@metaobjectsdev/codegen-ts-react 0.24.3 → 0.24.5

package/README.md

@@ -26,6 +26,14 @@ export default defineConfig({
 targets". The form imports the entity module from wherever `entityFile()` is
 routed (relative when same target, the entity-module target's `importBase` when not).
 
+### The generator is yours
+
+`formFile()` has a reference template: `meta eject form` copies it into `codegen/generators/form.ts`
+for you to own. The emitted component is React with react-hook-form — if your framework needs a
+marker directive or a different import shape, compose the exported renderer and change that one
+step. Inside the ejected file's existing `if (!ctx.renderContext) throw …` guard, change only the
+`content:` line: `content: '"use client";\n' + renderFormFile(entity, ctx.renderContext)`.
+
 ## Pairs with
 
 - Runtime: [`@metaobjectsdev/react`](../../../../client/web/packages/react) — the generated forms import from here.

package/dist/form-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-file.d.ts","sourceRoot":"","sources":["../src/form-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAA6B,KAAK,gBAAgB,EAAwF,MAAM,4BAA4B,CAAC;AAGpL,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAwChB,gBAAgB,CAAC,YAAY,CAAC,CAAC"}
+{"version":3,"file":"form-file.d.ts","sourceRoot":"","sources":["../src/form-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAA6B,KAAK,gBAAgB,EAA6G,MAAM,4BAA4B,CAAC;AAGzM,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EA2ChB,gBAAgB,CAAC,YAAY,CAAC,CAAC"}

package/dist/form-file.js

@@ -1,5 +1,5 @@
 import { OBJECT_ATTR_DISCRIMINATOR } from "@metaobjectsdev/metadata";
-import { perEntity, entityOutputPath, servesWriteApi, isProjection, isTphSubtype, CODEGEN_ATTR_EMIT_FORM } from "@metaobjectsdev/codegen-ts";
+import { perEntity, entityOutputPath, servesWriteApi, isProjection, isTphSubtype, CODEGEN_ATTR_EMIT_FORM, withClientDirective } from "@metaobjectsdev/codegen-ts";
 import { renderFormFile } from "./templates/form-file.js";
 /**
  * Forms are opt-in: a user must add `formFile()` to config.generators.
@@ -42,7 +42,7 @@ export const formFile = function formFile(opts) {
             }
             return {
                 path: entityOutputPath(ctx.config.outputLayout ?? "flat", entity.package, `${entity.name}.form.tsx`),
-                content: renderFormFile(entity, ctx.renderContext),
+                content: withClientDirective(renderFormFile(entity, ctx.renderContext), ctx.renderContext.clientDirective),
             };
         }),
     };

package/dist/form-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-file.js","sourceRoot":"","sources":["../src/form-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,SAAS,EAAyC,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpL,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAO1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,SAAS,QAAQ,CAAC,IAAmB;IAC3D,MAAM,UAAU,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,WAAW;QACjB,8DAA8D;QAC9D,oEAAoE;QACpE,qEAAqE;QACrE,4BAA4B;QAC5B,2EAA2E;QAC3E,yEAAyE;QACzE,6EAA6E;QAC7E,MAAM,EAAE,CAAC,CAAa,EAAE,EAAE;YACxB,6EAA6E;YAC7E,IAAI,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,KAAK;gBAAE,OAAO,KAAK,CAAC;YAC3D,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;YACjC,IAAI,YAAY,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC,CAAC,mBAAmB;YACrD,wDAAwD;YACxD,4EAA4E;YAC5E,8EAA8E;YAC9E,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC3E,gFAAgF;YAChF,8EAA8E;YAC9E,2EAA2E;YAC3E,wCAAwC;YACxC,OAAO,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,QAAQ,EAAE,SAAS,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;YAClC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,WAAW,CAAC;gBACpG,OAAO,EAAE,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC;aACnD,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,CAAmC,CAAC"}
+{"version":3,"file":"form-file.js","sourceRoot":"","sources":["../src/form-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,SAAS,EAAyC,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACzM,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAO1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,SAAS,QAAQ,CAAC,IAAmB;IAC3D,MAAM,UAAU,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,WAAW;QACjB,8DAA8D;QAC9D,oEAAoE;QACpE,qEAAqE;QACrE,4BAA4B;QAC5B,2EAA2E;QAC3E,yEAAyE;QACzE,6EAA6E;QAC7E,MAAM,EAAE,CAAC,CAAa,EAAE,EAAE;YACxB,6EAA6E;YAC7E,IAAI,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,KAAK;gBAAE,OAAO,KAAK,CAAC;YAC3D,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;YACjC,IAAI,YAAY,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC,CAAC,mBAAmB;YACrD,wDAAwD;YACxD,4EAA4E;YAC5E,8EAA8E;YAC9E,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC3E,gFAAgF;YAChF,8EAA8E;YAC9E,2EAA2E;YAC3E,wCAAwC;YACxC,OAAO,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,QAAQ,EAAE,SAAS,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;YAClC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,WAAW,CAAC;gBACpG,OAAO,EAAE,mBAAmB,CAC1B,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,EACzC,GAAG,CAAC,aAAa,CAAC,eAAe,CAClC;aACF,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,CAAmC,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,5 @@
 export { formFile, type FormFileOpts } from "./form-file.js";
+export { renderFormFile } from "./templates/form-file.js";
+export { resolveReferenceRoot, readReferenceTemplate, REFERENCE_GENERATOR_NAMES } from "./reference-templates.js";
+export type { ReferenceGeneratorName } from "./reference-templates.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI7D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI1D,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAGlH,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,3 +1,9 @@
 // Public API surface for @metaobjectsdev/codegen-ts-react.
 export { formFile } from "./form-file.js";
+// FR-040 §4.2(b) — public so an owned generator composes the engine rather than
+// forking it. Signature is stable API: (entity, ctx) => string.
+export { renderFormFile } from "./templates/form-file.js";
+// FR-040 §4.1 — the copyable reference generator(s) this package ships in
+// `src/reference/`, and the reader `meta init`/`meta eject` use to read them.
+export { resolveReferenceRoot, readReferenceTemplate, REFERENCE_GENERATOR_NAMES } from "./reference-templates.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EAAE,QAAQ,EAAqB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EAAE,QAAQ,EAAqB,MAAM,gBAAgB,CAAC;AAE7D,gFAAgF;AAChF,gEAAgE;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,0EAA0E;AAC1E,8EAA8E;AAC9E,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/reference-templates.d.ts

@@ -0,0 +1,5 @@
+export declare const REFERENCE_GENERATOR_NAMES: readonly ["form"];
+export type ReferenceGeneratorName = (typeof REFERENCE_GENERATOR_NAMES)[number];
+export declare function resolveReferenceRoot(): string;
+export declare function readReferenceTemplate(name: ReferenceGeneratorName): string;
+//# sourceMappingURL=reference-templates.d.ts.map

package/dist/reference-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-templates.d.ts","sourceRoot":"","sources":["../src/reference-templates.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,yBAAyB,mBAAoB,CAAC;AAC3D,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIhF,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAE1E"}

package/dist/reference-templates.js

@@ -0,0 +1,12 @@
+// FR-040 §4.1 — this package hosts its own copyable reference generators in
+// `src/reference/`, read through the shared factory so the resolver is not duplicated.
+import { makeReferenceReader } from "@metaobjectsdev/codegen-ts";
+export const REFERENCE_GENERATOR_NAMES = ["form"];
+const reader = makeReferenceReader(import.meta.url, REFERENCE_GENERATOR_NAMES);
+export function resolveReferenceRoot() {
+    return reader.resolveReferenceRoot();
+}
+export function readReferenceTemplate(name) {
+    return reader.readReferenceTemplate(name);
+}
+//# sourceMappingURL=reference-templates.js.map

package/dist/reference-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-templates.js","sourceRoot":"","sources":["../src/reference-templates.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,uFAAuF;AACvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,MAAM,CAAU,CAAC;AAG3D,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAAC;AAE/E,MAAM,UAAU,oBAAoB;IAClC,OAAO,MAAM,CAAC,oBAAoB,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAA4B;IAChE,OAAO,MAAM,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/codegen-ts-react",
-  "version": "0.24.3",
+  "version": "0.24.5",
   "description": "React codegen for metaobjects — emits <Entity>.form.tsx files using react-hook-form and @metaobjectsdev/react helpers.",
   "type": "module",
   "main": "./dist/index.js",
@@ -45,8 +45,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@metaobjectsdev/metadata": "0.24.3",
-    "@metaobjectsdev/codegen-ts": "0.24.3",
+    "@metaobjectsdev/metadata": "0.24.5",
+    "@metaobjectsdev/codegen-ts": "0.24.5",
     "ts-poet": "^6.10.0"
   },
   "peerDependencies": {

package/src/form-file.ts

@@ -1,6 +1,6 @@
 import type { MetaObject } from "@metaobjectsdev/metadata";
 import { OBJECT_ATTR_DISCRIMINATOR } from "@metaobjectsdev/metadata";
-import { perEntity, type Generator, type GeneratorFactory, entityOutputPath, servesWriteApi, isProjection, isTphSubtype, CODEGEN_ATTR_EMIT_FORM } from "@metaobjectsdev/codegen-ts";
+import { perEntity, type Generator, type GeneratorFactory, entityOutputPath, servesWriteApi, isProjection, isTphSubtype, CODEGEN_ATTR_EMIT_FORM, withClientDirective } from "@metaobjectsdev/codegen-ts";
 import { renderFormFile } from "./templates/form-file.js";
 
 export interface FormFileOpts {
@@ -45,7 +45,10 @@ export const formFile = function formFile(opts?: FormFileOpts): Generator {
       }
       return {
         path: entityOutputPath(ctx.config.outputLayout ?? "flat", entity.package, `${entity.name}.form.tsx`),
-        content: renderFormFile(entity, ctx.renderContext),
+        content: withClientDirective(
+          renderFormFile(entity, ctx.renderContext),
+          ctx.renderContext.clientDirective,
+        ),
       };
     }),
   };

package/src/index.ts

@@ -1,2 +1,13 @@
 // Public API surface for @metaobjectsdev/codegen-ts-react.
 export { formFile, type FormFileOpts } from "./form-file.js";
+
+// FR-040 §4.2(b) — public so an owned generator composes the engine rather than
+// forking it. Signature is stable API: (entity, ctx) => string.
+export { renderFormFile } from "./templates/form-file.js";
+
+// FR-040 §4.1 — the copyable reference generator(s) this package ships in
+// `src/reference/`, and the reader `meta init`/`meta eject` use to read them.
+export { resolveReferenceRoot, readReferenceTemplate, REFERENCE_GENERATOR_NAMES } from "./reference-templates.js";
+// The name union travels with the names array — codegen-ts exports both, and a
+// consumer keying anything by ejectable name needs the type as much as the values.
+export type { ReferenceGeneratorName } from "./reference-templates.js";

package/src/reference/form.ts

@@ -0,0 +1,92 @@
+// REFERENCE TEMPLATE — copy this into your repo (e.g. codegen/generators/form.ts) and own it.
+// Then import it LOCALLY in metaobjects.config.ts:
+//   import { formFile } from "./codegen/generators/form.js";
+//
+// RUNTIME: this file executes under whatever runs `meta gen` — NODE, even in a Bun
+// project. Do not reach for `Bun.*` globals here.
+// targets:       React with react-hook-form. The emitted component calls `useEntityForm`
+//                from `@metaobjectsdev/react`, so it is a CLIENT component.
+//                If your framework compiles server and client from one tree and resolves
+//                each half under different conditions, the emitted file may need a marker
+//                directive — prepend it to `renderFormFile`'s result below. That is a
+//                one-line change in THIS file and is the intended way to do it.
+// use-when:      you want a generated form per writable entity.
+// emits:         <target>/<Entity>.form.tsx
+// customize:     this generator is YOURS. `renderFormFile` (exported from
+//                @metaobjectsdev/codegen-ts-react) produces the component body — wrap it,
+//                prepend to it, or replace the call entirely with your own renderer.
+// composes-with: entity.ts (imports the schemas the form validates against).
+
+import type { MetaObject } from "@metaobjectsdev/metadata";
+import { OBJECT_ATTR_DISCRIMINATOR } from "@metaobjectsdev/metadata";
+import {
+  perEntity,
+  type Generator,
+  type GeneratorFactory,
+  entityOutputPath,
+  servesWriteApi,
+  isProjection,
+  isTphSubtype,
+  CODEGEN_ATTR_EMIT_FORM,
+  withClientDirective,
+} from "@metaobjectsdev/codegen-ts";
+import { renderFormFile } from "@metaobjectsdev/codegen-ts-react";
+
+export interface FormFileOpts {
+  filter?: (entity: MetaObject) => boolean;
+  target?: string;
+}
+
+/**
+ * Forms are opt-in: a user must add `formFile()` to config.generators.
+ * Per-entity opt-out via `@emitForm: false` is honored.
+ * .tsx files are not piped through formatTs (Biome only handles .ts here).
+ */
+export const formFile = function formFile(opts?: FormFileOpts): Generator {
+  const userFilter = opts?.filter ?? (() => true);
+  const generator: Generator = {
+    name: "form-file",
+    // Always set: AND-composes the framework write-artifact guard
+    // (skips abstract types — no instance — and read-only projections —
+    // instantiable for read, never for write), the metadata opt-out, and
+    // the optional user filter.
+    // FR-017 Tier 3: forms are ALWAYS per-subtype. The discriminator base gets
+    // NO form (you can't create an abstract base), but each concrete subtype
+    // does — even though it has no own writable source (it inherits the base's).
+    filter: (e: MetaObject) => {
+      // ADR-0039: resolving — a concrete entity may inherit @emitForm via extends.
+      if (e.attr(CODEGEN_ATTR_EMIT_FORM) === false) return false;
+      if (!userFilter(e)) return false;
+      if (isTphSubtype(e)) return true; // per-subtype form
+      // A discriminator base is never form-rendered directly.
+      // ADR-0039: own — @discriminator identifies a TPH base level (read own so a
+      // subtype isn't mistaken for a base); e is already known not to be a subtype.
+      if (typeof e.ownAttr(OBJECT_ATTR_DISCRIMINATOR) === "string") return false;
+      // A form is a client of a WRITE endpoint. Ask whether one exists, not where the
+      // data is stored — see api-surface.ts. `!isProjection` stays explicit here: a
+      // read-only view is a UI-tier exclusion (nothing to submit), distinct from
+      // whether write endpoints exist at all.
+      return servesWriteApi(e) && !isProjection(e);
+    },
+    generate: perEntity((entity, ctx) => {
+      if (!ctx.renderContext) {
+        throw new Error("form-file: renderContext is required (provided by runGen)");
+      }
+      // The framework-coupled seam. `withClientDirective` applies the project-level
+      // `clientDirective` config knob (FR-040 §6.4); for a directive your framework
+      // needs that MetaObjects does not model, prepend it right here.
+      const body = withClientDirective(
+        renderFormFile(entity, ctx.renderContext),
+        ctx.renderContext.clientDirective,
+      );
+      return {
+        path: entityOutputPath(ctx.config.outputLayout ?? "flat", entity.package, `${entity.name}.form.tsx`),
+        content: body,
+      };
+    }),
+  };
+  if (opts?.target) {
+    generator.target = opts.target;
+  }
+  return generator;
+} as GeneratorFactory<FormFileOpts>;

package/src/reference-templates.ts

@@ -0,0 +1,16 @@
+// FR-040 §4.1 — this package hosts its own copyable reference generators in
+// `src/reference/`, read through the shared factory so the resolver is not duplicated.
+import { makeReferenceReader } from "@metaobjectsdev/codegen-ts";
+
+export const REFERENCE_GENERATOR_NAMES = ["form"] as const;
+export type ReferenceGeneratorName = (typeof REFERENCE_GENERATOR_NAMES)[number];
+
+const reader = makeReferenceReader(import.meta.url, REFERENCE_GENERATOR_NAMES);
+
+export function resolveReferenceRoot(): string {
+  return reader.resolveReferenceRoot();
+}
+
+export function readReferenceTemplate(name: ReferenceGeneratorName): string {
+  return reader.readReferenceTemplate(name);
+}