@metaobjectsdev/codegen-ts 0.24.4 → 0.25.0

package/dist/reference-templates.js

@@ -11,34 +11,68 @@ import { existsSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 /** Basenames (no extension) of the copyable reference generators shipped in `src/reference/`. */
-export const REFERENCE_GENERATOR_NAMES = ["entity", "queries", "routes", "barrel"];
-/** A directory is the reference root iff it holds the entity reference template. */
-function isReferenceRoot(dir) {
-    return existsSync(join(dir, "entity.ts"));
+export const REFERENCE_GENERATOR_NAMES = ["entity", "queries", "routes", "routes-hono", "barrel", "names"];
+/** A directory is a reference root iff it holds the first template the reader was told to expect. */
+function isReferenceRoot(dir, sentinel) {
+    return existsSync(join(dir, `${sentinel}.ts`));
 }
 /**
- * Resolve the `src/reference/` directory holding the copyable reference generators.
- * Works in dev (this module runs from `src/`, templates at `./reference/`) and in a
- * published install (this module runs from `dist/`, templates at `../src/reference/`,
- * since `src/` ships alongside `dist/`). Walks up checking both layouts at each level.
+ * FR-040 §4.1 — build a reference-template reader for ONE package. `moduleUrl` is the
+ * calling module's `import.meta.url`, so each package resolves its OWN `src/reference/`.
+ * `names[0]` is the sentinel that identifies the directory.
+ *
+ * Works in dev (module runs from `src/`, templates at `./reference/`) and in a published
+ * install (module runs from `dist/`, templates at `../src/reference/`, since `src/` ships
+ * alongside `dist/`). Walks up checking both layouts at each level.
  */
-export function resolveReferenceRoot() {
-    let dir = dirname(fileURLToPath(import.meta.url));
-    for (let i = 0; i < 8; i++) {
-        for (const candidate of [join(dir, "reference"), join(dir, "src", "reference")]) {
-            if (isReferenceRoot(candidate))
-                return candidate;
+export function makeReferenceReader(moduleUrl, names) {
+    // A non-empty tuple type, so `names[0]` is `string` outright — this used to need a
+    // runtime empty-check plus a re-bound const, because `noUncheckedIndexedAccess`
+    // narrowing does not survive into the closures below. Every call site already passes
+    // an `as const` tuple or an array literal, so the type costs nothing and deletes both.
+    const sentinel = names[0];
+    function resolveReferenceRoot() {
+        let dir = dirname(fileURLToPath(moduleUrl));
+        for (let i = 0; i < 8; i++) {
+            for (const candidate of [join(dir, "reference"), join(dir, "src", "reference")]) {
+                if (isReferenceRoot(candidate, sentinel))
+                    return candidate;
+            }
+            const parent = dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
         }
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
+        throw new Error("reference templates not found — looked for `reference/` and `src/reference/` " +
+            `walking up from ${dir}.`);
     }
-    throw new Error("codegen-ts reference templates not found — looked for `reference/` and `src/reference/` " +
-        "walking up from the codegen-ts module.");
+    return {
+        resolveReferenceRoot,
+        /**
+         * Read one template by name. The name is checked against `names` FIRST: this is a
+         * public export, so `name` is an untrusted `string` at runtime (the per-package
+         * wrappers narrow to a literal union, but types are erased). Without the check it
+         * interpolates straight into a path, so any caller threading a CLI argument through
+         * reads whatever file the string points at. The allowlist is already a parameter —
+         * enforcing it here makes the guarantee structural instead of something every call
+         * site has to remember, and it is the reason `meta eject` needs no check of its own.
+         */
+        readReferenceTemplate: (name) => {
+            if (!names.includes(name)) {
+                throw new Error(`unknown reference template "${name}". Available: ${names.join(", ")}.`);
+            }
+            return readFileSync(join(resolveReferenceRoot(), `${name}.ts`), "utf8");
+        },
+    };
+}
+// This package's own reader — the back-compatible named exports `meta init` uses.
+const ownReader = makeReferenceReader(import.meta.url, REFERENCE_GENERATOR_NAMES);
+/** Resolve the `src/reference/` directory holding this package's reference generators. */
+export function resolveReferenceRoot() {
+    return ownReader.resolveReferenceRoot();
 }
 /** Read the raw source of one reference generator (e.g. `"entity"` → the text of `entity.ts`). */
 export function readReferenceTemplate(name) {
-    return readFileSync(join(resolveReferenceRoot(), `${name}.ts`), "utf8");
+    return ownReader.readReferenceTemplate(name);
 }
 //# sourceMappingURL=reference-templates.js.map

package/dist/reference-templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"reference-templates.js","sourceRoot":"","sources":["../src/reference-templates.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,sFAAsF;AACtF,wFAAwF;AACxF,sFAAsF;AACtF,qEAAqE;AACrE,EAAE;AACF,qFAAqF;AACrF,yFAAyF;AACzF,mFAAmF;AAEnF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,iGAAiG;AACjG,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAG5F,oFAAoF;AACpF,SAAS,eAAe,CAAC,GAAW;IAClC,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,KAAK,MAAM,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;YAChF,IAAI,eAAe,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC;QACnD,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CACb,0FAA0F;QACxF,wCAAwC,CAC3C,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,qBAAqB,CAAC,IAA4B;IAChE,OAAO,YAAY,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,GAAG,IAAI,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"reference-templates.js","sourceRoot":"","sources":["../src/reference-templates.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,sFAAsF;AACtF,wFAAwF;AACxF,sFAAsF;AACtF,qEAAqE;AACrE,EAAE;AACF,qFAAqF;AACrF,yFAAyF;AACzF,mFAAmF;AAEnF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,iGAAiG;AACjG,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAGpH,qGAAqG;AACrG,SAAS,eAAe,CAAC,GAAW,EAAE,QAAgB;IACpD,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,KAAqC;IAC1F,mFAAmF;IACnF,gFAAgF;IAChF,qFAAqF;IACrF,uFAAuF;IACvF,MAAM,QAAQ,GAAW,KAAK,CAAC,CAAC,CAAC,CAAC;IAElC,SAAS,oBAAoB;QAC3B,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;QAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,KAAK,MAAM,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;gBAChF,IAAI,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC;oBAAE,OAAO,SAAS,CAAC;YAC7D,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,MAAM,KAAK,GAAG;gBAAE,MAAM;YAC1B,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;QACD,MAAM,IAAI,KAAK,CACb,+EAA+E;YAC7E,mBAAmB,GAAG,GAAG,CAC5B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,oBAAoB;QACpB;;;;;;;;WAQG;QACH,qBAAqB,EAAE,CAAC,IAAY,EAAU,EAAE;YAC9C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACxE,CAAC;YACJ,CAAC;YACD,OAAO,YAAY,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,GAAG,IAAI,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1E,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAAC;AAElF,0FAA0F;AAC1F,MAAM,UAAU,oBAAoB;IAClC,OAAO,SAAS,CAAC,oBAAoB,EAAE,CAAC;AAC1C,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,qBAAqB,CAAC,IAA4B;IAChE,OAAO,SAAS,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/render-context.d.ts

@@ -46,12 +46,29 @@ export interface RenderContext {
      * doc comment on `MetaobjectsGenConfig.timestampMode` in metaobjects-config.ts.
      */
     timestampMode: "date" | "string";
+    /**
+     * Prepend `"use client";` to generated CLIENT artifacts (forms, hooks, grid
+     * columns, grid hooks). Defaults to false. A bundler-topology fact the adopter
+     * declares — see `MetaobjectsGenConfig.clientDirective` for why it is config
+     * rather than metadata, and why the default is off. FR-040 §6.4.
+     */
+    clientDirective: boolean;
     /** Path prefix applied to generated route registrations + hook fetch URLs. Defaults to "". */
     apiPrefix: string;
     /** Whether abstract entities emit their shape artifact (type-only interface / value-object file). Defaults to true. Instance/write artifacts are never emitted for abstract entities regardless. */
     emitAbstractShapes: boolean;
     /** Output layout mode: "flat" (default) — all files in outDir; "package" — sub-paths from entity metadata package. */
     outputLayout: OutputLayout;
+    /**
+     * §A6 — whether the run emits the `<Entity>Names` artifact (the runner aggregates the
+     * suite's `emitsNames` markers; `ctx.config.includeNames` carries the same fact for
+     * generators). A template may reference those constants ONLY when this is true: the
+     * names generator is opt-in under ADR-0034 scaffold-and-own, so an unconditional
+     * import would break every project that has not enabled it. Defaults to FALSE, which
+     * is what keeps output byte-identical for such a project — and for every bare-context
+     * caller (unit tests, generators invoked outside runGen).
+     */
+    includeNames: boolean;
     /**
      * Resolve an entity name to its Drizzle collection (table) variable name,
      * applying the project's pluralization config + per-entity overrides. Every
@@ -94,14 +111,16 @@ export interface RenderContext {
     providedEnumModule?: string;
 }
 /** Optional shape — `extStyle`, `omImport`, `columnNamingStrategy`, `apiPrefix`, `outputLayout`, and `packageOf` default if omitted. `packageOf` defaults to an empty Map (correct for flat layout; `runGen` always provides the real map). `collectionName` is built from `pluralizeCollections` + `collectionNameOverrides` (both default to always-pluralize). */
-export type RenderContextInput = Omit<RenderContext, "extStyle" | "omImport" | "columnNamingStrategy" | "timestampMode" | "apiPrefix" | "emitAbstractShapes" | "outputLayout" | "packageOf" | "valueObjectNames" | "valueObjectEmittedName" | "resolveValueObjectName" | "selfTarget" | "entityModuleTarget" | "collectionName"> & {
+export type RenderContextInput = Omit<RenderContext, "extStyle" | "omImport" | "columnNamingStrategy" | "timestampMode" | "clientDirective" | "apiPrefix" | "emitAbstractShapes" | "outputLayout" | "includeNames" | "packageOf" | "valueObjectNames" | "valueObjectEmittedName" | "resolveValueObjectName" | "selfTarget" | "entityModuleTarget" | "collectionName"> & {
     extStyle?: ExtStyle;
     omImport?: string;
     columnNamingStrategy?: ColumnNamingStrategy;
     timestampMode?: "date" | "string";
+    clientDirective?: boolean;
     apiPrefix?: string;
     emitAbstractShapes?: boolean;
     outputLayout?: OutputLayout;
+    includeNames?: boolean;
     packageOf?: Map<string, string | undefined>;
     /** ADR-0044/#228 value-object emitted-name map (resolutionKey → emitted name).
      *  Defaults to an empty Map — bare names, byte-identical to pre-#228 output.

package/dist/render-context.d.ts.map

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

package/dist/render-context.js

@@ -63,9 +63,11 @@ export function makeRenderContext(opts) {
         // a unit test or a generator invoked outside `runGen`, must get the same
         // safe-no-op guarantee). See MetaobjectsGenConfig.timestampMode's doc comment.
         timestampMode: opts.dialect === "sqlite" ? "string" : (opts.timestampMode ?? "string"),
+        clientDirective: opts.clientDirective ?? false,
         apiPrefix: opts.apiPrefix ?? "",
         emitAbstractShapes: opts.emitAbstractShapes ?? true,
         outputLayout,
+        includeNames: opts.includeNames ?? false,
         packageOf: opts.packageOf ?? new Map(),
         valueObjectNames,
         valueObjectEmittedName: (obj) => valueObjectNames.get(obj.resolutionKey()) ?? obj.name,

package/dist/render-context.js.map

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

package/dist/retired-codegen-attrs.d.ts

@@ -0,0 +1,32 @@
+import type { MetaObject } from "@metaobjectsdev/metadata";
+/**
+ * `@emitRoutes` / `@emitTanstack` / `@emitForm` / `@emitGrid` / `@emitAngular` were read
+ * off metadata by generator filters and were never registered metamodel vocabulary. Under
+ * the strict loader — which is what `meta verify` runs — every one of them is
+ * `ERR_UNKNOWN_ATTR`, while `meta gen` loads non-strict and honoured them. That is the
+ * defect: an adopter who authored the documented opt-out got working suppression AND a red
+ * `meta verify`, with nothing connecting the two.
+ *
+ * The reads are gone (see constants.ts for why registering them was refused rather than
+ * the other way round). But a project can be sitting on a WORKING `@emitRoutes: false`
+ * today, and deleting the read alone would start writing that suppressed file with no
+ * explanation — a silent behaviour change on upgrade, which is the one outcome not open
+ * to us. So the run says it.
+ *
+ * This follows the `layout.dataGrid` precedent (#287, data-grid-gate.ts) and the prompt
+ * generator gate beside it: tell the adopter at `meta gen` time rather than in a doc line
+ * that gets missed the same way the original one was. Warning only — the exit code is
+ * untouched, and `--dry-run` reports it too, since generators run before the write phase
+ * branches.
+ *
+ * It lives in the RUNNER, not in a generator, for two reasons. It is a model-level
+ * observation, so it must fire exactly ONCE per run rather than once per generator that
+ * happens to be wired; and the attribute is equally stale whether or not the generator it
+ * used to suppress is wired at all, so a generator-local check would go quiet in exactly
+ * the project that dropped the generator and kept the attribute.
+ *
+ * Self-extinguishing: removing the attribute from the metadata silences it forever. That
+ * is also the fix, since the same edit is what makes `meta verify` pass.
+ */
+export declare function warnRetiredCodegenAttrs(entities: readonly MetaObject[], warn: (msg: string) => void): void;
+//# sourceMappingURL=retired-codegen-attrs.d.ts.map

package/dist/retired-codegen-attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retired-codegen-attrs.d.ts","sourceRoot":"","sources":["../src/retired-codegen-attrs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC1B,IAAI,CAgBN"}

package/dist/retired-codegen-attrs.js

@@ -0,0 +1,47 @@
+import { RETIRED_CODEGEN_ATTRS } from "./constants.js";
+/**
+ * `@emitRoutes` / `@emitTanstack` / `@emitForm` / `@emitGrid` / `@emitAngular` were read
+ * off metadata by generator filters and were never registered metamodel vocabulary. Under
+ * the strict loader — which is what `meta verify` runs — every one of them is
+ * `ERR_UNKNOWN_ATTR`, while `meta gen` loads non-strict and honoured them. That is the
+ * defect: an adopter who authored the documented opt-out got working suppression AND a red
+ * `meta verify`, with nothing connecting the two.
+ *
+ * The reads are gone (see constants.ts for why registering them was refused rather than
+ * the other way round). But a project can be sitting on a WORKING `@emitRoutes: false`
+ * today, and deleting the read alone would start writing that suppressed file with no
+ * explanation — a silent behaviour change on upgrade, which is the one outcome not open
+ * to us. So the run says it.
+ *
+ * This follows the `layout.dataGrid` precedent (#287, data-grid-gate.ts) and the prompt
+ * generator gate beside it: tell the adopter at `meta gen` time rather than in a doc line
+ * that gets missed the same way the original one was. Warning only — the exit code is
+ * untouched, and `--dry-run` reports it too, since generators run before the write phase
+ * branches.
+ *
+ * It lives in the RUNNER, not in a generator, for two reasons. It is a model-level
+ * observation, so it must fire exactly ONCE per run rather than once per generator that
+ * happens to be wired; and the attribute is equally stale whether or not the generator it
+ * used to suppress is wired at all, so a generator-local check would go quiet in exactly
+ * the project that dropped the generator and kept the attribute.
+ *
+ * Self-extinguishing: removing the attribute from the metadata silences it forever. That
+ * is also the fix, since the same edit is what makes `meta verify` pass.
+ */
+export function warnRetiredCodegenAttrs(entities, warn) {
+    for (const { name, replacement } of RETIRED_CODEGEN_ATTRS) {
+        // ADR-0039: resolving — an INHERITED flag suppressed emission exactly as an own one
+        // did, so an own-only read here would leave the inheriting adopter unwarned while
+        // their output silently changed. `hasAttr` rather than a value comparison: an
+        // `@emitForm: true` was a no-op that still fails `meta verify`, so it is just as
+        // stale as the `false` that did something.
+        const carriers = entities.filter((e) => e.hasAttr(name));
+        if (carriers.length === 0)
+            continue;
+        warn(`@${name} on ${carriers.map((e) => e.name).join(", ")} is no longer read by any ` +
+            `generator — it was never registered metamodel vocabulary, so \`meta verify\` ` +
+            `rejects it outright with ERR_UNKNOWN_ATTR. Decide per generator what you ` +
+            `consume: ${replacement}. Remove the attribute to silence this.`);
+    }
+}
+//# sourceMappingURL=retired-codegen-attrs.js.map

package/dist/retired-codegen-attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retired-codegen-attrs.js","sourceRoot":"","sources":["../src/retired-codegen-attrs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA+B,EAC/B,IAA2B;IAE3B,KAAK,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,qBAAqB,EAAE,CAAC;QAC1D,oFAAoF;QACpF,kFAAkF;QAClF,8EAA8E;QAC9E,iFAAiF;QACjF,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACpC,IAAI,CACF,IAAI,IAAI,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B;YAC/E,+EAA+E;YAC/E,2EAA2E;YAC3E,YAAY,WAAW,yCAAyC,CACnE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/routes-expose.d.ts

@@ -0,0 +1,63 @@
+import type { MetaObject } from "@metaobjectsdev/metadata";
+/**
+ * The five CRUD verbs a generated routes file can mount.
+ *
+ * Mirrors `CrudVerb` in `@metaobjectsdev/runtime-ts` — both the fastify and hono mount
+ * modules declare it identically. It is RESTATED rather than imported because codegen-ts
+ * does not depend on runtime-ts: codegen emits a call to that helper, it never links
+ * against it. Pinned against both runtime declarations by test/routes-expose.test.ts, so
+ * the two cannot drift the way the cell-renderer keys drifted from the view registry.
+ */
+export declare const CRUD_VERBS: readonly ["list", "get", "create", "update", "delete"];
+/**
+ * The verbs a TPH discriminator BASE serves at its own path.
+ *
+ * Read-only BY CONSTRUCTION: the discriminated union has no single writable shape, so the
+ * base mount can never carry `create`/`update`/`delete` — an author-supplied `expose`
+ * INTERSECTS with this set rather than replacing it, and may narrow to just `list`.
+ * Writes live on the per-subtype mounts at `<base path>/<segment>`.
+ *
+ * Named here because two places need it and a second literal would be a second answer:
+ * `routes-file.ts` emits the mount, and `api-model.ts` documents it. They disagreed —
+ * the api surface documented POST/PATCH/DELETE on a base path that serves none, under a
+ * comment claiming the documented paths "match the generated routes exactly".
+ */
+export declare const TPH_POLYMORPHIC_VERBS: readonly ["list", "get"];
+export type CrudVerb = (typeof CRUD_VERBS)[number];
+/**
+ * Which CRUD verbs a generated routes file mounts (#348).
+ *
+ * A `filter` cannot express this. `filter` decides whether the file emits AT ALL, per
+ * entity, so it can only remove the whole surface; restricting to a SUBSET of verbs is a
+ * different axis. That is why this is a generator option rather than the "narrow it with
+ * `filter`" remedy that answered the retired `@emit*` attributes — the same reasoning that
+ * made a TPH subtype's opt-IN grid `tphSubtypeGrids` rather than a filter.
+ *
+ * It is deliberately NOT metadata. Which verbs a deployment exposes is a property of the
+ * app, not of the model: the same entity is read-only in one service and writable in
+ * another, and an attribute would force one answer into the shared spine.
+ *
+ * Absent — or a function returning `undefined` for an entity — means all five, and emits
+ * output byte-identical to before this option existed.
+ */
+export type ExposeOption = readonly CrudVerb[] | ((entity: MetaObject) => readonly CrudVerb[] | undefined);
+/** Resolve the option for one entity. `undefined` means "mount all five". */
+export declare function resolveExpose(entity: MetaObject, expose: ExposeOption | undefined): readonly CrudVerb[] | undefined;
+/**
+ * Narrow a mount whose verb set is already fixed by construction.
+ *
+ * A TPH polymorphic mount is read-only (`["list", "get"]`) because the discriminated union
+ * has no single writable shape. An author-supplied `expose` may narrow that further but
+ * must never widen it, so this INTERSECTS rather than replaces: mounting `create` on a
+ * surface that cannot serve it would emit a route that fails at runtime, and a wrong
+ * endpoint is worse than a missing one.
+ */
+export declare function intersectExpose(fixed: readonly CrudVerb[], requested: readonly CrudVerb[] | undefined): readonly CrudVerb[];
+/**
+ * The `expose: [...]` line for a mount call, or "" when every verb mounts.
+ *
+ * Emitting nothing rather than the full list keeps output byte-identical for every
+ * project that does not use the option.
+ */
+export declare function exposeLine(verbs: readonly CrudVerb[] | undefined, indent: string): string;
+//# sourceMappingURL=routes-expose.d.ts.map

package/dist/routes-expose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes-expose.d.ts","sourceRoot":"","sources":["../src/routes-expose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,wDAAyD,CAAC;AAEjF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,0BAA2B,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,QAAQ,EAAE,GACnB,CAAC,CAAC,MAAM,EAAE,UAAU,KAAK,SAAS,QAAQ,EAAE,GAAG,SAAS,CAAC,CAAC;AAE9D,6EAA6E;AAC7E,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,YAAY,GAAG,SAAS,GAC/B,SAAS,QAAQ,EAAE,GAAG,SAAS,CAGjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,GACzC,SAAS,QAAQ,EAAE,CAIrB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGzF"}

package/dist/routes-expose.js

@@ -0,0 +1,57 @@
+/**
+ * The five CRUD verbs a generated routes file can mount.
+ *
+ * Mirrors `CrudVerb` in `@metaobjectsdev/runtime-ts` — both the fastify and hono mount
+ * modules declare it identically. It is RESTATED rather than imported because codegen-ts
+ * does not depend on runtime-ts: codegen emits a call to that helper, it never links
+ * against it. Pinned against both runtime declarations by test/routes-expose.test.ts, so
+ * the two cannot drift the way the cell-renderer keys drifted from the view registry.
+ */
+export const CRUD_VERBS = ["list", "get", "create", "update", "delete"];
+/**
+ * The verbs a TPH discriminator BASE serves at its own path.
+ *
+ * Read-only BY CONSTRUCTION: the discriminated union has no single writable shape, so the
+ * base mount can never carry `create`/`update`/`delete` — an author-supplied `expose`
+ * INTERSECTS with this set rather than replacing it, and may narrow to just `list`.
+ * Writes live on the per-subtype mounts at `<base path>/<segment>`.
+ *
+ * Named here because two places need it and a second literal would be a second answer:
+ * `routes-file.ts` emits the mount, and `api-model.ts` documents it. They disagreed —
+ * the api surface documented POST/PATCH/DELETE on a base path that serves none, under a
+ * comment claiming the documented paths "match the generated routes exactly".
+ */
+export const TPH_POLYMORPHIC_VERBS = ["list", "get"];
+/** Resolve the option for one entity. `undefined` means "mount all five". */
+export function resolveExpose(entity, expose) {
+    if (expose === undefined)
+        return undefined;
+    return typeof expose === "function" ? expose(entity) : expose;
+}
+/**
+ * Narrow a mount whose verb set is already fixed by construction.
+ *
+ * A TPH polymorphic mount is read-only (`["list", "get"]`) because the discriminated union
+ * has no single writable shape. An author-supplied `expose` may narrow that further but
+ * must never widen it, so this INTERSECTS rather than replaces: mounting `create` on a
+ * surface that cannot serve it would emit a route that fails at runtime, and a wrong
+ * endpoint is worse than a missing one.
+ */
+export function intersectExpose(fixed, requested) {
+    if (requested === undefined)
+        return fixed;
+    const want = new Set(requested);
+    return fixed.filter((v) => want.has(v));
+}
+/**
+ * The `expose: [...]` line for a mount call, or "" when every verb mounts.
+ *
+ * Emitting nothing rather than the full list keeps output byte-identical for every
+ * project that does not use the option.
+ */
+export function exposeLine(verbs, indent) {
+    if (verbs === undefined)
+        return "";
+    return `\n${indent}expose: [${verbs.map((v) => JSON.stringify(v)).join(", ")}],`;
+}
+//# sourceMappingURL=routes-expose.js.map

package/dist/routes-expose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes-expose.js","sourceRoot":"","sources":["../src/routes-expose.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAEjF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAU,CAAC;AAuB9D,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAC3B,MAAkB,EAClB,MAAgC;IAEhC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAChE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,KAA0B,EAC1B,SAA0C;IAE1C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,SAAS,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsC,EAAE,MAAc;IAC/E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,KAAK,MAAM,YAAY,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACnF,CAAC"}

package/dist/runner.d.ts

@@ -73,5 +73,23 @@ export interface RunGenResult {
      *  CLI can print the end-of-run summary. */
     conflicts: WriteResult[];
 }
+/**
+ * True exactly on the FIRST gen after upgrading past the release that moved the API base
+ * URL out of the entity descriptor, and only for a project that actually had a prefix to
+ * move. Exported for test.
+ *
+ * Keyed on the #232 engine stamp rather than on `apiPrefix` alone so the note is
+ * self-extinguishing: whether the app passed `baseUrl` to its provider is runtime code
+ * `meta gen` cannot see, so a prefix-only trigger would nag for ever with no way to
+ * satisfy it — the cry-wolf failure that got the `timestampMode` warning deleted from
+ * this file (see `codegen-ts-tanstack/src/data-grid-gate.ts`).
+ *
+ * Silence is the default for an absent or unorderable recorded version. That is the
+ * OPPOSITE call to the 0.24.5 agent-context staleness nudge, and deliberately: there an
+ * unknown version meant "cannot prove it is fresh, so nudge"; here it means "no gen
+ * history, so nothing to migrate", and a false nag costs more than a missed one when the
+ * compile break already routes the adopter to the same line.
+ */
+export declare function shouldNoteBaseUrlMove(apiPrefix: string, recordedEngine: string | undefined, moveVersion?: string): boolean;
 export declare function runGen(opts: RunGenOpts): Promise<RunGenResult>;
 //# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,0BAA0B,CAAC;AAMrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAQpE,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EAElB,MAAM,uBAAuB,CAAC;AAU/B,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;4BAEwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;oDACgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;qBAEiB;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;gDAC4C;IAC5C,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AAkBD,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CA6iBpE"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,0BAA0B,CAAC;AAOrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAQpE,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EAElB,MAAM,uBAAuB,CAAC;AAU/B,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;4BAEwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;oDACgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;qBAEiB;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;gDAC4C;IAC5C,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AA4BD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,WAAW,GAAE,MAA8B,GAC1C,OAAO,CAWT;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAonBpE"}