@metamesh/generator-sdk 0.5.2 → 0.6.0

package/dist/generator-module.js

@@ -1,119 +1,12 @@
 import { GENERATOR_PACKAGE_FORMAT_VERSION } from "./generator-package/constants.js";
-import { createParamCodec } from "./parameters.js";
-const EXPORT_NAMES = ["formatVersion", "generate", "generatorId", "validate", "version"];
-const hasExactExports = (value) => {
-    const names = Object.keys(value).sort();
-    return (names.length === EXPORT_NAMES.length &&
-        names.every((name, index) => name === EXPORT_NAMES[index]));
-};
-function moduleProblem(value, definition) {
-    if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        return "must be an object";
-    }
-    const candidate = value;
-    if (!hasExactExports(candidate)) {
-        const names = Object.keys(candidate).sort();
-        const missing = EXPORT_NAMES.filter((name) => !names.includes(name));
-        const extra = names.filter((name) => !EXPORT_NAMES.some((expected) => expected === name));
-        const display = (values) => values
-            .slice(0, 20)
-            .map((name) => name.slice(0, 100))
-            .join(", ");
-        return `must export exactly ${EXPORT_NAMES.join(", ")}. Missing: ${display(missing) || "none"}. Unexpected: ${display(extra) || "none"}${extra.length > 20 ? ", …" : ""}`;
-    }
-    if (candidate.formatVersion !== GENERATOR_PACKAGE_FORMAT_VERSION) {
-        return `formatVersion must be ${GENERATOR_PACKAGE_FORMAT_VERSION}`;
-    }
-    if (candidate.generatorId !== definition.id) {
-        return `generatorId must be ${JSON.stringify(definition.id)}`;
-    }
-    if (candidate.version !== definition.version) {
-        return `version must be ${JSON.stringify(definition.version)}`;
-    }
-    if (typeof candidate.validate !== "function")
-        return "validate must be a function";
-    if (typeof candidate.generate !== "function")
-        return "generate must be a function";
-    return undefined;
-}
-function requireSynchronousArray(value, operation) {
-    if (!Array.isArray(value)) {
-        throw new TypeError(`Generator ${operation}() must return an array synchronously.`);
-    }
-    return value;
-}
-function assembleCanonicalModule(definition, validate, generate) {
+/** Codec-free authoring helper. Hosts check metadata and callback results. */
+export function defineGeneratorModule({ definition, prepare, build, }) {
     return Object.freeze({
         formatVersion: GENERATOR_PACKAGE_FORMAT_VERSION,
-        generate,
         generatorId: definition.id,
-        validate,
         version: definition.version,
+        prepare,
+        build,
     });
 }
-function checkedCanonicalModule(definition, validate, generate) {
-    return assembleCanonicalModule(definition, (parameters, services) => requireSynchronousArray(validate(parameters, services), "validate"), (parameters, context, services) => requireSynchronousArray(generate(parameters, context, services), "generate"));
-}
-function strictModule(definition, canonical) {
-    const codec = createParamCodec(definition);
-    return Object.freeze({
-        formatVersion: canonical.formatVersion,
-        generate(parameters, context, services) {
-            return canonical.generate(codec.parse(parameters), context, services);
-        },
-        generatorId: canonical.generatorId,
-        validate(parameters, services) {
-            return canonical.validate(codec.parse(parameters), services);
-        },
-        version: canonical.version,
-    });
-}
-/**
- * Creates the complete compiled-module surface from one typed definition.
- *
- * The returned callbacks accept canonical parameters so this authoring helper stays small in
- * self-contained release bundles. Hosts use `parseGeneratorModule()` at untrusted boundaries.
- */
-export function defineGeneratorModule({ definition, generate, validate, }) {
-    return assembleCanonicalModule(definition, validate, generate);
-}
-/** Checks an evaluated ESM namespace against its authoritative manifest definition. */
-export function isGeneratorModule(value, definition) {
-    try {
-        return moduleProblem(value, definition) === undefined;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Parses an evaluated ESM namespace and snapshots both invocation lanes.
- *
- * The canonical lane is for host-prepared `GeneratorParams`; the strict lane is the only lane that
- * accepts boundary `ParameterValues` and decodes them before invoking evaluated code. Function
- * result values remain host-validated because JavaScript cannot prove them without execution.
- */
-export function parseGeneratorModule(value, definition) {
-    let problem;
-    try {
-        problem = moduleProblem(value, definition);
-    }
-    catch {
-        problem = "exports could not be inspected";
-    }
-    if (problem !== undefined)
-        throw new Error(`Invalid Generator module: ${problem}.`);
-    try {
-        const candidate = value;
-        const validate = candidate.validate;
-        const generate = candidate.generate;
-        if (typeof validate !== "function" || typeof generate !== "function")
-            throw new TypeError();
-        const canonical = checkedCanonicalModule(definition, validate, generate);
-        return Object.freeze({ canonical, strict: strictModule(definition, canonical) });
-    }
-    catch {
-        throw new Error("Invalid Generator module: exports could not be read.");
-    }
-}
 //# sourceMappingURL=generator-module.js.map

package/dist/generator-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator-module.js","sourceRoot":"","sources":["../src/generator-module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generator-module.js","sourceRoot":"","sources":["../src/generator-module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AAiCpF,8EAA8E;AAC9E,MAAM,UAAU,qBAAqB,CAA0D,EAC7F,UAAU,EACV,OAAO,EACP,KAAK,GACyC;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,gCAAgC;QAC/C,WAAW,EAAE,UAAU,CAAC,EAAE;QAC1B,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,OAAO;QACP,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/generator-package/constants.d.ts

@@ -1,5 +1,5 @@
-export declare const METAMESH_RUNTIME_VERSION = "1.3.0";
-export declare const GENERATOR_PACKAGE_FORMAT_VERSION = 1;
+export declare const METAMESH_RUNTIME_VERSION = "2.0.0";
+export declare const GENERATOR_PACKAGE_FORMAT_VERSION = 2;
 export declare const MAX_GENERATOR_PACKAGE_BYTES: number;
 /** Portable metadata limits enforced before package content reaches Studio. */
 export declare const MAX_GENERATOR_ID_LENGTH = 120;

package/dist/generator-package/constants.js

@@ -1,5 +1,5 @@
-export const METAMESH_RUNTIME_VERSION = "1.3.0";
-export const GENERATOR_PACKAGE_FORMAT_VERSION = 1;
+export const METAMESH_RUNTIME_VERSION = "2.0.0";
+export const GENERATOR_PACKAGE_FORMAT_VERSION = 2;
 export const MAX_GENERATOR_PACKAGE_BYTES = 5 * 1024 * 1024;
 /** Portable metadata limits enforced before package content reaches Studio. */
 export const MAX_GENERATOR_ID_LENGTH = 120;

package/dist/generator-package/schemas/definition.schema.d.ts

@@ -31,6 +31,7 @@ export declare const generatorDefinitionSchema: z.ZodObject<{
         max: z.ZodOptional<z.ZodNumber>;
         step: z.ZodOptional<z.ZodNumber>;
         default: z.ZodNumber;
+        integer: z.ZodOptional<z.ZodBoolean>;
         role: z.ZodOptional<z.ZodLiteral<"curve-resolution">>;
         id: z.ZodString;
         label: z.ZodString;
@@ -44,6 +45,7 @@ export declare const generatorDefinitionSchema: z.ZodObject<{
         max: z.ZodNumber;
         step: z.ZodNumber;
         default: z.ZodNumber;
+        integer: z.ZodOptional<z.ZodBoolean>;
         role: z.ZodOptional<z.ZodLiteral<"curve-resolution">>;
         id: z.ZodString;
         label: z.ZodString;
@@ -141,6 +143,7 @@ export declare const generatorDefinitionSchema: z.ZodObject<{
         maxItems: z.ZodOptional<z.ZodNumber>;
         items: z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodLiteral<"number">;
+            integer: z.ZodOptional<z.ZodBoolean>;
             min: z.ZodOptional<z.ZodNumber>;
             max: z.ZodOptional<z.ZodNumber>;
             step: z.ZodOptional<z.ZodNumber>;

package/dist/generator-package/schemas/definition.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.schema.d.ts","sourceRoot":"","sources":["../../../src/generator-package/schemas/definition.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,oBAAoB;;;;;kBAK/B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOpC,CAAC;AAEH,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GACpD,SAAS,YAAY,CAAC,IAAI,CAAC,EAAE,GAC7B,CAAC,SAAS,MAAM,GACd;IAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAAE,GACnD,CAAC,CAAC;AAER,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AACjF,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"definition.schema.d.ts","sourceRoot":"","sources":["../../../src/generator-package/schemas/definition.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,oBAAoB;;;;;kBAK/B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOpC,CAAC;AAEH,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GACpD,SAAS,YAAY,CAAC,IAAI,CAAC,EAAE,GAC7B,CAAC,SAAS,MAAM,GACd;IAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAAE,GACnD,CAAC,CAAC;AAER,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AACjF,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC"}