@acms-subir/core 0.3.0 → 0.3.2

package/src/pages/api/webhooks/docs.ts

@@ -0,0 +1,61 @@
+import type { APIRoute } from 'astro';
+import { WEBHOOK_EVENTS } from '../../../lib/schema';
+
+export const GET: APIRoute = () => new Response(`# ACMS webhooks
+
+Owners manage endpoints in Team → API & webhooks (/admin/integrations).
+This screen is available even when the calendar is disabled.
+Select explicit event subscriptions; use Edit event subscriptions to extend an existing endpoint.
+Existing explicit subscriptions do not change. Existing '*' subscriptions receive the new events too.
+
+## Events
+
+${WEBHOOK_EVENTS.map(e => `- ${e}`).join('\n')}
+
+post/page.published: a document becomes public, including scheduled posts.
+post/page.updated: public content changes (including applying a pending draft).
+post/page.unpublished: a public document becomes draft, archived or scheduled.
+post/page.deleted: a published document is deleted.
+Draft creation, autosaves, staged edits and discarded drafts do not emit these events.
+Custom post collections use post.* with the collection key in the payload.
+
+design.published: a design draft is published, including its navigation and sections.
+Restoring design history only stages a draft; publishing it emits this event.
+media.created/updated/deleted: a media record is added, its alt text changes, or it is removed.
+site.restored: a content backup is restored; resync instead of expecting individual record events.
+Existing event.* and booking.* payloads are described at /api/calendar/docs.
+
+## Payloads
+
+Every POST: { "id": "delivery-id", "type": "post.published", "createdAt": "ISO timestamp", "data": { ... } }
+
+post.* data: { "post": { "id", "slug", "title", "status", "collection" }, "previous"?: { same metadata } | null }
+page.* data: { "page": { "id", "slug", "title", "status", "locale", "isHome" }, "previous"?: { same metadata } | null }
+design.published data: { "design": { "revision", "activeTheme", "navigationChanged", "sectionPageIds" } }
+media.* data: { "media": { "id", "key", "filename", "mime", "width", "height", "size", "alt" } }
+site.restored data: { "counts": { "posts", "pages", "media" } }
+
+Content notifications carry metadata, not document bodies or pending drafts.
+On publication/update, fetch current public content from /api/v1/content/<id>?kind=post (or kind=page).
+For unpublish/delete, remove the ID from your index; the public API may already return 404.
+Use previous.slug/collection/locale/isHome to invalidate old routes after a move.
+Treat payloads as event-time snapshots; subsequent edits may already have happened.
+Publication events do not include account details, API keys, settings credentials or draft content.
+Media metadata is sent only to endpoints explicitly subscribed to media events (or '*').
+
+## Verification and delivery
+
+Headers: X-Acms-Event, X-Acms-Delivery, X-Acms-Timestamp, X-Acms-Signature.
+X-Acms-Signature = sha256=<hex HMAC-SHA256(secret, "<timestamp>.<raw body>")>.
+Verify the raw bytes before parsing, compare signatures in constant time, and reject stale timestamps.
+Return 2xx promptly after accepting a delivery; redirects are not followed.
+Failed deliveries retry after 1, 10 and 60 minutes, subject to scheduler execution.
+Requests time out after 8 seconds. Delivery is at-least-once; deduplicate by X-Acms-Delivery/id.
+Delivery order is not guaranteed. Retries keep the same ID and body with a fresh signature/timestamp.
+New notifications are persisted with the mutation and flushed after HTTP writes.
+The scheduled worker/Node scheduler and request sweep recover pending deliveries.
+Keep the independent scheduler configured for delivery during periods without traffic.
+Send test emits ping. Paused endpoints receive no new notifications.
+
+Webhooks notify another server; they do not push changes directly into an open browser.
+`, { headers: { 'Content-Type': 'text/plain; charset=utf-8' } });

package/src/pages/index.astro

@@ -23,6 +23,12 @@ const settings = await effectiveSettings(rawSettings, Astro.url, Astro.cookies,
 // /es must never 404 mid-setup
 if (wantsLocaleHome && !home) home = await repo.getHomePage();
 
+// Live state must not survive in a cached page after its snapshot expires.
+if (settings.live.mode !== 'off' || home?.blocks.some(block => block.type === 'live') ||
+    (home && settings.sectionPages?.[home.id]?.sections.some(section => section.type === 'live'))) {
+  Astro.response.headers.set('Cache-Control', 'no-store');
+}
+
 // A theme may ship templates/home.astro — a coded homepage that wins over the
 // isHome content page unless the Design screen forces 'content'. The template
 // receives the page (its body renders as the hero) plus published posts/tags.

package/src/pages/links.astro

@@ -1,4 +1,5 @@
 ---
+import LiveCard from '../components/LiveCard.astro';
 import Site from '../layouts/Site.astro';
 import { getRepo } from '../lib/repo';
 import { cleanEventName } from '../lib/analytics';
@@ -7,6 +8,7 @@ import { effectiveNav } from '../lib/designPreview';
 
 const repo = await getRepo(Astro.locals);
 const [links, settings, liveNav] = await Promise.all([repo.listLinks(), repo.getSettings(), repo.listNavItems()]);
+if (links.some(link => link.kind === 'live')) Astro.response.headers.set('Cache-Control', 'no-store');
 // staged social links show up in design preview mode
 const navItems = await effectiveNav(liveNav, Astro.url, Astro.cookies, Astro.locals);
 // the site's social links (Navigation → Social) as an icon row under the bio
@@ -104,6 +106,8 @@ const visible = links.filter((l) => {
         ))}
       </nav>
     )}
+    {/* while live, the Live block moves here from wherever it was placed */}
+    <span data-live-slot hidden></span>
     {visible.map((l) => {
       const ico = iconInfo(l);
       const icon =
@@ -112,6 +116,8 @@ const visible = links.filter((l) => {
         ico.type === 'emoji' ? <span class="link-ico link-ico-emoji">{ico.value}</span> :
         null;
       switch (l.kind) {
+        case 'live':
+          return <LiveCard compact />;
         case 'heading':
           return <h2 class="link-heading">{l.label}</h2>;
         case 'text':

package/src/styles/live-admin.css

@@ -0,0 +1,126 @@
+/* Live video admin (LiveManager.tsx). Scoped under .live-admin; reuses the
+   Inset Paper tokens from admin.css. */
+
+.live-admin { display: flex; flex-direction: column; gap: 14px; max-width: 900px; }
+.live-admin .page-head { margin-bottom: 0; }
+.live-admin .sub { max-width: 60ch; }
+.live-admin code, .live-admin .mono { font-family: ui-monospace, 'SF Mono', monospace; font-size: 12.5px; }
+.live-admin .hint { margin: 0; }
+.live-admin a { color: var(--accent-deep); text-underline-offset: 2px; }
+.live-admin fieldset { border: 0; padding: 0; margin: 0; min-width: 0; }
+.live-admin fieldset:disabled { opacity: 0.75; }
+.live-admin input[readonly] { background: var(--panel-2); color: var(--text-2); }
+.live-admin .notice { margin-bottom: 0; font-size: 13px; }
+.live-admin-msgs:empty { display: none; }
+.live-admin-msgs .flash { margin: 0; }
+.live-admin-flash { margin: 10px 0 0 !important; }
+
+.live-admin-lede { margin: 0; color: var(--text-2); font-size: 13.5px; max-width: 64ch; }
+
+.live-admin-card { background: var(--panel); border: 1px solid var(--line); border-radius: var(--r-lg); box-shadow: var(--shadow-card); padding: 16px 18px; }
+.live-admin-card h2 { font-size: 14.5px; margin: 0; letter-spacing: -0.01em; color: var(--text); }
+.live-admin-card h3 { font-size: 13px; margin: 0 0 4px; color: var(--text); }
+.live-admin-card-head { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 12px; }
+
+/* status marker: dot + text, never a filled badge */
+.live-admin-status { display: inline-flex; align-items: center; gap: 7px; font-size: 12.5px; font-weight: 600; color: var(--text-2); }
+.live-admin-status i, .live-admin-dot { flex: 0 0 auto; width: 8px; height: 8px; border-radius: 50%; background: var(--faint); display: inline-block; }
+.live-admin .is-live i, .live-admin-dot.is-live { background: var(--red); box-shadow: 0 0 0 3px var(--red-soft); }
+.live-admin .is-ok i, .live-admin-dot.is-ok { background: var(--green); }
+.live-admin .is-warn i, .live-admin-dot.is-warn { background: var(--amber); }
+.live-admin .is-bad i, .live-admin-dot.is-bad { background: var(--red); }
+.live-admin-status.is-live { color: var(--red); }
+.live-admin-status.is-ok { color: var(--green); }
+.live-admin-status.is-warn { color: var(--amber); }
+.live-admin-status.is-bad { color: var(--red); }
+
+/* right now */
+.live-admin-now p { margin: 0 0 10px; font-size: 14px; color: var(--text); }
+.live-admin-now .live-admin-status { margin-right: 6px; }
+.live-admin-conns { list-style: none; margin: 12px 0 0; padding: 10px 13px; background: var(--panel-2); border-radius: var(--r-md); display: grid; gap: 6px; }
+.live-admin-conns li { display: flex; align-items: center; justify-content: space-between; gap: 12px; font-size: 13px; }
+.live-admin-conns b { font-weight: 600; }
+.live-admin-sched { margin-top: 10px !important; }
+
+/* settings */
+.live-admin-modes { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 8px; margin-bottom: 14px !important; }
+.live-admin-modes legend { font-size: 12px; color: var(--muted); font-weight: 500; padding: 0; margin-bottom: 5px; }
+.live-admin-mode { display: flex; gap: 9px; align-items: flex-start; padding: 10px 12px; border: 1px solid var(--line-strong); border-radius: var(--r-md); cursor: pointer; background: var(--panel); }
+.live-admin-mode:hover { background: var(--hover); }
+.live-admin-mode.on { background: var(--sel); }
+.live-admin-mode:focus-within { border-color: var(--accent); box-shadow: 0 0 0 3px var(--accent-ring); }
+.live-admin-mode input { accent-color: var(--accent); margin: 3px 0 0; flex: 0 0 auto; }
+.live-admin-mode b { display: block; font-size: 13px; }
+.live-admin-mode small { display: block; font-size: 12px; color: var(--muted); margin-top: 1px; line-height: 1.4; }
+.live-admin-fields { margin-bottom: 4px !important; }
+.live-admin-fields > .notice { margin: 0 0 12px !important; }
+/* how it looks */
+.live-admin-look { margin-top: 14px !important; padding-top: 14px !important; border-top: 1px solid var(--line) !important; }
+.live-admin-look legend { font-size: 12px; color: var(--muted); font-weight: 500; padding: 0; float: left; width: 100%; margin-bottom: 6px; }
+.live-admin-styles { clear: both; display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 8px; }
+.live-admin-style > span { min-width: 0; }
+.live-admin-glyph { display: block; position: relative; width: 100%; max-width: 132px; aspect-ratio: 2 / 1; margin: 1px 0 8px; border-radius: 6px; background: var(--panel-2); border: 1px solid var(--line); overflow: hidden; }
+.live-admin-glyph em, .live-admin-glyph s { position: absolute; display: block; border-radius: 3px; }
+.live-admin-glyph em { background: var(--line-strong); }
+.live-admin-glyph s { width: 14px; height: 5px; background: #e0352b; border-radius: 1.5px; }
+.live-admin-glyph.is-poster em { left: 8px; right: 8px; top: 6px; bottom: 16px; }
+.live-admin-glyph.is-poster s { left: 11px; top: 9px; }
+.live-admin-glyph.is-poster::after { content: ''; position: absolute; left: 8px; bottom: 7px; width: 55%; height: 4px; border-radius: 2px; background: var(--line-strong); }
+.live-admin-glyph.is-split em { left: 6px; top: 7px; bottom: 7px; width: 54%; }
+.live-admin-glyph.is-split s { left: 9px; top: 10px; }
+.live-admin-glyph.is-split::after { content: ''; position: absolute; right: 8px; top: 40%; width: 28%; height: 4px; border-radius: 2px; background: var(--line-strong); box-shadow: 0 7px 0 var(--line-strong); }
+.live-admin-glyph.is-row em { left: 6px; top: 35%; height: 30%; width: 28%; }
+.live-admin-glyph.is-row s { left: 8px; top: calc(35% + 2px); width: 9px; height: 4px; }
+.live-admin-glyph.is-row::after { content: ''; position: absolute; left: 40%; top: 46%; width: 44%; height: 4px; border-radius: 2px; background: var(--line-strong); }
+.live-admin-style.on .live-admin-glyph { border-color: var(--accent); }
+.live-admin-look-hint { display: block; margin: 6px 0 10px; }
+.live-admin-look .check-row { margin-top: 6px; }
+.live-admin-sub { margin: 14px 0 2px; font-size: 12px; color: var(--muted); font-weight: 500; }
+
+.live-admin-actions { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; margin-top: 4px; }
+.live-admin-place { margin-top: 14px !important; padding-top: 12px; border-top: 1px solid var(--line); }
+
+/* provider tabs (text tabs on the kit segmented track) */
+.live-admin-tabs { margin-bottom: 14px; }
+.live-admin-tabs > button { font-size: 12.5px; padding: 5px 14px; gap: 7px; }
+.live-admin-tabs > button:focus-visible { outline: 2px solid var(--accent); outline-offset: 1px; }
+
+.live-admin-panel[hidden] { display: none; }
+.live-admin-health { padding: 12px 14px; background: var(--panel-2); border-radius: var(--r-md); margin-bottom: 12px; }
+.live-admin-dl { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 8px 16px; margin: 10px 0 0; }
+.live-admin-dl dt { font-size: 11.5px; color: var(--muted); }
+.live-admin-dl dd { margin: 1px 0 0; font-size: 13px; color: var(--text); overflow-wrap: anywhere; }
+
+.live-admin-guide { border: 1px solid var(--line); border-radius: var(--r-md); margin-bottom: 14px; }
+.live-admin-guide > summary { cursor: pointer; padding: 10px 13px; font-size: 13px; font-weight: 600; color: var(--text); list-style-position: inside; }
+.live-admin-guide > summary:focus-visible { outline: 2px solid var(--accent); outline-offset: -2px; border-radius: var(--r-md); }
+.live-admin-guide[open] > summary { border-bottom: 1px solid var(--line); }
+.live-admin-guide ol { margin: 0; padding: 12px 16px 4px 34px; display: grid; gap: 8px; font-size: 13px; color: var(--text-2); line-height: 1.5; }
+.live-admin-guide > .hint { padding: 6px 13px 12px; line-height: 1.5; }
+.live-admin-copy { display: flex; gap: 6px; align-items: center; margin-top: 6px; }
+.live-admin-copy input { flex: 1; min-width: 0; }
+
+.live-admin-form { margin-bottom: 4px; }
+.live-admin-form > h3 { margin-bottom: 10px; }
+.live-admin-steps-row { display: grid; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); gap: 10px; margin-top: 14px; }
+.live-admin-step { border: 1px solid var(--line); border-radius: var(--r-md); padding: 12px 13px; display: flex; flex-direction: column; align-items: flex-start; gap: 8px; }
+.live-admin-step .field { margin-bottom: 0; width: 100%; }
+.live-admin-step .live-admin-actions { margin-top: 0; }
+
+.live-admin-danger { margin-top: 12px; padding-top: 10px; border-top: 1px solid var(--line); }
+.live-admin .btn.ghost.danger { color: var(--red); }
+.live-admin .btn:disabled { opacity: 0.55; cursor: not-allowed; }
+.live-admin-copied:empty { display: none; }
+.live-admin-copied { margin-top: 10px !important; }
+
+.live-admin-roadmap p { margin: 4px 0 0; font-size: 13px; color: var(--muted); }
+
+@media (max-width: 767px) {
+  .live-admin-card { padding: 14px; }
+  .live-admin-modes, .live-admin-styles { grid-template-columns: 1fr; }
+  .live-admin-glyph { display: none; }
+  .live-admin-tabs { display: flex; }
+  .live-admin-tabs > button { flex: 1; min-height: 36px; }
+  .live-admin-actions .btn { flex: 1; justify-content: center; }
+  .live-admin-conns li { flex-wrap: wrap; }
+}

package/src/styles/live.css

@@ -0,0 +1,199 @@
+/* Live video: the card (all layouts) and the site-wide signals.
+ *
+ * Theme API — override any of these on :root (or a wrapper) in theme.css:
+ *   --live-color        tag, markers, avatar ring (theme token `live`)
+ *   --live-ink          text on --live-color
+ *   --live-radius       poster + card corners
+ *   --live-tag-radius   the LIVE tag (keep it a rectangle, never a pill)
+ *   --live-poster-ratio poster shape
+ *   --live-pulse        marker blink duration (0s = still)
+ * Hooks: .pc-live[data-layout=poster|split|row|links][data-status=live|upcoming|offline],
+ *        html[data-live=live|upcoming] while a broadcast is on.
+ */
+/* Wrapped in @layer base so theme CSS (inlined unlayered by Site.astro)
+   always wins ties, regardless of bundle order in the built head. */
+@layer base {
+:root {
+  --live-color: var(--live, #d42f25);
+  --live-ink: var(--live-on, #fff);
+  --live-radius: var(--r, 16px);
+  --live-tag-radius: 5px;
+  --live-poster-ratio: 16 / 9;
+  --live-pulse: 1.6s;
+}
+
+@keyframes pc-live-pulse { 50% { opacity: 0.35; } }
+
+.pc-live { margin: 28px 0; color: var(--ink); container-type: inline-size; text-align: left; }
+.pc-live[hidden], .pc-live [hidden], .pc-live-dock[hidden], .pc-live-bar[hidden], .site-live[hidden] { display: none !important; }
+.pc-live :focus-visible, .pc-live-dock :focus-visible, .pc-live-bar :focus-visible, .site-live:focus-visible { outline: 2px solid var(--accent); outline-offset: 3px; }
+
+/* ---- offline: one slim row instead of an empty card ---- */
+.pc-live-off {
+  display: none; align-items: center; gap: 10px; padding: 12px 16px;
+  border: 1px solid var(--line); border-radius: var(--live-radius); background: var(--panel); font-size: 0.92em;
+}
+.pc-live[data-status='offline'] .pc-live-off { display: flex; }
+.pc-live[data-status='offline'] .pc-live-body { display: none; }
+.pc-live-off-dot { width: 7px; height: 7px; border-radius: 2px; background: var(--muted); opacity: 0.6; flex: none; }
+.pc-live-off span { flex: 1; color: var(--muted); }
+.pc-live-off a { font-weight: 600; color: var(--ink); text-decoration: none; white-space: nowrap; }
+.pc-live-off a:hover { text-decoration: underline; text-underline-offset: 3px; }
+
+/* ---- card body ---- */
+.pc-live-body {
+  background: var(--panel); border: 1px solid var(--line);
+  border-radius: calc(var(--live-radius) + 4px); padding: 10px; box-shadow: var(--sh-1);
+}
+.pc-live-media { position: relative; min-width: 0; }
+.pc-live-poster {
+  position: relative; display: block; aspect-ratio: var(--live-poster-ratio); overflow: hidden;
+  border-radius: var(--live-radius); color: var(--muted);
+  background: color-mix(in srgb, var(--live-color) 7%, var(--soft));
+}
+.pc-live[data-status='upcoming'] .pc-live-poster { background: color-mix(in srgb, var(--accent) 8%, var(--soft)); }
+.pc-live-poster img { position: absolute; inset: 0; width: 100%; height: 100%; object-fit: cover; }
+.pc-live-ph { position: absolute; inset: 0; display: grid; place-items: center; }
+.pc-live-ph svg { width: 22%; max-width: 64px; opacity: 0.5; }
+
+.pc-live-tag {
+  position: absolute; top: 10px; left: 10px; display: inline-flex; align-items: center; gap: 6px;
+  padding: 6px 8px; border-radius: var(--live-tag-radius);
+  background: var(--live-color); color: var(--live-ink);
+  font: 700 11px/1 var(--font-body); letter-spacing: 0.08em;
+}
+.pc-live-tag::before { content: ''; width: 6px; height: 6px; border-radius: 1.5px; background: currentColor; animation: pc-live-pulse var(--live-pulse) ease-in-out infinite; }
+.pc-live[data-status='upcoming'] .pc-live-tag { background: rgb(12 13 16 / 80%); color: #fff; letter-spacing: 0; font-weight: 600; }
+.pc-live[data-status='upcoming'] .pc-live-tag::before { display: none; }
+.pc-live-viewers {
+  position: absolute; left: 10px; bottom: 10px; padding: 5px 7px; border-radius: var(--live-tag-radius);
+  background: rgb(12 13 16 / 72%); color: #fff; font: 500 11.5px/1 var(--font-body);
+}
+.pc-live-play { position: absolute; inset: 0; }
+.pc-live-play::before {
+  content: ''; position: absolute; left: 50%; top: 50%; width: 58px; height: 58px; margin: -29px 0 0 -29px;
+  border-radius: 16px; background: rgb(255 255 255 / 92%); box-shadow: 0 10px 28px -10px rgb(0 0 0 / 55%);
+  transition: transform 0.15s ease;
+}
+.pc-live-play::after {
+  content: ''; position: absolute; left: 50%; top: 50%; margin: -10px 0 0 -5px;
+  border-left: 16px solid #17181c; border-top: 10px solid transparent; border-bottom: 10px solid transparent;
+}
+.pc-live-poster:hover .pc-live-play::before { transform: scale(1.06); }
+.pc-live-player iframe { display: block; width: 100%; aspect-ratio: 16 / 9; border: 0; border-radius: var(--live-radius); background: #000; }
+
+/* ---- text ---- */
+.pc-live-info { display: flex; flex-direction: column; align-items: flex-start; gap: 4px; padding: 12px 6px 6px; min-width: 0; }
+.pc-live-kicker, .pc-live-mark {
+  display: inline-flex; align-items: center; gap: 7px;
+  font: 700 11px/1.2 var(--font-body); letter-spacing: 0.08em; text-transform: uppercase; color: var(--live-color);
+}
+.pc-live-kicker::before, .pc-live-mark::before { content: ''; width: 7px; height: 7px; border-radius: 2px; background: currentColor; animation: pc-live-pulse var(--live-pulse) ease-in-out infinite; flex: none; }
+.pc-live[data-status='upcoming'] .pc-live-kicker { color: var(--accent-text, var(--accent)); }
+.pc-live[data-status='upcoming'] .pc-live-kicker::before { animation: none; }
+.pc-live-kicker { display: none; }
+/* typography sits on the inner span: section/prose h2 rules (unlayered) can't reach it */
+.pc-live-title-text { display: block; font: 600 1.08rem/1.3 var(--font-heading); letter-spacing: -0.01em; overflow-wrap: anywhere; }
+.pc-live-meta { margin: 0; color: var(--muted); font-size: 0.86em; }
+.pc-live-actions { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 10px; }
+.pc-live-btn {
+  display: inline-flex; align-items: center; gap: 6px; padding: 9px 14px; cursor: pointer;
+  border: 1px solid transparent; border-radius: var(--r-sm, 10px);
+  background: var(--btn, var(--ink)); color: var(--btn-ink, var(--bg));
+  font: 600 0.88em/1.2 var(--font-body); text-decoration: none; white-space: nowrap;
+}
+.pc-live-btn:hover { filter: brightness(1.08); }
+.pc-live[data-playable='true'] a.pc-live-btn { background: transparent; color: var(--ink); border-color: var(--line); }
+.pc-live-privacy { color: var(--muted); font-size: 0.78em; margin-top: 6px; }
+
+/* ---- split: a hero (the "player" section style, or the owner's card style) ---- */
+.pc-live[data-layout='split'] .pc-live-body {
+  display: grid; grid-template-columns: minmax(0, 1.35fr) minmax(0, 1fr); gap: 24px; align-items: center; padding: 12px;
+  border-radius: calc(var(--live-radius) + 6px);
+}
+.pc-live[data-layout='split'] .pc-live-info { padding: 4px 8px 4px 0; }
+.pc-live[data-layout='split'] .pc-live-kicker { display: inline-flex; }
+.pc-live[data-layout='split'] .pc-live-title-text { margin: 8px 0 4px; }
+.pc-live[data-layout='split'] .pc-live-title-text {
+  font-size: clamp(1.3rem, 3.4cqi, 1.9rem); line-height: 1.12;
+  font-weight: var(--display-weight, 650); letter-spacing: var(--display-tracking, -0.03em);
+}
+@container (max-width: 700px) {
+  .pc-live[data-layout='split'] .pc-live-body { grid-template-columns: 1fr; gap: 4px; padding: 10px; }
+  .pc-live[data-layout='split'] .pc-live-info { padding: 10px 6px 6px; }
+}
+
+/* ---- row: compact, for sidebars and busy pages ---- */
+.pc-live[data-layout='row'] .pc-live-body { display: grid; grid-template-columns: 168px minmax(0, 1fr); gap: 16px; align-items: center; padding: 8px; }
+.pc-live[data-layout='row'] .pc-live-poster { border-radius: calc(var(--live-radius) * 0.7); }
+.pc-live[data-layout='row'] .pc-live-tag { top: 6px; left: 6px; padding: 4px 6px; font-size: 10px; }
+.pc-live[data-layout='row'] .pc-live-viewers, .pc-live[data-layout='row'] .pc-live-ph svg { display: none; }
+.pc-live[data-layout='row'] .pc-live-info { padding: 2px 8px 2px 0; }
+.pc-live[data-layout='row'] .pc-live-actions { margin-top: 6px; }
+@container (max-width: 420px) {
+  .pc-live[data-layout='row'] .pc-live-body { grid-template-columns: 112px minmax(0, 1fr); gap: 12px; }
+  .pc-live[data-layout='row'] .pc-live-tag { font-size: 0; gap: 0; padding: 5px; }
+}
+
+/* ---- links page block ---- */
+.pc-live[data-layout='links'] { margin: 12px 0; }
+.pc-live[data-layout='links'] .pc-live-body { padding: 8px; }
+.pc-live[data-layout='links'] .pc-live-info { flex-direction: row; align-items: center; gap: 12px; padding: 10px 4px 2px; }
+.pc-live[data-layout='links'] .pc-live-title { flex: 1; }
+.pc-live[data-layout='links'] .pc-live-title-text { font-size: 0.95rem; }
+.pc-live[data-layout='links'] .pc-live-meta { display: none; }
+.pc-live[data-layout='links'] .pc-live-actions { margin: 0; }
+.pc-live[data-layout='links'] .pc-live-btn { padding: 7px 11px; font-size: 0.82em; }
+html[data-live='live'] .links-avatar { box-shadow: 0 0 0 3px var(--bg), 0 0 0 5px var(--live-color); }
+
+/* ---- site-wide: live bar (takes the announcement slot while live) ---- */
+.pc-live-bar {
+  display: flex; align-items: center; justify-content: center; gap: 12px; position: relative;
+  padding: 9px 44px; background: var(--ink); color: var(--bg); font-size: 14px;
+}
+.pc-live-bar .pc-live-mark { color: color-mix(in srgb, var(--live-color) 70%, var(--bg)); }
+.pc-live-bar-title { opacity: 0.82; min-width: 0; max-width: 46ch; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.pc-live-bar a { color: inherit; font-weight: 600; text-decoration: underline; text-underline-offset: 3px; white-space: nowrap; }
+.pc-live-x {
+  position: absolute; right: 10px; top: 50%; transform: translateY(-50%);
+  background: none; border: 0; color: inherit; opacity: 0.7; cursor: pointer; font-size: 12px; padding: 6px; border-radius: 6px;
+}
+.pc-live-x:hover { opacity: 1; background: color-mix(in srgb, currentColor 12%, transparent); }
+html[data-live-bar] .announcement-bar { display: none; }
+@media (max-width: 560px) { .pc-live-bar-title { display: none; } }
+
+/* ---- site-wide: header marker ---- */
+.site-live {
+  display: inline-flex; align-items: center; gap: 7px; padding: 7px 10px; white-space: nowrap;
+  border: 1px solid var(--line); border-radius: var(--r-sm, 10px);
+  color: var(--ink); font: 600 13px/1 var(--font-body); text-decoration: none;
+}
+.site-live::before { content: ''; width: 7px; height: 7px; border-radius: 2px; background: var(--live-color); animation: pc-live-pulse var(--live-pulse) ease-in-out infinite; }
+.site-live:hover { background: var(--soft); }
+
+/* ---- site-wide: floating dock ---- */
+.pc-live-dock {
+  position: fixed; right: 16px; bottom: max(16px, env(safe-area-inset-bottom)); z-index: 60;
+  width: min(300px, calc(100vw - 32px)); padding: 8px 30px 8px 8px;
+  background: var(--panel); color: var(--ink); border: 1px solid var(--line); border-radius: var(--r, 14px);
+  box-shadow: var(--sh-3); animation: pc-live-in 0.25s ease-out;
+}
+.pc-live-dock > a { display: grid; grid-template-columns: 104px minmax(0, 1fr); gap: 10px; align-items: center; color: inherit; text-decoration: none; }
+.pc-live-dock-thumb {
+  position: relative; aspect-ratio: 16 / 9; border-radius: calc(var(--live-radius) * 0.6); overflow: hidden;
+  background: color-mix(in srgb, var(--live-color) 10%, var(--soft));
+}
+.pc-live-dock-thumb img { position: absolute; inset: 0; width: 100%; height: 100%; object-fit: cover; }
+.pc-live-dock b { display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; margin-top: 4px; font-size: 13px; line-height: 1.3; font-weight: 600; }
+.pc-live-dock .pc-live-x { top: 6px; right: 4px; transform: none; color: var(--muted); }
+@keyframes pc-live-in { from { opacity: 0; transform: translateY(8px); } }
+
+@media (prefers-reduced-motion: reduce) {
+  .pc-live-tag::before, .pc-live-kicker::before, .pc-live-mark::before, .site-live::before { animation: none; }
+  .pc-live-dock { animation: none; }
+}
+}
+
+/* Unlayered on purpose: prose and section rules (`.acms-section h2`, `article h2`)
+   are unlayered too, and would otherwise restyle the card's heading. */
+.pc-live h2.pc-live-title { margin: 0; padding: 0; border: 0; font-size: 1rem; line-height: 1; }

package/src/theme-sdk/contract.mjs

@@ -18,6 +18,7 @@ const f = (label, type = 'text', value = '') => ({ label, type, default: value }
 const base = { heading: f('Heading'), text: f('Supporting text', 'textarea') };
 /** @type {Record<string, import("zod").infer<typeof SectionDefinition>>} */
 export const BUILTIN_SECTIONS = {
+  live: { name: 'Live video', version: 1, variants: ['card','player'], fields: {} },
   'page-content': { name: 'Existing page content', version: 1, variants: ['default'], fields: {} },
   hero: { name: 'Hero', version: 1, variants: ['split', 'centered'], fields: { ...base, image: f('Image', 'image'), alt: f('Image description'), label: f('Button label'), href: f('Button link', 'url') } },
   features: { name: 'Features', version: 1, variants: ['grid', 'list'], fields: { ...base, items: f('Features (one per line: title | description)', 'textarea') } },

package/src/theme-sdk/tokens.mjs

@@ -10,6 +10,7 @@ export const DarkTokens = z.object({
   accent: hex.optional(),
   panel: hex.optional(),
   soft: hex.optional(),
+  live: hex.optional(),
 });
 
 export const ThemeTokens = z.object({
@@ -23,6 +24,8 @@ export const ThemeTokens = z.object({
   soft: hex.default('#efede8'),
   // text on an accent fill; '' = pick white or near-black by contrast
   accentInk: hex.default(''),
+  // the live-video signal color (LIVE tag, markers); '' = a tuned red
+  live: hex.default(''),
   // primary buttons: ink-filled (default) or accent-filled
   button: z.enum(['ink', 'accent']).default('ink'),
   // dark scheme

package/src/themes/editorial/theme.css

@@ -91,3 +91,8 @@ article h1 { font-size: 42px; line-height: 1.12; }
 
 /* overlay hero: keep the serif display sizing on the image variant too */
 .post-hero-content h1 { font-size: clamp(34px, 6vw, 52px); font-weight: 500; }
+
+/* live video: square-cut tag and spaced caps to match the masthead */
+:root { --live-tag-radius: 2px; }
+.pc-live-tag, .pc-live-kicker, .pc-live-mark { letter-spacing: 0.14em; }
+.pc-live[data-layout='split'] .pc-live-title-text { font-weight: 500; }

package/src/themes/editorial/theme.json

@@ -6,6 +6,7 @@
     "ink": "#181712",
     "muted": "#6d685e",
     "line": "#e4e0d5",
+    "live": "#b8261b",
     "accent": "#b33a2e",
     "panel": "#fdfcf9",
     "soft": "#edeae1",
@@ -18,6 +19,7 @@
       "ink": "#ece6da",
       "muted": "#a39c8e",
       "line": "#2d2a24",
+      "live": "#f26b57",
       "accent": "#e0735f",
       "panel": "#1d1b16",
       "soft": "#25221c"

package/src/themes/field/theme.json

@@ -6,6 +6,7 @@
     "ink": "#1f261e",
     "muted": "#5f6a58",
     "line": "#dde3d6",
+    "live": "#c2412d",
     "accent": "#3d6b45",
     "panel": "#fbfdf9",
     "soft": "#e6ebdf",

package/src/themes/night/theme.json

@@ -18,6 +18,7 @@
       "ink": "#ebe9e3",
       "muted": "#9b9ba4",
       "line": "#2a2b32",
+      "live": "#ff6a55",
       "accent": "#e8a849",
       "panel": "#1a1b21",
       "soft": "#23242b"