@shwfed/config 2.7.8 → 2.9.0

package/dist/runtime/components/form/fields/2026-04-22/com.shwfed.form.field.textarea/runtime.vue

@@ -6,7 +6,7 @@ import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
 import { getLocalizedText } from "../../../../../share/locale";
 import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
-import { InputGroup, InputGroupTextarea } from "../../../../ui/input-group";
+import { InputGroup, InputGroupAddon, InputGroupText, InputGroupTextarea } from "../../../../ui/input-group";
 import { Markdown } from "../../../../ui/markdown";
 import { DEFAULT_FIELD_ORIENTATION } from "../../../utils/common";
 import { useFieldValue } from "../../../utils/field-value";
@@ -29,6 +29,7 @@ const placeholderText = computed(
 const tooltipText = computed(
   () => props.config.tooltip ? getLocalizedText(props.config.tooltip, locale.value) : void 0
 );
+const maxLength = computed(() => props.config.maxLength);
 function evalBool(expression, label) {
   if (!expression) return false;
   try {
@@ -94,9 +95,17 @@ const { isRequired, errors, warnings, visible } = useFieldValidation({
         v-model="draft"
         :placeholder="placeholderText"
         :disabled="isDisabled"
-        :rows="config.rows"
+        :maxlength="maxLength"
         @blur="commit"
       />
+      <InputGroupAddon
+        v-if="maxLength != null"
+        align="block-end"
+      >
+        <InputGroupText class="tabular-nums">
+          {{ draft.length }} / {{ maxLength }}
+        </InputGroupText>
+      </InputGroupAddon>
     </InputGroup>
     <FieldMessages
       v-if="visible"

package/dist/runtime/components/form/fields/2026-04-22/com.shwfed.form.field.textarea/schema.d.ts

@@ -40,10 +40,10 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
         message: Schema.SchemaClass<string, string, never>;
     }>]>>;
     orientation: Schema.optional<Schema.Literal<["vertical", "floating"]>>;
-    rows: Schema.optional<Schema.refine<number, Schema.filter<typeof Schema.Number>>>;
     binding: Schema.optional<Schema.refine<string, typeof Schema.String>>;
     disabled: Schema.optional<Schema.Schema<string, string, never>>;
     readonly: Schema.optional<Schema.Schema<string, string, never>>;
+    maxLength: Schema.optional<Schema.refine<number, Schema.filter<typeof Schema.Number>>>;
     derived: Schema.optional<Schema.Struct<{
         mode: Schema.Literal<["formula", "prefill"]>;
         expression: Schema.Schema<string, string, never>;

package/dist/runtime/components/form/fields/2026-04-22/com.shwfed.form.field.textarea/schema.js

@@ -29,10 +29,6 @@ export function schema(configure) {
       description: "\u9F20\u6807\u60AC\u505C\u5728\u6807\u7B7E\u4E0A\u65F6\u5C55\u793A\u7684\u8BF4\u660E"
     })),
     orientation: Schema.optional(FieldOrientationSchema),
-    rows: Schema.optional(Schema.Number.pipe(Schema.int(), Schema.positive()).annotations({
-      title: "\u884C\u6570",
-      description: "\u8F93\u5165\u6846\u7684\u521D\u59CB\u53EF\u89C1\u884C\u6570\uFF1B\u7559\u7A7A\u4F7F\u7528\u9ED8\u8BA4\u9AD8\u5EA6"
-    })),
     binding: Schema.optional(Schema.String.pipe(Schema.minLength(1)).annotations({
       title: "\u7ED1\u5B9A\u8DEF\u5F84",
       description: "\u5199\u5165\u8868\u5355\u72B6\u6001\u7684 `dot-prop` \u8DEF\u5F84\uFF0C\u4F8B\u5982 `user.bio`\uFF1B\u7559\u7A7A\u5219\u4E3A\u975E\u53D7\u63A7\u5B57\u6BB5\uFF0C\u4E0D\u5199\u5165\u8868\u5355\u72B6\u6001"
@@ -45,6 +41,10 @@ export function schema(configure) {
       title: "\u53EA\u8BFB\u6761\u4EF6",
       description: "\u8FD4\u56DE `true` \u65F6\u4EC5\u4EE5\u7EAF\u6587\u672C\u5C55\u793A\u5F53\u524D\u503C"
     })),
+    maxLength: Schema.optional(Schema.Number.pipe(Schema.int(), Schema.positive()).annotations({
+      title: "\u5B57\u6570\u9650\u5236",
+      description: "\u5141\u8BB8\u8F93\u5165\u7684\u6700\u5927\u5B57\u7B26\u6570\uFF1B\u8FBE\u5230\u4E0A\u9650\u540E\u65E0\u6CD5\u7EE7\u7EED\u8F93\u5165\uFF0C\u5E76\u5728\u53F3\u4E0B\u89D2\u5C55\u793A\u5B57\u6570\u8BA1\u6570"
+    })),
     derived: derivedField(configure, "string")
   }).annotations({
     title: "TextareaField",

package/dist/runtime/components/form/fields/2026-05-18/com.shwfed.form.field.table/config.d.vue.ts

@@ -30,6 +30,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             cellStyle?: string;
             style?: string;
             pagination?: import("effect/Schema").Schema.Type<typeof import("../../../../table/schema.js").Pagination>;
+            persistQuery?: boolean;
             initialState?: import("effect/Schema").Schema.Type<import("effect/Schema").Struct<{
                 columnVisibility: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Boolean>>;
                 columnOrder: import("effect/Schema").optional<import("effect/Schema").Array$<typeof import("effect/Schema").String>>;
@@ -105,6 +106,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             cellStyle?: string;
             style?: string;
             pagination?: import("effect/Schema").Schema.Type<typeof import("../../../../table/schema.js").Pagination>;
+            persistQuery?: boolean;
             initialState?: import("effect/Schema").Schema.Type<import("effect/Schema").Struct<{
                 columnVisibility: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Boolean>>;
                 columnOrder: import("effect/Schema").optional<import("effect/Schema").Array$<typeof import("effect/Schema").String>>;

package/dist/runtime/components/form/fields/2026-05-18/com.shwfed.form.field.table/config.vue.d.ts

@@ -30,6 +30,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             cellStyle?: string;
             style?: string;
             pagination?: import("effect/Schema").Schema.Type<typeof import("../../../../table/schema.js").Pagination>;
+            persistQuery?: boolean;
             initialState?: import("effect/Schema").Schema.Type<import("effect/Schema").Struct<{
                 columnVisibility: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Boolean>>;
                 columnOrder: import("effect/Schema").optional<import("effect/Schema").Array$<typeof import("effect/Schema").String>>;
@@ -105,6 +106,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             cellStyle?: string;
             style?: string;
             pagination?: import("effect/Schema").Schema.Type<typeof import("../../../../table/schema.js").Pagination>;
+            persistQuery?: boolean;
             initialState?: import("effect/Schema").Schema.Type<import("effect/Schema").Struct<{
                 columnVisibility: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Boolean>>;
                 columnOrder: import("effect/Schema").optional<import("effect/Schema").Array$<typeof import("effect/Schema").String>>;

package/dist/runtime/components/form/fields/2026-05-18/com.shwfed.form.field.table/schema.d.ts

@@ -47,6 +47,7 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
         cellStyle?: string;
         style?: string;
         pagination?: Schema.Schema.Type<typeof import("../../../../table/schema.js").Pagination>;
+        persistQuery?: boolean;
         initialState?: Schema.Schema.Type<Schema.Struct<{
             columnVisibility: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Boolean>>;
             columnOrder: Schema.optional<Schema.Array$<typeof Schema.String>>;
@@ -82,6 +83,7 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
         cellStyle?: string;
         style?: string;
         pagination?: Schema.Schema.Type<typeof import("../../../../table/schema.js").Pagination>;
+        persistQuery?: boolean;
         initialState?: Schema.Schema.Type<Schema.Struct<{
             columnVisibility: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Boolean>>;
             columnOrder: Schema.optional<Schema.Array$<typeof Schema.String>>;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.combobox.multi/runtime.vue

@@ -8,6 +8,7 @@ import { useI18n } from "vue-i18n";
 import { asRequest, fetchJsonOption } from "../../../../../share/request";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
+import { publishSelection } from "../../../../../utils/selections-registry";
 import { interpolateMarkdown } from "../../../../table/utils/runtime";
 import { getLocalizedText } from "../../../../../share/locale";
 import {
@@ -178,7 +179,8 @@ const entries = computed(() => {
         key: item.id,
         value: item.value.value,
         label: labelTpl ? safeInterpolate(labelTpl, ctx) : "",
-        keywords: kw.length > 0 ? kw : void 0
+        keywords: kw.length > 0 ? kw : void 0,
+        raw: item
       };
     });
   }
@@ -194,7 +196,8 @@ const entries = computed(() => {
     key: String(idx),
     value: remoteValueOf(option),
     label: remoteLabelOf(option),
-    keywords: remoteKeywordsOf(option)
+    keywords: remoteKeywordsOf(option),
+    raw: option
   }));
 });
 const uncontrolled = ref([]);
@@ -243,6 +246,14 @@ const selectedEntries = computed(() => {
 });
 const selectedKeys = computed(() => selectedEntries.value.map((e) => e.key));
 const selectedKeySet = computed(() => new Set(selectedKeys.value));
+publishSelection(
+  props.fieldId,
+  () => selectedEntries.value.length > 0 ? selectedEntries.value : void 0,
+  {
+    identity: (list) => list.map((e) => e.key).join("\0"),
+    raw: (list) => list.map((e) => e.raw)
+  }
+);
 const triggerLabel = computed(() => {
   const arr = selectedEntries.value;
   if (arr.length === 0) return "";

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.combobox.multi/schema.d.ts

@@ -16,6 +16,7 @@ export declare const metadata: {
         readonly min: 2;
         readonly max: 2;
     };
+    readonly selection: true;
 };
 export declare function itemSchema(configure: (env: Environment) => void): Schema.Struct<{
     id: Schema.refine<string, typeof Schema.String>;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.combobox.multi/schema.js

@@ -8,7 +8,10 @@ export const metadata = {
   name: "\u4E0B\u62C9\u591A\u9009",
   icon: "fluent:chevron-down-20-regular",
   w: { initial: 8, min: 4, max: Infinity },
-  h: { initial: 2, min: 2, max: 2 }
+  h: { initial: 2, min: 2, max: 2 },
+  // Publishes its resolved options (array, in selection order) to the
+  // `selections` registry (runtime.vue), readable via `selections["<id>"]`.
+  selection: true
 };
 const isListType = (actual) => actual === "dyn" || actual.startsWith("list") || actual.startsWith("optional");
 function configureWithOption(configure) {

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.combobox.single/runtime.vue

@@ -8,6 +8,7 @@ import { useI18n } from "vue-i18n";
 import { asRequest, fetchJsonOption } from "../../../../../share/request";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
+import { publishSelection } from "../../../../../utils/selections-registry";
 import { interpolateMarkdown } from "../../../../table/utils/runtime";
 import { getLocalizedText } from "../../../../../share/locale";
 import {
@@ -180,7 +181,8 @@ const entries = computed(() => {
         value: item.value.value,
         label: labelTpl ? safeInterpolate(labelTpl, ctx) : "",
         tooltip: tooltipTpl ? safeInterpolate(tooltipTpl, ctx) : void 0,
-        keywords: kw.length > 0 ? kw : void 0
+        keywords: kw.length > 0 ? kw : void 0,
+        raw: item
       };
     });
   }
@@ -196,7 +198,8 @@ const entries = computed(() => {
     key: String(idx),
     value: remoteValueOf(option),
     label: remoteLabelOf(option),
-    keywords: remoteKeywordsOf(option)
+    keywords: remoteKeywordsOf(option),
+    raw: option
   }));
 });
 const uncontrolled = ref(void 0);
@@ -246,6 +249,11 @@ const selectedEntry = computed(
 );
 const selectedKey = computed(() => selectedEntry.value?.key);
 const selectedLabel = computed(() => selectedEntry.value?.label ?? "");
+publishSelection(
+  props.fieldId,
+  () => selectedEntry.value,
+  { identity: (entry) => entry.key, raw: (entry) => entry.raw }
+);
 const open = ref(false);
 function handleSelect(key) {
   if (typeof key !== "string") return;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.combobox.single/schema.d.ts

@@ -16,6 +16,7 @@ export declare const metadata: {
         readonly min: 2;
         readonly max: 2;
     };
+    readonly selection: true;
 };
 export declare function itemSchema(configure: (env: Environment) => void): Schema.Struct<{
     id: Schema.refine<string, typeof Schema.String>;

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.combobox.single/schema.js

@@ -8,7 +8,10 @@ export const metadata = {
   name: "\u4E0B\u62C9\u5355\u9009",
   icon: "fluent:chevron-down-20-regular",
   w: { initial: 8, min: 4, max: Infinity },
-  h: { initial: 2, min: 2, max: 2 }
+  h: { initial: 2, min: 2, max: 2 },
+  // Publishes its resolved option to the `selections` registry (runtime.vue), so
+  // a sibling expression can read the full chosen record via `selections["<id>"]`.
+  selection: true
 };
 const isListType = (actual) => actual === "dyn" || actual.startsWith("list") || actual.startsWith("optional");
 function configureWithOption(configure) {

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.combobox.multi/runtime.vue

@@ -7,6 +7,7 @@ import { useI18n } from "vue-i18n";
 import { fetchJsonOption } from "../../../../../share/request";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
+import { publishSelection } from "../../../../../utils/selections-registry";
 import { getLocalizedText } from "../../../../../share/locale";
 import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "../../../../ui/input-group";
@@ -240,6 +241,21 @@ const triggerLabel = computed(() => {
   if (arr.length === 1) return head;
   return `${head} + ${arr.length - 1}`;
 });
+const selectedLeaves = computed(
+  () => model.value.map((k) => {
+    const path = findWrappedPath(roots.value, k);
+    if (!path || path.length === 0) return void 0;
+    return path[path.length - 1];
+  }).filter((node) => node !== void 0)
+);
+publishSelection(
+  props.fieldId,
+  () => selectedLeaves.value.length > 0 ? selectedLeaves.value : void 0,
+  {
+    identity: (list) => list.map((w) => w.key).join(" "),
+    raw: (list) => list.map((w) => w.raw)
+  }
+);
 const initialExpanded = computed(() => {
   if (!props.config.expandAll) return [];
   const out = [];

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.combobox.multi/schema.d.ts

@@ -16,6 +16,7 @@ export declare const metadata: {
         readonly min: 2;
         readonly max: 2;
     };
+    readonly selection: true;
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     label: Schema.optional<Schema.TupleType<readonly [Schema.Struct<{

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.combobox.multi/schema.js

@@ -9,7 +9,10 @@ export const metadata = {
   name: "\u4E0B\u62C9\u6811\uFF08\u591A\u9009\uFF09",
   icon: "fluent:tree-evergreen-20-regular",
   w: { initial: 8, min: 4, max: Infinity },
-  h: { initial: 2, min: 2, max: 2 }
+  h: { initial: 2, min: 2, max: 2 },
+  // Publishes its resolved nodes (array, in selection order) to the `selections`
+  // registry (runtime.vue), readable via `selections["<id>"]`.
+  selection: true
 };
 const NODE_VAR = {
   type: "dyn",

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.combobox.single/runtime.vue

@@ -7,6 +7,7 @@ import { useI18n } from "vue-i18n";
 import { fetchJsonOption } from "../../../../../share/request";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
+import { publishSelection } from "../../../../../utils/selections-registry";
 import { getLocalizedText } from "../../../../../share/locale";
 import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "../../../../ui/input-group";
@@ -227,14 +228,21 @@ const roots = computed(
     nodeChildren: nodeChildrenList
   })
 );
-const triggerLabel = computed(() => {
+const selectedWrapped = computed(() => {
   const k = model.value;
-  if (!k) return "";
+  if (!k) return void 0;
   const path = findWrappedPath(roots.value, k);
-  if (!path || path.length === 0) return "";
-  const leaf = path[path.length - 1];
-  return wrappedLabelText(leaf);
+  if (!path || path.length === 0) return void 0;
+  return path[path.length - 1];
 });
+const triggerLabel = computed(
+  () => selectedWrapped.value ? wrappedLabelText(selectedWrapped.value) : ""
+);
+publishSelection(
+  props.fieldId,
+  () => selectedWrapped.value,
+  { identity: (w) => w.key, raw: (w) => w.raw }
+);
 const initialExpanded = computed(() => {
   if (!props.config.expandAll) return [];
   const out = [];

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.combobox.single/schema.d.ts

@@ -16,6 +16,7 @@ export declare const metadata: {
         readonly min: 2;
         readonly max: 2;
     };
+    readonly selection: true;
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     label: Schema.optional<Schema.TupleType<readonly [Schema.Struct<{

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.combobox.single/schema.js

@@ -9,7 +9,10 @@ export const metadata = {
   name: "\u4E0B\u62C9\u6811\uFF08\u5355\u9009\uFF09",
   icon: "fluent:tree-evergreen-20-regular",
   w: { initial: 8, min: 4, max: Infinity },
-  h: { initial: 2, min: 2, max: 2 }
+  h: { initial: 2, min: 2, max: 2 },
+  // Publishes its resolved node (the backend record) to the `selections`
+  // registry (runtime.vue), readable via `selections["<id>"]`.
+  selection: true
 };
 const NODE_VAR = {
   type: "dyn",

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.multi/runtime.vue

@@ -7,6 +7,7 @@ import { useI18n } from "vue-i18n";
 import { fetchJsonOption } from "../../../../../share/request";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
+import { publishSelection } from "../../../../../utils/selections-registry";
 import { getLocalizedText } from "../../../../../share/locale";
 import { Checkbox } from "../../../../ui/checkbox";
 import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
@@ -262,20 +263,39 @@ const filterLabelText = computed(() => {
   const localized = props.config.filter?.label ? getLocalizedText(props.config.filter.label, locale.value) : void 0;
   return localized && localized.length > 0 ? localized : t("tree-multi-search-label");
 });
-const readonlyText = computed(() => {
+const resolvedByKey = computed(() => {
   const selected = new Set(model.value);
-  const empty = t("tree-multi-readonly-empty");
-  if (selected.size === 0) return empty;
   const found = /* @__PURE__ */ new Map();
+  if (selected.size === 0) return found;
   const stack = [...roots.value];
   while (stack.length) {
     const n = stack.pop();
     const k = getKey(n);
-    if (selected.has(k)) found.set(k, nodeLabelText(n));
+    if (selected.has(k)) found.set(k, n);
     const kids = getChildren(n);
     if (kids && kids.length) stack.push(...kids);
   }
-  const labels = model.value.map((id) => found.get(id) ?? id).filter((l) => l.length > 0);
+  return found;
+});
+const selectedNodes = computed(
+  () => model.value.map((id) => resolvedByKey.value.get(id)).filter((n) => n !== void 0)
+);
+publishSelection(
+  props.fieldId,
+  () => selectedNodes.value.length > 0 ? selectedNodes.value : void 0,
+  {
+    identity: (list) => list.map((n) => getKey(n)).join(" "),
+    raw: (list) => list
+  }
+);
+const readonlyText = computed(() => {
+  const empty = t("tree-multi-readonly-empty");
+  if (model.value.length === 0) return empty;
+  const found = resolvedByKey.value;
+  const labels = model.value.map((id) => {
+    const n = found.get(id);
+    return n !== void 0 ? nodeLabelText(n) : id;
+  }).filter((l) => l.length > 0);
   return labels.length > 0 ? labels.join(t("tree-multi-readonly-separator")) : empty;
 });
 </script>

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.multi/schema.d.ts

@@ -17,6 +17,7 @@ export declare const metadata: {
         readonly max: number;
         readonly grow: true;
     };
+    readonly selection: true;
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     label: Schema.optional<Schema.TupleType<readonly [Schema.Struct<{

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.multi/schema.js

@@ -9,7 +9,10 @@ export const metadata = {
   name: "\u6811\uFF08\u591A\u9009\uFF09",
   icon: "fluent:tree-evergreen-20-regular",
   w: { initial: 8, min: 4, max: Infinity },
-  h: { initial: 8, min: 4, max: Infinity, grow: true }
+  h: { initial: 8, min: 4, max: Infinity, grow: true },
+  // Publishes its resolved nodes (array, in selection order) to the `selections`
+  // registry (runtime.vue), readable via `selections["<id>"]`.
+  selection: true
 };
 export function schema(configure) {
   const CelBool = Expression({ configure, resultType: "bool" });

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/runtime.vue

@@ -7,6 +7,7 @@ import { useI18n } from "vue-i18n";
 import { fetchJsonOption } from "../../../../../share/request";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
+import { publishSelection } from "../../../../../utils/selections-registry";
 import { getLocalizedText } from "../../../../../share/locale";
 import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "../../../../ui/input-group";
@@ -258,21 +259,30 @@ const filterLabelText = computed(() => {
   const localized = props.config.filter?.label ? getLocalizedText(props.config.filter.label, locale.value) : void 0;
   return localized && localized.length > 0 ? localized : t("tree-single-search-label");
 });
-const readonlyText = computed(() => {
+const selectedNode = computed(() => {
   const selected = model.value;
-  const empty = t("tree-single-readonly-empty");
-  if (selected == null) return empty;
+  if (selected == null) return void 0;
   const stack = [...roots.value];
   while (stack.length) {
     const n = stack.pop();
-    if (getKey(n) === selected) {
-      const label = nodeLabelText(n);
-      return label.length > 0 ? label : selected;
-    }
+    if (getKey(n) === selected) return n;
     const kids = getChildren(n);
     if (kids && kids.length) stack.push(...kids);
   }
-  return selected;
+  return void 0;
+});
+publishSelection(
+  props.fieldId,
+  () => selectedNode.value,
+  { identity: (node) => getKey(node), raw: (node) => node }
+);
+const readonlyText = computed(() => {
+  const selected = model.value;
+  if (selected == null) return t("tree-single-readonly-empty");
+  const n = selectedNode.value;
+  if (n === void 0) return selected;
+  const label = nodeLabelText(n);
+  return label.length > 0 ? label : selected;
 });
 </script>
 

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/schema.d.ts

@@ -16,6 +16,7 @@ export declare const metadata: {
         readonly max: number;
         readonly grow: true;
     };
+    readonly selection: true;
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     label: Schema.optional<Schema.TupleType<readonly [Schema.Struct<{

package/dist/runtime/components/form/fields/2026-05-28/com.shwfed.form.field.tree.single/schema.js

@@ -9,7 +9,10 @@ export const metadata = {
   name: "\u6811\uFF08\u5355\u9009\uFF09",
   icon: "fluent:tree-evergreen-20-regular",
   w: { initial: 8, min: 4, max: Infinity },
-  h: { initial: 8, min: 4, max: Infinity, grow: true }
+  h: { initial: 8, min: 4, max: Infinity, grow: true },
+  // Publishes its resolved node (the backend record) to the `selections`
+  // registry (runtime.vue), readable via `selections["<id>"]`.
+  selection: true
 };
 export function schema(configure) {
   const CelBool = Expression({ configure, resultType: "bool" });

package/dist/runtime/components/form/index.vue

@@ -15,10 +15,10 @@ import { provideCommitBus } from "./utils/commit-bus";
 import { provideDerivedQuiescence, useDerived } from "./utils/derived";
 import { useFormHistory } from "./utils/history";
 import { evaluateInitial } from "./utils/initial";
-import { provideFormValidate } from "../../share/form-validate";
 import { provideEventTarget } from "../../share/event-bus";
 import { provideFormReadonly } from "./utils/readonly";
 import { provideFormState } from "./utils/state";
+import { provideSelectionsRegistry } from "../../utils/selections-registry";
 import { provideValidation } from "./utils/validation";
 defineOptions({ name: "ShwfedForm" });
 const state = defineModel({ type: Object, ...{ default: () => ({}) } });
@@ -29,9 +29,15 @@ const props = defineProps({
 const configure = props.configure ?? (() => {
 });
 void configure;
+const selections = provideSelectionsRegistry();
 provideCELContext(buildFormRuntimeScope({
   form: () => state.value ?? {},
-  now: () => new TZDate()
+  now: () => new TZDate(),
+  // `formHistory` is created further down; these thunks are stored now and
+  // only called at eval time (long after setup), so reading it here is safe.
+  undoable: () => formHistory.canUndo.value,
+  redoable: () => formHistory.canRedo.value,
+  selections: () => selections.entries.value
 }));
 const inherited = injectCELContext();
 const $cel = (expression, context) => _rawCel(expression, { ...celBindings(inherited), ...context });
@@ -77,10 +83,16 @@ const validation = provideValidation({
   seeded,
   settled: quiescence.settled
 });
-provideFormValidate(validation.validate);
 const formHistory = useFormHistory(state, { quiescence, seeded, dirty: formState.dirty });
+class FormInvalid {
+  _tag = "FormInvalid";
+}
 const formInstanceId = config.value?.id ?? crypto.randomUUID();
 provideEventTarget(formInstanceId, {
+  "validate": () => Effect.gen(function* () {
+    const valid = yield* Effect.promise(() => validation.validate());
+    if (!valid) yield* Effect.die(new FormInvalid());
+  }),
   "undo": () => Effect.sync(formHistory.undo),
   "redo": () => Effect.sync(formHistory.redo),
   "reset-to-initial": () => Effect.sync(formHistory.reset)

package/dist/runtime/components/form/schema.d.ts

@@ -11,6 +11,10 @@ export declare const metadata: {
     readonly name: "表单";
     readonly icon: "fluent:form-20-regular";
     readonly operations: readonly [{
+        readonly id: "validate";
+        readonly name: "校验";
+        readonly icon: "fluent:checkmark-circle-20-regular";
+    }, {
         readonly id: "undo";
         readonly name: "撤销";
         readonly icon: "fluent:arrow-undo-20-regular";

package/dist/runtime/components/form/schema.js

@@ -20,6 +20,7 @@ export const metadata = {
   name: "\u8868\u5355",
   icon: "fluent:form-20-regular",
   operations: [
+    { id: "validate", name: "\u6821\u9A8C", icon: "fluent:checkmark-circle-20-regular" },
     { id: "undo", name: "\u64A4\u9500", icon: "fluent:arrow-undo-20-regular" },
     { id: "redo", name: "\u91CD\u505A", icon: "fluent:arrow-redo-20-regular" },
     { id: "reset-to-initial", name: "\u91CD\u7F6E\u4E3A\u521D\u59CB\u503C", icon: "fluent:arrow-reset-20-regular" }

package/dist/runtime/components/form/unit-config.vue

@@ -7,7 +7,8 @@ import { toast } from "vue-sonner";
 import {
   celBindings,
   injectCELContext,
-  provideCELContext
+  provideCELContext,
+  provideSelectionRoster
 } from "../../utils/cel-context";
 import { findFreePlacement, normalizeLayoutSet, placeGroupAt } from "../../share/layout";
 import { readClip, reidFragment, writeClip } from "../../share/clipboard";
@@ -45,6 +46,10 @@ const breadcrumbExt = inject(BREADCRUMB_EXTENSION_KEY, null);
 const fullPane = ref(false);
 provide(FORM_FIELD_LAYOUT_KEY, { fullPane });
 provideCELContext(props.fieldCelScope ?? {});
+const selectionRoster = computed(
+  () => unit.value.fields.filter((f) => findField(f.type, f.compatibilityDate)?.metadata?.selection).map((f) => ({ id: f.id, name: fieldLabel(f) }))
+);
+provideSelectionRoster(selectionRoster);
 const takeover = inject(SIDEBAR_TAKEOVER_KEY, null);
 const takeoverTarget = computed(() => takeover?.target.value ?? null);
 const activeFieldId = computed(() => {

package/dist/runtime/components/form/utils/form-vars.js

@@ -1,5 +1,9 @@
+import { SELECTIONS_VAR } from "../../../utils/cel-context.js";
 export function registerFormVariablesIfAbsent(env) {
   const declared = new Set(env.getDefinitions().variables.map((v) => v.name));
   if (!declared.has("now")) env.registerVariable("now", "Date", { label: "\u5F53\u524D\u65F6\u95F4", description: "\u5F53\u524D\u65E5\u671F/\u65F6\u95F4" });
   if (!declared.has("form")) env.registerVariable("form", "dyn", { label: "\u8868\u5355\u503C", description: "\u5F53\u524D\u8868\u5355\u72B6\u6001" });
+  if (!declared.has("undoable")) env.registerVariable("undoable", "bool", { label: "\u53EF\u64A4\u9500", description: "\u5F53\u524D\u662F\u5426\u6709\u53EF\u64A4\u9500\u7684\u4FEE\u6539" });
+  if (!declared.has("redoable")) env.registerVariable("redoable", "bool", { label: "\u53EF\u91CD\u505A", description: "\u5F53\u524D\u662F\u5426\u6709\u53EF\u91CD\u505A\u7684\u4FEE\u6539" });
+  if (!declared.has(SELECTIONS_VAR)) env.registerVariable(SELECTIONS_VAR, "dyn", { label: "\u9009\u4E2D\u9879", description: "\u5404\u9009\u62E9\u5B57\u6BB5\u5F53\u524D\u9009\u4E2D\u9879\u7684\u5B8C\u6574\u5BF9\u8C61\uFF08\u6309\u5B57\u6BB5\u6807\u8BC6\uFF09" });
 }

package/dist/runtime/components/form/utils/resolve.d.ts

@@ -65,6 +65,16 @@ export type FieldMetadata = Readonly<{
      * fullscreen. See `BlockLayoutEditor`'s inline-config pane.
      */
     inlineConfig?: boolean;
+    /**
+     * Whether this field is *selection-like* — it publishes its currently-resolved
+     * full option to the `selections` registry at runtime (see
+     * `utils/selections-registry`), keyed by its uuid. The form's unit-config reads
+     * this to build the selection roster the ExpressionEditor advertises: a sibling
+     * expression reaches the chosen record via `selections["<id>"].code`, and the
+     * editor renders that uuid as this field's name. Set it together with the
+     * runtime publish so the picker never advertises a field that writes nothing.
+     */
+    selection?: boolean;
 }>;
 /**
  * Optional creation-time defaults factory. Returns a partial config that