@pibbl/core 0.0.1

package/dist/lib/render-target.js

@@ -0,0 +1,118 @@
+import { GLOBAL_STATE } from "./global-state.js";
+function rootRenderTarget(surface) {
+  return {
+    logicalBounds: bitmapVisibleLogicalBounds(surface),
+    backingWidth: surface.backingWidth,
+    backingHeight: surface.backingHeight,
+    renderTransform: surface.renderTransform,
+    inverseRenderTransform: surface.inverseRenderTransform
+  };
+}
+function bitmapVisibleLogicalBounds(surface) {
+  const points = [
+    surface.inverseRenderTransform.transformPoint(new DOMPoint(0, 0)),
+    surface.inverseRenderTransform.transformPoint(
+      new DOMPoint(surface.backingWidth, 0)
+    ),
+    surface.inverseRenderTransform.transformPoint(
+      new DOMPoint(0, surface.backingHeight)
+    ),
+    surface.inverseRenderTransform.transformPoint(
+      new DOMPoint(surface.backingWidth, surface.backingHeight)
+    )
+  ];
+  if (points.some((point) => !Number.isFinite(point.x) || !Number.isFinite(point.y))) {
+    throw new Error(
+      "Pibbl root surface inverse projection produced non-finite logical bounds."
+    );
+  }
+  const xs = points.map((point) => point.x);
+  const ys = points.map((point) => point.y);
+  const left = Math.min(...xs);
+  const top = Math.min(...ys);
+  const right = Math.max(...xs);
+  const bottom = Math.max(...ys);
+  return Object.freeze({
+    x: left,
+    y: top,
+    width: right - left,
+    height: bottom - top
+  });
+}
+function getCurrentPaintTransform() {
+  const target = getCurrentRenderTarget();
+  const canvasTransform = getCurrentRenderContext().getTransform();
+  return target.inverseRenderTransform.isIdentity ? canvasTransform : target.inverseRenderTransform.multiply(canvasTransform);
+}
+function getCurrentWorldTransform(paintTransform) {
+  const exactWorld = GLOBAL_STATE.worldExactTransform;
+  const paintAnchor = GLOBAL_STATE.worldPaintAnchorTransform;
+  if (exactWorld && paintAnchor) {
+    const currentPaint = paintTransform ?? getCurrentPaintTransform();
+    if (sameMatrixExactly(paintAnchor, currentPaint)) return exactWorld;
+    return exactWorld.multiply(paintAnchor.inverse()).multiply(currentPaint);
+  }
+  const worldBase = GLOBAL_STATE.worldBaseTransform;
+  if (!worldBase) {
+    throw new Error("No world transform is available.");
+  }
+  return worldBase.multiply(paintTransform ?? getCurrentPaintTransform());
+}
+function hasCurrentWorldTransformCanvasDelta(paintTransform) {
+  const paintAnchor = GLOBAL_STATE.worldPaintAnchorTransform;
+  return paintAnchor !== void 0 && !sameMatrixExactly(paintAnchor, paintTransform ?? getCurrentPaintTransform());
+}
+function sameMatrixExactly(left, right) {
+  return left.a === right.a && left.b === right.b && left.c === right.c && left.d === right.d && left.e === right.e && left.f === right.f;
+}
+function setCurrentWorldTransformAnchor(exactWorld) {
+  GLOBAL_STATE.worldExactTransform = exactWorld;
+  GLOBAL_STATE.worldPaintAnchorTransform = getCurrentPaintTransform();
+}
+function initializeCurrentWorldTransformAnchor(worldBase) {
+  setCurrentWorldTransformAnchor(worldBase.multiply(getCurrentPaintTransform()));
+}
+function withRenderTarget(context, target, worldBase, work) {
+  const previousContext = GLOBAL_STATE.renderContext;
+  const previousTarget = GLOBAL_STATE.renderTarget;
+  const previousWorldBase = GLOBAL_STATE.worldBaseTransform;
+  const previousWorldExact = GLOBAL_STATE.worldExactTransform;
+  const previousWorldPaintAnchor = GLOBAL_STATE.worldPaintAnchorTransform;
+  const previousLineage = GLOBAL_STATE.presentationTransformLineage;
+  try {
+    GLOBAL_STATE.renderContext = context;
+    GLOBAL_STATE.renderTarget = target;
+    GLOBAL_STATE.worldBaseTransform = worldBase;
+    initializeCurrentWorldTransformAnchor(worldBase);
+    return work();
+  } finally {
+    GLOBAL_STATE.renderContext = previousContext;
+    GLOBAL_STATE.renderTarget = previousTarget;
+    GLOBAL_STATE.worldBaseTransform = previousWorldBase;
+    GLOBAL_STATE.worldExactTransform = previousWorldExact;
+    GLOBAL_STATE.worldPaintAnchorTransform = previousWorldPaintAnchor;
+    GLOBAL_STATE.presentationTransformLineage = previousLineage;
+  }
+}
+function getCurrentRenderContext() {
+  if (!GLOBAL_STATE.renderContext) {
+    throw new Error("No render context is available.");
+  }
+  return GLOBAL_STATE.renderContext;
+}
+function getCurrentRenderTarget() {
+  if (!GLOBAL_STATE.renderTarget) {
+    throw new Error("No render target is available.");
+  }
+  return GLOBAL_STATE.renderTarget;
+}
+export {
+  getCurrentPaintTransform,
+  getCurrentWorldTransform,
+  hasCurrentWorldTransformCanvasDelta,
+  initializeCurrentWorldTransformAnchor,
+  rootRenderTarget,
+  setCurrentWorldTransformAnchor,
+  withRenderTarget
+};
+//# sourceMappingURL=render-target.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/render-target.ts"],
+  "sourcesContent": ["import { GLOBAL_STATE } from './global-state.js';\nimport type { LayoutBox } from './layout/types.js';\nimport type { PibblSurfaceSnapshot } from './surface/types.js';\nimport type { RenderingContext2D } from './types.js';\n\nexport interface RenderTargetSnapshot {\n  readonly logicalBounds: Readonly<LayoutBox>;\n  readonly backingWidth: number;\n  readonly backingHeight: number;\n  readonly renderTransform: DOMMatrix;\n  readonly inverseRenderTransform: DOMMatrix;\n}\n\nexport function rootRenderTarget(\n  surface: PibblSurfaceSnapshot,\n): RenderTargetSnapshot {\n  return {\n    logicalBounds: bitmapVisibleLogicalBounds(surface),\n    backingWidth: surface.backingWidth,\n    backingHeight: surface.backingHeight,\n    renderTransform: surface.renderTransform,\n    inverseRenderTransform: surface.inverseRenderTransform,\n  };\n}\n\nfunction bitmapVisibleLogicalBounds(\n  surface: PibblSurfaceSnapshot,\n): Readonly<LayoutBox> {\n  const points = [\n    surface.inverseRenderTransform.transformPoint(new DOMPoint(0, 0)),\n    surface.inverseRenderTransform.transformPoint(\n      new DOMPoint(surface.backingWidth, 0),\n    ),\n    surface.inverseRenderTransform.transformPoint(\n      new DOMPoint(0, surface.backingHeight),\n    ),\n    surface.inverseRenderTransform.transformPoint(\n      new DOMPoint(surface.backingWidth, surface.backingHeight),\n    ),\n  ];\n  if (points.some(point => !Number.isFinite(point.x) || !Number.isFinite(point.y))) {\n    throw new Error(\n      'Pibbl root surface inverse projection produced non-finite logical bounds.',\n    );\n  }\n  const xs = points.map(point => point.x);\n  const ys = points.map(point => point.y);\n  const left = Math.min(...xs);\n  const top = Math.min(...ys);\n  const right = Math.max(...xs);\n  const bottom = Math.max(...ys);\n  return Object.freeze({\n    x: left,\n    y: top,\n    width: right - left,\n    height: bottom - top,\n  });\n}\n\nexport function getCurrentPaintTransform(): DOMMatrix {\n  const target = getCurrentRenderTarget();\n  const canvasTransform = getCurrentRenderContext().getTransform();\n  return target.inverseRenderTransform.isIdentity ? canvasTransform :\n    target.inverseRenderTransform.multiply(canvasTransform);\n}\n\n/**\n * Returns the current logical world transform, optionally incorporating a supplied paint\n * transform.\n *\n * @param paintTransform - Optional paint transform to include in the world transform.\n * @returns The transform mapping local geometry into world coordinates.\n *\n * @see {@link LayoutBox}\n */\nexport function getCurrentWorldTransform(paintTransform?: DOMMatrix): DOMMatrix {\n  const exactWorld = GLOBAL_STATE.worldExactTransform;\n  const paintAnchor = GLOBAL_STATE.worldPaintAnchorTransform;\n  if (exactWorld && paintAnchor) {\n    const currentPaint = paintTransform ?? getCurrentPaintTransform();\n    if (sameMatrixExactly(paintAnchor, currentPaint)) return exactWorld;\n    return exactWorld.multiply(paintAnchor.inverse()).multiply(currentPaint);\n  }\n  const worldBase = GLOBAL_STATE.worldBaseTransform;\n  if (!worldBase) {\n    throw new Error('No world transform is available.');\n  }\n  return worldBase.multiply(paintTransform ?? getCurrentPaintTransform());\n}\n\n/** Whether direct Canvas calls changed paint since the last Pibbl-owned anchor. */\nexport function hasCurrentWorldTransformCanvasDelta(paintTransform?: DOMMatrix): boolean {\n  const paintAnchor = GLOBAL_STATE.worldPaintAnchorTransform;\n  return paintAnchor !== undefined &&\n    !sameMatrixExactly(paintAnchor, paintTransform ?? getCurrentPaintTransform());\n}\n\nfunction sameMatrixExactly(\n  left: DOMMatrixReadOnly,\n  right: DOMMatrixReadOnly,\n): boolean {\n  return left.a === right.a && left.b === right.b &&\n    left.c === right.c && left.d === right.d &&\n    left.e === right.e && left.f === right.f;\n}\n\nexport function setCurrentWorldTransformAnchor(exactWorld: DOMMatrix): void {\n  GLOBAL_STATE.worldExactTransform = exactWorld;\n  GLOBAL_STATE.worldPaintAnchorTransform = getCurrentPaintTransform();\n}\n\nexport function initializeCurrentWorldTransformAnchor(worldBase: DOMMatrix): void {\n  setCurrentWorldTransformAnchor(worldBase.multiply(getCurrentPaintTransform()));\n}\n\nexport function withRenderTarget<T>(\n  context: RenderingContext2D,\n  target: RenderTargetSnapshot,\n  worldBase: DOMMatrix,\n  work: () => T,\n): T {\n  const previousContext = GLOBAL_STATE.renderContext;\n  const previousTarget = GLOBAL_STATE.renderTarget;\n  const previousWorldBase = GLOBAL_STATE.worldBaseTransform;\n  const previousWorldExact = GLOBAL_STATE.worldExactTransform;\n  const previousWorldPaintAnchor = GLOBAL_STATE.worldPaintAnchorTransform;\n  const previousLineage = GLOBAL_STATE.presentationTransformLineage;\n  try {\n    GLOBAL_STATE.renderContext = context;\n    GLOBAL_STATE.renderTarget = target;\n    GLOBAL_STATE.worldBaseTransform = worldBase;\n    initializeCurrentWorldTransformAnchor(worldBase);\n    return work();\n  } finally {\n    GLOBAL_STATE.renderContext = previousContext;\n    GLOBAL_STATE.renderTarget = previousTarget;\n    GLOBAL_STATE.worldBaseTransform = previousWorldBase;\n    GLOBAL_STATE.worldExactTransform = previousWorldExact;\n    GLOBAL_STATE.worldPaintAnchorTransform = previousWorldPaintAnchor;\n    GLOBAL_STATE.presentationTransformLineage = previousLineage;\n  }\n}\n\nfunction getCurrentRenderContext(): RenderingContext2D {\n  if (!GLOBAL_STATE.renderContext) {\n    throw new Error('No render context is available.');\n  }\n  return GLOBAL_STATE.renderContext;\n}\n\nfunction getCurrentRenderTarget(): RenderTargetSnapshot {\n  if (!GLOBAL_STATE.renderTarget) {\n    throw new Error('No render target is available.');\n  }\n  return GLOBAL_STATE.renderTarget;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/render-transaction.d.ts

@@ -0,0 +1,10 @@
+import type { PibblRenderTransaction } from './types.js';
+/** Root-wide publication precedes focus/policy commit in both render paths. */
+export declare class RootRenderTransaction implements PibblRenderTransaction {
+    private publications;
+    private callbacks;
+    private result;
+    onPublish(callback: () => void): void;
+    onFinish(callback: (success: boolean) => void): void;
+    finish(success: boolean): void;
+}

package/dist/lib/render-transaction.js

@@ -0,0 +1,46 @@
+class RootRenderTransaction {
+  publications = /* @__PURE__ */ new Set();
+  callbacks = /* @__PURE__ */ new Set();
+  result;
+  onPublish(callback) {
+    if (this.result !== void 0) {
+      if (this.result) callback();
+    } else this.publications.add(callback);
+  }
+  onFinish(callback) {
+    if (this.result !== void 0) callback(this.result);
+    else this.callbacks.add(callback);
+  }
+  finish(success) {
+    if (this.result !== void 0) return;
+    const errors = [];
+    if (success) {
+      for (const publish of this.publications) {
+        try {
+          publish();
+        } catch (error) {
+          errors.push(error);
+          success = false;
+          break;
+        }
+      }
+    }
+    this.publications.clear();
+    this.result = success;
+    const callbacks = Array.from(this.callbacks);
+    this.callbacks.clear();
+    for (const callback of callbacks) {
+      try {
+        callback(success);
+      } catch (error) {
+        errors.push(error);
+      }
+    }
+    if (errors.length === 1) throw errors[0];
+    if (errors.length) throw new AggregateError(errors, "Pibbl render completion failed.");
+  }
+}
+export {
+  RootRenderTransaction
+};
+//# sourceMappingURL=render-transaction.js.map

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

@@ -0,0 +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;",
+  "names": []
+}

package/dist/lib/render.d.ts

@@ -0,0 +1,3 @@
+import { PibblComponentRefs } from './types.js';
+import type { PibblNode } from './element/types.js';
+export declare function render(node: PibblNode, parentId: string, parent: PibblComponentRefs<any> | undefined): void;

package/dist/lib/render.js

@@ -0,0 +1,385 @@
+import {
+  clearComponentState,
+  getAnonElemName,
+  GLOBAL_STATE
+} from "./global-state.js";
+import { Teardowns } from "./teardowns.js";
+import { finalizeHookSlots } from "./hooks/hook-slot.js";
+import { resolveElementStyle, takePreNormalizedStyle } from "./style/resolve-dispatch.js";
+import {
+  getPlacementSignalHandoff,
+  enterPlacementHandoffCapture,
+  withPlacementHandoff
+} from "./style/positioning.js";
+import {
+  enterElementEnhancers,
+  exitElementEnhancers,
+  hasElementEnhancers,
+  prepareElementEnhancers,
+  reconcileElementEnhancers
+} from "./element-enhancers.js";
+import {
+  getPlacementIdentityHint,
+  getPrimitiveDefinition,
+  getPrimitiveReceiverToken,
+  getElementSource,
+  isPlacementConsumed
+} from "./element/metadata.js";
+import { resolvePrimitiveInputs } from "./element/resolve-primitive-inputs.js";
+import { materializeContainerChildren } from "./element/children.js";
+import { isFragmentElement } from "./element/fragment.js";
+import {
+  backendMismatchError
+} from "./backend/types.js";
+import {
+  collectComponentSignalReads,
+  disposeSignalRenderConsumer
+} from "./signals/render-consumer.js";
+import { adoptReceiverInputProvision } from "./signals/input-provision.js";
+import { untracked } from "./signals/graph.js";
+import { requestInstanceRender } from "./scheduler/realm-scheduler.js";
+import {
+  getCurrentWorldTransform,
+  hasCurrentWorldTransformCanvasDelta
+} from "./render-target.js";
+function render(node, parentId, parent) {
+  const elements = materializeContainerChildren(node, "Pibbl root");
+  renderPreparedChildren(elements, parentId, parent);
+}
+function renderPreparedChildren(elements, parentId, parent) {
+  for (const element of elements) {
+    renderPreparedElement(element, parentId, parent);
+  }
+}
+function renderPreparedElement(element, parentId, parent) {
+  if (isFragmentElement(element)) {
+    renderKeyedFragment(element, parentId, parent);
+    return;
+  }
+  renderComponentElement(element, parentId, parent);
+}
+function renderKeyedFragment(element, parentId, parent) {
+  try {
+    const componentRefs = prepareComponentScope(
+      element,
+      parentId,
+      parent
+    );
+    reconcileElementEnhancers(
+      componentRefs,
+      GLOBAL_STATE.currentPibblInstance
+    );
+    const enteredEnhancers = enterElementEnhancers(componentRefs);
+    let enhancerSuccess = false;
+    let releaseComponent;
+    try {
+      releaseComponent = enterBackendComponent();
+      collectComponentSignalReads(
+        componentRefs,
+        () => componentSignalReadOptions(componentRefs),
+        (commitSignalReads) => {
+          const receiverToken = getPrimitiveReceiverToken(componentRefs.element) ?? componentRefs;
+          adoptReceiverInputProvision(
+            GLOBAL_STATE.renderTransaction,
+            receiverToken
+          );
+          const children = materializeContainerChildren(
+            element.props.children,
+            element
+          );
+          commitSignalReads();
+          untracked(() => {
+            renderPreparedChildren(children, componentRefs.id, componentRefs);
+          });
+        }
+      );
+      componentRefs.signalConsumer?.markClean();
+      enhancerSuccess = true;
+    } finally {
+      try {
+        releaseComponent?.();
+      } finally {
+        exitElementEnhancers(enteredEnhancers, enhancerSuccess);
+      }
+    }
+  } finally {
+    clearComponentState();
+  }
+}
+function renderComponentElement(element, parentId, parent) {
+  try {
+    const componentRefs = prepareComponentScope(element, parentId, parent);
+    const id = componentRefs.id;
+    GLOBAL_STATE.componentRefs = componentRefs;
+    GLOBAL_STATE.componentHookIndex = 0;
+    const definition = getPrimitiveDefinition(componentRefs.element.type);
+    const receiverToken = getPrimitiveReceiverToken(componentRefs.element) ?? componentRefs;
+    reconcileElementEnhancers(
+      componentRefs,
+      GLOBAL_STATE.currentPibblInstance,
+      definition !== void 0
+    );
+    const enteredEnhancers = enterElementEnhancers(componentRefs);
+    let enhancerSuccess = false;
+    let releaseComponent;
+    try {
+      const { driver, frame } = requireBackendFrame();
+      releaseComponent = driver.enterComponent(frame);
+      let onAfterRender;
+      let afterRenderFinished = false;
+      const finishAfterRender = () => {
+        if (afterRenderFinished) return;
+        afterRenderFinished = true;
+        onAfterRender ??= componentRefs.onAfterRender;
+        componentRefs.onAfterRender = void 0;
+        onAfterRender?.();
+      };
+      try {
+        collectComponentSignalReads(componentRefs, () => ({
+          ...componentSignalReadOptions(componentRefs)
+        }), (commitSignalReads) => {
+          adoptReceiverInputProvision(
+            GLOBAL_STATE.renderTransaction,
+            receiverToken
+          );
+          const renderProgram = (invoke) => {
+            try {
+              const previousReceiverToken = GLOBAL_STATE.primitiveReceiverToken;
+              GLOBAL_STATE.primitiveReceiverToken = receiverToken;
+              let result;
+              try {
+                result = invoke();
+              } finally {
+                GLOBAL_STATE.primitiveReceiverToken = previousReceiverToken;
+              }
+              finalizeHookSlots(componentRefs);
+              onAfterRender = componentRefs.onAfterRender;
+              componentRefs.onAfterRender = void 0;
+              const children = materializeContainerChildren(
+                result,
+                componentRefs.element
+              );
+              commitSignalReads();
+              untracked(() => {
+                renderPreparedChildren(children, id, componentRefs);
+              });
+            } finally {
+              finishAfterRender();
+            }
+          };
+          if (definition) {
+            if (definition.backend !== driver.token) {
+              throw backendMismatchError(
+                componentRefs.element.type.name || "Anonymous",
+                definition.backend,
+                driver,
+                getElementSource(componentRefs.element)
+              );
+            }
+            const preparedStyle = takePreNormalizedStyle(componentRefs.element);
+            const inputs = resolvePrimitiveInputs(
+              componentRefs.element,
+              definition,
+              preparedStyle
+            );
+            const style = (() => {
+              const previousReceiverToken = GLOBAL_STATE.primitiveReceiverToken;
+              GLOBAL_STATE.primitiveReceiverToken = receiverToken;
+              try {
+                return resolveElementStyle(
+                  componentRefs.element,
+                  inputs.style,
+                  true,
+                  preparedStyle
+                );
+              } finally {
+                GLOBAL_STATE.primitiveReceiverToken = previousReceiverToken;
+              }
+            })();
+            const componentName = componentRefs.element.type.name || "Anonymous";
+            const source = getElementSource(componentRefs.element);
+            const props = inputs.props;
+            const tracksPresentationLineage = hasElementEnhancers(componentRefs);
+            const tracksCanvasWorldTransform = GLOBAL_STATE.worldBaseTransform !== void 0 && GLOBAL_STATE.renderContext !== void 0 && GLOBAL_STATE.renderTarget !== void 0;
+            const prepared = tracksPresentationLineage ? prepareElementEnhancers(componentRefs, {
+              componentType: componentRefs.element.type,
+              componentName,
+              props,
+              style,
+              source,
+              parentWorldTransform: tracksCanvasWorldTransform ? getCurrentWorldTransform() : new DOMMatrix(),
+              presentationTransformLineage: GLOBAL_STATE.presentationTransformLineage,
+              hasUntrackedCanvasTransform: tracksCanvasWorldTransform && hasCurrentWorldTransformCanvasDelta()
+            }) : void 0;
+            let invoked = false;
+            if (tracksPresentationLineage) {
+              GLOBAL_STATE.presentationTransformLineageTrackingDepth += 1;
+            }
+            try {
+              driver.runPrimitive(frame, {
+                componentName,
+                source,
+                definition,
+                props,
+                style,
+                presentationTransform2D: prepared?.presentationTransform2D
+              }, (invoke) => {
+                if (invoked) {
+                  throw new Error(
+                    `${driver.name} invoked ${componentName} more than once in one traversal.`
+                  );
+                }
+                invoked = true;
+                renderProgram(invoke);
+              });
+            } finally {
+              if (tracksPresentationLineage) {
+                GLOBAL_STATE.presentationTransformLineageTrackingDepth -= 1;
+              }
+            }
+            if (!invoked) {
+              throw new Error(
+                `${driver.name} did not invoke ${componentName} during traversal.`
+              );
+            }
+          } else {
+            const preparedStyle = takePreNormalizedStyle(componentRefs.element);
+            const signalHandoff = getPlacementSignalHandoff(componentRefs.element);
+            const consumedStyle = preparedStyle?.style ?? signalHandoff;
+            const receivesPlacementHandoff = isPlacementConsumed(componentRefs.element) || signalHandoff !== void 0;
+            const props = isPlacementConsumed(componentRefs.element) ? withPlacementHandoff(componentRefs.element.props, consumedStyle) : componentRefs.element.props;
+            renderProgram(() => {
+              const releaseHandoff = receivesPlacementHandoff ? enterPlacementHandoffCapture(props, consumedStyle) : void 0;
+              try {
+                return componentRefs.element.type(props);
+              } finally {
+                releaseHandoff?.();
+              }
+            });
+          }
+        });
+        componentRefs.signalConsumer?.markClean();
+      } finally {
+        try {
+          finishAfterRender();
+        } finally {
+          releaseComponent?.();
+        }
+      }
+      enhancerSuccess = true;
+    } finally {
+      exitElementEnhancers(enteredEnhancers, enhancerSuccess);
+    }
+  } finally {
+    clearComponentState();
+  }
+}
+function componentSignalReadOptions(componentRefs) {
+  const pibblInstance = GLOBAL_STATE.currentPibblInstance;
+  return {
+    debugName: `${componentRefs.element.type.name || "Anonymous"} (${componentRefs.id})`,
+    invalidate: () => {
+      if (GLOBAL_STATE.pibblInstances.get(pibblInstance.canvas) !== pibblInstance || pibblInstance.mainTeardowns.closed || componentRefs.teardowns.closed || pibblInstance.refs.get(componentRefs.id) !== componentRefs) {
+        return;
+      }
+      requestInstanceRender(pibblInstance);
+    },
+    onMaterialize: () => {
+      if (componentRefs.signalConsumerTeardownAttached) return;
+      componentRefs.signalConsumerTeardownAttached = true;
+      componentRefs.teardowns.add(() => {
+        const consumer = componentRefs.signalConsumer;
+        componentRefs.signalConsumer = void 0;
+        if (consumer !== void 0) {
+          disposeSignalRenderConsumer(consumer);
+        }
+      });
+    }
+  };
+}
+function requireBackendFrame() {
+  const driver = GLOBAL_STATE.backendDriver;
+  const frame = GLOBAL_STATE.backendFrame;
+  if (!driver || !frame) {
+    throw new Error("Pibbl component traversal requires an active backend frame.");
+  }
+  return { driver, frame };
+}
+function enterBackendComponent() {
+  const { driver, frame } = requireBackendFrame();
+  return driver.enterComponent(frame);
+}
+function prepareComponentScope(element, parentId, parent) {
+  const pibblInstance = GLOBAL_STATE.currentPibblInstance;
+  const typeName = getElementTypeName(element, parentId);
+  const id = ensureUniqueId(parentId, typeName);
+  GLOBAL_STATE.seenIds.add(id);
+  let componentRefs = pibblInstance.refs.get(id);
+  GLOBAL_STATE.componentIsMounting = componentRefs === void 0;
+  if (componentRefs === void 0) {
+    const teardowns = new Teardowns();
+    teardowns.follow(pibblInstance.mainTeardowns);
+    const mountedRefs = {
+      id,
+      parent,
+      element,
+      renderGeneration: pibblInstance.renderGeneration,
+      refs: [],
+      hooks: [],
+      signalConsumer: void 0,
+      signalConsumerTeardownAttached: false,
+      teardowns,
+      onAfterRender: void 0
+    };
+    pibblInstance.refs.set(id, mountedRefs);
+    componentRefs = mountedRefs;
+  }
+  componentRefs.parent = parent;
+  componentRefs.element = element;
+  componentRefs.renderGeneration = pibblInstance.renderGeneration;
+  const layout = GLOBAL_STATE.layoutStack?.at(-1);
+  if (!layout) componentRefs.layoutEntry = void 0;
+  else {
+    const previous = componentRefs.layoutEntry;
+    const allocation = captureLayoutBox(previous?.allocation, layout.allocation);
+    const percentageBasis = captureLayoutBox(previous?.percentageBasis, layout.percentageBasis);
+    if (allocation !== previous?.allocation || percentageBasis !== previous?.percentageBasis) {
+      componentRefs.layoutEntry = Object.freeze({ allocation, percentageBasis });
+    }
+  }
+  return componentRefs;
+}
+function captureLayoutBox(previous, box) {
+  if (previous && previous.x === box.x && previous.y === box.y && previous.width === box.width && previous.height === box.height) return previous;
+  return Object.freeze({ x: box.x, y: box.y, width: box.width, height: box.height });
+}
+function getElementTypeName(element, parentId) {
+  const identityHint = getPlacementIdentityHint(element);
+  const identityType = identityHint?.type ?? element.type;
+  const typeIdentity = getAnonElemName(identityType);
+  const typeName = identityType.name || "Anonymous";
+  const key = identityHint ? identityHint.key : element.key;
+  if (key === void 0) {
+    const occurrence = identityHint?.occurrence ?? 0;
+    return `${typeName}:${typeIdentity}${occurrence ? `_${occurrence}` : ""}`;
+  }
+  const encodedKey = encodeURIComponent(key);
+  const siblingKey = `${parentId}/${encodedKey}`;
+  if (GLOBAL_STATE.seenKeys.has(siblingKey)) {
+    throw new Error(`Duplicate Pibbl key "${key}" under "${parentId}"`);
+  }
+  GLOBAL_STATE.seenKeys.add(siblingKey);
+  return `${typeName}:${typeIdentity}[${encodedKey}]`;
+}
+function ensureUniqueId(parentId, typeName) {
+  let id = `${parentId}/${typeName}`;
+  let n = 1;
+  while (GLOBAL_STATE.seenIds.has(id)) {
+    id = `${parentId}/${typeName}_${n++}`;
+  }
+  return id;
+}
+export {
+  render
+};
+//# sourceMappingURL=render.js.map

package/dist/lib/render.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/render.ts"],
+  "sourcesContent": ["import {\n  clearComponentState,\n  getAnonElemName,\n  GLOBAL_STATE,\n} from './global-state.js';\nimport { Teardowns } from './teardowns.js';\nimport { PibblComponentRefs } from './types.js';\nimport type { LayoutBox } from './layout/types.js';\nimport { finalizeHookSlots } from './hooks/hook-slot.js';\nimport { resolveElementStyle, takePreNormalizedStyle } from './style/resolve-dispatch.js';\nimport {\n  getPlacementSignalHandoff,\n  enterPlacementHandoffCapture,\n  withPlacementHandoff,\n} from './style/positioning.js';\nimport {\n  enterElementEnhancers,\n  exitElementEnhancers,\n  hasElementEnhancers,\n  prepareElementEnhancers,\n  reconcileElementEnhancers,\n} from './element-enhancers.js';\nimport {\n  getPlacementIdentityHint,\n  getPrimitiveDefinition,\n  getPrimitiveReceiverToken,\n  getElementSource,\n  isPlacementConsumed,\n} from './element/metadata.js';\nimport { resolvePrimitiveInputs } from './element/resolve-primitive-inputs.js';\nimport { materializeContainerChildren } from './element/children.js';\nimport { isFragmentElement } from './element/fragment.js';\nimport type { PibblElement, PibblNode, PibblNodeInput } from './element/types.js';\nimport {\n  backendMismatchError,\n  type PibblBackendDriver,\n  type PibblBackendFrame,\n} from './backend/types.js';\nimport {\n  collectComponentSignalReads,\n  disposeSignalRenderConsumer,\n} from './signals/render-consumer.js';\nimport { adoptReceiverInputProvision } from './signals/input-provision.js';\nimport { untracked } from './signals/graph.js';\nimport { requestInstanceRender } from './scheduler/realm-scheduler.js';\nimport {\n  getCurrentWorldTransform,\n  hasCurrentWorldTransformCanvasDelta,\n} from './render-target.js';\n\nexport function render(\n  node: PibblNode,\n  parentId: string,\n  parent: PibblComponentRefs<any> | undefined,\n): void {\n  const elements = materializeContainerChildren(node, 'Pibbl root');\n  renderPreparedChildren(elements, parentId, parent);\n}\n\nfunction renderPreparedChildren(\n  elements: readonly PibblElement<any>[],\n  parentId: string,\n  parent: PibblComponentRefs<any> | undefined,\n): void {\n  for (const element of elements) {\n    renderPreparedElement(element, parentId, parent);\n  }\n}\n\nfunction renderPreparedElement(\n  element: PibblElement<any>,\n  parentId: string,\n  parent: PibblComponentRefs<any> | undefined,\n): void {\n  if (isFragmentElement(element)) {\n    renderKeyedFragment(element, parentId, parent);\n    return;\n  }\n  renderComponentElement(element, parentId, parent);\n}\n\nfunction renderKeyedFragment(\n  element: PibblElement<any>,\n  parentId: string,\n  parent: PibblComponentRefs<any> | undefined,\n): void {\n  try {\n    const componentRefs = prepareComponentScope(\n      element,\n      parentId,\n      parent,\n    );\n    reconcileElementEnhancers(\n      componentRefs,\n      GLOBAL_STATE.currentPibblInstance!,\n    );\n    const enteredEnhancers = enterElementEnhancers(componentRefs);\n    let enhancerSuccess = false;\n    let releaseComponent: (() => void) | undefined;\n    try {\n      releaseComponent = enterBackendComponent();\n      collectComponentSignalReads(\n        componentRefs,\n        () => componentSignalReadOptions(componentRefs),\n        commitSignalReads => {\n          const receiverToken =\n            getPrimitiveReceiverToken(componentRefs.element) ?? componentRefs;\n          adoptReceiverInputProvision(\n            GLOBAL_STATE.renderTransaction,\n            receiverToken,\n          );\n          const children = materializeContainerChildren(\n            element.props.children,\n            element,\n          );\n          commitSignalReads();\n          untracked(() => {\n            renderPreparedChildren(children, componentRefs.id, componentRefs);\n          });\n        },\n      );\n      componentRefs.signalConsumer?.markClean();\n      enhancerSuccess = true;\n    } finally {\n      try {\n        releaseComponent?.();\n      } finally {\n        exitElementEnhancers(enteredEnhancers, enhancerSuccess);\n      }\n    }\n  } finally {\n    clearComponentState();\n  }\n}\n\nfunction renderComponentElement<P>(\n  element: PibblElement<P>,\n  parentId: string,\n  parent: PibblComponentRefs<any> | undefined,\n): void {\n  try {\n    const componentRefs = prepareComponentScope(element, parentId, parent);\n    const id = componentRefs.id;\n    GLOBAL_STATE.componentRefs = componentRefs;\n    GLOBAL_STATE.componentHookIndex = 0;\n    const definition = getPrimitiveDefinition(componentRefs.element.type);\n    const receiverToken =\n      getPrimitiveReceiverToken(componentRefs.element) ?? componentRefs;\n\n    reconcileElementEnhancers(\n      componentRefs,\n      GLOBAL_STATE.currentPibblInstance!,\n      definition !== undefined,\n    );\n    const enteredEnhancers = enterElementEnhancers(componentRefs);\n    let enhancerSuccess = false;\n    let releaseComponent: (() => void) | undefined;\n    try {\n      const { driver, frame } = requireBackendFrame();\n      releaseComponent = driver.enterComponent(frame);\n      let onAfterRender: (() => void) | undefined;\n      let afterRenderFinished = false;\n      const finishAfterRender = () => {\n        if (afterRenderFinished) return;\n        afterRenderFinished = true;\n        onAfterRender ??= componentRefs.onAfterRender;\n        componentRefs.onAfterRender = undefined;\n        onAfterRender?.();\n      };\n      try {\n        collectComponentSignalReads(componentRefs, () => ({\n          ...componentSignalReadOptions(componentRefs),\n        }), commitSignalReads => {\n          adoptReceiverInputProvision(\n            GLOBAL_STATE.renderTransaction,\n            receiverToken,\n          );\n          const renderProgram = (invoke: () => PibblNodeInput | void) => {\n            try {\n              const previousReceiverToken = GLOBAL_STATE.primitiveReceiverToken;\n              GLOBAL_STATE.primitiveReceiverToken = receiverToken;\n              let result: PibblNodeInput | void;\n              try {\n                result = invoke();\n              } finally {\n                GLOBAL_STATE.primitiveReceiverToken = previousReceiverToken;\n              }\n              finalizeHookSlots(componentRefs);\n\n              onAfterRender = componentRefs.onAfterRender;\n              componentRefs.onAfterRender = undefined;\n              const children = materializeContainerChildren(\n                result as PibblNodeInput,\n                componentRefs.element,\n              );\n              commitSignalReads();\n\n              untracked(() => {\n                renderPreparedChildren(children, id, componentRefs);\n              });\n            } finally {\n              finishAfterRender();\n            }\n          };\n          if (definition) {\n            if (definition.backend !== driver.token) {\n              throw backendMismatchError(\n                componentRefs.element.type.name || 'Anonymous',\n                definition.backend,\n                driver,\n                getElementSource(componentRefs.element),\n              );\n            }\n            const preparedStyle = takePreNormalizedStyle(componentRefs.element);\n            const inputs = resolvePrimitiveInputs(\n              componentRefs.element,\n              definition,\n              preparedStyle,\n            );\n            const style = (() => {\n              const previousReceiverToken = GLOBAL_STATE.primitiveReceiverToken;\n              GLOBAL_STATE.primitiveReceiverToken = receiverToken;\n              try {\n                return resolveElementStyle(\n                  componentRefs.element,\n                  inputs.style,\n                  true,\n                  preparedStyle,\n                );\n              } finally {\n                GLOBAL_STATE.primitiveReceiverToken = previousReceiverToken;\n              }\n            })();\n            const componentName = componentRefs.element.type.name || 'Anonymous';\n            const source = getElementSource(componentRefs.element);\n            const props = inputs.props;\n            const tracksPresentationLineage = hasElementEnhancers(componentRefs);\n            const tracksCanvasWorldTransform =\n              GLOBAL_STATE.worldBaseTransform !== undefined &&\n              GLOBAL_STATE.renderContext !== undefined &&\n              GLOBAL_STATE.renderTarget !== undefined;\n            const prepared = tracksPresentationLineage\n              ? prepareElementEnhancers(componentRefs, {\n                  componentType: componentRefs.element.type,\n                  componentName,\n                  props,\n                  style,\n                  source,\n                  parentWorldTransform: tracksCanvasWorldTransform ?\n                    getCurrentWorldTransform() : new DOMMatrix(),\n                  presentationTransformLineage:\n                    GLOBAL_STATE.presentationTransformLineage,\n                  hasUntrackedCanvasTransform: tracksCanvasWorldTransform &&\n                    hasCurrentWorldTransformCanvasDelta(),\n                })\n              : undefined;\n            let invoked = false;\n            if (tracksPresentationLineage) {\n              GLOBAL_STATE.presentationTransformLineageTrackingDepth += 1;\n            }\n            try {\n              driver.runPrimitive(frame, {\n                componentName,\n                source,\n                definition,\n                props,\n                style,\n                presentationTransform2D: prepared?.presentationTransform2D,\n              }, invoke => {\n                if (invoked) {\n                  throw new Error(\n                    `${driver.name} invoked ${componentName} more than once in one traversal.`,\n                  );\n                }\n                invoked = true;\n                renderProgram(invoke);\n              });\n            } finally {\n              if (tracksPresentationLineage) {\n                GLOBAL_STATE.presentationTransformLineageTrackingDepth -= 1;\n              }\n            }\n            if (!invoked) {\n              throw new Error(\n                `${driver.name} did not invoke ${componentName} during traversal.`,\n              );\n            }\n          } else {\n            // Layout owns the outer translation. A private marker survives one\n            // intentional `{ ...style }` forward without changing other children.\n            const preparedStyle = takePreNormalizedStyle(componentRefs.element);\n            const signalHandoff = getPlacementSignalHandoff(componentRefs.element);\n            const consumedStyle = preparedStyle?.style ?? signalHandoff;\n            const receivesPlacementHandoff =\n              isPlacementConsumed(componentRefs.element) ||\n              signalHandoff !== undefined;\n            const props = isPlacementConsumed(componentRefs.element) ?\n              withPlacementHandoff(componentRefs.element.props, consumedStyle) :\n              componentRefs.element.props;\n            renderProgram(() => {\n              const releaseHandoff = receivesPlacementHandoff ?\n                enterPlacementHandoffCapture(props, consumedStyle) :\n                undefined;\n              try {\n                return componentRefs.element.type(props);\n              } finally {\n                releaseHandoff?.();\n              }\n            });\n          }\n        });\n        componentRefs.signalConsumer?.markClean();\n      } finally {\n        try {\n          finishAfterRender();\n        } finally {\n          releaseComponent?.();\n        }\n      }\n      enhancerSuccess = true;\n    } finally {\n      exitElementEnhancers(enteredEnhancers, enhancerSuccess);\n    }\n  } finally {\n    clearComponentState();\n  }\n}\n\nfunction componentSignalReadOptions(\n  componentRefs: PibblComponentRefs<any>,\n) {\n  const pibblInstance = GLOBAL_STATE.currentPibblInstance!;\n  return {\n    debugName: `${componentRefs.element.type.name || 'Anonymous'} (${componentRefs.id})`,\n    invalidate: () => {\n      if (\n        GLOBAL_STATE.pibblInstances.get(pibblInstance.canvas) !== pibblInstance ||\n        pibblInstance.mainTeardowns.closed ||\n        componentRefs.teardowns.closed ||\n        pibblInstance.refs.get(componentRefs.id) !== componentRefs\n      ) {\n        return;\n      }\n      requestInstanceRender(pibblInstance);\n    },\n    onMaterialize: () => {\n      if (componentRefs.signalConsumerTeardownAttached) return;\n      componentRefs.signalConsumerTeardownAttached = true;\n      componentRefs.teardowns.add(() => {\n        const consumer = componentRefs.signalConsumer;\n        componentRefs.signalConsumer = undefined;\n        if (consumer !== undefined) {\n          disposeSignalRenderConsumer(consumer);\n        }\n      });\n    },\n  };\n}\n\nfunction requireBackendFrame(): {\n  driver: PibblBackendDriver<unknown>;\n  frame: PibblBackendFrame<unknown>;\n} {\n  const driver = GLOBAL_STATE.backendDriver;\n  const frame = GLOBAL_STATE.backendFrame;\n  if (!driver || !frame) {\n    throw new Error('Pibbl component traversal requires an active backend frame.');\n  }\n  return { driver, frame };\n}\n\nfunction enterBackendComponent(): () => void {\n  const { driver, frame } = requireBackendFrame();\n  return driver.enterComponent(frame);\n}\n\nfunction prepareComponentScope<P>(\n  element: PibblElement<P>,\n  parentId: string,\n  parent: PibblComponentRefs<any> | undefined,\n): PibblComponentRefs<P> {\n  const pibblInstance = GLOBAL_STATE.currentPibblInstance!;\n  const typeName = getElementTypeName(element, parentId);\n  const id = ensureUniqueId(parentId, typeName);\n  GLOBAL_STATE.seenIds!.add(id);\n  let componentRefs = pibblInstance.refs.get(id) as\n    PibblComponentRefs<P> | undefined;\n  GLOBAL_STATE.componentIsMounting = componentRefs === undefined;\n  if (componentRefs === undefined) {\n    const teardowns = new Teardowns();\n    teardowns.follow(pibblInstance.mainTeardowns);\n    const mountedRefs: PibblComponentRefs<P> = {\n      id,\n      parent,\n      element,\n      renderGeneration: pibblInstance.renderGeneration,\n      refs: [],\n      hooks: [],\n      signalConsumer: undefined,\n      signalConsumerTeardownAttached: false,\n      teardowns,\n      onAfterRender: undefined,\n    };\n    pibblInstance.refs.set(id, mountedRefs);\n    componentRefs = mountedRefs;\n  }\n\n  componentRefs.parent = parent;\n  componentRefs.element = element;\n  componentRefs.renderGeneration = pibblInstance.renderGeneration;\n  const layout = GLOBAL_STATE.layoutStack?.at(-1);\n  if (!layout) componentRefs.layoutEntry = undefined;\n  else {\n    const previous = componentRefs.layoutEntry;\n    const allocation = captureLayoutBox(previous?.allocation, layout.allocation);\n    const percentageBasis = captureLayoutBox(previous?.percentageBasis, layout.percentageBasis);\n    if (allocation !== previous?.allocation || percentageBasis !== previous?.percentageBasis) {\n      componentRefs.layoutEntry = Object.freeze({ allocation, percentageBasis });\n    }\n  }\n  return componentRefs;\n}\n\n/** Constant-sized numeric evidence; unchanged entry contexts allocate nothing. */\nfunction captureLayoutBox(previous: Readonly<LayoutBox> | undefined, box: Readonly<LayoutBox>): Readonly<LayoutBox> {\n  if (previous && previous.x === box.x && previous.y === box.y &&\n      previous.width === box.width && previous.height === box.height) return previous;\n  return Object.freeze({ x: box.x, y: box.y, width: box.width, height: box.height });\n}\n\nfunction getElementTypeName(element: PibblElement<any>, parentId: string): string {\n  const identityHint = getPlacementIdentityHint<{\n    type: PibblElement<any>['type'];\n    key: string | undefined;\n    occurrence: number;\n  }>(element);\n  const identityType = identityHint?.type ?? element.type;\n  const typeIdentity = getAnonElemName(identityType);\n  const typeName = identityType.name || 'Anonymous';\n  const key = identityHint ? identityHint.key : element.key;\n  if (key === undefined) {\n    const occurrence = identityHint?.occurrence ?? 0;\n    return `${typeName}:${typeIdentity}${occurrence ? `_${occurrence}` : ''}`;\n  }\n\n  const encodedKey = encodeURIComponent(key);\n  const siblingKey = `${parentId}/${encodedKey}`;\n  if (GLOBAL_STATE.seenKeys!.has(siblingKey)) {\n    throw new Error(`Duplicate Pibbl key \"${key}\" under \"${parentId}\"`);\n  }\n  GLOBAL_STATE.seenKeys!.add(siblingKey);\n  return `${typeName}:${typeIdentity}[${encodedKey}]`;\n}\n\nfunction ensureUniqueId(parentId: string, typeName: string) {\n  let id = `${parentId}/${typeName}`;\n  let n = 1;\n  while (GLOBAL_STATE.seenIds!.has(id)) {\n    id = `${parentId}/${typeName}_${n++}`;\n  }\n  return id;\n}\n"],
+  "mappings": "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",
+  "names": []
+}