@orbit-work/ui 0.1.0

package/README.md

@@ -0,0 +1,110 @@
+# Orbitwork UI
+
+Orbitwork Design System 组件库，为 Orbitwork Agent OS 提供丰富的组件、Design Tokens、浅色/深色主题。
+
+## npm 使用
+
+```bash
+npm i @orbit-work/ui
+```
+
+在 React 应用入口引入样式，并从包根路径导入组件：
+
+```tsx
+import '@orbit-work/ui/styles/orbitwork.css'
+import { Button, ThemeProvider } from '@orbit-work/ui'
+
+export default function App() {
+  return (
+    <ThemeProvider defaultTheme="system">
+      <Button variant="primary">Hello Orbitwork UI</Button>
+    </ThemeProvider>
+  )
+}
+```
+
+项目需要提供 React 18 或更高版本以及 React DOM 18 或更高版本。
+
+## 目录结构
+
+```text
+packages/ui/
+├── src/
+│   ├── components/    # React 组件（primitives / composite / domain / Layout）
+│   ├── hooks/         # 通用 Hooks
+│   ├── theme/         # 主题、皮肤（skins）与 ThemeProvider
+│   ├── tokens/        # Design Tokens 定义
+│   ├── lib/           # 独立入口（appearance / about-window / browser-annotation-popup）
+│   └── utils/         # 工具函数
+├── styles/            # 全局样式与组件样式源文件
+├── scripts/           # 构建与代码生成脚本
+└── .storybook/        # Storybook 文档站配置
+```
+
+## 研发与测试规范
+
+开发或修改组件前，Coding Agent 应先阅读以下规范文档：
+
+- **研发规范**：仓库根 [`AGENTS.md`](../../AGENTS.md) — 硬性规则、Token 约束、Story 强制、工程纪律
+- **组件开发工作流**：[`.agents/skills/ui-development/`](../../.agents/skills/ui-development/SKILL.md) — 新组件的创建流程与目录约定
+- **测试规范**：[`AGENTS.md`](../../AGENTS.md) 的「测试分层」章节 + [`.agents/skills/ui-quality/`](../../.agents/skills/ui-quality/) — 单元测试与 Storybook 视觉测试标准
+
+## 本地开发
+
+在 `packages/ui/` 目录下执行：
+
+```bash
+pnpm install
+pnpm storybook      # 启动文档站（会先生成 tokens）
+pnpm build          # 构建组件库（ESM/CJS + 样式产物）
+pnpm typecheck      # TypeScript 类型检查
+pnpm test           # 运行单元测试
+```
+
+## DS 2.0 守卫（`pnpm check:ds2`）
+
+`scripts/check-ds2.mjs` 扫 `src/components/**` 与 `styles/*.css`（`tokens*.css` 是生成物，跳过；
+`*.test.mjs` 也跳过——源码守卫测试的正文本来就是「被禁写法的正则字面量」），把 DS 2.0 契约里
+**改一次就会全库漂**的那几条钉成 HARD 规则（`exit 1`）；另有 WARN 级只打印不拦。
+规则体在 `scripts/ds2-rules.mjs`（纯函数，可单测），测试在 `scripts/check-ds2.test.mjs`
+（`pnpm test:ds2`，也含在 `pnpm test` 里）。
+
+| 规则 | 抓什么 | 正解 |
+| --- | --- | --- |
+| `yellow` | 荧黄/信标极色写死 | 经语义 token 或品牌锁定件取色 |
+| `paper` / `stage` / `term` | 恒定域 token 越出各自语境 | 只在文档纸面 / login·share·splash / 终端语境用 |
+| `primary` | 共享 CSS 里裸引 `--ow-primary` 族 | 见下 `primary-nonpole` |
+| `v1-naming` | V1 token 与类名回流 | DS2 语义 token |
+| `disabled` | 统一透明度禁用态 | 逐 token 禁用色 |
+| `hover-move` | hover 位移/缩放 | hover 只换色 |
+| `shimmer` | 流光扫过动效 | 呼吸（opacity）或静止 |
+| `drift` | `styles/tokens.css` 与设计侧规格 `tokens/ds2-spec.json` 逐值比对 | 改设计仓库后 `--update-spec` 重抽 |
+
+W5 防回流批（新增）：
+
+| 规则 | 抓什么 | 正解 |
+| --- | --- | --- |
+| `radius-literal` | `border-radius: Npx` / `rounded-[Npx]`，N ∉ {0,4,6,8,10,12,16,999,9999}；组件层的裸 Tailwind 圆角刻度类（`rounded-md/lg/2xl…`，含侧向变体） | `[border-radius:var(--ow-radius-*)]` 或 ow 圆角类。`rounded-none` / `rounded-full` 不禁；`calc()/min()/max()/clamp()` 里的 px 不计 |
+| `grounded-shadow` | 在贴地面上消费 `var(--ow-shadow-1\|-2)` / `shadow-ow-shadow-1\|2` | §5 平面贴地零影：分层用 `1px var(--ow-border)`。投影只属 popover/menu/modal/dialog/toast/tooltip/pet/floating 等真悬浮层，且要逐条进 allowlist |
+| `bare-transition` | `transition-all/-colors/-opacity/-shadow/-transform/-[…]` 未配 `duration-[var(--ow-dur-*)]`；CSS/内联/`duration-…` 里的字面时长 ∉ {120,200,320}ms | `--ow-dur-1/2/3` ＋ `--ow-ease(-beacon)`。reduced-motion 兜底(0.01ms)、skeleton/呼吸(1.6s)、自转、第三方皮肤在 allowlist |
+| `primary-nonpole` | 组件层的 `var(--ow-primary…)`、全库的 `(bg\|text\|border)-ow-primary*` 类 | §4 行动极唯一：焦点→`--ow-focus-ring`、选中→`--ow-current-bg`/`--ow-control-on`、链接→`--ow-link`、hover→`--ow-hover`、tint→`--ow-info-tint` 族、实底字→`--ow-on-fill`、真主按钮→`--ow-btn-primary-*` |
+| `control-height` | `h-9` / `h-11` / `h-[NNpx]` / `min-h-[NNpx]` 与 `height\|min-height: NNpx`，NN ∈ {22,24,26,30,34,35,36,38,44,46,48} | §7 控件高只有 {28,32,40}：`--ow-h-sm/md/lg`、行高 `--ow-row-h(-dense)`；48 只属标题带，写成 `var(--ow-titlebar-h)`。`max-height`/`line-height` 与算式里的 px 不计 |
+| `unlayered-global` | `styles/*.css` 里 `@layer` 之外、选择器是 `*` 或裸元素名的规则 | 收进 `@layer base { }`。Tailwind v4 里未分层声明永远压过 `@layer utilities`，这种规则会静默压死整库工具类 |
+
+### allowlist
+
+`scripts/ds2-allowlist.json`：规则名 → 条目数组，每条都要在 `$reasons` 里写理由
+（测试会验「有条目必有 `$reasons`」）。条目两种写法：
+
+```jsonc
+"src/components/composite/Splash/**",              // 整路径豁免
+"styles/desktop-surfaces.css::.scroll-fab"         // 只豁免该文件里 scope 含 needle 的命中
+```
+
+`needle` 按子串、大小写不敏感地匹配命中的 **scope**：CSS 命中的 scope 是
+`选择器 { 声明原文 }`，源码命中的 scope 是出事那行。选择器级豁免是新规的必需品——
+`desktop-surfaces.css` 是六千行共享表，整文件豁免等于把规则关掉。
+
+写 `$reasons` 的要求是**说清它凭什么是例外**，不是「历史如此」：`control-height` 要写
+它为什么不是控件（图标位／头像位／内容缩略盒／只读标签／文本块下限），`grounded-shadow`
+要写它凭什么算悬浮层，`primary-nonpole` 要写它凭什么占行动极。

package/dist/about-window.cjs

@@ -0,0 +1 @@
+'use strict';var chunk5VLBKOG7_cjs=require('./chunk-5VLBKOG7.cjs');Object.defineProperty(exports,"renderAboutWindowHtml",{enumerable:true,get:function(){return chunk5VLBKOG7_cjs.a}});

package/dist/about-window.d.cts

@@ -0,0 +1,12 @@
+interface AboutWindowContent {
+    version: string;
+    notes: string;
+    logoSvg: string;
+}
+/**
+ * Renders the shared, self-contained content for Orbitwork's native About window.
+ * Electron owns the window lifecycle; ow-ui owns its visual structure and CSS.
+ */
+declare function renderAboutWindowHtml({ version, notes, logoSvg }: AboutWindowContent): string;
+
+export { type AboutWindowContent, renderAboutWindowHtml };

package/dist/about-window.d.ts

@@ -0,0 +1,12 @@
+interface AboutWindowContent {
+    version: string;
+    notes: string;
+    logoSvg: string;
+}
+/**
+ * Renders the shared, self-contained content for Orbitwork's native About window.
+ * Electron owns the window lifecycle; ow-ui owns its visual structure and CSS.
+ */
+declare function renderAboutWindowHtml({ version, notes, logoSvg }: AboutWindowContent): string;
+
+export { type AboutWindowContent, renderAboutWindowHtml };

package/dist/about-window.js

@@ -0,0 +1 @@
+export{a as renderAboutWindowHtml}from'./chunk-VG7FQQ7K.js';

package/dist/appearance-D5uQ53j3.d.cts

@@ -0,0 +1,210 @@
+/**
+ * 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

@@ -0,0 +1,210 @@
+/**
+ * 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.cjs

@@ -0,0 +1 @@
+'use strict';var chunkEF2BSN3K_cjs=require('./chunk-EF2BSN3K.cjs');Object.defineProperty(exports,"BUILTIN_ORBITWORK_SKINS",{enumerable:true,get:function(){return chunkEF2BSN3K_cjs.u}});Object.defineProperty(exports,"MAX_ORBITWORK_SKIN_IMAGE_BYTES",{enumerable:true,get:function(){return chunkEF2BSN3K_cjs.b}});Object.defineProperty(exports,"ORBITWORK_SKIN_CSS_VARIABLES",{enumerable:true,get:function(){return chunkEF2BSN3K_cjs.e}});Object.defineProperty(exports,"THEME_OPTIONS",{enumerable:true,get:function(){return chunkEF2BSN3K_cjs.A}});Object.defineProperty(exports,"applyOrbitworkSkin",{enumerable:true,get:function(){return chunkEF2BSN3K_cjs.x}});Object.defineProperty(exports,"hasOrbitworkSkinChatBackground",{enumerable:true,get:function(){return chunkEF2BSN3K_cjs.p}});Object.defineProperty(exports,"orbitworkSkinChatBackgroundMaskColor",{enumerable:true,get:function(){return chunkEF2BSN3K_cjs.d}});Object.defineProperty(exports,"orbitworkSkinImageCssValue",{enumerable:true,get:function(){return chunkEF2BSN3K_cjs.r}});Object.defineProperty(exports,"parseOrbitworkSkin",{enumerable:true,get:function(){return chunkEF2BSN3K_cjs.q}});Object.defineProperty(exports,"resolveOrbitworkSkinChatBackgroundMask",{enumerable:true,get:function(){return chunkEF2BSN3K_cjs.c}});

package/dist/appearance.d.cts

@@ -0,0 +1 @@
+export { B as BUILTIN_ORBITWORK_SKINS, M as MAX_ORBITWORK_SKIN_IMAGE_BYTES, d as ORBITWORK_SKIN_CSS_VARIABLES, O as OrbitworkSkin, e as OrbitworkSkinChatBackgroundMask, g as OrbitworkSkinTokens, R as ResolvedTheme, S as SkinValidationResult, h as THEME_OPTIONS, T as Theme, i as applyOrbitworkSkin, o as hasOrbitworkSkinChatBackground, u as orbitworkSkinChatBackgroundMaskColor, v as orbitworkSkinImageCssValue, w as parseOrbitworkSkin, x as resolveOrbitworkSkinChatBackgroundMask } from './appearance-D5uQ53j3.cjs';

package/dist/appearance.d.ts

@@ -0,0 +1 @@
+export { B as BUILTIN_ORBITWORK_SKINS, M as MAX_ORBITWORK_SKIN_IMAGE_BYTES, d as ORBITWORK_SKIN_CSS_VARIABLES, O as OrbitworkSkin, e as OrbitworkSkinChatBackgroundMask, g as OrbitworkSkinTokens, R as ResolvedTheme, S as SkinValidationResult, h as THEME_OPTIONS, T as Theme, i as applyOrbitworkSkin, o as hasOrbitworkSkinChatBackground, u as orbitworkSkinChatBackgroundMaskColor, v as orbitworkSkinImageCssValue, w as parseOrbitworkSkin, x as resolveOrbitworkSkinChatBackgroundMask } from './appearance-D5uQ53j3.js';

package/dist/appearance.js

@@ -0,0 +1 @@
+export{u as BUILTIN_ORBITWORK_SKINS,b as MAX_ORBITWORK_SKIN_IMAGE_BYTES,e as ORBITWORK_SKIN_CSS_VARIABLES,A as THEME_OPTIONS,x as applyOrbitworkSkin,p as hasOrbitworkSkinChatBackground,d as orbitworkSkinChatBackgroundMaskColor,r as orbitworkSkinImageCssValue,q as parseOrbitworkSkin,c as resolveOrbitworkSkinChatBackgroundMask}from'./chunk-3KT7IU4X.js';

package/dist/browser-annotation-popup.cjs

@@ -0,0 +1 @@
+'use strict';var chunkGMMYDILD_cjs=require('./chunk-GMMYDILD.cjs');Object.defineProperty(exports,"BROWSER_ANNOTATION_POPUP_STYLES",{enumerable:true,get:function(){return chunkGMMYDILD_cjs.b}});Object.defineProperty(exports,"BROWSER_ANNOTATION_PROPERTY_DEFS",{enumerable:true,get:function(){return chunkGMMYDILD_cjs.a}});