@metaobjectsdev/codegen-ts 0.24.5 → 1.0.0-rc.1

package/dist/generators/index.js

@@ -1,19 +1,21 @@
-// ADR-0034 scaffold-and-own — these built-in generator factories remain the engine's
-// internal composers, but importing them from `@metaobjectsdev/codegen-ts/generators`
-// into a consumer's `metaobjects.config.ts` is DEPRECATED. The recommended path is to
-// own copyable reference templates in your repo (`meta init` scaffolds them into
-// `codegen/generators/*.ts`) and import those locally. This package export will be
-// removed in a future major. See spec/decisions/ADR-0034-codegen-scaffold-and-own.md.
-/** @deprecated ADR-0034 — own a copy instead: `import { entityFile } from "./codegen/generators/entity"` (scaffolded by `meta init`). */
-export { entityFile } from "./entity-file.js";
-/** @deprecated ADR-0034 — own a copy instead: `import { queriesFile } from "./codegen/generators/queries"` (scaffolded by `meta init`). */
-export { queriesFile } from "./queries-file.js";
+// Built-in generator factories.
+//
+// ADR-0034 scaffold-and-own — `entityFile`, `queriesFile`, `routesFile` and `barrel` were
+// exported here and DEPRECATED; 1.0 REMOVED them (ADR-0035 A3, `docs/1.0-readiness.md` G2,
+// `docs/features/migrations/0.x-to-1.0.md` §11). Own a copy instead: `meta init` scaffolds
+// them into `codegen/generators/*.ts` and `meta eject <name>` copies one at any time. They
+// remain in this directory as the engine's internal composers and as the oracle the
+// byte-identity gate holds each reference template to — they are no longer public API.
+//
+// The factories BELOW are not deprecated and this subpath is their supported public home:
+// the prompt/output tier (`promptRender`, `outputParser`, `outputPrompt`, `extractor`,
+// `renderHelper`, `traceHelperFile`) is upstream-owned and has no ownable copy — the CLI's
+// own prompt-gate warning names this import path — and `routesFileHono` / `namesFile` /
+// `callableFile` are stock generators a consumer wires directly.
+// See spec/decisions/ADR-0034-codegen-scaffold-and-own.md.
 export { callableFile } from "./callable-file.js";
-/** @deprecated ADR-0034 — own a copy instead: `import { routesFile } from "./codegen/generators/routes"` (scaffolded by `meta init`). */
-export { routesFile } from "./routes-file.js";
 export { routesFileHono } from "./routes-file-hono.js";
-/** @deprecated ADR-0034 — own a copy instead: `import { barrel } from "./codegen/generators/barrel"` (scaffolded by `meta init`). */
-export { barrel } from "./barrel.js";
+export { namesFile } from "./names-file.js";
 /** @deprecated ADR-0021 D1 — neutral artifact owned by `meta docs` (ADR-0020); not part of the recommended `meta gen` suite. */
 export { mermaidErDiagram } from "./mermaid-er.js";
 export { promptRender } from "./prompt-render-file.js";
@@ -34,4 +36,7 @@ export { buildTemplateDocData } from "./template-doc-builder.js";
 // behaviour composes its own generator instead of filing an issue here.
 export { requirementTests } from "./requirement-tests.js";
 export { requirementsFile } from "./requirements-file.js";
+// The `agent` docs surface — internal engine of `meta docs --agent`, like docsFile()
+// and apiDocsFile(). Not a `meta gen` config generator.
+export { agentDocsFile } from "./agent-docs-file.js";
 //# sourceMappingURL=index.js.map

package/dist/generators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,sFAAsF;AACtF,sFAAsF;AACtF,iFAAiF;AACjF,mFAAmF;AACnF,sFAAsF;AAEtF,yIAAyI;AACzI,OAAO,EAAE,UAAU,EAAuB,MAAM,kBAAkB,CAAC;AACnE,2IAA2I;AAC3I,OAAO,EAAE,WAAW,EAAwB,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AACzE,yIAAyI;AACzI,OAAO,EAAE,UAAU,EAAuB,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,cAAc,EAA2B,MAAM,uBAAuB,CAAC;AAChF,qIAAqI;AACrI,OAAO,EAAE,MAAM,EAAmB,MAAM,aAAa,CAAC;AACtD,gIAAgI;AAChI,OAAO,EAAE,gBAAgB,EAAyB,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAsB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,oKAAoK;AACpK,OAAO,EAAE,WAAW,EAAwB,MAAM,oBAAoB,CAAC;AACvE,iJAAiJ;AACjJ,OAAO,EAAE,QAAQ,EAAqB,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,iBAAiB,GAIlB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAwB,MAAM,wBAAwB,CAAC;AAS/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,6EAA6E;AAC7E,8EAA8E;AAC9E,wEAAwE;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,EAAE;AACF,0FAA0F;AAC1F,2FAA2F;AAC3F,2FAA2F;AAC3F,2FAA2F;AAC3F,oFAAoF;AACpF,uFAAuF;AACvF,EAAE;AACF,0FAA0F;AAC1F,uFAAuF;AACvF,2FAA2F;AAC3F,wFAAwF;AACxF,iEAAiE;AACjE,2DAA2D;AAE3D,OAAO,EAAE,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,cAAc,EAA2B,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,gIAAgI;AAChI,OAAO,EAAE,gBAAgB,EAAyB,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAsB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,oKAAoK;AACpK,OAAO,EAAE,WAAW,EAAwB,MAAM,oBAAoB,CAAC;AACvE,iJAAiJ;AACjJ,OAAO,EAAE,QAAQ,EAAqB,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,iBAAiB,GAIlB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAwB,MAAM,wBAAwB,CAAC;AAS/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,6EAA6E;AAC7E,8EAA8E;AAC9E,wEAAwE;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,qFAAqF;AACrF,wDAAwD;AACxD,OAAO,EAAE,aAAa,EAA0B,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { Generator } from "../generator.js";
+/**
+ * §A1/§A2/§A6 — `<Entity>Names`: the physical database names for one object, as constants a
+ * hand-written consumer references instead of a string literal.
+ *
+ * This is the built-in twin of `src/reference/names.ts` (ADR-0034 scaffold-and-own —
+ * `meta init` copies the reference file into the adopter's repo; this one stays the
+ * engine's internal composer and the reference-byte-identical gate's other half). Same
+ * `generate` body; only the import paths differ (relative package-internal here, the
+ * public `@metaobjectsdev/codegen-ts` barrel there).
+ *
+ * Deliberately a SEPARATE generator, never a boolean on the entity generator — a new
+ * artifact is a MINOR under docs/compatibility-policy.md and adds zero bytes to existing
+ * files, where a flag would move every $table-carrying golden for the same functionality.
+ */
+export declare function namesFile(): Generator;
+//# sourceMappingURL=names-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"names-file.d.ts","sourceRoot":"","sources":["../../src/generators/names-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAA2B,MAAM,iBAAiB,CAAC;AAM1E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,IAAI,SAAS,CA6ErC"}

package/dist/generators/names-file.js

@@ -0,0 +1,95 @@
+import { entityOutputPath, crossEntitySpecifier } from "../import-path.js";
+import { renderNamesDecl } from "../templates/names-decl.js";
+import { namesArtifactSuperOf, resolveObjectNames } from "../names.js";
+/**
+ * §A1/§A2/§A6 — `<Entity>Names`: the physical database names for one object, as constants a
+ * hand-written consumer references instead of a string literal.
+ *
+ * This is the built-in twin of `src/reference/names.ts` (ADR-0034 scaffold-and-own —
+ * `meta init` copies the reference file into the adopter's repo; this one stays the
+ * engine's internal composer and the reference-byte-identical gate's other half). Same
+ * `generate` body; only the import paths differ (relative package-internal here, the
+ * public `@metaobjectsdev/codegen-ts` barrel there).
+ *
+ * Deliberately a SEPARATE generator, never a boolean on the entity generator — a new
+ * artifact is a MINOR under docs/compatibility-policy.md and adds zero bytes to existing
+ * files, where a flag would move every $table-carrying golden for the same functionality.
+ */
+export function namesFile() {
+    return {
+        name: "names",
+        // §A6 — the marker the runner aggregates into ResolvedGenConfig.includeNames, so the
+        // entity generator can tell whether this artifact will exist. Exactly the mechanism
+        // routesFileHono already uses via emitsHonoRoutes/includeHonoRoutes.
+        emitsNames: true,
+        generate: (ctx) => {
+            const layout = ctx.config.outputLayout ?? "flat";
+            const extStyle = ctx.config.extStyle ?? "js";
+            // The strategy lives on the RENDER CONTEXT, not on ResolvedGenConfig — `ctx.config`
+            // carries outDir/extStyle/dbImport/dialect and nothing about naming.
+            const strategy = ctx.renderContext?.columnNamingStrategy;
+            const pathOf = (obj) => 
+            // entityOutputPath, not a bare filename: §A6 makes the entity module IMPORT these
+            // constants, so the artifact has to land in the same directory the entity module
+            // does. Under outputLayout: "package" a bare name puts it at the target ROOT while
+            // its entity sits at <pkg>/<Entity>.ts — an unresolvable import, and a hard
+            // conflicting-duplicate-path failure as soon as two packages declare a
+            // same-bare-named entity.
+            entityOutputPath(layout, obj.package, `${obj.name}.names.ts`);
+            const superSpecifierFor = (obj) => {
+                const sup = namesArtifactSuperOf(obj);
+                return sup === undefined
+                    ? undefined
+                    : crossEntitySpecifier(layout, obj.package, sup.package, `${sup.name}.names`, extStyle);
+            };
+            const out = [];
+            // Pass 1 — every matched object that participates in the database (#248).
+            // `emitted` tracks what pass 1 actually WROTE, not what it looked at: a matched
+            // abstract base emits nothing here, and seeding it as already-emitted is what would
+            // make pass 2 skip the very object it exists to produce.
+            const emitted = new Set();
+            const participants = ctx.entities.filter(ctx.matches);
+            for (const entity of participants) {
+                const content = renderNamesDecl(entity, {
+                    strategy, superSpecifier: superSpecifierFor(entity),
+                });
+                if (content === "")
+                    continue; // no primary source ⇒ no names artifact (#248)
+                emitted.add(entity.resolutionKey());
+                out.push({ path: pathOf(entity), content });
+            }
+            // Pass 2 — the abstract bases those participants EXTEND. Each carries the columns it
+            // declares, so a child states them once rather than restating its parent's.
+            //
+            // Reached by walking UP from a participant, never by scanning for abstracts: that is
+            // what keeps #248 intact. A sourceless object nothing persistable extends — an
+            // `object.value`, say — is not reached, so it acquires no artifact and no phantom
+            // participation. Two children of one base both reach it and emit the same file at
+            // the same path with the same bytes; the runner collapses byte-identical duplicates
+            // (#266), so it is written once. `emitted` keeps that from even arising, and keeps
+            // the walk from re-rendering the same base once per child.
+            for (const entity of participants) {
+                if (resolveObjectNames(entity, strategy) === undefined)
+                    continue;
+                for (let sup = namesArtifactSuperOf(entity); sup !== undefined; sup = namesArtifactSuperOf(sup)) {
+                    const key = sup.resolutionKey();
+                    if (emitted.has(key))
+                        break; // already emitted, and so is everything above it
+                    emitted.add(key);
+                    // `fragment` says "this is an ancestor render", not which shape to render:
+                    // `renderNamesDecl` derives that from the object itself, so a TPH base reached
+                    // by this walk keeps the shared table it owns. Deciding it there rather than
+                    // here is what makes the EJECTED copy of this generator correct too.
+                    const content = renderNamesDecl(sup, {
+                        strategy, superSpecifier: superSpecifierFor(sup), fragment: true,
+                    });
+                    if (content === "")
+                        continue;
+                    out.push({ path: pathOf(sup), content });
+                }
+            }
+            return out;
+        },
+    };
+}
+//# sourceMappingURL=names-file.js.map

package/dist/generators/names-file.js.map

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

package/dist/generators/requirements-markdown.d.ts

@@ -6,5 +6,22 @@ import type { RequirementRow } from "./requirements-view.js";
  * The generator keys on that to emit no file at all, which is in turn what lets the
  * surface default to on without changing output for any project lacking a ledger.
  */
-export declare function renderRequirementsMarkdown(rows: readonly RequirementRow[]): string;
+export interface RequirementsMarkdownOpts {
+    /**
+     * Render the ledger as a SECTION of a larger page rather than as the page.
+     *
+     * The `agent/requirements.md` surface carries this ledger under its own `## The ledger`
+     * heading, and an embedded copy that keeps its `# Requirements` title gives the page two
+     * H1s and reparents every entry as a sibling of the section that contains it — the
+     * document silently loses its outline. So the title is dropped and every heading moves
+     * down one level.
+     *
+     * A POST-HOC REGEX OVER THIS FUNCTION'S OUTPUT would do the same thing and would be the
+     * wrong shape: heading depth is this renderer's decision (it already caps at h6), and a
+     * caller rewriting it from outside would have to re-derive that cap and would drift from
+     * it the next time this file changes.
+     */
+    readonly embedded?: boolean;
+}
+export declare function renderRequirementsMarkdown(rows: readonly RequirementRow[], opts?: RequirementsMarkdownOpts): string;
 //# sourceMappingURL=requirements-markdown.d.ts.map

package/dist/generators/requirements-markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requirements-markdown.d.ts","sourceRoot":"","sources":["../../src/generators/requirements-markdown.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA8D7D;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAUlF"}
+{"version":3,"file":"requirements-markdown.d.ts","sourceRoot":"","sources":["../../src/generators/requirements-markdown.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA8D7D;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,SAAS,cAAc,EAAE,EAC/B,IAAI,CAAC,EAAE,wBAAwB,GAC9B,MAAM,CAuBR"}

package/dist/generators/requirements-markdown.js

@@ -76,22 +76,24 @@ function renderOne(r) {
     }
     return out.join("\n");
 }
-/**
- * Render the ledger as one markdown index.
- *
- * Returns the EMPTY STRING for an empty ledger rather than a headed-but-empty page.
- * The generator keys on that to emit no file at all, which is in turn what lets the
- * surface default to on without changing output for any project lacking a ledger.
- */
-export function renderRequirementsMarkdown(rows) {
+export function renderRequirementsMarkdown(rows, opts) {
     if (rows.length === 0)
         return "";
+    const body = rows.map(renderOne);
+    if (opts?.embedded === true) {
+        return [
+            `${rows.length} declared requirement${rows.length === 1 ? "" : "s"}, in declaration order.`,
+            "",
+            // One extra `#` on every heading line, capped at h6 exactly as `heading()` caps.
+            ...body.map((entry) => entry.replace(/^(#{1,6}) /gm, (_m, hashes) => `${"#".repeat(Math.min(hashes.length + 1, 6))} `)),
+        ].join("\n");
+    }
     return [
         "# Requirements",
         "",
         `${rows.length} declared requirement${rows.length === 1 ? "" : "s"}, in declaration order.`,
         "",
-        ...rows.map(renderOne),
+        ...body,
     ].join("\n");
 }
 //# sourceMappingURL=requirements-markdown.js.map

package/dist/generators/requirements-markdown.js.map

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

package/dist/generators/routes-file-hono.d.ts

@@ -1,7 +1,18 @@
 import type { MetaObject } from "@metaobjectsdev/metadata";
 import { type GeneratorFactory } from "../generator.js";
+import { type ExposeOption } from "../routes-expose.js";
 export interface RoutesFileHonoOpts {
     filter?: (entity: MetaObject) => boolean;
+    /**
+     * Which CRUD verbs the emitted file mounts (#348). Verbs, or a per-entity function;
+     * absent means all five and emits byte-identical output.
+     *
+     *   routesFileHono({ expose: (e) => e.name === "AuditEntry" ? ["list", "get"] : undefined })
+     *
+     * A `filter` cannot express this — it decides whether the file emits AT ALL, so it can
+     * only remove the whole surface, not restrict it to a subset of verbs.
+     */
+    expose?: ExposeOption;
     target?: string;
 }
 /**
@@ -14,8 +25,12 @@ export interface RoutesFileHonoOpts {
  * consumers running Hono can replace hand-written route registration with
  * this generator output one entity at a time.
  *
- * Per-entity opt-out via `@emitRoutes: false` is honored. If the user
- * supplies their own filter, both must pass (AND).
+ * If the user supplies their own filter, it AND-composes with the built-in gates.
+ *
+ * Decide per generator what you consume: wire only the generators whose output you
+ * actually import, and narrow this one with its `filter` option. There is no `@emit*`
+ * metadata attribute — those were never registered vocabulary, so `meta verify` rejects
+ * them (ERR_UNKNOWN_ATTR).
  *
  * #248 R2: an object with no declared/inherited source.rdb (of ANY kind) isn't
  * backed by any store — gated by `hasAnyRdbSource` (does NOT add TPH handling;

package/dist/generators/routes-file-hono.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes-file-hono.d.ts","sourceRoot":"","sources":["../../src/generators/routes-file-hono.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAQnF,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,EA2DtB,gBAAgB,CAAC,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"routes-file-hono.d.ts","sourceRoot":"","sources":["../../src/generators/routes-file-hono.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMnF,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,cAAc,EAsDtB,gBAAgB,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/generators/routes-file-hono.js

@@ -3,8 +3,8 @@ import { renderRoutesFileHono } from "../templates/routes-file-hono.js";
 import { hasAnyRdbSource } from "../source-detect.js";
 import { formatTs } from "../format.js";
 import { entityOutputPath } from "../import-path.js";
-import { CODEGEN_ATTR_EMIT_ROUTES } from "../constants.js";
 import { isTphSubtype } from "../templates/zod-validators.js";
+import { resolveExpose } from "../routes-expose.js";
 /**
  * Hono variant of routesFile() — emits `<Entity>.routes.hono.ts` mounting
  * the same five CRUD verbs (GET list / GET :id / POST / PATCH+PUT / DELETE)
@@ -15,8 +15,12 @@ import { isTphSubtype } from "../templates/zod-validators.js";
  * consumers running Hono can replace hand-written route registration with
  * this generator output one entity at a time.
  *
- * Per-entity opt-out via `@emitRoutes: false` is honored. If the user
- * supplies their own filter, both must pass (AND).
+ * If the user supplies their own filter, it AND-composes with the built-in gates.
+ *
+ * Decide per generator what you consume: wire only the generators whose output you
+ * actually import, and narrow this one with its `filter` option. There is no `@emit*`
+ * metadata attribute — those were never registered vocabulary, so `meta verify` rejects
+ * them (ERR_UNKNOWN_ATTR).
  *
  * #248 R2: an object with no declared/inherited source.rdb (of ANY kind) isn't
  * backed by any store — gated by `hasAnyRdbSource` (does NOT add TPH handling;
@@ -28,18 +32,12 @@ export const routesFileHono = function routesFileHono(opts) {
     // below cannot drift apart. They differ only by `!isTphSubtype` vs `isTphSubtype`, and
     // written out twice a later edit to one silently makes an entity either stop emitting
     // without being named as held back, or get warned about while still emitting.
-    const passesOtherGates = (e) => 
-    // ADR-0039: resolving — a concrete entity may inherit @emitRoutes via extends.
-    e.attr(CODEGEN_ATTR_EMIT_ROUTES) !== false
-        && hasAnyRdbSource(e)
-        && userFilter(e);
+    const passesOtherGates = (e) => hasAnyRdbSource(e) && userFilter(e);
     const generator = {
         name: "routes-file-hono",
         // Marks this as the Hono routes generator so the runner can aggregate
         // `ctx.config.includeHonoRoutes` and api-docs auto-documents the Hono surface.
         emitsHonoRoutes: true,
-        // ADR-0039: resolving — a concrete entity may inherit @emitRoutes via extends.
-        //
         // TPH subtypes are EXCLUDED, matching the Fastify generator. A TPH subtype shares
         // its base's table, so mounting vanilla CRUD for it produced routes with no
         // discriminator scoping at all: the list returned EVERY subtype's rows, and
@@ -68,7 +66,7 @@ export const routesFileHono = function routesFileHono(opts) {
         }
         return {
             path: entityOutputPath(ctx.config.outputLayout ?? "flat", entity.package, `${entity.name}.routes.hono.ts`),
-            content: await formatTs(renderRoutesFileHono(entity, ctx.renderContext)),
+            content: await formatTs(renderRoutesFileHono(entity, ctx.renderContext, resolveExpose(entity, opts?.expose))),
         };
     });
     if (opts?.target) {

package/dist/generators/routes-file-hono.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes-file-hono.js","sourceRoot":"","sources":["../../src/generators/routes-file-hono.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"routes-file-hono.js","sourceRoot":"","sources":["../../src/generators/routes-file-hono.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAyC,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAqB,MAAM,qBAAqB,CAAC;AAiBvE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,cAAc,CAAC,IAAyB;IAC7E,MAAM,UAAU,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChD,qFAAqF;IACrF,uFAAuF;IACvF,sFAAsF;IACtF,8EAA8E;IAC9E,MAAM,gBAAgB,GAAG,CAAC,CAAa,EAAW,EAAE,CAClD,eAAe,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,kBAAkB;QACxB,sEAAsE;QACtE,+EAA+E;QAC/E,eAAe,EAAE,IAAI;QACrB,kFAAkF;QAClF,4EAA4E;QAC5E,4EAA4E;QAC5E,2EAA2E;QAC3E,iFAAiF;QACjF,iFAAiF;QACjF,gFAAgF;QAChF,gEAAgE;QAChE,MAAM,EAAE,CAAC,CAAa,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAClE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACtB,gFAAgF;YAChF,6EAA6E;YAC7E,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YACnF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,GAAG,CAAC,IAAI,CACN,iDAAiD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;oBAC3F,+EAA+E;oBAC/E,4EAA4E;oBAC5E,4DAA4D,CAC7D,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;KACF,CAAC;IACF,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QACzC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO;YACL,IAAI,EAAE,gBAAgB,CACpB,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,EACjC,MAAM,CAAC,OAAO,EACd,GAAG,MAAM,CAAC,IAAI,iBAAiB,CAChC;YACD,OAAO,EAAE,MAAM,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;SAC9G,CAAC;IACN,CAAC,CAAC,CAAC;IACH,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAyC,CAAC"}

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

@@ -1,12 +1,27 @@
 import type { MetaObject } from "@metaobjectsdev/metadata";
 import { type GeneratorFactory } from "../generator.js";
+import { type ExposeOption } from "../routes-expose.js";
 export interface RoutesFileOpts {
     filter?: (entity: MetaObject) => boolean;
+    /**
+     * Which CRUD verbs the emitted file mounts (#348). Verbs, or a per-entity function;
+     * absent means all five and emits byte-identical output.
+     *
+     *   routesFile({ expose: (e) => e.name === "AuditEntry" ? ["list", "get"] : undefined })
+     *
+     * A `filter` cannot express this — it decides whether the file emits AT ALL, so it can
+     * only remove the whole surface, not restrict it to a subset of verbs.
+     */
+    expose?: ExposeOption;
     target?: string;
 }
 /**
- * Per-entity opt-out via `@emitRoutes: false` is honored. If the user supplies
- * their own filter, both must pass (AND).
+ * If the user supplies their own filter, it AND-composes with the built-in gates.
+ *
+ * Decide per generator what you consume: wire only the generators whose output you
+ * actually import, and narrow this one with its `filter` option. There is no `@emit*`
+ * metadata attribute — those were never registered vocabulary, so `meta verify` rejects
+ * them (ERR_UNKNOWN_ATTR).
  *
  * #248 R2: an object with no declared/inherited source.rdb (of ANY kind) isn't
  * backed by any store — routes against it would import Drizzle table/allowlist

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

@@ -1 +1 @@
-{"version":3,"file":"routes-file.d.ts","sourceRoot":"","sources":["../../src/generators/routes-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAQnF,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAsBlB,gBAAgB,CAAC,cAAc,CAAC,CAAC"}
+{"version":3,"file":"routes-file.d.ts","sourceRoot":"","sources":["../../src/generators/routes-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMnF,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU,EAqBlB,gBAAgB,CAAC,cAAc,CAAC,CAAC"}

package/dist/generators/routes-file.js

@@ -4,10 +4,14 @@ import { isTphSubtype } from "../templates/zod-validators.js";
 import { hasAnyRdbSource } from "../source-detect.js";
 import { formatTs } from "../format.js";
 import { entityOutputPath } from "../import-path.js";
-import { CODEGEN_ATTR_EMIT_ROUTES } from "../constants.js";
+import { resolveExpose } from "../routes-expose.js";
 /**
- * Per-entity opt-out via `@emitRoutes: false` is honored. If the user supplies
- * their own filter, both must pass (AND).
+ * If the user supplies their own filter, it AND-composes with the built-in gates.
+ *
+ * Decide per generator what you consume: wire only the generators whose output you
+ * actually import, and narrow this one with its `filter` option. There is no `@emit*`
+ * metadata attribute — those were never registered vocabulary, so `meta verify` rejects
+ * them (ERR_UNKNOWN_ATTR).
  *
  * #248 R2: an object with no declared/inherited source.rdb (of ANY kind) isn't
  * backed by any store — routes against it would import Drizzle table/allowlist
@@ -20,17 +24,15 @@ export const routesFile = function routesFile(opts) {
     const userFilter = opts?.filter ?? (() => true);
     const generator = {
         name: "routes-file",
-        // Always set: AND-composes metadata opt-out with optional user filter.
-        filter: (e) => 
-        // ADR-0039: resolving — a concrete entity may inherit its @emit* opt-out flag via extends.
-        e.attr(CODEGEN_ATTR_EMIT_ROUTES) !== false && hasAnyRdbSource(e) && !isTphSubtype(e) && userFilter(e),
+        // Always set: AND-composes the built-in gates with the optional user filter.
+        filter: (e) => hasAnyRdbSource(e) && !isTphSubtype(e) && userFilter(e),
         generate: perEntity(async (entity, ctx) => {
             if (!ctx.renderContext) {
                 throw new Error("routes-file: renderContext is required (provided by runGen)");
             }
             return {
                 path: entityOutputPath(ctx.config.outputLayout ?? "flat", entity.package, `${entity.name}.routes.ts`),
-                content: await formatTs(renderRoutesFile(entity, ctx.renderContext)),
+                content: await formatTs(renderRoutesFile(entity, ctx.renderContext, resolveExpose(entity, opts?.expose))),
             };
         }),
     };

package/dist/generators/routes-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes-file.js","sourceRoot":"","sources":["../../src/generators/routes-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAyC,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAO3D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,UAAU,CAAC,IAAqB;IACjE,MAAM,UAAU,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,aAAa;QACnB,uEAAuE;QACvE,MAAM,EAAE,CAAC,CAAa,EAAE,EAAE;QACxB,2FAA2F;QAC3F,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,KAAK,KAAK,IAAI,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC;QACvG,QAAQ,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YACxC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;YACjF,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,YAAY,CAAC;gBACrG,OAAO,EAAE,MAAM,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;aACrE,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;IACF,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAqC,CAAC"}
+{"version":3,"file":"routes-file.js","sourceRoot":"","sources":["../../src/generators/routes-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAyC,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAqB,MAAM,qBAAqB,CAAC;AAiBvE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,UAAU,CAAC,IAAqB;IACjE,MAAM,UAAU,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,aAAa;QACnB,6EAA6E;QAC7E,MAAM,EAAE,CAAC,CAAa,EAAE,EAAE,CACxB,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC;QACzD,QAAQ,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YACxC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;YACjF,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,YAAY,CAAC;gBACrG,OAAO,EAAE,MAAM,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;aAC1G,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;IACF,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAqC,CAAC"}

package/dist/generators/template-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-generator.d.ts","sourceRoot":"","sources":["../../src/generators/template-generator.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAU,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,KAAK,EAAsC,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAU5F;6CAC6C;AAC7C,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC;qEACiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC;iCAC6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb;;;;oFAIgF;IAChF,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAChF;;+EAE2E;IAC3E,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;+EAC2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;uEAEmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB;;8EAE0E;IAC1E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC;;;;;uDAKmD;IACnD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAkCD,eAAO,MAAM,iBAAiB,EAyDzB,gBAAgB,CAAC,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"template-generator.d.ts","sourceRoot":"","sources":["../../src/generators/template-generator.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAU,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,KAAK,EAAsC,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAU5F;6CAC6C;AAC7C,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC;qEACiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC;iCAC6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb;;;;oFAIgF;IAChF,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAChF;;+EAE2E;IAC3E,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;+EAC2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;uEAEmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB;;8EAE0E;IAC1E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC;;;;;uDAKmD;IACnD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAkCD,eAAO,MAAM,iBAAiB,EAyDzB,gBAAgB,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/generators/template-generator.js

@@ -5,13 +5,27 @@
 // generators; just adds the "Mustache template" + "walk that yields a
 // data dict per output" primitives.
 //
-// Design line we adopted (from the design doc):
-//   Code → hand-coded generators (ts-poet, idiomatic per-port).
-//   Documents → templateGenerator (shared Mustache templates).
+// SUPERSEDED, and left here as a correction because the old line still circulates:
+// the original 2026-05-28 split was "Code → hand-coded generators, Documents →
+// templateGenerator", with code emission an explicit NON-GOAL for this primitive.
+// SP-1 (docs/superpowers/specs/2026-06-28-mustache-codegen-parity-design.md §2)
+// moved past it — its goal is a consumer authoring "a working code generator, on ANY
+// port, with NO generator code", and its worked outputPattern is
+// "{package}/{name}Service.java". Source, not a document.
 //
-// docsFile() is the first templateGenerator instance (rc.12). OpenAPI specs,
-// Mermaid diagrams, HTML doc sites, etc. follow as templates + a walk
-// function each.
+// The axis is NOT what kind of file comes out. It is: pick a template when the output
+// SHAPE is what you are iterating on, or when you want the same output across
+// languages (that is what the neutral data dict buys); pick a hand-coded generator
+// when the logic is gnarly or the run is hot. Tradeoff table:
+// docs/features/codegen-concepts.md §3.
+//
+// This matters most where a port has no choice: C# and Python expose closed built-in
+// generator registries, so the declarative spec is the ONLY consumer authoring path
+// there — and a documents-only reading of this primitive would tell those adopters
+// their port cannot emit a custom shape at all.
+//
+// docsFile() is the first templateGenerator instance (rc.12), which is why the
+// documents framing stuck; it is the first instance, not the boundary.
 import { render } from "@metaobjectsdev/render";
 import { projectProvider } from "../render-engine/framework-provider.js";
 import { expandOutputPattern } from "../template-codegen/output-pattern.js";

package/dist/generators/template-generator.js.map

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

package/dist/index.d.ts

@@ -10,8 +10,10 @@ export type { TemplateSpecEntry, TemplateSpecFile } from "./template-codegen/tem
 export type { TemplateScope } from "./generators/template-generator.js";
 export { generatorRegistry, listGenerators, getGenerator, } from "./generator-registry.js";
 export type { GeneratorRegistryEntry, GeneratorTier } from "./generator-registry.js";
-export type { MetaobjectsGenConfig, NormalizedMetaobjectsGenConfig, ResolvedGenConfig, Dialect, ExtStyle, ColumnNamingStrategy, MetaDataTypeProvider, GeneratorSpec, DocsConfig, ResolvedDocsConfig, DocsSurface, ApiSurface } from "./metaobjects-config.js";
+export type { MetaobjectsGenConfig, NormalizedMetaobjectsGenConfig, ResolvedGenConfig, Dialect, ExtStyle, ColumnNamingStrategy, MetaDataTypeProvider, GeneratorSpec, DocsConfig, ResolvedDocsConfig, DocsSurface, ApiSurface, VerifyConfig } from "./metaobjects-config.js";
 export { defineConfig, normalizeConfig, resolveGenerators, resolveDocsConfig } from "./metaobjects-config.js";
+export { DEFAULT_DIALECT } from "./metaobjects-config.js";
+export { dbEmittingObjects, missingDialectMessage } from "./db-emitting.js";
 export { apiLabel } from "./generators/api-label.js";
 export type { ColumnSpec, DefaultExpr } from "./column-mapper.js";
 export { mapColumnType } from "./column-mapper.js";
@@ -25,7 +27,8 @@ export type { WriteStatus, WriteResult, MergeStrategy, BaselineMode, DecideAndWr
 export { decideAndWrite, GitMissingError } from "./overwrite-policy.js";
 export { contentHash, readGeneratedHash, listGeneratedPaths } from "./overwrite-policy.js";
 export { CodegenError } from "./errors.js";
-export { GENERATED_HEADER, EXTRA_SUFFIX, DEFAULT_OUT_DIR, CODEGEN_ATTR_EMIT_TANSTACK, CODEGEN_ATTR_EMIT_GRID, CODEGEN_ATTR_EMIT_FORM, CODEGEN_ATTR_EMIT_ROUTES } from "./constants.js";
+export { GENERATED_HEADER, DEFAULT_OUT_DIR, RETIRED_CODEGEN_ATTRS, type RetiredCodegenAttr } from "./constants.js";
+export { warnRetiredCodegenAttrs } from "./retired-codegen-attrs.js";
 export { formatTs } from "./format.js";
 export { pluralize, columnNameFromField, tableNameFromEntity, viewNameFromProjection } from "./naming.js";
 export { packageToPath, entityOutputPath, crossEntitySpecifier, barrelEntrySpecifier, relativeModuleSpecifier, entityModuleSpecifier, siblingSpecifier, barrelModuleSpecifier } from "./import-path.js";
@@ -34,11 +37,14 @@ export { docPageOutputPath, docPageHref, docPageNode, effectivePackage, assertNo
 export type { DocPageNode, DocPagePlacement } from "./docs-paths.js";
 export { isProjection, isWriteThrough } from "./projection/projection-detector.js";
 export { isAbstract, emitsInstanceArtifacts, emitsWriteArtifacts } from "./instance-artifacts.js";
-export { servesReadApi, servesWriteApi } from "./api-surface.js";
+export { hasGeneratedForm, restPath, servesReadApi, servesWriteApi } from "./api-surface.js";
+export { viewForContext, VIEW_CONTEXT_FORM, VIEW_CONTEXT_GRID } from "./view-context.js";
+export { humanize, inferViewKind, labelFor, currencyMetaFor, valueObjectFor } from "./templates/field-meta.js";
 export { renderEntityMetaFile, entityMetaFileName, entityMetaSpecifier } from "./templates/entity-meta-file.js";
 export { isTphDiscriminatorBase, tphConcreteSubtypes, collectTphSubtypeFields, tphPlan, tphRouteSegment } from "./templates/tph-discriminator.js";
 export type { TphPlan, TphSubtypePlan } from "./templates/tph-discriminator.js";
-export { isTphSubtype, tphDiscriminatorPin } from "./templates/zod-validators.js";
+export { isTphSubtype, tphDiscriminatorBase, tphDiscriminatorPin } from "./templates/zod-validators.js";
+export { isSortableField, sortableFields } from "./templates/filter-shared.js";
 export { renderTphDiscriminatorUnion } from "./templates/tph-discriminator.js";
 export { hasWritableRdbSource, hasAnyRdbSource } from "./source-detect.js";
 export { renderSharedEnumsFile, SHARED_ENUMS_BASENAME } from "./templates/enums-file.js";
@@ -46,7 +52,8 @@ export { resolveReferenceRoot, readReferenceTemplate, REFERENCE_GENERATOR_NAMES,
 export type { ReferenceGeneratorName } from "./reference-templates.js";
 export { code, imp, joinCode } from "ts-poet";
 export type { Code } from "ts-poet";
-export { renderFindByIdFn, renderListFn, renderCreateFn, renderUpdateFn, renderDeleteByIdFn, renderReverseFinderFns, reverseFksFor, getPkInfo, } from "./templates/queries.js";
+export { renderFindByIdFn, renderListFn, renderCreateFn, renderInsertPreservingFn, renderUpdateFn, renderDeleteByIdFn, renderReverseFinderFns, reverseFksFor, getPkInfo, } from "./templates/queries.js";
+export { hasAutoSetFields } from "./templates/zod-validators.js";
 export { renderEntityFile } from "./templates/entity-file.js";
 export type { RenderEntityFileOpts } from "./templates/entity-file.js";
 export { renderZodValidators } from "./templates/zod-validators.js";
@@ -58,9 +65,14 @@ export { renderFilterType } from "./templates/filter-type.js";
 export { renderFilterAllowlist, renderSortAllowlist } from "./templates/filter-allowlist.js";
 export { renderEntityConstants, resourcePath } from "./templates/entity-constants.js";
 export { renderQueriesFile } from "./templates/queries-file.js";
+export { CRUD_VERBS, resolveExpose, intersectExpose, exposeLine } from "./routes-expose.js";
+export type { CrudVerb, ExposeOption } from "./routes-expose.js";
 export { renderRoutesFile } from "./templates/routes-file.js";
 export { renderRoutesFileHono } from "./templates/routes-file-hono.js";
 export { renderValueObjectFile } from "./templates/value-object-file.js";
+export { renderNamesDecl } from "./templates/names-decl.js";
+export type { NamesDeclOpts } from "./templates/names-decl.js";
+export { resolveObjectNames, resolveSuperFragmentNames, namesArtifactSuperOf, namesRef, namesConstArg, physicalNameExpr, columnExpr, type ObjectNames, type FieldNames, type SuperNames, } from "./names.js";
 export { renderProjectionDecl } from "./templates/projection-decl.js";
 export type { ProjectionDeclOpts } from "./templates/projection-decl.js";
 export { extractViewSpec } from "./projection/extract-view-spec.js";
@@ -79,6 +91,9 @@ export type { TemplateDocData, TemplateOutputPart } from "./generators/template-
 export { buildTemplateDocData } from "./generators/template-doc-builder.js";
 export { requirementTests } from "./generators/requirement-tests.js";
 export { requirementsFile } from "./generators/requirements-file.js";
+export { agentDocsFile } from "./generators/agent-docs-file.js";
+export type { AgentDocsFileOpts } from "./generators/agent-docs-file.js";
+export type { AgentSchemaInput, SchemaColumnLike, SchemaTableLike, SchemaViewLike, } from "./generators/agent-schema-input.js";
 export type { RequirementRow } from "./generators/requirements-view.js";
 export { requirementRows } from "./generators/requirements-view.js";
 export type { RequirementTestsOpts, RequirementTestRenderer, } from "./generators/requirement-tests.js";