@port60/template-kit 0.10.0 → 0.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@port60/template-kit",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Build Port60 site templates locally: scaffold, live-preview, validate against the platform contract, and package for studio upload. AI-agent ready — every scaffold ships AGENTS.md and validate emits machine-readable JSON.",
   "type": "module",
   "bin": {

package/src/lib/agentsMd.mjs

@@ -80,8 +80,8 @@ platform accepts it; if it fails here, the upload will fail identically.
 
 Everything you read comes from ONE tree: \`site\`, \`site.brand\`, \`site.nav\`,
 \`site.socials\`, \`site.locale\` and the typed collections under \`site.content.*\`
-(services, events, articles, campaigns, causes, courses, volunteering, media, resources,
-locations, schedules, about). Four rules it never breaks, so neither should you:
+(services, events, articles, campaigns, causes, courses, resources, locations,
+schedules, about). Four rules it never breaks, so neither should you:
 
 - Every collection is BOUNDED (a documented cap plus a \`moreHref\`), link onward, never
   assume you have everything.
@@ -121,11 +121,11 @@ excludes it, and conformance proofs always run on the canonical fixtures.
 - Navigation can contain two levels below a top item. Render every supplied child and branch on
   optional \`group\`, \`description\`, \`imageUrl\` and \`megaMenu\` promo metadata. Never hardcode
   menu groups that are not in \`nav\`.
-- Dynamic sections include appeals (\`causes\`), programmes (\`services\`), resources, locations,
-  volunteering opportunities and structured media. Derive or omit when a collection is empty and
-  use the supplied URLs rather than constructing routes.
-- Submission and behaviour surfaces such as \`newsletter_signup\`, \`volunteer_signup\`, \`form\`,
-  \`search\`, \`language_switch\` and \`next_prayer\` are platform islands. Place and style them;
+- Dynamic sections include appeals (\`causes\`), programmes (\`services\`), resources and
+  locations. Derive or omit when a collection is empty and use the supplied URLs rather than
+  constructing routes.
+- Submission and behaviour surfaces such as \`newsletter_signup\`, \`form\`, \`search\`,
+  \`language_switch\` and \`next_prayer\` are platform islands. Place and style them;
   never reproduce their API calls or consent behaviour.
 - \`manifest.imagery.hero\` (optional but recommended): declare the photo shape YOUR hero
   composes best with (\`idealAspect\`, \`minWidth\`, a one-line \`note\`), the charity's editor

package/src/vendor/contract/v1/content-model.json

@@ -111,34 +111,6 @@
         "href": { "type": "string", "since": "1.0" }
       }
     },
-    "volunteering": {
-      "since": "1.0",
-      "cap": 12,
-      "moreHref": "/volunteering",
-      "description": "Open volunteering opportunities.",
-      "item": {
-        "id": { "type": "string", "since": "1.0" },
-        "slug": { "type": "string", "since": "1.0" },
-        "title": { "type": "string", "since": "1.0", "max": 200 },
-        "summary": { "type": "string", "since": "1.0", "nullable": true, "max": 500 },
-        "imageUrl": { "type": "string", "since": "1.0", "nullable": true },
-        "content": { "type": "object", "since": "1.0", "nullable": true }
-      }
-    },
-    "media": {
-      "since": "1.0",
-      "cap": 12,
-      "moreHref": "/media",
-      "description": "Published media items. `content.mediaType` is an OPEN enum (VIDEO and AUDIO today).",
-      "item": {
-        "id": { "type": "string", "since": "1.0" },
-        "slug": { "type": "string", "since": "1.0" },
-        "title": { "type": "string", "since": "1.0", "max": 200 },
-        "summary": { "type": "string", "since": "1.0", "nullable": true, "max": 500 },
-        "imageUrl": { "type": "string", "since": "1.0", "nullable": true },
-        "content": { "type": "object", "since": "1.0", "nullable": true }
-      }
-    },
     "resources": {
       "since": "1.0",
       "cap": 24,

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

@@ -47,7 +47,7 @@
         "section",
         "layout"
       ],
-      "description": "The typed collections: services, events, articles, campaigns, causes, courses, volunteering, media, resources, locations, schedules, about. EVERY collection is bounded (cap + moreHref in the model registry), every enum is open, every optional field explicitly nullable, and the model only ever grows. The validator computes your template's content footprint from the paths you read and stamps the required minimum model version at publish; dynamic indexing into site.content is refused so the footprint stays decidable."
+      "description": "The typed collections: services, events, articles, campaigns, causes, courses, resources, locations, schedules, about. EVERY collection is bounded (cap + moreHref in the model registry), every enum is open, every optional field explicitly nullable, and the model only ever grows. The validator computes your template's content footprint from the paths you read and stamps the required minimum model version at publish; dynamic indexing into site.content is refused so the footprint stays decidable."
     },
     {
       "path": "section",
@@ -430,22 +430,6 @@
       "description": "A public location with id, name, address, latitude, longitude, primary and directionsHref. Provider references and private notes are excluded.",
       "deprecated": true
     },
-    {
-      "path": "opportunities",
-      "availableIn": [
-        "section:volunteering"
-      ],
-      "description": "Published volunteering opportunities in display order. Each item contains id, slug, title, summary, imageUrl and content with location, schedule, commitment, dates, expected hours and shift dates. Sign-up remains the volunteer_signup island.",
-      "deprecated": true
-    },
-    {
-      "path": "media",
-      "availableIn": [
-        "section:media"
-      ],
-      "description": "Published structured media entries. Each item contains id, slug, title, summary, imageUrl and content with mediaType, mediaUrl, speaker, publishedAt and duration.",
-      "deprecated": true
-    },
     {
       "path": "infoEvents",
       "availableIn": [
@@ -1738,92 +1722,6 @@
           }
         ]
       },
-      "volunteering": {
-        "opportunities": [
-          {
-            "id": "aaaaaaaa-1111-4111-8111-111111111111",
-            "slug": "garden-volunteer",
-            "title": "Garden Volunteer",
-            "summary": "Keep the Foundry Lane beds thriving: sowing, watering, and showing first-timers where the trowels live.",
-            "imageUrl": "p60fixture:volunteer/garden",
-            "content": {
-              "location": "Foundry Lane Garden",
-              "schedule": "Saturday mornings",
-              "commitment": "Twice a month",
-              "hoursExpected": "3 hours"
-            }
-          },
-          {
-            "id": "aaaaaaaa-1111-4111-8111-111111111112",
-            "slug": "kitchen-crew",
-            "title": "Wednesday Kitchen Crew",
-            "summary": "Help cook and serve the weekly community meal. Full food hygiene training provided.",
-            "imageUrl": "p60fixture:volunteer/kitchen",
-            "content": {
-              "location": "St Chad's Hall",
-              "schedule": "Wednesdays 9am to 2pm",
-              "commitment": "Weekly",
-              "hoursExpected": "5 hours"
-            }
-          },
-          {
-            "id": "aaaaaaaa-1111-4111-8111-111111111113",
-            "slug": "food-bank-driver",
-            "title": "Food Bank Driver",
-            "summary": "Collect supermarket surplus on the morning round. A full licence and a friendly wave required.",
-            "imageUrl": null,
-            "content": {
-              "location": "Foundry Lane depot",
-              "schedule": "Weekday mornings",
-              "commitment": "One morning a week",
-              "hoursExpected": "2 hours"
-            }
-          }
-        ]
-      },
-      "media": {
-        "media": [
-          {
-            "id": "bbbbbbbb-2222-4222-8222-222222222221",
-            "slug": "garden-opening-film",
-            "title": "The Garden Opening, on Film",
-            "summary": "Four minutes from the gates opening, shot by the youth club media group.",
-            "imageUrl": "p60fixture:media/gardenfilm",
-            "content": {
-              "mediaType": "VIDEO",
-              "mediaUrl": "/fixture/garden-opening",
-              "speaker": null,
-              "duration": "4 minutes"
-            }
-          },
-          {
-            "id": "bbbbbbbb-2222-4222-8222-222222222222",
-            "slug": "trustee-talk-2030",
-            "title": "Where the Trust Goes Next",
-            "summary": "Chair of trustees Priya Sharma on the three-year plan, recorded at the spring members' evening.",
-            "imageUrl": "p60fixture:media/talk",
-            "content": {
-              "mediaType": "VIDEO",
-              "mediaUrl": "/fixture/trustee-talk",
-              "speaker": "Priya Sharma",
-              "duration": "18 minutes"
-            }
-          },
-          {
-            "id": "bbbbbbbb-2222-4222-8222-222222222223",
-            "slug": "sound-of-the-kitchen",
-            "title": "Sound of the Kitchen",
-            "summary": "An audio portrait of Wednesday lunchtime, best enjoyed hungry.",
-            "imageUrl": null,
-            "content": {
-              "mediaType": "AUDIO",
-              "mediaUrl": "/fixture/kitchen-audio",
-              "speaker": null,
-              "duration": "9 minutes"
-            }
-          }
-        ]
-      },
       "impactMap": {
         "impactMap": {
           "slug": "our-work",
@@ -2357,88 +2255,6 @@
             "href": "/courses"
           }
         ],
-        "volunteering": [
-          {
-            "id": "aaaaaaaa-1111-4111-8111-111111111111",
-            "slug": "garden-volunteer",
-            "title": "Garden Volunteer",
-            "summary": "Keep the Foundry Lane beds thriving: sowing, watering, and showing first-timers where the trowels live.",
-            "imageUrl": "p60fixture:volunteer/garden",
-            "content": {
-              "location": "Foundry Lane Garden",
-              "schedule": "Saturday mornings",
-              "commitment": "Twice a month",
-              "hoursExpected": "3 hours"
-            }
-          },
-          {
-            "id": "aaaaaaaa-1111-4111-8111-111111111112",
-            "slug": "kitchen-crew",
-            "title": "Wednesday Kitchen Crew",
-            "summary": "Help cook and serve the weekly community meal. Full food hygiene training provided.",
-            "imageUrl": "p60fixture:volunteer/kitchen",
-            "content": {
-              "location": "St Chad's Hall",
-              "schedule": "Wednesdays 9am to 2pm",
-              "commitment": "Weekly",
-              "hoursExpected": "5 hours"
-            }
-          },
-          {
-            "id": "aaaaaaaa-1111-4111-8111-111111111113",
-            "slug": "food-bank-driver",
-            "title": "Food Bank Driver",
-            "summary": "Collect supermarket surplus on the morning round. A full licence and a friendly wave required.",
-            "imageUrl": null,
-            "content": {
-              "location": "Foundry Lane depot",
-              "schedule": "Weekday mornings",
-              "commitment": "One morning a week",
-              "hoursExpected": "2 hours"
-            }
-          }
-        ],
-        "media": [
-          {
-            "id": "bbbbbbbb-2222-4222-8222-222222222221",
-            "slug": "garden-opening-film",
-            "title": "The Garden Opening, on Film",
-            "summary": "Four minutes from the gates opening, shot by the youth club media group.",
-            "imageUrl": "p60fixture:media/gardenfilm",
-            "content": {
-              "mediaType": "VIDEO",
-              "mediaUrl": "/fixture/garden-opening",
-              "speaker": null,
-              "duration": "4 minutes"
-            }
-          },
-          {
-            "id": "bbbbbbbb-2222-4222-8222-222222222222",
-            "slug": "trustee-talk-2030",
-            "title": "Where the Trust Goes Next",
-            "summary": "Chair of trustees Priya Sharma on the three-year plan, recorded at the spring members' evening.",
-            "imageUrl": "p60fixture:media/talk",
-            "content": {
-              "mediaType": "VIDEO",
-              "mediaUrl": "/fixture/trustee-talk",
-              "speaker": "Priya Sharma",
-              "duration": "18 minutes"
-            }
-          },
-          {
-            "id": "bbbbbbbb-2222-4222-8222-222222222223",
-            "slug": "sound-of-the-kitchen",
-            "title": "Sound of the Kitchen",
-            "summary": "An audio portrait of Wednesday lunchtime, best enjoyed hungry.",
-            "imageUrl": null,
-            "content": {
-              "mediaType": "AUDIO",
-              "mediaUrl": "/fixture/kitchen-audio",
-              "speaker": null,
-              "duration": "9 minutes"
-            }
-          }
-        ],
         "resources": [
           {
             "id": "88888888-8888-8888-8888-888888888881",

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

@@ -203,20 +203,6 @@
         ".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",

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

@@ -36,14 +36,12 @@
           "events",
           "articles",
           "services",
-          "volunteering",
           "forms",
           "resources",
           "locations",
           "newsletter",
           "i18n",
-          "search",
-          "media"
+          "search"
         ]
       },
       "uniqueItems": true,

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

@@ -775,80 +775,6 @@
         "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",

package/src/vendor/validator/fixture-art.mjs

@@ -18,8 +18,6 @@ const PALETTES = {
   service: [['#2f4d3e', '#132a1f', '#9fc490'], ['#31495c', '#14222e', '#8fb8c9']],
   people: [['#4d4238', '#292019', '#d3a97c'], ['#3d4550', '#1f242b', '#b0a3c4']],
   course: [['#2d4a55', '#112530', '#83c1b0'], ['#4a3c2d', '#251d11', '#c1a583']],
-  media: [['#26243a', '#100e1e', '#8f7fd9'], ['#3a2430', '#1e0f18', '#d97fae']],
-  volunteer: [['#3e4a2d', '#1e2511', '#b7c183'], ['#2d3f4a', '#111e25', '#83a9c1']],
   impact: [['#44503c', '#232b1e', '#c2cf9f'], ['#503c46', '#2b1e25', '#cf9fb4']]
 };
 

package/src/vendor/validator/preview.mjs

@@ -147,12 +147,6 @@ function islandSkeleton(name, ctx = {}, fx = STUDIO_FX) {
       return `<label class="language-switch" data-p60-preview-island="language_switch">${previewNote(name)}<span class="language-switch-label">Language</span><select class="language-switch-select" disabled><option>English</option><option>Cymraeg</option><option>العربية</option></select></label>`;
     case 'search':
       return `<div class="site-search" data-p60-preview-island="search">${previewNote(name)}<form class="site-search-form"><label class="site-search-label">Search this site</label><div class="site-search-fields"><input class="site-search-input" type="search" disabled><button class="site-search-submit" type="button" disabled>Search</button></div></form><ul class="site-search-results"><li class="site-search-result"><span class="site-search-kind">Article</span><a class="site-search-link" href="#">The Community Garden Opens Its Gates</a><p class="site-search-summary">Two years of digging and Saturday mornings in the rain: the Foundry Lane garden is open.</p></li></ul></div>`;
-    case 'volunteer_signup': {
-      const opportunities = fx.sections?.volunteering?.opportunities ?? [];
-      const options = (opportunities.length ? opportunities : [{ title: 'Garden Volunteer' }])
-        .map((o) => `<option>${escapeHtml(o.title)}</option>`).join('');
-      return `<form class="volunteer-signup" data-p60-preview-island="volunteer_signup">${previewNote(name)}<label class="volunteer-field"><span>Opportunity</span><select disabled>${options}</select></label><label class="volunteer-field"><span>Name</span><input disabled></label><label class="volunteer-field"><span>Email address</span><input disabled></label><label class="volunteer-privacy"><input type="checkbox" disabled><span>I agree that the organisation may respond.</span></label><button class="volunteer-submit" type="button" disabled>Register my interest</button></form>`;
-    }
     case 'map': {
       // The impact-map skeleton: the fixture's points projected onto a token-themed canvas —
       // the same fallback rendering production uses until the platform tile layer is configured.
@@ -448,9 +442,7 @@ export async function renderStudioPreview(files, options = {}) {
         emergency: { causes: c.causes ?? [] },
         programmes: { services: c.services ?? [] },
         resources: { resources: c.resources ?? [] },
-        locations: { locations: c.locations ?? [] },
-        volunteering: { opportunities: c.volunteering ?? [] },
-        media: { media: c.media ?? [] }
+        locations: { locations: c.locations ?? [] }
       }
     };
   }

package/src/vendor/validator/validate.mjs

@@ -94,14 +94,12 @@ export async function validateArtifact(files) {
       events: () => sections.has('events') || pages.has('events') || islands.has('events_carousel'),
       articles: () => sections.has('articles') || hasAny(pages, ['articles', 'article']) || islands.has('latest_articles'),
       services: () => sections.has('programmes'),
-      volunteering: () => sections.has('volunteering') || islands.has('volunteer_signup'),
       forms: () => islands.has('form'),
       resources: () => sections.has('resources'),
       locations: () => sections.has('locations'),
       newsletter: () => islands.has('newsletter_signup'),
       i18n: () => islands.has('language_switch'),
-      search: () => islands.has('search'),
-      media: () => sections.has('media')
+      search: () => islands.has('search')
     };
     for (const capability of manifest?.requiresCapabilities ?? []) {
       if (!capabilitySurface[capability]?.()) {
@@ -236,9 +234,7 @@ export async function validateArtifact(files) {
     articles: { island: 'latest_articles', dataKey: 'latestArticles', sentinel: sentinelOf('articles', 'latestArticles', 'title') },
     campaigns: { island: null, dataKey: 'campaigns', sentinel: sentinelOf('campaigns', 'campaigns', 'title') },
     resources: { island: null, dataKey: 'resources', sentinel: sentinelOf('resources', 'resources', 'title') },
-    locations: { island: null, dataKey: 'locations', sentinel: sentinelOf('locations', 'locations', 'name') },
-    volunteering: { island: 'volunteer_signup', dataKey: 'opportunities', sentinel: sentinelOf('volunteering', 'opportunities', 'title') },
-    media: { island: null, dataKey: 'media', sentinel: sentinelOf('media', 'media', 'title') }
+    locations: { island: null, dataKey: 'locations', sentinel: sentinelOf('locations', 'locations', 'name') }
   };
 
   // 2–4. Sections: catalogue membership, parse, fixture renders.