@xtctwins/tctwins-pdf-core 0.1.0

package/dist/utils/EventTrigger.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 事件触发器 — 工具间通信机制
+ * 参考 dxf-viewer/src/Mechanism/EventTrigger.js
+ *
+ * 泛型设计：通过 EventMap 约束事件名和回调参数类型
+ *
+ * 使用方式：
+ *   const events = new EventTrigger<MeasureEvents>();
+ *   events.on("measure_start", () => console.log("started"));
+ *   events.emit("measure_start");
+ *   events.off("measure_start", handler);
+ */
+export declare class EventTrigger<EventMap extends Record<keyof EventMap, (...args: any[]) => void> = any> {
+    private _events;
+    /**
+     * 订阅事件
+     * @returns 传入的 listener（便于保存引用后取消订阅）
+     */
+    on<K extends keyof EventMap & string>(event: K, listener: EventMap[K]): EventMap[K];
+    /**
+     * 只订阅一次（触发后自动取消）
+     */
+    once<K extends keyof EventMap & string>(event: K, listener: EventMap[K]): void;
+    /**
+     * 取消订阅
+     */
+    off<K extends keyof EventMap & string>(event: K, listener: EventMap[K]): void;
+    /**
+     * 触发事件
+     */
+    emit<K extends keyof EventMap & string>(event: K, ...args: Parameters<EventMap[K]>): void;
+    /**
+     * 移除指定事件的所有监听器
+     */
+    removeAllListeners<K extends keyof EventMap & string>(event?: K): void;
+    /**
+     * 获取事件监听器数量
+     */
+    listenerCount<K extends keyof EventMap & string>(event: K): number;
+    /**
+     * 销毁，清除所有事件
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=EventTrigger.d.ts.map

package/dist/utils/EventTrigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventTrigger.d.ts","sourceRoot":"","sources":["../../src/utils/EventTrigger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qBAAa,YAAY,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,GAAG,GAAG;IAChG,OAAO,CAAC,OAAO,CAAsD;IAErE;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAUnF;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,QAAQ,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAQ9E;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAY7E;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,QAAQ,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAazF;;OAEG;IACH,kBAAkB,CAAC,CAAC,SAAS,MAAM,QAAQ,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAQtE;;OAEG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,QAAQ,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;IAIlE;;OAEG;IACH,OAAO,IAAI,IAAI;CAGf"}

package/dist/vue/index.d.ts

@@ -0,0 +1,2 @@
+export { usePdfCore, type UsePdfCoreOptions, type UsePdfCoreResult } from "./usePdfCore";
+//# sourceMappingURL=index.d.ts.map

package/dist/vue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/vue/plugin.d.ts

@@ -0,0 +1,5 @@
+import type { App } from "vue";
+import PdfViewer from "../components/PdfViewer.vue";
+export declare function installPdfCore(app: App): void;
+export { PdfViewer };
+//# sourceMappingURL=plugin.d.ts.map

package/dist/vue/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/vue/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,SAAS,MAAM,6BAA6B,CAAC;AAEpD,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAE7C;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/vue/useAnnotations.d.ts

@@ -0,0 +1,12 @@
+import { type Ref } from "vue";
+import type { AnnotationItem, PointLike } from "../types/annotations";
+export interface UseAnnotationsResult {
+    annotations: Ref<AnnotationItem[]>;
+    addMeasureAnnotation: (points: PointLike[], value?: number, unit?: string) => void;
+    addShapeAnnotation: (points: PointLike[], shapeType?: "rectangle" | "circle" | "polygon" | "freehand") => void;
+    removeAnnotation: (id: string) => void;
+    clearAnnotations: () => void;
+    replaceAnnotations: (items: AnnotationItem[]) => void;
+}
+export declare function useAnnotations(): UseAnnotationsResult;
+//# sourceMappingURL=useAnnotations.d.ts.map

package/dist/vue/useAnnotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnnotations.d.ts","sourceRoot":"","sources":["../../src/vue/useAnnotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtE,MAAM,WAAW,oBAAoB;IACpC,WAAW,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;IACnC,oBAAoB,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnF,kBAAkB,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,KAAK,IAAI,CAAC;IAC/G,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,kBAAkB,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;CACtD;AAED,wBAAgB,cAAc,IAAI,oBAAoB,CA+BrD"}

package/dist/vue/useInteraction.d.ts

@@ -0,0 +1,13 @@
+import { type Ref } from "vue";
+import type { PointLike } from "../types/annotations";
+export interface UseInteractionResult {
+    points: Ref<PointLike[]>;
+    annotations: Ref<any[]>;
+    isMeasuring: Ref<boolean>;
+    startMeasure: () => void;
+    addPoint: (point: PointLike) => void;
+    finishMeasure: (label?: string) => void;
+    clear: () => void;
+}
+export declare function useInteraction(): UseInteractionResult;
+//# sourceMappingURL=useInteraction.d.ts.map

package/dist/vue/useInteraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInteraction.d.ts","sourceRoot":"","sources":["../../src/vue/useInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAItD,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IACzB,WAAW,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IACxB,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1B,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAgB,cAAc,IAAI,oBAAoB,CA0CrD"}

package/dist/vue/useMeasurement.d.ts

@@ -0,0 +1,10 @@
+import { type Ref } from "vue";
+import type { PointLike } from "../types/annotations";
+export interface UseMeasurementResult {
+    points: Ref<PointLike[]>;
+    addPoint: (point: PointLike) => void;
+    clearPoints: () => void;
+    distance: Ref<number>;
+}
+export declare function useMeasurement(): UseMeasurementResult;
+//# sourceMappingURL=useMeasurement.d.ts.map

package/dist/vue/useMeasurement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMeasurement.d.ts","sourceRoot":"","sources":["../../src/vue/useMeasurement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACtB;AAED,wBAAgB,cAAc,IAAI,oBAAoB,CAuBrD"}

package/dist/vue/usePdfCore.d.ts

@@ -0,0 +1,28 @@
+import { type Ref } from "vue";
+import type { PDFDocumentProxy, PDFPageProxy } from "pdfjs-dist";
+import { EventTrigger } from "../utils/EventTrigger";
+import type { PdfCoreEventMap } from "../types/core";
+export interface UsePdfCoreOptions {
+    autoLoad?: boolean;
+    scale?: number;
+    /** CSS 颜色字符串，作为 PDF 页面渲染背景 */
+    backgroundColor?: string;
+}
+export interface UsePdfCoreResult {
+    containerRef: Ref<HTMLElement | null>;
+    doc: Ref<PDFDocumentProxy | null>;
+    page: Ref<PDFPageProxy | null>;
+    pageCount: Ref<number>;
+    currentPageNum: Ref<number>;
+    currentScale: Ref<number>;
+    isLoading: Ref<boolean>;
+    error: Ref<string | null>;
+    /** PDF 核心事件触发器 */
+    events: EventTrigger<PdfCoreEventMap>;
+    loadFile: (source: File | ArrayBuffer) => Promise<void>;
+    renderCurrentPage: () => Promise<void>;
+    setScale: (scale: number) => Promise<void>;
+    reset: () => void;
+}
+export declare function usePdfCore(options?: UsePdfCoreOptions): UsePdfCoreResult;
+//# sourceMappingURL=usePdfCore.d.ts.map

package/dist/vue/usePdfCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePdfCore.d.ts","sourceRoot":"","sources":["../../src/vue/usePdfCore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIjE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAChC,YAAY,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACtC,GAAG,EAAE,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAClC,IAAI,EAAE,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC/B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACxB,KAAK,EAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1B,kBAAkB;IAClB,MAAM,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC;IACtC,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,GAAG,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAgK5E"}

package/package.json

@@ -0,0 +1,61 @@
+{
+	"name": "@xtctwins/tctwins-pdf-core",
+	"private": false,
+	"version": "0.1.0",
+	"description": "Reusable PDF core with Vue 3 viewer, tile rendering, annotations (measure/rectangle), and composables",
+	"type": "module",
+	"license": "MIT",
+	"author": "",
+	"keywords": [
+		"pdf",
+		"pdfjs",
+		"pdf-viewer",
+		"vue3",
+		"annotation",
+		"measure",
+		"tile-renderer",
+		"canvas"
+	],
+	"repository": {
+		"type": "git",
+		"url": ""
+	},
+	"files": [
+		"dist"
+	],
+	"sideEffects": [
+		"**/*.css"
+	],
+	"main": "./dist/pdf-core.js",
+	"module": "./dist/pdf-core.js",
+	"types": "./dist/index.d.ts",
+	"style": "./dist/style.css",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/pdf-core.js",
+			"default": "./dist/pdf-core.js"
+		},
+		"./style.css": "./dist/style.css"
+	},
+	"scripts": {
+		"dev": "vite",
+		"dev:minimal": "vite --config minimal-example/vite.config.ts minimal-example/",
+		"build": "vite build && vue-tsc -p tsconfig.build.json",
+		"prepublishOnly": "npm run build",
+		"publish": "npm publish --access public --registry=https://registry.npmjs.org/"
+	},
+	"devDependencies": {
+		"@types/node": "^22.10.1",
+		"@vitejs/plugin-vue": "^6.0.7",
+		"pdfjs-dist": "^5.7.284",
+		"typescript": "^5.6.3",
+		"vite": "^8.1.2",
+		"vue": "^3.5.0",
+		"vue-tsc": "^3.3.8"
+	},
+	"peerDependencies": {
+		"pdfjs-dist": "^5.7.0",
+		"vue": "^3.5.0"
+	}
+}