@q1travel/design-system 0.30.12 → 0.30.13

package/README.md

@@ -71,7 +71,7 @@ root.render(
 | --- | --- |
 | `npx q1-design ls` | 列出包内提供的组件、hook 与应用模板 |
 | `npx q1-design doc <组件名>` | 打印组件的公共 API；`doc app-base` 查看应用基础样式模板 |
-| `npx q1-design lint [路径...]` | 按 `Q1-DS-*` 规则检查样式用法，默认扫描 `src` |
+| `npx q1-design lint [路径...]` | 按 `Q1-DS-*` 规则检查样式和组件枚举字面量，默认扫描 `src` |
 | `npx q1-design lint --diff <base-ref>` | 只检查相对 `base-ref` 有改动的文件 |
 | `npx q1-design overrides [路径...]` | 统计对组件外观的 `className` 覆写 |
 | `npx q1-design sync` | 将设计契约与 AI 编码指南同步为项目内的只读缓存 |

package/bin/lint-component-enums.mjs

@@ -0,0 +1,42 @@
+export const COMPONENT_ENUM_RULE = 'Q1-DS-002';
+
+// Match the CLI's import-based scan; only literal JSX attributes are checked.
+export function lintComponentEnums(source, filename, loadSchema) {
+  const imports = new Map();
+  const importPattern = /import\s*\{([^{}]*?)\}\s*from\s*["']@q1travel\/design-system["']/gs;
+  for (const match of source.matchAll(importPattern)) {
+    for (const part of match[1].split(',')) {
+      if (/^\s*type\s/.test(part)) continue;
+      const [component, local = component] = part.trim().split(/\s+as\s+/);
+      if (/^[A-Z][A-Za-z0-9_]*$/.test(local)) imports.set(local, component);
+    }
+  }
+  for (const match of source.matchAll(/import\s*\*\s*as\s+(\w+)\s*from\s*["']@q1travel\/design-system["']/g)) {
+    imports.set(`${match[1]}.*`, '*');
+  }
+  if (!imports.size) return [];
+  const hits = [];
+  const tagPattern = /<([A-Z][\w.]*)\b((?:"[^"]*"|'[^']*'|\{(?:[^{}]|\{[^{}]*\})*\}|[^>"'{}])*)>/g;
+  for (const tag of source.matchAll(tagPattern)) {
+    const [namespace, member] = tag[1].split('.');
+    const component = member && imports.has(`${namespace}.*`) ? member : imports.get(tag[1]);
+    if (!component) continue;
+    const attributes = /(?:^|\s)(variant|size)\s*=\s*(?:"([^"]*)"|'([^']*)'|\{\s*(?:"([^"]*)"|'([^']*)')\s*\})/g;
+    for (const attribute of tag[2].matchAll(attributes)) {
+      let value = attribute[2] ?? attribute[3] ?? attribute[4] ?? attribute[5];
+      if (attribute[2] !== undefined || attribute[3] !== undefined) {
+        value = value.replace(/&#(x[\da-f]+|\d+);/gi, (_, code) => String.fromCodePoint(code[0].toLowerCase() === 'x' ? parseInt(code.slice(1), 16) : Number(code)));
+      }
+      const allowed = loadSchema()[component]?.[attribute[1]];
+      if (allowed && !allowed.includes(value)) {
+        const offset = tag.index + tag[0].indexOf(tag[2]) + attribute.index;
+        hits.push({
+          ruleId: COMPONENT_ENUM_RULE,
+          lineNumber: source.slice(0, offset + attribute[0].search(/\S/)).split('\n').length,
+          lineContent: `error ${component}.${attribute[1]}=${JSON.stringify(value)}; 允许值: ${allowed.join(' | ')}`,
+        });
+      }
+    }
+  }
+  return hits;
+}

package/bin/q1-design.mjs

@@ -22,6 +22,8 @@ import { createHash } from 'node:crypto';
 import { dirname, extname, isAbsolute, join, relative, resolve, sep } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 
+import { COMPONENT_ENUM_RULE, lintComponentEnums } from './lint-component-enums.mjs';
+
 const PACKAGE_NAME = '@q1travel/design-system';
 const SKILL_RELATIVE_DIR = '.claude/skills/product-design';
 const MANIFEST_FILE_NAME = '.q1-design-manifest.json';
@@ -644,6 +646,17 @@ const LINT_RULES = [
 function collectLintHits(inputPaths, baseDir) {
   const targetFiles = collectLintTargetFiles(inputPaths, baseDir);
   const hits = [];
+  let enumSchema;
+  const loadEnumSchema = () => {
+    if (!enumSchema) {
+      const relativePath = 'dist-pkg/component-enums.json';
+      const packageRoot = resolveInstalledPackageRoot(baseDir) ?? baseDir;
+      const schemaPath = join(packageRoot, relativePath);
+      if (!existsSync(schemaPath)) throw new Error(`[q1-design] 找不到 ${relativePath}，无法检查组件枚举；请安装 ${PACKAGE_NAME} 或先运行 npm run build:lib。`);
+      enumSchema = JSON.parse(readFileSync(schemaPath, 'utf8'));
+    }
+    return enumSchema;
+  };
 
   for (const absoluteFilePath of targetFiles) {
     const fileContent = readFileSync(absoluteFilePath, 'utf8');
@@ -653,6 +666,14 @@ function collectLintHits(inputPaths, baseDir) {
       isTokens: isTokensPath(absoluteFilePath, baseDir),
     };
 
+    if (!fileFacts.isCssFile && !hasFileDisablePragma(fileContent, COMPONENT_ENUM_RULE)) {
+      const isSuppressed = createSuppressionTracker(COMPONENT_ENUM_RULE);
+      const suppressedLines = fileContent.split('\n').map((line) => isSuppressed(line));
+      for (const hit of lintComponentEnums(fileContent, absoluteFilePath, loadEnumSchema)) {
+        if (!suppressedLines[hit.lineNumber - 1]) hits.push({ ...hit, filePath: relativeFilePath });
+      }
+    }
+
     const activeRules = LINT_RULES.map((rule) => ({
       rule,
       applicable: rule.appliesToFile(fileFacts) && !hasFileDisablePragma(fileContent, rule.ruleId),
@@ -717,7 +738,7 @@ function runLint(inputPaths, consumerRootDir, diffBaseRef) {
 
   for (const hit of hits) {
     console.log(
-      `${hit.ruleId} ${hit.filePath}:${hit.lineNumber} ${truncateLine(hit.lineContent)}`,
+      `${hit.ruleId} ${hit.filePath}:${hit.lineNumber} ${hit.ruleId === COMPONENT_ENUM_RULE ? hit.lineContent : truncateLine(hit.lineContent)}`,
     );
   }
   console.log(`[q1-design] 共 ${hits.length} 处命中`);
@@ -1109,7 +1130,12 @@ if (isDirectRun) {
       }
       args.splice(diffIndex, 2);
     }
-    runLint(args.length > 0 ? args : ['src'], consumerRootDir, diffBaseRef);
+    try {
+      runLint(args.length > 0 ? args : ['src'], consumerRootDir, diffBaseRef);
+    } catch (error) {
+      console.error(error.message);
+      process.exit(1);
+    }
   } else if (subcommand === 'eval') {
     runEval();
   } else if (subcommand === 'overrides') {

package/contracts/implementation-map.md

@@ -112,7 +112,7 @@ Timeline / TimelineItem (ol/li, 8px token dot or Avatar), Marker (quiet actor/ti
 
 Accepted 2026-10-07: public `ToggleGroup` names a group of pressable controls with single or multiple selection. Its `items` API exposes `value`, `label`, optional `icon`, `disabled`, and `ariaLabel`; icon-only items require an icon and `ariaLabel`. `type="single"` accepts string `value` / `defaultValue` and `onValueChange`; `allowEmpty` defaults to false. `type="multiple"` accepts string arrays. Controlled values remain caller-owned; uncontrolled single selection falls back to the first enabled item when its value is absent or unknown and empty selection is disallowed. Disabling an existing selected item retains its pressed state and moves only the tabstop. No existing Switch consumer is migrated.
 
-Native buttons expose `aria-pressed` within `role="group"`. Roving tabindex and Arrow / Home / End move focus without selecting; Enter / Space activate through native clicks. Disabled items are skipped. Button-aligned sm32 / md40 / lg48 sizes use existing tokens, quiet selected background and primary text without a selected ring, shared focus shadow, and the shared coarse-pointer 44px TouchTarget with reserved neighbor space. The Tier A keyboard contract lives on `/components/toggle-group`; Switch retains radio semantics and Tabs retains panel semantics.
+Native buttons expose `aria-pressed` within `role="group"`. Roving tabindex and Arrow / Home / End move focus without selecting; Enter / Space activate through native clicks. Disabled items are skipped. Button-aligned sm32 / md40 / lg48 sizes use existing tokens, quiet selected background and primary text with the shared `selection-recipe.css` inset border-strong selection edge (bg-subtle in light, bg-raised in dark); keyboard focus replaces that edge with the shared focus shadow, and the shared coarse-pointer 44px TouchTarget with reserved neighbor space. The Tier A keyboard contract lives on `/components/toggle-group`; Switch retains radio semantics and Tabs retains panel semantics.
 ## Checkbox task completion circle
 - Native base: `src/components/ui/ControlOption.tsx`; circle-only readonly/warning module: `src/components/ui/CircleCheckbox.tsx`; independent style: `src/styles/checkbox-circle.css`, imported at the top of global.css and included by build-style.mjs. Square defaults remain unchanged.
 - Documentation: `src/pages/CheckboxPage.tsx`, `CheckboxCircleDemo.tsx`, `src/styles/checkbox-circle-specimen.css`; circle completion is restricted to tasks/checklists and row completion treatment stays consumer-owned.
@@ -150,3 +150,7 @@ The announcement region wraps only the icon, the `q1-sr-only` 「错误：」 pr
 ## Cascader 层级选择
 
 `Cascader`（`src/components/ui/Cascader.tsx`）负责字段及触发器；`cascader/` 的 Types、model、window、Panel 分别负责受控边界、路径与独立选择、测量窗口、关联 listbox 与搜索。复用 Popover/useOverlay、RegionErrorState 和 Spinner；样式来自既有 surface、text、control、space、radius 与 focus token。窄屏同一弹层单列钻取，亮暗继承 anchor。完整约束、可选省略、公开面与回滚见 [Cascader](./cascader.md)。文档入口 `/components/cascader`，不迁移既有选择器。
+
+## ThemeSwitcher selection appearance
+
+Accepted 2026-11-02 (#761): ThemeSwitcher keeps a single outer group border. Options have no border; selection uses `--q1-color-bg-selected-neutral` and primary text, with no inset selection edge. Unselected options keep secondary text and the container background. Light and dark selected and unselected text meet 4.5:1 contrast; the selected background differs from the container. Native labeled radios retain their keyboard behavior, hover changes enabled option text to primary, and keyboard focus uses the shared focus shadow. Public props, class names, DOM structure, exports, and tokens are unchanged.

package/dist-pkg/component-enums.json

@@ -0,0 +1,284 @@
+{
+  "Badge": {
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "Book": {
+    "variant": [
+      "stripe",
+      "simple"
+    ]
+  },
+  "Browser": {
+    "variant": [
+      "light",
+      "dark"
+    ]
+  },
+  "Button": {
+    "variant": [
+      "primary",
+      "secondary",
+      "ghost",
+      "warning",
+      "danger"
+    ],
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "ButtonLink": {
+    "variant": [
+      "primary",
+      "secondary",
+      "ghost",
+      "warning",
+      "danger"
+    ],
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "CalendarGrid": {
+    "size": [
+      "large",
+      "small"
+    ]
+  },
+  "Checkbox": {
+    "size": [
+      "sm",
+      "md"
+    ]
+  },
+  "CodeBlock": {
+    "variant": [
+      "default",
+      "flush"
+    ]
+  },
+  "Combobox": {
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "DotsMenu": {
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "ErrorMessage": {
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "FilterChip": {
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "Gauge": {
+    "size": [
+      "xs",
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "IconButton": {
+    "variant": [
+      "primary",
+      "secondary",
+      "ghost",
+      "warning",
+      "danger"
+    ],
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "Input": {
+    "size": [
+      "xs",
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "InputOTP": {
+    "size": [
+      "md",
+      "lg"
+    ]
+  },
+  "Marker": {
+    "variant": [
+      "default",
+      "separator",
+      "unread"
+    ]
+  },
+  "Menu": {
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "Navigation": {
+    "variant": [
+      "default",
+      "line"
+    ]
+  },
+  "Note": {
+    "size": [
+      "small",
+      "default",
+      "large"
+    ]
+  },
+  "PageFeedback": {
+    "variant": [
+      "rating",
+      "helpful"
+    ]
+  },
+  "Pill": {
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "ProductLockup": {
+    "size": [
+      "sm",
+      "md"
+    ]
+  },
+  "ProjectBanner": {
+    "variant": [
+      "default",
+      "success",
+      "warning",
+      "error"
+    ]
+  },
+  "RangeField": {
+    "size": [
+      "large",
+      "small"
+    ]
+  },
+  "Select": {
+    "size": [
+      "xs",
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "Sheet": {
+    "size": [
+      "sm",
+      "md",
+      "lg",
+      "xl"
+    ]
+  },
+  "SidebarDrawer": {
+    "variant": [
+      "panel",
+      "plain"
+    ]
+  },
+  "Spinner": {
+    "size": [
+      "sm",
+      "md",
+      "lg",
+      "xl"
+    ]
+  },
+  "SplitButton": {
+    "variant": [
+      "default",
+      "secondary"
+    ],
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "StatusPage": {
+    "size": [
+      "page",
+      "region"
+    ]
+  },
+  "Switch": {
+    "variant": [
+      "segmented",
+      "cards"
+    ],
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "Tabs": {
+    "variant": [
+      "default",
+      "secondary",
+      "line"
+    ]
+  },
+  "Textarea": {
+    "size": [
+      "xs",
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "TextWithCopyButton": {
+    "size": [
+      "default",
+      "small"
+    ]
+  },
+  "Toggle": {
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  },
+  "ToggleGroup": {
+    "size": [
+      "sm",
+      "md",
+      "lg"
+    ]
+  }
+}

package/dist-pkg/design-system.js

@@ -14283,7 +14283,7 @@ function Gd(e) {
       ),
       e.mode === "multiple" && J.length ? /* @__PURE__ */ n("div", { className: "q1-cascader__tags", role: "list", "aria-label": "已选项", children: J.map((ce) => /* @__PURE__ */ _("span", { className: "q1-cascader__tag", role: "listitem", children: [
         /* @__PURE__ */ n("span", { children: U(ce) }),
-        w ? /* @__PURE__ */ n("button", { type: "button", className: "q1-cascader__remove", disabled: !F, "aria-label": `移除 ${ne(ce)}`, onClick: () => Me(ce), children: /* @__PURE__ */ n(Ue, { size: 16, strokeWidth: oe, "aria-hidden": "true" }) }) : null
+        w ? /* @__PURE__ */ n("button", { type: "button", className: "q1-cascader__remove", disabled: !F, "aria-label": `移除 ${ne(ce)}`, onClick: () => Me(ce), children: /* @__PURE__ */ n(Ue, { size: 12, strokeWidth: oe, "aria-hidden": "true" }) }) : null
       ] }, ce)) }) : null,
       w && J.length ? /* @__PURE__ */ n("button", { type: "button", className: "q1-cascader__remove", disabled: !F, "aria-label": "全部清除", onClick: () => Me(), children: /* @__PURE__ */ n(Ue, { size: 16, strokeWidth: oe, "aria-hidden": "true" }) }) : null
     ] }),

package/dist-pkg/style.css

@@ -2894,6 +2894,7 @@
 }
 
 .banner__close {
+  font: inherit;
   box-sizing: border-box;
   display: inline-flex;
   align-items: center;
@@ -3095,6 +3096,7 @@ a.breadcrumb__link:hover {
 }
 
 .breadcrumb__toggle {
+  font: inherit;
   display: inline-flex;
   align-items: center;
   justify-content: center;
@@ -3388,6 +3390,7 @@ a.breadcrumb__link:hover {
  可见焦点环——它可聚焦，chrome 整体不再 aria-hidden 正是为了让它可达。
  点击目标 24×24（WCAG 2.2 最小目标），图标仍 12px 居中——负 margin 抵消撑高，不改地址栏高度。 */
 .browser__address-copy {
+  font: inherit;
   flex-shrink: 0;
   display: grid;
   place-items: center;
@@ -4338,6 +4341,7 @@ a[href]:has(> .book):focus-visible {
 }
 
 .cal-field__trigger {
+  font: inherit;
   display: inline-flex;
   align-items: center;
   gap: var(--q1-space-2);
@@ -4360,6 +4364,7 @@ a[href]:has(> .book):focus-visible {
 
 .cal-field__clear,
 .cal-field__caret {
+  font: inherit;
   display: grid;
   place-items: center;
   min-height: var(--q1-space-6);
@@ -4479,6 +4484,7 @@ a[href]:has(> .book):focus-visible {
 }
 
 .calendar__nav-btn {
+  font: inherit;
   display: grid;
   place-items: center;
   width: 28px;
@@ -4540,6 +4546,7 @@ a[href]:has(> .book):focus-visible {
 }
 
 .calendar__day {
+  font: inherit;
   position: relative;
   display: grid;
   place-items: center;
@@ -4601,6 +4608,7 @@ a[href]:has(> .book):focus-visible {
 }
 
 .cal-period__trigger {
+  font: inherit;
   display: inline-flex;
   align-items: center;
   gap: var(--q1-space-2);
@@ -4638,6 +4646,7 @@ a[href]:has(> .book):focus-visible {
 }
 
 .cal-period__option {
+  font: inherit;
   width: 100%;
   text-align: left;
   padding: var(--q1-space-2) var(--q1-space-3);
@@ -5062,6 +5071,7 @@ a[href]:has(> .book):focus-visible {
 }
 
 .snippet__copy {
+  font: inherit;
   position: absolute;
   top: 50%;
   right: var(--q1-space-1);
@@ -5335,6 +5345,7 @@ a[href]:has(> .book):focus-visible {
 
 /* 行动按钮。 */
 .note__action {
+  font: inherit;
   flex-shrink: 0;
   display: inline-flex;
   align-items: center;
@@ -6417,6 +6428,7 @@ a.q1-card:focus-visible {
 }
 
 .twc__copy {
+  font: inherit;
   display: grid;
   place-items: center;
   width: 24px;
@@ -6532,6 +6544,7 @@ a.q1-card:focus-visible {
 
 /* 清除按钮：视觉走字段家族的通用 X；Esc 仍是即时键盘路径。 */
 .search-input__clear {
+  font: inherit;
   position: absolute;
   top: 50%;
   right: var(--q1-space-2);
@@ -6741,6 +6754,7 @@ a.q1-card:focus-visible {
 
 /* 药丸触发器：h32 / font 14/500 / 全圆角；颜色走家族 panel+border。 */
 .show-more__trigger {
+  font: inherit;
   display: inline-flex;
   align-items: center;
   gap: var(--q1-space-1);
@@ -7537,6 +7551,7 @@ a.q1-card:focus-visible {
   min-height: 0;
 }
 .scroller-buttons__control {
+  font: inherit;
   flex: none;
   display: grid;
   place-items: center;
@@ -7601,9 +7616,8 @@ a.q1-card:focus-visible {
   place-items: center;
 }
 .theme-switcher__option:has(input:checked) {
-  background: var(--q1-color-bg-subtle);
+  background: var(--q1-color-bg-selected-neutral);
   color: var(--q1-color-text-primary);
-  box-shadow: inset 0 0 0 1px var(--q1-color-gray-400);
 }
 .theme-switcher__option:has(input:focus-visible) {
   outline: none;
@@ -7960,6 +7974,7 @@ a.q1-card:focus-visible {
   box-shadow: var(--q1-shadow-focus);
 }
 .q1-toast__close {
+  font: inherit;
   flex: none;
   display: grid;
   place-items: center;
@@ -8268,6 +8283,7 @@ a.q1-card:focus-visible {
   display: inline-block;
 }
 .dots-menu__trigger {
+  font: inherit;
   display: grid;
   place-items: center;
   border: 0;
@@ -8573,6 +8589,7 @@ a.q1-card:focus-visible {
   outline: none;
 }
 .combobox__clear {
+  font: inherit;
   flex: none;
   display: grid;
   place-items: center;
@@ -8887,6 +8904,7 @@ a.q1-card:focus-visible {
 }
 /* 遮罩颜色与 Modal 同源，见 overlay-surfaces.css：浅色为白纱，暗色压暗。 */
 .search-dialog__backdrop {
+  font: inherit;
   position: absolute;
   inset: 0;
   border: 0;
@@ -8938,6 +8956,7 @@ a.q1-card:focus-visible {
 }
 /* 关闭入口以 Esc 键帽呈现：键盘优先、视觉更轻；粗指针下由 TouchTarget 扩展到 44px 命中区。 */
 .search-dialog__close {
+  font: inherit;
   position: relative;
   display: inline-flex;
   flex: none;
@@ -9171,6 +9190,7 @@ a.q1-card:focus-visible {
   padding: var(--q1-space-4);
 }
 .modal__backdrop {
+  font: inherit;
   position: absolute;
   inset: 0;
   border: 0;
@@ -9354,6 +9374,7 @@ a.q1-card:focus-visible {
   align-items: center;
 }
 .drawer__backdrop {
+  font: inherit;
   position: absolute;
   inset: 0;
   border: 0;
@@ -9373,6 +9394,7 @@ a.q1-card:focus-visible {
 /* 抓手把是真按钮（点击/Enter/Space 关闭，下滑手势保留给触屏）——原 role=button+tabIndex=-1
  是读屏能发现却无法激活的矛盾信号。清按钮默认样式，触控目标保持至少 44px。 */
 .drawer__handle {
+  font: inherit;
   display: grid;
   place-items: center;
   width: 100%;
@@ -9688,6 +9710,7 @@ a.q1-card:focus-visible {
   color: var(--q1-color-text-primary);
 }
 .sheet__close {
+  font: inherit;
   flex: none;
   display: grid;
   place-items: center;
@@ -10557,6 +10580,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 
 .q1-context-switcher__popup[role='dialog'] input[type='search'],
 .q1-context-switcher__popup--stacked input[type='search'] {
+  font: inherit;
   width: 100%;
   min-width: 0;
   min-height: var(--q1-space-8);
@@ -11491,7 +11515,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 
 .q1-cascader { display: grid; gap: var(--q1-space-2); min-inline-size: 0; }
 .q1-cascader__label { color: var(--q1-color-text-primary); font-size: var(--q1-font-size-label-14); line-height: var(--q1-line-height-label-14); }
-.q1-cascader__control { position: relative; display: flex; flex-wrap: wrap; align-items: center; gap: var(--q1-space-2); border: calc(var(--q1-space-1) / 4) solid var(--q1-color-border); border-radius: var(--q1-radius-2); background: var(--q1-color-bg-sunken); }
+.q1-cascader__control { position: relative; display: flex; flex-wrap: wrap; align-items: center; gap: var(--q1-space-2); border: calc(var(--q1-space-1) / 4) solid var(--q1-color-border-control); border-radius: var(--q1-radius-2); background: var(--q1-color-bg-sunken); }
 .q1-cascader__trigger { display: flex; align-items: center; justify-content: space-between; flex: 1; gap: var(--q1-space-2); min-inline-size: 0; min-block-size: var(--q1-control-height-default); padding: var(--q1-space-2) var(--q1-space-3); border: none; background: none; border-radius: var(--q1-radius-2); color: var(--q1-color-text-primary); font: inherit; font-size: var(--q1-font-size-label-14); line-height: var(--q1-line-height-label-14); cursor: pointer; text-align: start; overflow-wrap: anywhere; }
 .q1-cascader__trigger svg, .q1-cascader__option svg { flex: none; }
 .q1-cascader__control:focus-within { box-shadow: var(--q1-shadow-focus-input); }
@@ -11500,25 +11524,26 @@ a.q1-navigation__item[aria-disabled='true'] {
 .q1-cascader__trigger:focus-visible { outline: none; }
 .q1-cascader__placeholder, .q1-cascader__path { color: var(--q1-color-text-muted); }
 .q1-cascader__control[data-disabled], .q1-cascader__trigger[aria-disabled], .q1-cascader__option[aria-disabled] { color: var(--q1-color-text-disabled); cursor: default; }
+.q1-cascader__control[data-disabled]:not([data-invalid]) { border-color: var(--q1-color-border); }
 .q1-cascader__control[data-disabled] .q1-cascader__trigger { color: inherit; }
 .q1-cascader__control[data-tags] { align-items: start; flex-wrap: nowrap; padding-inline-end: calc(var(--q1-control-height-default) + var(--q1-space-3)); }
 .q1-cascader__control[data-tags] .q1-cascader__trigger { position: absolute; inset: 0; inline-size: 100%; padding: 0; }
 .q1-cascader__control[data-tags][data-clearable] { padding-inline-end: calc(var(--q1-control-height-default) * 2 + var(--q1-space-3)); }
 .q1-cascader__control[data-clearable]:not([data-tags]) .q1-cascader__trigger { margin-inline-end: var(--q1-control-height-default); }
-.q1-cascader__control[data-tags] .q1-cascader__trigger > svg { position: absolute; inset-block-start: var(--q1-space-2); inset-inline-end: var(--q1-space-2); }
+.q1-cascader__control[data-tags] .q1-cascader__trigger > svg { position: absolute; inset-block-start: calc((var(--q1-control-height-default) - var(--q1-space-4)) / 2); inset-inline-end: var(--q1-space-2); }
 .q1-cascader__control[data-tags][data-clearable] .q1-cascader__trigger > svg { inset-inline-end: calc(var(--q1-control-height-default) + var(--q1-space-2)); }
 .q1-cascader__remove { position: relative; z-index: 1; pointer-events: auto; }
 .q1-cascader__control > .q1-cascader__remove { position: absolute; inset-block-start: 0; inset-inline-end: 0; }
-.q1-cascader__tags { position: relative; pointer-events: none; min-inline-size: 0; flex: 1; display: flex; flex-wrap: wrap; gap: var(--q1-space-2); padding: var(--q1-space-2); }
-.q1-cascader__tag { max-inline-size: 100%; min-inline-size: 0; display: inline-flex; align-items: center; gap: var(--q1-space-2); background: var(--q1-color-bg-selected); border-radius: var(--q1-radius-2); padding-inline-start: var(--q1-space-2); overflow-wrap: anywhere; }
+.q1-cascader__tags { position: relative; pointer-events: none; min-inline-size: 0; flex: 1; display: flex; flex-wrap: wrap; gap: var(--q1-space-1); padding: var(--q1-space-2); }
+.q1-cascader__tag { font-size: var(--q1-font-size-label-14); line-height: var(--q1-line-height-label-14); max-inline-size: 100%; min-inline-size: 0; display: inline-flex; align-items: center; gap: var(--q1-space-1); background: var(--q1-color-bg-hover); border-radius: var(--q1-radius-1); padding-inline-start: var(--q1-space-2); overflow-wrap: anywhere; }
 .q1-cascader__tag > span { min-inline-size: 0; }
-.q1-cascader__tag .q1-cascader__remove { pointer-events: auto; flex: none; }
+.q1-cascader__tag .q1-cascader__remove { pointer-events: auto; flex: none; min-block-size: var(--q1-space-6); min-inline-size: var(--q1-space-6); padding: 0; border-radius: var(--q1-radius-1); color: inherit; }
 .q1-cascader__option [data-selection-area] { display: inline-flex; align-items: center; justify-content: center; flex: none; align-self: stretch; inline-size: var(--q1-control-height-default); margin: calc(var(--q1-space-2) * -1) 0 calc(var(--q1-space-2) * -1) calc(var(--q1-space-3) * -1); }
 .q1-cascader__remove, .q1-cascader__back { display: inline-flex; align-items: center; justify-content: center; min-block-size: var(--q1-control-height-default); min-inline-size: var(--q1-control-height-default); padding: var(--q1-space-2); border: none; border-radius: var(--q1-radius-2); background: none; color: var(--q1-color-text-secondary); font: inherit; cursor: pointer; }
 .q1-cascader__remove:focus-visible, .q1-cascader__back:focus-visible, .q1-cascader__search:focus-visible, .q1-cascader__list:focus-visible { outline: none; box-shadow: var(--q1-shadow-focus-input); }
 .q1-cascader__popup.popover-panel { max-inline-size: calc(100vw - var(--q1-space-6)); padding: var(--q1-space-2); border-radius: var(--q1-radius-3); background: var(--q1-color-bg-overlay); }
 .q1-cascader__panel { display: grid; gap: var(--q1-space-2); min-inline-size: 0; }
-.q1-cascader__search { box-sizing: border-box; inline-size: 100%; min-block-size: var(--q1-control-height-default); padding: var(--q1-space-2) var(--q1-space-3); border: calc(var(--q1-space-1) / 4) solid var(--q1-color-border); border-radius: var(--q1-radius-2); background: var(--q1-color-bg-sunken); color: var(--q1-color-text-primary); font: inherit; font-size: var(--q1-font-size-label-14); }
+.q1-cascader__search { box-sizing: border-box; inline-size: 100%; min-block-size: var(--q1-control-height-default); padding: var(--q1-space-2) var(--q1-space-3); border: calc(var(--q1-space-1) / 4) solid var(--q1-color-border-control); border-radius: var(--q1-radius-2); background: var(--q1-color-bg-sunken); color: var(--q1-color-text-primary); font: inherit; font-size: var(--q1-font-size-label-14); }
 .q1-cascader__columns { display: flex; overflow-x: auto; min-inline-size: 0; max-inline-size: calc(100vw - var(--q1-space-6) * 2); }
 .q1-cascader__column { flex: 0 0 auto; inline-size: calc(var(--q1-space-10) * 6); min-inline-size: 0; max-inline-size: 100%; }
 .q1-cascader__column[hidden] { display: none; }
@@ -11544,7 +11569,7 @@ a.q1-navigation__item[aria-disabled='true'] {
   .q1-cascader__control[data-clearable]:not([data-tags]) .q1-cascader__trigger { margin-inline-end: var(--q1-touch-target-min); }
   .q1-cascader__control[data-tags] .q1-cascader__trigger > svg { inset-block-start: calc((var(--q1-touch-target-min) - var(--q1-space-4)) / 2); }
   .q1-cascader__control[data-tags][data-clearable] .q1-cascader__trigger > svg { inset-inline-end: calc(var(--q1-touch-target-min) + var(--q1-space-2)); }
-  .q1-cascader__remove { min-inline-size: var(--q1-touch-target-min); }
+  .q1-cascader__remove, .q1-cascader__tag .q1-cascader__remove { min-inline-size: var(--q1-touch-target-min); min-block-size: var(--q1-touch-target-min); }
 }
 
 /* 未知总量以往返移动表示持续等待；减弱动态时保留居中填充段，不伪装完成比例。 */
@@ -12474,7 +12499,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 
 .multi-combobox { min-width: 0; }
 .multi-combobox__control { box-sizing: border-box; position: relative; display: flex; align-items: center; gap: var(--q1-space-2); min-height: var(--q1-control-height-default); padding: var(--q1-space-1) var(--q1-space-3); border: calc(var(--q1-space-1) / 4) solid var(--q1-color-border-control); border-radius: var(--q1-radius-2); background: var(--q1-color-bg-sunken); }
-.multi-combobox__trigger { position: absolute; inset: 0; width: 100%; border: 0; border-radius: inherit; background: transparent; cursor: pointer; }
+.multi-combobox__trigger { font: inherit; position: absolute; inset: 0; width: 100%; border: 0; border-radius: inherit; background: transparent; cursor: pointer; }
 .multi-combobox__trigger:focus { outline: none; }
 .multi-combobox__control:has(.multi-combobox__trigger:focus-visible) { box-shadow: var(--q1-shadow-focus); }
 .multi-combobox__control[data-invalid] { border-color: var(--q1-color-status-danger); box-shadow: 0 0 0 calc(var(--q1-space-1) / 4) var(--q1-color-status-danger), 0 0 0 var(--q1-space-1) var(--q1-color-red-100); }
@@ -12484,7 +12509,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 .multi-combobox__values { display: flex; flex: 1; flex-wrap: wrap; align-items: center; gap: var(--q1-space-1); min-width: 0; pointer-events: none; font-size: var(--q1-font-size-label-14); line-height: var(--q1-line-height-label-14); }
 .multi-combobox__tag { position: relative; display: inline-flex; align-items: center; gap: var(--q1-space-1); max-width: 100%; padding-inline-start: var(--q1-space-2); border-radius: var(--q1-radius-1); background: var(--q1-color-bg-hover); color: var(--q1-color-text-primary); }
 .multi-combobox__tag > span { min-width: 0; overflow-wrap: anywhere; }
-.multi-combobox__remove { position: relative; display: inline-flex; align-items: center; justify-content: center; flex: none; min-width: var(--q1-space-6); min-height: var(--q1-space-6); padding: 0; border: 0; border-radius: var(--q1-radius-1); background: transparent; color: inherit; pointer-events: auto; cursor: pointer; }
+.multi-combobox__remove { font: inherit; position: relative; display: inline-flex; align-items: center; justify-content: center; flex: none; min-width: var(--q1-space-6); min-height: var(--q1-space-6); padding: 0; border: 0; border-radius: var(--q1-radius-1); background: transparent; color: inherit; pointer-events: auto; cursor: pointer; }
 .multi-combobox__remove:disabled { cursor: default; }
 .multi-combobox__remove:focus-visible { outline: none; box-shadow: var(--q1-shadow-focus); }
 .multi-combobox__placeholder { color: var(--q1-color-text-muted); }
@@ -12560,6 +12585,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 .command-palette__hint,
 .command-palette__close,
 .command-palette__kbd {
+  font: inherit;
   border-radius: var(--q1-radius-1);
   background: color-mix(in srgb, var(--q1-color-text-primary) 8%, transparent);
   color: var(--q1-color-text-secondary);
@@ -12583,6 +12609,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 }
 
 .command-palette__backdrop {
+  font: inherit;
   position: absolute;
   inset: 0;
   border: 0;
@@ -13073,6 +13100,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 }
 
 .copy-button {
+  font: inherit;
   display: grid;
   place-items: center;
   width: var(--q1-space-8);
@@ -13197,6 +13225,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 }
 
 .clearable__clear {
+  font: inherit;
   display: grid;
   place-items: center;
   width: var(--q1-space-6);
@@ -13290,6 +13319,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 }
 
 .codeblock__tab {
+  font: inherit;
   min-height: var(--q1-space-6);
   padding: calc(var(--q1-space-1) / 2) var(--q1-space-3);
   border: none;
@@ -13486,6 +13516,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 }
 
 .description__hint {
+  font: inherit;
   display: inline-grid;
   place-items: center;
   width: var(--q1-space-6);
@@ -13639,6 +13670,7 @@ a.q1-navigation__item[aria-disabled='true'] {
  触屏下 TouchTarget 再扩到 --q1-touch-target-min。 */
 .info-tip__trigger,
 .info-tip__close {
+  font: inherit;
   position: relative;
   display: inline-grid;
   place-items: center;
@@ -13959,6 +13991,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 }
 
 .corner-remove-button {
+  font: inherit;
   position: absolute;
   top: 0;
   right: 0;
@@ -14881,7 +14914,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 .composer textarea::placeholder { color: var(--q1-color-text-muted); }
 .composer__tools { display: flex; align-items: center; gap: var(--q1-space-3); padding: var(--q1-space-2); }
 .composer__tools > .button { margin-left: auto; }
-.composer__icon { position: relative; --touch-target-border-width: 0px; display: grid; place-items: center; border: 0; background: transparent; color: var(--q1-color-text-secondary); width: var(--q1-space-7); height: var(--q1-space-7); border-radius: var(--q1-radius-2); }
+.composer__icon { font: inherit; position: relative; --touch-target-border-width: 0px; display: grid; place-items: center; border: 0; background: transparent; color: var(--q1-color-text-secondary); width: var(--q1-space-7); height: var(--q1-space-7); border-radius: var(--q1-radius-2); }
 .composer__icon:hover { background: var(--q1-color-bg-hover); }
 .composer__icon:focus-visible { outline: none; box-shadow: var(--q1-shadow-focus); }
 .composer__attachments { display: flex; flex-wrap: wrap; gap: var(--q1-space-2); padding: var(--q1-space-2); }
@@ -14909,7 +14942,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 .attachment__retry { position: relative; --touch-target-border-width: 0px; border: 0; padding: 0; background: transparent; color: var(--q1-color-text-primary); font: inherit; font-weight: var(--q1-font-weight-medium); border-radius: var(--q1-radius-1); cursor: pointer; }
 .attachment__retry:hover { text-decoration: underline; }
 .attachment__retry:focus-visible { outline: none; box-shadow: var(--q1-shadow-focus); }
-.attachment__remove { position: relative; --touch-target-border-width: 0px; border: 0; background: transparent; color: var(--q1-color-text-muted); display: grid; place-items: center; width: var(--q1-space-6); height: var(--q1-space-6); border-radius: var(--q1-radius-1); flex-shrink: 0; }
+.attachment__remove { font: inherit; position: relative; --touch-target-border-width: 0px; border: 0; background: transparent; color: var(--q1-color-text-muted); display: grid; place-items: center; width: var(--q1-space-6); height: var(--q1-space-6); border-radius: var(--q1-radius-1); flex-shrink: 0; }
 .attachment__remove:hover { background: var(--q1-color-bg-hover); }
 .attachment__remove:focus-visible { outline: none; box-shadow: var(--q1-shadow-focus); }
 @media (pointer: coarse), (any-pointer: coarse) { .attachment { gap: var(--q1-space-4); padding: var(--q1-space-3); } }
@@ -15001,6 +15034,7 @@ a.q1-navigation__item[aria-disabled='true'] {
 }
 
 .feedback__emotion {
+  font: inherit;
   display: grid;
   place-items: center;
   width: var(--q1-space-8);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@q1travel/design-system",
-  "version": "0.30.12",
+  "version": "0.30.13",
   "description": "React components, design tokens, and interface contracts for q1travel products.",
   "keywords": [
     "react",
@@ -55,15 +55,15 @@
     "preview": "vite preview --host 127.0.0.1",
     "check:shell": "npm run sync:contracts && node scripts/check-shell.mjs && node scripts/check-token-package.mjs && npm run check:release-provenance",
     "check:browser:strictmode": "node scripts/check-browser.mjs --strictmode-ref",
-    "check:browser": "node --test scripts/devtools-connection.test.mjs scripts/browser-exit-deadline.test.mjs scripts/chromium-teardown.test.mjs scripts/vite-server-lifecycle.test.mjs scripts/chromium-launch.test.mjs scripts/chromium-recovery.test.mjs scripts/chromium-ownership.test.mjs scripts/cdp-recovery.test.mjs && npm run check:browser:strictmode && node scripts/check-browser.mjs --note && node scripts/check-browser.mjs --combobox-panel && node scripts/check-browser.mjs && node scripts/check-clearable-input-browser.mjs && node scripts/check-calendar-browser.mjs && node scripts/check-banner-browser.mjs && node scripts/check-button-link-browser.mjs && node scripts/check-button-browser.mjs && node scripts/check-trailing-icon-padding-browser.mjs && node scripts/check-overlay-theme-browser.mjs && node scripts/check-browser-component-browser.mjs",
-    "check:package-api": "node scripts/check-package-api.mjs && node --test scripts/check-public-type-global-augmentations.test.mjs && node --test scripts/check-combobox-required.test.mjs scripts/check-multi-combobox-contract.test.mjs && node --test scripts/check-q1-design-lint.test.mjs scripts/check-q1-design-bin-entry.test.mjs && node --test scripts/check-json-view-contract.test.mjs && node --test scripts/check-verification-code-input.test.mjs && node --test scripts/check-bare-field-error.test.mjs scripts/check-label-hidden-contract.test.mjs scripts/check-required-indicator-contract.test.mjs scripts/check-spinner-inherit-contract.test.mjs && node --test scripts/check-controls-contract.test.mjs && node --test scripts/check-pagination-contract.test.mjs && node --test scripts/check-table-core.test.mjs scripts/check-table-interaction.test.mjs scripts/check-table-layout.test.mjs && node --test scripts/check-contrast-contract.test.mjs && node --test scripts/check-optical-alignment-contract.test.mjs && node --test scripts/check-overlay-coordination.test.mjs scripts/check-sheet-contract.test.mjs && node --test scripts/check-choicebox-contract.test.mjs && node --test scripts/check-radio-group-contract.test.mjs && node --test scripts/check-clearable-input-contract.test.mjs && node --test scripts/check-card-contract.test.mjs && node --test scripts/check-book-contract.test.mjs && node --test scripts/check-breadcrumbs-contract.test.mjs && node --test scripts/check-description-contract.test.mjs && node --test scripts/check-error-message-contract.test.mjs && node --test scripts/check-show-more-contract.test.mjs && node --test scripts/check-load-more-button-contract.test.mjs && node --test scripts/check-banner-contract.test.mjs && node --test scripts/check-project-banner-contract.test.mjs && node --test scripts/check-note-contract.test.mjs && node --test scripts/check-feedback-contract.test.mjs && node --test scripts/check-page-feedback-contract.test.mjs && node --test scripts/check-drawer-gesture.test.mjs && node --test scripts/check-checkbox-circle-contract.test.mjs && node --test scripts/check-chat-contract.test.mjs && node --test scripts/check-calendar-single-contract.test.mjs && node --test scripts/check-hover-card-contract.test.mjs && node --test scripts/check-bare-field-error.test.mjs && node --test scripts/check-controls-contract.test.mjs scripts/check-control-size-contract.test.mjs && node --test scripts/check-composer-dots-menu-contract.test.mjs && node --test scripts/check-filter-option-panel-contract.test.mjs && npm run check:release-diff",
+    "check:browser": "node --test scripts/cascader-browser-lifecycle.test.mjs scripts/devtools-connection.test.mjs scripts/browser-exit-deadline.test.mjs scripts/chromium-teardown.test.mjs scripts/vite-server-lifecycle.test.mjs scripts/chromium-launch.test.mjs scripts/chromium-recovery.test.mjs scripts/chromium-ownership.test.mjs scripts/cdp-recovery.test.mjs && npm run check:browser:strictmode && node scripts/check-browser.mjs --note && node scripts/check-browser.mjs --combobox-panel && node scripts/check-browser.mjs && node scripts/check-clearable-input-browser.mjs && node scripts/check-calendar-browser.mjs && node scripts/check-banner-browser.mjs && node scripts/check-button-link-browser.mjs && node scripts/check-button-browser.mjs && node scripts/check-trailing-icon-padding-browser.mjs && node scripts/check-overlay-theme-browser.mjs && node scripts/check-browser-component-browser.mjs",
+    "check:package-api": "node scripts/check-package-api.mjs && node --test scripts/check-public-type-global-augmentations.test.mjs && node --test scripts/check-combobox-required.test.mjs scripts/check-multi-combobox-contract.test.mjs && node --test scripts/check-q1-design-lint.test.mjs scripts/check-q1-design-component-enums.test.mjs scripts/check-q1-design-bin-entry.test.mjs && node --test scripts/check-json-view-contract.test.mjs && node --test scripts/check-verification-code-input.test.mjs && node --test scripts/check-bare-field-error.test.mjs scripts/check-label-hidden-contract.test.mjs scripts/check-required-indicator-contract.test.mjs scripts/check-spinner-inherit-contract.test.mjs && node --test scripts/check-controls-contract.test.mjs && node --test scripts/check-pagination-contract.test.mjs && node --test scripts/check-table-core.test.mjs scripts/check-table-interaction.test.mjs scripts/check-table-layout.test.mjs && node --test scripts/check-contrast-contract.test.mjs && node --test scripts/check-optical-alignment-contract.test.mjs && node --test scripts/check-overlay-coordination.test.mjs scripts/check-sheet-contract.test.mjs && node --test scripts/check-choicebox-contract.test.mjs && node --test scripts/check-radio-group-contract.test.mjs && node --test scripts/check-clearable-input-contract.test.mjs && node --test scripts/check-card-contract.test.mjs && node --test scripts/check-book-contract.test.mjs && node --test scripts/check-breadcrumbs-contract.test.mjs && node --test scripts/check-description-contract.test.mjs && node --test scripts/check-error-message-contract.test.mjs && node --test scripts/check-show-more-contract.test.mjs && node --test scripts/check-load-more-button-contract.test.mjs && node --test scripts/check-banner-contract.test.mjs && node --test scripts/check-project-banner-contract.test.mjs && node --test scripts/check-note-contract.test.mjs && node --test scripts/check-feedback-contract.test.mjs && node --test scripts/check-page-feedback-contract.test.mjs && node --test scripts/check-drawer-gesture.test.mjs && node --test scripts/check-checkbox-circle-contract.test.mjs && node --test scripts/check-chat-contract.test.mjs && node --test scripts/check-calendar-single-contract.test.mjs && node --test scripts/check-hover-card-contract.test.mjs && node --test scripts/check-bare-field-error.test.mjs && node --test scripts/check-controls-contract.test.mjs scripts/check-control-size-contract.test.mjs && node --test scripts/check-composer-dots-menu-contract.test.mjs && node --test scripts/check-filter-option-panel-contract.test.mjs && npm run check:release-diff",
     "check:release-diff": "node --test scripts/check-release-artifact-diff.test.mjs && node scripts/check-release-artifact-diff.mjs",
     "check:release-provenance": "node --test scripts/check-release-provenance.test.mjs && node scripts/check-release-provenance.mjs",
     "check:release-sync": "node --test scripts/release-sync.test.mjs scripts/release-preview-version.test.mjs",
     "release:verify": "node scripts/release-sync.mjs --verify-only",
     "release:sync": "node scripts/release-sync.mjs",
     "check": "npm run check:release-sync && npm run build && npm run check:shell && npm run check:browser && npm run build:pkg",
-    "build:lib": "vite build --config vite.lib.config.ts",
+    "build:lib": "vite build --config vite.lib.config.ts && node scripts/build-component-enums.mjs",
     "build:style": "node scripts/build-style.mjs",
     "build:pkg": "npm run build:lib && npm run build:style && npm run check:package-api",
     "prepack": "npm run build:pkg"

package/tooling/README.md

@@ -6,4 +6,10 @@
 - `evals/fixtures.json` —— eval fixture 索引。
 - `evals/<fixture>/{before,after}/` —— 每条规则的前后态样例,用来测 skill / linter 是否产出预期改动。
 
-**现状**:`q1-design lint` 已实现 `Q1-DS-001`(`--ds-*`)/`Q1-DS-401`(`transition: all`)/`Q1-DS-404`(裸 duration/easing)/`Q1-DS-501`(裸颜色字面量)四条纯机械规则;`q1-design eval` 已实现,对每个 fixture 校验 before 命中且 after 零命中。`q1-design overrides` 统计消费方对组件的 className 覆写并按「重画外观/仅布局」分类——它不是 pass/fail 规则,因为覆写布局是正当用法,拦它的规则最后会被整体关掉。其余 `kind=deterministic` 规则(含判断成分)与全部 `kind=judgment` 规则待后续批次。见 `../.agents/skills/product-design/references/coverage-gaps.md`。
+**现状**:`q1-design lint` 已实现 `Q1-DS-001`(`--ds-*`)/`Q1-DS-401`(`transition: all`)/`Q1-DS-404`(裸 duration/easing)/`Q1-DS-501`(裸颜色字面量)与 `Q1-DS-002`（组件 `variant` / `size` 非法字符串字面量）五条纯机械规则;`q1-design eval` 已实现,对每个 fixture 校验 before 命中且 after 零命中。`q1-design overrides` 统计消费方对组件的 className 覆写并按「重画外观/仅布局」分类——它不是 pass/fail 规则,因为覆写布局是正当用法,拦它的规则最后会被整体关掉。其余 `kind=deterministic` 规则(含判断成分)与全部 `kind=judgment` 规则待后续批次。见 `../.agents/skills/product-design/references/coverage-gaps.md`。
+
+`Q1-DS-002` 为 error：仅检查直接从 `@q1travel/design-system` 导入的组件（含命名别名、命名空间），不追踪消费方再导出或运行时赋值；局部同名组件不受影响。允许值来自随包 `dist-pkg/design-system.d.ts` 中组件 props 的有限字符串联合，覆盖 `Button` 及其他声明了此类 `variant` / `size` 的导出组件。`variant="quiet"`、`variant={'quiet'}` 会检查，`variant={value}` 与条件表达式交给消费方类型检查。诊断包含文件、行号、组件、属性、非法值和允许值；命中退出 1，支持现有文件、区间和下一行 pragma。检测到相关字面量却缺少类型声明时退出 1 并提示修复，不能静默跳过。
+
+CLI 通过运行时依赖 TypeScript 解析 JSX 与词法绑定，避免把注释、字符串或被遮蔽的同名组件误当成包组件；不依赖消费方开发依赖或本仓源码。
+
+在本仓直跑组件规则或对应 CLI 测试前，运行 `npm run build:lib` 生成类型声明；仅扫描 CSS 不要求该产物。

package/tooling/scripts/evals/rules-checklist.json

@@ -1,5 +1,5 @@
 {
-  "note": "q1travel 产品设计确定性规则清单。每条带稳定 ID + canonical 出处。kind=deterministic 的可由 linter 静态强制;kind=judgment 的留给 product-design skill / Review。linter CLI 与 eval runner 已实现:`q1-design lint`(Q1-DS-001/401/501)与 `q1-design eval`(bin/q1-design.mjs);覆盖缺口见 ../../../.agents/skills/product-design/references/coverage-gaps.md。",
+  "note": "q1travel 产品设计确定性规则清单。每条带稳定 ID + canonical 出处。kind=deterministic 的可由 linter 静态强制;kind=judgment 的留给 product-design skill / Review。linter CLI 与 eval runner 已实现:`q1-design lint`(Q1-DS-001/002/401/404/501)与 `q1-design eval`(bin/q1-design.mjs);覆盖缺口见 ../../../.agents/skills/product-design/references/coverage-gaps.md。",
   "version": 0,
   "idScheme": {
     "0xx": "token 与事实源",
@@ -11,6 +11,7 @@
   },
   "rules": [
     { "id": "Q1-DS-001", "title": "新代码用 --q1-*,不用 --ds-*", "source": "contracts/token-naming.md", "severity": "error", "kind": "deterministic", "detect": "新增/改动代码里出现 --ds-* 声明或作为新决策源名", "fix": "改用 --q1-* canonical token" },
+    { "id": "Q1-DS-002", "title": "组件枚举属性仅使用公开值", "source": "dist-pkg/design-system.d.ts", "severity": "error", "kind": "deterministic", "detect": "直接从包导入的组件，其 variant / size 字符串字面量不在 props 有限联合中", "fix": "使用诊断列出的公开允许值，动态表达式交给类型检查" },
     { "id": "Q1-DS-101", "title": "导航用原生 link、动作用原生 button", "source": "contracts/interface-guidelines.md#interactions", "severity": "error", "kind": "judgment", "detect": "用 div/span + onClick 承载导航或动作", "fix": "导航用 <a href>,动作用 <button>" },
     { "id": "Q1-DS-102", "title": "命中区 ≥24px(触摸 44px)", "source": "contracts/interface-guidelines.md#interactions", "severity": "warn", "kind": "judgment", "detect": "可点击元素视觉/命中区小于 24px 且未扩大命中区", "fix": "min-width/height + 负 margin 扩大命中区,不撑高容器" },
     { "id": "Q1-DS-301", "title": "icon-only 控件必须有可访问名", "source": "contracts/interface-guidelines.md#content-and-accessibility", "severity": "error", "kind": "judgment", "detect": "只含图标的 button/link 无 aria-label / 可访问名", "fix": "补 aria-label 或视觉隐藏文本" },