@port60/template-kit 0.9.0 → 0.10.0

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

@@ -64,7 +64,7 @@
       "name": "stickyHeader",
       "status": "available",
       "label": "Sticky header condense",
-      "description": "State classes for scroll-aware headers: past a small threshold the engine adds is-condensed; with the \"auto-hide\" value, scrolling down past 160px adds is-hidden and scrolling up removes it. The engine only ever toggles classes (rAF-throttled) — what condensing or hiding looks like, and whether it animates, is entirely the template's CSS (gate transitions behind prefers-reduced-motion yourself; the classes always apply because a condensed header is layout, not decoration).",
+      "description": "State classes for scroll-aware headers: past a small threshold the engine adds is-condensed; with the \"auto-hide\" value, scrolling down past 160px adds is-hidden and scrolling up removes it. The engine only ever toggles classes (rAF-throttled), what condensing or hiding looks like, and whether it animates, is entirely the template's CSS (gate transitions behind prefers-reduced-motion yourself; the classes always apply because a condensed header is layout, not decoration).",
       "attributes": [
         { "attr": "data-p60-sticky-header", "value": "none for condense-only; \"auto-hide\" adds the hide-on-scroll-down pair" }
       ],
@@ -75,7 +75,7 @@
       "name": "stickyCta",
       "status": "available",
       "label": "Sticky call-to-action bar",
-      "description": "Adds is-stuck once the visitor scrolls past the threshold (the attribute value in px, default 480) and removes it above. The bar should DUPLICATE an action that already exists in the page (a donate button, a ticket link) — because of that, this is the one behaviour whose element may be hidden unconditionally in CSS rather than .p60-js-scoped: a no-JS visitor loses nothing, the original action is still on the page.",
+      "description": "Adds is-stuck once the visitor scrolls past the threshold (the attribute value in px, default 480) and removes it above. The bar should DUPLICATE an action that already exists in the page (a donate button, a ticket link); because of that, this is the one behaviour whose element may be hidden unconditionally in CSS rather than .p60-js-scoped: a no-JS visitor loses nothing; the original action is still on the page.",
       "attributes": [
         { "attr": "data-p60-sticky-cta", "value": "optional scroll threshold in px (default 480)" }
       ],
@@ -86,7 +86,7 @@
       "name": "lightbox",
       "status": "available",
       "label": "Lightbox",
-      "description": "On a group container: each data-p60-lightbox-item is an anchor whose href is the full image (the no-JS render simply navigates to it — already functional). The engine intercepts the click and opens an injected overlay (.p60-lightbox) with the image, a caption from data-p60-caption or the thumbnail's alt, a close button, backdrop and Escape close, arrow-key prev/next within the group, and a focus trap. Reduced motion: no transition on the overlay (the engine sets none; style the steady state).",
+      "description": "On a group container: each data-p60-lightbox-item is an anchor whose href is the full image (the no-JS render simply navigates to it, already functional). The engine intercepts the click and opens an injected overlay (.p60-lightbox) with the image, a caption from data-p60-caption or the thumbnail's alt, a close button, backdrop and Escape close, arrow-key prev/next within the group, and a focus trap. Reduced motion: no transition on the overlay (the engine sets none; style the steady state).",
       "attributes": [
         { "attr": "data-p60-lightbox", "value": "none; the group container" },
         { "attr": "data-p60-lightbox-item", "value": "none; on each anchor to a full image" },
@@ -100,7 +100,7 @@
       "name": "tabs",
       "status": "available",
       "label": "Tabs",
-      "description": "data-p60-tab=\"key\" on each tab control and data-p60-panel=\"key\" on each panel, inside a data-p60-tabs container. The engine wires the tablist/tab/tabpanel roles, aria-selected, roving tabindex, arrow/Home/End keys, toggles is-active on the active pair and hides inactive panels with the hidden attribute — so the no-JS render shows every panel stacked and complete, with no CSS scoping needed. The first tab (or the one authored with is-active) starts active.",
+      "description": "data-p60-tab=\"key\" on each tab control and data-p60-panel=\"key\" on each panel, inside a data-p60-tabs container. The engine wires the tablist/tab/tabpanel roles, aria-selected, roving tabindex, arrow/Home/End keys, toggles is-active on the active pair and hides inactive panels with the hidden attribute, so the no-JS render shows every panel stacked and complete, with no CSS scoping needed. The first tab (or the one authored with is-active) starts active.",
       "attributes": [
         { "attr": "data-p60-tabs", "value": "none; the container" },
         { "attr": "data-p60-tab", "value": "the key of the panel this control activates" },

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

@@ -1,5 +1,5 @@
 {
-  "description": "The maximum lengths of every admin-entered display field a template renders. The admin screens stop input at these caps and the API rejects anything longer, so a template can design cards, headings and captions against known worst cases. Additive-only within a contract major: a bound may loosen, never tighten. Long-form bodies (article bodies, course About pages, service pages) are deliberately outside this table — they are sanitised HTML rendered in dedicated full-width regions, never inside cards.",
+  "description": "The maximum lengths of every admin-entered display field a template renders. The admin screens stop input at these caps and the API rejects anything longer, so a template can design cards, headings and captions against known worst cases. Additive-only within a contract major: a bound may loosen, never tighten. Long-form bodies (article bodies, course About pages, service pages) are deliberately outside this table; they are sanitised HTML rendered in dedicated full-width regions, never inside cards.",
   "groups": [
     {
       "name": "Brand (layout chrome)",
@@ -68,7 +68,7 @@
         {
           "field": "Tag",
           "max": 40,
-          "note": "Each — rendered as chips."
+          "note": "Each, rendered as chips."
         }
       ]
     },
@@ -109,7 +109,7 @@
         {
           "field": "Page name",
           "max": 200,
-          "note": "The body is sanitised HTML rendered full-width — not card content."
+          "note": "The body is sanitised HTML rendered full-width, not card content."
         }
       ]
     }

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

@@ -0,0 +1,193 @@
+{
+  "description": "The CONTENT MODEL REGISTRY (docs/template-content-model.md, v1): the typed `site.content.*` tree every template reads. One realistic organisation, one shape. Four disciplines are baked in from birth because they cannot be retrofitted: every collection is BOUNDED (a documented cap and an explicit moreHref, so a big tenant can never break a render budget); every enum field is OPEN (values grow; templates must survive unknown values, proven behaviourally); every optional field is EXPLICITLY nullable (branch-on-it is the norm); and the model is ADD-ONLY (fields and collections gain `deprecated: true` markers, they are never removed within a major, deprecated means it stops being documented, never that it stops being served). Versioning is COMPUTED, never author-declared: every collection and field carries `since`, the validator derives a template's required minimum from its content footprint at publish, and authors never think about versions. New list or field = minor. Fixture or doc clarification = patch.",
+  "version": "1.0",
+  "root": "site",
+  "siblings": {
+    "description": "site.brand, site.nav, site.socials and site.locale carry the SAME shapes documented in context.json for the flat era; the tree re-addresses them, it does not reshape them.",
+    "keys": ["brand", "nav", "socials", "locale"]
+  },
+  "collections": {
+    "services": {
+      "since": "1.0",
+      "cap": 24,
+      "moreHref": "/services",
+      "description": "The organisation's published content pages (the services CMS), newest curation order first.",
+      "item": {
+        "id": { "type": "string", "since": "1.0" },
+        "title": { "type": "string", "since": "1.0", "max": 200 },
+        "slug": { "type": "string", "since": "1.0" },
+        "summary": { "type": "string", "since": "1.0", "nullable": true, "max": 500 },
+        "imageUrl": { "type": "string", "since": "1.0", "nullable": true },
+        "href": { "type": "string", "since": "1.0" }
+      }
+    },
+    "events": {
+      "since": "1.0",
+      "cap": 12,
+      "moreHref": "/events",
+      "description": "Published events, soonest first. `registrationMode` is an OPEN enum: INFO, RSVP and TICKETED exist today and new modes will arrive; branch on the ones you style and fall back for the rest.",
+      "item": {
+        "id": { "type": "string", "since": "1.0" },
+        "name": { "type": "string", "since": "1.0", "max": 200 },
+        "description": { "type": "string", "since": "1.0", "nullable": true, "max": 200 },
+        "registrationMode": { "type": "string", "since": "1.0", "enumOpen": ["INFO", "RSVP", "TICKETED"] },
+        "startsAt": { "type": "string", "since": "1.0" },
+        "endsAt": { "type": "string", "since": "1.0", "nullable": true },
+        "venueName": { "type": "string", "since": "1.0", "nullable": true, "max": 200 },
+        "online": { "type": "boolean", "since": "1.0" },
+        "imageUrl": { "type": "string", "since": "1.0", "nullable": true },
+        "onSale": { "type": "boolean", "since": "1.0" },
+        "soldOut": { "type": "boolean", "since": "1.0" },
+        "priceFrom": { "type": "number", "since": "1.0", "nullable": true },
+        "currency": { "type": "string", "since": "1.0", "nullable": true },
+        "detailHref": { "type": "string", "since": "1.0" }
+      }
+    },
+    "articles": {
+      "since": "1.0",
+      "cap": 12,
+      "moreHref": "/articles/all",
+      "description": "Published articles, newest first. Detail bodies stay editor-owned sanitised richtext on the article page BY DESIGN; the card model carries everything a listing needs.",
+      "item": {
+        "id": { "type": "string", "since": "1.0" },
+        "title": { "type": "string", "since": "1.0", "max": 200 },
+        "slug": { "type": "string", "since": "1.0" },
+        "excerpt": { "type": "string", "since": "1.0", "nullable": true, "max": 500 },
+        "imageUrl": { "type": "string", "since": "1.0", "nullable": true },
+        "authorName": { "type": "string", "since": "1.0", "nullable": true, "max": 120 },
+        "authorRole": { "type": "string", "since": "1.0", "nullable": true, "max": 120 },
+        "categories": { "type": "string[]", "since": "1.0" },
+        "publishedAt": { "type": "string", "since": "1.0" },
+        "readingMinutes": { "type": "number", "since": "1.0", "nullable": true },
+        "href": { "type": "string", "since": "1.0" }
+      }
+    },
+    "campaigns": {
+      "since": "1.0",
+      "cap": 12,
+      "moreHref": "/campaigns",
+      "description": "Live campaigns, curation order.",
+      "item": {
+        "id": { "type": "string", "since": "1.0" },
+        "title": { "type": "string", "since": "1.0", "max": 200 },
+        "href": { "type": "string", "since": "1.0" },
+        "summary": { "type": "string", "since": "1.0", "nullable": true, "max": 500 },
+        "imageUrl": { "type": "string", "since": "1.0", "nullable": true }
+      }
+    },
+    "causes": {
+      "since": "1.0",
+      "cap": 12,
+      "moreHref": "/donate",
+      "description": "Causes currently accepting donations, quick-give first. `paymentOptions` mirrors the public cause contract.",
+      "item": {
+        "id": { "type": "string", "since": "1.0" },
+        "title": { "type": "string", "since": "1.0", "max": 200 },
+        "slug": { "type": "string", "since": "1.0" },
+        "description": { "type": "string", "since": "1.0", "nullable": true, "max": 500 },
+        "imageUrl": { "type": "string", "since": "1.0", "nullable": true },
+        "targetAmount": { "type": "number", "since": "1.0", "nullable": true },
+        "raisedAmount": { "type": "number", "since": "1.0", "nullable": true },
+        "progressPercentage": { "type": "number", "since": "1.0", "nullable": true },
+        "href": { "type": "string", "since": "1.0" },
+        "paymentOptions": { "type": "object", "since": "1.0", "nullable": true }
+      }
+    },
+    "courses": {
+      "since": "1.0",
+      "cap": 12,
+      "moreHref": "/courses",
+      "description": "Enrollable courses. The long-form About body is sanitised richtext on the course page, never in cards.",
+      "item": {
+        "id": { "type": "string", "since": "1.0" },
+        "title": { "type": "string", "since": "1.0", "max": 200 },
+        "description": { "type": "string", "since": "1.0", "nullable": true, "max": 500 },
+        "imageUrl": { "type": "string", "since": "1.0", "nullable": true },
+        "venue": { "type": "string", "since": "1.0", "nullable": true, "max": 200 },
+        "audience": { "type": "string", "since": "1.0", "enumOpen": ["ADULT", "CHILD", "FAMILY"] },
+        "priceFrom": { "type": "number", "since": "1.0", "nullable": true },
+        "currency": { "type": "string", "since": "1.0", "nullable": true },
+        "soldOut": { "type": "boolean", "since": "1.0" },
+        "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,
+      "moreHref": "/resources",
+      "description": "Published documents, grouped by folder.",
+      "item": {
+        "id": { "type": "string", "since": "1.0" },
+        "title": { "type": "string", "since": "1.0", "max": 200 },
+        "folder": { "type": "string", "since": "1.0", "nullable": true },
+        "url": { "type": "string", "since": "1.0" },
+        "contentType": { "type": "string", "since": "1.0", "nullable": true },
+        "bytes": { "type": "number", "since": "1.0", "nullable": true },
+        "publishedAt": { "type": "string", "since": "1.0", "nullable": true }
+      }
+    },
+    "locations": {
+      "since": "1.0",
+      "cap": 12,
+      "moreHref": "/locations",
+      "description": "The organisation's physical places, primary first.",
+      "item": {
+        "id": { "type": "string", "since": "1.0" },
+        "name": { "type": "string", "since": "1.0", "max": 200 },
+        "address": { "type": "string", "since": "1.0", "nullable": true, "max": 500 },
+        "latitude": { "type": "number", "since": "1.0", "nullable": true },
+        "longitude": { "type": "number", "since": "1.0", "nullable": true },
+        "primary": { "type": "boolean", "since": "1.0" },
+        "directionsHref": { "type": "string", "since": "1.0", "nullable": true }
+      }
+    },
+    "schedules": {
+      "since": "1.0",
+      "cap": 4,
+      "moreHref": null,
+      "description": "TYPE-DERIVED recurring schedules. `type` is an OPEN enum; 'worship' is the first (its shape is the layout worship contract: times, labels, today, next). Other institutions arrive as new types; render the types you know, ignore the rest.",
+      "item": {
+        "type": { "type": "string", "since": "1.0", "enumOpen": ["worship"] },
+        "content": { "type": "object", "since": "1.0" }
+      }
+    },
+    "about": {
+      "since": "1.0",
+      "cap": 24,
+      "moreHref": null,
+      "description": "The admin-authored page composition: the ordered sections of the home/about surface. `type` is the section catalogue's OPEN enum; `content` is that section type's fields. This is what `section.*` re-addresses; a mega-page template can walk it directly.",
+      "item": {
+        "type": { "type": "string", "since": "1.0", "enumOpen": [] },
+        "content": { "type": "object", "since": "1.0" }
+      }
+    }
+  }
+}