@file-viewer/renderer-iwork 0.0.1 → 2.3.0

package/LICENSE

@@ -1,160 +1,7 @@
-Apache License
-Version 2.0, January 2004
-http://www.apache.org/licenses/
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1. Definitions.
-
-"License" shall mean the terms and conditions for use, reproduction, and
-distribution as defined by Sections 1 through 9 of this document.
-
-"Licensor" shall mean the copyright owner or entity authorized by the copyright
-owner that is granting the License.
-
-"Legal Entity" shall mean the union of the acting entity and all other entities
-that control, are controlled by, or are under common control with that entity.
-For the purposes of this definition, "control" means (i) the power, direct or
-indirect, to cause the direction or management of such entity, whether by
-contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
-outstanding shares, or (iii) beneficial ownership of such entity.
-
-"You" (or "Your") shall mean an individual or Legal Entity exercising
-permissions granted by this License.
-
-"Source" form shall mean the preferred form for making modifications, including
-but not limited to software source code, documentation source, and configuration
-files.
-
-"Object" form shall mean any form resulting from mechanical transformation or
-translation of a Source form, including but not limited to compiled object code,
-generated documentation, and conversions to other media types.
-
-"Work" shall mean the work of authorship, whether in Source or Object form,
-made available under the License, as indicated by a copyright notice that is
-included in or attached to the work.
-
-"Derivative Works" shall mean any work, whether in Source or Object form, that
-is based on (or derived from) the Work and for which the editorial revisions,
-annotations, elaborations, or other modifications represent, as a whole, an
-original work of authorship. For the purposes of this License, Derivative Works
-shall not include works that remain separable from, or merely link (or bind by
-name) to the interfaces of, the Work and Derivative Works thereof.
-
-"Contribution" shall mean any work of authorship, including the original version
-of the Work and any modifications or additions to that Work or Derivative Works
-thereof, that is intentionally submitted to Licensor for inclusion in the Work by
-the copyright owner or by an individual or Legal Entity authorized to submit on
-behalf of the copyright owner. For the purposes of this definition, "submitted"
-means any form of electronic, verbal, or written communication sent to the
-Licensor or its representatives, including but not limited to communication on
-electronic mailing lists, source code control systems, and issue tracking systems
-that are managed by, or on behalf of, the Licensor for the purpose of discussing
-and improving the Work, but excluding communication that is conspicuously marked
-or otherwise designated in writing by the copyright owner as "Not a
-Contribution."
-
-"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
-of whom a Contribution has been received by Licensor and subsequently
-incorporated within the Work.
-
-2. Grant of Copyright License. Subject to the terms and conditions of this
-License, each Contributor hereby grants to You a perpetual, worldwide,
-non-exclusive, no-charge, royalty-free, irrevocable copyright license to
-reproduce, prepare Derivative Works of, publicly display, publicly perform,
-sublicense, and distribute the Work and such Derivative Works in Source or
-Object form.
-
-3. Grant of Patent License. Subject to the terms and conditions of this License,
-each Contributor hereby grants to You a perpetual, worldwide, non-exclusive,
-no-charge, royalty-free, irrevocable (except as stated in this section) patent
-license to make, have made, use, offer to sell, sell, import, and otherwise
-transfer the Work, where such license applies only to those patent claims
-licensable by such Contributor that are necessarily infringed by their
-Contribution(s) alone or by combination of their Contribution(s) with the Work to
-which such Contribution(s) was submitted. If You institute patent litigation
-against any entity (including a cross-claim or counterclaim in a lawsuit)
-alleging that the Work or a Contribution incorporated within the Work
-constitutes direct or contributory patent infringement, then any patent licenses
-granted to You under this License for that Work shall terminate as of the date
-such litigation is filed.
-
-4. Redistribution. You may reproduce and distribute copies of the Work or
-Derivative Works thereof in any medium, with or without modifications, and in
-Source or Object form, provided that You meet the following conditions:
-
-(a) You must give any other recipients of the Work or Derivative Works a copy of
-this License; and
-
-(b) You must cause any modified files to carry prominent notices stating that
-You changed the files; and
-
-(c) You must retain, in the Source form of any Derivative Works that You
-distribute, all copyright, patent, trademark, and attribution notices from the
-Source form of the Work, excluding those notices that do not pertain to any part
-of the Derivative Works; and
-
-(d) If the Work includes a "NOTICE" text file as part of its distribution, then
-any Derivative Works that You distribute must include a readable copy of the
-attribution notices contained within such NOTICE file, excluding those notices
-that do not pertain to any part of the Derivative Works, in at least one of the
-following places: within a NOTICE text file distributed as part of the Derivative
-Works; within the Source form or documentation, if provided along with the
-Derivative Works; or, within a display generated by the Derivative Works, if and
-wherever such third-party notices normally appear. The contents of the NOTICE
-file are for informational purposes only and do not modify the License. You may
-add Your own attribution notices within Derivative Works that You distribute,
-alongside or as an addendum to the NOTICE text from the Work, provided that such
-additional attribution notices cannot be construed as modifying the License.
-
-You may add Your own copyright statement to Your modifications and may provide
-additional or different license terms and conditions for use, reproduction, or
-distribution of Your modifications, or for any such Derivative Works as a whole,
-provided Your use, reproduction, and distribution of the Work otherwise complies
-with the conditions stated in this License.
-
-5. Submission of Contributions. Unless You explicitly state otherwise, any
-Contribution intentionally submitted for inclusion in the Work by You to the
-Licensor shall be under the terms and conditions of this License, without any
-additional terms or conditions. Notwithstanding the above, nothing herein shall
-supersede or modify the terms of any separate license agreement you may have
-executed with Licensor regarding such Contributions.
-
-6. Trademarks. This License does not grant permission to use the trade names,
-trademarks, service marks, or product names of the Licensor, except as required
-for reasonable and customary use in describing the origin of the Work and
-reproducing the content of the NOTICE file.
-
-7. Disclaimer of Warranty. Unless required by applicable law or agreed to in
-writing, Licensor provides the Work (and each Contributor provides its
-Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, either express or implied, including, without limitation, any warranties or
-conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-PARTICULAR PURPOSE. You are solely responsible for determining the
-appropriateness of using or redistributing the Work and assume any risks
-associated with Your exercise of permissions under this License.
-
-8. Limitation of Liability. In no event and under no legal theory, whether in
-tort (including negligence), contract, or otherwise, unless required by
-applicable law (such as deliberate and grossly negligent acts) or agreed to in
-writing, shall any Contributor be liable to You for damages, including any
-direct, indirect, special, incidental, or consequential damages of any character
-arising as a result of this License or out of the use or inability to use the
-Work (including but not limited to damages for loss of goodwill, work stoppage,
-computer failure or malfunction, or any and all other commercial damages or
-losses), even if such Contributor has been advised of the possibility of such
-damages.
-
-9. Accepting Warranty or Additional Liability. While redistributing the Work or
-Derivative Works thereof, You may choose to offer, and charge a fee for,
-acceptance of support, warranty, indemnity, or other liability obligations and/or
-rights consistent with this License. However, in accepting such obligations, You
-may act only on Your own behalf and on Your sole responsibility, not on behalf of
-any other Contributor, and only if You agree to indemnify, defend, and hold each
-Contributor harmless for any liability incurred by, or claims asserted against,
-such Contributor by reason of your accepting any such warranty or additional
-liability.
-
-END OF TERMS AND CONDITIONS
+Apache License 2.0
 
 Copyright 2026 Yu Wang
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License. You may obtain a copy at
+https://www.apache.org/licenses/LICENSE-2.0

package/README.en.md

@@ -1,18 +1,5 @@
 # @file-viewer/renderer-iwork
 
-The thin File Viewer adapter for `iwork-viewer`. Parsing and scene rendering live in the standalone package; this package only connects format registration, Worker paths, zoom, export, and thumbnail contracts.
+Offline Apple `.pages/.numbers/.key` renderer for modern IWA and iWork '09 XML/APXL containers. Heavy parsing runs in a module Worker. Animations, transitions, and Numbers formula recalculation are not executed. Embedded Quick Look previews are loading/failure fallbacks and never count as fidelity evidence.
 
-```bash
-pnpm add @file-viewer/core @file-viewer/renderer-iwork@0.0.1
-```
-
-```ts
-import iworkRenderer from '@file-viewer/renderer-iwork'
-
-const viewer = createFileViewer({
-  container,
-  options: { renderers: [iworkRenderer] },
-})
-```
-
-Supports `.pages`, `.numbers`, and `.key`, while loading the standalone `iwork-viewer` Worker on demand. See [GitHub](https://github.com/flyfish-dev/iwork-viewer) for details.
+`.pages`, `.numbers`, and `.key` meet the stable high-fidelity code gates. Real '09, 2013+, and current-version fixtures pass structural assertions, real-browser smoke, and fixed-font pixel-diff gates against Apple-native exports. Only the generic IWA fallback is labeled as a limited preview; npm, Release, and production-domain checks remain the authority for public release status.

package/README.md

@@ -1,18 +1,5 @@
 # @file-viewer/renderer-iwork
 
-`iwork-viewer` 的 File Viewer 薄适配包。解析与场景渲染由独立包提供；本包只连接格式注册、Worker 路径、缩放、导出和缩略图契约。
+Apple `.pages/.numbers/.key` 离线 renderer。支持现代 IWA 容器和 iWork ’09 XML/APXL 容器检测与解析，所有重解析在 module Worker 中执行。动画、转场和 Numbers 公式重算不执行；内嵌 Quick Look 预览只用于加载或明确的失败降级，不计入高保真证据。
 
-```bash
-pnpm add @file-viewer/core @file-viewer/renderer-iwork@0.0.1
-```
-
-```ts
-import iworkRenderer from '@file-viewer/renderer-iwork'
-
-const viewer = createFileViewer({
-  container,
-  options: { renderers: [iworkRenderer] },
-})
-```
-
-支持 `.pages`、`.numbers`、`.key`，并按需加载独立 `iwork-viewer` Worker。完整说明见 [GitHub](https://github.com/flyfish-dev/iwork-viewer)。
+`.pages`、`.numbers`、`.key` 已达到 stable 高保真代码门禁：’09、2013+ 与当前版本真实 fixture 均通过结构断言、真实浏览器 smoke 和 Apple 原生导出的固定字体像素差门禁。只有 typed 场景解析失败并进入通用 IWA 兜底时才标记为有限预览；实际公开发布状态以 npm、Release 和生产域名验收为准。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,6 @@
+# Third-party notices
+
+- The IWA Snappy framing implementation follows the public Apple iWork notes and the Apache-2.0 SheetJS implementation. No Xberg runtime code is embedded.
+- `keynote-archives` 2.0.1 supplies MIT-licensed generated Protobuf message definitions for typed Keynote and shared iWork object decoding. File Viewer applies its own bounded Snappy framing and tolerant archive parser around those definitions.
+- `styled-exceljs` is used for the modern Numbers saved-value workbook path under its published license.
+- `JSZip`, `pako`, and `@xmldom/xmldom` are loaded inside the on-demand iWork renderer/Worker chunk.

package/dist/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class IworkContainerMismatchError extends Error {
+    readonly actualRendererId: string;
+    constructor(actualRendererId: string, message: string);
+}

package/dist/errors.js

@@ -0,0 +1,7 @@
+export class IworkContainerMismatchError extends Error {
+    constructor(actualRendererId, message) {
+        super(message);
+        this.name = 'IworkContainerMismatchError';
+        this.actualRendererId = actualRendererId;
+    }
+}

package/dist/index.d.ts

@@ -2,4 +2,20 @@ import { type FileRenderHandler, type FileViewerRenderedInstance, type FileViewe
 export declare const pagesRendererDefinition: RendererDefinition, numbersRendererDefinition: RendererDefinition, keynoteRendererDefinition: RendererDefinition;
 export declare const renderFileViewerIwork: FileRenderHandler<FileViewerRenderedInstance, HTMLDivElement>;
 export declare const iworkRenderer: FileViewerRendererPlugin<FileRenderHandler<FileViewerRenderedInstance, HTMLDivElement>>;
+export { IworkContainerMismatchError } from './errors.js';
+export { DEFAULT_IWORK_PARSE_LIMITS } from './limits.js';
+export declare const inspectIworkContainer: (...args: Parameters<typeof import("./parser.js")["inspectIworkContainer"]>) => Promise<{
+    zip: import("jszip");
+    generation: import("./model.js").IworkGeneration;
+    limits: {
+        maxUncompressedBytes: number;
+        maxCompressionRatio: number;
+        maxObjects: number;
+        maxImagePixels: number;
+        maxNestingDepth: number;
+    };
+}>;
+export declare const parseIworkDocument: (...args: Parameters<typeof import("./parser.js")["parseIworkDocument"]>) => Promise<import("./model.js").IworkDocument>;
+export { decompressIwaFile } from './snappy.js';
+export type { IworkDocument, IworkEmbeddedPreview, IworkGeneration, IworkKind, IworkParseLimits, IworkScene, IworkTable, IworkTextBlock, IworkVisualObject, } from './model.js';
 export default iworkRenderer;

package/dist/index.js

@@ -1,79 +1,24 @@
-import { DEFAULT_RENDERER_DEFINITIONS, registerFileViewerZoomProvider, resolveFileViewerIworkWorkerUrl, unregisterFileViewerZoomProvider, } from '@file-viewer/core';
-import { renderIworkDocument, } from 'iwork-viewer';
+import { DEFAULT_RENDERER_DEFINITIONS, } from '@file-viewer/core';
 const definitions = ['apple-pages', 'apple-numbers', 'apple-keynote'].map(id => DEFAULT_RENDERER_DEFINITIONS.find(definition => definition.id === id));
-if (definitions.some(definition => !definition)) {
-    throw new Error('@file-viewer/renderer-iwork could not locate the shared Pages, Numbers, and Keynote definitions.');
-}
+if (definitions.some(definition => !definition))
+    throw new Error('@file-viewer/renderer-iwork could not locate all shared iWork definitions.');
 export const [pagesRendererDefinition, numbersRendererDefinition, keynoteRendererDefinition] = definitions;
-const toStandaloneFitMode = (mode) => mode === 'auto' ? 'width' : mode;
-export const renderFileViewerIwork = async (buffer, target, type, context) => {
-    var _a, _b, _c;
-    const options = (_a = context === null || context === void 0 ? void 0 : context.options) === null || _a === void 0 ? void 0 : _a.iwork;
-    const viewer = await renderIworkDocument(buffer, target, type, {
-        ...options,
-        workerUrl: resolveFileViewerIworkWorkerUrl(options, typeof document === 'undefined' ? undefined : document.baseURI),
-        signal: context === null || context === void 0 ? void 0 : context.signal,
-    });
-    const fit = (request) => {
-        const state = viewer.fit(toStandaloneFitMode(request.mode), {
-            width: request.viewportWidth,
-            height: request.viewportHeight,
-        });
-        return state
-            ? {
-                applied: true,
-                mode: request.mode,
-                resize: request.resize,
-                scale: state.scale,
-                source: request.source,
-                provider: 'zoom',
-            }
-            : {
-                applied: false,
-                mode: request.mode,
-                resize: request.resize,
-                source: request.source,
-                reason: 'unmeasurable',
-                provider: 'zoom',
-            };
-    };
-    registerFileViewerZoomProvider(target, {
-        zoomIn: viewer.zoomIn,
-        zoomOut: viewer.zoomOut,
-        resetZoom: viewer.resetZoom,
-        setZoom: viewer.setZoom,
-        fit,
-        getState: viewer.getZoomState,
-    });
-    (_b = context === null || context === void 0 ? void 0 : context.registerExportAdapter) === null || _b === void 0 ? void 0 : _b.call(context, {
-        includeDocumentStyles: false,
-        getPrintMaskPages: viewer.getPrintPages,
-        printStyle: viewer.printStyle,
-        toHtml: viewer.toHtml,
-    });
-    (_c = context === null || context === void 0 ? void 0 : context.registerThumbnailAdapter) === null || _c === void 0 ? void 0 : _c.call(context, {
-        captureSource: viewer.captureSource,
-        capture: viewer.captureSource === 'embedded' ? viewer.captureEmbeddedPreview : undefined,
-        getTarget: viewer.getThumbnailTarget,
-    });
-    return {
-        $el: target,
-        unmount() {
-            var _a, _b;
-            unregisterFileViewerZoomProvider(target);
-            (_a = context === null || context === void 0 ? void 0 : context.registerExportAdapter) === null || _a === void 0 ? void 0 : _a.call(context, null);
-            (_b = context === null || context === void 0 ? void 0 : context.registerThumbnailAdapter) === null || _b === void 0 ? void 0 : _b.call(context, null);
-            viewer.destroy();
-        },
-    };
-};
+export const renderFileViewerIwork = (buffer, target, type, context) => import('./iwork.js').then(({ default: renderIwork }) => renderIwork(buffer, target, type, context));
 export const iworkRenderer = {
     id: 'file-viewer-renderer-iwork',
-    label: 'File Viewer Apple iWork renderer',
+    label: 'Flyfish File Viewer Apple iWork renderer',
     definitions: definitions,
-    handlers: definitions.map(definition => ({
-        rendererId: definition.id,
-        handler: renderFileViewerIwork,
-    })),
+    handlers: definitions.map(definition => ({ rendererId: definition.id, handler: renderFileViewerIwork })),
+};
+export { IworkContainerMismatchError } from './errors.js';
+export { DEFAULT_IWORK_PARSE_LIMITS } from './limits.js';
+export const inspectIworkContainer = async (...args) => {
+    const parser = await import('./iwork.parser.js');
+    return parser.inspectIworkContainer(...args);
+};
+export const parseIworkDocument = async (...args) => {
+    const parser = await import('./iwork.parser.js');
+    return parser.parseIworkDocument(...args);
 };
+export { decompressIwaFile } from './snappy.js';
 export default iworkRenderer;

package/dist/iwork.d.ts

@@ -0,0 +1,2 @@
+import { type FileRenderContext, type FileViewerRenderedInstance } from '@file-viewer/core';
+export default function renderIwork(buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext): Promise<FileViewerRenderedInstance>;