@pibbl/core 0.0.1

package/dist/lib/components/regular-polygon.js

@@ -0,0 +1,112 @@
+import { definePrimitive } from "../define-primitive.js";
+import {
+  resolveRegularPolygonGeometry
+} from "../geometry/regular-polygon.js";
+import {
+  integerAtLeast
+} from "../geometry/validation.js";
+import {
+  resolveLocalOffset,
+  stripLayoutParticipation
+} from "../style/resolve-built-in.js";
+import { registerOpaqueStyleProperties } from "../style/resolve-dispatch.js";
+import { renderPath } from "./path.js";
+import { resolveRoundedCornerStyle } from "./rounded-corner-style.js";
+import {
+  circularPercentageBasis,
+  resolveFiniteShapeNumber,
+  resolveNonnegativeShapeLength,
+  shapeGeometryErrorFactory
+} from "./shape-style.js";
+function renderRegularPolygon(props, style, ctx) {
+  const {
+    sides,
+    cx,
+    cy,
+    rotation,
+    circumradius,
+    inradius,
+    sideLength,
+    cornerRadius,
+    cornerRadii,
+    geometryErrorFactory,
+    ...pathStyle
+  } = style;
+  const geometry = resolveRegularPolygonGeometry({
+    sides,
+    cx,
+    cy,
+    rotation,
+    ...circumradius === void 0 ? {} : { circumradius },
+    ...inradius === void 0 ? {} : { inradius },
+    ...sideLength === void 0 ? {} : { sideLength },
+    cornerRadius,
+    cornerRadii
+  }, geometryErrorFactory);
+  return renderPath({
+    ...props,
+    keyboardNavigationBounds: props.keyboardNavigationBounds ?? geometry.bounds
+  }, {
+    ...pathStyle,
+    d: geometry.path
+  }, ctx);
+}
+const RegularPolygon = definePrimitive(renderRegularPolygon, {
+  resolveStyle: (style, context) => {
+    const errorFactory = shapeGeometryErrorFactory(context);
+    const sides = integerAtLeast(style.sides, 3, "sides", errorFactory);
+    const basis = circularPercentageBasis(context);
+    return {
+      ...stripLayoutParticipation(style),
+      sides,
+      cx: resolveLocalOffset(
+        style.cx,
+        context.percentageBasis.width,
+        "cx",
+        context
+      ),
+      cy: resolveLocalOffset(
+        style.cy,
+        context.percentageBasis.height,
+        "cy",
+        context
+      ),
+      rotation: resolveFiniteShapeNumber(
+        style.rotation ?? -Math.PI / 2,
+        "rotation",
+        context
+      ),
+      ...style.circumradius === void 0 ? {} : {
+        circumradius: resolveNonnegativeShapeLength(
+          style.circumradius,
+          basis,
+          "circumradius",
+          context
+        )
+      },
+      ...style.inradius === void 0 ? {} : {
+        inradius: resolveNonnegativeShapeLength(
+          style.inradius,
+          basis,
+          "inradius",
+          context
+        )
+      },
+      ...style.sideLength === void 0 ? {} : {
+        sideLength: resolveNonnegativeShapeLength(
+          style.sideLength,
+          basis,
+          "sideLength",
+          context
+        )
+      },
+      ...resolveRoundedCornerStyle(sides, style, context),
+      geometryErrorFactory: errorFactory
+    };
+  }
+});
+registerOpaqueStyleProperties(RegularPolygon, ["fill", "stroke", "cursor"]);
+export {
+  RegularPolygon
+};
+//# sourceMappingURL=regular-polygon.js.map

package/dist/lib/components/regular-polygon.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/components/regular-polygon.ts"],
+  "sourcesContent": ["import { definePrimitive } from '../define-primitive.js';\nimport type {\n  PibblEventFocusOptions,\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n} from '../events/types.js';\nimport {\n  resolveRegularPolygonGeometry,\n  type RegularPolygonPathOptions,\n} from '../geometry/regular-polygon.js';\nimport {\n  integerAtLeast,\n  type GeometryErrorFactory,\n} from '../geometry/validation.js';\nimport {\n  resolveLocalOffset,\n  stripLayoutParticipation,\n} from '../style/resolve-built-in.js';\nimport { registerOpaqueStyleProperties } from '../style/resolve-dispatch.js';\nimport type {\n  BoxStyle,\n  CursorStyle,\n  LayoutItemStyle,\n  Length,\n  PaintStyle,\n  RoundedCornerStyle,\n} from '../style/types.js';\nimport type { RenderingContext2D, SystemStyle } from '../types.js';\nimport type { PibblPhysics2DPropExtension } from '../types.js';\nimport { renderPath } from './path.js';\nimport { resolveRoundedCornerStyle } from './rounded-corner-style.js';\nimport {\n  circularPercentageBasis,\n  resolveFiniteShapeNumber,\n  resolveNonnegativeShapeLength,\n  shapeGeometryErrorFactory,\n} from './shape-style.js';\n\n/**\n * Authored inputs for RegularPolygon, including the declared data and presentation options.\n *\n * @see {@link PibblEventHandlers}\n * @see {@link PibblEventParticipationOptions}\n * @see {@link PibblPhysics2DPropExtension}\n * @see {@link RegularPolygon}\n */\nexport interface RegularPolygonProps\n  extends PibblEventHandlers, PibblEventFocusOptions, PibblEventParticipationOptions, PibblPhysics2DPropExtension {}\n\n/**\n * Center, side count, rotation, and paint shared by regular-polygon size variants.\n *\n * @see {@link RegularPolygonStyle}\n */\ninterface RegularPolygonCommonStyle extends RoundedCornerStyle {\n  /** Number of sides of the regular polygon. See {@link RegularPolygonCommonStyle}. */\n  sides: number;\n  /** Horizontal coordinate of the center. See {@link Length}. */\n  cx?: Exclude<Length, 'auto'>;\n  /** Vertical coordinate of the center. See {@link Length}. */\n  cy?: Exclude<Length, 'auto'>;\n  /** Rotation applied to the containing geometry. See {@link RegularPolygonCommonStyle}. */\n  rotation?: number;\n  /**\n   * Width used for line hit testing independently of the visible stroke width. See\n   * {@link RegularPolygonCommonStyle}.\n   */\n  lineInteractionWidth?: number;\n}\n\n/**\n * Exactly one declared size measure for a regular polygon.\n *\n * @see {@link RegularPolygonStyle}\n */\ntype RegularPolygonSizeStyle =\n  | {\n      /** Distance from the polygon center to a vertex. See {@link Length}. */\n      circumradius: Exclude<Length, 'auto'>;\n      /**\n       * Not accepted in this variant; use the alternative fields instead. See\n       * {@link RegularPolygonSizeStyle}.\n       */\n      inradius?: never;\n      /**\n       * Not accepted in this variant; use the alternative fields instead. See\n       * {@link RegularPolygonSizeStyle}.\n       */\n      sideLength?: never;\n    }\n  | {\n      /**\n       * Not accepted in this variant; use the alternative fields instead. See\n       * {@link RegularPolygonSizeStyle}.\n       */\n      circumradius?: never;\n      /** Distance from the polygon center to an edge. See {@link Length}. */\n      inradius: Exclude<Length, 'auto'>;\n      /**\n       * Not accepted in this variant; use the alternative fields instead. See\n       * {@link RegularPolygonSizeStyle}.\n       */\n      sideLength?: never;\n    }\n  | {\n      /**\n       * Not accepted in this variant; use the alternative fields instead. See\n       * {@link RegularPolygonSizeStyle}.\n       */\n      circumradius?: never;\n      /**\n       * Not accepted in this variant; use the alternative fields instead. See\n       * {@link RegularPolygonSizeStyle}.\n       */\n      inradius?: never;\n      /** Length of one polygon edge. See {@link Length}. */\n      sideLength: Exclude<Length, 'auto'>;\n    };\n\n/**\n * Supported geometry and presentation properties for RegularPolygon.\n *\n * @see {@link SystemStyle}\n * @see {@link PaintStyle}\n * @see {@link CursorStyle}\n * @see {@link BoxStyle}\n * @see {@link LayoutItemStyle}\n * @see {@link RegularPolygon}\n */\nexport type RegularPolygonStyle = RegularPolygonCommonStyle &\n  RegularPolygonSizeStyle &\n  SystemStyle &\n  PaintStyle &\n  CursorStyle &\n  BoxStyle &\n  LayoutItemStyle;\n\ninterface ResolvedRegularPolygonStyle\n  extends SystemStyle, PaintStyle, CursorStyle {\n  sides: number;\n  cx: number;\n  cy: number;\n  rotation: number;\n  circumradius?: number;\n  inradius?: number;\n  sideLength?: number;\n  cornerRadius?: number;\n  cornerRadii?: readonly (number | null | undefined)[];\n  lineInteractionWidth?: number;\n  geometryErrorFactory: GeometryErrorFactory;\n}\n\nfunction renderRegularPolygon(\n  props: RegularPolygonProps,\n  style: Readonly<ResolvedRegularPolygonStyle>,\n  ctx: RenderingContext2D,\n) {\n  const {\n    sides,\n    cx,\n    cy,\n    rotation,\n    circumradius,\n    inradius,\n    sideLength,\n    cornerRadius,\n    cornerRadii,\n    geometryErrorFactory,\n    ...pathStyle\n  } = style;\n  const geometry = resolveRegularPolygonGeometry({\n    sides,\n    cx,\n    cy,\n    rotation,\n    ...(circumradius === undefined ? {} : { circumradius }),\n    ...(inradius === undefined ? {} : { inradius }),\n    ...(sideLength === undefined ? {} : { sideLength }),\n    cornerRadius,\n    cornerRadii,\n  } as RegularPolygonPathOptions, geometryErrorFactory);\n\n  return renderPath({\n    ...props,\n    keyboardNavigationBounds: props.keyboardNavigationBounds ?? geometry.bounds,\n  }, {\n    ...pathStyle,\n    d: geometry.path,\n  }, ctx);\n}\n\n/**\n * Describes a regular-polygon primitive for JSX or createElement authoring.\n *\n * @param props - Authored component inputs, supplied through JSX or createElement. See the linked\n * props and style types.\n * @throws When called directly; Pibbl mounts this component through JSX or createElement.\n *\n * @see {@link RegularPolygonProps}\n * @see {@link RegularPolygonStyle}\n */\nexport const RegularPolygon = definePrimitive<\n  RegularPolygonProps,\n  RegularPolygonStyle,\n  RegularPolygonStyle,\n  ResolvedRegularPolygonStyle\n>(renderRegularPolygon, {\n  resolveStyle: (style, context) => {\n    const errorFactory = shapeGeometryErrorFactory(context);\n    const sides = integerAtLeast(style.sides, 3, 'sides', errorFactory);\n    const basis = circularPercentageBasis(context);\n    return {\n      ...stripLayoutParticipation(style),\n      sides,\n      cx: resolveLocalOffset(\n        style.cx,\n        context.percentageBasis.width,\n        'cx',\n        context,\n      ),\n      cy: resolveLocalOffset(\n        style.cy,\n        context.percentageBasis.height,\n        'cy',\n        context,\n      ),\n      rotation: resolveFiniteShapeNumber(\n        style.rotation ?? -Math.PI / 2,\n        'rotation',\n        context,\n      ),\n      ...(style.circumradius === undefined ? {} : {\n        circumradius: resolveNonnegativeShapeLength(\n          style.circumradius,\n          basis,\n          'circumradius',\n          context,\n        ),\n      }),\n      ...(style.inradius === undefined ? {} : {\n        inradius: resolveNonnegativeShapeLength(\n          style.inradius,\n          basis,\n          'inradius',\n          context,\n        ),\n      }),\n      ...(style.sideLength === undefined ? {} : {\n        sideLength: resolveNonnegativeShapeLength(\n          style.sideLength,\n          basis,\n          'sideLength',\n          context,\n        ),\n      }),\n      ...resolveRoundedCornerStyle(sides, style, context),\n      geometryErrorFactory: errorFactory,\n    } as ResolvedRegularPolygonStyle;\n  },\n});\nregisterOpaqueStyleProperties(RegularPolygon, ['fill', 'stroke', 'cursor']);\n"],
+  "mappings": "AAAA,SAAS,uBAAuB;AAMhC;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,qCAAqC;AAW9C,SAAS,kBAAkB;AAC3B,SAAS,iCAAiC;AAC1C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAoHP,SAAS,qBACP,OACA,OACA,KACA;AACA,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,QAAM,WAAW,8BAA8B;AAAA,IAC7C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAI,iBAAiB,SAAY,CAAC,IAAI,EAAE,aAAa;AAAA,IACrD,GAAI,aAAa,SAAY,CAAC,IAAI,EAAE,SAAS;AAAA,IAC7C,GAAI,eAAe,SAAY,CAAC,IAAI,EAAE,WAAW;AAAA,IACjD;AAAA,IACA;AAAA,EACF,GAAgC,oBAAoB;AAEpD,SAAO,WAAW;AAAA,IAChB,GAAG;AAAA,IACH,0BAA0B,MAAM,4BAA4B,SAAS;AAAA,EACvE,GAAG;AAAA,IACD,GAAG;AAAA,IACH,GAAG,SAAS;AAAA,EACd,GAAG,GAAG;AACR;AAYO,MAAM,iBAAiB,gBAK5B,sBAAsB;AAAA,EACtB,cAAc,CAAC,OAAO,YAAY;AAChC,UAAM,eAAe,0BAA0B,OAAO;AACtD,UAAM,QAAQ,eAAe,MAAM,OAAO,GAAG,SAAS,YAAY;AAClE,UAAM,QAAQ,wBAAwB,OAAO;AAC7C,WAAO;AAAA,MACL,GAAG,yBAAyB,KAAK;AAAA,MACjC;AAAA,MACA,IAAI;AAAA,QACF,MAAM;AAAA,QACN,QAAQ,gBAAgB;AAAA,QACxB;AAAA,QACA;AAAA,MACF;AAAA,MACA,IAAI;AAAA,QACF,MAAM;AAAA,QACN,QAAQ,gBAAgB;AAAA,QACxB;AAAA,QACA;AAAA,MACF;AAAA,MACA,UAAU;AAAA,QACR,MAAM,YAAY,CAAC,KAAK,KAAK;AAAA,QAC7B;AAAA,QACA;AAAA,MACF;AAAA,MACA,GAAI,MAAM,iBAAiB,SAAY,CAAC,IAAI;AAAA,QAC1C,cAAc;AAAA,UACZ,MAAM;AAAA,UACN;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,MACA,GAAI,MAAM,aAAa,SAAY,CAAC,IAAI;AAAA,QACtC,UAAU;AAAA,UACR,MAAM;AAAA,UACN;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,MACA,GAAI,MAAM,eAAe,SAAY,CAAC,IAAI;AAAA,QACxC,YAAY;AAAA,UACV,MAAM;AAAA,UACN;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,MACA,GAAG,0BAA0B,OAAO,OAAO,OAAO;AAAA,MAClD,sBAAsB;AAAA,IACxB;AAAA,EACF;AACF,CAAC;AACD,8BAA8B,gBAAgB,CAAC,QAAQ,UAAU,QAAQ,CAAC;",
+  "names": []
+}

package/dist/lib/components/rounded-corner-style.d.ts

@@ -0,0 +1,7 @@
+import type { RoundedCornerStyle } from '../style/types.js';
+import type { StyleResolutionContext } from '../types.js';
+export interface ResolvedRoundedCornerStyle {
+    cornerRadius?: number;
+    cornerRadii?: readonly (number | null | undefined)[];
+}
+export declare function resolveRoundedCornerStyle(cornerCount: number, style: Readonly<RoundedCornerStyle>, context: Readonly<StyleResolutionContext>): ResolvedRoundedCornerStyle;

package/dist/lib/components/rounded-corner-style.js

@@ -0,0 +1,40 @@
+import { layoutDiagnostic } from "../style/diagnostics.js";
+import { resolveRequiredLength } from "../style/resolve-built-in.js";
+import { circularPercentageBasis } from "./shape-style.js";
+function resolveRoundedCornerStyle(cornerCount, style, context) {
+  if (style.cornerRadii && style.cornerRadii.length > cornerCount) {
+    throw layoutDiagnostic({
+      component: context.component,
+      property: "cornerRadii",
+      value: style.cornerRadii.length,
+      algorithm: context.algorithm,
+      constraints: context.constraints,
+      reason: `length must not exceed corner count ${cornerCount}`
+    });
+  }
+  const basis = circularPercentageBasis(context);
+  const resolveRadius = (value, property) => {
+    const resolved = resolveRequiredLength(value, basis, property, context);
+    if (resolved < 0) {
+      throw layoutDiagnostic({
+        component: context.component,
+        property,
+        value,
+        algorithm: context.algorithm,
+        constraints: context.constraints,
+        reason: "must resolve to a nonnegative number"
+      });
+    }
+    return resolved;
+  };
+  return {
+    cornerRadius: style.cornerRadius === void 0 ? void 0 : resolveRadius(style.cornerRadius, "cornerRadius"),
+    cornerRadii: style.cornerRadii?.map(
+      (radius, index) => radius === null || radius === void 0 ? radius : resolveRadius(radius, `cornerRadii[${index}]`)
+    )
+  };
+}
+export {
+  resolveRoundedCornerStyle
+};
+//# sourceMappingURL=rounded-corner-style.js.map

package/dist/lib/components/rounded-corner-style.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/components/rounded-corner-style.ts"],
+  "sourcesContent": ["import { layoutDiagnostic } from '../style/diagnostics.js';\nimport { resolveRequiredLength } from '../style/resolve-built-in.js';\nimport type { RoundedCornerStyle } from '../style/types.js';\nimport type { StyleResolutionContext } from '../types.js';\nimport { circularPercentageBasis } from './shape-style.js';\n\nexport interface ResolvedRoundedCornerStyle {\n  cornerRadius?: number;\n  cornerRadii?: readonly (number | null | undefined)[];\n}\n\nexport function resolveRoundedCornerStyle(\n  cornerCount: number,\n  style: Readonly<RoundedCornerStyle>,\n  context: Readonly<StyleResolutionContext>,\n): ResolvedRoundedCornerStyle {\n  if (style.cornerRadii && style.cornerRadii.length > cornerCount) {\n    throw layoutDiagnostic({\n      component: context.component,\n      property: 'cornerRadii',\n      value: style.cornerRadii.length,\n      algorithm: context.algorithm,\n      constraints: context.constraints,\n      reason: `length must not exceed corner count ${cornerCount}`,\n    });\n  }\n\n  const basis = circularPercentageBasis(context);\n  const resolveRadius = (\n    value: NonNullable<RoundedCornerStyle['cornerRadius']>,\n    property: string,\n  ) => {\n    const resolved = resolveRequiredLength(value, basis, property, context);\n    if (resolved < 0) {\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 nonnegative number',\n      });\n    }\n    return resolved;\n  };\n\n  return {\n    cornerRadius: style.cornerRadius === undefined ? undefined :\n      resolveRadius(style.cornerRadius, 'cornerRadius'),\n    cornerRadii: style.cornerRadii?.map((radius, index) =>\n      radius === null || radius === undefined ? radius :\n        resolveRadius(radius, `cornerRadii[${index}]`),\n    ),\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,wBAAwB;AACjC,SAAS,6BAA6B;AAGtC,SAAS,+BAA+B;AAOjC,SAAS,0BACd,aACA,OACA,SAC4B;AAC5B,MAAI,MAAM,eAAe,MAAM,YAAY,SAAS,aAAa;AAC/D,UAAM,iBAAiB;AAAA,MACrB,WAAW,QAAQ;AAAA,MACnB,UAAU;AAAA,MACV,OAAO,MAAM,YAAY;AAAA,MACzB,WAAW,QAAQ;AAAA,MACnB,aAAa,QAAQ;AAAA,MACrB,QAAQ,uCAAuC,WAAW;AAAA,IAC5D,CAAC;AAAA,EACH;AAEA,QAAM,QAAQ,wBAAwB,OAAO;AAC7C,QAAM,gBAAgB,CACpB,OACA,aACG;AACH,UAAM,WAAW,sBAAsB,OAAO,OAAO,UAAU,OAAO;AACtE,QAAI,WAAW,GAAG;AAChB,YAAM,iBAAiB;AAAA,QACrB,WAAW,QAAQ;AAAA,QACnB;AAAA,QACA;AAAA,QACA,WAAW,QAAQ;AAAA,QACnB,aAAa,QAAQ;AAAA,QACrB,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,cAAc,MAAM,iBAAiB,SAAY,SAC/C,cAAc,MAAM,cAAc,cAAc;AAAA,IAClD,aAAa,MAAM,aAAa;AAAA,MAAI,CAAC,QAAQ,UAC3C,WAAW,QAAQ,WAAW,SAAY,SACxC,cAAc,QAAQ,eAAe,KAAK,GAAG;AAAA,IACjD;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/components/shape-style.d.ts

@@ -0,0 +1,7 @@
+import type { Length } from '../style/types.js';
+import type { StyleResolutionContext } from '../types.js';
+import type { GeometryErrorFactory } from '../geometry/validation.js';
+export declare function resolveNonnegativeShapeLength(value: Exclude<Length, 'auto'>, reference: number, property: string, context: Readonly<StyleResolutionContext>): number;
+export declare function resolveFiniteShapeNumber(value: number, property: string, context: Readonly<StyleResolutionContext>): number;
+export declare function circularPercentageBasis(context: Readonly<StyleResolutionContext>): number;
+export declare function shapeGeometryErrorFactory(context: Readonly<StyleResolutionContext>): GeometryErrorFactory;

package/dist/lib/components/shape-style.js

@@ -0,0 +1,52 @@
+import { layoutDiagnostic } from "../style/diagnostics.js";
+import { resolveRequiredLength } from "../style/resolve-built-in.js";
+function resolveNonnegativeShapeLength(value, reference, property, context) {
+  const resolved = resolveRequiredLength(value, reference, property, context);
+  if (resolved < 0) {
+    throw layoutDiagnostic({
+      component: context.component,
+      property,
+      value,
+      algorithm: context.algorithm,
+      constraints: context.constraints,
+      reason: "must resolve to a nonnegative number"
+    });
+  }
+  return resolved;
+}
+function resolveFiniteShapeNumber(value, property, context) {
+  if (!Number.isFinite(value)) {
+    throw layoutDiagnostic({
+      component: context.component,
+      property,
+      value,
+      algorithm: context.algorithm,
+      constraints: context.constraints,
+      reason: "must be a finite number"
+    });
+  }
+  return value;
+}
+function circularPercentageBasis(context) {
+  return Math.min(
+    context.percentageBasis.width,
+    context.percentageBasis.height
+  );
+}
+function shapeGeometryErrorFactory(context) {
+  return (property, value, reason) => layoutDiagnostic({
+    component: context.component,
+    property,
+    value,
+    algorithm: context.algorithm,
+    constraints: context.constraints,
+    reason
+  });
+}
+export {
+  circularPercentageBasis,
+  resolveFiniteShapeNumber,
+  resolveNonnegativeShapeLength,
+  shapeGeometryErrorFactory
+};
+//# sourceMappingURL=shape-style.js.map

package/dist/lib/components/shape-style.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/components/shape-style.ts"],
+  "sourcesContent": ["import { layoutDiagnostic } from '../style/diagnostics.js';\nimport { resolveRequiredLength } from '../style/resolve-built-in.js';\nimport type { Length } from '../style/types.js';\nimport type { StyleResolutionContext } from '../types.js';\nimport type { GeometryErrorFactory } from '../geometry/validation.js';\n\nexport function resolveNonnegativeShapeLength(\n  value: Exclude<Length, 'auto'>,\n  reference: number,\n  property: string,\n  context: Readonly<StyleResolutionContext>,\n): number {\n  const resolved = resolveRequiredLength(value, reference, property, context);\n  if (resolved < 0) {\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 nonnegative number',\n    });\n  }\n  return resolved;\n}\n\nexport function resolveFiniteShapeNumber(\n  value: number,\n  property: string,\n  context: Readonly<StyleResolutionContext>,\n): number {\n  if (!Number.isFinite(value)) {\n    throw layoutDiagnostic({\n      component: context.component,\n      property,\n      value,\n      algorithm: context.algorithm,\n      constraints: context.constraints,\n      reason: 'must be a finite number',\n    });\n  }\n  return value;\n}\n\nexport function circularPercentageBasis(\n  context: Readonly<StyleResolutionContext>,\n): number {\n  return Math.min(\n    context.percentageBasis.width,\n    context.percentageBasis.height,\n  );\n}\n\nexport function shapeGeometryErrorFactory(\n  context: Readonly<StyleResolutionContext>,\n): GeometryErrorFactory {\n  return (property, value, reason) => layoutDiagnostic({\n    component: context.component,\n    property,\n    value,\n    algorithm: context.algorithm,\n    constraints: context.constraints,\n    reason,\n  });\n}\n"],
+  "mappings": "AAAA,SAAS,wBAAwB;AACjC,SAAS,6BAA6B;AAK/B,SAAS,8BACd,OACA,WACA,UACA,SACQ;AACR,QAAM,WAAW,sBAAsB,OAAO,WAAW,UAAU,OAAO;AAC1E,MAAI,WAAW,GAAG;AAChB,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,yBACd,OACA,UACA,SACQ;AACR,MAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AAC3B,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,wBACd,SACQ;AACR,SAAO,KAAK;AAAA,IACV,QAAQ,gBAAgB;AAAA,IACxB,QAAQ,gBAAgB;AAAA,EAC1B;AACF;AAEO,SAAS,0BACd,SACsB;AACtB,SAAO,CAAC,UAAU,OAAO,WAAW,iBAAiB;AAAA,IACnD,WAAW,QAAQ;AAAA,IACnB;AAAA,IACA;AAAA,IACA,WAAW,QAAQ;AAAA,IACnB,aAAa,QAAQ;AAAA,IACrB;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

package/dist/lib/components/star.d.ts

@@ -0,0 +1,56 @@
+import type { PibblEventFocusOptions, PibblEventHandlers, PibblEventParticipationOptions } from '../events/types.js';
+import type { BoxStyle, CursorStyle, LayoutItemStyle, Length, PaintStyle, RoundedCornerStyle } from '../style/types.js';
+import type { SystemStyle } from '../types.js';
+import type { PibblPhysics2DPropExtension } from '../types.js';
+/**
+ * Authored inputs for Star, including the declared data and presentation options.
+ *
+ * @see {@link PibblEventHandlers}
+ * @see {@link PibblEventParticipationOptions}
+ * @see {@link PibblPhysics2DPropExtension}
+ * @see {@link Star}
+ */
+export interface StarProps extends PibblEventHandlers, PibblEventFocusOptions, PibblEventParticipationOptions, PibblPhysics2DPropExtension {
+}
+/**
+ * Supported geometry and presentation properties for Star.
+ *
+ * @see {@link RoundedCornerStyle}
+ * @see {@link SystemStyle}
+ * @see {@link PaintStyle}
+ * @see {@link CursorStyle}
+ * @see {@link BoxStyle}
+ * @see {@link LayoutItemStyle}
+ * @see {@link Length}
+ * @see {@link Star}
+ */
+export interface StarStyle extends RoundedCornerStyle, SystemStyle, PaintStyle, CursorStyle, BoxStyle, LayoutItemStyle {
+    /** Points defining the geometry or reported by the contact query. See {@link StarStyle}. */
+    points: number;
+    /** Horizontal coordinate of the center. See {@link Length}. */
+    cx?: Exclude<Length, 'auto'>;
+    /** Vertical coordinate of the center. See {@link Length}. */
+    cy?: Exclude<Length, 'auto'>;
+    /** Radius of the outer boundary. See {@link Length}. */
+    outerRadius: Exclude<Length, 'auto'>;
+    /** Radius of the inner boundary. See {@link Length}. */
+    innerRadius: Exclude<Length, 'auto'>;
+    /** Rotation applied to the containing geometry. See {@link StarStyle}. */
+    rotation?: number;
+    /**
+     * Width used for line hit testing independently of the visible stroke width. See
+     * {@link StarStyle}.
+     */
+    lineInteractionWidth?: number;
+}
+/**
+ * Describes a star primitive for JSX or createElement authoring.
+ *
+ * @param props - Authored component inputs, supplied through JSX or createElement. See the linked
+ * props and style types.
+ * @throws When called directly; Pibbl mounts this component through JSX or createElement.
+ *
+ * @see {@link StarProps}
+ * @see {@link StarStyle}
+ */
+export declare const Star: import("@pibbl/core").PibblPrimitiveComponent<StarProps, import("@pibbl/core").PrimitiveInput<StarProps, StarStyle>>;

package/dist/lib/components/star.js

@@ -0,0 +1,98 @@
+import { definePrimitive } from "../define-primitive.js";
+import {
+  resolveStarGeometry
+} from "../geometry/star.js";
+import {
+  integerAtLeast
+} from "../geometry/validation.js";
+import {
+  resolveLocalOffset,
+  stripLayoutParticipation
+} from "../style/resolve-built-in.js";
+import { registerOpaqueStyleProperties } from "../style/resolve-dispatch.js";
+import { renderPath } from "./path.js";
+import { resolveRoundedCornerStyle } from "./rounded-corner-style.js";
+import {
+  circularPercentageBasis,
+  resolveFiniteShapeNumber,
+  resolveNonnegativeShapeLength,
+  shapeGeometryErrorFactory
+} from "./shape-style.js";
+function renderStar(props, style, ctx) {
+  const {
+    points,
+    cx,
+    cy,
+    outerRadius,
+    innerRadius,
+    rotation,
+    cornerRadius,
+    cornerRadii,
+    geometryErrorFactory,
+    ...pathStyle
+  } = style;
+  const geometry = resolveStarGeometry({
+    points,
+    cx,
+    cy,
+    outerRadius,
+    innerRadius,
+    rotation,
+    cornerRadius,
+    cornerRadii
+  }, geometryErrorFactory);
+  return renderPath({
+    ...props,
+    keyboardNavigationBounds: props.keyboardNavigationBounds ?? geometry.bounds
+  }, {
+    ...pathStyle,
+    d: geometry.path
+  }, ctx);
+}
+const Star = definePrimitive(renderStar, {
+  resolveStyle: (style, context) => {
+    const errorFactory = shapeGeometryErrorFactory(context);
+    const points = integerAtLeast(style.points, 3, "points", errorFactory);
+    const basis = circularPercentageBasis(context);
+    return {
+      ...stripLayoutParticipation(style),
+      points,
+      cx: resolveLocalOffset(
+        style.cx,
+        context.percentageBasis.width,
+        "cx",
+        context
+      ),
+      cy: resolveLocalOffset(
+        style.cy,
+        context.percentageBasis.height,
+        "cy",
+        context
+      ),
+      outerRadius: resolveNonnegativeShapeLength(
+        style.outerRadius,
+        basis,
+        "outerRadius",
+        context
+      ),
+      innerRadius: resolveNonnegativeShapeLength(
+        style.innerRadius,
+        basis,
+        "innerRadius",
+        context
+      ),
+      rotation: resolveFiniteShapeNumber(
+        style.rotation ?? -Math.PI / 2,
+        "rotation",
+        context
+      ),
+      ...resolveRoundedCornerStyle(points * 2, style, context),
+      geometryErrorFactory: errorFactory
+    };
+  }
+});
+registerOpaqueStyleProperties(Star, ["fill", "stroke", "cursor"]);
+export {
+  Star
+};
+//# sourceMappingURL=star.js.map

package/dist/lib/components/star.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/components/star.ts"],
+  "sourcesContent": ["import { definePrimitive } from '../define-primitive.js';\nimport type {\n  PibblEventFocusOptions,\n  PibblEventHandlers,\n  PibblEventParticipationOptions,\n} from '../events/types.js';\nimport {\n  resolveStarGeometry,\n  type StarPathOptions,\n} from '../geometry/star.js';\nimport {\n  integerAtLeast,\n  type GeometryErrorFactory,\n} from '../geometry/validation.js';\nimport {\n  resolveLocalOffset,\n  stripLayoutParticipation,\n} from '../style/resolve-built-in.js';\nimport { registerOpaqueStyleProperties } from '../style/resolve-dispatch.js';\nimport type {\n  BoxStyle,\n  CursorStyle,\n  LayoutItemStyle,\n  Length,\n  PaintStyle,\n  RoundedCornerStyle,\n} from '../style/types.js';\nimport type { RenderingContext2D, SystemStyle } from '../types.js';\nimport type { PibblPhysics2DPropExtension } from '../types.js';\nimport { renderPath } from './path.js';\nimport { resolveRoundedCornerStyle } from './rounded-corner-style.js';\nimport {\n  circularPercentageBasis,\n  resolveFiniteShapeNumber,\n  resolveNonnegativeShapeLength,\n  shapeGeometryErrorFactory,\n} from './shape-style.js';\n\n/**\n * Authored inputs for Star, including the declared data and presentation options.\n *\n * @see {@link PibblEventHandlers}\n * @see {@link PibblEventParticipationOptions}\n * @see {@link PibblPhysics2DPropExtension}\n * @see {@link Star}\n */\nexport interface StarProps extends PibblEventHandlers, PibblEventFocusOptions, PibblEventParticipationOptions, PibblPhysics2DPropExtension {}\n\n/**\n * Supported geometry and presentation properties for Star.\n *\n * @see {@link RoundedCornerStyle}\n * @see {@link SystemStyle}\n * @see {@link PaintStyle}\n * @see {@link CursorStyle}\n * @see {@link BoxStyle}\n * @see {@link LayoutItemStyle}\n * @see {@link Length}\n * @see {@link Star}\n */\nexport interface StarStyle\n  extends\n    RoundedCornerStyle,\n    SystemStyle,\n    PaintStyle,\n    CursorStyle,\n    BoxStyle,\n    LayoutItemStyle {\n  /** Points defining the geometry or reported by the contact query. See {@link StarStyle}. */\n  points: number;\n  /** Horizontal coordinate of the center. See {@link Length}. */\n  cx?: Exclude<Length, 'auto'>;\n  /** Vertical coordinate of the center. See {@link Length}. */\n  cy?: Exclude<Length, 'auto'>;\n  /** Radius of the outer boundary. See {@link Length}. */\n  outerRadius: Exclude<Length, 'auto'>;\n  /** Radius of the inner boundary. See {@link Length}. */\n  innerRadius: Exclude<Length, 'auto'>;\n  /** Rotation applied to the containing geometry. See {@link StarStyle}. */\n  rotation?: number;\n  /**\n   * Width used for line hit testing independently of the visible stroke width. See\n   * {@link StarStyle}.\n   */\n  lineInteractionWidth?: number;\n}\n\ninterface ResolvedStarStyle extends SystemStyle, PaintStyle, CursorStyle {\n  points: number;\n  cx: number;\n  cy: number;\n  outerRadius: number;\n  innerRadius: number;\n  rotation: number;\n  cornerRadius?: number;\n  cornerRadii?: readonly (number | null | undefined)[];\n  lineInteractionWidth?: number;\n  geometryErrorFactory: GeometryErrorFactory;\n}\n\nfunction renderStar(\n  props: StarProps,\n  style: Readonly<ResolvedStarStyle>,\n  ctx: RenderingContext2D,\n) {\n  const {\n    points,\n    cx,\n    cy,\n    outerRadius,\n    innerRadius,\n    rotation,\n    cornerRadius,\n    cornerRadii,\n    geometryErrorFactory,\n    ...pathStyle\n  } = style;\n  const geometry = resolveStarGeometry({\n    points,\n    cx,\n    cy,\n    outerRadius,\n    innerRadius,\n    rotation,\n    cornerRadius,\n    cornerRadii,\n  } satisfies StarPathOptions, geometryErrorFactory);\n\n  return renderPath({\n    ...props,\n    keyboardNavigationBounds: props.keyboardNavigationBounds ?? geometry.bounds,\n  }, {\n    ...pathStyle,\n    d: geometry.path,\n  }, ctx);\n}\n\n/**\n * Describes a star primitive for JSX or createElement authoring.\n *\n * @param props - Authored component inputs, supplied through JSX or createElement. See the linked\n * props and style types.\n * @throws When called directly; Pibbl mounts this component through JSX or createElement.\n *\n * @see {@link StarProps}\n * @see {@link StarStyle}\n */\nexport const Star = definePrimitive<\n  StarProps,\n  StarStyle,\n  StarStyle,\n  ResolvedStarStyle\n>(renderStar, {\n  resolveStyle: (style, context) => {\n    const errorFactory = shapeGeometryErrorFactory(context);\n    const points = integerAtLeast(style.points, 3, 'points', errorFactory);\n    const basis = circularPercentageBasis(context);\n    return {\n      ...stripLayoutParticipation(style),\n      points,\n      cx: resolveLocalOffset(\n        style.cx,\n        context.percentageBasis.width,\n        'cx',\n        context,\n      ),\n      cy: resolveLocalOffset(\n        style.cy,\n        context.percentageBasis.height,\n        'cy',\n        context,\n      ),\n      outerRadius: resolveNonnegativeShapeLength(\n        style.outerRadius,\n        basis,\n        'outerRadius',\n        context,\n      ),\n      innerRadius: resolveNonnegativeShapeLength(\n        style.innerRadius,\n        basis,\n        'innerRadius',\n        context,\n      ),\n      rotation: resolveFiniteShapeNumber(\n        style.rotation ?? -Math.PI / 2,\n        'rotation',\n        context,\n      ),\n      ...resolveRoundedCornerStyle(points * 2, style, context),\n      geometryErrorFactory: errorFactory,\n    };\n  },\n});\nregisterOpaqueStyleProperties(Star, ['fill', 'stroke', 'cursor']);\n"],
+  "mappings": "AAAA,SAAS,uBAAuB;AAMhC;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,qCAAqC;AAW9C,SAAS,kBAAkB;AAC3B,SAAS,iCAAiC;AAC1C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAgEP,SAAS,WACP,OACA,OACA,KACA;AACA,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,QAAM,WAAW,oBAAoB;AAAA,IACnC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAA6B,oBAAoB;AAEjD,SAAO,WAAW;AAAA,IAChB,GAAG;AAAA,IACH,0BAA0B,MAAM,4BAA4B,SAAS;AAAA,EACvE,GAAG;AAAA,IACD,GAAG;AAAA,IACH,GAAG,SAAS;AAAA,EACd,GAAG,GAAG;AACR;AAYO,MAAM,OAAO,gBAKlB,YAAY;AAAA,EACZ,cAAc,CAAC,OAAO,YAAY;AAChC,UAAM,eAAe,0BAA0B,OAAO;AACtD,UAAM,SAAS,eAAe,MAAM,QAAQ,GAAG,UAAU,YAAY;AACrE,UAAM,QAAQ,wBAAwB,OAAO;AAC7C,WAAO;AAAA,MACL,GAAG,yBAAyB,KAAK;AAAA,MACjC;AAAA,MACA,IAAI;AAAA,QACF,MAAM;AAAA,QACN,QAAQ,gBAAgB;AAAA,QACxB;AAAA,QACA;AAAA,MACF;AAAA,MACA,IAAI;AAAA,QACF,MAAM;AAAA,QACN,QAAQ,gBAAgB;AAAA,QACxB;AAAA,QACA;AAAA,MACF;AAAA,MACA,aAAa;AAAA,QACX,MAAM;AAAA,QACN;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,MACA,aAAa;AAAA,QACX,MAAM;AAAA,QACN;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,MACA,UAAU;AAAA,QACR,MAAM,YAAY,CAAC,KAAK,KAAK;AAAA,QAC7B;AAAA,QACA;AAAA,MACF;AAAA,MACA,GAAG,0BAA0B,SAAS,GAAG,OAAO,OAAO;AAAA,MACvD,sBAAsB;AAAA,IACxB;AAAA,EACF;AACF,CAAC;AACD,8BAA8B,MAAM,CAAC,QAAQ,UAAU,QAAQ,CAAC;",
+  "names": []
+}

package/dist/lib/components/structural-events.d.ts

@@ -0,0 +1,10 @@
+import type { PibblEventHandlers } from '../events/types.js';
+/**
+ * Event props shared by child-bearing Canvas built-ins.
+ *
+ * @see {@link PibblEventHandlers}
+ */
+export interface PibblStructuralEventProps extends PibblEventHandlers {
+}
+/** Registers a structural ancestor without creating hit-test geometry. */
+export declare function wireStructuralEvents(handlers: PibblEventHandlers): void;

package/dist/lib/components/structural-events.js

@@ -0,0 +1,8 @@
+import { useEventListener } from "../hooks/use-event-listener.js";
+function wireStructuralEvents(handlers) {
+  useEventListener(handlers);
+}
+export {
+  wireStructuralEvents
+};
+//# sourceMappingURL=structural-events.js.map

package/dist/lib/components/structural-events.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/components/structural-events.ts"],
+  "sourcesContent": ["import type { PibblEventHandlers } from '../events/types.js';\nimport { useEventListener } from '../hooks/use-event-listener.js';\n\n/**\n * Event props shared by child-bearing Canvas built-ins.\n *\n * @see {@link PibblEventHandlers}\n */\nexport interface PibblStructuralEventProps extends PibblEventHandlers {}\n\n/** Registers a structural ancestor without creating hit-test geometry. */\nexport function wireStructuralEvents(handlers: PibblEventHandlers): void {\n  useEventListener(handlers);\n}\n"],
+  "mappings": "AACA,SAAS,wBAAwB;AAU1B,SAAS,qBAAqB,UAAoC;AACvE,mBAAiB,QAAQ;AAC3B;",
+  "names": []
+}

package/dist/lib/components/svg-path.d.ts

@@ -0,0 +1,23 @@
+import type { PibblPhysics2DPropExtension } from '../types.js';
+import type { SvgPathStyle } from '../style/types.js';
+import type { PathProps } from './path.js';
+/**
+ * Authored inputs for SvgPath, including the declared data and presentation options.
+ *
+ * @see {@link PathProps}
+ * @see {@link PibblPhysics2DPropExtension}
+ * @see {@link SvgPath}
+ */
+export interface SvgPathProps extends PathProps, PibblPhysics2DPropExtension {
+}
+/**
+ * Describes an SVG-data path primitive for JSX or createElement authoring.
+ *
+ * @param props - Authored component inputs, supplied through JSX or createElement. See the linked
+ * props and style types.
+ * @throws When called directly; Pibbl mounts this component through JSX or createElement.
+ *
+ * @see {@link SvgPathProps}
+ * @see {@link SvgPathStyle}
+ */
+export declare const SvgPath: import("@pibbl/core").PibblPrimitiveComponent<SvgPathProps, import("@pibbl/core").PrimitiveInput<SvgPathProps, SvgPathStyle>>;

package/dist/lib/components/svg-path.js

@@ -0,0 +1,25 @@
+import { definePrimitive } from "../define-primitive.js";
+import { createSvgPath } from "../geometry/svg-path.js";
+import { stripLayoutParticipation } from "../style/resolve-built-in.js";
+import { registerOpaqueStyleProperties } from "../style/resolve-dispatch.js";
+import { renderPath } from "./path.js";
+function renderSvgPath(props, style, ctx) {
+  const { d, ...pathStyle } = style;
+  const svgPath = createSvgPath({ d });
+  return renderPath(
+    props,
+    {
+      ...pathStyle,
+      d: svgPath
+    },
+    ctx
+  );
+}
+const SvgPath = definePrimitive(renderSvgPath, {
+  resolveStyle: (style) => stripLayoutParticipation(style)
+});
+registerOpaqueStyleProperties(SvgPath, ["d", "fill", "stroke", "cursor"]);
+export {
+  SvgPath
+};
+//# sourceMappingURL=svg-path.js.map

package/dist/lib/components/svg-path.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/components/svg-path.ts"],
+  "sourcesContent": ["import { definePrimitive } from '../define-primitive.js';\nimport { createSvgPath } from '../geometry/svg-path.js';\nimport { RenderingContext2D } from '../types.js';\nimport type { PibblPhysics2DPropExtension } from '../types.js';\nimport { stripLayoutParticipation } from '../style/resolve-built-in.js';\nimport { registerOpaqueStyleProperties } from '../style/resolve-dispatch.js';\nimport type { ResolvedSvgPathStyle, SvgPathStyle } from '../style/types.js';\nimport { renderPath } from './path.js';\nimport type { PathProps } from './path.js';\n\n/**\n * Authored inputs for SvgPath, including the declared data and presentation options.\n *\n * @see {@link PathProps}\n * @see {@link PibblPhysics2DPropExtension}\n * @see {@link SvgPath}\n */\nexport interface SvgPathProps extends PathProps, PibblPhysics2DPropExtension {}\n\nfunction renderSvgPath(\n  props: SvgPathProps,\n  style: Readonly<ResolvedSvgPathStyle>,\n  ctx: RenderingContext2D,\n) {\n  const { d, ...pathStyle } = style;\n  const svgPath = createSvgPath({ d });\n  return renderPath(\n    props,\n    {\n      ...pathStyle,\n      d: svgPath,\n    },\n    ctx,\n  );\n}\n\n/**\n * Describes an SVG-data path primitive for JSX or createElement authoring.\n *\n * @param props - Authored component inputs, supplied through JSX or createElement. See the linked\n * props and style types.\n * @throws When called directly; Pibbl mounts this component through JSX or createElement.\n *\n * @see {@link SvgPathProps}\n * @see {@link SvgPathStyle}\n */\nexport const SvgPath = definePrimitive<\n  SvgPathProps,\n  SvgPathStyle,\n  SvgPathStyle,\n  ResolvedSvgPathStyle\n>(renderSvgPath, {\n  resolveStyle: style =>\n    stripLayoutParticipation(style) as ResolvedSvgPathStyle,\n});\nregisterOpaqueStyleProperties(SvgPath, ['d', 'fill', 'stroke', 'cursor']);\n"],
+  "mappings": "AAAA,SAAS,uBAAuB;AAChC,SAAS,qBAAqB;AAG9B,SAAS,gCAAgC;AACzC,SAAS,qCAAqC;AAE9C,SAAS,kBAAkB;AAY3B,SAAS,cACP,OACA,OACA,KACA;AACA,QAAM,EAAE,GAAG,GAAG,UAAU,IAAI;AAC5B,QAAM,UAAU,cAAc,EAAE,EAAE,CAAC;AACnC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,GAAG;AAAA,MACH,GAAG;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;AAYO,MAAM,UAAU,gBAKrB,eAAe;AAAA,EACf,cAAc,WACZ,yBAAyB,KAAK;AAClC,CAAC;AACD,8BAA8B,SAAS,CAAC,KAAK,QAAQ,UAAU,QAAQ,CAAC;",
+  "names": []
+}

package/dist/lib/components/text-layout.d.ts

@@ -0,0 +1,31 @@
+import type { TextStyle } from '../style/types.js';
+type TextLayoutStyle = Omit<TextStyle, 'x' | 'y' | 'width' | 'height'> & {
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+};
+export interface TextBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface TextLayoutLine {
+    text: string;
+    x: number;
+    y: number;
+    bounds: TextBounds;
+    squishWidth?: number;
+}
+export interface TextLayout {
+    lines: readonly TextLayoutLine[];
+    bounds: TextBounds | undefined;
+    clipBounds: TextBounds | undefined;
+}
+export type MeasureText = (text: string) => TextMetrics;
+/** Resolves text line breaking and geometry without rendering or runtime state. */
+export declare function resolveTextLayout(measureText: MeasureText, text: string, style: Readonly<TextLayoutStyle>): TextLayout;
+/** Resolves finite clip geometry, with an optional pure height fallback. */
+export declare function resolveTextClipBounds(style: Readonly<TextLayoutStyle>, fallbackHeight?: number): TextBounds | undefined;
+export {};