@worm-vue3-print/common 0.0.0-stage → 1.3.7-beta.0

package/dist/shell/prop-group.d.ts

@@ -0,0 +1,11 @@
+/*!
+ * @worm-vue3-print/common v1.3.7-beta.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+import type { El } from '../core/h';
+import type { ShellCtx } from './controls';
+export declare function group(ctx: ShellCtx, key: string, title: string, icon: string, rows: unknown[], defaultExpanded?: boolean): El;
+/** 表单壳：canvas 各分组内容恒为 form.pd-form 且屏蔽回车提交 */
+export declare function pdForm(children: unknown[]): El;

package/dist/shell/property-panel.d.ts

@@ -0,0 +1,14 @@
+/*!
+ * @worm-vue3-print/common v1.3.7-beta.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+import type { ShellCtx } from './controls';
+/** 下拉属性行 */
+/** 下拉属性行（导出仅供单测断言未设置态，包公开入口不导出） */
+export declare function selectField(_ctx: ShellCtx, label: string, value: string, options: {
+    value: string;
+    label: string;
+}[], onCommit: (v: string) => void, tip?: string): import("../core/h").El;
+export declare function renderPropertyPanel(ctx: ShellCtx): import("../core/h").El;

package/dist/shell/property-search.d.ts

@@ -0,0 +1,32 @@
+/*!
+ * @worm-vue3-print/common v1.3.7-beta.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+import type { El } from '../core/h';
+import type { ShellCtx } from './controls';
+export interface PropertySearchResult {
+    groups: string[];
+    keys: Set<string>;
+    searching: boolean;
+}
+/** 命中结果（按关键字缓存：一次重绘要问几十次，避免重复扫描注册表） */
+export declare function propertySearch(text?: string): PropertySearchResult;
+/** 该分组是否受搜索门控：不在注册表内的分组（行属性/单元格）恒显示 */
+export declare function searchGroupOf(groupKey: string): string;
+/** 对应 canvas 各分组的 `v-if="filteredGroups.includes(key)"` */
+export declare function showGroup(ctx: ShellCtx, groupKey: string): boolean;
+/** 对应 canvas 分组内的 `v-show="showItem(key)"` */
+export declare function showItem(ctx: ShellCtx, itemKey: string): boolean;
+/** 字段门控：挂 data-prop-key（供输入时定点更新）+ 按搜索态决定显隐 */
+export declare function gateItem(ctx: ShellCtx, itemKey: string, node: El): El;
+/** 分组门控标记：挂 data-prop-group 并给出是否显示 */
+export declare function gateGroup(ctx: ShellCtx, groupKey: string, node: El): El;
+/**
+ * 定点重放：搜索框输入时只切显隐，不整体重绘；外壳 paint() 末尾同样调用它，
+ * 保证重绘后的 DOM 与当前过滤词一致。
+ */
+export declare function applyPropertySearch(root: ParentNode, text?: string): void;
+/** 搜索框：canvas 的 PropertySearch.vue 等价物（类名与结构逐字一致） */
+export declare function renderPropertySearch(ctx: ShellCtx): El;

package/dist/shell/ruler.d.ts

@@ -0,0 +1,29 @@
+/*!
+ * @worm-vue3-print/common v1.3.7-beta.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+/** 设计区视口几何（与 CanvasArea.vue 的 rulerGeom 同构） */
+export interface RulerGeom {
+    /** 纸张 0mm 点相对横尺起点的屏幕偏移（已扣除尺条厚度） */
+    originX: number;
+    /** 纸张 0mm 点相对竖尺起点的屏幕偏移 */
+    originY: number;
+    /** 横尺可见长度（屏幕 px） */
+    viewW: number;
+    /** 竖尺可见长度（屏幕 px） */
+    viewH: number;
+    /** 纸张当前缩放（1 = 100%） */
+    paperScale: number;
+}
+export interface RulerOptions {
+    orientation: 'horizontal' | 'vertical';
+    geom: RulerGeom;
+    /** 纸张该方向长度（mm），用于边界标记与纸外淡化范围 */
+    paperLengthMM: number;
+    scale: number;
+    /** 鼠标在尺条轴向上的位置（屏幕 px） */
+    cursorPx?: number | null;
+}
+export declare function drawRuler(canvas: HTMLCanvasElement, opts: RulerOptions): void;

package/dist/shell/table-props.d.ts

@@ -0,0 +1,17 @@
+/*!
+ * @worm-vue3-print/common v1.3.7-beta.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+import type { RuntimeElement } from '@worm-vue3-print/core/designer';
+import type { El } from '../core/h';
+import type { ShellCtx } from './controls';
+/** 行属性：行类型 / 行高 / 表头每页重复（作用于整个表头区） */
+export declare function tableRowGroup(ctx: ShellCtx, el: RuntimeElement): El;
+/** 表格设置：列表数据源、表格级默认样式、逐列列宽 */
+export declare function tableSettingsGroup(ctx: ShellCtx, el: RuntimeElement): El;
+/** 分页配置：表格元素只有「启用分页」，非表格元素为「参与分页 / 与下元素同页」 */
+export declare function paginationGroup(ctx: ShellCtx, el: RuntimeElement): El;
+/** 单元格：内容类型与码制 / 内容表达式 / 样式 / 边框 / 合并拆分（作用于整个选区） */
+export declare function tableCellGroup(ctx: ShellCtx, el: RuntimeElement): El;

package/dist/shell/table.d.ts

@@ -0,0 +1,22 @@
+/*!
+ * @worm-vue3-print/common v1.3.7-beta.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+import type { RuntimeElement } from '@worm-vue3-print/core/designer';
+import type { DesignerStore } from '../core/store';
+import type { El } from '../core/h';
+export interface TableFire {
+    (action: string, arg?: unknown): void;
+}
+/** 表格右键菜单可见状态：由外层持有并逐帧传给 renderTableContextMenu */
+export interface TableMenuState {
+    visible: boolean;
+    x: number;
+    y: number;
+}
+export declare function renderTableContextMenu(store: DesignerStore, fire: TableFire, menu: TableMenuState): El | '';
+/** 强制解除列宽拖拽监听（宿主 disconnectedCallback 可用） */
+export declare function abortTableColResize(): void;
+export declare function renderTable(el: RuntimeElement, store: DesignerStore, fire: TableFire): El;

package/dist/shell/toolbar-overflow.d.ts

@@ -0,0 +1,28 @@
+/*!
+ * @worm-vue3-print/common v1.3.7-beta.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+import type { ShellCtx } from './controls';
+export declare const TOOLBAR_OVERFLOW_GAP = 2;
+/** 「更多」触发钮占位宽，与 CSS 侧 .tb-dd-trigger 的 padding + 文字 + 箭头对齐 */
+export declare const MORE_TRIGGER_WIDTH = 74;
+export interface ToolbarUnitDef {
+    id: string;
+    /** 数值小者先被收进「更多」 */
+    order: number;
+    /** 面板内分组标题 */
+    label: string;
+}
+/** 收纳优先级链：与 canvas 的 DesignerToolbar / FormatToolbar 声明逐条对应 */
+export declare const TOOLBAR_UNITS: ToolbarUnitDef[];
+/**
+ * 「更多」分组节点：触发钮 + 常驻面板（收起时 .is-hidden，不能用条件渲染，
+ * 否则落位槽不存在，被收纳的单元会退回行内显示）。
+ */
+export declare function renderMoreGroup(ctx: ShellCtx): import("../core/h").El;
+export declare function applyToolbarOverflow(scope: ParentNode): {
+    movedIds: string[];
+    overflowRemains: boolean;
+};

package/dist/shell/toolbar.d.ts

@@ -0,0 +1,8 @@
+/*!
+ * @worm-vue3-print/common v1.3.7-beta.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+import type { ShellCtx } from './controls';
+export declare function renderToolbar(ctx: ShellCtx, formatSection: unknown): import("../core/h").El;

package/dist/shell/watermark.d.ts

@@ -0,0 +1,10 @@
+/*!
+ * @worm-vue3-print/common v1.3.7-beta.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+import type { ShellCtx } from './controls';
+/** 与 canvas 的 isExpressionText 同判定：花括号 / 函数调用 / 字段路径视为表达式 */
+export declare function isExpressionText(text: string): boolean;
+export declare function watermarkSection(ctx: ShellCtx): import("../core/h").El;

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@worm-vue3-print/common",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.3.7-beta.0",
+  "type": "module",
+  "description": "【预览版 · 实验性，不建议用于生产】打印模板设计器的通用宿主适配包：任意框架或无框架宿主均可直接接入（实现为零框架原生 Custom Elements + Shadow DOM），零 Vue/React 依赖，直接消费 @worm-vue3-print/core；Vue 3 项目请使用 @worm-vue3-print/canvas",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./browser": {
+      "types": "./dist/browser-bundle.d.ts",
+      "default": "./dist/common.js"
+    },
+    "./style.css": "./dist/common.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "author": "worm <liu_long_qqcom@qq.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitee.com/liulong_oschina/worm-vue3-print.git"
+  },
+  "readme": "README.md",
+  "keywords": [
+    "print",
+    "template",
+    "designer",
+    "web-components",
+    "custom-elements",
+    "framework-agnostic"
+  ],
+  "scripts": {
+    "styles": "node scripts/gen-styles.mjs && node scripts/gen-icons.mjs",
+    "build": "npm run styles && vite build && vite build -c vite.bundle.config.ts && tsc -p tsconfig.build.json && node ../../scripts/inject-license-banner.mjs dist",
+    "dev": "npm run styles && vite build --watch",
+    "typecheck": "npm run styles && tsc -p tsconfig.json --noEmit",
+    "test": "npm run styles && vitest run"
+  },
+  "dependencies": {
+    "@worm-vue3-print/core": "^1.3.7",
+    "dompurify": "^3.4.12",
+    "jsbarcode": "^3.12.3",
+    "qrcode": "^1.5.4"
+  },
+  "devDependencies": {
+    "@types/qrcode": "^1.5.6",
+    "happy-dom": "^20.10.6",
+    "typescript": "~5.9.3",
+    "vite": "^7.3.6",
+    "vitest": "^1.6.0"
+  }
+}