@shwfed/config 1.0.0

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

@@ -0,0 +1,498 @@
+<script setup>
+import { useNuxtApp } from "#app";
+import { Icon } from "@iconify/vue";
+import { Effect } from "effect";
+import { computed, inject, onBeforeUnmount, provide, ref, useTemplateRef, watch } from "vue";
+import { toast } from "vue-sonner";
+import {
+  celBindings,
+  injectCELContext
+} from "../../plugins/cel/context";
+import { findFreePlacement, normalizeLayoutSet } from "../../share/layout";
+import { getLocalizedText } from "../../share/locale";
+import BlockLayoutEditor from "../block-layout-editor/index.vue";
+import LayoutsSidebar from "../block-layout-editor/sidebar.vue";
+import LayoutMetaStrip from "../block-layout-editor/meta-strip.vue";
+import { BREADCRUMB_EXTENSION_KEY } from "../config/breadcrumb-extension";
+import { SIDEBAR_TAKEOVER_KEY } from "../sidebar-takeover";
+import { FORM_FIELD_LAYOUT_KEY } from "./field-layout";
+import { Button } from "../ui/button";
+import { ScrollArea } from "../ui/scroll-area";
+import { Separator } from "../ui/separator";
+import { FIELDS, findField } from "./utils/resolve";
+defineOptions({ name: "ShwfedFormUnitConfig" });
+const unit = defineModel({ type: Object, ...{ required: true } });
+const selection = defineModel("selection", { type: Object, ...{
+  default: () => ({ kind: "layout" })
+} });
+defineProps({
+  extras: { type: Array, required: false }
+});
+defineSlots();
+const activeLayoutIndex = ref(0);
+const stack = ref([{ kind: "top" }]);
+const top = computed(() => stack.value[stack.value.length - 1]);
+const isDrilled = computed(() => stack.value.length > 1);
+function popOne() {
+  if (stack.value.length <= 1) return;
+  stack.value = stack.value.slice(0, -1);
+}
+const breadcrumbExt = inject(BREADCRUMB_EXTENSION_KEY, null);
+const fullPane = ref(false);
+provide(FORM_FIELD_LAYOUT_KEY, { fullPane });
+const takeover = inject(SIDEBAR_TAKEOVER_KEY, null);
+const takeoverTarget = computed(() => takeover?.target.value ?? null);
+const activeFieldId = computed(() => {
+  const t = top.value;
+  if (t.kind === "field-drill") return t.id;
+  return selection.value.kind === "field" ? selection.value.id : null;
+});
+const activeField = computed(() => {
+  const id = activeFieldId.value;
+  if (!id) return null;
+  return unit.value.fields.find((f) => f.id === id) ?? null;
+});
+const activeFieldEntry = computed(() => {
+  const f = activeField.value;
+  return f ? findField(f.type, f.compatibilityDate) ?? null : null;
+});
+function selectExtra(id) {
+  selection.value = { kind: "extras", id };
+}
+function selectLayout() {
+  selection.value = { kind: "layout" };
+}
+function drillField(id) {
+  stack.value = [...stack.value, { kind: "field-drill", id }];
+}
+function switchDrillField(id) {
+  if (!stack.value.length) return;
+  if (id === activeFieldId.value) return;
+  if (top.value.kind !== "field-drill") return;
+  stack.value = [...stack.value.slice(0, -1), { kind: "field-drill", id }];
+}
+function fieldIcon(f) {
+  return findField(f.type, f.compatibilityDate)?.metadata?.icon ?? "fluent:square-20-regular";
+}
+const layoutsModel = computed({
+  get: () => [...unit.value.layouts],
+  set: (next) => {
+    unit.value = { ...unit.value, layouts: next };
+  }
+});
+const sidebarRef = useTemplateRef("sidebarRef");
+function addLayout() {
+  sidebarRef.value?.addLayout();
+}
+const FIELD_PICKER_ENTRIES = computed(() => {
+  const byType = /* @__PURE__ */ new Map();
+  for (const f of FIELDS) {
+    const prev = byType.get(f.type);
+    if (!prev || f.compatibilityDate > prev.compatibilityDate) {
+      byType.set(f.type, {
+        type: f.type,
+        compatibilityDate: f.compatibilityDate,
+        name: f.metadata.name,
+        icon: f.metadata.icon
+      });
+    }
+  }
+  return [...byType.values()].sort((a, b) => a.name.localeCompare(b.name, "zh"));
+});
+function makeId() {
+  if (typeof crypto !== "undefined" && "randomUUID" in crypto) return crypto.randomUUID();
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    return (c === "x" ? r : r & 3 | 8).toString(16);
+  });
+}
+function defaultField(entry) {
+  const fieldEntry = findField(entry.type, entry.compatibilityDate);
+  return {
+    ...fieldEntry?.defaults?.() ?? {},
+    id: makeId(),
+    type: entry.type,
+    compatibilityDate: entry.compatibilityDate
+  };
+}
+function addField(entry, options) {
+  const field = defaultField(entry);
+  const meta = findField(entry.type, entry.compatibilityDate)?.metadata;
+  const w = meta?.w.initial ?? 1;
+  const h = meta?.h.initial ?? 1;
+  const i = activeLayoutIndex.value;
+  const nextLayouts = unit.value.layouts.map((ls, idx) => {
+    if (idx !== i) return ls;
+    const placement = findFreePlacement(ls.layout.placements, w, h);
+    const placements = { ...ls.layout.placements, [field.id]: placement };
+    let cols = 0;
+    let rows = 0;
+    for (const p of Object.values(placements)) {
+      const [, [x2, y2]] = p.area;
+      if (x2 - 1 > cols) cols = x2 - 1;
+      if (y2 - 1 > rows) rows = y2 - 1;
+    }
+    return {
+      ...ls,
+      layout: {
+        ...ls.layout,
+        placements,
+        columns: Math.max(1, cols),
+        rows: Math.max(1, rows)
+      }
+    };
+  });
+  unit.value = {
+    ...unit.value,
+    fields: [...unit.value.fields, field],
+    layouts: nextLayouts
+  };
+  if (!options?.silent) {
+    selection.value = { kind: "field", id: field.id };
+  }
+}
+function removeField(id) {
+  removeFields([id]);
+}
+function removeFields(ids) {
+  if (ids.length === 0) return;
+  const drop = new Set(ids);
+  unit.value = {
+    ...unit.value,
+    fields: unit.value.fields.filter((f) => !drop.has(f.id)),
+    layouts: unit.value.layouts.map((ls) => {
+      const entries = Object.entries(ls.layout.placements).filter(([pid]) => !drop.has(pid));
+      if (entries.length === Object.keys(ls.layout.placements).length) return ls;
+      return normalizeLayoutSet({
+        ...ls,
+        layout: { ...ls.layout, placements: Object.fromEntries(entries) }
+      });
+    })
+  };
+  if (selection.value.kind === "field" && drop.has(selection.value.id)) {
+    selection.value = { kind: "layout" };
+  }
+  if (top.value.kind === "field-drill" && drop.has(top.value.id)) {
+    stack.value = stack.value.slice(0, -1);
+  }
+}
+function updateActiveField(next) {
+  const id = activeFieldId.value;
+  if (!id) return;
+  const i = unit.value.fields.findIndex((f) => f.id === id);
+  if (i < 0) return;
+  const fields = [...unit.value.fields];
+  fields[i] = next;
+  unit.value = { ...unit.value, fields };
+}
+const { $cel: rawCel } = useNuxtApp();
+const inheritedCEL = injectCELContext();
+function celForMigration(expression, context) {
+  return rawCel(expression, { ...celBindings(inheritedCEL), ...context });
+}
+const migrationContext = { $cel: celForMigration };
+const latestEntry = computed(() => {
+  const e = activeFieldEntry.value;
+  if (!e?.deprecated || !e.supersededBy) return null;
+  return findField(e.type, e.supersededBy) ?? null;
+});
+const canMigrate = computed(() => !!latestEntry.value?.migrate);
+async function migrateActiveField() {
+  const sel = activeField.value;
+  const target = latestEntry.value;
+  if (!sel || !target?.migrate) return;
+  try {
+    const next = await Effect.runPromise(target.migrate(sel, migrationContext));
+    updateActiveField(next);
+    toast.success(`\u5DF2\u8FC1\u79FB\u5230 ${target.compatibilityDate} \u7248\u672C`);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    toast.error("\u8FC1\u79FB\u5931\u8D25", { description: message });
+  }
+}
+function fieldLabel(f) {
+  const fa = f;
+  if (typeof fa.displayName === "string" && fa.displayName.length > 0) {
+    return fa.displayName;
+  }
+  const label = fa.label;
+  return getLocalizedText(label, "zh") ?? "\u672A\u547D\u540D\u5B57\u6BB5";
+}
+function getFieldLabel(field) {
+  return fieldLabel(field);
+}
+if (breadcrumbExt) {
+  const crumb = breadcrumbExt.add();
+  watch(
+    [isDrilled, activeField],
+    ([drilled, field]) => {
+      if (drilled && field) {
+        crumb.label.value = `\u7F16\u8F91${fieldLabel(field)}`;
+        crumb.back.value = popOne;
+      } else {
+        crumb.label.value = null;
+        crumb.back.value = null;
+      }
+    },
+    { immediate: true }
+  );
+  onBeforeUnmount(() => {
+    crumb.dispose();
+  });
+}
+function isExtraActive(id) {
+  return selection.value.kind === "extras" && selection.value.id === id;
+}
+</script>
+
+<template>
+  <!-- Sidebar takeover: when a host provides a takeover target, teleport our
+       left rail into it. This flattens nested sidebars when the form is
+       drilled into from the actions modal-layout button. -->
+  <Teleport
+    v-if="takeoverTarget && !fullPane"
+    :to="takeoverTarget"
+  >
+    <template v-if="!isDrilled">
+      <ScrollArea class="flex-1">
+        <template v-if="extras && extras.length > 0">
+          <div
+            v-for="extra in extras"
+            :key="extra.id"
+            class="row general-row pl-2"
+            :class="[
+  isExtraActive(extra.id) ? 'bg-[color-mix(in_srgb,var(--primary)_10%,white)] text-(--primary)' : 'text-zinc-600 hover:bg-zinc-50'
+]"
+            @click.stop="selectExtra(extra.id)"
+          >
+            <Icon
+              :icon="extra.icon"
+              class="size-4 shrink-0"
+            />
+            <span class="flex-1 truncate">{{ extra.label }}</span>
+          </div>
+
+          <Separator class="my-1" />
+        </template>
+
+        <LayoutsSidebar
+          ref="sidebarRef"
+          v-model="layoutsModel"
+          v-model:active-index="activeLayoutIndex"
+          :active="selection.kind === 'layout'"
+          @select="selectLayout()"
+        />
+      </ScrollArea>
+
+      <Button
+        variant="ghost"
+        size="sm"
+        @click="addLayout()"
+      >
+        <Icon
+          icon="fluent:add-20-regular"
+          class="size-4"
+        />
+        <span>新增布局</span>
+      </Button>
+    </template>
+    <template v-else>
+      <ScrollArea class="flex-1">
+        <div class="flex flex-col gap-0.5">
+          <button
+            v-for="f in unit.fields"
+            :key="f.id"
+            type="button"
+            class="row w-full pl-2 text-left"
+            :class="[
+  activeFieldId === f.id ? 'bg-[color-mix(in_srgb,var(--primary)_10%,white)] text-(--primary)' : 'text-zinc-600 hover:bg-zinc-50'
+]"
+            @click="switchDrillField(f.id)"
+          >
+            <Icon
+              :icon="fieldIcon(f)"
+              class="size-4 shrink-0"
+            />
+            <span class="flex-1 truncate">{{ getFieldLabel(f) }}</span>
+          </button>
+        </div>
+      </ScrollArea>
+    </template>
+  </Teleport>
+
+  <div class="flex gap-2 min-h-128">
+    <!-- Inline sidebar: top-level shows extras + layouts; drilled view swaps
+         to a field switcher so users can hop between fields without going
+         back. Suppressed when the host claims our rail via
+         SIDEBAR_TAKEOVER_KEY, or when a drilled field config claims the right
+         pane via FORM_FIELD_LAYOUT_KEY (fullPane). -->
+    <div
+      v-if="!fullPane && !takeoverTarget"
+      class="flex w-64 shrink-0 flex-col"
+    >
+      <template v-if="!isDrilled">
+        <ScrollArea class="flex-1">
+          <template v-if="extras && extras.length > 0">
+            <div
+              v-for="extra in extras"
+              :key="extra.id"
+              class="row general-row pl-2"
+              :class="[
+  isExtraActive(extra.id) ? 'bg-[color-mix(in_srgb,var(--primary)_10%,white)] text-(--primary)' : 'text-zinc-600 hover:bg-zinc-50'
+]"
+              @click.stop="selectExtra(extra.id)"
+            >
+              <Icon
+                :icon="extra.icon"
+                class="size-4 shrink-0"
+              />
+              <span class="flex-1 truncate">{{ extra.label }}</span>
+            </div>
+
+            <Separator class="my-1" />
+          </template>
+
+          <LayoutsSidebar
+            ref="sidebarRef"
+            v-model="layoutsModel"
+            v-model:active-index="activeLayoutIndex"
+            :active="selection.kind === 'layout'"
+            @select="selectLayout()"
+          />
+        </ScrollArea>
+
+        <Button
+          variant="ghost"
+          size="sm"
+          @click="addLayout()"
+        >
+          <Icon
+            icon="fluent:add-20-regular"
+            class="size-4"
+          />
+          <span>新增布局</span>
+        </Button>
+      </template>
+      <template v-else>
+        <ScrollArea class="flex-1">
+          <div class="flex flex-col gap-0.5">
+            <button
+              v-for="f in unit.fields"
+              :key="f.id"
+              type="button"
+              class="row w-full pl-2 text-left"
+              :class="[
+  activeFieldId === f.id ? 'bg-[color-mix(in_srgb,var(--primary)_10%,white)] text-(--primary)' : 'text-zinc-600 hover:bg-zinc-50'
+]"
+              @click="switchDrillField(f.id)"
+            >
+              <Icon
+                :icon="fieldIcon(f)"
+                class="size-4 shrink-0"
+              />
+              <span class="flex-1 truncate">{{ getFieldLabel(f) }}</span>
+            </button>
+          </div>
+        </ScrollArea>
+      </template>
+    </div>
+
+    <!-- Right pane -->
+    <div class="flex flex-1 flex-col">
+      <!-- Extras pane -->
+      <div
+        v-if="!isDrilled && selection.kind === 'extras'"
+      >
+        <slot
+          :id="selection.id"
+          name="extras-pane"
+        />
+      </div>
+
+      <!-- 布局 view -->
+      <div
+        v-else-if="!isDrilled && selection.kind === 'layout'"
+        class="flex flex-1 flex-col gap-2"
+      >
+        <LayoutMetaStrip
+          v-model="layoutsModel"
+          :index="activeLayoutIndex"
+        />
+        <div class="flex-1">
+          <BlockLayoutEditor
+            v-model="layoutsModel"
+            v-model:active-index="activeLayoutIndex"
+            :items="unit.fields"
+            :find-entry="findField"
+            :get-item-label="getFieldLabel"
+            :picker-entries="FIELD_PICKER_ENTRIES"
+            :can-delete="true"
+            item-noun="字段"
+            @add-new="addField"
+            @drill-down="drillField"
+            @delete-item="removeField"
+            @delete-items="removeFields"
+          />
+        </div>
+      </div>
+
+      <!-- 字段 view (drill) -->
+      <div
+        v-else-if="activeField"
+        :class="fullPane ? '' : 'p-6'"
+      >
+        <div
+          v-if="activeFieldEntry"
+        >
+          <div
+            v-if="activeFieldEntry.deprecated"
+            class="mb-4 flex items-center gap-2 rounded border border-amber-200 bg-amber-50 px-3 py-2 text-xs text-amber-800"
+            role="alert"
+          >
+            <Icon
+              icon="fluent:warning-20-regular"
+              class="size-4 shrink-0"
+            />
+            <span class="flex-1">
+              此字段类型已弃用，建议迁移至 <span class="tabular-nums font-medium">{{ activeFieldEntry.supersededBy }}</span> 版本。
+            </span>
+            <Button
+              v-if="canMigrate"
+              variant="ghost"
+              size="sm"
+              class="text-amber-800 hover:bg-amber-100 hover:text-amber-900"
+              data-slot="field-migrate"
+              @click="migrateActiveField"
+            >
+              <Icon icon="fluent:arrow-sync-20-regular" />
+              迁移
+            </Button>
+          </div>
+          <component
+            :is="activeFieldEntry.config"
+            :model-value="activeField"
+            @update:model-value="updateActiveField"
+          />
+        </div>
+        <div
+          v-else
+          class="text-sm text-red-500"
+        >
+          未注册的字段类型：{{ activeField.type }}@{{ activeField.compatibilityDate }}
+        </div>
+      </div>
+
+      <!-- Empty state -->
+      <div
+        v-else
+        class="flex min-h-112 items-center justify-center p-8 text-sm text-zinc-400"
+      >
+        选择左侧项目以查看和编辑
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.row{align-items:center;border-radius:.25rem;cursor:pointer;display:flex;font-size:.875rem;gap:.375rem;padding-block:.375rem;padding-right:.5rem;position:relative;transition:background-color .1s ease;-webkit-user-select:none;-moz-user-select:none;user-select:none}.general-row{font-weight:500}
+</style>

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

@@ -0,0 +1,63 @@
+import type { FieldValue, FormUnitValue } from './schema.js';
+export type UnitExtra = {
+    id: string;
+    label: string;
+    icon: string;
+};
+export type UnitSelection = {
+    kind: 'extras';
+    id: string;
+} | {
+    kind: 'layout';
+} | {
+    kind: 'field';
+    id: string;
+};
+type __VLS_Props = {
+    /**
+     * Sidebar rows rendered above the layouts list. Each entry has a matching
+     * `extras-pane` slot keyed by `id`. Selection lives in the `selection`
+     * v-model — hosts read which extra is active via `selection.value`.
+     */
+    extras?: ReadonlyArray<UnitExtra>;
+};
+type __VLS_Slots = {
+    /** Pane content for the currently-selected extra. Receives `{ id }`. */
+    'extras-pane'(props: {
+        id: string;
+    }): unknown;
+};
+type __VLS_ModelProps = {
+    modelValue: FormUnitValue;
+    'selection'?: UnitSelection;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: Readonly<{
+        fields: ReadonlyArray<FieldValue>;
+        layouts: readonly Readonly<{
+            name: string;
+            media?: string;
+            layout: import("./schema.js").LayoutValue;
+        }>[];
+    }>) => any;
+    "update:selection": (value: UnitSelection) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: Readonly<{
+        fields: ReadonlyArray<FieldValue>;
+        layouts: readonly Readonly<{
+            name: string;
+            media?: string;
+            layout: import("./schema.js").LayoutValue;
+        }>[];
+    }>) => any) | undefined;
+    "onUpdate:selection"?: ((value: UnitSelection) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/form/utils/common.d.ts

@@ -0,0 +1,15 @@
+import { Schema } from 'effect';
+import type { Environment } from '../../../vendor/cel-js/lib/index.js';
+export declare function commonFieldFields(configure: (env: Environment) => void): {
+    id: Schema.refine<string, typeof Schema.String>;
+    displayName: Schema.optional<Schema.SchemaClass<string, string, never>>;
+    hidden: Schema.optional<Schema.Schema<string, string, never>>;
+};
+export declare const FIELD_ORIENTATIONS: readonly ["vertical", "floating"];
+export type FieldOrientation = typeof FIELD_ORIENTATIONS[number];
+export declare const FIELD_ORIENTATION_OPTIONS: ReadonlyArray<{
+    value: FieldOrientation;
+    label: string;
+}>;
+export declare const FieldOrientationSchema: Schema.Literal<["vertical", "floating"]>;
+export declare const DEFAULT_FIELD_ORIENTATION: FieldOrientation;

package/dist/runtime/components/form/utils/common.js

@@ -0,0 +1,26 @@
+import { Schema } from "effect";
+import { Expression } from "../../../share/expression.js";
+export function commonFieldFields(configure) {
+  const CelBool = Expression({ configure, resultType: "bool" });
+  return {
+    id: Schema.UUID.annotations({ description: "\u5B57\u6BB5\u552F\u4E00\u6807\u8BC6\uFF1B\u5E03\u5C40\u901A\u8FC7\u8BE5 id \u5F15\u7528\u5B57\u6BB5" }),
+    displayName: Schema.optional(Schema.String.annotations({
+      title: "\u5185\u90E8\u540D\u79F0",
+      description: "\u4EC5\u5728\u7F16\u8F91\u5668\u5185\u53EF\u89C1\u7684\u5B57\u6BB5\u540D\uFF0C\u7528\u4E8E\u5728\u4FA7\u8FB9\u680F\u548C\u5E03\u5C40\u7F16\u8F91\u5668\u4E2D\u8BC6\u522B\u5B57\u6BB5\uFF1B\u8FD0\u884C\u65F6\u4E0D\u5C55\u793A"
+    })),
+    hidden: Schema.optional(CelBool.annotations({
+      title: "\u9690\u85CF\u6761\u4EF6",
+      description: "\u8FD4\u56DE `true` \u65F6\u5B57\u6BB5\u5728\u6240\u6709\u5E03\u5C40\u4E2D\u90FD\u4E0D\u6E32\u67D3"
+    }))
+  };
+}
+export const FIELD_ORIENTATIONS = ["vertical", "floating"];
+export const FIELD_ORIENTATION_OPTIONS = [
+  { value: "vertical", label: "\u5782\u76F4\uFF08\u6807\u7B7E\u5728\u4E0A\uFF09" },
+  { value: "floating", label: "\u6D6E\u52A8\uFF08\u6807\u7B7E\u5D4C\u5165\u8F93\u5165\u6846\uFF09" }
+];
+export const FieldOrientationSchema = Schema.Literal(...FIELD_ORIENTATIONS).annotations({
+  title: "\u65B9\u5411",
+  description: "\u6807\u7B7E\u4E0E\u8F93\u5165\u6846\u7684\u6392\u5217\u65B9\u5411"
+});
+export const DEFAULT_FIELD_ORIENTATION = "vertical";

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

@@ -0,0 +1,77 @@
+import type { Component } from 'vue';
+import type { Effect, Schema } from 'effect';
+import type { Environment } from '../../../vendor/cel-js/lib/index.js';
+type AnySchema = Schema.Schema<any, any, never>;
+type SchemaFactory = (configure: (env: Environment) => void) => AnySchema;
+/**
+ * Capabilities a migration function may need from the host. Currently exposes
+ * the Nuxt-provided CEL evaluator so legacy fields with embedded CEL
+ * expressions can be evaluated during the rewrite. New capabilities are
+ * additive — extend this type rather than introducing a parallel context.
+ */
+export type MigrationContext = Readonly<{
+    $cel: <T>(expression: string, context?: Record<string, unknown>) => Effect.Effect<T, unknown>;
+}>;
+/**
+ * Migrates a value of the previous compatibilityDate's schema to this entry's
+ * schema. Lives on the *target* (newer) entry. The Effect's success channel
+ * is the migrated value; failures surface to the host as a toast — see
+ * src/runtime/components/form/config.vue's migrate handler.
+ */
+export type MigrateFn = (prev: unknown, ctx: MigrationContext) => Effect.Effect<unknown, Error>;
+export type FieldSizeRange = Readonly<{
+    /** Span (in step units) used when the field is first placed. */
+    initial: number;
+    /** Lower bound (inclusive) the user may shrink the field to. */
+    min: number;
+    /** Upper bound (inclusive) the user may grow the field to. */
+    max: number;
+    /**
+     * When true, this axis escapes the grid's `1fr` equal-share and follows
+     * content instead. Currently honored only on `h` by the form runtime: any
+     * row track containing at least one visible field whose `h.grow` is true is
+     * rendered as `auto`, while other rows keep `minmax(auto, 1fr)`.
+     */
+    grow?: boolean;
+}>;
+export type FieldMetadata = Readonly<{
+    name: string;
+    icon: string;
+    w: FieldSizeRange;
+    h: FieldSizeRange;
+}>;
+/**
+ * Optional creation-time defaults factory. Returns a partial config that
+ * merges into the seed when the user adds a new field, so newly-added fields
+ * arrive with sensible values populated. Schemas remain pure validators —
+ * defaults live here. Mirrors `getColumnDefaults` in table/config.vue.
+ */
+export type FieldDefaults = () => Record<string, any>;
+export type FieldEntry = Readonly<{
+    type: string;
+    compatibilityDate: string;
+    metadata: FieldMetadata;
+    schema: SchemaFactory;
+    config: Component;
+    runtime: Component;
+    /** True iff a newer entry with the same `type` exists in the registry. */
+    deprecated: boolean;
+    /** `compatibilityDate` of the newest entry sharing this `type`, when deprecated. */
+    supersededBy?: string;
+    /**
+     * Optional migration from the previous compatibilityDate's schema to this
+     * entry's schema. When present, the host renders a "迁移" button on
+     * deprecated fields whose superseding entry exposes this function.
+     */
+    migrate?: MigrateFn;
+    /**
+     * Optional creation-time defaults. The host merges the returned partial
+     * onto the seed when the user adds a new field via the picker. Absent →
+     * the field is created with only `{ id, type, compatibilityDate }`.
+     */
+    defaults?: FieldDefaults;
+}>;
+export declare const FIELDS: ReadonlyArray<FieldEntry>;
+export declare function allFieldSchemas(configure: (env: Environment) => void): ReadonlyArray<AnySchema>;
+export declare function findField(type: string, compatibilityDate: string): FieldEntry | undefined;
+export {};