@invinite-org/chartlang-adapter-kit 1.1.0

package/dist/validation/decodeDrawing.d.ts

@@ -0,0 +1,29 @@
+import type { DrawingState } from "@invinite-org/chartlang-core";
+import type { DrawingEmission } from "../types.js";
+/**
+ * Narrow a {@link DrawingEmission} to its typed {@link DrawingState}.
+ * Returns `null` when the emission fails the same validation
+ * {@link validateEmission} runs — adapters that want to know WHY call
+ * `validateEmission(e)` directly and inspect `.code` / `.message`.
+ *
+ * Successful narrows return `e.state` typed as `DrawingState`; the
+ * caller can switch on `state.kind` for per-kind handling. The
+ * validator pins `state.kind === e.drawingKind`, so the discriminator
+ * is safe.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     import { decodeDrawing } from "@invinite-org/chartlang-adapter-kit";
+ *     import type { DrawingEmission } from "@invinite-org/chartlang-adapter-kit";
+ *
+ *     declare const e: DrawingEmission;
+ *     const state = decodeDrawing(e);
+ *     if (state !== null && state.kind === "line") {
+ *         const [from, to] = state.anchors;
+ *         void from;
+ *         void to;
+ *     }
+ */
+export declare function decodeDrawing(e: DrawingEmission): DrawingState | null;
+//# sourceMappingURL=decodeDrawing.d.ts.map

package/dist/validation/decodeDrawing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeDrawing.d.ts","sourceRoot":"","sources":["../../src/validation/decodeDrawing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,eAAe,GAAG,YAAY,GAAG,IAAI,CAIrE"}

package/dist/validation/decodeDrawing.js

@@ -0,0 +1,35 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { validateEmission } from "./validateEmission.js";
+/**
+ * Narrow a {@link DrawingEmission} to its typed {@link DrawingState}.
+ * Returns `null` when the emission fails the same validation
+ * {@link validateEmission} runs — adapters that want to know WHY call
+ * `validateEmission(e)` directly and inspect `.code` / `.message`.
+ *
+ * Successful narrows return `e.state` typed as `DrawingState`; the
+ * caller can switch on `state.kind` for per-kind handling. The
+ * validator pins `state.kind === e.drawingKind`, so the discriminator
+ * is safe.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     import { decodeDrawing } from "@invinite-org/chartlang-adapter-kit";
+ *     import type { DrawingEmission } from "@invinite-org/chartlang-adapter-kit";
+ *
+ *     declare const e: DrawingEmission;
+ *     const state = decodeDrawing(e);
+ *     if (state !== null && state.kind === "line") {
+ *         const [from, to] = state.anchors;
+ *         void from;
+ *         void to;
+ *     }
+ */
+export function decodeDrawing(e) {
+    const result = validateEmission(e);
+    if (!result.ok)
+        return null;
+    return e.state;
+}
+//# sourceMappingURL=decodeDrawing.js.map

package/dist/validation/decodeDrawing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeDrawing.js","sourceRoot":"","sources":["../../src/validation/decodeDrawing.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAK/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,aAAa,CAAC,CAAkB;IAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,CAAY,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,CAAC,CAAC,KAAK,CAAC;AACnB,CAAC"}

package/dist/validation/index.d.ts

@@ -0,0 +1,4 @@
+export { decodeDrawing } from "./decodeDrawing.js";
+export { validateEmission } from "./validateEmission.js";
+export type { ValidationFail, ValidationOk, ValidationResult } from "./validateEmission.js";
+//# sourceMappingURL=index.d.ts.map

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

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

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

package/dist/validation/index.js.map

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

package/dist/validation/validateEmission.d.ts

@@ -0,0 +1,70 @@
+import type { DiagnosticCode } from "../types.js";
+/**
+ * Successful validation. `e` was a well-formed Phase-1 emission and is
+ * safe to forward across the structured-clone boundary.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     const r: ValidationOk = { ok: true };
+ */
+export type ValidationOk = {
+    readonly ok: true;
+};
+/**
+ * Failed validation. `code` is `"malformed-emission"` for shape errors
+ * and `"unsupported-drawing-kind"` for the Phase-1 drawing stub.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     const r: ValidationFail = {
+ *         ok: false,
+ *         code: "malformed-emission",
+ *         message: "not an object",
+ *     };
+ */
+export type ValidationFail = {
+    readonly ok: false;
+    readonly code: DiagnosticCode;
+    readonly message: string;
+};
+/**
+ * Discriminated union returned by {@link validateEmission}.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     declare const r: ValidationResult;
+ *     if (r.ok) {
+ *         // pass through
+ *     } else {
+ *         console.error(r.code, r.message);
+ *     }
+ */
+export type ValidationResult = ValidationOk | ValidationFail;
+/**
+ * Hand-rolled validator covering every Phase-1 / Phase-2 / Phase-3
+ * emission shape. Returns `{ ok: true }` for well-formed payloads and
+ * `{ ok: false, code, message }` otherwise. Hosts and adapters call
+ * this at every structured-clone boundary (Worker `postMessage`,
+ * QuickJS membrane) per PLAN §7.3.
+ *
+ * Phase 3 widens the drawing dispatch from an unconditional Phase-1
+ * stub to a per-kind validator: unknown `drawingKind` returns
+ * `unsupported-drawing-kind`; malformed payloads of a known kind
+ * return `malformed-emission`. Tasks 6–18 each ADD their kind
+ * validators to the dispatch as ports land.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { validateEmission } from "@invinite-org/chartlang-adapter-kit";
+ *
+ *     const r = validateEmission({ kind: "plot" });
+ *     if (!r.ok) {
+ *         console.error(r.code, r.message);
+ *     }
+ */
+export declare function validateEmission(e: unknown): ValidationResult;
+//# sourceMappingURL=validateEmission.d.ts.map

package/dist/validation/validateEmission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateEmission.d.ts","sourceRoot":"","sources":["../../src/validation/validateEmission.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,cAAc,CAAC;AAm9C7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAwB7D"}