pdfwright-web 0.2.1__tar.gz → 0.2.2__tar.gz

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/PKG-INFO

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

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/frontend/package.json

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

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/frontend/src/App.vue

@@ -74,7 +74,7 @@ async function loadExamples(): Promise<void> {
 function loadExample(id: string): void {
   const item = examples.value.find((example) => example.id === id)
   if (!item) return
-  importSchema(item.schema)
+  importSchema(item.schema, item.data ?? {})
   ElMessage.success(`已加载示例：${item.title}`)
 }
 
@@ -113,7 +113,7 @@ async function importHtml(): Promise<void> {
   htmlBusy.value = true
   try {
     const result = await api.convertHtml(htmlSource.value)
-    importSchema(result.document)
+    importSchema(result.document, result.data ?? {})
     ElMessage.success(`已转换：${result.fields.length} 个字段`)
     htmlDialog.value = false
   } catch (error) {
@@ -128,7 +128,7 @@ async function onOfficeFile(event: Event, kind: 'docx' | 'xlsx'): Promise<void>
   if (!file) return
   try {
     const result = kind === 'docx' ? await api.convertDocx(file) : await api.convertXlsx(file)
-    importSchema(result.document)
+    importSchema(result.document, result.data ?? {})
     ElMessage.success(`已转换：${result.fields.length} 个字段`)
   } catch (error) {
     ElMessage.error(`转换失败：${(error as Error).message}`)

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/frontend/src/api/client.ts

@@ -27,11 +27,15 @@ export interface ExampleItem {
   variables: number
   blocks: number
   schema: DocumentSchema
+  /** 示例数据（与 schema 分离：schema 不再内嵌 data） */
+  data?: FormData | null
 }
 
 export interface ConvertResponse {
   document: DocumentSchema
   fields: { name: string; label: string; kind: string }[]
+  /** 转换时自动生成的示例数据（与 schema 分离，单独下发） */
+  data?: FormData | null
 }
 
 async function jsonRequest<T>(url: string, init?: RequestInit): Promise<T> {

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/frontend/src/designer/JsonPanel.vue

@@ -17,7 +17,10 @@ watch(() => state.mode, sync)
 
 function applySchema(): void {
   try {
-    importSchema(JSON.parse(schemaText.value) as DocumentSchema)
+    const parsed = JSON.parse(schemaText.value) as DocumentSchema
+    // 配置 JSON 不含数据（data 是运行态）：应用配置时保留当前示例数据，
+    // 否则编辑一下 schema 就顺手把「数据」tab / 右栏里的 mock 清空了。
+    importSchema(parsed, state.sampleData)
     ElMessage.success('页面配置已应用')
     void refreshPreview()
   } catch (error) {

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/frontend/src/fill/FillView.vue

@@ -26,13 +26,13 @@ const margin = computed(() => {
   return boxToPt(raw)
 })
 
-/** 初值：变量默认值 + 示例数据 */
+/** 初值：变量默认值 + 导入时携带的示例数据快照（填表过程中的编辑不回写快照，故「重置」可恢复）。 */
 function initialData(): Record<string, unknown> {
   const out: Record<string, unknown> = {}
   for (const variable of state.schema.variables ?? []) {
     if (variable.default !== undefined && variable.default !== null) out[variable.name] = variable.default
   }
-  return { ...out, ...(state.schema.data ?? {}) }
+  return { ...out, ...(state.sampleData ?? {}) }
 }
 
 const scope = computed(() => buildContext(state.schema, { ...state.data, ...formData }))

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/frontend/src/lib/expand.ts

@@ -10,7 +10,10 @@ export interface ResolvedValue {
   hasValue: boolean
 }
 
-/** 构建作用域：变量默认值 < schema.data < 运行态 data < extra。 */
+/** 构建作用域：变量默认值 < 填写数据 data < extra。
+ *
+ * 配置与数据分离：数据只从 ``data`` 参数进，schema 不携带任何示例/mock 数据。
+ */
 export function buildContext(
   schema: DocumentSchema,
   data?: Record<string, unknown> | null,
@@ -22,7 +25,6 @@ export function buildContext(
       scope[variable.name] = variable.default
     }
   }
-  if (schema.data) Object.assign(scope, schema.data)
   if (data) Object.assign(scope, data)
   if (extra) Object.assign(scope, extra)
   return scope

pdfwright_web-0.2.2/frontend/src/lib/markup.spec.ts

@@ -0,0 +1,58 @@
+import { describe, expect, it } from 'vitest'
+
+import { markupToHtml, plainText } from './markup'
+
+
+describe('plainText', () => {
+  it('剥离内联标记但保留 {{ 变量 }}', () => {
+    expect(plainText('<font color="#000" size="10.5" face="cn-song">一、项目部</font>')).toBe('一、项目部')
+    expect(plainText('{{project_name}}日报')).toBe('{{project_name}}日报')
+    expect(plainText('<b>{{a}}</b> 与 <i>b</i>')).toBe('{{a}} 与 b')
+    expect(plainText('<font face="x">甲<br/>乙</font>')).toBe('甲 乙')
+    expect(plainText(null)).toBe('')
+  })
+})
+
+describe('markupToHtml：安全硬化', () => {
+  it('<a href> 只放行 scheme 白名单（javascript: 被剥成无 href 的 <a>）', () => {
+    const html = markupToHtml('<a href="javascript:alert(1)">坏</a><a href="https://ok.example">好</a>', {
+      mode: 'preview',
+    })
+    expect(html).not.toContain('javascript:')
+    expect(html).toContain('<a>坏</a>')
+    expect(html).toContain('href="https://ok.example"')
+  })
+
+  it('文本转义：未知标签按文本输出，不执行', () => {
+    const html = markupToHtml('<script>alert(1)</script>正文', { mode: 'preview' })
+    expect(html).not.toContain('<script>')
+    expect(html).toContain('&lt;script&gt;')
+  })
+
+  it('未知属性被忽略（onmouseover 无法注入）', () => {
+    const html = markupToHtml('<font color="red" onmouseover="x">甲</font>', { mode: 'preview' })
+    expect(html).not.toContain('onmouseover')
+    expect(html).toContain('color:red')
+  })
+
+  it('字号夹到合法范围（font size 与 span font-size 同规则）', () => {
+    expect(markupToHtml('<font size="5000">甲</font>', { mode: 'preview' })).toContain(
+      'font-size:500pt',
+    )
+    expect(markupToHtml('<font size="0.0001">甲</font>', { mode: 'preview' })).toContain(
+      'font-size:1pt',
+    )
+    expect(
+      markupToHtml('<span style="font-size:9999pt;color:red">甲</span>', { mode: 'preview' }),
+    ).toContain('font-size:500pt')
+  })
+
+  it('占位符值按文本转义（预览态值不成为标记）', () => {
+    const html = markupToHtml('{{ v }}', {
+      mode: 'preview',
+      scope: { v: '<b>注入</b>' },
+    })
+    expect(html).not.toContain('<b>')
+    expect(html).toContain('&lt;b&gt;注入&lt;/b&gt;')
+  })
+})

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/frontend/src/lib/markup.ts

@@ -39,6 +39,9 @@ const SAFE_CSS_PROPS = new Set([
   'text-decoration',
 ])
 const SAFE_URL_SCHEMES = ['http://', 'https://', 'mailto:', '/', '#']
+// 内联标记字号范围（pt）：与后端 `render/markup.py` 同值，挡住 `size="5000"` 这类病态值
+const MIN_MARKUP_FONT_SIZE = 1
+const MAX_MARKUP_FONT_SIZE = 500
 const TAG_RE = /<(\/?)([a-zA-Z][a-zA-Z0-9]*)((?:\s[^<>]*)?)(\/?)>/g
 const ATTR_RE = /([a-zA-Z-]+)\s*=\s*"([^"]*)"/g
 const PLACEHOLDER_RE = /\{\{\s*([A-Za-z_][A-Za-z0-9_.\]]*)\s*\}\}/g
@@ -78,6 +81,20 @@ function escapeHtml(value: string): string {
     .replace(/"/g, '&quot;')
 }
 
+/** 字号夹到合法范围（与后端 `clamp_font_size` 同规则）。 */
+function clampFontSize(size: number): number {
+  return Math.min(Math.max(size, MIN_MARKUP_FONT_SIZE), MAX_MARKUP_FONT_SIZE)
+}
+
+/** CSS `font-size` 的数值部分夹到合法范围（保留原单位）。 */
+function clampCssFontSize(value: string): string {
+  const match = /^\s*(-?[\d.]+)/.exec(value)
+  if (!match) return value
+  const size = Number(match[1])
+  if (!Number.isFinite(size)) return value
+  return `${clampFontSize(size)}${value.slice(match[0].trimEnd().length)}`
+}
+
 /** 占位符显示名：绝对路径里的数组下标压缩成 `[]`（person.0.person.0.name → person[].person[].name）。 */
 export function displayName(name: string): string {
   return name.replace(/\.\d+(?=\.|$)/g, '[]')
@@ -135,7 +152,8 @@ export function markupToHtml(markup: string | null | undefined, options: MarkupO
       const parsed = parseStyleAttr(attrsOf(match[3] ?? '').style ?? '')
       const styles: string[] = []
       for (const [prop, value] of Object.entries(parsed)) {
-        if (SAFE_CSS_PROPS.has(prop)) styles.push(`${prop}:${value}`)
+        if (!SAFE_CSS_PROPS.has(prop)) continue
+        styles.push(`${prop}:${prop === 'font-size' ? clampCssFontSize(value) : value}`)
       }
       parts.push(styles.length ? `<span style="${styles.join(';')}">` : '<span>')
     } else if (PASSTHROUGH_TAGS[tag]) {
@@ -146,7 +164,7 @@ export function markupToHtml(markup: string | null | undefined, options: MarkupO
       const family = attrs.face ? fontFamilyCss(attrs.face) : undefined
       if (family) styles.push(`font-family:${family}`)
       const size = Number(attrs.size)
-      if (Number.isFinite(size) && size > 0) styles.push(`font-size:${size}pt`)
+      if (Number.isFinite(size)) styles.push(`font-size:${clampFontSize(size)}pt`)
       if (attrs.color) styles.push(`color:${attrs.color}`)
       if (attrs.backcolor) styles.push(`background-color:${attrs.backcolor}`)
       const spacing = Number(attrs.spacing)

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/frontend/src/store/designer.spec.ts

@@ -25,6 +25,7 @@ import {
   duplicateSelected,
   ensureDrop,
   exportSchema,
+  importSchema,
   moveSelected,
   moveNodeTo,
   removeSelected,
@@ -68,6 +69,7 @@ function reset(): void {
   state.selectedId = null
   state.components = { groups: [], components: [headingMeta, sectionMeta], styleProps: [], fontSizes: { cn: [] }, pageSizes: [], fontFamilies: [] }
   state.data = {}
+  state.sampleData = {}
   state.issues = []
   state.history = []
   state.historyIndex = -1
@@ -545,3 +547,38 @@ describe('档案模板预设 / 变量自动补全', () => {
     expect(syncVariables()).toBe(0)
   })
 })
+
+describe('导入导出：配置只服务渲染', () => {
+  beforeEach(() => {
+    reset()
+    vi.spyOn(api, 'validateDocument').mockResolvedValue({ ok: true, issues: [] })
+  })
+
+  it('导出的页面配置不含 data（配置与数据分离）', () => {
+    const exported = exportSchema()
+    expect('data' in exported).toBe(false)
+    expect(JSON.stringify(exported)).not.toContain('"data"')
+  })
+
+  it('导入无 pdf 节的配置时 PDF/A 档位落地为默认 2b', () => {
+    importSchema({ version: '1.0', body: [{ type: 'paragraph', text: '正文' }] }, { a: 1 })
+    expect(exportSchema().pdf?.pdfa).toBe('2b')
+    // 示例数据与配置分离：只进运行态，供设计器内 mock 预览
+    expect(state.data).toEqual({ a: 1 })
+    expect(state.sampleData).toEqual({ a: 1 })
+    expect('data' in exportSchema()).toBe(false)
+  })
+
+  it('导入显式 pdfa=false 时不被默认值覆盖', () => {
+    importSchema({ version: '1.0', body: [], pdf: { pdfa: false, numericFont: 'serif' } })
+    const pdf = exportSchema().pdf
+    expect(pdf?.pdfa).toBe(false)
+    expect(pdf?.numericFont).toBe('serif')
+  })
+
+  it('不传 data 时运行态数据为空对象', () => {
+    importSchema({ version: '1.0', body: [] })
+    expect(state.data).toEqual({})
+    expect(state.sampleData).toEqual({})
+  })
+})

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/frontend/src/store/designer.ts

@@ -62,6 +62,8 @@ export const DEFAULT_SCHEMA: DocumentSchema = {
 interface DesignerState {
   schema: DocumentSchema
   data: FormData
+  /** 导入/转换带来的示例数据快照（填写态「重置」的不可变初值；不进 schema、不导出） */
+  sampleData: FormData
   selectedId: string | null
   components: ComponentsPayload | null
   fonts: string[]
@@ -86,6 +88,7 @@ interface DesignerState {
 export const state = reactive<DesignerState>({
   schema: deepClone(DEFAULT_SCHEMA),
   data: {},
+  sampleData: {},
   selectedId: null,
   components: null,
   fonts: [],
@@ -987,6 +990,11 @@ export function setDataValue(name: string, value: unknown): void {
 }
 
 // ---- 导入导出 ----
+/** 导出「页面配置」：只服务 PDF / 页面渲染。
+ *
+ * schema 本身就不含示例/mock 数据（配置与数据分离，见 ``importSchema``）：这里只剔除
+ * 编辑器内部使用的 ``_id``。设计器的 mock 数据存在运行态 ``state.data``，不随配置分发。
+ */
 export function exportSchema(): DocumentSchema {
   return {
     ...state.schema,
@@ -994,16 +1002,22 @@ export function exportSchema(): DocumentSchema {
   }
 }
 
-export function importSchema(schema: DocumentSchema): void {
+/** 导入页面配置。``data`` 是与配置**分离**的示例/填写数据（缺省为空），不会写进 schema。 */
+export function importSchema(schema: DocumentSchema, data?: FormData | null): void {
   state.schema = {
     ...schema,
+    // PDF/A 档位显式落地：属性面板在 `pdf` 缺失时会 UI 兜底显示 2b
+    // （PropsPanel.pdfaLevel），若 JSON 不写出来，「标准」就只存在于隐式默认里
+    // （导出看不到、与后端 effective_pdf_options 的默认也可能悄悄分叉）。
+    pdf: { pdfa: '2b', ...(schema.pdf ?? {}) },
     body: schema.body ?? [],
     variables: schema.variables ?? [],
   }
   ensureIds(state.schema.body)
   state.selectedId = null
-  // 导入的配置常自带示例数据（如 Word/Excel 转换结果）——保留它，预览才有内容
-  state.data = schema.data ? deepClone(schema.data) : {}
+  // 示例数据（Word/Excel/HTML 转换器或示例文件带来）与配置分离：只进运行态，供预览使用
+  state.sampleData = deepClone(data ?? {})
+  state.data = deepClone(state.sampleData)
   pushHistory()
   void refreshPreview()
 }

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/frontend/src/types/schema.ts

@@ -169,7 +169,7 @@ export interface DocumentSchema {
   page?: PageConfig
   variables?: VariableDecl[]
   body?: ElementNode[]
-  data?: Record<string, unknown>
+  // 配置与数据分离：schema **不含 data**（示例/mock 数据是运行态 state.data，渲染时单独传）
   html?: Record<string, unknown>
   pdf?: Record<string, unknown>
   meta?: Record<string, unknown>

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 # CLI: pdfwright-web --port 8765
 name = "pdfwright-web"
-version = "0.2.1"
+version = "0.2.2"
 description = "pdfwright 的无状态 Web 服务：可视化配置编辑器 + HTML/PDF 预览 + 对外渲染 API（不存储任何数据与内容）"
 readme = "README.md"
 requires-python = ">=3.12"

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/src/pdfwright_web/__init__.py

@@ -6,4 +6,4 @@
 from pdfwright_web.app import app, create_app, main
 
 __all__ = ["app", "create_app", "main"]
-__version__ = "0.2.1"
+__version__ = "0.2.2"

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/src/pdfwright_web/app.py

@@ -100,7 +100,7 @@ def create_app() -> FastAPI:
     """构建 FastAPI 应用。"""
     app = FastAPI(
         title="pdfwright-web",
-        version="0.2.1",
+        version="0.2.2",
         description="配置驱动的 PDF 渲染服务（无状态）：schema + data → PDF / HTML / 校验",
     )
     app.add_middleware(

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/src/pdfwright_web/routers/convert.py

@@ -86,6 +86,7 @@ async def convert_docx(file: UploadFile = File(...)) -> ConvertResponse:
     return ConvertResponse(
         document=with_service_security(result.document).to_dict(),
         fields=[{"name": f.name, "label": f.label, "kind": f.kind} for f in result.fields],
+        data=result.data,
     )
 
 
@@ -124,6 +125,7 @@ async def convert_html(payload: HtmlConvertRequest) -> ConvertResponse:
     return ConvertResponse(
         document=result.document.to_dict(),
         fields=[{"name": f.name, "label": f.label, "kind": f.kind} for f in result.fields],
+        data=result.data,
     )
 
 
@@ -139,4 +141,5 @@ async def convert_html_file(file: UploadFile = File(...)) -> ConvertResponse:
     return ConvertResponse(
         document=with_service_security(result.document).to_dict(),
         fields=[{"name": f.name, "label": f.label, "kind": f.kind} for f in result.fields],
+        data=result.data,
     )

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/src/pdfwright_web/routers/examples.py

@@ -76,6 +76,10 @@ def _load_examples(directory: str) -> dict[str, Any]:
         except (OSError, json.JSONDecodeError):
             continue
         meta = schema.get("meta") or {}
+        # 示例文件为了「单文件即完整演示」把 data 写在同一个 JSON 里；
+        # 但配置与数据分离 —— 对外只把 schema（不含 data）与 data 分开下发。
+        data = schema.get("data") if isinstance(schema.get("data"), dict) else None
+        schema = {k: v for k, v in schema.items() if k != "data"}
         items.append(
             {
                 "id": path.stem,
@@ -84,6 +88,7 @@ def _load_examples(directory: str) -> dict[str, Any]:
                 "variables": len(schema.get("variables") or []),
                 "blocks": len(schema.get("body") or []),
                 "schema": schema,
+                "data": data,
             }
         )
     return {"examples": items, "count": len(items)}

{pdfwright_web-0.2.1 → pdfwright_web-0.2.2}/src/pdfwright_web/schemas.py

@@ -4,16 +4,24 @@ from __future__ import annotations
 
 from typing import Any
 
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, field_validator
 
 
 class RenderRequest(BaseModel):
-    """渲染请求：schema + 填写数据。"""
+    """渲染请求：schema + 填写数据（**配置与数据分离**）。"""
 
     document: dict[str, Any] = Field(..., description="页面 JSON 配置（schema）")
-    data: dict[str, Any] | None = Field(default=None, description="表单填写数据（独立于 schema）")
+    data: dict[str, Any] = Field(
+        default_factory=dict, description="表单填写数据（独立于 schema；缺省为空对象）"
+    )
     filename: str | None = Field(default=None, description="下载文件名（PDF）")
 
+    @field_validator("data", mode="before")
+    @classmethod
+    def _none_to_empty(cls, value: Any) -> Any:
+        """未传 / 传 null 一律视为空对象（缺失数据等价于空数据）。"""
+        return value or {}
+
 
 class ValidateRequest(BaseModel):
     """校验请求。"""
@@ -50,9 +58,11 @@ class OptionsFetchResponse(BaseModel):
 class ConvertResponse(BaseModel):
     """文档转换响应：返回可直接用于编辑器的 schema。
 
-    ``warnings`` = 源文件里有、但本次转换没能搬过来的特性（不静默丢弃）。
+    ``data`` 是与配置分离的**示例数据**（不是 schema 字段）；``warnings`` = 源文件里有、
+    但本次转换没能搬过来的特性（不静默丢弃）。
     """
 
     document: dict[str, Any]
     fields: list[dict[str, Any]] = []
     warnings: list[str] = []
+    data: dict[str, Any] | None = None