Docs: How-it-works covers Lightning/Ark/SP/gifts; README rewrite

The in-app page grows plain-language cards for Lightning swaps, Ark
(instant off-chain, the unilateral escape hatch, expiry housekeeping,
fees), silent payments, and gift links. The README catches up with
reality: the native-JS Ark client headlines the feature list, and the
modular HAL_FEATURES build system gets its own section — every feature
is a plugin behind a build seam, and excluded code never ships.

Co-Authored-By: Claude Fable 5 <[email protected]>

1 files changed, 16 insertions, 2 deletions

diff --git a/src/app.js b/src/app.js
index 7eacff1..fa0fe90 100644
--- a/src/app.js
+++ b/src/app.js
@@ -504,9 +504,23 @@ function howItWorksScreen() {
       para('hiwBasics2'),
       para('hiwBasics3'),
       para('hiwBasics4'),
-      para('hiwBasics5'),
-      h('p', { class: 'small muted hiw-tribute', style: 'margin:0' }, ...linkify(t('hiwTribute')))
+      para('hiwBasics5')
     ),
+    h('div', { class: 'card col', style: 'gap:14px' },
+      h('h3', {}, '⚡ ' + t('hiwLnTitle')),
+      para('hiwLn1')),
+    h('div', { class: 'card col', style: 'gap:14px' },
+      h('h3', {}, '⚔ ' + t('hiwArkTitle')),
+      para('hiwArk1'),
+      para('hiwArk2'),
+      para('hiwArk3')),
+    h('div', { class: 'card col', style: 'gap:14px' },
+      h('h3', {}, '👤 ' + t('hiwSpTitle')),
+      para('hiwSp1')),
+    h('div', { class: 'card col', style: 'gap:14px' },
+      h('h3', {}, '🎁 ' + t('hiwGiftsTitle')),
+      para('hiwGifts1'),
+      h('p', { class: 'small muted hiw-tribute', style: 'margin:0' }, ...linkify(t('hiwTribute')))),
     h('button', { class: 'btn-block', onClick: back }, t('back'))
   );
 }