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

package/dist/geometry/decompose.js

@@ -0,0 +1,176 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { decomposeArrow, decomposeArrowMarkDown, decomposeArrowMarkUp, decomposeArrowMarker, decomposeText, } from "./kinds/annotations.js";
+import { decomposeCircle, decomposeEllipse, decomposeFillBetween, decomposePath, decomposePolyline, decomposeRectangle, decomposeRotatedRectangle, decomposeTriangle, } from "./kinds/boxes.js";
+import { decomposeDisjointChannel, decomposeFlatTopBottom, decomposeRegressionTrend, decomposeTrendChannel, } from "./kinds/channels.js";
+import { decomposeFrame, decomposeGroup, decomposeTable } from "./kinds/containers.js";
+import { decomposeArc, decomposeCurve, decomposeDoubleCurve } from "./kinds/curves.js";
+import { decomposeCyclicLines, decomposeSineLine, decomposeTimeCycles } from "./kinds/cycles.js";
+import { decomposeElliottCorrectionWave, decomposeElliottDoubleCombo, decomposeElliottImpulseWave, decomposeElliottTriangleWave, decomposeElliottTripleCombo, } from "./kinds/elliott.js";
+import { decomposeFibChannel, decomposeFibCircles, decomposeFibRetracement, decomposeFibSpeedArcs, decomposeFibSpeedFan, decomposeFibSpiral, decomposeFibTimeZone, decomposeFibTrendExtension, decomposeFibTrendTime, decomposeFibWedge, } from "./kinds/fibonacci.js";
+import { decomposeBrush, decomposeHighlighter, decomposePen } from "./kinds/freehand.js";
+import { decomposeGannBox, decomposeGannFan, decomposeGannSquare, decomposeGannSquareFixed, } from "./kinds/gann.js";
+import { decomposeCrossLine, decomposeHorizontalLine, decomposeHorizontalRay, decomposeLine, decomposeTrendAngle, decomposeVerticalLine, } from "./kinds/lines.js";
+import { decomposeMarker } from "./kinds/marker.js";
+import { decomposeAbcdPattern, decomposeCypherPattern, decomposeHeadAndShoulders, decomposeThreeDrivesPattern, decomposeTrianglePattern, decomposeXabcdPattern, } from "./kinds/patterns.js";
+import { decomposePitchfan, decomposePitchfork } from "./kinds/pitchforks.js";
+/**
+ * Reduce a {@link DrawingEmission} to a flat, renderer-agnostic
+ * {@link DrawPrimitive} list against `view`. Pure — no `ctx`, no library
+ * types — so every adapter shares one geometry derivation and paints
+ * the result with its own sink.
+ *
+ * The switch is **exhaustive over all 63 `DrawingKind`s**: the 20 basic
+ * kinds (Task 1), the 20 curve / freehand / channel / fibonacci kinds
+ * (Task 2), and the 23 gann / pitchfork / pattern / elliott / cycle /
+ * container / table kinds (Task 3). The `default` arm is a `const
+ * _exhaustive: never` guard — it compiles only because every literal has
+ * a `case`, so adding a future `DrawingKind` to core fails `pnpm
+ * typecheck` here until a decomposer is added. `op: "remove"` is handled
+ * by each adapter's drawing-state map (this function operates on whatever
+ * `state` it is handed).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const e: DrawingEmission;
+ *     declare const v: Viewport;
+ *     const prims = decomposeDrawing(e, v);
+ *     void prims;
+ */
+export function decomposeDrawing(e, view) {
+    switch (e.drawingKind) {
+        case "line":
+            return decomposeLine(e.state, view);
+        case "horizontal-line":
+            return decomposeHorizontalLine(e.state, view);
+        case "horizontal-ray":
+            return decomposeHorizontalRay(e.state, view);
+        case "vertical-line":
+            return decomposeVerticalLine(e.state, view);
+        case "cross-line":
+            return decomposeCrossLine(e.state, view);
+        case "trend-angle":
+            return decomposeTrendAngle(e.state, view);
+        case "rectangle":
+            return decomposeRectangle(e.state, view);
+        case "rotated-rectangle":
+            return decomposeRotatedRectangle(e.state, view);
+        case "triangle":
+            return decomposeTriangle(e.state, view);
+        case "polyline":
+            return decomposePolyline(e.state, view);
+        case "circle":
+            return decomposeCircle(e.state, view);
+        case "ellipse":
+            return decomposeEllipse(e.state, view);
+        case "path":
+            return decomposePath(e.state, view);
+        case "fill-between":
+            return decomposeFillBetween(e.state, view);
+        case "marker":
+            return decomposeMarker(e.state, view);
+        case "text":
+            return decomposeText(e.state, view);
+        case "arrow":
+            return decomposeArrow(e.state, view);
+        case "arrow-marker":
+            return decomposeArrowMarker(e.state, view);
+        case "arrow-mark-up":
+            return decomposeArrowMarkUp(e.state, view);
+        case "arrow-mark-down":
+            return decomposeArrowMarkDown(e.state, view);
+        case "arc":
+            return decomposeArc(e.state, view);
+        case "curve":
+            return decomposeCurve(e.state, view);
+        case "double-curve":
+            return decomposeDoubleCurve(e.state, view);
+        case "pen":
+            return decomposePen(e.state, view);
+        case "highlighter":
+            return decomposeHighlighter(e.state, view);
+        case "brush":
+            return decomposeBrush(e.state, view);
+        case "trend-channel":
+            return decomposeTrendChannel(e.state, view);
+        case "flat-top-bottom":
+            return decomposeFlatTopBottom(e.state, view);
+        case "disjoint-channel":
+            return decomposeDisjointChannel(e.state, view);
+        case "regression-trend":
+            return decomposeRegressionTrend(e.state, view);
+        case "fib-retracement":
+            return decomposeFibRetracement(e.state, view);
+        case "fib-trend-extension":
+            return decomposeFibTrendExtension(e.state, view);
+        case "fib-channel":
+            return decomposeFibChannel(e.state, view);
+        case "fib-time-zone":
+            return decomposeFibTimeZone(e.state, view);
+        case "fib-wedge":
+            return decomposeFibWedge(e.state, view);
+        case "fib-speed-fan":
+            return decomposeFibSpeedFan(e.state, view);
+        case "fib-speed-arcs":
+            return decomposeFibSpeedArcs(e.state, view);
+        case "fib-spiral":
+            return decomposeFibSpiral(e.state, view);
+        case "fib-circles":
+            return decomposeFibCircles(e.state, view);
+        case "fib-trend-time":
+            return decomposeFibTrendTime(e.state, view);
+        case "gann-box":
+            return decomposeGannBox(e.state, view);
+        case "gann-square-fixed":
+            return decomposeGannSquareFixed(e.state, view);
+        case "gann-square":
+            return decomposeGannSquare(e.state, view);
+        case "gann-fan":
+            return decomposeGannFan(e.state, view);
+        case "pitchfork":
+            return decomposePitchfork(e.state, view);
+        case "pitchfan":
+            return decomposePitchfan(e.state, view);
+        case "xabcd-pattern":
+            return decomposeXabcdPattern(e.state, view);
+        case "cypher-pattern":
+            return decomposeCypherPattern(e.state, view);
+        case "head-and-shoulders":
+            return decomposeHeadAndShoulders(e.state, view);
+        case "abcd-pattern":
+            return decomposeAbcdPattern(e.state, view);
+        case "triangle-pattern":
+            return decomposeTrianglePattern(e.state, view);
+        case "three-drives-pattern":
+            return decomposeThreeDrivesPattern(e.state, view);
+        case "elliott-impulse-wave":
+            return decomposeElliottImpulseWave(e.state, view);
+        case "elliott-correction-wave":
+            return decomposeElliottCorrectionWave(e.state, view);
+        case "elliott-triangle-wave":
+            return decomposeElliottTriangleWave(e.state, view);
+        case "elliott-double-combo":
+            return decomposeElliottDoubleCombo(e.state, view);
+        case "elliott-triple-combo":
+            return decomposeElliottTripleCombo(e.state, view);
+        case "cyclic-lines":
+            return decomposeCyclicLines(e.state, view);
+        case "time-cycles":
+            return decomposeTimeCycles(e.state, view);
+        case "sine-line":
+            return decomposeSineLine(e.state, view);
+        case "group":
+            return decomposeGroup(e.state, view);
+        case "frame":
+            return decomposeFrame(e.state, view);
+        case "table":
+            return decomposeTable(e.state, view);
+        default: {
+            const _exhaustive = e.drawingKind;
+            void _exhaustive;
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=decompose.js.map

package/dist/geometry/decompose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompose.js","sourceRoot":"","sources":["../../src/geometry/decompose.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 {\n    AbcdPatternState,\n    ArcState,\n    ArrowMarkDownState,\n    ArrowMarkUpState,\n    ArrowMarkerState,\n    ArrowState,\n    BrushState,\n    CircleState,\n    CrossLineState,\n    CurveState,\n    CyclicLinesState,\n    CypherPatternState,\n    DisjointChannelState,\n    DoubleCurveState,\n    ElliottCorrectionWaveState,\n    ElliottDoubleComboState,\n    ElliottImpulseWaveState,\n    ElliottTriangleWaveState,\n    ElliottTripleComboState,\n    EllipseState,\n    FibChannelState,\n    FibCirclesState,\n    FibRetracementState,\n    FibSpeedArcsState,\n    FibSpeedFanState,\n    FibSpiralState,\n    FibTimeZoneState,\n    FibTrendExtensionState,\n    FibTrendTimeState,\n    FibWedgeState,\n    FillBetweenState,\n    FlatTopBottomState,\n    FrameState,\n    GannBoxState,\n    GannFanState,\n    GannSquareFixedState,\n    GannSquareState,\n    GroupState,\n    HeadAndShouldersState,\n    HighlighterState,\n    HorizontalLineState,\n    HorizontalRayState,\n    LineState,\n    MarkerState,\n    PathState,\n    PenState,\n    PitchfanState,\n    PitchforkState,\n    PolylineState,\n    RectangleState,\n    RegressionTrendState,\n    RotatedRectangleState,\n    SineLineState,\n    TableState,\n    TextState,\n    ThreeDrivesPatternState,\n    TimeCyclesState,\n    TrendAngleState,\n    TrendChannelState,\n    TrianglePatternState,\n    TriangleState,\n    VerticalLineState,\n    XabcdPatternState,\n} from \"@invinite-org/chartlang-core\";\n\nimport type { DrawingEmission } from \"../types.js\";\nimport {\n    decomposeArrow,\n    decomposeArrowMarkDown,\n    decomposeArrowMarkUp,\n    decomposeArrowMarker,\n    decomposeText,\n} from \"./kinds/annotations.js\";\nimport {\n    decomposeCircle,\n    decomposeEllipse,\n    decomposeFillBetween,\n    decomposePath,\n    decomposePolyline,\n    decomposeRectangle,\n    decomposeRotatedRectangle,\n    decomposeTriangle,\n} from \"./kinds/boxes.js\";\nimport {\n    decomposeDisjointChannel,\n    decomposeFlatTopBottom,\n    decomposeRegressionTrend,\n    decomposeTrendChannel,\n} from \"./kinds/channels.js\";\nimport { decomposeFrame, decomposeGroup, decomposeTable } from \"./kinds/containers.js\";\nimport { decomposeArc, decomposeCurve, decomposeDoubleCurve } from \"./kinds/curves.js\";\nimport { decomposeCyclicLines, decomposeSineLine, decomposeTimeCycles } from \"./kinds/cycles.js\";\nimport {\n    decomposeElliottCorrectionWave,\n    decomposeElliottDoubleCombo,\n    decomposeElliottImpulseWave,\n    decomposeElliottTriangleWave,\n    decomposeElliottTripleCombo,\n} from \"./kinds/elliott.js\";\nimport {\n    decomposeFibChannel,\n    decomposeFibCircles,\n    decomposeFibRetracement,\n    decomposeFibSpeedArcs,\n    decomposeFibSpeedFan,\n    decomposeFibSpiral,\n    decomposeFibTimeZone,\n    decomposeFibTrendExtension,\n    decomposeFibTrendTime,\n    decomposeFibWedge,\n} from \"./kinds/fibonacci.js\";\nimport { decomposeBrush, decomposeHighlighter, decomposePen } from \"./kinds/freehand.js\";\nimport {\n    decomposeGannBox,\n    decomposeGannFan,\n    decomposeGannSquare,\n    decomposeGannSquareFixed,\n} from \"./kinds/gann.js\";\nimport {\n    decomposeCrossLine,\n    decomposeHorizontalLine,\n    decomposeHorizontalRay,\n    decomposeLine,\n    decomposeTrendAngle,\n    decomposeVerticalLine,\n} from \"./kinds/lines.js\";\nimport { decomposeMarker } from \"./kinds/marker.js\";\nimport {\n    decomposeAbcdPattern,\n    decomposeCypherPattern,\n    decomposeHeadAndShoulders,\n    decomposeThreeDrivesPattern,\n    decomposeTrianglePattern,\n    decomposeXabcdPattern,\n} from \"./kinds/patterns.js\";\nimport { decomposePitchfan, decomposePitchfork } from \"./kinds/pitchforks.js\";\nimport type { DrawPrimitive, Viewport } from \"./types.js\";\n\n/**\n * Reduce a {@link DrawingEmission} to a flat, renderer-agnostic\n * {@link DrawPrimitive} list against `view`. Pure — no `ctx`, no library\n * types — so every adapter shares one geometry derivation and paints\n * the result with its own sink.\n *\n * The switch is **exhaustive over all 63 `DrawingKind`s**: the 20 basic\n * kinds (Task 1), the 20 curve / freehand / channel / fibonacci kinds\n * (Task 2), and the 23 gann / pitchfork / pattern / elliott / cycle /\n * container / table kinds (Task 3). The `default` arm is a `const\n * _exhaustive: never` guard — it compiles only because every literal has\n * a `case`, so adding a future `DrawingKind` to core fails `pnpm\n * typecheck` here until a decomposer is added. `op: \"remove\"` is handled\n * by each adapter's drawing-state map (this function operates on whatever\n * `state` it is handed).\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const e: DrawingEmission;\n *     declare const v: Viewport;\n *     const prims = decomposeDrawing(e, v);\n *     void prims;\n */\nexport function decomposeDrawing(e: DrawingEmission, view: Viewport): ReadonlyArray<DrawPrimitive> {\n    switch (e.drawingKind) {\n        case \"line\":\n            return decomposeLine(e.state as LineState, view);\n        case \"horizontal-line\":\n            return decomposeHorizontalLine(e.state as HorizontalLineState, view);\n        case \"horizontal-ray\":\n            return decomposeHorizontalRay(e.state as HorizontalRayState, view);\n        case \"vertical-line\":\n            return decomposeVerticalLine(e.state as VerticalLineState, view);\n        case \"cross-line\":\n            return decomposeCrossLine(e.state as CrossLineState, view);\n        case \"trend-angle\":\n            return decomposeTrendAngle(e.state as TrendAngleState, view);\n        case \"rectangle\":\n            return decomposeRectangle(e.state as RectangleState, view);\n        case \"rotated-rectangle\":\n            return decomposeRotatedRectangle(e.state as RotatedRectangleState, view);\n        case \"triangle\":\n            return decomposeTriangle(e.state as TriangleState, view);\n        case \"polyline\":\n            return decomposePolyline(e.state as PolylineState, view);\n        case \"circle\":\n            return decomposeCircle(e.state as CircleState, view);\n        case \"ellipse\":\n            return decomposeEllipse(e.state as EllipseState, view);\n        case \"path\":\n            return decomposePath(e.state as PathState, view);\n        case \"fill-between\":\n            return decomposeFillBetween(e.state as FillBetweenState, view);\n        case \"marker\":\n            return decomposeMarker(e.state as MarkerState, view);\n        case \"text\":\n            return decomposeText(e.state as TextState, view);\n        case \"arrow\":\n            return decomposeArrow(e.state as ArrowState, view);\n        case \"arrow-marker\":\n            return decomposeArrowMarker(e.state as ArrowMarkerState, view);\n        case \"arrow-mark-up\":\n            return decomposeArrowMarkUp(e.state as ArrowMarkUpState, view);\n        case \"arrow-mark-down\":\n            return decomposeArrowMarkDown(e.state as ArrowMarkDownState, view);\n        case \"arc\":\n            return decomposeArc(e.state as ArcState, view);\n        case \"curve\":\n            return decomposeCurve(e.state as CurveState, view);\n        case \"double-curve\":\n            return decomposeDoubleCurve(e.state as DoubleCurveState, view);\n        case \"pen\":\n            return decomposePen(e.state as PenState, view);\n        case \"highlighter\":\n            return decomposeHighlighter(e.state as HighlighterState, view);\n        case \"brush\":\n            return decomposeBrush(e.state as BrushState, view);\n        case \"trend-channel\":\n            return decomposeTrendChannel(e.state as TrendChannelState, view);\n        case \"flat-top-bottom\":\n            return decomposeFlatTopBottom(e.state as FlatTopBottomState, view);\n        case \"disjoint-channel\":\n            return decomposeDisjointChannel(e.state as DisjointChannelState, view);\n        case \"regression-trend\":\n            return decomposeRegressionTrend(e.state as RegressionTrendState, view);\n        case \"fib-retracement\":\n            return decomposeFibRetracement(e.state as FibRetracementState, view);\n        case \"fib-trend-extension\":\n            return decomposeFibTrendExtension(e.state as FibTrendExtensionState, view);\n        case \"fib-channel\":\n            return decomposeFibChannel(e.state as FibChannelState, view);\n        case \"fib-time-zone\":\n            return decomposeFibTimeZone(e.state as FibTimeZoneState, view);\n        case \"fib-wedge\":\n            return decomposeFibWedge(e.state as FibWedgeState, view);\n        case \"fib-speed-fan\":\n            return decomposeFibSpeedFan(e.state as FibSpeedFanState, view);\n        case \"fib-speed-arcs\":\n            return decomposeFibSpeedArcs(e.state as FibSpeedArcsState, view);\n        case \"fib-spiral\":\n            return decomposeFibSpiral(e.state as FibSpiralState, view);\n        case \"fib-circles\":\n            return decomposeFibCircles(e.state as FibCirclesState, view);\n        case \"fib-trend-time\":\n            return decomposeFibTrendTime(e.state as FibTrendTimeState, view);\n        case \"gann-box\":\n            return decomposeGannBox(e.state as GannBoxState, view);\n        case \"gann-square-fixed\":\n            return decomposeGannSquareFixed(e.state as GannSquareFixedState, view);\n        case \"gann-square\":\n            return decomposeGannSquare(e.state as GannSquareState, view);\n        case \"gann-fan\":\n            return decomposeGannFan(e.state as GannFanState, view);\n        case \"pitchfork\":\n            return decomposePitchfork(e.state as PitchforkState, view);\n        case \"pitchfan\":\n            return decomposePitchfan(e.state as PitchfanState, view);\n        case \"xabcd-pattern\":\n            return decomposeXabcdPattern(e.state as XabcdPatternState, view);\n        case \"cypher-pattern\":\n            return decomposeCypherPattern(e.state as CypherPatternState, view);\n        case \"head-and-shoulders\":\n            return decomposeHeadAndShoulders(e.state as HeadAndShouldersState, view);\n        case \"abcd-pattern\":\n            return decomposeAbcdPattern(e.state as AbcdPatternState, view);\n        case \"triangle-pattern\":\n            return decomposeTrianglePattern(e.state as TrianglePatternState, view);\n        case \"three-drives-pattern\":\n            return decomposeThreeDrivesPattern(e.state as ThreeDrivesPatternState, view);\n        case \"elliott-impulse-wave\":\n            return decomposeElliottImpulseWave(e.state as ElliottImpulseWaveState, view);\n        case \"elliott-correction-wave\":\n            return decomposeElliottCorrectionWave(e.state as ElliottCorrectionWaveState, view);\n        case \"elliott-triangle-wave\":\n            return decomposeElliottTriangleWave(e.state as ElliottTriangleWaveState, view);\n        case \"elliott-double-combo\":\n            return decomposeElliottDoubleCombo(e.state as ElliottDoubleComboState, view);\n        case \"elliott-triple-combo\":\n            return decomposeElliottTripleCombo(e.state as ElliottTripleComboState, view);\n        case \"cyclic-lines\":\n            return decomposeCyclicLines(e.state as CyclicLinesState, view);\n        case \"time-cycles\":\n            return decomposeTimeCycles(e.state as TimeCyclesState, view);\n        case \"sine-line\":\n            return decomposeSineLine(e.state as SineLineState, view);\n        case \"group\":\n            return decomposeGroup(e.state as GroupState, view);\n        case \"frame\":\n            return decomposeFrame(e.state as FrameState, view);\n        case \"table\":\n            return decomposeTable(e.state as TableState, view);\n        default: {\n            const _exhaustive: never = e.drawingKind;\n            void _exhaustive;\n            return [];\n        }\n    }\n}\n"]}

package/dist/geometry/index.d.ts

@@ -0,0 +1,4 @@
+export { decomposeDrawing } from "./decompose.js";
+export { priceToY, timeToX, worldPointToPixel } from "./project.js";
+export type { DrawPrimitive, FillStyle, Point2, StrokeStyle, Viewport } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/geometry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/geometry/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/geometry/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+export { decomposeDrawing } from "./decompose.js";
+export { priceToY, timeToX, worldPointToPixel } from "./project.js";
+//# sourceMappingURL=index.js.map

package/dist/geometry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/geometry/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,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\nexport { decomposeDrawing } from \"./decompose.js\";\nexport { priceToY, timeToX, worldPointToPixel } from \"./project.js\";\nexport type { DrawPrimitive, FillStyle, Point2, StrokeStyle, Viewport } from \"./types.js\";\n"]}

package/dist/geometry/kinds/annotations.d.ts

@@ -0,0 +1,77 @@
+import type { ArrowMarkDownState, ArrowMarkUpState, ArrowMarkerState, ArrowState, TextState } from "@invinite-org/chartlang-core";
+import type { DrawPrimitive, Viewport } from "../types.js";
+/**
+ * Decompose a `text` drawing — a single label at the projected anchor,
+ * its font / alignment / colour resolved from `TextOpts`. `bgColor` is
+ * carried through onto the IR `text` primitive (adapters that can paint
+ * a background rect may use it; the canvas sink ignores it).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: TextState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeText(s, v);
+ *     // prims[0].kind === "text"
+ *     void prims;
+ */
+export declare function decomposeText(state: TextState, view: Viewport): ReadonlyArray<DrawPrimitive>;
+/**
+ * Decompose an `arrow` drawing — a stroked shaft, a filled arrowhead
+ * triangle at the head anchor, and an optional label at the shaft
+ * midpoint. Stroke and arrowhead fill share `style.color`.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: ArrowState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeArrow(s, v);
+ *     // prims[0].kind === "polyline"; prims[1].kind === "polyline"
+ *     void prims;
+ */
+export declare function decomposeArrow(state: ArrowState, view: Viewport): ReadonlyArray<DrawPrimitive>;
+/**
+ * Decompose an `arrow-marker` drawing — a self-contained compact glyph
+ * at the anchor: a filled dot, a short stub up + right, a filled
+ * arrowhead at the stub end, and optional text to the right. Default
+ * colour is `"#3b82f6"` (invinite toolbar blue).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: ArrowMarkerState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeArrowMarker(s, v);
+ *     void prims;
+ */
+export declare function decomposeArrowMarker(state: ArrowMarkerState, view: Viewport): ReadonlyArray<DrawPrimitive>;
+/**
+ * Decompose an `arrow-mark-up` drawing — a filled up-chevron glyph at
+ * the anchor. Default fill colour is `"#22c55e"` (green); an explicit
+ * `style.color` overrides.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: ArrowMarkUpState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeArrowMarkUp(s, v);
+ *     void prims;
+ */
+export declare function decomposeArrowMarkUp(state: ArrowMarkUpState, view: Viewport): ReadonlyArray<DrawPrimitive>;
+/**
+ * Decompose an `arrow-mark-down` drawing — a filled down-chevron glyph
+ * at the anchor. Default fill colour is `"#ef4444"` (red); an explicit
+ * `style.color` overrides.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: ArrowMarkDownState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeArrowMarkDown(s, v);
+ *     void prims;
+ */
+export declare function decomposeArrowMarkDown(state: ArrowMarkDownState, view: Viewport): ReadonlyArray<DrawPrimitive>;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/geometry/kinds/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../../src/geometry/kinds/annotations.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACR,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,SAAS,EACZ,MAAM,8BAA8B,CAAC;AAOtC,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiB3D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,aAAa,CAAC,aAAa,CAAC,CAgB5F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,aAAa,CAAC,aAAa,CAAC,CAmC9F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,QAAQ,GACf,aAAa,CAAC,aAAa,CAAC,CAyC9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,QAAQ,GACf,aAAa,CAAC,aAAa,CAAC,CAW9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAClC,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,QAAQ,GACf,aAAa,CAAC,aAAa,CAAC,CAW9B"}

package/dist/geometry/kinds/annotations.js

@@ -0,0 +1,219 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// Annotation geometry moved from the canvas2d adapter's per-kind
+// renderers
+//   examples/canvas2d-adapter/src/render/draw/{text,arrow,arrowMarker,
+//   arrowMarkUp,arrowMarkDown}.ts.
+// The originating math is invinite's text / arrow / arrow-marker /
+// arrow-mark-up / arrow-mark-down tools (commit
+// 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite); re-licensed
+// MIT for chartlang.
+import { arrowheadPolygon } from "../_lib/arrowhead.js";
+import { chevronPolygon } from "../_lib/chevron.js";
+import { dashPattern } from "../_lib/dash.js";
+import { resolveTextOpts } from "../_lib/textStyle.js";
+import { worldPointToPixel } from "../project.js";
+const DEFAULT_LINE_COLOR = "#000000";
+const DEFAULT_LINE_WIDTH = 1;
+const DEFAULT_ARROW_MARKER_COLOR = "#3b82f6"; // invinite toolbar blue
+const DEFAULT_MARK_UP_COLOR = "#22c55e";
+const DEFAULT_MARK_DOWN_COLOR = "#ef4444";
+const SOLID_FILL_ALPHA = 1;
+const ARROW_LABEL_FONT = "12px sans-serif";
+const ARROW_LABEL_VERTICAL_OFFSET = 4;
+const MARKER_DOT_RADIUS = 3;
+const MARKER_STUB_DX = 16;
+const MARKER_STUB_DY = -8;
+const MARKER_TEXT_OFFSET_X = 6;
+const MARKER_TEXT_FONT = "12px sans-serif";
+const TWO_PI = Math.PI * 2;
+/**
+ * Decompose a `text` drawing — a single label at the projected anchor,
+ * its font / alignment / colour resolved from `TextOpts`. `bgColor` is
+ * carried through onto the IR `text` primitive (adapters that can paint
+ * a background rect may use it; the canvas sink ignores it).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: TextState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeText(s, v);
+ *     // prims[0].kind === "text"
+ *     void prims;
+ */
+export function decomposeText(state, view) {
+    const anchor = worldPointToPixel(state.anchor, view);
+    const resolved = resolveTextOpts(state.style);
+    return [
+        {
+            kind: "text",
+            x: anchor.x,
+            y: anchor.y,
+            text: state.body,
+            color: resolved.color,
+            font: resolved.font,
+            align: resolved.align,
+            baseline: resolved.baseline,
+            ...(state.style.bgColor === undefined ? {} : { bgColor: state.style.bgColor }),
+        },
+    ];
+}
+/**
+ * Decompose an `arrow` drawing — a stroked shaft, a filled arrowhead
+ * triangle at the head anchor, and an optional label at the shaft
+ * midpoint. Stroke and arrowhead fill share `style.color`.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: ArrowState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeArrow(s, v);
+ *     // prims[0].kind === "polyline"; prims[1].kind === "polyline"
+ *     void prims;
+ */
+export function decomposeArrow(state, view) {
+    const from = worldPointToPixel(state.anchors[0], view);
+    const to = worldPointToPixel(state.anchors[1], view);
+    const color = state.style.color ?? DEFAULT_LINE_COLOR;
+    const out = [
+        {
+            kind: "polyline",
+            points: [from, to],
+            closed: false,
+            stroke: {
+                color,
+                width: state.style.lineWidth ?? DEFAULT_LINE_WIDTH,
+                dash: dashPattern(state.style.lineStyle ?? "solid"),
+            },
+        },
+        {
+            kind: "polyline",
+            points: arrowheadPolygon(from, to),
+            closed: true,
+            fill: { color, alpha: SOLID_FILL_ALPHA },
+        },
+    ];
+    if (state.style.label !== undefined) {
+        out.push({
+            kind: "text",
+            x: (from.x + to.x) / 2,
+            y: (from.y + to.y) / 2 - ARROW_LABEL_VERTICAL_OFFSET,
+            text: state.style.label,
+            color,
+            font: ARROW_LABEL_FONT,
+            align: "center",
+            baseline: "bottom",
+        });
+    }
+    return out;
+}
+/**
+ * Decompose an `arrow-marker` drawing — a self-contained compact glyph
+ * at the anchor: a filled dot, a short stub up + right, a filled
+ * arrowhead at the stub end, and optional text to the right. Default
+ * colour is `"#3b82f6"` (invinite toolbar blue).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: ArrowMarkerState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeArrowMarker(s, v);
+ *     void prims;
+ */
+export function decomposeArrowMarker(state, view) {
+    const anchor = worldPointToPixel(state.anchor, view);
+    const color = state.style.color ?? DEFAULT_ARROW_MARKER_COLOR;
+    const stubEnd = { x: anchor.x + MARKER_STUB_DX, y: anchor.y + MARKER_STUB_DY };
+    const out = [
+        {
+            kind: "arc",
+            cx: anchor.x,
+            cy: anchor.y,
+            r: MARKER_DOT_RADIUS,
+            start: 0,
+            end: TWO_PI,
+            closed: false,
+            fill: { color, alpha: SOLID_FILL_ALPHA },
+        },
+        {
+            kind: "polyline",
+            points: [anchor, stubEnd],
+            closed: false,
+            stroke: { color, width: DEFAULT_LINE_WIDTH, dash: dashPattern("solid") },
+        },
+        {
+            kind: "polyline",
+            points: arrowheadPolygon(anchor, stubEnd),
+            closed: true,
+            fill: { color, alpha: SOLID_FILL_ALPHA },
+        },
+    ];
+    if (state.style.text !== undefined) {
+        out.push({
+            kind: "text",
+            x: anchor.x + MARKER_TEXT_OFFSET_X,
+            y: anchor.y,
+            text: state.style.text,
+            color,
+            font: MARKER_TEXT_FONT,
+            align: "left",
+            baseline: "middle",
+        });
+    }
+    return out;
+}
+/**
+ * Decompose an `arrow-mark-up` drawing — a filled up-chevron glyph at
+ * the anchor. Default fill colour is `"#22c55e"` (green); an explicit
+ * `style.color` overrides.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: ArrowMarkUpState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeArrowMarkUp(s, v);
+ *     void prims;
+ */
+export function decomposeArrowMarkUp(state, view) {
+    const anchor = worldPointToPixel(state.anchor, view);
+    const color = state.style.color ?? DEFAULT_MARK_UP_COLOR;
+    return [
+        {
+            kind: "polyline",
+            points: chevronPolygon(anchor, "up"),
+            closed: true,
+            fill: { color, alpha: SOLID_FILL_ALPHA },
+        },
+    ];
+}
+/**
+ * Decompose an `arrow-mark-down` drawing — a filled down-chevron glyph
+ * at the anchor. Default fill colour is `"#ef4444"` (red); an explicit
+ * `style.color` overrides.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: ArrowMarkDownState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeArrowMarkDown(s, v);
+ *     void prims;
+ */
+export function decomposeArrowMarkDown(state, view) {
+    const anchor = worldPointToPixel(state.anchor, view);
+    const color = state.style.color ?? DEFAULT_MARK_DOWN_COLOR;
+    return [
+        {
+            kind: "polyline",
+            points: chevronPolygon(anchor, "down"),
+            closed: true,
+            fill: { color, alpha: SOLID_FILL_ALPHA },
+        },
+    ];
+}
+//# sourceMappingURL=annotations.js.map

package/dist/geometry/kinds/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../../src/geometry/kinds/annotations.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,iEAAiE;AACjE,YAAY;AACZ,uEAAuE;AACvE,mCAAmC;AACnC,mEAAmE;AACnE,gDAAgD;AAChD,qEAAqE;AACrE,qBAAqB;AAUrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,kBAAkB,GAAG,SAAS,CAAC;AACrC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,0BAA0B,GAAG,SAAS,CAAC,CAAC,wBAAwB;AACtE,MAAM,qBAAqB,GAAG,SAAS,CAAC;AACxC,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAC1C,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAC3C,MAAM,2BAA2B,GAAG,CAAC,CAAC;AACtC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,cAAc,GAAG,CAAC,CAAC,CAAC;AAC1B,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;AAE3B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgB,EAAE,IAAc;IAC1D,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO;QACH;YACI,IAAI,EAAE,MAAM;YACZ,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;SACjF;KACJ,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,IAAc;IAC5D,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACvD,MAAM,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,kBAAkB,CAAC;IACtD,MAAM,GAAG,GAAoB;QACzB;YACI,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YAClB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE;gBACJ,KAAK;gBACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,IAAI,kBAAkB;gBAClD,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC;aACtD;SACJ;QACD;YACI,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE;SAC3C;KACJ,CAAC;IACF,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAClC,GAAG,CAAC,IAAI,CAAC;YACL,IAAI,EAAE,MAAM;YACZ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YACtB,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,2BAA2B;YACpD,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK;YACvB,KAAK;YACL,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,QAAQ;SACrB,CAAC,CAAC;IACP,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAChC,KAAuB,EACvB,IAAc;IAEd,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,0BAA0B,CAAC;IAC9D,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,cAAc,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,cAAc,EAAE,CAAC;IAC/E,MAAM,GAAG,GAAoB;QACzB;YACI,IAAI,EAAE,KAAK;YACX,EAAE,EAAE,MAAM,CAAC,CAAC;YACZ,EAAE,EAAE,MAAM,CAAC,CAAC;YACZ,CAAC,EAAE,iBAAiB;YACpB,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,MAAM;YACX,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE;SAC3C;QACD;YACI,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;YACzB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE;SAC3E;QACD;YACI,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC;YACzC,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE;SAC3C;KACJ,CAAC;IACF,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC;YACL,IAAI,EAAE,MAAM;YACZ,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,oBAAoB;YAClC,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;YACtB,KAAK;YACL,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,QAAQ;SACrB,CAAC,CAAC;IACP,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAChC,KAAuB,EACvB,IAAc;IAEd,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,qBAAqB,CAAC;IACzD,OAAO;QACH;YACI,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC;YACpC,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE;SAC3C;KACJ,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CAClC,KAAyB,EACzB,IAAc;IAEd,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,uBAAuB,CAAC;IAC3D,OAAO;QACH;YACI,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC;YACtC,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE;SAC3C;KACJ,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// Annotation geometry moved from the canvas2d adapter's per-kind\n// renderers\n//   examples/canvas2d-adapter/src/render/draw/{text,arrow,arrowMarker,\n//   arrowMarkUp,arrowMarkDown}.ts.\n// The originating math is invinite's text / arrow / arrow-marker /\n// arrow-mark-up / arrow-mark-down tools (commit\n// 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite); re-licensed\n// MIT for chartlang.\n\nimport type {\n    ArrowMarkDownState,\n    ArrowMarkUpState,\n    ArrowMarkerState,\n    ArrowState,\n    TextState,\n} from \"@invinite-org/chartlang-core\";\n\nimport { arrowheadPolygon } from \"../_lib/arrowhead.js\";\nimport { chevronPolygon } from \"../_lib/chevron.js\";\nimport { dashPattern } from \"../_lib/dash.js\";\nimport { resolveTextOpts } from \"../_lib/textStyle.js\";\nimport { worldPointToPixel } from \"../project.js\";\nimport type { DrawPrimitive, Viewport } from \"../types.js\";\n\nconst DEFAULT_LINE_COLOR = \"#000000\";\nconst DEFAULT_LINE_WIDTH = 1;\nconst DEFAULT_ARROW_MARKER_COLOR = \"#3b82f6\"; // invinite toolbar blue\nconst DEFAULT_MARK_UP_COLOR = \"#22c55e\";\nconst DEFAULT_MARK_DOWN_COLOR = \"#ef4444\";\nconst SOLID_FILL_ALPHA = 1;\nconst ARROW_LABEL_FONT = \"12px sans-serif\";\nconst ARROW_LABEL_VERTICAL_OFFSET = 4;\nconst MARKER_DOT_RADIUS = 3;\nconst MARKER_STUB_DX = 16;\nconst MARKER_STUB_DY = -8;\nconst MARKER_TEXT_OFFSET_X = 6;\nconst MARKER_TEXT_FONT = \"12px sans-serif\";\nconst TWO_PI = Math.PI * 2;\n\n/**\n * Decompose a `text` drawing — a single label at the projected anchor,\n * its font / alignment / colour resolved from `TextOpts`. `bgColor` is\n * carried through onto the IR `text` primitive (adapters that can paint\n * a background rect may use it; the canvas sink ignores it).\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: TextState;\n *     declare const v: Viewport;\n *     const prims = decomposeText(s, v);\n *     // prims[0].kind === \"text\"\n *     void prims;\n */\nexport function decomposeText(state: TextState, view: Viewport): ReadonlyArray<DrawPrimitive> {\n    const anchor = worldPointToPixel(state.anchor, view);\n    const resolved = resolveTextOpts(state.style);\n    return [\n        {\n            kind: \"text\",\n            x: anchor.x,\n            y: anchor.y,\n            text: state.body,\n            color: resolved.color,\n            font: resolved.font,\n            align: resolved.align,\n            baseline: resolved.baseline,\n            ...(state.style.bgColor === undefined ? {} : { bgColor: state.style.bgColor }),\n        },\n    ];\n}\n\n/**\n * Decompose an `arrow` drawing — a stroked shaft, a filled arrowhead\n * triangle at the head anchor, and an optional label at the shaft\n * midpoint. Stroke and arrowhead fill share `style.color`.\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: ArrowState;\n *     declare const v: Viewport;\n *     const prims = decomposeArrow(s, v);\n *     // prims[0].kind === \"polyline\"; prims[1].kind === \"polyline\"\n *     void prims;\n */\nexport function decomposeArrow(state: ArrowState, view: Viewport): ReadonlyArray<DrawPrimitive> {\n    const from = worldPointToPixel(state.anchors[0], view);\n    const to = worldPointToPixel(state.anchors[1], view);\n    const color = state.style.color ?? DEFAULT_LINE_COLOR;\n    const out: DrawPrimitive[] = [\n        {\n            kind: \"polyline\",\n            points: [from, to],\n            closed: false,\n            stroke: {\n                color,\n                width: state.style.lineWidth ?? DEFAULT_LINE_WIDTH,\n                dash: dashPattern(state.style.lineStyle ?? \"solid\"),\n            },\n        },\n        {\n            kind: \"polyline\",\n            points: arrowheadPolygon(from, to),\n            closed: true,\n            fill: { color, alpha: SOLID_FILL_ALPHA },\n        },\n    ];\n    if (state.style.label !== undefined) {\n        out.push({\n            kind: \"text\",\n            x: (from.x + to.x) / 2,\n            y: (from.y + to.y) / 2 - ARROW_LABEL_VERTICAL_OFFSET,\n            text: state.style.label,\n            color,\n            font: ARROW_LABEL_FONT,\n            align: \"center\",\n            baseline: \"bottom\",\n        });\n    }\n    return out;\n}\n\n/**\n * Decompose an `arrow-marker` drawing — a self-contained compact glyph\n * at the anchor: a filled dot, a short stub up + right, a filled\n * arrowhead at the stub end, and optional text to the right. Default\n * colour is `\"#3b82f6\"` (invinite toolbar blue).\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: ArrowMarkerState;\n *     declare const v: Viewport;\n *     const prims = decomposeArrowMarker(s, v);\n *     void prims;\n */\nexport function decomposeArrowMarker(\n    state: ArrowMarkerState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const anchor = worldPointToPixel(state.anchor, view);\n    const color = state.style.color ?? DEFAULT_ARROW_MARKER_COLOR;\n    const stubEnd = { x: anchor.x + MARKER_STUB_DX, y: anchor.y + MARKER_STUB_DY };\n    const out: DrawPrimitive[] = [\n        {\n            kind: \"arc\",\n            cx: anchor.x,\n            cy: anchor.y,\n            r: MARKER_DOT_RADIUS,\n            start: 0,\n            end: TWO_PI,\n            closed: false,\n            fill: { color, alpha: SOLID_FILL_ALPHA },\n        },\n        {\n            kind: \"polyline\",\n            points: [anchor, stubEnd],\n            closed: false,\n            stroke: { color, width: DEFAULT_LINE_WIDTH, dash: dashPattern(\"solid\") },\n        },\n        {\n            kind: \"polyline\",\n            points: arrowheadPolygon(anchor, stubEnd),\n            closed: true,\n            fill: { color, alpha: SOLID_FILL_ALPHA },\n        },\n    ];\n    if (state.style.text !== undefined) {\n        out.push({\n            kind: \"text\",\n            x: anchor.x + MARKER_TEXT_OFFSET_X,\n            y: anchor.y,\n            text: state.style.text,\n            color,\n            font: MARKER_TEXT_FONT,\n            align: \"left\",\n            baseline: \"middle\",\n        });\n    }\n    return out;\n}\n\n/**\n * Decompose an `arrow-mark-up` drawing — a filled up-chevron glyph at\n * the anchor. Default fill colour is `\"#22c55e\"` (green); an explicit\n * `style.color` overrides.\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: ArrowMarkUpState;\n *     declare const v: Viewport;\n *     const prims = decomposeArrowMarkUp(s, v);\n *     void prims;\n */\nexport function decomposeArrowMarkUp(\n    state: ArrowMarkUpState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const anchor = worldPointToPixel(state.anchor, view);\n    const color = state.style.color ?? DEFAULT_MARK_UP_COLOR;\n    return [\n        {\n            kind: \"polyline\",\n            points: chevronPolygon(anchor, \"up\"),\n            closed: true,\n            fill: { color, alpha: SOLID_FILL_ALPHA },\n        },\n    ];\n}\n\n/**\n * Decompose an `arrow-mark-down` drawing — a filled down-chevron glyph\n * at the anchor. Default fill colour is `\"#ef4444\"` (red); an explicit\n * `style.color` overrides.\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: ArrowMarkDownState;\n *     declare const v: Viewport;\n *     const prims = decomposeArrowMarkDown(s, v);\n *     void prims;\n */\nexport function decomposeArrowMarkDown(\n    state: ArrowMarkDownState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const anchor = worldPointToPixel(state.anchor, view);\n    const color = state.style.color ?? DEFAULT_MARK_DOWN_COLOR;\n    return [\n        {\n            kind: \"polyline\",\n            points: chevronPolygon(anchor, \"down\"),\n            closed: true,\n            fill: { color, alpha: SOLID_FILL_ALPHA },\n        },\n    ];\n}\n"]}