superspec 0.1.0

package/dist/cli/ui/interactive.js

@@ -0,0 +1,60 @@
+/**
+ * Interactive Detection Utilities
+ *
+ * Determines if the CLI is running in an interactive environment
+ */
+/**
+ * Check if the current environment is interactive
+ */
+export function isInteractive(options) {
+    // Explicit option override
+    if (typeof options === 'boolean') {
+        return options;
+    }
+    if (options?.interactive !== undefined) {
+        return options.interactive;
+    }
+    // Environment variable override
+    if (process.env['SUPERSPEC_INTERACTIVE'] === '0') {
+        return false;
+    }
+    if (process.env['SUPERSPEC_INTERACTIVE'] === '1') {
+        return true;
+    }
+    // CI environment detection
+    if (process.env['CI']) {
+        return false;
+    }
+    if (process.env['CONTINUOUS_INTEGRATION']) {
+        return false;
+    }
+    // No color often means non-interactive
+    if (process.env['NO_COLOR']) {
+        return false;
+    }
+    // Check if stdin is a TTY
+    return !!process.stdin.isTTY;
+}
+/**
+ * Ensure interactive mode or exit with error
+ */
+export function requireInteractive(message = 'This command requires interactive mode') {
+    if (!isInteractive()) {
+        console.error(`Error: ${message}`);
+        console.error('Run with explicit arguments or in a terminal with TTY support.');
+        process.exit(1);
+    }
+}
+/**
+ * Check if colors should be enabled
+ */
+export function shouldUseColor() {
+    if (process.env['NO_COLOR']) {
+        return false;
+    }
+    if (process.env['FORCE_COLOR']) {
+        return true;
+    }
+    return !!process.stdout.isTTY;
+}
+//# sourceMappingURL=interactive.js.map

package/dist/cli/ui/interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../../../src/cli/ui/interactive.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAsC;IAClE,2BAA2B;IAC3B,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,OAAO,CAAC,WAAW,CAAC;IAC7B,CAAC;IAED,gCAAgC;IAChC,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,KAAK,GAAG,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,KAAK,GAAG,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2BAA2B;IAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0BAA0B;IAC1B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,wCAAwC;IAC3F,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;AAChC,CAAC"}

package/dist/cli/ui/palette.d.ts

@@ -0,0 +1,301 @@
+/**
+ * SuperSpec CLI Visual System
+ *
+ * Design Direction: "Precision Terminal"
+ * Inspired by space mission control panels, precision instruments,
+ * and Japanese minimalism with technical precision.
+ *
+ * Color Philosophy:
+ * - Teal as primary: represents precision and professionalism
+ * - Amber as accent: draws attention to important elements
+ * - Muted grays: clean, non-distracting background text
+ */
+export declare const PALETTE: {
+    primary: import("chalk").ChalkInstance;
+    primaryBright: import("chalk").ChalkInstance;
+    primaryDim: import("chalk").ChalkInstance;
+    primaryMuted: import("chalk").ChalkInstance;
+    accent: import("chalk").ChalkInstance;
+    accentBright: import("chalk").ChalkInstance;
+    accentDim: import("chalk").ChalkInstance;
+    secondary: import("chalk").ChalkInstance;
+    secondaryBright: import("chalk").ChalkInstance;
+    success: import("chalk").ChalkInstance;
+    successBright: import("chalk").ChalkInstance;
+    warning: import("chalk").ChalkInstance;
+    error: import("chalk").ChalkInstance;
+    errorBright: import("chalk").ChalkInstance;
+    info: import("chalk").ChalkInstance;
+    white: import("chalk").ChalkInstance;
+    light: import("chalk").ChalkInstance;
+    muted: import("chalk").ChalkInstance;
+    dim: import("chalk").ChalkInstance;
+    subtle: import("chalk").ChalkInstance;
+    dark: import("chalk").ChalkInstance;
+    darker: import("chalk").ChalkInstance;
+    bold: import("chalk").ChalkInstance;
+    italic: import("chalk").ChalkInstance;
+    underline: import("chalk").ChalkInstance;
+    strikethrough: import("chalk").ChalkInstance;
+    cyan: import("chalk").ChalkInstance;
+    lightGray: import("chalk").ChalkInstance;
+    midGray: import("chalk").ChalkInstance;
+    darkGray: import("chalk").ChalkInstance;
+};
+export declare const ICONS: {
+    success: string;
+    error: string;
+    warning: string;
+    info: string;
+    pending: string;
+    check: string;
+    cross: string;
+    dot: string;
+    arrowRight: string;
+    arrowLeft: string;
+    arrowUp: string;
+    arrowDown: string;
+    pointer: string;
+    chevron: string;
+    file: string;
+    fileFilled: string;
+    folder: string;
+    spec: string;
+    radioOn: string;
+    radioOff: string;
+    checkboxOn: string;
+    checkboxOff: string;
+    star: string;
+    diamond: string;
+    square: string;
+    circle: string;
+    play: string;
+    pause: string;
+    stop: string;
+    refresh: string;
+    logo: string;
+    logoAlt: string;
+};
+export declare const SYMBOLS: {
+    success: string;
+    error: string;
+    warning: string;
+    info: string;
+    arrow: string;
+    pointer: string;
+    selected: string;
+    unselected: string;
+    checkbox: string;
+    uncheckbox: string;
+    filledBar: string;
+    emptyBar: string;
+    spinner: string[];
+    bullet: string;
+    dash: string;
+    verticalLine: string;
+    corner: string;
+    tee: string;
+};
+export declare const BOX: {
+    topLeft: string;
+    topRight: string;
+    bottomLeft: string;
+    bottomRight: string;
+    horizontal: string;
+    vertical: string;
+    teeLeft: string;
+    teeRight: string;
+    teeTop: string;
+    teeBottom: string;
+    cross: string;
+    doubleH: string;
+    doubleV: string;
+    doubleTopLeft: string;
+    doubleTopRight: string;
+    doubleBottomLeft: string;
+    doubleBottomRight: string;
+    heavyH: string;
+    heavyV: string;
+    heavyTopLeft: string;
+    heavyTopRight: string;
+    heavyBottomLeft: string;
+    heavyBottomRight: string;
+    roundTopLeft: string;
+    roundTopRight: string;
+    roundBottomLeft: string;
+    roundBottomRight: string;
+};
+export declare const LINES: {
+    thin: string;
+    thick: string;
+    double: string;
+    dotted: string;
+    dashed: string;
+};
+export declare const BANNER: string;
+export declare const MINI_BANNER: string;
+export declare const INLINE_LOGO: string;
+/**
+ * Command header with modern styling
+ */
+export declare function commandHeader(command: string, description?: string): string;
+/**
+ * Section header
+ */
+export declare function sectionHeader(title: string, icon?: string): string;
+/**
+ * Section divider
+ */
+export declare function sectionDivider(): string;
+/**
+ * Subsection divider (lighter)
+ */
+export declare function subsectionDivider(): string;
+/**
+ * Styled content box
+ */
+export declare function styledBox(title: string, content: string[], options?: {
+    width?: number;
+    style?: 'default' | 'accent' | 'success' | 'warning' | 'error';
+}): string;
+/**
+ * Info card (compact box for single info)
+ */
+export declare function infoCard(label: string, value: string, icon?: string): string;
+/**
+ * Modern progress bar
+ */
+export declare function createProgressBar(current: number, total: number, options?: {
+    width?: number;
+    showPercent?: boolean;
+    showCount?: boolean;
+    style?: 'default' | 'minimal' | 'detailed';
+}): string;
+/**
+ * Status indicator with label
+ */
+export declare function statusIndicator(status: 'success' | 'warning' | 'error' | 'info' | 'pending' | 'active'): string;
+/**
+ * Status badge with text
+ */
+export declare function statusBadge(status: 'active' | 'draft' | 'completed' | 'archived' | 'error'): string;
+/**
+ * Phase indicator for workflow
+ */
+export declare function phaseIndicator(current: number, total: number, labels?: string[]): string;
+/**
+ * Styled list item
+ */
+export declare function listItem(text: string, options?: {
+    indent?: number;
+    icon?: string;
+    style?: 'default' | 'dim' | 'highlight';
+}): string;
+/**
+ * Numbered list item
+ */
+export declare function numberedItem(num: number, text: string, options?: {
+    indent?: number;
+    style?: 'default' | 'dim' | 'highlight';
+}): string;
+/**
+ * Task item (checkbox style)
+ */
+export declare function taskItem(text: string, done: boolean, options?: {
+    indent?: number;
+}): string;
+/**
+ * Keyboard shortcut hint
+ */
+export declare function keyHint(keys: string, action: string): string;
+/**
+ * Multiple key hints
+ */
+export declare function keyHints(hints: Array<[string, string]>): string;
+/**
+ * Command hint
+ */
+export declare function commandHint(cmd: string, desc?: string): string;
+/**
+ * Simple table row
+ */
+export declare function tableRow(columns: string[], widths: number[]): string;
+/**
+ * Table header
+ */
+export declare function tableHeader(columns: string[], widths: number[]): string;
+/**
+ * Highlight text within a string
+ */
+export declare function highlight(text: string, term: string): string;
+/**
+ * Truncate text with ellipsis
+ */
+export declare function truncate(text: string, maxLength: number): string;
+/**
+ * Format a path
+ */
+export declare function formatPath(path: string): string;
+/**
+ * Format a date
+ */
+export declare function formatDate(date: Date | string): string;
+/**
+ * Format file size
+ */
+export declare function formatSize(bytes: number): string;
+/**
+ * Success message
+ */
+export declare function successMessage(text: string): string;
+/**
+ * Error message
+ */
+export declare function errorMessage(text: string): string;
+/**
+ * Warning message
+ */
+export declare function warningMessage(text: string): string;
+/**
+ * Info message
+ */
+export declare function infoMessage(text: string): string;
+/**
+ * Tip/hint message
+ */
+export declare function tipMessage(text: string): string;
+/**
+ * Change card for list view
+ */
+export declare function changeCard(options: {
+    id: string;
+    title?: string;
+    status: 'active' | 'draft' | 'completed' | 'archived';
+    phase?: string;
+    progress?: {
+        current: number;
+        total: number;
+    };
+    specs?: number;
+}): string;
+/**
+ * Spec card for list view
+ */
+export declare function specCard(options: {
+    name: string;
+    path?: string;
+    requirements?: number;
+    scenarios?: number;
+}): string;
+/**
+ * Quick actions footer
+ */
+export declare function quickActions(actions: Array<{
+    cmd: string;
+    desc: string;
+}>): string;
+/**
+ * Next steps suggestion
+ */
+export declare function nextSteps(steps: string[]): string;
+//# sourceMappingURL=palette.d.ts.map

package/dist/cli/ui/palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/palette.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CnB,CAAC;AAMF,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDjB,CAAC;AAGF,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;CAmBnB,CAAC;AAMF,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCf,CAAC;AAMF,eAAO,MAAM,KAAK;;;;;;CAMjB,CAAC;AAsFF,eAAO,MAAM,MAAM,QAIlB,CAAC;AAEF,eAAO,MAAM,WAAW,QAAuB,CAAC;AAEhD,eAAO,MAAM,WAAW,QAAiD,CAAC;AAM1E;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAqB3E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAMD;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;CAC3D,GAAG,MAAM,CAkCd;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5E;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;CACvC,GACL,MAAM,CAqCR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAU/G;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CASnG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAaxF;AAMD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,WAAW,CAAC;CACpC,GAAG,MAAM,CAUd;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,WAAW,CAAC;CACpC,GAAG,MAAM,CAUd;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,MAAM,CAOd;AAMD;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9D;AAMD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAOpE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CASvE;AAMD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAOtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWhD;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAqCT;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAsBT;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAYlF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAYjD"}