@pibbl/core 0.0.1 → 0.0.3-alpha.109.1

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

package/dist/lib/events/propagation.js

@@ -1,6 +1,7 @@
 import { getPibblEventDefinition } from "./event-definitions.js";
 import {
   createPibblEvent,
+  finishEventDispatch,
   isPibblImmediatePropagationStopped,
   isPibblPropagationStopped,
   setPibblEventInvocation
@@ -14,25 +15,29 @@ function dispatchEventPath(input) {
   const path = buildEventPath(input.target);
   const event = createPibblEvent({ ...input, path });
   const targetIndex = path.length - 1;
-  for (let index = 0; index < targetIndex; index++) {
-    if (isPibblPropagationStopped(event)) break;
-    invoke(path[index], input.type, true, 1, event);
-  }
-  if (!isPibblPropagationStopped(event) && input.target.live) {
-    invoke(input.target, input.type, true, 2, event);
-    if (!isPibblImmediatePropagationStopped(event)) {
-      invoke(input.target, input.type, false, 2, event);
-    }
-  }
-  if (definition.bubbles && !isPibblPropagationStopped(event)) {
-    for (let index = targetIndex - 1; index >= 0; index--) {
+  try {
+    for (let index = 0; index < targetIndex; index++) {
       if (isPibblPropagationStopped(event)) break;
-      invoke(path[index], input.type, false, 3, event);
+      invokePibblEventHandler(path[index], input.type, true, 1, event);
+    }
+    if (!isPibblPropagationStopped(event) && input.target.live) {
+      invokePibblEventHandler(input.target, input.type, true, 2, event);
+      if (!isPibblImmediatePropagationStopped(event)) {
+        invokePibblEventHandler(input.target, input.type, false, 2, event);
+      }
+    }
+    if (definition.bubbles && !isPibblPropagationStopped(event)) {
+      for (let index = targetIndex - 1; index >= 0; index--) {
+        if (isPibblPropagationStopped(event)) break;
+        invokePibblEventHandler(path[index], input.type, false, 3, event);
+      }
     }
+    return event;
+  } finally {
+    finishEventDispatch(event);
   }
-  return event;
 }
-function invoke(node, type, capture, phase, event) {
+function invokePibblEventHandler(node, type, capture, phase, event) {
   if (!node.live) return;
   const key = capture ? `${type}Capture` : type;
   const handler = node.handlers[key];
@@ -51,6 +56,7 @@ function reportDispatchError(error) {
   }
 }
 export {
-  dispatchEventPath
+  dispatchEventPath,
+  invokePibblEventHandler
 };
 //# sourceMappingURL=propagation.js.map

package/dist/lib/events/propagation.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/events/propagation.ts"],
-  "sourcesContent": ["import { getPibblEventDefinition } from './event-definitions.js';\nimport {\n  createPibblEvent,\n  isPibblImmediatePropagationStopped,\n  isPibblPropagationStopped,\n  setPibblEventInvocation,\n  type CreatePibblEventInput,\n} from './event-facade.js';\nimport { buildEventPath } from './event-path.js';\nimport type {\n  PibblEventNode,\n  PibblNormalizedHandlers,\n} from './registrations.js';\nimport type {\n  PibblEvent,\n  PibblEventMap,\n  PibblEventPhase,\n  PibblEventType,\n} from './types.js';\n\nexport interface DispatchEventPathInput<K extends PibblEventType>\n  extends Omit<CreatePibblEventInput<K>, 'path'> {\n  readonly target: PibblEventNode;\n}\n\ntype PibblNormalizedCaptureKey = `${PibblEventType}Capture`;\n\nexport function dispatchEventPath<K extends PibblEventType>(\n  input: DispatchEventPathInput<K>,\n): PibblEventMap[K] {\n  const definition = getPibblEventDefinition(input.type);\n  if (!definition) {\n    throw new Error(`Unsupported Pibbl event type: ${input.type}`);\n  }\n  const path = buildEventPath(input.target);\n  const event = createPibblEvent({ ...input, path });\n  const targetIndex = path.length - 1;\n\n  for (let index = 0; index < targetIndex; index++) {\n    if (isPibblPropagationStopped(event)) break;\n    invoke(path[index], input.type, true, 1, event);\n  }\n\n  if (!isPibblPropagationStopped(event) && input.target.live) {\n    invoke(input.target, input.type, true, 2, event);\n    if (!isPibblImmediatePropagationStopped(event)) {\n      invoke(input.target, input.type, false, 2, event);\n    }\n  }\n\n  if (definition.bubbles && !isPibblPropagationStopped(event)) {\n    for (let index = targetIndex - 1; index >= 0; index--) {\n      if (isPibblPropagationStopped(event)) break;\n      invoke(path[index], input.type, false, 3, event);\n    }\n  }\n\n  return event;\n}\n\nfunction invoke(\n  node: PibblEventNode,\n  type: PibblEventType,\n  capture: boolean,\n  phase: PibblEventPhase,\n  event: PibblEvent,\n): void {\n  if (!node.live) return;\n  const key = capture ? `${type}Capture` as PibblNormalizedCaptureKey : type;\n  const handler = node.handlers[key as keyof PibblNormalizedHandlers];\n  if (!handler) return;\n  setPibblEventInvocation(event, node.publicTarget, phase);\n  try {\n    (handler as (event: PibblEvent) => void)(event);\n  } catch (error) {\n    reportDispatchError(error);\n  }\n}\n\nfunction reportDispatchError(error: unknown): void {\n  try {\n    globalThis.reportError(error);\n  } catch {\n    // Reporting cannot suppress unrelated handlers in this logical dispatch.\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,+BAA+B;AACxC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,sBAAsB;AAmBxB,SAAS,kBACd,OACkB;AAClB,QAAM,aAAa,wBAAwB,MAAM,IAAI;AACrD,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,iCAAiC,MAAM,IAAI,EAAE;AAAA,EAC/D;AACA,QAAM,OAAO,eAAe,MAAM,MAAM;AACxC,QAAM,QAAQ,iBAAiB,EAAE,GAAG,OAAO,KAAK,CAAC;AACjD,QAAM,cAAc,KAAK,SAAS;AAElC,WAAS,QAAQ,GAAG,QAAQ,aAAa,SAAS;AAChD,QAAI,0BAA0B,KAAK,EAAG;AACtC,WAAO,KAAK,KAAK,GAAG,MAAM,MAAM,MAAM,GAAG,KAAK;AAAA,EAChD;AAEA,MAAI,CAAC,0BAA0B,KAAK,KAAK,MAAM,OAAO,MAAM;AAC1D,WAAO,MAAM,QAAQ,MAAM,MAAM,MAAM,GAAG,KAAK;AAC/C,QAAI,CAAC,mCAAmC,KAAK,GAAG;AAC9C,aAAO,MAAM,QAAQ,MAAM,MAAM,OAAO,GAAG,KAAK;AAAA,IAClD;AAAA,EACF;AAEA,MAAI,WAAW,WAAW,CAAC,0BAA0B,KAAK,GAAG;AAC3D,aAAS,QAAQ,cAAc,GAAG,SAAS,GAAG,SAAS;AACrD,UAAI,0BAA0B,KAAK,EAAG;AACtC,aAAO,KAAK,KAAK,GAAG,MAAM,MAAM,OAAO,GAAG,KAAK;AAAA,IACjD;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,OACP,MACA,MACA,SACA,OACA,OACM;AACN,MAAI,CAAC,KAAK,KAAM;AAChB,QAAM,MAAM,UAAU,GAAG,IAAI,YAAyC;AACtE,QAAM,UAAU,KAAK,SAAS,GAAoC;AAClE,MAAI,CAAC,QAAS;AACd,0BAAwB,OAAO,KAAK,cAAc,KAAK;AACvD,MAAI;AACF,IAAC,QAAwC,KAAK;AAAA,EAChD,SAAS,OAAO;AACd,wBAAoB,KAAK;AAAA,EAC3B;AACF;AAEA,SAAS,oBAAoB,OAAsB;AACjD,MAAI;AACF,eAAW,YAAY,KAAK;AAAA,EAC9B,QAAQ;AAAA,EAER;AACF;",
+  "sourcesContent": ["import { getPibblEventDefinition } from './event-definitions.js';\nimport {\n  createPibblEvent,\n  finishEventDispatch,\n  isPibblImmediatePropagationStopped,\n  isPibblPropagationStopped,\n  setPibblEventInvocation,\n  type CreatePibblEventInput,\n} from './event-facade.js';\nimport { buildEventPath } from './event-path.js';\nimport type {\n  PibblEventNode,\n  PibblNormalizedHandlers,\n} from './registrations.js';\nimport type {\n  PibblEvent,\n  PibblEventMap,\n  PibblEventPhase,\n  PibblEventType,\n} from './types.js';\n\nexport interface DispatchEventPathInput<K extends PibblEventType>\n  extends Omit<CreatePibblEventInput<K>, 'path'> {\n  readonly target: PibblEventNode;\n}\n\ntype PibblNormalizedCaptureKey = `${PibblEventType}Capture`;\n\nexport function dispatchEventPath<K extends PibblEventType>(\n  input: DispatchEventPathInput<K>,\n): PibblEventMap[K] {\n  const definition = getPibblEventDefinition(input.type);\n  if (!definition) {\n    throw new Error(`Unsupported Pibbl event type: ${input.type}`);\n  }\n  const path = buildEventPath(input.target);\n  const event = createPibblEvent({ ...input, path });\n  const targetIndex = path.length - 1;\n  try {\n  for (let index = 0; index < targetIndex; index++) {\n    if (isPibblPropagationStopped(event)) break;\n    invokePibblEventHandler(path[index], input.type, true, 1, event);\n  }\n\n  if (!isPibblPropagationStopped(event) && input.target.live) {\n    invokePibblEventHandler(input.target, input.type, true, 2, event);\n    if (!isPibblImmediatePropagationStopped(event)) {\n      invokePibblEventHandler(input.target, input.type, false, 2, event);\n    }\n  }\n\n  if (definition.bubbles && !isPibblPropagationStopped(event)) {\n    for (let index = targetIndex - 1; index >= 0; index--) {\n      if (isPibblPropagationStopped(event)) break;\n      invokePibblEventHandler(path[index], input.type, false, 3, event);\n    }\n  }\n\n  return event;\n  } finally { finishEventDispatch(event); }\n}\n\nexport function invokePibblEventHandler(\n  node: PibblEventNode,\n  type: PibblEventType,\n  capture: boolean,\n  phase: PibblEventPhase,\n  event: PibblEvent,\n): void {\n  if (!node.live) return;\n  const key = capture ? `${type}Capture` as PibblNormalizedCaptureKey : type;\n  const handler = node.handlers[key as keyof PibblNormalizedHandlers];\n  if (!handler) return;\n  setPibblEventInvocation(event, node.publicTarget, phase);\n  try {\n    (handler as (event: PibblEvent) => void)(event);\n  } catch (error) {\n    reportDispatchError(error);\n  }\n}\n\nfunction reportDispatchError(error: unknown): void {\n  try {\n    globalThis.reportError(error);\n  } catch {\n    // Reporting cannot suppress unrelated handlers in this logical dispatch.\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,+BAA+B;AACxC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,sBAAsB;AAmBxB,SAAS,kBACd,OACkB;AAClB,QAAM,aAAa,wBAAwB,MAAM,IAAI;AACrD,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,iCAAiC,MAAM,IAAI,EAAE;AAAA,EAC/D;AACA,QAAM,OAAO,eAAe,MAAM,MAAM;AACxC,QAAM,QAAQ,iBAAiB,EAAE,GAAG,OAAO,KAAK,CAAC;AACjD,QAAM,cAAc,KAAK,SAAS;AAClC,MAAI;AACJ,aAAS,QAAQ,GAAG,QAAQ,aAAa,SAAS;AAChD,UAAI,0BAA0B,KAAK,EAAG;AACtC,8BAAwB,KAAK,KAAK,GAAG,MAAM,MAAM,MAAM,GAAG,KAAK;AAAA,IACjE;AAEA,QAAI,CAAC,0BAA0B,KAAK,KAAK,MAAM,OAAO,MAAM;AAC1D,8BAAwB,MAAM,QAAQ,MAAM,MAAM,MAAM,GAAG,KAAK;AAChE,UAAI,CAAC,mCAAmC,KAAK,GAAG;AAC9C,gCAAwB,MAAM,QAAQ,MAAM,MAAM,OAAO,GAAG,KAAK;AAAA,MACnE;AAAA,IACF;AAEA,QAAI,WAAW,WAAW,CAAC,0BAA0B,KAAK,GAAG;AAC3D,eAAS,QAAQ,cAAc,GAAG,SAAS,GAAG,SAAS;AACrD,YAAI,0BAA0B,KAAK,EAAG;AACtC,gCAAwB,KAAK,KAAK,GAAG,MAAM,MAAM,OAAO,GAAG,KAAK;AAAA,MAClE;AAAA,IACF;AAEA,WAAO;AAAA,EACP,UAAE;AAAU,wBAAoB,KAAK;AAAA,EAAG;AAC1C;AAEO,SAAS,wBACd,MACA,MACA,SACA,OACA,OACM;AACN,MAAI,CAAC,KAAK,KAAM;AAChB,QAAM,MAAM,UAAU,GAAG,IAAI,YAAyC;AACtE,QAAM,UAAU,KAAK,SAAS,GAAoC;AAClE,MAAI,CAAC,QAAS;AACd,0BAAwB,OAAO,KAAK,cAAc,KAAK;AACvD,MAAI;AACF,IAAC,QAAwC,KAAK;AAAA,EAChD,SAAS,OAAO;AACd,wBAAoB,KAAK;AAAA,EAC3B;AACF;AAEA,SAAS,oBAAoB,OAAsB;AACjD,MAAI;AACF,eAAW,YAAY,KAAK;AAAA,EAC9B,QAAQ;AAAA,EAER;AACF;",
   "names": []
 }

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

@@ -20,6 +20,8 @@ export type PibblNormalizedHandlers = Partial<{
  * @see {@link isBackendEventTargetLive}
  */
 export interface PibblEventTargetRegistration {
+    /** @internal Withdraws published interaction while preserving mount-owned resources. */
+    suspendLayout(): void;
     /** Selects the kind of geometry, material, or result. See {@link PibblEventTargetRegistration}. */
     readonly kind: "target";
     /** Mount or runtime resource owning this registration. See {@link PibblInstance}. */
@@ -87,6 +89,8 @@ export interface PibblEventTargetRegistration {
     live: boolean;
 }
 export interface PibblEventListenerRegistration {
+    /** @internal Withdraws listeners while preserving mount-owned resources. */
+    suspendLayout(): void;
     readonly kind: "listener";
     readonly owner: PibblInstance;
     readonly component: PibblComponentRefs<any>;
@@ -106,6 +110,12 @@ export interface PibblEventListenerRegistration {
 }
 export type PibblEventNode = PibblEventTargetRegistration | PibblEventListenerRegistration;
 export declare function createTarget(owner: PibblInstance, component: PibblComponentRefs<any>, slot: number): PibblEventTargetRegistration;
+/** Prepared external registrations acquire fallible native leases before adoption. */
+export declare function prepareTargetUpdate(target: PibblEventTargetRegistration, handlers: PibblEventHandlers, options: PibblEventTargetOptions, transform: DOMMatrix, clippingStack: PibblPathPaintEntry['clippingStack']): {
+    adopt(): void;
+    finish(): void;
+    notify(): void;
+};
 export declare function updateTarget(target: PibblEventTargetRegistration, handlers: PibblEventHandlers, options: PibblEventTargetOptions, participatesInPaint?: boolean, preserveKeyboardNavigationGeometry?: boolean): void;
 export declare function updateCursorTarget(target: PibblEventTargetRegistration, { path, fill, lineInteractionWidth, cursor, }: {
     path: Path2D | PathGeometry;

package/dist/lib/events/registrations.js

@@ -1,3 +1,5 @@
+import { releaseLayoutTargetGeometry } from "../layout/geometry-publication.js";
+import { registerLayoutSuspensionResource, unregisterLayoutSuspensionResource, isLayoutComponentSuspended, isLayoutInstanceSuspended } from "../layout/participation.js";
 import { PIBBL_EVENT_DEFINITIONS } from "./event-definitions.js";
 import { GLOBAL_STATE } from "../global-state.js";
 import { resolvePath } from "../geometry/resolve-path.js";
@@ -15,6 +17,7 @@ function createTarget(owner, component, slot) {
   const publicTarget = createPublicTarget(() => target);
   Object.assign(target, {
     kind: "target",
+    suspendLayout: suspendTargetLayout,
     owner,
     component,
     slot,
@@ -33,8 +36,109 @@ function createTarget(owner, component, slot) {
     keyboardNavigationPoints: void 0,
     live: false
   });
+  registerLayoutSuspensionResource(component, target);
   return target;
 }
+function prepareTargetUpdate(target, handlers, options, transform, clippingStack) {
+  const state = { ...target };
+  refreshHandlers(state, handlers, Boolean(options.cursor));
+  const paintEntry = {
+    paintKind: PibblPaintEntryKind.Path,
+    target,
+    path: resolvePath(options.path),
+    fill: options.fill ?? false,
+    lineInteractionWidth: options.lineInteractionWidth ?? 0,
+    transform,
+    clippingStack
+  };
+  const leases = /* @__PURE__ */ new Map();
+  const existing = nativeReleases.get(target);
+  const additions = [];
+  const hub = target.owner.eventRoot.nativeListeners;
+  try {
+    if (hub) forEachChangedType(
+      state.requiredNativeTypesLow,
+      state.requiredNativeTypesHigh,
+      (type) => {
+        let lease = existing?.get(type);
+        if (!lease) {
+          lease = hub.acquire(type);
+          additions.push(lease);
+        }
+        leases.set(type, lease);
+      }
+    );
+  } catch (error) {
+    const errors = [error];
+    for (const release of additions) {
+      try {
+        release();
+      } catch (releaseError) {
+        errors.push(releaseError);
+      }
+    }
+    if (errors.length > 1) throw new AggregateError(errors, "Prepared target acquisition failed.", { cause: error });
+    throw error;
+  }
+  let previous;
+  let adopted = false;
+  return {
+    adopt() {
+      previous = nativeReleases.get(target);
+      nativeReleases.set(target, leases);
+      if (target.paintEntry) target.owner.paintEntries.delete(target.paintEntry);
+      target.handlers = state.handlers;
+      target.handlerTypesLow = state.handlerTypesLow;
+      target.handlerTypesHigh = state.handlerTypesHigh;
+      target.requiredNativeTypesLow = target.ownedNativeTypesLow = state.requiredNativeTypesLow;
+      target.requiredNativeTypesHigh = target.ownedNativeTypesHigh = state.requiredNativeTypesHigh;
+      target.cursor = options.cursor;
+      target.keyboardFocusable = options.keyboardFocusable;
+      target.keyboardNavigationBounds = options.keyboardNavigationBounds;
+      target.keyboardNavigationPoints = void 0;
+      target.paintEntry = paintEntry;
+      target.live = true;
+      target.owner.regions.add(target);
+      target.owner.eventRoot.targets.add(target);
+      adopted = true;
+    },
+    finish() {
+      const errors = [];
+      const complete = (callback) => {
+        try {
+          callback();
+        } catch (error) {
+          errors.push(error);
+        }
+      };
+      if (adopted) {
+        for (const [type, release] of previous ?? []) if (!leases.has(type)) complete(release);
+        previous = void 0;
+      } else {
+        for (const release of additions) complete(release);
+        additions.length = 0;
+      }
+      if (errors.length === 1) throw errors[0];
+      if (errors.length) throw new AggregateError(errors, "Prepared target completion failed.");
+    },
+    notify() {
+      if (!adopted || !target.live) return;
+      const errors = [];
+      try {
+        target.owner.eventRoot.focusPolicy?.observeTarget(target);
+      } catch (error) {
+        errors.push(error);
+      }
+      try {
+        target.owner.eventRoot.onTargetUpdate?.(target);
+      } catch (error) {
+        errors.push(error);
+      }
+      if (errors.length === 1) throw errors[0];
+      if (errors.length) throw new AggregateError(errors, "Prepared target notification failed.");
+    }
+  };
+}
 function updateTarget(target, handlers, options, participatesInPaint = false, preserveKeyboardNavigationGeometry = false) {
   updateTargetRegistration(
     target,
@@ -106,27 +210,64 @@ function updateTargetRegistration(target, handlers, options, participatesInPaint
   target.owner.paintEntries.add(paintEntry);
   target.owner.eventRoot.targets.add(target);
   updateNativeOwnership(target);
+  if (isLayoutComponentSuspended(target.component) || isLayoutInstanceSuspended(target.owner)) {
+    target.suspendLayout();
+    return;
+  }
   target.owner.eventRoot.focusPolicy?.observeTarget(target);
   target.owner.eventRoot.onTargetUpdate?.(target);
 }
+function suspendTargetLayout() {
+  if (!this.live) return;
+  if (this.paintEntry) this.owner.paintEntries.delete(this.paintEntry);
+  this.owner.regions.delete(this);
+  this.owner.eventRoot.targets.delete(this);
+  this.owner.eventRoot.focusPolicy?.removeTarget(this);
+  this.owner.eventRoot.onNodeRelease?.(this);
+  this.paintEntry = void 0;
+  this.live = false;
+  clearPointerCapturesForTarget(this);
+}
+function suspendListenerLayout() {
+  if (!this.live) return;
+  const entries = this.owner.eventRoot.listenersByComponent.get(this.component.id);
+  entries?.delete(this);
+  if (entries?.size === 0) this.owner.eventRoot.listenersByComponent.delete(this.component.id);
+  this.owner.eventRoot.onNodeRelease?.(this);
+  this.live = false;
+  clearPointerCapturesForTarget(this);
+}
 function releaseTarget(target) {
+  releaseLayoutTargetGeometry(target);
+  const errors = [];
+  const release = (callback) => {
+    try {
+      callback();
+    } catch (error) {
+      errors.push(error);
+    }
+  };
+  release(() => unregisterLayoutSuspensionResource(target.component, target));
   if (target.live) {
     if (target.paintEntry) target.owner.paintEntries.delete(target.paintEntry);
     target.owner.eventRoot.targets.delete(target);
-    target.owner.eventRoot.focusPolicy?.removeTarget(target);
-    target.owner.eventRoot.onNodeRelease?.(target);
+    release(() => target.owner.eventRoot.focusPolicy?.removeTarget(target));
+    release(() => target.owner.eventRoot.onNodeRelease?.(target));
   }
   target.owner.regions.delete(target);
   target.paintEntry = void 0;
   target.live = false;
-  clearPointerCapturesForTarget(target);
-  releaseNativeOwnership(target);
+  release(() => clearPointerCapturesForTarget(target));
+  release(() => releaseNativeOwnership(target));
+  if (errors.length === 1) throw errors[0];
+  if (errors.length) throw new AggregateError(errors, "Target release failed.");
 }
 function createListener(owner, component, slot) {
   const listener = {};
   const publicTarget = createPublicTarget(() => listener);
   Object.assign(listener, {
     kind: "listener",
+    suspendLayout: suspendListenerLayout,
     owner,
     component,
     slot,
@@ -140,6 +281,7 @@ function createListener(owner, component, slot) {
     ownedNativeTypesHigh: 0,
     live: false
   });
+  registerLayoutSuspensionResource(component, listener);
   return listener;
 }
 function updateListener(listener, handlers) {
@@ -171,9 +313,14 @@ function updateListener(listener, handlers) {
   }
   registrations.add(listener);
   listener.live = true;
+  if (isLayoutComponentSuspended(listener.component) || isLayoutInstanceSuspended(listener.owner)) {
+    listener.suspendLayout();
+    return;
+  }
   updateNativeOwnership(listener);
 }
 function releaseListener(listener) {
+  unregisterLayoutSuspensionResource(listener.component, listener);
   if (listener.live) {
     const registrations = listener.owner.eventRoot.listenersByComponent.get(
       listener.component.id
@@ -354,10 +501,17 @@ function releaseNativeOwnership(registration) {
   const releases = nativeReleases.get(registration);
   if (!releases) return;
   nativeReleases.delete(registration);
+  const errors = [];
   for (const release of releases.values()) {
-    release();
+    try {
+      release();
+    } catch (error) {
+      errors.push(error);
+    }
   }
   releases.clear();
+  if (errors.length === 1) throw errors[0];
+  if (errors.length) throw new AggregateError(errors, "Native listener release failed.");
 }
 function forEachChangedType(low, high, visit) {
   while (low !== 0) {
@@ -388,6 +542,7 @@ export {
   createListener,
   createTarget,
   normalizeHandlers,
+  prepareTargetUpdate,
   releaseListener,
   releaseTarget,
   updateCursorTarget,