@metaobjectsdev/codegen-ts 0.9.0 → 0.11.0-rc.1

package/dist/enum-shared.js

@@ -0,0 +1,83 @@
+// FR-019 — shared + externally-provided enum resolution.
+//
+// A reusable enum is a ROOT/package-level abstract `field.enum` (a sibling of
+// object.entity) that concrete entity fields `extends`. Per ADR-0026 such a
+// declaration is materialized ONCE per port and referenced, instead of being
+// redeclared inline in every consuming entity file.
+//
+// Two cases on the abstract declaration:
+//   • non-@provided → metaobjects MATERIALIZES the type once (a shared module),
+//     and consuming fields reference it.
+//   • @provided: true → metaobjects emits NOTHING for the type; consuming fields
+//     reference an existing hand-written/third-party type, resolved via per-port
+//     codegen config (the namespace/module never lives in metadata — ADR-0001).
+//
+// The common inline case (a concrete `field.enum` with @values declared directly,
+// no root-extends) is UNCHANGED — it stays a per-entity `<Entity><Field>` union.
+import { FIELD_SUBTYPE_ENUM, FIELD_ATTR_PROVIDED, TYPE_METADATA, } from "@metaobjectsdev/metadata";
+import { toPascalCase } from "./naming.js";
+import { enumValues } from "./enum-meta.js";
+/**
+ * The root-level abstract `field.enum` a concrete enum field resolves to via
+ * `extends`, or undefined when the field is an inline enum (no root-abstract
+ * super). A super qualifies only when it is (a) an abstract field, AND (b) a
+ * direct child of the metadata root (a package-level declaration) — NOT an
+ * abstract field nested inside another object.
+ */
+export function resolveSharedEnumDecl(field) {
+    if (field.subType !== FIELD_SUBTYPE_ENUM)
+        return undefined;
+    const sup = field.resolveSuper();
+    if (sup === undefined)
+        return undefined;
+    if (!sup.isAbstract)
+        return undefined;
+    // The declaration must sit at the package/root level (sibling of object.entity),
+    // i.e. its parent node is the metadata root.
+    const parent = sup.parent;
+    if (parent === undefined || parent.type !== TYPE_METADATA)
+        return undefined;
+    return sup;
+}
+/** The shared-enum descriptor a field resolves to, or undefined for inline enums. */
+export function sharedEnumForField(field) {
+    const decl = resolveSharedEnumDecl(field);
+    if (decl === undefined)
+        return undefined;
+    const values = enumValues(field);
+    if (values === undefined)
+        return undefined;
+    return {
+        name: toPascalCase(decl.name),
+        values,
+        provided: decl.attr(FIELD_ATTR_PROVIDED) === true,
+    };
+}
+/**
+ * All shared (root-level abstract) enum declarations in the loaded root that are
+ * actually CONSUMED by at least one concrete entity field — keyed by the
+ * materialized type name. A declaration nobody extends is not materialized (no
+ * dangling type). Deterministic order: first-consumption order across entities.
+ */
+export function collectSharedEnums(root) {
+    const out = new Map();
+    for (const entity of root.objects()) {
+        for (const field of entity.fields()) {
+            const shared = sharedEnumForField(field);
+            if (shared === undefined)
+                continue;
+            if (!out.has(shared.name))
+                out.set(shared.name, shared);
+        }
+    }
+    return out;
+}
+/** The shared enums that metaobjects MATERIALIZES (non-@provided, consumed). */
+export function materializedSharedEnums(root) {
+    return [...collectSharedEnums(root).values()].filter((e) => !e.provided);
+}
+/** Whether any shared enum (materialized or provided) is consumed in the model. */
+export function hasSharedEnums(root) {
+    return collectSharedEnums(root).size > 0;
+}
+//# sourceMappingURL=enum-shared.js.map

package/dist/enum-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-shared.js","sourceRoot":"","sources":["../src/enum-shared.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,oDAAoD;AACpD,EAAE;AACF,yCAAyC;AACzC,gFAAgF;AAChF,yCAAyC;AACzC,iFAAiF;AACjF,iFAAiF;AACjF,gFAAgF;AAChF,EAAE;AACF,kFAAkF;AAClF,iFAAiF;AAGjF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAY5C;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAgB;IACpD,IAAI,KAAK,CAAC,OAAO,KAAK,kBAAkB;QAAE,OAAO,SAAS,CAAC;IAC3D,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;IACjC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,CAAC,GAAG,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IACtC,iFAAiF;IACjF,6CAA6C;IAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,SAAS,CAAC;IAC5E,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,KAAgB;IACjD,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7B,MAAM;QACN,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,IAAI;KAClD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC1C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACpC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,MAAM,KAAK,SAAS;gBAAE,SAAS;YACnC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;gBAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,uBAAuB,CAAC,IAAc;IACpD,OAAO,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;AAC3C,CAAC"}

package/dist/generator-registry.d.ts

@@ -0,0 +1,22 @@
+import type { Generator } from "./generator.js";
+export type GeneratorTier = "native" | "neutral";
+export interface GeneratorRegistryEntry {
+    /** Stable, cross-port-consistent id. Equals the registry map key. */
+    name: string;
+    /** One-line (no newline) human description for `--list`. */
+    description: string;
+    /** "native" = recommended `meta gen` suite; "neutral" = `meta docs`-owned. */
+    tier: GeneratorTier;
+    /** Constructs the generator with sensible defaults. Calling it must not throw. */
+    factory: () => Generator;
+    /** Optional one-line options summary for `--list`. */
+    options?: string;
+    /** Optional note — used to point neutral entries at their canonical door. */
+    note?: string;
+}
+export declare const generatorRegistry: Record<string, GeneratorRegistryEntry>;
+/** All registry entries, native first then neutral, alphabetical within tier. */
+export declare function listGenerators(): GeneratorRegistryEntry[];
+/** Resolve a generator entry by its stable id, or undefined if unknown. */
+export declare function getGenerator(id: string): GeneratorRegistryEntry | undefined;
+//# sourceMappingURL=generator-registry.d.ts.map

package/dist/generator-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-registry.d.ts","sourceRoot":"","sources":["../src/generator-registry.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAoBhD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjD,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,IAAI,EAAE,aAAa,CAAC;IACpB,kFAAkF;IAClF,OAAO,EAAE,MAAM,SAAS,CAAC;IACzB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAeD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAsHpE,CAAC;AAEF,iFAAiF;AACjF,wBAAgB,cAAc,IAAI,sBAAsB,EAAE,CAQzD;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAE3E"}

package/dist/generator-registry.js

@@ -0,0 +1,161 @@
+// ADR-0021 D3 — stable-name generator registry.
+//
+// Generators are identified by a STABLE string id (e.g. `entity`, `routes`,
+// `render-helper`) rather than by a language-specific factory import. The id is
+// the cross-port contract: the same logical generator carries the same stable
+// name in every port. This module is the discoverability + identity surface
+// behind `meta gen --list`.
+//
+// It is ADDITIVE. The existing `defineConfig({ generators: [entityFile(), ...] })`
+// factory-array config keeps working unchanged — the registry powers `--list`
+// and a stable identity, it does not replace the config path.
+//
+// Tiering (ADR-0020 / ADR-0021 D1):
+//   - "native"  — the recommended Tier-1 `meta gen` suite (idiomatic emission).
+//   - "neutral" — Tier-2 artifacts owned by the neutral docs engine. `docs` and
+//                 `mermaid-er` are present here for identity/discoverability but
+//                 are NOT part of the recommended native surface — the canonical
+//                 door for documentation is `meta docs` (D1).
+import { entityFile, queriesFile, callableFile, routesFile, routesFileHono, barrel, mermaidErDiagram, promptRender, outputParser, extractor, outputPrompt, renderHelper, apiDocsFile, docsFile, templateGenerator, traceHelperFile, } from "./generators/index.js";
+// The `template` generator is a PRIMITIVE: callers supply { name, walk,
+// template }. For registry identity + `--list` we expose a no-op default so the
+// factory constructs a valid Generator without throwing; real use passes opts
+// via the config factory-array path. (docsFile() is the first instance of this
+// primitive — see template-generator.ts.)
+function templatePrimitive() {
+    return templateGenerator({
+        name: "template",
+        template: "",
+        walk: () => [],
+    });
+}
+export const generatorRegistry = {
+    // ----- Tier-1 native suite (idiomatic per-port emission) -----------------
+    entity: {
+        name: "entity",
+        description: "Per-entity Drizzle table + typed model module (the entity module).",
+        tier: "native",
+        factory: () => entityFile(),
+        options: "filter?, target?",
+    },
+    queries: {
+        name: "queries",
+        description: "Per-entity typed query helpers (findById/create/...).",
+        tier: "native",
+        factory: () => queriesFile(),
+        options: "filter?, target?",
+    },
+    callable: {
+        name: "callable",
+        description: "Per-entity callable/service surface wrapping the query helpers.",
+        tier: "native",
+        factory: () => callableFile(),
+        options: "filter?, target?",
+    },
+    routes: {
+        name: "routes",
+        description: "Per-entity Fastify CRUD routes (drizzle-fastify mountCrudRoutes).",
+        tier: "native",
+        factory: () => routesFile(),
+        options: "filter?, target?",
+    },
+    "routes-hono": {
+        name: "routes-hono",
+        description: "Per-entity Hono CRUD routes (runtime-ts/hono mountCrudRoutes).",
+        tier: "native",
+        factory: () => routesFileHono(),
+        options: "filter?, target?",
+    },
+    barrel: {
+        name: "barrel",
+        description: "Single index.ts re-exporting every generated entity module.",
+        tier: "native",
+        factory: () => barrel(),
+        options: "target?",
+    },
+    "prompt-render": {
+        name: "prompt-render",
+        description: "Per-template prompt-render helper over the render engine.",
+        tier: "native",
+        factory: () => promptRender(),
+        options: "filter?, target?",
+    },
+    "output-parser": {
+        name: "output-parser",
+        description: "Per-template tolerant output parser (recover-on-receipt).",
+        tier: "native",
+        factory: () => outputParser(),
+        options: "filter?, target?",
+    },
+    extractor: {
+        name: "extractor",
+        description: "Per-template typed extract<Name> helper (strict payload extraction).",
+        tier: "native",
+        factory: () => extractor(),
+        options: "filter?, target?",
+    },
+    "output-prompt": {
+        name: "output-prompt",
+        description: "Per-template output-format prompt fragment generator.",
+        tier: "native",
+        factory: () => outputPrompt(),
+        options: "filter?, target?",
+    },
+    "render-helper": {
+        name: "render-helper",
+        description: "Per-template.output render helper (document/email typed wrappers).",
+        tier: "native",
+        factory: () => renderHelper(),
+        options: "filter?, target?",
+    },
+    template: {
+        name: "template",
+        description: "Generic Mustache template primitive (walk + template → files).",
+        tier: "native",
+        factory: () => templatePrimitive(),
+        options: "name, walk, template, format?, filter?, provider?, target?",
+    },
+    "api-docs": {
+        name: "api-docs",
+        description: "Per-entity/template SDK API reference (the generated code's API, human + agent forms).",
+        tier: "native",
+        factory: () => apiDocsFile(),
+        options: "filter?, target?",
+    },
+    "trace-helper": {
+        name: "trace-helper",
+        description: "Per-entity typed record<Entity>/call<Entity> trace helpers (extract + buildLlmCallRow + persist; LlmCallBase-derived entities only).",
+        tier: "native",
+        factory: () => traceHelperFile(),
+        options: "outDir?, target?",
+    },
+    // ----- Tier-2 neutral (owned by the `meta docs` engine — D1 / ADR-0020) ---
+    docs: {
+        name: "docs",
+        description: "Neutral per-entity / per-template Markdown documentation pages.",
+        tier: "neutral",
+        factory: () => docsFile(),
+        note: "neutral artifact — use `meta docs` (the single docs door, ADR-0021 D1); not part of the recommended `meta gen` native suite.",
+    },
+    "mermaid-er": {
+        name: "mermaid-er",
+        description: "Mermaid ER diagram of the entity/relationship model.",
+        tier: "neutral",
+        factory: () => mermaidErDiagram(),
+        note: "neutral artifact owned by the docs engine (ADR-0020); surfaced via `meta docs`, not the recommended `meta gen` native suite.",
+    },
+};
+/** All registry entries, native first then neutral, alphabetical within tier. */
+export function listGenerators() {
+    const entries = Object.values(generatorRegistry);
+    const byName = (a, b) => a.name.localeCompare(b.name);
+    return [
+        ...entries.filter((e) => e.tier === "native").sort(byName),
+        ...entries.filter((e) => e.tier === "neutral").sort(byName),
+    ];
+}
+/** Resolve a generator entry by its stable id, or undefined if unknown. */
+export function getGenerator(id) {
+    return generatorRegistry[id];
+}
+//# sourceMappingURL=generator-registry.js.map

package/dist/generator-registry.js.map

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

package/dist/generator.d.ts

@@ -44,6 +44,12 @@ export interface Generator {
     /** Marks the generator that produces entity modules — the runner uses its
      *  target as the entity-module target for cross-target import resolution. */
     emitsEntityModule?: boolean;
+    /** Marks the OPT-IN Hono routes generator (routesFileHono). The runner
+     *  aggregates this across the active suite into `ctx.config.includeHonoRoutes`,
+     *  so a generator that documents the API surface (api-docs) can AUTO-DETECT
+     *  that Hono routes are actually being emitted and document them — rather than
+     *  silently omitting the Hono CRUD registrars whenever the variant is wired. */
+    emitsHonoRoutes?: boolean;
 }
 export type GeneratorFactory<TOpts = void> = TOpts extends void ? () => Generator : (opts?: TOpts) => Generator;
 /** One-file-per-entity convenience. Async-safe. */

package/dist/generator.d.ts.map

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

package/dist/generator.js.map

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

package/dist/generators/api-doc-render.d.ts

@@ -0,0 +1,17 @@
+import type { Provider } from "@metaobjectsdev/render";
+import type { ApiModel, ApiUnitDoc } from "./api-model.js";
+import type { OutputLayout } from "../import-path.js";
+/** Render ONE per-unit human reference page from an ApiUnitDoc, via the shared
+ *  render() engine + the canonical `api/entity-api.md` template. `modelPageHref`
+ *  (when given) cross-links the page back to the entity's model/metadata page. */
+export declare function renderEntityApiPage(unit: ApiUnitDoc, provider: Provider, modelPageHref?: string): string;
+/** Render the consolidated human API index (links to each unit page, grouped
+ *  entity vs template) via the shared render() engine + `api/index.md`. */
+export declare function renderApiIndex(model: ApiModel, layout: OutputLayout, provider: Provider): string;
+/** Render the condensed agent/LLM form: per unit, symbols grouped under a single
+ *  `import { … } from "<module>"` header then one compact `signature — usage`
+ *  line each (with a `[throws: …]` marker when it throws), NO prose/examples
+ *  (token budget). Units keep their ApiModel order; symbols keep their per-unit
+ *  order (the canonical generator emission order). */
+export declare function renderAgentApi(model: ApiModel, provider: Provider): string;
+//# sourceMappingURL=api-doc-render.d.ts.map

package/dist/generators/api-doc-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-doc-render.d.ts","sourceRoot":"","sources":["../../src/generators/api-doc-render.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAyC,MAAM,gBAAgB,CAAC;AAGlG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA8StD;;kFAEkF;AAClF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,QAAQ,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CASR;AAyDD;2EAC2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAehG;AA+GD;;;;sDAIsD;AACtD,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA8B1E"}