@port60/template-kit 0.8.0 → 0.10.0

package/src/vendor/contract/v1/dialect.json

@@ -1,6 +1,6 @@
 {
   "format": "port60-liquid@1",
-  "description": "The Port60 template dialect — a strict, whitelisted subset of Liquid. Anything not listed here is rejected at parse time by the engine and at publish time by the conformance validator.",
+  "description": "The Port60 template dialect, a strict, whitelisted subset of Liquid. Anything not listed here is rejected at parse time by the engine and at publish time by the conformance validator.",
   "outputEscape": "escape",
   "rawFilter": "raw",
   "tags": [
@@ -16,7 +16,7 @@
     {
       "name": "island",
       "usage": "{% island 'donation_widget' %}",
-      "description": "Places a platform functional island (a live, hydrated component) at this position. Templates place islands, never implement them — the island's markup, behaviour and data are platform-owned and upgraded platform-side. The island name must be declared in the manifest's supports.islands."
+      "description": "Places a platform functional island (a live, hydrated component) at this position. Templates place islands, never implement them, the island's markup, behaviour and data are platform-owned and upgraded platform-side. The island name must be declared in the manifest's supports.islands."
     },
     {
       "name": "content",
@@ -34,6 +34,6 @@
   ],
   "excluded": {
     "tags": ["include", "render", "layout", "tablerow", "cycle", "increment", "decrement"],
-    "reason": "File inclusion (no file system exists inside an artifact yet — a snippets mechanism arrives with the Layout slot), table markup generation, and stateful counters are outside the v1 dialect."
+    "reason": "File inclusion (no file system exists inside an artifact yet, a snippets mechanism arrives with the Layout slot), table markup generation, and stateful counters are outside the v1 dialect."
   }
 }

package/src/vendor/contract/v1/fonts.json

@@ -1,5 +1,5 @@
 {
- "description": "The curated font catalogue behind `font` settings knobs. The tenant picks a FAMILY; the template's typographic system (weights, sizes, tracking) is author-owned — the host requests the template's declared weights for the chosen family, clamped to the family's real weights below (nearest wins). Curated, not the raw Google catalogue: every family here is open-licence (OFL/Apache), quality-checked, and tagged so non-technical admins choose by vibe. Served from Bunny Fonts (a privacy-first, EU-hosted drop-in mirror of the Google Fonts catalogue — same families, same css2 API). Additive-only within a contract major; never remove a family (published sites reference them).",
+ "description": "The curated font catalogue behind `font` settings knobs. The tenant picks a FAMILY; the template's typographic system (weights, sizes, tracking) is author-owned, the host requests the template's declared weights for the chosen family, clamped to the family's real weights below (nearest wins). Curated, not the raw Google catalogue: every family here is open-licence (OFL/Apache), quality-checked, and tagged so non-technical admins choose by vibe. Served from Bunny Fonts (a privacy-first, EU-hosted drop-in mirror of the Google Fonts catalogue, same families, same css2 API). Additive-only within a contract major; never remove a family (published sites reference them).",
  "provider": {
   "cssBase": "https://fonts.bunny.net/css2",
   "preconnect": "https://fonts.bunny.net"

package/src/vendor/contract/v1/imagery.json

@@ -1,23 +1,23 @@
 {
- "description": "Platform imagery envelopes — ADVICE, never enforcement. Entity images (events, courses, articles) render on SEVERAL surfaces at once (cards, carousel slides, detail banners), including platform-owned components, so their guidance is platform-level: the envelope every surface can live with. Template-composed slots (the home hero) are different — their ideal is the TEMPLATE's own design call, declared per-template in manifest.imagery and surfaced beside the upload. Editors measure the actual upload against the relevant guidance and advise; the charity always decides.",
+ "description": "Platform imagery envelopes, ADVICE, never enforcement. Entity images (events, courses, articles) render on SEVERAL surfaces at once (cards, carousel slides, detail banners), including platform-owned components, so their guidance is platform-level: the envelope every surface can live with. Template-composed slots (the home hero) are different, their ideal is the TEMPLATE's own design call, declared per-template in manifest.imagery and surfaced beside the upload. Editors measure the actual upload against the relevant guidance and advise; the charity always decides.",
  "entityImages": {
   "eventPromo": {
    "idealAspect": "3:2",
    "aspectRange": ["4:3", "16:9"],
    "minWidth": 1600,
-   "note": "One photo, several surfaces: the events card, the home carousel slide, and the event page banner — each crops differently, so keep the subject centred and avoid text baked into the image."
+   "note": "One photo, several surfaces: the events card, the home carousel slide, and the event page banner, each crops differently, so keep the subject centred and avoid text baked into the image."
   },
   "courseImage": {
    "idealAspect": "3:2",
    "aspectRange": ["4:3", "16:9"],
    "minWidth": 1600,
-   "note": "Renders as the course card and the course page opener — subject centred, no baked-in text."
+   "note": "Renders as the course card and the course page opener, subject centred, no baked-in text."
   },
   "articleCover": {
    "idealAspect": "16:9",
    "aspectRange": ["3:2", "2:1"],
    "minWidth": 1600,
-   "note": "The article card thumbnail and the article page cover — wide editorial shots sit best."
+   "note": "The article card thumbnail and the article page cover, wide editorial shots sit best."
   }
  }
 }

package/src/vendor/contract/v1/islands.json

@@ -1,112 +1,258 @@
 {
- "description": "The platform's functional islands — the app-block table. A template PLACES an island with {% island 'name' %}; the platform renders, hydrates, upgrades and patches it. The stylingApi lists the STABLE class names a template may target with CSS; anything not listed is internal and may change without notice.",
- "islands": [
-  {
-   "name": "donation_widget",
-   "label": "Donation widget",
-   "status": "available",
-   "description": "The full donation flow for the tenant's quick-give cause: suggested amounts, custom amount, donor details, Gift Aid opt-in, payment. All payment/compliance behaviour is platform-owned.",
-   "params": [],
-   "stylingApi": [
-    ".donate-card",
-    ".donate-head",
-    ".donate-sub",
-    ".freq-tabs",
-    ".freq-tab",
-    ".amount-grid",
-    ".amount-option",
-    ".amount-list",
-    ".amount-row",
-    ".giftaid-box",
-    ".donate-submit",
-    ".donate-note",
-    ".donate-success"
-   ]
-  },
-  {
-   "name": "member_menu",
-   "label": "Port60 ID sign-in / account menu",
-   "status": "available",
-   "description": "The branded Port60 ID entry point: the sign-in button (popup flow) for guests, the account pill (Members area / Sign out) for signed-in members. Renders NOTHING when the tenant doesn't allow member sign-ups. The identity brand and popup behaviour are platform-owned and identical across every template — place it in your header's nav; never rebuild it.",
-   "params": [],
-   "stylingApi": [
-    ".nav-p60-signin",
-    ".nav-account",
-    ".nav-account-toggle",
-    ".nav-account-menu",
-    ".p60-mark"
-   ]
-  },
-  {
-   "name": "events_carousel",
-   "label": "Events carousel",
-   "status": "available",
-   "description": "The rotating showcase of published ticketed events. Renders nothing when the tenant has no matching published content.",
-   "params": [],
-   "stylingApi": [
-    ".events-carousel",
-    ".carousel-slide",
-    ".carousel-caption",
-    ".carousel-dots",
-    ".carousel-dot"
-   ]
-  },
-  {
-   "name": "whats_on_strip",
-   "label": "What's-on strip",
-   "status": "available",
-   "description": "The slim banner of upcoming info events. Renders nothing when the tenant has no matching published content.",
-   "params": [],
-   "stylingApi": [
-    ".info-events-bar",
-    ".info-events-inner",
-    ".info-event-chip"
-   ]
-  },
-  {
-   "name": "latest_articles",
-   "label": "Latest articles",
-   "status": "available",
-   "description": "A strip of the most recent published articles. Renders nothing when the tenant has no matching published content.",
-   "params": [],
-   "stylingApi": [
-    ".article-grid",
-    ".article-card",
-    ".article-card-body",
-    ".article-strip-cta"
-   ]
-  },
-  {
-   "name": "course_enrol",
-   "label": "Course enrolment widget",
-   "status": "available",
-   "description": "The member-gated course enrolment journey (schedule options, household picker, payment, seat holds) for the course the page addresses. Only meaningful on the course page template (pages/course.liquid) — place it where your layout wants the purchase column (left rail, right rail, or below the content); position in your source is position on the page. Everything inside is platform-owned; it renders a standard sold-out note when no places remain (branch on course.soldOut if you want your own tag elsewhere).",
-   "params": [],
-   "stylingApi": [
-    ".course-enrol",
-    ".course-variant-list",
-    ".course-subject-list",
-    ".course-summary",
-    ".course-pay-panel",
-    ".course-soldout-note"
-   ]
-  },
-  {
-   "name": "hero_carousel",
-   "label": "Hero image carousel",
-   "status": "available",
-   "description": "Rotation for the home hero's photographs (homeHero.images, 2+): auto-advance every ~6s, pauses on hover/focus, honours prefers-reduced-motion (no auto-advance), swipe on touch, dot navigation. The platform owns the motion; the TEMPLATE owns the look — including the tonal treatment: every slide ships an empty .hero-slide-scrim layer over its image, and the template colours it from its OWN palette variables (a colour wash, a blend, a gradient) so any uploaded photo sits inside the template's tones. Renders nothing with fewer than 2 images — single-image and no-image states are the template's own renderer, not this island's.",
-   "params": [],
-   "stylingApi": [
-    ".hero-carousel",
-    ".hero-slides",
-    ".hero-slide",
-    ".hero-slide-img",
-    ".hero-slide-scrim",
-    ".hero-dots",
-    ".hero-dot",
-    ".hero-dot--active"
-   ]
-  }
- ]
+  "description": "The platform's functional islands, the app-block table. A template PLACES an island with {% island 'name' %}; the platform renders, hydrates, upgrades and patches it. The stylingApi lists the STABLE class names a template may target with CSS; anything not listed is internal and may change without notice.",
+  "islands": [
+    {
+      "name": "donation_widget",
+      "label": "Donation widget",
+      "status": "available",
+      "description": "The full donation flow for the tenant's quick-give cause: suggested amounts, custom amount, donor details, Gift Aid opt-in, payment. All payment/compliance behaviour is platform-owned.",
+      "params": [],
+      "stylingApi": [
+        ".donate-card",
+        ".donate-head",
+        ".donate-sub",
+        ".freq-tabs",
+        ".freq-tab",
+        ".amount-grid",
+        ".amount-option",
+        ".amount-list",
+        ".amount-row",
+        ".giftaid-box",
+        ".donate-submit",
+        ".donate-note",
+        ".donate-success"
+      ]
+    },
+    {
+      "name": "member_menu",
+      "label": "Port60 ID sign-in / account menu",
+      "status": "available",
+      "description": "The branded Port60 ID entry point: the sign-in button (popup flow) for guests, the account pill (Members area / Sign out) for signed-in members. Renders NOTHING when the tenant doesn't allow member sign-ups. The identity brand and popup behaviour are platform-owned and identical across every template, place it in your header's nav; never rebuild it.",
+      "params": [],
+      "stylingApi": [
+        ".nav-p60-signin",
+        ".nav-account",
+        ".nav-account-toggle",
+        ".nav-account-menu",
+        ".p60-mark"
+      ]
+    },
+    {
+      "name": "events_carousel",
+      "label": "Events carousel",
+      "status": "available",
+      "description": "The rotating showcase of published ticketed events. Renders nothing when the tenant has no matching published content.",
+      "params": [],
+      "stylingApi": [
+        ".events-carousel",
+        ".carousel-slide",
+        ".carousel-caption",
+        ".carousel-dots",
+        ".carousel-dot"
+      ]
+    },
+    {
+      "name": "whats_on_strip",
+      "label": "What's-on strip",
+      "status": "available",
+      "description": "The slim banner of upcoming info events. Renders nothing when the tenant has no matching published content.",
+      "params": [],
+      "stylingApi": [
+        ".info-events-bar",
+        ".info-events-inner",
+        ".info-event-chip"
+      ]
+    },
+    {
+      "name": "latest_articles",
+      "label": "Latest articles",
+      "status": "available",
+      "description": "A strip of the most recent published articles. Renders nothing when the tenant has no matching published content.",
+      "params": [],
+      "stylingApi": [
+        ".article-grid",
+        ".article-card",
+        ".article-card-body",
+        ".article-strip-cta"
+      ]
+    },
+    {
+      "name": "course_enrol",
+      "label": "Course enrolment widget",
+      "status": "available",
+      "description": "The member-gated course enrolment journey (schedule options, household picker, payment, seat holds) for the course the page addresses. Only meaningful on the course page template (pages/course.liquid), place it where your layout wants the purchase column (left rail, right rail, or below the content); position in your source is position on the page. Everything inside is platform-owned; it renders a standard sold-out note when no places remain (branch on course.soldOut if you want your own tag elsewhere).",
+      "params": [],
+      "stylingApi": [
+        ".course-enrol",
+        ".course-variant-list",
+        ".course-subject-list",
+        ".course-summary",
+        ".course-pay-panel",
+        ".course-soldout-note"
+      ]
+    },
+    {
+      "name": "next_prayer",
+      "label": "Next worship time",
+      "status": "available",
+      "description": "A live countdown to worship.next for the tenant's schedule. Renders nothing when no next time is available. The platform owns the clock; the template owns presentation through the stable classes.",
+      "params": [],
+      "stylingApi": [
+        ".next-prayer",
+        ".next-prayer-label",
+        ".next-prayer-name",
+        ".next-prayer-time",
+        ".next-prayer-countdown"
+      ]
+    },
+    {
+      "name": "article_engagement",
+      "label": "Article engagement",
+      "status": "available",
+      "description": "The platform-owned article views, likes and sharing bar for the article page being rendered.",
+      "params": [],
+      "stylingApi": [
+        ".article-engage",
+        ".article-views",
+        ".article-share-group",
+        ".article-share-btn",
+        ".article-share-word",
+        ".article-share-copied"
+      ]
+    },
+    {
+      "name": "article_comments",
+      "label": "Article comments",
+      "status": "available",
+      "description": "The identity-aware article conversation for the article page being rendered. Renders the closed state when comments are disabled.",
+      "params": [],
+      "stylingApi": [
+        ".article-comments",
+        ".article-comment-list",
+        ".article-comment",
+        ".article-comment-head",
+        ".article-comment-form",
+        ".article-comments-gate",
+        ".article-comments-note"
+      ]
+    },
+    {
+      "name": "hero_carousel",
+      "label": "Hero image carousel",
+      "status": "available",
+      "description": "Rotation for the home hero's photographs (homeHero.images, 2+): auto-advance every ~6s, pauses on hover/focus, honours prefers-reduced-motion (no auto-advance), swipe on touch, dot navigation. The platform owns the motion; the TEMPLATE owns the look, including the tonal treatment: every slide ships an empty .hero-slide-scrim layer over its image, and the template colours it from its OWN palette variables (a colour wash, a blend, a gradient) so any uploaded photo sits inside the template's tones. Renders nothing with fewer than 2 images, single-image and no-image states are the template's own renderer, not this island's.",
+      "params": [],
+      "stylingApi": [
+        ".hero-carousel",
+        ".hero-slides",
+        ".hero-slide",
+        ".hero-slide--active",
+        ".hero-slide-img",
+        ".hero-slide-scrim",
+        ".hero-dots",
+        ".hero-dot",
+        ".hero-dot--active"
+      ]
+    },
+    {
+      "name": "newsletter_signup",
+      "label": "Newsletter sign-up",
+      "status": "available",
+      "description": "Explicit email opt-in over the platform's versioned consent and one-click unsubscribe rail. Templates own placement and presentation; wording, evidence and abuse checks remain platform-owned.",
+      "params": [],
+      "stylingApi": [
+        ".newsletter-signup",
+        ".newsletter-label",
+        ".newsletter-fields",
+        ".newsletter-email",
+        ".newsletter-submit",
+        ".newsletter-consent",
+        ".newsletter-message"
+      ]
+    },
+    {
+      "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.",
+      "params": [],
+      "stylingApi": [
+        ".language-switch",
+        ".language-switch-label",
+        ".language-switch-select"
+      ]
+    },
+    {
+      "name": "search",
+      "label": "Site search",
+      "status": "available",
+      "description": "Searches published articles, programmes, events and public resources. It reads public projections only and cannot search member, payment, private media or admin data.",
+      "params": [],
+      "stylingApi": [
+        ".site-search",
+        ".site-search-form",
+        ".site-search-label",
+        ".site-search-fields",
+        ".site-search-input",
+        ".site-search-submit",
+        ".site-search-results",
+        ".site-search-result",
+        ".site-search-kind",
+        ".site-search-link",
+        ".site-search-summary",
+        ".site-search-empty"
+      ]
+    },
+    {
+      "name": "volunteer_signup",
+      "label": "Volunteer expression of interest",
+      "status": "available",
+      "description": "Lists published opportunities and captures a privacy-recorded expression of interest. Templates own placement and styling; validation, abuse checks and submission storage remain platform-owned.",
+      "params": [],
+      "stylingApi": [
+        ".volunteer-signup",
+        ".volunteer-field",
+        ".volunteer-privacy",
+        ".volunteer-submit",
+        ".volunteer-message"
+      ]
+    },
+    {
+      "name": "form",
+      "label": "Public form",
+      "status": "available",
+      "description": "Renders the tenant's first published platform form and records its submission with explicit privacy acceptance. Templates cannot handle or redirect submissions themselves.",
+      "params": [],
+      "stylingApi": [
+        ".public-form",
+        ".public-form-head",
+        ".public-form-field",
+        ".public-form-check",
+        ".public-form-privacy",
+        ".public-form-submit",
+        ".public-form-message"
+      ]
+    },
+    {
+      "name": "map",
+      "label": "Impact map",
+      "status": "available",
+      "description": "The tenant's published impact map: a themed, privacy-clean map (platform-served tiles, never a third-party tile CDN) whose points open cards derived from the content they link. The island derives its colours from the template's tokens; v1 renders the tenant's first published map.",
+      "params": [],
+      "stylingApi": [
+        ".impact-map",
+        ".impact-map-head",
+        ".impact-map-intro",
+        ".impact-map-canvas",
+        ".impact-map-pin",
+        ".impact-map-pin--active",
+        ".impact-map-card",
+        ".impact-map-card-kind",
+        ".impact-map-card-title",
+        ".impact-map-card-summary",
+        ".impact-map-card-cta",
+        ".impact-map-empty"
+      ]
+    }
+  ]
 }

package/src/vendor/contract/v1/layout.json

@@ -0,0 +1,25 @@
+{
+  "description": "How platform pages are placed inside a template. Every platform page (donate, services, events, campaigns, the members area) renders through a fixed set of LAYOUT INTENTS, the content SEAM. A template STYLES these intents to place content its way; it must never build a parallel content container, or platform pages drift from the template's own sections. Enforced at publish by the conformance validator.",
+  "widthToken": "--container",
+  "intents": [
+    {
+      "class": "container",
+      "kind": "contained",
+      "note": "The contained content column, text, forms, cards. Style it (and override --container) to set your content width and gutter. Use it in your own layout and sections too, so everything shares one column."
+    },
+    {
+      "class": "full",
+      "kind": "full-bleed",
+      "note": "Edge-to-edge regardless of the container it sits in, a hero image, a colour band. Restyle it freely; the default breaks out to the viewport width."
+    }
+  ],
+  "rules": [
+    {
+      "id": "no-parallel-container",
+      "kind": "css-width-off-token",
+      "token": "--container",
+      "allow": ["container", "full"],
+      "message": "builds its own content container from var(--container). Platform pages render inside .container, so a parallel container drifts from your sections, style .container instead (override --container for width and add your gutter there), and use .full for edge-to-edge."
+    }
+  ]
+}

package/src/vendor/contract/v1/manifest.schema.json

@@ -9,12 +9,12 @@
     "name": {
       "type": "string",
       "pattern": "^[a-z][a-z0-9-]{1,48}[a-z0-9]$",
-      "description": "The template's identity — lowercase, hyphenated, stable across versions."
+      "description": "The template's identity, lowercase, hyphenated, stable across versions."
     },
     "version": {
       "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Semver. Versions are IMMUTABLE once published — a fix is a new version."
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:-dev\\.\\d+)?$",
+      "description": "Semver. Stable versions are immutable once submitted. Owner-only development versions use x.y.z-dev.N, remain non-promotable, and may be replaced before creating a stable release."
     },
     "format": {
       "type": "string",
@@ -23,10 +23,47 @@
     },
     "label": { "type": "string", "maxLength": 60, "description": "Human-readable name shown in pickers." },
     "description": { "type": "string", "maxLength": 300 },
+    "requiresCapabilities": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "giving",
+          "appeals",
+          "worship",
+          "courses",
+          "membership",
+          "events",
+          "articles",
+          "services",
+          "volunteering",
+          "forms",
+          "resources",
+          "locations",
+          "newsletter",
+          "i18n",
+          "search",
+          "media"
+        ]
+      },
+      "uniqueItems": true,
+      "default": [],
+      "description": "Platform capabilities this design needs in order to work as intended. This is a catalogue matching signal, never an entitlement grant. The validator checks that each declared capability has a corresponding section, page template, island or context surface."
+    },
+    "suitsProfiles": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["general", "mosque", "church", "appeal-charity", "pta", "community", "training"]
+      },
+      "uniqueItems": true,
+      "default": [],
+      "description": "Organisation profiles this design was composed for. An empty list means the template is general purpose. Profiles improve catalogue recommendations but do not hide or unlock features."
+    },
     "changelog": {
       "type": "string",
       "maxLength": 300,
-      "description": "One human line describing what THIS version changed — shown on the Appearance update nudge."
+      "description": "One human line describing what THIS version changed, shown on the Appearance update nudge."
     },
     "supports": {
       "type": "object",
@@ -38,14 +75,14 @@
           "items": { "type": "string", "enum": ["home", "about"] },
           "minItems": 1,
           "uniqueItems": true,
-          "description": "The pages this template renders (grows with the contract)."
+          "description": "Section based page bodies this template renders from sections/{type}.liquid. Contract v1 supports home and about. This is independent of layout chrome and route-specific pageTemplates."
         },
         "sections": {
           "type": "array",
           "items": { "type": "string" },
           "minItems": 1,
           "uniqueItems": true,
-          "description": "Section types this template ships renderers for (sections/{type}.liquid). Unsupported types are omitted at render — never an error."
+          "description": "Section types this template ships renderers for (sections/{type}.liquid). Unsupported types are omitted at render, never an error."
         },
         "islands": {
           "type": "array",
@@ -57,14 +94,14 @@
         "layout": {
           "type": "boolean",
           "default": false,
-          "description": "True when the template ships layout.liquid and owns the page chrome (header/nav/footer). The platform still owns <head>, consent, and identity — see the layouts guide."
+          "description": "True when the template ships layout.liquid and owns the page chrome (header/nav/footer). The platform still owns <head>, consent, and identity, see the layouts guide."
         },
         "pageTemplates": {
           "type": "array",
-          "items": { "type": "string", "enum": ["events", "course"] },
+          "items": { "type": "string", "enum": ["events", "course", "articles", "article"] },
           "uniqueItems": true,
           "default": [],
-          "description": "Pages whose DISPLAY body this template renders itself (pages/{page}.liquid) with that page's documented data context. Transactional views stay platform-owned; without an entry the platform body renders inside your chrome."
+          "description": "Route-specific data views rendered from pages/{page}.liquid with documented context. Events and articles own listings; course and article own detail presentation. Event transactions, course enrolment, article engagement, comments, identity and consent stay platform-owned islands. Requires supports.layout; without an entry the platform body renders inside the template chrome."
         },
         "worship": {
           "type": "boolean",
@@ -74,14 +111,23 @@
         "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."
+          "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."
+        },
+        "behaviors": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["reveal", "counter", "progress", "countdown", "accordion", "carousel", "stickyHeader", "stickyCta", "lightbox", "tabs"]
+          },
+          "uniqueItems": true,
+          "description": "Engine-attached behaviours this template's markup opts into via data-p60-* attributes (see the behaviour catalogue). Templates never ship JavaScript; declaring here is what makes the engine wire the markup, and the validator proves declaration and usage agree in both directions."
         }
       }
     },
     "imagery": {
       "type": "object",
       "additionalProperties": false,
-      "description": "The template's OWN image advice, surfaced beside uploads in the charity's editor — a design statement (what shape suits THIS composition), advisory only, never enforced. Entity images (events, courses, articles) are platform-scoped instead: see the contract's imagery.json envelopes.",
+      "description": "The template's OWN image advice, surfaced beside uploads in the charity's editor, a design statement (what shape suits THIS composition), advisory only, never enforced. Entity images (events, courses, articles) are platform-scoped instead: see the contract's imagery.json envelopes.",
       "properties": {
         "hero": {
           "type": "object",
@@ -127,7 +173,7 @@
           "name": {
             "type": "string",
             "maxLength": 40,
-            "description": "The look's evocative, author-chosen name — shown as a one-click chip in Appearance."
+            "description": "The look's evocative, author-chosen name, shown as a one-click chip in Appearance."
           },
           "values": {
             "type": "object",
@@ -160,7 +206,7 @@
               "group": {
                 "type": "string",
                 "enum": ["typography", "looks"],
-                "description": "Where the admin surfaces this knob: 'typography' → the Typography section beside the font slots; 'looks' → the Looks section with the one-click bundles (colour schemes and accent dials belong there — and ungrouped color knobs plus a knob keyed 'scheme' default there anyway); other ungrouped knobs render under Template options."
+                "description": "Where the admin surfaces this knob: 'typography' → the Typography section beside the font slots; 'looks' → the Looks section with the one-click bundles (colour schemes and accent dials belong there, and ungrouped color knobs plus a knob keyed 'scheme' default there anyway); other ungrouped knobs render under Template options."
               },
               "weights": {
                 "type": "array",
@@ -170,7 +216,7 @@
               }
             }
           },
-          "description": "The template's own theming knobs (colour schemes etc.) — rendered as an editor in Appearance/get-started; values land in site-config config.theme."
+          "description": "The template's own theming knobs (colour schemes etc.), rendered as an editor in Appearance/get-started; values land in site-config config.theme."
         }
       }
     }