pdfwright-web 0.3.0__tar.gz → 0.4.0__tar.gz

{pdfwright_web-0.3.0 → pdfwright_web-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pdfwright-web
-Version: 0.3.0
+Version: 0.4.0
 Summary: pdfwright 的无状态 Web 服务：可视化配置编辑器 + HTML/PDF 预览 + 对外渲染 API（不存储任何数据与内容）
 License: Proprietary
 Requires-Python: >=3.12

{pdfwright_web-0.3.0 → pdfwright_web-0.4.0}/frontend/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pdfwright-designer",
   "private": true,
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "scripts": {
     "dev": "vite",

{pdfwright_web-0.3.0 → pdfwright_web-0.4.0}/frontend/src/App.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 /** 应用外壳：设计（组件树 + 画布 + 属性）/ 填写；预览在画布区就地切换。 */
-import { computed, onMounted, ref } from 'vue'
+import { computed, onMounted, onUnmounted, ref } from 'vue'
 import { ElMessage, ElMessageBox } from 'element-plus'
 import CanvasArea from '@/designer/CanvasArea.vue'
 import ComponentPalette from '@/designer/ComponentPalette.vue'
@@ -10,7 +10,7 @@ import PropsPanel from '@/designer/PropsPanel.vue'
 import FillView from '@/fill/FillView.vue'
 import * as api from '@/api/client'
 import type { ExampleItem } from '@/api/client'
-import { downloadPdf, exportSchema, extractLegacyData, importSchema, importSchemaJson, initialize, redo, removeSelected, restoreDraft, hasDraft, clearDraft, setMode, state, undo } from '@/store/designer'
+import { downloadPdf, exportSchema, extractLegacyData, importSchema, importSchemaJson, initialize, redo, removeSelected, restoreDraft, peekDraft, clearDraft, setMode, state, undo } from '@/store/designer'
 import { downloadBlob } from '@/lib/download'
 import type { DocumentSchema } from '@/types/schema'
 
@@ -21,8 +21,12 @@ const xlsxInput = ref<HTMLInputElement | null>(null)
 //: 默认 **块级**（各自独立成块，可自由拖拽），需要保留 Word 的同行排版时从下拉菜单选。
 const docxInline = ref(false)
 const jsonOpen = ref(false)
+/** JSON 抽屉里的面板（``@open`` 时要让它重新同步，见 JsonPanel.sync 的注释）。 */
+const jsonPanelRef = ref<InstanceType<typeof import('./designer/JsonPanel.vue')['default']> | null>(null)
 const leftTab = ref('palette')
 const examples = ref<ExampleItem[]>([])
+/** 新构建探测轮询的定时器句柄（`onUnmounted` 里要清）。 */
+let buildTimer: number | undefined
 
 const errorCount = computed(() => state.issues.filter((issue) => issue.level === 'error').length)
 const warnCount = computed(() => state.issues.filter((issue) => issue.level === 'warning').length)
@@ -30,16 +34,25 @@ const warnCount = computed(() => state.issues.filter((issue) => issue.level ===
 onMounted(() => {
   void bootstrap()
   void watchBuild()
-  setInterval(() => void watchBuild(), 30000)
+  buildTimer = window.setInterval(() => void watchBuild(), 30000)
   document.addEventListener('visibilitychange', onVisibility)
   window.addEventListener('keydown', onKeydown)
   void loadExamples()
 })
 
+// ⚠️ 轮询与两个全局监听器必须成对注销：组件被卸载后旧实例仍会每 30s 打一次
+// `/api/version`，且监听器会随每次重新挂载（HMR / 测试）不断累积。
+onUnmounted(() => {
+  if (buildTimer !== undefined) window.clearInterval(buildTimer)
+  buildTimer = undefined
+  document.removeEventListener('visibilitychange', onVisibility)
+  window.removeEventListener('keydown', onKeydown)
+})
+
 /** 启动：先尝试恢复上次的草稿（刷新/误关不丢工作），用户可选择放弃。 */
 async function bootstrap(): Promise<void> {
   await initialize()
-  if (!hasDraft()) return
+  if (!peekDraft()) return
   try {
     await ElMessageBox.confirm('检测到上次未导出的草稿，是否恢复？', '恢复草稿', {
       confirmButtonText: '恢复',
@@ -245,6 +258,7 @@ function pickDocxFile(inline: boolean): void {
       <div class="toolbar-spacer" />
 
       <span v-if="errorCount" class="issue-badge error">{{ errorCount }} 个错误</span>
+      <span v-else-if="state.renderWarnings.length" class="issue-badge warn">{{ state.renderWarnings.length }} 个渲染提示</span>
       <span v-else-if="warnCount" class="issue-badge warn">{{ warnCount }} 个提示</span>
 
       <el-button size="small" :disabled="state.historyIndex <= 0" @click="undo">撤销</el-button>
@@ -292,6 +306,12 @@ function pickDocxFile(inline: boolean): void {
         ⓘ {{ issue.path }}：{{ issue.message }}
       </span>
     </div>
+    <!-- 渲染期告警：静态校验查不出来的东西（图片没加载出来 / 变量未定义 / 字符被忽略）。
+         独立一条是因为它属于「**这份数据渲染时**」，且下载成功≠配置正确。 -->
+    <div v-if="state.renderWarnings.length" class="issue-bar render-warn">
+      <span v-for="warning in state.renderWarnings.slice(0, 3)" :key="warning">⚠ {{ warning }}</span>
+      <el-button size="small" text @click="state.renderWarnings = []">知道了</el-button>
+    </div>
 
     <main class="main">
       <template v-if="state.mode === 'design'">
@@ -311,8 +331,14 @@ function pickDocxFile(inline: boolean): void {
       <FillView v-else />
     </main>
 
-    <el-drawer v-model="jsonOpen" title="页面配置 JSON" size="46%" :with-header="true">
-      <JsonPanel />
+    <el-drawer
+      v-model="jsonOpen"
+      title="页面配置 JSON"
+      size="46%"
+      :with-header="true"
+      @open="jsonPanelRef?.sync()"
+    >
+      <JsonPanel ref="jsonPanelRef" />
     </el-drawer>
   </div>
 </template>
@@ -393,6 +419,13 @@ function pickDocxFile(inline: boolean): void {
   color: #b45309;
   border-bottom-color: #fde68a;
 }
+/* 渲染告警：用中性橙底与静态校验的黄色条区分（一个来自配置、一个来自这次渲染） */
+.issue-bar.render-warn {
+  background: #fff7ed;
+  color: #c2410c;
+  border-bottom-color: #fed7aa;
+  align-items: center;
+}
 .example-item {
   padding: 2px 0;
   max-width: 320px;

pdfwright_web-0.4.0/frontend/src/api/client.spec.ts

@@ -0,0 +1,88 @@
+/** API 客户端：导入 Word 的「同排」开关要走对 URL（默认块级 = 不带参数）。 */
+
+import { afterEach, describe, expect, it, vi } from 'vitest'
+
+import { convertDocx, renderHtml, renderPdf } from './client'
+
+const OK = { document: { page: {}, body: [] }, fields: [], warnings: [] }
+
+function stubFetch(): ReturnType<typeof vi.fn> {
+  const spy = vi.fn(async () => new Response(JSON.stringify(OK), { status: 200 }))
+  vi.stubGlobal('fetch', spy)
+  return spy
+}
+
+describe('convertDocx', () => {
+  afterEach(() => {
+    vi.unstubAllGlobals()
+  })
+
+  it('默认（块级）不打 inline_commands', async () => {
+    const spy = stubFetch()
+    await convertDocx(new File(['x'], 'a.docx'))
+    expect(String(spy.mock.calls[0][0])).toBe('/api/convert/docx')
+  })
+
+  it('开启同排 → ?inline_commands=true', async () => {
+    const spy = stubFetch()
+    await convertDocx(new File(['x'], 'a.docx'), true)
+    expect(String(spy.mock.calls[0][0])).toBe('/api/convert/docx?inline_commands=true')
+  })
+})
+
+describe('renderPdf / renderHtml 的告警头', () => {
+  afterEach(() => {
+    vi.unstubAllGlobals()
+  })
+
+  /** 服务端把告警序列化成 base64url 的 JSON 数组放进 ``X-PdfWright-Warnings``。 */
+  function warningsHeader(items: string[]): Headers {
+    const bytes = new TextEncoder().encode(JSON.stringify(items))
+    let binary = ''
+    bytes.forEach((byte) => (binary += String.fromCharCode(byte)))
+    return new Headers({ 'x-pdfwright-warnings': btoa(binary).replace(/\+/g, '-').replace(/\//g, '_') })
+  }
+
+  it('PDF：告警从响应头解出来（中文不乱码），值仍是 Blob', async () => {
+    vi.stubGlobal(
+      'fetch',
+      vi.fn(
+        async () =>
+          new Response(new Blob([new Uint8Array([1, 2, 3])]), {
+            status: 200,
+            headers: warningsHeader(['图片加载失败，已跳过：/etc/hosts']),
+          }),
+      ),
+    )
+    const result = await renderPdf({ page: {}, body: [] } as never)
+    expect(result.warnings).toEqual(['图片加载失败，已跳过：/etc/hosts'])
+    expect(result.value).toBeInstanceOf(Blob)
+  })
+
+  it('HTML：告警从响应头解出来', async () => {
+    vi.stubGlobal(
+      'fetch',
+      vi.fn(async () => new Response('<p>x</p>', { status: 200, headers: warningsHeader(['未定义变量 foo']) })),
+    )
+    const result = await renderHtml({ page: {}, body: [] } as never)
+    expect(result.value).toBe('<p>x</p>')
+    expect(result.warnings).toEqual(['未定义变量 foo'])
+  })
+
+  it('头缺失 / 非法 base64 → 当作没有告警，**不能**让渲染失败', async () => {
+    vi.stubGlobal('fetch', vi.fn(async () => new Response(new Blob([new Uint8Array([1])]), { status: 200 })))
+    expect((await renderPdf({ page: {}, body: [] } as never)).warnings).toEqual([])
+
+    vi.stubGlobal(
+      'fetch',
+      vi.fn(
+        async () =>
+          new Response(new Blob([new Uint8Array([1])]), {
+            status: 200,
+            headers: { 'x-pdfwright-warnings': '!!!not-base64!!!' },
+          }),
+      ),
+    )
+    expect((await renderPdf({ page: {}, body: [] } as never)).warnings).toEqual([])
+  })
+})

{pdfwright_web-0.3.0 → pdfwright_web-0.4.0}/frontend/src/api/client.ts

@@ -96,6 +96,8 @@ export interface SemanticFont {
   exact: boolean
   /** 字体自然行高倍数（后端按字体度量算，前端据此还原行距） */
   lineRatio?: number | null
+  /** 字体**排版**行高倍数（OS/2 win）：判断文档网格吸附用（后端按字体度量算） */
+  lineRatioWin?: number | null
 }
 
 export interface SearchableFont {
@@ -129,7 +131,35 @@ export function validateDocument(
   })
 }
 
-export async function renderHtml(document: DocumentSchema, data?: FormData): Promise<string> {
+/** 从渲染响应头解出告警（``X-PdfWright-Warnings`` = base64url 的 JSON 数组）。
+ *
+ * ⚠️ 这层解包放在客户端而不是让调用方处理：``/api/render/*`` 返回二进制/HTML，
+ * 告警只能走响应头；解不出来（头缺失、旧服务、非法 base64）就当没有告警 —— 绝不能
+ * 因为一个提示头解码失败就让整个渲染失败。
+ */
+function decodeWarnings(response: Response): string[] {
+  const raw = response.headers.get('x-pdfwright-warnings')
+  if (!raw) return []
+  try {
+    const binary = atob(raw.replace(/-/g, '+').replace(/_/g, '/'))
+    const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0))
+    const parsed: unknown = JSON.parse(new TextDecoder().decode(bytes))
+    return Array.isArray(parsed) ? parsed.map((item) => String(item)).slice(0, 20) : []
+  } catch {
+    return []
+  }
+}
+
+export interface RenderResult<T> {
+  value: T
+  /** 渲染期告警（图片没加载出来 / 变量未定义 / 字符被忽略…），已去重截断 */
+  warnings: string[]
+}
+
+export async function renderHtml(
+  document: DocumentSchema,
+  data?: FormData,
+): Promise<RenderResult<string>> {
   const response = await fetch('/api/render/html', {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
@@ -140,10 +170,10 @@ export async function renderHtml(document: DocumentSchema, data?: FormData): Pro
     // 早前这里只拼「HTTP xxx」，把后端给的具体原因（模板语法错误/非法配置项）丢了
     throw new Error(await errorMessage(response, 'HTML 预览失败'))
   }
-  return response.text()
+  return { value: await response.text(), warnings: decodeWarnings(response) }
 }
 
-export async function renderPdf(document: DocumentSchema, data?: FormData): Promise<Blob> {
+export async function renderPdf(document: DocumentSchema, data?: FormData): Promise<RenderResult<Blob>> {
   const response = await fetch('/api/render/pdf', {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
@@ -153,7 +183,7 @@ export async function renderPdf(document: DocumentSchema, data?: FormData): Prom
   if (!response.ok) {
     throw new Error(await errorMessage(response, 'PDF 生成失败'))
   }
-  return response.blob()
+  return { value: await response.blob(), warnings: decodeWarnings(response) }
 }
 
 /** 模板需要的字段（服务端从模板 AST + 变量声明推断，与 mock 数据同源）。 */

pdfwright_web-0.4.0/frontend/src/designer/DataPanel.vue

@@ -0,0 +1,193 @@
+<script setup lang="ts">
+/** 数据面板（属性面板的「数据」tab）：示例（Mock）数据、示例图样式、推断提示与字段清单。
+ *
+ * 从 `PropsPanel.vue` 拆出来的：这里读写的是运行态 `state.data` 与 `/api/mock`，
+ * 与「选中元素的属性」毫无关系。样式基元见 `panel-shared.css`，本面板专属样式见
+ * `data-panel.css`。
+ */
+import { ref } from 'vue'
+import * as api from '@/api/client'
+import { ElMessage } from 'element-plus'
+import { exportSchema, refreshPreview, setMockImages, state } from '@/store/designer'
+
+const dataText = ref('')
+const mockBusy = ref(false)
+/** 服务端返回的「无法推断」提示（函数调用/动态下标等） */
+const mockWarnings = ref<string[]>([])
+/** 服务端推断出的字段清单（类型 + 嵌套结构） */
+const mockVariables = ref<api.MockVariable[]>([])
+
+function syncDataText(): void {
+  dataText.value = JSON.stringify(state.data ?? {}, null, 2)
+}
+syncDataText()
+
+/** 输入时**防抖自动应用**：改 mock 数据后预览立刻跟着变，不必先点别处再点刷新。 */
+let dataTimer: ReturnType<typeof setTimeout> | undefined
+
+function scheduleDataApply(): void {
+  if (dataTimer) clearTimeout(dataTimer)
+  dataTimer = setTimeout(() => {
+    dataTimer = undefined
+    applyData()
+  }, 400)
+}
+
+function applyData(): void {
+  try {
+    state.data = dataText.value.trim() ? JSON.parse(dataText.value) : {}
+  } catch {
+    ElMessage.error('数据 JSON 不合法')
+  }
+}
+
+/** 数据 tab 的「刷新」：应用 JSON 并重新渲染当前视图（HTML/PDF 预览或设计画布）。 */
+function refreshData(): void {
+  applyData()
+  syncDataText()
+  void refreshPreview()
+  ElMessage.success('已刷新预览')
+}
+
+/** 示例图（Mock 假图）形状选项：签章与普通图片各一套默认。 */
+const IMAGE_SHAPES = [
+  { value: 'cross', label: '框 + X（图片占位）' },
+  { value: 'rect', label: '纯色块' },
+  { value: 'seal', label: '方章（框 + 星）' },
+  { value: 'ring', label: '圆章（环 + 星）' },
+]
+
+/** 示例图样式（签章图 / 图片）：改了就重新生成示例图（见 setMockImages）。 */
+function mockImageShape(which: 'seal' | 'image'): string {
+  const fallback = which === 'seal' ? 'seal' : 'cross'
+  return state.mockImages?.[which]?.shape ?? fallback
+}
+
+function mockImageLine(which: 'seal' | 'image'): string {
+  const fallback = which === 'seal' ? '#c1121f' : '#64748b'
+  return state.mockImages?.[which]?.line ?? fallback
+}
+
+function onMockImage(which: 'seal' | 'image', patch: { shape?: string; line?: string }): void {
+  const clean = Object.fromEntries(Object.entries(patch).filter(([, value]) => value))
+  void setMockImages({ [which]: clean as never })
+}
+
+/** 一键生成 Mock 数据：调 `/api/mock`（库侧 `pdfwright.mock`，按模板语义推断）。
+ *
+ * 前端**不再自己猜**（按变量类型生成的扁平数组会让内层循环取不到数据 → 内容行整片
+ * 消失）；变量提取/循环/嵌套/条件分支/下拉合法值都在库侧一处实现，与导入自带的
+ * 示例数据同源。已有数据只补缺失，手填的值不会被覆盖。
+ */
+async function fillMockData(): Promise<void> {
+  mockBusy.value = true
+  try {
+    const result = await api.generateMockData(exportSchema(), state.data, 2, state.mockImages)
+    state.data = result.data
+    mockWarnings.value = result.warnings
+    mockVariables.value = result.variables ?? []
+    syncDataText()
+    void refreshPreview()
+    if (result.warnings.length) {
+      ElMessage.warning(`已生成 Mock 数据，${result.warnings.length} 处无法推断（见下方提示）`)
+    } else {
+      ElMessage.success('已按模板结构生成 Mock 数据（变量/循环/嵌套/条件）')
+    }
+  } catch (error) {
+    ElMessage.error(`生成 Mock 数据失败：${(error as Error).message}`)
+  } finally {
+    mockBusy.value = false
+  }
+}
+</script>
+
+<template>
+  <div class="prop-group">
+    <div class="data-actions">
+      <el-button size="small" type="primary" plain :loading="mockBusy" @click="fillMockData">按模板生成 Mock</el-button>
+      <el-button size="small" @click="refreshData">刷新预览</el-button>
+    </div>
+    <div class="data-hint">
+      用于画布/HTML/PDF 预览的示例数据（不影响导出配置）；按模板里的循环/条件/控件声明推断，已有值只补不覆盖
+    </div>
+    <div class="mock-images">
+      <div class="mock-images-title">示例图（签章 / 图片字段的假图，base64 内联）</div>
+      <div class="mock-image-row">
+        <span class="mock-image-label">签章图</span>
+        <el-select
+          size="small"
+          :model-value="mockImageShape('seal')"
+          @update:model-value="onMockImage('seal', { shape: String($event) })"
+        >
+          <el-option
+            v-for="item in IMAGE_SHAPES"
+            :key="item.value"
+            :label="item.label"
+            :value="item.value"
+          />
+        </el-select>
+        <el-color-picker
+          size="small"
+          :model-value="mockImageLine('seal')"
+          @update:model-value="onMockImage('seal', { line: String($event) })"
+        />
+      </div>
+      <div class="mock-image-row">
+        <span class="mock-image-label">图片</span>
+        <el-select
+          size="small"
+          :model-value="mockImageShape('image')"
+          @update:model-value="onMockImage('image', { shape: String($event) })"
+        >
+          <el-option
+            v-for="item in IMAGE_SHAPES"
+            :key="item.value"
+            :label="item.label"
+            :value="item.value"
+          />
+        </el-select>
+        <el-color-picker
+          size="small"
+          :model-value="mockImageLine('image')"
+          @update:model-value="onMockImage('image', { line: String($event) })"
+        />
+      </div>
+      <div class="mock-images-hint">改样式会重新生成示例图（覆盖当前数据里的 PNG 假图）</div>
+    </div>
+    <div v-if="mockWarnings.length" class="mock-warnings">
+      <div v-for="message in mockWarnings" :key="message">⚠️ {{ message }}</div>
+    </div>
+    <div v-if="mockVariables.length" class="mock-variables">
+      <div class="mock-variables-title">模板需要的字段（{{ mockVariables.length }} 个根变量）</div>
+      <div v-for="variable in mockVariables" :key="variable.name" class="mock-variable">
+        <span class="mock-variable-name">{{ variable.name }}</span>
+        <span class="mock-variable-type">: {{ variable.type }}</span>
+        <span v-if="variable.declared" class="mock-variable-declared">已声明</span>
+        <span v-else class="mock-variable-undeclared">未声明</span>
+        <div v-if="variable.fields?.length" class="mock-variable-fields">
+          <div v-for="field in variable.fields" :key="field.name" class="mock-variable">
+            <span class="mock-variable-name">{{ field.name }}</span>
+            <span class="mock-variable-type">: {{ field.type }}</span>
+            <div v-if="field.fields?.length" class="mock-variable-fields">
+              <div v-for="nested in field.fields" :key="nested.name" class="mock-variable">
+                <span class="mock-variable-name">{{ nested.name }}</span>
+                <span class="mock-variable-type">: {{ nested.type }}</span>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+    <el-input
+      v-model="dataText"
+      type="textarea"
+      :rows="16"
+      class="json-area"
+      @blur="applyData"
+      @input="scheduleDataApply"
+    />
+  </div>
+</template>
+
+<style scoped src="./panel-shared.css"></style>
+<style scoped src="./data-panel.css"></style>

pdfwright_web-0.4.0/frontend/src/designer/JsonPanel.spec.ts

@@ -0,0 +1,37 @@
+/**
+ * 「配置 JSON」面板的**同步接线**守卫（E2E 抓到的真 bug）。
+ *
+ * 症状：面板长期显示首次挂载时的快照 —— 用户看到/编辑的是过期配置，点「应用」会用
+ * 过期内容**覆盖**新编辑（实测：改了「本行独立列宽」开关，面板里读到的还是改前的 schema）。
+ * 根因：`JsonPanel` 的 `sync()` 只在 setup 与 `watch(state.mode)` 时跑，而 `el-drawer`
+ * 的内容首次打开后常驻挂载 → 再打开不会重新同步。
+ *
+ * 这里断言的是**接线**（`defineExpose` + drawer 的 `@open`），不是运行时行为 ——
+ * SSR 渲染不出 `el-input` 的 value，行为由 `runtime/e2e/browser2.mjs` 在真浏览器里验。
+ */
+
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+import { describe, expect, it } from 'vitest'
+
+const here = dirname(fileURLToPath(import.meta.url))
+
+describe('JsonPanel 同步接线', () => {
+  const panel = readFileSync(join(here, 'JsonPanel.vue'), 'utf8')
+  const app = readFileSync(join(here, '..', 'App.vue'), 'utf8')
+
+  it('JsonPanel 通过 defineExpose 暴露 sync', () => {
+    expect(panel).toMatch(/defineExpose\(\{\s*sync\s*\}\)/)
+  })
+
+  it('App.vue 在抽屉 open 时调用它', () => {
+    expect(app).toMatch(/@open="jsonPanelRef\?\.sync\(\)"/)
+    expect(app).toMatch(/<JsonPanel ref="jsonPanelRef"/)
+  })
+
+  it('sync 真的从 exportSchema/state.data 取当前值（不是缓存的旧快照）', () => {
+    expect(panel).toMatch(/schemaText\.value = JSON\.stringify\(exportSchema\(\)/)
+    expect(panel).toMatch(/dataText\.value = JSON\.stringify\(state\.data/)
+  })
+})

{pdfwright_web-0.3.0 → pdfwright_web-0.4.0}/frontend/src/designer/JsonPanel.vue

@@ -14,6 +14,13 @@ function sync(): void {
 sync()
 watch(() => state.mode, sync)
 
+// 抽屉每次打开都要显示**当前**文档：`sync()` 原先只在 setup 与 `watch(state.mode)`
+// 时跑，而 el-drawer 的内容首次打开后常驻挂载 → 面板会一直显示首次挂载时的快照。
+// 后果有二：① 用户看到/编辑的是过期配置；② 点「应用」会用过期内容**覆盖**新编辑
+// （E2E 实测：改完表格列宽开关，面板里读到的还是改之前的 schema）。
+// App.vue 在 drawer 的 ``open`` 事件里调这里暴露的 ``sync``。
+defineExpose({ sync })
+
 function applySchema(): void {
   try {
     const parsed = JSON.parse(schemaText.value) as Record<string, unknown>