@wisdomgarden/torque-knowledge 0.1.2

package/LICENSE

@@ -0,0 +1,101 @@
+                          WisdomGarden License
+                       Version 1.0, September 2026
+
+              Copyright (c) 2026 WisdomGarden. All rights reserved.
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean WisdomGarden, the copyright owner of the Work.
+
+      "Work" shall mean the software made available under this License,
+      including its source code, object code, documentation, design assets,
+      and any accompanying files.
+
+      "You" shall mean an individual or Legal Entity exercising permissions
+      granted by this License.
+
+      "Authorized User" shall mean (a) WisdomGarden and its affiliates, and
+      (b) any Legal Entity that has entered into a valid commercial agreement
+      with WisdomGarden covering a WisdomGarden product, for the duration of
+      that agreement and solely in connection with that product.
+
+   2. Grant of Copyright License.
+
+      Subject to the terms of this License, Licensor grants to each Authorized
+      User a non-exclusive, non-transferable, non-sublicensable, revocable,
+      royalty-free license to use, reproduce, and modify the Work, and to
+      incorporate the Work into products operated by or on behalf of that
+      Authorized User, solely for that purpose.
+
+   3. Grant of Patent License.
+
+      Subject to the terms of this License, Licensor grants to each Authorized
+      User a non-exclusive, non-transferable, revocable, royalty-free patent
+      license to make and use the Work, limited to those patent claims
+      licensable by Licensor that are necessarily infringed by the Work alone.
+      If You institute patent litigation against any entity alleging that the
+      Work constitutes patent infringement, any license granted to You under
+      this License terminates as of the date such litigation is filed.
+
+   4. Restrictions.
+
+      Except as expressly permitted by Section 2, You may not:
+
+      (a) use the Work if You are not an Authorized User;
+
+      (b) distribute, sublicense, sell, rent, or lease the Work, or any
+          derivative of it, to any third party;
+
+      (c) use the Work to build, operate, or offer a product that competes
+          with any WisdomGarden product; or
+
+      (d) remove or obscure any copyright, trademark, or other proprietary
+          notice contained in the Work.
+
+      The Work may be publicly downloadable from a package registry. Public
+      availability does not grant any license beyond what this document
+      states.
+
+   5. Redistribution.
+
+      Redistribution of the Work as a standalone library is not permitted. An
+      Authorized User may deploy the Work as part of a product it operates,
+      provided the Work is not offered to third parties on its own.
+
+   6. Trademarks.
+
+      This License does not grant permission to use the trade names,
+      trademarks, service marks, or product names of Licensor, including
+      "WisdomGarden" and "Torque Design", except as required for reasonable
+      and customary use in describing the origin of the Work.
+
+   7. Disclaimer of Warranty.
+
+      THE WORK IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR
+      CONDITIONS OF ANY KIND, either express or implied, including, without
+      limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT,
+      MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely
+      responsible for determining the appropriateness of using the Work and
+      assume any risks associated with Your exercise of permissions under
+      this License.
+
+   8. Limitation of Liability.
+
+      IN NO EVENT AND UNDER NO LEGAL THEORY SHALL LICENSOR BE LIABLE TO YOU
+      FOR DAMAGES, INCLUDING ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
+      CONSEQUENTIAL DAMAGES OF ANY CHARACTER ARISING AS A RESULT OF THIS
+      LICENSE OR OUT OF THE USE OR INABILITY TO USE THE WORK, even if
+      Licensor has been advised of the possibility of such damages.
+
+   9. Termination.
+
+      This License terminates automatically if You breach any of its terms,
+      or when You cease to be an Authorized User. Upon termination You must
+      cease all use of the Work and destroy all copies in Your possession.
+
+   END OF TERMS AND CONDITIONS

package/README.md

@@ -0,0 +1,93 @@
+# @wisdomgarden/torque-knowledge
+
+**这个包是给机器读的，不是给人读的。** 人读的组件文档在
+[`@wisdomgarden/torque-doc`](../torque-doc)（文档站），组件本身在
+[`@wisdomgarden/torque`](../torque)。
+
+它把组件库的知识打包成一个可发布、可版本寻址的 artifact，供两个消费端取用。
+包里不含任何运行时代码，**不要 `import` 它** —— 没有 `main` / `exports`，
+消费端是 `npm pack` 之后解包取文件。
+
+## 产物
+
+| 文件 | 给谁 | 是什么 |
+| --- | --- | --- |
+| `dist/torque-components.md` | **diting**（`lms-web` 的 CI code review） | 选型决策树 + 可用组件全表 + 硬约束 + 禁止事项。带 diting 认的 frontmatter（单行 `keywords` / `globs`），解包进它的 `rule_dirs` 就能被召回 |
+| `dist/components.db` | **`lms-web` 的本地 MCP** | SQLite 组件目录，`search_component()` 的数据源。44 个组件的导出名、英文描述、keywords 和完整 props |
+| `dist/.meta.json` | CI / 下游漂移检测 | `{ knowledge, torque, generatedAt }` —— 这份知识是哪个版本、描述的又是哪个 torque 版本 |
+
+## 版本与 `@wisdomgarden/torque` 相互独立
+
+四个包各自独立版本号，这个包的 version **没有**和 `torque` 相等的义务 ——
+`knowledge@0.2.0` 描述 `torque@0.1.5` 是完全正常的状态。
+
+下游取的是 `latest`（`npm pack @wisdomgarden/torque-knowledge@latest`），
+不经过 lockfile —— 因为把它装成 `devDependency` 会让 `lms-web` 的 base image
+（1642 个包）在每次知识更新时重建，而这个包有时只改了几句描述。
+
+代价是版本对齐从「精确」降成「有窗口」，靠漂移检测兜住：`dist/.meta.json` 的
+`torque` 字段记着这份知识描述的是哪个版本，下游拿它和自己装的 `torque` 比对。
+**所以那个字段是必须的，不是锦上添花** —— 上游不落地 `.meta.json`，
+下游的漂移检测就是恒静默的，不报错也不会有人发现。
+
+## 构建
+
+```bash
+pnpm --filter @wisdomgarden/torque-knowledge build
+```
+
+`dist/` 是构建产物，不入库。仓库根的 `pnpm build` 会自动带上这个包。
+
+## 源与数据流
+
+```
+packages/torque/src/index.ts              ← 组件清单的唯一来源（不是 readdir）
+packages/torque/src/components/*/readme.md ← 39 篇，props 和中文描述
+packages/torque/src/provider/readme.md     ← 第 40 篇
+src/fallback.json                          ← 全部 44 个组件的英文描述（手工维护）
+src/handwritten/*.md                       ← 人工提炼的正文片段
+        │
+        └──> scripts/gen.mjs ──> dist/
+```
+
+机械的部分（扫源码、解析 props、产 db 和组件全表）在 `gen.mjs` 里，每次 `pnpm build`
+都跑。需要判断力的部分（读懂 readme 提炼选型/约束、复核英文描述）在
+`.claude/skills/torque-knowledge/` 这个 skill 里。
+
+`scripts/check-changes.mjs` 是两者之间的闸门：
+
+```bash
+node scripts/check-changes.mjs --check-only   # 只问「有活吗」，不写缓存、不生成
+node scripts/check-changes.mjs                # 有变化就顺便重新生成
+```
+
+退出码是契约：`0` 有变化 / `1` 无变化 / `2` 有变化但生成失败。
+`--check-only` 的意义是让调用方先判断要不要花一次 AI 调用 —— lms-web 实测 22 个生产日里
+有 21 天没活干。缓存在 `.cache/changes.json`（gitignore）。
+
+`gen.mjs` 和 `check-changes.mjs` 共用 `scripts/lib/parse-barrel.mjs` 解析组件清单。
+**别在任一个里重写一遍正则** —— 两份必然漂移，一个认得 `StickyBox` 另一个不认得，
+变更检测就会报出永远修不掉的假变化。
+
+几件容易踩的事，改 `gen.mjs` 前先看一眼：
+
+- **组件清单从 barrel 推，不要 `readdir`。** `components/sticky-box.tsx` 是裸文件、
+  没有目录也没有 readme，但公开导出 `StickyBox`；`_inner/` 则不该暴露。barrel 两个问题都没有。
+- **`components.db` 的 schema 是硬契约。** `lms-web` 的 reader 按字段名取值，
+  改了名那边静默返回 `undefined`，不会报错。
+- **db 保持默认的 `DELETE` journal 模式，不要设 WAL。** WAL 标记会持久化进 db header，
+  产物在只读目录下会直接打不开。
+- **`torque-components.md` 的 frontmatter 是 diting 的硬契约**：`keywords` / `globs`
+  必须单行逗号分隔（它用 `^keywords:\s*(.*?)$` 解析，多行 YAML 数组会静默变成空），
+  且**不能**设 `alwaysApply: true`（那等于每次 review 都全量注入）。
+- **`gen.mjs` 不写回 `src/fallback.json`。** 缺 entry 就报错退出，由人补。
+  写回会让 `pnpm build` 变成改动被追踪源文件的操作。
+- **不要给这个包加 npm 依赖。** 它会被解包进 CI 环境，只用 Node 内置模块。
+
+## 新增组件之后
+
+1. 在 `packages/torque/src/index.ts` 里导出它（`gen.mjs` 从这里认组件）
+2. 往 `src/fallback.json` 加一条**英文**的 `whenToUse` + `keywords` ——
+   不加的话 `pnpm build` 会直接报错退出，并把建议的起手式打出来
+3. 组件有 readme 的话，props 会自动解析出来（表格或 `- \`name?: Type\`: 说明` 列表都认）
+4. 如果它带来了新的硬约束或禁止事项，补进 `src/handwritten/`

package/dist/.meta.json

@@ -0,0 +1,5 @@
+{
+  "knowledge": "0.1.2",
+  "torque": "0.1.2",
+  "generatedAt": "2026-09-16T14:28:56.156Z"
+}

package/dist/torque-components.md

@@ -0,0 +1,208 @@
+---
+description: Torque UI component library — selection priority, available components, and hard constraints.
+globs: src/**/*.{tsx,ts}
+keywords: torque, component, ui, mantine, layout, button, icon-button, link-button, link-icon-button, tooltip, popover, drawer, bottom-drawer, modal, menu, message, notifications, alert, sticky-box, tag, tab, table, table-pagination, tree, tree-select, virtualized-tree-select, date-picker, filter, data-filter, base-input, form-wrapper, text-input, text-area, number-input, password-input, checkbox, radio, switch, select, multi-select, combobox, box, text, flex, group, stack, paper, unstyled-button, provider, iconbutton, linkbutton, linkiconbutton, bottomdrawer, messages, stickybox, tabs, tablepagination, treeselect, virtualizedtreeselect, datepicker, datafilter, baseinput, formitemwrapper, textinput, textarea, numberinput, passwordinput, multiselect, unstyledbutton, uiprovider
+---
+
+# Torque UI 组件库
+
+> 由 `@wisdomgarden/torque-knowledge@0.1.2` 生成，对应 `@wisdomgarden/torque@0.1.2`。
+> 不要手改 —— 它是 npm 包解包出来的，下次装依赖就被覆盖。
+
+## 导入方式
+
+一切都从**包根**导出，没有子路径导入：
+
+```tsx
+import { Button, Select, Stack, Text, messages, drawers } from '@wisdomgarden/torque';
+```
+
+`@wisdomgarden/torque-icons` 的图标已在包根**再导出**，不要单独去装、去导。
+`lms-web` 侧的 barrel `@/ui/base` 就是对本包的一层转发，两种写法等价。
+
+配置入口只有 `UiProvider` 一个，必须在 `'use client'` 边界内 —— 它接收组件引用，
+Server Component 序列化不了。
+
+## 选型决策树
+
+**优先级：`@wisdomgarden/torque` > `className` + Tailwind 自行扩展 > Mantine 兜底。**
+
+**布局与文本**
+
+| 需求 | 用 |
+| --- | --- |
+| 视觉表面（卡片 / 面板 / 弹窗内容区） | `Paper` |
+| 水平排列 + 垂直居中（按钮组、标签行、工具栏） | `Group` |
+| 垂直排列（表单字段、列表项、页面区块） | `Stack` |
+| 要响应式换方向，或对齐方式不是前两者的默认值 | `Flex` |
+| 不需要布局，只是替代裸 `<div>`（含响应式显隐） | `Box` |
+| 文本：字号 / 字重 / 截断 / 语义标签 | `Text` |
+| 自定义点击区（整卡可点、图片热区） | `UnstyledButton` |
+| 有明确按钮样式变体 | `Button`；纯图标 `IconButton`；跳转 `LinkButton` / `LinkIconButton` |
+
+`Box` 替代 `<div>`；`Text` 替代 `<span>` / `<p>`，用 `component` 选语义标签
+（`h1`–`h6` / `p` / `span`）；`UnstyledButton` 替代 `<button>`。
+`Paper` 不参与布局 —— 内部要排版就在里面嵌 `Flex` / `Group` / `Stack`。
+
+`Group` / `Stack` 是 `Flex` 的预设，只是默认值不同：`Group` = `align: center` +
+`wrap` + `gap: md`；`Stack` = `align: stretch` + `nowrap` + `gap: md`；
+`Flex` = `align: stretch` + `nowrap` + 无 gap。**默认值合适就别用 `Flex`。**
+
+**下拉与选择** —— 标准表单字段用 `Select`（单选）/ `MultiSelect`（多选，值是
+`string[]`）；要自定义触发器外观或富选项内容（头像、标签）才用 `Combobox`；
+树形数据用 `TreeSelect`，大到需要虚拟滚动用 `VirtualizedTreeSelect`；
+纯筛选触发器（不是表单字段）用 `Filter` / `MultiFilter` / `IconFilter`；
+**业务数据筛选区一律用 `DataFilter`**，哪怕当前只有一个筛选项。
+
+**反馈与浮层** —— 一句话轻提示无交互用 `messages.showXxx()`；有标题 + 详情、带操作
+按钮或文本较长用 `notifications.showXxx()`；页面内常驻状态条用 `Alert`；
+侧边抽屉优先指令式 `drawers.open()`，需要复杂局部状态联动才用声明式 `<Drawer>`；
+移动端底部抽屉用 `BottomDrawer`（**只在移动端**）；悬停提示 `Tooltip`；
+需要交互内容的浮层 `Popover`；操作菜单 `Menu`。
+
+**多态（`component` prop）** —— 自建布局组件**只接受 HTML 标签字符串**，Server 和
+Client Component 都安全。Mantine 的 `component={ReactComponent}` 只能在 Client
+Component 里用（函数跨 Server/Client 边界无法序列化）。
+
+## 可用组件全表
+
+全部从 `@wisdomgarden/torque`（lms-web 侧是 `@/ui/base`）导出。
+完整 props 和完整描述查 `components.db`（MCP 的 `search_component()`），这里只给选型用的一句话。
+
+| 组件 | 导出名 | 何时使用 |
+| --- | --- | --- |
+| button | `Button` | General-purpose button with multiple variants (primary,… |
+| icon-button | `IconButton` | Icon-only button built on Button |
+| link-button | `LinkButton` | Button-looking navigation component with native <a> sem… |
+| link-icon-button | `LinkIconButton` | Icon-only navigation component with IconButton appearan… |
+| tooltip | `Tooltip` | Hover tooltip for short contextual help text or to reve… |
+| popover | `Popover`, `PopoverTarget`, `PopoverDropdown` | Floating popover component that displays content near a… |
+| drawer | `Drawer`, `DrawerManager`, `drawers` | Side panel sliding in from the right by default, with a… |
+| bottom-drawer | `BottomDrawer` | Bottom sheet that slides up from the bottom edge |
+| modal | `Modal` | PC-side modal dialog with a custom header (title + clos… |
+| menu | `Menu` | Responsive action menu |
+| message | `messages` | Imperative lightweight toast shown top-center, auto-clo… |
+| notifications | `notifications`, `Notification` | Imperative global notification popup shown top-right, a… |
+| alert | `Alert`, `AlertSkeleton` | Inline status banner with built-in icon, semantic color… |
+| sticky-box | `StickyBox` | Pin a block to the top or bottom of its nearest scroll… |
+| tag | `Tag` | Compact label/badge for categorization, status, or meta… |
+| tab | `Tabs`, `TabsTab`, `TabsList`, `TabsPanel` | Primary tab navigation with Tabs, TabsList, TabsPanel,… |
+| table | `Table`, `TableSkeleton` | Data table with sortable columns, row selection, and a… |
+| table-pagination | `TablePagination`, `Pagination`, `getPaginationRange` | Standard pagination bar for tables: page numbers, a per… |
+| tree | `Tree` | Hierarchical tree component for displaying nested data… |
+| tree-select | `TreeSelect` | Hierarchical tree selector with dropdown support, check… |
+| virtualized-tree-select | `VirtualizedTreeSelect` | Virtualized hierarchical tree dropdown for selecting fr… |
+| date-picker | `DatePicker`, `TimePicker`, `DateTimePicker`, `DateRangePicker` | Date and time selection components including DatePicker… |
+| filter | `Filter`, `IconFilter`, `MultiFilter` | Filter triggers built on Select/MultiSelect that open a… |
+| data-filter | `DataFilter` | The shared, business-agnostic container for data-filter… |
+| base-input | `BaseInput`, `BaseInputTarget`, `BaseInputWrapper` | Foundation input component providing the base structure… |
+| form-wrapper | `FormItemWrapper`, `FormItemWrapperDefaultsProvider`, `useFormItemWrapperDefaults` | Wrap a form field with a consistent label, helper text,… |
+| text-input | `TextInput` | Standard single-line text input field |
+| text-area | `TextArea` | Multi-line text input for longer free-form content such… |
+| number-input | `NumberInput` | Numeric text field with increment/decrement stepper but… |
+| password-input | `PasswordInput` | Password field with a show/hide visibility toggle |
+| checkbox | `Checkbox` | Checkbox for a single boolean choice and CheckboxGroup… |
+| radio | `Radio` | Radio button and RadioGroup for mutually exclusive sing… |
+| switch | `Switch`, `SwitchGroup` | Toggle switch for a single boolean on/off setting |
+| select | `Select` | Single-value dropdown selector |
+| multi-select | `MultiSelect` | Multi-value selector rendered as an input field with se… |
+| combobox | `Combobox`, `useCombobox`, `useComboboxContext` | Compound dropdown selection component with desktop Popo… |
+| box | `Box` | The most basic layout primitive, a drop-in replacement… |
+| text | `Text` | Text rendering primitive built on Box, adding font size… |
+| flex | `Flex` | Generic flexbox container with full CSS flex control |
+| group | `Group` | Horizontal row layout with default center alignment, wr… |
+| stack | `Stack` | Vertical column layout with default stretch alignment a… |
+| paper | `Paper` | Visual surface container (card/panel) with raised backg… |
+| unstyled-button | `UnstyledButton` | Button without any default styling — a blank slate for… |
+| provider | `UiProvider`, `UiContext`, `DefaultUiLink`, `useLocale` | UiProvider is the single configuration entry point for… |
+
+## 硬约束
+
+每一条都会**直接导致 bug 或规范违规**，不是风格偏好。来源是各组件 readme 的
+「AI 编码最佳实践 & 注意事项」。
+
+### 表单
+
+- **传了 `form` + `fieldName` 就不要再传 `value` / `onChange` / `error`**，组件会从
+  `form.getInputProps` 自己取，两边都传会互相覆盖。（`TextInput` / `TextArea` /
+  `NumberInput` / `DatePicker` 系列 / `TreeSelect`）
+- **表单控件已内置 `FormItemWrapper`**，外面不要再包 `Field` / `Form.Item`，
+  `DataFilter` 里的 `Select` 也一样 —— 会出现重复 label。
+- **`TextInput` / `TextArea` 的字数统计要求受控或绑表单。** 非受控且没传 `form` 时
+  组件读不到当前长度，`maxLength` 计数不更新。
+- **`CheckboxGroup` 内的 `Checkbox` 不要手动绑 `checked` / `onChange`**，会被 Context
+  覆盖，只传 `value`。
+- **`Switch` 的 `onChange` 参数是原生 `ChangeEvent`**，取值要 `e.currentTarget.checked`。
+- **`NumberInput` 的 `onChange` 可能给到 `string`**（清空时是 `''`），不只是 `number`。
+- **`MultiSelect` 的 `value` 是 `string[]`**，初始值写 `[]`，不是 `''` / `null`。
+
+### 加载与禁用
+
+- **`loading={true}` 已经等于禁用**（不只是样式，`onClick` 也会被阻断）。提交表单只写
+  `loading={isSubmitting}`，不要再加 `disabled`。（`Button` / `IconButton`）
+- **不要用原生 `disabled` 控制 `Button` / `IconButton`**，用组件的 `disabled` prop ——
+  内部会处理 `aria-disabled` / `tabIndex` / `data-disabled`。
+  （`UnstyledButton` 相反，它就用原生 `disabled`。）
+
+### 浮层与移动端
+
+- **`DataFilter` 里的下拉控件（`Select` / `MultiSelect` / `TreeSelect` / `DatePicker`）
+  保持 `withinPortal` 默认的 `true`，不要设 `false`** —— 设了下拉层会被 DataFilter 的
+  滚动容器裁剪。嵌套浮层的外部点击、焦点范围、层级和逐层 Escape 由基础 `Popover` 统一处理。
+- **移动端标题靠 `placeholder` / `title`**（`Select` / `MultiSelect` 用前者，
+  `Menu` / `Combobox.Dropdown` / `Filter` 用后者）。桌面端可能不显示，但在移动端
+  它是底部弹层的标题，不传就是没标题。
+- **`BottomDrawer` 只用于移动端**，PC 端用 `Drawer`。
+- **`messages.showXxx` / `notifications.showXxx` 是副作用**，只能在事件处理函数或
+  `useEffect` 里调，**严禁**在渲染主体里调。
+- **`Combobox.Target` / `Popover.Target` 只接受单个 React 元素**（内部走 `cloneElement`），
+  多个元素或 Fragment 会报错。
+- **不要在 `Combobox.Option` 里嵌 `<button>`** —— `role="option"` 的点击由组件接管，
+  再放交互元素会触发 a11y 的 `nested-interactive` 违规。
+- **不要给 `Filter` / `IconFilter` 的 `buttonProps` / `iconButtonProps` 传 `onClick`**，
+  会覆盖内置的弹层开关，导致弹不出来。
+
+### 文本与截断
+
+- **`Text` 的 `truncate` 必须有明确宽度限制**（父容器或自身），否则截断不生效。
+- **文本溢出才显示 Tooltip 用 `showOnlyWhenTruncated`**，不要自己写测量逻辑；
+  多行用 `truncateMaxLines`。
+- **`Text` 没有颜色 prop**，颜色走 `className`（如 `text-fg-secondary`）。
+
+### 其他
+
+- **`Table` 用 `tableColumns` 传列配置，不是原生的 `columns`**，传错会类型报错或自定义
+  渲染失效。加载态用 `TableSkeleton`。空单元格占位、文本截断和 Tooltip 都已内置，
+  不要重复实现。
+- **`Menu` 的破坏性操作用 `dangerous: true` 标记**，不要用 `className` 改颜色。触发器要
+  跟随展开状态时用 `renderTarget={({ opened }) => ...}`，**不要**自己维护 `isOpen`。
+- **`Alert` 自己管关闭状态**，父组件不需要维护 `visible` / `onClose`。
+- **`Tabs` 切换默认卸载其他 Panel**，Panel 里有表单或音视频时必须设
+  `keepMounted={true}`。吸顶时 `sticky` 加在 `Tabs.List` 的**外层** `div` 上
+  （`overflow="scroll"` 时内部有独立滚动容器）。
+- **`Select` 的搜索是自动的** —— 选项数超阈值会自动开启，不要手写 `searchable`，
+  只有要违背默认行为时才显式传值。
+- **`Tree` 的 `defaultExpandedIds` 只放真正需要默认可见的节点**，不要递归收集全部。
+  懒加载场景必须显式传 `isItemFolder`，否则 `children` 为 `undefined` 的节点会被误判成叶子。
+- **`UnstyledButton` 在表单里必须显式 `type="button"`**，否则会意外触发提交。
+- **`IconButton` 必须给 `aria-label` 或 `title`** —— 它没有可见文字。
+- **日期选择器除 `DatePicker` 外都是草稿模式** —— 弹层里的操作只改临时状态，点「确定」
+  才触发 `onChange`。没立刻触发不是 bug。
+
+## 禁止事项
+
+- ❌ **从 `@mantine/core` 导入 `Box` / `Text` / `Flex` / `Group` / `Stack` / `Paper` /
+  `UnstyledButton`。** 这些在 `@wisdomgarden/torque` 里都有同名替代品，行为和默认值
+  是本设计系统的，不是 Mantine 的。其他 Mantine 交互组件同理 —— 库里有的一律用库里的。
+- ❌ **Mantine style props**：`p` / `m` / `bg` / `c` / `fz` / `fw` / `sx` / `styles`。
+  一律用 `className` + Tailwind。（`Flex` / `Group` / `Stack` 的 `gap` / `align` /
+  `justify` 是本库自己的 props，接受设计 token，不在此列。）
+- ❌ **`--mantine-*` CSS 变量。** 用 `--t-*` 或 Tailwind 类。
+- ❌ **任意值**（`p-[16px]` 这种）。只用设计 token。
+- ❌ **手写 dark mode 分支。** `--t-*` 颜色自动适配，不要按主题条件切换颜色。
+- ❌ **在 Server Component 里用 `component={ReactComponent}`**（Next 16 限制）。
+  标签字符串形式的 `component="form"` 两边都安全。
+- ❌ **裸 `<div>`**，尤其是需要 `hiddenFrom` / `visibleFrom` 的地方 —— 用 `Box`。
+- ❌ **重新实现业务筛选容器、折叠行为或触发器** —— 用 `DataFilter`。
+- ❌ **直接调用 `@mantine/notifications` 的 `showNotification`** —— 用 `messages` / `notifications`。
+- ❌ **组件不支持 dark mode / 响应式 / i18n（5 语言）/ a11y / ltr-rtl。**

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@wisdomgarden/torque-knowledge",
+  "version": "0.1.2",
+  "description": "Machine-readable knowledge artifact for @wisdomgarden/torque — component catalog (SQLite) and AI coding rules (Markdown). Consumed by CI code review and local AI tooling, not by application runtime.",
+  "type": "module",
+  "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">=22.13"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "node scripts/gen.mjs"
+  }
+}