oh-my-design-cli 0.1.2 → 1.0.0

package/dist/index.d.ts

@@ -1,559 +0,0 @@
-import { z } from 'zod';
-
-type Mood = 'clean' | 'warm' | 'bold' | 'minimal' | 'playful' | 'dark';
-type Roundness = 'sharp' | 'moderate' | 'rounded' | 'pill';
-type Density = 'compact' | 'comfortable' | 'spacious';
-type TypographyStyle = 'geometric' | 'humanist' | 'monospace' | 'serif-accent';
-type DepthStyle = 'flat' | 'subtle' | 'layered' | 'dramatic';
-type ComponentName = 'button' | 'card' | 'dialog' | 'dropdown' | 'table' | 'input' | 'navigation' | 'badge' | 'floating-button' | 'toast' | 'tabs' | 'select';
-interface UserPreferences {
-    mood: Mood;
-    primaryColor: string;
-    roundness: Roundness;
-    density: Density;
-    typography: TypographyStyle;
-    depth: DepthStyle;
-    darkMode: boolean;
-    components: ComponentName[];
-    preset?: string;
-}
-interface ColorScale {
-    50: string;
-    100: string;
-    200: string;
-    300: string;
-    400: string;
-    500: string;
-    600: string;
-    700: string;
-    800: string;
-    900: string;
-    950: string;
-}
-interface SemanticColor {
-    base: string;
-    foreground: string;
-}
-interface ColorTokens {
-    primary: SemanticColor & {
-        scale: ColorScale;
-    };
-    secondary: SemanticColor;
-    accent: SemanticColor;
-    muted: SemanticColor;
-    destructive: SemanticColor;
-    background: string;
-    foreground: string;
-    card: SemanticColor;
-    popover: SemanticColor;
-    border: string;
-    input: string;
-    ring: string;
-    chart: [string, string, string, string, string];
-}
-interface TypographyTokens {
-    fontFamily: {
-        sans: string;
-        mono: string;
-        heading: string;
-    };
-    scale: {
-        xs: string;
-        sm: string;
-        base: string;
-        lg: string;
-        xl: string;
-        '2xl': string;
-        '3xl': string;
-        '4xl': string;
-    };
-    weight: {
-        normal: number;
-        medium: number;
-        semibold: number;
-        bold: number;
-    };
-    lineHeight: {
-        tight: number;
-        normal: number;
-        relaxed: number;
-    };
-    letterSpacing: {
-        tight: string;
-        normal: string;
-        wide: string;
-    };
-}
-interface SpacingTokens {
-    baseUnit: number;
-    scale: number[];
-    sectionGap: string;
-    componentPadding: {
-        sm: string;
-        md: string;
-        lg: string;
-    };
-}
-interface RadiusTokens {
-    none: string;
-    sm: string;
-    md: string;
-    lg: string;
-    xl: string;
-    full: string;
-}
-interface ShadowTokens {
-    none: string;
-    sm: string;
-    md: string;
-    lg: string;
-    xl: string;
-}
-interface BorderTokens {
-    width: string;
-    style: string;
-    color: string;
-}
-interface ComponentTokens {
-    description: string;
-    variants: Record<string, {
-        background: string;
-        foreground: string;
-        border?: string;
-        shadow?: string;
-        radius?: string;
-        padding?: string;
-    }>;
-    states: {
-        hover?: string;
-        active?: string;
-        disabled?: string;
-        focus?: string;
-    };
-    sizes?: Record<string, {
-        height: string;
-        padding: string;
-        fontSize: string;
-    }>;
-}
-interface DesignTokens {
-    name: string;
-    colors: ColorTokens;
-    typography: TypographyTokens;
-    spacing: SpacingTokens;
-    radius: RadiusTokens;
-    shadows: ShadowTokens;
-    borders: BorderTokens;
-    components: Partial<Record<ComponentName, ComponentTokens>>;
-    darkColors?: ColorTokens;
-}
-interface Preset {
-    name: string;
-    displayName: string;
-    description: string;
-    preferences: Partial<UserPreferences>;
-    tokenOverrides?: Partial<DesignTokens>;
-    dosAndDonts?: {
-        dos: string[];
-        donts: string[];
-    };
-}
-interface TemplateContext extends DesignTokens {
-    preferences: UserPreferences;
-    presetName?: string;
-    generatedAt: string;
-    version: string;
-}
-
-declare function resolveTokens(prefs: UserPreferences): DesignTokens;
-
-declare function renderDesignMd(context: TemplateContext): string;
-
-declare function generateComponentTokens(componentNames: ComponentName[], tokens: DesignTokens): Array<{
-    name: ComponentName;
-    title: string;
-} & ComponentTokens>;
-
-interface ShadcnTheme {
-    light: Record<string, string>;
-    dark?: Record<string, string>;
-}
-declare function mapToShadcn(tokens: DesignTokens): ShadcnTheme;
-declare function shadcnToCss(theme: ShadcnTheme): string;
-
-interface ReferenceEntry {
-    id: string;
-    name: string;
-    category: string;
-    designMd: string;
-    colors: ExtractedColors;
-    typography: ExtractedTypography;
-    radius: string;
-    mood: string;
-}
-interface ExtractedColors {
-    primary: string;
-    primaryName: string;
-    background: string;
-    foreground: string;
-    accent?: string;
-    border?: string;
-}
-interface ExtractedTypography {
-    primary: string;
-    mono?: string;
-    headingWeight: string;
-}
-declare function loadReference(id: string): ReferenceEntry;
-declare function listReferences(): Array<{
-    id: string;
-    name: string;
-    category: string;
-    primaryColor: string;
-}>;
-
-interface CustomOverrides {
-    primaryColor?: string;
-    headingWeight?: string;
-    borderRadius?: string;
-    fontFamily?: string;
-    darkMode: boolean;
-    additionalNotes?: string;
-}
-
-/**
- * Apply user overrides to a reference DESIGN.md.
- *
- * Strategy:
- *  - "as-is": return the original DESIGN.md content with minimal additions
- *  - "customized": perform text-level replacements for color/font/radius/weight
- *    and append a customization summary + shadcn CSS variables block
- *
- * This is intentionally NOT an AI call. It's deterministic string transformation.
- */
-declare function applyOverrides(ref: ReferenceEntry, overrides: CustomOverrides, mode: 'as-is' | 'customized', components?: string[]): {
-    designMd: string;
-    shadcnCss: string;
-    previewData: PreviewData;
-};
-interface PreviewData {
-    name: string;
-    basedOn: string;
-    primary: string;
-    background: string;
-    foreground: string;
-    font: string;
-    headingWeight: string;
-    radius: string;
-    shadcnCss: string;
-    designMd: string;
-    colors: {
-        primary: string;
-        accent: string;
-        muted: string;
-        destructive: string;
-        border: string;
-        scale: Record<string, string>;
-        chart: string[];
-    };
-    darkMode: boolean;
-}
-
-declare function generatePreviewHtml(data: PreviewData): string;
-
-declare function getPreset(name: string): Preset | undefined;
-declare function getAllPresets(): Preset[];
-declare function mergeWithBase(preset: Preset): Required<Pick<Preset, 'preferences' | 'dosAndDonts'>>;
-
-interface ManagedBlock {
-    version: number;
-    hash: string;
-    content: string;
-    rawStart: number;
-    rawEnd: number;
-}
-interface WriteBlockResult {
-    updated: string;
-    hash: string;
-}
-declare function hashContent(content: string): string;
-declare function parseBlock(fileContent: string): ManagedBlock | null;
-declare function hasDrift(block: ManagedBlock): boolean;
-declare function writeBlock(fileContent: string, managedContent: string, version: number): WriteBlockResult;
-
-declare const SYNC_LOCK_VERSION = 1;
-declare const SYNC_LOCK_PATH = ".omd/sync.lock.json";
-declare const TargetSchema: z.ZodObject<{
-    managed_hash: z.ZodString;
-    last_synced: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    managed_hash: string;
-    last_synced: string;
-}, {
-    managed_hash: string;
-    last_synced: string;
-}>;
-declare const SyncLockSchema: z.ZodObject<{
-    version: z.ZodNumber;
-    design_md_hash: z.ZodString;
-    targets: z.ZodRecord<z.ZodString, z.ZodObject<{
-        managed_hash: z.ZodString;
-        last_synced: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        managed_hash: string;
-        last_synced: string;
-    }, {
-        managed_hash: string;
-        last_synced: string;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    version: number;
-    design_md_hash: string;
-    targets: Record<string, {
-        managed_hash: string;
-        last_synced: string;
-    }>;
-}, {
-    version: number;
-    design_md_hash: string;
-    targets: Record<string, {
-        managed_hash: string;
-        last_synced: string;
-    }>;
-}>;
-type SyncTarget = z.infer<typeof TargetSchema>;
-type SyncLock = z.infer<typeof SyncLockSchema>;
-declare function readLock(projectRoot: string): SyncLock | null;
-declare function writeLock(projectRoot: string, lock: SyncLock): void;
-declare function createLock(designMdHash: string): SyncLock;
-declare function updateTarget(projectRoot: string, target: string, managedHash: string): SyncLock;
-declare function updateDesignMdHash(projectRoot: string, designMdHash: string): SyncLock;
-
-declare const MANAGED_BLOCK_VERSION = 1;
-type ShimId = 'claude' | 'agents' | 'cursor';
-type ShimMode = 'block' | 'whole';
-interface Shim {
-    id: ShimId;
-    relPath: string;
-    mode: ShimMode;
-    render(): string;
-}
-declare const CLAUDE_SHIM: Shim;
-declare const AGENTS_SHIM: Shim;
-declare const CURSOR_SHIM: Shim;
-declare const ALL_SHIMS: readonly Shim[];
-type DriftAction = 'overwrite' | 'skip' | 'error';
-interface WriteShimResult {
-    id: ShimId;
-    path: string;
-    hash: string;
-    status: 'created' | 'updated' | 'unchanged' | 'skipped-drift';
-}
-interface WriteShimsOptions {
-    onDrift?: DriftAction;
-}
-type InspectStatus = 'missing' | 'clean' | 'drifted' | 'out-of-date';
-interface InspectResult {
-    id: ShimId;
-    path: string;
-    status: InspectStatus;
-    existing?: string;
-    rendered: string;
-}
-declare function inspectShim(projectRoot: string, shim: Shim): InspectResult;
-declare function inspectAllShims(projectRoot: string): InspectResult[];
-declare function writeShim(projectRoot: string, shim: Shim, opts?: WriteShimsOptions): WriteShimResult;
-declare function writeAllShims(projectRoot: string, opts?: WriteShimsOptions): WriteShimResult[];
-declare function refreshDesignMdHash(projectRoot: string): string | null;
-
-declare const PREFERENCES_PATH = ".omd/preferences.md";
-declare const PREFERENCES_SCHEMA = "omd.preferences/v1";
-type PreferenceScope = 'visualTheme' | 'color' | 'typography' | 'spacing' | 'voice' | 'motion' | 'layout' | `components.${string}`;
-type PreferenceSignal = 'user-correction' | 'user-statement' | 'inferred-from-revert' | 'inferred-from-edit';
-type PreferenceConfidence = 'explicit' | 'inferred';
-type PreferenceStatus = 'pending' | 'applied' | 'rejected' | 'superseded';
-interface PreferenceMeta {
-    id: string;
-    timestamp: string;
-    scope: PreferenceScope;
-    signal: PreferenceSignal;
-    confidence: PreferenceConfidence;
-    status: PreferenceStatus;
-    source_agent?: string;
-    source_context?: string;
-    applied_design_md_hash?: string;
-    applied_at?: string;
-    rejected_reason?: string;
-    superseded_by?: string;
-}
-interface PreferenceEntry {
-    meta: PreferenceMeta;
-    heading: string;
-    body: string;
-}
-interface PreferencesFile {
-    schema: string;
-    design_md_hash_at_creation: string;
-    entries: PreferenceEntry[];
-}
-declare function generateId(): string;
-declare function slugify(input: string, max?: number): string;
-declare function inferScope(note: string): PreferenceScope;
-declare function renderFile(file: PreferencesFile): string;
-declare function parseFile(raw: string): PreferencesFile;
-declare function readFile(projectRoot: string): PreferencesFile | null;
-declare function writeFile(projectRoot: string, file: PreferencesFile): void;
-interface CreateEntryInput {
-    note: string;
-    scope?: PreferenceScope;
-    signal?: PreferenceSignal;
-    confidence?: PreferenceConfidence;
-    source_agent?: string;
-    source_context?: string;
-    now?: Date;
-}
-declare function buildEntry(input: CreateEntryInput): PreferenceEntry;
-interface UpdateStatusInput {
-    id: string;
-    status: PreferenceStatus;
-    applied_design_md_hash?: string;
-    rejected_reason?: string;
-    superseded_by?: string;
-    now?: Date;
-}
-declare function updateEntryStatus(projectRoot: string, input: UpdateStatusInput): PreferenceEntry;
-declare function groupByScope(entries: PreferenceEntry[]): Map<PreferenceScope, PreferenceEntry[]>;
-declare function filterByStatus(entries: PreferenceEntry[], status: PreferenceStatus): PreferenceEntry[];
-declare function appendEntry(projectRoot: string, input: CreateEntryInput, designMdHashIfNew?: string): PreferenceEntry;
-
-type AgentId = 'claude-code' | 'codex' | 'opencode' | 'cursor' | 'unknown';
-declare function detectCallingAgent(): AgentId;
-interface AgentPresence {
-    claudeCode: boolean;
-    codex: boolean;
-    opencode: boolean;
-    cursor: boolean;
-}
-declare function detectInstalledAgents(projectRoot: string): AgentPresence;
-
-interface AxisSpec {
-    type: 'int' | 'float' | 'enum';
-    domain: [number, number];
-    unit?: string;
-    step?: number;
-}
-interface KeywordAxes {
-    [axis: string]: {
-        delta: number;
-        range: [number, number];
-    };
-}
-interface KeywordSpec {
-    group: 'tone' | 'density' | 'formality' | 'domain';
-    axes: KeywordAxes;
-    conflicts_with: string[];
-    voice_hints: string[];
-    coupled_axes?: string[];
-    sources?: string[];
-}
-interface Vocabulary {
-    version: number;
-    generated_at: string;
-    axis_registry: Record<string, AxisSpec>;
-    modifiers: Record<string, number>;
-    keywords: Record<string, KeywordSpec>;
-}
-interface SynonymsFile {
-    version: number;
-    map: Record<string, string>;
-}
-declare function loadVocabulary(): Vocabulary;
-declare function loadSynonyms(): SynonymsFile;
-interface ResolvedKeyword {
-    keyword: string;
-    modifier: number;
-    matchedAs: 'direct' | 'synonym';
-    synonymSource?: string;
-}
-declare function extractKeywords(description: string): ResolvedKeyword[];
-interface ConflictResolution {
-    kept: ResolvedKeyword[];
-    dropped: Array<{
-        keyword: string;
-        reason: string;
-    }>;
-    warnings: string[];
-}
-declare function resolveConflicts(keywords: ResolvedKeyword[]): ConflictResolution;
-interface DeltaSet {
-    axes: Record<string, {
-        value: number;
-        rangeUnion: [number, number];
-        sources: string[];
-    }>;
-    voiceHints: string[];
-    unresolved: string[];
-    warnings: string[];
-    droppedKeywords: Array<{
-        keyword: string;
-        reason: string;
-    }>;
-    matchedKeywords: ResolvedKeyword[];
-}
-declare function buildDeltaSet(description: string): DeltaSet;
-declare function listKeywords(): string[];
-
-interface ReferenceTag {
-    id: string;
-    color: string;
-    category: string;
-    keywords: string[];
-}
-interface RecommendHit {
-    id: string;
-    category: string;
-    color: string;
-    keywords: string[];
-    score: number;
-    matchedKeywords: string[];
-    matchedCategories: string[];
-}
-declare function loadReferenceTags(): ReferenceTag[];
-interface RecommendOptions {
-    topK?: number;
-    diversityByCategory?: boolean;
-}
-declare function recommend(description: string, opts?: RecommendOptions): RecommendHit[];
-
-interface StubStats {
-    hexMatches: number;
-    hexChanged: number;
-    hueShift: number;
-    satShift: number;
-    lightShift: number;
-    sourcesApplied: string[];
-}
-interface StubResult {
-    designMd: string;
-    stats: StubStats;
-}
-declare function applyDeltaStub(referenceMd: string, delta: DeltaSet): StubResult;
-
-interface DeprecateOptions {
-    projectRoot: string;
-    previousReference?: string;
-    newReference: string;
-    preferencesReplayed?: number;
-    preferencesOrphaned?: number;
-    orphanFile?: string;
-    reason: string;
-    now?: Date;
-}
-interface DeprecateResult {
-    renamed: boolean;
-    from: string;
-    to: string;
-}
-declare function deprecateDesignMd(opts: DeprecateOptions): DeprecateResult;
-
-export { AGENTS_SHIM, ALL_SHIMS, type AgentId, type AgentPresence, CLAUDE_SHIM, CURSOR_SHIM, type ComponentName, type ComponentTokens, type ConflictResolution, type DeltaSet, type Density, type DeprecateOptions, type DeprecateResult, type DepthStyle, type DesignTokens, type InspectResult, type InspectStatus, type KeywordSpec, MANAGED_BLOCK_VERSION, type ManagedBlock, type Mood, PREFERENCES_PATH, PREFERENCES_SCHEMA, type PreferenceConfidence, type PreferenceEntry, type PreferenceMeta, type PreferenceScope, type PreferenceSignal, type PreferenceStatus, type PreferencesFile, type Preset, type PreviewData, type RecommendHit, type RecommendOptions, type ReferenceEntry, type ReferenceTag, type ResolvedKeyword, type Roundness, SYNC_LOCK_PATH, SYNC_LOCK_VERSION, type ShadcnTheme, type Shim, type ShimId, type ShimMode, type StubResult, type StubStats, type SyncLock, type SyncTarget, type TemplateContext, type TypographyStyle, type UserPreferences, type Vocabulary, type WriteShimResult, appendEntry, applyDeltaStub, applyOverrides, buildDeltaSet, buildEntry, createLock, deprecateDesignMd, detectCallingAgent, detectInstalledAgents, extractKeywords, filterByStatus, generateComponentTokens, generateId as generatePreferenceId, generatePreviewHtml, getAllPresets, getPreset, groupByScope, hasDrift, hashContent, inferScope, inspectAllShims, inspectShim, listKeywords, listReferences, loadReference, loadReferenceTags, loadSynonyms, loadVocabulary, mapToShadcn, mergeWithBase, parseBlock, parseFile as parsePreferencesFile, readLock, readFile as readPreferencesFile, recommend, refreshDesignMdHash, renderDesignMd, renderFile as renderPreferencesFile, resolveConflicts, resolveTokens, shadcnToCss, slugify, updateDesignMdHash, updateEntryStatus, updateTarget, writeAllShims, writeBlock, writeLock, writeFile as writePreferencesFile, writeShim };