@shwfed/config 1.1.5 → 2.0.1

package/dist/runtime/components/form/fields/2026-05-17/com.shwfed.form.field.radio.group/runtime.vue

@@ -0,0 +1,159 @@
+<script setup>
+import { Effect } from "effect";
+import { computed, ref } from "vue";
+import { useI18n } from "vue-i18n";
+import { cel as _rawCel } from "../../../../../utils/cel";
+import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
+import { interpolateMarkdown } from "../../../../table/utils/runtime";
+import { getLocalizedText } from "../../../../../share/locale";
+import { RadioGroup, RadioGroupItem } from "../../../../ui/radio-group";
+import { Field, FieldLabel } from "../../../../ui/field";
+import { Markdown } from "../../../../ui/markdown";
+import { useFormReadonly } from "../../../utils/readonly";
+import { useFormState } from "../../../utils/state";
+defineOptions({ name: "ShwfedRadioGroupFieldRuntime" });
+const props = defineProps({
+  fieldId: { type: String, required: true },
+  config: { type: null, required: true }
+});
+const { locale, t } = useI18n({
+  inheritLocale: true,
+  messages: {
+    zh: { "radio-group-empty": "\u65E0\u53EF\u9009\u9879" },
+    en: { "radio-group-empty": "No options" },
+    ja: { "radio-group-empty": "\u9078\u629E\u80A2\u306A\u3057" }
+  }
+});
+const { state, getAt, setAt } = useFormState();
+const inherited = injectCELContext();
+const $cel = (expression, context) => _rawCel(expression, { ...celBindings(inherited), ...context });
+const labelText = computed(() => getLocalizedText(props.config.label, locale.value));
+const tooltipText = computed(
+  () => props.config.tooltip ? getLocalizedText(props.config.tooltip, locale.value) : void 0
+);
+function evalBool(expression, label) {
+  if (!expression) return false;
+  try {
+    return Effect.runSync($cel(expression, { form: state.value ?? {} }));
+  } catch (err) {
+    console.error(`[shwfed-form] failed to evaluate ${label} for ${props.fieldId}:`, err);
+    return false;
+  }
+}
+const isDisabled = computed(() => evalBool(props.config.disabled, "disabled"));
+const formReadonly = useFormReadonly();
+const isReadonly = computed(
+  () => props.config.readonly != null ? evalBool(props.config.readonly, "readonly") : formReadonly.value
+);
+const effectiveReadonly = computed(() => isReadonly.value || props.config.derived?.mode === "formula");
+function safeInterpolate(tpl, ctx) {
+  try {
+    return interpolateMarkdown(tpl, $cel, ctx);
+  } catch (err) {
+    console.error(`[shwfed-form] failed to interpolate option text for ${props.fieldId}:`, err);
+    return tpl;
+  }
+}
+const entries = computed(
+  () => (props.config.items ?? []).map((item) => {
+    const labelTpl = getLocalizedText(item.label, locale.value) ?? "";
+    const tooltipTpl = item.tooltip ? getLocalizedText(item.tooltip, locale.value) : void 0;
+    const ctx = { form: state.value ?? {} };
+    return {
+      key: item.id,
+      value: item.value.value,
+      label: labelTpl ? safeInterpolate(labelTpl, ctx) : "",
+      tooltip: tooltipTpl ? safeInterpolate(tooltipTpl, ctx) : void 0
+    };
+  })
+);
+const uncontrolled = ref(void 0);
+const model = computed({
+  get: () => {
+    const path = props.config.binding;
+    const raw = path == null ? uncontrolled.value : getAt(path);
+    return typeof raw === "string" || typeof raw === "number" ? raw : void 0;
+  },
+  set: (next) => {
+    const path = props.config.binding;
+    if (path == null) {
+      uncontrolled.value = next;
+      return;
+    }
+    setAt(path, next);
+  }
+});
+function onSelect(next) {
+  if (isDisabled.value) return;
+  model.value = typeof next === "string" || typeof next === "number" ? next : void 0;
+}
+const readonlyText = computed(() => {
+  const selected = entries.value.find((e) => e.value === model.value);
+  return selected?.label || "\u2014";
+});
+</script>
+
+<template>
+  <Field
+    orientation="vertical"
+    :data-disabled="isDisabled || void 0"
+  >
+    <FieldLabel
+      v-if="labelText"
+      class="text-xs text-zinc-500"
+    >
+      <template
+        v-if="tooltipText"
+        #tooltip
+      >
+        <Markdown
+          :source="tooltipText"
+          class="prose prose-xs prose-zinc"
+        />
+      </template>
+      {{ labelText }}
+    </FieldLabel>
+    <div
+      v-if="effectiveReadonly"
+      class="min-h-9 py-1.5 text-sm text-zinc-700"
+    >
+      {{ readonlyText }}
+    </div>
+    <div
+      v-else-if="entries.length === 0"
+      class="min-h-9 py-1.5 text-sm text-zinc-400"
+    >
+      {{ t("radio-group-empty") }}
+    </div>
+    <RadioGroup
+      v-else
+      :model-value="model"
+      :disabled="isDisabled"
+      class="flex flex-wrap items-start gap-x-6 gap-y-2 py-1"
+      @update:model-value="onSelect"
+    >
+      <label
+        v-for="entry in entries"
+        :key="entry.key"
+        data-slot="radio-group-option"
+        class="flex items-start gap-2"
+        :class="isDisabled ? 'cursor-not-allowed opacity-60' : 'cursor-pointer'"
+      >
+        <RadioGroupItem
+          :value="entry.value"
+          :disabled="isDisabled"
+          class="mt-0.5"
+        />
+        <span class="flex flex-col gap-0.5">
+          <span class="text-sm text-zinc-700">{{ entry.label }}</span>
+          <Markdown
+            v-if="entry.tooltip"
+            :source="entry.tooltip"
+            block
+            class="prose prose-xs prose-zinc text-zinc-400"
+          />
+        </span>
+      </label>
+    </RadioGroup>
+  </Field>
+</template>

package/dist/runtime/components/form/fields/2026-05-17/com.shwfed.form.field.radio.group/runtime.vue.d.ts

@@ -0,0 +1,8 @@
+import type { Value } from './schema.js';
+type __VLS_Props = {
+    fieldId: string;
+    config: Value;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/form/fields/2026-05-17/com.shwfed.form.field.radio.group/schema.d.ts

@@ -0,0 +1,121 @@
+import { Schema } from 'effect';
+import type { Environment } from '../../../../../vendor/cel-js/lib/index.js';
+export declare const type: "com.shwfed.form.field.radio.group";
+export declare const compatibilityDate: "2026-05-17";
+export declare const metadata: {
+    readonly name: "单选框组";
+    readonly icon: "fluent:radio-button-20-regular";
+    readonly w: {
+        readonly initial: 8;
+        readonly min: 2;
+        readonly max: number;
+    };
+    readonly h: {
+        readonly initial: 2;
+        readonly min: 2;
+        readonly max: 2;
+    };
+};
+export declare function itemSchema(configure: (env: Environment) => void): Schema.Struct<{
+    id: Schema.refine<string, typeof Schema.String>;
+    label: Schema.refine<readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], Schema.TupleType<readonly [Schema.Struct<{
+        locale: Schema.Literal<["zh"]>;
+        message: Schema.SchemaClass<string, string, never>;
+    }>], [Schema.Struct<{
+        locale: Schema.Literal<["ja", "en", "ko"]>;
+        message: Schema.SchemaClass<string, string, never>;
+    }>]>>;
+    value: Schema.Union<[Schema.Struct<{
+        kind: Schema.Literal<["text"]>;
+        value: typeof Schema.String;
+    }>, Schema.Struct<{
+        kind: Schema.Literal<["number"]>;
+        value: typeof Schema.Number;
+    }>]>;
+    tooltip: Schema.optional<Schema.refine<readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], Schema.TupleType<readonly [Schema.Struct<{
+        locale: Schema.Literal<["zh"]>;
+        message: Schema.SchemaClass<string, string, never>;
+    }>], [Schema.Struct<{
+        locale: Schema.Literal<["ja", "en", "ko"]>;
+        message: Schema.SchemaClass<string, string, never>;
+    }>]>>>;
+}>;
+export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
+    label: Schema.optional<Schema.TupleType<readonly [Schema.Struct<{
+        locale: Schema.Literal<["zh"]>;
+        message: Schema.SchemaClass<string, string, never>;
+    }>], [Schema.Struct<{
+        locale: Schema.Literal<["ja", "en", "ko"]>;
+        message: Schema.SchemaClass<string, string, never>;
+    }>]>>;
+    tooltip: Schema.optional<Schema.TupleType<readonly [Schema.Struct<{
+        locale: Schema.Literal<["zh"]>;
+        message: Schema.SchemaClass<string, string, never>;
+    }>], [Schema.Struct<{
+        locale: Schema.Literal<["ja", "en", "ko"]>;
+        message: Schema.SchemaClass<string, string, never>;
+    }>]>>;
+    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>>;
+    derived: Schema.optional<Schema.Struct<{
+        mode: Schema.Literal<["formula", "prefill"]>;
+        expression: Schema.Schema<string, string, never>;
+    }>>;
+    items: Schema.optionalWith<Schema.Array$<Schema.Struct<{
+        id: Schema.refine<string, typeof Schema.String>;
+        label: Schema.refine<readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], Schema.TupleType<readonly [Schema.Struct<{
+            locale: Schema.Literal<["zh"]>;
+            message: Schema.SchemaClass<string, string, never>;
+        }>], [Schema.Struct<{
+            locale: Schema.Literal<["ja", "en", "ko"]>;
+            message: Schema.SchemaClass<string, string, never>;
+        }>]>>;
+        value: Schema.Union<[Schema.Struct<{
+            kind: Schema.Literal<["text"]>;
+            value: typeof Schema.String;
+        }>, Schema.Struct<{
+            kind: Schema.Literal<["number"]>;
+            value: typeof Schema.Number;
+        }>]>;
+        tooltip: Schema.optional<Schema.refine<readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], Schema.TupleType<readonly [Schema.Struct<{
+            locale: Schema.Literal<["zh"]>;
+            message: Schema.SchemaClass<string, string, never>;
+        }>], [Schema.Struct<{
+            locale: Schema.Literal<["ja", "en", "ko"]>;
+            message: Schema.SchemaClass<string, string, never>;
+        }>]>>>;
+    }>>, {
+        default: () => readonly [];
+    }>;
+    id: Schema.refine<string, typeof Schema.String>;
+    displayName: Schema.optional<Schema.SchemaClass<string, string, never>>;
+    hidden: Schema.optional<Schema.Schema<string, string, never>>;
+    type: Schema.Literal<["com.shwfed.form.field.radio.group"]>;
+    compatibilityDate: Schema.Literal<["2026-05-17"]>;
+}>;
+export type Value = Schema.Schema.Type<ReturnType<typeof schema>>;

package/dist/runtime/components/form/fields/2026-05-17/com.shwfed.form.field.radio.group/schema.js

@@ -0,0 +1,78 @@
+import { Schema } from "effect";
+import { Expression, LocaleMarkdown } from "../../../../../share/expression.js";
+import { Locale } from "../../../../../share/locale.js";
+import { commonFieldFields, derivedField } from "../../../utils/common.js";
+export const type = "com.shwfed.form.field.radio.group";
+export const compatibilityDate = "2026-05-17";
+export const metadata = {
+  name: "\u5355\u9009\u6846\u7EC4",
+  icon: "fluent:radio-button-20-regular",
+  w: { initial: 8, min: 2, max: Infinity },
+  h: { initial: 2, min: 2, max: 2 }
+};
+export function itemSchema(configure) {
+  const LocaleMd = LocaleMarkdown({ configure });
+  const TextValue = Schema.Struct({
+    kind: Schema.Literal("text"),
+    value: Schema.String
+  });
+  const NumberValue = Schema.Struct({
+    kind: Schema.Literal("number"),
+    value: Schema.Number
+  });
+  const ItemValue = Schema.Union(TextValue, NumberValue).annotations({
+    title: "\u503C",
+    description: "\u9009\u9879\u7ED1\u5B9A\u7684\u503C\uFF0C\u53EF\u4EE5\u662F\u6587\u672C\u6216\u6570\u5B57"
+  });
+  return Schema.Struct({
+    id: Schema.UUID.annotations({ description: "\u9009\u9879\u552F\u4E00\u6807\u8BC6\uFF0C\u7528\u4E8E\u7A33\u5B9A\u7684 v-for key" }),
+    label: LocaleMd.annotations({
+      title: "\u6807\u7B7E",
+      description: "\u9009\u9879\u5C55\u793A\u7684\u672C\u5730\u5316\u6587\u672C\uFF0C\u652F\u6301 Markdown \u4E0E `{{ form.foo }}` \u63D2\u503C"
+    }),
+    value: ItemValue,
+    tooltip: Schema.optional(LocaleMd.annotations({
+      title: "\u63D0\u793A",
+      description: "\u5C55\u793A\u5728\u9009\u9879\u6807\u7B7E\u4E0B\u65B9\u7684\u672C\u5730\u5316\u63D0\u793A\uFF0C\u652F\u6301 Markdown"
+    }))
+  }).annotations({
+    title: "RadioGroupItem"
+  });
+}
+export function schema(configure) {
+  const CelBool = Expression({ configure, resultType: "bool" });
+  const Item = itemSchema(configure);
+  return Schema.Struct({
+    type: Schema.Literal(type),
+    compatibilityDate: Schema.Literal(compatibilityDate),
+    ...commonFieldFields(configure),
+    label: Schema.optional(Locale.annotations({
+      title: "\u6807\u7B7E",
+      description: "\u5B57\u6BB5\u524D\u5C55\u793A\u7684\u6587\u672C\uFF1B\u7559\u7A7A\u5219\u4E0D\u6E32\u67D3\u6807\u7B7E"
+    })),
+    tooltip: Schema.optional(Locale.annotations({
+      title: "\u63D0\u793A",
+      description: "\u9F20\u6807\u60AC\u505C\u5728\u6807\u7B7E\u4E0A\u65F6\u5C55\u793A\u7684\u8BF4\u660E"
+    })),
+    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.role`\uFF1B\u5199\u5165\u503C\u4E3A\u9009\u4E2D\u9009\u9879\u7684\u503C\uFF1B\u7559\u7A7A\u5219\u4E3A\u975E\u53D7\u63A7\u5B57\u6BB5"
+    })),
+    disabled: Schema.optional(CelBool.annotations({
+      title: "\u7981\u7528\u6761\u4EF6",
+      description: "\u8FD4\u56DE `true` \u65F6\u5355\u9009\u6846\u4ECD\u7136\u6E32\u67D3\u4F46\u4E0D\u53EF\u9009\u62E9"
+    })),
+    readonly: Schema.optional(CelBool.annotations({
+      title: "\u53EA\u8BFB\u6761\u4EF6",
+      description: "\u8FD4\u56DE `true` \u65F6\u4EC5\u4EE5\u7EAF\u6587\u672C\u5C55\u793A\u5F53\u524D\u9009\u4E2D\u9009\u9879\u7684\u6807\u7B7E"
+    })),
+    derived: derivedField(configure, "dyn"),
+    items: Schema.optionalWith(Schema.Array(Item).annotations({
+      title: "\u9009\u9879",
+      description: "\u5355\u9009\u6846\u7EC4\u53EF\u9009\u9879\u5217\u8868"
+    }), { default: () => [] })
+  }).annotations({
+    title: "RadioGroupField",
+    description: "\u5355\u9009\u6846\u7EC4\u5355\u9009\u8F93\u5165"
+  });
+}

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

@@ -11,6 +11,12 @@ type __VLS_ModelProps = {
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
     seeded: Promise<void>;
+    flush: () => void;
+    settled: () => Promise<void>;
+    undo: () => void;
+    redo: () => void;
+    canUndo: import("vue").Ref<boolean, boolean>;
+    canRedo: import("vue").Ref<boolean, boolean>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: FormState) => any;
     "update:config": (value: FormConfigValue) => any;

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

@@ -1,5 +1,5 @@
 <script setup>
-import { useNuxtApp } from "#app";
+import { cel as _rawCel } from "../../utils/cel";
 import { TZDate } from "@date-fns/tz";
 import { Effect } from "effect";
 import { computed, onMounted, ref, watch } from "vue";
@@ -7,9 +7,14 @@ import {
   celBindings,
   injectCELContext,
   provideCELContext
-} from "../../plugins/cel/context";
+} from "../../utils/cel-context";
+import { provideCommitBus } from "./utils/commit-bus";
+import { provideDerivedQuiescence, useDerived } from "./utils/derived";
+import { useFormHistory } from "./utils/history";
+import { provideFormReadonly } from "./utils/readonly";
 import { findField } from "./utils/resolve";
 import { provideFormState } from "./utils/state";
+import { DEFAULT_GAP } from "./schema";
 defineOptions({ name: "ShwfedForm" });
 const state = defineModel({ type: Object, ...{ default: () => ({}) } });
 const config = defineModel("config", { type: Object, ...{ required: true } });
@@ -19,7 +24,6 @@ const props = defineProps({
 const configure = props.configure ?? (() => {
 });
 void configure;
-const { $cel: _rawCel } = useNuxtApp();
 provideCELContext({
   form: {
     type: "dyn",
@@ -40,7 +44,20 @@ provideCELContext({
 });
 const inherited = injectCELContext();
 const $cel = (expression, context) => _rawCel(expression, { ...celBindings(inherited), ...context });
-provideFormState(state);
+const formState = provideFormState(state);
+const commitBus = provideCommitBus();
+const quiescence = provideDerivedQuiescence();
+const formReadonly = computed(() => {
+  const expr = config.value.readonly;
+  if (!expr) return false;
+  try {
+    return Effect.runSync($cel(expr, { form: state.value ?? {} }));
+  } catch (err) {
+    console.error("[shwfed-form] failed to evaluate form readonly:", err);
+    return false;
+  }
+});
+provideFormReadonly(formReadonly);
 const seeded = (() => {
   const current = state.value ?? {};
   const initial = config.value.initial;
@@ -56,7 +73,23 @@ const seeded = (() => {
     }
   );
 })();
-defineExpose({ seeded });
+useDerived({
+  fields: () => config.value.fields,
+  evaluate: (expression) => $cel(expression),
+  ready: seeded,
+  formState,
+  quiescence
+});
+const formHistory = useFormHistory(state, { quiescence, seeded, dirty: formState.dirty });
+defineExpose({
+  seeded,
+  flush: commitBus.flushAll,
+  settled: quiescence.settled,
+  undo: formHistory.undo,
+  redo: formHistory.redo,
+  canUndo: formHistory.canUndo,
+  canRedo: formHistory.canRedo
+});
 function pickLayout(sets) {
   for (const set of sets) {
     if (!set.media) return set;
@@ -140,7 +173,9 @@ const gridStyle = computed(() => {
     "display: grid",
     `grid-template-columns: ${colTemplate}`,
     rowTemplate ? `grid-template-rows: ${rowTemplate}` : "",
-    l.gap ? `gap: calc(${l.gap} * 0.25rem)` : "",
+    // A missing `gap` resolves to `DEFAULT_GAP`, not 0 — same fallback the
+    // layout editor shows, so editor and render agree. `gap: 0` stays 0.
+    `gap: calc(${l.gap ?? DEFAULT_GAP} * 0.25rem)`,
     l.style ?? ""
   ].filter(Boolean);
   return parts.join("; ");

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

@@ -11,6 +11,12 @@ type __VLS_ModelProps = {
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
     seeded: Promise<void>;
+    flush: () => void;
+    settled: () => Promise<void>;
+    undo: () => void;
+    redo: () => void;
+    canUndo: import("vue").Ref<boolean, boolean>;
+    canRedo: import("vue").Ref<boolean, boolean>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: FormState) => any;
     "update:config": (value: FormConfigValue) => any;

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

@@ -3,7 +3,7 @@ import type { Environment } from '../../vendor/cel-js/lib/index.js';
 import { type LayoutSetValue } from '../../share/layout.js';
 export { commonFieldFields } from './utils/common.js';
 export { getStructFieldTitle, getStructFieldDescription } from './utils/schema-meta.js';
-export { Align, LayoutSet, validatePlacements } from '../../share/layout.js';
+export { Align, DEFAULT_GAP, LayoutSet, validatePlacements } from '../../share/layout.js';
 declare const KIND = "shwfed.component.form";
 type AnySchema = Schema.Schema<any, any, never>;
 /**
@@ -89,6 +89,7 @@ export declare function FormConfig(configure: (env: Environment) => void): Schem
         };
         readonly media?: string | undefined;
     }[];
+    readonly readonly?: string | undefined;
 }, Schema.Struct<{
     fields: Schema.Array$<AnySchema>;
     layouts: Schema.refine<readonly {
@@ -124,6 +125,7 @@ export declare function FormConfig(configure: (env: Environment) => void): Schem
     }>>>;
     kind: Schema.tag<"shwfed.component.form">;
     initial: Schema.optional<Schema.Schema<string, string, never>>;
+    readonly: Schema.optional<Schema.Schema<string, string, never>>;
 }>>;
 export declare function createFormConfig(body: Omit<Schema.Schema.Type<ReturnType<typeof FormConfig>>, 'kind'>): {
     initial?: string | undefined;
@@ -145,6 +147,7 @@ export declare function createFormConfig(body: Omit<Schema.Schema.Type<ReturnTyp
         };
         readonly media?: string | undefined;
     }[];
+    readonly?: string | undefined;
     kind: typeof KIND;
 };
 export declare function defaultFormConfig(): FormConfigValue;
@@ -161,4 +164,5 @@ export type FormUnitValue = Readonly<{
 export type FormConfigValue = Readonly<{
     kind: typeof KIND;
     initial?: string;
+    readonly?: string;
 }> & FormUnitValue;

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

@@ -8,7 +8,7 @@ import {
 } from "../../share/layout.js";
 export { commonFieldFields } from "./utils/common.js";
 export { getStructFieldTitle, getStructFieldDescription } from "./utils/schema-meta.js";
-export { Align, LayoutSet, validatePlacements } from "../../share/layout.js";
+export { Align, DEFAULT_GAP, LayoutSet, validatePlacements } from "../../share/layout.js";
 const KIND = "shwfed.component.form";
 function unitFields(configure) {
   const fieldSchemas = allFieldSchemas(configure);
@@ -40,9 +40,11 @@ export function FormUnit(configure) {
 export function FormConfig(configure) {
   const formConfigure = (env) => {
     env.registerVariable("now", "Date", { description: "\u5F53\u524D\u65E5\u671F/\u65F6\u95F4" });
+    env.registerVariable("form", "dyn", { description: "\u5F53\u524D\u8868\u5355\u72B6\u6001" });
     configure(env);
   };
   const CelFormInitial = Expression({ configure: formConfigure, resultType: "dyn" });
+  const CelFormReadonly = Expression({ configure: formConfigure, resultType: "bool" });
   return Schema.Struct({
     kind: Schema.tag(KIND),
     initial: Schema.optional(CelFormInitial.annotations({
@@ -59,6 +61,16 @@ export function FormConfig(configure) {
         - 如果配置了初始值，重置这个表单将**重置为其初始值，而非空**
       `
     })),
+    readonly: Schema.optional(CelFormReadonly.annotations({
+      title: "\u53EA\u8BFB\u6761\u4EF6",
+      description: md`
+        返回 \`true\` 时整个表单切到只读：所有字段以纯文本展示、不可编辑。
+
+        可访问 \`form\` 当前状态，因此可让表单按数据自锁——例如 \`form.status == 'submitted'\`，新建时可填、载入已提交的记录后只读。
+
+        字段自身的「只读条件」会**覆盖**这里：未配置只读条件的字段跟随本表达式，配置了的以字段自己的结果为准（可在只读表单中单独放开某个字段）。
+      `
+    })),
     ...unitFields(formConfigure)
   }).pipe(Schema.filter(unitPlacementsFilter)).annotations({
     title: "FormConfig",

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

@@ -9,9 +9,6 @@ export type UnitSelection = {
     id: string;
 } | {
     kind: 'layout';
-} | {
-    kind: 'field';
-    id: string;
 };
 type __VLS_Props = {
     /**

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

@@ -1,5 +1,5 @@
 <script setup>
-import { useNuxtApp } from "#app";
+import { cel as rawCel } from "../../utils/cel";
 import { Icon } from "@iconify/vue";
 import { Effect } from "effect";
 import { computed, inject, onBeforeUnmount, provide, ref, useTemplateRef, watch } from "vue";
@@ -7,7 +7,7 @@ import { toast } from "vue-sonner";
 import {
   celBindings,
   injectCELContext
-} from "../../plugins/cel/context";
+} from "../../utils/cel-context";
 import { findFreePlacement, normalizeLayoutSet } from "../../share/layout";
 import { getLocalizedText } from "../../share/locale";
 import BlockLayoutEditor from "../block-layout-editor/index.vue";
@@ -43,9 +43,7 @@ provide(FORM_FIELD_LAYOUT_KEY, { fullPane });
 const takeover = inject(SIDEBAR_TAKEOVER_KEY, null);
 const takeoverTarget = computed(() => takeover?.target.value ?? null);
 const activeFieldId = computed(() => {
-  const t = top.value;
-  if (t.kind === "field-drill") return t.id;
-  return selection.value.kind === "field" ? selection.value.id : null;
+  return top.value.kind === "field-drill" ? top.value.id : null;
 });
 const activeField = computed(() => {
   const id = activeFieldId.value;
@@ -148,7 +146,7 @@ function addField(entry, options) {
     layouts: nextLayouts
   };
   if (!options?.silent) {
-    selection.value = { kind: "field", id: field.id };
+    drillField(field.id);
   }
 }
 function removeField(id) {
@@ -169,9 +167,6 @@ function removeFields(ids) {
       });
     })
   };
-  if (selection.value.kind === "field" && drop.has(selection.value.id)) {
-    selection.value = { kind: "layout" };
-  }
   if (top.value.kind === "field-drill" && drop.has(top.value.id)) {
     stack.value = stack.value.slice(0, -1);
   }
@@ -185,7 +180,6 @@ function updateActiveField(next) {
   fields[i] = next;
   unit.value = { ...unit.value, fields };
 }
-const { $cel: rawCel } = useNuxtApp();
 const inheritedCEL = injectCELContext();
 function celForMigration(expression, context) {
   return rawCel(expression, { ...celBindings(inheritedCEL), ...context });

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

@@ -9,9 +9,6 @@ export type UnitSelection = {
     id: string;
 } | {
     kind: 'layout';
-} | {
-    kind: 'field';
-    id: string;
 };
 type __VLS_Props = {
     /**

package/dist/runtime/components/form/utils/commit-bus.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Form-wide registry of pending field commits.
+ *
+ * Text-like fields defer writing their draft into form state until blur (see
+ * `useFieldValue`). A focused field therefore still holds uncommitted input
+ * when something reads the form — e.g. a parent about to submit. The host
+ * calls `flushAll()` to drain every pending draft into form state first.
+ */
+export type CommitBus = {
+    /** Register a field's commit fn; returns a callback that unregisters it. */
+    register: (commit: () => void) => () => void;
+    /** Commit every registered field's pending draft. */
+    flushAll: () => void;
+};
+/**
+ * Provide a commit bus for the current form. Called once at the top-level
+ * form host; nested list rows inherit it through `inject`, so a single bus
+ * spans every field in the form regardless of nesting depth.
+ */
+export declare function provideCommitBus(): CommitBus;
+/**
+ * Inject the form's commit bus. Falls back to a no-op bus when a field is
+ * mounted outside a `<Form>` host — a field is fully functional without one;
+ * the bus only matters for host-driven flushing.
+ */
+export declare function useCommitBus(): CommitBus;