agnosticui-cli 2.0.0-alpha.10

package/README.md

@@ -0,0 +1,135 @@
+# agnosticui-cli
+
+CLI for AgnosticUI Local - The UI kit that lives in your codebase.
+
+> **See also:** Developer guide (build, test, publish) at [`v2/docs/CLI.md`](../docs/CLI.md)
+
+## What is AgnosticUI Local?
+
+AgnosticUI Local is a new approach to UI libraries. Instead of installing components as a dependency in `node_modules/`, the entire library lives in your project as a **reference library**, and you copy components you need into your own source code.
+
+**Benefits:**
+
+- **AI-Friendly**: Your entire component library is visible to AI coding tools (Cursor, Windsurf, Claude)
+- **Complete Ownership**: Components are copied to your project - modify them however you want
+- **Zero Lock-in**: No black boxes, no vendor dependencies
+- **Upgrade Safety**: Reference library updates independently from your customized components
+
+## Installation
+
+```bash
+# Initialize AgnosticUI in your project
+npx agnosticui-cli@alpha init
+
+# Or install globally
+npm install -g agnosticui-cli@alpha
+ag init
+```
+
+## Quick Start
+
+```bash
+# 1. Initialize (creates reference library in ./agnosticui/)
+npx ag init --framework react
+
+# 2. Add components to your project
+npx ag add button input checkbox
+
+# 3. List available components
+npx ag list
+
+# 4. Import and use in your code
+import { ReactButton } from './components/ag/Button/react'
+```
+
+## Commands
+
+### `ag init`
+
+Initialize AgnosticUI Local in your project.
+
+```bash
+ag init [options]
+
+Options:
+  -f, --framework <framework>      Framework to use: react, vue, lit, svelte
+  -p, --components-path <path>     Where to generate components (default: ./src/components/ag)
+```
+
+**Example:**
+
+```bash
+ag init --framework react --components-path ./src/components/ag
+```
+
+### `ag add <components...>`
+
+Add one or more components to your project.
+
+```bash
+ag add <components...> [options]
+
+Options:
+  --force    Overwrite existing components
+
+Examples:
+  ag add button                    # Add single component
+  ag add button input checkbox     # Add multiple components
+  ag add button --force            # Overwrite existing
+```
+
+### `ag list`
+
+List all available components and show which are already added.
+
+```bash
+ag list
+```
+
+### `ag sync`
+
+Update the reference library to the latest version (your customized components are never touched).
+
+```bash
+ag sync
+```
+
+## How It Works
+
+After running `ag init`, your project structure looks like this:
+
+```
+your-project/
+├── agnosticui/                    # Reference library (all components)
+│   ├── lib/src/components/        # Source for all 56 components
+│   └── docs/                      # Documentation
+├── src/components/ag/             # YOUR components (copied, customizable)
+│   ├── Button/                    # You own this code
+│   └── Input/                     # Modify freely
+└── agnosticui.config.json         # CLI configuration
+```
+
+**The workflow:**
+
+1. **Reference library** (`./agnosticui/`) - Full library for context, visible to AI tools
+2. **Your components** (`./src/components/ag/`) - Copied components you can customize
+3. **Update safely** - `ag sync` updates reference, never touches your code
+
+## Framework Support
+
+AgnosticUI supports React, Vue 3, Lit, and Svelte:
+
+- **React**: Components using @lit/react wrappers
+- **Vue 3**: Vue components using Composition API
+- **Lit**: Native web components
+- **Svelte**: Direct web component support (excellent compatibility)
+
+## More Information
+
+- [GitHub Repository](https://github.com/AgnosticUI/agnosticui)
+- [Documentation](https://www.agnosticui.com)
+- [Component Library Package](https://www.npmjs.com/package/agnosticui-core)
+
+## License
+
+Apache-2.0

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+/**
+ * AgnosticUI CLI - Main entry point
+ *
+ * Package Resolution Strategy:
+ * ============================
+ *
+ * The CLI uses a two-tier approach to locate the AgnosticUI core library:
+ *
+ * 1. Local Development (Priority):
+ *    - Checks for: ../../dist/agnosticui-local-v2.0.0-alpha.tar.gz
+ *    - Built via: ./scripts/build-local-tarball.sh
+ *    - Used for: Testing changes before publishing
+ *
+ * 2. Production (NPM Registry):
+ *    - Downloads: agnosticui-core@{version} from NPM
+ *    - Command: npm pack agnosticui-core@alpha (or latest, or specific version)
+ *    - Used for: Production installations after publishing
+ *
+ * Package Naming:
+ * - Local tarball:  agnosticui-local-v*.tar.gz
+ * - NPM package:    agnosticui-core
+ * - This CLI:       agnosticui-cli
+ *
+ * Note: The different naming prevents confusion between local dev builds
+ * and published NPM packages.
+ *
+ * See: v2/cli/README.md "Testing After NPM Publication" for verification steps.
+ */
+import { Command } from 'commander';
+import { init } from './commands/init.js';
+import { add } from './commands/add.js';
+import { remove } from './commands/remove.js';
+import { list } from './commands/list.js';
+import { sync } from './commands/sync.js';
+const program = new Command();
+program
+    .name('ag')
+    .description('AgnosticUI Local - The UI kit that lives in your codebase')
+    .version('2.0.0-alpha.9');
+// ag init command
+program
+    .command('init')
+    .description('Initialize AgnosticUI Local in your project')
+    .option('-f, --framework <framework>', 'Framework to use (react, vue, lit, svelte)')
+    .option('-p, --components-path <path>', 'Path where components will be generated')
+    .option('-t, --tarball <path>', 'Path to local tarball (for development)')
+    .option('-v, --version <version>', 'NPM version to download (e.g., alpha, latest, 2.0.0)', 'alpha')
+    .option('--skip-prompts', 'Skip all interactive prompts (non-interactive mode)')
+    .action(async (options) => {
+    await init({
+        framework: options.framework,
+        componentsPath: options.componentsPath,
+        tarball: options.tarball,
+        version: options.version,
+        skipPrompts: options.skipPrompts,
+    });
+});
+// ag add command
+program
+    .command('add <components...>')
+    .description('Add component(s) to your project')
+    .option('--force', 'Overwrite existing components')
+    .action(async (components, options) => {
+    await add(components, {
+        force: options.force,
+    });
+});
+// ag remove command
+program
+    .command('remove <components...>')
+    .description('Remove component(s) from your project')
+    .option('--force', 'Skip confirmation prompt')
+    .action(async (components, options) => {
+    await remove(components, {
+        force: options.force,
+    });
+});
+// ag list command
+program
+    .command('list')
+    .description('List available components')
+    .action(async () => {
+    await list();
+});
+// ag sync command
+program
+    .command('sync')
+    .description('Update reference library from tarball')
+    .option('-t, --tarball <path>', 'Path to tarball (overrides config)')
+    .option('--force', 'Bypass confirmation prompt')
+    .action(async (options) => {
+    await sync({
+        tarball: options.tarball,
+        force: options.force,
+    });
+});
+// Parse arguments
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/add.d.ts

@@ -0,0 +1,3 @@
+import type { AddOptions } from '../types/index.js';
+export declare function add(componentNames: string[], options?: AddOptions): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,mBAAmB,CAAC;AAe/D,wBAAsB,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAiN3F"}