@metaobjectsdev/codegen-ts 0.7.0-rc.11 → 0.7.0-rc.12

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,EAGf,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;AA+OD;;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,375 @@
+// 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})\``);
+        }
+    }
+    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) {
+                parts.push(`pattern \`${pattern}\``);
+            }
+        }
+    }
+    const maxLenAttr = field.ownAttr(FIELD_ATTR_MAX_LENGTH);
+    if (typeof maxLenAttr === "number") {
+        parts.push(`maxLength: ${maxLenAttr}`);
+    }
+    for (const v of field.validators()) {
+        if (v.subType === VALIDATOR_SUBTYPE_LENGTH) {
+            const min = v.ownAttr(VALIDATOR_ATTR_MIN);
+            const max = v.ownAttr(VALIDATOR_ATTR_MAX);
+            if (typeof min === "number")
+                parts.push(`minLength: ${min}`);
+            if (typeof max === "number" && typeof maxLenAttr !== "number")
+                parts.push(`maxLength: ${max}`);
+        }
+    }
+    for (const v of field.validators()) {
+        if (v.subType === VALIDATOR_SUBTYPE_NUMERIC) {
+            const min = v.ownAttr(VALIDATOR_ATTR_MIN);
+            const max = v.ownAttr(VALIDATOR_ATTR_MAX);
+            if (typeof min === "number")
+                parts.push(`min: ${min}`);
+            if (typeof max === "number")
+                parts.push(`max: ${max}`);
+        }
+    }
+    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) {
+        const refIdent = id;
+        const raw = refIdent.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,87 @@
+/** 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;
+    tsTypeCell: string;
+    sqlExprCell: string;
+    constraintsCell: string;
+    /** 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 {
+    /** 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 {
+    /** Pre-formatted bullet text — e.g.
+     *    "- `posts` — one-to-many → `Post` (composition)" */
+    bullet: string;
+}
+export interface UsedByDoc {
+    /** Pre-formatted bullet text. */
+    bullet: string;
+}
+export interface GeneratedFileDoc {
+    filename: string;
+    description: string;
+}
+export interface EntityDocData {
+    /** 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. */
+    entity: {
+        name: string;
+        type: string;
+        source?: string;
+        package?: string;
+        description?: string;
+    };
+    /** Description as a blockquote (one `> ` per line). Present iff description
+     *  is present. Pre-rendered so multi-line descriptions don't have to be
+     *  expressed as Mustache structural constructs. */
+    descriptionQuote?: string;
+    /** 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?: {
+        /** Pre-rendered "| Field | ... |\n|---|---|---|---|" header pair. */
+        tableHeader: string;
+        rows: StorageFieldDoc[];
+    };
+    /** Identity section bullets — empty array iff section is omitted. Templates
+     *  check `hasIdentities` (boolean) to decide whether to emit the section
+     *  header; iterate `identities` for the bullets. (Splitting "is the section
+     *  present?" from "iterate the bullets" works around Mustache's lack of an
+     *  "is non-empty array" primitive.) */
+    identities?: IdentityDoc[];
+    hasIdentities?: boolean;
+    /** Relationships section — same pattern as identities. */
+    relationships?: RelationshipDoc[];
+    hasRelationships?: boolean;
+    /** Validation section — always emitted. */
+    validation: {
+        insertSchema: string;
+        updateSchema: string;
+        entityFile: string;
+        lower: string;
+    };
+    /** "Used by" — present iff any templates declare @payloadRef → this entity. */
+    usedBy?: UsedByDoc[];
+    hasUsedBy?: boolean;
+    /** Storage section presence flag — same pattern as identities. */
+    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":"AAYA;;;mEAGmE;AACnE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,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,iCAAiC;IACjC,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;;6BAEyB;IACzB,eAAe,EAAE,MAAM,CAAC;IAExB,2BAA2B;IAC3B,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;;uDAEmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;0EACsE;IACtE,cAAc,EAAE,MAAM,CAAC;IAEvB;+BAC2B;IAC3B,OAAO,CAAC,EAAE;QACR,qEAAqE;QACrE,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,eAAe,EAAE,CAAC;KACzB,CAAC;IAEF;;;;2CAIuC;IACvC,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,2CAA2C;IAC3C,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,+EAA+E;IAC/E,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,4EAA4E;IAC5E,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B"}

package/dist/generators/docs-data.js

@@ -0,0 +1,13 @@
+// Data-dict shapes for the docs templates — the public contract template
+// authors consume. Versioned per MO major; deprecated before removal.
+//
+// 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.
+//
+// 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.
+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,4EAA4E;AAC5E,2EAA2E;AAC3E,2EAA2E;AAC3E,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,6EAA6E;AAC7E,iEAAiE"}

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

@@ -1,5 +1,5 @@
 import type { MetaObject } from "@metaobjectsdev/metadata";
-import { type GeneratorFactory } from "../generator.js";
+import type { GeneratorFactory } from "../generator.js";
 export interface DocsFileOpts {
     filter?: (entity: MetaObject) => boolean;
     target?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"docs-file.d.ts","sourceRoot":"","sources":["../../src/generators/docs-file.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAInF,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,QAAQ,EA+BhB,gBAAgB,CAAC,YAAY,CAAC,CAAC"}
+{"version":3,"file":"docs-file.d.ts","sourceRoot":"","sources":["../../src/generators/docs-file.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAa,gBAAgB,EAAc,MAAM,iBAAiB,CAAC;AAQ/E,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAYD,eAAO,MAAM,QAAQ,EA+ChB,gBAAgB,CAAC,YAAY,CAAC,CAAC"}

package/dist/generators/docs-file.js

@@ -1,52 +1,69 @@
 // docsFile() — emits `<Entity>.md` next to each generated entity module.
 //
-// Markdown is port-agnostic: the same metadata produces the same documentation
-// page regardless of dialect, output layout, or runtime target. The page covers
-// description / type / source / package preamble; storage table + identity +
-// relationships for table-backed entities; validation entry points; "used by"
-// template cross-references; and the generated-code surface (which sibling
-// files codegen produces). See `templates/docs-file.ts` for the body.
-import { perEntity } from "../generator.js";
-import { renderDocsFile } from "../templates/docs-file.js";
+// rc.12+: refactored to use templateGenerator(). The Markdown structure now
+// lives in `templates/docs/entity-page.md.mustache`; the data extraction lives
+// in `buildEntityDocData()`. Adopters can override the framework template by
+// dropping their own `templates/docs/entity-page.md.mustache` into the project
+// root (resolved via the project-then-framework provider chain).
+//
+// The conformance fixture (`fixtures/conformance/docs-file-basic`) gates
+// byte-identity through the refactor — the codegen output must match the
+// hand-coded rc.11 byte-for-byte. If you're hacking on this and the
+// conformance test breaks, the refactor is the bug, not the fixture.
 import { entityOutputPath } from "../import-path.js";
+import { templateGenerator, } from "./template-generator.js";
+import { buildEntityDocData } from "./docs-data-builder.js";
+/** The names of the generators that may emit sibling files for an entity.
+ *  We always list them in the "Generated code" section — adopters cross-
+ *  reference their own metaobjects.config.ts to confirm which are wired in.
+ *  Matches the rc.11 behavior. */
+const KNOWN_SIBLING_GENERATORS = new Set([
+    "queries-file",
+    "routes-file",
+    "routes-file-hono",
+]);
 export const docsFile = function docsFile(opts) {
+    // We can't fully delegate to templateGenerator's `walk(root)` because the
+    // per-entity output path depends on the runtime `outputLayout` (flat /
+    // package), which only lives on `GenContext.config`. So docsFile wraps
+    // templateGenerator and threads ctx through.
+    const tgOpts = {
+        name: "docs-file",
+        template: "docs/entity-page.md",
+        format: "markdown",
+        walk: () => [], // placeholder — real walk happens inside generate() below
+    };
+    const inner = templateGenerator(tgOpts);
     const generator = {
         name: "docs-file",
-        generate: perEntity((entity, ctx) => {
+        async generate(ctx) {
             if (!ctx.renderContext) {
                 throw new Error("docs-file: renderContext is required (provided by runGen)");
             }
             const rc = ctx.renderContext;
-            const generatorNames = readGeneratorNames(ctx);
-            return {
-                path: entityOutputPath(ctx.config.outputLayout ?? "flat", entity.package, `${entity.name}.md`),
-                content: renderDocsFile(entity, {
+            // Drive the templateGenerator by populating its walk via closure.
+            const realWalk = (root) => root.objects().filter(ctx.matches).map((entity) => ({
+                data: buildEntityDocData(entity, {
                     dialect: rc.dialect,
-                    columnNamingStrategy: rc.columnNamingStrategy,
+                    ...(rc.columnNamingStrategy !== undefined
+                        ? { columnNamingStrategy: rc.columnNamingStrategy }
+                        : {}),
                     loadedRoot: rc.loadedRoot,
-                    generatorNames,
+                    generatorNames: KNOWN_SIBLING_GENERATORS,
                 }),
-            };
-        }),
+                outputPath: entityOutputPath(ctx.config.outputLayout ?? "flat", entity.package, `${entity.name}.md`),
+            }));
+            // Hot-swap walk on the underlying templateGenerator. (The factory
+            // closes over `opts.walk`, so we mutate the options object's walk
+            // reference here.)
+            tgOpts.walk = realWalk;
+            return inner.generate(ctx);
+        },
     };
-    if (opts?.filter) {
+    if (opts?.filter)
         generator.filter = opts.filter;
-    }
-    if (opts?.target) {
+    if (opts?.target)
         generator.target = opts.target;
-    }
     return generator;
 };
-/**
- * `GenContext` does not currently carry the full generator list — that lives on
- * the resolved config inside the runner. Rather than thread a new field through
- * just to populate one optional markdown section, we always list every
- * potential companion. The "Generated code" section becomes "files that may be
- * generated alongside this one" — adopters cross-reference their own
- * `metaobjects.config.ts` to confirm which they actually wired in. This matches
- * the spec guidance "list them all and let the reader figure out which exist."
- */
-function readGeneratorNames(_ctx) {
-    return new Set(["queries-file", "routes-file", "routes-file-hono"]);
-}
 //# sourceMappingURL=docs-file.js.map