@metamesh/generator-sdk 0.5.2 → 0.7.0

package/dist/parse-generator-module.d.ts

@@ -0,0 +1,29 @@
+import type { GeneratorDefinition, GeneratorIssue, GeneratorParams } from "./contracts.js";
+import type { Preparation } from "./generator-module.js";
+import { GENERATOR_PACKAGE_FORMAT_VERSION } from "./generator-package/constants.js";
+import type { GeneratorServices } from "./generator-services.js";
+/** A one-use closure captures preparation without exposing arbitrary prepared-value invocation. */
+export interface PreparedBuild<Context, Output> {
+    readonly ok: true;
+    readonly issues: readonly GeneratorIssue[];
+    readonly build: (context: Context) => Output;
+}
+export interface ParsedGeneratorModule<D extends GeneratorDefinition = GeneratorDefinition, Context = unknown, Output = unknown> {
+    readonly formatVersion: typeof GENERATOR_PACKAGE_FORMAT_VERSION;
+    readonly generatorId: D["id"];
+    readonly version: D["version"];
+    readonly prepare: (parameters: GeneratorParams<D>, services: GeneratorServices) => PreparedBuild<Context, Output> | {
+        readonly ok: false;
+        readonly issues: readonly GeneratorIssue<D>[];
+    };
+}
+/** Inspects only the result envelope and issues. The prepared value remains opaque. */
+export declare function parsePreparation<D extends GeneratorDefinition, P>(definition: D, result: unknown): Preparation<D, P>;
+export declare function capturePreparation<D extends GeneratorDefinition, P, Context, Output>(definition: D, result: unknown, build: (prepared: P, context: Context) => Output): PreparedBuild<Context, Output> | {
+    readonly ok: false;
+    readonly issues: readonly GeneratorIssue<D>[];
+};
+/** Captures the exact format-2 surface; unsupported formats fail before callback invocation. */
+export declare function parseGeneratorModule<D extends GeneratorDefinition, Context = unknown, Output = unknown>(value: unknown, definition: D): ParsedGeneratorModule<D, Context, Output>;
+export declare function isGeneratorModule<D extends GeneratorDefinition>(value: unknown, definition: D): boolean;
+//# sourceMappingURL=parse-generator-module.d.ts.map

package/dist/parse-generator-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-generator-module.d.ts","sourceRoot":"","sources":["../src/parse-generator-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAajE,mGAAmG;AACnG,MAAM,WAAW,aAAa,CAAC,OAAO,EAAE,MAAM;IAC5C,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;CAC9C;AAED,MAAM,WAAW,qBAAqB,CACpC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,EACnD,OAAO,GAAG,OAAO,EACjB,MAAM,GAAG,OAAO;IAEhB,QAAQ,CAAC,aAAa,EAAE,OAAO,gCAAgC,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,CAChB,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,QAAQ,EAAE,iBAAiB,KAEzB,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,GAC9B;QAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,CAAA;KAAE,CAAC;CAC3E;AAiCD,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,mBAAmB,EAAE,CAAC,EAC/D,UAAU,EAAE,CAAC,EACb,MAAM,EAAE,OAAO,GACd,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAyBnB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,mBAAmB,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAClF,UAAU,EAAE,CAAC,EACb,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,GAE9C,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,GAC9B;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,CAkBxE;AAED,gGAAgG;AAChG,wBAAgB,oBAAoB,CAClC,CAAC,SAAS,mBAAmB,EAC7B,OAAO,GAAG,OAAO,EACjB,MAAM,GAAG,OAAO,EAChB,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CA2C1E;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,mBAAmB,EAC7D,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,CAAC,GACZ,OAAO,CAOT"}

package/dist/parse-generator-module.js

@@ -0,0 +1,137 @@
+import { GENERATOR_PACKAGE_FORMAT_VERSION } from "./generator-package/constants.js";
+import { parseParameterIssues } from "./parameters.js";
+const EXPORT_NAMES = ["build", "formatVersion", "generatorId", "prepare", "version"];
+function ownData(value, key) {
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    if (descriptor === undefined || !("value" in descriptor)) {
+        throw new TypeError(`Generator ${key} must be an own data field.`);
+    }
+    return descriptor.value;
+}
+function assertSynchronousResult(value, method) {
+    if ((typeof value === "object" && value !== null) || typeof value === "function") {
+        // Inspect descriptors rather than calling a then getter on executable output.
+        let prototype = value;
+        let depth = 0;
+        let inspectThen = true;
+        while (prototype !== null) {
+            if (++depth > 64)
+                throw new TypeError(`Generator ${method} output prototype depth exceeds limits.`);
+            const descriptor = inspectThen
+                ? Object.getOwnPropertyDescriptor(prototype, "then")
+                : undefined;
+            if (prototype === Promise.prototype ||
+                (descriptor !== undefined &&
+                    (!("value" in descriptor) || typeof descriptor.value === "function"))) {
+                try {
+                    // Observe intrinsic Promise rejections without calling executable then methods.
+                    void Promise.prototype.then.call(value, undefined, () => undefined);
+                }
+                catch {
+                    // Arbitrary thenables and Promise species failures retain the synchronous misuse error.
+                }
+                throw new TypeError(`Generator ${method}() must return synchronously.`);
+            }
+            if (descriptor !== undefined)
+                inspectThen = false;
+            prototype = Object.getPrototypeOf(prototype);
+        }
+    }
+}
+/** Inspects only the result envelope and issues. The prepared value remains opaque. */
+export function parsePreparation(definition, result) {
+    assertSynchronousResult(result, "prepare");
+    if (typeof result !== "object" || result === null || Array.isArray(result)) {
+        throw new TypeError("Generator prepare() must return a result object synchronously.");
+    }
+    const ok = ownData(result, "ok");
+    if (typeof ok !== "boolean")
+        throw new TypeError("Generator preparation ok must be boolean.");
+    const expected = ok ? ["ok", "value", "issues"] : ["ok", "issues"];
+    const keys = Reflect.ownKeys(result);
+    if (keys.length !== expected.length ||
+        keys.some((key) => typeof key !== "string" || !expected.includes(key))) {
+        throw new TypeError("Generator preparation must contain exactly its result fields.");
+    }
+    const issues = parseParameterIssues(definition, ownData(result, "issues"));
+    const hasError = issues.some(({ severity }) => severity === "error");
+    if (ok === hasError) {
+        throw new TypeError("Generator preparation success must agree with its validation errors.");
+    }
+    if (!ok)
+        return Object.freeze({ ok: false, issues });
+    return Object.freeze({ ok: true, value: ownData(result, "value"), issues });
+}
+export function capturePreparation(definition, result, build) {
+    const parsed = parsePreparation(definition, result);
+    if (!parsed.ok)
+        return parsed;
+    let value = parsed.value;
+    let available = true;
+    return Object.freeze({
+        ok: true,
+        issues: parsed.issues,
+        build(context) {
+            if (!available)
+                throw new TypeError("Prepared Generator build has already been consumed.");
+            available = false;
+            const preparedValue = value;
+            value = undefined;
+            const output = build(preparedValue, context);
+            assertSynchronousResult(output, "build");
+            return output;
+        },
+    });
+}
+/** Captures the exact format-2 surface; unsupported formats fail before callback invocation. */
+export function parseGeneratorModule(value, definition) {
+    try {
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            throw new TypeError("must be an object");
+        }
+        if (ownData(value, "formatVersion") !== GENERATOR_PACKAGE_FORMAT_VERSION) {
+            throw new TypeError(`unsupported formatVersion; expected ${GENERATOR_PACKAGE_FORMAT_VERSION}`);
+        }
+        const names = Reflect.ownKeys(value)
+            .filter((key) => key !== Symbol.toStringTag)
+            .sort((left, right) => String(left).localeCompare(String(right)));
+        if (names.length !== EXPORT_NAMES.length ||
+            names.some((name, index) => name !== EXPORT_NAMES[index])) {
+            throw new TypeError(`must export exactly ${EXPORT_NAMES.join(", ")}`);
+        }
+        const generatorId = ownData(value, "generatorId");
+        const version = ownData(value, "version");
+        const prepare = ownData(value, "prepare");
+        const build = ownData(value, "build");
+        if (generatorId !== definition.id || version !== definition.version) {
+            throw new TypeError("identity must match the manifest definition");
+        }
+        if (typeof prepare !== "function" || typeof build !== "function") {
+            throw new TypeError("prepare and build must be functions");
+        }
+        const typedPrepare = prepare;
+        const typedBuild = build;
+        return Object.freeze({
+            formatVersion: GENERATOR_PACKAGE_FORMAT_VERSION,
+            generatorId: definition.id,
+            version: definition.version,
+            prepare(parameters, services) {
+                return capturePreparation(definition, typedPrepare(parameters, services), typedBuild);
+            },
+        });
+    }
+    catch (cause) {
+        const detail = cause instanceof Error ? cause.message : "exports could not be inspected";
+        throw new TypeError(`Invalid Generator module: ${detail}.`, { cause });
+    }
+}
+export function isGeneratorModule(value, definition) {
+    try {
+        parseGeneratorModule(value, definition);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=parse-generator-module.js.map

package/dist/parse-generator-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-generator-module.js","sourceRoot":"","sources":["../src/parse-generator-module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AAEpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAE9F,SAAS,OAAO,CAAC,KAAa,EAAE,GAAW;IACzC,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC/D,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,SAAS,CAAC,aAAa,GAAG,6BAA6B,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC;AAC1B,CAAC;AAyBD,SAAS,uBAAuB,CAAC,KAAc,EAAE,MAA2B;IAC1E,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QACjF,8EAA8E;QAC9E,IAAI,SAAS,GAAkB,KAAK,CAAC;QACrC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,WAAW,GAAG,IAAI,CAAC;QACvB,OAAO,SAAS,KAAK,IAAI,EAAE,CAAC;YAC1B,IAAI,EAAE,KAAK,GAAG,EAAE;gBACd,MAAM,IAAI,SAAS,CAAC,aAAa,MAAM,yCAAyC,CAAC,CAAC;YACpF,MAAM,UAAU,GAAG,WAAW;gBAC5B,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,MAAM,CAAC;gBACpD,CAAC,CAAC,SAAS,CAAC;YACd,IACE,SAAS,KAAK,OAAO,CAAC,SAAS;gBAC/B,CAAC,UAAU,KAAK,SAAS;oBACvB,CAAC,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,EACvE,CAAC;gBACD,IAAI,CAAC;oBACH,gFAAgF;oBAChF,KAAK,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACtE,CAAC;gBAAC,MAAM,CAAC;oBACP,wFAAwF;gBAC1F,CAAC;gBACD,MAAM,IAAI,SAAS,CAAC,aAAa,MAAM,+BAA+B,CAAC,CAAC;YAC1E,CAAC;YACD,IAAI,UAAU,KAAK,SAAS;gBAAE,WAAW,GAAG,KAAK,CAAC;YAClD,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,SAAS,CAAkB,CAAC;QAChE,CAAC;IACH,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,gBAAgB,CAC9B,UAAa,EACb,MAAe;IAEf,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,SAAS,CAAC,gEAAgE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,IAAI,OAAO,EAAE,KAAK,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;IAC9F,MAAM,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,IACE,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;QAC/B,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EACtE,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,MAAM,GAAG,oBAAoB,CACjC,UAAU,EACV,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CACM,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACrE,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;QACpB,MAAM,IAAI,SAAS,CAAC,sEAAsE,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,UAAa,EACb,MAAe,EACf,KAAgD;IAIhD,MAAM,MAAM,GAAG,gBAAgB,CAAO,UAAU,EAAE,MAAM,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,KAAK,GAAkB,MAAM,CAAC,KAAK,CAAC;IACxC,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,CAAC,OAAgB;YACpB,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;YAC3F,SAAS,GAAG,KAAK,CAAC;YAClB,MAAM,aAAa,GAAG,KAAU,CAAC;YACjC,KAAK,GAAG,SAAS,CAAC;YAClB,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAC7C,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACzC,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,oBAAoB,CAIlC,KAAc,EAAE,UAAa;IAC7B,IAAI,CAAC;QACH,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,gCAAgC,EAAE,CAAC;YACzE,MAAM,IAAI,SAAS,CACjB,uCAAuC,gCAAgC,EAAE,CAC1E,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;aACjC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CAAC,WAAW,CAAC;aAC3C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpE,IACE,KAAK,CAAC,MAAM,KAAK,YAAY,CAAC,MAAM;YACpC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,YAAY,CAAC,KAAK,CAAC,CAAC,EACzD,CAAC;YACD,MAAM,IAAI,SAAS,CAAC,uBAAuB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,WAAW,KAAK,UAAU,CAAC,EAAE,IAAI,OAAO,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;YACpE,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,OAAO,OAAO,KAAK,UAAU,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YACjE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,YAAY,GAAG,OAAwC,CAAC;QAC9D,MAAM,UAAU,GAAG,KAAsD,CAAC;QAC1E,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,aAAa,EAAE,gCAAgC;YAC/C,WAAW,EAAE,UAAU,CAAC,EAAE;YAC1B,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,OAAO,CAAC,UAA8B,EAAE,QAA2B;gBACjE,OAAO,kBAAkB,CAAC,UAAU,EAAE,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;YACxF,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gCAAgC,CAAC;QACzF,MAAM,IAAI,SAAS,CAAC,6BAA6B,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAc,EACd,UAAa;IAEb,IAAI,CAAC;QACH,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,10 @@
+export { parseGeneratorModule, isGeneratorModule, parsePreparation, } from "./parse-generator-module.js";
+export type { ParsedGeneratorModule, PreparedBuild } from "./parse-generator-module.js";
+export { prepareGenerator, executeGenerator } from "./execute-generator.js";
+export type { PrepareGeneratorOptions, ExecuteGeneratorOptions, GeneratorExecutionResult, GeneratorExecutionInvalid, GeneratorExecutionBuilt, GeneratorExecutionPrepared, GeneratorPreparationResult, } from "./execute-generator.js";
+export { parseGeneratedParts } from "./generated-parts.js";
+export type { GeneratedPartsLimits } from "./generated-parts.js";
+export type { GeneratedPart, GeneratedModel, ModelBounds, ModelStats, ModelTimings, MeshTopologyMode, } from "./contracts.js";
+export type * from "./worker-contracts.js";
+export { parseGenerationSentAt } from "./worker-contracts.js";
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,YAAY,EACV,aAAa,EACb,cAAc,EACd,WAAW,EACX,UAAU,EACV,YAAY,EACZ,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,mBAAmB,uBAAuB,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,5 @@
+export { parseGeneratorModule, isGeneratorModule, parsePreparation, } from "./parse-generator-module.js";
+export { prepareGenerator, executeGenerator } from "./execute-generator.js";
+export { parseGeneratedParts } from "./generated-parts.js";
+export { parseGenerationSentAt } from "./worker-contracts.js";
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAU5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAW3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/worker-contracts.d.ts

@@ -0,0 +1,80 @@
+import type { GeneratedModel, MeshTopologyMode, ParameterValidationResult, ParameterValues } from "./contracts.js";
+import type { GeneratorRuntimeReference } from "./generator-packages.js";
+export interface GenerateRequest {
+    readonly type: "generate";
+    readonly requestId: number;
+    readonly generatorId: string;
+    readonly meshTopologyMode: MeshTopologyMode;
+    readonly runtime: GeneratorRuntimeReference;
+    readonly parameters: ParameterValues;
+}
+export interface ValidateRequest {
+    readonly type: "validate";
+    readonly requestId: number;
+    readonly generatorId: string;
+    readonly runtime: GeneratorRuntimeReference;
+    readonly parameters: ParameterValues;
+}
+export interface Export3mfRequest {
+    /** Project appearance overrides keyed by semantic part ID; does not affect generation. */
+    readonly partColors?: Readonly<Record<string, string>>;
+    readonly type: "export-3mf";
+    readonly requestId: number;
+    readonly filename: string;
+    /** Captured finalized geometry. Export never evaluates generator code. */
+    readonly model: GeneratedModel;
+    readonly name: string;
+}
+export interface ValidationSuccess {
+    readonly type: "validation-success";
+    readonly requestId: number;
+    readonly validation: ParameterValidationResult;
+}
+export interface GenerationSuccess {
+    readonly type: "generation-success";
+    readonly requestId: number;
+    readonly model: GeneratedModel;
+    /** High-resolution epoch milliseconds captured immediately before posting the completed model. */
+    readonly sentAt: number;
+}
+/** Reads an own data timestamp without invoking accessors or accepting malformed transport data. */
+export declare function parseGenerationSentAt(response: unknown): number;
+export interface GenerationInvalid {
+    readonly type: "generation-invalid";
+    readonly requestId: number;
+    readonly validation: ParameterValidationResult;
+}
+export interface ExportedFile {
+    readonly bytes: ArrayBuffer;
+    readonly filename: string;
+    readonly mimeType: "model/3mf";
+}
+export interface ExportSuccess {
+    readonly type: "export-success";
+    readonly requestId: number;
+    readonly file: ExportedFile;
+}
+export interface RuntimeError {
+    readonly code: string;
+    readonly message: string;
+    readonly stack?: string;
+    readonly recoverable?: boolean;
+}
+export interface GenerationError {
+    readonly type: "generation-error";
+    readonly requestId: number;
+    readonly error: RuntimeError;
+}
+export interface ExportError {
+    readonly type: "export-error";
+    readonly requestId: number;
+    readonly error: RuntimeError;
+}
+export interface ValidationError {
+    readonly type: "validation-error";
+    readonly requestId: number;
+    readonly error: RuntimeError;
+}
+export type WorkerRequest = ValidateRequest | GenerateRequest | Export3mfRequest;
+export type WorkerResponse = ValidationSuccess | GenerationSuccess | GenerationInvalid | ExportSuccess | ValidationError | GenerationError | ExportError;
+//# sourceMappingURL=worker-contracts.d.ts.map

package/dist/worker-contracts.d.ts.map

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

package/dist/worker-contracts.js

@@ -0,0 +1,12 @@
+/** Reads an own data timestamp without invoking accessors or accepting malformed transport data. */
+export function parseGenerationSentAt(response) {
+    const descriptor = typeof response === "object" && response !== null && !Array.isArray(response)
+        ? Object.getOwnPropertyDescriptor(response, "sentAt")
+        : undefined;
+    const value = descriptor !== undefined && "value" in descriptor ? descriptor.value : undefined;
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        throw new Error("Generation success requires a finite positive sentAt timestamp.");
+    }
+    return value;
+}
+//# sourceMappingURL=worker-contracts.js.map

package/dist/worker-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-contracts.js","sourceRoot":"","sources":["../src/worker-contracts.ts"],"names":[],"mappings":"AAkDA,oGAAoG;AACpG,MAAM,UAAU,qBAAqB,CAAC,QAAiB;IACrD,MAAM,UAAU,GACd,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC3E,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACrD,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,KAAK,GACT,UAAU,KAAK,SAAS,IAAI,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamesh/generator-sdk",
-  "version": "0.5.2",
+  "version": "0.7.0",
   "description": "Portable contracts and helpers for MetaMesh Generators.",
   "license": "Apache-2.0",
   "repository": {
@@ -23,6 +23,18 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./parameters": {
+      "types": "./dist/parameters.d.ts",
+      "import": "./dist/parameters.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js"
+    },
+    "./packages": {
+      "types": "./dist/generator-packages.d.ts",
+      "import": "./dist/generator-packages.js"
+    },
     "./fonts": {
       "types": "./dist/fonts.d.ts",
       "import": "./dist/fonts.js"
@@ -38,6 +50,7 @@
   "devDependencies": {
     "@metamesh/config": "0.0.0",
     "@vitest/coverage-v8": "^5.0.3",
+    "esbuild": "^0.28.2",
     "fast-check": "4.10.2",
     "vitest": "^5.0.3"
   },

package/dist/prepared-generator-module.d.ts

@@ -1,24 +0,0 @@
-import type { GeneratedPart, GeneratorDefinition, GeneratorIssue, GeneratorParams } from "./contracts.js";
-import { type GeneratorModule } from "./generator-module.js";
-import type { GeneratorServices } from "./generator-services.js";
-/** Successful preparation contains plain, immutable measurements and geometry data. */
-export type GeneratorPreparation<D extends GeneratorDefinition, Prepared> = {
-    readonly ok: true;
-    readonly value: Readonly<Prepared>;
-    readonly issues: readonly GeneratorIssue<D>[];
-} | {
-    readonly ok: false;
-    readonly issues: readonly GeneratorIssue<D>[];
-};
-export interface PreparedGeneratorModuleOptions<D extends GeneratorDefinition, Context, Prepared> {
-    readonly definition: D;
-    readonly prepare: (parameters: GeneratorParams<D>, services: GeneratorServices) => GeneratorPreparation<D, Prepared>;
-    readonly generate: (parameters: GeneratorParams<D>, context: Context, services: GeneratorServices, prepared: Readonly<Prepared>) => readonly GeneratedPart[];
-}
-/**
- * Shares successful preparation between validation and the next generation of the exact frozen
- * parameters and services. The single pending result is consumed before generation, including
- * failed generation; direct calls prepare afresh. Returned modules retain the five format-1 exports.
- */
-export declare function definePreparedGeneratorModule<const D extends GeneratorDefinition, Context, Prepared>({ definition, prepare, generate, }: PreparedGeneratorModuleOptions<D, Context, Prepared>): GeneratorModule<D, Context>;
-//# sourceMappingURL=prepared-generator-module.d.ts.map

package/dist/prepared-generator-module.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prepared-generator-module.d.ts","sourceRoot":"","sources":["../src/prepared-generator-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,eAAe,EAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,uFAAuF;AACvF,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,mBAAmB,EAAE,QAAQ,IACpE;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;CAC/C,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,CAAC;AAE1E,MAAM,WAAW,8BAA8B,CAAC,CAAC,SAAS,mBAAmB,EAAE,OAAO,EAAE,QAAQ;IAC9F,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,CAChB,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,QAAQ,EAAE,iBAAiB,KACxB,oBAAoB,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,CACjB,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,KACzB,SAAS,aAAa,EAAE,CAAC;CAC/B;AAiGD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,CAAC,CAAC,SAAS,mBAAmB,EACnC,OAAO,EACP,QAAQ,EACR,EACA,UAAU,EACV,OAAO,EACP,QAAQ,GACT,EAAE,8BAA8B,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,OAAO,CAAC,CAsCpF"}

package/dist/prepared-generator-module.js

@@ -1,124 +0,0 @@
-import { defineGeneratorModule } from "./generator-module.js";
-import { parseParameterIssues } from "./parameters.js";
-// Bound traversal of author data before retaining it between callbacks. This is not a geometry
-// complexity policy; each generator remains responsible for its own physical sampling limits.
-const MAX_PREPARATION_VALUES = 1_000_000;
-const MAX_PREPARATION_DEPTH = 64;
-function inspectPlainData(value, requireFrozen) {
-    const objects = [];
-    const visited = new Set();
-    const ancestors = new Set();
-    let count = 0;
-    const visit = (entry, depth) => {
-        if (++count > MAX_PREPARATION_VALUES || depth > MAX_PREPARATION_DEPTH) {
-            throw new TypeError("Generator preparation data exceeds the traversal limits.");
-        }
-        if (entry === null ||
-            entry === undefined ||
-            typeof entry === "boolean" ||
-            typeof entry === "string") {
-            return;
-        }
-        if (typeof entry === "number" && Number.isFinite(entry))
-            return;
-        if (typeof entry !== "object") {
-            throw new TypeError("Generator preparation must contain only finite, plain data values.");
-        }
-        if (ancestors.has(entry))
-            throw new TypeError("Generator preparation data must not contain cycles.");
-        if (visited.has(entry))
-            return;
-        const prototype = Object.getPrototypeOf(entry);
-        if ((Array.isArray(entry) && prototype !== Array.prototype) ||
-            (!Array.isArray(entry) && prototype !== Object.prototype && prototype !== null)) {
-            throw new TypeError("Generator preparation must contain only plain objects and arrays.");
-        }
-        if (requireFrozen && !Object.isFrozen(entry)) {
-            throw new TypeError("Generator preparation reuse requires deeply frozen parameters.");
-        }
-        visited.add(entry);
-        ancestors.add(entry);
-        objects.push(entry);
-        for (const key of Reflect.ownKeys(entry)) {
-            const descriptor = Object.getOwnPropertyDescriptor(entry, key);
-            if (typeof key !== "string" || descriptor === undefined || !("value" in descriptor)) {
-                throw new TypeError("Generator preparation data must not contain symbols or accessors.");
-            }
-            visit(descriptor.value, depth + 1);
-        }
-        ancestors.delete(entry);
-    };
-    visit(value, 0);
-    return objects;
-}
-function canReuse(parameters, services) {
-    try {
-        inspectPlainData(parameters, true);
-        const text = Object.getOwnPropertyDescriptor(services, "text");
-        const provider = text?.value;
-        return (Object.isFrozen(services) &&
-            typeof provider === "object" &&
-            provider !== null &&
-            Object.isFrozen(provider) &&
-            typeof Object.getOwnPropertyDescriptor(provider, "layout")?.value === "function");
-    }
-    catch {
-        return false;
-    }
-}
-function checkedPreparation(definition, result) {
-    // Inspect descriptors before reading so accidental getters, promises, and WASM handles never
-    // become retained preparation. Functions live in the callbacks, not in their result data.
-    const objects = inspectPlainData(result, false);
-    const issues = parseParameterIssues(definition, result.issues);
-    const hasErrors = issues.some((issue) => issue.severity === "error");
-    if (typeof result.ok !== "boolean" || result.ok === hasErrors) {
-        throw new TypeError("Generator preparation success must agree with its validation errors.");
-    }
-    const expected = result.ok ? ["ok", "value", "issues"] : ["ok", "issues"];
-    const keys = Object.keys(result);
-    if (keys.length !== expected.length || expected.some((key) => !keys.includes(key))) {
-        throw new TypeError("Generator preparation must return an explicit success or invalid result.");
-    }
-    for (const object of objects)
-        Object.freeze(object);
-    return result.ok
-        ? Object.freeze({ ok: true, value: result.value, issues })
-        : Object.freeze({ ok: false, issues });
-}
-/**
- * Shares successful preparation between validation and the next generation of the exact frozen
- * parameters and services. The single pending result is consumed before generation, including
- * failed generation; direct calls prepare afresh. Returned modules retain the five format-1 exports.
- */
-export function definePreparedGeneratorModule({ definition, prepare, generate, }) {
-    let pending;
-    const runPreparation = (parameters, services) => checkedPreparation(definition, prepare(parameters, services));
-    return defineGeneratorModule({
-        definition,
-        validate(parameters, services) {
-            pending = undefined;
-            const result = runPreparation(parameters, services);
-            if (result.ok && canReuse(parameters, services)) {
-                pending = { parameters, services, value: result.value };
-            }
-            return result.issues;
-        },
-        generate(parameters, context, services) {
-            const previous = pending;
-            pending = undefined;
-            if (previous?.parameters === parameters && previous.services === services) {
-                return generate(parameters, context, services, previous.value);
-            }
-            const result = runPreparation(parameters, services);
-            if (!result.ok) {
-                throw new Error(result.issues
-                    .filter((issue) => issue.severity === "error")
-                    .map((issue) => issue.message)
-                    .join(" "));
-            }
-            return generate(parameters, context, services, result.value);
-        },
-    });
-}
-//# sourceMappingURL=prepared-generator-module.js.map

package/dist/prepared-generator-module.js.map

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