truncgil-uxigl 0.0.0-stage → 2.5.2

package/README.md

@@ -1,3 +1,125 @@
-# Temporary Holding Version
+# uxiGL — Modular Liquid Glass × Google Material You Design System
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **Uniting User Experience (UX), User Interface (UI), and Hardware-Accelerated WebGL (`SheetGL` + `FileManGL`) into a Single Enterprise Architecture.**
+
+[![Version](https://img.shields.io/badge/version-2.5.0-0284c7.svg)](https://github.com/umitunc)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178c6.svg)](https://www.typescriptlang.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-10b981.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 🎨 Brand Identity & Single-Glyph Monogram (`U` + `X` + `I`)
+
+**`uxiGL`** is part of the `GL` ecosystem alongside **`SheetGL`** and **`FileManGL`**.
+
+The [`UXILogo`](src/components/brand/UXILogo.tsx) emblem reduces the three letters **U**, **X**, and **I** into a **single unified 3D Liquid-Glass glyph**:
+1. **`U` — Outer Liquid-Glass Cradle:** The outer continuous ribbon forms a 3D `U` bowl that holds the entire symbol.
+2. **`X` — Intersecting Diagonal Blades:** Two crossed diagonal light ribbons (`\ /`) bridge the arms of the `U`.
+3. **`I` — Central Crystalline Pillar:** A vertical luminescent spine passes directly through the center of the `X` and `U`, crowned with a floating diamond node (`•`).
+
+---
+
+## ✨ Key Architectural Highlights
+
+1. **Liquid Glass & Standard Materials:**
+   - **Liquid Glass (`Regular` & `Clear`):** Reserved strictly for the floating navigation and transient control layer (`Sidebar`, `TopHeader`, `CommandPalette`, `SegmentedControl`, `Slider` & `Switch` thumbs).
+   - **Standard Materials (`UltraThin`, `Thin`, `Regular`, `Thick`):** Applied to the content layer (`Card`, `DataTable`, KPI panels) with 4-tier **Vibrancy** (`label-primary`, `label-secondary`, `label-tertiary`, `fill-vibrant`).
+2. **Google Material You (M3) & Live `0px–32px` Border Radius Engine:**
+   - **6 Seed Color Palettes:** *Cupertino Blue, Material Iris, Emerald Mint, Sunset Coral, Amber Gold, Graphite Mono* with automatic dark/light tonal adaptation.
+   - **Live Corner Geometry (`0px–32px`):** Switch between `Sharp (4px)`, `Squircle (12px)`, `Pill (22px)`, or fine-tune any pixel radius (`0px–32px`) from the TopHeader (`R- | R:12px | R+`), Component Playground, or Theme Studio Drawer.
+   - **Global Font Scale (`80%–125%`):** Real-time root `rem` scaling persisted in `localStorage`.
+3. **Dual Data Table Architecture (`SheetGL` + Native `<DataTable />`):**
+   - **`SheetGLGridAdapter` (WebGL/Canvas DataGrid):** Includes **4 enterprise scenarios** (*SaaS & Enterprise Finance*, *AI & Cloud Node Telemetry*, *Workforce & Payroll Matrix*, *Global Logistics & SKU Inventory*) with live formula evaluation, sorting, filtering, and CSV export.
+   - **Native `<DataTable />`:** Zero-GPU semantic HTML table with **4 visual variants** (`default`, `striped`, `bordered`, `compact`), column sorting, search filtering, and row selection.
+4. **FileManGL WebGL2 Virtual File System (`FileManGLExplorerAdapter`):**
+   - Windows 11 tabbed explorer UX, 3D Spatial View (`webgl_spatial`), Disk Treemap (`webgl_diskmap`), and a 5-layer **NTFS ACL + POSIX (`0755`)** permission engine.
+5. **Clean HTML5 History API Routing (`RouteService`):**
+   - Every navigation item, tab, breadcrumb, and component renders as a semantic `<a href="...">` with clean URLs (`/`, `/dashboard/*`, `/components/*`, `/docs/*`) and full browser Back/Forward (`popstate`) support.
+6. **Zero Idle CPU/GPU Resource Footprint & SOLID Principles:**
+   - Single-Active-Engine policy ensures only one heavy canvas (`SheetGL` or `FileManGL`) is mounted per view.
+   - Strict Dependency Inversion (`ThemeEngineService`, `StorageService`, `RouteService`) and Open/Closed component contracts.
+
+---
+
+## 🔗 Application Route Map
+
+| URL Route | View / Module | Description |
+| :--- | :--- | :--- |
+| `/` | `UXILandingPage` | Full-screen `uxiGL` product landing page with live interactive preview & phonetic guide |
+| `/dashboard/overview` | `AppleGoogleAppShowcase` | Command Center Overview (KPIs, neural telemetry, native table & SheetGL summary) |
+| `/dashboard/analytics` | `AppleGoogleAppShowcase` | Live Analytics & Regional Performance Matrix |
+| `/dashboard/crm-orders` | `SheetGLGridAdapter` | Full-page SheetGL (4 enterprise presets) + Native `<DataTable />` comparison |
+| `/dashboard/file-manager` | `FileManGLExplorerAdapter` | Full-page FileManGL WebGL2 Virtual File System Explorer |
+| `/dashboard/smart-cluster` | `AppleGoogleAppShowcase` | AI Neural Engine Compilation & Hardware Cluster Controls |
+| `/components/inputs/:id` | `InteractivePlayground` | Form Controls (`button`, `input`, `switch`, `checkbox`, `slider`) |
+| `/components/surfaces/:id` | `InteractivePlayground` | Surfaces & Navigation (`card`, `segmented-control`, `tabs-accordion`, `modal-command`) |
+| `/components/feedback/:id` | `InteractivePlayground` | Data & Feedback (`chips-badges`, `progress-avatar`, `datatable-statcard`, `filemangl-explorer`) |
+| `/docs/:topic` | `ArchitectureDocsView` | Interactive Documentation (`getting-started`, `theming-tokens`, `layout-shell`, `cli-shortcuts`) |
+
+---
+
+## 🚀 Quick Start (Single-Command Setup)
+
+### 1. Install `uxiGL` (All-in-One Design System)
+
+```bash
+# SheetGL (WebGL DataGrid), FileManGL (WebGL2 VFS) and Lucide Icons are bundled directly!
+npm install uxigl
+# or: pnpm add uxigl | yarn add uxigl | bun add uxigl
+```
+
+### 2. Scaffold Ready-to-Use Workspace via NPX
+
+```bash
+# Generates a pre-configured <UXIWorkspace /> component & theme setup
+npx uxigl init
+```
+
+### 3. Usage Example
+
+```tsx
+import React from 'react';
+import {
+  ThemeProvider,
+  ToastProvider,
+  Button,
+  Card,
+  SheetGLGridAdapter,
+  FileManGLExplorerAdapter,
+} from 'uxigl';
+import 'uxigl/styles';
+
+export default function App() {
+  return (
+    <ThemeProvider defaultTheme="system" defaultRadius={12}>
+      <ToastProvider>
+        <Card variant="glass" title="uxiGL Enterprise Dashboard">
+          <SheetGLGridAdapter scenario="saas_finance" />
+        </Card>
+      </ToastProvider>
+    </ThemeProvider>
+  );
+}
+```
+
+### 4. Local Development & NPM Library Build
+
+```bash
+# Start Vite development server
+npm run dev
+
+# Build both demo SPA (dist/index.html) and npm library bundle (dist/lib)
+npm run build
+
+# Or compile the npm library & TypeScript declarations only
+npm run build:lib
+
+# Run package diagnostics
+npm run doctor
+```
+
+---
+
+## 📄 License
+
+MIT License • Crafted with ❤️ by [Trunçgil Teknoloji](https://www.truncgil.com)

package/bin/cli.mjs

@@ -0,0 +1,410 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const pkgRoot = path.resolve(__dirname, '..');
+
+const CYAN = '\x1b[36m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+const RESET = '\x1b[0m';
+
+function readPkgVersion() {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(pkgRoot, 'package.json'), 'utf8'));
+    return pkg.version || '2.5.1';
+  } catch {
+    return '2.5.1';
+  }
+}
+
+function printBanner() {
+  const version = readPkgVersion();
+  console.log(`
+${CYAN}${BOLD}  ╔══════════════════════════════════════════════════════════════════════╗
+  ║   ⚡ uxiGL v${version} — Liquid Glass & Google Material You Design System  ║
+  ║   SheetGL (WebGL DataGrid) + FileManGL (WebGL2 VFS) Unified Suite    ║
+  ╚══════════════════════════════════════════════════════════════════════╝${RESET}
+`);
+}
+
+function printHelp() {
+  printBanner();
+  console.log(`${BOLD}Usage:${RESET}
+  npx uxigl <command> [options]
+  npmx uxigl <command> [options]
+
+${BOLD}Commands:${RESET}
+  ${GREEN}init${RESET} [target-file]      Generate a ready-to-use <UXIWorkspace /> component in your React project
+                          (Default: src/components/UXIWorkspace.tsx)
+  ${GREEN}create${RESET} <project-name>   Scaffold a new Vite + React + TypeScript + uxiGL starter app
+  ${GREEN}demo${RESET}                    Launch the interactive uxiGL Showcase & Documentation server
+  ${GREEN}doctor${RESET}                  Verify Node.js, build artifacts, styles, and environment readiness
+  ${GREEN}help${RESET}                    Show this help message
+
+${BOLD}Single-Command Installation:${RESET}
+  ${DIM}# npm / pnpm / yarn / bun (SheetGL & FileManGL included):${RESET}
+  npm install uxigl
+  pnpm add uxigl
+  yarn add uxigl
+  bun add uxigl
+
+${BOLD}CLI Examples:${RESET}
+  ${DIM}# 1. Generate ready-to-use UXIWorkspace.tsx component:${RESET}
+  npx uxigl init
+
+  ${DIM}# 2. Scaffold a brand-new starter project:${RESET}
+  npx uxigl create my-uxigl-app
+`);
+}
+
+const STARTER_COMPONENT_TEMPLATE = `import React, { useState } from 'react';
+import {
+  ThemeProvider,
+  ToastProvider,
+  Card,
+  Button,
+  Input,
+  Badge,
+  Switch,
+  SheetGLGridAdapter,
+  FileManGLExplorerAdapter,
+  UXILogo,
+} from 'uxigl';
+import 'uxigl/styles';
+
+export function UXIWorkspace() {
+  const [activeTab, setActiveTab] = useState<'overview' | 'sheet' | 'files'>('overview');
+  const [metricEnabled, setMetricEnabled] = useState(true);
+
+  return (
+    <ThemeProvider defaultTheme="system" defaultRadius={12}>
+      <ToastProvider>
+        <div
+          style={{
+            minHeight: '100vh',
+            padding: '24px',
+            backgroundColor: 'var(--uxu-surface-base)',
+            color: 'var(--uxu-text-primary)',
+            fontFamily: 'var(--uxu-font-sans)',
+            display: 'flex',
+            flexDirection: 'column',
+            gap: 20,
+          }}
+        >
+          {/* Top Control Bar */}
+          <header
+            style={{
+              display: 'flex',
+              alignItems: 'center',
+              justifyContent: 'space-between',
+              padding: '14px 20px',
+              borderRadius: 'var(--uxu-radius-lg)',
+              backgroundColor: 'var(--uxu-surface-glass-regular)',
+              border: '1px solid var(--uxu-border-subtle)',
+              backdropFilter: 'blur(20px)',
+            }}
+          >
+            <div style={{ display: 'flex', alignItems: 'center', gap: 12 }}>
+              <UXILogo size={36} animated />
+              <div>
+                <h1 style={{ margin: 0, fontSize: '1.2rem', fontWeight: 800 }}>uxiGL Unified Workspace</h1>
+                <p style={{ margin: 0, fontSize: '0.78rem', color: 'var(--uxu-text-secondary)' }}>
+                  Liquid Glass & M3 Design System with WebGL Accelerators
+                </p>
+              </div>
+            </div>
+
+            <div style={{ display: 'flex', alignItems: 'center', gap: 8 }}>
+              <Button
+                variant={activeTab === 'overview' ? 'primary' : 'ghost'}
+                size="sm"
+                onClick={() => setActiveTab('overview')}
+              >
+                Genel Bakış
+              </Button>
+              <Button
+                variant={activeTab === 'sheet' ? 'primary' : 'ghost'}
+                size="sm"
+                onClick={() => setActiveTab('sheet')}
+              >
+                SheetGL (DataGrid)
+              </Button>
+              <Button
+                variant={activeTab === 'files' ? 'primary' : 'ghost'}
+                size="sm"
+                onClick={() => setActiveTab('files')}
+              >
+                FileManGL (VFS)
+              </Button>
+            </div>
+          </header>
+
+          {/* Active View */}
+          {activeTab === 'overview' && (
+            <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(280px, 1fr))', gap: 16 }}>
+              <Card variant="glass" title="uxiGL Tasarım Sistemi">
+                <p style={{ fontSize: '0.88rem', color: 'var(--uxu-text-secondary)', lineHeight: 1.5 }}>
+                  Liquid Glass tabakası, canlı 0px–32px köşe geometrisi ve Google Material You tonal renk paletleri.
+                </p>
+                <div style={{ display: 'flex', alignItems: 'center', gap: 8, marginTop: 14 }}>
+                  <Badge variant="success">Hazır</Badge>
+                  <Badge variant="info">v2.5.1</Badge>
+                  <Badge variant="default">WebGL Hızlandırmalı</Badge>
+                </div>
+              </Card>
+
+              <Card variant="glass" title="Bileşen Örnekleri">
+                <div style={{ display: 'flex', flexDirection: 'column', gap: 12 }}>
+                  <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between' }}>
+                    <span style={{ fontSize: '0.88rem' }}>Donanım Hızlandırması</span>
+                    <Switch checked={metricEnabled} onChange={setMetricEnabled} />
+                  </div>
+                  <Input placeholder="Hızlı komut veya arama filtresi..." />
+                </div>
+              </Card>
+            </div>
+          )}
+
+          {activeTab === 'sheet' && (
+            <div style={{ height: '680px', borderRadius: 'var(--uxu-radius-lg)', overflow: 'hidden' }}>
+              <SheetGLGridAdapter scenario="saas_finance" />
+            </div>
+          )}
+
+          {activeTab === 'files' && (
+            <div style={{ height: '680px', borderRadius: 'var(--uxu-radius-lg)', overflow: 'hidden' }}>
+              <FileManGLExplorerAdapter initialPath="/workspace/projects" />
+            </div>
+          )}
+        </div>
+      </ToastProvider>
+    </ThemeProvider>
+  );
+}
+
+export default UXIWorkspace;
+`;
+
+function handleInit(rawArgs) {
+  printBanner();
+  let dirOpt = null;
+  let nameOpt = null;
+  let positionalPath = null;
+
+  for (let i = 0; i < rawArgs.length; i++) {
+    const arg = rawArgs[i];
+    if (arg === '--dir' || arg === '-d') {
+      dirOpt = rawArgs[++i];
+    } else if (arg === '--name' || arg === '-n') {
+      nameOpt = rawArgs[++i];
+    } else if (!arg.startsWith('-') && !positionalPath) {
+      positionalPath = arg;
+    }
+  }
+
+  const componentName = (nameOpt || 'UXIWorkspace').replace(/\.(tsx|ts|jsx|js)$/i, '');
+  const defaultRelPath = path.join(dirOpt || 'src/components', `${componentName}.tsx`);
+  const outPath = path.resolve(process.cwd(), positionalPath || defaultRelPath);
+  const outDir = path.dirname(outPath);
+
+  if (!fs.existsSync(outDir)) {
+    fs.mkdirSync(outDir, { recursive: true });
+  }
+
+  const customizedTemplate = STARTER_COMPONENT_TEMPLATE.replace(/UXIWorkspace/g, componentName);
+
+  fs.writeFileSync(outPath, customizedTemplate, 'utf8');
+  console.log(`${GREEN}✔ Created uxiGL starter component at:${RESET} ${BOLD}${outPath}${RESET}`);
+  console.log(`
+${BOLD}Next steps:${RESET}
+  1. Ensure ${CYAN}uxigl${RESET} is installed in your project:
+     ${YELLOW}npm install uxigl${RESET}
+  2. Import and render ${CYAN}<${componentName} />${RESET} in your ${BOLD}App.tsx${RESET}:
+     ${DIM}import { ${componentName} } from './components/${componentName}';${RESET}
+`);
+}
+
+function handleCreate(projectName) {
+  printBanner();
+  if (!projectName) {
+    console.error(`${YELLOW}⚠ Please specify a project directory name:${RESET}\n  npx uxigl create my-uxigl-app`);
+    process.exit(1);
+  }
+
+  const targetDir = path.resolve(process.cwd(), projectName);
+  if (fs.existsSync(targetDir) && fs.readdirSync(targetDir).length > 0) {
+    console.error(`${YELLOW}⚠ Target directory "${projectName}" already exists and is not empty.${RESET}`);
+    process.exit(1);
+  }
+
+  fs.mkdirSync(path.join(targetDir, 'src', 'components'), { recursive: true });
+
+  const appPkg = {
+    name: projectName.toLowerCase().replace(/[^a-z0-9-_]/g, '-'),
+    private: true,
+    version: '0.1.0',
+    type: 'module',
+    scripts: {
+      dev: 'vite',
+      build: 'tsc && vite build',
+      preview: 'vite preview',
+    },
+    dependencies: {
+      uxigl: `^${readPkgVersion()}`,
+      react: '^19.0.0',
+      'react-dom': '^19.0.0',
+    },
+    devDependencies: {
+      '@types/react': '^19.0.0',
+      '@types/react-dom': '^19.0.0',
+      '@vitejs/plugin-react': '^4.3.4',
+      typescript: '~5.7.2',
+      vite: '^6.2.0',
+    },
+  };
+
+  fs.writeFileSync(path.join(targetDir, 'package.json'), JSON.stringify(appPkg, null, 2), 'utf8');
+  fs.writeFileSync(
+    path.join(targetDir, 'index.html'),
+    `<!doctype html>
+<html lang="tr" class="dark">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${projectName} — uxiGL</title>
+    <link href="https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;600&display=swap" rel="stylesheet" />
+  </head>
+  <body style="margin:0;padding:0;background:#06080e;color:#f8fafc;">
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`,
+    'utf8'
+  );
+
+  fs.writeFileSync(
+    path.join(targetDir, 'vite.config.ts'),
+    `import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig({
+  plugins: [react()],
+});
+`,
+    'utf8'
+  );
+
+  fs.writeFileSync(
+    path.join(targetDir, 'tsconfig.json'),
+    JSON.stringify(
+      {
+        compilerOptions: {
+          target: 'ES2022',
+          lib: ['ES2022', 'DOM', 'DOM.Iterable'],
+          module: 'ESNext',
+          moduleResolution: 'bundler',
+          jsx: 'react-jsx',
+          strict: true,
+          skipLibCheck: true,
+          noEmit: true,
+        },
+        include: ['src'],
+      },
+      null,
+      2
+    ),
+    'utf8'
+  );
+
+  fs.writeFileSync(
+    path.join(targetDir, 'src', 'components', 'UXIWorkspace.tsx'),
+    STARTER_COMPONENT_TEMPLATE,
+    'utf8'
+  );
+  fs.writeFileSync(
+    path.join(targetDir, 'src', 'App.tsx'),
+    `import React from 'react';
+import { UXIWorkspace } from './components/UXIWorkspace';
+
+export default function App() {
+  return <UXIWorkspace />;
+}
+`,
+    'utf8'
+  );
+  fs.writeFileSync(
+    path.join(targetDir, 'src', 'main.tsx'),
+    `import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);
+`,
+    'utf8'
+  );
+
+  console.log(`${GREEN}✔ Scaffolded new uxiGL project in:${RESET} ${BOLD}${targetDir}${RESET}\n`);
+  console.log(`${BOLD}Run the following commands to start:${RESET}
+  ${CYAN}cd ${projectName}${RESET}
+  ${CYAN}npm install${RESET}
+  ${CYAN}npm run dev${RESET}
+`);
+}
+
+function handleDoctor() {
+  printBanner();
+  const esmBundle = path.join(pkgRoot, 'dist', 'lib', 'uxigl.js');
+  const cjsBundle = path.join(pkgRoot, 'dist', 'lib', 'uxigl.cjs');
+  const cssBundle = path.join(pkgRoot, 'dist', 'lib', 'style.css');
+  const dtsBundle = path.join(pkgRoot, 'dist', 'lib', 'types', 'index.d.ts');
+  const demoIndex = path.join(pkgRoot, 'dist', 'index.html');
+
+  console.log(`${BOLD}Environment & Package Diagnostics:${RESET}`);
+  console.log(`  • Node.js Runtime : ${GREEN}${process.version}${RESET}`);
+  console.log(`  • Platform / Arch : ${process.platform} (${process.arch})`);
+  console.log(`  • ESM Library     : ${fs.existsSync(esmBundle) ? `${GREEN}✔ Ready (dist/lib/uxigl.js)${RESET}` : `${YELLOW}⚠ Missing (run npm run build:lib)${RESET}`}`);
+  console.log(`  • CJS Library     : ${fs.existsSync(cjsBundle) ? `${GREEN}✔ Ready (dist/lib/uxigl.cjs)${RESET}` : `${YELLOW}⚠ Missing (run npm run build:lib)${RESET}`}`);
+  console.log(`  • CSS Stylesheet  : ${fs.existsSync(cssBundle) ? `${GREEN}✔ Ready (dist/lib/style.css)${RESET}` : `${YELLOW}⚠ Missing (run npm run build:lib)${RESET}`}`);
+  console.log(`  • TypeScript .d.ts: ${fs.existsSync(dtsBundle) ? `${GREEN}✔ Ready (dist/lib/types/index.d.ts)${RESET}` : `${YELLOW}⚠ Missing (run npm run build:lib)${RESET}`}`);
+  console.log(`  • Demo SPA Bundle : ${fs.existsSync(demoIndex) ? `${GREEN}✔ Ready (dist/index.html)${RESET}` : `${YELLOW}⚠ Missing (run npm run build:demo)${RESET}`}`);
+  console.log('');
+}
+
+function handleDemo() {
+  printBanner();
+  console.log(`${CYAN}Starting uxiGL Showcase & Documentation server...${RESET}\n`);
+  spawnSync('npx', ['vite'], { cwd: pkgRoot, stdio: 'inherit', shell: true });
+}
+
+const args = process.argv.slice(2);
+const invokedBin = path.basename(process.argv[1] || '');
+const cmd = (args[0] || 'help').toLowerCase();
+
+if (invokedBin.includes('create-uxigl') && args[0] && !['init', 'create', 'doctor', 'demo', 'help', '-v', '--version'].includes(cmd)) {
+  handleCreate(args[0]);
+} else if (cmd === 'init' || cmd === 'setup') {
+  handleInit(args.slice(1));
+} else if (cmd === 'create') {
+  handleCreate(args[1]);
+} else if (cmd === 'doctor' || cmd === 'info' || cmd === 'check') {
+  handleDoctor();
+} else if (cmd === 'demo' || cmd === 'studio' || cmd === 'start') {
+  handleDemo();
+} else if (cmd === '-v' || cmd === '--version' || cmd === 'version') {
+  console.log(readPkgVersion());
+} else {
+  printHelp();
+}