Extras — L3+ opt-in coverage

Optional modules beyond core PDF 2.0. Each is a { name, dependencies, factory } descriptor, consumable directly via runtime.resolve(name) or through pdfApi.use(...). Grouped by phase priority.

P0 — critical coverage (7)

P1 — extended coverage (14)

P2 — PDF 2.0 long tail (3)

P3 — Catalog + Info tail, sandbox (3)

Legacy — PDF 1.7 read + deprecated filters (5)

Common pattern

import { ModuleRuntime } from '@awacloud/fw/core/runtime.js';
import { fw_require, pkg_require, modules, extras, bundle } from '@awacloud/pdf';

const rt = new ModuleRuntime();
for (const m of fw_require)  rt.register(m);
for (const m of pkg_require) rt.register(m);
for (const m of modules)     rt.register(m);
for (const m of extras)      rt.register(m);
for (const m of bundle)      rt.register(m);

const ext = rt.resolve('pdfContentOpsExtended');
ext.typeExtGState(dict);

Unlike the modules array, extras entries are not part of the package root's additive re-export list (import { pdfContentOpsExtended } from '@awacloud/pdf' does not exist) — each extra is only reachable through the extras array above, through ModuleRuntime, or through its own ./extra/* export subpath. A sibling composer that wants to avoid building a runtime can import the extra directly by subpath and resolve its declared dependencies (always core modules members, reachable from the package root) itself:

import { pdfContentOpsExtended } from '@awacloud/pdf/extra/content-ops-extended';
import { pdfErrors, pdfParserObj } from '@awacloud/pdf';

const ext = pdfContentOpsExtended.factory(pdfErrors.factory(), pdfParserObj.factory());
ext.typeExtGState(dict);

See also

• Bundles
• API index