@orbit-work/ui 0.1.2-preview.0 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbit-work/ui",
-  "version": "0.1.2-preview.0",
+  "version": "0.1.3",
   "description": "Orbitwork Design System — React components with light/dark theme support.",
   "type": "module",
   "publishConfig": {
@@ -12,52 +12,103 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./browser-annotation-popup": {
-      "types": "./dist/browser-annotation-popup.d.ts",
-      "import": "./dist/browser-annotation-popup.js",
-      "require": "./dist/browser-annotation-popup.cjs"
+      "import": {
+        "types": "./dist/browser-annotation-popup.d.ts",
+        "default": "./dist/browser-annotation-popup.js"
+      },
+      "require": {
+        "types": "./dist/browser-annotation-popup.d.cts",
+        "default": "./dist/browser-annotation-popup.cjs"
+      }
     },
     "./appearance": {
-      "types": "./dist/appearance.d.ts",
-      "import": "./dist/appearance.js",
-      "require": "./dist/appearance.cjs"
+      "import": {
+        "types": "./dist/appearance.d.ts",
+        "default": "./dist/appearance.js"
+      },
+      "require": {
+        "types": "./dist/appearance.d.cts",
+        "default": "./dist/appearance.cjs"
+      }
+    },
+    "./brand-preview": {
+      "import": {
+        "types": "./dist/brand-preview.d.ts",
+        "default": "./dist/brand-preview.js"
+      },
+      "require": {
+        "types": "./dist/brand-preview.d.cts",
+        "default": "./dist/brand-preview.cjs"
+      }
     },
     "./about-window": {
-      "types": "./dist/about-window.d.ts",
-      "import": "./dist/about-window.js",
-      "require": "./dist/about-window.cjs"
+      "import": {
+        "types": "./dist/about-window.d.ts",
+        "default": "./dist/about-window.js"
+      },
+      "require": {
+        "types": "./dist/about-window.d.cts",
+        "default": "./dist/about-window.cjs"
+      }
+    },
+    "./slot/core": {
+      "import": {
+        "types": "./dist/slot-core.d.ts",
+        "default": "./dist/slot-core.js"
+      },
+      "require": {
+        "types": "./dist/slot-core.d.cts",
+        "default": "./dist/slot-core.cjs"
+      }
+    },
+    "./slot/react": {
+      "import": {
+        "types": "./dist/slot-react.d.ts",
+        "default": "./dist/slot-react.js"
+      },
+      "require": {
+        "types": "./dist/slot-react.d.cts",
+        "default": "./dist/slot-react.cjs"
+      }
     },
-    "./styles/orbitwork.css": "./dist/orbitwork.css"
+    "./styles/core.css": "./dist/core.css",
+    "./styles/core.scoped.css": "./dist/core.scoped.css",
+    "./styles/workbench.css": "./dist/workbench.css",
+    "./styles/file-tree.css": "./dist/file-tree.css",
+    "./styles/office.css": "./dist/office.css",
+    "./styles/tailwind.css": "./dist/tailwind.css",
+    "./locale": {
+      "import": {
+        "types": "./dist/locale.d.ts",
+        "default": "./dist/locale.js"
+      },
+      "require": {
+        "types": "./dist/locale.d.cts",
+        "default": "./dist/locale.cjs"
+      }
+    }
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
+  ],
+  "sideEffects": [
+    "./dist/core.css",
+    "./dist/core.scoped.css",
+    "./dist/workbench.css",
+    "./dist/file-tree.css",
+    "./dist/office.css",
+    "./dist/tailwind.css"
   ],
-  "scripts": {
-    "build": "node scripts/build.mjs",
-    "dev": "tsup --watch",
-    "lint": "biome lint src/",
-    "lint:fix": "biome lint --write src/",
-    "format": "biome format --write src/",
-    "check": "biome check src/",
-    "test": "node --test \"src/**/*.test.mjs\" \"scripts/*.test.mjs\"",
-    "typecheck": "tsc --noEmit",
-    "storybook": "npm run generate:tokens && storybook dev -p 6006",
-    "build-storybook": "npm run generate:tokens && storybook build",
-    "test-storybook": "test-storybook --url http://127.0.0.1:6006",
-    "chromatic": "chromatic --exit-zero-on-changes",
-    "new-component": "node scripts/new-component.mjs",
-    "check:stories": "node scripts/check-stories.mjs",
-    "check:stories:all": "node scripts/check-stories.mjs --all",
-    "check:ds2": "node scripts/check-ds2.mjs",
-    "check:utilities": "node scripts/check-missing-utilities.mjs",
-    "generate:tokens": "node scripts/generate-tokens-css.mjs",
-    "test:ds2": "node --test \"scripts/*.test.mjs\""
-  },
   "dependencies": {
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -76,27 +127,25 @@
     "@storybook/addon-docs": "^10.5.10",
     "@storybook/addon-themes": "^10.5.10",
     "@storybook/addon-vitest": "^10.5.10",
-    "@storybook/instrumenter": "^8.6.14",
+    "@storybook/react": "^10.5.10",
     "@storybook/react-vite": "^10.5.10",
-    "@storybook/test": "^8.6.15",
-    "@storybook/test-runner": "^0.24.4",
     "@tailwindcss/postcss": "^4.3.3",
     "@tailwindcss/vite": "^4.3.3",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/user-event": "^14.6.6",
-    "@types/jest-image-snapshot": "^6.4.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
-    "@vitest/browser-playwright": "5.0.0",
+    "@vitest/browser-playwright": "4.1.11",
+    "@vitest/coverage-v8": "4.1.11",
     "aria-query": "^5.3.2",
     "chromatic": "^18.6.1",
     "esbuild": "^0.27.7",
-    "jest-image-snapshot": "^6.5.2",
     "lz-string": "^1.5.0",
     "playwright": "1.62.1",
     "postcss": "^8.5.26",
     "postcss-import": "^17.0.0",
+    "postcss-selector-parser": "^7.1.6",
     "pretty-format": "^30.5.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
@@ -104,16 +153,46 @@
     "tailwindcss": "^4.3.3",
     "tsup": "^8.0.0",
     "typescript": "^5.6.3",
-    "vitest": "5.0.0"
+    "vitest": "4.1.11"
   },
   "peerDependencies": {
     "echarts": ">=5.0.0",
-    "react": ">=18",
-    "react-dom": ">=18"
+    "react": ">=19",
+    "react-dom": ">=19"
   },
   "peerDependenciesMeta": {
     "echarts": {
       "optional": true
     }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "biome lint src/",
+    "lint:fix": "biome lint --write src/",
+    "format": "biome format --write src/",
+    "check": "biome check src/",
+    "test": "node --test \"src/**/*.test.mjs\" \"scripts/*.test.mjs\"",
+    "typecheck": "tsc --noEmit",
+    "storybook": "npm run generate:tokens && storybook dev -p 6006",
+    "build-storybook": "npm run generate:tokens && storybook build",
+    "chromatic": "chromatic --exit-zero-on-changes",
+    "new-component": "node scripts/new-component.mjs",
+    "check:stories": "node scripts/check-stories.mjs",
+    "check:stories:all": "node scripts/check-stories.mjs --all",
+    "check:ds2": "node scripts/check-ds2.mjs",
+    "check:i18n": "node scripts/check-i18n.mjs",
+    "check:a11y": "vitest run --project storybook",
+    "check:utilities": "node scripts/check-missing-utilities.mjs",
+    "check:css": "node scripts/check-css-contract.mjs",
+    "check:scopes": "node scripts/check-scoped-css.mjs",
+    "generate:tokens": "node scripts/generate-tokens-css.mjs",
+    "test:ds2": "node --test \"scripts/*.test.mjs\"",
+    "verify:package": "node scripts/verify-package.mjs",
+    "verify:static": "pnpm check && pnpm test && pnpm typecheck && pnpm build && pnpm verify:package && pnpm check:scopes && pnpm check:stories && pnpm check:i18n && pnpm check:css && pnpm check:ds2 && pnpm check:utilities",
+    "verify": "pnpm verify:static && pnpm check:a11y"
   }
-}
+}

package/dist/appearance-D5uQ53j3.d.cts

@@ -1,210 +0,0 @@
-/**
- * Orbitwork skin protocol — aligned with Design project architecture.
- * A skin is a validated JSON document that overrides --ow-* CSS variables
- * at runtime. This module is framework-agnostic.
- */
-type Theme = "light" | "dark" | "system";
-type ResolvedTheme = "light" | "dark";
-/**
- * DS2 皮肤白名单（COMPONENT-RULES §15 · 2026-08-31 裁决）：
- * - 可覆盖：中性表面/边框/文字梯度、chat/composer/sidebar 背景类、
- *   btn-primary 族（唯一开放的租户品牌色位）。
- * - 已移除（禁覆盖）：primary 族（--ow-primary 暗档=荧黄行动极）、link、
- *   switchActive（--ow-control-on 无彩选中）、功能色四族、cardRadius/buttonRadius
- *   （圆角是品牌定稿）。
- */
-type OrbitworkSkinTokens = {
-    backgroundPrimary?: string;
-    backgroundSecondary?: string;
-    backgroundTertiary?: string;
-    backgroundPanel?: string;
-    foregroundPrimary?: string;
-    foregroundSecondary?: string;
-    foregroundMuted?: string;
-    foregroundHint?: string;
-    borderSubtle?: string;
-    borderDefault?: string;
-    borderStrong?: string;
-    buttonPrimaryBackground?: string;
-    buttonPrimaryForeground?: string;
-    chatBackground?: string;
-    chatBackgroundImage?: string;
-    chatBackgroundOverlay?: string;
-    chatBackgroundMaskColor?: string;
-    chatBackgroundPosition?: "center" | "top" | "bottom" | "left" | "right" | "top left" | "top right" | "bottom left" | "bottom right";
-    chatBackgroundSize?: "cover" | "contain" | "auto";
-    userBubbleBackground?: string;
-    userBubbleForeground?: string;
-    userBubbleBorder?: string;
-    composerBackground?: string;
-    composerBorder?: string;
-    sidebarBackground?: string;
-    sidebarSelectedBackground?: string;
-};
-/** L2/L3 逃生通道登记项：每条高级样式须登记目标与用途（§15，长期目标清零）。 */
-type OrbitworkSkinRegistryEntry = {
-    target: string;
-    reason: string;
-};
-type OrbitworkSkin = {
-    version: 1;
-    id: string;
-    name: string;
-    description?: string;
-    /**
-     * @deprecated DS2 §15：圆角是品牌定稿，皮肤不再开放 cardRadius/buttonRadius。
-     * 字段仅为旧代码类型兼容保留（空对象），解析路径一律拒绝 common。
-     */
-    common?: Record<string, never>;
-    modes: {
-        light?: OrbitworkSkinTokens;
-        dark?: OrbitworkSkinTokens;
-    };
-    contributes?: {
-        /** L2: 语义选择器样式（精准定制组件部件） */
-        semanticStyles?: string;
-        /** L3: 自由补丁（高级用户，需谨慎使用） */
-        patches?: string;
-        /** L2/L3 登记表：存在 semanticStyles/patches 时必须逐条登记（validate-skin 强制） */
-        registry?: OrbitworkSkinRegistryEntry[];
-    };
-};
-type SkinValidationResult = {
-    ok: true;
-    skin: OrbitworkSkin;
-} | {
-    ok: false;
-    error: string;
-};
-declare const HEX_COLOR: RegExp;
-declare const MAX_ORBITWORK_SKIN_IMAGE_BYTES: number;
-type OrbitworkSkinChatBackgroundMask = {
-    color: string;
-    strength: number;
-    startOpacity: number;
-    endOpacity: number;
-};
-/** Six-digit colors retain the original 80% → 50% mask; explicit alpha controls final strength. */
-declare function resolveOrbitworkSkinChatBackgroundMask(value: string): OrbitworkSkinChatBackgroundMask;
-declare function orbitworkSkinChatBackgroundMaskColor(color: string, strength: number): string;
-declare const ORBITWORK_SKIN_CSS_VARIABLES: Readonly<Record<keyof OrbitworkSkinTokens, string>>;
-/**
- * DS2 皮肤禁覆盖清单（COMPONENT-RULES §15 · 2026-08-31 裁决）。
- * 条目以 `*` 结尾表示前缀匹配；其余为精确名（含其 `-` 后缀派生，如
- * `--ow-control-on` 同时覆盖 `--ow-control-on-glyph`）。
- *
- * ⚠️ 同步义务：.claude/skills/ui-theme-skin/scripts/check-skin-ds2.mjs 持有
- * 本清单的副本，两处必须同步修改。
- */
-declare const DS2_SKIN_DENYLIST: readonly ["--ow-beacon", "--ow-beacon-idle", "--ow-accent-dot", "--ow-data-today", "--ow-primary*", "--ow-control-on", "--ow-focus-ring", "--ow-info*", "--ow-success*", "--ow-warning*", "--ow-error*", "--ow-mention*", "--ow-paper", "--ow-stage-*", "--ow-term-*", "--ow-ansi-*", "--ow-radius-*"];
-/**
- * DS2 皮肤禁覆盖 **CSS 属性** 清单（COMPONENT-RULES §5/§7/§9 · W5 终扫补闸）。
- *
- * 背景：`DS2_SKIN_DENYLIST` 是 token 名维度的闸，只认 `--ow-*`。L2/L3 的
- * semanticStyles / patches 里裸写的 `box-shadow: 0 0 20px …`、`border-radius: 18px`、
- * `transform: translateY(-2px)`、`animation: neon-pulse 2s infinite` 完全绕开它——
- * 而这四类恰恰是 2.0 明令收口的三层：贴地零影（§5）、形状表定稿（§7）、
- * 唯一动效语汇＝信标（§9）。故对属性维度另立一闸：命中即整块剥除。
- *
- * 条目为属性名前缀（连字符边界）：`border-radius` 同时覆盖
- * `border-top-left-radius` 等长写；`transition` 覆盖 `transition-property` 等。
- *
- * ⚠️ 同步义务：.claude/skills/ui-theme-skin/scripts/check-skin-ds2.mjs 持有本清单副本。
- */
-declare const DS2_SKIN_DENIED_PROPERTIES: readonly ["border-radius", "border-top-left-radius", "border-top-right-radius", "border-bottom-left-radius", "border-bottom-right-radius", "box-shadow", "transform", "animation", "transition", "backdrop-filter", "-webkit-backdrop-filter"];
-/**
- * 判断某个 CSS 属性名是否命中属性维度禁覆盖清单。
- * 只按连字符边界做前缀匹配，避免 `animation` 误伤自定义属性 `--animation-x`
- * （自定义属性由 token 维度那一闸单独管）。
- */
-declare function isDs2SkinDeniedProperty(propertyName: string): boolean;
-/**
- * 在一段 CSS 文本里找出第一处命中属性维度禁覆盖清单的声明。
- * 只在「声明位置」匹配（块首/`;`/`{` 之后的标识符 + `:`），选择器与值里的同名词不算。
- */
-declare function findDs2DeniedCssProperty(css: string): string | null;
-/**
- * 值维度禁覆盖（DS2 判据 7「品牌外渐变一律清除」）。
- *
- * ⚠️ 同步义务：与 .claude|.agents/skills/ui-theme-skin/scripts/check-skin-ds2.mjs 的
- * DENIED_VALUE_PATTERNS 为同一清单的副本（见 SkinDenylistSyncSource.test.mjs）。
- *
- * 为什么不是往 DS2_SKIN_DENIED_PROPERTIES 里加 `background`：皮肤本来就该能改底色，
- * 按属性名封会把整类合法覆盖一起封掉。要拦的是**值的形态**——任何 *-gradient()。
- * R2 之前这一层完全没有：glass.ts 的 `body { background: linear-gradient(135deg,
- * rgba(59,130,246,.1), rgba(139,92,246,.1)) }`（V1 蓝紫）是整份皮肤里唯二穿过闸口的
- * 块之一；cyberpunk.ts 的 `userBubbleBackground: "linear-gradient(135deg,#E91E63,#9C27B0)"`
- * 更是走 mode token 直接落到用户气泡上——两条路都得拦。
- */
-declare const DS2_SKIN_DENIED_VALUE_PATTERNS: readonly ["-gradient("];
-/** 判断某个 CSS 值是否命中值维度禁覆盖（渐变）。 */
-declare function isDs2SkinDeniedValue(value: string): boolean;
-/**
- * 在一段 CSS 文本里找出第一处命中值维度禁覆盖的声明值。
- * 只看声明的**值**侧，选择器与注释里的同名词不算（调用方已剥注释）。
- */
-declare function findDs2DeniedCssValue(css: string): string | null;
-/** 锁定件 data-slot 选择器初始清单：L2/L3 内容命中即剥除（字符串匹配）。 */
-declare const DS2_LOCKED_SLOT_SELECTORS: readonly ["beacon-spinner", "orbitwork-mark", "orbitwork-lockup"];
-/** 判断某个 CSS 自定义属性名是否命中 DS2 禁覆盖清单。 */
-declare function isDs2SkinDeniedToken(tokenName: string): boolean;
-/** WCAG 2.x 相对亮度 → 对比度实算（输入为 3/4/6/8 位 hex；alpha 忽略，按不透明计算）。 */
-declare function ds2ContrastRatio(hexA: string, hexB: string): number;
-declare function hasOrbitworkSkinChatBackground(skin: OrbitworkSkin | null | undefined, mode: ResolvedTheme): boolean;
-declare function parseOrbitworkSkin(input: unknown): SkinValidationResult;
-/** Convert a validated embedded image into a CSS value without accepting arbitrary CSS or URLs. */
-declare function orbitworkSkinImageCssValue(value: string | undefined): string | undefined;
-declare function assertKnownKeys(value: Record<string, unknown>, allowed: Set<string>, path: string): void;
-declare function isRecord(value: unknown): value is Record<string, unknown>;
-
-declare const BUILTIN_ORBITWORK_SKINS: readonly [OrbitworkSkin, OrbitworkSkin, OrbitworkSkin];
-
-/**
- * Scoped skin application — inspired by design project
- *
- * 改进点：
- * 1. 从内联样式改为 <style> 标签注入
- * 2. 使用 html[data-ow-skin] 作用域选择器
- * 3. CSS 层面真正隔离，可通过选择器精准控制
- * 4. 支持 L2/L3 高级样式（语义选择器、自由补丁）
- *
- * 向后兼容：保持与原 applyOrbitworkSkin() 相同的签名和行为
- */
-
-/**
- * 作用域化皮肤应用
- *
- * @example
- * applyScopedOrbitworkSkin(document.documentElement, skin, 'light')
- * // 生成: html[data-ow-skin="aurora"] { --ow-primary: #7c3aed; ... }
- */
-declare function applyScopedOrbitworkSkin(target: HTMLElement, skin: OrbitworkSkin | null, mode: ResolvedTheme): void;
-/**
- * 获取当前激活的皮肤 ID
- */
-declare function getActiveSkinId(): string | null;
-/**
- * 检查是否有皮肤激活
- */
-declare function hasSkinActive(): boolean;
-
-/**
- * @deprecated Import from './theme' instead. This file re-exports for backward compatibility.
- *
- * 例外：`THEME_OPTIONS`（文件末）是本文件自有的值——设置面与账户菜单共用的主题三格。
- */
-
-/**
- * 主题三格（R2 · D4 / 裁决：设置常规段与账户菜单「外观」行共用同一份选项）。
- *
- * 原型的 themeRows 只有「浅色 / 深色」两档、另配一条「显示模式跟随系统」开关；
- * R2 按 Terry 的参考图把三件事收成一排三格——`system` 就是第三格「自动」，
- * 那条开关卡随之撤除。写在这里而不是各件各写一份：设置面（DesktopAppearanceSettings）
- * 与侧栏账户菜单（DesktopAccountMenuView）两处必须同词同序，分叉了就是两套语汇。
- */
-declare const THEME_OPTIONS: Array<{
-    value: Theme;
-    label: string;
-}>;
-
-export { BUILTIN_ORBITWORK_SKINS as B, DS2_LOCKED_SLOT_SELECTORS as D, HEX_COLOR as H, MAX_ORBITWORK_SKIN_IMAGE_BYTES as M, type OrbitworkSkin as O, type ResolvedTheme as R, type SkinValidationResult as S, type Theme as T, DS2_SKIN_DENIED_PROPERTIES as a, DS2_SKIN_DENIED_VALUE_PATTERNS as b, DS2_SKIN_DENYLIST as c, ORBITWORK_SKIN_CSS_VARIABLES as d, type OrbitworkSkinChatBackgroundMask as e, type OrbitworkSkinRegistryEntry as f, type OrbitworkSkinTokens as g, THEME_OPTIONS as h, applyScopedOrbitworkSkin as i, assertKnownKeys as j, ds2ContrastRatio as k, findDs2DeniedCssProperty as l, findDs2DeniedCssValue as m, getActiveSkinId as n, hasOrbitworkSkinChatBackground as o, hasSkinActive as p, isDs2SkinDeniedProperty as q, isDs2SkinDeniedToken as r, isDs2SkinDeniedValue as s, isRecord as t, orbitworkSkinChatBackgroundMaskColor as u, orbitworkSkinImageCssValue as v, parseOrbitworkSkin as w, resolveOrbitworkSkinChatBackgroundMask as x };

package/dist/appearance-D5uQ53j3.d.ts

@@ -1,210 +0,0 @@
-/**
- * Orbitwork skin protocol — aligned with Design project architecture.
- * A skin is a validated JSON document that overrides --ow-* CSS variables
- * at runtime. This module is framework-agnostic.
- */
-type Theme = "light" | "dark" | "system";
-type ResolvedTheme = "light" | "dark";
-/**
- * DS2 皮肤白名单（COMPONENT-RULES §15 · 2026-08-31 裁决）：
- * - 可覆盖：中性表面/边框/文字梯度、chat/composer/sidebar 背景类、
- *   btn-primary 族（唯一开放的租户品牌色位）。
- * - 已移除（禁覆盖）：primary 族（--ow-primary 暗档=荧黄行动极）、link、
- *   switchActive（--ow-control-on 无彩选中）、功能色四族、cardRadius/buttonRadius
- *   （圆角是品牌定稿）。
- */
-type OrbitworkSkinTokens = {
-    backgroundPrimary?: string;
-    backgroundSecondary?: string;
-    backgroundTertiary?: string;
-    backgroundPanel?: string;
-    foregroundPrimary?: string;
-    foregroundSecondary?: string;
-    foregroundMuted?: string;
-    foregroundHint?: string;
-    borderSubtle?: string;
-    borderDefault?: string;
-    borderStrong?: string;
-    buttonPrimaryBackground?: string;
-    buttonPrimaryForeground?: string;
-    chatBackground?: string;
-    chatBackgroundImage?: string;
-    chatBackgroundOverlay?: string;
-    chatBackgroundMaskColor?: string;
-    chatBackgroundPosition?: "center" | "top" | "bottom" | "left" | "right" | "top left" | "top right" | "bottom left" | "bottom right";
-    chatBackgroundSize?: "cover" | "contain" | "auto";
-    userBubbleBackground?: string;
-    userBubbleForeground?: string;
-    userBubbleBorder?: string;
-    composerBackground?: string;
-    composerBorder?: string;
-    sidebarBackground?: string;
-    sidebarSelectedBackground?: string;
-};
-/** L2/L3 逃生通道登记项：每条高级样式须登记目标与用途（§15，长期目标清零）。 */
-type OrbitworkSkinRegistryEntry = {
-    target: string;
-    reason: string;
-};
-type OrbitworkSkin = {
-    version: 1;
-    id: string;
-    name: string;
-    description?: string;
-    /**
-     * @deprecated DS2 §15：圆角是品牌定稿，皮肤不再开放 cardRadius/buttonRadius。
-     * 字段仅为旧代码类型兼容保留（空对象），解析路径一律拒绝 common。
-     */
-    common?: Record<string, never>;
-    modes: {
-        light?: OrbitworkSkinTokens;
-        dark?: OrbitworkSkinTokens;
-    };
-    contributes?: {
-        /** L2: 语义选择器样式（精准定制组件部件） */
-        semanticStyles?: string;
-        /** L3: 自由补丁（高级用户，需谨慎使用） */
-        patches?: string;
-        /** L2/L3 登记表：存在 semanticStyles/patches 时必须逐条登记（validate-skin 强制） */
-        registry?: OrbitworkSkinRegistryEntry[];
-    };
-};
-type SkinValidationResult = {
-    ok: true;
-    skin: OrbitworkSkin;
-} | {
-    ok: false;
-    error: string;
-};
-declare const HEX_COLOR: RegExp;
-declare const MAX_ORBITWORK_SKIN_IMAGE_BYTES: number;
-type OrbitworkSkinChatBackgroundMask = {
-    color: string;
-    strength: number;
-    startOpacity: number;
-    endOpacity: number;
-};
-/** Six-digit colors retain the original 80% → 50% mask; explicit alpha controls final strength. */
-declare function resolveOrbitworkSkinChatBackgroundMask(value: string): OrbitworkSkinChatBackgroundMask;
-declare function orbitworkSkinChatBackgroundMaskColor(color: string, strength: number): string;
-declare const ORBITWORK_SKIN_CSS_VARIABLES: Readonly<Record<keyof OrbitworkSkinTokens, string>>;
-/**
- * DS2 皮肤禁覆盖清单（COMPONENT-RULES §15 · 2026-08-31 裁决）。
- * 条目以 `*` 结尾表示前缀匹配；其余为精确名（含其 `-` 后缀派生，如
- * `--ow-control-on` 同时覆盖 `--ow-control-on-glyph`）。
- *
- * ⚠️ 同步义务：.claude/skills/ui-theme-skin/scripts/check-skin-ds2.mjs 持有
- * 本清单的副本，两处必须同步修改。
- */
-declare const DS2_SKIN_DENYLIST: readonly ["--ow-beacon", "--ow-beacon-idle", "--ow-accent-dot", "--ow-data-today", "--ow-primary*", "--ow-control-on", "--ow-focus-ring", "--ow-info*", "--ow-success*", "--ow-warning*", "--ow-error*", "--ow-mention*", "--ow-paper", "--ow-stage-*", "--ow-term-*", "--ow-ansi-*", "--ow-radius-*"];
-/**
- * DS2 皮肤禁覆盖 **CSS 属性** 清单（COMPONENT-RULES §5/§7/§9 · W5 终扫补闸）。
- *
- * 背景：`DS2_SKIN_DENYLIST` 是 token 名维度的闸，只认 `--ow-*`。L2/L3 的
- * semanticStyles / patches 里裸写的 `box-shadow: 0 0 20px …`、`border-radius: 18px`、
- * `transform: translateY(-2px)`、`animation: neon-pulse 2s infinite` 完全绕开它——
- * 而这四类恰恰是 2.0 明令收口的三层：贴地零影（§5）、形状表定稿（§7）、
- * 唯一动效语汇＝信标（§9）。故对属性维度另立一闸：命中即整块剥除。
- *
- * 条目为属性名前缀（连字符边界）：`border-radius` 同时覆盖
- * `border-top-left-radius` 等长写；`transition` 覆盖 `transition-property` 等。
- *
- * ⚠️ 同步义务：.claude/skills/ui-theme-skin/scripts/check-skin-ds2.mjs 持有本清单副本。
- */
-declare const DS2_SKIN_DENIED_PROPERTIES: readonly ["border-radius", "border-top-left-radius", "border-top-right-radius", "border-bottom-left-radius", "border-bottom-right-radius", "box-shadow", "transform", "animation", "transition", "backdrop-filter", "-webkit-backdrop-filter"];
-/**
- * 判断某个 CSS 属性名是否命中属性维度禁覆盖清单。
- * 只按连字符边界做前缀匹配，避免 `animation` 误伤自定义属性 `--animation-x`
- * （自定义属性由 token 维度那一闸单独管）。
- */
-declare function isDs2SkinDeniedProperty(propertyName: string): boolean;
-/**
- * 在一段 CSS 文本里找出第一处命中属性维度禁覆盖清单的声明。
- * 只在「声明位置」匹配（块首/`;`/`{` 之后的标识符 + `:`），选择器与值里的同名词不算。
- */
-declare function findDs2DeniedCssProperty(css: string): string | null;
-/**
- * 值维度禁覆盖（DS2 判据 7「品牌外渐变一律清除」）。
- *
- * ⚠️ 同步义务：与 .claude|.agents/skills/ui-theme-skin/scripts/check-skin-ds2.mjs 的
- * DENIED_VALUE_PATTERNS 为同一清单的副本（见 SkinDenylistSyncSource.test.mjs）。
- *
- * 为什么不是往 DS2_SKIN_DENIED_PROPERTIES 里加 `background`：皮肤本来就该能改底色，
- * 按属性名封会把整类合法覆盖一起封掉。要拦的是**值的形态**——任何 *-gradient()。
- * R2 之前这一层完全没有：glass.ts 的 `body { background: linear-gradient(135deg,
- * rgba(59,130,246,.1), rgba(139,92,246,.1)) }`（V1 蓝紫）是整份皮肤里唯二穿过闸口的
- * 块之一；cyberpunk.ts 的 `userBubbleBackground: "linear-gradient(135deg,#E91E63,#9C27B0)"`
- * 更是走 mode token 直接落到用户气泡上——两条路都得拦。
- */
-declare const DS2_SKIN_DENIED_VALUE_PATTERNS: readonly ["-gradient("];
-/** 判断某个 CSS 值是否命中值维度禁覆盖（渐变）。 */
-declare function isDs2SkinDeniedValue(value: string): boolean;
-/**
- * 在一段 CSS 文本里找出第一处命中值维度禁覆盖的声明值。
- * 只看声明的**值**侧，选择器与注释里的同名词不算（调用方已剥注释）。
- */
-declare function findDs2DeniedCssValue(css: string): string | null;
-/** 锁定件 data-slot 选择器初始清单：L2/L3 内容命中即剥除（字符串匹配）。 */
-declare const DS2_LOCKED_SLOT_SELECTORS: readonly ["beacon-spinner", "orbitwork-mark", "orbitwork-lockup"];
-/** 判断某个 CSS 自定义属性名是否命中 DS2 禁覆盖清单。 */
-declare function isDs2SkinDeniedToken(tokenName: string): boolean;
-/** WCAG 2.x 相对亮度 → 对比度实算（输入为 3/4/6/8 位 hex；alpha 忽略，按不透明计算）。 */
-declare function ds2ContrastRatio(hexA: string, hexB: string): number;
-declare function hasOrbitworkSkinChatBackground(skin: OrbitworkSkin | null | undefined, mode: ResolvedTheme): boolean;
-declare function parseOrbitworkSkin(input: unknown): SkinValidationResult;
-/** Convert a validated embedded image into a CSS value without accepting arbitrary CSS or URLs. */
-declare function orbitworkSkinImageCssValue(value: string | undefined): string | undefined;
-declare function assertKnownKeys(value: Record<string, unknown>, allowed: Set<string>, path: string): void;
-declare function isRecord(value: unknown): value is Record<string, unknown>;
-
-declare const BUILTIN_ORBITWORK_SKINS: readonly [OrbitworkSkin, OrbitworkSkin, OrbitworkSkin];
-
-/**
- * Scoped skin application — inspired by design project
- *
- * 改进点：
- * 1. 从内联样式改为 <style> 标签注入
- * 2. 使用 html[data-ow-skin] 作用域选择器
- * 3. CSS 层面真正隔离，可通过选择器精准控制
- * 4. 支持 L2/L3 高级样式（语义选择器、自由补丁）
- *
- * 向后兼容：保持与原 applyOrbitworkSkin() 相同的签名和行为
- */
-
-/**
- * 作用域化皮肤应用
- *
- * @example
- * applyScopedOrbitworkSkin(document.documentElement, skin, 'light')
- * // 生成: html[data-ow-skin="aurora"] { --ow-primary: #7c3aed; ... }
- */
-declare function applyScopedOrbitworkSkin(target: HTMLElement, skin: OrbitworkSkin | null, mode: ResolvedTheme): void;
-/**
- * 获取当前激活的皮肤 ID
- */
-declare function getActiveSkinId(): string | null;
-/**
- * 检查是否有皮肤激活
- */
-declare function hasSkinActive(): boolean;
-
-/**
- * @deprecated Import from './theme' instead. This file re-exports for backward compatibility.
- *
- * 例外：`THEME_OPTIONS`（文件末）是本文件自有的值——设置面与账户菜单共用的主题三格。
- */
-
-/**
- * 主题三格（R2 · D4 / 裁决：设置常规段与账户菜单「外观」行共用同一份选项）。
- *
- * 原型的 themeRows 只有「浅色 / 深色」两档、另配一条「显示模式跟随系统」开关；
- * R2 按 Terry 的参考图把三件事收成一排三格——`system` 就是第三格「自动」，
- * 那条开关卡随之撤除。写在这里而不是各件各写一份：设置面（DesktopAppearanceSettings）
- * 与侧栏账户菜单（DesktopAccountMenuView）两处必须同词同序，分叉了就是两套语汇。
- */
-declare const THEME_OPTIONS: Array<{
-    value: Theme;
-    label: string;
-}>;
-
-export { BUILTIN_ORBITWORK_SKINS as B, DS2_LOCKED_SLOT_SELECTORS as D, HEX_COLOR as H, MAX_ORBITWORK_SKIN_IMAGE_BYTES as M, type OrbitworkSkin as O, type ResolvedTheme as R, type SkinValidationResult as S, type Theme as T, DS2_SKIN_DENIED_PROPERTIES as a, DS2_SKIN_DENIED_VALUE_PATTERNS as b, DS2_SKIN_DENYLIST as c, ORBITWORK_SKIN_CSS_VARIABLES as d, type OrbitworkSkinChatBackgroundMask as e, type OrbitworkSkinRegistryEntry as f, type OrbitworkSkinTokens as g, THEME_OPTIONS as h, applyScopedOrbitworkSkin as i, assertKnownKeys as j, ds2ContrastRatio as k, findDs2DeniedCssProperty as l, findDs2DeniedCssValue as m, getActiveSkinId as n, hasOrbitworkSkinChatBackground as o, hasSkinActive as p, isDs2SkinDeniedProperty as q, isDs2SkinDeniedToken as r, isDs2SkinDeniedValue as s, isRecord as t, orbitworkSkinChatBackgroundMaskColor as u, orbitworkSkinImageCssValue as v, parseOrbitworkSkin as w, resolveOrbitworkSkinChatBackgroundMask as x };