@q1travel/design-system 0.1.0 → 0.3.0

package/{dist → dist-pkg}/style.css

@@ -2230,7 +2230,7 @@ a.breadcrumb__link:hover {
   padding-right: 48px;
 }
 
-.tabs-specimen {
+.tabs-root {
   border: 1px solid var(--q1-color-border);
   border-radius: var(--q1-radius-3);
   background: var(--q1-color-bg-panel);
@@ -2308,7 +2308,7 @@ a.breadcrumb__link:hover {
   align-items: center;
 }
 
-.tabs-specimen {
+.tabs-root {
   display: grid;
   gap: var(--q1-space-4);
 }

package/package.json

@@ -1,20 +1,29 @@
 {
   "name": "@q1travel/design-system",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "private": false,
   "type": "module",
-  "main": "./dist/design-system.js",
-  "module": "./dist/design-system.js",
-  "types": "./dist/design-system.d.ts",
+  "main": "./dist-pkg/design-system.js",
+  "module": "./dist-pkg/design-system.js",
+  "types": "./dist-pkg/design-system.d.ts",
+  "bin": {
+    "q1-design": "./bin/q1-design.mjs"
+  },
   "exports": {
     ".": {
-      "types": "./dist/design-system.d.ts",
-      "import": "./dist/design-system.js"
+      "types": "./dist-pkg/design-system.d.ts",
+      "import": "./dist-pkg/design-system.js"
     },
-    "./style.css": "./dist/style.css"
+    "./style.css": "./dist-pkg/style.css",
+    "./contracts/*": "./contracts/*",
+    "./package.json": "./package.json"
   },
   "files": [
-    "dist"
+    "dist-pkg",
+    "contracts",
+    ".agents",
+    "tooling",
+    "bin"
   ],
   "sideEffects": [
     "*.css"
@@ -29,7 +38,8 @@
     "check": "npm run build && npm run check:shell && npm run check:browser",
     "build:lib": "vite build --config vite.lib.config.ts",
     "build:style": "node scripts/build-style.mjs",
-    "build:pkg": "npm run build:lib && npm run build:style"
+    "build:pkg": "npm run build:lib && npm run build:style",
+    "prepack": "npm run build:pkg"
   },
   "dependencies": {
     "lucide-react": "^0.468.0"

package/tooling/README.md

@@ -0,0 +1,9 @@
+# tooling/scripts/evals
+
+产品设计框架的确定性工具层(规则 + eval)。
+
+- `evals/rules-checklist.json` —— 稳定 ID 规则清单(`Q1-DS-*`);`kind=deterministic` 可静态强制,`kind=judgment` 留给 product-design skill / Review。
+- `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-501`(裸颜色字面量)三条纯机械规则;`q1-design eval` 已实现,对每个 fixture 校验 before 命中且 after 零命中。其余 `kind=deterministic` 规则(含判断成分)与全部 `kind=judgment` 规则待后续批次。见 `../.agents/skills/product-design/references/coverage-gaps.md`。

package/tooling/scripts/evals/fixtures.json

@@ -0,0 +1,7 @@
+{
+  "note": "eval 种子:每个 fixture 引一条规则,给 before/after 两态,用来测 skill/linter 是否产出预期改动。runner 即 `q1-design eval`(bin/q1-design.mjs,已实现);expectedHits 为 before 的精确命中数,after 恒 0。",
+  "version": 0,
+  "fixtures": [
+    { "id": "transition-all", "rule": "Q1-DS-401", "dir": "transition-all", "summary": "transition: all → 只过渡具体属性", "expectedHits": 1 }
+  ]
+}

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

@@ -0,0 +1,23 @@
+{
+  "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。",
+  "version": 0,
+  "idScheme": {
+    "0xx": "token 与事实源",
+    "1xx": "交互与命中区",
+    "2xx": "表单",
+    "3xx": "内容与可访问性",
+    "4xx": "动效",
+    "5xx": "主题"
+  },
+  "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-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 或视觉隐藏文本" },
+    { "id": "Q1-DS-401", "title": "禁用 transition: all", "source": "contracts/interface-guidelines.md#animation", "severity": "error", "kind": "deterministic", "detect": "CSS 出现 `transition: all` 或 `transition-property: all`", "fix": "只列需要过渡的具体属性(opacity / transform)" },
+    { "id": "Q1-DS-402", "title": "必须 honor prefers-reduced-motion", "source": "contracts/interface-guidelines.md#animation", "severity": "warn", "kind": "judgment", "detect": "有非平凡动效但无 prefers-reduced-motion 兜底", "fix": "加 @media (prefers-reduced-motion: reduce) 降级" },
+    { "id": "Q1-DS-403", "title": "只动 opacity / transform", "source": "contracts/interface-guidelines.md#animation", "severity": "warn", "kind": "deterministic", "detect": "transition/animation 作用于非 opacity/transform 属性且无书面理由", "fix": "改用 opacity/transform,或记书面理由" },
+    { "id": "Q1-DS-501", "title": "主题用 token,不用页面局部颜色常量", "source": "contracts/interface-guidelines.md#theming", "severity": "error", "kind": "deterministic", "detect": "组件 CSS 出现裸 hex / rgba() 颜色字面量", "fix": "改用 --q1-color-* / 语义 token;需要混色用 color-mix" },
+    { "id": "Q1-DS-502", "title": "native select 显式设前景/背景", "source": "contracts/interface-guidelines.md#theming", "severity": "warn", "kind": "judgment", "detect": "样式化的 <select> 未显式设 color / background", "fix": "显式设 select 的 fg/bg 以匹配当前主题" }
+  ]
+}

package/tooling/scripts/evals/transition-all/after/example.css

@@ -0,0 +1,4 @@
+/* after —— 只过渡具体属性(opacity / transform) */
+.q1-card {
+  transition: opacity 200ms ease, transform 200ms ease;
+}

package/tooling/scripts/evals/transition-all/before/example.css

@@ -0,0 +1,4 @@
+/* before —— 违反 Q1-DS-401(注释不得含规则字面量,否则自身会被 lint 命中) */
+.q1-card {
+  transition: all 200ms ease;
+}