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

package/dist/slot-react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/slot/react.tsx"],"sourcesContent":["\"use client\"\n\nimport {\n  Component,\n  type ComponentType,\n  type ErrorInfo,\n  type ReactNode,\n  createContext,\n  createElement,\n  useCallback,\n  useContext,\n  useMemo,\n  useState,\n  useSyncExternalStore,\n} from \"react\"\nimport type {\n  SlotChildOf,\n  SlotCore,\n  SlotDeclOf,\n  SlotEntry,\n  SlotEntryKeyOf,\n  SlotName,\n  SlotOwnerOf,\n  SlotRenderFunction,\n  SlotTranslator,\n} from \"./core\"\n\nexport type SlotDiagnostics = (error: Error, entry: SlotEntry) => void\nexport type SlotTranslate = (\n  namespace: string | undefined,\n  key: string,\n  values?: Readonly<Record<string, string | number>>,\n) => string\n\nconst SlotCoreContext = createContext<SlotCore | null>(null)\nconst SlotTranslateContext = createContext<SlotTranslate>((_namespace, key) => key)\n\nexport interface SlotProviderProps {\n  children: ReactNode\n  core: SlotCore\n  translate?: SlotTranslate\n}\n\nexport function SlotProvider({ children, core, translate }: SlotProviderProps) {\n  const translation = translate ?? ((_namespace: string | undefined, key: string) => key)\n  return (\n    <SlotCoreContext.Provider value={core}>\n      <SlotTranslateContext.Provider value={translation}>{children}</SlotTranslateContext.Provider>\n    </SlotCoreContext.Provider>\n  )\n}\n\nfunction useHostSlotCore(): SlotCore {\n  const core = useContext(SlotCoreContext)\n  if (!core) throw new Error(\"SlotOutlet must be used inside SlotProvider\")\n  return core\n}\n\ntype ErrorBoundaryProps = {\n  children: ReactNode\n  entry: SlotEntry\n  onError: SlotDiagnostics\n  onFailed: () => void\n}\n\ntype ErrorBoundaryState = { failed: boolean }\n\nclass SlotErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {\n  state: ErrorBoundaryState = { failed: false }\n\n  static getDerivedStateFromError(): ErrorBoundaryState {\n    return { failed: true }\n  }\n\n  componentDidCatch(error: Error, _info: ErrorInfo): void {\n    try {\n      this.props.onError(error, this.props.entry)\n    } catch {\n      // Diagnostics are observational. A broken reporter must never prevent\n      // the next candidate or first-party fallback from rendering.\n    }\n    this.props.onFailed()\n  }\n\n  render(): ReactNode {\n    return this.state.failed ? null : this.props.children\n  }\n}\n\ntype CandidateCellProps = {\n  candidates: readonly SlotEntry[]\n  fallback?: ReactNode\n  owner: Readonly<Record<string, unknown>>\n  renderSlot: SlotRenderFunction<any>\n  translate: SlotTranslate\n  onError: SlotDiagnostics\n}\n\nfunction CandidateRenderer({\n  entry,\n  owner,\n  renderSlot,\n  translate,\n}: Pick<CandidateCellProps, \"owner\" | \"renderSlot\" | \"translate\"> & { entry: SlotEntry }) {\n  const injected = entry.inject?.()\n  if (injected !== undefined && (injected === null || typeof injected !== \"object\" || Array.isArray(injected))) {\n    throw new Error(`Slot \"${entry.name}\" inject must return an object`)\n  }\n  for (const key of Object.keys(injected ?? {})) {\n    if (key === \"renderSlot\" || key === \"t\" || Object.hasOwn(owner, key)) {\n      throw new Error(`Slot \"${entry.name}\" inject conflicts with owner prop: ${key}`)\n    }\n  }\n\n  const Renderer = entry.renderer as ComponentType<Record<string, unknown>>\n  const t: SlotTranslator = (key, values) => translate(entry.locale, key, values)\n  return <Renderer {...injected} {...owner} renderSlot={renderSlot} t={t} />\n}\n\nfunction CandidateCell({ candidates, fallback = null, owner, renderSlot, translate, onError }: CandidateCellProps) {\n  const [failedCount, setFailedCount] = useState(0)\n  const entry = candidates[failedCount]\n  if (!entry) return fallback\n\n  return (\n    <SlotErrorBoundary\n      key={entry.sequence}\n      entry={entry}\n      onError={onError}\n      onFailed={() => setFailedCount((count) => count + 1)}\n    >\n      <CandidateRenderer entry={entry} owner={owner} renderSlot={renderSlot} translate={translate} />\n    </SlotErrorBoundary>\n  )\n}\n\ntype CommonSlotOutletProps<Name extends SlotName> = {\n  name: Name\n  owner: SlotOwnerOf<Name>\n  fallback?: ReactNode\n  renderSlot?: SlotRenderFunction<Extract<SlotChildOf<Name>, SlotName>>\n  onError?: SlotDiagnostics\n}\n\nexport type SlotOutletProps<Name extends SlotName> = SlotDeclOf<Name>[\"kind\"] extends \"keyed\"\n  ? CommonSlotOutletProps<Name> & { entryKey: SlotEntryKeyOf<Name> }\n  : CommonSlotOutletProps<Name> & { entryKey?: never }\n\nfunction groupByCell(entries: readonly SlotEntry[]): Array<[string, SlotEntry[]]> {\n  const cells = new Map<string, SlotEntry[]>()\n  for (const entry of entries) {\n    const cell =\n      entry.kind === \"list\" ? (entry.id as string) : entry.kind === \"keyed\" ? (entry.key as string) : \"single\"\n    const candidates = cells.get(cell)\n    if (candidates) candidates.push(entry)\n    else cells.set(cell, [entry])\n  }\n  return [...cells.entries()]\n}\n\nexport function SlotOutlet<Name extends SlotName>({\n  name,\n  owner,\n  entryKey,\n  fallback,\n  renderSlot = () => null,\n  onError = (error, entry) => console.error(`[SlotOutlet] ${entry.name} failed`, error),\n}: SlotOutletProps<Name>) {\n  const core = useHostSlotCore()\n  const translate = useContext(SlotTranslateContext)\n  const subscribe = useCallback((callback: () => void) => core.subscribe(name, callback), [core, name])\n  const getSnapshot = useCallback(() => core.versionOf(name), [core, name])\n  const version = useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n\n  const entries = useMemo(() => {\n    for (const kind of [\"single\", \"list\", \"keyed\"] as const) {\n      try {\n        return core.entriesOf(name, kind)\n      } catch {\n        // The runtime declaration is authoritative; try the next kind.\n      }\n    }\n    return []\n  }, [core, name, version])\n\n  if (entries.length === 0) return fallback ?? null\n  const kind = entries[0]?.kind\n  const ownerRecord = owner as Readonly<Record<string, unknown>>\n\n  if (kind === \"single\") {\n    return (\n      <CandidateCell\n        key={`${name}:single:${version}`}\n        candidates={entries}\n        fallback={fallback}\n        owner={ownerRecord}\n        renderSlot={renderSlot}\n        translate={translate}\n        onError={onError}\n      />\n    )\n  }\n\n  if (kind === \"keyed\") {\n    const candidates = entries.filter((entry) => entry.key === entryKey)\n    return (\n      <CandidateCell\n        key={`${name}:${String(entryKey)}:${version}`}\n        candidates={candidates}\n        fallback={fallback}\n        owner={ownerRecord}\n        renderSlot={renderSlot}\n        translate={translate}\n        onError={onError}\n      />\n    )\n  }\n\n  return groupByCell(entries).map(([cell, candidates]) =>\n    createElement(CandidateCell, {\n      key: `${name}:${cell}:${version}`,\n      candidates,\n      owner: ownerRecord,\n      renderSlot,\n      translate,\n      onError,\n    }),\n  )\n}\n"],"mappings":"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","names":["kind"]}

package/dist/tailwind.css

@@ -0,0 +1,137 @@
+/* Orbitwork Design System — Tailwind v4 theme mapping
+ *
+ * Maps CSS custom properties to Tailwind theme keys.
+ *
+ * ⚠️  Generated by scripts/generate-tokens-css.mjs from src/tokens/.
+ *     Do not edit this file directly.
+ */
+@theme inline {
+  --color-ow-bg: var(--ow-bg);
+  --color-ow-success: var(--ow-success);
+  --color-ow-warning: var(--ow-warning);
+  --color-ow-error: var(--ow-error);
+  --color-ow-info: var(--ow-info);
+  --color-ow-info-border: var(--ow-info-border);
+  --color-ow-pending: var(--ow-pending);
+  --color-ow-control-on: var(--ow-control-on);
+  --color-ow-control-on-glyph: var(--ow-control-on-glyph);
+  --color-ow-control-off: var(--ow-control-off);
+  --color-ow-control-knob: var(--ow-control-knob);
+  --color-ow-link: var(--ow-link);
+  --color-ow-link-hover: var(--ow-link-hover);
+  --color-ow-scrollbar: var(--ow-scrollbar);
+  --color-ow-scrollbar-hover: var(--ow-scrollbar-hover);
+  --color-ow-border: var(--ow-border);
+  --color-ow-hover: var(--ow-hover);
+  --color-ow-press: var(--ow-press);
+  --color-ow-hover-pop: var(--ow-hover-pop);
+  --color-ow-press-pop: var(--ow-press-pop);
+  --color-ow-selected-bg: var(--ow-selected-bg);
+  --color-ow-current-bg: var(--ow-current-bg);
+  --color-ow-graphite: var(--ow-graphite);
+  --color-ow-popover-bg: var(--ow-popover-bg);
+  --color-ow-tooltip-bg: var(--ow-tooltip-bg);
+  --color-ow-tooltip-text: var(--ow-tooltip-text);
+  --color-ow-surface: var(--ow-surface);
+  --color-ow-surface-2: var(--ow-surface-2);
+  --color-ow-border-strong: var(--ow-border-strong);
+  --color-ow-text: var(--ow-text);
+  --color-ow-text-2: var(--ow-text-2);
+  --color-ow-text-3: var(--ow-text-3);
+  --color-ow-error-on-tint: var(--ow-error-on-tint);
+  --color-ow-success-on-tint: var(--ow-success-on-tint);
+  --color-ow-warning-on-tint: var(--ow-warning-on-tint);
+  --color-ow-info-on-tint: var(--ow-info-on-tint);
+  --color-ow-badge-error-bg: var(--ow-badge-error-bg);
+  --color-ow-badge-error-border: var(--ow-badge-error-border);
+  --color-ow-badge-error-fg: var(--ow-badge-error-fg);
+  --color-ow-badge-normal-bg: var(--ow-badge-normal-bg);
+  --color-ow-badge-normal-border: var(--ow-badge-normal-border);
+  --color-ow-badge-normal-fg: var(--ow-badge-normal-fg);
+  --color-ow-badge-pending-bg: var(--ow-badge-pending-bg);
+  --color-ow-badge-pending-border: var(--ow-badge-pending-border);
+  --color-ow-badge-pending-fg: var(--ow-badge-pending-fg);
+  --color-ow-badge-success-bg: var(--ow-badge-success-bg);
+  --color-ow-badge-success-border: var(--ow-badge-success-border);
+  --color-ow-badge-success-fg: var(--ow-badge-success-fg);
+  --color-ow-badge-warning-bg: var(--ow-badge-warning-bg);
+  --color-ow-badge-warning-border: var(--ow-badge-warning-border);
+  --color-ow-badge-warning-fg: var(--ow-badge-warning-fg);
+  --color-ow-diff-add-bg: var(--ow-diff-add-bg);
+  --color-ow-diff-add-fg: var(--ow-diff-add-fg);
+  --color-ow-diff-del-bg: var(--ow-diff-del-bg);
+  --color-ow-diff-del-fg: var(--ow-diff-del-fg);
+  --color-ow-diff-hunk-bg: var(--ow-diff-hunk-bg);
+  --color-ow-diff-hunk-fg: var(--ow-diff-hunk-fg);
+  --color-ow-btn-primary-bg: var(--ow-btn-primary-bg);
+  --color-ow-btn-primary-hover: var(--ow-btn-primary-hover);
+  --color-ow-btn-primary-press: var(--ow-btn-primary-press);
+  --color-ow-btn-primary-fg: var(--ow-btn-primary-fg);
+  --color-ow-btn-danger-bg: var(--ow-btn-danger-bg);
+  --color-ow-btn-danger-hover: var(--ow-btn-danger-hover);
+  --color-ow-btn-danger-press: var(--ow-btn-danger-press);
+  --color-ow-btn-danger-fg: var(--ow-btn-danger-fg);
+  --color-ow-input-border: var(--ow-input-border);
+  --color-ow-input-border-hover: var(--ow-input-border-hover);
+  --color-ow-input-border-focus: var(--ow-input-border-focus);
+  --color-background: var(--ow-bg);
+  --color-foreground: var(--ow-text);
+  --color-card: var(--ow-surface);
+  --color-card-foreground: var(--ow-text);
+  --color-popover: var(--ow-popover-bg);
+  --color-popover-foreground: var(--ow-text);
+  --color-secondary: var(--ow-surface-2);
+  --color-secondary-foreground: var(--ow-text);
+  --color-muted: var(--ow-surface-2);
+  --color-muted-foreground: var(--ow-text-3);
+  --color-accent: var(--ow-surface-2);
+  --color-accent-foreground: var(--ow-text);
+  --color-destructive: var(--ow-error);
+  --color-destructive-foreground: var(--ow-on-fill);
+  --color-border: var(--ow-border);
+  --color-input: var(--ow-input-border);
+  --color-ring: var(--ow-focus-ring);
+  --radius-action: var(--ow-radius-action);
+  --radius-control: var(--ow-radius-control);
+  --radius-card: var(--ow-radius-card);
+  --radius-pill: var(--ow-radius-pill);
+  --radius-2xs: var(--ow-radius-2xs);
+  --radius-xs: var(--ow-radius-xs);
+  --radius-sm: var(--ow-radius-sm);
+  --radius-md: var(--ow-radius-md);
+  --radius-lg: var(--ow-radius-lg);
+  --radius-xl: var(--ow-radius-xl);
+  --radius-2xl: var(--ow-radius-modal);
+  --font-sans: var(--ow-font-sans);
+  --font-mono: var(--ow-font-mono);
+  --font-weight-normal: var(--ow-font-weight-normal);
+  --font-weight-medium: var(--ow-font-weight-medium);
+  --font-weight-semibold: var(--ow-font-weight-semibold);
+  --font-weight-bold: var(--ow-font-weight-bold);
+  --text-ow-fs-display: var(--ow-fs-display);
+  --text-ow-fs-headline: var(--ow-fs-headline);
+  --text-ow-fs-headline-lg: var(--ow-fs-headline-lg);
+  --text-ow-fs-headline-md: var(--ow-fs-headline-md);
+  --text-ow-fs-headline-sm: var(--ow-fs-headline-sm);
+  --text-ow-fs-title: var(--ow-fs-title);
+  --text-ow-fs-title-lg: var(--ow-fs-title-lg);
+  --text-ow-fs-title-md: var(--ow-fs-title-md);
+  --text-ow-fs-title-sm: var(--ow-fs-title-sm);
+  --text-ow-fs-subtitle: var(--ow-fs-subtitle);
+  --text-ow-fs-body: var(--ow-fs-body);
+  --text-ow-fs-body-lg: var(--ow-fs-body-lg);
+  --text-ow-fs-body-md: var(--ow-fs-body-md);
+  --text-ow-fs-body-sm: var(--ow-fs-body-sm);
+  --text-ow-fs-caption: var(--ow-fs-caption);
+  --text-ow-fs-eyebrow: var(--ow-fs-eyebrow);
+  --text-ow-fs-eyebrow-cjk: var(--ow-fs-eyebrow-cjk);
+  --text-ow-fs-ui: var(--ow-fs-ui);
+  --text-ow-fs-code: var(--ow-fs-code);
+  --text-ow-fs-mark-md: var(--ow-fs-mark-md);
+  --text-ow-fs-mark-sm: var(--ow-fs-mark-sm);
+  --border-width-thin: var(--ow-border-width-thin);
+  --border-width: var(--ow-border-width-default);
+  --border-width-thick: var(--ow-border-width-thick);
+  --opacity-muted: var(--ow-opacity-muted);
+  --opacity-hover: var(--ow-opacity-hover);
+}

package/dist/unifiedTheme-DQ-sETKO.d.cts

@@ -0,0 +1,201 @@
+/** Supported text sizes, independent of the light/dark palette. */
+declare const ORBITWORK_FONT_SCALES: readonly [0.9, 1, 1.1, 1.2];
+type OrbitworkFontScale = (typeof ORBITWORK_FONT_SCALES)[number];
+declare function isOrbitworkFontScale(value: unknown): value is OrbitworkFontScale;
+/** Personal device preference wins over a skin preset; old settings resolve to 100%. */
+declare function resolveOrbitworkFontScale(preference: unknown, skinScale?: unknown): OrbitworkFontScale;
+
+/**
+ * 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;
+    foregroundPrimary?: string;
+    foregroundSecondary?: string;
+    foregroundMuted?: string;
+    borderSubtle?: string;
+    borderStrong?: string;
+    buttonPrimaryBackground?: string;
+    buttonPrimaryForeground?: string;
+    chatBackground?: string;
+    chatBackgroundImage?: string;
+    /** 0–1 decimal string; kept under the legacy chatBackground namespace for skin.json compatibility. */
+    chatBackgroundImageOpacity?: 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;
+};
+/** Maintenance record for each public-part precision selector. */
+type OrbitworkSkinRegistryEntry = {
+    target: string;
+    reason: string;
+};
+type OrbitworkSkin = {
+    version: 1;
+    id: string;
+    name: string;
+    description?: string;
+    /** Uniform text size preset, shared by both color modes. */
+    fontScale?: OrbitworkFontScale;
+    modes: {
+        light?: OrbitworkSkinTokens;
+        dark?: OrbitworkSkinTokens;
+    };
+    contributes?: {
+        /** Registered CSS targeting component roots and their public parts. */
+        publicPartStyles?: string;
+        /** Every public-part selector must have a matching maintenance record. */
+        registry?: OrbitworkSkinRegistryEntry[];
+    };
+};
+type SkinValidationResult = {
+    ok: true;
+    skin: OrbitworkSkin;
+} | {
+    ok: false;
+    error: string;
+};
+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>>;
+/**
+ * Exact precision-style surface maintained by Orbitwork UI.
+ * A data-slot/data-ow-part attribute is not skin-public unless it appears here.
+ * Each target also owns its allowed visual properties so skins cannot turn a
+ * stable selector into an undocumented layout or behavior override.
+ */
+declare const ORBITWORK_SKIN_PUBLIC_PARTS: Readonly<{
+    readonly '[data-slot="artifact-preview-card"] [data-ow-part="meta"]': readonly string[];
+}>;
+/** 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;
+
+/** Runtime layers may override only this complete neutral group. */
+declare const TENANT_THEME_COLOR_KEYS: readonly ["bg", "surface", "surface2", "text", "text2", "text3", "border", "borderStrong"];
+type TenantThemeColors = Record<(typeof TENANT_THEME_COLOR_KEYS)[number], string>;
+/** Localized brand copy. Assets stay outside locale buckets. */
+type TenantBranding = {
+    productName: string;
+    companyName: string;
+    claim?: string;
+    claimNote?: string;
+    slogan?: string;
+};
+type LocalizedBranding = Record<string, TenantBranding>;
+/**
+ * GET /api/v1/tenant/theme response.
+ *
+ * Every supplied mode is a complete neutral group. Keeping light and dark
+ * separate prevents a runtime :root override from leaking one palette into
+ * both DS2 modes.
+ */
+type TenantTheme = {
+    name: string;
+    /** Brand image. Empty string means fall through to the host/brand layer. */
+    logo: string;
+    /** Optional login key-visual photo; empty/absent falls back to the stock KV. */
+    loginKV?: string;
+    favicon?: string;
+    modes: Partial<Record<ResolvedTheme, TenantThemeColors>>;
+    typography: {
+        fontSans: string;
+        fontMono: string;
+    };
+    /** en-US is the required baseline; other locale buckets are optional. */
+    branding: LocalizedBranding;
+};
+declare const UNIFIED_NEUTRAL_TOKENS: readonly ["--ow-bg", "--ow-surface", "--ow-surface-2", "--ow-text", "--ow-text-2", "--ow-text-3", "--ow-border", "--ow-border-strong"];
+declare const BRAND_ACTION_TOKENS: readonly ["--ow-btn-primary-bg", "--ow-btn-primary-hover", "--ow-btn-primary-press", "--ow-btn-primary-fg", "--ow-beacon", "--ow-beacon-idle", "--ow-accent-dot", "--ow-data-today"];
+declare const UNIFIED_TYPOGRAPHY_TOKENS: readonly ["--ow-font-sans", "--ow-font-mono"];
+type UnifiedNeutralToken = (typeof UNIFIED_NEUTRAL_TOKENS)[number];
+type BrandActionToken = (typeof BRAND_ACTION_TOKENS)[number];
+type BrandThemeToken = UnifiedNeutralToken | BrandActionToken;
+type UnifiedTypographyToken = (typeof UNIFIED_TYPOGRAPHY_TOKENS)[number];
+type UnifiedThemeToken = BrandThemeToken | UnifiedTypographyToken;
+/** Build-time validated OEM brand input consumed by the UI merge layer. */
+type BrandTheme = {
+    id: string;
+    logo?: string;
+    /** Optional login key-visual photo (KV board background on the desktop login page). */
+    loginKV?: string;
+    favicon?: string;
+    modes: Partial<Record<ResolvedTheme, Partial<Record<BrandThemeToken, string>>>>;
+    typography?: {
+        fontSans: string;
+        fontMono: string;
+    };
+    /** OEM text-size preset; the personal preference and user skins still win. */
+    fontScale?: OrbitworkFontScale;
+    branding?: LocalizedBranding;
+};
+
+type UnifiedBranding = TenantBranding & {
+    logo?: string;
+    loginKV?: string;
+    favicon?: string;
+};
+type UnifiedTheme = {
+    mode: ResolvedTheme;
+    /** Partial overrides only. DS2 CSS remains the sole source of defaults. */
+    tokens: Readonly<Partial<Record<AppliedThemeToken, string>>>;
+    branding: UnifiedBranding | null;
+    skin: {
+        id: string;
+        publicPartStyles?: string;
+        /** Validated embedded image retained outside CSSOM so the applier can use a short blob URL. */
+        chatBackgroundImage?: string;
+        hasChatBackgroundImage: boolean;
+        hasUserBubbleStyle: boolean;
+    } | null;
+    sources: {
+        brand: string | null;
+        tenant: string | null;
+        user: string | null;
+    };
+};
+type SkinThemeToken = (typeof ORBITWORK_SKIN_CSS_VARIABLES)[keyof typeof ORBITWORK_SKIN_CSS_VARIABLES] | "--ow-chat-bg-mask-start-opacity" | "--ow-chat-bg-mask-end-opacity";
+type AppliedThemeToken = UnifiedThemeToken | SkinThemeToken;
+/** Pick the best localized copy for a locale: canonical, then language, then en-US. */
+declare function localizedCopy(source: LocalizedBranding | undefined, locale: string): TenantBranding | undefined;
+/**
+ * Merge already-validated layers for one resolved color mode.
+ * Priority: personal skin > tenant > OEM brand > DS2 CSS defaults.
+ */
+declare function mergeUnifiedTheme(brand: BrandTheme | null, tenant: TenantTheme | null, userSkin: OrbitworkSkin | null, mode: ResolvedTheme, locale?: string, appearanceOverlaySkin?: OrbitworkSkin | null, fontScalePreference?: OrbitworkFontScale | null): UnifiedTheme;
+
+export { type AppliedThemeToken as A, type BrandTheme as B, ds2ContrastRatio as C, orbitworkSkinImageCssValue as D, type LocalizedBranding as L, MAX_ORBITWORK_SKIN_IMAGE_BYTES as M, type OrbitworkFontScale as O, type ResolvedTheme as R, type SkinValidationResult as S, type TenantBranding as T, type UnifiedTheme as U, type TenantTheme as a, type UnifiedBranding as b, type UnifiedThemeToken as c, type Theme as d, type OrbitworkSkin as e, ORBITWORK_FONT_SCALES as f, type OrbitworkSkinChatBackgroundMask as g, type OrbitworkSkinTokens as h, type TenantThemeColors as i, hasOrbitworkSkinChatBackground as j, isOrbitworkFontScale as k, localizedCopy as l, mergeUnifiedTheme as m, resolveOrbitworkSkinChatBackgroundMask as n, orbitworkSkinChatBackgroundMaskColor as o, parseOrbitworkSkin as p, BRAND_ACTION_TOKENS as q, resolveOrbitworkFontScale as r, type BrandActionToken as s, type BrandThemeToken as t, ORBITWORK_SKIN_CSS_VARIABLES as u, ORBITWORK_SKIN_PUBLIC_PARTS as v, UNIFIED_NEUTRAL_TOKENS as w, UNIFIED_TYPOGRAPHY_TOKENS as x, type UnifiedNeutralToken as y, type UnifiedTypographyToken as z };

package/dist/unifiedTheme-DQ-sETKO.d.ts

@@ -0,0 +1,201 @@
+/** Supported text sizes, independent of the light/dark palette. */
+declare const ORBITWORK_FONT_SCALES: readonly [0.9, 1, 1.1, 1.2];
+type OrbitworkFontScale = (typeof ORBITWORK_FONT_SCALES)[number];
+declare function isOrbitworkFontScale(value: unknown): value is OrbitworkFontScale;
+/** Personal device preference wins over a skin preset; old settings resolve to 100%. */
+declare function resolveOrbitworkFontScale(preference: unknown, skinScale?: unknown): OrbitworkFontScale;
+
+/**
+ * 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;
+    foregroundPrimary?: string;
+    foregroundSecondary?: string;
+    foregroundMuted?: string;
+    borderSubtle?: string;
+    borderStrong?: string;
+    buttonPrimaryBackground?: string;
+    buttonPrimaryForeground?: string;
+    chatBackground?: string;
+    chatBackgroundImage?: string;
+    /** 0–1 decimal string; kept under the legacy chatBackground namespace for skin.json compatibility. */
+    chatBackgroundImageOpacity?: 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;
+};
+/** Maintenance record for each public-part precision selector. */
+type OrbitworkSkinRegistryEntry = {
+    target: string;
+    reason: string;
+};
+type OrbitworkSkin = {
+    version: 1;
+    id: string;
+    name: string;
+    description?: string;
+    /** Uniform text size preset, shared by both color modes. */
+    fontScale?: OrbitworkFontScale;
+    modes: {
+        light?: OrbitworkSkinTokens;
+        dark?: OrbitworkSkinTokens;
+    };
+    contributes?: {
+        /** Registered CSS targeting component roots and their public parts. */
+        publicPartStyles?: string;
+        /** Every public-part selector must have a matching maintenance record. */
+        registry?: OrbitworkSkinRegistryEntry[];
+    };
+};
+type SkinValidationResult = {
+    ok: true;
+    skin: OrbitworkSkin;
+} | {
+    ok: false;
+    error: string;
+};
+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>>;
+/**
+ * Exact precision-style surface maintained by Orbitwork UI.
+ * A data-slot/data-ow-part attribute is not skin-public unless it appears here.
+ * Each target also owns its allowed visual properties so skins cannot turn a
+ * stable selector into an undocumented layout or behavior override.
+ */
+declare const ORBITWORK_SKIN_PUBLIC_PARTS: Readonly<{
+    readonly '[data-slot="artifact-preview-card"] [data-ow-part="meta"]': readonly string[];
+}>;
+/** 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;
+
+/** Runtime layers may override only this complete neutral group. */
+declare const TENANT_THEME_COLOR_KEYS: readonly ["bg", "surface", "surface2", "text", "text2", "text3", "border", "borderStrong"];
+type TenantThemeColors = Record<(typeof TENANT_THEME_COLOR_KEYS)[number], string>;
+/** Localized brand copy. Assets stay outside locale buckets. */
+type TenantBranding = {
+    productName: string;
+    companyName: string;
+    claim?: string;
+    claimNote?: string;
+    slogan?: string;
+};
+type LocalizedBranding = Record<string, TenantBranding>;
+/**
+ * GET /api/v1/tenant/theme response.
+ *
+ * Every supplied mode is a complete neutral group. Keeping light and dark
+ * separate prevents a runtime :root override from leaking one palette into
+ * both DS2 modes.
+ */
+type TenantTheme = {
+    name: string;
+    /** Brand image. Empty string means fall through to the host/brand layer. */
+    logo: string;
+    /** Optional login key-visual photo; empty/absent falls back to the stock KV. */
+    loginKV?: string;
+    favicon?: string;
+    modes: Partial<Record<ResolvedTheme, TenantThemeColors>>;
+    typography: {
+        fontSans: string;
+        fontMono: string;
+    };
+    /** en-US is the required baseline; other locale buckets are optional. */
+    branding: LocalizedBranding;
+};
+declare const UNIFIED_NEUTRAL_TOKENS: readonly ["--ow-bg", "--ow-surface", "--ow-surface-2", "--ow-text", "--ow-text-2", "--ow-text-3", "--ow-border", "--ow-border-strong"];
+declare const BRAND_ACTION_TOKENS: readonly ["--ow-btn-primary-bg", "--ow-btn-primary-hover", "--ow-btn-primary-press", "--ow-btn-primary-fg", "--ow-beacon", "--ow-beacon-idle", "--ow-accent-dot", "--ow-data-today"];
+declare const UNIFIED_TYPOGRAPHY_TOKENS: readonly ["--ow-font-sans", "--ow-font-mono"];
+type UnifiedNeutralToken = (typeof UNIFIED_NEUTRAL_TOKENS)[number];
+type BrandActionToken = (typeof BRAND_ACTION_TOKENS)[number];
+type BrandThemeToken = UnifiedNeutralToken | BrandActionToken;
+type UnifiedTypographyToken = (typeof UNIFIED_TYPOGRAPHY_TOKENS)[number];
+type UnifiedThemeToken = BrandThemeToken | UnifiedTypographyToken;
+/** Build-time validated OEM brand input consumed by the UI merge layer. */
+type BrandTheme = {
+    id: string;
+    logo?: string;
+    /** Optional login key-visual photo (KV board background on the desktop login page). */
+    loginKV?: string;
+    favicon?: string;
+    modes: Partial<Record<ResolvedTheme, Partial<Record<BrandThemeToken, string>>>>;
+    typography?: {
+        fontSans: string;
+        fontMono: string;
+    };
+    /** OEM text-size preset; the personal preference and user skins still win. */
+    fontScale?: OrbitworkFontScale;
+    branding?: LocalizedBranding;
+};
+
+type UnifiedBranding = TenantBranding & {
+    logo?: string;
+    loginKV?: string;
+    favicon?: string;
+};
+type UnifiedTheme = {
+    mode: ResolvedTheme;
+    /** Partial overrides only. DS2 CSS remains the sole source of defaults. */
+    tokens: Readonly<Partial<Record<AppliedThemeToken, string>>>;
+    branding: UnifiedBranding | null;
+    skin: {
+        id: string;
+        publicPartStyles?: string;
+        /** Validated embedded image retained outside CSSOM so the applier can use a short blob URL. */
+        chatBackgroundImage?: string;
+        hasChatBackgroundImage: boolean;
+        hasUserBubbleStyle: boolean;
+    } | null;
+    sources: {
+        brand: string | null;
+        tenant: string | null;
+        user: string | null;
+    };
+};
+type SkinThemeToken = (typeof ORBITWORK_SKIN_CSS_VARIABLES)[keyof typeof ORBITWORK_SKIN_CSS_VARIABLES] | "--ow-chat-bg-mask-start-opacity" | "--ow-chat-bg-mask-end-opacity";
+type AppliedThemeToken = UnifiedThemeToken | SkinThemeToken;
+/** Pick the best localized copy for a locale: canonical, then language, then en-US. */
+declare function localizedCopy(source: LocalizedBranding | undefined, locale: string): TenantBranding | undefined;
+/**
+ * Merge already-validated layers for one resolved color mode.
+ * Priority: personal skin > tenant > OEM brand > DS2 CSS defaults.
+ */
+declare function mergeUnifiedTheme(brand: BrandTheme | null, tenant: TenantTheme | null, userSkin: OrbitworkSkin | null, mode: ResolvedTheme, locale?: string, appearanceOverlaySkin?: OrbitworkSkin | null, fontScalePreference?: OrbitworkFontScale | null): UnifiedTheme;
+
+export { type AppliedThemeToken as A, type BrandTheme as B, ds2ContrastRatio as C, orbitworkSkinImageCssValue as D, type LocalizedBranding as L, MAX_ORBITWORK_SKIN_IMAGE_BYTES as M, type OrbitworkFontScale as O, type ResolvedTheme as R, type SkinValidationResult as S, type TenantBranding as T, type UnifiedTheme as U, type TenantTheme as a, type UnifiedBranding as b, type UnifiedThemeToken as c, type Theme as d, type OrbitworkSkin as e, ORBITWORK_FONT_SCALES as f, type OrbitworkSkinChatBackgroundMask as g, type OrbitworkSkinTokens as h, type TenantThemeColors as i, hasOrbitworkSkinChatBackground as j, isOrbitworkFontScale as k, localizedCopy as l, mergeUnifiedTheme as m, resolveOrbitworkSkinChatBackgroundMask as n, orbitworkSkinChatBackgroundMaskColor as o, parseOrbitworkSkin as p, BRAND_ACTION_TOKENS as q, resolveOrbitworkFontScale as r, type BrandActionToken as s, type BrandThemeToken as t, ORBITWORK_SKIN_CSS_VARIABLES as u, ORBITWORK_SKIN_PUBLIC_PARTS as v, UNIFIED_NEUTRAL_TOKENS as w, UNIFIED_TYPOGRAPHY_TOKENS as x, type UnifiedNeutralToken as y, type UnifiedTypographyToken as z };