@tryvitris/website-harness 0.0.0-stage → 0.1.0-beta.5

package/bin/types/src/preserve/verify.d.ts

@@ -0,0 +1,29 @@
+export type PreserveCheck = {
+    path: string;
+    width: number;
+    changedPixelRatio: number;
+    dimensionsMatch: boolean;
+    screenshot: string;
+    failures: string[];
+};
+export type PreserveReport = {
+    version: 1;
+    ok: boolean;
+    sourceRevision: string;
+    artifactDigest: string;
+    checkedAt: string;
+    remoteUrl?: string;
+    checks: PreserveCheck[];
+    failures: string[];
+    warnings: string[];
+    assetChecks?: Array<{
+        file: string;
+        ok: boolean;
+        error?: string;
+    }>;
+};
+export declare function verifyPreservedSite(root: string, opts?: {
+    signal?: AbortSignal;
+    onLog?: (line: string) => void;
+    remoteUrl?: string;
+}): Promise<PreserveReport>;

package/bin/types/src/render.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Public render surface for the kernel.
+ * Page compilation lives in compile/; this module re-exports helpers used by the Worker and tests.
+ */
+export { beaconJs, baseCss, compileAllPages, compilePage, compileSite, renderDocument, robotsTxt, siteCss, siteIslands, sitemapXml, usedComponents, } from "./compile/site.ts";
+export { applyRootAttrs, flattenBody, resolveInstanceMotion, rewriteLeadForms, wrapMain, } from "./compile/flatten.ts";
+export { parseFrontmatter } from "./compile/frontmatter.ts";
+export { defaultTitleFromPath, fileToPath } from "./compile/paths.ts";
+/** @deprecated Prefer flattenBody — kept for transitional tests. */
+export declare function interpolate(template: string, ctx: Record<string, unknown>): string;

package/bin/types/src/runtime/beacon.d.ts

@@ -0,0 +1,2 @@
+/** Deferred first-party analytics beacon (shipped as beacon.js). */
+export declare const beaconJs = "(() => {\n  const kernel = document.documentElement.getAttribute(\"data-backend\") || document.documentElement.getAttribute(\"data-kernel\");\n  if (!kernel) return;\n\n  const endpoint = kernel.replace(/\\/$/, \"\") + \"/api/t\";\n  const gpc = navigator.globalPrivacyControl === true\n    || navigator.doNotTrack === \"1\"\n    || window.doNotTrack === \"1\";\n  const preview = location.pathname.match(/^\\/preview\\/([^/]+)/);\n  const src = preview ? \"preview\" : \"live\";\n  const path = location.pathname || \"/\";\n  const params = new URLSearchParams(location.search);\n  const started = Date.now();\n  let maxScroll = 0;\n  let engageCount = 0;\n  let left = false;\n  let pingTimer = 0;\n\n  const uuid = () => (crypto.randomUUID ? crypto.randomUUID() : \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    return (c === \"x\" ? r : (r & 0x3) | 0x8).toString(16);\n  }));\n\n  const readCookie = (name) => {\n    const parts = document.cookie.split(\"; \");\n    for (const part of parts) {\n      const i = part.indexOf(\"=\");\n      if (i === -1) continue;\n      if (part.slice(0, i) === name) return decodeURIComponent(part.slice(i + 1));\n    }\n    return \"\";\n  };\n\n  const writeCookie = (name, value, days) => {\n    const maxAge = Math.floor(days * 86400);\n    const secure = location.protocol === \"https:\" ? \"; Secure\" : \"\";\n    document.cookie = name + \"=\" + encodeURIComponent(value)\n      + \"; Path=/; Max-Age=\" + maxAge + \"; SameSite=Lax\" + secure;\n  };\n\n  const clearCookie = (name) => {\n    const secure = location.protocol === \"https:\" ? \"; Secure\" : \"\";\n    document.cookie = name + \"=; Path=/; Max-Age=0; SameSite=Lax\" + secure;\n  };\n\n  const privacyHref = () => {\n    if (preview) return \"/preview/\" + preview[1] + \"/cookie-compliance\";\n    return \"/cookie-compliance\";\n  };\n\n  let consent = gpc ? \"0\" : (readCookie(\"vitris_cc\") || \"\");\n  let allowCookie = !gpc && consent !== \"0\";\n\n  const uuidRe = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n  let vid = \"\";\n\n  const ensureVid = () => {\n    if (!allowCookie) {\n      vid = \"\";\n      return;\n    }\n    vid = readCookie(\"vitris_vid\");\n    if (!uuidRe.test(vid)) vid = uuid();\n    writeCookie(\"vitris_vid\", vid, 395);\n  };\n  ensureVid();\n\n  const sidKey = \"vitris_sid\";\n  const sidAtKey = \"vitris_sid_at\";\n  let sid = \"\";\n  try {\n    const last = Number(sessionStorage.getItem(sidAtKey) || \"0\");\n    sid = sessionStorage.getItem(sidKey) || \"\";\n    if (!sid || !last || Date.now() - last > 30 * 60 * 1000) sid = uuid();\n    sessionStorage.setItem(sidKey, sid);\n    sessionStorage.setItem(sidAtKey, String(Date.now()));\n  } catch {\n    sid = uuid();\n  }\n\n  const touchSid = () => {\n    try { sessionStorage.setItem(sidAtKey, String(Date.now())); } catch (_) {}\n  };\n\n  const syncVidFields = () => {\n    document.querySelectorAll('form[data-lead-form] input[name=\"vid\"]').forEach((el) => {\n      el.value = vid || \"\";\n    });\n  };\n  syncVidFields();\n\n  const send = (payload) => {\n    const body = new URLSearchParams();\n    for (const [k, v] of Object.entries(payload)) {\n      if (v == null || v === \"\") continue;\n      body.set(k, String(v));\n    }\n    if (preview) body.set(\"slug\", preview[1]);\n    if (vid) body.set(\"vid\", vid);\n    body.set(\"sid\", sid);\n    body.set(\"src\", src);\n    body.set(\"path\", path);\n    if (navigator.sendBeacon && navigator.sendBeacon(endpoint, body)) return;\n    try {\n      fetch(endpoint, { method: \"POST\", body, keepalive: true, credentials: \"omit\", mode: \"cors\" }).catch(() => {});\n    } catch (_) {}\n  };\n\n  let referrerHost = \"\";\n  try {\n    if (document.referrer) referrerHost = new URL(document.referrer).hostname.replace(/^www\\./, \"\");\n  } catch (_) {}\n\n  send({\n    kind: \"pageview\",\n    referrer: referrerHost,\n    utm_medium: params.get(\"utm_medium\") || \"\",\n    utm_source: params.get(\"utm_source\") || \"\",\n    hour: String(new Date().getHours()),\n  });\n\n  const measureScroll = () => {\n    const doc = document.documentElement;\n    const bodyEl = document.body;\n    const height = Math.max(doc.scrollHeight, bodyEl ? bodyEl.scrollHeight : 0, 1);\n    const view = window.innerHeight || doc.clientHeight || 0;\n    const top = window.scrollY || doc.scrollTop || 0;\n    const pct = Math.min(100, Math.round(((top + view) / height) * 100));\n    if (pct > maxScroll) maxScroll = pct;\n  };\n  measureScroll();\n  let scrollRaf = 0;\n  window.addEventListener(\"scroll\", () => {\n    if (scrollRaf) return;\n    scrollRaf = requestAnimationFrame(() => {\n      scrollRaf = 0;\n      measureScroll();\n      touchSid();\n    });\n  }, { passive: true });\n\n  const leave = () => {\n    if (left) return;\n    left = true;\n    measureScroll();\n    const duration = Math.min(30 * 60 * 1000, Math.max(0, Date.now() - started));\n    send({ kind: \"leave\", duration_ms: String(duration), scroll_pct: String(maxScroll) });\n    stopPing();\n  };\n\n  document.addEventListener(\"visibilitychange\", () => {\n    if (document.visibilityState === \"hidden\") leave();\n    else if (allowCookie) {\n      startPing();\n      sendPing();\n    }\n  });\n  window.addEventListener(\"pagehide\", leave);\n\n  const isMaps = (href) => {\n    const h = (href || \"\").toLowerCase();\n    return h.includes(\"google.com/maps\") || h.includes(\"maps.google.\")\n      || h.includes(\"maps.apple.com\") || h.includes(\"bing.com/maps\") || h.includes(\"goo.gl/maps\");\n  };\n\n  const labelOf = (el) => {\n    if (!el) return \"\";\n    const raw = (el.getAttribute(\"aria-label\") || el.getAttribute(\"alt\") || el.textContent || \"\")\n      .replace(/\\s+/g, \" \").trim();\n    return raw.slice(0, 40);\n  };\n\n  const hrefPath = (href) => {\n    try { return new URL(href, location.href).pathname.slice(0, 200); }\n    catch (_) { return \"\"; }\n  };\n\n  document.addEventListener(\"click\", (event) => {\n    const t = event.target;\n    if (!(t instanceof Element)) return;\n\n    if (t.closest(\"[data-cookie-accept]\")) {\n      event.preventDefault();\n      acceptCookies();\n      return;\n    }\n    if (t.closest(\"[data-cookie-reject]\")) {\n      event.preventDefault();\n      rejectCookies();\n      return;\n    }\n\n    touchSid();\n\n    const a = t.closest(\"a[href]\");\n    if (a) {\n      const href = a.getAttribute(\"href\") || \"\";\n      const low = href.toLowerCase();\n      if (low.startsWith(\"tel:\")) {\n        send({ kind: \"convert\", goal: \"tel\", label: labelOf(a) });\n        return;\n      }\n      if (low.startsWith(\"mailto:\")) {\n        send({ kind: \"convert\", goal: \"mailto\", label: labelOf(a) });\n        return;\n      }\n      if (isMaps(href)) {\n        send({ kind: \"convert\", goal: \"maps\", label: labelOf(a), href: hrefPath(href) });\n        return;\n      }\n    }\n\n    if (engageCount >= 25) return;\n\n    const carousel = t.closest(\"[data-quotes-prev], [data-quotes-next], [data-stage-prev], [data-stage-next]\");\n    if (carousel) {\n      engageCount += 1;\n      send({ kind: \"engage\", action: \"carousel\", label: labelOf(carousel) });\n      return;\n    }\n\n    const navA = t.closest(\"[data-nav] a, .c-header__nav a, nav[aria-label='Primary'] a\");\n    if (navA) {\n      engageCount += 1;\n      send({ kind: \"engage\", action: \"nav\", label: labelOf(navA), href: hrefPath(navA.getAttribute(\"href\") || \"\") });\n      return;\n    }\n\n    const btn = t.closest(\"a.btn, button.btn, .btn-outline, .btn-arrow, .c-header__cta\");\n    if (btn) {\n      if (btn.closest(\"form[data-lead-form]\") && (btn.matches(\"button, [type='submit']\"))) return;\n      engageCount += 1;\n      send({ kind: \"engage\", action: \"btn\", label: labelOf(btn), href: hrefPath(btn.getAttribute(\"href\") || \"\") });\n      return;\n    }\n\n    if (t.closest(\"img\") || (a && a.querySelector(\"img\"))) {\n      const img = t.closest(\"img\") || (a && a.querySelector(\"img\"));\n      const link = (img && img.closest(\"a\")) || a;\n      engageCount += 1;\n      send({\n        kind: \"engage\",\n        action: \"img\",\n        label: labelOf(img || link),\n        href: hrefPath(link && link.getAttribute ? link.getAttribute(\"href\") || \"\" : \"\"),\n      });\n    }\n  }, true);\n\n  const sendPing = () => {\n    if (!allowCookie || document.visibilityState !== \"visible\") return;\n    send({ kind: \"ping\" });\n  };\n  const startPing = () => {\n    if (!allowCookie || pingTimer) return;\n    pingTimer = window.setInterval(sendPing, 15000);\n  };\n  const stopPing = () => {\n    if (!pingTimer) return;\n    clearInterval(pingTimer);\n    pingTimer = 0;\n  };\n  if (allowCookie) {\n    sendPing();\n    startPing();\n  }\n\n  const removeBanner = () => {\n    const el = document.getElementById(\"vitris-cookie-banner\");\n    if (el) el.remove();\n  };\n\n  const acceptCookies = () => {\n    if (gpc) return;\n    consent = \"1\";\n    writeCookie(\"vitris_cc\", \"1\", 395);\n    allowCookie = true;\n    ensureVid();\n    syncVidFields();\n    removeBanner();\n    if (document.visibilityState === \"visible\") {\n      startPing();\n      sendPing();\n    }\n  };\n\n  const rejectCookies = () => {\n    consent = \"0\";\n    writeCookie(\"vitris_cc\", \"0\", 395);\n    clearCookie(\"vitris_vid\");\n    vid = \"\";\n    allowCookie = false;\n    syncVidFields();\n    stopPing();\n    removeBanner();\n  };\n\n  if (!gpc && !consent) {\n    const banner = document.createElement(\"div\");\n    banner.id = \"vitris-cookie-banner\";\n    banner.className = \"c-cookie-banner\";\n    banner.setAttribute(\"role\", \"dialog\");\n    banner.setAttribute(\"aria-modal\", \"false\");\n    banner.setAttribute(\"aria-labelledby\", \"vitris-cookie-title\");\n    banner.setAttribute(\"aria-describedby\", \"vitris-cookie-desc\");\n    banner.innerHTML = '<div class=\"c-cookie-banner__inner wrap\">'\n      + '<div class=\"c-cookie-banner__copy\">'\n      + '<p id=\"vitris-cookie-title\" class=\"c-cookie-banner__title\">Cookies on this site</p>'\n      + '<p id=\"vitris-cookie-desc\" class=\"c-cookie-banner__text\">'\n      + \"We use a first-party cookie to understand visits and improve this website. \"\n      + \"You can accept or reject analytics cookies.\"\n      + \"</p>\"\n      + \"</div>\"\n      + '<div class=\"c-cookie-banner__actions\">'\n      + '<button type=\"button\" class=\"btn\" data-cookie-accept>Accept</button>'\n      + '<button type=\"button\" class=\"btn btn-ghost\" data-cookie-reject>Reject</button>'\n      + '<a class=\"c-cookie-banner__more\" href=\"' + privacyHref() + '\">Learn more</a>'\n      + \"</div>\"\n      + \"</div>\";\n    const mount = () => {\n      if (!document.body || document.getElementById(\"vitris-cookie-banner\")) return;\n      document.body.prepend(banner);\n    };\n    if (document.body) mount();\n    else document.addEventListener(\"DOMContentLoaded\", mount);\n  }\n})();\n";

package/bin/types/src/runtime/before-after.d.ts

@@ -0,0 +1,2 @@
+/** Draggable before/after compare slider. */
+export declare const beforeAfterJs = "(() => {\n  const roots = [...document.querySelectorAll(\"[data-island=\\\"before-after\\\"]\")];\n  for (const root of roots) {\n    if (!(root instanceof HTMLElement)) continue;\n    const after = root.querySelector(\".before-after__after\");\n    const handle = root.querySelector(\".before-after__handle\");\n    if (!(after instanceof HTMLElement) || !(handle instanceof HTMLElement)) continue;\n\n    let dragging = false;\n    const setPos = (clientX) => {\n      const rect = root.getBoundingClientRect();\n      const pct = Math.min(100, Math.max(0, ((clientX - rect.left) / rect.width) * 100));\n      after.style.clipPath = `inset(0 0 0 ${pct}%)`;\n      handle.style.left = `${pct}%`;\n      root.setAttribute(\"aria-valuenow\", String(Math.round(pct)));\n    };\n\n    const onMove = (e) => {\n      if (!dragging) return;\n      const x = \"touches\" in e ? e.touches[0].clientX : e.clientX;\n      setPos(x);\n    };\n    const stop = () => { dragging = false; };\n\n    root.addEventListener(\"pointerdown\", (e) => {\n      dragging = true;\n      root.setPointerCapture?.(e.pointerId);\n      setPos(e.clientX);\n    });\n    root.addEventListener(\"pointermove\", onMove);\n    root.addEventListener(\"pointerup\", stop);\n    root.addEventListener(\"pointercancel\", stop);\n    root.addEventListener(\"keydown\", (e) => {\n      if (!(e instanceof KeyboardEvent)) return;\n      const now = Number(root.getAttribute(\"aria-valuenow\") || \"50\");\n      if (e.key === \"ArrowLeft\") setPos(root.getBoundingClientRect().left + ((now - 5) / 100) * root.clientWidth);\n      if (e.key === \"ArrowRight\") setPos(root.getBoundingClientRect().left + ((now + 5) / 100) * root.clientWidth);\n    });\n    root.setAttribute(\"role\", \"slider\");\n    root.setAttribute(\"aria-valuemin\", \"0\");\n    root.setAttribute(\"aria-valuemax\", \"100\");\n    root.setAttribute(\"aria-valuenow\", \"50\");\n    root.tabIndex = 0;\n  }\n})();\n";

package/bin/types/src/runtime/carousel.d.ts

@@ -0,0 +1,2 @@
+/** Buttoned, no-autoplay carousel with scroll-snap. */
+export declare const carouselJs = "(() => {\n  const roots = [...document.querySelectorAll(\"[data-island=\\\"carousel\\\"]\")];\n  for (const root of roots) {\n    const track = root.querySelector(\".carousel__track\");\n    const prev = root.querySelector(\"[data-carousel-prev]\");\n    const next = root.querySelector(\"[data-carousel-next]\");\n    if (!(track instanceof HTMLElement)) continue;\n    const step = () => Math.max(track.clientWidth * 0.85, 240);\n    prev?.addEventListener(\"click\", () => track.scrollBy({ left: -step(), behavior: \"smooth\" }));\n    next?.addEventListener(\"click\", () => track.scrollBy({ left: step(), behavior: \"smooth\" }));\n    root.addEventListener(\"keydown\", (e) => {\n      if (!(e instanceof KeyboardEvent)) return;\n      if (e.key === \"ArrowLeft\") track.scrollBy({ left: -step(), behavior: \"smooth\" });\n      if (e.key === \"ArrowRight\") track.scrollBy({ left: step(), behavior: \"smooth\" });\n    });\n  }\n})();\n";

package/bin/types/src/runtime/cookie-compliance.d.ts

@@ -0,0 +1,14 @@
+export declare const COOKIE_COMPLIANCE_PATH = "/cookie-compliance";
+export declare const COOKIE_COMPLIANCE_FOOTER_LINK: {
+    readonly label: "Cookie compliance";
+    readonly href: "/cookie-compliance";
+};
+/**
+ * Kernel-owned cookie compliance body (no site components).
+ * Sites should link here from their footer: /cookie-compliance
+ */
+export declare function cookieComplianceHtml(siteName: string): string;
+/** @deprecated Editor-era merge — kept as no-op helpers for transitional imports. */
+export declare function withCookieComplianceSite<T extends {
+    pages?: unknown;
+}>(site: T): T;

package/bin/types/src/runtime/experience.d.ts

@@ -0,0 +1,4 @@
+/** Before first paint: keep a route handoff covered, then fail open if runtime fails. */
+export declare function experienceArrivalBootstrap(pauseKey?: string): string;
+/** Opt-in interaction choreography. Customer markup/styles own the composition. */
+export declare const experienceJs: string;

package/bin/types/src/runtime/header.d.ts

@@ -0,0 +1,2 @@
+/** Sticky header scroll state + mobile drawer. */
+export declare const headerJs = "(() => {\n  const headers = [...document.querySelectorAll(\"[data-island=\\\"header\\\"]\")];\n  if (!headers.length) return;\n\n  const onScroll = () => {\n    const scrolled = window.scrollY > 8;\n    for (const el of headers) el.classList.toggle(\"is-scrolled\", scrolled);\n  };\n  onScroll();\n  window.addEventListener(\"scroll\", onScroll, { passive: true });\n\n  for (const root of headers) {\n    const toggle = root.querySelector(\"[data-nav-toggle]\");\n    const drawer = root.querySelector(\".nav-drawer\");\n    const panel = root.querySelector(\".nav-drawer__panel\");\n    if (!toggle || !drawer || !panel) continue;\n\n    const close = () => {\n      drawer.classList.remove(\"is-open\");\n      toggle.setAttribute(\"aria-expanded\", \"false\");\n      document.body.style.overflow = \"\";\n    };\n    const open = () => {\n      drawer.classList.add(\"is-open\");\n      toggle.setAttribute(\"aria-expanded\", \"true\");\n      document.body.style.overflow = \"hidden\";\n      const focusable = panel.querySelector(\"a,button,[tabindex]:not([tabindex='-1'])\");\n      if (focusable instanceof HTMLElement) focusable.focus();\n    };\n\n    toggle.addEventListener(\"click\", () => {\n      if (drawer.classList.contains(\"is-open\")) close();\n      else open();\n    });\n    drawer.addEventListener(\"click\", (e) => {\n      if (e.target === drawer) close();\n    });\n    document.addEventListener(\"keydown\", (e) => {\n      if (e.key === \"Escape\") close();\n    });\n    panel.querySelectorAll(\"a\").forEach((a) => a.addEventListener(\"click\", close));\n  }\n})();\n";

package/bin/types/src/runtime/leads.d.ts

@@ -0,0 +1,2 @@
+/** One shared client for generated and preserved contact forms. Lazy challenge keeps resting layouts intact. */
+export declare const leadsJs = "(() => {\n  let challengeScript;\n  const loadChallenge = () => {\n    if (window.turnstile) return Promise.resolve(window.turnstile);\n    if (!challengeScript) challengeScript = new Promise((resolve, reject) => {\n      const script = document.createElement('script');\n      script.src = 'https://challenges.cloudflare.com/turnstile/v0/api.js?render=explicit';\n      script.onload = () => window.turnstile ? resolve(window.turnstile) : reject(new Error('challenge_unavailable'));\n      script.onerror = () => { script.remove(); challengeScript = null; reject(new Error('challenge_unavailable')); };\n      document.head.append(script);\n    });\n    return challengeScript;\n  };\n  document.querySelectorAll('form[data-lead-form][data-vitris-enhanced]').forEach(form => {\n    // Named controls can shadow native form properties and methods.\n    const data = Object.getOwnPropertyDescriptor(HTMLElement.prototype, 'dataset').get.call(form);\n    const setAttribute = Element.prototype.setAttribute.bind(form);\n    const removeAttribute = Element.prototype.removeAttribute.bind(form);\n    const querySelectorAll = Element.prototype.querySelectorAll.bind(form);\n    if (data.vitrisInitialized) return;\n    data.vitrisInitialized = '1';\n    let submitting = false, key, signature, widget, token = '', challengeResolve, challengeReject, completedSignature;\n    const note = document.createElement('p'); note.className = 'c-lead-status';\n    note.setAttribute('role', 'status'); note.setAttribute('aria-live', 'polite'); note.tabIndex = -1;\n    note.style.display = 'none'; Element.prototype.after.call(form, note);\n    const say = (message, error = false) => {\n      note.style.display = ''; note.setAttribute('role', error ? 'alert' : 'status'); note.textContent = message;\n      if (error) note.focus();\n    };\n    let challengeBox;\n    const challenge = async () => {\n      const api = await loadChallenge();\n      if (challengeBox) challengeBox.style.display = '';\n      if (token) return token;\n      if (!challengeBox) { challengeBox = document.createElement('div'); challengeBox.className = 'vitris-challenge'; challengeBox.setAttribute('aria-label', 'Security verification'); Element.prototype.append.call(form, challengeBox); }\n      return new Promise((resolve, reject) => {\n        challengeResolve = resolve; challengeReject = reject;\n        if (widget !== undefined) api.reset(widget);\n        else widget = api.render(challengeBox, {\n          sitekey: data.vitrisSitekey, action: data.vitrisAction,\n          callback: value => { token = value; challengeResolve?.(value); },\n          'expired-callback': () => { token = ''; if (submitting) say('Security check expired. Please submit again.', true); challengeReject?.(new Error('challenge_expired')); },\n          'timeout-callback': () => { token = ''; challengeReject?.(new Error('challenge_expired')); },\n          'error-callback': () => { token = ''; challengeReject?.(new Error('challenge_unavailable')); }\n        });\n      });\n    };\n    EventTarget.prototype.addEventListener.call(form, 'submit', async event => {\n      if (event.defaultPrevented) return;\n      event.preventDefault(); if (submitting) return;\n      if (!HTMLFormElement.prototype.reportValidity.call(form)) return;\n      const values = new URLSearchParams(new FormData(form));\n      values.delete('cf-turnstile-response'); values.delete('idempotency_key');\n      const current = values.toString();\n      if (current === completedSignature) { say('Your message was already accepted.'); return; }\n      if (!data.vitrisForm || !data.vitrisSitekey) { say('This preview does not send messages. Please use the listed contact details.', true); return; }\n      if (current !== signature) { key = crypto.randomUUID(); signature = current; }\n      submitting = true;\n      const controls = [...querySelectorAll('button[type=\"submit\"], button:not([type]), input[type=\"submit\"], [data-vitrisid=\"emailSendButton\"]')];\n      const prior = controls.map(c => c.disabled);\n      controls.forEach(c => { c.disabled = true; c.setAttribute('aria-disabled', 'true'); }); setAttribute('aria-busy', 'true');\n      let timeout;\n      try {\n        say('Please complete the security check.');\n        const challengeTimeout = new Promise((_, reject) => { timeout = setTimeout(() => reject(new Error('challenge_unavailable')), 120000); });\n        const verified = await Promise.race([challenge(), challengeTimeout]);\n        clearTimeout(timeout);\n        values.set('cf-turnstile-response', verified); values.set('idempotency_key', key);\n        say('Sending your inquiry\u2026');\n        const controller = new AbortController();\n        timeout = setTimeout(() => controller.abort(), Math.max(100, Math.min(30000, Number(data.leadTimeoutMs) || 10000)));\n        const response = await fetch(Object.getOwnPropertyDescriptor(HTMLFormElement.prototype, 'action').get.call(form), { method:'POST', body:values, headers:{accept:'application/json'}, signal:controller.signal, credentials:'omit' });\n        const result = response.headers.get('content-type')?.includes('application/json') ? await response.json() : null;\n        if (!response.ok || result?.ok !== true) throw new Error(result?.error || 'backend_unavailable');\n        say(result.mode === 'test' ? 'Test message accepted. No customer email will be sent.' : 'Message accepted. Your inquiry has been saved.');\n        completedSignature = current;\n        if (challengeBox) challengeBox.style.display = 'none';\n      } catch (error) {\n        const messages = {\n          challenge_required:'Please complete the security check and try again.',\n          challenge_invalid:'Security check expired or was invalid. Please try again.',\n          challenge_replayed:'Security check was already used. Please try again.',\n          challenge_expired:'Security check expired. Please try again.',\n          challenge_unavailable:'Security check is unavailable. Please try again or use the listed contact details.',\n          rate_limited:'Too many attempts. Please wait ten minutes and try again.',\n          validation_error:'Please check your form fields and try again.',\n          form_disabled:'This form is currently unavailable. Please use the listed contact details.',\n          configuration_unavailable:'This form is currently unavailable. Please use the listed contact details.',\n          idempotency_conflict:'This request changed during a retry. Please edit your message and try again.'\n        };\n        say(error?.name === 'AbortError' ? 'The request timed out. Your message is still here; please try again.' : (messages[error?.message] || 'Acceptance could not be confirmed. Your details are still here; please try again or use the listed contact options.'), true);\n        if (challengeBox) challengeBox.style.display = '';\n      } finally {\n        clearTimeout(timeout); token = ''; challengeResolve = null; challengeReject = null;\n        if (window.turnstile && widget !== undefined) window.turnstile.reset(widget);\n        controls.forEach((c, i) => { c.disabled = prior[i]; c.removeAttribute('aria-disabled'); });\n        removeAttribute('aria-busy'); submitting = false;\n      }\n    });\n  });\n})();";

package/bin/types/src/runtime/lightbox.d.ts

@@ -0,0 +1,2 @@
+/** Gallery lightbox via <dialog>. */
+export declare const lightboxJs = "(() => {\n  const roots = [...document.querySelectorAll(\"[data-island=\\\"lightbox\\\"]\")];\n  for (const root of roots) {\n    const dialog = root.querySelector(\"dialog\");\n    const img = dialog?.querySelector(\"img\");\n    if (!(dialog instanceof HTMLDialogElement) || !(img instanceof HTMLImageElement)) continue;\n\n    root.querySelectorAll(\"[data-lightbox-src]\").forEach((btn) => {\n      btn.addEventListener(\"click\", () => {\n        const src = btn.getAttribute(\"data-lightbox-src\");\n        const alt = btn.getAttribute(\"data-lightbox-alt\") || \"\";\n        if (!src) return;\n        img.src = src;\n        img.alt = alt;\n        dialog.showModal();\n      });\n    });\n    dialog.addEventListener(\"click\", (e) => {\n      if (e.target === dialog) dialog.close();\n    });\n    dialog.querySelector(\"[data-lightbox-close]\")?.addEventListener(\"click\", () => dialog.close());\n  }\n})();\n";

package/bin/types/src/runtime/scroll-motion.generated.d.ts

@@ -0,0 +1,4 @@
+export declare const motionEngine = "vanilla";
+export declare const motionAssetHref = "/motion-465c0e1b6d85.js";
+export declare const motionAssetHash = "465c0e1b6d851c4d2cb310d9b41a2bbd533728b4ab53910de78058d169ee7bbe";
+export declare const motionJs = "(()=>{function W(a){window.VitrisMotion?.dispose();let n=()=>{},r=new Map,p=!1,u=matchMedia(\"(prefers-reduced-motion: reduce)\"),c=matchMedia(\"(max-width: 599px)\"),l=new WeakSet,b=[\"count\",\"text\",\"sequence\",\"draw\"],m=[\"entrance\",\"stagger\",...b],h=(o,s,w)=>Number(o.getAttribute(\"data-motion-\"+s)??w),v=()=>{p||(u.addEventListener(\"change\",v),p=!0);for(let[i,g]of r)if(b.includes(g.effect)&&g.phase===\"playing\"){let A=document.getElementById(i);A&&l.add(A)}n(),r=new Map;let o=[],s=[],w=new Map,I=!1,M=(i,g,A,$)=>{i.addEventListener(g,A,$),s.push(()=>i.removeEventListener(g,A,$))},L=i=>{w.get(i)?.(),w.delete(i),i.classList.add(\"is-in\");let g=r.get(i.id);g&&(g.phase=\"complete\")};if(n=()=>{I=!0;for(let i of o)i();for(let i of w.values())i();w.clear();for(let i of s)i()},!(document.documentElement.dataset.motionPolicy===\"off\"||u.matches||!window.IntersectionObserver||!Element.prototype.animate))try{let i=document.documentElement.dataset.motionPolicy===\"enabled\",g=i?'[data-motion],[data-reveal],[data-island=\"counter\"] [data-count-to]':'[data-reveal],[data-island=\"counter\"] [data-count-to]',A=[...document.querySelectorAll(g)],$=(e,t)=>{t.run=a.enter(t.children,t.options,()=>{I||(t.phase=\"complete\",l.add(e),e.classList.add(\"is-in\"))},!0),w.set(e,t.run.cancel)},O=new IntersectionObserver(e=>{try{for(let t of e){let x=t.target,d=r.get(x.id);!d||d.static||(t.isIntersecting&&(d.effect!==\"count\"||t.intersectionRatio>=.35)&&d.phase===\"pending\"?(d.phase=\"playing\",d.run||$(x,d),d.run.play(),d.repeat||O.unobserve(x)):!t.isIntersecting&&d.phase===\"playing\"&&b.includes(d.effect)?(l.add(x),L(x)):!t.isIntersecting&&d.repeat&&d.phase===\"complete\"&&(L(x),d.phase=\"pending\",d.run=null,$(x,d)))}}catch(t){n(),r.clear(),console.warn(\"Motion playback failed; static content restored\",t)}},{threshold:[0,.35],rootMargin:\"0px 0px -10% 0px\"});o.push(()=>O.disconnect());for(let e of A){e.id||(e.id=`motion-runtime-${A.indexOf(e)}`);let t=i&&e.getAttribute(\"data-motion\")||(e.hasAttribute(\"data-count-to\")?\"count\":e.hasAttribute(\"data-reveal-stagger\")?\"stagger\":\"entrance\"),x=e.getBoundingClientRect(),d=getComputedStyle(e),K=e.parentElement?.closest(g),R=t===\"story\"||!!K||[\"MAIN\",\"HEADER\",\"FOOTER\",\"BODY\",\"HTML\"].includes(e.tagName)||/(?:^|\\s)c-(?:site-)?(?:hero|header|footer)(?:\\s|$)/.test(e.className)||x.height>innerHeight*2||d.position===\"sticky\"||d.position===\"fixed\"||c.matches&&(e.getAttribute(\"data-motion-mobile\")===\"static\"||t===\"drift\"&&!e.hasAttribute(\"data-motion-mobile\")),Q=t===\"text\"?\"[data-motion-word]\":t===\"draw\"?\"[data-motion-path]\":i?\"[data-motion-child],[data-reveal-child]\":\"[data-reveal-child]\",V=[\"stagger\",\"text\",\"sequence\",\"draw\"].includes(t)?[...e.querySelectorAll(Q)].filter(S=>S.closest(g)===e&&(t!==\"stagger\"||!S.hasAttribute(\"data-motion-child\")||S.parentElement===e)):[],Z=V.length?V:[e],B={effect:t,treatment:e.getAttribute(\"data-motion-treatment\")||\"phrase\",duration:h(e,\"duration\",t===\"count\"?900:Number.parseFloat(d.getPropertyValue(\"--reveal-dur\"))||550),delay:h(e,\"delay\",0),distance:h(e,\"distance\",t===\"text\"?4:Number.parseFloat(d.getPropertyValue(\"--reveal-dist\"))||16),stagger:h(e,\"stagger\",70),from:e.getAttribute(\"data-motion-from\")||e.getAttribute(\"data-reveal-from\")||\"up\",ease:e.getAttribute(\"data-motion-ease\")||\"editorial\"},C={effect:t,static:R,phase:\"pending\",children:Z,options:B,repeat:e.getAttribute(\"data-motion-replay\")===\"repeat\",progress:null};if(r.set(e.id,C),R||b.includes(t)&&l.has(e)||m.includes(t)&&(x.bottom<=0||location.hash.slice(1)===e.id||e.contains(document.activeElement))||[\"entrance\",\"stagger\",\"text\",\"sequence\"].includes(t)&&x.top<innerHeight){C.static=!0,L(e);continue}if(m.includes(t))O.observe(e);else{let S=document.getElementById(e.getAttribute(\"data-motion-trigger\"));if(!S){C.static=!0;continue}C.phase=\"linked\";let T=h(e,\"range-start\",0),H=h(e,\"range-end\",1);C.progress=()=>{let U=S.getBoundingClientRect();return Math.max(0,Math.min(1,((innerHeight-U.top)/(innerHeight+U.height)-T)/(H-T)))};let Y=a.link(e,S,t,{...B,start:T,end:H},C.progress);w.set(e,Y.cancel),o.push(Y.cancel)}}for(let e of A){let t=r.get(e.id);t&&!t.static&&m.includes(t.effect)&&$(e,t)}let D=e=>{for(let t of A)(t===e.target||t.contains(e.target))&&L(t)},P=()=>{let e=document.getElementById(decodeURIComponent(location.hash.slice(1)));e&&D({target:e})};M(document,\"focusin\",D),M(window,\"hashchange\",P),P(),M(window,\"pageshow\",e=>{e.persisted&&v()}),M(c,\"change\",v),M(window,\"resize\",()=>{for(let e of A){let t=r.get(e.id);t&&[\"text\",\"sequence\"].includes(t.effect)&&(l.add(e),L(e))}}),M(document.fonts,\"loadingdone\",()=>{for(let e of A){let t=r.get(e.id);t&&t.phase!==\"pending\"&&[\"text\",\"sequence\"].includes(t.effect)&&(l.add(e),L(e))}})}catch(i){n(),r.clear(),console.warn(\"Motion initialization left static content readable\",i)}},f=!1,y=0,E=()=>{let o=!1,s=()=>{o||f||(o=!0,clearTimeout(y),v())};y=setTimeout(s,1500),(document.fonts?.status===\"loading\"?document.fonts.ready:Promise.resolve()).then(s,s)};window.VitrisMotion={version:1,engine:a.name,init:v,dispose(){f=!0,clearTimeout(y),document.removeEventListener(\"DOMContentLoaded\",E),n(),r=new Map,u.removeEventListener(\"change\",v),p=!1},inspect(o){let s=r.get(o);return s?{effect:s.effect,static:s.static,phase:s.phase,progress:typeof s.progress==\"function\"?s.progress():null}:{static:!0,phase:\"static\",progress:null}}},window.VitrisCounters={dispose(){window.VitrisMotion.dispose()}},document.readyState===\"complete\"||performance.getEntriesByType(\"navigation\")[0]?.domContentLoadedEventStart>0?E():document.addEventListener(\"DOMContentLoaded\",E,{once:!0})}var q=new Set,z=0;function X(a){z=0;for(let n of[...q])n.update(a);q.size&&(z=requestAnimationFrame(X))}function j(a,n,r){let p=a.textContent,u=!a.hasAttribute(\"data-motion\"),c=Number(a.getAttribute(u?\"data-count-to\":\"data-motion-value\")),l=p.match(/[-+]?\\d[\\d,]*(?:\\.\\d+)?/);if(!Number.isFinite(c)||!l||a.children.length)return{play(){r()},cancel(){}};let b=u?p.slice(0,l.index):a.getAttribute(\"data-motion-prefix\")||\"\",m=u?p.slice(l.index+l[0].length):a.getAttribute(\"data-motion-suffix\")||\"\",h=u?l[0].split(\".\")[1]?.length||0:Number(a.getAttribute(\"data-motion-decimals\")||0),v=u?l[0].includes(\",\"):a.getAttribute(\"data-motion-group\")!==\"false\",f=u?l[0].startsWith(\"+\"):a.getAttribute(\"data-motion-sign\")===\"always\",y=i=>b+(f&&i>=0?\"+\":\"\")+i.toLocaleString(\"en-US\",{minimumFractionDigits:h,maximumFractionDigits:h,useGrouping:v})+m;if(!u&&y(c)!==p)return{play(){r()},cancel(){}};let E=null,o=null,s=null,w=!1,I=a.getAttribute(\"style\"),M=()=>{q.delete(L),q.size||(cancelAnimationFrame(z),z=0),o&&(a.replaceChildren(...o.childNodes),o=null,s=null,I===null?a.removeAttribute(\"style\"):a.setAttribute(\"style\",I))},L={update(i){E===null&&(E=i);let g=Math.min(1,(i-E)/n.duration);if(g>=1){M(),w=!0,r();return}s.textContent=y(c*(1-Math.pow(1-g,3)))}};return{play(){w||o||(o=document.createElement(\"span\"),o.style.opacity=\"0\",o.append(...a.childNodes),s=document.createElement(\"span\"),s.setAttribute(\"aria-hidden\",\"true\"),s.setAttribute(\"data-motion-visual\",\"\"),s.style.cssText=\"position:absolute;inset:0;user-select:none;pointer-events:none;white-space:inherit\",s.textContent=y(0),a.style.position=\"relative\",a.style.display=\"inline-block\",a.append(o,s),q.add(L),z||(z=requestAnimationFrame(X)))},cancel(){w=!0,M()}}}var _={editorial:\"cubic-bezier(.22,1,.36,1)\",gentle:\"cubic-bezier(.25,.1,.25,1)\",linear:\"linear\"},G=a=>{let n=getComputedStyle(a).transform;return n===\"none\"?\"\":n},F=new Set,N=0,ee=()=>{N=0;let a=[...F].filter(n=>n.active||n.dirty).map(n=>[n,n.progress()]);for(let[n,r]of a)n.write(r),n.dirty=!1},k=()=>{N||(N=requestAnimationFrame(ee))},J={name:\"vanilla\",enter(a,n,r,p=!1){if(n.effect===\"count\")return j(a[0],n,r);let u=a.map((c,l)=>{let b=G(c),m=getComputedStyle(c).opacity,h=[\"left\",\"right\"].includes(n.from)?\"X\":\"Y\",v=[\"down\",\"left\"].includes(n.from)?-1:1,f={opacity:0,transform:`${b} translate${h}(${v*n.distance}px)`},y={opacity:m,transform:b||\"none\"};if(n.effect===\"text\"&&n.treatment===\"mask\"&&(f.clipPath=\"inset(0 0 100% 0)\",y.clipPath=\"inset(0 0 0% 0)\"),n.effect===\"sequence\"&&c.getAttribute(\"data-motion-role\")===\"image\"&&(f={opacity:m,transform:`${b} scale(1.015)`},y={opacity:m,transform:b||\"none\"}),n.effect===\"draw\"){let o=c.getTotalLength?.()||1;f={strokeDasharray:`${o} ${o}`,strokeDashoffset:o},y={strokeDasharray:`${o} ${o}`,strokeDashoffset:0}}let E=c.animate([f,y],{duration:n.duration,delay:Math.min(300,n.delay+l*n.stagger),easing:_[n.ease],fill:\"both\"});return p&&E.pause(),E});return Promise.all(u.map(c=>c.finished)).then(()=>{for(let c of u)c.cancel();r()}).catch(()=>{}),{play(){for(let c of u)c.play()},cancel(){for(let c of u)c.cancel()}}},link(a,n,r,p,u){let c=G(a),l=f=>r===\"drift\"?`${c} translateY(${p.distance*(2*f-1)}px)`:`${c} scaleX(${f})`;try{if(window.ViewTimeline){let f=new ViewTimeline({subject:n,axis:\"block\",inset:\"0px\"}),y=a.animate([{transform:l(0)},{transform:l(1)}],{timeline:f,rangeStart:`cover ${p.start*100}%`,rangeEnd:`cover ${p.end*100}%`,easing:\"linear\",fill:\"both\"});return{cancel(){y.cancel()}}}}catch{}let b=a.style.transform,m={active:!0,dirty:!0,progress:u,write:f=>{a.style.transform=l(f)}};F.size||(addEventListener(\"scroll\",k,{passive:!0}),addEventListener(\"resize\",k)),F.add(m);let h=new IntersectionObserver(f=>{m.active=f[0].isIntersecting,m.dirty=!0,k()});h.observe(n);let v=window.ResizeObserver?new ResizeObserver(()=>{m.dirty=!0,k()}):null;return v?.observe(n),document.fonts?.ready.then(()=>{F.has(m)&&(m.dirty=!0,k())}),k(),{cancel(){F.delete(m),F.size||(cancelAnimationFrame(N),N=0,removeEventListener(\"scroll\",k),removeEventListener(\"resize\",k)),h.disconnect(),v?.disconnect(),a.style.transform=b}}}};W(J);})();\n";

package/bin/types/src/runtime/tabs.d.ts

@@ -0,0 +1,2 @@
+/** ARIA tabs. */
+export declare const tabsJs = "(() => {\n  const roots = [...document.querySelectorAll(\"[data-island=\\\"tabs\\\"]\")];\n  for (const root of roots) {\n    const tabs = [...root.querySelectorAll(\"[role=\\\"tab\\\"]\")];\n    const panels = [...root.querySelectorAll(\"[role=\\\"tabpanel\\\"]\")];\n    if (!tabs.length) continue;\n\n    const select = (tab) => {\n      for (const t of tabs) {\n        const on = t === tab;\n        t.setAttribute(\"aria-selected\", on ? \"true\" : \"false\");\n        t.tabIndex = on ? 0 : -1;\n      }\n      const id = tab.getAttribute(\"aria-controls\");\n      for (const p of panels) {\n        p.hidden = p.id !== id;\n      }\n    };\n\n    tabs.forEach((tab, i) => {\n      tab.addEventListener(\"click\", () => select(tab));\n      tab.addEventListener(\"keydown\", (e) => {\n        if (!(e instanceof KeyboardEvent)) return;\n        let next = i;\n        if (e.key === \"ArrowRight\") next = (i + 1) % tabs.length;\n        if (e.key === \"ArrowLeft\") next = (i - 1 + tabs.length) % tabs.length;\n        if (next !== i) {\n          e.preventDefault();\n          tabs[next].focus();\n          select(tabs[next]);\n        }\n      });\n    });\n    const initial = tabs.find((t) => t.getAttribute(\"aria-selected\") === \"true\") || tabs[0];\n    select(initial);\n  }\n})();\n";

package/bin/types/src/schema.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Schema helpers retained for dormant admin / patch paths.
+ * Site components no longer ship schema.json — agents author HTML directly.
+ */
+export type BoundField = {
+    key: string;
+    label: string;
+    type: string;
+    bind: string;
+    sectionId: string;
+    component: string;
+    path: string;
+};
+export declare function componentLabel(component: string): string;
+export declare function isKernelOwnedBind(bind: string): boolean;
+export declare function uniqueBinds(fields: BoundField[]): {
+    bind: string;
+    component: string;
+    sectionId: string;
+}[];
+export declare function fieldsForBind(fields: BoundField[], bind: string): BoundField[];
+/** @deprecated Owner editor removed — always returns []. */
+export declare function builderFields(): BoundField[];
+export declare function getPath(tree: Record<string, unknown>, path: string): unknown;
+export declare function setPath(tree: Record<string, unknown>, path: string, value: unknown): void;
+export declare function resolveEditorPage(_site: unknown, raw: string | null | undefined): string;
+export declare const DETAILS_BINDS: readonly ["header", "footer"];

package/bin/types/src/stock/library.d.ts

@@ -0,0 +1,14 @@
+import type { StockCatalog, StockItem } from "./types.ts";
+export declare const digest: (bytes: Uint8Array) => string;
+export declare function readStockCatalog(path: string): StockCatalog;
+export declare function accepted(item: StockItem): boolean;
+/** Resolve local immutable cache first, then a provider URL pinned by its expected hash. */
+export declare function stockBytes(item: StockItem, cacheRoot: string, thumb?: boolean, assetOrigin?: string | undefined): Promise<Buffer>;
+export declare function importStock(opts: {
+    root: string;
+    cacheRoot: string;
+    item: StockItem;
+    reason: string;
+    placements: string[];
+    assetOrigin?: string;
+}): Promise<string>;

package/bin/types/src/stock/search.d.ts

@@ -0,0 +1,30 @@
+import type { StockItem } from "./types.ts";
+export type StockQuery = {
+    text?: string;
+    subject?: string;
+    context?: string;
+    detail?: string;
+    metaphor?: string;
+    composition?: string;
+    palette?: string[];
+    lighting?: string;
+    setting?: string;
+    unwantedSubjects?: string[];
+    cropTolerance?: "low" | "medium" | "high";
+    recentExposure?: Record<string, number>;
+    kind?: "image" | "video";
+    industry?: string;
+    role?: string;
+    orientation?: "landscape" | "portrait" | "square";
+    negativeSpace?: string;
+    minWidth?: number;
+    limit?: number;
+};
+/** Pure retrieval shared by the browser picker and agent. Captions are searchable, never proof of inspection. */
+export declare function searchStock(items: StockItem[], query?: StockQuery): StockItem[];
+/** Set ranking is advisory; actual finalist pixels still determine acceptance. */
+export declare function selectStockSet(items: StockItem[], queries: StockQuery[]): {
+    query: StockQuery;
+    item?: StockItem;
+    uncertainty: string[];
+}[];

package/bin/types/src/stock/selection.d.ts

@@ -0,0 +1,30 @@
+import { type MediaInventory } from "../agent/artifacts.ts";
+export type MediaAsset = MediaInventory["assets"][number];
+export type MediaSlot = {
+    id: string;
+    route: string;
+    purpose: string;
+    placement?: "section" | "header" | "footer";
+    sectionId?: string;
+    kind?: "image" | "video";
+    identity?: MediaAsset["identity"];
+    minWidth?: number;
+};
+export type MediaSelection = {
+    version: 1;
+    placements: {
+        slot: MediaSlot;
+        assetId?: string;
+        reason: string;
+        crop?: string;
+        noMatch?: boolean;
+    }[];
+};
+export declare function identityAsset(asset: MediaAsset): boolean;
+export declare function eligibleForSlot(asset: MediaAsset, slot: MediaSlot): boolean;
+/** Retrieve by section meaning before imposing the inference cap; inventory order is not relevance. */
+export declare function shortlistForSlot(assets: MediaAsset[], slot: MediaSlot, limit?: number): MediaAsset[];
+export declare function checkMediaIdentity(assets: MediaAsset[], root?: string): string[];
+export declare function validateMediaSelection(root: string, selection?: MediaSelection, requireSelection?: boolean): string[];
+export declare function saveSelection(root: string, selection: MediaSelection): void;
+export declare function validateRenderedMedia(root: string): string[];

package/bin/types/src/stock/types.d.ts

@@ -0,0 +1,54 @@
+export type StockKind = "image" | "video";
+export type MediaInspection = {
+    version: 1;
+    assetHash: string;
+    observedAt: string;
+    observer: string;
+    description: string;
+    evidence: string[];
+    subjects: string[];
+    activities: string[];
+    settings: string[];
+    industries: string[];
+    roles: string[];
+    palette: string[];
+    lighting: string;
+    density: "low" | "medium" | "high";
+    focalPoint: string;
+    negativeSpace: string[];
+    cropNotes: string;
+    visibleText: boolean;
+    motion?: string;
+    uncertainty: string[];
+};
+export type StockItem = {
+    id: string;
+    kind: StockKind;
+    src: string;
+    thumb: string;
+    alt: string;
+    tags: string[];
+    categories: string[];
+    credit: string;
+    pexelsId: number;
+    sha256?: string;
+    sourceUrl?: string;
+    downloadUrl?: string;
+    thumbnailUrl?: string;
+    acquiredAt?: string;
+    termsUrl?: string;
+    width?: number;
+    height?: number;
+    bytes?: number;
+    duration?: number;
+    thumbSha256?: string;
+    thumbBytes?: number;
+    legacySrc?: string;
+    legacyThumb?: string;
+    inspection?: MediaInspection;
+    status?: "staged" | "accepted" | "excluded";
+};
+export type StockCatalog = {
+    version: 1 | 2;
+    items: StockItem[];
+};

package/bin/types/src/theme.d.ts

@@ -0,0 +1,3 @@
+import type { ThemeTokens } from "./types.ts";
+export declare function mergeTheme(partial?: Partial<ThemeTokens> | null): ThemeTokens;
+export declare function themeCss(tokens: ThemeTokens): string;

package/bin/types/src/types.d.ts

@@ -0,0 +1,115 @@
+export type MotionStrength = "off" | "whisper" | "editorial" | "noticeable";
+export type RevealFrom = "up" | "down" | "left" | "right";
+export type MotionConfig = {
+    strength?: MotionStrength;
+    /** Cascade children marked [data-reveal-child] */
+    stagger?: boolean;
+    /** Enter direction. Default `up` (fade-up). */
+    from?: RevealFrom;
+};
+/** Thin site-wide facts. Page composition lives in pages/*.html. */
+export type SiteConfig = {
+    name: string;
+    slug?: string;
+    siteId?: string;
+    sourceFormatVersion?: number;
+    capabilities?: string[];
+    /** Site-wide default for scroll reveal; page instances may override */
+    motion?: MotionConfig;
+    /** Versioned opt-in. Explicit off overrides legacy and new instance behavior. */
+    scrollMotion?: {
+        version: 1;
+        policy: "enabled" | "off";
+    };
+    /** New authoring contract; historical sites omit it, managed upgrade never adds it. */
+    motionComposition?: {
+        version: 2;
+        routes: "all-authored" | string[];
+    };
+    /** Design-run instrumentation; omitted from ordinary single-site authoring. */
+    designRun?: {
+        runId?: string;
+        candidateId?: string;
+    };
+    /** Optional LocalBusiness JSON-LD hints. Address, not email alone, selects LocalBusiness. */
+    telephone?: string;
+    email?: string;
+    address?: string;
+    /** Explicit schema type. Defaults to LocalBusiness only when address is present. */
+    businessType?: string;
+    environment?: "preview" | "production";
+    indexing?: "index" | "noindex";
+    /** Pinned knowledge release for sites created with this kernel. */
+    knowledgeRelease?: string;
+};
+export type ThemeTokens = {
+    colorBg: string;
+    colorText: string;
+    colorMuted: string;
+    colorAccent: string;
+    colorAccentText: string;
+    colorSurface: string;
+    /** Secondary surface (subtle cards, muted bands). */
+    colorSurface2: string;
+    colorBorder: string;
+    colorFocus: string;
+    fontBody: string;
+    fontDisplay: string;
+    radius: string;
+    /** Larger radius for media / elevated cards. */
+    radiusLg: string;
+    /** Pill radius for `.btn` / `.btn-outline`. Cards keep `radius`. */
+    radiusPill: string;
+    maxWidth: string;
+    /** Opt-in type scale and rhythm. Omitted values retain legacy compiler defaults. */
+    typeStep0?: string;
+    typeStep1?: string;
+    typeStep2?: string;
+    typeStep3?: string;
+    typeStep4?: string;
+    typeStep5?: string;
+    sectionY?: string;
+};
+/** @deprecated Editor-era content tree — dormant patch/workflow only. */
+export type ContentTree = Record<string, unknown>;
+export type CatalogEntry = {
+    html: string;
+    css: string;
+    island: string | null;
+};
+export type Catalog = Record<string, CatalogEntry>;
+/** A discovered page after frontmatter parse. */
+export type PageSource = {
+    /** URL path: `/`, `/about`, `/blog/post` */
+    path: string;
+    /** Relative path under pages/, e.g. `index.html`, `blog/post.html` */
+    file: string;
+    title: string;
+    description?: string;
+    indexing?: "index" | "noindex";
+    lang?: string;
+    /** Raw HTML body (authoring tags + content) */
+    body: string;
+};
+export type CompiledPage = {
+    path: string;
+    title: string;
+    description?: string;
+    indexing?: "index" | "noindex";
+    lang?: string;
+    /** Flattened HTML body fragments (no document shell) */
+    bodyHtml: string;
+    /** Component names used on this page */
+    used: string[];
+    /** Whether any section has motion enabled */
+    usesMotion: boolean;
+    motionTargets?: import("./compile/scroll-motion.ts").MotionTarget[];
+    /** Whether a lead form is present */
+    usesLeadForm: boolean;
+};
+export declare const defaultTheme: ThemeTokens;
+export declare const themeFields: {
+    key: keyof ThemeTokens;
+    label: string;
+    kind: "color" | "text";
+}[];

package/bin/types/src/upgrade/kit.d.ts

@@ -0,0 +1,48 @@
+export interface ManagedKitManifest {
+    schemaVersion: 1;
+    harnessVersion: string;
+    files: Record<string, string>;
+}
+export interface KitUpgradePlan {
+    schemaVersion: 1;
+    targetVersion: string;
+    sourceRevision: string;
+    kitDigest: string;
+    targetDigest: string;
+    updates: string[];
+    additions: string[];
+    conflicts: Array<{
+        path: string;
+        reason: string;
+    }>;
+    migrations: string[];
+    requiredChecks: string[];
+    evidenceInvalidation: string[];
+}
+export declare function recordManagedKit(siteRoot: string, harnessRoot: string): ManagedKitManifest;
+export declare function resolveManagedInstructionWithProvenance(siteRoot: string, harnessRoot: string, path: string): {
+    content: string;
+    provenance: string;
+};
+export declare function resolveManagedInstruction(siteRoot: string, harnessRoot: string, path: string): string;
+export declare function planKitUpgrade(siteRoot: string, targetHarnessRoot: string): KitUpgradePlan;
+export declare function applyKitUpgrade(siteRoot: string, targetHarnessRoot: string, plan: KitUpgradePlan): {
+    status: "applied";
+    backup: string;
+    changed: string[];
+    manifest: ManagedKitManifest;
+};
+export declare function recoverKitUpgrade(siteRoot: string): {
+    status: "nothing_to_recover";
+    changed?: undefined;
+} | {
+    status: "applied_receipt_found";
+    changed?: undefined;
+} | {
+    status: "recovered";
+    changed: string[];
+};
+export declare function rollbackKitUpgrade(siteRoot: string): {
+    status: "rolled_back";
+    changed: string[];
+};