@mecorelabs/free-pdf-sdk 0.0.0-stage → 0.2.1

package/LICENSE-APACHE

@@ -0,0 +1,177 @@
+
+                                 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
+      (an example is provided in the Appendix below).
+
+      "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

package/LICENSE-MIT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 the Free PDF SDK contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,46 @@
+Free PDF SDK
+Copyright (c) 2026 the Free PDF SDK contributors.
+Licensed under the MIT License or the Apache License, Version 2.0, at your option
+(LICENSE-MIT, LICENSE-APACHE).
+
+Based on pdfcraft
+-----------------
+Free PDF SDK is based on pdfcraft by the ArtCraft Team and the PdfCraft contributors
+(https://github.com/storytold/pdfcraft), used as a Cargo dependency pinned to commit
+
+    88dad98dd478d255399b1405b33765f4da542704 (pdfcraft 0.11.0)
+
+with Free PDF SDK modifications to pdfcraft's interface crate (pdfcraft-ui-egui): opt-in hooks
+for white-label branding and for hiding features. The exact modified commit is in Cargo.lock
+and in version.json as "pdfcraftRev".
+
+pdfcraft is Copyright (c) 2026 ArtCraft Team and the PdfCraft contributors, licensed under
+the MIT License or the Apache License, Version 2.0. Its licence files, NOTICE and
+ATTRIBUTION.md are in third-party/pdfcraft/.
+
+Trademarks
+----------
+"ArtCraft", "PdfCraft" and the ArtCraft logos are trademarks of the ArtCraft Team. Free PDF SDK
+does not use them as its name or logo, does not display them, and is not endorsed by the
+ArtCraft Team. The ArtCraft logos are not compiled into the viewer (pdfcraft-ui-egui is built
+without its `artcraft-marks` feature); the names remain only inside pdfcraft's unused message
+strings and translations. The placeholder logos in brand/ are original to this project.
+
+Third-party material
+--------------------
+The viewer embeds third-party material under its own licences: Lucide icons (ISC); the Inter,
+JetBrains Mono and Dancing Script typefaces (SIL OFL 1.1); egui's default fonts (Ubuntu Font
+Licence 1.0, MIT / Bitstream Vera, SIL OFL 1.1, MIT); the Foxit standard-14 substitute fonts and
+Adobe CMap resources (BSD-3-Clause); a CC0 ICC profile; and the Rust crates listed in
+third-party/crates.md. Licences and required notices are in third-party/ (see its README.md).
+
+  Foxit standard-14 substitute fonts:
+    Copyright 2014 PDFium Authors. All rights reserved. Original code copyright 2014 Foxit
+    Software Inc. Redistributed under the BSD-3-Clause licence (third-party/foxit/LICENSE_FOXIT).
+
+  CMap resources (character-mapping data bundled by hayro-cmap):
+    Copyright 1990-2023 Adobe. All rights reserved. Redistributed under the BSD-3-Clause licence
+    (third-party/adobe-cmaps/LICENSE.txt). Neither the name of Adobe nor the names of its
+    contributors are used to endorse or promote this product.
+
+The brand/ placeholder wordmarks contain outlines of the Inter typeface (SIL OFL 1.1).

package/README.md

@@ -1,3 +1,105 @@
-# Temporary Holding Version
+# Free PDF SDK
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Show your users exactly what they need. Hide the rest.**
+
+A free, open-source, white-label PDF viewer, annotator and editor for the web. Your users switch
+PDF layers on and off with a click. You switch panels, tools and whole features on or off, and
+every menu, toolbar and shortcut follows. It runs in the browser (WebAssembly), so documents never
+leave your page.
+
+[Website](https://freepdfsdk.mecorelabs.com/) · [Live demo](https://freepdfsdk.mecorelabs.com/demo/) ·
+[Get started](https://freepdfsdk.mecorelabs.com/docs/getting-started/) ·
+[Docs](https://freepdfsdk.mecorelabs.com/docs/) · [GitHub](https://github.com/GeorgeMilroy/free-pdf-sdk)
+
+![The viewer in annotate mode on a floor plan, with the Layers panel open and the Furniture layer hidden](https://freepdfsdk.mecorelabs.com/assets/img/viewer-layers.png)
+
+- **8 modes**, from read-only to full authoring, and **31 feature switches**. What's off is gone
+  from every menu, toolbar, right-click menu and shortcut, not greyed out.
+- **PDF layers**: show or hide structure, furniture, electrical, dimensions... in one click.
+  Printing follows what is shown; the file is untouched.
+- **Comments & review**: notes, callouts, highlights, shapes, ink and stamps, with replies and
+  review status. Standard XFDF in and out.
+- **Measurement**, **Forms, Fill & Sign**, **page organization**, **redaction**, **signature
+  validation**, export to Word, images and HTML, PDF/A, accessibility checker, search and print.
+- **Private by design**: an iframe on your own origin, no server, no uploads, no tracking.
+  AES-256 encrypted files open in place; an owner password lifts their restrictions.
+- **23 languages**, light, dark and system themes.
+- **React, Vue, Svelte, Angular** (Web Component) and plain JavaScript. Fully typed.
+
+## Install
+
+```bash
+npm install @mecorelabs/free-pdf-sdk
+npx @mecorelabs/free-pdf-sdk copy-viewer public/free-pdf-sdk
+```
+
+The second command copies the viewer files into a folder your site serves. The viewer must be
+served from the same origin as your page. Run it again after upgrading, or add it as a
+`postinstall` script: `"postinstall": "free-pdf-sdk copy-viewer public/free-pdf-sdk"`.
+
+## Use
+
+```ts
+import { FreePdf } from "@mecorelabs/free-pdf-sdk";
+
+const viewer = await FreePdf.init(document.getElementById("viewer")!, {
+  baseUrl: "/free-pdf-sdk/",
+  mode: "annotate",
+  features: { stamps: false, measurement: false },
+  author: "Ada Lovelace",
+  document: { url: "/files/plan.pdf" },
+});
+
+viewer.on("annotationsChanged", ({ count }) => console.log(count, "comments"));
+const xfdf = await viewer.exportXfdf();      // store it anywhere; importXfdf() brings it back
+```
+
+Give the element a height. Modes: `view`, `review`, `annotate`, `fill`, `sign`, `organize`,
+`edit`, `full`.
+
+### Frameworks
+
+```tsx
+// React
+import { FreePdfViewer } from "@mecorelabs/free-pdf-sdk/react";
+<FreePdfViewer baseUrl="/free-pdf-sdk/" mode="annotate" document={{ url: "/files/plan.pdf" }} style={{ height: "80vh" }} />
+```
+
+```vue
+<!-- Vue -->
+<script setup lang="ts">
+import { FreePdfViewer } from "@mecorelabs/free-pdf-sdk/vue";
+</script>
+<template>
+  <FreePdfViewer base-url="/free-pdf-sdk/" mode="annotate" :document="{ url: '/files/plan.pdf' }" style="height: 80vh" />
+</template>
+```
+
+```html
+<!-- Web Component: Angular and everything else -->
+<script type="module">
+  import { defineFreePdfViewer } from "@mecorelabs/free-pdf-sdk/element";
+  defineFreePdfViewer();
+</script>
+<free-pdf-viewer base-url="/free-pdf-sdk/" src="/files/plan.pdf" mode="view" style="height: 80vh"></free-pdf-viewer>
+```
+
+Svelte: `import { freePdf } from "@mecorelabs/free-pdf-sdk/svelte"` (an action).
+
+## Documentation
+
+Guides for every framework, the full API reference and recipes:
+**[freepdfsdk.mecorelabs.com/docs](https://freepdfsdk.mecorelabs.com/docs/)**. For AI coding assistants,
+every page is also Markdown, indexed in [/llms.txt](https://freepdfsdk.mecorelabs.com/llms.txt), with a
+[JSON Schema](https://freepdfsdk.mecorelabs.com/schema/viewer-options.schema.json) of the options.
+
+## Support the project
+
+Free PDF SDK is open source and free. Donations pay for bringing in each new engine release,
+testing new browsers, fixing bugs and keeping the docs current:
+[Donate on Ko-fi](https://ko-fi.com/K4V228W28L).
+
+## Licence
+
+MIT OR Apache-2.0. Built on [pdfcraft](https://github.com/storytold/pdfcraft) by the ArtCraft
+Team; see `NOTICE` and `third-party/` in the package.

package/bin/free-pdf-sdk.mjs

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+// Free PDF SDK command line: copies the viewer files (viewer/, version.json and the licences)
+// from this package into a folder your web server serves, such as public/free-pdf-sdk.
+//
+//   npx @mecorelabs/free-pdf-sdk copy-viewer public/free-pdf-sdk
+//
+// Run it after every install or upgrade (for example in a "postinstall" or "prebuild" script),
+// so the viewer always matches the wrapper version.
+
+import { cpSync, existsSync, mkdirSync, rmSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const pkg = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const [command, target] = process.argv.slice(2);
+
+function usage(code) {
+  console.log("Usage: free-pdf-sdk copy-viewer <folder>\n\nCopies the viewer files into <folder>; then use that folder's URL as baseUrl.");
+  process.exit(code);
+}
+
+if (command === "--help" || command === "-h") usage(0);
+if (command !== "copy-viewer" || !target) usage(1);
+
+const source = join(pkg, "viewer");
+if (!existsSync(source)) {
+  console.error(`free-pdf-sdk: ${source} is missing; reinstall the package`);
+  process.exit(1);
+}
+const dest = resolve(process.cwd(), target);
+mkdirSync(dest, { recursive: true });
+// A new version has new hashed file names: start clean so old ones don't pile up.
+rmSync(join(dest, "viewer"), { recursive: true, force: true });
+cpSync(source, join(dest, "viewer"), { recursive: true });
+for (const file of ["version.json", "NOTICE", "LICENSE-MIT", "LICENSE-APACHE"]) {
+  if (existsSync(join(pkg, file))) cpSync(join(pkg, file), join(dest, file));
+}
+if (existsSync(join(pkg, "third-party"))) cpSync(join(pkg, "third-party"), join(dest, "third-party"), { recursive: true });
+console.log(`free-pdf-sdk: copied the viewer to ${dest}`);

package/dist/controller.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The shared engine of the framework adapters: mounts a viewer in a container, turns later
+ * option changes into the matching API calls (in order), and tears it down. The Web Component,
+ * React, Vue and Svelte integrations are thin layers over it.
+ *
+ * @packageDocumentation
+ */
+import { type EventMap, type EventName, type FreePdfViewer, type InitOptions } from "./free-pdf-sdk.js";
+/** The DOM event name for each SDK event (`<free-pdf-viewer>` and the Svelte action). */
+export declare const ELEMENT_EVENTS: Record<EventName, string>;
+/** Every event name, for adapters that forward them all. */
+export declare const EVENT_NAMES: readonly EventName[];
+/** What a controller mounts: the {@link InitOptions} without `listeners`. */
+export type ViewerOptions = Omit<InitOptions, "listeners">;
+/** Receives every event of the viewer. */
+export type EventSink = <K extends EventName>(name: K, data: EventMap[K]) => void;
+/** A viewer whose options can change after it mounted. */
+export declare class FreePdfController {
+    private readonly container;
+    private readonly sink;
+    private viewer;
+    private options;
+    private queue;
+    private generation;
+    private destroyed;
+    /** The iframe of a mount still starting, removed at once if it is abandoned. */
+    private starting;
+    /** Resolves with the viewer once it is ready and its first document has loaded or failed to (a failure is a `documentError` event). */
+    ready: Promise<FreePdfViewer>;
+    /**
+     * @param container - The element the viewer fills; give it a size.
+     * @param options - Initial options.
+     * @param sink - Called with every event.
+     */
+    constructor(container: HTMLElement, options: ViewerOptions, sink: EventSink);
+    /** The mounted viewer, once ready. */
+    get current(): FreePdfViewer | null;
+    private mount;
+    /**
+     * Applies new options: what changed becomes API calls (`setMode`, `setFeatures`, `setUi`,
+     * `setTheme`, `setAuthor`, `setLocale`, `setDisabledElements`, `load`); a new `baseUrl`
+     * mounts a new viewer. Failures are reported as `error` events.
+     */
+    update(next: ViewerOptions): void;
+    /** Removes the viewer. Safe to call twice. */
+    destroy(): Promise<void>;
+}

package/dist/controller.js

@@ -0,0 +1,170 @@
+/**
+ * The shared engine of the framework adapters: mounts a viewer in a container, turns later
+ * option changes into the matching API calls (in order), and tears it down. The Web Component,
+ * React, Vue and Svelte integrations are thin layers over it.
+ *
+ * @packageDocumentation
+ */
+import { FreePdfError, init, } from "./free-pdf-sdk.js";
+/** The DOM event name for each SDK event (`<free-pdf-viewer>` and the Svelte action). */
+export const ELEMENT_EVENTS = {
+    ready: "fps-ready",
+    documentLoaded: "fps-document-loaded",
+    documentError: "fps-document-error",
+    annotationsChanged: "fps-annotations-changed",
+    dirtyChanged: "fps-dirty-changed",
+    error: "fps-error",
+    saveRequested: "fps-save-requested",
+};
+/** Every event name, for adapters that forward them all. */
+export const EVENT_NAMES = ["ready", "documentLoaded", "documentError", "annotationsChanged", "dirtyChanged", "error", "saveRequested"];
+const same = (a, b) => JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
+function sameDocument(a, b) {
+    if (!a || !b)
+        return a === b;
+    if ("url" in a && "url" in b)
+        return a.url === b.url && a.name === b.name;
+    if ("data" in a && "data" in b)
+        return a.data === b.data && a.name === b.name;
+    return false;
+}
+/** A viewer whose options can change after it mounted. */
+export class FreePdfController {
+    /**
+     * @param container - The element the viewer fills; give it a size.
+     * @param options - Initial options.
+     * @param sink - Called with every event.
+     */
+    constructor(container, options, sink) {
+        this.container = container;
+        this.sink = sink;
+        this.viewer = null;
+        this.queue = Promise.resolve();
+        this.generation = 0;
+        this.destroyed = false;
+        /** The iframe of a mount still starting, removed at once if it is abandoned. */
+        this.starting = null;
+        this.options = options;
+        this.ready = this.mount();
+    }
+    /** The mounted viewer, once ready. */
+    get current() {
+        return this.viewer;
+    }
+    mount() {
+        const generation = ++this.generation;
+        const listeners = {};
+        for (const name of EVENT_NAMES) {
+            listeners[name] = (data) => {
+                if (generation === this.generation && !this.destroyed)
+                    this.sink(name, data);
+            };
+        }
+        // The viewer starts without the document: a document that fails to open must not take the
+        // viewer with it (init would remove it), so later options can still load another one.
+        const { document: doc, password, ...config } = this.options;
+        const started = init(this.container, { ...config, listeners });
+        // init appends its iframe synchronously; remember it so an abandoned start can remove it.
+        this.starting = this.container.lastElementChild;
+        return started.then(async (viewer) => {
+            this.starting = null;
+            if (generation !== this.generation || this.destroyed) {
+                await viewer.destroy();
+                throw new FreePdfError("DESTROYED", "the viewer was replaced before it was ready");
+            }
+            this.viewer = viewer;
+            if (doc) {
+                // The viewer reports a failure itself (documentError); ready still resolves.
+                await viewer.load(doc, password === undefined ? undefined : { password }).catch(() => undefined);
+            }
+            return viewer;
+        }, (e) => {
+            this.starting = null;
+            const err = e instanceof FreePdfError ? e : new FreePdfError("INTERNAL", String(e));
+            if (generation === this.generation && !this.destroyed && err.code !== "DESTROYED")
+                this.sink("error", { code: err.code, message: err.message });
+            throw err;
+        });
+    }
+    /**
+     * Applies new options: what changed becomes API calls (`setMode`, `setFeatures`, `setUi`,
+     * `setTheme`, `setAuthor`, `setLocale`, `setDisabledElements`, `load`); a new `baseUrl`
+     * mounts a new viewer. Failures are reported as `error` events.
+     */
+    update(next) {
+        const prev = this.options;
+        this.options = next;
+        if (this.destroyed)
+            return;
+        if (next.baseUrl !== prev.baseUrl) {
+            const old = this.viewer;
+            this.viewer = null;
+            this.queue = Promise.resolve();
+            this.starting?.remove();
+            this.starting = null;
+            void old?.destroy();
+            this.ready = this.mount();
+            this.ready.catch(() => undefined);
+            return;
+        }
+        const calls = [];
+        if (next.mode !== undefined && next.mode !== prev.mode)
+            calls.push((v) => v.setMode(next.mode ?? "view"));
+        if (!same(next.features, prev.features))
+            calls.push((v) => v.setFeatures(next.features ?? {}));
+        if (!same(next.ui, prev.ui) && next.ui)
+            calls.push((v) => v.setUi(next.ui ?? {}));
+        if (!same(next.disabledElements, prev.disabledElements))
+            calls.push((v) => v.setDisabledElements(next.disabledElements ?? []));
+        if (next.theme !== undefined && next.theme !== prev.theme)
+            calls.push((v) => v.setTheme(next.theme ?? "system"));
+        if (next.author !== undefined && next.author !== prev.author)
+            calls.push((v) => v.setAuthor(next.author ?? ""));
+        if (next.locale !== undefined && next.locale !== prev.locale)
+            calls.push((v) => v.setLocale(next.locale ?? "en"));
+        if (next.document && !sameDocument(next.document, prev.document)) {
+            const doc = next.document;
+            calls.push((v) => v.load(doc, next.password === undefined ? undefined : { password: next.password }));
+        }
+        if (calls.length === 0)
+            return;
+        const generation = this.generation;
+        this.queue = this.queue
+            .then(() => this.ready)
+            .then(async (v) => {
+            // Each call on its own: one refused call (a bad locale) must not drop the rest (the load).
+            for (const call of calls) {
+                if (generation !== this.generation || this.destroyed)
+                    return;
+                try {
+                    await call(v);
+                }
+                catch (e) {
+                    if (generation !== this.generation || this.destroyed)
+                        return;
+                    const err = e instanceof FreePdfError ? e : new FreePdfError("INTERNAL", String(e));
+                    if (err.code !== "DESTROYED")
+                        this.sink("error", { code: err.code, message: err.message });
+                }
+            }
+        })
+            .catch(() => undefined);
+    }
+    /** Removes the viewer. Safe to call twice. */
+    async destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        this.generation++;
+        const v = this.viewer;
+        this.viewer = null;
+        // A start still under way: take its iframe away now (it is destroyed when init settles).
+        this.starting?.remove();
+        this.starting = null;
+        if (v)
+            await v.destroy();
+        else
+            await this.ready.then((late) => late.destroy()).catch(() => undefined);
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The shared engine of the framework adapters: mounts a viewer in a container, turns later\n * option changes into the matching API calls (in order), and tears it down. The Web Component,\n * React, Vue and Svelte integrations are thin layers over it.\n *\n * @packageDocumentation\n */\n\nimport {\n  type DocumentSource,\n  type EventMap,\n  type EventName,\n  type FreePdfViewer,\n  type InitOptions,\n  type Listener,\n  FreePdfError,\n  init,\n} from \"./free-pdf-sdk.js\";\n\n/** The DOM event name for each SDK event (`<free-pdf-viewer>` and the Svelte action). */\nexport const ELEMENT_EVENTS: Record<EventName, string> = {\n  ready: \"fps-ready\",\n  documentLoaded: \"fps-document-loaded\",\n  documentError: \"fps-document-error\",\n  annotationsChanged: \"fps-annotations-changed\",\n  dirtyChanged: \"fps-dirty-changed\",\n  error: \"fps-error\",\n  saveRequested: \"fps-save-requested\",\n};\n\n/** Every event name, for adapters that forward them all. */\nexport const EVENT_NAMES: readonly EventName[] = [\"ready\", \"documentLoaded\", \"documentError\", \"annotationsChanged\", \"dirtyChanged\", \"error\", \"saveRequested\"];\n\n/** What a controller mounts: the {@link InitOptions} without `listeners`. */\nexport type ViewerOptions = Omit<InitOptions, \"listeners\">;\n\n/** Receives every event of the viewer. */\nexport type EventSink = <K extends EventName>(name: K, data: EventMap[K]) => void;\n\nconst same = (a: unknown, b: unknown): boolean => JSON.stringify(a ?? null) === JSON.stringify(b ?? null);\n\nfunction sameDocument(a: DocumentSource | undefined, b: DocumentSource | undefined): boolean {\n  if (!a || !b) return a === b;\n  if (\"url\" in a && \"url\" in b) return a.url === b.url && a.name === b.name;\n  if (\"data\" in a && \"data\" in b) return a.data === b.data && a.name === b.name;\n  return false;\n}\n\n/** A viewer whose options can change after it mounted. */\nexport class FreePdfController {\n  private viewer: FreePdfViewer | null = null;\n  private options: ViewerOptions;\n  private queue: Promise<unknown> = Promise.resolve();\n  private generation = 0;\n  private destroyed = false;\n  /** The iframe of a mount still starting, removed at once if it is abandoned. */\n  private starting: Element | null = null;\n  /** Resolves with the viewer once it is ready and its first document has loaded or failed to (a failure is a `documentError` event). */\n  ready: Promise<FreePdfViewer>;\n\n  /**\n   * @param container - The element the viewer fills; give it a size.\n   * @param options - Initial options.\n   * @param sink - Called with every event.\n   */\n  constructor(\n    private readonly container: HTMLElement,\n    options: ViewerOptions,\n    private readonly sink: EventSink,\n  ) {\n    this.options = options;\n    this.ready = this.mount();\n  }\n\n  /** The mounted viewer, once ready. */\n  get current(): FreePdfViewer | null {\n    return this.viewer;\n  }\n\n  private mount(): Promise<FreePdfViewer> {\n    const generation = ++this.generation;\n    const listeners: { [K in EventName]?: Listener<K> } = {};\n    for (const name of EVENT_NAMES) {\n      (listeners as Record<EventName, Listener<EventName>>)[name] = (data) => {\n        if (generation === this.generation && !this.destroyed) this.sink(name, data);\n      };\n    }\n    // The viewer starts without the document: a document that fails to open must not take the\n    // viewer with it (init would remove it), so later options can still load another one.\n    const { document: doc, password, ...config } = this.options;\n    const started = init(this.container, { ...config, listeners });\n    // init appends its iframe synchronously; remember it so an abandoned start can remove it.\n    this.starting = this.container.lastElementChild;\n    return started.then(\n      async (viewer) => {\n        this.starting = null;\n        if (generation !== this.generation || this.destroyed) {\n          await viewer.destroy();\n          throw new FreePdfError(\"DESTROYED\", \"the viewer was replaced before it was ready\");\n        }\n        this.viewer = viewer;\n        if (doc) {\n          // The viewer reports a failure itself (documentError); ready still resolves.\n          await viewer.load(doc, password === undefined ? undefined : { password }).catch(() => undefined);\n        }\n        return viewer;\n      },\n      (e: unknown) => {\n        this.starting = null;\n        const err = e instanceof FreePdfError ? e : new FreePdfError(\"INTERNAL\", String(e));\n        if (generation === this.generation && !this.destroyed && err.code !== \"DESTROYED\") this.sink(\"error\", { code: err.code, message: err.message });\n        throw err;\n      },\n    );\n  }\n\n  /**\n   * Applies new options: what changed becomes API calls (`setMode`, `setFeatures`, `setUi`,\n   * `setTheme`, `setAuthor`, `setLocale`, `setDisabledElements`, `load`); a new `baseUrl`\n   * mounts a new viewer. Failures are reported as `error` events.\n   */\n  update(next: ViewerOptions): void {\n    const prev = this.options;\n    this.options = next;\n    if (this.destroyed) return;\n    if (next.baseUrl !== prev.baseUrl) {\n      const old = this.viewer;\n      this.viewer = null;\n      this.queue = Promise.resolve();\n      this.starting?.remove();\n      this.starting = null;\n      void old?.destroy();\n      this.ready = this.mount();\n      this.ready.catch(() => undefined);\n      return;\n    }\n    const calls: Array<(v: FreePdfViewer) => Promise<unknown>> = [];\n    if (next.mode !== undefined && next.mode !== prev.mode) calls.push((v) => v.setMode(next.mode ?? \"view\"));\n    if (!same(next.features, prev.features)) calls.push((v) => v.setFeatures(next.features ?? {}));\n    if (!same(next.ui, prev.ui) && next.ui) calls.push((v) => v.setUi(next.ui ?? {}));\n    if (!same(next.disabledElements, prev.disabledElements)) calls.push((v) => v.setDisabledElements(next.disabledElements ?? []));\n    if (next.theme !== undefined && next.theme !== prev.theme) calls.push((v) => v.setTheme(next.theme ?? \"system\"));\n    if (next.author !== undefined && next.author !== prev.author) calls.push((v) => v.setAuthor(next.author ?? \"\"));\n    if (next.locale !== undefined && next.locale !== prev.locale) calls.push((v) => v.setLocale(next.locale ?? \"en\"));\n    if (next.document && !sameDocument(next.document, prev.document)) {\n      const doc = next.document;\n      calls.push((v) => v.load(doc, next.password === undefined ? undefined : { password: next.password }));\n    }\n    if (calls.length === 0) return;\n    const generation = this.generation;\n    this.queue = this.queue\n      .then(() => this.ready)\n      .then(async (v) => {\n        // Each call on its own: one refused call (a bad locale) must not drop the rest (the load).\n        for (const call of calls) {\n          if (generation !== this.generation || this.destroyed) return;\n          try {\n            await call(v);\n          } catch (e) {\n            if (generation !== this.generation || this.destroyed) return;\n            const err = e instanceof FreePdfError ? e : new FreePdfError(\"INTERNAL\", String(e));\n            if (err.code !== \"DESTROYED\") this.sink(\"error\", { code: err.code, message: err.message });\n          }\n        }\n      })\n      .catch(() => undefined);\n  }\n\n  /** Removes the viewer. Safe to call twice. */\n  async destroy(): Promise<void> {\n    if (this.destroyed) return;\n    this.destroyed = true;\n    this.generation++;\n    const v = this.viewer;\n    this.viewer = null;\n    // A start still under way: take its iframe away now (it is destroyed when init settles).\n    this.starting?.remove();\n    this.starting = null;\n    if (v) await v.destroy();\n    else await this.ready.then((late) => late.destroy()).catch(() => undefined);\n  }\n}\n"]}