@pibbl/core 0.0.1

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

@@ -0,0 +1,83 @@
+import type { normalizeEdges } from "./normalize.js";
+import type { resolveLength } from "./resolve-length.js";
+import type { Constraints } from '../layout/types.js';
+/**
+ * Component and source context attached to a layout diagnostic.
+ *
+ * @see {@link Constraints}
+ * @see {@link LayoutDiagnosticInput}
+ * @see {@link normalizeEdges}
+ * @see {@link resolveLength}
+ */
+export interface LayoutDiagnosticContext {
+    /**
+     * Component identity or diagnostic name associated with this value. See
+     * {@link LayoutDiagnosticContext}.
+     */
+    component?: string;
+    /**
+     * Name of the layout algorithm producing this diagnostic or resolution. See
+     * {@link LayoutDiagnosticContext}.
+     */
+    algorithm?: string;
+    /** Sizing limits and available dimensions for this operation. See {@link Constraints}. */
+    constraints?: Readonly<Constraints>;
+}
+/**
+ * Validation-failure details used to construct a layout diagnostic.
+ *
+ * @see {@link LayoutDiagnosticContext}
+ * @see {@link layoutDiagnostic}
+ */
+export interface LayoutDiagnosticInput extends LayoutDiagnosticContext {
+    /** Name of the affected input property. See {@link LayoutDiagnosticInput}. */
+    property: string;
+    /** Value associated with this sample, input, or result. See {@link LayoutDiagnosticInput}. */
+    value: unknown;
+    /**
+     * Reason the operation could not produce its ordinary result. See {@link LayoutDiagnosticInput}
+     * .
+     */
+    reason: string;
+}
+/**
+ * A layout validation error carrying the affected property and component context.
+ *
+ * @see {@link layoutDiagnostic}
+ */
+export declare class LayoutDiagnostic extends Error {
+    /**
+     * Component identity or diagnostic name associated with this value. See {@link LayoutDiagnostic}
+     * .
+     */
+    readonly component: string;
+    /** Name of the affected input property. See {@link LayoutDiagnostic}. */
+    readonly property: string;
+    /** The original value that failed validation. See {@link LayoutDiagnostic}. */
+    readonly suppliedValue: unknown;
+    /**
+     * Name of the layout algorithm producing this diagnostic or resolution. See
+     * {@link LayoutDiagnostic}.
+     */
+    readonly algorithm: string;
+    /** Sizing limits and available dimensions for this operation. See {@link Constraints}. */
+    readonly constraints: Readonly<Constraints> | undefined;
+    /**
+     * Creates a layout error containing the property, supplied value, and diagnostic context. See
+     * {@link LayoutDiagnostic}.
+     * @param input - Diagnostic code, message, property, and layout context. See
+     * {@link LayoutDiagnosticInput} .
+     */
+    constructor(input: LayoutDiagnosticInput);
+}
+/**
+ * Creates a structured layout error from a validation failure and its component context.
+ *
+ * @param input - Diagnostic code, message, property, and layout context. See
+ * {@link LayoutDiagnosticInput} .
+ * @returns A structured layout diagnostic. See {@link LayoutDiagnostic}.
+ *
+ * @see {@link LayoutDiagnosticInput}
+ * @see {@link LayoutDiagnostic}
+ */
+export declare function layoutDiagnostic(input: LayoutDiagnosticInput): LayoutDiagnostic;

package/dist/lib/style/diagnostics.js

@@ -0,0 +1,63 @@
+class LayoutDiagnostic extends Error {
+  /**
+   * Component identity or diagnostic name associated with this value. See {@link LayoutDiagnostic}
+   * .
+   */
+  component;
+  /** Name of the affected input property. See {@link LayoutDiagnostic}. */
+  property;
+  /** The original value that failed validation. See {@link LayoutDiagnostic}. */
+  suppliedValue;
+  /**
+   * Name of the layout algorithm producing this diagnostic or resolution. See
+   * {@link LayoutDiagnostic}.
+   */
+  algorithm;
+  /** Sizing limits and available dimensions for this operation. See {@link Constraints}. */
+  constraints;
+  /**
+   * Creates a layout error containing the property, supplied value, and diagnostic context. See
+   * {@link LayoutDiagnostic}.
+   * @param input - Diagnostic code, message, property, and layout context. See
+   * {@link LayoutDiagnosticInput} .
+   */
+  constructor(input) {
+    const component = input.component ?? "layout";
+    const algorithm = input.algorithm ?? "value-resolution";
+    const constraints = input.constraints;
+    super(
+      `${component}: property ${input.property} received ${formatValue(input.value)} during ${algorithm}; constraints ${formatConstraints(constraints)}; ${input.reason}`
+    );
+    this.name = "LayoutDiagnostic";
+    this.component = component;
+    this.property = input.property;
+    this.suppliedValue = input.value;
+    this.algorithm = algorithm;
+    this.constraints = constraints;
+  }
+}
+function layoutDiagnostic(input) {
+  return new LayoutDiagnostic(input);
+}
+function formatValue(value) {
+  if (typeof value === "string") return JSON.stringify(value);
+  if (typeof value === "number") {
+    if (Number.isNaN(value)) return "NaN";
+    if (value === Number.POSITIVE_INFINITY) return "Infinity";
+    if (value === Number.NEGATIVE_INFINITY) return "-Infinity";
+  }
+  try {
+    return JSON.stringify(value) ?? String(value);
+  } catch {
+    return String(value);
+  }
+}
+function formatConstraints(constraints) {
+  if (!constraints) return "unspecified";
+  return `{ minWidth: ${formatValue(constraints.minWidth)}, maxWidth: ${formatValue(constraints.maxWidth)}, minHeight: ${formatValue(constraints.minHeight)}, maxHeight: ${formatValue(constraints.maxHeight)} }`;
+}
+export {
+  LayoutDiagnostic,
+  layoutDiagnostic
+};
+//# sourceMappingURL=diagnostics.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/style/diagnostics.ts"],
+  "sourcesContent": ["import type { normalizeEdges } from './normalize.js';\nimport type { resolveLength } from './resolve-length.js';\nimport type { Constraints } from '../layout/types.js';\n\n/**\n * Component and source context attached to a layout diagnostic.\n *\n * @see {@link Constraints}\n * @see {@link LayoutDiagnosticInput}\n * @see {@link normalizeEdges}\n * @see {@link resolveLength}\n */\nexport interface LayoutDiagnosticContext {\n  /**\n   * Component identity or diagnostic name associated with this value. See\n   * {@link LayoutDiagnosticContext}.\n   */\n  component?: string;\n  /**\n   * Name of the layout algorithm producing this diagnostic or resolution. See\n   * {@link LayoutDiagnosticContext}.\n   */\n  algorithm?: string;\n  /** Sizing limits and available dimensions for this operation. See {@link Constraints}. */\n  constraints?: Readonly<Constraints>;\n}\n\n/**\n * Validation-failure details used to construct a layout diagnostic.\n *\n * @see {@link LayoutDiagnosticContext}\n * @see {@link layoutDiagnostic}\n */\nexport interface LayoutDiagnosticInput extends LayoutDiagnosticContext {\n  /** Name of the affected input property. See {@link LayoutDiagnosticInput}. */\n  property: string;\n  /** Value associated with this sample, input, or result. See {@link LayoutDiagnosticInput}. */\n  value: unknown;\n  /**\n   * Reason the operation could not produce its ordinary result. See {@link LayoutDiagnosticInput}\n   * .\n   */\n  reason: string;\n}\n\n/**\n * A layout validation error carrying the affected property and component context.\n *\n * @see {@link layoutDiagnostic}\n */\nexport class LayoutDiagnostic extends Error {\n  /**\n   * Component identity or diagnostic name associated with this value. See {@link LayoutDiagnostic}\n   * .\n   */\n  readonly component: string;\n  /** Name of the affected input property. See {@link LayoutDiagnostic}. */\n  readonly property: string;\n  /** The original value that failed validation. See {@link LayoutDiagnostic}. */\n  readonly suppliedValue: unknown;\n  /**\n   * Name of the layout algorithm producing this diagnostic or resolution. See\n   * {@link LayoutDiagnostic}.\n   */\n  readonly algorithm: string;\n  /** Sizing limits and available dimensions for this operation. See {@link Constraints}. */\n  readonly constraints: Readonly<Constraints> | undefined;\n\n  /**\n   * Creates a layout error containing the property, supplied value, and diagnostic context. See\n   * {@link LayoutDiagnostic}.\n   * @param input - Diagnostic code, message, property, and layout context. See\n   * {@link LayoutDiagnosticInput} .\n   */\n  constructor(input: LayoutDiagnosticInput) {\n    const component = input.component ?? 'layout';\n    const algorithm = input.algorithm ?? 'value-resolution';\n    const constraints = input.constraints;\n    super(\n      `${component}: property ${input.property} received ${formatValue(input.value)} ` +\n        `during ${algorithm}; constraints ${formatConstraints(constraints)}; ${input.reason}`,\n    );\n    this.name = 'LayoutDiagnostic';\n    this.component = component;\n    this.property = input.property;\n    this.suppliedValue = input.value;\n    this.algorithm = algorithm;\n    this.constraints = constraints;\n  }\n}\n\n/**\n * Creates a structured layout error from a validation failure and its component context.\n *\n * @param input - Diagnostic code, message, property, and layout context. See\n * {@link LayoutDiagnosticInput} .\n * @returns A structured layout diagnostic. See {@link LayoutDiagnostic}.\n *\n * @see {@link LayoutDiagnosticInput}\n * @see {@link LayoutDiagnostic}\n */\nexport function layoutDiagnostic(\n  input: LayoutDiagnosticInput,\n): LayoutDiagnostic {\n  return new LayoutDiagnostic(input);\n}\n\nfunction formatValue(value: unknown): string {\n  if (typeof value === 'string') return JSON.stringify(value);\n  if (typeof value === 'number') {\n    if (Number.isNaN(value)) return 'NaN';\n    if (value === Number.POSITIVE_INFINITY) return 'Infinity';\n    if (value === Number.NEGATIVE_INFINITY) return '-Infinity';\n  }\n  try {\n    return JSON.stringify(value) ?? String(value);\n  } catch {\n    return String(value);\n  }\n}\n\nfunction formatConstraints(\n  constraints: Readonly<Constraints> | undefined,\n): string {\n  if (!constraints) return 'unspecified';\n  return (\n    `{ minWidth: ${formatValue(constraints.minWidth)}, maxWidth: ${formatValue(constraints.maxWidth)}, ` +\n    `minHeight: ${formatValue(constraints.minHeight)}, maxHeight: ${formatValue(constraints.maxHeight)} }`\n  );\n}\n"],
+  "mappings": "AAkDO,MAAM,yBAAyB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,EAKjC;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA;AAAA;AAAA,EAEA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQT,YAAY,OAA8B;AACxC,UAAM,YAAY,MAAM,aAAa;AACrC,UAAM,YAAY,MAAM,aAAa;AACrC,UAAM,cAAc,MAAM;AAC1B;AAAA,MACE,GAAG,SAAS,cAAc,MAAM,QAAQ,aAAa,YAAY,MAAM,KAAK,CAAC,WACjE,SAAS,iBAAiB,kBAAkB,WAAW,CAAC,KAAK,MAAM,MAAM;AAAA,IACvF;AACA,SAAK,OAAO;AACZ,SAAK,YAAY;AACjB,SAAK,WAAW,MAAM;AACtB,SAAK,gBAAgB,MAAM;AAC3B,SAAK,YAAY;AACjB,SAAK,cAAc;AAAA,EACrB;AACF;AAYO,SAAS,iBACd,OACkB;AAClB,SAAO,IAAI,iBAAiB,KAAK;AACnC;AAEA,SAAS,YAAY,OAAwB;AAC3C,MAAI,OAAO,UAAU,SAAU,QAAO,KAAK,UAAU,KAAK;AAC1D,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,OAAO,MAAM,KAAK,EAAG,QAAO;AAChC,QAAI,UAAU,OAAO,kBAAmB,QAAO;AAC/C,QAAI,UAAU,OAAO,kBAAmB,QAAO;AAAA,EACjD;AACA,MAAI;AACF,WAAO,KAAK,UAAU,KAAK,KAAK,OAAO,KAAK;AAAA,EAC9C,QAAQ;AACN,WAAO,OAAO,KAAK;AAAA,EACrB;AACF;AAEA,SAAS,kBACP,aACQ;AACR,MAAI,CAAC,YAAa,QAAO;AACzB,SACE,eAAe,YAAY,YAAY,QAAQ,CAAC,eAAe,YAAY,YAAY,QAAQ,CAAC,gBAClF,YAAY,YAAY,SAAS,CAAC,gBAAgB,YAAY,YAAY,SAAS,CAAC;AAEtG;",
+  "names": []
+}

package/dist/lib/style/empty-style.d.ts

@@ -0,0 +1,3 @@
+import type { SystemStyle } from '../types.js';
+/** @internal Shared empty specified style for primitives without author style. */
+export declare const EMPTY_STYLE: Readonly<SystemStyle>;

package/dist/lib/style/empty-style.js

@@ -0,0 +1,5 @@
+const EMPTY_STYLE = Object.freeze({});
+export {
+  EMPTY_STYLE
+};
+//# sourceMappingURL=empty-style.js.map

package/dist/lib/style/empty-style.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/style/empty-style.ts"],
+  "sourcesContent": ["import type { SystemStyle } from '../types.js';\n\n/** @internal Shared empty specified style for primitives without author style. */\nexport const EMPTY_STYLE: Readonly<SystemStyle> = Object.freeze({});\n"],
+  "mappings": "AAGO,MAAM,cAAqC,OAAO,OAAO,CAAC,CAAC;",
+  "names": []
+}

package/dist/lib/style/filter-types.d.ts

@@ -0,0 +1,243 @@
+import type { SystemStyle } from "../types.js";
+import type { blur, brightness, contrast, dropShadow, grayscale, hueRotate, invert, opacity, saturate, sepia } from "../../filters/native.js";
+import type { displacement } from "../../filters/displacement.js";
+import type { reflectedLight } from "../../filters/reflected-light.js";
+import type { PrimitivePresentation } from '../primitive-presentation.js';
+import type { StyleResolutionContext } from '../types.js';
+import type { SignalValue } from '../signals/types.js';
+import type { TexturePaint } from '../textures/texture-protocol.js';
+/**
+ * Opaque, imported appearance effect accepted by `style.filter`.
+ *
+ * @see {@link SystemStyle}
+ * @see {@link blur}
+ * @see {@link brightness}
+ */
+export interface PibblFilter {
+    readonly [PIBBL_FILTER_EXECUTOR]: PibblFilterExecutor;
+}
+/** @internal Stable protocol key shared by the base renderer and optional entries. */
+export declare const PIBBL_FILTER_EXECUTOR: unique symbol;
+/** @internal A value prepared for one receiving primitive generation. */
+export interface PreparedPibblFilter {
+    readonly executor: PibblFilterBoundaryExecutor;
+}
+/** @internal Optional filter implementations own validation and pixel processing. */
+export interface PibblFilterBoundaryExecutor {
+    render(input: Readonly<PibblFilterRenderInput>): void;
+}
+export interface PibblFilterExecutor extends PibblFilterBoundaryExecutor {
+    prepare(value: PibblFilter, property: string, context: Readonly<StyleResolutionContext>): PreparedPibblFilter;
+    render(input: Readonly<PibblFilterRenderInput>): void;
+}
+/** @internal Generic call boundary that keeps capture implementation out of core. */
+export interface PibblFilterRenderInput {
+    readonly component: string;
+    readonly filters: readonly PreparedPibblFilter[];
+    readonly presentation?: Readonly<PrimitivePresentation>;
+    readonly renderSubtree: () => void;
+}
+/**
+ * Parameters for the blur filter, including signal-capable inputs where declared.
+ *
+ * @see {@link SignalValue}
+ * @see {@link blur}
+ */
+export interface PibblBlurFilterOptions {
+    /** Radius in the coordinate system of this geometry or effect. See {@link SignalValue}. */
+    readonly radius: SignalValue<number>;
+}
+/**
+ * Parameters for the brightness filter, including signal-capable inputs where declared.
+ *
+ * @see {@link SignalValue}
+ * @see {@link brightness}
+ */
+export interface PibblBrightnessFilterOptions {
+    /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */
+    readonly amount: SignalValue<number>;
+}
+/**
+ * Parameters for the contrast filter, including signal-capable inputs where declared.
+ *
+ * @see {@link SignalValue}
+ * @see {@link contrast}
+ */
+export interface PibblContrastFilterOptions {
+    /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */
+    readonly amount: SignalValue<number>;
+}
+/**
+ * Parameters for the drop shadow filter, including signal-capable inputs where declared.
+ *
+ * @see {@link SignalValue}
+ * @see {@link dropShadow}
+ */
+export interface PibblDropShadowFilterOptions {
+    /** Horizontal offset applied to the texture or shadow. See {@link SignalValue}. */
+    readonly offsetX: SignalValue<number>;
+    /** Vertical offset applied to the texture or shadow. See {@link SignalValue}. */
+    readonly offsetY: SignalValue<number>;
+    /** Radius of the shadow's blur. See {@link SignalValue}. */
+    readonly blurRadius?: SignalValue<number>;
+    /** Color used by the mark or effect. See {@link SignalValue}. */
+    readonly color: SignalValue<string>;
+}
+/**
+ * Parameters for the grayscale filter, including signal-capable inputs where declared.
+ *
+ * @see {@link SignalValue}
+ * @see {@link grayscale}
+ */
+export interface PibblGrayscaleFilterOptions {
+    /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */
+    readonly amount: SignalValue<number>;
+}
+/**
+ * Parameters for the hue rotate filter, including signal-capable inputs where declared.
+ *
+ * @see {@link SignalValue}
+ * @see {@link hueRotate}
+ */
+export interface PibblHueRotateFilterOptions {
+    /** Hue rotation in degrees. See {@link SignalValue}. */
+    readonly degrees: SignalValue<number>;
+}
+/**
+ * Parameters for the invert filter, including signal-capable inputs where declared.
+ *
+ * @see {@link SignalValue}
+ * @see {@link invert}
+ */
+export interface PibblInvertFilterOptions {
+    /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */
+    readonly amount: SignalValue<number>;
+}
+/**
+ * Parameters for the opacity filter, including signal-capable inputs where declared.
+ *
+ * @see {@link SignalValue}
+ * @see {@link opacity}
+ */
+export interface PibblOpacityFilterOptions {
+    /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */
+    readonly amount: SignalValue<number>;
+}
+/**
+ * Parameters for the saturate filter, including signal-capable inputs where declared.
+ *
+ * @see {@link SignalValue}
+ * @see {@link saturate}
+ */
+export interface PibblSaturateFilterOptions {
+    /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */
+    readonly amount: SignalValue<number>;
+}
+/**
+ * Parameters for the sepia filter, including signal-capable inputs where declared.
+ *
+ * @see {@link SignalValue}
+ * @see {@link sepia}
+ */
+export interface PibblSepiaFilterOptions {
+    /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */
+    readonly amount: SignalValue<number>;
+}
+/**
+ * Parameters for the displacement filter, including signal-capable inputs where declared.
+ *
+ * @see {@link SignalValue}
+ * @see {@link TexturePaint}
+ * @see {@link displacement}
+ */
+export interface PibblDisplacementFilterOptions {
+    /**
+     * Optional local blur support radius. Blue × alpha scales it; zero preserves displacement-only
+     * behavior.
+     */
+    readonly blurRadius?: SignalValue<number>;
+    /** Texture or image supplying displacement samples. See {@link SignalValue}, {@link TexturePaint}. */
+    readonly map: SignalValue<TexturePaint>;
+    /** Magnitude of the displacement or brush effect. See {@link SignalValue}. */
+    readonly strength: SignalValue<number>;
+    /**
+     * Logical region over which the effect is evaluated. See {@link PibblDisplacementFilterOptions}.
+     */
+    readonly region: Readonly<{
+        /**
+         * Horizontal coordinate or displacement in the containing coordinate system. See
+         * {@link PibblDisplacementFilterOptions}.
+         */
+        x: number;
+        /**
+         * Vertical coordinate or displacement in the containing coordinate system. See
+         * {@link PibblDisplacementFilterOptions}.
+         */
+        y: number;
+        /**
+         * Horizontal extent in the units of the containing geometry or surface. See
+         * {@link PibblDisplacementFilterOptions}.
+         */
+        width: number;
+        /**
+         * Vertical extent in the units of the containing geometry or surface. See
+         * {@link PibblDisplacementFilterOptions}.
+         */
+        height: number;
+    }>;
+}
+/**
+ * Surface-light source. Images are caller-owned and must already be decoded.
+ *
+ * @see {@link TexturePaint}
+ * @see {@link PibblReflectedLightFilterOptions}
+ */
+export type PibblReflectedLightSource = string | TexturePaint | HTMLImageElement | ImageBitmap;
+/**
+ * Parameters for the reflected light filter, including signal-capable inputs where declared.
+ *
+ * @see {@link SignalValue}
+ * @see {@link TexturePaint}
+ * @see {@link PibblReflectedLightSource}
+ * @see {@link reflectedLight}
+ */
+export interface PibblReflectedLightFilterOptions {
+    /** Texture or image supplying the surface-height samples. See {@link SignalValue}, {@link TexturePaint}. */
+    readonly map: SignalValue<TexturePaint>;
+    /**
+     * Logical region over which the effect is evaluated. See {@link PibblReflectedLightFilterOptions}
+     * .
+     */
+    readonly region: Readonly<{
+        /**
+         * Horizontal coordinate or displacement in the containing coordinate system. See
+         * {@link PibblReflectedLightFilterOptions}.
+         */
+        x: number;
+        /**
+         * Vertical coordinate or displacement in the containing coordinate system. See
+         * {@link PibblReflectedLightFilterOptions}.
+         */
+        y: number;
+        /**
+         * Horizontal extent in the units of the containing geometry or surface. See
+         * {@link PibblReflectedLightFilterOptions}.
+         */
+        width: number;
+        /**
+         * Vertical extent in the units of the containing geometry or surface. See
+         * {@link PibblReflectedLightFilterOptions}.
+         */
+        height: number;
+    }>;
+    /** Light-source position or direction used for the reflection. See {@link SignalValue}, {@link PibblReflectedLightSource}. */
+    readonly source?: SignalValue<PibblReflectedLightSource>;
+    /** Opacity of the painted result. See {@link SignalValue}. */
+    readonly opacity?: SignalValue<number>;
+    /** Intensity threshold used to select reflected-light contributions. See {@link SignalValue}. */
+    readonly threshold?: SignalValue<number>;
+    /** Softness of the reflected-light threshold boundary. See {@link SignalValue}. */
+    readonly softness?: SignalValue<number>;
+    /** Direction in which this operation proceeds. See {@link PibblReflectedLightFilterOptions}. */
+    readonly direction?: readonly [number, number];
+}

package/dist/lib/style/filter-types.js

@@ -0,0 +1,5 @@
+const PIBBL_FILTER_EXECUTOR = /* @__PURE__ */ Symbol("pibbl.filter.executor");
+export {
+  PIBBL_FILTER_EXECUTOR
+};
+//# sourceMappingURL=filter-types.js.map

package/dist/lib/style/filter-types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/style/filter-types.ts"],
+  "sourcesContent": ["import type { SystemStyle } from '../types.js';\nimport type { blur, brightness, contrast, dropShadow, grayscale, hueRotate, invert, opacity, saturate, sepia } from '../../filters/native.js';\nimport type { displacement } from '../../filters/displacement.js';\nimport type { reflectedLight } from '../../filters/reflected-light.js';\nimport type { PrimitivePresentation } from '../primitive-presentation.js';\nimport type { StyleResolutionContext } from '../types.js';\nimport type { SignalValue } from '../signals/types.js';\nimport type { TexturePaint } from '../textures/texture-protocol.js';\n\n/**\n * Opaque, imported appearance effect accepted by `style.filter`.\n *\n * @see {@link SystemStyle}\n * @see {@link blur}\n * @see {@link brightness}\n */\nexport interface PibblFilter {\n  readonly [PIBBL_FILTER_EXECUTOR]: PibblFilterExecutor;\n}\n\n/** @internal Stable protocol key shared by the base renderer and optional entries. */\nexport const PIBBL_FILTER_EXECUTOR = Symbol('pibbl.filter.executor');\n\n/** @internal A value prepared for one receiving primitive generation. */\nexport interface PreparedPibblFilter {\n  readonly executor: PibblFilterBoundaryExecutor;\n}\n\n/** @internal Optional filter implementations own validation and pixel processing. */\nexport interface PibblFilterBoundaryExecutor {\n  render(input: Readonly<PibblFilterRenderInput>): void;\n}\n\nexport interface PibblFilterExecutor extends PibblFilterBoundaryExecutor {\n  prepare(value: PibblFilter, property: string, context: Readonly<StyleResolutionContext>): PreparedPibblFilter;\n  render(input: Readonly<PibblFilterRenderInput>): void;\n}\n\n/** @internal Generic call boundary that keeps capture implementation out of core. */\nexport interface PibblFilterRenderInput {\n  readonly component: string;\n  readonly filters: readonly PreparedPibblFilter[];\n  readonly presentation?: Readonly<PrimitivePresentation>;\n  readonly renderSubtree: () => void;\n}\n\n/**\n * Parameters for the blur filter, including signal-capable inputs where declared.\n *\n * @see {@link SignalValue}\n * @see {@link blur}\n */\nexport interface PibblBlurFilterOptions {\n  /** Radius in the coordinate system of this geometry or effect. See {@link SignalValue}. */\n  readonly radius: SignalValue<number>;\n}\n/**\n * Parameters for the brightness filter, including signal-capable inputs where declared.\n *\n * @see {@link SignalValue}\n * @see {@link brightness}\n */\nexport interface PibblBrightnessFilterOptions {\n  /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */\n  readonly amount: SignalValue<number>;\n}\n/**\n * Parameters for the contrast filter, including signal-capable inputs where declared.\n *\n * @see {@link SignalValue}\n * @see {@link contrast}\n */\nexport interface PibblContrastFilterOptions {\n  /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */\n  readonly amount: SignalValue<number>;\n}\n/**\n * Parameters for the drop shadow filter, including signal-capable inputs where declared.\n *\n * @see {@link SignalValue}\n * @see {@link dropShadow}\n */\nexport interface PibblDropShadowFilterOptions {\n  /** Horizontal offset applied to the texture or shadow. See {@link SignalValue}. */\n  readonly offsetX: SignalValue<number>;\n  /** Vertical offset applied to the texture or shadow. See {@link SignalValue}. */\n  readonly offsetY: SignalValue<number>;\n  /** Radius of the shadow's blur. See {@link SignalValue}. */\n  readonly blurRadius?: SignalValue<number>;\n  /** Color used by the mark or effect. See {@link SignalValue}. */\n  readonly color: SignalValue<string>;\n}\n/**\n * Parameters for the grayscale filter, including signal-capable inputs where declared.\n *\n * @see {@link SignalValue}\n * @see {@link grayscale}\n */\nexport interface PibblGrayscaleFilterOptions {\n  /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */\n  readonly amount: SignalValue<number>;\n}\n/**\n * Parameters for the hue rotate filter, including signal-capable inputs where declared.\n *\n * @see {@link SignalValue}\n * @see {@link hueRotate}\n */\nexport interface PibblHueRotateFilterOptions {\n  /** Hue rotation in degrees. See {@link SignalValue}. */\n  readonly degrees: SignalValue<number>;\n}\n/**\n * Parameters for the invert filter, including signal-capable inputs where declared.\n *\n * @see {@link SignalValue}\n * @see {@link invert}\n */\nexport interface PibblInvertFilterOptions {\n  /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */\n  readonly amount: SignalValue<number>;\n}\n/**\n * Parameters for the opacity filter, including signal-capable inputs where declared.\n *\n * @see {@link SignalValue}\n * @see {@link opacity}\n */\nexport interface PibblOpacityFilterOptions {\n  /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */\n  readonly amount: SignalValue<number>;\n}\n/**\n * Parameters for the saturate filter, including signal-capable inputs where declared.\n *\n * @see {@link SignalValue}\n * @see {@link saturate}\n */\nexport interface PibblSaturateFilterOptions {\n  /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */\n  readonly amount: SignalValue<number>;\n}\n/**\n * Parameters for the sepia filter, including signal-capable inputs where declared.\n *\n * @see {@link SignalValue}\n * @see {@link sepia}\n */\nexport interface PibblSepiaFilterOptions {\n  /** Magnitude of the filter or motion adjustment. See {@link SignalValue}. */\n  readonly amount: SignalValue<number>;\n}\n/**\n * Parameters for the displacement filter, including signal-capable inputs where declared.\n *\n * @see {@link SignalValue}\n * @see {@link TexturePaint}\n * @see {@link displacement}\n */\nexport interface PibblDisplacementFilterOptions {\n  /**\n   * Optional local blur support radius. Blue \u00D7 alpha scales it; zero preserves displacement-only\n   * behavior.\n   */\n  readonly blurRadius?: SignalValue<number>;\n  /** Texture or image supplying displacement samples. See {@link SignalValue}, {@link TexturePaint}. */\n  readonly map: SignalValue<TexturePaint>;\n  /** Magnitude of the displacement or brush effect. See {@link SignalValue}. */\n  readonly strength: SignalValue<number>;\n  /**\n   * Logical region over which the effect is evaluated. See {@link PibblDisplacementFilterOptions}.\n   */\n  readonly region: Readonly<{\n    /**\n     * Horizontal coordinate or displacement in the containing coordinate system. See\n     * {@link PibblDisplacementFilterOptions}.\n     */\n    x: number;\n    /**\n     * Vertical coordinate or displacement in the containing coordinate system. See\n     * {@link PibblDisplacementFilterOptions}.\n     */\n    y: number;\n    /**\n     * Horizontal extent in the units of the containing geometry or surface. See\n     * {@link PibblDisplacementFilterOptions}.\n     */\n    width: number;\n    /**\n     * Vertical extent in the units of the containing geometry or surface. See\n     * {@link PibblDisplacementFilterOptions}.\n     */\n    height: number;\n  }>;\n}\n\n/**\n * Surface-light source. Images are caller-owned and must already be decoded.\n *\n * @see {@link TexturePaint}\n * @see {@link PibblReflectedLightFilterOptions}\n */\nexport type PibblReflectedLightSource = string | TexturePaint | HTMLImageElement | ImageBitmap;\n/**\n * Parameters for the reflected light filter, including signal-capable inputs where declared.\n *\n * @see {@link SignalValue}\n * @see {@link TexturePaint}\n * @see {@link PibblReflectedLightSource}\n * @see {@link reflectedLight}\n */\nexport interface PibblReflectedLightFilterOptions {\n  /** Texture or image supplying the surface-height samples. See {@link SignalValue}, {@link TexturePaint}. */\n  readonly map: SignalValue<TexturePaint>;\n  /**\n   * Logical region over which the effect is evaluated. See {@link PibblReflectedLightFilterOptions}\n   * .\n   */\n  readonly region: Readonly<{\n    /**\n     * Horizontal coordinate or displacement in the containing coordinate system. See\n     * {@link PibblReflectedLightFilterOptions}.\n     */\n    x: number;\n    /**\n     * Vertical coordinate or displacement in the containing coordinate system. See\n     * {@link PibblReflectedLightFilterOptions}.\n     */\n    y: number;\n    /**\n     * Horizontal extent in the units of the containing geometry or surface. See\n     * {@link PibblReflectedLightFilterOptions}.\n     */\n    width: number;\n    /**\n     * Vertical extent in the units of the containing geometry or surface. See\n     * {@link PibblReflectedLightFilterOptions}.\n     */\n    height: number;\n  }>;\n  /** Light-source position or direction used for the reflection. See {@link SignalValue}, {@link PibblReflectedLightSource}. */\n  readonly source?: SignalValue<PibblReflectedLightSource>;\n  /** Opacity of the painted result. See {@link SignalValue}. */\n  readonly opacity?: SignalValue<number>;\n  /** Intensity threshold used to select reflected-light contributions. See {@link SignalValue}. */\n  readonly threshold?: SignalValue<number>;\n  /** Softness of the reflected-light threshold boundary. See {@link SignalValue}. */\n  readonly softness?: SignalValue<number>;\n  /** Direction in which this operation proceeds. See {@link PibblReflectedLightFilterOptions}. */\n  readonly direction?: readonly [number, number];\n}\n"],
+  "mappings": "AAqBO,MAAM,wBAAwB,uBAAO,uBAAuB;",
+  "names": []
+}

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

@@ -0,0 +1,7 @@
+import type { StyleResolutionContext, SystemStyle } from '../types.js';
+import { type PibblFilter, type PreparedPibblFilter } from './filter-types.js';
+export interface ResolvedFilterList {
+    readonly values: readonly PreparedPibblFilter[];
+}
+export declare function resolveFilterList(value: PibblFilter | readonly PibblFilter[] | undefined, context: Readonly<StyleResolutionContext>): ResolvedFilterList | undefined;
+export declare function getResolvedFilterList(style: Readonly<SystemStyle>): ResolvedFilterList | undefined;

package/dist/lib/style/filter.js

@@ -0,0 +1,50 @@
+import { layoutDiagnostic } from "./diagnostics.js";
+import {
+  PIBBL_FILTER_EXECUTOR
+} from "./filter-types.js";
+function resolveFilterList(value, context) {
+  if (value === void 0) return void 0;
+  const list = Array.isArray(value) ? value : [value];
+  if (list.length === 0) return void 0;
+  const values = list.map((candidate, index) => prepareFilter(
+    candidate,
+    Array.isArray(value) ? `filter[${index}]` : "filter",
+    context
+  ));
+  if (values.some((value2) => value2.executor !== values[0].executor)) {
+    throw invalidFilter("filter", value, "contains incompatible boundary executors", context);
+  }
+  return Object.freeze({ values: Object.freeze(values) });
+}
+function getResolvedFilterList(style) {
+  const { filter } = style;
+  if (!Array.isArray(filter) || filter.length === 0) return void 0;
+  return Object.freeze({ values: filter });
+}
+function prepareFilter(value, property, context) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw invalidFilter(property, value, "must be a value returned by an imported filter factory", context);
+  }
+  const executor = value[PIBBL_FILTER_EXECUTOR];
+  if (!executor || typeof executor.prepare !== "function" || typeof executor.render !== "function") {
+    const legacy = value;
+    const reason = legacy.type === void 0 ? "must be a value returned by an imported filter factory" : "uses the removed descriptor form; import the matching factory from @pibbl/core/filters";
+    throw invalidFilter(property, value, reason, context);
+  }
+  return executor.prepare(value, property, context);
+}
+function invalidFilter(property, value, reason, context) {
+  return layoutDiagnostic({
+    component: context.component,
+    property,
+    value,
+    algorithm: context.algorithm,
+    constraints: context.constraints,
+    reason
+  });
+}
+export {
+  getResolvedFilterList,
+  resolveFilterList
+};
+//# sourceMappingURL=filter.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/style/filter.ts"],
+  "sourcesContent": ["import type { StyleResolutionContext, SystemStyle } from '../types.js';\nimport { layoutDiagnostic } from './diagnostics.js';\nimport {\n  PIBBL_FILTER_EXECUTOR,\n  type PibblFilter,\n  type PreparedPibblFilter,\n} from './filter-types.js';\n\nexport interface ResolvedFilterList {\n  readonly values: readonly PreparedPibblFilter[];\n}\n\nexport function resolveFilterList(\n  value: PibblFilter | readonly PibblFilter[] | undefined,\n  context: Readonly<StyleResolutionContext>,\n): ResolvedFilterList | undefined {\n  if (value === undefined) return undefined;\n  const list = Array.isArray(value) ? value : [value];\n  if (list.length === 0) return undefined;\n  const values = list.map((candidate, index) => prepareFilter(\n    candidate,\n    Array.isArray(value) ? `filter[${index}]` : 'filter',\n    context,\n  ));\n  if (values.some(value => value.executor !== values[0]!.executor)) {\n    throw invalidFilter('filter', value, 'contains incompatible boundary executors', context);\n  }\n  return Object.freeze({ values: Object.freeze(values) });\n}\n\nexport function getResolvedFilterList(style: Readonly<SystemStyle>): ResolvedFilterList | undefined {\n  const { filter } = style;\n  if (!Array.isArray(filter) || filter.length === 0) return undefined;\n  return Object.freeze({ values: filter as readonly PreparedPibblFilter[] });\n}\n\nfunction prepareFilter(value: unknown, property: string, context: Readonly<StyleResolutionContext>): PreparedPibblFilter {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    throw invalidFilter(property, value, 'must be a value returned by an imported filter factory', context);\n  }\n  const executor = (value as Partial<PibblFilter>)[PIBBL_FILTER_EXECUTOR];\n  if (!executor || typeof executor.prepare !== 'function' || typeof executor.render !== 'function') {\n    const legacy = value as { type?: unknown };\n    const reason = legacy.type === undefined ?\n      'must be a value returned by an imported filter factory' :\n      'uses the removed descriptor form; import the matching factory from @pibbl/core/filters';\n    throw invalidFilter(property, value, reason, context);\n  }\n  return executor.prepare(value as PibblFilter, property, context);\n}\n\nfunction invalidFilter(property: string, value: unknown, reason: string, context: Readonly<StyleResolutionContext>) {\n  return layoutDiagnostic({\n    component: context.component,\n    property,\n    value,\n    algorithm: context.algorithm,\n    constraints: context.constraints,\n    reason,\n  });\n}\n"],
+  "mappings": "AACA,SAAS,wBAAwB;AACjC;AAAA,EACE;AAAA,OAGK;AAMA,SAAS,kBACd,OACA,SACgC;AAChC,MAAI,UAAU,OAAW,QAAO;AAChC,QAAM,OAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AAClD,MAAI,KAAK,WAAW,EAAG,QAAO;AAC9B,QAAM,SAAS,KAAK,IAAI,CAAC,WAAW,UAAU;AAAA,IAC5C;AAAA,IACA,MAAM,QAAQ,KAAK,IAAI,UAAU,KAAK,MAAM;AAAA,IAC5C;AAAA,EACF,CAAC;AACD,MAAI,OAAO,KAAK,CAAAA,WAASA,OAAM,aAAa,OAAO,CAAC,EAAG,QAAQ,GAAG;AAChE,UAAM,cAAc,UAAU,OAAO,4CAA4C,OAAO;AAAA,EAC1F;AACA,SAAO,OAAO,OAAO,EAAE,QAAQ,OAAO,OAAO,MAAM,EAAE,CAAC;AACxD;AAEO,SAAS,sBAAsB,OAA8D;AAClG,QAAM,EAAE,OAAO,IAAI;AACnB,MAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,EAAG,QAAO;AAC1D,SAAO,OAAO,OAAO,EAAE,QAAQ,OAAyC,CAAC;AAC3E;AAEA,SAAS,cAAc,OAAgB,UAAkB,SAAgE;AACvH,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;AAC/D,UAAM,cAAc,UAAU,OAAO,0DAA0D,OAAO;AAAA,EACxG;AACA,QAAM,WAAY,MAA+B,qBAAqB;AACtE,MAAI,CAAC,YAAY,OAAO,SAAS,YAAY,cAAc,OAAO,SAAS,WAAW,YAAY;AAChG,UAAM,SAAS;AACf,UAAM,SAAS,OAAO,SAAS,SAC7B,2DACA;AACF,UAAM,cAAc,UAAU,OAAO,QAAQ,OAAO;AAAA,EACtD;AACA,SAAO,SAAS,QAAQ,OAAsB,UAAU,OAAO;AACjE;AAEA,SAAS,cAAc,UAAkB,OAAgB,QAAgB,SAA2C;AAClH,SAAO,iBAAiB;AAAA,IACtB,WAAW,QAAQ;AAAA,IACnB;AAAA,IACA;AAAA,IACA,WAAW,QAAQ;AAAA,IACnB,aAAa,QAAQ;AAAA,IACrB;AAAA,EACF,CAAC;AACH;",
+  "names": ["value"]
+}

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

@@ -0,0 +1,18 @@
+import type { Edges } from '../layout/types.js';
+import { type LayoutDiagnosticContext } from './diagnostics.js';
+import type { EdgeValues } from './types.js';
+/**
+ * Expands shorthand insets into four validated numeric edges.
+ *
+ * @param value - Edge shorthand to expand; undefined uses the empty edge defaults. See
+ * {@link EdgeValues} .
+ * @param property - Property name used in diagnostics.
+ * @param context - Component and property context for diagnostic messages. See
+ * {@link LayoutDiagnosticContext} .
+ * @returns Explicit top, right, bottom, and left edge values. See {@link Edges}.
+ *
+ * @see {@link EdgeValues}
+ * @see {@link LayoutDiagnosticContext}
+ * @see {@link Edges}
+ */
+export declare function normalizeEdges(value: EdgeValues | undefined, property: string, context?: Readonly<LayoutDiagnosticContext>): Edges;

package/dist/lib/style/normalize.js

@@ -0,0 +1,50 @@
+import {
+  layoutDiagnostic
+} from "./diagnostics.js";
+function normalizeEdges(value, property, context = {}) {
+  if (value === void 0) return zeroEdges();
+  if (typeof value === "number") {
+    const edge = validateEdge(value, property, context);
+    return { top: edge, right: edge, bottom: edge, left: edge };
+  }
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw layoutDiagnostic({
+      ...context,
+      property,
+      value,
+      reason: `uses an unsupported edge value ${String(value)}`
+    });
+  }
+  return {
+    top: validateEdge(value.top ?? 0, `${property}.top`, context),
+    right: validateEdge(value.right ?? 0, `${property}.right`, context),
+    bottom: validateEdge(value.bottom ?? 0, `${property}.bottom`, context),
+    left: validateEdge(value.left ?? 0, `${property}.left`, context)
+  };
+}
+function validateEdge(value, property, context) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw layoutDiagnostic({
+      ...context,
+      property,
+      value,
+      reason: "must be a finite number"
+    });
+  }
+  if (value < 0) {
+    throw layoutDiagnostic({
+      ...context,
+      property,
+      value,
+      reason: "must be nonnegative"
+    });
+  }
+  return value;
+}
+function zeroEdges() {
+  return { top: 0, right: 0, bottom: 0, left: 0 };
+}
+export {
+  normalizeEdges
+};
+//# sourceMappingURL=normalize.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/style/normalize.ts"],
+  "sourcesContent": ["import type { Edges } from '../layout/types.js';\nimport {\n  layoutDiagnostic,\n  type LayoutDiagnosticContext,\n} from './diagnostics.js';\nimport type { EdgeValues } from './types.js';\n\n/**\n * Expands shorthand insets into four validated numeric edges.\n *\n * @param value - Edge shorthand to expand; undefined uses the empty edge defaults. See\n * {@link EdgeValues} .\n * @param property - Property name used in diagnostics.\n * @param context - Component and property context for diagnostic messages. See\n * {@link LayoutDiagnosticContext} .\n * @returns Explicit top, right, bottom, and left edge values. See {@link Edges}.\n *\n * @see {@link EdgeValues}\n * @see {@link LayoutDiagnosticContext}\n * @see {@link Edges}\n */\nexport function normalizeEdges(\n  value: EdgeValues | undefined,\n  property: string,\n  context: Readonly<LayoutDiagnosticContext> = {},\n): Edges {\n  if (value === undefined) return zeroEdges();\n  if (typeof value === 'number') {\n    const edge = validateEdge(value, property, context);\n    return { top: edge, right: edge, bottom: edge, left: edge };\n  }\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n    throw layoutDiagnostic({\n      ...context,\n      property,\n      value,\n      reason: `uses an unsupported edge value ${String(value)}`,\n    });\n  }\n\n  return {\n    top: validateEdge(value.top ?? 0, `${property}.top`, context),\n    right: validateEdge(value.right ?? 0, `${property}.right`, context),\n    bottom: validateEdge(value.bottom ?? 0, `${property}.bottom`, context),\n    left: validateEdge(value.left ?? 0, `${property}.left`, context),\n  };\n}\n\nfunction validateEdge(\n  value: number,\n  property: string,\n  context: Readonly<LayoutDiagnosticContext>,\n): number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw layoutDiagnostic({\n      ...context,\n      property,\n      value,\n      reason: 'must be a finite number',\n    });\n  }\n  if (value < 0) {\n    throw layoutDiagnostic({\n      ...context,\n      property,\n      value,\n      reason: 'must be nonnegative',\n    });\n  }\n  return value;\n}\n\nfunction zeroEdges(): Edges {\n  return { top: 0, right: 0, bottom: 0, left: 0 };\n}\n"],
+  "mappings": "AACA;AAAA,EACE;AAAA,OAEK;AAiBA,SAAS,eACd,OACA,UACA,UAA6C,CAAC,GACvC;AACP,MAAI,UAAU,OAAW,QAAO,UAAU;AAC1C,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,OAAO,aAAa,OAAO,UAAU,OAAO;AAClD,WAAO,EAAE,KAAK,MAAM,OAAO,MAAM,QAAQ,MAAM,MAAM,KAAK;AAAA,EAC5D;AACA,MAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;AACvE,UAAM,iBAAiB;AAAA,MACrB,GAAG;AAAA,MACH;AAAA,MACA;AAAA,MACA,QAAQ,kCAAkC,OAAO,KAAK,CAAC;AAAA,IACzD,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL,KAAK,aAAa,MAAM,OAAO,GAAG,GAAG,QAAQ,QAAQ,OAAO;AAAA,IAC5D,OAAO,aAAa,MAAM,SAAS,GAAG,GAAG,QAAQ,UAAU,OAAO;AAAA,IAClE,QAAQ,aAAa,MAAM,UAAU,GAAG,GAAG,QAAQ,WAAW,OAAO;AAAA,IACrE,MAAM,aAAa,MAAM,QAAQ,GAAG,GAAG,QAAQ,SAAS,OAAO;AAAA,EACjE;AACF;AAEA,SAAS,aACP,OACA,UACA,SACQ;AACR,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,GAAG;AACxD,UAAM,iBAAiB;AAAA,MACrB,GAAG;AAAA,MACH;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AACA,MAAI,QAAQ,GAAG;AACb,UAAM,iBAAiB;AAAA,MACrB,GAAG;AAAA,MACH;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAEA,SAAS,YAAmB;AAC1B,SAAO,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,EAAE;AAChD;",
+  "names": []
+}

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

@@ -0,0 +1,32 @@
+import type { StyleResolutionContext, SystemStyle } from '../types.js';
+import type { PibblElement } from '../element/types.js';
+import type { Length } from './types.js';
+/** @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. */
+export declare function enterPlacementHandoffCapture(props: unknown, consumedStyle: Readonly<SystemStyle> | undefined): () => void;
+/** @internal Annotates an element created with the active forwarded style signal. */
+export declare function capturePlacementHandoff(element: PibblElement<any>, style: unknown): void;
+/** @internal Reads the original style behind an enumerable forwarding marker. */
+export declare function getPlacementHandoffSource(style: unknown): Readonly<SystemStyle> | undefined;
+/** @internal Removes a private handoff marker before style callbacks run. */
+export declare function consumePlacementHandoff(style: Readonly<SystemStyle>): Readonly<SystemStyle>;
+/** @internal Determines whether a primitive consumes one forwarded signal style. */
+export declare function getPlacementSignalHandoff(element: PibblElement<any>): Readonly<SystemStyle> | undefined;
+/**
+ * Offsets in the parent layout coordinate system; percentages resolve against the containing box.
+ *
+ * @see {@link Length}
+ * @see {@link SystemStyle}
+ */
+export interface PositioningStyle extends SystemStyle {
+    /** Left edge coordinate or inset. See {@link Length}. */
+    left?: Exclude<Length, 'auto'>;
+    /** Top edge value or top envelope guide. See {@link Length}. */
+    top?: Exclude<Length, 'auto'>;
+}
+export interface ResolvedPosition {
+    left: number;
+    top: number;
+}
+export declare function resolveStandalonePosition(style: Readonly<PositioningStyle>, context: Readonly<StyleResolutionContext>): ResolvedPosition;