@servrox/console-fx 0.1.0

package/dist/validation/index.js

@@ -0,0 +1,291 @@
+import { effectDescriptor, EFFECT_ORDER } from "../effects/catalog.js";
+import { deepFreeze, LIMITS } from "../model/limits.js";
+import { presentationDescriptor } from "../presentations/catalog.js";
+export class SceneValidationError extends Error {
+    diagnostics;
+    constructor(diagnostics) {
+        super(diagnostics[0]?.message ?? "Invalid scene.");
+        this.name = "SceneValidationError";
+        this.diagnostics = deepFreeze([...diagnostics]);
+    }
+}
+export function fail(code, message, path) {
+    throw new SceneValidationError([{ code, severity: "error", message, path }]);
+}
+export function record(input, keys, path) {
+    if (input === null || typeof input !== "object" || Array.isArray(input)) {
+        fail("invalid-object", "Expected a plain data object.", path);
+    }
+    const prototype = Object.getPrototypeOf(input);
+    if (prototype !== Object.prototype && prototype !== null)
+        fail("invalid-object", "Expected a plain data object.", path);
+    const descriptors = Object.getOwnPropertyDescriptors(input);
+    const result = Object.create(null);
+    for (const key of Reflect.ownKeys(descriptors)) {
+        // The schema-owned allowlists contain no prototype-related property names.
+        if (typeof key !== "string" || !keys.includes(key)) {
+            fail("unknown-property", "Unsupported property.", path);
+        }
+        const descriptor = descriptors[key];
+        if (!("value" in descriptor) || !descriptor.enumerable)
+            fail("invalid-property", "Accessors and hidden properties are unsupported.", [...path, key]);
+        result[key] = descriptor.value;
+    }
+    return result;
+}
+export function array(input, max, path) {
+    if (!Array.isArray(input))
+        fail("invalid-array", "Expected an array.", path);
+    if (Object.getPrototypeOf(input) !== Array.prototype)
+        fail("invalid-array", "Expected a plain array.", path);
+    if (input.length > max)
+        fail("resource-limit", "Structure limit exceeded.", path);
+    for (const key of Reflect.ownKeys(input)) {
+        if (key !== "length" &&
+            (typeof key !== "string" ||
+                !/^(0|[1-9]\d*)$/.test(key) ||
+                Number(key) >= input.length))
+            fail("unknown-property", "Extra array properties are unsupported.", path);
+    }
+    // Validate data descriptors before accessing items; never invoke an imported getter.
+    for (let index = 0; index < input.length; index++) {
+        const descriptor = Object.getOwnPropertyDescriptor(input, index);
+        if (!descriptor || !("value" in descriptor))
+            fail("invalid-array", "Sparse arrays and accessors are unsupported.", path);
+    }
+    return input;
+}
+function numeric(value, fallback, min, max, path) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== "number" ||
+        !Number.isFinite(value) ||
+        value < min ||
+        value > max) {
+        fail("invalid-number", "Expected a finite number within limits.", path);
+    }
+    return value;
+}
+function choice(value, fallback, values, path) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== "string" || !values.includes(value))
+        fail("invalid-enum", "Choose a documented option.", path);
+    return value;
+}
+function color(value, fallback, path) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== "string" ||
+        !/^#(?:[\da-f]{3}|[\da-f]{6}|[\da-f]{8})$/i.test(value))
+        fail("invalid-color", "Use a hexadecimal color.", path);
+    const normalized = value.toLowerCase();
+    return normalized.length === 4
+        ? `#${[...normalized.slice(1)].map((part) => part + part).join("")}`
+        : normalized;
+}
+export function text(value, path) {
+    if (typeof value !== "string")
+        fail("invalid-text", "Expected text.", path);
+    if (value.length > LIMITS.textCodePoints * 2)
+        fail("resource-limit", "Text limit exceeded.", path);
+    // eslint-disable-next-line no-control-regex -- This boundary deliberately rejects forbidden control characters.
+    if (/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f]/u.test(value))
+        fail("invalid-control-character", "Control and ANSI escape characters are unsupported.", path);
+    if (/[\ud800-\udbff](?![\udc00-\udfff])|(?<![\ud800-\udbff])[\udc00-\udfff]/u.test(value))
+        fail("invalid-unicode", "Text contains an unpaired Unicode surrogate.", path);
+    return value.replace(/\r\n?/g, "\n");
+}
+function normalize(input) {
+    const root = record(input, ["schemaVersion", "label", "surface", "lines", "motion", "presentation"], []);
+    if (root.schemaVersion !== 1)
+        fail("unsupported-schema-version", "Unsupported scene version.", [
+            "schemaVersion",
+        ]);
+    const label = text(root.label, ["label"]);
+    let presentation;
+    if (root.presentation !== undefined) {
+        const data = record(root.presentation, ["kind", "profile", "accent", "detail", "tone"], ["presentation"]);
+        const descriptor = typeof data.profile === "string"
+            ? presentationDescriptor(data.profile)
+            : undefined;
+        if (data.kind !== "presetCard" || !descriptor)
+            fail("unsupported-presentation", "Choose a documented card profile.", [
+                "presentation",
+                "profile",
+            ]);
+        if (descriptor.id !== "requestTrace" && Object.hasOwn(data, "tone"))
+            fail("unknown-property", "Tone belongs only to Request Trace.", [
+                "presentation",
+                "tone",
+            ]);
+        presentation = {
+            kind: "presetCard",
+            profile: descriptor.profile,
+            accent: color(data.accent, descriptor.accent, ["presentation", "accent"]),
+            detail: choice(data.detail, "standard", ["minimal", "standard"], ["presentation", "detail"]),
+            ...(descriptor.id === "requestTrace"
+                ? {
+                    tone: choice(data.tone, "neutral", ["success", "warning", "error", "neutral"], ["presentation", "tone"]),
+                }
+                : {}),
+        };
+    }
+    let textCount = [...label].length;
+    let runCount = 0;
+    const surface = record(root.surface ?? {}, ["width", "height", "background", "padding", "borderRadius"], ["surface"]);
+    const normalizedSurface = {
+        width: numeric(surface.width, 600, 80, LIMITS.svgWidth, [
+            "surface",
+            "width",
+        ]),
+        height: numeric(surface.height, 180, 40, LIMITS.svgHeight, [
+            "surface",
+            "height",
+        ]),
+        background: color(surface.background, "#0c1117", ["surface", "background"]),
+        padding: numeric(surface.padding, 20, 0, 64, ["surface", "padding"]),
+        borderRadius: numeric(surface.borderRadius, 16, 0, 64, [
+            "surface",
+            "borderRadius",
+        ]),
+    };
+    if (normalizedSurface.padding * 2 >=
+        Math.min(normalizedSurface.width, normalizedSurface.height))
+        fail("invalid-surface", "Padding must leave room for the message.", [
+            "surface",
+            "padding",
+        ]);
+    const motion = record(root.motion ?? {}, ["durationMs", "finish"], ["motion"]);
+    const lines = array(root.lines, LIMITS.lines, ["lines"]).map((value, lineIndex) => {
+        const path = ["lines", lineIndex];
+        const line = record(value, ["align", "runs"], path);
+        const runs = array(line.runs, LIMITS.runs, [...path, "runs"]).map((value, runIndex) => {
+            const runPath = [...path, "runs", runIndex];
+            if (++runCount > LIMITS.runs)
+                fail("resource-limit", "A scene supports at most 32 runs.", runPath);
+            const run = record(value, ["text", "style", "effects"], runPath);
+            const runText = text(run.text, [...runPath, "text"]);
+            textCount += [...runText].length;
+            if (textCount > LIMITS.textCodePoints)
+                fail("resource-limit", "At most 2,000 text code points, including the label.", runPath);
+            const style = record(run.style ?? {}, ["color", "fontSize", "fontWeight", "fontFamily", "letterSpacing"], [...runPath, "style"]);
+            const families = new Set();
+            const effects = array(run.effects ?? [], LIMITS.effectsPerRun, [
+                ...runPath,
+                "effects",
+            ])
+                .map((value, effectIndex) => {
+                const effectPath = [...runPath, "effects", effectIndex];
+                // Inspect kind as a data property before choosing the catalog-owned schema.
+                if (value === null || typeof value !== "object")
+                    fail("invalid-effect", "Expected an effect object.", effectPath);
+                const kindProperty = Object.getOwnPropertyDescriptor(value, "kind");
+                if (!kindProperty ||
+                    !("value" in kindProperty) ||
+                    typeof kindProperty.value !== "string")
+                    fail("invalid-effect", "Choose a built-in effect.", effectPath);
+                const descriptor = effectDescriptor(kindProperty.value);
+                if (!descriptor)
+                    fail("invalid-effect", "Choose a built-in effect.", effectPath);
+                if (families.has(descriptor.family))
+                    fail("effect-conflict", "Effects cannot share a family.", effectPath);
+                families.add(descriptor.family);
+                const effect = record(value, ["kind", ...Object.keys(descriptor.parameters)], effectPath);
+                const normalized = {
+                    kind: descriptor.kind,
+                };
+                for (const [key, parameter] of Object.entries(descriptor.parameters)) {
+                    const parameterPath = [...effectPath, key];
+                    switch (parameter.type) {
+                        case "number":
+                            normalized[key] = numeric(effect[key], parameter.default, parameter.min, parameter.max, parameterPath);
+                            break;
+                        case "color":
+                            normalized[key] = color(effect[key], parameter.default, parameterPath);
+                            break;
+                        case "enum":
+                            normalized[key] = choice(effect[key], parameter.default, parameter.values, parameterPath);
+                            break;
+                        case "boolean":
+                            if (effect[key] !== undefined &&
+                                typeof effect[key] !== "boolean")
+                                fail("invalid-boolean", "Expected a boolean.", parameterPath);
+                            normalized[key] = effect[key] ?? parameter.default;
+                    }
+                }
+                return normalized;
+            })
+                .sort((a, b) => EFFECT_ORDER.indexOf(a.kind) - EFFECT_ORDER.indexOf(b.kind));
+            return {
+                text: runText,
+                style: {
+                    color: color(style.color, "#e8f3f5", [
+                        ...runPath,
+                        "style",
+                        "color",
+                    ]),
+                    fontSize: numeric(style.fontSize, 36, 8, 96, [
+                        ...runPath,
+                        "style",
+                        "fontSize",
+                    ]),
+                    fontWeight: numeric(style.fontWeight, 700, 100, 900, [
+                        ...runPath,
+                        "style",
+                        "fontWeight",
+                    ]),
+                    fontFamily: choice(style.fontFamily, "mono", ["sans", "mono", "serif"], [...runPath, "style", "fontFamily"]),
+                    letterSpacing: numeric(style.letterSpacing, 0, -2, 10, [
+                        ...runPath,
+                        "style",
+                        "letterSpacing",
+                    ]),
+                },
+                effects,
+            };
+        });
+        return {
+            align: choice(line.align, "left", ["left", "center", "right"], [...path, "align"]),
+            runs,
+        };
+    });
+    if (textCount > LIMITS.textCodePoints)
+        fail("resource-limit", "Text limit exceeded.", ["label"]);
+    const visualLineCount = lines.length +
+        lines.reduce((count, line) => count +
+            line.runs.reduce((count, run) => count + run.text.split("\n").length - 1, 0), 0);
+    if (visualLineCount > LIMITS.lines)
+        fail("resource-limit", "At most eight visual lines, including run newlines.", ["lines"]);
+    return deepFreeze({
+        schemaVersion: 1,
+        label,
+        surface: normalizedSurface,
+        lines,
+        motion: {
+            durationMs: numeric(motion.durationMs, 4800, 1000, LIMITS.motionMs, [
+                "motion",
+                "durationMs",
+            ]),
+            finish: choice(motion.finish, "freeze", ["freeze"], ["motion", "finish"]),
+        },
+        ...(presentation ? { presentation } : {}),
+    });
+}
+export function parseScene(input) {
+    try {
+        return { ok: true, value: normalize(input), diagnostics: [] };
+    }
+    catch (error) {
+        if (error instanceof SceneValidationError)
+            return { ok: false, diagnostics: error.diagnostics };
+        throw error;
+    }
+}
+export function defineScene(input) {
+    const result = parseScene(input);
+    if (!result.ok)
+        throw new SceneValidationError(result.diagnostics);
+    return result.value;
+}
+//# 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":"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"}

package/dist/validation/layout.d.ts

@@ -0,0 +1,10 @@
+import type { LayoutRequest, OutputSizing, MeasurementSnapshot, TextMeasurementRequest } from "../model/layout.js";
+export declare function fitNumber(value: unknown, min: number, max: number, path: readonly (string | number)[]): number;
+export declare function normalizeLayout(input: unknown): LayoutRequest;
+export declare function normalizeSizing(input: unknown): OutputSizing;
+export declare function measurementEnvironment(input: unknown): string;
+/** Collision-free identity, bounded by the snapshot/request budgets. No content hash guesses. */
+export declare function measurementKey(r: Omit<TextMeasurementRequest, "key">): string;
+export declare function normalizeMeasurementRequest(input: unknown): TextMeasurementRequest;
+export declare function normalizeMeasurements(input: unknown): MeasurementSnapshot;
+//# sourceMappingURL=layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/validation/layout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EAEvB,MAAM,oBAAoB,CAAC;AAG5B,wBAAgB,SAAS,CACvB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GACjC,MAAM,CAaR;AAUD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAyB7D;AACD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAsB5D;AACD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAS7D;AACD,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,GAAG,MAAM,CAc7E;AACD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb,sBAAsB,CAmFxB;AACD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAmEzE"}

package/dist/validation/layout.js

@@ -0,0 +1,183 @@
+import { deepFreeze, LIMITS, utf8ByteLength } from "../model/limits.js";
+import { array, defineScene, fail, record, text } from "./index.js";
+export function fitNumber(value, min, max, path) {
+    if (typeof value !== "number" ||
+        !Number.isFinite(value) ||
+        value < min ||
+        value > max)
+        fail("invalid-number", "Expected a finite fitting value within limits.", path);
+    return value;
+}
+function choice(input, choices, path) {
+    if (typeof input !== "string" || !choices.includes(input))
+        fail("invalid-options", "Choose a documented fitting option.", path);
+    return input;
+}
+export function normalizeLayout(input) {
+    const d = record(input, ["algorithm", "width", "maxHeight", "variant", "overflow", "minFontSize"], ["layout"]);
+    return deepFreeze({
+        algorithm: choice(d.algorithm, ["fit/v1"], ["layout", "algorithm"]),
+        width: fitNumber(d.width, 1, LIMITS.svgWidth, ["layout", "width"]),
+        maxHeight: fitNumber(d.maxHeight, 1, LIMITS.svgHeight, [
+            "layout",
+            "maxHeight",
+        ]),
+        variant: choice(d.variant, ["standard", "compact", "auto"], ["layout", "variant"]),
+        overflow: choice(d.overflow, ["error", "wrap", "shrink", "wrap-then-shrink"], ["layout", "overflow"]),
+        minFontSize: fitNumber(d.minFontSize, 8, 160, ["layout", "minFontSize"]),
+    });
+}
+export function normalizeSizing(input) {
+    const d = record(input, ["mode", "width", "maxWidth", "fillFraction"], ["sizing"]);
+    if (d.mode === "fixed") {
+        record(input, ["mode", "width"], ["sizing"]);
+        return deepFreeze({
+            mode: "fixed",
+            width: fitNumber(d.width, 1, LIMITS.svgWidth, ["sizing", "width"]),
+        });
+    }
+    record(input, ["mode", "maxWidth", "fillFraction"], ["sizing"]);
+    return deepFreeze({
+        mode: choice(d.mode, ["container-experimental"], ["sizing", "mode"]),
+        maxWidth: fitNumber(d.maxWidth, 1, LIMITS.svgWidth, ["sizing", "maxWidth"]),
+        fillFraction: fitNumber(d.fillFraction ?? 0.96, 0.5, 0.98, [
+            "sizing",
+            "fillFraction",
+        ]),
+    });
+}
+export function measurementEnvironment(input) {
+    const value = text(input, ["measurementEnvironment"]);
+    if (!value || value.length > 160 || /[\n\t]/u.test(value))
+        fail("invalid-measurement", "Use a short explicit font-environment identifier.", ["measurementEnvironment"]);
+    return value;
+}
+/** Collision-free identity, bounded by the snapshot/request budgets. No content hash guesses. */
+export function measurementKey(r) {
+    return JSON.stringify([
+        r.algorithm,
+        r.profile,
+        r.text,
+        r.style.color,
+        r.style.fontFamily,
+        r.style.fontSize,
+        r.style.fontWeight,
+        r.style.letterSpacing,
+        r.italic,
+        r.direction,
+        r.environment,
+    ]);
+}
+export function normalizeMeasurementRequest(input) {
+    const d = record(input, [
+        "key",
+        "algorithm",
+        "profile",
+        "text",
+        "style",
+        "italic",
+        "direction",
+        "environment",
+    ], ["measurement"]);
+    const profile = text(d.profile, ["measurement", "profile"]);
+    if (!/^(flow\/v1|(?:buildReceipt|requestTrace|serviceReady|commandCard|releaseBulletin|blueprint|contourMap|letterpress|signalHalftone|orbital)\/(?:compact\/)?v1|(?:lightning-metal|ice-cathedral|liquid-chrome|molten-gold)-v1)$/u.test(profile))
+        fail("invalid-measurement", "Unknown measurement profile.", [
+            "measurement",
+            "profile",
+        ]);
+    // Reuse the strict scene style/text validator, including accessor/control checks.
+    const suppliedStyle = record(d.style, ["color", "fontSize", "fontWeight", "fontFamily", "letterSpacing"], ["measurement", "style"]);
+    // Derived artboard type may be below 8px when explicit output upscaling keeps
+    // the requested display floor. This never changes the source scene's limits.
+    const fontSize = fitNumber(suppliedStyle.fontSize, 0.0001, 96, [
+        "measurement",
+        "style",
+        "fontSize",
+    ]);
+    const run = defineScene({
+        schemaVersion: 1,
+        label: "",
+        lines: [
+            {
+                runs: [
+                    {
+                        text: d.text,
+                        style: { ...suppliedStyle, fontSize: Math.max(8, fontSize) },
+                    },
+                ],
+            },
+        ],
+    }).lines[0].runs[0];
+    if (/[\n\t\u2028\u2029]/u.test(run.text))
+        fail("invalid-measurement", "Measure one complete visual fragment.", [
+            "measurement",
+            "text",
+        ]);
+    if (typeof d.italic !== "boolean")
+        fail("invalid-measurement", "Specify the font style.", [
+            "measurement",
+            "italic",
+        ]);
+    const r = {
+        algorithm: choice(d.algorithm, ["fit/v1"], ["measurement", "algorithm"]),
+        profile,
+        text: run.text,
+        style: { ...run.style, fontSize },
+        italic: d.italic,
+        direction: choice(d.direction, ["ltr", "rtl"], ["measurement", "direction"]),
+        environment: measurementEnvironment(d.environment),
+    };
+    const key = measurementKey(r);
+    if (d.key !== key)
+        fail("invalid-measurement", "Measurement key does not match its exact text, style and environment.", ["measurement", "key"]);
+    return deepFreeze({ key, ...r });
+}
+export function normalizeMeasurements(input) {
+    const d = record(input, ["kind", "measurementVersion", "environment", "records"], ["measurements"]);
+    if (d.kind !== "consoleFxMeasurements" || d.measurementVersion !== 1)
+        fail("invalid-measurement", "Unsupported measurement snapshot.", [
+            "measurements",
+        ]);
+    const environment = measurementEnvironment(d.environment);
+    let bytes = utf8ByteLength(environment) + 100;
+    const seen = new Set();
+    const records = array(d.records, 512, ["measurements", "records"]).map((input) => {
+        const r = record(input, ["request", "advance", "inkLeft", "inkRight", "ascent", "descent"], ["measurements", "records"]);
+        const request = normalizeMeasurementRequest(r.request);
+        if (request.environment !== environment || seen.has(request.key))
+            fail("invalid-measurement", "Duplicate or mismatched measurement environment.", ["measurements"]);
+        seen.add(request.key);
+        const metrics = {
+            request,
+            advance: fitNumber(r.advance, 0, 1e6, ["measurements", "advance"]),
+            inkLeft: fitNumber(r.inkLeft, -1e6, 1e6, ["measurements", "inkLeft"]),
+            inkRight: fitNumber(r.inkRight, -1e6, 1e6, [
+                "measurements",
+                "inkRight",
+            ]),
+            ascent: fitNumber(r.ascent, -1e6, 1e6, ["measurements", "ascent"]),
+            descent: fitNumber(r.descent, -1e6, 1e6, ["measurements", "descent"]),
+        };
+        if (metrics.inkRight + metrics.inkLeft < 0 ||
+            metrics.ascent + metrics.descent < 0)
+            fail("invalid-measurement", "Inverted text ink bounds.", [
+                "measurements",
+            ]);
+        bytes += utf8ByteLength(JSON.stringify(metrics));
+        if (bytes > LIMITS.inputBytes)
+            fail("resource-limit", "Measurement snapshots must fit within 64 KiB.", ["measurements"]);
+        return metrics;
+    });
+    const value = {
+        kind: "consoleFxMeasurements",
+        measurementVersion: 1,
+        environment,
+        records,
+    };
+    if (utf8ByteLength(JSON.stringify(value)) > LIMITS.inputBytes)
+        fail("resource-limit", "Measurement snapshots must fit within 64 KiB.", [
+            "measurements",
+        ]);
+    return deepFreeze(value);
+}
+//# sourceMappingURL=layout.js.map

package/dist/validation/layout.js.map

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

package/dist/validation/options.d.ts

@@ -0,0 +1,6 @@
+import type { CompileOptions, ExportOptions } from "../model/types.js";
+export declare function normalizeCompileOptions(input: unknown): NormalizedCompileOptions;
+export declare function normalizeExportOptions(input: unknown): NormalizedExportOptions;
+export type NormalizedCompileOptions = CompileOptions & Required<Pick<CompileOptions, "target" | "renderer" | "motion" | "unsupported">>;
+export type NormalizedExportOptions = ExportOptions & Required<Pick<ExportOptions, "target" | "renderer" | "motion" | "unsupported">>;
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/validation/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA0BvE,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,wBAAwB,CAE1B;AACD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,uBAAuB,CAEzB;AACD,MAAM,MAAM,wBAAwB,GAAG,cAAc,GACnD,QAAQ,CACN,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC,CACvE,CAAC;AACJ,MAAM,MAAM,uBAAuB,GAAG,aAAa,GACjD,QAAQ,CACN,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC,CACtE,CAAC"}

package/dist/validation/options.js

@@ -0,0 +1,29 @@
+import { fail, record } from "./index.js";
+function normalize(input, motion) {
+    const supported = {
+        target: ["chromium", "firefox", "safari", "node", "bun", "unknown"],
+        renderer: ["css", "svg", "text"],
+        motion,
+        unsupported: ["error", "fallback"],
+    };
+    const data = record(input, Object.keys(supported), []);
+    for (const [key, value] of Object.entries(data)) {
+        if (value !== undefined &&
+            (typeof value !== "string" ||
+                !supported[key].includes(value)))
+            fail("invalid-options", "Choose documented compilation options.", [key]);
+    }
+    return {
+        target: data.target ?? "unknown",
+        renderer: data.renderer ?? "text",
+        motion: data.motion ?? "reduce",
+        unsupported: data.unsupported ?? "error",
+    };
+}
+export function normalizeCompileOptions(input) {
+    return normalize(input, ["allow", "reduce"]);
+}
+export function normalizeExportOptions(input) {
+    return normalize(input, ["system", "reduce"]);
+}
+//# sourceMappingURL=options.js.map

package/dist/validation/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/validation/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE1C,SAAS,SAAS,CAAC,KAAc,EAAE,MAAyB;IAC1D,MAAM,SAAS,GAAG;QAChB,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC;QACnE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC;QAChC,MAAM;QACN,WAAW,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC;KACnC,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IACvD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IACE,KAAK,KAAK,SAAS;YACnB,CAAC,OAAO,KAAK,KAAK,QAAQ;gBACxB,CAAC,SAAS,CAAC,GAA6B,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAE5D,IAAI,CAAC,iBAAiB,EAAE,wCAAwC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;QAChC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM;QACjC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,QAAQ;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,OAAO;KACzC,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,uBAAuB,CACrC,KAAc;IAEd,OAAO,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAA6B,CAAC;AAC3E,CAAC;AACD,MAAM,UAAU,sBAAsB,CACpC,KAAc;IAEd,OAAO,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAA4B,CAAC;AAC3E,CAAC"}

package/dist/validation/recipe.d.ts

@@ -0,0 +1,5 @@
+import type { RenderRecipeV1 } from "../model/layout.js";
+import type { ValidationResult } from "../model/types.js";
+/** Parses recipe data only. parseScene intentionally never guesses this envelope. */
+export declare function parseRenderRecipe(input: unknown): ValidationResult<RenderRecipeV1>;
+//# sourceMappingURL=recipe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../src/validation/recipe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D,qFAAqF;AACrF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,GACb,gBAAgB,CAAC,cAAc,CAAC,CA2BlC"}

package/dist/validation/recipe.js

@@ -0,0 +1,30 @@
+import { deepFreeze, LIMITS, utf8ByteLength } from "../model/limits.js";
+import { defineScene, fail, record, SceneValidationError } from "./index.js";
+import { normalizeRenderExportOptions } from "./render-options.js";
+/** Parses recipe data only. parseScene intentionally never guesses this envelope. */
+export function parseRenderRecipe(input) {
+    try {
+        const d = record(input, ["kind", "recipeVersion", "scene", "options"], []);
+        if (d.kind !== "consoleFxRenderRecipe" || d.recipeVersion !== 1)
+            fail("unsupported-recipe", "Use a supported ConsoleFX render recipe.", [
+                "recipeVersion",
+            ]);
+        // Snapshot/environment are transient inputs and cannot enter saved recipes.
+        const options = record(d.options, ["target", "renderer", "motion", "unsupported", "layout", "sizing"], ["options"]);
+        const value = {
+            kind: "consoleFxRenderRecipe",
+            recipeVersion: 1,
+            scene: defineScene(d.scene),
+            options: normalizeRenderExportOptions(options),
+        };
+        if (utf8ByteLength(JSON.stringify(value)) > LIMITS.inputBytes)
+            fail("resource-limit", "Render recipes must fit within 64 KiB.", []);
+        return { ok: true, value: deepFreeze(value), diagnostics: [] };
+    }
+    catch (error) {
+        if (error instanceof SceneValidationError)
+            return { ok: false, diagnostics: error.diagnostics };
+        throw error;
+    }
+}
+//# sourceMappingURL=recipe.js.map

package/dist/validation/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.js","sourceRoot":"","sources":["../../src/validation/recipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAEnE,qFAAqF;AACrF,MAAM,UAAU,iBAAiB,CAC/B,KAAc;IAEd,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,CAAC,IAAI,KAAK,uBAAuB,IAAI,CAAC,CAAC,aAAa,KAAK,CAAC;YAC7D,IAAI,CAAC,oBAAoB,EAAE,0CAA0C,EAAE;gBACrE,eAAe;aAChB,CAAC,CAAC;QACL,4EAA4E;QAC5E,MAAM,OAAO,GAAG,MAAM,CACpB,CAAC,CAAC,OAAO,EACT,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAC,EACnE,CAAC,SAAS,CAAC,CACZ,CAAC;QACF,MAAM,KAAK,GAAmB;YAC5B,IAAI,EAAE,uBAAuB;YAC7B,aAAa,EAAE,CAAC;YAChB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAgC,CAAC;YACtD,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC;SAC/C,CAAC;QACF,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU;YAC3D,IAAI,CAAC,gBAAgB,EAAE,wCAAwC,EAAE,EAAE,CAAC,CAAC;QACvE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,oBAAoB;YACvC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;QACvD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}