create-wakii-stack 0.0.0-stage → 0.1.1

package/stack-template/app/ui-kit/package.json

@@ -0,0 +1,166 @@
+{
+  "name": "@wakii/ui-kit",
+  "version": "0.5.0",
+  "description": "Design system của Wakii — tokens + Tailwind v4 + 90 React components + hooks (antd/PrimeReact parity), dark theme, motion. Storybook: https://storybook-static-khaki-two.vercel.app",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./carousel": "./src/entries/carousel.ts",
+    "./chart": "./src/entries/chart.ts",
+    "./schedule": "./src/entries/schedule.ts",
+    "./editor": "./src/entries/editor.ts",
+    "./styles/tokens.css": "./src/styles/tokens.css",
+    "./styles/base.css": "./src/styles/base.css",
+    "./styles/tailwind.css": "./src/styles/tailwind.css",
+    "./styles/themes/dark.css": "./src/styles/themes/dark.css",
+    "./styles/ui-kit.css": "./dist/ui-kit.css",
+    "./experience3d": {
+      "types": "./src/entries/experience3d.ts",
+      "import": "./src/entries/experience3d.ts"
+    }
+  },
+  "scripts": {
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "build": "tsup && pnpm build:css",
+    "storybook": "node scripts/stamp-build.cjs && storybook dev -p 6006",
+    "build-storybook": "node scripts/stamp-build.cjs && storybook build",
+    "test-storybook": "test-storybook --maxWorkers=2",
+    "build:css": "tailwindcss -i src/styles/ui-kit.css -o dist/ui-kit.css --minify"
+  },
+  "peerDependencies": {
+    "@fullcalendar/core": "^6.1.15",
+    "@tiptap/react": "^3.32.0",
+    "chart.js": "^4.5.1",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "swiper": "^14.3.0",
+    "zod": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "swiper": {
+      "optional": true
+    },
+    "chart.js": {
+      "optional": true
+    },
+    "@fullcalendar/core": {
+      "optional": true
+    },
+    "@tiptap/react": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    "src/styles"
+  ],
+  "publishConfig": {
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "require": "./dist/index.cjs"
+      },
+      "./carousel": {
+        "types": "./dist/carousel.d.ts",
+        "import": "./dist/carousel.js",
+        "require": "./dist/carousel.cjs"
+      },
+      "./chart": {
+        "types": "./dist/chart.d.ts",
+        "import": "./dist/chart.js",
+        "require": "./dist/chart.cjs"
+      },
+      "./schedule": {
+        "types": "./dist/schedule.d.ts",
+        "import": "./dist/schedule.js",
+        "require": "./dist/schedule.cjs"
+      },
+      "./editor": {
+        "types": "./dist/editor.d.ts",
+        "import": "./dist/editor.js",
+        "require": "./dist/editor.cjs"
+      },
+      "./styles/tokens.css": "./src/styles/tokens.css",
+      "./styles/base.css": "./src/styles/base.css",
+      "./styles/tailwind.css": "./src/styles/tailwind.css",
+      "./styles/themes/dark.css": "./src/styles/themes/dark.css"
+    }
+  },
+  "devDependencies": {
+    "@changesets/cli": "^3.0.3",
+    "@fullcalendar/core": "^6.1.15",
+    "@fullcalendar/daygrid": "^6.1.22",
+    "@fullcalendar/interaction": "^6.1.22",
+    "@hookform/resolvers": "^5.9.2",
+    "@react-three/drei": "^10.7.9",
+    "@react-three/fiber": "^9.8.2",
+    "@storybook/addon-a11y": "^9.1.21",
+    "@storybook/addon-docs": "^9.0.0",
+    "@storybook/addon-themes": "^9.1.21",
+    "@storybook/react-vite": "^9.0.0",
+    "@storybook/test-runner": "^0.26.0",
+    "@tailwindcss/cli": "^4.3.3",
+    "@tailwindcss/vite": "^4.3.3",
+    "@testing-library/jest-dom": "6.9.0",
+    "@testing-library/react": "16.3.0",
+    "@testing-library/user-event": "14.6.1",
+    "@tiptap/core": "^3.32.0",
+    "@tiptap/react": "^3.32.0",
+    "@tiptap/starter-kit": "^3.32.0",
+    "@types/react": "19.2.2",
+    "@types/react-dom": "19.2.3",
+    "@types/three": "^0.186.0",
+    "@vitest/coverage-v8": "3.2.4",
+    "chart.js": "^4.5.1",
+    "eslint": "^10.13.0",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-react-refresh": "^0.5.7",
+    "jsdom": "27.0.0",
+    "motion": "^12",
+    "playwright": "^1.64.1",
+    "react": "catalog:",
+    "react-dom": "catalog:",
+    "react-hook-form": "^7",
+    "storybook": "^9.0.0",
+    "tailwindcss": "^4.3.3",
+    "three": "^0.186.1",
+    "tsup": "^9.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.71.2",
+    "vite": "^7.0.0",
+    "vitest": "3.2.4",
+    "zod": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "swiper": "^14.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wakii-dev/architecture-overview.git",
+    "directory": "app/ui-kit"
+  },
+  "homepage": "https://storybook-static-khaki-two.vercel.app",
+  "bugs": "https://github.com/wakii-dev/architecture-overview/issues",
+  "keywords": [
+    "design-system",
+    "ui-kit",
+    "react",
+    "tailwind",
+    "components",
+    "antd",
+    "primereact",
+    "wakii"
+  ],
+  "author": "wakii-dev",
+  "license": "MIT"
+}

package/stack-template/app/ui-kit/scripts/publish-github.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# Publish @wakii-dev/ui-kit lên GitHub Packages (mirror org nội bộ — canonical là @wakii/ui-kit trên npmjs, publish trực tiếp bằng pnpm).
+# Registry GitHub Packages (@wakii/ui-kit) publish trực tiếp bằng pnpm — xem RELEASE.md.
+#
+# Cần: GH_PACKAGES_TOKEN = ghp PAT write:packages của account GitHub wakii-dev
+#   NPM_TOKEN=npm_xxx ./scripts/publish-npm.sh
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+[ -n "${GH_PACKAGES_TOKEN:-}" ] || { echo "✗ Thiếu GH_PACKAGES_TOKEN (PAT wakii-dev)"; exit 1; }
+grep -q '"name": "@wakii/ui-kit"' package.json || { echo "✗ package.json không phải @wakii/ui-kit (sai repo state)"; exit 1; }
+
+echo "▶ Build mới (tsup + CSS compiled)..."
+pnpm build
+
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+# Giữ ĐÚNG đường dẫn src/styles trong tarball (files field pack theo src/styles).
+# cp nhiều nguồn copy theo BASENAME — 'src/styles' sẽ thành 'styles/' ở gốc và
+# npm pack bỏ hết CSS tokens — nên copy tách nguồn, kèm guard.
+cp -r dist README.md LICENSE package.json "$TMP/"
+mkdir -p "$TMP/src"
+cp -r src/styles "$TMP/src/"
+[ -d "$TMP/src/styles" ] || { echo "✗ thiếu src/styles sau copy"; exit 1; }
+
+python3 - "$TMP" << 'PY'
+import json, sys
+p = json.load(open(f'{sys.argv[1]}/package.json'))
+p['name'] = '@wakii-dev/ui-kit'                    # scope GitHub org wakii-dev
+p['publishConfig']['registry'] = 'https://npm.pkg.github.com'
+for k in ('devDependencies', 'scripts', 'overrides'): p.pop(k, None)
+json.dump(p, open(f'{sys.argv[1]}/package.json', 'w'), indent=2, ensure_ascii=False)
+open(f'{sys.argv[1]}/package.json', 'a').write('\n')
+PY
+
+printf '//npm.pkg.github.com/:_authToken=%s\n@wakii-dev:registry=https://npm.pkg.github.com\n' "$GH_PACKAGES_TOKEN" > "$TMP/.npmrc"
+cd "$TMP"
+npm publish --registry=https://npm.pkg.github.com
+echo "✓ @wakii-dev/ui-kit published (GitHub Packages)"

package/stack-template/app/ui-kit/scripts/publish-npm.sh

@@ -0,0 +1,76 @@
+#!/usr/bin/env bash
+# Publish @wakii/ui-kit lên npmjs.org (canonical scope @wakii — KHÔNG đổi name).
+# Mirror của publish-github.sh — chỉ đổi đích registry + giữ nguyên tên package.
+# Xem RELEASE.md bước 3.
+#
+# Auth: hoặc env NPM_TOKEN (npm_xxx quyền publish scope @wakii), hoặc đã lưu
+# token wakii trong ~/.npmrc (2026-10-24 user duyệt lưu lại — sau đó chạy thẳng
+#   ./scripts/publish-npm.sh   không cần env).
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+NPMRC_AUTH="$(grep -s '^//registry\.npmjs\.org/:_authToken=' "${NPM_CONFIG_USERCONFIG:-$HOME/.npmrc}" | head -1 || true)"
+if [ -z "${NPM_TOKEN:-}" ] && [ -z "$NPMRC_AUTH" ]; then
+  echo "✗ Thiếu NPM_TOKEN (env) hoặc _authToken cho registry.npmjs.org trong ~/.npmrc"; exit 1
+fi
+grep -q '"name": "@wakii/ui-kit"' package.json || { echo "✗ package.json không phải @wakii/ui-kit (sai repo state)"; exit 1; }
+
+echo "▶ Build mới (tsup + CSS compiled)..."
+pnpm build
+
+TMP=$(mktemp -d)
+trap 'rm -rf "$TMP"' EXIT
+# Giữ ĐÚNG đường dẫn src/styles trong tarball (files field pack theo src/styles).
+# cp nhiều nguồn copy theo BASENAME — 'src/styles' sẽ thành 'styles/' ở gốc và
+# npm pack bỏ hết CSS tokens — nên copy tách nguồn, kèm guard.
+cp -r dist README.md LICENSE package.json "$TMP/"
+mkdir -p "$TMP/src"
+cp -r src/styles "$TMP/src/"
+[ -d "$TMP/src/styles" ] || { echo "✗ thiếu src/styles sau copy"; exit 1; }
+
+# Giữ NGUYÊN name @wakii/ui-kit (canonical npmjs); registry đích npmjs; bỏ phần
+# không cần khi publish (devDeps/scripts/overrides — mirror publish-github.sh).
+# QUAN TRỌNG — exports ĐỔI SANG DIST (hotfix 0.4.1): repo exports trỏ TS source
+# (ADR-0009 consumed-qua-source cho monorepo) nhưng consumers npm (vite/webpack
+# ngoài monorepo) KHÔNG resolve được package entry .ts → build fail. npm package
+# nhận dist (js/cjs/d.ts đủ 6 entry) — styles giữ src (css thuần, có trong tarball).
+python3 - "$TMP" << 'PY'
+import json, sys
+p = json.load(open(f'{sys.argv[1]}/package.json'))
+p['publishConfig']['registry'] = 'https://registry.npmjs.org'
+
+def dist_entry(name):
+    return {
+        'types': f'./dist/{name}.d.ts',
+        'import': f'./dist/{name}.js',
+        'require': f'./dist/{name}.cjs',
+    }
+
+p['exports'] = {
+    '.': dist_entry('index'),
+    './carousel': dist_entry('carousel'),
+    './chart': dist_entry('chart'),
+    './schedule': dist_entry('schedule'),
+    './editor': dist_entry('editor'),
+    './experience3d': dist_entry('experience3d'),
+    './styles/tokens.css': './src/styles/tokens.css',
+    './styles/base.css': './src/styles/base.css',
+    './styles/tailwind.css': './src/styles/tailwind.css',
+    './styles/themes/dark.css': './src/styles/themes/dark.css',
+    './styles/ui-kit.css': './dist/ui-kit.css',
+}
+p['main'] = './dist/index.cjs'
+p['module'] = './dist/index.js'
+p['types'] = './dist/index.d.ts'
+for k in ('devDependencies', 'scripts', 'overrides'): p.pop(k, None)
+json.dump(p, open(f'{sys.argv[1]}/package.json', 'w'), indent=2, ensure_ascii=False)
+open(f'{sys.argv[1]}/package.json', 'a').write('\n')
+PY
+
+# Env token ưu tiên; không có thì kế thừa auth ~/.npmrc (không ghi .npmrc TMP).
+if [ -n "${NPM_TOKEN:-}" ]; then
+  printf '//registry.npmjs.org/:_authToken=%s\n@wakii:registry=https://registry.npmjs.org\n' "$NPM_TOKEN" > "$TMP/.npmrc"
+fi
+cd "$TMP"
+npm publish --registry=https://registry.npmjs.org --access public
+echo "✓ @wakii/ui-kit published (npmjs.org)"

package/stack-template/app/ui-kit/scripts/stamp-build.cjs

@@ -0,0 +1,13 @@
+// Gắn build-id (version + git sha + giờ) vào manager-head badge — mỗi lần build/dev mới.
+const { execSync } = require('child_process');
+const { readFileSync, writeFileSync } = require('fs');
+const path = require('path');
+let sha = 'dev';
+try { sha = execSync('git rev-parse --short HEAD').toString().trim(); } catch {}
+const pkg = JSON.parse(readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
+const id = `${pkg.version}+${sha}+${new Date().toISOString().slice(11, 16)}Z`;
+const file = path.join(__dirname, '..', '.storybook', 'manager-head.html');
+let html = readFileSync(file, 'utf8');
+html = html.replace(/id="build-badge">[^<]*</, `id="build-badge">${id}<`);
+writeFileSync(file, html);
+console.log('build badge:', id);