@superdesign/cli 0.1.0

package/dist/skills/superdesign.d.ts

@@ -0,0 +1,4 @@
+/**
+ * SKILL.md template for Claude Code integration
+ */
+export declare function getSkillTemplate(): string;

package/dist/utils/ascii-animation.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ASCII Art Animation for SuperDesign CLI
+ * Matrix-style decrypt animation that reveals the logo
+ */
+/**
+ * Check if animation should be skipped
+ */
+export declare function shouldSkipAnimation(): boolean;
+/**
+ * Run the decrypt animation
+ * Characters gradually reveal from scrambled to actual logo
+ */
+export declare function animateLogo(): Promise<void>;
+/**
+ * Quick reveal animation - simpler version for non-TTY contexts
+ */
+export declare function quickReveal(): Promise<void>;

package/dist/utils/auth-flow.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared authentication flow utility
+ * Used by both login and init commands
+ */
+export interface AuthFlowOptions {
+    /** Whether to open browser automatically */
+    openBrowser?: boolean;
+    /** Whether to show success message */
+    showSuccessMessage?: boolean;
+}
+export interface AuthFlowResult {
+    success: boolean;
+    teamId?: string;
+    teamName?: string;
+    apiKey?: string;
+    error?: string;
+}
+/**
+ * Run the device authentication flow
+ * Creates a session, opens browser for authorization, polls for approval, and saves credentials
+ */
+export declare function runAuthFlow(options?: AuthFlowOptions): Promise<AuthFlowResult>;

package/dist/utils/job-runner.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Job runner utility for polling async jobs
+ * Encapsulates the common pattern of: start job -> poll -> handle result
+ */
+import { type JobCompletedResponse } from '../api/jobs';
+export interface JobRunnerConfig<TResult> {
+    /** Label shown while starting (e.g., "Creating design draft...") */
+    startLabel: string;
+    /** Label shown while polling (e.g., "Generating design with AI...") */
+    pollingLabel: string;
+    /** Label shown on success (e.g., "Design draft created!") */
+    successLabel: string;
+    /** Label shown on timeout (e.g., "Generation timed out") */
+    timeoutLabel: string;
+    /** Label shown on failure (e.g., "Failed to create draft") */
+    failureLabel: string;
+    /** Custom timeout in ms (defaults to POLL_TIMEOUT_MS) */
+    timeoutMs?: number;
+    /** Function that starts the job and returns jobId */
+    startJob: () => Promise<{
+        jobId: string;
+    }>;
+    /** Transform completed job result for output */
+    transformResult: (job: JobCompletedResponse<TResult>) => Record<string, unknown>;
+    /** Display human-readable result (non-JSON mode) */
+    displayResult: (job: JobCompletedResponse<TResult>) => void;
+}
+export interface JobRunnerResult<TResult> {
+    success: boolean;
+    data?: JobCompletedResponse<TResult>;
+    error?: string;
+}
+/**
+ * Run a job with polling and standard error handling
+ * Handles spinner updates, timeout, failure states, and output formatting
+ */
+export declare function runJob<TResult>(config: JobRunnerConfig<TResult>): Promise<never>;
+/**
+ * Check authentication and exit with appropriate error if not authenticated
+ */
+export declare function requireAuth(isAuthenticated: () => boolean): void;

package/dist/utils/open-browser.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Cross-platform browser opening utility
+ */
+/**
+ * Open a URL in the default browser
+ */
+export declare function openBrowser(url: string): Promise<void>;

package/dist/utils/output.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Output utilities for human-readable and JSON output
+ */
+/**
+ * Enable JSON output mode
+ */
+export declare function setJsonMode(enabled: boolean): void;
+/**
+ * Check if JSON mode is enabled
+ */
+export declare function isJsonMode(): boolean;
+/**
+ * Output data - either as JSON or human-readable
+ */
+export declare function output(data: unknown): void;
+/**
+ * Output success message
+ */
+export declare function success(message: string): void;
+/**
+ * Output error message
+ */
+export declare function error(message: string): void;
+/**
+ * Output info message (only in human mode)
+ */
+export declare function info(message: string): void;
+/**
+ * Output warning message (only in human mode)
+ */
+export declare function warn(message: string): void;
+/**
+ * Format a key-value pair for display
+ */
+export declare function formatKeyValue(key: string, value: string | number | boolean): string;
+/**
+ * Output result with optional success message in human mode
+ */
+export declare function result<T>(data: T, humanMessage?: string): void;

package/dist/utils/poll.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Polling utility for async operations
+ */
+export interface PollOptions {
+    /** Interval between poll attempts in ms */
+    intervalMs?: number;
+    /** Maximum time to poll in ms */
+    timeoutMs?: number;
+    /** Callback on each poll attempt */
+    onPoll?: (attempt: number) => void;
+}
+export interface PollResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    timedOut?: boolean;
+}
+/**
+ * Poll a function until a condition is met or timeout
+ *
+ * @param fn Function to poll (should return the current state)
+ * @param isDone Predicate to check if polling should stop
+ * @param options Polling options
+ */
+export declare function poll<T>(fn: () => Promise<T>, isDone: (result: T) => boolean, options?: PollOptions): Promise<PollResult<T>>;
+/**
+ * Sleep for a specified duration
+ */
+export declare function sleep(ms: number): Promise<void>;

package/dist/utils/spinner.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Spinner utility wrapping ora
+ */
+import { type Ora } from 'ora';
+/**
+ * Start a spinner with the given text
+ * Returns null in JSON mode (no spinner shown)
+ */
+export declare function startSpinner(text: string): Ora | null;
+/**
+ * Update spinner text
+ */
+export declare function updateSpinner(text: string): void;
+/**
+ * Stop spinner with success
+ */
+export declare function succeedSpinner(text?: string): void;
+/**
+ * Stop spinner with failure
+ */
+export declare function failSpinner(text?: string): void;
+/**
+ * Stop spinner (neutral)
+ */
+export declare function stopSpinner(): void;
+/**
+ * Get the current spinner instance
+ */
+export declare function getSpinner(): Ora | null;

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@superdesign/cli",
+  "version": "0.1.0",
+  "description": "CLI for SuperDesign Platform - agent skills for Claude Code",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "superdesign": "./bin/superdesign.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "rslib build && chmod +x bin/superdesign.js",
+    "dev": "rslib build --watch"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "commander": "^11.1.0",
+    "dotenv": "^16.3.0",
+    "open": "^10.0.0",
+    "ora": "^8.0.0"
+  },
+  "devDependencies": {
+    "@rslib/core": "0.15.1",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "superdesign",
+    "cli",
+    "claude-code",
+    "ai",
+    "design"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/superdesigndev/superdesign-platform.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT"
+}