@veluai/velu 0.1.0

package/runtime/velu-ui/components/prompt.css

@@ -0,0 +1,99 @@
+/* Prompt — surface card with title, monospace truncated body, and a
+   solid accent "Copy Prompt" button. All values are tokens; light /
+   dark auto via [data-theme] since the surface, text, and accent vars
+   all switch. */
+
+.velu-prompt {
+  background: var(--surface-color);
+  border: var(--border-width) solid var(--border-color);
+  border-radius: var(--radius-md);
+  padding: var(--s2);
+  color: var(--text-color);
+}
+
+.velu-prompt__title {
+  font-size: var(--f-h4);
+  line-height: var(--lh-h4);
+  font-weight: var(--weight-medium);
+  margin-block-end: var(--s1);
+}
+
+/* Truncated multi-line body. white-space:pre-wrap preserves the
+   newlines / leading whitespace of the source prompt; -webkit-box +
+   -webkit-line-clamp adds the auto ellipsis on the Nth line. The
+   `lines` prop sets -webkit-line-clamp inline via React. */
+.velu-prompt__body {
+  margin: 0;
+  font-family: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);
+  font-size: var(--f-h6);
+  line-height: var(--lh-h6);
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  display: -webkit-box;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+/* Layout (flex + gap + justify-end) is provided by <Cluster>; this
+   rule only owns the spacing FROM the body above. */
+.velu-prompt__actions {
+  margin-block-start: var(--s1);
+}
+
+/* Accent-filled copy button — same visual weight as the CTA on Card,
+   sized to read as the row's primary action. Hover dims the accent
+   slightly via color-mix. */
+.velu-prompt__copy {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--s-2);
+  padding-block: var(--s-6);
+  padding-inline: var(--s-3);
+  background: var(--accent-color);
+  border: 0;
+  border-radius: var(--radius-sm);
+  color: #fff;
+  font: inherit;
+  font-size: var(--f-h6);
+  line-height: var(--lh-h6);
+  font-weight: var(--weight-medium);
+  cursor: pointer;
+}
+.velu-prompt__copy:hover {
+  background: color-mix(in srgb, var(--accent-color) 88%, #000);
+}
+.velu-prompt__copy:focus-visible {
+  outline: var(--border-width) solid var(--text-color);
+  outline-offset: 2px;
+}
+
+.velu-prompt__copy-icon {
+  display: inline-flex;
+  align-items: center;
+}
+
+/* Open in Cursor — same shape as copy, inverted neutral palette so it
+   reads as the secondary action sitting next to the accent primary.
+   Inherits the cursor brand glyph color via `currentColor`. */
+.velu-prompt__open-cursor {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--s-2);
+  padding-block: var(--s-6);
+  padding-inline: var(--s-3);
+  background: var(--text-color);
+  color: var(--page-bg);
+  border-radius: var(--radius-sm);
+  font: inherit;
+  font-size: var(--f-h6);
+  line-height: var(--lh-h6);
+  font-weight: var(--weight-medium);
+  text-decoration: none;
+}
+.velu-prompt__open-cursor:hover {
+  background: color-mix(in srgb, var(--text-color) 88%, var(--accent-color));
+}
+.velu-prompt__open-cursor:focus-visible {
+  outline: var(--border-width) solid var(--accent-color);
+  outline-offset: 2px;
+}

package/runtime/velu-ui/components/search.css

@@ -0,0 +1,307 @@
+/* Search — command-palette search. Ported from the Claude-Design "Velu
+   Search" handoff and retokenized: the design's surf/txt/bord layers
+   map onto velu-ui tokens, so it themes for free via [data-theme].
+     surf-page / surf-elevated   → --page-bg
+     surf-row-hover / kbd        → --surface-color
+     surf-row-selected           → accent tint
+     txt-1                       → --text-color
+     txt-2 / txt-3 / muted       → --muted-color
+     bord-*                      → --border-color
+     accent                      → --accent-color
+*/
+
+/* ── Shared kbd chip (⌘K trigger hint / esc / ↵) ────────────────────── */
+/* line-height: 1 so a tall glyph like ↵ doesn't stretch the chip;
+   justify-content centers single-character contents. */
+.velu-search__kbd {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex: none;
+  min-inline-size: var(--s0);
+  padding-block: var(--s-5);
+  padding-inline: var(--s-3);
+  background: var(--surface-color);
+  border: var(--border-width) solid var(--border-color);
+  border-radius: var(--radius-sm);
+  font-size: var(--f-h7);
+  line-height: 1;
+  font-weight: var(--weight-medium);
+  color: var(--text-color);
+}
+
+/* ── Trigger box (placed at the top of the page) ────────────────────── */
+/* Content-sized; the label's flex:1 only matters if the consumer gives
+   the trigger an explicit width. */
+.velu-search__trigger {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--s-3);
+  padding-block: var(--s-3);
+  padding-inline: var(--s-2);
+  background: var(--page-bg);
+  border: var(--border-width) solid var(--border-color);
+  border-radius: var(--radius-sm);
+  color: var(--muted-color);
+  font: inherit;
+  font-size: var(--f-h6);
+  cursor: pointer;
+  transition: border-color 0.12s ease;
+}
+.velu-search__trigger:hover {
+  border-color: var(--accent-color);
+}
+.velu-search__trigger-icon {
+  display: inline-flex;
+  flex: none;
+  color: var(--muted-color);
+}
+.velu-search__trigger-label {
+  flex: 1;
+  text-align: start;
+}
+
+/* ── Mobile collapse — trigger becomes icon-only ───────────────────── */
+/* At mobile widths (< 640px) the header is too crowded to show the
+   full search box; collapse to a magnifier icon. App.jsx passes
+   `inline-size: 30ch` inline on the trigger to fix its desktop width,
+   so we need !important here to win over the inline style. The kbd
+   chip is also hidden — at mobile there's no keyboard shortcut hint
+   to display. */
+@container docs (max-width: 640px) {
+  .velu-search__trigger {
+    inline-size: auto !important;
+    padding-inline: var(--s-3);
+  }
+  .velu-search__trigger-label,
+  .velu-search__trigger .velu-search__kbd {
+    display: none;
+  }
+}
+
+/* ── Scrim + palette ────────────────────────────────────────────────── */
+.velu-search__scrim {
+  position: fixed;
+  inset: 0;
+  z-index: 60;
+  display: flex;
+  align-items: flex-start;
+  justify-content: center;
+  /* Top offset eases down on short screens; side gutter is small so the
+     palette uses most of a narrow viewport (no effect on desktop —
+     the palette is capped at --vsearch-width there). */
+  padding-block-start: clamp(var(--s1), 8vh, 12vh);
+  padding-inline: var(--s-3);
+  background: color-mix(in srgb, #000 48%, transparent);
+  -webkit-backdrop-filter: blur(4px);
+  backdrop-filter: blur(4px);
+  animation: velu-search-scrim-in 0.18s ease-out;
+}
+@keyframes velu-search-scrim-in {
+  from { opacity: 0; }
+  to { opacity: 1; }
+}
+
+.velu-search__palette {
+  /* Overridable panel width (≈ the design's 720px). */
+  --vsearch-width: 45rem;
+  inline-size: var(--vsearch-width);
+  max-inline-size: 100%;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  background: var(--page-bg);
+  color: var(--text-color);
+  border: var(--border-width) solid var(--border-color);
+  border-radius: var(--radius-md);
+  box-shadow:
+    0 var(--s2) var(--s4) color-mix(in srgb, #000 32%, transparent),
+    0 var(--s0) var(--s2) color-mix(in srgb, #000 18%, transparent);
+  animation: velu-search-palette-in 0.22s cubic-bezier(0.2, 0.8, 0.2, 1);
+}
+@keyframes velu-search-palette-in {
+  from {
+    opacity: 0;
+    transform: translateY(calc(var(--s-3) * -1)) scale(0.985);
+  }
+  to {
+    opacity: 1;
+    transform: none;
+  }
+}
+/* base.css's global `* { max-width: 66ch }` would cap the <input>;
+   reset within the palette — flex / the panel govern width here. */
+.velu-search__palette * {
+  max-inline-size: none;
+}
+
+/* ── Input row ──────────────────────────────────────────────────────── */
+.velu-search__input-wrap {
+  display: flex;
+  align-items: center;
+  gap: var(--s-2);
+  padding: var(--s-1) var(--s0);
+  border-block-end: var(--border-width) solid var(--border-color);
+}
+.velu-search__input-icon {
+  display: inline-flex;
+  flex: none;
+  color: var(--muted-color);
+}
+.velu-search__input {
+  flex: 1 1 auto;
+  min-inline-size: 0;
+  padding: 0;
+  background: transparent;
+  border: 0;
+  outline: 0;
+  font: inherit;
+  font-size: var(--f-h4);
+  font-weight: var(--weight-light);
+  line-height: var(--lh-h4);
+  color: var(--text-color);
+}
+.velu-search__input::placeholder {
+  color: var(--muted-color);
+}
+
+/* ── Result list ────────────────────────────────────────────────────── */
+.velu-search__list {
+  flex: 1 1 auto;
+  overflow-y: auto;
+  padding: var(--s-3);
+  max-block-size: 72vh;
+}
+.velu-search__group {
+  padding: var(--s-1) var(--s-1) var(--s-4);
+  font-size: var(--f-h7);
+  font-weight: var(--weight-medium);
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--muted-color);
+}
+
+/* Result row — grid: glyph | (breadcrumb / title / desc) | meta. */
+.velu-search__row {
+  display: grid;
+  grid-template-columns: auto 1fr auto;
+  gap: var(--s-6) var(--s0);
+  align-items: center;
+  padding: var(--s-2);
+  border-radius: var(--radius-sm);
+  color: var(--text-color);
+  cursor: pointer;
+}
+.velu-search__row + .velu-search__row {
+  margin-block-start: var(--s-6);
+}
+.velu-search__row:hover {
+  background: var(--surface-color);
+}
+.velu-search__row--selected {
+  background: color-mix(in srgb, var(--accent-color) 12%, transparent);
+}
+
+.velu-search__row-glyph {
+  grid-column: 1;
+  grid-row: 1 / -1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  inline-size: 2.5em;
+  block-size: 2.5em;
+  color: var(--text-color);
+}
+.velu-search__glyph-hash {
+  font-size: var(--f-h3);
+  font-weight: var(--weight-light);
+  line-height: 1;
+  color: var(--text-color);
+}
+.velu-search__glyph-icon {
+  display: inline-flex;
+  inline-size: var(--icon-size-lg);
+  block-size: var(--icon-size-lg);
+  color: var(--muted-color);
+}
+.velu-search__row--selected .velu-search__glyph-icon {
+  color: var(--text-color);
+}
+
+.velu-search__crumbs {
+  grid-column: 2;
+  grid-row: 1;
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: var(--s-4);
+  font-size: var(--f-h6);
+  line-height: var(--lh-h6);
+  color: var(--muted-color);
+}
+.velu-search__crumb-sep {
+  opacity: 0.6;
+}
+.velu-search__row-title {
+  grid-column: 2;
+  grid-row: 2;
+  font-size: var(--f-h5);
+  font-weight: var(--weight-medium);
+  line-height: var(--lh-h5);
+  color: var(--text-color);
+}
+.velu-search__row-desc {
+  grid-column: 2;
+  grid-row: 3;
+  font-size: var(--f-h6);
+  font-weight: var(--weight-light);
+  line-height: var(--lh-h6);
+  color: var(--muted-color);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.velu-search__row-meta {
+  grid-column: 3;
+  grid-row: 1 / -1;
+  display: flex;
+  align-items: center;
+  opacity: 0;
+  transition: opacity 0.15s ease;
+}
+.velu-search__row:hover .velu-search__row-meta,
+.velu-search__row--selected .velu-search__row-meta {
+  opacity: 1;
+}
+
+/* ── Empty / no-results ─────────────────────────────────────────────── */
+.velu-search__empty {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: var(--s-6);
+  padding: var(--s3) var(--s0);
+  text-align: center;
+}
+.velu-search__empty-icon {
+  display: inline-flex;
+  margin-block-end: var(--s-3);
+  font-size: var(--f-h2);
+  color: var(--muted-color);
+}
+.velu-search__empty-title {
+  font-size: var(--f-h6);
+  font-weight: var(--weight-medium);
+  color: var(--text-color);
+}
+.velu-search__empty-sub {
+  font-size: var(--f-h6);
+  color: var(--muted-color);
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .velu-search__scrim,
+  .velu-search__palette {
+    animation: none;
+  }
+}

package/runtime/velu-ui/components/sidebar.css

@@ -0,0 +1,144 @@
+/* Sidebar — sidebar-specific styling ONLY.
+
+   Vertical rhythm (nav, section lists, nested sublists) is composed from the
+   Stack primitive in Sidebar.jsx (DRY) — Stack supplies display/flex/gap
+   inline. This file holds only what Stack cannot express: the indent rails,
+   active accent rail, the horizontal item rows, summary marker, chevron
+   rotation, and centralized icon sizing/stroke. All values are tokens. */
+
+.velu-sidebar {
+  border-left: var(--border-width) solid var(--surface-color);
+  margin-left: var(--s1);
+}
+
+.velu-sidebar__section {
+  /* Sticky section header: each heading pins to the top of the scroll
+     region until its own section scrolls past, then the next heading
+     takes over (iOS-list style). It sticks within its section wrapper
+     (Sidebar.jsx renders each section in its own Stack), which bounds
+     the push-out. Full-width opaque background so scrolling items
+     don't show behind it; --page-bg matches the surroundings, so the
+     bar is invisible until it's actually covering scrolled content. */
+  position: sticky;
+  inset-block-start: 0;
+  z-index: 1;
+  background: var(--page-bg);
+  display: flex;
+  align-items: center;
+  gap: var(--s-2);
+  padding-block: var(--s-4);
+  padding-inline: var(--s-3);
+  /* A notch smaller than the default h5, with a little tracking so the
+     uppercase label stays legible at the reduced size. */
+  font-size: var(--f-h6);
+  font-weight: 500;
+  letter-spacing: 0.02em;
+  text-transform: uppercase;
+}
+/* Fade zone just below the pinned heading: a gradient overlay
+   (page-bg → transparent) that sits directly under the sticky header
+   and scrolls with it. Items sliding up pass behind it and fade out
+   before they tuck under the (crisp) heading. Absolutely positioned
+   so it adds no resting layout space; pointer-events:none so it never
+   eats clicks. Hidden by default — only shown once the nav is actually
+   scrolled (the layout toggles it via data-fade-top on the scroll
+   region), so a section's first item isn't faded at rest. */
+.velu-sidebar__section::after {
+  content: '';
+  position: absolute;
+  inset-inline: 0;
+  inset-block-start: 100%;
+  block-size: var(--s3);
+  background: linear-gradient(
+    to bottom,
+    var(--page-bg),
+    color-mix(in srgb, var(--page-bg) 55%, transparent),
+    transparent
+  );
+  pointer-events: none;
+  opacity: 0;
+  transition: opacity 0.15s ease;
+}
+/* When a heading becomes the newly-pinned one (data-stuck set by the
+   runtime as you scroll past sections), fade + slide it in so the
+   handoff from the previous heading reads as a transition rather than
+   a hard swap. */
+.velu-sidebar__section[data-stuck='true'] {
+  animation: velu-sidebar-stick-in 0.2s ease;
+}
+@keyframes velu-sidebar-stick-in {
+  from {
+    opacity: 0.3;
+    transform: translateY(-0.2rem);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+/* Lists are Stacks (flex/gap come from Stack inline) — only reset list chrome. */
+.velu-sidebar__list,
+.velu-sidebar__sublist {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.velu-sidebar__sublist {
+  margin-left: var(--s0);
+  border-left: var(--border-width) solid var(--border-color);
+}
+
+/* Item rows are horizontal (icon · label · chevron) — Stack is vertical-only,
+   so these stay CSS until/if a Cluster/Inline primitive exists. */
+.velu-sidebar__item,
+.velu-sidebar__subitem {
+  display: flex;
+  align-items: center;
+  gap: var(--s-3);
+  padding-inline: var(--s0);
+  color: var(--text-color);
+  text-decoration: none;
+}
+
+.velu-sidebar__subitem {
+  padding-block: var(--s-5);
+}
+
+.velu-sidebar__item--active {
+  color: var(--accent-color);
+  border-left: 2px solid var(--accent-color);
+}
+
+.velu-sidebar__summary {
+  cursor: pointer;
+  list-style: none;
+}
+.velu-sidebar__summary::-webkit-details-marker {
+  display: none;
+}
+
+/* Icon sizing centralized here; stroke weight is the global --icon-stroke
+   token (.lucide rule in base.css), not set per-component. */
+.velu-sidebar__icon {
+  display: inline-flex;
+  flex: none;
+  inline-size: var(--f-body);
+  block-size: var(--f-body);
+}
+.velu-sidebar__icon svg {
+  inline-size: 100%;
+  block-size: 100%;
+}
+
+.velu-sidebar__chevron {
+  flex: none;
+  inline-size: var(--f-body);
+  block-size: var(--f-body);
+  transition: transform 0.15s ease;
+}
+
+details[open] > .velu-sidebar__summary .velu-sidebar__chevron {
+  transform: rotate(90deg);
+}

package/runtime/velu-ui/components/steps.css

@@ -0,0 +1,77 @@
+/* Steps — numbered procedural list with a continuous accent rail
+   running through every step's left margin. All values are tokens;
+   light/dark via [data-theme]. */
+
+.velu-steps {
+  display: block;
+}
+
+/* Each step is a 2-col / 2-row grid placed explicitly:
+
+     col 1               col 2
+   ┌──────────────────┬────────────────────┐
+   │ circle (row 1,   │ title  (row 1,     │
+   │ align-self: end) │ align-self: end)   │
+   ├──────────────────┼────────────────────┤
+   │ line (row 2,     │ body   (row 2)     │
+   │ 100% block-size) │                    │
+   └──────────────────┴────────────────────┘
+
+   `align-self: end` on both row-1 items puts the circle's bottom and
+   the title's bottom flush together — so an oversize circle no longer
+   hovers above the title. Row 1 height is whichever child is taller
+   (the circle). row-gap stays at 0 so the line touches the next step's
+   circle with no visible break in the rail. */
+.velu-step {
+  display: grid;
+  grid-template-columns: var(--step-circle, 2em) 1fr;
+  column-gap: var(--s0);
+  row-gap: 0;
+}
+
+.velu-step__circle {
+  grid-row: 1;
+  grid-column: 1;
+  align-self: center;
+  justify-self: center;
+  inline-size: var(--step-circle, 2em);
+  block-size: var(--step-circle, 2em);
+  border-radius: 50%;
+  background: var(--accent-color);
+  color: var(--page-bg);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  font-size: var(--f-h6);
+  line-height: 1;
+  font-weight: var(--weight-medium);
+}
+
+.velu-step__line {
+  grid-row: 2;
+  grid-column: 1;
+  justify-self: center;
+  inline-size: 2px;
+  block-size: 100%;
+  min-block-size: var(--s2);
+  background: var(--accent-color);
+}
+
+.velu-step__title {
+  grid-row: 1;
+  grid-column: 2;
+  align-self: center;
+  font-size: var(--f-h4);
+  line-height: var(--lh-h4);
+  font-weight: var(--weight-medium);
+  color: var(--text-color);
+}
+
+.velu-step__body {
+  grid-row: 2;
+  grid-column: 2;
+  padding-block: var(--s-1) var(--s2);
+  color: var(--text-color);
+  font-size: var(--f-body);
+  line-height: var(--lh-body);
+}

package/runtime/velu-ui/components/theme-toggle.css

@@ -0,0 +1,70 @@
+/* ThemeToggle — circular button with a sun/moon glyph; click flips
+   the theme. Geometry is a 32 × 32 circle with an 18 × 18 glyph
+   centred inside. The pill-with-slider design was replaced earlier;
+   only the circle survives now.
+
+   In light mode: --page-bg circle, sun glyph.
+   In dark mode:  --page-bg circle, moon glyph.
+
+   Visibility model: BOTH icons are always rendered, stacked at the
+   same `position: absolute` slot inside the button. Opacity controls
+   which one is visible. We use opacity (not display: none) because:
+
+     1. Stacked icons render at the exact same point — no layout
+        shift when the theme flips.
+     2. Opacity is not touched anywhere else for these elements, so
+        the cascade is trivial — no risk of a stray rule (preflight,
+        utility class, dev-time fallback) overriding `display: none`
+        and revealing the wrong icon.
+     3. Identical markup on server + client → SSR-safe, no hydration
+        mismatch and no icon flash.
+
+   All values are tokens. */
+
+.velu-theme-toggle {
+  /* `relative` so the absolutely-positioned icons inside are
+     anchored to this button, not the page. */
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  inline-size: 2rem;
+  block-size: 2rem;
+  border: var(--border-width) solid var(--border-color);
+  border-radius: 999px;
+  padding: 0;
+  background: var(--page-bg);
+  cursor: pointer;
+  transition: border-color 0.12s ease, background 0.12s ease;
+}
+.velu-theme-toggle:hover {
+  border-color: var(--accent-color);
+}
+
+/* Both icons stack here, centred. Default opacity 0 — the per-theme
+   rules below switch one on. */
+.velu-theme-toggle__icon {
+  position: absolute;
+  inset-block-start: 50%;
+  inset-inline-start: 50%;
+  inline-size: 1.125rem;
+  block-size: 1.125rem;
+  margin-block-start: -0.5625rem;     /* half of block-size */
+  margin-inline-start: -0.5625rem;    /* half of inline-size */
+  color: var(--text-color);
+  opacity: 0;
+  transition: opacity 0.2s ease;
+  pointer-events: none;
+}
+
+/* Default (light) → sun on. */
+.velu-theme-toggle__icon--sun {
+  opacity: 1;
+}
+/* Dark theme → moon on, sun off. */
+[data-theme='dark'] .velu-theme-toggle__icon--sun {
+  opacity: 0;
+}
+[data-theme='dark'] .velu-theme-toggle__icon--moon {
+  opacity: 1;
+}