@pibbl/core 0.0.2 → 0.0.3-alpha.109.1

package/dist/lib/layout/measure.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/layout/measure.ts"],
-  "sourcesContent": ["import { getStyleMeasurementMode, withStyleMeasurement, rejectResponsiveMeasurement, UnsupportedResponsiveMeasurement } from '../style/responsive.js';\nimport { layoutDiagnostic } from '../style/diagnostics.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport { EMPTY_STYLE } from '../style/empty-style.js';\nimport {\n  takePreNormalizedStyle,\n  withoutSystemFilter,\n} from '../style/resolve-dispatch.js';\nimport {\n  createPrimitiveReceiverToken,\n  getPrimitiveDefinition,\n  getPrimitiveReceiverToken,\n  getPolicyPreparationSource,\n} from '../element/metadata.js';\nimport { resolvePrimitiveInputs } from '../element/resolve-primitive-inputs.js';\nimport { recordLayoutMeasurement } from './diagnostics.js';\nimport type {\n  CanvasMeasurementService,\n  MeasureResult,\n} from '../types.js';\nimport type { PibblElement } from '../element/types.js';\nimport { prepareElementPolicies } from '../element/children.js';\nimport type { Constraints } from './types.js';\nimport { untracked, withSignalWriteForbidden } from '../signals/graph.js';\n\nexport type {\n  CanvasMeasurementService,\n  MeasureInput,\n  MeasureResult,\n} from '../types.js';\n\n/**\n * Measures an element against finite constraints using the supplied Canvas measurement service.\n *\n * @param element - Element whose declared measurement capability is used. See {@link PibblElement}.\n * @param constraints - Available size constraints in logical units. See {@link Constraints}.\n * @param service - Canvas text measurement service. See {@link CanvasMeasurementService}.\n * @returns Measured dimensions, or an unsupported result with its reason. See\n * {@link MeasureResult} .\n *\n * @see {@link PibblElement}\n * @see {@link Constraints}\n * @see {@link CanvasMeasurementService}\n * @see {@link MeasureResult}\n */\nexport function measureElement(\n  element: PibblElement<any>,\n  constraints: Readonly<Constraints>,\n  service: CanvasMeasurementService,\n): MeasureResult {\n  const context: MeasurementContext = {\n    active: new Set(),\n    stack: [],\n  };\n  const mode = getStyleMeasurementMode() ? 'recursive' :\n    GLOBAL_STATE.componentRefs ? 'mounted-intrinsic' : 'standalone-root';\n  return withSignalWriteForbidden('Signal writes are forbidden during Pibbl measurement', () =>\n    withStyleMeasurement(mode, () => withIsolatedRenderState(() =>\n      measureElementInternal(element, constraints, service, context),\n    )),\n  );\n}\n\ninterface MeasurementContext {\n  active: Set<PibblElement<any>>;\n  stack: PibblElement<any>[];\n}\n\nfunction measureElementInternal(\n  element: PibblElement<any>,\n  constraints: Readonly<Constraints>,\n  service: CanvasMeasurementService,\n  context: MeasurementContext,\n): MeasureResult {\n  element = prepareElementPolicies(element, 'measureElement');\n  recordLayoutMeasurement();\n  const type = element.type;\n  const definition = getPrimitiveDefinition(type);\n  const component = type.name || 'Anonymous';\n  const preNormalized = takePreNormalizedStyle(element);\n  const source = getPolicyPreparationSource(element) ??\n    preNormalized?.source ??\n    element;\n  if (context.active.has(source)) {\n    throw layoutDiagnostic({\n      component,\n      property: 'measurement',\n      value: context.stack.map(item => item.type.name || 'Anonymous'),\n      algorithm: 'measurement',\n      constraints,\n      reason: 'cyclic measurement dependency is not supported',\n    });\n  }\n  if (!definition?.measure) {\n    return {\n      status: 'unsupported',\n      reason: `${component} does not provide measurement`,\n    };\n  }\n\n  context.active.add(source);\n  context.stack.push(element);\n  try {\n    if (preNormalized?.query && getStyleMeasurementMode() !== 'standalone-root') {\n      rejectResponsiveMeasurement(element);\n    }\n    const inputs = untracked(() => resolvePrimitiveInputs(element, definition, preNormalized, {\n      width: constraints.maxWidth, height: constraints.maxHeight,\n    }));\n    const specifiedStyle = withoutSystemFilter(\n      preNormalized?.style ?? inputs.style ?? EMPTY_STYLE,\n    );\n    const normalized = preNormalized ?\n        specifiedStyle :\n      definition.normalizeStyle ?\n          definition.normalizeStyle(specifiedStyle) :\n          specifiedStyle;\n    const previousReceiverToken = GLOBAL_STATE.primitiveReceiverToken;\n    GLOBAL_STATE.primitiveReceiverToken =\n      getPrimitiveReceiverToken(element) ?? createPrimitiveReceiverToken();\n    let result: MeasureResult;\n    try {\n      result = withStyleMeasurement('recursive', () => definition.measure!({\n        props: inputs.props,\n        style: normalized,\n        constraints,\n        service,\n        measureElement: (child, childConstraints) =>\n          measureElementInternal(child, childConstraints, service, context),\n      }));\n    } finally {\n      GLOBAL_STATE.primitiveReceiverToken = previousReceiverToken;\n    }\n    if (result.status === 'unsupported') return result;\n    validateMeasuredSize(result.size.width, 'width', component, constraints);\n    validateMeasuredSize(result.size.height, 'height', component, constraints);\n    return result;\n  } catch (error) {\n    if (error instanceof UnsupportedResponsiveMeasurement) {\n      return { status: 'unsupported', reason: error.message };\n    }\n    throw error;\n  } finally {\n    context.stack.pop();\n    context.active.delete(source);\n  }\n}\n\nfunction withIsolatedRenderState<T>(work: () => T): T {\n  const snapshot = {\n    currentPibblInstance: GLOBAL_STATE.currentPibblInstance,\n    componentRefs: GLOBAL_STATE.componentRefs,\n    canvas: GLOBAL_STATE.canvas,\n    componentIsMounting: GLOBAL_STATE.componentIsMounting,\n    componentHookIndex: GLOBAL_STATE.componentHookIndex,\n    renderContext: GLOBAL_STATE.renderContext,\n    primitiveReceiverToken: GLOBAL_STATE.primitiveReceiverToken,\n    seenIds: GLOBAL_STATE.seenIds,\n    seenKeys: GLOBAL_STATE.seenKeys,\n    clippingStack: GLOBAL_STATE.clippingStack,\n    layoutStack: GLOBAL_STATE.layoutStack,\n  };\n  GLOBAL_STATE.currentPibblInstance = undefined;\n  GLOBAL_STATE.componentRefs = undefined;\n  GLOBAL_STATE.canvas = undefined;\n  GLOBAL_STATE.componentIsMounting = false;\n  GLOBAL_STATE.componentHookIndex = 0;\n  GLOBAL_STATE.renderContext = undefined;\n  GLOBAL_STATE.primitiveReceiverToken = undefined;\n  GLOBAL_STATE.seenIds = undefined;\n  GLOBAL_STATE.seenKeys = undefined;\n  GLOBAL_STATE.clippingStack = [];\n  GLOBAL_STATE.layoutStack = undefined;\n  try {\n    return work();\n  } finally {\n    Object.assign(GLOBAL_STATE, snapshot);\n  }\n}\n\nfunction validateMeasuredSize(\n  value: number,\n  property: 'width' | 'height',\n  component: string,\n  constraints: Readonly<Constraints>,\n): void {\n  if (!Number.isFinite(value) || value < 0) {\n    throw layoutDiagnostic({\n      component,\n      property,\n      value,\n      algorithm: 'measurement',\n      constraints,\n      reason: 'measured dimensions must be finite and nonnegative',\n    });\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { bindCanvasMeasurementService, sameCanvasMeasurementService } from './canvas-measurement.js';\nimport { allocationMeasurement, declineUnrecordedAllocationMeasurement, declineUntracedAllocationQuery, allocationQueryReplayRevision, allocationQueryVolatilityRevision } from './allocation-checkpoint.js';\nimport { allocationOwner, setAllocationOwner } from './allocation-revision.js';\nimport { isFitContent } from '../style/sizing-length.js';\nimport { observeReceiverInputReads, captureReceiverInputProvision, replayReceiverInputProvision, withReceiverInputProvision, type ReceiverInputProvisionReceipt } from '../signals/input-provision.js';\nimport type { BoxStyle } from '../style/types.js';\nimport { hasPercentageBoxPadding } from './box-insets.js';\nimport { contentBoxStyle } from './box-sizing.js';\nimport { isLayoutComponent, placedLayoutComponentRoot } from './define-layout-component.js';\nimport { getStyleMeasurementMode, withStyleMeasurement, rejectResponsiveMeasurement, UnsupportedResponsiveMeasurement, type PreparedQuery } from '../style/responsive.js';\nimport { layoutDiagnostic } from '../style/diagnostics.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport { withMeasurementLayoutOwner } from './wasm/region.js';\nimport { EMPTY_STYLE } from '../style/empty-style.js';\nimport {\n  takePreNormalizedStyle,\n  peekPreNormalizedStyle,\n  withoutSystemFilter,\n} from '../style/resolve-dispatch.js';\nimport {\n  createPrimitiveReceiverToken,\n  getPrimitiveDefinition,\n  getPrimitiveProgramProps,\n  getPrimitiveReceiverToken,\n  getElementMetadata,\n} from '../element/metadata.js';\nimport { resolvePrimitiveInputs } from '../element/resolve-primitive-inputs.js';\nimport { recordLayoutMeasurement } from './diagnostics.js';\nimport type {\n  CanvasMeasurementService,\n  MeasureResult,\n  IntrinsicSizesResult,\n  BaselinesResult,\n  BaselineMeasureInput,\n  SystemStyle,\n} from '../types.js';\nimport type { PibblElement } from '../element/types.js';\nimport { prepareElementPolicies } from '../element/children.js';\nimport type { Constraints, LayoutBox } from './types.js';\nimport { isSignal, trackSignalDependency, withSignalTracking, type SignalNode, withSignalDependencyRole, untracked, withSignalWriteForbidden } from '../signals/graph.js';\n\nexport type {\n  CanvasMeasurementService,\n  MeasureInput,\n  MeasureResult,\n} from '../types.js';\n\n/**\n * Measures an element against logical size constraints using the supplied Canvas measurement service.\n *\n * @param element - Element whose declared measurement capability is used. See {@link PibblElement}.\n * @param constraints - Available size constraints in logical units. See {@link Constraints}.\n * @param service - Canvas text measurement service. See {@link CanvasMeasurementService}.\n * @returns Measured dimensions, or an unsupported result with its reason. See\n * {@link MeasureResult} .\n *\n * @see {@link PibblElement}\n * @see {@link Constraints}\n * @see {@link CanvasMeasurementService}\n * @see {@link MeasureResult}\n */\nexport function measureElement(element: PibblElement<any>, constraints: Readonly<Constraints>, service: CanvasMeasurementService): MeasureResult {\n  const resolveService = bindCanvasMeasurementService(service);\n  return allocationMeasurement(element, current => measureElementUncached(current, constraints, resolveService()));\n}\n\nfunction measureElementUncached(\n  element: PibblElement<any>,\n  constraints: Readonly<Constraints>,\n  service: CanvasMeasurementService,\n): MeasureResult {\n  const context: MeasurementContext = {\n    active: new Set(),\n    stack: [],\n  };\n  const mode = getStyleMeasurementMode() ? 'recursive' :\n    GLOBAL_STATE.componentRefs ? 'mounted-intrinsic' : 'standalone-root';\n  const owner = GLOBAL_STATE.currentPibblInstance?.interactionRoot ?? GLOBAL_STATE.currentPibblInstance;\n  const evaluate = () => withSignalWriteForbidden('Signal writes are forbidden during Pibbl measurement', () =>\n    withMeasurementLayoutOwner(owner, () => withStyleMeasurement(mode, () => withIsolatedRenderState(() =>\n      measureElementInternal(element, constraints, service, context),\n    ))),\n  );\n  const receiver = getPrimitiveReceiverToken(element);\n  return receiver ? withReceiverInputProvision(GLOBAL_STATE.renderTransaction, receiver, () => withSignalDependencyRole('measurement', evaluate)) : evaluate();\n}\n\n/** @internal Passive snapshot owned and released by one layout region. */\nexport interface PrimitiveMeasurementEntry {\n  readonly props: object;\n  readonly key: string;\n  readonly result: IntrinsicSizesResult | MeasureResult | BaselinesResult;\n  readonly mode: 'intrinsic' | 'finite' | 'baseline';\n  readonly dependencies: readonly SignalNode<unknown>[];\n  readonly receiverDependencies?: readonly SignalNode<unknown>[];\n  readonly dependencyVersions?: readonly number[];\n  readonly inputSnapshot: readonly unknown[] | undefined;\n  readonly receiverReceipts?: readonly ConstrainedMeasurementReceipt[];\n}\nfunction measurementDependenciesUnchanged(entry: Pick<PrimitiveMeasurementEntry, 'dependencies' | 'dependencyVersions'>): boolean {\n  const versions = entry.dependencyVersions;\n  if (!versions || versions.length !== entry.dependencies.length) return false;\n  for (let index = 0; index < versions.length; index++) {\n    const node = entry.dependencies[index]!;\n    node.validate?.();\n    if (node.version !== versions[index]) return false;\n  }\n  return true;\n}\nfunction measurementDependencyVersions(dependencies: readonly SignalNode<unknown>[]): number[] {\n  const versions: number[] = [];\n  for (let index = 0; index < dependencies.length; index++) versions.push(dependencies[index]!.version);\n  return versions;\n}\ninterface PrimitiveMeasurementCache {\n  readPrimitiveMeasurement(token: object, key: string): PrimitiveMeasurementEntry | undefined;\n  writePrimitiveMeasurement(token: object, entry: PrimitiveMeasurementEntry): void;\n}\nconst intrinsicTransactions = new WeakMap<object, WeakMap<object, Map<string, PrimitiveMeasurementEntry>>>();\n\n// Conservative admission: mutable nested props or custom style records always\n// remeasure. Scalar snapshots also detect production-mode in-place scalar writes.\nfunction intrinsicInputSnapshot(element: PibblElement<any>): unknown[] | undefined {\n  const props = getPrimitiveProgramProps<Record<string, unknown>>(element);\n  const style = peekPreNormalizedStyle(element)?.style as Readonly<Record<string, unknown>> | undefined;\n  const snapshot: unknown[] = [];\n  for (const key of Object.keys(props)) {\n    const value = props[key];\n    if (value !== null && (typeof value === 'object' && !isSignal(value) || typeof value === 'function')) return;\n    snapshot.push(key, value);\n  }\n  if (style) for (const key of Object.keys(style)) {\n    const value = style[key];\n    // This module-branded sizing record is immutable; snapshot its semantic limit\n    // rather than its per-render identity. Other object-valued styles stay conservative.\n    if (isFitContent(value) && Object.isFrozen(value)) {\n      snapshot.push(key, isFitContent, value.limit);\n      continue;\n    }\n    if (value !== null && (typeof value === 'object' || typeof value === 'function')) return;\n    snapshot.push(key, value);\n  }\n  return snapshot;\n}\nfunction sameIntrinsicInputs(left: readonly unknown[] | undefined, right: readonly unknown[] | undefined): boolean {\n  if (!left || !right || left.length !== right.length) return false;\n  for (let index=0; index<left.length; index++) if (!Object.is(left[index], right[index])) return false;\n  return true;\n}\n\ninterface PrimitiveMeasurementOptions {\n  cache: PrimitiveMeasurementCache;\n  token: object;\n  key: string;\n  recordMeasurement: () => void;\n}\n/** @internal Paired content contributions through the existing pure receiver transaction. */\nexport function measureIntrinsicElement(element: PibblElement<any>, constraints: Readonly<Constraints>, service: CanvasMeasurementService, options?: PrimitiveMeasurementOptions): IntrinsicSizesResult {\n  const resolveService = bindCanvasMeasurementService(service);\n  return allocationMeasurement(element, current => measurePrimitiveInput(current, constraints, resolveService(), true, options));\n}\n/** @internal Finite custom measurement through the same receiver transaction and cache. */\nexport function measureConstrainedIntrinsicElement(element: PibblElement<any>, constraints: Readonly<Constraints>, service: CanvasMeasurementService, options?: PrimitiveMeasurementOptions): MeasureResult {\n  const resolveService = bindCanvasMeasurementService(service);\n  return allocationMeasurement(element, current => measurePrimitiveInput(current, constraints, resolveService(), false, options));\n}\n/** @internal Parent-owned prepared row result with fresh receiver paths per query. */\nexport function measurePreparedLayoutElement(\n  element: PibblElement<any>, constraints: Readonly<Constraints>, service: CanvasMeasurementService,\n  options: PrimitiveMeasurementOptions, snapshot: readonly unknown[], receivers: readonly object[],\n): MeasureResult {\n  declineUnrecordedAllocationMeasurement();\n  return measurePrimitiveInput(element, constraints, service, false, options, { snapshot, receivers });\n}\ninterface PreparedMeasurementInput {\n  readonly snapshot: readonly unknown[];\n  readonly receivers: readonly object[];\n}\n\n\ninterface PreparedBaselineOwner {\n  readonly transaction: object;\n  readonly receiver: object;\n  readonly query: PreparedQuery;\n  readonly width: number;\n  readonly height: number;\n}\nconst preparedBaselineOwners = new WeakMap<PibblElement<any>, PreparedBaselineOwner>();\n/** @internal One-shot proof of a direct child's current finite Flex selection. */\nexport function setPreparedBaselineOwner(element: PibblElement<any>, owner: Readonly<LayoutBox>): void {\n  const transaction = GLOBAL_STATE.renderTransaction;\n  const receiver = getPrimitiveReceiverToken(element);\n  const query = peekPreNormalizedStyle(element)?.query;\n  if (!transaction || !receiver || !query || !Number.isFinite(owner.width) || !Number.isFinite(owner.height) ||\n      query.basis.width !== owner.width || query.basis.height !== owner.height) return;\n  preparedBaselineOwners.set(element, { transaction, receiver, query, width: owner.width, height: owner.height });\n}\n\n/** @internal Cache identity for a transparent, currently prepared primitive root. */\nexport interface BaselineMeasurementOptions extends PrimitiveMeasurementOptions {\n  source?: PibblElement<any>;\n}\n\n/** @internal Pure first/last baseline query at one final content allocation. */\nexport function measureBaselineElement(element: PibblElement<any>, allocation: Readonly<LayoutBox>, service: CanvasMeasurementService, options?: BaselineMeasurementOptions): BaselinesResult {\n  const resolveService = bindCanvasMeasurementService(service);\n  const owner = preparedBaselineOwners.get(element);\n  const ownerValid = owner && owner.transaction === GLOBAL_STATE.renderTransaction &&\n    owner.receiver === getPrimitiveReceiverToken(element) && owner.query === peekPreNormalizedStyle(element)?.query;\n  const ownerBox = ownerValid ? { x: 0, y: 0, width: owner.width, height: owner.height } : undefined;\n  return allocationMeasurement(element, current => {\n    if (ownerBox) setPreparedBaselineOwner(current, ownerBox);\n    return measureBaselineElementUncached(current, allocation, resolveService(), options);\n  }, true);\n}\n\nfunction measureBaselineElementUncached(\n  element: PibblElement<any>,\n  allocation: Readonly<LayoutBox>,\n  service: CanvasMeasurementService,\n  options?: BaselineMeasurementOptions,\n): BaselinesResult {\n  // Responsive baselines require the existing current-owner proof and must\n  // never bypass its validation through direct demand reuse.\n  if (!options && !peekPreNormalizedStyle(element)?.query) {\n    const mode = getStyleMeasurementMode() ? 'recursive' : GLOBAL_STATE.componentRefs ? 'mounted-intrinsic' : 'standalone-root';\n    return exactDirectMeasurement(element, service, ['baseline', mode, allocation.width, allocation.height],\n      () => measureBaselineElementWithCache(element, allocation, service));\n  }\n  return measureBaselineElementWithCache(element, allocation, service, options);\n}\n\nfunction measureBaselineElementWithCache(\n  element: PibblElement<any>, allocation: Readonly<LayoutBox>, service: CanvasMeasurementService, options?: BaselineMeasurementOptions,\n): BaselinesResult {\n  const transaction = GLOBAL_STATE.renderTransaction;\n  const receiver = getPrimitiveReceiverToken(element);\n  const mode = getStyleMeasurementMode() ? 'recursive' : GLOBAL_STATE.componentRefs ? 'mounted-intrinsic' : 'standalone-root';\n  const key = `baseline:${options?.key ?? ''}`;\n  const constraints = {\n    minWidth: allocation.width, maxWidth: allocation.width,\n    minHeight: allocation.height, maxHeight: allocation.height,\n  };\n  return withSignalWriteForbidden('Signal writes are forbidden during Pibbl measurement', () => withReceiverInputProvision(transaction, receiver, () => withSignalDependencyRole('measurement', () => {\n    const source = options?.source ?? element;\n    let inputSnapshot = intrinsicInputSnapshot(element);\n    if (source !== element) {\n      const sourceSnapshot = intrinsicInputSnapshot(source);\n      if (!sourceSnapshot || !inputSnapshot) inputSnapshot = undefined;\n      else {\n        // The source props retain one wrapper occurrence; the complete scalar\n        // root snapshot permits fresh JSX descriptions without retaining roots.\n        sourceSnapshot.push(source.type, source.key, element.type, element.key, inputSnapshot.length);\n        for (let index = 0; index < inputSnapshot.length; index++) sourceSnapshot.push(inputSnapshot[index]);\n        inputSnapshot = sourceSnapshot;\n      }\n    }\n    let receivers = transaction && intrinsicTransactions.get(transaction);\n    let entries = options && receivers?.get(options.token);\n    let entry = options && (entries?.get(key) ?? options.cache.readPrimitiveMeasurement(options.token, key));\n    if (!entry || !measurementDependenciesUnchanged(entry) || entry.mode !== 'baseline' || entry.props !== source.props || !sameIntrinsicInputs(entry.inputSnapshot, inputSnapshot)) {\n      options?.recordMeasurement();\n      const dependencies: SignalNode<unknown>[] = [];\n      const addDependency = (node: SignalNode<unknown>) => { if (!dependencies.includes(node)) dependencies.push(node); };\n      const result = observeReceiverInputReads(addDependency, () => withSignalTracking({ addDependency }, () =>\n        withStyleMeasurement(mode, () => withIsolatedRenderState(() =>\n          measureBaselineInput(element, allocation, constraints, service),\n        ))));\n      entry = { props: source.props, key, result, mode: 'baseline', dependencies, dependencyVersions: measurementDependencyVersions(dependencies), inputSnapshot };\n      if (options && transaction && inputSnapshot && result.status === 'measured') {\n        if (!receivers) { receivers = new WeakMap(); intrinsicTransactions.set(transaction, receivers); }\n        if (!entries) { entries = new Map(); receivers.set(options.token, entries); }\n        entries.set(key, entry);\n        const snapshot = entry;\n        transaction.onFinish(success => { if (success) options.cache.writePrimitiveMeasurement(options.token, snapshot); });\n      }\n    }\n    for (const node of entry.dependencies) trackSignalDependency(node, 'measurement');\n    return entry.result as BaselinesResult;\n  })));\n}\n\nfunction measureBaselineInput(\n  original: PibblElement<any>,\n  allocation: Readonly<LayoutBox>,\n  constraints: Readonly<Constraints>,\n  service: CanvasMeasurementService,\n): BaselinesResult {\n  const element = prepareElementPolicies(original, 'measureBaselines');\n  recordLayoutMeasurement();\n  const definition = getPrimitiveDefinition(element.type);\n  const component = element.type.name || 'Anonymous';\n  if (isLayoutComponent(element.type)) {\n    return { status: 'unsupported', reason: 'baseline providers currently require a direct custom primitive' };\n  }\n  if (!definition?.measureBaselines) {\n    return { status: 'unsupported', reason: `${component} does not provide baseline measurement` };\n  }\n  const preNormalized = takePreNormalizedStyle(element);\n  const preparedOwner = preparedBaselineOwners.get(element);\n  preparedBaselineOwners.delete(element);\n  if (preNormalized?.query && getStyleMeasurementMode() !== 'standalone-root') {\n    // Only the direct Flex owner's already-selected style may cross this pure\n    // boundary. Never evaluate responsive rules against the provider allocation.\n    const query = preNormalized.query;\n    if (getStyleMeasurementMode() !== 'mounted-intrinsic' || !preparedOwner ||\n        preparedOwner.transaction !== GLOBAL_STATE.renderTransaction ||\n        preparedOwner.receiver !== getPrimitiveReceiverToken(element) || preparedOwner.query !== query ||\n        preparedOwner.width !== query.basis.width || preparedOwner.height !== query.basis.height) {\n      rejectResponsiveMeasurement(element);\n    }\n  }\n  const inputs = resolvePrimitiveInputs(element, definition, preNormalized, {\n    width: allocation.width, height: allocation.height,\n  });\n  const specifiedStyle = withoutSystemFilter(preNormalized?.style ?? inputs.style ?? EMPTY_STYLE);\n  let normalized = preNormalized ? specifiedStyle : definition.normalizeStyle ?\n    definition.normalizeStyle(specifiedStyle) : specifiedStyle;\n  if (hasPercentageBoxPadding(normalized as Readonly<BoxStyle>)) {\n    return { status: 'unsupported', reason: 'percentage padding requires an actual finite Flex owner allocation' };\n  }\n  if ('boxSizing' in normalized && normalized.boxSizing !== undefined) {\n    normalized = contentBoxStyle(normalized as Readonly<BoxStyle>, {\n      width: allocation.width, height: allocation.height,\n      context: { component, algorithm: 'baseline measurement', constraints },\n    });\n  }\n  const previousReceiverToken = GLOBAL_STATE.primitiveReceiverToken;\n  GLOBAL_STATE.primitiveReceiverToken = getPrimitiveReceiverToken(element) ?? createPrimitiveReceiverToken();\n  try {\n    const result = definition.measureBaselines({\n      props: inputs.props,\n      style: normalized,\n      allocation: { x: 0, y: 0, width: allocation.width, height: allocation.height },\n      service,\n    } as BaselineMeasureInput<Record<PropertyKey, unknown>, SystemStyle>);\n    if (result.status === 'unsupported') return result;\n    if (result.status !== 'measured' || !Number.isFinite(result.first) || !Number.isFinite(result.last) || result.first > result.last) {\n      throw layoutDiagnostic({\n        component, property: 'measureBaselines', value: result,\n        algorithm: 'baseline measurement', constraints,\n        reason: 'first and last baselines must be finite with first not after last',\n      });\n    }\n    return { status: 'measured', first: result.first, last: result.last };\n  } catch (error) {\n    if (error instanceof UnsupportedResponsiveMeasurement) return { status: 'unsupported', reason: error.message };\n    throw error;\n  } finally {\n    GLOBAL_STATE.primitiveReceiverToken = previousReceiverToken;\n  }\n}\nfunction measurePrimitiveInput(element: PibblElement<any>, constraints: Readonly<Constraints>, service: CanvasMeasurementService, intrinsic: true, options?: PrimitiveMeasurementOptions): IntrinsicSizesResult;\nfunction measurePrimitiveInput(element: PibblElement<any>, constraints: Readonly<Constraints>, service: CanvasMeasurementService, intrinsic: false, options?: PrimitiveMeasurementOptions, prepared?: PreparedMeasurementInput): MeasureResult;\nfunction measurePrimitiveInput(element: PibblElement<any>, constraints: Readonly<Constraints>, service: CanvasMeasurementService, intrinsic: boolean, options?: PrimitiveMeasurementOptions, prepared?: PreparedMeasurementInput): IntrinsicSizesResult | MeasureResult {\n  const transaction = GLOBAL_STATE.renderTransaction;\n  const receiver = getPrimitiveReceiverToken(element);\n  const context: MeasurementContext = { active: new Set(), stack: [] };\n  const mode = getStyleMeasurementMode() ? 'recursive' : GLOBAL_STATE.componentRefs ? 'mounted-intrinsic' : 'standalone-root';\n  const key = `${intrinsic ? 'intrinsic' : 'finite'}:${options?.key ?? ''}`;\n  const owner = GLOBAL_STATE.currentPibblInstance?.interactionRoot ?? GLOBAL_STATE.currentPibblInstance;\n  return withSignalWriteForbidden('Signal writes are forbidden during Pibbl measurement', () => withMeasurementLayoutOwner(owner, () => withReceiverInputProvision(transaction, receiver, () => withSignalDependencyRole('measurement', () => {\n    const inputSnapshot = prepared?.snapshot ?? intrinsicInputSnapshot(element);\n    let receivers = transaction && intrinsicTransactions.get(transaction);\n    let entries = options && receivers?.get(options.token);\n    let entry = options && (entries?.get(key) ?? options.cache.readPrimitiveMeasurement(options.token, key));\n    const entryMode = intrinsic ? 'intrinsic' : 'finite';\n    if (!entry || !measurementDependenciesUnchanged(entry) || entry.mode !== entryMode || entry.props !== element.props || !sameIntrinsicInputs(entry.inputSnapshot, inputSnapshot) || prepared && entry.receiverReceipts === undefined) {\n      options?.recordMeasurement();\n      const dependencies: SignalNode<unknown>[] = [];\n      const receiverDependencies: SignalNode<unknown>[] = [];\n      let untracedReceiverReads = false;\n      const trace: ConstrainedMeasurementTrace | undefined = prepared ? {\n        cacheable: true, receipts: [], receivers: prepared.receivers,\n      } : undefined;\n      const evaluate = () => withStyleMeasurement(mode, () => withIsolatedRenderState(() => intrinsic ?\n        measureElementInternal(element, constraints, service, context, true) :\n        measureElementInternal(element, constraints, service, context, false, true),\n      ));\n      const addDependency = (node: SignalNode<unknown>) => {\n        if (!dependencies.includes(node)) dependencies.push(node);\n        if (!receiverDependencies.includes(node)) receiverDependencies.push(node);\n      };\n      const result = observeReceiverInputReads((node, _roles, inputReceiver) => {\n        if (!dependencies.includes(node)) dependencies.push(node);\n        if (inputReceiver === receiver && !receiverDependencies.includes(node)) receiverDependencies.push(node);\n        if (inputReceiver !== receiver && !trace) untracedReceiverReads = true;\n      }, () => withSignalTracking({ addDependency }, () =>\n        trace ? withConstrainedMeasurementTrace(trace, evaluate) : evaluate()));\n      entry = { props: element.props, key, result, mode: entryMode, dependencies, receiverDependencies, dependencyVersions: measurementDependencyVersions(dependencies), inputSnapshot,\n        ...(trace?.cacheable ? { receiverReceipts: trace.receipts } : {}) };\n      if (options && transaction && inputSnapshot && result.status === 'measured' && !untracedReceiverReads && (!trace || trace.cacheable)) {\n        if (!receivers) { receivers = new WeakMap(); intrinsicTransactions.set(transaction, receivers); }\n        if (!entries) { entries = new Map(); receivers.set(options.token, entries); }\n        entries.set(key, entry);\n        const snapshot = entry;\n        transaction.onFinish(success => { if (success) options.cache.writePrimitiveMeasurement(options.token, snapshot); });\n      }\n    }\n    if (prepared && entry.receiverReceipts) {\n      for (let index = 0; index < entry.receiverReceipts.length; index++) {\n        const captured = entry.receiverReceipts[index];\n        replayReceiverInputProvision(transaction, prepared.receivers[captured.childIndex], captured.receipt);\n      }\n    }\n    for (const node of entry.receiverDependencies ?? entry.dependencies) trackSignalDependency(node, 'measurement');\n    return entry.result as IntrinsicSizesResult | MeasureResult;\n  }))));\n}\n\ninterface MeasurementContext {\n  active: Set<PibblElement<any>>;\n  stack: PibblElement<any>[];\n}\n\n// Present only while a primitive measurement callback is evaluating. Flex uses this\n// continuation for its explicitly admitted paired structural child, so the child\n// shares the caller's cycle stack and receives provider inputs with measurement\n// dependency tracking. Ordinary `input.measureElement` remains unchanged.\nlet constrainedChildContext: MeasurementContext | undefined;\nlet constrainedChildService: CanvasMeasurementService | undefined;\ninterface ConstrainedMeasurementReceipt {\n  readonly childIndex: number;\n  readonly receipt: ReceiverInputProvisionReceipt;\n}\nexport interface ConstrainedMeasurementTrace {\n  cacheable: boolean;\n  readonly receipts: ConstrainedMeasurementReceipt[];\n  readonly receivers: readonly object[];\n}\nlet constrainedMeasurementTrace: ConstrainedMeasurementTrace | undefined;\n/** @internal Binds one direct known-row provider trace without retaining receiver tokens. */\nexport function withConstrainedMeasurementTrace<T>(trace: ConstrainedMeasurementTrace, work: () => T): T {\n  const previous = constrainedMeasurementTrace;\n  constrainedMeasurementTrace = trace;\n  try { return work(); }\n  finally { constrainedMeasurementTrace = previous; }\n}\ninterface ExactDirectDemand {\n  readonly type: Function;\n  readonly service: CanvasMeasurementService;\n  readonly key: readonly unknown[];\n  readonly inputs: readonly unknown[];\n  readonly receipt: ReceiverInputProvisionReceipt;\n  readonly dependencies: readonly SignalNode<unknown>[];\n  readonly dependencyVersions: readonly number[];\n  readonly result: MeasureResult | BaselinesResult;\n}\nconst exactDirectDemands = new WeakMap<object, WeakMap<object, ExactDirectDemand>>();\n\n// A failed allocation equality barrier may demand the same pure query again.\n// Share only current transaction/receiver numeric demands, never an old program.\nfunction exactDirectMeasurement<T extends MeasureResult | BaselinesResult>(\n  element: PibblElement<any>, service: CanvasMeasurementService, key: readonly unknown[], run: () => T, allowHit = true,\n): T {\n  const transaction = GLOBAL_STATE.renderTransaction, receiver = getPrimitiveReceiverToken(element);\n  if (!transaction || !receiver || Object.hasOwn(element.props, 'children') || isLayoutComponent(element.type)) return run();\n  const inputs = peekPreNormalizedStyle(element) ? intrinsicInputSnapshot(element) : undefined;\n  const demands = exactDirectDemands.get(transaction), prior = demands?.get(receiver);\n  if (allowHit && inputs && prior && prior.type === element.type && sameCanvasMeasurementService(prior.service, service) &&\n      sameIntrinsicInputs(prior.key, key) && sameIntrinsicInputs(prior.inputs, inputs) && measurementDependenciesUnchanged(prior)) {\n    takePreNormalizedStyle(element);\n    replayReceiverInputProvision(transaction, receiver, prior.receipt);\n    return prior.result as T;\n  }\n  let direct = true;\n  const receipt: { node: SignalNode<unknown>; roles: number }[] = [];\n  const replayRevision = allocationQueryReplayRevision(), volatility = allocationQueryVolatilityRevision();\n  const captured = observeReceiverInputReads((node, roles, owner) => {\n    if (owner !== receiver) { direct = false; return; }\n    const existing = receipt.find(entry => entry.node === node);\n    if (existing) existing.roles |= roles;\n    else receipt.push({ node, roles });\n  }, () => captureReceiverInputProvision(transaction, receiver, run));\n  if (inputs && direct && replayRevision === allocationQueryReplayRevision() && volatility === allocationQueryVolatilityRevision() && captured.receipt && captured.value.status === 'measured') {\n    let current = demands;\n    if (!current) {\n      current = new WeakMap(); exactDirectDemands.set(transaction, current);\n      transaction.onFinish(() => exactDirectDemands.delete(transaction));\n    }\n    const dependencies = receipt.map(entry => entry.node);\n    current.set(receiver, { type: element.type, service, key, inputs, receipt, dependencies,\n      dependencyVersions: measurementDependencyVersions(dependencies), result: captured.value });\n  }\n  return captured.value;\n}\n\nexport function measureConstrainedLayoutChild(\n  element: PibblElement<any>,\n  constraints: Readonly<Constraints>,\n  childIndex?: number,\n): MeasureResult {\n  const context = constrainedChildContext, service = constrainedChildService;\n  if (!context || !service) throw new Error('Constrained structural measurement requires an active provider measurement.');\n  const transaction = GLOBAL_STATE.renderTransaction;\n  const receiver = getPrimitiveReceiverToken(element);\n  const trace = constrainedMeasurementTrace;\n  const run = () => withSignalDependencyRole('measurement', () =>\n    measureElementInternal(element, constraints, service, context, false, true));\n  // The structural tracer has no indexed leaf path for this native continuation.\n  if (transaction && receiver && childIndex === undefined && !Object.hasOwn(element.props, 'children') && !isLayoutComponent(element.type)) {\n    if (trace) trace.cacheable = false;\n    const metadata = getElementMetadata(element);\n    const source = metadata?.policyPreparationSource ?? metadata?.layoutDescriptionSource ?? peekPreNormalizedStyle(element)?.source ?? element;\n    return exactDirectMeasurement(element, service,\n      ['size', getStyleMeasurementMode(), constraints.minWidth, constraints.maxWidth, constraints.minHeight, constraints.maxHeight],\n      run, !context.active.has(source));\n  }\n  if (!trace) return withReceiverInputProvision(transaction, receiver, run);\n  if (childIndex === undefined || trace.receivers[childIndex] !== receiver) {\n    trace.cacheable = false;\n    return withReceiverInputProvision(transaction, receiver, run);\n  }\n  const captured = captureReceiverInputProvision(transaction, receiver, run);\n  if (captured.receipt === undefined) trace.cacheable = false;\n  else trace.receipts.push({ childIndex, receipt: captured.receipt });\n  return captured.value;\n}\n\nfunction measureElementInternal(element: PibblElement<any>, constraints: Readonly<Constraints>, service: CanvasMeasurementService, context: MeasurementContext, intrinsic: true): IntrinsicSizesResult;\nfunction measureElementInternal(element: PibblElement<any>, constraints: Readonly<Constraints>, service: CanvasMeasurementService, context: MeasurementContext, intrinsic?: false, providerInputs?: boolean): MeasureResult;\nfunction measureElementInternal(\n  element: PibblElement<any>,\n  constraints: Readonly<Constraints>,\n  service: CanvasMeasurementService,\n  context: MeasurementContext,\n  intrinsic = false,\n  providerInputs = false,\n): MeasureResult | IntrinsicSizesResult {\n  element = prepareElementPolicies(element, 'measureElement');\n  recordLayoutMeasurement();\n  const type = element.type;\n  const definition = getPrimitiveDefinition(type);\n  const component = type.name || 'Anonymous';\n  const preNormalized = takePreNormalizedStyle(element);\n  const metadata = getElementMetadata(element);\n  const source = metadata?.policyPreparationSource ?? metadata?.layoutDescriptionSource ??\n    preNormalized?.source ??\n    element;\n  if (context.active.has(source)) {\n    throw layoutDiagnostic({\n      component,\n      property: 'measurement',\n      value: context.stack.map(item => item.type.name || 'Anonymous'),\n      algorithm: 'measurement',\n      constraints,\n      reason: 'cyclic measurement dependency is not supported',\n    });\n  }\n  if (isLayoutComponent(type)) {\n    context.active.add(source);\n    context.stack.push(element);\n    try {\n      // A declared layout description is the existing pure boundary. Preserve the\n      // caller's measurement mode so a paired primitive root can contribute its\n      // intrinsic result or receive provider inputs under the same transaction.\n      const root = placedLayoutComponentRoot(element, preNormalized);\n      return withReceiverInputProvision(GLOBAL_STATE.renderTransaction, getPrimitiveReceiverToken(root), () => intrinsic ?\n        measureElementInternal(root, constraints, service, context, true) :\n        measureElementInternal(root, constraints, service, context, false, providerInputs));\n    } finally {\n      context.stack.pop();\n      context.active.delete(source);\n    }\n  }\n  if (intrinsic ? !definition?.measureIntrinsic : !definition?.measure) {\n    return {\n      status: 'unsupported',\n      reason: `${component} does not provide ${intrinsic ? 'intrinsic measurement' : 'measurement'}`,\n    };\n  }\n\n  context.active.add(source);\n  context.stack.push(element);\n  try {\n    if (preNormalized?.query && getStyleMeasurementMode() !== 'standalone-root') {\n      rejectResponsiveMeasurement(element);\n    }\n    const readInputs = () => resolvePrimitiveInputs(element, definition!, preNormalized, {\n      width: constraints.maxWidth, height: constraints.maxHeight,\n    });\n    const inputs = intrinsic || providerInputs ? readInputs() : untracked(readInputs);\n    const specifiedStyle = withoutSystemFilter(\n      preNormalized?.style ?? inputs.style ?? EMPTY_STYLE,\n    );\n    let normalized = preNormalized ?\n        specifiedStyle :\n      definition!.normalizeStyle ?\n          definition!.normalizeStyle!(specifiedStyle) :\n          specifiedStyle;\n    if (hasPercentageBoxPadding(normalized as Readonly<BoxStyle>)) return { status: 'unsupported', reason: 'percentage padding requires an actual finite Flex owner allocation' };\n    if ('boxSizing' in normalized && normalized.boxSizing !== undefined) normalized = contentBoxStyle(normalized as Readonly<BoxStyle>, { width: constraints.maxWidth, height: constraints.maxHeight, context: { component, algorithm: 'measurement', constraints } });\n    const previousReceiverToken = GLOBAL_STATE.primitiveReceiverToken;\n    GLOBAL_STATE.primitiveReceiverToken =\n      getPrimitiveReceiverToken(element) ?? createPrimitiveReceiverToken();\n    let result: MeasureResult | IntrinsicSizesResult;\n    const previousConstrainedChildContext = constrainedChildContext;\n    const previousConstrainedChildService = constrainedChildService;\n    if (!intrinsic) { constrainedChildContext = context; constrainedChildService = service; }\n    try {\n      result = withStyleMeasurement('recursive', () => intrinsic ? definition!.measureIntrinsic!({\n        props: inputs.props, style: normalized, service,\n        constraints: {\n          width: Number.isFinite(constraints.maxWidth) ? { kind: 'bounded', min: constraints.minWidth, max: constraints.maxWidth } : { kind: 'unbounded', min: constraints.minWidth },\n          height: Number.isFinite(constraints.maxHeight) ? { kind: 'bounded', min: constraints.minHeight, max: constraints.maxHeight } : { kind: 'unbounded', min: constraints.minHeight },\n        },\n      }) : definition!.measure!({\n        props: inputs.props,\n        style: normalized,\n        constraints,\n        service,\n        measureElement: (child, childConstraints) => {\n          // Public recursive queries have no direct-child receipt path. Preserve\n          // their ordinary measurement behavior without caching this aggregate.\n          if (constrainedMeasurementTrace) constrainedMeasurementTrace.cacheable = false;\n          const receiver = getPrimitiveReceiverToken(child);\n          const prepared = peekPreNormalizedStyle(child);\n          // Known layout providers pass current normalized children with an\n          // owned receiver path. Their props must join that receiver's receipt.\n          // Arbitrary public descriptors have no such replayable input proof.\n          if (!receiver || !prepared) declineUntracedAllocationQuery();\n          return receiver ? withReceiverInputProvision(GLOBAL_STATE.renderTransaction, receiver, () => withSignalDependencyRole('measurement', () =>\n            measureElementInternal(child, childConstraints, service, context, false, !!prepared))) : measureElementInternal(child, childConstraints, service, context);\n        },\n      }));\n    } finally {\n      constrainedChildContext = previousConstrainedChildContext;\n      constrainedChildService = previousConstrainedChildService;\n      GLOBAL_STATE.primitiveReceiverToken = previousReceiverToken;\n    }\n    if (result.status === 'unsupported') return result;\n    if ('minContent' in result) {\n      validateMeasuredSize(result.minContent.width, 'minContent.width', component, constraints);\n      validateMeasuredSize(result.minContent.height, 'minContent.height', component, constraints);\n      validateMeasuredSize(result.maxContent.width, 'maxContent.width', component, constraints);\n      validateMeasuredSize(result.maxContent.height, 'maxContent.height', component, constraints);\n      if (result.minContent.width > result.maxContent.width) throw layoutDiagnostic({ component, property: 'measureIntrinsic', value: result, algorithm: 'measurement', constraints, reason: 'min-content width must not exceed max-content width' });\n      return result;\n    }\n    validateMeasuredSize(result.size.width, 'width', component, constraints);\n    validateMeasuredSize(result.size.height, 'height', component, constraints);\n    return result;\n  } catch (error) {\n    if (error instanceof UnsupportedResponsiveMeasurement) {\n      return { status: 'unsupported', reason: error.message };\n    }\n    throw error;\n  } finally {\n    context.stack.pop();\n    context.active.delete(source);\n  }\n}\n\n/** @internal Shared pure measurement preparation; never lends a mounted render context. */\nexport function withIsolatedRenderState<T>(work: () => T): T {\n  const previousAllocationOwner = setAllocationOwner(allocationOwner());\n  const snapshot = {\n    currentPibblInstance: GLOBAL_STATE.currentPibblInstance,\n    componentRefs: GLOBAL_STATE.componentRefs,\n    canvas: GLOBAL_STATE.canvas,\n    componentIsMounting: GLOBAL_STATE.componentIsMounting,\n    componentHookIndex: GLOBAL_STATE.componentHookIndex,\n    renderContext: GLOBAL_STATE.renderContext,\n    primitiveReceiverToken: GLOBAL_STATE.primitiveReceiverToken,\n    seenIds: GLOBAL_STATE.seenIds,\n    seenKeys: GLOBAL_STATE.seenKeys,\n    clippingStack: GLOBAL_STATE.clippingStack,\n    layoutStack: GLOBAL_STATE.layoutStack,\n  };\n  GLOBAL_STATE.currentPibblInstance = undefined;\n  GLOBAL_STATE.componentRefs = undefined;\n  GLOBAL_STATE.canvas = undefined;\n  GLOBAL_STATE.componentIsMounting = false;\n  GLOBAL_STATE.componentHookIndex = 0;\n  GLOBAL_STATE.renderContext = undefined;\n  GLOBAL_STATE.primitiveReceiverToken = undefined;\n  GLOBAL_STATE.seenIds = undefined;\n  GLOBAL_STATE.seenKeys = undefined;\n  GLOBAL_STATE.clippingStack = [];\n  GLOBAL_STATE.layoutStack = undefined;\n  try {\n    return work();\n  } finally {\n    Object.assign(GLOBAL_STATE, snapshot);\n    setAllocationOwner(previousAllocationOwner);\n  }\n}\n\nfunction validateMeasuredSize(\n  value: number,\n  property: string,\n  component: string,\n  constraints: Readonly<Constraints>,\n): void {\n  if (!Number.isFinite(value) || value < 0) {\n    throw layoutDiagnostic({\n      component,\n      property,\n      value,\n      algorithm: 'measurement',\n      constraints,\n      reason: 'measured dimensions must be finite and nonnegative',\n    });\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/layout/overlay.js

@@ -1,4 +1,8 @@
-import { preparedStyleValue, preparedStyleQuery } from "../style/responsive.js";
+import { withAllocationCheckpoint, mountedAllocationCheckpointOwner } from "./allocation-checkpoint.js";
+import { hasPercentageBoxPadding, resolveAllocatedInsets } from "./box-insets.js";
+import { recordWasmAllocationPass, recordWasmAllocationItem, recordWasmAllocationCacheHit, nativeLayout } from "./wasm/region.js";
+import { registerKnownLayoutPreflight, claimPreparedLayoutPlan, stagePreparedLayoutPlan, prepareKnownLayoutDescendants, preparePlacedKnownLayout } from "./prepared-root.js";
+import { getStyleMeasurementMode, preparedStyleValue, preparedStyleQuery } from "../style/responsive.js";
 import { definePrimitive } from "../define-primitive.js";
 import { GLOBAL_STATE } from "../global-state.js";
 import { layoutDiagnostic } from "../style/diagnostics.js";
@@ -12,13 +16,16 @@ import {
   prepareDirectChildStyle,
   placeDirectChildren,
   resolveContainerBox,
-  resolveDirectChildBox
+  resolveDirectChildBox,
+  measureUnionIntrinsic
 } from "./absolute.js";
-import { pushLayoutBox } from "./context.js";
+import { pushLayoutBox, resolvePositionedContainingBox } from "./context.js";
 import { recordLayoutEvaluation } from "./diagnostics.js";
+import { assertSupportedChildPosition } from "./positioning-diagnostics.js";
+const OVERLAY_CONTAINING_BOX_STYLE = /* @__PURE__ */ Symbol("pibbl.overlay-containing-box-style");
 function renderOverlay(props, style, ctx) {
   wireStructuralEvents(props);
-  const children = prepareLayoutChildren(props.children, "Overlay");
+  const ordinaryChildren = nativeLayout ? void 0 : prepareLayoutChildren(props.children, "Overlay");
   recordLayoutEvaluation();
   const content = style.box.contentBox;
   ctx.translate(content.x, content.y);
@@ -28,45 +35,96 @@ function renderOverlay(props, style, ctx) {
     width: content.width,
     height: content.height
   });
-  const releaseLayout = pushLayoutBox(localContent);
+  const releaseLayout = pushLayoutBox(localContent, {
+    logicalOffset: content,
+    containingBlock: resolvePositionedContainingBox(
+      style[OVERLAY_CONTAINING_BOX_STYLE],
+      localContent,
+      "Overlay"
+    )
+  });
   GLOBAL_STATE.componentRefs.onAfterRender = releaseLayout;
+  const prepared = nativeLayout ? claimPreparedLayoutPlan(GLOBAL_STATE.componentRefs.element, localContent) : void 0;
+  const children = prepared?.children ?? ordinaryChildren ?? prepareLayoutChildren(props.children, "Overlay");
+  const placements = prepared?.placements ?? (nativeLayout ? withAllocationCheckpoint(mountedAllocationCheckpointOwner(), { children, content: localContent, settings: style, onHit: recordWasmAllocationCacheHit, calculate: () => prepareOverlayPlacements(children, localContent, style) }) : void 0);
+  let placementIndex = 0;
   let occurrence = 0;
   return placeDirectChildren(
     children,
     localContent,
-    (child) => resolveOverlayChildPlacement(
-      localContent,
-      child,
-      style,
-      getChildPrimitiveReceiverToken(
-        GLOBAL_STATE.renderTransaction,
-        GLOBAL_STATE.primitiveReceiverToken,
-        occurrence++
-      )
-    ),
+    (child, childOccurrence) => {
+      const placement = placements ? placements[placementIndex++] : resolveOverlayChildPlacement(localContent, child, style, getChildPrimitiveReceiverToken(GLOBAL_STATE.renderTransaction, GLOBAL_STATE.primitiveReceiverToken, occurrence++));
+      if (nativeLayout && !prepared) preparePlacedKnownLayout(placement.element, childOccurrence);
+      return placement;
+    },
     style.overflow
   );
 }
 const Overlay = definePrimitive(renderOverlay, {
   childInput: "structural",
-  resolveStyle: (style, context) => ({
-    box: resolveContainerBox(style, context, "Overlay", "overlay"),
-    overflow: style.overflow ?? "visible",
-    alignItems: style.alignItems ?? "stretch",
-    justifyItems: style.justifyItems ?? "stretch"
-  })
+  resolveStyle: (style, context) => {
+    if (nativeLayout && hasPercentageBoxPadding(style)) {
+      style = resolveAllocatedInsets(style, {
+        width: context.percentageBasis.width,
+        context: { ...context, component: "Overlay", algorithm: "overlay" }
+      });
+    }
+    return {
+      box: resolveContainerBox(style, context, "Overlay", "overlay"),
+      [OVERLAY_CONTAINING_BOX_STYLE]: style,
+      overflow: style.overflow ?? "visible",
+      alignItems: style.alignItems ?? "stretch",
+      justifyItems: style.justifyItems ?? "stretch"
+    };
+  },
+  measureIntrinsic: (input) => measureUnionIntrinsic(input, "Overlay")
+});
+function prepareOverlayPlacements(children, content, alignment) {
+  recordWasmAllocationPass();
+  const placements = new Array(children.length);
+  for (let index = 0; index < children.length; index++) {
+    recordWasmAllocationItem();
+    placements[index] = resolveOverlayChildPlacement(content, children[index], alignment, getChildPrimitiveReceiverToken(GLOBAL_STATE.renderTransaction, GLOBAL_STATE.primitiveReceiverToken, index));
+  }
+  return placements;
+}
+if (nativeLayout) registerKnownLayoutPreflight(Overlay, (element, style, content, receiver, slot) => {
+  const previous = GLOBAL_STATE.primitiveReceiverToken;
+  GLOBAL_STATE.primitiveReceiverToken = receiver;
+  const releaseLayout = pushLayoutBox(content, {
+    containingBlock: resolvePositionedContainingBox(
+      style,
+      content,
+      "Overlay"
+    )
+  });
+  try {
+    const children = prepareLayoutChildren(element.props.children, "Overlay");
+    const plan = { content, children, placements: withAllocationCheckpoint(slot, { children, content, settings: style, onHit: recordWasmAllocationCacheHit, calculate: () => prepareOverlayPlacements(children, content, style) }) };
+    prepareKnownLayoutDescendants(plan, slot);
+    stagePreparedLayoutPlan(slot, plan);
+  } finally {
+    releaseLayout();
+    GLOBAL_STATE.primitiveReceiverToken = previous;
+  }
 });
 function placeOverlayChild(container, child, alignment = {}) {
   return resolveOverlayChildPlacement(container, child, alignment).box;
 }
 function resolveOverlayChildPlacement(container, child, alignment = {}, receiverToken) {
   const prepared = prepareDirectChildStyle(child, receiverToken, container);
-  const item = preparedStyleValue(prepared);
+  let item = preparedStyleValue(prepared);
+  if (nativeLayout && GLOBAL_STATE.currentPibblInstance && getStyleMeasurementMode() === void 0 && hasPercentageBoxPadding(item)) {
+    item = resolveAllocatedInsets(item, { width: container.width, context: { component: child.type.name || "Anonymous", algorithm: "overlay" } });
+  }
+  assertSupportedChildPosition("Overlay", child, item, false, false);
   const resolved = resolveDirectChildBox(
     container,
     child,
     "overlay",
-    item
+    item,
+    void 0,
+    receiverToken
   );
   const declaredBox = resolved.borderBox;
   const horizontal = resolveItemAlignment(

package/dist/lib/layout/overlay.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/layout/overlay.ts"],
-  "sourcesContent": ["import { preparedStyleValue, preparedStyleQuery } from '../style/responsive.js';\nimport { definePrimitive } from '../define-primitive.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport { layoutDiagnostic } from '../style/diagnostics.js';\nimport {\n  type PibblStructuralEventProps,\n  wireStructuralEvents,\n} from '../components/structural-events.js';\nimport type { BoxStyle, LayoutItemStyle, ResolvedBoxStyle } from '../style/types.js';\nimport type {\n  PibblNodeInput,\n  RenderingContext2D,\n  SystemStyle,\n} from '../types.js';\nimport type { PibblElement } from '../element/types.js';\nimport { getChildPrimitiveReceiverToken } from '../element/metadata.js';\nimport {\n  childWithUsedSize,\n  prepareLayoutChildren,\n  prepareDirectChildStyle,\n  placeDirectChildren,\n  resolveContainerBox,\n  resolveDirectChildBox,\n} from './absolute.js';\nimport { pushLayoutBox } from './context.js';\nimport { recordLayoutEvaluation } from './diagnostics.js';\nimport type { LayoutBox } from './types.js';\n\ntype OverlayAlignment = 'start' | 'center' | 'end' | 'stretch';\n\n/**\n * Supported geometry and presentation properties for Overlay.\n *\n * @see {@link BoxStyle}\n * @see {@link LayoutItemStyle}\n * @see {@link Overlay}\n */\nexport interface OverlayStyle extends BoxStyle, LayoutItemStyle {\n  /** Default alignment of children on the cross or block axis. See {@link OverlayAlignment}. */\n  alignItems?: OverlayAlignment;\n  /** Default inline-axis alignment of grid or overlay children. See {@link OverlayAlignment}. */\n  justifyItems?: OverlayAlignment;\n}\n\n/**\n * Authored inputs for Overlay, including the declared data and presentation options.\n *\n * @see {@link PibblNodeInput}\n * @see {@link Overlay}\n */\nexport interface OverlayProps extends PibblStructuralEventProps {\n  /** Descendant content or the callback that supplies it. See {@link PibblNodeInput}. */\n  children: PibblNodeInput;\n}\n\ninterface ResolvedOverlayStyle extends SystemStyle {\n  box: ResolvedBoxStyle;\n  overflow: 'visible' | 'clip';\n  alignItems: OverlayAlignment;\n  justifyItems: OverlayAlignment;\n}\n\nfunction renderOverlay(\n  props: OverlayProps,\n  style: Readonly<ResolvedOverlayStyle>,\n  ctx: RenderingContext2D,\n) {\n  wireStructuralEvents(props);\n  const children = prepareLayoutChildren(props.children, 'Overlay');\n  recordLayoutEvaluation();\n  const content = style.box.contentBox;\n  ctx.translate(content.x, content.y);\n  const localContent = Object.freeze({\n    x: 0,\n    y: 0,\n    width: content.width,\n    height: content.height,\n  });\n  const releaseLayout = pushLayoutBox(localContent);\n  GLOBAL_STATE.componentRefs!.onAfterRender = releaseLayout;\n\n  let occurrence = 0;\n  return placeDirectChildren(\n    children,\n    localContent,\n    child => resolveOverlayChildPlacement(\n      localContent,\n      child,\n      style,\n      getChildPrimitiveReceiverToken(\n        GLOBAL_STATE.renderTransaction,\n        GLOBAL_STATE.primitiveReceiverToken,\n        occurrence++,\n      ),\n    ),\n    style.overflow,\n  );\n}\n\n/**\n * Describes overlay layout for JSX or createElement authoring.\n *\n * @param props - Authored component inputs, supplied through JSX or createElement. See the linked\n * props and style types.\n * @throws When called directly; Pibbl mounts this component through JSX or createElement.\n *\n * @see {@link OverlayProps}\n * @see {@link OverlayStyle}\n */\nexport const Overlay = definePrimitive<\n  OverlayProps,\n  OverlayStyle,\n  OverlayStyle,\n  ResolvedOverlayStyle\n>(renderOverlay, {\n  childInput: 'structural',\n  resolveStyle: (style, context) => ({\n    box: resolveContainerBox(style, context, 'Overlay', 'overlay'),\n    overflow: style.overflow ?? 'visible',\n    alignItems: style.alignItems ?? 'stretch',\n    justifyItems: style.justifyItems ?? 'stretch',\n  }),\n});\n\nexport function placeOverlayChild(\n  container: Readonly<LayoutBox>,\n  child: PibblElement<any>,\n  alignment: Readonly<Pick<OverlayStyle, 'alignItems' | 'justifyItems'>> = {},\n): LayoutBox {\n  return resolveOverlayChildPlacement(container, child, alignment).box;\n}\n\nfunction resolveOverlayChildPlacement(\n  container: Readonly<LayoutBox>,\n  child: PibblElement<any>,\n  alignment: Readonly<Pick<OverlayStyle, 'alignItems' | 'justifyItems'>> = {},\n  receiverToken?: object,\n): { box: LayoutBox; element: PibblElement<any> } {\n  const prepared = prepareDirectChildStyle(child, receiverToken, container);\n  const item = preparedStyleValue(prepared) as Readonly<\n    BoxStyle & LayoutItemStyle\n  >;\n  const resolved = resolveDirectChildBox(\n    container,\n    child,\n    'overlay',\n    item,\n  );\n  const declaredBox = resolved.borderBox;\n  const horizontal = resolveItemAlignment(\n    item.justifySelf,\n    alignment.justifyItems ?? 'stretch',\n    child,\n    container,\n    'justifySelf',\n  );\n  const vertical = resolveItemAlignment(\n    item.alignSelf,\n    alignment.alignItems ?? 'stretch',\n    child,\n    container,\n    'alignSelf',\n  );\n  const x = alignAxis(\n    container.x,\n    container.width,\n    declaredBox.width,\n    horizontal,\n  );\n  const y = alignAxis(\n    container.y,\n    container.height,\n    declaredBox.height,\n    vertical,\n  );\n  const box = {\n    x,\n    y,\n    width: horizontal === 'stretch' ?\n        Math.max(0, container.width) :\n        declaredBox.width,\n    height: vertical === 'stretch' ?\n        Math.max(0, container.height) :\n        declaredBox.height,\n  };\n  const horizontalPadding = declaredBox.width - resolved.contentBox.width;\n  const verticalPadding = declaredBox.height - resolved.contentBox.height;\n  return {\n    box,\n    element: childWithUsedSize(\n      child,\n      item,\n      Math.max(0, box.width - horizontalPadding),\n      Math.max(0, box.height - verticalPadding),\n      receiverToken,\n      preparedStyleQuery(prepared),\n    ),\n  };\n}\n\nfunction resolveItemAlignment(\n  item: LayoutItemStyle['alignSelf'] | LayoutItemStyle['justifySelf'],\n  fallback: OverlayAlignment,\n  child: PibblElement<any>,\n  container: Readonly<LayoutBox>,\n  property: 'alignSelf' | 'justifySelf',\n): OverlayAlignment {\n  if (item === undefined || item === 'auto') return fallback;\n  if (item === 'start' || item === 'center' || item === 'end' || item === 'stretch') {\n    return item;\n  }\n  throw layoutDiagnostic({\n    component: child.type.name || 'Anonymous',\n    property,\n    value: item,\n    algorithm: 'overlay',\n    constraints: {\n      minWidth: 0,\n      maxWidth: container.width,\n      minHeight: 0,\n      maxHeight: container.height,\n    },\n    reason: 'uses an unsupported overlay alignment value',\n  });\n}\n\nfunction alignAxis(\n  start: number,\n  available: number,\n  size: number,\n  alignment: OverlayAlignment,\n): number {\n  switch (alignment) {\n    case 'center': return start + (available - size) / 2;\n    case 'end': return start + available - size;\n    default: return start;\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { withAllocationCheckpoint, mountedAllocationCheckpointOwner } from './allocation-checkpoint.js';\nimport { hasPercentageBoxPadding, resolveAllocatedInsets } from './box-insets.js';\nimport { recordWasmAllocationPass, recordWasmAllocationItem, recordWasmAllocationCacheHit, nativeLayout } from './wasm/region.js';\nimport { registerKnownLayoutPreflight, claimPreparedLayoutPlan, stagePreparedLayoutPlan, prepareKnownLayoutDescendants, preparePlacedKnownLayout, type PreparedLayoutPlan } from './prepared-root.js';\nimport { getStyleMeasurementMode, preparedStyleValue, preparedStyleQuery } from '../style/responsive.js';\nimport { definePrimitive } from '../define-primitive.js';\nimport { GLOBAL_STATE } from '../global-state.js';\nimport { layoutDiagnostic } from '../style/diagnostics.js';\nimport {\n  type PibblStructuralEventProps,\n  wireStructuralEvents,\n} from '../components/structural-events.js';\nimport type { BoxStyle, LayoutItemStyle, ResolvedBoxStyle } from '../style/types.js';\nimport type {\n  PibblNodeInput,\n  RenderingContext2D,\n  SystemStyle,\n} from '../types.js';\nimport type { PibblElement } from '../element/types.js';\nimport { getChildPrimitiveReceiverToken } from '../element/metadata.js';\nimport {\n  childWithUsedSize,\n  prepareLayoutChildren,\n  prepareDirectChildStyle,\n  placeDirectChildren,\n  resolveContainerBox,\n  resolveDirectChildBox,\n  measureUnionIntrinsic,\n} from './absolute.js';\nimport { pushLayoutBox, resolvePositionedContainingBox } from './context.js';\nimport { recordLayoutEvaluation } from './diagnostics.js';\nimport { assertSupportedChildPosition } from './positioning-diagnostics.js';\nimport type { LayoutBox } from './types.js';\n\ntype OverlayAlignment = 'start' | 'center' | 'end' | 'stretch';\n\n/**\n * Supported geometry and presentation properties for Overlay.\n *\n * @see {@link BoxStyle}\n * @see {@link LayoutItemStyle}\n * @see {@link Overlay}\n */\nexport interface OverlayStyle extends BoxStyle, LayoutItemStyle {\n  /** Default alignment of children on the cross or block axis. See {@link OverlayAlignment}. */\n  alignItems?: OverlayAlignment;\n  /** Default inline-axis alignment of grid or overlay children. See {@link OverlayAlignment}. */\n  justifyItems?: OverlayAlignment;\n}\n\n/**\n * Authored inputs for Overlay, including the declared data and presentation options.\n *\n * @see {@link PibblNodeInput}\n * @see {@link Overlay}\n */\nexport interface OverlayProps extends PibblStructuralEventProps {\n  /** Descendant content or the callback that supplies it. See {@link PibblNodeInput}. */\n  children: PibblNodeInput;\n}\n\n// Parent input is private metadata, not a recursively validated resolved value.\nconst OVERLAY_CONTAINING_BOX_STYLE = Symbol('pibbl.overlay-containing-box-style');\n\ninterface ResolvedOverlayStyle extends SystemStyle {\n  box: ResolvedBoxStyle;\n  [OVERLAY_CONTAINING_BOX_STYLE]: Readonly<OverlayStyle>;\n  overflow: 'visible' | 'clip';\n  alignItems: OverlayAlignment;\n  justifyItems: OverlayAlignment;\n}\n\nfunction renderOverlay(\n  props: OverlayProps,\n  style: Readonly<ResolvedOverlayStyle>,\n  ctx: RenderingContext2D,\n) {\n  wireStructuralEvents(props);\n  const ordinaryChildren = nativeLayout ? undefined : prepareLayoutChildren(props.children, 'Overlay');\n  recordLayoutEvaluation();\n  const content = style.box.contentBox;\n  ctx.translate(content.x, content.y);\n  const localContent = Object.freeze({\n    x: 0,\n    y: 0,\n    width: content.width,\n    height: content.height,\n  });\n  const releaseLayout = pushLayoutBox(localContent, {\n    logicalOffset: content,\n    containingBlock: resolvePositionedContainingBox(\n      style[OVERLAY_CONTAINING_BOX_STYLE],\n      localContent,\n      'Overlay',\n    ),\n  });\n  GLOBAL_STATE.componentRefs!.onAfterRender = releaseLayout;\n\n  const prepared = nativeLayout ? claimPreparedLayoutPlan(GLOBAL_STATE.componentRefs!.element, localContent) : undefined;\n  const children = prepared?.children ?? ordinaryChildren ?? prepareLayoutChildren(props.children, 'Overlay');\n  const placements = prepared?.placements ?? (nativeLayout ? withAllocationCheckpoint(mountedAllocationCheckpointOwner(), { children, content: localContent, settings: style, onHit: recordWasmAllocationCacheHit, calculate: () => prepareOverlayPlacements(children, localContent, style) }) : undefined);\n  let placementIndex = 0;\n  let occurrence = 0;\n  return placeDirectChildren(\n    children,\n    localContent,\n    (child, childOccurrence) => {\n      const placement = placements ? placements[placementIndex++] : resolveOverlayChildPlacement(localContent, child, style, getChildPrimitiveReceiverToken(GLOBAL_STATE.renderTransaction, GLOBAL_STATE.primitiveReceiverToken, occurrence++));\n      if (nativeLayout && !prepared) preparePlacedKnownLayout(placement.element, childOccurrence);\n      return placement;\n    },\n    style.overflow,\n  );\n}\n\n/**\n * Describes overlay layout for JSX or createElement authoring.\n *\n * @param props - Authored component inputs, supplied through JSX or createElement. See the linked\n * props and style types.\n * @throws When called directly; Pibbl mounts this component through JSX or createElement.\n *\n * @see {@link OverlayProps}\n * @see {@link OverlayStyle}\n */\nexport const Overlay = definePrimitive<\n  OverlayProps,\n  OverlayStyle,\n  OverlayStyle,\n  ResolvedOverlayStyle\n>(renderOverlay, {\n  childInput: 'structural',\n  resolveStyle: (style, context) => {\n    if (nativeLayout && hasPercentageBoxPadding(style)) {\n      style = resolveAllocatedInsets(style, { width: context.percentageBasis.width,\n        context: { ...context, component: 'Overlay', algorithm: 'overlay' } });\n    }\n    return {\n      box: resolveContainerBox(style, context, 'Overlay', 'overlay'),\n      [OVERLAY_CONTAINING_BOX_STYLE]: style,\n      overflow: style.overflow ?? 'visible',\n      alignItems: style.alignItems ?? 'stretch',\n      justifyItems: style.justifyItems ?? 'stretch',\n    };\n  },\n  measureIntrinsic: (input) => measureUnionIntrinsic(input, 'Overlay'),\n});\n\nfunction prepareOverlayPlacements(children: readonly PibblElement<any>[], content: Readonly<LayoutBox>, alignment: Readonly<Pick<OverlayStyle, 'alignItems' | 'justifyItems'>>): { box: LayoutBox; element: PibblElement<any> }[] {\n  recordWasmAllocationPass();\n  const placements = new Array<{ box: LayoutBox; element: PibblElement<any> }>(children.length);\n  for (let index = 0; index < children.length; index++) {\n    recordWasmAllocationItem();\n    placements[index] = resolveOverlayChildPlacement(content, children[index], alignment, getChildPrimitiveReceiverToken(GLOBAL_STATE.renderTransaction, GLOBAL_STATE.primitiveReceiverToken, index));\n  }\n  return placements;\n}\nif (nativeLayout) registerKnownLayoutPreflight(Overlay, (element, style, content, receiver, slot) => {\n  // The registry owns this structural slot; Overlay needs no numeric arena.\n  const previous = GLOBAL_STATE.primitiveReceiverToken;\n  GLOBAL_STATE.primitiveReceiverToken = receiver;\n  const releaseLayout = pushLayoutBox(content, {\n    containingBlock: resolvePositionedContainingBox(\n      style as Readonly<OverlayStyle>,\n      content,\n      'Overlay',\n    ),\n  });\n  try {\n    const children = prepareLayoutChildren(element.props.children, 'Overlay');\n    const plan: PreparedLayoutPlan = { content, children, placements: withAllocationCheckpoint(slot, { children, content, settings: style, onHit: recordWasmAllocationCacheHit, calculate: () => prepareOverlayPlacements(children, content, style as Readonly<OverlayStyle>) }) };\n    prepareKnownLayoutDescendants(plan, slot);\n    stagePreparedLayoutPlan(slot, plan);\n  } finally {\n    releaseLayout();\n    GLOBAL_STATE.primitiveReceiverToken = previous;\n  }\n});\n\nexport function placeOverlayChild(\n  container: Readonly<LayoutBox>,\n  child: PibblElement<any>,\n  alignment: Readonly<Pick<OverlayStyle, 'alignItems' | 'justifyItems'>> = {},\n): LayoutBox {\n  return resolveOverlayChildPlacement(container, child, alignment).box;\n}\n\nfunction resolveOverlayChildPlacement(\n  container: Readonly<LayoutBox>,\n  child: PibblElement<any>,\n  alignment: Readonly<Pick<OverlayStyle, 'alignItems' | 'justifyItems'>> = {},\n  receiverToken?: object,\n): { box: LayoutBox; element: PibblElement<any> } {\n  const prepared = prepareDirectChildStyle(child, receiverToken, container);\n  let item = preparedStyleValue(prepared) as Readonly<\n    BoxStyle & LayoutItemStyle\n  >;\n  if (nativeLayout && GLOBAL_STATE.currentPibblInstance && getStyleMeasurementMode() === undefined && hasPercentageBoxPadding(item)) {\n    item = resolveAllocatedInsets(item, { width: container.width, context: { component: child.type.name || 'Anonymous', algorithm: 'overlay' } });\n  }\n  assertSupportedChildPosition('Overlay', child, item, false, false);\n  const resolved = resolveDirectChildBox(\n    container,\n    child,\n    'overlay',\n    item,\n    undefined,\n    receiverToken,\n  );\n  const declaredBox = resolved.borderBox;\n  const horizontal = resolveItemAlignment(\n    item.justifySelf,\n    alignment.justifyItems ?? 'stretch',\n    child,\n    container,\n    'justifySelf',\n  );\n  const vertical = resolveItemAlignment(\n    item.alignSelf,\n    alignment.alignItems ?? 'stretch',\n    child,\n    container,\n    'alignSelf',\n  );\n  const x = alignAxis(\n    container.x,\n    container.width,\n    declaredBox.width,\n    horizontal,\n  );\n  const y = alignAxis(\n    container.y,\n    container.height,\n    declaredBox.height,\n    vertical,\n  );\n  const box = {\n    x,\n    y,\n    width: horizontal === 'stretch' ?\n        Math.max(0, container.width) :\n        declaredBox.width,\n    height: vertical === 'stretch' ?\n        Math.max(0, container.height) :\n        declaredBox.height,\n  };\n  const horizontalPadding = declaredBox.width - resolved.contentBox.width;\n  const verticalPadding = declaredBox.height - resolved.contentBox.height;\n  return {\n    box,\n    element: childWithUsedSize(\n      child,\n      item,\n      Math.max(0, box.width - horizontalPadding),\n      Math.max(0, box.height - verticalPadding),\n      receiverToken,\n      preparedStyleQuery(prepared),\n    ),\n  };\n}\n\nfunction resolveItemAlignment(\n  item: LayoutItemStyle['alignSelf'] | LayoutItemStyle['justifySelf'],\n  fallback: OverlayAlignment,\n  child: PibblElement<any>,\n  container: Readonly<LayoutBox>,\n  property: 'alignSelf' | 'justifySelf',\n): OverlayAlignment {\n  if (item === undefined || item === 'auto') return fallback;\n  if (item === 'start' || item === 'center' || item === 'end' || item === 'stretch') {\n    return item;\n  }\n  throw layoutDiagnostic({\n    component: child.type.name || 'Anonymous',\n    property,\n    value: item,\n    algorithm: 'overlay',\n    constraints: {\n      minWidth: 0,\n      maxWidth: container.width,\n      minHeight: 0,\n      maxHeight: container.height,\n    },\n    reason: 'uses an unsupported overlay alignment value',\n  });\n}\n\nfunction alignAxis(\n  start: number,\n  available: number,\n  size: number,\n  alignment: OverlayAlignment,\n): number {\n  switch (alignment) {\n    case 'center': return start + (available - size) / 2;\n    case 'end': return start + available - size;\n    default: return start;\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/layout/participation.d.ts

@@ -0,0 +1,27 @@
+import { type PreparedStyleInput } from '../style/resolve-dispatch.js';
+import type { PibblElement } from '../element/types.js';
+import type { PibblComponentRefs, PibblInstance } from '../types.js';
+export declare function registerContentsTransform(type: Function): void;
+export declare function isContentsTransform(type: Function): boolean;
+export interface LayoutSuspensionResource {
+    suspendLayout(): void;
+}
+export declare function registerLayoutSuspensionResource(refs: PibblComponentRefs<any>, resource: LayoutSuspensionResource): void;
+export declare function unregisterLayoutSuspensionResource(refs: PibblComponentRefs<any>, resource: LayoutSuspensionResource): void;
+export declare function isLayoutComponentSuspended(refs: PibblComponentRefs<any>): boolean;
+export declare function isLayoutInstanceSuspended(owner: PibblInstance): boolean;
+export declare function resumeLayoutComponent(refs: PibblComponentRefs<any>): void;
+/** Reads only the structural visibility input; hidden inputs never require measurement. */
+export declare function layoutParticipation(element: PibblElement<any>, preparedStyle?: PreparedStyleInput | null): 'normal' | 'hidden' | 'contents';
+export interface LayoutParticipationSource {
+    readonly element: PibblElement<any>;
+    readonly hidden: boolean;
+    readonly children?: readonly LayoutParticipationSource[];
+}
+/** Contents may expose only declared structural children, never an opaque component program. */
+export declare function contentsChildren(element: PibblElement<any>): readonly PibblElement<any>[];
+export declare function participatingLayoutChildren(source: readonly PibblElement<any>[]): readonly PibblElement<any>[];
+export declare function layoutParticipationPlan(children: readonly PibblElement<any>[]): readonly LayoutParticipationSource[] | undefined;
+/** Records mount ownership once; retaining a hidden subtree never scans unrelated mounts. */
+export declare function registerLayoutComponentMount(refs: PibblComponentRefs<any>): void;
+export declare function retainHiddenLayoutDescendants(refs: PibblComponentRefs<any>): void;

package/dist/lib/layout/participation.js

@@ -0,0 +1,188 @@
+import { peekPreNormalizedStyle } from "../style/resolve-dispatch.js";
+import { materializeContainerChildren } from "../element/children.js";
+import { isKnownLayoutType } from "./prepared-root.js";
+import { getSpecifiedStyle } from "../element/metadata.js";
+import { GLOBAL_STATE } from "../global-state.js";
+import { isSignal, getSignalNode, withSignalDependencyRole } from "../signals/graph.js";
+const contentsTransforms = /* @__PURE__ */ new WeakSet();
+function registerContentsTransform(type) {
+  contentsTransforms.add(type);
+}
+function isContentsTransform(type) {
+  return contentsTransforms.has(type);
+}
+const suspensionResources = /* @__PURE__ */ new WeakMap();
+function registerLayoutSuspensionResource(refs, resource) {
+  let resources = suspensionResources.get(refs);
+  if (!resources) {
+    resources = /* @__PURE__ */ new Set();
+    suspensionResources.set(refs, resources);
+  }
+  resources.add(resource);
+}
+function unregisterLayoutSuspensionResource(refs, resource) {
+  const resources = suspensionResources.get(refs);
+  resources?.delete(resource);
+  if (resources?.size === 0) suspensionResources.delete(refs);
+}
+const suspendedComponents = /* @__PURE__ */ new WeakSet();
+function isLayoutComponentSuspended(refs) {
+  return !refs.teardowns.closed && suspendedComponents.has(refs);
+}
+function isLayoutInstanceSuspended(owner) {
+  let current = owner;
+  while (current) {
+    if (current.eventParent && isLayoutComponentSuspended(current.eventParent)) return true;
+    current = current.parent ? GLOBAL_STATE.pibblInstances.get(current.parent) : void 0;
+  }
+  return false;
+}
+function resumeLayoutComponent(refs) {
+  suspendedComponents.delete(refs);
+}
+function participationStyle(element, preparedStyle) {
+  const prepared = preparedStyle === void 0 ? peekPreNormalizedStyle(element) : preparedStyle;
+  if (prepared) return prepared.style;
+  const specified = getSpecifiedStyle(element);
+  if (!isSignal(specified)) return specified;
+  const node = getSignalNode(specified);
+  node.validate?.();
+  const current = node.value;
+  return current && typeof current === "object" && current.layoutParticipation !== void 0 ? specified.get() : current;
+}
+const mountedChildren = /* @__PURE__ */ new WeakMap();
+function layoutParticipation(element, preparedStyle) {
+  const style = participationStyle(element, preparedStyle);
+  const input = style && typeof style === "object" ? style.layoutParticipation : void 0;
+  const value = isSignal(input) ? withSignalDependencyRole("layout", () => input.get()) : input;
+  if (value === void 0 || value === "normal") return "normal";
+  if (value === "hidden" || value === "contents") return value;
+  throw new TypeError(`${element.type.name || "Component"} style.layoutParticipation must be normal, hidden, or contents.`);
+}
+const participationPlans = /* @__PURE__ */ new WeakMap();
+function contentsChildren(element) {
+  if (!isContentsTransform(element.type) && !isKnownLayoutType(element.type)) {
+    throw new TypeError(`${element.type.name || "Component"} contents participation requires a built-in layout or Group with declared structural children.`);
+  }
+  const style = participationStyle(element);
+  if (style && typeof style === "object") {
+    const values = style;
+    rejectContentsBoxProperty(values, "width", element);
+    rejectContentsBoxProperty(values, "height", element);
+    rejectContentsBoxProperty(values, "minWidth", element);
+    rejectContentsBoxProperty(values, "maxWidth", element);
+    rejectContentsBoxProperty(values, "minHeight", element);
+    rejectContentsBoxProperty(values, "maxHeight", element);
+    rejectContentsBoxProperty(values, "boxSizing", element);
+    rejectContentsBoxProperty(values, "padding", element);
+    rejectContentsBoxProperty(values, "paddingStart", element);
+    rejectContentsBoxProperty(values, "paddingEnd", element);
+    rejectContentsBoxProperty(values, "borderWidth", element);
+    rejectContentsBoxProperty(values, "borderStartWidth", element);
+    rejectContentsBoxProperty(values, "borderEndWidth", element);
+    rejectContentsBoxProperty(values, "overflow", element);
+    rejectContentsBoxProperty(values, "filter", element);
+    rejectContentsBoxProperty(values, "position", element);
+    rejectContentsBoxProperty(values, "left", element);
+    rejectContentsBoxProperty(values, "right", element);
+    rejectContentsBoxProperty(values, "top", element);
+    rejectContentsBoxProperty(values, "bottom", element);
+    rejectContentsBoxProperty(values, "insetStart", element);
+    rejectContentsBoxProperty(values, "insetEnd", element);
+    rejectContentsBoxProperty(values, "margin", element);
+    rejectContentsBoxProperty(values, "marginTop", element);
+    rejectContentsBoxProperty(values, "marginRight", element);
+    rejectContentsBoxProperty(values, "marginBottom", element);
+    rejectContentsBoxProperty(values, "marginLeft", element);
+    rejectContentsBoxProperty(values, "marginStart", element);
+    rejectContentsBoxProperty(values, "marginEnd", element);
+  }
+  const input = element.props.children;
+  return materializeContainerChildren(input, element);
+}
+function participatingLayoutChildren(source) {
+  let needsPlan = false;
+  for (const element of source) if (layoutParticipation(element) !== "normal") {
+    needsPlan = true;
+    break;
+  }
+  if (!needsPlan) return source;
+  const leaves = [];
+  const visiting = /* @__PURE__ */ new Set();
+  const build = (sequence) => {
+    const result = [];
+    for (const element of sequence) {
+      const participation = layoutParticipation(element);
+      if (participation === "hidden") result.push({ element, hidden: true });
+      else if (participation === "contents") {
+        if (visiting.has(element)) throw new TypeError("Contents layout descriptors form a cycle.");
+        visiting.add(element);
+        try {
+          result.push({ element, hidden: false, children: build(contentsChildren(element)) });
+        } finally {
+          visiting.delete(element);
+        }
+      } else {
+        leaves.push(element);
+        result.push({ element, hidden: false });
+      }
+    }
+    return result;
+  };
+  participationPlans.set(leaves, build(source));
+  return leaves;
+}
+function layoutParticipationPlan(children) {
+  return participationPlans.get(children);
+}
+function registerLayoutComponentMount(refs) {
+  const parent = refs.parent;
+  if (!parent) return;
+  let children = mountedChildren.get(parent);
+  if (!children) {
+    children = /* @__PURE__ */ new Set();
+    mountedChildren.set(parent, children);
+  }
+  children.add(refs);
+  const owned = children;
+  refs.teardowns.add(() => {
+    owned.delete(refs);
+    if (!owned.size && mountedChildren.get(parent) === owned) mountedChildren.delete(parent);
+    mountedChildren.delete(refs);
+  });
+}
+function retainHiddenLayoutDescendants(refs) {
+  suspendedComponents.add(refs);
+  refs.renderGeneration = GLOBAL_STATE.currentPibblInstance.renderGeneration;
+  const resources = suspensionResources.get(refs);
+  if (resources) for (const resource of resources) resource.suspendLayout();
+  const children = mountedChildren.get(refs);
+  if (!children) return;
+  for (const child of children) {
+    if (child.teardowns.closed) continue;
+    GLOBAL_STATE.seenIds.add(child.id);
+    retainHiddenLayoutDescendants(child);
+  }
+}
+function rejectContentsBoxProperty(style, property, element) {
+  const input = style[property];
+  if ((isSignal(input) ? input.get() : input) !== void 0) {
+    throw new TypeError(`${element.type.name} style.${property} requires a box and is incompatible with contents participation.`);
+  }
+}
+export {
+  contentsChildren,
+  isContentsTransform,
+  isLayoutComponentSuspended,
+  isLayoutInstanceSuspended,
+  layoutParticipation,
+  layoutParticipationPlan,
+  participatingLayoutChildren,
+  registerContentsTransform,
+  registerLayoutComponentMount,
+  registerLayoutSuspensionResource,
+  resumeLayoutComponent,
+  retainHiddenLayoutDescendants,
+  unregisterLayoutSuspensionResource
+};
+//# sourceMappingURL=participation.js.map