@shwfed/config 3.0.14 → 3.0.15

package/dist/runtime/components/form/fields/2026-07-18/com.shwfed.form.field.richtext/indent.js

@@ -0,0 +1,64 @@
+import { Extension } from "@tiptap/core";
+export const Indent = Extension.create({
+  name: "indent",
+  // Load-bearing. Extensions are sorted by priority descending and their keymap
+  // plugins run in that order, with ProseMirror stopping at the first handler
+  // that returns true. `ListItem` and the table extension both bind Tab at the
+  // default priority of 100; sitting at 50 puts this keymap last, so nesting a
+  // list item and moving between table cells keep first refusal and Tab only
+  // reaches paragraph indentation when neither applies.
+  priority: 50,
+  addOptions() {
+    return { types: ["paragraph"], step: 2, maxLevel: 8 };
+  },
+  addGlobalAttributes() {
+    return [{
+      types: this.options.types,
+      attributes: {
+        indent: {
+          default: 0,
+          keepOnSplit: true,
+          parseHTML: (element) => {
+            const raw = element.style.marginInlineStart || element.style.marginLeft;
+            if (!raw) return 0;
+            const em = Number.parseFloat(raw);
+            return Number.isFinite(em) ? Math.round(em / this.options.step) : 0;
+          },
+          renderHTML: (attributes) => {
+            const level = Number(attributes.indent) || 0;
+            if (level <= 0) return {};
+            return { style: `margin-inline-start: ${level * this.options.step}em` };
+          }
+        }
+      }
+    }];
+  },
+  addCommands() {
+    const clamp = (n) => Math.min(Math.max(n, 0), this.options.maxLevel);
+    const apply = (next) => ({ state, tr, dispatch }) => {
+      const { from, to } = state.selection;
+      let changed = false;
+      state.doc.nodesBetween(from, to, (node, pos) => {
+        if (!this.options.types.includes(node.type.name)) return;
+        const current = Number(node.attrs.indent) || 0;
+        const level = clamp(next(current));
+        if (level === current) return;
+        tr.setNodeMarkup(pos, void 0, { ...node.attrs, indent: level });
+        changed = true;
+      });
+      if (!changed) return false;
+      if (dispatch) dispatch(tr);
+      return true;
+    };
+    return {
+      indent: () => apply((current) => current + 1),
+      outdent: () => apply((current) => current - 1)
+    };
+  },
+  addKeyboardShortcuts() {
+    return {
+      "Tab": () => this.editor.commands.indent(),
+      "Shift-Tab": () => this.editor.commands.outdent()
+    };
+  }
+});

package/dist/runtime/components/form/fields/2026-07-18/com.shwfed.form.field.richtext/prompt.md

@@ -0,0 +1,33 @@
+**何时用我**：需要用户输入**带简单排版的正文**（公告、说明、条款……），且这段内容要以 HTML 存取。只要纯文本（哪怕多行）就用 `textarea`，不要用我。
+
+**配置配方**
+
+- `binding`：写入表单状态的 dot-prop 路径（如 `article.body`）。写入的值是 **HTML 字符串**。
+- `placeholder`：正文为空时的占位文本（纯文本 Locale）。
+- 其余 `label` / `tooltip` / `required` / `hidden` / `disabled` / `readonly` / `validations` / `derived` 与其它输入字段一致。
+
+**功能清单**（两个数组，**都是必填**）
+
+- `inline`：行内样式，取值 `bold` / `italic` / `underline` / `strike`。
+- `block`：块级功能，取值 `bulletList` / `orderedList`。
+
+新建时用 `defaults()` 的种子——两个数组全开。只有用户明确要求裁剪（"不要斜体"）时才删元素，**不要自作主张删**。数组元素顺序固定按上面的顺序写。
+
+不要编造别的开关。**左/中/右对齐和增减缩进是常驻功能，不在这两个数组里**，也没有对应配置项。
+
+**能力边界**：加粗、斜体、下划线、删除线、无序列表、有序列表、左中右对齐、缩进/减少缩进。
+
+**没有链接，也没有表格**——这两项已被移除，交互设计需要重新考虑。用户要求这两个功能时，直接说明当前不支持，**不要编造 `link` / `table` 配置项**，也不要建议用别的字段拼凑。
+
+其余不支持的还有：标题、图片、代码块、引用、任务列表。
+
+**坑**
+
+- 正文为空时写入的是 `null`，不是 `''`，也不是 `<p></p>`。`required` 与自定义校验按 `null` 判空即可。
+- 值是 HTML 而非 Markdown。要在别处展示它，直接渲染 HTML；不要套 `markdown` 字段或 `Markdown` 组件。**编辑器不解析 Markdown**：用户敲 `**x**`、`- `、`# ` 不会自动变格式，别向用户承诺这个行为。
+- 载入的 HTML 只保留上面列出的能力，**其余标签会被拍平**：`<a>` 退化成纯文本、`<table>` 只剩单元格文字、`<h1>` 变普通段落。文字不会丢，结构会丢。从别处迁移内容进来前先确认这一点。
+- 从数组里删掉一项只是收回"写"的入口（按钮不渲染、快捷键解绑），**不会清洗存量内容**——已有的加粗照常显示和保存。所以删元素不能用来做数据清理。
+- 缩进落在 HTML 里是 `<p style="margin-inline-start: Nem">`，对齐是 `<p style="text-align: …">`；未对齐/未缩进的段落不带 `style`。如果后端会过滤内联样式，这两项会丢。
+- 校验规则里对正文做长度判断会连 HTML 标签一起算进去——需要按可见字数校验时先向用户确认口径，不要想当然。
+- `derived` 的表达式返回的同样是 HTML 字符串。
+- 这是块级字段，`h.grow` 为真、高度跟随内容；布局里给它留足空间（默认 12×8）。

package/dist/runtime/components/form/fields/2026-07-18/com.shwfed.form.field.richtext/runtime.d.vue.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-07-18/com.shwfed.form.field.richtext/runtime.vue

@@ -0,0 +1,121 @@
+<script setup>
+import { Effect } from "effect";
+import { computed } from "vue";
+import { useI18n } from "vue-i18n";
+import { cel as _rawCel } from "../../../../../utils/cel";
+import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
+import { getLocalizedText } from "../../../../../share/locale";
+import { interpolateMarkdown } from "../../../../table/utils/runtime";
+import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
+import { Markdown } from "../../../../ui/markdown";
+import { useFieldValue } from "../../../utils/field-value";
+import { useFieldValidation } from "../../../utils/validation";
+import { useFormReadonly } from "../../../utils/readonly";
+import { useFormScope } from "../../../utils/state";
+import RichTextEditor from "./RichTextEditor.vue";
+import { featureSignature, resolveFeatures } from "./features";
+defineOptions({ name: "ShwfedRichTextFieldRuntime" });
+const props = defineProps({
+  fieldId: { type: String, required: true },
+  config: { type: null, required: true }
+});
+const { locale } = useI18n();
+const formScope = useFormScope();
+const inherited = injectCELContext();
+const $cel = (expression, context) => _rawCel(expression, { ...celBindings(inherited), ...context });
+const labelText = computed(() => getLocalizedText(props.config.label, locale.value));
+const placeholderText = computed(
+  () => props.config.placeholder ? getLocalizedText(props.config.placeholder, locale.value) : void 0
+);
+const tooltipText = computed(() => {
+  const raw = props.config.tooltip ? getLocalizedText(props.config.tooltip, locale.value) : void 0;
+  return raw ? interpolateMarkdown(raw, $cel, { form: formScope.state.value ?? {} }) : void 0;
+});
+function evalBool(expression, label) {
+  if (!expression) return false;
+  try {
+    return Effect.runSync($cel(expression, { form: formScope.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");
+const { draft, commit } = useFieldValue({
+  binding: () => props.config.binding,
+  fromState: (raw) => raw == null ? "" : String(raw),
+  toState: (next) => next.length === 0 ? null : next
+});
+const features = computed(() => resolveFeatures(props.config));
+const featureKey = computed(() => featureSignature(features.value));
+const { isRequired, errors, warnings, visible } = useFieldValidation({
+  fieldId: () => props.fieldId,
+  config: () => props.config,
+  $cel,
+  locale: () => locale.value
+});
+</script>
+
+<template>
+  <Field
+    orientation="vertical"
+    :data-disabled="isDisabled || void 0"
+  >
+    <FieldLabel
+      v-if="labelText"
+      :for="fieldId"
+      class="text-xs text-zinc-500"
+    >
+      <template
+        v-if="tooltipText"
+        #tooltip
+      >
+        <Markdown
+          :source="tooltipText"
+          class="prose prose-xs prose-zinc"
+        />
+      </template>
+      {{ labelText }}<span
+        v-if="isRequired"
+        aria-hidden="true"
+        class="text-red-600"
+      > *</span>
+    </FieldLabel>
+    <div
+      v-if="effectiveReadonly"
+      data-slot="field-value"
+      data-value="true"
+      class="min-h-9 py-1.5 text-sm"
+    >
+      <div
+        v-if="draft"
+        class="prose prose-sm prose-zinc max-w-none"
+        v-html="draft"
+      />
+      <span
+        v-else
+        class="font-mono text-zinc-300 select-none"
+      >-</span>
+    </div>
+    <RichTextEditor
+      v-else
+      :id="fieldId"
+      :key="featureKey"
+      v-model="draft"
+      :features="features"
+      :placeholder="placeholderText"
+      :editable="!isDisabled"
+      @blur="commit"
+    />
+    <FieldMessages
+      v-if="visible"
+      :errors="errors"
+      :warnings="warnings"
+    />
+  </Field>
+</template>

package/dist/runtime/components/form/fields/2026-07-18/com.shwfed.form.field.richtext/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-07-18/com.shwfed.form.field.richtext/schema.d.ts

@@ -0,0 +1,133 @@
+import { Schema } from 'effect';
+import type { Environment } from '../../../../../vendor/cel-js/lib/index.js';
+export declare const type: "com.shwfed.form.field.richtext";
+export declare const compatibilityDate: "2026-07-18";
+export declare const metadata: {
+    readonly name: "富文本";
+    readonly icon: "fluent:text-edit-style-20-regular";
+    readonly description: "所见即所得的富文本输入，读写 HTML 字符串；行内样式与列表可逐项开关";
+    readonly w: {
+        readonly initial: 12;
+        readonly min: 6;
+        readonly max: number;
+    };
+    readonly h: {
+        readonly initial: 8;
+        readonly min: 4;
+        readonly max: number;
+        readonly grow: true;
+    };
+};
+/**
+ * What the toolbar may offer, split the way the editor actually works on it:
+ * `inline` decorates a text range, `block` restructures the document.
+ *
+ * Unchecking one withdraws the *means of authoring* it — the button is not
+ * rendered and the keyboard shortcut is unbound — but the mark or node stays
+ * registered on the schema. Dropping the extension outright would make
+ * ProseMirror discard the tag while parsing existing content, so merely
+ * opening a record authored before the box was unchecked would silently strip
+ * it and the next save would persist the loss.
+ *
+ * Alignment and indentation are in neither list: they are always-on toolbar
+ * furniture, not capabilities to negotiate.
+ */
+export declare const INLINE_FEATURES: readonly ["bold", "italic", "underline", "strike"];
+export declare const BLOCK_FEATURES: readonly ["bulletList", "orderedList"];
+export type InlineFeature = typeof INLINE_FEATURES[number];
+export type BlockFeature = typeof BLOCK_FEATURES[number];
+export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
+    label: Schema.optional<Schema.suspend<readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], string | readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], never>>;
+    placeholder: Schema.optional<Schema.suspend<readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], string | readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], never>>;
+    tooltip: Schema.optional<Schema.refine<readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], Schema.suspend<readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], string | readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], never>>>;
+    binding: Schema.optional<Schema.refine<string, typeof Schema.String>>;
+    inline: Schema.Array$<Schema.Literal<["bold", "italic", "underline", "strike"]>>;
+    block: Schema.Array$<Schema.Literal<["bulletList", "orderedList"]>>;
+    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>;
+    }>>;
+    id: Schema.refine<string, typeof Schema.String>;
+    displayName: Schema.optional<Schema.SchemaClass<string, string, never>>;
+    hidden: Schema.optional<Schema.Schema<string, string, never>>;
+    required: Schema.optional<Schema.Schema<string, string, never>>;
+    validations: Schema.optional<Schema.Array$<Schema.Struct<{
+        when: Schema.Schema<string, string, never>;
+        warning: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+        message: Schema.refine<readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], Schema.suspend<readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], string | readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], never>>;
+    }>>>;
+    type: Schema.Literal<["com.shwfed.form.field.richtext"]>;
+    compatibilityDate: Schema.Literal<["2026-07-18"]>;
+}>;
+export type Value = Schema.Schema.Type<ReturnType<typeof schema>>;
+/**
+ * Creation-time seed. Required because `inline` and `block` are required
+ * fields beyond identity — without this the picker would mint a bare
+ * `{ id, type, compatibilityDate }` that fails its own schema.
+ *
+ * Everything starts enabled: a new editor should be fully capable, and the
+ * author narrows it down rather than opting in one feature at a time.
+ */
+export declare function defaults(): Partial<Value>;

package/dist/runtime/components/form/fields/2026-07-18/com.shwfed.form.field.richtext/schema.js

@@ -0,0 +1,65 @@
+import { Schema } from "effect";
+import { LocaleMarkdown, Expression } from "../../../../../share/expression.js";
+import { Locale } from "../../../../../share/locale.js";
+import { commonFieldFields, derivedField } from "../../../utils/common.js";
+export const type = "com.shwfed.form.field.richtext";
+export const compatibilityDate = "2026-07-18";
+export const metadata = {
+  name: "\u5BCC\u6587\u672C",
+  icon: "fluent:text-edit-style-20-regular",
+  description: "\u6240\u89C1\u5373\u6240\u5F97\u7684\u5BCC\u6587\u672C\u8F93\u5165\uFF0C\u8BFB\u5199 HTML \u5B57\u7B26\u4E32\uFF1B\u884C\u5185\u6837\u5F0F\u4E0E\u5217\u8868\u53EF\u9010\u9879\u5F00\u5173",
+  w: { initial: 12, min: 6, max: Infinity },
+  h: { initial: 8, min: 4, max: Infinity, grow: true }
+};
+export const INLINE_FEATURES = ["bold", "italic", "underline", "strike"];
+export const BLOCK_FEATURES = ["bulletList", "orderedList"];
+export function schema(configure) {
+  const CelBool = Expression({ configure, resultType: "bool" });
+  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"
+    })),
+    placeholder: Schema.optional(Locale.annotations({
+      title: "\u5360\u4F4D\u7B26",
+      description: "\u6B63\u6587\u4E3A\u7A7A\u65F6\u5C55\u793A\u7684\u5360\u4F4D\u6587\u672C"
+    })),
+    tooltip: Schema.optional(LocaleMarkdown({ configure }).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 `article.body`\uFF1B\u5199\u5165\u7684\u503C\u662F HTML \u5B57\u7B26\u4E32\uFF0C\u6B63\u6587\u4E3A\u7A7A\u65F6\u5199\u5165 `null`\u3002\u7559\u7A7A\u5219\u4E3A\u975E\u53D7\u63A7\u5B57\u6BB5\uFF0C\u4E0D\u5199\u5165\u8868\u5355\u72B6\u6001"
+    })),
+    inline: Schema.Array(Schema.Literal(...INLINE_FEATURES)).annotations({
+      title: "\u884C\u5185\u6837\u5F0F",
+      description: "\u5DE5\u5177\u680F\u5F00\u653E\u7684\u884C\u5185\u6837\u5F0F\uFF1A\u52A0\u7C97\u3001\u659C\u4F53\u3001\u4E0B\u5212\u7EBF\u3001\u5220\u9664\u7EBF\u3002\u53D6\u6D88\u52FE\u9009\u53EA\u662F\u6536\u56DE\u300C\u5199\u300D\u7684\u5165\u53E3\u2014\u2014\u6309\u94AE\u4E0D\u518D\u6E32\u67D3\u3001\u5FEB\u6377\u952E\u4E00\u5E76\u89E3\u7ED1\u2014\u2014\u5B58\u91CF\u5185\u5BB9\u91CC\u5DF2\u6709\u7684\u6837\u5F0F\u4ECD\u7136\u7167\u5E38\u89E3\u6790\u4E0E\u4FDD\u5B58\uFF0C\u4E0D\u4F1A\u88AB\u6E05\u6D17\u6389"
+    }),
+    block: Schema.Array(Schema.Literal(...BLOCK_FEATURES)).annotations({
+      title: "\u5757\u7EA7\u529F\u80FD",
+      description: "\u5DE5\u5177\u680F\u5F00\u653E\u7684\u5757\u7EA7\u529F\u80FD\uFF1A\u65E0\u5E8F\u5217\u8868\u3001\u6709\u5E8F\u5217\u8868\u3002\u5DE6\u53F3\u5BF9\u9F50\u4E0E\u7F29\u8FDB\u662F\u5E38\u9A7B\u529F\u80FD\uFF0C\u4E0D\u5728\u6B64\u5217"
+    }),
+    disabled: Schema.optional(CelBool.annotations({
+      title: "\u7981\u7528\u6761\u4EF6",
+      description: "\u8FD4\u56DE `true` \u65F6\u7F16\u8F91\u5668\u4ECD\u7136\u6E32\u67D3\u4F46\u4E0D\u53EF\u7F16\u8F91\uFF0C\u5DE5\u5177\u680F\u4E00\u5E76\u7981\u7528"
+    })),
+    readonly: Schema.optional(CelBool.annotations({
+      title: "\u53EA\u8BFB\u6761\u4EF6",
+      description: "\u8FD4\u56DE `true` \u65F6\u9690\u85CF\u5DE5\u5177\u680F\uFF0C\u4EC5\u6E32\u67D3\u6B63\u6587 HTML"
+    })),
+    derived: derivedField(configure, "string")
+  }).annotations({
+    title: "RichTextField",
+    description: "\u5BCC\u6587\u672C\u8F93\u5165\uFF0C\u503C\u4E3A HTML \u5B57\u7B26\u4E32"
+  });
+}
+export function defaults() {
+  return {
+    inline: [...INLINE_FEATURES],
+    block: [...BLOCK_FEATURES]
+  };
+}

package/dist/runtime/components/operations/2026-06-11/com.shwfed.operation.http.request.json/runtime.js

@@ -2,6 +2,7 @@ import { Effect, Either, Option } from "effect";
 import { Fetch } from "fx-fetch";
 import { toast } from "vue-sonner";
 import { asRequest } from "../../../../share/request.js";
+import { IDEMPOTENCY_KEY_HEADER, mintIdempotencyKey } from "../../../../share/idempotency-key.js";
 import { getLocalizedText } from "../../../../share/locale.js";
 import { interpolateMarkdown } from "../../../../share/interpolate.js";
 class HttpRequestHalted {
@@ -11,24 +12,35 @@ class HttpRequestHalted {
   _tag = "HttpRequestHalted";
 }
 const TOAST_STYLES = /* @__PURE__ */ new Set(["success", "error", "warning", "info"]);
+const KEYLESS_METHODS = /* @__PURE__ */ new Set(["GET", "HEAD", "OPTIONS", "TRACE"]);
+function applyIdempotencyKey(request, key) {
+  const { method, headers } = request.describe();
+  if (KEYLESS_METHODS.has(method.toUpperCase())) return;
+  const target = IDEMPOTENCY_KEY_HEADER.toLowerCase();
+  if (headers.some(([name]) => name.toLowerCase() === target)) return;
+  request.header(IDEMPOTENCY_KEY_HEADER, key);
+}
 export const handler = (params, ctx) => {
   const { expression, resultExpression, titleExpression, description } = params ?? {};
   if (!expression || expression.trim().length === 0) return Effect.void;
   const program = Effect.gen(function* () {
     const steps = ctx.step?.outputs() ?? {};
-    const evaluated = yield* ctx.cel(expression, { steps });
+    const idempotencyKey = ctx.step?.idempotencyKey() ?? mintIdempotencyKey();
+    const scope = { steps, idempotencyKey };
+    const evaluated = yield* ctx.cel(expression, scope);
     const request = asRequest(evaluated);
     if (Option.isNone(request)) return;
+    applyIdempotencyKey(request.value, idempotencyKey);
     const outcome = yield* Effect.either(request.value.json());
     const json = Either.isRight(outcome) ? outcome.right : null;
     if (Either.isRight(outcome)) ctx.step?.publish(json);
-    const result = Either.isLeft(outcome) ? "error" : resultExpression === void 0 ? "success" : yield* ctx.cel(resultExpression, { json, steps });
+    const result = Either.isLeft(outcome) ? "error" : resultExpression === void 0 ? "success" : yield* ctx.cel(resultExpression, { ...scope, json });
     const kind = TOAST_STYLES.has(result) ? result : "success";
     if (titleExpression !== void 0) {
-      const title = yield* ctx.cel(titleExpression, { json, result, steps });
+      const title = yield* ctx.cel(titleExpression, { ...scope, json, result });
       if (title.length > 0) {
         const raw = getLocalizedText(description, ctx.locale()) ?? "";
-        const body = raw.length === 0 ? void 0 : interpolateMarkdown(raw, ctx.cel, { json, result, steps });
+        const body = raw.length === 0 ? void 0 : interpolateMarkdown(raw, ctx.cel, { ...scope, json, result });
         toast[kind](title, body === void 0 ? void 0 : { description: body });
       }
     }

package/dist/runtime/components/operations/2026-06-11/com.shwfed.operation.http.request.json/schema.js

@@ -1,7 +1,7 @@
 import { Schema } from "effect";
 import { Expression, LocaleMarkdown } from "../../../../share/expression.js";
 import { md } from "../../../../share/markdown.js";
-import { registerStepsVariableIfAbsent } from "../../utils/step-vars.js";
+import { registerIdempotencyKeyVariableIfAbsent, registerStepsVariableIfAbsent } from "../../utils/step-vars.js";
 export const type = "com.shwfed.operation.http.request.json";
 export const compatibilityDate = "2026-06-11";
 export const metadata = {
@@ -9,13 +9,14 @@ export const metadata = {
   icon: "fluent:cloud-arrow-up-20-regular",
   description: "\u53D1\u9001\u4E00\u4E2A HTTP \u8BF7\u6C42\uFF1B\u5176\u89E3\u6790\u540E\u7684\u54CD\u5E94\u4F53\u4F5C\u4E3A\u94FE\u6B65\u8F93\u51FA\uFF0C\u540E\u7EED\u6B65\u9AA4\u53EF\u7528 steps \u5F15\u7528",
   // This op publishes its parsed response as a chain-step output, so later
-  // trigger rows can reference it via `steps[?"<row-id>"]`.
+  // trigger rows can reference it via `steps["<row-id>"]`.
   output: "HTTP \u54CD\u5E94\uFF08\u89E3\u6790\u540E\u7684 JSON\uFF09"
 };
 export function schema(configure) {
   const withSteps = (env) => {
     configure(env);
     registerStepsVariableIfAbsent(env);
+    registerIdempotencyKeyVariableIfAbsent(env);
   };
   const CelHttpRequest = Expression({ configure: withSteps, resultType: "HttpRequest" });
   const withJson = (env) => {
@@ -70,10 +71,16 @@ export function schema(configure) {
     description: md`
       发起一次 HTTP 请求（响应解析为 JSON）。请求失败（网络错误 / 非 2xx / 响应不可解析）
       或「执行结果」为 \`error\` 时中止本次触发链。在触发列表中串联多个本操作即可按顺序
-      调用多个接口——前一个失败后，后续操作不再执行。后面的步骤可经 \`steps[?"<步骤标识>"]\`
+      调用多个接口——前一个失败后，后续操作不再执行。后面的步骤可经 \`steps["<步骤标识>"]\`
       引用前面步骤的响应。
 
       toast 完全由「提示标题」「提示内容」决定（含失败场景）；不配置标题、或标题求值为空字符串则静默。
+
+      写请求（\`POST\` / \`PUT\` / \`PATCH\` / \`DELETE\`）自动附带 \`Idempotency-Key\`
+      请求头——值是本步在本次运行中的幂等键，同一次运行内固定、重新触发则改变，
+      服务端可据此识别重发、避免重复落库。\`GET\` 不带（本就幂等，且会平白触发
+      跨域预检）。需要把它放进**请求体**的接口，用 \`idempotencyKey\` 变量自行拼进
+      「请求」表达式即可——与请求头取到的是同一个值。
     `
   });
 }

package/dist/runtime/components/operations/2026-06-15/com.shwfed.operation.http.download/schema.js

@@ -40,7 +40,7 @@ export function schema(configure) {
       title: "\u8BF7\u6C42",
       description: md`
         构造一个请求，其响应将被取回并保存为文件。
-        可经 \`steps[?"<步骤标识>"]\` 引用前序步骤的输出——把先前
+        可经 \`steps["<步骤标识>"]\` 引用前序步骤的输出——把先前
         \`发送请求\` 行取得的凭据用于构造真正的下载请求。
       `
     }),
@@ -76,7 +76,7 @@ export function schema(configure) {
       发起一次 HTTP 请求：若响应是二进制（非 JSON）则保存为本地文件；若响应是 JSON，
       则视为后端返回的状态信封，经「执行结果」裁定成败而**不**保存。下载失败（网络错误 / 非 2xx）
       或「执行结果」为 \`error\` 会中止本次触发链——其后排队的操作不再执行。把本操作接在一个
-      \`发送请求\` 行之后、并经 \`steps[?"<步骤标识>"]\` 引用其响应，即可实现
+      \`发送请求\` 行之后、并经 \`steps["<步骤标识>"]\` 引用其响应，即可实现
       “先取凭据再下载”的两步式。toast 完全由「提示标题」「提示内容」决定（含失败场景）；
       不配置标题、或标题求值为空字符串则静默。
     `

package/dist/runtime/components/operations/2026-06-15/com.shwfed.operation.navigation/schema.js

@@ -29,7 +29,7 @@ export function schema(configure) {
   }).annotations({
     title: "NavigationOperation",
     description: md`
-      按所选方式打开一个链接。链接表达式可经 \`steps[?"<步骤标识>"]\` 引用前序步骤的输出，
+      按所选方式打开一个链接。链接表达式可经 \`steps["<步骤标识>"]\` 引用前序步骤的输出，
       因此可由先前请求的响应拼接目标地址。导航失败不中止本次触发链。
     `
   });

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

@@ -35,7 +35,7 @@ export type OperationMetadata = Readonly<{
     description?: string;
     /**
      * Present iff this operation publishes a chain-step output (`ctx.step.publish`)
-     * for later trigger rows to read via `steps[?"<row-id>"]` — the value is the
+     * for later trigger rows to read via `steps["<row-id>"]` — the value is the
      * designer-facing label of what gets published (e.g. 'HTTP 响应'). The trigger
      * editor reads it to decide which rows to offer as step references, so a
      * non-publishing op never advertises a reference that resolves to nothing.

package/dist/runtime/components/operations/utils/step-vars.d.ts

@@ -6,12 +6,10 @@ import { type CELVar } from '../../../utils/cel-context.js';
  * an op schema may be embedded under a host whose `configure` already
  * advertises it, and double registration throws.
  *
- * `dyn` (not `map<string, dyn>`) so `steps[?"<id>"].data.code` type-checks the
+ * `dyn` (not `map<string, dyn>`) so `steps["<id>"].data.code` type-checks the
  * same way `form.foo.bar` does — what a step publishes is backend-defined and
  * unknowable at design time. Keyed by trigger-row uuid; the picker renders
- * each key as its「第 N 步」position, and writes the OPTIONAL lookup (`[?]`), so
- * a step that published nothing evaluates to `undefined` instead of throwing
- * `No such key`.
+ * each key as its「第 N 步」position.
  */
 export declare function registerStepsVariableIfAbsent(env: Environment): void;
 /**
@@ -22,3 +20,17 @@ export declare function registerStepsVariableIfAbsent(env: Environment): void;
  * context channel at all — the op handler passes it as an evaluation extra.
  */
 export declare function stepsCelVar(): CELVar;
+/**
+ * Register the `idempotencyKey` variable on `env`, skipping it when already
+ * declared — idempotent for the same reason as the `steps` variant.
+ *
+ * `string` (not `dyn`): unlike `steps`, the shape is ours and fully known, so
+ * a typo like `idempotencyKey.value` should fail the editor's inline check
+ * rather than defer to runtime.
+ */
+export declare function registerIdempotencyKeyVariableIfAbsent(env: Environment): void;
+/**
+ * The design-time CELVar cell for `idempotencyKey`. The value shown in the
+ * picker is a placeholder — the real key does not exist until the chain runs.
+ */
+export declare function idempotencyKeyCelVar(): CELVar;

package/dist/runtime/components/operations/utils/step-vars.js

@@ -1,4 +1,4 @@
-import { STEPS_VAR } from "../../../utils/cel-context.js";
+import { IDEMPOTENCY_KEY_VAR, STEPS_VAR } from "../../../utils/cel-context.js";
 const STEPS_VAR_META = {
   label: "\u524D\u5E8F\u6B65\u9AA4",
   description: "\u672C\u6B21\u89E6\u53D1\u94FE\u4E2D\u524D\u5E8F\u6B65\u9AA4\u53D1\u5E03\u7684\u8F93\u51FA\uFF08\u6309\u6B65\u9AA4\u6807\u8BC6\uFF09"
@@ -10,3 +10,16 @@ export function registerStepsVariableIfAbsent(env) {
 export function stepsCelVar() {
   return { type: "dyn", ...STEPS_VAR_META, value: void 0 };
 }
+const IDEMPOTENCY_KEY_VAR_META = {
+  label: "\u5E42\u7B49\u952E",
+  description: "\u672C\u6B65\u5728\u672C\u6B21\u8FD0\u884C\u4E2D\u7684\u5E42\u7B49\u952E\uFF08UUID\uFF09\uFF1B\u540C\u4E00\u6B21\u8FD0\u884C\u5185\u56FA\u5B9A\uFF0C\u91CD\u65B0\u89E6\u53D1\u5373\u6539\u53D8"
+};
+export function registerIdempotencyKeyVariableIfAbsent(env) {
+  const declared = new Set(env.getDefinitions().variables.map((v) => v.name));
+  if (!declared.has(IDEMPOTENCY_KEY_VAR)) {
+    env.registerVariable(IDEMPOTENCY_KEY_VAR, "string", IDEMPOTENCY_KEY_VAR_META);
+  }
+}
+export function idempotencyKeyCelVar() {
+  return { type: "string", ...IDEMPOTENCY_KEY_VAR_META, value: "" };
+}

package/dist/runtime/components/table/columns/2026-05-24/com.shwfed.table.column.combobox-single.remote.options-remote/config.d.vue.ts

@@ -53,9 +53,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly successMessage?: string | undefined;
         readonly accessor?: string | undefined;
         readonly sortKey?: string | undefined;
+        readonly successMessage?: string | undefined;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: {
@@ -108,9 +108,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
             readonly locale: "en" | "ja" | "ko";
             readonly message: string;
         }[]];
-        readonly successMessage?: string | undefined;
         readonly accessor?: string | undefined;
         readonly sortKey?: string | undefined;
+        readonly successMessage?: string | undefined;
     }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;