@qlover/tailwind-theme 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @qlover/tailwind-theme
 
+## 0.3.0
+
+### Minor Changes
+
+#### ✨ Features
+
+- **tailwind-theme:** Introduce 'generater' module for theme generation ([24e2345](https://github.com/qlover/fe-base/commit/24e2345d7cc1162702362ea3c29b61b6788d7861)) ([#658](https://github.com/qlover/fe-base/pull/658))
+
+- **next-oauth:** enhance styling and theme generation for improved UI consistency ([c225d16](https://github.com/qlover/fe-base/commit/c225d164d09c5c71070c309022203295a840c024)) ([#657](https://github.com/qlover/fe-base/pull/657))
+
+#### ♻️ Refactors
+
+- **UserService, UserStore:** Simplify session persistence logic ([5de703d](https://github.com/qlover/fe-base/commit/5de703daf5a0b96e269a46e4b9360401da657d6d)) ([#669](https://github.com/qlover/fe-base/pull/669))
+
 ## 0.2.1
 
 ### Patch Changes

package/dist/generater.cjs

@@ -0,0 +1,383 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/generater.ts
+var generater_exports = {};
+__export(generater_exports, {
+  generateThemeFile: () => generateThemeFile,
+  generateThemeFiles: () => generateThemeFiles
+});
+module.exports = __toCommonJS(generater_exports);
+var import_fs = __toESM(require("fs"), 1);
+var import_path = __toESM(require("path"), 1);
+
+// src/utils.ts
+function resolveTokenValue(value, prefix) {
+  return value.replace(/\$\{prefix\}/g, prefix);
+}
+function deepMerge(target, source) {
+  const result = { ...target };
+  for (const key in source) {
+    if (Object.prototype.hasOwnProperty.call(source, key)) {
+      const sourceVal = source[key];
+      const targetVal = result[key];
+      if (sourceVal && typeof sourceVal === "object" && !Array.isArray(sourceVal) && targetVal && typeof targetVal === "object") {
+        result[key] = deepMerge(
+          targetVal,
+          sourceVal
+        );
+      } else {
+        result[key] = sourceVal;
+      }
+    }
+  }
+  return result;
+}
+
+// src/config.ts
+var themePrimaryBgOpacity = {
+  light: "0.08",
+  dark: "0.12",
+  pink: "0.12",
+  amber: "0.12",
+  forest: "0.1",
+  ocean: "0.1"
+};
+var builtinThemes = {
+  light: {
+    "color-primary": "246 248 250",
+    "color-secondary": "255 255 255",
+    "color-elevated": "240 242 244",
+    "color-primary-text": "31 35 40",
+    "color-primary-text-hover": "101 109 118",
+    "color-secondary-text": "101 109 118",
+    "color-tertiary-text": "140 149 159",
+    "color-primary-border": "208 215 222",
+    "color-brand": "124 58 237",
+    "color-brand-hover": "109 40 217",
+    "color-brand-active": "91 33 182",
+    "color-success": "#1a7f37",
+    "color-warning": "#faad14",
+    "color-error": "#cf222e",
+    "border-radius": "6px"
+  },
+  dark: {
+    "color-primary": "15 17 21",
+    "color-secondary": "22 27 34",
+    "color-elevated": "33 38 45",
+    "color-primary-text": "230 237 243",
+    "color-primary-text-hover": "139 148 158",
+    "color-secondary-text": "139 148 158",
+    "color-tertiary-text": "110 118 129",
+    "color-primary-border": "48 54 61",
+    "color-brand": "139 92 246",
+    "color-brand-hover": "124 58 237",
+    "color-brand-active": "109 40 217",
+    "color-success": "#3fb950",
+    "color-warning": "#faad14",
+    "color-error": "#f85149",
+    "border-radius": "6px"
+  },
+  pink: {
+    "color-primary": "26 13 20",
+    "color-secondary": "37 16 27",
+    "color-elevated": "48 21 34",
+    "color-primary-text": "252 232 240",
+    "color-primary-text-hover": "196 144 168",
+    "color-secondary-text": "196 144 168",
+    "color-tertiary-text": "138 88 112",
+    "color-primary-border": "92 45 66",
+    "color-brand": "244 114 182",
+    "color-brand-hover": "236 72 153",
+    "color-brand-active": "219 39 119",
+    "color-success": "#34d399",
+    "color-warning": "#faad14",
+    "color-error": "#fb7185",
+    "border-radius": "8px"
+  },
+  amber: {
+    "color-primary": "30 18 0",
+    "color-secondary": "40 26 0",
+    "color-elevated": "50 31 0",
+    "color-primary-text": "242 232 213",
+    "color-primary-text-hover": "184 166 138",
+    "color-secondary-text": "184 166 138",
+    "color-tertiary-text": "122 106 86",
+    "color-primary-border": "74 56 0",
+    "color-brand": "232 148 58",
+    "color-brand-hover": "208 120 40",
+    "color-brand-active": "180 100 30",
+    "color-success": "#5aad6e",
+    "color-warning": "#faad14",
+    "color-error": "#c85a4a",
+    "border-radius": "6px"
+  },
+  forest: {
+    "color-primary": "6 21 8",
+    "color-secondary": "12 31 14",
+    "color-elevated": "19 39 22",
+    "color-primary-text": "216 240 220",
+    "color-primary-text-hover": "136 173 142",
+    "color-secondary-text": "136 173 142",
+    "color-tertiary-text": "90 122 94",
+    "color-primary-border": "44 66 48",
+    "color-brand": "74 222 128",
+    "color-brand-hover": "34 197 94",
+    "color-brand-active": "22 163 74",
+    "color-success": "#86efac",
+    "color-warning": "#faad14",
+    "color-error": "#f87171",
+    "border-radius": "6px"
+  },
+  ocean: {
+    "color-primary": "6 14 26",
+    "color-secondary": "13 26 46",
+    "color-elevated": "18 36 62",
+    "color-primary-text": "218 238 255",
+    "color-primary-text-hover": "122 181 212",
+    "color-secondary-text": "122 181 212",
+    "color-tertiary-text": "74 126 154",
+    "color-primary-border": "30 58 92",
+    "color-brand": "56 189 248",
+    "color-brand-hover": "14 165 233",
+    "color-brand-active": "2 132 199",
+    "color-success": "#34d399",
+    "color-warning": "#faad14",
+    "color-error": "#f87171",
+    "border-radius": "6px"
+  }
+};
+var getDerivedTokens = (prefix, themeName) => {
+  const opacity = themeName ? themePrimaryBgOpacity[themeName] ?? "0.1" : "0.1";
+  return {
+    "color-bg-container": `rgb(var(--${prefix}-color-secondary))`,
+    "color-text": `rgb(var(--${prefix}-color-primary-text) / 0.85)`,
+    "color-text-heading": `rgb(var(--${prefix}-color-primary-text))`,
+    "color-text-disabled": `rgb(var(--${prefix}-color-primary-text) / 0.25)`,
+    "color-primary-hover": `rgb(var(--${prefix}-color-brand-hover))`,
+    "color-primary-active": `rgb(var(--${prefix}-color-brand-active))`,
+    "color-primary-bg": `rgb(var(--${prefix}-color-brand) / ${opacity})`,
+    "line-height": "1.5715"
+  };
+};
+var defaultTokenMapping = {
+  "color-primary": "rgb(var(--${prefix}-color-primary))",
+  "color-primary-active": "rgb(var(--${prefix}-color-primary-active))",
+  "color-primary-hover": "rgb(var(--${prefix}-color-primary-hover))",
+  "color-primary-bg": "rgb(var(--${prefix}-color-primary-bg))",
+  "color-secondary": "rgb(var(--${prefix}-color-secondary))",
+  "color-elevated": "rgb(var(--${prefix}-color-elevated))",
+  "color-primary-text": "rgb(var(--${prefix}-color-primary-text))",
+  "color-primary-text-hover": "rgb(var(--${prefix}-color-primary-text-hover))",
+  "color-secondary-text": "rgb(var(--${prefix}-color-secondary-text))",
+  "color-tertiary-text": "rgb(var(--${prefix}-color-tertiary-text))",
+  "color-primary-border": "rgb(var(--${prefix}-color-primary-border))",
+  "color-brand": "rgb(var(--${prefix}-color-brand))",
+  "color-brand-hover": "rgb(var(--${prefix}-color-brand-hover))",
+  "color-brand-active": "rgb(var(--${prefix}-color-brand-active))",
+  /** Text/icons on brand-colored surfaces (buttons, badges) */
+  "color-on-brand": "#ffffff",
+  "color-progress-track": "rgb(var(--${prefix}-color-primary-border) / 0.5)",
+  "color-bg-container": "rgb(var(--${prefix}-color-bg-container))",
+  "font-sans": 'var(--font-inter), ui-sans-serif, system-ui, "PingFang SC", "Microsoft YaHei UI", "Microsoft YaHei", "Noto Sans SC", sans-serif',
+  "animate-dashboard-skeleton-shimmer": "dashboard-skeleton-shimmer 1.6s ease-in-out infinite"
+};
+function getDefaultSelector(themeName, root) {
+  if (root) {
+    return `:root, html[data-theme="${themeName}"], [data-theme="${themeName}"]`;
+  }
+  return `html[data-theme="${themeName}"], [data-theme="${themeName}"]`;
+}
+var defaultConfig = {
+  prefix: "fe",
+  themes: {},
+  tokenMapping: defaultTokenMapping,
+  cssSelector: getDefaultSelector
+};
+function getConfig(options) {
+  let allThemes = deepMerge(builtinThemes, options?.themes || {});
+  const includeThemes = options?.includeThemes;
+  if (includeThemes?.length) {
+    const filtered = {};
+    for (const name of includeThemes) {
+      if (allThemes[name]) {
+        filtered[name] = allThemes[name];
+      }
+    }
+    allThemes = filtered;
+  }
+  const allMappings = deepMerge(
+    defaultTokenMapping,
+    options?.tokenMapping || {}
+  );
+  const config = Object.assign(
+    {},
+    defaultConfig,
+    options,
+    {
+      themes: allThemes,
+      tokenMapping: allMappings,
+      includeThemes: includeThemes ?? []
+    }
+  );
+  if (!config.defaultTheme || !config.themes[config.defaultTheme]) {
+    config.defaultTheme = Object.keys(config.themes)[0];
+  }
+  return config;
+}
+
+// src/core.ts
+function generateLayerBaseCSS(options = {}) {
+  const config = getConfig(options);
+  const { prefix, themes, cssSelector, defaultTheme } = config;
+  let css = "";
+  for (const [themeName, vars] of Object.entries(themes)) {
+    const isDefault = themeName === defaultTheme;
+    const selector = cssSelector(themeName, isDefault);
+    const themeDerived = getDerivedTokens(prefix, themeName);
+    const merged = {
+      ...vars,
+      ...themeDerived
+    };
+    css += `${selector} {
+`;
+    for (const [varName, value] of Object.entries(merged)) {
+      css += `  --${prefix}-${varName}: ${value};
+`;
+    }
+    css += "}\n\n";
+  }
+  return css;
+}
+function generateThemeBlockCSS(options = {}) {
+  const config = getConfig(options);
+  const { prefix, tokenMapping = defaultTokenMapping } = config;
+  let css = "@theme {\n";
+  for (const [tokenName, tokenValue] of Object.entries(tokenMapping)) {
+    const finalValue = resolveTokenValue(tokenValue, prefix);
+    css += `  --${tokenName}: ${finalValue};
+`;
+  }
+  css += "}\n";
+  return css;
+}
+function generateThemeCSS(options = {}) {
+  let css = "";
+  const layerBaseContent = generateLayerBaseCSS(options);
+  if (layerBaseContent) {
+    css += "@layer base {\n" + layerBaseContent + "}\n\n";
+  }
+  css += generateThemeBlockCSS(options);
+  return css;
+}
+
+// src/generater.ts
+var DEFAULT_OUTPUT_PATHS = {
+  "layer-base": "theme-layer-base.css",
+  "theme-block": "theme-block.css",
+  full: "theme.css"
+};
+function resolveCssContent(variant, options) {
+  switch (variant) {
+    case "layer-base": {
+      const layerBaseContent = generateLayerBaseCSS(options);
+      return layerBaseContent ? `@layer base {
+${layerBaseContent}}
+` : "";
+    }
+    case "theme-block":
+      return generateThemeBlockCSS(options);
+    case "full":
+      return generateThemeCSS(options);
+    default: {
+      const _exhaustive = variant;
+      return _exhaustive;
+    }
+  }
+}
+async function writeCssFile(absolutePath, css, overwrite) {
+  if (import_fs.default.existsSync(absolutePath)) {
+    if (overwrite) {
+      console.warn(
+        `\u26A0\uFE0F Warning: File already exists at ${absolutePath}. It will be overwritten.`
+      );
+    } else {
+      throw new Error(
+        `File already exists at ${absolutePath} and overwrite is set to false.`
+      );
+    }
+  }
+  const dir = import_path.default.dirname(absolutePath);
+  if (!import_fs.default.existsSync(dir)) {
+    import_fs.default.mkdirSync(dir, { recursive: true });
+  }
+  await import_fs.default.promises.writeFile(absolutePath, css, "utf-8");
+  console.log(`\u2705 Theme CSS generated at ${absolutePath}`);
+}
+function resolveOutputPath(variant, options) {
+  if (options.outputPath) {
+    return import_path.default.resolve(process.cwd(), options.outputPath);
+  }
+  return import_path.default.resolve(process.cwd(), DEFAULT_OUTPUT_PATHS[variant]);
+}
+async function generateThemeFile(options = {}) {
+  const {
+    variant = "full",
+    overwrite = true,
+    outputPath,
+    ...restOptions
+  } = options;
+  const absolutePath = outputPath ? import_path.default.resolve(process.cwd(), outputPath) : resolveOutputPath(variant, options);
+  const css = resolveCssContent(variant, restOptions);
+  await writeCssFile(absolutePath, css, overwrite);
+  return absolutePath;
+}
+async function generateThemeFiles(options = {}) {
+  const {
+    outputDir = ".",
+    outputPaths = {},
+    overwrite = true,
+    ...restOptions
+  } = options;
+  const variants = Object.keys(DEFAULT_OUTPUT_PATHS);
+  const result = {};
+  for (const variant of variants) {
+    const relativePath = outputPaths[variant] ?? import_path.default.join(outputDir, DEFAULT_OUTPUT_PATHS[variant]);
+    const absolutePath = import_path.default.resolve(process.cwd(), relativePath);
+    const css = resolveCssContent(variant, restOptions);
+    await writeCssFile(absolutePath, css, overwrite);
+    result[variant] = absolutePath;
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateThemeFile,
+  generateThemeFiles
+});

package/dist/generater.d.cts

@@ -0,0 +1,68 @@
+type RGBChannels = string;
+type ColorValue = string;
+type ThemeTokens = Record<string, ColorValue | RGBChannels>;
+/** Named themes → token sets (avoids index-signature confusion with `Record<string, ThemeTokens>`) */
+type ThemesMap = Record<string, ThemeTokens>;
+/**
+ * Token mapping for the theme.
+ *
+ * @example
+ * {
+ *   'color-primary': 'rgb(var(--${prefix}-color-primary))',
+ *   'color-secondary': 'rgb(var(--${prefix}-color-secondary))',
+ *   'color-elevated': 'rgb(var(--${prefix}-color-elevated))',
+ *   'color-primary-text': 'rgb(var(--${prefix}-color-primary-text))',
+ *   'color-primary-text-hover': 'rgb(var(--${prefix}-color-primary-text-hover))',
+ *   'color-secondary-text': 'rgb(var(--${prefix}-color-secondary-text))',
+ *   'color-tertiary-text': 'rgb(var(--${prefix}-color-tertiary-text))',
+ * }
+ *
+ * 最后结果可能=>
+ * {
+ *   '--color-primary': 'rgb(var(--fe-color-primary))',
+ *   '--color-secondary': 'rgb(var(--fe-color-secondary))',
+ *   '--color-elevated': 'rgb(var(--fe-color-elevated))',
+ *   '--color-primary-text': 'rgb(var(--fe-color-primary-text))',
+ *   '--color-primary-text-hover': 'rgb(var(--fe-color-primary-text-hover))',
+ *   '--color-secondary-text': 'rgb(var(--fe-color-secondary-text))',
+ *   '--color-tertiary-text': 'rgb(var(--fe-color-tertiary-text))',
+ * }
+ */
+type TokenMapping = Record<string, string>;
+interface UiThemeOptions {
+    prefix?: string;
+    defaultTheme?: string;
+    themes?: ThemesMap;
+    /**
+     * When set, only these theme names are emitted (after merging builtins).
+     * Use to keep app CSS small when the package ships extra demo themes.
+     */
+    includeThemes?: string[];
+    tokenMapping?: TokenMapping;
+    cssSelector?: (themeName: string, root: boolean) => string;
+    outputPath?: string;
+    overwrite?: boolean;
+}
+
+/** CSS variant aligned with {@link core.ts} generators */
+type ThemeCssVariant = 'layer-base' | 'theme-block' | 'full';
+interface GenerateThemeFileOptions extends UiThemeOptions {
+    /** Which CSS generator to use. Default: `full` */
+    variant?: ThemeCssVariant;
+}
+interface GenerateThemeFilesOptions extends UiThemeOptions {
+    /** Directory for default output file names. Default: `.` (cwd) */
+    outputDir?: string;
+    /** Override output path per variant (relative to cwd unless absolute) */
+    outputPaths?: Partial<Record<ThemeCssVariant, string>>;
+}
+/**
+ * Write theme CSS to a file using the selected core generator variant.
+ */
+declare function generateThemeFile(options?: GenerateThemeFileOptions): Promise<string>;
+/**
+ * Write all three theme CSS variants (layer-base, theme-block, full) to files.
+ */
+declare function generateThemeFiles(options?: GenerateThemeFilesOptions): Promise<Record<ThemeCssVariant, string>>;
+
+export { type GenerateThemeFileOptions, type GenerateThemeFilesOptions, type ThemeCssVariant, generateThemeFile, generateThemeFiles };

package/dist/generater.d.ts

@@ -0,0 +1,68 @@
+type RGBChannels = string;
+type ColorValue = string;
+type ThemeTokens = Record<string, ColorValue | RGBChannels>;
+/** Named themes → token sets (avoids index-signature confusion with `Record<string, ThemeTokens>`) */
+type ThemesMap = Record<string, ThemeTokens>;
+/**
+ * Token mapping for the theme.
+ *
+ * @example
+ * {
+ *   'color-primary': 'rgb(var(--${prefix}-color-primary))',
+ *   'color-secondary': 'rgb(var(--${prefix}-color-secondary))',
+ *   'color-elevated': 'rgb(var(--${prefix}-color-elevated))',
+ *   'color-primary-text': 'rgb(var(--${prefix}-color-primary-text))',
+ *   'color-primary-text-hover': 'rgb(var(--${prefix}-color-primary-text-hover))',
+ *   'color-secondary-text': 'rgb(var(--${prefix}-color-secondary-text))',
+ *   'color-tertiary-text': 'rgb(var(--${prefix}-color-tertiary-text))',
+ * }
+ *
+ * 最后结果可能=>
+ * {
+ *   '--color-primary': 'rgb(var(--fe-color-primary))',
+ *   '--color-secondary': 'rgb(var(--fe-color-secondary))',
+ *   '--color-elevated': 'rgb(var(--fe-color-elevated))',
+ *   '--color-primary-text': 'rgb(var(--fe-color-primary-text))',
+ *   '--color-primary-text-hover': 'rgb(var(--fe-color-primary-text-hover))',
+ *   '--color-secondary-text': 'rgb(var(--fe-color-secondary-text))',
+ *   '--color-tertiary-text': 'rgb(var(--fe-color-tertiary-text))',
+ * }
+ */
+type TokenMapping = Record<string, string>;
+interface UiThemeOptions {
+    prefix?: string;
+    defaultTheme?: string;
+    themes?: ThemesMap;
+    /**
+     * When set, only these theme names are emitted (after merging builtins).
+     * Use to keep app CSS small when the package ships extra demo themes.
+     */
+    includeThemes?: string[];
+    tokenMapping?: TokenMapping;
+    cssSelector?: (themeName: string, root: boolean) => string;
+    outputPath?: string;
+    overwrite?: boolean;
+}
+
+/** CSS variant aligned with {@link core.ts} generators */
+type ThemeCssVariant = 'layer-base' | 'theme-block' | 'full';
+interface GenerateThemeFileOptions extends UiThemeOptions {
+    /** Which CSS generator to use. Default: `full` */
+    variant?: ThemeCssVariant;
+}
+interface GenerateThemeFilesOptions extends UiThemeOptions {
+    /** Directory for default output file names. Default: `.` (cwd) */
+    outputDir?: string;
+    /** Override output path per variant (relative to cwd unless absolute) */
+    outputPaths?: Partial<Record<ThemeCssVariant, string>>;
+}
+/**
+ * Write theme CSS to a file using the selected core generator variant.
+ */
+declare function generateThemeFile(options?: GenerateThemeFileOptions): Promise<string>;
+/**
+ * Write all three theme CSS variants (layer-base, theme-block, full) to files.
+ */
+declare function generateThemeFiles(options?: GenerateThemeFilesOptions): Promise<Record<ThemeCssVariant, string>>;
+
+export { type GenerateThemeFileOptions, type GenerateThemeFilesOptions, type ThemeCssVariant, generateThemeFile, generateThemeFiles };

package/dist/generater.js

@@ -0,0 +1,347 @@
+// src/generater.ts
+import fs from "fs";
+import path from "path";
+
+// src/utils.ts
+function resolveTokenValue(value, prefix) {
+  return value.replace(/\$\{prefix\}/g, prefix);
+}
+function deepMerge(target, source) {
+  const result = { ...target };
+  for (const key in source) {
+    if (Object.prototype.hasOwnProperty.call(source, key)) {
+      const sourceVal = source[key];
+      const targetVal = result[key];
+      if (sourceVal && typeof sourceVal === "object" && !Array.isArray(sourceVal) && targetVal && typeof targetVal === "object") {
+        result[key] = deepMerge(
+          targetVal,
+          sourceVal
+        );
+      } else {
+        result[key] = sourceVal;
+      }
+    }
+  }
+  return result;
+}
+
+// src/config.ts
+var themePrimaryBgOpacity = {
+  light: "0.08",
+  dark: "0.12",
+  pink: "0.12",
+  amber: "0.12",
+  forest: "0.1",
+  ocean: "0.1"
+};
+var builtinThemes = {
+  light: {
+    "color-primary": "246 248 250",
+    "color-secondary": "255 255 255",
+    "color-elevated": "240 242 244",
+    "color-primary-text": "31 35 40",
+    "color-primary-text-hover": "101 109 118",
+    "color-secondary-text": "101 109 118",
+    "color-tertiary-text": "140 149 159",
+    "color-primary-border": "208 215 222",
+    "color-brand": "124 58 237",
+    "color-brand-hover": "109 40 217",
+    "color-brand-active": "91 33 182",
+    "color-success": "#1a7f37",
+    "color-warning": "#faad14",
+    "color-error": "#cf222e",
+    "border-radius": "6px"
+  },
+  dark: {
+    "color-primary": "15 17 21",
+    "color-secondary": "22 27 34",
+    "color-elevated": "33 38 45",
+    "color-primary-text": "230 237 243",
+    "color-primary-text-hover": "139 148 158",
+    "color-secondary-text": "139 148 158",
+    "color-tertiary-text": "110 118 129",
+    "color-primary-border": "48 54 61",
+    "color-brand": "139 92 246",
+    "color-brand-hover": "124 58 237",
+    "color-brand-active": "109 40 217",
+    "color-success": "#3fb950",
+    "color-warning": "#faad14",
+    "color-error": "#f85149",
+    "border-radius": "6px"
+  },
+  pink: {
+    "color-primary": "26 13 20",
+    "color-secondary": "37 16 27",
+    "color-elevated": "48 21 34",
+    "color-primary-text": "252 232 240",
+    "color-primary-text-hover": "196 144 168",
+    "color-secondary-text": "196 144 168",
+    "color-tertiary-text": "138 88 112",
+    "color-primary-border": "92 45 66",
+    "color-brand": "244 114 182",
+    "color-brand-hover": "236 72 153",
+    "color-brand-active": "219 39 119",
+    "color-success": "#34d399",
+    "color-warning": "#faad14",
+    "color-error": "#fb7185",
+    "border-radius": "8px"
+  },
+  amber: {
+    "color-primary": "30 18 0",
+    "color-secondary": "40 26 0",
+    "color-elevated": "50 31 0",
+    "color-primary-text": "242 232 213",
+    "color-primary-text-hover": "184 166 138",
+    "color-secondary-text": "184 166 138",
+    "color-tertiary-text": "122 106 86",
+    "color-primary-border": "74 56 0",
+    "color-brand": "232 148 58",
+    "color-brand-hover": "208 120 40",
+    "color-brand-active": "180 100 30",
+    "color-success": "#5aad6e",
+    "color-warning": "#faad14",
+    "color-error": "#c85a4a",
+    "border-radius": "6px"
+  },
+  forest: {
+    "color-primary": "6 21 8",
+    "color-secondary": "12 31 14",
+    "color-elevated": "19 39 22",
+    "color-primary-text": "216 240 220",
+    "color-primary-text-hover": "136 173 142",
+    "color-secondary-text": "136 173 142",
+    "color-tertiary-text": "90 122 94",
+    "color-primary-border": "44 66 48",
+    "color-brand": "74 222 128",
+    "color-brand-hover": "34 197 94",
+    "color-brand-active": "22 163 74",
+    "color-success": "#86efac",
+    "color-warning": "#faad14",
+    "color-error": "#f87171",
+    "border-radius": "6px"
+  },
+  ocean: {
+    "color-primary": "6 14 26",
+    "color-secondary": "13 26 46",
+    "color-elevated": "18 36 62",
+    "color-primary-text": "218 238 255",
+    "color-primary-text-hover": "122 181 212",
+    "color-secondary-text": "122 181 212",
+    "color-tertiary-text": "74 126 154",
+    "color-primary-border": "30 58 92",
+    "color-brand": "56 189 248",
+    "color-brand-hover": "14 165 233",
+    "color-brand-active": "2 132 199",
+    "color-success": "#34d399",
+    "color-warning": "#faad14",
+    "color-error": "#f87171",
+    "border-radius": "6px"
+  }
+};
+var getDerivedTokens = (prefix, themeName) => {
+  const opacity = themeName ? themePrimaryBgOpacity[themeName] ?? "0.1" : "0.1";
+  return {
+    "color-bg-container": `rgb(var(--${prefix}-color-secondary))`,
+    "color-text": `rgb(var(--${prefix}-color-primary-text) / 0.85)`,
+    "color-text-heading": `rgb(var(--${prefix}-color-primary-text))`,
+    "color-text-disabled": `rgb(var(--${prefix}-color-primary-text) / 0.25)`,
+    "color-primary-hover": `rgb(var(--${prefix}-color-brand-hover))`,
+    "color-primary-active": `rgb(var(--${prefix}-color-brand-active))`,
+    "color-primary-bg": `rgb(var(--${prefix}-color-brand) / ${opacity})`,
+    "line-height": "1.5715"
+  };
+};
+var defaultTokenMapping = {
+  "color-primary": "rgb(var(--${prefix}-color-primary))",
+  "color-primary-active": "rgb(var(--${prefix}-color-primary-active))",
+  "color-primary-hover": "rgb(var(--${prefix}-color-primary-hover))",
+  "color-primary-bg": "rgb(var(--${prefix}-color-primary-bg))",
+  "color-secondary": "rgb(var(--${prefix}-color-secondary))",
+  "color-elevated": "rgb(var(--${prefix}-color-elevated))",
+  "color-primary-text": "rgb(var(--${prefix}-color-primary-text))",
+  "color-primary-text-hover": "rgb(var(--${prefix}-color-primary-text-hover))",
+  "color-secondary-text": "rgb(var(--${prefix}-color-secondary-text))",
+  "color-tertiary-text": "rgb(var(--${prefix}-color-tertiary-text))",
+  "color-primary-border": "rgb(var(--${prefix}-color-primary-border))",
+  "color-brand": "rgb(var(--${prefix}-color-brand))",
+  "color-brand-hover": "rgb(var(--${prefix}-color-brand-hover))",
+  "color-brand-active": "rgb(var(--${prefix}-color-brand-active))",
+  /** Text/icons on brand-colored surfaces (buttons, badges) */
+  "color-on-brand": "#ffffff",
+  "color-progress-track": "rgb(var(--${prefix}-color-primary-border) / 0.5)",
+  "color-bg-container": "rgb(var(--${prefix}-color-bg-container))",
+  "font-sans": 'var(--font-inter), ui-sans-serif, system-ui, "PingFang SC", "Microsoft YaHei UI", "Microsoft YaHei", "Noto Sans SC", sans-serif',
+  "animate-dashboard-skeleton-shimmer": "dashboard-skeleton-shimmer 1.6s ease-in-out infinite"
+};
+function getDefaultSelector(themeName, root) {
+  if (root) {
+    return `:root, html[data-theme="${themeName}"], [data-theme="${themeName}"]`;
+  }
+  return `html[data-theme="${themeName}"], [data-theme="${themeName}"]`;
+}
+var defaultConfig = {
+  prefix: "fe",
+  themes: {},
+  tokenMapping: defaultTokenMapping,
+  cssSelector: getDefaultSelector
+};
+function getConfig(options) {
+  let allThemes = deepMerge(builtinThemes, options?.themes || {});
+  const includeThemes = options?.includeThemes;
+  if (includeThemes?.length) {
+    const filtered = {};
+    for (const name of includeThemes) {
+      if (allThemes[name]) {
+        filtered[name] = allThemes[name];
+      }
+    }
+    allThemes = filtered;
+  }
+  const allMappings = deepMerge(
+    defaultTokenMapping,
+    options?.tokenMapping || {}
+  );
+  const config = Object.assign(
+    {},
+    defaultConfig,
+    options,
+    {
+      themes: allThemes,
+      tokenMapping: allMappings,
+      includeThemes: includeThemes ?? []
+    }
+  );
+  if (!config.defaultTheme || !config.themes[config.defaultTheme]) {
+    config.defaultTheme = Object.keys(config.themes)[0];
+  }
+  return config;
+}
+
+// src/core.ts
+function generateLayerBaseCSS(options = {}) {
+  const config = getConfig(options);
+  const { prefix, themes, cssSelector, defaultTheme } = config;
+  let css = "";
+  for (const [themeName, vars] of Object.entries(themes)) {
+    const isDefault = themeName === defaultTheme;
+    const selector = cssSelector(themeName, isDefault);
+    const themeDerived = getDerivedTokens(prefix, themeName);
+    const merged = {
+      ...vars,
+      ...themeDerived
+    };
+    css += `${selector} {
+`;
+    for (const [varName, value] of Object.entries(merged)) {
+      css += `  --${prefix}-${varName}: ${value};
+`;
+    }
+    css += "}\n\n";
+  }
+  return css;
+}
+function generateThemeBlockCSS(options = {}) {
+  const config = getConfig(options);
+  const { prefix, tokenMapping = defaultTokenMapping } = config;
+  let css = "@theme {\n";
+  for (const [tokenName, tokenValue] of Object.entries(tokenMapping)) {
+    const finalValue = resolveTokenValue(tokenValue, prefix);
+    css += `  --${tokenName}: ${finalValue};
+`;
+  }
+  css += "}\n";
+  return css;
+}
+function generateThemeCSS(options = {}) {
+  let css = "";
+  const layerBaseContent = generateLayerBaseCSS(options);
+  if (layerBaseContent) {
+    css += "@layer base {\n" + layerBaseContent + "}\n\n";
+  }
+  css += generateThemeBlockCSS(options);
+  return css;
+}
+
+// src/generater.ts
+var DEFAULT_OUTPUT_PATHS = {
+  "layer-base": "theme-layer-base.css",
+  "theme-block": "theme-block.css",
+  full: "theme.css"
+};
+function resolveCssContent(variant, options) {
+  switch (variant) {
+    case "layer-base": {
+      const layerBaseContent = generateLayerBaseCSS(options);
+      return layerBaseContent ? `@layer base {
+${layerBaseContent}}
+` : "";
+    }
+    case "theme-block":
+      return generateThemeBlockCSS(options);
+    case "full":
+      return generateThemeCSS(options);
+    default: {
+      const _exhaustive = variant;
+      return _exhaustive;
+    }
+  }
+}
+async function writeCssFile(absolutePath, css, overwrite) {
+  if (fs.existsSync(absolutePath)) {
+    if (overwrite) {
+      console.warn(
+        `\u26A0\uFE0F Warning: File already exists at ${absolutePath}. It will be overwritten.`
+      );
+    } else {
+      throw new Error(
+        `File already exists at ${absolutePath} and overwrite is set to false.`
+      );
+    }
+  }
+  const dir = path.dirname(absolutePath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  await fs.promises.writeFile(absolutePath, css, "utf-8");
+  console.log(`\u2705 Theme CSS generated at ${absolutePath}`);
+}
+function resolveOutputPath(variant, options) {
+  if (options.outputPath) {
+    return path.resolve(process.cwd(), options.outputPath);
+  }
+  return path.resolve(process.cwd(), DEFAULT_OUTPUT_PATHS[variant]);
+}
+async function generateThemeFile(options = {}) {
+  const {
+    variant = "full",
+    overwrite = true,
+    outputPath,
+    ...restOptions
+  } = options;
+  const absolutePath = outputPath ? path.resolve(process.cwd(), outputPath) : resolveOutputPath(variant, options);
+  const css = resolveCssContent(variant, restOptions);
+  await writeCssFile(absolutePath, css, overwrite);
+  return absolutePath;
+}
+async function generateThemeFiles(options = {}) {
+  const {
+    outputDir = ".",
+    outputPaths = {},
+    overwrite = true,
+    ...restOptions
+  } = options;
+  const variants = Object.keys(DEFAULT_OUTPUT_PATHS);
+  const result = {};
+  for (const variant of variants) {
+    const relativePath = outputPaths[variant] ?? path.join(outputDir, DEFAULT_OUTPUT_PATHS[variant]);
+    const absolutePath = path.resolve(process.cwd(), relativePath);
+    const css = resolveCssContent(variant, restOptions);
+    await writeCssFile(absolutePath, css, overwrite);
+    result[variant] = absolutePath;
+  }
+  return result;
+}
+export {
+  generateThemeFile,
+  generateThemeFiles
+};

package/dist/index.cjs

@@ -1,13 +1,11 @@
-"use strict";var j=Object.create;var m=Object.defineProperty;var B=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var G=Object.getPrototypeOf,A=Object.prototype.hasOwnProperty;var E=(r,e)=>{for(var o in e)m(r,o,{get:e[o],enumerable:!0})},k=(r,e,o,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of D(e))!A.call(r,a)&&a!==o&&m(r,a,{get:()=>e[a],enumerable:!(t=B(e,a))||t.enumerable});return r};var $=(r,e,o)=>(o=r!=null?j(G(r)):{},k(e||!r||!r.__esModule?m(o,"default",{value:r,enumerable:!0}):o,r)),_=r=>k(m({},"__esModule",{value:!0}),r);var Y={};E(Y,{builtinThemes:()=>C,defaultConfig:()=>S,defaultTokenMapping:()=>l,generateLayerBaseCSS:()=>f,generateThemeBlockCSS:()=>y,generateThemeCSS:()=>v,generateThemeFile:()=>q,generateThemeFiles:()=>I,getConfig:()=>g,getDefaultSelector:()=>w,getDerivedTokens:()=>x});module.exports=_(Y);function O(r,e){return r.replace(/\$\{prefix\}/g,e)}function d(r,e){let o={...r};for(let t in e)if(Object.prototype.hasOwnProperty.call(e,t)){let a=e[t],n=o[t];a&&typeof a=="object"&&!Array.isArray(a)&&n&&typeof n=="object"?o[t]=d(n,a):o[t]=a}return o}var H={light:"0.08",dark:"0.12",pink:"0.12",amber:"0.12",forest:"0.1",ocean:"0.1"},C={light:{"color-primary":"246 248 250","color-secondary":"255 255 255","color-elevated":"240 242 244","color-primary-text":"31 35 40","color-primary-text-hover":"101 109 118","color-secondary-text":"101 109 118","color-tertiary-text":"140 149 159","color-primary-border":"208 215 222","color-brand":"124 58 237","color-brand-hover":"109 40 217","color-brand-active":"91 33 182","color-success":"#1a7f37","color-warning":"#faad14","color-error":"#cf222e","border-radius":"6px"},dark:{"color-primary":"15 17 21","color-secondary":"22 27 34","color-elevated":"33 38 45","color-primary-text":"230 237 243","color-primary-text-hover":"139 148 158","color-secondary-text":"139 148 158","color-tertiary-text":"110 118 129","color-primary-border":"48 54 61","color-brand":"139 92 246","color-brand-hover":"124 58 237","color-brand-active":"109 40 217","color-success":"#3fb950","color-warning":"#faad14","color-error":"#f85149","border-radius":"6px"},pink:{"color-primary":"26 13 20","color-secondary":"37 16 27","color-elevated":"48 21 34","color-primary-text":"252 232 240","color-primary-text-hover":"196 144 168","color-secondary-text":"196 144 168","color-tertiary-text":"138 88 112","color-primary-border":"92 45 66","color-brand":"244 114 182","color-brand-hover":"236 72 153","color-brand-active":"219 39 119","color-success":"#34d399","color-warning":"#faad14","color-error":"#fb7185","border-radius":"8px"},amber:{"color-primary":"30 18 0","color-secondary":"40 26 0","color-elevated":"50 31 0","color-primary-text":"242 232 213","color-primary-text-hover":"184 166 138","color-secondary-text":"184 166 138","color-tertiary-text":"122 106 86","color-primary-border":"74 56 0","color-brand":"232 148 58","color-brand-hover":"208 120 40","color-brand-active":"180 100 30","color-success":"#5aad6e","color-warning":"#faad14","color-error":"#c85a4a","border-radius":"6px"},forest:{"color-primary":"6 21 8","color-secondary":"12 31 14","color-elevated":"19 39 22","color-primary-text":"216 240 220","color-primary-text-hover":"136 173 142","color-secondary-text":"136 173 142","color-tertiary-text":"90 122 94","color-primary-border":"44 66 48","color-brand":"74 222 128","color-brand-hover":"34 197 94","color-brand-active":"22 163 74","color-success":"#86efac","color-warning":"#faad14","color-error":"#f87171","border-radius":"6px"},ocean:{"color-primary":"6 14 26","color-secondary":"13 26 46","color-elevated":"18 36 62","color-primary-text":"218 238 255","color-primary-text-hover":"122 181 212","color-secondary-text":"122 181 212","color-tertiary-text":"74 126 154","color-primary-border":"30 58 92","color-brand":"56 189 248","color-brand-hover":"14 165 233","color-brand-active":"2 132 199","color-success":"#34d399","color-warning":"#faad14","color-error":"#f87171","border-radius":"6px"}},x=(r,e)=>{let o=e?H[e]??"0.1":"0.1";return{"color-bg-container":`rgb(var(--${r}-color-secondary))`,"color-text":`rgb(var(--${r}-color-primary-text) / 0.85)`,"color-text-heading":`rgb(var(--${r}-color-primary-text))`,"color-text-disabled":`rgb(var(--${r}-color-primary-text) / 0.25)`,"color-primary-hover":`rgb(var(--${r}-color-brand-hover))`,"color-primary-active":`rgb(var(--${r}-color-brand-active))`,"color-primary-bg":`rgb(var(--${r}-color-brand) / ${o})`,"line-height":"1.5715"}},l={"color-primary":"rgb(var(--${prefix}-color-primary))","color-primary-active":"rgb(var(--${prefix}-color-primary-active))","color-primary-hover":"rgb(var(--${prefix}-color-primary-hover))","color-primary-bg":"rgb(var(--${prefix}-color-primary-bg))","color-secondary":"rgb(var(--${prefix}-color-secondary))","color-elevated":"rgb(var(--${prefix}-color-elevated))","color-primary-text":"rgb(var(--${prefix}-color-primary-text))","color-primary-text-hover":"rgb(var(--${prefix}-color-primary-text-hover))","color-secondary-text":"rgb(var(--${prefix}-color-secondary-text))","color-tertiary-text":"rgb(var(--${prefix}-color-tertiary-text))","color-primary-border":"rgb(var(--${prefix}-color-primary-border))","color-brand":"rgb(var(--${prefix}-color-brand))","color-brand-hover":"rgb(var(--${prefix}-color-brand-hover))","color-brand-active":"rgb(var(--${prefix}-color-brand-active))","color-on-brand":"#ffffff","color-progress-track":"rgb(var(--${prefix}-color-primary-border) / 0.5)","color-bg-container":"rgb(var(--${prefix}-color-bg-container))","font-sans":'var(--font-inter), ui-sans-serif, system-ui, "PingFang SC", "Microsoft YaHei UI", "Microsoft YaHei", "Noto Sans SC", sans-serif',"animate-dashboard-skeleton-shimmer":"dashboard-skeleton-shimmer 1.6s ease-in-out infinite"};function w(r,e){return e?`:root, html[data-theme="${r}"], [data-theme="${r}"]`:`html[data-theme="${r}"], [data-theme="${r}"]`}var S={prefix:"fe",themes:{},tokenMapping:l,cssSelector:w};function g(r){let e=d(C,r?.themes||{}),o=d(l,r?.tokenMapping||{}),t=Object.assign({},S,r,{themes:e,tokenMapping:o});return!t.defaultTheme&&t.themes&&(t.defaultTheme=Object.keys(t.themes)[0]),t}function f(r={}){let e=g(r),{prefix:o,themes:t,cssSelector:a,defaultTheme:n}=e,c="";for(let[i,h]of Object.entries(t)){let u=a(i,i===n),V=x(o,i),P={...h,...V};c+=`${u} {
-`;for(let[R,F]of Object.entries(P))c+=`  --${o}-${R}: ${F};
-`;c+=`}
+"use strict";var d=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var S=Object.prototype.hasOwnProperty;var w=(r,o)=>{for(var t in o)d(r,t,{get:o[t],enumerable:!0})},R=(r,o,t,a)=>{if(o&&typeof o=="object"||typeof o=="function")for(let e of C(o))!S.call(r,e)&&e!==t&&d(r,e,{get:()=>o[e],enumerable:!(a=O(o,e))||a.enumerable});return r};var U=r=>R(d({},"__esModule",{value:!0}),r);var B={};w(B,{builtinThemes:()=>f,defaultConfig:()=>b,defaultTokenMapping:()=>l,generateLayerBaseCSS:()=>x,generateThemeBlockCSS:()=>h,generateThemeCSS:()=>V,getConfig:()=>p,getDefaultSelector:()=>y,getDerivedTokens:()=>m});module.exports=U(B);function g(r,o){return r.replace(/\$\{prefix\}/g,o)}function s(r,o){let t={...r};for(let a in o)if(Object.prototype.hasOwnProperty.call(o,a)){let e=o[a],c=t[a];e&&typeof e=="object"&&!Array.isArray(e)&&c&&typeof c=="object"?t[a]=s(c,e):t[a]=e}return t}var j={light:"0.08",dark:"0.12",pink:"0.12",amber:"0.12",forest:"0.1",ocean:"0.1"},f={light:{"color-primary":"246 248 250","color-secondary":"255 255 255","color-elevated":"240 242 244","color-primary-text":"31 35 40","color-primary-text-hover":"101 109 118","color-secondary-text":"101 109 118","color-tertiary-text":"140 149 159","color-primary-border":"208 215 222","color-brand":"124 58 237","color-brand-hover":"109 40 217","color-brand-active":"91 33 182","color-success":"#1a7f37","color-warning":"#faad14","color-error":"#cf222e","border-radius":"6px"},dark:{"color-primary":"15 17 21","color-secondary":"22 27 34","color-elevated":"33 38 45","color-primary-text":"230 237 243","color-primary-text-hover":"139 148 158","color-secondary-text":"139 148 158","color-tertiary-text":"110 118 129","color-primary-border":"48 54 61","color-brand":"139 92 246","color-brand-hover":"124 58 237","color-brand-active":"109 40 217","color-success":"#3fb950","color-warning":"#faad14","color-error":"#f85149","border-radius":"6px"},pink:{"color-primary":"26 13 20","color-secondary":"37 16 27","color-elevated":"48 21 34","color-primary-text":"252 232 240","color-primary-text-hover":"196 144 168","color-secondary-text":"196 144 168","color-tertiary-text":"138 88 112","color-primary-border":"92 45 66","color-brand":"244 114 182","color-brand-hover":"236 72 153","color-brand-active":"219 39 119","color-success":"#34d399","color-warning":"#faad14","color-error":"#fb7185","border-radius":"8px"},amber:{"color-primary":"30 18 0","color-secondary":"40 26 0","color-elevated":"50 31 0","color-primary-text":"242 232 213","color-primary-text-hover":"184 166 138","color-secondary-text":"184 166 138","color-tertiary-text":"122 106 86","color-primary-border":"74 56 0","color-brand":"232 148 58","color-brand-hover":"208 120 40","color-brand-active":"180 100 30","color-success":"#5aad6e","color-warning":"#faad14","color-error":"#c85a4a","border-radius":"6px"},forest:{"color-primary":"6 21 8","color-secondary":"12 31 14","color-elevated":"19 39 22","color-primary-text":"216 240 220","color-primary-text-hover":"136 173 142","color-secondary-text":"136 173 142","color-tertiary-text":"90 122 94","color-primary-border":"44 66 48","color-brand":"74 222 128","color-brand-hover":"34 197 94","color-brand-active":"22 163 74","color-success":"#86efac","color-warning":"#faad14","color-error":"#f87171","border-radius":"6px"},ocean:{"color-primary":"6 14 26","color-secondary":"13 26 46","color-elevated":"18 36 62","color-primary-text":"218 238 255","color-primary-text-hover":"122 181 212","color-secondary-text":"122 181 212","color-tertiary-text":"74 126 154","color-primary-border":"30 58 92","color-brand":"56 189 248","color-brand-hover":"14 165 233","color-brand-active":"2 132 199","color-success":"#34d399","color-warning":"#faad14","color-error":"#f87171","border-radius":"6px"}},m=(r,o)=>{let t=o?j[o]??"0.1":"0.1";return{"color-bg-container":`rgb(var(--${r}-color-secondary))`,"color-text":`rgb(var(--${r}-color-primary-text) / 0.85)`,"color-text-heading":`rgb(var(--${r}-color-primary-text))`,"color-text-disabled":`rgb(var(--${r}-color-primary-text) / 0.25)`,"color-primary-hover":`rgb(var(--${r}-color-brand-hover))`,"color-primary-active":`rgb(var(--${r}-color-brand-active))`,"color-primary-bg":`rgb(var(--${r}-color-brand) / ${t})`,"line-height":"1.5715"}},l={"color-primary":"rgb(var(--${prefix}-color-primary))","color-primary-active":"rgb(var(--${prefix}-color-primary-active))","color-primary-hover":"rgb(var(--${prefix}-color-primary-hover))","color-primary-bg":"rgb(var(--${prefix}-color-primary-bg))","color-secondary":"rgb(var(--${prefix}-color-secondary))","color-elevated":"rgb(var(--${prefix}-color-elevated))","color-primary-text":"rgb(var(--${prefix}-color-primary-text))","color-primary-text-hover":"rgb(var(--${prefix}-color-primary-text-hover))","color-secondary-text":"rgb(var(--${prefix}-color-secondary-text))","color-tertiary-text":"rgb(var(--${prefix}-color-tertiary-text))","color-primary-border":"rgb(var(--${prefix}-color-primary-border))","color-brand":"rgb(var(--${prefix}-color-brand))","color-brand-hover":"rgb(var(--${prefix}-color-brand-hover))","color-brand-active":"rgb(var(--${prefix}-color-brand-active))","color-on-brand":"#ffffff","color-progress-track":"rgb(var(--${prefix}-color-primary-border) / 0.5)","color-bg-container":"rgb(var(--${prefix}-color-bg-container))","font-sans":'var(--font-inter), ui-sans-serif, system-ui, "PingFang SC", "Microsoft YaHei UI", "Microsoft YaHei", "Noto Sans SC", sans-serif',"animate-dashboard-skeleton-shimmer":"dashboard-skeleton-shimmer 1.6s ease-in-out infinite"};function y(r,o){return o?`:root, html[data-theme="${r}"], [data-theme="${r}"]`:`html[data-theme="${r}"], [data-theme="${r}"]`}var b={prefix:"fe",themes:{},tokenMapping:l,cssSelector:y};function p(r){let o=s(f,r?.themes||{}),t=r?.includeThemes;if(t?.length){let c={};for(let n of t)o[n]&&(c[n]=o[n]);o=c}let a=s(l,r?.tokenMapping||{}),e=Object.assign({},b,r,{themes:o,tokenMapping:a,includeThemes:t??[]});return(!e.defaultTheme||!e.themes[e.defaultTheme])&&(e.defaultTheme=Object.keys(e.themes)[0]),e}function x(r={}){let o=p(r),{prefix:t,themes:a,cssSelector:e,defaultTheme:c}=o,n="";for(let[i,v]of Object.entries(a)){let u=e(i,i===c),T=m(t,i),$={...v,...T};n+=`${u} {
+`;for(let[k,M]of Object.entries($))n+=`  --${t}-${k}: ${M};
+`;n+=`}
 
-`}return c}function y(r={}){let e=g(r),{prefix:o,tokenMapping:t=l}=e,a=`@theme {
-`;for(let[n,c]of Object.entries(t)){let i=O(c,o);a+=`  --${n}: ${i};
-`}return a+=`}
-`,a}function v(r={}){let e="",o=f(r);return o&&(e+=`@layer base {
-`+o+`}
+`}return n}function h(r={}){let o=p(r),{prefix:t,tokenMapping:a=l}=o,e=`@theme {
+`;for(let[c,n]of Object.entries(a)){let i=g(n,t);e+=`  --${c}: ${i};
+`}return e+=`}
+`,e}function V(r={}){let o="",t=x(r);return t&&(o+=`@layer base {
+`+t+`}
 
-`),e+=y(r),e}var p=$(require("fs"),1),s=$(require("path"),1);var T={"layer-base":"theme-layer-base.css","theme-block":"theme-block.css",full:"theme.css"};function M(r,e){switch(r){case"layer-base":{let o=f(e);return o?`@layer base {
-${o}}
-`:""}case"theme-block":return y(e);case"full":return v(e);default:return r}}async function U(r,e,o){if(p.default.existsSync(r))if(o)console.warn(`\u26A0\uFE0F Warning: File already exists at ${r}. It will be overwritten.`);else throw new Error(`File already exists at ${r} and overwrite is set to false.`);let t=s.default.dirname(r);p.default.existsSync(t)||p.default.mkdirSync(t,{recursive:!0}),await p.default.promises.writeFile(r,e,"utf-8"),console.log(`\u2705 Theme CSS generated at ${r}`)}function L(r,e){return e.outputPath?s.default.resolve(process.cwd(),e.outputPath):s.default.resolve(process.cwd(),T[r])}async function q(r={}){let{variant:e="full",overwrite:o=!0,outputPath:t,...a}=r,n=t?s.default.resolve(process.cwd(),t):L(e,r),c=M(e,a);return await U(n,c,o),n}async function I(r={}){let{outputDir:e=".",outputPaths:o={},overwrite:t=!0,...a}=r,n=Object.keys(T),c={};for(let i of n){let h=o[i]??s.default.join(e,T[i]),b=s.default.resolve(process.cwd(),h),u=M(i,a);await U(b,u,t),c[i]=b}return c}0&&(module.exports={builtinThemes,defaultConfig,defaultTokenMapping,generateLayerBaseCSS,generateThemeBlockCSS,generateThemeCSS,generateThemeFile,generateThemeFiles,getConfig,getDefaultSelector,getDerivedTokens});
+`),o+=h(r),o}0&&(module.exports={builtinThemes,defaultConfig,defaultTokenMapping,generateLayerBaseCSS,generateThemeBlockCSS,generateThemeCSS,getConfig,getDefaultSelector,getDerivedTokens});

package/dist/index.d.ts

@@ -33,6 +33,11 @@ interface UiThemeOptions {
     prefix?: string;
     defaultTheme?: string;
     themes?: ThemesMap;
+    /**
+     * When set, only these theme names are emitted (after merging builtins).
+     * Use to keep app CSS small when the package ships extra demo themes.
+     */
+    includeThemes?: string[];
     tokenMapping?: TokenMapping;
     cssSelector?: (themeName: string, root: boolean) => string;
     outputPath?: string;
@@ -64,25 +69,4 @@ declare function generateThemeBlockCSS(options?: UiThemeOptions): string;
  */
 declare function generateThemeCSS(options?: UiThemeOptions): string;
 
-/** CSS variant aligned with {@link core.ts} generators */
-type ThemeCssVariant = 'layer-base' | 'theme-block' | 'full';
-interface GenerateThemeFileOptions extends UiThemeOptions {
-    /** Which CSS generator to use. Default: `full` */
-    variant?: ThemeCssVariant;
-}
-interface GenerateThemeFilesOptions extends UiThemeOptions {
-    /** Directory for default output file names. Default: `.` (cwd) */
-    outputDir?: string;
-    /** Override output path per variant (relative to cwd unless absolute) */
-    outputPaths?: Partial<Record<ThemeCssVariant, string>>;
-}
-/**
- * Write theme CSS to a file using the selected core generator variant.
- */
-declare function generateThemeFile(options?: GenerateThemeFileOptions): Promise<string>;
-/**
- * Write all three theme CSS variants (layer-base, theme-block, full) to files.
- */
-declare function generateThemeFiles(options?: GenerateThemeFilesOptions): Promise<Record<ThemeCssVariant, string>>;
-
-export { type ColorValue, type GenerateThemeFileOptions, type GenerateThemeFilesOptions, type RGBChannels, type ThemeCssVariant, type ThemeTokens, type ThemesMap, type TokenMapping, type UiThemeOptions, builtinThemes, defaultConfig, defaultTokenMapping, generateLayerBaseCSS, generateThemeBlockCSS, generateThemeCSS, generateThemeFile, generateThemeFiles, getConfig, getDefaultSelector, getDerivedTokens };
+export { type ColorValue, type RGBChannels, type ThemeTokens, type ThemesMap, type TokenMapping, type UiThemeOptions, builtinThemes, defaultConfig, defaultTokenMapping, generateLayerBaseCSS, generateThemeBlockCSS, generateThemeCSS, getConfig, getDefaultSelector, getDerivedTokens };

package/dist/index.js

@@ -182,7 +182,17 @@ var defaultConfig = {
   cssSelector: getDefaultSelector
 };
 function getConfig(options) {
-  const allThemes = deepMerge(builtinThemes, options?.themes || {});
+  let allThemes = deepMerge(builtinThemes, options?.themes || {});
+  const includeThemes = options?.includeThemes;
+  if (includeThemes?.length) {
+    const filtered = {};
+    for (const name of includeThemes) {
+      if (allThemes[name]) {
+        filtered[name] = allThemes[name];
+      }
+    }
+    allThemes = filtered;
+  }
   const allMappings = deepMerge(
     defaultTokenMapping,
     options?.tokenMapping || {}
@@ -193,10 +203,11 @@ function getConfig(options) {
     options,
     {
       themes: allThemes,
-      tokenMapping: allMappings
+      tokenMapping: allMappings,
+      includeThemes: includeThemes ?? []
     }
   );
-  if (!config.defaultTheme && config.themes) {
+  if (!config.defaultTheme || !config.themes[config.defaultTheme]) {
     config.defaultTheme = Object.keys(config.themes)[0];
   }
   return config;
@@ -246,88 +257,6 @@ function generateThemeCSS(options = {}) {
   css += generateThemeBlockCSS(options);
   return css;
 }
-
-// src/generater.ts
-import fs from "fs";
-import path from "path";
-var DEFAULT_OUTPUT_PATHS = {
-  "layer-base": "theme-layer-base.css",
-  "theme-block": "theme-block.css",
-  full: "theme.css"
-};
-function resolveCssContent(variant, options) {
-  switch (variant) {
-    case "layer-base": {
-      const layerBaseContent = generateLayerBaseCSS(options);
-      return layerBaseContent ? `@layer base {
-${layerBaseContent}}
-` : "";
-    }
-    case "theme-block":
-      return generateThemeBlockCSS(options);
-    case "full":
-      return generateThemeCSS(options);
-    default: {
-      const _exhaustive = variant;
-      return _exhaustive;
-    }
-  }
-}
-async function writeCssFile(absolutePath, css, overwrite) {
-  if (fs.existsSync(absolutePath)) {
-    if (overwrite) {
-      console.warn(
-        `\u26A0\uFE0F Warning: File already exists at ${absolutePath}. It will be overwritten.`
-      );
-    } else {
-      throw new Error(
-        `File already exists at ${absolutePath} and overwrite is set to false.`
-      );
-    }
-  }
-  const dir = path.dirname(absolutePath);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  await fs.promises.writeFile(absolutePath, css, "utf-8");
-  console.log(`\u2705 Theme CSS generated at ${absolutePath}`);
-}
-function resolveOutputPath(variant, options) {
-  if (options.outputPath) {
-    return path.resolve(process.cwd(), options.outputPath);
-  }
-  return path.resolve(process.cwd(), DEFAULT_OUTPUT_PATHS[variant]);
-}
-async function generateThemeFile(options = {}) {
-  const {
-    variant = "full",
-    overwrite = true,
-    outputPath,
-    ...restOptions
-  } = options;
-  const absolutePath = outputPath ? path.resolve(process.cwd(), outputPath) : resolveOutputPath(variant, options);
-  const css = resolveCssContent(variant, restOptions);
-  await writeCssFile(absolutePath, css, overwrite);
-  return absolutePath;
-}
-async function generateThemeFiles(options = {}) {
-  const {
-    outputDir = ".",
-    outputPaths = {},
-    overwrite = true,
-    ...restOptions
-  } = options;
-  const variants = Object.keys(DEFAULT_OUTPUT_PATHS);
-  const result = {};
-  for (const variant of variants) {
-    const relativePath = outputPaths[variant] ?? path.join(outputDir, DEFAULT_OUTPUT_PATHS[variant]);
-    const absolutePath = path.resolve(process.cwd(), relativePath);
-    const css = resolveCssContent(variant, restOptions);
-    await writeCssFile(absolutePath, css, overwrite);
-    result[variant] = absolutePath;
-  }
-  return result;
-}
 export {
   builtinThemes,
   defaultConfig,
@@ -335,8 +264,6 @@ export {
   generateLayerBaseCSS,
   generateThemeBlockCSS,
   generateThemeCSS,
-  generateThemeFile,
-  generateThemeFiles,
   getConfig,
   getDefaultSelector,
   getDerivedTokens

package/dist/plugin.cjs

@@ -208,7 +208,17 @@ var defaultConfig = {
   cssSelector: getDefaultSelector
 };
 function getConfig(options) {
-  const allThemes = deepMerge(builtinThemes, options?.themes || {});
+  let allThemes = deepMerge(builtinThemes, options?.themes || {});
+  const includeThemes = options?.includeThemes;
+  if (includeThemes?.length) {
+    const filtered = {};
+    for (const name of includeThemes) {
+      if (allThemes[name]) {
+        filtered[name] = allThemes[name];
+      }
+    }
+    allThemes = filtered;
+  }
   const allMappings = deepMerge(
     defaultTokenMapping,
     options?.tokenMapping || {}
@@ -219,10 +229,11 @@ function getConfig(options) {
     options,
     {
       themes: allThemes,
-      tokenMapping: allMappings
+      tokenMapping: allMappings,
+      includeThemes: includeThemes ?? []
     }
   );
-  if (!config.defaultTheme && config.themes) {
+  if (!config.defaultTheme || !config.themes[config.defaultTheme]) {
     config.defaultTheme = Object.keys(config.themes)[0];
   }
   return config;

package/dist/plugin.d.cts

@@ -35,6 +35,11 @@ interface UiThemeOptions {
     prefix?: string;
     defaultTheme?: string;
     themes?: ThemesMap;
+    /**
+     * When set, only these theme names are emitted (after merging builtins).
+     * Use to keep app CSS small when the package ships extra demo themes.
+     */
+    includeThemes?: string[];
     tokenMapping?: TokenMapping;
     cssSelector?: (themeName: string, root: boolean) => string;
     outputPath?: string;

package/dist/plugin.d.ts

@@ -35,6 +35,11 @@ interface UiThemeOptions {
     prefix?: string;
     defaultTheme?: string;
     themes?: ThemesMap;
+    /**
+     * When set, only these theme names are emitted (after merging builtins).
+     * Use to keep app CSS small when the package ships extra demo themes.
+     */
+    includeThemes?: string[];
     tokenMapping?: TokenMapping;
     cssSelector?: (themeName: string, root: boolean) => string;
     outputPath?: string;

package/dist/plugin.js

@@ -182,7 +182,17 @@ var defaultConfig = {
   cssSelector: getDefaultSelector
 };
 function getConfig(options) {
-  const allThemes = deepMerge(builtinThemes, options?.themes || {});
+  let allThemes = deepMerge(builtinThemes, options?.themes || {});
+  const includeThemes = options?.includeThemes;
+  if (includeThemes?.length) {
+    const filtered = {};
+    for (const name of includeThemes) {
+      if (allThemes[name]) {
+        filtered[name] = allThemes[name];
+      }
+    }
+    allThemes = filtered;
+  }
   const allMappings = deepMerge(
     defaultTokenMapping,
     options?.tokenMapping || {}
@@ -193,10 +203,11 @@ function getConfig(options) {
     options,
     {
       themes: allThemes,
-      tokenMapping: allMappings
+      tokenMapping: allMappings,
+      includeThemes: includeThemes ?? []
     }
   );
-  if (!config.defaultTheme && config.themes) {
+  if (!config.defaultTheme || !config.themes[config.defaultTheme]) {
     config.defaultTheme = Object.keys(config.themes)[0];
   }
   return config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qlover/tailwind-theme",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "private": false,
   "main": "./dist/index.js",
@@ -18,6 +18,11 @@
       "import": "./dist/plugin.js",
       "require": "./dist/plugin.cjs"
     },
+    "./generater": {
+      "types": "./dist/generater.d.ts",
+      "import": "./dist/generater.js",
+      "require": "./dist/generater.cjs"
+    },
     "./theme.css": "./dist/theme.css",
     "./theme-layer-base.css": "./dist/theme-layer-base.css",
     "./theme-block.css": "./dist/theme-block.css"