@jxyszb/jxy-form-designer 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## Unreleased
+
+## 0.3.0 - 2026-10-16
+
+- Schema 升级为 1.4.0，兼容迁移 1.0.0 至 1.3.0。
+- 普通上传增加按需模板下载，支持独立模板数据源、实时参数和宿主下载适配。
+- provider 增加可选 downloadTemplate，预览通过 mock 展示下载信息。
+- 数据源和字段选择支持搜索；字段选项同时展示中文标题与 prop。
+- 模板引用纳入类型校验、删除清理、导入 ID 重映射和 Undo/Redo。
+
+## 0.2.0
+
+- 保存草稿和发布按钮支持独立名称与显示配置。
+- `JXYFormDesigner` 新增 `save-draft`、`publish`、`publish-invalid` 事件，由宿主负责持久化和接口调用。
+- Designer 默认不再读取固定 localStorage 草稿，旧持久化方法保留为废弃兼容 API。
+- Playground 增加本地草稿和模拟后端发布参考实现。
+
 ## 0.1.0
 
 - 首次拆分 JXY Form Designer、Runtime、Schema、Store 和扩展字段。

package/README.md

@@ -6,7 +6,7 @@ A schema-driven form designer and runtime for Vue 3, Pinia, and Element Plus.
 
 - Drag-and-drop form design with fields, titles, and grid layouts.
 - Runtime rendering from JSON Schema.
-- Static, dictionary, and API data sources.
+- Static, dictionary, API, and on-demand template-download data sources.
 - Validation, field reactions, import/export, and preview.
 - Host adapters for request clients, file upload, rich-text editors, and custom fields.
 
@@ -46,6 +46,9 @@ Dynamic data sources, uploads, and rich-text fields can use host adapters:
 ```js
 app.use(createJxyFormPlugin({
   request: requestClient,
+  // JXY framework example: keep the method receiver so its internal this remains valid.
+  downloadFile: (url, params, fileName) =>
+    app.config.globalProperties.$custom.downFile(params, fileName, url),
   components: {
     fileUpload: FileUpload,
     editor: RichTextEditor
@@ -64,21 +67,58 @@ import {
   createDefaultSchema
 } from '@jxyszb/jxy-form-designer';
 
+const designerRef = ref();
 const schema = ref(createDefaultSchema());
 const formData = ref({});
+
+function handleSaveDraft({ schema: draftSchema }) {
+  localStorage.setItem('business-form-draft', JSON.stringify(draftSchema));
+}
+
+async function handlePublish({ schema: publishedSchema, warnings }) {
+  await publishFormSchema(publishedSchema);
+  console.log('publish warnings', warnings);
+}
+
+function handlePublishInvalid({ errors }) {
+  console.warn('schema cannot be published', errors);
+}
 </script>
 
 <template>
-  <JXYFormDesigner />
+  <JXYFormDesigner
+    ref="designerRef"
+    save-draft-button-label="保存草稿"
+    :show-save-draft-button="true"
+    publish-button-label="发布"
+    :show-publish-button="true"
+    @save-draft="handleSaveDraft"
+    @publish="handlePublish"
+    @publish-invalid="handlePublishInvalid"
+  />
   <JXYFormRuntime v-model="formData" :schema="schema" />
 </template>
 ```
 
+Designer emits independent, normalized Schema snapshots. It does not persist drafts or published schemas by default. Publish validation remains inside the package; the host owns storage, API calls, loading, and result messages.
+
 Schema utilities are also available from `@jxyszb/jxy-form-designer/schema`. The `testing` subpath contains demo and mock helpers and should not be used by production code.
 
 ## Documentation
 
-- [Field suffix extension](docs/field-suffix-extension.md)
+Normal upload fields (`file`) support a template download button:
+
+1. Add a `templateDownload` data source with a relative `url`, `params`, and optional `fileName`.
+2. Enable template download in the field properties and select that source.
+3. Provide `downloadFile` through the plugin, or `downloadTemplate(url, params, fileName)` through a custom provider.
+
+The button appears after the upload component and only requests on click. Required parameters use current form values. A configured file name overrides the backend name; leave it empty to use the host downloader's response-header handling. Global form disabled/view mode hides the button; individual field disabled states do not. Existing synchronous JXY download utilities are supported without download loading or duplicate-click protection.
+
+An explicit Runtime provider overrides the plugin provider entirely. Preview providers must implement `downloadTemplate`; the included mock displays request details and never downloads a real file. Upgrade Runtime before publishing Schema `jxy-form-schema@1.4.0`.
+
+- [Field suffix extension](<docs/JXY 表单字段右侧扩展位使用说明.md>)
+- [Designer configuration and template downloads](<docs/JXY Form Designer 开发者说明.md>)
+- [Designer developer guide](docs/designer-save-publish-events.md)
 
 ## License