@orbit-work/ui 0.1.0

package/src/components/domain/chat/Composer/parts/ComposerAudioSpectrum.tsx

@@ -0,0 +1,110 @@
+"use client"
+
+import { type RefObject, useEffect, useRef } from "react"
+import { cn } from "../../../../../lib/utils"
+
+export type ComposerAudioSpectrumProps = {
+  /** Live Web Audio analyser. Sampling and drawing are owned by the component. */
+  analyserRef?: RefObject<AnalyserNode | null>
+  /** Static normalized values for previews, tests, or non-Web-Audio clients. */
+  levels?: readonly number[]
+  className?: string
+  "aria-label"?: string
+}
+
+/**
+ * ComposerAudioSpectrum —— 语音输入的滚动频谱（Composer 簇内部件）。
+ *
+ * 取色走 `--ow-composer-spectrum-fill`（components.css 里按主题给值），画布只读 CSS 变量，
+ * 组件内零裸色；§5 无渐变——两端同色的双色填充已退役，直接平涂单色。
+ * 频谱是「正在录」的形编码之一，配合麦克风按钮的选中态构成 R1 双编码。
+ */
+export function ComposerAudioSpectrum({
+  analyserRef,
+  levels,
+  className = "",
+  "aria-label": ariaLabel = "语音输入频谱",
+}: ComposerAudioSpectrumProps) {
+  const canvasRef = useRef<HTMLCanvasElement | null>(null)
+
+  useEffect(() => {
+    const canvas = canvasRef.current
+    const context = canvas?.getContext("2d")
+    if (!canvas || !context) return
+
+    const dpr = window.devicePixelRatio || 1
+    const timeDomain = new Uint8Array(512)
+    const samples: number[] = levels ? [...levels] : []
+    let animationFrame = 0
+    let frame = 0
+
+    const resize = () => {
+      const rect = canvas.getBoundingClientRect()
+      canvas.width = Math.max(1, Math.round(rect.width * dpr))
+      canvas.height = Math.max(1, Math.round(rect.height * dpr))
+    }
+    resize()
+    const observer = typeof ResizeObserver === "undefined" ? undefined : new ResizeObserver(resize)
+    observer?.observe(canvas)
+
+    const currentLevel = () => {
+      const analyser = analyserRef?.current
+      if (!analyser) return 0
+      analyser.getByteTimeDomainData(timeDomain)
+      let sum = 0
+      for (const sample of timeDomain) {
+        const deviation = (sample - 128) / 128
+        sum += deviation * deviation
+      }
+      const rms = Math.sqrt(sum / timeDomain.length)
+      if (rms < 0.015) return 0
+      return Math.min(1, (rms - 0.015) / 0.18) ** 0.7
+    }
+
+    const draw = () => {
+      animationFrame = requestAnimationFrame(draw)
+      frame += 1
+      if (!levels && frame % 8 === 0) samples.push(currentLevel())
+
+      const { width, height } = canvas
+      context.clearRect(0, 0, width, height)
+      const styles = getComputedStyle(canvas)
+      const fill = styles.getPropertyValue("--ow-composer-spectrum-fill").trim() || styles.color
+      const barWidth = 3 * dpr
+      const gap = 3.5 * dpr
+      const step = barWidth + gap
+      const count = Math.max(8, Math.floor((width + gap) / step))
+      while (samples.length < count) samples.unshift(0)
+      while (samples.length > count) samples.shift()
+
+      // §5「无渐变」：频谱条平涂单色，取所在主题的 --ow-composer-spectrum-fill。
+      context.fillStyle = fill
+      const center = height / 2
+      for (let index = 0; index < samples.length; index += 1) {
+        const level = Math.max(0, Math.min(1, samples[index] ?? 0))
+        const x = width - (samples.length - index) * step
+        if (x + barWidth < 0) continue
+        const barHeight = level <= 0 ? 2 * dpr : Math.max(4 * dpr, level * height)
+        context.beginPath()
+        context.roundRect(x, center - barHeight / 2, barWidth, barHeight, Math.min(barWidth, barHeight) / 2)
+        context.fill()
+      }
+    }
+
+    draw()
+    return () => {
+      cancelAnimationFrame(animationFrame)
+      observer?.disconnect()
+    }
+  }, [analyserRef, levels])
+
+  return (
+    <canvas
+      ref={canvasRef}
+      data-slot="composer-audio-spectrum"
+      className={cn(className)}
+      role="img"
+      aria-label={ariaLabel}
+    />
+  )
+}

package/src/components/domain/chat/Composer/parts/ComposerAudioSpectrumSource.test.mjs

@@ -0,0 +1,54 @@
+import assert from "node:assert/strict"
+import { readFile } from "node:fs/promises"
+import test from "node:test"
+
+const source = await readFile(new URL("./ComposerAudioSpectrum.tsx", import.meta.url), "utf8")
+const css = await readFile(new URL("../../../../../../styles/components.css", import.meta.url), "utf8")
+const stories = await readFile(new URL("./ComposerAudioSpectrum.stories.tsx", import.meta.url), "utf8")
+
+// W5 终扫：§5「无内阴影无发光无渐变」。浅档原来 primary→wave-active 双色横向渐变，
+// 暗档两端早已同色（即已平涂），两档口径合一成单色平涂。
+test("§5 无渐变：频谱条平涂单色，createLinearGradient 退役", () => {
+  assert.doesNotMatch(source, /createLinearGradient|addColorStop/)
+  assert.match(source, /context\.fillStyle = fill/)
+})
+
+test("取色仍全部走 CSS 变量，组件内零裸色", () => {
+  assert.match(source, /getPropertyValue\("--ow-composer-spectrum-fill"\)/)
+  assert.doesNotMatch(source, /#[0-9a-fA-F]{3,8}\b/)
+})
+
+test("components.css 只留一个平涂色位，浅/暗两档不再各说各话", () => {
+  assert.match(css, /--ow-composer-spectrum-fill: var\(--ow-text\);/)
+  assert.doesNotMatch(css, /--ow-composer-spectrum-(?:start|end)/)
+})
+
+/* ── R2 复审批 ───────────────────────────────────────────────── */
+
+// 同一枚画布原来存 32（静息）/ 36（录音态）两个高度，还比同排的 Button ghost·sm(28) 高一头。
+test("R2：频谱画布只有一个高度 32，录音态只横向铺开", () => {
+  const rest = /\[data-slot="composer-audio-spectrum"\] \{[^}]*\}/.exec(css)
+  assert.ok(rest, "缺 composer-audio-spectrum 基态规则")
+  assert.match(rest[0], /height: 32px;/)
+  const active =
+    /\[data-slot="composer-voice"\]\[data-ow-state="active"\] \[data-slot="composer-audio-spectrum"\] \{[^}]*\}/.exec(
+      css,
+    )
+  assert.ok(active, "缺录音态规则")
+  assert.match(active[0], /height: 32px;/)
+  assert.match(active[0], /flex: 1 1 auto;/)
+  assert.doesNotMatch(active[0], /height: 36px;/)
+})
+
+// 去痕轮口径「新旧写法并存 / 死代码残留」：.ow-composer-voice.is-active 那五条与
+// data-slot/data-ow-state 五条逐条重复，且全仓源码对该类零消费。
+test("R2 死代码：legacy .ow-composer-voice.is-active 镜像选择器已清", () => {
+  assert.doesNotMatch(css, /\.ow-composer-voice\.is-active/)
+})
+
+// 演示标签中文化 + 走字阶（原为英文 "Low/Medium/High activity" ＋ 裸 fontSize 12）。
+test("R2 fixture：演示标签中文 ＋ --ow-fs-body-sm，aria-label 覆盖值也中文", () => {
+  assert.doesNotMatch(stories, /Low activity|Medium activity|High activity/)
+  assert.doesNotMatch(stories, /Audio input visualization/)
+  assert.match(stories, /fontSize: "var\(--ow-fs-body-sm\)"/)
+})

package/src/components/domain/chat/Composer/parts/ComposerAuthorization.stories.tsx

@@ -0,0 +1,155 @@
+import type { Meta, StoryObj } from "@storybook/react"
+import { Lock, Shield, Unlock } from "../../../../composite/Icons"
+import { ComposerAuthorization } from "./ComposerAuthorization"
+
+const meta = {
+  title: "Chat/ComposerAuthorization",
+  component: ComposerAuthorization,
+  decorators: [
+    (Story) => (
+      <div style={{ padding: 40, background: "var(--ow-bg)", minHeight: 400 }}>
+        <Story />
+      </div>
+    ),
+  ],
+} satisfies Meta<typeof ComposerAuthorization>
+
+export default meta
+type Story = StoryObj<typeof meta>
+
+const mockOptions = [
+  {
+    value: "auto",
+    label: "自动授权",
+    description: "根据操作风险自动决定",
+    icon: <Shield />,
+  },
+  {
+    value: "prompt",
+    label: "每次询问",
+    description: "每个操作都需要确认",
+    icon: <Lock />,
+  },
+  {
+    value: "allow",
+    label: "始终允许",
+    description: "所有操作自动执行",
+    icon: <Lock />,
+  },
+]
+
+export const Default: Story = {
+  args: {
+    value: "auto",
+    options: mockOptions,
+    onChange: (value) => console.log("Change:", value),
+  },
+}
+
+export const Open: Story = {
+  args: {
+    value: "auto",
+    options: mockOptions,
+    defaultOpen: true,
+    onChange: (value) => console.log("Change:", value),
+  },
+}
+
+export const PromptMode: Story = {
+  args: {
+    value: "prompt",
+    options: mockOptions,
+    onChange: (value) => console.log("Change:", value),
+  },
+}
+
+export const AllowMode: Story = {
+  args: {
+    value: "allow",
+    options: mockOptions,
+    onChange: (value) => console.log("Change:", value),
+  },
+}
+
+export const CustomTitle: Story = {
+  args: {
+    value: "auto",
+    options: mockOptions,
+    title: "选择授权策略",
+    menuHeader: "授权策略",
+    onChange: (value) => console.log("Change:", value),
+  },
+}
+
+export const Disabled: Story = {
+  args: {
+    value: "auto",
+    options: mockOptions,
+    disabled: true,
+    onChange: (value) => console.log("Change:", value),
+  },
+}
+
+export const WithDisabledOption: Story = {
+  args: {
+    value: "auto",
+    options: [
+      ...mockOptions,
+      {
+        value: "custom",
+        label: "自定义规则",
+        description: "配置细粒度权限（企业版）",
+        disabled: true,
+      },
+    ],
+    onChange: (value) => console.log("Change:", value),
+  },
+}
+
+export const SimpleOptions: Story = {
+  args: {
+    value: "read",
+    options: [
+      { value: "read", label: "只读" },
+      { value: "write", label: "读写" },
+      { value: "admin", label: "管理员" },
+    ],
+    onChange: (value) => console.log("Change:", value),
+  },
+}
+
+export const LongLabels: Story = {
+  args: {
+    value: "balanced",
+    options: [
+      {
+        value: "strict",
+        label: "严格模式",
+        description: "最高安全级别，所有操作都需要明确授权",
+      },
+      {
+        value: "balanced",
+        label: "平衡模式",
+        description: "平衡安全性和便利性，低风险操作自动执行",
+      },
+      {
+        value: "permissive",
+        label: "宽松模式",
+        description: "优先便利性，大部分操作自动执行",
+      },
+    ],
+    onChange: (value) => console.log("Change:", value),
+  },
+}
+
+export const ManyOptions: Story = {
+  args: {
+    value: "level-3",
+    options: Array.from({ length: 8 }, (_, i) => ({
+      value: `level-${i + 1}`,
+      label: `级别 ${i + 1}`,
+      description: `授权级别 ${i + 1} 的描述`,
+    })),
+    onChange: (value) => console.log("Change:", value),
+  },
+}

package/src/components/domain/chat/Composer/parts/ComposerAuthorization.tsx

@@ -0,0 +1,108 @@
+"use client"
+
+import { type ReactNode, useCallback, useState } from "react"
+import { cn } from "../../../../../lib/utils"
+import { ChevDown, Shield } from "../../../../composite/Icons"
+import { Button } from "../../../../primitives"
+import { Menu } from "../../../../primitives/Menu"
+
+export interface ComposerAuthorizationOption<T extends string = string> {
+  value: T
+  label: ReactNode
+  description?: string
+  icon?: ReactNode
+  disabled?: boolean
+}
+
+export interface ComposerAuthorizationProps<T extends string = string> {
+  value: T
+  options: ComposerAuthorizationOption<T>[]
+  open?: boolean
+  defaultOpen?: boolean
+  onOpenChange?: (open: boolean) => void
+  onChange?: (value: T) => void
+  title?: string
+  menuHeader?: ReactNode
+  icon?: ReactNode
+  disabled?: boolean
+  className?: string
+}
+
+/**
+ * ComposerAuthorization —— Composer 页脚的授权模式选择（Composer 簇内部件）。
+ *
+ * 开合、外点关闭、Esc 归位、键盘导航、弹层立面（popover 面 ＋ pop 影 ＋ 1px 边，
+ * 行 hover 走 -pop 档）全部由 `primitives/Menu` 承担；本件只剩触发器与选项映射。
+ * 触发器走 ghost 正规变体，§6 的 hover / press / focus-visible / disabled 由原语补齐。
+ */
+export function ComposerAuthorization<T extends string = string>({
+  value,
+  options,
+  open,
+  defaultOpen = false,
+  onOpenChange,
+  onChange,
+  title = "授权模式",
+  menuHeader = "授权模式",
+  icon,
+  disabled = false,
+  className = "",
+}: ComposerAuthorizationProps<T>) {
+  const [internalOpen, setInternalOpen] = useState(defaultOpen)
+  const resolvedOpen = open ?? internalOpen
+  const selected = options.find((option) => option.value === value)
+
+  const setOpen = useCallback(
+    (next: boolean) => {
+      if (open === undefined) setInternalOpen(next)
+      onOpenChange?.(next)
+    },
+    [onOpenChange, open],
+  )
+
+  return (
+    <div
+      data-slot="composer-authorization"
+      className={cn("relative inline-flex flex-[0_0_auto] items-center overflow-visible", className)}
+    >
+      <Menu
+        open={resolvedOpen}
+        onOpenChange={setOpen}
+        width={280}
+        header={menuHeader}
+        ariaLabel={title}
+        items={options.map((option) => ({
+          key: option.value,
+          label: option.label,
+          description: option.description,
+          icon: option.icon,
+          disabled: option.disabled,
+          selected: option.value === value,
+        }))}
+        onSelect={(key) => onChange?.(key as T)}
+        trigger={
+          <Button
+            variant="ghost"
+            size="sm"
+            type="button"
+            data-ow-part="trigger"
+            data-ow-state={resolvedOpen ? "open" : undefined}
+            // 静止色不再压成 --ow-text-3（与禁用态同色，用户会以为点不动）——
+            // 走 ghost 原形的 --ow-btn-ghost-fg，hover / open 时再加深到 --ow-text。
+            className="max-w-full font-normal data-[ow-state=open]:text-[color:var(--ow-text)] hover:text-[color:var(--ow-text)]"
+            title={title}
+            disabled={disabled}
+          >
+            <span data-ow-part="icon" className="inline-flex items-center justify-center">
+              {icon ?? selected?.icon ?? <Shield />}
+            </span>
+            <span data-ow-part="label" className="min-w-0 overflow-hidden text-ellipsis whitespace-nowrap">
+              {selected?.label ?? value}
+            </span>
+            <ChevDown className="w-3 h-3 text-current" />
+          </Button>
+        }
+      />
+    </div>
+  )
+}

package/src/components/domain/chat/Composer/parts/ComposerMentions.stories.tsx

@@ -0,0 +1,76 @@
+import type { Meta, StoryObj } from "@storybook/react"
+import { ComposerMentions } from "./ComposerMentions"
+
+const meta = {
+  title: "Chat/ComposerMentions",
+  component: ComposerMentions,
+  parameters: {
+    layout: "padded",
+  },
+  tags: ["autodocs"],
+} satisfies Meta<typeof ComposerMentions>
+
+export default meta
+type Story = StoryObj<typeof meta>
+
+/** 空数组＝组件返回 null，画布上**本就什么都不渲**（挂载区不占位、不留空壳）。
+ *  这一条留着是为了把「无挂载物时不留痕」这条契约钉在故事里，不是渲染坏了。 */
+export const Empty: Story = {
+  parameters: {
+    docs: { description: { story: "无挂载物：组件返回 null，画布为空是预期结果。" } },
+  },
+  args: {
+    mentions: [],
+  },
+}
+
+export const SingleMention: Story = {
+  args: {
+    mentions: [{ id: "1", kind: "file", name: "index.tsx" }],
+    onRemove: (mention, index) => console.log("remove", mention, index),
+  },
+}
+
+export const MultipleMentions: Story = {
+  args: {
+    mentions: [
+      { id: "1", kind: "file", name: "App.tsx" },
+      { id: "2", kind: "folder", name: "components" },
+      { id: "3", kind: "symbol", name: "getUserData" },
+    ],
+    onRemove: (mention, index) => console.log("remove", mention, index),
+  },
+}
+
+export const WithoutRemove: Story = {
+  args: {
+    mentions: [
+      { id: "1", kind: "file", name: "index.tsx" },
+      { id: "2", kind: "folder", name: "src" },
+    ],
+  },
+}
+
+export const ManyMentions: Story = {
+  args: {
+    mentions: [
+      { id: "1", kind: "file", name: "App.tsx" },
+      { id: "2", kind: "file", name: "utils.ts" },
+      { id: "3", kind: "folder", name: "components" },
+      { id: "4", kind: "symbol", name: "fetchData" },
+      { id: "5", kind: "file", name: "config.json" },
+      { id: "6", kind: "folder", name: "hooks" },
+    ],
+    onRemove: (mention, index) => console.log("remove", mention, index),
+  },
+}
+
+export const LongNames: Story = {
+  args: {
+    mentions: [
+      { id: "1", kind: "file", name: "VeryLongComponentNameThatMightOverflow.tsx" },
+      { id: "2", kind: "folder", name: "src/components/features/authentication" },
+    ],
+    onRemove: (mention, index) => console.log("remove", mention, index),
+  },
+}

package/src/components/domain/chat/Composer/parts/ComposerMentions.tsx

@@ -0,0 +1,83 @@
+"use client"
+
+import type { ReactElement } from "react"
+import { Bolt, Doc, Folder, Paperclip, Server, Skill, Terminal } from "../../../../composite/Icons"
+import { Chip } from "../../../../primitives"
+
+export type ComposerMention = {
+  id: string
+  kind: string
+  name: string
+}
+
+export type ComposerMentionsProps = {
+  mentions: readonly ComposerMention[]
+  onRemove?: (mention: ComposerMention, index: number) => void
+}
+
+/**
+ * 类别图标表（W3 判断表「挂载芯片」条）：分类不再靠彩度，靠字形。
+ * 未登记的 kind 落通用挂载物字形，绝不回退成颜色。
+ */
+const KIND_ICON: Record<string, ReactElement> = {
+  skill: <Skill />,
+  command: <Terminal />,
+  "agent-command": <Terminal />,
+  mcp: <Server />,
+  connector: <Server />,
+  agent: <Bolt />,
+  file: <Doc />,
+  folder: <Folder />,
+}
+
+/** 兜底＝通用挂载物字形（回形针）。R2 复审前兜底写的是 <Bolt/>，与 `agent` 同一枚字形，
+ *  未登记的 kind 渲出来与 agent chip 一模一样，「分类只由类别图标区分」在兜底上失效。 */
+function mentionIcon(kind: string): ReactElement {
+  return KIND_ICON[kind.toLowerCase()] ?? <Paperclip />
+}
+
+/**
+ * Mention chips for the Composer context region — 归口到 primitives/Chip。
+ *
+ * 形状由 Chip 自动判：无 `dotTone` 也无 `count` ⇒ `square`，即 6 直角
+ * （`--ow-radius-tag`）；999 胶囊只留给带状态点/计数的 chip（§7）。挂载 chip 两者皆无，
+ * 所以渲出来是 6 直角——R2 复审前这行注释还写着「胶囊 999」，停在 Chip 改口径之前。
+ *
+ * 芯片口径（判断表「挂载芯片」条 / §7）：V1 的技能蓝 · 连接器绿 · 其余灰三色分类退役——
+ * 分类不是状态，不占功能色极。三类同落 info tint，配方由 Chip 原语的 `tone="mention"`
+ * 承担（`--ow-mention-bg` / `--ow-mention-text`，边 `--ow-info-tint-border`；tint 面上的
+ * 子件——前置图标、删除钮——一并收 `-on-tint` 字色，不留 `--ow-text-2/-3` 这类地面档字色，
+ * §2 语义优先），本文件不再手抄 className。类别只由**类别图标**区分，指令文本走 mono。
+ */
+export function ComposerMentions({ mentions, onRemove }: ComposerMentionsProps): ReactElement | null {
+  if (mentions.length === 0) return null
+
+  return (
+    <div data-slot="composer-mentions" className="flex flex-wrap gap-2 py-2">
+      {mentions.map((mention, index) => (
+        <Chip
+          key={`${mention.kind}-${mention.id}`}
+          data-ow-part="mention-chip"
+          data-kind={mention.kind}
+          icon={mentionIcon(mention.kind)}
+          tone="mention"
+          className="font-[family-name:var(--ow-font-mono)] font-normal"
+          title={`${mention.kind} · ${mention.name}`}
+          label={
+            <span data-ow-part="mention" className="inline-flex items-center gap-1 min-w-0">
+              <span data-ow-part="at">@</span>
+              <span data-ow-part="kind" className="font-medium">
+                {mention.kind}
+              </span>
+              <span data-ow-part="value" className="overflow-hidden text-ellipsis">
+                {mention.name}
+              </span>
+            </span>
+          }
+          removeLabel={`移除 ${mention.name}`}
+          onRemove={onRemove ? () => onRemove(mention, index) : undefined}
+        />
+      ))}
+    </div>
+  )
+}

package/src/components/domain/chat/Composer/parts/ComposerMentionsSource.test.mjs

@@ -0,0 +1,85 @@
+import assert from "node:assert/strict"
+import { readFile } from "node:fs/promises"
+import test from "node:test"
+
+const source = await readFile(new URL("./ComposerMentions.tsx", import.meta.url), "utf8")
+// 同一「挂载/提及芯片」母题在桌面面上的两族：编辑器内联芯片与命令面板类别块。
+const desktopStyles = await readFile(new URL("../../../../../../styles/desktop-surfaces.css", import.meta.url), "utf8")
+// tint 配方本体已上收到原语（tone="mention"），在这里一并核，防止配方两处并存。
+const chip = await readFile(new URL("../../../../primitives/Chip/index.tsx", import.meta.url), "utf8")
+
+test("composer mentions delegate chip chrome to primitives/Chip", () => {
+  assert.ok(source.includes("export type ComposerMentionsProps = {"))
+  assert.ok(source.includes('data-slot="composer-mentions"'))
+  assert.ok(source.includes('data-ow-part="mention-chip"'))
+  assert.match(source, /import \{ Chip \} from ['"](?:\.\.\/)+primitives['"]/)
+  assert.ok(source.includes("onRemove(mention, index)"))
+})
+
+test("composer mention keeps mono identity and accessible removal", () => {
+  assert.ok(source.includes("font-[family-name:var(--ow-font-mono)]"))
+  assert.ok(source.includes("removeLabel={`移除 ${mention.name}`}"))
+  assert.ok(source.includes('data-ow-part="kind"'))
+  assert.ok(source.includes('data-ow-part="value"'))
+})
+
+// W3 芯片统一：三色分类退役，统一 info tint + 类别图标（判断表「挂载芯片」条）。
+// R2：tint 配方已上收到 primitives/Chip 的 tone="mention"，本件不再手抄 className——
+// 断言随之分两处：调用点必须传 tone，配方本体在原语里核。
+test("composer mentions land on one info tint", () => {
+  assert.match(source, /tone="mention"/)
+  assert.ok(chip.includes("bg-[var(--ow-mention-bg)]"))
+  assert.ok(chip.includes("text-[color:var(--ow-mention-text)]"))
+  assert.ok(chip.includes("border-[color:var(--ow-info-tint-border)]"))
+  assert.ok(chip.includes("hover:bg-[var(--ow-info-tint-hover)]"))
+  // tint 面上的子件一并收 on-tint 字色，不留地面档 text-2/-3
+  assert.ok(chip.includes("[&_[data-ow-part=icon]]:text-[color:var(--ow-mention-text)]"))
+  assert.ok(chip.includes("[&_[data-ow-part=remove]]:text-[color:var(--ow-mention-text)]"))
+  assert.doesNotMatch(source, /text-ow-text(-[23])?"/)
+})
+
+test("composer mentions carry a category glyph per kind", () => {
+  assert.match(source, /const KIND_ICON: Record<string, ReactElement> = \{/)
+  for (const kind of ["skill", "command", "mcp", "connector", "agent", "file", "folder"]) {
+    assert.ok(source.includes(`${kind.includes("-") ? `"${kind}"` : kind}:`), `${kind} 缺类别图标`)
+  }
+  assert.ok(source.includes("icon={mentionIcon(mention.kind)}"))
+  // 未登记 kind 落**通用挂载物**字形，绝不回退成颜色，也不能与已登记类别撞形：
+  // R2 复审前兜底是 <Bolt/>，与 agent 同一枚，symbol 之类渲出来与 agent chip 无异。
+  assert.ok(source.includes("KIND_ICON[kind.toLowerCase()] ?? <Paperclip />"))
+  assert.doesNotMatch(source, /\?\? <Bolt \/>/)
+})
+
+// W3 芯片统一：编辑器内联芯片（.rich-chip）四色分类退役，类别改由前缀符 + 字族承担。
+test("composer inline chips collapse to one info tint", () => {
+  assert.match(
+    desktopStyles,
+    /\.rich-chip \{[^}]*background: var\(--ow-mention-bg\); color: var\(--ow-mention-text\);[^}]*\}/s,
+  )
+  // 旧四色（skill 蓝 / command 琥珀 / mcp 绿 / agent 紫）不得回流
+  assert.doesNotMatch(
+    desktopStyles,
+    /\.rich-chip--[a-z-]+[^{]*\{[^}]*(?:background|color): var\(--ow-(?:info|success|warning|error|primary)-/s,
+  )
+  // 指令族（`/name`）走 mono，提及族（`@name`）走 sans——R1 第二编码
+  assert.match(
+    desktopStyles,
+    /\.rich-chip--skill, \.rich-chip--command, \.rich-chip--agent-command \{ font-family: var\(--ow-font-mono\); \}/,
+  )
+  assert.match(desktopStyles, /\.rich-chip--mcp, \.rich-chip--agent \{ font-family: var\(--ow-font-sans\); \}/)
+})
+
+// W5 移交 B②：.cmd-* 全族（命令面板下拉 ＋ Composer「+」菜单）全仓零消费方，整族撤——
+// 两处消费方都已改走 composite/CommandPalette。W3 给 .cmd-opt__ic 收的 info tint 随之
+// 退场，断言由「必须是 mention tint」翻成「整族不得再出现」。
+test("command palette category glyph family is gone for good", () => {
+  const rules = desktopStyles.replace(/\/\*[\s\S]*?\*\//g, "")
+  for (const selector of ["\\.cmd-opt", "\\.cmd-list", "\\.cmd-group", "\\.cmd-empty", "\\.cpop--cmd"]) {
+    assert.doesNotMatch(rules, new RegExp(`^\\s*${selector}[\\s.:_{,]`, "m"))
+  }
+  // 挂载芯片的 info tint 口径本身不变，仍由 .rich-chip 承担
+  assert.match(
+    desktopStyles,
+    /\.rich-chip \{[^}]*background: var\(--ow-mention-bg\); color: var\(--ow-mention-text\);/s,
+  )
+})