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

package/CHANGELOG.md

@@ -1,5 +1,162 @@
 # @invinite-org/chartlang-adapter-kit
 
+## 1.4.0
+
+### Minor Changes
+
+- 03f59bf: Complete the `adapter-kit` geometry layer with the final 23 drawing-kind
+  decomposers — 4 gann (`gann-box`, `gann-square-fixed`, `gann-square`,
+  `gann-fan`), 2 pitchforks (`pitchfork`, `pitchfan`), 6 harmonic patterns
+  (`xabcd-pattern`, `cypher-pattern`, `head-and-shoulders`, `abcd-pattern`,
+  `triangle-pattern`, `three-drives-pattern`), 5 elliott waves
+  (`elliott-impulse-wave`, `elliott-correction-wave`, `elliott-triangle-wave`,
+  `elliott-double-combo`, `elliott-triple-combo`), 3 cycles (`cyclic-lines`,
+  `time-cycles`, `sine-line`), and 3 containers (`group`, `frame`, `table`).
+
+  `decomposeDrawing` is now **exhaustive over all 63 `DrawingKind`s**: its
+  `default` arm is a `const _exhaustive: never` guard, so adding a future kind to
+  core fails `pnpm typecheck` until a decomposer is added. The `table` kind
+  decomposes in CSS-pixel/viewport space (it resolves `position` against the
+  `Viewport` rather than world coordinates).
+
+  Move the shared `gannLevels` (`GANN_LEVELS` / `GANN_FAN_RATIOS` /
+  `GANN_FAN_LABELS` / `formatGannRatio`) and `pitchforkGeom`
+  (`medianOriginFor` / `medianTargetFor`) helpers into package-private
+  `geometry/_lib/`, reused by the gann and pitchfork decomposers.
+
+- 03f59bf: Extend the `adapter-kit` geometry layer with 20 more drawing-kind decomposers —
+  3 curves (`arc`, `curve`, `double-curve`), 3 freehand (`pen`, `highlighter`,
+  `brush`), 4 channels (`trend-channel`, `flat-top-bottom`, `disjoint-channel`,
+  `regression-trend`), and 10 fibonacci (`fib-retracement`, `fib-trend-extension`,
+  `fib-channel`, `fib-time-zone`, `fib-wedge`, `fib-speed-fan`, `fib-speed-arcs`,
+  `fib-spiral`, `fib-circles`, `fib-trend-time`). `decomposeDrawing` now covers 40
+  of the 63 kinds; the remaining 23 return `[]` until Task 3.
+
+  Add an optional `StrokeStyle.alpha` IR field (backward-compatible — omitted
+  strokes are byte-identical to before): `paintPrimitive` brackets the `stroke()`
+  in `globalAlpha` when set, expressing the `highlighter` translucency.
+
+  Move the shared `FIB_LEVELS` ratio array + `formatLevel` label formatter into a
+  package-private `geometry/_lib/fibLevels.ts`, reused by every fib decomposer.
+
+- 03f59bf: Add a renderer-agnostic geometry layer to `adapter-kit`: the `Viewport` +
+  projection helpers (`timeToX`, `priceToY`, `worldPointToPixel`), the
+  `DrawPrimitive` IR (`polyline` / `arc` / `text` / `marker` with `StrokeStyle` /
+  `FillStyle`), and `decomposeDrawing(emission, viewport)` covering the 20 basic
+  drawing kinds (lines / rays, boxes / shapes incl. `fill-between`, annotations,
+  marker, text). The remaining 43 kinds return `[]` until Tasks 2–3 land their
+  decomposers.
+
+  Also ships the canvas-family sink under the new `./canvas` sub-path:
+  `RenderCtx`, `paintPrimitive(ctx, prim)`, the generalised `MockCanvasContext`
+  (records every method + setter), and `hashCallLog` for deterministic call-log
+  hashing.
+
+## 1.3.0
+
+### Minor Changes
+
+- ca19e20: Bidirectional plot `offset` — negative offsets shift a plotted series left.
+
+  `offset` becomes a presentation-only **display shift** in bars with the
+  fixed sign convention `+n` = right (future), `−n` = left (past); the
+  numeric series value is unshifted. This replaces the old value-read model
+  (where a positive offset made `series.current` read the value N bars ago
+  and a negative offset resolved to `NaN`). The `*Opts` `offset` JSDoc (and
+  ALMA's `barShift`) now describe both directions and drop the old
+  "negative ⇒ NaN" wording (`AlmaOpts.offset`, the Gaussian-centre
+  position, is unchanged).
+
+  `PlotEmission` gains an optional presentation field `xShift?: number`
+  (signed integer bars; omitted/`0` ≡ no shift, so a no-shift emission is
+  byte-identical to today). `validateEmission` rejects a non-integer
+  `xShift`. The compiler no longer counts `offset` toward `maxLookback`
+  (the value is no longer read from a deeper slot). The runtime threads the
+  declared offset onto the emission as `xShift` (reading a
+  `WeakMap<Series, number>` offset tag set by `makeShiftedSeriesView`; ALMA
+  tags `opts.barShift`) and stops the old value-read shift so
+  `series.current` is unshifted; the reference adapter renders it by
+  projecting `xShift` onto the x-axis (extending the viewport for
+  future-shifted points).
+
+  The Pine converter now maps `plot(<ta.* call>, offset=N)` onto the
+  emitted `ta.*` call's `offset` opt (signed, both directions); a plot
+  whose value is not a direct `ta.*` call drops the offset and emits the
+  new `plot-offset-needs-ta-call` warning, and a plot-level offset
+  replacing the ta call's own `offset=` emits `plot-offset-overrides-ta-offset`.
+
+  The conformance harness's `plot-field` assertion gains an `xShift` field,
+  and a new scenario pins both shift directions plus the unshifted value
+  series.
+
+- 3bf391a: Add the `draw.fillBetween(edgeA, edgeB, opts?)` drawing primitive — a
+  native filled ribbon between two edges (the closed polygon `edgeA`
+  forward then `edgeB` reversed). It is the chartlang equivalent of Pine's
+  `linefill.new(line1, line2, color)` / `fill(plot1, plot2)`. The
+  pine-converter now lowers static two-line `linefill.new` to it instead of
+  approximating with `draw.rotatedRectangle`, retiring the
+  `linefill-rotatedrect-approximated` diagnostic.
+- 8086003: Add an optional presentation-only `z` (render-order / z-index) option to
+  `plot()` and every `draw.*` primitive. Default `0`; higher renders on
+  top, ties fall back to the existing group + declaration order. Finite
+  numbers only. Affects stacking only — values, alerts, and `state.*` are
+  unchanged.
+
+  Adapter kit: `PlotEmission` and `DrawingEmission` gain the matching
+  presentation-only `z?: number` wire field, validated by
+  `validateEmission` as a finite number (NaN / ±Infinity rejected;
+  fractional and negative allowed). Omitted/`0` stays byte-identical to a
+  pre-feature emission, so existing goldens and conformance hashes are
+  untouched.
+
+  Runtime: `plotImpl` reads `opts.z`, and the drawing-emit path
+  (`createDrawingHandle`) lifts `z` out of `state.style` — into a shallow
+  clone with `z` removed, where the per-kind `draw.*` impls fold the opts
+  bag — and threads it onto the top-level `PlotEmission.z` /
+  `DrawingEmission.z` with the same omit-when-`0` conditional spread used
+  for `xShift`. `z` is persisted **beside** the drawing slot's `state`
+  (never inside `DrawingState`), so an `update` retains the last value. A
+  no-`z` plot or drawing emits no `z` key — byte-identical to the
+  pre-feature baseline. `draw.table` / `draw.group` do not carry `z` in
+  v1.
+
+  Pine converter: `explicit_plot_zorder` is now a recognized no-op instead
+  of an unmapped warning. chartlang already layers marks by declaration
+  order within their group (the normative ordering contract), which is
+  exactly what Pine's `explicit_plot_zorder=true` makes authoritative — so
+  the flag is satisfied by default and needs no chartlang option.
+  `mapDeclarationArgs` no longer raises `indicator-arg-not-mapped` for it;
+  instead it emits a single `explicit-plot-zorder-default` info note
+  (covering both `explicit_plot_zorder=true` and the Pine-default
+  `=false`). The converter still never _emits_ a numeric `z` — Pine has no
+  per-element z source construct. Other unmapped `indicator(...)` args
+  (`timeframe`, etc.) keep warning.
+
+  Compiler: the ambient `@invinite-org/chartlang-core` `.d.ts` shim gains a
+  `ZOrdered { z?: number }` mixin intersected into `PlotOpts` and every
+  `draw.*` option type (mirroring core's `drawingStyle.ts`), so a compiled
+  script's `plot(value, { z })` **and** `draw.*(…, { z })` type-check (the
+  shim stays in lockstep with core).
+
+  Conformance: a new `z-order` scenario pins the plot `z` →
+  `PlotEmission.z` wire contract — a `plot(value, { z: -1 })` emits
+  `z: -1`, a no-`z` plot omits the field (omit-when-`0` byte-identity), and
+  a value-hash proves `z` never transforms the series. The `plot-field`
+  assertion's `field` union widens to also accept `"z"`.
+
+### Patch Changes
+
+- Updated dependencies [850ae21]
+- Updated dependencies [ca19e20]
+- Updated dependencies [6235ad7]
+- Updated dependencies [3bf391a]
+- Updated dependencies [8086003]
+- Updated dependencies [850ae21]
+- Updated dependencies [073f41b]
+- Updated dependencies [5a9c24d]
+- Updated dependencies [08c536c]
+  - @invinite-org/chartlang-core@1.2.0
+
 ## 1.2.1
 
 ### Patch Changes

package/README.md

@@ -35,6 +35,13 @@ pnpm add @invinite-org/chartlang-adapter-kit
   `dep-error`, `dep-cycle`, `dep-unknown-output`,
   `dep-invalid-input-override`, `dep-dynamic`, `dep-output-not-titled` for
   the new `.output(...)` / `.withInputs(...)` surface.
+- Geometry layer: `timeToX`, `priceToY`, `worldPointToPixel`,
+  `decomposeDrawing(emission, viewport) -> DrawPrimitive[]` (covers the basic
+  drawing kinds today; the rest land incrementally), plus the `Viewport`,
+  `Point2`, `DrawPrimitive`, `StrokeStyle`, and `FillStyle` types.
+- Canvas sink (`@invinite-org/chartlang-adapter-kit/canvas`): `RenderCtx`,
+  `paintPrimitive(ctx, prim)`, `MockCanvasContext`, `RecordedCall`, and
+  `hashCallLog(mock.calls)` for deterministic, headless call-log hashing.
 
 ## Minimum-viable API call
 

package/dist/canvas/index.d.ts

@@ -0,0 +1,5 @@
+export { hashCallLog, MockCanvasContext } from "./mockContext.js";
+export type { RecordedCall } from "./mockContext.js";
+export { paintPrimitive } from "./paintPrimitive.js";
+export type { RenderCtx } from "./renderCtx.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/canvas/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/canvas/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 { hashCallLog, MockCanvasContext } from "./mockContext.js";
+export { paintPrimitive } from "./paintPrimitive.js";
+//# sourceMappingURL=index.js.map

package/dist/canvas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/canvas/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,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 { hashCallLog, MockCanvasContext } from \"./mockContext.js\";\nexport type { RecordedCall } from \"./mockContext.js\";\nexport { paintPrimitive } from \"./paintPrimitive.js\";\nexport type { RenderCtx } from \"./renderCtx.js\";\n"]}

package/dist/canvas/mockContext.d.ts

@@ -0,0 +1,168 @@
+/**
+ * One recorded call against {@link MockCanvasContext}. Tests inspect
+ * the array to assert a paint sequence. The union covers every method
+ * and setter on {@link import("./renderCtx").RenderCtx}; adding a new
+ * draw call means extending both the mock and this union together.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const call: RecordedCall = { kind: "clearRect", x: 0, y: 0, w: 100, h: 100 };
+ *     void call;
+ */
+export type RecordedCall = {
+    readonly kind: "clearRect";
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+} | {
+    readonly kind: "translate";
+    readonly x: number;
+    readonly y: number;
+} | {
+    readonly kind: "save";
+} | {
+    readonly kind: "restore";
+} | {
+    readonly kind: "beginPath";
+} | {
+    readonly kind: "moveTo";
+    readonly x: number;
+    readonly y: number;
+} | {
+    readonly kind: "lineTo";
+    readonly x: number;
+    readonly y: number;
+} | {
+    readonly kind: "stroke";
+} | {
+    readonly kind: "fillRect";
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+} | {
+    readonly kind: "fill";
+} | {
+    readonly kind: "arc";
+    readonly x: number;
+    readonly y: number;
+    readonly radius: number;
+    readonly start: number;
+    readonly end: number;
+} | {
+    readonly kind: "closePath";
+} | {
+    readonly kind: "setLineDash";
+    readonly segments: ReadonlyArray<number>;
+} | {
+    readonly kind: "fillText";
+    readonly text: string;
+    readonly x: number;
+    readonly y: number;
+} | {
+    readonly kind: "set";
+    readonly prop: "strokeStyle";
+    readonly value: string;
+} | {
+    readonly kind: "set";
+    readonly prop: "fillStyle";
+    readonly value: string;
+} | {
+    readonly kind: "set";
+    readonly prop: "lineWidth";
+    readonly value: number;
+} | {
+    readonly kind: "set";
+    readonly prop: "globalAlpha";
+    readonly value: number;
+} | {
+    readonly kind: "set";
+    readonly prop: "font";
+    readonly value: string;
+} | {
+    readonly kind: "set";
+    readonly prop: "textAlign";
+    readonly value: string;
+} | {
+    readonly kind: "set";
+    readonly prop: "textBaseline";
+    readonly value: string;
+};
+/**
+ * Hand-rolled Canvas 2D mock that satisfies the canvas sink's
+ * {@link import("./renderCtx").RenderCtx} structural type. Every method
+ * and setter appends a typed record to `calls` so tests can assert the
+ * exact paint sequence without standing up `node-canvas` or a real
+ * browser. The canvas2d adapter re-exports this class as
+ * `MockCanvas2DContext` (implementation shared, public name unchanged).
+ *
+ * Property setters are tracked via accessor pairs — the mock stores the
+ * most recent value in private fields so `ctx.strokeStyle = "#x"` both
+ * records the call and survives a subsequent read.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const ctx = new MockCanvasContext();
+ *     ctx.clearRect(0, 0, 100, 100);
+ *     // ctx.calls[0] === { kind: "clearRect", x: 0, y: 0, w: 100, h: 100 }
+ *     void ctx;
+ */
+export declare class MockCanvasContext {
+    readonly calls: RecordedCall[];
+    private _strokeStyle;
+    private _fillStyle;
+    private _lineWidth;
+    private _globalAlpha;
+    private _font;
+    private _textAlign;
+    private _textBaseline;
+    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;
+    get strokeStyle(): string;
+    set strokeStyle(value: string);
+    get fillStyle(): string;
+    set fillStyle(value: string);
+    get lineWidth(): number;
+    set lineWidth(value: number);
+    get globalAlpha(): number;
+    set globalAlpha(value: number);
+    get font(): string;
+    set font(value: string);
+    get textAlign(): "start" | "center" | "end" | "left" | "right";
+    set textAlign(value: "start" | "center" | "end" | "left" | "right");
+    get textBaseline(): "top" | "middle" | "bottom" | "alphabetic" | "hanging";
+    set textBaseline(value: "top" | "middle" | "bottom" | "alphabetic" | "hanging");
+}
+/**
+ * Hash a recorded call log into a stable SHA-256 hex string. Floats are
+ * rounded to four decimal places and re-serialised in canonical-key
+ * JSON so a microscopic floating-point drift does not re-hash the log.
+ * Pass `mock.calls`. Adapters pin their integration render output
+ * against a single golden constant with this.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const ctx = new MockCanvasContext();
+ *     ctx.clearRect(0, 0, 100, 100);
+ *     const h = hashCallLog(ctx.calls);
+ *     // h is a 64-char hex string
+ *     void h;
+ */
+export declare function hashCallLog(calls: ReadonlyArray<RecordedCall>): string;
+//# sourceMappingURL=mockContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mockContext.d.ts","sourceRoot":"","sources":["../../src/canvas/mockContext.ts"],"names":[],"mappings":"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"}

package/dist/canvas/mockContext.js

@@ -0,0 +1,198 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { createHash } from "node:crypto";
+/**
+ * Hand-rolled Canvas 2D mock that satisfies the canvas sink's
+ * {@link import("./renderCtx").RenderCtx} structural type. Every method
+ * and setter appends a typed record to `calls` so tests can assert the
+ * exact paint sequence without standing up `node-canvas` or a real
+ * browser. The canvas2d adapter re-exports this class as
+ * `MockCanvas2DContext` (implementation shared, public name unchanged).
+ *
+ * Property setters are tracked via accessor pairs — the mock stores the
+ * most recent value in private fields so `ctx.strokeStyle = "#x"` both
+ * records the call and survives a subsequent read.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const ctx = new MockCanvasContext();
+ *     ctx.clearRect(0, 0, 100, 100);
+ *     // ctx.calls[0] === { kind: "clearRect", x: 0, y: 0, w: 100, h: 100 }
+ *     void ctx;
+ */
+export class MockCanvasContext {
+    calls = [];
+    _strokeStyle = "#000000";
+    _fillStyle = "#000000";
+    _lineWidth = 1;
+    _globalAlpha = 1;
+    _font = "10px sans-serif";
+    _textAlign = "start";
+    _textBaseline = "alphabetic";
+    clearRect(x, y, w, h) {
+        this.calls.push({ kind: "clearRect", x, y, w, h });
+    }
+    translate(x, y) {
+        this.calls.push({ kind: "translate", x, y });
+    }
+    save() {
+        this.calls.push({ kind: "save" });
+    }
+    restore() {
+        this.calls.push({ kind: "restore" });
+    }
+    beginPath() {
+        this.calls.push({ kind: "beginPath" });
+    }
+    moveTo(x, y) {
+        this.calls.push({ kind: "moveTo", x, y });
+    }
+    lineTo(x, y) {
+        this.calls.push({ kind: "lineTo", x, y });
+    }
+    stroke() {
+        this.calls.push({ kind: "stroke" });
+    }
+    fillRect(x, y, w, h) {
+        this.calls.push({ kind: "fillRect", x, y, w, h });
+    }
+    fill() {
+        this.calls.push({ kind: "fill" });
+    }
+    arc(x, y, radius, start, end) {
+        this.calls.push({ kind: "arc", x, y, radius, start, end });
+    }
+    closePath() {
+        this.calls.push({ kind: "closePath" });
+    }
+    setLineDash(segments) {
+        this.calls.push({ kind: "setLineDash", segments: segments.slice() });
+    }
+    fillText(text, x, y) {
+        this.calls.push({ kind: "fillText", text, x, y });
+    }
+    get strokeStyle() {
+        return this._strokeStyle;
+    }
+    set strokeStyle(value) {
+        this._strokeStyle = value;
+        this.calls.push({ kind: "set", prop: "strokeStyle", value });
+    }
+    get fillStyle() {
+        return this._fillStyle;
+    }
+    set fillStyle(value) {
+        this._fillStyle = value;
+        this.calls.push({ kind: "set", prop: "fillStyle", value });
+    }
+    get lineWidth() {
+        return this._lineWidth;
+    }
+    set lineWidth(value) {
+        this._lineWidth = value;
+        this.calls.push({ kind: "set", prop: "lineWidth", value });
+    }
+    get globalAlpha() {
+        return this._globalAlpha;
+    }
+    set globalAlpha(value) {
+        this._globalAlpha = value;
+        this.calls.push({ kind: "set", prop: "globalAlpha", value });
+    }
+    get font() {
+        return this._font;
+    }
+    set font(value) {
+        this._font = value;
+        this.calls.push({ kind: "set", prop: "font", value });
+    }
+    get textAlign() {
+        return this._textAlign;
+    }
+    set textAlign(value) {
+        this._textAlign = value;
+        this.calls.push({ kind: "set", prop: "textAlign", value });
+    }
+    get textBaseline() {
+        return this._textBaseline;
+    }
+    set textBaseline(value) {
+        this._textBaseline = value;
+        this.calls.push({ kind: "set", prop: "textBaseline", value });
+    }
+}
+const FLOAT_DECIMALS = 4;
+function roundFloat(n) {
+    if (!Number.isFinite(n))
+        return String(n);
+    return Number(n.toFixed(FLOAT_DECIMALS));
+}
+function canonicalise(call) {
+    switch (call.kind) {
+        case "clearRect":
+        case "fillRect":
+            return {
+                kind: call.kind,
+                x: roundFloat(call.x),
+                y: roundFloat(call.y),
+                w: roundFloat(call.w),
+                h: roundFloat(call.h),
+            };
+        case "moveTo":
+        case "lineTo":
+        case "translate":
+            return { kind: call.kind, x: roundFloat(call.x), y: roundFloat(call.y) };
+        case "arc":
+            return {
+                kind: call.kind,
+                x: roundFloat(call.x),
+                y: roundFloat(call.y),
+                radius: roundFloat(call.radius),
+                start: roundFloat(call.start),
+                end: roundFloat(call.end),
+            };
+        case "setLineDash":
+            return { kind: call.kind, segments: call.segments.map((s) => roundFloat(s)) };
+        case "fillText":
+            return {
+                kind: call.kind,
+                text: call.text,
+                x: roundFloat(call.x),
+                y: roundFloat(call.y),
+            };
+        case "set": {
+            const value = typeof call.value === "number" ? roundFloat(call.value) : call.value;
+            return { kind: call.kind, prop: call.prop, value };
+        }
+        case "beginPath":
+        case "save":
+        case "restore":
+        case "stroke":
+        case "fill":
+        case "closePath":
+            return { kind: call.kind };
+    }
+}
+/**
+ * Hash a recorded call log into a stable SHA-256 hex string. Floats are
+ * rounded to four decimal places and re-serialised in canonical-key
+ * JSON so a microscopic floating-point drift does not re-hash the log.
+ * Pass `mock.calls`. Adapters pin their integration render output
+ * against a single golden constant with this.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const ctx = new MockCanvasContext();
+ *     ctx.clearRect(0, 0, 100, 100);
+ *     const h = hashCallLog(ctx.calls);
+ *     // h is a 64-char hex string
+ *     void h;
+ */
+export function hashCallLog(calls) {
+    const payload = calls.map(canonicalise);
+    const serialised = JSON.stringify(payload);
+    return createHash("sha256").update(serialised).digest("hex");
+}
+//# sourceMappingURL=mockContext.js.map

package/dist/canvas/mockContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockContext.js","sourceRoot":"","sources":["../../src/canvas/mockContext.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 { createHash } from \"node:crypto\";\n\n/**\n * One recorded call against {@link MockCanvasContext}. Tests inspect\n * the array to assert a paint sequence. The union covers every method\n * and setter on {@link import(\"./renderCtx\").RenderCtx}; adding a new\n * draw call means extending both the mock and this union together.\n *\n * @since 1.3\n * @stable\n * @example\n *     const call: RecordedCall = { kind: \"clearRect\", x: 0, y: 0, w: 100, h: 100 };\n *     void call;\n */\nexport type RecordedCall =\n    | {\n          readonly kind: \"clearRect\";\n          readonly x: number;\n          readonly y: number;\n          readonly w: number;\n          readonly h: number;\n      }\n    | { readonly kind: \"translate\"; readonly x: number; readonly y: number }\n    | { readonly kind: \"save\" }\n    | { readonly kind: \"restore\" }\n    | { readonly kind: \"beginPath\" }\n    | { readonly kind: \"moveTo\"; readonly x: number; readonly y: number }\n    | { readonly kind: \"lineTo\"; readonly x: number; readonly y: number }\n    | { readonly kind: \"stroke\" }\n    | {\n          readonly kind: \"fillRect\";\n          readonly x: number;\n          readonly y: number;\n          readonly w: number;\n          readonly h: number;\n      }\n    | { readonly kind: \"fill\" }\n    | {\n          readonly kind: \"arc\";\n          readonly x: number;\n          readonly y: number;\n          readonly radius: number;\n          readonly start: number;\n          readonly end: number;\n      }\n    | { readonly kind: \"closePath\" }\n    | { readonly kind: \"setLineDash\"; readonly segments: ReadonlyArray<number> }\n    | { readonly kind: \"fillText\"; readonly text: string; readonly x: number; readonly y: number }\n    | { readonly kind: \"set\"; readonly prop: \"strokeStyle\"; readonly value: string }\n    | { readonly kind: \"set\"; readonly prop: \"fillStyle\"; readonly value: string }\n    | { readonly kind: \"set\"; readonly prop: \"lineWidth\"; readonly value: number }\n    | { readonly kind: \"set\"; readonly prop: \"globalAlpha\"; readonly value: number }\n    | { readonly kind: \"set\"; readonly prop: \"font\"; readonly value: string }\n    | { readonly kind: \"set\"; readonly prop: \"textAlign\"; readonly value: string }\n    | { readonly kind: \"set\"; readonly prop: \"textBaseline\"; readonly value: string };\n\n/**\n * Hand-rolled Canvas 2D mock that satisfies the canvas sink's\n * {@link import(\"./renderCtx\").RenderCtx} structural type. Every method\n * and setter appends a typed record to `calls` so tests can assert the\n * exact paint sequence without standing up `node-canvas` or a real\n * browser. The canvas2d adapter re-exports this class as\n * `MockCanvas2DContext` (implementation shared, public name unchanged).\n *\n * Property setters are tracked via accessor pairs — the mock stores the\n * most recent value in private fields so `ctx.strokeStyle = \"#x\"` both\n * records the call and survives a subsequent read.\n *\n * @since 1.3\n * @stable\n * @example\n *     const ctx = new MockCanvasContext();\n *     ctx.clearRect(0, 0, 100, 100);\n *     // ctx.calls[0] === { kind: \"clearRect\", x: 0, y: 0, w: 100, h: 100 }\n *     void ctx;\n */\nexport class MockCanvasContext {\n    readonly calls: RecordedCall[] = [];\n    private _strokeStyle = \"#000000\";\n    private _fillStyle = \"#000000\";\n    private _lineWidth = 1;\n    private _globalAlpha = 1;\n    private _font = \"10px sans-serif\";\n    private _textAlign: \"start\" | \"center\" | \"end\" | \"left\" | \"right\" = \"start\";\n    private _textBaseline: \"top\" | \"middle\" | \"bottom\" | \"alphabetic\" | \"hanging\" = \"alphabetic\";\n\n    clearRect(x: number, y: number, w: number, h: number): void {\n        this.calls.push({ kind: \"clearRect\", x, y, w, h });\n    }\n\n    translate(x: number, y: number): void {\n        this.calls.push({ kind: \"translate\", x, y });\n    }\n\n    save(): void {\n        this.calls.push({ kind: \"save\" });\n    }\n\n    restore(): void {\n        this.calls.push({ kind: \"restore\" });\n    }\n\n    beginPath(): void {\n        this.calls.push({ kind: \"beginPath\" });\n    }\n\n    moveTo(x: number, y: number): void {\n        this.calls.push({ kind: \"moveTo\", x, y });\n    }\n\n    lineTo(x: number, y: number): void {\n        this.calls.push({ kind: \"lineTo\", x, y });\n    }\n\n    stroke(): void {\n        this.calls.push({ kind: \"stroke\" });\n    }\n\n    fillRect(x: number, y: number, w: number, h: number): void {\n        this.calls.push({ kind: \"fillRect\", x, y, w, h });\n    }\n\n    fill(): void {\n        this.calls.push({ kind: \"fill\" });\n    }\n\n    arc(x: number, y: number, radius: number, start: number, end: number): void {\n        this.calls.push({ kind: \"arc\", x, y, radius, start, end });\n    }\n\n    closePath(): void {\n        this.calls.push({ kind: \"closePath\" });\n    }\n\n    setLineDash(segments: ReadonlyArray<number>): void {\n        this.calls.push({ kind: \"setLineDash\", segments: segments.slice() });\n    }\n\n    fillText(text: string, x: number, y: number): void {\n        this.calls.push({ kind: \"fillText\", text, x, y });\n    }\n\n    get strokeStyle(): string {\n        return this._strokeStyle;\n    }\n\n    set strokeStyle(value: string) {\n        this._strokeStyle = value;\n        this.calls.push({ kind: \"set\", prop: \"strokeStyle\", value });\n    }\n\n    get fillStyle(): string {\n        return this._fillStyle;\n    }\n\n    set fillStyle(value: string) {\n        this._fillStyle = value;\n        this.calls.push({ kind: \"set\", prop: \"fillStyle\", value });\n    }\n\n    get lineWidth(): number {\n        return this._lineWidth;\n    }\n\n    set lineWidth(value: number) {\n        this._lineWidth = value;\n        this.calls.push({ kind: \"set\", prop: \"lineWidth\", value });\n    }\n\n    get globalAlpha(): number {\n        return this._globalAlpha;\n    }\n\n    set globalAlpha(value: number) {\n        this._globalAlpha = value;\n        this.calls.push({ kind: \"set\", prop: \"globalAlpha\", value });\n    }\n\n    get font(): string {\n        return this._font;\n    }\n\n    set font(value: string) {\n        this._font = value;\n        this.calls.push({ kind: \"set\", prop: \"font\", value });\n    }\n\n    get textAlign(): \"start\" | \"center\" | \"end\" | \"left\" | \"right\" {\n        return this._textAlign;\n    }\n\n    set textAlign(value: \"start\" | \"center\" | \"end\" | \"left\" | \"right\") {\n        this._textAlign = value;\n        this.calls.push({ kind: \"set\", prop: \"textAlign\", value });\n    }\n\n    get textBaseline(): \"top\" | \"middle\" | \"bottom\" | \"alphabetic\" | \"hanging\" {\n        return this._textBaseline;\n    }\n\n    set textBaseline(value: \"top\" | \"middle\" | \"bottom\" | \"alphabetic\" | \"hanging\") {\n        this._textBaseline = value;\n        this.calls.push({ kind: \"set\", prop: \"textBaseline\", value });\n    }\n}\n\nconst FLOAT_DECIMALS = 4;\n\nfunction roundFloat(n: number): number | string {\n    if (!Number.isFinite(n)) return String(n);\n    return Number(n.toFixed(FLOAT_DECIMALS));\n}\n\nfunction canonicalise(call: RecordedCall): Record<string, unknown> {\n    switch (call.kind) {\n        case \"clearRect\":\n        case \"fillRect\":\n            return {\n                kind: call.kind,\n                x: roundFloat(call.x),\n                y: roundFloat(call.y),\n                w: roundFloat(call.w),\n                h: roundFloat(call.h),\n            };\n        case \"moveTo\":\n        case \"lineTo\":\n        case \"translate\":\n            return { kind: call.kind, x: roundFloat(call.x), y: roundFloat(call.y) };\n        case \"arc\":\n            return {\n                kind: call.kind,\n                x: roundFloat(call.x),\n                y: roundFloat(call.y),\n                radius: roundFloat(call.radius),\n                start: roundFloat(call.start),\n                end: roundFloat(call.end),\n            };\n        case \"setLineDash\":\n            return { kind: call.kind, segments: call.segments.map((s) => roundFloat(s)) };\n        case \"fillText\":\n            return {\n                kind: call.kind,\n                text: call.text,\n                x: roundFloat(call.x),\n                y: roundFloat(call.y),\n            };\n        case \"set\": {\n            const value = typeof call.value === \"number\" ? roundFloat(call.value) : call.value;\n            return { kind: call.kind, prop: call.prop, value };\n        }\n        case \"beginPath\":\n        case \"save\":\n        case \"restore\":\n        case \"stroke\":\n        case \"fill\":\n        case \"closePath\":\n            return { kind: call.kind };\n    }\n}\n\n/**\n * Hash a recorded call log into a stable SHA-256 hex string. Floats are\n * rounded to four decimal places and re-serialised in canonical-key\n * JSON so a microscopic floating-point drift does not re-hash the log.\n * Pass `mock.calls`. Adapters pin their integration render output\n * against a single golden constant with this.\n *\n * @since 1.3\n * @stable\n * @example\n *     const ctx = new MockCanvasContext();\n *     ctx.clearRect(0, 0, 100, 100);\n *     const h = hashCallLog(ctx.calls);\n *     // h is a 64-char hex string\n *     void h;\n */\nexport function hashCallLog(calls: ReadonlyArray<RecordedCall>): string {\n    const payload = calls.map(canonicalise);\n    const serialised = JSON.stringify(payload);\n    return createHash(\"sha256\").update(serialised).digest(\"hex\");\n}\n"]}

package/dist/canvas/paintPrimitive.d.ts

@@ -0,0 +1,35 @@
+import type { DrawPrimitive } from "../geometry/types.js";
+import type { RenderCtx } from "./renderCtx.js";
+/**
+ * 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 declare function paintPrimitive(ctx: RenderCtx, p: DrawPrimitive): void;
+//# sourceMappingURL=paintPrimitive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paintPrimitive.d.ts","sourceRoot":"","sources":["../../src/canvas/paintPrimitive.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAA0B,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAgDhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,GAAG,IAAI,CA8CrE"}