@file-viewer/core 2.4.0 → 3.0.1

package/dist/registry/registry.js

@@ -11,10 +11,14 @@ const getAutoRendererBucket = () => {
     }
     return host[autoRendererBucketKey];
 };
-const normalizeDefinition = (definition) => ({
-    ...definition,
-    extensions: definition.extensions.map(normalizeFileExtension),
-});
+const normalizeDefinition = (definition) => {
+    var _a;
+    return ({
+        ...definition,
+        extensions: definition.extensions.map(normalizeFileExtension),
+        enhancesExtensions: (_a = definition.enhancesExtensions) === null || _a === void 0 ? void 0 : _a.map(normalizeFileExtension),
+    });
+};
 export const createRendererRegistry = (initialDefinitions = DEFAULT_RENDERER_DEFINITIONS) => {
     const byId = new Map();
     const byExtension = new Map();
@@ -72,6 +76,142 @@ export const createRendererRegistry = (initialDefinitions = DEFAULT_RENDERER_DEF
         },
     };
 };
+const collectRendererEnhancementClaims = (registry, definitions) => {
+    var _a, _b;
+    const normalizedDefinitions = definitions.map(normalizeDefinition);
+    const incomingDefinitionsById = new Map();
+    normalizedDefinitions.forEach(definition => {
+        incomingDefinitionsById.set(definition.id, definition);
+    });
+    const claimsByOwnerAndExtension = new Map();
+    for (const definition of registry.list().map(normalizeDefinition)) {
+        const ownerId = definition.enhancesRendererId;
+        if (!ownerId || !((_a = definition.enhancesExtensions) === null || _a === void 0 ? void 0 : _a.length)) {
+            continue;
+        }
+        const ownedExtensions = new Set(definition.extensions);
+        definition.enhancesExtensions.forEach(extension => {
+            var _a;
+            if (ownedExtensions.has(extension) &&
+                ((_a = registry.getByExtension(extension)) === null || _a === void 0 ? void 0 : _a.id) === definition.id) {
+                claimsByOwnerAndExtension.set(`${ownerId}\u0000${extension}`, {
+                    enhancerId: definition.id,
+                    ownerId,
+                    extension,
+                });
+            }
+        });
+    }
+    for (const definition of normalizedDefinitions) {
+        const declaresOwner = definition.enhancesRendererId !== undefined;
+        const declaresExtensions = definition.enhancesExtensions !== undefined;
+        if (declaresOwner !== declaresExtensions) {
+            throw new Error(`Renderer "${definition.id}" enhancement must declare both enhancesRendererId and enhancesExtensions.`);
+        }
+        if (!declaresOwner || !declaresExtensions) {
+            continue;
+        }
+        const ownerId = ((_b = definition.enhancesRendererId) === null || _b === void 0 ? void 0 : _b.trim()) || '';
+        const enhancedExtensions = definition.enhancesExtensions || [];
+        if (!ownerId) {
+            throw new Error(`Renderer "${definition.id}" enhancement owner must not be empty.`);
+        }
+        if (!enhancedExtensions.length) {
+            throw new Error(`Renderer "${definition.id}" enhancement extensions must not be empty.`);
+        }
+        if (ownerId === definition.id) {
+            throw new Error(`Renderer "${definition.id}" cannot enhance its own definition.`);
+        }
+        const directlyOwnedExtensions = new Set(definition.extensions);
+        for (const extension of enhancedExtensions) {
+            if (!extension) {
+                throw new Error(`Renderer "${definition.id}" enhancement extension must not be empty.`);
+            }
+            if (directlyOwnedExtensions.has(extension)) {
+                throw new Error(`Renderer "${definition.id}" must not own and enhance extension "${extension}" simultaneously.`);
+            }
+            const key = `${ownerId}\u0000${extension}`;
+            const existing = claimsByOwnerAndExtension.get(key);
+            if (existing && existing.enhancerId !== definition.id) {
+                throw new Error(`Renderer enhancement collision: extension "${extension}" from "${ownerId}" is claimed by both "${existing.enhancerId}" and "${definition.id}".`);
+            }
+            claimsByOwnerAndExtension.set(key, {
+                enhancerId: definition.id,
+                ownerId,
+                extension,
+            });
+        }
+    }
+    for (const claim of claimsByOwnerAndExtension.values()) {
+        const owner = incomingDefinitionsById.get(claim.ownerId) || registry.getById(claim.ownerId);
+        if (!owner) {
+            throw new Error(`Renderer "${claim.enhancerId}" enhances unknown renderer "${claim.ownerId}".`);
+        }
+        const ownerExtensions = new Set(owner.extensions.map(normalizeFileExtension));
+        const installedExtensionOwner = registry.getByExtension(claim.extension);
+        const alreadyInstalled = (installedExtensionOwner === null || installedExtensionOwner === void 0 ? void 0 : installedExtensionOwner.id) === claim.enhancerId;
+        if (!ownerExtensions.has(claim.extension) && !alreadyInstalled) {
+            throw new Error(`Renderer "${claim.enhancerId}" cannot enhance extension "${claim.extension}" because renderer "${claim.ownerId}" does not own it.`);
+        }
+    }
+    return {
+        claims: Array.from(claimsByOwnerAndExtension.values()),
+        normalizedDefinitions,
+    };
+};
+const createRendererDefinitionInstallPlan = (registry, definitions) => {
+    const { claims, normalizedDefinitions } = collectRendererEnhancementClaims(registry, definitions);
+    const claimedExtensionsByOwnerId = new Map();
+    claims.forEach(claim => {
+        const extensions = claimedExtensionsByOwnerId.get(claim.ownerId) || new Set();
+        extensions.add(claim.extension);
+        claimedExtensionsByOwnerId.set(claim.ownerId, extensions);
+    });
+    const applyClaims = (definition) => {
+        var _a, _b;
+        const normalized = normalizeDefinition(definition);
+        const extensions = new Set(normalized.extensions);
+        (_a = normalized.enhancesExtensions) === null || _a === void 0 ? void 0 : _a.forEach(extension => extensions.add(extension));
+        (_b = claimedExtensionsByOwnerId.get(normalized.id)) === null || _b === void 0 ? void 0 : _b.forEach(extension => extensions.delete(extension));
+        return {
+            ...normalized,
+            extensions: Array.from(extensions),
+        };
+    };
+    const incomingDefinitionIds = new Set(normalizedDefinitions.map(definition => definition.id));
+    const existingOwnerDefinitions = Array.from(claimedExtensionsByOwnerId.keys())
+        .filter(ownerId => !incomingDefinitionIds.has(ownerId))
+        .map(ownerId => registry.getById(ownerId))
+        .filter((definition) => !!definition)
+        .map(applyClaims);
+    const regularDefinitions = normalizedDefinitions
+        .filter(definition => definition.enhancesRendererId === undefined)
+        .map(applyClaims);
+    const enhancerDefinitions = normalizedDefinitions
+        .filter(definition => definition.enhancesRendererId !== undefined)
+        .map(applyClaims);
+    const plannedDefinitions = [
+        ...existingOwnerDefinitions,
+        ...regularDefinitions,
+        ...enhancerDefinitions,
+    ];
+    // Validate the complete ownership transition before mutating the caller's registry.
+    const validationRegistry = createRendererRegistry(registry.list());
+    plannedDefinitions.forEach(definition => validationRegistry.register(definition));
+    return { definitions: plannedDefinitions };
+};
+const createEnhancementAwareInstallRegistry = (registry) => ({
+    register(definition) {
+        const plan = createRendererDefinitionInstallPlan(registry, [definition]);
+        plan.definitions.forEach(plannedDefinition => registry.register(plannedDefinition));
+    },
+    unregister: id => registry.unregister(id),
+    getById: id => registry.getById(id),
+    getByExtension: extension => registry.getByExtension(extension),
+    hasExtension: extension => registry.hasExtension(extension),
+    list: () => registry.list(),
+    listExtensions: () => registry.listExtensions(),
+});
 const isRendererPreset = (input) => {
     return !!input && typeof input === 'object' && !Array.isArray(input) &&
         Array.isArray(input.renderers);
@@ -187,15 +327,17 @@ export const resolveFileViewerRendererPresetInputs = (input) => {
     return [input];
 };
 export const installFileViewerRendererPlugins = async ({ registry, plugins, registerHandler, }) => {
-    var _a, _b, _c;
-    for (const plugin of plugins) {
-        (_a = plugin.definitions) === null || _a === void 0 ? void 0 : _a.forEach(definition => {
-            registry.register(definition);
-        });
-        (_b = plugin.handlers) === null || _b === void 0 ? void 0 : _b.forEach(registration => {
+    var _a, _b;
+    const pluginList = Array.from(plugins);
+    const definitions = pluginList.flatMap(plugin => [...(plugin.definitions || [])]);
+    const plan = createRendererDefinitionInstallPlan(registry, definitions);
+    plan.definitions.forEach(definition => registry.register(definition));
+    const installRegistry = createEnhancementAwareInstallRegistry(registry);
+    for (const plugin of pluginList) {
+        (_a = plugin.handlers) === null || _a === void 0 ? void 0 : _a.forEach(registration => {
             registerHandler === null || registerHandler === void 0 ? void 0 : registerHandler(registration);
         });
-        await ((_c = plugin.install) === null || _c === void 0 ? void 0 : _c.call(plugin, { registry, registerHandler }));
+        await ((_b = plugin.install) === null || _b === void 0 ? void 0 : _b.call(plugin, { registry: installRegistry, registerHandler }));
     }
     return registry;
 };

package/dist/renderers/index.d.ts

@@ -16,7 +16,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "high-fidelity";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-word";
-    readonly presets: readonly ["office", "all"];
+    readonly presets: readonly ["standard", "office", "all"];
     readonly containerVersions: readonly ["OOXML Transitional", "OOXML Strict"];
     readonly knownLimits: readonly ["VBA is never executed"];
     readonly capabilities: {
@@ -35,7 +35,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "structured";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-word";
-    readonly presets: readonly ["office", "all"];
+    readonly presets: readonly ["standard", "office", "all"];
     readonly containerVersions: readonly ["Word 97-2003 Binary"];
     readonly knownLimits: readonly ["Macros are never executed"];
     readonly capabilities: {
@@ -53,7 +53,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly async: true;
     readonly supportLevel: "structured";
     readonly status: "stable";
-    readonly packageName: "@file-viewer/renderer-presentation";
+    readonly packageName: "@file-viewer/renderer-ppt";
     readonly presets: readonly ["office", "all"];
     readonly containerVersions: readonly ["PowerPoint 97-2003 Binary"];
     readonly knownLimits: readonly ["Embedded engine watermark is retained", "Macros are never executed"];
@@ -72,8 +72,8 @@ export declare const coreLiteRendererDefinitions: ({
     readonly async: true;
     readonly supportLevel: "high-fidelity";
     readonly status: "stable";
-    readonly packageName: "@file-viewer/renderer-presentation";
-    readonly presets: readonly ["office", "all"];
+    readonly packageName: "@file-viewer/renderer-pptx";
+    readonly presets: readonly ["standard", "office", "all"];
     readonly containerVersions: readonly ["OOXML Transitional", "OOXML Strict"];
     readonly knownLimits: readonly ["Macros and external programs are never executed"];
     readonly capabilities: {
@@ -92,7 +92,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "structured";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-word";
-    readonly presets: readonly ["office", "all"];
+    readonly presets: readonly ["standard", "office", "all"];
     readonly containerVersions: readonly ["RTF", "OpenDocument"];
     readonly knownLimits: readonly [];
     readonly capabilities: {
@@ -111,7 +111,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "structured";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-spreadsheet";
-    readonly presets: readonly ["office", "all"];
+    readonly presets: readonly ["standard", "office", "all"];
     readonly containerVersions: readonly ["OOXML", "BIFF", "OpenDocument", "Delimited text"];
     readonly knownLimits: readonly ["VBA and add-in code are never executed", "Formula results are read from the saved workbook cache"];
     readonly capabilities: {
@@ -206,7 +206,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "structured";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-spreadsheet";
-    readonly presets: readonly ["office", "all"];
+    readonly presets: readonly ["standard", "office", "all"];
     readonly containerVersions: readonly ["dBASE III/IV", "Visual FoxPro"];
     readonly knownLimits: readonly ["Missing DBT/FPT memo sidecars are reported as incomplete"];
     readonly capabilities: {
@@ -225,7 +225,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "high-fidelity";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-pdf";
-    readonly presets: readonly ["office", "all"];
+    readonly presets: readonly ["standard", "office", "all"];
     readonly containerVersions: readonly ["PDF"];
     readonly knownLimits: readonly [];
     readonly capabilities: {
@@ -244,7 +244,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "structured";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-ofd";
-    readonly presets: readonly ["office", "all"];
+    readonly presets: readonly ["standard", "office", "all"];
     readonly containerVersions: readonly ["OFD"];
     readonly knownLimits: readonly [];
     readonly capabilities: {
@@ -301,7 +301,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "structured";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-archive";
-    readonly presets: readonly ["all"];
+    readonly presets: readonly ["standard", "all"];
     readonly containerVersions: readonly ["libarchive-supported containers"];
     readonly knownLimits: readonly [];
     readonly capabilities: {
@@ -311,6 +311,25 @@ export declare const coreLiteRendererDefinitions: ({
         readonly zoom: false;
         readonly search: true;
     };
+} | {
+    readonly id: "chm";
+    readonly label: "Compiled HTML Help";
+    readonly category: "ebook";
+    readonly extensions: readonly ["chm"];
+    readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-chm";
+    readonly presets: readonly ["all"];
+    readonly containerVersions: readonly ["Microsoft HTML Help ITSF v2/v3", "LZX MSCompressed and uncompressed content"];
+    readonly knownLimits: readonly ["ActiveX, Shortcut/WinHelp commands, scripts and external network resources are intentionally blocked", "Merged help collections require each referenced CHM file to be opened separately"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: "adapter";
+        readonly exportHtml: "adapter";
+        readonly zoom: false;
+        readonly search: true;
+    };
 } | {
     readonly id: "email";
     readonly label: "Email";
@@ -320,7 +339,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "structured";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-email";
-    readonly presets: readonly ["all"];
+    readonly presets: readonly ["standard", "all"];
     readonly containerVersions: readonly ["MIME", "Outlook MSG", "mbox"];
     readonly knownLimits: readonly [];
     readonly capabilities: {
@@ -510,7 +529,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "high-fidelity";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-image";
-    readonly presets: readonly ["lite", "all"];
+    readonly presets: readonly ["lite", "standard", "all"];
     readonly containerVersions: readonly ["Raster", "SVG"];
     readonly knownLimits: readonly [];
     readonly capabilities: {
@@ -520,6 +539,44 @@ export declare const coreLiteRendererDefinitions: ({
         readonly zoom: "provider";
         readonly search: false;
     };
+} | {
+    readonly id: "dicom";
+    readonly label: "DICOM";
+    readonly category: "medical-image";
+    readonly extensions: readonly ["dcm", "dicom"];
+    readonly async: true;
+    readonly supportLevel: "basic";
+    readonly status: "experimental";
+    readonly packageName: "@file-viewer/renderer-dicom";
+    readonly presets: readonly [];
+    readonly containerVersions: readonly ["DICOM Part 10"];
+    readonly knownLimits: readonly ["Local single-file and multi-frame viewing only; series assembly, PACS/DICOMweb, MPR, segmentation, measurement tools, and diagnostic-use claims are not included", "Tested transfer syntaxes are Implicit/Explicit VR Little Endian, JPEG Lossless Process 14 SV1, JPEG-LS Lossless, and JPEG 2000 Lossless"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: false;
+        readonly exportHtml: false;
+        readonly zoom: "provider";
+        readonly search: false;
+    };
+} | {
+    readonly id: "signature";
+    readonly label: "Digital signatures and evidence containers";
+    readonly category: "cryptographic-container";
+    readonly extensions: readonly ["p7m", "p7s", "p7c", "p7b", "pkcs7", "cms", "cmsc", "tsd", "tst", "tsq", "tsr", "asics", "scs", "asice", "sce", "ers", "asc", "sig", "pgp", "gpg", "jws"];
+    readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "experimental";
+    readonly packageName: "@file-viewer/renderer-signature";
+    readonly presets: readonly [];
+    readonly containerVersions: readonly ["CMS/PKCS#7", "CAdES attributes", "RFC 3161", "RFC 5544", "ASiC-S/E", "RFC 4998", "RFC 7515", "OpenPGP RFC 9580"];
+    readonly knownLimits: readonly ["Opt-in renderer; it is not added to the published preset-all/full compatibility closure", "Cryptographic checks are reported separately from certificate/key trust, policy, qualified-signature status and legal validity", "ASiC XML references and RFC 4998 renewal chains are structurally inspected; full XAdES and archival-policy validation are not claimed", "OpenPGP private-key operations and automatic decryption are intentionally excluded"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: false;
+        readonly exportHtml: false;
+        readonly zoom: false;
+        readonly search: false;
+    };
 } | {
     readonly id: "markdown";
     readonly label: "Markdown";
@@ -529,7 +586,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "structured";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-text";
-    readonly presets: readonly ["lite", "all"];
+    readonly presets: readonly ["lite", "standard", "all"];
     readonly containerVersions: readonly ["CommonMark/GFM"];
     readonly knownLimits: readonly [];
     readonly capabilities: {
@@ -548,7 +605,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "structured";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-text";
-    readonly presets: readonly ["lite", "all"];
+    readonly presets: readonly ["lite", "standard", "all"];
     readonly containerVersions: readonly ["Plain text", "source code", "Git bundle"];
     readonly knownLimits: readonly [];
     readonly capabilities: {
@@ -567,7 +624,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "high-fidelity";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-media";
-    readonly presets: readonly ["lite", "all"];
+    readonly presets: readonly ["lite", "standard", "all"];
     readonly containerVersions: readonly ["Browser media"];
     readonly knownLimits: readonly ["Codec support follows the browser"];
     readonly capabilities: {
@@ -586,7 +643,7 @@ export declare const coreLiteRendererDefinitions: ({
     readonly supportLevel: "high-fidelity";
     readonly status: "stable";
     readonly packageName: "@file-viewer/renderer-media";
-    readonly presets: readonly ["lite", "all"];
+    readonly presets: readonly ["lite", "standard", "all"];
     readonly containerVersions: readonly ["Browser media", "MIDI"];
     readonly knownLimits: readonly ["Codec support follows the browser"];
     readonly capabilities: {
@@ -596,6 +653,202 @@ export declare const coreLiteRendererDefinitions: ({
         readonly zoom: false;
         readonly search: false;
     };
+} | {
+    readonly id: "photoshop-design";
+    readonly label: "Adobe Photoshop";
+    readonly category: "asset";
+    readonly extensions: readonly ["psb", "pdd", "psdt"];
+    readonly async: true;
+    readonly supportLevel: "experimental";
+    readonly status: "experimental";
+    readonly packageName: "@file-viewer/renderer-design";
+    readonly presets: readonly [];
+    readonly enhancesRendererId: "data-asset";
+    readonly enhancesExtensions: readonly ["psd"];
+    readonly containerVersions: readonly ["PSD v1", "PSB v2"];
+    readonly knownLimits: readonly ["Pixel rendering is enabled only for 8-bit RGB and grayscale documents; unsupported color modes and bit depths are rejected instead of decoded incorrectly", "The untouched merged composite is the fidelity reference and must have been saved with Maximize Compatibility using Raw or PackBits RLE compression; ZIP composites are rejected", "Auxiliary channels are accepted only when PSD layer-info declares one merged-transparency channel; PSB currently requires exactly the base RGB or grayscale channels", "Embedded ICC profiles are detected but not color-converted yet, so profiled color is not reference-verified", "The PSD/PSB container version is taken from the 8BPS header; a mismatched filename extension is diagnosed and never used as the format authority", "Legacy PhotoDeluxe PDD and Photoshop template PSDT inputs are accepted only when the bytes validate as a PSD v1 8BPS container; unrelated files sharing those extensions are rejected", "PSD layer visibility is interactive only for flat normal-blend 100%-opacity documents without masks, effects, clipping, adjustments, groups, or resource-limit violations", "PSB currently exposes the saved composite and a read-only layer tree; interactive PSB layer recomposition is not claimed, and PSB files containing ZIP-compressed layer channels are rejected"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: true;
+        readonly exportHtml: false;
+        readonly zoom: true;
+        readonly search: false;
+    };
+} | {
+    readonly id: "illustrator-pdf-design";
+    readonly label: "Adobe Illustrator AI/AIT";
+    readonly category: "asset";
+    readonly extensions: readonly ["ait"];
+    readonly async: true;
+    readonly supportLevel: "experimental";
+    readonly status: "experimental";
+    readonly packageName: "@file-viewer/renderer-design";
+    readonly presets: readonly [];
+    readonly enhancesRendererId: "data-asset";
+    readonly enhancesExtensions: readonly ["ai"];
+    readonly containerVersions: readonly ["Illustrator PDF-compatible AI/AIT", "Illustrator native PGF/private source"];
+    readonly knownLimits: readonly ["Automatic mode prefers the verified PDF-compatible surface for the highest saved appearance fidelity, while Native PGF mode parses the editable private source in a dedicated bounded Worker and exposes native artboards and layer visibility", "A PDF header alone is insufficient: the renderer also requires Illustrator-origin XMP, MIME, creator, or AIPrivateData evidence so an ordinary renamed PDF is not advertised as an Illustrator document", "The packaged browser Worker decodes uncompressed, deflate, and Illustrator 24 zstd private source entirely offline; zstd output is streamed through the same decoded-byte ceiling and unsupported long-distance frames fail explicitly", "Native PGF rendering currently preserves and reports unknown operators but does not claim complete Illustrator gradients, text shaping, placed or embedded images, plugins, effects, masks, blending, overprint, spot-color management, or font substitution fidelity", "The PDF renderer is required only for the saved PDF surface; native-only AI/AIT can open without it, and PDF pages or optional-content groups are not presented as native artboards or layers"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: true;
+        readonly exportHtml: false;
+        readonly zoom: true;
+        readonly search: true;
+    };
+} | {
+    readonly id: "indesign-idml-design";
+    readonly label: "Adobe InDesign IDML";
+    readonly category: "asset";
+    readonly extensions: readonly ["idml"];
+    readonly async: true;
+    readonly supportLevel: "experimental";
+    readonly status: "experimental";
+    readonly packageName: "@file-viewer/renderer-design";
+    readonly presets: readonly [];
+    readonly containerVersions: readonly ["IDML package", "@paged-media/introspect-wasm 0.62.0"];
+    readonly knownLimits: readonly ["Pages are rendered locally by the CPU WASM engine in a module Worker; the browser never uploads the IDML package", "ZIP64, encrypted, multi-disk, overlapping, unsafe-path, unsupported-compression, and configured expansion-limit packages are rejected before the WASM engine opens them", "The current engine page tree lists TextFrame and Rectangle objects only even though other supported objects may still appear in rendered page pixels", "Each page render rebuilds the upstream document internally; interactive requests are latest-wins, preview is lazy, and print-all is bounded by the configured total RGBA working-set limit"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: true;
+        readonly exportHtml: false;
+        readonly zoom: true;
+        readonly search: false;
+    };
+} | {
+    readonly id: "indesign-exchange-design";
+    readonly label: "Adobe InCopy and InDesign Exchange";
+    readonly category: "asset";
+    readonly extensions: readonly ["icml", "idms", "inx"];
+    readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "experimental";
+    readonly packageName: "@file-viewer/renderer-design";
+    readonly presets: readonly [];
+    readonly containerVersions: readonly ["ICML InCopyInterchange", "IDMS PageItem", "legacy INX"];
+    readonly knownLimits: readonly ["ICML is rendered as styled story content because the format does not carry a complete document page layout", "IDMS page-item paths, transforms, colors, stories, styles, layers, and linked-resource metadata are parsed in a terminable Worker and shown as a bounded layout-fragment preview; it is not advertised as a complete INDD page", "Legacy INX abbreviated records have no maintained browser layout engine; common page items and geometry are visualized while every unmapped element name remains visible in the structure inventory", "UTF-8, signature, DTD/entity, source size, node, depth, attribute, text, story, item, point, style, and color limits are enforced; linked resource paths are never fetched"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: true;
+        readonly exportHtml: true;
+        readonly zoom: false;
+        readonly search: true;
+    };
+} | {
+    readonly id: "adobe-animate-xfl-design";
+    readonly label: "Adobe Animate XFL";
+    readonly category: "asset";
+    readonly extensions: readonly ["fla", "xfl"];
+    readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "experimental";
+    readonly packageName: "@file-viewer/renderer-design";
+    readonly presets: readonly [];
+    readonly containerVersions: readonly ["Modern compressed XFL-based FLA (CS5+)", "single DOMDocument XML XFL"];
+    readonly knownLimits: readonly ["Modern ZIP/XFL-based FLA is parsed in a terminable Worker; legacy binary FLA (Flash CS4 and earlier) is explicitly rejected", "The bounded first-frame preview reconstructs solid shapes, static text, nested symbols, and direct PNG/JPEG instances; masks, filters, tweens, ActionScript, audio/video playback, and proprietary bitmap .dat payloads remain structure-only", "A standard uncompressed .xfl is only a marker beside DOMDocument.xml, LIBRARY, and media folders; a single browser File object cannot access those siblings, so it must be packaged as FLA or supplied through a future folder/multi-file API", "ZIP64, encryption, multi-disk archives, overlapping records, unsafe or ambiguous paths, CRC failures, unsupported compression, DTD/entity XML, external XML stylesheets, and configured size/node/depth/ratio limits are rejected"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: false;
+        readonly exportHtml: false;
+        readonly zoom: false;
+        readonly search: false;
+    };
+} | {
+    readonly id: "adobe-xd-design";
+    readonly label: "Adobe XD Package";
+    readonly category: "asset";
+    readonly extensions: readonly ["xd"];
+    readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "experimental";
+    readonly packageName: "@file-viewer/renderer-design";
+    readonly presets: readonly [];
+    readonly containerVersions: readonly ["XD UCF package", "AGC JSON inventory"];
+    readonly knownLimits: readonly ["A terminable module Worker shows the highest-resolution structurally referenced embedded PNG/JPEG rendition and a bounded manifest, artboard, layer, and resource inventory", "Native AGC vector scene reconstruction is not implemented; files without a saved preview remain structure-only", "ZIP64, encrypted, multi-disk, overlapping, unsafe-path, CRC-invalid, unsupported-compression, and configured expansion-limit packages are rejected"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: false;
+        readonly exportHtml: false;
+        readonly zoom: false;
+        readonly search: false;
+    };
+} | {
+    readonly id: "indesign-native-design";
+    readonly label: "Adobe InDesign Native";
+    readonly category: "asset";
+    readonly extensions: readonly ["indd", "indt"];
+    readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "experimental";
+    readonly packageName: "@file-viewer/renderer-design";
+    readonly presets: readonly [];
+    readonly containerVersions: readonly ["InDesign 2+ native database", "INDD", "INDT"];
+    readonly knownLimits: readonly ["A terminable module Worker shows a JPEG/PNG preview only when it is embedded in a structurally verified contiguous XMP object", "The proprietary native layout database is not reconstructed; files without a saved XMP thumbnail remain metadata- or structure-only and should be exported to IDML for full page rendering", "The reader follows declared master-page and object boundaries and never scans arbitrary binary bytes for coincidental image signatures; legacy InDesign 1.x is rejected"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: false;
+        readonly exportHtml: false;
+        readonly zoom: false;
+        readonly search: false;
+    };
+} | {
+    readonly id: "postscript-design";
+    readonly label: "Adobe EPS and PostScript";
+    readonly category: "asset";
+    readonly extensions: readonly ["ps"];
+    readonly async: true;
+    readonly supportLevel: "experimental";
+    readonly status: "experimental";
+    readonly packageName: "@file-viewer/renderer-design";
+    readonly presets: readonly [];
+    readonly enhancesRendererId: "data-asset";
+    readonly enhancesExtensions: readonly ["eps"];
+    readonly containerVersions: readonly ["EPSF/DSC PostScript", "Adobe PostScript programs"];
+    readonly knownLimits: readonly ["Stet WASM renders pages in a terminable Worker with latest-wins interactive requests and bounded source size, VM memory, page count, dimensions, pixels, DPI, total print working set, and retained canvas cache", "The distributed runtime excludes upstream URW Base35 and Ghostscript CMYK ICC assets; Carlito, Tinos, Cousine, and Noto Sans Symbols 2 OFL substitutes plus the PLRM DeviceCMYK formula fallback can differ in metrics and color from Adobe applications", "This experimental path is not claimed to implement every Adobe PostScript Level 3 operator, font technology, color-management workflow, or printer device"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: true;
+        readonly exportHtml: false;
+        readonly zoom: true;
+        readonly search: false;
+    };
+} | {
+    readonly id: "adobe-palette-design";
+    readonly label: "Adobe Color Palettes";
+    readonly category: "asset";
+    readonly extensions: readonly ["ase", "aco"];
+    readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "stable";
+    readonly packageName: "@file-viewer/renderer-design";
+    readonly presets: readonly [];
+    readonly containerVersions: readonly ["ASE 1.x", "ACO v1/v2"];
+    readonly knownLimits: readonly ["ASE RGB, CMYK, Gray, and CIELAB colors and ACO RGB, HSB, CMYK, CIELAB, and Gray colors are parsed with strict bounds in a terminable module Worker", "Browser swatches convert CIELAB D50 and device CMYK to approximate sRGB; original model values remain visible for reference", "Unknown ASE blocks and bounded ACO trailing application data are skipped and reported rather than executed"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: true;
+        readonly exportHtml: true;
+        readonly zoom: false;
+        readonly search: true;
+    };
+} | {
+    readonly id: "photoshop-resource-design";
+    readonly label: "Adobe Photoshop Resources and Presets";
+    readonly category: "asset";
+    readonly extensions: readonly ["abr", "csh", "pat", "grd", "asl"];
+    readonly async: true;
+    readonly supportLevel: "structured";
+    readonly status: "experimental";
+    readonly packageName: "@file-viewer/renderer-design";
+    readonly presets: readonly [];
+    readonly containerVersions: readonly ["Photoshop ABR 6.x", "Photoshop CSH v2", "PAT v1", "GRD v5", "ASL v2", "ag-psd 31.0.2"];
+    readonly knownLimits: readonly ["ABR previews decode saved brush-tip alpha, embedded patterns, and bounded preset metadata; they do not simulate Photoshop's stroke engine, dynamics, or paint blending", "CSH previews reconstruct bounded Bezier path geometry; subtract, intersect, and exclude composition is exposed as metadata rather than claimed as Photoshop-equivalent raster output", "PAT previews decode bounded RGB, grayscale, indexed-color, alpha, Raw, and PackBits pattern tiles; unsupported image modes and compression variants fail closed", "GRD previews render saved solid color stops and deterministic bounded noise samples from v5 descriptors; they do not claim Photoshop's complete interpolation and color-management pipeline", "ASL previews expose bounded layer-effect descriptors, blend metadata, and embedded pattern thumbnails as a structure view; they do not rasterize Photoshop's full effect stack", "Legacy ABR variants before 6.x and unknown CSH container versions are rejected instead of being scanned heuristically"];
+    readonly capabilities: {
+        readonly download: true;
+        readonly print: true;
+        readonly exportHtml: false;
+        readonly zoom: false;
+        readonly search: true;
+    };
 } | {
     readonly id: "data-asset";
     readonly label: "Data Asset";

package/dist/security/svgResources.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Keep ordinary SVG styles while preventing imports and resource requests.
+ * Obfuscated URL tokens fail closed instead of depending on parser quirks.
+ */
+export declare const sanitizeFileViewerSvgCss: (value: string) => string;
+/** Remove executable attributes and every SVG resource URL that can load data remotely. */
+export declare const sanitizeFileViewerSvgResources: (root: ParentNode) => void;
+/**
+ * Mermaid 11 resolves image-node URLs with `new Image()` while rendering,
+ * before its SVG can be sanitized. Reject image metadata and explicit remote
+ * URLs before calling Mermaid so an untrusted diagram cannot initiate I/O.
+ */
+export declare const assertFileViewerMermaidSourceHasNoExternalResources: (source: string) => void;