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

pdfwright_web-0.2.1/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+bandit-report.json
+
+# Node / 前端
+node_modules/
+pdfwright-web/frontend/dist/
+pdfwright-web/frontend/.vite/
+
+# 前端构建产物（由 pdfwright-web 构建时生成，不入库；构建命令见 README）
+pdfwright-web/src/pdfwright_web/static/
+
+# 示例生成的输出文件
+pdfwright/examples/output/
+
+# 其它
+.DS_Store
+*.log
+.idea/
+.vscode/
+
+# 本地发布凭据（scripts/publish.sh --config 默认读它）
+.publish.env

pdfwright_web-0.2.1/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.5
+Name: pdfwright-web
+Version: 0.2.1
+Summary: pdfwright 的无状态 Web 服务：可视化配置编辑器 + HTML/PDF 预览 + 对外渲染 API（不存储任何数据与内容）
+License: Proprietary
+Requires-Python: >=3.12
+Requires-Dist: fastapi>=0.115
+Requires-Dist: pdfwright>=0.2.1
+Requires-Dist: pydantic>=2.9
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: uvicorn>=0.30
+Description-Content-Type: text/markdown
+
+# pdfwright-web — 无状态 Web 服务
+
+为 pdfwright 提供的配置 / 预览 / 对外渲染服务：
+
+- **不存储任何数据与内容**（无数据库、无文件持久化），外部传入 JSON，回传 PDF / HTML / 校验结果。
+- 提供可视化配置编辑器（Vue3 + TS + Element Plus 前端，构建产物内嵌于本包）。
+- 依赖基础库 [`pdfwright`](../pdfwright/)。
+
+## 启动
+
+```bash
+uv run uvicorn pdfwright_web.app:app --host 0.0.0.0 --port 8765
+```
+
+## API（骨架规划）
+
+| 方法 | 路径 | 说明 |
+|---|---|---|
+| POST | /api/validate | schema 校验（返回错误列表） |
+| POST | /api/render/html | schema + data → HTML 预览 |
+| POST | /api/render/pdf | schema + data → PDF 二进制 |
+| GET | /api/meta/components | 组件注册表（编辑器调色板/属性面板驱动） |
+| POST | /api/options/fetch | 接口选项代理（动态下拉，解决 CORS） |
+| POST | /api/convert/docx | DOCX → schema（高保真 + 自动字段 key） |
+| POST | /api/convert/xlsx | Excel → schema |
+
+详细实现见后续迭代（当前为骨架）。

pdfwright_web-0.2.1/README.md

@@ -0,0 +1,27 @@
+# pdfwright-web — 无状态 Web 服务
+
+为 pdfwright 提供的配置 / 预览 / 对外渲染服务：
+
+- **不存储任何数据与内容**（无数据库、无文件持久化），外部传入 JSON，回传 PDF / HTML / 校验结果。
+- 提供可视化配置编辑器（Vue3 + TS + Element Plus 前端，构建产物内嵌于本包）。
+- 依赖基础库 [`pdfwright`](../pdfwright/)。
+
+## 启动
+
+```bash
+uv run uvicorn pdfwright_web.app:app --host 0.0.0.0 --port 8765
+```
+
+## API（骨架规划）
+
+| 方法 | 路径 | 说明 |
+|---|---|---|
+| POST | /api/validate | schema 校验（返回错误列表） |
+| POST | /api/render/html | schema + data → HTML 预览 |
+| POST | /api/render/pdf | schema + data → PDF 二进制 |
+| GET | /api/meta/components | 组件注册表（编辑器调色板/属性面板驱动） |
+| POST | /api/options/fetch | 接口选项代理（动态下拉，解决 CORS） |
+| POST | /api/convert/docx | DOCX → schema（高保真 + 自动字段 key） |
+| POST | /api/convert/xlsx | Excel → schema |
+
+详细实现见后续迭代（当前为骨架）。

pdfwright_web-0.2.1/frontend/env.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="vite/client" />
+
+declare module '*.vue' {
+  import type { DefineComponent } from 'vue'
+  const component: DefineComponent<Record<string, unknown>, Record<string, unknown>, unknown>
+  export default component
+}
+
+declare module 'nunjucks' {
+  export interface Environment {
+    render(template: string, context: Record<string, unknown>): string
+    renderString(template: string, context: Record<string, unknown>): string
+    addFilter(name: string, fn: (...args: unknown[]) => unknown): void
+    options: { autoescape: boolean }
+  }
+  export function configure(options: Record<string, unknown>): Environment
+  export class Template {
+    constructor(src: string, env?: Environment, path?: string)
+    render(context?: Record<string, unknown>): string
+  }
+}

pdfwright_web-0.2.1/frontend/eslint.config.js

@@ -0,0 +1,40 @@
+// ESLint 9 flat config：Vue 3 + TypeScript（项目红线要求 ESLint 强制通过）
+import js from '@eslint/js'
+import tseslint from 'typescript-eslint'
+import pluginVue from 'eslint-plugin-vue'
+
+export default tseslint.config(
+  { ignores: ['dist/**', 'node_modules/**', '../src/pdfwright_web/static/**'] },
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  ...pluginVue.configs['flat/recommended'],
+  {
+    files: ['**/*.vue'],
+    languageOptions: {
+      parserOptions: { parser: tseslint.parser },
+    },
+    rules: {
+      // TS 已由 vue-tsc 做未定义变量检查（typescript-eslint 官方建议关闭 no-undef）；
+      // eslint-plugin-vue v10 起不再为 .vue 注入 browser globals，故此处显式关闭。
+      'no-undef': 'off',
+    },
+  },
+  {
+    rules: {
+      // 单文件组件名与模板属性顺序不做强制，避免与既有代码风格冲突
+      'vue/multi-word-component-names': 'off',
+      'vue/attributes-order': 'off',
+      'vue/max-attributes-per-line': 'off',
+      'vue/singleline-html-element-content-newline': 'off',
+      'vue/html-self-closing': 'off',
+      'vue/html-indent': 'off',
+      // 新版 core 规则不认识 Vue 模板里的使用（computed/常量只在模板引用）→ 误报
+      'no-useless-assignment': 'off',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-explicit-any': 'warn',
+      // v-html 只用于 markupToHtml 的输出：除白名单标签外全部转义，且属性来自
+      // 我们自己的 schema（非用户 HTML 输入），因此不存在注入面
+      'vue/no-v-html': 'off',
+    },
+  },
+)

pdfwright_web-0.2.1/frontend/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>pdfwright 可视化页面设计器</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

pdfwright_web-0.2.1/frontend/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "pdfwright-designer",
+  "private": true,
+  "version": "0.2.1",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vue-tsc --noEmit && vite build",
+    "build:only": "vite build",
+    "typecheck": "vue-tsc --noEmit",
+    "lint:check": "eslint .",
+    "lint": "eslint . --fix",
+    "format": "prettier --write src",
+    "preview": "vite preview",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@element-plus/icons-vue": "^2.3.2",
+    "element-plus": "^2.14.6",
+    "nunjucks": "^3.2.4",
+    "vue": "^3.5.43",
+    "vuedraggable": "^4.1.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@tailwindcss/vite": "^4.3.3",
+    "@types/node": "^26.6.2",
+    "@types/nunjucks": "^3.2.6",
+    "@vitejs/plugin-vue": "^6.0.9",
+    "@vue/server-renderer": "^3.5.43",
+    "eslint": "^10.11.0",
+    "eslint-plugin-vue": "^10.11.0",
+    "prettier": "^3.9.8",
+    "tailwindcss": "^4.3.3",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.70.0",
+    "vite": "^8.3.0",
+    "vitest": "^5.0.1",
+    "vue-eslint-parser": "^10.4.1",
+    "vue-tsc": "^3.3.11"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  }
+}