typebulb 0.55.2 → 0.55.4

package/dist/format/index.d.ts

@@ -7,5 +7,6 @@ export * from './chunks.js';
 export * from './slug.js';
 export * from './mode.js';
 export * from './pageShell.js';
+export * from './scrollRestore.js';
 export { escapeYamlString, unescapeYamlString } from './yaml.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/format/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}

package/dist/format/index.js

@@ -7,5 +7,6 @@ export * from './chunks.js';
 export * from './slug.js';
 export * from './mode.js';
 export * from './pageShell.js';
+export * from './scrollRestore.js';
 export { escapeYamlString, unescapeYamlString } from './yaml.js';
 //# sourceMappingURL=index.js.map

package/dist/format/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}

package/dist/format/scrollRestore.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The scroll-restoration engine a rendered bulb document ships (specs/Scroll-Restoration.md).
+ * ONE copy, beside pageShell.ts and on its argument: both hosts must emit the same behavior or a
+ * bulb restores differently local vs published. A script string for the page <head>; the host's
+ * own snippet then calls `window.__tbScroll.init({ initialY, save })` to say where the offset
+ * comes from and where reports go (the CLI: the page's sessionStorage; the sandbox: a postMessage
+ * to the parent).
+ *
+ *   init({ initialY, save }) -> arm the re-apply loop at initialY (0: nothing to do); save(y) is
+ *                                the throttled reporter's sink
+ *   restore(y)               -> re-arm at y (a traversal landed); undefined or 0 scrolls to top
+ *   top()                    -> a page-shaped move landed: disarm, scroll to 0, report 0
+ *   flush()                  -> report the pending offset now (before a route change goes out)
+ *
+ * While armed, every frame writes `y` once the document is tall enough, and the loop stands down
+ * on the first scroll it did not author (input, the browser's scroll anchoring, a bulb scrolling
+ * itself) or TAIL_MS after `load`. A clamp (the document shrank under us) is exempt. Native
+ * restoration gives up at `load`; this covers the tail a bulb that renders after load needs.
+ */
+export declare const scrollRestoreEngine = "(function () {\n  var W = window, D = document;\n  var TAIL_MS = 1500, TOL = 2, THROTTLE_MS = 200;\n  var SCROLL_KEYS = { ' ': 1, ArrowUp: 1, ArrowDown: 1, PageUp: 1, PageDown: 1, Home: 1, End: 1 };\n  var save = null;\n  var target = 0, armed = false, applied = false, lastWritten = -1, raf = 0, deadline = 0;\n  var pending, timer = 0;\n\n  var maxY = function () { var d = D.documentElement; return Math.max(0, d.scrollHeight - d.clientHeight); };\n  var write = function (y) {\n    lastWritten = y;\n    try { W.scrollTo({ top: y, left: 0, behavior: 'instant' }); } catch (e) { W.scrollTo(0, y); }\n  };\n  var disarm = function () {\n    armed = false;\n    if (raf) { cancelAnimationFrame(raf); raf = 0; }\n    if (deadline) { clearTimeout(deadline); deadline = 0; }\n  };\n  var tick = function () {\n    if (!armed) return;\n    if (target <= maxY()) { applied = true; if (Math.abs(W.scrollY - target) > TOL) write(target); }\n    raf = requestAnimationFrame(tick);\n  };\n  var expire = function () {\n    if (!armed) return;\n    if (!applied) { var y = Math.min(target, maxY()); if (y > 0) write(y); }\n    disarm();\n  };\n  var arm = function (y) {\n    disarm();\n    target = y; applied = false;\n    if (!(y > 0)) return;\n    armed = true;\n    raf = requestAnimationFrame(tick);\n    var start = function () { if (armed && !deadline) deadline = setTimeout(expire, TAIL_MS); };\n    if (D.readyState === 'complete') start(); else W.addEventListener('load', start, { once: true });\n  };\n\n  var report = function (y) { if (save) { try { save(y); } catch (e) {} } };\n  var flush = function () {\n    if (timer) { clearTimeout(timer); timer = 0; }\n    if (pending !== undefined) { var y = pending; pending = undefined; report(y); }\n  };\n\n  W.addEventListener('scroll', function () {\n    var y = W.scrollY;\n    pending = y;\n    if (!timer) timer = setTimeout(flush, THROTTLE_MS);\n    if (!armed || Math.abs(y - lastWritten) <= TOL) return;\n    if (y < target && Math.abs(y - maxY()) <= TOL) return;\n    disarm();\n  }, { passive: true });\n  W.addEventListener('wheel', disarm, { capture: true, passive: true });\n  W.addEventListener('touchstart', disarm, { capture: true, passive: true });\n  W.addEventListener('keydown', function (e) { if (SCROLL_KEYS[e.key]) disarm(); }, { capture: true });\n\n  W.__tbScroll = {\n    init: function (o) {\n      save = o && typeof o.save === 'function' ? o.save : null;\n      arm(o ? Number(o.initialY) : 0);\n    },\n    restore: function (y) {\n      y = Number(y);\n      if (y > 0 && isFinite(y)) arm(y); else { disarm(); write(0); }\n    },\n    top: function () { disarm(); write(0); report(0); },\n    flush: flush\n  };\n})();";
+//# sourceMappingURL=scrollRestore.d.ts.map

package/dist/format/scrollRestore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollRestore.d.ts","sourceRoot":"","sources":["../../format/src/scrollRestore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,kpFAoE1B,CAAA"}

package/dist/format/scrollRestore.js

@@ -0,0 +1,89 @@
+/**
+ * The scroll-restoration engine a rendered bulb document ships (specs/Scroll-Restoration.md).
+ * ONE copy, beside pageShell.ts and on its argument: both hosts must emit the same behavior or a
+ * bulb restores differently local vs published. A script string for the page <head>; the host's
+ * own snippet then calls `window.__tbScroll.init({ initialY, save })` to say where the offset
+ * comes from and where reports go (the CLI: the page's sessionStorage; the sandbox: a postMessage
+ * to the parent).
+ *
+ *   init({ initialY, save }) -> arm the re-apply loop at initialY (0: nothing to do); save(y) is
+ *                                the throttled reporter's sink
+ *   restore(y)               -> re-arm at y (a traversal landed); undefined or 0 scrolls to top
+ *   top()                    -> a page-shaped move landed: disarm, scroll to 0, report 0
+ *   flush()                  -> report the pending offset now (before a route change goes out)
+ *
+ * While armed, every frame writes `y` once the document is tall enough, and the loop stands down
+ * on the first scroll it did not author (input, the browser's scroll anchoring, a bulb scrolling
+ * itself) or TAIL_MS after `load`. A clamp (the document shrank under us) is exempt. Native
+ * restoration gives up at `load`; this covers the tail a bulb that renders after load needs.
+ */
+export const scrollRestoreEngine = `(function () {
+  var W = window, D = document;
+  var TAIL_MS = 1500, TOL = 2, THROTTLE_MS = 200;
+  var SCROLL_KEYS = { ' ': 1, ArrowUp: 1, ArrowDown: 1, PageUp: 1, PageDown: 1, Home: 1, End: 1 };
+  var save = null;
+  var target = 0, armed = false, applied = false, lastWritten = -1, raf = 0, deadline = 0;
+  var pending, timer = 0;
+
+  var maxY = function () { var d = D.documentElement; return Math.max(0, d.scrollHeight - d.clientHeight); };
+  var write = function (y) {
+    lastWritten = y;
+    try { W.scrollTo({ top: y, left: 0, behavior: 'instant' }); } catch (e) { W.scrollTo(0, y); }
+  };
+  var disarm = function () {
+    armed = false;
+    if (raf) { cancelAnimationFrame(raf); raf = 0; }
+    if (deadline) { clearTimeout(deadline); deadline = 0; }
+  };
+  var tick = function () {
+    if (!armed) return;
+    if (target <= maxY()) { applied = true; if (Math.abs(W.scrollY - target) > TOL) write(target); }
+    raf = requestAnimationFrame(tick);
+  };
+  var expire = function () {
+    if (!armed) return;
+    if (!applied) { var y = Math.min(target, maxY()); if (y > 0) write(y); }
+    disarm();
+  };
+  var arm = function (y) {
+    disarm();
+    target = y; applied = false;
+    if (!(y > 0)) return;
+    armed = true;
+    raf = requestAnimationFrame(tick);
+    var start = function () { if (armed && !deadline) deadline = setTimeout(expire, TAIL_MS); };
+    if (D.readyState === 'complete') start(); else W.addEventListener('load', start, { once: true });
+  };
+
+  var report = function (y) { if (save) { try { save(y); } catch (e) {} } };
+  var flush = function () {
+    if (timer) { clearTimeout(timer); timer = 0; }
+    if (pending !== undefined) { var y = pending; pending = undefined; report(y); }
+  };
+
+  W.addEventListener('scroll', function () {
+    var y = W.scrollY;
+    pending = y;
+    if (!timer) timer = setTimeout(flush, THROTTLE_MS);
+    if (!armed || Math.abs(y - lastWritten) <= TOL) return;
+    if (y < target && Math.abs(y - maxY()) <= TOL) return;
+    disarm();
+  }, { passive: true });
+  W.addEventListener('wheel', disarm, { capture: true, passive: true });
+  W.addEventListener('touchstart', disarm, { capture: true, passive: true });
+  W.addEventListener('keydown', function (e) { if (SCROLL_KEYS[e.key]) disarm(); }, { capture: true });
+
+  W.__tbScroll = {
+    init: function (o) {
+      save = o && typeof o.save === 'function' ? o.save : null;
+      arm(o ? Number(o.initialY) : 0);
+    },
+    restore: function (y) {
+      y = Number(y);
+      if (y > 0 && isFinite(y)) arm(y); else { disarm(); write(0); }
+    },
+    top: function () { disarm(); write(0); report(0); },
+    flush: flush
+  };
+})();`;
+//# sourceMappingURL=scrollRestore.js.map

package/dist/format/scrollRestore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollRestore.js","sourceRoot":"","sources":["../../format/src/scrollRestore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAoE7B,CAAA"}