@port60/template-kit 1.1.0 → 1.2.0

package/src/vendor/contract/v2.lock.json

@@ -202,6 +202,18 @@
             "pages",
             "sections"
           ],
+          "dependentSchemas": {
+            "heroImageLimit": {
+              "required": [
+                "heroImagery"
+              ],
+              "properties": {
+                "heroImagery": {
+                  "const": true
+                }
+              }
+            }
+          },
           "properties": {
             "pages": {
               "type": "array",
@@ -262,6 +274,53 @@
               "default": false,
               "description": "True when the layout renders the `worship` context (the prayer/service-times rail). Declared honesty: the choosers badge worship-enabled tenants toward looks that show their times, and warn on looks that don't. Requires supports.layout; the layout must actually branch on `worship`."
             },
+            "navigationModes": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "options",
+                "default"
+              ],
+              "properties": {
+                "options": {
+                  "type": "array",
+                  "minItems": 2,
+                  "maxItems": 2,
+                  "uniqueItems": true,
+                  "items": {
+                    "enum": [
+                      "simple",
+                      "mega"
+                    ]
+                  }
+                },
+                "default": {
+                  "enum": [
+                    "simple",
+                    "mega"
+                  ]
+                }
+              },
+              "description": "Explicit header presentation switch for this exact layout. Both simple and mega must be implemented without changing saved navigation nodes, destinations or metadata. Requires supports.layout. The host resolves an accepted saved menus.headerMode or this default into site.nav.headerMode. Mark the navigation root data-p60-navigation-mode with that resolved mode. Missing support preserves the historical layout and leaves saved preferences unused, never inferred from navigationHighlights."
+            },
+            "sectionCollectionLinkVisibility": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 7,
+              "uniqueItems": true,
+              "items": {
+                "enum": [
+                  "events",
+                  "articles",
+                  "courses",
+                  "campaigns",
+                  "services",
+                  "documents",
+                  "appealGrid"
+                ]
+              },
+              "description": "Supported collection section types whose existing onward link may be hidden. Every entry must also be in supports.sections and render its supplied collection destination on a permanent data-p60-collection-link anchor. Only section.showCollectionLink == false adds hidden; absent or true retains the template default link. Keep its shared label and destination unchanged, and never hide the heading, records, cards or individual record links. No new URLs, text override or positioning control."
+            },
             "navigationHighlights": {
               "type": "boolean",
               "default": false,
@@ -273,11 +332,55 @@
               "description": "True when the sections mark which node shows which field with data-p60-field, so the editor can put the caret on the page instead of in a side panel. The address is inside that section's own content: data-p60-field=\"title\", or data-p60-field=\"items.{{ forloop.index0 }}.label\" for an entry in a list. Purely additive: the attribute is markup, the contract is untouched, and a template that marks nothing keeps the section-level editor. The validator reads the marks from the source and warns on any that does not name a field of that section. Missing or false leaves this exact template version editing in the panel.",
               "$comment": "Follows the navigationHighlights pattern: declared honesty, proven by the validator."
             },
+            "sectionHeadingAlignment": {
+              "type": "object",
+              "maxProperties": 16,
+              "propertyNames": {
+                "enum": [
+                  "hero",
+                  "values",
+                  "cta",
+                  "homeHero",
+                  "impact",
+                  "events",
+                  "articles",
+                  "campaigns",
+                  "emergency",
+                  "stats",
+                  "appealGrid",
+                  "services",
+                  "documents",
+                  "people",
+                  "impactMap",
+                  "courses"
+                ]
+              },
+              "additionalProperties": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 3,
+                "uniqueItems": true,
+                "items": {
+                  "enum": [
+                    "start",
+                    "center",
+                    "end"
+                  ]
+                }
+              },
+              "description": "Explicit opt-in per supported section type to desktop heading alignment choices. Missing entries disable the editor control. The host projects section.headingAlignment only for declared options. Mark heading/eyebrow elements using data-p60-heading-align with that value. The shared base applies text-align at widths of at least 1024 CSS pixels; absent/empty hooks retain the template default at every width. The validator proves each declared option renders on real headings and cannot change unrelated content. No layout positioning is implied."
+            },
             "heroImagery": {
               "type": "boolean",
               "default": false,
               "description": "True when the homeHero renderer displays the tenant's hero photographs (homeHero.images, legacy imageUrl), always under a TREATMENT built from the template's own palette variables (scrim/tint/blend), never raw. Declared honesty, proven behaviourally at validation: the choosers badge photo-led tenants toward templates that show their images and warn on ones that won't. Requires the homeHero section among supports.sections."
             },
+            "heroImageLimit": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 6,
+              "description": "Maximum homeHero photographs this exact template version can present. Requires supports.heroImagery: true. Missing means one; no hero imagery means zero. Values above one require rendering every image in a fixture of the declared size or placing the hero_carousel island. Generic carousel behavior or island declarations alone do not opt in. This gates editor additions, never truncates saved photographs or changes an older artifact's rendering."
+            },
             "behaviors": {
               "type": "array",
               "items": {
@@ -551,6 +654,13 @@
             "footer"
           ],
           "properties": {
+            "headerMode": {
+              "enum": [
+                "simple",
+                "mega"
+              ],
+              "description": "Resolved header presentation only when the exact template declares navigationModes. The host uses the accepted saved preference or the declared default. Omitted for unsupported templates; never inferred from menu shape or highlights."
+            },
             "header": {
               "type": "array",
               "items": {
@@ -2627,6 +2737,17 @@
           ],
           "description": "The page opener: a headline with an optional kicker and sanitised rich-text intro.",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -2663,6 +2784,17 @@
           ],
           "description": "A set of principles shown as cards or a numbered list, per the template.",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -2738,6 +2870,17 @@
           ],
           "description": "A closing band: heading, optional line, one button.",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "heading",
               "kind": "text",
@@ -2783,6 +2926,17 @@
           ],
           "description": "The home opener. EVERY field optional: eyebrow/title derive from branding when absent, the lead OMITS when absent (never a fabricated placeholder), buttons fall back to platform defaults.",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -2845,7 +2999,7 @@
               "name": "images",
               "kind": "items",
               "required": false,
-              "description": "Hero photographs (0-6, uploaded through the platform pipeline). One = a main image; several = rotation material, a template with supports.heroImagery renders at least the first and MAY place the hero_carousel island (or a CSS scroll strip) for the rest. Like every field: absent means the template's designed no-photo state, never a placeholder.",
+              "description": "Hero photographs (0-6, uploaded through the platform pipeline). One = a main image; several = rotation material. A template with supports.heroImagery renders at least the first and may place the hero_carousel island (or a CSS scroll strip) for the rest. Declare supports.heroImageLimit above one to offer multiple photographs in the editor; missing means one, and absent heroImagery means zero. Saved photographs survive template switches and are never truncated by this capability. Like every field: absent means the template's designed no-photo state, never a placeholder.",
               "itemFields": [
                 {
                   "name": "imageUrl",
@@ -2913,6 +3067,17 @@
           ],
           "description": "What gifts make possible, optional intro plus icon/title/description cards. Claims must be truthful for the tenant.",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3002,6 +3167,23 @@
           "kind": "widget",
           "description": "Published events across registration modes. Render the supplied bounded site.content.events.items with this placement's authored introduction. Optional motion uses declared behaviours; ticket sales and RSVP stay on the platform-owned detail route supplied by each item.",
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3040,6 +3222,23 @@
           "kind": "widget",
           "description": "Published articles from the supplied bounded site.content.articles.items. Render the records with this placement's authored introduction and link through the supplied item URLs. Article engagement and comments remain platform islands on the detail page.",
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3081,6 +3280,23 @@
             "campaignsLabel"
           ],
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3118,6 +3334,17 @@
             "causes"
           ],
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "heading",
               "kind": "text",
@@ -3161,6 +3388,17 @@
           ],
           "description": "Big headline numbers, the at-a-glance impact band. Values are author-entered text (write them exactly as they should read), or, per item, a live figure the platform counts (`source`).",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3244,6 +3482,23 @@
             "causes"
           ],
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3333,6 +3588,23 @@
             "services"
           ],
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3370,6 +3642,23 @@
             "resources"
           ],
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3404,6 +3693,17 @@
           ],
           "description": "The key people behind the charity, trustees, staff, volunteers, as simple cards: name, position, an optional photograph (uploaded through the platform pipeline) and an optional one-line statement. Templates render a card grid that collapses to a single column on small screens; a card without a photo renders cleanly (initials or plain), never a placeholder face.",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3496,6 +3796,17 @@
           "description": "The organisation's impact map: a themed map whose points link existing content (campaigns, causes, articles, events, places), each opening a card derived from the linked thing. Place the `map` island, it brings the map, the points and the cards; your template brings placement and tokens (the island theming contract).",
           "context": [],
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3535,6 +3846,23 @@
             "home"
           ],
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -5274,7 +5602,7 @@
           "name": "language_switch",
           "label": "Language switch",
           "status": "available",
-          "description": "Switches between the platform's supported public languages while preserving the current route. The host supplies locale and text direction to Liquid and the document element.",
+          "description": "Temporarily inactive: currently renders nothing. Localisation supports a site's language and text direction; translated tenant content and an explicit per-site language choice need a separate opt-in design. The host supplies locale and direction independently. Do not add a replacement visitor selector.",
           "params": [],
           "stylingApi": [
             ".language-switch",

package/src/vendor/engine/presentation-capabilities.mjs

@@ -0,0 +1,45 @@
+// Exact-artifact opt-ins. Preferences survive template switches in the stored document;
+// only supported values reach the render context or the editor's controls.
+export const NAVIGATION_MODES = Object.freeze(['simple', 'mega']);
+export const COLLECTION_LINK_SECTIONS = Object.freeze([
+  'events', 'articles', 'courses', 'campaigns', 'services', 'documents', 'appealGrid'
+]);
+
+/** Editor addition limit, not a mutation or truncation of previously saved photographs. */
+export function heroImageLimitCapability(manifest) {
+  if (manifest?.supports?.heroImagery !== true) return 0;
+  const limit = manifest.supports.heroImageLimit;
+  return manifest.format === 'port60-liquid@2' && Number.isInteger(limit) && limit >= 1 && limit <= 6 ? limit : 1;
+}
+
+export function navigationModeCapabilities(manifest) {
+  if (manifest?.format !== 'port60-liquid@2' || manifest?.supports?.layout !== true) return null;
+  const declared = manifest.supports.navigationModes;
+  if (!declared || typeof declared !== 'object' || Array.isArray(declared)) return null;
+  const { options, default: fallback } = declared;
+  if (!Array.isArray(options) || options.length !== 2 || new Set(options).size !== 2
+    || options.some(option => !NAVIGATION_MODES.includes(option)) || !options.includes(fallback)) return null;
+  return { options: [...options], default: fallback };
+}
+
+export function resolvedNavigationMode(manifest, preference) {
+  const capability = navigationModeCapabilities(manifest);
+  return capability ? (capability.options.includes(preference) ? preference : capability.default) : undefined;
+}
+
+export function collectionLinkVisibilityCapabilities(manifest) {
+  if (manifest?.format !== 'port60-liquid@2') return [];
+  const sections = manifest?.supports?.sections;
+  const declared = manifest?.supports?.sectionCollectionLinkVisibility;
+  if (!Array.isArray(sections) || !Array.isArray(declared) || !declared.length
+    || new Set(declared).size !== declared.length
+    || declared.some(type => !COLLECTION_LINK_SECTIONS.includes(type) || !sections.includes(type))) return [];
+  return [...declared];
+}
+
+export function withCollectionLinkVisibility(content, type, manifest) {
+  const projected = { ...content };
+  if (!collectionLinkVisibilityCapabilities(manifest).includes(type)
+    || typeof projected.showCollectionLink !== 'boolean') delete projected.showCollectionLink;
+  return projected;
+}

package/src/vendor/engine/section-heading-alignment.mjs

@@ -0,0 +1,28 @@
+// Presentation choices are opt-in on the exact immutable artifact. Never mutate saved content:
+// switching to an unsupported template leaves the original choice available for a later switch.
+export const HEADING_ALIGNMENTS = Object.freeze(['start', 'center', 'end']);
+
+export function headingAlignmentCapabilities(manifest) {
+  if (manifest?.format !== 'port60-liquid@2') return {};
+  const declared = manifest?.supports?.sectionHeadingAlignment;
+  if (!declared || typeof declared !== 'object' || Array.isArray(declared)) return {};
+  const sections = manifest?.supports?.sections;
+  if (!Array.isArray(sections)) return {};
+  const result = {};
+  for (const [type, options] of Object.entries(declared)) {
+    if (!sections.includes(type) || !/^[A-Za-z][A-Za-z0-9]{0,63}$/.test(type)) continue;
+    if (!Array.isArray(options) || !options.length || options.length > 3
+      || options.some(option => !HEADING_ALIGNMENTS.includes(option))
+      || new Set(options).size !== options.length) continue;
+    Object.defineProperty(result, type, { value: [...options], enumerable: true });
+  }
+  return result;
+}
+
+export function withHeadingAlignment(content, type, manifest) {
+  const projected = { ...content };
+  const capabilities = headingAlignmentCapabilities(manifest);
+  const options = Object.hasOwn(capabilities, type) ? capabilities[type] : undefined;
+  if (!options?.includes(projected.headingAlignment)) delete projected.headingAlignment;
+  return projected;
+}

package/src/vendor/validator/collection-link-visibility.mjs

@@ -0,0 +1,47 @@
+import { parsePresentationMarkup, presentationText, presentationVisible, presentationSignature } from './presentation-proof.mjs';
+
+export const COLLECTION_LINK_TYPES = ['events', 'articles', 'courses', 'campaigns', 'services', 'documents', 'appealGrid'];
+const ATTRIBUTE = 'data-p60-collection-link';
+
+/** render receives raw saved values and a destination override; the caller applies host projection. */
+export async function proveCollectionLinkVisibility(render, entry, declared) {
+  const errors = [];
+  const href = `/p60-collection-link-${entry.type}`;
+  const content = { ...structuredClone(entry.sample ?? {}) };
+  // Authored appeal cards intentionally replace the connected causes collection.
+  if (entry.type === 'appealGrid') content.items = [];
+  delete content.showCollectionLink;
+  let baseline;
+  for (const requested of [undefined, true, false, 'false', null, 0]) {
+    const label = requested === undefined ? 'default' : JSON.stringify(requested);
+    try {
+      const html = await render({ ...content, ...(requested === undefined ? {} : { showCollectionLink: requested }) }, href);
+      const { nodes, root } = parsePresentationMarkup(html);
+      const hooks = nodes.filter(node => Object.hasOwn(node.attrs, ATTRIBUTE));
+      const expectedHidden = declared && requested === false;
+      if (declared && !hooks.length) errors.push(`${label}: must retain a permanent data-p60-collection-link anchor`);
+      for (const hook of hooks) {
+        if (hook.tag !== 'a' || hook.attrs.href !== href || !presentationText(hook)) {
+          errors.push(`${label}: collection link hook must mark a nonempty onward anchor using the supplied collection href, not a section, card or record link`);
+          continue;
+        }
+        if (('hidden' in hook.attrs) !== expectedHidden) errors.push(`${label}: only boolean false may add hidden to the onward anchor`);
+        const attrs = hook.attrs;
+        hook.attrs = { ...attrs };
+        delete hook.attrs.hidden;
+        if (!presentationVisible(hook)) errors.push(`${label}: the onward anchor must otherwise be visible, not hidden by its ancestor or another attribute`);
+        hook.attrs = attrs;
+      }
+      const signature = presentationSignature(root, node => Object.hasOwn(node.attrs, ATTRIBUTE) ? ['hidden'] : []);
+      if (baseline === undefined) baseline = signature;
+      else if (signature !== baseline) errors.push(`${label}: visibility may change only the onward anchor hidden attribute, never copy, URLs, headings, records or other markup`);
+    } catch (error) { errors.push(`${label}: failed rendering visibility fixture, ${error.message}`); }
+  }
+  if (declared) {
+    try {
+      const { nodes } = parsePresentationMarkup(await render(content, null));
+      if (nodes.some(node => Object.hasOwn(node.attrs, ATTRIBUTE))) errors.push('missing destination: omit the onward anchor rather than inventing a URL');
+    } catch (error) { errors.push(`missing destination: failed rendering fixture, ${error.message}`); }
+  }
+  return [...new Set(errors)].map(message => `section '${entry.type}' showCollectionLink: ${message}`);
+}