@thangnqdev/ui 0.2.0 → 0.2.1

package/bin/cli.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import readline from 'node:readline';
+import { execSync } from 'node:child_process';
+
+const CONFIG_DIR = path.join(os.homedir(), '.thangnqdev-ui');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'telemetry.json');
+
+const args = process.argv.slice(2);
+const command = args[0] || 'help';
+
+function getGitRemote() {
+  try {
+    return execSync('git remote get-url origin', {
+      stdio: ['pipe', 'pipe', 'ignore'],
+      timeout: 1000,
+    })
+      .toString()
+      .trim();
+  } catch {
+    return null;
+  }
+}
+
+function loadConfig() {
+  if (fs.existsSync(CONFIG_FILE)) {
+    try {
+      return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+    } catch {
+      return {};
+    }
+  }
+  return {};
+}
+
+function saveConfig(data) {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  fs.writeFileSync(
+    CONFIG_FILE,
+    JSON.stringify(
+      {
+        ...loadConfig(),
+        ...data,
+        updatedAt: new Date().toISOString(),
+      },
+      null,
+      2
+    )
+  );
+}
+
+switch (command) {
+  case 'showcase':
+  case 'register': {
+    const detected = getGitRemote();
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    console.log('\n\x1b[36m✦ AETHER Community Showcase Registration\x1b[0m');
+    console.log('Share your project or repository using @thangnqdev/ui:\n');
+
+    rl.question(`  Repository URL [${detected || 'none'}]: `, (repoUrl) => {
+      const finalRepo = repoUrl.trim() || detected || 'custom';
+      rl.question('  Project / Company Name (optional): ', (name) => {
+        saveConfig({
+          enabled: true,
+          repo: finalRepo,
+          projectName: name.trim() || undefined,
+          prompted: true,
+        });
+
+        console.log('\n\x1b[32m✔ Successfully registered for AETHER Community Showcase!\x1b[0m');
+        console.log(`  Repo: \x1b[33m${finalRepo}\x1b[0m\n`);
+        rl.close();
+      });
+    });
+    break;
+  }
+
+  case 'telemetry': {
+    const sub = args[1] || 'status';
+    if (sub === 'enable') {
+      const remote = getGitRemote();
+      saveConfig({ enabled: true, repo: remote, prompted: true });
+      console.log('\x1b[32m✔ Repository sharing & showcase telemetry enabled.\x1b[0m');
+    } else if (sub === 'disable') {
+      saveConfig({ enabled: false, repo: null, prompted: true });
+      console.log('\x1b[90m✔ Repository sharing & showcase telemetry disabled.\x1b[0m');
+    } else {
+      const cfg = loadConfig();
+      console.log('\n\x1b[36m✦ AETHER Telemetry & Showcase Status\x1b[0m');
+      console.log(`  Status: ${cfg.enabled ? '\x1b[32mEnabled (Sharing active)\x1b[0m' : '\x1b[90mDisabled (Anonymous)\x1b[0m'}`);
+      if (cfg.repo) console.log(`  Repository: \x1b[33m${cfg.repo}\x1b[0m`);
+      console.log('\n  Commands:');
+      console.log('    npx @thangnqdev/ui showcase          # Register project for showcase');
+      console.log('    npx @thangnqdev/ui telemetry enable   # Enable repo telemetry');
+      console.log('    npx @thangnqdev/ui telemetry disable  # Disable repo telemetry\n');
+    }
+    break;
+  }
+
+  case 'help':
+  default: {
+    console.log(`
+\x1b[1m@thangnqdev/ui CLI\x1b[0m (AETHER System)
+
+Usage:
+  npx @thangnqdev/ui <command>
+
+Commands:
+  showcase            Register repository for AETHER Community Showcase
+  telemetry status    View repository sharing & telemetry status
+  telemetry enable    Opt-in to share repository telemetry
+  telemetry disable   Opt-out from repository telemetry
+`);
+    break;
+  }
+}

package/llms.txt

@@ -1,7 +1,7 @@
 # @thangnqdev/ui — Full Architecture Component System Contract
 
 > Machine-readable specification for AI Coding Agents (Claude Code, Antigravity, Cursor, Qwen, Codex).
-> Package: `@thangnqdev/ui` (v0.2.0)
+> Package: `@thangnqdev/ui` (v0.2.1)
 > Total Registered SSOT Components: 145
 > Aesthetic Core: Spatial Optics, Editorial Bento, and Enterprise-grade Accessible Primitives.
 > Sub-module Exports: `core`, `layout`, `typography`, `buttons`, `forms`, `overlays`, `navigation`, `data-display`, `feedback`, `glass`, `bento`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thangnqdev/ui",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "description": "Spatial Optics & Editorial Bento UI System with Machine-Readable AI Contracts",
   "license": "MIT",
@@ -104,15 +104,22 @@
     "./glass/styles.css": "./dist/glass/styles.css",
     "./bento/styles.css": "./dist/bento/styles.css"
   },
+  "bin": {
+    "@thangnqdev/ui": "./bin/cli.js",
+    "aether-ui": "./bin/cli.js"
+  },
   "files": [
     "dist",
     "src",
+    "bin",
+    "scripts/postinstall.js",
     "llms.txt",
     "ui-contract.json",
     "LICENSE"
   ],
   "scripts": {
     "dev": "vite",
+    "postinstall": "node scripts/postinstall.js",
     "build:manifests": "node scripts/generate-manifests.js",
     "build:css": "node scripts/build-css.js",
     "build:ts": "tsup",

package/scripts/postinstall.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import readline from 'node:readline';
+import { execSync } from 'node:child_process';
+
+const CONFIG_DIR = path.join(os.homedir(), '.thangnqdev-ui');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'telemetry.json');
+
+// 1. Silent bailouts for CI, non-interactive environments, and opt-out flags
+if (
+  process.env.CI ||
+  process.env.CONTINUOUS_INTEGRATION ||
+  process.env.DO_NOT_TRACK === '1' ||
+  process.env.AETHER_TELEMETRY_DISABLED === '1' ||
+  !process.stdout.isTTY ||
+  !process.stdin.isTTY
+) {
+  process.exit(0);
+}
+
+// 2. Check if user has already configured preference
+if (fs.existsSync(CONFIG_FILE)) {
+  try {
+    const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+    if (config.prompted) {
+      process.exit(0);
+    }
+  } catch {
+    // Ignore corrupted config
+  }
+}
+
+function getGitRemote() {
+  try {
+    const remote = execSync('git remote get-url origin', {
+      stdio: ['pipe', 'pipe', 'ignore'],
+      timeout: 1000,
+    })
+      .toString()
+      .trim();
+    return remote;
+  } catch {
+    return null;
+  }
+}
+
+function saveConfig(data) {
+  try {
+    if (!fs.existsSync(CONFIG_DIR)) {
+      fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    fs.writeFileSync(
+      CONFIG_FILE,
+      JSON.stringify(
+        {
+          ...data,
+          updatedAt: new Date().toISOString(),
+          prompted: true,
+        },
+        null,
+        2
+      )
+    );
+  } catch {
+    // Ignore filesystem permissions error on read-only environments
+  }
+}
+
+async function promptUser() {
+  const detectedRepo = getGitRemote();
+
+  console.log('\n\x1b[36m╭────────────────────────────────────────────────────────────────────────╮\x1b[0m');
+  console.log('\x1b[36m│\x1b[0m  \x1b[1m✦ Thanks for installing @thangnqdev/ui (AETHER Spatial UI)\x1b[0m            \x1b[36m│\x1b[0m');
+  console.log('\x1b[36m│\x1b[0m                                                                        \x1b[36m│\x1b[0m');
+  console.log('\x1b[36m│\x1b[0m  Would you like to share your public repository info to be featured    \x1b[36m│\x1b[0m');
+  console.log('\x1b[36m│\x1b[0m  in the AETHER Community Showcase & project ecosystem?                 \x1b[36m│\x1b[0m');
+  if (detectedRepo) {
+    console.log(`\x1b[36m│\x1b[0m  \x1b[90mDetected repo:\x1b[0m \x1b[32m${detectedRepo.slice(0, 52)}\x1b[0m \x1b[36m│\x1b[0m`);
+  }
+  console.log('\x1b[36m│\x1b[0m                                                                        \x1b[36m│\x1b[0m');
+  console.log('\x1b[36m│\x1b[0m  \x1b[1m[y]\x1b[0m Yes, share repo info    \x1b[1m[n]\x1b[0m No, keep anonymous (Default: n)      \x1b[36m│\x1b[0m');
+  console.log('\x1b[36m╰────────────────────────────────────────────────────────────────────────╯\x1b[0m');
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    // Timeout prompt after 15 seconds so installation never hangs
+    const timer = setTimeout(() => {
+      saveConfig({ enabled: false, repo: null });
+      rl.close();
+      resolve();
+    }, 15000);
+
+    rl.question('  \x1b[33mShare repository info? (y/N):\x1b[0m ', (answer) => {
+      clearTimeout(timer);
+      const isYes = answer.trim().toLowerCase() === 'y' || answer.trim().toLowerCase() === 'yes';
+
+      if (isYes) {
+        saveConfig({
+          enabled: true,
+          repo: detectedRepo || 'manual-opt-in',
+          optedInAt: new Date().toISOString(),
+        });
+        console.log('  \x1b[32m✔ Thank you! Repository info shared with AETHER Community Showcase.\x1b[0m\n');
+      } else {
+        saveConfig({
+          enabled: false,
+          repo: null,
+        });
+        console.log('  \x1b[90m✔ Understood. Anonymous mode active. (Manage anytime via npx @thangnqdev/ui showcase)\x1b[0m\n');
+      }
+
+      rl.close();
+      resolve();
+    });
+  });
+}
+
+promptUser().catch(() => process.exit(0));

package/ui-contract.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "packageName": "@thangnqdev/ui",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "totalComponents": 145,
   "modules": {
     "core": {