@lucasvu/scope-ui 0.1.4 → 0.1.5

package/AI_SETUP.md

@@ -2,7 +2,7 @@
 
 Muc tieu cua file nay la de AI cua project dung `@lucasvu/scope-ui` dung cach, khong import lung tung, khong hardcode mau sai cho, va giu dung base `Vite + micro frontend` khi repo duoc setup o may khac.
 
-Tu phien ban nay, cac phan generic truoc day thuong nam o `packages/shared/theme` da duoc ship ngay trong package nay:
+Tu phien ban nay, cac phan theme/runtime truoc day tung nam o legacy shared theme source da duoc ship ngay trong package nay:
 
 - base stylesheet
 - color-mode runtime

package/RULES.md

@@ -0,0 +1,52 @@
+# Rules Cho `@lucasvu/scope-ui`
+
+## Vai trò
+
+`@lucasvu/scope-ui` là package UI chính của workspace. Package này sở hữu:
+
+- component surface
+- stylesheet public
+- theme layers public
+- color-mode runtime
+- theme/runtime contract cho giao diện
+
+## Import đúng
+
+Import component từ:
+
+- `@lucasvu/scope-ui`
+
+Import runtime/theme contract từ:
+
+- `@lucasvu/scope-ui/core`
+
+Import stylesheet và theme từ:
+
+- `@lucasvu/scope-ui/styles.css`
+- `@lucasvu/scope-ui/themes/*`
+
+Không import:
+
+- từ `src/*`
+- từ `theme-source/*`
+- từ file nội bộ trong `dist/*`
+
+## Rule sử dụng
+
+- Import `styles.css` một lần ở app entry.
+- Nếu dùng theme layer, import từ `@lucasvu/scope-ui/themes/*`.
+- Nếu app không cần React surface mà chỉ cần theme/runtime, dùng `@lucasvu/scope-ui/core`.
+- Dùng component root trước. Chỉ dùng `MainFe` khi task thật sự yêu cầu legacy main-fe.
+- Không tự tạo thêm một hệ theme khác ngoài theme contract của package.
+
+## Rule cho AI và agent
+
+- Chọn component theo intent trước khi code.
+- Đọc `uiAiManifest` hoặc docs canonical props trước khi tự chọn component.
+- Không tự import file nội bộ chỉ vì tiện.
+- Không tự phát minh variant/theme path ngoài public API.
+
+## Ghi chú boundary
+
+- Theme source thuộc `ui`, không thuộc `shared`.
+- Utility generic như regex, formatter, runtime helper không nằm ở package này.

package/bin/copy-theme-assets.mjs

@@ -3,7 +3,7 @@
 import { copyFileSync, existsSync, mkdirSync, readdirSync, rmSync } from 'node:fs'
 import { dirname, join, resolve } from 'node:path'
 
-const sourceDir = resolve(process.cwd(), '../shared/theme')
+const sourceDir = resolve(process.cwd(), 'theme-source')
 const targetDir = resolve(process.cwd(), 'dist/themes')
 
 if (!existsSync(sourceDir)) {

package/dist/{chunk-CL3F2TWE.js → chunk-QBAHQOOH.js}

@@ -1,9 +1,3 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
 // src/ai-manifest.ts
 var uiAiManifest = {
   packageName: "@lucasvu/scope-ui",
@@ -1036,4 +1030,4 @@ function cn(...values) {
   return values.filter(Boolean).join(" ");
 }
 
-export { ROOT_CLIENT_THEME_ATTRIBUTE, ROOT_COLOR_MODE_ATTRIBUTE, __export, applyDocumentClientTheme, applyDocumentColorMode, cn, getSystemColorMode, initializeDocumentColorMode, isColorMode, subscribeToSystemColorMode, syncDocumentColorModeToSystem, uiAiManifest, uiDefaultThemePreset, uiProjectAiRules, uiScreenBlueprint, uiScreenBriefFields, uiThemeContract, uiThemeLayerAssets, uiThemePresets };
+export { ROOT_CLIENT_THEME_ATTRIBUTE, ROOT_COLOR_MODE_ATTRIBUTE, applyDocumentClientTheme, applyDocumentColorMode, cn, getSystemColorMode, initializeDocumentColorMode, isColorMode, subscribeToSystemColorMode, syncDocumentColorModeToSystem, uiAiManifest, uiDefaultThemePreset, uiProjectAiRules, uiScreenBlueprint, uiScreenBriefFields, uiThemeContract, uiThemeLayerAssets, uiThemePresets };

package/dist/core/index.js

@@ -1 +1 @@
-export { ROOT_CLIENT_THEME_ATTRIBUTE, ROOT_COLOR_MODE_ATTRIBUTE, applyDocumentClientTheme, applyDocumentColorMode, cn, getSystemColorMode, initializeDocumentColorMode, isColorMode, subscribeToSystemColorMode, syncDocumentColorModeToSystem, uiAiManifest, uiDefaultThemePreset, uiProjectAiRules, uiScreenBlueprint, uiScreenBriefFields, uiThemeContract, uiThemeLayerAssets, uiThemePresets } from '../chunk-CL3F2TWE.js';
+export { ROOT_CLIENT_THEME_ATTRIBUTE, ROOT_COLOR_MODE_ATTRIBUTE, applyDocumentClientTheme, applyDocumentColorMode, cn, getSystemColorMode, initializeDocumentColorMode, isColorMode, subscribeToSystemColorMode, syncDocumentColorModeToSystem, uiAiManifest, uiDefaultThemePreset, uiProjectAiRules, uiScreenBlueprint, uiScreenBriefFields, uiThemeContract, uiThemeLayerAssets, uiThemePresets } from '../chunk-QBAHQOOH.js';