@emotionalamo/plugin-extratheme 0.0.5

package/dist/shared/color.js

@@ -0,0 +1,122 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var color_exports = {};
+__export(color_exports, {
+  buildBackground: () => buildBackground,
+  fontFormatFromUrl: () => fontFormatFromUrl,
+  hexToRgba: () => hexToRgba,
+  safeCssColor: () => safeCssColor,
+  safeNum: () => safeNum,
+  sanitizeCssUrl: () => sanitizeCssUrl,
+  sanitizeFontFamily: () => sanitizeFontFamily,
+  toSolidRgb: () => toSolidRgb,
+  withAlpha: () => withAlpha
+});
+module.exports = __toCommonJS(color_exports);
+function sanitizeFontFamily(family) {
+  let s = (family || "").replace(/[;{}<>\\/*]/g, "").replace(/[\r\n\t]+/g, " ").trim();
+  if ((s.match(/"/g) || []).length % 2) s = s.replace(/"/g, "");
+  if ((s.match(/'/g) || []).length % 2) s = s.replace(/'/g, "");
+  return s.slice(0, 200);
+}
+function fontFormatFromUrl(url) {
+  var _a;
+  const ext = (((_a = (url || "").split("?")[0].split("#")[0].match(/\.([a-z0-9]+)$/i)) == null ? void 0 : _a[1]) || "").toLowerCase();
+  return { woff2: "woff2", woff: "woff", ttf: "truetype", otf: "opentype", ttc: "truetype" }[ext] || "";
+}
+function sanitizeCssUrl(url) {
+  return (url || "").replace(/["')(;{}<>\\]/g, "").replace(/\s+/g, "").slice(0, 2e3);
+}
+function hexToRgba(hex, alpha) {
+  let h = (hex || "").replace("#", "");
+  if (h.length === 3) h = h.split("").map((c) => c + c).join("");
+  const r = parseInt(h.slice(0, 2), 16);
+  const g = parseInt(h.slice(2, 4), 16);
+  const b = parseInt(h.slice(4, 6), 16);
+  return `rgba(${r},${g},${b},${alpha})`;
+}
+function parseRgb(color) {
+  const c = (color || "").trim();
+  const m = c.match(/^rgba?\(\s*([\d.]+)[\s,]+([\d.]+)[\s,]+([\d.]+)/i);
+  if (m) return [Math.round(+m[1]), Math.round(+m[2]), Math.round(+m[3])];
+  let h = c.replace("#", "");
+  if (h.length === 3) h = h.split("").map((x) => x + x).join("");
+  if (/^[0-9a-f]{6}$/i.test(h)) return [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16)];
+  return null;
+}
+function safeCssColor(color) {
+  const c = (color || "").trim();
+  if (/^#([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i.test(c)) return c;
+  if (/^(rgb|rgba|hsl|hsla)\(\s*[\d.,%\s/]+\)$/i.test(c)) return c;
+  if (/^[a-z]+$/i.test(c)) return c;
+  return "transparent";
+}
+function safeNum(v, def = 0) {
+  const n = Number(v);
+  return Number.isFinite(n) ? n : def;
+}
+function toSolidRgb(color) {
+  const rgb = parseRgb(color);
+  return rgb ? `rgb(${rgb[0]},${rgb[1]},${rgb[2]})` : "rgb(0,0,0)";
+}
+function withAlpha(color, alpha) {
+  const rgb = parseRgb(color);
+  return rgb ? `rgba(${rgb[0]},${rgb[1]},${rgb[2]},${safeNum(alpha)})` : "transparent";
+}
+function buildBackground(bg) {
+  var _a;
+  const none = { image: "transparent", size: "auto", repeat: "no-repeat", position: "center" };
+  if (!bg || bg.type === "none") return none;
+  if (bg.type === "color") return { image: safeCssColor(bg.color), size: "auto", repeat: "no-repeat", position: "center" };
+  if (bg.type === "gradient") {
+    const stops = (bg.gradient.colors || []).map(safeCssColor).join(",");
+    return {
+      image: `linear-gradient(${safeNum(bg.gradient.angle)}deg,${stops})`,
+      size: "cover",
+      repeat: "no-repeat",
+      position: "center"
+    };
+  }
+  const url = sanitizeCssUrl(((_a = bg.image) == null ? void 0 : _a.url) || "");
+  if (!url) return none;
+  const fit = bg.image.fit;
+  const repeat = fit === "repeat" ? "repeat" : "no-repeat";
+  const size = fit === "repeat" ? "auto" : fit === "stretch" ? "100% 100%" : fit === "contain" ? "contain" : "cover";
+  return { image: `url("${url}")`, size, repeat, position: "center" };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildBackground,
+  fontFormatFromUrl,
+  hexToRgba,
+  safeCssColor,
+  safeNum,
+  sanitizeCssUrl,
+  sanitizeFontFamily,
+  toSolidRgb,
+  withAlpha
+});

package/dist/shared/defaults.d.ts

@@ -0,0 +1,22 @@
+import type { AppConfig, LoginConfig, ExtraThemeConfig } from './types';
+/** Background gradient presets (name -> color stops). Options for the background picker, not skins. */
+export declare const GRADIENT_PRESETS: Record<string, string[]>;
+/**
+ * Global font presets (label -> CSS font-family stack). All are SYSTEM-font stacks —
+ * no web-font is loaded (CSP-safe, offline-safe, zero-latency). value '' = system
+ * default (no override). CJK-first so Chinese text stays correct on macOS/Windows/Linux.
+ */
+export declare const FONT_PRESETS: {
+    label: string;
+    value: string;
+}[];
+/**
+ * Starting values when an admin first enables the 工作区外观 group. Everything is
+ * OFF by default (`enabled: false`) — these numbers only take visual effect once
+ * the admin flips the switch on.
+ */
+export declare const DEFAULT_APP: AppConfig;
+/** Starting values for the 登录页外观 group (independent of app). */
+export declare const DEFAULT_LOGIN: LoginConfig;
+/** Merge a partial (from DB / API) onto the defaults, producing a complete config. */
+export declare function mergeConfig(partial: any): ExtraThemeConfig;

package/dist/shared/defaults.js

@@ -0,0 +1,109 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var defaults_exports = {};
+__export(defaults_exports, {
+  DEFAULT_APP: () => DEFAULT_APP,
+  DEFAULT_LOGIN: () => DEFAULT_LOGIN,
+  FONT_PRESETS: () => FONT_PRESETS,
+  GRADIENT_PRESETS: () => GRADIENT_PRESETS,
+  mergeConfig: () => mergeConfig
+});
+module.exports = __toCommonJS(defaults_exports);
+const GRADIENT_PRESETS = {
+  \u6674\u7A7A: ["#e0f2fe", "#ede9fe"],
+  \u6696\u9633: ["#fff7ed", "#ffedd5", "#fed7aa"],
+  \u6781\u5149: ["#c7d2fe", "#a7f3d0", "#fbcfe8"],
+  \u6D77\u6D0B: ["#cffafe", "#bae6fd", "#a5b4fc"],
+  \u8584\u8377: ["#d1fae5", "#a7f3d0"],
+  \u6A31\u7C89: ["#fce7f3", "#fbcfe8", "#ddd6fe"],
+  \u6DF1\u591C: ["#1e293b", "#0f172a"]
+};
+const FONT_PRESETS = [
+  { label: "\u7CFB\u7EDF\u9ED8\u8BA4", value: "" },
+  { label: "\u65E0\u886C\u7EBF\uFF08\u82F9\u65B9/\u96C5\u9ED1\uFF09", value: '"PingFang SC","Microsoft YaHei","Hiragino Sans GB","Segoe UI",Roboto,system-ui,sans-serif' },
+  { label: "\u601D\u6E90\u9ED1\u4F53", value: '"Source Han Sans SC","Noto Sans CJK SC","PingFang SC","Microsoft YaHei",sans-serif' },
+  { label: "\u886C\u7EBF\uFF08\u5B8B\u4F53\uFF09", value: '"Songti SC","Noto Serif CJK SC","SimSun",Georgia,"Times New Roman",serif' },
+  { label: "\u6977\u4F53", value: '"Kaiti SC","STKaiti","KaiTi","Noto Serif CJK SC",serif' },
+  { label: "\u5706\u4F53", value: '"Yuanti SC","PingFang SC","Hiragino Sans GB","Microsoft YaHei",sans-serif' },
+  { label: "\u7B49\u5BBD\uFF08\u4EE3\u7801\uFF09", value: '"SF Mono","JetBrains Mono","Fira Code",Consolas,"Courier New",monospace' }
+];
+const DEFAULT_APP = {
+  enabled: false,
+  background: {
+    type: "gradient",
+    color: "#eef2f7",
+    gradient: { preset: "\u6674\u7A7A", angle: 135, colors: GRADIENT_PRESETS["\u6674\u7A7A"] },
+    image: { url: "", fit: "cover", position: "center" },
+    dim: 0
+  },
+  card: { glass: true, opacity: 72, blur: 12, border: true },
+  // header / sider / font are independent of the 工作区外观 (background+card) switch;
+  // all default OFF so a fresh install changes nothing. font.family defaults to the
+  // 无衬线 stack so flipping the switch on shows an immediate effect.
+  header: { enabled: false, style: "frosted", color: "#ffffff", opacity: 90, blur: 14, text: "dark" },
+  sider: { enabled: false, style: "frosted", color: "#ffffff", opacity: 86, blur: 16, text: "dark" },
+  font: { enabled: false, source: "system", family: FONT_PRESETS[1].value, upload: { url: "", name: "", format: "" } },
+  // scrollbar off by default (native); when enabled, 'always' shows / 'hidden' hides.
+  scrollbar: { enabled: false, mode: "always" }
+};
+const DEFAULT_LOGIN = {
+  enabled: false,
+  background: {
+    type: "gradient",
+    color: "#1e293b",
+    gradient: { preset: "\u6696\u9633", angle: 135, colors: GRADIENT_PRESETS["\u6696\u9633"] },
+    image: { url: "", fit: "cover", position: "center" },
+    dim: 15
+  },
+  card: { glass: true, opacity: 70, blur: 18, radius: 18, shadow: true }
+};
+function isObj(v) {
+  return v != null && typeof v === "object" && !Array.isArray(v);
+}
+function deepMerge(base, over) {
+  if (!isObj(base)) return over === void 0 ? base : over;
+  const out = Array.isArray(base) ? [...base] : { ...base };
+  for (const k of Object.keys(base)) {
+    if (isObj(base[k])) out[k] = deepMerge(base[k], over == null ? void 0 : over[k]);
+    else if (over && over[k] !== void 0) out[k] = over[k];
+  }
+  return out;
+}
+function mergeConfig(partial) {
+  return {
+    app: deepMerge(DEFAULT_APP, partial == null ? void 0 : partial.app),
+    login: deepMerge(DEFAULT_LOGIN, partial == null ? void 0 : partial.login)
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_APP,
+  DEFAULT_LOGIN,
+  FONT_PRESETS,
+  GRADIENT_PRESETS,
+  mergeConfig
+});

package/dist/shared/generateCss.d.ts

@@ -0,0 +1,5 @@
+import type { ExtraThemeConfig, AppConfig, Selectors } from './types';
+/** True when any app-scope section (bg/card, header, sider, font, or scrollbar) is on. */
+export declare function isAppActive(app: AppConfig): boolean;
+/** Thin stylesheet: page background + frosted blur (surface colors are antd tokens). */
+export declare function generateStylesheet(config: ExtraThemeConfig, sel: Selectors): string;

package/dist/shared/generateCss.js

@@ -0,0 +1,116 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var generateCss_exports = {};
+__export(generateCss_exports, {
+  generateStylesheet: () => generateStylesheet,
+  isAppActive: () => isAppActive
+});
+module.exports = __toCommonJS(generateCss_exports);
+var import_color = require("./color");
+const FONT_FORMATS = ["woff2", "woff", "truetype", "opentype"];
+function bgDecl(bg) {
+  const b = (0, import_color.buildBackground)(bg);
+  let image = b.image;
+  const dim = (0, import_color.safeNum)(bg.dim);
+  if (dim > 0 && bg.type !== "none") {
+    const d = (0, import_color.hexToRgba)("#000000", dim / 100);
+    image = `linear-gradient(${d},${d}),${b.image}`;
+  }
+  return `background:${image}!important;background-size:${b.size}!important;background-repeat:${b.repeat}!important;background-position:${b.position}!important;background-attachment:fixed!important;`;
+}
+function scopedList(scope, list) {
+  return list.split(",").map((s) => `${scope} ${s.trim()}`).join(",");
+}
+function blur(px) {
+  const n = (0, import_color.safeNum)(px);
+  return `backdrop-filter:blur(${n}px);-webkit-backdrop-filter:blur(${n}px);`;
+}
+function appCss(app, s) {
+  var _a, _b;
+  const scope = "body.extra-theme-app-on";
+  const out = [];
+  if (app.enabled) {
+    out.push(`${scope}{${bgDecl(app.background)}}`);
+    out.push(`${scope} .ant-layout-sider-children{top:auto!important;bottom:0!important;}`);
+    out.push(`${scopedList(scope, s.content)}{background:transparent!important;}`);
+    out.push(`${scopedList(scope, s.card + " div:not([class]):not([id])")}{background-color:transparent!important;}`);
+    if (app.card.glass && app.card.blur > 0) {
+      out.push(`${scopedList(scope, s.card)},${scope} .code-block{${blur(app.card.blur)}}`);
+    }
+  }
+  if (app.header.enabled) {
+    const headerBg = (0, import_color.withAlpha)(app.header.color, app.header.opacity / 100);
+    const glass = app.header.style === "frosted" && app.header.blur > 0 ? blur(app.header.blur) : "";
+    out.push(`${scope} .ant-layout-header,${scope} .ant-pro-layout-header{background:${headerBg}!important;${glass}}`);
+  }
+  const font = app.font;
+  if (font == null ? void 0 : font.enabled) {
+    if (font.source === "upload" && ((_a = font.upload) == null ? void 0 : _a.url)) {
+      const name = (0, import_color.sanitizeFontFamily)(font.upload.name || "").replace(/["']/g, "") || "ExtraTheme Font";
+      const url = (0, import_color.sanitizeCssUrl)(font.upload.url);
+      const fmt = FONT_FORMATS.includes(font.upload.format) ? font.upload.format : (0, import_color.fontFormatFromUrl)(font.upload.url);
+      if (url) {
+        out.push(`@font-face{font-family:"${name}";src:url("${url}")${fmt ? ` format("${fmt}")` : ""};font-display:swap;}`);
+        out.push(`${scope}{font-family:"${name}"!important;}`);
+      }
+    } else if (font.source !== "upload") {
+      const fam = (0, import_color.sanitizeFontFamily)(font.family || "");
+      if (fam) out.push(`${scope}{font-family:${fam}!important;}`);
+    }
+  }
+  if (app.sider.enabled) {
+    const siderBg = (0, import_color.withAlpha)(app.sider.color, app.sider.opacity / 100);
+    const glass = app.sider.style === "frosted" && app.sider.blur > 0 ? blur(app.sider.blur) : "";
+    out.push(
+      `${scope} .ant-layout-sider{background:transparent!important;}${scope} .ant-layout-sider-children{background:${siderBg}!important;border-right:none!important;${glass}}${scope} .ant-layout-sider .ant-menu{background:transparent!important;border-inline-end:none!important;}${scope} .ant-layout-sider .ant-menu::-webkit-scrollbar{width:6px;height:6px;}${scope} .ant-layout-sider .ant-menu::-webkit-scrollbar-thumb{background:rgba(0,0,0,0.18);border-radius:4px;}${scope} .ant-layout-sider .ant-menu::-webkit-scrollbar-track{background:transparent;}`
+    );
+  }
+  if ((_b = app.scrollbar) == null ? void 0 : _b.enabled) {
+    if (app.scrollbar.mode === "hidden") {
+      out.push(
+        `${scope} ::-webkit-scrollbar,${scope}::-webkit-scrollbar{display:none;width:0;height:0;}${scope},${scope} *{scrollbar-width:none;-ms-overflow-style:none;}`
+      );
+    } else {
+      out.push(
+        `${scope} ::-webkit-scrollbar,${scope}::-webkit-scrollbar{width:10px;height:10px;}${scope} ::-webkit-scrollbar-thumb,${scope}::-webkit-scrollbar-thumb{background:rgba(0,0,0,0.22);border-radius:8px;border:2px solid transparent;background-clip:content-box;}${scope} ::-webkit-scrollbar-thumb:hover,${scope}::-webkit-scrollbar-thumb:hover{background:rgba(0,0,0,0.4);background-clip:content-box;}${scope} ::-webkit-scrollbar-track,${scope}::-webkit-scrollbar-track{background:transparent;}`
+      );
+    }
+  }
+  return out.join("\n");
+}
+function isAppActive(app) {
+  var _a, _b;
+  return !!(app.enabled || app.header.enabled || app.sider.enabled || ((_a = app.font) == null ? void 0 : _a.enabled) || ((_b = app.scrollbar) == null ? void 0 : _b.enabled));
+}
+function generateStylesheet(config, sel) {
+  return appCss(config.app, sel.app).trim();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateStylesheet,
+  isAppActive
+});

package/dist/shared/injector.d.ts

@@ -0,0 +1,15 @@
+import type { Selectors, ExtraThemeConfig } from './types';
+export declare const CHANGE_EVENT = "extra-theme:changed";
+type ApiRequest = (opts: any) => Promise<any>;
+export declare class ThemeInjector {
+    private request;
+    private selectors;
+    constructor(request: ApiRequest, selectors: Selectors);
+    /** Paint from cache immediately, then fetch fresh config, then listen for saves. */
+    start(): void;
+    /** Fetch the public config, cache it, and apply. Silent on failure (keep cache / native). */
+    refresh(): Promise<void>;
+    /** Toggle body markers + (re)write the single injected <style>. */
+    apply(cfg: ExtraThemeConfig): void;
+}
+export {};

package/dist/shared/injector.js

@@ -0,0 +1,88 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var injector_exports = {};
+__export(injector_exports, {
+  CHANGE_EVENT: () => CHANGE_EVENT,
+  ThemeInjector: () => ThemeInjector
+});
+module.exports = __toCommonJS(injector_exports);
+var import_generateCss = require("./generateCss");
+var import_defaults = require("./defaults");
+const STYLE_ID = "extra-theme-style";
+const CACHE_KEY = "EXTRA_THEME_CACHE";
+const CHANGE_EVENT = "extra-theme:changed";
+class ThemeInjector {
+  constructor(request, selectors) {
+    this.request = request;
+    this.selectors = selectors;
+  }
+  /** Paint from cache immediately, then fetch fresh config, then listen for saves. */
+  start() {
+    try {
+      const cached = localStorage.getItem(CACHE_KEY);
+      if (cached) this.apply((0, import_defaults.mergeConfig)(JSON.parse(cached)));
+    } catch {
+    }
+    this.refresh();
+    window.addEventListener(CHANGE_EVENT, () => this.refresh());
+  }
+  /** Fetch the public config, cache it, and apply. Silent on failure (keep cache / native). */
+  async refresh() {
+    var _a;
+    try {
+      const res = await this.request({ url: "extraTheme:getPublic", method: "get" });
+      const data = ((_a = res == null ? void 0 : res.data) == null ? void 0 : _a.data) ?? (res == null ? void 0 : res.data) ?? {};
+      const cfg = (0, import_defaults.mergeConfig)(data);
+      try {
+        localStorage.setItem(CACHE_KEY, JSON.stringify(cfg));
+      } catch {
+      }
+      this.apply(cfg);
+    } catch {
+    }
+  }
+  /** Toggle body markers + (re)write the single injected <style>. */
+  apply(cfg) {
+    var _a;
+    const body = document.body;
+    if (!body) return;
+    body.classList.toggle("extra-theme-app-on", (0, import_generateCss.isAppActive)(cfg.app));
+    body.classList.toggle("extra-theme-login-on", !!((_a = cfg.login) == null ? void 0 : _a.enabled));
+    let el = document.getElementById(STYLE_ID);
+    if (!el) {
+      el = document.createElement("style");
+      el.id = STYLE_ID;
+      document.head.appendChild(el);
+    }
+    el.textContent = (0, import_generateCss.generateStylesheet)(cfg, this.selectors);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CHANGE_EVENT,
+  ThemeInjector
+});

package/dist/shared/selectors.d.ts

@@ -0,0 +1,17 @@
+import type { Selectors } from './types';
+/**
+ * DOM anchors pinned against the live NocoBase 2.1.19 pro-layout DOM. Verified
+ * to be IDENTICAL for the legacy `/admin` client and the modern `/v` client —
+ * both render the same `@ant-design/pro-layout` chrome (only the content engine
+ * differs), so one selector set drives both lanes.
+ *
+ *   .ant-layout                         → layout root (background)
+ *   .ant-layout-header                  → top nav bar (2 exist; both frost)
+ *   .ant-layout-sider                   → left sider (settings / data sub-menu / side-mode)
+ *   .ant-card                           → content block containers
+ *   pro-layout-content/-container + nb-subpages-slot* → transparent so bg shows through
+ *
+ * Login anchors are placeholders; pinned for real in Task 10 against the
+ * sign-in DOM (legacy `/signin` + modern `/v/signin`).
+ */
+export declare const DEFAULT_SELECTORS: Selectors;

package/dist/shared/selectors.js

@@ -0,0 +1,48 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var selectors_exports = {};
+__export(selectors_exports, {
+  DEFAULT_SELECTORS: () => DEFAULT_SELECTORS
+});
+module.exports = __toCommonJS(selectors_exports);
+const DEFAULT_SELECTORS = {
+  app: {
+    appRoot: ".ant-layout",
+    header: ".ant-layout-header",
+    sider: ".ant-layout-sider",
+    card: ".ant-card",
+    content: '.ant-pro-layout-content,.ant-pro-layout-container,.ant-layout-content,.ant-page-header,[class*="nb-subpages-slot"],[class*="nb-subpages-slot"]>div'
+  },
+  login: {
+    loginRoot: ".ant-layout",
+    loginCard: ".ant-card"
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_SELECTORS
+});

package/dist/shared/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * ExtraTheme config types — shared by server (defaults/seed), legacy client and
+ * modern client-v2. Two logical config groups: `app` (工作区外观, applies to
+ * /admin + /v) and `login` (登录页外观, independent). Everything is a plain
+ * JSON-serialisable object so it round-trips through the `extraThemeSettings`
+ * collection and the public `extraTheme:getPublic` action.
+ */
+export type BgType = 'none' | 'color' | 'gradient' | 'image';
+export type NavStyle = 'solid' | 'frosted';
+export type TextTone = 'dark' | 'light';
+export type BgFit = 'cover' | 'contain' | 'stretch' | 'repeat';
+export interface BackgroundConfig {
+    type: BgType;
+    color: string;
+    gradient: {
+        preset: string;
+        angle: number;
+        colors: string[];
+    };
+    image: {
+        url: string;
+        fit: BgFit;
+        position: string;
+    };
+    dim: number;
+}
+export interface CardConfig {
+    glass: boolean;
+    opacity: number;
+    blur: number;
+    border: boolean;
+}
+export interface NavConfig {
+    enabled: boolean;
+    style: NavStyle;
+    color: string;
+    opacity: number;
+    blur: number;
+    text: TextTone;
+}
+export interface FontUpload {
+    url: string;
+    name: string;
+    format: string;
+}
+export interface FontConfig {
+    enabled: boolean;
+    source: 'system' | 'upload';
+    family: string;
+    upload: FontUpload;
+}
+export type ScrollbarMode = 'always' | 'hidden';
+export interface ScrollbarConfig {
+    enabled: boolean;
+    mode: ScrollbarMode;
+}
+export interface AppConfig {
+    enabled: boolean;
+    background: BackgroundConfig;
+    card: CardConfig;
+    header: NavConfig;
+    sider: NavConfig;
+    font: FontConfig;
+    scrollbar: ScrollbarConfig;
+}
+export interface LoginCard {
+    glass: boolean;
+    opacity: number;
+    blur: number;
+    radius: number;
+    shadow: boolean;
+}
+export interface LoginConfig {
+    enabled: boolean;
+    background: BackgroundConfig;
+    card: LoginCard;
+}
+export interface ExtraThemeConfig {
+    app: AppConfig;
+    login: LoginConfig;
+}
+/** DOM anchors — each client lane passes its own (pinned against the live DOM). */
+export interface AppSelectors {
+    appRoot: string;
+    header: string;
+    sider: string;
+    card: string;
+    content: string;
+}
+export interface LoginSelectors {
+    loginRoot: string;
+    loginCard: string;
+}
+export interface Selectors {
+    app: AppSelectors;
+    login: LoginSelectors;
+}

package/dist/shared/types.js

@@ -0,0 +1,24 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);