@csszyx/cli 0.1.0

package/README.md

@@ -0,0 +1,61 @@
+# @csszyx/cli
+
+> Command-line tools for csszyx.
+
+Review usage stats, diagnose issues, and initialize projects.
+
+## Installation
+
+```bash
+npm install -g @csszyx/cli
+# or run via npx
+npx csszyx <command>
+```
+
+## Commands
+
+### `init`
+
+Initialize csszyx in a new or existing project.
+
+```bash
+npx csszyx init
+```
+
+### `doctor`
+
+Diagnose configuration and mangling issues.
+
+```bash
+npx csszyx doctor
+```
+
+### `audit`
+
+View performance statistics and mangle compression rates.
+
+```bash
+npx csszyx audit
+```
+
+### `generate-types`
+
+Generate TypeScript definitions from your `tailwind.config.js`.
+
+```bash
+npx csszyx generate-types
+```
+
+### `migrate`
+
+Convert Tailwind `className="..."` to csszyx `sz={...}` props. Phase 1 supports static string classNames.
+
+```bash
+npx csszyx migrate src/
+npx csszyx migrate --dry-run          # preview changes
+npx csszyx migrate --ignore "*.test.*"  # skip test files
+```
+
+## License
+
+MIT © [csszyx contributors](https://github.com/nguyennhutien/csszyx)

package/dist/index.d.ts

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+/**
+ * CLI command: generate-types
+ *
+ * Scans tailwind.config.js and generates strict TypeScript types
+ * for the csszyx sz prop.
+ *
+ * @module commands/generate-types
+ */
+/**
+ * Command options for generate-types.
+ */
+interface GenerateTypesOptions {
+    /** Path to tailwind.config.js (auto-detect if not specified) */
+    config?: string;
+    /** Output file path (default: ./csszyx.d.ts) */
+    output?: string;
+    /** Current working directory */
+    cwd?: string;
+    /** Silent mode (no output) */
+    silent?: boolean;
+}
+/**
+ * Execute the generate-types command.
+ *
+ * @param {GenerateTypesOptions} options - Command options
+ * @returns {Promise<void>}
+ *
+ * @example
+ * ```typescript
+ * await generateTypes({ config: './tailwind.config.js', output: './src/csszyx.d.ts' });
+ * ```
+ */
+declare function generateTypes(options?: GenerateTypesOptions): Promise<void>;
+
+/**
+ * Tailwind CSS configuration scanner.
+ *
+ * Scans and resolves tailwind.config.js to extract theme values
+ * for TypeScript type generation.
+ *
+ * @module scanner/tailwind-scanner
+ */
+/**
+ * Resolved Tailwind theme structure.
+ */
+interface ResolvedTheme {
+    colors: Record<string, string | Record<string, string>>;
+    spacing: Record<string, string>;
+    screens: Record<string, string>;
+    fontFamily: Record<string, string[]>;
+    fontSize: Record<string, string | [string, Record<string, string>]>;
+    fontWeight: Record<string, string>;
+    borderRadius: Record<string, string>;
+    boxShadow: Record<string, string>;
+    opacity: Record<string, string>;
+    zIndex: Record<string, string>;
+    [key: string]: unknown;
+}
+/**
+ * Scanner result containing resolved theme and metadata.
+ */
+interface ScanResult {
+    theme: ResolvedTheme;
+    configPath: string;
+    hasCustomColors: boolean;
+    hasCustomSpacing: boolean;
+}
+/**
+ * Find the Tailwind config file in the given directory.
+ *
+ * @param {string} cwd - Current working directory
+ * @returns {string | null} Path to config file or null if not found
+ */
+declare function findConfigFile(cwd: string): string | null;
+/**
+ * Load and resolve Tailwind configuration.
+ *
+ * @param {string} configPath - Path to tailwind.config.js/ts
+ * @returns {Promise<ScanResult>} Resolved theme and metadata
+ *
+ * @example
+ * ```typescript
+ * const result = await scanTailwindConfig('./tailwind.config.js');
+ * console.log(result.theme.colors);
+ * ```
+ */
+declare function scanTailwindConfig(configPath: string): Promise<ScanResult>;
+/**
+ * Extract flat color names from nested color object.
+ *
+ * @param {Record<string, unknown>} colors - Tailwind colors object
+ * @returns {string[]} Flat array of color class names (e.g., 'red-500', 'blue-100')
+ *
+ * @example
+ * ```typescript
+ * const colors = { red: { 500: '#f00', 600: '#c00' }, white: '#fff' };
+ * flattenColors(colors); // ['red-500', 'red-600', 'white']
+ * ```
+ */
+declare function flattenColors(colors: Record<string, string | Record<string, string>>): string[];
+/**
+ * Extract spacing values as strings.
+ *
+ * @param {Record<string, string>} spacing - Tailwind spacing object
+ * @returns {string[]} Array of spacing keys (e.g., '0', '1', '2', 'px')
+ */
+declare function extractSpacingKeys(spacing: Record<string, string>): string[];
+/**
+ * Extract screen breakpoint names.
+ *
+ * @param {Record<string, string>} screens - Tailwind screens object
+ * @returns {string[]} Array of screen names (e.g., 'sm', 'md', 'lg')
+ */
+declare function extractScreenKeys(screens: Record<string, string>): string[];
+
+/**
+ * TypeScript declaration generator for csszyx.
+ *
+ * Generates strict TypeScript types from resolved Tailwind configuration
+ * using declaration merging to override the base SzObject interface.
+ *
+ * @module generator/type-generator
+ */
+
+/**
+ * Type generation options.
+ */
+interface GeneratorOptions {
+    /** Output file path (default: ./csszyx.d.ts) */
+    output?: string;
+    /** Include comments in generated file */
+    includeComments?: boolean;
+    /** Include deprecated/legacy properties */
+    includeLegacy?: boolean;
+}
+/**
+ * Generate TypeScript declarations from resolved Tailwind theme.
+ *
+ * @param {ResolvedTheme} theme - Resolved Tailwind theme
+ * @param {GeneratorOptions} options - Generation options
+ * @returns {string} Generated TypeScript declaration content
+ */
+declare function generateTypeDeclarations(theme: ResolvedTheme, options?: GeneratorOptions): string;
+/**
+ * Write generated declarations to file.
+ *
+ * @param {string} content - Generated TypeScript content
+ * @param {string} outputPath - Output file path
+ */
+declare function writeDeclarationFile(content: string, outputPath: string): Promise<void>;
+/**
+ * Generate type declarations from Tailwind theme and write to file.
+ *
+ * @param {ResolvedTheme} theme - Resolved Tailwind theme
+ * @param {GeneratorOptions} options - Generation options
+ * @returns {Promise<string>} Path to generated file
+ */
+declare function generateAndWriteTypes(theme: ResolvedTheme, options?: GeneratorOptions): Promise<string>;
+
+export { type GenerateTypesOptions, type GeneratorOptions, type ResolvedTheme, type ScanResult, extractScreenKeys, extractSpacingKeys, findConfigFile, flattenColors, generateAndWriteTypes, generateTypeDeclarations, generateTypes, scanTailwindConfig, writeDeclarationFile };