@awacloud/pdf 0.0.0-stage → 1.0.0

package/src/annot/projection.js

@@ -0,0 +1,52 @@
+// Copyright (c) 2026 AwaCloud SAS
+// Author: Matthieu Bouilloux
+// SPDX-License-Identifier: AGPL-3.0-only
+// Dual-licensed; see the NOTICE file for licensing and any additional terms.
+
+/**
+ * @fileoverview Projection (3D-view) annotation per ISO 32000-2:2020
+ * §13.6.6.2 (Projections), and legacy Movie/Sound annotations
+ * (Annex H, deprecated in PDF 2.0 but still parsed for completeness).
+ *
+ * Projection subtype-specific entries:
+ *   /V  dict|name — 3D-view (or referenced view name)
+ *   /B  dict      — 3D-state (background, etc.)
+ *
+ * @module pdf/annot/projection
+ */
+
+/**
+ * Module factory.
+ */
+import { pdfErrors } from '../errors.js';
+import { pdfParser } from '../syntax/parser.js';
+import { pdfAnnot } from './annot.js';
+
+export const pdfProjectionAnnot = {
+    name: 'pdfProjectionAnnot',
+    dependencies: ['pdfErrors', 'pdfParser', 'pdfAnnot'],
+    deps: [pdfErrors, pdfParser, pdfAnnot],
+    factory(errors, parser, annot) {
+        const { ParseError } = errors;
+        const { isType } = parser;
+        const { typeBaseAnnot, captureExtras } = annot;
+
+        const KNOWN = new Set(['V', 'B']);
+
+        function typeProjectionAnnot(dict) {
+            const base = typeBaseAnnot(dict);
+            if (base.subtype && base.subtype !== 'Projection') {
+                throw new ParseError('pdf/annot/projection/bad-subtype',
+                    '/Subtype must be /Projection',
+                    { context: { actual: base.subtype } });
+            }
+            const e = dict.entries;
+            base.v = e.V || null;
+            base.b = isType(e.B, 'dict') ? e.B : null;
+            captureExtras(base, dict, KNOWN);
+            return base;
+        }
+
+        return { typeProjectionAnnot };
+    }
+};

package/src/annot/redact.js

@@ -0,0 +1,87 @@
+// Copyright (c) 2026 AwaCloud SAS
+// Author: Matthieu Bouilloux
+// SPDX-License-Identifier: AGPL-3.0-only
+// Dual-licensed; see the NOTICE file for licensing and any additional terms.
+
+/**
+ * @fileoverview Redact annotation (ISO 32000-2 §12.5.6.21) — read-side typing only; applying a redaction (content removal) is not implemented.
+ *
+ * Subtype-specific entries:
+ *   /QuadPoints  array of numbers (multiple of 8) — redaction regions
+ *   /IC          array — interior color (post-redaction fill)
+ *   /RO          stream — replacement appearance for the redacted area
+ *   /OverlayText string — text overlaid after applying the redaction
+ *   /Repeat      boolean — repeat overlay text to fill the region
+ *   /DA          string — default appearance for /OverlayText
+ *   /Q           int    — quadding for /OverlayText
+ *
+ * @module pdf/annot/redact
+ */
+
+/**
+ * Module factory.
+ */
+import { pdfErrors } from '../errors.js';
+import { pdfParser } from '../syntax/parser.js';
+import { pdfAnnot } from './annot.js';
+
+export const pdfRedactAnnot = {
+    name: 'pdfRedactAnnot',
+    dependencies: ['pdfErrors', 'pdfParser', 'pdfAnnot'],
+    deps: [pdfErrors, pdfParser, pdfAnnot],
+    factory(errors, parser, annot) {
+        const { ParseError } = errors;
+        const { isType } = parser;
+        const { typeBaseAnnot, captureExtras } = annot;
+
+        const KNOWN = new Set([
+            'QuadPoints', 'IC', 'RO', 'OverlayText', 'Repeat', 'DA', 'Q'
+        ]);
+
+        function typeRedactAnnot(dict) {
+            const base = typeBaseAnnot(dict);
+            if (base.subtype && base.subtype !== 'Redact') {
+                throw new ParseError('pdf/annot/redact/bad-subtype',
+                    '/Subtype must be /Redact',
+                    { context: { actual: base.subtype } });
+            }
+            const e = dict.entries;
+            base.quadPoints  = toNumArray(e.QuadPoints, 'pdf/annot/redact/bad-quadpoints');
+            if (base.quadPoints && base.quadPoints.length % 8 !== 0) {
+                throw new ParseError('pdf/annot/redact/bad-quadpoints',
+                    '/QuadPoints length must be a multiple of 8',
+                    { context: { length: base.quadPoints.length } });
+            }
+            base.ic          = toNumArray(e.IC, 'pdf/annot/redact/bad-ic');
+            base.ro          = e.RO || null;
+            base.overlayText = isType(e.OverlayText, 'string') ? e.OverlayText.value : null;
+            base.repeat      = isType(e.Repeat, 'bool') ? !!e.Repeat.value : false;
+            base.da          = isType(e.DA, 'string') ? e.DA.value : null;
+            base.q           = (e.Q && (e.Q.type === 'int' || e.Q.type === 'real'))
+                ? (e.Q.value | 0) : 0;
+            captureExtras(base, dict, KNOWN);
+            return base;
+        }
+
+        function toNumArray(v, errCode) {
+            if (!v) return null;
+            if (v.type !== 'array') {
+                throw new ParseError(errCode,
+                    'expected an array of numbers',
+                    { context: { kind: v.type } });
+            }
+            const out = [];
+            for (const it of v.items) {
+                if (!it || (it.type !== 'int' && it.type !== 'real')) {
+                    throw new ParseError(errCode,
+                        'array entries must be numbers',
+                        { context: { kind: it && it.type } });
+                }
+                out.push(it.value);
+            }
+            return out;
+        }
+
+        return { typeRedactAnnot };
+    }
+};

package/src/annot/square.js

@@ -0,0 +1,132 @@
+// Copyright (c) 2026 AwaCloud SAS
+// Author: Matthieu Bouilloux
+// SPDX-License-Identifier: AGPL-3.0-only
+// Dual-licensed; see the NOTICE file for licensing and any additional terms.
+
+/**
+ * @fileoverview Shape annotations per ISO 32000-2:2020 §12.5.6.7–9.
+ *
+ * Subtypes handled: Square, Circle, Line, Polygon, PolyLine.
+ *
+ * Common-ish entries:
+ *   /BS    border style dict       (already on base; explicit here)
+ *   /IC    interior color array
+ *   /LE    line-ending styles array of 2 names
+ *
+ * Square/Circle: /RD (rectangle differences).
+ * Line:          /L (x1,y1,x2,y2), /LL, /LLE, /Cap, /CP, /Measure, /IT.
+ * Polygon/PolyLine: /Vertices, /Measure, /IT, /Path.
+ *
+ * @module pdf/annot/square
+ */
+
+/**
+ * Module factory.
+ */
+import { pdfErrors } from '../errors.js';
+import { pdfParser } from '../syntax/parser.js';
+import { pdfAnnot } from './annot.js';
+
+export const pdfShapeAnnot = {
+    name: 'pdfShapeAnnot',
+    dependencies: ['pdfErrors', 'pdfParser', 'pdfAnnot'],
+    deps: [pdfErrors, pdfParser, pdfAnnot],
+    factory(errors, parser, annot) {
+        const { ParseError } = errors;
+        const { isType } = parser;
+        const { typeBaseAnnot, captureExtras } = annot;
+
+        const VALID = new Set(['Square', 'Circle', 'Line', 'Polygon', 'PolyLine']);
+        const KNOWN = new Set([
+            'RD', 'IC', 'L', 'LE', 'LL', 'LLE', 'Cap', 'CP', 'Measure', 'IT',
+            'Vertices', 'Path'
+        ]);
+
+        function typeShapeAnnot(dict, expected) {
+            if (!VALID.has(expected)) {
+                throw new ParseError('pdf/annot/shape/bad-expected',
+                    'unsupported shape subtype',
+                    { context: { expected } });
+            }
+            const base = typeBaseAnnot(dict);
+            if (base.subtype && base.subtype !== expected) {
+                throw new ParseError('pdf/annot/shape/bad-subtype',
+                    '/Subtype mismatch for shape typer',
+                    { context: { expected, actual: base.subtype } });
+            }
+            const e = dict.entries;
+
+            base.ic = toNumArray(e.IC, 'pdf/annot/shape/bad-ic');
+
+            if (expected === 'Square' || expected === 'Circle') {
+                base.rd = toNumArray(e.RD, 'pdf/annot/shape/bad-rd');
+            }
+            if (expected === 'Line') {
+                base.l   = toNumArray(e.L, 'pdf/annot/shape/bad-l');
+                base.le  = toNameArray(e.LE, 'pdf/annot/shape/bad-le');
+                base.ll  = toNum(e.LL, null);
+                base.lle = toNum(e.LLE, null);
+                base.cap = isType(e.Cap, 'bool') ? !!e.Cap.value : false;
+                base.cp  = isType(e.CP, 'name') ? e.CP.value : null;
+                base.it  = isType(e.IT, 'name') ? e.IT.value : null;
+                base.measure = isType(e.Measure, 'dict') ? e.Measure : null;
+            }
+            if (expected === 'Polygon' || expected === 'PolyLine') {
+                base.vertices = toNumArray(e.Vertices, 'pdf/annot/shape/bad-vertices');
+                base.le       = toNameArray(e.LE, 'pdf/annot/shape/bad-le');
+                base.it       = isType(e.IT, 'name') ? e.IT.value : null;
+                base.measure  = isType(e.Measure, 'dict') ? e.Measure : null;
+                base.path     = isType(e.Path, 'array') ? e.Path : null;
+            }
+
+            captureExtras(base, dict, KNOWN);
+            return base;
+        }
+
+        function toNumArray(v, errCode) {
+            if (!v) return null;
+            if (v.type !== 'array') {
+                throw new ParseError(errCode,
+                    'expected an array of numbers',
+                    { context: { kind: v.type } });
+            }
+            const out = [];
+            for (const it of v.items) {
+                if (!it || (it.type !== 'int' && it.type !== 'real')) {
+                    throw new ParseError(errCode,
+                        'array entries must be numbers',
+                        { context: { kind: it && it.type } });
+                }
+                out.push(it.value);
+            }
+            return out;
+        }
+
+        function toNameArray(v, errCode) {
+            if (!v) return null;
+            if (v.type !== 'array') {
+                throw new ParseError(errCode,
+                    'expected an array of names',
+                    { context: { kind: v.type } });
+            }
+            const out = [];
+            for (const it of v.items) {
+                if (!it || it.type !== 'name') {
+                    throw new ParseError(errCode,
+                        'array entries must be names',
+                        { context: { kind: it && it.type } });
+                }
+                out.push(it.value);
+            }
+            return out;
+        }
+
+        function toNum(v, dflt) {
+            if (!v) return dflt;
+            if (v.type !== 'int' && v.type !== 'real') return dflt;
+            return v.value;
+        }
+
+        return { typeShapeAnnot };
+    }
+};

package/src/annot/stamp.js

@@ -0,0 +1,48 @@
+// Copyright (c) 2026 AwaCloud SAS
+// Author: Matthieu Bouilloux
+// SPDX-License-Identifier: AGPL-3.0-only
+// Dual-licensed; see the NOTICE file for licensing and any additional terms.
+
+/**
+ * @fileoverview Rubber-stamp annotation per ISO 32000-2:2020 §12.5.6.12.
+ *
+ * Subtype-specific entries:
+ *   /Name  name — icon name (Approved, Confidential, Draft, …)
+ *
+ * @module pdf/annot/stamp
+ */
+
+/**
+ * Module factory.
+ */
+import { pdfErrors } from '../errors.js';
+import { pdfParser } from '../syntax/parser.js';
+import { pdfAnnot } from './annot.js';
+
+export const pdfStampAnnot = {
+    name: 'pdfStampAnnot',
+    dependencies: ['pdfErrors', 'pdfParser', 'pdfAnnot'],
+    deps: [pdfErrors, pdfParser, pdfAnnot],
+    factory(errors, parser, annot) {
+        const { ParseError } = errors;
+        const { isType } = parser;
+        const { typeBaseAnnot, captureExtras } = annot;
+
+        const KNOWN = new Set(['Name']);
+
+        function typeStampAnnot(dict) {
+            const base = typeBaseAnnot(dict);
+            if (base.subtype && base.subtype !== 'Stamp') {
+                throw new ParseError('pdf/annot/stamp/bad-subtype',
+                    '/Subtype must be /Stamp',
+                    { context: { actual: base.subtype } });
+            }
+            const e = dict.entries;
+            base.iconName = isType(e.Name, 'name') ? e.Name.value : null;
+            captureExtras(base, dict, KNOWN);
+            return base;
+        }
+
+        return { typeStampAnnot };
+    }
+};

package/src/annot/text.js

@@ -0,0 +1,54 @@
+// Copyright (c) 2026 AwaCloud SAS
+// Author: Matthieu Bouilloux
+// SPDX-License-Identifier: AGPL-3.0-only
+// Dual-licensed; see the NOTICE file for licensing and any additional terms.
+
+/**
+ * @fileoverview Text (sticky-note) annotation per ISO 32000-2:2020 §12.5.6.4.
+ *
+ * Subtype-specific entries:
+ *   /Open       boolean — pop-up window initial state
+ *   /Name       name    — icon name (e.g. Note, Comment, Help)
+ *   /State      string  — annotation state (e.g. Marked, Unmarked)
+ *   /StateModel string  — model the state belongs to
+ *
+ * @module pdf/annot/text
+ */
+
+/**
+ * Module factory.
+ */
+import { pdfErrors } from '../errors.js';
+import { pdfParser } from '../syntax/parser.js';
+import { pdfAnnot } from './annot.js';
+
+export const pdfTextAnnot = {
+    name: 'pdfTextAnnot',
+    dependencies: ['pdfErrors', 'pdfParser', 'pdfAnnot'],
+    deps: [pdfErrors, pdfParser, pdfAnnot],
+    factory(errors, parser, annot) {
+        const { ParseError } = errors;
+        const { isType } = parser;
+        const { typeBaseAnnot, captureExtras } = annot;
+
+        const KNOWN = new Set(['Open', 'Name', 'State', 'StateModel']);
+
+        function typeTextAnnot(dict) {
+            const base = typeBaseAnnot(dict);
+            if (base.subtype && base.subtype !== 'Text') {
+                throw new ParseError('pdf/annot/text/bad-subtype',
+                    '/Subtype must be /Text',
+                    { context: { actual: base.subtype } });
+            }
+            const e = dict.entries;
+            base.open       = isType(e.Open, 'bool') ? !!e.Open.value : false;
+            base.iconName   = isType(e.Name, 'name') ? e.Name.value : null;
+            base.state      = isType(e.State, 'string') ? e.State.value : null;
+            base.stateModel = isType(e.StateModel, 'string') ? e.StateModel.value : null;
+            captureExtras(base, dict, KNOWN);
+            return base;
+        }
+
+        return { typeTextAnnot };
+    }
+};

package/src/annot/widget.js

@@ -0,0 +1,61 @@
+// Copyright (c) 2026 AwaCloud SAS
+// Author: Matthieu Bouilloux
+// SPDX-License-Identifier: AGPL-3.0-only
+// Dual-licensed; see the NOTICE file for licensing and any additional terms.
+
+/**
+ * @fileoverview Widget annotation per ISO 32000-2:2020 §12.5.6.19.
+ *
+ * Widgets are the annotation side of form fields. This typer addresses
+ * only the annotation entries — field typing lives in `pdf/form/*`.
+ *
+ * Subtype-specific entries:
+ *   /H       name — highlight mode (N, I, O, P, T)
+ *   /MK      dict — appearance characteristics
+ *   /A       dict — action triggered when activated
+ *   /AA      dict — additional actions
+ *   /BS      dict — border style (on base)
+ *   /Parent  ref  — parent field (hierarchical)
+ *
+ * @module pdf/annot/widget
+ */
+
+/**
+ * Module factory.
+ */
+import { pdfErrors } from '../errors.js';
+import { pdfParser } from '../syntax/parser.js';
+import { pdfAnnot } from './annot.js';
+
+export const pdfWidgetAnnot = {
+    name: 'pdfWidgetAnnot',
+    dependencies: ['pdfErrors', 'pdfParser', 'pdfAnnot'],
+    deps: [pdfErrors, pdfParser, pdfAnnot],
+    factory(errors, parser, annot) {
+        const { ParseError } = errors;
+        const { isType } = parser;
+        const { typeBaseAnnot, captureExtras } = annot;
+
+        const KNOWN = new Set(['H', 'MK', 'A', 'AA', 'Parent']);
+
+        function typeWidgetAnnot(dict) {
+            const base = typeBaseAnnot(dict);
+            if (base.subtype && base.subtype !== 'Widget') {
+                throw new ParseError('pdf/annot/widget/bad-subtype',
+                    '/Subtype must be /Widget',
+                    { context: { actual: base.subtype } });
+            }
+            const e = dict.entries;
+            base.h      = isType(e.H, 'name') ? e.H.value : null;
+            base.mk     = isType(e.MK, 'dict') ? e.MK : null;
+            base.action = isType(e.A,  'dict') ? e.A  : null;
+            base.aa     = isType(e.AA, 'dict') ? e.AA : null;
+            base.parent = e.Parent && e.Parent.type === 'ref'
+                ? { num: e.Parent.num, gen: e.Parent.gen } : null;
+            captureExtras(base, dict, KNOWN);
+            return base;
+        }
+
+        return { typeWidgetAnnot };
+    }
+};

package/src/associatedFiles/associatedFiles.js

@@ -0,0 +1,86 @@
+// Copyright (c) 2026 AwaCloud SAS
+// Author: Matthieu Bouilloux
+// SPDX-License-Identifier: AGPL-3.0-only
+// Dual-licensed; see the NOTICE file for licensing and any additional terms.
+
+/**
+ * @fileoverview Associated Files typing per ISO 32000-2:2020 annex
+ * "PDF20_AN002 — Associated Files".
+ *
+ * PDF 2.0 introduces `/AF`, an array of indirect references to File
+ * Specification dicts, attachable to the Catalog, a Page, an XObject,
+ * a Form Field, an Annotation, a Mark, or a Structure Element. Each
+ * referenced filespec must carry an `/AFRelationship` name.
+ *
+ * Standard relationships: Source, Data, Alternative, Supplement,
+ * EncryptedPayload, FormData, Schema, Unspecified.
+ *
+ * @module pdf/associatedFiles/associatedFiles
+ */
+
+/**
+ * Module factory.
+ */
+import { pdfErrors } from '../errors.js';
+import { pdfParser } from '../syntax/parser.js';
+
+export const pdfAssociatedFiles = {
+    name: 'pdfAssociatedFiles',
+    dependencies: ['pdfErrors', 'pdfParser'],
+    deps: [pdfErrors, pdfParser],
+    factory(errors, parser) {
+        const { ParseError } = errors;
+        const { isType } = parser;
+
+        const STANDARD = new Set([
+            'Source', 'Data', 'Alternative', 'Supplement',
+            'EncryptedPayload', 'FormData', 'Schema', 'Unspecified'
+        ]);
+
+        function typeAssociatedFiles(arr, resolveRef) {
+            if (!isType(arr, 'array')) {
+                throw new ParseError('pdf/af/not-array',
+                    '/AF must be an array',
+                    { context: { type: arr && arr.type } });
+            }
+            const out = [];
+            for (let i = 0; i < arr.items.length; i++) {
+                const it = arr.items[i];
+                let dict = it;
+                if (it.type === 'ref') {
+                    if (typeof resolveRef !== 'function') {
+                        out.push({ ref: it, resolved: false });
+                        continue;
+                    }
+                    dict = resolveRef(it);
+                }
+                if (!isType(dict, 'dict')) {
+                    throw new ParseError('pdf/af/bad-entry',
+                        '/AF entries must resolve to a dict',
+                        { context: { index: i, type: dict && dict.type } });
+                }
+                const rel = dict.entries.AFRelationship;
+                let relValue = null, standard = false;
+                if (rel) {
+                    if (rel.type !== 'name') {
+                        throw new ParseError('pdf/af/bad-relationship',
+                            '/AFRelationship must be a name',
+                            { context: { index: i, type: rel.type } });
+                    }
+                    relValue = rel.value;
+                    standard = STANDARD.has(relValue);
+                }
+                const rec = {
+                    filespec: dict,
+                    relationship: relValue,
+                    standard
+                };
+                if (it.type === 'ref') rec.ref = { num: it.num, gen: it.gen };
+                out.push(rec);
+            }
+            return out;
+        }
+
+        return { typeAssociatedFiles };
+    }
+};

package/src/bundles/pdf-full.js

@@ -0,0 +1,91 @@
+// Copyright (c) 2026 AwaCloud SAS
+// Author: Matthieu Bouilloux
+// SPDX-License-Identifier: AGPL-3.0-only
+// Dual-licensed; see the NOTICE file for licensing and any additional terms.
+
+/**
+ * @fileoverview `@awacloud/pdf/bundles/pdf-full` — full PDF 2.0 strict bundle.
+ *
+ * Pure fw factory descriptor. Declares the core `pdf` orchestrator and
+ * every P0/P1/P2/P3 extra **except** the `legacy-*` family as
+ * dependencies. The runtime resolves every dependency transitively and
+ * passes the already-constructed instances to the factory, which wires
+ * them into the `pdf` core via `pdf.use(...)` and returns the enriched
+ * instance.
+ *
+ * Consumption is exclusively declarative — register the descriptor in a
+ * `ModuleRuntime` and call `runtime.resolve('pdfFullBundle')`.
+ *
+ * Suitable for callers that need 100% PDF 2.0 strict coverage. For
+ * PDF 1.7 read support + 1.7→2.0 conversion, use `pdf-legacy` instead.
+ *
+ * @module pdf/bundles/pdf-full
+ */
+
+import { pdf } from '../pdf.js';
+import { pdfContentOpsExtended } from '../extra/content-ops-extended.js';
+import { pdfFontCidTyped } from '../extra/font-cid-typed.js';
+import { pdfFontColorTagging } from '../extra/font-color-tagging.js';
+import { pdfTaggedPdfTyped } from '../extra/tagged-pdf-typed.js';
+import { pdfAnnotExtended } from '../extra/annot-extended.js';
+import { pdfAOutputIntent } from '../extra/pdf-a-output-intent.js';
+import { pdfUaTagged } from '../extra/pdf-ua-tagged.js';
+import { pdfFormActionsExtended } from '../extra/form-actions-extended.js';
+import { pdfColorSpacesExtended } from '../extra/color-spaces-extended.js';
+import { pdfShadingTyped } from '../extra/shading-typed.js';
+import { pdfTransparencyTyped } from '../extra/transparency-typed.js';
+import { pdfSigPades } from '../extra/sig-pades.js';
+import { pdfSigAesGcm } from '../extra/sig-aes-gcm.js';
+import { pdfDocumentParts } from '../extra/document-parts.js';
+import { pdfRedactionIso32005 } from '../extra/redaction-iso32005.js';
+import { pdfXPrepress } from '../extra/pdf-x-prepress.js';
+import { pdfWellTagged } from '../extra/well-tagged-pdf.js';
+import { pdfOptionalContentExtended } from '../extra/optional-content-extended.js';
+import { pdfEmbeddedFilesPortfolio } from '../extra/embedded-files-portfolio.js';
+import { pdfAssociatedFiles2 } from '../extra/associated-files.js';
+import { pdfXmpExtended } from '../extra/xmp-extended.js';
+import { pdfLinearizationWrite } from '../extra/linearization-write.js';
+import { pdf3dRichMedia } from '../extra/3d-richmedia.js';
+import { pdfJbig2Read } from '../extra/jbig2-read.js';
+import { pdfMisc } from '../extra/misc.js';
+import { pdfInfoDictDeprecated } from '../extra/info-dict-deprecated.js';
+import { pdfSandbox } from '../extra/pdf-sandbox.js';
+
+export const pdfFullBundle = {
+    name: 'pdfFullBundle',
+    dependencies: [
+        'pdf',
+        'pdfContentOpsExtended', 'pdfFontCidTyped', 'pdfFontColorTagging',
+        'pdfTaggedPdfTyped', 'pdfAnnotExtended', 'pdfAOutputIntent', 'pdfUaTagged',
+        'pdfFormActionsExtended', 'pdfColorSpacesExtended', 'pdfShadingTyped',
+        'pdfTransparencyTyped', 'pdfSigPades', 'pdfSigAesGcm', 'pdfDocumentParts',
+        'pdfRedactionIso32005', 'pdfXPrepress', 'pdfWellTagged',
+        'pdfOptionalContentExtended', 'pdfEmbeddedFilesPortfolio',
+        'pdfAssociatedFiles2', 'pdfXmpExtended',
+        'pdfLinearizationWrite', 'pdf3dRichMedia', 'pdfJbig2Read', 'pdfMisc',
+        'pdfInfoDictDeprecated', 'pdfSandbox'
+    ],
+    deps: [pdf, pdfContentOpsExtended, pdfFontCidTyped, pdfFontColorTagging, pdfTaggedPdfTyped, pdfAnnotExtended, pdfAOutputIntent, pdfUaTagged, pdfFormActionsExtended, pdfColorSpacesExtended, pdfShadingTyped, pdfTransparencyTyped, pdfSigPades, pdfSigAesGcm, pdfDocumentParts, pdfRedactionIso32005, pdfXPrepress, pdfWellTagged, pdfOptionalContentExtended, pdfEmbeddedFilesPortfolio, pdfAssociatedFiles2, pdfXmpExtended, pdfLinearizationWrite, pdf3dRichMedia, pdfJbig2Read, pdfMisc, pdfInfoDictDeprecated, pdfSandbox],
+    factory(pdf, ...instances) {
+        const names = [
+            'pdfContentOpsExtended', 'pdfFontCidTyped', 'pdfFontColorTagging',
+            'pdfTaggedPdfTyped', 'pdfAnnotExtended', 'pdfAOutputIntent', 'pdfUaTagged',
+            'pdfFormActionsExtended', 'pdfColorSpacesExtended', 'pdfShadingTyped',
+            'pdfTransparencyTyped', 'pdfSigPades', 'pdfSigAesGcm', 'pdfDocumentParts',
+            'pdfRedactionIso32005', 'pdfXPrepress', 'pdfWellTagged',
+            'pdfOptionalContentExtended', 'pdfEmbeddedFilesPortfolio',
+            'pdfAssociatedFiles2', 'pdfXmpExtended',
+            'pdfLinearizationWrite', 'pdf3dRichMedia', 'pdfJbig2Read', 'pdfMisc',
+            'pdfInfoDictDeprecated', 'pdfSandbox'
+        ];
+        for (let i = 0; i < names.length; i++) {
+            const name = names[i];
+            const inst = instances[i];
+            pdf.use({
+                name,
+                register() { return { [name]: inst }; }
+            });
+        }
+        return pdf;
+    }
+};