@docmentis/udoc-editor 0.0.1 → 0.8.0

package/dist/edit-mode.js

@@ -0,0 +1,214 @@
+// Edit mode: the editor's extension of udoc-ui's shell.
+import { selectionPaint, selectionTextFormat, subscribeSelector } from "@docmentis/udoc-ui/internal";
+import { formatCommands } from "./commands.js";
+import { CONTEXT_MENU, TABLE_CONTEXT_MENU } from "./context-menu.js";
+import { createGrips } from "./grips.js";
+import { createModeSwitch } from "./components/ModeSwitch.js";
+import { createPaintOptionsModal } from "./components/PaintOptionsModal.js";
+import { EditClient } from "./edit-client.js";
+import { FORMATTING_MARKS_COMMAND, formattingMarksKey, mountFormattingMarks, setShowFormattingMarks, } from "./formatting-marks.js";
+import { createI18n, MESSAGE_PACKS } from "./i18n/index.js";
+import { insertCommands, insertImage, pickImage, place, placedShape } from "./insert.js";
+import { runEditMenuAction } from "./menu-action.js";
+import { mountNewSlide, newSlideCommand } from "./new-slide.js";
+import { mountPageControls, PAGE_CONTROLS_SPACING, pageControlsShown } from "./page-controls.js";
+import { ALL_MODES, EDIT_MODE } from "./mode.js";
+import { editState, INITIAL_EDIT_STATE, updateEditState } from "./state.js";
+import { RULER, rulerShown, setShowRuler } from "./ruler.js";
+import { editorStyles } from "./styles.js";
+import { editTabs } from "./tabs.js";
+import { createEditTools } from "./tools.js";
+/**
+ * Keep the document-derived parts of edit mode's state in step with the open
+ * document: the theme palette and font families pulled on open, the palette
+ * again per slide, both cleared while nothing is open, and the selection's
+ * resolved format mirrored from each selection report. Returns the teardown.
+ */
+function mountDocumentState(host) {
+    const { store, client, edit } = host;
+    // Pull the current slide's resolved theme palette from the engine (the color
+    // picker's "Theme Colors"; the color dropdowns map it to swatches). Null for
+    // doc types without a theme, which keeps the picker's stand-in.
+    const refreshThemePalette = async () => {
+        updateEditState(store, { themePalette: await edit.themePalette() });
+    };
+    // Pull the open document's available font families (the engine's font
+    // registry) — the Text tab's font picker lists them. Empty for a doc type
+    // with no text font registry (PDF/image). Per-document, so pulled once on
+    // open (unlike the theme palette, which re-pulls per slide), and the whole
+    // list is stable across the session, so it's cached from there.
+    const refreshFontFamilies = async () => {
+        updateEditState(store, { fontFamilies: await edit.fontFamilySummaries() });
+        updateEditState(store, { loadedFontFamilyNames: await edit.loadedFontFamilyNames() });
+    };
+    const unsubs = [
+        // A document opening or closing drops the last one's palette and fonts.
+        subscribeSelector(store, (s) => s.status, (status) => {
+            if (status === "loading" || status === "empty") {
+                updateEditState(store, { themePalette: null, fontFamilies: [], loadedFontFamilyNames: [] });
+            }
+        }),
+        // Each opened document: its palette and its font list — async, off the
+        // open's critical path.
+        subscribeSelector(store, (s) => s.docGeneration, () => {
+            void refreshThemePalette();
+            void refreshFontFamilies();
+        }),
+        // Re-pull the theme palette when the viewed slide changes: a
+        // multi-master deck (or a slide with a `clrMapOvr`) re-themes per slide,
+        // so the picker's "Theme Colors" must track the current slide.
+        // Presentations only — a word document carries one theme, pulled once
+        // at open; it never re-themes per page.
+        subscribeSelector(store, (s) => s.pageIndex, () => {
+            if (store.getState().docType === "presentation")
+                void refreshThemePalette();
+        }),
+        // Mirror the selection's resolved character format onto the Text tab,
+        // and its color per channel onto the Fill / Line / Text Color dropdowns
+        // — projected from the engine's selection properties, every report.
+        client.onSelection((state) => updateEditState(store, {
+            selectionText: selectionTextFormat(state.properties),
+            selectionPaint: selectionPaint(state.properties),
+        })),
+    ];
+    return () => {
+        for (const unsub of unsubs)
+            unsub();
+    };
+}
+/** Whether the engine draws edit mode's authoring view in `s`. */
+function editing(s) {
+    return s.mode === "edit";
+}
+/**
+ * Keep the engine drawing what only editing shows: objects that run off the
+ * page, and the prompts in empty placeholders. Both are sticky in the worker
+ * and start off, so pushed at once too. Returns the teardown.
+ */
+function mountEditingView(host) {
+    const { store, edit } = host;
+    const show = (on) => {
+        // Objects that run off the page show only while editing; the engine
+        // applies it only in single-page view (where a stray object has no
+        // neighbours to spill over), so the other modes — and continuous —
+        // read as a clean page.
+        edit.setOverflowVisible(on);
+        // Empty-placeholder prompts (dashed frame + "Click to add …") are an
+        // editing affordance, so a document opened for reading shows none.
+        // Only presentations draw prompts, so this is a no-op for other doc
+        // types.
+        edit.setPlaceholderPrompts(on);
+    };
+    show(editing(store.getState()));
+    return subscribeSelector(store, editing, show);
+}
+/** Edit mode, as `options` configure it. */
+export function editMode(options) {
+    const i18n = createI18n(options.locale, options.translations);
+    // The modes the host allows — every one unless it narrows them — and the
+    // one the editor opens in: the host's, if allowed, else the first allowed.
+    const allowedModes = options.allowedModes && options.allowedModes.length > 0 ? options.allowedModes : ALL_MODES;
+    const requestedMode = options.initialMode ?? "edit";
+    const initialMode = allowedModes.includes(requestedMode) ? requestedMode : allowedModes[0];
+    const showPageControls = options.showPageControls ?? true;
+    // What the shell lends, and what edit mode builds on it, from the mount on.
+    let host = null;
+    let tools = null;
+    let newSlide = null;
+    const grips = createGrips(() => tools);
+    const mountedTools = () => {
+        if (!tools)
+            throw new Error("udoc: edit mode is not mounted");
+        return tools;
+    };
+    return {
+        styles: editorStyles,
+        messages: MESSAGE_PACKS,
+        mode: EDIT_MODE,
+        initialMode,
+        initialState: {
+            ...INITIAL_EDIT_STATE,
+            showRuler: options.showRuler ?? INITIAL_EDIT_STATE.showRuler,
+            allowedModes,
+            showModeSwitch: options.showModeSwitch ?? allowedModes.length > 1,
+        },
+        tabs: editTabs,
+        commands: {
+            ...formatCommands(mountedTools),
+            formattingMarks: FORMATTING_MARKS_COMMAND,
+            createSlide: newSlideCommand(() => void newSlide?.open()),
+            ...insertCommands(() => {
+                if (host)
+                    pickImage(host);
+            }),
+        },
+        spacing: (state) => (showPageControls && pageControlsShown(state) ? PAGE_CONTROLS_SPACING : null),
+        keydown(e) {
+            if (host)
+                formattingMarksKey(e, host.store);
+        },
+        menuAction(action) {
+            if (tools)
+                runEditMenuAction(tools, action);
+        },
+        // Edit mode's acts on the selection, a table's rows added over one; view
+        // mode keeps the shell's.
+        contextMenuItems: (state, inTable) => (editing(state) ? (inTable ? TABLE_CONTEXT_MENU : CONTEXT_MENU) : null),
+        guideBand: (state) => (rulerShown(state) ? RULER : null),
+        placedShape,
+        selectionChrome: grips.chrome,
+        pressCanvas: (x, y, _ev, canvas) => grips.press(x, y, canvas),
+        canvasCursor: (x, y) => grips.cursor(x, y),
+        place: (tool, page, p0, p1) => (host ? place(host, tool, page, p0, p1) : Promise.resolve()),
+        mount(lent) {
+            // What the shell lends, with edit mode's own client over the worker.
+            const mounted = { ...lent, edit: new EditClient(lent.client) };
+            host = mounted;
+            tools = createEditTools(mounted, i18n);
+            const modeSwitch = createModeSwitch(i18n);
+            modeSwitch.mount(mounted.modeSlot, mounted.store);
+            const paintOptionsModal = createPaintOptionsModal(i18n);
+            paintOptionsModal.mount(mounted.root);
+            const unmountDocumentState = mountDocumentState(mounted);
+            const unmountEditingView = mountEditingView(mounted);
+            const unmountPageControls = showPageControls ? mountPageControls(mounted, i18n) : null;
+            const unmountFormattingMarks = mountFormattingMarks(mounted);
+            newSlide = mountNewSlide(mounted, i18n);
+            return () => {
+                newSlide?.destroy();
+                newSlide = null;
+                unmountFormattingMarks();
+                unmountPageControls?.();
+                unmountEditingView();
+                unmountDocumentState();
+                tools?.clipboard.destroy();
+                paintOptionsModal.destroy();
+                modeSwitch.destroy();
+                tools = null;
+                host = null;
+            };
+        },
+        setShowFormattingMarks(visible) {
+            if (host)
+                setShowFormattingMarks(host.store, visible);
+        },
+        setShowRuler(visible) {
+            if (host)
+                setShowRuler(host.store, visible);
+        },
+        currentMode() {
+            return (host?.store.getState().mode ?? initialMode);
+        },
+        setMode(mode) {
+            // Ignored outside the host's modes; the shell ignores one the
+            // session isn't entitled to.
+            if (host && editState(host.store.getState()).allowedModes.includes(mode)) {
+                host.store.dispatch({ type: "SET_MODE", mode });
+            }
+        },
+        insertImage(bytes, contentType) {
+            return host ? insertImage(host, bytes, contentType) : Promise.resolve();
+        },
+    };
+}
+//# sourceMappingURL=edit-mode.js.map

package/dist/edit-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-mode.js","sourceRoot":"","sources":["../src/edit-mode.ts"],"names":[],"mappings":"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"}

package/dist/editor.d.ts

@@ -0,0 +1,101 @@
+import { UDocBase } from "@docmentis/udoc-ui";
+import type { LocalCollaborationServiceOptions, UDocEvents, UDocOptions } from "@docmentis/udoc-ui";
+import type { Messages } from "./i18n/index.js";
+import type { EditorMode } from "./mode.js";
+/** Options for {@link UDocEditor.create}: the common ones, and edit mode's. Every field is optional; each says its default. */
+export interface UDocEditorOptions extends UDocOptions {
+    /** Strings that replace the built-in ones, by key — the host's own wording,
+     *  or a language the editor doesn't ship. Default none. */
+    translations?: Partial<Messages>;
+    /** The mode the editor opens in. Default `"edit"`. */
+    initialMode?: EditorMode;
+    /** The modes the user may switch between. Default every mode. */
+    allowedModes?: readonly EditorMode[];
+    /** Show the mode switcher. Default `true` when more than one mode is allowed. */
+    showModeSwitch?: boolean;
+    /** Show edit mode's per-page controls — the page-control rail
+     *  (`udoc:page-actions`) and the insert-between-pages affordance
+     *  (`udoc:page-insert`) — with the wider page spacing they sit in. Default
+     *  `true`; a host shipping its own page organizer sets `false`. */
+    showPageControls?: boolean;
+    /** Show the page ruler on paged documents. Default `true`;
+     *  {@link UDocEditor.setShowRuler} changes it. */
+    showRuler?: boolean;
+}
+/** The editor's event map: the common events, and edit mode's. Subscribe with {@link UDocEditor.on}. */
+export interface UDocEditorEvents extends UDocEvents {
+    /** Fires when the editor mode changes (via {@link UDocEditor.setMode} or the mode switcher). */
+    "mode:changed": {
+        mode: EditorMode;
+        previousMode: EditorMode;
+    };
+}
+/**
+ * The document editor — construct it with {@link UDocEditor.create} and drive
+ * it with `open` / `close` / `destroy`.
+ */
+export declare class UDocEditor extends UDocBase<UDocEditorEvents> {
+    #private;
+    /** This package's version, from its `package.json`. */
+    static readonly version: string;
+    private constructor();
+    /**
+     * Create an editor mounted into `container`. Spawns the render worker and loads
+     * the WASM (async), then mounts the UI. Rejects with an `unsupported`
+     * `UDocError` on runtimes without OffscreenCanvas-in-worker support.
+     */
+    static create(container: HTMLElement, options?: UDocEditorOptions): Promise<UDocEditor>;
+    /**
+     * Start a local collaboration service on the document in `bytes`, and
+     * resolve with its id — the page's own udoc server for one document, for
+     * editors in this page to {@link openLocal} and
+     * {@link joinLocalCollaboration}.
+     *
+     * Editors that each {@link open} the same bytes can't collaborate: a
+     * document's ids are minted as its parts load, so two editors that load
+     * them in a different order hold different ids for the same content. The
+     * service imports the document once, in a worker of its own, and keeps its
+     * udoc package, which every editor opening it shares; then it serves their
+     * collaboration, as udoc-server serves one for a document it keeps. It ends
+     * when the last editor joined to it leaves.
+     *
+     * Its session is started as an editor's is, under `options`: it rejects
+     * when the license refuses it.
+     */
+    static startLocalCollaborationService(bytes: Uint8Array, options?: LocalCollaborationServiceOptions): Promise<string>;
+    /**
+     * Insert the image file `bytes` as a picture on the current slide, centred
+     * and scaled down to fit, then selected — what the Insert tab's Image does
+     * with the file it asks for. `contentType` is the file's MIME type
+     * (`image/png`, …); an empty one is read from the bytes' own signature. One
+     * committing edit (one undo step). The image never enters the CRDT: it
+     * reaches a peer through {@link opaquePartsSince}. Rejects for a document
+     * that isn't a presentation, or bytes no codec reads.
+     */
+    insertImage(bytes: Uint8Array, contentType: string): Promise<void>;
+    /**
+     * Show or hide the page ruler on paged documents (PDF / DOCX / PPTX). A
+     * user preference; the ruler is additionally hidden automatically in
+     * `"view"` mode (a reading pose needs no measurement chrome). A spreadsheet's
+     * row/column headers are essential and never affected.
+     */
+    setShowRuler(visible: boolean): void;
+    /**
+     * Show or hide formatting marks — `¶` at each paragraph end, a dot in each
+     * space, an arrow in each tab, `↵` at each line break — on wordprocessing
+     * documents; the same toggle as the ribbon's button. A
+     * user preference, off by default; the marks are editing chrome, so they're
+     * additionally hidden outside `"edit"` mode.
+     */
+    setShowFormattingMarks(visible: boolean): void;
+    /** The current editor mode; `"mode:changed"` fires when it changes. */
+    get mode(): EditorMode;
+    /**
+     * Switch the editor mode. Ignored if `mode` isn't in the configured
+     * `allowedModes`. Drives the toolbar's command set and pointer behavior.
+     */
+    setMode(mode: EditorMode): void;
+    /** Tear down components, listeners, and the render worker. */
+    destroy(): void;
+}
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,gCAAgC,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKpG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAO5C,+HAA+H;AAC/H,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IAClD;+DAC2D;IAC3D,YAAY,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,sDAAsD;IACtD,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,iEAAiE;IACjE,YAAY,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACrC,iFAAiF;IACjF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;uEAGmE;IACnE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;sDACkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wGAAwG;AACxG,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAChD,gGAAgG;IAChG,cAAc,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,YAAY,EAAE,UAAU,CAAA;KAAE,CAAC;CAClE;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,QAAQ,CAAC,gBAAgB,CAAC;;IACtD,uDAAuD;IACvD,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAmB;IAKlD,OAAO;IAWP;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;IAY3F;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,8BAA8B,CACjC,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,gCAAqC,GAC/C,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;;;;OAQG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIpC;;;;;;OAMG;IACH,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI9C,uEAAuE;IACvE,IAAI,IAAI,IAAI,UAAU,CAErB;IAED;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAI/B,8DAA8D;IACrD,OAAO,IAAI,IAAI;CAI3B"}

package/dist/editor.js

@@ -0,0 +1,101 @@
+import { UDocBase } from "@docmentis/udoc-ui";
+import { createAs, startLocalCollaborationService, subscribeSelector } from "@docmentis/udoc-ui/internal";
+import { editMode } from "./edit-mode.js";
+import { WRAPPER_VERSION } from "./version.js";
+import { startRenderWorker } from "./worker/worker-source.js";
+/** This package, as the wrapper it reports to the engine. */
+const EDITOR_WRAPPER = { name: "udoc-editor", version: WRAPPER_VERSION };
+/**
+ * The document editor — construct it with {@link UDocEditor.create} and drive
+ * it with `open` / `close` / `destroy`.
+ */
+export class UDocEditor extends UDocBase {
+    /** This package's version, from its `package.json`. */
+    static version = WRAPPER_VERSION;
+    #unsubscribeMode;
+    #editMode;
+    constructor(shell, editMode) {
+        super(shell);
+        this.#editMode = editMode;
+        this.#unsubscribeMode = subscribeSelector(shell.store, 
+        // The shell's mode is view or edit mode's own.
+        (s) => s.mode, (mode, previousMode) => this.emit("mode:changed", { mode, previousMode }));
+    }
+    /**
+     * Create an editor mounted into `container`. Spawns the render worker and loads
+     * the WASM (async), then mounts the UI. Rejects with an `unsupported`
+     * `UDocError` on runtimes without OffscreenCanvas-in-worker support.
+     */
+    static create(container, options = {}) {
+        const mode = editMode(options);
+        return createAs(container, options, EDITOR_WRAPPER, startRenderWorker, mode, (shell) => new UDocEditor(shell, mode));
+    }
+    /**
+     * Start a local collaboration service on the document in `bytes`, and
+     * resolve with its id — the page's own udoc server for one document, for
+     * editors in this page to {@link openLocal} and
+     * {@link joinLocalCollaboration}.
+     *
+     * Editors that each {@link open} the same bytes can't collaborate: a
+     * document's ids are minted as its parts load, so two editors that load
+     * them in a different order hold different ids for the same content. The
+     * service imports the document once, in a worker of its own, and keeps its
+     * udoc package, which every editor opening it shares; then it serves their
+     * collaboration, as udoc-server serves one for a document it keeps. It ends
+     * when the last editor joined to it leaves.
+     *
+     * Its session is started as an editor's is, under `options`: it rejects
+     * when the license refuses it.
+     */
+    static startLocalCollaborationService(bytes, options = {}) {
+        return startLocalCollaborationService(bytes, options, EDITOR_WRAPPER);
+    }
+    /**
+     * Insert the image file `bytes` as a picture on the current slide, centred
+     * and scaled down to fit, then selected — what the Insert tab's Image does
+     * with the file it asks for. `contentType` is the file's MIME type
+     * (`image/png`, …); an empty one is read from the bytes' own signature. One
+     * committing edit (one undo step). The image never enters the CRDT: it
+     * reaches a peer through {@link opaquePartsSince}. Rejects for a document
+     * that isn't a presentation, or bytes no codec reads.
+     */
+    insertImage(bytes, contentType) {
+        return this.#editMode.insertImage(bytes, contentType);
+    }
+    /**
+     * Show or hide the page ruler on paged documents (PDF / DOCX / PPTX). A
+     * user preference; the ruler is additionally hidden automatically in
+     * `"view"` mode (a reading pose needs no measurement chrome). A spreadsheet's
+     * row/column headers are essential and never affected.
+     */
+    setShowRuler(visible) {
+        this.#editMode.setShowRuler(visible);
+    }
+    /**
+     * Show or hide formatting marks — `¶` at each paragraph end, a dot in each
+     * space, an arrow in each tab, `↵` at each line break — on wordprocessing
+     * documents; the same toggle as the ribbon's button. A
+     * user preference, off by default; the marks are editing chrome, so they're
+     * additionally hidden outside `"edit"` mode.
+     */
+    setShowFormattingMarks(visible) {
+        this.#editMode.setShowFormattingMarks(visible);
+    }
+    /** The current editor mode; `"mode:changed"` fires when it changes. */
+    get mode() {
+        return this.#editMode.currentMode();
+    }
+    /**
+     * Switch the editor mode. Ignored if `mode` isn't in the configured
+     * `allowedModes`. Drives the toolbar's command set and pointer behavior.
+     */
+    setMode(mode) {
+        this.#editMode.setMode(mode);
+    }
+    /** Tear down components, listeners, and the render worker. */
+    destroy() {
+        this.#unsubscribeMode();
+        super.destroy();
+    }
+}
+//# sourceMappingURL=editor.js.map

package/dist/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAE1G,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,6DAA6D;AAC7D,MAAM,cAAc,GAAY,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;AA6BlF;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,QAA0B;IACtD,uDAAuD;IACvD,MAAM,CAAU,OAAO,GAAW,eAAe,CAAC;IAEzC,gBAAgB,CAAa;IAC7B,SAAS,CAAW;IAE7B,YAAoB,KAAc,EAAE,QAAkB;QAClD,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,iBAAiB,CACrC,KAAK,CAAC,KAAK;QACX,+CAA+C;QAC/C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAkB,EAC3B,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAC5E,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,SAAsB,EAAE,UAA6B,EAAE;QACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,QAAQ,CACX,SAAS,EACT,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,IAAI,EACJ,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CACzC,CAAC;IACN,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,8BAA8B,CACjC,KAAiB,EACjB,UAA4C,EAAE;QAE9C,OAAO,8BAA8B,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;;OAQG;IACH,WAAW,CAAC,KAAiB,EAAE,WAAmB;QAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,OAAgB;QACzB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;OAMG;IACH,sBAAsB,CAAC,OAAgB;QACnC,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,uEAAuE;IACvE,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,IAAgB;QACpB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,8DAA8D;IACrD,OAAO;QACZ,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,KAAK,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC"}

package/dist/fonts/faces.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Which faces a font change will actually have to render in.
+ *
+ * A selection is rarely one face. Applying a family to a paragraph with a bold
+ * word in it produces text in *two* faces, and each is a separate binary — get
+ * only the regular one and the bold word still lays out in a stand-in and
+ * reflows when its own download lands, which is the whole thing the preload
+ * exists to avoid.
+ *
+ * The engine already answers this, in the form the ribbon's B / I buttons show:
+ * it folds the selection's resolved runs into a consensus per axis, and
+ * `"mixed"` means both values are present. That fold is a real walk over the
+ * composed runs, so `"mixed"` is a fact about the text, not a guess.
+ */
+import type { TextFormatState } from "@docmentis/udoc-ui/internal";
+/**
+ * The `(bold, italic)` faces to get here before applying a family.
+ *
+ * One face for a uniform selection, two when one axis is mixed, four when both
+ * are. Four is an **over-approximation**: a selection that is mixed on both axes
+ * need not contain all four combinations (bold text and italic text, but nothing
+ * bold-italic). Narrowing it would mean a new engine read of the distinct faces
+ * rather than the per-axis fold, and the cost of being wrong is one extra font
+ * fetched — the same fetch that would have happened anyway if the selection did
+ * span it.
+ */
+export declare function facesToLoad(bold: TextFormatState, italic: TextFormatState): Array<[boolean, boolean]>;
+//# sourceMappingURL=faces.d.ts.map

package/dist/fonts/faces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faces.d.ts","sourceRoot":"","sources":["../../src/fonts/faces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,GAAG,KAAK,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAMrG"}

package/dist/fonts/faces.js

@@ -0,0 +1,38 @@
+/**
+ * Which faces a font change will actually have to render in.
+ *
+ * A selection is rarely one face. Applying a family to a paragraph with a bold
+ * word in it produces text in *two* faces, and each is a separate binary — get
+ * only the regular one and the bold word still lays out in a stand-in and
+ * reflows when its own download lands, which is the whole thing the preload
+ * exists to avoid.
+ *
+ * The engine already answers this, in the form the ribbon's B / I buttons show:
+ * it folds the selection's resolved runs into a consensus per axis, and
+ * `"mixed"` means both values are present. That fold is a real walk over the
+ * composed runs, so `"mixed"` is a fact about the text, not a guess.
+ */
+/**
+ * The `(bold, italic)` faces to get here before applying a family.
+ *
+ * One face for a uniform selection, two when one axis is mixed, four when both
+ * are. Four is an **over-approximation**: a selection that is mixed on both axes
+ * need not contain all four combinations (bold text and italic text, but nothing
+ * bold-italic). Narrowing it would mean a new engine read of the distinct faces
+ * rather than the per-axis fold, and the cost of being wrong is one extra font
+ * fetched — the same fetch that would have happened anyway if the selection did
+ * span it.
+ */
+export function facesToLoad(bold, italic) {
+    const faces = [];
+    for (const isBold of values(bold)) {
+        for (const isItalic of values(italic))
+            faces.push([isBold, isItalic]);
+    }
+    return faces;
+}
+/** The values one axis takes across the selection. */
+function values(state) {
+    return state === "mixed" ? [false, true] : [state === "on"];
+}
+//# sourceMappingURL=faces.js.map

package/dist/fonts/faces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faces.js","sourceRoot":"","sources":["../../src/fonts/faces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,IAAqB,EAAE,MAAuB;IACtE,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,sDAAsD;AACtD,SAAS,MAAM,CAAC,KAAsB;IAClC,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;AAChE,CAAC"}

package/dist/fonts/preview.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Font **specimens** — a family's name drawn in its own typeface, so the picker
+ * shows the face instead of naming it.
+ *
+ * Two paths, and a family's `sourceType` picks which. Most families the browser
+ * can draw itself: a `Local` one it already answers to by name, a `Url` one it
+ * loads as a `FontFace`, a `Google` one it pulls from the css2 API. Those rows
+ * stay live text — they restyle with the theme, ellipse when the panel is
+ * narrow, and read out to a screen reader — and this module's whole job for them
+ * is to get the face into `document.fonts` and let the browser repaint on its
+ * own.
+ *
+ * The rest — `Embedded`, `OfficeCompatible`, `AdobeStandard` — have no bytes
+ * outside wasm, so nothing here can name them. Those come back from the engine
+ * as a PNG **alpha mask** and are held as object URLs for a CSS `mask-image`
+ * over `currentColor`: the specimen then takes the theme's text color, and a
+ * light/dark switch needs no redraw.
+ *
+ * A `Url` family's address is **not** in its source type — the tag carries no
+ * data at all — so the host supplies it from the same list it registered with
+ * `registerUrlFonts`. It is the only side that ever had it.
+ *
+ * Every family is worked on **once**. The picker asks for its visible window on
+ * every scroll step, so `request` has to be cheap to re-call — it is the only
+ * thing standing between a flick through ~2000 families and a request storm.
+ */
+import type { FontSourceType } from "@docmentis/udoc-wasm";
+import type { FontPreviewImage } from "../worker/protocol.js";
+/** An engine-drawn specimen: a mask to point CSS at, and the box to draw it in. */
+export interface FontSpecimen {
+    /** Object URL of a PNG whose alpha is the glyph coverage. */
+    url: string;
+    /** CSS px. */
+    width: number;
+    /** CSS px. */
+    height: number;
+    /**
+     * The transparent bleed on every side, CSS px. Offset the element by
+     * `-bleed` to put the specimen's pen origin where a text row's is — the
+     * raster is grown all round to hold overhanging ink.
+     */
+    bleed: number;
+}
+export interface FontPreviewLoaderOptions {
+    /**
+     * Draw a specimen the browser can't — the worker's `renderFontPreview`.
+     * Resolving `null` means the engine had nothing to draw; the row keeps the
+     * plain name.
+     */
+    render: (family: string, size: number) => Promise<FontPreviewImage | null>;
+    /** The em to draw engine specimens at, in CSS px. */
+    size: number;
+    /**
+     * Where a `Url` family's font actually is, keyed by family — the same
+     * addresses the host handed to `registerUrlFonts`. Omit it when the host
+     * registered none, which leaves `Url` families showing their plain name.
+     */
+    urls?: ReadonlyMap<string, string>;
+    /** Where css2 is asked for a `Google` family's face — the worker's own. */
+    googleFontEndpoint: string;
+    /**
+     * Called once per batch of arrivals (coalesced to a microtask), so a caller
+     * re-renders the rows it has mounted rather than being patched per row.
+     * Never called for browser-loaded faces — the browser repaints those itself.
+     */
+    onSpecimens: () => void;
+}
+export interface FontPreviewLoader {
+    /**
+     * Make sure these families can be shown in their own face. Families already
+     * worked on are skipped, so calling this on every scroll step is fine.
+     */
+    request: (families: readonly FontSpecimenRequest[]) => void;
+    /**
+     * The engine-drawn specimen for `family`, once it has landed.
+     *
+     * The object URLs behind these are held for the loader's life, which is the
+     * page's: a face is drawn once and the picker reopens against the same
+     * masks, so there is no point at which revoking one would be right.
+     */
+    specimen: (family: string) => FontSpecimen | undefined;
+}
+/** One row's worth of what the loader needs: which family, and whose face it is. */
+export interface FontSpecimenRequest {
+    family: string;
+    sourceType: FontSourceType;
+}
+/** Whether the engine has to draw this family — nothing outside wasm holds its
+ *  bytes. The complement of the three the browser can load itself. */
+export declare function isEngineDrawn(sourceType: FontSourceType): boolean;
+export declare function createFontPreviewLoader(options: FontPreviewLoaderOptions): FontPreviewLoader;
+/**
+ * `family` as a CSS `font-family` value, quoted and escaped — the form to drop
+ * into a style attribute. A family name is arbitrary text (it comes out of a
+ * document's font table), so it can't be interpolated raw.
+ */
+export declare function cssFontFamily(family: string): string;
+//# sourceMappingURL=preview.d.ts.map

package/dist/fonts/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/fonts/preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAU9D,mFAAmF;AACnF,MAAM,WAAW,YAAY;IACzB,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACrC;;;;OAIG;IACH,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC3E,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAC9B;;;OAGG;IACH,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,KAAK,IAAI,CAAC;IAC5D;;;;;;OAMG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC;CAC1D;AAED,oFAAoF;AACpF,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,cAAc,CAAC;CAC9B;AAED;sEACsE;AACtE,wBAAgB,aAAa,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAEjE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAsG5F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD"}