@jzg223/design-runtime 0.0.0-stage → 0.0.1

package/dist/types/form/design-form.vue.d.ts

@@ -0,0 +1,96 @@
+import type { DesignTableTool as TableTool, PlatformFormConfig } from '../types';
+type __VLS_Props = {
+    /** 模块分类 */
+    category?: string;
+    /** 配置名称 */
+    name?: string;
+    /** 直接传入配置（可选，跳过 API 请求） */
+    config?: PlatformFormConfig | null;
+    /** 表单初始数据（直接传入，优先级低于 sourceId） */
+    source?: Record<string, any>;
+    /** 编辑模式下的记录 ID（传入后会调用 showUrl 拉取数据） */
+    sourceId?: string | number;
+    /** 额外参数（外部上下文注入，保存时合并进 info 一并提交） */
+    /** 上游组件推过来的参数；与路由参数合并为组件自身 extraParams（随保存作为 params 下发后端） */
+    parentParams?: Record<string, any>;
+    /** 表单标题 */
+    taskTitle?: string;
+    /**
+     * 显示模式（保留兼容入参，不再影响按钮显示）
+     * 自 2026-09 起表单按钮一律按配置的「工具条(toolBars)」渲染，
+     * 不再自动生成底部 保存/删除/重置；standalone 与 embedded 显示已无差别。
+     */
+    mode?: 'embedded' | 'standalone';
+    /** dev 悬浮按钮距容器顶部距离(px)；嵌套在其它设计组件内时下移，避免与父组件按钮重叠 */
+    devButtonTop?: number;
+};
+/**
+ * 供父组件调用的提交入口（不依赖按钮：取当前表单值后走统一保存逻辑）
+ * 从 inner form 获取当前表单值后执行保存
+ */
+declare function submit(): Promise<any>;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    getFormApi: () => {
+        getValues: () => Record<string, any>;
+        setValues: (values: Record<string, any>) => void;
+        resetForm: () => void;
+        form: {
+            values: Record<string, any>;
+        };
+        derivedValues: Record<string, any>;
+    } | undefined;
+    /** 程序化提交入口：取当前表单值并走统一保存逻辑（供父组件/宿主调用） */
+    submit: typeof submit;
+    /** 保存进行中状态（供宿主读取，如同步到 drawer confirmLoading） */
+    saving: import("vue").Ref<boolean, boolean>;
+    /** 表单配置的宽度（供抽屉组件读取） */
+    formConfigWidth: import("vue").ComputedRef<string | number | undefined>;
+    /** 表单配置的标题（供抽屉组件读取） */
+    formConfigTitle: import("vue").ComputedRef<string | undefined>;
+    /** 开发面板状态（本库不渲染调试台，留给宿主调试台按需读取） */
+    devState: import("vue").ComputedRef<Record<string, any>>;
+    toolScope: import("vue").ComputedRef<Record<string, any>>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    deleted: () => any;
+    saved: (result: any) => any;
+    "data-change": (data: Record<string, any>) => any;
+    "url-change": (urls: {
+        delete: string;
+        insert: string;
+        show: string;
+        update: string;
+    }) => any;
+    "config-loaded": (config: {
+        title?: string;
+        width?: number | string;
+    }) => any;
+    "update:title": (title: string) => any;
+    "tool-command": (tool: TableTool) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onDeleted?: (() => any) | undefined;
+    onSaved?: ((result: any) => any) | undefined;
+    "onData-change"?: ((data: Record<string, any>) => any) | undefined;
+    "onUrl-change"?: ((urls: {
+        delete: string;
+        insert: string;
+        show: string;
+        update: string;
+    }) => any) | undefined;
+    "onConfig-loaded"?: ((config: {
+        title?: string;
+        width?: number | string;
+    }) => any) | undefined;
+    "onUpdate:title"?: ((title: string) => any) | undefined;
+    "onTool-command"?: ((tool: TableTool) => any) | undefined;
+}>, {
+    name: string;
+    config: PlatformFormConfig | null;
+    source: Record<string, any>;
+    mode: "embedded" | "standalone";
+    category: string;
+    sourceId: string | number;
+    parentParams: Record<string, any>;
+    taskTitle: string;
+    devButtonTop: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/checkbox-field.vue.d.ts

@@ -0,0 +1,14 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+    "update:derived": (values: Record<string, any>) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+    "onUpdate:derived"?: ((values: Record<string, any>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/custom-field.vue.d.ts

@@ -0,0 +1,22 @@
+import type { PlatformFormCell } from '../../types';
+/**
+ * 自定义字段 — 默认回退组件
+ * 外部可通过 `fieldRegistry.register('myType', MyComponent)` 注册自定义类型
+ *
+ * ⚠️ `cell` 声明为可选（默认 {}）：它同时被「插槽兜底」复用（扩展包组件没注册、
+ * 菜单页面插槽解析不到组件等），那些场景调用方可能没有 cell 配置；
+ * 必填会让回退组件自己先崩在 `cell.type` 上（2026-10-21 实测：页面插槽白屏）。
+ */
+type __VLS_Props = {
+    cell?: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {
+    cell: PlatformFormCell;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/date-field.vue.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/embedded-list-field.vue.d.ts

@@ -0,0 +1,26 @@
+import type { DesignTableTool as TableTool, PlatformFormCell, RowAction } from '../../types';
+type __VLS_Props = {
+    /** 内嵌列表单元格配置（embeddedList + mappings + title） */
+    cell: PlatformFormCell;
+    /** 主表单字段当前值（含派生值，随输入实时变化） */
+    master?: Record<string, any>;
+    /** 主键字段名（用于判断主记录是否存在：无 id → 仅标题行） */
+    pfield?: string;
+    /** 表单外部参数（路由/上游 parentParams），作为映射 params 作用域 */
+    extraParams?: Record<string, any>;
+    /** 表单所在模块（列表未存 module 时的兜底） */
+    category?: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "tool-command": (tool: TableTool) => any;
+    "row-command": (action: RowAction, row: Record<string, any>) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onTool-command"?: ((tool: TableTool) => any) | undefined;
+    "onRow-command"?: ((action: RowAction, row: Record<string, any>) => any) | undefined;
+}>, {
+    category: string;
+    pfield: string;
+    extraParams: Record<string, any>;
+    master: Record<string, any>;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/file-field.vue.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/image-field.vue.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/index.d.ts

@@ -0,0 +1,34 @@
+import type { Component } from 'vue';
+import CustomField from './custom-field.vue';
+import TextField from './text-field.vue';
+/** 尚未迁入的字段类型（命中即回退占位 + warn，见 resolveComponent） */
+export declare const pendingFieldTypes: string[];
+/** 宿主侧统一请求：走注入的 http（返回值已按平台口径解包） */
+export { hostRequest } from '../../components/design-shared/host-api';
+/**
+ * 注册自定义字段组件（与 `registerComponents` 等价，保留宿主侧的旧名字）
+ * @param type 字段 type 名（同时可作为 `cell.comname` 使用）
+ */
+export declare function register(type: string, comp: Component): void;
+/** 批量注册自定义类型 */
+export declare function registerFields(map: Record<string, Component>): void;
+/**
+ * 查找字段组件：自定义注册表 > 内置 > CustomField 回退
+ */
+export declare function resolveComponent(type?: string): Component;
+/**
+ * 按**单元格**解析组件（运行端统一入口）
+ *
+ * - `type === 'my'`（构建端的「自定义」）：按 `cell.comname` 查注册表；
+ *   没填 comname / 名字没注册 → warn 一次并回退 CustomField（占位输入框，不炸表单）。
+ * - 其它类型：走 {@link resolveComponent}。
+ */
+export declare function resolveCellComponent(cell?: {
+    comname?: string;
+    type?: string;
+}): Component;
+/** 已注册的自定义组件名（含内置字段类型），用于「先判断有没有」的插槽 */
+export declare function listCustomComponents(): string[];
+/** 某个 comname / 字段类型是否真的可用 */
+export declare function hasCustomComponent(comname?: string): boolean;
+export { CustomField, TextField };

package/dist/types/form/fields/month-field.vue.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/org-select-field.vue.d.ts

@@ -0,0 +1,14 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+    "update:derived": (values: Record<string, any>) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+    "onUpdate:derived"?: ((values: Record<string, any>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/orgs-select-field.vue.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/radio-field.vue.d.ts

@@ -0,0 +1,14 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+    "update:derived": (values: Record<string, any>) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+    "onUpdate:derived"?: ((values: Record<string, any>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/select-field.vue.d.ts

@@ -0,0 +1,14 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+    "update:derived": (values: Record<string, any>) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+    "onUpdate:derived"?: ((values: Record<string, any>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/splitline-field.vue.d.ts

@@ -0,0 +1,7 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+};
+declare const _default: 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>;
+export default _default;

package/dist/types/form/fields/switch-field.vue.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/text-field.vue.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/time-field.vue.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/fields/tree-field.vue.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformFormCell } from '../../types';
+type __VLS_Props = {
+    cell: PlatformFormCell;
+    disabled?: boolean;
+    modelValue?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/form/number-precision.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 数字（小数）输入的小数位数 `cell.decimalLen` 的解析与取整（纯函数，便于单测）。
+ *
+ * 语义（与设计器 cell/text.vue 的「小数位数」一致）：
+ *   `0`      → 整数
+ *   留空/非法 → 不限位数（保持历史行为）
+ *   `N`      → 最多 N 位小数，超出四舍五入
+ */
+/** 解析小数位数：''/纯空格/null/undefined/负数/非整数/非数字 → undefined（不限位数） */
+export declare function parsePrecision(raw: unknown): number | undefined;
+/**
+ * 按精度四舍五入；未配置精度（undefined）或非有限数时原样返回。
+ * 加 EPSILON 是为了抵消二进制浮点误差（如 1.005 直接 toFixed 会得 1.00）。
+ */
+export declare function roundToPrecision(num: number, precision?: number): number;

package/dist/types/form/transformer.d.ts

@@ -0,0 +1,27 @@
+import type { DesignFormSchema } from '../search/transformer';
+import type { PlatformDerivedField, PlatformFormCell, PlatformFormConfig } from '../types';
+/** 网格布局配置（供 DesignFormInner 渲染 CSS Grid） */
+export interface FormGridConfig {
+    cells: PlatformFormCell[];
+    colWidths: number[];
+    rowHeights: number[];
+    totalCol: number;
+    totalRow: number;
+    derivedFieldList: PlatformDerivedField[];
+}
+/**
+ * 将平台表单配置转换为 DesignFormSchema 数组 + 网格布局信息
+ *
+ * 支持两种格式：
+ * 1. 新格式：config.cells 直接包含 { cells, totalRow, totalCol, colWidths, rowHeights }
+ * 2. 旧格式：config.content 为 JSON 字符串，解析后得到 cells
+ */
+export declare function transformFormConfig(config: PlatformFormConfig): {
+    gridConfig: FormGridConfig;
+    schema: DesignFormSchema[];
+    labelWidth: number;
+    insertUrl: string | undefined;
+    updateUrl: string | undefined;
+    deleteUrl: string | undefined;
+    showUrl: string | undefined;
+};

package/dist/types/host.d.ts

@@ -0,0 +1,182 @@
+/**
+ * 宿主能力契约（T2 的核心设计）
+ *
+ * 本库要能装进**任意**基于 vben 的项目，就不能 import 宿主内部的东西
+ * （`#/utils/http`、`#/adapter/vxe-table`、app 的 pinia store…）。
+ * 做法：宿主在 bootstrap 里调一次 `installDesignPlatform(ctx)`，把公共能力注入进来；
+ * 库内一律通过 `getDesignHost()` 取。
+ *
+ * ## 判断「一个能力该 peer 还是该注入」的三级优先（2026-10-27 定）
+ *
+ *  1. **真 npm 包 → 直接 peer + external**：`vue`、`vue-router`、`antdv-next`、`@antdv-next/icons`、
+ *     `vxe-table`。理由：外部使用方 `npm i` 得到的就是构建好的产物与 `.d.ts`。
+ *  2. **宿主私有 / 业务数据 → 注入**：`http`（宿主那一个请求实例）、`dict`（宿主的字典数据）、
+ *     `workflow`（业务后端的流程接口）、`message` / `modal` / `t` / `getAuth`。
+ *     理由：库里既没有数据源也不能自建一份，否则会出现第二套口径。
+ *  3. **vben 基座包（`@vben/*`）→ 注入，不能 peer**：`Page` / `useVbenModal` / `useVbenDrawer` /
+ *     `useVbenVxeGrid`。理由：`@vben/plugins`、`@vben/common-ui` 的 `exports` 直接指向 `./src/*.ts`
+ *     （源码导出，vben monorepo 内部用），发到 npm 的库若声明成 peer，外部使用方装不到可用产物，
+ *     而且 .d.ts 里引用它会让类型解析直接失败。
+ *
+ * 结论：**`@vben/*` 出现在本库任何 import 里都是 bug**（`npm run verify` 的白名单也会盯住）。
+ *
+ * 约定：除 `http` 外全部可选。缺哪个，用到它的功能降级（不是崩溃），并在控制台给**一次**明确提示。
+ * 只有**单例**才有资格注入（登录态 / i18n / 路由 / http 客户端 / antd 的 message、modal）。
+ */
+import type { Component } from 'vue';
+import type { DesignHttp } from './http';
+/** 消息提示（宿主一般是 antd 的 message 实例） */
+export interface DesignHostMessage {
+    error: (msg: string) => void;
+    info?: (msg: string) => void;
+    /**
+     * 持续提示，返回关闭函数（导出/导入这类长任务用）。
+     * 未注入时回退 antdv-next 的 message.loading({ duration: 0 })。
+     */
+    loading?: (content: string) => () => void;
+    success: (msg: string) => void;
+    warning: (msg: string) => void;
+}
+/** 模态框（宿主一般是 antd 的 modal 实例） */
+export interface DesignHostModal {
+    confirm: (options: Record<string, any>) => void;
+    /** 纯提示框（`other` 工具的 `openDialog` 在没有 onOk 时用它）；未注入时降级为 message */
+    info?: (options: Record<string, any>) => void;
+}
+/** 登录态只读快照：库绝不自己去读 localStorage / token */
+export interface DesignAuthSnapshot {
+    /** 是否已登录（宿主从自己的 store 读） */
+    loggedIn: boolean;
+    /** 低代码页面常见的按钮级权限码 */
+    permissions?: string[];
+}
+/**
+ * UI 外壳能力（vben 基座包，源码导出 ⇒ 只能注入，见文件头第 3 条）
+ *
+ * 这些都是 `[组件, api]` 形态的组合函数：库内组件用 `<component :is="Shell">` 渲染拿到的组件，
+ * 靠 `api.open() / api.close() / api.setState()` 控制，与 vben 里用法一致。
+ */
+export interface DesignHostUi {
+    /** vben 的 `Page` 页容器（标题/描述/面包屑）；未注入时用普通容器兜底 */
+    Page?: Component;
+    /** vben 的 `useVbenDrawer`（表单抽屉） */
+    useVbenDrawer?: (...args: any[]) => any;
+    /** vben 的 `useVbenModal`（弹窗） */
+    useVbenModal?: (...args: any[]) => any;
+    /**
+     * vben 的 `useVbenVxeGrid`（**必须是宿主 adapter 里那个包装过的版本**：
+     * 它在模块顶层调过 `setupVbenVxeTable`，表格的边框/工具栏/分页/代理响应口径都在那里配好）。
+     * 表格与树形视图都要它；未注入时这两个组件不可用（取数仍是好的）。
+     */
+    useVbenVxeGrid?: (...args: any[]) => any;
+}
+/** 字典能力（业务数据，必须在宿主） */
+export interface DesignHostDict {
+    /** 字典项：宿主 `#/utils/render` 的 `getDictOptions` */
+    getOptions?: (dictName: string) => any[];
+    /** 值 → 标签：宿主 `#/utils/render` 的 `renderDict`（缺了字典列降级显示原值 + warn 一次） */
+    render?: (value: any, dictName: string, options?: Record<string, any>) => any;
+}
+/** 业务后端能力（流程等），按需注入；缺了对应功能不显示，不报错 */
+export interface DesignHostWorkflow {
+    /**
+     * 流程「提交/发起」弹窗组件（**宿主 app 私有**：vben 里的 `#/views/workflow/components`
+     * 的 `applyModal`）。表单「提交并走流程」时用它提交申请人节点。
+     *
+     * 未注入时：提交按钮降级为**只保存不发起流程**，并 warn 一次 ——
+     * 因为发起流程要宿主 app 的流程定义/表单上下文，库里没有也无法自建。
+     */
+    applyModal?: Component;
+    /** 撤回/取消流程申请：宿主 `#/api/workflow/instance` 的 `cancelProcessApply` */
+    cancelProcessApply?: (data: any) => Promise<any>;
+}
+/** 上传结果（宿主各家口径不同，库只依赖 `url`） */
+export interface DesignUploadResult {
+    /** 可访问地址（表单值存的就是它） */
+    url: string;
+    /** 原始文件名（可选） */
+    name?: string;
+    /** 其它字段（如 ossId）原样透传给宿主自己的组件 */
+    [key: string]: any;
+}
+export interface DesignUploadOptions {
+    /** 上传进度（0~100） */
+    onProgress?: (percent: number) => void;
+}
+/**
+ * 文件上传能力（**宿主实现**）。
+ *
+ * 为什么不像 `http` 那样直接给接口路径：上传地址与返回口径是**平台相关**的
+ * （vben/ruoyi 是 `POST /resource/oss/upload` → `{url, fileName, ossId}`，别的项目各不相同）。
+ * 库只要求「给个 File，还我一个 url」，接口细节全部留在宿主。
+ *
+ * 未注入时：`file` / `image` 字段显示「上传不可用」提示并 warn 一次。
+ */
+export type DesignHostUpload = (file: File, options?: DesignUploadOptions) => Promise<DesignUploadResult>;
+export interface DesignHost {
+    /**
+     * 网络层。**必须**注入宿主自己的请求实例适配（见 http.ts 顶部说明），
+     * 否则库内取数没有登录态，且宿主的 401 处理不生效。
+     */
+    http?: DesignHttp;
+    /** 文件上传（file / image 字段用），见 DesignHostUpload */
+    upload?: DesignHostUpload;
+    /** 国际化：传 key 返回文案；未注入时用内置中文兜底 */
+    t?: (key: string) => string;
+    message?: DesignHostMessage;
+    modal?: DesignHostModal;
+    /** 登录态快照（函数形式，保证每次取到最新值） */
+    getAuth?: () => DesignAuthSnapshot;
+    /** UI 外壳（Page / 抽屉 / 弹窗 / vxe-grid），见 DesignHostUi */
+    ui?: DesignHostUi;
+    /** 字典渲染（业务数据在宿主） */
+    dict?: DesignHostDict;
+    /** 业务后端能力（流程等） */
+    workflow?: DesignHostWorkflow;
+    /**
+     * 严格版本自检：为 true 时，若宿主的 vue / antdv-next 不在支持区间，**启动即抛错**。
+     * 默认 false（只 console.error），避免一个版本提示把整个应用打挂；
+     * CI / 预发环境建议打开。
+     */
+    strictCompat?: boolean;
+}
+/**
+ * 安装 / 更新宿主能力。宿主在 bootstrap 里调一次；
+ * 允许重复调用（后到的覆盖同名项，便于热更 / 多应用共存）。
+ *
+ * `ui` / `dict` / `workflow` 三个分组是**按键合并**的：
+ * `installDesignPlatform({ ui: { Page } })` 之后再
+ * `installDesignPlatform({ ui: { useVbenVxeGrid } })`，两个能力都在。
+ *
+ * 首次调用会顺带跑一次依赖版本自检（见 compat.ts），不匹配时明确报出来。
+ */
+export declare function installDesignPlatform(next: DesignHost): DesignHost;
+/** 读取宿主能力（库内部使用） */
+export declare function getDesignHost(): DesignHost;
+/** 取文案：宿主注入了 `t` 就用宿主语言，否则内置中文兜底 */
+export declare function hostT(key: string, fallback: string): string;
+/** 仅测试用：清空注入 */
+export declare function resetDesignHost(): void;
+/** UI 外壳能力（可能为空对象，用前自己判字段） */
+export declare function getHostUi(): DesignHostUi;
+/** 字典能力（可能为空对象；`render` 缺失时字典列降级为原值） */
+export declare function getHostDict(): DesignHostDict;
+/** 业务后端能力（可能为空对象；缺字段的功能直接不显示） */
+export declare function getHostWorkflow(): DesignHostWorkflow;
+/**
+ * 取 http：没注入就直接报错（这是**唯一**必须注入的能力，静默降级只会让问题更难查）
+ */
+export declare function requireHttp(): DesignHttp;
+/**
+ * 取 vxe-grid 组合函数：没注入就报错（表格/树形视图没有它渲染不出网格）。
+ *
+ * 为什么不像 `getHostDict()` 那样返回空对象：网格是这类组件的**主体**，
+ * 静默降级成"空白页"比直接抛错更难查。
+ */
+export declare function requireVxeGrid(): NonNullable<DesignHostUi['useVbenVxeGrid']>;
+/**
+ * 取抽屉/弹窗组合函数：返回 undefined 时调用方必须降级（不打开面板、只提示）。
+ * 不抛错的原因：这两个是**外壳**，缺了仍可用别的形式展示（例如抽屉退化成弹窗），
+ * 属于可选能力。
+ */
+export declare function getHostPopup(kind: 'drawer' | 'modal'): ((...args: any[]) => any) | undefined;