@laminapdf/sdk 0.0.0-stage → 0.2.0-alpha.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +243 -2
- package/dist/api.d.ts +26 -0
- package/dist/api.d.ts.map +1 -0
- package/dist/api.js +12 -0
- package/dist/api.js.map +1 -0
- package/dist/builder.d.ts +335 -0
- package/dist/builder.d.ts.map +1 -0
- package/dist/builder.js +574 -0
- package/dist/builder.js.map +1 -0
- package/dist/defined.d.ts +5 -0
- package/dist/defined.d.ts.map +1 -0
- package/dist/defined.js +7 -0
- package/dist/defined.js.map +1 -0
- package/dist/document.d.ts +267 -0
- package/dist/document.d.ts.map +1 -0
- package/dist/document.js +472 -0
- package/dist/document.js.map +1 -0
- package/dist/entry/node.d.ts +30 -0
- package/dist/entry/node.d.ts.map +1 -0
- package/dist/entry/node.js +37 -0
- package/dist/entry/node.js.map +1 -0
- package/dist/entry/workerd.d.ts +30 -0
- package/dist/entry/workerd.d.ts.map +1 -0
- package/dist/entry/workerd.js +37 -0
- package/dist/entry/workerd.js.map +1 -0
- package/dist/errors.d.ts +102 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +131 -0
- package/dist/errors.js.map +1 -0
- package/dist/explain.d.ts +20 -0
- package/dist/explain.d.ts.map +1 -0
- package/dist/explain.js +14 -0
- package/dist/explain.js.map +1 -0
- package/dist/extract.d.ts +57 -0
- package/dist/extract.d.ts.map +1 -0
- package/dist/extract.js +5 -0
- package/dist/extract.js.map +1 -0
- package/dist/font.d.ts +73 -0
- package/dist/font.d.ts.map +1 -0
- package/dist/font.js +133 -0
- package/dist/font.js.map +1 -0
- package/dist/generated/builder-enums.d.ts +29 -0
- package/dist/generated/builder-enums.d.ts.map +1 -0
- package/dist/generated/builder-enums.js +80 -0
- package/dist/generated/builder-enums.js.map +1 -0
- package/dist/generated/codes.d.ts +109 -0
- package/dist/generated/codes.d.ts.map +1 -0
- package/dist/generated/codes.js +508 -0
- package/dist/generated/codes.js.map +1 -0
- package/dist/generated/explain.d.ts +6 -0
- package/dist/generated/explain.d.ts.map +1 -0
- package/dist/generated/explain.js +155 -0
- package/dist/generated/explain.js.map +1 -0
- package/dist/generated/extract.d.ts +235 -0
- package/dist/generated/extract.d.ts.map +1 -0
- package/dist/generated/extract.js +4 -0
- package/dist/generated/extract.js.map +1 -0
- package/dist/index.d.ts +30 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +37 -0
- package/dist/index.js.map +1 -0
- package/dist/init.d.ts +88 -0
- package/dist/init.d.ts.map +1 -0
- package/dist/init.js +139 -0
- package/dist/init.js.map +1 -0
- package/dist/internal/handle.d.ts +58 -0
- package/dist/internal/handle.d.ts.map +1 -0
- package/dist/internal/handle.js +113 -0
- package/dist/internal/handle.js.map +1 -0
- package/dist/internal/instance.d.ts +56 -0
- package/dist/internal/instance.d.ts.map +1 -0
- package/dist/internal/instance.js +125 -0
- package/dist/internal/instance.js.map +1 -0
- package/dist/loader/fetch.d.ts +3 -0
- package/dist/loader/fetch.d.ts.map +1 -0
- package/dist/loader/fetch.js +2 -0
- package/dist/loader/fetch.js.map +1 -0
- package/dist/loader/node.d.ts +3 -0
- package/dist/loader/node.d.ts.map +1 -0
- package/dist/loader/node.js +9 -0
- package/dist/loader/node.js.map +1 -0
- package/dist/loader/workerd.d.ts +3 -0
- package/dist/loader/workerd.d.ts.map +1 -0
- package/dist/loader/workerd.js +15 -0
- package/dist/loader/workerd.js.map +1 -0
- package/dist/matrix.d.ts +16 -0
- package/dist/matrix.d.ts.map +1 -0
- package/dist/matrix.js +36 -0
- package/dist/matrix.js.map +1 -0
- package/dist/path.d.ts +34 -0
- package/dist/path.d.ts.map +1 -0
- package/dist/path.js +49 -0
- package/dist/path.js.map +1 -0
- package/dist/source/http.d.ts +36 -0
- package/dist/source/http.d.ts.map +1 -0
- package/dist/source/http.js +211 -0
- package/dist/source/http.js.map +1 -0
- package/dist/source/range.d.ts +75 -0
- package/dist/source/range.d.ts.map +1 -0
- package/dist/source/range.js +100 -0
- package/dist/source/range.js.map +1 -0
- package/dist/text.d.ts +90 -0
- package/dist/text.d.ts.map +1 -0
- package/dist/text.js +127 -0
- package/dist/text.js.map +1 -0
- package/dist/transaction.d.ts +36 -0
- package/dist/transaction.d.ts.map +1 -0
- package/dist/transaction.js +47 -0
- package/dist/transaction.js.map +1 -0
- package/dist/types.d.ts +79 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- package/dist/version.d.ts +3 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +6 -0
- package/dist/version.js.map +1 -0
- package/dist/worker/client.d.ts +88 -0
- package/dist/worker/client.d.ts.map +1 -0
- package/dist/worker/client.js +407 -0
- package/dist/worker/client.js.map +1 -0
- package/dist/worker/emitter.d.ts +12 -0
- package/dist/worker/emitter.d.ts.map +1 -0
- package/dist/worker/emitter.js +34 -0
- package/dist/worker/emitter.js.map +1 -0
- package/dist/worker/entry.d.ts +2 -0
- package/dist/worker/entry.d.ts.map +1 -0
- package/dist/worker/entry.js +4 -0
- package/dist/worker/entry.js.map +1 -0
- package/dist/worker/index.d.ts +7 -0
- package/dist/worker/index.d.ts.map +1 -0
- package/dist/worker/index.js +4 -0
- package/dist/worker/index.js.map +1 -0
- package/dist/worker/protocol.d.ts +82 -0
- package/dist/worker/protocol.d.ts.map +1 -0
- package/dist/worker/protocol.js +11 -0
- package/dist/worker/protocol.js.map +1 -0
- package/dist/worker/server.d.ts +51 -0
- package/dist/worker/server.d.ts.map +1 -0
- package/dist/worker/server.js +493 -0
- package/dist/worker/server.js.map +1 -0
- package/dist/worker/support.d.ts +43 -0
- package/dist/worker/support.d.ts.map +1 -0
- package/dist/worker/support.js +26 -0
- package/dist/worker/support.js.map +1 -0
- package/dist/worker/transfer.d.ts +3 -0
- package/dist/worker/transfer.d.ts.map +1 -0
- package/dist/worker/transfer.js +13 -0
- package/dist/worker/transfer.js.map +1 -0
- package/dist/worker/types.d.ts +50 -0
- package/dist/worker/types.d.ts.map +1 -0
- package/dist/worker/types.js +2 -0
- package/dist/worker/types.js.map +1 -0
- package/docs/AGENTS.md +14 -0
- package/docs/api/README.md +147 -0
- package/docs/api/classes/Builder.md +467 -0
- package/docs/api/classes/Document.md +742 -0
- package/docs/api/classes/Font.md +74 -0
- package/docs/api/classes/Image.md +140 -0
- package/docs/api/classes/LaminaPdfError.md +189 -0
- package/docs/api/classes/Page.md +178 -0
- package/docs/api/classes/PageRef.md +253 -0
- package/docs/api/classes/PageText.md +129 -0
- package/docs/api/classes/PageTextRun.md +167 -0
- package/docs/api/classes/PendingPath.md +97 -0
- package/docs/api/classes/SaveJob.md +205 -0
- package/docs/api/classes/Surface.md +326 -0
- package/docs/api/classes/Transaction.md +111 -0
- package/docs/api/functions/callbackSource.md +33 -0
- package/docs/api/functions/httpRangeSource.md +48 -0
- package/docs/api/functions/init.md +36 -0
- package/docs/api/functions/isExtractLoaded.md +21 -0
- package/docs/api/functions/isInitialized.md +19 -0
- package/docs/api/functions/isLaminaPdfError.md +41 -0
- package/docs/api/functions/isTextLoaded.md +19 -0
- package/docs/api/functions/loadExtract.md +28 -0
- package/docs/api/functions/loadText.md +28 -0
- package/docs/api/functions/onLeak.md +29 -0
- package/docs/api/functions/reset.md +22 -0
- package/docs/api/functions/wasmMemory.md +22 -0
- package/docs/api/interfaces/BuilderOptions.md +108 -0
- package/docs/api/interfaces/ByteRange.md +29 -0
- package/docs/api/interfaces/ChunkOptions.md +37 -0
- package/docs/api/interfaces/Diagnostic.md +67 -0
- package/docs/api/interfaces/ExtractOptions.md +92 -0
- package/docs/api/interfaces/ExtractResult.md +37 -0
- package/docs/api/interfaces/FontInfo.md +37 -0
- package/docs/api/interfaces/HttpRangeOptions.md +78 -0
- package/docs/api/interfaces/InitOptions.md +40 -0
- package/docs/api/interfaces/Leak.md +21 -0
- package/docs/api/interfaces/Location.md +53 -0
- package/docs/api/interfaces/OpLog.md +25 -0
- package/docs/api/interfaces/OpenOptions.md +37 -0
- package/docs/api/interfaces/PageTextOptions.md +21 -0
- package/docs/api/interfaces/PathBuilder.md +195 -0
- package/docs/api/interfaces/QuadPoint.md +25 -0
- package/docs/api/interfaces/RangeOptions.md +54 -0
- package/docs/api/interfaces/RangeSource.md +59 -0
- package/docs/api/interfaces/StrokeStyle.md +61 -0
- package/docs/api/interfaces/TagSpec.md +69 -0
- package/docs/api/interfaces/TextBoxOptions.md +93 -0
- package/docs/api/interfaces/TextGlyph.md +29 -0
- package/docs/api/interfaces/TextOptions.md +101 -0
- package/docs/api/interfaces/WasmMemory.md +37 -0
- package/docs/api/type-aliases/AfRelationship.md +15 -0
- package/docs/api/type-aliases/Align.md +15 -0
- package/docs/api/type-aliases/ArtifactKind.md +15 -0
- package/docs/api/type-aliases/AttachmentOptions.md +15 -0
- package/docs/api/type-aliases/BlendMode.md +15 -0
- package/docs/api/type-aliases/BoxRect.md +15 -0
- package/docs/api/type-aliases/BuildOptions.md +15 -0
- package/docs/api/type-aliases/Cell.md +71 -0
- package/docs/api/type-aliases/Chunk.md +79 -0
- package/docs/api/type-aliases/Color.md +16 -0
- package/docs/api/type-aliases/Coordinates.md +55 -0
- package/docs/api/type-aliases/Direction.md +15 -0
- package/docs/api/type-aliases/DocumentInfo.md +15 -0
- package/docs/api/type-aliases/DropReason.md +15 -0
- package/docs/api/type-aliases/Dropped.md +59 -0
- package/docs/api/type-aliases/Edited.md +15 -0
- package/docs/api/type-aliases/ErrorCode.md +15 -0
- package/docs/api/type-aliases/ErrorKind.md +15 -0
- package/docs/api/type-aliases/ExtractFormat.md +15 -0
- package/docs/api/type-aliases/ExtractedBlock.md +82 -0
- package/docs/api/type-aliases/ExtractedPage.md +65 -0
- package/docs/api/type-aliases/ExtractedSource.md +48 -0
- package/docs/api/type-aliases/Extraction.md +22 -0
- package/docs/api/type-aliases/FillRule.md +15 -0
- package/docs/api/type-aliases/Fit.md +15 -0
- package/docs/api/type-aliases/Flags.md +15 -0
- package/docs/api/type-aliases/Generator.md +41 -0
- package/docs/api/type-aliases/GlyphQuad.md +15 -0
- package/docs/api/type-aliases/InfoPatch.md +15 -0
- package/docs/api/type-aliases/LaminaPdfWarning.md +16 -0
- package/docs/api/type-aliases/LimitName.md +15 -0
- package/docs/api/type-aliases/Limits.md +15 -0
- package/docs/api/type-aliases/LineBox.md +15 -0
- package/docs/api/type-aliases/LineCap.md +15 -0
- package/docs/api/type-aliases/LineJoin.md +15 -0
- package/docs/api/type-aliases/LinkTarget.md +15 -0
- package/docs/api/type-aliases/Metadata.md +15 -0
- package/docs/api/type-aliases/Op.md +15 -0
- package/docs/api/type-aliases/OutlineEntry.md +15 -0
- package/docs/api/type-aliases/Overflow.md +15 -0
- package/docs/api/type-aliases/PageInfo.md +15 -0
- package/docs/api/type-aliases/PageLabel.md +15 -0
- package/docs/api/type-aliases/PageSizeName.md +15 -0
- package/docs/api/type-aliases/Point.md +15 -0
- package/docs/api/type-aliases/Profile.md +15 -0
- package/docs/api/type-aliases/Progress.md +15 -0
- package/docs/api/type-aliases/ReadingOrder.md +15 -0
- package/docs/api/type-aliases/Rect.md +15 -0
- package/docs/api/type-aliases/Region.md +31 -0
- package/docs/api/type-aliases/RenderMode.md +15 -0
- package/docs/api/type-aliases/Rotation.md +15 -0
- package/docs/api/type-aliases/SaveOptions.md +15 -0
- package/docs/api/type-aliases/SaveReport.md +15 -0
- package/docs/api/type-aliases/Span.md +63 -0
- package/docs/api/type-aliases/SplitOn.md +15 -0
- package/docs/api/type-aliases/Standard14.md +15 -0
- package/docs/api/type-aliases/StructRef.md +41 -0
- package/docs/api/type-aliases/StructSource.md +17 -0
- package/docs/api/type-aliases/TableDetector.md +15 -0
- package/docs/api/type-aliases/TableMode.md +15 -0
- package/docs/api/type-aliases/TableScope.md +15 -0
- package/docs/api/type-aliases/Tag.md +15 -0
- package/docs/api/type-aliases/TagName.md +15 -0
- package/docs/api/type-aliases/TextLayout.md +15 -0
- package/docs/api/type-aliases/TextRange.md +33 -0
- package/docs/api/type-aliases/TextRunInfo.md +15 -0
- package/docs/api/type-aliases/Transform.md +15 -0
- package/docs/api/type-aliases/UndoOutcome.md +15 -0
- package/docs/api/type-aliases/ViewerPreferences.md +15 -0
- package/docs/api/type-aliases/WarningCode.md +15 -0
- package/docs/api/type-aliases/WasmSource.md +16 -0
- package/docs/api/variables/Matrix.md +99 -0
- package/docs/api/variables/PAGE_SIZES.md +15 -0
- package/docs/api/variables/TAG_NAMES.md +15 -0
- package/docs/errors/README.md +156 -0
- package/docs/errors/aes-padding-invalid.md +34 -0
- package/docs/errors/already-initialized.md +34 -0
- package/docs/errors/binary-output-to-terminal.md +35 -0
- package/docs/errors/builder-finished.md +35 -0
- package/docs/errors/cancelled.md +35 -0
- package/docs/errors/cmap-invalid.md +42 -0
- package/docs/errors/collection-index.md +33 -0
- package/docs/errors/color-components.md +33 -0
- package/docs/errors/content-bad-operands.md +36 -0
- package/docs/errors/content-path-unpainted.md +36 -0
- package/docs/errors/content-resource-missing.md +37 -0
- package/docs/errors/content-syntax.md +36 -0
- package/docs/errors/content-unbalanced-bt.md +36 -0
- package/docs/errors/content-unbalanced-marked.md +36 -0
- package/docs/errors/content-unbalanced-q.md +36 -0
- package/docs/errors/content-unknown-operator.md +37 -0
- package/docs/errors/data-pending.md +34 -0
- package/docs/errors/decompress.md +34 -0
- package/docs/errors/device-color-without-output-intent.md +33 -0
- package/docs/errors/direct-page.md +34 -0
- package/docs/errors/disposed.md +34 -0
- package/docs/errors/document-changed.md +34 -0
- package/docs/errors/embedded-file-forbidden.md +35 -0
- package/docs/errors/embedded-file-without-mime-type.md +36 -0
- package/docs/errors/encoding-full.md +34 -0
- package/docs/errors/encrypted-base.md +33 -0
- package/docs/errors/extract-limit-blocks.md +35 -0
- package/docs/errors/extract-module-not-loaded.md +37 -0
- package/docs/errors/extract-reading-order-ambiguous.md +32 -0
- package/docs/errors/extract-struct-tree-ignored.md +32 -0
- package/docs/errors/extract-table-ambiguous.md +32 -0
- package/docs/errors/extract-table-limit.md +35 -0
- package/docs/errors/extract-untagged-content.md +32 -0
- package/docs/errors/fetch-failed.md +34 -0
- package/docs/errors/flate-truncated.md +34 -0
- package/docs/errors/font-invalid.md +36 -0
- package/docs/errors/font-mismatch.md +34 -0
- package/docs/errors/font-not-embeddable.md +34 -0
- package/docs/errors/font-not-embedded.md +35 -0
- package/docs/errors/font-not-shapable.md +33 -0
- package/docs/errors/glyph-out-of-range.md +34 -0
- package/docs/errors/glyph-without-unicode.md +35 -0
- package/docs/errors/heading-level-skipped.md +36 -0
- package/docs/errors/image-data-length.md +33 -0
- package/docs/errors/image-too-large.md +32 -0
- package/docs/errors/inline-image-unterminated.md +36 -0
- package/docs/errors/input-unreadable.md +37 -0
- package/docs/errors/instance-reset.md +34 -0
- package/docs/errors/invalid-argument.md +33 -0
- package/docs/errors/invalid-axis-value.md +32 -0
- package/docs/errors/invalid-box.md +34 -0
- package/docs/errors/invalid-color.md +32 -0
- package/docs/errors/invalid-command-line.md +44 -0
- package/docs/errors/invalid-date.md +34 -0
- package/docs/errors/invalid-entry.md +34 -0
- package/docs/errors/invalid-feature.md +32 -0
- package/docs/errors/invalid-font.md +32 -0
- package/docs/errors/invalid-geometry.md +32 -0
- package/docs/errors/invalid-icc-profile.md +32 -0
- package/docs/errors/invalid-image.md +33 -0
- package/docs/errors/invalid-op-log.md +33 -0
- package/docs/errors/invalid-page-label.md +34 -0
- package/docs/errors/invalid-page-labels.md +32 -0
- package/docs/errors/invalid-page-range.md +37 -0
- package/docs/errors/invalid-rotate.md +34 -0
- package/docs/errors/invalid-structure-nesting.md +38 -0
- package/docs/errors/invalid-structure.md +34 -0
- package/docs/errors/invalid-text-range.md +33 -0
- package/docs/errors/job-finished.md +34 -0
- package/docs/errors/limit-exceeded.md +38 -0
- package/docs/errors/link-without-contents.md +33 -0
- package/docs/errors/link-without-structure.md +37 -0
- package/docs/errors/missing-alt-text.md +33 -0
- package/docs/errors/missing-glyph.md +33 -0
- package/docs/errors/missing-header.md +37 -0
- package/docs/errors/missing-lang.md +32 -0
- package/docs/errors/missing-root.md +34 -0
- package/docs/errors/missing-title.md +32 -0
- package/docs/errors/name-tree-node-skipped.md +34 -0
- package/docs/errors/nested-transaction.md +34 -0
- package/docs/errors/no-pending-save.md +32 -0
- package/docs/errors/no-transaction.md +33 -0
- package/docs/errors/not-initialized.md +35 -0
- package/docs/errors/not-pdf.md +33 -0
- package/docs/errors/not-rebased.md +35 -0
- package/docs/errors/object-number-out-of-range.md +38 -0
- package/docs/errors/objstm-index-mismatch.md +36 -0
- package/docs/errors/out-of-memory.md +38 -0
- package/docs/errors/outline-cycle.md +34 -0
- package/docs/errors/outline-item-skipped.md +34 -0
- package/docs/errors/output-unwritable.md +37 -0
- package/docs/errors/overwrite-refused.md +36 -0
- package/docs/errors/page-count-mismatch.md +34 -0
- package/docs/errors/page-index-out-of-range.md +34 -0
- package/docs/errors/page-tree-node-skipped.md +35 -0
- package/docs/errors/password-required.md +36 -0
- package/docs/errors/path-outside-roots.md +32 -0
- package/docs/errors/perms-mismatch.md +34 -0
- package/docs/errors/profile-version-conflict.md +35 -0
- package/docs/errors/reference-cycle.md +35 -0
- package/docs/errors/render-backend-unavailable.md +32 -0
- package/docs/errors/render-failed.md +33 -0
- package/docs/errors/render-too-large.md +36 -0
- package/docs/errors/repaired-base.md +34 -0
- package/docs/errors/requires-rewrite.md +38 -0
- package/docs/errors/saved-not-rebased.md +34 -0
- package/docs/errors/sink-not-empty.md +33 -0
- package/docs/errors/sink.md +31 -0
- package/docs/errors/source-budget-exceeded.md +34 -0
- package/docs/errors/source-changed.md +33 -0
- package/docs/errors/source.md +30 -0
- package/docs/errors/stale-generation.md +34 -0
- package/docs/errors/stream-length-recovered.md +37 -0
- package/docs/errors/strict.md +34 -0
- package/docs/errors/subset-failed.md +31 -0
- package/docs/errors/syntax.md +34 -0
- package/docs/errors/text-module-not-loaded.md +36 -0
- package/docs/errors/text-overflow.md +34 -0
- package/docs/errors/tounicode-conflict.md +32 -0
- package/docs/errors/type.md +34 -0
- package/docs/errors/unexpected-eof.md +34 -0
- package/docs/errors/unknown-axis.md +33 -0
- package/docs/errors/unknown-code.md +36 -0
- package/docs/errors/unknown-destination.md +33 -0
- package/docs/errors/unknown-font.md +33 -0
- package/docs/errors/unknown-option.md +33 -0
- package/docs/errors/unknown-page.md +34 -0
- package/docs/errors/unmapped-glyph.md +36 -0
- package/docs/errors/unnumbered-heading-misused.md +34 -0
- package/docs/errors/unset-object.md +30 -0
- package/docs/errors/unsupported-filter.md +34 -0
- package/docs/errors/unsupported-image.md +33 -0
- package/docs/errors/unsupported-layout-option.md +33 -0
- package/docs/errors/unsupported-security-handler.md +34 -0
- package/docs/errors/unsupported-version.md +32 -0
- package/docs/errors/untagged-content.md +35 -0
- package/docs/errors/warnings-truncated.md +35 -0
- package/docs/errors/wasm-trap.md +37 -0
- package/docs/errors/whole-font-rebuilt.md +30 -0
- package/docs/errors/worker-crashed.md +33 -0
- package/docs/errors/worker-failed.md +32 -0
- package/docs/errors/worker-version-mismatch.md +34 -0
- package/docs/errors/would-invalidate-signatures.md +38 -0
- package/docs/errors/wrong-document.md +33 -0
- package/docs/errors/wrong-password.md +34 -0
- package/docs/errors/xobject-cycle.md +36 -0
- package/docs/errors/xref-repaired.md +36 -0
- package/docs/errors/xrefstm-ignored.md +34 -0
- package/docs/llms.txt +88 -0
- package/docs/pages/concepts/dependencies.md +44 -0
- package/docs/pages/concepts/errors-and-warnings.md +64 -0
- package/docs/pages/concepts/how-lamina-thinks.md +86 -0
- package/docs/pages/concepts/pages-and-coordinates.md +67 -0
- package/docs/pages/guides/accessible-pdfs.md +260 -0
- package/docs/pages/guides/archival-pdfs.md +429 -0
- package/docs/pages/guides/edit-a-pdf.md +137 -0
- package/docs/pages/guides/fonts-and-text.md +202 -0
- package/docs/pages/guides/images-and-vectors.md +219 -0
- package/docs/pages/guides/keep-the-page-responsive.md +81 -0
- package/docs/pages/guides/links-outlines-and-metadata.md +222 -0
- package/docs/pages/guides/password-protected-files.md +70 -0
- package/docs/pages/guides/save-a-pdf.md +144 -0
- package/docs/pages/guides/untrusted-files.md +80 -0
- package/docs/pages/index.md +33 -0
- package/docs/pages/install.md +75 -0
- package/docs/pages/quick-start/browser.md +67 -0
- package/docs/pages/quick-start/bun.md +60 -0
- package/docs/pages/quick-start/deno.md +58 -0
- package/docs/pages/quick-start/node.md +61 -0
- package/docs/pages/quick-start/rust.md +58 -0
- package/docs/pages/quick-start/workers.md +139 -0
- package/docs/pages/recipes/cloudflare-worker.md +115 -0
- package/docs/pages/recipes/extract-markdown.md +114 -0
- package/docs/pages/recipes/generate-then-edit.md +135 -0
- package/docs/pages/recipes/hello.md +94 -0
- package/docs/pages/recipes/images-and-vectors.md +209 -0
- package/docs/pages/recipes/invoice.md +226 -0
- package/docs/pages/recipes/links-and-outlines.md +215 -0
- package/docs/pages/recipes/multilingual.md +189 -0
- package/docs/pages/recipes/open-untrusted.md +65 -0
- package/docs/pages/recipes/pdf-a-archive.md +205 -0
- package/docs/pages/recipes/pdf-a3-invoice-with-xml.md +222 -0
- package/docs/pages/recipes/pdf-ua-report.md +237 -0
- package/docs/pages/recipes/report.md +125 -0
- package/docs/pages/recipes/web-worker-client.md +64 -0
- package/docs/pages/recipes.md +47 -0
- package/docs/pages/reference/changelog.md +86 -0
- package/docs/pages/reference/codes.md +14 -0
- package/docs/pages/reference/glossary.md +108 -0
- package/docs/pages/reference/rust.md +36 -0
- package/docs/pages/reference/stability.md +59 -0
- package/docs/pages/start/coding-agents.md +45 -0
- package/docs/pages/start/first-pdf.md +77 -0
- package/docs/pages/troubleshooting.md +74 -0
- package/docs/renames.json +86 -0
- package/docs/schemas/error.schema.json +305 -0
- package/docs/schemas/renames.schema.json +29 -0
- package/package.json +93 -3
- package/schemas/error.schema.json +305 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}
|
package/dist/builder.js
ADDED
|
@@ -0,0 +1,574 @@
|
|
|
1
|
+
import { defined } from "./defined.js";
|
|
2
|
+
import { Document } from "./document.js";
|
|
3
|
+
import { didYouMean, packageError } from "./errors.js";
|
|
4
|
+
import { ARTIFACT_KINDS, TABLE_SCOPES, TAG_NAMES, } from "./generated/builder-enums.js";
|
|
5
|
+
import { readingModule, textModule } from "./init.js";
|
|
6
|
+
import { disposable, forget, Handle, watch } from "./internal/handle.js";
|
|
7
|
+
import { PathEncoder } from "./path.js";
|
|
8
|
+
const mm = (w, h) => [(w * 72) / 25.4, (h * 72) / 25.4];
|
|
9
|
+
/** Each named size in points, width × height. */
|
|
10
|
+
export const PAGE_SIZES = {
|
|
11
|
+
A0: mm(841, 1189),
|
|
12
|
+
A1: mm(594, 841),
|
|
13
|
+
A2: mm(420, 594),
|
|
14
|
+
A3: mm(297, 420),
|
|
15
|
+
A4: mm(210, 297),
|
|
16
|
+
A5: mm(148, 210),
|
|
17
|
+
A6: mm(105, 148),
|
|
18
|
+
Letter: [612, 792],
|
|
19
|
+
Legal: [612, 1008],
|
|
20
|
+
Tabloid: [792, 1224],
|
|
21
|
+
};
|
|
22
|
+
export { TAG_NAMES } from "./generated/builder-enums.js";
|
|
23
|
+
/** `name` when `names` has it, else `invalid-argument` with the closest names. */
|
|
24
|
+
function checked(names, name, argument, detail) {
|
|
25
|
+
if (names.includes(name))
|
|
26
|
+
return name;
|
|
27
|
+
throw packageError("invalid-argument", detail, { didYouMean: didYouMean(name, names), data: { argument, detail } });
|
|
28
|
+
}
|
|
29
|
+
/** The size of a named page; `invalid-argument` (with suggestions) for an unknown name. */
|
|
30
|
+
function namedSize(name) {
|
|
31
|
+
const size = PAGE_SIZES[name];
|
|
32
|
+
if (size !== undefined && Object.hasOwn(PAGE_SIZES, name))
|
|
33
|
+
return size;
|
|
34
|
+
throw packageError("invalid-argument", "not a page size name", {
|
|
35
|
+
didYouMean: didYouMean(name, Object.keys(PAGE_SIZES)),
|
|
36
|
+
data: { argument: "size", detail: "a page size is a name such as A4 or Letter, or [width, height] in points" },
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
/** Whether `a` and `b` hold the same bytes (identity first: no copy, no hash). */
|
|
40
|
+
function sameBytes(a, b) {
|
|
41
|
+
if (a === b)
|
|
42
|
+
return true;
|
|
43
|
+
if (a.length !== b.length)
|
|
44
|
+
return false;
|
|
45
|
+
for (let i = 0; i < a.length; i++)
|
|
46
|
+
if (a[i] !== b[i])
|
|
47
|
+
return false;
|
|
48
|
+
return true;
|
|
49
|
+
}
|
|
50
|
+
const HEX = "0123456789abcdef";
|
|
51
|
+
function hexId(id) {
|
|
52
|
+
if (typeof id === "string")
|
|
53
|
+
return id;
|
|
54
|
+
let out = "";
|
|
55
|
+
for (const byte of id)
|
|
56
|
+
out += (HEX[byte >> 4] ?? "") + (HEX[byte & 15] ?? "");
|
|
57
|
+
return out;
|
|
58
|
+
}
|
|
59
|
+
/** The record without the keys the TS layer handles, or `undefined` when nothing is left. */
|
|
60
|
+
function rest(record, keys) {
|
|
61
|
+
const out = Object.fromEntries(Object.entries(defined(record)).filter(([k]) => !keys.includes(k)));
|
|
62
|
+
return Object.keys(out).length > 0 ? out : undefined;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* The raw page of a {@link Page}, a handle freed with its builder: `builder-finished` once the page
|
|
66
|
+
* or its builder finishes, `disposed` once either is freed.
|
|
67
|
+
*/
|
|
68
|
+
class LivePage extends Handle {
|
|
69
|
+
#raw;
|
|
70
|
+
#onClose;
|
|
71
|
+
constructor(raw, builder, instance, onClose) {
|
|
72
|
+
super("Page", instance, builder);
|
|
73
|
+
this.#raw = raw;
|
|
74
|
+
this.#onClose = onClose;
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* Runs `f`, calls into the glue, on this page's raw side.
|
|
78
|
+
*
|
|
79
|
+
* @throws {@link LaminaPdfError} `disposed`, `instance-reset`, `builder-finished`; what `f` throws.
|
|
80
|
+
*/
|
|
81
|
+
run(f) {
|
|
82
|
+
return this.call(() => {
|
|
83
|
+
if (this.#raw === undefined)
|
|
84
|
+
throw packageError("builder-finished", "the page has already finished");
|
|
85
|
+
return f(this.#raw);
|
|
86
|
+
});
|
|
87
|
+
}
|
|
88
|
+
/** Frees the raw page and keeps the handle: later calls throw `builder-finished`. */
|
|
89
|
+
close() {
|
|
90
|
+
if (this.owned)
|
|
91
|
+
this.#raw?.free();
|
|
92
|
+
this.#raw = undefined;
|
|
93
|
+
this.#onClose(this);
|
|
94
|
+
}
|
|
95
|
+
release() {
|
|
96
|
+
this.close();
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
/** A path waiting to be painted: fill it, stroke it, both, or clip to it. */
|
|
100
|
+
export class PendingPath {
|
|
101
|
+
#surface;
|
|
102
|
+
#page;
|
|
103
|
+
#path;
|
|
104
|
+
/** @internal */
|
|
105
|
+
constructor(surface, page, path) {
|
|
106
|
+
this.#surface = surface;
|
|
107
|
+
this.#page = page;
|
|
108
|
+
this.#path = path;
|
|
109
|
+
}
|
|
110
|
+
/** Fills the path with the fill colour. @returns the surface. */
|
|
111
|
+
fill(rule = "nonZero") {
|
|
112
|
+
this.#page.run((page) => page.fillPath(this.#path, rule));
|
|
113
|
+
return this.#surface;
|
|
114
|
+
}
|
|
115
|
+
/** Strokes the path with the stroke colour and `style`. @returns the surface. */
|
|
116
|
+
stroke(style = {}) {
|
|
117
|
+
this.#surface.strokeStyle(style);
|
|
118
|
+
this.#page.run((page) => page.strokePath(this.#path));
|
|
119
|
+
return this.#surface;
|
|
120
|
+
}
|
|
121
|
+
/** Fills, then strokes the path. @returns the surface. */
|
|
122
|
+
fillStroke(rule = "nonZero", style = {}) {
|
|
123
|
+
this.#surface.strokeStyle(style);
|
|
124
|
+
this.#page.run((page) => page.fillStrokePath(this.#path, rule));
|
|
125
|
+
return this.#surface;
|
|
126
|
+
}
|
|
127
|
+
/** Clips what is drawn next to the path, until the next `restore`. @returns the surface. */
|
|
128
|
+
clip(rule = "nonZero") {
|
|
129
|
+
this.#page.run((page) => page.clipPath(this.#path, rule));
|
|
130
|
+
return this.#surface;
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
/**
|
|
134
|
+
* What a page is drawn with. Methods that set state return the surface, so calls chain; invalid
|
|
135
|
+
* geometry is reported by {@link Page.finish} (`invalid-geometry`).
|
|
136
|
+
*/
|
|
137
|
+
export class Surface {
|
|
138
|
+
#builder;
|
|
139
|
+
#page;
|
|
140
|
+
/** @internal */
|
|
141
|
+
constructor(builder, page) {
|
|
142
|
+
this.#builder = builder;
|
|
143
|
+
this.#page = page;
|
|
144
|
+
}
|
|
145
|
+
/** Saves the graphics state (`q`). */
|
|
146
|
+
save() {
|
|
147
|
+
this.#page.run((page) => page.save());
|
|
148
|
+
return this;
|
|
149
|
+
}
|
|
150
|
+
/** Restores the graphics state (`Q`). */
|
|
151
|
+
restore() {
|
|
152
|
+
this.#page.run((page) => page.restore());
|
|
153
|
+
return this;
|
|
154
|
+
}
|
|
155
|
+
/** Applies `matrix` (page space) to what is drawn next. See {@link Matrix}. */
|
|
156
|
+
transform(matrix) {
|
|
157
|
+
this.#page.run((page) => page.transform(new Float64Array(matrix)));
|
|
158
|
+
return this;
|
|
159
|
+
}
|
|
160
|
+
/** The colour fills (and text) use. */
|
|
161
|
+
fillColor(color) {
|
|
162
|
+
this.#page.run((page) => typeof color === "string" ? page.fillColorHex(color) : page.fillColor(new Float64Array(color)));
|
|
163
|
+
return this;
|
|
164
|
+
}
|
|
165
|
+
/** The colour strokes use. */
|
|
166
|
+
strokeColor(color) {
|
|
167
|
+
this.#page.run((page) => typeof color === "string" ? page.strokeColorHex(color) : page.strokeColor(new Float64Array(color)));
|
|
168
|
+
return this;
|
|
169
|
+
}
|
|
170
|
+
/** Fill and stroke opacity, 0 to 1. */
|
|
171
|
+
opacity(fill, stroke) {
|
|
172
|
+
this.#page.run((page) => page.opacity(fill, stroke));
|
|
173
|
+
return this;
|
|
174
|
+
}
|
|
175
|
+
/** The blend mode. */
|
|
176
|
+
blendMode(mode) {
|
|
177
|
+
this.#page.run((page) => page.blendMode(mode));
|
|
178
|
+
return this;
|
|
179
|
+
}
|
|
180
|
+
/** @internal The stroke style the next stroke uses. */
|
|
181
|
+
strokeStyle(style) {
|
|
182
|
+
this.#page.run((page) => page.strokeStyle(style.width ?? 1, style.cap ?? "butt", style.join ?? "miter", style.miterLimit ?? 10, new Float64Array(style.dash ?? []), style.dashPhase ?? 0));
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
* A path, built by `build`, to paint.
|
|
186
|
+
*
|
|
187
|
+
* @example
|
|
188
|
+
* ```ts
|
|
189
|
+
* surface.path((p) => p.moveTo(56, 590).lineTo(539, 590)).stroke({ width: 0.5 });
|
|
190
|
+
* ```
|
|
191
|
+
*/
|
|
192
|
+
path(build) {
|
|
193
|
+
const encoder = new PathEncoder();
|
|
194
|
+
build(encoder);
|
|
195
|
+
return new PendingPath(this, this.#page, encoder.finish());
|
|
196
|
+
}
|
|
197
|
+
/**
|
|
198
|
+
* Draws `image` scaled into `rect`; with `alt`, as a `Figure` structure element with that
|
|
199
|
+
* alternate text.
|
|
200
|
+
*/
|
|
201
|
+
image(image, rect, alt) {
|
|
202
|
+
const raw = this.#builder.wasmImage(image);
|
|
203
|
+
const draw = () => this.#page.run((page) => page.image(raw, rect[0], rect[1], rect[2], rect[3]));
|
|
204
|
+
if (alt !== undefined)
|
|
205
|
+
return this.tag({ type: "Figure", alt }, draw);
|
|
206
|
+
draw();
|
|
207
|
+
return this;
|
|
208
|
+
}
|
|
209
|
+
/**
|
|
210
|
+
* Draws what `draw` draws inside the structure element `tag`: its text, paths and images
|
|
211
|
+
* become the element's content, elements opened inside it its children, links its `Link`
|
|
212
|
+
* children, in reading order. Elements and artifacts `draw` leaves open end with it, also when
|
|
213
|
+
* it throws. A page using an element makes the document tagged.
|
|
214
|
+
*
|
|
215
|
+
* @example
|
|
216
|
+
* ```ts
|
|
217
|
+
* s.tag("Sect", (s) => {
|
|
218
|
+
* s.text("Results", { font, size: 18, at: [56, 96], tag: "H1" });
|
|
219
|
+
* s.tag({ type: "P", lang: "en-GB" }, (s) => s.textBox(summary, { font, size: 11, box }));
|
|
220
|
+
* });
|
|
221
|
+
* ```
|
|
222
|
+
* @throws {@link LaminaPdfError} `invalid-argument` for an unknown type without a `role`.
|
|
223
|
+
*/
|
|
224
|
+
tag(tag, draw) {
|
|
225
|
+
this.#begin(tag);
|
|
226
|
+
this.#within(draw);
|
|
227
|
+
return this;
|
|
228
|
+
}
|
|
229
|
+
/**
|
|
230
|
+
* Draws what `draw` draws as an artifact: decoration, running heads and footers, backgrounds;
|
|
231
|
+
* content outside the structure tree.
|
|
232
|
+
*/
|
|
233
|
+
artifact(kind, draw) {
|
|
234
|
+
const name = checked(ARTIFACT_KINDS, kind, "kind", "not an artifact kind");
|
|
235
|
+
this.#page.run((page) => page.beginArtifact(name));
|
|
236
|
+
this.#within(draw);
|
|
237
|
+
return this;
|
|
238
|
+
}
|
|
239
|
+
#begin(tag) {
|
|
240
|
+
const t = typeof tag === "string" ? { type: tag } : tag;
|
|
241
|
+
const custom = !TAG_NAMES.includes(t.type) && t.role !== undefined;
|
|
242
|
+
const kind = custom
|
|
243
|
+
? checked(TAG_NAMES, t.role ?? "", "role", "not a standard structure type")
|
|
244
|
+
: checked(TAG_NAMES, t.type, "type", "not a standard structure type (give a custom type a role)");
|
|
245
|
+
const scope = t.scope === undefined ? undefined : checked(TABLE_SCOPES, t.scope, "scope", "not a table scope");
|
|
246
|
+
this.#page.run((page) => page.beginTag(kind, custom ? t.type : undefined, t.alt, t.actualText, t.lang, t.expansion, scope));
|
|
247
|
+
}
|
|
248
|
+
/** Runs `draw`, then ends the element or artifact just begun. */
|
|
249
|
+
#within(draw) {
|
|
250
|
+
this.#ended(() => draw(this));
|
|
251
|
+
}
|
|
252
|
+
/**
|
|
253
|
+
* Runs `draw`, then ends the innermost element or artifact. When `draw` throws, its error is
|
|
254
|
+
* the one thrown (ending is still tried, and its own failure, a finished page, ignored).
|
|
255
|
+
*/
|
|
256
|
+
#ended(draw) {
|
|
257
|
+
let result;
|
|
258
|
+
try {
|
|
259
|
+
result = draw();
|
|
260
|
+
}
|
|
261
|
+
catch (e) {
|
|
262
|
+
try {
|
|
263
|
+
this.#page.run((page) => page.endTag());
|
|
264
|
+
}
|
|
265
|
+
catch {
|
|
266
|
+
// `draw`'s error is the one to report.
|
|
267
|
+
}
|
|
268
|
+
throw e;
|
|
269
|
+
}
|
|
270
|
+
this.#page.run((page) => page.endTag());
|
|
271
|
+
return result;
|
|
272
|
+
}
|
|
273
|
+
/** Runs `draw` inside `tag`, when there is one. */
|
|
274
|
+
#tagged(tag, draw) {
|
|
275
|
+
if (tag === undefined)
|
|
276
|
+
return draw();
|
|
277
|
+
this.#begin(tag);
|
|
278
|
+
return this.#ended(draw);
|
|
279
|
+
}
|
|
280
|
+
/** A link annotation over `rect`, with `contents` as its alternate text. */
|
|
281
|
+
link(rect, target, contents) {
|
|
282
|
+
this.#page.run((page) => page.link(rect[0], rect[1], rect[2], rect[3], target, contents));
|
|
283
|
+
return this;
|
|
284
|
+
}
|
|
285
|
+
/**
|
|
286
|
+
* Draws `text`: shaped, bidi-resolved, one line per line break (needs the text module).
|
|
287
|
+
*
|
|
288
|
+
* @returns what the run measures.
|
|
289
|
+
* @throws {@link LaminaPdfError} `text-module-not-loaded`, `missing-glyph`, `font-not-shapable`, …
|
|
290
|
+
*/
|
|
291
|
+
text(text, options) {
|
|
292
|
+
const font = this.#builder.wasmFont(options.font);
|
|
293
|
+
const extra = rest(options, ["font", "size", "at", "tag"]);
|
|
294
|
+
return this.#tagged(options.tag, () => this.#page.run((page) => page.text(text, font, options.size, options.at[0], options.at[1], extra)));
|
|
295
|
+
}
|
|
296
|
+
/**
|
|
297
|
+
* Lays `text` out in `options.box`, breaking lines at Unicode line-break opportunities.
|
|
298
|
+
*
|
|
299
|
+
* @returns the lines drawn and where the overflow starts (UTF-16 offsets).
|
|
300
|
+
* @throws {@link LaminaPdfError} as {@link Surface.text}; `text-overflow` with `overflow: "error"`.
|
|
301
|
+
*/
|
|
302
|
+
textBox(text, options) {
|
|
303
|
+
const font = this.#builder.wasmFont(options.font);
|
|
304
|
+
const [x, y, w, h] = options.box;
|
|
305
|
+
const extra = rest(options, ["font", "size", "box", "tag"]);
|
|
306
|
+
return this.#tagged(options.tag, () => this.#page.run((page) => page.textBox(text, font, options.size, x, y, w, h, extra)));
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
/**
|
|
310
|
+
* A page being drawn: its boxes and rotation, its {@link Surface}, then {@link Page.finish}. Freed
|
|
311
|
+
* with its builder; `using` or {@link Page.free} drops it without writing it.
|
|
312
|
+
*/
|
|
313
|
+
export class Page {
|
|
314
|
+
#page;
|
|
315
|
+
#surface;
|
|
316
|
+
/** @internal */
|
|
317
|
+
constructor(builder, page) {
|
|
318
|
+
this.#page = page;
|
|
319
|
+
this.#surface = new Surface(builder, this.#page);
|
|
320
|
+
}
|
|
321
|
+
/** What the page is drawn with (the same object on every call). */
|
|
322
|
+
surface() {
|
|
323
|
+
return this.#surface;
|
|
324
|
+
}
|
|
325
|
+
/** `/Rotate`: 0, 90, 180 or 270 degrees. */
|
|
326
|
+
rotate(degrees) {
|
|
327
|
+
this.#page.run((page) => page.rotate(degrees));
|
|
328
|
+
return this;
|
|
329
|
+
}
|
|
330
|
+
/** `/UserUnit`, for pages larger than 14,400 units. */
|
|
331
|
+
userUnit(unit) {
|
|
332
|
+
this.#page.run((page) => page.userUnit(unit));
|
|
333
|
+
return this;
|
|
334
|
+
}
|
|
335
|
+
/** `/CropBox` (the visible region), in the media box's page space. */
|
|
336
|
+
cropBox(rect) {
|
|
337
|
+
return this.#box("crop", rect);
|
|
338
|
+
}
|
|
339
|
+
/** `/BleedBox`. */
|
|
340
|
+
bleedBox(rect) {
|
|
341
|
+
return this.#box("bleed", rect);
|
|
342
|
+
}
|
|
343
|
+
/** `/TrimBox`. */
|
|
344
|
+
trimBox(rect) {
|
|
345
|
+
return this.#box("trim", rect);
|
|
346
|
+
}
|
|
347
|
+
/** `/ArtBox`. */
|
|
348
|
+
artBox(rect) {
|
|
349
|
+
return this.#box("art", rect);
|
|
350
|
+
}
|
|
351
|
+
#box(kind, rect) {
|
|
352
|
+
this.#page.run((page) => page.setBox(kind, rect[0], rect[1], rect[2], rect[3]));
|
|
353
|
+
return this;
|
|
354
|
+
}
|
|
355
|
+
/**
|
|
356
|
+
* Writes the page into its builder and frees the page's WASM side; the page takes no more
|
|
357
|
+
* drawing afterwards (`builder-finished`).
|
|
358
|
+
*
|
|
359
|
+
* @returns the page's ID.
|
|
360
|
+
* @throws {@link LaminaPdfError} `invalid-geometry`, `builder-finished`.
|
|
361
|
+
*/
|
|
362
|
+
finish() {
|
|
363
|
+
try {
|
|
364
|
+
return this.#page.run((page) => page.finish());
|
|
365
|
+
}
|
|
366
|
+
finally {
|
|
367
|
+
// After a trap, `close` frees nothing: the instance is about to be replaced.
|
|
368
|
+
this.#page.close();
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
/**
|
|
372
|
+
* Drops the page without writing it and frees its WASM side; a second call does nothing, and
|
|
373
|
+
* any other call afterwards throws `disposed`.
|
|
374
|
+
*/
|
|
375
|
+
free() {
|
|
376
|
+
this.#page.free();
|
|
377
|
+
}
|
|
378
|
+
/** Drops the page at the end of a `using` block (an alias of `free()`). */
|
|
379
|
+
[Symbol.dispose]() {
|
|
380
|
+
this.free();
|
|
381
|
+
}
|
|
382
|
+
}
|
|
383
|
+
disposable(Page);
|
|
384
|
+
/**
|
|
385
|
+
* Builds a new document: pages, navigation and metadata; {@link Builder.finish} returns a
|
|
386
|
+
* {@link Document} to save. Created in the text module when it is loaded (or `text: true`),
|
|
387
|
+
* else in the reading module (text, extract, then base; vector and image pages only). `finish()`
|
|
388
|
+
* frees its WebAssembly memory; to drop it unfinished, use `using` or {@link Builder.free}.
|
|
389
|
+
*
|
|
390
|
+
* @example
|
|
391
|
+
* ```ts
|
|
392
|
+
* await init({ text: true });
|
|
393
|
+
* const b = new Builder({ producer: "my app" });
|
|
394
|
+
* const page = b.page("A4");
|
|
395
|
+
* page.surface().text("Hello, world!", { font: Font.standard("Helvetica"), size: 24, at: [72, 96] });
|
|
396
|
+
* page.finish();
|
|
397
|
+
* const bytes = b.finish().save();
|
|
398
|
+
* ```
|
|
399
|
+
*/
|
|
400
|
+
export class Builder extends Handle {
|
|
401
|
+
#raw;
|
|
402
|
+
#text;
|
|
403
|
+
/** Registered fonts: standard 14 by name, others by their bytes (one PDF font per distinct font). */
|
|
404
|
+
#fonts = new Map();
|
|
405
|
+
/** Pages not yet finished: freed with the builder, so they can't finish into nothing. */
|
|
406
|
+
#pages = new Set();
|
|
407
|
+
/**
|
|
408
|
+
* @param options - version, file ID, producer, creation date, compression, tagging,
|
|
409
|
+
* conformance `profiles`; `text`.
|
|
410
|
+
* @throws {@link LaminaPdfError} `not-initialized`, `text-module-not-loaded`; `unknown-option`.
|
|
411
|
+
*/
|
|
412
|
+
constructor(options = {}) {
|
|
413
|
+
const text = textModule();
|
|
414
|
+
if (options.text === true && text === undefined) {
|
|
415
|
+
throw packageError("text-module-not-loaded", "the text module is not loaded");
|
|
416
|
+
}
|
|
417
|
+
const withText = options.text ?? text !== undefined;
|
|
418
|
+
// Without text, the reading module (text, extract, then base): the built document can then
|
|
419
|
+
// extract text whenever a module that extracts is loaded.
|
|
420
|
+
super("Builder", (withText && text !== undefined ? text : readingModule()));
|
|
421
|
+
this.#text = withText;
|
|
422
|
+
const init = rest(options, ["text", "id"]) ?? {};
|
|
423
|
+
const record = options.id === undefined ? init : { ...init, id: hexId(options.id) };
|
|
424
|
+
this.#raw = this.instance.call((glue) => new glue.WasmBuilder(record));
|
|
425
|
+
watch(this, "Builder");
|
|
426
|
+
}
|
|
427
|
+
/** @throws {@link LaminaPdfError} `disposed`, `instance-reset`, `builder-finished`. */
|
|
428
|
+
get #builder() {
|
|
429
|
+
this.assertLive();
|
|
430
|
+
if (this.#raw === undefined)
|
|
431
|
+
throw packageError("builder-finished", "the builder has already finished");
|
|
432
|
+
return this.#raw;
|
|
433
|
+
}
|
|
434
|
+
/** @internal `image` in this builder's instance. */
|
|
435
|
+
wasmImage(image) {
|
|
436
|
+
return image.in(this.instance);
|
|
437
|
+
}
|
|
438
|
+
/** As `new Builder(options)`. */
|
|
439
|
+
static create(options) {
|
|
440
|
+
return new Builder(options);
|
|
441
|
+
}
|
|
442
|
+
/** Whether this builder draws in the text module (fonts and text). */
|
|
443
|
+
get hasText() {
|
|
444
|
+
return this.#text;
|
|
445
|
+
}
|
|
446
|
+
/** A new page of a named size or `[width, height]` in points. */
|
|
447
|
+
page(size = "A4") {
|
|
448
|
+
const [w, h] = typeof size === "string" ? namedSize(size) : size;
|
|
449
|
+
const raw = this.call(() => this.#builder.page(w, h));
|
|
450
|
+
const live = new LivePage(raw, this, this.instance, (p) => this.#pages.delete(p));
|
|
451
|
+
this.#pages.add(live);
|
|
452
|
+
return new Page(this, live);
|
|
453
|
+
}
|
|
454
|
+
/**
|
|
455
|
+
* Registers `font` with this builder (otherwise it is registered at first use).
|
|
456
|
+
*
|
|
457
|
+
* @throws {@link LaminaPdfError} `text-module-not-loaded`, `invalid-font`, `font-not-embeddable`.
|
|
458
|
+
*/
|
|
459
|
+
font(font) {
|
|
460
|
+
const raw = this.wasmFont(font);
|
|
461
|
+
return this.call(() => ({ family: raw.family, postscriptName: raw.postscriptName, isStandard: raw.isStandard }));
|
|
462
|
+
}
|
|
463
|
+
/** @internal The font in this builder's instance. */
|
|
464
|
+
wasmFont(font) {
|
|
465
|
+
// A cached font lives in the builder's instance: check it is still the current one.
|
|
466
|
+
this.assertLive();
|
|
467
|
+
const key = font.standard ?? this.#bytesKey(font.bytes ?? new Uint8Array());
|
|
468
|
+
let raw = this.#fonts.get(key);
|
|
469
|
+
if (raw !== undefined)
|
|
470
|
+
return raw;
|
|
471
|
+
if (!this.#text) {
|
|
472
|
+
throw packageError("text-module-not-loaded", "this builder was created without the text module");
|
|
473
|
+
}
|
|
474
|
+
const builder = this.#builder;
|
|
475
|
+
raw = this.call(() => font.bytes !== undefined ? builder.fontBytes(font.bytes) : builder.standardFont(font.standard ?? ""));
|
|
476
|
+
this.#fonts.set(key, raw);
|
|
477
|
+
return raw;
|
|
478
|
+
}
|
|
479
|
+
/** The key of a font program already registered with equal bytes, else `bytes` itself. */
|
|
480
|
+
#bytesKey(bytes) {
|
|
481
|
+
for (const key of this.#fonts.keys()) {
|
|
482
|
+
if (typeof key !== "string" && sameBytes(key, bytes))
|
|
483
|
+
return key;
|
|
484
|
+
}
|
|
485
|
+
return bytes;
|
|
486
|
+
}
|
|
487
|
+
/** Defines the named destination `name`: page `index`, shown as `fit` (default: the page). */
|
|
488
|
+
destination(name, index, fit) {
|
|
489
|
+
this.call(() => this.#builder.destination(name, index, fit));
|
|
490
|
+
return this;
|
|
491
|
+
}
|
|
492
|
+
/** Adds outline (bookmark) items with their children. @returns their IDs, in pre-order. */
|
|
493
|
+
outline(entries) {
|
|
494
|
+
return this.call(() => this.#builder.outline(entries));
|
|
495
|
+
}
|
|
496
|
+
/** The page labels (`i, ii, 1, 2…`), ranges by first page; checked at finish. */
|
|
497
|
+
pageLabels(ranges) {
|
|
498
|
+
this.call(() => this.#builder.pageLabels(ranges));
|
|
499
|
+
return this;
|
|
500
|
+
}
|
|
501
|
+
/** The metadata, written as the Info dictionary and an XMP packet. */
|
|
502
|
+
metadata(metadata) {
|
|
503
|
+
this.call(() => this.#builder.metadata(metadata));
|
|
504
|
+
return this;
|
|
505
|
+
}
|
|
506
|
+
/** The natural language (`/Lang`), a BCP 47 tag. */
|
|
507
|
+
lang(tag) {
|
|
508
|
+
this.call(() => this.#builder.lang(tag));
|
|
509
|
+
return this;
|
|
510
|
+
}
|
|
511
|
+
/**
|
|
512
|
+
* Attaches a file: PDF/A-3b's associated files, such as an e-invoice's XML. The same name
|
|
513
|
+
* again replaces the file. PDF/A-2b and PDF/A-2u refuse attachments at {@link Builder.finish},
|
|
514
|
+
* and every PDF/A profile refuses one without a MIME type there.
|
|
515
|
+
*
|
|
516
|
+
* @param name - the file name viewers show.
|
|
517
|
+
* @param bytes - the file's contents.
|
|
518
|
+
* @param mime - its MIME type, such as `text/xml`.
|
|
519
|
+
* @param options - how the file relates to the document (`relationship`, default
|
|
520
|
+
* `unspecified`), its `description` and `modDate`.
|
|
521
|
+
* @throws {@link LaminaPdfError} `invalid-argument` for a `modDate` that isn't a PDF date,
|
|
522
|
+
* `unknown-option` for an unknown key, `builder-finished` after {@link Builder.finish}.
|
|
523
|
+
*/
|
|
524
|
+
attach(name, bytes, mime, options) {
|
|
525
|
+
this.call(() => this.#builder.attach(name, bytes, mime, options));
|
|
526
|
+
return this;
|
|
527
|
+
}
|
|
528
|
+
/** How viewers present the document when it opens. */
|
|
529
|
+
viewerPreferences(preferences) {
|
|
530
|
+
this.call(() => this.#builder.viewerPreferences(preferences));
|
|
531
|
+
return this;
|
|
532
|
+
}
|
|
533
|
+
/**
|
|
534
|
+
* Writes fonts, links, the page tree, outline and metadata; the builder (and its unfinished
|
|
535
|
+
* pages) take no more calls afterwards.
|
|
536
|
+
*
|
|
537
|
+
* @returns the new document (unsaved; its save is a full rewrite).
|
|
538
|
+
* @throws {@link LaminaPdfError} `page-index-out-of-range`, `unknown-destination`,
|
|
539
|
+
* `invalid-page-labels`, `invalid-geometry`, `subset-failed`, `builder-finished`; under a
|
|
540
|
+
* profile (`profiles` in the options), the first rule the document breaks, with that rule's
|
|
541
|
+
* code (the error reference lists them, from `profile-version-conflict` on).
|
|
542
|
+
*/
|
|
543
|
+
finish() {
|
|
544
|
+
const builder = this.#builder;
|
|
545
|
+
try {
|
|
546
|
+
return new Document(this.call(() => builder.finish()), this.instance);
|
|
547
|
+
}
|
|
548
|
+
finally {
|
|
549
|
+
// After a trap, `#close` frees nothing: the instance is about to be replaced.
|
|
550
|
+
this.#close();
|
|
551
|
+
}
|
|
552
|
+
}
|
|
553
|
+
/**
|
|
554
|
+
* Frees the raw builder, its fonts and unfinished pages, and keeps the handle: later calls throw
|
|
555
|
+
* `builder-finished` (`free()` makes them `disposed`).
|
|
556
|
+
*/
|
|
557
|
+
#close() {
|
|
558
|
+
// Its WASM side is freed (or gone with its instance): not a leak.
|
|
559
|
+
forget(this);
|
|
560
|
+
for (const page of [...this.#pages])
|
|
561
|
+
page.close();
|
|
562
|
+
if (this.owned) {
|
|
563
|
+
for (const font of this.#fonts.values())
|
|
564
|
+
font.free();
|
|
565
|
+
this.#raw?.free();
|
|
566
|
+
}
|
|
567
|
+
this.#fonts.clear();
|
|
568
|
+
this.#raw = undefined;
|
|
569
|
+
}
|
|
570
|
+
release() {
|
|
571
|
+
this.#close();
|
|
572
|
+
}
|
|
573
|
+
}
|
|
574
|
+
//# sourceMappingURL=builder.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"defined.d.ts","sourceRoot":"","sources":["../src/defined.ts"],"names":[],"mappings":"AAGA,wGAAwG;AACxG,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;CAAE,CAIlG"}
|
package/dist/defined.js
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
// Records without their `undefined` members: the SDK's option objects go through it before they
|
|
2
|
+
// reach the WebAssembly or cross to the worker.
|
|
3
|
+
/** `record` without its `undefined` members, so the result holds under `exactOptionalPropertyTypes`. */
|
|
4
|
+
export function defined(record) {
|
|
5
|
+
return Object.fromEntries(Object.entries(record).filter(([, v]) => v !== undefined));
|
|
6
|
+
}
|
|
7
|
+
//# sourceMappingURL=defined.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"defined.js","sourceRoot":"","sources":["../src/defined.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,gDAAgD;AAEhD,wGAAwG;AACxG,MAAM,UAAU,OAAO,CAAmB,MAAS;IACjD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAElF,CAAC;AACJ,CAAC"}
|