@pibbl/core 0.0.2 → 0.0.3-alpha.90.1

package/dist/lib/render-transaction.js

@@ -1,7 +1,9 @@
 class RootRenderTransaction {
   publications = /* @__PURE__ */ new Set();
   callbacks = /* @__PURE__ */ new Set();
+  afterFinishCallbacks = /* @__PURE__ */ new Set();
   result;
+  afterFinishDelivered = false;
   onPublish(callback) {
     if (this.result !== void 0) {
       if (this.result) callback();
@@ -11,6 +13,13 @@ class RootRenderTransaction {
     if (this.result !== void 0) callback(this.result);
     else this.callbacks.add(callback);
   }
+  onAfterFinish(callback) {
+    if (this.afterFinishDelivered) {
+      callback(this.result);
+    } else {
+      this.afterFinishCallbacks.add(callback);
+    }
+  }
   finish(success) {
     if (this.result !== void 0) return;
     const errors = [];
@@ -36,8 +45,21 @@ class RootRenderTransaction {
         errors.push(error);
       }
     }
+    while (this.afterFinishCallbacks.size) {
+      const afterFinishCallbacks = Array.from(this.afterFinishCallbacks);
+      this.afterFinishCallbacks.clear();
+      for (const callback of afterFinishCallbacks) {
+        try {
+          callback(success);
+        } catch (error) {
+          errors.push(error);
+        }
+      }
+    }
+    this.afterFinishDelivered = true;
     if (errors.length === 1) throw errors[0];
-    if (errors.length) throw new AggregateError(errors, "Pibbl render completion failed.");
+    if (errors.length)
+      throw new AggregateError(errors, "Pibbl render completion failed.");
   }
 }
 export {

package/dist/lib/render-transaction.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/render-transaction.ts"],
-  "sourcesContent": ["import type { PibblRenderTransaction } from './types.js';\n\n/** Root-wide publication precedes focus/policy commit in both render paths. */\nexport class RootRenderTransaction implements PibblRenderTransaction {\n  private publications = new Set<() => void>();\n  private callbacks = new Set<(success: boolean) => void>();\n  private result: boolean | undefined;\n\n  onPublish(callback: () => void): void {\n    if (this.result !== undefined) {\n      if (this.result) callback();\n    } else this.publications.add(callback);\n  }\n\n  onFinish(callback: (success: boolean) => void): void {\n    if (this.result !== undefined) callback(this.result);\n    else this.callbacks.add(callback);\n  }\n\n  finish(success: boolean): void {\n    if (this.result !== undefined) return;\n    const errors: unknown[] = [];\n    if (success) {\n      for (const publish of this.publications) {\n        try { publish(); } catch (error) { errors.push(error); success = false; break; }\n      }\n    }\n    this.publications.clear();\n    this.result = success;\n    const callbacks = Array.from(this.callbacks);\n    this.callbacks.clear();\n    for (const callback of callbacks) {\n      try { callback(success); } catch (error) { errors.push(error); }\n    }\n    if (errors.length === 1) throw errors[0];\n    if (errors.length) throw new AggregateError(errors, 'Pibbl render completion failed.');\n  }\n}\n"],
-  "mappings": "AAGO,MAAM,sBAAwD;AAAA,EAC3D,eAAe,oBAAI,IAAgB;AAAA,EACnC,YAAY,oBAAI,IAAgC;AAAA,EAChD;AAAA,EAER,UAAU,UAA4B;AACpC,QAAI,KAAK,WAAW,QAAW;AAC7B,UAAI,KAAK,OAAQ,UAAS;AAAA,IAC5B,MAAO,MAAK,aAAa,IAAI,QAAQ;AAAA,EACvC;AAAA,EAEA,SAAS,UAA4C;AACnD,QAAI,KAAK,WAAW,OAAW,UAAS,KAAK,MAAM;AAAA,QAC9C,MAAK,UAAU,IAAI,QAAQ;AAAA,EAClC;AAAA,EAEA,OAAO,SAAwB;AAC7B,QAAI,KAAK,WAAW,OAAW;AAC/B,UAAM,SAAoB,CAAC;AAC3B,QAAI,SAAS;AACX,iBAAW,WAAW,KAAK,cAAc;AACvC,YAAI;AAAE,kBAAQ;AAAA,QAAG,SAAS,OAAO;AAAE,iBAAO,KAAK,KAAK;AAAG,oBAAU;AAAO;AAAA,QAAO;AAAA,MACjF;AAAA,IACF;AACA,SAAK,aAAa,MAAM;AACxB,SAAK,SAAS;AACd,UAAM,YAAY,MAAM,KAAK,KAAK,SAAS;AAC3C,SAAK,UAAU,MAAM;AACrB,eAAW,YAAY,WAAW;AAChC,UAAI;AAAE,iBAAS,OAAO;AAAA,MAAG,SAAS,OAAO;AAAE,eAAO,KAAK,KAAK;AAAA,MAAG;AAAA,IACjE;AACA,QAAI,OAAO,WAAW,EAAG,OAAM,OAAO,CAAC;AACvC,QAAI,OAAO,OAAQ,OAAM,IAAI,eAAe,QAAQ,iCAAiC;AAAA,EACvF;AACF;",
+  "sourcesContent": ["import type { PibblRenderTransaction } from \"./types.js\";\n\n/** Root-wide publications and ordinary commit callbacks precede completion observers. */\nexport class RootRenderTransaction implements PibblRenderTransaction {\n  private publications = new Set<() => void>();\n  private callbacks = new Set<(success: boolean) => void>();\n  private afterFinishCallbacks = new Set<(success: boolean) => void>();\n  private result: boolean | undefined;\n  private afterFinishDelivered = false;\n\n  onPublish(callback: () => void): void {\n    if (this.result !== undefined) {\n      if (this.result) callback();\n    } else this.publications.add(callback);\n  }\n\n  onFinish(callback: (success: boolean) => void): void {\n    if (this.result !== undefined) callback(this.result);\n    else this.callbacks.add(callback);\n  }\n\n  onAfterFinish(callback: (success: boolean) => void): void {\n    if (this.afterFinishDelivered) {\n      callback(this.result!);\n    } else {\n      this.afterFinishCallbacks.add(callback);\n    }\n  }\n\n  finish(success: boolean): void {\n    if (this.result !== undefined) return;\n    const errors: unknown[] = [];\n    if (success) {\n      for (const publish of this.publications) {\n        try {\n          publish();\n        } catch (error) {\n          errors.push(error);\n          success = false;\n          break;\n        }\n      }\n    }\n    this.publications.clear();\n    this.result = success;\n    const callbacks = Array.from(this.callbacks);\n    this.callbacks.clear();\n    for (const callback of callbacks) {\n      try {\n        callback(success);\n      } catch (error) {\n        errors.push(error);\n      }\n    }\n    while (this.afterFinishCallbacks.size) {\n      const afterFinishCallbacks = Array.from(this.afterFinishCallbacks);\n      this.afterFinishCallbacks.clear();\n      for (const callback of afterFinishCallbacks) {\n        try {\n          callback(success);\n        } catch (error) {\n          errors.push(error);\n        }\n      }\n    }\n    this.afterFinishDelivered = true;\n    if (errors.length === 1) throw errors[0];\n    if (errors.length)\n      throw new AggregateError(errors, \"Pibbl render completion failed.\");\n  }\n}\n"],
+  "mappings": "AAGO,MAAM,sBAAwD;AAAA,EAC3D,eAAe,oBAAI,IAAgB;AAAA,EACnC,YAAY,oBAAI,IAAgC;AAAA,EAChD,uBAAuB,oBAAI,IAAgC;AAAA,EAC3D;AAAA,EACA,uBAAuB;AAAA,EAE/B,UAAU,UAA4B;AACpC,QAAI,KAAK,WAAW,QAAW;AAC7B,UAAI,KAAK,OAAQ,UAAS;AAAA,IAC5B,MAAO,MAAK,aAAa,IAAI,QAAQ;AAAA,EACvC;AAAA,EAEA,SAAS,UAA4C;AACnD,QAAI,KAAK,WAAW,OAAW,UAAS,KAAK,MAAM;AAAA,QAC9C,MAAK,UAAU,IAAI,QAAQ;AAAA,EAClC;AAAA,EAEA,cAAc,UAA4C;AACxD,QAAI,KAAK,sBAAsB;AAC7B,eAAS,KAAK,MAAO;AAAA,IACvB,OAAO;AACL,WAAK,qBAAqB,IAAI,QAAQ;AAAA,IACxC;AAAA,EACF;AAAA,EAEA,OAAO,SAAwB;AAC7B,QAAI,KAAK,WAAW,OAAW;AAC/B,UAAM,SAAoB,CAAC;AAC3B,QAAI,SAAS;AACX,iBAAW,WAAW,KAAK,cAAc;AACvC,YAAI;AACF,kBAAQ;AAAA,QACV,SAAS,OAAO;AACd,iBAAO,KAAK,KAAK;AACjB,oBAAU;AACV;AAAA,QACF;AAAA,MACF;AAAA,IACF;AACA,SAAK,aAAa,MAAM;AACxB,SAAK,SAAS;AACd,UAAM,YAAY,MAAM,KAAK,KAAK,SAAS;AAC3C,SAAK,UAAU,MAAM;AACrB,eAAW,YAAY,WAAW;AAChC,UAAI;AACF,iBAAS,OAAO;AAAA,MAClB,SAAS,OAAO;AACd,eAAO,KAAK,KAAK;AAAA,MACnB;AAAA,IACF;AACA,WAAO,KAAK,qBAAqB,MAAM;AACrC,YAAM,uBAAuB,MAAM,KAAK,KAAK,oBAAoB;AACjE,WAAK,qBAAqB,MAAM;AAChC,iBAAW,YAAY,sBAAsB;AAC3C,YAAI;AACF,mBAAS,OAAO;AAAA,QAClB,SAAS,OAAO;AACd,iBAAO,KAAK,KAAK;AAAA,QACnB;AAAA,MACF;AAAA,IACF;AACA,SAAK,uBAAuB;AAC5B,QAAI,OAAO,WAAW,EAAG,OAAM,OAAO,CAAC;AACvC,QAAI,OAAO;AACT,YAAM,IAAI,eAAe,QAAQ,iCAAiC;AAAA,EACtE;AACF;",
   "names": []
 }

package/dist/lib/series-inspection-frame.d.ts

@@ -0,0 +1,18 @@
+import type { PibblClippingStackEntry } from "./types.js";
+/** Private geometry/ownership seam; no inspection algorithms enter core rendering.
+ * @returns Captured receiver ownership and lazily composed root geometry.
+ * @see {@link PibblClippingStackEntry}
+ */
+export declare function captureSeriesInspectionFrame(): {
+    receiver: import("./types.js").PibblComponentRefs<any>;
+    onDispose: (callback: () => void) => void;
+    onFinish: (callback: (success: boolean) => void) => void;
+    alive: () => boolean;
+    generation: () => number;
+    resolve(): {
+        transform: DOMMatrix;
+        clips: PibblClippingStackEntry[];
+        generation: number;
+        canvas: HTMLCanvasElement;
+    } | undefined;
+};

package/dist/lib/series-inspection-frame.js

@@ -0,0 +1,70 @@
+import { GLOBAL_STATE } from "./global-state.js";
+import { requireHookContext } from "./hooks/hook-slot.js";
+import { getCurrentWorldTransform } from "./render-target.js";
+import { PibblPaintEntryKind } from "./events/paint-entry.js";
+function captureSeriesInspectionFrame() {
+  const { componentRefs, pibblInstance } = requireHookContext();
+  const localTransform = new DOMMatrix(
+    Array.from(getCurrentWorldTransform().toFloat64Array())
+  );
+  const localClips = GLOBAL_STATE.clippingStack.map((clip) => ({
+    ...clip,
+    path: new Path2D(clip.path),
+    transform: new DOMMatrix(Array.from(clip.transform.toFloat64Array()))
+  }));
+  const transaction = GLOBAL_STATE.renderTransaction;
+  return {
+    receiver: componentRefs,
+    onDispose: (callback) => componentRefs.teardowns.add(callback),
+    onFinish: (callback) => transaction.onFinish(callback),
+    alive: () => !componentRefs.teardowns.closed && !pibblInstance.mainTeardowns.closed,
+    generation: () => pibblInstance.eventRoot.rootInstance?.committedRenderGeneration ?? 0,
+    resolve() {
+      let owner = pibblInstance;
+      let transform = new DOMMatrix(
+        Array.from(localTransform.toFloat64Array())
+      );
+      let clips = localClips.slice();
+      while (owner !== owner.eventRoot.rootInstance) {
+        const parent = owner.parent && GLOBAL_STATE.pibblInstances.get(owner.parent);
+        if (!parent) return void 0;
+        const bridge = [...parent.paintEntries].find(
+          (entry) => entry.paintKind !== PibblPaintEntryKind.Path && entry.instance === owner
+        );
+        if (!bridge || bridge.paintKind === PibblPaintEntryKind.Path)
+          return void 0;
+        const outer = bridge.transform;
+        clips = clips.map((clip) => ({
+          ...clip,
+          transform: outer.multiply(clip.transform)
+        }));
+        clips.push(
+          ...bridge.clippingStack.map((clip) => ({
+            ...clip,
+            path: new Path2D(clip.path),
+            transform: new DOMMatrix(
+              Array.from(clip.transform.toFloat64Array())
+            )
+          }))
+        );
+        clips.push({
+          path: new Path2D(bridge.bounds),
+          transform: new DOMMatrix(Array.from(outer.toFloat64Array())),
+          fillRule: "nonzero"
+        });
+        transform = outer.multiply(transform);
+        owner = parent;
+      }
+      return {
+        transform,
+        clips,
+        generation: owner.committedRenderGeneration ?? 0,
+        canvas: owner.canvas
+      };
+    }
+  };
+}
+export {
+  captureSeriesInspectionFrame
+};
+//# sourceMappingURL=series-inspection-frame.js.map

package/dist/lib/series-inspection-frame.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/series-inspection-frame.ts"],
+  "sourcesContent": ["import { GLOBAL_STATE } from \"./global-state.js\";\nimport { requireHookContext } from \"./hooks/hook-slot.js\";\nimport { getCurrentWorldTransform } from \"./render-target.js\";\nimport { PibblPaintEntryKind } from \"./events/paint-entry.js\";\nimport type { PibblClippingStackEntry } from \"./types.js\";\n\n/** Private geometry/ownership seam; no inspection algorithms enter core rendering.\n * @returns Captured receiver ownership and lazily composed root geometry.\n * @see {@link PibblClippingStackEntry}\n */\nexport function captureSeriesInspectionFrame() {\n  const { componentRefs, pibblInstance } = requireHookContext();\n  const localTransform = new DOMMatrix(\n    Array.from(getCurrentWorldTransform().toFloat64Array()),\n  );\n  const localClips = GLOBAL_STATE.clippingStack.map((clip) => ({\n    ...clip,\n    path: new Path2D(clip.path),\n    transform: new DOMMatrix(Array.from(clip.transform.toFloat64Array())),\n  }));\n  const transaction = GLOBAL_STATE.renderTransaction!;\n  return {\n    receiver: componentRefs,\n    onDispose: (callback: () => void) => componentRefs.teardowns.add(callback),\n    onFinish: (callback: (success: boolean) => void) =>\n      transaction.onFinish(callback),\n    alive: () =>\n      !componentRefs.teardowns.closed && !pibblInstance.mainTeardowns.closed,\n    generation: () =>\n      pibblInstance.eventRoot.rootInstance?.committedRenderGeneration ?? 0,\n    resolve() {\n      let owner = pibblInstance;\n      let transform = new DOMMatrix(\n        Array.from(localTransform.toFloat64Array()),\n      );\n      let clips: PibblClippingStackEntry[] = localClips.slice();\n      while (owner !== owner.eventRoot.rootInstance) {\n        const parent =\n          owner.parent && GLOBAL_STATE.pibblInstances.get(owner.parent);\n        if (!parent) return undefined;\n        const bridge = [...parent.paintEntries].find(\n          (entry) =>\n            entry.paintKind !== PibblPaintEntryKind.Path &&\n            entry.instance === owner,\n        );\n        if (!bridge || bridge.paintKind === PibblPaintEntryKind.Path)\n          return undefined;\n        const outer = bridge.transform;\n        clips = clips.map((clip) => ({\n          ...clip,\n          transform: outer.multiply(clip.transform),\n        }));\n        clips.push(\n          ...bridge.clippingStack.map((clip) => ({\n            ...clip,\n            path: new Path2D(clip.path),\n            transform: new DOMMatrix(\n              Array.from(clip.transform.toFloat64Array()),\n            ),\n          })),\n        );\n        clips.push({\n          path: new Path2D(bridge.bounds),\n          transform: new DOMMatrix(Array.from(outer.toFloat64Array())),\n          fillRule: \"nonzero\",\n        });\n        transform = outer.multiply(transform);\n        owner = parent;\n      }\n      return {\n        transform,\n        clips,\n        generation: owner.committedRenderGeneration ?? 0,\n        canvas: owner.canvas as HTMLCanvasElement,\n      };\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,0BAA0B;AACnC,SAAS,gCAAgC;AACzC,SAAS,2BAA2B;AAO7B,SAAS,+BAA+B;AAC7C,QAAM,EAAE,eAAe,cAAc,IAAI,mBAAmB;AAC5D,QAAM,iBAAiB,IAAI;AAAA,IACzB,MAAM,KAAK,yBAAyB,EAAE,eAAe,CAAC;AAAA,EACxD;AACA,QAAM,aAAa,aAAa,cAAc,IAAI,CAAC,UAAU;AAAA,IAC3D,GAAG;AAAA,IACH,MAAM,IAAI,OAAO,KAAK,IAAI;AAAA,IAC1B,WAAW,IAAI,UAAU,MAAM,KAAK,KAAK,UAAU,eAAe,CAAC,CAAC;AAAA,EACtE,EAAE;AACF,QAAM,cAAc,aAAa;AACjC,SAAO;AAAA,IACL,UAAU;AAAA,IACV,WAAW,CAAC,aAAyB,cAAc,UAAU,IAAI,QAAQ;AAAA,IACzE,UAAU,CAAC,aACT,YAAY,SAAS,QAAQ;AAAA,IAC/B,OAAO,MACL,CAAC,cAAc,UAAU,UAAU,CAAC,cAAc,cAAc;AAAA,IAClE,YAAY,MACV,cAAc,UAAU,cAAc,6BAA6B;AAAA,IACrE,UAAU;AACR,UAAI,QAAQ;AACZ,UAAI,YAAY,IAAI;AAAA,QAClB,MAAM,KAAK,eAAe,eAAe,CAAC;AAAA,MAC5C;AACA,UAAI,QAAmC,WAAW,MAAM;AACxD,aAAO,UAAU,MAAM,UAAU,cAAc;AAC7C,cAAM,SACJ,MAAM,UAAU,aAAa,eAAe,IAAI,MAAM,MAAM;AAC9D,YAAI,CAAC,OAAQ,QAAO;AACpB,cAAM,SAAS,CAAC,GAAG,OAAO,YAAY,EAAE;AAAA,UACtC,CAAC,UACC,MAAM,cAAc,oBAAoB,QACxC,MAAM,aAAa;AAAA,QACvB;AACA,YAAI,CAAC,UAAU,OAAO,cAAc,oBAAoB;AACtD,iBAAO;AACT,cAAM,QAAQ,OAAO;AACrB,gBAAQ,MAAM,IAAI,CAAC,UAAU;AAAA,UAC3B,GAAG;AAAA,UACH,WAAW,MAAM,SAAS,KAAK,SAAS;AAAA,QAC1C,EAAE;AACF,cAAM;AAAA,UACJ,GAAG,OAAO,cAAc,IAAI,CAAC,UAAU;AAAA,YACrC,GAAG;AAAA,YACH,MAAM,IAAI,OAAO,KAAK,IAAI;AAAA,YAC1B,WAAW,IAAI;AAAA,cACb,MAAM,KAAK,KAAK,UAAU,eAAe,CAAC;AAAA,YAC5C;AAAA,UACF,EAAE;AAAA,QACJ;AACA,cAAM,KAAK;AAAA,UACT,MAAM,IAAI,OAAO,OAAO,MAAM;AAAA,UAC9B,WAAW,IAAI,UAAU,MAAM,KAAK,MAAM,eAAe,CAAC,CAAC;AAAA,UAC3D,UAAU;AAAA,QACZ,CAAC;AACD,oBAAY,MAAM,SAAS,SAAS;AACpC,gBAAQ;AAAA,MACV;AACA,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,YAAY,MAAM,6BAA6B;AAAA,QAC/C,QAAQ,MAAM;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/types.d.ts

@@ -461,6 +461,8 @@ export interface PibblEventRoot {
 export interface PibblRenderTransaction {
     onPublish?(callback: () => void): void;
     onFinish(callback: (success: boolean) => void): void;
+    /** Run after all finish callbacks have published their committed state. */
+    onAfterFinish?(callback: (success: boolean) => void): void;
 }
 export interface PibblFocusPolicyBridge {
     observeHtmlRegion?(region: HtmlFocusRegion): void;
@@ -529,6 +531,10 @@ export type FillStyle = CanvasRenderingContext2D["fillStyle"] | import('./textur
  */
 export type StrokeStyle = CanvasRenderingContext2D["strokeStyle"] | import('./textures/texture.js').TexturePaint;
 export interface PibblInstance {
+    /** Last root traversal published successfully; failed render attempts do not advance it. */
+    committedRenderGeneration?: number;
+    /** Opt-in root bitmap observers; absent unless a recording is attached. */
+    rootFrameObservers?: Set<(success: boolean, generation: number) => void>;
     canvas: Canvas;
     controller: PibblController;
     root: PibblNode;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pibbl/core",
   "type": "module",
-  "version": "0.0.2",
+  "version": "0.0.3-alpha.90.1",
   "description": "Canvas 2D component runtime with JSX and createElement authoring",
   "author": "Ben Lesh <ben@benlesh.com>",
   "license": "MIT",
@@ -86,6 +86,10 @@
     "./machines/animation": {
       "types": "./dist/features/machines/animation.d.ts",
       "default": "./dist/features/machines/animation.mjs"
+    },
+    "./viz/inspection": {
+      "types": "./dist/features/viz/inspection.d.ts",
+      "default": "./dist/features/viz/inspection.mjs"
     }
   },
   "main": "./dist/index.mjs",
@@ -144,6 +148,9 @@
       ],
       "machines/animation": [
         "./dist/features/machines/animation.d.ts"
+      ],
+      "viz/inspection": [
+        "./dist/features/viz/inspection.d.ts"
       ]
     }
   },
@@ -155,8 +162,9 @@
     "@dimforge/rapier2d-compat": "0.21.0",
     "assemblyscript": "0.28.20"
   },
+  "pibblAlphaInputHash": "4e1aa28c56f216e57a6a34894c8b27de8aa2d133f7ec33db74931ef3c4ffa958",
   "scripts": {
-    "build": "node ../../tooling/build-transition-wasm.mjs --check && rimraf dist && tsc -p tsconfig.build.json && node ../../tooling/build-core.mjs",
+    "build": "node ../../tooling/build-transition-wasm.mjs --check && node ../../tooling/build-recording-wasm.mjs --check && node ../../tooling/build-recording-worker.mjs --check && rimraf dist && tsc -p tsconfig.build.json && node ../../tooling/build-core.mjs",
     "dev": "pnpm run build",
     "test": "vitest"
   }