@ggts-sh/spec 0.43.0

package/dist/validate-map-forms.js

@@ -0,0 +1,125 @@
+import { CHANNELS } from "./schema-catalog.js";
+import { isRecord, pathSegments } from "./validate-schema-walk.js";
+export const CHANNEL_FIX_EXAMPLE = { field: "column_name" };
+/**
+ * Channel names that live under aes (plot- or layer-level).
+ * Derived from CHANNELS so path classification cannot drift behind the catalog (#1078).
+ */
+const AES_CHANNEL_KEYS = new Set(CHANNELS);
+/** True only for the channel node itself (`…/aes/<channel>`), not nested paths. */
+export function isChannelPath(path) {
+    const segs = pathSegments(path);
+    if (segs.length < 2)
+        return false;
+    const i = segs.length - 2;
+    return segs[i] === "aes" && AES_CHANNEL_KEYS.has(segs[i + 1]);
+}
+/**
+ * DataRef / InlineData union roots only:
+ * `/data`, `/datasets/<name>`, or `/layers/<n>/data`.
+ * Nested paths under a data container must keep their own diagnostics.
+ */
+export function isDataUnionPath(path) {
+    const segs = pathSegments(path);
+    if (segs.length === 1 && segs[0] === "data")
+        return true;
+    if (segs.length === 2 && segs[0] === "datasets")
+        return true;
+    // /layers/<index>/data
+    if (segs.length === 3 &&
+        segs[0] === "layers" &&
+        /^\d+$/.test(segs[1] ?? "") &&
+        segs[2] === "data") {
+        return true;
+    }
+    return false;
+}
+/** Canonical channel object form (or null); bare strings are handled separately. */
+export function looksLikeChannelForm(v) {
+    if (v === null)
+        return true;
+    if (!isRecord(v))
+        return false;
+    return "field" in v || "value" in v || "stat" in v;
+}
+/** Already a data container shape — do not suggest re-wrapping as `{ values: [...] }`. */
+export function looksLikeDataContainer(v) {
+    if (!isRecord(v))
+        return false;
+    return "values" in v || "columns" in v || "name" in v;
+}
+export function isScalarValue(v) {
+    return v === null || typeof v === "string" || typeof v === "number" || typeof v === "boolean";
+}
+/** Exclusive channel form discriminators (exactly one allowed per channel). */
+const CHANNEL_DISCRIMINATORS = ["field", "value", "stat"];
+/** Exclusive data form discriminators (exactly one allowed per DataRef). */
+const DATA_DISCRIMINATORS = ["values", "columns", "name"];
+/**
+ * True when an additionalProperties failure lists a key that is *not* in
+ * `ignoreKeys`. Used to ignore competing-branch noise (e.g. Columns rejecting
+ * `values`) while still surfacing typos and form-illegal keys.
+ */
+export function additionalPropertyNames(group, ignoreKeys = new Set()) {
+    const names = new Set();
+    for (const error of group) {
+        if (error.keyword !== "additionalProperties")
+            continue;
+        const listed = Array.isArray(error.params.additionalProperties)
+            ? error.params.additionalProperties
+            : [];
+        for (const key of listed) {
+            if (!ignoreKeys.has(key))
+                names.add(key);
+        }
+    }
+    return [...names];
+}
+export function hasActionableAddlNoise(group, ignoreKeys) {
+    return additionalPropertyNames(group, ignoreKeys).length > 0;
+}
+export function channelDiscriminatorKeys(v) {
+    return CHANNEL_DISCRIMINATORS.filter((k) => k in v);
+}
+export function dataDiscriminatorKeys(v, allowed = DATA_DISCRIMINATORS) {
+    return allowed.filter((k) => k in v);
+}
+export function dataDiscriminatorsForUnion(members, path) {
+    const allowed = [];
+    if (members.refs.some((ref) => ref.endsWith("DataValues")))
+        allowed.push("values");
+    if (members.refs.some((ref) => ref.endsWith("DataColumns")))
+        allowed.push("columns");
+    if (members.refs.some((ref) => ref.endsWith("DataName")))
+        allowed.push("name");
+    if (allowed.length > 0)
+        return allowed;
+    return pathSegments(path)[0] === "datasets" ? ["values", "columns"] : DATA_DISCRIMINATORS;
+}
+/**
+ * Keys legal on the single present channel form, or null when forms are mixed
+ * / absent. FieldRef = {field}; ValueRef = {value, scale?}; StatRef = {stat}.
+ */
+export function allowedKeysForPresentChannelForm(v) {
+    const discs = channelDiscriminatorKeys(v);
+    if (discs.length !== 1)
+        return null;
+    switch (discs[0]) {
+        case "field":
+            return new Set(["field"]);
+        case "value":
+            return new Set(["value", "scale"]);
+        case "stat":
+            return new Set(["stat"]);
+        default:
+            return null;
+    }
+}
+/** Keys legal on the single present data form, or null when forms are mixed. */
+export function allowedKeysForPresentDataForm(v, allowedDiscriminators) {
+    const discs = dataDiscriminatorKeys(v, allowedDiscriminators);
+    if (discs.length !== 1)
+        return null;
+    return new Set([discs[0]]);
+}
+//# sourceMappingURL=validate-map-forms.js.map

package/dist/validate-map-forms.js.map

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

package/dist/validate-map-path-keywords.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Keyword path mapping for TypeBox 1.x errors: additionalProperties, required,
+ * numeric range, and default type normalization.
+ * Union classification: validate-map-path-unions.ts. Orchestrator: validate-map-errors.ts.
+ */
+import type { TLocalizedValidationError } from "typebox/error";
+import type { SpecError } from "./errors.js";
+import type { MapErrorsContext } from "./validate-map-errors.js";
+/** Map remaining keywords after union classification (or when no anyOf/const). */
+export declare function mapKeywordPathGroup(instancePath: string, group: readonly TLocalizedValidationError[], ctx: MapErrorsContext, path: string, key: string, valueAtPath: unknown, activeFormKeys: ReadonlySet<string> | null): SpecError[];
+//# sourceMappingURL=validate-map-path-keywords.d.ts.map

package/dist/validate-map-path-keywords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-map-path-keywords.d.ts","sourceRoot":"","sources":["../src/validate-map-path-keywords.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAW7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,kFAAkF;AAClF,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,SAAS,yBAAyB,EAAE,EAC3C,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,OAAO,EACpB,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GACzC,SAAS,EAAE,CAmGb"}

package/dist/validate-map-path-keywords.js

@@ -0,0 +1,95 @@
+import { didYouMean } from "./errors.js";
+import { additionalPropertiesIsClosed, numberBounds, objectPropertyNames, pointerGet, schemaAtInstancePath, schemaAtSchemaPath, } from "./validate-schema-walk.js";
+import { additionalPropertyNames } from "./validate-map-forms.js";
+/** Map remaining keywords after union classification (or when no anyOf/const). */
+export function mapKeywordPathGroup(instancePath, group, ctx, path, key, valueAtPath, activeFormKeys) {
+    // additionalProperties: closed objects → unexpected keys; schema-valued
+    // additionalProperties (records / free-form rows) → value type failures.
+    const addl = group.find((e) => e.keyword === "additionalProperties");
+    if (addl !== undefined) {
+        const listed = additionalPropertyNames(group, activeFormKeys ?? new Set());
+        const objectSchema = (typeof addl.schemaPath === "string"
+            ? schemaAtSchemaPath(ctx.schema, instancePath, addl.schemaPath)
+            : null) ?? schemaAtInstancePath(ctx.schema, instancePath);
+        if (!additionalPropertiesIsClosed(objectSchema)) {
+            return listed.map((prop) => {
+                const propPath = `${path}/${prop}`;
+                const propValue = pointerGet(ctx.value, `${instancePath}/${prop}`);
+                return {
+                    code: "invalid-type",
+                    path: propPath,
+                    message: `Invalid value for "${prop}" (got ${JSON.stringify(propValue)}).`,
+                };
+            });
+        }
+        const properties = activeFormKeys === null ? objectPropertyNames(objectSchema) : [...activeFormKeys];
+        return listed.map((prop) => {
+            const propPath = `${path}/${prop}`;
+            const suggestion = didYouMean(prop, properties);
+            return {
+                code: "unexpected-property",
+                path: propPath,
+                message: `Unknown property "${prop}".` +
+                    (suggestion === undefined ? "" : ` Did you mean "${suggestion}"?`),
+                allowed: properties,
+                ...(suggestion !== undefined && {
+                    fix: { description: `Rename "${prop}" to "${suggestion}".` },
+                }),
+            };
+        });
+    }
+    // required: may list several missing keys.
+    const req = group.find((e) => e.keyword === "required");
+    if (req !== undefined) {
+        const missing = Array.isArray(req.params.requiredProperties)
+            ? req.params.requiredProperties
+            : [];
+        return missing.map((prop) => ({
+            code: "missing-property",
+            path: `${path}/${prop}`,
+            message: `Missing required property "${prop}".`,
+        }));
+    }
+    // numeric range — use schema bounds when available for full min+max message.
+    const rangeErr = group.find((e) => ["minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum"].includes(e.keyword));
+    if (rangeErr !== undefined) {
+        const propSchema = schemaAtInstancePath(ctx.schema, instancePath) ??
+            schemaAtSchemaPath(ctx.schema, instancePath, rangeErr.schemaPath);
+        let bounds = numberBounds(propSchema);
+        if (bounds.length === 0) {
+            const limit = rangeErr.params.limit;
+            const comparison = rangeErr.params.comparison;
+            if (typeof limit === "number" && typeof comparison === "string") {
+                bounds = [`${comparison} ${limit}`];
+            }
+        }
+        return [
+            {
+                code: "value-out-of-range",
+                path,
+                message: `Value ${JSON.stringify(valueAtPath)} for "${key}" is out of range (must be ${bounds.join(" and ")}).`,
+                fix: { description: `Set "${key}" to a number ${bounds.join(" and ")}.` },
+            },
+        ];
+    }
+    // Lone const (Literal) without anyOf group — handled in union module when
+    // constErrs non-empty; fall through to default for remaining keywords (type, etc.).
+    // Normalize 1.x "must be X" wording toward the catalog's "Expected X" form.
+    const first = group[0];
+    let message = first.message;
+    if (first.keyword === "type") {
+        const t = first.params.type;
+        const expected = Array.isArray(t) ? t.join("|") : t;
+        if (typeof expected === "string") {
+            message = `Expected ${expected}`;
+        }
+    }
+    return [
+        {
+            code: "invalid-type",
+            path,
+            message: `${message}${path === "" ? "" : ` at "${key}"`} (got ${JSON.stringify(valueAtPath)}).`,
+        },
+    ];
+}
+//# sourceMappingURL=validate-map-path-keywords.js.map

package/dist/validate-map-path-keywords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-map-path-keywords.js","sourceRoot":"","sources":["../src/validate-map-path-keywords.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,4BAA4B,EAC5B,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CACjC,YAAoB,EACpB,KAA2C,EAC3C,GAAqB,EACrB,IAAY,EACZ,GAAW,EACX,WAAoB,EACpB,cAA0C;IAE1C,wEAAwE;IACxE,yEAAyE;IACzE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,sBAAsB,CAAC,CAAC;IACrE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,EAAE,cAAc,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3E,MAAM,YAAY,GAChB,CAAC,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;YAClC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC;YAC/D,CAAC,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,4BAA4B,CAAC,YAAY,CAAC,EAAE,CAAC;YAChD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACzB,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;gBACnC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,YAAY,IAAI,IAAI,EAAE,CAAC,CAAC;gBACnE,OAAO;oBACL,IAAI,EAAE,cAAuB;oBAC7B,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,sBAAsB,IAAI,UAAU,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI;iBAC3E,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QACD,MAAM,UAAU,GACd,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC;QACpF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACzB,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAChD,OAAO;gBACL,IAAI,EAAE,qBAA8B;gBACpC,IAAI,EAAE,QAAQ;gBACd,OAAO,EACL,qBAAqB,IAAI,IAAI;oBAC7B,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,UAAU,IAAI,CAAC;gBACpE,OAAO,EAAE,UAAU;gBACnB,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI;oBAC9B,GAAG,EAAE,EAAE,WAAW,EAAE,WAAW,IAAI,SAAS,UAAU,IAAI,EAAE;iBAC7D,CAAC;aACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,2CAA2C;IAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC;IACxD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC;YAC1D,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,kBAAkB;YAC/B,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,kBAA2B;YACjC,IAAI,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE;YACvB,OAAO,EAAE,8BAA8B,IAAI,IAAI;SAChD,CAAC,CAAC,CAAC;IACN,CAAC;IAED,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAChC,CAAC,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CACnF,CAAC;IACF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,UAAU,GACd,oBAAoB,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;YAC9C,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QACpE,IAAI,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAI,QAAQ,CAAC,MAA6B,CAAC,KAAK,CAAC;YAC5D,MAAM,UAAU,GAAI,QAAQ,CAAC,MAAkC,CAAC,UAAU,CAAC;YAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBAChE,MAAM,GAAG,CAAC,GAAG,UAAU,IAAI,KAAK,EAAE,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QACD,OAAO;YACL;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,IAAI;gBACJ,OAAO,EAAE,SAAS,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,GAAG,8BAA8B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI;gBAC/G,GAAG,EAAE,EAAE,WAAW,EAAE,QAAQ,GAAG,iBAAiB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;aAC1E;SACF,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,oFAAoF;IAEpF,4EAA4E;IAC5E,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IACxB,IAAI,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC5B,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAI,KAAK,CAAC,MAAuC,CAAC,IAAI,CAAC;QAC9D,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,GAAG,YAAY,QAAQ,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IACD,OAAO;QACL;YACE,IAAI,EAAE,cAAc;YACpB,IAAI;YACJ,OAAO,EAAE,GAAG,OAAO,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI;SAChG;KACF,CAAC;AACJ,CAAC"}

package/dist/validate-map-path-unions.d.ts

@@ -0,0 +1,27 @@
+/**
+ * anyOf/const union path mapping for TypeBox 1.x errors (channel forms, data
+ * refs, enums). Keyword handlers: validate-map-path-keywords.ts.
+ * Orchestrator: validate-map-errors.ts.
+ *
+ * Result contract:
+ *  - `{ status: "done", errors }` — including `errors: []` meaning "suppress
+ *    noisy union diagnostics; a nested path owns the real error"
+ *  - `{ status: "continue", activeFormKeys }` — fall through to keyword handlers
+ *    (activeFormKeys null when no near-canonical form keyed the fall-through)
+ */
+import type { TLocalizedValidationError } from "typebox/error";
+import type { SpecError } from "./errors.js";
+import type { MapErrorsContext } from "./validate-map-errors.js";
+export type UnionPathResult = {
+    status: "done";
+    errors: SpecError[];
+} | {
+    status: "continue";
+    activeFormKeys: ReadonlySet<string> | null;
+};
+/**
+ * Classify anyOf/const group noise. When neither anyOf nor const is present,
+ * returns continue with null form keys so keyword handlers still run.
+ */
+export declare function mapUnionPathGroup(instancePath: string, group: readonly TLocalizedValidationError[], ctx: MapErrorsContext, path: string, key: string, valueAtPath: unknown): UnionPathResult;
+//# sourceMappingURL=validate-map-path-unions.d.ts.map

package/dist/validate-map-path-unions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-map-path-unions.d.ts","sourceRoot":"","sources":["../src/validate-map-path-unions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAsB7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC;AAEvE;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,SAAS,yBAAyB,EAAE,EAC3C,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,OAAO,GACnB,eAAe,CA6CjB"}

package/dist/validate-map-path-unions.js

@@ -0,0 +1,200 @@
+import { didYouMean } from "./errors.js";
+import { isRecord, schemaAtInstancePath, schemaAtSchemaPath, unionMembers, } from "./validate-schema-walk.js";
+import { allowedKeysForPresentChannelForm, allowedKeysForPresentDataForm, channelDiscriminatorKeys, CHANNEL_FIX_EXAMPLE, dataDiscriminatorKeys, dataDiscriminatorsForUnion, hasActionableAddlNoise, isChannelPath, isDataUnionPath, isScalarValue, looksLikeChannelForm, looksLikeDataContainer, } from "./validate-map-forms.js";
+/**
+ * Classify anyOf/const group noise. When neither anyOf nor const is present,
+ * returns continue with null form keys so keyword handlers still run.
+ */
+export function mapUnionPathGroup(instancePath, group, ctx, path, key, valueAtPath) {
+    const anyOfErr = group.find((e) => e.keyword === "anyOf");
+    const constErrs = group.filter((e) => e.keyword === "const");
+    if (anyOfErr === undefined && constErrs.length === 0) {
+        return { status: "continue", activeFormKeys: null };
+    }
+    // Object-branch noise in mixed unions (e.g. ThemeName | ThemeSpec): prefer
+    // required / additionalProperties over const-branch enum synthesis.
+    const hasObjectBranchNoise = isRecord(valueAtPath) &&
+        group.some((e) => e.keyword === "additionalProperties" || e.keyword === "required");
+    // anyOf / const unions FIRST: 1.x fans out branch failures (required +
+    // additionalProperties + anyOf) for object unions. Prefer the anyOf signal
+    // so DataRef / ChannelValue surface catalog codes, not branch noise — except
+    // when the instance already matches a near-canonical form (nested paths own
+    // the real diagnostic) or an object branch reported concrete property noise.
+    const unionSchema = (anyOfErr === undefined
+        ? null
+        : schemaAtSchemaPath(ctx.schema, instancePath, anyOfErr.schemaPath)) ??
+        schemaAtInstancePath(ctx.schema, instancePath);
+    const members = unionMembers(unionSchema);
+    const isChannel = members.refs.includes("FieldRef") ||
+        members.refs.some((r) => r.endsWith("FieldRef")) ||
+        isChannelPath(path);
+    if (isChannel && !members.allConst) {
+        return mapChannelUnion(group, path, key, valueAtPath);
+    }
+    const isDataUnion = members.refs.includes("DataValues") ||
+        members.refs.some((r) => r.includes("DataValues")) ||
+        (isDataUnionPath(path) && anyOfErr !== undefined);
+    if (isDataUnion) {
+        return mapDataUnion(group, members, path, valueAtPath);
+    }
+    return mapEnumUnion(anyOfErr, constErrs, members, hasObjectBranchNoise, valueAtPath, path, key);
+}
+function mapEnumUnion(anyOfErr, constErrs, members, hasObjectBranchNoise, valueAtPath, path, key) {
+    let allowed = [];
+    if (constErrs.length > 0) {
+        allowed = constErrs
+            .map((e) => e.params.allowedValue)
+            .filter((v) => v !== undefined)
+            .map(String);
+    }
+    if (allowed.length === 0 && members.allConst && members.consts.length > 0) {
+        allowed = members.consts;
+    }
+    // Only promote const branch noise when the value could be an enum member.
+    // Mixed enum|object unions (theme) must not turn ThemeSpec property errors
+    // into "pick a theme name".
+    if (allowed.length > 0 &&
+        (members.allConst || isScalarValue(valueAtPath)) &&
+        !hasObjectBranchNoise) {
+        if (allowed.length === 1 && constErrs.length <= 1 && anyOfErr === undefined) {
+            return {
+                status: "done",
+                errors: [
+                    {
+                        code: "invalid-enum-value",
+                        path,
+                        message: `Invalid value ${JSON.stringify(valueAtPath)} for "${key}"; the only supported value is ${allowed.map((a) => `"${a}"`).join(", ")}.`,
+                        allowed,
+                    },
+                ],
+            };
+        }
+        const suggestion = typeof valueAtPath === "string" ? didYouMean(valueAtPath, allowed) : undefined;
+        return {
+            status: "done",
+            errors: [
+                {
+                    code: "invalid-enum-value",
+                    path,
+                    message: `Invalid value ${JSON.stringify(valueAtPath)} for "${key}"; allowed: ${allowed.map((c) => `"${c}"`).join(", ")}.` +
+                        (suggestion === undefined ? "" : ` Did you mean "${suggestion}"?`),
+                    allowed,
+                    ...(suggestion !== undefined && {
+                        fix: { description: `Set "${key}" to "${suggestion}".` },
+                    }),
+                },
+            ],
+        };
+    }
+    if (anyOfErr !== undefined && !hasObjectBranchNoise) {
+        return {
+            status: "done",
+            errors: [
+                {
+                    code: "invalid-type",
+                    path,
+                    message: `${anyOfErr.message} at "${key}".`,
+                },
+            ],
+        };
+    }
+    return { status: "continue", activeFormKeys: null };
+}
+function mapChannelUnion(group, path, key, valueAtPath) {
+    if (isRecord(valueAtPath) && looksLikeChannelForm(valueAtPath)) {
+        const discs = channelDiscriminatorKeys(valueAtPath);
+        if (discs.length > 1) {
+            return {
+                status: "done",
+                errors: [
+                    {
+                        code: "invalid-channel-value",
+                        path,
+                        message: `Channel "${key}" mixes forms (${discs.map((disc) => `"${disc}"`).join(" and ")}); use exactly one of {"field": ...}, {"value": ...}, or {"stat": ...}.`,
+                        fix: {
+                            description: `Pick a single channel form for "${key}".`,
+                            example: CHANNEL_FIX_EXAMPLE,
+                        },
+                    },
+                ],
+            };
+        }
+        const formKeys = allowedKeysForPresentChannelForm(valueAtPath);
+        if (formKeys !== null && hasActionableAddlNoise(group, formKeys)) {
+            return { status: "continue", activeFormKeys: formKeys };
+        }
+        return { status: "done", errors: [] };
+    }
+    const bareString = typeof valueAtPath === "string";
+    return {
+        status: "done",
+        errors: [
+            {
+                code: "invalid-channel-value",
+                path,
+                message: bareString
+                    ? `Channel "${key}" is the bare string ${JSON.stringify(valueAtPath)}; portable specs require the canonical form {"field": ${JSON.stringify(valueAtPath)}}.`
+                    : `Channel "${key}" must be {"field": ...}, {"value": ...}, {"stat": ...}, or null.`,
+                fix: {
+                    description: `Use a canonical channel form, e.g. {"field": "column_name"} to map "${key}" to a data column.`,
+                    example: bareString ? { field: valueAtPath } : CHANNEL_FIX_EXAMPLE,
+                },
+            },
+        ],
+    };
+}
+function mapDataUnion(group, members, path, valueAtPath) {
+    const allowed = dataDiscriminatorsForUnion(members, path);
+    const forms = allowed.map((discriminator) => {
+        if (discriminator === "values")
+            return '{"values": [...rows]}';
+        if (discriminator === "columns")
+            return '{"columns": {...arrays}}';
+        return '{"name": "dataset"}';
+    });
+    const formsMessage = forms.length === 2
+        ? `${forms[0]} or ${forms[1]}`
+        : `${forms.slice(0, -1).join(", ")}, or ${forms.at(-1)}`;
+    if (isRecord(valueAtPath) && looksLikeDataContainer(valueAtPath)) {
+        const discs = dataDiscriminatorKeys(valueAtPath, allowed);
+        if (discs.length > 1) {
+            return {
+                status: "done",
+                errors: [
+                    {
+                        code: "invalid-data",
+                        path,
+                        message: `Data mixes forms (${discs.map((disc) => `"${disc}"`).join(" and ")}); use exactly one of ${formsMessage}.`,
+                        allowed: [...allowed],
+                        fix: {
+                            description: "Pick a single data form.",
+                            example: { values: [{ x: 1, y: 2 }] },
+                        },
+                    },
+                ],
+            };
+        }
+        const presentFormKeys = allowedKeysForPresentDataForm(valueAtPath, allowed);
+        const formKeys = presentFormKeys ?? new Set(allowed);
+        if (hasActionableAddlNoise(group, formKeys)) {
+            return { status: "continue", activeFormKeys: formKeys };
+        }
+        return { status: "done", errors: [] };
+    }
+    return {
+        status: "done",
+        errors: [
+            {
+                code: "invalid-data",
+                path,
+                message: `Data must be one of ${formsMessage}.`,
+                allowed: [...allowed],
+                fix: {
+                    description: 'Wrap inline rows as {"values": [...]}.',
+                    example: { values: [{ x: 1, y: 2 }] },
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=validate-map-path-unions.js.map

package/dist/validate-map-path-unions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-map-path-unions.js","sourceRoot":"","sources":["../src/validate-map-path-unions.ts"],"names":[],"mappings":"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"}

package/dist/validate-schema-shape.d.ts

@@ -0,0 +1,69 @@
+import type { SpecError } from "./errors.js";
+/** Known geom → layer schema for branch-selected tier-1 walks and tier-2 eligibility. */
+export declare const GEOM_BRANCHES: {
+    readonly point: import("./schema-imports.js").SpecImportSchema;
+    readonly line: import("./schema-imports.js").SpecImportSchema;
+    readonly path: import("./schema-imports.js").SpecImportSchema;
+    readonly col: import("./schema-imports.js").SpecImportSchema;
+    readonly bar: import("./schema-imports.js").SpecImportSchema;
+    readonly histogram: import("./schema-imports.js").SpecImportSchema;
+    readonly freqpoly: import("./schema-imports.js").SpecImportSchema;
+    readonly area: import("./schema-imports.js").SpecImportSchema;
+    readonly ribbon: import("./schema-imports.js").SpecImportSchema;
+    readonly segment: import("./schema-imports.js").SpecImportSchema;
+    readonly count: import("./schema-imports.js").SpecImportSchema;
+    readonly violin: import("./schema-imports.js").SpecImportSchema;
+    readonly function: import("./schema-imports.js").SpecImportSchema;
+    readonly polygon: import("./schema-imports.js").SpecImportSchema;
+    readonly abline: import("./schema-imports.js").SpecImportSchema;
+    readonly curve: import("./schema-imports.js").SpecImportSchema;
+    readonly map: import("./schema-imports.js").SpecImportSchema;
+    readonly blank: import("./schema-imports.js").SpecImportSchema;
+    readonly sf: import("./schema-imports.js").SpecImportSchema;
+    readonly sf_text: import("./schema-imports.js").SpecImportSchema;
+    readonly sf_label: import("./schema-imports.js").SpecImportSchema;
+    readonly spoke: import("./schema-imports.js").SpecImportSchema;
+    readonly rug: import("./schema-imports.js").SpecImportSchema;
+    readonly step: import("./schema-imports.js").SpecImportSchema;
+    readonly qq: import("./schema-imports.js").SpecImportSchema;
+    readonly qq_line: import("./schema-imports.js").SpecImportSchema;
+    readonly rule: import("./schema-imports.js").SpecImportSchema;
+    readonly hline: import("./schema-imports.js").SpecImportSchema;
+    readonly vline: import("./schema-imports.js").SpecImportSchema;
+    readonly jitter: import("./schema-imports.js").SpecImportSchema;
+    readonly text: import("./schema-imports.js").SpecImportSchema;
+    readonly label: import("./schema-imports.js").SpecImportSchema;
+    readonly smooth: import("./schema-imports.js").SpecImportSchema;
+    readonly quantile: import("./schema-imports.js").SpecImportSchema;
+    readonly contour: import("./schema-imports.js").SpecImportSchema;
+    readonly boxplot: import("./schema-imports.js").SpecImportSchema;
+    readonly density: import("./schema-imports.js").SpecImportSchema;
+    readonly density_2d: import("./schema-imports.js").SpecImportSchema;
+    readonly density_2d_filled: import("./schema-imports.js").SpecImportSchema;
+    readonly dotplot: import("./schema-imports.js").SpecImportSchema;
+    readonly errorbar: import("./schema-imports.js").SpecImportSchema;
+    readonly linerange: import("./schema-imports.js").SpecImportSchema;
+    readonly pointrange: import("./schema-imports.js").SpecImportSchema;
+    readonly crossbar: import("./schema-imports.js").SpecImportSchema;
+    readonly rect: import("./schema-imports.js").SpecImportSchema;
+    readonly tile: import("./schema-imports.js").SpecImportSchema;
+    readonly bin_2d: import("./schema-imports.js").SpecImportSchema;
+    readonly raster: import("./schema-imports.js").SpecImportSchema;
+    readonly hex: import("./schema-imports.js").SpecImportSchema;
+};
+/** Result of the tier-1 shape walk for one invalid plot. */
+export type SchemaShapeResult = {
+    errors: SpecError[];
+    /**
+     * Layer indices whose geom-branch `Value.Errors` walk was empty. Used by
+     * validate() so the tier-2 structural gate does not re-run interpreted
+     * `Value.Check` on the same layers.
+     */
+    branchOkLayerIndices: ReadonlySet<number>;
+};
+/**
+ * Tier-1 schema walk (caller must set TypeBox Settings for the process).
+ * Layer branch walk + plot-level shell so layer noise is not double-reported.
+ */
+export declare function collectSchemaShapeErrors(input: Record<string, unknown>): SchemaShapeResult;
+//# sourceMappingURL=validate-schema-shape.d.ts.map

package/dist/validate-schema-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-schema-shape.d.ts","sourceRoot":"","sources":["../src/validate-schema-shape.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAuD7C,yFAAyF;AACzF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDhB,CAAC;AA+CX,4DAA4D;AAC5D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB;;;;OAIG;IACH,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC3C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAiD1F"}