@recallkit/web 0.1.1

package/src/styles/layout.css

@@ -0,0 +1,111 @@
+.page {
+  width: 100%;
+  max-width: 1120px;
+  margin: 0 auto;
+  padding: 56px 32px;
+}
+
+.page--narrow {
+  max-width: 720px;
+}
+
+.page--hero {
+  padding: 96px 32px 88px;
+  max-width: 980px;
+}
+
+.page-header {
+  display: flex;
+  align-items: flex-end;
+  justify-content: space-between;
+  gap: 24px;
+  margin-bottom: 36px;
+  flex-wrap: wrap;
+}
+
+.page-header__title {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.page-header__actions {
+  display: flex;
+  gap: 10px;
+  align-items: center;
+}
+
+.eyebrow {
+  display: inline-flex;
+  align-items: center;
+  gap: 7px;
+  font-family: var(--font-mono), ui-monospace, monospace;
+  font-size: 11px;
+  color: var(--accent);
+  letter-spacing: 0.04em;
+}
+
+.eyebrow__dot {
+  width: 6px;
+  height: 6px;
+  border-radius: 999px;
+  background: var(--accent);
+  box-shadow: 0 0 0 3px var(--accent-soft);
+}
+
+.h1 {
+  font-family: var(--font-display), var(--font-sans), sans-serif;
+  font-weight: 500;
+  font-size: 36px;
+  line-height: 1.05;
+  letter-spacing: -0.025em;
+  color: var(--ink);
+  margin: 0;
+}
+
+.h1--hero {
+  font-size: clamp(56px, 8vw, 88px);
+  line-height: 1.02;
+  letter-spacing: -0.035em;
+  max-width: 800px;
+}
+
+.h2 {
+  font-family: var(--font-display), var(--font-sans), sans-serif;
+  font-weight: 500;
+  font-size: 28px;
+  line-height: 1.1;
+  letter-spacing: -0.02em;
+  color: var(--ink);
+  margin: 0;
+}
+
+.lede {
+  font-size: 16px;
+  line-height: 1.55;
+  color: var(--text-muted);
+  margin: 0;
+  max-width: 560px;
+}
+
+.lede--hero {
+  font-size: 17px;
+}
+
+.body-dim {
+  font-size: 13.5px;
+  color: var(--text-dim);
+  margin: 0;
+}
+
+.accent-text {
+  color: var(--accent);
+}
+
+/* Keep the route shell full-width; .page owns content width. */
+.shell {
+  padding-top: 0;
+  padding-bottom: 0;
+  width: 100%;
+  max-width: none;
+}

package/src/styles/navigation.css

@@ -0,0 +1,121 @@
+.topnav {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 20px;
+  padding: 18px 28px;
+  border-bottom: 1px solid var(--border);
+  background: rgba(20, 20, 20, 0.7);
+  backdrop-filter: blur(6px);
+  position: sticky;
+  top: 0;
+  z-index: 10;
+}
+
+.topnav__brand {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  font-weight: 600;
+  font-size: 14px;
+  color: var(--ink);
+}
+
+.topnav__mark {
+  width: 32px;
+  height: 32px;
+  display: block;
+  image-rendering: pixelated;
+  image-rendering: crisp-edges;
+  object-fit: contain;
+}
+
+.topnav__links {
+  display: flex;
+  gap: 24px;
+  font-size: 13.5px;
+  margin-left: auto;
+}
+
+.topnav__links a {
+  color: var(--text-dim);
+  transition: color 0.15s ease;
+}
+
+.topnav__links a:hover {
+  color: var(--text);
+}
+
+.topnav__links a.is-active {
+  color: var(--ink);
+}
+
+.topnav__right {
+  display: flex;
+  justify-content: flex-end;
+  min-width: 0;
+}
+
+.wallet-nav {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  min-width: 0;
+}
+
+.wallet-nav__button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  min-height: 34px;
+  padding: 0 12px;
+  border: 1px solid var(--border-hover);
+  border-radius: 7px;
+  background: rgba(34, 34, 34, 0.82);
+  color: var(--text);
+  cursor: pointer;
+  font-family: var(--font-mono), ui-monospace, monospace;
+  font-size: 12px;
+  white-space: nowrap;
+  transition: border-color 0.12s ease, color 0.15s ease;
+}
+
+.wallet-nav__button:hover:not(:disabled) {
+  border-color: var(--text-dim);
+  color: var(--ink);
+}
+
+.wallet-nav__button:disabled {
+  opacity: 0.55;
+  cursor: not-allowed;
+}
+
+.wallet-nav__dot {
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: var(--accent);
+  box-shadow: 0 0 12px rgba(110, 231, 183, 0.6);
+}
+
+.wallet-nav__dot--off {
+  background: var(--text-faint);
+  box-shadow: none;
+}
+
+.wallet-nav__balance {
+  font-family: var(--font-mono), ui-monospace, monospace;
+  font-size: 11px;
+  color: var(--text-dim);
+  white-space: nowrap;
+}
+
+.wallet-nav__error {
+  max-width: 220px;
+  overflow: hidden;
+  color: var(--danger);
+  font-size: 12px;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}

package/src/styles/overlays.css

@@ -0,0 +1,65 @@
+.modal-v2-backdrop {
+  position: fixed;
+  inset: 0;
+  display: grid;
+  place-items: center;
+  padding: 20px;
+  background: rgba(0, 0, 0, 0.6);
+  backdrop-filter: blur(4px);
+  z-index: 50;
+}
+
+.modal-v2 {
+  width: min(560px, calc(100vw - 40px));
+  max-height: calc(100dvh - 40px);
+  overflow: auto;
+  background: var(--surface);
+  border: 1px solid var(--border-hover);
+  border-radius: 12px;
+  box-shadow: 0 30px 80px rgba(0, 0, 0, 0.6);
+  display: flex;
+  flex-direction: column;
+}
+
+.modal-v2__head {
+  padding: 22px 26px 16px;
+  border-bottom: 1px solid var(--border);
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  gap: 16px;
+}
+
+.modal-v2__title {
+  font-family: var(--font-display), var(--font-sans), sans-serif;
+  font-size: 22px;
+  font-weight: 500;
+  color: var(--ink);
+  letter-spacing: -0.015em;
+  margin: 0;
+}
+
+.modal-v2__close {
+  background: transparent;
+  border: none;
+  color: var(--text-dim);
+  cursor: pointer;
+  padding: 4px;
+}
+
+.modal-v2__close:hover {
+  color: var(--ink);
+}
+
+.modal-v2__body {
+  padding: 20px 26px;
+}
+
+.modal-v2__foot {
+  padding: 16px 26px;
+  border-top: 1px solid var(--border);
+  display: flex;
+  justify-content: flex-end;
+  gap: 10px;
+  background: var(--bg);
+}

package/src/styles/tokens.css

@@ -0,0 +1,26 @@
+:root {
+  /* Surfaces */
+  --bg: #141414;
+  --surface: #1a1a1a;
+  --surface-2: #181d1b;
+
+  /* Borders */
+  --border: #242424;
+  --border-strong: #2c2c2c;
+  --border-hover: #383838;
+
+  /* Text */
+  --ink: #fafafa;
+  --text: #e5e5e5;
+  --text-muted: #a3a3a3;
+  --text-dim: #737373;
+  --text-faint: #525252;
+
+  /* Accent */
+  --accent: #6ee7b7;
+  --accent-hover: #5ee0aa;
+  --accent-soft: rgba(110, 231, 183, 0.08);
+
+  /* Signals */
+  --danger: #f87171;
+}

package/src/styles/utilities.css

@@ -0,0 +1,358 @@
+.bar {
+  display: inline-block;
+  width: 36px;
+  height: 4px;
+  border-radius: 2px;
+  background: rgba(255, 255, 255, 0.08);
+  position: relative;
+  vertical-align: middle;
+  overflow: hidden;
+}
+
+.bar__fill {
+  display: block;
+  height: 100%;
+  background: var(--accent);
+  border-radius: 2px;
+}
+
+.bar--dim .bar__fill {
+  background: var(--text-muted);
+}
+
+.copy-value {
+  display: inline-flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 8px;
+  background: transparent;
+  border: none;
+  cursor: pointer;
+  font: inherit;
+  font-family: var(--font-mono), ui-monospace, monospace;
+  color: var(--text-muted);
+  padding: 0;
+  text-align: right;
+  overflow-wrap: anywhere;
+  min-width: 0;
+  max-width: 100%;
+}
+
+.copy-value__icon {
+  display: inline-flex;
+  flex-shrink: 0;
+  color: var(--text-faint);
+  transition: color 0.15s ease;
+}
+
+.copy-value__text {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.copy-value:hover .copy-value__icon,
+.copy-value--copied .copy-value__icon {
+  color: var(--accent);
+}
+
+.spinner {
+  display: inline-block;
+  width: 12px;
+  height: 12px;
+  border: 1.5px solid currentColor;
+  border-top-color: transparent;
+  border-radius: 50%;
+  animation: spinner-rotate 0.7s linear infinite;
+}
+
+@keyframes spinner-rotate {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+.snippet {
+  display: block;
+  padding: 12px 14px;
+  border: 1px solid var(--border-strong);
+  border-radius: 8px;
+  background: rgba(30, 30, 30, 0.65);
+  font-family: var(--font-mono), ui-monospace, monospace;
+  font-size: 12.5px;
+  color: var(--text);
+  overflow-wrap: anywhere;
+  margin: 12px 0 0;
+}
+
+.snippet__prompt {
+  color: var(--text-faint);
+  user-select: none;
+  margin-right: 8px;
+}
+
+.meta {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 10px;
+  margin-top: 10px;
+  font-family: var(--font-mono), ui-monospace, monospace;
+  font-size: 11px;
+  color: var(--text-dim);
+}
+
+.meta__sep {
+  color: var(--text-faint);
+}
+
+.meta__kind {
+  color: var(--accent);
+}
+
+.row-actions {
+  display: flex;
+  gap: 6px;
+  align-self: flex-start;
+  opacity: 0;
+  transition: opacity 0.15s ease;
+}
+
+.list__row:hover .row-actions,
+.list__row.is-selected .row-actions,
+.row-actions.is-visible {
+  opacity: 1;
+}
+
+.row-action {
+  padding: 6px 10px;
+  background: transparent;
+  border: 1px solid var(--border-hover);
+  color: var(--text-muted);
+  border-radius: 6px;
+  font-size: 12px;
+  cursor: pointer;
+  transition: color 0.15s ease, border-color 0.12s ease;
+  font-family: var(--font-sans), sans-serif;
+}
+
+.row-action:hover {
+  color: var(--ink);
+  border-color: var(--text-dim);
+}
+
+.row-action--danger:hover {
+  color: var(--danger);
+  border-color: var(--danger);
+}
+
+.status-pill {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  width: max-content;
+  min-width: max-content;
+  padding: 3px 10px;
+  border-radius: 999px;
+  font-family: var(--font-mono), ui-monospace, monospace;
+  font-size: 11px;
+  color: var(--accent);
+  background: var(--accent-soft);
+  white-space: nowrap;
+}
+
+.status-pill::before {
+  content: "";
+  flex: 0 0 auto;
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: var(--accent);
+}
+
+.status-pill--warn {
+  color: #fbbf24;
+  background: rgba(251, 191, 36, 0.08);
+}
+
+.status-pill--warn::before {
+  background: #fbbf24;
+}
+
+.status-pill--off {
+  color: var(--text-dim);
+  background: transparent;
+  border: 1px solid var(--border-hover);
+}
+
+.status-pill--off::before {
+  background: var(--text-dim);
+}
+
+.settings-group {
+  border: 1px solid var(--border-strong);
+  border-radius: 10px;
+  margin-bottom: 16px;
+  background: rgba(30, 30, 30, 0.5);
+  backdrop-filter: blur(2px);
+}
+
+.settings-group__head {
+  padding: 16px 20px;
+  border-bottom: 1px solid var(--border-strong);
+  font-family: var(--font-mono), ui-monospace, monospace;
+  font-size: 11px;
+  color: var(--text-dim);
+  letter-spacing: 0.04em;
+}
+
+.settings-row {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) minmax(180px, max-content);
+  align-items: center;
+  justify-content: space-between;
+  padding: 16px 20px;
+  border-bottom: 1px solid var(--border);
+  gap: 24px;
+}
+
+.settings-row:last-child {
+  border-bottom: none;
+}
+
+.settings-row__label {
+  font-size: 13.5px;
+  color: var(--text);
+}
+
+.settings-row__hint {
+  font-size: 12px;
+  color: var(--text-dim);
+  margin-top: 2px;
+  max-width: 34rem;
+}
+
+.settings-row__value {
+  font-family: var(--font-mono), ui-monospace, monospace;
+  font-size: 12.5px;
+  color: var(--text-muted);
+  text-align: right;
+  overflow-wrap: anywhere;
+  min-width: 0;
+  justify-self: end;
+}
+
+.settings-row > .copy-value,
+.settings-row > .status-pill {
+  justify-self: end;
+}
+
+.summary-row {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 10px 0;
+  border-bottom: 1px solid var(--border);
+  font-size: 13px;
+  gap: 16px;
+}
+
+.summary-row:last-child {
+  border-bottom: none;
+}
+
+.summary-row__label {
+  color: var(--text-dim);
+}
+
+.summary-row__value {
+  color: var(--text);
+  font-family: var(--font-mono), ui-monospace, monospace;
+  font-size: 12px;
+  text-align: right;
+  overflow-wrap: anywhere;
+}
+
+.summary-row__value--accent {
+  color: var(--accent);
+}
+
+.error-v2 {
+  margin-top: 12px;
+  padding: 10px 14px;
+  border-radius: 7px;
+  background: rgba(248, 113, 113, 0.08);
+  border: 1px solid rgba(248, 113, 113, 0.3);
+  color: #fca5a5;
+  font-size: 13px;
+}
+
+.v-stack {
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+}
+
+.v-stack--lg {
+  gap: 28px;
+}
+
+.v-row {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+
+.v-row--between {
+  justify-content: space-between;
+}
+
+@media (max-width: 800px) {
+  .topnav {
+    align-items: flex-start;
+    flex-wrap: wrap;
+    padding: 16px 20px;
+  }
+
+  .topnav__links {
+    order: 3;
+    width: 100%;
+    gap: 18px;
+    margin-left: 0;
+  }
+
+  .topnav__right {
+    margin-left: auto;
+  }
+
+  .wallet-nav__balance,
+  .wallet-nav__error {
+    display: none;
+  }
+
+  .stat-grid {
+    grid-template-columns: repeat(2, 1fr);
+  }
+
+  .stat-grid__cell:nth-child(2) {
+    border-right: none;
+  }
+
+  .stat-grid__cell:nth-child(1),
+  .stat-grid__cell:nth-child(2) {
+    border-bottom: 1px solid var(--border-strong);
+  }
+
+  .settings-row {
+    grid-template-columns: 1fr;
+    gap: 10px;
+  }
+
+  .settings-row__value,
+  .settings-row .copy-value {
+    justify-self: start;
+    text-align: left;
+  }
+}

package/src/utils/errors.ts

@@ -0,0 +1,5 @@
+export function readError(error: unknown, fallback = "Something went wrong."): string {
+  if (error instanceof Error && error.message) return error.message;
+  if (typeof error === "string" && error.length > 0) return error;
+  return fallback;
+}

package/src/utils/format.ts

@@ -0,0 +1,37 @@
+export function shortAddress(address: string): string {
+  return `${address.slice(0, 6)}...${address.slice(-4)}`;
+}
+
+export function percent(value: number): number {
+  return Math.round(value * 100);
+}
+
+export function formatTimeAgo(iso: string, now: Date = new Date()): string {
+  const then = new Date(iso).getTime();
+  if (Number.isNaN(then)) return "";
+  const diff = Math.max(0, now.getTime() - then);
+  const sec = Math.round(diff / 1000);
+  if (sec < 45) return "just now";
+  const min = Math.round(sec / 60);
+  if (min < 60) return `${min}m ago`;
+  const hr = Math.round(min / 60);
+  if (hr < 24) return `${hr}h ago`;
+  const day = Math.round(hr / 24);
+  if (day < 30) return `${day}d ago`;
+  const mo = Math.round(day / 30);
+  if (mo < 12) return `${mo}mo ago`;
+  const yr = Math.round(mo / 12);
+  return `${yr}y ago`;
+}
+
+export function formatScopeLabel(scope: {
+  level?: string;
+  projectId?: string;
+  workspaceId?: string;
+  repoPath?: string;
+}): string {
+  const level = scope.level ?? (scope.projectId ? "project" : "global");
+  const detail = scope.projectId ?? scope.repoPath ?? scope.workspaceId;
+  const label = level === "project" ? "Project" : level === "session" ? "Session" : "Global";
+  return detail ? `${label} · ${detail}` : label;
+}