@khoaha/spek-cli 1.0.4 → 1.0.5

package/src/index.ts

@@ -1,231 +0,0 @@
-import chalk from 'chalk';
-import { configExists, loadConfig, saveConfig, getConfigPath } from './config/manager.js';
-import { promptForConfig, promptForFileId } from './prompts/index.js';
-import { handleDownload } from './download/handler.js';
-import { handleSvgToVd } from './commands/svg-to-vd/handler.js';
-import type { CliOptions, SvgToVdOptions } from './types/index.js';
-
-/**
- * Parse command line arguments
- */
-function parseArgs(): CliOptions {
-  const args = process.argv.slice(2);
-  const options: CliOptions = {};
-
-  // Check for command
-  if (args.length > 0 && !args[0].startsWith('-')) {
-    if (args[0] === 'svg-to-vd') {
-      options.command = 'svg-to-vd';
-      options.svgToVd = parseSvgToVdArgs(args.slice(1));
-      return options;
-    }
-  }
-
-  // Parse download options
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    
-    if (arg === '-d' || arg === '--download') {
-      options.command = 'download';
-      options.fileId = args[i + 1];
-      i++; // Skip next arg
-    } else if (arg === '-h' || arg === '--help') {
-      showHelp();
-      process.exit(0);
-    } else if (arg === '-v' || arg === '--version') {
-      showVersion();
-      process.exit(0);
-    }
-  }
-
-  return options;
-}
-
-/**
- * Parse svg-to-vd command arguments
- */
-function parseSvgToVdArgs(args: string[]): SvgToVdOptions {
-  const options: Partial<SvgToVdOptions> = {};
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    
-    if (arg === '-i' || arg === '--input') {
-      options.input = args[i + 1];
-      i++;
-    } else if (arg === '-o' || arg === '--output') {
-      options.output = args[i + 1];
-      i++;
-    } else if (arg === '--tint') {
-      options.tint = args[i + 1];
-      i++;
-    } else if (arg === '-h' || arg === '--help') {
-      showSvgToVdHelp();
-      process.exit(0);
-    }
-  }
-
-  return options as SvgToVdOptions;
-}
-
-/**
- * Show help message
- */
-function showHelp(): void {
-  console.log(`
-${chalk.bold('spek-cli')} - Download and extract Figma design specs from Directus
-
-${chalk.bold('USAGE')}
-  npx spek-cli [command] [options]
-
-${chalk.bold('COMMANDS')}
-  svg-to-vd                   Convert SVG to Android Vector Drawable
-  (no command)                Interactive download mode
-
-${chalk.bold('OPTIONS')}
-  -d, --download <file-id>    Download and extract file by ID
-  -h, --help                  Show this help message
-  -v, --version               Show version
-
-${chalk.bold('EXAMPLES')}
-  ${chalk.dim('# Interactive mode (prompts for file ID)')}
-  npx spek-cli
-
-  ${chalk.dim('# Direct download')}
-  npx spek-cli -d abc123-def456-ghi789
-
-  ${chalk.dim('# Convert SVG to Vector Drawable')}
-  npx spek-cli svg-to-vd -i icon.svg -o icon.xml
-  npx spek-cli svg-to-vd --help
-
-${chalk.bold('CONFIGURATION')}
-  Config is stored at: ${chalk.cyan(getConfigPath())}
-  On first run, you'll be prompted to enter:
-    - Directus instance URL
-    - Access token
-`);
-}
-
-/**
- * Show SVG to Vector Drawable help
- */
-function showSvgToVdHelp(): void {
-  console.log(`
-${chalk.bold('spek-cli svg-to-vd')} - Convert SVG to Android Vector Drawable
-
-${chalk.bold('USAGE')}
-  npx spek-cli svg-to-vd -i <input> -o <output> [options]
-
-${chalk.bold('REQUIRED')}
-  -i, --input <input>         SVG file path or raw SVG content
-  -o, --output <output>       Output Vector Drawable XML file path
-
-${chalk.bold('OPTIONS')}
-  --tint <color>              Tint color (e.g., "#FF5722")
-  -h, --help                  Show this help message
-
-${chalk.bold('EXAMPLES')}
-  ${chalk.dim('# Convert SVG file')}
-  npx spek-cli svg-to-vd -i ./icons/heart.svg -o ./drawables/heart.xml
-
-  ${chalk.dim('# With tint color')}
-  npx spek-cli svg-to-vd -i icon.svg -o icon.xml --tint "#FF5722"
-
-  ${chalk.dim('# Using raw SVG content')}
-  npx spek-cli svg-to-vd -i "<svg>...</svg>" -o output.xml
-
-${chalk.bold('NOTES')}
-  • Input is auto-detected as file path or raw SVG content
-  • Output file will be overwritten if it already exists
-  • Output directory is created automatically if needed
-  • Complex SVG features may not be fully supported
-`);
-}
-
-/**
- * Show version
- */
-function showVersion(): void {
-  // Read version from package.json
-  console.log('1.0.0');
-}
-
-/**
- * Main CLI entry point
- */
-async function main(): Promise<void> {
-  console.log(chalk.bold.blue('\n📦 spek-cli\n'));
-
-  // Parse arguments
-  const options = parseArgs();
-
-  // Handle svg-to-vd command
-  if (options.command === 'svg-to-vd') {
-    if (!options.svgToVd) {
-      console.log(chalk.red('\n❌ Invalid svg-to-vd command'));
-      showSvgToVdHelp();
-      process.exit(1);
-    }
-
-    const result = await handleSvgToVd(options.svgToVd);
-
-    if (result.success) {
-      console.log(chalk.green.bold('\n✓ Conversion complete!\n'));
-      process.exit(0);
-    } else {
-      console.log(chalk.red(`\n❌ Error: ${result.error}\n`));
-      process.exit(1);
-    }
-  }
-
-  // Check if config exists, if not prompt for setup
-  let config = loadConfig();
-  
-  if (!config) {
-    const newConfig = await promptForConfig();
-    
-    if (!newConfig) {
-      console.log(chalk.yellow('\n⚠️  Setup cancelled'));
-      process.exit(1);
-    }
-
-    saveConfig(newConfig);
-    config = loadConfig();
-    
-    if (!config) {
-      console.log(chalk.red('\n❌ Failed to save configuration'));
-      process.exit(1);
-    }
-
-    console.log(chalk.green(`\n✓ Configuration saved to ${getConfigPath()}`));
-  }
-
-  // Get file ID (from args or prompt)
-  let fileId: string | null | undefined = options.fileId;
-  
-  if (!fileId) {
-    fileId = await promptForFileId();
-    
-    if (!fileId) {
-      console.log(chalk.yellow('\n⚠️  No file ID provided'));
-      process.exit(1);
-    }
-  }
-
-  // Download and extract
-  const result = await handleDownload(config, fileId);
-
-  if (result.success) {
-    console.log(chalk.green.bold('\n✓ Success!\n'));
-    process.exit(0);
-  } else {
-    console.log(chalk.red(`\n❌ Error: ${result.error}\n`));
-    process.exit(1);
-  }
-}
-
-// Run CLI
-main().catch((error) => {
-  console.error(chalk.red(`\n❌ Unexpected error: ${error.message}\n`));
-  process.exit(1);
-});

package/src/prompts/index.ts

@@ -1,76 +0,0 @@
-import prompts from 'prompts';
-import type { VaultConfig } from '../types/index.js';
-
-/**
- * Prompt user for Directus configuration
- */
-export async function promptForConfig(): Promise<Omit<VaultConfig, 'createdAt'> | null> {
-  console.log('\n🔧 Configuration not found. Let\'s set it up!\n');
-
-  const response = await prompts([
-    {
-      type: 'text',
-      name: 'directusUrl',
-      message: 'Enter your Directus instance URL:',
-      validate: (value: string) => {
-        if (!value) return 'URL is required';
-        try {
-          new URL(value);
-          return true;
-        } catch {
-          return 'Please enter a valid URL (e.g., https://my-instance.directus.app)';
-        }
-      },
-    },
-    {
-      type: 'password',
-      name: 'accessToken',
-      message: 'Enter your Directus access token:',
-      validate: (value: string) => (value ? true : 'Access token is required'),
-    },
-  ]);
-
-  // User cancelled (Ctrl+C)
-  if (!response.directusUrl || !response.accessToken) {
-    return null;
-  }
-
-  return {
-    directusUrl: response.directusUrl.trim(),
-    accessToken: response.accessToken.trim(),
-  };
-}
-
-/**
- * Prompt user for file ID (interactive mode)
- */
-export async function promptForFileId(): Promise<string | null> {
-  const response = await prompts({
-    type: 'text',
-    name: 'fileId',
-    message: 'Enter the file ID to download:',
-    validate: (value: string) => (value ? true : 'File ID is required'),
-  });
-
-  // User cancelled
-  if (!response.fileId) {
-    return null;
-  }
-
-  return response.fileId.trim();
-}
-
-/**
- * Prompt user whether to overwrite existing files
- */
-export async function promptOverwrite(): Promise<boolean> {
-  const response = await prompts({
-    type: 'confirm',
-    name: 'overwrite',
-    message: 'Files already exist in current directory. Overwrite?',
-    initial: false,
-  });
-
-  // User cancelled or said no
-  return response.overwrite === true;
-}

package/src/types/index.ts

@@ -1,72 +0,0 @@
-/**
- * Configuration stored in ~/.spek-cli/config.json
- */
-export interface VaultConfig {
-  /** Directus instance URL (e.g., https://my-instance.directus.app) */
-  directusUrl: string;
-  /** Directus access token for authentication */
-  accessToken: string;
-  /** Timestamp when config was created */
-  createdAt: string;
-}
-
-/**
- * CLI command options
- */
-export interface CliOptions {
-  /** File ID to download (from -d or --download flag) */
-  fileId?: string;
-  /** Command to execute */
-  command?: 'download' | 'svg-to-vd';
-  /** SVG to Vector Drawable conversion options */
-  svgToVd?: SvgToVdOptions;
-}
-
-/**
- * SVG to Vector Drawable conversion options
- */
-export interface SvgToVdOptions {
-  /** Input: SVG file path or raw SVG content */
-  input: string;
-  /** Output: Destination file path for Vector Drawable XML */
-  output: string;
-  /** Optional tint color (e.g., "#FF5722") */
-  tint?: string;
-}
-
-/**
- * SVG conversion result
- */
-export interface SvgConversionResult {
-  /** Whether conversion was successful */
-  success: boolean;
-  /** Path where file was written */
-  outputPath?: string;
-  /** Error message if failed */
-  error?: string;
-}
-
-
-/**
- * Download result
- */
-export interface DownloadResult {
-  /** Whether download was successful */
-  success: boolean;
-  /** Path where files were extracted */
-  extractPath?: string;
-  /** Error message if failed */
-  error?: string;
-}
-
-/**
- * File metadata from Directus
- */
-export interface FileMetadata {
-  /** File ID */
-  id: string;
-  /** Original filename */
-  filename_download: string;
-  /** File title */
-  title?: string;
-}

package/src/utils/file-utils.ts

@@ -1,69 +0,0 @@
-import { readFile, writeFile, access } from 'fs/promises';
-import { constants } from 'fs';
-import { dirname } from 'path';
-import { mkdir } from 'fs/promises';
-
-/**
- * Check if a file exists
- */
-export async function fileExists(filePath: string): Promise<boolean> {
-  try {
-    await access(filePath, constants.F_OK);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Read file content as string
- */
-export async function readFileContent(filePath: string): Promise<string> {
-  return await readFile(filePath, 'utf8');
-}
-
-/**
- * Write content to file (creates directory if needed)
- */
-export async function writeFileContent(filePath: string, content: string): Promise<void> {
-  const dir = dirname(filePath);
-  
-  // Ensure directory exists
-  await mkdir(dir, { recursive: true });
-  
-  // Write file
-  await writeFile(filePath, content, 'utf8');
-}
-
-/**
- * Auto-detect if input is a file path or SVG content
- * Detection logic:
- * 1. If starts with '<svg' -> treat as content
- * 2. If file exists -> read file
- * 3. Fallback -> treat as content
- */
-export async function detectInputType(input: string): Promise<{ isFile: boolean; content: string }> {
-  const trimmedInput = input.trim();
-  
-  // Check if it looks like SVG content
-  if (trimmedInput.startsWith('<svg')) {
-    return { isFile: false, content: trimmedInput };
-  }
-  
-  // Check if it's a file path that exists
-  if (await fileExists(input)) {
-    const content = await readFileContent(input);
-    return { isFile: true, content };
-  }
-  
-  // Fallback: treat as content
-  return { isFile: false, content: trimmedInput };
-}
-
-/**
- * Generate output file path by replacing extension
- */
-export function generateOutputPath(inputPath: string): string {
-  // Replace extension with .xml
-  return inputPath.replace(/\.[^.]+$/, '.xml');
-}

package/src/utils/svg-converter.ts

@@ -1,196 +0,0 @@
-/**
- * SVG to Vector Drawable Conversion Utility
- * 
- * Converts SVG content to Android Vector Drawable XML format using vd-tool
- */
-
-import { writeFile, unlink, mkdtemp, readFile } from 'fs/promises';
-import { join } from 'path';
-import { tmpdir } from 'os';
-import { vdConvert } from 'vd-tool';
-
-/**
- * Validation result for SVG content
- */
-interface SvgValidationResult {
-  isValid: boolean;
-  errors: string[];
-}
-
-/**
- * Conversion result
- */
-interface ConversionResult {
-  vectorDrawable: string;
-  warnings: string[];
-}
-
-/**
- * Conversion options
- */
-interface ConversionOptions {
-  /** Optional tint color to apply (e.g., "#FF5722") */
-  tint?: string;
-}
-
-/**
- * Validates SVG content format
- * 
- * @param svgContent - The SVG content to validate
- * @returns Validation result with isValid boolean and errors array
- */
-export function validateSvgContent(svgContent: string): SvgValidationResult {
-  const errors: string[] = [];
-
-  if (!svgContent || typeof svgContent !== 'string') {
-    errors.push('SVG content is required and must be a string');
-  } else {
-    if (svgContent.trim().length === 0) {
-      errors.push('SVG content cannot be empty');
-    }
-
-    if (!svgContent.includes('<svg')) {
-      errors.push('SVG content must contain an opening <svg> tag');
-    }
-
-    if (!svgContent.includes('</svg>')) {
-      errors.push('SVG content must contain a closing </svg> tag');
-    }
-
-    // Check for basic XML structure
-    const openTags = (svgContent.match(/<svg[^>]*>/g) || []).length;
-    const closeTags = (svgContent.match(/<\/svg>/g) || []).length;
-    
-    if (openTags !== closeTags) {
-      errors.push('SVG content has mismatched <svg> tags');
-    }
-  }
-
-  return {
-    isValid: errors.length === 0,
-    errors
-  };
-}
-
-/**
- * Applies customizations to the Vector Drawable XML
- * 
- * @param vectorDrawableXml - The Vector Drawable XML content
- * @param options - Customization options
- * @returns Customized Vector Drawable XML
- */
-function applyCustomizations(vectorDrawableXml: string, options: ConversionOptions): string {
-  let customizedXml = vectorDrawableXml;
-
-  // Apply tint if specified
-  if (options.tint) {
-    customizedXml = customizedXml.replace(
-      /<vector([^>]*)>/,
-      `<vector$1 android:tint="${options.tint}">`
-    );
-  }
-
-  return customizedXml;
-}
-
-/**
- * Cleans up temporary files and directories
- * 
- * @param svgFile - Path to temporary SVG file
- * @param vdFile - Path to temporary Vector Drawable file
- * @param tempDir - Path to temporary directory
- */
-async function cleanup(svgFile: string | null, vdFile: string | null, tempDir: string | null): Promise<void> {
-  try {
-    if (svgFile) await unlink(svgFile).catch(() => {});
-    if (vdFile) await unlink(vdFile).catch(() => {});
-    if (tempDir) {
-      const { rm } = await import('fs/promises');
-      await rm(tempDir, { recursive: true, force: true }).catch(() => {});
-    }
-  } catch (error) {
-    // Ignore cleanup errors
-  }
-}
-
-/**
- * Converts SVG content to Android Vector Drawable XML format
- * 
- * @param svgContent - The SVG content to convert
- * @param options - Conversion options
- * @returns Conversion result with vectorDrawable XML and optional warnings
- * @throws Error if conversion fails
- */
-export async function convertSvgToVectorDrawable(
-  svgContent: string,
-  options: ConversionOptions = {}
-): Promise<ConversionResult> {
-  // Input validation
-  if (!svgContent || typeof svgContent !== 'string') {
-    throw new Error('SVG content is required and must be a string');
-  }
-
-  if (svgContent.trim().length === 0) {
-    throw new Error('SVG content cannot be empty');
-  }
-
-  // Basic SVG format validation
-  if (!svgContent.includes('<svg') || !svgContent.includes('</svg>')) {
-    throw new Error('Invalid SVG format: must contain <svg> tags');
-  }
-
-  let tempDir: string | null = null;
-  let tempSvgFile: string | null = null;
-  let tempVdFile: string | null = null;
-
-  try {
-    // Create temporary directory
-    tempDir = await mkdtemp(join(tmpdir(), 'svg-to-vd-'));
-    tempSvgFile = join(tempDir, 'input.svg');
-    tempVdFile = join(tempDir, 'input.xml');
-
-    // Write SVG content to temporary file
-    await writeFile(tempSvgFile, svgContent, 'utf8');
-
-    // Use vd-tool library for conversion
-    try {
-      await vdConvert(tempSvgFile, {
-        outDir: tempDir
-      });
-    } catch (conversionError: any) {
-      const errorMessage = conversionError.message || 'Unknown conversion error';
-      throw new Error(`SVG to Vector Drawable conversion failed: ${errorMessage}`);
-    }
-
-    // Read the generated Vector Drawable XML
-    let vectorDrawableContent: string;
-    try {
-      vectorDrawableContent = await readFile(tempVdFile, 'utf8');
-    } catch (readError) {
-      throw new Error('Failed to read converted Vector Drawable file');
-    }
-
-    // Apply customizations if provided
-    if (options.tint) {
-      vectorDrawableContent = applyCustomizations(vectorDrawableContent, options);
-    }
-
-    // Clean up temporary files
-    await cleanup(tempSvgFile, tempVdFile, tempDir);
-
-    return {
-      vectorDrawable: vectorDrawableContent,
-      warnings: []
-    };
-
-  } catch (error) {
-    // Clean up temporary files in case of error
-    if (tempSvgFile || tempVdFile || tempDir) {
-      await cleanup(tempSvgFile, tempVdFile, tempDir).catch(() => {
-        // Ignore cleanup errors
-      });
-    }
-    
-    throw error;
-  }
-}

package/tsconfig.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "lib": ["ES2022"],
-    "moduleResolution": "node",
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}