@shwfed/config 3.0.6 → 3.0.8

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "shwfed",
   "configKey": "shwfed",
-  "version": "3.0.6",
+  "version": "3.0.8",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/runtime/components/actions/ai-l1.md

@@ -0,0 +1,24 @@
+你正在配置一组操作按钮（actions）。一组操作由**按钮组**（group）与**按钮项**（item）构成：每个按钮属于一个组，组只用于视觉分段。发现式推进：先 `list_available_button_types` / `describe_specific_button_type` 看清可用按钮类型与其配置契约，再增删配置；配完 `leave_node` 返回。
+
+## 增删按钮
+
+- `insert_action_group` 建组（可设默认变体），`insert_button` 新增按钮（不传 `groupId` 则自动建一个新组）。按钮初始只有身份，动作字段留空——像人手动「先加后配」，随后用 `configure_button` 补齐（必填字段未填时校验会提示）。
+- `insert_dropdown` 建下拉菜单，`insert_button({ dropdownId })` 往下拉里加子按钮。
+- `set_action_item` 配按钮外观（标题、图标、变体、仅图标，以及 CEL 的 `hidden` / `disabled` 条件）；`configure_button` 配按钮**行为**（各类型自己的字段 + 触发链）。
+- `list_action_groups` / `list_action_items` / `delete_action_groups` / `delete_action_items` 管理。
+
+## 触发接线（trigger）
+
+多数按钮的行为是**向上冒泡的操作请求**：请求某个祖先实例执行它的一个操作。一条触发行是 `{ target, operation, params }`：
+
+- `target` 是目标实例 id，**必须**取自 `describe_event_targets`（它按当前位置列出可达目标：页面、外层表格 / 树、以及承载当前弹窗的按钮）。
+- `operation` 是该目标暴露的操作 id。目标里带 `compatibilityDate` 的是**参数化操作**——用 `list_operations` 查其 `params` 契约（JSON Schema）；不带的是无参操作（如表格的 `search` / `reset-query`、页面的 `close`、表单的 `validate`）。
+- 触发字段名由按钮类型决定（`describe_specific_button_type` 的 `triggerFields` 会点名，如 `triggers` / `before` / `onSuccess`）。用 `configure_button` 把触发行写进对应字段。
+
+常见接线：搜索按钮 → `触发事件`，触发目标表格的 `search`；重置按钮 → 触发目标表格的 `reset-query`；提交按钮 → `请求`，`before` 里先触发表单 `validate`（校验未过则中止），`onSuccess` 里再刷新表格。
+
+**链步引用（`steps`）**：触发行按顺序串行执行，发布输出的操作（如「发送请求」，见 `list_operations` 的 `output`）把结果存到该行 `id` 名下，后续行的 CEL 经 `steps[?"<该行 id>"]` 读取——例如先「发送请求」取下载凭据、再「下载文件」引用它。需要被引用的行请**自带一个新 UUID 作 `id`**（这是行输出的稳定地址，重排也不变）；不引用输出的行可省略 `id`，写入时会自动补上。
+
+## 模态窗口按钮
+
+`模态窗口` 按钮点击后弹出一个含块的弹窗，其内容是一个页面槽（page-slot）。`describe_specific_button_type` 里 `drillable: true` 即表示可钻入——`enter_node` 进入后用页面块工具族在弹窗内搭块。关闭弹窗的触发目标是**承载弹窗的按钮实例**（不是弹窗本身）。

package/dist/runtime/components/actions/buttons/2026-04-18/com.shwfed.actions.button.prototype/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-04-18";
 export declare const metadata: {
     readonly name: "原型";
     readonly icon: "fluent:predictions-20-regular";
+    readonly description: "占位按钮，点击无副作用；先占位、之后可一键转换为其它按钮类型";
 };
 export declare function schema(_configure: (env: Environment) => void): Schema.Struct<{
     type: Schema.Literal<["com.shwfed.actions.button.prototype"]>;

package/dist/runtime/components/actions/buttons/2026-04-18/com.shwfed.actions.button.prototype/schema.js

@@ -3,7 +3,8 @@ export const type = "com.shwfed.actions.button.prototype";
 export const compatibilityDate = "2026-04-18";
 export const metadata = {
   name: "\u539F\u578B",
-  icon: "fluent:predictions-20-regular"
+  icon: "fluent:predictions-20-regular",
+  description: "\u5360\u4F4D\u6309\u94AE\uFF0C\u70B9\u51FB\u65E0\u526F\u4F5C\u7528\uFF1B\u5148\u5360\u4F4D\u3001\u4E4B\u540E\u53EF\u4E00\u952E\u8F6C\u6362\u4E3A\u5176\u5B83\u6309\u94AE\u7C7B\u578B"
 };
 export function schema(_configure) {
   return Schema.Struct({

package/dist/runtime/components/actions/buttons/2026-05-11/com.shwfed.actions.button.modal.layout/prompt.md

@@ -0,0 +1,8 @@
+## 模态窗口按钮
+
+点击后弹出一个弹窗，弹窗内容是一个**页面槽**（可放任意块与布局）。
+
+- 配置弹窗外观用 `configure_button`：`modalTitle`（本地化标题，不填回退按钮名）、`modalWidth`（如 `720px` / `60vw`）、`modalMinHeight`。
+- 弹窗**内容**不在 `configure_button` 里配——它 `drillable`，用 `enter_node` 进入其内部页面槽，再用页面块工具族搭块（表格、表单等，可继续递归）。
+- 该按钮暴露一个 `close` 操作：弹窗里的「关闭」按钮要触发**这个按钮实例的 id**（承载弹窗者）的 `close`，而不是弹窗自身。
+- 弹窗内的块**继承打开处的作用域**：行操作弹窗内可直接引用 `row`，表单里的弹窗可直接引用 `form`。只有当弹窗内又嵌套了重新绑定同名变量的作用域（如弹窗里的表格行）、外层被遮蔽时，才需要 `__scopes__["<外层实例 uuid>"].row` 跨层寻址。

package/dist/runtime/components/actions/buttons/2026-05-11/com.shwfed.actions.button.modal.layout/schema.d.ts

@@ -2,9 +2,15 @@ import { Schema } from 'effect';
 import type { Environment } from '../../../../../vendor/cel-js/lib/index.js';
 export declare const type: "com.shwfed.actions.button.modal.layout";
 export declare const compatibilityDate: "2026-05-11";
+export declare const edges: readonly [{
+    readonly key: "slot";
+    readonly host: "slot";
+    readonly label: "弹窗内容";
+}];
 export declare const metadata: {
     readonly name: "模态窗口";
     readonly icon: "fluent:window-edit-20-regular";
+    readonly description: "点击后弹出一个包含一组块的弹窗；其内容是一个可继续配置的页面槽";
     readonly drillable: true;
     readonly operations: readonly [{
         readonly id: "close";

package/dist/runtime/components/actions/buttons/2026-05-11/com.shwfed.actions.button.modal.layout/schema.js

@@ -4,9 +4,13 @@ import { Slot, defaultSlot } from "../../../../../share/layout.js";
 import { lookupBlockRef } from "../../../../config/utils/block-ref-cache.js";
 export const type = "com.shwfed.actions.button.modal.layout";
 export const compatibilityDate = "2026-05-11";
+export const edges = [
+  { key: "slot", host: "slot", label: "\u5F39\u7A97\u5185\u5BB9" }
+];
 export const metadata = {
   name: "\u6A21\u6001\u7A97\u53E3",
   icon: "fluent:window-edit-20-regular",
+  description: "\u70B9\u51FB\u540E\u5F39\u51FA\u4E00\u4E2A\u5305\u542B\u4E00\u7EC4\u5757\u7684\u5F39\u7A97\uFF1B\u5176\u5185\u5BB9\u662F\u4E00\u4E2A\u53EF\u7EE7\u7EED\u914D\u7F6E\u7684\u9875\u9762\u69FD",
   drillable: true,
   operations: [
     { id: "close", name: "\u5173\u95ED\u5F39\u7A97", icon: "fluent:dismiss-20-regular" }

package/dist/runtime/components/actions/buttons/2026-05-15/com.shwfed.actions.button.event.dispatch/prompt.md

@@ -0,0 +1,8 @@
+## 触发事件按钮
+
+最通用的按钮：它自己不做任何事，只按顺序**触发一组操作**（`triggers`），每条 `{ target, operation, params }` 向某个祖先实例发一个操作请求。
+
+- 目标与操作先用 `describe_event_targets`（可达实例 + 各自操作）与 `list_operations`（参数化操作的 `params` 契约）查清；`target` 必须是前者返回的 id。
+- 典型用法：一个「搜索」按钮触发目标表格的 `search`；一个「重置」按钮触发目标表格的 `reset-query`；一个「关闭」按钮触发**承载弹窗的按钮实例**（不是弹窗本身）的 `close`。
+- 触发行按列表顺序串行执行，前一条中止（如表单「校验」未过、确认弹窗取消）会取消其后的行——把校验 / 确认放在最前面即可作为前置门。
+- 需要引用某个已发请求的响应时，用参数化的「发送请求」操作作为其中一行，后续行以 `steps[?"<该行 id>"]` 读取其输出。

package/dist/runtime/components/actions/buttons/2026-05-15/com.shwfed.actions.button.event.dispatch/schema.d.ts

@@ -6,6 +6,7 @@ export declare const compatibilityDate: "2026-05-15";
 export declare const metadata: {
     readonly name: "触发事件";
     readonly icon: "fluent:flash-20-regular";
+    readonly description: "点击后按顺序触发一组操作（如搜索 / 重置 / 关闭弹窗 / 页面级请求）；最通用的按钮";
 };
 export declare function schema(_configure: (env: Environment) => void): Schema.Struct<{
     type: Schema.Literal<["com.shwfed.actions.button.event.dispatch"]>;

package/dist/runtime/components/actions/buttons/2026-05-15/com.shwfed.actions.button.event.dispatch/schema.js

@@ -7,7 +7,8 @@ export const type = "com.shwfed.actions.button.event.dispatch";
 export const compatibilityDate = "2026-05-15";
 export const metadata = {
   name: "\u89E6\u53D1\u4E8B\u4EF6",
-  icon: "fluent:flash-20-regular"
+  icon: "fluent:flash-20-regular",
+  description: "\u70B9\u51FB\u540E\u6309\u987A\u5E8F\u89E6\u53D1\u4E00\u7EC4\u64CD\u4F5C\uFF08\u5982\u641C\u7D22 / \u91CD\u7F6E / \u5173\u95ED\u5F39\u7A97 / \u9875\u9762\u7EA7\u8BF7\u6C42\uFF09\uFF1B\u6700\u901A\u7528\u7684\u6309\u94AE"
 };
 export function schema(_configure) {
   return Schema.Struct({

package/dist/runtime/components/actions/buttons/2026-06-08/com.shwfed.actions.button.http.request.json.batch/prompt.md

@@ -0,0 +1,9 @@
+## 批量请求按钮
+
+点击后对一个**请求列表**逐条串行发送，配一个带进度与「停止」的弹窗。适合批量提交 / 导入选中行。
+
+- `expression`（请求列表）求值为一组 `HttpRequestBuilder`——常见是对 `selected`（已选行）逐行 `map` 构造请求。
+- `resultExpression` 逐条对该条响应体 `json` 求值返回 `bool` 判定成功；不配则任何未报错的响应都算成功。
+- `continueOnError` 关（默认）时首个失败即停；开则跳过失败继续。
+- `messageExpression` 在全部结束后对成功响应体列表 `jsons` 求值一次作 toast，全成功样式为 success、有失败为 error。
+- `markdown` 是进度弹窗正文，可用 `total` / `succeeded` / `failure` 计数插值实时刷新。

package/dist/runtime/components/actions/buttons/2026-06-08/com.shwfed.actions.button.http.request.json.batch/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-06-08";
 export declare const metadata: {
     readonly name: "批量请求";
     readonly icon: "fluent:cloud-arrow-up-20-regular";
+    readonly description: "点击后按顺序逐条发送一批 HTTP 请求，带进度弹窗；适合批量提交 / 导入";
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     type: Schema.Literal<["com.shwfed.actions.button.http.request.json.batch"]>;

package/dist/runtime/components/actions/buttons/2026-06-08/com.shwfed.actions.button.http.request.json.batch/schema.js

@@ -7,7 +7,8 @@ export const type = "com.shwfed.actions.button.http.request.json.batch";
 export const compatibilityDate = "2026-06-08";
 export const metadata = {
   name: "\u6279\u91CF\u8BF7\u6C42",
-  icon: "fluent:cloud-arrow-up-20-regular"
+  icon: "fluent:cloud-arrow-up-20-regular",
+  description: "\u70B9\u51FB\u540E\u6309\u987A\u5E8F\u9010\u6761\u53D1\u9001\u4E00\u6279 HTTP \u8BF7\u6C42\uFF0C\u5E26\u8FDB\u5EA6\u5F39\u7A97\uFF1B\u9002\u5408\u6279\u91CF\u63D0\u4EA4 / \u5BFC\u5165"
 };
 const isHttpRequestList = (t) => t === "dyn" || t === "list" || t === "list<dyn>" || t === "list<HttpRequest>";
 export function schema(configure) {

package/dist/runtime/components/actions/buttons/2026-07-13/com.shwfed.actions.button.state.write/prompt.md

@@ -0,0 +1,8 @@
+## 写入表单状态按钮
+
+点击后把一批 CEL 表达式的结果写回**最近祖先表单**的状态。
+
+- `writes` 是一个 `{ path, value }` 列表，按顺序逐行求值写入：`path` 是绑定路径（如 `dataJson.cus_currency`），`value` 是点击时求值的 CEL。对象值与当前值**深合并**（数组整体替换），其他类型直接替换。
+- `before`（写入前）是一条触发链：任一步中止（请求失败、表单校验未过）取消本次写入。放「发送请求」在此可先取远端数据；其输出在 `value` 与 `onSuccess` 里用 `steps[?"<第 N 步 id>"]` 引用。
+- `onSuccess`（写入后）是写入完成后再跑的触发链（如刷新表格、关闭弹窗）。
+- 只想改本地表单值、不发请求时，`writes` 直接写常量 / 引用 `form` 即可；无需触发链。

package/dist/runtime/components/actions/buttons/2026-07-13/com.shwfed.actions.button.state.write/schema.d.ts

@@ -6,6 +6,7 @@ export declare const compatibilityDate: "2026-07-13";
 export declare const metadata: {
     readonly name: "写入表单状态";
     readonly icon: "fluent:document-edit-20-regular";
+    readonly description: "点击后按顺序把每个 CEL 求值结果写入最近祖先表单状态的对应绑定路径；写入前后可各接一条触发链";
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     type: Schema.Literal<["com.shwfed.actions.button.state.write"]>;

package/dist/runtime/components/actions/buttons/2026-07-13/com.shwfed.actions.button.state.write/schema.js

@@ -9,7 +9,8 @@ export const type = "com.shwfed.actions.button.state.write";
 export const compatibilityDate = "2026-07-13";
 export const metadata = {
   name: "\u5199\u5165\u8868\u5355\u72B6\u6001",
-  icon: "fluent:document-edit-20-regular"
+  icon: "fluent:document-edit-20-regular",
+  description: "\u70B9\u51FB\u540E\u6309\u987A\u5E8F\u628A\u6BCF\u4E2A CEL \u6C42\u503C\u7ED3\u679C\u5199\u5165\u6700\u8FD1\u7956\u5148\u8868\u5355\u72B6\u6001\u7684\u5BF9\u5E94\u7ED1\u5B9A\u8DEF\u5F84\uFF1B\u5199\u5165\u524D\u540E\u53EF\u5404\u63A5\u4E00\u6761\u89E6\u53D1\u94FE"
 };
 export function schema(configure) {
   const withSteps = (env) => {

package/dist/runtime/components/actions/config.vue

@@ -12,6 +12,7 @@ import {
 import { Environment } from "../../vendor/cel-js/lib/index";
 import { cel as rawCel } from "../../utils/cel";
 import { celBindings, injectCELContext, provideCELContext } from "../../utils/cel-context";
+import { readClip, reidFragment, writeClip } from "../../share/clipboard";
 import { BUTTONS, findButton, ITEMS, findItem } from "./utils/resolve";
 import { SIDEBAR_TAKEOVER_KEY } from "../sidebar-takeover";
 import { BREADCRUMB_EXTENSION_KEY } from "../config/breadcrumb-extension";
@@ -175,6 +176,9 @@ const editingStyle = computed({
   }
 });
 const selected = ref({ kind: "general" });
+const pickedItemIds = ref([]);
+const pickedItemIdSet = computed(() => new Set(pickedItemIds.value));
+const pickAnchor = ref(null);
 function itemsOfGroup(groupId) {
   return editingItems.value.filter((it) => it.groupId === groupId);
 }
@@ -528,12 +532,107 @@ function selectGeneral() {
 function selectGroup(id) {
   selected.value = { kind: "group", id };
 }
-function selectItem(id) {
+const orderedItemIds = computed(
+  () => editingGroups.value.flatMap((g) => itemsOfGroup(g.id).map((it) => it.id))
+);
+function itemRange(a, b) {
+  const ord = orderedItemIds.value;
+  const ia = ord.indexOf(a);
+  const ib = ord.indexOf(b);
+  if (ia === -1 || ib === -1) return [b];
+  const [lo, hi] = ia <= ib ? [ia, ib] : [ib, ia];
+  return ord.slice(lo, hi + 1);
+}
+function selectItem(id, e) {
+  const meta = !!e && (e.metaKey || e.ctrlKey);
+  if (meta && e.shiftKey) {
+    const range = pickAnchor.value ? itemRange(pickAnchor.value, id) : [id];
+    const set = new Set(pickedItemIds.value);
+    for (const iid of range) set.add(iid);
+    pickedItemIds.value = orderedItemIds.value.filter((iid) => set.has(iid));
+    pickAnchor.value = id;
+    return;
+  }
+  if (meta) {
+    const set = new Set(pickedItemIds.value);
+    if (set.has(id)) set.delete(id);
+    else set.add(id);
+    pickedItemIds.value = orderedItemIds.value.filter((iid) => set.has(iid));
+    pickAnchor.value = id;
+    return;
+  }
+  pickedItemIds.value = [];
+  pickAnchor.value = null;
   selected.value = { kind: "item", id };
 }
 function selectSub(id) {
   selected.value = { kind: "sub", id };
 }
+watch(selected, (s) => {
+  if (s?.kind !== "item") {
+    pickedItemIds.value = [];
+    pickAnchor.value = null;
+  }
+});
+async function copyItems() {
+  if (pickedItemIds.value.length === 0) return;
+  const set = pickedItemIdSet.value;
+  const items = orderedItemIds.value.filter((id) => set.has(id)).map((id) => findItemNode(id)).filter((it) => !!it);
+  if (items.length === 0) return;
+  const groupIds = new Set(items.map((it) => it.groupId));
+  const groups = editingGroups.value.filter((g) => groupIds.has(g.id));
+  const ok = await writeClip("actions", { items, groups });
+  if (ok) toast.success(`\u5DF2\u590D\u5236 ${items.length} \u4E2A\u6309\u94AE`);
+  else toast.error("\u590D\u5236\u5931\u8D25");
+}
+async function pasteItems() {
+  const clip = await readClip();
+  if (!clip || clip.surface !== "actions") return;
+  const { items, groups } = reidFragment(clip);
+  const pastedItems = items;
+  if (pastedItems.length === 0) return;
+  const w = snapshot();
+  const pastedGroups = [...groups ?? []];
+  const known = new Set(pastedGroups.map((g) => g.id));
+  const repaired = pastedItems.map((it) => {
+    if (known.has(it.groupId)) return it;
+    const group = { id: crypto.randomUUID() };
+    pastedGroups.push(group);
+    known.add(group.id);
+    return { ...it, groupId: group.id };
+  });
+  w.groups = [...w.groups, ...pastedGroups];
+  w.items = sortByGroupOrder(w.groups, [...w.items, ...repaired]);
+  commit(w);
+  const ids = repaired.map((it) => it.id);
+  pickedItemIds.value = ids;
+  pickAnchor.value = ids[ids.length - 1] ?? null;
+  selected.value = { kind: "item", id: ids[ids.length - 1] };
+  toast.success(`\u5DF2\u7C98\u8D34 ${repaired.length} \u4E2A\u6309\u94AE`);
+}
+function isTextInput(el) {
+  if (!(el instanceof HTMLElement)) return false;
+  const tag = el.tagName;
+  return tag === "INPUT" || tag === "TEXTAREA" || el.isContentEditable;
+}
+function onItemListKeydown(e) {
+  if (isTextInput(e.target)) return;
+  const mod = e.metaKey || e.ctrlKey;
+  if (!mod || e.shiftKey || e.altKey) return;
+  const key = e.key.toLowerCase();
+  if (key === "c") {
+    if (pickedItemIds.value.length === 0) return;
+    const sel = window.getSelection();
+    if (sel && !sel.isCollapsed) return;
+    e.preventDefault();
+    e.stopPropagation();
+    void copyItems();
+  } else if (key === "v") {
+    e.preventDefault();
+    e.stopPropagation();
+    void pasteItems();
+  }
+}
 function isSourceDropdown(src) {
   if (src.kind !== ITEM_DRAG_KIND) return false;
   const it = editingItems.value.find((i) => i.id === src.id);
@@ -795,6 +894,10 @@ function wrapActionItemInDropdown(itemId) {
   selected.value = { kind: "item", id: dropdown.id };
 }
 function resolveSelection() {
+  const live = new Set(editingItems.value.map((it) => it.id));
+  if (pickedItemIds.value.some((id) => !live.has(id))) {
+    pickedItemIds.value = pickedItemIds.value.filter((id) => live.has(id));
+  }
   const s = selected.value;
   if (!s || s.kind === "general") return;
   if (s.kind === "group" && findGroup(s.id)) return;
@@ -959,7 +1062,10 @@ const newGroupZoneId = (insertIndex) => `new-group-${insertIndex}`;
         :disabled="!outerTakeoverTarget"
       >
         <div
+          class="outline-none"
           :class="outerTakeoverTarget ? 'flex flex-1 flex-col gap-2 min-h-0' : 'flex gap-2 w-72 shrink-0 flex-col'"
+          tabindex="-1"
+          @keydown="onItemListKeydown"
         >
           <div
             v-if="selectedDrillableAction"
@@ -1040,9 +1146,9 @@ const newGroupZoneId = (insertIndex) => `new-group-${insertIndex}`;
                     <div
                       class="row group item-row pl-5"
                       :class="[
-  selected?.kind === 'item' && selected.id === item.id ? 'bg-[color-mix(in_srgb,var(--primary)_10%,white)] text-(--primary)' : 'text-zinc-600 hover:bg-zinc-50'
+  selected?.kind === 'item' && selected.id === item.id ? 'bg-[color-mix(in_srgb,var(--primary)_10%,white)] text-(--primary)' : pickedItemIdSet.has(item.id) ? 'bg-zinc-100 text-zinc-700' : 'text-zinc-600 hover:bg-zinc-50'
 ]"
-                      @click.stop="selectItem(item.id)"
+                      @click.stop="selectItem(item.id, $event)"
                     >
                       <Icon
                         icon="fluent:re-order-dots-vertical-20-regular"

package/dist/runtime/components/actions/items/2026-05-21/com.shwfed.actions.item.markdown/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-05-21";
 export declare const metadata: {
     readonly name: "内联 Markdown";
     readonly icon: "fluent:markdown-20-regular";
+    readonly description: "与按钮并排展示一段内联 Markdown 文本（仅展示，不是按钮）";
 };
 export declare function schema(_configure: (env: Environment) => void): Schema.Struct<{
     id: Schema.refine<string, typeof Schema.String>;

package/dist/runtime/components/actions/items/2026-05-21/com.shwfed.actions.item.markdown/schema.js

@@ -4,7 +4,8 @@ export const type = "com.shwfed.actions.item.markdown";
 export const compatibilityDate = "2026-05-21";
 export const metadata = {
   name: "\u5185\u8054 Markdown",
-  icon: "fluent:markdown-20-regular"
+  icon: "fluent:markdown-20-regular",
+  description: "\u4E0E\u6309\u94AE\u5E76\u6392\u5C55\u793A\u4E00\u6BB5\u5185\u8054 Markdown \u6587\u672C\uFF08\u4EC5\u5C55\u793A\uFF0C\u4E0D\u662F\u6309\u94AE\uFF09"
 };
 export function schema(_configure) {
   return Schema.Struct({

package/dist/runtime/components/actions/utils/ai-button-tools.d.ts

@@ -0,0 +1,29 @@
+import { Environment } from '../../../vendor/cel-js/lib/index.js';
+import type { AgenticTool } from '../../../utils/ai/index.js';
+type AnyRecord = Record<string, any>;
+/** 一个可作为 trigger `target` 的事件目标实例及其操作（由游标按帧栈计算）。 */
+export interface EventTargetInfo {
+    /** 实例 id（trigger 的 `target`）；null 表示该目标尚无 id，无法被可靠寻址。 */
+    id: string | null;
+    /** 目标种类，仅供模型理解（table / queryForm / page / tree / modal）。 */
+    kind: string;
+    /** 目标的展示名（内部名称，或类型名兜底）。 */
+    name: string;
+    /** 该目标暴露的操作；`compatibilityDate` 存在即为参数化操作。 */
+    operations: ReadonlyArray<{
+        id: string;
+        name: string;
+        compatibilityDate?: string;
+    }>;
+    /** 可选说明（例如「尚无 id」）。 */
+    note?: string;
+}
+export interface ActionsAiToolDeps {
+    readonly read: () => AnyRecord | undefined;
+    readonly write: (next: AnyRecord) => void;
+    readonly configure: (env: Environment) => void;
+    readonly genUuid: () => string;
+    readonly eventTargets?: () => ReadonlyArray<EventTargetInfo>;
+}
+export declare function createActionsAiTools(deps: ActionsAiToolDeps): AgenticTool[];
+export {};