@metaobjectsdev/codegen-ts 0.7.0 → 0.8.0

package/dist/templates/fr010-field-mapping.js

@@ -0,0 +1,170 @@
+// server/typescript/packages/codegen-ts/src/templates/fr010-field-mapping.ts
+//
+// Shared field-kind mapping for the FR-010 codegen emitters (recover-schema-emitter +
+// output-format-spec-emitter). Maps a metadata field subtype onto the render engine's
+// FieldKind member, the idiomatic nullable TS type used by the recover mirror interface,
+// and the RecoverMap accessor that reads it from the forgiving outcome map.
+//
+// Mirrors the C# Fr010FieldMapping (adapted to TS syntax + the `| null` nullable mirror).
+// Bounded scope (parity with Java/Kotlin/C#): scalar / enum / scalar-array. Nested object +
+// array-of-enum are deferred.
+import { TYPE_FIELD, FIELD_SUBTYPE_STRING, FIELD_SUBTYPE_CLASS, FIELD_SUBTYPE_DATE, FIELD_SUBTYPE_TIME, FIELD_SUBTYPE_TIMESTAMP, FIELD_SUBTYPE_INT, FIELD_SUBTYPE_SHORT, FIELD_SUBTYPE_BYTE, FIELD_SUBTYPE_LONG, FIELD_SUBTYPE_CURRENCY, FIELD_SUBTYPE_DOUBLE, FIELD_SUBTYPE_FLOAT, FIELD_SUBTYPE_DECIMAL, FIELD_SUBTYPE_BOOLEAN, FIELD_SUBTYPE_ENUM, FIELD_SUBTYPE_OBJECT, FIELD_ATTR_REQUIRED, FIELD_ATTR_VALUES, } from "@metaobjectsdev/metadata";
+/** The render-engine FieldKind member name for a scalar field subtype, or null if non-scalar. */
+export function scalarKind(subType) {
+    switch (subType) {
+        case FIELD_SUBTYPE_STRING:
+        case FIELD_SUBTYPE_CLASS:
+        case FIELD_SUBTYPE_DATE:
+        case FIELD_SUBTYPE_TIME:
+        case FIELD_SUBTYPE_TIMESTAMP:
+            return "STRING";
+        case FIELD_SUBTYPE_INT:
+        case FIELD_SUBTYPE_SHORT:
+        case FIELD_SUBTYPE_BYTE:
+            return "INT";
+        case FIELD_SUBTYPE_LONG:
+        case FIELD_SUBTYPE_CURRENCY:
+            return "LONG";
+        case FIELD_SUBTYPE_DOUBLE:
+        case FIELD_SUBTYPE_FLOAT:
+        case FIELD_SUBTYPE_DECIMAL:
+            return "DOUBLE";
+        case FIELD_SUBTYPE_BOOLEAN:
+            return "BOOLEAN";
+        default:
+            return null;
+    }
+}
+/** The field children of a payload value-object, in declaration order. */
+export function fields(vo) {
+    return vo.children().filter((c) => c.type === TYPE_FIELD);
+}
+/** isArray is a native (reserved) property on MetaData, not an attr. */
+export function isArray(field) {
+    return field.isArray === true;
+}
+/** True iff the field's @required is explicitly true (or the string "true"). */
+export function isRequired(field) {
+    const v = field.ownAttr(FIELD_ATTR_REQUIRED);
+    if (v === true)
+        return true;
+    return typeof v === "string" && v.toLowerCase() === "true";
+}
+/** The string members of an enum field's @values attr (empty when absent). */
+export function enumValues(field) {
+    const v = field.ownAttr(FIELD_ATTR_VALUES);
+    if (Array.isArray(v))
+        return v.map((e) => String(e));
+    return [];
+}
+/** The nullable TS type for a field in the recover mirror interface. */
+export function mirrorType(field) {
+    // Matches asStringList's `(string | null)[] | null` return — a recovered array
+    // can contain null elements where individual items were lost.
+    if (isArray(field))
+        return "(string | null)[] | null";
+    if (field.subType === FIELD_SUBTYPE_OBJECT)
+        return "unknown"; // nested deferred
+    if (field.subType === FIELD_SUBTYPE_ENUM)
+        return "string | null"; // enum is string-backed
+    switch (scalarKind(field.subType)) {
+        case "INT":
+        case "LONG":
+        case "DOUBLE":
+            return "number | null";
+        case "BOOLEAN":
+            return "boolean | null";
+        default:
+            return "string | null";
+    }
+}
+/**
+ * The RecoverMap.as* helper name that reads this field from the forgiving map, or null
+ * for a nested object (which emits a null literal, not a helper call). Single source of
+ * truth for the per-field dispatch — both recoverMapCall and recoverMapHelpersUsed use it.
+ */
+function recoverMapHelper(field) {
+    if (isArray(field))
+        return "asStringList";
+    if (field.subType === FIELD_SUBTYPE_OBJECT)
+        return null; // null literal, no helper
+    if (field.subType === FIELD_SUBTYPE_ENUM)
+        return "asString";
+    switch (scalarKind(field.subType)) {
+        case "INT":
+            return "asInt";
+        case "LONG":
+            return "asLong";
+        case "DOUBLE":
+            return "asDouble";
+        case "BOOLEAN":
+            return "asBool";
+        default:
+            return "asString";
+    }
+}
+/** The RecoverMap.as* helper name + call that reads this field from the forgiving map `d`. */
+export function recoverMapCall(field) {
+    const helper = recoverMapHelper(field);
+    if (helper === null)
+        return "null /* FR-010: nested recover deferred */";
+    return `${helper}(d, ${jsonStringLiteral(field.name)})`;
+}
+/** Distinct RecoverMap helper names used across a value-object's fields (for the import). */
+export function recoverMapHelpersUsed(vo) {
+    const used = new Set();
+    for (const f of fields(vo)) {
+        const helper = recoverMapHelper(f);
+        if (helper !== null)
+            used.add(helper);
+    }
+    return [...used].sort();
+}
+/** A TS double-quoted string literal for `value`, with the load-bearing chars escaped. */
+export function jsonStringLiteral(value) {
+    let out = '"';
+    for (const ch of value) {
+        switch (ch) {
+            case "\\":
+                out += "\\\\";
+                break;
+            case '"':
+                out += '\\"';
+                break;
+            case "\t":
+                out += "\\t";
+                break;
+            case "\n":
+                out += "\\n";
+                break;
+            case "\r":
+                out += "\\r";
+                break;
+            default:
+                out += ch;
+        }
+    }
+    return out + '"';
+}
+/** A TS array literal `["a", "b"]` for the given members. */
+export function stringArrayLiteral(values) {
+    return "[" + values.map((v) => jsonStringLiteral(v)).join(", ") + "]";
+}
+/**
+ * A TS object literal `{ "k": "v", … }` for a properties-shaped attr (e.g. @enumAlias /
+ * @enumDoc), or "null" when absent/empty. Null values are dropped; keys are sorted
+ * ordinally for deterministic output (matches the canonical-serializer properties sort).
+ */
+export function propertiesMapLiteral(attr) {
+    if (attr == null || typeof attr !== "object" || Array.isArray(attr))
+        return "null";
+    const d = attr;
+    const entries = Object.keys(d)
+        .filter((k) => d[k] != null)
+        .sort()
+        .map((k) => `${jsonStringLiteral(k)}: ${jsonStringLiteral(String(d[k]))}`);
+    if (entries.length === 0)
+        return "null";
+    return "{ " + entries.join(", ") + " }";
+}
+//# sourceMappingURL=fr010-field-mapping.js.map

package/dist/templates/fr010-field-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fr010-field-mapping.js","sourceRoot":"","sources":["../../src/templates/fr010-field-mapping.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,sFAAsF;AACtF,sFAAsF;AACtF,yFAAyF;AACzF,4EAA4E;AAC5E,EAAE;AACF,0FAA0F;AAC1F,4FAA4F;AAC5F,8BAA8B;AAE9B,OAAO,EAEL,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,iGAAiG;AACjG,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,mBAAmB,CAAC;QACzB,KAAK,kBAAkB,CAAC;QACxB,KAAK,kBAAkB,CAAC;QACxB,KAAK,uBAAuB;YAC1B,OAAO,QAAQ,CAAC;QAClB,KAAK,iBAAiB,CAAC;QACvB,KAAK,mBAAmB,CAAC;QACzB,KAAK,kBAAkB;YACrB,OAAO,KAAK,CAAC;QACf,KAAK,kBAAkB,CAAC;QACxB,KAAK,sBAAsB;YACzB,OAAO,MAAM,CAAC;QAChB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,mBAAmB,CAAC;QACzB,KAAK,qBAAqB;YACxB,OAAO,QAAQ,CAAC;QAClB,KAAK,qBAAqB;YACxB,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,MAAM,CAAC,EAAY;IACjC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;AAC5D,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,OAAO,CAAC,KAAe;IACrC,OAAO,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC;AAChC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;AAC7D,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,+EAA+E;IAC/E,8DAA8D;IAC9D,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,0BAA0B,CAAC;IACtD,IAAI,KAAK,CAAC,OAAO,KAAK,oBAAoB;QAAE,OAAO,SAAS,CAAC,CAAC,kBAAkB;IAChF,IAAI,KAAK,CAAC,OAAO,KAAK,kBAAkB;QAAE,OAAO,eAAe,CAAC,CAAC,wBAAwB;IAC1F,QAAQ,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,eAAe,CAAC;QACzB,KAAK,SAAS;YACZ,OAAO,gBAAgB,CAAC;QAC1B;YACE,OAAO,eAAe,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,KAAe;IACvC,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IAC1C,IAAI,KAAK,CAAC,OAAO,KAAK,oBAAoB;QAAE,OAAO,IAAI,CAAC,CAAC,0BAA0B;IACnF,IAAI,KAAK,CAAC,OAAO,KAAK,kBAAkB;QAAE,OAAO,UAAU,CAAC;IAC5D,QAAQ,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,KAAK,KAAK;YACR,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,UAAU,CAAC;IACtB,CAAC;AACH,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,KAAe;IAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,4CAA4C,CAAC;IACzE,OAAO,GAAG,MAAM,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;AAC1D,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,qBAAqB,CAAC,EAAY;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,QAAQ,EAAE,EAAE,CAAC;YACX,KAAK,IAAI;gBACP,GAAG,IAAI,MAAM,CAAC;gBACd,MAAM;YACR,KAAK,GAAG;gBACN,GAAG,IAAI,KAAK,CAAC;gBACb,MAAM;YACR,KAAK,IAAI;gBACP,GAAG,IAAI,KAAK,CAAC;gBACb,MAAM;YACR,KAAK,IAAI;gBACP,GAAG,IAAI,KAAK,CAAC;gBACb,MAAM;YACR,KAAK,IAAI;gBACP,GAAG,IAAI,KAAK,CAAC;gBACb,MAAM;YACR;gBACE,GAAG,IAAI,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,CAAC;AACnB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,MAAyB;IAC1D,OAAO,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACnF,MAAM,CAAC,GAAG,IAA+B,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;SAC3B,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,KAAK,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC1C,CAAC"}

package/dist/templates/output-format-spec-emitter.d.ts

@@ -0,0 +1,4 @@
+import { type MetaData } from "@metaobjectsdev/metadata";
+/** Emit `{ format, rootName, style, fields: [ … ] } satisfies OutputFormatSpec`. */
+export declare function specLiteral(vo: MetaData, template: MetaData, rootName: string): string;
+//# sourceMappingURL=output-format-spec-emitter.d.ts.map

package/dist/templates/output-format-spec-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format-spec-emitter.d.ts","sourceRoot":"","sources":["../../src/templates/output-format-spec-emitter.ts"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,QAAQ,EAUd,MAAM,0BAA0B,CAAC;AAYlC,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQtF"}

package/dist/templates/output-format-spec-emitter.js

@@ -0,0 +1,60 @@
+// server/typescript/packages/codegen-ts/src/templates/output-format-spec-emitter.ts
+//
+// Turns a payload value-object + its template.output node into a TS source literal for an
+// OutputFormatSpec — the artifact-1 prompt descriptor used by the FR-010 output-prompt codegen.
+//
+// Emits an `{ format, rootName, style, fields: [ … ] } satisfies OutputFormatSpec` literal.
+// Mirrors the C# OutputFormatSpecEmitter (adapted to TS syntax). Field-kind mapping is shared
+// via fr010-field-mapping. Bounded scope: scalar / enum. Nested object → FieldKind.OBJECT placeholder.
+import { FIELD_SUBTYPE_ENUM, FIELD_SUBTYPE_OBJECT, FIELD_ATTR_EXAMPLE, FIELD_ATTR_INSTRUCTION, FIELD_ATTR_ENUM_DOC, TEMPLATE_ATTR_FORMAT, TEMPLATE_ATTR_PROMPT_STYLE, PROMPT_STYLE_INLINE, PROMPT_STYLE_EXAMPLE_ONLY, } from "@metaobjectsdev/metadata";
+import { fields, isRequired, isArray, scalarKind, enumValues, jsonStringLiteral, stringArrayLiteral, propertiesMapLiteral, } from "./fr010-field-mapping.js";
+/** Emit `{ format, rootName, style, fields: [ … ] } satisfies OutputFormatSpec`. */
+export function specLiteral(vo, template, rootName) {
+    const formatEnum = resolveFormat(template);
+    const styleEnum = resolvePromptStyle(template);
+    const fieldLits = fields(vo).map(promptFieldLiteral);
+    return (`{ format: ${formatEnum}, rootName: ${jsonStringLiteral(rootName)}, ` +
+        `style: ${styleEnum}, fields: [${fieldLits.join(", ")}] } satisfies OutputFormatSpec`);
+}
+function resolveFormat(template) {
+    const f = template.ownAttr(TEMPLATE_ATTR_FORMAT);
+    return typeof f === "string" && f.toLowerCase() === "xml" ? "Format.XML" : "Format.JSON";
+}
+function resolvePromptStyle(template) {
+    switch (template.ownAttr(TEMPLATE_ATTR_PROMPT_STYLE)) {
+        case PROMPT_STYLE_INLINE:
+            return "PromptStyle.INLINE";
+        case PROMPT_STYLE_EXAMPLE_ONLY:
+            return "PromptStyle.EXAMPLE_ONLY";
+        default:
+            return "PromptStyle.GUIDE";
+    }
+}
+/** A PromptField object literal. Field order matches the PromptField interface. */
+function promptFieldLiteral(field) {
+    const name = jsonStringLiteral(field.name);
+    const required = isRequired(field);
+    const array = isArray(field);
+    if (field.subType === FIELD_SUBTYPE_OBJECT) {
+        return (`{ name: ${name}, kind: FieldKind.OBJECT, required: ${required}, array: ${array}, ` +
+            `enumValues: null, enumDoc: null, example: null, instruction: null, nested: null }` +
+            ` /* FR-010: nested prompt deferred */`);
+    }
+    const example = optStringAttr(field, FIELD_ATTR_EXAMPLE);
+    const instruction = optStringAttr(field, FIELD_ATTR_INSTRUCTION);
+    if (field.subType === FIELD_SUBTYPE_ENUM) {
+        const valuesLit = stringArrayLiteral(enumValues(field));
+        const enumDocLit = propertiesMapLiteral(field.ownAttr(FIELD_ATTR_ENUM_DOC));
+        return (`{ name: ${name}, kind: FieldKind.ENUM, required: ${required}, array: ${array}, ` +
+            `enumValues: ${valuesLit}, enumDoc: ${enumDocLit}, example: ${example}, ` +
+            `instruction: ${instruction}, nested: null }`);
+    }
+    const kind = scalarKind(field.subType) ?? "STRING";
+    return (`{ name: ${name}, kind: FieldKind.${kind}, required: ${required}, array: ${array}, ` +
+        `enumValues: null, enumDoc: null, example: ${example}, instruction: ${instruction}, nested: null }`);
+}
+function optStringAttr(field, attrName) {
+    const v = field.ownAttr(attrName);
+    return typeof v === "string" ? jsonStringLiteral(v) : "null";
+}
+//# sourceMappingURL=output-format-spec-emitter.js.map

package/dist/templates/output-format-spec-emitter.js.map

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

package/dist/templates/output-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output-parser.d.ts","sourceRoot":"","sources":["../../src/templates/output-parser.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,QAAQ,EAQd,MAAM,0BAA0B,CAAC;AAyDlC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CA6D/E"}
+{"version":3,"file":"output-parser.d.ts","sourceRoot":"","sources":["../../src/templates/output-parser.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,QAAQ,EASd,MAAM,0BAA0B,CAAC;AA+DlC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAiI/E"}

package/dist/templates/output-parser.js

@@ -7,7 +7,9 @@
 // `<TemplateName>Data`. Consumers wiring `promptRender()` get a structurally
 // identical payload-VO interface in `prompts.ts`; either type can be used
 // interchangeably with parse results.
-import { TYPE_OBJECT, TYPE_FIELD, TYPE_TEMPLATE, TEMPLATE_SUBTYPE_OUTPUT, FIELD_SUBTYPE_OBJECT, FIELD_ATTR_OBJECT_REF, TEMPLATE_ATTR_PAYLOAD_REF, } from "@metaobjectsdev/metadata";
+import { TYPE_OBJECT, TYPE_FIELD, TYPE_TEMPLATE, TEMPLATE_SUBTYPE_OUTPUT, FIELD_SUBTYPE_OBJECT, FIELD_ATTR_OBJECT_REF, TEMPLATE_ATTR_PAYLOAD_REF, TEMPLATE_ATTR_FORMAT, } from "@metaobjectsdev/metadata";
+import { schemaLiteral, mirrorInterface, mirrorInitializer, } from "./recover-schema-emitter.js";
+import { recoverMapHelpersUsed } from "./fr010-field-mapping.js";
 const SCALAR_ZOD = {
     string: "z.string()",
     class: "z.string()",
@@ -88,9 +90,13 @@ export function renderOutputParser(root, templateName) {
     const errorName = `${templateName}ValidationError`;
     const parseName = `parse${templateName}`;
     const safeParseName = `safeParse${templateName}`;
-    return `import { z } from "zod";
-
-const ${schemaName} = ${schema};
+    // FR-010: emit the tolerant recover() API alongside the strict Zod parser when the
+    // template targets json/xml. The @payloadRef already resolved to a value-object above,
+    // so a RecoverSchema can always be baked. text-format outputs get no recover.
+    const format = tmpl.ownAttr(TEMPLATE_ATTR_FORMAT) ?? "text";
+    const lc = format.toLowerCase();
+    const emitRecover = lc === "json" || lc === "xml";
+    const strictBody = `const ${schemaName} = ${schema};
 
 export type ${dataName} = z.infer<typeof ${schemaName}>;
 export type ${errorName} = z.ZodError;
@@ -125,5 +131,64 @@ export function ${safeParseName}(
     : { success: false, error: result.error };
 }
 `;
+    if (!emitRecover) {
+        return `import { z } from "zod";\n\n${strictBody}`;
+    }
+    // ---- FR-010 tolerant recover block (json/xml only) ----
+    const recoveredName = `${templateName}Recovered`;
+    const recoverFnName = `recover${templateName}`;
+    const tryRecoverName = `tryRecover${templateName}`;
+    const schemaConstName = `${templateName}RecoverSchema`;
+    const schemaLit = schemaLiteral(vo, format, payloadRef);
+    const mirrorDecl = mirrorInterface(vo, recoveredName);
+    const initializer = mirrorInitializer(vo);
+    const mapHelpers = recoverMapHelpersUsed(vo);
+    // Render-package imports the recover block needs. Only pull in the names the emitted
+    // source actually references, so the file has no unused imports (tsc noUnusedLocals-safe).
+    const renderImports = ["recover", "recoverSchema", "Format"];
+    if (schemaLit.includes("scalar("))
+        renderImports.push("scalar");
+    if (schemaLit.includes("enumField("))
+        renderImports.push("enumField");
+    if (schemaLit.includes("FieldKind."))
+        renderImports.push("FieldKind");
+    renderImports.push("type RecoverSchema", "type RecoverOptions", "type RecoveryResult");
+    renderImports.push(...mapHelpers);
+    const recoverBody = `/** Baked recover descriptor for the ${templateName} output. */
+const ${schemaConstName}: RecoverSchema = ${schemaLit};
+
+${mirrorDecl}
+
+/**
+ * Tolerant best-effort recovery of a dirty LLM response; never throws. Returns a
+ * nullable mirror (\`${recoveredName}\`) with fields null where lost/malformed,
+ * plus the per-field recovery report.
+ */
+export function ${recoverFnName}(
+  text: string,
+  opts?: RecoverOptions,
+): RecoveryResult<${recoveredName}> {
+  const outcome = recover(text, ${schemaConstName}, opts);
+  const d = outcome.data;
+  const data: ${recoveredName} = ${initializer};
+  return { data, report: outcome.report };
+}
+
+/**
+ * Recovery as a bool gate: \`true\` when the response was non-empty and no required
+ * field was lost. On success, \`result\` carries the recovered mirror + report.
+ */
+export function ${tryRecoverName}(
+  text: string,
+): { ok: boolean; result: RecoveryResult<${recoveredName}> } {
+  const result = ${recoverFnName}(text);
+  const ok = !result.report.isEmpty() && !result.report.hasLostRequired();
+  return { ok, result };
+}
+`;
+    return (`import { z } from "zod";\n` +
+        `import {\n  ${renderImports.join(",\n  ")},\n} from "@metaobjectsdev/render";\n\n` +
+        `${strictBody}\n` +
+        `${recoverBody}`);
 }
 //# sourceMappingURL=output-parser.js.map

package/dist/templates/output-parser.js.map

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

package/dist/templates/output-prompt.d.ts

@@ -0,0 +1,10 @@
+import { type MetaData } from "@metaobjectsdev/metadata";
+/** True iff the template.output's @format is json or xml (the renderable structured formats). */
+export declare function templateSupportsPrompt(tmpl: MetaData): boolean;
+/**
+ * Render the full output-prompt file for one json/xml `template.output` node.
+ * Throws if the template isn't found, isn't a template.output, isn't json/xml,
+ * or its @payloadRef doesn't resolve to an object.value.
+ */
+export declare function renderOutputPrompt(root: MetaData, templateName: string): string;
+//# sourceMappingURL=output-prompt.d.ts.map

package/dist/templates/output-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-prompt.d.ts","sourceRoot":"","sources":["../../src/templates/output-prompt.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,QAAQ,EAMd,MAAM,0BAA0B,CAAC;AAWlC,iGAAiG;AACjG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAG9D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CA8C/E"}

package/dist/templates/output-prompt.js

@@ -0,0 +1,75 @@
+// server/typescript/packages/codegen-ts/src/templates/output-prompt.ts
+//
+// Per-template renderer for the FR-010 artifact-1 output-format prompt fragment
+// ("produce your answer like this"). For each json/xml `template.output` whose
+// @payloadRef resolves to a value-object, emits a `<TemplateName>.prompt.ts` file
+// exporting `render<TemplateName>Format(overrides?)` backed by the render engine's
+// renderOutputFormat(). The baked OutputFormatSpec's rootName is the payload name,
+// so the prompt fragment and the recover() codegen agree on the root name.
+//
+// Mirrors the C# OutputPromptGenerator + OutputFormatSpecEmitter (split into a
+// generator factory + this pure renderer, matching the TS output-parser shape).
+import { TYPE_OBJECT, TYPE_TEMPLATE, TEMPLATE_SUBTYPE_OUTPUT, TEMPLATE_ATTR_PAYLOAD_REF, TEMPLATE_ATTR_FORMAT, } from "@metaobjectsdev/metadata";
+import { specLiteral } from "./output-format-spec-emitter.js";
+function findObject(root, name) {
+    return root.ownChildren().find((c) => c.type === TYPE_OBJECT && c.name === name);
+}
+function findTemplate(root, name) {
+    return root.ownChildren().find((c) => c.type === TYPE_TEMPLATE && c.name === name);
+}
+/** True iff the template.output's @format is json or xml (the renderable structured formats). */
+export function templateSupportsPrompt(tmpl) {
+    const f = (tmpl.ownAttr(TEMPLATE_ATTR_FORMAT) ?? "text").toLowerCase();
+    return f === "json" || f === "xml";
+}
+/**
+ * Render the full output-prompt file for one json/xml `template.output` node.
+ * Throws if the template isn't found, isn't a template.output, isn't json/xml,
+ * or its @payloadRef doesn't resolve to an object.value.
+ */
+export function renderOutputPrompt(root, templateName) {
+    const tmpl = findTemplate(root, templateName);
+    if (!tmpl) {
+        throw new Error(`template "${templateName}" not found in metadata root`);
+    }
+    if (tmpl.subType !== TEMPLATE_SUBTYPE_OUTPUT) {
+        throw new Error(`template "${templateName}" is not a template.output (got subtype "${tmpl.subType}")`);
+    }
+    if (!templateSupportsPrompt(tmpl)) {
+        throw new Error(`template "${templateName}" @format is not json/xml — no prompt fragment`);
+    }
+    const payloadRef = tmpl.ownAttr(TEMPLATE_ATTR_PAYLOAD_REF);
+    if (typeof payloadRef !== "string") {
+        throw new Error(`template "${templateName}" missing @payloadRef`);
+    }
+    const vo = findObject(root, payloadRef);
+    if (!vo) {
+        throw new Error(`template "${templateName}" @payloadRef "${payloadRef}" not found in metadata root`);
+    }
+    // rootName == payload name so the prompt fragment and recover() agree.
+    const spec = specLiteral(vo, tmpl, payloadRef);
+    const specName = `${templateName}FormatSpec`;
+    const fnName = `render${templateName}Format`;
+    return `import {
+  renderOutputFormat,
+  Format,
+  FieldKind,
+  PromptStyle,
+  type OutputFormatSpec,
+  type PromptOverrides,
+} from "@metaobjectsdev/render";
+
+const ${specName}: OutputFormatSpec = ${spec};
+
+/**
+ * The output-format instruction fragment for the ${templateName} template.output
+ * ("produce your answer like this"). Comment-free — guidance lives in prose /
+ * inline placeholders / a filled skeleton. Pass \`overrides\` to override the style
+ * or per-field example/instruction at render time.
+ */
+export function ${fnName}(overrides?: PromptOverrides): string {
+  return renderOutputFormat(${specName}, overrides ?? {});
+}
+`;
+}
+//# sourceMappingURL=output-prompt.js.map

package/dist/templates/output-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-prompt.js","sourceRoot":"","sources":["../../src/templates/output-prompt.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,kFAAkF;AAClF,mFAAmF;AACnF,mFAAmF;AACnF,2EAA2E;AAC3E,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAEhF,OAAO,EAEL,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,SAAS,UAAU,CAAC,IAAc,EAAE,IAAY;IAC9C,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,YAAY,CAAC,IAAc,EAAE,IAAY;IAChD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACrF,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,sBAAsB,CAAC,IAAc;IACnD,MAAM,CAAC,GAAG,CAAE,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAwB,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/F,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAc,EAAE,YAAoB;IACrE,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,8BAA8B,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,uBAAuB,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,4CAA4C,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IACzG,CAAC;IACD,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,gDAAgD,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC3D,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,uBAAuB,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,kBAAkB,UAAU,8BAA8B,CAAC,CAAC;IACvG,CAAC;IAED,uEAAuE;IACvE,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,GAAG,YAAY,YAAY,CAAC;IAC7C,MAAM,MAAM,GAAG,SAAS,YAAY,QAAQ,CAAC;IAE7C,OAAO;;;;;;;;;QASD,QAAQ,wBAAwB,IAAI;;;oDAGQ,YAAY;;;;;kBAK9C,MAAM;8BACM,QAAQ;;CAErC,CAAC;AACF,CAAC"}

package/dist/templates/recover-schema-emitter.d.ts

@@ -0,0 +1,8 @@
+import { type MetaData } from "@metaobjectsdev/metadata";
+/** Emit `recoverSchema(Format.X, "rootName", [ … ])`. */
+export declare function schemaLiteral(vo: MetaData, format: string, rootName: string): string;
+/** Emit the all-nullable mirror interface declaration. */
+export declare function mirrorInterface(vo: MetaData, interfaceName: string): string;
+/** Emit `{ prop: asString(d, "prop"), … }` building the mirror from the forgiving map `d`. */
+export declare function mirrorInitializer(vo: MetaData): string;
+//# sourceMappingURL=recover-schema-emitter.d.ts.map

package/dist/templates/recover-schema-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recover-schema-emitter.d.ts","sourceRoot":"","sources":["../../src/templates/recover-schema-emitter.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,KAAK,QAAQ,EAId,MAAM,0BAA0B,CAAC;AAclC,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIpF;AA+BD,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAc3E;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAGtD"}

package/dist/templates/recover-schema-emitter.js

@@ -0,0 +1,64 @@
+// server/typescript/packages/codegen-ts/src/templates/recover-schema-emitter.ts
+//
+// Turns a payload value-object into TS source fragments for the FR-010 recover codegen:
+//   • schemaLiteral     — a `recoverSchema(Format.JSON, "root", [ … ])` baked descriptor
+//                         built from FieldSpec factories (scalar / enumField).
+//   • mirrorInterface   — an all-nullable mirror interface `<Payload>Recovered` (each
+//                         component `T | null`); recover returns this nullable twin rather
+//                         than the strict payload (same reasoning as the Java/C#/Kotlin ports).
+//   • mirrorInitializer — `{ prop: asString(d, "prop"), … }` building the mirror from the
+//                         forgiving outcome map `d`.
+//
+// Mirrors the C# RecoverSchemaEmitter (adapted to TS syntax + the `| null` nullable mirror).
+// Bounded scope: scalar / enum / scalar-array. Nested object + array-of-enum deferred.
+import { FIELD_SUBTYPE_ENUM, FIELD_SUBTYPE_OBJECT, FIELD_ATTR_ENUM_ALIAS, } from "@metaobjectsdev/metadata";
+import { fields, isRequired, isArray, scalarKind, mirrorType, recoverMapCall, enumValues, jsonStringLiteral, stringArrayLiteral, propertiesMapLiteral, } from "./fr010-field-mapping.js";
+/** Emit `recoverSchema(Format.X, "rootName", [ … ])`. */
+export function schemaLiteral(vo, format, rootName) {
+    const formatEnum = format.toLowerCase() === "xml" ? "Format.XML" : "Format.JSON";
+    const specs = fields(vo).map(fieldSpecLiteral);
+    return `recoverSchema(${formatEnum}, ${jsonStringLiteral(rootName)}, [${specs.join(", ")}])`;
+}
+function fieldSpecLiteral(field) {
+    const name = jsonStringLiteral(field.name);
+    const required = isRequired(field);
+    if (field.subType === FIELD_SUBTYPE_ENUM) {
+        const valuesLit = stringArrayLiteral(enumValues(field));
+        const aliasLit = propertiesMapLiteral(field.ownAttr(FIELD_ATTR_ENUM_ALIAS));
+        // enumField() sets array:false; enum-array is a bounded deferral (parity with Java/C#).
+        return `enumField(${name}, ${required}, ${valuesLit}, ${aliasLit})`;
+    }
+    if (field.subType === FIELD_SUBTYPE_OBJECT) {
+        // FR-010: nested recover deferred — treat as an opaque required/optional string slot.
+        return `scalar(${name}, FieldKind.STRING, ${required}) /* FR-010: nested recover deferred */`;
+    }
+    const kind = scalarKind(field.subType) ?? "STRING";
+    // Scalar-array: the scalar() factory only builds singular specs (array:false), so emit a
+    // FieldSpec object literal with array:true. Tier-2 win over the Roslyn proof: the emitted
+    // recover() actually populates the array at runtime (RecoverMap.asStringList).
+    if (isArray(field)) {
+        return (`{ name: ${name}, kind: FieldKind.${kind}, required: ${required}, array: true, ` +
+            `enumValues: null, enumAlias: null, min: null, max: null, nested: null }`);
+    }
+    return `scalar(${name}, FieldKind.${kind}, ${required})`;
+}
+/** Emit the all-nullable mirror interface declaration. */
+export function mirrorInterface(vo, interfaceName) {
+    const base = interfaceName.endsWith("Recovered")
+        ? interfaceName.slice(0, -"Recovered".length)
+        : interfaceName;
+    const lines = [];
+    lines.push(`/** Best-effort recovered twin of \`${base}\` — every field nullable (null where lost/malformed). */`);
+    lines.push(`export interface ${interfaceName} {`);
+    for (const f of fields(vo)) {
+        lines.push(`  ${f.name}: ${mirrorType(f)};`);
+    }
+    lines.push("}");
+    return lines.join("\n");
+}
+/** Emit `{ prop: asString(d, "prop"), … }` building the mirror from the forgiving map `d`. */
+export function mirrorInitializer(vo) {
+    const assigns = fields(vo).map((f) => `${f.name}: ${recoverMapCall(f)}`);
+    return `{ ${assigns.join(", ")} }`;
+}
+//# sourceMappingURL=recover-schema-emitter.js.map

package/dist/templates/recover-schema-emitter.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/codegen-ts",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "TypeScript codegen engine for MetaObjects — emits Drizzle, Zod, and Fastify artifacts.",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,8 +38,8 @@
 "access": "public"
 },
 "dependencies": {
-  "@metaobjectsdev/metadata": "0.7.0",
-  "@metaobjectsdev/render": "0.7.0",
+  "@metaobjectsdev/metadata": "0.8.0",
+  "@metaobjectsdev/render": "0.8.0",
   "@biomejs/js-api": "^0.7.0",
   "@biomejs/wasm-nodejs": "^1.9.4",
   "ts-poet": "^6.10.0"
@@ -50,7 +50,7 @@
 },
 "devDependencies": {
   "@biomejs/biome": "^1.9.0",
-  "@metaobjectsdev/codegen-ts-react": "0.7.0",
+  "@metaobjectsdev/codegen-ts-react": "0.8.0",
   "bun-types": "latest",
   "drizzle-orm": "^0.36.0",
   "hono": "^4.6.0",

package/src/generators/entity-file.ts

@@ -3,6 +3,7 @@ import { perEntity, type Generator, type GeneratorFactory } from "../generator.j
 import { renderEntityFile } from "../templates/entity-file.js";
 import { formatTs } from "../format.js";
 import { entityOutputPath } from "../import-path.js";
+import { isAbstract } from "../instance-artifacts.js";
 
 export interface EntityFileOpts {
   filter?: (entity: MetaObject) => boolean;
@@ -33,6 +34,12 @@ export const entityFile = function entityFile(opts?: EntityFileOpts): Generator
       if (!ctx.renderContext) {
         throw new Error("entity-file: renderContext is required (provided by runGen)");
       }
+      // Abstract entities contribute shape only. When emitAbstractShapes is off
+      // (cross-port knob; default on) the entity-file generator emits nothing for
+      // them. Instance/write generators skip abstract unconditionally elsewhere.
+      if (isAbstract(entity) && !ctx.renderContext.emitAbstractShapes) {
+        return [];
+      }
       return {
         path: entityOutputPath(ctx.config.outputLayout ?? "flat", entity.package, `${entity.name}.ts`),
         content: await formatTs(renderEntityFile(entity, ctx.renderContext, { allowlists })),

package/src/generators/index.ts

@@ -6,6 +6,7 @@ export { barrel, type BarrelOpts } from "./barrel.js";
 export { mermaidErDiagram, type MermaidErOptions } from "./mermaid-er.js";
 export { promptRender, type PromptRenderOpts } from "./prompt-render-file.js";
 export { outputParser, type OutputParserOpts } from "./output-parser-file.js";
+export { outputPrompt, type OutputPromptOpts } from "./output-prompt-file.js";
 export { docsFile, type DocsFileOpts } from "./docs-file.js";
 export {
   templateGenerator,