@leanspec/ui 0.2.14 → 0.2.15

package/src/lib/backend-adapter.ts

@@ -1,382 +0,0 @@
-// Backend adapter pattern for web (HTTP) vs desktop (Tauri IPC)
-// This allows the same UI code to work in both browser and Tauri contexts
-
-import type {
-  ContextFileContent,
-  ContextFileListItem,
-  DependencyGraph,
-  DirectoryListResponse,
-  ListParams,
-  Spec,
-  SpecDetail,
-  Stats,
-  Project,
-  ProjectStatsResponse,
-  ProjectValidationResponse,
-  ProjectsResponse,
-  ListSpecsResponse,
-  ProjectContext,
-} from '../types/api';
-
-export class APIError extends Error {
-  status: number;
-
-  constructor(status: number, message: string) {
-    super(message);
-    this.status = status;
-    this.name = 'APIError';
-  }
-}
-
-/**
- * Backend adapter interface - abstracts the communication layer
- * Web uses HTTP fetch, Desktop uses Tauri invoke
- */
-export interface BackendAdapter {
-  // Project operations
-  getProjects(): Promise<ProjectsResponse>;
-  createProject(
-    path: string,
-    options?: { favorite?: boolean; color?: string; name?: string; description?: string | null }
-  ): Promise<Project>;
-  updateProject(
-    projectId: string,
-    updates: Partial<Pick<Project, 'name' | 'color' | 'favorite' | 'description'>>
-  ): Promise<Project | undefined>;
-  deleteProject(projectId: string): Promise<void>;
-  validateProject(projectId: string): Promise<ProjectValidationResponse>;
-
-  // Spec operations
-  getSpecs(projectId: string, params?: ListParams): Promise<Spec[]>;
-  getSpec(projectId: string, specName: string): Promise<SpecDetail>;
-  updateSpec(projectId: string, specName: string, updates: Partial<Pick<Spec, 'status' | 'priority' | 'tags'>>): Promise<void>;
-
-  // Stats and dependencies
-  getStats(projectId: string): Promise<Stats>;
-  getProjectStats(projectId: string): Promise<Stats>;
-  getDependencies(projectId: string, specName?: string): Promise<DependencyGraph>;
-
-  // Context files & local filesystem
-  getContextFiles(): Promise<ContextFileListItem[]>;
-  getContextFile(path: string): Promise<ContextFileContent>;
-  getProjectContext(projectId: string): Promise<ProjectContext>;
-  listDirectory(path?: string): Promise<DirectoryListResponse>;
-}
-
-/**
- * HTTP adapter for web browser - connects to Rust HTTP server
- */
-export class HttpBackendAdapter implements BackendAdapter {
-  private baseUrl: string;
-
-  constructor(baseUrl?: string) {
-    this.baseUrl = baseUrl || import.meta.env.VITE_API_URL || 'http://localhost:3333';
-  }
-
-  private async fetchAPI<T>(endpoint: string, options?: RequestInit): Promise<T> {
-    const response = await fetch(`${this.baseUrl}${endpoint}`, {
-      ...options,
-      headers: {
-        'Content-Type': 'application/json',
-        ...options?.headers,
-      },
-    });
-
-    if (!response.ok) {
-      const raw = await response.text();
-      let message = raw || response.statusText;
-
-      try {
-        const parsed = JSON.parse(raw);
-        if (typeof parsed.message === 'string') {
-          message = parsed.message;
-        } else if (typeof parsed.error === 'string') {
-          message = parsed.error;
-        } else if (typeof parsed.detail === 'string') {
-          message = parsed.detail;
-        }
-      } catch {
-        // Fall back to raw message
-      }
-
-      throw new APIError(response.status, message || response.statusText);
-    }
-
-    if (response.status === 204) {
-      return undefined as T;
-    }
-
-    const text = await response.text();
-    if (!text) {
-      return undefined as T;
-    }
-
-    try {
-      return JSON.parse(text) as T;
-    } catch (err) {
-      throw new APIError(response.status, err instanceof Error ? err.message : 'Failed to parse response');
-    }
-  }
-
-  async getProjects(): Promise<ProjectsResponse> {
-    const data = await this.fetchAPI<ProjectsResponse>('/api/projects');
-    return data;
-  }
-
-  async createProject(
-    path: string,
-    options?: { favorite?: boolean; color?: string; name?: string; description?: string | null }
-  ): Promise<Project> {
-    // Rust backend returns Project directly (not wrapped in { project: ... })
-    const project = await this.fetchAPI<Project>('/api/projects', {
-      method: 'POST',
-      body: JSON.stringify({ path, ...options }),
-    });
-    return project;
-  }
-
-  async updateProject(
-    projectId: string,
-    updates: Partial<Pick<Project, 'name' | 'color' | 'favorite' | 'description'>>
-  ): Promise<Project | undefined> {
-    // Rust backend returns Project directly (not wrapped in { project: ... })
-    const project = await this.fetchAPI<Project>(`/api/projects/${encodeURIComponent(projectId)}`, {
-      method: 'PATCH',
-      body: JSON.stringify(updates),
-    });
-    return project;
-  }
-
-  async deleteProject(projectId: string): Promise<void> {
-    await this.fetchAPI(`/api/projects/${encodeURIComponent(projectId)}`, {
-      method: 'DELETE',
-    });
-  }
-
-  async validateProject(projectId: string): Promise<ProjectValidationResponse> {
-    return this.fetchAPI<ProjectValidationResponse>(`/api/projects/${encodeURIComponent(projectId)}/validate`, {
-      method: 'POST',
-    });
-  }
-
-  async getSpecs(projectId: string, params?: ListParams): Promise<Spec[]> {
-    const query = params
-      ? new URLSearchParams(
-        Object.entries(params).reduce<string[][]>((acc, [key, value]) => {
-          if (typeof value === 'string' && value.length > 0) acc.push([key, value]);
-          return acc;
-        }, [])
-      ).toString()
-      : '';
-    const endpoint = query
-      ? `/api/projects/${encodeURIComponent(projectId)}/specs?${query}`
-      : `/api/projects/${encodeURIComponent(projectId)}/specs`;
-    const data = await this.fetchAPI<ListSpecsResponse>(endpoint);
-    return data.specs || [];
-  }
-
-  async getSpec(projectId: string, specName: string): Promise<SpecDetail> {
-    const data = await this.fetchAPI<SpecDetail | { spec: SpecDetail }>(
-      `/api/projects/${encodeURIComponent(projectId)}/specs/${encodeURIComponent(specName)}`
-    );
-    return 'spec' in data ? data.spec : data;
-  }
-
-  async updateSpec(
-    projectId: string,
-    specName: string,
-    updates: Partial<Pick<Spec, 'status' | 'priority' | 'tags'>>
-  ): Promise<void> {
-    await this.fetchAPI(`/api/projects/${encodeURIComponent(projectId)}/specs/${encodeURIComponent(specName)}/metadata`, {
-      method: 'PATCH',
-      body: JSON.stringify(updates),
-    });
-  }
-
-  async getStats(projectId: string): Promise<Stats> {
-    const data = await this.fetchAPI<Stats | { stats: Stats }>(
-      `/api/projects/${encodeURIComponent(projectId)}/stats`
-    );
-    return 'stats' in data ? data.stats : data;
-  }
-
-  async getProjectStats(projectId: string): Promise<Stats> {
-    const data = await this.fetchAPI<ProjectStatsResponse | Stats>(
-      `/api/projects/${encodeURIComponent(projectId)}/stats`
-    );
-    const statsPayload = 'stats' in data ? data.stats : data;
-    return statsPayload;
-  }
-
-  async getDependencies(projectId: string, _specName?: string): Promise<DependencyGraph> {
-    // Note: specName parameter is ignored for HTTP adapter as the project endpoint
-    // returns the full dependency graph. Individual spec dependencies can be computed client-side.
-    const data = await this.fetchAPI<DependencyGraph>(
-      `/api/projects/${encodeURIComponent(projectId)}/dependencies`
-    );
-    return data;
-  }
-
-  async getContextFiles(): Promise<ContextFileListItem[]> {
-    const data = await this.fetchAPI<{ files?: ContextFileListItem[] }>('/api/context');
-    return data.files || [];
-  }
-
-  async getContextFile(path: string): Promise<ContextFileContent> {
-    const safePath = encodeURIComponent(path);
-    const data = await this.fetchAPI<ContextFileContent>(
-      `/api/context/${safePath}`
-    );
-    return data;
-  }
-
-  async getProjectContext(projectId: string): Promise<ProjectContext> {
-    const data = await this.fetchAPI<ProjectContext>(
-      `/api/projects/${encodeURIComponent(projectId)}/context`
-    );
-    return data;
-  }
-
-  async listDirectory(path = ''): Promise<DirectoryListResponse> {
-    return this.fetchAPI<DirectoryListResponse>('/api/local-projects/list-directory', {
-      method: 'POST',
-      body: JSON.stringify({ path }),
-    });
-  }
-}
-
-/**
- * Tauri adapter for desktop app - uses IPC commands
- */
-export class TauriBackendAdapter implements BackendAdapter {
-  private async invoke<T>(command: string, args?: Record<string, unknown>): Promise<T> {
-    // Dynamic import to avoid bundling Tauri in web builds
-    const { invoke } = await import('@tauri-apps/api/core');
-    return invoke<T>(command, args);
-  }
-
-  async getProjects(): Promise<ProjectsResponse> {
-    const data = await this.invoke<{
-      projects: Project[];
-      recentProjects?: string[];
-      favoriteProjects?: string[];
-    }>('desktop_bootstrap');
-
-    return {
-      projects: data.projects,
-      recentProjects: data.recentProjects,
-      favoriteProjects: data.favoriteProjects,
-    };
-  }
-
-  async createProject(
-    _path: string,
-    _options?: { favorite?: boolean; color?: string; name?: string; description?: string | null }
-  ): Promise<Project> {
-    throw new Error('createProject is not implemented for the Tauri backend yet');
-  }
-
-  async updateProject(
-    _projectId: string,
-    _updates: Partial<Pick<Project, 'name' | 'color' | 'favorite' | 'description'>>
-  ): Promise<Project | undefined> {
-    throw new Error('updateProject is not implemented for the Tauri backend yet');
-  }
-
-  async deleteProject(_projectId: string): Promise<void> {
-    throw new Error('deleteProject is not implemented for the Tauri backend yet');
-  }
-
-  async validateProject(_projectId: string): Promise<ProjectValidationResponse> {
-    throw new Error('validateProject is not implemented for the Tauri backend yet');
-  }
-
-  async getSpecs(projectId: string, _params?: ListParams): Promise<Spec[]> {
-    // Tauri commands return LightweightSpec[], need to map to Spec[]
-    const specs = await this.invoke<Spec[]>('get_specs', {
-      projectId
-    });
-    return specs;
-  }
-
-  async getSpec(projectId: string, specName: string): Promise<SpecDetail> {
-    const spec = await this.invoke<SpecDetail>('get_spec_detail', {
-      projectId,
-      specId: specName,
-    });
-    return spec;
-  }
-
-  async updateSpec(
-    projectId: string,
-    specName: string,
-    updates: Partial<Pick<Spec, 'status' | 'priority' | 'tags'>>
-  ): Promise<void> {
-    // For now, only status update is supported
-    if (updates.status) {
-      await this.invoke('update_spec_status', {
-        projectId,
-        specId: specName,
-        newStatus: updates.status,
-      });
-    }
-  }
-
-  async getStats(projectId: string): Promise<Stats> {
-    const stats = await this.invoke<Stats>('get_project_stats', {
-      projectId,
-    });
-    return stats;
-  }
-
-  async getProjectStats(projectId: string): Promise<Stats> {
-    const stats = await this.invoke<Stats>('get_project_stats', {
-      projectId,
-    });
-    return stats;
-  }
-
-  async getDependencies(projectId: string, _specName?: string): Promise<DependencyGraph> {
-    return this.invoke<DependencyGraph>('get_dependency_graph', {
-      projectId,
-    });
-  }
-
-  async getContextFiles(): Promise<ContextFileListItem[]> {
-    throw new Error('getContextFiles is not implemented for the Tauri backend yet');
-  }
-
-  async getContextFile(_path: string): Promise<ContextFileContent> {
-    throw new Error('getContextFile is not implemented for the Tauri backend yet');
-  }
-
-  async getProjectContext(_projectId: string): Promise<ProjectContext> {
-    throw new Error('getProjectContext is not implemented for the Tauri backend yet');
-  }
-
-  async listDirectory(_path = ''): Promise<DirectoryListResponse> {
-    throw new Error('listDirectory is not implemented for the Tauri backend yet');
-  }
-}
-
-/**
- * Detect environment and create appropriate backend adapter
- */
-export function createBackendAdapter(): BackendAdapter {
-  // Check if running in Tauri
-  // @ts-expect-error __TAURI__ is injected by Tauri at runtime
-  if (typeof window !== 'undefined' && window.__TAURI__) {
-    return new TauriBackendAdapter();
-  }
-  return new HttpBackendAdapter();
-}
-
-// Export singleton instance
-let backendInstance: BackendAdapter | null = null;
-
-export function getBackend(): BackendAdapter {
-  if (!backendInstance) {
-    backendInstance = createBackendAdapter();
-  }
-  return backendInstance;
-}

package/src/lib/date-utils.ts

@@ -1,122 +0,0 @@
-/**
- * Utility functions for date formatting
- */
-
-import dayjs from 'dayjs';
-import relativeTime from 'dayjs/plugin/relativeTime';
-import 'dayjs/locale/zh-cn';
-
-dayjs.extend(relativeTime);
-
-function isChineseLocale(locale?: string) {
-  if (!locale) return false;
-  return locale.toLowerCase().startsWith('zh');
-}
-
-function resolveDayjsLocale(locale?: string) {
-  return isChineseLocale(locale) ? 'zh-cn' : 'en';
-}
-
-/**
- * Format a date as relative time (e.g., "2 days ago")
- */
-export function formatRelativeTime(
-  date: Date | string | number | null | undefined,
-  locale?: string
-): string {
-  if (!date) return isChineseLocale(locale) ? '未知' : 'Unknown';
-  return dayjs(date).locale(resolveDayjsLocale(locale)).fromNow();
-}
-
-/**
- * Format a date in a readable format (e.g., "Nov 12, 2025")
- */
-export function formatDate(
-  date: Date | string | number | null | undefined,
-  locale?: string
-): string {
-  if (!date) return isChineseLocale(locale) ? '未知' : 'Unknown';
-  return dayjs(date).locale(resolveDayjsLocale(locale)).format('MMM D, YYYY');
-}
-
-/**
- * Format a date with time (e.g., "Nov 12, 2025 10:30 AM")
- */
-export function formatDateTime(
-  date: Date | string | number | null | undefined,
-  locale?: string
-): string {
-  if (!date) return isChineseLocale(locale) ? '未知' : 'Unknown';
-  return dayjs(date).locale(resolveDayjsLocale(locale)).format('MMM D, YYYY h:mm A');
-}
-
-/**
- * Format duration between two dates in a human-readable format
- */
-export function formatDuration(
-  start: Date | string | number | null | undefined,
-  end: Date | string | number | null | undefined,
-  locale?: string
-): string {
-  if (!start || !end) return '';
-
-  const startDate = dayjs(start);
-  const endDate = dayjs(end);
-  const diffMs = endDate.diff(startDate);
-
-  if (diffMs < 0) return '';
-
-  const days = Math.floor(diffMs / (1000 * 60 * 60 * 24));
-  const hours = Math.floor((diffMs % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
-  const minutes = Math.floor((diffMs % (1000 * 60 * 60)) / (1000 * 60));
-  const chinese = isChineseLocale(locale);
-
-  const unitFormatters = chinese
-    ? {
-      minute: (value: number) => `${value} 分钟`,
-      hour: (value: number) => `${value} 小时`,
-      day: (value: number) => `${value} 天`,
-      month: (value: number) => `${value} 个月`,
-      year: (value: number) => `${value} 年`,
-    }
-    : {
-      minute: (value: number) => `${value}m`,
-      hour: (value: number) => `${value}h`,
-      day: (value: number) => `${value}d`,
-      month: (value: number) => `${value}mo`,
-      year: (value: number) => `${value}y`,
-    };
-
-  const joinValues = (...parts: string[]) => parts.filter(Boolean).join(chinese ? ' ' : ' ');
-  const lessThanMinute = chinese ? '小于 1 分钟' : '< 1m';
-
-  if (days === 0 && hours === 0) {
-    if (minutes === 0) return lessThanMinute;
-    return unitFormatters.minute(minutes);
-  }
-
-  if (days === 0) {
-    return unitFormatters.hour(hours);
-  }
-
-  if (days < 30) {
-    return hours > 0
-      ? joinValues(unitFormatters.day(days), unitFormatters.hour(hours))
-      : unitFormatters.day(days);
-  }
-
-  const months = Math.floor(days / 30);
-  const remainingDays = days % 30;
-
-  if (months < 12) {
-    return remainingDays > 0
-      ? joinValues(unitFormatters.month(months), unitFormatters.day(remainingDays))
-      : unitFormatters.month(months);
-  }
-
-  const years = Math.floor(months / 12);
-  const remainingMonths = months % 12;
-  return remainingMonths > 0
-    ? joinValues(unitFormatters.year(years), unitFormatters.month(remainingMonths))
-    : unitFormatters.year(years);
-}

package/src/lib/i18n.test.ts

@@ -1,57 +0,0 @@
-import { beforeEach, describe, expect, it } from 'vitest';
-import i18n from './i18n';
-
-describe('i18n configuration', () => {
-  beforeEach(() => {
-    localStorage.clear();
-    void i18n.changeLanguage('en');
-  });
-
-  it('should have English and Chinese languages available', () => {
-    const languages = Object.keys(i18n.options.resources || {});
-    expect(languages).toContain('en');
-    expect(languages).toContain('zh-CN');
-  });
-
-  it('should have namespaces: common, errors, help', () => {
-    expect(i18n.options.ns).toContain('common');
-    expect(i18n.options.ns).toContain('errors');
-    expect(i18n.options.ns).toContain('help');
-  });
-
-  it('should translate navigation.home to Chinese', async () => {
-    await i18n.changeLanguage('zh-CN');
-    expect(i18n.t('navigation.home', { ns: 'common' })).toBe('首页');
-  });
-
-  it('should translate Spec label to Chinese', async () => {
-    await i18n.changeLanguage('zh-CN');
-    expect(i18n.t('spec.spec', { ns: 'common' })).toBe('规范');
-  });
-
-  it('should translate status terms', async () => {
-    await i18n.changeLanguage('zh-CN');
-    expect(i18n.t('status.planned', { ns: 'common' })).toBe('已计划');
-    expect(i18n.t('status.inProgress', { ns: 'common' })).toBe('进行中');
-    expect(i18n.t('status.complete', { ns: 'common' })).toBe('已完成');
-  });
-
-  it('should fallback to English for missing keys', async () => {
-    await i18n.changeLanguage('zh-CN');
-    const result = i18n.t('nonexistent.key', {
-      ns: 'common',
-      defaultValue: 'fallback',
-    });
-    expect(result).toBe('fallback');
-  });
-
-  it('should detect browser language on init', () => {
-    expect(i18n.options.detection).toBeDefined();
-  });
-
-  it('should persist language choice to localStorage', async () => {
-    await i18n.changeLanguage('zh-CN');
-    const stored = localStorage.getItem('leanspec-language');
-    expect(stored).toBe('zh-CN');
-  });
-});

package/src/lib/i18n.ts

@@ -1,51 +0,0 @@
-import i18n from 'i18next';
-import { initReactI18next } from 'react-i18next';
-import LanguageDetector from 'i18next-browser-languagedetector';
-
-import commonEn from '../locales/en/common.json';
-import errorsEn from '../locales/en/errors.json';
-import helpEn from '../locales/en/help.json';
-
-import commonZh from '../locales/zh-CN/common.json';
-import errorsZh from '../locales/zh-CN/errors.json';
-import helpZh from '../locales/zh-CN/help.json';
-
-const resources = {
-  en: {
-    common: commonEn,
-    errors: errorsEn,
-    help: helpEn,
-  },
-  'zh-CN': {
-    common: commonZh,
-    errors: errorsZh,
-    help: helpZh,
-  },
-};
-
-i18n
-  .use(LanguageDetector)
-  .use(initReactI18next)
-  .init({
-    resources,
-    fallbackLng: 'en',
-    defaultNS: 'common',
-    ns: ['common', 'errors', 'help'],
-    detection: {
-      order: ['localStorage', 'navigator'],
-      caches: ['localStorage'],
-      lookupLocalStorage: 'leanspec-language',
-    },
-    interpolation: {
-      escapeValue: false,
-    },
-  });
-
-// Persist language preference for environments without detector cache writes
-i18n.on('languageChanged', (lng) => {
-  if (typeof localStorage !== 'undefined') {
-    localStorage.setItem('leanspec-language', lng);
-  }
-});
-
-export default i18n;

package/src/lib/markdown-utils.ts

@@ -1,38 +0,0 @@
-import GithubSlugger from 'github-slugger';
-
-export interface HeadingItem {
-  id: string;
-  text: string;
-  level: number;
-}
-
-/**
- * Extract markdown headings while skipping fenced code blocks.
- */
-export function extractHeadings(markdown: string): HeadingItem[] {
-  if (!markdown) return [];
-
-  const headings: HeadingItem[] = [];
-  const lines = markdown.split('\n');
-  let inCodeBlock = false;
-  const slugger = new GithubSlugger();
-
-  for (const line of lines) {
-    if (line.trim().startsWith('```')) {
-      inCodeBlock = !inCodeBlock;
-      continue;
-    }
-
-    if (inCodeBlock) continue;
-
-    const match = line.match(/^(#{2,6})\s+(.+)$/);
-    if (match) {
-      const level = match[1].length;
-      const text = match[2].trim();
-      const id = slugger.slug(text);
-      headings.push({ id, text, level });
-    }
-  }
-
-  return headings;
-}