@mlightcad/cad-pdf-plugin 1.6.3 → 1.7.1

package/README.md

@@ -3,18 +3,21 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![npm version](https://img.shields.io/npm/v/@mlightcad/cad-pdf-plugin.svg)](https://www.npmjs.com/package/@mlightcad/cad-pdf-plugin)
 
-PDF **export** and **import** plugin for [`@mlightcad/cad-simple-viewer`](../cad-simple-viewer). Registers two system commands:
+PDF **export** and **import** plugin for [`@mlightcad/cad-simple-viewer`](../cad-simple-viewer). Registers system commands:
 
 | Command | Description |
 |---------|-------------|
-| `cpdf` | Export the current drawing to a vector PDF (SVG pipeline → jsPDF) |
+| `-cpdf` | Export via **command-line prompts** (no dialog; AutoCAD-style `-` prefix) |
+| `cpdf` | Same as `-cpdf` when no UI command is registered. In [`cad-viewer`](../cad-viewer), `cpdf` opens an **export options dialog** instead |
 | `ipdf` | Import vector geometry from a PDF file into model space |
 
-The plugin is designed for **lazy loading** so PDF libraries (`jspdf`, `pdfjs-dist`, `svg2pdf.js`) are only downloaded when a user runs `cpdf` or `ipdf`.
+The plugin is designed for **lazy loading** so PDF libraries (`pdf-lib` via `@mlightcad/pdf-renderer`, `pdfjs-dist`) are only downloaded when a user runs `-cpdf` / `cpdf` or `ipdf`.
 
 ## Key features
 
-- **Vector PDF export** — renders model-space entities via `@mlightcad/cad-svg-plugin`, then converts SVG to PDF with `svg2pdf.js`
+- **Vector PDF export** — renders model space and each paper-space layout as PDF pages with `@mlightcad/pdf-renderer` (native AcGi PDF backend). Paper-space pages include model content shown through viewports, clipped to each viewport frame.
+- **Busy indicator** — export shows the same conversion spinner as `chtml` so the browser stays responsive
+- **Export options** — model-space framing (`Extents` / `Display`) and optional paper-space layouts
 - **PDF import** — parses vector paths from the first page of a PDF (lines, polylines, Bézier curves) and appends CAD entities
 - **Plugin API** — implements `AcApPlugin`; register once with `registerLazyPdfPlugin`
 - **Framework-agnostic** — no Vue/React dependency; works anywhere `cad-simple-viewer` runs
@@ -29,13 +32,11 @@ Peer dependencies:
 
 - `@mlightcad/cad-simple-viewer`
 - `@mlightcad/data-model`
-- `@mlightcad/cad-svg-plugin`
+- `@mlightcad/pdf-renderer`
 
 Runtime dependencies (bundled with this package):
 
-- `jspdf`
-- `pdfjs-dist`
-- `svg2pdf.js`
+- `pdfjs-dist` (import only)
 
 ## Build
 
@@ -49,7 +50,7 @@ pnpm --filter @mlightcad/cad-pdf-plugin build
 
 ### Lazy registration (recommended)
 
-Register the plugin with the document manager's plugin manager. Import from the `/register` subpath so only the registration stub enters your initial bundle; the main plugin chunk loads on first use of `cpdf` or `ipdf`:
+Register the plugin with the document manager's plugin manager. Import from the `/register` subpath so only the registration stub enters your initial bundle; the main plugin chunk loads on first use of `-cpdf`, `cpdf`, or `ipdf`:
 
 ```typescript
 import { AcApDocManager } from '@mlightcad/cad-simple-viewer'
@@ -79,14 +80,16 @@ AcApDocManager.instance.pluginManager.registerLazyPlugin({
 After registration, users (or your UI) invoke commands through the editor:
 
 ```typescript
-// Export current drawing to PDF
-await AcApDocManager.instance.editor.executeCommand('cpdf')
+// Export current drawing to PDF (command-line prompts)
+await AcApDocManager.instance.editor.executeCommand('-cpdf')
 
 // Open file picker and import PDF vectors
 await AcApDocManager.instance.editor.executeCommand('ipdf')
 ```
 
-`cad-viewer` registers this plugin automatically via `registerLazyPlugins()` in its app bootstrap.
+In [`cad-viewer`](../cad-viewer), use `cpdf` to open the export options dialog; `-cpdf` remains available on the command line for prompt-based export.
+
+`cad-viewer` registers this plugin automatically via `registerLazyPlugins()` in its app bootstrap and registers the `cpdf` dialog command separately.
 
 ### Eager registration
 
@@ -104,11 +107,21 @@ You can bypass the command layer and call the convertors directly:
 
 ```typescript
 import { AcApContext } from '@mlightcad/cad-simple-viewer'
-import { AcApPdfConvertor, AcApPdfImportConvertor } from '@mlightcad/cad-pdf-plugin'
+import {
+  AcApPdfConvertor,
+  AcApPdfImportConvertor,
+  resolveAcApPdfExportOptions
+} from '@mlightcad/cad-pdf-plugin'
 
 // Export
 const context: AcApContext = /* active context */
-await new AcApPdfConvertor().convert(context)
+await new AcApPdfConvertor().convert(
+  context,
+  resolveAcApPdfExportOptions({
+    modelSpaceFit: 'extents',
+    exportLayouts: true
+  })
+)
 
 // Import from bytes
 const buffer: ArrayBuffer = /* PDF file */
@@ -117,11 +130,12 @@ await new AcApPdfImportConvertor().convert(context, buffer, 1) // page 1
 
 ## How it works
 
-### Export (`cpdf`)
+### Export (`-cpdf` / dialog)
 
-1. Iterate model-space entities and render with `AcSvgRenderer` (respects linetype scale, lineweight display, font mapping, background/foreground colors).
-2. Parse the SVG and pass it to `svg2pdf.js` inside a `jsPDF` document sized to the SVG viewBox.
-3. Trigger a browser download as `drawing.pdf`.
+1. Collect options: model-space framing (`Extents` / `Display`) and whether to export layouts.
+2. Show the application busy overlay (same animation pattern as `chtml`).
+3. Call `@mlightcad/pdf-renderer` `exportDatabaseToPdf`. With layouts enabled, model space and every paper space become one PDF page each.
+4. Download the resulting PDF bytes.
 
 ### Import (`ipdf`)
 
@@ -139,9 +153,10 @@ Import is **vector-only**; raster/scanned PDF pages produce no entities. Only th
 | `PDF_PLUGIN_NAME`, `PDF_PLUGIN_TRIGGERS` | Plugin id and command triggers |
 | `@mlightcad/cad-pdf-plugin/register` | `registerLazyPdfPlugin` and registration constants |
 | `AcApPdfPlugin` | `AcApPlugin` implementation |
-| `AcApConvertToPdfCmd` | `cpdf` command class |
+| `AcApConvertToPdfCmd` | `-cpdf` / fallback `cpdf` command class |
 | `AcApImportPdfCmd` | `ipdf` command class |
-| `AcApPdfConvertor` | SVG → PDF export utility |
+| `AcApPdfConvertor` | CAD → PDF export utility |
+| `AcApPdfExportOptions`, `resolveAcApPdfExportOptions` | Export option types and defaults |
 | `AcApPdfImportConvertor` | PDF → CAD entities import utility |
 
 ## Project layout
@@ -150,14 +165,15 @@ Import is **vector-only**; raster/scanned PDF pages produce no entities. Only th
 |------|------|
 | `src/register.ts` | Lazy plugin registration (`/register` entry) and `createPdfPlugin` |
 | `src/AcApPdfPlugin.ts` | Plugin lifecycle (`onLoad` / `onUnload`) |
-| `src/AcApConvertToPdfCmd.ts` | `cpdf` command |
+| `src/AcApConvertToPdfCmd.ts` | `-cpdf` command (command-line prompts) |
 | `src/AcApImportPdfCmd.ts` | `ipdf` command |
-| `src/AcApPdfConvertor.ts` | Export pipeline (SVG renderer + jsPDF) |
+| `src/AcApPdfConvertor.ts` | Export pipeline (`exportDatabaseToPdf`) |
+| `src/AcApPdfExportOptions.ts` | Export option types and defaults |
 | `src/AcApPdfImportConvertor.ts` | Import pipeline (pdf.js operator parsing) |
 
 ## Role in MLightCAD
 
-This package extends `cad-simple-viewer` with optional PDF I/O. It depends on `cad-svg-plugin` for export quality parity with the existing SVG export command (`csvg`) and keeps heavy PDF dependencies out of the core viewer bundle through lazy loading.
+This package extends `cad-simple-viewer` with optional PDF I/O. Export uses `@mlightcad/pdf-renderer`; import uses `pdfjs-dist`. Heavy PDF dependencies stay out of the core viewer bundle through lazy loading.
 
 ## License
 

package/dist/cad-pdf-plugin-register.js

@@ -1,16 +1,17 @@
-const t = "PdfPlugin", e = ["cpdf", "ipdf"];
-function i(n) {
-  n.registerLazyPlugin({
-    name: t,
-    triggers: [...e],
+const s = "PdfPlugin", o = ["-cpdf", "cpdf", "ipdf"];
+function P(r, e = {}) {
+  const t = e.disableExport === !0, i = t ? ["ipdf"] : [...o];
+  r.registerLazyPlugin({
+    name: s,
+    triggers: [...i],
     loader: async () => {
-      const { createPdfPlugin: r } = await import("@mlightcad/cad-pdf-plugin");
-      return r();
+      const { createPdfPlugin: n } = await import("@mlightcad/cad-pdf-plugin");
+      return n({ disableExport: t });
     }
   });
 }
 export {
-  t as PDF_PLUGIN_NAME,
-  e as PDF_PLUGIN_TRIGGERS,
-  i as registerLazyPdfPlugin
+  s as PDF_PLUGIN_NAME,
+  o as PDF_PLUGIN_TRIGGERS,
+  P as registerLazyPdfPlugin
 };

package/dist/cad-pdf-plugin-register.umd.cjs

@@ -1 +1 @@
-"use strict";var o=Object.create;var n=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var c=Object.getPrototypeOf,d=Object.prototype.hasOwnProperty;var l=(e,t,P,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of u(t))!d.call(e,r)&&r!==P&&n(e,r,{get:()=>t[r],enumerable:!(i=s(t,r))||i.enumerable});return e};var f=(e,t,P)=>(P=e!=null?o(c(e)):{},l(t||!e||!e.__esModule?n(P,"default",{value:e,enumerable:!0}):P,e));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g="PdfPlugin",a=["cpdf","ipdf"];function G(e){e.registerLazyPlugin({name:g,triggers:[...a],loader:async()=>{const{createPdfPlugin:t}=await import("@mlightcad/cad-pdf-plugin");return t()}})}exports.PDF_PLUGIN_NAME=g;exports.PDF_PLUGIN_TRIGGERS=a;exports.registerLazyPdfPlugin=G;
+"use strict";var o=Object.create;var n=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var c=Object.getPrototypeOf,l=Object.prototype.hasOwnProperty;var u=(t,e,r,P)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of d(e))!l.call(t,i)&&i!==r&&n(t,i,{get:()=>e[i],enumerable:!(P=a(e,i))||P.enumerable});return t};var f=(t,e,r)=>(r=t!=null?o(c(t)):{},u(e||!t||!t.__esModule?n(r,"default",{value:t,enumerable:!0}):r,t));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s="PdfPlugin",g=["-cpdf","cpdf","ipdf"];function p(t,e={}){const r=e.disableExport===!0,P=r?["ipdf"]:[...g];t.registerLazyPlugin({name:s,triggers:[...P],loader:async()=>{const{createPdfPlugin:i}=await import("@mlightcad/cad-pdf-plugin");return i({disableExport:r})}})}exports.PDF_PLUGIN_NAME=s;exports.PDF_PLUGIN_TRIGGERS=g;exports.registerLazyPdfPlugin=p;