@zpress/ui 0.3.0 → 0.4.0

package/dist/theme/styles/overrides/rspress.css

@@ -1,25 +1,14 @@
 /**
- * Rspress brand overrides (purple / violet).
+ * Rspress structural overrides.
  *
- * html:root bumps specificity (0,1,1) above Rspress vars.css
- * (:root = 0,1,0) so these always win regardless of load order.
+ * Color definitions have moved to theme files (styles/themes/*.css).
+ * This file retains only structural overrides: fonts, layout, LLMs UI.
  */
 
 html:root {
   /* Fonts — map Geist into Rspress's font stack */
   --rp-font-family-base: 'Geist Pixel Square', ui-sans-serif, system-ui, sans-serif;
   --rp-font-family-mono: 'Geist Mono', ui-monospace, 'SFMono-Regular', monospace;
-
-  /* Brand colors */
-  --rp-c-brand: #a78bfa;
-  --rp-c-brand-light: #c4b5fd;
-  --rp-c-brand-lighter: #ddd6fe;
-  --rp-c-brand-dark: #8b5cf6;
-  --rp-c-brand-darker: #7c3aed;
-  --rp-c-brand-tint: rgba(167, 139, 250, 0.14);
-
-  /* Solid home background — overrides Rspress default radial gradients */
-  --rp-home-background-bg: #fff;
 }
 
 /* ── LLMs UI — hide the view-options trigger button (dropdown arrow) ── */
@@ -48,61 +37,3 @@ html table {
   border-radius: var(--rp-radius);
   overflow: hidden;
 }
-
-/* ── Dark-mode overrides (zpress custom vars) ─────────────── */
-.rp-dark,
-html[data-dark='true'] {
-  --zp-c-bg: #141414;
-  --zp-c-bg-alt: #1a1a1a;
-  --zp-c-bg-elv: #1f1f1f;
-  --zp-c-bg-soft: #222222;
-  --zp-c-bg-icon: #3d3d3d;
-
-  --zp-c-text-1: #fbfbfb;
-  --zp-c-text-2: rgba(251, 251, 251, 0.72);
-  --zp-c-text-3: rgba(251, 251, 251, 0.48);
-
-  --zp-c-divider: #2e2e2e;
-  --zp-c-border: #3a3a3a;
-  --zp-c-gutter: #1a1a1a;
-
-  --zp-c-brand-1: #a78bfa;
-  --zp-c-brand-2: #8b5cf6;
-  --zp-c-brand-3: #7c3aed;
-  --zp-c-brand-soft: rgba(167, 139, 250, 0.14);
-
-  --zp-code-block-bg: #1a1a1a;
-
-  --zp-button-brand-bg: #7c3aed;
-  --zp-button-brand-hover-bg: #8b5cf6;
-  --zp-button-brand-active-bg: #6d28d9;
-  --zp-button-brand-text: #fbfbfb;
-}
-
-/* ── Dark-mode overrides (Rspress vars) ──────────────────────
- * html.rp-dark bumps specificity (0,1,1) above Rspress vars.css
- * .rp-dark (0,1,0) so these always win regardless of load order. */
-html.rp-dark {
-  --rp-c-bg: #141414;
-  --rp-c-bg-soft: #222222;
-  --rp-c-bg-mute: #1f1f1f;
-
-  --rp-c-text-1: #fbfbfb;
-  --rp-c-text-2: rgba(251, 251, 251, 0.72);
-  --rp-c-text-3: rgba(251, 251, 251, 0.48);
-
-  --rp-c-divider: #2e2e2e;
-
-  --rp-c-brand: #a78bfa;
-  --rp-c-brand-light: #c4b5fd;
-  --rp-c-brand-lighter: #ddd6fe;
-  --rp-c-brand-dark: #8b5cf6;
-  --rp-c-brand-darker: #7c3aed;
-  --rp-c-brand-tint: rgba(167, 139, 250, 0.14);
-  --rp-c-link: var(--rp-c-brand-light);
-
-  --rp-code-block-bg: #1a1a1a;
-
-  /* Solid home background — overrides Rspress default radial gradients */
-  --rp-home-background-bg: #141414;
-}

package/dist/theme/styles/overrides/tokens.css

@@ -1,11 +1,8 @@
 /**
- * zpress custom properties (--zp-* prefix).
+ * zpress structural tokens (--zp-* prefix).
  *
- * Palette derived from apps/console globals.css:
- *   --background : oklch(0.1448 0 0)   ≈ #1a1a1a
- *   --foreground : oklch(0.9851 0 0)    ≈ #fbfbfb
- *   --primary    : oklch(0.78 0.13 291) ≈ #a78bfa (purple/violet)
- *   --border     : oklch(0.3407 0 0)    ≈ #4a4a4a
+ * Color definitions have moved to theme files (styles/themes/*.css).
+ * This file retains only structural tokens: fonts, layout, radii.
  */
 
 :root {
@@ -17,32 +14,4 @@
   --rp-radius: 0.25rem;
   --rp-radius-small: 0.125rem;
   --rp-radius-large: 0.5rem;
-
-  --zp-c-brand-1: #a78bfa;
-  --zp-c-brand-2: #8b5cf6;
-  --zp-c-brand-3: #7c3aed;
-  --zp-c-brand-soft: rgba(167, 139, 250, 0.14);
-
-  /* Light-mode surface & text defaults — ensures --zp-c-* variables
-     resolve even when .rp-dark is not applied. */
-  --zp-c-bg: #ffffff;
-  --zp-c-bg-alt: #f9f9f9;
-  --zp-c-bg-elv: #f5f5f5;
-  --zp-c-bg-soft: #f0f0f0;
-  --zp-c-bg-icon: #cccccc;
-
-  --zp-c-text-1: #1a1a1a;
-  --zp-c-text-2: rgba(26, 26, 26, 0.72);
-  --zp-c-text-3: rgba(26, 26, 26, 0.48);
-
-  --zp-c-divider: #e2e2e2;
-  --zp-c-border: #d0d0d0;
-  --zp-c-gutter: #f5f5f5;
-
-  --zp-code-block-bg: #f5f5f5;
-
-  --zp-button-brand-bg: #7c3aed;
-  --zp-button-brand-hover-bg: #8b5cf6;
-  --zp-button-brand-active-bg: #6d28d9;
-  --zp-button-brand-text: #ffffff;
 }

package/dist/theme/styles/themes/arcade-fx.css

@@ -0,0 +1,360 @@
+/**
+ * Arcade theme — custom hover animations and visual effects.
+ *
+ * All rules are scoped to html[data-zp-theme='arcade'] so they
+ * only activate when the arcade palette is in use.
+ *
+ * Effects:
+ *   1. Border trace — conic-gradient that spins around cards on hover
+ *   2. Neon pulse  — expanding glow ring on buttons
+ *   3. CRT scanlines — subtle scrolling overlay on code blocks
+ *   4. Link glow — neon underline sweep on hover
+ *   5. Sidebar + navbar hover — neon underline sweep
+ *   6. Sidebar active glow bar
+ */
+
+/* ── @property for animatable gradient angle ─────────────── */
+@property --arcade-border-angle {
+  syntax: '<angle>';
+  initial-value: 0deg;
+  inherits: false;
+}
+
+/* ── 1. Border trace — cards ─────────────────────────────── */
+
+/*
+ * Uses a conic-gradient as the border-image source.
+ * The --arcade-border-angle custom property is animated from
+ * 0deg to 360deg, creating a neon light tracing the border.
+ *
+ * Requires position: relative and overflow: hidden on the card
+ * so the ::before pseudo-element stays within bounds.
+ */
+html[data-zp-theme='arcade'] .home-card,
+html[data-zp-theme='arcade'] .section-card {
+  position: relative;
+  overflow: hidden;
+  --arcade-border-angle: 0deg;
+}
+
+html[data-zp-theme='arcade'] .home-card::before,
+html[data-zp-theme='arcade'] .section-card::before {
+  content: '';
+  position: absolute;
+  inset: 0;
+  border-radius: inherit;
+  padding: 1px;
+  background: conic-gradient(
+    from var(--arcade-border-angle),
+    transparent 40%,
+    #00ff88 50%,
+    #00ffcc 55%,
+    transparent 60%
+  );
+  mask:
+    linear-gradient(#000 0 0) content-box,
+    linear-gradient(#000 0 0);
+  -webkit-mask-composite: xor;
+  mask-composite: exclude;
+  opacity: 0;
+  transition: opacity 0.3s;
+  pointer-events: none;
+  z-index: 1;
+}
+
+html[data-zp-theme='arcade'] .home-card:hover::before,
+html[data-zp-theme='arcade'] .section-card:hover::before {
+  opacity: 1;
+  animation: arcade-border-spin 2.5s linear infinite;
+}
+
+/* Glow shadow behind the card on hover */
+html[data-zp-theme='arcade'] .home-card:hover,
+html[data-zp-theme='arcade'] .section-card:hover {
+  box-shadow:
+    0 0 12px rgba(0, 255, 136, 0.15),
+    0 0 24px rgba(0, 255, 136, 0.06);
+}
+
+@keyframes arcade-border-spin {
+  to {
+    --arcade-border-angle: 360deg;
+  }
+}
+
+/* ── 2. Neon pulse — buttons ─────────────────────────────── */
+
+/*
+ * Replace the default gradient with a solid neon brand color,
+ * dark text for contrast, and a subtle border glow on hover.
+ */
+html[data-zp-theme='arcade'] .rp-button--brand {
+  background: #7c3aed;
+  color: #fff;
+  border: 1px solid #7c3aed;
+  opacity: 1;
+}
+
+html[data-zp-theme='arcade'] .rp-button--brand:hover {
+  background: transparent;
+  color: #a78bfa;
+  border-color: #a78bfa;
+  opacity: 1;
+  box-shadow:
+    0 0 8px rgba(124, 58, 237, 0.5),
+    inset 0 0 8px rgba(124, 58, 237, 0.15);
+}
+
+/*
+ * Alt button — outlined style with neon border.
+ */
+html[data-zp-theme='arcade'] .rp-button--alt {
+  background: transparent;
+  color: var(--zp-c-text-1);
+  border: 1px solid var(--zp-c-border);
+}
+
+html[data-zp-theme='arcade'] .rp-button--alt:hover {
+  border-color: #a78bfa;
+  color: #a78bfa;
+  opacity: 1;
+  background: transparent;
+  box-shadow:
+    0 0 8px rgba(124, 58, 237, 0.3),
+    inset 0 0 8px rgba(124, 58, 237, 0.06);
+}
+
+/*
+ * On hover, hero action buttons emit an expanding ring pulse
+ * using box-shadow animation. The ring fades out as it expands.
+ */
+html[data-zp-theme='arcade'] .rp-button--medium,
+html[data-zp-theme='arcade'] .rp-button--big {
+  transition:
+    background 0.2s,
+    box-shadow 0.2s,
+    transform 0.2s;
+}
+
+html[data-zp-theme='arcade'] .rp-button--medium:hover,
+html[data-zp-theme='arcade'] .rp-button--big:hover {
+  transform: scale(1.03);
+  animation: arcade-neon-pulse 1.4s ease-out infinite;
+}
+
+@keyframes arcade-neon-pulse {
+  0% {
+    box-shadow:
+      0 0 4px rgba(124, 58, 237, 0.6),
+      0 0 0 0 rgba(124, 58, 237, 0.4);
+  }
+  70% {
+    box-shadow:
+      0 0 8px rgba(124, 58, 237, 0.3),
+      0 0 0 12px rgba(124, 58, 237, 0);
+  }
+  100% {
+    box-shadow:
+      0 0 4px rgba(124, 58, 237, 0.6),
+      0 0 0 0 rgba(124, 58, 237, 0);
+  }
+}
+
+/* ── 3. CRT scanlines — code blocks ──────────────────────── */
+
+/*
+ * A repeating linear-gradient of thin semi-transparent lines
+ * scrolls slowly down code blocks, simulating a CRT monitor.
+ * pointer-events: none keeps the overlay non-interactive.
+ *
+ * Rspress wraps code blocks in .rp-codeblock which already
+ * has position: relative. The overlay targets .rp-codeblock__content
+ * (the inner container with the background color) so it sits
+ * above the code but below the title bar and button group.
+ */
+html[data-zp-theme='arcade'] .rp-codeblock__content {
+  position: relative;
+}
+
+html[data-zp-theme='arcade'] .rp-codeblock__content::after {
+  content: '';
+  position: absolute;
+  inset: 0;
+  background: repeating-linear-gradient(
+    to bottom,
+    transparent 0px,
+    transparent 3px,
+    rgba(0, 255, 136, 0.08) 3px,
+    rgba(0, 255, 136, 0.08) 4px
+  );
+  animation: arcade-scanline 8s linear infinite;
+  pointer-events: none;
+  z-index: 2;
+  opacity: 1;
+  transition: opacity 0.3s ease;
+}
+
+html[data-zp-theme='arcade'] .rp-codeblock:hover .rp-codeblock__content::after {
+  opacity: 0;
+}
+
+@keyframes arcade-scanline {
+  from {
+    background-position: 0 0;
+  }
+  to {
+    background-position: 0 200px;
+  }
+}
+
+/* ── 4. Link glow — neon underline sweep ─────────────────── */
+
+/*
+ * Content links get a neon underline that sweeps in from the
+ * left on hover, paired with a subtle text-shadow glow.
+ *
+ * Rspress uses a.rp-link for content links inside .rp-doc.
+ * Header anchors use .rp-header-anchor and are excluded.
+ */
+html[data-zp-theme='arcade'] .rp-doc a.rp-link:not(.rp-header-anchor) {
+  text-decoration: none;
+  background-image: linear-gradient(#00ff88, #00ff88);
+  background-size: 0% 1.5px;
+  background-position: 0 100%;
+  background-repeat: no-repeat;
+  transition:
+    background-size 0.3s ease,
+    text-shadow 0.3s ease;
+}
+
+html[data-zp-theme='arcade'] .rp-doc a.rp-link:not(.rp-header-anchor):hover {
+  background-size: 100% 1.5px;
+  border-bottom: none;
+  text-shadow:
+    0 0 6px rgba(0, 255, 136, 0.5),
+    0 0 12px rgba(0, 255, 136, 0.2);
+}
+
+/* ── 5. Sidebar + navbar link hover — neon underline sweep ── */
+
+/*
+ * Same sweep effect as doc content links, adapted for
+ * sidebar items (.rp-sidebar-item) and navbar menu items
+ * (.rp-nav-menu__item). Uses a background-image gradient
+ * that expands from 0% to 100% width on hover.
+ */
+html[data-zp-theme='arcade'] .rp-sidebar-item {
+  text-decoration: none;
+  background-image: linear-gradient(#00ff88, #00ff88);
+  background-size: 0% 1.5px;
+  background-position: 0 100%;
+  background-repeat: no-repeat;
+  transition:
+    color 0.15s,
+    background-color 0.15s,
+    background-size 0.3s ease,
+    text-shadow 0.3s ease;
+}
+
+html[data-zp-theme='arcade'] .rp-sidebar-item:hover {
+  background-size: 100% 1.5px;
+  text-shadow:
+    0 0 6px rgba(0, 255, 136, 0.5),
+    0 0 12px rgba(0, 255, 136, 0.2);
+}
+
+html[data-zp-theme='arcade'] .rp-nav-menu__item {
+  text-decoration: none;
+  background-image: linear-gradient(#00ff88, #00ff88);
+  background-size: 0% 1.5px;
+  background-position: 0 100%;
+  background-repeat: no-repeat;
+  transition:
+    color 0.25s,
+    background-size 0.3s ease,
+    text-shadow 0.3s ease;
+}
+
+html[data-zp-theme='arcade'] .rp-nav-menu__item:hover {
+  background-size: 100% 1.5px;
+  text-shadow:
+    0 0 6px rgba(0, 255, 136, 0.5),
+    0 0 12px rgba(0, 255, 136, 0.2);
+}
+
+/* ── 6. Sidebar active glow bar ──────────────────────────── */
+
+/*
+ * The active sidebar item gets a left-border glow that
+ * scales in vertically, simulating a neon indicator light.
+ *
+ * Rspress uses .rp-sidebar-item--active (BEM double hyphen).
+ * It already has position: relative. Uses ::after because
+ * ::before is used by Rspress for group-item line indicators.
+ */
+html[data-zp-theme='arcade'] .rp-sidebar-item--active {
+  overflow: visible;
+}
+
+html[data-zp-theme='arcade'] .rp-sidebar-item--active::after {
+  content: '';
+  position: absolute;
+  left: 0;
+  top: 50%;
+  width: 2px;
+  height: 0;
+  background: #00ff88;
+  box-shadow:
+    0 0 4px rgba(0, 255, 136, 0.8),
+    0 0 8px rgba(0, 255, 136, 0.4);
+  border-radius: 1px;
+  animation: arcade-glow-bar 0.3s ease-out forwards;
+}
+
+@keyframes arcade-glow-bar {
+  to {
+    height: 60%;
+    top: 20%;
+  }
+}
+
+/* ── 7. Search results — readable highlight ────────────── */
+
+/*
+ * The default search highlight uses --rp-c-brand (#00ff88)
+ * as a background, which is too bright for white text.
+ * Override to a darker green that maintains the neon feel
+ * while ensuring legibility.
+ */
+html[data-zp-theme='arcade'] .rp-suggest-item--current .rp-suggest-item__link {
+  background-color: #007a42;
+}
+
+html[data-zp-theme='arcade'] .rp-suggest-item__mark {
+  color: #00ff88;
+}
+
+html[data-zp-theme='arcade'] .rp-suggest-item--current .rp-suggest-item__mark {
+  color: #fff;
+}
+
+/* ── Reduced motion ──────────────────────────────────────── */
+
+/*
+ * Disable all continuous and hover-triggered animations when
+ * the user has opted into reduced motion.
+ */
+@media (prefers-reduced-motion: reduce) {
+  html[data-zp-theme='arcade'] .home-card:hover::before,
+  html[data-zp-theme='arcade'] .section-card:hover::before,
+  html[data-zp-theme='arcade'] .rp-codeblock__content::after,
+  html[data-zp-theme='arcade'] .rp-sidebar-item--active::after {
+    animation: none;
+  }
+
+  html[data-zp-theme='arcade'] .rp-button--medium:hover,
+  html[data-zp-theme='arcade'] .rp-button--big:hover {
+    animation: none;
+    transform: none;
+  }
+}

package/dist/theme/styles/themes/arcade.css

@@ -0,0 +1,96 @@
+/**
+ * Arcade theme — retro neon gaming palette.
+ *
+ * Vibrant neon green/cyan brand with deep indigo backgrounds.
+ * High-saturation, high-energy visual style.
+ */
+
+/* ── Light mode (deep indigo) ────────────────────────────── */
+html[data-zp-theme='arcade'] {
+  --zp-c-brand-1: #00ff88;
+  --zp-c-brand-2: #00cc6a;
+  --zp-c-brand-3: #00aa55;
+  --zp-c-brand-soft: rgba(0, 255, 136, 0.14);
+
+  --zp-c-bg: #0d0d1a;
+  --zp-c-bg-alt: #10102a;
+  --zp-c-bg-elv: #141433;
+  --zp-c-bg-soft: #18183d;
+  --zp-c-bg-icon: #2a2a55;
+
+  --zp-c-text-1: #e0ffe0;
+  --zp-c-text-2: rgba(224, 255, 224, 0.72);
+  --zp-c-text-3: rgba(224, 255, 224, 0.48);
+
+  --zp-c-divider: #1a1a40;
+  --zp-c-border: #252560;
+  --zp-c-gutter: #10102a;
+
+  --zp-code-block-bg: #10102a;
+
+  --zp-button-brand-bg: #00aa55;
+  --zp-button-brand-hover-bg: #00cc6a;
+  --zp-button-brand-active-bg: #008844;
+  --zp-button-brand-text: #0d0d1a;
+
+  --rp-c-brand: #00ff88;
+  --rp-c-brand-light: #66ffbb;
+  --rp-c-brand-lighter: #99ffcc;
+  --rp-c-brand-dark: #00cc6a;
+  --rp-c-brand-darker: #00aa55;
+  --rp-c-brand-tint: rgba(0, 255, 136, 0.14);
+
+  --rp-c-bg: #0d0d1a;
+  --rp-c-bg-soft: #18183d;
+  --rp-c-bg-mute: #141433;
+
+  --rp-c-text-1: #e0ffe0;
+  --rp-c-text-2: rgba(224, 255, 224, 0.72);
+  --rp-c-text-3: rgba(224, 255, 224, 0.48);
+
+  --rp-c-divider: #1a1a40;
+  --rp-c-link: var(--rp-c-brand-light);
+
+  --rp-code-block-bg: #10102a;
+
+  --rp-home-background-bg: #0d0d1a;
+}
+
+/* ── Dark mode (deeper indigo) ───────────────────────────── */
+html[data-zp-theme='arcade'].rp-dark {
+  --zp-c-bg: #080812;
+  --zp-c-bg-alt: #0a0a1a;
+  --zp-c-bg-elv: #0d0d22;
+  --zp-c-bg-soft: #10102a;
+  --zp-c-bg-icon: #222250;
+
+  --zp-c-text-1: #f0fff0;
+  --zp-c-text-2: rgba(240, 255, 240, 0.72);
+  --zp-c-text-3: rgba(240, 255, 240, 0.48);
+
+  --zp-c-divider: #141430;
+  --zp-c-border: #1e1e50;
+  --zp-c-gutter: #0a0a1a;
+
+  --zp-code-block-bg: #0a0a1a;
+
+  --zp-button-brand-bg: #00aa55;
+  --zp-button-brand-hover-bg: #00cc6a;
+  --zp-button-brand-active-bg: #008844;
+  --zp-button-brand-text: #080812;
+
+  --rp-c-bg: #080812;
+  --rp-c-bg-soft: #10102a;
+  --rp-c-bg-mute: #0d0d22;
+
+  --rp-c-text-1: #f0fff0;
+  --rp-c-text-2: rgba(240, 255, 240, 0.72);
+  --rp-c-text-3: rgba(240, 255, 240, 0.48);
+
+  --rp-c-divider: #141430;
+  --rp-c-link: var(--rp-c-brand-light);
+
+  --rp-code-block-bg: #0a0a1a;
+
+  --rp-home-background-bg: #080812;
+}