prev-cli 0.24.20 → 0.25.0

package/src/theme/storage.ts

@@ -0,0 +1,71 @@
+export interface StorageAdapter {
+  get<T>(key: string): T | null
+  set<T>(key: string, value: T): void
+  remove(key: string): void
+  list(prefix: string): string[]
+  clear(prefix: string): void
+}
+
+interface StorageBackend {
+  getItem(key: string): string | null
+  setItem(key: string, value: string): void
+  removeItem(key: string): void
+  key(index: number): string | null
+  readonly length: number
+}
+
+export class PrefixedStorageAdapter implements StorageAdapter {
+  constructor(
+    private backend: StorageBackend,
+    private prefix = 'prev:',
+  ) {}
+
+  get<T>(key: string): T | null {
+    try {
+      const raw = this.backend.getItem(this.prefix + key)
+      return raw ? JSON.parse(raw) : null
+    } catch {
+      return null
+    }
+  }
+
+  set<T>(key: string, value: T): void {
+    try {
+      this.backend.setItem(this.prefix + key, JSON.stringify(value))
+    } catch {
+      // Silently ignore quota errors
+    }
+  }
+
+  remove(key: string): void {
+    this.backend.removeItem(this.prefix + key)
+  }
+
+  list(prefix: string): string[] {
+    const fullPrefix = this.prefix + prefix
+    const keys: string[] = []
+    for (let i = 0; i < this.backend.length; i++) {
+      const key = this.backend.key(i)
+      if (key?.startsWith(fullPrefix)) {
+        keys.push(key.slice(this.prefix.length))
+      }
+    }
+    return keys
+  }
+
+  clear(prefix: string): void {
+    this.list(prefix).forEach(k => this.remove(k))
+  }
+}
+
+// Default singleton using localStorage (browser environment)
+export const storage: StorageAdapter = typeof localStorage !== 'undefined'
+  ? new PrefixedStorageAdapter(localStorage)
+  : new PrefixedStorageAdapter({
+      // No-op fallback for SSR/non-browser
+      getItem: () => null,
+      setItem: () => {},
+      removeItem: () => {},
+      key: () => null,
+      length: 0,
+    })

package/src/theme/styles.css

@@ -606,18 +606,25 @@ body {
 
 /* Preview detail page - full available space */
 .preview-detail-page {
+  display: flex;
+  flex-direction: column;
   height: calc(100vh - 4rem);
   padding: 0;
   margin: -2rem; /* Negate parent padding */
   margin-bottom: 3rem; /* Space for toolbar */
-}
-
-.preview-detail-page > div {
-  height: 100%;
   border-radius: 0;
   overflow: hidden;
 }
 
+.preview-detail-page > .preview-state-selector {
+  flex-shrink: 0;
+}
+
+.preview-detail-page > div:last-child {
+  flex: 1;
+  min-height: 0;
+}
+
 @media (min-width: 769px) {
   .preview-detail-page {
     margin: -2rem;
@@ -626,7 +633,7 @@ body {
     padding: 1rem;
   }
 
-  .preview-detail-page > div {
+  .preview-detail-page > div:last-child {
     border-radius: 12px;
     border: 1px solid var(--fd-border);
     box-shadow: 0 4px 24px rgba(0, 0, 0, 0.08);
@@ -638,7 +645,7 @@ body {
    =========================================== */
 
 .previews-catalog {
-  padding: 16px;
+  padding: 12px;
 }
 
 @media (min-width: 640px) {
@@ -647,28 +654,236 @@ body {
   }
 }
 
-.previews-grid {
-  display: grid;
-  grid-template-columns: 1fr;
-  gap: 16px;
+/* Catalog Header */
+.catalog-header {
+  margin-bottom: 16px;
 }
 
-@media (min-width: 480px) {
-  .previews-grid {
-    grid-template-columns: repeat(2, 1fr);
+@media (min-width: 640px) {
+  .catalog-header {
+    margin-bottom: 32px;
   }
 }
 
-@media (min-width: 768px) {
-  .previews-grid {
-    grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
-    gap: 20px;
+.catalog-title {
+  font-size: 20px;
+  font-weight: bold;
+  margin: 0 0 4px 0;
+}
+
+@media (min-width: 640px) {
+  .catalog-title {
+    font-size: 28px;
+    margin-bottom: 8px;
+  }
+}
+
+.catalog-subtitle {
+  font-size: 13px;
+  color: var(--fd-muted-foreground);
+  margin: 0;
+}
+
+@media (min-width: 640px) {
+  .catalog-subtitle {
+    font-size: 16px;
+  }
+}
+
+/* Catalog Tip - hidden on mobile */
+.catalog-tip {
+  display: none;
+  margin-top: 32px;
+  padding: 14px 16px;
+  background-color: var(--fd-muted);
+  border: 1px solid var(--fd-border);
+  border-radius: 10px;
+}
+
+@media (min-width: 640px) {
+  .catalog-tip {
+    display: block;
+  }
+}
+
+.catalog-tip p {
+  margin: 0;
+  font-size: 14px;
+  color: var(--fd-muted-foreground);
+}
+
+.catalog-tip strong {
+  color: var(--fd-foreground);
+}
+
+.catalog-tip code {
+  background-color: var(--fd-accent);
+  padding: 2px 6px;
+  border-radius: 4px;
+  font-family: var(--fd-font-mono);
+}
+
+/* Category Section */
+.category-section {
+  margin-bottom: 24px;
+}
+
+@media (min-width: 640px) {
+  .category-section {
+    margin-bottom: 32px;
+  }
+}
+
+.category-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 12px;
+  padding-bottom: 8px;
+  border-bottom: 1px solid var(--fd-border);
+}
+
+@media (min-width: 640px) {
+  .category-header {
+    gap: 10px;
+    margin-bottom: 16px;
+    padding-bottom: 12px;
+  }
+}
+
+.category-icon {
+  font-size: 16px;
+  flex-shrink: 0;
+}
+
+@media (min-width: 640px) {
+  .category-icon {
+    font-size: 20px;
+  }
+}
+
+.category-info {
+  flex: 1;
+  min-width: 0;
+}
+
+.category-title {
+  font-size: 14px;
+  font-weight: 600;
+  margin: 0;
+  color: var(--fd-foreground);
+}
+
+@media (min-width: 640px) {
+  .category-title {
+    font-size: 18px;
+  }
+}
+
+.category-count {
+  margin-left: 6px;
+  font-size: 12px;
+  font-weight: 400;
+  color: var(--fd-muted-foreground);
+}
+
+@media (min-width: 640px) {
+  .category-count {
+    margin-left: 8px;
+    font-size: 14px;
+  }
+}
+
+.category-description {
+  display: none;
+  font-size: 13px;
+  color: var(--fd-muted-foreground);
+  margin: 0;
+}
+
+@media (min-width: 640px) {
+  .category-description {
+    display: block;
+  }
+}
+
+/* Category Navigation Buttons */
+.category-nav {
+  display: flex;
+  gap: 4px;
+  flex-shrink: 0;
+}
+
+.category-nav-btn {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 28px;
+  height: 28px;
+  border: 1px solid var(--fd-border);
+  border-radius: 6px;
+  background: var(--fd-background);
+  color: var(--fd-muted-foreground);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+@media (min-width: 640px) {
+  .category-nav-btn {
+    width: 32px;
+    height: 32px;
   }
 }
 
+.category-nav-btn:hover {
+  background: var(--fd-muted);
+  color: var(--fd-foreground);
+  border-color: var(--fd-foreground);
+}
+
+.category-nav-btn:active {
+  transform: scale(0.95);
+}
+
+/* Horizontal carousel for preview cards */
+.previews-grid {
+  display: flex;
+  gap: 16px;
+  overflow-x: auto;
+  overflow-y: hidden;
+  scroll-snap-type: x mandatory;
+  scroll-behavior: smooth;
+  padding-bottom: 8px;
+  margin: 0 -16px;
+  padding-left: 16px;
+  padding-right: 16px;
+  /* Hide scrollbar but keep functionality */
+  scrollbar-width: thin;
+  scrollbar-color: var(--fd-border) transparent;
+}
+
+.previews-grid::-webkit-scrollbar {
+  height: 6px;
+}
+
+.previews-grid::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+.previews-grid::-webkit-scrollbar-thumb {
+  background-color: var(--fd-border);
+  border-radius: 3px;
+}
+
+.previews-grid::-webkit-scrollbar-thumb:hover {
+  background-color: var(--fd-muted-foreground);
+}
+
 /* Preview card enhancements */
 .previews-grid a {
   display: block;
+  flex: 0 0 260px;
+  scroll-snap-align: start;
   border: 1px solid var(--fd-border);
   border-radius: 12px;
   overflow: hidden;
@@ -678,6 +893,12 @@ body {
   transition: box-shadow 0.2s ease, transform 0.2s ease, border-color 0.2s ease;
 }
 
+@media (min-width: 768px) {
+  .previews-grid a {
+    flex: 0 0 280px;
+  }
+}
+
 .previews-grid a:hover {
   box-shadow: 0 8px 24px rgba(0, 0, 0, 0.1);
   transform: translateY(-2px);
@@ -690,22 +911,16 @@ body {
 
 /* Preview Card Component Styles */
 .preview-card-thumbnail {
-  height: 140px;
+  height: 120px;
   overflow: hidden;
   position: relative;
   background-color: var(--fd-muted);
   pointer-events: none;
 }
 
-@media (min-width: 480px) {
-  .preview-card-thumbnail {
-    height: 160px;
-  }
-}
-
 @media (min-width: 768px) {
   .preview-card-thumbnail {
-    height: 180px;
+    height: 140px;
   }
 }
 
@@ -774,6 +989,62 @@ body {
   font-family: var(--fd-font-mono);
 }
 
+/* ===========================================
+   Preview State Selector
+   =========================================== */
+
+.preview-state-selector {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 12px 16px;
+  background-color: var(--fd-card);
+  border-bottom: 1px solid var(--fd-border);
+}
+
+.preview-state-label {
+  font-size: 12px;
+  font-weight: 600;
+  color: var(--fd-muted-foreground);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.preview-state-buttons {
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  gap: 4px;
+  background-color: var(--fd-muted);
+  border-radius: 8px;
+  padding: 4px;
+}
+
+.preview-state-btn {
+  padding: 6px 12px;
+  font-size: 13px;
+  font-weight: 400;
+  border: none;
+  border-radius: 6px;
+  cursor: pointer;
+  background-color: transparent;
+  color: var(--fd-muted-foreground);
+  transition: all 0.15s ease;
+  text-transform: capitalize;
+}
+
+.preview-state-btn:hover {
+  background-color: var(--fd-background);
+  color: var(--fd-foreground);
+}
+
+.preview-state-btn.active {
+  font-weight: 600;
+  background-color: var(--fd-background);
+  color: var(--fd-foreground);
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
+}
+
 /* ===========================================
    Dead Link Warning (Dev Mode Only)
    =========================================== */

package/src/theme/types.ts

@@ -0,0 +1,64 @@
+// === Annotations ===
+export type AnnotationCategory = 'bug' | 'copy' | 'design' | 'general'
+
+export interface Annotation {
+  id: string
+  previewName: string
+  stateOrStep: string
+  x: number // % relative to iframe width
+  y: number // % relative to iframe height
+  category: AnnotationCategory
+  resolved: boolean
+  createdAt: string
+  comments: AnnotationComment[]
+}
+
+export interface AnnotationComment {
+  id: string
+  author: string
+  text: string
+  createdAt: string
+}
+
+// === Snapshots ===
+export interface Snapshot {
+  id: string
+  previewName: string
+  stateOrStep: string
+  viewport: string
+  screenshotDataUrl: string
+  createdAt: string
+  label?: string
+}
+
+// === Status / Approval ===
+export type ApprovalStatus = 'draft' | 'in-review' | 'approved' | 'needs-changes'
+
+export interface StatusEntry {
+  previewName: string
+  status: ApprovalStatus
+  updatedAt: string
+  updatedBy: string
+}
+
+export interface AuditLogEntry {
+  previewName: string
+  from: ApprovalStatus
+  to: ApprovalStatus
+  changedBy: string
+  changedAt: string
+}
+
+// === Token Overrides ===
+export interface TokenOverride {
+  category: string
+  name: string
+  originalValue: string
+  overrideValue: string
+}
+
+// === User Identity (mock) ===
+export interface UserIdentity {
+  name: string
+  avatar?: string
+}

package/src/tokens/CLAUDE.md

@@ -0,0 +1,16 @@
+<!-- c3-generated: c3-701, c3-702, c3-703 -->
+# c3-7: Tokens
+
+Before modifying this code, read:
+- `.c3/c3-7-tokens/c3-701-resolver.md` - Token resolution (TokensConfig, resolveTokens)
+- `.c3/c3-7-tokens/c3-702-defaults.md` - Default shadcn token values
+- `.c3/c3-7-tokens/c3-703-validation.md` - Token validation with suggestions
+
+Token categories: `colors`, `backgrounds`, `spacing`, `typography.sizes`, `typography.weights`, `radius`, `shadows`
+
+Key files:
+- `resolver.ts` - `resolveTokens()`, `TokensConfig`, `PartialTokensConfig`
+- `defaults.ts` - `DEFAULT_TOKENS`
+- `validation.ts` - `validateToken()`, `isValidToken()`, `ValidationError`
+- `utils.ts` - `mergeTokenConfigs()`, `levenshtein()`
+<!-- end-c3-generated -->

package/src/tokens/resolver.ts

@@ -125,7 +125,7 @@ function loadPartialTokens(filePath: string): PartialTokensConfig {
 export function resolveTokens(options: ResolveTokensOptions = {}): TokensConfig {
   const { userTokens, defaultsPath } = options
 
-  // Check for user tokens path from Vite plugin or options
+  // Check for user tokens path from build plugin or options
   let userTokensPath = options.userTokensPath
   if (!userTokensPath && typeof globalThis !== 'undefined') {
     userTokensPath = (globalThis as any).__PREV_USER_TOKENS_PATH

package/dist/preview-runtime/vendors.d.ts

@@ -1,6 +0,0 @@
-export interface VendorBundleResult {
-    success: boolean;
-    code: string;
-    error?: string;
-}
-export declare function buildVendorBundle(): Promise<VendorBundleResult>;

package/dist/vite/config-parser.d.ts

@@ -1,13 +0,0 @@
-import { type PreviewConfig, type FlowDefinition, type AtlasDefinition } from './preview-types';
-/**
- * Parse a config.yaml or config.yml file and validate against schema
- */
-export declare function parsePreviewConfig(filePath: string): Promise<PreviewConfig | null>;
-/**
- * Parse a flow index.yaml file
- */
-export declare function parseFlowDefinition(filePath: string): Promise<FlowDefinition | null>;
-/**
- * Parse an atlas index.yaml file
- */
-export declare function parseAtlasDefinition(filePath: string): Promise<AtlasDefinition | null>;

package/dist/vite/config.d.ts

@@ -1,12 +0,0 @@
-import type { InlineConfig } from 'vite';
-import { getDebugCollector } from '../utils/debug';
-export { getDebugCollector };
-export interface ConfigOptions {
-    rootDir: string;
-    mode: 'development' | 'production';
-    port?: number;
-    include?: string[];
-    base?: string;
-    debug?: boolean;
-}
-export declare function createViteConfig(options: ConfigOptions): Promise<InlineConfig>;

package/dist/vite/plugins/config-plugin.d.ts

@@ -1,3 +0,0 @@
-import type { Plugin } from 'vite';
-import type { PrevConfig } from '../../config';
-export declare function createConfigPlugin(config: PrevConfig): Plugin;

package/dist/vite/plugins/debug-plugin.d.ts

@@ -1,3 +0,0 @@
-import type { Plugin } from 'vite';
-import { DebugCollector } from '../../utils/debug';
-export declare function debugPlugin(collector: DebugCollector): Plugin;

package/dist/vite/plugins/entry-plugin.d.ts

@@ -1,2 +0,0 @@
-import type { Plugin } from 'vite';
-export declare function entryPlugin(rootDir?: string): Plugin;

package/dist/vite/plugins/fumadocs-plugin.d.ts

@@ -1,9 +0,0 @@
-import type { Plugin } from 'vite';
-/**
- * Vite plugin to resolve fumadocs subpath exports.
- *
- * Fumadocs uses Node.js subpath exports which Vite's esbuild pre-bundler
- * can't resolve when packages are in CLI's node_modules (not user's project).
- * This plugin uses resolveId hook to dynamically resolve imports to dist files.
- */
-export declare function fumadocsPlugin(nodeModulesPath: string): Plugin;

package/dist/vite/plugins/pages-plugin.d.ts

@@ -1,5 +0,0 @@
-import type { Plugin } from 'vite';
-export interface PagesPluginOptions {
-    include?: string[];
-}
-export declare function pagesPlugin(rootDir: string, options?: PagesPluginOptions): Plugin;

package/dist/vite/plugins/previews-plugin.d.ts

@@ -1,2 +0,0 @@
-import type { Plugin } from 'vite';
-export declare function previewsPlugin(rootDir: string): Plugin;

package/dist/vite/plugins/tokens-plugin.d.ts

@@ -1,2 +0,0 @@
-import type { Plugin } from 'vite';
-export declare function tokensPlugin(rootDir: string): Plugin;

package/dist/vite/preview-types.d.ts

@@ -1,70 +0,0 @@
-import { z } from 'zod';
-export type PreviewType = 'component' | 'screen' | 'flow' | 'atlas';
-export declare const configSchema: z.ZodObject<{
-    tags: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>>;
-    category: z.ZodOptional<z.ZodString>;
-    status: z.ZodOptional<z.ZodEnum<{
-        draft: "draft";
-        stable: "stable";
-        deprecated: "deprecated";
-    }>>;
-    title: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    order: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export type PreviewConfig = z.infer<typeof configSchema>;
-export interface PreviewUnit {
-    type: PreviewType;
-    name: string;
-    path: string;
-    route: string;
-    config: PreviewConfig | null;
-    files: {
-        index: string;
-        states?: string[];
-        schema?: string;
-        docs?: string;
-    };
-}
-export interface FlowStep {
-    screen: string;
-    state?: string;
-    note?: string;
-    trigger?: string;
-    highlight?: string[];
-}
-export interface FlowDefinition {
-    name: string;
-    description?: string;
-    steps: FlowStep[];
-}
-export interface AtlasArea {
-    title: string;
-    description?: string;
-    parent?: string;
-    children?: string[];
-    access?: string;
-}
-export interface AtlasDefinition {
-    name: string;
-    description?: string;
-    hierarchy: {
-        root: string;
-        areas: Record<string, AtlasArea>;
-    };
-    routes?: Record<string, {
-        area: string;
-        screen: string;
-        guard?: string;
-    }>;
-    navigation?: Record<string, Array<{
-        area?: string;
-        icon?: string;
-        action?: string;
-    }>>;
-    relationships?: Array<{
-        from: string;
-        to: string;
-        type: string;
-    }>;
-}