@goplusvn/core 0.1.17 → 0.1.19

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.1.19 — applyBrandThemeTokens (gom logic áp theme, subtle dark-aware)
+
+Mỗi app copy y hệt logic áp bảng màu thương hiệu vào CSS token trong theme-provider
+→ cùng 1 bug (`--accent-primary-subtle` luôn sáng → mất chữ dark mode) phải sửa 3
+lần. Đưa vào core: `@goerp/core/providers/brand-theme` — `applyBrandThemeTokens(root,
+theme, isDark)` + `shiftLightness` + type `BrandThemeColor`. Subtle DARK-AWARE sẵn
+(dark hue 32% 18%, light 60% 96%). App chỉ giữ BẢNG màu riêng + gọi helper.
+
+
+## 0.1.18 — SettingsProvider nhận `defaults` (đổi màu/theme mặc định theo app)
+
+Customizer khóa cứng `defaultSettings.theme = "blue"` trong core → app không đặt
+được màu mặc định riêng (vd wu-vpbank muốn "green"). Thêm prop tùy chọn `defaults?:
+Partial<SettingsType>` cho `SettingsProvider` — merge lên core defaults (áp cho state
+đầu, khi không có cookie, và resetSettings). Additive/backward-compatible. App dùng:
+`<SettingsProvider locale={locale} defaults={{ theme: "green" }}>`.
+
+
 ## 0.1.17 — Fix: khôi phục nền màu tab (page-tabs) theo golden vinhhoa
 
 Bản "neutral single-style" trước đó bỏ gradient nền tab NHƯNG vẫn để icon/chữ

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goplusvn/core",
   "description": "GoPlusVN Platform Kit - ERP kernel: layout, RBAC, CRUD, multi-tenant, system pages",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "private": false,
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -53,7 +53,8 @@
     "./utils/cccd-parser": "./src/utils/cccd-parser.ts",
     "./configs/status": "./src/configs/status.ts",
     "./configs/entities": "./src/configs/entities/index.ts",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./providers/brand-theme": "./src/providers/brand-theme.ts"
   },
   "peerDependencies": {
     "next": ">=14.0.0",

package/src/providers/brand-theme.ts

@@ -0,0 +1,55 @@
+// Áp bảng màu thương hiệu (theme) đã calibrate vào các CSS token — logic DÙNG
+// CHUNG cho theme-provider của mọi app (trước đây bị copy y hệt ở wu/vinhhoa/
+// thingtodo → cùng 1 bug phải sửa 3 lần). App chỉ giữ BẢNG màu riêng (THEMES) +
+// gọi hàm này; token dark-aware xử lý ở đây.
+//
+// Usage (app theme-provider):
+//   import { applyBrandThemeTokens } from "@goerp/core/providers/brand-theme";
+//   applyBrandThemeTokens(document.documentElement, THEMES[theme], isDark);
+
+export interface BrandThemeColor {
+  /** "H S% L%" cho light mode. */
+  primary: string;
+  /** "H S% L%" cho dark mode (thường sáng hơn). */
+  primaryDark: string;
+  /** primary-foreground "H S% L%". */
+  fg: string;
+  /** nền sidebar light. */
+  sidebar: string;
+  /** nền sidebar dark. */
+  sidebarDark: string;
+}
+
+/** Dịch lightness của "H S% L%" (cho hover/active). */
+export function shiftLightness(triple: string, delta: number): string {
+  const parts = triple.trim().split(/\s+/);
+  if (parts.length < 3) return triple;
+  const l = parseFloat(parts[2]);
+  const next = Math.max(0, Math.min(100, l + delta));
+  return `${parts[0]} ${parts[1]} ${next}%`;
+}
+
+export function applyBrandThemeTokens(
+  root: HTMLElement,
+  theme: BrandThemeColor,
+  isDark: boolean,
+): void {
+  const primary = isDark ? theme.primaryDark : theme.primary;
+  const sidebar = isDark ? theme.sidebarDark : theme.sidebar;
+  const hue = primary.trim().split(/\s+/)[0];
+
+  root.style.setProperty("--primary", primary);
+  root.style.setProperty("--accent-primary", primary);
+  root.style.setProperty("--ring", primary);
+  root.style.setProperty("--primary-foreground", theme.fg);
+  root.style.setProperty("--accent-primary-hover", shiftLightness(primary, -6));
+  root.style.setProperty("--accent-primary-active", shiftLightness(primary, -12));
+  // Subtle DARK-AWARE: sáng (96% L) ở light, TỐI (18% L) ở dark — nếu luôn sáng
+  // thì UI dùng bg-accent-primary-subtle + chữ sáng sẽ mất chữ ở dark mode.
+  if (hue)
+    root.style.setProperty(
+      "--accent-primary-subtle",
+      isDark ? `${hue} 32% 18%` : `${hue} 60% 96%`,
+    );
+  root.style.setProperty("--sidebar-background", sidebar);
+}

package/src/providers/index.tsx

@@ -39,14 +39,20 @@ export const SettingsContext = createContext<
 export function SettingsProvider({
   locale,
   children,
+  defaults,
 }: {
   locale: LocaleType;
   children: ReactNode;
+  /** App-level overrides của defaultSettings (vd theme, radius). Truyền object
+   *  ỔN ĐỊNH (module-level const) để tránh re-render. Mặc định = defaultSettings core. */
+  defaults?: Partial<SettingsType>;
 }) {
+  // Mặc định của app = core defaults + override từ app (vd theme:"green").
+  const base = { ...defaultSettings, ...defaults };
   const [storedSettings, setStoredSettings, deleteStoredSettings] =
     useCookie("settings");
   const [settings, setSettings] = useState<SettingsType>(() => ({
-    ...defaultSettings,
+    ...base,
     locale,
   }));
 
@@ -54,14 +60,15 @@ export function SettingsProvider({
     if (storedSettings) {
       try {
         const parsedSettings = JSON.parse(storedSettings);
-        setSettings({ ...defaultSettings, ...parsedSettings });
+        setSettings({ ...base, ...parsedSettings });
       } catch {
-        setSettings({ ...defaultSettings, locale });
+        setSettings({ ...base, locale });
       }
     } else {
-      setSettings({ ...defaultSettings, locale });
+      setSettings({ ...base, locale });
     }
-  }, [storedSettings, locale]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [storedSettings, locale, defaults]);
 
   const updateSettings = useCallback(
     (newSettings: SettingsType) => {
@@ -73,8 +80,8 @@ export function SettingsProvider({
 
   const resetSettings = useCallback(() => {
     deleteStoredSettings();
-    setSettings(defaultSettings);
-  }, [deleteStoredSettings]);
+    setSettings({ ...defaultSettings, ...defaults });
+  }, [deleteStoredSettings, defaults]);
 
   // Apply the appearance choices the Customizer exposes but that nothing else
   // wires up. Without this, the "Radius" and "Density" controls store a value