ultimate-jekyll-manager 1.7.1 → 1.8.0

package/dist/assets/themes/newsflash/css/base/_mixins.scss

@@ -0,0 +1,50 @@
+// Newsflash Theme — Mixins
+// The shared building blocks of the editorial look. Components @include these
+// so the frame/shadow/lift system lives in ONE place (SSOT) rather than being
+// copy-pasted across buttons, cards, inputs, etc.
+
+// Hairline frame in the current ink color.
+@mixin nf-border($width: var(--nf-border-width)) {
+  border: $width solid var(--nf-border-color);
+}
+
+// Small hard offset shadow (no blur) — the resting state of controls.
+@mixin nf-shadow-hard() {
+  box-shadow: var(--nf-shadow-hard);
+}
+
+// Soft "pop" shadow — depth for frames and panels (hero art, signup rail).
+@mixin nf-shadow-pop() {
+  box-shadow: var(--nf-shadow-pop);
+}
+
+// The signature interaction: the element rests on a small hard shadow, then
+// LIFTS up-left on hover (shadow grows beneath it) and presses flush on
+// active. Pure transform + shadow — no color shift.
+@mixin nf-lift() {
+  transition: $nf-transition;
+
+  &:hover {
+    transform: translate(-2px, -2px);
+    box-shadow: var(--nf-shadow-hard-hover);
+  }
+
+  &:active {
+    transform: translate(0, 0);
+    box-shadow: 1px 1px 0 var(--nf-shadow-color);
+  }
+}
+
+// Headline hover underline — an accent rule that grows from the left under
+// the text (the editorial "this is a link" affordance on serif headlines).
+@mixin nf-underline-grow($color: var(--bs-primary), $thickness: 2px) {
+  background-image: linear-gradient($color, $color);
+  background-repeat: no-repeat;
+  background-size: 0% $thickness;
+  background-position: 0 96%;
+  transition: background-size 0.35s cubic-bezier(0.22, 1, 0.36, 1);
+
+  &:hover {
+    background-size: 100% $thickness;
+  }
+}

package/dist/assets/themes/newsflash/css/base/_root.scss

@@ -0,0 +1,134 @@
+// Newsflash Theme — CSS Custom Properties
+// Bridges SCSS config into runtime CSS variables so light/dark mode switching
+// works without recompilation. Components read these var(--nf-*) tokens, never
+// the raw SCSS values, so dark mode is a single block of overrides.
+
+// ============================================
+// Light Mode (default)
+// ============================================
+// DOUBLED selectors (:root:root / [data-bs-theme][data-bs-theme]) on purpose:
+// every theme page bundle re-emits Bootstrap's own :root/[data-bs-theme=dark]
+// variable blocks (because page SCSS @uses config → Bootstrap) and those load
+// AFTER the main bundle. The doubled selector (0,2,0) beats Bootstrap's
+// (0,1,0) regardless of load order, so the paper/ink surfaces always win.
+:root:root,
+[data-bs-theme="light"][data-bs-theme="light"] {
+  // Paper & ink
+  --nf-paper: #{$nf-paper};
+  --nf-paper-2: #{$nf-paper-2};
+  --nf-ink: #{$nf-ink};
+  --nf-ink-soft: #{$nf-ink-soft};
+
+  // Translucent paper for the blurred sticky masthead
+  --nf-paper-translucent: #{rgba($nf-paper, 0.88)};
+
+  // Soft hairline for in-content dividers (feed rows, hr, table rules) —
+  // frames use the full-strength ink via --nf-border-color instead.
+  --nf-line: #{rgba($nf-ink, 0.16)};
+
+  // Accents
+  --nf-vermilion: #{$nf-vermilion};
+  --nf-blue: #{$nf-blue};
+  --nf-volt: #{$nf-volt};
+  --nf-volt-ink: #{$nf-volt-ink};
+
+  // Ink panels (ticker, footer, big-read band) — dark slabs in both modes
+  --nf-panel-bg: #{$nf-panel-bg};
+  --nf-panel-color: #{$nf-panel-color};
+
+  // Frame + shadow color follow the ink
+  --nf-border-color: var(--nf-ink);
+  --nf-shadow-color: var(--nf-ink);
+
+  // Frame + shadow recipes (used by components)
+  --nf-border-width: #{$nf-border-width};
+  --nf-border: #{$nf-border-width} solid var(--nf-border-color);
+  --nf-shadow-hard: #{$nf-shadow-offset} #{$nf-shadow-offset} 0 var(--nf-shadow-color);
+  --nf-shadow-hard-hover: #{$nf-shadow-offset-hover} #{$nf-shadow-offset-hover} 0 var(--nf-shadow-color);
+  --nf-shadow-pop: #{$nf-shadow-pop};
+
+  // Film grain strength (see _utilities.scss)
+  --nf-grain-opacity: 0.05;
+
+  // INTERACTIVE accent — the single token every hover/active fill points at
+  // (nav links, dropdown items, pagination). It tracks the rendered primary
+  // (--bs-primary), NOT the raw SCSS value, so consumer overrides flow through.
+  --nf-accent-interactive: var(--bs-primary);
+  --nf-accent-interactive-ink: #ffffff; // readable text on the interactive fill
+
+  // Map onto Bootstrap surfaces. The -rgb companions MUST be remapped too —
+  // Bootstrap's .bg-body-* / .text-body-* utilities paint from
+  // rgba(var(--bs-*-rgb), opacity), not the hex vars.
+  --bs-body-bg: #{$nf-paper};
+  --bs-body-bg-rgb: #{red($nf-paper)}, #{green($nf-paper)}, #{blue($nf-paper)};
+  --bs-body-color: #{$nf-ink};
+  --bs-body-color-rgb: #{red($nf-ink)}, #{green($nf-ink)}, #{blue($nf-ink)};
+  --bs-secondary-color: #{$nf-ink-soft};      // .text-body-secondary / muted metas
+  --bs-secondary-color-rgb: #{red($nf-ink-soft)}, #{green($nf-ink-soft)}, #{blue($nf-ink-soft)};
+  --bs-secondary-bg: #{$nf-paper-2};
+  --bs-secondary-bg-rgb: #{red($nf-paper-2)}, #{green($nf-paper-2)}, #{blue($nf-paper-2)};
+  --bs-tertiary-bg: #{$nf-paper-2};
+  --bs-tertiary-bg-rgb: #{red($nf-paper-2)}, #{green($nf-paper-2)}, #{blue($nf-paper-2)};
+  --bs-border-color: var(--nf-line);          // soft dividers; frames opt into full ink
+  --bs-card-bg: #{$nf-paper};
+  --bs-emphasis-color: #{$nf-ink};
+  --bs-emphasis-color-rgb: #{red($nf-ink)}, #{green($nf-ink)}, #{blue($nf-ink)};
+}
+
+// ============================================
+// Dark Mode
+// ============================================
+// Paper flips to deep warm near-black, ink to cream; vermilion/blue brighten
+// for contrast; volt stays vibrant. Frames + hard shadows auto-flip because
+// they reference var(--nf-border-color) → var(--nf-ink).
+// Doubled selector: see the light-mode block note.
+
+// Dark-mode primary derives from the COMPILE-TIME $primary so a consumer's
+// brand override survives dark mode (the stock vermilion keeps its hand-tuned
+// brightening; any other brand color gets a generic white-mix lift).
+$nf-primary-dark-mode: if($primary == $nf-vermilion, $nf-vermilion-dark-mode, mix(white, $primary, 15%));
+
+[data-bs-theme="dark"][data-bs-theme="dark"] {
+  --nf-paper: #{$nf-paper-dark};
+  --nf-paper-2: #{$nf-paper-2-dark};
+  --nf-ink: #{$nf-ink-dark};
+  --nf-ink-soft: #{$nf-ink-soft-dark};
+
+  --nf-paper-translucent: #{rgba($nf-paper-dark, 0.88)};
+  --nf-line: #{rgba($nf-ink-dark, 0.18)};
+
+  --nf-vermilion: #{$nf-vermilion-dark-mode};
+  --nf-blue: #{$nf-blue-dark-mode};
+
+  --nf-panel-bg: #{$nf-panel-bg-dark};
+  --nf-panel-color: #{$nf-panel-color-dark};
+
+  // Pop shadows barely read on dark paper; lean on a deeper, tighter blur.
+  --nf-shadow-pop: 0 18px 40px -18px rgba(0, 0, 0, 0.8);
+
+  --nf-grain-opacity: 0.07;
+
+  // Brighten the rendered primary so it stays vivid on dark paper
+  // (--bs-primary is compile-time; these runtime link/button reads cover the
+  // places that matter most for legibility).
+  --bs-primary: #{$nf-primary-dark-mode};
+  --bs-primary-rgb: #{red($nf-primary-dark-mode)}, #{green($nf-primary-dark-mode)}, #{blue($nf-primary-dark-mode)};
+  --bs-link-color: #{$nf-primary-dark-mode};
+  --bs-link-color-rgb: #{red($nf-primary-dark-mode)}, #{green($nf-primary-dark-mode)}, #{blue($nf-primary-dark-mode)};
+  --bs-link-hover-color: #{lighten($nf-primary-dark-mode, 8%)};
+
+  --bs-body-bg: #{$nf-paper-dark};
+  --bs-body-bg-rgb: #{red($nf-paper-dark)}, #{green($nf-paper-dark)}, #{blue($nf-paper-dark)};
+  --bs-body-color: #{$nf-ink-dark};
+  --bs-body-color-rgb: #{red($nf-ink-dark)}, #{green($nf-ink-dark)}, #{blue($nf-ink-dark)};
+  --bs-secondary-color: #{$nf-ink-soft-dark};
+  --bs-secondary-color-rgb: #{red($nf-ink-soft-dark)}, #{green($nf-ink-soft-dark)}, #{blue($nf-ink-soft-dark)};
+  --bs-secondary-bg: #{$nf-paper-2-dark};
+  --bs-secondary-bg-rgb: #{red($nf-paper-2-dark)}, #{green($nf-paper-2-dark)}, #{blue($nf-paper-2-dark)};
+  --bs-tertiary-bg: #{$nf-paper-2-dark};
+  --bs-tertiary-bg-rgb: #{red($nf-paper-2-dark)}, #{green($nf-paper-2-dark)}, #{blue($nf-paper-2-dark)};
+  --bs-border-color: var(--nf-line);
+  --bs-card-bg: #{$nf-paper-2-dark};
+  --bs-emphasis-color: #{$nf-ink-dark};
+  --bs-emphasis-color-rgb: #{red($nf-ink-dark)}, #{green($nf-ink-dark)}, #{blue($nf-ink-dark)};
+}

package/dist/assets/themes/newsflash/css/base/_typography.scss

@@ -0,0 +1,49 @@
+// Newsflash Theme — Typography
+// Optical-sized serif headlines over a clean grotesk body — the editorial
+// voice of the theme. Fonts are loaded via the theme's `head` block in
+// base.html (Google Fonts), NOT @import-ed here, to avoid render-blocking
+// duplicate loads.
+
+// NOTE: families, weights, and line-heights ship as Bootstrap vars in
+// _config.scss ($headings-*, $display-*, $lead-font-weight, $line-height-base)
+// — NOT as element rules here. Page bundles re-emit Bootstrap AFTER the main
+// bundle, so element-rule overrides of Bootstrap-owned props would silently
+// lose on any page that ships page CSS (the stock 300 display/lead weights
+// would come back). Only non-Bootstrap props live below.
+
+body {
+  -webkit-font-smoothing: antialiased;
+}
+
+h1, h2, h3, h4, h5, h6,
+.h1, .h2, .h3, .h4, .h5, .h6 {
+  font-optical-sizing: auto;
+  letter-spacing: $nf-heading-letter-spacing;
+  text-wrap: balance;
+}
+
+// Display headlines: tighter tracking — the front-page splash voice
+// (weight 550 + leading 1.04 come from $display-* in _config.scss).
+.display-1, .display-2, .display-3, .display-4, .display-5, .display-6 {
+  font-family: $nf-font-display;
+  font-optical-sizing: auto;
+  letter-spacing: -0.022em;
+}
+
+// Deks (the standfirst under a headline) — .lead reads as ink-soft prose.
+.lead {
+  color: var(--bs-secondary-color);
+  line-height: 1.6;
+}
+
+// Plain in-content links: vermilion with a visible underline. Buttons set
+// their own text color via --bs-btn-color — guard them so labels never turn
+// vermilion on hover.
+a {
+  text-underline-offset: 0.15em;
+  text-decoration-thickness: 1.5px;
+}
+
+a.btn:hover {
+  color: var(--bs-btn-color);
+}

package/dist/assets/themes/newsflash/css/base/_utilities.scss

@@ -0,0 +1,58 @@
+// Newsflash Theme — Base
+// Body surface, the film-grain overlay, selection color, and editorial
+// treatments of utility classes the shared (Classy-derived) layouts emit.
+// No theme-prefixed classes in markup: the look comes from restyling
+// STANDARD classes so markup stays swappable across themes.
+
+// Body surface
+body {
+  background-color: var(--nf-paper);
+  color: var(--bs-body-color);
+}
+
+// ============================================
+// Film grain — the analog print texture over everything
+// ============================================
+// Fixed SVG-noise overlay; pointer-events none so it never intercepts input.
+// Multiply on paper, screen on dark paper (multiply would just vanish).
+body::after {
+  content: "";
+  position: fixed;
+  inset: 0;
+  z-index: 999;
+  pointer-events: none;
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='240' height='240'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='2'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='0.55'/%3E%3C/svg%3E");
+  opacity: var(--nf-grain-opacity);
+  mix-blend-mode: multiply;
+}
+
+[data-bs-theme="dark"] body::after {
+  mix-blend-mode: screen;
+}
+
+// Volt selection — the highlighter
+::selection {
+  background: var(--nf-volt);
+  color: var(--nf-volt-ink);
+}
+
+// ============================================
+// Accent text (headline_accent spans) — italic serif vermilion
+// ============================================
+.text-accent {
+  font-family: $nf-font-display;
+  font-style: italic;
+  color: var(--bs-primary);
+}
+
+// ============================================
+// Highlighter swipe — volt half-height marker behind inline text
+// ============================================
+mark,
+.highlight {
+  background: linear-gradient(transparent 55%, var(--nf-volt) 55%);
+  color: inherit;
+  padding: 0 0.12em;
+  box-decoration-break: clone;
+  -webkit-box-decoration-break: clone;
+}

package/dist/assets/themes/newsflash/css/components/_badges.scss

@@ -0,0 +1,65 @@
+// Newsflash Theme — Badges, Chips & Pagination
+// Badges become uppercase pill chips with hairline ink frames (the "FEATURED"
+// sticker from the masthead design). Pagination becomes a row of pills.
+
+.badge {
+  border-radius: 50rem;
+  font-weight: 800;
+  font-size: 0.68em;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  padding: 0.55em 0.95em;
+  @include nf-border();
+}
+
+// Tertiary "superheadline" badges (inherited layouts emit these above
+// headlines) become the volt sticker chip.
+.badge.bg-body-tertiary {
+  background: var(--nf-volt) !important;
+  color: var(--nf-volt-ink) !important;
+}
+
+// Soft category chips (blog cards) keep their soft fill but read editorial
+.badge[class*="-soft"] {
+  border-color: currentColor;
+}
+
+// ============================================
+// Pagination — pill links, vermilion active
+// ============================================
+.pagination {
+  gap: 0.4rem;
+
+  .page-link {
+    border: var(--nf-border);
+    border-radius: 50rem !important; // beats Bootstrap's first/last corner rounding
+    background: transparent;
+    color: var(--bs-body-color);
+    font-weight: 700;
+    font-size: 0.9rem;
+    padding: 0.5rem 0.95rem;
+    transition: $nf-transition;
+
+    &:hover {
+      background: var(--nf-ink);
+      color: var(--nf-paper);
+      border-color: var(--nf-border-color);
+    }
+
+    &:focus {
+      box-shadow: 0 0 0 3px var(--nf-volt);
+    }
+  }
+
+  .page-item.active .page-link {
+    background: var(--nf-accent-interactive);
+    color: var(--nf-accent-interactive-ink);
+    border-color: var(--nf-border-color);
+  }
+
+  .page-item.disabled .page-link {
+    background: transparent;
+    border-color: var(--nf-line);
+    color: var(--bs-secondary-color);
+  }
+}

package/dist/assets/themes/newsflash/css/components/_buttons.scss

@@ -0,0 +1,139 @@
+// Newsflash Theme — Buttons
+// Pill buttons framed in ink, resting on a small hard offset shadow that
+// LIFTS on hover. This restyles Bootstrap's own .btn / .btn-* classes so all
+// existing markup (nav CTAs, hero buttons, forms) inherits the look with
+// zero HTML changes.
+
+.btn {
+  font-family: $font-family-sans-serif;
+  font-weight: 700;
+  letter-spacing: 0.02em;
+  border-radius: 50rem;
+  @include nf-border();
+  @include nf-shadow-hard();
+  padding: 0.6rem 1.4rem;
+}
+
+// The lift interaction. Doubled `.btn.btn` selector (specificity 0,2,0) on
+// purpose: every theme page bundle re-emits Bootstrap's own `.btn` rules
+// (because page SCSS @forwards Bootstrap) and those load AFTER the main
+// bundle — the doubled class beats them so the lift is pure transform+shadow.
+// Outline and link buttons are flat — they opt out below.
+.btn.btn:not([class*="btn-outline-"]):not(.btn-link) {
+  @include nf-lift();
+
+  // Focus shows an OUTLINE ring (outside the box, never conflicts with the
+  // offset shadow).
+  &:focus { outline: 0; }
+  &:focus-visible {
+    outline: 3px solid var(--nf-volt);
+    outline-offset: 2px;
+  }
+}
+
+.btn {
+  // Bootstrap adds a subtle border-color per-variant; force ink so the
+  // hairline frame is consistent across every color.
+  // (btn-adaptive / -inverse are the mode-flipping solids used by the nav
+  // CTA, auth buttons, etc. — they MUST be in this list or they'd keep
+  // Bootstrap's default "darken on hover" and feel different.)
+  &.btn-primary,
+  &.btn-secondary,
+  &.btn-success,
+  &.btn-info,
+  &.btn-warning,
+  &.btn-danger,
+  &.btn-light,
+  &.btn-dark,
+  &.btn-adaptive,
+  &.btn-adaptive-inverse {
+    border-color: var(--nf-border-color);
+    --bs-btn-hover-border-color: var(--nf-border-color);
+    --bs-btn-active-border-color: var(--nf-border-color);
+  }
+
+  // SOLID buttons: freeze hover/active fill to the resting color so the lift
+  // is pure transform+shadow (no color shift). Outline buttons are excluded —
+  // they keep their fill-on-hover.
+  &.btn-primary,   &.btn-secondary, &.btn-success,
+  &.btn-info,      &.btn-warning,   &.btn-danger,
+  &.btn-light,     &.btn-dark,
+  &.btn-adaptive,  &.btn-adaptive-inverse {
+    --bs-btn-hover-bg: var(--bs-btn-bg);
+    --bs-btn-hover-color: var(--bs-btn-color);
+    --bs-btn-active-bg: var(--bs-btn-bg);
+    --bs-btn-active-color: var(--bs-btn-color);
+  }
+}
+
+// btn-adaptive / -inverse RESTING fill. The global _buttons-adaptive.scss sets
+// these via `.btn-adaptive` (0,1,0), but Bootstrap's own re-emitted
+// `.btn { --bs-btn-bg: transparent }` can tie/beat it on order. Restate the
+// resting fill at `.btn.btn-adaptive` (0,2,0) so it always wins.
+.btn.btn-adaptive {
+  --bs-btn-color: #{$nf-paper};
+  --bs-btn-bg: #{$nf-ink};
+  --bs-btn-border-color: var(--nf-border-color);
+}
+[data-bs-theme="dark"] .btn.btn-adaptive {
+  --bs-btn-color: #{$nf-paper-dark};
+  --bs-btn-bg: #{$nf-ink-dark};
+}
+.btn.btn-adaptive-inverse {
+  --bs-btn-color: #{$nf-paper-dark};
+  --bs-btn-bg: #{$nf-ink-dark};
+  --bs-btn-border-color: var(--nf-border-color);
+}
+[data-bs-theme="dark"] .btn.btn-adaptive-inverse {
+  --bs-btn-color: #{$nf-paper};
+  --bs-btn-bg: #{$nf-ink};
+}
+
+// Size variants keep the pill proportions
+.btn-lg {
+  padding: 0.85rem 1.75rem;
+  font-size: 1.05rem;
+}
+
+.btn-sm {
+  padding: 0.35rem 0.9rem;
+  font-size: 0.82rem;
+}
+
+// Outline ("ghost") buttons: flat — transparent fill, ink frame, no shadow,
+// no lift. Hover fills with ink + paper text, true to the editorial ghost.
+// DOUBLED attribute selector (0,2,0) on purpose: page bundles re-emit
+// Bootstrap's .btn / .btn-outline-* rules after the main bundle; the doubled
+// selector wins regardless of load order (the variant's compile-time ink
+// color is invisible on dark paper otherwise).
+[class*="btn-outline-"][class*="btn-outline-"] {
+  box-shadow: none;
+  background: transparent;
+  border-color: var(--nf-border-color);
+  color: var(--bs-body-color);
+  --bs-btn-hover-bg: var(--nf-ink);
+  --bs-btn-hover-color: var(--nf-paper);
+  --bs-btn-hover-border-color: var(--nf-border-color);
+  --bs-btn-active-bg: var(--nf-ink);
+  --bs-btn-active-color: var(--nf-paper);
+  --bs-btn-active-border-color: var(--nf-border-color);
+
+  &:hover {
+    color: var(--nf-paper);
+    background: var(--nf-ink);
+  }
+}
+
+// Link-style button stays flat (no frame/shadow) but bold + underlined
+.btn-link {
+  border: 0;
+  box-shadow: none;
+  font-weight: 700;
+  text-decoration: underline;
+  text-underline-offset: 0.2em;
+}
+
+// NOTE: There are intentionally NO theme-specific accent button classes.
+// Themes must restyle the STANDARD Bootstrap button classes so the same
+// markup works across themes (swap theme.id, done). Need a volt CTA? Use
+// `.btn-warning` ($warning is volt). Vermilion? `.btn-primary`.

package/dist/assets/themes/newsflash/css/components/_cards.scss

@@ -0,0 +1,52 @@
+// Newsflash Theme — Cards
+// Framed paper objects: hairline ink border, editorial radius, serif titles.
+// Cards that ARE links lift gently and grow their framed image on hover.
+
+.card {
+  background: var(--bs-card-bg);
+  @include nf-border();
+  border-radius: var(--bs-border-radius-lg);
+  transition: $nf-transition;
+
+  .card-title {
+    font-family: $nf-font-display;
+    font-optical-sizing: auto;
+    letter-spacing: -0.012em;
+    line-height: 1.22;
+  }
+
+  // Serif headline links read as ink until hovered — then the vermilion
+  // rule grows in underneath (see nf-underline-grow).
+  .card-title a {
+    color: inherit;
+    text-decoration: none;
+    @include nf-underline-grow();
+  }
+}
+
+// Cards that are links (editorial story cards) lift on hover
+a.card {
+  color: inherit;
+  text-decoration: none;
+
+  &:hover {
+    transform: translateY(-5px);
+  }
+}
+
+// Framed images inside hovered cards/links zoom slowly (cinematic pan feel)
+.card:hover .art-frame img,
+a:hover > .art-frame img {
+  transform: scale(1.04);
+}
+
+// Card footers used as byline rows stay flush with the editorial look
+.card-footer {
+  background: transparent;
+  border-top: 1px solid var(--nf-line);
+}
+
+.card-header {
+  background: transparent;
+  border-bottom: 1px solid var(--nf-line);
+}