@shwfed/config 3.0.3 → 3.0.6

package/dist/module.json

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

package/dist/runtime/components/actions/buttons/2026-04-21/com.shwfed.actions.button.navigation/runtime.vue

@@ -1,6 +1,7 @@
 <script setup>
 import { Effect } from "effect";
 import { navigateTo, useRouter } from "#app";
+import { isAbsoluteUrl } from "../../../../../share/navigation";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
 import ShwfedActionDefinition from "../../../components/definition.vue";
@@ -12,23 +13,16 @@ const props = defineProps({
 const router = useRouter();
 const inherited = injectCELContext();
 const $cel = (expression, context) => _rawCel(expression, { ...celBindings(inherited), ...context });
-function isExternal(url) {
-  try {
-    return new URL(url, window.location.href).origin !== window.location.origin;
-  } catch {
-    return false;
-  }
-}
 const effect = Effect.suspend(
   () => Effect.flatMap(
     $cel(props.config.url),
     (url) => Effect.promise(async () => {
-      const external = isExternal(url);
+      const absolute = isAbsoluteUrl(url);
       if (props.config.mode === "_blank") {
-        window.open(external ? url : router.resolve(url).href, "_blank");
+        window.open(absolute ? url : router.resolve(url).href, "_blank");
         return;
       }
-      await navigateTo(url, { external });
+      await navigateTo(url, { external: absolute });
     })
   )
 );

package/dist/runtime/components/actions/buttons/2026-05-21/com.shwfed.actions.button.http.download/schema.d.ts

@@ -5,7 +5,7 @@ export declare const compatibilityDate: "2026-05-21";
 export declare const metadata: {
     readonly name: "下载文件";
     readonly icon: "fluent:arrow-download-20-regular";
-    readonly deprecated: "本按钮已废弃：改用「触发事件」按钮，其触发列表串联页面的「下载文件」操作；原两步式（先取凭据再下载）现为一个「发送请求」行后接一个引用 `steps[\"<步骤标识>\"]` 的「下载文件」行。";
+    readonly deprecated: "本按钮已废弃：改用「触发事件」按钮，其触发列表串联页面的「下载文件」操作；原两步式（先取凭据再下载）现为一个「发送请求」行后接一个引用 `steps[?\"<步骤标识>\"]` 的「下载文件」行。";
 };
 export declare const JSON_VAR: {
     readonly type: "dyn";

package/dist/runtime/components/actions/buttons/2026-05-21/com.shwfed.actions.button.http.download/schema.js

@@ -9,8 +9,8 @@ export const metadata = {
   icon: "fluent:arrow-download-20-regular",
   // No structured migrate target — designers rebuild downloads by hand. Use a
   // 触发事件 按钮，其触发列表串联页面的「下载文件」操作即可替代本按钮；原来的两步式
-  // （先取凭据再下载）现为一个「发送请求」行后接一个引用 `steps["<步骤标识>"]` 的「下载文件」行。
-  deprecated: '\u672C\u6309\u94AE\u5DF2\u5E9F\u5F03\uFF1A\u6539\u7528\u300C\u89E6\u53D1\u4E8B\u4EF6\u300D\u6309\u94AE\uFF0C\u5176\u89E6\u53D1\u5217\u8868\u4E32\u8054\u9875\u9762\u7684\u300C\u4E0B\u8F7D\u6587\u4EF6\u300D\u64CD\u4F5C\uFF1B\u539F\u4E24\u6B65\u5F0F\uFF08\u5148\u53D6\u51ED\u636E\u518D\u4E0B\u8F7D\uFF09\u73B0\u4E3A\u4E00\u4E2A\u300C\u53D1\u9001\u8BF7\u6C42\u300D\u884C\u540E\u63A5\u4E00\u4E2A\u5F15\u7528 `steps["<\u6B65\u9AA4\u6807\u8BC6>"]` \u7684\u300C\u4E0B\u8F7D\u6587\u4EF6\u300D\u884C\u3002'
+  // （先取凭据再下载）现为一个「发送请求」行后接一个引用 `steps[?"<步骤标识>"]` 的「下载文件」行。
+  deprecated: '\u672C\u6309\u94AE\u5DF2\u5E9F\u5F03\uFF1A\u6539\u7528\u300C\u89E6\u53D1\u4E8B\u4EF6\u300D\u6309\u94AE\uFF0C\u5176\u89E6\u53D1\u5217\u8868\u4E32\u8054\u9875\u9762\u7684\u300C\u4E0B\u8F7D\u6587\u4EF6\u300D\u64CD\u4F5C\uFF1B\u539F\u4E24\u6B65\u5F0F\uFF08\u5148\u53D6\u51ED\u636E\u518D\u4E0B\u8F7D\uFF09\u73B0\u4E3A\u4E00\u4E2A\u300C\u53D1\u9001\u8BF7\u6C42\u300D\u884C\u540E\u63A5\u4E00\u4E2A\u5F15\u7528 `steps[?"<\u6B65\u9AA4\u6807\u8BC6>"]` \u7684\u300C\u4E0B\u8F7D\u6587\u4EF6\u300D\u884C\u3002'
 };
 export const JSON_VAR = {
   type: "dyn",

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

@@ -1,5 +1,5 @@
 <script setup>
-import { Effect } from "effect";
+import { Cause, Effect } from "effect";
 import { createDefu } from "defu";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
@@ -51,7 +51,27 @@ const effect = Effect.suspend(() => {
             return Effect.map($cel(write.value, { steps }), (result) => {
               const merged = mergeAtPath(formState.getAt(path), result);
               formState.setAt(path, merged);
-            });
+            }).pipe(
+              // A row that blows up here — an expression that parses but throws on
+              // this click's data (`steps[?"r1"].json.rate` when the response was
+              // null), a path dot-prop cannot descend — is a *config* bug, not a
+              // condition the end user can act on. So: no toast, but never silent
+              // either. The failure otherwise reaches only the action runner's
+              // `catch`, whose `console.error` is `import.meta.dev`-gated — and the
+              // designer configures inside the running (production-built) app, so
+              // that log is one they can never see. Log ungated, like every other
+              // CEL misconfiguration in the runtime (`form/index.vue`,
+              // `sidebar/tree.vue`, the field runtimes), naming the row that failed;
+              // then re-raise so the click still halts (rows after it, and 写入后,
+              // stay skipped). `tapErrorCause` covers a throwing `setAt` (a defect)
+              // as well as a failed evaluation.
+              Effect.tapErrorCause((cause) => Effect.sync(() => {
+                console.error(
+                  `[shwfed-actions] state.write: failed to write "${path}" for ${props.buttonId}:`,
+                  Cause.squash(cause)
+                );
+              }))
+            );
           },
           { discard: true }
         )

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

@@ -35,8 +35,10 @@ export type WriteValue = Value['writes'][number];
  * Adopts 2026-06-25 values, whose「写入前」was a `requests` list of bare
  * HTTP-request expressions. Each row becomes one「发送请求」op trigger on the
  * page target — the op the button now dispatches instead of fetching itself.
- * The row's `id` is carried over verbatim, so every `steps["<id>"]` already
- * written into a write value keeps resolving; the op publishes its parsed
+ * The row's `id` is carried over verbatim, so every step reference already
+ * written into a write value keeps resolving — the strict `steps["<id>"]` those
+ * values carry as much as the optional `steps[?"<id>"]` the picker writes today,
+ * both addressing the same id; the op publishes its parsed
  * response under that same id and halts the chain on failure, which is what the
  * old inline requests did.
  *

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

@@ -36,7 +36,7 @@ export function schema(configure) {
         将取消本次写入。
 
         发布输出的操作（如「发送请求」）可在「写入值」与「写入后」中经
-        \`steps["<第 N 步>"]\` 引用其输出。
+        \`steps[?"<第 N 步>"]\` 引用其输出。
       `
     })),
     writes: Schema.Array(Write).annotations({

package/dist/runtime/components/actions/utils/steps.d.ts

@@ -1,7 +1,7 @@
 import type { TriggerValue } from '../../../share/event-bus.js';
 /**
  * One row of a trigger list that publishes a chain-step output — the rows a
- * later expression can address as `steps["<id>"]`.
+ * later expression can address as `steps[?"<id>"]`.
  *
  * A row qualifies on two counts, neither of them a type check: its operation's
  * registry `metadata.output` marks it as publishing (so a new publishing op

package/dist/runtime/components/config/blocks/2026-05-06/com.shwfed.block.table/config.d.vue.ts

@@ -228,6 +228,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
                 readonly expanded?: boolean | {
                     readonly [x: string]: boolean;
                 } | undefined;
+                readonly rowSelection?: {
+                    readonly [x: string]: boolean;
+                } | undefined;
                 readonly columnVisibility?: {
                     readonly [x: string]: boolean;
                 } | undefined;
@@ -248,9 +251,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
                 readonly columnSizing?: {
                     readonly [x: string]: number;
                 } | undefined;
-                readonly rowSelection?: {
-                    readonly [x: string]: boolean;
-                } | undefined;
             } | undefined;
         };
         readonly compatibilityDate: "2026-05-06";
@@ -476,6 +476,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
                 readonly expanded?: boolean | {
                     readonly [x: string]: boolean;
                 } | undefined;
+                readonly rowSelection?: {
+                    readonly [x: string]: boolean;
+                } | undefined;
                 readonly columnVisibility?: {
                     readonly [x: string]: boolean;
                 } | undefined;
@@ -496,9 +499,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
                 readonly columnSizing?: {
                     readonly [x: string]: number;
                 } | undefined;
-                readonly rowSelection?: {
-                    readonly [x: string]: boolean;
-                } | undefined;
             } | undefined;
         };
         readonly compatibilityDate: "2026-05-06";

package/dist/runtime/components/config/blocks/2026-05-06/com.shwfed.block.table/config.vue.d.ts

@@ -228,6 +228,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
                 readonly expanded?: boolean | {
                     readonly [x: string]: boolean;
                 } | undefined;
+                readonly rowSelection?: {
+                    readonly [x: string]: boolean;
+                } | undefined;
                 readonly columnVisibility?: {
                     readonly [x: string]: boolean;
                 } | undefined;
@@ -248,9 +251,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
                 readonly columnSizing?: {
                     readonly [x: string]: number;
                 } | undefined;
-                readonly rowSelection?: {
-                    readonly [x: string]: boolean;
-                } | undefined;
             } | undefined;
         };
         readonly compatibilityDate: "2026-05-06";
@@ -476,6 +476,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
                 readonly expanded?: boolean | {
                     readonly [x: string]: boolean;
                 } | undefined;
+                readonly rowSelection?: {
+                    readonly [x: string]: boolean;
+                } | undefined;
                 readonly columnVisibility?: {
                     readonly [x: string]: boolean;
                 } | undefined;
@@ -496,9 +499,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
                 readonly columnSizing?: {
                     readonly [x: string]: number;
                 } | undefined;
-                readonly rowSelection?: {
-                    readonly [x: string]: boolean;
-                } | undefined;
             } | undefined;
         };
         readonly compatibilityDate: "2026-05-06";

package/dist/runtime/components/config/blocks/2026-05-06/com.shwfed.block.table/runtime.d.vue.ts

@@ -223,6 +223,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 readonly expanded?: boolean | {
                     readonly [x: string]: boolean;
                 } | undefined;
+                readonly rowSelection?: {
+                    readonly [x: string]: boolean;
+                } | undefined;
                 readonly columnVisibility?: {
                     readonly [x: string]: boolean;
                 } | undefined;
@@ -243,9 +246,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 readonly columnSizing?: {
                     readonly [x: string]: number;
                 } | undefined;
-                readonly rowSelection?: {
-                    readonly [x: string]: boolean;
-                } | undefined;
             } | undefined;
         };
         readonly compatibilityDate: "2026-05-06";
@@ -471,6 +471,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 readonly expanded?: boolean | {
                     readonly [x: string]: boolean;
                 } | undefined;
+                readonly rowSelection?: {
+                    readonly [x: string]: boolean;
+                } | undefined;
                 readonly columnVisibility?: {
                     readonly [x: string]: boolean;
                 } | undefined;
@@ -491,9 +494,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 readonly columnSizing?: {
                     readonly [x: string]: number;
                 } | undefined;
-                readonly rowSelection?: {
-                    readonly [x: string]: boolean;
-                } | undefined;
             } | undefined;
         };
         readonly compatibilityDate: "2026-05-06";

package/dist/runtime/components/config/blocks/2026-05-06/com.shwfed.block.table/runtime.vue.d.ts

@@ -223,6 +223,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 readonly expanded?: boolean | {
                     readonly [x: string]: boolean;
                 } | undefined;
+                readonly rowSelection?: {
+                    readonly [x: string]: boolean;
+                } | undefined;
                 readonly columnVisibility?: {
                     readonly [x: string]: boolean;
                 } | undefined;
@@ -243,9 +246,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 readonly columnSizing?: {
                     readonly [x: string]: number;
                 } | undefined;
-                readonly rowSelection?: {
-                    readonly [x: string]: boolean;
-                } | undefined;
             } | undefined;
         };
         readonly compatibilityDate: "2026-05-06";
@@ -471,6 +471,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 readonly expanded?: boolean | {
                     readonly [x: string]: boolean;
                 } | undefined;
+                readonly rowSelection?: {
+                    readonly [x: string]: boolean;
+                } | undefined;
                 readonly columnVisibility?: {
                     readonly [x: string]: boolean;
                 } | undefined;
@@ -491,9 +494,6 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
                 readonly columnSizing?: {
                     readonly [x: string]: number;
                 } | undefined;
-                readonly rowSelection?: {
-                    readonly [x: string]: boolean;
-                } | undefined;
             } | undefined;
         };
         readonly compatibilityDate: "2026-05-06";

package/dist/runtime/components/config/blocks/2026-05-06/com.shwfed.block.table/schema.d.ts

@@ -241,6 +241,9 @@ export declare function schema(configure: (env: Environment) => void, _blockRef:
             readonly expanded?: boolean | {
                 readonly [x: string]: boolean;
             } | undefined;
+            readonly rowSelection?: {
+                readonly [x: string]: boolean;
+            } | undefined;
             readonly columnVisibility?: {
                 readonly [x: string]: boolean;
             } | undefined;
@@ -261,9 +264,6 @@ export declare function schema(configure: (env: Environment) => void, _blockRef:
             readonly columnSizing?: {
                 readonly [x: string]: number;
             } | undefined;
-            readonly rowSelection?: {
-                readonly [x: string]: boolean;
-            } | undefined;
         } | undefined;
     }, Schema.Struct<{
         kind: Schema.tag<"shwfed.component.table">;

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

@@ -13,6 +13,7 @@ import ShwfedModal from "../modal.vue";
 import EditorBody from "./config.vue";
 import EditorBreadcrumb from "./breadcrumb.vue";
 import EditorFooter from "./footer.vue";
+import PruneDialog from "./prune-dialog.vue";
 import { provideEventTarget } from "../../share/event-bus";
 import { operationHandlers } from "../operations/utils/resolve";
 import * as alertOperation from "../operations/2026-06-09/com.shwfed.operation.alert/schema";
@@ -95,12 +96,31 @@ provideEventTarget(PAGE_TARGET_ID, {
   )
 });
 const editorOpen = ref(false);
+const pendingPrune = ref(null);
+let settlePrune = null;
+function confirmPrune(items) {
+  resolvePrune(false);
+  pendingPrune.value = items;
+  return new Promise((resolve) => {
+    settlePrune = resolve;
+  });
+}
+function resolvePrune(proceed) {
+  pendingPrune.value = null;
+  const settle = settlePrune;
+  settlePrune = null;
+  settle?.(proceed);
+}
+onBeforeUnmount(() => {
+  if (settlePrune) resolvePrune(false);
+});
 const editorState = useConfigEditor(config, {
   configure: mergedConfigure,
   // Presence is decided once at setup (a host toggling the prop's existence
   // at runtime is not supported); the wrapper reads the current prop per
   // call so a rebound handler identity stays honored.
   save: props.save ? (cfg) => props.save(cfg) : void 0,
+  confirmPrune,
   onClose: () => {
     editorOpen.value = false;
   }
@@ -243,6 +263,11 @@ const isMac = computed(
           />
         </div>
       </div>
+      <PruneDialog
+        :items="pendingPrune"
+        @confirm="resolvePrune(true)"
+        @cancel="resolvePrune(false)"
+      />
       <template #footer>
         <EditorFooter
           :state="editorState"

package/dist/runtime/components/config/prune-dialog.d.vue.ts

@@ -0,0 +1,14 @@
+import { type PruneSummary } from './utils/prune.js';
+type __VLS_Props = {
+    /** Non-null while the gate is open; one entry per item about to be dropped. */
+    items: ReadonlyArray<PruneSummary> | null;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    cancel: () => any;
+    confirm: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCancel?: (() => any) | undefined;
+    onConfirm?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/config/prune-dialog.vue

@@ -0,0 +1,72 @@
+<script setup>
+import { computed } from "vue";
+import { Icon } from "@iconify/vue";
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle
+} from "../ui/alert-dialog";
+import { pruneKindNoun } from "./utils/prune";
+defineOptions({ name: "ShwfedConfigPruneDialog" });
+const props = defineProps({
+  items: { type: [Array, null], required: true }
+});
+const emit = defineEmits(["confirm", "cancel"]);
+const open = computed(() => props.items !== null);
+function onOpenChange(next) {
+  if (!next) emit("cancel");
+}
+</script>
+
+<template>
+  <AlertDialog
+    :open="open"
+    @update:open="onOpenChange"
+  >
+    <AlertDialogContent class="sm:px-12 sm:py-8 flex flex-col gap-8">
+      <AlertDialogHeader class="sr-only">
+        <AlertDialogTitle>清理未使用的内容</AlertDialogTitle>
+        <AlertDialogDescription>Confirmation dialog</AlertDialogDescription>
+      </AlertDialogHeader>
+      <Icon
+        icon="fluent:broom-20-filled"
+        class="text-6xl mx-auto text-yellow-500"
+      />
+      <div class="flex flex-col gap-3">
+        <p class="text-sm text-zinc-900">
+          以下内容未放入任何布局，不会在页面上显示。保存时将一并删除：
+        </p>
+        <ul class="max-h-60 overflow-y-auto flex flex-col gap-1 rounded border border-zinc-200 bg-zinc-50 p-3">
+          <li
+            v-for="(item, i) in props.items ?? []"
+            :key="i"
+            class="flex items-baseline gap-2 text-sm text-zinc-700"
+          >
+            <span class="shrink-0 rounded bg-zinc-200 px-1.5 py-0.5 text-xs text-zinc-600">
+              {{ pruneKindNoun(item.kind) }}
+            </span>
+            <span class="break-all">{{ item.label }}</span>
+          </li>
+        </ul>
+        <p class="text-xs text-zinc-500">
+          若仍需保留，请点击取消，并将其放入布局。
+        </p>
+      </div>
+      <AlertDialogFooter>
+        <AlertDialogCancel @click="emit('cancel')">
+          <Icon icon="fluent:dismiss-20-regular" />
+          取消
+        </AlertDialogCancel>
+        <AlertDialogAction @click="emit('confirm')">
+          <Icon icon="fluent:checkmark-20-regular" />
+          删除并保存
+        </AlertDialogAction>
+      </AlertDialogFooter>
+    </AlertDialogContent>
+  </AlertDialog>
+</template>

package/dist/runtime/components/config/prune-dialog.vue.d.ts

@@ -0,0 +1,14 @@
+import { type PruneSummary } from './utils/prune.js';
+type __VLS_Props = {
+    /** Non-null while the gate is open; one entry per item about to be dropped. */
+    items: ReadonlyArray<PruneSummary> | null;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    cancel: () => any;
+    confirm: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCancel?: (() => any) | undefined;
+    onConfirm?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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

@@ -33,7 +33,7 @@ export const metadata = {
       icon: httpRequestOperation.metadata.icon
     },
     // Navigation as an op (replaces the standalone navigation *button*): its URL
-    // expression can reference `steps["<id>"]`, so a chain can navigate using an
+    // expression can reference `steps[?"<id>"]`, so a chain can navigate using an
     // earlier request's response. The page hosts it for the same reason as the
     // request op — navigation acts on nothing instance-specific.
     {
@@ -43,7 +43,7 @@ export const metadata = {
       icon: navigationOperation.metadata.icon
     },
     // Download as an op (replaces the standalone download *button*): its request
-    // expression can reference `steps["<id>"]`, so the old two-step「先取凭据再下载」
+    // expression can reference `steps[?"<id>"]`, so the old two-step「先取凭据再下载」
     // becomes a 发送请求 row followed by this download row. The page hosts it for
     // the same reason as the request op — the download acts on nothing
     // instance-specific.

package/dist/runtime/components/config/use-editor.d.ts

@@ -4,6 +4,7 @@ import { type LayoutSetValue, type PlacementValue, type SlotValue } from '../../
 import type { BreadcrumbCrumb, BreadcrumbParentSuffix } from './breadcrumb-extension.js';
 import { type BlockValue, type PageConfigValue } from './schema.js';
 import { type BlockEntry } from './utils/resolve.js';
+import { type PruneSummary } from './utils/prune.js';
 export type PickerEntry = {
     type: string;
     compatibilityDate: string;
@@ -133,6 +134,14 @@ export interface UseConfigEditorOptions {
      * the editor guarantees the session is never lost to a failed save.
      */
     save?: (config: PageConfigValue) => void | Promise<void>;
+    /**
+     * Consent gate for the save-time prune of unplaced items (utils/prune.ts).
+     * Called only when 确认 would actually drop something, with a breadcrumb per
+     * removal; resolving `false` aborts the save with the draft untouched. Hosts
+     * wire this to a confirmation dialog — `ShwfedConfig` does. Left unwired, the
+     * prune is silent.
+     */
+    confirmPrune?: (items: ReadonlyArray<PruneSummary>) => boolean | Promise<boolean>;
     /**
      * Called after a successful 确认 commits the draft to the outer model.
      * Hosts wire this to close the modal; legacy mode emits `close`.

package/dist/runtime/components/config/use-editor.js

@@ -7,6 +7,12 @@ import { PageConfig } from "./schema.js";
 import { BLOCKS, findBlock } from "./utils/resolve.js";
 import { formatValidationError } from "./utils/validation-error.js";
 import { findDanglingLinkages, formatDanglingLinkages } from "./utils/linkage.js";
+import {
+  findPruneConflicts,
+  formatPruneConflicts,
+  pruneUnplaced,
+  summarizePrune
+} from "./utils/prune.js";
 import { createExpressionValidityRegistry, provideExpressionValidity } from "../ui/expression-editor/index.js";
 function deepClone(value) {
   return JSON.parse(JSON.stringify(value));
@@ -396,20 +402,42 @@ export function useConfigEditor(model, options = {}) {
       validationError.value = "\u5B58\u5728\u65E0\u6548\u7684\u8DE8\u5C42\u4F5C\u7528\u57DF\u5F15\u7528\uFF0C\u8BF7\u4FEE\u6B63\u6807\u7EA2\u7684\u8868\u8FBE\u5F0F\u540E\u518D\u4FDD\u5B58";
       return false;
     }
-    const dangling = findDanglingLinkages(decoded);
-    if (dangling.length > 0) {
-      validationError.value = formatDanglingLinkages(dangling, decoded, (i) => {
-        const b = topSlotEditor.blocks.value[i];
-        return b ? topSlotEditor.getBlockLabel(b) : void 0;
+    const { config: pruned, removed } = pruneUnplaced(decoded);
+    const draftBlockLabelAt = (i) => {
+      const b = topSlotEditor.blocks.value[i];
+      return b ? topSlotEditor.getBlockLabel(b) : void 0;
+    };
+    const prunedBlockLabelAt = (i) => {
+      const b = pruned.slot.blocks[i];
+      return b ? topSlotEditor.getBlockLabel(b) : void 0;
+    };
+    const conflicts = findPruneConflicts(pruned, removed);
+    if (conflicts.length > 0) {
+      validationError.value = formatPruneConflicts(conflicts, {
+        prunedRoot: pruned,
+        originalRoot: decoded,
+        prunedBlockLabelAt,
+        originalBlockLabelAt: draftBlockLabelAt
       });
       return false;
     }
+    const dangling = findDanglingLinkages(pruned);
+    if (dangling.length > 0) {
+      validationError.value = formatDanglingLinkages(dangling, pruned, prunedBlockLabelAt);
+      return false;
+    }
     validationError.value = null;
+    if (removed.length > 0 && options.confirmPrune) {
+      const proceed = await options.confirmPrune(
+        summarizePrune(removed, decoded, draftBlockLabelAt)
+      );
+      if (!proceed) return false;
+    }
     if (options.save) {
       saving.value = true;
       saveError.value = null;
       try {
-        await options.save(deepClone(decoded));
+        await options.save(deepClone(pruned));
       } catch (err) {
         saveError.value = `\u4FDD\u5B58\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}`;
         return false;
@@ -417,9 +445,9 @@ export function useConfigEditor(model, options = {}) {
         saving.value = false;
       }
     }
-    model.value = decoded;
-    baseline.value = deepClone(decoded);
-    draft.value = deepClone(decoded);
+    model.value = pruned;
+    baseline.value = deepClone(pruned);
+    draft.value = deepClone(pruned);
     stack.value = [{ kind: "layout" }];
     topSlotEditor.selectedBlockIds.value = [];
     topSlotEditor.activeLayoutIndex.value = 0;

package/dist/runtime/components/config/utils/linkage.d.ts

@@ -11,6 +11,13 @@ export type DanglingLinkage = Readonly<{
      */
     path: ReadonlyArray<PropertyKey>;
 }>;
+/**
+ * Every uuid `id` defined under `node`. Exported so the save-time prune
+ * (utils/prune.ts) asks what a to-be-removed subtree *defines* with the very
+ * same rule this gate uses to decide what is *defined* — the two must agree, or
+ * a prune would strand a linkage this walker then fails to flag.
+ */
+export declare function definedIds(node: unknown): Set<string>;
 /**
  * Find every linkage in `config` whose target uuid is not defined anywhere in
  * the tree. `PAGE_TARGET_ID` (the singleton page target sentinel) is always
@@ -19,6 +26,7 @@ export type DanglingLinkage = Readonly<{
  * the caller can render a field-level breadcrumb (see `describePath`).
  */
 export declare function findDanglingLinkages(config: unknown): DanglingLinkage[];
+export declare const LINKAGE_KIND_LABEL: Record<LinkageKind, string>;
 /**
  * One-line save-footer message for a non-empty dangling list. Renders the
  * breadcrumb to the first offending reference (`「表单 › 确定 › value」`) via the

package/dist/runtime/components/config/utils/linkage.js

@@ -17,6 +17,11 @@ function collectDefinedIds(node, into) {
     collectDefinedIds(v, into);
   }
 }
+export function definedIds(node) {
+  const out = /* @__PURE__ */ new Set();
+  collectDefinedIds(node, out);
+  return out;
+}
 function collectRefs(node, path, into) {
   if (Array.isArray(node)) {
     node.forEach((v, i) => collectRefs(v, [...path, i], into));
@@ -41,7 +46,7 @@ export function findDanglingLinkages(config) {
   collectRefs(config, [], refs);
   return refs.filter((r) => r.id !== PAGE_TARGET_ID && !defined.has(r.id));
 }
-const KIND_LABEL = {
+export const LINKAGE_KIND_LABEL = {
   operation: "\u89E6\u53D1\u64CD\u4F5C",
   step: "\u6B65\u9AA4\u5F15\u7528",
   scope: "\u8DE8\u5C42\u4F5C\u7528\u57DF\u5F15\u7528"
@@ -49,7 +54,7 @@ const KIND_LABEL = {
 export function formatDanglingLinkages(dangling, rootData, blockLabelAt) {
   const first = dangling[0];
   if (!first) return "";
-  const kind = KIND_LABEL[first.kind];
+  const kind = LINKAGE_KIND_LABEL[first.kind];
   const segs = describePath(first.path, rootData, blockLabelAt);
   const where = segs.length > 0 ? `\u300C${segs.join(" \u203A ")}\u300D\u7684${kind}` : kind;
   const suffix = dangling.length > 1 ? `\uFF08\u8FD8\u6709 ${dangling.length - 1} \u4E2A\uFF09` : "";