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

package/dist/canvas/paintPrimitive.js

@@ -0,0 +1,171 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * The canvas `textAlign` value a {@link DrawPrimitive} `text.align`
+ * maps to. The IR uses the narrower `left | center | right`.
+ */
+const ALIGN_TO_CANVAS = { left: "left", center: "center", right: "right" };
+/**
+ * The canvas `textBaseline` value a {@link DrawPrimitive} `text.baseline`
+ * maps to. The IR uses the narrower `top | middle | bottom`.
+ */
+const BASELINE_TO_CANVAS = { top: "top", middle: "middle", bottom: "bottom" };
+function applyFill(ctx, fill) {
+    ctx.fillStyle = fill.color;
+    ctx.globalAlpha = fill.alpha;
+    ctx.fill();
+    ctx.globalAlpha = 1;
+}
+function applyStrokeStyle(ctx, stroke) {
+    ctx.strokeStyle = stroke.color;
+    ctx.lineWidth = stroke.width;
+    ctx.setLineDash(stroke.dash);
+}
+/**
+ * Stroke the current path, bracketing the `stroke()` call in
+ * `globalAlpha` when `stroke.alpha` is set (the `highlighter`
+ * translucency), then resetting the dash. When `alpha` is omitted the
+ * call sequence is exactly `stroke()` → `setLineDash([])` — byte-identical
+ * to the Task-1 painter — so no-alpha strokes never re-hash.
+ */
+function strokeWithAlpha(ctx, stroke) {
+    if (stroke.alpha !== undefined) {
+        ctx.globalAlpha = stroke.alpha;
+        ctx.stroke();
+        ctx.globalAlpha = 1;
+    }
+    else {
+        ctx.stroke();
+    }
+    ctx.setLineDash([]);
+}
+/**
+ * Paint one {@link DrawPrimitive} into a {@link RenderCtx}. The canvas
+ * sink shared by the canvas2d, lightweight-charts, and uplot adapters.
+ * For each primitive the painter applies the stroke style (when set),
+ * builds the path, fills before stroking (so the outline draws on top
+ * of the band), and resets `setLineDash([])` + `globalAlpha = 1` after
+ * use so downstream draws are unaffected — matching the per-kind
+ * renderer conventions the IR replaces. A `stroke.alpha` (the
+ * `highlighter` translucency) brackets the `stroke()` in `globalAlpha`;
+ * an omitted `alpha` emits no `globalAlpha` mutation, keeping the
+ * sequence byte-identical to a Task-1 stroke.
+ *
+ * `text.bgColor` is carried on the IR but NOT painted here (the
+ * structural `RenderCtx` exposes neither `measureText` nor a
+ * background-rect path), mirroring the source renderers. The IR
+ * `marker` primitive is painted as a sized glyph; no basic kind emits
+ * it today, but adapters / future kinds rely on the painter covering
+ * every IR shape.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const ctx: RenderCtx;
+ *     paintPrimitive(ctx, {
+ *         kind: "polyline",
+ *         points: [{ x: 0, y: 0 }, { x: 10, y: 10 }],
+ *         closed: false,
+ *         stroke: { color: "#000000", width: 1, dash: [] },
+ *     });
+ *     void paintPrimitive;
+ */
+export function paintPrimitive(ctx, p) {
+    switch (p.kind) {
+        case "polyline": {
+            if (p.points.length === 0)
+                return;
+            if (p.stroke !== undefined)
+                applyStrokeStyle(ctx, p.stroke);
+            ctx.beginPath();
+            ctx.moveTo(p.points[0].x, p.points[0].y);
+            for (let i = 1; i < p.points.length; i++) {
+                ctx.lineTo(p.points[i].x, p.points[i].y);
+            }
+            if (p.closed)
+                ctx.closePath();
+            if (p.fill !== undefined)
+                applyFill(ctx, p.fill);
+            if (p.stroke !== undefined)
+                strokeWithAlpha(ctx, p.stroke);
+            return;
+        }
+        case "arc": {
+            if (p.stroke !== undefined)
+                applyStrokeStyle(ctx, p.stroke);
+            ctx.beginPath();
+            ctx.arc(p.cx, p.cy, p.r, p.start, p.end);
+            if (p.closed)
+                ctx.closePath();
+            if (p.fill !== undefined)
+                applyFill(ctx, p.fill);
+            if (p.stroke !== undefined)
+                strokeWithAlpha(ctx, p.stroke);
+            return;
+        }
+        case "text": {
+            ctx.font = p.font;
+            ctx.textAlign = ALIGN_TO_CANVAS[p.align];
+            ctx.textBaseline = BASELINE_TO_CANVAS[p.baseline];
+            ctx.fillStyle = p.color;
+            ctx.fillText(p.text, p.x, p.y);
+            return;
+        }
+        case "marker": {
+            const polygon = markerPolygon(p.shape, p.x, p.y, p.size);
+            if (p.stroke !== undefined)
+                applyStrokeStyle(ctx, p.stroke);
+            ctx.beginPath();
+            ctx.moveTo(polygon[0].x, polygon[0].y);
+            for (let i = 1; i < polygon.length; i++) {
+                ctx.lineTo(polygon[i].x, polygon[i].y);
+            }
+            ctx.closePath();
+            if (p.fill !== undefined)
+                applyFill(ctx, p.fill);
+            if (p.stroke !== undefined)
+                strokeWithAlpha(ctx, p.stroke);
+            return;
+        }
+    }
+}
+/**
+ * Vertices of a sized marker glyph centred on `(x, y)`. `circle` is
+ * approximated as a square for the closed-polygon painter — the IR
+ * `marker` is emitted by no basic kind today, so the approximation only
+ * matters once an adapter / later task uses it; the contract is a
+ * non-empty closed polygon for every shape.
+ */
+function markerPolygon(shape, x, y, size) {
+    const h = size / 2;
+    switch (shape) {
+        case "circle":
+        case "square":
+            return [
+                { x: x - h, y: y - h },
+                { x: x + h, y: y - h },
+                { x: x + h, y: y + h },
+                { x: x - h, y: y + h },
+            ];
+        case "diamond":
+            return [
+                { x, y: y - h },
+                { x: x + h, y },
+                { x, y: y + h },
+                { x: x - h, y },
+            ];
+        case "triangle-up":
+            return [
+                { x, y: y - h },
+                { x: x + h, y: y + h },
+                { x: x - h, y: y + h },
+            ];
+        case "triangle-down":
+            return [
+                { x, y: y + h },
+                { x: x + h, y: y - h },
+                { x: x - h, y: y - h },
+            ];
+    }
+}
+//# sourceMappingURL=paintPrimitive.js.map

package/dist/canvas/paintPrimitive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paintPrimitive.js","sourceRoot":"","sources":["../../src/canvas/paintPrimitive.ts"],"names":[],"mappings":"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","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 { DrawPrimitive, FillStyle, StrokeStyle } from \"../geometry/types.js\";\nimport type { RenderCtx } from \"./renderCtx.js\";\n\n/**\n * The canvas `textAlign` value a {@link DrawPrimitive} `text.align`\n * maps to. The IR uses the narrower `left | center | right`.\n */\nconst ALIGN_TO_CANVAS: Readonly<Record<\"left\" | \"center\" | \"right\", \"left\" | \"center\" | \"right\">> =\n    { left: \"left\", center: \"center\", right: \"right\" };\n\n/**\n * The canvas `textBaseline` value a {@link DrawPrimitive} `text.baseline`\n * maps to. The IR uses the narrower `top | middle | bottom`.\n */\nconst BASELINE_TO_CANVAS: Readonly<\n    Record<\"top\" | \"middle\" | \"bottom\", \"top\" | \"middle\" | \"bottom\">\n> = { top: \"top\", middle: \"middle\", bottom: \"bottom\" };\n\nfunction applyFill(ctx: RenderCtx, fill: FillStyle): void {\n    ctx.fillStyle = fill.color;\n    ctx.globalAlpha = fill.alpha;\n    ctx.fill();\n    ctx.globalAlpha = 1;\n}\n\nfunction applyStrokeStyle(ctx: RenderCtx, stroke: StrokeStyle): void {\n    ctx.strokeStyle = stroke.color;\n    ctx.lineWidth = stroke.width;\n    ctx.setLineDash(stroke.dash);\n}\n\n/**\n * Stroke the current path, bracketing the `stroke()` call in\n * `globalAlpha` when `stroke.alpha` is set (the `highlighter`\n * translucency), then resetting the dash. When `alpha` is omitted the\n * call sequence is exactly `stroke()` → `setLineDash([])` — byte-identical\n * to the Task-1 painter — so no-alpha strokes never re-hash.\n */\nfunction strokeWithAlpha(ctx: RenderCtx, stroke: StrokeStyle): void {\n    if (stroke.alpha !== undefined) {\n        ctx.globalAlpha = stroke.alpha;\n        ctx.stroke();\n        ctx.globalAlpha = 1;\n    } else {\n        ctx.stroke();\n    }\n    ctx.setLineDash([]);\n}\n\n/**\n * Paint one {@link DrawPrimitive} into a {@link RenderCtx}. The canvas\n * sink shared by the canvas2d, lightweight-charts, and uplot adapters.\n * For each primitive the painter applies the stroke style (when set),\n * builds the path, fills before stroking (so the outline draws on top\n * of the band), and resets `setLineDash([])` + `globalAlpha = 1` after\n * use so downstream draws are unaffected — matching the per-kind\n * renderer conventions the IR replaces. A `stroke.alpha` (the\n * `highlighter` translucency) brackets the `stroke()` in `globalAlpha`;\n * an omitted `alpha` emits no `globalAlpha` mutation, keeping the\n * sequence byte-identical to a Task-1 stroke.\n *\n * `text.bgColor` is carried on the IR but NOT painted here (the\n * structural `RenderCtx` exposes neither `measureText` nor a\n * background-rect path), mirroring the source renderers. The IR\n * `marker` primitive is painted as a sized glyph; no basic kind emits\n * it today, but adapters / future kinds rely on the painter covering\n * every IR shape.\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const ctx: RenderCtx;\n *     paintPrimitive(ctx, {\n *         kind: \"polyline\",\n *         points: [{ x: 0, y: 0 }, { x: 10, y: 10 }],\n *         closed: false,\n *         stroke: { color: \"#000000\", width: 1, dash: [] },\n *     });\n *     void paintPrimitive;\n */\nexport function paintPrimitive(ctx: RenderCtx, p: DrawPrimitive): void {\n    switch (p.kind) {\n        case \"polyline\": {\n            if (p.points.length === 0) return;\n            if (p.stroke !== undefined) applyStrokeStyle(ctx, p.stroke);\n            ctx.beginPath();\n            ctx.moveTo(p.points[0].x, p.points[0].y);\n            for (let i = 1; i < p.points.length; i++) {\n                ctx.lineTo(p.points[i].x, p.points[i].y);\n            }\n            if (p.closed) ctx.closePath();\n            if (p.fill !== undefined) applyFill(ctx, p.fill);\n            if (p.stroke !== undefined) strokeWithAlpha(ctx, p.stroke);\n            return;\n        }\n        case \"arc\": {\n            if (p.stroke !== undefined) applyStrokeStyle(ctx, p.stroke);\n            ctx.beginPath();\n            ctx.arc(p.cx, p.cy, p.r, p.start, p.end);\n            if (p.closed) ctx.closePath();\n            if (p.fill !== undefined) applyFill(ctx, p.fill);\n            if (p.stroke !== undefined) strokeWithAlpha(ctx, p.stroke);\n            return;\n        }\n        case \"text\": {\n            ctx.font = p.font;\n            ctx.textAlign = ALIGN_TO_CANVAS[p.align];\n            ctx.textBaseline = BASELINE_TO_CANVAS[p.baseline];\n            ctx.fillStyle = p.color;\n            ctx.fillText(p.text, p.x, p.y);\n            return;\n        }\n        case \"marker\": {\n            const polygon = markerPolygon(p.shape, p.x, p.y, p.size);\n            if (p.stroke !== undefined) applyStrokeStyle(ctx, p.stroke);\n            ctx.beginPath();\n            ctx.moveTo(polygon[0].x, polygon[0].y);\n            for (let i = 1; i < polygon.length; i++) {\n                ctx.lineTo(polygon[i].x, polygon[i].y);\n            }\n            ctx.closePath();\n            if (p.fill !== undefined) applyFill(ctx, p.fill);\n            if (p.stroke !== undefined) strokeWithAlpha(ctx, p.stroke);\n            return;\n        }\n    }\n}\n\n/**\n * Vertices of a sized marker glyph centred on `(x, y)`. `circle` is\n * approximated as a square for the closed-polygon painter — the IR\n * `marker` is emitted by no basic kind today, so the approximation only\n * matters once an adapter / later task uses it; the contract is a\n * non-empty closed polygon for every shape.\n */\nfunction markerPolygon(\n    shape: \"circle\" | \"square\" | \"diamond\" | \"triangle-up\" | \"triangle-down\",\n    x: number,\n    y: number,\n    size: number,\n): ReadonlyArray<{ readonly x: number; readonly y: number }> {\n    const h = size / 2;\n    switch (shape) {\n        case \"circle\":\n        case \"square\":\n            return [\n                { x: x - h, y: y - h },\n                { x: x + h, y: y - h },\n                { x: x + h, y: y + h },\n                { x: x - h, y: y + h },\n            ];\n        case \"diamond\":\n            return [\n                { x, y: y - h },\n                { x: x + h, y },\n                { x, y: y + h },\n                { x: x - h, y },\n            ];\n        case \"triangle-up\":\n            return [\n                { x, y: y - h },\n                { x: x + h, y: y + h },\n                { x: x - h, y: y + h },\n            ];\n        case \"triangle-down\":\n            return [\n                { x, y: y + h },\n                { x: x + h, y: y - h },\n                { x: x - h, y: y - h },\n            ];\n    }\n}\n"]}

package/dist/canvas/renderCtx.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Minimal `CanvasRenderingContext2D` subset the canvas-family sink
+ * touches. Declared here (and re-used by {@link import("./paintPrimitive").paintPrimitive}
+ * and {@link import("./mockContext").MockCanvasContext}) so production
+ * `CanvasRenderingContext2D`, `OffscreenCanvasRenderingContext2D`, and
+ * the test `MockCanvasContext` all satisfy one structural type. Moved
+ * from the canvas2d adapter's `render/clear.ts` so lightweight-charts /
+ * uplot / canvas2d share one painter and one mock.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const ctx: RenderCtx;
+ *     ctx.clearRect(0, 0, 1, 1);
+ *     void ctx;
+ */
+export type RenderCtx = {
+    clearRect(x: number, y: number, w: number, h: number): void;
+    translate(x: number, y: number): void;
+    save(): void;
+    restore(): void;
+    beginPath(): void;
+    moveTo(x: number, y: number): void;
+    lineTo(x: number, y: number): void;
+    stroke(): void;
+    fillRect(x: number, y: number, w: number, h: number): void;
+    fill(): void;
+    arc(x: number, y: number, radius: number, start: number, end: number): void;
+    closePath(): void;
+    setLineDash(segments: ReadonlyArray<number>): void;
+    fillText(text: string, x: number, y: number): void;
+    strokeStyle: string;
+    fillStyle: string;
+    lineWidth: number;
+    globalAlpha: number;
+    font: string;
+    textAlign: "start" | "center" | "end" | "left" | "right";
+    textBaseline: "top" | "middle" | "bottom" | "alphabetic" | "hanging";
+};
+//# sourceMappingURL=renderCtx.d.ts.map

package/dist/canvas/renderCtx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderCtx.d.ts","sourceRoot":"","sources":["../../src/canvas/renderCtx.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GAAG;IACpB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,IAAI,CAAC;IAChB,SAAS,IAAI,IAAI,CAAC;IAClB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D,IAAI,IAAI,IAAI,CAAC;IACb,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5E,SAAS,IAAI,IAAI,CAAC;IAClB,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IACzD,YAAY,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;CACxE,CAAC"}

package/dist/canvas/renderCtx.js

@@ -0,0 +1,4 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+export {};
+//# sourceMappingURL=renderCtx.js.map

package/dist/canvas/renderCtx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderCtx.js","sourceRoot":"","sources":["../../src/canvas/renderCtx.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D","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 * Minimal `CanvasRenderingContext2D` subset the canvas-family sink\n * touches. Declared here (and re-used by {@link import(\"./paintPrimitive\").paintPrimitive}\n * and {@link import(\"./mockContext\").MockCanvasContext}) so production\n * `CanvasRenderingContext2D`, `OffscreenCanvasRenderingContext2D`, and\n * the test `MockCanvasContext` all satisfy one structural type. Moved\n * from the canvas2d adapter's `render/clear.ts` so lightweight-charts /\n * uplot / canvas2d share one painter and one mock.\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const ctx: RenderCtx;\n *     ctx.clearRect(0, 0, 1, 1);\n *     void ctx;\n */\nexport type RenderCtx = {\n    clearRect(x: number, y: number, w: number, h: number): void;\n    translate(x: number, y: number): void;\n    save(): void;\n    restore(): void;\n    beginPath(): void;\n    moveTo(x: number, y: number): void;\n    lineTo(x: number, y: number): void;\n    stroke(): void;\n    fillRect(x: number, y: number, w: number, h: number): void;\n    fill(): void;\n    arc(x: number, y: number, radius: number, start: number, end: number): void;\n    closePath(): void;\n    setLineDash(segments: ReadonlyArray<number>): void;\n    fillText(text: string, x: number, y: number): void;\n    strokeStyle: string;\n    fillStyle: string;\n    lineWidth: number;\n    globalAlpha: number;\n    font: string;\n    textAlign: \"start\" | \"center\" | \"end\" | \"left\" | \"right\";\n    textBaseline: \"top\" | \"middle\" | \"bottom\" | \"alphabetic\" | \"hanging\";\n};\n"]}

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

@@ -0,0 +1,18 @@
+import type { Point2 } from "../types.js";
+/**
+ * Return the three vertices of a filled isoceles-triangle arrowhead at
+ * `to` pointing along the `from → to` direction. The order is
+ * `[tip, leftWing, rightWing]` so a caller paints a closed polyline
+ * `moveTo(tip) → lineTo(left) → lineTo(right) → close`. Pure — no `ctx`.
+ *
+ * `size` defaults to 8 CSS px (the wing length).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const tri = arrowheadPolygon({ x: 0, y: 0 }, { x: 100, y: 0 });
+ *     // tri[0] === { x: 100, y: 0 } (tip)
+ *     void tri;
+ */
+export declare function arrowheadPolygon(from: Point2, to: Point2, size?: number): ReadonlyArray<Point2>;
+//# sourceMappingURL=arrowhead.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arrowhead.d.ts","sourceRoot":"","sources":["../../../src/geometry/_lib/arrowhead.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAK1C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC5B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,MAA+B,GACtC,aAAa,CAAC,MAAM,CAAC,CAWvB"}

package/dist/geometry/_lib/arrowhead.js

@@ -0,0 +1,38 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// Arrowhead geometry ported from
+//   invinite/src/components/trading-chart/tools/arrow-tool.ts,
+//   invinite/src/components/trading-chart/tools/arrow-marker-tool.ts,
+//   commit 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite.
+// Re-licensed MIT for chartlang.
+const DEFAULT_ARROWHEAD_SIZE = 8;
+const ARROWHEAD_HALF_ANGLE = Math.PI / 6; // 30° each side → 60° total
+/**
+ * Return the three vertices of a filled isoceles-triangle arrowhead at
+ * `to` pointing along the `from → to` direction. The order is
+ * `[tip, leftWing, rightWing]` so a caller paints a closed polyline
+ * `moveTo(tip) → lineTo(left) → lineTo(right) → close`. Pure — no `ctx`.
+ *
+ * `size` defaults to 8 CSS px (the wing length).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const tri = arrowheadPolygon({ x: 0, y: 0 }, { x: 100, y: 0 });
+ *     // tri[0] === { x: 100, y: 0 } (tip)
+ *     void tri;
+ */
+export function arrowheadPolygon(from, to, size = DEFAULT_ARROWHEAD_SIZE) {
+    const angle = Math.atan2(to.y - from.y, to.x - from.x);
+    const left = {
+        x: to.x - size * Math.cos(angle - ARROWHEAD_HALF_ANGLE),
+        y: to.y - size * Math.sin(angle - ARROWHEAD_HALF_ANGLE),
+    };
+    const right = {
+        x: to.x - size * Math.cos(angle + ARROWHEAD_HALF_ANGLE),
+        y: to.y - size * Math.sin(angle + ARROWHEAD_HALF_ANGLE),
+    };
+    return [to, left, right];
+}
+//# sourceMappingURL=arrowhead.js.map

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"]}