@port60/template-kit 0.1.0

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

@@ -0,0 +1,95 @@
+{
+ "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"
+   ]
+  }
+ ]
+}

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

@@ -0,0 +1,144 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://developers.port60.co.uk/schemas/template-manifest-v1.json",
+  "title": "Port60 template manifest (contract v1)",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "version", "format", "supports"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{1,48}[a-z0-9]$",
+      "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."
+    },
+    "format": {
+      "type": "string",
+      "enum": ["port60-liquid@1"],
+      "description": "The dialect/contract major this template is written against."
+    },
+    "label": { "type": "string", "maxLength": 60, "description": "Human-readable name shown in pickers." },
+    "description": { "type": "string", "maxLength": 300 },
+    "changelog": {
+      "type": "string",
+      "maxLength": 300,
+      "description": "One human line describing what THIS version changed — shown on the Appearance update nudge."
+    },
+    "supports": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["pages", "sections"],
+      "properties": {
+        "pages": {
+          "type": "array",
+          "items": { "type": "string", "enum": ["home", "about"] },
+          "minItems": 1,
+          "uniqueItems": true,
+          "description": "The pages this template renders (grows with the contract)."
+        },
+        "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."
+        },
+        "islands": {
+          "type": "array",
+          "items": { "type": "string" },
+          "uniqueItems": true,
+          "default": [],
+          "description": "Islands this template places. Every {% island %} name must be listed here AND exist in the platform island registry."
+        },
+        "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."
+        },
+        "pageTemplates": {
+          "type": "array",
+          "items": { "type": "string", "enum": ["events", "course"] },
+          "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."
+        },
+        "worship": {
+          "type": "boolean",
+          "default": false,
+          "description": "True when the layout renders the `worship` context (the prayer/service-times rail). Declared honesty: the choosers badge worship-enabled tenants toward looks that show their times, and warn on looks that don't. Requires supports.layout; the layout must actually branch on `worship`."
+        }
+      }
+    },
+    "fonts": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^https://fonts\\.googleapis\\.com/css2\\?"
+      },
+      "default": [],
+      "description": "Webfont stylesheet URLs the platform loads in <head> (with preconnects, never a CSS @import). Google Fonts css2 URLs only."
+    },
+    "looks": {
+      "type": "array",
+      "maxItems": 8,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "values"],
+        "properties": {
+          "name": {
+            "type": "string",
+            "maxLength": 40,
+            "description": "The look's evocative, author-chosen name — shown as a one-click chip in Appearance."
+          },
+          "values": {
+            "type": "object",
+            "minProperties": 1,
+            "propertyNames": { "pattern": "^[a-zA-Z][a-zA-Z0-9]{0,39}$" },
+            "additionalProperties": { "type": "string" },
+            "description": "Knob key → value. Every key must be a declared settings knob; select values must be listed options; font values must be catalogue families."
+          }
+        }
+      },
+      "default": [],
+      "description": "One-click LOOKS: author-named bundles of knob values (scheme + fonts + width…) applied together. Everything remains individually adjustable afterwards."
+    },
+    "settings": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "schema": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["key", "kind", "label"],
+            "properties": {
+              "key": { "type": "string", "pattern": "^[a-zA-Z][a-zA-Z0-9]{0,39}$" },
+              "kind": { "type": "string", "enum": ["color", "select", "toggle", "font"] },
+              "label": { "type": "string", "maxLength": 60 },
+              "default": {},
+              "options": { "type": "array", "items": { "type": "string" } },
+              "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."
+              },
+              "weights": {
+                "type": "array",
+                "items": { "type": "integer", "minimum": 100, "maximum": 1000 },
+                "uniqueItems": true,
+                "description": "FONT knobs only: the weights this template's typographic system uses for the slot. The host requests these for the tenant's chosen family (clamped to the family's real weights). The tenant picks the FAMILY; weights, sizes and tracking stay template-owned."
+              }
+            }
+          },
+          "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."
+        }
+      }
+    }
+  }
+}