@pibbl/core 0.0.1

package/dist/lib/style/positioning.js

@@ -0,0 +1,81 @@
+import {
+  getPlacementSignalHandoffStyle,
+  setPlacementSignalHandoff
+} from "../element/metadata.js";
+import { isSignal } from "../signals/graph.js";
+import { resolveLocalOffset } from "./resolve-built-in.js";
+const PLACEMENT_HANDOFF = /* @__PURE__ */ Symbol("pibbl.placement-handoff");
+let activeSignalHandoff;
+function hasPositioning(style) {
+  if (Object.hasOwn(style, "left") || Object.hasOwn(style, "top")) 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"));
+  });
+}
+function withPlacementHandoff(props, consumedStyle) {
+  if (!props || typeof props !== "object") return props;
+  const candidate = props;
+  const style = candidate.style;
+  if (!style || typeof style !== "object" || isSignal(style) || style[PLACEMENT_HANDOFF] !== void 0 || !hasPositioning(style)) {
+    return props;
+  }
+  return {
+    ...candidate,
+    style: Object.freeze({
+      ...style,
+      [PLACEMENT_HANDOFF]: Object.freeze({
+        source: consumedStyle ?? style
+      })
+    })
+  };
+}
+function enterPlacementHandoffCapture(props, consumedStyle) {
+  const style = props && typeof props === "object" ? props.style : void 0;
+  const previous = activeSignalHandoff;
+  activeSignalHandoff = style && isSignal(style) && consumedStyle !== void 0 ? {
+    signal: style,
+    consumedStyle
+  } : void 0;
+  return () => {
+    activeSignalHandoff = previous;
+  };
+}
+function capturePlacementHandoff(element, style) {
+  if (style && style === activeSignalHandoff?.signal) {
+    setPlacementSignalHandoff(element, activeSignalHandoff.consumedStyle);
+  }
+}
+function getPlacementHandoffSource(style) {
+  if (!style || typeof style !== "object") return void 0;
+  const marker = style[PLACEMENT_HANDOFF];
+  if (!marker || typeof marker !== "object") return void 0;
+  return marker.source;
+}
+function consumePlacementHandoff(style) {
+  if (getPlacementHandoffSource(style) === void 0) return style;
+  const withoutHandoff = { ...style };
+  delete withoutHandoff[PLACEMENT_HANDOFF];
+  return Object.freeze(withoutHandoff);
+}
+function getPlacementSignalHandoff(element) {
+  return getPlacementSignalHandoffStyle(element);
+}
+function resolveStandalonePosition(style, context) {
+  return {
+    left: resolveLocalOffset(style.left, context.percentageBasis.width, "left", context),
+    top: resolveLocalOffset(style.top, context.percentageBasis.height, "top", context)
+  };
+}
+export {
+  capturePlacementHandoff,
+  consumePlacementHandoff,
+  enterPlacementHandoffCapture,
+  getPlacementHandoffSource,
+  getPlacementSignalHandoff,
+  resolveStandalonePosition,
+  withPlacementHandoff
+};
+//# sourceMappingURL=positioning.js.map

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

@@ -0,0 +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;",
+  "names": []
+}

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

@@ -0,0 +1,6 @@
+import type { StyleResolutionContext, SystemStyle } from '../types.js';
+import type { Length } from './types.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 resolveLocalOffset(value: Exclude<Length, 'auto'> | undefined, reference: number, property: string, context: Readonly<StyleResolutionContext>): number;

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

@@ -0,0 +1,58 @@
+import { layoutDiagnostic } from "./diagnostics.js";
+import { resolveLength } from "./resolve-length.js";
+const LAYOUT_PARTICIPATION_KEYS = /* @__PURE__ */ new Set([
+  "width",
+  "height",
+  "minWidth",
+  "maxWidth",
+  "minHeight",
+  "maxHeight",
+  "padding",
+  "overflow",
+  "left",
+  "top",
+  "alignSelf",
+  "justifySelf",
+  "flexBasis",
+  "flexGrow",
+  "flexShrink",
+  "gridColumnStart",
+  "gridColumnSpan",
+  "gridRowStart",
+  "gridRowSpan"
+]);
+function stripLayoutParticipation(style) {
+  const result = {};
+  for (const [key, value] of Object.entries(style)) {
+    if (!LAYOUT_PARTICIPATION_KEYS.has(key)) result[key] = value;
+  }
+  return result;
+}
+function resolveRequiredLength(value, reference, property, context) {
+  const resolved = resolveLength(value, reference, property, context);
+  if (resolved === void 0) {
+    throw layoutDiagnostic({
+      component: context.component,
+      property,
+      value,
+      algorithm: context.algorithm,
+      constraints: context.constraints,
+      reason: "must resolve to a finite number before rendering"
+    });
+  }
+  return resolved;
+}
+function resolveOptionalLength(value, reference, property, context) {
+  if (value === void 0) return void 0;
+  return resolveLength(value, reference, property, context);
+}
+function resolveLocalOffset(value, reference, property, context) {
+  return resolveRequiredLength(value ?? 0, reference, property, context);
+}
+export {
+  resolveLocalOffset,
+  resolveOptionalLength,
+  resolveRequiredLength,
+  stripLayoutParticipation
+};
+//# sourceMappingURL=resolve-built-in.js.map

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

@@ -0,0 +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;",
+  "names": []
+}

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

@@ -0,0 +1,20 @@
+import { type PreparedQuery } from './responsive.js';
+import type { PibblElement } from '../element/types.js';
+import type { ResolvedStyle, SystemStyle } from '../types.js';
+import type { PibblFilter } from './filter-types.js';
+export interface PreparedStyleInput {
+    style: Readonly<SystemStyle>;
+    source: PibblElement<any>;
+    query?: PreparedQuery;
+}
+/** @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 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. */
+export declare function registerOpaqueStyleProperties(type: Function, properties: readonly string[]): void;
+/** @internal Reads the framework-owned filter property from a system style. */
+export declare function extractSystemFilter(style: Readonly<SystemStyle>): PibblFilter | readonly PibblFilter[] | undefined;
+/** @internal Removes the framework-owned filter before custom style callbacks run. */
+export declare function withoutSystemFilter(style: Readonly<SystemStyle>): Readonly<SystemStyle>;
+export declare function resolveElementStyle<S extends SystemStyle, N extends SystemStyle, R extends SystemStyle>(element: PibblElement<any>, resolvedSpecifiedStyle?: Readonly<SystemStyle>, hasResolvedSpecifiedStyle?: boolean, prepared?: PreparedStyleInput): ResolvedStyle<R>;

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

@@ -0,0 +1,167 @@
+import { resolveTransitionBinding } from "../transitions/binding.js";
+import { getLayoutBox, getPercentageBasis } from "../layout/context.js";
+import { EMPTY_STYLE } from "./empty-style.js";
+import {
+  getPrimitiveDefinition,
+  getSpecifiedStyle,
+  setPrimitiveReceiverToken
+} from "../element/metadata.js";
+import { layoutDiagnostic } from "./diagnostics.js";
+import { resolveFilterList } from "./filter.js";
+import { isPlacementConsumed } from "../element/metadata.js";
+import {
+  consumePlacementHandoff,
+  getPlacementSignalHandoff,
+  getPlacementHandoffSource,
+  resolveStandalonePosition
+} from "./positioning.js";
+import { CANVAS_2D_BACKEND } from "../backend/canvas-2d-backend.js";
+const opaqueStyleProperties = /* @__PURE__ */ new WeakMap();
+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 takePreNormalizedStyle(element) {
+  const value = preNormalizedStyles.get(element);
+  preNormalizedStyles.delete(element);
+  return value;
+}
+function registerOpaqueStyleProperties(type, properties) {
+  opaqueStyleProperties.set(type, new Set(properties));
+}
+function extractSystemFilter(style) {
+  return style.filter;
+}
+function withoutSystemFilter(style) {
+  if (!("when" in style)) {
+    const { filter: _filter2, transition: _transition2, ...withoutFilter2 } = style;
+    return Object.freeze(withoutFilter2);
+  }
+  const { filter: _filter, transition: _transition, when: _when, ...withoutFilter } = style;
+  return Object.freeze(withoutFilter);
+}
+function resolveElementStyle(element, resolvedSpecifiedStyle, hasResolvedSpecifiedStyle = false, prepared) {
+  const allocation = getLayoutBox();
+  const percentageBasis = getPercentageBasis();
+  const type = element.type;
+  const definition = getPrimitiveDefinition(type);
+  if (!definition) {
+    throw new Error(
+      `${type.name || "Anonymous"} does not have Pibbl primitive metadata`
+    );
+  }
+  const component = type.name || "Anonymous";
+  const context = {
+    allocation,
+    percentageBasis,
+    constraints: {
+      minWidth: 0,
+      maxWidth: allocation.width,
+      minHeight: 0,
+      maxHeight: allocation.height
+    },
+    component,
+    algorithm: "render-dispatch"
+  };
+  const preNormalized = prepared;
+  const specified = (hasResolvedSpecifiedStyle ? resolvedSpecifiedStyle : getSpecifiedStyle(element)) ?? EMPTY_STYLE;
+  const resolvedInput = preNormalized?.style ?? specified;
+  const forwardedStyle = getPlacementHandoffSource(
+    getSpecifiedStyle(element)
+  ) ?? getPlacementSignalHandoff(element);
+  const handoffStyle = consumePlacementHandoff(resolvedInput);
+  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;
+  const systemFilter = resolveFilterList(
+    combined,
+    context
+  );
+  const normalized = preNormalized ? withoutSystemFilter(handoffStyle) : definition.normalizeStyle ? definition.normalizeStyle(
+    withoutSystemFilter(handoffStyle)
+  ) : withoutSystemFilter(handoffStyle);
+  const resolved = definition.resolveStyle ? definition.resolveStyle(normalized, context) : normalized;
+  const positioning = normalized;
+  const hasLeft = positioning.left !== void 0;
+  const hasTop = 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,
+      top: consumesOuterPosition || forwarded !== void 0 && Object.is(positioning.top, forwarded.top) ? 0 : standalone.top
+    };
+    positioned = {
+      ...resolved,
+      ...hasLeft ? { left: position.left } : {},
+      ...hasTop ? { top: position.top } : {}
+    };
+  }
+  const final = systemFilter ? { ...positioned, filter: systemFilter.values } : positioned;
+  assertResolvedValue(
+    final,
+    "",
+    context,
+    /* @__PURE__ */ new Set(),
+    opaqueStyleProperties.get(type) ?? /* @__PURE__ */ new Set()
+  );
+  return final;
+}
+function assertResolvedValue(value, property, context, seen, opaqueProperties) {
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) {
+      throw unresolvedDiagnostic(property, value, context, "must be finite");
+    }
+    return;
+  }
+  if (typeof value === "string") {
+    if (!opaqueProperties.has(property) && (value === "auto" || value.endsWith("%"))) {
+      throw unresolvedDiagnostic(
+        property,
+        value,
+        context,
+        "must resolve before the component callback is invoked"
+      );
+    }
+    return;
+  }
+  if (!value || typeof value !== "object" || seen.has(value)) return;
+  if (property === "custom" || property === "filter") return;
+  const prototype = Object.getPrototypeOf(value);
+  if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {
+    return;
+  }
+  seen.add(value);
+  for (const [key, child] of Object.entries(value)) {
+    if (key === "custom") continue;
+    assertResolvedValue(
+      child,
+      property ? `${property}.${key}` : key,
+      context,
+      seen,
+      opaqueProperties
+    );
+  }
+}
+function unresolvedDiagnostic(property, value, context, reason) {
+  return layoutDiagnostic({
+    component: context.component,
+    property: property || "style",
+    value,
+    algorithm: context.algorithm,
+    constraints: context.constraints,
+    reason
+  });
+}
+export {
+  extractSystemFilter,
+  registerOpaqueStyleProperties,
+  resolveElementStyle,
+  setPreNormalizedStyle,
+  takePreNormalizedStyle,
+  withoutSystemFilter
+};
+//# sourceMappingURL=resolve-dispatch.js.map

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

@@ -0,0 +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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",
+  "names": ["_filter", "_transition", "withoutFilter"]
+}

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

@@ -0,0 +1,16 @@
+import { type LayoutDiagnosticContext } from './diagnostics.js';
+import type { Length } from './types.js';
+/**
+ * Resolves a numeric or percentage length; automatic sizing returns undefined.
+ *
+ * @param value - Logical length or percentage to resolve. See {@link Length}.
+ * @param reference - Reference length for percentages, or undefined if unavailable.
+ * @param property - Property name used in diagnostics.
+ * @param context - Component and property context for diagnostic messages. See
+ * {@link LayoutDiagnosticContext} .
+ * @returns The resolved logical length, or undefined for an unresolved automatic length.
+ *
+ * @see {@link Length}
+ * @see {@link LayoutDiagnosticContext}
+ */
+export declare function resolveLength(value: Length, reference: number | undefined, property: string, context?: Readonly<LayoutDiagnosticContext>): number | undefined;

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

@@ -0,0 +1,54 @@
+import {
+  layoutDiagnostic
+} from "./diagnostics.js";
+const DECIMAL_PERCENTAGE = /^[+-]?(?:\d+(?:\.\d+)?|\.\d+)%$/;
+function resolveLength(value, reference, property, context = {}) {
+  if (value === "auto") return void 0;
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) {
+      throw diagnostic(property, value, "must be a finite number", context);
+    }
+    return value;
+  }
+  if (typeof value !== "string" || !DECIMAL_PERCENTAGE.test(value)) {
+    throw diagnostic(
+      property,
+      value,
+      `uses an unsupported length value ${String(value)}`,
+      context
+    );
+  }
+  if (reference === void 0 || !Number.isFinite(reference)) {
+    throw diagnostic(
+      property,
+      value,
+      "requires a definite finite percentage reference",
+      context
+    );
+  }
+  if (reference < 0) {
+    throw diagnostic(
+      property,
+      value,
+      "percentage reference must be nonnegative",
+      context
+    );
+  }
+  const resolved = Number.parseFloat(value) / 100 * reference;
+  if (!Number.isFinite(resolved)) {
+    throw diagnostic(
+      property,
+      value,
+      "resolved percentage arithmetic must remain finite",
+      context
+    );
+  }
+  return resolved;
+}
+function diagnostic(property, value, reason, context) {
+  return layoutDiagnostic({ ...context, property, value, reason });
+}
+export {
+  resolveLength
+};
+//# sourceMappingURL=resolve-length.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/style/resolve-length.ts"],
+  "sourcesContent": ["import {\n  layoutDiagnostic,\n  type LayoutDiagnosticContext,\n} from './diagnostics.js';\nimport type { Length } from './types.js';\n\nconst DECIMAL_PERCENTAGE = /^[+-]?(?:\\d+(?:\\.\\d+)?|\\.\\d+)%$/;\n\n/**\n * Resolves a numeric or percentage length; automatic sizing returns undefined.\n *\n * @param value - Logical length or percentage to resolve. See {@link Length}.\n * @param reference - Reference length for percentages, or undefined if unavailable.\n * @param property - Property name used in diagnostics.\n * @param context - Component and property context for diagnostic messages. See\n * {@link LayoutDiagnosticContext} .\n * @returns The resolved logical length, or undefined for an unresolved automatic length.\n *\n * @see {@link Length}\n * @see {@link LayoutDiagnosticContext}\n */\nexport function resolveLength(\n  value: Length,\n  reference: number | undefined,\n  property: string,\n  context: Readonly<LayoutDiagnosticContext> = {},\n): number | undefined {\n  if (value === 'auto') return undefined;\n\n  if (typeof value === 'number') {\n    if (!Number.isFinite(value)) {\n      throw diagnostic(property, value, 'must be a finite number', context);\n    }\n    return value;\n  }\n\n  if (typeof value !== 'string' || !DECIMAL_PERCENTAGE.test(value)) {\n    throw diagnostic(\n      property,\n      value,\n      `uses an unsupported length value ${String(value)}`,\n      context,\n    );\n  }\n\n  if (reference === undefined || !Number.isFinite(reference)) {\n    throw diagnostic(\n      property,\n      value,\n      'requires a definite finite percentage reference',\n      context,\n    );\n  }\n  if (reference < 0) {\n    throw diagnostic(\n      property,\n      value,\n      'percentage reference must be nonnegative',\n      context,\n    );\n  }\n\n  const resolved = (Number.parseFloat(value) / 100) * reference;\n  if (!Number.isFinite(resolved)) {\n    throw diagnostic(\n      property,\n      value,\n      'resolved percentage arithmetic must remain finite',\n      context,\n    );\n  }\n  return resolved;\n}\n\nfunction diagnostic(\n  property: string,\n  value: unknown,\n  reason: string,\n  context: Readonly<LayoutDiagnosticContext>,\n) {\n  return layoutDiagnostic({ ...context, property, value, reason });\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAEK;AAGP,MAAM,qBAAqB;AAepB,SAAS,cACd,OACA,WACA,UACA,UAA6C,CAAC,GAC1B;AACpB,MAAI,UAAU,OAAQ,QAAO;AAE7B,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AAC3B,YAAM,WAAW,UAAU,OAAO,2BAA2B,OAAO;AAAA,IACtE;AACA,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,YAAY,CAAC,mBAAmB,KAAK,KAAK,GAAG;AAChE,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA,oCAAoC,OAAO,KAAK,CAAC;AAAA,MACjD;AAAA,IACF;AAAA,EACF;AAEA,MAAI,cAAc,UAAa,CAAC,OAAO,SAAS,SAAS,GAAG;AAC1D,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,MAAI,YAAY,GAAG;AACjB,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,WAAY,OAAO,WAAW,KAAK,IAAI,MAAO;AACpD,MAAI,CAAC,OAAO,SAAS,QAAQ,GAAG;AAC9B,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,WACP,UACA,OACA,QACA,SACA;AACA,SAAO,iBAAiB,EAAE,GAAG,SAAS,UAAU,OAAO,OAAO,CAAC;AACjE;",
+  "names": []
+}

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

@@ -0,0 +1,31 @@
+import type { PibblElement } from '../element/types.js';
+export interface QueryBasis {
+    readonly width: number;
+    readonly height: number;
+}
+export interface PreparedQuery {
+    readonly basis: QueryBasis;
+    readonly axes: number;
+}
+/** A single evaluation's selected style; never indexed by receiver identity. */
+export declare class ResponsiveStylePreparation<T extends object = Readonly<Record<PropertyKey, unknown>>> {
+    style: T;
+    readonly query: PreparedQuery;
+    constructor(style: T, query: PreparedQuery);
+}
+export declare function preparedStyleValue<T extends object>(value: T | ResponsiveStylePreparation<T>): T;
+export declare function preparedStyleQuery(value: object): PreparedQuery | undefined;
+export type StyleMeasurementMode = 'standalone-root' | 'mounted-intrinsic' | 'recursive';
+export declare function getStyleMeasurementMode(): StyleMeasurementMode | undefined;
+export declare function withStyleMeasurement<T>(mode: StyleMeasurementMode, work: () => T): T;
+export declare class UnsupportedResponsiveMeasurement extends Error {
+}
+export declare function rejectResponsiveMeasurement(element?: PibblElement<any>): never;
+export declare function responsiveStyleSnapshot(): {
+    preparations: number;
+    rules: number;
+    patchFields: number;
+    mergeCopies: number;
+};
+/** Selects a closed local rule list; ordinary styles bypass this function. */
+export declare function resolveResponsiveStyle(source: Readonly<Record<PropertyKey, unknown>>, element?: PibblElement<any>, suppliedBasis?: QueryBasis): Readonly<Record<PropertyKey, unknown>> | ResponsiveStylePreparation;