@ngcorex/cli 0.1.3 → 0.1.5

package/README.md

@@ -39,6 +39,23 @@ npm install -D @ngcorex/cli
 
 > The CLI depends on `@ngcorex/css`, which will be installed automatically.
 
+### Initialize ngCorex
+
+To quickly get started, run:
+
+```bash
+ngcorex init
+```
+
+This will create:
+
+- `tokens.json`
+- `ngcorex.config.ts`
+
+If the files already exist, they will not be overwritten.
+
+***Or Create files manually:***
+
 ### Create tokens.json
 
 Create a `tokens.json` file at your project root:
@@ -86,8 +103,27 @@ export default defineNgCorexConfig({
 
 ---
 
+## Command Overview
+
+The ngCorex CLI supports the following commands:
+
+- `ngcorex init` – create starter config and tokens
+- `ngcorex build` – generate CSS from tokens
+- `ngcorex build --watch` – rebuild on file changes
+- `ngcorex build --dry-run` – validate without writing files
+- `ngcorex version` / `--version` / `-v` – print CLI version
+- `ngcorex --help` / `-h` – show help information
+
 ## Commands
 
+### Initialize
+
+```bash
+npx ngcorex init
+```
+
+---
+
 ### Build CSS
 
 ```bash
@@ -107,8 +143,8 @@ npx ngcorex build --watch
 ```
 
 - Watches `ngcorex.config.ts`
-- Rebuilds on change
-- Does not exit on errors
+- Watches `tokens.json` (if present)
+- Rebuilds CSS when either file changes
 
 ---
 
@@ -134,6 +170,16 @@ Prints the CLI version.
 
 ---
 
+### Help
+
+```bash
+npx ngcorex --help
+```
+
+Prints available commands and usage information.
+
+---
+
 ## Output
 
 The CLI generates CSS variables based on your tokens and constraints.

package/dist/commands/index.js

@@ -1,5 +1,6 @@
 import { buildCommand } from './build.js';
 import { versionCommand } from './version.js';
+import { initCommand } from './init.js';
 export async function runCommand(args) {
     const command = args[0];
     switch (command) {
@@ -11,6 +12,14 @@ export async function runCommand(args) {
         case '-v':
             await versionCommand();
             break;
+        case 'init': {
+            await initCommand();
+            return;
+        }
+        case '--help':
+        case '-h':
+            printHelp();
+            return;
         default:
             printHelp();
     }
@@ -20,6 +29,7 @@ function printHelp() {
 ngCorex CLI
 
 Usage:
+  ngcorex init         Create starter config and tokens
   ngcorex build        Generate CSS
   ngcorex build --watch
   ngcorex version      Show version

package/dist/commands/init.js

@@ -0,0 +1,50 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export async function initCommand() {
+    const cwd = process.cwd();
+    const tokensPath = path.resolve(cwd, 'tokens.json');
+    const configPath = path.resolve(cwd, 'ngcorex.config.ts');
+    let createdSomething = false;
+    // tokens.json
+    if (!fs.existsSync(tokensPath)) {
+        fs.writeFileSync(tokensPath, JSON.stringify({
+            spacing: {
+                "xs": "1rem",
+                "sm": "1.25rem"
+            },
+            colors: {
+                gray: {
+                    "100": "#f3f4f6",
+                    "900": "#111827"
+                }
+            }
+        }, null, 2));
+        console.info('✔ Created tokens.json');
+        createdSomething = true;
+    }
+    else {
+        console.info('i tokens.json already exists — skipped');
+    }
+    // ngcorex.config.ts
+    if (!fs.existsSync(configPath)) {
+        fs.writeFileSync(configPath, `import { defineNgCorexConfig } from '@ngcorex/css';
+
+export default defineNgCorexConfig({
+  output: {
+    file: 'src/styles/ngcorex.css'
+  }
+});
+`);
+        console.info('✔ Created ngcorex.config.ts');
+        createdSomething = true;
+    }
+    else {
+        console.info('i ngcorex.config.ts already exists — skipped');
+    }
+    if (createdSomething) {
+        console.info('');
+        console.info('Next steps:');
+        console.info('- Run `ngcorex build` to generate CSS');
+        console.info('- Edit tokens.json to customize your design tokens');
+    }
+}

package/dist/watch/watch-config.js

@@ -1,10 +1,15 @@
-import { watch } from 'node:fs';
+import { watch, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
 import { resolveConfigPath } from '../config/resolve-path.js';
 export function watchConfig(onChange) {
     const configPath = resolveConfigPath();
+    const tokensPath = resolve(process.cwd(), 'tokens.json');
     console.log(`✔ Watching ${configPath}`);
+    if (existsSync(tokensPath)) {
+        console.log(`✔ Watching ${tokensPath}`);
+    }
     let timeout = null;
-    watch(configPath, () => {
+    const triggerRebuild = () => {
         if (timeout) {
             clearTimeout(timeout);
         }
@@ -12,5 +17,11 @@ export function watchConfig(onChange) {
             console.log('\n↻ Rebuilding...\n');
             onChange();
         }, 100);
-    });
+    };
+    // Watch config
+    watch(configPath, triggerRebuild);
+    // Watch tokens.json (if present)
+    if (existsSync(tokensPath)) {
+        watch(tokensPath, triggerRebuild);
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngcorex/cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "CLI for ngCorex - Angular-native design token engine",
   "keywords": [
     "design-tokens",