@metamesh/generator-sdk 0.5.2 → 0.6.0

package/dist/parameters/issues.js

@@ -0,0 +1,262 @@
+import { isFontSelection } from "../fonts.js";
+import { MAX_ARRAY_ITEMS, MAX_METADATA_TEXT_LENGTH, MAX_PARAMETER_OPTIONS, MAX_TEXT_PARAMETER_LENGTH, } from "../generator-package/constants.js";
+import { isProfileValue } from "../profiles.js";
+import { HEX_COLOR_PATTERN, isRecord, readDenseArray, svgValueFits } from "./values.js";
+export const MAX_PARAMETER_ISSUES = 100;
+export const MAX_PARAMETER_ISSUE_MESSAGE_LENGTH = 1_000;
+function issue(parameterId, message) {
+    return { severity: "error", parameterId, message };
+}
+export function validateDefinitionValue(parameter, value) {
+    switch (parameter.type) {
+        case "profile":
+            return isProfileValue(value)
+                ? []
+                : [issue(parameter.id, `${parameter.label} must be a bounded, normalized side outline.`)];
+        case "font":
+            return isFontSelection(value)
+                ? []
+                : [issue(parameter.id, `${parameter.label} must be an immutable font selection.`)];
+        case "number":
+        case "slider": {
+            if (typeof value !== "number" || !Number.isFinite(value)) {
+                return [issue(parameter.id, `${parameter.label} must be a finite number.`)];
+            }
+            const issues = [];
+            if (parameter.integer && !Number.isInteger(value)) {
+                issues.push(issue(parameter.id, `${parameter.label} must be an integer.`));
+            }
+            if (parameter.min !== undefined && value < parameter.min) {
+                issues.push(issue(parameter.id, `${parameter.label} must be at least ${parameter.min}.`));
+            }
+            if (parameter.max !== undefined && value > parameter.max) {
+                issues.push(issue(parameter.id, `${parameter.label} must be at most ${parameter.max}.`));
+            }
+            return issues;
+        }
+        case "boolean":
+            return typeof value === "boolean"
+                ? []
+                : [issue(parameter.id, `${parameter.label} must be true or false.`)];
+        case "select":
+            return typeof value === "string" && parameter.options.some((option) => option.value === value)
+                ? []
+                : [issue(parameter.id, `${parameter.label} must be one of its available options.`)];
+        case "choice-set": {
+            if (!Array.isArray(value)) {
+                return [issue(parameter.id, `${parameter.label} must be a list of available choices.`)];
+            }
+            const issues = [];
+            if (value.length > MAX_PARAMETER_OPTIONS) {
+                issues.push(issue(parameter.id, `${parameter.label} must include at most ${MAX_PARAMETER_OPTIONS} choices.`));
+                return issues;
+            }
+            const entries = readDenseArray(value, MAX_PARAMETER_OPTIONS);
+            if (entries === undefined) {
+                issues.push(issue(parameter.id, `${parameter.label} must be a dense list of data values.`));
+                return issues;
+            }
+            const knownValues = new Set(parameter.options.map((option) => option.value));
+            const seen = new Set();
+            const inspectedLength = Math.min(entries.length, MAX_PARAMETER_OPTIONS);
+            for (let index = 0; index < inspectedLength; index += 1) {
+                if (issues.length === MAX_PARAMETER_ISSUES)
+                    break;
+                const entry = entries[index];
+                if (typeof entry !== "string" || !knownValues.has(entry)) {
+                    issues.push(issue(parameter.id, `${parameter.label} choice ${index + 1} must be available.`));
+                    continue;
+                }
+                if (seen.has(entry)) {
+                    issues.push(issue(parameter.id, `${parameter.label} choices must be unique.`));
+                    continue;
+                }
+                seen.add(entry);
+            }
+            if (parameter.minSelections !== undefined && entries.length < parameter.minSelections) {
+                issues.push(issue(parameter.id, `${parameter.label} must include at least ${parameter.minSelections} choices.`));
+            }
+            if (parameter.maxSelections !== undefined && entries.length > parameter.maxSelections) {
+                issues.push(issue(parameter.id, `${parameter.label} must include at most ${parameter.maxSelections} choices.`));
+            }
+            return issues;
+        }
+        case "color":
+            return typeof value === "string" && HEX_COLOR_PATTERN.test(value)
+                ? []
+                : [issue(parameter.id, `${parameter.label} must be a six-digit hex color.`)];
+        case "text":
+            if (typeof value !== "string") {
+                return [issue(parameter.id, `${parameter.label} must be text.`)];
+            }
+            return value.length <= MAX_TEXT_PARAMETER_LENGTH
+                ? []
+                : [
+                    issue(parameter.id, `${parameter.label} must contain at most ${MAX_TEXT_PARAMETER_LENGTH} characters.`),
+                ];
+        case "svg":
+            if (typeof value !== "string")
+                return [issue(parameter.id, `${parameter.label} must be SVG text.`)];
+            return svgValueFits(value)
+                ? []
+                : [issue(parameter.id, `${parameter.label} must be 256 KiB or smaller.`)];
+        case "array": {
+            if (!Array.isArray(value)) {
+                return [issue(parameter.id, `${parameter.label} must be a list.`)];
+            }
+            const issues = [];
+            if (value.length > MAX_ARRAY_ITEMS) {
+                issues.push(issue(parameter.id, `${parameter.label} must contain at most ${MAX_ARRAY_ITEMS} items.`));
+                return issues;
+            }
+            if (parameter.minItems !== undefined && value.length < parameter.minItems) {
+                issues.push(issue(parameter.id, `${parameter.label} must contain at least ${parameter.minItems} items.`));
+            }
+            if (parameter.maxItems !== undefined && value.length > parameter.maxItems) {
+                issues.push(issue(parameter.id, `${parameter.label} must contain at most ${parameter.maxItems} items.`));
+            }
+            const entries = readDenseArray(value, MAX_ARRAY_ITEMS);
+            if (entries === undefined) {
+                issues.push(issue(parameter.id, `${parameter.label} must be a dense list of data values.`));
+                return issues;
+            }
+            const inspectedLength = Math.min(value.length, MAX_ARRAY_ITEMS);
+            for (let index = 0; index < inspectedLength; index += 1) {
+                if (issues.length === MAX_PARAMETER_ISSUES)
+                    break;
+                const item = entries[index];
+                if (parameter.items.type === "string") {
+                    if (typeof item !== "string") {
+                        issues.push(issue(parameter.id, `${parameter.label} item ${index + 1} must be text.`));
+                    }
+                    else if (item.length > MAX_METADATA_TEXT_LENGTH) {
+                        issues.push(issue(parameter.id, `${parameter.label} item ${index + 1} must contain at most ${MAX_METADATA_TEXT_LENGTH} characters.`));
+                    }
+                    continue;
+                }
+                if (typeof item !== "number" || !Number.isFinite(item)) {
+                    issues.push(issue(parameter.id, `${parameter.label} item ${index + 1} must be a finite number.`));
+                    continue;
+                }
+                if (parameter.items.integer && !Number.isInteger(item)) {
+                    issues.push(issue(parameter.id, `${parameter.label} item ${index + 1} must be an integer.`));
+                }
+                if (parameter.items.min !== undefined && item < parameter.items.min) {
+                    issues.push(issue(parameter.id, `${parameter.label} item ${index + 1} must be at least ${parameter.items.min}.`));
+                }
+                if (parameter.items.max !== undefined && item > parameter.items.max) {
+                    issues.push(issue(parameter.id, `${parameter.label} item ${index + 1} must be at most ${parameter.items.max}.`));
+                }
+            }
+            return issues;
+        }
+    }
+}
+/** Caps reported issues, prioritizing errors while preserving the retained issues' input order. */
+export function aggregateParameterIssues(...issueSets) {
+    let remainingErrors = 0;
+    for (const set of issueSets) {
+        for (const entry of set) {
+            if (entry.severity === "error" && remainingErrors < MAX_PARAMETER_ISSUES) {
+                remainingErrors += 1;
+            }
+        }
+    }
+    let remainingWarnings = MAX_PARAMETER_ISSUES - remainingErrors;
+    const issues = [];
+    for (const set of issueSets) {
+        for (const entry of set) {
+            if (entry.severity === "error" && remainingErrors > 0) {
+                issues.push(entry);
+                remainingErrors -= 1;
+            }
+            else if (entry.severity === "warning" && remainingWarnings > 0) {
+                issues.push(entry);
+                remainingWarnings -= 1;
+            }
+            if (issues.length === MAX_PARAMETER_ISSUES)
+                break;
+        }
+        if (issues.length === MAX_PARAMETER_ISSUES)
+            break;
+    }
+    const errors = issues.filter((entry) => entry.severity === "error");
+    const warnings = issues.filter((entry) => entry.severity === "warning");
+    return {
+        isValid: errors.length === 0,
+        issues,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Parses validator output at the executable-code boundary.
+ *
+ * Validation issues are intentionally strict and bounded because authored and
+ * installed generator code can return values that did not pass TypeScript.
+ */
+export function parseParameterIssues(definition, value) {
+    if (!Array.isArray(value)) {
+        throw new TypeError("Generator validation must return an array of parameter issues.");
+    }
+    if (value.length > MAX_PARAMETER_ISSUES) {
+        throw new TypeError(`Generator validation may return at most ${MAX_PARAMETER_ISSUES} issues.`);
+    }
+    const entries = readDenseArray(value, MAX_PARAMETER_ISSUES);
+    if (entries === undefined) {
+        throw new TypeError("Generator validation must return a dense array of issue data values.");
+    }
+    const parameterIds = new Set(definition.parameters.map((parameter) => parameter.id));
+    const parsed = entries.map((entry, index) => {
+        const path = `Generator validation issue ${index + 1}`;
+        if (!isRecord(entry)) {
+            throw new TypeError(`${path} must be an object.`);
+        }
+        const allowedKeys = new Set(["severity", "parameterId", "message"]);
+        let keys;
+        try {
+            keys = Reflect.ownKeys(entry);
+        }
+        catch (cause) {
+            throw new TypeError(`${path} fields could not be inspected.`, { cause });
+        }
+        const unknownKey = keys.find((key) => typeof key !== "string" || !allowedKeys.has(key));
+        if (unknownKey !== undefined) {
+            throw new TypeError(`${path} contains unknown field "${String(unknownKey)}".`);
+        }
+        const dataField = (key) => {
+            let descriptor;
+            try {
+                descriptor = Object.getOwnPropertyDescriptor(entry, key);
+            }
+            catch (cause) {
+                throw new TypeError(`${path}.${key} could not be inspected.`, { cause });
+            }
+            if (descriptor === undefined)
+                return undefined;
+            if (!("value" in descriptor)) {
+                throw new TypeError(`${path}.${key} must be an own data field.`);
+            }
+            return descriptor.value;
+        };
+        const severity = dataField("severity");
+        const message = dataField("message");
+        const parameterId = dataField("parameterId");
+        if (severity !== "error" && severity !== "warning") {
+            throw new TypeError(`${path}.severity must be "error" or "warning".`);
+        }
+        if (typeof message !== "string" || message.trim().length === 0) {
+            throw new TypeError(`${path}.message must be a non-empty string.`);
+        }
+        if (message.length > MAX_PARAMETER_ISSUE_MESSAGE_LENGTH) {
+            throw new TypeError(`${path}.message may contain at most ${MAX_PARAMETER_ISSUE_MESSAGE_LENGTH} characters.`);
+        }
+        if (parameterId !== undefined &&
+            (typeof parameterId !== "string" || !parameterIds.has(parameterId))) {
+            throw new TypeError(`${path}.parameterId must identify a declared parameter.`);
+        }
+        return Object.freeze(parameterId === undefined ? { severity, message } : { severity, parameterId, message });
+    });
+    return Object.freeze(parsed);
+}
+//# sourceMappingURL=issues.js.map

package/dist/parameters/issues.js.map

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

package/dist/parameters/preparation.d.ts

@@ -0,0 +1,13 @@
+import type { GeneratorDefinition, GeneratorIssue, GeneratorParams, ParameterValidationResult } from "../contracts.js";
+export interface PreparedParameters<D extends GeneratorDefinition> {
+    readonly parameters: GeneratorParams<D>;
+    readonly validation: ParameterValidationResult;
+}
+/**
+ * Normalizes known values once, then aggregates schema and Generator-owned issues.
+ * Obsolete keys never leak into Generator validation.
+ */
+export declare function prepareParameters<const D extends GeneratorDefinition>(definition: D, parameters: Readonly<Record<string, unknown>>, validate?: (parameters: GeneratorParams<D>) => readonly GeneratorIssue<D>[]): PreparedParameters<D>;
+/** Aggregates definition and Generator-owned validation issues. */
+export declare function validateParameters<const D extends GeneratorDefinition>(definition: D, parameters: Readonly<Record<string, unknown>>, validate?: (parameters: GeneratorParams<D>) => readonly GeneratorIssue<D>[]): ParameterValidationResult;
+//# sourceMappingURL=preparation.d.ts.map

package/dist/parameters/preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preparation.d.ts","sourceRoot":"","sources":["../../src/parameters/preparation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EAEf,yBAAyB,EAC1B,MAAM,iBAAiB,CAAC;AASzB,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,mBAAmB;IAC/D,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;CAChD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,CAAC,SAAS,mBAAmB,EACnE,UAAU,EAAE,CAAC,EACb,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC7C,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,GAC1E,kBAAkB,CAAC,CAAC,CAAC,CA2BvB;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,CAAC,SAAS,mBAAmB,EACpE,UAAU,EAAE,CAAC,EACb,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC7C,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,GAC1E,yBAAyB,CAE3B"}

package/dist/parameters/preparation.js

@@ -0,0 +1,35 @@
+import { aggregateParameterIssues, parseParameterIssues, validateDefinitionValue, } from "./issues.js";
+import { normalizeParameters } from "./recovery.js";
+import { MAX_PROJECT_SVG_PARAMETER_BYTES, ownValue, svgParameterBytes } from "./values.js";
+/**
+ * Normalizes known values once, then aggregates schema and Generator-owned issues.
+ * Obsolete keys never leak into Generator validation.
+ */
+export function prepareParameters(definition, parameters, validate) {
+    const schemaIssues = definition.parameters.flatMap((parameter) => validateDefinitionValue(parameter, ownValue(parameters, parameter.id)));
+    const svgBytes = definition.parameters.reduce((total, parameter) => {
+        const value = ownValue(parameters, parameter.id);
+        return parameter.type === "svg" && typeof value === "string"
+            ? total + svgParameterBytes(value)
+            : total;
+    }, 0);
+    const projectSvgIssues = svgBytes > MAX_PROJECT_SVG_PARAMETER_BYTES
+        ? [
+            {
+                severity: "error",
+                message: "All SVG parameters together must be 512 KiB or smaller.",
+            },
+        ]
+        : [];
+    const normalized = normalizeParameters(definition, parameters);
+    const customIssues = validate === undefined ? [] : parseParameterIssues(definition, validate(normalized));
+    return {
+        parameters: normalized,
+        validation: aggregateParameterIssues(schemaIssues, projectSvgIssues, customIssues),
+    };
+}
+/** Aggregates definition and Generator-owned validation issues. */
+export function validateParameters(definition, parameters, validate) {
+    return prepareParameters(definition, parameters, validate).validation;
+}
+//# sourceMappingURL=preparation.js.map

package/dist/parameters/preparation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preparation.js","sourceRoot":"","sources":["../../src/parameters/preparation.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,+BAA+B,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAO3F;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAa,EACb,UAA6C,EAC7C,QAA2E;IAE3E,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAC/D,uBAAuB,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CACvE,CAAC;IACF,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;QACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;QACjD,OAAO,SAAS,CAAC,IAAI,KAAK,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAC1D,CAAC,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC;YAClC,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC,EAAE,CAAC,CAAC,CAAC;IACN,MAAM,gBAAgB,GACpB,QAAQ,GAAG,+BAA+B;QACxC,CAAC,CAAC;YACE;gBACE,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,yDAAyD;aAC1C;SAC3B;QACH,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,UAAU,GAAG,mBAAmB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC/D,MAAM,YAAY,GAChB,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAEvF,OAAO;QACL,UAAU,EAAE,UAAU;QACtB,UAAU,EAAE,wBAAwB,CAAC,YAAY,EAAE,gBAAgB,EAAE,YAAY,CAAC;KACnF,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,kBAAkB,CAChC,UAAa,EACb,UAA6C,EAC7C,QAA2E;IAE3E,OAAO,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC;AACxE,CAAC"}

package/dist/parameters/recovery.d.ts

@@ -0,0 +1,10 @@
+import type { GeneratorDefinition, GeneratorParams, ParameterDefinition, ParameterValue } from "../contracts.js";
+export declare function normalizeValue(parameter: ParameterDefinition, value: unknown, fallback: ParameterValue): ParameterValue;
+export declare function normalizedDefinitionDefault(parameter: ParameterDefinition): ParameterValue;
+/**
+ * Returns one value per declared parameter. Unknown input keys are discarded,
+ * missing/invalid values fall back to defaults, and numbers are clamped.
+ */
+export declare function normalizeParameters<const D extends GeneratorDefinition>(definition: D, input?: Readonly<Record<string, unknown>> | null): GeneratorParams<D>;
+export declare function getDefaultParameters<const D extends GeneratorDefinition>(definition: D): GeneratorParams<D>;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/parameters/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/parameters/recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACf,MAAM,iBAAiB,CAAC;AAkCzB,wBAAgB,cAAc,CAC5B,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,cAAc,GACvB,cAAc,CAwFhB;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,mBAAmB,GAAG,cAAc,CAE1F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,mBAAmB,EACrE,UAAU,EAAE,CAAC,EACb,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAC/C,eAAe,CAAC,CAAC,CAAC,CASpB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,CAAC,SAAS,mBAAmB,EACtE,UAAU,EAAE,CAAC,GACZ,eAAe,CAAC,CAAC,CAAC,CAEpB"}

package/dist/parameters/recovery.js

@@ -0,0 +1,124 @@
+import { isFontSelection } from "../fonts.js";
+import { MAX_ARRAY_ITEMS, MAX_METADATA_TEXT_LENGTH, MAX_PARAMETER_OPTIONS, MAX_TEXT_PARAMETER_LENGTH, } from "../generator-package/constants.js";
+import { cloneProfileValue, isProfileValue } from "../profiles.js";
+import { freezeParameters, HEX_COLOR_PATTERN, ownValue, readDenseArray, svgValueFits, } from "./values.js";
+function isBoundedStringArray(value) {
+    return value.every((item) => typeof item === "string" && item.length <= MAX_METADATA_TEXT_LENGTH);
+}
+function isFiniteNumberArray(value) {
+    return value.every((item) => typeof item === "number" && Number.isFinite(item));
+}
+function isParameterArray(value) {
+    return Array.isArray(value);
+}
+function clamp(value, minimum, maximum) {
+    const withMinimum = minimum === undefined ? value : Math.max(minimum, value);
+    return maximum === undefined ? withMinimum : Math.min(maximum, withMinimum);
+}
+export function normalizeValue(parameter, value, fallback) {
+    const fallbackValue = isParameterArray(fallback)
+        ? fallback.slice()
+        : isFontSelection(fallback)
+            ? { ...fallback }
+            : isProfileValue(fallback)
+                ? cloneProfileValue(fallback)
+                : fallback;
+    switch (parameter.type) {
+        case "profile":
+            return isProfileValue(value) ? cloneProfileValue(value) : fallbackValue;
+        case "font":
+            return isFontSelection(value)
+                ? { faceId: value.faceId, revision: value.revision, weight: value.weight }
+                : fallbackValue;
+        case "number":
+        case "slider":
+            return typeof value === "number" &&
+                Number.isFinite(value) &&
+                (!parameter.integer || Number.isInteger(value))
+                ? clamp(value, parameter.min, parameter.max)
+                : fallbackValue;
+        case "boolean":
+            return typeof value === "boolean" ? value : fallbackValue;
+        case "select":
+            return typeof value === "string" && parameter.options.some((option) => option.value === value)
+                ? value
+                : fallbackValue;
+        case "choice-set": {
+            if (!Array.isArray(value) || value.length > MAX_PARAMETER_OPTIONS) {
+                return fallbackValue;
+            }
+            const entries = readDenseArray(value, MAX_PARAMETER_OPTIONS);
+            if (entries === undefined)
+                return fallbackValue;
+            const knownValues = new Set(parameter.options.map((option) => option.value));
+            const selected = new Set();
+            for (let index = 0; index < entries.length; index += 1) {
+                const entry = entries[index];
+                if (typeof entry !== "string" || !knownValues.has(entry) || selected.has(entry)) {
+                    return fallbackValue;
+                }
+                selected.add(entry);
+            }
+            if ((parameter.minSelections !== undefined && entries.length < parameter.minSelections) ||
+                (parameter.maxSelections !== undefined && entries.length > parameter.maxSelections)) {
+                return fallbackValue;
+            }
+            // Selection order has no meaning; option-definition order is the
+            // canonical representation used by persistence, presets, and equality.
+            return parameter.options
+                .map((option) => option.value)
+                .filter((option) => selected.has(option));
+        }
+        case "color":
+            return typeof value === "string" && HEX_COLOR_PATTERN.test(value)
+                ? value.toLowerCase()
+                : fallbackValue;
+        case "text":
+            return typeof value === "string" && value.length <= MAX_TEXT_PARAMETER_LENGTH
+                ? value
+                : fallbackValue;
+        case "svg":
+            return typeof value === "string" && svgValueFits(value) ? value : fallbackValue;
+        case "array": {
+            if (!Array.isArray(value))
+                return fallbackValue;
+            if (value.length > MAX_ARRAY_ITEMS ||
+                (parameter.minItems !== undefined && value.length < parameter.minItems) ||
+                (parameter.maxItems !== undefined && value.length > parameter.maxItems)) {
+                return fallbackValue;
+            }
+            const entries = readDenseArray(value, MAX_ARRAY_ITEMS);
+            if (entries === undefined)
+                return fallbackValue;
+            if (parameter.items.type === "string") {
+                return isBoundedStringArray(entries) ? entries : fallbackValue;
+            }
+            const numericItems = parameter.items;
+            if (!isFiniteNumberArray(entries) ||
+                (numericItems.integer && !entries.every(Number.isInteger)))
+                return fallbackValue;
+            return entries.map((item) => clamp(item, numericItems.min, numericItems.max));
+        }
+    }
+}
+export function normalizedDefinitionDefault(parameter) {
+    return normalizeValue(parameter, parameter.default, parameter.default);
+}
+/**
+ * Returns one value per declared parameter. Unknown input keys are discarded,
+ * missing/invalid values fall back to defaults, and numbers are clamped.
+ */
+export function normalizeParameters(definition, input) {
+    const entries = definition.parameters.map((parameter) => {
+        const fallback = normalizedDefinitionDefault(parameter);
+        return [
+            parameter.id,
+            normalizeValue(parameter, ownValue(input, parameter.id), fallback),
+        ];
+    });
+    return freezeParameters(Object.fromEntries(entries));
+}
+export function getDefaultParameters(definition) {
+    return normalizeParameters(definition);
+}
+//# sourceMappingURL=recovery.js.map

package/dist/parameters/recovery.js.map

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

package/dist/parameters/strict.d.ts

@@ -0,0 +1,30 @@
+import type { GeneratorDefinition, GeneratorParams } from "../contracts.js";
+export type ParamDecodeCode = "invalid" | "missing" | "type" | "unknown";
+export interface ParamDecodeIssue {
+    readonly code: ParamDecodeCode;
+    readonly parameterId?: string;
+    readonly path: readonly (number | string)[];
+    readonly message: string;
+}
+export type ParamParseResult<P> = {
+    readonly success: true;
+    readonly data: P;
+} | {
+    readonly success: false;
+    readonly issues: readonly ParamDecodeIssue[];
+};
+export interface ParamCodec<D extends GeneratorDefinition> {
+    readonly parse: (input: unknown) => GeneratorParams<D>;
+    readonly safeParse: (input: unknown) => ParamParseResult<GeneratorParams<D>>;
+}
+export declare class ParamDecodeError extends TypeError {
+    readonly issues: readonly ParamDecodeIssue[];
+    constructor(issues: readonly ParamDecodeIssue[]);
+}
+/**
+ * Creates a strict decoder for the exact normalized parameter map described by
+ * a definition. Unlike normalization, decoding never fills, drops, clamps, or
+ * canonicalizes values.
+ */
+export declare function createParamCodec<const D extends GeneratorDefinition>(definition: D): ParamCodec<D>;
+//# sourceMappingURL=strict.d.ts.map

package/dist/parameters/strict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict.d.ts","sourceRoot":"","sources":["../../src/parameters/strict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAkB,MAAM,iBAAiB,CAAC;AAe5F,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAAE,CAAC;AAE9E,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,mBAAmB;IACvD,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,eAAe,CAAC,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9E;AAED,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;gBAEjC,MAAM,EAAE,SAAS,gBAAgB,EAAE;CAKhD;AA2BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAClE,UAAU,EAAE,CAAC,GACZ,UAAU,CAAC,CAAC,CAAC,CA6Gf"}

package/dist/parameters/strict.js

@@ -0,0 +1,116 @@
+import { isFontSelection } from "../fonts.js";
+import { MAX_ARRAY_ITEMS } from "../generator-package/constants.js";
+import { isProfileValue, profileValuesEqual } from "../profiles.js";
+import { MAX_PARAMETER_ISSUES, validateDefinitionValue } from "./issues.js";
+import { normalizedDefinitionDefault, normalizeValue } from "./recovery.js";
+import { freezeParameters, isRecord, MAX_PROJECT_SVG_PARAMETER_BYTES, parameterValueEquals, readDenseArray, svgParameterBytes, } from "./values.js";
+export class ParamDecodeError extends TypeError {
+    issues;
+    constructor(issues) {
+        super(issues[0]?.message ?? "Generator parameters are invalid.");
+        this.name = "ParamDecodeError";
+        this.issues = issues;
+    }
+}
+function valueMatchesCanonical(value, canonical) {
+    if (isProfileValue(canonical)) {
+        return isProfileValue(value) && profileValuesEqual(value, canonical);
+    }
+    if (isFontSelection(canonical))
+        return isFontSelection(value) && parameterValueEquals(value, canonical);
+    if (!Array.isArray(canonical))
+        return Object.is(value, canonical);
+    const entries = readDenseArray(value, MAX_ARRAY_ITEMS);
+    if (entries === undefined || entries.length !== canonical.length)
+        return false;
+    return canonical.every((entry, index) => Object.is(entry, entries[index]));
+}
+function decodeIssue(code, path, message, parameterId) {
+    return parameterId === undefined ? { code, path, message } : { code, path, parameterId, message };
+}
+function appendDecodeIssue(issues, next) {
+    if (issues.length < MAX_PARAMETER_ISSUES)
+        issues.push(next);
+}
+/**
+ * Creates a strict decoder for the exact normalized parameter map described by
+ * a definition. Unlike normalization, decoding never fills, drops, clamps, or
+ * canonicalizes values.
+ */
+export function createParamCodec(definition) {
+    const parameterIds = new Set(definition.parameters.map((parameter) => parameter.id));
+    if (parameterIds.size !== definition.parameters.length) {
+        throw new TypeError("Generator parameter IDs must be unique.");
+    }
+    const safeParse = (input) => {
+        if (!isRecord(input)) {
+            return {
+                success: false,
+                issues: [decodeIssue("type", [], "Generator parameters must be an object.")],
+            };
+        }
+        const issues = [];
+        for (const key of Reflect.ownKeys(input)) {
+            if (typeof key !== "string" || !parameterIds.has(key)) {
+                const printableKey = typeof key === "string" ? key : String(key);
+                appendDecodeIssue(issues, decodeIssue("unknown", [printableKey], `Unknown Generator parameter "${printableKey}".`));
+                if (issues.length === MAX_PARAMETER_ISSUES)
+                    break;
+            }
+        }
+        const entries = [];
+        let svgBytes = 0;
+        for (const parameter of definition.parameters) {
+            if (issues.length === MAX_PARAMETER_ISSUES)
+                break;
+            const descriptor = Object.getOwnPropertyDescriptor(input, parameter.id);
+            if (descriptor === undefined) {
+                appendDecodeIssue(issues, decodeIssue("missing", [parameter.id], `${parameter.label} is required.`, parameter.id));
+                continue;
+            }
+            if (!("value" in descriptor)) {
+                appendDecodeIssue(issues, decodeIssue("invalid", [parameter.id], `${parameter.label} must be a data value.`, parameter.id));
+                continue;
+            }
+            const value = descriptor.value;
+            const fieldIssues = validateDefinitionValue(parameter, value);
+            for (const fieldIssue of fieldIssues) {
+                appendDecodeIssue(issues, decodeIssue("invalid", [parameter.id], fieldIssue.message, parameter.id));
+            }
+            if (fieldIssues.length > 0)
+                continue;
+            const canonical = normalizeValue(parameter, value, normalizedDefinitionDefault(parameter));
+            if (!valueMatchesCanonical(value, canonical)) {
+                appendDecodeIssue(issues, decodeIssue("invalid", [parameter.id], `${parameter.label} must use its canonical representation.`, parameter.id));
+                continue;
+            }
+            if (parameter.type === "svg" && typeof value === "string") {
+                svgBytes += svgParameterBytes(value);
+            }
+            entries.push([
+                parameter.id,
+                Array.isArray(canonical) ? canonical.slice() : canonical,
+            ]);
+        }
+        if (svgBytes > MAX_PROJECT_SVG_PARAMETER_BYTES && issues.length < MAX_PARAMETER_ISSUES) {
+            appendDecodeIssue(issues, decodeIssue("invalid", [], "All SVG parameters together must be 512 KiB or smaller."));
+        }
+        if (issues.length > 0) {
+            return { success: false, issues: Object.freeze(issues) };
+        }
+        return {
+            success: true,
+            data: freezeParameters(Object.fromEntries(entries)),
+        };
+    };
+    return {
+        safeParse,
+        parse(input) {
+            const result = safeParse(input);
+            if (!result.success)
+                throw new ParamDecodeError(result.issues);
+            return result.data;
+        },
+    };
+}
+//# sourceMappingURL=strict.js.map