@orbit-work/ui 0.1.0

package/src/theme/core/unifiedTheme.ts

@@ -0,0 +1,157 @@
+/**
+ * 统一的主题配置类型
+ * 整合了租户主题和用户皮肤
+ */
+
+import type { OrbitworkSkin } from "./skin"
+import type { TenantBranding, TenantTheme } from "./types.ts"
+
+export type UnifiedTheme = {
+  // 🔒 品牌标识 - 仅租户可配置，用户不可覆盖
+  branding: TenantBranding & {
+    logo: string
+    favicon?: string
+  }
+
+  // 🎨 配色方案 - 租户提供默认，用户可覆盖
+  /**
+   * R2：色位改用 DS 2.0 语义名（面 bg/surface/surface2 · 字 text/-2/-3 · 线 border/-strong）。
+   * 原字段是 V1 梯队名（bg1/bg2/bg3、fg1..3、line1..3）＋ primary/primaryHover ——
+   * 前者已被 check-ds2 的 v1-naming 按 HARD 拦，后者在 DS2 禁覆盖清单上（--ow-primary*），
+   * 租户/皮肤两条链路都落不下去，留着是个应用不上的字段。
+   * error/success/warning 早已因「功能色四族禁覆盖」失效，一并撤。
+   */
+  colors: {
+    bg: string
+    surface: string
+    surface2: string
+    text: string
+    text2: string
+    text3: string
+    border: string
+    borderStrong: string
+  }
+
+  // 📐 圆角 - 租户提供默认，用户可覆盖
+  radius?: {
+    sm?: string
+    md?: string
+    lg?: string
+    full?: string
+  }
+
+  // 🔤 字体 - 租户配置
+  typography: {
+    fontSans: string
+    fontMono: string
+  }
+
+  // 🖼️ 装饰性资产 - 仅用户皮肤有
+  assets?: {
+    chatBackground?: {
+      light?: string
+      dark?: string
+    }
+  }
+
+  // 📦 元数据
+  source: "tenant" | "user" | "builtin" // 来源标识
+  id: string
+  name: string
+}
+
+/**
+ * 将租户主题转换为统一主题
+ */
+export function tenantThemeToUnified(tenant: TenantTheme): UnifiedTheme {
+  return {
+    id: `tenant-${tenant.name}`,
+    name: tenant.name,
+    source: "tenant",
+    branding: {
+      ...tenant.branding,
+      logo: tenant.logo,
+      favicon: tenant.favicon,
+    },
+    colors: tenant.colors,
+    typography: tenant.typography,
+  }
+}
+
+/**
+ * 将用户皮肤转换为统一主题（不包含品牌信息）
+ */
+export function skinToUnified(skin: OrbitworkSkin): Partial<UnifiedTheme> {
+  const lightMode = skin.modes?.light
+  const darkMode = skin.modes?.dark
+
+  return {
+    id: skin.id,
+    name: skin.name,
+    source: "user",
+    // R2：兜底值原是一整套 Tailwind 默认灰（#FFFFFF/#F9FAFB/#F3F4F6/#111827/#E5E7EB…）
+    // ＋ 靛蓝 #4F46E5 —— 皮肤缺项时渲出来的就是一屏 V1 配色。改抄 DS 2.0 浅档终值。
+    // 另：skin 的 primary 位在 §15 已取消、--ow-primary* 又在禁覆盖清单上，两行 primary
+    // 映射落不下去，随色位一起撤。
+    colors: lightMode
+      ? {
+          bg: lightMode.backgroundPrimary || "#F7F6F1",
+          surface: lightMode.backgroundSecondary || "#FDFDFC",
+          surface2: lightMode.backgroundTertiary || "#F1F0EA",
+          text: lightMode.foregroundPrimary || "#333B50",
+          text2: lightMode.foregroundSecondary || "#646B7A",
+          text3: lightMode.foregroundMuted || "#A2A5A9",
+          border: lightMode.borderSubtle || "#DCDCD7",
+          borderStrong: lightMode.borderStrong || "#C2C3C1",
+          // DS2 §15：功能色四族禁覆盖，皮肤不再提供 error/success/warning
+        }
+      : undefined,
+    // DS2 §15：圆角是品牌定稿，皮肤不再提供 radius
+    assets: lightMode?.chatBackgroundImage
+      ? {
+          chatBackground: {
+            light: lightMode.chatBackgroundImage,
+            dark: darkMode?.chatBackgroundImage,
+          },
+        }
+      : undefined,
+  }
+}
+
+/**
+ * 合并租户主题和用户皮肤
+ *
+ * 优先级规则：
+ * - branding: 始终使用租户的（用户不可覆盖）
+ * - colors: 用户皮肤 > 租户主题
+ * - radius: 用户皮肤 > 租户主题
+ * - typography: 始终使用租户的
+ * - assets: 仅用户皮肤有
+ */
+export function mergeThemes(tenant: TenantTheme, userSkin: OrbitworkSkin | null): UnifiedTheme {
+  const baseTheme = tenantThemeToUnified(tenant)
+
+  if (!userSkin) {
+    return baseTheme
+  }
+
+  const userTheme = skinToUnified(userSkin)
+
+  return {
+    ...baseTheme,
+    // 🔒 品牌：始终用租户的
+    branding: baseTheme.branding,
+    // 🎨 配色：用户覆盖租户
+    colors: userTheme.colors || baseTheme.colors,
+    // 📐 圆角：用户覆盖租户
+    radius: userTheme.radius || baseTheme.radius,
+    // 🔤 字体：始终用租户的
+    typography: baseTheme.typography,
+    // 🖼️ 装饰背景：仅用户有
+    assets: userTheme.assets,
+    // 📦 元数据更新
+    id: userSkin.id,
+    name: userSkin.name,
+    source: "user",
+  }
+}

package/src/theme/index.ts

@@ -0,0 +1,33 @@
+export * from "./core/skin"
+export * from "./core/skinScoped"
+export * from "./utils/cssSafety"
+export * from "./core/semanticAdapter"
+export { ThemeProvider, useTheme } from "./providers/ThemeProvider"
+export type { ThemeContextValue } from "./providers/ThemeProvider"
+export { BrandingProvider, useBranding } from "./providers/BrandingProvider"
+export type { BrandingContextValue } from "./providers/BrandingProvider"
+export { BUILTIN_ORBITWORK_SKINS } from "./skins"
+
+// 🆕 统一主题系统（推荐使用）
+export { useUnifiedTheme } from "../hooks/useUnifiedTheme"
+export type { UnifiedTheme } from "./core/unifiedTheme"
+
+// Tenant theme (Phase 1) - 内部使用，建议使用 useUnifiedTheme
+export { useTenantTheme } from "../hooks/useTenantTheme"
+export { applyTenantTheme, removeTenantTheme, getCurrentThemeName } from "./utils/themeApplier"
+export { ThemeDemo } from "../components/domain/theme/ThemeDemo"
+export type { TenantBranding, TenantTheme } from "./core/types"
+export { parseTenantTheme } from "./core/tenantTheme"
+export type { TenantThemeValidationResult } from "./core/tenantTheme"
+
+// User skin system (Phase 3)
+export { SkinManager } from "../components/domain/theme/SkinManagerUI"
+export {
+  exportSkin,
+  importSkin,
+  importSkinFromUrl,
+  shareSkin,
+  importSkinFromShareUrl,
+  saveCustomSkins,
+  loadCustomSkins,
+} from "./utils/skinManager"

package/src/theme/providers/BrandingProvider.tsx

@@ -0,0 +1,57 @@
+"use client"
+
+import { type ReactNode, createContext, useContext, useMemo } from "react"
+import { useUnifiedTheme } from "../../hooks/useUnifiedTheme"
+import type { UnifiedTheme } from "../core/unifiedTheme"
+
+/**
+ * 租户品牌素材管道：把 GET /api/v1/tenant/theme 的 branding 经 Context 下发到
+ * 组件实例 props。这是品牌文本/图形素材（productName/slogan/claim/logo）进入
+ * 组件的**唯一通道**——DS2 皮肤层（skin.json）不承载文本，品牌锁定件也不接受
+ * 皮肤覆盖。
+ *
+ * 范围说明：本 Provider 只下发品牌素材（branding），不做 applyTenantTheme
+ * （租户色上桌面涉及与用户皮肤的 merge 优先级，另行处理）。拉取失败/契约非法/
+ * 后端缺省时 branding 为 null，组件回落到包内默认文案（Orbitwork）。
+ */
+
+export type BrandingContextValue = {
+  /** 租户品牌素材；null = 无租户品牌（组件用默认文案） */
+  branding: UnifiedTheme["branding"] | null
+  tenantLoading: boolean
+  tenantError: string | null
+}
+
+const FALLBACK_VALUE: BrandingContextValue = { branding: null, tenantLoading: false, tenantError: null }
+
+const BrandingContext = createContext<BrandingContextValue | null>(null)
+
+type BrandingProviderProps = {
+  children: ReactNode
+  /** 租户主题接口地址；默认 /api/v1/tenant/theme */
+  apiUrl?: string
+}
+
+export function BrandingProvider({ children, apiUrl }: BrandingProviderProps) {
+  // useUnifiedTheme 必须在 ThemeProvider 内（依赖其 skin/试穿状态）
+  const { unifiedTheme, tenantLoading, tenantError } = useUnifiedTheme(apiUrl)
+
+  const value = useMemo<BrandingContextValue>(
+    () => ({
+      branding: unifiedTheme?.branding ?? null,
+      tenantLoading,
+      tenantError,
+    }),
+    [unifiedTheme, tenantLoading, tenantError],
+  )
+
+  return <BrandingContext.Provider value={value}>{children}</BrandingContext.Provider>
+}
+
+/**
+ * 读取租户品牌素材。无 Provider 时返回 branding: null（组件回落默认文案），
+ * 比 useTheme 宽松——锁定件组件允许在未接线的宿主中渲染。
+ */
+export function useBranding(): BrandingContextValue {
+  return useContext(BrandingContext) ?? FALLBACK_VALUE
+}

package/src/theme/providers/ThemeProvider.tsx

@@ -0,0 +1,221 @@
+"use client"
+
+import { type ReactNode, createContext, useCallback, useContext, useEffect, useMemo, useState } from "react"
+import { createSemanticAdapter } from "../core/semanticAdapter"
+import type { OrbitworkSkin, ResolvedTheme, Theme } from "../core/skin"
+import { applyScopedOrbitworkSkin } from "../core/skinScoped"
+import { BUILTIN_ORBITWORK_SKINS } from "../skins"
+
+const STORAGE_KEY = "ow-theme"
+const SKIN_STORAGE_KEY = "ow-skin-id"
+
+type ThemeContextValue = {
+  /** User preference: light / dark / system. */
+  theme: Theme
+  /** Effective theme after resolving `system`. */
+  resolvedTheme: ResolvedTheme
+  setTheme: (theme: Theme) => void
+  /** Active runtime skin, null = default theme. */
+  skin: OrbitworkSkin | null
+  /** Active skin ID. */
+  skinId: string
+  /** Pass a validated OrbitworkSkin, or null to restore the default theme. */
+  setSkin: (skin: OrbitworkSkin | null) => void
+  /** Built-in skins shipped with the library. */
+  builtinSkins: readonly OrbitworkSkin[]
+  /** Custom skins (user-imported). */
+  customSkins: OrbitworkSkin[]
+  /** Update custom skins. */
+  setCustomSkins: (skins: OrbitworkSkin[]) => void
+  /** All skins (builtin + custom). */
+  skins: OrbitworkSkin[]
+
+  // Phase 4.1: 试穿预览 API
+  /** 当前正在试穿的皮肤（未保存） */
+  tryOnSkin: OrbitworkSkin | null
+  /** 试穿皮肤（不保存到 localStorage） */
+  tryOn: (skin: OrbitworkSkin) => void
+  /** 应用试穿的皮肤（保存到 localStorage） */
+  applySkin: () => void
+  /** 取消试穿（恢复原皮肤） */
+  cancelTryOn: () => void
+  /** 是否处于试穿模式 */
+  isTryingOn: boolean
+}
+
+export type { ThemeContextValue }
+
+const ThemeContext = createContext<ThemeContextValue | null>(null)
+
+function resolveSystemTheme(): ResolvedTheme {
+  if (typeof window === "undefined" || typeof window.matchMedia !== "function") return "light"
+  return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light"
+}
+
+function readInitialTheme(): Theme {
+  try {
+    const stored = window.localStorage.getItem(STORAGE_KEY)
+    if (stored === "light" || stored === "dark" || stored === "system") return stored
+  } catch {
+    /* storage unavailable (SSR / private mode) */
+  }
+  return "system"
+}
+
+function readInitialSkin(): OrbitworkSkin | null {
+  try {
+    const id = window.localStorage.getItem(SKIN_STORAGE_KEY)
+    return BUILTIN_ORBITWORK_SKINS.find((skin) => skin.id === id) ?? null
+  } catch {
+    return null
+  }
+}
+
+type ThemeProviderProps = {
+  children: ReactNode
+  defaultTheme?: Theme
+  initialTheme?: Theme
+  initialSkinId?: string
+  initialCustomSkins?: OrbitworkSkin[]
+}
+
+export function ThemeProvider({ children, initialTheme, initialSkinId, initialCustomSkins = [] }: ThemeProviderProps) {
+  const [theme, setThemeState] = useState<Theme>(initialTheme ?? readInitialTheme)
+  const [resolvedTheme, setResolvedTheme] = useState<ResolvedTheme>(() =>
+    theme === "system" ? resolveSystemTheme() : theme,
+  )
+  const [skin, setSkinState] = useState<OrbitworkSkin | null>(() => {
+    if (initialSkinId && initialSkinId !== "default") {
+      return (
+        BUILTIN_ORBITWORK_SKINS.find((s) => s.id === initialSkinId) ??
+        initialCustomSkins.find((s) => s.id === initialSkinId) ??
+        null
+      )
+    }
+    return readInitialSkin()
+  })
+  const [customSkins, setCustomSkins] = useState<OrbitworkSkin[]>(initialCustomSkins)
+
+  // Phase 4.1: 试穿预览状态
+  const [tryOnSkin, setTryOnSkin] = useState<OrbitworkSkin | null>(null)
+  const isTryingOn = tryOnSkin !== null
+
+  // 合并 builtin + custom
+  const builtinSkins = BUILTIN_ORBITWORK_SKINS
+  const skins = [...BUILTIN_ORBITWORK_SKINS, ...customSkins]
+
+  // Resolve system theme
+  useEffect(() => {
+    if (theme !== "system") {
+      setResolvedTheme(theme)
+      return
+    }
+    const updateSystemTheme = () => setResolvedTheme(resolveSystemTheme())
+    updateSystemTheme()
+    const mq = window.matchMedia("(prefers-color-scheme: dark)")
+    mq.addEventListener("change", updateSystemTheme)
+    return () => mq.removeEventListener("change", updateSystemTheme)
+  }, [theme])
+
+  // Apply theme attribute（DS2：主题仅由 data-theme 驱动；.dark class 并行 toggle 已移除，
+  // Tailwind dark 变体经 @custom-variant 接回 data-theme，全库无 .dark 选择器消费）
+  useEffect(() => {
+    document.documentElement.setAttribute("data-theme", resolvedTheme)
+  }, [resolvedTheme])
+
+  // Apply skin (试穿模式优先)
+  useEffect(() => {
+    const activeSkin = tryOnSkin ?? skin
+    applyScopedOrbitworkSkin(document.documentElement, activeSkin, resolvedTheme)
+  }, [resolvedTheme, skin, tryOnSkin])
+
+  // Setup semantic adapter
+  useEffect(() => {
+    const adapter = createSemanticAdapter()
+    return () => adapter.disconnect()
+  }, [])
+
+  const setTheme = useCallback((next: Theme) => {
+    setThemeState(next)
+    try {
+      window.localStorage.setItem(STORAGE_KEY, next)
+    } catch {
+      /* storage unavailable */
+    }
+  }, [])
+
+  const setSkin = useCallback((next: OrbitworkSkin | null) => {
+    setSkinState(next)
+    setTryOnSkin(null) // 清除试穿状态
+    try {
+      if (next) {
+        window.localStorage.setItem(SKIN_STORAGE_KEY, next.id)
+      } else {
+        window.localStorage.removeItem(SKIN_STORAGE_KEY)
+      }
+    } catch {
+      /* storage unavailable */
+    }
+  }, [])
+
+  // Phase 4.1: 试穿预览 API
+  const tryOn = useCallback((targetSkin: OrbitworkSkin) => {
+    setTryOnSkin(targetSkin)
+  }, [])
+
+  const applySkin = useCallback(() => {
+    if (tryOnSkin) {
+      setSkin(tryOnSkin)
+    }
+  }, [tryOnSkin, setSkin])
+
+  const cancelTryOn = useCallback(() => {
+    setTryOnSkin(null)
+  }, [])
+
+  const value = useMemo<ThemeContextValue>(
+    () => ({
+      theme,
+      resolvedTheme,
+      setTheme,
+      skin,
+      skinId: skin?.id ?? "default",
+      setSkin,
+      builtinSkins,
+      customSkins,
+      setCustomSkins,
+      skins,
+      tryOnSkin,
+      tryOn,
+      applySkin,
+      cancelTryOn,
+      isTryingOn,
+    }),
+    [
+      theme,
+      resolvedTheme,
+      setTheme,
+      skin,
+      setSkin,
+      builtinSkins,
+      customSkins,
+      setCustomSkins,
+      skins,
+      tryOnSkin,
+      tryOn,
+      applySkin,
+      cancelTryOn,
+      isTryingOn,
+    ],
+  )
+
+  return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>
+}
+
+export function useTheme(): ThemeContextValue {
+  const context = useContext(ThemeContext)
+  if (!context) {
+    throw new Error("useTheme must be used within a ThemeProvider")
+  }
+  return context
+}

package/src/theme/skinDs2PropertyGate.test.mjs

@@ -0,0 +1,109 @@
+import assert from "node:assert/strict"
+import test from "node:test"
+
+const { DS2_SKIN_DENIED_PROPERTIES, findDs2DeniedCssProperty, isDs2SkinDeniedProperty } = await import("./core/skin.ts")
+
+test("属性维度禁覆盖清单覆盖 §5/§7/§9 三层词汇", () => {
+  for (const property of ["box-shadow", "border-radius", "transform", "animation", "transition", "backdrop-filter"]) {
+    assert.ok(DS2_SKIN_DENIED_PROPERTIES.includes(property), `${property} 应在清单内`)
+    assert.equal(isDs2SkinDeniedProperty(property), true)
+  }
+})
+
+test("按连字符边界前缀匹配长写属性，不误伤同前缀的别的属性", () => {
+  assert.equal(isDs2SkinDeniedProperty("border-top-left-radius"), true)
+  assert.equal(isDs2SkinDeniedProperty("transition-property"), true)
+  assert.equal(isDs2SkinDeniedProperty("animation-duration"), true)
+  // 非禁项
+  assert.equal(isDs2SkinDeniedProperty("border-color"), false)
+  assert.equal(isDs2SkinDeniedProperty("transform-origin"), true) // transform- 前缀属同族，一并拦
+  assert.equal(isDs2SkinDeniedProperty("background-color"), false)
+  // 自定义属性交给 token 维度那一闸，属性闸不插手
+  assert.equal(isDs2SkinDeniedProperty("--ow-animation-x"), false)
+})
+
+test("只在声明位置取属性名——选择器与值里的同名词不算", () => {
+  assert.equal(findDs2DeniedCssProperty('[data-ow-part="bubble"] { color: red; }'), null)
+  assert.equal(findDs2DeniedCssProperty(".x { background-image: url(#transform); }"), null)
+  assert.equal(findDs2DeniedCssProperty(".x:hover { color: red; }"), null)
+})
+
+test("cyberpunk / glass 那几类越界写法逐条命中", () => {
+  assert.equal(
+    findDs2DeniedCssProperty('[data-ow-part="message-bubble"] { box-shadow: 0 0 20px #ff2e97; }'),
+    "box-shadow",
+  )
+  assert.equal(findDs2DeniedCssProperty(".card:hover { transform: translateY(-2px); }"), "transform")
+  assert.equal(findDs2DeniedCssProperty(".b { animation: neon-pulse 2s infinite; }"), "animation")
+  assert.equal(findDs2DeniedCssProperty(".b { border-radius: 18px; }"), "border-radius")
+  assert.equal(findDs2DeniedCssProperty(".g { backdrop-filter: blur(12px); }"), "backdrop-filter")
+  // @keyframes 整块内部命中（skin-scoped 按顶层块整块剥除）
+  assert.equal(findDs2DeniedCssProperty("@keyframes scan { 0% { transform: translateY(0) } }"), "transform")
+})
+
+/* ================= R2：值维度禁覆盖（判据 7 品牌外渐变一律清除） ================= */
+
+const { DS2_SKIN_DENIED_VALUE_PATTERNS, findDs2DeniedCssValue, isDs2SkinDeniedValue } = await import("./core/skin.ts")
+
+// 补这一闸之前：属性闸按**属性名**拦（background 不在表上，也不该在——皮肤本来就该能改底），
+// token 闸按**落点名**拦（--ow-chat-user-bubble-bg 是合法落点）。于是渐变从两闸中间穿过去：
+// glass.ts 的 `body { background: linear-gradient(…蓝→紫…) }` 是整份皮肤里唯二没被剥掉的块，
+// cyberpunk.ts 的 `userBubbleBackground: "linear-gradient(135deg,#E91E63,#9C27B0)"` 更是走
+// mode token 直接落到用户气泡上。要拦的是**值的形态**，不是属性名。
+test("值维度禁覆盖：任何 *-gradient() 都算命中", () => {
+  assert.deepEqual([...DS2_SKIN_DENIED_VALUE_PATTERNS], ["-gradient("])
+  for (const value of [
+    "linear-gradient(135deg, #E91E63 0%, #9C27B0 100%)",
+    "radial-gradient(circle, #fff, #000)",
+    "conic-gradient(from 0deg, red, blue)",
+    "repeating-linear-gradient(45deg, #000 0 10px, #fff 10px 20px)",
+    "LINEAR-GRADIENT(TO RIGHT, RED, BLUE)",
+  ]) {
+    assert.equal(isDs2SkinDeniedValue(value), true, value)
+  }
+  // 纯色、透明度、色值函数一律放行——皮肤的合法业务
+  for (const value of ["#E91E63", "rgba(255, 46, 151, 0.15)", "color-mix(in srgb, #fff 50%, #000)", "transparent"]) {
+    assert.equal(isDs2SkinDeniedValue(value), false, value)
+  }
+})
+
+test("findDs2DeniedCssValue 只看声明的值侧，返回渐变函数名", () => {
+  assert.equal(
+    findDs2DeniedCssValue("body { background: linear-gradient(135deg, #a 0%, #b 100%); }"),
+    "linear-gradient",
+  )
+  assert.equal(
+    findDs2DeniedCssValue(".x { border-image: repeating-linear-gradient(90deg, #a, #b) 1; }"),
+    "repeating-linear-gradient",
+  )
+  // 选择器/类名里出现 gradient 字样不算
+  assert.equal(findDs2DeniedCssValue(".gradient-card { background: #fff; }"), null)
+  assert.equal(findDs2DeniedCssValue(".x { color: red; }"), null)
+})
+
+test("内置皮肤的 mode token 值里不再有渐变", async () => {
+  const { BUILTIN_ORBITWORK_SKINS } = await import("./skins/index.ts")
+  for (const skin of BUILTIN_ORBITWORK_SKINS) {
+    for (const [mode, tokens] of Object.entries(skin.modes ?? {})) {
+      for (const [key, value] of Object.entries(tokens ?? {})) {
+        if (key === "chatBackgroundImage") continue
+        assert.equal(
+          typeof value === "string" && isDs2SkinDeniedValue(value),
+          false,
+          `${skin.id}.modes.${mode}.${key} 的值是渐变：${value}`,
+        )
+      }
+    }
+  }
+})
+
+// R2 死码清除的守卫：三份内置皮肤的 L2/L3 补丁曾是 100% 被剥除的死内容
+// （glass 16 块 kept 2、cyberpunk 9 块 kept 0、auroraPro 4 块 kept 0），
+// 留着等于把「会被闸整块剥掉的写法」当合法样例存着。
+test("内置皮肤不再带 L2/L3 补丁（contributes 已清空）", async () => {
+  const { BUILTIN_ORBITWORK_SKINS } = await import("./skins/index.ts")
+  for (const skin of BUILTIN_ORBITWORK_SKINS) {
+    assert.equal(skin.contributes?.semanticStyles ?? "", "", `${skin.id} 仍带 L2 semanticStyles`)
+    assert.equal(skin.contributes?.patches ?? "", "", `${skin.id} 仍带 L3 patches`)
+  }
+})

package/src/theme/skins/index.ts

@@ -0,0 +1,107 @@
+import type { OrbitworkSkin } from "../core/skin.ts"
+
+// DS2 §15：已剥除 common(radius)、primary 族、link、switchActive（详见 skin.ts 白名单注释）
+export const aurora: OrbitworkSkin = {
+  version: 1,
+  id: "aurora",
+  name: "极光紫",
+  description: "柔和紫色强调与微暖背景",
+  modes: {
+    light: {
+      backgroundPrimary: "#fdfcff",
+      backgroundSecondary: "#f8f5ff",
+      backgroundTertiary: "#f1ecfb",
+      foregroundPrimary: "#1d1a26",
+      foregroundSecondary: "#4c4560",
+      foregroundHint: "#c9c5d6",
+      borderStrong: "#c4b5fd",
+      buttonPrimaryBackground: "#7c3aed",
+      buttonPrimaryForeground: "#ffffff",
+    },
+    dark: {
+      backgroundPrimary: "#17141d",
+      backgroundSecondary: "#201b29",
+      backgroundTertiary: "#2a2335",
+      backgroundPanel: "#1c1823",
+      foregroundPrimary: "#eae6f2",
+      foregroundSecondary: "#b3abc6",
+      foregroundHint: "#4a4459",
+      borderStrong: "#6d4aa5",
+      buttonPrimaryBackground: "#a78bfa",
+      buttonPrimaryForeground: "#17141d",
+    },
+  },
+}
+
+export const forest: OrbitworkSkin = {
+  version: 1,
+  id: "forest",
+  name: "苔原绿",
+  description: "克制自然的绿色工作空间",
+  modes: {
+    light: {
+      backgroundPrimary: "#fbfdfb",
+      backgroundSecondary: "#f3f8f5",
+      backgroundTertiary: "#e9f1ec",
+      foregroundPrimary: "#16211b",
+      foregroundSecondary: "#3f5248",
+      foregroundHint: "#c5d0c9",
+      borderStrong: "#98d8be",
+      buttonPrimaryBackground: "#16805b",
+      buttonPrimaryForeground: "#ffffff",
+    },
+    dark: {
+      backgroundPrimary: "#111916",
+      backgroundSecondary: "#17231e",
+      backgroundTertiary: "#1e2e27",
+      backgroundPanel: "#141e1a",
+      foregroundPrimary: "#e4efe8",
+      foregroundSecondary: "#a7bcb0",
+      foregroundHint: "#3d4a44",
+      borderStrong: "#28664f",
+      buttonPrimaryBackground: "#55d6a0",
+      buttonPrimaryForeground: "#111916",
+    },
+  },
+}
+
+export const auroraPro: OrbitworkSkin = {
+  version: 1,
+  id: "aurora-pro",
+  // R2：名与述原为「极光紫 Pro（演示 L2/L3）」「带高级样式的极光紫」，而它演示的那四块
+  // L2/L3 补丁 100% 被 §15 剥除闸挡掉（见下方注释），皮肤列表里等于挂着一个做不到的承诺。
+  name: "极光紫 Pro",
+  description: "更深一档的极光紫（同族深色变体）",
+  modes: {
+    light: {
+      backgroundPrimary: "#fdfcff",
+      backgroundSecondary: "#f8f5ff",
+      backgroundTertiary: "#f1ecfb",
+      foregroundPrimary: "#1d1a26",
+      foregroundSecondary: "#4c4560",
+      foregroundHint: "#c9c5d6",
+      borderStrong: "#c4b5fd",
+      buttonPrimaryBackground: "#7c3aed",
+      buttonPrimaryForeground: "#ffffff",
+    },
+    dark: {
+      backgroundPrimary: "#17141d",
+      backgroundSecondary: "#201b29",
+      backgroundTertiary: "#2a2335",
+      backgroundPanel: "#1c1823",
+      foregroundPrimary: "#eae6f2",
+      foregroundSecondary: "#b3abc6",
+      foregroundHint: "#4a4459",
+      borderStrong: "#6d4aa5",
+      buttonPrimaryBackground: "#a78bfa",
+      buttonPrimaryForeground: "#17141d",
+    },
+  },
+  // R2 死码清除：原 auroraPro 的 contributes（L2 三块 + L3 一块「演示用」补丁）整体删除。
+  // 四块全部只写 border-radius / box-shadow / transform / transition —— §15 的 L2/L3
+  // 剥除闸恰好逐条禁的就是这四个属性（§7 形状表定稿、§5 贴地零影、§9 唯一动效语汇），
+  // 实跑 kept 0 / removed 4。作为「演示」它演示的是一套会被闸整块剥掉的写法，
+  // 比没有演示更糟：照抄的人拿到的是必然失效的样例。
+}
+
+export const BUILTIN_ORBITWORK_SKINS = [aurora, forest, auroraPro] as const