@omega.js/extension 0.1.0

package/dist/assets/themes/newsflash/_layouts/frontend/pages/index.html

@@ -0,0 +1,328 @@
+---
+layout: frontend/core/base
+
+# Hero Section — the front-page lead. News voice: the brand IS the publication.
+hero:
+  tagline: "{{ resolved.config.brand.name }}: independent journalism"
+  headline: "News with a"
+  headline_accent: "pulse"
+  description: "Sharp reporting and zero noise: the stories that matter, delivered before your coffee gets cold."
+  primary_button:
+    text: "Read the latest"
+    icon: "bolt"
+    href: "/blog"
+  secondary_button:
+    text: "Get the newsletter"
+    icon: "envelope"
+    href: "#signup"
+
+# The Latest — the front-page feed (posts-driven; newsflash-specific section)
+latest:
+  superheadline:
+    text: "The latest"
+  view_all:
+    text: "View the firehose"
+    href: "/blog"
+
+# More to Chew On — extra stories before the big read (posts-driven)
+more_stories:
+  superheadline:
+    text: "More to chew on"
+
+# The Rundown — the newsroom's three-step playbook (newsflash-specific section)
+rundown:
+  superheadline:
+    text: "The rundown"
+  headline: "Journalism worth your"
+  headline_accent: "morning"
+  subheadline: "What you get from the {{ resolved.config.brand.name }} newsroom every single day"
+  items:
+    - title: "Original reporting"
+      description: "Stories researched and written by people who pick up the phone, not rewrites of someone else's scoop."
+    - title: "The daily briefing"
+      description: "The five stories that actually matter, distilled into a five-minute read and delivered before sunrise."
+    - title: "Deep dives"
+      description: "Long-form features that follow the money, the people, and the consequences long after the headlines move on."
+
+# Newsletter Rail (sidebar signup)
+newsletter:
+  headline: "{{ resolved.config.brand.name }}, daily."
+  subheadline: "One ridiculously good email every morning. The stories that matter, minus the noise."
+  button:
+    text: "Join"
+  form:
+    placeholder: "you@example.com"
+  disclaimer: "Free forever. Unsubscribe anytime."
+
+# The Desks — coverage areas (newsflash-specific section)
+desks:
+  superheadline:
+    text: "The desks"
+  headline: "Coverage with"
+  headline_accent: "teeth"
+  subheadline: "Three desks, one standard: report it right, write it sharp."
+  cta_button:
+    text: "Browse all stories"
+    icon: "arrow-right"
+    href: "/blog"
+  items:
+    - title: "Tech"
+      description: "The machines, the makers, and the money rewiring how we live and work."
+      icon: "microchip"
+      href: "/blog/categories/tech"
+    - title: "Culture"
+      description: "What we watch, wear, and argue about, and why it matters more than you think."
+      icon: "masks-theater"
+      href: "/blog/categories/culture"
+    - title: "Money"
+      description: "Markets, paychecks, and the economics hiding inside everyday decisions."
+      icon: "chart-line"
+      href: "/blog/categories/money"
+
+# Stats Section — the masthead numbers
+stats:
+  - number: "2M+"
+    label: "Monthly readers"
+    sublabel: "Across 120+ countries"
+  - number: "12k+"
+    label: "Stories published"
+    sublabel: "And counting"
+  - number: "5 min"
+    label: "Daily briefing"
+    sublabel: "Fully caught up"
+  - number: "0"
+    label: "Clickbait headlines"
+    sublabel: "We checked"
+
+# CTA Section — the big-read band
+cta:
+  superheadline:
+    text: "The big read"
+  headline: "Don't just scroll the news."
+  headline_accent: "Understand it."
+  subheadline: "Join the readers who start their day with {{ resolved.config.brand.name }}: reporting with teeth, context with heart, and zero filler."
+  primary_button:
+    text: "Start reading"
+    icon: "bolt"
+    href: "/blog"
+  secondary_button:
+    text: "Get the newsletter"
+    icon: "envelope"
+    href: "#signup"
+---
+
+{% comment %}
+  NEWSFLASH HOMEPAGE
+  A newspaper front page: a featured-story hero (publication pitch left, the
+  latest post as the framed cover story right), top-story tiles, "the latest"
+  as an editorial post feed (square art + kicker + headline + dek) with a
+  sticky rail sidebar (most-read + newsletter signup), "the rundown" as the
+  newsroom's numbered three-step playbook, coverage-desk cards (linked to
+  their category pages), a masthead numbers strip, "more to chew on" story
+  tiles, and a dark big-read CTA band. (Reader quotes live on the about page.)
+  The rundown and desks bands render through newsflash-layer sections;
+  marketing/stats and marketing/cta fall through to the BASE sections
+  (omega-* markup, restyled by this theme's scss), and the rail signup card
+  is the newsletter-cta fork's rail variant (managed form, §7-bound); only
+  the posts-driven bands are still rendered by this layout. The
+  frontmatter defaults are NEWS-genre copy — a theme's defaults are part of
+  its identity (see docs/web/sections.md: theme defaults are theme
+  identity). Universal sections (hero, stats, cta, newsletter) keep
+  the shared key names; `latest`, `rundown`, `desks`, and `more_stories` are
+  newsflash-specific. Posts-driven sections disappear gracefully when
+  site.posts is empty.
+{% endcomment %}
+
+<!-- ============================================ -->
+<!-- HERO — front page lead: pitch left, cover story right -->
+<!-- ============================================ -->
+<section class="newsflash-hero pb-4">
+  <div class="container">
+    <div class="row align-items-center g-4 g-lg-5">
+      <!-- Left: kicker + serif headline + dek + actions -->
+      <div class="col-lg-6" data-lazy="@class animation-slide-up">
+        {% iftruthy resolved.hero.tagline %}
+          <span class="newsflash-kicker">{{ resolved.hero.tagline }}</span>
+        {% endiftruthy %}
+        <h1 class="newsflash-hero__title my-3">
+          {{ resolved.hero.headline }}
+          {% iftruthy resolved.hero.headline_accent %}
+            <span class="newsflash-accent">{{ resolved.hero.headline_accent }}</span>
+          {% endiftruthy %}
+        </h1>
+        {% iftruthy resolved.hero.description %}
+          <p class="lead mb-4" style="max-width: 34em;">{{ resolved.hero.description }}</p>
+        {% endiftruthy %}
+        <div class="d-flex flex-wrap gap-3">
+          {% iftruthy resolved.hero.primary_button %}
+            <a href="{{ resolved.hero.primary_button.href }}" class="btn btn-primary btn-lg">
+              <i class="fa-solid fa-{{ resolved.hero.primary_button.icon }} me-2"></i>{{ resolved.hero.primary_button.text }}
+            </a>
+          {% endiftruthy %}
+          {% iftruthy resolved.hero.secondary_button %}
+            <a href="{{ resolved.hero.secondary_button.href }}" class="btn btn-outline-dark btn-lg">
+              <i class="fa-solid fa-{{ resolved.hero.secondary_button.icon }} me-2"></i>{{ resolved.hero.secondary_button.text }}
+            </a>
+          {% endiftruthy %}
+        </div>
+      </div>
+
+      <!-- Right: the cover story (latest post) — or a cover-art block pre-content -->
+      <div class="col-lg-6" data-lazy="@class animation-slide-up">
+        {% if site.posts.size > 0 %}
+          {% assign featured = site.posts.first %}
+          <a href="{{ resolved.config.url }}{{ featured.url }}" class="newsflash-hero__art d-block position-relative text-decoration-none text-body">
+            <span class="badge bg-body-tertiary newsflash-hero__chip">Featured</span>
+            <div class="newsflash-frame shadow">
+              {%- omega_post featured.post.id, "image-tag", class="w-100" -%}
+            </div>
+            <div class="mt-3">
+              {% if featured.post.categories[0] %}
+                <span class="newsflash-kicker mb-1">{{ featured.post.categories[0] | omega_title_case }}</span>
+              {% endif %}
+              <h2 class="h4 mb-1">{{ featured.post.title }}</h2>
+              {% capture featured_rt %}{% omega_readtime featured.content %}{% endcapture %}
+              {% component "news/byline", author: featured.post.author, date: featured.date | date: "%b %d, %Y", readtime: featured_rt %}
+            </div>
+          </a>
+        {% else %}
+          <div class="newsflash-hero__art position-relative">
+            <span class="badge bg-body-tertiary newsflash-hero__chip">Featured</span>
+            <div class="newsflash-frame shadow">
+              <div class="newsflash-hero__cover ratio ratio-4x3"></div>
+            </div>
+          </div>
+        {% endif %}
+      </div>
+    </div>
+  </div>
+</section>
+
+<!-- ============================================ -->
+<!-- TOP STORIES — three editorial tiles -->
+<!-- ============================================ -->
+{% if site.posts.size > 1 %}
+  <section class="pt-4">
+    <div class="container">
+      {% component "heading/rule-head", text: "Top stories", link_text: "View all", link_href: resolved.config.url | append: "/blog" %}
+      <div class="row g-4">
+        {% for post in site.posts offset: 1 limit: 3 %}
+          <div class="col-md-4" data-lazy="@class animation-slide-up">
+            {% capture rt %}{% omega_readtime post.content %}{% endcapture %}
+            {% component "news/story-card", url: resolved.config.url | append: post.url, id: post.post.id, kicker: post.post.categories[0] | default: "" | omega_title_case, title: post.post.title, author: post.post.author, date: post.date | date: "%b %d, %Y", readtime: rt, generated: post.generated %}
+          </div>
+        {% endfor %}
+      </div>
+    </div>
+  </section>
+{% endif %}
+
+<!-- ============================================ -->
+<!-- THE LATEST — editorial post feed + sticky rail sidebar -->
+<!-- (mirrors the front-page feed: square art, kicker, headline, dek, byline) -->
+<!-- ============================================ -->
+{% comment %}
+  Post slots are strictly deduplicated down the page: hero = post 1,
+  top stories = 2-4, this feed = 5-9, most-read rail = 10-14, "more to chew
+  on" = 15-17. Sections disappear gracefully when the site doesn't have
+  enough posts to fill their slice (only the ticker repeats the latest —
+  it's chrome, not content).
+{% endcomment %}
+{% if site.posts.size > 4 %}
+<section class="newsflash-feed">
+  <div class="container">
+    {% component "heading/rule-head", text: resolved.latest.superheadline.text, link_text: resolved.latest.view_all.text, link_href: resolved.latest.view_all.href %}
+
+    <div class="row g-4 g-lg-5">
+      <!-- The feed: posts 5-9 (hero + top stories show 1-4) -->
+      <div class="col-lg-7">
+        <div>
+          {% for post in site.posts offset: 4 limit: 5 %}
+            <a href="{{ resolved.config.url }}{{ post.url }}" class="newsflash-feed__item" data-lazy="@class animation-slide-up">
+              <div class="newsflash-frame">
+                {%- omega_post post.post.id, "image-tag", class="w-100" -%}
+              </div>
+              <div>
+                {% if post.post.categories[0] %}
+                  <span class="newsflash-kicker mb-1">{{ post.post.categories[0] | omega_title_case }}</span>
+                {% endif %}
+                <h3 class="h4 my-2">{{ post.post.title }}</h3>
+                {% iftruthy post.post.description %}
+                  <p class="text-body-secondary mb-2">{{ post.post.description }}</p>
+                {% endiftruthy %}
+                {% capture rt %}{% omega_readtime post.content %}{% endcapture %}
+                {% component "news/byline", author: post.post.author, date: post.date | date: "%b %d, %Y", readtime: rt %}
+              </div>
+            </a>
+          {% endfor %}
+        </div>
+      </div>
+
+      <!-- The rail -->
+      <aside class="col-lg-5 col-xl-4 ms-auto">
+        <div class="newsflash-rail d-flex flex-column gap-4">
+          {% comment %} Most read: posts 10-14 — the next slice after the feed (no duplicates) {% endcomment %}
+          {% if site.posts.size > 9 %}
+            <div class="card p-4" data-lazy="@class animation-slide-up">
+              <div class="newsflash-rail__title">Most read</div>
+              <ol class="newsflash-rail__mostread list-unstyled mb-0">
+                {% for post in site.posts offset: 9 limit: 5 %}
+                  <li>
+                    <a href="{{ resolved.config.url }}{{ post.url }}">{{ post.post.title }}</a>
+                  </li>
+                {% endfor %}
+              </ol>
+            </div>
+          {% endif %}
+
+          {% iftruthy resolved.newsletter %}
+            {% section "marketing/newsletter-cta", data: resolved.newsletter, variant: "rail", anchor: "signup" %}
+          {% endiftruthy %}
+        </div>
+      </aside>
+    </div>
+  </div>
+</section>
+{% endif %}
+
+<!-- ============================================ -->
+<!-- THE RUNDOWN — the newsroom's numbered three-step playbook -->
+<!-- ============================================ -->
+{% section "marketing/rundown", data: resolved.rundown %}
+
+<!-- ============================================ -->
+<!-- THE DESKS — coverage cards in a paper well -->
+<!-- ============================================ -->
+{% section "marketing/desks", data: resolved.desks %}
+
+<!-- ============================================ -->
+<!-- STATS — masthead numbers (base marketing/stats, restyled) -->
+<!-- ============================================ -->
+{% section "marketing/stats", items: resolved.stats %}
+
+<!-- ============================================ -->
+<!-- MORE TO CHEW ON — extra story tiles before the big read -->
+<!-- ============================================ -->
+{% comment %} More to chew on: posts 15-17 — the slice after the most-read rail (no duplicates) {% endcomment %}
+{% if site.posts.size > 14 %}
+  <section class="pt-0">
+    <div class="container">
+      {% component "heading/rule-head", text: resolved.more_stories.superheadline.text %}
+      <div class="row g-4">
+        {% for post in site.posts offset: 14 limit: 3 %}
+          <div class="col-md-4" data-lazy="@class animation-slide-up">
+            {% capture rt %}{% omega_readtime post.content %}{% endcapture %}
+            {% component "news/story-card", url: resolved.config.url | append: post.url, id: post.post.id, kicker: post.post.categories[0] | default: "" | omega_title_case, title: post.post.title, author: post.post.author, date: post.date | date: "%b %d, %Y", readtime: rt, generated: post.generated %}
+          </div>
+        {% endfor %}
+      </div>
+    </div>
+  </section>
+{% endif %}
+
+<!-- ============================================ -->
+<!-- CTA — the dark big-read band (base marketing/cta, restyled) -->
+<!-- ============================================ -->
+{% section "marketing/cta", data: resolved.cta %}
+
+{{ content | omega_content_format }}

package/dist/assets/themes/newsflash/_sections/marketing/desks/section.html

@@ -0,0 +1,39 @@
+{% comment %}
+  The desks — coverage-area cards in a paper well: rule head, lede header,
+  icon story-cards linking to their category pages, optional CTA button.
+  Newsflash-specific section; the index passes its copy over the data bridge.
+{% endcomment %}
+<section class="bg-body-tertiary">
+  <div class="container">
+    {% component "heading/rule-head", text: args.superheadline.text %}
+
+    <header class="mb-5" data-lazy="@class animation-slide-up">
+      {% component "heading/lede", headline: args.headline, headline_accent: args.headline_accent, subheadline: args.subheadline %}
+    </header>
+
+    <div class="row g-4">
+      {% for desk in args.items %}
+        {% comment %} Each desk card links to its category page (href overrides the slugified title) {% endcomment %}
+        {% capture desk_href %}{% if desk.href %}{{ desk.href }}{% else %}/blog/categories/{{ desk.title | slugify }}{% endif %}{% endcapture %}
+        <div class="col-md-4" data-lazy="@class animation-slide-up">
+          <a href="{{ desk_href }}" class="card newsflash-story-card h-100 p-4 text-decoration-none">
+            <span class="newsflash-desks__icon d-inline-flex align-items-center justify-content-center rounded-circle text-bg-primary mb-3">
+              <i class="fa-solid fa-{{ desk.icon }}"></i>
+            </span>
+            <h3 class="h4 mb-2">{{ desk.title }}</h3>
+            <p class="text-body-secondary mb-0">{{ desk.description }}</p>
+            <span class="small fw-bold text-primary mt-3">Read the desk <i class="fa-solid fa-arrow-right ms-1"></i></span>
+          </a>
+        </div>
+      {% endfor %}
+    </div>
+
+    {% iftruthy args.cta_button %}
+      <div class="text-center mt-5" data-lazy="@class animation-slide-up">
+        <a href="{{ args.cta_button.href }}" class="btn btn-primary btn-lg">
+          <i class="fa-solid fa-{{ args.cta_button.icon }} me-2"></i>{{ args.cta_button.text }}
+        </a>
+      </div>
+    {% endiftruthy %}
+  </div>
+</section>

package/dist/assets/themes/newsflash/_sections/marketing/desks/section.json5

@@ -0,0 +1,49 @@
+{
+  description: 'The desks — coverage-area cards in a paper well: rule head, lede header, icon story-cards linking to their category pages (desk.href overrides the slugified title), optional cta_button. Newsflash-specific; the index passes its copy over the data bridge.',
+
+  args: {
+    superheadline: 'object',
+    headline: 'string',
+    headline_accent: 'string',
+    subheadline: 'string',
+    items: 'array',
+    cta_button: 'object',
+  },
+
+  defaults: {},
+
+  // Showcase variants (spec §9) — demo desks pass explicit hrefs so the
+  // cards never point at category pages the site may not have.
+  demo: [
+    {
+      label: 'Three desks',
+      args: {
+        superheadline: { text: 'The desks' },
+        headline: 'Coverage that',
+        headline_accent: 'compounds',
+        subheadline: 'Three beats, one standard.',
+        items: [
+          {
+            icon: 'microchip',
+            title: 'Technology',
+            description: 'Chips, code, and the people shipping both.',
+            href: '/blog',
+          },
+          {
+            icon: 'chart-line',
+            title: 'Markets',
+            description: 'What moved, why it moved, who moved it.',
+            href: '/blog',
+          },
+          {
+            icon: 'landmark',
+            title: 'Policy',
+            description: 'The rules being written while you read this.',
+            href: '/blog',
+          },
+        ],
+        cta_button: { icon: 'rss', text: 'Browse all coverage', href: '/blog' },
+      },
+    },
+  ],
+}

package/dist/assets/themes/newsflash/_sections/marketing/newsletter-cta/section.html

@@ -0,0 +1,103 @@
+{% comment %}
+  The vermilion newsletter capture, two presentations: the default slab band
+  (primary card in a full section) and variant: "rail" — the compact sidebar
+  signup card with NO section/container wrapper, made to compose inside an
+  aside (the index rail). Both speak the client form-manager dialect.
+  Theme-layer FORK of the base marketing/newsletter-cta: same args
+  contract (+ headline_accent, the narrow column knob, variant/anchor/
+  disclaimer), same BEHAVIOR — the json5 declares inherit: ['js'], so
+  the base layer's section.js (the FormManager binding) keeps riding the §7 bundle
+  and binds through the data-omega-section root of EITHER presentation. That
+  makes the inherited js's DOM contract part of this markup:
+  form.newsletter-form inside the root and .button-text on the submit
+  button. SHARED band: defaults stay neutral, every caller passes its own
+  copy.
+{% endcomment %}
+{% if args.variant == "rail" %}
+<div class="card bg-primary text-white p-4" data-lazy="@class animation-slide-up" data-omega-section="marketing/newsletter-cta"{% if args.anchor != blank %} id="{{ args.anchor }}"{% endif %}>
+  {% iftruthy args.headline %}
+    <h3 class="h3 fst-italic mb-2">{{ args.headline }}</h3>
+  {% endiftruthy %}
+  {% iftruthy args.subheadline %}
+    <p class="small mb-3">{{ args.subheadline }}</p>
+  {% endiftruthy %}
+  <form class="newsletter-form" novalidate data-form-state="initializing" onsubmit="return false">
+    <div class="d-flex gap-2 align-items-start">
+      <div class="flex-grow-1">
+        <label for="newsletter-email" class="visually-hidden">Email address</label>
+        <input
+          type="email"
+          class="form-control"
+          placeholder="{{ args.form.placeholder }}"
+          name="email"
+          id="newsletter-email"
+          required
+          autocomplete="email"
+        >
+        <div class="invalid-feedback text-start">
+          Please enter a valid email address.
+        </div>
+      </div>
+      <button type="submit" class="btn btn-dark">
+        <span class="button-text">{{ args.button.text }}</span>
+      </button>
+    </div>
+  </form>
+  {% iftruthy args.disclaimer %}
+    <small class="d-block mt-2 opacity-75">{{ args.disclaimer }}</small>
+  {% endiftruthy %}
+</div>
+{% else %}
+<section{% if args.section_class != blank %} class="{{ args.section_class }}"{% endif %}{% if args.anchor != blank %} id="{{ args.anchor }}"{% endif %} data-omega-section="marketing/newsletter-cta">
+  <div class="container">
+    {% if args.narrow %}<div class="row justify-content-center"><div class="col-xl-8 col-lg-8 col-md-12 col-12">{% endif %}
+    <div class="card bg-primary text-white p-4 p-md-5 text-center position-relative overflow-hidden" data-lazy="@class animation-slide-up">
+      <div class="position-relative">
+        {% iftruthy args.superheadline.text %}
+          <span class="badge bg-body-tertiary p-2 mb-3">
+            {{ args.superheadline.text }}
+          </span>
+        {% endiftruthy %}
+
+        {% iftruthy args.headline %}
+          <h2 class="h2 fst-italic mb-3">
+            {{ args.headline }}
+            {% iftruthy args.headline_accent %}
+              {{ args.headline_accent }}
+            {% endiftruthy %}
+          </h2>
+        {% endiftruthy %}
+
+        {% iftruthy args.subheadline %}
+          <p class="lead text-white mb-4">{{ args.subheadline }}</p>
+        {% endiftruthy %}
+
+        <!-- Newsletter Form -->
+        <form id="newsletter-form" class="newsletter-form" novalidate data-form-state="initializing" onsubmit="return false">
+          <div class="row g-3 justify-content-center">
+            <div class="col-md-7">
+              <input
+                type="email"
+                class="form-control form-control-lg"
+                placeholder="{{ args.form.placeholder }}"
+                name="email"
+                required
+                autocomplete="email"
+              >
+              <div class="invalid-feedback text-start">
+                Please enter a valid email address.
+              </div>
+            </div>
+            <div class="col-md-auto">
+              <button type="submit" class="btn btn-dark btn-lg px-4">
+                <span class="button-text">{{ args.button.text }}</span>
+              </button>
+            </div>
+          </div>
+        </form>
+      </div>
+    </div>
+    {% if args.narrow %}</div></div>{% endif %}
+  </div>
+</section>
+{% endif %}

package/dist/assets/themes/newsflash/_sections/marketing/newsletter-cta/section.json5

@@ -0,0 +1,50 @@
+{
+  description: 'The vermilion newsletter capture, two presentations — the default slab band (primary card in a full section) and variant: "rail", the compact sidebar signup card with no section wrapper (composes inside an aside). Both speak the client form-manager dialect (data-form-state; the §7 presence init binds the form). Theme-layer FORK of the base band: newsflash markup, inherited behavior — the base layer\'s FormManager section.js keeps riding the bundle via inherit, and its DOM contract (form.newsletter-form under the data-omega-section root, .button-text) is part of this markup. SHARED band: defaults stay neutral, every caller passes its own copy.',
+
+  args: {
+    superheadline: 'object',
+    headline: 'string',
+    headline_accent: 'string',
+    subheadline: 'string',
+    button: 'object',
+    form: 'object',
+    section_class: 'string',
+    narrow: { type: 'boolean', description: 'wrap the card in the centered col-xl-8 column (the post-page variant)' },
+    variant: { type: 'string', description: 'presentation family: unset renders the slab band; "rail" renders the compact sidebar card (no section/container wrapper)' },
+    anchor: { type: 'string', description: 'optional id on the root element — a deep-link target (e.g. the hero\'s #signup button)' },
+    disclaimer: { type: 'string', description: 'small print under the form (rail presentation only)' },
+  },
+
+  defaults: {},
+
+  // Showcase variants (spec §9) — both presentations, generic copy.
+  demo: [
+    {
+      label: 'Slab band',
+      args: {
+        superheadline: { text: 'Newsletter' },
+        headline: 'Never miss an',
+        headline_accent: 'issue',
+        subheadline: 'One email a week: the best of the desk, nothing else.',
+        button: { text: 'Subscribe' },
+        form: { placeholder: 'you@example.com' },
+      },
+    },
+    {
+      label: 'Rail card',
+      args: {
+        variant: 'rail',
+        headline: 'The morning brief',
+        subheadline: 'The day in five minutes, in your inbox by six.',
+        button: { text: 'Sign up' },
+        form: { placeholder: 'you@example.com' },
+        disclaimer: 'Free forever. Unsubscribe anytime.',
+        anchor: 'demo-signup',
+      },
+    },
+  ],
+
+  // §7: this fork replaces markup, not behavior — keep the base layer's
+  // section.js (the FormManager binding) in the bundle.
+  inherit: ['js'],
+}

package/dist/assets/themes/newsflash/_sections/marketing/rundown/section.html

@@ -0,0 +1,28 @@
+{% comment %}
+  The rundown — the newsroom playbook: rule head, lede header, then a
+  numbered feed of items (big stroked numerals). Newsflash-specific section;
+  the index passes its copy over the data bridge.
+{% endcomment %}
+<section class="newsflash-rundown pt-0">
+  <div class="container">
+    {% component "heading/rule-head", text: args.superheadline.text %}
+
+    <header class="mb-4" data-lazy="@class animation-slide-up">
+      {% component "heading/lede", headline: args.headline, headline_accent: args.headline_accent, subheadline: args.subheadline %}
+    </header>
+
+    <div class="row">
+      <div class="col-lg-9">
+        {% for item in args.items %}
+          <article class="newsflash-feed__item" data-lazy="@class animation-slide-up">
+            <div class="newsflash-feed__num" aria-hidden="true">{{ forloop.index | prepend: '0' | slice: -2, 2 }}</div>
+            <div>
+              <h3 class="h4 mb-2">{{ item.title }}</h3>
+              <p class="text-body-secondary mb-0">{{ item.description }}</p>
+            </div>
+          </article>
+        {% endfor %}
+      </div>
+    </div>
+  </div>
+</section>

package/dist/assets/themes/newsflash/_sections/marketing/rundown/section.json5

@@ -0,0 +1,40 @@
+{
+  description: 'The rundown — the newsroom playbook: rule head, lede header, then a numbered feed of items. Newsflash-specific; the index passes its copy over the data bridge.',
+
+  args: {
+    superheadline: 'object',
+    headline: 'string',
+    headline_accent: 'string',
+    subheadline: 'string',
+    items: 'array',
+  },
+
+  defaults: {},
+
+  // Showcase variants (spec §9)
+  demo: [
+    {
+      label: 'Three-step playbook',
+      args: {
+        superheadline: { text: 'The rundown' },
+        headline: 'How the newsroom',
+        headline_accent: 'ships',
+        subheadline: 'The playbook, in the order it actually happens.',
+        items: [
+          {
+            title: 'Report it',
+            description: 'Every story starts at a desk, with a byline on the hook.',
+          },
+          {
+            title: 'Edit it',
+            description: 'Two reads minimum: copy first, then the desk editor.',
+          },
+          {
+            title: 'Publish it',
+            description: 'One verb ships it to every edition at once.',
+          },
+        ],
+      },
+    },
+  ],
+}

package/dist/assets/themes/newsflash/_theme.js

@@ -0,0 +1,24 @@
+// Newsflash Theme — JS entry point
+// Loaded at runtime via webpack's __theme__ alias (import('__theme__/_theme.js')).
+// Exposes Bootstrap globally and wires up theme behaviors on DOM ready.
+import bootstrap from '__main_assets__/themes/bootstrap/js/index.umd.js';
+import { ready as domReady } from '@omega.js/client/modules/dom.js';
+
+// Make Bootstrap available globally (used by omega utilities + components)
+window.bootstrap = bootstrap;
+
+/* @dev-only:start */
+{
+  console.log('Newsflash theme loaded successfully (assets/themes/newsflash/_theme.js)');
+}
+/* @dev-only:end */
+
+// Theme behaviors (masthead scroll state rides the shared motion engine's
+// data-omega-scroll-watch — no theme JS)
+import initializeTooltips from '__main_assets__/js/libs/initialize-tooltips.js';
+
+// Initialize when DOM is ready
+domReady().then(() => {
+  // Generic Bootstrap initializations
+  initializeTooltips();
+});