@pibbl/core 0.0.1 → 0.0.3-alpha.109.1

package/dist/lib/components/text.js

@@ -7,11 +7,14 @@ import {
   stripLayoutParticipation
 } from "../style/resolve-built-in.js";
 import { registerOpaqueStyleProperties } from "../style/resolve-dispatch.js";
-import { resolveLength } from "../style/resolve-length.js";
+import { resolveScalarSizingLength } from "../style/sizing-length.js";
+import { normalizeBoxInsets } from "../layout/box-insets.js";
 import { wireCommonEvents } from "../util/wire-common-events.js";
 import { pushClippingPath } from "../util/push-clipping-path.js";
 import { resolveTextClipBounds, resolveTextLayout } from "./text-layout.js";
 import { withReceiverInputProvision } from "../signals/input-provision.js";
+import { withSignalDependencyRole, withSignalWriteForbidden } from "../signals/graph.js";
+import { withHooksForbidden } from "../hooks/hook-slot.js";
 const materializedTextTransactions = /* @__PURE__ */ new WeakMap();
 function renderText(props, style, ctx) {
   const text = materializeTextContent(props);
@@ -85,28 +88,43 @@ function renderText(props, style, ctx) {
 }
 const Text = definePrimitive(renderText, {
   childInput: "text",
-  resolveStyle: (style, context) => ({
-    ...stripLayoutParticipation(style),
-    x: 0,
-    y: 0,
-    width: resolveOptionalLength(
-      style.width,
-      context.percentageBasis.width,
-      "width",
-      context
-    ),
-    height: resolveOptionalLength(
-      style.height,
-      context.percentageBasis.height,
-      "height",
-      context
-    )
-  }),
+  resolveStyle: (style, context) => {
+    let x = 0, y = 0;
+    if (style.padding !== void 0 || style.paddingStart !== void 0 || style.paddingEnd !== void 0 || style.borderWidth !== void 0 || style.borderStartWidth !== void 0 || style.borderEndWidth !== void 0) {
+      const insets = normalizeBoxInsets(style, context);
+      x = insets.left;
+      y = insets.top;
+    }
+    return {
+      ...stripLayoutParticipation(style),
+      x,
+      y,
+      width: resolveOptionalLength(
+        style.width,
+        context.percentageBasis.width,
+        "width",
+        context
+      ),
+      height: resolveOptionalLength(
+        style.height,
+        context.percentageBasis.height,
+        "height",
+        context
+      )
+    };
+  },
   measure: ({ props, style, constraints, service }) => measureTextStyle(
     materializeTextContent(props),
     style,
     constraints,
     service
+  ),
+  measureIntrinsic: ({ props, style, service }) => measureTextIntrinsic(props, style, service),
+  measureBaselines: ({ props, style, allocation, service }) => measureTextBaselines(
+    materializeTextContent(props),
+    style,
+    allocation,
+    service
   )
 });
 registerOpaqueStyleProperties(Text, [
@@ -118,14 +136,62 @@ registerOpaqueStyleProperties(Text, [
   "textBaseline",
   "textAlign"
 ]);
+function measureTextBaselines(text, style, allocation, service) {
+  if (text.length === 0) return { status: "unsupported", reason: "Text baseline measurement requires nonempty text" };
+  const measureAtBaseline = service.measureTextAtBaseline;
+  if (!measureAtBaseline) {
+    return {
+      status: "unsupported",
+      reason: "Text baseline measurement requires CanvasMeasurementService.measureTextAtBaseline"
+    };
+  }
+  const font = style.font ?? "13px sans-serif";
+  const textBaseline = style.textBaseline ?? "top";
+  const layout = resolveTextLayout(
+    (value) => measureAtBaseline.call(service, value, { font, textBaseline }),
+    text,
+    { ...style, x: 0, y: 0, width: allocation.width, height: allocation.height }
+  );
+  const firstLine = layout.lines[0];
+  const lastLine = layout.lines[layout.lines.length - 1];
+  if (!firstLine || !lastLine || firstLine.text.length === 0 || lastLine.text.length === 0) {
+    return { status: "unsupported", reason: "Text does not resolve a line for baseline measurement: requires a nonempty rendered baseline line" };
+  }
+  const firstMetrics = measureAtBaseline.call(service, firstLine.text, { font, textBaseline });
+  const first = firstLine.y - firstMetrics.alphabeticBaseline;
+  let last = first;
+  if (lastLine !== firstLine) {
+    const lastMetrics = measureAtBaseline.call(service, lastLine.text, { font, textBaseline });
+    last = lastLine.y - lastMetrics.alphabeticBaseline;
+  }
+  if (!Number.isFinite(first) || !Number.isFinite(last)) {
+    return {
+      status: "unsupported",
+      reason: "Canvas text metrics do not provide a finite alphabeticBaseline for Text baseline measurement"
+    };
+  }
+  return { status: "measured", first, last };
+}
+function measureTextIntrinsic(props, style, service) {
+  const text = prepareLayoutTextContent(props, {});
+  const font = style.font ?? "13px sans-serif";
+  const maximum = style.wrap ? measureLayoutTextNaturalRun(text, { font, service }) : service.measureText(text, font).width;
+  const minimum = style.wrap ? measureLayoutTextMinimumWidth(props, { font, service }) : maximum;
+  const intrinsicStyle = { ...style, width: void 0, height: void 0, fit: "visible" };
+  const minResult = measureTextStyle(text, intrinsicStyle, { minWidth: 0, maxWidth: minimum, minHeight: 0, maxHeight: Infinity }, service);
+  const maxResult = measureTextStyle(text, intrinsicStyle, { minWidth: 0, maxWidth: maximum, minHeight: 0, maxHeight: Infinity }, service);
+  if (minResult.status !== "measured") return minResult;
+  if (maxResult.status !== "measured") return maxResult;
+  return { status: "measured", minContent: { width: minimum, height: minResult.size.height }, maxContent: { width: maximum, height: maxResult.size.height } };
+}
 function measureTextStyle(text, style, constraints, service) {
   const context = {
     component: "Text",
     algorithm: "measurement",
     constraints
   };
-  const specifiedWidth = style.width === void 0 ? void 0 : resolveLength(style.width, constraints.maxWidth, "width", context);
-  const specifiedHeight = style.height === void 0 ? void 0 : resolveLength(style.height, constraints.maxHeight, "height", context);
+  const specifiedWidth = style.width === void 0 ? void 0 : resolveScalarSizingLength(style.width, constraints.maxWidth, "width", context);
+  const specifiedHeight = style.height === void 0 ? void 0 : resolveScalarSizingLength(style.height, constraints.maxHeight, "height", context);
   const layoutWidth = specifiedWidth ?? (style.wrap && Number.isFinite(constraints.maxWidth) ? constraints.maxWidth : void 0);
   const font = style.font ?? "13px sans-serif";
   const layout = resolveTextLayout(
@@ -147,9 +213,44 @@ function measureTextStyle(text, style, constraints, service) {
     }
   };
 }
-function materializeTextContent(props) {
+function measureLayoutTextNaturalRun(text, options) {
+  let start = 0;
+  while (text.charCodeAt(start) === 32) start++;
+  if (start === text.length) return 0;
+  const width = options.service.measureText(text.slice(start), options.font).width;
+  if (!Number.isFinite(width) || width < 0) {
+    throw new Error("Text intrinsic measurement requires a finite nonnegative natural width.");
+  }
+  return width;
+}
+function measureLayoutTextMinimumWidth(props, options) {
+  const text = prepareLayoutTextContent(props, { receiverToken: options.receiverToken });
+  let longest = 0;
+  let start = 0;
+  for (let index = 0; index <= text.length; index++) {
+    if (index !== text.length && text.charCodeAt(index) !== 32) continue;
+    if (index > start) {
+      const width = options.service.measureText(text.slice(start, index), options.font).width;
+      if (!Number.isFinite(width) || width < 0) {
+        throw new Error("Text intrinsic measurement requires finite nonnegative word widths.");
+      }
+      if (width > longest) longest = width;
+    }
+    start = index + 1;
+  }
+  return longest;
+}
+function prepareLayoutTextContent(props, options) {
+  return withSignalWriteForbidden(
+    "Signal writes are forbidden during Pibbl measurement",
+    () => withHooksForbidden(
+      "Pibbl hooks cannot be called while preparing measured Text content.",
+      () => materializeTextContent(props, options.receiverToken)
+    )
+  );
+}
+function materializeTextContent(props, receiver = GLOBAL_STATE.primitiveReceiverToken) {
   const transaction = GLOBAL_STATE.renderTransaction;
-  const receiver = GLOBAL_STATE.primitiveReceiverToken;
   if (!transaction || !receiver) {
     return materializeTextChildren(props.children, "Text");
   }
@@ -163,12 +264,18 @@ function materializeTextContent(props) {
   const materialized = withReceiverInputProvision(
     transaction,
     receiver,
-    () => materializeTextChildren(props.children, "Text")
+    () => withSignalDependencyRole(
+      "measurement",
+      () => materializeTextChildren(props.children, "Text")
+    )
   );
   receivers.set(receiver, materialized);
   return materialized;
 }
 export {
-  Text
+  Text,
+  measureLayoutTextMinimumWidth,
+  measureLayoutTextNaturalRun,
+  prepareLayoutTextContent
 };
 //# sourceMappingURL=text.js.map

package/dist/lib/components/text.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/components/text.ts"],
-  "sourcesContent": ["import { resolveTexturePaint } from '../textures/texture-protocol.js';\nimport { definePrimitive } from '../define-primitive.js';\nimport { materializeTextChildren } from '../element/children.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport type {\n  PibblEventFocusOptions,\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n} from '../events/types.js';\nimport {\n  resolveOptionalLength,\n  stripLayoutParticipation,\n} from '../style/resolve-built-in.js';\nimport { registerOpaqueStyleProperties } from '../style/resolve-dispatch.js';\nimport type { ResolvedTextStyle, TextStyle } from '../style/types.js';\nimport {\n  CanvasMeasurementService,\n  MeasureResult,\n  RenderingContext2D,\n} from '../types.js';\nimport type { Constraints } from '../layout/types.js';\nimport type { PibblRenderTransaction, PibblTextInput } from '../types.js';\nimport type { PibblPhysics2DPropExtension } from '../types.js';\nimport { resolveLength } from '../style/resolve-length.js';\nimport { wireCommonEvents } from '../util/wire-common-events.js';\nimport { pushClippingPath } from '../util/push-clipping-path.js';\nimport { resolveTextClipBounds, resolveTextLayout } from './text-layout.js';\nimport { withReceiverInputProvision } from '../signals/input-provision.js';\n\n/**\n * Authored inputs for Text, including the declared data and presentation options.\n *\n * @see {@link PibblEventHandlers}\n * @see {@link PibblEventParticipationOptions}\n * @see {@link PibblPhysics2DPropExtension}\n * @see {@link PibblTextInput}\n * @see {@link Text}\n */\nexport interface TextProps\n  extends\n    PibblEventHandlers,\n    PibblEventFocusOptions,\n    PibblEventParticipationOptions,\n    PibblPhysics2DPropExtension {\n  /** Descendant content or the callback that supplies it. See {@link PibblTextInput}. */\n  children?: PibblTextInput;\n}\n\nconst materializedTextTransactions = new WeakMap<\n  PibblRenderTransaction,\n  WeakMap<object, string>\n>();\n\nfunction renderText(\n  props: TextProps,\n  style: Readonly<ResolvedTextStyle>,\n  ctx: RenderingContext2D,\n) {\n  const text = materializeTextContent(props);\n  const {\n    font = '13px sans-serif',\n    textBaseline = 'top',\n    textAlign = 'left',\n    fill,\n    stroke,\n    strokeWidth = 0,\n    opacity,\n    cursor,\n  } = style;\n\n  if (opacity !== undefined) {\n    ctx.globalAlpha = ctx.globalAlpha * opacity;\n  }\n\n  ctx.font = font;\n  ctx.textBaseline = textBaseline;\n  ctx.textAlign = textAlign;\n\n  const layout = resolveTextLayout(\n    value => ctx.measureText(value),\n    text,\n    style,\n  );\n  const clipBounds =\n    layout.clipBounds ?? resolveTextClipBounds(style, ctx.canvas.height);\n\n  let releaseClip: (() => void) | undefined;\n  if (clipBounds) {\n    const clipPath = new Path2D();\n    clipPath.rect(\n      clipBounds.x,\n      clipBounds.y,\n      clipBounds.width,\n      clipBounds.height,\n    );\n    releaseClip = pushClippingPath(ctx, clipPath);\n  }\n\n  try {\n    const textBounds = props.pointerEvents === 'none' ? undefined : new Path2D();\n\n    for (const line of layout.lines) {\n      if (stroke && strokeWidth) {\n        ctx.strokeStyle = resolveTexturePaint(stroke, ctx, layout.bounds ?? line.bounds);\n        ctx.lineWidth = strokeWidth;\n        ctx.strokeText(line.text, line.x, line.y, line.squishWidth);\n      }\n\n      if (fill) {\n        ctx.fillStyle = resolveTexturePaint(fill, ctx, layout.bounds ?? line.bounds);\n        ctx.fillText(line.text, line.x, line.y, line.squishWidth);\n      }\n\n      if (textBounds) {\n        textBounds.moveTo(line.bounds.x, line.bounds.y);\n        textBounds.lineTo(line.bounds.x + line.bounds.width, line.bounds.y);\n        textBounds.lineTo(\n          line.bounds.x + line.bounds.width,\n          line.bounds.y + line.bounds.height,\n        );\n        textBounds.lineTo(line.bounds.x, line.bounds.y + line.bounds.height);\n        textBounds.closePath();\n      }\n    }\n\n    wireCommonEvents(\n      props,\n      textBounds,\n      true,\n      strokeWidth,\n      cursor,\n      layout.bounds,\n    );\n  } finally {\n    releaseClip?.();\n  }\n}\n\n/**\n * Draws Canvas text from textual children using the resolved font, wrapping, fitting, and paint\n * style.\n *\n * @param props - Authored component inputs, supplied through JSX or createElement. See the linked\n * props and style types.\n * @throws When called directly; Pibbl mounts this component through JSX or createElement.\n *\n * @see {@link TextProps}\n * @see {@link TextStyle}\n */\nexport const Text = definePrimitive<\n  TextProps,\n  TextStyle,\n  TextStyle,\n  ResolvedTextStyle\n>(renderText, {\n  childInput: 'text',\n  resolveStyle: (style, context) => ({\n    ...stripLayoutParticipation(style),\n    x: 0,\n    y: 0,\n    width: resolveOptionalLength(\n      style.width,\n      context.percentageBasis.width,\n      'width',\n      context,\n    ),\n    height: resolveOptionalLength(\n      style.height,\n      context.percentageBasis.height,\n      'height',\n      context,\n    ),\n  }) as ResolvedTextStyle,\n  measure: ({ props, style, constraints, service }) =>\n    measureTextStyle(\n      materializeTextContent(props),\n      style,\n      constraints,\n      service,\n    ),\n});\nregisterOpaqueStyleProperties(Text, [\n  'font',\n  'fill',\n  'stroke',\n  'cursor',\n  'fit',\n  'textBaseline',\n  'textAlign',\n]);\n\nfunction measureTextStyle(\n  text: string,\n  style: Readonly<TextStyle>,\n  constraints: Readonly<Constraints>,\n  service: CanvasMeasurementService,\n): MeasureResult {\n  const context = {\n    component: 'Text',\n    algorithm: 'measurement',\n    constraints,\n  };\n  const specifiedWidth = style.width === undefined ? undefined :\n    resolveLength(style.width, constraints.maxWidth, 'width', context);\n  const specifiedHeight = style.height === undefined ? undefined :\n    resolveLength(style.height, constraints.maxHeight, 'height', context);\n  const layoutWidth = specifiedWidth ?? (\n    style.wrap && Number.isFinite(constraints.maxWidth) ?\n      constraints.maxWidth :\n      undefined\n  );\n  const font = style.font ?? '13px sans-serif';\n  const layout = resolveTextLayout(\n    value => service.measureText(value, font),\n    text,\n    {\n      ...style,\n      x: 0,\n      y: 0,\n      width: layoutWidth,\n      height: specifiedHeight,\n    },\n  );\n  return {\n    status: 'measured',\n    size: {\n      width: specifiedWidth ?? (style.wrap && layoutWidth !== undefined ?\n        layoutWidth :\n        layout.bounds?.width ?? 0),\n      height: specifiedHeight ?? (style.wrap ?\n        layout.lines.length * (style.lineHeight ?? 13) :\n        layout.bounds?.height ?? 0),\n    },\n  };\n}\n\nfunction materializeTextContent(props: Readonly<TextProps>): string {\n  const transaction = GLOBAL_STATE.renderTransaction;\n  const receiver = GLOBAL_STATE.primitiveReceiverToken;\n  if (!transaction || !receiver) {\n    return materializeTextChildren(props.children, 'Text');\n  }\n\n  let receivers = materializedTextTransactions.get(transaction);\n  if (!receivers) {\n    receivers = new WeakMap();\n    materializedTextTransactions.set(transaction, receivers);\n  }\n  const cached = receivers.get(receiver);\n  if (cached !== undefined) return cached;\n  const materialized = withReceiverInputProvision(\n    transaction,\n    receiver,\n    () => materializeTextChildren(props.children, 'Text'),\n  );\n  receivers.set(receiver, materialized);\n  return materialized;\n}\n"],
-  "mappings": "AAAA,SAAS,2BAA2B;AACpC,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AACxC,SAAS,oBAAoB;AAM7B;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,qCAAqC;AAU9C,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AACjC,SAAS,wBAAwB;AACjC,SAAS,uBAAuB,yBAAyB;AACzD,SAAS,kCAAkC;AAqB3C,MAAM,+BAA+B,oBAAI,QAGvC;AAEF,SAAS,WACP,OACA,OACA,KACA;AACA,QAAM,OAAO,uBAAuB,KAAK;AACzC,QAAM;AAAA,IACJ,OAAO;AAAA,IACP,eAAe;AAAA,IACf,YAAY;AAAA,IACZ;AAAA,IACA;AAAA,IACA,cAAc;AAAA,IACd;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,MAAI,YAAY,QAAW;AACzB,QAAI,cAAc,IAAI,cAAc;AAAA,EACtC;AAEA,MAAI,OAAO;AACX,MAAI,eAAe;AACnB,MAAI,YAAY;AAEhB,QAAM,SAAS;AAAA,IACb,WAAS,IAAI,YAAY,KAAK;AAAA,IAC9B;AAAA,IACA;AAAA,EACF;AACA,QAAM,aACJ,OAAO,cAAc,sBAAsB,OAAO,IAAI,OAAO,MAAM;AAErE,MAAI;AACJ,MAAI,YAAY;AACd,UAAM,WAAW,IAAI,OAAO;AAC5B,aAAS;AAAA,MACP,WAAW;AAAA,MACX,WAAW;AAAA,MACX,WAAW;AAAA,MACX,WAAW;AAAA,IACb;AACA,kBAAc,iBAAiB,KAAK,QAAQ;AAAA,EAC9C;AAEA,MAAI;AACF,UAAM,aAAa,MAAM,kBAAkB,SAAS,SAAY,IAAI,OAAO;AAE3E,eAAW,QAAQ,OAAO,OAAO;AAC/B,UAAI,UAAU,aAAa;AACzB,YAAI,cAAc,oBAAoB,QAAQ,KAAK,OAAO,UAAU,KAAK,MAAM;AAC/E,YAAI,YAAY;AAChB,YAAI,WAAW,KAAK,MAAM,KAAK,GAAG,KAAK,GAAG,KAAK,WAAW;AAAA,MAC5D;AAEA,UAAI,MAAM;AACR,YAAI,YAAY,oBAAoB,MAAM,KAAK,OAAO,UAAU,KAAK,MAAM;AAC3E,YAAI,SAAS,KAAK,MAAM,KAAK,GAAG,KAAK,GAAG,KAAK,WAAW;AAAA,MAC1D;AAEA,UAAI,YAAY;AACd,mBAAW,OAAO,KAAK,OAAO,GAAG,KAAK,OAAO,CAAC;AAC9C,mBAAW,OAAO,KAAK,OAAO,IAAI,KAAK,OAAO,OAAO,KAAK,OAAO,CAAC;AAClE,mBAAW;AAAA,UACT,KAAK,OAAO,IAAI,KAAK,OAAO;AAAA,UAC5B,KAAK,OAAO,IAAI,KAAK,OAAO;AAAA,QAC9B;AACA,mBAAW,OAAO,KAAK,OAAO,GAAG,KAAK,OAAO,IAAI,KAAK,OAAO,MAAM;AACnE,mBAAW,UAAU;AAAA,MACvB;AAAA,IACF;AAEA;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO;AAAA,IACT;AAAA,EACF,UAAE;AACA,kBAAc;AAAA,EAChB;AACF;AAaO,MAAM,OAAO,gBAKlB,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,cAAc,CAAC,OAAO,aAAa;AAAA,IACjC,GAAG,yBAAyB,KAAK;AAAA,IACjC,GAAG;AAAA,IACH,GAAG;AAAA,IACH,OAAO;AAAA,MACL,MAAM;AAAA,MACN,QAAQ,gBAAgB;AAAA,MACxB;AAAA,MACA;AAAA,IACF;AAAA,IACA,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,QAAQ,gBAAgB;AAAA,MACxB;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EACA,SAAS,CAAC,EAAE,OAAO,OAAO,aAAa,QAAQ,MAC7C;AAAA,IACE,uBAAuB,KAAK;AAAA,IAC5B;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACJ,CAAC;AACD,8BAA8B,MAAM;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,SAAS,iBACP,MACA,OACA,aACA,SACe;AACf,QAAM,UAAU;AAAA,IACd,WAAW;AAAA,IACX,WAAW;AAAA,IACX;AAAA,EACF;AACA,QAAM,iBAAiB,MAAM,UAAU,SAAY,SACjD,cAAc,MAAM,OAAO,YAAY,UAAU,SAAS,OAAO;AACnE,QAAM,kBAAkB,MAAM,WAAW,SAAY,SACnD,cAAc,MAAM,QAAQ,YAAY,WAAW,UAAU,OAAO;AACtE,QAAM,cAAc,mBAClB,MAAM,QAAQ,OAAO,SAAS,YAAY,QAAQ,IAChD,YAAY,WACZ;AAEJ,QAAM,OAAO,MAAM,QAAQ;AAC3B,QAAM,SAAS;AAAA,IACb,WAAS,QAAQ,YAAY,OAAO,IAAI;AAAA,IACxC;AAAA,IACA;AAAA,MACE,GAAG;AAAA,MACH,GAAG;AAAA,MACH,GAAG;AAAA,MACH,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,EACF;AACA,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,MAAM;AAAA,MACJ,OAAO,mBAAmB,MAAM,QAAQ,gBAAgB,SACtD,cACA,OAAO,QAAQ,SAAS;AAAA,MAC1B,QAAQ,oBAAoB,MAAM,OAChC,OAAO,MAAM,UAAU,MAAM,cAAc,MAC3C,OAAO,QAAQ,UAAU;AAAA,IAC7B;AAAA,EACF;AACF;AAEA,SAAS,uBAAuB,OAAoC;AAClE,QAAM,cAAc,aAAa;AACjC,QAAM,WAAW,aAAa;AAC9B,MAAI,CAAC,eAAe,CAAC,UAAU;AAC7B,WAAO,wBAAwB,MAAM,UAAU,MAAM;AAAA,EACvD;AAEA,MAAI,YAAY,6BAA6B,IAAI,WAAW;AAC5D,MAAI,CAAC,WAAW;AACd,gBAAY,oBAAI,QAAQ;AACxB,iCAA6B,IAAI,aAAa,SAAS;AAAA,EACzD;AACA,QAAM,SAAS,UAAU,IAAI,QAAQ;AACrC,MAAI,WAAW,OAAW,QAAO;AACjC,QAAM,eAAe;AAAA,IACnB;AAAA,IACA;AAAA,IACA,MAAM,wBAAwB,MAAM,UAAU,MAAM;AAAA,EACtD;AACA,YAAU,IAAI,UAAU,YAAY;AACpC,SAAO;AACT;",
+  "sourcesContent": ["import { resolveTexturePaint } from '../textures/texture-protocol.js';\nimport { definePrimitive } from '../define-primitive.js';\nimport { materializeTextChildren } from '../element/children.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport type {\n  PibblEventFocusOptions,\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n} from '../events/types.js';\nimport {\n  resolveOptionalLength,\n  stripLayoutParticipation,\n} from '../style/resolve-built-in.js';\nimport { registerOpaqueStyleProperties } from '../style/resolve-dispatch.js';\nimport type { ResolvedTextStyle, TextStyle } from '../style/types.js';\nimport {\n  CanvasMeasurementService,\n  MeasureResult,\n  IntrinsicSizesResult,\n  RenderingContext2D,\n} from '../types.js';\nimport type { Constraints } from '../layout/types.js';\nimport type { PibblRenderTransaction, PibblTextInput } from '../types.js';\nimport type { PibblPhysics2DPropExtension } from '../types.js';\nimport { resolveScalarSizingLength } from '../style/sizing-length.js';\nimport { normalizeBoxInsets } from '../layout/box-insets.js';\nimport { wireCommonEvents } from '../util/wire-common-events.js';\nimport { pushClippingPath } from '../util/push-clipping-path.js';\nimport { resolveTextClipBounds, resolveTextLayout } from './text-layout.js';\nimport { withReceiverInputProvision } from '../signals/input-provision.js';\nimport { withSignalDependencyRole, withSignalWriteForbidden } from '../signals/graph.js';\nimport { withHooksForbidden } from '../hooks/hook-slot.js';\n\n/**\n * Authored inputs for Text, including the declared data and presentation options.\n *\n * @see {@link PibblEventHandlers}\n * @see {@link PibblEventParticipationOptions}\n * @see {@link PibblPhysics2DPropExtension}\n * @see {@link PibblTextInput}\n * @see {@link Text}\n */\nexport interface TextProps\n  extends\n    PibblEventHandlers,\n    PibblEventFocusOptions,\n    PibblEventParticipationOptions,\n    PibblPhysics2DPropExtension {\n  /** Descendant content or the callback that supplies it. See {@link PibblTextInput}. */\n  children?: PibblTextInput;\n}\n\nconst materializedTextTransactions = new WeakMap<\n  PibblRenderTransaction,\n  WeakMap<object, string>\n>();\n\nfunction renderText(\n  props: TextProps,\n  style: Readonly<ResolvedTextStyle>,\n  ctx: RenderingContext2D,\n) {\n  const text = materializeTextContent(props);\n  const {\n    font = '13px sans-serif',\n    textBaseline = 'top',\n    textAlign = 'left',\n    fill,\n    stroke,\n    strokeWidth = 0,\n    opacity,\n    cursor,\n  } = style;\n\n  if (opacity !== undefined) {\n    ctx.globalAlpha = ctx.globalAlpha * opacity;\n  }\n\n  ctx.font = font;\n  ctx.textBaseline = textBaseline;\n  ctx.textAlign = textAlign;\n\n  const layout = resolveTextLayout(\n    value => ctx.measureText(value),\n    text,\n    style,\n  );\n  const clipBounds =\n    layout.clipBounds ?? resolveTextClipBounds(style, ctx.canvas.height);\n\n  let releaseClip: (() => void) | undefined;\n  if (clipBounds) {\n    const clipPath = new Path2D();\n    clipPath.rect(\n      clipBounds.x,\n      clipBounds.y,\n      clipBounds.width,\n      clipBounds.height,\n    );\n    releaseClip = pushClippingPath(ctx, clipPath);\n  }\n\n  try {\n    const textBounds = props.pointerEvents === 'none' ? undefined : new Path2D();\n\n    for (const line of layout.lines) {\n      if (stroke && strokeWidth) {\n        ctx.strokeStyle = resolveTexturePaint(stroke, ctx, layout.bounds ?? line.bounds);\n        ctx.lineWidth = strokeWidth;\n        ctx.strokeText(line.text, line.x, line.y, line.squishWidth);\n      }\n\n      if (fill) {\n        ctx.fillStyle = resolveTexturePaint(fill, ctx, layout.bounds ?? line.bounds);\n        ctx.fillText(line.text, line.x, line.y, line.squishWidth);\n      }\n\n      if (textBounds) {\n        textBounds.moveTo(line.bounds.x, line.bounds.y);\n        textBounds.lineTo(line.bounds.x + line.bounds.width, line.bounds.y);\n        textBounds.lineTo(\n          line.bounds.x + line.bounds.width,\n          line.bounds.y + line.bounds.height,\n        );\n        textBounds.lineTo(line.bounds.x, line.bounds.y + line.bounds.height);\n        textBounds.closePath();\n      }\n    }\n\n    wireCommonEvents(\n      props,\n      textBounds,\n      true,\n      strokeWidth,\n      cursor,\n      layout.bounds,\n    );\n  } finally {\n    releaseClip?.();\n  }\n}\n\n/**\n * Draws Canvas text from textual children using the resolved font, wrapping, fitting, and paint\n * style.\n *\n * @param props - Authored component inputs, supplied through JSX or createElement. See the linked\n * props and style types.\n * @throws When called directly; Pibbl mounts this component through JSX or createElement.\n *\n * @see {@link TextProps}\n * @see {@link TextStyle}\n */\nexport const Text = definePrimitive<\n  TextProps,\n  TextStyle,\n  TextStyle,\n  ResolvedTextStyle\n>(renderText, {\n  childInput: 'text',\n  resolveStyle: (style, context) => {\n    let x = 0, y = 0;\n    if (style.padding !== undefined || style.paddingStart !== undefined || style.paddingEnd !== undefined ||\n        style.borderWidth !== undefined || style.borderStartWidth !== undefined || style.borderEndWidth !== undefined) {\n      const insets = normalizeBoxInsets(style, context);\n      x = insets.left; y = insets.top;\n    }\n    return {\n      ...stripLayoutParticipation(style),\n      x,\n      y,\n      width: resolveOptionalLength(\n        style.width,\n        context.percentageBasis.width,\n        'width',\n        context,\n      ),\n      height: resolveOptionalLength(\n        style.height,\n        context.percentageBasis.height,\n        'height',\n        context,\n      ),\n    } as ResolvedTextStyle;\n  },\n  measure: ({ props, style, constraints, service }) =>\n    measureTextStyle(\n      materializeTextContent(props),\n      style,\n      constraints,\n      service,\n    ),\n  measureIntrinsic: ({ props, style, service }) => measureTextIntrinsic(props, style, service),\n  measureBaselines: ({ props, style, allocation, service }) =>\n    measureTextBaselines(\n      materializeTextContent(props),\n      style,\n      allocation,\n      service,\n    ),\n});\nregisterOpaqueStyleProperties(Text, [\n  'font',\n  'fill',\n  'stroke',\n  'cursor',\n  'fit',\n  'textBaseline',\n  'textAlign',\n]);\n\n\nfunction measureTextBaselines(\n  text: string,\n  style: Readonly<TextStyle>,\n  allocation: Readonly<{ width: number; height: number }>,\n  service: CanvasMeasurementService,\n) {\n  if (text.length === 0) return { status: 'unsupported' as const, reason: 'Text baseline measurement requires nonempty text' };\n  const measureAtBaseline = service.measureTextAtBaseline;\n  if (!measureAtBaseline) {\n    return {\n      status: 'unsupported' as const,\n      reason: 'Text baseline measurement requires CanvasMeasurementService.measureTextAtBaseline',\n    };\n  }\n  const font = style.font ?? '13px sans-serif';\n  const textBaseline = style.textBaseline ?? 'top';\n  const layout = resolveTextLayout(\n    value => measureAtBaseline.call(service, value, { font, textBaseline }),\n    text,\n    { ...style, x: 0, y: 0, width: allocation.width, height: allocation.height },\n  );\n  const firstLine = layout.lines[0];\n  const lastLine = layout.lines[layout.lines.length - 1];\n  if (!firstLine || !lastLine || firstLine.text.length === 0 || lastLine.text.length === 0) {\n    return { status: 'unsupported' as const, reason: 'Text does not resolve a line for baseline measurement: requires a nonempty rendered baseline line' };\n  }\n  const firstMetrics = measureAtBaseline.call(service, firstLine.text, { font, textBaseline });\n  const first = firstLine.y - firstMetrics.alphabeticBaseline;\n  let last = first;\n  if (lastLine !== firstLine) {\n    const lastMetrics = measureAtBaseline.call(service, lastLine.text, { font, textBaseline });\n    last = lastLine.y - lastMetrics.alphabeticBaseline;\n  }\n  if (!Number.isFinite(first) || !Number.isFinite(last)) {\n    return {\n      status: 'unsupported' as const,\n      reason: 'Canvas text metrics do not provide a finite alphabeticBaseline for Text baseline measurement',\n    };\n  }\n  return { status: 'measured' as const, first, last };\n}\n\n/** Width contributions and their respective natural heights share Text's existing wrap policy. */\nfunction measureTextIntrinsic(props: Readonly<TextProps>, style: Readonly<TextStyle>, service: CanvasMeasurementService): IntrinsicSizesResult {\n  const text = prepareLayoutTextContent(props, {});\n  const font = style.font ?? '13px sans-serif';\n  const maximum = style.wrap ? measureLayoutTextNaturalRun(text, { font, service }) : service.measureText(text, font).width;\n  const minimum = style.wrap ? measureLayoutTextMinimumWidth(props, { font, service }) : maximum;\n  const intrinsicStyle = { ...style, width: undefined, height: undefined, fit: 'visible' as const };\n  const minResult = measureTextStyle(text, intrinsicStyle, { minWidth: 0, maxWidth: minimum, minHeight: 0, maxHeight: Infinity }, service);\n  const maxResult = measureTextStyle(text, intrinsicStyle, { minWidth: 0, maxWidth: maximum, minHeight: 0, maxHeight: Infinity }, service);\n  if (minResult.status !== 'measured') return minResult;\n  if (maxResult.status !== 'measured') return maxResult;\n  return { status: 'measured', minContent: { width: minimum, height: minResult.size.height }, maxContent: { width: maximum, height: maxResult.size.height } };\n}\n\nfunction measureTextStyle(\n  text: string,\n  style: Readonly<TextStyle>,\n  constraints: Readonly<Constraints>,\n  service: CanvasMeasurementService,\n): MeasureResult {\n  const context = {\n    component: 'Text',\n    algorithm: 'measurement',\n    constraints,\n  };\n  const specifiedWidth = style.width === undefined ? undefined :\n    resolveScalarSizingLength(style.width, constraints.maxWidth, 'width', context);\n  const specifiedHeight = style.height === undefined ? undefined :\n    resolveScalarSizingLength(style.height, constraints.maxHeight, 'height', context);\n  const layoutWidth = specifiedWidth ?? (\n    style.wrap && Number.isFinite(constraints.maxWidth) ?\n      constraints.maxWidth :\n      undefined\n  );\n  const font = style.font ?? '13px sans-serif';\n  const layout = resolveTextLayout(\n    value => service.measureText(value, font),\n    text,\n    {\n      ...style,\n      x: 0,\n      y: 0,\n      width: layoutWidth,\n      height: specifiedHeight,\n    },\n  );\n  return {\n    status: 'measured',\n    size: {\n      width: specifiedWidth ?? (style.wrap && layoutWidth !== undefined ?\n        layoutWidth :\n        layout.bounds?.width ?? 0),\n      height: specifiedHeight ?? (style.wrap ?\n        layout.lines.length * (style.lineHeight ?? 13) :\n        layout.bounds?.height ?? 0),\n    },\n  };\n}\n\n/** @internal Measure a materialized value without bypassing receiver reads. */\nexport function measureLayoutTextNaturalRun(\n  text: string, options: { font: string; service: CanvasMeasurementService },\n): number {\n  // wrapText discards leading empty words but preserves later spaces. Use the\n  // same boundary rather than adding a CSS whitespace-normalization policy.\n  let start = 0;\n  while (text.charCodeAt(start) === 32) start++;\n  if (start === text.length) return 0;\n  const width = options.service.measureText(text.slice(start), options.font).width;\n  if (!Number.isFinite(width) || width < 0) {\n    throw new Error('Text intrinsic measurement requires a finite nonnegative natural width.');\n  }\n  return width;\n}\n\n/** @internal Longest run under Text's existing ASCII-space wrapping contract. */\nexport function measureLayoutTextMinimumWidth(\n  props: Readonly<TextProps>,\n  options: { font: string; service: CanvasMeasurementService; receiverToken?: object },\n): number {\n  const text = prepareLayoutTextContent(props, { receiverToken: options.receiverToken });\n  let longest = 0;\n  let start = 0;\n  for (let index = 0; index <= text.length; index++) {\n    if (index !== text.length && text.charCodeAt(index) !== 32) continue;\n    if (index > start) {\n      const width = options.service.measureText(text.slice(start, index), options.font).width;\n      if (!Number.isFinite(width) || width < 0) {\n        throw new Error('Text intrinsic measurement requires finite nonnegative word widths.');\n      }\n      if (width > longest) longest = width;\n    }\n    start = index + 1;\n  }\n  return longest;\n}\n\n/** @internal Prepare measured Text through its existing transaction/receiver ownership. */\nexport function prepareLayoutTextContent(\n  props: Readonly<TextProps>, options: { receiverToken?: object },\n): string {\n  return withSignalWriteForbidden('Signal writes are forbidden during Pibbl measurement', () =>\n    withHooksForbidden('Pibbl hooks cannot be called while preparing measured Text content.', () =>\n      materializeTextContent(props, options.receiverToken),\n    ),\n  );\n}\n\nfunction materializeTextContent(\n  props: Readonly<TextProps>, receiver = GLOBAL_STATE.primitiveReceiverToken,\n): string {\n  const transaction = GLOBAL_STATE.renderTransaction;\n  if (!transaction || !receiver) {\n    return materializeTextChildren(props.children, 'Text');\n  }\n\n  let receivers = materializedTextTransactions.get(transaction);\n  if (!receivers) {\n    receivers = new WeakMap();\n    materializedTextTransactions.set(transaction, receivers);\n  }\n  const cached = receivers.get(receiver);\n  if (cached !== undefined) return cached;\n  const materialized = withReceiverInputProvision(\n    transaction,\n    receiver,\n    () => withSignalDependencyRole(\n      'measurement',\n      () => materializeTextChildren(props.children, 'Text'),\n    ),\n  );\n  receivers.set(receiver, materialized);\n  return materialized;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/define-primitive.d.ts

@@ -1,13 +1,15 @@
 import type { PibblBackendPrimitiveProgram, PibblBackendToken } from './backend/types.js';
 import type { PibblPrimitiveComponent, PreservedSignalPropKey, PrimitiveCapabilities, PrimitiveInput, PrimitiveProgramProps, PrimitiveRender, SystemStyle } from './types.js';
+import type { SizingLength } from './style/sizing-length.js';
 type DeclaresWhen<S> = S extends unknown ? 'when' extends keyof S ? true : false : never;
 type PrimitiveStyleGuard<S, N, R> = true extends DeclaresWhen<S> | DeclaresWhen<N> | DeclaresWhen<R> ? {
     readonly 'Pibbl: style.when is framework-owned; remove when from the primitive style type': never;
 } : unknown;
-type AllocationValue = `${number}%` | 'auto';
+type AllocationValue = Exclude<SizingLength, number | 'stretch'>;
+type StretchSizingValue<S> = S extends unknown ? S[Extract<keyof S, 'width' | 'height' | 'minWidth' | 'maxWidth' | 'minHeight' | 'maxHeight' | 'flexBasis'>] : never;
 type DeclaredStyleValue<S> = S extends unknown ? S[Exclude<keyof S, 'custom'>] : never;
 type RequiresResolver<S> = [
-    Extract<DeclaredStyleValue<S>, AllocationValue>
+    Extract<DeclaredStyleValue<S>, AllocationValue> | Extract<StretchSizingValue<S>, 'stretch'>
 ] extends [never] ? false : true;
 type PrimitiveCapabilitiesInput<P, S extends SystemStyle, N extends SystemStyle, R extends SystemStyle> = Readonly<PrimitiveCapabilities<P, S, N, R>> & PrimitiveStyleGuard<S, N, R> & ([
     PreservedSignalPropKey<P>

package/dist/lib/define-primitive.js

@@ -35,7 +35,9 @@ Use <${componentName} ... /> in a Pibbl JSX file or createElement(${componentNam
     childInput: capabilities.childInput,
     normalizeStyle: capabilities.normalizeStyle,
     resolveStyle: capabilities.resolveStyle,
-    measure: capabilities.measure
+    measure: capabilities.measure,
+    measureIntrinsic: capabilities.measureIntrinsic,
+    measureBaselines: capabilities.measureBaselines
   });
   return component;
 }

package/dist/lib/define-primitive.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/define-primitive.ts"],
-  "sourcesContent": ["import {\n  derivePrimitiveMetadata,\n  getPrimitiveDefinition,\n  setPrimitiveDefinition,\n} from './element/metadata.js';\nimport {\n  CANVAS_2D_BACKEND,\n} from './backend/canvas-2d-backend.js';\nimport type {\n  PibblBackendPrimitiveProgram,\n  PibblBackendToken,\n} from './backend/types.js';\nimport type {\n  PibblPrimitiveComponent,\n  PreservedSignalPropKey,\n  PrimitiveCapabilities,\n  PrimitiveInput,\n  PrimitiveProgramProps,\n  PrimitiveRender,\n  RenderingContext2D,\n  SystemStyle,\n} from './types.js';\nimport { GLOBAL_STATE } from './global-state.js';\nimport { withSignalWriteForbidden } from './signals/graph.js';\n\ntype DeclaresWhen<S> = S extends unknown ? 'when' extends keyof S ? true : false : never;\ntype PrimitiveStyleGuard<S, N, R> = true extends DeclaresWhen<S> | DeclaresWhen<N> | DeclaresWhen<R> ? {\n  readonly 'Pibbl: style.when is framework-owned; remove when from the primitive style type': never;\n} : unknown;\n\ntype AllocationValue = `${number}%` | 'auto';\ntype DeclaredStyleValue<S> = S extends unknown\n  ? S[Exclude<keyof S, 'custom'>]\n  : never;\ntype RequiresResolver<S> = [\n  Extract<DeclaredStyleValue<S>, AllocationValue>,\n] extends [never] ? false : true;\ntype PrimitiveCapabilitiesInput<\n  P,\n  S extends SystemStyle,\n  N extends SystemStyle,\n  R extends SystemStyle,\n> = Readonly<PrimitiveCapabilities<P, S, N, R>> & PrimitiveStyleGuard<S, N, R> & (\n  [PreservedSignalPropKey<P>] extends [never] ? object : {\n    readonly preserveSignalProps: readonly [\n      PreservedSignalPropKey<P>,\n      ...PreservedSignalPropKey<P>[],\n    ];\n  }\n);\ntype CapabilityArguments<\n  P,\n  S extends SystemStyle,\n  N extends SystemStyle,\n  R extends SystemStyle,\n> = RequiresResolver<R> extends true ? [capabilities: never] :\n  RequiresResolver<S> extends true ? [\n    capabilities: PrimitiveCapabilitiesInput<P, S, N, R> & {\n      resolveStyle: NonNullable<\n        PrimitiveCapabilities<P, S, N, R>['resolveStyle']\n      >;\n    },\n  ] : [PreservedSignalPropKey<P>] extends [never] ? [\n    capabilities?: PrimitiveCapabilitiesInput<P, S, N, R>,\n  ] : [capabilities: PrimitiveCapabilitiesInput<P, S, N, R>];\n\n/**\n * Defines a platform component with private style and measurement behavior.\n *\n * @param render - Synchronous primitive renderer receiving props, resolved style, and Canvas\n * context. See {@link PrimitiveRender} , {@link PrimitiveStyleGuard} , {@link PrimitiveInput} .\n * @param capabilityArguments - Style normalization, resolution, and measurement capabilities\n * required by the primitive. See {@link CapabilityArguments} .\n * @returns A primitive component usable with JSX or createElement. See\n * {@link PibblPrimitiveComponent} , {@link PrimitiveProgramProps} , {@link PrimitiveInput} .\n *\n * @see {@link PrimitiveRender}\n * @see {@link PrimitiveInput}\n * @see {@link PibblPrimitiveComponent}\n * @see {@link PrimitiveProgramProps}\n * @see {@link SystemStyle}\n */\nexport function definePrimitive<\n  P = Record<string, never>,\n  S extends SystemStyle = SystemStyle,\n  N extends SystemStyle = S,\n  R extends SystemStyle = N,\n>(\n  render: PrimitiveRender<P, R> & PrimitiveStyleGuard<S, N, R> & (\n    PrimitiveInput<P, S> extends never ? never : unknown\n  ),\n  ...capabilityArguments: CapabilityArguments<P, S, N, R>\n): PibblPrimitiveComponent<PrimitiveProgramProps<P>, PrimitiveInput<P, S>> {\n  return defineBackendPrimitive<P, S, N, R, RenderingContext2D>(\n    CANVAS_2D_BACKEND.token,\n    render,\n    ...capabilityArguments,\n  );\n}\n\n/**\n * Defines a primitive owned by one official Pibbl rendering backend.\n *\n * @param backend - Identity of the backend that can execute this primitive. See\n * {@link PibblBackendToken} .\n * @param program - Synchronous program using the active backend environment. See\n * {@link PibblBackendPrimitiveProgram} , {@link PrimitiveStyleGuard} , {@link PrimitiveInput} .\n * @param capabilityArguments - Style and measurement capabilities for the primitive. See\n * {@link CapabilityArguments} .\n * @returns A primitive component bound to the specified backend. See {@link PibblPrimitiveComponent}\n * , {@link PrimitiveProgramProps} , {@link PrimitiveInput} .\n *\n * @see {@link PibblBackendToken}\n * @see {@link PibblBackendPrimitiveProgram}\n * @see {@link PrimitiveInput}\n * @see {@link PibblPrimitiveComponent}\n * @see {@link PrimitiveProgramProps}\n * @see {@link SystemStyle}\n */\nexport function defineBackendPrimitive<\n  P = Record<string, never>,\n  S extends SystemStyle = SystemStyle,\n  N extends SystemStyle = S,\n  R extends SystemStyle = N,\n  E = unknown,\n>(\n  backend: PibblBackendToken,\n  program: PibblBackendPrimitiveProgram<P, R, E> & PrimitiveStyleGuard<S, N, R> & (\n    PrimitiveInput<P, S> extends never ? never : unknown\n  ),\n  ...capabilityArguments: CapabilityArguments<P, S, N, R>\n): PibblPrimitiveComponent<PrimitiveProgramProps<P>, PrimitiveInput<P, S>> {\n  const componentName = primitiveComponentName(program.name);\n  const component = function PibblPrimitiveComponent(): never {\n    throw new Error(\n      `${componentName} is a Pibbl component and was invoked outside the Pibbl ` +\n      'renderer.\\n' +\n      `Use <${componentName} ... /> in a Pibbl JSX file or ` +\n      `createElement(${componentName}, props).`,\n    );\n  } as unknown as PibblPrimitiveComponent<\n    PrimitiveProgramProps<P>,\n    PrimitiveInput<P, S>\n  >;\n  Object.defineProperty(component, 'name', {\n    configurable: true,\n    value: componentName,\n  });\n\n  const capabilities = (capabilityArguments[0] ?? {}) as Readonly<\n    PrimitiveCapabilities<P, S, N, R>\n  >;\n  setPrimitiveDefinition(component, {\n    backend,\n    program,\n    preserveSignalProps: capabilities.preserveSignalProps,\n    childInput: capabilities.childInput,\n    normalizeStyle: capabilities.normalizeStyle,\n    resolveStyle: capabilities.resolveStyle,\n    measure: capabilities.measure,\n  });\n  return component;\n}\n\n/**\n * Derives a new official-package primitive identity with the source behavior.\n *\n * @param source - Primitive whose rendering and capabilities are reused.\n * @returns A derived primitive with its own component identity.\n *\n * @see {@link PibblPrimitiveComponent}\n */\nexport function derivePrimitive<T extends PibblPrimitiveComponent<any, any>>(\n  source: T,\n): T {\n  if (!getPrimitiveDefinition(source)) {\n    throw new TypeError('Can only derive a Pibbl primitive component.');\n  }\n  const componentName = source.name || 'Anonymous';\n  const derived = function PibblPrimitiveComponent(): never {\n    throw new Error(\n      `${componentName} is a Pibbl component and was invoked outside the Pibbl ` +\n      'renderer.\\n' +\n      `Use <${componentName} ... /> in a Pibbl JSX file or ` +\n      `createElement(${componentName}, props).`,\n    );\n  } as unknown as T;\n  Object.defineProperty(derived, 'name', {\n    configurable: true,\n    value: componentName,\n  });\n  derivePrimitiveMetadata(source, derived);\n  return derived;\n}\n\n/**\n * Runs one official-package primitive resolver without render side-effect authority.\n *\n * @param callback - Synchronous resolver to evaluate with hooks and signal writes forbidden.\n * @returns The resolver's return value.\n *\n * @see {@link PrimitiveCapabilities}\n */\nexport function pibblInternalRunPurePrimitiveResolver<T>(callback: () => T): T {\n  const previousComponentRefs = GLOBAL_STATE.componentRefs;\n  const previousComponentHookIndex = GLOBAL_STATE.componentHookIndex;\n  const previousComponentIsMounting = GLOBAL_STATE.componentIsMounting;\n  GLOBAL_STATE.componentRefs = undefined;\n  GLOBAL_STATE.componentHookIndex = 0;\n  GLOBAL_STATE.componentIsMounting = false;\n  try {\n    return withSignalWriteForbidden('Pibbl pure primitive resolver', callback);\n  } finally {\n    GLOBAL_STATE.componentRefs = previousComponentRefs;\n    GLOBAL_STATE.componentHookIndex = previousComponentHookIndex;\n    GLOBAL_STATE.componentIsMounting = previousComponentIsMounting;\n  }\n}\n\nfunction primitiveComponentName(renderName: string): string {\n  if (/^render[A-Z]/.test(renderName)) return renderName.slice('render'.length);\n  return renderName || 'Anonymous';\n}\n"],
-  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,OACK;AAeP,SAAS,oBAAoB;AAC7B,SAAS,gCAAgC;AA2DlC,SAAS,gBAMd,WAGG,qBACsE;AACzE,SAAO;AAAA,IACL,kBAAkB;AAAA,IAClB;AAAA,IACA,GAAG;AAAA,EACL;AACF;AAqBO,SAAS,uBAOd,SACA,YAGG,qBACsE;AACzE,QAAM,gBAAgB,uBAAuB,QAAQ,IAAI;AACzD,QAAM,YAAY,SAAS,0BAAiC;AAC1D,UAAM,IAAI;AAAA,MACR,GAAG,aAAa;AAAA,OAER,aAAa,gDACJ,aAAa;AAAA,IAChC;AAAA,EACF;AAIA,SAAO,eAAe,WAAW,QAAQ;AAAA,IACvC,cAAc;AAAA,IACd,OAAO;AAAA,EACT,CAAC;AAED,QAAM,eAAgB,oBAAoB,CAAC,KAAK,CAAC;AAGjD,yBAAuB,WAAW;AAAA,IAChC;AAAA,IACA;AAAA,IACA,qBAAqB,aAAa;AAAA,IAClC,YAAY,aAAa;AAAA,IACzB,gBAAgB,aAAa;AAAA,IAC7B,cAAc,aAAa;AAAA,IAC3B,SAAS,aAAa;AAAA,EACxB,CAAC;AACD,SAAO;AACT;AAUO,SAAS,gBACd,QACG;AACH,MAAI,CAAC,uBAAuB,MAAM,GAAG;AACnC,UAAM,IAAI,UAAU,8CAA8C;AAAA,EACpE;AACA,QAAM,gBAAgB,OAAO,QAAQ;AACrC,QAAM,UAAU,SAAS,0BAAiC;AACxD,UAAM,IAAI;AAAA,MACR,GAAG,aAAa;AAAA,OAER,aAAa,gDACJ,aAAa;AAAA,IAChC;AAAA,EACF;AACA,SAAO,eAAe,SAAS,QAAQ;AAAA,IACrC,cAAc;AAAA,IACd,OAAO;AAAA,EACT,CAAC;AACD,0BAAwB,QAAQ,OAAO;AACvC,SAAO;AACT;AAUO,SAAS,sCAAyC,UAAsB;AAC7E,QAAM,wBAAwB,aAAa;AAC3C,QAAM,6BAA6B,aAAa;AAChD,QAAM,8BAA8B,aAAa;AACjD,eAAa,gBAAgB;AAC7B,eAAa,qBAAqB;AAClC,eAAa,sBAAsB;AACnC,MAAI;AACF,WAAO,yBAAyB,iCAAiC,QAAQ;AAAA,EAC3E,UAAE;AACA,iBAAa,gBAAgB;AAC7B,iBAAa,qBAAqB;AAClC,iBAAa,sBAAsB;AAAA,EACrC;AACF;AAEA,SAAS,uBAAuB,YAA4B;AAC1D,MAAI,eAAe,KAAK,UAAU,EAAG,QAAO,WAAW,MAAM,SAAS,MAAM;AAC5E,SAAO,cAAc;AACvB;",
+  "sourcesContent": ["import {\n  derivePrimitiveMetadata,\n  getPrimitiveDefinition,\n  setPrimitiveDefinition,\n} from './element/metadata.js';\nimport {\n  CANVAS_2D_BACKEND,\n} from './backend/canvas-2d-backend.js';\nimport type {\n  PibblBackendPrimitiveProgram,\n  PibblBackendToken,\n} from './backend/types.js';\nimport type {\n  PibblPrimitiveComponent,\n  PreservedSignalPropKey,\n  PrimitiveCapabilities,\n  PrimitiveInput,\n  PrimitiveProgramProps,\n  PrimitiveRender,\n  RenderingContext2D,\n  SystemStyle,\n} from './types.js';\nimport { GLOBAL_STATE } from './global-state.js';\nimport { withSignalWriteForbidden } from './signals/graph.js';\nimport type { SizingLength } from './style/sizing-length.js';\n\ntype DeclaresWhen<S> = S extends unknown ? 'when' extends keyof S ? true : false : never;\ntype PrimitiveStyleGuard<S, N, R> = true extends DeclaresWhen<S> | DeclaresWhen<N> | DeclaresWhen<R> ? {\n  readonly 'Pibbl: style.when is framework-owned; remove when from the primitive style type': never;\n} : unknown;\n\n// Any nonnumeric sizing syntax depends on allocation or an intrinsic owner.\n// A primitive must normalize it before its render program receives the style.\ntype AllocationValue = Exclude<SizingLength, number | 'stretch'>;\ntype StretchSizingValue<S> = S extends unknown ? S[Extract<keyof S, 'width' | 'height' | 'minWidth' | 'maxWidth' | 'minHeight' | 'maxHeight' | 'flexBasis'>] : never;\ntype DeclaredStyleValue<S> = S extends unknown\n  ? S[Exclude<keyof S, 'custom'>]\n  : never;\ntype RequiresResolver<S> = [\n  Extract<DeclaredStyleValue<S>, AllocationValue> | Extract<StretchSizingValue<S>, 'stretch'>,\n] extends [never] ? false : true;\ntype PrimitiveCapabilitiesInput<\n  P,\n  S extends SystemStyle,\n  N extends SystemStyle,\n  R extends SystemStyle,\n> = Readonly<PrimitiveCapabilities<P, S, N, R>> & PrimitiveStyleGuard<S, N, R> & (\n  [PreservedSignalPropKey<P>] extends [never] ? object : {\n    readonly preserveSignalProps: readonly [\n      PreservedSignalPropKey<P>,\n      ...PreservedSignalPropKey<P>[],\n    ];\n  }\n);\ntype CapabilityArguments<\n  P,\n  S extends SystemStyle,\n  N extends SystemStyle,\n  R extends SystemStyle,\n> = RequiresResolver<R> extends true ? [capabilities: never] :\n  RequiresResolver<S> extends true ? [\n    capabilities: PrimitiveCapabilitiesInput<P, S, N, R> & {\n      resolveStyle: NonNullable<\n        PrimitiveCapabilities<P, S, N, R>['resolveStyle']\n      >;\n    },\n  ] : [PreservedSignalPropKey<P>] extends [never] ? [\n    capabilities?: PrimitiveCapabilitiesInput<P, S, N, R>,\n  ] : [capabilities: PrimitiveCapabilitiesInput<P, S, N, R>];\n\n/**\n * Defines a platform component with private style and measurement behavior.\n *\n * @param render - Synchronous primitive renderer receiving props, resolved style, and Canvas\n * context. See {@link PrimitiveRender} , {@link PrimitiveStyleGuard} , {@link PrimitiveInput} .\n * @param capabilityArguments - Style normalization, resolution, and measurement capabilities\n * required by the primitive. See {@link CapabilityArguments} .\n * @returns A primitive component usable with JSX or createElement. See\n * {@link PibblPrimitiveComponent} , {@link PrimitiveProgramProps} , {@link PrimitiveInput} .\n *\n * @see {@link PrimitiveRender}\n * @see {@link PrimitiveInput}\n * @see {@link PibblPrimitiveComponent}\n * @see {@link PrimitiveProgramProps}\n * @see {@link SystemStyle}\n */\nexport function definePrimitive<\n  P = Record<string, never>,\n  S extends SystemStyle = SystemStyle,\n  N extends SystemStyle = S,\n  R extends SystemStyle = N,\n>(\n  render: PrimitiveRender<P, R> & PrimitiveStyleGuard<S, N, R> & (\n    PrimitiveInput<P, S> extends never ? never : unknown\n  ),\n  ...capabilityArguments: CapabilityArguments<P, S, N, R>\n): PibblPrimitiveComponent<PrimitiveProgramProps<P>, PrimitiveInput<P, S>> {\n  return defineBackendPrimitive<P, S, N, R, RenderingContext2D>(\n    CANVAS_2D_BACKEND.token,\n    render,\n    ...capabilityArguments,\n  );\n}\n\n/**\n * Defines a primitive owned by one official Pibbl rendering backend.\n *\n * @param backend - Identity of the backend that can execute this primitive. See\n * {@link PibblBackendToken} .\n * @param program - Synchronous program using the active backend environment. See\n * {@link PibblBackendPrimitiveProgram} , {@link PrimitiveStyleGuard} , {@link PrimitiveInput} .\n * @param capabilityArguments - Style and measurement capabilities for the primitive. See\n * {@link CapabilityArguments} .\n * @returns A primitive component bound to the specified backend. See {@link PibblPrimitiveComponent}\n * , {@link PrimitiveProgramProps} , {@link PrimitiveInput} .\n *\n * @see {@link PibblBackendToken}\n * @see {@link PibblBackendPrimitiveProgram}\n * @see {@link PrimitiveInput}\n * @see {@link PibblPrimitiveComponent}\n * @see {@link PrimitiveProgramProps}\n * @see {@link SystemStyle}\n */\nexport function defineBackendPrimitive<\n  P = Record<string, never>,\n  S extends SystemStyle = SystemStyle,\n  N extends SystemStyle = S,\n  R extends SystemStyle = N,\n  E = unknown,\n>(\n  backend: PibblBackendToken,\n  program: PibblBackendPrimitiveProgram<P, R, E> & PrimitiveStyleGuard<S, N, R> & (\n    PrimitiveInput<P, S> extends never ? never : unknown\n  ),\n  ...capabilityArguments: CapabilityArguments<P, S, N, R>\n): PibblPrimitiveComponent<PrimitiveProgramProps<P>, PrimitiveInput<P, S>> {\n  const componentName = primitiveComponentName(program.name);\n  const component = function PibblPrimitiveComponent(): never {\n    throw new Error(\n      `${componentName} is a Pibbl component and was invoked outside the Pibbl ` +\n      'renderer.\\n' +\n      `Use <${componentName} ... /> in a Pibbl JSX file or ` +\n      `createElement(${componentName}, props).`,\n    );\n  } as unknown as PibblPrimitiveComponent<\n    PrimitiveProgramProps<P>,\n    PrimitiveInput<P, S>\n  >;\n  Object.defineProperty(component, 'name', {\n    configurable: true,\n    value: componentName,\n  });\n\n  const capabilities = (capabilityArguments[0] ?? {}) as Readonly<\n    PrimitiveCapabilities<P, S, N, R>\n  >;\n  setPrimitiveDefinition(component, {\n    backend,\n    program,\n    preserveSignalProps: capabilities.preserveSignalProps,\n    childInput: capabilities.childInput,\n    normalizeStyle: capabilities.normalizeStyle,\n    resolveStyle: capabilities.resolveStyle,\n    measure: capabilities.measure,\n    measureIntrinsic: capabilities.measureIntrinsic,\n    measureBaselines: capabilities.measureBaselines,\n  });\n  return component;\n}\n\n/**\n * Derives a new official-package primitive identity with the source behavior.\n *\n * @param source - Primitive whose rendering and capabilities are reused.\n * @returns A derived primitive with its own component identity.\n *\n * @see {@link PibblPrimitiveComponent}\n */\nexport function derivePrimitive<T extends PibblPrimitiveComponent<any, any>>(\n  source: T,\n): T {\n  if (!getPrimitiveDefinition(source)) {\n    throw new TypeError('Can only derive a Pibbl primitive component.');\n  }\n  const componentName = source.name || 'Anonymous';\n  const derived = function PibblPrimitiveComponent(): never {\n    throw new Error(\n      `${componentName} is a Pibbl component and was invoked outside the Pibbl ` +\n      'renderer.\\n' +\n      `Use <${componentName} ... /> in a Pibbl JSX file or ` +\n      `createElement(${componentName}, props).`,\n    );\n  } as unknown as T;\n  Object.defineProperty(derived, 'name', {\n    configurable: true,\n    value: componentName,\n  });\n  derivePrimitiveMetadata(source, derived);\n  return derived;\n}\n\n/**\n * Runs one official-package primitive resolver without render side-effect authority.\n *\n * @param callback - Synchronous resolver to evaluate with hooks and signal writes forbidden.\n * @returns The resolver's return value.\n *\n * @see {@link PrimitiveCapabilities}\n */\nexport function pibblInternalRunPurePrimitiveResolver<T>(callback: () => T): T {\n  const previousComponentRefs = GLOBAL_STATE.componentRefs;\n  const previousComponentHookIndex = GLOBAL_STATE.componentHookIndex;\n  const previousComponentIsMounting = GLOBAL_STATE.componentIsMounting;\n  GLOBAL_STATE.componentRefs = undefined;\n  GLOBAL_STATE.componentHookIndex = 0;\n  GLOBAL_STATE.componentIsMounting = false;\n  try {\n    return withSignalWriteForbidden('Pibbl pure primitive resolver', callback);\n  } finally {\n    GLOBAL_STATE.componentRefs = previousComponentRefs;\n    GLOBAL_STATE.componentHookIndex = previousComponentHookIndex;\n    GLOBAL_STATE.componentIsMounting = previousComponentIsMounting;\n  }\n}\n\nfunction primitiveComponentName(renderName: string): string {\n  if (/^render[A-Z]/.test(renderName)) return renderName.slice('render'.length);\n  return renderName || 'Anonymous';\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,OACK;AAeP,SAAS,oBAAoB;AAC7B,SAAS,gCAAgC;AA+DlC,SAAS,gBAMd,WAGG,qBACsE;AACzE,SAAO;AAAA,IACL,kBAAkB;AAAA,IAClB;AAAA,IACA,GAAG;AAAA,EACL;AACF;AAqBO,SAAS,uBAOd,SACA,YAGG,qBACsE;AACzE,QAAM,gBAAgB,uBAAuB,QAAQ,IAAI;AACzD,QAAM,YAAY,SAAS,0BAAiC;AAC1D,UAAM,IAAI;AAAA,MACR,GAAG,aAAa;AAAA,OAER,aAAa,gDACJ,aAAa;AAAA,IAChC;AAAA,EACF;AAIA,SAAO,eAAe,WAAW,QAAQ;AAAA,IACvC,cAAc;AAAA,IACd,OAAO;AAAA,EACT,CAAC;AAED,QAAM,eAAgB,oBAAoB,CAAC,KAAK,CAAC;AAGjD,yBAAuB,WAAW;AAAA,IAChC;AAAA,IACA;AAAA,IACA,qBAAqB,aAAa;AAAA,IAClC,YAAY,aAAa;AAAA,IACzB,gBAAgB,aAAa;AAAA,IAC7B,cAAc,aAAa;AAAA,IAC3B,SAAS,aAAa;AAAA,IACtB,kBAAkB,aAAa;AAAA,IAC/B,kBAAkB,aAAa;AAAA,EACjC,CAAC;AACD,SAAO;AACT;AAUO,SAAS,gBACd,QACG;AACH,MAAI,CAAC,uBAAuB,MAAM,GAAG;AACnC,UAAM,IAAI,UAAU,8CAA8C;AAAA,EACpE;AACA,QAAM,gBAAgB,OAAO,QAAQ;AACrC,QAAM,UAAU,SAAS,0BAAiC;AACxD,UAAM,IAAI;AAAA,MACR,GAAG,aAAa;AAAA,OAER,aAAa,gDACJ,aAAa;AAAA,IAChC;AAAA,EACF;AACA,SAAO,eAAe,SAAS,QAAQ;AAAA,IACrC,cAAc;AAAA,IACd,OAAO;AAAA,EACT,CAAC;AACD,0BAAwB,QAAQ,OAAO;AACvC,SAAO;AACT;AAUO,SAAS,sCAAyC,UAAsB;AAC7E,QAAM,wBAAwB,aAAa;AAC3C,QAAM,6BAA6B,aAAa;AAChD,QAAM,8BAA8B,aAAa;AACjD,eAAa,gBAAgB;AAC7B,eAAa,qBAAqB;AAClC,eAAa,sBAAsB;AACnC,MAAI;AACF,WAAO,yBAAyB,iCAAiC,QAAQ;AAAA,EAC3E,UAAE;AACA,iBAAa,gBAAgB;AAC7B,iBAAa,qBAAqB;AAClC,iBAAa,sBAAsB;AAAA,EACrC;AACF;AAEA,SAAS,uBAAuB,YAA4B;AAC1D,MAAI,eAAe,KAAK,UAAU,EAAG,QAAO,WAAW,MAAM,SAAS,MAAM;AAC5E,SAAO,cAAc;AACvB;",
   "names": []
 }

package/dist/lib/element/metadata.d.ts

@@ -1,6 +1,7 @@
 import type { PibblBackendPrimitiveInput } from "../backend/types.js";
 import type { PibblInternalPrimitiveAttachmentInput } from "../element-enhancers.js";
 import type { getCurrentElementSource } from "../../internal.js";
+import type { LayoutBox } from '../layout/types.js';
 import type { PibblRenderTransaction, SystemStyle } from '../types.js';
 import type { PibblElement } from './types.js';
 import type { PrimitivePresentation } from '../primitive-presentation.js';
@@ -26,6 +27,11 @@ export interface InternalElementMetadata {
     readonly primitiveProgramProps?: Readonly<Record<PropertyKey, unknown>>;
     readonly primitiveReceiverToken?: object;
     readonly policyPreparationSource?: PibblElement<any>;
+    readonly layoutDescriptionSource?: PibblElement<any>;
+    readonly preparedLayoutSlot?: object;
+    readonly layoutContentsChildren?: readonly PibblElement<any>[];
+    /** Ancestor padding box expressed in a placed static Flex content coordinate system. */
+    readonly absoluteContainingBlock?: Readonly<LayoutBox>;
     identityHint?: unknown;
     placementConsumed?: boolean;
     placementSignalHandoff?: Readonly<SystemStyle>;
@@ -79,6 +85,9 @@ export declare function getPrimitiveReceiverToken(element: PibblElement<any>): o
 export declare function createPrimitiveReceiverToken(): object;
 /** @internal Reuses a direct-child occurrence across layout measurement and paint. */
 export declare function getChildPrimitiveReceiverToken(transaction: PibblRenderTransaction | undefined, parent: object | undefined, occurrence: number): object;
+/** A transaction-independent numeric child path, never a retained receiver token. */
+export declare function primitiveReceiverPath(receiver: object, root: object): readonly number[] | undefined;
+export declare function primitiveReceiverAtPath(transaction: PibblRenderTransaction, root: object, path: readonly number[]): object;
 /** @internal Reads the private identity override for a placed element. */
 export declare function getPlacementIdentityHint<T>(element: PibblElement<any>): T | undefined;
 /** @internal Stores the private identity override for a placed element. */

package/dist/lib/element/metadata.js

@@ -4,6 +4,7 @@ const primitiveDefinitions = /* @__PURE__ */ new WeakMap();
 const primitiveDefinitionTypes = /* @__PURE__ */ new WeakMap();
 const primitivePresentationResolvers = /* @__PURE__ */ new WeakMap();
 const policyDefinitions = /* @__PURE__ */ new WeakMap();
+const receiverParents = /* @__PURE__ */ new WeakMap();
 const childPrimitiveReceiverTransactions = /* @__PURE__ */ new WeakMap();
 function setPrimitiveDefinition(type, definition) {
   const erased = definition;
@@ -94,10 +95,26 @@ function getChildPrimitiveReceiverToken(transaction, parent, occurrence) {
   let token = children.get(occurrence);
   if (!token) {
     token = createPrimitiveReceiverToken();
+    receiverParents.set(token, { parent, index: occurrence });
     children.set(occurrence, token);
   }
   return token;
 }
+function primitiveReceiverPath(receiver, root) {
+  const reverse = [];
+  while (receiver !== root) {
+    const edge = receiverParents.get(receiver);
+    if (!edge) return;
+    reverse.push(edge.index);
+    receiver = edge.parent;
+  }
+  return reverse.reverse();
+}
+function primitiveReceiverAtPath(transaction, root, path) {
+  let receiver = root;
+  for (let index = 0; index < path.length; index++) receiver = getChildPrimitiveReceiverToken(transaction, receiver, path[index]);
+  return receiver;
+}
 function getPlacementIdentityHint(element) {
   return elementMetadata.get(element)?.identityHint;
 }
@@ -145,6 +162,8 @@ export {
   getPrimitiveReceiverToken,
   getSpecifiedStyle,
   isPlacementConsumed,
+  primitiveReceiverAtPath,
+  primitiveReceiverPath,
   registerElementCloneMetadataHandler,
   registerOpaquePrimitiveProps,
   setElementMetadata,

package/dist/lib/element/metadata.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/element/metadata.ts"],
-  "sourcesContent": ["import type { PibblBackendPrimitiveInput } from '../backend/types.js';\nimport type { PibblInternalPrimitiveAttachmentInput } from '../element-enhancers.js';\nimport type { getCurrentElementSource } from '../../internal.js';\nimport type {\n  PibblRenderTransaction,\n  SystemStyle,\n} from '../types.js';\nimport type { PibblElement } from './types.js';\nimport type { PrimitivePresentation } from '../primitive-presentation.js';\nimport type { PibblBackendPrimitiveDefinition } from '../backend/types.js';\n\n/**\n * Authoring source location attached to an element for diagnostics.\n *\n * @see {@link PibblBackendPrimitiveInput}\n * @see {@link PibblInternalPrimitiveAttachmentInput}\n * @see {@link getCurrentElementSource}\n */\nexport interface PibblElementSource {\n  /** Source filename recorded for diagnostics. See {@link PibblElementSource}. */\n  readonly fileName: string;\n  /** Source line recorded for diagnostics. See {@link PibblElementSource}. */\n  readonly lineNumber: number;\n  /** Source column recorded for diagnostics. See {@link PibblElementSource}. */\n  readonly columnNumber: number;\n}\n\nexport interface InternalElementMetadata {\n  readonly source?: PibblElementSource;\n  readonly specifiedStyle?: Readonly<SystemStyle>;\n  readonly primitiveProgramProps?: Readonly<Record<PropertyKey, unknown>>;\n  readonly primitiveReceiverToken?: object;\n  readonly policyPreparationSource?: PibblElement<any>;\n  identityHint?: unknown;\n  placementConsumed?: boolean;\n  placementSignalHandoff?: Readonly<SystemStyle>;\n}\n\nconst elementMetadata = new WeakMap<PibblElement<any>, InternalElementMetadata>();\nconst elementCloneMetadataHandlers = new Set<(\n  source: PibblElement<any>,\n  clone: PibblElement<any>,\n) => void>();\nconst primitiveDefinitions = new WeakMap<Function, PrimitiveDefinition>();\nconst primitiveDefinitionTypes = new WeakMap<PrimitiveDefinition, Function>();\nconst primitivePresentationResolvers = new WeakMap<\n  Function,\n  (style: Readonly<any>) => Readonly<PrimitivePresentation> | undefined\n>();\nconst policyDefinitions = new WeakMap<Function, ElementPolicyDefinition>();\nconst childPrimitiveReceiverTransactions = new WeakMap<\n  PibblRenderTransaction,\n  WeakMap<object, Map<number, object>>\n>();\n\nexport interface PrimitiveDefinition<\n  P = any,\n  S extends SystemStyle = SystemStyle,\n  N extends SystemStyle = S,\n  R extends SystemStyle = N,\n> extends PibblBackendPrimitiveDefinition<P, S, N, R> {}\n\nexport interface ElementPolicyDefinition {\n  readonly prepare: (\n    policy: PibblElement<any>,\n    child: PibblElement<any>,\n  ) => PibblElement<any>;\n}\n\n/** @internal Registers the platform behavior for one component value. */\nexport function setPrimitiveDefinition<\n  P,\n  S extends SystemStyle,\n  N extends SystemStyle,\n  R extends SystemStyle,\n>(\n  type: Function,\n  definition: PrimitiveDefinition<P, S, N, R>,\n): void {\n  const erased = definition as PrimitiveDefinition;\n  primitiveDefinitions.set(type, erased);\n  primitiveDefinitionTypes.set(erased, type);\n}\n\n/** @internal Reads platform behavior without attaching fields to a function. */\nexport function getPrimitiveDefinition(\n  type: Function,\n): PrimitiveDefinition | undefined {\n  return primitiveDefinitions.get(type);\n}\n\n/** @internal Copies one primitive definition and presentation onto a new identity. */\nexport function derivePrimitiveMetadata(source: Function, derived: Function): void {\n  const definition = primitiveDefinitions.get(source);\n  if (!definition) throw new TypeError('Can only derive a Pibbl primitive component.');\n  setPrimitiveDefinition(derived, { ...definition });\n  const presentation = primitivePresentationResolvers.get(source);\n  if (presentation) primitivePresentationResolvers.set(derived, presentation);\n}\n\n/** @internal Resolves Canvas presentation behavior from erased backend input. */\nexport function getDefinitionPrimitivePresentation<S>(\n  definition: PrimitiveDefinition,\n  style: Readonly<S>,\n): Readonly<PrimitivePresentation> | undefined {\n  const type = primitiveDefinitionTypes.get(definition);\n  return type ? getPrimitivePresentation(type, style) : undefined;\n}\n\n/** @internal Registers private presentation behavior for one primitive. */\nexport function setPrimitivePresentation<S>(\n  type: Function,\n  resolve: (\n    style: Readonly<S>,\n  ) => Readonly<PrimitivePresentation> | undefined,\n): void {\n  primitivePresentationResolvers.set(type, resolve);\n}\n\n/** @internal Resolves private presentation behavior for one primitive. */\nexport function getPrimitivePresentation<S>(\n  type: Function,\n  style: Readonly<S>,\n): Readonly<PrimitivePresentation> | undefined {\n  return primitivePresentationResolvers.get(type)?.(style);\n}\n\n/** @internal Registers an identity-transparent element preparation policy. */\nexport function setElementPolicyDefinition(\n  type: Function,\n  definition: ElementPolicyDefinition,\n): void {\n  policyDefinitions.set(type, definition);\n}\n\n/** @internal Reads a policy before ordinary component identity is assigned. */\nexport function getElementPolicyDefinition(\n  type: Function,\n): ElementPolicyDefinition | undefined {\n  return policyDefinitions.get(type);\n}\n\n/** @internal */\nexport function setElementMetadata(\n  element: PibblElement<any>,\n  metadata: InternalElementMetadata,\n): void {\n  elementMetadata.set(element, metadata);\n}\n\n/** @internal */\nexport function getElementMetadata(\n  element: PibblElement<any>,\n): InternalElementMetadata | undefined {\n  return elementMetadata.get(element);\n}\n\n/** @internal Retains the original measurable identity behind policy clones. */\nexport function setPolicyPreparationSource(\n  element: PibblElement<any>,\n  source: PibblElement<any>,\n): void {\n  elementMetadata.set(element, {\n    ...elementMetadata.get(element),\n    policyPreparationSource: source,\n  });\n}\n\n/** @internal Reads the original measurable identity behind policy clones. */\nexport function getPolicyPreparationSource(\n  element: PibblElement<any>,\n): PibblElement<any> | undefined {\n  return elementMetadata.get(element)?.policyPreparationSource;\n}\n\n/** @internal Registers private WeakMap-backed annotations for immutable clones. */\nexport function registerElementCloneMetadataHandler(\n  handler: (source: PibblElement<any>, clone: PibblElement<any>) => void,\n): void {\n  elementCloneMetadataHandlers.add(handler);\n}\n\n/** @internal Copies every registered private annotation to a finalized clone. */\nexport function copyElementCloneMetadata(\n  source: PibblElement<any>,\n  clone: PibblElement<any>,\n): void {\n  for (const handler of elementCloneMetadataHandlers) handler(source, clone);\n}\n\n/** @internal */\nexport function getElementSource(\n  element: PibblElement<any>,\n): PibblElementSource | undefined {\n  return elementMetadata.get(element)?.source;\n}\n\n/** @internal */\nexport function getSpecifiedStyle<S extends SystemStyle>(\n  element: PibblElement<{ style?: S }>,\n): Readonly<S> | undefined {\n  return element.props.style;\n}\n\n/** @internal Returns program props with primitive-owned style removed. */\nexport function getPrimitiveProgramProps<P>(element: PibblElement<any>): P {\n  const prepared = elementMetadata.get(element)?.primitiveProgramProps;\n  if (prepared !== undefined) return prepared as P;\n  const { style: _style, ...programProps } = element.props as {\n    readonly style?: unknown;\n    readonly [key: PropertyKey]: unknown;\n  };\n  return programProps as P;\n}\n\n/** @internal Associates measurement and paint clones for one occurrence. */\nexport function setPrimitiveReceiverToken(\n  element: PibblElement<any>,\n  token: object,\n): void {\n  const current = elementMetadata.get(element) ?? {};\n  elementMetadata.set(element, { ...current, primitiveReceiverToken: token });\n}\n\n/** @internal Reads the occurrence token carried by an internal clone. */\nexport function getPrimitiveReceiverToken(\n  element: PibblElement<any>,\n): object | undefined {\n  return elementMetadata.get(element)?.primitiveReceiverToken;\n}\n\n/** @internal Creates one receiver identity for a standalone measurement. */\nexport function createPrimitiveReceiverToken(): object {\n  return {};\n}\n\n/** @internal Reuses a direct-child occurrence across layout measurement and paint. */\nexport function getChildPrimitiveReceiverToken(\n  transaction: PibblRenderTransaction | undefined,\n  parent: object | undefined,\n  occurrence: number,\n): object {\n  if (!transaction || !parent) return createPrimitiveReceiverToken();\n  let parents = childPrimitiveReceiverTransactions.get(transaction);\n  if (!parents) {\n    parents = new WeakMap();\n    childPrimitiveReceiverTransactions.set(transaction, parents);\n  }\n  let children = parents.get(parent);\n  if (!children) {\n    children = new Map();\n    parents.set(parent, children);\n  }\n  let token = children.get(occurrence);\n  if (!token) {\n    token = createPrimitiveReceiverToken();\n    children.set(occurrence, token);\n  }\n  return token;\n}\n\n/** @internal Reads the private identity override for a placed element. */\nexport function getPlacementIdentityHint<T>(element: PibblElement<any>): T | undefined {\n  return elementMetadata.get(element)?.identityHint as T | undefined;\n}\n\n/** @internal Stores the private identity override for a placed element. */\nexport function setPlacementIdentityHint<T>(element: PibblElement<any>, value: T): void {\n  const current = elementMetadata.get(element) ?? {};\n  elementMetadata.set(element, { ...current, identityHint: value });\n}\n\nconst opaquePrimitiveProps = new WeakMap<Function, readonly string[]>();\n/** @internal Built-in opaque payloads, without widening definePrimitive's API. */\nexport function registerOpaquePrimitiveProps(type: Function, keys: readonly string[]): void {\n  opaquePrimitiveProps.set(type, keys);\n}\nexport function getOpaquePrimitiveProps(type: Function): readonly string[] | undefined {\n  return opaquePrimitiveProps.get(type);\n}\n\n/** @internal Marks authored left/top as consumed by a parent layout wrapper. */\nexport function setPlacementConsumed(element: PibblElement<any>): void {\n  const current = elementMetadata.get(element) ?? {};\n  elementMetadata.set(element, { ...current, placementConsumed: true });\n}\n\n/** @internal */\nexport function isPlacementConsumed(element: PibblElement<any>): boolean {\n  return elementMetadata.get(element)?.placementConsumed === true;\n}\n\n\n/** @internal Marks an element created with a forwarded placement style signal. */\nexport function setPlacementSignalHandoff(\n  element: PibblElement<any>,\n  style: Readonly<SystemStyle>,\n): void {\n  const current = elementMetadata.get(element) ?? {};\n  elementMetadata.set(element, { ...current, placementSignalHandoff: style });\n}\n\n/** @internal */\nexport function getPlacementSignalHandoffStyle(\n  element: PibblElement<any>,\n): Readonly<SystemStyle> | undefined {\n  return elementMetadata.get(element)?.placementSignalHandoff;\n}\n"],
-  "mappings": "AAsCA,MAAM,kBAAkB,oBAAI,QAAoD;AAChF,MAAM,+BAA+B,oBAAI,IAG9B;AACX,MAAM,uBAAuB,oBAAI,QAAuC;AACxE,MAAM,2BAA2B,oBAAI,QAAuC;AAC5E,MAAM,iCAAiC,oBAAI,QAGzC;AACF,MAAM,oBAAoB,oBAAI,QAA2C;AACzE,MAAM,qCAAqC,oBAAI,QAG7C;AAiBK,SAAS,uBAMd,MACA,YACM;AACN,QAAM,SAAS;AACf,uBAAqB,IAAI,MAAM,MAAM;AACrC,2BAAyB,IAAI,QAAQ,IAAI;AAC3C;AAGO,SAAS,uBACd,MACiC;AACjC,SAAO,qBAAqB,IAAI,IAAI;AACtC;AAGO,SAAS,wBAAwB,QAAkB,SAAyB;AACjF,QAAM,aAAa,qBAAqB,IAAI,MAAM;AAClD,MAAI,CAAC,WAAY,OAAM,IAAI,UAAU,8CAA8C;AACnF,yBAAuB,SAAS,EAAE,GAAG,WAAW,CAAC;AACjD,QAAM,eAAe,+BAA+B,IAAI,MAAM;AAC9D,MAAI,aAAc,gCAA+B,IAAI,SAAS,YAAY;AAC5E;AAGO,SAAS,mCACd,YACA,OAC6C;AAC7C,QAAM,OAAO,yBAAyB,IAAI,UAAU;AACpD,SAAO,OAAO,yBAAyB,MAAM,KAAK,IAAI;AACxD;AAGO,SAAS,yBACd,MACA,SAGM;AACN,iCAA+B,IAAI,MAAM,OAAO;AAClD;AAGO,SAAS,yBACd,MACA,OAC6C;AAC7C,SAAO,+BAA+B,IAAI,IAAI,IAAI,KAAK;AACzD;AAGO,SAAS,2BACd,MACA,YACM;AACN,oBAAkB,IAAI,MAAM,UAAU;AACxC;AAGO,SAAS,2BACd,MACqC;AACrC,SAAO,kBAAkB,IAAI,IAAI;AACnC;AAGO,SAAS,mBACd,SACA,UACM;AACN,kBAAgB,IAAI,SAAS,QAAQ;AACvC;AAGO,SAAS,mBACd,SACqC;AACrC,SAAO,gBAAgB,IAAI,OAAO;AACpC;AAGO,SAAS,2BACd,SACA,QACM;AACN,kBAAgB,IAAI,SAAS;AAAA,IAC3B,GAAG,gBAAgB,IAAI,OAAO;AAAA,IAC9B,yBAAyB;AAAA,EAC3B,CAAC;AACH;AAGO,SAAS,2BACd,SAC+B;AAC/B,SAAO,gBAAgB,IAAI,OAAO,GAAG;AACvC;AAGO,SAAS,oCACd,SACM;AACN,+BAA6B,IAAI,OAAO;AAC1C;AAGO,SAAS,yBACd,QACA,OACM;AACN,aAAW,WAAW,6BAA8B,SAAQ,QAAQ,KAAK;AAC3E;AAGO,SAAS,iBACd,SACgC;AAChC,SAAO,gBAAgB,IAAI,OAAO,GAAG;AACvC;AAGO,SAAS,kBACd,SACyB;AACzB,SAAO,QAAQ,MAAM;AACvB;AAGO,SAAS,yBAA4B,SAA+B;AACzE,QAAM,WAAW,gBAAgB,IAAI,OAAO,GAAG;AAC/C,MAAI,aAAa,OAAW,QAAO;AACnC,QAAM,EAAE,OAAO,QAAQ,GAAG,aAAa,IAAI,QAAQ;AAInD,SAAO;AACT;AAGO,SAAS,0BACd,SACA,OACM;AACN,QAAM,UAAU,gBAAgB,IAAI,OAAO,KAAK,CAAC;AACjD,kBAAgB,IAAI,SAAS,EAAE,GAAG,SAAS,wBAAwB,MAAM,CAAC;AAC5E;AAGO,SAAS,0BACd,SACoB;AACpB,SAAO,gBAAgB,IAAI,OAAO,GAAG;AACvC;AAGO,SAAS,+BAAuC;AACrD,SAAO,CAAC;AACV;AAGO,SAAS,+BACd,aACA,QACA,YACQ;AACR,MAAI,CAAC,eAAe,CAAC,OAAQ,QAAO,6BAA6B;AACjE,MAAI,UAAU,mCAAmC,IAAI,WAAW;AAChE,MAAI,CAAC,SAAS;AACZ,cAAU,oBAAI,QAAQ;AACtB,uCAAmC,IAAI,aAAa,OAAO;AAAA,EAC7D;AACA,MAAI,WAAW,QAAQ,IAAI,MAAM;AACjC,MAAI,CAAC,UAAU;AACb,eAAW,oBAAI,IAAI;AACnB,YAAQ,IAAI,QAAQ,QAAQ;AAAA,EAC9B;AACA,MAAI,QAAQ,SAAS,IAAI,UAAU;AACnC,MAAI,CAAC,OAAO;AACV,YAAQ,6BAA6B;AACrC,aAAS,IAAI,YAAY,KAAK;AAAA,EAChC;AACA,SAAO;AACT;AAGO,SAAS,yBAA4B,SAA2C;AACrF,SAAO,gBAAgB,IAAI,OAAO,GAAG;AACvC;AAGO,SAAS,yBAA4B,SAA4B,OAAgB;AACtF,QAAM,UAAU,gBAAgB,IAAI,OAAO,KAAK,CAAC;AACjD,kBAAgB,IAAI,SAAS,EAAE,GAAG,SAAS,cAAc,MAAM,CAAC;AAClE;AAEA,MAAM,uBAAuB,oBAAI,QAAqC;AAE/D,SAAS,6BAA6B,MAAgB,MAA+B;AAC1F,uBAAqB,IAAI,MAAM,IAAI;AACrC;AACO,SAAS,wBAAwB,MAA+C;AACrF,SAAO,qBAAqB,IAAI,IAAI;AACtC;AAGO,SAAS,qBAAqB,SAAkC;AACrE,QAAM,UAAU,gBAAgB,IAAI,OAAO,KAAK,CAAC;AACjD,kBAAgB,IAAI,SAAS,EAAE,GAAG,SAAS,mBAAmB,KAAK,CAAC;AACtE;AAGO,SAAS,oBAAoB,SAAqC;AACvE,SAAO,gBAAgB,IAAI,OAAO,GAAG,sBAAsB;AAC7D;AAIO,SAAS,0BACd,SACA,OACM;AACN,QAAM,UAAU,gBAAgB,IAAI,OAAO,KAAK,CAAC;AACjD,kBAAgB,IAAI,SAAS,EAAE,GAAG,SAAS,wBAAwB,MAAM,CAAC;AAC5E;AAGO,SAAS,+BACd,SACmC;AACnC,SAAO,gBAAgB,IAAI,OAAO,GAAG;AACvC;",
+  "sourcesContent": ["import type { LayoutBox } from '../layout/types.js';\nimport type { PibblBackendPrimitiveInput } from '../backend/types.js';\nimport type { PibblInternalPrimitiveAttachmentInput } from '../element-enhancers.js';\nimport type { getCurrentElementSource } from '../../internal.js';\nimport type {\n  PibblRenderTransaction,\n  SystemStyle,\n} from '../types.js';\nimport type { PibblElement } from './types.js';\nimport type { PrimitivePresentation } from '../primitive-presentation.js';\nimport type { PibblBackendPrimitiveDefinition } from '../backend/types.js';\n\n/**\n * Authoring source location attached to an element for diagnostics.\n *\n * @see {@link PibblBackendPrimitiveInput}\n * @see {@link PibblInternalPrimitiveAttachmentInput}\n * @see {@link getCurrentElementSource}\n */\nexport interface PibblElementSource {\n  /** Source filename recorded for diagnostics. See {@link PibblElementSource}. */\n  readonly fileName: string;\n  /** Source line recorded for diagnostics. See {@link PibblElementSource}. */\n  readonly lineNumber: number;\n  /** Source column recorded for diagnostics. See {@link PibblElementSource}. */\n  readonly columnNumber: number;\n}\n\nexport interface InternalElementMetadata {\n  readonly source?: PibblElementSource;\n  readonly specifiedStyle?: Readonly<SystemStyle>;\n  readonly primitiveProgramProps?: Readonly<Record<PropertyKey, unknown>>;\n  readonly primitiveReceiverToken?: object;\n  readonly policyPreparationSource?: PibblElement<any>;\n  readonly layoutDescriptionSource?: PibblElement<any>;\n  readonly preparedLayoutSlot?: object;\n  readonly layoutContentsChildren?: readonly PibblElement<any>[];\n  /** Ancestor padding box expressed in a placed static Flex content coordinate system. */\n  readonly absoluteContainingBlock?: Readonly<LayoutBox>;\n  identityHint?: unknown;\n  placementConsumed?: boolean;\n  placementSignalHandoff?: Readonly<SystemStyle>;\n}\n\nconst elementMetadata = new WeakMap<PibblElement<any>, InternalElementMetadata>();\nconst elementCloneMetadataHandlers = new Set<(\n  source: PibblElement<any>,\n  clone: PibblElement<any>,\n) => void>();\nconst primitiveDefinitions = new WeakMap<Function, PrimitiveDefinition>();\nconst primitiveDefinitionTypes = new WeakMap<PrimitiveDefinition, Function>();\nconst primitivePresentationResolvers = new WeakMap<\n  Function,\n  (style: Readonly<any>) => Readonly<PrimitivePresentation> | undefined\n>();\nconst policyDefinitions = new WeakMap<Function, ElementPolicyDefinition>();\nconst receiverParents = new WeakMap<object, { parent: object; index: number }>();\nconst childPrimitiveReceiverTransactions = new WeakMap<\n  PibblRenderTransaction,\n  WeakMap<object, Map<number, object>>\n>();\n\nexport interface PrimitiveDefinition<\n  P = any,\n  S extends SystemStyle = SystemStyle,\n  N extends SystemStyle = S,\n  R extends SystemStyle = N,\n> extends PibblBackendPrimitiveDefinition<P, S, N, R> {}\n\nexport interface ElementPolicyDefinition {\n  readonly prepare: (\n    policy: PibblElement<any>,\n    child: PibblElement<any>,\n  ) => PibblElement<any>;\n}\n\n/** @internal Registers the platform behavior for one component value. */\nexport function setPrimitiveDefinition<\n  P,\n  S extends SystemStyle,\n  N extends SystemStyle,\n  R extends SystemStyle,\n>(\n  type: Function,\n  definition: PrimitiveDefinition<P, S, N, R>,\n): void {\n  const erased = definition as PrimitiveDefinition;\n  primitiveDefinitions.set(type, erased);\n  primitiveDefinitionTypes.set(erased, type);\n}\n\n/** @internal Reads platform behavior without attaching fields to a function. */\nexport function getPrimitiveDefinition(\n  type: Function,\n): PrimitiveDefinition | undefined {\n  return primitiveDefinitions.get(type);\n}\n\n/** @internal Copies one primitive definition and presentation onto a new identity. */\nexport function derivePrimitiveMetadata(source: Function, derived: Function): void {\n  const definition = primitiveDefinitions.get(source);\n  if (!definition) throw new TypeError('Can only derive a Pibbl primitive component.');\n  setPrimitiveDefinition(derived, { ...definition });\n  const presentation = primitivePresentationResolvers.get(source);\n  if (presentation) primitivePresentationResolvers.set(derived, presentation);\n}\n\n/** @internal Resolves Canvas presentation behavior from erased backend input. */\nexport function getDefinitionPrimitivePresentation<S>(\n  definition: PrimitiveDefinition,\n  style: Readonly<S>,\n): Readonly<PrimitivePresentation> | undefined {\n  const type = primitiveDefinitionTypes.get(definition);\n  return type ? getPrimitivePresentation(type, style) : undefined;\n}\n\n/** @internal Registers private presentation behavior for one primitive. */\nexport function setPrimitivePresentation<S>(\n  type: Function,\n  resolve: (\n    style: Readonly<S>,\n  ) => Readonly<PrimitivePresentation> | undefined,\n): void {\n  primitivePresentationResolvers.set(type, resolve);\n}\n\n/** @internal Resolves private presentation behavior for one primitive. */\nexport function getPrimitivePresentation<S>(\n  type: Function,\n  style: Readonly<S>,\n): Readonly<PrimitivePresentation> | undefined {\n  return primitivePresentationResolvers.get(type)?.(style);\n}\n\n/** @internal Registers an identity-transparent element preparation policy. */\nexport function setElementPolicyDefinition(\n  type: Function,\n  definition: ElementPolicyDefinition,\n): void {\n  policyDefinitions.set(type, definition);\n}\n\n/** @internal Reads a policy before ordinary component identity is assigned. */\nexport function getElementPolicyDefinition(\n  type: Function,\n): ElementPolicyDefinition | undefined {\n  return policyDefinitions.get(type);\n}\n\n/** @internal */\nexport function setElementMetadata(\n  element: PibblElement<any>,\n  metadata: InternalElementMetadata,\n): void {\n  elementMetadata.set(element, metadata);\n}\n\n/** @internal */\nexport function getElementMetadata(\n  element: PibblElement<any>,\n): InternalElementMetadata | undefined {\n  return elementMetadata.get(element);\n}\n\n/** @internal Retains the original measurable identity behind policy clones. */\nexport function setPolicyPreparationSource(\n  element: PibblElement<any>,\n  source: PibblElement<any>,\n): void {\n  elementMetadata.set(element, {\n    ...elementMetadata.get(element),\n    policyPreparationSource: source,\n  });\n}\n\n/** @internal Reads the original measurable identity behind policy clones. */\nexport function getPolicyPreparationSource(\n  element: PibblElement<any>,\n): PibblElement<any> | undefined {\n  return elementMetadata.get(element)?.policyPreparationSource;\n}\n\n/** @internal Registers private WeakMap-backed annotations for immutable clones. */\nexport function registerElementCloneMetadataHandler(\n  handler: (source: PibblElement<any>, clone: PibblElement<any>) => void,\n): void {\n  elementCloneMetadataHandlers.add(handler);\n}\n\n/** @internal Copies every registered private annotation to a finalized clone. */\nexport function copyElementCloneMetadata(\n  source: PibblElement<any>,\n  clone: PibblElement<any>,\n): void {\n  for (const handler of elementCloneMetadataHandlers) handler(source, clone);\n}\n\n/** @internal */\nexport function getElementSource(\n  element: PibblElement<any>,\n): PibblElementSource | undefined {\n  return elementMetadata.get(element)?.source;\n}\n\n/** @internal */\nexport function getSpecifiedStyle<S extends SystemStyle>(\n  element: PibblElement<{ style?: S }>,\n): Readonly<S> | undefined {\n  return element.props.style;\n}\n\n/** @internal Returns program props with primitive-owned style removed. */\nexport function getPrimitiveProgramProps<P>(element: PibblElement<any>): P {\n  const prepared = elementMetadata.get(element)?.primitiveProgramProps;\n  if (prepared !== undefined) return prepared as P;\n  const { style: _style, ...programProps } = element.props as {\n    readonly style?: unknown;\n    readonly [key: PropertyKey]: unknown;\n  };\n  return programProps as P;\n}\n\n/** @internal Associates measurement and paint clones for one occurrence. */\nexport function setPrimitiveReceiverToken(\n  element: PibblElement<any>,\n  token: object,\n): void {\n  const current = elementMetadata.get(element) ?? {};\n  elementMetadata.set(element, { ...current, primitiveReceiverToken: token });\n}\n\n/** @internal Reads the occurrence token carried by an internal clone. */\nexport function getPrimitiveReceiverToken(\n  element: PibblElement<any>,\n): object | undefined {\n  return elementMetadata.get(element)?.primitiveReceiverToken;\n}\n\n/** @internal Creates one receiver identity for a standalone measurement. */\nexport function createPrimitiveReceiverToken(): object {\n  return {};\n}\n\n/** @internal Reuses a direct-child occurrence across layout measurement and paint. */\nexport function getChildPrimitiveReceiverToken(\n  transaction: PibblRenderTransaction | undefined,\n  parent: object | undefined,\n  occurrence: number,\n): object {\n  if (!transaction || !parent) return createPrimitiveReceiverToken();\n  let parents = childPrimitiveReceiverTransactions.get(transaction);\n  if (!parents) {\n    parents = new WeakMap();\n    childPrimitiveReceiverTransactions.set(transaction, parents);\n  }\n  let children = parents.get(parent);\n  if (!children) {\n    children = new Map();\n    parents.set(parent, children);\n  }\n  let token = children.get(occurrence);\n  if (!token) {\n    token = createPrimitiveReceiverToken();\n    receiverParents.set(token, { parent, index: occurrence });\n    children.set(occurrence, token);\n  }\n  return token;\n}\n\n/** A transaction-independent numeric child path, never a retained receiver token. */\nexport function primitiveReceiverPath(receiver: object, root: object): readonly number[] | undefined {\n  const reverse: number[] = [];\n  while (receiver !== root) {\n    const edge = receiverParents.get(receiver);\n    if (!edge) return;\n    reverse.push(edge.index); receiver = edge.parent;\n  }\n  return reverse.reverse();\n}\nexport function primitiveReceiverAtPath(transaction: PibblRenderTransaction, root: object, path: readonly number[]): object {\n  let receiver = root;\n  for (let index = 0; index < path.length; index++) receiver = getChildPrimitiveReceiverToken(transaction, receiver, path[index]);\n  return receiver;\n}\n\n/** @internal Reads the private identity override for a placed element. */\nexport function getPlacementIdentityHint<T>(element: PibblElement<any>): T | undefined {\n  return elementMetadata.get(element)?.identityHint as T | undefined;\n}\n\n/** @internal Stores the private identity override for a placed element. */\nexport function setPlacementIdentityHint<T>(element: PibblElement<any>, value: T): void {\n  const current = elementMetadata.get(element) ?? {};\n  elementMetadata.set(element, { ...current, identityHint: value });\n}\n\nconst opaquePrimitiveProps = new WeakMap<Function, readonly string[]>();\n/** @internal Built-in opaque payloads, without widening definePrimitive's API. */\nexport function registerOpaquePrimitiveProps(type: Function, keys: readonly string[]): void {\n  opaquePrimitiveProps.set(type, keys);\n}\nexport function getOpaquePrimitiveProps(type: Function): readonly string[] | undefined {\n  return opaquePrimitiveProps.get(type);\n}\n\n/** @internal Marks authored left/top as consumed by a parent layout wrapper. */\nexport function setPlacementConsumed(element: PibblElement<any>): void {\n  const current = elementMetadata.get(element) ?? {};\n  elementMetadata.set(element, { ...current, placementConsumed: true });\n}\n\n/** @internal */\nexport function isPlacementConsumed(element: PibblElement<any>): boolean {\n  return elementMetadata.get(element)?.placementConsumed === true;\n}\n\n\n/** @internal Marks an element created with a forwarded placement style signal. */\nexport function setPlacementSignalHandoff(\n  element: PibblElement<any>,\n  style: Readonly<SystemStyle>,\n): void {\n  const current = elementMetadata.get(element) ?? {};\n  elementMetadata.set(element, { ...current, placementSignalHandoff: style });\n}\n\n/** @internal */\nexport function getPlacementSignalHandoffStyle(\n  element: PibblElement<any>,\n): Readonly<SystemStyle> | undefined {\n  return elementMetadata.get(element)?.placementSignalHandoff;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/element/resolve-primitive-inputs.d.ts

@@ -10,3 +10,5 @@ export declare function resolvePrimitiveInputs(element: PibblElement<any>, defin
 }, basis?: QueryBasis): ResolvedPrimitiveInputs;
 export declare function resolvePrimitiveStyleInput(input: unknown, element: PibblElement<any> | undefined, basis: QueryBasis | undefined, mode: 'value'): Readonly<Record<PropertyKey, unknown>> | undefined;
 export declare function resolvePrimitiveStyleInput(input: unknown, element?: PibblElement<any>, basis?: QueryBasis): Readonly<Record<PropertyKey, unknown>> | ResponsiveStylePreparation | undefined;
+/** @internal Shared receiver input roles for numeric allocation comparisons. */
+export declare function styleInputRole(key: string): 'layout' | 'measurement' | 'paint' | 'interaction' | 'transform' | 'unknown';

package/dist/lib/element/resolve-primitive-inputs.js

@@ -8,7 +8,8 @@ import {
   isSignal,
   recordPlainInputResolution,
   recordShallowInputCopy,
-  recordSignalInputResolution
+  recordSignalInputResolution,
+  withSignalDependencyRole
 } from "../signals/graph.js";
 function resolvePrimitiveInputs(element, definition, prepared, basis) {
   const rawProps = getPrimitiveProgramProps(element);
@@ -26,7 +27,7 @@ function resolvePrimitiveInputs(element, definition, prepared, basis) {
         programProps = { ...rawProps };
         recordShallowInputCopy();
       }
-      programProps[key] = value.get();
+      programProps[key] = key === "pointerEvents" || key === "keyboardFocusable" || key === "keyboardNavigationBounds" ? withSignalDependencyRole("interaction", () => value.get()) : value.get();
     } else {
       recordPlainInputResolution();
       if (programProps !== void 0) programProps[key] = value;
@@ -69,15 +70,27 @@ function resolvePrimitiveStyleInput(input, element, basis, mode = "preparation")
         resolved = { ...source };
         recordShallowInputCopy();
       }
-      resolved[key] = value.get();
+      resolved[key] = withSignalDependencyRole(
+        styleInputRole(key),
+        () => value.get()
+      );
     } else {
       recordPlainInputResolution();
     }
   }
   return resolved ?? source;
 }
+function styleInputRole(key) {
+  if (key === "fill" || key === "stroke" || key === "strokeWidth" || key === "opacity" || key === "filter") return "paint";
+  if (key === "translateX" || key === "translateY" || key === "scaleX" || key === "scaleY" || key === "rotationDegrees" || key === "rotationOrigin" || key === "skewX" || key === "skewY") return "transform";
+  if (key === "cursor" || key === "pointerEvents" || key === "lineInteractionWidth") return "interaction";
+  if (key === "font" || key === "textBaseline" || key === "textAlign" || key === "lineHeight" || key === "wrap" || key === "fit") return "measurement";
+  if (key === "layoutParticipation" || key === "gridAutoFlow" || key === "gridAutoColumns" || key === "gridAutoRows" || key === "gridTemplateColumns" || key === "gridTemplateRows" || key === "gridColumnStart" || key === "gridColumnSpan" || key === "gridRowStart" || key === "gridRowSpan" || key === "aspectRatio" || key === "borderWidth" || key === "borderStartWidth" || key === "borderEndWidth" || key === "boxSizing" || key === "width" || key === "height" || key === "minWidth" || key === "minHeight" || key === "maxWidth" || key === "maxHeight" || key === "position" || key === "left" || key === "right" || key === "top" || key === "bottom" || key === "insetStart" || key === "insetEnd" || key === "flexBasis" || key === "flexGrow" || key === "flexShrink" || key === "layoutDirection" || key === "flexDirection" || key === "flexWrap" || key === "justifyContent" || key === "alignItems" || key === "alignSelf" || key === "alignContent" || key === "gap" || key === "rowGap" || key === "columnGap" || key === "padding" || key === "paddingStart" || key === "paddingEnd" || key === "margin" || key === "marginTop" || key === "marginRight" || key === "marginBottom" || key === "marginLeft" || key === "marginStart" || key === "marginEnd") return "layout";
+  return "unknown";
+}
 export {
   resolvePrimitiveInputs,
-  resolvePrimitiveStyleInput
+  resolvePrimitiveStyleInput,
+  styleInputRole
 };
 //# sourceMappingURL=resolve-primitive-inputs.js.map