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

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

@@ -0,0 +1 @@
+{"version":3,"file":"boxes.js","sourceRoot":"","sources":["../../../src/geometry/kinds/boxes.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//\n// Stroke + fill geometry moved from the canvas2d adapter's per-kind\n// shape renderers\n//   examples/canvas2d-adapter/src/render/draw/{rectangle,\n//   rotatedRectangle,triangle,polyline,circle,ellipse,path,\n//   fillBetween}.ts.\n// The originating math is invinite's rectangle / rotated-rectangle /\n// triangle / polyline / circle / ellipse / path tools (commit\n// 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite); re-licensed\n// MIT for chartlang.\n\nimport type {\n    CircleState,\n    EllipseState,\n    FillBetweenState,\n    PathState,\n    PolylineState,\n    RectangleState,\n    RotatedRectangleState,\n    TriangleState,\n} from \"@invinite-org/chartlang-core\";\n\nimport { dashPattern } from \"../_lib/dash.js\";\nimport { resolveShapeStyle } from \"../_lib/shapeStyle.js\";\nimport { worldPointToPixel } from \"../project.js\";\nimport type { DrawPrimitive, Point2, Viewport } from \"../types.js\";\n\nconst DEFAULT_LINE_WIDTH = 1;\nconst DEFAULT_FILL_ALPHA = 1;\nconst TWO_PI = Math.PI * 2;\n\n/**\n * Number of polyline segments used to approximate an `ellipse`. 64\n * segments give visually smooth strokes at typical viewport widths\n * (≈800 px) while keeping the primitive list bounded — matching the\n * canvas2d source renderer exactly.\n */\nconst ELLIPSE_SEGMENTS = 64;\n\n/**\n * Decompose a `rectangle` drawing — a closed 4-corner polygon derived\n * from the axis-aligned bounding box of the two projected anchors.\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: RectangleState;\n *     declare const v: Viewport;\n *     const prims = decomposeRectangle(s, v);\n *     // prims[0].kind === \"polyline\"; prims[0].closed === true\n *     void prims;\n */\nexport function decomposeRectangle(\n    state: RectangleState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const a = worldPointToPixel(state.anchors[0], view);\n    const b = worldPointToPixel(state.anchors[1], view);\n    const xMin = Math.min(a.x, b.x);\n    const xMax = Math.max(a.x, b.x);\n    const yMin = Math.min(a.y, b.y);\n    const yMax = Math.max(a.y, b.y);\n    const { stroke, fill } = resolveShapeStyle(state.style);\n    return [\n        {\n            kind: \"polyline\",\n            points: [\n                { x: xMin, y: yMin },\n                { x: xMax, y: yMin },\n                { x: xMax, y: yMax },\n                { x: xMin, y: yMax },\n            ],\n            closed: true,\n            stroke,\n            ...(fill === undefined ? {} : { fill }),\n        },\n    ];\n}\n\n/**\n * Decompose a `rotated-rectangle` drawing — a closed polygon through\n * the four projected anchors (carried in stroke order, so no matrix\n * math is needed).\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: RotatedRectangleState;\n *     declare const v: Viewport;\n *     const prims = decomposeRotatedRectangle(s, v);\n *     void prims;\n */\nexport function decomposeRotatedRectangle(\n    state: RotatedRectangleState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const points = state.anchors.map((p) => worldPointToPixel(p, view));\n    const { stroke, fill } = resolveShapeStyle(state.style);\n    return [\n        {\n            kind: \"polyline\",\n            points,\n            closed: true,\n            stroke,\n            ...(fill === undefined ? {} : { fill }),\n        },\n    ];\n}\n\n/**\n * Decompose a `triangle` drawing — a closed 3-vertex polygon.\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: TriangleState;\n *     declare const v: Viewport;\n *     const prims = decomposeTriangle(s, v);\n *     void prims;\n */\nexport function decomposeTriangle(\n    state: TriangleState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const points = state.anchors.map((p) => worldPointToPixel(p, view));\n    const { stroke, fill } = resolveShapeStyle(state.style);\n    return [\n        {\n            kind: \"polyline\",\n            points,\n            closed: true,\n            stroke,\n            ...(fill === undefined ? {} : { fill }),\n        },\n    ];\n}\n\n/**\n * Decompose a `polyline` drawing — a closed N-vertex polyline carrying\n * a `LineDrawStyle` (no fill).\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: PolylineState;\n *     declare const v: Viewport;\n *     const prims = decomposePolyline(s, v);\n *     // prims[0].closed === true\n *     void prims;\n */\nexport function decomposePolyline(\n    state: PolylineState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const points = state.anchors.map((p) => worldPointToPixel(p, view));\n    return [\n        {\n            kind: \"polyline\",\n            points,\n            closed: true,\n            stroke: {\n                color: state.style.color ?? \"#000000\",\n                width: state.style.lineWidth ?? DEFAULT_LINE_WIDTH,\n                dash: dashPattern(state.style.lineStyle ?? \"solid\"),\n            },\n        },\n    ];\n}\n\n/**\n * Decompose a `circle` drawing — an arc whose radius is the projected\n * pixel distance between the centre anchor and the radius anchor (so\n * the stroke keeps the same apparent thickness across zoom changes).\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: CircleState;\n *     declare const v: Viewport;\n *     const prims = decomposeCircle(s, v);\n *     // prims[0].kind === \"arc\"\n *     void prims;\n */\nexport function decomposeCircle(state: CircleState, view: Viewport): ReadonlyArray<DrawPrimitive> {\n    const centre = worldPointToPixel(state.anchors[0], view);\n    const edge = worldPointToPixel(state.anchors[1], view);\n    const radius = Math.hypot(edge.x - centre.x, edge.y - centre.y);\n    const { stroke, fill } = resolveShapeStyle(state.style);\n    return [\n        {\n            kind: \"arc\",\n            cx: centre.x,\n            cy: centre.y,\n            r: radius,\n            start: 0,\n            end: TWO_PI,\n            closed: true,\n            stroke,\n            ...(fill === undefined ? {} : { fill }),\n        },\n    ];\n}\n\n/**\n * Decompose an axis-aligned `ellipse` drawing — a closed\n * {@link ELLIPSE_SEGMENTS}-segment polyline inscribed in the bounding\n * box of the two anchors. Rotated ellipses are out of scope.\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: EllipseState;\n *     declare const v: Viewport;\n *     const prims = decomposeEllipse(s, v);\n *     void prims;\n */\nexport function decomposeEllipse(\n    state: EllipseState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const a = worldPointToPixel(state.anchors[0], view);\n    const b = worldPointToPixel(state.anchors[1], view);\n    const cx = (a.x + b.x) / 2;\n    const cy = (a.y + b.y) / 2;\n    const rx = Math.abs(b.x - a.x) / 2;\n    const ry = Math.abs(b.y - a.y) / 2;\n    const points: Point2[] = [{ x: cx + rx, y: cy }];\n    for (let i = 1; i < ELLIPSE_SEGMENTS; i++) {\n        const theta = (i / ELLIPSE_SEGMENTS) * TWO_PI;\n        points.push({ x: cx + rx * Math.cos(theta), y: cy + ry * Math.sin(theta) });\n    }\n    const { stroke, fill } = resolveShapeStyle(state.style);\n    return [\n        {\n            kind: \"polyline\",\n            points,\n            closed: true,\n            stroke,\n            ...(fill === undefined ? {} : { fill }),\n        },\n    ];\n}\n\n/**\n * Decompose a `path` drawing — an OPEN N-vertex polyline (unless\n * `style.closed === true`) carrying a `PathOpts` style (no fill).\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: PathState;\n *     declare const v: Viewport;\n *     const prims = decomposePath(s, v);\n *     void prims;\n */\nexport function decomposePath(state: PathState, view: Viewport): ReadonlyArray<DrawPrimitive> {\n    const points = state.anchors.map((p) => worldPointToPixel(p, view));\n    return [\n        {\n            kind: \"polyline\",\n            points,\n            closed: state.style.closed === true,\n            stroke: {\n                color: state.style.color ?? \"#000000\",\n                width: state.style.lineWidth ?? DEFAULT_LINE_WIDTH,\n                dash: dashPattern(state.style.lineStyle ?? \"solid\"),\n            },\n        },\n    ];\n}\n\n/**\n * Decompose a `fill-between` drawing — a closed filled polygon walking\n * `edgeA` forward then `edgeB` in reverse. The optional outline strokes\n * only when `style.color` is set; the band fills only when `style.fill`\n * is set. A degenerate edge (`< 1` point) or a non-finite mapped anchor\n * is a silent no-op (returns `[]`), matching the source renderer's\n * warmup behaviour.\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: FillBetweenState;\n *     declare const v: Viewport;\n *     const prims = decomposeFillBetween(s, v);\n *     void prims;\n */\nexport function decomposeFillBetween(\n    state: FillBetweenState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const a = state.edgeA.map((p) => worldPointToPixel(p, view));\n    const b = state.edgeB.map((p) => worldPointToPixel(p, view));\n    if (a.length < 1 || b.length < 1) return [];\n    if (a.some((p) => !Number.isFinite(p.x) || !Number.isFinite(p.y))) return [];\n    if (b.some((p) => !Number.isFinite(p.x) || !Number.isFinite(p.y))) return [];\n    const points: Point2[] = [...a];\n    for (let i = b.length - 1; i >= 0; i--) points.push(b[i]);\n    const { color, fill } = state.style;\n    return [\n        {\n            kind: \"polyline\",\n            points,\n            closed: true,\n            ...(color === undefined\n                ? {}\n                : {\n                      stroke: {\n                          color,\n                          width: state.style.lineWidth ?? DEFAULT_LINE_WIDTH,\n                          dash: dashPattern(state.style.lineStyle ?? \"solid\"),\n                      },\n                  }),\n            ...(fill === undefined\n                ? {}\n                : { fill: { color: fill, alpha: state.style.fillAlpha ?? DEFAULT_FILL_ALPHA } }),\n        },\n    ];\n}\n"]}

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

@@ -0,0 +1,72 @@
+import type { DisjointChannelState, FlatTopBottomState, RegressionTrendState, TrendChannelState } from "@invinite-org/chartlang-core";
+import type { DrawPrimitive, Viewport } from "../types.js";
+/**
+ * Decompose a `trend-channel` drawing — two parallel line segments. The
+ * primary rail runs `anchors[0]` → `anchors[1]`; the second rail is its
+ * translate by the offset vector `anchors[2] − anchors[0]`, keeping the
+ * pair strictly parallel. Stroke-only — `LineDrawStyle` carries no fill,
+ * so there is no inter-rail band (matching the canvas2d source).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: TrendChannelState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeTrendChannel(s, v);
+ *     // prims.length === 2
+ *     void prims;
+ */
+export declare function decomposeTrendChannel(state: TrendChannelState, view: Viewport): ReadonlyArray<DrawPrimitive>;
+/**
+ * Decompose a `flat-top-bottom` drawing — two horizontal rails. The top
+ * rail sits at `max(anchors[0].price, anchors[2].price)` and the bottom
+ * at `min(...)`; both span the time range `anchors[0].time` →
+ * `anchors[1].time`. Stroke-only.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: FlatTopBottomState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeFlatTopBottom(s, v);
+ *     // prims.length === 2
+ *     void prims;
+ */
+export declare function decomposeFlatTopBottom(state: FlatTopBottomState, view: Viewport): ReadonlyArray<DrawPrimitive>;
+/**
+ * Decompose a `disjoint-channel` drawing — two independent line segments
+ * with no shared geometry constraint: `anchors[0]` → `anchors[1]` and
+ * `anchors[2]` → `anchors[3]`. Stroke-only.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: DisjointChannelState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeDisjointChannel(s, v);
+ *     // prims.length === 2
+ *     void prims;
+ */
+export declare function decomposeDisjointChannel(state: DisjointChannelState, view: Viewport): ReadonlyArray<DrawPrimitive>;
+/**
+ * Decompose a `regression-trend` drawing — a single placeholder line
+ * between the two anchors, colour `style.color ?? "#3b82f6"`, width 1,
+ * solid. The OLS fit + ±σ bands the `RegressionTrendOpts` flags
+ * (`source` / `stdevMultiplier` / `showUpperBand` / `showLowerBand`)
+ * describe require a bar buffer the `Viewport` does not expose and band
+ * anchors the 2-point `state.anchors` does not carry; the canvas2d
+ * source renders the same placeholder line, so this decomposer preserves
+ * that geometry. Those style fields are accepted but unused here —
+ * consumer adapters with a bar buffer can compute the fit themselves.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: RegressionTrendState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeRegressionTrend(s, v);
+ *     // prims.length === 1; prims[0].kind === "polyline"
+ *     void prims;
+ */
+export declare function decomposeRegressionTrend(state: RegressionTrendState, view: Viewport): ReadonlyArray<DrawPrimitive>;
+//# sourceMappingURL=channels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../../src/geometry/kinds/channels.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACR,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACpB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAU3D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,QAAQ,GACf,aAAa,CAAC,aAAa,CAAC,CAmB9B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAClC,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,QAAQ,GACf,aAAa,CAAC,aAAa,CAAC,CAe9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,IAAI,EAAE,QAAQ,GACf,aAAa,CAAC,aAAa,CAAC,CAU9B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,IAAI,EAAE,QAAQ,GACf,aAAa,CAAC,aAAa,CAAC,CAe9B"}

package/dist/geometry/kinds/channels.js

@@ -0,0 +1,148 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// Channel geometry moved from the canvas2d adapter's per-kind renderers
+//   examples/canvas2d-adapter/src/render/draw/{trendChannel,
+//   flatTopBottom,disjointChannel,regressionTrend}.ts.
+// The originating math is invinite's trend-channel / flat-top-bottom /
+// disjoint-channel / regression-trend tools (commit
+// 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite); re-licensed
+// MIT for chartlang.
+import { dashPattern } from "../_lib/dash.js";
+import { strokeOf } from "../_lib/strokeStyle.js";
+import { worldPointToPixel } from "../project.js";
+const DEFAULT_LINE_WIDTH = 1;
+/**
+ * Default stroke colour of a `regression-trend` placeholder line —
+ * `#3b82f6`, matching the canvas2d source renderer.
+ */
+const REGRESSION_DEFAULT_COLOR = "#3b82f6";
+/**
+ * Decompose a `trend-channel` drawing — two parallel line segments. The
+ * primary rail runs `anchors[0]` → `anchors[1]`; the second rail is its
+ * translate by the offset vector `anchors[2] − anchors[0]`, keeping the
+ * pair strictly parallel. Stroke-only — `LineDrawStyle` carries no fill,
+ * so there is no inter-rail band (matching the canvas2d source).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: TrendChannelState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeTrendChannel(s, v);
+ *     // prims.length === 2
+ *     void prims;
+ */
+export function decomposeTrendChannel(state, view) {
+    const a = worldPointToPixel(state.anchors[0], view);
+    const b = worldPointToPixel(state.anchors[1], view);
+    const hook = worldPointToPixel(state.anchors[2], view);
+    const dx = hook.x - a.x;
+    const dy = hook.y - a.y;
+    const stroke = strokeOf(state.style);
+    return [
+        { kind: "polyline", points: [a, b], closed: false, stroke },
+        {
+            kind: "polyline",
+            points: [
+                { x: a.x + dx, y: a.y + dy },
+                { x: b.x + dx, y: b.y + dy },
+            ],
+            closed: false,
+            stroke,
+        },
+    ];
+}
+/**
+ * Decompose a `flat-top-bottom` drawing — two horizontal rails. The top
+ * rail sits at `max(anchors[0].price, anchors[2].price)` and the bottom
+ * at `min(...)`; both span the time range `anchors[0].time` →
+ * `anchors[1].time`. Stroke-only.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: FlatTopBottomState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeFlatTopBottom(s, v);
+ *     // prims.length === 2
+ *     void prims;
+ */
+export function decomposeFlatTopBottom(state, view) {
+    const p0 = state.anchors[0];
+    const p1 = state.anchors[1];
+    const p2 = state.anchors[2];
+    const topPrice = Math.max(p0.price, p2.price);
+    const bottomPrice = Math.min(p0.price, p2.price);
+    const topLeft = worldPointToPixel({ time: p0.time, price: topPrice }, view);
+    const topRight = worldPointToPixel({ time: p1.time, price: topPrice }, view);
+    const bottomLeft = worldPointToPixel({ time: p0.time, price: bottomPrice }, view);
+    const bottomRight = worldPointToPixel({ time: p1.time, price: bottomPrice }, view);
+    const stroke = strokeOf(state.style);
+    return [
+        { kind: "polyline", points: [topLeft, topRight], closed: false, stroke },
+        { kind: "polyline", points: [bottomLeft, bottomRight], closed: false, stroke },
+    ];
+}
+/**
+ * Decompose a `disjoint-channel` drawing — two independent line segments
+ * with no shared geometry constraint: `anchors[0]` → `anchors[1]` and
+ * `anchors[2]` → `anchors[3]`. Stroke-only.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: DisjointChannelState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeDisjointChannel(s, v);
+ *     // prims.length === 2
+ *     void prims;
+ */
+export function decomposeDisjointChannel(state, view) {
+    const a = worldPointToPixel(state.anchors[0], view);
+    const b = worldPointToPixel(state.anchors[1], view);
+    const c = worldPointToPixel(state.anchors[2], view);
+    const d = worldPointToPixel(state.anchors[3], view);
+    const stroke = strokeOf(state.style);
+    return [
+        { kind: "polyline", points: [a, b], closed: false, stroke },
+        { kind: "polyline", points: [c, d], closed: false, stroke },
+    ];
+}
+/**
+ * Decompose a `regression-trend` drawing — a single placeholder line
+ * between the two anchors, colour `style.color ?? "#3b82f6"`, width 1,
+ * solid. The OLS fit + ±σ bands the `RegressionTrendOpts` flags
+ * (`source` / `stdevMultiplier` / `showUpperBand` / `showLowerBand`)
+ * describe require a bar buffer the `Viewport` does not expose and band
+ * anchors the 2-point `state.anchors` does not carry; the canvas2d
+ * source renders the same placeholder line, so this decomposer preserves
+ * that geometry. Those style fields are accepted but unused here —
+ * consumer adapters with a bar buffer can compute the fit themselves.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: RegressionTrendState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeRegressionTrend(s, v);
+ *     // prims.length === 1; prims[0].kind === "polyline"
+ *     void prims;
+ */
+export function decomposeRegressionTrend(state, view) {
+    const a = worldPointToPixel(state.anchors[0], view);
+    const b = worldPointToPixel(state.anchors[1], view);
+    return [
+        {
+            kind: "polyline",
+            points: [a, b],
+            closed: false,
+            stroke: {
+                color: state.style.color ?? REGRESSION_DEFAULT_COLOR,
+                width: DEFAULT_LINE_WIDTH,
+                dash: dashPattern("solid"),
+            },
+        },
+    ];
+}
+//# sourceMappingURL=channels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../../src/geometry/kinds/channels.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//\n// Channel geometry moved from the canvas2d adapter's per-kind renderers\n//   examples/canvas2d-adapter/src/render/draw/{trendChannel,\n//   flatTopBottom,disjointChannel,regressionTrend}.ts.\n// The originating math is invinite's trend-channel / flat-top-bottom /\n// disjoint-channel / regression-trend tools (commit\n// 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite); re-licensed\n// MIT for chartlang.\n\nimport type {\n    DisjointChannelState,\n    FlatTopBottomState,\n    RegressionTrendState,\n    TrendChannelState,\n} from \"@invinite-org/chartlang-core\";\n\nimport { dashPattern } from \"../_lib/dash.js\";\nimport { strokeOf } from \"../_lib/strokeStyle.js\";\nimport { worldPointToPixel } from \"../project.js\";\nimport type { DrawPrimitive, Viewport } from \"../types.js\";\n\nconst DEFAULT_LINE_WIDTH = 1;\n\n/**\n * Default stroke colour of a `regression-trend` placeholder line —\n * `#3b82f6`, matching the canvas2d source renderer.\n */\nconst REGRESSION_DEFAULT_COLOR = \"#3b82f6\";\n\n/**\n * Decompose a `trend-channel` drawing — two parallel line segments. The\n * primary rail runs `anchors[0]` → `anchors[1]`; the second rail is its\n * translate by the offset vector `anchors[2] − anchors[0]`, keeping the\n * pair strictly parallel. Stroke-only — `LineDrawStyle` carries no fill,\n * so there is no inter-rail band (matching the canvas2d source).\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: TrendChannelState;\n *     declare const v: Viewport;\n *     const prims = decomposeTrendChannel(s, v);\n *     // prims.length === 2\n *     void prims;\n */\nexport function decomposeTrendChannel(\n    state: TrendChannelState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const a = worldPointToPixel(state.anchors[0], view);\n    const b = worldPointToPixel(state.anchors[1], view);\n    const hook = worldPointToPixel(state.anchors[2], view);\n    const dx = hook.x - a.x;\n    const dy = hook.y - a.y;\n    const stroke = strokeOf(state.style);\n    return [\n        { kind: \"polyline\", points: [a, b], closed: false, stroke },\n        {\n            kind: \"polyline\",\n            points: [\n                { x: a.x + dx, y: a.y + dy },\n                { x: b.x + dx, y: b.y + dy },\n            ],\n            closed: false,\n            stroke,\n        },\n    ];\n}\n\n/**\n * Decompose a `flat-top-bottom` drawing — two horizontal rails. The top\n * rail sits at `max(anchors[0].price, anchors[2].price)` and the bottom\n * at `min(...)`; both span the time range `anchors[0].time` →\n * `anchors[1].time`. Stroke-only.\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: FlatTopBottomState;\n *     declare const v: Viewport;\n *     const prims = decomposeFlatTopBottom(s, v);\n *     // prims.length === 2\n *     void prims;\n */\nexport function decomposeFlatTopBottom(\n    state: FlatTopBottomState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const p0 = state.anchors[0];\n    const p1 = state.anchors[1];\n    const p2 = state.anchors[2];\n    const topPrice = Math.max(p0.price, p2.price);\n    const bottomPrice = Math.min(p0.price, p2.price);\n    const topLeft = worldPointToPixel({ time: p0.time, price: topPrice }, view);\n    const topRight = worldPointToPixel({ time: p1.time, price: topPrice }, view);\n    const bottomLeft = worldPointToPixel({ time: p0.time, price: bottomPrice }, view);\n    const bottomRight = worldPointToPixel({ time: p1.time, price: bottomPrice }, view);\n    const stroke = strokeOf(state.style);\n    return [\n        { kind: \"polyline\", points: [topLeft, topRight], closed: false, stroke },\n        { kind: \"polyline\", points: [bottomLeft, bottomRight], closed: false, stroke },\n    ];\n}\n\n/**\n * Decompose a `disjoint-channel` drawing — two independent line segments\n * with no shared geometry constraint: `anchors[0]` → `anchors[1]` and\n * `anchors[2]` → `anchors[3]`. Stroke-only.\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: DisjointChannelState;\n *     declare const v: Viewport;\n *     const prims = decomposeDisjointChannel(s, v);\n *     // prims.length === 2\n *     void prims;\n */\nexport function decomposeDisjointChannel(\n    state: DisjointChannelState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const a = worldPointToPixel(state.anchors[0], view);\n    const b = worldPointToPixel(state.anchors[1], view);\n    const c = worldPointToPixel(state.anchors[2], view);\n    const d = worldPointToPixel(state.anchors[3], view);\n    const stroke = strokeOf(state.style);\n    return [\n        { kind: \"polyline\", points: [a, b], closed: false, stroke },\n        { kind: \"polyline\", points: [c, d], closed: false, stroke },\n    ];\n}\n\n/**\n * Decompose a `regression-trend` drawing — a single placeholder line\n * between the two anchors, colour `style.color ?? \"#3b82f6\"`, width 1,\n * solid. The OLS fit + ±σ bands the `RegressionTrendOpts` flags\n * (`source` / `stdevMultiplier` / `showUpperBand` / `showLowerBand`)\n * describe require a bar buffer the `Viewport` does not expose and band\n * anchors the 2-point `state.anchors` does not carry; the canvas2d\n * source renders the same placeholder line, so this decomposer preserves\n * that geometry. Those style fields are accepted but unused here —\n * consumer adapters with a bar buffer can compute the fit themselves.\n *\n * @since 1.3\n * @stable\n * @example\n *     declare const s: RegressionTrendState;\n *     declare const v: Viewport;\n *     const prims = decomposeRegressionTrend(s, v);\n *     // prims.length === 1; prims[0].kind === \"polyline\"\n *     void prims;\n */\nexport function decomposeRegressionTrend(\n    state: RegressionTrendState,\n    view: Viewport,\n): ReadonlyArray<DrawPrimitive> {\n    const a = worldPointToPixel(state.anchors[0], view);\n    const b = worldPointToPixel(state.anchors[1], view);\n    return [\n        {\n            kind: \"polyline\",\n            points: [a, b],\n            closed: false,\n            stroke: {\n                color: state.style.color ?? REGRESSION_DEFAULT_COLOR,\n                width: DEFAULT_LINE_WIDTH,\n                dash: dashPattern(\"solid\"),\n            },\n        },\n    ];\n}\n"]}

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

@@ -0,0 +1,54 @@
+import type { FrameState, GroupState, TableState } from "@invinite-org/chartlang-core";
+import type { DrawPrimitive, Viewport } from "../types.js";
+/**
+ * Decompose a `group` drawing — a no-op container. Groups are
+ * metadata-only on the wire: `childHandleIds` reference drawings that
+ * decompose through their own arms, and the `Viewport` exposes no
+ * child-state side-channel, so a group emits nothing.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: GroupState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeGroup(s, v);
+ *     // prims.length === 0
+ *     void prims;
+ */
+export declare function decomposeGroup(state: GroupState, view: Viewport): ReadonlyArray<DrawPrimitive>;
+/**
+ * Decompose a `frame` drawing — a stroked rectangle between the two
+ * world anchors `[topLeft, bottomRight]`. An optional `style.bgColor`
+ * adds a background `fill` (alpha 1) on the border polyline; an optional
+ * `style.label` adds a `text` primitive at the top-left corner.
+ * Degenerate anchors (zero width/height, or non-finite) emit `[]`.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: FrameState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeFrame(s, v);
+ *     void prims;
+ */
+export declare function decomposeFrame(state: FrameState, view: Viewport): ReadonlyArray<DrawPrimitive>;
+/**
+ * Decompose a `draw.table` emission as a CSS-pixel viewport overlay.
+ * Unlike every other kind, `table` ignores world-coordinate transforms:
+ * `state.position` resolves directly against `Viewport.pxWidth` /
+ * `Viewport.pxHeight`. Each cell emits a background-fill polyline + a
+ * `text` primitive (+ an optional per-cell border polyline when both
+ * `borderColor` and `borderWidth` are set); an optional outer `frame`
+ * polyline wraps the whole grid. Zero rows/columns yields a degenerate
+ * (possibly empty) grid without throwing.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: TableState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeTable(s, v);
+ *     void prims;
+ */
+export declare function decomposeTable(state: TableState, view: Viewport): ReadonlyArray<DrawPrimitive>;
+//# sourceMappingURL=containers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"containers.d.ts","sourceRoot":"","sources":["../../../src/geometry/kinds/containers.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACR,UAAU,EACV,UAAU,EAGV,UAAU,EACb,MAAM,8BAA8B,CAAC;AAItC,OAAO,KAAK,EAAE,aAAa,EAA0B,QAAQ,EAAE,MAAM,aAAa,CAAC;AAMnF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,aAAa,CAAC,aAAa,CAAC,CAI9F;AAWD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,aAAa,CAAC,aAAa,CAAC,CAyC9F;AAuID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,aAAa,CAAC,aAAa,CAAC,CA4D9F"}

package/dist/geometry/kinds/containers.js

@@ -0,0 +1,268 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// Container + table geometry moved from the canvas2d adapter's per-kind
+// renderers
+//   examples/canvas2d-adapter/src/render/draw/{group,frame,table}.ts.
+// `group` / `frame` state shapes originate from invinite's collab
+// y-doc-bridge (commit 078f41fe2569d659d5aba726da8bcb5d3e2ced02,
+// © Invinite); the frame envelope + table layout are chartlang
+// additions. Re-licensed MIT for chartlang.
+import { SOLID_DASH } from "../_lib/dash.js";
+import { worldPointToPixel } from "../project.js";
+const FILL_OPAQUE = 1;
+// --- group ---------------------------------------------------------------
+/**
+ * Decompose a `group` drawing — a no-op container. Groups are
+ * metadata-only on the wire: `childHandleIds` reference drawings that
+ * decompose through their own arms, and the `Viewport` exposes no
+ * child-state side-channel, so a group emits nothing.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: GroupState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeGroup(s, v);
+ *     // prims.length === 0
+ *     void prims;
+ */
+export function decomposeGroup(state, view) {
+    void state;
+    void view;
+    return [];
+}
+// --- frame ---------------------------------------------------------------
+const FRAME_STROKE = "#64748b";
+const FRAME_LABEL_COLOR = "#1e293b";
+const FRAME_LINE_WIDTH = 1;
+const FRAME_LABEL_FONT = "12px sans-serif";
+const FRAME_LABEL_INSET_X = 6;
+const FRAME_LABEL_INSET_Y = 14;
+/**
+ * Decompose a `frame` drawing — a stroked rectangle between the two
+ * world anchors `[topLeft, bottomRight]`. An optional `style.bgColor`
+ * adds a background `fill` (alpha 1) on the border polyline; an optional
+ * `style.label` adds a `text` primitive at the top-left corner.
+ * Degenerate anchors (zero width/height, or non-finite) emit `[]`.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: FrameState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeFrame(s, v);
+ *     void prims;
+ */
+export function decomposeFrame(state, view) {
+    const a = worldPointToPixel(state.anchors[0], view);
+    const b = worldPointToPixel(state.anchors[1], view);
+    const xMin = Math.min(a.x, b.x);
+    const xMax = Math.max(a.x, b.x);
+    const yMin = Math.min(a.y, b.y);
+    const yMax = Math.max(a.y, b.y);
+    const width = xMax - xMin;
+    const height = yMax - yMin;
+    if (width === 0 || height === 0)
+        return [];
+    if (!Number.isFinite(width) || !Number.isFinite(height))
+        return [];
+    const fill = state.style.bgColor !== undefined
+        ? { color: state.style.bgColor, alpha: FILL_OPAQUE }
+        : undefined;
+    const border = {
+        kind: "polyline",
+        points: [
+            { x: xMin, y: yMin },
+            { x: xMax, y: yMin },
+            { x: xMax, y: yMax },
+            { x: xMin, y: yMax },
+        ],
+        closed: true,
+        stroke: { color: FRAME_STROKE, width: FRAME_LINE_WIDTH, dash: SOLID_DASH },
+        ...(fill !== undefined ? { fill } : {}),
+    };
+    const out = [border];
+    if (state.style.label !== undefined) {
+        out.push({
+            kind: "text",
+            x: xMin + FRAME_LABEL_INSET_X,
+            y: yMin + FRAME_LABEL_INSET_Y,
+            text: state.style.label,
+            color: FRAME_LABEL_COLOR,
+            font: FRAME_LABEL_FONT,
+            align: "left",
+            baseline: "bottom",
+        });
+    }
+    return out;
+}
+// --- table ---------------------------------------------------------------
+const TABLE_VIEWPORT_PADDING_PX = 8;
+const TABLE_CELL_PAD_X_PX = 6;
+const TABLE_CELL_PAD_Y_PX = 4;
+const TABLE_DEFAULT_TEXT_COLOR = "#0f172a";
+const TABLE_DEFAULT_BG_COLOR = "#ffffff";
+const TABLE_FONT_FAMILY = "sans-serif";
+const TABLE_TEXT_SIZE_PX = {
+    tiny: 8,
+    small: 10,
+    normal: 12,
+    large: 16,
+    huge: 24,
+};
+function tableTextSizePx(cell) {
+    return TABLE_TEXT_SIZE_PX[cell.textSize ?? "normal"];
+}
+function estimateTextWidth(text, fontPx) {
+    return text.length * fontPx * 0.6;
+}
+function columnCount(rows) {
+    let count = 0;
+    for (const row of rows) {
+        if (row.length > count)
+            count = row.length;
+    }
+    return count;
+}
+function resolveTableX(position, tableWidth, view) {
+    if (position.endsWith("-center"))
+        return view.pxWidth / 2 - tableWidth / 2;
+    if (position.endsWith("-right"))
+        return view.pxWidth - tableWidth - TABLE_VIEWPORT_PADDING_PX;
+    return TABLE_VIEWPORT_PADDING_PX;
+}
+function resolveTableY(position, tableHeight, view) {
+    if (position.startsWith("middle-"))
+        return view.pxHeight / 2 - tableHeight / 2;
+    if (position.startsWith("bottom-"))
+        return view.pxHeight - tableHeight - TABLE_VIEWPORT_PADDING_PX;
+    return TABLE_VIEWPORT_PADDING_PX;
+}
+function layoutTable(state, view) {
+    const columns = columnCount(state.cells);
+    const columnWidths = Array.from({ length: columns }, () => 0);
+    const rowHeights = state.cells.map((row) => {
+        let maxFont = TABLE_TEXT_SIZE_PX.normal;
+        for (let column = 0; column < row.length; column++) {
+            const cell = row[column];
+            const fontPx = tableTextSizePx(cell);
+            if (fontPx > maxFont)
+                maxFont = fontPx;
+            const width = estimateTextWidth(cell.text, fontPx) + TABLE_CELL_PAD_X_PX * 2;
+            if (width > columnWidths[column])
+                columnWidths[column] = width;
+        }
+        return maxFont + TABLE_CELL_PAD_Y_PX * 2;
+    });
+    const width = columnWidths.reduce((sum, widthPx) => sum + widthPx, 0);
+    const height = rowHeights.reduce((sum, heightPx) => sum + heightPx, 0);
+    return {
+        x: resolveTableX(state.position, width, view),
+        y: resolveTableY(state.position, height, view),
+        width,
+        height,
+        columnWidths,
+        rowHeights,
+    };
+}
+function rectPolyline(x, y, width, height, stroke, fill) {
+    return {
+        kind: "polyline",
+        points: [
+            { x, y },
+            { x: x + width, y },
+            { x: x + width, y: y + height },
+            { x, y: y + height },
+        ],
+        closed: true,
+        ...(stroke !== undefined ? { stroke } : {}),
+        ...(fill !== undefined ? { fill } : {}),
+    };
+}
+function cellTextX(cell, x, width) {
+    switch (cell.textHalign ?? "left") {
+        case "center":
+            return x + width / 2;
+        case "right":
+            return x + width - TABLE_CELL_PAD_X_PX;
+        case "left":
+            return x + TABLE_CELL_PAD_X_PX;
+    }
+}
+function cellTextY(cell, y, height) {
+    switch (cell.textValign ?? "middle") {
+        case "top":
+            return y + TABLE_CELL_PAD_Y_PX;
+        case "bottom":
+            return y + height - TABLE_CELL_PAD_Y_PX;
+        case "middle":
+            return y + height / 2;
+    }
+}
+function cellAlign(cell) {
+    return cell.textHalign ?? "left";
+}
+function cellBaseline(cell) {
+    return cell.textValign ?? "middle";
+}
+/**
+ * Decompose a `draw.table` emission as a CSS-pixel viewport overlay.
+ * Unlike every other kind, `table` ignores world-coordinate transforms:
+ * `state.position` resolves directly against `Viewport.pxWidth` /
+ * `Viewport.pxHeight`. Each cell emits a background-fill polyline + a
+ * `text` primitive (+ an optional per-cell border polyline when both
+ * `borderColor` and `borderWidth` are set); an optional outer `frame`
+ * polyline wraps the whole grid. Zero rows/columns yields a degenerate
+ * (possibly empty) grid without throwing.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     declare const s: TableState;
+ *     declare const v: Viewport;
+ *     const prims = decomposeTable(s, v);
+ *     void prims;
+ */
+export function decomposeTable(state, view) {
+    const layout = layoutTable(state, view);
+    const out = [];
+    let y = layout.y;
+    for (let rowIndex = 0; rowIndex < state.cells.length; rowIndex++) {
+        const row = state.cells[rowIndex];
+        const height = layout.rowHeights[rowIndex];
+        let x = layout.x;
+        for (let columnIndex = 0; columnIndex < layout.columnWidths.length; columnIndex++) {
+            const width = layout.columnWidths[columnIndex];
+            const cell = row[columnIndex] ?? { text: "" };
+            out.push(rectPolyline(x, y, width, height, undefined, {
+                color: cell.bgColor ?? TABLE_DEFAULT_BG_COLOR,
+                alpha: FILL_OPAQUE,
+            }));
+            out.push({
+                kind: "text",
+                x: cellTextX(cell, x, width),
+                y: cellTextY(cell, y, height),
+                text: cell.text,
+                color: cell.textColor ?? TABLE_DEFAULT_TEXT_COLOR,
+                font: `${tableTextSizePx(cell)}px ${TABLE_FONT_FAMILY}`,
+                align: cellAlign(cell),
+                baseline: cellBaseline(cell),
+            });
+            if (state.borderColor !== undefined && state.borderWidth !== undefined) {
+                out.push(rectPolyline(x, y, width, height, {
+                    color: state.borderColor,
+                    width: state.borderWidth,
+                    dash: SOLID_DASH,
+                }, undefined));
+            }
+            x += width;
+        }
+        y += height;
+    }
+    if (state.frame !== undefined) {
+        out.push(rectPolyline(layout.x, layout.y, layout.width, layout.height, { color: state.frame.color, width: state.frame.width, dash: SOLID_DASH }, undefined));
+    }
+    return out;
+}
+//# sourceMappingURL=containers.js.map