@tachui/cli 0.8.1-alpha → 0.8.8

package/README.md

@@ -1,439 +1,64 @@
 # @tachui/cli
 
-> Comprehensive developer tooling and CLI for tachUI framework
-
-[![npm version](https://img.shields.io/npm/v/@tachui/cli.svg)](https://www.npmjs.com/package/@tachui/cli)
-[![License: MPL-2.0](https://img.shields.io/badge/License-MPL--2.0-blue.svg)](https://opensource.org/licenses/MPL-2.0)
-
-## Overview
-
-The tachUI CLI (`tacho`) provides comprehensive developer tooling including project scaffolding, code generation, SwiftUI migration utilities, performance analysis, and development server capabilities.
-
-## Features
-
-- 🚀 **Project Scaffolding** - Create new tachUI projects with templates
-- 🔧 **Code Generation** - Generate components, pages, and plugins
-- 📱 **SwiftUI Migration** - Convert SwiftUI code to tachUI
-- ⚡ **Performance Tools** - Bundle analysis and optimization
-- 🔍 **Development Server** - Hot reload and debugging capabilities
-- 🧪 **Testing Utilities** - Test generation and runner integration
-
-## Installation
-
-### Global Installation
-
-```bash
-npm install -g @tachui/cli@0.8.0-alpha
-# or
-pnpm add -g @tachui/cli@0.8.0-alpha
-```
-
-### Local Project Installation
-
-```bash
-npm install --save-dev @tachui/cli@0.8.0-alpha
-# or
-pnpm add -D @tachui/cli@0.8.0-alpha
-```
+Developer CLI for TachUI.
 
 ## Quick Start
 
-### Create New Project
-
-```bash
-# Create a new tachUI project
-tacho create my-app
-
-# Create with specific template
-tacho create my-app --template react-integration
-tacho create my-app --template mobile-first
-tacho create my-app --template desktop-app
-```
-
-### Generate Components
-
-```bash
-# Generate a new component
-tacho generate component UserProfile
-tacho generate component --interactive
-
-# Generate a page with routing
-tacho generate page ProductDetail --route "/products/:id"
-
-# Generate a plugin
-tacho generate plugin MyCustomPlugin
-```
-
-## Commands
-
-### Project Management
-
-```bash
-# Create new project
-tacho create <project-name> [options]
-
-# Initialize tachUI in existing project
-tacho init
-
-# Add tachUI packages to existing project
-tacho add forms navigation symbols
-```
-
-### Code Generation
-
-```bash
-# Generate component
-tacho generate component <ComponentName>
-tacho g c <ComponentName>  # Shorthand
-
-# Generate page
-tacho generate page <PageName> --route <route>
-
-# Generate plugin
-tacho generate plugin <PluginName>
-
-# Generate form
-tacho generate form <FormName> --fields name:string,email:email,age:number
-```
-
-### SwiftUI Migration
+Use `npx` without a global install:
 
 ```bash
-# Migrate SwiftUI file to tachUI
-tacho migrate swiftui ./MyView.swift
-
-# Migrate entire SwiftUI project
-tacho migrate swiftui-project ./MySwiftUIApp
-
-# Interactive migration with suggestions
-tacho migrate --interactive ./ContentView.swift
+npx @tachui/cli init my-app
+cd my-app
+npm install
+npm run dev
 ```
 
-### Development Tools
+## Init Command
 
 ```bash
-# Start development server
-tacho dev
-tacho serve --port 3000
-
-# Build project
-tacho build
-tacho build --mode production
-
-# Analyze bundle size
-tacho analyze
-tacho bundle-size --detailed
-```
-
-### Performance & Optimization
-
-```bash
-# Performance analysis
-tacho perf analyze
-tacho perf benchmark
-
-# Bundle optimization
-tacho optimize --tree-shake
-tacho optimize --compress-assets
-
-# Audit dependencies
-tacho audit
-tacho audit --security
+tacho init <target> [options]
 ```
 
-## Templates
-
-### Available Project Templates
+Examples:
 
 ```bash
-# Basic tachUI application
-tacho create my-app --template basic
-
-# React.js integration
-tacho create my-app --template react-integration
-
-# Vue.js integration
-tacho create my-app --template vue-integration
-
-# Mobile-first application
-tacho create my-app --template mobile-first
-
-# Desktop application with Electron
-tacho create my-app --template desktop
-
-# Full-stack application with backend
-tacho create my-app --template fullstack
-```
-
-### Component Templates
-
-```bash
-# Basic component
-tacho generate component Button
-
-# Component with props interface
-tacho generate component UserCard --props "user:User,onClick:Function"
-
-# Form component with validation
-tacho generate component LoginForm --type form
-
-# List component with data binding
-tacho generate component TodoList --type list --data-source todos
-```
-
-## Configuration
-
-### `tacho.config.js`
-
-```javascript
-export default {
-  // Project settings
-  projectName: 'my-tachui-app',
-  version: '1.0.0',
-
-  // Development server
-  dev: {
-    port: 3000,
-    host: 'localhost',
-    open: true,
-    https: false,
-  },
-
-  // Build configuration
-  build: {
-    outDir: 'dist',
-    sourcemap: true,
-    minify: 'terser',
-    target: 'es2020',
-  },
-
-  // Code generation preferences
-  generate: {
-    componentsDir: 'src/components',
-    pagesDir: 'src/pages',
-    pluginsDir: 'src/plugins',
-    typescript: true,
-    cssModules: false,
-  },
-
-  // SwiftUI migration settings
-  migration: {
-    outputDir: 'src/migrated',
-    preserveComments: true,
-    generateTypes: true,
-    swiftUIVersion: '5.0',
-  },
-}
-```
-
-## SwiftUI Migration
-
-### Supported SwiftUI Features
-
-```bash
-# Migrate common SwiftUI patterns
-tacho migrate swiftui MyView.swift
-
-# What gets converted:
-# - VStack, HStack, ZStack → VStack, HStack, ZStack
-# - Text, Button, Image → Text, Button, Image
-# - @State → createSignal
-# - @ObservedObject → createComputed
-# - .modifier chains → .modifier chains
-# - NavigationView → NavigationView
-# - List, ForEach → List, ForEach
-```
-
-### Migration Examples
-
-**Before (SwiftUI):**
-
-```swift
-struct ContentView: View {
-    @State private var count = 0
-
-    var body: some View {
-        VStack(spacing: 20) {
-            Text("Count: \(count)")
-                .font(.title)
-                .foregroundColor(.blue)
-
-            Button("Increment") {
-                count += 1
-            }
-            .padding()
-            .background(Color.blue)
-            .foregroundColor(.white)
-            .cornerRadius(8)
-        }
-    }
-}
-```
-
-**After (tachUI):**
-
-```typescript
-import { createSignal } from '@tachui/core'
-import { VStack, Text, Button } from '@tachui/primitives'
-
-const ContentView = () => {
-  const [count, setCount] = createSignal(0)
-
-  return VStack({
-    children: [
-      Text(() => `Count: ${count()}`)
-        .modifier.font({ size: 24, weight: 'bold' })
-        .foregroundColor('#007AFF')
-        .build(),
-
-      Button('Increment', () => setCount(count() + 1))
-        .modifier.padding(16)
-        .backgroundColor('#007AFF')
-        .foregroundColor('white')
-        .cornerRadius(8)
-        .build(),
-    ],
-    spacing: 20,
-  }).build()
-}
-```
-
-## Plugin Development
-
-### Create Plugin Template
-
-```bash
-tacho generate plugin MyPlugin --type enhancement
-
-# Generates:
-# - src/plugins/MyPlugin/
-# - index.ts (main plugin file)
-# - components/ (plugin components)
-# - types.ts (TypeScript definitions)
-# - README.md (plugin documentation)
-```
-
-### Plugin Structure
-
-```typescript
-// Generated plugin template
-import { createTachUIPlugin } from '@tachui/core'
-
-export const MyPlugin = createTachUIPlugin({
-  name: 'MyPlugin',
-  version: '1.0.0',
-  components: {
-    // Custom components
-  },
-  modifiers: {
-    // Custom modifiers
-  },
-  utilities: {
-    // Helper functions
-  },
-})
-
-export default MyPlugin
-```
-
-## Development Server
-
-```bash
-# Start development server with hot reload
-tacho dev
-
-# Start with custom configuration
-tacho dev --port 3000 --host 0.0.0.0 --https
-
-# Start with specific environment
-tacho dev --mode development --env local
-```
-
-Features:
-
-- **Hot Module Replacement** - Instant updates without page refresh
-- **Error Overlay** - In-browser error display
-- **Performance Metrics** - Real-time performance monitoring
-- **Component Inspector** - Debug component hierarchy
-
-## Performance Tools
-
-### Bundle Analysis
-
-```bash
-# Analyze bundle composition
-tacho analyze
-
-# Generate detailed report
-tacho analyze --output report.html --detailed
-
-# Compare bundle sizes
-tacho analyze --compare baseline.json
-```
-
-### Performance Profiling
-
-```bash
-# Profile application performance
-tacho perf profile --duration 30s
-
-# Benchmark specific components
-tacho perf benchmark --components Button,Text,VStack
-
-# Memory usage analysis
-tacho perf memory --watch
-```
-
-## Integration Examples
-
-### React Integration
-
-```bash
-tacho create my-react-app --template react-integration
-
-# Generates project with:
-# - React + tachUI setup
-# - Custom React hooks for tachUI signals
-# - Component interoperability
-# - Shared state management
-```
-
-### Vue Integration
-
-```bash
-tacho create my-vue-app --template vue-integration
-
-# Generates project with:
-# - Vue 3 + tachUI setup
-# - Vue composition API integration
-# - Reactive property bindings
-# - Component bridge utilities
+npx @tachui/cli init my-app --template basic --yes
+npx @tachui/cli init my-app --template advanced --yes
+npx @tachui/cli init . --template basic --yes
+npx @tachui/cli init my-app --tachui-version 0.8.8-alpha --yes
 ```
 
-## Examples
+Options:
 
-Check out generated project examples:
+- `--template <template>`: `basic` or `advanced`
+- `--yes`: skip prompts
+- `--tachui-version <version>`: version to use for generated `@tachui/*` dependencies
+- `--package-manager <npm|pnpm>`: controls next-step output only (does not change generated scripts)
+- `--list-templates`: print available templates
 
-- **[Basic App](https://github.com/tach-UI/tachUI/tree/main/apps/examples/cli/basic-app)**
-- **[React Integration](https://github.com/tach-UI/tachUI/tree/main/apps/examples/cli/react-integration)**
-- **[SwiftUI Migration](https://github.com/tach-UI/tachUI/tree/main/apps/examples/cli/swiftui-migration)**
+Notes:
 
-## API Reference
+- `phase6` template naming has been removed. Use `advanced`.
+- `--yes` requires an explicit target, for example `init my-app --yes`.
+- By default, the CLI resolves `@tachui/core` from npm registry (`@tachui/core/latest`).
+- If registry resolution fails, the CLI falls back to an internal compatibility map.
+- `--tachui-version` always overrides the default resolution behavior.
 
-- **[CLI Commands](https://github.com/tach-UI/tachUI/blob/main/docs/api/cli/src/functions/main.md)**
-- **[Configuration Options](https://github.com/tach-UI/tachUI/blob/main/docs/guide/cli/configuration.md)**
-- **[Plugin Development](https://github.com/tach-UI/tachUI/blob/main/docs/guide/cli/plugins.md)**
+## Development Server Path
 
-## Requirements
+Scaffolded projects default to plain Vite scripts:
 
-- **Node.js** 20.0+
-- **@tachui/core** ^0.8.0-alpha or later
-- **TypeScript** 5.0+ (recommended)
+- `npm run dev`
+- `npm run build`
 
-## Contributing
+`tacho dev` remains available as optional enhanced CLI workflow.
 
-See the main [Contributing Guide](https://github.com/tach-UI/tachUI/blob/main/CONTRIBUTING.md) for information on contributing to tachUI CLI.
+## Other Commands
 
-## License
+- `tacho dev`
+- `tacho generate`
+- `tacho migrate`
+- `tacho analyze`
+- `tacho optimize`
 
-Mozilla Public License 2.0 - see [LICENSE](https://github.com/tach-UI/tachUI/blob/main/LICENSE) for details.
+Run `tacho <command> --help` for command-specific flags.

package/bin/tacho.js

@@ -1,10 +1,62 @@
 #!/usr/bin/env node
 
-import('../dist/index.js')
-  .then(({ main }) => {
-    main()
-  })
-  .catch((error) => {
-    console.error('Failed to start Tacho CLI:', error)
+import { realpathSync } from 'node:fs'
+import { dirname } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const binRealPath = realpathSync(fileURLToPath(import.meta.url))
+const binDirUrl = pathToFileURL(`${dirname(binRealPath)}/`)
+
+const moduleCandidates = [
+  new URL('../dist/index.js', binDirUrl).href,
+  new URL('../dist/cli/src/index.js', binDirUrl).href,
+]
+
+const isMissingModule = (error, candidate) => {
+  if (!error) return false
+  if (error.code !== 'ERR_MODULE_NOT_FOUND') return false
+  return typeof error.message === 'string' && error.message.includes(candidate)
+}
+
+async function start() {
+  for (const candidate of moduleCandidates) {
+    try {
+      const { main } = await import(candidate)
+      if (typeof main === 'function') {
+        await main()
+        return
+      }
+    } catch (error) {
+      if (!isMissingModule(error, candidate)) {
+        console.error('Failed to start Tacho CLI:', error)
+        process.exit(1)
+      }
+    }
+  }
+
+  await startFromSource()
+}
+
+async function startFromSource() {
+  try {
+    // Register TSX loader so we can import TypeScript sources without building
+    await import('tsx/esm')
+    const { main } = await import(
+      new URL('../src/index.ts', binDirUrl).href
+    )
+
+    if (typeof main !== 'function') {
+      throw new Error('CLI entry did not export a main() function')
+    }
+
+    await main()
+  } catch (error) {
+    console.error(
+      'Failed to start Tacho CLI. Build artifacts missing and TSX loader unavailable.',
+      error
+    )
     process.exit(1)
-  })
+  }
+}
+
+start()

package/dist/commands/analyze-imports.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * TachUI CLI - Import Analysis Command
+ *
+ * Analyzes project imports and provides optimization recommendations
+ */
+interface AnalyzeOptions {
+    project?: string;
+    output?: string;
+    interactive?: boolean;
+    fix?: boolean;
+    threshold?: number;
+}
+declare function analyzeImports(options: AnalyzeOptions): Promise<void>;
+declare function showImportGuide(packageName?: string): Promise<void>;
+declare function showCheatSheet(): Promise<void>;
+export { analyzeImports, showImportGuide, showCheatSheet };
+//# sourceMappingURL=analyze-imports.d.ts.map

package/dist/commands/analyze-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-imports.d.ts","sourceRoot":"","sources":["../../src/commands/analyze-imports.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAWH,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAqCD,iBAAe,cAAc,CAAC,OAAO,EAAE,cAAc,iBAwFpD;AAiCD,iBAAe,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,iBAgBlD;AAED,iBAAe,cAAc,kBAI5B;AAGD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,CAAA"}