@port60/template-kit 0.8.0 → 0.10.0

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

@@ -1,5 +1,5 @@
 {
-  "description": "The content-section catalogue — the closed set of section types a page may hold and a template may render. Section type = content KIND (coarse); layout/variant is the template's job. Additive-only: types and fields are added, never removed or re-shaped, within a contract major. Every section is independently omittable — a template must degrade gracefully when any subset is absent.",
+  "description": "The content-section catalogue, the closed set of section types a page may hold and a template may render. Section type = content KIND (coarse); layout/variant is the template's job. Additive-only: types and fields are added, never removed or re-shaped, within a contract major. Every section is independently omittable, a template must degrade gracefully when any subset is absent.",
   "sections": [
     {
       "type": "hero",
@@ -25,7 +25,7 @@
           "name": "bodyHtml",
           "kind": "richtext",
           "required": false,
-          "description": "Sanitised HTML intro — render with the raw filter."
+          "description": "Sanitised HTML intro, render with the raw filter."
         }
       ],
       "minimal": {
@@ -33,8 +33,8 @@
       },
       "sample": {
         "eyebrow": "About us",
-        "title": "Generosity, put to work.",
-        "bodyHtml": "<p>We began in 2019 around a simple belief: small, regular acts of kindness, pooled together, change lives.</p>"
+        "title": "Neighbours, looked after.",
+        "bodyHtml": "<p>The Lantern Trust began in 2011 with a soup pot, a borrowed hall and a belief that nobody in Alderford should face a hard winter alone. Today we run a food bank, a youth club, an advice service and a community garden, powered by more than a hundred volunteers.</p>"
       }
     },
     {
@@ -97,16 +97,16 @@
         "heading": "Our values",
         "items": [
           {
-            "title": "Transparency",
-            "description": "Every pound is tracked and reported."
+            "title": "Openness",
+            "description": "Every pound is tracked, reported and published in our annual accounts."
           },
           {
             "title": "Dignity",
-            "description": "We work alongside communities, not for them."
+            "description": "No referrals, no means tests at the door. If you say you need help, that is enough."
           },
           {
-            "title": "Impact",
-            "description": "We fund what works and measure the difference."
+            "title": "Neighbourliness",
+            "description": "We work alongside people, not for them. Most of our volunteers first came to us for help."
           }
         ]
       }
@@ -142,7 +142,7 @@
           "name": "buttonHref",
           "kind": "url",
           "required": true,
-          "description": "The button's destination (scheme-guarded on save). The editor's cause picker writes /donate/{slug} here and records causeId beside it (editor bookkeeping — renderers use buttonHref only and may ignore causeId)."
+          "description": "The button's destination (scheme-guarded on save). The editor's cause picker writes /donate/{slug} here and records causeId beside it (editor bookkeeping, renderers use buttonHref only and may ignore causeId)."
         }
       ],
       "minimal": {
@@ -151,8 +151,8 @@
         "buttonHref": "/donate"
       },
       "sample": {
-        "heading": "Ready to help?",
-        "text": "It takes less than a minute.",
+        "heading": "Be somebody's good news today",
+        "text": "A monthly gift keeps the shelves stocked and the hall warm.",
         "buttonLabel": "Donate now",
         "buttonHref": "/#donate"
       }
@@ -215,13 +215,13 @@
             "form",
             "button"
           ],
-          "description": "How this hero offers giving: 'form' (default) places the donation widget beside the copy; 'button' renders copy only — the primary button becomes the giving path (defaulting to /donate). Templates MUST render both."
+          "description": "How this hero offers giving: 'form' (default) places the donation widget beside the copy; 'button' renders copy only, the primary button becomes the giving path (defaulting to /donate). Templates MUST render both."
         },
         {
           "name": "imageUrl",
           "kind": "image",
           "required": false,
-          "description": "Background photograph for the hero (uploaded through the platform pipeline). Superseded by `images` when that carries any entry — render imageUrl only when images is absent/empty. The template must TREAT the photo (scrim/tint from its own palette variables), never place it raw, and omit for its designed no-photo state."
+          "description": "Background photograph for the hero (uploaded through the platform pipeline). Superseded by `images` when that carries any entry, render imageUrl only when images is absent/empty. The template must TREAT the photo (scrim/tint from its own palette variables), never place it raw, and omit for its designed no-photo state."
         },
         {
           "name": "photoFraming",
@@ -231,13 +231,13 @@
             "fill",
             "whole"
           ],
-          "description": "How hero photographs meet the hero. 'fill' (default): the hero keeps its designed shape and photos crop to fill it (use each photo's focus to pick the surviving slice). 'whole': the hero adapts toward the photo's own shape (height-clamped) so the FULL scene stays visible — the vista treatment for wide landscape photographs; templates overlay or stack their copy accordingly."
+          "description": "How hero photographs meet the hero. 'fill' (default): the hero keeps its designed shape and photos crop to fill it (use each photo's focus to pick the surviving slice). 'whole': the hero adapts toward the photo's own shape (height-clamped) so the FULL scene stays visible, the vista treatment for wide landscape photographs; templates overlay or stack their copy accordingly."
         },
         {
           "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. Like every field: absent means the template's designed no-photo state, never a placeholder.",
           "itemFields": [
             {
               "name": "imageUrl",
@@ -262,23 +262,27 @@
                 "left",
                 "right"
               ],
-              "description": "Which part of the photograph survives the fill-crop (templates render photos cover-style, so an aspect mismatch crops — this picks the slice that stays). Maps to background-position/object-position; absent means centre."
+              "description": "Which part of the photograph survives the fill-crop (templates render photos cover-style, so an aspect mismatch crops, this picks the slice that stays). Maps to background-position/object-position; absent means centre."
             }
           ]
         }
       ],
       "minimal": {},
       "sample": {
-        "lead": "We turn everyday generosity into practical help for the families who need it most.",
+        "lead": "We turn everyday generosity into food parcels, warm rooms and open doors across Alderford.",
         "givingStyle": "button",
         "images": [
           {
-            "imageUrl": "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 160 90'%3E%3Cdefs%3E%3ClinearGradient id='g' x1='0' y1='0' x2='1' y2='1'%3E%3Cstop offset='0' stop-color='%23355e4b'/%3E%3Cstop offset='1' stop-color='%23103528'/%3E%3C/linearGradient%3E%3C/defs%3E%3Crect width='160' height='90' fill='url(%23g)'/%3E%3Ccircle cx='118' cy='28' r='14' fill='%23baa769' opacity='.7'/%3E%3Ctext x='10' y='78' font-family='sans-serif' font-size='9' fill='%23ffffff' opacity='.75'%3EHero photo one%3C/text%3E%3C/svg%3E",
-            "alt": "Volunteers serving meals at dusk"
+            "imageUrl": "p60fixture:hero/dusk",
+            "alt": "Volunteers serving supper as the light fades"
           },
           {
-            "imageUrl": "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 160 90'%3E%3Cdefs%3E%3ClinearGradient id='g' x1='0' y1='0' x2='1' y2='1'%3E%3Cstop offset='0' stop-color='%23445a78'/%3E%3Cstop offset='1' stop-color='%23141d2c'/%3E%3C/linearGradient%3E%3C/defs%3E%3Crect width='160' height='90' fill='url(%23g)'/%3E%3Ccircle cx='40' cy='30' r='12' fill='%23e8e2d4' opacity='.5'/%3E%3Ctext x='10' y='78' font-family='sans-serif' font-size='9' fill='%23ffffff' opacity='.75'%3EHero photo two%3C/text%3E%3C/svg%3E",
-            "alt": "The community hall on open day"
+            "imageUrl": "p60fixture:hero/river",
+            "alt": "The lantern walk along the River Aldern"
+          },
+          {
+            "imageUrl": "p60fixture:hero/garden",
+            "alt": "Raised beds in the Foundry Lane community garden"
           }
         ]
       }
@@ -289,7 +293,7 @@
       "pages": [
         "home"
       ],
-      "description": "What gifts make possible — optional intro plus icon/title/description cards. Claims must be truthful for the tenant.",
+      "description": "What gifts make possible, optional intro plus icon/title/description cards. Claims must be truthful for the tenant.",
       "fields": [
         {
           "name": "eyebrow",
@@ -325,7 +329,7 @@
               "name": "icon",
               "kind": "icon",
               "required": false,
-              "description": "Legacy emoji/icon — superseded by imageUrl; render it only when imageUrl is absent."
+              "description": "Legacy emoji/icon, superseded by imageUrl; render it only when imageUrl is absent."
             },
             {
               "name": "title",
@@ -355,18 +359,18 @@
         "heading": "Real help, made of small acts",
         "items": [
           {
-            "imageUrl": "https://assets.example/impact-water.jpg",
-            "title": "£10 · Clean water",
-            "description": "Safe drinking water for a family for a whole month."
+            "imageUrl": "p60fixture:impact/parcel",
+            "title": "£10 · A family food parcel",
+            "description": "Three days of meals, toiletries and a bag of fresh produce from the garden."
           },
           {
-            "icon": "🍲",
-            "title": "£25 · Warm meals",
-            "description": "Fifteen hot meals served at a local community kitchen."
+            "icon": "🔥",
+            "title": "£25 · A warm week",
+            "description": "Heating top-ups for a household choosing between eating and heating."
           },
           {
-            "title": "£50 · School kit",
-            "description": "Books and supplies for two children for a full term."
+            "title": "£50 · A month of youth club",
+            "description": "Coaching, kit and hot food for a young person, four evenings a week."
           }
         ]
       }
@@ -379,7 +383,7 @@
       ],
       "kind": "widget",
       "island": "whats_on_strip",
-      "description": "Upcoming info events (special days — no sign-up). Render the `infoEvents` context your way, or place {% island 'whats_on_strip' %} for the ready-made strip.",
+      "description": "Upcoming info events (special days, no sign-up). Render the `infoEvents` context your way, or place {% island 'whats_on_strip' %} for the ready-made strip.",
       "fields": [],
       "minimal": {},
       "sample": {},
@@ -395,7 +399,7 @@
       ],
       "kind": "widget",
       "island": "events_carousel",
-      "description": "Upcoming ticketed events on the home page. Your template renders the `events` context (the curated listing model) however its voice demands — or places {% island 'events_carousel' %} for the ready-made rotating showcase. Listing data only: ticket sales happen on the platform-rendered detail view (detailHref).",
+      "description": "Upcoming ticketed events on the home page. Your template renders the `events` context (the curated listing model) however its voice demands, or places {% island 'events_carousel' %} for the ready-made rotating showcase. Listing data only: ticket sales happen on the platform-rendered detail view (detailHref).",
       "fields": [],
       "minimal": {},
       "sample": {},
@@ -419,13 +423,54 @@
         "latestArticles"
       ]
     },
+    {
+      "type": "campaigns",
+      "label": "Campaigns",
+      "pages": [
+        "home"
+      ],
+      "description": "The tenant's LIVE campaigns (appeals, petitions, surveys) as cards linking to each campaign's page. Render the `campaigns` context your way; render nothing when no campaign is live.",
+      "context": [
+        "campaigns",
+        "campaignsLabel"
+      ],
+      "fields": [
+        {
+          "name": "eyebrow",
+          "kind": "text",
+          "required": false,
+          "description": "Short kicker."
+        },
+        {
+          "name": "heading",
+          "kind": "text",
+          "required": false,
+          "description": "The section heading; fall back to the campaignsLabel context when unset."
+        },
+        {
+          "name": "text",
+          "kind": "text",
+          "required": false,
+          "description": "Optional introduction."
+        }
+      ],
+      "minimal": {},
+      "sample": {
+        "eyebrow": "Get involved",
+        "heading": "What we are campaigning for",
+        "text": "The changes Alderford is asking for right now, and how to add your voice."
+      }
+    },
     {
       "type": "emergency",
       "label": "Emergency appeal strip",
       "pages": [
         "home"
       ],
-      "description": "A high-urgency full-width strip — one headline, an optional line, one action. For live emergencies and time-critical appeals.",
+      "description": "A high-urgency full-width strip, one headline, an optional line, one action. For live emergencies and time-critical appeals.",
+      "context": [
+        "causes"
+      ],
       "fields": [
         {
           "name": "heading",
@@ -456,9 +501,9 @@
         "heading": "Emergency appeal"
       },
       "sample": {
-        "heading": "Gaza emergency appeal",
-        "text": "Families need food, water and shelter right now.",
-        "buttonLabel": "Give emergency aid",
+        "heading": "Flood response appeal",
+        "text": "The Aldern broke its banks on Sunday. Thirty households need dry bedding and warmth now.",
+        "buttonLabel": "Give to the flood response",
         "buttonHref": "/donate"
       }
     },
@@ -468,7 +513,7 @@
       "pages": [
         "home"
       ],
-      "description": "Big headline numbers — the at-a-glance impact band. Values are author-entered text (write them exactly as they should read).",
+      "description": "Big headline numbers, the at-a-glance impact band. Values are author-entered text (write them exactly as they should read).",
       "fields": [
         {
           "name": "eyebrow",
@@ -516,16 +561,16 @@
         "heading": "What your giving did",
         "items": [
           {
-            "value": "12,400",
-            "label": "hot meals served"
+            "value": "9,200",
+            "label": "food parcels packed"
           },
           {
-            "value": "3,100",
-            "label": "families supported"
+            "value": "1,400",
+            "label": "warm space visits"
           },
           {
-            "value": "98p",
-            "label": "of every pound to the cause"
+            "value": "96p",
+            "label": "of every pound spent in Alderford"
           }
         ]
       }
@@ -536,7 +581,10 @@
       "pages": [
         "home"
       ],
-      "description": "A grid of appeal/campaign cards — image, title, a line, and a per-card action.",
+      "description": "A grid of appeal/campaign cards, image, title, a line, and a per-card action.",
+      "context": [
+        "causes"
+      ],
       "fields": [
         {
           "name": "eyebrow",
@@ -602,27 +650,212 @@
         "heading": "Where help is needed most",
         "items": [
           {
-            "title": "Winter appeal",
-            "text": "Warm meals and heating grants through the coldest months.",
+            "title": "Winter Appeal",
+            "text": "Heating top-ups, warm bedding and a hot meal through the coldest months.",
             "buttonLabel": "Support winter",
             "buttonHref": "/donate"
           },
           {
-            "title": "Clean water",
-            "text": "Wells and filtration for three villages.",
-            "buttonLabel": "Give water",
+            "title": "Food Bank Fund",
+            "text": "Ten pounds fills a family parcel and keeps the depot shelves stocked.",
+            "buttonLabel": "Fill a parcel",
             "buttonHref": "/donate"
           }
         ]
       }
     },
+    {
+      "type": "programmes",
+      "label": "Services and programmes",
+      "pages": [
+        "home"
+      ],
+      "description": "The tenant's published services and programmes as a dynamic card collection. Render the services context and omit the section when it is empty.",
+      "context": [
+        "services"
+      ],
+      "fields": [
+        {
+          "name": "eyebrow",
+          "kind": "text",
+          "required": false,
+          "description": "Short kicker."
+        },
+        {
+          "name": "heading",
+          "kind": "text",
+          "required": false,
+          "description": "The section heading."
+        },
+        {
+          "name": "text",
+          "kind": "text",
+          "required": false,
+          "description": "Optional introduction."
+        }
+      ],
+      "minimal": {},
+      "sample": {
+        "eyebrow": "What we do",
+        "heading": "Support that meets you where you are",
+        "text": "Food, advice, activity and company: five programmes, one front door."
+      }
+    },
+    {
+      "type": "resources",
+      "label": "Resource library",
+      "pages": [
+        "home"
+      ],
+      "description": "Public documents from the tenant's media library. The resources context contains PUBLIC documents only; private files and storage metadata never reach Liquid.",
+      "context": [
+        "resources"
+      ],
+      "fields": [
+        {
+          "name": "eyebrow",
+          "kind": "text",
+          "required": false,
+          "description": "Short kicker."
+        },
+        {
+          "name": "heading",
+          "kind": "text",
+          "required": false,
+          "description": "The section heading."
+        },
+        {
+          "name": "text",
+          "kind": "text",
+          "required": false,
+          "description": "Optional introduction."
+        }
+      ],
+      "minimal": {},
+      "sample": {
+        "eyebrow": "Resources",
+        "heading": "Reports and documents",
+        "text": "Our accounts, policies and handbooks, all in one place."
+      }
+    },
+    {
+      "type": "locations",
+      "label": "Locations",
+      "pages": [
+        "home"
+      ],
+      "description": "The tenant's public venue directory with safe directions links. Provider references and private venue notes are never exposed.",
+      "context": [
+        "locations"
+      ],
+      "fields": [
+        {
+          "name": "eyebrow",
+          "kind": "text",
+          "required": false,
+          "description": "Short kicker."
+        },
+        {
+          "name": "heading",
+          "kind": "text",
+          "required": false,
+          "description": "The section heading."
+        },
+        {
+          "name": "text",
+          "kind": "text",
+          "required": false,
+          "description": "Optional introduction."
+        }
+      ],
+      "minimal": {},
+      "sample": {
+        "eyebrow": "Find us",
+        "heading": "Where to find us",
+        "text": "Two front doors in the middle of Alderford, both step-free."
+      }
+    },
+    {
+      "type": "volunteering",
+      "label": "Volunteering opportunities",
+      "pages": [
+        "home"
+      ],
+      "description": "Published opportunities from the volunteering module. Templates render the cards and place volunteer_signup for the platform-owned, privacy-recorded expression-of-interest flow.",
+      "context": [
+        "opportunities"
+      ],
+      "fields": [
+        {
+          "name": "eyebrow",
+          "kind": "text",
+          "required": false,
+          "description": "Short kicker."
+        },
+        {
+          "name": "heading",
+          "kind": "text",
+          "required": false,
+          "description": "The section heading."
+        },
+        {
+          "name": "text",
+          "kind": "text",
+          "required": false,
+          "description": "Optional introduction."
+        }
+      ],
+      "minimal": {},
+      "sample": {
+        "eyebrow": "Get involved",
+        "heading": "Volunteer with us",
+        "text": "Two hours or twenty, there is a role that fits the time you have."
+      }
+    },
+    {
+      "type": "media",
+      "label": "Audio, video and livestreams",
+      "pages": [
+        "home"
+      ],
+      "description": "Structured public audio, video and livestream entries with titles, speakers, dates and safe media links.",
+      "context": [
+        "media"
+      ],
+      "fields": [
+        {
+          "name": "eyebrow",
+          "kind": "text",
+          "required": false,
+          "description": "Short kicker."
+        },
+        {
+          "name": "heading",
+          "kind": "text",
+          "required": false,
+          "description": "The section heading."
+        },
+        {
+          "name": "text",
+          "kind": "text",
+          "required": false,
+          "description": "Optional introduction."
+        }
+      ],
+      "minimal": {},
+      "sample": {
+        "eyebrow": "Media",
+        "heading": "Watch and listen",
+        "text": "Films, talks and the occasional kitchen soundscape from around the Trust."
+      }
+    },
     {
       "type": "people",
       "label": "People / team",
       "pages": [
         "about"
       ],
-      "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.",
+      "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": "eyebrow",
@@ -664,7 +897,7 @@
               "name": "imageUrl",
               "kind": "image",
               "required": false,
-              "description": "A photograph (platform pipeline). Absent renders cleanly — never a placeholder face."
+              "description": "A photograph (platform pipeline). Absent renders cleanly, never a placeholder face."
             },
             {
               "name": "statement",
@@ -686,25 +919,61 @@
       "sample": {
         "eyebrow": "Who we are",
         "heading": "The people behind the work",
-        "text": "A small team and a lot of volunteers, accountable to you.",
+        "text": "A small staff team, a board of local trustees, and more than a hundred volunteers, accountable to you.",
         "items": [
           {
-            "name": "Amina Khan",
+            "name": "Priya Sharma",
             "role": "Chair of Trustees",
-            "imageUrl": "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 96 96'%3E%3Crect width='96' height='96' fill='%23355e4b'/%3E%3Ccircle cx='48' cy='38' r='16' fill='%23e8e2d4'/%3E%3Cpath d='M16 88c4-20 18-28 32-28s28 8 32 28z' fill='%23e8e2d4'/%3E%3C/svg%3E",
-            "statement": "Every pound is a trust — we treat it that way."
+            "imageUrl": "p60fixture:people/priya/portrait",
+            "statement": "Every pound is a trust. We spend it like a neighbour is watching, because one is."
           },
           {
-            "name": "Daniel Osei",
-            "role": "Treasurer"
+            "name": "Derek Osei",
+            "role": "Food Bank Lead",
+            "imageUrl": "p60fixture:people/derek/portrait"
           },
           {
             "name": "Sara Malik",
             "role": "Volunteer Coordinator",
-            "statement": "Fifty pairs of hands, one purpose."
+            "statement": "A hundred pairs of hands, one purpose."
           }
         ]
       }
+    },
+    {
+      "type": "impactMap",
+      "label": "Impact map",
+      "pages": [
+        "home"
+      ],
+      "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": "eyebrow",
+          "kind": "text",
+          "required": false,
+          "description": "Short kicker."
+        },
+        {
+          "name": "heading",
+          "kind": "text",
+          "required": false,
+          "description": "The section heading."
+        },
+        {
+          "name": "text",
+          "kind": "text",
+          "required": false,
+          "description": "Optional introduction."
+        }
+      ],
+      "minimal": {},
+      "sample": {
+        "eyebrow": "Where we work",
+        "heading": "Our impact, on the map",
+        "text": "Every marker is a real place: a programme, an appeal, a story. Click one to see what happens there."
+      }
     }
   ]
-}
+}

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

@@ -1,5 +1,5 @@
 {
-  "description": "The CSS custom-property contract — the theming tokens the platform base declares and every island/page consumes. A template overrides them via :root:root in its theme.css. Additive-only: tokens are never removed or repurposed within a contract major.",
+  "description": "The CSS custom-property contract, the theming tokens the platform base declares and every island/page consumes. A template overrides them via :root:root in its theme.css. Additive-only: tokens are never removed or repurposed within a contract major.",
   "tokens": [
     { "name": "--bg", "description": "Page background." },
     { "name": "--bg-tint", "description": "Subtle tinted background (footer, wells)." },

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

@@ -1,5 +1,5 @@
 {
-  "_comment": "FROZEN compatibility baseline for port60-liquid@1 (8.6). tests/contract-freeze.test.mjs enforces that everything here still exists — removals/narrowings fail. Regenerate ONLY deliberately via scripts/contract-lock.mjs; the diff is the review.",
+  "_comment": "FROZEN compatibility baseline for port60-liquid@1 (8.6). tests/contract-freeze.test.mjs enforces that everything here still exists, removals/narrowings fail. Regenerate ONLY deliberately via scripts/contract-lock.mjs; the diff is the review.",
   "format": "port60-liquid@1",
   "dialect": {
     "tags": [