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

package/dist/generators/api-doc-render.js

@@ -0,0 +1,431 @@
+// api-doc-render.ts — the two documentation FORMS that an ApiModel feeds:
+//   • a per-unit HUMAN reference page  (renderEntityApiPage)
+//   • a consolidated HUMAN index       (renderApiIndex)
+//   • a condensed AGENT/LLM form        (renderAgentApi)
+//
+// ADR-0022 Part 3: one ApiModel, two forms — the human prose page and the
+// token-frugal agent form derive from the SAME IR, never re-derived. Rendering
+// goes through the SHARED `render()` Mustache engine against canonical templates
+// under `templates/api/` (resolved via the framework/project provider chain —
+// the same mechanism docs-file.ts uses), so adopters can override a template by
+// dropping their own `templates/api/<ref>.mustache` into their project root.
+//
+// The view-models are pre-rendered here (mirroring docs-data-builder) so the
+// Mustache templates stay logic-light: section grouping, symbol counts, and the
+// collision-safe index hrefs (docPageHref) are computed in TS.
+import { render } from "@metaobjectsdev/render";
+import { inlineShape } from "./api-field-shape.js";
+import { docPageHref } from "../docs-paths.js";
+import { GENERATED_HEADER } from "../constants.js";
+// Template refs (resolved as `templates/api/<ref-tail>.mustache`).
+const ENTITY_PAGE_REF = "api/entity-api.md";
+const INDEX_REF = "api/index.md";
+const AGENT_REF = "api/agent-api.md";
+const GENERATED_MARKER = `<!-- ${GENERATED_HEADER} — DO NOT EDIT. -->`;
+// ---------------------------------------------------------------------------
+// Relative-import RENDER prefix.
+//
+// An `ApiSymbol.importPath` is the generated module's path RELATIVE TO the
+// codegen output dir (flat → `Product.queries`; package → the package-folded
+// `acme/shop/Product.queries`). It is the DATA the accuracy gate verifies
+// against the emitted file, so it stays a bare module path.
+//
+// The generated files import each OTHER with `./`-prefixed RELATIVE specifiers
+// (`from "./Product"`), so a copy-paste consumer co-located in the generated
+// output dir must do the same — a BARE specifier (`from "Product.queries"`)
+// only resolves with a non-default `baseUrl` and otherwise fails TS2307. The
+// renderers therefore `./`-prefix the importPath in every rendered `from "…"`
+// (the human page, the agent group headers, AND the example import blocks),
+// without touching the underlying importPath data. A consumer importing from
+// elsewhere adjusts the prefix (stated once in the page's import note).
+// ---------------------------------------------------------------------------
+/** The `./`-prefixed RELATIVE specifier for a documented module path (the form a
+ *  co-located consumer copy-pastes). Already-relative paths pass through. */
+function relSpecifier(importPath) {
+    return importPath.startsWith("./") || importPath.startsWith("../")
+        ? importPath
+        : `./${importPath}`;
+}
+/** Rewrite the `from "<module>"` tail of an example `import { … } from "<module>";`
+ *  line to the `./`-prefixed relative specifier — the example imports are
+ *  pre-composed in the ApiModel (reusing each symbol's bare importPath), so the
+ *  `./` prefix is applied at render time alongside the section/header imports. */
+function relImportLine(line) {
+    return line.replace(/(\bfrom\s+")([^"]+)(")/, (_m, pre, mod, post) => `${pre}${relSpecifier(mod)}${post}`);
+}
+// The human-facing section ORDER + HEADING per ApiSymbolKind. A unit's page
+// renders only the kinds it actually carries, always in this canonical order
+// (so two runs over the same model are byte-stable regardless of symbol order).
+const KIND_ORDER = [
+    "model",
+    "relation",
+    "data-access",
+    "callable",
+    "rest",
+    "rest-hono",
+    "validation",
+    "extractor",
+    "render",
+    "prompt",
+];
+const KIND_HEADING = {
+    model: "Model",
+    relation: "Relations",
+    "data-access": "Data access",
+    callable: "Callable",
+    rest: "REST",
+    "rest-hono": "REST (Hono)",
+    validation: "Validation",
+    extractor: "Extractor",
+    render: "Render",
+    prompt: "Prompt",
+};
+/** A docs-page name for the index href helper. The API index lives at the docs
+ *  ROOT, so its links to per-unit pages are computed via the same docPageHref
+ *  used elsewhere (resolves in flat AND package layout). */
+const INDEX_NODE = { name: "index" };
+/** The full set of handles a unit's example may reference. The per-unit page
+ *  shows only the handles that unit's example actually uses; the agent + index
+ *  forms show the full set once. */
+/** Build a setup row, deriving the single-line agent snippet from the block one
+ *  (newlines → `; `, collapsing any blank lines / double semicolons). */
+function setupHandle(handle, note, snippet) {
+    const snippetInline = snippet
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0)
+        .map((l) => (l.endsWith(";") ? l.slice(0, -1) : l))
+        .join("; ");
+    return { handle, note, snippet, snippetInline };
+}
+const SETUP_HANDLES = {
+    db: setupHandle("db", "your Drizzle connection — the generated queries take `db: Db` (a `NodePgDatabase` / `BaseSQLiteDatabase` alias). Construct one over your own driver and pass any compatible Drizzle instance:", `import { drizzle } from "drizzle-orm/node-postgres";
+import { Pool } from "pg";
+const db = drizzle(new Pool({ connectionString: process.env.DATABASE_URL }));`),
+    provider: setupHandle("provider", "the render `Provider` (resolves a template ref to text) — import it from `@metaobjectsdev/render`; `InMemoryProvider` is built in (or supply your own filesystem-backed `Provider`):", `import { InMemoryProvider } from "@metaobjectsdev/render";
+const provider = new InMemoryProvider({ "group/source": "Hello {{name}}" });`),
+    root: setupHandle("root", "the loaded `MetaRoot` `extract<Name>` parses against — load your metadata via `@metaobjectsdev/metadata` (the result carries `.root`):", `import { loadDirectory } from "@metaobjectsdev/metadata";
+const { root } = await loadDirectory("./metadata");`),
+};
+/** Which handles a unit's example references (so the page shows only those). */
+function setupHandlesFor(unit) {
+    const text = unit.example ? unit.example.body.join("\n") : "";
+    const out = [];
+    if (/\bdb\b/.test(text))
+        out.push(SETUP_HANDLES.db);
+    if (/\bprovider\b/.test(text))
+        out.push(SETUP_HANDLES.provider);
+    if (/\broot\b/.test(text))
+        out.push(SETUP_HANDLES.root);
+    return out;
+}
+/** A human-page caption for a symbol's field table, by kind + signature shape. */
+function fieldsCaptionFor(s) {
+    if (s.kind === "model")
+        return "Fields";
+    if (s.kind === "validation")
+        return "Accepted fields";
+    if (s.kind === "prompt")
+        return "Payload";
+    if (s.kind === "extractor")
+        return "Returns";
+    if (s.kind === "relation")
+        return "Navigations";
+    if (s.kind === "callable")
+        return "Returns";
+    if (s.kind === "rest" || s.kind === "rest-hono") {
+        return s.name.startsWith("GET ") ? "Response body" : "Request body";
+    }
+    // data-access: a create/update takes a body; reads return the model.
+    return s.name.startsWith("create") || s.name.startsWith("update") ? "Request body (data)" : "Returns";
+}
+/** Markdown-escape a cell whose text may contain a `|` (TS union types do). */
+function mdCell(text) {
+    return text.replace(/\|/g, "\\|");
+}
+/** Build the Field / Type / Required / Notes rows from a field shape. */
+function fieldRows(fields) {
+    return fields.map((f) => ({
+        field: f.name,
+        type: mdCell(f.type),
+        required: f.optional ? "" : "yes",
+        notes: f.note ?? "",
+    }));
+}
+/** The exact `import { … } from "<importPath>"` an adopter writes for a symbol.
+ *  REST endpoints aren't importable functions — the import is the entity's route
+ *  registrar (`<entity>Routes`) from the routes module; the symbol's `name` is a
+ *  "METHOD /path", not an identifier, so we import the registrar instead. Import
+ *  paths are RELATIVE to the adopter's generated-output dir (a note at the top of
+ *  the page states this once). */
+function importLineFor(s) {
+    // REST + Hono endpoints aren't importable functions — import the route
+    // registrar named on the symbol instead of the "METHOD /path" name.
+    const isRouteKind = s.kind === "rest" || s.kind === "rest-hono";
+    const imported = isRouteKind ? s.registrar ?? s.name : s.name;
+    return `import { ${imported} } from "${relSpecifier(s.importPath)}"`;
+}
+/** Group a unit's symbols into ordered sections (one per present kind), each a
+ *  list of {signature, usage, import, throws, example}. Empty kinds are omitted. */
+function entityPageVM(unit) {
+    const sections = [];
+    for (const kind of KIND_ORDER) {
+        const ofKind = unit.symbols.filter((s) => s.kind === kind);
+        if (ofKind.length === 0)
+            continue;
+        sections.push({
+            heading: KIND_HEADING[kind],
+            symbols: ofKind.map(symbolVM),
+        });
+    }
+    const setup = setupHandlesFor(unit);
+    const vm = {
+        generatedMarker: GENERATED_MARKER,
+        node: unit.node,
+        hasSetup: setup.length > 0,
+        setup,
+        sections,
+    };
+    const ex = unitExampleBlock(unit.example);
+    if (ex !== undefined)
+        vm.unitExample = ex;
+    return vm;
+}
+/** The full worked-example block for a unit (imports + body), as one ```ts body
+ *  string. Undefined when the unit has no runnable example. */
+function unitExampleBlock(example) {
+    if (example === undefined)
+        return undefined;
+    // The example imports are pre-composed in the ApiModel from the symbols' bare
+    // importPaths; `./`-prefix each at render time so the copy-paste block resolves.
+    const lines = example.imports.map(relImportLine);
+    if (example.imports.length > 0 && example.body.length > 0)
+        lines.push("");
+    lines.push(...example.body);
+    return lines.join("\n");
+}
+function symbolVM(s) {
+    const vm = { signature: s.signature, usage: s.usage, importLine: importLineFor(s) };
+    // REST: tell the agent how to actually wire the endpoints once imported.
+    if (s.kind === "rest" && s.registrar !== undefined) {
+        vm.mountNote = `\`await ${s.registrar}(fastify)\``;
+    }
+    // Hono: the registrar mounts onto the Hono app with a per-request deps object.
+    if (s.kind === "rest-hono" && s.registrar !== undefined) {
+        vm.mountNote = `\`${s.registrar}(app, { db })\``;
+    }
+    if (s.throws !== undefined)
+        vm.throws = s.throws;
+    if (s.example !== undefined)
+        vm.example = s.example;
+    // Field shape → a Field / Type / Required / Notes table (only when there is at
+    // least one field; a shape with no fields is omitted to keep the page clean).
+    if (s.fields !== undefined && s.fields.length > 0) {
+        vm.hasFields = true;
+        vm.fieldsCaption = fieldsCaptionFor(s);
+        vm.fieldRows = fieldRows(s.fields);
+    }
+    return vm;
+}
+/** 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 function renderEntityApiPage(unit, provider, modelPageHref) {
+    const payload = entityPageVM(unit);
+    if (modelPageHref !== undefined)
+        payload.modelPageHref = modelPageHref;
+    return render({
+        ref: ENTITY_PAGE_REF,
+        payload,
+        provider,
+        format: "markdown",
+    });
+}
+/** Lowercase summary label per kind (keeps the proper-noun acronym "REST"
+ *  intact rather than ".toLowerCase()"-ing it to "rest"). */
+const KIND_SUMMARY_LABEL = {
+    model: "model",
+    relation: "relations",
+    "data-access": "data access",
+    callable: "callable",
+    rest: "REST",
+    "rest-hono": "REST (Hono)",
+    validation: "validation",
+    extractor: "extractor",
+    render: "render",
+    prompt: "prompt",
+};
+/** A one-line summary for a unit's index row: the count of each present kind,
+ *  in canonical order (e.g. "model, 5 data access, 5 REST, 2 validation"). */
+function unitSummary(unit) {
+    const parts = [];
+    for (const kind of KIND_ORDER) {
+        const n = unit.symbols.filter((s) => s.kind === kind).length;
+        if (n === 0)
+            continue;
+        const label = KIND_SUMMARY_LABEL[kind];
+        parts.push(n === 1 ? label : `${n} ${label}`);
+    }
+    return parts.length > 0 ? parts.join(", ") : "no public symbols";
+}
+function indexRow(layout, unit) {
+    // The per-unit page is placed by {name, effective package} (see Task-3
+    // emission); link to it via the same docPageHref used for doc pages so it
+    // resolves in BOTH layouts — flat (`./Product.md`) and package
+    // (`./acme/shop/Product.md`), folding under the package path.
+    const href = docPageHref(layout, INDEX_NODE, { name: unit.node, package: unit.package });
+    return {
+        node: unit.node,
+        href,
+        summary: unitSummary(unit),
+        symbolCount: unit.symbols.length,
+        one: unit.symbols.length === 1,
+    };
+}
+/** Render the consolidated human API index (links to each unit page, grouped
+ *  entity vs template) via the shared render() engine + `api/index.md`. */
+export function renderApiIndex(model, layout, provider) {
+    const byName = (a, b) => a.node.localeCompare(b.node);
+    const entities = model.units.filter((u) => u.nodeKind === "entity").sort(byName);
+    const templates = model.units.filter((u) => u.nodeKind === "template").sort(byName);
+    const payload = {
+        generatedMarker: GENERATED_MARKER,
+        title: "API Reference",
+        intro: "Generated public API surface, one page per entity and output template.",
+        hasEntities: entities.length > 0,
+        entities: entities.map((u) => indexRow(layout, u)),
+        hasTemplates: templates.length > 0,
+        templates: templates.map((u) => indexRow(layout, u)),
+    };
+    return render({ ref: INDEX_REF, payload, provider, format: "markdown" });
+}
+/**
+ * The agent-form signature WITH the field shape inlined — so an LLM sees exactly
+ * what to pass / what it gets, not an opaque `unknown` / `ZodType` / type NAME.
+ * Token-frugal but complete. Shaping is per kind:
+ *   • model            → `interface <Name> <inlineShape>`;
+ *   • data-access      → swap the `data: unknown` param for `data: <inlineShape>`
+ *                        (create/update only; reads have no body shape);
+ *   • validation       → `<Name>InsertSchema: ZodType<<inlineShape>>`;
+ *   • REST             → append ` body: <inlineShape>` (write) / ` -> <inlineShape>`
+ *                        (GET response);
+ *   • extractor        → append ` // <Payload>: <inlineShape>`.
+ * Falls back to the bare signature when the symbol carries no field shape.
+ */
+function agentSignature(s) {
+    if (s.fields === undefined || s.fields.length === 0)
+        return s.signature;
+    const shape = inlineShape(s.fields);
+    switch (s.kind) {
+        case "model":
+            return `interface ${s.name} ${shape}`;
+        case "data-access":
+            // create/update carry a `data: unknown` body param to specialize.
+            return s.signature.includes("data: unknown")
+                ? s.signature.replace("data: unknown", `data: ${shape}`)
+                : s.signature;
+        case "validation":
+            return s.signature.replace("ZodType", `ZodType<${shape}>`);
+        case "rest":
+        case "rest-hono":
+            return s.name.startsWith("GET ") ? `${s.signature} -> ${shape}` : `${s.signature} body: ${shape}`;
+        case "extractor":
+        case "prompt":
+            return `${s.signature} // ${s.returns ?? "payload"}: ${shape}`;
+        case "relation":
+            // The navigations ride in the shape; show them inline after the const decl.
+            return `const ${s.name} ${shape}`;
+        case "callable":
+            // Callable returns a typed row array; the model shape isn't its param, so
+            // keep the bare signature (its `args` shape is the @parameterRef VO, shown
+            // on that VO's own unit).
+            return s.signature;
+        default:
+            return s.signature;
+    }
+}
+/** Group a unit's symbols by their import MODULE (first-appearance order),
+ *  emitting ONE `import { … } from "<module>"` header per module then the
+ *  symbols under it. This is the token-frugal form that still tells the agent the
+ *  exact import for EVERY symbol (one header amortized over N symbols, vs. an
+ *  import line per symbol). REST endpoints aren't importable identifiers — they
+ *  collapse under their entity's single route-registrar import (the registrar is
+ *  the imported name; the endpoints list the verbs/paths it mounts). */
+function agentGroups(unit) {
+    const order = [];
+    const byModule = new Map();
+    for (const s of unit.symbols) {
+        let g = byModule.get(s.importPath);
+        if (!g) {
+            g = { names: [], symbols: [] };
+            byModule.set(s.importPath, g);
+            order.push(s.importPath);
+        }
+        // The identifier an adopter imports: the symbol name, or — for REST / Hono —
+        // the shared route registrar (deduped across the entity's endpoints).
+        const isRouteKind = s.kind === "rest" || s.kind === "rest-hono";
+        const imported = isRouteKind ? s.registrar ?? s.name : s.name;
+        if (!g.names.includes(imported))
+            g.names.push(imported);
+        const sym = { signature: agentSignature(s), usage: s.usage };
+        if (s.throws !== undefined)
+            sym.throwsMarker = `[throws: ${s.throws}]`;
+        g.symbols.push(sym);
+    }
+    return order.map((mod) => {
+        const g = byModule.get(mod);
+        return {
+            importHeader: `import { ${g.names.join(", ")} } from "${relSpecifier(mod)}"`,
+            symbols: g.symbols,
+        };
+    });
+}
+/** 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 function renderAgentApi(model, provider) {
+    const units = model.units
+        .filter((u) => u.symbols.length > 0)
+        .map((u) => {
+        const vm = { node: u.node, groups: agentGroups(u) };
+        // The compact agent example: body statements only (the imports are already
+        // amortized into the group headers above the example).
+        if (u.example !== undefined && u.example.body.length > 0) {
+            vm.example = u.example.body.join("\n");
+        }
+        return vm;
+    });
+    // The handles ANY unit's example references — shown once at the top so an agent
+    // knows where db / provider / root come from before the call sites below.
+    const setup = setupHandlesForModel(model);
+    const payload = {
+        generatedMarker: GENERATED_MARKER,
+        title: "Agent API Reference",
+        // The ApiModel carries no package itself, so the model-only entry point uses
+        // a generic, self-contained project label. (A richer label off the loaded
+        // root's package can be layered in by the Task-3 emission entrypoint, which
+        // has the root.)
+        project: "this project",
+        // Import paths are RELATIVE to the adopter's generated-output dir.
+        importNote: "Imports are relative to your generated-output directory.",
+        hasSetup: setup.length > 0,
+        setup,
+        units,
+    };
+    return render({ ref: AGENT_REF, payload, provider, format: "markdown" });
+}
+/** The union of setup handles referenced by ANY unit's example, in canonical
+ *  db→provider→root order (shown once at the top of the agent form). */
+function setupHandlesForModel(model) {
+    const used = new Set();
+    for (const u of model.units) {
+        for (const h of setupHandlesFor(u))
+            used.add(h.handle);
+    }
+    return ["db", "provider", "root"]
+        .filter((h) => used.has(h))
+        .map((h) => SETUP_HANDLES[h]);
+}
+//# sourceMappingURL=api-doc-render.js.map

package/dist/generators/api-doc-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-doc-render.js","sourceRoot":"","sources":["../../src/generators/api-doc-render.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,6DAA6D;AAC7D,wDAAwD;AACxD,yDAAyD;AACzD,EAAE;AACF,0EAA0E;AAC1E,+EAA+E;AAC/E,iFAAiF;AACjF,8EAA8E;AAC9E,gFAAgF;AAChF,6EAA6E;AAC7E,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,+DAA+D;AAE/D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAmB,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAoB,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,mEAAmE;AACnE,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAC5C,MAAM,SAAS,GAAG,cAAc,CAAC;AACjC,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC,MAAM,gBAAgB,GAAG,QAAQ,gBAAgB,qBAAqB,CAAC;AAEvE,8EAA8E;AAC9E,iCAAiC;AACjC,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,0EAA0E;AAC1E,4DAA4D;AAC5D,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,8EAA8E;AAE9E;6EAC6E;AAC7E,SAAS,YAAY,CAAC,UAAkB;IACtC,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC;QAChE,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;AACxB,CAAC;AAED;;;kFAGkF;AAClF,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;AAC7G,CAAC;AAED,4EAA4E;AAC5E,6EAA6E;AAC7E,gFAAgF;AAChF,MAAM,UAAU,GAA6B;IAC3C,OAAO;IACP,UAAU;IACV,aAAa;IACb,UAAU;IACV,MAAM;IACN,WAAW;IACX,YAAY;IACZ,WAAW;IACX,QAAQ;IACR,QAAQ;CACT,CAAC;AACF,MAAM,YAAY,GAAkC;IAClD,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,WAAW;IACrB,aAAa,EAAE,aAAa;IAC5B,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF;;4DAE4D;AAC5D,MAAM,UAAU,GAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AA4BlD;;oCAEoC;AACpC;yEACyE;AACzE,SAAS,WAAW,CAAC,MAAc,EAAE,IAAY,EAAE,OAAe;IAChE,MAAM,aAAa,GAAG,OAAO;SAC1B,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,aAAa,GAAsD;IACvE,EAAE,EAAE,WAAW,CACb,IAAI,EACJ,+LAA+L,EAC/L;;8EAE0E,CAC3E;IACD,QAAQ,EAAE,WAAW,CACnB,UAAU,EACV,sLAAsL,EACtL;6EACyE,CAC1E;IACD,IAAI,EAAE,WAAW,CACf,MAAM,EACN,wIAAwI,EACxI;oDACgD,CACjD;CACF,CAAC;AAEF,gFAAgF;AAChF,SAAS,eAAe,CAAC,IAAgB;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACpD,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,GAAG,CAAC;AACb,CAAC;AAmDD,kFAAkF;AAClF,SAAS,gBAAgB,CAAC,CAAY;IACpC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,iBAAiB,CAAC;IACtD,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,aAAa,CAAC;IAChD,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAChD,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC;IACtE,CAAC;IACD,qEAAqE;IACrE,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;AACxG,CAAC;AAED,+EAA+E;AAC/E,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,yEAAyE;AACzE,SAAS,SAAS,CAAC,MAAoB;IACrC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxB,KAAK,EAAE,CAAC,CAAC,IAAI;QACb,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK;QACjC,KAAK,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;KACpB,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;kCAKkC;AAClC,SAAS,aAAa,CAAC,CAAY;IACjC,uEAAuE;IACvE,oEAAoE;IACpE,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;IAChE,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,OAAO,YAAY,QAAQ,YAAY,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;AACvE,CAAC;AAED;oFACoF;AACpF,SAAS,YAAY,CAAC,IAAgB;IACpC,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAClC,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC;YAC3B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,EAAE,GAAiB;QACvB,eAAe,EAAE,gBAAgB;QACjC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC;QAC1B,KAAK;QACL,QAAQ;KACT,CAAC;IACF,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,EAAE,KAAK,SAAS;QAAE,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC;IAC1C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;+DAC+D;AAC/D,SAAS,gBAAgB,CAAC,OAAgC;IACxD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,8EAA8E;IAC9E,iFAAiF;IACjF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACjD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,QAAQ,CAAC,CAAY;IAC5B,MAAM,EAAE,GAAa,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9F,yEAAyE;IACzE,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnD,EAAE,CAAC,SAAS,GAAG,WAAW,CAAC,CAAC,SAAS,aAAa,CAAC;IACrD,CAAC;IACD,+EAA+E;IAC/E,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACxD,EAAE,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,SAAS,iBAAiB,CAAC;IACnD,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS;QAAE,EAAE,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;IACpD,+EAA+E;IAC/E,8EAA8E;IAC9E,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC;QACpB,EAAE,CAAC,aAAa,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACvC,EAAE,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;kFAEkF;AAClF,MAAM,UAAU,mBAAmB,CACjC,IAAgB,EAChB,QAAkB,EAClB,aAAsB;IAEtB,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC;IACvE,OAAO,MAAM,CAAC;QACZ,GAAG,EAAE,eAAe;QACpB,OAAO;QACP,QAAQ;QACR,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;AACL,CAAC;AAcD;6DAC6D;AAC7D,MAAM,kBAAkB,GAAkC;IACxD,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,WAAW;IACrB,aAAa,EAAE,aAAa;IAC5B,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF;8EAC8E;AAC9E,SAAS,WAAW,CAAC,IAAgB;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;QAC7D,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QACtB,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;AACnE,CAAC;AAED,SAAS,QAAQ,CAAC,MAAoB,EAAE,IAAgB;IACtD,uEAAuE;IACvE,0EAA0E;IAC1E,+DAA+D;IAC/D,8DAA8D;IAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACzF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI;QACJ,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC;QAC1B,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;QAChC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED;2EAC2E;AAC3E,MAAM,UAAU,cAAc,CAAC,KAAe,EAAE,MAAoB,EAAE,QAAkB;IACtF,MAAM,MAAM,GAAG,CAAC,CAAa,EAAE,CAAa,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjF,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEpF,MAAM,OAAO,GAAG;QACd,eAAe,EAAE,gBAAgB;QACjC,KAAK,EAAE,eAAe;QACtB,KAAK,EAAE,wEAAwE;QAC/E,WAAW,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC;QAChC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAClD,YAAY,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;QAClC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;KACrD,CAAC;IACF,OAAO,MAAM,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AAC3E,CAAC;AA4BD;;;;;;;;;;;;GAYG;AACH,SAAS,cAAc,CAAC,CAAY;IAClC,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,SAAS,CAAC;IACxE,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,aAAa,CAAC,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC;QACxC,KAAK,aAAa;YAChB,kEAAkE;YAClE,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC;gBAC1C,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,KAAK,EAAE,CAAC;gBACxD,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClB,KAAK,YAAY;YACf,OAAO,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,KAAK,GAAG,CAAC,CAAC;QAC7D,KAAK,MAAM,CAAC;QACZ,KAAK,WAAW;YACd,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,UAAU,KAAK,EAAE,CAAC;QACpG,KAAK,WAAW,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC,CAAC,SAAS,OAAO,CAAC,CAAC,OAAO,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACjE,KAAK,UAAU;YACb,4EAA4E;YAC5E,OAAO,SAAS,CAAC,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC;QACpC,KAAK,UAAU;YACb,0EAA0E;YAC1E,2EAA2E;YAC3E,0BAA0B;YAC1B,OAAO,CAAC,CAAC,SAAS,CAAC;QACrB;YACE,OAAO,CAAC,CAAC,SAAS,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;;;wEAMwE;AACxE,SAAS,WAAW,CAAC,IAAgB;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyD,CAAC;IAElF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC/B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;QACD,6EAA6E;QAC7E,sEAAsE;QACtE,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;QAChE,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9D,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAExD,MAAM,GAAG,GAAkB,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAC5E,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;YAAE,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC;QACvE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACvB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QAC7B,OAAO;YACL,YAAY,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,YAAY,CAAC,GAAG,CAAC,GAAG;YAC5E,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;sDAIsD;AACtD,MAAM,UAAU,cAAc,CAAC,KAAe,EAAE,QAAkB;IAChE,MAAM,KAAK,GAAkB,KAAK,CAAC,KAAK;SACrC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;SACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,EAAE,GAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,2EAA2E;QAC3E,uDAAuD;QACvD,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,EAAE,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IACL,gFAAgF;IAChF,0EAA0E;IAC1E,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG;QACd,eAAe,EAAE,gBAAgB;QACjC,KAAK,EAAE,qBAAqB;QAC5B,6EAA6E;QAC7E,0EAA0E;QAC1E,4EAA4E;QAC5E,iBAAiB;QACjB,OAAO,EAAE,cAAc;QACvB,mEAAmE;QACnE,UAAU,EAAE,0DAA0D;QACtE,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC;QAC1B,KAAK;QACL,KAAK;KACN,CAAC;IACF,OAAO,MAAM,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED;wEACwE;AACxE,SAAS,oBAAoB,CAAC,KAAe;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IACD,OAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAW;SACzC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { MetaObject } from "@metaobjectsdev/metadata";
+import type { GeneratorFactory } from "../generator.js";
+export interface ApiDocsFileOpts {
+    filter?: (entity: MetaObject) => boolean;
+    target?: string;
+    /** Output prefix for all api-docs artifacts. Default `docs/api`. */
+    subDir?: string;
+    /** When true, the model surface is emitted alongside the api surface (at the
+     *  docs root), so each api entity page cross-links back to its model page. The
+     *  href is computed via the shared `surfaceCrossHref` so it resolves in BOTH
+     *  layouts. ABSENT/false ⇒ default api output byte-identical. */
+    modelSurface?: boolean;
+}
+/**
+ * @deprecated ADR-0025: `meta docs` is the single door for ALL docs. `apiDocsFile()`
+ * stays as the INTERNAL engine of the docs door's api surface — do NOT add it to a
+ * `meta gen` config / the generators array. Use `meta docs` (it emits the api surface
+ * alongside the model surface). A `meta gen` config that lists it is warned + skipped.
+ */
+export declare const apiDocsFile: GeneratorFactory<ApiDocsFileOpts>;
+//# sourceMappingURL=api-docs-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-docs-file.d.ts","sourceRoot":"","sources":["../../src/generators/api-docs-file.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAa,gBAAgB,EAAe,MAAM,iBAAiB,CAAC;AA2BhF,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;qEAGiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAwEnB,gBAAgB,CAAC,eAAe,CAAC,CAAC"}

package/dist/generators/api-docs-file.js

@@ -0,0 +1,112 @@
+// apiDocsFile() — the `api-docs` GENERATOR (ADR-0022 Part 3, Tier-1 NATIVE).
+//
+// It documents the PUBLIC API surface the OTHER generators emit for a model —
+// the generated code's own API, in two forms (a human reference + a condensed
+// agent form). It is a thin wiring layer: it REUSES, without re-derivation,
+//   • Task-1's buildApiModel() — the accurate-by-construction IR, and
+//   • Task-2's renderEntityApiPage / renderApiIndex / renderAgentApi renderers,
+//   • the shared docs-paths placement (collision-safe, layout-aware) that
+//     docsFile() uses — so multi-package models never silently overwrite a page.
+//
+// Output (all under `docs/api/`):
+//   • one `<Node>.md` per entity + template.output unit (the human page),
+//   • `README.md` — the consolidated human index (GitHub treats it as landing),
+//   • `AGENT-API.md` — the token-frugal agent form.
+//
+// Unlike `docs`/`mermaid-er` (Tier-2 neutral, owned by `meta docs`), `api-docs`
+// is a NATIVE generator: it is REGISTERED in the generator registry (ADR-0022
+// Part 3) — so it appears in `gen --list` and is selectable by its stable name
+// `api-docs`. It is NOT a `meta docs` mode.
+//
+// It is NOT (yet) part of the default `meta gen` scaffold suite: it is
+// registry-listed but not auto-run. Turning it on by default in the scaffold,
+// and surfacing the agent form (AGENT-API.md) to a coding agent via a pointer
+// from the installed `.metaobjects/` context, are tracked as agent-context-
+// coordination follow-ups — deliberately deferred here to avoid colliding with
+// the live agent-context work.
+import { docPageOutputPath, surfaceCrossHref, assertNoDuplicateDocPaths, } from "../docs-paths.js";
+import { projectProvider } from "../render-engine/framework-provider.js";
+import { buildApiModel } from "./api-model.js";
+import { renderEntityApiPage, renderApiIndex, renderAgentApi, } from "./api-doc-render.js";
+// All api-docs artifacts live under this sub-directory of the codegen out dir.
+// Per-unit pages fold further under their package path (package layout); the
+// index + agent form stay at the api root (their links are computed relative to
+// it via the same docPageHref the renderers use).
+//
+// The DEFAULT prefix is `docs/api` — byte-identical to the historical `meta gen`
+// behaviour + goldens. The unified `meta docs` command (which writes everything
+// under one docs root, `./docs`) overrides it via `subDir:'api'` so the api
+// surface emits `api/<Node>.md` rather than doubling to `./docs/docs/api`.
+const DEFAULT_API_DIR = "docs/api";
+/**
+ * @deprecated ADR-0025: `meta docs` is the single door for ALL docs. `apiDocsFile()`
+ * stays as the INTERNAL engine of the docs door's api surface — do NOT add it to a
+ * `meta gen` config / the generators array. Use `meta docs` (it emits the api surface
+ * alongside the model surface). A `meta gen` config that lists it is warned + skipped.
+ */
+export const apiDocsFile = function apiDocsFile(opts) {
+    const generator = {
+        name: "api-docs",
+        generate(ctx) {
+            const provider = projectProvider(ctx.projectRoot ?? process.cwd());
+            const layout = ctx.config.outputLayout ?? "flat";
+            // Per-call output prefix. Default `docs/api`; `meta docs` passes `api`.
+            const apiDir = opts?.subDir ?? DEFAULT_API_DIR;
+            const indexFilename = `${apiDir}/README.md`;
+            const agentFilename = `${apiDir}/AGENT-API.md`;
+            // ONE ApiModel feeds every form (Task-1 builder; Task-2 renderers). The
+            // pkMap is reused from the run's renderContext when present (the real gen
+            // run always provides it) and derived otherwise.
+            // Auto-detect: document the OPT-IN Hono CRUD surface iff the Hono routes
+            // generator is actually in the run. The runner aggregates each generator's
+            // `emitsHonoRoutes` marker into ctx.config.includeHonoRoutes, so api-docs
+            // "just works" — it documents Hono exactly when `routesFileHono` is wired,
+            // and omits it (Fastify-only) otherwise. No explicit opt needed.
+            const model = buildApiModel(ctx.loadedRoot, {
+                loadedRoot: ctx.loadedRoot,
+                outputLayout: layout,
+                includeHonoRoutes: ctx.config.includeHonoRoutes ?? false,
+                ...(ctx.renderContext?.pkMap !== undefined && { pkMap: ctx.renderContext.pkMap }),
+            });
+            // Track (path, fqn) for the SAME hard collision backstop docsFile() uses —
+            // two units that resolve to one path (flat, cross-package short-name clash)
+            // throw rather than silently overwrite.
+            const placements = [];
+            // Per-unit human page. Placement is collision-safe via docPageOutputPath
+            // off {name, effective package}, prefixed under the api dir; the index
+            // (renderApiIndex) computes its links from the SAME {name, package}, so a
+            // link always points at the page's real location in BOTH layouts.
+            const files = model.units.map((unit) => {
+                const node = { name: unit.node, package: unit.package };
+                const path = `${apiDir}/${docPageOutputPath(layout, node)}`;
+                placements.push({ path, fqn: unit.package ? `${unit.package}::${unit.node}` : unit.node });
+                // Cross-link back to the sibling model page, when emitted. The model page
+                // lives at the docs root at `<placement>`; this api page lives at
+                // `<apiDir>/<placement>`. The href is derived from the SAME
+                // docPageOutputPath placement via surfaceCrossHref so it resolves in both
+                // layouts. ABSENT otherwise.
+                const modelPageHref = opts?.modelSurface
+                    ? surfaceCrossHref(path, docPageOutputPath(layout, node))
+                    : undefined;
+                return { path, content: renderEntityApiPage(unit, provider, modelPageHref) };
+            });
+            // The consolidated human index (README.md) + the condensed agent form,
+            // both at the api root. Only emitted when at least one unit page exists.
+            if (files.length > 0) {
+                placements.push({ path: indexFilename, fqn: "<the api-docs index page>" });
+                placements.push({ path: agentFilename, fqn: "<the api-docs agent form>" });
+                files.unshift({ path: indexFilename, content: renderApiIndex(model, layout, provider) }, { path: agentFilename, content: renderAgentApi(model, provider) });
+            }
+            // Hard backstop against silent overwrite (ALL layouts): throw naming both
+            // colliding FQNs + the path. Same guard docsFile() reuses.
+            assertNoDuplicateDocPaths(placements);
+            return files;
+        },
+    };
+    if (opts?.filter)
+        generator.filter = opts.filter;
+    if (opts?.target)
+        generator.target = opts.target;
+    return generator;
+};
+//# sourceMappingURL=api-docs-file.js.map

package/dist/generators/api-docs-file.js.map

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

package/dist/generators/api-field-shape.d.ts

@@ -0,0 +1,39 @@
+import type { MetaObject, MetaRoot } from "@metaobjectsdev/metadata";
+/** One documented field in a model / payload shape. Structured so BOTH renderers
+ *  (the human field table + the agent inline shape) format it without re-deriving. */
+export interface FieldShape {
+    /** The field name (the property key). */
+    name: string;
+    /** The TS type expression, e.g. `string`, `number`, `"active" | "archived"`,
+     *  `Address[]`. Enum unions are inlined (self-contained for an agent). */
+    type: string;
+    /** Whether the property is optional in this shape (`name?: T`). */
+    optional: boolean;
+    /** A short note, e.g. `pinned "Bridge"` (TPH discriminator) or `server-set`
+     *  (@autoSet). Undefined when there is nothing extra to say. */
+    note?: string;
+}
+/**
+ * The entity MODEL field shape — every field, with the value-object interface's
+ * TS type and the docs nullable rule (optional iff not required and not the PK).
+ * Mirrors `InferSelectModel` field-presence; the PK is reported required.
+ */
+export declare function modelFieldShapes(obj: MetaObject): FieldShape[];
+/** The create-payload (InsertSchema) field shape — what `create<Name>` / POST
+ *  accepts. */
+export declare function createFieldShapes(obj: MetaObject): FieldShape[];
+/** The update-payload (UpdateSchema) field shape — what `update<Name>` / PATCH
+ *  accepts (typically all-optional partial). */
+export declare function updateFieldShapes(obj: MetaObject): FieldShape[];
+/**
+ * The extractor PAYLOAD field shape — the field interface of the value object
+ * `extract<Name>` returns (the `@payloadRef` target). Same `fieldTsTypeString`
+ * mapping + `isFieldRequired` optionality the VO interface emitter uses, so it
+ * matches the emitted payload type. Returns undefined when the ref does not
+ * resolve to a loaded object.
+ */
+export declare function payloadFieldShapes(root: MetaRoot, payloadRef: string): FieldShape[] | undefined;
+/** Format a list of field shapes as a compact inline TS object type, e.g.
+ *  `{ name: string; status?: "active" | "archived" }`. Empty list → `{}`. */
+export declare function inlineShape(fields: FieldShape[]): string;
+//# sourceMappingURL=api-field-shape.d.ts.map

package/dist/generators/api-field-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-field-shape.d.ts","sourceRoot":"","sources":["../../src/generators/api-field-shape.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,UAAU,EAAa,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAShF;sFACsF;AACtF,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb;8EAC0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,QAAQ,EAAE,OAAO,CAAC;IAClB;oEACgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,EAAE,CAW9D;AAuBD;eACe;AACf,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,EAAE,CAE/D;AAED;gDACgD;AAChD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,EAAE,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,SAAS,CAI/F;AAED;6EAC6E;AAC7E,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAIxD"}