@shwfed/config 2.1.0 → 2.1.2

package/dist/module.json

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

package/dist/runtime/components/form/ai/fields-button.d.vue.ts

@@ -0,0 +1,13 @@
+import type { Environment } from '../../../vendor/cel-js/lib/index.js';
+type AnyRecord = Record<string, any>;
+type __VLS_Props = {
+    configure?: (env: Environment) => void;
+    fields?: ReadonlyArray<AnyRecord>;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    apply: (value: AnyRecord[]) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onApply?: ((value: AnyRecord[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/form/ai/fields-button.vue

@@ -0,0 +1,458 @@
+<script setup>
+import { Icon } from "@iconify/vue";
+import { Either, ParseResult, Schema } from "effect";
+import { computed, ref } from "vue";
+import { toast } from "vue-sonner";
+import ShwfedModal from "../../modal.vue";
+import { Button } from "../../ui/button";
+import { Markdown } from "../../ui/markdown";
+import { Textarea } from "../../ui/textarea";
+import { composeCelPrompt } from "../../../utils/ai/cel-prompt";
+import { StructuredOutputDecodeError, ai as $ai } from "../../../utils/ai";
+import { registerFormVariablesIfAbsent } from "../schema";
+import { listStructFields } from "../utils/schema-meta";
+import { buildFormCelScope } from "../utils/cel-scope";
+import { FIELDS, findField } from "../utils/resolve";
+import TASK from "./fields-task.md?raw";
+defineOptions({ name: "ShwfedFormAiFieldsButton" });
+const props = defineProps({
+  configure: { type: Function, required: false },
+  fields: { type: Array, required: false }
+});
+const emit = defineEmits(["apply"]);
+const SUPPORTED_TYPES = /* @__PURE__ */ new Set([
+  "com.shwfed.form.field.text",
+  "com.shwfed.form.field.textarea",
+  "com.shwfed.form.field.number",
+  "com.shwfed.form.field.numberrange",
+  "com.shwfed.form.field.date",
+  "com.shwfed.form.field.daterange",
+  "com.shwfed.form.field.datetime",
+  "com.shwfed.form.field.datetimerange",
+  "com.shwfed.form.field.time",
+  "com.shwfed.form.field.timerange",
+  "com.shwfed.form.field.switch",
+  "com.shwfed.form.field.combobox.single",
+  "com.shwfed.form.field.checkbox.group",
+  "com.shwfed.form.field.radio.group",
+  "com.shwfed.form.field.upload"
+]);
+const NOOP_CONFIGURE = () => {
+};
+const LocaleEntry = Schema.Struct({
+  locale: Schema.String,
+  message: Schema.String
+}).annotations({ identifier: "LocaleEntry" });
+const LocaleArray = Schema.Array(LocaleEntry);
+const ItemDraft = Schema.Struct({
+  id: Schema.optional(Schema.String),
+  label: Schema.optional(LocaleArray),
+  value: Schema.optional(Schema.Struct({
+    kind: Schema.String,
+    value: Schema.Union(Schema.String, Schema.Number)
+  })),
+  tooltip: Schema.optional(LocaleArray)
+});
+const PresetDraft = Schema.Struct({
+  id: Schema.optional(Schema.String),
+  label: Schema.optional(LocaleArray),
+  value: Schema.optional(Schema.String),
+  start: Schema.optional(Schema.String),
+  end: Schema.optional(Schema.String)
+});
+const FieldDraft = Schema.Struct({
+  id: Schema.optional(Schema.String).annotations({
+    description: "Stable field id. Call the `gen_uuid` tool to obtain it \u2014 never invent UUIDs."
+  }),
+  type: Schema.String.annotations({
+    description: 'Field type \u2014 must match a `type` listed under "Available field types".'
+  }),
+  compatibilityDate: Schema.String.annotations({
+    description: "Compatibility date for the field type \u2014 copy verbatim from its heading."
+  }),
+  displayName: Schema.optional(Schema.String),
+  hidden: Schema.optional(Schema.String),
+  label: Schema.optional(LocaleArray),
+  placeholder: Schema.optional(LocaleArray),
+  startPlaceholder: Schema.optional(LocaleArray),
+  endPlaceholder: Schema.optional(LocaleArray),
+  tooltip: Schema.optional(LocaleArray),
+  description: Schema.optional(LocaleArray),
+  trueLabel: Schema.optional(LocaleArray),
+  falseLabel: Schema.optional(LocaleArray),
+  templateLabel: Schema.optional(LocaleArray),
+  orientation: Schema.optional(Schema.String),
+  binding: Schema.optional(Schema.String),
+  disabled: Schema.optional(Schema.String),
+  readonly: Schema.optional(Schema.String),
+  derived: Schema.optional(Schema.Struct({
+    mode: Schema.optional(Schema.String),
+    expression: Schema.optional(Schema.String)
+  })),
+  precision: Schema.optional(Schema.Number),
+  roundingMode: Schema.optional(Schema.String),
+  step: Schema.optional(Schema.Number),
+  min: Schema.optional(Schema.String),
+  max: Schema.optional(Schema.String),
+  rows: Schema.optional(Schema.Number),
+  format: Schema.optional(Schema.String),
+  valueFormat: Schema.optional(Schema.String),
+  presets: Schema.optional(Schema.Array(PresetDraft)),
+  rangeSeparatorIcon: Schema.optional(Schema.String),
+  numberOfMonths: Schema.optional(Schema.Number),
+  items: Schema.optional(Schema.Array(ItemDraft)),
+  multiple: Schema.optional(Schema.Boolean),
+  accept: Schema.optional(Schema.Array(Schema.String)),
+  maxFileSize: Schema.optional(Schema.Number),
+  maxTotalSize: Schema.optional(Schema.Number),
+  maxFiles: Schema.optional(Schema.Number),
+  template: Schema.optional(Schema.String),
+  templateIcon: Schema.optional(Schema.String)
+});
+const FieldsDraft = Schema.Struct({
+  fields: Schema.Array(FieldDraft).annotations({
+    description: "The NEW fields to append to the form. Emit only the fields the user asked to add \u2014 never echo existing fields."
+  })
+});
+function effectiveConfigure(env) {
+  registerFormVariablesIfAbsent(env);
+  props.configure?.(env);
+}
+function renderRegisterables() {
+  const byType = /* @__PURE__ */ new Map();
+  for (const f of FIELDS) {
+    if (!SUPPORTED_TYPES.has(f.type)) continue;
+    const prev = byType.get(f.type);
+    if (!prev || f.compatibilityDate > prev.compatibilityDate) byType.set(f.type, f);
+  }
+  const entries = [...byType.values()].sort((a, b) => a.type.localeCompare(b.type));
+  const lines = ["# Available field types", ""];
+  for (const entry of entries) {
+    lines.push(`## \`${entry.type}\` (compatibilityDate \`${entry.compatibilityDate}\`)`);
+    lines.push("");
+    lines.push(`Renders: ${entry.metadata.name}.`);
+    lines.push("");
+    for (const info of listStructFields(entry.schema(NOOP_CONFIGURE))) {
+      if (info.name === "type" || info.name === "compatibilityDate") continue;
+      const req = info.optional ? "" : " (required)";
+      const title = info.title ? ` \u2014 ${info.title}` : "";
+      const desc = info.description ? `: ${info.description}` : "";
+      lines.push(`- \`${info.name}\`${req}${title}${desc}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+const open = ref(false);
+const context = ref("");
+const submitting = ref(false);
+const tick = ref(0);
+const description = [
+  "\u63CF\u8FF0\u4F60\u60F3**\u65B0\u589E\u7684\u5B57\u6BB5**\uFF08\u7C7B\u578B\u3001\u6807\u7B7E\u3001\u7ED1\u5B9A\u8DEF\u5F84\u7B49\uFF09\uFF0C\u53EF\u9644\u5B57\u6BB5\u542B\u4E49\u6216 PRD\u3002",
+  "",
+  "AI \u53EA\u4F1A**\u65B0\u589E**\u5B57\u6BB5\uFF0C\u4E0D\u4F1A\u6539\u52A8\u5DF2\u6709\u5B57\u6BB5\u3002\u751F\u6210\u7684\u5B57\u6BB5\u9ED8\u8BA4**\u672A\u653E\u7F6E**\uFF0C\u9700\u5728\u5E03\u5C40\u7F16\u8F91\u5668\u7684\u300C\u672A\u653E\u7F6E\u300D\u4E2D\u624B\u52A8\u62D6\u5165\u3002"
+].join("\n");
+const canSubmit = computed(() => !submitting.value && context.value.trim().length > 0);
+function onTrigger() {
+  open.value = true;
+}
+function collectErrors(fields) {
+  const out = [];
+  fields.forEach((field, i) => {
+    const prefix = `fields[${i}]`;
+    const type = field.type;
+    if (typeof type !== "string" || !SUPPORTED_TYPES.has(type)) {
+      out.push({
+        path: `${prefix}.type`,
+        message: `Field type "${type}" is not allowed. Use one of the types listed under "Available field types".`
+      });
+      return;
+    }
+    const entry = findField(type, field.compatibilityDate);
+    if (!entry) {
+      out.push({
+        path: `${prefix}.type`,
+        message: `Unknown field type "${type}@${field.compatibilityDate}". Copy the compatibilityDate verbatim from the type's heading.`
+      });
+      return;
+    }
+    if (entry.deprecated) {
+      out.push({
+        path: `${prefix}.compatibilityDate`,
+        message: `compatibilityDate "${field.compatibilityDate}" for "${type}" is deprecated. Use "${entry.supersededBy}" instead.`
+      });
+      return;
+    }
+    const decoded = Schema.decodeUnknownEither(entry.schema(effectiveConfigure))(field);
+    if (Either.isLeft(decoded)) {
+      const issues = ParseResult.ArrayFormatter.formatErrorSync(decoded.left);
+      for (const issue of issues) {
+        const sub = issue.path.map(String).join(".");
+        out.push({ path: sub ? `${prefix}.${sub}` : prefix, message: issue.message });
+      }
+    }
+  });
+  return out;
+}
+function buildRetryFeedback(errors) {
+  const lines = errors.map(({ path, message }) => `- \`${path}\`: ${message}`);
+  return [
+    "The previous output failed validation. Fix only the listed paths and return the corrected object \u2014 keep the other fields identical.",
+    "",
+    "Reminders:",
+    '- Only emit fields whose `type` is in the "Available field types" list \u2014 never actions / table / list / markdown / remote-dropdown fields.',
+    "- Copy each type's `compatibilityDate` verbatim from its heading; never use a deprecated date.",
+    "- The `fields` array is APPENDED \u2014 emit only the new fields, never echo existing ones.",
+    "",
+    "Errors:",
+    ...lines
+  ].join("\n");
+}
+function buildShapeFeedback(message) {
+  return [
+    "The previous output did not match the required JSON shape. Re-emit the structured output matching the schema exactly. The output must be a JSON object with a required `fields` array. Each field needs at minimum `type` and `compatibilityDate`.",
+    "",
+    "Decoder error:",
+    message
+  ].join("\n");
+}
+function tryUnwrap(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
+  const entries = Object.entries(raw);
+  if (entries.length !== 1) return null;
+  const [, inner] = entries[0];
+  let candidate = inner;
+  if (typeof candidate === "string") {
+    try {
+      candidate = JSON.parse(candidate);
+    } catch {
+      return null;
+    }
+  }
+  if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) return null;
+  if (!("fields" in candidate)) return null;
+  return candidate;
+}
+const genUuidTool = {
+  name: "gen_uuid",
+  description: "Generate a fresh RFC 4122 UUID string. Call this whenever you need an `id` \u2014 for a field, an option inside `items`, or an entry inside `presets`. Returns the UUID directly as a plain string; use it verbatim. Never invent UUIDs yourself.",
+  inputJsonSchema: { type: "object", properties: {}, additionalProperties: false },
+  execute: () => crypto.randomUUID()
+};
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function sanitizeField(draft) {
+  const cleaned = {};
+  for (const [k, v] of Object.entries(draft)) {
+    if (v === void 0) continue;
+    if (typeof v === "string" && v.trim() === "") continue;
+    cleaned[k] = v;
+  }
+  const incomingId = typeof cleaned.id === "string" ? cleaned.id : void 0;
+  const id = incomingId && UUID_RE.test(incomingId) ? incomingId : crypto.randomUUID();
+  const entry = findField(draft.type, draft.compatibilityDate);
+  return { ...entry?.defaults?.() ?? {}, ...cleaned, id };
+}
+function evaluate(value) {
+  const fields = value.fields.map(sanitizeField);
+  const errors = collectErrors(fields);
+  if (errors.length > 0) {
+    return { kind: "retry", previousOutput: value, feedback: buildRetryFeedback(errors) };
+  }
+  return { kind: "ok", fields };
+}
+async function callModel(prompt, system, retry) {
+  try {
+    const value = await $ai.generateObject({
+      prompt,
+      system,
+      schema: FieldsDraft,
+      objectName: "fields",
+      tools: [genUuidTool],
+      ...retry ? { retry } : {},
+      onProgress: () => {
+        tick.value++;
+      }
+    });
+    return evaluate(value);
+  } catch (err) {
+    if (err instanceof StructuredOutputDecodeError) {
+      const unwrapped = tryUnwrap(err.rawOutput);
+      if (unwrapped !== null) {
+        const decoded = Schema.decodeUnknownEither(FieldsDraft)(unwrapped);
+        if (Either.isRight(decoded)) return evaluate(decoded.right);
+      }
+      return { kind: "retry", previousOutput: err.rawOutput, feedback: buildShapeFeedback(err.message) };
+    }
+    throw err;
+  }
+}
+function buildUserPrompt() {
+  return [
+    context.value.trim(),
+    "",
+    "# Current configuration",
+    "",
+    "```json",
+    JSON.stringify({ fields: props.fields ?? [] }, null, 2),
+    "```"
+  ].join("\n");
+}
+function salvage(previousOutput) {
+  const candidate = previousOutput && typeof previousOutput === "object" ? previousOutput : null;
+  const usable = candidate && "fields" in candidate ? candidate : tryUnwrap(previousOutput);
+  if (!usable) return [];
+  const decoded = Schema.decodeUnknownEither(FieldsDraft)(usable);
+  if (Either.isLeft(decoded)) return [];
+  return decoded.right.fields.map(sanitizeField).filter((f) => {
+    const entry = findField(f.type, f.compatibilityDate);
+    return SUPPORTED_TYPES.has(f.type) && !!entry && !entry.deprecated;
+  });
+}
+async function onSubmit() {
+  if (!canSubmit.value) return;
+  submitting.value = true;
+  tick.value = 0;
+  try {
+    const baseSystem = composeCelPrompt({
+      scope: [
+        {
+          name: "\u5B57\u6BB5\u5185 CEL \u8868\u8FBE\u5F0F\uFF08\u9690\u85CF\u6761\u4EF6\u3001\u7981\u7528\u6761\u4EF6\u3001\u53EA\u8BFB\u6761\u4EF6\u3001\u6D3E\u751F\u503C\u3001\u6700\u503C\u7B49\uFF09\u53EF\u7528\u53D8\u91CF",
+          context: buildFormCelScope(props.configure ?? NOOP_CONFIGURE)
+        }
+      ],
+      task: TASK
+    });
+    const system = `${baseSystem}
+
+${renderRegisterables()}`;
+    const prompt = buildUserPrompt();
+    let outcome = await callModel(prompt, system);
+    if (outcome.kind === "retry") {
+      tick.value = 0;
+      outcome = await callModel(prompt, system, {
+        previousOutput: outcome.previousOutput,
+        feedback: outcome.feedback
+      });
+    }
+    if (outcome.kind === "ok") {
+      if (outcome.fields.length > 0) {
+        emit("apply", outcome.fields);
+        toast.success("\u5DF2\u6839\u636E\u63CF\u8FF0\u751F\u6210\u5B57\u6BB5");
+      } else {
+        toast.message("AI \u672A\u8FD4\u56DE\u4EFB\u4F55\u53EF\u65B0\u589E\u7684\u5B57\u6BB5");
+      }
+      open.value = false;
+      context.value = "";
+      return;
+    }
+    const salvaged = salvage(outcome.previousOutput);
+    if (salvaged.length > 0) {
+      emit("apply", salvaged);
+      toast.message("AI \u8F93\u51FA\u672A\u5B8C\u5168\u901A\u8FC7\u6821\u9A8C\uFF0C\u5DF2\u5E94\u7528\u5176\u4E2D\u53EF\u7528\u7684\u5B57\u6BB5\uFF0C\u8BF7\u68C0\u67E5");
+      open.value = false;
+      context.value = "";
+      return;
+    }
+    toast.error("AI \u751F\u6210\u5931\u8D25", { description: "\u6A21\u578B\u672A\u8FD4\u56DE\u53EF\u5E94\u7528\u7684\u5B57\u6BB5\uFF0C\u8BF7\u8C03\u6574\u63CF\u8FF0\u540E\u91CD\u8BD5" });
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    toast.error("AI \u751F\u6210\u5931\u8D25", { description: message });
+  } finally {
+    submitting.value = false;
+  }
+}
+</script>
+
+<template>
+  <Button
+    variant="ghost"
+    size="sm"
+    :disabled="submitting"
+    @click="onTrigger"
+  >
+    <Icon
+      icon="fluent:magic-wand-20-regular"
+      class="size-4"
+    />
+    <span>AI 生成字段</span>
+  </Button>
+
+  <ShwfedModal
+    v-model:open="open"
+    content-width="48rem"
+    :dismissible="!submitting"
+  >
+    <template #title>
+      <span class="flex items-center gap-2">
+        <Icon
+          icon="fluent:magic-wand-20-regular"
+          class="size-5"
+        />
+        AI 生成字段
+      </span>
+    </template>
+    <template #description>
+      <Markdown
+        :source="description"
+        block
+        class="prose prose-sm prose-zinc max-w-none"
+      />
+    </template>
+
+    <form
+      class="flex flex-col gap-2 py-2"
+      @submit.prevent="onSubmit"
+    >
+      <Textarea
+        v-model="context"
+        placeholder="任意上下文，建议包含：&#10;- 想要的字段：例如「姓名文本框、年龄数值、是否在职开关」&#10;- 字段含义、绑定路径或示例数据&#10;- 校验 / 默认值 / 只读等额外要求"
+        wrap="soft"
+        class="field-sizing-fixed h-72 max-h-[60vh] resize-none overflow-auto break-all whitespace-pre-wrap font-mono text-xs"
+        :disabled="submitting"
+      />
+    </form>
+
+    <template #footer>
+      <div class="flex items-center gap-2">
+        <div
+          v-if="submitting"
+          class="mr-auto flex items-center gap-2 text-xs text-muted-foreground"
+          aria-live="polite"
+        >
+          <span
+            :key="tick"
+            class="ai-progress-dot"
+            :class="tick > 0 ? 'is-streaming' : 'is-waiting'"
+          />
+          <span>{{ tick > 0 ? "\u6B63\u5728\u63A5\u6536\u6A21\u578B\u8F93\u51FA\u2026" : "\u6B63\u5728\u8BF7\u6C42\u6A21\u578B\u2026" }}</span>
+        </div>
+        <Button
+          type="button"
+          size="sm"
+          :disabled="submitting"
+          @click="open = false"
+        >
+          <Icon icon="fluent:dismiss-20-regular" />
+          取消
+        </Button>
+        <Button
+          type="button"
+          variant="primary"
+          size="sm"
+          :disabled="!canSubmit"
+          @click="onSubmit"
+        >
+          <Icon
+            :icon="submitting ? 'fluent:arrow-sync-20-regular' : 'fluent:sparkle-20-regular'"
+            :class="submitting ? 'animate-spin' : ''"
+          />
+          生成
+        </Button>
+      </div>
+    </template>
+  </ShwfedModal>
+</template>
+
+<style scoped>
+.ai-progress-dot{background-color:var(--primary,currentColor);border-radius:9999px;display:inline-block;height:.5rem;width:.5rem}.ai-progress-dot.is-waiting{animation:ai-progress-waiting 1.2s ease-in-out infinite}.ai-progress-dot.is-streaming{animation:ai-progress-kick .32s ease-out}@keyframes ai-progress-waiting{0%,to{opacity:.35;transform:scale(1)}50%{opacity:1;transform:scale(1.15)}}@keyframes ai-progress-kick{0%{opacity:1;transform:scale(1.6)}to{opacity:.7;transform:scale(1)}}
+</style>

package/dist/runtime/components/form/ai/fields-button.vue.d.ts

@@ -0,0 +1,13 @@
+import type { Environment } from '../../../vendor/cel-js/lib/index.js';
+type AnyRecord = Record<string, any>;
+type __VLS_Props = {
+    configure?: (env: Environment) => void;
+    fields?: ReadonlyArray<AnyRecord>;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    apply: (value: AnyRecord[]) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onApply?: ((value: AnyRecord[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/form/ai/fields-task.md

@@ -0,0 +1,71 @@
+Generate **new form fields** from the user's free-form description. The output is a single struct with one required field: `fields` — an array of field objects.
+
+The `fields` array is **APPENDED** to the form — it is **not** a replacement. The host adds whatever you emit to the existing fields and leaves every existing field untouched. So:
+
+- Emit **only** the fields the user is asking to add. Do **not** echo existing fields back.
+- The generated fields are left **unplaced** — they do not appear on any layout. The user drags them onto a layout themselves afterwards. Do not worry about layout / placement.
+
+# Hard rules
+
+1. **Allowlist only.** Every field's `type` + `compatibilityDate` pair **must** come from the "Available field types" list in this prompt. Never emit a `type` outside that list — in particular never emit an actions field, a nested table field, a list/repeater field, a markdown field, or a remote (server-driven) dropdown. If the user asks for one of those, pick the closest allowed field or omit it.
+2. **Use the latest `compatibilityDate`.** For each `type`, copy the `compatibilityDate` shown in its heading verbatim. Never emit an older/deprecated date.
+3. **Leave CEL fields empty unless explicitly asked.** Fields whose value is a CEL expression — `hidden`, `disabled`, `readonly`, `derived`, the number `min` / `max`, the upload `template`, date `presets` values — should be **omitted** unless the user explicitly describes that behavior (e.g. "在状态为已提交时只读", "默认填入当前用户"). Do not invent conditions.
+4. **Always call `gen_uuid` for every `id`.** Each field needs a stable `id`; every option inside `items` and every entry inside `presets` also needs its own `id`. Call the `gen_uuid` tool once per id you need — never invent UUIDs yourself.
+5. **Bare optional CEL access.** When you do write a CEL expression, reference form state with bare optional access — `form.?status`, `form.?user.?role`. Never wrap in coercions (`string(...)`, `int(...)`) and never add `.orValue(...)` defaults.
+
+# Field fields
+
+Each field object needs at minimum:
+
+- `id`: a fresh UUID from the `gen_uuid` tool.
+- `type`: one of the allowlisted types.
+- `compatibilityDate`: copied verbatim from that type's heading.
+- Type-specific fields — see "Available field types" below; each lists its own fields with titles and descriptions.
+
+Common optional fields most input types support:
+
+- `displayName`: a short editor-only name for the field, shown in the field list. Plain string, not localized. Prefer setting this so the user can tell the generated fields apart.
+- `label`: the localized label rendered before the input (locale array — see below).
+- `placeholder`: localized placeholder text.
+- `tooltip`: localized help text shown on label hover.
+- `binding`: a `dot-prop` path string the field writes into form state, e.g. `user.name`, `order.amount`. Always a **single** string path (range fields accept a single path too). Derive sensible paths from the user's prose; omit if the user gives no hint.
+- `orientation`: `'vertical'` (label above, default) or `'floating'` (label inside the input).
+
+# Value shapes
+
+**Localized strings** (`label`, `placeholder`, `tooltip`, …) are arrays of `{ "locale": ..., "message": ... }`. The `zh` entry **must be the first element**. Other locales are limited to `en` / `ja` / `ko`. Usually emit just the `zh` entry:
+
+```json
+"label": [{ "locale": "zh", "message": "姓名" }]
+```
+
+**`items`** (for `combobox.single`, `checkbox.group`, `radio.group`) — always populate this when you emit one of those types. Each item is:
+
+```json
+{ "id": "<gen_uuid>", "label": [{ "locale": "zh", "message": "启用" }], "value": { "kind": "text", "value": "enabled" } }
+```
+
+`value.kind` is `"text"` (with a string `value`) or `"number"` (with a numeric `value`). An optional `tooltip` (locale array) may be added.
+
+**`derived`** — only when the user explicitly asks for a computed / auto-filled value:
+
+```json
+"derived": { "mode": "formula", "expression": "form.?price * form.?qty" }
+```
+
+`mode` is `"formula"` (read-only, always the expression's result) or `"prefill"` (editable, expression fills until the user edits).
+
+**`presets`** (date / daterange fields) — each entry is `{ id, label, value }` for single-date fields or `{ id, label, start, end }` for range fields, where `value` / `start` / `end` are CEL expressions returning a `Date` (e.g. `now`, `now.offset(-7, "days")`). Only emit when the user asks for quick-pick presets.
+
+# CEL scope
+
+CEL expressions in form fields run with `form` (the current form state, `dyn`), `now` (current `Date`), and any host-registered variables — see "Variables In Scope" above.
+
+# Current configuration
+
+The form's existing fields are appended to the user prompt under `Current configuration` as `{ "fields": [...] }`. Use it only to:
+
+- keep naming / `binding` paths consistent with what already exists, and
+- avoid emitting a field that duplicates an existing one's `binding`.
+
+Do **not** copy those existing fields into your output — they stay in the form regardless. Your `fields` array is purely the **new** fields to add.

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

@@ -1,4 +1,4 @@
-import { Environment } from '../../vendor/cel-js/lib/index.js';
+import type { Environment } from '../../vendor/cel-js/lib/index.js';
 import { type FormConfigValue } from './schema.js';
 type __VLS_Props = {
     configure?: (env: Environment) => void;

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

@@ -1,9 +1,6 @@
 <script setup>
 import { computed, ref } from "vue";
-import { Environment } from "../../vendor/cel-js/lib/index";
-import {
-  provideCELContext
-} from "../../utils/cel-context";
+import { provideCELContext } from "../../utils/cel-context";
 import { ExpressionEditor } from "../ui/expression-editor";
 import { Field, FieldLabel } from "../ui/field";
 import { Markdown } from "../ui/markdown";
@@ -13,6 +10,7 @@ import {
   getStructFieldTitle
 } from "./schema";
 import ShwfedFormUnitConfig, {} from "./unit-config.vue";
+import { buildFormCelScope } from "./utils/cel-scope";
 defineOptions({ name: "ShwfedFormConfig" });
 const config = defineModel({ type: Object, ...{ required: true } });
 const props = defineProps({
@@ -23,38 +21,7 @@ const configure = props.configure ?? (() => {
 const formConfigSchema = FormConfig(configure);
 const generalFieldTitle = (f) => getStructFieldTitle(formConfigSchema, f) ?? f;
 const generalFieldDescription = (f) => getStructFieldDescription(formConfigSchema, f);
-const advertisedContext = (() => {
-  const probe = new Environment({ unlistedVariablesAreDyn: false });
-  const baseline = new Set(probe.getDefinitions().variables.map((v) => v.name));
-  configure(probe);
-  const out = {
-    form: {
-      type: "dyn",
-      label: "\u8868\u5355\u503C",
-      description: "\u5F53\u524D\u8868\u5355\u72B6\u6001",
-      value: void 0
-    },
-    // Mirrors the runtime `now` binding in `form/index.vue`. Editor never
-    // evaluates so we leave `value` undefined.
-    now: {
-      type: "Date",
-      label: "now",
-      description: "\u5F53\u524D\u65E5\u671F/\u65F6\u95F4",
-      value: void 0
-    }
-  };
-  for (const v of probe.getDefinitions().variables) {
-    if (baseline.has(v.name)) continue;
-    out[v.name] = {
-      type: v.type,
-      label: v.label ?? v.name,
-      description: v.description ?? void 0,
-      value: void 0
-    };
-  }
-  return out;
-})();
-provideCELContext(advertisedContext);
+provideCELContext(buildFormCelScope(configure));
 const unitModel = computed({
   get: () => ({ fields: config.value.fields, layouts: config.value.layouts }),
   set: (next) => {
@@ -90,6 +57,7 @@ function updateReadonly(value) {
     v-model="unitModel"
     v-model:selection="selection"
     :extras="EXTRAS"
+    :configure="configure"
   >
     <template #extras-pane>
       <div class="flex flex-col gap-4">

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

@@ -1,4 +1,4 @@
-import { Environment } from '../../vendor/cel-js/lib/index.js';
+import type { Environment } from '../../vendor/cel-js/lib/index.js';
 import { type FormConfigValue } from './schema.js';
 type __VLS_Props = {
     configure?: (env: Environment) => void;