@pibbl/core 0.0.2 → 0.0.3-alpha.109.1

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": "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",
+  "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

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/element/resolve-primitive-inputs.ts"],
-  "sourcesContent": ["import { resolveResponsiveStyle, preparedStyleValue, type ResponsiveStylePreparation, type QueryBasis } from '../style/responsive.js';\nimport {\n  getPrimitiveProgramProps,\n  getOpaquePrimitiveProps,\n  getSpecifiedStyle,\n  type PrimitiveDefinition,\n} from './metadata.js';\nimport type { PibblElement } from './types.js';\nimport {\n  isSignal,\n  recordPlainInputResolution,\n  recordShallowInputCopy,\n  recordSignalInputResolution,\n} from '../signals/graph.js';\n\nexport interface ResolvedPrimitiveInputs {\n  readonly props: Readonly<Record<PropertyKey, unknown>>;\n  readonly style: Readonly<Record<PropertyKey, unknown>> | undefined;\n}\n\nexport function resolvePrimitiveInputs(\n  element: PibblElement<any>,\n  definition: PrimitiveDefinition,\n  prepared?: { style: Readonly<Record<PropertyKey, unknown>> },\n  basis?: QueryBasis,\n): ResolvedPrimitiveInputs {\n  const rawProps = getPrimitiveProgramProps(element) as Readonly<\n    Record<PropertyKey, unknown>\n  >;\n  const preserve = definition.preserveSignalProps as\n    readonly PropertyKey[] | undefined;\n  let programProps: Record<PropertyKey, unknown> | undefined;\n\n  for (const key in rawProps) {\n    const value = rawProps[key];\n    if (key === 'children' || preserve?.includes(key) || getOpaquePrimitiveProps(element.type)?.includes(key)) {\n      if (programProps !== undefined) programProps[key] = value;\n      continue;\n    }\n    if (isSignal(value)) {\n      recordSignalInputResolution();\n      if (programProps === undefined) {\n        programProps = { ...rawProps };\n        recordShallowInputCopy();\n      }\n      programProps[key] = value.get();\n    } else {\n      recordPlainInputResolution();\n      if (programProps !== undefined) programProps[key] = value;\n    }\n  }\n\n  return {\n    props: programProps ?? rawProps,\n    style: prepared ? prepared.style : resolvePrimitiveStyleInput(\n      getSpecifiedStyle(element), element, basis, 'value',\n    ),\n  };\n}\n\nexport function resolvePrimitiveStyleInput(\n  input: unknown,\n  element: PibblElement<any> | undefined,\n  basis: QueryBasis | undefined,\n  mode: 'value',\n): Readonly<Record<PropertyKey, unknown>> | undefined;\nexport function resolvePrimitiveStyleInput(\n  input: unknown,\n  element?: PibblElement<any>,\n  basis?: QueryBasis,\n): Readonly<Record<PropertyKey, unknown>> | ResponsiveStylePreparation | undefined;\nexport function resolvePrimitiveStyleInput(\n  input: unknown,\n  element?: PibblElement<any>,\n  basis?: QueryBasis,\n  mode: 'value' | 'preparation' = 'preparation',\n): Readonly<Record<PropertyKey, unknown>> | ResponsiveStylePreparation | undefined {\n  let style = input;\n  if (isSignal(style)) {\n    recordSignalInputResolution();\n    style = style.get();\n  } else if (style !== undefined) {\n    recordPlainInputResolution();\n  }\n  if (style === undefined) return undefined;\n  if (style === null || typeof style !== 'object') {\n    return style as Readonly<Record<PropertyKey, unknown>>;\n  }\n\n  const source = style as Readonly<Record<PropertyKey, unknown>>;\n  if (source.when !== undefined) {\n    const prepared = resolveResponsiveStyle(source, element, basis);\n    return mode === 'value' ? preparedStyleValue(prepared) : prepared;\n  }\n  let resolved: Record<PropertyKey, unknown> | undefined;\n  for (const key in source) {\n    if (key === 'custom') continue;\n    const value = source[key];\n    if (isSignal(value)) {\n      recordSignalInputResolution();\n      if (resolved === undefined) {\n        resolved = { ...source };\n        recordShallowInputCopy();\n      }\n      resolved[key] = value.get();\n    } else {\n      recordPlainInputResolution();\n    }\n  }\n  return resolved ?? source;\n}\n"],
-  "mappings": "AAAA,SAAS,wBAAwB,0BAA4E;AAC7G;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAOA,SAAS,uBACd,SACA,YACA,UACA,OACyB;AACzB,QAAM,WAAW,yBAAyB,OAAO;AAGjD,QAAM,WAAW,WAAW;AAE5B,MAAI;AAEJ,aAAW,OAAO,UAAU;AAC1B,UAAM,QAAQ,SAAS,GAAG;AAC1B,QAAI,QAAQ,cAAc,UAAU,SAAS,GAAG,KAAK,wBAAwB,QAAQ,IAAI,GAAG,SAAS,GAAG,GAAG;AACzG,UAAI,iBAAiB,OAAW,cAAa,GAAG,IAAI;AACpD;AAAA,IACF;AACA,QAAI,SAAS,KAAK,GAAG;AACnB,kCAA4B;AAC5B,UAAI,iBAAiB,QAAW;AAC9B,uBAAe,EAAE,GAAG,SAAS;AAC7B,+BAAuB;AAAA,MACzB;AACA,mBAAa,GAAG,IAAI,MAAM,IAAI;AAAA,IAChC,OAAO;AACL,iCAA2B;AAC3B,UAAI,iBAAiB,OAAW,cAAa,GAAG,IAAI;AAAA,IACtD;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,gBAAgB;AAAA,IACvB,OAAO,WAAW,SAAS,QAAQ;AAAA,MACjC,kBAAkB,OAAO;AAAA,MAAG;AAAA,MAAS;AAAA,MAAO;AAAA,IAC9C;AAAA,EACF;AACF;AAaO,SAAS,2BACd,OACA,SACA,OACA,OAAgC,eACiD;AACjF,MAAI,QAAQ;AACZ,MAAI,SAAS,KAAK,GAAG;AACnB,gCAA4B;AAC5B,YAAQ,MAAM,IAAI;AAAA,EACpB,WAAW,UAAU,QAAW;AAC9B,+BAA2B;AAAA,EAC7B;AACA,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,UAAU,QAAQ,OAAO,UAAU,UAAU;AAC/C,WAAO;AAAA,EACT;AAEA,QAAM,SAAS;AACf,MAAI,OAAO,SAAS,QAAW;AAC7B,UAAM,WAAW,uBAAuB,QAAQ,SAAS,KAAK;AAC9D,WAAO,SAAS,UAAU,mBAAmB,QAAQ,IAAI;AAAA,EAC3D;AACA,MAAI;AACJ,aAAW,OAAO,QAAQ;AACxB,QAAI,QAAQ,SAAU;AACtB,UAAM,QAAQ,OAAO,GAAG;AACxB,QAAI,SAAS,KAAK,GAAG;AACnB,kCAA4B;AAC5B,UAAI,aAAa,QAAW;AAC1B,mBAAW,EAAE,GAAG,OAAO;AACvB,+BAAuB;AAAA,MACzB;AACA,eAAS,GAAG,IAAI,MAAM,IAAI;AAAA,IAC5B,OAAO;AACL,iCAA2B;AAAA,IAC7B;AAAA,EACF;AACA,SAAO,YAAY;AACrB;",
+  "sourcesContent": ["import { resolveResponsiveStyle, preparedStyleValue, type ResponsiveStylePreparation, type QueryBasis } from '../style/responsive.js';\nimport {\n  getPrimitiveProgramProps,\n  getOpaquePrimitiveProps,\n  getSpecifiedStyle,\n  type PrimitiveDefinition,\n} from './metadata.js';\nimport type { PibblElement } from './types.js';\nimport {\n  isSignal,\n  recordPlainInputResolution,\n  recordShallowInputCopy,\n  recordSignalInputResolution,\n  withSignalDependencyRole,\n} from '../signals/graph.js';\n\nexport interface ResolvedPrimitiveInputs {\n  readonly props: Readonly<Record<PropertyKey, unknown>>;\n  readonly style: Readonly<Record<PropertyKey, unknown>> | undefined;\n}\n\nexport function resolvePrimitiveInputs(\n  element: PibblElement<any>,\n  definition: PrimitiveDefinition,\n  prepared?: { style: Readonly<Record<PropertyKey, unknown>> },\n  basis?: QueryBasis,\n): ResolvedPrimitiveInputs {\n  const rawProps = getPrimitiveProgramProps(element) as Readonly<\n    Record<PropertyKey, unknown>\n  >;\n  const preserve = definition.preserveSignalProps as\n    readonly PropertyKey[] | undefined;\n  let programProps: Record<PropertyKey, unknown> | undefined;\n\n  for (const key in rawProps) {\n    const value = rawProps[key];\n    if (key === 'children' || preserve?.includes(key) || getOpaquePrimitiveProps(element.type)?.includes(key)) {\n      if (programProps !== undefined) programProps[key] = value;\n      continue;\n    }\n    if (isSignal(value)) {\n      recordSignalInputResolution();\n      if (programProps === undefined) {\n        programProps = { ...rawProps };\n        recordShallowInputCopy();\n      }\n      programProps[key] = key === 'pointerEvents' || key === 'keyboardFocusable' || key === 'keyboardNavigationBounds'\n        ? withSignalDependencyRole('interaction', () => value.get()) : value.get();\n    } else {\n      recordPlainInputResolution();\n      if (programProps !== undefined) programProps[key] = value;\n    }\n  }\n\n  return {\n    props: programProps ?? rawProps,\n    style: prepared ? prepared.style : resolvePrimitiveStyleInput(\n      getSpecifiedStyle(element), element, basis, 'value',\n    ),\n  };\n}\n\nexport function resolvePrimitiveStyleInput(\n  input: unknown,\n  element: PibblElement<any> | undefined,\n  basis: QueryBasis | undefined,\n  mode: 'value',\n): Readonly<Record<PropertyKey, unknown>> | undefined;\nexport function resolvePrimitiveStyleInput(\n  input: unknown,\n  element?: PibblElement<any>,\n  basis?: QueryBasis,\n): Readonly<Record<PropertyKey, unknown>> | ResponsiveStylePreparation | undefined;\nexport function resolvePrimitiveStyleInput(\n  input: unknown,\n  element?: PibblElement<any>,\n  basis?: QueryBasis,\n  mode: 'value' | 'preparation' = 'preparation',\n): Readonly<Record<PropertyKey, unknown>> | ResponsiveStylePreparation | undefined {\n  let style = input;\n  if (isSignal(style)) {\n    recordSignalInputResolution();\n    style = style.get();\n  } else if (style !== undefined) {\n    recordPlainInputResolution();\n  }\n  if (style === undefined) return undefined;\n  if (style === null || typeof style !== 'object') {\n    return style as Readonly<Record<PropertyKey, unknown>>;\n  }\n\n  const source = style as Readonly<Record<PropertyKey, unknown>>;\n  if (source.when !== undefined) {\n    const prepared = resolveResponsiveStyle(source, element, basis);\n    return mode === 'value' ? preparedStyleValue(prepared) : prepared;\n  }\n  let resolved: Record<PropertyKey, unknown> | undefined;\n  for (const key in source) {\n    if (key === 'custom') continue;\n    const value = source[key];\n    if (isSignal(value)) {\n      recordSignalInputResolution();\n      if (resolved === undefined) {\n        resolved = { ...source };\n        recordShallowInputCopy();\n      }\n      resolved[key] = withSignalDependencyRole(\n        styleInputRole(key),\n        () => value.get(),\n      );\n    } else {\n      recordPlainInputResolution();\n    }\n  }\n  return resolved ?? source;\n}\n\n/** @internal Shared receiver input roles for numeric allocation comparisons. */\nexport function styleInputRole(\n  key: string,\n): 'layout' | 'measurement' | 'paint' | 'interaction' | 'transform' | 'unknown' {\n  if (key === 'fill' || key === 'stroke' || key === 'strokeWidth' || key === 'opacity' || key === 'filter') return 'paint';\n  if (key === 'translateX' || key === 'translateY' || key === 'scaleX' || key === 'scaleY' || key === 'rotationDegrees' || key === 'rotationOrigin' || key === 'skewX' || key === 'skewY') return 'transform';\n  if (key === 'cursor' || key === 'pointerEvents' || key === 'lineInteractionWidth') return 'interaction';\n  if (key === 'font' || key === 'textBaseline' || key === 'textAlign' || key === 'lineHeight' || key === 'wrap' || key === 'fit') return 'measurement';\n  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';\n  return 'unknown';\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/events/event-facade.d.ts

@@ -12,7 +12,25 @@ export interface CreatePibblEventInput<K extends PibblEventType> {
     readonly x?: number;
     /** Root-logical coordinate supplied by the family adapter. */
     readonly y?: number;
+    /** HtmlBox border-local coordinates, fixed across the logical path. */
+    readonly localX?: number;
+    readonly localY?: number;
+    /** Native host paths preserve the original DOM bubbling flag. */
+    readonly nativeBubbles?: boolean;
 }
+/** Private opt-in dispatch ownership; ordinary events allocate no resource map.
+ * @param event - The currently dispatched logical event.
+ * @param key - Identity of this optional integration resource.
+ * @param create - Lazy initializer with an exact dispatch-end disposer.
+ * @returns Shared resource for this logical dispatch.
+ * @see {@link PibblEvent}
+ */
+export declare function borrowDispatchResource<T>(event: PibblEvent, key: object, create: () => {
+    value: T;
+    dispose: () => void;
+}): T;
+/** Releases optional synchronous resources even when a handler fails. */
+export declare function finishEventDispatch(event: PibblEvent): void;
 export declare function createPibblEvent<K extends PibblEventType>(input: CreatePibblEventInput<K>): PibblEventMap[K];
 export declare function setPibblEventInvocation(event: PibblEvent, currentTarget: PibblEventTarget, eventPhase: PibblEventPhase): void;
 export declare function isPibblPropagationStopped(event: PibblEvent): boolean;

package/dist/lib/events/event-facade.js

@@ -2,6 +2,27 @@ import {
   getPibblEventDefinition
 } from "./event-definitions.js";
 const states = /* @__PURE__ */ new WeakMap();
+function borrowDispatchResource(event, key, create) {
+  const state = requiredState(event);
+  if (state.dispatchFinished) throw new Error("Inspection dispatch has expired.");
+  const resources = state.resources ??= /* @__PURE__ */ new Map();
+  let resource = resources.get(key);
+  if (!resource) {
+    resource = create();
+    resources.set(key, resource);
+  }
+  return resource.value;
+}
+function finishEventDispatch(event) {
+  const state = requiredState(event);
+  state.dispatchFinished = true;
+  const resources = state.resources;
+  if (resources) {
+    for (const resource of resources.values()) resource.dispose();
+    resources.clear();
+    state.resources = void 0;
+  }
+}
 function createPibblEvent(input) {
   const definition = requiredDefinition(input.type);
   const originalEvent = input.originalEvent;
@@ -20,7 +41,7 @@ function createPibblEvent(input) {
     type: input.type,
     target: input.target.publicTarget,
     relatedTarget: input.relatedTarget?.publicTarget ?? null,
-    bubbles: definition.bubbles,
+    bubbles: input.nativeBubbles ?? definition.bubbles,
     cancelable,
     timeStamp: originalEvent.timeStamp,
     originalEvent,
@@ -32,7 +53,7 @@ function createPibblEvent(input) {
       return state.eventPhase;
     },
     get defaultPrevented() {
-      return state.defaultPrevented;
+      return state.defaultPrevented || originalEvent.defaultPrevented;
     },
     composedPath() {
       return publicPath;
@@ -81,6 +102,9 @@ function projectFamilyFields(facade, definition, input) {
   const original = input.originalEvent;
   if (definition.coordinate) {
     Object.assign(facade, { x: input.x ?? 0, y: input.y ?? 0 });
+    if (input.localX !== void 0 && input.localY !== void 0) {
+      Object.assign(facade, { localX: input.localX, localY: input.localY });
+    }
   }
   switch (definition.family) {
     case "pointer":
@@ -180,7 +204,9 @@ function pick(value, keys) {
   return result;
 }
 export {
+  borrowDispatchResource,
   createPibblEvent,
+  finishEventDispatch,
   isPibblImmediatePropagationStopped,
   isPibblPropagationStopped,
   setPibblEventInvocation

package/dist/lib/events/event-facade.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/events/event-facade.ts"],
-  "sourcesContent": ["import {\n  getPibblEventDefinition,\n  type PibblEventDefinition,\n} from './event-definitions.js';\nimport type { PibblEventNode } from './registrations.js';\nimport type {\n  PibblEvent,\n  PibblEventMap,\n  PibblEventPhase,\n  PibblEventTarget,\n  PibblEventType,\n} from './types.js';\n\nexport type PibblOriginalEvent<K extends PibblEventType> =\n  PibblEventMap[K] extends PibblEvent<infer TOriginal> ? TOriginal : Event;\n\nexport interface CreatePibblEventInput<K extends PibblEventType> {\n  readonly type: K;\n  readonly target: PibblEventNode;\n  readonly path: readonly PibblEventNode[];\n  readonly relatedTarget?: PibblEventNode | null;\n  readonly originalEvent: PibblOriginalEvent<K>;\n  readonly sourceEvent?: Event;\n  /** Root-logical coordinate supplied by the family adapter. */\n  readonly x?: number;\n  /** Root-logical coordinate supplied by the family adapter. */\n  readonly y?: number;\n}\n\ninterface PibblEventFacadeState {\n  currentTarget: PibblEventTarget;\n  eventPhase: PibblEventPhase;\n  defaultPrevented: boolean;\n  propagationStopped: boolean;\n  immediatePropagationStopped: boolean;\n}\n\nconst states = new WeakMap<object, PibblEventFacadeState>();\n\nexport function createPibblEvent<K extends PibblEventType>(\n  input: CreatePibblEventInput<K>,\n): PibblEventMap[K] {\n  const definition = requiredDefinition(input.type);\n  const originalEvent = input.originalEvent;\n  const cancelable = definition.cancelable && originalEvent.cancelable;\n  const publicPath = Object.freeze(\n    input.path.map(node => node.publicTarget),\n  );\n  const state: PibblEventFacadeState = {\n    currentTarget: input.target.publicTarget,\n    eventPhase: 2,\n    defaultPrevented: cancelable && originalEvent.defaultPrevented,\n    propagationStopped: false,\n    immediatePropagationStopped: false,\n  };\n  const facade = {\n    type: input.type,\n    target: input.target.publicTarget,\n    relatedTarget: input.relatedTarget?.publicTarget ?? null,\n    bubbles: definition.bubbles,\n    cancelable,\n    timeStamp: originalEvent.timeStamp,\n    originalEvent,\n    sourceEvent: input.sourceEvent,\n    get currentTarget() {\n      return state.currentTarget;\n    },\n    get eventPhase() {\n      return state.eventPhase;\n    },\n    get defaultPrevented() {\n      return state.defaultPrevented;\n    },\n    composedPath() {\n      return publicPath;\n    },\n    preventDefault() {\n      if (!cancelable) return;\n      state.defaultPrevented = true;\n      originalEvent.preventDefault();\n    },\n    stopPropagation() {\n      state.propagationStopped = true;\n      originalEvent.stopPropagation();\n    },\n    stopImmediatePropagation() {\n      state.propagationStopped = true;\n      state.immediatePropagationStopped = true;\n      originalEvent.stopImmediatePropagation();\n    },\n  } as PibblEvent & Record<string, unknown>;\n  states.set(facade, state);\n  projectFamilyFields(facade, definition, input);\n  return facade as unknown as PibblEventMap[K];\n}\n\nexport function setPibblEventInvocation(\n  event: PibblEvent,\n  currentTarget: PibblEventTarget,\n  eventPhase: PibblEventPhase,\n): void {\n  const state = requiredState(event);\n  state.currentTarget = currentTarget;\n  state.eventPhase = eventPhase;\n}\n\nexport function isPibblPropagationStopped(event: PibblEvent): boolean {\n  return requiredState(event).propagationStopped;\n}\n\nexport function isPibblImmediatePropagationStopped(event: PibblEvent): boolean {\n  return requiredState(event).immediatePropagationStopped;\n}\n\nfunction requiredState(event: PibblEvent): PibblEventFacadeState {\n  const state = states.get(event);\n  if (!state) throw new Error('Pibbl event facade state is unavailable.');\n  return state;\n}\n\nfunction requiredDefinition(type: PibblEventType): PibblEventDefinition {\n  const definition = getPibblEventDefinition(type);\n  if (!definition) throw new Error(`Unsupported Pibbl event type: ${type}`);\n  return definition;\n}\n\nfunction projectFamilyFields<K extends PibblEventType>(\n  facade: PibblEvent & Record<string, unknown>,\n  definition: PibblEventDefinition,\n  input: CreatePibblEventInput<K>,\n): void {\n  const original: unknown = input.originalEvent;\n  if (definition.coordinate) {\n    Object.assign(facade, { x: input.x ?? 0, y: input.y ?? 0 });\n  }\n\n  switch (definition.family) {\n    case 'pointer':\n      projectMouseFields(facade, original as PointerEvent);\n      Object.assign(facade, pick(original as PointerEvent, [\n        'pointerId',\n        'width',\n        'height',\n        'pressure',\n        'tangentialPressure',\n        'tiltX',\n        'tiltY',\n        'twist',\n        'pointerType',\n        'isPrimary',\n      ]));\n      break;\n    case 'mouse':\n      projectMouseFields(facade, original as MouseEvent);\n      break;\n    case 'touch':\n      projectModifierFields(facade, original as TouchEvent);\n      Object.assign(facade, pick(original as TouchEvent, [\n        'touches',\n        'targetTouches',\n        'changedTouches',\n      ]));\n      break;\n    case 'wheel':\n      projectMouseFields(facade, original as WheelEvent);\n      Object.assign(facade, pick(original as WheelEvent, [\n        'deltaX',\n        'deltaY',\n        'deltaZ',\n        'deltaMode',\n      ]));\n      break;\n    case 'keyboard':\n      projectModifierFields(facade, original as KeyboardEvent);\n      Object.assign(facade, pick(original as KeyboardEvent, [\n        'key',\n        'code',\n        'location',\n        'repeat',\n        'isComposing',\n      ]));\n      break;\n    case 'input':\n      if (definition.type === 'beforeinput' || definition.type === 'input') {\n        Object.assign(facade, pick(original as InputEvent, [\n          'data',\n          'dataTransfer',\n          'inputType',\n          'isComposing',\n        ]));\n      }\n      break;\n    case 'composition':\n      Object.assign(facade, pick(original as CompositionEvent, ['data']));\n      break;\n    case 'clipboard':\n      Object.assign(facade, pick(original as ClipboardEvent, ['clipboardData']));\n      break;\n    case 'drag':\n      projectMouseFields(facade, original as DragEvent);\n      Object.assign(facade, pick(original as DragEvent, ['dataTransfer']));\n      break;\n    case 'focus':\n      break;\n  }\n}\n\nfunction projectMouseFields(\n  facade: PibblEvent & Record<string, unknown>,\n  original: MouseEvent,\n): void {\n  projectModifierFields(facade, original);\n  Object.assign(facade, pick(original, [\n    'clientX',\n    'clientY',\n    'screenX',\n    'screenY',\n    'movementX',\n    'movementY',\n    'button',\n    'buttons',\n    'detail',\n  ]));\n}\n\nfunction projectModifierFields(\n  facade: PibblEvent & Record<string, unknown>,\n  original: MouseEvent | TouchEvent | KeyboardEvent,\n): void {\n  Object.assign(facade, pick(original, [\n    'altKey',\n    'ctrlKey',\n    'metaKey',\n    'shiftKey',\n  ]));\n}\n\nfunction pick<T extends object, K extends keyof T>(\n  value: T,\n  keys: readonly K[],\n): Pick<T, K> {\n  const result = {} as Pick<T, K>;\n  for (const key of keys) result[key] = value[key];\n  return result;\n}\n"],
-  "mappings": "AAAA;AAAA,EACE;AAAA,OAEK;AAkCP,MAAM,SAAS,oBAAI,QAAuC;AAEnD,SAAS,iBACd,OACkB;AAClB,QAAM,aAAa,mBAAmB,MAAM,IAAI;AAChD,QAAM,gBAAgB,MAAM;AAC5B,QAAM,aAAa,WAAW,cAAc,cAAc;AAC1D,QAAM,aAAa,OAAO;AAAA,IACxB,MAAM,KAAK,IAAI,UAAQ,KAAK,YAAY;AAAA,EAC1C;AACA,QAAM,QAA+B;AAAA,IACnC,eAAe,MAAM,OAAO;AAAA,IAC5B,YAAY;AAAA,IACZ,kBAAkB,cAAc,cAAc;AAAA,IAC9C,oBAAoB;AAAA,IACpB,6BAA6B;AAAA,EAC/B;AACA,QAAM,SAAS;AAAA,IACb,MAAM,MAAM;AAAA,IACZ,QAAQ,MAAM,OAAO;AAAA,IACrB,eAAe,MAAM,eAAe,gBAAgB;AAAA,IACpD,SAAS,WAAW;AAAA,IACpB;AAAA,IACA,WAAW,cAAc;AAAA,IACzB;AAAA,IACA,aAAa,MAAM;AAAA,IACnB,IAAI,gBAAgB;AAClB,aAAO,MAAM;AAAA,IACf;AAAA,IACA,IAAI,aAAa;AACf,aAAO,MAAM;AAAA,IACf;AAAA,IACA,IAAI,mBAAmB;AACrB,aAAO,MAAM;AAAA,IACf;AAAA,IACA,eAAe;AACb,aAAO;AAAA,IACT;AAAA,IACA,iBAAiB;AACf,UAAI,CAAC,WAAY;AACjB,YAAM,mBAAmB;AACzB,oBAAc,eAAe;AAAA,IAC/B;AAAA,IACA,kBAAkB;AAChB,YAAM,qBAAqB;AAC3B,oBAAc,gBAAgB;AAAA,IAChC;AAAA,IACA,2BAA2B;AACzB,YAAM,qBAAqB;AAC3B,YAAM,8BAA8B;AACpC,oBAAc,yBAAyB;AAAA,IACzC;AAAA,EACF;AACA,SAAO,IAAI,QAAQ,KAAK;AACxB,sBAAoB,QAAQ,YAAY,KAAK;AAC7C,SAAO;AACT;AAEO,SAAS,wBACd,OACA,eACA,YACM;AACN,QAAM,QAAQ,cAAc,KAAK;AACjC,QAAM,gBAAgB;AACtB,QAAM,aAAa;AACrB;AAEO,SAAS,0BAA0B,OAA4B;AACpE,SAAO,cAAc,KAAK,EAAE;AAC9B;AAEO,SAAS,mCAAmC,OAA4B;AAC7E,SAAO,cAAc,KAAK,EAAE;AAC9B;AAEA,SAAS,cAAc,OAA0C;AAC/D,QAAM,QAAQ,OAAO,IAAI,KAAK;AAC9B,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,0CAA0C;AACtE,SAAO;AACT;AAEA,SAAS,mBAAmB,MAA4C;AACtE,QAAM,aAAa,wBAAwB,IAAI;AAC/C,MAAI,CAAC,WAAY,OAAM,IAAI,MAAM,iCAAiC,IAAI,EAAE;AACxE,SAAO;AACT;AAEA,SAAS,oBACP,QACA,YACA,OACM;AACN,QAAM,WAAoB,MAAM;AAChC,MAAI,WAAW,YAAY;AACzB,WAAO,OAAO,QAAQ,EAAE,GAAG,MAAM,KAAK,GAAG,GAAG,MAAM,KAAK,EAAE,CAAC;AAAA,EAC5D;AAEA,UAAQ,WAAW,QAAQ;AAAA,IACzB,KAAK;AACH,yBAAmB,QAAQ,QAAwB;AACnD,aAAO,OAAO,QAAQ,KAAK,UAA0B;AAAA,QACnD;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC,CAAC;AACF;AAAA,IACF,KAAK;AACH,yBAAmB,QAAQ,QAAsB;AACjD;AAAA,IACF,KAAK;AACH,4BAAsB,QAAQ,QAAsB;AACpD,aAAO,OAAO,QAAQ,KAAK,UAAwB;AAAA,QACjD;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC,CAAC;AACF;AAAA,IACF,KAAK;AACH,yBAAmB,QAAQ,QAAsB;AACjD,aAAO,OAAO,QAAQ,KAAK,UAAwB;AAAA,QACjD;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC,CAAC;AACF;AAAA,IACF,KAAK;AACH,4BAAsB,QAAQ,QAAyB;AACvD,aAAO,OAAO,QAAQ,KAAK,UAA2B;AAAA,QACpD;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC,CAAC;AACF;AAAA,IACF,KAAK;AACH,UAAI,WAAW,SAAS,iBAAiB,WAAW,SAAS,SAAS;AACpE,eAAO,OAAO,QAAQ,KAAK,UAAwB;AAAA,UACjD;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF,CAAC,CAAC;AAAA,MACJ;AACA;AAAA,IACF,KAAK;AACH,aAAO,OAAO,QAAQ,KAAK,UAA8B,CAAC,MAAM,CAAC,CAAC;AAClE;AAAA,IACF,KAAK;AACH,aAAO,OAAO,QAAQ,KAAK,UAA4B,CAAC,eAAe,CAAC,CAAC;AACzE;AAAA,IACF,KAAK;AACH,yBAAmB,QAAQ,QAAqB;AAChD,aAAO,OAAO,QAAQ,KAAK,UAAuB,CAAC,cAAc,CAAC,CAAC;AACnE;AAAA,IACF,KAAK;AACH;AAAA,EACJ;AACF;AAEA,SAAS,mBACP,QACA,UACM;AACN,wBAAsB,QAAQ,QAAQ;AACtC,SAAO,OAAO,QAAQ,KAAK,UAAU;AAAA,IACnC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC,CAAC;AACJ;AAEA,SAAS,sBACP,QACA,UACM;AACN,SAAO,OAAO,QAAQ,KAAK,UAAU;AAAA,IACnC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC,CAAC;AACJ;AAEA,SAAS,KACP,OACA,MACY;AACZ,QAAM,SAAS,CAAC;AAChB,aAAW,OAAO,KAAM,QAAO,GAAG,IAAI,MAAM,GAAG;AAC/C,SAAO;AACT;",
+  "sourcesContent": ["import {\n  getPibblEventDefinition,\n  type PibblEventDefinition,\n} from './event-definitions.js';\nimport type { PibblEventNode } from './registrations.js';\nimport type {\n  PibblEvent,\n  PibblEventMap,\n  PibblEventPhase,\n  PibblEventTarget,\n  PibblEventType,\n} from './types.js';\n\nexport type PibblOriginalEvent<K extends PibblEventType> =\n  PibblEventMap[K] extends PibblEvent<infer TOriginal> ? TOriginal : Event;\n\nexport interface CreatePibblEventInput<K extends PibblEventType> {\n  readonly type: K;\n  readonly target: PibblEventNode;\n  readonly path: readonly PibblEventNode[];\n  readonly relatedTarget?: PibblEventNode | null;\n  readonly originalEvent: PibblOriginalEvent<K>;\n  readonly sourceEvent?: Event;\n  /** Root-logical coordinate supplied by the family adapter. */\n  readonly x?: number;\n  /** Root-logical coordinate supplied by the family adapter. */\n  readonly y?: number;\n  /** HtmlBox border-local coordinates, fixed across the logical path. */\n  readonly localX?: number;\n  readonly localY?: number;\n  /** Native host paths preserve the original DOM bubbling flag. */\n  readonly nativeBubbles?: boolean;\n}\n\ninterface PibblEventFacadeState {\n  dispatchFinished?: boolean;\n  resources?: Map<object, { value: unknown; dispose: () => void }>;\n  currentTarget: PibblEventTarget;\n  eventPhase: PibblEventPhase;\n  defaultPrevented: boolean;\n  propagationStopped: boolean;\n  immediatePropagationStopped: boolean;\n}\n\nconst states = new WeakMap<object, PibblEventFacadeState>();\n\n/** Private opt-in dispatch ownership; ordinary events allocate no resource map.\n * @param event - The currently dispatched logical event.\n * @param key - Identity of this optional integration resource.\n * @param create - Lazy initializer with an exact dispatch-end disposer.\n * @returns Shared resource for this logical dispatch.\n * @see {@link PibblEvent}\n */\nexport function borrowDispatchResource<T>(event: PibblEvent, key: object, create: () => {value:T;dispose:()=>void}): T {\n  const state = requiredState(event);\n  if (state.dispatchFinished) throw new Error('Inspection dispatch has expired.');\n  const resources = state.resources ??= new Map();\n  let resource = resources.get(key);\n  if (!resource) { resource = create(); resources.set(key,resource); }\n  return resource.value as T;\n}\n\n/** Releases optional synchronous resources even when a handler fails. */\nexport function finishEventDispatch(event: PibblEvent): void {\n  const state = requiredState(event);\n  state.dispatchFinished = true;\n  const resources = state.resources;\n  if (resources) {\n    for (const resource of resources.values()) resource.dispose();\n    resources.clear();\n    state.resources = undefined;\n  }\n}\n\nexport function createPibblEvent<K extends PibblEventType>(\n  input: CreatePibblEventInput<K>,\n): PibblEventMap[K] {\n  const definition = requiredDefinition(input.type);\n  const originalEvent = input.originalEvent;\n  const cancelable = definition.cancelable && originalEvent.cancelable;\n  const publicPath = Object.freeze(\n    input.path.map(node => node.publicTarget),\n  );\n  const state: PibblEventFacadeState = {\n    currentTarget: input.target.publicTarget,\n    eventPhase: 2,\n    defaultPrevented: cancelable && originalEvent.defaultPrevented,\n    propagationStopped: false,\n    immediatePropagationStopped: false,\n  };\n  const facade = {\n    type: input.type,\n    target: input.target.publicTarget,\n    relatedTarget: input.relatedTarget?.publicTarget ?? null,\n    bubbles: input.nativeBubbles ?? definition.bubbles,\n    cancelable,\n    timeStamp: originalEvent.timeStamp,\n    originalEvent,\n    sourceEvent: input.sourceEvent,\n    get currentTarget() {\n      return state.currentTarget;\n    },\n    get eventPhase() {\n      return state.eventPhase;\n    },\n    get defaultPrevented() {\n      return state.defaultPrevented || originalEvent.defaultPrevented;\n    },\n    composedPath() {\n      return publicPath;\n    },\n    preventDefault() {\n      if (!cancelable) return;\n      state.defaultPrevented = true;\n      originalEvent.preventDefault();\n    },\n    stopPropagation() {\n      state.propagationStopped = true;\n      originalEvent.stopPropagation();\n    },\n    stopImmediatePropagation() {\n      state.propagationStopped = true;\n      state.immediatePropagationStopped = true;\n      originalEvent.stopImmediatePropagation();\n    },\n  } as PibblEvent & Record<string, unknown>;\n  states.set(facade, state);\n  projectFamilyFields(facade, definition, input);\n  return facade as unknown as PibblEventMap[K];\n}\n\nexport function setPibblEventInvocation(\n  event: PibblEvent,\n  currentTarget: PibblEventTarget,\n  eventPhase: PibblEventPhase,\n): void {\n  const state = requiredState(event);\n  state.currentTarget = currentTarget;\n  state.eventPhase = eventPhase;\n}\n\nexport function isPibblPropagationStopped(event: PibblEvent): boolean {\n  return requiredState(event).propagationStopped;\n}\n\nexport function isPibblImmediatePropagationStopped(event: PibblEvent): boolean {\n  return requiredState(event).immediatePropagationStopped;\n}\n\nfunction requiredState(event: PibblEvent): PibblEventFacadeState {\n  const state = states.get(event);\n  if (!state) throw new Error('Pibbl event facade state is unavailable.');\n  return state;\n}\n\nfunction requiredDefinition(type: PibblEventType): PibblEventDefinition {\n  const definition = getPibblEventDefinition(type);\n  if (!definition) throw new Error(`Unsupported Pibbl event type: ${type}`);\n  return definition;\n}\n\nfunction projectFamilyFields<K extends PibblEventType>(\n  facade: PibblEvent & Record<string, unknown>,\n  definition: PibblEventDefinition,\n  input: CreatePibblEventInput<K>,\n): void {\n  const original: unknown = input.originalEvent;\n  if (definition.coordinate) {\n    Object.assign(facade, { x: input.x ?? 0, y: input.y ?? 0 });\n    if (input.localX !== undefined && input.localY !== undefined) {\n      Object.assign(facade, { localX: input.localX, localY: input.localY });\n    }\n  }\n\n  switch (definition.family) {\n    case 'pointer':\n      projectMouseFields(facade, original as PointerEvent);\n      Object.assign(facade, pick(original as PointerEvent, [\n        'pointerId',\n        'width',\n        'height',\n        'pressure',\n        'tangentialPressure',\n        'tiltX',\n        'tiltY',\n        'twist',\n        'pointerType',\n        'isPrimary',\n      ]));\n      break;\n    case 'mouse':\n      projectMouseFields(facade, original as MouseEvent);\n      break;\n    case 'touch':\n      projectModifierFields(facade, original as TouchEvent);\n      Object.assign(facade, pick(original as TouchEvent, [\n        'touches',\n        'targetTouches',\n        'changedTouches',\n      ]));\n      break;\n    case 'wheel':\n      projectMouseFields(facade, original as WheelEvent);\n      Object.assign(facade, pick(original as WheelEvent, [\n        'deltaX',\n        'deltaY',\n        'deltaZ',\n        'deltaMode',\n      ]));\n      break;\n    case 'keyboard':\n      projectModifierFields(facade, original as KeyboardEvent);\n      Object.assign(facade, pick(original as KeyboardEvent, [\n        'key',\n        'code',\n        'location',\n        'repeat',\n        'isComposing',\n      ]));\n      break;\n    case 'input':\n      if (definition.type === 'beforeinput' || definition.type === 'input') {\n        Object.assign(facade, pick(original as InputEvent, [\n          'data',\n          'dataTransfer',\n          'inputType',\n          'isComposing',\n        ]));\n      }\n      break;\n    case 'composition':\n      Object.assign(facade, pick(original as CompositionEvent, ['data']));\n      break;\n    case 'clipboard':\n      Object.assign(facade, pick(original as ClipboardEvent, ['clipboardData']));\n      break;\n    case 'drag':\n      projectMouseFields(facade, original as DragEvent);\n      Object.assign(facade, pick(original as DragEvent, ['dataTransfer']));\n      break;\n    case 'focus':\n      break;\n  }\n}\n\nfunction projectMouseFields(\n  facade: PibblEvent & Record<string, unknown>,\n  original: MouseEvent,\n): void {\n  projectModifierFields(facade, original);\n  Object.assign(facade, pick(original, [\n    'clientX',\n    'clientY',\n    'screenX',\n    'screenY',\n    'movementX',\n    'movementY',\n    'button',\n    'buttons',\n    'detail',\n  ]));\n}\n\nfunction projectModifierFields(\n  facade: PibblEvent & Record<string, unknown>,\n  original: MouseEvent | TouchEvent | KeyboardEvent,\n): void {\n  Object.assign(facade, pick(original, [\n    'altKey',\n    'ctrlKey',\n    'metaKey',\n    'shiftKey',\n  ]));\n}\n\nfunction pick<T extends object, K extends keyof T>(\n  value: T,\n  keys: readonly K[],\n): Pick<T, K> {\n  const result = {} as Pick<T, K>;\n  for (const key of keys) result[key] = value[key];\n  return result;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/events/hit-test.js

@@ -1,3 +1,4 @@
+import { committedLayoutPaintEntries } from "../layout/geometry-publication.js";
 import { isHit } from "../util/is-hit.js";
 import {
   PibblHitDisposition,
@@ -37,7 +38,7 @@ function resolveCoordinateOutput(eventRoot, point) {
   return output;
 }
 function resolveInstanceHit(eventRoot, instance, canvas, rootX, rootY, transform, output) {
-  const entries = Array.from(instance.paintEntries);
+  const entries = committedLayoutPaintEntries(instance) ?? Array.from(instance.paintEntries);
   for (let index = entries.length - 1; index >= 0; index--) {
     const entry = entries[index];
     reset(output);

package/dist/lib/events/hit-test.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/events/hit-test.ts"],
-  "sourcesContent": ["import type { PibblClippingStackEntry, PibblEventRoot, PibblInstance } from '../types.js';\nimport { isHit } from '../util/is-hit.js';\nimport {\n  PibblHitDisposition,\n  PibblPaintEntryKind,\n  hitTestScratchFactory,\n  type PibblHitTestInput,\n  type PibblHitTestOutput,\n  type PibblPathPaintEntry,\n} from './paint-entry.js';\nimport type { PibblEventTargetRegistration } from './registrations.js';\n\nexport interface PibblCoordinatePoint {\n  readonly x: number;\n  readonly y: number;\n}\n\n/** Resolves one paint entry in reverse global paint order without allocating. */\nexport function resolveCoordinateHit(\n  eventRoot: PibblEventRoot,\n  input: PibblHitTestInput,\n  output: PibblHitTestOutput,\n): PibblHitTestOutput {\n  const instance = eventRoot.rootInstance;\n  const canvas = eventRoot.canvas;\n  reset(output);\n  if (!instance || !canvas || !instance.surface.snapshot) return output;\n  return resolveInstanceHit(\n    eventRoot,\n    instance,\n    canvas,\n    input.rootX,\n    input.rootY,\n    new DOMMatrix(),\n    output,\n  );\n}\n\n/** Compatibility wrapper for coordinate event dispatch. */\nexport function resolveCoordinateTarget(\n  eventRoot: PibblEventRoot,\n  point: PibblCoordinatePoint,\n): PibblEventTargetRegistration | undefined {\n  const output = resolveCoordinateOutput(eventRoot, point);\n  return output.disposition === PibblHitDisposition.Target ?\n    output.target ?? undefined :\n    undefined;\n}\n\n/** Borrows the root scratch result for immediate coordinate dispatch. */\nexport function resolveCoordinateOutput(\n  eventRoot: PibblEventRoot,\n  point: PibblCoordinatePoint,\n): PibblHitTestOutput {\n  let input = eventRoot.coordinateHitInput;\n  let output = eventRoot.coordinateHitOutput;\n  if (!input || !output) {\n    const scratch = hitTestScratchFactory.create();\n    input = eventRoot.coordinateHitInput = scratch.input;\n    output = eventRoot.coordinateHitOutput = scratch.output;\n  }\n  input.rootX = point.x;\n  input.rootY = point.y;\n  resolveCoordinateHit(eventRoot, input, output);\n  return output;\n}\n\nfunction resolveInstanceHit(\n  eventRoot: PibblEventRoot,\n  instance: PibblInstance,\n  canvas: HTMLCanvasElement,\n  rootX: number,\n  rootY: number,\n  transform: DOMMatrix,\n  output: PibblHitTestOutput,\n): PibblHitTestOutput {\n  const entries = Array.from(instance.paintEntries);\n  for (let index = entries.length - 1; index >= 0; index--) {\n    const entry = entries[index]!;\n    reset(output);\n    switch (entry.paintKind) {\n      case PibblPaintEntryKind.Path:\n        resolvePathHit(eventRoot, canvas, entry, rootX, rootY, transform, output);\n        break;\n      case PibblPaintEntryKind.NestedInstance:\n      case PibblPaintEntryKind.Resolver: {\n        if (entry.instance.mainTeardowns.closed) continue;\n        const childTransform = multiplyTransforms(transform, entry.transform);\n        const boundaryClippingStack = composeClippingStack(\n          entry.clippingStack,\n          transform,\n        );\n        if (!isHit({\n          canvas,\n          path: entry.bounds,\n          transform: childTransform,\n          x: rootX,\n          y: rootY,\n          fill: true,\n          lineInteractionWidth: 0,\n          currentClippingStack: boundaryClippingStack,\n        })) break;\n        try {\n          if (entry.paintKind === PibblPaintEntryKind.NestedInstance) {\n            resolveInstanceHit(\n              eventRoot,\n              entry.instance,\n              canvas,\n              rootX,\n              rootY,\n              childTransform,\n              output,\n            );\n          } else if (entry.resolveLocal) {\n            const local = childTransform.inverse().transformPoint(\n              new DOMPoint(rootX, rootY),\n            );\n            entry.resolveLocal(local.x, local.y, output);\n          }\n        } finally {\n          // Child clipping and local coordinates are stack-local to this call.\n        }\n        break;\n      }\n    }\n    if (output.disposition !== PibblHitDisposition.Miss) return output;\n  }\n  return output;\n}\n\nfunction resolvePathHit(\n  eventRoot: PibblEventRoot,\n  canvas: HTMLCanvasElement,\n  entry: PibblPathPaintEntry,\n  rootX: number,\n  rootY: number,\n  transform: DOMMatrix,\n  output: PibblHitTestOutput,\n): void {\n  const target = entry.target;\n  if (!isLiveTarget(eventRoot, target)) return;\n  if (isHit({\n    canvas,\n    path: entry.path,\n    transform: multiplyTransforms(transform, entry.transform),\n    x: rootX,\n    y: rootY,\n    fill: entry.fill,\n    lineInteractionWidth: entry.lineInteractionWidth,\n    currentClippingStack: composeClippingStack(entry.clippingStack, transform),\n  })) {\n    output.disposition = PibblHitDisposition.Target;\n    output.target = target;\n  }\n}\n\nfunction reset(output: PibblHitTestOutput): void {\n  output.disposition = PibblHitDisposition.Miss;\n  output.target = null;\n  delete output.winner;\n  delete output.winnerState;\n}\n\nfunction isLiveTarget(\n  eventRoot: PibblEventRoot,\n  target: PibblEventTargetRegistration,\n): boolean {\n  return target.live &&\n    !target.owner.mainTeardowns.closed &&\n    target.owner.eventRoot === eventRoot &&\n    eventRoot.targets.has(target);\n}\n\nfunction composeClippingStack(\n  clippingStack: readonly PibblClippingStackEntry[],\n  transform: DOMMatrix,\n): readonly PibblClippingStackEntry[] {\n  if (clippingStack.length === 0 || transform.isIdentity) return clippingStack;\n  return clippingStack.map(entry => ({\n    ...entry,\n    transform: multiplyTransforms(transform, entry.transform),\n  }));\n}\n\nfunction multiplyTransforms(parent: DOMMatrix, child: DOMMatrix): DOMMatrix {\n  if (parent.isIdentity) return child;\n  if (child.isIdentity) return parent;\n  return parent.multiply(child);\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { committedLayoutPaintEntries } from '../layout/geometry-publication.js';\nimport type { PibblClippingStackEntry, PibblEventRoot, PibblInstance } from '../types.js';\nimport { isHit } from '../util/is-hit.js';\nimport {\n  PibblHitDisposition,\n  PibblPaintEntryKind,\n  hitTestScratchFactory,\n  type PibblHitTestInput,\n  type PibblHitTestOutput,\n  type PibblPathPaintEntry,\n} from './paint-entry.js';\nimport type { PibblEventTargetRegistration } from './registrations.js';\n\nexport interface PibblCoordinatePoint {\n  readonly x: number;\n  readonly y: number;\n}\n\n/** Resolves one paint entry in reverse global paint order without allocating. */\nexport function resolveCoordinateHit(\n  eventRoot: PibblEventRoot,\n  input: PibblHitTestInput,\n  output: PibblHitTestOutput,\n): PibblHitTestOutput {\n  const instance = eventRoot.rootInstance;\n  const canvas = eventRoot.canvas;\n  reset(output);\n  if (!instance || !canvas || !instance.surface.snapshot) return output;\n  return resolveInstanceHit(\n    eventRoot,\n    instance,\n    canvas,\n    input.rootX,\n    input.rootY,\n    new DOMMatrix(),\n    output,\n  );\n}\n\n/** Compatibility wrapper for coordinate event dispatch. */\nexport function resolveCoordinateTarget(\n  eventRoot: PibblEventRoot,\n  point: PibblCoordinatePoint,\n): PibblEventTargetRegistration | undefined {\n  const output = resolveCoordinateOutput(eventRoot, point);\n  return output.disposition === PibblHitDisposition.Target ?\n    output.target ?? undefined :\n    undefined;\n}\n\n/** Borrows the root scratch result for immediate coordinate dispatch. */\nexport function resolveCoordinateOutput(\n  eventRoot: PibblEventRoot,\n  point: PibblCoordinatePoint,\n): PibblHitTestOutput {\n  let input = eventRoot.coordinateHitInput;\n  let output = eventRoot.coordinateHitOutput;\n  if (!input || !output) {\n    const scratch = hitTestScratchFactory.create();\n    input = eventRoot.coordinateHitInput = scratch.input;\n    output = eventRoot.coordinateHitOutput = scratch.output;\n  }\n  input.rootX = point.x;\n  input.rootY = point.y;\n  resolveCoordinateHit(eventRoot, input, output);\n  return output;\n}\n\nfunction resolveInstanceHit(\n  eventRoot: PibblEventRoot,\n  instance: PibblInstance,\n  canvas: HTMLCanvasElement,\n  rootX: number,\n  rootY: number,\n  transform: DOMMatrix,\n  output: PibblHitTestOutput,\n): PibblHitTestOutput {\n  const entries = committedLayoutPaintEntries(instance) ?? Array.from(instance.paintEntries);\n  for (let index = entries.length - 1; index >= 0; index--) {\n    const entry = entries[index]!;\n    reset(output);\n    switch (entry.paintKind) {\n      case PibblPaintEntryKind.Path:\n        resolvePathHit(eventRoot, canvas, entry, rootX, rootY, transform, output);\n        break;\n      case PibblPaintEntryKind.NestedInstance:\n      case PibblPaintEntryKind.Resolver: {\n        if (entry.instance.mainTeardowns.closed) continue;\n        const childTransform = multiplyTransforms(transform, entry.transform);\n        const boundaryClippingStack = composeClippingStack(\n          entry.clippingStack,\n          transform,\n        );\n        if (!isHit({\n          canvas,\n          path: entry.bounds,\n          transform: childTransform,\n          x: rootX,\n          y: rootY,\n          fill: true,\n          lineInteractionWidth: 0,\n          currentClippingStack: boundaryClippingStack,\n        })) break;\n        try {\n          if (entry.paintKind === PibblPaintEntryKind.NestedInstance) {\n            resolveInstanceHit(\n              eventRoot,\n              entry.instance,\n              canvas,\n              rootX,\n              rootY,\n              childTransform,\n              output,\n            );\n          } else if (entry.resolveLocal) {\n            const local = childTransform.inverse().transformPoint(\n              new DOMPoint(rootX, rootY),\n            );\n            entry.resolveLocal(local.x, local.y, output);\n          }\n        } finally {\n          // Child clipping and local coordinates are stack-local to this call.\n        }\n        break;\n      }\n    }\n    if (output.disposition !== PibblHitDisposition.Miss) return output;\n  }\n  return output;\n}\n\nfunction resolvePathHit(\n  eventRoot: PibblEventRoot,\n  canvas: HTMLCanvasElement,\n  entry: PibblPathPaintEntry,\n  rootX: number,\n  rootY: number,\n  transform: DOMMatrix,\n  output: PibblHitTestOutput,\n): void {\n  const target = entry.target;\n  if (!isLiveTarget(eventRoot, target)) return;\n  if (isHit({\n    canvas,\n    path: entry.path,\n    transform: multiplyTransforms(transform, entry.transform),\n    x: rootX,\n    y: rootY,\n    fill: entry.fill,\n    lineInteractionWidth: entry.lineInteractionWidth,\n    currentClippingStack: composeClippingStack(entry.clippingStack, transform),\n  })) {\n    output.disposition = PibblHitDisposition.Target;\n    output.target = target;\n  }\n}\n\nfunction reset(output: PibblHitTestOutput): void {\n  output.disposition = PibblHitDisposition.Miss;\n  output.target = null;\n  delete output.winner;\n  delete output.winnerState;\n}\n\nfunction isLiveTarget(\n  eventRoot: PibblEventRoot,\n  target: PibblEventTargetRegistration,\n): boolean {\n  return target.live &&\n    !target.owner.mainTeardowns.closed &&\n    target.owner.eventRoot === eventRoot &&\n    eventRoot.targets.has(target);\n}\n\nfunction composeClippingStack(\n  clippingStack: readonly PibblClippingStackEntry[],\n  transform: DOMMatrix,\n): readonly PibblClippingStackEntry[] {\n  if (clippingStack.length === 0 || transform.isIdentity) return clippingStack;\n  return clippingStack.map(entry => ({\n    ...entry,\n    transform: multiplyTransforms(transform, entry.transform),\n  }));\n}\n\nfunction multiplyTransforms(parent: DOMMatrix, child: DOMMatrix): DOMMatrix {\n  if (parent.isIdentity) return child;\n  if (child.isIdentity) return parent;\n  return parent.multiply(child);\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/events/propagation.d.ts

@@ -1,7 +1,8 @@
 import { type CreatePibblEventInput } from './event-facade.js';
 import type { PibblEventNode } from './registrations.js';
-import type { PibblEventMap, PibblEventType } from './types.js';
+import type { PibblEvent, PibblEventMap, PibblEventPhase, PibblEventType } from './types.js';
 export interface DispatchEventPathInput<K extends PibblEventType> extends Omit<CreatePibblEventInput<K>, 'path'> {
     readonly target: PibblEventNode;
 }
 export declare function dispatchEventPath<K extends PibblEventType>(input: DispatchEventPathInput<K>): PibblEventMap[K];
+export declare function invokePibblEventHandler(node: PibblEventNode, type: PibblEventType, capture: boolean, phase: PibblEventPhase, event: PibblEvent): void;