@file-viewer/ppt 0.2.0

package/LICENSE

@@ -0,0 +1,196 @@
+Flyfish Public Watermarked Binary License for @file-viewer/ppt
+Version 1.2, July 2026
+License policy identifier: flyfish-public-watermarked-binary-license-v1
+
+Copyright (c) 2026 Flyfish. All rights reserved except as expressly granted in this License.
+
+IMPORTANT: This is a proprietary binary-use license. It is not an open-source
+license. By downloading, installing, copying, accessing, or using the Public
+Package, You accept this License. If You do not accept it, do not use the Public
+Package and delete every copy under Your control.
+
+1. Definitions
+
+“Flyfish” means the copyright owner and licensor of the Public Package.
+
+“Public Package” means the official, unmodified @file-viewer/ppt binary npm
+package distributed by Flyfish under this License, including its JavaScript
+loader, native WebAssembly rendering module, declarations, documentation, and
+required Flyfish Viewer watermark.
+
+“You” means an individual natural person acting solely in that person’s
+personal capacity. A company, legal entity, government body, school, nonprofit,
+team, employer, client, or other organization is not “You” under the free grant,
+even when an individual accesses the Public Package on its behalf.
+
+“Personal Non-Commercial Use” means learning, private research, private testing,
+personal evaluation, or a personal non-revenue project that is not performed
+for, on behalf of, or in connection with any organization, employment, client,
+profession, trade, business, compensation, fee, fundraising, or commercial
+advantage.
+
+“Commercial Use” means every use that is not Personal Non-Commercial Use.
+
+2. Limited free grant
+
+Subject to continuous compliance with this License, Flyfish grants You a
+limited, non-exclusive, non-transferable, non-sublicensable, revocable right to:
+
+- download and install the official Public Package;
+- execute it on any normal HTTP or HTTPS browser origin solely for Personal
+  Non-Commercial Use; and
+- serve unmodified Public Package assets only as an integrated component of
+  Your own Personal Non-Commercial Use project.
+
+The grant is conditioned on the Flyfish Viewer watermark remaining visible,
+complete, unobstructed, and unmodified in every rendered slide and preview.
+The grant does not include source code, source-delivery rights, redistribution
+rights, modification rights, derivative-work rights, or any commercial right.
+
+3. Commercial and organizational use
+
+You must obtain a separate written commercial license from Flyfish before any
+Commercial Use. Commercial Use includes, without limitation:
+
+- any use by or for a company, organization, government body, school,
+  nonprofit, team, employer, customer, or client, including internal evaluation;
+- production, intranet, extranet, SaaS, hosted, cloud, embedded, OEM, resale,
+  consulting, customer-delivery, revenue-generating, fee-supported, sponsored,
+  or professionally connected use;
+- integration into any product, service, project, procurement, sales demo, or
+  workflow connected with business or compensated activity; and
+- any removal, hiding, obstruction, weakening, alteration, or replacement of
+  the required Flyfish Viewer watermark or public-edition restrictions.
+
+A separately purchased commercial or enterprise agreement applies only to the
+features, deployments, origins, entities, term, and other scope expressly stated
+in that agreement. A commercial agreement does not amend this Public Package.
+Flyfish may instead provide a separately built commercial package.
+
+Purchase and authorization information:
+https://dev.flyfish.group/shop
+
+4. Restrictions
+
+Except to the limited extent that mandatory law expressly permits despite this
+restriction, You may not, and may not enable or assist another person to:
+
+- redistribute, publish, mirror, sublicense, sell, rent, lease, transfer,
+  repackage, or make the Public Package available as a standalone download,
+  reusable dependency, CDN asset, hosted API, or service for third parties;
+- modify, translate, adapt, patch, or create derivative works from the Public
+  Package, WebAssembly module, or watermark;
+- reverse engineer, decrypt, decompile, disassemble, extract, dump, recover, or
+  otherwise attempt to derive source code, keys, protected modules, algorithms,
+  or non-public interfaces;
+- bypass, forge, replace, disable, or interfere with any policy gate, integrity
+  check, encryption, feature restriction, watermark control, or other technical
+  protection measure;
+- remove, hide, crop, cover, restyle, obscure, weaken, or interfere with the
+  Flyfish Viewer watermark in the viewer output;
+- remove or alter copyright, license, attribution, provenance, trademark, or
+  commercial-use notices; or
+- represent the Public Package as open source or as licensed under Apache-2.0,
+  MIT, BSD, GPL, or another open-source license.
+
+Installing the official package through npm and making reasonable backup copies
+solely for Your permitted use are not prohibited redistribution.
+
+Technical bundling, minification, and static-asset deployment are permitted only
+as necessary to operate Your own project within the Limited Free Grant, provided
+that the Public Package is not exposed or supplied as a reusable library,
+standalone dependency, mirror, download, API, or service, and provided that all
+license notices, integrity controls, and required watermarks remain intact.
+
+5. Separate source deliveries and Apache-2.0 boundary
+
+This License applies only to the Public Package and does not grant rights under
+the Apache License 2.0 or any other open-source license.
+
+Any Apache License 2.0 terms that Flyfish may separately provide to a specific
+source-delivery customer apply only to the source files and scope expressly
+identified in that separate delivery. Those terms are not incorporated into,
+and do not extend to, this Public Package, its public WebAssembly distribution,
+the Flyfish Viewer watermark, or Flyfish trademarks.
+Nothing in this License changes rights already validly granted in a separate
+written delivery or license agreement.
+
+6. Watermark and limited trademark permission
+
+The Flyfish name and Flyfish Viewer watermark are protected marks of Flyfish.
+Solely so You can comply with this License, Flyfish grants You a narrow,
+non-transferable permission to display the unmodified mandatory watermark as
+produced by the Public Package. No other trademark, branding, endorsement, or
+merchandising right is granted.
+
+Only a separately purchased and separately built commercial package may omit
+the public watermark. Possession of a license file, source delivery, package
+copy, or modified runtime does not by itself authorize watermark removal.
+
+7. Ownership and reservation of rights
+
+Flyfish and its licensors retain all title, ownership, copyright, patent,
+trade-secret, trademark, and other intellectual-property rights in the Public
+Package. No right is granted by implication, estoppel, exhaustion, or otherwise.
+All rights not expressly granted are reserved.
+
+Third-party components, if expressly identified in accompanying notices, remain
+subject to their respective licenses solely for those identified components.
+No third-party notice expands the grant for Flyfish proprietary components.
+
+8. Updates and policy changes
+
+Each version of the Public Package is governed by the LICENSE file shipped with
+that version. Flyfish may offer later versions under revised terms. Continuing
+to use an updated version constitutes acceptance of the terms shipped with that
+updated version.
+
+9. Termination
+
+This License terminates automatically and immediately upon breach. On
+termination, You must stop all use and delete every copy under Your possession
+or control. Sections 3 through 7 and 9 through 11 survive termination.
+Termination does not limit any other remedy available to Flyfish.
+
+10. Disclaimer and limitation of liability
+
+THE PUBLIC PACKAGE IS PROVIDED “AS IS” AND “AS AVAILABLE,” WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING TITLE, NON-INFRINGEMENT,
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, ACCURACY, AVAILABILITY, OR
+SECURITY. TO THE MAXIMUM EXTENT PERMITTED BY LAW, FLYFISH AND ITS LICENSORS WILL
+NOT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY,
+PUNITIVE, OR COMMERCIAL DAMAGES, OR FOR LOSS OF DATA, PROFITS, REVENUE, GOODWILL,
+OR BUSINESS INTERRUPTION, ARISING FROM OR RELATED TO THE PUBLIC PACKAGE OR THIS
+LICENSE.
+
+11. General
+
+This License is the complete agreement for the Public Package unless You and
+Flyfish have signed a separate written agreement that expressly governs the
+same use. If a provision is unenforceable, it will be limited to the minimum
+extent necessary and the remaining provisions will continue in effect. A waiver
+must be in writing and applies only to the stated instance. You may not assign
+this License. Headings are for convenience only.
+
+12. Contact
+
+Commercial licensing: https://dev.flyfish.group/shop
+Support email: wybaby168@gmail.com
+
+中文摘要（仅便于阅读；如与英文条款冲突，以英文条款为准）
+
+- 本 npm 公网包是 Flyfish 专有二进制发行版，不是开源软件，也不适用
+  Apache-2.0。单独向特定源码客户交付的 Apache-2.0 条款，仅适用于该次交付中
+  明确列出的源码和范围，不会扩展到本公网 npm 包。
+- 免费授权对象仅为以个人身份行事的自然人，且仅限个人、非商用、非组织用途；
+  公司、组织、政府、学校、非营利机构、团队、雇主或客户的内部评估也属于商用。
+- 公网水印版不限制正常 HTTP/HTTPS origin，但每一页必须完整显示
+  Flyfish Viewer 水印。不得删除、遮挡、裁剪、弱化或替换水印。
+- 不得再分发、镜像、转售、重打包、修改、反编译、解密、提取、伪造授权或绕过
+  WASM、完整性校验、功能限制及其他技术保护措施。
+- 在免费授权范围内，仅为运行本人项目而进行必要的前端打包、压缩和静态资源部署
+  是允许的，但不得将本包作为可复用依赖、镜像、独立下载、API 或服务向第三方
+  提供，并且必须完整保留许可证声明、完整性保护和水印。
+- 商业、生产、内网、SaaS、托管、嵌入、OEM、客户项目、收费或其他业务用途，
+  必须先购买单独商业授权；只有单独构建的商业包可以不显示公网水印。
+- 商业授权购买地址：https://dev.flyfish.group/shop

package/NOTICE

@@ -0,0 +1,232 @@
+@file-viewer/ppt
+Copyright 2026 Flyfish.
+
+PROPRIETARY PUBLIC BINARY DISTRIBUTION — NOT OPEN SOURCE
+
+This npm package is governed only by the included Flyfish Public Watermarked
+Binary License. It is not licensed under Apache-2.0. Apache-2.0 terms supplied
+under a separate written source-code delivery apply only to the files and scope
+expressly identified in that separate delivery and do not extend to this npm
+package.
+
+Free use is limited to an individual natural person acting solely in a personal,
+non-commercial, non-organizational capacity. Use by or for any company,
+organization, government body, school, nonprofit, team, employer, customer, or
+client requires a purchased commercial license.
+
+Every public rendering must display the unmodified Flyfish Viewer watermark.
+Only a separately purchased and separately built commercial package may omit
+that watermark.
+
+This package contains a native PPT parsing and Canvas rasterization WebAssembly
+runtime plus generated public declarations. It does not include a customer
+runtime license, license-signing secret, commercial watermark-removal
+capability, source-delivery rights, or readable parser/renderer source.
+
+Commercial licensing: https://dev.flyfish.group/shop
+
+The native engine embeds deterministic fallback fonts. Their copyright notices
+and full font licenses are appended to this NOTICE in the published package.
+
+THIRD-PARTY FONT NOTICES
+
+Liberation Sans Regular
+Digitized data copyright (c) 2010 Google Corporation; Copyright (c) 2012 Red Hat, Inc.
+Licensed under the SIL Open Font License 1.1:
+Digitized data copyright (c) 2010 Google Corporation
+	with Reserved Font Arimo, Tinos and Cousine.
+Copyright (c) 2012 Red Hat, Inc.
+	with Reserved Font Name Liberation.
+
+This Font Software is licensed under the SIL Open Font License,
+Version 1.1.
+
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+
+PREAMBLE The goals of the Open Font License (OFL) are to stimulate
+worldwide development of collaborative font projects, to support the font
+creation efforts of academic and linguistic communities, and to provide
+a free and open framework in which fonts may be shared and improved in
+partnership with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves.
+The fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works.  The fonts and derivatives,
+however, cannot be released under any other type of license.  The
+requirement for fonts to remain under this license does not apply to
+any document created using the fonts or their derivatives.
+
+
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such.
+This may include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components
+as distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting ? in part or in whole ?
+any of the components of the Original Version, by changing formats or
+by porting the Font Software to a new environment.
+
+"Author" refers to any designer, engineer, programmer, technical writer
+or other person who contributed to the Font Software.
+
+
+PERMISSION & CONDITIONS
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,in
+   Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+   redistributed and/or sold with any software, provided that each copy
+   contains the above copyright notice and this license. These can be
+   included either as stand-alone text files, human-readable headers or
+   in the appropriate machine-readable metadata fields within text or
+   binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+   Name(s) unless explicit written permission is granted by the
+   corresponding Copyright Holder. This restriction only applies to the
+   primary font name as presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+   Software shall not be used to promote, endorse or advertise any
+   Modified Version, except to acknowledge the contribution(s) of the
+   Copyright Holder(s) and the Author(s) or with their explicit written
+   permission.
+
+5) The Font Software, modified or unmodified, in part or in whole, must
+   be distributed entirely under this license, and must not be distributed
+   under any other license. The requirement for fonts to remain under
+   this license does not apply to any document created using the Font
+   Software.
+
+
+
+TERMINATION
+This license becomes null and void if any of the above conditions are not met.
+
+
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT.  IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER
+DEALINGS IN THE FONT SOFTWARE.
+
+Noto Sans CJK SC Regular
+Copyright 2014-2021 Adobe. Noto is a trademark of Google Inc.
+Licensed under the SIL Open Font License 1.1:
+This Font Software is licensed under the SIL Open Font License,
+Version 1.1.
+
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font
+creation efforts of academic and linguistic communities, and to
+provide a free and open framework in which fonts may be shared and
+improved in partnership with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply to
+any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software
+components as distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to,
+deleting, or substituting -- in part or in whole -- any of the
+components of the Original Version, by changing formats or by porting
+the Font Software to a new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed,
+modify, redistribute, and sell modified and unmodified copies of the
+Font Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components, in
+Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the
+corresponding Copyright Holder. This restriction only applies to the
+primary font name as presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created using
+the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/README.md

@@ -0,0 +1,278 @@
+# @file-viewer/ppt
+
+> Professional browser preview for PowerPoint 97–2003 (`.ppt`), powered by native WebAssembly and Canvas.
+
+[![npm version](https://img.shields.io/npm/v/%40file-viewer%2Fppt.svg)](https://www.npmjs.com/package/@file-viewer/ppt)
+[![format](https://img.shields.io/badge/format-PowerPoint%2097--2003-c43e1c.svg)](#format-scope)
+[![license](https://img.shields.io/badge/license-proprietary-334155.svg)](./LICENSE)
+
+[English](#english) · [简体中文](#简体中文)
+
+## English
+
+### A professional viewer for traditional PowerPoint files
+
+`@file-viewer/ppt` is Flyfish's independently developed preview engine for the
+PowerPoint 97–2003 binary (`.ppt`) format. It reconstructs slides directly in a
+modern browser without Microsoft Office, LibreOffice, browser plug-ins, or a
+server-side conversion service.
+
+The product is designed for document platforms, archives, knowledge systems,
+intranets, SaaS applications, and web products that still need dependable
+access to traditional PowerPoint files.
+
+### Product highlights
+
+- **Native `.ppt` understanding** — Reads the classic PowerPoint compound-file,
+  persist-record, text, drawing, and picture structures directly.
+- **Professional slide reconstruction** — Handles slide size, masters,
+  backgrounds, color schemes, text formatting, adjustable OfficeArt shapes,
+  fills, gradients, bounded legacy 3-D extrusion, grouped objects, pictures,
+  transforms, and layer order.
+- **Native WASM Canvas pipeline** — Parsing, layout, rasterization, and public
+  watermark composition run in one WebAssembly engine. JavaScript presents the
+  engine's final RGBA frames with Canvas.
+- **Local document processing** — The public runtime does not require documents
+  to be uploaded to a conversion service.
+- **Verified engine asset** — The loader validates the exact native WASM
+  SHA-256 before execution.
+- **Straightforward integration** — ESM, TypeScript declarations, no runtime
+  JavaScript dependencies, and support for both complete-viewer mounting and
+  individual-slide rendering.
+
+### Format scope
+
+This package previews PowerPoint 97–2003 binary `.ppt` files. For XML-based
+`.pptx` files, use a dedicated PPTX viewer.
+
+### Installation
+
+```bash
+npm install @file-viewer/ppt
+```
+
+### Quick start
+
+```html
+<input id="ppt-file" type="file" accept=".ppt,application/vnd.ms-powerpoint">
+<div id="ppt-viewer"></div>
+```
+
+```js
+import { createPptViewer } from '@file-viewer/ppt';
+
+const viewer = await createPptViewer();
+const input = document.querySelector('#ppt-file');
+
+input.addEventListener('change', async () => {
+  const file = input.files?.[0];
+  if (!file) return;
+
+  await viewer.mount('#ppt-viewer', await file.arrayBuffer(), {
+    scale: 1,
+    pixelRatio: window.devicePixelRatio
+  });
+});
+```
+
+`mount()` creates one Canvas per slide and renders progressively. No license
+file or origin registration is required for the public watermarked edition.
+
+### Render one slide
+
+```js
+const response = await fetch('/documents/presentation.ppt');
+const pptDocument = viewer.open(await response.arrayBuffer());
+
+const canvas = document.querySelector('canvas');
+pptDocument.renderSlide(0, canvas, { scale: 1.25 });
+
+console.log(pptDocument.slideCount, pptDocument.width, pptDocument.height);
+pptDocument.close();
+```
+
+Close documents when they are no longer needed so their native memory can be
+released immediately.
+
+### Core API
+
+| API | Purpose |
+| --- | --- |
+| `createPptViewer()` / `loadPptViewer()` | Loads and verifies the native viewer engine |
+| `viewer.mount(target, input, options)` | Renders the complete presentation into Canvas elements |
+| `viewer.open(input)` | Opens a `.ppt` document and returns an opaque document handle |
+| `document.renderSlide(index, canvas, options)` | Renders one final RGBA slide frame to Canvas |
+| `document.close()` | Releases native document memory |
+| `getPptPackageManifest()` | Returns package and edition metadata |
+
+All public APIs include TypeScript declarations. Parsed document models,
+records, HTML, SVG, drawing command streams, and unwatermarked frames are not
+part of the public API.
+
+### Browser and deployment requirements
+
+- A current browser with ES modules, WebAssembly, Web Crypto, `fetch`, and Canvas 2D
+- Static hosting or a bundler that emits `ppt-native.wasm` beside `index.mjs`
+- `application/wasm` MIME type for `.wasm` assets
+- CSP permission to load the package's own module and WASM asset, including
+  `'wasm-unsafe-eval'` where required by the browser
+- Normal HTTP or HTTPS hosting; the public edition does not restrict origin
+
+### Compatibility notes
+
+Traditional PowerPoint files may contain macros, ActiveX controls, OLE objects,
+linked media, or host-specific behaviors that browsers cannot execute. These
+features are treated as non-executable preview content. Font substitution may
+be used when an original document font is not available in the viewer's
+embedded fallback set.
+
+### Editions and licensing
+
+| Edition | Permitted use | Watermark | Origin |
+| --- | --- | --- | --- |
+| Public npm edition | Individual personal, non-commercial, non-organizational use | Mandatory `Flyfish Viewer` on every slide | Any normal HTTP/HTTPS origin |
+| Commercial edition | Licensed company, organization, customer project, intranet, SaaS, OEM, or production use | Watermark-free build available according to the purchased agreement | According to the commercial agreement |
+
+**Commercial use requires a purchased license.** Use by or for a company,
+organization, government body, school, nonprofit, team, employer, customer, or
+client—including internal evaluation—is commercial use.
+
+The public npm edition is proprietary software and is **not licensed under
+Apache-2.0**. Removing, hiding, covering, replacing, or bypassing the required
+watermark is prohibited. See [LICENSE](./LICENSE) for the binding terms.
+
+Purchase a commercial license from the
+[Flyfish Shop](https://dev.flyfish.group/shop).
+
+### Product links
+
+- [Documentation](https://officejs-doc.pages.dev)
+- [Commercial licensing](https://dev.flyfish.group/shop)
+- [Issue tracker](https://github.com/flyfish-dev/office-preview-js/issues)
+
+## 简体中文
+
+### 专业传统 PPT 浏览器预览引擎
+
+`@file-viewer/ppt` 是 Flyfish 纯自研的 PowerPoint 97–2003 二进制 `.ppt`
+专业预览引擎。它直接理解传统 PPT 文件结构，并在现代浏览器中重建幻灯片，无需
+安装 Microsoft Office、LibreOffice、浏览器插件，也不依赖服务端格式转换。
+
+产品适用于文件预览平台、档案与知识管理系统、企业内网、SaaS 产品，以及仍需
+稳定支持传统 PowerPoint 文档的 Web 应用。
+
+### 产品特点
+
+- **原生理解 `.ppt`**：直接读取复合文件、持久化记录、文字、绘图和图片结构。
+- **专业幻灯片还原**：支持页面尺寸、母版、背景、配色、文字格式、可调节
+  OfficeArt 形状、填充、渐变、受限的传统 3D 挤出、组合对象、图片、旋转变换
+  和图层顺序。
+- **原生 WASM Canvas 链路**：解析、布局、光栅化和公网水印合成全部在同一个
+  WebAssembly 引擎内完成；JavaScript 只将最终 RGBA 画面提交给 Canvas。
+- **文档本地处理**：公网运行时不要求将文档上传到第三方转换服务。
+- **引擎完整性校验**：执行前自动校验原生 WASM 的精确 SHA-256。
+- **易于集成**：提供 ESM、TypeScript 类型，无 JavaScript 运行时依赖；既可
+  挂载完整预览器，也可单独渲染指定页。
+
+### 格式范围
+
+本包专门预览 PowerPoint 97–2003 二进制 `.ppt` 文件。XML 格式的 `.pptx`
+应使用专用 PPTX 预览器。
+
+### 安装
+
+```bash
+npm install @file-viewer/ppt
+```
+
+### 快速开始
+
+```html
+<input id="ppt-file" type="file" accept=".ppt,application/vnd.ms-powerpoint">
+<div id="ppt-viewer"></div>
+```
+
+```js
+import { createPptViewer } from '@file-viewer/ppt';
+
+const viewer = await createPptViewer();
+const input = document.querySelector('#ppt-file');
+
+input.addEventListener('change', async () => {
+  const file = input.files?.[0];
+  if (!file) return;
+
+  await viewer.mount('#ppt-viewer', await file.arrayBuffer(), {
+    scale: 1,
+    pixelRatio: window.devicePixelRatio
+  });
+});
+```
+
+`mount()` 会为每一页创建 Canvas 并渐进渲染。公网水印版不需要 license 文件，
+也不限制正常 HTTP/HTTPS origin。
+
+### 单页渲染
+
+```js
+const response = await fetch('/documents/presentation.ppt');
+const pptDocument = viewer.open(await response.arrayBuffer());
+
+const canvas = document.querySelector('canvas');
+pptDocument.renderSlide(0, canvas, { scale: 1.25 });
+
+console.log(pptDocument.slideCount, pptDocument.width, pptDocument.height);
+pptDocument.close();
+```
+
+文档不再使用时请调用 `close()`，以便立即释放原生内存。
+
+### 核心 API
+
+| API | 用途 |
+| --- | --- |
+| `createPptViewer()` / `loadPptViewer()` | 加载并校验原生预览引擎 |
+| `viewer.mount(target, input, options)` | 将完整演示文稿渲染为 Canvas 列表 |
+| `viewer.open(input)` | 打开 `.ppt` 并返回不透明文档句柄 |
+| `document.renderSlide(index, canvas, options)` | 将单页最终 RGBA 画面渲染到 Canvas |
+| `document.close()` | 释放原生文档内存 |
+| `getPptPackageManifest()` | 返回包与版本信息 |
+
+所有公开 API 均提供 TypeScript 类型。解析后的文档模型、记录、HTML、SVG、
+绘图指令流和无水印画面均不属于公开 API。
+
+### 浏览器与部署要求
+
+- 支持 ES Modules、WebAssembly、Web Crypto、`fetch` 和 Canvas 2D 的现代浏览器
+- 能将 `ppt-native.wasm` 与 `index.mjs` 一同发布的静态服务器或打包工具
+- 为 `.wasm` 配置 `application/wasm` MIME 类型
+- CSP 允许加载包自身的模块和 WASM 资源；浏览器要求时需允许
+  `'wasm-unsafe-eval'`
+- 使用正常 HTTP 或 HTTPS 部署；公网版不限制 origin
+
+### 兼容性说明
+
+传统 PPT 可能包含宏、ActiveX、OLE、链接媒体或依赖桌面宿主的行为，浏览器无法
+执行这些能力；预览器会把它们作为不可执行内容安全处理。原始字体不在内置回退
+字体集时，会使用确定性的字体替代。
+
+### 版本与授权
+
+| 版本 | 允许用途 | 水印 | Origin |
+| --- | --- | --- | --- |
+| 公网 npm 版 | 自然人个人、非商业、非组织用途 | 每页强制显示 `Flyfish Viewer` | 任意正常 HTTP/HTTPS origin |
+| 商业版 | 已授权的公司、组织、客户项目、内网、SaaS、OEM 或生产用途 | 按商业协议提供无公网水印构建 | 按商业协议执行 |
+
+**任何商业用途均需购买授权。** 公司、组织、政府、学校、非营利机构、团队、
+雇主、客户或委托项目的使用，包括内部评估，均属于商业用途。
+
+公网 npm 版是专有软件，**不适用 Apache-2.0**。禁止删除、隐藏、遮挡、替换或
+绕过强制水印。具有法律约束力的完整条款见 [LICENSE](./LICENSE)。
+
+商业授权请前往 [Flyfish 商店](https://dev.flyfish.group/shop)购买。
+
+### 产品链接
+
+- [产品文档](https://officejs-doc.pages.dev)
+- [商业授权](https://dev.flyfish.group/shop)
+- [问题反馈](https://github.com/flyfish-dev/office-preview-js/issues)

package/index.d.ts

@@ -0,0 +1,110 @@
+export interface PptPackageManifest {
+  kind: 'flyfish-ppt-public-native-wasm-v1';
+  product: 'Flyfish PPT Viewer';
+  format: 'PowerPoint 97-2003 (.ppt)';
+  packageName: '@file-viewer/ppt';
+  packageVersion: string;
+  engine: 'flyfish-classic-ppt-native-engine';
+  engineBuild: string;
+  id: 'FV-PPT-PUBLIC-WATERMARKED-V2';
+  feature: 'ppt';
+  edition: 'public-watermarked';
+  holder: 'Individual Personal Non-Commercial Use';
+  distribution: 'proprietary-public-binary';
+  commercialUse: false;
+  publicAnyOrigin: true;
+  watermarkRequired: true;
+  watermarkText: 'Flyfish Viewer';
+  usePolicy: 'public-individual-noncommercial-watermarked';
+  licensePolicy: 'flyfish-public-watermarked-binary-license-v1';
+  sourceCodeRights: false;
+  sourceDeliveryRights: false;
+  apacheLicenseApplies: false;
+  redistributionAllowed: false;
+  runtimeLicenseRequired: false;
+  renderer: 'native-wasm-rgba-canvas';
+  integrity: 'native-wasm-sha256-v1';
+  wasmFile: 'ppt-native.wasm';
+  watermarkEnforcement: 'native-final-frame';
+  wasmSha256: string;
+}
+
+export interface PptRuntimeLicenseSummary {
+  readonly id: 'FV-PPT-PUBLIC-WATERMARKED-V2';
+  readonly edition: 'public-watermarked';
+  readonly holder: 'Individual Personal Non-Commercial Use';
+  readonly policy: 'flyfish-public-watermarked-binary-license-v1';
+  readonly commercialUse: false;
+  readonly sourceCodeRights: false;
+  readonly sourceDeliveryRights: false;
+  readonly apacheLicenseApplies: false;
+  readonly redistributionAllowed: false;
+}
+
+export interface PptWatermarkSummary {
+  readonly required: true;
+  readonly text: 'Flyfish Viewer';
+}
+
+export interface PptRenderOptions {
+  /** CSS size multiplier. Defaults to 1. */
+  scale?: number;
+  /** Raster density. Defaults to devicePixelRatio in browsers and 1 elsewhere. */
+  pixelRatio?: number;
+}
+
+export interface PptMountOptions extends PptRenderOptions {
+  /** Replace existing children of the target. Defaults to true. */
+  replace?: boolean;
+  /** Optional class name for the generated viewer root. */
+  className?: string;
+}
+
+export interface PptRenderResult {
+  readonly slideIndex: number;
+  readonly width: number;
+  readonly height: number;
+  readonly logicalWidth: number;
+  readonly logicalHeight: number;
+  readonly scale: number;
+  readonly pixelRatio: number;
+}
+
+export interface PptDocument {
+  readonly slideCount: number;
+  readonly width: number;
+  readonly height: number;
+  readonly closed: boolean;
+  renderSlide(
+    slideIndex: number,
+    canvas: HTMLCanvasElement | OffscreenCanvas,
+    options?: PptRenderOptions
+  ): PptRenderResult;
+  close(): void;
+}
+
+export interface MountedPptViewer {
+  readonly document: PptDocument;
+  readonly root: HTMLElement;
+  readonly canvases: readonly HTMLCanvasElement[];
+  close(): void;
+}
+
+export interface LoadPptViewerOptions {
+  wasmUrl?: string | URL | Response | ArrayBuffer | Uint8Array;
+}
+
+export interface PptViewerRuntime {
+  readonly license: Readonly<PptRuntimeLicenseSummary>;
+  readonly watermark: Readonly<PptWatermarkSummary>;
+  open(input: ArrayBuffer | Uint8Array): PptDocument;
+  mount(
+    target: string | HTMLElement,
+    input: ArrayBuffer | Uint8Array,
+    options?: PptMountOptions
+  ): Promise<MountedPptViewer>;
+}
+
+export declare function getPptPackageManifest(): PptPackageManifest;
+export declare function loadPptViewer(options?: LoadPptViewerOptions): Promise<PptViewerRuntime>;
+export declare const createPptViewer: typeof loadPptViewer;

package/index.mjs

@@ -0,0 +1,325 @@
+const MANIFEST = Object.freeze({"kind":"flyfish-ppt-public-native-wasm-v1","product":"Flyfish PPT Viewer","format":"PowerPoint 97-2003 (.ppt)","packageName":"@file-viewer/ppt","packageVersion":"0.2.0","engine":"flyfish-classic-ppt-native-engine","engineBuild":"ef5987a0a85b6103","id":"FV-PPT-PUBLIC-WATERMARKED-V2","feature":"ppt","edition":"public-watermarked","holder":"Individual Personal Non-Commercial Use","distribution":"proprietary-public-binary","commercialUse":false,"publicAnyOrigin":true,"watermarkRequired":true,"watermarkText":"Flyfish Viewer","usePolicy":"public-individual-noncommercial-watermarked","licensePolicy":"flyfish-public-watermarked-binary-license-v1","sourceCodeRights":false,"sourceDeliveryRights":false,"apacheLicenseApplies":false,"redistributionAllowed":false,"runtimeLicenseRequired":false,"renderer":"native-wasm-rgba-canvas","integrity":"native-wasm-sha256-v1","wasmFile":"ppt-native.wasm","watermarkEnforcement":"native-final-frame","wasmSha256":"ef5987a0a85b61034ea651a02a28d4582ad19a09610e9a5637dcf01136815a2e"});
+const DEFAULT_WASM_URL = new URL('./ppt-native.wasm', import.meta.url);
+const WASM_EXPORTS = Object.freeze([
+  'memory',
+  'ppt_input_alloc',
+  'ppt_input_free',
+  'ppt_document_open',
+  'ppt_document_close',
+  'ppt_slide_count',
+  'ppt_slide_width',
+  'ppt_slide_height',
+  'ppt_render_slide_rgba',
+  'ppt_frame_ptr',
+  'ppt_frame_len',
+  'ppt_frame_width',
+  'ppt_frame_height',
+  'ppt_frame_stride',
+  'ppt_frame_free',
+  'ppt_last_error_code'
+]);
+
+const LICENSE = Object.freeze({
+  id: 'FV-PPT-PUBLIC-WATERMARKED-V2',
+  edition: 'public-watermarked',
+  holder: 'Individual Personal Non-Commercial Use',
+  policy: 'flyfish-public-watermarked-binary-license-v1',
+  commercialUse: false,
+  sourceCodeRights: false,
+  sourceDeliveryRights: false,
+  apacheLicenseApplies: false,
+  redistributionAllowed: false
+});
+
+const WATERMARK = Object.freeze({ required: true, text: 'Flyfish Viewer' });
+let enginePromise;
+
+export function getPptPackageManifest() {
+  return { ...MANIFEST };
+}
+
+export async function loadPptViewer(options = {}) {
+  const engine = await loadEngine(options.wasmUrl);
+  return createRuntime(engine);
+}
+
+export const createPptViewer = loadPptViewer;
+
+async function loadEngine(wasmSource) {
+  if (wasmSource !== undefined) return instantiateEngine(wasmSource);
+  if (!enginePromise) {
+    enginePromise = instantiateEngine(DEFAULT_WASM_URL).catch((error) => {
+      enginePromise = undefined;
+      throw error;
+    });
+  }
+  return enginePromise;
+}
+
+async function instantiateEngine(source) {
+  const bytes = await loadWasmBytes(source);
+  await verifyWasmIntegrity(bytes);
+  const module = await WebAssembly.compile(bytes);
+  const imports = WebAssembly.Module.imports(module);
+  if (imports.length !== 0) {
+    throw packageError('wasm-imports-rejected', 'The PPT rendering engine must not import browser or host functions.');
+  }
+  const instance = await WebAssembly.instantiate(module, {});
+  validateEngine(instance.exports);
+  return Object.freeze({ module, exports: instance.exports });
+}
+
+async function verifyWasmIntegrity(bytes) {
+  const subtle = globalThis.crypto?.subtle;
+  if (!subtle || typeof subtle.digest !== 'function') {
+    throw packageError('wasm-integrity-unavailable', 'Web Crypto SHA-256 support is required to verify the PPT rendering engine.');
+  }
+  const digest = new Uint8Array(await subtle.digest('SHA-256', bytes));
+  const actual = Array.from(digest, (byte) => byte.toString(16).padStart(2, '0')).join('');
+  if (actual !== MANIFEST.wasmSha256) {
+    throw packageError('wasm-integrity-invalid', 'The PPT rendering engine failed its SHA-256 integrity check.');
+  }
+}
+
+async function loadWasmBytes(source) {
+  if (source instanceof WebAssembly.Module) {
+    throw packageError('wasm-module-unsupported', 'Pass a URL, Response, ArrayBuffer, or Uint8Array so the engine can be verified before use.');
+  }
+  if (source instanceof Uint8Array) return source.slice();
+  if (source instanceof ArrayBuffer) return new Uint8Array(source.slice(0));
+  if (typeof Response !== 'undefined' && source instanceof Response) {
+    if (!source.ok) throw packageError('wasm-request-failed', `The PPT rendering engine request failed with HTTP ${source.status}.`);
+    return new Uint8Array(await source.arrayBuffer());
+  }
+  const response = await fetch(source instanceof URL || typeof source === 'string' ? source : DEFAULT_WASM_URL);
+  if (!response.ok) throw packageError('wasm-request-failed', `The PPT rendering engine request failed with HTTP ${response.status}.`);
+  return new Uint8Array(await response.arrayBuffer());
+}
+
+function validateEngine(api) {
+  const actual = Object.keys(api).sort();
+  const expected = [...WASM_EXPORTS].sort();
+  if (actual.length !== expected.length || actual.some((name, index) => name !== expected[index])) {
+    throw packageError('wasm-abi-invalid', 'The PPT rendering engine has an unexpected public ABI.');
+  }
+  if (!(api.memory instanceof WebAssembly.Memory)) {
+    throw packageError('wasm-memory-invalid', 'The PPT rendering engine did not provide its bounded working memory.');
+  }
+  for (const name of WASM_EXPORTS) {
+    if (name !== 'memory' && typeof api[name] !== 'function') {
+      throw packageError('wasm-abi-invalid', `The PPT rendering engine is missing ${name}.`);
+    }
+  }
+}
+
+function createRuntime(engine) {
+  const api = engine.exports;
+  return Object.freeze({
+    license: LICENSE,
+    watermark: WATERMARK,
+    open(input) {
+      return openDocument(api, input);
+    },
+    async mount(target, input, options = {}) {
+      const document = openDocument(api, input);
+      try {
+        return await mountDocument(document, target, options);
+      } catch (error) {
+        document.close();
+        throw error;
+      }
+    }
+  });
+}
+
+function openDocument(api, input) {
+  const bytes = normalizeInput(input);
+  if (bytes.byteLength < 8 || !hasCfbSignature(bytes)) {
+    throw packageError('ppt-signature-invalid', 'Input is not a PowerPoint 97-2003 (.ppt) compound document.');
+  }
+  const pointer = Number(api.ppt_input_alloc(bytes.byteLength));
+  if (!pointer) throw engineError(api, 'Unable to allocate native input memory.');
+  let handle = 0;
+  try {
+    new Uint8Array(api.memory.buffer, pointer, bytes.byteLength).set(bytes);
+    handle = Number(api.ppt_document_open(pointer, bytes.byteLength));
+  } finally {
+    api.ppt_input_free(pointer, bytes.byteLength);
+  }
+  if (!handle) throw engineError(api, 'The native PPT parser rejected the document.');
+
+  const slideCount = Number(api.ppt_slide_count(handle));
+  const slideWidth = Number(api.ppt_slide_width(handle, 1000));
+  const slideHeight = Number(api.ppt_slide_height(handle, 1000));
+  if (!Number.isInteger(slideCount) || slideCount < 1 || slideCount > 10000
+    || !Number.isFinite(slideWidth) || slideWidth <= 0
+    || !Number.isFinite(slideHeight) || slideHeight <= 0) {
+    api.ppt_document_close(handle);
+    throw engineError(api, 'The native PPT parser returned invalid presentation dimensions.');
+  }
+
+  let closed = false;
+  const document = {
+    get slideCount() { return slideCount; },
+    get width() { return slideWidth; },
+    get height() { return slideHeight; },
+    get closed() { return closed; },
+    renderSlide(slideIndex, canvas, options = {}) {
+      if (closed) throw packageError('document-closed', 'The PPT document is already closed.');
+      return renderSlide(api, handle, slideCount, slideWidth, slideHeight, slideIndex, canvas, options);
+    },
+    close() {
+      if (!closed) {
+        closed = true;
+        if (Number(api.ppt_document_close(handle)) !== 1) throw engineError(api, 'Unable to close the native PPT document.');
+      }
+    }
+  };
+  return Object.freeze(document);
+}
+
+function renderSlide(api, documentHandle, slideCount, logicalWidth, logicalHeight, slideIndex, canvas, options) {
+  if (!Number.isInteger(slideIndex) || slideIndex < 0 || slideIndex >= slideCount) {
+    throw new RangeError(`slideIndex must be between 0 and ${slideCount - 1}.`);
+  }
+  if (!canvas || typeof canvas.getContext !== 'function') {
+    throw new TypeError('renderSlide requires an HTMLCanvasElement or OffscreenCanvas.');
+  }
+  const scale = finitePositive(options.scale, 1);
+  const pixelRatio = finitePositive(options.pixelRatio, defaultPixelRatio());
+  const nativeScale = scale * pixelRatio;
+  if (nativeScale < 0.1 || nativeScale > 8) {
+    throw new RangeError('scale * pixelRatio must be between 0.1 and 8.');
+  }
+  const scaleMilli = Math.round(nativeScale * 1000);
+  const pixelWidth = Number(api.ppt_slide_width(documentHandle, scaleMilli));
+  const pixelHeight = Number(api.ppt_slide_height(documentHandle, scaleMilli));
+  const frame = Number(api.ppt_render_slide_rgba(documentHandle, slideIndex, scaleMilli));
+  if (!frame) throw engineError(api, `Unable to render slide ${slideIndex + 1}.`);
+  try {
+    const width = Number(api.ppt_frame_width(frame));
+    const height = Number(api.ppt_frame_height(frame));
+    const stride = Number(api.ppt_frame_stride(frame));
+    const length = Number(api.ppt_frame_len(frame));
+    const pointer = Number(api.ppt_frame_ptr(frame));
+    if (width !== pixelWidth || height !== pixelHeight || stride !== width * 4 || length !== stride * height || !pointer) {
+      throw packageError('wasm-frame-invalid', 'The native PPT engine returned an invalid RGBA frame.');
+    }
+    const pixels = new Uint8ClampedArray(api.memory.buffer, pointer, length).slice();
+    canvas.width = width;
+    canvas.height = height;
+    if ('style' in canvas && canvas.style) {
+      canvas.style.width = `${Math.round(logicalWidth * scale)}px`;
+      canvas.style.maxWidth = '100%';
+      canvas.style.height = 'auto';
+      canvas.style.aspectRatio = `${width} / ${height}`;
+      canvas.style.display = 'block';
+    }
+    const context = canvas.getContext('2d', { alpha: false, desynchronized: false });
+    if (!context || typeof context.putImageData !== 'function') {
+      throw packageError('canvas-context-unavailable', 'A 2D Canvas context is required to display PPT slides.');
+    }
+    let imageData;
+    if (typeof ImageData === 'function') {
+      imageData = new ImageData(pixels, width, height);
+    } else {
+      imageData = context.createImageData(width, height);
+      imageData.data.set(pixels);
+    }
+    context.putImageData(imageData, 0, 0);
+    return Object.freeze({ slideIndex, width, height, logicalWidth, logicalHeight, scale, pixelRatio });
+  } finally {
+    api.ppt_frame_free(frame);
+  }
+}
+
+async function mountDocument(document, target, options) {
+  const container = resolveElement(target);
+  const root = documentRoot(container, options);
+  const canvases = [];
+  for (let slideIndex = 0; slideIndex < document.slideCount; slideIndex += 1) {
+    const canvas = documentCanvas(root, slideIndex);
+    document.renderSlide(slideIndex, canvas, options);
+    canvases.push(canvas);
+    if (slideIndex + 1 < document.slideCount) await yieldToBrowser();
+  }
+  return Object.freeze({
+    document,
+    root,
+    canvases: Object.freeze(canvases),
+    close() {
+      document.close();
+      root.remove();
+    }
+  });
+}
+
+function resolveElement(target) {
+  const element = typeof target === 'string' ? document.querySelector(target) : target;
+  if (!element || typeof element.append !== 'function') {
+    throw new TypeError('mount requires a DOM element or a selector that resolves to one.');
+  }
+  return element;
+}
+
+function documentRoot(container, options) {
+  if (options.replace !== false) container.replaceChildren();
+  const root = document.createElement('div');
+  root.className = options.className || 'flyfish-ppt-viewer';
+  root.dataset.flyfishPptEdition = 'public-watermarked';
+  root.style.cssText = 'display:grid;width:100%;min-width:0;justify-content:center;gap:20px;padding:20px;box-sizing:border-box;background:#eef1f5;';
+  container.append(root);
+  return root;
+}
+
+function documentCanvas(root, slideIndex) {
+  const shell = document.createElement('section');
+  shell.dataset.slideIndex = String(slideIndex);
+  shell.style.cssText = 'max-width:100%;min-width:0;overflow:hidden;background:#fff;box-shadow:0 8px 28px rgba(15,23,42,.14);';
+  const canvas = document.createElement('canvas');
+  canvas.setAttribute('role', 'img');
+  canvas.setAttribute('aria-label', `Slide ${slideIndex + 1}`);
+  shell.append(canvas);
+  root.append(shell);
+  return canvas;
+}
+
+function normalizeInput(input) {
+  if (input instanceof Uint8Array) return input;
+  if (input instanceof ArrayBuffer) return new Uint8Array(input);
+  if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
+  throw new TypeError('PPT input must be an ArrayBuffer or Uint8Array.');
+}
+
+function hasCfbSignature(bytes) {
+  const signature = [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1];
+  return signature.every((value, index) => bytes[index] === value);
+}
+
+function finitePositive(value, fallback) {
+  if (value === undefined) return fallback;
+  const number = Number(value);
+  if (!Number.isFinite(number) || number <= 0) throw new RangeError('Render scale and pixelRatio must be finite positive numbers.');
+  return number;
+}
+
+function defaultPixelRatio() {
+  return typeof devicePixelRatio === 'number' && Number.isFinite(devicePixelRatio) ? Math.max(1, devicePixelRatio) : 1;
+}
+
+function yieldToBrowser() {
+  if (typeof requestAnimationFrame === 'function') return new Promise((resolve) => requestAnimationFrame(() => resolve()));
+  return Promise.resolve();
+}
+
+function engineError(api, fallback) {
+  const code = Number(api.ppt_last_error_code()) || 0;
+  return packageError(`native-${code || 'unknown'}`, `${fallback} (native error ${code || 'unknown'})`);
+}
+
+function packageError(code, message) {
+  const error = new Error(message);
+  error.name = 'FlyfishPptError';
+  Object.defineProperty(error, 'code', { value: code, enumerable: true });
+  return error;
+}

package/manifest.json

@@ -0,0 +1,30 @@
+{
+  "kind": "flyfish-ppt-public-native-wasm-v1",
+  "product": "Flyfish PPT Viewer",
+  "format": "PowerPoint 97-2003 (.ppt)",
+  "packageName": "@file-viewer/ppt",
+  "packageVersion": "0.2.0",
+  "engine": "flyfish-classic-ppt-native-engine",
+  "engineBuild": "ef5987a0a85b6103",
+  "id": "FV-PPT-PUBLIC-WATERMARKED-V2",
+  "feature": "ppt",
+  "edition": "public-watermarked",
+  "holder": "Individual Personal Non-Commercial Use",
+  "distribution": "proprietary-public-binary",
+  "commercialUse": false,
+  "publicAnyOrigin": true,
+  "watermarkRequired": true,
+  "watermarkText": "Flyfish Viewer",
+  "usePolicy": "public-individual-noncommercial-watermarked",
+  "licensePolicy": "flyfish-public-watermarked-binary-license-v1",
+  "sourceCodeRights": false,
+  "sourceDeliveryRights": false,
+  "apacheLicenseApplies": false,
+  "redistributionAllowed": false,
+  "runtimeLicenseRequired": false,
+  "renderer": "native-wasm-rgba-canvas",
+  "integrity": "native-wasm-sha256-v1",
+  "wasmFile": "ppt-native.wasm",
+  "watermarkEnforcement": "native-final-frame",
+  "wasmSha256": "ef5987a0a85b61034ea651a02a28d4582ad19a09610e9a5637dcf01136815a2e"
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@file-viewer/ppt",
+  "version": "0.2.0",
+  "description": "Professional native WebAssembly canvas viewer for PowerPoint 97-2003 (.ppt) files.",
+  "type": "module",
+  "main": "./index.mjs",
+  "module": "./index.mjs",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.mjs",
+      "default": "./index.mjs"
+    },
+    "./manifest.json": "./manifest.json",
+    "./ppt-native.wasm": "./ppt-native.wasm",
+    "./LICENSE": "./LICENSE"
+  },
+  "files": [
+    "LICENSE",
+    "NOTICE",
+    "README.md",
+    "index.d.ts",
+    "index.mjs",
+    "manifest.json",
+    "ppt-native.wasm"
+  ],
+  "sideEffects": false,
+  "license": "SEE LICENSE IN LICENSE",
+  "keywords": [
+    "ppt",
+    "powerpoint",
+    "viewer",
+    "preview",
+    "canvas",
+    "wasm",
+    "document"
+  ],
+  "homepage": "https://officejs-doc.pages.dev",
+  "bugs": {
+    "url": "https://github.com/flyfish-dev/office-preview-js/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}