@ggts-sh/spec 0.43.0

package/dist/validate-structure-paint.js.map

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

package/dist/validate-structure-scales.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Data-free structural checks for named color/fill schemes vs scale family.
+ * Layer grammar: validate-structure-layers.ts (+ layer-rule/ribbon/computed-y). Facet: validate-structure-facet.ts.
+ */
+import type { SpecError } from "./errors.js";
+/** Guide variants are constrained by aesthetic and explicit scale family. */
+export declare function guideStructuralErrors(guides: Record<string, unknown>, scales: Record<string, unknown> | undefined): SpecError[];
+/** Named color schemes must match the configured color scale family. */
+export declare function colorScaleStructuralErrors(scales: Record<string, unknown>): SpecError[];
+//# sourceMappingURL=validate-structure-scales.d.ts.map

package/dist/validate-structure-scales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-structure-scales.d.ts","sourceRoot":"","sources":["../src/validate-structure-scales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA4B7C,6EAA6E;AAC7E,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,SAAS,EAAE,CA0Bb;AAoBD,wEAAwE;AACxE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CA8DvF"}

package/dist/validate-structure-scales.js

@@ -0,0 +1,242 @@
+import { CATEGORICAL_SCHEME_NAMES, CYCLIC_SCHEME_NAMES, SEQUENTIAL_SCHEME_NAMES, } from "./schema-names.js";
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+const CATEGORICAL_SCHEMES = new Set(CATEGORICAL_SCHEME_NAMES);
+const SEQUENTIAL_SCHEMES = new Set(SEQUENTIAL_SCHEME_NAMES);
+const CYCLIC_SCHEMES = new Set(CYCLIC_SCHEME_NAMES);
+/** Named color schemes must match the configured color scale family. */
+const GUIDE_AESTHETICS = [
+    "x",
+    "y",
+    "color",
+    "fill",
+    "size",
+    "linewidth",
+    "alpha",
+    "shape",
+    "linetype",
+];
+/** Guide variants are constrained by aesthetic and explicit scale family. */
+export function guideStructuralErrors(guides, scales) {
+    const errors = [];
+    const check = (aesthetic, guide, path) => {
+        if (!isRecord(guide) || typeof guide["type"] !== "string")
+            return;
+        const type = guide["type"];
+        if (type === "none")
+            return;
+        const scale = isRecord(scales?.[aesthetic]) ? scales?.[aesthetic] : undefined;
+        const scaleType = scale?.["type"];
+        if (guideIsValid(aesthetic, type, scaleType))
+            return;
+        errors.push({
+            code: "guide-aesthetic-incompatible",
+            path,
+            message: `The ${type} guide is incompatible with the ${aesthetic} aesthetic${typeof scaleType === "string" ? ` using a ${scaleType} scale` : ""}.`,
+            fix: {
+                description: guideFixDescription(aesthetic),
+            },
+        });
+    };
+    for (const aesthetic of GUIDE_AESTHETICS) {
+        const top = guides[aesthetic];
+        check(aesthetic, top, `/guides/${aesthetic}`);
+        const scale = scales?.[aesthetic];
+        if (top === undefined && isRecord(scale))
+            check(aesthetic, scale["guide"], `/scales/${aesthetic}/guide`);
+    }
+    return errors;
+}
+function guideIsValid(aesthetic, type, scaleType) {
+    if (aesthetic === "x" || aesthetic === "y")
+        return type === "axis";
+    if (aesthetic !== "color" && aesthetic !== "fill")
+        return type === "legend";
+    if (type === "legend")
+        return scaleType !== "sequential" && scaleType !== "binned";
+    if (type === "colorbar")
+        return scaleType === undefined || scaleType === "sequential";
+    return type === "colorsteps" && scaleType === "binned";
+}
+function guideFixDescription(aesthetic) {
+    if (aesthetic === "x" || aesthetic === "y") {
+        return 'Use { type: "axis" } or { type: "none" } for positional aesthetics.';
+    }
+    if (aesthetic === "color" || aesthetic === "fill") {
+        return "Use legend for discrete colors, colorbar for sequential colors, colorsteps for binned colors, or none.";
+    }
+    return 'Use { type: "legend" } or { type: "none" } for mapped style aesthetics.';
+}
+/** Named color schemes must match the configured color scale family. */
+export function colorScaleStructuralErrors(scales) {
+    const errors = [];
+    for (const channel of ["color", "fill"]) {
+        const scale = scales[channel];
+        if (!isRecord(scale))
+            continue;
+        const type = scale["type"];
+        const scheme = scale["scheme"];
+        addBasicColorScaleErrors(errors, scale, channel, type);
+        addCyclicScaleErrors(errors, scale, channel, type, scheme);
+        if ((type === "sequential" || type === "binned") &&
+            typeof scheme === "string" &&
+            CATEGORICAL_SCHEMES.has(scheme)) {
+            errors.push({
+                code: "scale-scheme-type",
+                path: `/scales/${channel}/scheme`,
+                message: `The categorical scheme "${scheme}" cannot be used with a ${type} color scale.`,
+                fix: {
+                    description: 'Use "viridis" or provide a sequential range of #rgb/#rrggbb stops.',
+                    example: "viridis",
+                },
+            });
+        }
+        else if (type === "manual" && typeof scheme === "string" && SEQUENTIAL_SCHEMES.has(scheme)) {
+            // Ordinal may use sequential-family schemes (scale_*_viridis_d samples the
+            // ramp across the trained domain). Manual still rejects named schemes.
+            errors.push({
+                code: "scale-scheme-type",
+                path: `/scales/${channel}/scheme`,
+                message: `The sequential scheme "${scheme}" cannot be used with a manual color scale.`,
+                fix: {
+                    description: "Use a categorical scheme or provide an ordinal range of CSS colors.",
+                    example: "observable10",
+                },
+            });
+        }
+        const transform = scale["transform"];
+        const temporal = scale["temporalKind"] !== undefined || scale["parse"] !== undefined;
+        const describedType = typeof type === "string" ? type : "inferred";
+        if (typeof transform === "string" &&
+            transform !== "identity" &&
+            (temporal || type === "ordinal" || type === "manual" || type === "identity")) {
+            errors.push({
+                code: "scale-type-transform-conflict",
+                path: `/scales/${channel}/transform`,
+                message: `The ${describedType} ${channel} scale cannot apply the ${transform} transform${temporal ? " to temporal values" : ""}.`,
+                fix: {
+                    description: "Remove the transform, or use a non-temporal sequential/binned quantitative scale.",
+                    example: "identity",
+                },
+            });
+        }
+        addColorRangeErrors(errors, scale, channel, type);
+    }
+    return errors;
+}
+function addBasicColorScaleErrors(errors, scale, channel, type) {
+    if ("range" in scale && scale["range"] !== undefined && !Array.isArray(scale["range"])) {
+        errors.push({
+            code: "invalid-type",
+            path: `/scales/${channel}/range`,
+            message: `scales.${channel}.range must be an array of colors (got ${typeof scale["range"]}).`,
+            fix: {
+                description: "Provide range as a JSON array of #rgb/#rrggbb colors.",
+                example: ["#f00", "#0f0", "#00f"],
+            },
+        });
+    }
+    if (type === "binned" && scale["oob"] === "wrap") {
+        errors.push({
+            code: "scale-scheme-oob",
+            path: `/scales/${channel}/oob`,
+            message: `The binned ${channel} scale cannot use wrap out-of-bounds.`,
+            fix: {
+                description: 'Use "censor" or "squish" on binned color scales.',
+                example: "censor",
+            },
+        });
+    }
+}
+function addCyclicScaleErrors(errors, scale, channel, type, scheme) {
+    if (typeof scheme !== "string" || !CYCLIC_SCHEMES.has(scheme))
+        return;
+    if (type !== undefined && type !== "sequential") {
+        const typeLabel = typeof type === "string" ? type : "this";
+        errors.push({
+            code: "scale-scheme-type",
+            path: `/scales/${channel}/scheme`,
+            message: `The cyclic scheme "${scheme}" cannot be used with a ${typeLabel} color scale.`,
+            fix: {
+                description: 'Use type "sequential" with an explicit domain period and oob "wrap".',
+                example: "sequential",
+            },
+        });
+    }
+    if (scale["oob"] === "censor" || scale["oob"] === "squish") {
+        errors.push({
+            code: "scale-scheme-oob",
+            path: `/scales/${channel}/oob`,
+            message: `The cyclic scheme "${scheme}" requires wrap out-of-bounds.`,
+            fix: {
+                description: 'Set oob to "wrap", or omit it (cyclic schemes default to wrap).',
+                example: "wrap",
+            },
+        });
+    }
+    if (!Array.isArray(scale["domain"]) || scale["domain"].length !== 2) {
+        errors.push({
+            code: "scale-cyclic-domain",
+            path: `/scales/${channel}/domain`,
+            message: `The cyclic scheme "${scheme}" requires an explicit two-value domain period.`,
+            fix: {
+                description: "Set domain to one period, for example [0, 360] for degrees.",
+                example: [0, 360],
+            },
+        });
+    }
+    if (scale["range"] !== undefined) {
+        errors.push({
+            code: "scale-scheme-type",
+            path: `/scales/${channel}/range`,
+            message: `The cyclic scheme "${scheme}" cannot be combined with an explicit range.`,
+            fix: { description: "Remove range and keep the named cyclic scheme, or drop the scheme." },
+        });
+    }
+    const transform = scale["transform"];
+    const temporal = scale["temporalKind"] !== undefined || scale["parse"] !== undefined;
+    if ((typeof transform === "string" && transform !== "identity") || temporal) {
+        errors.push({
+            code: "scale-type-transform-conflict",
+            path: `/scales/${channel}/transform`,
+            message: `The cyclic scheme "${scheme}" cannot apply a transform or temporal parser.`,
+            fix: {
+                description: "Remove transform and temporal options. Wrap in semantic space only.",
+                example: "identity",
+            },
+        });
+    }
+}
+function addColorRangeErrors(errors, scale, channel, type) {
+    const range = scale["range"];
+    const domain = scale["domain"];
+    if (type === "manual" &&
+        Array.isArray(domain) &&
+        Array.isArray(range) &&
+        domain.length !== range.length) {
+        errors.push({
+            code: "color-manual-domain-range",
+            path: `/scales/${channel}`,
+            message: `The manual ${channel} scale has ${String(domain.length)} domain values but ${String(range.length)} range colors.`,
+            fix: { description: "Provide exactly one range color for each explicit domain value." },
+        });
+    }
+    if (!Array.isArray(range))
+        return;
+    for (let index = 0; index < range.length; index++) {
+        const color = range[index];
+        if (typeof color !== "string" || /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i.test(color))
+            continue;
+        errors.push({
+            code: "scale-range-color",
+            path: `/scales/${channel}/range/${index}`,
+            message: `The color stop "${color}" is not a supported hex color.`,
+            fix: {
+                description: "Use #rgb or #rrggbb syntax for custom color ranges.",
+                example: "#ff0000",
+            },
+        });
+    }
+}
+//# sourceMappingURL=validate-structure-scales.js.map

package/dist/validate-structure-scales.js.map

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

package/dist/validate-structure-style-bins.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Structural well-formedness for binned numeric/finite style scales.
+ * Mirrors runtime checks in scale-style-numeric.ts / scale-style-finite.ts:
+ * authored breaks must be finite + strictly increasing, and when both domain
+ * and breaks are authored their endpoints must agree.
+ *
+ * Independent of parseFailure and of data — recovery bounds must themselves
+ * be valid or the runtime throws style-binned-breaks / style-domain-invalid.
+ */
+import type { SpecError } from "./errors.js";
+/**
+ * Config-only checks for binned size/linewidth/alpha/shape/linetype scales.
+ * Runs whenever the scale object is schema-valid (same cadence as color
+ * structural checks).
+ */
+export declare function binnedStyleScaleStructuralErrors(scales: Record<string, unknown>): SpecError[];
+//# sourceMappingURL=validate-structure-style-bins.d.ts.map

package/dist/validate-structure-style-bins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-structure-style-bins.d.ts","sourceRoot":"","sources":["../src/validate-structure-style-bins.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoF7C;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAoE7F"}

package/dist/validate-structure-style-bins.js

@@ -0,0 +1,150 @@
+import { parseTemporalColumn } from "./temporal-column.js";
+import { parseTemporal } from "./temporal-parse.js";
+import { temporalParserUsable } from "./validate-data-checks-temporal.js";
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+const BINNED_STYLE_AESTHETICS = ["size", "linewidth", "alpha", "shape", "linetype"];
+/** Mirror core cellToNumber for non-temporal style boundary resolution. */
+function nonTemporalSemantic(value) {
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : undefined;
+    if (value instanceof Date) {
+        const epochMs = value.getTime();
+        return Number.isFinite(epochMs) ? epochMs : undefined;
+    }
+    if (typeof value === "boolean")
+        return value ? 1 : 0;
+    if (typeof value === "string") {
+        const iso = parseTemporal(value, "iso");
+        if (iso.ok)
+            return iso.epochMs;
+        if (value.trim() === "")
+            return undefined;
+        const numeric = Number(value);
+        return Number.isFinite(numeric) ? numeric : undefined;
+    }
+    return undefined;
+}
+function resolveBoundarySemantics(values, config) {
+    const requestsTemporal = config["temporalKind"] !== undefined ||
+        config["parse"] !== undefined ||
+        config["timezone"] !== undefined ||
+        config["disambiguation"] !== undefined;
+    if (!requestsTemporal) {
+        const mapped = [];
+        for (const value of values) {
+            const semantic = nonTemporalSemantic(value);
+            if (semantic === undefined)
+                return null;
+            mapped.push(semantic);
+        }
+        return mapped;
+    }
+    // Schema-invalid temporal inputs still reach structure checks; defer rather
+    // than throw inside the temporal helpers (same gate as data-aware checks).
+    if (!temporalParserUsable(config["parse"]))
+        return null;
+    if (config["timezone"] !== undefined && typeof config["timezone"] !== "string")
+        return null;
+    if (config["disambiguation"] !== undefined && typeof config["disambiguation"] !== "string") {
+        return null;
+    }
+    const options = {
+        ...(typeof config["timezone"] === "string" && { timezone: config["timezone"] }),
+        ...(typeof config["disambiguation"] === "string" && {
+            disambiguation: config["disambiguation"],
+        }),
+    };
+    const parser = (config["parse"] ?? "auto");
+    const column = parseTemporalColumn(values, parser, options);
+    const mapped = [];
+    for (let index = 0; index < values.length; index++) {
+        if (column.valid[index] !== 1)
+            return null;
+        const epochMs = column.semantic[index];
+        if (epochMs === undefined || !Number.isFinite(epochMs))
+            return null;
+        mapped.push(epochMs);
+    }
+    return mapped;
+}
+function isStrictlyIncreasing(boundaries) {
+    for (let index = 1; index < boundaries.length; index++) {
+        const prev = boundaries[index - 1];
+        const current = boundaries[index];
+        if (prev === undefined || current === undefined || current <= prev)
+            return false;
+    }
+    return true;
+}
+/**
+ * Config-only checks for binned size/linewidth/alpha/shape/linetype scales.
+ * Runs whenever the scale object is schema-valid (same cadence as color
+ * structural checks).
+ */
+export function binnedStyleScaleStructuralErrors(scales) {
+    const errors = [];
+    for (const aesthetic of BINNED_STYLE_AESTHETICS) {
+        const config = scales[aesthetic];
+        if (!isRecord(config) || config["type"] !== "binned")
+            continue;
+        const authoredBreaks = Array.isArray(config["breaks"]) ? config["breaks"] : undefined;
+        if (authoredBreaks === undefined)
+            continue;
+        // Schema already enforces minItems: 2; still guard for partial schema paths.
+        if (authoredBreaks.length < 2) {
+            errors.push({
+                code: "scale-binned-breaks",
+                path: `/scales/${aesthetic}/breaks`,
+                message: `The ${aesthetic} boundaries must be finite and strictly increasing.`,
+                fix: {
+                    description: "Provide at least two strictly increasing boundary values.",
+                    example: [0, 10, 20],
+                },
+            });
+            continue;
+        }
+        const breakSemantics = resolveBoundarySemantics(authoredBreaks, config);
+        if (breakSemantics === null || !isStrictlyIncreasing(breakSemantics)) {
+            errors.push({
+                code: "scale-binned-breaks",
+                path: `/scales/${aesthetic}/breaks`,
+                message: `The ${aesthetic} boundaries must be finite and strictly increasing.`,
+                fix: {
+                    description: "Provide 2+ strictly increasing boundaries that parse under the scale's parser.",
+                    example: aesthetic === "size" || aesthetic === "linewidth" || aesthetic === "alpha"
+                        ? [0, 10, 20]
+                        : [0, 1, 2],
+                },
+            });
+            // Malformed breaks are the primary diagnostic; skip domain agreement.
+            continue;
+        }
+        const domain = Array.isArray(config["domain"]) ? config["domain"] : undefined;
+        if (domain === undefined || domain.length !== 2)
+            continue;
+        const domainSemantics = resolveBoundarySemantics(domain, config);
+        if (domainSemantics === null || domainSemantics.length !== 2) {
+            // Unparseable domain is a separate runtime style-domain-invalid path; the
+            // censor-recovery check covers type-mismatch. Only emit agreement here when
+            // both sides fully resolve.
+            continue;
+        }
+        const first = breakSemantics[0];
+        const last = breakSemantics.at(-1);
+        if (domainSemantics[0] !== first || domainSemantics[1] !== last) {
+            errors.push({
+                code: "scale-binned-domain",
+                path: `/scales/${aesthetic}/domain`,
+                message: `The ${aesthetic} binned domain must match its first and last boundaries.`,
+                fix: {
+                    description: "Set domain to the first and last break values, or omit domain.",
+                    example: [first, last],
+                },
+            });
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=validate-structure-style-bins.js.map

package/dist/validate-structure-style-bins.js.map

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

package/dist/validate-structure.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Data-free structural grammar checks (tier-2, opt-in via validate options).
+ *
+ * Implementation:
+ *  - validate-structure-layers.ts — geom channels, rule/ribbon/computed-y forms, M2 layer rules
+ *  - validate-structure-scales.ts — named color/fill scheme vs family
+ *  - validate-structure-style-bins.ts — binned style breaks/domain well-formedness
+ *  - validate-structure-facet.ts — wrap XOR grid form
+ *
+ * Used only by validate() — not public surface.
+ */
+export { layerStructuralErrors } from "./validate-structure-layers.js";
+export { colorScaleStructuralErrors, guideStructuralErrors } from "./validate-structure-scales.js";
+export { binnedStyleScaleStructuralErrors } from "./validate-structure-style-bins.js";
+export { coordFacetStructuralErrors, facetStructuralErrors } from "./validate-structure-facet.js";
+//# sourceMappingURL=validate-structure.d.ts.map

package/dist/validate-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-structure.d.ts","sourceRoot":"","sources":["../src/validate-structure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACnG,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AACtF,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/validate-structure.js

@@ -0,0 +1,16 @@
+/**
+ * Data-free structural grammar checks (tier-2, opt-in via validate options).
+ *
+ * Implementation:
+ *  - validate-structure-layers.ts — geom channels, rule/ribbon/computed-y forms, M2 layer rules
+ *  - validate-structure-scales.ts — named color/fill scheme vs family
+ *  - validate-structure-style-bins.ts — binned style breaks/domain well-formedness
+ *  - validate-structure-facet.ts — wrap XOR grid form
+ *
+ * Used only by validate() — not public surface.
+ */
+export { layerStructuralErrors } from "./validate-structure-layers.js";
+export { colorScaleStructuralErrors, guideStructuralErrors } from "./validate-structure-scales.js";
+export { binnedStyleScaleStructuralErrors } from "./validate-structure-style-bins.js";
+export { coordFacetStructuralErrors, facetStructuralErrors } from "./validate-structure-facet.js";
+//# sourceMappingURL=validate-structure.js.map

package/dist/validate-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-structure.js","sourceRoot":"","sources":["../src/validate-structure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACnG,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AACtF,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,24 @@
+import type { SpecError } from "./errors.js";
+import type { SpecAdvisory } from "./lint.js";
+import type { PortableSpec } from "./schema.js";
+import type { ValidateOptions } from "./validate-data.js";
+export type ValidateResult = {
+    ok: true;
+    spec: PortableSpec;
+    advisories?: SpecAdvisory[];
+} | {
+    ok: false;
+    errors: SpecError[];
+    advisories?: SpecAdvisory[];
+};
+/**
+ * Validate a spec. Tier 1 (always): schema shape, no data needed. Tier 2
+ * (opt-in — pass an `options` argument, even `{}`): the grammar's structural
+ * rules (required channels per geom, bar/count y ban, rule forms) plus
+ * data-aware checks against the spec's inline data or the provided
+ * DataProfile, under documented input limits (DEFAULT_VALIDATE_LIMITS).
+ *
+ * On success, returns the input typed as PortableSpec (no copy is made).
+ */
+export declare function validate(input: unknown, options?: ValidateOptions): ValidateResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,KAAK,EAAO,YAAY,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAW1D,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAA;CAAE,GAC7D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC;AAMpE;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc,CA+GlF"}