@pibbl/core 0.0.2 → 0.0.3-alpha.109.1

package/dist/lib/signals/render-consumer.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/signals/render-consumer.ts"],
-  "sourcesContent": ["import {\n  recordRendererConsumerCreated,\n  recordRendererConsumerReleased,\n  recordRendererEdgeCreated,\n  recordRendererEdgeReleased,\n  recordRendererEdgeReused,\n  recordLazyRendererConsumerCreated,\n  type SignalDependencyCollector,\n  type SignalNode,\n  withSignalTracking,\n} from './graph.js';\nimport {\n  beginReactiveCollection,\n  collectReactiveDependency,\n  disposeReactiveConsumer,\n  finishReactiveCollection,\n  linkReactiveEdgeToSource,\n  rollbackReactiveCollection,\n  unlinkReactiveEdgeFromSource,\n  type ReactiveEdge,\n  type SignalDependencyConsumer,\n} from './edge.js';\n\nexport interface SignalRenderConsumer {\n  readonly debugName: string;\n  readonly releaseCount: number;\n  markClean(): void;\n}\n\nexport interface SignalRenderConsumerOptions {\n  debugName: string;\n  invalidate(): void;\n}\n\nexport interface ComponentSignalRenderOwner {\n  signalConsumer: SignalRenderConsumer | undefined;\n}\n\nexport interface ComponentSignalReadOptions extends SignalRenderConsumerOptions {\n  onMaterialize(): void;\n}\n\ninterface ConsumerState extends SignalDependencyConsumer {\n  collecting: boolean;\n  dirty: boolean;\n  disposed: boolean;\n  releaseCount: number;\n}\n\nconst consumerStates = new WeakMap<SignalRenderConsumer, ConsumerState>();\n\n/** @internal Opaque identity for repository-local passive ownership correlation. */\nexport function signalRenderConsumerIdentity(consumer: SignalRenderConsumer): object | undefined {\n  return consumerStates.get(consumer);\n}\n\nexport function createSignalRenderConsumer(\n  options: SignalRenderConsumerOptions,\n): SignalRenderConsumer {\n  const state: ConsumerState = {\n    dependencyHead: undefined,\n    dependencyTail: undefined,\n    dependencyFreeHead: undefined,\n    dependencyFreeCount: 0,\n    dependencyCount: 0,\n    dependencyHighWater: 0,\n    collectionCursor: undefined,\n    collectionGeneration: 0,\n    collecting: false,\n    dirty: true,\n    disposed: false,\n    releaseCount: 0,\n    renderInvalidation: true,\n    addDependency(node): void {\n      if (!state.collecting) return;\n      const cursor = state.collectionCursor;\n      if (\n        cursor?.source === node &&\n        cursor.collectionGeneration !== state.collectionGeneration\n      ) {\n        cursor.collectionGeneration = state.collectionGeneration;\n        cursor.collectionKind = 'reused';\n        state.collectionCursor = cursor.consumerNext;\n        return;\n      }\n      collectReactiveDependency(state, node);\n    },\n    notify(): void {\n      if (state.disposed || state.dirty) return;\n      state.dirty = true;\n      options.invalidate();\n    },\n  };\n\n  const consumer: SignalRenderConsumer = {\n    debugName: options.debugName,\n    get releaseCount(): number {\n      return state.releaseCount;\n    },\n    markClean(): void {\n      if (!state.disposed) state.dirty = false;\n    },\n  };\n\n  consumerStates.set(consumer, state);\n  recordRendererConsumerCreated();\n  return consumer;\n}\n\nexport function collectSignalReads<T>(\n  consumer: SignalRenderConsumer,\n  callback: (commit: () => void) => T,\n): T {\n  const state = getConsumerState(consumer);\n  if (state.disposed) {\n    return withSignalTracking(\n      { addDependency: () => {} },\n      () => callback(() => {}),\n    );\n  }\n\n  beginReactiveCollection(state);\n  state.collecting = true;\n  let committed = false;\n  const commit = (): void => {\n    if (committed) return;\n    committed = true;\n    state.collecting = false;\n    if (!state.disposed) commitCollectedDependencies(state);\n    else rollbackReactiveCollection(state);\n  };\n  try {\n    const result = withSignalTracking(state, () => callback(commit));\n    commit();\n    return result;\n  } catch (error) {\n    if (!committed) rollbackReactiveCollection(state);\n    throw error;\n  } finally {\n    state.collecting = false;\n  }\n}\n\nexport function collectComponentSignalReads<T>(\n  owner: ComponentSignalRenderOwner,\n  createOptions: () => ComponentSignalReadOptions,\n  callback: (commit: () => void) => T,\n): T {\n  let consumer = owner.signalConsumer;\n  let state = consumer === undefined ? undefined : getConsumerState(consumer);\n  let provisional = false;\n  let committed = false;\n  let onMaterialize: (() => void) | undefined;\n\n  let collector: SignalDependencyCollector;\n  if (state === undefined) {\n    collector = {\n      addDependency(node: SignalNode<unknown>): void {\n        if (committed) return;\n        if (state === undefined) {\n          const options = createOptions();\n          onMaterialize = options.onMaterialize;\n          consumer = createSignalRenderConsumer(options);\n          state = getConsumerState(consumer);\n          provisional = true;\n          recordLazyRendererConsumerCreated();\n          beginConsumerCollection(state);\n        }\n        state.addDependency(node);\n      },\n    };\n  } else {\n    beginConsumerCollection(state);\n    collector = state;\n  }\n  const commit = (): void => {\n    if (committed) return;\n    committed = true;\n    if (state === undefined || consumer === undefined) return;\n    state.collecting = false;\n    commitCollectedDependencies(state);\n    if (state.dependencyCount === 0) {\n      if (owner.signalConsumer === consumer) owner.signalConsumer = undefined;\n      disposeSignalRenderConsumer(consumer);\n    } else if (provisional) {\n      owner.signalConsumer = consumer;\n      onMaterialize!();\n    }\n  };\n\n  try {\n    const result = withSignalTracking(collector, () => callback(commit));\n    commit();\n    return result;\n  } catch (error) {\n    if (!committed && state !== undefined) {\n      rollbackReactiveCollection(state);\n      if (provisional && consumer !== undefined) {\n        disposeSignalRenderConsumer(consumer);\n      }\n    }\n    throw error;\n  } finally {\n    if (state !== undefined) state.collecting = false;\n  }\n}\n\nexport function disposeSignalRenderConsumer(consumer: SignalRenderConsumer): void {\n  const state = getConsumerState(consumer);\n  if (state.disposed) return;\n  state.disposed = true;\n  state.collectionGeneration++;\n  state.collecting = false;\n  disposeReactiveConsumer(state, releaseRendererEdge);\n  state.releaseCount++;\n  recordRendererConsumerReleased();\n}\n\nfunction getConsumerState(consumer: SignalRenderConsumer): ConsumerState {\n  const state = consumerStates.get(consumer);\n  if (state === undefined) {\n    throw new TypeError('Expected a signal render consumer created by Pibbl.');\n  }\n  return state;\n}\n\nfunction beginConsumerCollection(state: ConsumerState): void {\n  beginReactiveCollection(state);\n  state.collecting = true;\n}\n\nfunction commitCollectedDependencies(state: ConsumerState): void {\n  const onlyEdge = state.dependencyHead;\n  if (\n    onlyEdge !== undefined &&\n    onlyEdge.consumerNext === undefined &&\n    onlyEdge.collectionGeneration === state.collectionGeneration &&\n    onlyEdge.sourceLinked &&\n    onlyEdge.collectionKind === 'reused'\n  ) {\n    recordRendererEdgeReused();\n    onlyEdge.observedVersion = onlyEdge.source!.version;\n    onlyEdge.collectionKind = undefined;\n    state.collectionCursor = undefined;\n    return;\n  }\n  finishReactiveCollection(\n    state,\n    edge => {\n      const restored = !edge.sourceLinked;\n      if (restored) {\n        const source = edge.source!;\n        linkReactiveEdgeToSource(edge, source.observe?.());\n      }\n      if (edge.collectionKind === 'new') {\n        recordRendererEdgeCreated();\n      } else {\n        recordRendererEdgeReused(restored);\n      }\n      edge.everPublished = true;\n      edge.observedVersion = edge.source!.version;\n      edge.collectionKind = undefined;\n    },\n    releaseRendererEdge,\n  );\n}\n\nfunction releaseRendererEdge(edge: ReactiveEdge): void {\n  if (!edge.sourceLinked) return;\n  unlinkReactiveEdgeFromSource(edge);\n  recordRendererEdgeReleased();\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { invalidateAllocationReceiver, releaseAllocationReceiver } from '../layout/allocation-dependencies.js';\nimport type { PibblInstance } from '../types.js';\nimport { invalidateReceiverAllocationInputs } from '../layout/allocation-revision.js';\nimport {\n  recordRendererConsumerCreated,\n  recordRendererConsumerReleased,\n  recordRendererEdgeCreated,\n  recordRendererEdgeReleased,\n  recordRendererEdgeReused,\n  recordSignalInputInvalidation,\n  recordLazyRendererConsumerCreated,\n  type SignalDependencyCollector,\n  type SignalDependencyRoleInput,\n  type SignalNode,\n  withSignalTracking,\n} from './graph.js';\nimport {\n  beginReactiveCollection,\n  collectReactiveDependency,\n  disposeReactiveConsumer,\n  finishReactiveCollection,\n  linkReactiveEdgeToSource,\n  rollbackReactiveCollection,\n  unlinkReactiveEdgeFromSource,\n  type ReactiveEdge,\n  type SignalDependencyConsumer,\n} from './edge.js';\n\nconst allocationDependencyRoles = 1 | 2 | 4 | 64; // structure, layout, measurement, unknown\n\nexport interface SignalRenderConsumer {\n  readonly debugName: string;\n  readonly releaseCount: number;\n  markClean(): void;\n}\n\nexport interface SignalRenderConsumerOptions {\n  layoutOwner?: PibblInstance;\n  allocationReceiver?: object;\n  debugName: string;\n  invalidate(): void;\n}\n\nexport interface ComponentSignalRenderOwner {\n  signalConsumer: SignalRenderConsumer | undefined;\n}\n\nexport interface ComponentSignalReadOptions extends SignalRenderConsumerOptions {\n  onMaterialize(): void;\n}\n\ninterface ConsumerState extends SignalDependencyConsumer {\n  readonly allocationReceiver: object | undefined;\n  collecting: boolean;\n  dirty: boolean;\n  disposed: boolean;\n  releaseCount: number;\n}\n\nconst consumerStates = new WeakMap<SignalRenderConsumer, ConsumerState>();\n\n/** @internal Opaque identity for repository-local passive ownership correlation. */\nexport function signalRenderConsumerIdentity(consumer: SignalRenderConsumer): object | undefined {\n  return consumerStates.get(consumer);\n}\n\nexport function createSignalRenderConsumer(\n  options: SignalRenderConsumerOptions,\n): SignalRenderConsumer {\n  const state: ConsumerState = {\n    allocationReceiver: options.allocationReceiver,\n    dependencyHead: undefined,\n    dependencyTail: undefined,\n    dependencyFreeHead: undefined,\n    dependencyFreeCount: 0,\n    dependencyCount: 0,\n    dependencyHighWater: 0,\n    collectionCursor: undefined,\n    collectionGeneration: 0,\n    collecting: false,\n    dirty: true,\n    disposed: false,\n    releaseCount: 0,\n    renderInvalidation: true,\n    addDependency(node, role?: SignalDependencyRoleInput): void {\n      if (!state.collecting) return;\n      collectReactiveDependency(state, node, role);\n    },\n    notify(_node, dependencyRoles = 64): void {\n      if (state.disposed) return;\n      recordSignalInputInvalidation(dependencyRoles);\n      if (options.allocationReceiver) invalidateAllocationReceiver(options.allocationReceiver, dependencyRoles);\n      // Paint, transforms, and interaction retain allocation geometry. Mixed\n      // dependencies still invalidate when any structural/metric role is present.\n      if ((dependencyRoles & allocationDependencyRoles) !== 0) {\n        // Only layout/measurement roles can be checked by a frozen descriptor\n        // fingerprint. Structure and unknown values can replace that descriptor.\n        invalidateReceiverAllocationInputs(options.layoutOwner, (dependencyRoles & (1 | 64)) !== 0 ? 'structural' : 'metric');\n      }\n      if (state.dirty) return;\n      state.dirty = true;\n      options.invalidate();\n    },\n  };\n\n  const consumer: SignalRenderConsumer = {\n    debugName: options.debugName,\n    get releaseCount(): number {\n      return state.releaseCount;\n    },\n    markClean(): void {\n      if (!state.disposed) {\n        state.dirty = false;\n      }\n    },\n  };\n\n  consumerStates.set(consumer, state);\n  recordRendererConsumerCreated();\n  return consumer;\n}\n\nexport function collectSignalReads<T>(\n  consumer: SignalRenderConsumer,\n  callback: (commit: () => void) => T,\n): T {\n  const state = getConsumerState(consumer);\n  if (state.disposed) {\n    return withSignalTracking(\n      { addDependency: () => {} },\n      () => callback(() => {}),\n    );\n  }\n\n  beginReactiveCollection(state);\n  state.collecting = true;\n  let committed = false;\n  const commit = (): void => {\n    if (committed) return;\n    committed = true;\n    state.collecting = false;\n    if (!state.disposed) commitCollectedDependencies(state);\n    else rollbackReactiveCollection(state);\n  };\n  try {\n    const result = withSignalTracking(state, () => callback(commit));\n    commit();\n    return result;\n  } catch (error) {\n    if (!committed) rollbackReactiveCollection(state);\n    throw error;\n  } finally {\n    state.collecting = false;\n  }\n}\n\nexport function collectComponentSignalReads<T>(\n  owner: ComponentSignalRenderOwner,\n  createOptions: () => ComponentSignalReadOptions,\n  callback: (commit: () => void) => T,\n): T {\n  let consumer = owner.signalConsumer;\n  let state = consumer === undefined ? undefined : getConsumerState(consumer);\n  let provisional = false;\n  let committed = false;\n  let onMaterialize: (() => void) | undefined;\n\n  let collector: SignalDependencyCollector;\n  if (state === undefined) {\n    collector = {\n      addDependency(node: SignalNode<unknown>, role?: SignalDependencyRoleInput): void {\n        if (committed) return;\n        if (state === undefined) {\n          const options = createOptions();\n          onMaterialize = options.onMaterialize;\n          consumer = createSignalRenderConsumer(options);\n          state = getConsumerState(consumer);\n          provisional = true;\n          recordLazyRendererConsumerCreated();\n          beginConsumerCollection(state);\n        }\n        state.addDependency(node, role);\n      },\n    };\n  } else {\n    beginConsumerCollection(state);\n    collector = state;\n  }\n  const commit = (): void => {\n    if (committed) return;\n    committed = true;\n    if (state === undefined || consumer === undefined) return;\n    state.collecting = false;\n    commitCollectedDependencies(state);\n    if (state.dependencyCount === 0) {\n      if (owner.signalConsumer === consumer) owner.signalConsumer = undefined;\n      disposeSignalRenderConsumer(consumer);\n    } else if (provisional) {\n      owner.signalConsumer = consumer;\n      onMaterialize!();\n    }\n  };\n\n  try {\n    const result = withSignalTracking(collector, () => callback(commit));\n    commit();\n    return result;\n  } catch (error) {\n    if (!committed && state !== undefined) {\n      rollbackReactiveCollection(state);\n      if (provisional && consumer !== undefined) {\n        disposeSignalRenderConsumer(consumer);\n      }\n    }\n    throw error;\n  } finally {\n    if (state !== undefined) state.collecting = false;\n  }\n}\n\nexport function disposeSignalRenderConsumer(consumer: SignalRenderConsumer): void {\n  const state = getConsumerState(consumer);\n  if (state.disposed) return;\n  state.disposed = true;\n  if (state.allocationReceiver) releaseAllocationReceiver(state.allocationReceiver);\n  state.collectionGeneration++;\n  state.collecting = false;\n  disposeReactiveConsumer(state, releaseRendererEdge);\n  state.releaseCount++;\n  recordRendererConsumerReleased();\n}\n\nfunction getConsumerState(consumer: SignalRenderConsumer): ConsumerState {\n  const state = consumerStates.get(consumer);\n  if (state === undefined) {\n    throw new TypeError('Expected a signal render consumer created by Pibbl.');\n  }\n  return state;\n}\n\nfunction beginConsumerCollection(state: ConsumerState): void {\n  beginReactiveCollection(state);\n  state.collecting = true;\n}\n\nfunction commitCollectedDependencies(state: ConsumerState): void {\n  const onlyEdge = state.dependencyHead;\n  if (\n    onlyEdge !== undefined &&\n    onlyEdge.consumerNext === undefined &&\n    onlyEdge.collectionGeneration === state.collectionGeneration &&\n    onlyEdge.sourceLinked &&\n    onlyEdge.collectionKind === 'reused'\n  ) {\n    onlyEdge.dependencyRoles = onlyEdge.collectedDependencyRoles;\n    recordRendererEdgeReused();\n    onlyEdge.observedVersion = onlyEdge.source!.version;\n    onlyEdge.collectionKind = undefined;\n    state.collectionCursor = undefined;\n    return;\n  }\n  finishReactiveCollection(\n    state,\n    edge => {\n      const restored = !edge.sourceLinked;\n      if (restored) {\n        const source = edge.source!;\n        linkReactiveEdgeToSource(edge, source.observe?.());\n      }\n      if (edge.collectionKind === 'new') {\n        recordRendererEdgeCreated();\n      } else {\n        recordRendererEdgeReused(restored);\n      }\n      edge.everPublished = true;\n      edge.observedVersion = edge.source!.version;\n      edge.collectionKind = undefined;\n    },\n    releaseRendererEdge,\n  );\n}\n\nfunction releaseRendererEdge(edge: ReactiveEdge): void {\n  if (!edge.sourceLinked) return;\n  unlinkReactiveEdgeFromSource(edge);\n  recordRendererEdgeReleased();\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/style/positioning.d.ts

@@ -1,6 +1,10 @@
 import type { StyleResolutionContext, SystemStyle } from '../types.js';
 import type { PibblElement } from '../element/types.js';
 import type { Length } from './types.js';
+/** @internal Marks only a fresh placement-owned style; authored style objects are never changed. */
+export declare function markDerivedAbsoluteAxes(style: SystemStyle, width: boolean, height: boolean): void;
+/** @internal Substitutes settled axes only across an exact forwarded placement handoff. */
+export declare function resolveForwardedDerivedAbsoluteAxes(style: Readonly<SystemStyle>, source: Readonly<SystemStyle> | undefined): Readonly<SystemStyle>;
 /** @internal Marks a placed function component's object style for forwarding. */
 export declare function withPlacementHandoff<P>(props: P, consumedStyle: Readonly<SystemStyle> | undefined): P;
 /** @internal Activates signal identity capture while one plain component runs. */
@@ -20,10 +24,54 @@ export declare function getPlacementSignalHandoff(element: PibblElement<any>): R
  * @see {@link SystemStyle}
  */
 export interface PositioningStyle extends SystemStyle {
-    /** Left edge coordinate or inset. See {@link Length}. */
+    /**
+     * Experimental direct-Flex placement mode. In a finite Flex, static
+     * keeps the allocated slot and ignores insets; relative offsets final geometry
+     * once without moving siblings. Primitive static/relative leaves support every
+     * main/writing direction and wrapping mode. Wrapped parents admit fixed numeric
+     * direct Flex owners that remain internally nowrap; non-row chains use the same
+     * fixed owner restriction, with zero grow/shrink and
+     * omitted or automatic basis; physical offsets retain their sign through main reversal. Absolute stays out of sibling allocation, using
+     * the padding box for explicit insets and content alignment for omitted axes.
+     * Fixed numeric, percentage and admitted automatic absolute profiles support all main directions
+     * and RTL, with numeric or percentage bounds applied before placement. In every wrapping mode,
+     * omitted axes use whole-content main/cross alignment; wrap-reverse reverses
+     * omitted cross alignment and combines with column RTL exactly once.
+     * Paired natural providers keep their exact/unbounded query in every admitted direction.
+     * Direct wrapped Text with a generic pixel font and visible fit/overflow may
+     * measure automatic height at a resolved numeric or percentage width through the same owned query.
+     * Unwrapped Text may measure automatic width at a resolved numeric or percentage height, using
+     * its existing Canvas ink-bounds width before bounds and physical anchoring.
+     * Generic unwrapped Text also supports natural ink height and both automatic
+     * dimensions through one unbounded query before independent numeric clamps;
+     * mixed opposing-pair/natural feedback and both-auto aspect remain excluded.
+     * On the documented finite direct-child path, automatic absolute axes resolve
+     * from opposing numeric or percentage physical insets. With a positive finite aspectRatio,
+     * exactly one automatic axis can instead derive from its resolved declared finite numeric or percentage opposite axis.
+     * Opposing insets win. Finite numeric or percentage min/max bounds clamp used axes
+     * independently after derivation; a clamp does not recouple aspectRatio, and a
+     * numeric minimum above its maximum rejects. A direct custom primitive with
+     * paired pure measurement providers may instead measure natural automatic
+     * width at a declared numeric or percentage height, or natural height at a declared numeric
+     * or percentage width. The automatic axis is unbounded; the exact axis uses its declared
+     * resolved padding-box value before bounds clamp the used dimensions.
+     * In direct declarative Flex chains,
+     * static Flex passes the containing box outward while relative Flex owns a local box.
+     * Omission retains the legacy local Flex boundary and left/top behavior.
+     */
+    position?: 'static' | 'relative' | 'absolute';
+    /** Left edge coordinate or inset. Explicit absolute Flex insets accept finite numbers or percentages of the containing padding-box axis; relative percentages use the parent content-box axis. See {@link Length}. */
     left?: Exclude<Length, 'auto'>;
-    /** Top edge value or top envelope guide. See {@link Length}. */
+    /** Right edge inset. Absolute Flex accepts finite numbers or percentages of the containing padding-box width; relative percentages use the parent content-box width. See {@link Length}. */
+    right?: Exclude<Length, 'auto'>;
+    /** Top edge coordinate or inset. Explicit absolute Flex insets accept finite numbers or percentages of the containing padding-box axis; relative percentages use the parent content-box axis. See {@link Length}. */
     top?: Exclude<Length, 'auto'>;
+    /** Bottom edge inset. Absolute Flex accepts finite numbers or percentages of the containing padding-box height; relative percentages use the parent content-box height. See {@link Length}. */
+    bottom?: Exclude<Length, 'auto'>;
+    /** Experimental direct absolute Flex inline-start inset, mapped through the receiving Flex direction. Overrides the corresponding physical edge, including zero. Percentages use the selected containing padding-box width. See {@link Length}. */
+    insetStart?: Exclude<Length, 'auto'>;
+    /** Experimental direct absolute Flex inline-end inset, mapped through the receiving Flex direction. Overrides the corresponding physical edge. See {@link Length}. */
+    insetEnd?: Exclude<Length, 'auto'>;
 }
 export interface ResolvedPosition {
     left: number;

package/dist/lib/style/positioning.js

@@ -5,16 +5,36 @@ import {
 import { isSignal } from "../signals/graph.js";
 import { resolveLocalOffset } from "./resolve-built-in.js";
 const PLACEMENT_HANDOFF = /* @__PURE__ */ Symbol("pibbl.placement-handoff");
+const PLACEMENT_DERIVED_ABSOLUTE_AXES = /* @__PURE__ */ Symbol("pibbl.placement-derived-absolute-axes");
 let activeSignalHandoff;
 function hasPositioning(style) {
-  if (Object.hasOwn(style, "left") || Object.hasOwn(style, "top")) return true;
+  if (Object.hasOwn(style, "position") || Object.hasOwn(style, "left") || Object.hasOwn(style, "right") || Object.hasOwn(style, "top") || Object.hasOwn(style, "bottom") || Object.hasOwn(style, "insetStart") || Object.hasOwn(style, "insetEnd")) return true;
   const when = style.when;
   return Array.isArray(when) && when.some((rule) => {
     if (!rule || typeof rule !== "object") return false;
     const patch = rule.style;
-    return !!patch && typeof patch === "object" && (Object.hasOwn(patch, "left") || Object.hasOwn(patch, "top"));
+    return !!patch && typeof patch === "object" && (Object.hasOwn(patch, "position") || Object.hasOwn(patch, "left") || Object.hasOwn(patch, "right") || Object.hasOwn(patch, "top") || Object.hasOwn(patch, "bottom") || Object.hasOwn(patch, "insetStart") || Object.hasOwn(patch, "insetEnd"));
   });
 }
+function markDerivedAbsoluteAxes(style, width, height) {
+  style[PLACEMENT_DERIVED_ABSOLUTE_AXES] = (width ? 1 : 0) | (height ? 2 : 0);
+}
+function resolveForwardedDerivedAbsoluteAxes(style, source) {
+  if (source === void 0) return style;
+  const axes = source[PLACEMENT_DERIVED_ABSOLUTE_AXES];
+  if (!axes || !samePositioning(style, source)) return style;
+  const raw = style;
+  const settled = source;
+  const width = (axes & 1) !== 0 && (raw.width === void 0 || raw.width === "auto") && typeof settled.width === "number" ? settled.width : raw.width;
+  const height = (axes & 2) !== 0 && (raw.height === void 0 || raw.height === "auto") && typeof settled.height === "number" ? settled.height : raw.height;
+  if (Object.is(width, raw.width) && Object.is(height, raw.height)) return style;
+  return Object.freeze({ ...raw, width, height });
+}
+function samePositioning(style, source) {
+  const left = style;
+  const right = source;
+  return Object.is(left.position, right.position) && Object.is(left.left, right.left) && Object.is(left.right, right.right) && Object.is(left.top, right.top) && Object.is(left.bottom, right.bottom) && Object.is(left.insetStart, right.insetStart) && Object.is(left.insetEnd, right.insetEnd);
+}
 function withPlacementHandoff(props, consumedStyle) {
   if (!props || typeof props !== "object") return props;
   const candidate = props;
@@ -55,9 +75,11 @@ function getPlacementHandoffSource(style) {
   return marker.source;
 }
 function consumePlacementHandoff(style) {
-  if (getPlacementHandoffSource(style) === void 0) return style;
-  const withoutHandoff = { ...style };
+  const record = style;
+  if (record[PLACEMENT_HANDOFF] === void 0 && record[PLACEMENT_DERIVED_ABSOLUTE_AXES] === void 0) return style;
+  const withoutHandoff = { ...record };
   delete withoutHandoff[PLACEMENT_HANDOFF];
+  delete withoutHandoff[PLACEMENT_DERIVED_ABSOLUTE_AXES];
   return Object.freeze(withoutHandoff);
 }
 function getPlacementSignalHandoff(element) {
@@ -75,6 +97,8 @@ export {
   enterPlacementHandoffCapture,
   getPlacementHandoffSource,
   getPlacementSignalHandoff,
+  markDerivedAbsoluteAxes,
+  resolveForwardedDerivedAbsoluteAxes,
   resolveStandalonePosition,
   withPlacementHandoff
 };

package/dist/lib/style/positioning.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/style/positioning.ts"],
-  "sourcesContent": ["import type { StyleResolutionContext, SystemStyle } from '../types.js';\nimport {\n  getPlacementSignalHandoffStyle,\n  setPlacementSignalHandoff,\n} from '../element/metadata.js';\nimport type { PibblElement } from '../element/types.js';\nimport { isSignal } from '../signals/graph.js';\nimport { resolveLocalOffset } from './resolve-built-in.js';\nimport type { Length } from './types.js';\n\nconst PLACEMENT_HANDOFF = Symbol('pibbl.placement-handoff');\n\ntype PropsWithStyle = Record<PropertyKey, unknown> & {\n  readonly style?: unknown;\n};\n\ntype PlacementHandoff = Readonly<{\n  source: Readonly<SystemStyle>;\n}>;\n\nlet activeSignalHandoff: {\n  readonly signal: object;\n  readonly consumedStyle: Readonly<SystemStyle>;\n} | undefined;\n\nfunction hasPositioning(style: Readonly<Record<PropertyKey, unknown>>): boolean {\n  if (Object.hasOwn(style, 'left') || Object.hasOwn(style, 'top')) return true;\n  const when = style.when;\n  return Array.isArray(when) && when.some((rule) => {\n    if (!rule || typeof rule !== 'object') return false;\n    const patch = (rule as { style?: unknown }).style;\n    return !!patch && typeof patch === 'object' &&\n      (Object.hasOwn(patch, 'left') || Object.hasOwn(patch, 'top'));\n  });\n}\n\n/** @internal Marks a placed function component's object style for forwarding. */\nexport function withPlacementHandoff<P>(\n  props: P,\n  consumedStyle: Readonly<SystemStyle> | undefined,\n): P {\n  if (!props || typeof props !== 'object') return props;\n  const candidate = props as PropsWithStyle;\n  const style = candidate.style;\n  if (\n    !style ||\n    typeof style !== 'object' ||\n    isSignal(style) ||\n    (style as Record<PropertyKey, unknown>)[PLACEMENT_HANDOFF] !== undefined ||\n    !hasPositioning(style as Readonly<Record<PropertyKey, unknown>>)\n  ) {\n    return props;\n  }\n  return {\n    ...candidate,\n    style: Object.freeze({\n      ...(style as Record<PropertyKey, unknown>),\n      [PLACEMENT_HANDOFF]: Object.freeze({\n        source: consumedStyle ?? style as Readonly<SystemStyle>,\n      }),\n    }),\n  } as P;\n}\n\n/** @internal Activates signal identity capture while one plain component runs. */\nexport function enterPlacementHandoffCapture(\n  props: unknown,\n  consumedStyle: Readonly<SystemStyle> | undefined,\n): () => void {\n  const style = props && typeof props === 'object' ?\n    (props as PropsWithStyle).style : undefined;\n  const previous = activeSignalHandoff;\n  activeSignalHandoff = style && isSignal(style) && consumedStyle !== undefined ? {\n    signal: style,\n    consumedStyle,\n  } : undefined;\n  return () => {\n    activeSignalHandoff = previous;\n  };\n}\n\n/** @internal Annotates an element created with the active forwarded style signal. */\nexport function capturePlacementHandoff(\n  element: PibblElement<any>,\n  style: unknown,\n): void {\n  if (style && style === activeSignalHandoff?.signal) {\n    setPlacementSignalHandoff(element, activeSignalHandoff.consumedStyle);\n  }\n}\n\n/** @internal Reads the original style behind an enumerable forwarding marker. */\nexport function getPlacementHandoffSource(\n  style: unknown,\n): Readonly<SystemStyle> | undefined {\n  if (!style || typeof style !== 'object') return undefined;\n  const marker = (style as Record<PropertyKey, unknown>)[PLACEMENT_HANDOFF];\n  if (!marker || typeof marker !== 'object') return undefined;\n  return (marker as PlacementHandoff).source;\n}\n\n/** @internal Removes a private handoff marker before style callbacks run. */\nexport function consumePlacementHandoff(\n  style: Readonly<SystemStyle>,\n): Readonly<SystemStyle> {\n  if (getPlacementHandoffSource(style) === undefined) return style;\n  const withoutHandoff = { ...(style as Record<PropertyKey, unknown>) };\n  delete withoutHandoff[PLACEMENT_HANDOFF];\n  return Object.freeze(withoutHandoff) as Readonly<SystemStyle>;\n}\n\n/** @internal Determines whether a primitive consumes one forwarded signal style. */\nexport function getPlacementSignalHandoff(\n  element: PibblElement<any>,\n): Readonly<SystemStyle> | undefined {\n  return getPlacementSignalHandoffStyle(element);\n}\n\n/**\n * Offsets in the parent layout coordinate system; percentages resolve against the containing box.\n *\n * @see {@link Length}\n * @see {@link SystemStyle}\n */\nexport interface PositioningStyle extends SystemStyle {\n  /** Left edge coordinate or inset. See {@link Length}. */\n  left?: Exclude<Length, 'auto'>;\n  /** Top edge value or top envelope guide. See {@link Length}. */\n  top?: Exclude<Length, 'auto'>;\n}\n\nexport interface ResolvedPosition {\n  left: number;\n  top: number;\n}\n\nexport function resolveStandalonePosition(\n  style: Readonly<PositioningStyle>,\n  context: Readonly<StyleResolutionContext>,\n): ResolvedPosition {\n  return {\n    left: resolveLocalOffset(style.left, context.percentageBasis.width, 'left', context),\n    top: resolveLocalOffset(style.top, context.percentageBasis.height, 'top', context),\n  };\n}\n"],
-  "mappings": "AACA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEP,SAAS,gBAAgB;AACzB,SAAS,0BAA0B;AAGnC,MAAM,oBAAoB,uBAAO,yBAAyB;AAU1D,IAAI;AAKJ,SAAS,eAAe,OAAwD;AAC9E,MAAI,OAAO,OAAO,OAAO,MAAM,KAAK,OAAO,OAAO,OAAO,KAAK,EAAG,QAAO;AACxE,QAAM,OAAO,MAAM;AACnB,SAAO,MAAM,QAAQ,IAAI,KAAK,KAAK,KAAK,CAAC,SAAS;AAChD,QAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,UAAM,QAAS,KAA6B;AAC5C,WAAO,CAAC,CAAC,SAAS,OAAO,UAAU,aAChC,OAAO,OAAO,OAAO,MAAM,KAAK,OAAO,OAAO,OAAO,KAAK;AAAA,EAC/D,CAAC;AACH;AAGO,SAAS,qBACd,OACA,eACG;AACH,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAClB,QAAM,QAAQ,UAAU;AACxB,MACE,CAAC,SACD,OAAO,UAAU,YACjB,SAAS,KAAK,KACb,MAAuC,iBAAiB,MAAM,UAC/D,CAAC,eAAe,KAA+C,GAC/D;AACA,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,OAAO,OAAO,OAAO;AAAA,MACnB,GAAI;AAAA,MACJ,CAAC,iBAAiB,GAAG,OAAO,OAAO;AAAA,QACjC,QAAQ,iBAAiB;AAAA,MAC3B,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;AAGO,SAAS,6BACd,OACA,eACY;AACZ,QAAM,QAAQ,SAAS,OAAO,UAAU,WACrC,MAAyB,QAAQ;AACpC,QAAM,WAAW;AACjB,wBAAsB,SAAS,SAAS,KAAK,KAAK,kBAAkB,SAAY;AAAA,IAC9E,QAAQ;AAAA,IACR;AAAA,EACF,IAAI;AACJ,SAAO,MAAM;AACX,0BAAsB;AAAA,EACxB;AACF;AAGO,SAAS,wBACd,SACA,OACM;AACN,MAAI,SAAS,UAAU,qBAAqB,QAAQ;AAClD,8BAA0B,SAAS,oBAAoB,aAAa;AAAA,EACtE;AACF;AAGO,SAAS,0BACd,OACmC;AACnC,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,SAAU,MAAuC,iBAAiB;AACxE,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,SAAQ,OAA4B;AACtC;AAGO,SAAS,wBACd,OACuB;AACvB,MAAI,0BAA0B,KAAK,MAAM,OAAW,QAAO;AAC3D,QAAM,iBAAiB,EAAE,GAAI,MAAuC;AACpE,SAAO,eAAe,iBAAiB;AACvC,SAAO,OAAO,OAAO,cAAc;AACrC;AAGO,SAAS,0BACd,SACmC;AACnC,SAAO,+BAA+B,OAAO;AAC/C;AAoBO,SAAS,0BACd,OACA,SACkB;AAClB,SAAO;AAAA,IACL,MAAM,mBAAmB,MAAM,MAAM,QAAQ,gBAAgB,OAAO,QAAQ,OAAO;AAAA,IACnF,KAAK,mBAAmB,MAAM,KAAK,QAAQ,gBAAgB,QAAQ,OAAO,OAAO;AAAA,EACnF;AACF;",
+  "sourcesContent": ["import type { StyleResolutionContext, SystemStyle } from '../types.js';\nimport {\n  getPlacementSignalHandoffStyle,\n  setPlacementSignalHandoff,\n} from '../element/metadata.js';\nimport type { PibblElement } from '../element/types.js';\nimport { isSignal } from '../signals/graph.js';\nimport { resolveLocalOffset } from './resolve-built-in.js';\nimport type { Length } from './types.js';\n\nconst PLACEMENT_HANDOFF = Symbol('pibbl.placement-handoff');\nconst PLACEMENT_DERIVED_ABSOLUTE_AXES = Symbol('pibbl.placement-derived-absolute-axes');\n\ntype PropsWithStyle = Record<PropertyKey, unknown> & {\n  readonly style?: unknown;\n};\n\ntype PlacementHandoff = Readonly<{\n  source: Readonly<SystemStyle>;\n}>;\n\nlet activeSignalHandoff: {\n  readonly signal: object;\n  readonly consumedStyle: Readonly<SystemStyle>;\n} | undefined;\n\nfunction hasPositioning(style: Readonly<Record<PropertyKey, unknown>>): boolean {\n  if (Object.hasOwn(style, 'position') || Object.hasOwn(style, 'left') || Object.hasOwn(style, 'right') || Object.hasOwn(style, 'top') || Object.hasOwn(style, 'bottom') || Object.hasOwn(style, 'insetStart') || Object.hasOwn(style, 'insetEnd')) return true;\n  const when = style.when;\n  return Array.isArray(when) && when.some((rule) => {\n    if (!rule || typeof rule !== 'object') return false;\n    const patch = (rule as { style?: unknown }).style;\n    return !!patch && typeof patch === 'object' &&\n      (Object.hasOwn(patch, 'position') || Object.hasOwn(patch, 'left') || Object.hasOwn(patch, 'right') || Object.hasOwn(patch, 'top') || Object.hasOwn(patch, 'bottom') || Object.hasOwn(patch, 'insetStart') || Object.hasOwn(patch, 'insetEnd'));\n  });\n}\n\n/** @internal Marks only a fresh placement-owned style; authored style objects are never changed. */\nexport function markDerivedAbsoluteAxes(style: SystemStyle, width: boolean, height: boolean): void {\n  (style as Record<PropertyKey, unknown>)[PLACEMENT_DERIVED_ABSOLUTE_AXES] = (width ? 1 : 0) | (height ? 2 : 0);\n}\n\n/** @internal Substitutes settled axes only across an exact forwarded placement handoff. */\nexport function resolveForwardedDerivedAbsoluteAxes(\n  style: Readonly<SystemStyle>,\n  source: Readonly<SystemStyle> | undefined,\n): Readonly<SystemStyle> {\n  if (source === undefined) return style;\n  const axes = (source as Record<PropertyKey, unknown>)[PLACEMENT_DERIVED_ABSOLUTE_AXES] as number | undefined;\n  if (!axes || !samePositioning(style, source)) return style;\n  const raw = style as Readonly<Record<string, unknown>>;\n  const settled = source as Readonly<Record<string, unknown>>;\n  const width = (axes & 1) !== 0 && (raw.width === undefined || raw.width === 'auto') && typeof settled.width === 'number' ? settled.width : raw.width;\n  const height = (axes & 2) !== 0 && (raw.height === undefined || raw.height === 'auto') && typeof settled.height === 'number' ? settled.height : raw.height;\n  if (Object.is(width, raw.width) && Object.is(height, raw.height)) return style;\n  return Object.freeze({ ...raw, width, height }) as Readonly<SystemStyle>;\n}\n\nfunction samePositioning(style: Readonly<SystemStyle>, source: Readonly<SystemStyle>): boolean {\n  const left = style as Readonly<Record<string, unknown>>;\n  const right = source as Readonly<Record<string, unknown>>;\n  return Object.is(left.position, right.position) && Object.is(left.left, right.left) &&\n    Object.is(left.right, right.right) && Object.is(left.top, right.top) &&\n    Object.is(left.bottom, right.bottom) && Object.is(left.insetStart, right.insetStart) &&\n    Object.is(left.insetEnd, right.insetEnd);\n}\n\n/** @internal Marks a placed function component's object style for forwarding. */\nexport function withPlacementHandoff<P>(\n  props: P,\n  consumedStyle: Readonly<SystemStyle> | undefined,\n): P {\n  if (!props || typeof props !== 'object') return props;\n  const candidate = props as PropsWithStyle;\n  const style = candidate.style;\n  if (\n    !style ||\n    typeof style !== 'object' ||\n    isSignal(style) ||\n    (style as Record<PropertyKey, unknown>)[PLACEMENT_HANDOFF] !== undefined ||\n    !hasPositioning(style as Readonly<Record<PropertyKey, unknown>>)\n  ) {\n    return props;\n  }\n  return {\n    ...candidate,\n    style: Object.freeze({\n      ...(style as Record<PropertyKey, unknown>),\n      [PLACEMENT_HANDOFF]: Object.freeze({\n        source: consumedStyle ?? style as Readonly<SystemStyle>,\n      }),\n    }),\n  } as P;\n}\n\n/** @internal Activates signal identity capture while one plain component runs. */\nexport function enterPlacementHandoffCapture(\n  props: unknown,\n  consumedStyle: Readonly<SystemStyle> | undefined,\n): () => void {\n  const style = props && typeof props === 'object' ?\n    (props as PropsWithStyle).style : undefined;\n  const previous = activeSignalHandoff;\n  activeSignalHandoff = style && isSignal(style) && consumedStyle !== undefined ? {\n    signal: style,\n    consumedStyle,\n  } : undefined;\n  return () => {\n    activeSignalHandoff = previous;\n  };\n}\n\n/** @internal Annotates an element created with the active forwarded style signal. */\nexport function capturePlacementHandoff(\n  element: PibblElement<any>,\n  style: unknown,\n): void {\n  if (style && style === activeSignalHandoff?.signal) {\n    setPlacementSignalHandoff(element, activeSignalHandoff.consumedStyle);\n  }\n}\n\n/** @internal Reads the original style behind an enumerable forwarding marker. */\nexport function getPlacementHandoffSource(\n  style: unknown,\n): Readonly<SystemStyle> | undefined {\n  if (!style || typeof style !== 'object') return undefined;\n  const marker = (style as Record<PropertyKey, unknown>)[PLACEMENT_HANDOFF];\n  if (!marker || typeof marker !== 'object') return undefined;\n  return (marker as PlacementHandoff).source;\n}\n\n/** @internal Removes a private handoff marker before style callbacks run. */\nexport function consumePlacementHandoff(\n  style: Readonly<SystemStyle>,\n): Readonly<SystemStyle> {\n  const record = style as Record<PropertyKey, unknown>;\n  if (record[PLACEMENT_HANDOFF] === undefined && record[PLACEMENT_DERIVED_ABSOLUTE_AXES] === undefined) return style;\n  const withoutHandoff = { ...record };\n  delete withoutHandoff[PLACEMENT_HANDOFF];\n  delete withoutHandoff[PLACEMENT_DERIVED_ABSOLUTE_AXES];\n  return Object.freeze(withoutHandoff) as Readonly<SystemStyle>;\n}\n\n/** @internal Determines whether a primitive consumes one forwarded signal style. */\nexport function getPlacementSignalHandoff(\n  element: PibblElement<any>,\n): Readonly<SystemStyle> | undefined {\n  return getPlacementSignalHandoffStyle(element);\n}\n\n/**\n * Offsets in the parent layout coordinate system; percentages resolve against the containing box.\n *\n * @see {@link Length}\n * @see {@link SystemStyle}\n */\nexport interface PositioningStyle extends SystemStyle {\n  /**\n   * Experimental direct-Flex placement mode. In a finite Flex, static\n   * keeps the allocated slot and ignores insets; relative offsets final geometry\n   * once without moving siblings. Primitive static/relative leaves support every\n   * main/writing direction and wrapping mode. Wrapped parents admit fixed numeric\n   * direct Flex owners that remain internally nowrap; non-row chains use the same\n   * fixed owner restriction, with zero grow/shrink and\n   * omitted or automatic basis; physical offsets retain their sign through main reversal. Absolute stays out of sibling allocation, using\n   * the padding box for explicit insets and content alignment for omitted axes.\n   * Fixed numeric, percentage and admitted automatic absolute profiles support all main directions\n   * and RTL, with numeric or percentage bounds applied before placement. In every wrapping mode,\n   * omitted axes use whole-content main/cross alignment; wrap-reverse reverses\n   * omitted cross alignment and combines with column RTL exactly once.\n   * Paired natural providers keep their exact/unbounded query in every admitted direction.\n   * Direct wrapped Text with a generic pixel font and visible fit/overflow may\n   * measure automatic height at a resolved numeric or percentage width through the same owned query.\n   * Unwrapped Text may measure automatic width at a resolved numeric or percentage height, using\n   * its existing Canvas ink-bounds width before bounds and physical anchoring.\n   * Generic unwrapped Text also supports natural ink height and both automatic\n   * dimensions through one unbounded query before independent numeric clamps;\n   * mixed opposing-pair/natural feedback and both-auto aspect remain excluded.\n   * On the documented finite direct-child path, automatic absolute axes resolve\n   * from opposing numeric or percentage physical insets. With a positive finite aspectRatio,\n   * exactly one automatic axis can instead derive from its resolved declared finite numeric or percentage opposite axis.\n   * Opposing insets win. Finite numeric or percentage min/max bounds clamp used axes\n   * independently after derivation; a clamp does not recouple aspectRatio, and a\n   * numeric minimum above its maximum rejects. A direct custom primitive with\n   * paired pure measurement providers may instead measure natural automatic\n   * width at a declared numeric or percentage height, or natural height at a declared numeric\n   * or percentage width. The automatic axis is unbounded; the exact axis uses its declared\n   * resolved padding-box value before bounds clamp the used dimensions.\n   * In direct declarative Flex chains,\n   * static Flex passes the containing box outward while relative Flex owns a local box.\n   * Omission retains the legacy local Flex boundary and left/top behavior.\n   */\n  position?: 'static' | 'relative' | 'absolute';\n  /** Left edge coordinate or inset. Explicit absolute Flex insets accept finite numbers or percentages of the containing padding-box axis; relative percentages use the parent content-box axis. See {@link Length}. */\n  left?: Exclude<Length, 'auto'>;\n  /** Right edge inset. Absolute Flex accepts finite numbers or percentages of the containing padding-box width; relative percentages use the parent content-box width. See {@link Length}. */\n  right?: Exclude<Length, 'auto'>;\n  /** Top edge coordinate or inset. Explicit absolute Flex insets accept finite numbers or percentages of the containing padding-box axis; relative percentages use the parent content-box axis. See {@link Length}. */\n  top?: Exclude<Length, 'auto'>;\n  /** Bottom edge inset. Absolute Flex accepts finite numbers or percentages of the containing padding-box height; relative percentages use the parent content-box height. See {@link Length}. */\n  bottom?: Exclude<Length, 'auto'>;\n  /** Experimental direct absolute Flex inline-start inset, mapped through the receiving Flex direction. Overrides the corresponding physical edge, including zero. Percentages use the selected containing padding-box width. See {@link Length}. */\n  insetStart?: Exclude<Length, 'auto'>;\n  /** Experimental direct absolute Flex inline-end inset, mapped through the receiving Flex direction. Overrides the corresponding physical edge. See {@link Length}. */\n  insetEnd?: Exclude<Length, 'auto'>;\n}\n\nexport interface ResolvedPosition {\n  left: number;\n  top: number;\n}\n\nexport function resolveStandalonePosition(\n  style: Readonly<PositioningStyle>,\n  context: Readonly<StyleResolutionContext>,\n): ResolvedPosition {\n  return {\n    left: resolveLocalOffset(style.left, context.percentageBasis.width, 'left', context),\n    top: resolveLocalOffset(style.top, context.percentageBasis.height, 'top', context),\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/style/resolve-built-in.d.ts

@@ -1,6 +1,7 @@
-import type { StyleResolutionContext, SystemStyle } from '../types.js';
 import type { Length } from './types.js';
+import type { StyleResolutionContext, SystemStyle } from '../types.js';
+import type { SizingLength } from './sizing-length.js';
 export declare function stripLayoutParticipation<S extends SystemStyle>(style: Readonly<S>): Record<string, unknown>;
-export declare function resolveRequiredLength(value: Length, reference: number, property: string, context: Readonly<StyleResolutionContext>): number;
-export declare function resolveOptionalLength(value: Length | undefined, reference: number, property: string, context: Readonly<StyleResolutionContext>): number | undefined;
+export declare function resolveRequiredLength(value: SizingLength, reference: number, property: string, context: Readonly<StyleResolutionContext>): number;
+export declare function resolveOptionalLength(value: SizingLength | undefined, reference: number, property: string, context: Readonly<StyleResolutionContext>): number | undefined;
 export declare function resolveLocalOffset(value: Exclude<Length, 'auto'> | undefined, reference: number, property: string, context: Readonly<StyleResolutionContext>): number;

package/dist/lib/style/resolve-built-in.js

@@ -1,5 +1,5 @@
 import { layoutDiagnostic } from "./diagnostics.js";
-import { resolveLength } from "./resolve-length.js";
+import { resolveScalarSizingLength } from "./sizing-length.js";
 const LAYOUT_PARTICIPATION_KEYS = /* @__PURE__ */ new Set([
   "width",
   "height",
@@ -8,6 +8,20 @@ const LAYOUT_PARTICIPATION_KEYS = /* @__PURE__ */ new Set([
   "minHeight",
   "maxHeight",
   "padding",
+  "paddingStart",
+  "paddingEnd",
+  "boxSizing",
+  "borderWidth",
+  "borderStartWidth",
+  "borderEndWidth",
+  "aspectRatio",
+  "margin",
+  "marginTop",
+  "marginRight",
+  "marginBottom",
+  "marginLeft",
+  "marginStart",
+  "marginEnd",
   "overflow",
   "left",
   "top",
@@ -29,7 +43,7 @@ function stripLayoutParticipation(style) {
   return result;
 }
 function resolveRequiredLength(value, reference, property, context) {
-  const resolved = resolveLength(value, reference, property, context);
+  const resolved = resolveScalarSizingLength(value, reference, property, context);
   if (resolved === void 0) {
     throw layoutDiagnostic({
       component: context.component,
@@ -44,7 +58,7 @@ function resolveRequiredLength(value, reference, property, context) {
 }
 function resolveOptionalLength(value, reference, property, context) {
   if (value === void 0) return void 0;
-  return resolveLength(value, reference, property, context);
+  return resolveScalarSizingLength(value, reference, property, context);
 }
 function resolveLocalOffset(value, reference, property, context) {
   return resolveRequiredLength(value ?? 0, reference, property, context);

package/dist/lib/style/resolve-built-in.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/style/resolve-built-in.ts"],
-  "sourcesContent": ["import type { StyleResolutionContext, SystemStyle } from '../types.js';\nimport { layoutDiagnostic } from './diagnostics.js';\nimport { resolveLength } from './resolve-length.js';\nimport type { Length } from './types.js';\n\nconst LAYOUT_PARTICIPATION_KEYS = new Set([\n  'width',\n  'height',\n  'minWidth',\n  'maxWidth',\n  'minHeight',\n  'maxHeight',\n  'padding',\n  'overflow',\n  'left',\n  'top',\n  'alignSelf',\n  'justifySelf',\n  'flexBasis',\n  'flexGrow',\n  'flexShrink',\n  'gridColumnStart',\n  'gridColumnSpan',\n  'gridRowStart',\n  'gridRowSpan',\n]);\n\nexport function stripLayoutParticipation<S extends SystemStyle>(\n  style: Readonly<S>,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(style)) {\n    if (!LAYOUT_PARTICIPATION_KEYS.has(key)) result[key] = value;\n  }\n  return result;\n}\n\nexport function resolveRequiredLength(\n  value: Length,\n  reference: number,\n  property: string,\n  context: Readonly<StyleResolutionContext>,\n): number {\n  const resolved = resolveLength(value, reference, property, context);\n  if (resolved === undefined) {\n    throw layoutDiagnostic({\n      component: context.component,\n      property,\n      value,\n      algorithm: context.algorithm,\n      constraints: context.constraints,\n      reason: 'must resolve to a finite number before rendering',\n    });\n  }\n  return resolved;\n}\n\nexport function resolveOptionalLength(\n  value: Length | undefined,\n  reference: number,\n  property: string,\n  context: Readonly<StyleResolutionContext>,\n): number | undefined {\n  if (value === undefined) return undefined;\n  return resolveLength(value, reference, property, context);\n}\n\nexport function resolveLocalOffset(\n  value: Exclude<Length, 'auto'> | undefined,\n  reference: number,\n  property: string,\n  context: Readonly<StyleResolutionContext>,\n): number {\n  return resolveRequiredLength(value ?? 0, reference, property, context);\n}\n"],
-  "mappings": "AACA,SAAS,wBAAwB;AACjC,SAAS,qBAAqB;AAG9B,MAAM,4BAA4B,oBAAI,IAAI;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,SAAS,yBACd,OACyB;AACzB,QAAM,SAAkC,CAAC;AACzC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,CAAC,0BAA0B,IAAI,GAAG,EAAG,QAAO,GAAG,IAAI;AAAA,EACzD;AACA,SAAO;AACT;AAEO,SAAS,sBACd,OACA,WACA,UACA,SACQ;AACR,QAAM,WAAW,cAAc,OAAO,WAAW,UAAU,OAAO;AAClE,MAAI,aAAa,QAAW;AAC1B,UAAM,iBAAiB;AAAA,MACrB,WAAW,QAAQ;AAAA,MACnB;AAAA,MACA;AAAA,MACA,WAAW,QAAQ;AAAA,MACnB,aAAa,QAAQ;AAAA,MACrB,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAEO,SAAS,sBACd,OACA,WACA,UACA,SACoB;AACpB,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,cAAc,OAAO,WAAW,UAAU,OAAO;AAC1D;AAEO,SAAS,mBACd,OACA,WACA,UACA,SACQ;AACR,SAAO,sBAAsB,SAAS,GAAG,WAAW,UAAU,OAAO;AACvE;",
+  "sourcesContent": ["import type { Length } from './types.js';\nimport type { StyleResolutionContext, SystemStyle } from '../types.js';\nimport { layoutDiagnostic } from './diagnostics.js';\nimport { resolveScalarSizingLength } from './sizing-length.js';\nimport type { SizingLength } from './sizing-length.js';\n\nconst LAYOUT_PARTICIPATION_KEYS = new Set([\n  'width',\n  'height',\n  'minWidth',\n  'maxWidth',\n  'minHeight',\n  'maxHeight',\n  'padding',\n  'paddingStart',\n  'paddingEnd',\n  'boxSizing',\n  'borderWidth',\n  'borderStartWidth',\n  'borderEndWidth',\n  'aspectRatio',\n  'margin',\n  'marginTop',\n  'marginRight',\n  'marginBottom',\n  'marginLeft',\n  'marginStart',\n  'marginEnd',\n  'overflow',\n  'left',\n  'top',\n  'alignSelf',\n  'justifySelf',\n  'flexBasis',\n  'flexGrow',\n  'flexShrink',\n  'gridColumnStart',\n  'gridColumnSpan',\n  'gridRowStart',\n  'gridRowSpan',\n]);\n\nexport function stripLayoutParticipation<S extends SystemStyle>(\n  style: Readonly<S>,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(style)) {\n    if (!LAYOUT_PARTICIPATION_KEYS.has(key)) result[key] = value;\n  }\n  return result;\n}\n\nexport function resolveRequiredLength(\n  value: SizingLength,\n  reference: number,\n  property: string,\n  context: Readonly<StyleResolutionContext>,\n): number {\n  const resolved = resolveScalarSizingLength(value, reference, property, context);\n  if (resolved === undefined) {\n    throw layoutDiagnostic({\n      component: context.component,\n      property,\n      value,\n      algorithm: context.algorithm,\n      constraints: context.constraints,\n      reason: 'must resolve to a finite number before rendering',\n    });\n  }\n  return resolved;\n}\n\nexport function resolveOptionalLength(\n  value: SizingLength | undefined,\n  reference: number,\n  property: string,\n  context: Readonly<StyleResolutionContext>,\n): number | undefined {\n  if (value === undefined) return undefined;\n  return resolveScalarSizingLength(value, reference, property, context);\n}\n\nexport function resolveLocalOffset(\n  value: Exclude<Length, 'auto'> | undefined,\n  reference: number,\n  property: string,\n  context: Readonly<StyleResolutionContext>,\n): number {\n  return resolveRequiredLength(value ?? 0, reference, property, context);\n}\n"],
+  "mappings": "AAEA,SAAS,wBAAwB;AACjC,SAAS,iCAAiC;AAG1C,MAAM,4BAA4B,oBAAI,IAAI;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,SAAS,yBACd,OACyB;AACzB,QAAM,SAAkC,CAAC;AACzC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,CAAC,0BAA0B,IAAI,GAAG,EAAG,QAAO,GAAG,IAAI;AAAA,EACzD;AACA,SAAO;AACT;AAEO,SAAS,sBACd,OACA,WACA,UACA,SACQ;AACR,QAAM,WAAW,0BAA0B,OAAO,WAAW,UAAU,OAAO;AAC9E,MAAI,aAAa,QAAW;AAC1B,UAAM,iBAAiB;AAAA,MACrB,WAAW,QAAQ;AAAA,MACnB;AAAA,MACA;AAAA,MACA,WAAW,QAAQ;AAAA,MACnB,aAAa,QAAQ;AAAA,MACrB,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAEO,SAAS,sBACd,OACA,WACA,UACA,SACoB;AACpB,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,0BAA0B,OAAO,WAAW,UAAU,OAAO;AACtE;AAEO,SAAS,mBACd,OACA,WACA,UACA,SACQ;AACR,SAAO,sBAAsB,SAAS,GAAG,WAAW,UAAU,OAAO;AACvE;",
   "names": []
 }

package/dist/lib/style/resolve-dispatch.d.ts

@@ -7,8 +7,11 @@ export interface PreparedStyleInput {
     source: PibblElement<any>;
     query?: PreparedQuery;
 }
+export declare function setAllocatedContentSize(element: PibblElement<any>, width: number, height: number): void;
 /** @internal Carries one normalized style through an internal placement descriptor. */
 export declare function setPreNormalizedStyle(element: PibblElement<any>, style: Readonly<SystemStyle>, source?: PibblElement<any>, receiverToken?: object, query?: PreparedQuery): void;
+/** @internal Reads a settled descriptor for known descendant preparation. */
+export declare function peekPreNormalizedStyle(element: PibblElement<any>): PreparedStyleInput | undefined;
 /** @internal Consumes an internal normalized-style override exactly once. */
 export declare function takePreNormalizedStyle(element: PibblElement<any>): PreparedStyleInput | undefined;
 /** @internal Registers strings that are data, paint, or enums, not allocation syntax. */

package/dist/lib/style/resolve-dispatch.js

@@ -1,3 +1,6 @@
+import { isKnownLayoutType } from "../layout/prepared-root.js";
+import { nativeLayout } from "../layout/wasm/region.js";
+import { allocatedContentBoxStyle } from "../layout/box-sizing.js";
 import { resolveTransitionBinding } from "../transitions/binding.js";
 import { getLayoutBox, getPercentageBasis } from "../layout/context.js";
 import { EMPTY_STYLE } from "./empty-style.js";
@@ -13,15 +16,23 @@ import {
   consumePlacementHandoff,
   getPlacementSignalHandoff,
   getPlacementHandoffSource,
+  resolveForwardedDerivedAbsoluteAxes,
   resolveStandalonePosition
 } from "./positioning.js";
 import { CANVAS_2D_BACKEND } from "../backend/canvas-2d-backend.js";
 const opaqueStyleProperties = /* @__PURE__ */ new WeakMap();
+const allocatedContentSizes = /* @__PURE__ */ new WeakMap();
+function setAllocatedContentSize(element, width, height) {
+  allocatedContentSizes.set(element, { width, height });
+}
 const preNormalizedStyles = /* @__PURE__ */ new WeakMap();
 function setPreNormalizedStyle(element, style, source = element, receiverToken, query) {
   preNormalizedStyles.set(element, { style, source, query });
   if (receiverToken) setPrimitiveReceiverToken(element, receiverToken);
 }
+function peekPreNormalizedStyle(element) {
+  return preNormalizedStyles.get(element);
+}
 function takePreNormalizedStyle(element) {
   const value = preNormalizedStyles.get(element);
   preNormalizedStyles.delete(element);
@@ -71,6 +82,15 @@ function resolveElementStyle(element, resolvedSpecifiedStyle, hasResolvedSpecifi
     getSpecifiedStyle(element)
   ) ?? getPlacementSignalHandoff(element);
   const handoffStyle = consumePlacementHandoff(resolvedInput);
+  const forwarded = forwardedStyle;
+  if (forwarded?.position === "absolute") {
+    assertExplicitPositionBoundary(
+      handoffStyle,
+      forwarded,
+      isPlacementConsumed(element),
+      context
+    );
+  }
   const ordinaryFilter = extractSystemFilter(handoffStyle);
   const transitionFilters = handoffStyle.transition === void 0 ? void 0 : resolveTransitionBinding(handoffStyle.transition);
   const combined = transitionFilters?.length ? [...ordinaryFilter === void 0 ? [] : Array.isArray(ordinaryFilter) ? ordinaryFilter : [ordinaryFilter], ...transitionFilters] : ordinaryFilter;
@@ -78,17 +98,22 @@ function resolveElementStyle(element, resolvedSpecifiedStyle, hasResolvedSpecifi
     combined,
     context
   );
-  const normalized = preNormalized ? withoutSystemFilter(handoffStyle) : definition.normalizeStyle ? definition.normalizeStyle(
+  const normalizedInput = preNormalized ? withoutSystemFilter(handoffStyle) : definition.normalizeStyle ? definition.normalizeStyle(
     withoutSystemFilter(handoffStyle)
   ) : withoutSystemFilter(handoffStyle);
+  const normalizedDimensions = resolveForwardedDerivedAbsoluteAxes(normalizedInput, forwardedStyle);
+  const usedSize = allocatedContentSizes.get(element);
+  allocatedContentSizes.delete(element);
+  const normalized = usedSize ? allocatedContentBoxStyle(normalizedDimensions, usedSize.width, usedSize.height) : normalizedDimensions;
   const resolved = definition.resolveStyle ? definition.resolveStyle(normalized, context) : normalized;
   const positioning = normalized;
-  const hasLeft = positioning.left !== void 0;
-  const hasTop = positioning.top !== void 0;
+  const staticLayout = nativeLayout && positioning.position === "static" && isKnownLayoutType(element.type);
+  if (!staticLayout) assertExplicitPositionBoundary(positioning, forwarded, isPlacementConsumed(element), context);
+  const hasLeft = !staticLayout && positioning.left !== void 0;
+  const hasTop = !staticLayout && positioning.top !== void 0;
   let positioned = resolved;
   if (definition.backend === CANVAS_2D_BACKEND.token && (hasLeft || hasTop)) {
     const standalone = resolveStandalonePosition(normalized, context);
-    const forwarded = forwardedStyle;
     const consumesOuterPosition = isPlacementConsumed(element);
     const position = {
       left: consumesOuterPosition || forwarded !== void 0 && Object.is(positioning.left, forwarded.left) ? 0 : standalone.left,
@@ -110,7 +135,53 @@ function resolveElementStyle(element, resolvedSpecifiedStyle, hasResolvedSpecifi
   );
   return final;
 }
+function assertExplicitPositionBoundary(positioning, forwarded, consumesOuterPosition, context) {
+  const position = positioning.position;
+  if ((positioning.insetStart !== void 0 || positioning.insetEnd !== void 0) && position !== "absolute") {
+    throw layoutDiagnostic({
+      component: context.component,
+      property: "position",
+      value: position,
+      algorithm: "render-dispatch",
+      constraints: context.constraints,
+      reason: "PIBBL_LAYOUT_UNSUPPORTED_POSITION: logical insets require a supported direct absolute Flex child"
+    });
+  }
+  const hasRightOrBottom = positioning.right !== void 0 || positioning.bottom !== void 0;
+  if (position === void 0) {
+    if (!hasRightOrBottom) return;
+    throw layoutDiagnostic({
+      component: context.component,
+      property: positioning.right !== void 0 ? "right" : "bottom",
+      value: positioning.right ?? positioning.bottom,
+      algorithm: "render-dispatch",
+      constraints: context.constraints,
+      reason: "PIBBL_LAYOUT_IGNORED_POSITION: right/bottom require an explicit position in a supported direct Flex child"
+    });
+  }
+  if (position !== "static" && position !== "relative" && position !== "absolute") {
+    throw layoutDiagnostic({
+      component: context.component,
+      property: "position",
+      value: position,
+      algorithm: "render-dispatch",
+      constraints: context.constraints,
+      reason: "PIBBL_LAYOUT_UNSUPPORTED_POSITION: uses an unsupported placement mode"
+    });
+  }
+  if (consumesOuterPosition) return;
+  if (forwarded !== void 0 && Object.is(positioning.position, forwarded.position) && Object.is(positioning.left, forwarded.left) && Object.is(positioning.right, forwarded.right) && Object.is(positioning.top, forwarded.top) && Object.is(positioning.bottom, forwarded.bottom) && Object.is(positioning.insetStart, forwarded.insetStart) && Object.is(positioning.insetEnd, forwarded.insetEnd)) return;
+  throw layoutDiagnostic({
+    component: context.component,
+    property: "position",
+    value: position,
+    algorithm: "render-dispatch",
+    constraints: context.constraints,
+    reason: "PIBBL_LAYOUT_UNSUPPORTED_POSITION: requires direct Flex placement or one exact forwarded position/inset style"
+  });
+}
 function assertResolvedValue(value, property, context, seen, opaqueProperties) {
+  if (opaqueProperties.has(property)) return;
   if (typeof value === "number") {
     if (!Number.isFinite(value)) {
       throw unresolvedDiagnostic(property, value, context, "must be finite");
@@ -158,8 +229,10 @@ function unresolvedDiagnostic(property, value, context, reason) {
 }
 export {
   extractSystemFilter,
+  peekPreNormalizedStyle,
   registerOpaqueStyleProperties,
   resolveElementStyle,
+  setAllocatedContentSize,
   setPreNormalizedStyle,
   takePreNormalizedStyle,
   withoutSystemFilter

package/dist/lib/style/resolve-dispatch.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/style/resolve-dispatch.ts"],
-  "sourcesContent": ["import { resolveTransitionBinding } from '../transitions/binding.js';\nimport { type PreparedQuery } from './responsive.js';\nimport { getLayoutBox, getPercentageBasis } from '../layout/context.js';\nimport { EMPTY_STYLE } from './empty-style.js';\nimport {\n  getPrimitiveDefinition,\n  getSpecifiedStyle,\n  setPrimitiveReceiverToken,\n  type PrimitiveDefinition,\n} from '../element/metadata.js';\nimport type { PibblElement } from '../element/types.js';\nimport type {\n  ResolvedStyle,\n  SpecifiedStyle,\n  StyleResolutionContext,\n  SystemStyle,\n} from '../types.js';\nimport { layoutDiagnostic } from './diagnostics.js';\nimport { resolveFilterList } from './filter.js';\nimport type { PibblFilter } from './filter-types.js';\nimport { isPlacementConsumed } from '../element/metadata.js';\nimport {\n  consumePlacementHandoff,\n  getPlacementSignalHandoff,\n  getPlacementHandoffSource,\n  resolveStandalonePosition,\n  type PositioningStyle,\n} from './positioning.js';\nimport { CANVAS_2D_BACKEND } from '../backend/canvas-2d-backend.js';\n\nconst opaqueStyleProperties = new WeakMap<Function, ReadonlySet<string>>();\nexport interface PreparedStyleInput {\n  style: Readonly<SystemStyle>;\n  source: PibblElement<any>;\n  query?: PreparedQuery;\n}\nconst preNormalizedStyles = new WeakMap<PibblElement<any>, PreparedStyleInput>();\n\n/** @internal Carries one normalized style through an internal placement descriptor. */\nexport function setPreNormalizedStyle(\n  element: PibblElement<any>,\n  style: Readonly<SystemStyle>,\n  source: PibblElement<any> = element,\n  receiverToken?: object,\n  query?: PreparedQuery,\n): void {\n  preNormalizedStyles.set(element, { style, source, query });\n  if (receiverToken) setPrimitiveReceiverToken(element, receiverToken);\n}\n\n/** @internal Consumes an internal normalized-style override exactly once. */\nexport function takePreNormalizedStyle(\n  element: PibblElement<any>,\n): PreparedStyleInput | undefined {\n  const value = preNormalizedStyles.get(element);\n  preNormalizedStyles.delete(element);\n  return value;\n}\n\n/** @internal Registers strings that are data, paint, or enums, not allocation syntax. */\nexport function registerOpaqueStyleProperties(\n  type: Function,\n  properties: readonly string[],\n): void {\n  opaqueStyleProperties.set(type, new Set(properties));\n}\n\n/** @internal Reads the framework-owned filter property from a system style. */\nexport function extractSystemFilter(\n  style: Readonly<SystemStyle>,\n): PibblFilter | readonly PibblFilter[] | undefined {\n  return style.filter;\n}\n\n/** @internal Removes the framework-owned filter before custom style callbacks run. */\nexport function withoutSystemFilter(\n  style: Readonly<SystemStyle>,\n): Readonly<SystemStyle> {\n  if (!('when' in style)) {\n    const { filter: _filter, transition: _transition, ...withoutFilter } = style;\n    return Object.freeze(withoutFilter);\n  }\n  const { filter: _filter, transition: _transition, when: _when, ...withoutFilter } = style as Readonly<SystemStyle> & { when?: unknown };\n  return Object.freeze(withoutFilter);\n}\n\nexport function resolveElementStyle<\n  S extends SystemStyle,\n  N extends SystemStyle,\n  R extends SystemStyle,\n>(\n  element: PibblElement<any>,\n  resolvedSpecifiedStyle?: Readonly<SystemStyle>,\n  hasResolvedSpecifiedStyle = false,\n  prepared?: PreparedStyleInput,\n): ResolvedStyle<R> {\n  const allocation = getLayoutBox();\n  const percentageBasis = getPercentageBasis();\n  const type = element.type;\n  const definition = getPrimitiveDefinition(type) as\n    PrimitiveDefinition<any, S, N, R> | undefined;\n  if (!definition) {\n    throw new Error(\n      `${type.name || 'Anonymous'} does not have Pibbl primitive metadata`,\n    );\n  }\n  const component = type.name || 'Anonymous';\n  const context: StyleResolutionContext = {\n    allocation,\n    percentageBasis,\n    constraints: {\n      minWidth: 0,\n      maxWidth: allocation.width,\n      minHeight: 0,\n      maxHeight: allocation.height,\n    },\n    component,\n    algorithm: 'render-dispatch',\n  };\n  // The renderer already consumed placement metadata before resolving inputs.\n  const preNormalized = prepared;\n  const specified = ((hasResolvedSpecifiedStyle ?\n    resolvedSpecifiedStyle : getSpecifiedStyle(element)) ?? EMPTY_STYLE) as\n    SpecifiedStyle<S>;\n  const resolvedInput = preNormalized?.style ?? specified;\n  const forwardedStyle = getPlacementHandoffSource(\n    getSpecifiedStyle(element),\n  ) ?? getPlacementSignalHandoff(element);\n  const handoffStyle = consumePlacementHandoff(resolvedInput);\n  const ordinaryFilter = extractSystemFilter(handoffStyle);\n  const transitionFilters = handoffStyle.transition === undefined ? undefined : resolveTransitionBinding(handoffStyle.transition);\n  const combined = transitionFilters?.length ? [...(ordinaryFilter === undefined ? [] : Array.isArray(ordinaryFilter) ? ordinaryFilter : [ordinaryFilter]), ...transitionFilters] : ordinaryFilter;\n  const systemFilter = resolveFilterList(\n    combined,\n    context,\n  );\n  const normalized = preNormalized ?\n      withoutSystemFilter(handoffStyle) as Readonly<N> :\n    definition.normalizeStyle ?\n        definition.normalizeStyle(\n          withoutSystemFilter(handoffStyle) as SpecifiedStyle<S>,\n        ) :\n        withoutSystemFilter(handoffStyle) as unknown as Readonly<N>;\n  const resolved = definition.resolveStyle ?\n      definition.resolveStyle(normalized, context) :\n      normalized as unknown as ResolvedStyle<R>;\n  const positioning = normalized as Readonly<PositioningStyle>;\n  const hasLeft = positioning.left !== undefined;\n  const hasTop = positioning.top !== undefined;\n  let positioned = resolved;\n  if (definition.backend === CANVAS_2D_BACKEND.token && (hasLeft || hasTop)) {\n    const standalone = resolveStandalonePosition(normalized, context);\n    const forwarded = forwardedStyle as Readonly<PositioningStyle> | undefined;\n    const consumesOuterPosition = isPlacementConsumed(element);\n    const position = {\n      left: consumesOuterPosition ||\n        (forwarded !== undefined && Object.is(positioning.left, forwarded.left)) ?\n        0 : standalone.left,\n      top: consumesOuterPosition ||\n        (forwarded !== undefined && Object.is(positioning.top, forwarded.top)) ?\n        0 : standalone.top,\n    };\n    positioned = {\n      ...resolved,\n      ...(hasLeft ? { left: position.left } : {}),\n      ...(hasTop ? { top: position.top } : {}),\n    };\n  }\n  const final = systemFilter ? { ...positioned, filter: systemFilter.values } : positioned;\n  assertResolvedValue(\n    final,\n    '',\n    context,\n    new Set(),\n    opaqueStyleProperties.get(type) ?? new Set(),\n  );\n  return final;\n}\n\nfunction assertResolvedValue(\n  value: unknown,\n  property: string,\n  context: Readonly<StyleResolutionContext>,\n  seen: Set<object>,\n  opaqueProperties: ReadonlySet<string>,\n): void {\n  if (typeof value === 'number') {\n    if (!Number.isFinite(value)) {\n      throw unresolvedDiagnostic(property, value, context, 'must be finite');\n    }\n    return;\n  }\n  if (typeof value === 'string') {\n    if (\n      !opaqueProperties.has(property) &&\n      (value === 'auto' || value.endsWith('%'))\n    ) {\n      throw unresolvedDiagnostic(\n        property,\n        value,\n        context,\n        'must resolve before the component callback is invoked',\n      );\n    }\n    return;\n  }\n  if (!value || typeof value !== 'object' || seen.has(value)) return;\n  if (property === 'custom' || property === 'filter') return;\n  const prototype = Object.getPrototypeOf(value);\n  if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {\n    return;\n  }\n  seen.add(value);\n  for (const [key, child] of Object.entries(value)) {\n    if (key === 'custom') continue;\n    assertResolvedValue(\n      child,\n      property ? `${property}.${key}` : key,\n      context,\n      seen,\n      opaqueProperties,\n    );\n  }\n}\n\nfunction unresolvedDiagnostic(\n  property: string,\n  value: unknown,\n  context: Readonly<StyleResolutionContext>,\n  reason: string,\n) {\n  return layoutDiagnostic({\n    component: context.component,\n    property: property || 'style',\n    value,\n    algorithm: context.algorithm,\n    constraints: context.constraints,\n    reason,\n  });\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { isKnownLayoutType } from '../layout/prepared-root.js';\nimport { nativeLayout } from '../layout/wasm/region.js';\nimport { allocatedContentBoxStyle } from '../layout/box-sizing.js';\nimport { resolveTransitionBinding } from '../transitions/binding.js';\nimport { type PreparedQuery } from './responsive.js';\nimport { getLayoutBox, getPercentageBasis } from '../layout/context.js';\nimport { EMPTY_STYLE } from './empty-style.js';\nimport {\n  getPrimitiveDefinition,\n  getSpecifiedStyle,\n  setPrimitiveReceiverToken,\n  type PrimitiveDefinition,\n} from '../element/metadata.js';\nimport type { PibblElement } from '../element/types.js';\nimport type {\n  ResolvedStyle,\n  SpecifiedStyle,\n  StyleResolutionContext,\n  SystemStyle,\n} from '../types.js';\nimport { layoutDiagnostic } from './diagnostics.js';\nimport { resolveFilterList } from './filter.js';\nimport type { PibblFilter } from './filter-types.js';\nimport { isPlacementConsumed } from '../element/metadata.js';\nimport {\n  consumePlacementHandoff,\n  getPlacementSignalHandoff,\n  getPlacementHandoffSource,\n  resolveForwardedDerivedAbsoluteAxes,\n  resolveStandalonePosition,\n  type PositioningStyle,\n} from './positioning.js';\nimport { CANVAS_2D_BACKEND } from '../backend/canvas-2d-backend.js';\n\nconst opaqueStyleProperties = new WeakMap<Function, ReadonlySet<string>>();\nexport interface PreparedStyleInput {\n  style: Readonly<SystemStyle>;\n  source: PibblElement<any>;\n  query?: PreparedQuery;\n}\nconst allocatedContentSizes = new WeakMap<PibblElement<any>, { width: number; height: number }>();\nexport function setAllocatedContentSize(element: PibblElement<any>, width: number, height: number): void {\n  allocatedContentSizes.set(element, { width, height });\n}\n\nconst preNormalizedStyles = new WeakMap<PibblElement<any>, PreparedStyleInput>();\n\n/** @internal Carries one normalized style through an internal placement descriptor. */\nexport function setPreNormalizedStyle(\n  element: PibblElement<any>,\n  style: Readonly<SystemStyle>,\n  source: PibblElement<any> = element,\n  receiverToken?: object,\n  query?: PreparedQuery,\n): void {\n  preNormalizedStyles.set(element, { style, source, query });\n  if (receiverToken) setPrimitiveReceiverToken(element, receiverToken);\n}\n\n/** @internal Reads a settled descriptor for known descendant preparation. */\nexport function peekPreNormalizedStyle(element: PibblElement<any>): PreparedStyleInput | undefined {\n  return preNormalizedStyles.get(element);\n}\n\n/** @internal Consumes an internal normalized-style override exactly once. */\nexport function takePreNormalizedStyle(\n  element: PibblElement<any>,\n): PreparedStyleInput | undefined {\n  const value = preNormalizedStyles.get(element);\n  preNormalizedStyles.delete(element);\n  return value;\n}\n\n/** @internal Registers strings that are data, paint, or enums, not allocation syntax. */\nexport function registerOpaqueStyleProperties(\n  type: Function,\n  properties: readonly string[],\n): void {\n  opaqueStyleProperties.set(type, new Set(properties));\n}\n\n/** @internal Reads the framework-owned filter property from a system style. */\nexport function extractSystemFilter(\n  style: Readonly<SystemStyle>,\n): PibblFilter | readonly PibblFilter[] | undefined {\n  return style.filter;\n}\n\n/** @internal Removes the framework-owned filter before custom style callbacks run. */\nexport function withoutSystemFilter(\n  style: Readonly<SystemStyle>,\n): Readonly<SystemStyle> {\n  if (!('when' in style)) {\n    const { filter: _filter, transition: _transition, ...withoutFilter } = style;\n    return Object.freeze(withoutFilter);\n  }\n  const { filter: _filter, transition: _transition, when: _when, ...withoutFilter } = style as Readonly<SystemStyle> & { when?: unknown };\n  return Object.freeze(withoutFilter);\n}\n\nexport function resolveElementStyle<\n  S extends SystemStyle,\n  N extends SystemStyle,\n  R extends SystemStyle,\n>(\n  element: PibblElement<any>,\n  resolvedSpecifiedStyle?: Readonly<SystemStyle>,\n  hasResolvedSpecifiedStyle = false,\n  prepared?: PreparedStyleInput,\n): ResolvedStyle<R> {\n  const allocation = getLayoutBox();\n  const percentageBasis = getPercentageBasis();\n  const type = element.type;\n  const definition = getPrimitiveDefinition(type) as\n    PrimitiveDefinition<any, S, N, R> | undefined;\n  if (!definition) {\n    throw new Error(\n      `${type.name || 'Anonymous'} does not have Pibbl primitive metadata`,\n    );\n  }\n  const component = type.name || 'Anonymous';\n  const context: StyleResolutionContext = {\n    allocation,\n    percentageBasis,\n    constraints: {\n      minWidth: 0,\n      maxWidth: allocation.width,\n      minHeight: 0,\n      maxHeight: allocation.height,\n    },\n    component,\n    algorithm: 'render-dispatch',\n  };\n  // The renderer already consumed placement metadata before resolving inputs.\n  const preNormalized = prepared;\n  const specified = ((hasResolvedSpecifiedStyle ?\n    resolvedSpecifiedStyle : getSpecifiedStyle(element)) ?? EMPTY_STYLE) as\n    SpecifiedStyle<S>;\n  const resolvedInput = preNormalized?.style ?? specified;\n  const forwardedStyle = getPlacementHandoffSource(\n    getSpecifiedStyle(element),\n  ) ?? getPlacementSignalHandoff(element);\n  const handoffStyle = consumePlacementHandoff(resolvedInput);\n  const forwarded = forwardedStyle as Readonly<PositioningStyle> | undefined;\n  if (forwarded?.position === 'absolute') {\n    assertExplicitPositionBoundary(\n      handoffStyle as Readonly<PositioningStyle>, forwarded, isPlacementConsumed(element), context,\n    );\n  }\n  const ordinaryFilter = extractSystemFilter(handoffStyle);\n  const transitionFilters = handoffStyle.transition === undefined ? undefined : resolveTransitionBinding(handoffStyle.transition);\n  const combined = transitionFilters?.length ? [...(ordinaryFilter === undefined ? [] : Array.isArray(ordinaryFilter) ? ordinaryFilter : [ordinaryFilter]), ...transitionFilters] : ordinaryFilter;\n  const systemFilter = resolveFilterList(\n    combined,\n    context,\n  );\n  const normalizedInput = preNormalized ?\n      withoutSystemFilter(handoffStyle) as Readonly<N> :\n    definition.normalizeStyle ?\n        definition.normalizeStyle(\n          withoutSystemFilter(handoffStyle) as SpecifiedStyle<S>,\n        ) :\n        withoutSystemFilter(handoffStyle) as unknown as Readonly<N>;\n  const normalizedDimensions = resolveForwardedDerivedAbsoluteAxes(normalizedInput, forwardedStyle) as Readonly<N>;\n  const usedSize = allocatedContentSizes.get(element);\n  allocatedContentSizes.delete(element);\n  const normalized = usedSize ? allocatedContentBoxStyle(normalizedDimensions, usedSize.width, usedSize.height) as Readonly<N> : normalizedDimensions;\n  const resolved = definition.resolveStyle ?\n      definition.resolveStyle(normalized, context) :\n      normalized as unknown as ResolvedStyle<R>;\n  const positioning = normalized as Readonly<PositioningStyle>;\n  const staticLayout = nativeLayout && positioning.position === 'static' && isKnownLayoutType(element.type);\n  if (!staticLayout) assertExplicitPositionBoundary(positioning, forwarded, isPlacementConsumed(element), context);\n  const hasLeft = !staticLayout && positioning.left !== undefined;\n  const hasTop = !staticLayout && positioning.top !== undefined;\n  let positioned = resolved;\n  if (definition.backend === CANVAS_2D_BACKEND.token && (hasLeft || hasTop)) {\n    const standalone = resolveStandalonePosition(normalized, context);\n    const consumesOuterPosition = isPlacementConsumed(element);\n    const position = {\n      left: consumesOuterPosition ||\n        (forwarded !== undefined && Object.is(positioning.left, forwarded.left)) ?\n        0 : standalone.left,\n      top: consumesOuterPosition ||\n        (forwarded !== undefined && Object.is(positioning.top, forwarded.top)) ?\n        0 : standalone.top,\n    };\n    positioned = {\n      ...resolved,\n      ...(hasLeft ? { left: position.left } : {}),\n      ...(hasTop ? { top: position.top } : {}),\n    };\n  }\n  const final = systemFilter ? { ...positioned, filter: systemFilter.values } : positioned;\n  assertResolvedValue(\n    final,\n    '',\n    context,\n    new Set(),\n    opaqueStyleProperties.get(type) ?? new Set(),\n  );\n  return final;\n}\n\n\nfunction assertExplicitPositionBoundary(\n  positioning: Readonly<PositioningStyle>,\n  forwarded: Readonly<PositioningStyle> | undefined,\n  consumesOuterPosition: boolean,\n  context: Readonly<StyleResolutionContext>,\n): void {\n  const position = positioning.position;\n  if ((positioning.insetStart !== undefined || positioning.insetEnd !== undefined) && position !== 'absolute') {\n    throw layoutDiagnostic({ component: context.component, property: 'position', value: position,\n      algorithm: 'render-dispatch', constraints: context.constraints,\n      reason: 'PIBBL_LAYOUT_UNSUPPORTED_POSITION: logical insets require a supported direct absolute Flex child' });\n  }\n  const hasRightOrBottom = positioning.right !== undefined || positioning.bottom !== undefined;\n  if (position === undefined) {\n    if (!hasRightOrBottom) return;\n    throw layoutDiagnostic({\n      component: context.component,\n      property: positioning.right !== undefined ? 'right' : 'bottom',\n      value: positioning.right ?? positioning.bottom,\n      algorithm: 'render-dispatch',\n      constraints: context.constraints,\n      reason: 'PIBBL_LAYOUT_IGNORED_POSITION: right/bottom require an explicit position in a supported direct Flex child',\n    });\n  }\n  if (position !== 'static' && position !== 'relative' && position !== 'absolute') {\n    throw layoutDiagnostic({\n      component: context.component,\n      property: 'position',\n      value: position,\n      algorithm: 'render-dispatch',\n      constraints: context.constraints,\n      reason: 'PIBBL_LAYOUT_UNSUPPORTED_POSITION: uses an unsupported placement mode',\n    });\n  }\n  if (consumesOuterPosition) return;\n  if (forwarded !== undefined &&\n    Object.is(positioning.position, forwarded.position) &&\n    Object.is(positioning.left, forwarded.left) &&\n    Object.is(positioning.right, forwarded.right) &&\n    Object.is(positioning.top, forwarded.top) &&\n    Object.is(positioning.bottom, forwarded.bottom) &&\n    Object.is(positioning.insetStart, forwarded.insetStart) &&\n    Object.is(positioning.insetEnd, forwarded.insetEnd)) return;\n  throw layoutDiagnostic({\n    component: context.component,\n    property: 'position',\n    value: position,\n    algorithm: 'render-dispatch',\n    constraints: context.constraints,\n    reason: 'PIBBL_LAYOUT_UNSUPPORTED_POSITION: requires direct Flex placement or one exact forwarded position/inset style',\n  });\n}\n\nfunction assertResolvedValue(\n  value: unknown,\n  property: string,\n  context: Readonly<StyleResolutionContext>,\n  seen: Set<object>,\n  opaqueProperties: ReadonlySet<string>,\n): void {\n  if (opaqueProperties.has(property)) return;\n  if (typeof value === 'number') {\n    if (!Number.isFinite(value)) {\n      throw unresolvedDiagnostic(property, value, context, 'must be finite');\n    }\n    return;\n  }\n  if (typeof value === 'string') {\n    if (\n      !opaqueProperties.has(property) &&\n      (value === 'auto' || value.endsWith('%'))\n    ) {\n      throw unresolvedDiagnostic(\n        property,\n        value,\n        context,\n        'must resolve before the component callback is invoked',\n      );\n    }\n    return;\n  }\n  if (!value || typeof value !== 'object' || seen.has(value)) return;\n  if (property === 'custom' || property === 'filter') return;\n  const prototype = Object.getPrototypeOf(value);\n  if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {\n    return;\n  }\n  seen.add(value);\n  for (const [key, child] of Object.entries(value)) {\n    if (key === 'custom') continue;\n    assertResolvedValue(\n      child,\n      property ? `${property}.${key}` : key,\n      context,\n      seen,\n      opaqueProperties,\n    );\n  }\n}\n\nfunction unresolvedDiagnostic(\n  property: string,\n  value: unknown,\n  context: Readonly<StyleResolutionContext>,\n  reason: string,\n) {\n  return layoutDiagnostic({\n    component: context.component,\n    property: property || 'style',\n    value,\n    algorithm: context.algorithm,\n    constraints: context.constraints,\n    reason,\n  });\n}\n"],
+  "mappings": "AAAA,SAAS,yBAAyB;AAClC,SAAS,oBAAoB;AAC7B,SAAS,gCAAgC;AACzC,SAAS,gCAAgC;AAEzC,SAAS,cAAc,0BAA0B;AACjD,SAAS,mBAAmB;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAQP,SAAS,wBAAwB;AACjC,SAAS,yBAAyB;AAElC,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,yBAAyB;AAElC,MAAM,wBAAwB,oBAAI,QAAuC;AAMzE,MAAM,wBAAwB,oBAAI,QAA8D;AACzF,SAAS,wBAAwB,SAA4B,OAAe,QAAsB;AACvG,wBAAsB,IAAI,SAAS,EAAE,OAAO,OAAO,CAAC;AACtD;AAEA,MAAM,sBAAsB,oBAAI,QAA+C;AAGxE,SAAS,sBACd,SACA,OACA,SAA4B,SAC5B,eACA,OACM;AACN,sBAAoB,IAAI,SAAS,EAAE,OAAO,QAAQ,MAAM,CAAC;AACzD,MAAI,cAAe,2BAA0B,SAAS,aAAa;AACrE;AAGO,SAAS,uBAAuB,SAA4D;AACjG,SAAO,oBAAoB,IAAI,OAAO;AACxC;AAGO,SAAS,uBACd,SACgC;AAChC,QAAM,QAAQ,oBAAoB,IAAI,OAAO;AAC7C,sBAAoB,OAAO,OAAO;AAClC,SAAO;AACT;AAGO,SAAS,8BACd,MACA,YACM;AACN,wBAAsB,IAAI,MAAM,IAAI,IAAI,UAAU,CAAC;AACrD;AAGO,SAAS,oBACd,OACkD;AAClD,SAAO,MAAM;AACf;AAGO,SAAS,oBACd,OACuB;AACvB,MAAI,EAAE,UAAU,QAAQ;AACtB,UAAM,EAAE,QAAQA,UAAS,YAAYC,cAAa,GAAGC,eAAc,IAAI;AACvE,WAAO,OAAO,OAAOA,cAAa;AAAA,EACpC;AACA,QAAM,EAAE,QAAQ,SAAS,YAAY,aAAa,MAAM,OAAO,GAAG,cAAc,IAAI;AACpF,SAAO,OAAO,OAAO,aAAa;AACpC;AAEO,SAAS,oBAKd,SACA,wBACA,4BAA4B,OAC5B,UACkB;AAClB,QAAM,aAAa,aAAa;AAChC,QAAM,kBAAkB,mBAAmB;AAC3C,QAAM,OAAO,QAAQ;AACrB,QAAM,aAAa,uBAAuB,IAAI;AAE9C,MAAI,CAAC,YAAY;AACf,UAAM,IAAI;AAAA,MACR,GAAG,KAAK,QAAQ,WAAW;AAAA,IAC7B;AAAA,EACF;AACA,QAAM,YAAY,KAAK,QAAQ;AAC/B,QAAM,UAAkC;AAAA,IACtC;AAAA,IACA;AAAA,IACA,aAAa;AAAA,MACX,UAAU;AAAA,MACV,UAAU,WAAW;AAAA,MACrB,WAAW;AAAA,MACX,WAAW,WAAW;AAAA,IACxB;AAAA,IACA;AAAA,IACA,WAAW;AAAA,EACb;AAEA,QAAM,gBAAgB;AACtB,QAAM,aAAc,4BAClB,yBAAyB,kBAAkB,OAAO,MAAM;AAE1D,QAAM,gBAAgB,eAAe,SAAS;AAC9C,QAAM,iBAAiB;AAAA,IACrB,kBAAkB,OAAO;AAAA,EAC3B,KAAK,0BAA0B,OAAO;AACtC,QAAM,eAAe,wBAAwB,aAAa;AAC1D,QAAM,YAAY;AAClB,MAAI,WAAW,aAAa,YAAY;AACtC;AAAA,MACE;AAAA,MAA4C;AAAA,MAAW,oBAAoB,OAAO;AAAA,MAAG;AAAA,IACvF;AAAA,EACF;AACA,QAAM,iBAAiB,oBAAoB,YAAY;AACvD,QAAM,oBAAoB,aAAa,eAAe,SAAY,SAAY,yBAAyB,aAAa,UAAU;AAC9H,QAAM,WAAW,mBAAmB,SAAS,CAAC,GAAI,mBAAmB,SAAY,CAAC,IAAI,MAAM,QAAQ,cAAc,IAAI,iBAAiB,CAAC,cAAc,GAAI,GAAG,iBAAiB,IAAI;AAClL,QAAM,eAAe;AAAA,IACnB;AAAA,IACA;AAAA,EACF;AACA,QAAM,kBAAkB,gBACpB,oBAAoB,YAAY,IAClC,WAAW,iBACP,WAAW;AAAA,IACT,oBAAoB,YAAY;AAAA,EAClC,IACA,oBAAoB,YAAY;AACtC,QAAM,uBAAuB,oCAAoC,iBAAiB,cAAc;AAChG,QAAM,WAAW,sBAAsB,IAAI,OAAO;AAClD,wBAAsB,OAAO,OAAO;AACpC,QAAM,aAAa,WAAW,yBAAyB,sBAAsB,SAAS,OAAO,SAAS,MAAM,IAAmB;AAC/H,QAAM,WAAW,WAAW,eACxB,WAAW,aAAa,YAAY,OAAO,IAC3C;AACJ,QAAM,cAAc;AACpB,QAAM,eAAe,gBAAgB,YAAY,aAAa,YAAY,kBAAkB,QAAQ,IAAI;AACxG,MAAI,CAAC,aAAc,gCAA+B,aAAa,WAAW,oBAAoB,OAAO,GAAG,OAAO;AAC/G,QAAM,UAAU,CAAC,gBAAgB,YAAY,SAAS;AACtD,QAAM,SAAS,CAAC,gBAAgB,YAAY,QAAQ;AACpD,MAAI,aAAa;AACjB,MAAI,WAAW,YAAY,kBAAkB,UAAU,WAAW,SAAS;AACzE,UAAM,aAAa,0BAA0B,YAAY,OAAO;AAChE,UAAM,wBAAwB,oBAAoB,OAAO;AACzD,UAAM,WAAW;AAAA,MACf,MAAM,yBACH,cAAc,UAAa,OAAO,GAAG,YAAY,MAAM,UAAU,IAAI,IACtE,IAAI,WAAW;AAAA,MACjB,KAAK,yBACF,cAAc,UAAa,OAAO,GAAG,YAAY,KAAK,UAAU,GAAG,IACpE,IAAI,WAAW;AAAA,IACnB;AACA,iBAAa;AAAA,MACX,GAAG;AAAA,MACH,GAAI,UAAU,EAAE,MAAM,SAAS,KAAK,IAAI,CAAC;AAAA,MACzC,GAAI,SAAS,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC;AAAA,IACxC;AAAA,EACF;AACA,QAAM,QAAQ,eAAe,EAAE,GAAG,YAAY,QAAQ,aAAa,OAAO,IAAI;AAC9E;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA,oBAAI,IAAI;AAAA,IACR,sBAAsB,IAAI,IAAI,KAAK,oBAAI,IAAI;AAAA,EAC7C;AACA,SAAO;AACT;AAGA,SAAS,+BACP,aACA,WACA,uBACA,SACM;AACN,QAAM,WAAW,YAAY;AAC7B,OAAK,YAAY,eAAe,UAAa,YAAY,aAAa,WAAc,aAAa,YAAY;AAC3G,UAAM,iBAAiB;AAAA,MAAE,WAAW,QAAQ;AAAA,MAAW,UAAU;AAAA,MAAY,OAAO;AAAA,MAClF,WAAW;AAAA,MAAmB,aAAa,QAAQ;AAAA,MACnD,QAAQ;AAAA,IAAmG,CAAC;AAAA,EAChH;AACA,QAAM,mBAAmB,YAAY,UAAU,UAAa,YAAY,WAAW;AACnF,MAAI,aAAa,QAAW;AAC1B,QAAI,CAAC,iBAAkB;AACvB,UAAM,iBAAiB;AAAA,MACrB,WAAW,QAAQ;AAAA,MACnB,UAAU,YAAY,UAAU,SAAY,UAAU;AAAA,MACtD,OAAO,YAAY,SAAS,YAAY;AAAA,MACxC,WAAW;AAAA,MACX,aAAa,QAAQ;AAAA,MACrB,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AACA,MAAI,aAAa,YAAY,aAAa,cAAc,aAAa,YAAY;AAC/E,UAAM,iBAAiB;AAAA,MACrB,WAAW,QAAQ;AAAA,MACnB,UAAU;AAAA,MACV,OAAO;AAAA,MACP,WAAW;AAAA,MACX,aAAa,QAAQ;AAAA,MACrB,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AACA,MAAI,sBAAuB;AAC3B,MAAI,cAAc,UAChB,OAAO,GAAG,YAAY,UAAU,UAAU,QAAQ,KAClD,OAAO,GAAG,YAAY,MAAM,UAAU,IAAI,KAC1C,OAAO,GAAG,YAAY,OAAO,UAAU,KAAK,KAC5C,OAAO,GAAG,YAAY,KAAK,UAAU,GAAG,KACxC,OAAO,GAAG,YAAY,QAAQ,UAAU,MAAM,KAC9C,OAAO,GAAG,YAAY,YAAY,UAAU,UAAU,KACtD,OAAO,GAAG,YAAY,UAAU,UAAU,QAAQ,EAAG;AACvD,QAAM,iBAAiB;AAAA,IACrB,WAAW,QAAQ;AAAA,IACnB,UAAU;AAAA,IACV,OAAO;AAAA,IACP,WAAW;AAAA,IACX,aAAa,QAAQ;AAAA,IACrB,QAAQ;AAAA,EACV,CAAC;AACH;AAEA,SAAS,oBACP,OACA,UACA,SACA,MACA,kBACM;AACN,MAAI,iBAAiB,IAAI,QAAQ,EAAG;AACpC,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AAC3B,YAAM,qBAAqB,UAAU,OAAO,SAAS,gBAAgB;AAAA,IACvE;AACA;AAAA,EACF;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,QACE,CAAC,iBAAiB,IAAI,QAAQ,MAC7B,UAAU,UAAU,MAAM,SAAS,GAAG,IACvC;AACA,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA;AAAA,EACF;AACA,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,KAAK,IAAI,KAAK,EAAG;AAC5D,MAAI,aAAa,YAAY,aAAa,SAAU;AACpD,QAAM,YAAY,OAAO,eAAe,KAAK;AAC7C,MAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,cAAc,OAAO,aAAa,cAAc,MAAM;AACjF;AAAA,EACF;AACA,OAAK,IAAI,KAAK;AACd,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,QAAQ,SAAU;AACtB;AAAA,MACE;AAAA,MACA,WAAW,GAAG,QAAQ,IAAI,GAAG,KAAK;AAAA,MAClC;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,qBACP,UACA,OACA,SACA,QACA;AACA,SAAO,iBAAiB;AAAA,IACtB,WAAW,QAAQ;AAAA,IACnB,UAAU,YAAY;AAAA,IACtB;AAAA,IACA,WAAW,QAAQ;AAAA,IACnB,aAAa,QAAQ;AAAA,IACrB;AAAA,EACF,CAAC;AACH;",
   "names": ["_filter", "_transition", "withoutFilter"]
 }

package/dist/lib/style/resolve-length.d.ts

@@ -14,3 +14,5 @@ import type { Length } from './types.js';
  * @see {@link LayoutDiagnosticContext}
  */
 export declare function resolveLength(value: Length, reference: number | undefined, property: string, context?: Readonly<LayoutDiagnosticContext>): number | undefined;
+/** @internal Parse a percentage independently of its containing-size reference. */
+export declare function parsePercentage(value: unknown, property: string, context?: Readonly<LayoutDiagnosticContext>): number;