@metaobjectsdev/codegen-ts 0.9.0 → 0.10.0

package/dist/generators/template-doc-builder.js

@@ -0,0 +1,220 @@
+// Walk one `template.output` node (+ root) into the NEUTRAL TemplateDocData
+// shape the `docs/template-page.md` Mustache template consumes. The attr reads
+// MIRROR render-helper-file.ts / templates/render-helper.ts (@kind, @payloadRef,
+// @textRef, @format, @maxChars, @requiredTags; for email @subjectRef /
+// @htmlBodyRef / @textBodyRef) — but this builder emits DESCRIPTION, never code:
+// no helper signatures, no language types. `capability` is a FIXED, neutral
+// sentence per @kind.
+import { TEMPLATE_ATTR_PAYLOAD_REF, TEMPLATE_ATTR_TEXT_REF, TEMPLATE_ATTR_FORMAT, TEMPLATE_ATTR_MAX_CHARS, TEMPLATE_ATTR_KIND, TEMPLATE_KIND_EMAIL, TEMPLATE_KIND_DOCUMENT, TEMPLATE_KIND_DEFAULT, TEMPLATE_ATTR_SUBJECT_REF, TEMPLATE_ATTR_HTML_BODY_REF, TEMPLATE_ATTR_TEXT_BODY_REF, TEMPLATE_ATTR_REQUIRED_TAGS, DOC_ATTR_DESCRIPTION, stripPackage, } from "@metaobjectsdev/metadata";
+import { TYPE_TEMPLATE, TEMPLATE_SUBTYPE_OUTPUT, } from "@metaobjectsdev/metadata";
+import { GENERATED_HEADER } from "../constants.js";
+import { docPageHref, docPageNode } from "../docs-paths.js";
+import { fieldAnchorSlug } from "./field-anchor.js";
+import { buildEnrichedPayloadTree } from "./template-payload-tree.js";
+import { annotateTemplate } from "./template-source-annotate.js";
+import { renderSourceBlock, renderVariablesTable, renderRichLinkedHtml, } from "./template-source-render.js";
+// FIXED, language-NEUTRAL capability sentences. NO type names, NO signatures.
+const CAPABILITY_DOCUMENT = "A render helper is generated for this template: it takes the payload and " +
+    "returns the rendered output as a single string.";
+const CAPABILITY_EMAIL = "A render helper is generated for this template: it takes the payload and " +
+    "returns the rendered email — subject, HTML body, and an optional text body.";
+/** Read an attr that may be a string or string[] (string-array attrs come back
+ *  as string[]; a bare comma string is split defensively). Returns a trimmed,
+ *  non-empty string list. */
+function attrStringList(value) {
+    if (Array.isArray(value)) {
+        return value.filter((v) => typeof v === "string" && v.length > 0);
+    }
+    if (typeof value === "string" && value.trim() !== "") {
+        return value.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+    }
+    return [];
+}
+function readMaxChars(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "string" && value.trim() !== "") {
+        const n = Number(value);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return undefined;
+}
+function templateDescription(t) {
+    const v = t.attr(DOC_ATTR_DESCRIPTION);
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+/** Page-placement node for a metadata object resolved by short name, with the
+ *  SAME package-less fallback the Payload cross-link and field hrefs share: when
+ *  the object can't be resolved off the root, fall back to a root-level node so a
+ *  link is still emitted. Keeps every inbound href routing through the one
+ *  `docPageHref(layout, …)` placement. */
+function pageNodeByName(root, name) {
+    const obj = root?.findObject(name);
+    return obj !== undefined ? docPageNode(obj) : { name };
+}
+/** Build the TemplateDocData for one `template.output` node. */
+export function buildTemplateDocData(template, opts) {
+    const layout = opts?.layout ?? "flat";
+    const root = opts?.loadedRoot;
+    const kindRaw = (template.ownAttr(TEMPLATE_ATTR_KIND) ??
+        TEMPLATE_KIND_DEFAULT).toLowerCase();
+    const isEmail = kindRaw === TEMPLATE_KIND_EMAIL;
+    const kind = isEmail ? TEMPLATE_KIND_EMAIL : TEMPLATE_KIND_DOCUMENT;
+    const payloadRefRaw = template.ownAttr(TEMPLATE_ATTR_PAYLOAD_REF);
+    const payloadName = typeof payloadRefRaw === "string" && payloadRefRaw.length > 0
+        ? stripPackage(payloadRefRaw)
+        : "unknown";
+    const requiredTags = attrStringList(template.ownAttr(TEMPLATE_ATTR_REQUIRED_TAGS));
+    const maxChars = readMaxChars(template.ownAttr(TEMPLATE_ATTR_MAX_CHARS));
+    let format = "";
+    let parts;
+    const sourceRefs = [];
+    if (isEmail) {
+        const subjectRef = template.ownAttr(TEMPLATE_ATTR_SUBJECT_REF);
+        const htmlBodyRef = template.ownAttr(TEMPLATE_ATTR_HTML_BODY_REF);
+        const textBodyRef = template.ownAttr(TEMPLATE_ATTR_TEXT_BODY_REF);
+        parts = [];
+        if (typeof subjectRef === "string") {
+            parts.push({ label: "Subject", ref: subjectRef, format: "text", escaped: false });
+            sourceRefs.push(subjectRef);
+        }
+        if (typeof htmlBodyRef === "string") {
+            parts.push({ label: "HTML body", ref: htmlBodyRef, format: "html", escaped: true });
+            sourceRefs.push(htmlBodyRef);
+        }
+        if (typeof textBodyRef === "string") {
+            parts.push({ label: "Text body", ref: textBodyRef, format: "text", escaped: false });
+            sourceRefs.push(textBodyRef);
+        }
+    }
+    else {
+        format = (template.ownAttr(TEMPLATE_ATTR_FORMAT) ?? "text").toLowerCase();
+        const textRef = template.ownAttr(TEMPLATE_ATTR_TEXT_REF);
+        if (typeof textRef === "string")
+            sourceRefs.push(textRef);
+    }
+    // Cross-link to the payload entity's page. The href is derived from the SAME
+    // page-placement function used to write that entity page, so it resolves in
+    // BOTH layouts (package layout folds the correct relative path).
+    const payloadLink = docPageHref(layout, docPageNode(template), pageNodeByName(root, payloadName));
+    const data = {
+        generatedMarker: `<!-- ${GENERATED_HEADER} — DO NOT EDIT. -->`,
+        name: template.name,
+        kind,
+        isEmail,
+        format,
+        payload: { name: payloadName, link: payloadLink },
+        sourceRefs,
+        capability: isEmail ? CAPABILITY_EMAIL : CAPABILITY_DOCUMENT,
+    };
+    if (parts !== undefined)
+        data.parts = parts;
+    if (requiredTags.length > 0) {
+        data.requiredTags = requiredTags;
+        data.hasRequiredTags = true;
+    }
+    if (maxChars !== undefined)
+        data.maxChars = maxChars;
+    // ── "## Template source" section (Task 4) ────────────────────────────────
+    // Resolve each referenced mustache's SOURCE TEXT via the page provider, then
+    // annotate it against the ENRICHED payload tree (owner/type/required per node)
+    // and pre-render the three doc forms. Only when a provider + a resolvable
+    // payload VO are available; a ref that doesn't resolve is skipped (no crash).
+    if (opts?.provider !== undefined && root !== undefined && payloadName !== "unknown") {
+        const section = buildTemplateSourceSection({
+            provider: opts.provider,
+            root,
+            layout,
+            template,
+            payloadName,
+            // Document: the single @textRef (unlabeled). Email: one labeled part each.
+            refs: parts !== undefined
+                ? parts.map((p) => ({ label: p.label, ref: p.ref }))
+                : sourceRefs.map((ref) => ({ ref })),
+        });
+        if (section !== undefined)
+            data.templateSourceSection = section;
+    }
+    const desc = templateDescription(template);
+    if (desc !== undefined) {
+        data.descriptionQuote = desc.split("\n").map((l) => `> ${l}`.trimEnd()).join("\n");
+    }
+    return data;
+}
+/**
+ * Build the PRE-RENDERED "## Template source" section markdown. For each ref:
+ * resolve its mustache source via the provider, annotate it against the enriched
+ * payload tree, and emit the fenced source block + the linked variables table +
+ * the rich `<details>` linked view. A document template yields one block; an
+ * email yields one `### <label>` sub-section per part. Refs whose source the
+ * provider can't resolve are skipped (graceful — the build-time drift gate
+ * already errors on a truly unresolved ref). Returns `undefined` when NOTHING
+ * resolved, so the caller omits the section entirely.
+ */
+function buildTemplateSourceSection(args) {
+    const { provider, root, layout, template, payloadName, refs } = args;
+    const tree = buildEnrichedPayloadTree(root, payloadName);
+    const fromNode = docPageNode(template);
+    // Layout-aware field href: route through the SAME docPageHref the Payload
+    // cross-link uses, so the link lands on the owner VO's REAL page in BOTH
+    // layouts (flat → `./Owner.md`, package → `../<pkg>/Owner.md`).
+    const fieldHref = (owner, name) => `${docPageHref(layout, fromNode, pageNodeByName(root, owner))}#${fieldAnchorSlug(name)}`;
+    const resolvePartialHref = makePartialHrefResolver(root, layout, fromNode);
+    const isMultipart = refs.length > 1 || refs.some((r) => r.label !== undefined);
+    const blocks = [];
+    for (const spec of refs) {
+        const source = provider.resolve(spec.ref);
+        if (source === undefined)
+            continue; // missing source → skip this part.
+        const tokens = annotateTemplate(source, tree, {
+            ownerVoName: payloadName,
+            resolvePartialHref,
+            fieldHref,
+        });
+        const parts = [];
+        if (isMultipart && spec.label !== undefined)
+            parts.push(`### ${spec.label}`);
+        parts.push(renderSourceBlock(tokens));
+        const table = renderVariablesTable(tokens);
+        if (table !== "")
+            parts.push(table);
+        parts.push(renderRichLinkedHtml(tokens));
+        blocks.push(parts.join("\n\n"));
+    }
+    if (blocks.length === 0)
+        return undefined;
+    return ["## Template source", "", blocks.join("\n\n")].join("\n");
+}
+/**
+ * A `{{>ref}}` partial-href resolver: returns a relative href to the page of the
+ * `template.output` node that documents `ref` (it is one of that template's
+ * source refs — @textRef or an email part ref), else undefined (the partial is
+ * highlight-only). The href routes through the SAME `docPageHref(layout, …)` the
+ * field/Payload links use, so it resolves in BOTH layouts (flat → `./Name.md`,
+ * package → a correct relative path like `../comms/OrderEmail.md`).
+ */
+function makePartialHrefResolver(root, layout, fromNode) {
+    // Map each documented source ref → the template node that documents it.
+    const refToTemplate = new Map();
+    for (const child of root.ownChildren()) {
+        if (child.type !== TYPE_TEMPLATE || child.subType !== TEMPLATE_SUBTYPE_OUTPUT)
+            continue;
+        for (const attr of [
+            TEMPLATE_ATTR_TEXT_REF,
+            TEMPLATE_ATTR_SUBJECT_REF,
+            TEMPLATE_ATTR_HTML_BODY_REF,
+            TEMPLATE_ATTR_TEXT_BODY_REF,
+        ]) {
+            const v = child.ownAttr(attr);
+            if (typeof v === "string" && v.length > 0 && !refToTemplate.has(v)) {
+                refToTemplate.set(v, child);
+            }
+        }
+    }
+    return (ref) => {
+        const node = refToTemplate.get(ref);
+        return node !== undefined ? docPageHref(layout, fromNode, docPageNode(node)) : undefined;
+    };
+}
+//# sourceMappingURL=template-doc-builder.js.map

package/dist/generators/template-doc-builder.js.map

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

package/dist/generators/template-doc-data.d.ts

@@ -0,0 +1,62 @@
+/** One part of a multipart (email) template — a single rendered source ref with
+ *  its format and whether the renderer escapes its output for that format. */
+export interface TemplateOutputPart {
+    /** Human-readable part label, e.g. "Subject", "HTML body", "Text body". */
+    label: string;
+    /** The logical text ref rendered for this part (e.g. "email/welcome.html"). */
+    ref: string;
+    /** Render format for this part: "text" | "html" (subject/text = text, html = html). */
+    format: string;
+    /** True iff the renderer escapes output for this part's format (html → true). */
+    escaped: boolean;
+}
+export interface TemplateDocData {
+    /** @markdown — the generated-by marker, echoed at the top of the page. */
+    generatedMarker: string;
+    /** Raw template node name — also the emitted filename (`<name>.md`). */
+    name: string;
+    /** @kind — "document" | "email". */
+    kind: "document" | "email";
+    /** Convenience flag for the Mustache template (no "is X" primitive). */
+    isEmail: boolean;
+    /** @markdown — description as a blockquote (one `> ` per line). Present iff
+     *  the template declares a @description. Mirrors EntityDocData. */
+    descriptionQuote?: string;
+    /** Document: the @format (e.g. "html"). Email: "" — the parts carry format. */
+    format: string;
+    /** Email only: the ordered multipart parts (subject, html body, text body?). */
+    parts?: TemplateOutputPart[];
+    /** The payload object the template renders from. `link` is `./<rawName>.md` —
+     *  the payload entity's own doc page (raw-name convention, matching the
+     *  entity-page filename + the entity's Used-by back-link). */
+    payload: {
+        name: string;
+        link: string;
+    };
+    /** @requiredTags, if declared. Drives both the Input "Required fields" line
+     *  and the Render-contract "Required tags" bullet. */
+    requiredTags?: string[];
+    /** Present-and-non-empty flag for @requiredTags (Mustache has no "non-empty
+     *  array" primitive; same idiom as EntityDocData's `has*` flags). */
+    hasRequiredTags?: boolean;
+    /** @maxChars, if declared (document only in practice). */
+    maxChars?: number;
+    /** The template refs this page renders: [@textRef] for a document, or the
+     *  2–3 email part refs. Drives the Source section. */
+    sourceRefs: string[];
+    /** FIXED, language-NEUTRAL capability sentence per @kind. No type names, no
+     *  function signatures. See template-doc-builder.ts. */
+    capability: string;
+    /**
+     * @markdown — the PRE-RENDERED "## Template source" section body (linked-
+     * template-source-docs, Task 4). Present iff at least one referenced mustache
+     * resolved to source via the page provider. For a document template it is one
+     * block; for an email it is one `### <part>` sub-section per part. Each carries
+     * the fenced ```mustache source, a linked variables table, and the rich
+     * `<details>` linked view — ALL pre-rendered in the builder (the page template
+     * just emits this markdown verbatim, like `descriptionQuote`), so the mustache
+     * page never re-parses the embedded `{{field}}` tokens. Absent when no
+     * referenced source resolved (the section is omitted, not empty). */
+    templateSourceSection?: string;
+}
+//# sourceMappingURL=template-doc-data.d.ts.map

package/dist/generators/template-doc-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-doc-data.d.ts","sourceRoot":"","sources":["../../src/generators/template-doc-data.ts"],"names":[],"mappings":"AAeA;8EAC8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;IACZ,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAC;IAExB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IAEb,oCAAoC;IACpC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3B,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;IAEjB;uEACmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IAEf,gFAAgF;IAChF,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAE7B;;kEAE8D;IAC9D,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAExC;0DACsD;IACtD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;yEACqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;0DACsD;IACtD,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB;4DACwD;IACxD,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;yEASqE;IACrE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/dist/generators/template-doc-data.js

@@ -0,0 +1,16 @@
+// Data-dict shape for the NEUTRAL template.output doc page (the "render
+// contract" page). Sibling of EntityDocData (docs-data.ts) — same public-API
+// stability contract: template authors who write a custom Mustache file for
+// `docs/template-page.md` reference these keys.
+//
+// CRITICAL — NEUTRALITY: this shape carries NO language assumptions. There are
+// no generated-helper signatures, no language type names, no SDK tokens. The
+// `capability` field is a FIXED, language-neutral English sentence per @kind
+// (see template-doc-builder.ts). The page describes the RENDER CONTRACT (what
+// the template references, validates, and produces), not any one port's code.
+//
+// Markdown-flavored, like EntityDocData: a few fields are pre-rendered (the
+// parts table is structural, but escaping / raw-vs-escaped wording lives in the
+// builder so the template stays trivial and cross-port walks don't re-derive it).
+export {};
+//# sourceMappingURL=template-doc-data.js.map

package/dist/generators/template-doc-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-doc-data.js","sourceRoot":"","sources":["../../src/generators/template-doc-data.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,6EAA6E;AAC7E,4EAA4E;AAC5E,gDAAgD;AAChD,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,kFAAkF"}

package/dist/generators/template-payload-tree.d.ts

@@ -0,0 +1,15 @@
+import { type MetaRoot } from "@metaobjectsdev/metadata";
+import type { AnnotatePayloadField } from "./template-source-annotate.js";
+/**
+ * Walk the payload VO `voName` into an enriched `AnnotatePayloadField[]`. Each
+ * node carries `owner` (the short name of the VO that DECLARES the field — the
+ * link target), `type` (the neutral logical type), and `required`. Object-ref
+ * fields recurse into their referenced VO with `owner` switched to that nested
+ * VO; a `seen` set guards a (pathological) reference cycle (returns `[]` rather
+ * than recursing forever).
+ *
+ * Returns `[]` when the VO can't be resolved — the annotator then leaves the
+ * referencing variables unresolved (flagged "not on payload"), never throws.
+ */
+export declare function buildEnrichedPayloadTree(root: MetaRoot, voName: string, seen?: ReadonlySet<string>): AnnotatePayloadField[];
+//# sourceMappingURL=template-payload-tree.d.ts.map

package/dist/generators/template-payload-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-payload-tree.d.ts","sourceRoot":"","sources":["../../src/generators/template-payload-tree.ts"],"names":[],"mappings":"AAoBA,OAAO,EAEL,KAAK,QAAQ,EAId,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,WAAW,CAAC,MAAM,CAAa,GACpC,oBAAoB,EAAE,CAyBxB"}

package/dist/generators/template-payload-tree.js

@@ -0,0 +1,61 @@
+// Enriched payload-field tree for the template-source annotator
+// (linked-template-source-docs, Task 4).
+//
+// The render-helper drift gate walks the payload VO into a bare `PayloadField[]`
+// (name + nested fields) — enough to VERIFY that a `{{field}}` exists. The doc
+// page needs MORE per node: which VO OWNS the field (so the link points at the
+// right entity page), the field's NEUTRAL type, and whether it's required — the
+// exact same facts the entity Constraints table shows.
+//
+// This walk produces that `AnnotatePayloadField[]`. It is the same recursion the
+// render-helper's `derivePayloadFieldTree` does (object-ref fields recurse into
+// their referenced VO; a `seen` set guards a reference cycle) — but it carries
+// owner/type/required and SWITCHES owner to the nested VO when it descends, so a
+// `{{address.city}}` resolves to `Address.city` and links to `./Address.md`.
+//
+// Reuse, not reimplementation:
+//   • isFieldRequired / neutralTypeStr — the SAME helpers the entity Constraints
+//     table uses, so the documented type/required can never drift from the
+//     entity page.
+import { FIELD_SUBTYPE_OBJECT, FIELD_ATTR_OBJECT_REF, stripPackage, } from "@metaobjectsdev/metadata";
+import { isFieldRequired, neutralTypeStr } from "./docs-data-builder.js";
+/**
+ * Walk the payload VO `voName` into an enriched `AnnotatePayloadField[]`. Each
+ * node carries `owner` (the short name of the VO that DECLARES the field — the
+ * link target), `type` (the neutral logical type), and `required`. Object-ref
+ * fields recurse into their referenced VO with `owner` switched to that nested
+ * VO; a `seen` set guards a (pathological) reference cycle (returns `[]` rather
+ * than recursing forever).
+ *
+ * Returns `[]` when the VO can't be resolved — the annotator then leaves the
+ * referencing variables unresolved (flagged "not on payload"), never throws.
+ */
+export function buildEnrichedPayloadTree(root, voName, seen = new Set()) {
+    if (seen.has(voName))
+        return [];
+    const vo = root.findObject(voName);
+    if (vo === undefined)
+        return [];
+    const owner = stripPackage(vo.name);
+    const nextSeen = new Set(seen).add(voName);
+    const out = [];
+    for (const f of vo.fields()) {
+        const node = {
+            name: f.name,
+            owner,
+            type: neutralTypeStr(f),
+            required: isFieldRequired(f),
+        };
+        if (f.subType === FIELD_SUBTYPE_OBJECT) {
+            const ref = f.ownAttr(FIELD_ATTR_OBJECT_REF);
+            if (typeof ref === "string" && ref.length > 0) {
+                // Owner switches to the nested VO for its fields (the recursion below
+                // re-derives `owner` from the resolved VO's own name).
+                node.fields = buildEnrichedPayloadTree(root, stripPackage(ref), nextSeen);
+            }
+        }
+        out.push(node);
+    }
+    return out;
+}
+//# sourceMappingURL=template-payload-tree.js.map

package/dist/generators/template-payload-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-payload-tree.js","sourceRoot":"","sources":["../../src/generators/template-payload-tree.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,yCAAyC;AACzC,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,uDAAuD;AACvD,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,+EAA+E;AAC/E,iFAAiF;AACjF,6EAA6E;AAC7E,EAAE;AACF,+BAA+B;AAC/B,iFAAiF;AACjF,2EAA2E;AAC3E,mBAAmB;AAEnB,OAAO,EAGL,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGzE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAc,EACd,MAAc,EACd,OAA4B,IAAI,GAAG,EAAE;IAErC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,EAAE,GAA2B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAyB;YACjC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK;YACL,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;YACvB,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC;SAC7B,CAAC;QACF,IAAI,CAAC,CAAC,OAAO,KAAK,oBAAoB,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;YAC7C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9C,sEAAsE;gBACtE,uDAAuD;gBACvD,IAAI,CAAC,MAAM,GAAG,wBAAwB,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/generators/template-source-annotate.d.ts

@@ -0,0 +1,74 @@
+import { type PayloadField } from "@metaobjectsdev/render";
+/**
+ * An enriched payload-field node. Structurally a verify `PayloadField` (so the
+ * shared resolver walks it), plus the per-field doc metadata the annotator needs
+ * to emit a `ResolvedField` + link: `owner` (the VO that declares the field),
+ * `type`, and `required`. Container fields (object / array-of-object) carry
+ * `fields` whose nodes are owned by the nested VO.
+ */
+export interface AnnotatePayloadField extends PayloadField {
+    owner: string;
+    type: string;
+    required: boolean;
+    fields?: AnnotatePayloadField[];
+}
+/** The field a `{{variable}}` / `{{#section}}` resolves to. */
+export interface ResolvedField {
+    owner: string;
+    name: string;
+    type: string;
+    required: boolean;
+}
+/** One ordered token of the annotated template. `raw` is the verbatim source
+ *  span of the tag (text tokens carry `text`), so the source round-trips. */
+export type TplToken = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "var" | "unescaped";
+    raw: string;
+    path: string;
+    field?: ResolvedField;
+    href?: string;
+    valid: boolean;
+} | {
+    kind: "section" | "inverted" | "close";
+    raw: string;
+    path: string;
+    field?: ResolvedField;
+    href?: string;
+} | {
+    kind: "partial";
+    raw: string;
+    ref: string;
+    href?: string;
+} | {
+    kind: "comment";
+    raw: string;
+};
+export interface AnnotateOptions {
+    /** The root payload VO's short name (owner of the root-context fields). Used
+     *  only for diagnostics / callers; per-field owner comes off the tree node. */
+    ownerVoName: string;
+    /**
+     * Resolve a partial `{{>ref}}` to a doc-page href, if the ref names a
+     * documented template. Returns the href or undefined (highlight-only).
+     * Optional — when absent, partials are captured ref-only (no href).
+     */
+    resolvePartialHref?: (ref: string) => string | undefined;
+    /**
+     * Override how a resolved field's doc-page href is built (owner page + the
+     * shared `#field-<name>` fragment). Optional — when absent, the flat default
+     * `./<owner>.md#field-<name>` is used (byte-identical to today). A caller with
+     * the output layout + page placement in scope injects a layout-aware resolver
+     * (the SAME `docPageHref(layout, …)` the Payload cross-link uses) so the link
+     * resolves under package layout too.
+     */
+    fieldHref?: (owner: string, name: string) => string;
+}
+/**
+ * Parse `source` into an annotated IR, resolving each variable/section against
+ * the enriched `payload` tree using verify's shared resolution.
+ */
+export declare function annotateTemplate(source: string, payload: AnnotatePayloadField[], opts: AnnotateOptions): TplToken[];
+//# sourceMappingURL=template-source-annotate.d.ts.map

package/dist/generators/template-source-annotate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-source-annotate.d.ts","sourceRoot":"","sources":["../../src/generators/template-source-annotate.ts"],"names":[],"mappings":"AAoBA,OAAO,EAGN,KAAK,YAAY,EAEjB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;GAMG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;6EAC6E;AAC7E,MAAM,MAAM,QAAQ,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IACA,IAAI,EAAE,KAAK,GAAG,WAAW,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CACd,GACD;IACA,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACb,GACD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC/B;mFAC+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACzD;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACpD;AAkBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,oBAAoB,EAAE,EAC/B,IAAI,EAAE,eAAe,GACnB,QAAQ,EAAE,CAmKZ"}