@rightkit/document-core 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.2.0 (unpublished)
+
+Shape review 2026-11-11 (`docs/audits/2026-11-11-shape-matrix/reports/family-documents.md`; design in `reports/documents-redraw-design.md`). Taken on the recommended option, pending the owner's confirmation.
+
+The review judged this package the wrong shape: a catch-all holding ViewRight's whole PDF editor, its settings sections and workspace-only hooks beside the editor base, with five separate product-name stores across the document packages and names fixed to one app's prefix. It is dissolved as a catch-all: every part with an owner moved to it. What stays is the editor base that `@rightkit/html-editor`, `@rightkit/markdown-editor`, `@rightkit/docx-editor` and `@rightkit/document-workspace` all import; it cannot live in the workspace (the workspace imports the editors, so the editors importing the workspace would be a cycle), so it is not a re-export shim.
+
+Moved out (breaking: the subpaths are gone from this package):
+- To `@rightkit/document-workspace`: the PDF editor, `documents/pdf/*` (viewer, toolbar, thumbnails, outline, OCR, inline text editing, save plan, macOS native read pane, benchmark harness); the PDF-editor native commands of `state/tauriBridge` (`ocrPage`, `ocrAvailable`, `ocrBackendMissing`, `inspectPdfPage`, `listPdfFonts`, `composePdfPreview`, `preparePdfSave`, `commitPdfSave`, now `documents/pdf/pdfBridge`); `printPdf` and `printPdfDocument` of `app/documentPrinting` (now `documents/pdf/pdfPrinting`); `settings/sections/*` and `settings/rk-settings.css`; `app/useCloseFindOnSurfaceChange`, `app/useEditText`, `documents/FullscreenIcon`, `documents/txt/cmScroll`, `documents/useMirroredEditText`, `documents/useSplitResize`.
+- To `@rightkit/html-editor`: `app/shortcutChords`.
+- To `@rightkit/markdown-editor`: `documents/scopedSelectAll`, `documents/mdx/mdxRuntimeScript` (and its `.txt`).
+- `styles.css` no longer imports pdf.js's `pdf_viewer.css` (the workspace's does). Dependencies `pdfjs-dist` and `@codemirror/view` removed.
+
+Added:
+- `host` (also on the root): `configureDocumentHost({ appName?, id? })`, the one host-identity store for every document package, read at use time. `hostAppName`, `setHostAppName` (now a shorthand), `hostId`, `documentEvent(name)` = `<id>:<name>`, `hostScheme(suffix)` = `<id>-<suffix>`, `hostHeader(suffix)` = `x-<id>-<suffix>`, `hostStorageKey(key)` = `<id>:<key>`, `hostQaGlobal(name)` = `__<camelId><Name>`. Default `id` is `"rk-document"`; a host whose native side uses `viewright:*` events and `viewright-*` schemes passes `id: "viewright"` and every name is as before.
+- `state/tauriBridge` exports `byteArrayToBase64` (used by the PDF bridge).
+
+Changed (breaking):
+- `appName` module removed; import `hostAppName`/`setHostAppName` from the root or `host`.
+- Names shared with the host's native side now come from `id`: the stream scheme (`<id>-stream`, was `viewright-stream`), the `write_document_base64` path header (`x-<id>-path-hex`), the native menu event (`menuCommandEvent()` replaces the constant `MENU_COMMAND_EVENT`), the Markdown format event (`markdownFormatEvent()` replaces `MARKDOWN_FORMAT_EVENT`), the Tauri events `<id>:open-url` (`onAppEvent("open-url")`, was `onAppEvent("viewright:open-url")`) and `<id>:context-*`, the preview scheme (`previewScheme()` replaces the constant `PREVIEW_SCHEME`), the recent-URL storage key `<id>:recent-urls` and the QA global `__<camelId>QaPerf`.
+- The find-highlight style element id is `rk-document-search-highlight-styles` (was `viewright-search-highlight-styles`).
+
+Not changed here, recorded for a later step: the theme ids `viewright-paper` and `viewright-night` and the settings key `vr.settings.v1` are stored user data, so renaming them needs a migration; the bridge still calls fixed native command names (the paired Rust command set in `rightkit-document-workspace` is the report's step 3).
+
+## 0.1.2 (unpublished)
+
+- Removed (breaking, Adrian, 2026-11-03: "no dummy data, no fucking made up shit. real data."): the browser-QA fixture layer. `BROWSER_QA_BUILD`, `isBrowserQaMode()`, `qaReloadPdfBytes()`, every fixture branch of `state/tauriBridge` and the `state/browserQa`, `browserQaText`, `browserQaDocx` and `browserQaPdf` modules (and their `index` exports) are gone. Outside the Tauri webview the bridge keeps its plain no-op returns.
+- Removed (breaking, Adrian, 2026-11-03: no dummy data): the in-memory browser-QA licence client. `browserQaLicenseClient()` is gone from `state/tauriBridge`, `state/browserQaLicense` is deleted, and the `@rightkit/license` dependency with it (`@rightkit/license/testing` no longer exists).
+- `@rightkit/license` is a dependency again: the settings sections `document-core` exports come from `@rightkit/settings-ui`, whose `sections` entry imports its peer `@rightkit/license`; without it an installed `document-core` failed to import.
+
 ## 0.1.1
 
 - Ask 1: the host bridge (`state/tauriBridge`), diagnostics (`state/diagnostics`) and platform modules are the single copy the document editors import. Hosts delete their own copies. Host-facing changes a host must adopt:

package/README.md

@@ -1,11 +1,11 @@
 # @rightkit/document-core
 
-Shared base for the document editors: platform bridge, settings, state, PDF helpers and the format registry.
+Shared base for the document editors and the document workspace: document types and the format registry, the host bridge, drafts, diagnostics, settings store, find, print and toolbar primitives, and the one host-identity store.
 
 | Item | Value |
 |---|---|
 | Where it runs | App webview UI (React) |
-| Version | 0.1.0 |
+| Version | 0.2.0 |
 | License | MIT OR Apache-2.0 |
 
 ## Entry points
@@ -20,11 +20,35 @@ Shared base for the document editors: platform bridge, settings, state, PDF help
 
 `react`, `react-dom`
 
-## Product name
+## Host identity
 
-User-facing copy reads the product name from `hostAppName()` (default `"App"`). Call
-`setHostAppName("Your App")` (exported from the root and from `appName`) once at startup, before
-rendering.
+One store for every document package (`@rightkit/document-core/host`, also on the root). Call it once
+at startup, before rendering; values are read where they are used, never at module load:
+
+```ts
+configureDocumentHost({ appName: "Your App", id: "yourapp" });
+```
+
+- `appName` (default `"App"`): product name in user-facing copy. `hostAppName()` reads it;
+  `setHostAppName(name)` is the same as passing only `appName`. The editors' and the workspace's
+  `appName` modules re-export this store.
+- `id` (default `"rk-document"`): the prefix of every name shared with the host's native side or
+  between the document packages: events `<id>:<name>` (`documentEvent`), schemes `<id>-stream`,
+  `<id>-site`, `<id>-preview` (`hostScheme`), the raw-body path header `x-<id>-path-hex`
+  (`hostHeader`), storage keys `<id>:<key>` (`hostStorageKey`) and QA globals `__<camelId><Name>`
+  (`hostQaGlobal`). A host whose native side already uses its own prefix passes it here.
+
+Not host-derived (fixed, with a later neutral rename recorded in the CHANGELOG): the theme ids
+`viewright-paper` and `viewright-night` (stored in user settings) and the settings document key
+`vr.settings.v1`.
+
+## What moved out in 0.2.0
+
+The PDF editor (`documents/pdf/*`, its native commands from `state/tauriBridge` and the PDF print
+path), the settings sections and their stylesheet, and the hooks only the workspace used moved to
+`@rightkit/document-workspace`; `app/shortcutChords` moved to `@rightkit/html-editor`;
+`documents/scopedSelectAll` and `documents/mdx/mdxRuntimeScript` moved to `@rightkit/markdown-editor`.
+See the CHANGELOG for the full list.
 
 ## Host contract
 
@@ -38,4 +62,4 @@ pnpm --dir packages/document-core test
 ```
 
 Modules left out of the root barrel because an export name collides with an earlier module
-(import them by subpath): `documents/pdf/macPdfNativeBridge.ts`, `documents/pdf/pdfPrinting.ts`, `documents/previewViewport.tsx`, `state/tauriBridge.ts`
+(import them by subpath): `documents/previewViewport.tsx`, `state/tauriBridge.ts`

package/dist/app/chrome.js

@@ -9,7 +9,7 @@ function looksLikeLocalPath(input) {
         /^\/[^/]/.test(input));
 }
 import { ActionDialog, Button, IconButton, Input } from "@rightkit/react-shell/react";
-import { hostAppName } from "../appName.js";
+import { hostAppName } from "../host.js";
 // Presentational shell chrome for App: confirmation dialogs and the Open-URL dialog. Pure leaf
 // components — no app state, no file semantics. Extracted from App.tsx so the shell composition
 // stays readable. (The Start page moved to src/app/shell/StartPage.tsx in Wave 3.)

package/dist/app/documentPrinting.d.ts

@@ -16,12 +16,6 @@ export declare function printDocumentContent(input: PrintDocumentInput): Promise
  * document lets those selectors restyle the app behind macOS's print sheet. A shadow root keeps
  * both the document's authored CSS and print color settings inside this print-only subtree. */
 export declare function printIsolatedHtmlMarkup(markup: string): Promise<boolean>;
-/** Print the PDF a viewer pane already has open, WITHOUT re-fetching it. See
- *  src/documents/pdf/pdfPrinting.ts. */
-export declare function printPdfDocument(doc: Parameters<typeof import("../documents/pdf/pdfPrinting.js").printPdfDocument>[0]): Promise<boolean>;
-/** Fallback PDF print path for when no viewer pane is registered: fetch the bytes from the stream URL
- *  and rasterize them. See src/documents/pdf/pdfPrinting.ts. */
-export declare function printPdf(assetUrl: string): Promise<boolean>;
 /** Print a fully-baked image data: URI (crop/filters/text layers already rendered to a single canvas
  *  by exportNativeImageEdit — the same pipeline Save/Save As uses). Deliberately NOT the on-screen
  *  stage: that `<img>` loads through Tauri's custom asset:// scheme, which the native print

package/dist/app/documentPrinting.js

@@ -159,24 +159,6 @@ export async function printIsolatedHtmlMarkup(markup) {
       ${markup}`;
     });
 }
-/** Lazy bridge to the PDF print path. The pdf.js-dependent rasterizer lives in
- *  src/documents/pdf/pdfPrinting.ts so the shell's entry chunk never pays for it; this module keeps
- *  only the non-PDF printing helpers. The dynamic import resolves the SAME module the on-screen PDF
- *  viewer already loaded (it shares the one worker-src setup), so the worker URL is never resolved
- *  through a fresh chunk. See pdfPrinting.ts for the silent-hang trap this shape exists to avoid. */
-async function lazyPdfPrinting() {
-    return import("../documents/pdf/pdfPrinting.js");
-}
-/** Print the PDF a viewer pane already has open, WITHOUT re-fetching it. See
- *  src/documents/pdf/pdfPrinting.ts. */
-export async function printPdfDocument(doc) {
-    return lazyPdfPrinting().then((m) => m.printPdfDocument(doc));
-}
-/** Fallback PDF print path for when no viewer pane is registered: fetch the bytes from the stream URL
- *  and rasterize them. See src/documents/pdf/pdfPrinting.ts. */
-export async function printPdf(assetUrl) {
-    return lazyPdfPrinting().then((m) => m.printPdf(assetUrl));
-}
 /** Print a fully-baked image data: URI (crop/filters/text layers already rendered to a single canvas
  *  by exportNativeImageEdit — the same pipeline Save/Save As uses). Deliberately NOT the on-screen
  *  stage: that `<img>` loads through Tauri's custom asset:// scheme, which the native print

package/dist/app/shell/nativeMenu.d.ts

@@ -3,10 +3,11 @@ export interface NativeMenuCommand {
     run: () => void;
     checked?: boolean;
 }
-export declare const MENU_COMMAND_EVENT = "viewright:menu-command";
+/** Window event the native menu fires with the command id: `<host id>:menu-command`. */
+export declare const menuCommandEvent: () => string;
 /** Menu-bar formatting commands for the active Markdown editor (event detail = command id).
  *  Lives here (not in documents/markdown/) because the dispatcher is format-agnostic app chrome —
  *  keeping it in the markdown tree would pull a markdown module into every format's closure. */
-export declare const MARKDOWN_FORMAT_EVENT = "viewright:markdown-format";
+export declare const markdownFormatEvent: () => string;
 export declare function nativeMenuActive(): boolean;
 export declare function useNativeDocumentMenu(commands: NativeMenuCommand[] | null): void;

package/dist/app/shell/nativeMenu.js

@@ -1,16 +1,18 @@
 // macOS native menu bridge. The document's File/View/Format/Insert commands live in the system
 // menu bar on Mac instead of in-window menus. Rust builds the menu once (every item disabled);
 // this hook tells it which `vr-cmd:` items apply to the active document (and which are checked),
-// and runs the matching command when the menu fires `viewright:menu-command`.
+// and runs the matching command when the menu fires `<host id>:menu-command` (`documentEvent`).
 import { invoke } from "@tauri-apps/api/core";
 import { useEffect, useRef } from "react";
 import { isMac } from "../../platform.js";
 import { inTauri } from "../../state/tauriBridge.js";
-export const MENU_COMMAND_EVENT = "viewright:menu-command";
+import { documentEvent } from "../../host.js";
+/** Window event the native menu fires with the command id: `<host id>:menu-command`. */
+export const menuCommandEvent = () => documentEvent("menu-command");
 /** Menu-bar formatting commands for the active Markdown editor (event detail = command id).
  *  Lives here (not in documents/markdown/) because the dispatcher is format-agnostic app chrome —
  *  keeping it in the markdown tree would pull a markdown module into every format's closure. */
-export const MARKDOWN_FORMAT_EVENT = "viewright:markdown-format";
+export const markdownFormatEvent = () => documentEvent("markdown-format");
 export function nativeMenuActive() {
     return isMac() && inTauri();
 }
@@ -24,8 +26,9 @@ export function useNativeDocumentMenu(commands) {
             const id = event.detail;
             latest.current?.find((command) => command.id === id)?.run();
         };
-        window.addEventListener(MENU_COMMAND_EVENT, onCommand);
-        return () => window.removeEventListener(MENU_COMMAND_EVENT, onCommand);
+        const name = menuCommandEvent();
+        window.addEventListener(name, onCommand);
+        return () => window.removeEventListener(name, onCommand);
     }, [commands]);
     const enabled = commands?.map((command) => command.id) ?? [];
     const checked = commands?.filter((command) => command.checked).map((command) => command.id) ?? [];

package/dist/documents/perfEventCounters.d.ts

@@ -44,13 +44,5 @@ export interface PerfQaFamily {
     read(): unknown;
     reset(): void;
 }
-declare global {
-    interface Window {
-        __viewrightQaPerf?: {
-            read(): Record<string, unknown>;
-            reset(): void;
-        };
-    }
-}
 /** Adds a named counter family (for example the Markdown resource lifecycle) to the QA readout. */
 export declare function exposePerfFamilyForQa(name: string, family: PerfQaFamily): void;

package/dist/documents/perfEventCounters.js

@@ -14,6 +14,7 @@
  * Cancel. Cache misses increment parse/projection counters;
  * cache hits are free.
  */
+import { hostQaGlobal } from "../host.js";
 const counters = {
     sourceWrites: 0,
     parseCount: 0,
@@ -64,7 +65,7 @@ function qaReadoutEnabled() {
 function installQaReadout() {
     if (!qaReadoutEnabled())
         return;
-    window.__viewrightQaPerf = {
+    window[hostQaGlobal("QaPerf")] = {
         read: () => ({
             perf: getPerfCounters(),
             ...Object.fromEntries([...qaFamilies].map(([name, family]) => [name, family.read()])),

package/dist/documents/preview/previewFrame.d.ts

@@ -1,6 +1,7 @@
 import { type PreviewHandle } from "@rightkit/tauri-shell";
 export type PreviewKind = "mdx" | "interactive";
-export declare const PREVIEW_SCHEME = "viewright-preview";
+/** The host's preview scheme, `<host id>-preview` (`hostScheme`). */
+export declare const previewScheme: () => string;
 export { isTauri as inTauriWebview } from "@rightkit/platform-ui";
 export declare function registerPreview(kind: PreviewKind, html: string): Promise<PreviewHandle>;
 export declare function revokePreview(token: string): Promise<void>;

package/dist/documents/preview/previewFrame.js

@@ -1,15 +1,17 @@
-// Frame-source construction for documents served from the `viewright-preview` custom protocol
-// (the shell's preview store, configured in src-tauri/src/preview_protocol.rs). The protocol is
+// Frame-source construction for documents served from the host's `<host id>-preview` custom
+// protocol (the shell's preview store). The protocol is
 // registered by the Rust side; this file talks to the shell's register/revoke commands and takes the
 // iframe `src` from the URL the host builds. Content is keyed by an unguessable token, never by
 // file path.
 import { PREVIEW_COMMANDS } from "@rightkit/tauri-shell";
-export const PREVIEW_SCHEME = "viewright-preview";
-/** The origin a registered token is served from: `viewright-preview://localhost/<token>` on
- *  macOS/Linux, `http://viewright-preview.localhost/<token>` on Windows/WebView2. */
+import { hostScheme } from "../../host.js";
+/** The host's preview scheme, `<host id>-preview` (`hostScheme`). */
+export const previewScheme = () => hostScheme("preview");
+/** The origin a registered token is served from: `<scheme>://localhost/<token>` on
+ *  macOS/Linux, `http://<scheme>.localhost/<token>` on Windows/WebView2. */
 function isPreviewUrl(url, token) {
-    return (url === `${PREVIEW_SCHEME}://localhost/${token}` ||
-        url === `http://${PREVIEW_SCHEME}.localhost/${token}`);
+    const scheme = previewScheme();
+    return url === `${scheme}://localhost/${token}` || url === `http://${scheme}.localhost/${token}`;
 }
 export { isTauri as inTauriWebview } from "@rightkit/platform-ui";
 export async function registerPreview(kind, html) {

package/dist/documents/searchUtils.js

@@ -5,7 +5,7 @@ import { findLiteralMatches as findPlainMatches, findRegexMatches, regexPatternE
 export function isValidSearchRegex(pattern) {
     return regexPatternError(pattern) === null;
 }
-const SEARCH_HIGHLIGHT_STYLE_ID = "viewright-search-highlight-styles";
+const SEARCH_HIGHLIGHT_STYLE_ID = "rk-document-search-highlight-styles";
 function ensureSearchHighlightStyles(win) {
     const doc = win.document;
     if (doc.getElementById(SEARCH_HIGHLIGHT_STYLE_ID))

package/dist/host.d.ts

@@ -0,0 +1,36 @@
+export interface DocumentHostConfig {
+    /** Product name in user-facing copy (legal gate, settings, errors). Default `"App"`. */
+    appName?: string;
+    /**
+     * The host's native identifier. Every name the document packages share with the host's native
+     * side or with each other is derived from it:
+     *
+     * - window and Tauri event names: `<id>:<event>` (`documentEvent`);
+     * - custom URL schemes: `<id>-<suffix>`, e.g. `<id>-stream`, `<id>-site`, `<id>-preview` (`hostScheme`);
+     * - the raw-body path header: `x-<id>-path-hex` (`hostHeader`);
+     * - storage keys: `<id>:<key>` (`hostStorageKey`);
+     * - QA globals on `window`: `__<camelCaseId><Name>` (`hostQaGlobal`).
+     *
+     * Lower case letters, digits and single hyphens, starting with a letter. Default `"rk-document"`.
+     * A host whose native side already uses names with its own prefix passes that prefix here.
+     */
+    id?: string;
+}
+/** Set the host identity once at startup, before the first render. Absent fields keep their value. */
+export declare function configureDocumentHost(config: DocumentHostConfig): void;
+/** Product name for user-facing copy. Read it where the copy is built, not at module load. */
+export declare function hostAppName(): string;
+/** Same as `configureDocumentHost({ appName: name })`. */
+export declare function setHostAppName(name: string): void;
+/** The host's native identifier (see `DocumentHostConfig.id`). */
+export declare function hostId(): string;
+/** Name of a window or Tauri event shared by the document packages and the host: `<id>:<name>`. */
+export declare function documentEvent(name: string): string;
+/** Name of a host custom URL scheme: `<id>-<suffix>`. */
+export declare function hostScheme(suffix: string): string;
+/** Name of a host request header: `x-<id>-<suffix>`. */
+export declare function hostHeader(suffix: string): string;
+/** Key in web storage owned by the document packages: `<id>:<key>`. */
+export declare function hostStorageKey(key: string): string;
+/** Name of a QA global on `window`: `__<camelCaseId><Name>`. */
+export declare function hostQaGlobal(name: string): string;

package/dist/host.js

@@ -0,0 +1,54 @@
+// Host identity for every document package. One store, read at use time (never at module load), so
+// a host's `configureDocumentHost()` call at startup reaches every module that was already imported.
+// Before 0.2.0 each of the five document packages kept its own `appName` store, and the names the
+// packages share with the host's native side (window and Tauri event names, the binary stream
+// scheme, the path header, QA globals, storage keys) were fixed to one app's prefix.
+const ID_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+let appName = "App";
+let id = "rk-document";
+/** Set the host identity once at startup, before the first render. Absent fields keep their value. */
+export function configureDocumentHost(config) {
+    if (config.appName !== undefined) {
+        if (!config.appName.trim())
+            throw new Error("configureDocumentHost: appName must not be empty");
+        appName = config.appName;
+    }
+    if (config.id !== undefined) {
+        if (!ID_PATTERN.test(config.id))
+            throw new Error(`configureDocumentHost: invalid id ${JSON.stringify(config.id)}`);
+        id = config.id;
+    }
+}
+/** Product name for user-facing copy. Read it where the copy is built, not at module load. */
+export function hostAppName() {
+    return appName;
+}
+/** Same as `configureDocumentHost({ appName: name })`. */
+export function setHostAppName(name) {
+    configureDocumentHost({ appName: name });
+}
+/** The host's native identifier (see `DocumentHostConfig.id`). */
+export function hostId() {
+    return id;
+}
+/** Name of a window or Tauri event shared by the document packages and the host: `<id>:<name>`. */
+export function documentEvent(name) {
+    return `${id}:${name}`;
+}
+/** Name of a host custom URL scheme: `<id>-<suffix>`. */
+export function hostScheme(suffix) {
+    return `${id}-${suffix}`;
+}
+/** Name of a host request header: `x-<id>-<suffix>`. */
+export function hostHeader(suffix) {
+    return `x-${id}-${suffix}`;
+}
+/** Key in web storage owned by the document packages: `<id>:<key>`. */
+export function hostStorageKey(key) {
+    return `${id}:${key}`;
+}
+/** Name of a QA global on `window`: `__<camelCaseId><Name>`. */
+export function hostQaGlobal(name) {
+    const camel = id.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
+    return `__${camel}${name}`;
+}

package/dist/index.d.ts

@@ -9,79 +9,30 @@ export * from "./app/printPipelineShared.js";
 export * from "./app/resourceCensus.js";
 export * from "./app/shell/docBar.js";
 export * from "./app/shell/nativeMenu.js";
-export * from "./app/shortcutChords.js";
-export * from "./app/useCloseFindOnSurfaceChange.js";
-export * from "./app/useEditText.js";
-export * from "./appName.js";
 export * from "./documents/BackToTopButton.js";
 export * from "./documents/ChromeButton.js";
 export * from "./documents/DocumentToolbarFind.js";
 export * from "./documents/DocumentToolbarShell.js";
-export * from "./documents/FullscreenIcon.js";
 export * from "./documents/PreviewChrome.js";
 export * from "./documents/PreviewMessage.js";
 export * from "./documents/base64.js";
 export * from "./documents/documentFormats.js";
-export * from "./documents/pdf/MacPdfReadPane.js";
-export * from "./documents/pdf/NativePdfDocument.js";
-export * from "./documents/pdf/PdfInlineTextEditor.js";
-export * from "./documents/pdf/PdfOcrLayer.js";
-export * from "./documents/pdf/PdfOutline.js";
-export * from "./documents/pdf/PdfPasswordPrompt.js";
-export * from "./documents/pdf/PdfThumbnails.js";
-export * from "./documents/pdf/PdfToolbar.js";
-export * from "./documents/pdf/PdfViewer.js";
-export * from "./documents/pdf/PdfViewerBody.js";
-export * from "./documents/pdf/nearestVisiblePdfPage.js";
-export * from "./documents/pdf/pdfBench.js";
-export * from "./documents/pdf/pdfBenchAutopilot.js";
-export * from "./documents/pdf/pdfBenchTransport.js";
-export * from "./documents/pdf/pdfEditModel.js";
-export * from "./documents/pdf/pdfEditor.js";
-export * from "./documents/pdf/pdfOcr.js";
-export * from "./documents/pdf/pdfOcrEdit.js";
-export * from "./documents/pdf/pdfSave.js";
-export * from "./documents/pdf/pdfShared.js";
-export * from "./documents/pdf/pdfToMarkdown.js";
-export * from "./documents/pdf/toolbarIcons.js";
-export * from "./documents/pdf/usePdfDocumentLoader.js";
-export * from "./documents/pdf/usePdfEditSession.js";
-export * from "./documents/pdf/usePdfEditor.js";
-export * from "./documents/pdf/usePdfFit.js";
-export * from "./documents/pdf/usePdfOcr.js";
-export * from "./documents/pdf/usePdfPreviewRecompose.js";
-export * from "./documents/pdf/usePdfSavePlan.js";
-export * from "./documents/pdf/usePdfSearch.js";
-export * from "./documents/pdf/usePdfViewControls.js";
 export * from "./documents/perfEventCounters.js";
 export * from "./documents/preview/previewFrame.js";
 export * from "./documents/preview/usePreviewFrameSrc.js";
-export * from "./documents/scopedSelectAll.js";
 export * from "./documents/searchUtils.js";
 export * from "./documents/splitResizeMath.js";
 export * from "./documents/toolbarPrimitives.js";
-export * from "./documents/txt/cmScroll.js";
 export * from "./documents/types.js";
-export * from "./documents/useMirroredEditText.js";
 export * from "./documents/usePreviewFind.js";
-export * from "./documents/useSplitResize.js";
 export * from "./documents/web/webUrl.js";
+export * from "./host.js";
 export * from "./platform.js";
 export * from "./settings/fonts.js";
-export * from "./settings/sections/EditorSection.js";
-export * from "./settings/sections/FileAssociationsSection.js";
-export * from "./settings/sections/MacFileAssociationsBlock.js";
-export * from "./settings/sections/ThemeSection.js";
-export * from "./settings/sections/TypographySection.js";
-export * from "./settings/sections/onOff.js";
 export * from "./settings/settings.js";
 export * from "./settings/settingsBackend.js";
 export * from "./settings/themes.js";
 export * from "./state/bridgeEvents.js";
-export * from "./state/browserQa.js";
-export * from "./state/browserQaDocx.js";
-export * from "./state/browserQaPdf.js";
-export * from "./state/browserQaText.js";
 export * from "./state/diagnostics.js";
 export * from "./state/errors.js";
 export * from "./state/motion.js";

package/dist/index.js

@@ -11,79 +11,30 @@ export * from "./app/printPipelineShared.js";
 export * from "./app/resourceCensus.js";
 export * from "./app/shell/docBar.js";
 export * from "./app/shell/nativeMenu.js";
-export * from "./app/shortcutChords.js";
-export * from "./app/useCloseFindOnSurfaceChange.js";
-export * from "./app/useEditText.js";
-export * from "./appName.js";
 export * from "./documents/BackToTopButton.js";
 export * from "./documents/ChromeButton.js";
 export * from "./documents/DocumentToolbarFind.js";
 export * from "./documents/DocumentToolbarShell.js";
-export * from "./documents/FullscreenIcon.js";
 export * from "./documents/PreviewChrome.js";
 export * from "./documents/PreviewMessage.js";
 export * from "./documents/base64.js";
 export * from "./documents/documentFormats.js";
-export * from "./documents/pdf/MacPdfReadPane.js";
-export * from "./documents/pdf/NativePdfDocument.js";
-export * from "./documents/pdf/PdfInlineTextEditor.js";
-export * from "./documents/pdf/PdfOcrLayer.js";
-export * from "./documents/pdf/PdfOutline.js";
-export * from "./documents/pdf/PdfPasswordPrompt.js";
-export * from "./documents/pdf/PdfThumbnails.js";
-export * from "./documents/pdf/PdfToolbar.js";
-export * from "./documents/pdf/PdfViewer.js";
-export * from "./documents/pdf/PdfViewerBody.js";
-export * from "./documents/pdf/nearestVisiblePdfPage.js";
-export * from "./documents/pdf/pdfBench.js";
-export * from "./documents/pdf/pdfBenchAutopilot.js";
-export * from "./documents/pdf/pdfBenchTransport.js";
-export * from "./documents/pdf/pdfEditModel.js";
-export * from "./documents/pdf/pdfEditor.js";
-export * from "./documents/pdf/pdfOcr.js";
-export * from "./documents/pdf/pdfOcrEdit.js";
-export * from "./documents/pdf/pdfSave.js";
-export * from "./documents/pdf/pdfShared.js";
-export * from "./documents/pdf/pdfToMarkdown.js";
-export * from "./documents/pdf/toolbarIcons.js";
-export * from "./documents/pdf/usePdfDocumentLoader.js";
-export * from "./documents/pdf/usePdfEditSession.js";
-export * from "./documents/pdf/usePdfEditor.js";
-export * from "./documents/pdf/usePdfFit.js";
-export * from "./documents/pdf/usePdfOcr.js";
-export * from "./documents/pdf/usePdfPreviewRecompose.js";
-export * from "./documents/pdf/usePdfSavePlan.js";
-export * from "./documents/pdf/usePdfSearch.js";
-export * from "./documents/pdf/usePdfViewControls.js";
 export * from "./documents/perfEventCounters.js";
 export * from "./documents/preview/previewFrame.js";
 export * from "./documents/preview/usePreviewFrameSrc.js";
-export * from "./documents/scopedSelectAll.js";
 export * from "./documents/searchUtils.js";
 export * from "./documents/splitResizeMath.js";
 export * from "./documents/toolbarPrimitives.js";
-export * from "./documents/txt/cmScroll.js";
 export * from "./documents/types.js";
-export * from "./documents/useMirroredEditText.js";
 export * from "./documents/usePreviewFind.js";
-export * from "./documents/useSplitResize.js";
 export * from "./documents/web/webUrl.js";
+export * from "./host.js";
 export * from "./platform.js";
 export * from "./settings/fonts.js";
-export * from "./settings/sections/EditorSection.js";
-export * from "./settings/sections/FileAssociationsSection.js";
-export * from "./settings/sections/MacFileAssociationsBlock.js";
-export * from "./settings/sections/ThemeSection.js";
-export * from "./settings/sections/TypographySection.js";
-export * from "./settings/sections/onOff.js";
 export * from "./settings/settings.js";
 export * from "./settings/settingsBackend.js";
 export * from "./settings/themes.js";
 export * from "./state/bridgeEvents.js";
-export * from "./state/browserQa.js";
-export * from "./state/browserQaDocx.js";
-export * from "./state/browserQaPdf.js";
-export * from "./state/browserQaText.js";
 export * from "./state/diagnostics.js";
 export * from "./state/errors.js";
 export * from "./state/motion.js";

package/dist/settings/themes.js

@@ -1,4 +1,4 @@
-import { hostAppName } from "../appName.js";
+import { hostAppName } from "../host.js";
 export const THEMES = [
     {
         id: "viewright-paper",

package/dist/state/bridgeEvents.d.ts

@@ -1,5 +1,5 @@
 export type Unlisten = () => void | Promise<void>;
-export declare function onAppEvent(event: "open-file" | "file-changed" | "viewright:open-url" | "prepare-setup", cb: (path: string) => void): Promise<Unlisten>;
+export declare function onAppEvent(event: "open-file" | "file-changed" | "open-url" | "prepare-setup", cb: (path: string) => void): Promise<Unlisten>;
 export declare function onContextViewSource(cb: () => void): Promise<Unlisten>;
 export declare function onContextOpenLinkTab(cb: () => void): Promise<Unlisten>;
 export declare function onContextOpenLinkExternal(cb: () => void): Promise<Unlisten>;

package/dist/state/bridgeEvents.js

@@ -1,5 +1,6 @@
 import { isTauri as inTauri } from "@rightkit/platform-ui";
 import { EVENTS } from "@rightkit/tauri-shell";
+import { documentEvent } from "../host.js";
 export async function onAppEvent(event, cb) {
     if (!inTauri())
         return () => { };
@@ -12,27 +13,29 @@ export async function onAppEvent(event, cb) {
                 cb(path);
         });
     }
-    const un = await listen(event, (e) => cb(e.payload));
+    // `open-url` is the host's own event, `<host id>:open-url`; the others are shell events.
+    const name = event === "open-url" ? documentEvent("open-url") : event;
+    const un = await listen(name, (e) => cb(e.payload));
     return un;
 }
 export async function onContextViewSource(cb) {
     if (!inTauri())
         return () => { };
     const { listen } = await import("@tauri-apps/api/event");
-    const un = await listen("viewright:context-view-source", () => cb());
+    const un = await listen(documentEvent("context-view-source"), () => cb());
     return un;
 }
 export async function onContextOpenLinkTab(cb) {
     if (!inTauri())
         return () => { };
     const { listen } = await import("@tauri-apps/api/event");
-    const un = await listen("viewright:context-open-link-tab", () => cb());
+    const un = await listen(documentEvent("context-open-link-tab"), () => cb());
     return un;
 }
 export async function onContextOpenLinkExternal(cb) {
     if (!inTauri())
         return () => { };
     const { listen } = await import("@tauri-apps/api/event");
-    const un = await listen("viewright:context-open-link-external", () => cb());
+    const un = await listen(documentEvent("context-open-link-external"), () => cb());
     return un;
 }

package/dist/state/recentUrls.js

@@ -2,11 +2,12 @@
 // PathBroker-token + on-disk based and don't fit URLs) and shown in the Open-URL dialog so a dev can
 // re-pick a server without retyping. localStorage-backed → persists across sessions via WebView2's
 // user-data folder. Best-effort: any storage failure degrades to "no history", never throws.
-const KEY = "viewright:recent-urls";
+import { hostStorageKey } from "../host.js";
+const key = () => hostStorageKey("recent-urls");
 const MAX = 8;
 export function getRecentUrls() {
     try {
-        const raw = localStorage.getItem(KEY);
+        const raw = localStorage.getItem(key());
         const list = raw ? JSON.parse(raw) : [];
         return Array.isArray(list)
             ? list.filter((u) => typeof u === "string").slice(0, MAX)
@@ -22,7 +23,7 @@ export function addRecentUrl(url) {
         return;
     try {
         const next = [u, ...getRecentUrls().filter((existing) => existing !== u)].slice(0, MAX);
-        localStorage.setItem(KEY, JSON.stringify(next));
+        localStorage.setItem(key(), JSON.stringify(next));
     }
     catch {
         /* storage unavailable — recents are a convenience, not load-bearing */