@keyfunc/keybricks-ds 2.7.0 → 2.8.0

package/DEPLOY.md

@@ -55,11 +55,11 @@ deploys the documentation site. Watch it under *Build → Pipelines*.
 **5. Cut the first release.**
 
 ```bash
-git tag v2.7.0 && git push --tags
+git tag v2.8.0 && git push --tags
 ```
 
 That tag runs `generated:check` → `version:check` → `npm publish`. Confirm under *Deploy →
-Package Registry*: `@keyfunc/keybricks-ds` 2.7.0.
+Package Registry*: `@keyfunc/keybricks-ds` 2.8.0.
 
 **6. Hand developers two things:** the Pages URL, and the `.npmrc` snippet in §4 below.
 
@@ -187,7 +187,7 @@ GitLab injects `CI_JOB_TOKEN` — use that instead and no secret is stored anywh
 **Install — straight from git** (no registry, no publish; works today)
 
 ```json
-"@keyfunc/keybricks-ds": "git+ssh://git@gitlab.epm2demo.cn/Felix/keybricks-ds.git#v2.7.0"
+"@keyfunc/keybricks-ds": "git+ssh://git@gitlab.epm2demo.cn/Felix/keybricks-ds.git#v2.8.0"
 ```
 
 Because the package has no build step, a git dependency needs no `prepare` script — npm

package/DESIGN.md

@@ -164,6 +164,13 @@ with a hairline ring), `flush` (white rail), `contrast` (rail scoped to the dark
 `Button variant="ai"` hand the question to the Prophet AI panel) and, on the right, notifications, help and the user trigger, which opens `UserMenu` (identity,
 appearance switch, rows).
 
+### One component per job — team rule
+
+Notices are `Toast` / `ToastStack`; dialogs are `Modal`. Vue code that opens them from a function call uses `Message` / `MessageBox`
+(`_vue-services/`), which render with those same components — never a copy of their styles. Before building a new component,
+check the component list; build one only when nothing fits, and please check with Felix first. Placement: `ToastStack` defaults to
+bottom-right inside a page; app-wide messages from `Message` sit top-center.
+
 ### Global Search field — a sanctioned exception
 
 The collapsed `GlobalSearch` field uses `SearchInput`'s box at rest (`--bg-surface`, 1px `--border-control`, `--radius-md`, muted
@@ -372,7 +379,7 @@ section title and 32px ghost buttons share it comfortably.
 
 **Chrome** (fixed, not tiered): `--sidebar-w` 240 · `--rail-w` 64 · `--topbar-h` 56 ·
 `--panel-w` 400 · `--drawer-h` 250 · `--h-nav-item` 36 · `--h-subnav-item` 32 ·
-`--h-tree-item` 32.
+`--h-tree-item` 32 (DocTree; `Tree` follows the size tier — `--control-h`, sm 28 · md 32 · lg 40).
 
 **Page rhythm**: `--page-pad-y` 24px · `--page-pad-x` 32px · `--section-gap` 24px ·
 `--card-pad` 21px (`--card-pad-sm` 17px for dense cards). Gaps inside a bar come from the tier:

package/INTEGRATION.md

@@ -31,7 +31,7 @@ Not using a registry yet? A git dependency works with no publishing at all — t
 has no build step, so npm can use the checkout as-is:
 
 ```json
-"@keyfunc/keybricks-ds": "git+ssh://git@gitlab.epm2demo.cn/Felix/keybricks-ds.git#v2.7.0"
+"@keyfunc/keybricks-ds": "git+ssh://git@gitlab.epm2demo.cn/Felix/keybricks-ds.git#v2.8.0"
 ```
 
 **Source-only package.** `.jsx` and `.vue` files are published as authored, so your
@@ -523,6 +523,22 @@ Pin a minor range and update deliberately:
 - **Tokens outside CSS.** `tokens.json` / `tokens.js` / `tokens.d.ts` gained the tier tokens
   (`--control-*`, `--bar-h`, `--group-gap`, …) — 352 light tokens in all (2.0.2 adds `--danger-soft-hover`).
 
+### 2.8.0
+
+No API removed.
+
+> **Team rule — read before adding UI.** Notices and dialogs use `Toast` / `ToastStack` and `Modal`; in Vue, call them through `Message` / `MessageBox`, which render with exactly those components. Before building any new component, look for one in the component list (this file's index and the documentation site). Build a new one only when nothing there fits — please check with Felix first. Copying a component's look into a new file is not allowed: every look lives in one component.
+
+- **`Modal`** — always: focus moves in (`[data-autofocus]` first), Tab stays inside, Esc closes the topmost dialog, the page behind stops scrolling, focus returns on close. New optional props: `closeOnEsc`, `closeOnScrim`, `showClose`, `lockScroll`, `scrim`, `autoFocus` (all default `true`), `alert` (`role="alertdialog"`), `zIndex`, `closeLabel`. `onClose(reason)` / Vue `@close(reason)` gets `"close" | "esc" | "scrim"`. React `title` takes any node; Vue adds a `#title` slot.
+- **`ToastStack`** — `placement` (`"bottom-right"` default · `"top-center"` · `"top-right"` · `"bottom-center"`), `offset`, `duration` (auto-dismiss, paused on hover / focus; per-item override), `zIndex`. Items gain `content`, `icon`, `count` (`× n`, restarts the timer), `dismissible`, `closeLabel`, `className` / `class`, `style`. `onDismiss(id, "close" | "timeout")`.
+- **`Toast`** — `count` prop; `role="status"` (danger / warning: `role="alert"`).
+- **Vue `Message` / `MessageBox`** now render with `ToastStack placement="top-center"` + `Toast`, and `Modal` + `Button` + `Input` / `Textarea`. Their own dialog styles and `MessageView.vue` are gone. Message stacks 8px apart (was 16).
+
+- **`Table rowOpen`** — `"title"` (default, as before) | `"row"`. With `"row"` and `onRowOpen` (Vue `@row-open`), a click anywhere on a body row calls `onRowOpen(row, index, event)` and the row shows the hand cursor. Not on buttons (⋯, tree arrow), checkboxes, inputs, links, menus, the header, resize handles, or a click that ends a text selection. The twoLine tile and title open once, never twice. Tree folders: decide in `onRowOpen` whether to expand or enter.
+- **`Tree` follows the size tier** of its region: row `--control-h` (sm 28 · md 32 · lg 40), text `--control-text` / `--control-leading` / `--control-tracking`, glyph `--control-icon` − 1px. md is pixel-identical to before; `--h-tree-item` is no longer read by Tree.
+- **Vue `Message` / `MessageBox` source moved** from `components/feedback/` to `_vue-services/` (Vue-only services kept apart from the React + Vue components). Imports are unchanged: `@keyfunc/keybricks-ds/vue/message` and `/vue/message-box`. If you imported the files by path, update it.
+- **`Tree` node `icon: false`** — no glyph and no gap on that row, even with `showIcon` on (e.g. a "Documents" root).
+
 ### 2.7.0
 
 No API removed. Vue merges the 2.6.0 Button / Toast work above; React gets the same props.
@@ -541,7 +557,7 @@ No API removed. Vue merges the 2.6.0 Button / Toast work above; React gets the s
 - Vue Button 支持原生点击事件、组件 / VNode 图标、图标及加载插槽、独立尾部图标、后备文本和原生按钮类型；旧 actnplanBtn 的适配方式见 [按钮适配说明](components/buttons/BUTTON_MIGRATION.md)。Vue 专用声明位于 `Button.vue.d.ts`，React 接口保持原样。
 - Vue 新增 `@keyfunc/keybricks-ds/vue/message` 和 `@keyfunc/keybricks-ds/vue/message-box` 命令式服务入口；提供消息堆叠与分组，以及 alert / confirm / prompt、输入校验、关闭拦截、应用上下文和可配置默认文案。
 - 复用现有 DS 控件，补充 Toast 默认内容、图标插槽及可配置关闭按钮标签。
-- 与 Element Plus 的 API 对照、接入示例和兼容边界见 [消息服务迁移说明](components/feedback/MESSAGE_SERVICES.md)。不承诺所有 Element Plus 功能及样式完全兼容。
+- 与 Element Plus 的 API 对照、接入示例和兼容边界见 [消息服务迁移说明](_vue-services/MESSAGE_SERVICES.md)。不承诺所有 Element Plus 功能及样式完全兼容。
 - 本次仅修改源码及发布元数据；未执行测试、类型检查、构建、生成脚本或浏览器验证，发布前需同步生成产物中的版本元数据。
 
 

package/_adherence.oxlintrc.json

@@ -24,7 +24,6 @@
               "components/data/**",
               "components/display/**",
               "components/feedback/**",
-              "components/feedback/_internal/**",
               "components/forms/**",
               "components/icons/**",
               "components/navigation/**",