@invisibleloop/pulse 0.1.39 → 0.2.0

package/.github/workflows/publish.yml

@@ -25,11 +25,12 @@ jobs:
 
       - run: npm test
 
-      - name: Bump patch version if already published, then publish
+      - name: Bump version from conventional commits, then publish
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: |
-          VERSION=$(node -p "require('./package.json').version")
+          VERSION=$(node scripts/release-version.js)
+          # Fallback: if this exact version is somehow already on npm, bump patch
           while npm view @invisibleloop/pulse@$VERSION version 2>/dev/null | grep -q .; do
             VERSION=$(node -e "const [a,b,c]='$VERSION'.split('.').map(Number);console.log(a+'.'+b+'.'+(c+1))")
           done

package/CLAUDE.md

@@ -114,7 +114,17 @@ export const mySpec = {
   // Streaming SSR — split view into shell (instant) + deferred segments
   stream: {
     shell:    ['header', 'nav'],
-    deferred: ['feed']
+    deferred: ['feed'],
+
+    // Optional: scope each segment to only the server fetchers it needs.
+    // Shell sends as soon as its own fetchers resolve — deferred-only fetchers
+    // never block the shell. Each deferred segment streams independently.
+    // Omit scope (or omit a segment from scope) to give it all server state.
+    scope: {
+      header: ['user'],         // 'user' fetcher resolves → shell writes
+      nav:    ['user'],
+      feed:   ['posts', 'ads'], // 'posts' + 'ads' fetchers resolve → feed writes
+    }
   }
 }
 
@@ -138,6 +148,16 @@ Pulse binds to DOM attributes — no JSX, no templates.
 <button data-dialog-close>Cancel</button>                <!-- closes nearest ancestor <dialog> -->
 ```
 
+**List keys — use `data-key` on repeated elements** to enable key-based DOM reconciliation. When all element children of a container carry `data-key`, the runtime matches nodes by key instead of position — inserts, removals, and reorders become O(1) rather than O(n) patches, and existing DOM nodes (inputs, images) are preserved correctly:
+
+```html
+<ul>
+  ${items.map(item => `<li data-key="${item.id}">${item.name}</li>`).join('')}
+</ul>
+```
+
+All sibling elements in the container must have `data-key` to activate key mode — mixed keyed/unkeyed siblings fall back to position-based matching.
+
 **Modal pattern — never use `state.modalOpen`.** Always render the `<dialog>` in the DOM unconditionally and use `data-dialog-open` to show it. ESC key, backdrop click, and `<form method="dialog">` all close it natively with no spec state.
 
 **Important:** Do not use `data-event` on text inputs to mirror their value into state. The `innerHTML` replacement on every keystroke destroys focus. Instead, use uncontrolled inputs and capture `FormData` in `action.onStart` before `validate` runs.

package/benchmark/results/2026-03-27-09-20.json

@@ -0,0 +1,188 @@
+{
+  "timestamp": "2026-03-27T09:20:25.195Z",
+  "node": "v22.19.0",
+  "suites": [
+    {
+      "label": "simple",
+      "path": "/bench/simple",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.18965339000000087,
+        "p50": 0.17383399999999938,
+        "p95": 0.29887500000000955,
+        "p99": 0.3626250000000084,
+        "min": 0.14820799999998258,
+        "max": 0.3626250000000084
+      },
+      "total": {
+        "mean": 0.21540463999999956,
+        "p50": 0.19762500000001637,
+        "p95": 0.32587499999999636,
+        "p99": 0.40537499999999227,
+        "min": 0.16808299999999576,
+        "max": 0.40537499999999227
+      },
+      "bodyBytes": 1054,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "data-1",
+      "path": "/bench/data-1",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.7174741700000027,
+        "p50": 0.6867910000000848,
+        "p95": 1.1546250000001237,
+        "p99": 1.5141250000001492,
+        "min": 0.26679200000012315,
+        "max": 1.5141250000001492
+      },
+      "total": {
+        "mean": 22.057245399999985,
+        "p50": 22.128749999999854,
+        "p95": 22.988791999999876,
+        "p99": 23.292291999999975,
+        "min": 20.543083000000024,
+        "max": 23.292291999999975
+      },
+      "bodyBytes": 4384,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "data-3",
+      "path": "/bench/data-3",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.7575587300000006,
+        "p50": 0.7104169999997794,
+        "p95": 1.4852919999998448,
+        "p99": 1.7593329999999696,
+        "min": 0.2626669999999649,
+        "max": 1.7593329999999696
+      },
+      "total": {
+        "mean": 31.95738079999998,
+        "p50": 32.02441699999963,
+        "p95": 32.793916999999965,
+        "p99": 33.06345800000008,
+        "min": 30.259124999999585,
+        "max": 33.06345800000008
+      },
+      "bodyBytes": 1246,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "cached",
+      "path": "/bench/cached",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.1528695300000345,
+        "p50": 0.13799999999991996,
+        "p95": 0.2255829999994603,
+        "p99": 0.48387499999989814,
+        "min": 0.09737500000028376,
+        "max": 0.48387499999989814
+      },
+      "total": {
+        "mean": 0.16491832000000614,
+        "p50": 0.14895900000010442,
+        "p95": 0.2435829999994894,
+        "p99": 0.49779099999977916,
+        "min": 0.10537500000009459,
+        "max": 0.49779099999977916
+      },
+      "bodyBytes": 988,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "nav/simple",
+      "path": "/bench/simple",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.13343495999998595,
+        "p50": 0.1262909999995827,
+        "p95": 0.19287500000064028,
+        "p99": 0.423333000000639,
+        "min": 0.08924999999999272,
+        "max": 0.423333000000639
+      },
+      "total": {
+        "mean": 0.14239336000002367,
+        "p50": 0.13475000000016735,
+        "p95": 0.20391700000072888,
+        "p99": 0.4311250000000655,
+        "min": 0.09600000000045839,
+        "max": 0.4311250000000655
+      },
+      "bodyBytes": 244,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "nav/data-1",
+      "path": "/bench/data-1",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 21.82076291000002,
+        "p50": 21.85304200000064,
+        "p95": 22.433207999999468,
+        "p99": 23.03662499999973,
+        "min": 20.698709000000235,
+        "max": 23.03662499999973
+      },
+      "total": {
+        "mean": 21.865540849999878,
+        "p50": 21.896166999998968,
+        "p95": 22.511749999999665,
+        "p99": 23.08691699999963,
+        "min": 20.723042000000532,
+        "max": 23.08691699999963
+      },
+      "bodyBytes": 3513,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "nav/data-3",
+      "path": "/bench/data-3",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 31.878054999999968,
+        "p50": 31.92083300000013,
+        "p95": 32.69962499999929,
+        "p99": 33.174958999999944,
+        "min": 30.299708999998984,
+        "max": 33.174958999999944
+      },
+      "total": {
+        "mean": 31.93094377999998,
+        "p50": 31.96887500000048,
+        "p95": 32.76958299999933,
+        "p99": 33.27116700000079,
+        "min": 30.37066699999923,
+        "max": 33.27116700000079
+      },
+      "bodyBytes": 375,
+      "serverData": null,
+      "serverRender": null
+    }
+  ],
+  "bundles": {
+    "contact.boot": {
+      "file": "contact.boot-IBC3WEQQ.js",
+      "bytes": 2506
+    },
+    "counter.boot": {
+      "file": "counter.boot-VUWQFE5L.js",
+      "bytes": 1229
+    },
+    "runtime": {
+      "file": "runtime-YLZ4ZGK4.js",
+      "bytes": 7017
+    }
+  }
+}

package/benchmark/results/2026-03-27-09-21.json

@@ -0,0 +1,188 @@
+{
+  "timestamp": "2026-03-27T09:21:12.621Z",
+  "node": "v22.19.0",
+  "suites": [
+    {
+      "label": "simple",
+      "path": "/bench/simple",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.18461582000000049,
+        "p50": 0.1646250000000009,
+        "p95": 0.2852500000000191,
+        "p99": 0.42183299999999235,
+        "min": 0.1447080000000085,
+        "max": 0.42183299999999235
+      },
+      "total": {
+        "mean": 0.21154751000000033,
+        "p50": 0.18912499999999,
+        "p95": 0.31433400000000233,
+        "p99": 0.4727500000000191,
+        "min": 0.1662499999999909,
+        "max": 0.4727500000000191
+      },
+      "bodyBytes": 1107,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "data-1",
+      "path": "/bench/data-1",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.6358262399999944,
+        "p50": 0.5394169999999576,
+        "p95": 1.2368329999999332,
+        "p99": 2.6608750000000327,
+        "min": 0.22608299999990322,
+        "max": 2.6608750000000327
+      },
+      "total": {
+        "mean": 22.039515369999986,
+        "p50": 22.052624999999807,
+        "p95": 23.031082999999853,
+        "p99": 23.720332999999982,
+        "min": 20.468165999999655,
+        "max": 23.720332999999982
+      },
+      "bodyBytes": 4437,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "data-3",
+      "path": "/bench/data-3",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.5651482699999678,
+        "p50": 0.49766700000009223,
+        "p95": 1.3021660000003976,
+        "p99": 1.4529170000000704,
+        "min": 0.23220799999944575,
+        "max": 1.4529170000000704
+      },
+      "total": {
+        "mean": 31.685546209999952,
+        "p50": 31.745542000000114,
+        "p95": 32.82679100000041,
+        "p99": 33.18908300000021,
+        "min": 29.795499999999265,
+        "max": 33.18908300000021
+      },
+      "bodyBytes": 1299,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "cached",
+      "path": "/bench/cached",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.1482587500000227,
+        "p50": 0.13324999999986176,
+        "p95": 0.2303750000000946,
+        "p99": 0.3728339999997843,
+        "min": 0.10658300000068266,
+        "max": 0.3728339999997843
+      },
+      "total": {
+        "mean": 0.16088121999998292,
+        "p50": 0.145542000000205,
+        "p95": 0.24883299999964947,
+        "p99": 0.3845839999994496,
+        "min": 0.11658299999999144,
+        "max": 0.3845839999994496
+      },
+      "bodyBytes": 1041,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "nav/simple",
+      "path": "/bench/simple",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.11078830999994352,
+        "p50": 0.10883399999966059,
+        "p95": 0.12508299999990413,
+        "p99": 0.37304199999925913,
+        "min": 0.09274999999979627,
+        "max": 0.37304199999925913
+      },
+      "total": {
+        "mean": 0.1193449899999905,
+        "p50": 0.11745799999971496,
+        "p95": 0.13524999999935972,
+        "p99": 0.38433399999939866,
+        "min": 0.09883399999944231,
+        "max": 0.38433399999939866
+      },
+      "bodyBytes": 244,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "nav/data-1",
+      "path": "/bench/data-1",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 21.61796121999997,
+        "p50": 21.62274999999954,
+        "p95": 22.23725000000013,
+        "p99": 22.784042000000227,
+        "min": 20.593541999999616,
+        "max": 22.784042000000227
+      },
+      "total": {
+        "mean": 21.65816495000001,
+        "p50": 21.65904099999989,
+        "p95": 22.343792000000576,
+        "p99": 22.863250000000335,
+        "min": 20.61554199999955,
+        "max": 22.863250000000335
+      },
+      "bodyBytes": 3513,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "nav/data-3",
+      "path": "/bench/data-3",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 31.698053359999975,
+        "p50": 31.66662499999984,
+        "p95": 32.492291999999,
+        "p99": 32.72829199999978,
+        "min": 30.043375000001106,
+        "max": 32.72829199999978
+      },
+      "total": {
+        "mean": 31.743360929999927,
+        "p50": 31.71479199999885,
+        "p95": 32.56791599999997,
+        "p99": 32.881624999999985,
+        "min": 30.08008300000074,
+        "max": 32.881624999999985
+      },
+      "bodyBytes": 375,
+      "serverData": null,
+      "serverRender": null
+    }
+  ],
+  "bundles": {
+    "contact.boot": {
+      "file": "contact.boot-IBC3WEQQ.js",
+      "bytes": 2506
+    },
+    "counter.boot": {
+      "file": "counter.boot-VUWQFE5L.js",
+      "bytes": 1229
+    },
+    "runtime": {
+      "file": "runtime-YLZ4ZGK4.js",
+      "bytes": 7017
+    }
+  }
+}

package/benchmark/results/2026-03-27-09-29.json

@@ -0,0 +1,188 @@
+{
+  "timestamp": "2026-03-27T09:29:14.607Z",
+  "node": "v22.19.0",
+  "suites": [
+    {
+      "label": "simple",
+      "path": "/bench/simple",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.18297082000000045,
+        "p50": 0.17108400000000756,
+        "p95": 0.2559579999999926,
+        "p99": 0.4467909999999904,
+        "min": 0.15024999999999977,
+        "max": 0.4467909999999904
+      },
+      "total": {
+        "mean": 0.20846497000000028,
+        "p50": 0.19445799999999736,
+        "p95": 0.30350000000001387,
+        "p99": 0.48399999999998045,
+        "min": 0.17208299999998644,
+        "max": 0.48399999999998045
+      },
+      "bodyBytes": 1107,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "data-1",
+      "path": "/bench/data-1",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.6133241500000065,
+        "p50": 0.4627920000002632,
+        "p95": 1.2224160000000666,
+        "p99": 2.668916000000081,
+        "min": 0.29625000000010004,
+        "max": 2.668916000000081
+      },
+      "total": {
+        "mean": 21.990226709999998,
+        "p50": 21.921583999999996,
+        "p95": 22.944167000000107,
+        "p99": 23.517833999999993,
+        "min": 20.591375000000085,
+        "max": 23.517833999999993
+      },
+      "bodyBytes": 4437,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "data-3",
+      "path": "/bench/data-3",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.5387367000000086,
+        "p50": 0.4626250000001164,
+        "p95": 1.293916999999965,
+        "p99": 1.4869160000007469,
+        "min": 0.28574999999955253,
+        "max": 1.4869160000007469
+      },
+      "total": {
+        "mean": 31.784648730000022,
+        "p50": 31.87787500000013,
+        "p95": 32.797083000000384,
+        "p99": 33.82358299999942,
+        "min": 30.11054200000035,
+        "max": 33.82358299999942
+      },
+      "bodyBytes": 1299,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "cached",
+      "path": "/bench/cached",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.14762670000003708,
+        "p50": 0.13516700000036508,
+        "p95": 0.23062500000014552,
+        "p99": 0.5274579999995694,
+        "min": 0.11129199999959383,
+        "max": 0.5274579999995694
+      },
+      "total": {
+        "mean": 0.16071208999996997,
+        "p50": 0.1472089999997479,
+        "p95": 0.2516670000004524,
+        "p99": 0.5587909999994736,
+        "min": 0.12033299999984592,
+        "max": 0.5587909999994736
+      },
+      "bodyBytes": 1041,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "nav/simple",
+      "path": "/bench/simple",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 0.11551874999987376,
+        "p50": 0.11016599999948085,
+        "p95": 0.13649999999961437,
+        "p99": 0.39541600000029575,
+        "min": 0.09170799999992596,
+        "max": 0.39541600000029575
+      },
+      "total": {
+        "mean": 0.12438039999991815,
+        "p50": 0.11924999999973807,
+        "p95": 0.1472909999993135,
+        "p99": 0.40704099999948085,
+        "min": 0.09787500000038563,
+        "max": 0.40704099999948085
+      },
+      "bodyBytes": 244,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "nav/data-1",
+      "path": "/bench/data-1",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 21.649980459999988,
+        "p50": 21.569624999999178,
+        "p95": 22.391042000000198,
+        "p99": 22.874499999999898,
+        "min": 20.5278330000001,
+        "max": 22.874499999999898
+      },
+      "total": {
+        "mean": 21.690494169999955,
+        "p50": 21.597499999999854,
+        "p95": 22.469167000000198,
+        "p99": 22.954249999998865,
+        "min": 20.546290999999655,
+        "max": 22.954249999998865
+      },
+      "bodyBytes": 3513,
+      "serverData": null,
+      "serverRender": null
+    },
+    {
+      "label": "nav/data-3",
+      "path": "/bench/data-3",
+      "iterations": 100,
+      "ttfb": {
+        "mean": 31.646467500000053,
+        "p50": 31.64995799999997,
+        "p95": 32.36629200000061,
+        "p99": 32.69512500000019,
+        "min": 30.283833000001323,
+        "max": 32.69512500000019
+      },
+      "total": {
+        "mean": 31.690145040000026,
+        "p50": 31.678874999999607,
+        "p95": 32.40204200000153,
+        "p99": 32.79820800000016,
+        "min": 30.3387500000008,
+        "max": 32.79820800000016
+      },
+      "bodyBytes": 375,
+      "serverData": null,
+      "serverRender": null
+    }
+  ],
+  "bundles": {
+    "contact.boot": {
+      "file": "contact.boot-IBC3WEQQ.js",
+      "bytes": 2506
+    },
+    "counter.boot": {
+      "file": "counter.boot-VUWQFE5L.js",
+      "bytes": 1229
+    },
+    "runtime": {
+      "file": "runtime-YLZ4ZGK4.js",
+      "bytes": 7017
+    }
+  }
+}