refactor(docs): drop dead referencedFields, fix trailing-space in template page, add byte-exact goldens

Author: dmealing

fixtures/conformance/template-doc-document/expected/Welcome.md

@@ -0,0 +1,17 @@
+<!-- @generated by @metaobjectsdev/codegen-ts — DO NOT EDIT. -->
+
+# Welcome
+
+**Type:** `object.value`
+**Source:** `meta.json`
+
+## Constraints
+
+| Field | Required | Type | Limits | Rules |
+|---|---|---|---|---|
+| `name` |  | `string` |  |  |
+| `headline` |  | `string` |  |  |
+
+## Used by
+
+- [`template.output WelcomePage`](./WelcomePage.md) — uses `Welcome` as `@payloadRef`

fixtures/conformance/template-doc-document/expected/WelcomePage.md

@@ -0,0 +1,28 @@
+<!-- @generated by @metaobjectsdev/codegen-ts — DO NOT EDIT. -->
+
+# WelcomePage
+
+**Kind:** document
+
+## Output
+
+- Format: `html`
+
+## Input
+
+- Payload: [`Welcome`](./Welcome.md)
+- Required fields: `section`
+
+## Render contract
+
+- Every field referenced by the template is validated against the payload at generation time; an unknown field fails generation.
+- Maximum length: 5000 characters (rendering longer output fails).
+- Required tags must be present: `section`
+
+## Source
+
+- `site/welcome`
+
+## Capability
+
+A render helper is generated for this template: it takes the payload and returns the rendered output as a single string.

fixtures/conformance/template-doc-email/expected/Welcome.md

@@ -0,0 +1,17 @@
+<!-- @generated by @metaobjectsdev/codegen-ts — DO NOT EDIT. -->
+
+# Welcome
+
+**Type:** `object.value`
+**Source:** `meta.json`
+
+## Constraints
+
+| Field | Required | Type | Limits | Rules |
+|---|---|---|---|---|
+| `name` |  | `string` |  |  |
+| `headline` |  | `string` |  |  |
+
+## Used by
+
+- [`template.output WelcomeEmail`](./WelcomeEmail.md) — uses `Welcome` as `@payloadRef`

fixtures/conformance/template-doc-email/expected/WelcomeEmail.md

@@ -0,0 +1,33 @@
+<!-- @generated by @metaobjectsdev/codegen-ts — DO NOT EDIT. -->
+
+# WelcomeEmail
+
+**Kind:** email
+
+## Output
+
+Multipart email — rendered as the following parts:
+
+| Part | Source | Format | Escaping |
+|---|---|---|---|
+| Subject | `email/welcome.subject` | `text` | raw |
+| HTML body | `email/welcome.html` | `html` | escaped |
+| Text body | `email/welcome.text` | `text` | raw |
+
+## Input
+
+- Payload: [`Welcome`](./Welcome.md)
+
+## Render contract
+
+- Every field referenced by the template is validated against the payload at generation time; an unknown field fails generation.
+
+## Source
+
+- `email/welcome.subject`
+- `email/welcome.html`
+- `email/welcome.text`
+
+## Capability
+
+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.

server/typescript/packages/codegen-ts/src/generators/template-doc-builder.ts

@@ -111,7 +111,6 @@ export function buildTemplateDocData(template: MetaData): TemplateDocData {
     isEmail,
     format,
     payload: { name: payloadName, link: `./${payloadName}.md` },
-    referencedFields: requiredTags,
     sourceRefs,
     capability: isEmail ? CAPABILITY_EMAIL : CAPABILITY_DOCUMENT,
   };

server/typescript/packages/codegen-ts/src/generators/template-doc-data.ts

@@ -53,12 +53,6 @@ export interface TemplateDocData {
    *  entity-page filename + the entity's Used-by back-link). */
   payload: { name: string; link: string };
 
-  /** Best-effort list of fields the template references. Sourced from
-   *  @requiredTags (the only declared field-level contract on a template.output
-   *  node); the full mustache-referenced field set is a build-time drift gate,
-   *  not declared metadata. Empty when none. */
-  referencedFields: string[];
-
   /** @requiredTags, if declared. Drives both the Input "Required fields" line
    *  and the Render-contract "Required tags" bullet. */
   requiredTags?: string[];

server/typescript/packages/codegen-ts/templates/docs/template-page.md.mustache

@@ -28,7 +28,7 @@ Multipart email — rendered as the following parts:
 
 - Payload: [`{{payload.name}}`]({{payload.link}})
 {{#hasRequiredTags}}
-- Required fields: {{#requiredTags}}`{{.}}` {{/requiredTags}}
+- Required fields:{{#requiredTags}} `{{.}}`{{/requiredTags}}
 {{/hasRequiredTags}}
 
 ## Render contract
@@ -38,7 +38,7 @@ Multipart email — rendered as the following parts:
 - Maximum length: {{.}} characters (rendering longer output fails).
 {{/maxChars}}
 {{#hasRequiredTags}}
-- Required tags must be present: {{#requiredTags}}`{{.}}` {{/requiredTags}}
+- Required tags must be present:{{#requiredTags}} `{{.}}`{{/requiredTags}}
 {{/hasRequiredTags}}
 
 ## Source

templates/docs/template-page.md.mustache

@@ -28,7 +28,7 @@ Multipart email — rendered as the following parts:
 
 - Payload: [`{{payload.name}}`]({{payload.link}})
 {{#hasRequiredTags}}
-- Required fields: {{#requiredTags}}`{{.}}` {{/requiredTags}}
+- Required fields:{{#requiredTags}} `{{.}}`{{/requiredTags}}
 {{/hasRequiredTags}}
 
 ## Render contract
@@ -38,7 +38,7 @@ Multipart email — rendered as the following parts:
 - Maximum length: {{.}} characters (rendering longer output fails).
 {{/maxChars}}
 {{#hasRequiredTags}}
-- Required tags must be present: {{#requiredTags}}`{{.}}` {{/requiredTags}}
+- Required tags must be present:{{#requiredTags}} `{{.}}`{{/requiredTags}}
 {{/hasRequiredTags}}
 
 ## Source