@otlab/form-generator 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,29 @@
+MIT License
+
+Copyright (c) 2026 OTLOG
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+## Third-party notices
+
+本包的问卷表单引擎源自 tduck-platform（https://gitee.com/TDuckApp/tduck-platform），
+该项目以 MIT 协议发布。其原始版权声明与许可条款同样适用于本包中源自该项目的部分。
+上游代码已按 otlab 后端契约做过适配改造，且不再跟随上游同步。

package/README.md

@@ -1,3 +1,161 @@
-# Temporary Holding Version
+# @otlab/form-generator
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+otlab 问卷表单引擎：表单设计器 + 渲染层。从 `ot-admin` 前端仓库抽出的独立包。
+
+- **渲染层**（`@otlab/form-generator`）：`GenerateForm` / `GenerateFormContainer` / `BizProjectForm`，27 种题型、逻辑规则、分页、主题、选项名额、上传场景。
+- **设计器**（`@otlab/form-generator/designer`）：`FormDesign` / `InlineEditor`，含拖拽画布、右面板配置、富文本。
+
+两个入口分开是为了避免把 tinymce（富文本）与 vuedraggable（拖拽）打进只做填写/预览的消费方产物——SFC 带副作用，单桶无法树摇。
+
+## 安装（npmjs）
+
+已发布到 npmjs 公共 registry，直接安装，**无需配置 registry 或 token**：
+
+```bash
+pnpm add @otlab/form-generator
+```
+
+```json
+{ "dependencies": { "@otlab/form-generator": "^0.1.0" } }
+```
+
+用设计器时把可选依赖一并装上（渲染层不需要）：
+
+```bash
+pnpm add tinymce tinymce-i18n vuedraggable
+```
+
+### 本地联调（改包时用）
+
+改包要即时生效时，临时把依赖换成链接（**提交前还原成版本号**，否则 CI 装不上）：
+
+```json
+{ "dependencies": { "@otlab/form-generator": "link:../form-generator" } }
+```
+
+`link:` 直接指向本仓库目录，改完只需 `pnpm build` 产出 `dist`，无需重新发布。
+
+## 消费方必须提供
+
+peerDependencies（**不要**让包自带副本，否则 antd 双实例、主题令牌失效）：
+
+| 包 | 说明 |
+|---|---|
+| `vue` | ^3.4 |
+| `ant-design-vue` | ^4.2，且需在应用内**全局注册**组件（包内模板使用 `<a-xxx>`） |
+| `@ant-design/icons-vue` | ^7 |
+| `dayjs` / `lodash` | 工具依赖 |
+| `vuedraggable` | 仅设计器需要（optional peer） |
+| `tinymce` / `tinymce-i18n` | 仅设计器富文本需要（optional peer） |
+
+包内**零运行时 HTTP 依赖**：请求走宿主注入的适配器，公开数据源走原生 `fetch`。
+
+## 接入
+
+```ts
+// main.ts
+import { configure } from '@otlab/form-generator';
+import '@otlab/form-generator/style.css';
+import adapter from './form-generator-adapter'; // 参考 examples/adapter.ts
+
+configure({
+  apiBase: import.meta.env.VITE_APP_API_URL, // 静态资源/文件地址前缀
+  request: adapter,                          // 宿主请求适配器
+});
+```
+
+```vue
+<!-- 填写/预览 -->
+<script setup lang="ts">
+  import { BizProjectForm } from '@otlab/form-generator';
+</script>
+<template>
+  <BizProjectForm :form-config="{ formKey }" @submit="onSubmit" />
+</template>
+```
+
+```vue
+<!-- 设计器：建议配合路由懒加载 -->
+<script setup lang="ts">
+  import { provide } from 'vue';
+  import { FORM_DESIGN_READONLY_KEY } from '@otlab/form-generator';
+  import { FormDesign } from '@otlab/form-generator/designer';
+
+  const props = defineProps<{ formKey: string }>();
+  // 只读态由宿主工作台决定（编辑占用租约等），包只消费这一个布尔量
+  provide(FORM_DESIGN_READONLY_KEY, { isReadOnly });
+</script>
+<template>
+  <FormDesign :form-key="formKey" />
+</template>
+```
+
+## 配置项
+
+| 字段 | 默认 | 说明 |
+|---|---|---|
+| `apiBase` | `''` | 静态资源/文件地址前缀（原 `VITE_APP_API_URL`） |
+| `request` | `null` | 请求适配器，未配置时调用接口会抛错 |
+| `paths` | `/survey/**` | 后端端点表，局部覆盖即可换后端 |
+| `documentTitle` | `true` | 是否允许改写 `document.title` |
+
+端点表覆盖示例（默认值见 `src/api/paths.ts`）：
+
+```ts
+configure({
+  paths: {
+    formDetail: '/api-v2/form/{key}',
+    fileUpload: '/api-v2/file/upload',
+  },
+});
+```
+
+占位符 `{key}` 由 `resolvePath` 填充并 encode。
+
+## 开发
+
+```bash
+pnpm install
+pnpm check        # lint + typecheck + test + build
+pnpm build        # 产出 dist/index.js、dist/designer.js、dist/style.css、d.ts
+pnpm pack:local   # 本地打 tarball，供 npm pack 安装验证
+```
+
+## 发布（npmjs）
+
+### 首选：GitHub Actions（Trusted Publishing，无需 token）
+
+打 tag 推送即触发 `.github/workflows/publish.yml`：
+
+```bash
+pnpm version patch          # 或 minor / major，同时打 vX.Y.Z tag
+git push --follow-tags
+```
+
+一次性配置：在 npmjs 包的 Trusted Publisher 页面填 GitHub 仓库信息（`dowei` / `form-generator` / `publish.yml`），
+之后 CI 用 OIDC 换临时凭据发布，不涉及任何长期 token。
+
+### 本机发布（2FA 账号需要 OTP）
+
+```bash
+npm login
+pnpm version patch
+pnpm release --otp=<6位验证码>
+```
+
+> 账号开启 2FA 后，`pnpm release` 不带 `--otp` 会返回 403；且 npm 正在弃用
+> 「bypass 2FA 的 granular token」用于直接发布，所以长期建议走上面的 CI 通道。
+
+`prepublishOnly` 会先跑 `pnpm check`（lint + typecheck + test + build），门禁不过不发版。
+发布内容只有 `dist` + `README.md` + `LICENSE`（`files` 白名单），`npm pack --dry-run` 可先核对。
+
+版本语义（0.x 阶段）：`^0.1.0` 只接受 `0.1.x`，破坏性改动请升 minor（`0.2.0`）——
+下游 fork 后升级依赖是显式动作，不会被动跟到不兼容版本。
+
+发布后若消费方装了 pnpm 的「最小发布年龄」策略，`pnpm install` 会把新版本追加进
+`pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude`，属正常现象，随 lockfile 一起提交即可。
+
+## 约束
+
+- 题型白名单（`src/utils/item-contract.ts`、`src/config/index.ts`）必须与后端 `SurveyFormItemValidator` 保持一致；它是包的核心语义，**不做成配置项**。
+- 包内不得出现宿主路径别名（`/@/`）或宿主专属环境变量。

package/dist/api/index.d.ts

@@ -0,0 +1,23 @@
+import { ApiResponse } from '../types/adapter';
+export declare function getProject(formKey: string): Promise<ApiResponse>;
+export declare function getFormDetails(formKey: string): Promise<ApiResponse>;
+export declare function getTemplateFormDetails(formKey: string): Promise<ApiResponse>;
+export declare function queryProjectItems(formKey: string): Promise<ApiResponse>;
+export declare function listFormFields(formKey: string): Promise<ApiResponse>;
+export declare function createProjectItem(data: Record<string, unknown>): Promise<ApiResponse>;
+export declare function updateProjectItem(data: Record<string, unknown>): Promise<ApiResponse>;
+export declare function deleteProjectItem(formKey: string, id: number | string): Promise<ApiResponse>;
+export declare function sortProjectItem(formKey: string, itemIds: Array<number | string>): Promise<ApiResponse>;
+export declare function updateProject(data: Record<string, unknown>, options?: {
+    silentError?: boolean;
+}): Promise<ApiResponse>;
+export declare function batchCreateProjectItem(data: Array<Record<string, unknown>>): Promise<ApiResponse>;
+export declare function createFormResult(data: Record<string, unknown>): Promise<ApiResponse>;
+export declare function publicCreateFormResult(data: Record<string, unknown>): Promise<ApiResponse>;
+export declare function getFormLogic(params: Record<string, unknown>): Promise<ApiResponse>;
+export declare function getUserTheme(projectKey: string): Promise<ApiResponse>;
+export declare function getOptionUsedQuotaRequest(projectKey: string): Promise<ApiResponse>;
+export declare function stopPublishForm(formKey: string): Promise<ApiResponse>;
+export declare function fileUpload(data: FormData): Promise<ApiResponse>;
+export declare function fileUploadAnonymous(data: FormData, formKey?: string): Promise<ApiResponse>;
+export declare function getPhoneCode(phoneNumber: string, formKey?: string): Promise<ApiResponse>;

package/dist/api/paths.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 后端端点表。
+ *
+ * 包内所有 URL 集中在此，`{key}` 为占位符（由 config.resolvePath 填充并 encode）。
+ * 换后端前缀 / 换路径时用 configure({ paths: {...} }) 局部覆盖，无需改包内代码。
+ */
+export interface EndpointPaths {
+    /** 表单项目详情（设计器/管理端） */
+    formDetail: string;
+    /** 表单详情（填写/预览） */
+    formDetails: string;
+    /** 模板表单详情 */
+    templateDetails: string;
+    /** 表单项列表（query: key） */
+    itemList: string;
+    /** 创建表单项 */
+    itemCreate: string;
+    /** 更新表单项（PUT，body 含后端 id） */
+    itemUpdate: string;
+    /** 删除表单项（query: id + key） */
+    itemDelete: string;
+    /** 表单项排序（query: key，body 为 id 数组） */
+    itemSort: string;
+    /** 批量创建表单项 */
+    itemBatchCreate: string;
+    /** 更新表单项目（PUT，body 含问卷 id） */
+    formUpdate: string;
+    /** 保存表单结果 */
+    resultCreate: string;
+    /** 保存公开表单结果（@Anonymous） */
+    resultPublicCreate: string;
+    /** 表单逻辑（query: key） */
+    formLogic: string;
+    /** 表单主题 */
+    formTheme: string;
+    /** 选项名额已用数（query: key，@Anonymous） */
+    optionUsedQuota: string;
+    /** 停止发布（query: key） */
+    formStop: string;
+    /** 登录态文件上传 */
+    fileUpload: string;
+    /** 匿名文件上传（@Anonymous） */
+    fileUploadAnonymous: string;
+    /** 手机验证码（@Anonymous） */
+    phoneCode: string;
+}
+export declare const defaultPaths: EndpointPaths;

package/dist/api/request.d.ts

@@ -0,0 +1,3 @@
+import { ApiAdapter } from '../types/adapter';
+export declare function setApiInstance(instance: unknown): void;
+export declare function getApiInstance(): ApiAdapter | null;

package/dist/components/BizProjectForm/index.vue.d.ts

@@ -0,0 +1,137 @@
+import { FormConf } from '../../types/form';
+declare const _default: import('vue').DefineComponent<{
+    formConfig: {
+        type: ObjectConstructor;
+        default: () => {
+            formKey: string;
+            showBtns: boolean;
+            formKind: number;
+            supportText: string;
+            setting: null;
+            preview: boolean;
+        };
+    };
+    /** 运行时预填值（键=config.defaultValueSource），透传给 GenerateFormContainer（TASK-0115） */
+    prefillValues: {
+        type: ObjectConstructor;
+        default: () => {};
+    };
+}, {
+    containerRef: import('vue').Ref<import('vue').CreateComponentPublicInstance<Readonly<import('vue').ExtractPropTypes<{
+        formConf: {
+            type: import('vue').PropType<FormConf>;
+            required: true;
+        };
+        supportText: {
+            type: StringConstructor;
+            default: string;
+        };
+        prefillValues: {
+            type: ObjectConstructor;
+            default: () => {};
+        };
+    }>> & {
+        onChange?: ((...args: any[]) => any) | undefined;
+        onSubmit?: ((...args: any[]) => any) | undefined;
+        onCompleted?: ((...args: any[]) => any) | undefined;
+    }, {
+        generateFormRef: import('vue').Ref<{
+            getFormModel: () => Record<string, unknown>;
+            validate: () => Promise<unknown>;
+        } | null>;
+        getFormModel: () => Record<string, unknown> | undefined;
+        validate: () => Promise<unknown> | undefined;
+        restoreFormModel: (models: Record<string, unknown>) => void;
+    }, unknown, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        change: (...args: any[]) => void;
+        submit: (...args: any[]) => void;
+        completed: (...args: any[]) => void;
+    }, import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & Readonly<import('vue').ExtractPropTypes<{
+        formConf: {
+            type: import('vue').PropType<FormConf>;
+            required: true;
+        };
+        supportText: {
+            type: StringConstructor;
+            default: string;
+        };
+        prefillValues: {
+            type: ObjectConstructor;
+            default: () => {};
+        };
+    }>> & {
+        onChange?: ((...args: any[]) => any) | undefined;
+        onSubmit?: ((...args: any[]) => any) | undefined;
+        onCompleted?: ((...args: any[]) => any) | undefined;
+    }, {
+        prefillValues: Record<string, any>;
+        supportText: string;
+    }, true, {}, {}, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('vue').ExtractPropTypes<{
+        formConf: {
+            type: import('vue').PropType<FormConf>;
+            required: true;
+        };
+        supportText: {
+            type: StringConstructor;
+            default: string;
+        };
+        prefillValues: {
+            type: ObjectConstructor;
+            default: () => {};
+        };
+    }>> & {
+        onChange?: ((...args: any[]) => any) | undefined;
+        onSubmit?: ((...args: any[]) => any) | undefined;
+        onCompleted?: ((...args: any[]) => any) | undefined;
+    }, {
+        generateFormRef: import('vue').Ref<{
+            getFormModel: () => Record<string, unknown>;
+            validate: () => Promise<unknown>;
+        } | null>;
+        getFormModel: () => Record<string, unknown> | undefined;
+        validate: () => Promise<unknown> | undefined;
+        restoreFormModel: (models: Record<string, unknown>) => void;
+    }, {}, {}, {}, {
+        prefillValues: Record<string, any>;
+        supportText: string;
+    }> | null>;
+    getFormModel: () => Record<string, unknown> | undefined;
+    validate: () => Promise<unknown> | undefined;
+    restoreFormModel: (models: Record<string, unknown>) => void | undefined;
+}, unknown, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (...args: any[]) => void;
+    submit: (...args: any[]) => void;
+    completed: (...args: any[]) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    formConfig: {
+        type: ObjectConstructor;
+        default: () => {
+            formKey: string;
+            showBtns: boolean;
+            formKind: number;
+            supportText: string;
+            setting: null;
+            preview: boolean;
+        };
+    };
+    /** 运行时预填值（键=config.defaultValueSource），透传给 GenerateFormContainer（TASK-0115） */
+    prefillValues: {
+        type: ObjectConstructor;
+        default: () => {};
+    };
+}>> & {
+    onChange?: ((...args: any[]) => any) | undefined;
+    onSubmit?: ((...args: any[]) => any) | undefined;
+    onCompleted?: ((...args: any[]) => any) | undefined;
+}, {
+    prefillValues: Record<string, any>;
+    formConfig: Record<string, any>;
+}, {}>;
+export default _default;

package/dist/components/FormDesign/CenterCanvas.vue.d.ts

@@ -0,0 +1,31 @@
+/** Sortable.js 排序信息（sort-change 载荷，vuedraggable 无事件类型导出） */
+interface DragMovedInfo {
+    newIndex?: number;
+    oldIndex?: number;
+    element?: unknown;
+}
+declare const _default: import('vue').DefineComponent<__VLS_TypePropsToOption<{
+    /** 是否处于设计器全屏态（由父组件经 Fullscreen API 同步） */
+    fullscreen?: boolean;
+}>, {}, unknown, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "sort-change": (value: DragMovedInfo) => void;
+    "toggle-fullscreen": () => void;
+    clear: () => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToOption<{
+    /** 是否处于设计器全屏态（由父组件经 Fullscreen API 同步） */
+    fullscreen?: boolean;
+}>>> & {
+    onClear?: (() => any) | undefined;
+    "onSort-change"?: ((value: DragMovedInfo) => any) | undefined;
+    "onToggle-fullscreen"?: (() => any) | undefined;
+}, {}, {}>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/FormDesign/DefaultValueModal.vue.d.ts

@@ -0,0 +1,36 @@
+interface OptionItem {
+    label: string;
+    value: string | number;
+}
+interface FormField {
+    type?: string;
+    config: {
+        tag?: string;
+        defaultValue?: unknown;
+        defaultNowTime?: boolean;
+        options?: OptionItem[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+declare const _default: import('vue').DefineComponent<__VLS_TypePropsToOption<{
+    open: boolean;
+    field: FormField | null;
+}>, {}, unknown, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:open": (value: boolean) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToOption<{
+    open: boolean;
+    field: FormField | null;
+}>>> & {
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}, {}, {}>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/FormDesign/ExamConfigSection.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{}>>, {}, {}>;
+export default _default;

package/dist/components/FormDesign/FormItem.vue.d.ts

@@ -0,0 +1,53 @@
+import { FormFieldConfig, MatrixTable, SelectOption } from '../../types/form';
+/** 预览消费的 config：在 FormFieldConfig 基础上显式声明面板写入的额外开关 */
+interface PreviewFieldConfig extends FormFieldConfig {
+    showWordLimit?: boolean;
+    showOther?: boolean;
+    inline?: boolean;
+    buttonText?: string;
+}
+/** 画布预览消费的字段形状（FormField 顶层扩展属性为 unknown，此处按实际消费声明） */
+interface PreviewField {
+    placeholder?: string;
+    style?: Record<string, string>;
+    clearable?: boolean;
+    maxlength?: number;
+    showWordLimit?: boolean;
+    min?: number;
+    max?: number;
+    step?: number;
+    precision?: number;
+    autosize?: boolean | {
+        minRows: number;
+        maxRows: number;
+    };
+    format?: string;
+    allowHalf?: boolean;
+    multiple?: boolean;
+    orientation?: 'left' | 'right' | 'center';
+    content?: string;
+    sortList?: SelectOption[];
+    table?: MatrixTable;
+    textConfig?: {
+        prevBtnText?: string;
+        nextBtnText?: string;
+    };
+    tag?: string;
+    type?: string;
+    config?: PreviewFieldConfig;
+}
+declare const _default: import('vue').DefineComponent<__VLS_TypePropsToOption<{
+    field: PreviewField;
+}>, {}, unknown, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToOption<{
+    field: PreviewField;
+}>>>, {}, {}>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/FormDesign/FormItemLayout.vue.d.ts

@@ -0,0 +1,26 @@
+import { FormField } from '../../types/form';
+declare const _default: import('vue').DefineComponent<__VLS_TypePropsToOption<{
+    field: FormField;
+    active?: boolean;
+}>, {}, unknown, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    delete: () => void;
+    select: () => void;
+    copy: () => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToOption<{
+    field: FormField;
+    active?: boolean;
+}>>> & {
+    onCopy?: (() => any) | undefined;
+    onSelect?: (() => any) | undefined;
+    onDelete?: (() => any) | undefined;
+}, {}, {}>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/FormDesign/ImportFormItem.vue.d.ts

@@ -0,0 +1,23 @@
+declare const _default: import('vue').DefineComponent<__VLS_TypePropsToOption<{
+    open: boolean;
+    formKey: string;
+}>, {}, unknown, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:open": (value: boolean) => void;
+    success: () => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToOption<{
+    open: boolean;
+    formKey: string;
+}>>> & {
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+    onSuccess?: (() => any) | undefined;
+}, {}, {}>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/FormDesign/LeftPanel.vue.d.ts

@@ -0,0 +1,21 @@
+declare const _default: import('vue').DefineComponent<__VLS_TypePropsToOption<{
+    /** 当前问卷 key，导入题目批量创建时使用 */
+    formKey: string;
+}>, {}, unknown, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "import-success": () => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToOption<{
+    /** 当前问卷 key，导入题目批量创建时使用 */
+    formKey: string;
+}>>> & {
+    "onImport-success"?: (() => any) | undefined;
+}, {}, {}>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/FormDesign/RightPanel.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{}>>, {}, {}>;
+export default _default;

package/dist/components/FormDesign/default-value.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 默认值设置弹窗的题型分派与预览格式化（task-0032/feat-0047）。
+ * 渲染侧 GenerateForm initFormData 已消费 config.defaultValue，无需改动。
+ */
+export type DefaultValueMode = 'text' | 'number' | 'date' | 'choice';
+/** 支持设置默认值的题型（tag → 分派模式）；未列出的题型不支持 */
+export declare const tagModeMap: Record<string, DefaultValueMode>;
+export declare function isDefaultValueSupported(tag?: string): boolean;
+/** 选项节点（含级联 children，宽松取字段） */
+interface OptionNode {
+    label?: unknown;
+    value?: unknown;
+    children?: OptionNode[];
+}
+/**
+ * 默认值在面板按钮旁的预览文案（数组顿号连接，空值返回空串）。
+ * choice 类题型按选项表把 value 映射为选项名显示（bug-0054），查不到回落原值；
+ * 其余模式（text/number/date）原样显示。
+ */
+export declare function formatDefaultValuePreview(value: unknown, tag?: string, options?: OptionNode[]): string;
+export {};

package/dist/components/FormDesign/index.vue.d.ts

@@ -0,0 +1,15 @@
+declare const _default: import('vue').DefineComponent<__VLS_TypePropsToOption<{
+    formKey?: string;
+}>, {}, unknown, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToOption<{
+    formKey?: string;
+}>>>, {}, {}>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/FormItem/autoRegister.d.ts

@@ -0,0 +1,4 @@
+import { Component } from 'vue';
+declare const components: Record<string, Component>;
+export declare function getComponents(): Record<string, Component>;
+export default components;

package/dist/components/FormItemConfig/autoRegister.d.ts

@@ -0,0 +1,3 @@
+declare const components: Record<string, unknown>;
+export declare function getConfigComponents(): Record<string, unknown>;
+export default components;