@thangnqdev/ui 0.1.2 → 0.2.1

package/package.json

@@ -1,116 +1,167 @@
-{
-  "name": "@thangnqdev/ui",
-  "version": "0.1.2",
-  "type": "module",
-  "description": "Spatial Optics & Editorial Bento UI System",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./core": {
-      "types": "./dist/core/index.d.ts",
-      "import": "./dist/core/index.js",
-      "require": "./dist/core/index.cjs"
-    },
-    "./layout": {
-      "types": "./dist/layout/index.d.ts",
-      "import": "./dist/layout/index.js",
-      "require": "./dist/layout/index.cjs"
-    },
-    "./typography": {
-      "types": "./dist/typography/index.d.ts",
-      "import": "./dist/typography/index.js",
-      "require": "./dist/typography/index.cjs"
-    },
-    "./buttons": {
-      "types": "./dist/buttons/index.d.ts",
-      "import": "./dist/buttons/index.js",
-      "require": "./dist/buttons/index.cjs"
-    },
-    "./forms": {
-      "types": "./dist/forms/index.d.ts",
-      "import": "./dist/forms/index.js",
-      "require": "./dist/forms/index.cjs"
-    },
-    "./overlays": {
-      "types": "./dist/overlays/index.d.ts",
-      "import": "./dist/overlays/index.js",
-      "require": "./dist/overlays/index.cjs"
-    },
-    "./navigation": {
-      "types": "./dist/navigation/index.d.ts",
-      "import": "./dist/navigation/index.js",
-      "require": "./dist/navigation/index.cjs"
-    },
-    "./data-display": {
-      "types": "./dist/data-display/index.d.ts",
-      "import": "./dist/data-display/index.js",
-      "require": "./dist/data-display/index.cjs"
-    },
-    "./feedback": {
-      "types": "./dist/feedback/index.d.ts",
-      "import": "./dist/feedback/index.js",
-      "require": "./dist/feedback/index.cjs"
-    },
-    "./glass": {
-      "types": "./dist/glass/index.d.ts",
-      "import": "./dist/glass/index.js",
-      "require": "./dist/glass/index.cjs"
-    },
-    "./bento": {
-      "types": "./dist/bento/index.d.ts",
-      "import": "./dist/bento/index.js",
-      "require": "./dist/bento/index.cjs"
-    },
-    "./styles.css": "./dist/styles.css",
-    "./glass/styles.css": "./dist/glass/styles.css",
-    "./bento/styles.css": "./dist/bento/styles.css"
-  },
-  "files": [
-    "dist",
-    "src",
-    "llms.txt",
-    "ui-contract.json"
-  ],
-  "scripts": {
-    "dev": "vite",
-    "build": "tsup && node scripts/build-css.js",
-    "build:lib": "tsup && node scripts/build-css.js",
-    "watch:lib": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "preview": "vite preview"
-  },
-  "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
-  },
-  "dependencies": {
-    "class-variance-authority": "^0.7.1",
-    "clsx": "^2.1.1",
-    "lucide-react": "^1.16.0",
-    "tailwind-merge": "^3.0.2"
-  },
-  "devDependencies": {
-    "@tailwindcss/vite": "^4.3.3",
-    "@testing-library/dom": "^10.4.1",
-    "@testing-library/jest-dom": "^7.0.1",
-    "@testing-library/react": "^16.3.2",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "@vitejs/plugin-react": "^6.0.5",
-    "jsdom": "^30.0.1",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "tailwindcss": "^4.3.3",
-    "tsup": "^8.3.6",
-    "typescript": "^5.7.3",
-    "vite": "^8.2.1",
-    "vitest": "^3.0.7"
-  }
-}
+{
+  "name": "@thangnqdev/ui",
+  "version": "0.2.1",
+  "type": "module",
+  "description": "Spatial Optics & Editorial Bento UI System with Machine-Readable AI Contracts",
+  "license": "MIT",
+  "author": "thangnqdev",
+  "keywords": [
+    "react",
+    "ui",
+    "design-system",
+    "tailwind",
+    "spatial-optics",
+    "bento",
+    "accessibility",
+    "wcag",
+    "ssot",
+    "enterprise"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "sideEffects": [
+    "*.css",
+    "**/*.css"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "require": "./dist/core/index.cjs"
+    },
+    "./layout": {
+      "types": "./dist/layout/index.d.ts",
+      "import": "./dist/layout/index.js",
+      "require": "./dist/layout/index.cjs"
+    },
+    "./typography": {
+      "types": "./dist/typography/index.d.ts",
+      "import": "./dist/typography/index.js",
+      "require": "./dist/typography/index.cjs"
+    },
+    "./buttons": {
+      "types": "./dist/buttons/index.d.ts",
+      "import": "./dist/buttons/index.js",
+      "require": "./dist/buttons/index.cjs"
+    },
+    "./forms": {
+      "types": "./dist/forms/index.d.ts",
+      "import": "./dist/forms/index.js",
+      "require": "./dist/forms/index.cjs"
+    },
+    "./overlays": {
+      "types": "./dist/overlays/index.d.ts",
+      "import": "./dist/overlays/index.js",
+      "require": "./dist/overlays/index.cjs"
+    },
+    "./navigation": {
+      "types": "./dist/navigation/index.d.ts",
+      "import": "./dist/navigation/index.js",
+      "require": "./dist/navigation/index.cjs"
+    },
+    "./data-display": {
+      "types": "./dist/data-display/index.d.ts",
+      "import": "./dist/data-display/index.js",
+      "require": "./dist/data-display/index.cjs"
+    },
+    "./feedback": {
+      "types": "./dist/feedback/index.d.ts",
+      "import": "./dist/feedback/index.js",
+      "require": "./dist/feedback/index.cjs"
+    },
+    "./glass": {
+      "types": "./dist/glass/index.d.ts",
+      "import": "./dist/glass/index.js",
+      "require": "./dist/glass/index.cjs"
+    },
+    "./bento": {
+      "types": "./dist/bento/index.d.ts",
+      "import": "./dist/bento/index.js",
+      "require": "./dist/bento/index.cjs"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./tokens.css": "./dist/tokens.css",
+    "./components.css": "./dist/components.css",
+    "./reset.css": "./dist/reset.css",
+    "./core/styles.css": "./dist/core/styles.css",
+    "./layout/styles.css": "./dist/layout/styles.css",
+    "./typography/styles.css": "./dist/typography/styles.css",
+    "./buttons/styles.css": "./dist/buttons/styles.css",
+    "./forms/styles.css": "./dist/forms/styles.css",
+    "./overlays/styles.css": "./dist/overlays/styles.css",
+    "./navigation/styles.css": "./dist/navigation/styles.css",
+    "./data-display/styles.css": "./dist/data-display/styles.css",
+    "./feedback/styles.css": "./dist/feedback/styles.css",
+    "./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",
+    "build": "node scripts/generate-manifests.js && tsup && node scripts/build-css.js",
+    "build:lib": "node scripts/generate-manifests.js && tsup && node scripts/build-css.js",
+    "watch:lib": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:ssot": "vitest run tests/ssot-invariant.test.ts",
+    "test:a11y": "vitest run tests/a11y-enhanced.test.tsx tests/axe-automated.test.tsx tests/navigation-a11y.test.tsx",
+    "test:ssr": "vitest run tests/ssr.test.tsx",
+    "prepack": "npm run typecheck && npm test && npm run build",
+    "preview": "vite preview"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "lucide-react": "^1.16.0",
+    "tailwind-merge": "^3.0.2"
+  },
+  "devDependencies": {
+    "@tailwindcss/cli": "^4.3.3",
+    "@tailwindcss/vite": "^4.3.3",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^26.2.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^6.0.5",
+    "axe-core": "^4.13.0",
+    "jsdom": "^30.0.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwindcss": "^4.3.3",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "vite": "^8.2.1",
+    "vitest": "^3.0.7"
+  }
+}

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));