@port60/template-kit 1.0.0 → 1.2.0

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

@@ -92,7 +92,9 @@
         "upcase",
         "url_decode",
         "url_encode",
-        "where"
+        "where",
+        "t",
+        "local_date"
       ],
       "excluded": {
         "tags": [
@@ -200,6 +202,18 @@
             "pages",
             "sections"
           ],
+          "dependentSchemas": {
+            "heroImageLimit": {
+              "required": [
+                "heroImagery"
+              ],
+              "properties": {
+                "heroImagery": {
+                  "const": true
+                }
+              }
+            }
+          },
           "properties": {
             "pages": {
               "type": "array",
@@ -260,6 +274,53 @@
               "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`."
             },
+            "navigationModes": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "options",
+                "default"
+              ],
+              "properties": {
+                "options": {
+                  "type": "array",
+                  "minItems": 2,
+                  "maxItems": 2,
+                  "uniqueItems": true,
+                  "items": {
+                    "enum": [
+                      "simple",
+                      "mega"
+                    ]
+                  }
+                },
+                "default": {
+                  "enum": [
+                    "simple",
+                    "mega"
+                  ]
+                }
+              },
+              "description": "Explicit header presentation switch for this exact layout. Both simple and mega must be implemented without changing saved navigation nodes, destinations or metadata. Requires supports.layout. The host resolves an accepted saved menus.headerMode or this default into site.nav.headerMode. Mark the navigation root data-p60-navigation-mode with that resolved mode. Missing support preserves the historical layout and leaves saved preferences unused, never inferred from navigationHighlights."
+            },
+            "sectionCollectionLinkVisibility": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 7,
+              "uniqueItems": true,
+              "items": {
+                "enum": [
+                  "events",
+                  "articles",
+                  "courses",
+                  "campaigns",
+                  "services",
+                  "documents",
+                  "appealGrid"
+                ]
+              },
+              "description": "Supported collection section types whose existing onward link may be hidden. Every entry must also be in supports.sections and render its supplied collection destination on a permanent data-p60-collection-link anchor. Only section.showCollectionLink == false adds hidden; absent or true retains the template default link. Keep its shared label and destination unchanged, and never hide the heading, records, cards or individual record links. No new URLs, text override or positioning control."
+            },
             "navigationHighlights": {
               "type": "boolean",
               "default": false,
@@ -271,11 +332,55 @@
               "description": "True when the sections mark which node shows which field with data-p60-field, so the editor can put the caret on the page instead of in a side panel. The address is inside that section's own content: data-p60-field=\"title\", or data-p60-field=\"items.{{ forloop.index0 }}.label\" for an entry in a list. Purely additive: the attribute is markup, the contract is untouched, and a template that marks nothing keeps the section-level editor. The validator reads the marks from the source and warns on any that does not name a field of that section. Missing or false leaves this exact template version editing in the panel.",
               "$comment": "Follows the navigationHighlights pattern: declared honesty, proven by the validator."
             },
+            "sectionHeadingAlignment": {
+              "type": "object",
+              "maxProperties": 16,
+              "propertyNames": {
+                "enum": [
+                  "hero",
+                  "values",
+                  "cta",
+                  "homeHero",
+                  "impact",
+                  "events",
+                  "articles",
+                  "campaigns",
+                  "emergency",
+                  "stats",
+                  "appealGrid",
+                  "services",
+                  "documents",
+                  "people",
+                  "impactMap",
+                  "courses"
+                ]
+              },
+              "additionalProperties": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 3,
+                "uniqueItems": true,
+                "items": {
+                  "enum": [
+                    "start",
+                    "center",
+                    "end"
+                  ]
+                }
+              },
+              "description": "Explicit opt-in per supported section type to desktop heading alignment choices. Missing entries disable the editor control. The host projects section.headingAlignment only for declared options. Mark heading/eyebrow elements using data-p60-heading-align with that value. The shared base applies text-align at widths of at least 1024 CSS pixels; absent/empty hooks retain the template default at every width. The validator proves each declared option renders on real headings and cannot change unrelated content. No layout positioning is implied."
+            },
             "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."
             },
+            "heroImageLimit": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 6,
+              "description": "Maximum homeHero photographs this exact template version can present. Requires supports.heroImagery: true. Missing means one; no hero imagery means zero. Values above one require rendering every image in a fixture of the declared size or placing the hero_carousel island. Generic carousel behavior or island declarations alone do not opt in. This gates editor additions, never truncates saved photographs or changes an older artifact's rendering."
+            },
             "behaviors": {
               "type": "array",
               "items": {
@@ -549,6 +654,13 @@
             "footer"
           ],
           "properties": {
+            "headerMode": {
+              "enum": [
+                "simple",
+                "mega"
+              ],
+              "description": "Resolved header presentation only when the exact template declares navigationModes. The host uses the accepted saved preference or the declared default. Omitted for unsupported templates; never inferred from menu shape or highlights."
+            },
             "header": {
               "type": "array",
               "items": {
@@ -2596,7 +2708,7 @@
           "since": "2.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.",
+          "description": "TYPE-DERIVED recurring schedules. `type` is an OPEN enum; 'worship' is the first (times, labels, today, next, jumah). Mosque daily times and next may carry a stable `key`: fajr, zuhr, asr, maghrib or isha. Use key for icons, never replace the supplied name. Missing/unknown keys remain readable without an icon. Friday rows are `jumah`, not `jumuah`. Other institutions arrive as new types; render the types you know, ignore the rest.",
           "item": {
             "type": {
               "type": "string",
@@ -2625,6 +2737,17 @@
           ],
           "description": "The page opener: a headline with an optional kicker and sanitised rich-text intro.",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -2661,6 +2784,17 @@
           ],
           "description": "A set of principles shown as cards or a numbered list, per the template.",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -2736,6 +2870,17 @@
           ],
           "description": "A closing band: heading, optional line, one button.",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "heading",
               "kind": "text",
@@ -2781,6 +2926,17 @@
           ],
           "description": "The home opener. EVERY field optional: eyebrow/title derive from branding when absent, the lead OMITS when absent (never a fabricated placeholder), buttons fall back to platform defaults.",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -2843,7 +2999,7 @@
               "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. Declare supports.heroImageLimit above one to offer multiple photographs in the editor; missing means one, and absent heroImagery means zero. Saved photographs survive template switches and are never truncated by this capability. Like every field: absent means the template's designed no-photo state, never a placeholder.",
               "itemFields": [
                 {
                   "name": "imageUrl",
@@ -2911,6 +3067,17 @@
           ],
           "description": "What gifts make possible, optional intro plus icon/title/description cards. Claims must be truthful for the tenant.",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3000,6 +3167,23 @@
           "kind": "widget",
           "description": "Published events across registration modes. Render the supplied bounded site.content.events.items with this placement's authored introduction. Optional motion uses declared behaviours; ticket sales and RSVP stay on the platform-owned detail route supplied by each item.",
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3038,6 +3222,23 @@
           "kind": "widget",
           "description": "Published articles from the supplied bounded site.content.articles.items. Render the records with this placement's authored introduction and link through the supplied item URLs. Article engagement and comments remain platform islands on the detail page.",
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3079,6 +3280,23 @@
             "campaignsLabel"
           ],
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3116,6 +3334,17 @@
             "causes"
           ],
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "heading",
               "kind": "text",
@@ -3159,6 +3388,17 @@
           ],
           "description": "Big headline numbers, the at-a-glance impact band. Values are author-entered text (write them exactly as they should read), or, per item, a live figure the platform counts (`source`).",
           "fields": [
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3242,6 +3482,23 @@
             "causes"
           ],
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3331,6 +3588,23 @@
             "services"
           ],
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3368,6 +3642,23 @@
             "resources"
           ],
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3402,6 +3693,17 @@
           ],
           "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": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3494,6 +3796,17 @@
           "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": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -3533,6 +3846,23 @@
             "home"
           ],
           "fields": [
+            {
+              "name": "showCollectionLink",
+              "kind": "boolean",
+              "required": false,
+              "description": "Only false hides this placement's existing onward collection link. Missing or true keeps the template default. Requires this exact template to declare supports.sectionCollectionLinkVisibility for this section. Keep a stable data-p60-collection-link anchor and add hidden only for false. The platform-supplied URL and shared label stay unchanged; headings, records and individual card links are unaffected."
+            },
+            {
+              "name": "headingAlignment",
+              "kind": "select",
+              "required": false,
+              "options": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Desktop alignment of the heading and optional eyebrow. The template may position their heading-only group within its existing content container and gutters while preserving readable width. Only applied when this exact template declares supports.sectionHeadingAlignment for this section and option. Absent means template default. Start/end follow the site direction. Below 1024 CSS pixels the template retains its own layout. Introductions, body copy, buttons, cards, images and islands keep their placement and alignment; full-bleed imagery does not widen the heading bounds."
+            },
             {
               "name": "eyebrow",
               "kind": "text",
@@ -5272,7 +5602,7 @@
           "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.",
+          "description": "Temporarily inactive: currently renders nothing. Localisation supports a site's language and text direction; translated tenant content and an explicit per-site language choice need a separate opt-in design. The host supplies locale and direction independently. Do not add a replacement visitor selector.",
           "params": [],
           "stylingApi": [
             ".language-switch",

package/src/vendor/engine/dialect.mjs

@@ -5,6 +5,8 @@
 // JSON); this module does no file loading.
 
 /** Marker protocol for island placement: the island tag emits these; the renderer splits on them. */
+import { templateMessage, templateDate } from './locale.mjs';
+
 export const ISLAND_MARK_START = '\u0000P60_ISLAND:';
 export const ISLAND_MARK_END = '\u0000';
 
@@ -31,6 +33,8 @@ export function configureDialect(liquid, dialect, islandNames) {
   }
   // Filters LiquidJS ships beyond our whitelist (e.g. its non-standard json/inspect debug filters).
   const allowed = new Set(dialect.filters);
+  if (allowed.has('t')) liquid.registerFilter('t', templateMessage);
+  if (allowed.has('local_date')) liquid.registerFilter('local_date', templateDate);
   for (const name of ['json', 'inspect', 'to_integer', 'normalize_whitespace', 'find', 'find_exp', 'group_by', 'group_by_exp', 'where_exp', 'sum']) {
     if (!allowed.has(name)) {
       liquid.registerFilter(name, () => {

package/src/vendor/engine/locale.mjs

@@ -0,0 +1,74 @@
+// Template interface copy only. Never translate tenant-authored content or source record labels.
+// Plain JS so the host and kit use the exact same implementation, without network or tenant state.
+const arabic = Object.freeze({
+  'Explore': 'تصفّح', 'Menu': 'القائمة', 'Open menu': 'فتح القائمة', 'Close menu': 'إغلاق القائمة',
+  'Skip to content': 'انتقل إلى المحتوى', 'Skip to main content': 'انتقل إلى المحتوى الرئيسي',
+  'Search the website': 'ابحث في الموقع', 'Search this site': 'ابحث في الموقع',
+  'Main': 'التنقل الرئيسي', 'Footer': 'تذييل الصفحة', 'Social links': 'حسابات التواصل',
+  'Cookies': 'ملفات تعريف الارتباط', 'Cookie settings': 'إعدادات ملفات تعريف الارتباط',
+  'Previous image': 'الصورة السابقة', 'Next image': 'الصورة التالية',
+  'Previous campaign': 'الحملة السابقة', 'Next campaign': 'الحملة التالية',
+  'At the mosque': 'في المسجد', 'Prayer times': 'مواقيت الصلاة',
+  'Prayer and Jumuah times': 'مواقيت الصلاة والجمعة', 'Prayer schedule': 'مواقيت الصلاة',
+  'Prayer timetable': 'جدول الصلاة', 'Daily prayer timetable': 'جدول الصلوات اليومية',
+  'Daily prayer times': 'مواقيت الصلوات اليومية', 'Daily prayers': 'الصلوات اليومية',
+  'Prayer': 'الصلاة', 'Jumuah': 'الجمعة', 'Friday prayer': 'صلاة الجمعة',
+  'Friday at the mosque': 'الجمعة في المسجد', 'Prayer information': 'معلومات الصلاة',
+  'Full timetable': 'الجدول الكامل', 'Next:': 'الصلاة القادمة:',
+  'Begins': 'بداية الوقت', 'Congregation': 'الجماعة', 'Jama’at': 'الجماعة',
+  'Read article': 'اقرأ الخبر', 'Read more': 'اقرأ المزيد', 'Find out more': 'اعرف المزيد',
+  'Event details': 'تفاصيل الفعالية', 'View event': 'عرض الفعالية',
+  'View course': 'عرض الدورة', 'Explore course': 'اكتشف الدورة',
+  'View campaign': 'عرض الحملة', 'Explore campaign': 'اكتشف الحملة',
+  'Support this campaign': 'ادعم هذه الحملة', 'Online': 'عبر الإنترنت',
+  'Tickets not on sale': 'التذاكر غير متاحة للبيع', 'Sold out': 'اكتمل العدد',
+  'Free': 'مجاناً', 'From': 'من', 'Registration': 'التسجيل', 'Tickets': 'تذاكر',
+  'Get tickets': 'احجز تذكرتك', 'Book a place': 'احجز مكانك',
+  'Download': 'تنزيل', 'Read document': 'اقرأ المستند', 'View document': 'عرض المستند',
+  'All articles': 'جميع الأخبار', 'All events': 'جميع الفعاليات', 'All courses': 'جميع الدورات',
+  'All campaigns': 'جميع الحملات', 'All services': 'جميع الخدمات',
+  'Article': 'خبر', 'Course': 'دورة', 'Campaign': 'حملة', 'Service': 'خدمة',
+  'Article unavailable': 'الخبر غير متاح', 'Course unavailable': 'الدورة غير متاحة',
+  'This article is not available to view.': 'هذا الخبر غير متاح للعرض.',
+  'This course is not available to view.': 'هذه الدورة غير متاحة للعرض.',
+  'Browse': 'تصفّح', 'Browse courses': 'تصفّح الدورات', 'Back to': 'العودة إلى',
+  'Availability': 'التوفّر', 'Course details': 'تفاصيل الدورة', 'Course options': 'خيارات الدورة',
+  'Course enrolment': 'التسجيل في الدورة', 'Open article photograph': 'فتح صورة الخبر',
+  'Children': 'الأطفال', 'Adults': 'البالغون', 'Families': 'العائلات', 'Everyone': 'الجميع',
+  'Starts': 'البداية', 'Ends': 'النهاية', 'Monthly': 'شهرياً', 'One payment': 'دفعة واحدة',
+  'No places currently available': 'لا توجد أماكن متاحة حالياً', 'Not supplied': 'غير محدد',
+  'Payment': 'الدفع', 'Price': 'السعر', 'Term fee': 'رسوم الفصل', 'Updated': 'آخر تحديث',
+  'Where': 'المكان', 'Who it is for': 'الفئة المستهدفة', 'Open document': 'فتح المستند',
+  'Word document': 'مستند Word', 'Support this appeal': 'ادعم هذا النداء',
+  'View available sessions and enrolment details.': 'اطّلع على الجلسات المتاحة وتفاصيل التسجيل.',
+  'min read': 'دقائق للقراءة', '% of target reached': '% من الهدف',
+});
+
+export const templateMessageKeys = Object.freeze(Object.keys(arabic));
+const language = value => typeof value === 'string' && value.length <= 35
+  ? value.toLowerCase().split('-')[0] : 'en';
+
+/** Unknown copy/languages retain the supplied English UI fallback. Output remains autoescaped. */
+export function templateMessage(message, locale) {
+  if (typeof message !== 'string') return '';
+  return language(locale) === 'ar' && Object.hasOwn(arabic, message) ? arabic[message] : message;
+}
+
+// Exactly six formatter instances at most. No per-tenant or arbitrary-pattern cache growth.
+const formatters = new Map();
+export function templateDate(value, locale, style = 'date') {
+  // A timestamp needs an explicit offset. Date.parse on a zone-less timestamp would depend
+  // on the kit author's machine rather than the host's UTC rendering contract.
+  if (typeof value !== 'string' || value.length > 64 || !/^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,9})?)?(?:Z|[+-]\d{2}:\d{2}))?$/.test(value)) return '';
+  const timestamp = Date.parse(value);
+  if (!Number.isFinite(timestamp) || !['date', 'datetime'].includes(style)) return '';
+  const day = value.slice(0, 10);
+  if (new Date(Date.parse(`${day}T00:00:00Z`)).toISOString().slice(0, 10) !== day) return '';
+  const lang = ['ar', 'cy'].includes(language(locale)) ? language(locale) : 'en-GB';
+  const key = `${lang}:${style}`;
+  if (!formatters.has(key)) formatters.set(key, new Intl.DateTimeFormat(lang, {
+    calendar: 'gregory', timeZone: 'UTC', day: '2-digit', month: 'long', year: 'numeric',
+    ...(style === 'datetime' ? { hour: '2-digit', minute: '2-digit', hourCycle: 'h23' } : {}),
+  }));
+  return formatters.get(key).format(timestamp);
+}