@metaobjectsdev/codegen-ts 0.9.0 → 0.11.0-rc.1

package/templates/api/entity-api.md.mustache

@@ -0,0 +1,69 @@
+{{{generatedMarker}}}
+
+# {{node}} API
+{{#modelPageHref}}
+
+**Model / metadata:** [{{node}}]({{modelPageHref}})
+{{/modelPageHref}}
+
+> Import paths are relative to your generated-output directory.
+{{#hasSetup}}
+
+## Setup
+
+Obtain the runtime handles the calls below need:
+{{#setup}}
+
+- `{{handle}}` — {{{note}}}
+
+```ts
+{{{snippet}}}
+```
+{{/setup}}
+{{/hasSetup}}
+{{#unitExample}}
+
+## Example
+
+```ts
+{{{unitExample}}}
+```
+{{/unitExample}}
+{{#sections}}
+
+## {{heading}}
+{{#symbols}}
+
+### `{{signature}}`
+
+{{usage}}
+
+```ts
+{{importLine}}
+```
+{{#hasFields}}
+
+{{fieldsCaption}}:
+
+| Field | Type | Required | Notes |
+|---|---|---|---|
+{{#fieldRows}}
+| `{{field}}` | `{{{type}}}` | {{required}} | {{notes}} |
+{{/fieldRows}}
+{{/hasFields}}
+{{#mountNote}}
+
+Mount: {{{mountNote}}}
+{{/mountNote}}
+{{#throws}}
+
+Throws: {{throws}}
+{{/throws}}
+{{#example}}
+
+```ts
+{{{example}}}
+```
+{{/example}}
+{{/symbols}}
+{{/sections}}

package/templates/api/index.md.mustache

@@ -0,0 +1,21 @@
+{{{generatedMarker}}}
+
+# {{title}}
+
+{{intro}}
+{{#hasEntities}}
+
+## Entities
+
+{{#entities}}
+- [{{node}}]({{href}}) — {{summary}} ({{symbolCount}} symbol{{^one}}s{{/one}})
+{{/entities}}
+{{/hasEntities}}
+{{#hasTemplates}}
+
+## Templates
+
+{{#templates}}
+- [{{node}}]({{href}}) — {{summary}} ({{symbolCount}} symbol{{^one}}s{{/one}})
+{{/templates}}
+{{/hasTemplates}}

package/templates/docs/entity-page.md.mustache

@@ -1,21 +1,20 @@
 {{{generatedMarker}}}
 
 # {{entity.name}}
+{{#summaryLead}}
+
+{{{.}}}
+{{/summaryLead}}
 {{#descriptionQuote}}
 
 {{{.}}}
 {{/descriptionQuote}}
+{{#apiRefs.0}}
 
-{{{preambleHeader}}}
-{{#hasStorage}}
-
-## Storage
+**API reference:** {{/apiRefs.0}}{{#apiRefs}}[{{label}}]({{href}}){{^last}} · {{/last}}{{/apiRefs}}{{#apiRefs.0}}
+{{/apiRefs.0}}
 
-{{{storage.tableHeader}}}
-{{#storage.rows}}
-{{{rowLine}}}
-{{/storage.rows}}
-{{/hasStorage}}
+{{{preambleHeader}}}
 {{#hasIdentities}}
 
 ## Identity
@@ -24,6 +23,31 @@
 - {{{bullet}}}
 {{/identities}}
 {{/hasIdentities}}
+{{#hasNeighborhoodEr}}
+
+## In context
+
+{{{neighborhoodErBlock}}}
+{{/hasNeighborhoodEr}}
+{{#fields.hasFields}}
+
+## Fields
+
+| Field | Type | Required | Column | Rules |
+|---|---|---|---|---|
+{{#fields.rows}}
+| {{{fieldCell}}} | {{{typeCell}}} | {{requiredCell}} | {{{storageCell}}} | {{{rulesCell}}} |
+{{/fields.rows}}
+{{/fields.hasFields}}
+{{#fieldDetails.hasDetails}}
+
+## Field details
+
+{{#fieldDetails.rows}}
+{{{block}}}
+
+{{/fieldDetails.rows}}
+{{/fieldDetails.hasDetails}}
 {{#hasRelationships}}
 
 ## Relationships
@@ -32,12 +56,6 @@
 - {{{bullet}}}
 {{/relationships}}
 {{/hasRelationships}}
-
-## Validation
-
-- `{{validation.insertSchema}}` (Zod) — for creating new {{validation.lower}}s.
-- `{{validation.updateSchema}}` (Zod) — for partial updates.
-- See `{{validation.entityFile}}` for the exported schemas.
 {{#hasUsedBy}}
 
 ## Used by
@@ -46,9 +64,3 @@
 - {{{bullet}}}
 {{/usedBy}}
 {{/hasUsedBy}}
-
-## Generated code
-
-{{#generated}}
-- `{{filename}}` — {{{description}}}
-{{/generated}}

package/templates/docs/template-page.md.mustache

@@ -0,0 +1,56 @@
+{{{generatedMarker}}}
+
+# {{name}}
+{{#descriptionQuote}}
+
+{{{.}}}
+{{/descriptionQuote}}
+
+**Kind:** {{kind}}
+
+## Output
+{{^isEmail}}
+
+- Format: `{{format}}`
+{{/isEmail}}
+{{#isEmail}}
+
+Multipart email — rendered as the following parts:
+
+| Part | Source | Format | Escaping |
+|---|---|---|---|
+{{#parts}}
+| {{label}} | `{{ref}}` | `{{format}}` | {{#escaped}}escaped{{/escaped}}{{^escaped}}raw{{/escaped}} |
+{{/parts}}
+{{/isEmail}}
+
+## Input
+
+- Payload: [`{{payload.name}}`]({{payload.link}})
+{{#hasRequiredTags}}
+- Required fields:{{#requiredTags}} `{{.}}`{{/requiredTags}}
+{{/hasRequiredTags}}
+
+## Render contract
+
+- Every field referenced by the template is validated against the payload at generation time; an unknown field fails generation.
+{{#maxChars}}
+- Maximum length: {{.}} characters (rendering longer output fails).
+{{/maxChars}}
+{{#hasRequiredTags}}
+- Required tags must be present:{{#requiredTags}} `{{.}}`{{/requiredTags}}
+{{/hasRequiredTags}}
+
+## Source
+
+{{#sourceRefs}}
+- `{{.}}`
+{{/sourceRefs}}
+{{#templateSourceSection}}
+
+{{{.}}}
+{{/templateSourceSection}}
+
+## Capability
+
+{{capability}}

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

@@ -1,8 +0,0 @@
-import { type MetaData } from "@metaobjectsdev/metadata";
-/** Emit `extractSchema(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=extract-schema-emitter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"extract-schema-emitter.d.ts","sourceRoot":"","sources":["../../src/templates/extract-schema-emitter.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,KAAK,QAAQ,EAId,MAAM,0BAA0B,CAAC;AAkBlC,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIpF;AA+CD,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/extract-schema-emitter.js

@@ -1,81 +0,0 @@
-// server/typescript/packages/codegen-ts/src/templates/extract-schema-emitter.ts
-//
-// Turns a payload value-object into TS source fragments for the FR-010 extract codegen:
-//   • schemaLiteral     — a `extractSchema(Format.JSON, "root", [ … ])` baked descriptor
-//                         built from FieldSpec factories (scalar / enumField).
-//   • mirrorInterface   — an all-nullable mirror interface `<Payload>Extracted` (each
-//                         component `T | null`); extract 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# ExtractSchemaEmitter (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, extractMapCall, enumValues, coerceDefault, defaultValue, resolveNormalize, jsonStringLiteral, stringArrayLiteral, propertiesMapLiteral, } from "./fr010-field-mapping.js";
-import { NORMALIZE_DEFAULT } from "@metaobjectsdev/metadata";
-/** Emit `extractSchema(Format.X, "rootName", [ … ])`. */
-export function schemaLiteral(vo, format, rootName) {
-    const formatEnum = format.toLowerCase() === "xml" ? "Format.XML" : "Format.JSON";
-    const specs = fields(vo).map((f) => fieldSpecLiteral(f, vo));
-    return `extractSchema(${formatEnum}, ${jsonStringLiteral(rootName)}, [${specs.join(", ")}])`;
-}
-function fieldSpecLiteral(field, owner) {
-    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));
-        // FR-011: extended enumField signature is (name, required, values, aliases,
-        // coerceDefault?, normalize="strip", defaultValue?). Resolve the three new args
-        // (field → object → "strip" for normalize) and emit only what's needed: keep the
-        // back-compat 4-arg form when nothing is set, else emit the positional tail up to
-        // the last meaningful arg.
-        const cd = coerceDefault(field);
-        const dv = defaultValue(field);
-        const normalize = resolveNormalize(field, owner);
-        // enumField() sets array:false; enum-array is a bounded deferral (parity with Java/C#).
-        if (cd == null && dv == null && normalize === NORMALIZE_DEFAULT) {
-            return `enumField(${name}, ${required}, ${valuesLit}, ${aliasLit})`;
-        }
-        const cdLit = cd == null ? "null" : jsonStringLiteral(cd);
-        const normLit = jsonStringLiteral(normalize);
-        if (dv == null) {
-            return `enumField(${name}, ${required}, ${valuesLit}, ${aliasLit}, ${cdLit}, ${normLit})`;
-        }
-        return `enumField(${name}, ${required}, ${valuesLit}, ${aliasLit}, ${cdLit}, ${normLit}, ${jsonStringLiteral(dv)})`;
-    }
-    if (field.subType === FIELD_SUBTYPE_OBJECT) {
-        // FR-010: nested extract deferred — treat as an opaque required/optional string slot.
-        return `scalar(${name}, FieldKind.STRING, ${required}) /* FR-010: nested extract 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
-    // extract() actually populates the array at runtime (ExtractMap.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("Extracted")
-        ? interfaceName.slice(0, -"Extracted".length)
-        : interfaceName;
-    const lines = [];
-    lines.push(`/** Best-effort extracted 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}: ${extractMapCall(f)}`);
-    return `{ ${assigns.join(", ")} }`;
-}
-//# sourceMappingURL=extract-schema-emitter.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"extract-schema-emitter.js","sourceRoot":"","sources":["../../src/templates/extract-schema-emitter.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,wFAAwF;AACxF,yFAAyF;AACzF,+EAA+E;AAC/E,sFAAsF;AACtF,2FAA2F;AAC3F,gGAAgG;AAChG,0FAA0F;AAC1F,qDAAqD;AACrD,EAAE;AACF,6FAA6F;AAC7F,uFAAuF;AAEvF,OAAO,EAEL,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,MAAM,EACN,UAAU,EACV,OAAO,EACP,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,EAAY,EAAE,MAAc,EAAE,QAAgB;IAC1E,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;IACjF,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7D,OAAO,iBAAiB,UAAU,KAAK,iBAAiB,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAC/F,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAe,EAAE,KAAe;IACxD,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAEnC,IAAI,KAAK,CAAC,OAAO,KAAK,kBAAkB,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,kBAAkB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC5E,4EAA4E;QAC5E,gFAAgF;QAChF,iFAAiF;QACjF,kFAAkF;QAClF,2BAA2B;QAC3B,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACjD,wFAAwF;QACxF,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,SAAS,KAAK,iBAAiB,EAAE,CAAC;YAChE,OAAO,aAAa,IAAI,KAAK,QAAQ,KAAK,SAAS,KAAK,QAAQ,GAAG,CAAC;QACtE,CAAC;QACD,MAAM,KAAK,GAAG,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YACf,OAAO,aAAa,IAAI,KAAK,QAAQ,KAAK,SAAS,KAAK,QAAQ,KAAK,KAAK,KAAK,OAAO,GAAG,CAAC;QAC5F,CAAC;QACD,OAAO,aAAa,IAAI,KAAK,QAAQ,KAAK,SAAS,KAAK,QAAQ,KAAK,KAAK,KAAK,OAAO,KAAK,iBAAiB,CAAC,EAAE,CAAC,GAAG,CAAC;IACtH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,KAAK,oBAAoB,EAAE,CAAC;QAC3C,sFAAsF;QACtF,OAAO,UAAU,IAAI,uBAAuB,QAAQ,yCAAyC,CAAC;IAChG,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC;IACnD,yFAAyF;IACzF,0FAA0F;IAC1F,+EAA+E;IAC/E,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,CACL,WAAW,IAAI,qBAAqB,IAAI,eAAe,QAAQ,iBAAiB;YAChF,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,IAAI,eAAe,IAAI,KAAK,QAAQ,GAAG,CAAC;AAC3D,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAAC,EAAY,EAAE,aAAqB;IACjE,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC9C,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;QAC7C,CAAC,CAAC,aAAa,CAAC;IAClB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CACR,uCAAuC,IAAI,2DAA2D,CACvG,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,oBAAoB,aAAa,IAAI,CAAC,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,iBAAiB,CAAC,EAAY;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACzE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACrC,CAAC"}

package/src/templates/extract-schema-emitter.ts

@@ -1,111 +0,0 @@
-// server/typescript/packages/codegen-ts/src/templates/extract-schema-emitter.ts
-//
-// Turns a payload value-object into TS source fragments for the FR-010 extract codegen:
-//   • schemaLiteral     — a `extractSchema(Format.JSON, "root", [ … ])` baked descriptor
-//                         built from FieldSpec factories (scalar / enumField).
-//   • mirrorInterface   — an all-nullable mirror interface `<Payload>Extracted` (each
-//                         component `T | null`); extract 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# ExtractSchemaEmitter (adapted to TS syntax + the `| null` nullable mirror).
-// Bounded scope: scalar / enum / scalar-array. Nested object + array-of-enum deferred.
-
-import {
-  type MetaData,
-  FIELD_SUBTYPE_ENUM,
-  FIELD_SUBTYPE_OBJECT,
-  FIELD_ATTR_ENUM_ALIAS,
-} from "@metaobjectsdev/metadata";
-import {
-  fields,
-  isRequired,
-  isArray,
-  scalarKind,
-  mirrorType,
-  extractMapCall,
-  enumValues,
-  coerceDefault,
-  defaultValue,
-  resolveNormalize,
-  jsonStringLiteral,
-  stringArrayLiteral,
-  propertiesMapLiteral,
-} from "./fr010-field-mapping.js";
-import { NORMALIZE_DEFAULT } from "@metaobjectsdev/metadata";
-
-/** Emit `extractSchema(Format.X, "rootName", [ … ])`. */
-export function schemaLiteral(vo: MetaData, format: string, rootName: string): string {
-  const formatEnum = format.toLowerCase() === "xml" ? "Format.XML" : "Format.JSON";
-  const specs = fields(vo).map((f) => fieldSpecLiteral(f, vo));
-  return `extractSchema(${formatEnum}, ${jsonStringLiteral(rootName)}, [${specs.join(", ")}])`;
-}
-
-function fieldSpecLiteral(field: MetaData, owner: MetaData): string {
-  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));
-    // FR-011: extended enumField signature is (name, required, values, aliases,
-    // coerceDefault?, normalize="strip", defaultValue?). Resolve the three new args
-    // (field → object → "strip" for normalize) and emit only what's needed: keep the
-    // back-compat 4-arg form when nothing is set, else emit the positional tail up to
-    // the last meaningful arg.
-    const cd = coerceDefault(field);
-    const dv = defaultValue(field);
-    const normalize = resolveNormalize(field, owner);
-    // enumField() sets array:false; enum-array is a bounded deferral (parity with Java/C#).
-    if (cd == null && dv == null && normalize === NORMALIZE_DEFAULT) {
-      return `enumField(${name}, ${required}, ${valuesLit}, ${aliasLit})`;
-    }
-    const cdLit = cd == null ? "null" : jsonStringLiteral(cd);
-    const normLit = jsonStringLiteral(normalize);
-    if (dv == null) {
-      return `enumField(${name}, ${required}, ${valuesLit}, ${aliasLit}, ${cdLit}, ${normLit})`;
-    }
-    return `enumField(${name}, ${required}, ${valuesLit}, ${aliasLit}, ${cdLit}, ${normLit}, ${jsonStringLiteral(dv)})`;
-  }
-
-  if (field.subType === FIELD_SUBTYPE_OBJECT) {
-    // FR-010: nested extract deferred — treat as an opaque required/optional string slot.
-    return `scalar(${name}, FieldKind.STRING, ${required}) /* FR-010: nested extract 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
-  // extract() actually populates the array at runtime (ExtractMap.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: MetaData, interfaceName: string): string {
-  const base = interfaceName.endsWith("Extracted")
-    ? interfaceName.slice(0, -"Extracted".length)
-    : interfaceName;
-  const lines: string[] = [];
-  lines.push(
-    `/** Best-effort extracted 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: MetaData): string {
-  const assigns = fields(vo).map((f) => `${f.name}: ${extractMapCall(f)}`);
-  return `{ ${assigns.join(", ")} }`;
-}