@invisibleloop/pulse 0.12.3 → 0.14.1

package/examples/bookworms.css

@@ -0,0 +1,422 @@
+/*
+ * bookworms.css — BookWorms independent bookshop example
+ *
+ * Palette: warm off-white, deep ink, oxblood accent.
+ * Font:    Fraunces (display headings, loaded via Google Fonts in meta.styles)
+ *
+ * Split into two logical sections:
+ *   1. Token overrides — hex values, palette definitions ([data-theme="light"])
+ *   2. Component styles — layout, typography, custom elements (var() only)
+ */
+
+/* ==========================================================================
+   1. Token overrides (hex values live here)
+   ========================================================================== */
+
+/*
+ * Override --font and --font-display so --ui-font / --ui-font-display
+ * cascade to Fraunces throughout components and custom elements.
+ */
+:root {
+  --font:         'Fraunces', Georgia, 'Times New Roman', serif;
+  --font-display: 'Fraunces', Georgia, 'Times New Roman', serif;
+}
+
+[data-theme="light"] {
+  --ui-bg:           #f6f2ec;
+  --ui-surface:      #ffffff;
+  --ui-surface-2:    #efe9df;
+  --ui-border:       #d8cfc1;
+  --ui-text:         #1a1a1a;
+  --ui-muted:        #5a5043;
+  --ui-accent:       #6b2a2a;
+  --ui-accent-hover: #4f1d1d;
+  --ui-accent-dim:   #f0e3e3;
+  --ui-accent-text:  #ffffff;
+
+  /* BookWorms-specific token */
+  --bw-bg-alt:       #efe9df;
+}
+
+/* ==========================================================================
+   2. Component styles (var() only — no hex values below this line)
+   ========================================================================== */
+
+body { line-height: 1.6; }
+
+/* --------------------------------------------------------------------------
+   Shell (centred max-width wrapper)
+   -------------------------------------------------------------------------- */
+.bw-shell {
+  max-width: 1180px;
+  margin: 0 auto;
+  padding: 0 var(--ui-space-6);
+}
+
+/* --------------------------------------------------------------------------
+   Hero
+   -------------------------------------------------------------------------- */
+.bw-hero {
+  padding: var(--ui-space-20) 0 var(--ui-space-16);
+  border-bottom: 1px solid var(--ui-border);
+  overflow: hidden;
+}
+
+.bw-hero__inner {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: var(--ui-space-12);
+  align-items: center;
+}
+
+.bw-hero__content {
+  min-width: 0;
+}
+
+.bw-hero__image {
+  position: relative;
+  border-radius: var(--ui-radius-lg);
+  overflow: hidden;
+  aspect-ratio: 3 / 4;
+}
+
+.bw-hero__image img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  display: block;
+}
+
+@media (max-width: 700px) {
+  .bw-hero__inner {
+    grid-template-columns: 1fr;
+  }
+  .bw-hero__image {
+    aspect-ratio: 4 / 3;
+    order: -1;
+  }
+}
+
+.bw-eyebrow {
+  font-size: var(--ui-text-xs);
+  letter-spacing: 0.18em;
+  text-transform: uppercase;
+  color: var(--ui-muted);
+  margin-bottom: var(--ui-space-6);
+}
+
+.bw-hero-title {
+  font-family: var(--ui-font-display);
+  font-size: clamp(2.5rem, 7vw, 5.5rem);
+  font-weight: 500;
+  line-height: 1.02;
+  letter-spacing: -0.025em;
+  color: var(--ui-text);
+  margin-bottom: var(--ui-space-8);
+  max-width: 18ch;
+}
+
+.bw-hero-lede {
+  font-size: var(--ui-text-xl);
+  line-height: 1.55;
+  color: var(--ui-muted);
+  max-width: 60ch;
+  margin-bottom: var(--ui-space-8);
+}
+
+/* --------------------------------------------------------------------------
+   Section template
+   -------------------------------------------------------------------------- */
+.bw-section {
+  padding: var(--ui-space-16) 0;
+  border-bottom: 1px solid var(--ui-border);
+}
+
+.bw-section-label {
+  font-size: var(--ui-text-xs);
+  letter-spacing: 0.18em;
+  text-transform: uppercase;
+  color: var(--ui-muted);
+  margin-bottom: var(--ui-space-8);
+}
+
+.bw-section-title {
+  font-family: var(--ui-font-display);
+  font-size: clamp(1.75rem, 3.2vw, 2.5rem);
+  font-weight: 500;
+  line-height: 1.1;
+  letter-spacing: -0.02em;
+  color: var(--ui-text);
+  margin-bottom: var(--ui-space-10);
+  max-width: 24ch;
+}
+
+/* --------------------------------------------------------------------------
+   Staff picks grid
+   -------------------------------------------------------------------------- */
+.bw-picks {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: var(--ui-space-10);
+}
+
+@media (max-width: 800px) {
+  .bw-picks {
+    grid-template-columns: 1fr;
+    gap: var(--ui-space-8);
+  }
+}
+
+.bw-pick-cover-wrap {
+  position: relative;
+  overflow: hidden;
+  margin-bottom: var(--ui-space-6);
+  box-shadow: 0 2px 12px rgb(0 0 0 / 0.08);
+}
+
+.bw-pick-cover {
+  display: block;
+  width: 100%;
+  height: auto;
+  aspect-ratio: 2 / 3;
+  object-fit: cover;
+  background: var(--bw-bg-alt);
+}
+
+.bw-pick-overlay {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  flex-direction: column;
+  justify-content: flex-end;
+  padding: var(--ui-space-6);
+  background: linear-gradient(to top, rgba(0,0,0,0.72) 0%, rgba(0,0,0,0.2) 50%, transparent 100%);
+}
+
+/* First book only — text at top */
+.bw-picks article:first-child .bw-pick-overlay {
+  justify-content: flex-start;
+  background: linear-gradient(to bottom, rgba(0,0,0,0.72) 0%, rgba(0,0,0,0.2) 50%, transparent 100%);
+}
+
+.bw-picks article:first-child .bw-pick-overlay-title {
+  font-family: Arial, sans-serif;
+  font-weight: 700;
+  text-transform: uppercase;
+}
+
+/* Second book — solid semi-transparent block behind text */
+.bw-picks article:nth-child(2) .bw-pick-overlay {
+  inset: auto 0 0 0;
+  background: rgba(0, 0, 0, 0.55);
+  padding: var(--ui-space-5) var(--ui-space-6);
+}
+
+/* Third book — Arial, no italic on author */
+.bw-picks article:nth-child(3) .bw-pick-overlay-title {
+  font-family: Arial, sans-serif;
+  font-size: 3.75rem;
+}
+
+.bw-picks article:nth-child(3) .bw-pick-overlay-author {
+  font-family: Arial, sans-serif;
+  font-style: normal;
+}
+
+.bw-pick-overlay-tag {
+  font-size: var(--ui-text-xs);
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: rgba(255,255,255,0.7);
+  margin-bottom: var(--ui-space-2);
+}
+
+.bw-pick-overlay-title {
+  font-family: var(--ui-font);
+  font-size: var(--ui-text-2xl);
+  font-weight: 600;
+  line-height: 1.15;
+  color: #fff;
+  margin-bottom: var(--ui-space-1);
+}
+
+.bw-pick-overlay-author {
+  font-style: italic;
+  font-family: var(--ui-font);
+  font-size: var(--ui-text-sm);
+  color: rgba(255,255,255,0.7);
+}
+
+.bw-pick-meta {
+  font-size: var(--ui-text-xs);
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: var(--ui-accent);
+  margin-bottom: var(--ui-space-3);
+}
+
+.bw-pick-title {
+  font-family: var(--ui-font-display);
+  font-size: var(--ui-text-2xl);
+  font-weight: 500;
+  line-height: 1.2;
+  margin-bottom: var(--ui-space-2);
+  color: var(--ui-text);
+}
+
+.bw-pick-author {
+  font-style: italic;
+  color: var(--ui-muted);
+  margin-bottom: var(--ui-space-4);
+}
+
+.bw-pick-note {
+  font-size: var(--ui-text-base);
+  line-height: 1.6;
+  color: var(--ui-text);
+}
+
+/* --------------------------------------------------------------------------
+   Pull-quote
+   -------------------------------------------------------------------------- */
+.bw-pull {
+  padding: var(--ui-space-20) 0;
+  text-align: center;
+  border-bottom: 1px solid var(--ui-border);
+}
+
+.bw-pull-quote {
+  font-family: var(--ui-font-display);
+  font-size: clamp(1.75rem, 4vw, 2.75rem);
+  font-weight: 400;
+  font-style: italic;
+  line-height: 1.25;
+  letter-spacing: -0.015em;
+  color: var(--ui-text);
+  max-width: 32ch;
+  margin: 0 auto var(--ui-space-6);
+}
+
+.bw-pull-cite {
+  font-size: var(--ui-text-sm);
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: var(--ui-muted);
+}
+
+/* --------------------------------------------------------------------------
+   Feature grid (what we do)
+   -------------------------------------------------------------------------- */
+.bw-features {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: var(--ui-space-12) var(--ui-space-16);
+}
+
+@media (max-width: 800px) {
+  .bw-features {
+    grid-template-columns: 1fr;
+    gap: var(--ui-space-10);
+  }
+}
+
+.bw-feature-title {
+  font-family: var(--ui-font-display);
+  font-size: var(--ui-text-xl);
+  font-weight: 500;
+  margin-bottom: var(--ui-space-2);
+  color: var(--ui-text);
+}
+
+.bw-feature-body {
+  color: var(--ui-muted);
+  line-height: 1.6;
+}
+
+/* --------------------------------------------------------------------------
+   Events list
+   -------------------------------------------------------------------------- */
+.bw-events {
+  display: flex;
+  flex-direction: column;
+}
+
+.bw-event {
+  display: grid;
+  grid-template-columns: 140px 1fr auto;
+  align-items: baseline;
+  gap: var(--ui-space-8);
+  padding: var(--ui-space-6) 0;
+  border-top: 1px solid var(--ui-border);
+}
+
+.bw-event:last-child {
+  border-bottom: 1px solid var(--ui-border);
+}
+
+@media (max-width: 700px) {
+  .bw-event {
+    grid-template-columns: 1fr;
+    gap: var(--ui-space-2);
+  }
+}
+
+.bw-event-date {
+  font-family: var(--ui-font-display);
+  font-size: var(--ui-text-lg);
+  color: var(--ui-accent);
+  letter-spacing: 0.02em;
+}
+
+.bw-event-title {
+  font-family: var(--ui-font-display);
+  font-size: var(--ui-text-xl);
+  font-weight: 500;
+  color: var(--ui-text);
+}
+
+.bw-event-host {
+  color: var(--ui-muted);
+  font-style: italic;
+}
+
+/* --------------------------------------------------------------------------
+   CTA section
+   -------------------------------------------------------------------------- */
+.bw-cta {
+  padding: var(--ui-space-24) 0;
+  text-align: center;
+}
+
+.bw-cta-title {
+  font-family: var(--ui-font-display);
+  font-size: clamp(2rem, 5vw, 3.5rem);
+  font-weight: 500;
+  line-height: 1.05;
+  letter-spacing: -0.02em;
+  margin-bottom: var(--ui-space-6);
+  color: var(--ui-text);
+  max-width: 20ch;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.bw-cta-sub {
+  color: var(--ui-muted);
+  font-size: var(--ui-text-lg);
+  margin-bottom: var(--ui-space-8);
+  max-width: 50ch;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.bw-cta-actions {
+  display: flex;
+  gap: var(--ui-space-4);
+  justify-content: center;
+  flex-wrap: wrap;
+}
+
+.bw-cta-actions--start {
+  justify-content: flex-start;
+}

package/examples/bookworms.js

@@ -0,0 +1,225 @@
+/**
+ * Pulse — BookWorms example
+ *
+ * Demonstrates:
+ *   - Light-theme editorial branding for a physical/independent business
+ *   - nav() with logo text, anchor links, and a CTA action button
+ *   - Pure HTML sections — no Pulse section/container wrappers (shows the
+ *     framework is just strings; you can write vanilla HTML where it fits)
+ *   - Book card grid (staff picks) with cover images from picsum.photos
+ *   - Pull-quote / press quote breakout
+ *   - Two-column feature grid
+ *   - Bordered event list with date / title / host columns
+ *   - Centred CTA section
+ *   - footer() with flat link list
+ *   - Google Fonts (Fraunces) for display headings
+ *
+ * Run: node examples/dev.server.js  →  http://localhost:3001/bookworms
+ */
+
+import { nav, button, footer } from '../src/ui/index.js'
+
+// ---------------------------------------------------------------------------
+// Static data
+// ---------------------------------------------------------------------------
+
+const picks = [
+  {
+    tag:    'Fiction · Staff pick',
+    title:  'The Lantern Keepers',
+    author: 'Iris Aldenmoor',
+    note:   'A quiet novel about three sisters, an unreliable lighthouse, and the long winter that follows a single decision.',
+    cover:  '/images/bookworms/lantern-keepers.jpg',
+  },
+  {
+    tag:    'Non-fiction · This week',
+    title:  'How We Read Now',
+    author: 'Dr. Samuel Okafor',
+    note:   'A short, generous history of attention — from monastic libraries to the open browser tab.',
+    cover:  '/images/bookworms/how-we-read-now.jpg',
+  },
+  {
+    tag:    'Rare find · Just arrived',
+    title:  'Letters from a Provincial Bookseller',
+    author: 'M. Halloran (1927)',
+    note:   'First edition, lightly foxed. A wry account of running a shop through a quiet decade.',
+    cover:  '/images/bookworms/provincial-bookseller.jpg',
+  },
+]
+
+const features = [
+  {
+    title: 'Curated, not algorithmic',
+    body:  'Every recommendation comes from one of our booksellers. No bestseller lists, no engagement metrics — just books we\'ve read and would lend you ourselves.',
+  },
+  {
+    title: 'Browse by mood',
+    body:  'Looking for something restorative? Something difficult? Our shelves are arranged the way readers actually think.',
+  },
+  {
+    title: 'Author evenings & book clubs',
+    body:  'Small, considered events with writers we admire. Wine, conversation, and signed copies — no panels of four.',
+  },
+  {
+    title: 'Free delivery over £25',
+    body:  'Wrapped by hand, delivered locally by bicycle. Posted further afield by the next morning.',
+  },
+  {
+    title: 'Gift cards & reader subscriptions',
+    body:  'A monthly book chosen for one specific reader, with a note from the bookseller who picked it.',
+  },
+  {
+    title: 'Open seven days',
+    body:  'Old Market Lane, opposite the bakery. Coffee from nine, books from ten.',
+  },
+]
+
+const events = [
+  { date: '12 June',  title: 'An evening with Iris Aldenmoor', host: 'In conversation with Priya Joshi' },
+  { date: '21 June',  title: 'Slow Reading Club — Middlemarch, part one', host: 'Hosted by the BookWorms team' },
+  { date: '03 July',  title: 'New voices in non-fiction', host: 'Three debut authors read and answer questions' },
+]
+
+const navLinks = [
+  { label: 'Browse',      href: '#browse' },
+  { label: 'Staff picks', href: '#picks'  },
+  { label: 'Events',      href: '#events' },
+  { label: 'Visit',       href: '#visit'  },
+]
+
+// ---------------------------------------------------------------------------
+// Spec
+// ---------------------------------------------------------------------------
+
+export default {
+  route: '/bookworms',
+
+  meta: {
+    title:       'BookWorms — an independent bookstore for curious readers',
+    description: 'Handpicked fiction, non-fiction, and rare finds. Weekly staff picks, author evenings, and a slow reading club. Open seven days on Old Market Lane.',
+    theme:       'light',
+    styles:      [
+      'https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,400;0,9..144,500;1,9..144,400&display=swap',
+      '/pulse-ui.css',
+      '/examples/bookworms.css',
+    ],
+  },
+
+  view: () => `
+    ${nav({
+      logo:   'BookWorms',
+      links:  navLinks,
+      action: button({ label: 'Visit the shop', href: '#visit', variant: 'primary', size: 'sm' }),
+      sticky: true,
+    })}
+
+    <main id="main-content">
+      <section class="bw-hero">
+        <div class="bw-shell bw-hero__inner">
+          <div class="bw-hero__content">
+            <p class="bw-eyebrow">Independent bookstore · Old Market Lane</p>
+            <h1 class="bw-hero-title">Books, handpicked for the curious.</h1>
+            <p class="bw-hero-lede">
+              BookWorms is a small shop with a long memory. Every title on our shelves has been read by
+              someone who works here — and is waiting for the right reader to find it.
+            </p>
+            <div class="bw-cta-actions bw-cta-actions--start">
+              ${button({ label: 'See this week\u2019s picks', href: '#picks', variant: 'primary' })}
+              ${button({ label: 'Upcoming events',            href: '#events', variant: 'secondary' })}
+            </div>
+          </div>
+          <div class="bw-hero__image" aria-hidden="true">
+            <img src="/images/bookworms/hero-books.jpg" alt="" width="820" height="1080" />
+          </div>
+        </div>
+      </section>
+
+      <section class="bw-section" id="picks">
+        <div class="bw-shell">
+          <p class="bw-section-label">This week</p>
+          <h2 class="bw-section-title">Three books we\u2019re pressing into people\u2019s hands.</h2>
+          <div class="bw-picks">
+            ${picks.map((p, i) => `
+              <article>
+                <div class="bw-pick-cover-wrap">
+                  <img class="bw-pick-cover" src="${p.cover}" alt="Cover of ${p.title} by ${p.author}" width="400" height="600" loading="lazy" />
+                  <div class="bw-pick-overlay">
+                    <h3 class="bw-pick-overlay-title">${p.title}</h3>
+                    <p class="bw-pick-overlay-author">${i === 2 ? p.author.replace(/\s*\(\d{4}\)/, '') : 'by ' + p.author}</p>
+                  </div>
+                </div>
+                <p class="bw-pick-meta">${p.tag}</p>
+                <h3 class="bw-pick-title">${p.title}</h3>
+                <p class="bw-pick-author">by ${p.author}</p>
+                <p class="bw-pick-note">${p.note}</p>
+              </article>
+            `).join('')}
+          </div>
+        </div>
+      </section>
+
+      <section class="bw-pull">
+        <div class="bw-shell">
+          <p class="bw-pull-quote">\u201cThe kind of shop where you walk in for one book and leave with three you didn\u2019t know you needed.\u201d</p>
+          <p class="bw-pull-cite">\u2014 The Quarterly Review</p>
+        </div>
+      </section>
+
+      <section class="bw-section" id="browse">
+        <div class="bw-shell">
+          <p class="bw-section-label">What we do</p>
+          <h2 class="bw-section-title">A bookstore that still reads.</h2>
+          <div class="bw-features">
+            ${features.map(f => `
+              <div>
+                <h3 class="bw-feature-title">${f.title}</h3>
+                <p class="bw-feature-body">${f.body}</p>
+              </div>
+            `).join('')}
+          </div>
+        </div>
+      </section>
+
+      <section class="bw-section" id="events">
+        <div class="bw-shell">
+          <p class="bw-section-label">Upcoming</p>
+          <h2 class="bw-section-title">Evenings worth turning up for.</h2>
+          <div class="bw-events">
+            ${events.map(e => `
+              <article class="bw-event">
+                <p class="bw-event-date">${e.date}</p>
+                <h3 class="bw-event-title">${e.title}</h3>
+                <p class="bw-event-host">${e.host}</p>
+              </article>
+            `).join('')}
+          </div>
+        </div>
+      </section>
+
+      <section class="bw-cta" id="visit">
+        <div class="bw-shell">
+          <h2 class="bw-cta-title">Come and browse.</h2>
+          <p class="bw-cta-sub">
+            14 Old Market Lane, opposite the bakery. Open Monday to Sunday, 10am\u20137pm.
+            Or sign up to receive one handpicked book each month.
+          </p>
+          <div class="bw-cta-actions">
+            ${button({ label: 'Plan a visit',          href: '#visit', variant: 'primary'   })}
+            ${button({ label: 'Reader subscription',   href: '#visit', variant: 'secondary' })}
+          </div>
+        </div>
+      </section>
+    </main>
+
+    ${footer({
+      logo:  'BookWorms',
+      links: [
+        { label: 'Browse',  href: '#browse' },
+        { label: 'Events',  href: '#events' },
+        { label: 'Visit',   href: '#visit'  },
+        { label: 'Contact', href: '#visit'  },
+      ],
+      legal: '\u00a9 2026 BookWorms \u00b7 14 Old Market Lane',
+    })}
+  `,
+}

package/examples/contact.js

@@ -33,6 +33,7 @@ export default {
     title:       'Contact — Pulse',
     description: 'A contact form built with Pulse. Demonstrates server data, validation, and async action lifecycle.',
     styles:      ['/pulse-ui.css'],
+    theme:       'dark',
   },
 
   server: {

package/examples/counter.js

@@ -20,6 +20,7 @@ export default {
     title:       'Counter — Pulse',
     description: 'An interactive counter built with Pulse. Demonstrates mutations, constraints, and data-event binding.',
     styles:      ['/pulse-ui.css'],
+    theme:       'dark',
   },
 
   state: {

package/examples/dev.server.js

@@ -12,6 +12,12 @@
  *   http://localhost:3001/quiz      — multi-step state machine
  *   http://localhost:3001/products  — server data + search/filter/sort
  *   http://localhost:3001/pricing   — landing page components + billing toggle
+ *   http://localhost:3001/swish     — editorial fashion branding + light theme
+ *   http://localhost:3001/bookworms   — independent bookshop, Fraunces font, picsum covers
+ *   http://localhost:3001/retrowheels  — vintage bicycle shop, slab-serif, booking form
+ *   http://localhost:3001/suzukibento  — artist portfolio, dark brutalist, asymmetric grid
+ *   http://localhost:3001/andypixel   — blog article, editorial light, newsletter action
+ *   http://localhost:3001/journey     — app landing page, dark split-screen, sticky timeline
  */
 
 import fs   from 'fs'
@@ -81,6 +87,12 @@ await createServer(
     new URL('./quiz.js',     import.meta.url),
     new URL('./products.js', import.meta.url),
     new URL('./pricing.js',  import.meta.url),
+    new URL('./swish.js',    import.meta.url),
+    new URL('./bookworms.js',    import.meta.url),
+    new URL('./retrowheels.js', import.meta.url),
+    new URL('./suzukibento.js', import.meta.url),
+    new URL('./andypixel.js',   import.meta.url),
+    new URL('./journey.js',     import.meta.url),
   ],
   {
     port:       3001,
@@ -89,5 +101,10 @@ await createServer(
     root:       new URL('..', import.meta.url),  // pulse2/ — specs served at /examples/*
     onRequest:  staticHandler,
     extraBody:  themeScript,
+    csp: {
+      'style-src': ['https://fonts.googleapis.com'],
+      'font-src':  ['https://fonts.gstatic.com'],
+      'img-src':   ['https://images.unsplash.com', 'https://picsum.photos', 'https://fastly.picsum.photos'],
+    },
   }
 )