@invinite-org/chartlang-adapter-kit 1.2.1 → 1.4.0

package/dist/geometry/_lib/arrowhead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrowhead.js","sourceRoot":"","sources":["../../../src/geometry/_lib/arrowhead.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,iCAAiC;AACjC,+DAA+D;AAC/D,sEAAsE;AACtE,iEAAiE;AACjE,iCAAiC;AAIjC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACjC,MAAM,oBAAoB,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,4BAA4B;AAEtE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAC5B,IAAY,EACZ,EAAU,EACV,OAAe,sBAAsB;IAErC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,IAAI,GAAW;QACjB,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,oBAAoB,CAAC;QACvD,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,oBAAoB,CAAC;KAC1D,CAAC;IACF,MAAM,KAAK,GAAW;QAClB,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,oBAAoB,CAAC;QACvD,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,oBAAoB,CAAC;KAC1D,CAAC;IACF,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n//\n// Arrowhead geometry ported from\n//   invinite/src/components/trading-chart/tools/arrow-tool.ts,\n//   invinite/src/components/trading-chart/tools/arrow-marker-tool.ts,\n//   commit 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite.\n// Re-licensed MIT for chartlang.\n\nimport type { Point2 } from \"../types.js\";\n\nconst DEFAULT_ARROWHEAD_SIZE = 8;\nconst ARROWHEAD_HALF_ANGLE = Math.PI / 6; // 30° each side → 60° total\n\n/**\n * Return the three vertices of a filled isoceles-triangle arrowhead at\n * `to` pointing along the `from → to` direction. The order is\n * `[tip, leftWing, rightWing]` so a caller paints a closed polyline\n * `moveTo(tip) → lineTo(left) → lineTo(right) → close`. Pure — no `ctx`.\n *\n * `size` defaults to 8 CSS px (the wing length).\n *\n * @since 1.3\n * @stable\n * @example\n *     const tri = arrowheadPolygon({ x: 0, y: 0 }, { x: 100, y: 0 });\n *     // tri[0] === { x: 100, y: 0 } (tip)\n *     void tri;\n */\nexport function arrowheadPolygon(\n    from: Point2,\n    to: Point2,\n    size: number = DEFAULT_ARROWHEAD_SIZE,\n): ReadonlyArray<Point2> {\n    const angle = Math.atan2(to.y - from.y, to.x - from.x);\n    const left: Point2 = {\n        x: to.x - size * Math.cos(angle - ARROWHEAD_HALF_ANGLE),\n        y: to.y - size * Math.sin(angle - ARROWHEAD_HALF_ANGLE),\n    };\n    const right: Point2 = {\n        x: to.x - size * Math.cos(angle + ARROWHEAD_HALF_ANGLE),\n        y: to.y - size * Math.sin(angle + ARROWHEAD_HALF_ANGLE),\n    };\n    return [to, left, right];\n}\n"]}

package/dist/geometry/_lib/bezier.d.ts

@@ -0,0 +1,57 @@
+import type { Point2 } from "../types.js";
+/**
+ * Evaluate a quadratic Bezier curve at parameter `t ∈ [0, 1]`. The
+ * curve interpolates `p0` (at `t = 0`) and `p2` (at `t = 1`) with `p1`
+ * as the off-curve control point. Endpoints are float-exact:
+ * `quadraticBezier(p0, p1, p2, 0) === p0` and `… 1) === p2`.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const mid = quadraticBezier({ x: 0, y: 0 }, { x: 1, y: 2 }, { x: 2, y: 0 }, 0.5);
+ *     // mid.x === 1; mid.y === 1
+ *     void mid;
+ */
+export declare function quadraticBezier(p0: Point2, p1: Point2, p2: Point2, t: number): Point2;
+/**
+ * Evaluate a cubic Bezier curve at parameter `t ∈ [0, 1]`. The curve
+ * interpolates `p0` (at `t = 0`) and `p3` (at `t = 1`) with `p1` and
+ * `p2` as the two off-curve control points. Endpoints are float-exact.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const start = cubicBezier(
+ *         { x: 0, y: 0 }, { x: 1, y: 3 }, { x: 2, y: 3 }, { x: 3, y: 0 }, 0,
+ *     );
+ *     // start === { x: 0, y: 0 }
+ *     void start;
+ */
+export declare function cubicBezier(p0: Point2, p1: Point2, p2: Point2, p3: Point2, t: number): Point2;
+/**
+ * Sample a quadratic Bezier into `samples + 1` points evenly spaced in
+ * parameter `t ∈ [0, 1]`. The first sample is `p0`, the last is `p2`.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const pts = sampleQuadratic({ x: 0, y: 0 }, { x: 1, y: 2 }, { x: 2, y: 0 }, 4);
+ *     // pts.length === 5; pts[0] === { x: 0, y: 0 }; pts[4] === { x: 2, y: 0 }
+ *     void pts;
+ */
+export declare function sampleQuadratic(p0: Point2, p1: Point2, p2: Point2, samples: number): ReadonlyArray<Point2>;
+/**
+ * Sample a cubic Bezier into `samples + 1` points evenly spaced in
+ * parameter `t ∈ [0, 1]`. Mirrors {@link sampleQuadratic}.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const pts = sampleCubic(
+ *         { x: 0, y: 0 }, { x: 1, y: 3 }, { x: 2, y: 3 }, { x: 3, y: 0 }, 8,
+ *     );
+ *     // pts.length === 9; pts[0] === { x: 0, y: 0 }; pts[8] === { x: 3, y: 0 }
+ *     void pts;
+ */
+export declare function sampleCubic(p0: Point2, p1: Point2, p2: Point2, p3: Point2, samples: number): ReadonlyArray<Point2>;
+//# sourceMappingURL=bezier.d.ts.map

package/dist/geometry/_lib/bezier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bezier.d.ts","sourceRoot":"","sources":["../../../src/geometry/_lib/bezier.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAMrF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ7F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC3B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,GAChB,aAAa,CAAC,MAAM,CAAC,CAMvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACvB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,GAChB,aAAa,CAAC,MAAM,CAAC,CAMvB"}

package/dist/geometry/_lib/bezier.js

@@ -0,0 +1,84 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Evaluate a quadratic Bezier curve at parameter `t ∈ [0, 1]`. The
+ * curve interpolates `p0` (at `t = 0`) and `p2` (at `t = 1`) with `p1`
+ * as the off-curve control point. Endpoints are float-exact:
+ * `quadraticBezier(p0, p1, p2, 0) === p0` and `… 1) === p2`.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const mid = quadraticBezier({ x: 0, y: 0 }, { x: 1, y: 2 }, { x: 2, y: 0 }, 0.5);
+ *     // mid.x === 1; mid.y === 1
+ *     void mid;
+ */
+export function quadraticBezier(p0, p1, p2, t) {
+    const u = 1 - t;
+    return {
+        x: u * u * p0.x + 2 * u * t * p1.x + t * t * p2.x,
+        y: u * u * p0.y + 2 * u * t * p1.y + t * t * p2.y,
+    };
+}
+/**
+ * Evaluate a cubic Bezier curve at parameter `t ∈ [0, 1]`. The curve
+ * interpolates `p0` (at `t = 0`) and `p3` (at `t = 1`) with `p1` and
+ * `p2` as the two off-curve control points. Endpoints are float-exact.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const start = cubicBezier(
+ *         { x: 0, y: 0 }, { x: 1, y: 3 }, { x: 2, y: 3 }, { x: 3, y: 0 }, 0,
+ *     );
+ *     // start === { x: 0, y: 0 }
+ *     void start;
+ */
+export function cubicBezier(p0, p1, p2, p3, t) {
+    const u = 1 - t;
+    const uu = u * u;
+    const tt = t * t;
+    return {
+        x: uu * u * p0.x + 3 * uu * t * p1.x + 3 * u * tt * p2.x + tt * t * p3.x,
+        y: uu * u * p0.y + 3 * uu * t * p1.y + 3 * u * tt * p2.y + tt * t * p3.y,
+    };
+}
+/**
+ * Sample a quadratic Bezier into `samples + 1` points evenly spaced in
+ * parameter `t ∈ [0, 1]`. The first sample is `p0`, the last is `p2`.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const pts = sampleQuadratic({ x: 0, y: 0 }, { x: 1, y: 2 }, { x: 2, y: 0 }, 4);
+ *     // pts.length === 5; pts[0] === { x: 0, y: 0 }; pts[4] === { x: 2, y: 0 }
+ *     void pts;
+ */
+export function sampleQuadratic(p0, p1, p2, samples) {
+    const out = [];
+    for (let i = 0; i <= samples; i++) {
+        out.push(quadraticBezier(p0, p1, p2, i / samples));
+    }
+    return out;
+}
+/**
+ * Sample a cubic Bezier into `samples + 1` points evenly spaced in
+ * parameter `t ∈ [0, 1]`. Mirrors {@link sampleQuadratic}.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const pts = sampleCubic(
+ *         { x: 0, y: 0 }, { x: 1, y: 3 }, { x: 2, y: 3 }, { x: 3, y: 0 }, 8,
+ *     );
+ *     // pts.length === 9; pts[0] === { x: 0, y: 0 }; pts[8] === { x: 3, y: 0 }
+ *     void pts;
+ */
+export function sampleCubic(p0, p1, p2, p3, samples) {
+    const out = [];
+    for (let i = 0; i <= samples; i++) {
+        out.push(cubicBezier(p0, p1, p2, p3, i / samples));
+    }
+    return out;
+}
+//# sourceMappingURL=bezier.js.map

package/dist/geometry/_lib/bezier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bezier.js","sourceRoot":"","sources":["../../../src/geometry/_lib/bezier.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,CAAS;IACzE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO;QACH,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QACjD,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;KACpD,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,CAAS;IACjF,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,OAAO;QACH,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QACxE,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;KAC3E,CAAC;AACN,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC3B,EAAU,EACV,EAAU,EACV,EAAU,EACV,OAAe;IAEf,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CACvB,EAAU,EACV,EAAU,EACV,EAAU,EACV,EAAU,EACV,OAAe;IAEf,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { Point2 } from \"../types.js\";\n\n/**\n * Evaluate a quadratic Bezier curve at parameter `t ∈ [0, 1]`. The\n * curve interpolates `p0` (at `t = 0`) and `p2` (at `t = 1`) with `p1`\n * as the off-curve control point. Endpoints are float-exact:\n * `quadraticBezier(p0, p1, p2, 0) === p0` and `… 1) === p2`.\n *\n * @since 1.3\n * @stable\n * @example\n *     const mid = quadraticBezier({ x: 0, y: 0 }, { x: 1, y: 2 }, { x: 2, y: 0 }, 0.5);\n *     // mid.x === 1; mid.y === 1\n *     void mid;\n */\nexport function quadraticBezier(p0: Point2, p1: Point2, p2: Point2, t: number): Point2 {\n    const u = 1 - t;\n    return {\n        x: u * u * p0.x + 2 * u * t * p1.x + t * t * p2.x,\n        y: u * u * p0.y + 2 * u * t * p1.y + t * t * p2.y,\n    };\n}\n\n/**\n * Evaluate a cubic Bezier curve at parameter `t ∈ [0, 1]`. The curve\n * interpolates `p0` (at `t = 0`) and `p3` (at `t = 1`) with `p1` and\n * `p2` as the two off-curve control points. Endpoints are float-exact.\n *\n * @since 1.3\n * @stable\n * @example\n *     const start = cubicBezier(\n *         { x: 0, y: 0 }, { x: 1, y: 3 }, { x: 2, y: 3 }, { x: 3, y: 0 }, 0,\n *     );\n *     // start === { x: 0, y: 0 }\n *     void start;\n */\nexport function cubicBezier(p0: Point2, p1: Point2, p2: Point2, p3: Point2, t: number): Point2 {\n    const u = 1 - t;\n    const uu = u * u;\n    const tt = t * t;\n    return {\n        x: uu * u * p0.x + 3 * uu * t * p1.x + 3 * u * tt * p2.x + tt * t * p3.x,\n        y: uu * u * p0.y + 3 * uu * t * p1.y + 3 * u * tt * p2.y + tt * t * p3.y,\n    };\n}\n\n/**\n * Sample a quadratic Bezier into `samples + 1` points evenly spaced in\n * parameter `t ∈ [0, 1]`. The first sample is `p0`, the last is `p2`.\n *\n * @since 1.3\n * @stable\n * @example\n *     const pts = sampleQuadratic({ x: 0, y: 0 }, { x: 1, y: 2 }, { x: 2, y: 0 }, 4);\n *     // pts.length === 5; pts[0] === { x: 0, y: 0 }; pts[4] === { x: 2, y: 0 }\n *     void pts;\n */\nexport function sampleQuadratic(\n    p0: Point2,\n    p1: Point2,\n    p2: Point2,\n    samples: number,\n): ReadonlyArray<Point2> {\n    const out: Point2[] = [];\n    for (let i = 0; i <= samples; i++) {\n        out.push(quadraticBezier(p0, p1, p2, i / samples));\n    }\n    return out;\n}\n\n/**\n * Sample a cubic Bezier into `samples + 1` points evenly spaced in\n * parameter `t ∈ [0, 1]`. Mirrors {@link sampleQuadratic}.\n *\n * @since 1.3\n * @stable\n * @example\n *     const pts = sampleCubic(\n *         { x: 0, y: 0 }, { x: 1, y: 3 }, { x: 2, y: 3 }, { x: 3, y: 0 }, 8,\n *     );\n *     // pts.length === 9; pts[0] === { x: 0, y: 0 }; pts[8] === { x: 3, y: 0 }\n *     void pts;\n */\nexport function sampleCubic(\n    p0: Point2,\n    p1: Point2,\n    p2: Point2,\n    p3: Point2,\n    samples: number,\n): ReadonlyArray<Point2> {\n    const out: Point2[] = [];\n    for (let i = 0; i <= samples; i++) {\n        out.push(cubicBezier(p0, p1, p2, p3, i / samples));\n    }\n    return out;\n}\n"]}

package/dist/geometry/_lib/chevron.d.ts

@@ -0,0 +1,29 @@
+import type { Point2 } from "../types.js";
+/**
+ * Vertical direction of a chevron glyph. `"up"` puts the tip above the
+ * anchor (smaller y); `"down"` puts the tip below (larger y).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const d: ChevronDirection = "up";
+ *     void d;
+ */
+export type ChevronDirection = "up" | "down";
+/**
+ * Return the three vertices of a filled triangle chevron glyph centred
+ * on `at`, pointing up or down. The order is `[tip, baseLeft,
+ * baseRight]` so a caller paints a closed polyline. Pure — no `ctx`.
+ * Consumed by the `arrow-mark-up` / `arrow-mark-down` decomposers.
+ *
+ * `baseWidth` defaults to 12 CSS px, `height` to 10 CSS px.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const tri = chevronPolygon({ x: 100, y: 100 }, "up");
+ *     // tri[0].y === 95 (tip is half the height above the anchor)
+ *     void tri;
+ */
+export declare function chevronPolygon(at: Point2, direction: ChevronDirection, baseWidth?: number, height?: number): ReadonlyArray<Point2>;
+//# sourceMappingURL=chevron.d.ts.map

package/dist/geometry/_lib/chevron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chevron.d.ts","sourceRoot":"","sources":["../../../src/geometry/_lib/chevron.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAK1C;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,MAAM,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC1B,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,gBAAgB,EAC3B,SAAS,GAAE,MAA2B,EACtC,MAAM,GAAE,MAAuB,GAChC,aAAa,CAAC,MAAM,CAAC,CAUvB"}

package/dist/geometry/_lib/chevron.js

@@ -0,0 +1,37 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// Chevron glyph geometry ported from
+//   invinite/src/components/trading-chart/tools/arrow-mark-up-tool.ts,
+//   invinite/src/components/trading-chart/tools/arrow-mark-down-tool.ts,
+//   commit 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite.
+// Re-licensed MIT for chartlang.
+const DEFAULT_BASE_WIDTH = 12;
+const DEFAULT_HEIGHT = 10;
+/**
+ * Return the three vertices of a filled triangle chevron glyph centred
+ * on `at`, pointing up or down. The order is `[tip, baseLeft,
+ * baseRight]` so a caller paints a closed polyline. Pure — no `ctx`.
+ * Consumed by the `arrow-mark-up` / `arrow-mark-down` decomposers.
+ *
+ * `baseWidth` defaults to 12 CSS px, `height` to 10 CSS px.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const tri = chevronPolygon({ x: 100, y: 100 }, "up");
+ *     // tri[0].y === 95 (tip is half the height above the anchor)
+ *     void tri;
+ */
+export function chevronPolygon(at, direction, baseWidth = DEFAULT_BASE_WIDTH, height = DEFAULT_HEIGHT) {
+    const halfWidth = baseWidth / 2;
+    const halfHeight = height / 2;
+    const tipY = direction === "up" ? at.y - halfHeight : at.y + halfHeight;
+    const baseY = direction === "up" ? at.y + halfHeight : at.y - halfHeight;
+    return [
+        { x: at.x, y: tipY },
+        { x: at.x - halfWidth, y: baseY },
+        { x: at.x + halfWidth, y: baseY },
+    ];
+}
+//# sourceMappingURL=chevron.js.map

package/dist/geometry/_lib/chevron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chevron.js","sourceRoot":"","sources":["../../../src/geometry/_lib/chevron.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,qCAAqC;AACrC,uEAAuE;AACvE,yEAAyE;AACzE,iEAAiE;AACjE,iCAAiC;AAIjC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,cAAc,GAAG,EAAE,CAAC;AAc1B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAC1B,EAAU,EACV,SAA2B,EAC3B,YAAoB,kBAAkB,EACtC,SAAiB,cAAc;IAE/B,MAAM,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC;IACxE,MAAM,KAAK,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC;IACzE,OAAO;QACH,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE;QACpB,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE;QACjC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE;KACpC,CAAC;AACN,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n//\n// Chevron glyph geometry ported from\n//   invinite/src/components/trading-chart/tools/arrow-mark-up-tool.ts,\n//   invinite/src/components/trading-chart/tools/arrow-mark-down-tool.ts,\n//   commit 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite.\n// Re-licensed MIT for chartlang.\n\nimport type { Point2 } from \"../types.js\";\n\nconst DEFAULT_BASE_WIDTH = 12;\nconst DEFAULT_HEIGHT = 10;\n\n/**\n * Vertical direction of a chevron glyph. `\"up\"` puts the tip above the\n * anchor (smaller y); `\"down\"` puts the tip below (larger y).\n *\n * @since 1.3\n * @stable\n * @example\n *     const d: ChevronDirection = \"up\";\n *     void d;\n */\nexport type ChevronDirection = \"up\" | \"down\";\n\n/**\n * Return the three vertices of a filled triangle chevron glyph centred\n * on `at`, pointing up or down. The order is `[tip, baseLeft,\n * baseRight]` so a caller paints a closed polyline. Pure — no `ctx`.\n * Consumed by the `arrow-mark-up` / `arrow-mark-down` decomposers.\n *\n * `baseWidth` defaults to 12 CSS px, `height` to 10 CSS px.\n *\n * @since 1.3\n * @stable\n * @example\n *     const tri = chevronPolygon({ x: 100, y: 100 }, \"up\");\n *     // tri[0].y === 95 (tip is half the height above the anchor)\n *     void tri;\n */\nexport function chevronPolygon(\n    at: Point2,\n    direction: ChevronDirection,\n    baseWidth: number = DEFAULT_BASE_WIDTH,\n    height: number = DEFAULT_HEIGHT,\n): ReadonlyArray<Point2> {\n    const halfWidth = baseWidth / 2;\n    const halfHeight = height / 2;\n    const tipY = direction === \"up\" ? at.y - halfHeight : at.y + halfHeight;\n    const baseY = direction === \"up\" ? at.y + halfHeight : at.y - halfHeight;\n    return [\n        { x: at.x, y: tipY },\n        { x: at.x - halfWidth, y: baseY },\n        { x: at.x + halfWidth, y: baseY },\n    ];\n}\n"]}

package/dist/geometry/_lib/dash.d.ts

@@ -0,0 +1,30 @@
+import type { LineStyle } from "@invinite-org/chartlang-core";
+/**
+ * Canonical `setLineDash` segment array for each {@link LineStyle}.
+ * Copied (not moved) from the canvas2d adapter's `render/lineDash.ts`,
+ * which still serves the surviving plot renderers there. Decomposers
+ * map a `LineStyle` to a `StrokeStyle.dash` through this helper.
+ *
+ * `"solid"` → `[]`, `"dashed"` → `[6, 4]`, `"dotted"` → `[2, 4]`.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const d = dashPattern("dashed"); // [6, 4]
+ *     void d;
+ */
+export declare function dashPattern(style: LineStyle): ReadonlyArray<number>;
+/**
+ * The `setLineDash` segment array for a solid stroke — an empty array.
+ * Shared by the decomposers that emit always-solid primitives (fib
+ * arcs, gann/pitchfork rays, container borders) so the `"solid"` dash
+ * constant lives in one place instead of a per-file re-declaration.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const d = SOLID_DASH; // []
+ *     void d;
+ */
+export declare const SOLID_DASH: ReadonlyArray<number>;
+//# sourceMappingURL=dash.d.ts.map

package/dist/geometry/_lib/dash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dash.d.ts","sourceRoot":"","sources":["../../../src/geometry/_lib/dash.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CASnE;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,MAAM,CAAM,CAAC"}

package/dist/geometry/_lib/dash.js

@@ -0,0 +1,40 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Canonical `setLineDash` segment array for each {@link LineStyle}.
+ * Copied (not moved) from the canvas2d adapter's `render/lineDash.ts`,
+ * which still serves the surviving plot renderers there. Decomposers
+ * map a `LineStyle` to a `StrokeStyle.dash` through this helper.
+ *
+ * `"solid"` → `[]`, `"dashed"` → `[6, 4]`, `"dotted"` → `[2, 4]`.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const d = dashPattern("dashed"); // [6, 4]
+ *     void d;
+ */
+export function dashPattern(style) {
+    switch (style) {
+        case "solid":
+            return [];
+        case "dashed":
+            return [6, 4];
+        case "dotted":
+            return [2, 4];
+    }
+}
+/**
+ * The `setLineDash` segment array for a solid stroke — an empty array.
+ * Shared by the decomposers that emit always-solid primitives (fib
+ * arcs, gann/pitchfork rays, container borders) so the `"solid"` dash
+ * constant lives in one place instead of a per-file re-declaration.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const d = SOLID_DASH; // []
+ *     void d;
+ */
+export const SOLID_DASH = [];
+//# sourceMappingURL=dash.js.map

package/dist/geometry/_lib/dash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dash.js","sourceRoot":"","sources":["../../../src/geometry/_lib/dash.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB;IACxC,QAAQ,KAAK,EAAE,CAAC;QACZ,KAAK,OAAO;YACR,OAAO,EAAE,CAAC;QACd,KAAK,QAAQ;YACT,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClB,KAAK,QAAQ;YACT,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtB,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,UAAU,GAA0B,EAAE,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { LineStyle } from \"@invinite-org/chartlang-core\";\n\n/**\n * Canonical `setLineDash` segment array for each {@link LineStyle}.\n * Copied (not moved) from the canvas2d adapter's `render/lineDash.ts`,\n * which still serves the surviving plot renderers there. Decomposers\n * map a `LineStyle` to a `StrokeStyle.dash` through this helper.\n *\n * `\"solid\"` → `[]`, `\"dashed\"` → `[6, 4]`, `\"dotted\"` → `[2, 4]`.\n *\n * @since 1.3\n * @stable\n * @example\n *     const d = dashPattern(\"dashed\"); // [6, 4]\n *     void d;\n */\nexport function dashPattern(style: LineStyle): ReadonlyArray<number> {\n    switch (style) {\n        case \"solid\":\n            return [];\n        case \"dashed\":\n            return [6, 4];\n        case \"dotted\":\n            return [2, 4];\n    }\n}\n\n/**\n * The `setLineDash` segment array for a solid stroke — an empty array.\n * Shared by the decomposers that emit always-solid primitives (fib\n * arcs, gann/pitchfork rays, container borders) so the `\"solid\"` dash\n * constant lives in one place instead of a per-file re-declaration.\n *\n * @since 1.3\n * @stable\n * @example\n *     const d = SOLID_DASH; // []\n *     void d;\n */\nexport const SOLID_DASH: ReadonlyArray<number> = [];\n"]}

package/dist/geometry/_lib/fibLevels.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Canonical Fibonacci level ratios shared by every fib decomposer
+ * (`fibRetracement`, `fibTrendExtension`, `fibChannel`, `fibSpeedFan`,
+ * `fibSpeedArcs`, …). Frozen so per-kind decomposers cannot accidentally
+ * mutate the shared array. Source: invinite's
+ * `src/components/trading-chart/tools/fib-*` tools.
+ *
+ * Order is monotonic. Both the 0 and 1 endpoints are included so a
+ * retracement decomposer that needs the bracket lines (the 0% and 100%
+ * anchor levels) doesn't have to splice them in.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     for (const level of FIB_LEVELS) {
+ *         // Stroke a horizontal line at `from.price + level * (to.price - from.price)`.
+ *         void level;
+ *     }
+ */
+export declare const FIB_LEVELS: ReadonlyArray<number>;
+/**
+ * Format a Fibonacci ratio for display alongside its level line.
+ * Integer ratios (`0`, `1`, `2`) render with one decimal place (`"0.0"`,
+ * `"1.0"`, `"2.0"`); fractional ratios render with three (`"0.236"`,
+ * `"0.618"`, `"1.272"`). Matches the Pine-style label convention used
+ * by the invinite fib tools.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     formatLevel(0);     // "0.0"
+ *     formatLevel(0.618); // "0.618"
+ *     formatLevel(1.272); // "1.272"
+ */
+export declare function formatLevel(level: number): string;
+//# sourceMappingURL=fibLevels.d.ts.map

package/dist/geometry/_lib/fibLevels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fibLevels.d.ts","sourceRoot":"","sources":["../../../src/geometry/_lib/fibLevels.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,MAAM,CAI3C,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/geometry/_lib/fibLevels.js

@@ -0,0 +1,44 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Canonical Fibonacci level ratios shared by every fib decomposer
+ * (`fibRetracement`, `fibTrendExtension`, `fibChannel`, `fibSpeedFan`,
+ * `fibSpeedArcs`, …). Frozen so per-kind decomposers cannot accidentally
+ * mutate the shared array. Source: invinite's
+ * `src/components/trading-chart/tools/fib-*` tools.
+ *
+ * Order is monotonic. Both the 0 and 1 endpoints are included so a
+ * retracement decomposer that needs the bracket lines (the 0% and 100%
+ * anchor levels) doesn't have to splice them in.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     for (const level of FIB_LEVELS) {
+ *         // Stroke a horizontal line at `from.price + level * (to.price - from.price)`.
+ *         void level;
+ *     }
+ */
+export const FIB_LEVELS = Object.freeze([
+    0, 0.236, 0.382, 0.5, 0.618, 0.786, 1, 1.272,
+    // biome-ignore lint/suspicious/noApproximativeNumericConstant: canonical fib ratio, not √2.
+    1.414, 1.618, 2.0, 2.618, 4.236,
+]);
+/**
+ * Format a Fibonacci ratio for display alongside its level line.
+ * Integer ratios (`0`, `1`, `2`) render with one decimal place (`"0.0"`,
+ * `"1.0"`, `"2.0"`); fractional ratios render with three (`"0.236"`,
+ * `"0.618"`, `"1.272"`). Matches the Pine-style label convention used
+ * by the invinite fib tools.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     formatLevel(0);     // "0.0"
+ *     formatLevel(0.618); // "0.618"
+ *     formatLevel(1.272); // "1.272"
+ */
+export function formatLevel(level) {
+    return level === Math.floor(level) ? level.toFixed(1) : level.toFixed(3);
+}
+//# sourceMappingURL=fibLevels.js.map

package/dist/geometry/_lib/fibLevels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fibLevels.js","sourceRoot":"","sources":["../../../src/geometry/_lib/fibLevels.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,UAAU,GAA0B,MAAM,CAAC,MAAM,CAAC;IAC3D,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK;IAC5C,4FAA4F;IAC5F,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK;CAClC,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACrC,OAAO,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC7E,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\n/**\n * Canonical Fibonacci level ratios shared by every fib decomposer\n * (`fibRetracement`, `fibTrendExtension`, `fibChannel`, `fibSpeedFan`,\n * `fibSpeedArcs`, …). Frozen so per-kind decomposers cannot accidentally\n * mutate the shared array. Source: invinite's\n * `src/components/trading-chart/tools/fib-*` tools.\n *\n * Order is monotonic. Both the 0 and 1 endpoints are included so a\n * retracement decomposer that needs the bracket lines (the 0% and 100%\n * anchor levels) doesn't have to splice them in.\n *\n * @since 1.3\n * @stable\n * @example\n *     for (const level of FIB_LEVELS) {\n *         // Stroke a horizontal line at `from.price + level * (to.price - from.price)`.\n *         void level;\n *     }\n */\nexport const FIB_LEVELS: ReadonlyArray<number> = Object.freeze([\n    0, 0.236, 0.382, 0.5, 0.618, 0.786, 1, 1.272,\n    // biome-ignore lint/suspicious/noApproximativeNumericConstant: canonical fib ratio, not √2.\n    1.414, 1.618, 2.0, 2.618, 4.236,\n]);\n\n/**\n * Format a Fibonacci ratio for display alongside its level line.\n * Integer ratios (`0`, `1`, `2`) render with one decimal place (`\"0.0\"`,\n * `\"1.0\"`, `\"2.0\"`); fractional ratios render with three (`\"0.236\"`,\n * `\"0.618\"`, `\"1.272\"`). Matches the Pine-style label convention used\n * by the invinite fib tools.\n *\n * @since 1.3\n * @stable\n * @example\n *     formatLevel(0);     // \"0.0\"\n *     formatLevel(0.618); // \"0.618\"\n *     formatLevel(1.272); // \"1.272\"\n */\nexport function formatLevel(level: number): string {\n    return level === Math.floor(level) ? level.toFixed(1) : level.toFixed(3);\n}\n"]}

package/dist/geometry/_lib/gannLevels.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Canonical Gann box subdivision ratios. Each box decomposer emits one
+ * horizontal + one vertical stroke at each ratio (including 0 and 1.0
+ * for the outer rectangle). The 1/4 subdivisions match the upstream
+ * invinite default and are the pinned Phase-3 wire shape.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     import { GANN_LEVELS } from "./gannLevels.js";
+ *     for (const level of GANN_LEVELS) void level;
+ */
+export declare const GANN_LEVELS: ReadonlyArray<number>;
+/**
+ * Canonical Gann fan slope ratios. Each entry is the slope multiplier
+ * applied to the (a→b) direction vector — the 1×1 ray points at b, 1×2
+ * doubles the slope, 2×1 halves it, etc. The 9-entry tuple matches the
+ * upstream invinite default `FibGannLevel` set.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     import { GANN_FAN_RATIOS } from "./gannLevels.js";
+ *     for (const r of GANN_FAN_RATIOS) void r;
+ */
+export declare const GANN_FAN_RATIOS: ReadonlyArray<number>;
+/**
+ * Human-readable label for each {@link GANN_FAN_RATIOS} entry. Order
+ * matches the ratios array so a decomposer can co-index them. Ratios
+ * greater than 1 render as `"1x<n>"`; ratios less than 1 render as
+ * `"<n>x1"`; 1×1 is the identity.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     import { GANN_FAN_LABELS } from "./gannLevels.js";
+ *     for (const label of GANN_FAN_LABELS) void label;
+ */
+export declare const GANN_FAN_LABELS: ReadonlyArray<string>;
+/**
+ * Map a fan ratio to its kebab label. Ratios `>= 1` render as
+ * `"1x<n>"`; ratios `< 1` render as `"<n>x1"` where `n = round(1 /
+ * ratio)`. Used when fan labels are enabled.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     import { formatGannRatio } from "./gannLevels.js";
+ *     formatGannRatio(1); // "1x1"
+ *     formatGannRatio(2); // "1x2"
+ *     formatGannRatio(0.5); // "2x1"
+ */
+export declare function formatGannRatio(ratio: number): string;
+//# sourceMappingURL=gannLevels.d.ts.map

package/dist/geometry/_lib/gannLevels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gannLevels.d.ts","sourceRoot":"","sources":["../../../src/geometry/_lib/gannLevels.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,MAAM,CAA0C,CAAC;AAEzF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,MAAM,CAUhD,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,MAAM,CAUhD,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/geometry/_lib/gannLevels.js

@@ -0,0 +1,88 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// Gann box subdivision + fan-slope tables moved verbatim from the
+// canvas2d adapter's renderer helper
+//   examples/canvas2d-adapter/src/render/draw/gannLevels.ts.
+// The originating subdivision + slope conventions are invinite's
+// gann-box / gann-fan tools (commit
+// 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite); re-licensed
+// MIT for chartlang.
+/**
+ * Canonical Gann box subdivision ratios. Each box decomposer emits one
+ * horizontal + one vertical stroke at each ratio (including 0 and 1.0
+ * for the outer rectangle). The 1/4 subdivisions match the upstream
+ * invinite default and are the pinned Phase-3 wire shape.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     import { GANN_LEVELS } from "./gannLevels.js";
+ *     for (const level of GANN_LEVELS) void level;
+ */
+export const GANN_LEVELS = Object.freeze([0, 0.25, 0.5, 0.75, 1]);
+/**
+ * Canonical Gann fan slope ratios. Each entry is the slope multiplier
+ * applied to the (a→b) direction vector — the 1×1 ray points at b, 1×2
+ * doubles the slope, 2×1 halves it, etc. The 9-entry tuple matches the
+ * upstream invinite default `FibGannLevel` set.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     import { GANN_FAN_RATIOS } from "./gannLevels.js";
+ *     for (const r of GANN_FAN_RATIOS) void r;
+ */
+export const GANN_FAN_RATIOS = Object.freeze([
+    1,
+    2,
+    3,
+    0.5,
+    1 / 3,
+    4,
+    0.25,
+    8,
+    0.125,
+]);
+/**
+ * Human-readable label for each {@link GANN_FAN_RATIOS} entry. Order
+ * matches the ratios array so a decomposer can co-index them. Ratios
+ * greater than 1 render as `"1x<n>"`; ratios less than 1 render as
+ * `"<n>x1"`; 1×1 is the identity.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     import { GANN_FAN_LABELS } from "./gannLevels.js";
+ *     for (const label of GANN_FAN_LABELS) void label;
+ */
+export const GANN_FAN_LABELS = Object.freeze([
+    "1x1",
+    "1x2",
+    "1x3",
+    "2x1",
+    "3x1",
+    "1x4",
+    "4x1",
+    "1x8",
+    "8x1",
+]);
+/**
+ * Map a fan ratio to its kebab label. Ratios `>= 1` render as
+ * `"1x<n>"`; ratios `< 1` render as `"<n>x1"` where `n = round(1 /
+ * ratio)`. Used when fan labels are enabled.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     import { formatGannRatio } from "./gannLevels.js";
+ *     formatGannRatio(1); // "1x1"
+ *     formatGannRatio(2); // "1x2"
+ *     formatGannRatio(0.5); // "2x1"
+ */
+export function formatGannRatio(ratio) {
+    if (ratio >= 1)
+        return `1x${Math.round(ratio)}`;
+    return `${Math.round(1 / ratio)}x1`;
+}
+//# sourceMappingURL=gannLevels.js.map

package/dist/geometry/_lib/gannLevels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gannLevels.js","sourceRoot":"","sources":["../../../src/geometry/_lib/gannLevels.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,kEAAkE;AAClE,qCAAqC;AACrC,6DAA6D;AAC7D,iEAAiE;AACjE,oCAAoC;AACpC,qEAAqE;AACrE,qBAAqB;AAErB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,WAAW,GAA0B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAEzF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAA0B,MAAM,CAAC,MAAM,CAAC;IAChE,CAAC;IACD,CAAC;IACD,CAAC;IACD,GAAG;IACH,CAAC,GAAG,CAAC;IACL,CAAC;IACD,IAAI;IACJ,CAAC;IACD,KAAK;CACR,CAAC,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAA0B,MAAM,CAAC,MAAM,CAAC;IAChE,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACR,CAAC,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IACzC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IAChD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;AACxC,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n//\n// Gann box subdivision + fan-slope tables moved verbatim from the\n// canvas2d adapter's renderer helper\n//   examples/canvas2d-adapter/src/render/draw/gannLevels.ts.\n// The originating subdivision + slope conventions are invinite's\n// gann-box / gann-fan tools (commit\n// 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite); re-licensed\n// MIT for chartlang.\n\n/**\n * Canonical Gann box subdivision ratios. Each box decomposer emits one\n * horizontal + one vertical stroke at each ratio (including 0 and 1.0\n * for the outer rectangle). The 1/4 subdivisions match the upstream\n * invinite default and are the pinned Phase-3 wire shape.\n *\n * @since 1.3\n * @stable\n * @example\n *     import { GANN_LEVELS } from \"./gannLevels.js\";\n *     for (const level of GANN_LEVELS) void level;\n */\nexport const GANN_LEVELS: ReadonlyArray<number> = Object.freeze([0, 0.25, 0.5, 0.75, 1]);\n\n/**\n * Canonical Gann fan slope ratios. Each entry is the slope multiplier\n * applied to the (a→b) direction vector — the 1×1 ray points at b, 1×2\n * doubles the slope, 2×1 halves it, etc. The 9-entry tuple matches the\n * upstream invinite default `FibGannLevel` set.\n *\n * @since 1.3\n * @stable\n * @example\n *     import { GANN_FAN_RATIOS } from \"./gannLevels.js\";\n *     for (const r of GANN_FAN_RATIOS) void r;\n */\nexport const GANN_FAN_RATIOS: ReadonlyArray<number> = Object.freeze([\n    1,\n    2,\n    3,\n    0.5,\n    1 / 3,\n    4,\n    0.25,\n    8,\n    0.125,\n]);\n\n/**\n * Human-readable label for each {@link GANN_FAN_RATIOS} entry. Order\n * matches the ratios array so a decomposer can co-index them. Ratios\n * greater than 1 render as `\"1x<n>\"`; ratios less than 1 render as\n * `\"<n>x1\"`; 1×1 is the identity.\n *\n * @since 1.3\n * @stable\n * @example\n *     import { GANN_FAN_LABELS } from \"./gannLevels.js\";\n *     for (const label of GANN_FAN_LABELS) void label;\n */\nexport const GANN_FAN_LABELS: ReadonlyArray<string> = Object.freeze([\n    \"1x1\",\n    \"1x2\",\n    \"1x3\",\n    \"2x1\",\n    \"3x1\",\n    \"1x4\",\n    \"4x1\",\n    \"1x8\",\n    \"8x1\",\n]);\n\n/**\n * Map a fan ratio to its kebab label. Ratios `>= 1` render as\n * `\"1x<n>\"`; ratios `< 1` render as `\"<n>x1\"` where `n = round(1 /\n * ratio)`. Used when fan labels are enabled.\n *\n * @since 1.3\n * @stable\n * @example\n *     import { formatGannRatio } from \"./gannLevels.js\";\n *     formatGannRatio(1); // \"1x1\"\n *     formatGannRatio(2); // \"1x2\"\n *     formatGannRatio(0.5); // \"2x1\"\n */\nexport function formatGannRatio(ratio: number): string {\n    if (ratio >= 1) return `1x${Math.round(ratio)}`;\n    return `${Math.round(1 / ratio)}x1`;\n}\n"]}

package/dist/geometry/_lib/lineExtend.d.ts

@@ -0,0 +1,31 @@
+import type { Point2, Viewport } from "../types.js";
+/**
+ * Project the segment `(a, b)` to the viewport edges in the directions
+ * `opts.extendLeft` / `opts.extendRight`. Used by the `line`
+ * decomposer (when its `LineDrawStyle` flags are set) and by
+ * `horizontal-ray` (always extends right).
+ *
+ * The projection walks the parametric line `p(t) = a + t·(b − a)` and
+ * solves for the `t` that hits `x = 0` (left edge) or
+ * `x = view.pxWidth` (right edge). A purely vertical segment
+ * (`dx === 0`) cannot intersect the x-edges, so the segment is returned
+ * unchanged (the stroke clips at the viewport boundary).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const view: Viewport;
+ *     const a: Point2 = { x: 100, y: 100 };
+ *     const b: Point2 = { x: 200, y: 200 };
+ *     const seg = extendLineSegment(a, b, { extendRight: true }, view);
+ *     // seg.from === a; seg.to.x === view.pxWidth
+ *     void seg;
+ */
+export declare function extendLineSegment(a: Point2, b: Point2, opts: {
+    readonly extendLeft?: boolean | undefined;
+    readonly extendRight?: boolean | undefined;
+}, view: Viewport): {
+    readonly from: Point2;
+    readonly to: Point2;
+};
+//# sourceMappingURL=lineExtend.d.ts.map

package/dist/geometry/_lib/lineExtend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineExtend.d.ts","sourceRoot":"","sources":["../../../src/geometry/_lib/lineExtend.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC7B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,EAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,EAC/F,IAAI,EAAE,QAAQ,GACf;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAkBhD"}