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

package/dist/geometry/types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * A 2D point in renderer pixel space — the structural type every
+ * projection helper returns and every {@link DrawPrimitive} consumes.
+ * Read-only so decomposers can't mutate vertices they don't own.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const p: Point2 = { x: 100, y: 50 };
+ *     void p;
+ */
+export type Point2 = {
+    readonly x: number;
+    readonly y: number;
+};
+/**
+ * Visible window into world coordinates. `xMin`/`xMax` are bar times in
+ * UTC milliseconds; `yMin`/`yMax` are prices in the quote currency.
+ * `pxWidth`/`pxHeight` are the renderer's drawable size in CSS pixels.
+ * Ported verbatim from the canvas2d adapter's `render/coords.ts` so all
+ * adapters share one projection contract.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const vp: Viewport = {
+ *         xMin: 0, xMax: 9, yMin: 100, yMax: 110,
+ *         pxWidth: 800, pxHeight: 400,
+ *     };
+ *     void vp;
+ */
+export type Viewport = {
+    readonly xMin: number;
+    readonly xMax: number;
+    readonly yMin: number;
+    readonly yMax: number;
+    readonly pxWidth: number;
+    readonly pxHeight: number;
+};
+/**
+ * Resolved stroke styling for a {@link DrawPrimitive}. `dash` is the
+ * `setLineDash` segment array — `[]` is a solid stroke. Decomposers map
+ * a `LineStyle` to `dash` via the `_lib/dash` helper.
+ *
+ * `alpha ∈ [0, 1]` is the optional stroke opacity the painter brackets
+ * around the `stroke()` call (the `highlighter` freehand kind sets it).
+ * When omitted the stroke is fully opaque and the painter emits no
+ * `globalAlpha` mutation — so a stroke without `alpha` is byte-identical
+ * to a Task-1 stroke.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const s: StrokeStyle = { color: "#000000", width: 1, dash: [] };
+ *     void s;
+ */
+export type StrokeStyle = {
+    readonly color: string;
+    readonly width: number;
+    readonly dash: ReadonlyArray<number>;
+    readonly alpha?: number;
+};
+/**
+ * Resolved fill styling for a {@link DrawPrimitive}. `alpha ∈ [0, 1]`
+ * is applied around the fill so a subsequent stroke draws at full
+ * opacity.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const f: FillStyle = { color: "#dbeafe", alpha: 0.4 };
+ *     void f;
+ */
+export type FillStyle = {
+    readonly color: string;
+    readonly alpha: number;
+};
+/**
+ * Renderer-agnostic intermediate representation every drawing reduces
+ * to. {@link decomposeDrawing} returns a flat `DrawPrimitive[]`; each
+ * adapter paints the list with its own sink (canvas `paintPrimitive`,
+ * Konva nodes, ECharts `graphic`, …). The four shapes — `polyline`,
+ * `arc`, `text`, `marker` — are the smallest set all the target chart
+ * libraries can consume.
+ *
+ * - `polyline` — an open or `closed` path with optional `stroke` / `fill`.
+ * - `arc` — a circular arc centred on `(cx, cy)` from `start` to `end`
+ *   radians, with optional `stroke` / `fill`.
+ * - `text` — a single label at `(x, y)` with explicit `align` / `baseline`.
+ * - `marker` — a sized glyph at `(x, y)` (reserved for adapter / future
+ *   kinds; no basic kind emits it).
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     const seg: DrawPrimitive = {
+ *         kind: "polyline",
+ *         points: [{ x: 0, y: 0 }, { x: 10, y: 10 }],
+ *         closed: false,
+ *         stroke: { color: "#000000", width: 1, dash: [] },
+ *     };
+ *     void seg;
+ */
+export type DrawPrimitive = {
+    readonly kind: "polyline";
+    readonly points: ReadonlyArray<Point2>;
+    readonly closed: boolean;
+    readonly stroke?: StrokeStyle;
+    readonly fill?: FillStyle;
+} | {
+    readonly kind: "arc";
+    readonly cx: number;
+    readonly cy: number;
+    readonly r: number;
+    readonly start: number;
+    readonly end: number;
+    /**
+     * Whether the painter issues `closePath()` after the arc —
+     * drawing the chord back to the arc's start. `true` only for a
+     * full-circle shape (e.g. `circle`); partial arcs (the
+     * `trend-angle` indicator, `time-cycles`) MUST be `false`, else
+     * the chord renders as a spurious diameter line.
+     */
+    readonly closed: boolean;
+    readonly stroke?: StrokeStyle;
+    readonly fill?: FillStyle;
+} | {
+    readonly kind: "text";
+    readonly x: number;
+    readonly y: number;
+    readonly text: string;
+    readonly color: string;
+    readonly font: string;
+    readonly align: "left" | "center" | "right";
+    readonly baseline: "top" | "middle" | "bottom";
+    readonly bgColor?: string;
+} | {
+    readonly kind: "marker";
+    readonly shape: "circle" | "square" | "diamond" | "triangle-up" | "triangle-down";
+    readonly x: number;
+    readonly y: number;
+    readonly size: number;
+    readonly stroke?: StrokeStyle;
+    readonly fill?: FillStyle;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/geometry/types.js

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

package/dist/geometry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/geometry/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\n/**\n * A 2D point in renderer pixel space — the structural type every\n * projection helper returns and every {@link DrawPrimitive} consumes.\n * Read-only so decomposers can't mutate vertices they don't own.\n *\n * @since 1.3\n * @stable\n * @example\n *     const p: Point2 = { x: 100, y: 50 };\n *     void p;\n */\nexport type Point2 = { readonly x: number; readonly y: number };\n\n/**\n * Visible window into world coordinates. `xMin`/`xMax` are bar times in\n * UTC milliseconds; `yMin`/`yMax` are prices in the quote currency.\n * `pxWidth`/`pxHeight` are the renderer's drawable size in CSS pixels.\n * Ported verbatim from the canvas2d adapter's `render/coords.ts` so all\n * adapters share one projection contract.\n *\n * @since 1.3\n * @stable\n * @example\n *     const vp: Viewport = {\n *         xMin: 0, xMax: 9, yMin: 100, yMax: 110,\n *         pxWidth: 800, pxHeight: 400,\n *     };\n *     void vp;\n */\nexport type Viewport = {\n    readonly xMin: number;\n    readonly xMax: number;\n    readonly yMin: number;\n    readonly yMax: number;\n    readonly pxWidth: number;\n    readonly pxHeight: number;\n};\n\n/**\n * Resolved stroke styling for a {@link DrawPrimitive}. `dash` is the\n * `setLineDash` segment array — `[]` is a solid stroke. Decomposers map\n * a `LineStyle` to `dash` via the `_lib/dash` helper.\n *\n * `alpha ∈ [0, 1]` is the optional stroke opacity the painter brackets\n * around the `stroke()` call (the `highlighter` freehand kind sets it).\n * When omitted the stroke is fully opaque and the painter emits no\n * `globalAlpha` mutation — so a stroke without `alpha` is byte-identical\n * to a Task-1 stroke.\n *\n * @since 1.3\n * @stable\n * @example\n *     const s: StrokeStyle = { color: \"#000000\", width: 1, dash: [] };\n *     void s;\n */\nexport type StrokeStyle = {\n    readonly color: string;\n    readonly width: number;\n    readonly dash: ReadonlyArray<number>;\n    readonly alpha?: number;\n};\n\n/**\n * Resolved fill styling for a {@link DrawPrimitive}. `alpha ∈ [0, 1]`\n * is applied around the fill so a subsequent stroke draws at full\n * opacity.\n *\n * @since 1.3\n * @stable\n * @example\n *     const f: FillStyle = { color: \"#dbeafe\", alpha: 0.4 };\n *     void f;\n */\nexport type FillStyle = { readonly color: string; readonly alpha: number };\n\n/**\n * Renderer-agnostic intermediate representation every drawing reduces\n * to. {@link decomposeDrawing} returns a flat `DrawPrimitive[]`; each\n * adapter paints the list with its own sink (canvas `paintPrimitive`,\n * Konva nodes, ECharts `graphic`, …). The four shapes — `polyline`,\n * `arc`, `text`, `marker` — are the smallest set all the target chart\n * libraries can consume.\n *\n * - `polyline` — an open or `closed` path with optional `stroke` / `fill`.\n * - `arc` — a circular arc centred on `(cx, cy)` from `start` to `end`\n *   radians, with optional `stroke` / `fill`.\n * - `text` — a single label at `(x, y)` with explicit `align` / `baseline`.\n * - `marker` — a sized glyph at `(x, y)` (reserved for adapter / future\n *   kinds; no basic kind emits it).\n *\n * @since 1.3\n * @stable\n * @example\n *     const seg: DrawPrimitive = {\n *         kind: \"polyline\",\n *         points: [{ x: 0, y: 0 }, { x: 10, y: 10 }],\n *         closed: false,\n *         stroke: { color: \"#000000\", width: 1, dash: [] },\n *     };\n *     void seg;\n */\nexport type DrawPrimitive =\n    | {\n          readonly kind: \"polyline\";\n          readonly points: ReadonlyArray<Point2>;\n          readonly closed: boolean;\n          readonly stroke?: StrokeStyle;\n          readonly fill?: FillStyle;\n      }\n    | {\n          readonly kind: \"arc\";\n          readonly cx: number;\n          readonly cy: number;\n          readonly r: number;\n          readonly start: number;\n          readonly end: number;\n          /**\n           * Whether the painter issues `closePath()` after the arc —\n           * drawing the chord back to the arc's start. `true` only for a\n           * full-circle shape (e.g. `circle`); partial arcs (the\n           * `trend-angle` indicator, `time-cycles`) MUST be `false`, else\n           * the chord renders as a spurious diameter line.\n           */\n          readonly closed: boolean;\n          readonly stroke?: StrokeStyle;\n          readonly fill?: FillStyle;\n      }\n    | {\n          readonly kind: \"text\";\n          readonly x: number;\n          readonly y: number;\n          readonly text: string;\n          readonly color: string;\n          readonly font: string;\n          readonly align: \"left\" | \"center\" | \"right\";\n          readonly baseline: \"top\" | \"middle\" | \"bottom\";\n          readonly bgColor?: string;\n      }\n    | {\n          readonly kind: \"marker\";\n          readonly shape: \"circle\" | \"square\" | \"diamond\" | \"triangle-up\" | \"triangle-down\";\n          readonly x: number;\n          readonly y: number;\n          readonly size: number;\n          readonly stroke?: StrokeStyle;\n          readonly fill?: FillStyle;\n      };\n"]}

package/dist/index.d.ts

@@ -8,5 +8,9 @@ export type { ValidationFail, ValidationOk, ValidationResult } from "./validatio
 export { mockCandleSource } from "./mocks/index.js";
 export type { MockCandleSourceMode, MockCandleSourceOpts } from "./mocks/index.js";
 export { BufferingAdapter, PassThroughAdapter } from "./base/index.js";
+export { decomposeDrawing, priceToY, timeToX, worldPointToPixel } from "./geometry/index.js";
+export type { DrawPrimitive, FillStyle, Point2, StrokeStyle, Viewport, } from "./geometry/index.js";
+export { attachInteraction, createViewController, onDblCore, onDragCore, onWheelCore, yRangeInWindow, } from "./interaction/index.js";
+export type { InteractionHandlers, ViewController, ViewControllerOpts, WindowYInput, XWindow, } from "./interaction/index.js";
 export type { Adapter, AdapterSymInfo, AlertChannel, AlertConditionEmission, AlertEmission, Capabilities, CandleEvent, DiagnosticCode, DrawingCounts, DrawingEmission, DrawingKind, InputKind, LogEmission, PlotEmission, PlotKind, PlotOverride, PlotSlotDescriptor, PlotStyle, RunnerEmissions, RuntimeDiagnostic, SymInfoField, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,YAAY,EACR,OAAO,EACP,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,EACd,aAAa,EACb,eAAe,EACf,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,YAAY,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,YAAY,EACR,aAAa,EACb,SAAS,EACT,MAAM,EACN,WAAW,EACX,QAAQ,GACX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,WAAW,EACX,cAAc,GACjB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACR,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,OAAO,GACV,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACR,OAAO,EACP,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,EACd,aAAa,EACb,eAAe,EACf,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,YAAY,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -6,4 +6,6 @@ export { PHASE_5_PLOT_KINDS, capabilities } from "./capabilities/index.js";
 export { decodeDrawing, validateEmission } from "./validation/index.js";
 export { mockCandleSource } from "./mocks/index.js";
 export { BufferingAdapter, PassThroughAdapter } from "./base/index.js";
+export { decomposeDrawing, priceToY, timeToX, worldPointToPixel } from "./geometry/index.js";
+export { attachInteraction, createViewController, onDblCore, onDragCore, onWheelCore, yRangeInWindow, } from "./interaction/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,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 { KIND_BUCKET, bucketFor } from \"@invinite-org/chartlang-core\";\nexport type { DrawingBucket, DrawingState } from \"@invinite-org/chartlang-core\";\nexport { defineAdapter } from \"./defineAdapter.js\";\nexport type { DefineAdapterOpts } from \"./defineAdapter.js\";\nexport { PHASE_5_PLOT_KINDS, capabilities } from \"./capabilities/index.js\";\nexport { decodeDrawing, validateEmission } from \"./validation/index.js\";\nexport type { ValidationFail, ValidationOk, ValidationResult } from \"./validation/index.js\";\nexport { mockCandleSource } from \"./mocks/index.js\";\nexport type { MockCandleSourceMode, MockCandleSourceOpts } from \"./mocks/index.js\";\nexport { BufferingAdapter, PassThroughAdapter } from \"./base/index.js\";\nexport type {\n    Adapter,\n    AdapterSymInfo,\n    AlertChannel,\n    AlertConditionEmission,\n    AlertEmission,\n    Capabilities,\n    CandleEvent,\n    DiagnosticCode,\n    DrawingCounts,\n    DrawingEmission,\n    DrawingKind,\n    InputKind,\n    LogEmission,\n    PlotEmission,\n    PlotKind,\n    PlotOverride,\n    PlotSlotDescriptor,\n    PlotStyle,\n    RunnerEmissions,\n    RuntimeDiagnostic,\n    SymInfoField,\n} from \"./types.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQ7F,OAAO,EACH,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,WAAW,EACX,cAAc,GACjB,MAAM,wBAAwB,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 { KIND_BUCKET, bucketFor } from \"@invinite-org/chartlang-core\";\nexport type { DrawingBucket, DrawingState } from \"@invinite-org/chartlang-core\";\nexport { defineAdapter } from \"./defineAdapter.js\";\nexport type { DefineAdapterOpts } from \"./defineAdapter.js\";\nexport { PHASE_5_PLOT_KINDS, capabilities } from \"./capabilities/index.js\";\nexport { decodeDrawing, validateEmission } from \"./validation/index.js\";\nexport type { ValidationFail, ValidationOk, ValidationResult } from \"./validation/index.js\";\nexport { mockCandleSource } from \"./mocks/index.js\";\nexport type { MockCandleSourceMode, MockCandleSourceOpts } from \"./mocks/index.js\";\nexport { BufferingAdapter, PassThroughAdapter } from \"./base/index.js\";\nexport { decomposeDrawing, priceToY, timeToX, worldPointToPixel } from \"./geometry/index.js\";\nexport type {\n    DrawPrimitive,\n    FillStyle,\n    Point2,\n    StrokeStyle,\n    Viewport,\n} from \"./geometry/index.js\";\nexport {\n    attachInteraction,\n    createViewController,\n    onDblCore,\n    onDragCore,\n    onWheelCore,\n    yRangeInWindow,\n} from \"./interaction/index.js\";\nexport type {\n    InteractionHandlers,\n    ViewController,\n    ViewControllerOpts,\n    WindowYInput,\n    XWindow,\n} from \"./interaction/index.js\";\nexport type {\n    Adapter,\n    AdapterSymInfo,\n    AlertChannel,\n    AlertConditionEmission,\n    AlertEmission,\n    Capabilities,\n    CandleEvent,\n    DiagnosticCode,\n    DrawingCounts,\n    DrawingEmission,\n    DrawingKind,\n    InputKind,\n    LogEmission,\n    PlotEmission,\n    PlotKind,\n    PlotOverride,\n    PlotSlotDescriptor,\n    PlotStyle,\n    RunnerEmissions,\n    RuntimeDiagnostic,\n    SymInfoField,\n} from \"./types.js\";\n"]}

package/dist/interaction/domWiring.d.ts

@@ -0,0 +1,90 @@
+import type { ViewController } from "./viewController.js";
+/**
+ * The per-frame projection + data context {@link attachInteraction} needs
+ * to translate pixel gestures into world-x transforms. The adapter supplies
+ * these closing over its latest overlay `Viewport`, so the math always uses
+ * the current frame's scale.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     declare const view: import("./viewController.js").ViewController;
+ *     const h: InteractionHandlers = {
+ *         controller: view,
+ *         pxToWorldX: (px) => px,
+ *         worldXPerPx: () => 1,
+ *         dataBounds: () => ({ xMin: 0, xMax: 100 }),
+ *         requestRender: () => {},
+ *     };
+ *     void h;
+ */
+export type InteractionHandlers = {
+    /** The controller whose window the gestures mutate. */
+    readonly controller: ViewController;
+    /** Map a plot-area pixel x to a world x for the current frame. */
+    readonly pxToWorldX: (px: number) => number;
+    /** World-x units per pixel for the current frame (pan delta scale). */
+    readonly worldXPerPx: () => number;
+    /** The current data x extent (grows as bars stream in). */
+    readonly dataBounds: () => {
+        readonly xMin: number;
+        readonly xMax: number;
+    };
+    /** Re-render the adapter after a gesture mutates the window. */
+    readonly requestRender: () => void;
+    /** Override the wheel zoom sensitivity (default {@link DEFAULT_ZOOM_STEP}). */
+    readonly zoomStep?: number;
+};
+/**
+ * Apply one wheel notch: zoom the controller about the world-x under the
+ * cursor, then request a render. Pure on `(offsetX, deltaY)` so it is unit
+ * tested without a DOM event.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     declare const h: InteractionHandlers;
+ *     onWheelCore(h, 50, -120); // zoom in about pixel x=50
+ */
+export declare function onWheelCore(h: InteractionHandlers, offsetX: number, deltaY: number): void;
+/**
+ * Apply one drag step: pan the controller by the pixel delta converted to
+ * world x (dragging right reveals earlier data), then request a render.
+ * Pure on `dxPx`.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     declare const h: InteractionHandlers;
+ *     onDragCore(h, 12); // pan left by 12 px
+ */
+export declare function onDragCore(h: InteractionHandlers, dxPx: number): void;
+/**
+ * Apply a double-click: reset the controller to auto-follow, then request a
+ * render.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     declare const h: InteractionHandlers;
+ *     onDblCore(h);
+ */
+export declare function onDblCore(h: InteractionHandlers): void;
+/**
+ * Wire wheel-zoom, drag-pan, and double-click-reset on `el`, driving the
+ * supplied {@link InteractionHandlers}. Returns a detach function that
+ * removes every listener (call it from the adapter's `dispose`). The
+ * `addEventListener` plumbing is the only DOM-bound part; the decision
+ * logic lives in {@link onWheelCore} / {@link onDragCore} / {@link
+ * onDblCore}, which are unit tested directly.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     declare const el: HTMLElement;
+ *     declare const h: InteractionHandlers;
+ *     const detach = attachInteraction(el, h);
+ *     detach();
+ */
+export declare function attachInteraction(el: HTMLElement, h: InteractionHandlers): () => void;
+//# sourceMappingURL=domWiring.d.ts.map

package/dist/interaction/domWiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domWiring.d.ts","sourceRoot":"","sources":["../../src/interaction/domWiring.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQ1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAKzF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAGtD;AAED;;;;;;;;;;;;;;;GAeG;AAEH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAwCrF"}

package/dist/interaction/domWiring.js

@@ -0,0 +1,113 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+// Wheel notch → zoom factor sensitivity. A positive `deltaY` (scroll down)
+// yields a factor > 1 (zoom out); negative (scroll up) yields < 1 (zoom in).
+// `Math.exp` keeps both directions symmetric, so zoom-out always exists —
+// the bug the native-default drag-zoom-in lacked.
+const DEFAULT_ZOOM_STEP = 0.0015;
+/**
+ * Apply one wheel notch: zoom the controller about the world-x under the
+ * cursor, then request a render. Pure on `(offsetX, deltaY)` so it is unit
+ * tested without a DOM event.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     declare const h: InteractionHandlers;
+ *     onWheelCore(h, 50, -120); // zoom in about pixel x=50
+ */
+export function onWheelCore(h, offsetX, deltaY) {
+    const factor = Math.exp(deltaY * (h.zoomStep ?? DEFAULT_ZOOM_STEP));
+    const { xMin, xMax } = h.dataBounds();
+    h.controller.zoomAt(h.pxToWorldX(offsetX), factor, xMin, xMax);
+    h.requestRender();
+}
+/**
+ * Apply one drag step: pan the controller by the pixel delta converted to
+ * world x (dragging right reveals earlier data), then request a render.
+ * Pure on `dxPx`.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     declare const h: InteractionHandlers;
+ *     onDragCore(h, 12); // pan left by 12 px
+ */
+export function onDragCore(h, dxPx) {
+    const { xMin, xMax } = h.dataBounds();
+    h.controller.panBy(-dxPx * h.worldXPerPx(), xMin, xMax);
+    h.requestRender();
+}
+/**
+ * Apply a double-click: reset the controller to auto-follow, then request a
+ * render.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     declare const h: InteractionHandlers;
+ *     onDblCore(h);
+ */
+export function onDblCore(h) {
+    h.controller.reset();
+    h.requestRender();
+}
+/**
+ * Wire wheel-zoom, drag-pan, and double-click-reset on `el`, driving the
+ * supplied {@link InteractionHandlers}. Returns a detach function that
+ * removes every listener (call it from the adapter's `dispose`). The
+ * `addEventListener` plumbing is the only DOM-bound part; the decision
+ * logic lives in {@link onWheelCore} / {@link onDragCore} / {@link
+ * onDblCore}, which are unit tested directly.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     declare const el: HTMLElement;
+ *     declare const h: InteractionHandlers;
+ *     const detach = attachInteraction(el, h);
+ *     detach();
+ */
+/* v8 ignore start -- DOM event plumbing; the pure cores above carry the coverage */
+export function attachInteraction(el, h) {
+    let dragging = false;
+    let lastX = 0;
+    const onWheel = (e) => {
+        e.preventDefault();
+        onWheelCore(h, e.offsetX, e.deltaY);
+    };
+    const onPointerDown = (e) => {
+        dragging = true;
+        lastX = e.clientX;
+        el.setPointerCapture(e.pointerId);
+    };
+    const onPointerMove = (e) => {
+        if (!dragging)
+            return;
+        const dx = e.clientX - lastX;
+        lastX = e.clientX;
+        onDragCore(h, dx);
+    };
+    const onPointerUp = (e) => {
+        dragging = false;
+        if (el.hasPointerCapture(e.pointerId))
+            el.releasePointerCapture(e.pointerId);
+    };
+    const onDblClick = () => {
+        onDblCore(h);
+    };
+    el.addEventListener("wheel", onWheel, { passive: false });
+    el.addEventListener("pointerdown", onPointerDown);
+    el.addEventListener("pointermove", onPointerMove);
+    el.addEventListener("pointerup", onPointerUp);
+    el.addEventListener("dblclick", onDblClick);
+    return () => {
+        el.removeEventListener("wheel", onWheel);
+        el.removeEventListener("pointerdown", onPointerDown);
+        el.removeEventListener("pointermove", onPointerMove);
+        el.removeEventListener("pointerup", onPointerUp);
+        el.removeEventListener("dblclick", onDblClick);
+    };
+}
+/* v8 ignore stop */
+//# sourceMappingURL=domWiring.js.map

package/dist/interaction/domWiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domWiring.js","sourceRoot":"","sources":["../../src/interaction/domWiring.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 { ViewController } from \"./viewController.js\";\n\n// Wheel notch → zoom factor sensitivity. A positive `deltaY` (scroll down)\n// yields a factor > 1 (zoom out); negative (scroll up) yields < 1 (zoom in).\n// `Math.exp` keeps both directions symmetric, so zoom-out always exists —\n// the bug the native-default drag-zoom-in lacked.\nconst DEFAULT_ZOOM_STEP = 0.0015;\n\n/**\n * The per-frame projection + data context {@link attachInteraction} needs\n * to translate pixel gestures into world-x transforms. The adapter supplies\n * these closing over its latest overlay `Viewport`, so the math always uses\n * the current frame's scale.\n *\n * @since 1.6\n * @stable\n * @example\n *     declare const view: import(\"./viewController.js\").ViewController;\n *     const h: InteractionHandlers = {\n *         controller: view,\n *         pxToWorldX: (px) => px,\n *         worldXPerPx: () => 1,\n *         dataBounds: () => ({ xMin: 0, xMax: 100 }),\n *         requestRender: () => {},\n *     };\n *     void h;\n */\nexport type InteractionHandlers = {\n    /** The controller whose window the gestures mutate. */\n    readonly controller: ViewController;\n    /** Map a plot-area pixel x to a world x for the current frame. */\n    readonly pxToWorldX: (px: number) => number;\n    /** World-x units per pixel for the current frame (pan delta scale). */\n    readonly worldXPerPx: () => number;\n    /** The current data x extent (grows as bars stream in). */\n    readonly dataBounds: () => { readonly xMin: number; readonly xMax: number };\n    /** Re-render the adapter after a gesture mutates the window. */\n    readonly requestRender: () => void;\n    /** Override the wheel zoom sensitivity (default {@link DEFAULT_ZOOM_STEP}). */\n    readonly zoomStep?: number;\n};\n\n/**\n * Apply one wheel notch: zoom the controller about the world-x under the\n * cursor, then request a render. Pure on `(offsetX, deltaY)` so it is unit\n * tested without a DOM event.\n *\n * @since 1.6\n * @stable\n * @example\n *     declare const h: InteractionHandlers;\n *     onWheelCore(h, 50, -120); // zoom in about pixel x=50\n */\nexport function onWheelCore(h: InteractionHandlers, offsetX: number, deltaY: number): void {\n    const factor = Math.exp(deltaY * (h.zoomStep ?? DEFAULT_ZOOM_STEP));\n    const { xMin, xMax } = h.dataBounds();\n    h.controller.zoomAt(h.pxToWorldX(offsetX), factor, xMin, xMax);\n    h.requestRender();\n}\n\n/**\n * Apply one drag step: pan the controller by the pixel delta converted to\n * world x (dragging right reveals earlier data), then request a render.\n * Pure on `dxPx`.\n *\n * @since 1.6\n * @stable\n * @example\n *     declare const h: InteractionHandlers;\n *     onDragCore(h, 12); // pan left by 12 px\n */\nexport function onDragCore(h: InteractionHandlers, dxPx: number): void {\n    const { xMin, xMax } = h.dataBounds();\n    h.controller.panBy(-dxPx * h.worldXPerPx(), xMin, xMax);\n    h.requestRender();\n}\n\n/**\n * Apply a double-click: reset the controller to auto-follow, then request a\n * render.\n *\n * @since 1.6\n * @stable\n * @example\n *     declare const h: InteractionHandlers;\n *     onDblCore(h);\n */\nexport function onDblCore(h: InteractionHandlers): void {\n    h.controller.reset();\n    h.requestRender();\n}\n\n/**\n * Wire wheel-zoom, drag-pan, and double-click-reset on `el`, driving the\n * supplied {@link InteractionHandlers}. Returns a detach function that\n * removes every listener (call it from the adapter's `dispose`). The\n * `addEventListener` plumbing is the only DOM-bound part; the decision\n * logic lives in {@link onWheelCore} / {@link onDragCore} / {@link\n * onDblCore}, which are unit tested directly.\n *\n * @since 1.6\n * @stable\n * @example\n *     declare const el: HTMLElement;\n *     declare const h: InteractionHandlers;\n *     const detach = attachInteraction(el, h);\n *     detach();\n */\n/* v8 ignore start -- DOM event plumbing; the pure cores above carry the coverage */\nexport function attachInteraction(el: HTMLElement, h: InteractionHandlers): () => void {\n    let dragging = false;\n    let lastX = 0;\n\n    const onWheel = (e: WheelEvent): void => {\n        e.preventDefault();\n        onWheelCore(h, e.offsetX, e.deltaY);\n    };\n    const onPointerDown = (e: PointerEvent): void => {\n        dragging = true;\n        lastX = e.clientX;\n        el.setPointerCapture(e.pointerId);\n    };\n    const onPointerMove = (e: PointerEvent): void => {\n        if (!dragging) return;\n        const dx = e.clientX - lastX;\n        lastX = e.clientX;\n        onDragCore(h, dx);\n    };\n    const onPointerUp = (e: PointerEvent): void => {\n        dragging = false;\n        if (el.hasPointerCapture(e.pointerId)) el.releasePointerCapture(e.pointerId);\n    };\n    const onDblClick = (): void => {\n        onDblCore(h);\n    };\n\n    el.addEventListener(\"wheel\", onWheel, { passive: false });\n    el.addEventListener(\"pointerdown\", onPointerDown);\n    el.addEventListener(\"pointermove\", onPointerMove);\n    el.addEventListener(\"pointerup\", onPointerUp);\n    el.addEventListener(\"dblclick\", onDblClick);\n\n    return (): void => {\n        el.removeEventListener(\"wheel\", onWheel);\n        el.removeEventListener(\"pointerdown\", onPointerDown);\n        el.removeEventListener(\"pointermove\", onPointerMove);\n        el.removeEventListener(\"pointerup\", onPointerUp);\n        el.removeEventListener(\"dblclick\", onDblClick);\n    };\n}\n/* v8 ignore stop */\n"]}

package/dist/interaction/index.d.ts

@@ -0,0 +1,5 @@
+export { createViewController, yRangeInWindow } from "./viewController.js";
+export type { ViewController, ViewControllerOpts, WindowYInput, XWindow, } from "./viewController.js";
+export { attachInteraction, onDblCore, onDragCore, onWheelCore } from "./domWiring.js";
+export type { InteractionHandlers } from "./domWiring.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interaction/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EACR,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,OAAO,GACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACvF,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/interaction/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 { createViewController, yRangeInWindow } from "./viewController.js";
+export { attachInteraction, onDblCore, onDragCore, onWheelCore } from "./domWiring.js";
+//# sourceMappingURL=index.js.map

package/dist/interaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interaction/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO3E,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,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 { createViewController, yRangeInWindow } from \"./viewController.js\";\nexport type {\n    ViewController,\n    ViewControllerOpts,\n    WindowYInput,\n    XWindow,\n} from \"./viewController.js\";\nexport { attachInteraction, onDblCore, onDragCore, onWheelCore } from \"./domWiring.js\";\nexport type { InteractionHandlers } from \"./domWiring.js\";\n"]}

package/dist/interaction/viewController.d.ts

@@ -0,0 +1,120 @@
+/**
+ * A visible window into the world x axis (bar times in UTC ms). The two
+ * self-scaled adapters (canvas2d, konva) resolve one per frame from a
+ * {@link ViewController} and feed `xMin`/`xMax` into their `Viewport`.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     const win: XWindow = { xMin: 0, xMax: 100 };
+ *     void win;
+ */
+export type XWindow = {
+    readonly xMin: number;
+    readonly xMax: number;
+};
+/**
+ * Construction options for {@link createViewController}. `minSpan` is the
+ * smallest world-x span a zoom-in can reach (so the window never collapses
+ * to a point); `maxSpanFactor` is the largest span a zoom-out can reach as
+ * a multiple of the current data span (default `1` ⇒ cannot zoom out past
+ * "all data visible").
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     const opts: ViewControllerOpts = { minSpan: 1, maxSpanFactor: 1 };
+ *     void opts;
+ */
+export type ViewControllerOpts = {
+    readonly minSpan?: number;
+    readonly maxSpanFactor?: number;
+};
+/**
+ * Stateful, library-agnostic pan/zoom controller for an adapter that
+ * computes its own x scale every frame. It holds a user x-window plus a
+ * `userInteracted` flag: until the user wheels or drags, {@link
+ * ViewController.resolveXWindow} returns the full data range (auto-follow
+ * live bars); after the first interaction it returns the held window
+ * (re-clamped as data grows), so live frames stop snapping the view back.
+ *
+ * All transforms are pure functions of the current state + the supplied
+ * data bounds — there is no DOM or library coupling. The example adapters
+ * wire DOM events to {@link ViewController.zoomAt} / {@link
+ * ViewController.panBy} / {@link ViewController.reset} via {@link
+ * attachInteraction}.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     const view = createViewController();
+ *     view.resolveXWindow(0, 100); // { xMin: 0, xMax: 100 } (auto-follow)
+ *     view.panBy(10, 0, 100);
+ *     view.userInteracted; // true
+ */
+export type ViewController = {
+    /** `true` once the user has zoomed or panned (auto-follow is paused). */
+    readonly userInteracted: boolean;
+    /**
+     * The x-window to render this frame: `[dataXMin, dataXMax]` while not
+     * interacted (auto-follow), else the held window clamped into the
+     * current data bounds.
+     */
+    resolveXWindow(dataXMin: number, dataXMax: number): XWindow;
+    /** Zoom by `factor` (`<1` in, `>1` out) about a world-x pivot. */
+    zoomAt(pivotX: number, factor: number, dataXMin: number, dataXMax: number): void;
+    /** Pan the window by a signed world-x delta. */
+    panBy(deltaWorldX: number, dataXMin: number, dataXMax: number): void;
+    /** Clear the held window + flag so the view auto-follows again. */
+    reset(): void;
+};
+/**
+ * Build a {@link ViewController}. Pass `opts` to tune the zoom-in floor
+ * (`minSpan`) and zoom-out ceiling (`maxSpanFactor`); both default to a
+ * "1 ms floor, all-data ceiling" policy.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     const view = createViewController({ minSpan: 2, maxSpanFactor: 1 });
+ *     view.zoomAt(50, 0.5, 0, 100); // zoom in 2× about x=50
+ *     void view.resolveXWindow(0, 100);
+ */
+export declare function createViewController(opts?: ViewControllerOpts): ViewController;
+/**
+ * One candidate row for {@link yRangeInWindow}: a world `x` (bar time) plus
+ * the low / high values to fold into the y range when `x` is inside the
+ * window. Bars pass `{ x: time, lo: low, hi: high }`; a scalar series point
+ * passes `lo === hi === value`.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     const c: WindowYInput = { x: 10, lo: 99, hi: 101 };
+ *     void c;
+ */
+export type WindowYInput = {
+    readonly x: number;
+    readonly lo: number;
+    readonly hi: number;
+};
+/**
+ * Fold the y range of every candidate whose `x` falls inside `win` — the
+ * shared "auto-fit the price scale to the visible window" helper (matching
+ * lightweight-charts' auto price scale). Non-finite `lo`/`hi` rows are
+ * skipped. Returns `undefined` when no finite in-window candidate is seen,
+ * so the caller keeps its own degenerate-range fallback. Horizontal lines
+ * (no `x`) are folded in by the caller, not here.
+ *
+ * @since 1.6
+ * @stable
+ * @example
+ *     const r = yRangeInWindow([{ x: 5, lo: 1, hi: 3 }], { xMin: 0, xMax: 10 });
+ *     // r === { yMin: 1, yMax: 3 }
+ *     void r;
+ */
+export declare function yRangeInWindow(candidates: Iterable<WindowYInput>, win: XWindow): {
+    readonly yMin: number;
+    readonly yMax: number;
+} | undefined;
+//# sourceMappingURL=viewController.d.ts.map

package/dist/interaction/viewController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewController.d.ts","sourceRoot":"","sources":["../../src/interaction/viewController.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,OAAO,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5D,kEAAkE;IAClE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjF,gDAAgD;IAChD,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACrE,mEAAmE;IACnE,KAAK,IAAI,IAAI,CAAC;CACjB,CAAC;AAsCF;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAgD9E;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC1B,UAAU,EAAE,QAAQ,CAAC,YAAY,CAAC,EAClC,GAAG,EAAE,OAAO,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAW9D"}