@invinite-org/chartlang-adapter-kit 1.1.0

package/dist/defineAdapter.d.ts

@@ -0,0 +1,74 @@
+import type { Adapter } from "./types.js";
+/**
+ * Options accepted by {@link defineAdapter}. `dispose` is optional —
+ * `defineAdapter` substitutes a no-op when omitted.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     const opts: DefineAdapterOpts = {
+ *         id: "demo",
+ *         name: "Demo",
+ *         capabilities: {
+ *             plots: new Set(),
+ *             drawings: new Set(),
+ *             alerts: new Set(),
+ *             alertConditions: false,
+ *             logs: false,
+ *             inputs: new Set(),
+ *             intervals: [],
+ *             multiTimeframe: false,
+ *             subPanes: 0,
+ *             symInfoFields: new Set(),
+ *             maxDrawingsPerScript: {
+ *                 lines: 0, labels: 0, boxes: 0, polylines: 0, other: 0,
+ *             },
+ *             maxLookback: 0,
+ *             maxTickHz: 0,
+ *         },
+ *         candles: () => ({ async *[Symbol.asyncIterator]() {} }),
+ *         onEmissions: () => {},
+ *     };
+ */
+export type DefineAdapterOpts = Omit<Adapter, "dispose"> & {
+    readonly dispose?: () => void;
+};
+/**
+ * Wrap an adapter description in a stable factory so consumer-repo
+ * adapters get a single entry point + a default no-op `dispose`. The
+ * returned object aliases the supplied callbacks by reference — no
+ * normalisation, no cloning.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { defineAdapter, capabilities, mockCandleSource }
+ *         from "@invinite-org/chartlang-adapter-kit";
+ *
+ *     const adapter = defineAdapter({
+ *         id: "demo",
+ *         name: "Demo",
+ *         capabilities: {
+ *             plots: capabilities.allLines(),
+ *             drawings: new Set(),
+ *             alerts: new Set(),
+ *             alertConditions: false,
+ *             logs: false,
+ *             inputs: new Set(),
+ *             intervals: [],
+ *             multiTimeframe: false,
+ *             subPanes: 0,
+ *             symInfoFields: new Set(),
+ *             maxDrawingsPerScript: {
+ *                 lines: 0, labels: 0, boxes: 0, polylines: 0, other: 0,
+ *             },
+ *             maxLookback: 5000,
+ *             maxTickHz: 10,
+ *         },
+ *         candles: () => mockCandleSource([]),
+ *         onEmissions: () => {},
+ *     });
+ *     void adapter;
+ */
+export declare function defineAdapter(opts: DefineAdapterOpts): Adapter;
+//# sourceMappingURL=defineAdapter.d.ts.map

package/dist/defineAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineAdapter.d.ts","sourceRoot":"","sources":["../src/defineAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAW9D"}

package/dist/defineAdapter.js

@@ -0,0 +1,55 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Wrap an adapter description in a stable factory so consumer-repo
+ * adapters get a single entry point + a default no-op `dispose`. The
+ * returned object aliases the supplied callbacks by reference — no
+ * normalisation, no cloning.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { defineAdapter, capabilities, mockCandleSource }
+ *         from "@invinite-org/chartlang-adapter-kit";
+ *
+ *     const adapter = defineAdapter({
+ *         id: "demo",
+ *         name: "Demo",
+ *         capabilities: {
+ *             plots: capabilities.allLines(),
+ *             drawings: new Set(),
+ *             alerts: new Set(),
+ *             alertConditions: false,
+ *             logs: false,
+ *             inputs: new Set(),
+ *             intervals: [],
+ *             multiTimeframe: false,
+ *             subPanes: 0,
+ *             symInfoFields: new Set(),
+ *             maxDrawingsPerScript: {
+ *                 lines: 0, labels: 0, boxes: 0, polylines: 0, other: 0,
+ *             },
+ *             maxLookback: 5000,
+ *             maxTickHz: 10,
+ *         },
+ *         candles: () => mockCandleSource([]),
+ *         onEmissions: () => {},
+ *     });
+ *     void adapter;
+ */
+export function defineAdapter(opts) {
+    return {
+        id: opts.id,
+        name: opts.name,
+        capabilities: opts.capabilities,
+        ...(opts.resolveInputs !== undefined ? { resolveInputs: opts.resolveInputs } : {}),
+        ...(opts.symInfo !== undefined ? { symInfo: opts.symInfo } : {}),
+        candles: opts.candles,
+        onEmissions: opts.onEmissions,
+        dispose: opts.dispose ?? noopDispose,
+    };
+}
+function noopDispose() {
+    // intentional no-op
+}
+//# sourceMappingURL=defineAdapter.js.map

package/dist/defineAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineAdapter.js","sourceRoot":"","sources":["../src/defineAdapter.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAuC/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,aAAa,CAAC,IAAuB;IACjD,OAAO;QACH,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,WAAW;KACvC,CAAC;AACN,CAAC;AAED,SAAS,WAAW;IAChB,oBAAoB;AACxB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { KIND_BUCKET, bucketFor } from "@invinite-org/chartlang-core";
+export type { DrawingBucket, DrawingState } from "@invinite-org/chartlang-core";
+export { defineAdapter } from "./defineAdapter.js";
+export type { DefineAdapterOpts } from "./defineAdapter.js";
+export { PHASE_5_PLOT_KINDS, capabilities } from "./capabilities/index.js";
+export { decodeDrawing, validateEmission } from "./validation/index.js";
+export type { ValidationFail, ValidationOk, ValidationResult } from "./validation/index.js";
+export { mockCandleSource } from "./mocks/index.js";
+export type { MockCandleSourceMode, MockCandleSourceOpts } from "./mocks/index.js";
+export { BufferingAdapter, PassThroughAdapter } from "./base/index.js";
+export type { Adapter, AdapterSymInfo, AlertChannel, AlertConditionEmission, AlertEmission, Capabilities, CandleEvent, DiagnosticCode, DrawingCounts, DrawingEmission, DrawingKind, InputKind, LogEmission, PlotEmission, PlotKind, PlotStyle, RunnerEmissions, RuntimeDiagnostic, SymInfoField, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,YAAY,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+export { KIND_BUCKET, bucketFor } from "@invinite-org/chartlang-core";
+export { defineAdapter } from "./defineAdapter.js";
+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";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/mocks/index.d.ts

@@ -0,0 +1,3 @@
+export { mockCandleSource } from "./mockCandleSource.js";
+export type { MockCandleSourceMode, MockCandleSourceOpts } from "./mockCandleSource.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mocks/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/mocks/index.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 { mockCandleSource } from "./mockCandleSource.js";
+//# sourceMappingURL=index.js.map

package/dist/mocks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mocks/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/mocks/mockCandleSource.d.ts

@@ -0,0 +1,68 @@
+import type { Bar } from "@invinite-org/chartlang-core";
+import type { CandleEvent } from "../types.js";
+/**
+ * How a {@link mockCandleSource} surfaces the supplied bars:
+ *
+ * - `history` — yields one warm-up batch with every bar.
+ * - `stream` — yields one `close` event per bar in array order.
+ * - `history-then-stream` — yields one history batch containing all
+ *   but the last `streamTail` bars, then a `close` event per
+ *   remaining bar. Lets a consumer paint a chart instantly from
+ *   the warm-up batch and still receive per-bar ticks afterwards.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     const m: MockCandleSourceMode = "history-then-stream";
+ */
+export type MockCandleSourceMode = "history" | "stream" | "history-then-stream";
+/**
+ * Options accepted by {@link mockCandleSource}. `interval` mirrors the
+ * `Bar.interval` field; `mode` defaults to `"history"`. `streamTail`
+ * applies only when `mode === "history-then-stream"` and defaults to
+ * `1` — the smallest non-zero value, leaving a single tail bar to
+ * stream after the warm-up batch. `streamTail` is clamped to
+ * `[0, bars.length]`.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     const o: MockCandleSourceOpts = {
+ *         interval: "1D",
+ *         mode: "history-then-stream",
+ *         streamTail: 20,
+ *     };
+ */
+export type MockCandleSourceOpts = {
+    readonly interval: string;
+    readonly mode?: MockCandleSourceMode;
+    readonly streamTail?: number;
+};
+/**
+ * Wrap a static `Bar[]` array in an `AsyncIterable<CandleEvent>` the
+ * runtime + conformance tests can drive directly.
+ *
+ * - `"history"` (default) — yields exactly one
+ *   `{ kind: "history", bars }` event.
+ * - `"stream"` — yields one `{ kind: "close", bar }` per bar in array
+ *   order.
+ * - `"history-then-stream"` — yields a single
+ *   `{ kind: "history", bars }` event for all but the trailing
+ *   `streamTail` bars (default `1`), then one `{ kind: "close", bar }`
+ *   per remaining bar. With `streamTail` clamped to `[0, bars.length]`,
+ *   `streamTail === 0` degenerates to a pure history batch and
+ *   `streamTail >= bars.length` yields an empty history batch followed
+ *   by a close-per-bar.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { mockCandleSource } from "@invinite-org/chartlang-adapter-kit";
+ *
+ *     const source = mockCandleSource([], { interval: "1D" });
+ *     for await (const e of source) {
+ *         void e;
+ *     }
+ */
+export declare function mockCandleSource(bars: ReadonlyArray<Bar>, opts?: MockCandleSourceOpts): AsyncIterable<CandleEvent>;
+//# sourceMappingURL=mockCandleSource.d.ts.map

package/dist/mocks/mockCandleSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockCandleSource.d.ts","sourceRoot":"","sources":["../../src/mocks/mockCandleSource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,QAAQ,GAAG,qBAAqB,CAAC;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAIF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAC5B,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,EACxB,IAAI,GAAE,oBAAyC,GAChD,aAAa,CAAC,WAAW,CAAC,CAuB5B"}

package/dist/mocks/mockCandleSource.js

@@ -0,0 +1,61 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+const DEFAULT_STREAM_TAIL = 1;
+/**
+ * Wrap a static `Bar[]` array in an `AsyncIterable<CandleEvent>` the
+ * runtime + conformance tests can drive directly.
+ *
+ * - `"history"` (default) — yields exactly one
+ *   `{ kind: "history", bars }` event.
+ * - `"stream"` — yields one `{ kind: "close", bar }` per bar in array
+ *   order.
+ * - `"history-then-stream"` — yields a single
+ *   `{ kind: "history", bars }` event for all but the trailing
+ *   `streamTail` bars (default `1`), then one `{ kind: "close", bar }`
+ *   per remaining bar. With `streamTail` clamped to `[0, bars.length]`,
+ *   `streamTail === 0` degenerates to a pure history batch and
+ *   `streamTail >= bars.length` yields an empty history batch followed
+ *   by a close-per-bar.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { mockCandleSource } from "@invinite-org/chartlang-adapter-kit";
+ *
+ *     const source = mockCandleSource([], { interval: "1D" });
+ *     for await (const e of source) {
+ *         void e;
+ *     }
+ */
+export function mockCandleSource(bars, opts = { interval: "1D" }) {
+    const mode = opts.mode ?? "history";
+    const streamTail = clampTail(opts.streamTail ?? DEFAULT_STREAM_TAIL, bars.length);
+    return {
+        async *[Symbol.asyncIterator]() {
+            if (mode === "history") {
+                yield { kind: "history", bars };
+                return;
+            }
+            if (mode === "stream") {
+                for (const bar of bars) {
+                    yield { kind: "close", bar };
+                }
+                return;
+            }
+            // history-then-stream
+            const splitAt = bars.length - streamTail;
+            yield { kind: "history", bars: bars.slice(0, splitAt) };
+            for (let i = splitAt; i < bars.length; i += 1) {
+                yield { kind: "close", bar: bars[i] };
+            }
+        },
+    };
+}
+function clampTail(value, total) {
+    if (!Number.isFinite(value) || value < 0)
+        return 0;
+    if (value > total)
+        return total;
+    return Math.floor(value);
+}
+//# sourceMappingURL=mockCandleSource.js.map

package/dist/mocks/mockCandleSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockCandleSource.js","sourceRoot":"","sources":["../../src/mocks/mockCandleSource.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AA6C/D,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,gBAAgB,CAC5B,IAAwB,EACxB,OAA6B,EAAE,QAAQ,EAAE,IAAI,EAAE;IAE/C,MAAM,IAAI,GAAyB,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC;IAC1D,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,UAAU,IAAI,mBAAmB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAClF,OAAO;QACH,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;YACzB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACrB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;gBAChC,OAAO;YACX,CAAC;YACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACrB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;gBACjC,CAAC;gBACD,OAAO;YACX,CAAC;YACD,sBAAsB;YACtB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;YACzC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC;YACxD,KAAK,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,CAAC;QACL,CAAC;KACJ,CAAC;AACN,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,KAAa;IAC3C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACnD,IAAI,KAAK,GAAG,KAAK;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}