@ngcorex/cli 0.1.2 → 0.1.4

package/README.md

@@ -1,5 +1,7 @@
 # @ngcorex/cli
 
+![NPM Version](https://img.shields.io/npm/v/%40ngcorex%2Fcli?style=flat-square&logo=npm&labelColor=%23D50100&color=%23000) ![NPM License](https://img.shields.io/npm/l/%40ngcorex%2Fcli?style=flat-square) ![Static Badge](https://img.shields.io/badge/Github-Repo-blue?style=flat-square&logo=github) ![NPM Downloads](https://img.shields.io/npm/dm/%40ngcorex%2Fcli?style=flat-square&logo=npm&logoColor=%23ffffff&labelColor=%23D50100&color=%23000)
+
 Command-line interface for **ngCorex**.
 
 This package provides the `ngcorex` CLI used to build CSS from an
@@ -37,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:

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: {
+                "1": 4,
+                "2": 8
+            },
+            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/commands/run-build.js

@@ -5,6 +5,7 @@ import { loadConfig } from '../config/load-config.js';
 import { writeCss } from '../output/write-css.js';
 import { buildCssFromConfig } from '@ngcorex/css';
 import { resolve } from 'node:path';
+let hasShownInlineTokenNotice = false;
 export async function runBuild(options = {}) {
     const configPath = resolveConfigPath();
     const config = await loadConfig(configPath);
@@ -134,6 +135,15 @@ export async function runBuild(options = {}) {
             tokens: fileTokens
         }
         : config;
+    if (!fileTokens &&
+        config.tokens &&
+        !hasShownInlineTokenNotice) {
+        console.info('');
+        console.info('ℹ️ Inline tokens detected.');
+        console.info('   Using tokens.json is recommended for larger or shared projects.');
+        console.info('');
+        hasShownInlineTokenNotice = true;
+    }
     const css = buildCssFromConfig(effectiveConfig);
     console.log('✔ Generated CSS');
     writeCss(outputPath, css, { dryRun: options.dryRun });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngcorex/cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "CLI for ngCorex - Angular-native design token engine",
   "keywords": [
     "design-tokens",
@@ -30,5 +30,12 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json"
-  }
+  },
+    "repository": {
+    "type": "git",
+    "url": "https://github.com/arkdezin/ngCorex.git",
+    "directory": "packages/cli"
+  },
+
+  "homepage": "https://github.com/arkdezin/ngCorex"
 }