@shwfed/config 2.12.18 → 3.0.1

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

@@ -32,10 +32,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly format?: string | undefined;
-        readonly valueFormat?: string | undefined;
-        readonly disabledDate?: string | undefined;
         readonly rangeSeparatorIcon?: string | undefined;
+        readonly format?: string | undefined;
         readonly startPlaceholder?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -50,6 +48,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
+        readonly valueFormat?: string | undefined;
+        readonly disabledDate?: string | undefined;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -104,10 +104,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly mode: "formula" | "prefill";
             readonly expression: string;
         } | undefined;
-        readonly format?: string | undefined;
-        readonly valueFormat?: string | undefined;
-        readonly disabledDate?: string | undefined;
         readonly rangeSeparatorIcon?: string | undefined;
+        readonly format?: string | undefined;
         readonly startPlaceholder?: readonly [{
             readonly locale: "zh";
             readonly message: string;
@@ -122,6 +120,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]] | undefined;
+        readonly valueFormat?: string | undefined;
+        readonly disabledDate?: string | undefined;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";

package/dist/runtime/components/modal.d.vue.ts

@@ -10,29 +10,29 @@ declare function close(): void;
 declare var __VLS_20: {
     close: typeof close;
     isDesktop: boolean;
-}, __VLS_42: {
+}, __VLS_45: {
     close: typeof close;
     isDesktop: boolean;
-}, __VLS_50: {
+}, __VLS_53: {
     close: typeof close;
     isDesktop: boolean;
-}, __VLS_57: {
+}, __VLS_60: {
     close: typeof close;
     isDesktop: boolean;
-}, __VLS_65: {
+}, __VLS_68: {
     close: typeof close;
     isDesktop: boolean;
 };
 type __VLS_Slots = {} & {
     trigger?: (props: typeof __VLS_20) => any;
 } & {
-    title?: (props: typeof __VLS_42) => any;
+    title?: (props: typeof __VLS_45) => any;
 } & {
-    description?: (props: typeof __VLS_50) => any;
+    description?: (props: typeof __VLS_53) => any;
 } & {
-    default?: (props: typeof __VLS_57) => any;
+    default?: (props: typeof __VLS_60) => any;
 } & {
-    footer?: (props: typeof __VLS_65) => any;
+    footer?: (props: typeof __VLS_68) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:open": (open: boolean) => any;

package/dist/runtime/components/modal.vue

@@ -78,6 +78,9 @@ const open = computed({
 function close() {
   open.value = false;
 }
+function onDismissAttempt(event) {
+  if (!props.dismissible) event.preventDefault();
+}
 </script>
 
 <template>
@@ -98,12 +101,17 @@ function close() {
         />
       </component>
 
+      <!-- The × button is a dismiss affordance too — it hides alongside the
+           other dismissal paths while the modal is non-dismissible. -->
       <component
         :is="modalComponents.Content"
         v-bind="attrs"
-        :show-close-button="props.showCloseButton"
+        :show-close-button="props.showCloseButton && props.dismissible"
         :content-width="props.contentWidth"
         @after-close="emit('after-close')"
+        @escape-key-down="onDismissAttempt"
+        @pointer-down-outside="onDismissAttempt"
+        @interact-outside="onDismissAttempt"
       >
         <component
           :is="modalComponents.Header"

package/dist/runtime/components/modal.vue.d.ts

@@ -10,29 +10,29 @@ declare function close(): void;
 declare var __VLS_20: {
     close: typeof close;
     isDesktop: boolean;
-}, __VLS_42: {
+}, __VLS_45: {
     close: typeof close;
     isDesktop: boolean;
-}, __VLS_50: {
+}, __VLS_53: {
     close: typeof close;
     isDesktop: boolean;
-}, __VLS_57: {
+}, __VLS_60: {
     close: typeof close;
     isDesktop: boolean;
-}, __VLS_65: {
+}, __VLS_68: {
     close: typeof close;
     isDesktop: boolean;
 };
 type __VLS_Slots = {} & {
     trigger?: (props: typeof __VLS_20) => any;
 } & {
-    title?: (props: typeof __VLS_42) => any;
+    title?: (props: typeof __VLS_45) => any;
 } & {
-    description?: (props: typeof __VLS_50) => any;
+    description?: (props: typeof __VLS_53) => any;
 } & {
-    default?: (props: typeof __VLS_57) => any;
+    default?: (props: typeof __VLS_60) => any;
 } & {
-    footer?: (props: typeof __VLS_65) => any;
+    footer?: (props: typeof __VLS_68) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:open": (open: boolean) => any;

package/dist/runtime/components/sidebar/footer.vue

@@ -7,15 +7,12 @@ const props = defineProps({
 });
 const emit = defineEmits(["close"]);
 function onDismiss() {
+  if (props.state.saving.value) return;
   props.state.dismiss();
   emit("close");
 }
-function onConfirm() {
-  const errorBefore = props.state.validationError.value;
-  props.state.confirm();
-  const errorAfter = props.state.validationError.value;
-  if (errorAfter && errorAfter !== errorBefore) return;
-  if (!errorAfter) emit("close");
+async function onConfirm() {
+  if (await props.state.confirm()) emit("close");
 }
 </script>
 
@@ -26,11 +23,16 @@ function onConfirm() {
         v-if="props.state.validationError.value"
         class="text-red-500 break-all"
       >{{ props.state.validationError.value }}</span>
+      <span
+        v-if="props.state.saveError.value"
+        class="text-red-500 break-all"
+      >{{ props.state.saveError.value }}</span>
     </div>
     <Button
       type="button"
       variant="default"
       size="sm"
+      :disabled="props.state.saving.value"
       @click="onDismiss"
     >
       <Icon icon="fluent:dismiss-20-regular" />
@@ -40,9 +42,13 @@ function onConfirm() {
       type="button"
       variant="primary"
       size="sm"
+      :disabled="props.state.saving.value"
       @click="onConfirm"
     >
-      <Icon icon="fluent:checkmark-20-regular" />
+      <Icon
+        :icon="props.state.saving.value ? 'fluent:arrow-sync-20-regular' : 'fluent:checkmark-20-regular'"
+        :class="props.state.saving.value ? 'animate-spin' : ''"
+      />
       确认
     </Button>
   </div>

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

@@ -3,6 +3,7 @@ import { type SidebarConfigValue } from './schema.js';
 type __VLS_Props = {
     configure?: (env: Environment) => void;
     editable?: boolean;
+    save?: (config: SidebarConfigValue) => void | Promise<void>;
     storageKey?: string;
     collapsible?: 'offcanvas' | 'icon' | 'none';
     width?: string;

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

@@ -1,5 +1,6 @@
 <script setup>
 import { computed, ref, watch } from "vue";
+import { Icon } from "@iconify/vue";
 import { useLocalStorage } from "@vueuse/core";
 import { useRuntimeConfig } from "#app";
 import { injectCELContext } from "../../utils/cel-context";
@@ -9,6 +10,7 @@ import SidebarTree from "./tree.vue";
 import EditorBody from "./config.vue";
 import EditorFooter from "./footer.vue";
 import { useSidebarEditor } from "./use-editor";
+import { useUnsavedChangesGuard } from "../config/use-unsaved-guard";
 import { createSidebarConfig } from "./schema";
 defineOptions({ name: "ShwfedSidebar" });
 const configModel = defineModel("config", { type: null });
@@ -21,6 +23,7 @@ const config = computed({
 const props = defineProps({
   configure: { type: Function, required: false },
   editable: { type: Boolean, required: false },
+  save: { type: Function, required: false },
   storageKey: { type: String, required: false },
   collapsible: { type: String, required: false, default: "none" },
   width: { type: String, required: false, default: "13rem" }
@@ -83,10 +86,16 @@ const mergedConfigure = (env) => {
 const editorOpen = ref(false);
 const editorState = useSidebarEditor(config, {
   configure: mergedConfigure,
+  // Presence decided once at setup; the wrapper reads the current prop per
+  // call so a rebound handler identity stays honored (mirrors config/index.vue).
+  save: props.save ? (cfg) => props.save(cfg) : void 0,
   onClose: () => {
     editorOpen.value = false;
   }
 });
+useUnsavedChangesGuard(
+  () => props.editable === true && (editorState.isDirty.value || editorState.saving.value)
+);
 watch(editorOpen, (open, prev) => {
   if (open && !prev) editorState.reset();
 });
@@ -137,11 +146,16 @@ function onRootClick(event) {
       </SidebarProvider>
     </div>
 
+    <!-- While the draft is dirty (or a save is in flight) the modal refuses
+         casual dismissal — Esc, outside-click, and the × button all drop the
+         session on the reopen re-anchor above. The explicit footer exits
+         (取消 discards, 确认 saves) remain the only ways out of a dirty
+         session. Mirrors `config/index.vue`. -->
     <ShwfedModal
       v-if="editable"
       v-model:open="editorOpen"
       content-width="min(52rem, 92vw)"
-      :dismissible="true"
+      :dismissible="!editorState.isDirty.value && !editorState.saving.value"
     >
       <template #title>
         导航侧栏
@@ -149,7 +163,21 @@ function onRootClick(event) {
       <template #description>
         <span class="sr-only">编辑导航侧栏配置</span>
       </template>
-      <EditorBody :state="editorState" />
+      <!-- The overlay freezes the form while the host save runs: an edit
+           landing mid-save would be silently clobbered by the post-commit
+           draft re-anchor. -->
+      <div class="relative">
+        <EditorBody :state="editorState" />
+        <div
+          v-if="editorState.saving.value"
+          class="absolute inset-0 z-20 flex items-center justify-center bg-white/60"
+        >
+          <Icon
+            icon="fluent:arrow-sync-20-regular"
+            class="animate-spin text-2xl text-zinc-500"
+          />
+        </div>
+      </div>
       <template #footer>
         <EditorFooter
           :state="editorState"

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

@@ -3,6 +3,7 @@ import { type SidebarConfigValue } from './schema.js';
 type __VLS_Props = {
     configure?: (env: Environment) => void;
     editable?: boolean;
+    save?: (config: SidebarConfigValue) => void | Promise<void>;
     storageKey?: string;
     collapsible?: 'offcanvas' | 'icon' | 'none';
     width?: string;

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

@@ -4,14 +4,24 @@ import { type SidebarConfigValue } from './schema.js';
 export interface SidebarEditorState {
     draft: Ref<SidebarConfigValue>;
     validationError: Ref<string | null>;
+    saveError: Ref<string | null>;
+    saving: Ref<boolean>;
     isDirty: ComputedRef<boolean>;
     configure: (env: Environment) => void;
-    confirm: () => void;
+    confirm: () => Promise<boolean>;
     dismiss: () => void;
     reset: () => void;
 }
 export interface UseSidebarEditorOptions {
     configure?: (env: Environment) => void;
+    /**
+     * Delegated persistence. When provided, a successful 确认 first awaits this
+     * with the validated config; only after it resolves does the draft commit
+     * to the outer model and the editor close. A rejection keeps the editor
+     * open with the draft intact and surfaces the failure via `saveError` (see
+     * config/use-editor.ts — same contract).
+     */
+    save?: (config: SidebarConfigValue) => void | Promise<void>;
     /** Called after a successful 确认 commits the draft to the outer model. */
     onClose?: () => void;
 }

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

@@ -16,41 +16,62 @@ export function useSidebarEditor(model, options = {}) {
     () => JSON.stringify(draft.value) !== JSON.stringify(baseline.value)
   );
   const validationError = ref(null);
+  const saveError = ref(null);
+  const saving = ref(false);
   const validityRegistry = createExpressionValidityRegistry();
   provideExpressionValidity(validityRegistry);
-  function confirm() {
+  async function confirm() {
+    if (saving.value) return false;
     const schema = SidebarConfig(configure);
+    let decoded;
     try {
-      const decoded = Schema.decodeUnknownSync(schema)(draft.value);
-      if (!validityRegistry.allValid()) {
-        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;
-      }
-      const dangling = findDanglingLinkages(decoded);
-      if (dangling.length > 0) {
-        validationError.value = formatDanglingLinkages(dangling, decoded, () => void 0);
-        return;
-      }
-      validationError.value = null;
-      model.value = decoded;
-      baseline.value = deepClone(decoded);
-      draft.value = deepClone(decoded);
-      options.onClose?.();
+      decoded = Schema.decodeUnknownSync(schema)(draft.value);
     } catch (err) {
       validationError.value = formatValidationError(err, () => void 0, draft.value);
+      return false;
+    }
+    if (!validityRegistry.allValid()) {
+      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, () => void 0);
+      return false;
     }
+    validationError.value = null;
+    if (options.save) {
+      saving.value = true;
+      saveError.value = null;
+      try {
+        await options.save(deepClone(decoded));
+      } catch (err) {
+        saveError.value = `\u4FDD\u5B58\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}`;
+        return false;
+      } finally {
+        saving.value = false;
+      }
+    }
+    model.value = decoded;
+    baseline.value = deepClone(decoded);
+    draft.value = deepClone(decoded);
+    options.onClose?.();
+    return true;
   }
   function reset() {
     baseline.value = deepClone(model.value);
     draft.value = deepClone(model.value);
     validationError.value = null;
+    saveError.value = null;
   }
   function dismiss() {
+    if (saving.value) return;
     reset();
     options.onClose?.();
   }
   watch(draft, () => {
     if (validationError.value) validationError.value = null;
+    if (saveError.value) saveError.value = null;
   }, { deep: true });
-  return { draft, validationError, isDirty, configure, confirm, dismiss, reset };
+  return { draft, validationError, saveError, saving, isDirty, configure, confirm, dismiss, reset };
 }

package/dist/runtime/components/table/columns/2026-07-12/com.shwfed.table.column.dynamic/config.d.vue.ts

@@ -0,0 +1,10 @@
+type __VLS_ModelProps = {
+    modelValue: Record<string, any>;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: Record<string, any>) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: Record<string, any>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/table/columns/2026-07-12/com.shwfed.table.column.dynamic/config.vue

@@ -0,0 +1,73 @@
+<script setup>
+import { ExpressionEditor } from "../../../../ui/expression-editor";
+import { Field, FieldLabel } from "../../../../ui/field";
+import { Markdown } from "../../../../ui/markdown";
+import { getStructFieldDescription, getStructFieldTitle } from "../../../utils/schema-meta";
+import { schema } from "./schema";
+defineOptions({ name: "ShwfedTableDynamicColumnsConfig" });
+const value = defineModel({ type: Object, ...{ required: true } });
+const fieldSchema = schema(() => {
+});
+const fieldTitle = (field) => getStructFieldTitle(fieldSchema, field) ?? field;
+const fieldDescription = (field) => getStructFieldDescription(fieldSchema, field);
+const NON_ROW_EXCLUDE = ["row", "index", "selections", "options"];
+const TRANSFORM_VARS = {
+  json: { type: "optional<dyn>", label: "HTTP \u54CD\u5E94\u4F53" },
+  query: { type: "dyn", label: "\u641C\u7D22\u6761\u4EF6" }
+};
+</script>
+
+<template>
+  <div class="space-y-5">
+    <Field orientation="vertical">
+      <FieldLabel class="text-xs text-zinc-500">
+        <template
+          v-if="fieldDescription('request')"
+          #tooltip
+        >
+          <Markdown
+            :source="fieldDescription('request')"
+            block
+            class="prose prose-sm prose-zinc"
+          />
+        </template>
+        {{ fieldTitle("request") }}
+      </FieldLabel>
+      <ExpressionEditor
+        :model-value="value.request ?? ''"
+        placeholder="如 http.get('/api/columns').query('channel', 'invoice')"
+        result-type="HttpRequest"
+        multiline
+        class="min-h-20"
+        :exclude-vars="NON_ROW_EXCLUDE"
+        @update:model-value="(v) => value = { ...value, request: v }"
+      />
+    </Field>
+
+    <Field orientation="vertical">
+      <FieldLabel class="text-xs text-zinc-500">
+        <template
+          v-if="fieldDescription('transform')"
+          #tooltip
+        >
+          <Markdown
+            :source="fieldDescription('transform')"
+            block
+            class="prose prose-sm prose-zinc"
+          />
+        </template>
+        {{ fieldTitle("transform") }}
+      </FieldLabel>
+      <ExpressionEditor
+        :model-value="value.transform ?? ''"
+        placeholder="如 json.orValue([]).map(c, { 'key': c.parameter_name, 'header': c.name, 'kind': 'text', 'accessor': &quot;row.custom_property.filter(p, p.name == '&quot; + c.parameter_name + &quot;')[0].?value&quot; })"
+        result-type="list"
+        multiline
+        class="min-h-32"
+        :extra-vars="TRANSFORM_VARS"
+        :exclude-vars="NON_ROW_EXCLUDE"
+        @update:model-value="(v) => value = { ...value, transform: v }"
+      />
+    </Field>
+  </div>
+</template>

package/dist/runtime/components/table/columns/2026-07-12/com.shwfed.table.column.dynamic/config.vue.d.ts

@@ -0,0 +1,10 @@
+type __VLS_ModelProps = {
+    modelValue: Record<string, any>;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: Record<string, any>) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: Record<string, any>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/table/columns/2026-07-12/com.shwfed.table.column.dynamic/schema.d.ts

@@ -0,0 +1,63 @@
+import { Schema } from 'effect';
+import type { Environment } from '../../../../../vendor/cel-js/lib/index.js';
+import type { ColumnExpand } from '../../../utils/resolve.js';
+export declare const type: "com.shwfed.table.column.dynamic";
+export declare const compatibilityDate: "2026-07-12";
+export declare const metadata: {
+    readonly name: "动态列";
+    readonly icon: "fluent:table-lightning-20-regular";
+    readonly description: import("../../../../../share/markdown.js").Markdown;
+};
+declare const DynColumnKind: Schema.Literal<["text", "number", "date"]>;
+export type DynColumnKindValue = Schema.Schema.Type<typeof DynColumnKind>;
+/**
+ * The narrow, module-owned DTO the `transform` must emit per column. Keeping
+ * this contract closed (vs. exposing the internal column union) means internal
+ * schema evolution never breaks app config, the transform stays terse, and dyn
+ * cols auto-upgrade to the current renderer. Each element is decoded against
+ * this at runtime (partial-drop, loud) — the strongest static guarantee is
+ * only that `transform` returns `list<dyn>`.
+ */
+export declare const DynColumnDescriptor: Schema.Struct<{
+    key: Schema.filter<typeof Schema.String>;
+    header: typeof Schema.String;
+    kind: Schema.Literal<["text", "number", "date"]>;
+    accessor: Schema.filter<typeof Schema.String>;
+    /** px column width; defaults to 150. */
+    width: Schema.optional<typeof Schema.Number>;
+    /** Client-side sort by accessed value. */
+    sortable: Schema.optional<typeof Schema.Boolean>;
+    /** Backend sort field; only needed for server-side sort. */
+    sortKey: Schema.optional<typeof Schema.String>;
+    /** Default-hidden; the user can re-show it. */
+    hidden: Schema.optional<typeof Schema.Boolean>;
+    /** Header hover text; wrapped into a Locale by `expand`. */
+    tooltip: Schema.optional<typeof Schema.String>;
+    /** Text / number alignment. */
+    align: Schema.optional<Schema.Literal<["left", "center", "right"]>>;
+}>;
+export type DynColumnDescriptorValue = Schema.Schema.Type<typeof DynColumnDescriptor>;
+export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
+    request: Schema.Schema<string, string, never>;
+    transform: Schema.Schema<string, string, never>;
+    id: Schema.refine<string, typeof Schema.String>;
+    groupId: Schema.optional<typeof Schema.UUID>;
+    type: Schema.Literal<["com.shwfed.table.column.dynamic"]>;
+    compatibilityDate: Schema.Literal<["2026-07-12"]>;
+}>;
+export type Value = Schema.Schema.Type<ReturnType<typeof schema>>;
+export declare function defaults(): Partial<Value>;
+/**
+ * Runtime generator. Evaluates the block's `transform` against the fetched
+ * `json`, then decodes each element against `DynColumnDescriptor` — keeping the
+ * valid, dropping the invalid / duplicate / colliding (partial-drop, loud).
+ * Three failure layers (see the design doc):
+ *   1. transform throws / returns a non-list → the whole block yields 0 columns
+ *      (other columns render normally).
+ *   2. individual elements malformed / duplicate `key` / `key` colliding with a
+ *      static id → drop that element alone, first-wins on keys.
+ *   3. per-row accessor eval throws → handled downstream (`translateColumn`'s
+ *      `accessorFn` try/catches per row) — not here.
+ */
+export declare const expand: ColumnExpand;
+export {};