@robot-admin/layout 2.3.2 → 3.1.0

package/dist/core/index.cjs

@@ -0,0 +1,310 @@
+"use strict";
+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);
+
+// src/core/index.ts
+var core_exports = {};
+__export(core_exports, {
+  BORDER_RADIUS_MAP: () => BORDER_RADIUS_MAP,
+  COLOR_SWATCHES: () => COLOR_SWATCHES,
+  DEFAULT_SETTINGS: () => DEFAULT_SETTINGS,
+  LAYOUT_MODES: () => LAYOUT_MODES,
+  PRESET_COLORS: () => PRESET_COLORS,
+  SETTINGS_CONFIG_SCHEMA_VERSION: () => SETTINGS_CONFIG_SCHEMA_VERSION,
+  THEME_PRESETS: () => THEME_PRESETS,
+  TRANSITION_MAP: () => TRANSITION_MAP,
+  adjustColor: () => adjustColor,
+  sanitizeLayoutSettingsConfig: () => sanitizeLayoutSettingsConfig,
+  sanitizeSettingsPatch: () => sanitizeSettingsPatch
+});
+module.exports = __toCommonJS(core_exports);
+
+// src/core/settings.ts
+var ENUM_SETTINGS = {
+  themeMode: /* @__PURE__ */ new Set(["light", "dark", "system"]),
+  borderRadius: /* @__PURE__ */ new Set(["small", "medium", "large"]),
+  transitionType: /* @__PURE__ */ new Set(["fade", "slide", "zoom", "none"]),
+  layoutMode: /* @__PURE__ */ new Set([
+    "side",
+    "top",
+    "mix",
+    "mix-top",
+    "reverse-horizontal-mix",
+    "card-layout"
+  ]),
+  menuExpandMode: /* @__PURE__ */ new Set(["inline", "panel"]),
+  tagsViewStyle: /* @__PURE__ */ new Set(["default", "card", "smart"])
+};
+var BOOLEAN_SETTINGS = /* @__PURE__ */ new Set([
+  "enableTransition",
+  "collapsed",
+  "fixedHeader",
+  "showBreadcrumb",
+  "showBreadcrumbIcon",
+  "showTagsView",
+  "showFooter",
+  "enableHotkeys"
+]);
+var NUMBER_RANGES = {
+  tagsViewHeight: [24, 100],
+  sidebarWidth: [120, 480],
+  sidebarCollapsedWidth: [32, 160],
+  headerHeight: [32, 160]
+};
+var SETTINGS_CONFIG_SCHEMA_VERSION = 1;
+function sanitizeSettingsPatch(input) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
+    throw new TypeError("settings \u5FC5\u987B\u662F\u5BF9\u8C61");
+  }
+  const source = input;
+  const result = {};
+  const assign = (key, value) => {
+    result[key] = value;
+  };
+  for (const [key, allowed] of Object.entries(ENUM_SETTINGS)) {
+    const value = source[key];
+    if (value === void 0) continue;
+    if (typeof value !== "string" || !allowed.has(value)) {
+      throw new RangeError(`\u65E0\u6548\u7684\u8BBE\u7F6E\u9879 ${key}: ${String(value)}`);
+    }
+    assign(key, value);
+  }
+  for (const key of BOOLEAN_SETTINGS) {
+    const value = source[key];
+    if (value === void 0) continue;
+    if (typeof value !== "boolean") {
+      throw new TypeError(`\u8BBE\u7F6E\u9879 ${key} \u5FC5\u987B\u662F\u5E03\u5C14\u503C`);
+    }
+    assign(key, value);
+  }
+  for (const [key, range] of Object.entries(NUMBER_RANGES)) {
+    const value = source[key];
+    if (value === void 0) continue;
+    if (typeof value !== "number" || !Number.isFinite(value) || value < range[0] || value > range[1]) {
+      throw new RangeError(`\u8BBE\u7F6E\u9879 ${key} \u8D85\u51FA\u5141\u8BB8\u8303\u56F4`);
+    }
+    assign(key, value);
+  }
+  if (source.primaryColor !== void 0) {
+    if (typeof source.primaryColor !== "string" || !/^#[0-9a-fA-F]{6}$/.test(source.primaryColor)) {
+      throw new RangeError("primaryColor \u5FC5\u987B\u662F #rrggbb \u683C\u5F0F");
+    }
+    result.primaryColor = source.primaryColor;
+  }
+  if (source.version !== void 0) {
+    if (typeof source.version !== "string" || source.version.length > 50) {
+      throw new TypeError("version \u5FC5\u987B\u662F\u957F\u5EA6\u4E0D\u8D85\u8FC7 50 \u7684\u5B57\u7B26\u4E32");
+    }
+    result.version = source.version;
+  }
+  return result;
+}
+function sanitizeLayoutSettingsConfig(input) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
+    throw new TypeError("\u914D\u7F6E\u6587\u4EF6\u6839\u8282\u70B9\u5FC5\u987B\u662F\u5BF9\u8C61");
+  }
+  const source = input;
+  const result = {};
+  if (source.schemaVersion !== void 0) {
+    if (typeof source.schemaVersion !== "number" || !Number.isInteger(source.schemaVersion) || source.schemaVersion < 1 || source.schemaVersion > SETTINGS_CONFIG_SCHEMA_VERSION) {
+      throw new RangeError("\u4E0D\u652F\u6301\u7684\u914D\u7F6E\u683C\u5F0F\u7248\u672C");
+    }
+    result.schemaVersion = source.schemaVersion;
+  }
+  if (source.settings !== void 0) {
+    result.settings = sanitizeSettingsPatch(source.settings);
+  }
+  for (const key of ["gray", "colorWeak"]) {
+    const value = source[key];
+    if (value === void 0) continue;
+    if (typeof value !== "boolean") {
+      throw new TypeError(`${key} \u5FC5\u987B\u662F\u5E03\u5C14\u503C`);
+    }
+    result[key] = value;
+  }
+  if (source.watermark !== void 0) {
+    if (!source.watermark || typeof source.watermark !== "object" || Array.isArray(source.watermark)) {
+      throw new TypeError("watermark \u5FC5\u987B\u662F\u5BF9\u8C61");
+    }
+    const watermark = source.watermark;
+    if (typeof watermark.enabled !== "boolean" || typeof watermark.text !== "string" || watermark.text.length > 200) {
+      throw new TypeError("watermark \u914D\u7F6E\u65E0\u6548");
+    }
+    result.watermark = {
+      enabled: watermark.enabled,
+      text: watermark.text
+    };
+  }
+  return result;
+}
+function adjustColor(color, amount) {
+  if (typeof color !== "string") return "#000000";
+  if (!Number.isFinite(amount)) return color;
+  const normalizedAmount = Math.round(amount);
+  const trimmedColor = color.trim();
+  let hex = trimmedColor.startsWith("#") ? trimmedColor.slice(1) : trimmedColor;
+  if (hex.length === 3) {
+    hex = hex.split("").map((character) => character + character).join("");
+  }
+  if (!/^[0-9a-fA-F]{6}$/.test(hex)) return color;
+  const value = parseInt(hex, 16);
+  const red = Math.min(255, Math.max(0, (value >> 16) + normalizedAmount));
+  const green = Math.min(
+    255,
+    Math.max(0, (value >> 8 & 255) + normalizedAmount)
+  );
+  const blue = Math.min(
+    255,
+    Math.max(0, (value & 255) + normalizedAmount)
+  );
+  return `#${(red << 16 | green << 8 | blue).toString(16).padStart(6, "0")}`;
+}
+
+// src/constants/index.ts
+var PRESET_COLORS = [
+  { name: "\u62C2\u6653\u84DD", value: "#409eff" },
+  { name: "\u8584\u66AE\u7EA2", value: "#f5222d" },
+  { name: "\u706B\u5C71\u6A59", value: "#fa541c" },
+  { name: "\u65E5\u66AE\u9EC4", value: "#faad14" },
+  { name: "\u6781\u5149\u7EFF", value: "#52c41a" },
+  { name: "\u660E\u9752", value: "#13c2c2" },
+  { name: "\u6781\u5BA2\u84DD", value: "#2f54eb" },
+  { name: "\u9171\u7D2B", value: "#722ed1" }
+];
+var THEME_PRESETS = [
+  {
+    name: "\u79D1\u6280\u84DD",
+    icon: "\u{1F499}",
+    primaryColor: "#409eff"
+  },
+  {
+    name: "\u6E05\u65B0\u7EFF",
+    icon: "\u{1F49A}",
+    primaryColor: "#52c41a"
+  },
+  {
+    name: "\u5546\u52A1\u7070",
+    icon: "\u{1F5A4}",
+    primaryColor: "#595959"
+  },
+  {
+    name: "\u6D3B\u529B\u6A59",
+    icon: "\u{1F9E1}",
+    primaryColor: "#fa8c16"
+  },
+  {
+    name: "\u4F18\u96C5\u7D2B",
+    icon: "\u{1F49C}",
+    primaryColor: "#722ed1"
+  },
+  {
+    name: "\u7ECF\u5178\u7EA2",
+    icon: "\u2764\uFE0F",
+    primaryColor: "#f5222d"
+  }
+];
+var LAYOUT_MODES = [
+  {
+    mode: "side",
+    label: "\u5DE6\u4FA7\u83DC\u5355",
+    description: "\u7ECF\u5178\u7684\u5DE6\u4FA7\u5BFC\u822A\u5E03\u5C40",
+    icon: "i-mdi:page-layout-sidebar-left"
+  },
+  {
+    mode: "top",
+    label: "\u9876\u90E8\u83DC\u5355",
+    description: "\u9876\u90E8\u6C34\u5E73\u5BFC\u822A\u5E03\u5C40",
+    icon: "i-mdi:page-layout-header"
+  },
+  {
+    mode: "mix",
+    label: "\u6DF7\u5408\u83DC\u5355",
+    description: "\u9876\u90E8 + \u4FA7\u8FB9\u6DF7\u5408\u5E03\u5C40",
+    icon: "i-mdi:view-dashboard-outline"
+  },
+  {
+    mode: "mix-top",
+    label: "\u9876\u90E8\u6DF7\u5408",
+    description: "\u4FA7\u8FB9\u4F18\u5148\u7684\u6DF7\u5408\u5E03\u5C40",
+    icon: "i-mdi:view-dashboard-variant-outline"
+  },
+  {
+    mode: "reverse-horizontal-mix",
+    label: "\u53CD\u8F6C\u6DF7\u5408",
+    description: "\u53CD\u8F6C\u7684\u6C34\u5E73\u6DF7\u5408\u5E03\u5C40",
+    icon: "i-mdi:page-layout-header-footer"
+  },
+  {
+    mode: "card-layout",
+    label: "\u5361\u7247\u5E03\u5C40",
+    description: "\u5361\u7247\u5F0F\u5E03\u5C40\u98CE\u683C",
+    icon: "i-mdi:card-outline"
+  }
+];
+var BORDER_RADIUS_MAP = {
+  small: "4px",
+  medium: "6px",
+  large: "8px"
+};
+var TRANSITION_MAP = {
+  fade: "fade-transform",
+  slide: "fade-slide",
+  zoom: "fade-zoom",
+  none: ""
+};
+var DEFAULT_SETTINGS = {
+  // 外观
+  themeMode: "light",
+  primaryColor: "#409eff",
+  borderRadius: "medium",
+  transitionType: "slide",
+  enableTransition: true,
+  // 布局
+  layoutMode: "side",
+  menuExpandMode: "inline",
+  collapsed: false,
+  fixedHeader: true,
+  showBreadcrumb: true,
+  showBreadcrumbIcon: true,
+  showTagsView: true,
+  tagsViewHeight: 44,
+  tagsViewStyle: "default",
+  showFooter: true,
+  sidebarWidth: 220,
+  sidebarCollapsedWidth: 64,
+  headerHeight: 56,
+  // 高级
+  enableHotkeys: true,
+  version: "3.1.0"
+};
+var COLOR_SWATCHES = PRESET_COLORS.map((c) => c.value);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BORDER_RADIUS_MAP,
+  COLOR_SWATCHES,
+  DEFAULT_SETTINGS,
+  LAYOUT_MODES,
+  PRESET_COLORS,
+  SETTINGS_CONFIG_SCHEMA_VERSION,
+  THEME_PRESETS,
+  TRANSITION_MAP,
+  adjustColor,
+  sanitizeLayoutSettingsConfig,
+  sanitizeSettingsPatch
+});
+//# sourceMappingURL=index.cjs.map

package/dist/core/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/index.ts","../../src/core/settings.ts","../../src/constants/index.ts"],"sourcesContent":["export {\n  adjustColor,\n  sanitizeLayoutSettingsConfig,\n  sanitizeSettingsPatch,\n  SETTINGS_CONFIG_SCHEMA_VERSION,\n} from \"./settings\";\nexport type { LayoutSettingsConfig, LayoutVisualEffects } from \"./settings\";\n\nexport {\n  BORDER_RADIUS_MAP,\n  COLOR_SWATCHES,\n  DEFAULT_SETTINGS,\n  LAYOUT_MODES,\n  PRESET_COLORS,\n  THEME_PRESETS,\n  TRANSITION_MAP,\n} from \"../constants\";\n\nexport type {\n  BorderRadiusSize,\n  LayoutInfo,\n  LayoutMode,\n  MenuExpandMode,\n  PresetColor,\n  SettingsDrawerActions,\n  SettingsState,\n  SettingsStoreOptions,\n  TagsViewStyle,\n  ThemeMode,\n  ThemePreset,\n  TransitionType,\n} from \"./types\";\n","import type { SettingsState } from \"./types\";\n\nconst ENUM_SETTINGS = {\n  themeMode: new Set([\"light\", \"dark\", \"system\"]),\n  borderRadius: new Set([\"small\", \"medium\", \"large\"]),\n  transitionType: new Set([\"fade\", \"slide\", \"zoom\", \"none\"]),\n  layoutMode: new Set([\n    \"side\",\n    \"top\",\n    \"mix\",\n    \"mix-top\",\n    \"reverse-horizontal-mix\",\n    \"card-layout\",\n  ]),\n  menuExpandMode: new Set([\"inline\", \"panel\"]),\n  tagsViewStyle: new Set([\"default\", \"card\", \"smart\"]),\n} as const;\n\nconst BOOLEAN_SETTINGS: ReadonlySet<keyof SettingsState> = new Set([\n  \"enableTransition\",\n  \"collapsed\",\n  \"fixedHeader\",\n  \"showBreadcrumb\",\n  \"showBreadcrumbIcon\",\n  \"showTagsView\",\n  \"showFooter\",\n  \"enableHotkeys\",\n]);\n\nconst NUMBER_RANGES: Partial<\n  Record<keyof SettingsState, readonly [number, number]>\n> = {\n  tagsViewHeight: [24, 100],\n  sidebarWidth: [120, 480],\n  sidebarCollapsedWidth: [32, 160],\n  headerHeight: [32, 160],\n};\n\n/** 当前导入导出配置格式版本。 */\nexport const SETTINGS_CONFIG_SCHEMA_VERSION = 1 as const;\n\nexport interface LayoutVisualEffects {\n  gray?: boolean;\n  colorWeak?: boolean;\n  watermark?: {\n    enabled: boolean;\n    text: string;\n  };\n}\n\n/** 经校验后可原子应用的布局配置。 */\nexport interface LayoutSettingsConfig extends LayoutVisualEffects {\n  schemaVersion?: number;\n  settings?: Partial<SettingsState>;\n}\n\n/**\n * 校验来自配置文件等不可信来源的设置。\n * 未知键为向前兼容而忽略；已知键的非法值会让整次导入失败。\n */\nexport function sanitizeSettingsPatch(input: unknown): Partial<SettingsState> {\n  if (!input || typeof input !== \"object\" || Array.isArray(input)) {\n    throw new TypeError(\"settings 必须是对象\");\n  }\n\n  const source = input as Record<string, unknown>;\n  const result: Partial<SettingsState> = {};\n  const assign = (key: keyof SettingsState, value: unknown) => {\n    (result as Record<string, unknown>)[key] = value;\n  };\n\n  for (const [key, allowed] of Object.entries(ENUM_SETTINGS)) {\n    const value = source[key];\n    if (value === undefined) continue;\n    if (typeof value !== \"string\" || !allowed.has(value as never)) {\n      throw new RangeError(`无效的设置项 ${key}: ${String(value)}`);\n    }\n    assign(key as keyof SettingsState, value);\n  }\n\n  for (const key of BOOLEAN_SETTINGS) {\n    const value = source[key];\n    if (value === undefined) continue;\n    if (typeof value !== \"boolean\") {\n      throw new TypeError(`设置项 ${key} 必须是布尔值`);\n    }\n    assign(key, value);\n  }\n\n  for (const [key, range] of Object.entries(NUMBER_RANGES)) {\n    const value = source[key];\n    if (value === undefined) continue;\n    if (\n      typeof value !== \"number\" ||\n      !Number.isFinite(value) ||\n      value < range[0] ||\n      value > range[1]\n    ) {\n      throw new RangeError(`设置项 ${key} 超出允许范围`);\n    }\n    assign(key as keyof SettingsState, value);\n  }\n\n  if (source.primaryColor !== undefined) {\n    if (\n      typeof source.primaryColor !== \"string\" ||\n      !/^#[0-9a-fA-F]{6}$/.test(source.primaryColor)\n    ) {\n      throw new RangeError(\"primaryColor 必须是 #rrggbb 格式\");\n    }\n    result.primaryColor = source.primaryColor;\n  }\n\n  if (source.version !== undefined) {\n    if (typeof source.version !== \"string\" || source.version.length > 50) {\n      throw new TypeError(\"version 必须是长度不超过 50 的字符串\");\n    }\n    result.version = source.version;\n  }\n\n  return result;\n}\n\n/**\n * 一次性校验完整导入文件。此函数不修改任何响应式状态或浏览器 API，\n * 消费方可以在成功返回后再原子应用结果。\n */\nexport function sanitizeLayoutSettingsConfig(\n  input: unknown,\n): LayoutSettingsConfig {\n  if (!input || typeof input !== \"object\" || Array.isArray(input)) {\n    throw new TypeError(\"配置文件根节点必须是对象\");\n  }\n\n  const source = input as Record<string, unknown>;\n  const result: LayoutSettingsConfig = {};\n\n  if (source.schemaVersion !== undefined) {\n    if (\n      typeof source.schemaVersion !== \"number\" ||\n      !Number.isInteger(source.schemaVersion) ||\n      source.schemaVersion < 1 ||\n      source.schemaVersion > SETTINGS_CONFIG_SCHEMA_VERSION\n    ) {\n      throw new RangeError(\"不支持的配置格式版本\");\n    }\n    result.schemaVersion = source.schemaVersion;\n  }\n\n  if (source.settings !== undefined) {\n    result.settings = sanitizeSettingsPatch(source.settings);\n  }\n\n  for (const key of [\"gray\", \"colorWeak\"] as const) {\n    const value = source[key];\n    if (value === undefined) continue;\n    if (typeof value !== \"boolean\") {\n      throw new TypeError(`${key} 必须是布尔值`);\n    }\n    result[key] = value;\n  }\n\n  if (source.watermark !== undefined) {\n    if (\n      !source.watermark ||\n      typeof source.watermark !== \"object\" ||\n      Array.isArray(source.watermark)\n    ) {\n      throw new TypeError(\"watermark 必须是对象\");\n    }\n    const watermark = source.watermark as Record<string, unknown>;\n    if (\n      typeof watermark.enabled !== \"boolean\" ||\n      typeof watermark.text !== \"string\" ||\n      watermark.text.length > 200\n    ) {\n      throw new TypeError(\"watermark 配置无效\");\n    }\n    result.watermark = {\n      enabled: watermark.enabled,\n      text: watermark.text,\n    };\n  }\n\n  return result;\n}\n\n/**\n * 调整颜色亮度。\n * @returns 调整后的 #rrggbb；输入非法时原样返回。\n */\nexport function adjustColor(color: string, amount: number): string {\n  if (typeof color !== \"string\") return \"#000000\";\n  if (!Number.isFinite(amount)) return color;\n  const normalizedAmount = Math.round(amount);\n  const trimmedColor = color.trim();\n  let hex = trimmedColor.startsWith(\"#\") ? trimmedColor.slice(1) : trimmedColor;\n  if (hex.length === 3) {\n    hex = hex\n      .split(\"\")\n      .map((character) => character + character)\n      .join(\"\");\n  }\n  if (!/^[0-9a-fA-F]{6}$/.test(hex)) return color;\n\n  const value = parseInt(hex, 16);\n  const red = Math.min(255, Math.max(0, (value >> 16) + normalizedAmount));\n  const green = Math.min(\n    255,\n    Math.max(0, ((value >> 8) & 0x00ff) + normalizedAmount),\n  );\n  const blue = Math.min(\n    255,\n    Math.max(0, (value & 0x0000ff) + normalizedAmount),\n  );\n  return `#${((red << 16) | (green << 8) | blue).toString(16).padStart(6, \"0\")}`;\n}\n","/**\n * 布局和设置系统 - 常量定义\n */\n\nimport type {\n  ThemePreset,\n  SettingsState,\n  LayoutInfo,\n  PresetColor,\n} from \"../core/types\";\n\n// ============ 主题色预设 ============\nexport const PRESET_COLORS: PresetColor[] = [\n  { name: \"拂晓蓝\", value: \"#409eff\" },\n  { name: \"薄暮红\", value: \"#f5222d\" },\n  { name: \"火山橙\", value: \"#fa541c\" },\n  { name: \"日暮黄\", value: \"#faad14\" },\n  { name: \"极光绿\", value: \"#52c41a\" },\n  { name: \"明青\", value: \"#13c2c2\" },\n  { name: \"极客蓝\", value: \"#2f54eb\" },\n  { name: \"酱紫\", value: \"#722ed1\" },\n] as const;\n\n// ============ 主题预设方案 ============\nexport const THEME_PRESETS: ThemePreset[] = [\n  {\n    name: \"科技蓝\",\n    icon: \"💙\",\n    primaryColor: \"#409eff\",\n  },\n  {\n    name: \"清新绿\",\n    icon: \"💚\",\n    primaryColor: \"#52c41a\",\n  },\n  {\n    name: \"商务灰\",\n    icon: \"🖤\",\n    primaryColor: \"#595959\",\n  },\n  {\n    name: \"活力橙\",\n    icon: \"🧡\",\n    primaryColor: \"#fa8c16\",\n  },\n  {\n    name: \"优雅紫\",\n    icon: \"💜\",\n    primaryColor: \"#722ed1\",\n  },\n  {\n    name: \"经典红\",\n    icon: \"❤️\",\n    primaryColor: \"#f5222d\",\n  },\n];\n\n// ============ 布局模式信息 ============\nexport const LAYOUT_MODES: LayoutInfo[] = [\n  {\n    mode: \"side\",\n    label: \"左侧菜单\",\n    description: \"经典的左侧导航布局\",\n    icon: \"i-mdi:page-layout-sidebar-left\",\n  },\n  {\n    mode: \"top\",\n    label: \"顶部菜单\",\n    description: \"顶部水平导航布局\",\n    icon: \"i-mdi:page-layout-header\",\n  },\n  {\n    mode: \"mix\",\n    label: \"混合菜单\",\n    description: \"顶部 + 侧边混合布局\",\n    icon: \"i-mdi:view-dashboard-outline\",\n  },\n  {\n    mode: \"mix-top\",\n    label: \"顶部混合\",\n    description: \"侧边优先的混合布局\",\n    icon: \"i-mdi:view-dashboard-variant-outline\",\n  },\n  {\n    mode: \"reverse-horizontal-mix\",\n    label: \"反转混合\",\n    description: \"反转的水平混合布局\",\n    icon: \"i-mdi:page-layout-header-footer\",\n  },\n  {\n    mode: \"card-layout\",\n    label: \"卡片布局\",\n    description: \"卡片式布局风格\",\n    icon: \"i-mdi:card-outline\",\n  },\n];\n\n// ============ 圆角映射 ============\nexport const BORDER_RADIUS_MAP = {\n  small: \"4px\",\n  medium: \"6px\",\n  large: \"8px\",\n} as const;\n\n// ============ 动画映射 ============\nexport const TRANSITION_MAP = {\n  fade: \"fade-transform\",\n  slide: \"fade-slide\",\n  zoom: \"fade-zoom\",\n  none: \"\",\n} as const;\n\n// ============ 默认配置 ============\nexport const DEFAULT_SETTINGS: SettingsState = {\n  // 外观\n  themeMode: \"light\",\n  primaryColor: \"#409eff\",\n  borderRadius: \"medium\",\n  transitionType: \"slide\",\n  enableTransition: true,\n\n  // 布局\n  layoutMode: \"side\",\n  menuExpandMode: \"inline\",\n  collapsed: false,\n  fixedHeader: true,\n  showBreadcrumb: true,\n  showBreadcrumbIcon: true,\n  showTagsView: true,\n  tagsViewHeight: 44,\n  tagsViewStyle: \"default\",\n  showFooter: true,\n  sidebarWidth: 220,\n  sidebarCollapsedWidth: 64,\n  headerHeight: 56,\n\n  // 高级\n  enableHotkeys: true,\n  version: \"3.1.0\",\n};\n\n// ============ 其他常量 ============\n\n/** Color swatches for color picker */\nexport const COLOR_SWATCHES = PRESET_COLORS.map((c) => c.value);\n"],"mappings":"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","names":[]}

package/dist/core/index.d.cts

@@ -0,0 +1,121 @@
+/** 与具体主题实现无关的标准主题模式。 */
+type ThemeMode = "light" | "dark" | "system";
+/** 内置布局模式。 */
+type LayoutMode = "side" | "top" | "mix" | "mix-top" | "reverse-horizontal-mix" | "card-layout";
+/** 菜单展开方式。 */
+type MenuExpandMode = "inline" | "panel";
+/** 页面动画类型。 */
+type TransitionType = "fade" | "slide" | "zoom" | "none";
+/** 圆角大小。 */
+type BorderRadiusSize = "small" | "medium" | "large";
+/** 标签页风格。 */
+type TagsViewStyle = "default" | "card" | "smart";
+/** UI 无关的布局设置协议。 */
+interface SettingsState {
+    themeMode: ThemeMode;
+    primaryColor: string;
+    borderRadius: BorderRadiusSize;
+    transitionType: TransitionType;
+    enableTransition: boolean;
+    layoutMode: LayoutMode;
+    menuExpandMode: MenuExpandMode;
+    collapsed: boolean;
+    fixedHeader: boolean;
+    showBreadcrumb: boolean;
+    showBreadcrumbIcon: boolean;
+    showTagsView: boolean;
+    tagsViewHeight: number;
+    tagsViewStyle: TagsViewStyle;
+    showFooter: boolean;
+    sidebarWidth: number;
+    sidebarCollapsedWidth: number;
+    headerHeight: number;
+    enableHotkeys: boolean;
+    version: string;
+}
+/** 主题预设方案。 */
+interface ThemePreset {
+    name: string;
+    description?: string;
+    icon: string;
+    primaryColor: string;
+    settings?: Partial<Omit<SettingsState, "themeMode" | "layoutMode" | "primaryColor">>;
+}
+/** Settings Store 初始化选项。 */
+interface SettingsStoreOptions {
+    id?: string;
+    defaults?: Partial<SettingsState>;
+    onThemeModeChange?: (mode: ThemeMode) => void | Promise<void>;
+}
+/** 由宿主应用实现的高副作用操作。 */
+interface SettingsDrawerActions {
+    clearCache?: () => void | Promise<void>;
+    reloadPage?: () => void;
+}
+/** 布局模式展示信息。 */
+interface LayoutInfo {
+    mode: LayoutMode;
+    label: string;
+    description: string;
+    icon: string;
+}
+/** 预设颜色。 */
+interface PresetColor {
+    name: string;
+    value: string;
+}
+
+/** 当前导入导出配置格式版本。 */
+declare const SETTINGS_CONFIG_SCHEMA_VERSION: 1;
+interface LayoutVisualEffects {
+    gray?: boolean;
+    colorWeak?: boolean;
+    watermark?: {
+        enabled: boolean;
+        text: string;
+    };
+}
+/** 经校验后可原子应用的布局配置。 */
+interface LayoutSettingsConfig extends LayoutVisualEffects {
+    schemaVersion?: number;
+    settings?: Partial<SettingsState>;
+}
+/**
+ * 校验来自配置文件等不可信来源的设置。
+ * 未知键为向前兼容而忽略；已知键的非法值会让整次导入失败。
+ */
+declare function sanitizeSettingsPatch(input: unknown): Partial<SettingsState>;
+/**
+ * 一次性校验完整导入文件。此函数不修改任何响应式状态或浏览器 API，
+ * 消费方可以在成功返回后再原子应用结果。
+ */
+declare function sanitizeLayoutSettingsConfig(input: unknown): LayoutSettingsConfig;
+/**
+ * 调整颜色亮度。
+ * @returns 调整后的 #rrggbb；输入非法时原样返回。
+ */
+declare function adjustColor(color: string, amount: number): string;
+
+/**
+ * 布局和设置系统 - 常量定义
+ */
+
+declare const PRESET_COLORS: PresetColor[];
+declare const THEME_PRESETS: ThemePreset[];
+declare const LAYOUT_MODES: LayoutInfo[];
+declare const BORDER_RADIUS_MAP: {
+    readonly small: "4px";
+    readonly medium: "6px";
+    readonly large: "8px";
+};
+declare const TRANSITION_MAP: {
+    readonly fade: "fade-transform";
+    readonly slide: "fade-slide";
+    readonly zoom: "fade-zoom";
+    readonly none: "";
+};
+declare const DEFAULT_SETTINGS: SettingsState;
+/** Color swatches for color picker */
+declare const COLOR_SWATCHES: string[];
+
+export { BORDER_RADIUS_MAP, type BorderRadiusSize, COLOR_SWATCHES, DEFAULT_SETTINGS, LAYOUT_MODES, type LayoutInfo, type LayoutMode, type LayoutSettingsConfig, type LayoutVisualEffects, type MenuExpandMode, PRESET_COLORS, type PresetColor, SETTINGS_CONFIG_SCHEMA_VERSION, type SettingsDrawerActions, type SettingsState, type SettingsStoreOptions, THEME_PRESETS, TRANSITION_MAP, type TagsViewStyle, type ThemeMode, type ThemePreset, type TransitionType, adjustColor, sanitizeLayoutSettingsConfig, sanitizeSettingsPatch };

package/dist/core/index.d.ts

@@ -0,0 +1,121 @@
+/** 与具体主题实现无关的标准主题模式。 */
+type ThemeMode = "light" | "dark" | "system";
+/** 内置布局模式。 */
+type LayoutMode = "side" | "top" | "mix" | "mix-top" | "reverse-horizontal-mix" | "card-layout";
+/** 菜单展开方式。 */
+type MenuExpandMode = "inline" | "panel";
+/** 页面动画类型。 */
+type TransitionType = "fade" | "slide" | "zoom" | "none";
+/** 圆角大小。 */
+type BorderRadiusSize = "small" | "medium" | "large";
+/** 标签页风格。 */
+type TagsViewStyle = "default" | "card" | "smart";
+/** UI 无关的布局设置协议。 */
+interface SettingsState {
+    themeMode: ThemeMode;
+    primaryColor: string;
+    borderRadius: BorderRadiusSize;
+    transitionType: TransitionType;
+    enableTransition: boolean;
+    layoutMode: LayoutMode;
+    menuExpandMode: MenuExpandMode;
+    collapsed: boolean;
+    fixedHeader: boolean;
+    showBreadcrumb: boolean;
+    showBreadcrumbIcon: boolean;
+    showTagsView: boolean;
+    tagsViewHeight: number;
+    tagsViewStyle: TagsViewStyle;
+    showFooter: boolean;
+    sidebarWidth: number;
+    sidebarCollapsedWidth: number;
+    headerHeight: number;
+    enableHotkeys: boolean;
+    version: string;
+}
+/** 主题预设方案。 */
+interface ThemePreset {
+    name: string;
+    description?: string;
+    icon: string;
+    primaryColor: string;
+    settings?: Partial<Omit<SettingsState, "themeMode" | "layoutMode" | "primaryColor">>;
+}
+/** Settings Store 初始化选项。 */
+interface SettingsStoreOptions {
+    id?: string;
+    defaults?: Partial<SettingsState>;
+    onThemeModeChange?: (mode: ThemeMode) => void | Promise<void>;
+}
+/** 由宿主应用实现的高副作用操作。 */
+interface SettingsDrawerActions {
+    clearCache?: () => void | Promise<void>;
+    reloadPage?: () => void;
+}
+/** 布局模式展示信息。 */
+interface LayoutInfo {
+    mode: LayoutMode;
+    label: string;
+    description: string;
+    icon: string;
+}
+/** 预设颜色。 */
+interface PresetColor {
+    name: string;
+    value: string;
+}
+
+/** 当前导入导出配置格式版本。 */
+declare const SETTINGS_CONFIG_SCHEMA_VERSION: 1;
+interface LayoutVisualEffects {
+    gray?: boolean;
+    colorWeak?: boolean;
+    watermark?: {
+        enabled: boolean;
+        text: string;
+    };
+}
+/** 经校验后可原子应用的布局配置。 */
+interface LayoutSettingsConfig extends LayoutVisualEffects {
+    schemaVersion?: number;
+    settings?: Partial<SettingsState>;
+}
+/**
+ * 校验来自配置文件等不可信来源的设置。
+ * 未知键为向前兼容而忽略；已知键的非法值会让整次导入失败。
+ */
+declare function sanitizeSettingsPatch(input: unknown): Partial<SettingsState>;
+/**
+ * 一次性校验完整导入文件。此函数不修改任何响应式状态或浏览器 API，
+ * 消费方可以在成功返回后再原子应用结果。
+ */
+declare function sanitizeLayoutSettingsConfig(input: unknown): LayoutSettingsConfig;
+/**
+ * 调整颜色亮度。
+ * @returns 调整后的 #rrggbb；输入非法时原样返回。
+ */
+declare function adjustColor(color: string, amount: number): string;
+
+/**
+ * 布局和设置系统 - 常量定义
+ */
+
+declare const PRESET_COLORS: PresetColor[];
+declare const THEME_PRESETS: ThemePreset[];
+declare const LAYOUT_MODES: LayoutInfo[];
+declare const BORDER_RADIUS_MAP: {
+    readonly small: "4px";
+    readonly medium: "6px";
+    readonly large: "8px";
+};
+declare const TRANSITION_MAP: {
+    readonly fade: "fade-transform";
+    readonly slide: "fade-slide";
+    readonly zoom: "fade-zoom";
+    readonly none: "";
+};
+declare const DEFAULT_SETTINGS: SettingsState;
+/** Color swatches for color picker */
+declare const COLOR_SWATCHES: string[];
+
+export { BORDER_RADIUS_MAP, type BorderRadiusSize, COLOR_SWATCHES, DEFAULT_SETTINGS, LAYOUT_MODES, type LayoutInfo, type LayoutMode, type LayoutSettingsConfig, type LayoutVisualEffects, type MenuExpandMode, PRESET_COLORS, type PresetColor, SETTINGS_CONFIG_SCHEMA_VERSION, type SettingsDrawerActions, type SettingsState, type SettingsStoreOptions, THEME_PRESETS, TRANSITION_MAP, type TagsViewStyle, type ThemeMode, type ThemePreset, type TransitionType, adjustColor, sanitizeLayoutSettingsConfig, sanitizeSettingsPatch };