@metaobjectsdev/codegen-ts 0.7.0-rc.9 → 0.8.0-rc.1

package/dist/generator.d.ts

@@ -22,6 +22,15 @@ export interface GenContext {
      *  present at run time when invoked via runGen(); optional in the type
      *  so tests and custom callers don't need a placeholder. */
     renderContext?: RenderContext;
+    /** Resolved absolute project root — what the runner derives from
+     *  `opts.projectRoot` (the directory holding `.metaobjects/config.json`).
+     *  Generators that resolve project-scoped resources (e.g.
+     *  `templateGenerator` looking up the project's `templates/` directory)
+     *  should read this rather than `process.cwd()`, which is whatever
+     *  directory the CLI was invoked from and breaks when `meta gen` runs
+     *  in a sub-directory. Undefined only when the runner was driven
+     *  programmatically without an explicit projectRoot. */
+    projectRoot?: string;
     warn: (msg: string) => void;
 }
 export interface Generator {

package/dist/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,UAAU,EAAE,QAAQ,CAAC;IACrB;;oBAEgB;IAChB,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;gEAG4D;IAC5D,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,QAAQ,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtE,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;iFAC6E;IAC7E,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,IAAI,IAAI,KAAK,SAAS,IAAI,GAC3D,MAAM,SAAS,GACf,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,SAAS,CAAC;AAEhC,mDAAmD;AACnD,wBAAgB,SAAS,CACvB,EAAE,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,KACpC,WAAW,GACX,WAAW,EAAE,GACb,OAAO,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,GACvC,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAM7C;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CACxB,EAAE,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,UAAU,KACxC,WAAW,GACX,WAAW,EAAE,GACb,OAAO,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,GACvC,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAM7C"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,UAAU,EAAE,QAAQ,CAAC;IACrB;;oBAEgB;IAChB,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;gEAG4D;IAC5D,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;;;;4DAOwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,QAAQ,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtE,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;iFAC6E;IAC7E,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,IAAI,IAAI,KAAK,SAAS,IAAI,GAC3D,MAAM,SAAS,GACf,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,SAAS,CAAC;AAEhC,mDAAmD;AACnD,wBAAgB,SAAS,CACvB,EAAE,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,KACpC,WAAW,GACX,WAAW,EAAE,GACb,OAAO,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,GACvC,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAM7C;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CACxB,EAAE,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,UAAU,KACxC,WAAW,GACX,WAAW,EAAE,GACb,OAAO,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,GACvC,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAM7C"}

package/dist/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AA8CA,mDAAmD;AACnD,MAAM,UAAU,SAAS,CACvB,EAGwC;IAExC,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAClE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,UAAU,CACxB,EAGwC;IAExC,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAuDA,mDAAmD;AACnD,MAAM,UAAU,SAAS,CACvB,EAGwC;IAExC,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAClE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,UAAU,CACxB,EAGwC;IAExC,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC,CAAC;AACJ,CAAC"}

package/dist/generators/docs-data-builder.d.ts

@@ -0,0 +1,16 @@
+import { type MetaObject, type MetaRoot } from "@metaobjectsdev/metadata";
+import { type Dialect } from "../column-mapper.js";
+import type { ColumnNamingStrategy } from "../metaobjects-config.js";
+import type { EntityDocData } from "./docs-data.js";
+export interface BuildDocDataOpts {
+    dialect: Dialect;
+    columnNamingStrategy?: ColumnNamingStrategy;
+    loadedRoot: MetaRoot;
+    /** Set of generator names present in the pipeline; drives "Generated code". */
+    generatorNames?: ReadonlySet<string>;
+}
+/** Build the EntityDocData payload for one entity. The single public-API
+ *  entry point exported by this module; the markdown template applies
+ *  against this shape. */
+export declare function buildEntityDocData(entity: MetaObject, opts: BuildDocDataOpts): EntityDocData;
+//# sourceMappingURL=docs-data-builder.d.ts.map

package/dist/generators/docs-data-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-data-builder.d.ts","sourceRoot":"","sources":["../../src/generators/docs-data-builder.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,UAAU,EAIf,KAAK,QAAQ,EA2Cd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAKrE,OAAO,KAAK,EACV,aAAa,EAMd,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,UAAU,EAAE,QAAQ,CAAC;IACrB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACtC;AAiPD;;0BAE0B;AAC1B,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,gBAAgB,GACrB,aAAa,CAmJf"}

package/dist/generators/docs-data-builder.js

@@ -0,0 +1,381 @@
+// Helper that turns a MetaObject (+ root) into the EntityDocData shape the
+// templates consume. The previous hand-coded `renderDocsFile()` mixed data
+// extraction with string emission; this module is the data-only half — the
+// markdown structure now lives in templates/docs/entity-page.md.mustache.
+import { TYPE_TEMPLATE, TEMPLATE_ATTR_PAYLOAD_REF, OBJECT_SUBTYPE_VALUE, IDENTITY_SUBTYPE_PRIMARY, IDENTITY_SUBTYPE_SECONDARY, IDENTITY_SUBTYPE_REFERENCE, IDENTITY_ATTR_GENERATION, RELATIONSHIP_ATTR_CARDINALITY, RELATIONSHIP_ATTR_OBJECT_REF, RELATIONSHIP_SUBTYPE_COMPOSITION, RELATIONSHIP_SUBTYPE_AGGREGATION, RELATIONSHIP_SUBTYPE_ASSOCIATION, FIELD_SUBTYPE_ENUM, FIELD_SUBTYPE_OBJECT, FIELD_SUBTYPE_STRING, FIELD_SUBTYPE_CLASS, FIELD_SUBTYPE_INT, FIELD_SUBTYPE_SHORT, FIELD_SUBTYPE_BYTE, FIELD_SUBTYPE_LONG, FIELD_SUBTYPE_DOUBLE, FIELD_SUBTYPE_FLOAT, FIELD_SUBTYPE_DECIMAL, FIELD_SUBTYPE_CURRENCY, FIELD_SUBTYPE_BOOLEAN, FIELD_SUBTYPE_DATE, FIELD_SUBTYPE_TIME, FIELD_SUBTYPE_TIMESTAMP, FIELD_ATTR_REQUIRED, FIELD_ATTR_UNIQUE, FIELD_ATTR_OBJECT_REF, FIELD_ATTR_MAX_LENGTH, FIELD_ATTR_DEFAULT, VALIDATOR_SUBTYPE_LENGTH, VALIDATOR_SUBTYPE_REGEX, VALIDATOR_SUBTYPE_NUMERIC, VALIDATOR_SUBTYPE_REQUIRED, VALIDATOR_ATTR_PATTERN, VALIDATOR_ATTR_MIN, VALIDATOR_ATTR_MAX, DOC_ATTR_DESCRIPTION, stripPackage, } from "@metaobjectsdev/metadata";
+import { mapColumnType } from "../column-mapper.js";
+import { toPascalCase } from "../naming.js";
+import { enumValues } from "../enum-meta.js";
+import { hasWritableRdbSource } from "../source-detect.js";
+import { GENERATED_HEADER } from "../constants.js";
+const SCALAR_TS_BY_SUBTYPE = {
+    [FIELD_SUBTYPE_STRING]: "string",
+    [FIELD_SUBTYPE_CLASS]: "string",
+    [FIELD_SUBTYPE_INT]: "number",
+    [FIELD_SUBTYPE_SHORT]: "number",
+    [FIELD_SUBTYPE_BYTE]: "number",
+    [FIELD_SUBTYPE_LONG]: "number",
+    [FIELD_SUBTYPE_DOUBLE]: "number",
+    [FIELD_SUBTYPE_FLOAT]: "number",
+    [FIELD_SUBTYPE_DECIMAL]: "number",
+    [FIELD_SUBTYPE_CURRENCY]: "number",
+    [FIELD_SUBTYPE_BOOLEAN]: "boolean",
+    [FIELD_SUBTYPE_DATE]: "string",
+    [FIELD_SUBTYPE_TIME]: "string",
+    [FIELD_SUBTYPE_TIMESTAMP]: "string",
+};
+function enumTypeAliasName(entity, field) {
+    const superField = field.resolveSuper();
+    return superField !== undefined
+        ? toPascalCase(superField.name)
+        : `${entity.name}${toPascalCase(field.name)}`;
+}
+function isFieldRequired(field) {
+    if (field.ownAttr(FIELD_ATTR_REQUIRED) === true)
+        return true;
+    return field.validators().some((v) => v.subType === VALIDATOR_SUBTYPE_REQUIRED);
+}
+function tsTypeForStorage(entity, field, pkFieldNames) {
+    let base;
+    if (field.subType === FIELD_SUBTYPE_ENUM) {
+        const values = enumValues(field);
+        if (values !== undefined && values.length > 0) {
+            if (field.isArray) {
+                base = `${enumTypeAliasName(entity, field)}[]`;
+            }
+            else {
+                base = values.map((v) => JSON.stringify(v)).join(" | ");
+            }
+        }
+        else {
+            base = field.isArray ? "string[]" : "string";
+        }
+    }
+    else if (field.subType === FIELD_SUBTYPE_OBJECT) {
+        const ref = field.ownAttr(FIELD_ATTR_OBJECT_REF);
+        const refName = typeof ref === "string" && ref.length > 0 ? ref : "unknown";
+        base = field.isArray ? `${refName}[]` : refName;
+    }
+    else {
+        const scalar = SCALAR_TS_BY_SUBTYPE[field.subType] ?? "unknown";
+        base = field.isArray ? `${scalar}[]` : scalar;
+    }
+    const required = pkFieldNames.has(field.name) || isFieldRequired(field);
+    return required ? base : `${base} | null`;
+}
+function sqlColumnExpr(spec) {
+    const dbName = JSON.stringify(spec.dbName);
+    if (spec.fnOptions !== undefined && Object.keys(spec.fnOptions).length > 0) {
+        const parts = [];
+        for (const [k, v] of Object.entries(spec.fnOptions)) {
+            const lit = JSON.stringify(v);
+            if (Array.isArray(v)) {
+                parts.push(`${k}: ${lit} as const`);
+            }
+            else {
+                parts.push(`${k}: ${lit}`);
+            }
+        }
+        return `${spec.fnName}(${dbName}, { ${parts.join(", ")} })`;
+    }
+    return `${spec.fnName}(${dbName})`;
+}
+function constraintsCell(entity, field, pkFieldNames, fkMap) {
+    const parts = [];
+    if (pkFieldNames.has(field.name)) {
+        parts.push("primary key");
+        const primary = entity.primaryIdentity();
+        const gen = primary?.ownAttr(IDENTITY_ATTR_GENERATION);
+        if (typeof gen === "string") {
+            parts.push(`generation: \`${gen}\``);
+        }
+    }
+    else if (isFieldRequired(field)) {
+        parts.push("required");
+    }
+    else {
+        parts.push("optional");
+    }
+    if (field.ownAttr(FIELD_ATTR_UNIQUE) === true) {
+        parts.push("unique");
+    }
+    if (field.isArray) {
+        parts.push("JSON column");
+    }
+    if (field.subType === FIELD_SUBTYPE_ENUM && !field.isArray) {
+        const values = enumValues(field);
+        if (values !== undefined && values.length > 0) {
+            const list = values.map((v) => `'${v.replace(/'/g, "''")}'`).join(", ");
+            parts.push(`CHECK \`${field.column ?? field.name} IN (${list})\``);
+        }
+    }
+    // Walk validators once, bucket by subtype. We re-emit in the original
+    // emission order to preserve byte-identity with the docs-file-basic
+    // conformance fixture: regex pattern → maxLength-from-@maxLength →
+    // length-validator (min/max) → numeric-validator (min/max).
+    const maxLenAttr = field.ownAttr(FIELD_ATTR_MAX_LENGTH);
+    const regexParts = [];
+    const lengthParts = [];
+    const numericParts = [];
+    for (const v of field.validators()) {
+        if (v.subType === VALIDATOR_SUBTYPE_REGEX) {
+            const pattern = v.ownAttr(VALIDATOR_ATTR_PATTERN);
+            if (typeof pattern === "string" && pattern.length > 0) {
+                regexParts.push(`pattern \`${pattern}\``);
+            }
+        }
+        else if (v.subType === VALIDATOR_SUBTYPE_LENGTH) {
+            const min = v.ownAttr(VALIDATOR_ATTR_MIN);
+            const max = v.ownAttr(VALIDATOR_ATTR_MAX);
+            if (typeof min === "number")
+                lengthParts.push(`minLength: ${min}`);
+            if (typeof max === "number" && typeof maxLenAttr !== "number")
+                lengthParts.push(`maxLength: ${max}`);
+        }
+        else if (v.subType === VALIDATOR_SUBTYPE_NUMERIC) {
+            const min = v.ownAttr(VALIDATOR_ATTR_MIN);
+            const max = v.ownAttr(VALIDATOR_ATTR_MAX);
+            if (typeof min === "number")
+                numericParts.push(`min: ${min}`);
+            if (typeof max === "number")
+                numericParts.push(`max: ${max}`);
+        }
+    }
+    parts.push(...regexParts);
+    if (typeof maxLenAttr === "number") {
+        parts.push(`maxLength: ${maxLenAttr}`);
+    }
+    parts.push(...lengthParts, ...numericParts);
+    const fk = fkMap.get(field.name);
+    if (fk !== undefined) {
+        parts.push(`references \`${fk.targetEntity}.${fk.targetField}\``);
+    }
+    const def = field.ownAttr(FIELD_ATTR_DEFAULT);
+    if (def !== undefined) {
+        parts.push(`default: \`${String(def)}\``);
+    }
+    const sup = field.resolveSuper();
+    if (sup !== undefined) {
+        parts.push(`extends \`${sup.name}\``);
+    }
+    return parts.join(", ");
+}
+function buildFkMap(entity, root) {
+    const out = new Map();
+    for (const ref of entity.referenceIdentities()) {
+        const fkField = ref.fields[0];
+        const targetEntity = ref.targetEntity;
+        if (fkField === undefined || targetEntity === undefined)
+            continue;
+        const targetField = ref.resolvedTargetPkField(root) ?? "id";
+        out.set(fkField, { targetEntity: stripPackage(targetEntity), targetField });
+    }
+    return out;
+}
+function sourceLine(entity) {
+    const src = entity.source;
+    if (!src)
+        return undefined;
+    if ("files" in src && src.files.length > 0) {
+        return src.files[0];
+    }
+    if (src.format === "code") {
+        return src.caller !== undefined ? `(code) ${src.caller}` : "(code)";
+    }
+    return undefined;
+}
+function entityDescription(entity) {
+    const v = entity.attr(DOC_ATTR_DESCRIPTION);
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function describeIdentity(id) {
+    const fields = id.fields;
+    const fieldList = fields.length === 1
+        ? `\`${fields[0]}\``
+        : `(${fields.map((f) => `\`${f}\``).join(", ")})`;
+    if (id.subType === IDENTITY_SUBTYPE_PRIMARY) {
+        const gen = id.ownAttr(IDENTITY_ATTR_GENERATION);
+        const genSuffix = typeof gen === "string" ? ` — generation: \`${gen}\`` : "";
+        return `**Primary key:** ${fieldList}${genSuffix}`;
+    }
+    if (id.subType === IDENTITY_SUBTYPE_SECONDARY) {
+        const uniqueText = id.unique ? "unique" : "non-unique";
+        return `**Secondary index:** ${fieldList} — ${uniqueText}`;
+    }
+    if (id.subType === IDENTITY_SUBTYPE_REFERENCE) {
+        // The subType discriminator guarantees the instance is a MetaReferenceIdentity;
+        // narrow to it so we can use its typed `referencesRaw` getter directly.
+        const raw = id.referencesRaw;
+        if (typeof raw === "string" && raw.length > 0) {
+            return `**Reference:** ${fieldList} → \`${raw}\``;
+        }
+        return `**Reference:** ${fieldList}`;
+    }
+    return `**Identity (${id.subType}):** ${fieldList}`;
+}
+function relationshipBullet(r) {
+    const cardinality = r.ownAttr(RELATIONSHIP_ATTR_CARDINALITY);
+    const card = typeof cardinality === "string" ? cardinality : "?";
+    const targetRaw = r.ownAttr(RELATIONSHIP_ATTR_OBJECT_REF);
+    const target = typeof targetRaw === "string" ? stripPackage(targetRaw) : "?";
+    const subtype = r.subType;
+    let label;
+    switch (subtype) {
+        case RELATIONSHIP_SUBTYPE_COMPOSITION:
+            label = "composition";
+            break;
+        case RELATIONSHIP_SUBTYPE_AGGREGATION:
+            label = "aggregation";
+            break;
+        case RELATIONSHIP_SUBTYPE_ASSOCIATION:
+            label = "association";
+            break;
+        default: label = subtype;
+    }
+    return `\`${r.name}\` — ${card} → \`${target}\` (${label})`;
+}
+/** Build the EntityDocData payload for one entity. The single public-API
+ *  entry point exported by this module; the markdown template applies
+ *  against this shape. */
+export function buildEntityDocData(entity, opts) {
+    const strategy = opts.columnNamingStrategy ?? "snake_case";
+    const root = opts.loadedRoot;
+    const primary = entity.primaryIdentity();
+    const pkFields = primary?.fields ?? [];
+    const pkFieldNames = new Set(pkFields);
+    const fkMap = buildFkMap(entity, root);
+    // ---- Storage rows
+    const storageRows = entity.fields().map((field) => {
+        const spec = mapColumnType(field, opts.dialect, strategy);
+        const tsType = tsTypeForStorage(entity, field, pkFieldNames);
+        const tsTypeCell = tsType.split("|").map((s) => s.trim()).join(" \\| ");
+        const sqlExpr = sqlColumnExpr(spec);
+        const cons = constraintsCell(entity, field, pkFieldNames, fkMap);
+        const tsTypeCellStr = `\`${tsTypeCell}\``;
+        const sqlExprCellStr = `\`${sqlExpr}\``;
+        return {
+            name: field.name,
+            tsTypeCell: tsTypeCellStr,
+            sqlExprCell: sqlExprCellStr,
+            constraintsCell: cons,
+            rowLine: `| \`${field.name}\` | ${tsTypeCellStr} | ${sqlExprCellStr} | ${cons} |`,
+        };
+    });
+    const isValue = entity.subType === OBJECT_SUBTYPE_VALUE;
+    const hasStorage = !isValue && hasWritableRdbSource(entity);
+    // ---- Identities
+    const ids = entity.identities();
+    const identities = ids.length > 0
+        ? ids.map((id) => ({ bullet: describeIdentity(id) }))
+        : undefined;
+    // ---- Relationships
+    const rels = entity.relationships();
+    const relationships = rels.length > 0
+        ? rels.map((r) => ({ bullet: relationshipBullet(r) }))
+        : undefined;
+    // ---- Validation
+    const lower = entity.name.charAt(0).toLowerCase() + entity.name.slice(1);
+    const validation = {
+        insertSchema: `${entity.name}InsertSchema`,
+        updateSchema: `${entity.name}UpdateSchema`,
+        entityFile: `${entity.name}.ts`,
+        lower,
+    };
+    // ---- UsedBy
+    const usedByMatches = [];
+    for (const child of root.ownChildren()) {
+        if (child.type !== TYPE_TEMPLATE)
+            continue;
+        const ref = child.ownAttr(TEMPLATE_ATTR_PAYLOAD_REF);
+        if (typeof ref !== "string")
+            continue;
+        if (stripPackage(ref) !== entity.name)
+            continue;
+        usedByMatches.push({
+            bullet: `\`template.${child.subType} ${child.name}\` — uses \`${entity.name}\` as \`@payloadRef\``,
+        });
+    }
+    const usedBy = usedByMatches.length > 0 ? usedByMatches : undefined;
+    // ---- Generated
+    const gens = opts.generatorNames ?? new Set();
+    const generated = [];
+    generated.push({
+        filename: `${entity.name}.ts`,
+        description: "Drizzle table, Zod schemas, type aliases, enum literal unions.",
+    });
+    if (gens.has("queries-file") && !isValue) {
+        generated.push({
+            filename: `${entity.name}.queries.ts`,
+            description: "typed CRUD helpers (find / list / create / update / delete; takes `db` as first param per ADR-0008).",
+        });
+    }
+    if (gens.has("routes-file") && !isValue) {
+        generated.push({
+            filename: `${entity.name}.routes.ts`,
+            description: `Fastify CRUD-5 route registration (\`register${entity.name}Routes\`).`,
+        });
+    }
+    if (gens.has("routes-file-hono") && !isValue) {
+        generated.push({
+            filename: `${entity.name}.routes.hono.ts`,
+            description: `Hono CRUD-5 route registration (\`register${entity.name}Routes\`).`,
+        });
+    }
+    // Preamble header — built up exactly as the legacy emitter did.
+    const preambleLines = [];
+    const typeStr = `${entity.type}.${entity.subType}`;
+    preambleLines.push(`**Type:** \`${typeStr}\``);
+    const src = sourceLine(entity);
+    if (src !== undefined)
+        preambleLines.push(`**Source:** \`${src}\``);
+    if (entity.package !== undefined && entity.package !== "") {
+        preambleLines.push(`**Package:** \`${entity.package}\``);
+    }
+    const preambleHeader = preambleLines.join("\n");
+    // Description quote — each line of the description prefixed with "> ".
+    const desc = entityDescription(entity);
+    let descriptionQuote;
+    if (desc !== undefined) {
+        descriptionQuote = desc.split("\n").map((l) => `> ${l}`.trimEnd()).join("\n");
+    }
+    const data = {
+        generatedMarker: `<!-- ${GENERATED_HEADER} — DO NOT EDIT. -->`,
+        entity: {
+            name: entity.name,
+            type: typeStr,
+        },
+        preambleHeader,
+        validation,
+        generated,
+    };
+    if (desc !== undefined)
+        data.entity.description = desc;
+    if (descriptionQuote !== undefined)
+        data.descriptionQuote = descriptionQuote;
+    if (src !== undefined)
+        data.entity.source = src;
+    if (entity.package !== undefined && entity.package !== "") {
+        data.entity.package = entity.package;
+    }
+    if (hasStorage) {
+        data.storage = {
+            tableHeader: "| Field | TypeScript type | SQL column | Constraints |\n|---|---|---|---|",
+            rows: storageRows,
+        };
+        data.hasStorage = true;
+    }
+    if (identities !== undefined) {
+        data.identities = identities;
+        data.hasIdentities = true;
+    }
+    if (relationships !== undefined) {
+        data.relationships = relationships;
+        data.hasRelationships = true;
+    }
+    if (usedBy !== undefined) {
+        data.usedBy = usedBy;
+        data.hasUsedBy = true;
+    }
+    return data;
+}
+//# sourceMappingURL=docs-data-builder.js.map

package/dist/generators/docs-data-builder.js.map

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

package/dist/generators/docs-data.d.ts

@@ -0,0 +1,98 @@
+/** One row in the Storage table — fully-rendered as a single Markdown table
+ *  row. The escaping rules for pipe-inside-cell are non-trivial and live in
+ *  the data builder, not the template, so templates stay trivial and the
+ *  cross-port walk functions don't have to re-derive the rules. */
+export interface StorageFieldDoc {
+    name: string;
+    /** @markdown — already escaped TS type, with backticks. */
+    tsTypeCell: string;
+    /** @markdown — already escaped SQL expression, wrapped in backticks. */
+    sqlExprCell: string;
+    /** @markdown — already-formatted constraints text. */
+    constraintsCell: string;
+    /** @markdown — pre-rendered full Markdown table row, e.g.
+     *    "| `id` | `number` | `integer(\"id\")` | primary key |"
+     *  Templates emit this verbatim via `{{{rowLine}}}`. */
+    rowLine: string;
+}
+export interface IdentityDoc {
+    /** @markdown — pre-formatted bullet text — e.g.
+     *    "**Primary key:** `id` — generation: `increment`"
+     *  (Carrying the fully-rendered string keeps the template trivial; the
+     *  identity rendering rules are non-trivial and live in the builder.) */
+    bullet: string;
+}
+export interface RelationshipDoc {
+    /** @markdown — pre-formatted bullet text — e.g.
+     *    "- `posts` — one-to-many → `Post` (composition)" */
+    bullet: string;
+}
+export interface UsedByDoc {
+    /** @markdown — pre-formatted bullet text. */
+    bullet: string;
+}
+export interface GeneratedFileDoc {
+    filename: string;
+    description: string;
+}
+export interface EntityDocData {
+    /** @markdown — auto-emitted by the templateGenerator; templates may also
+     *  echo it for human readers. Format: `<!-- @generated by
+     *  @metaobjectsdev/codegen-ts — DO NOT EDIT. -->`. */
+    generatedMarker: string;
+    /** The entity preamble — RAW (not Markdown-flavored). Custom non-Markdown
+     *  templates can rely on these fields. */
+    entity: {
+        name: string;
+        type: string;
+        source?: string;
+        package?: string;
+        description?: string;
+    };
+    /** @markdown — description as a blockquote (one `> ` per line). Present
+     *  iff `entity.description` is present. Pre-rendered so multi-line
+     *  descriptions don't have to be expressed as Mustache structural
+     *  constructs. */
+    descriptionQuote?: string;
+    /** @markdown — multi-line preamble block: Type / Source? / Package?, one
+     *  per line, in the exact order matching the legacy emitter. Always
+     *  present. */
+    preambleHeader: string;
+    /** Storage section. Present iff the entity has a writable rdb source and
+     *  is NOT object.value. */
+    storage?: {
+        /** @markdown — pre-rendered "| Field | ... |\n|---|---|---|---|" header
+         *  pair. */
+        tableHeader: string;
+        rows: StorageFieldDoc[];
+    };
+    /** Identity section bullets — empty array iff section is omitted.
+     *  See the "Mustache idiom note" at the top of this file for why this
+     *  ships alongside a parallel `hasIdentities` boolean. */
+    identities?: IdentityDoc[];
+    /** Present-and-non-empty flag for the identities section. See the
+     *  "Mustache idiom note" at the top of this file. */
+    hasIdentities?: boolean;
+    /** Relationships section — same list+flag pattern as identities. */
+    relationships?: RelationshipDoc[];
+    /** Present-and-non-empty flag for the relationships section. */
+    hasRelationships?: boolean;
+    /** Validation section — RAW (not Markdown-flavored). Always emitted.
+     *  Custom non-Markdown templates can rely on these fields. */
+    validation: {
+        insertSchema: string;
+        updateSchema: string;
+        entityFile: string;
+        lower: string;
+    };
+    /** "Used by" — present iff any templates declare `@payloadRef` → this
+     *  entity. Same list+flag pattern as identities. */
+    usedBy?: UsedByDoc[];
+    /** Present-and-non-empty flag for the usedBy section. */
+    hasUsedBy?: boolean;
+    /** Present flag for the storage section. */
+    hasStorage?: boolean;
+    /** Generated-code section — always emitted (at minimum the entity file). */
+    generated: GeneratedFileDoc[];
+}
+//# sourceMappingURL=docs-data.d.ts.map

package/dist/generators/docs-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-data.d.ts","sourceRoot":"","sources":["../../src/generators/docs-data.ts"],"names":[],"mappings":"AA0CA;;;mEAGmE;AACnE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB;;4DAEwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B;;;6EAGyE;IACzE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;6DACyD;IACzD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B;;0DAEsD;IACtD,eAAe,EAAE,MAAM,CAAC;IAExB;8CAC0C;IAC1C,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF;;;sBAGkB;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;mBAEe;IACf,cAAc,EAAE,MAAM,CAAC;IAEvB;+BAC2B;IAC3B,OAAO,CAAC,EAAE;QACR;oBACY;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,eAAe,EAAE,CAAC;KACzB,CAAC;IAEF;;8DAE0D;IAC1D,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B;yDACqD;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,oEAAoE;IACpE,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;kEAC8D;IAC9D,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAEF;wDACoD;IACpD,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,4EAA4E;IAC5E,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B"}

package/dist/generators/docs-data.js

@@ -0,0 +1,43 @@
+// Data-dict shapes for the docs templates — the public contract template
+// authors consume. Versioned per MO major; deprecated before removal.
+//
+// ## Stability contract (v1)
+//
+// Per the template-driven codegen design (D3 — data-shape stability), these
+// types ARE a public API. Template authors who write custom Mustache files
+// for `docs/entity-page.md` (or any of the partials) reference these keys.
+//
+// `EntityDocData` is the **Markdown-flavored** data shape — it intentionally
+// mixes raw structural fields (entity, validation, generated) with
+// **pre-rendered Markdown fragments** so cross-port walk functions (TS,
+// Python, C#, Java, Kotlin) don't have to re-derive the same escaping rules
+// (pipe-inside-cell escapes, backtick wrapping, identity bullets,
+// description blockquotes). Fields whose JSDoc carries a `@markdown` tag
+// encode Markdown-specific layout decisions and are stable for the v1
+// contract; they are NOT useful for non-Markdown output (HTML, JSON, plain
+// text).
+//
+// A consumer writing a custom Mustache template with **different table
+// columns** or a **different output format** today must compose their own
+// data from `MetaObject` directly — the v1 shape does not expose a
+// structural-only layer. A future `EntityDocStructure` (raw fields only,
+// no Markdown) may ship in v2 if a real adopter needs that surface; the
+// split is deliberately deferred until then.
+//
+// ## Cross-port consistency
+//
+// Today's docsFile() refactor populates EntityDocData from MetaObject + the
+// existing column-mapper / source-detect / enum-meta helpers. Cross-port
+// implementations (C#, Java, Kotlin, Python) emit the same shape so a single
+// set of Mustache templates can drive every port's docs codegen.
+//
+// ## Mustache idiom note
+//
+// Some sections carry both a list and a parallel `has*` boolean. The flag is
+// only present to work around Mustache's lack of an "is non-empty array"
+// primitive (`{{#identities}}` iterates but doesn't gate a wrapping section
+// header). A future render engine version may let templates use
+// `{{#identities.0}}` for the same effect, at which point the flag fields
+// can be deprecated.
+export {};
+//# sourceMappingURL=docs-data.js.map

package/dist/generators/docs-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-data.js","sourceRoot":"","sources":["../../src/generators/docs-data.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,sEAAsE;AACtE,EAAE;AACF,6BAA6B;AAC7B,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,2EAA2E;AAC3E,EAAE;AACF,6EAA6E;AAC7E,mEAAmE;AACnE,wEAAwE;AACxE,4EAA4E;AAC5E,kEAAkE;AAClE,yEAAyE;AACzE,sEAAsE;AACtE,2EAA2E;AAC3E,SAAS;AACT,EAAE;AACF,uEAAuE;AACvE,0EAA0E;AAC1E,mEAAmE;AACnE,yEAAyE;AACzE,wEAAwE;AACxE,6CAA6C;AAC7C,EAAE;AACF,4BAA4B;AAC5B,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,6EAA6E;AAC7E,iEAAiE;AACjE,EAAE;AACF,yBAAyB;AACzB,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,gEAAgE;AAChE,0EAA0E;AAC1E,qBAAqB"}

package/dist/generators/docs-file.d.ts

@@ -0,0 +1,8 @@
+import type { MetaObject } from "@metaobjectsdev/metadata";
+import type { GeneratorFactory } from "../generator.js";
+export interface DocsFileOpts {
+    filter?: (entity: MetaObject) => boolean;
+    target?: string;
+}
+export declare const docsFile: GeneratorFactory<DocsFileOpts>;
+//# sourceMappingURL=docs-file.d.ts.map

package/dist/generators/docs-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-file.d.ts","sourceRoot":"","sources":["../../src/generators/docs-file.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKnE,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD,eAAO,MAAM,QAAQ,EA0ChB,gBAAgB,CAAC,YAAY,CAAC,CAAC"}