ooxml-ui 0.27.2 → 0.28.0

package/dist/edit-worker.js

@@ -0,0 +1,18 @@
+import { convertMetafileToSvgTree } from 'emf-converter';
+import { editVsdx, parseVsdx } from 'ooxml-core/visio';
+
+// src/visio/edit-worker.ts
+var worker = self;
+worker.onmessage = async (event) => {
+  try {
+    const result = await editVsdx(event.data.bytes, event.data.edits);
+    const document = await parseVsdx(result.bytes, { metafileConverter: convertMetafileToSvgTree });
+    worker.postMessage({ ok: true, ...result, document }, [result.bytes.buffer]);
+  } catch (cause) {
+    worker.postMessage({
+      ok: false,
+      message: cause instanceof Error ? cause.message : String(cause),
+      code: cause && typeof cause === "object" && "code" in cause && typeof cause.code === "string" ? cause.code : void 0
+    });
+  }
+};

package/dist/index.js

@@ -1,65 +1,9 @@
-import { installOfficeUiTheme } from './chunk-7QLJS57B.js';
-export { THEME_CSS, THEME_STYLE_ID, installOfficeUiTheme, shadcnBridge, themeBridge } from './chunk-7QLJS57B.js';
-import { registerControls } from './chunk-4PBFBPOH.js';
-export { CONTROL_DEFINERS, DEFAULT_OFFICE_PROFILE, EMPTY_MENU_STATE, OFFICE_AVATAR_SWATCHES, OFFICE_PROFILE_STORAGE_KEY, OFFICE_TITLE_BAR_SEARCH_LIMIT, OFFICE_TOAST_VISIBLE_LIMIT, assignKeyTips, attachKeyTips, clampFlyoutPosition, clampOptionNumber, clearOfficeProfile, createRibbonOverflow, defineAccount, defineBackstage, defineButton, defineCheckbox, defineCommandSearch, defineContextMenu, defineDialog, defineDialogFooter, defineFindBar, defineGallery, defineIcon, defineMenuButton, defineMenuItem, defineMenuSeparator, defineOptionsDialog, definePasteOptions, definePrintPreview, defineRadio, defineReadOnlyBanner, defineRibbon, defineRibbonGroup, defineRibbonSection, defineRibbonStack, defineRibbonToggle, defineRuler, defineSearchField, defineSelect, defineStatusBar, defineStatusItem, defineSwitch, defineTabStrip, defineTitleBar, defineToasts, defineToolbar, defineZoomSlider, glyph, nextEnabledIndex, parseSvgPreview, profileInitials, readOfficeProfile, registerControls, rulerDivisions, runKeyTips, sanitizeOfficeProfile, typeAheadIndex, writeOfficeProfile } from './chunk-4PBFBPOH.js';
-import { defineSmartArt } from './chunk-4VQ6S7QJ.js';
+export { OFFICE_UI_TAGS, registerOfficeUi } from './chunk-A56QI2OA.js';
 export { OfficeUiSmartArt, defineSmartArt, renderDiagramDrawing } from './chunk-4VQ6S7QJ.js';
-import { TEAMS_TAGS, registerTeams } from './chunk-LE4FTRWB.js';
-export { EMOJI, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_TAGS, TeamsElement, colorFor, dayLabel, defineAppRail, defineAvatar, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, definePrejoin, formatElapsed, formatSize, formatTime, icon, registerTeams, withStyles } from './chunk-LE4FTRWB.js';
+export { EMOJI, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_TAGS, TeamsApp, TeamsController, TeamsElement, TeamsSettings, applyTeamsProps, colorFor, createTeams, dayLabel, defineAppRail, defineAvatar, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, definePrejoin, defineTeamsApp, defineTeamsSettings, formatElapsed, formatSize, formatTime, icon, listenTeamsEvents, loadConfig, loadIdentity, parseIceLines, registerTeams, safeStorage, saveConfig, saveIdentity, withStyles } from './chunk-AJ2J734X.js';
+export { THEME_CSS, THEME_STYLE_ID, installOfficeUiTheme, shadcnBridge, themeBridge } from './chunk-7QLJS57B.js';
+export { CONTROL_DEFINERS, DEFAULT_OFFICE_PROFILE, EMPTY_MENU_STATE, OFFICE_AVATAR_SWATCHES, OFFICE_PROFILE_STORAGE_KEY, OFFICE_TITLE_BAR_SEARCH_LIMIT, OFFICE_TOAST_VISIBLE_LIMIT, assignKeyTips, attachKeyTips, clampFlyoutPosition, clampOptionNumber, clearOfficeProfile, createRibbonOverflow, defineAccount, defineBackstage, defineButton, defineCheckbox, defineCommandSearch, defineContextMenu, defineDialog, defineDialogFooter, defineFindBar, defineGallery, defineIcon, defineMenuButton, defineMenuItem, defineMenuSeparator, defineOptionsDialog, definePasteOptions, definePrintPreview, defineRadio, defineReadOnlyBanner, defineRibbon, defineRibbonGroup, defineRibbonSection, defineRibbonStack, defineRibbonToggle, defineRuler, defineSearchField, defineSelect, defineStatusBar, defineStatusItem, defineSwitch, defineTabStrip, defineTitleBar, defineToasts, defineToolbar, defineZoomSlider, glyph, nextEnabledIndex, parseSvgPreview, profileInitials, readOfficeProfile, registerControls, rulerDivisions, runKeyTips, sanitizeOfficeProfile, typeAheadIndex, writeOfficeProfile } from './chunk-G4ZGQYBH.js';
 export { createIconSvg, getIcon, listIcons, paintIcon, registerIcon } from './chunk-HZ422LTR.js';
-import { definePresence } from './chunk-V6W5DKJ6.js';
 export { OfficeUiPresence, definePresence, initialsOf, participantsFromAwareness } from './chunk-V6W5DKJ6.js';
 export { CONTRACT_REVISION, OfficeElement, controlStyles, flag, readFlag, triState, valueOn, withTokens } from './chunk-ZWBP2WTC.js';
 export { COMPACT, FOCUS_RING, OFFICE_TOKENS, TOUCH, tok } from './chunk-7Q7ZS2CC.js';
-
-// src/index.ts
-var OFFICE_UI_TAGS = [
-  "office-ui-icon",
-  "office-ui-button",
-  "office-ui-checkbox",
-  "office-ui-switch",
-  "office-ui-select",
-  "office-ui-ribbon-group",
-  "office-ui-ribbon-stack",
-  "office-ui-menu-item",
-  "office-ui-menu-button",
-  "office-ui-menu-separator",
-  "office-ui-context-menu",
-  "office-ui-command-search",
-  "office-ui-toolbar",
-  "office-ui-dialog",
-  "office-ui-status-bar",
-  "office-ui-status-item",
-  "office-ui-zoom-slider",
-  "office-ui-tab-strip",
-  "office-ui-options-dialog",
-  "office-ui-account",
-  "office-ui-ribbon",
-  "office-ui-find-bar",
-  "office-ui-ruler",
-  "office-ui-backstage",
-  "office-ui-print-preview",
-  "office-ui-radio",
-  "office-ui-search",
-  "office-ui-ribbon-toggle",
-  "office-ui-dialog-footer",
-  "office-ui-toasts",
-  "office-ui-read-only-banner",
-  "office-ui-paste-options",
-  "office-ui-title-bar",
-  "office-ui-ribbon-section",
-  "office-ui-gallery",
-  "office-ui-presence",
-  "office-ui-smartart",
-  ...TEAMS_TAGS
-];
-function registerOfficeUi(options = {}) {
-  if (typeof window === "undefined" || !window.customElements) return;
-  if (options.theme !== false) installOfficeUiTheme();
-  registerControls();
-  definePresence();
-  defineSmartArt();
-  registerTeams();
-}
-
-export { OFFICE_UI_TAGS, registerOfficeUi };

package/dist/parse-worker.js

@@ -0,0 +1,16 @@
+import { convertMetafileToSvgTree } from 'emf-converter';
+import { loadVisio } from 'ooxml-core/visio';
+
+// src/visio/parse-worker.ts
+var worker = self;
+worker.onmessage = async (event) => {
+  try {
+    const document = await loadVisio(event.data, { metafileConverter: convertMetafileToSvgTree });
+    worker.postMessage({ ok: true, document });
+  } catch (cause) {
+    worker.postMessage({
+      ok: false,
+      message: cause instanceof Error ? cause.message : String(cause)
+    });
+  }
+};

package/dist/teams/app/bind.d.ts

@@ -0,0 +1,28 @@
+import type { TeamsServerConfig } from 'ooxml-core/teams';
+import type { FileOpeners, FileUploader, OpenFileDetail, TeamsApp } from './teams-app.js';
+export interface TeamsProps {
+    /** Shared-state room: 1-100 alphanumeric, `-` or `_`. Default `demo`. */
+    workspaceId?: string;
+    userName?: string;
+    /** Stable id for authorship. Defaults to one remembered in this browser. */
+    userId?: string;
+    /** Server settings. Omit to use the settings dialog or local mode. */
+    config?: TeamsServerConfig | null;
+    uploadFile?: FileUploader;
+    openers?: FileOpeners;
+    onReady?: (detail: {
+        user: {
+            id: string;
+            name: string;
+        };
+    }) => void;
+    /** Cancel the event (`preventDefault`) to take over opening a file. */
+    onOpenFile?: (detail: OpenFileDetail, event: CustomEvent<OpenFileDetail>) => void;
+    onConfigChange?: (detail: {
+        config: TeamsServerConfig;
+    }) => void;
+}
+/** Push props onto the element. Only changed values are written, so frameworks can call it freely. */
+export declare function applyTeamsProps(el: TeamsApp, props: TeamsProps, prev?: TeamsProps): void;
+/** Subscribe to the element's events; the latest handlers are read through `get`. */
+export declare function listenTeamsEvents(el: TeamsApp, get: () => TeamsProps): () => void;

package/dist/teams/app/controller.d.ts

@@ -0,0 +1,13 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import { type TeamsClient, type TeamsClientOptions, type TeamsState } from 'ooxml-core/teams';
+export declare class TeamsController implements ReactiveController {
+    private readonly host;
+    private readonly onNotice;
+    client: TeamsClient | null;
+    state: TeamsState | null;
+    private off;
+    constructor(host: ReactiveControllerHost, onNotice: (text: string) => void);
+    start(options: TeamsClientOptions): void;
+    stop(): void;
+    hostDisconnected(): void;
+}

package/dist/teams/app/index.d.ts

@@ -0,0 +1,6 @@
+export { TeamsApp, defineTeamsApp, type FileOpeners, type FileUploader, type OpenFileDetail, } from './teams-app.js';
+export { TeamsSettings, defineTeamsSettings, parseIceLines } from './teams-settings.js';
+export { TeamsController } from './controller.js';
+export { applyTeamsProps, listenTeamsEvents, type TeamsProps } from './bind.js';
+export * from './store.js';
+export { loadConfig, loadIdentity, safeStorage, saveConfig, saveIdentity } from './storage.js';

package/dist/teams/app/storage.d.ts

@@ -0,0 +1,11 @@
+import { type StorageLike, type TeamsServerConfig } from 'ooxml-core/teams';
+/** localStorage that never throws (private windows, blocked cookies, quota). */
+export declare const safeStorage: StorageLike;
+export interface Identity {
+    id: string;
+    name: string;
+}
+export declare function loadIdentity(): Identity | null;
+export declare const saveIdentity: (identity: Identity) => void;
+export declare function loadConfig(): TeamsServerConfig | null;
+export declare const saveConfig: (config: TeamsServerConfig) => void;

package/dist/teams/app/store.d.ts

@@ -0,0 +1,4 @@
+import { type TeamsClient, type TeamsClientOptions } from 'ooxml-core/teams';
+export { type CallView, type TeamsClient, type TeamsClientOptions, type TeamsState, type ChannelView, type PersonView, type FileEntry, type SearchHit, } from 'ooxml-core/teams';
+/** `createTeamsClient` with the browser's safe localStorage wired in for offline snapshots. */
+export declare function createTeams(options: TeamsClientOptions): TeamsClient;

package/dist/teams/app/teams-app.d.ts

@@ -0,0 +1,110 @@
+import { LitElement, type PropertyValues } from 'lit';
+import { type FileUploader, type OfficeKind, type TeamsClient, type TeamsServerConfig } from 'ooxml-core/teams';
+import { type Identity } from './storage.js';
+export type { FileUploader } from 'ooxml-core/teams';
+export interface OpenFileDetail {
+    attachment: {
+        name: string;
+        kind: OfficeKind;
+        size?: number | undefined;
+        url?: string | undefined;
+    };
+    /** The URL to open, with the access token appended when the file lives on your server. */
+    url: string | undefined;
+}
+export type FileOpeners = Partial<Record<OfficeKind, (detail: OpenFileDetail) => void>>;
+type RailView = 'teams' | 'calls' | 'files';
+type Panel = '' | 'chat' | 'people';
+export declare class TeamsApp extends LitElement {
+    static styles: import("lit").CSSResult;
+    static properties: {
+        workspaceId: {
+            type: StringConstructor;
+            attribute: string;
+        };
+        userName: {
+            type: StringConstructor;
+            attribute: string;
+        };
+        userId: {
+            type: StringConstructor;
+            attribute: string;
+        };
+        serverConfig: {
+            type: StringConstructor;
+            attribute: string;
+        };
+        config: {
+            attribute: boolean;
+        };
+        uploadFile: {
+            attribute: boolean;
+        };
+        openers: {
+            attribute: boolean;
+        };
+        rail: {
+            state: boolean;
+        };
+        tab: {
+            state: boolean;
+        };
+        panel: {
+            state: boolean;
+        };
+        meeting: {
+            state: boolean;
+        };
+        settingsOpen: {
+            state: boolean;
+        };
+        toast: {
+            state: boolean;
+        };
+        identity: {
+            state: boolean;
+        };
+    };
+    workspaceId: string;
+    userName: string;
+    userId: string;
+    serverConfig: string;
+    /** Server settings. Omit to use the settings dialog (remembered in this browser) or local mode. */
+    config: TeamsServerConfig | null;
+    /** Where attachments go. Default: your server's `/files` endpoint. */
+    uploadFile: FileUploader | undefined;
+    /** Per-product openers (for example the Word or Excel viewer). Default: open the URL. */
+    openers: FileOpeners;
+    rail: RailView;
+    tab: 'posts' | 'files';
+    panel: Panel;
+    meeting: boolean;
+    settingsOpen: boolean;
+    toast: string;
+    identity: Identity | null;
+    private readonly teams;
+    private toastTimer;
+    constructor();
+    /** The core client behind this element, for hosts that want the raw actions. */
+    get client(): TeamsClient | null;
+    connectedCallback(): void;
+    private resolveConfig;
+    protected willUpdate(changed: PropertyValues<this>): void;
+    private notify;
+    private openFile;
+    private createChannel;
+    private onCallAction;
+    private startMeeting;
+    private selectChannel;
+    private askSettings;
+    protected render(): import("lit").TemplateResult<1>;
+    private welcome;
+    private topbar;
+    private sidebar;
+    private main;
+    private conversation;
+    private fileList;
+    private allFiles;
+    private meetingView;
+}
+export declare function defineTeamsApp(registry?: CustomElementRegistry | undefined): void;

package/dist/teams/app/teams-settings.d.ts

@@ -0,0 +1,34 @@
+import { LitElement } from 'lit';
+import { type TeamsServerConfig } from 'ooxml-core/teams';
+/** One ICE server per line: `urls[,urls] [username credential]`. */
+export declare function parseIceLines(text: string): unknown[];
+export declare const iceToText: (config: TeamsServerConfig) => string;
+/**
+ * `<teams-settings .config=${cfg} open>`. Emits `teams-settings-apply` `{ config }` and
+ * `teams-settings-close` `{}`.
+ */
+export declare class TeamsSettings extends LitElement {
+    static styles: import("lit").CSSResult;
+    static properties: {
+        config: {
+            attribute: boolean;
+        };
+        open: {
+            type: BooleanConstructor;
+            reflect: boolean;
+        };
+        issues: {
+            state: boolean;
+        };
+    };
+    config: TeamsServerConfig;
+    open: boolean;
+    issues: string[];
+    constructor();
+    protected updated(): void;
+    private field;
+    private apply;
+    private close;
+    protected render(): import("lit").TemplateResult<1>;
+}
+export declare function defineTeamsSettings(registry?: CustomElementRegistry | undefined): void;

package/dist/teams/index.d.ts

@@ -12,3 +12,4 @@ export * from './prejoin.js';
 export declare const TEAMS_TAGS: readonly ['office-ui-avatar', 'office-ui-app-rail', 'office-ui-channel-list', 'office-ui-chat-list', 'office-ui-chat-composer', 'office-ui-prejoin', 'office-ui-call-grid', 'office-ui-call-controls'];
 /** Define the team-workspace elements. Idempotent; a no-op without a DOM. */
 export declare function registerTeams(): void;
+export * from './app/index.js';

package/dist/teams.js

@@ -1,4 +1,6 @@
-export { EMOJI, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_TAGS, TeamsElement, colorFor, dayLabel, defineAppRail, defineAvatar, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, definePrejoin, formatElapsed, formatSize, formatTime, icon, registerTeams, withStyles } from './chunk-LE4FTRWB.js';
+export { EMOJI, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_TAGS, TeamsApp, TeamsController, TeamsElement, TeamsSettings, applyTeamsProps, colorFor, createTeams, dayLabel, defineAppRail, defineAvatar, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, definePrejoin, defineTeamsApp, defineTeamsSettings, formatElapsed, formatSize, formatTime, icon, listenTeamsEvents, loadConfig, loadIdentity, parseIceLines, registerTeams, safeStorage, saveConfig, saveIdentity, withStyles } from './chunk-AJ2J734X.js';
+import './chunk-7QLJS57B.js';
+import './chunk-G4ZGQYBH.js';
 import './chunk-HZ422LTR.js';
 import './chunk-V6W5DKJ6.js';
 import './chunk-ZWBP2WTC.js';

package/dist/visio/arrowheads.d.ts

@@ -0,0 +1,3 @@
+import type { VisioStyle } from 'ooxml-core/visio';
+/** Common Visio line/triangle and concave arrow styles. Sizes remain a documented visual approximation. */
+export declare function applyArrowheads(path: SVGPathElement, style: VisioStyle, defs: SVGDefsElement, warnings: Set<string>): void;

package/dist/visio/backstage.d.ts

@@ -0,0 +1,15 @@
+import type { OfficeBackstageItem } from '../controls';
+/** Visio's File (backstage) pages, in Visio's order. Save and Close act without a page. */
+export declare const BACKSTAGE_ITEMS: readonly [readonly ['info', 'Info'], readonly ['new', 'New'], readonly ['open', 'Open'], readonly ['save', 'Save'], readonly ['save-as', 'Save As'], readonly ['print', 'Print'], readonly ['share', 'Share'], readonly ['export', 'Export'], readonly ['close', 'Close']];
+export declare const BACKSTAGE_FOOTER: readonly [readonly ['account', 'Account'], readonly ['feedback', 'Feedback'], readonly ['options', 'Options']];
+export type BackstagePage = Exclude<(typeof BACKSTAGE_ITEMS)[number][0] | (typeof BACKSTAGE_FOOTER)[number][0], 'save' | 'close' | 'options'>;
+/** The navigation items, with optional disabled states (Save and Close follow the drawing). */
+export declare function backstageItems(state?: Partial<Record<string, {
+    disabled: boolean;
+    title?: string;
+}>>): OfficeBackstageItem[];
+/**
+ * Visio's backstage: a full-window File view with a navigation column and one page per item.
+ * Static application structure only; document values are filled in later as text.
+ */
+export declare function createBackstage(doc: Document): HTMLElement;

package/dist/visio/binding.d.ts

@@ -0,0 +1,27 @@
+import type { VisioEdit } from 'ooxml-core/visio';
+import type { ViewerOptions, VsdxSource } from 'ooxml-core/visio/ui';
+import { type VisioViewerElement } from './viewer-element.js';
+import type { ViewerController } from './controller.js';
+import type { SvgExportOptions, SvgExportResult } from './export-svg.js';
+import type { CurrentPagePrintSnapshotOptions, PrintSnapshot } from './print-snapshot.js';
+import type { VsdxExportResult } from 'ooxml-core/visio/ui';
+export interface MountedViewer {
+    readonly element: VisioViewerElement;
+    readonly controller: ViewerController;
+    update(options: ViewerOptions): void;
+    load(source: VsdxSource): Promise<void>;
+    applyEdits(edits: readonly VisioEdit[]): Promise<void>;
+    replacePlainText(pageId: string, shapeId: string, text: string): Promise<void>;
+    undo(): Promise<void>;
+    redo(): Promise<void>;
+    cancelEdit(): void;
+    exportVsdx(): VsdxExportResult;
+    fit(): void;
+    setLayerVisibility(pageId: string, layerId: string, visible: boolean | null): void;
+    resetLayerVisibility(pageId?: string): void;
+    exportSvg(options?: SvgExportOptions): SvgExportResult;
+    createPrintSnapshot(options?: CurrentPagePrintSnapshotOptions): PrintSnapshot;
+    destroy(): void;
+}
+/** One client-only lifecycle adapter; framework wrappers forward to this implementation. */
+export declare function mountViewer(container: HTMLElement, initial?: ViewerOptions): MountedViewer;

package/dist/visio/controller.d.ts

@@ -0,0 +1,71 @@
+import { type ViewerEditState, type VsdxExportResult } from 'ooxml-core/visio/ui';
+import { type CancellableEditor } from './worker-editor.js';
+import { type VisioDocument, type VisioEdit } from 'ooxml-core/visio';
+import { type LayerVisibilityOverride } from './viewer-layers.js';
+import type { CancellableParser } from './worker-parser.js';
+import type { ViewerEvents } from 'ooxml-core/visio/ui';
+import { type TextSearchState } from 'ooxml-core/visio/ui';
+export interface ViewerState {
+    readonly document: VisioDocument | null;
+    readonly edit: ViewerEditState;
+    readonly pageIndex: number;
+    readonly zoom: number;
+    readonly loading: boolean;
+    readonly error: Error | null;
+    readonly search: TextSearchState;
+    /** Viewer-only display overrides, independent of saved model and print policy. */
+    readonly layerVisibilityOverrides: readonly LayerVisibilityOverride[];
+    readonly selectedShape: {
+        id: string;
+        name: string;
+        pageId?: string;
+    } | null;
+}
+type Parser = CancellableParser;
+type EventListener = <K extends keyof ViewerEvents>(name: K, detail: ViewerEvents[K]) => void;
+export declare class ViewerController {
+    #private;
+    private readonly parser;
+    private readonly listenerError;
+    private readonly editor;
+    constructor(parser?: Parser, listenerError?: (error: unknown) => void, editor?: CancellableEditor);
+    get state(): ViewerState;
+    /** Accepted document replacements, including the same object, invalidate captured artifacts. */
+    get documentGeneration(): number;
+    /** Accepted source/model replacements invalidate drafts; edit/undo/redo keep this source epoch. */
+    get sourceGeneration(): number;
+    subscribe(listener: (state: ViewerState) => void): () => void;
+    onEvent(listener: EventListener): () => void;
+    setDocument(document: VisioDocument | null): void;
+    setPage(index: number): void;
+    setZoom(zoom: number): void;
+    selectShape(shape: ViewerState['selectedShape']): void;
+    /** Override one source-page layer for viewing. null restores its saved display flag. */
+    setLayerVisibility(pageId: string, layerId: string, visible: boolean | null): void;
+    /** Reset a source page, or all pages when omitted. Does not modify the document. */
+    resetLayerVisibility(pageId?: string): void;
+    /** Search does not change the page or selection until explicit result navigation. */
+    setSearchQuery(query: string): void;
+    selectSearchResult(index: number): void;
+    nextSearchResult(): void;
+    previousSearchResult(): void;
+    load(bytes: Uint8Array | ArrayBuffer): Promise<void>;
+    /** Reading bytes shares the same request epoch and error state as parsing them. */
+    loadSource(read: () => Uint8Array | ArrayBuffer | Promise<Uint8Array | ArrayBuffer>): Promise<void>;
+    cancelLoad(): void;
+    destroy(): void;
+    /** Replace one source-backed local plain-text target. Core decides target support. */
+    replacePlainText(pageId: string, shapeId: string, text: string): Promise<void>;
+    /** Atomic source-backed edits. Core owns protection, dependency and target validation. */
+    applyEdits(edits: readonly VisioEdit[]): Promise<void>;
+    undo(): Promise<void>;
+    /**
+     * Adopt a package from a shared session as one undoable history step. Emits `document-change`
+     * with kind `remote`, which a session must not publish back.
+     */
+    applyRemoteSource(bytes: Uint8Array): Promise<void>;
+    redo(): Promise<void>;
+    cancelEdit(): void;
+    exportVsdx(): VsdxExportResult;
+}
+export {};

package/dist/visio/edit-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/visio/export-svg.d.ts

@@ -0,0 +1,25 @@
+import { type VisioDocument, type VisioPage } from 'ooxml-core/visio';
+import { type CompatibilityNote } from 'ooxml-core/visio/ui';
+export declare const MAX_SVG_EXPORT_BYTES: number;
+export interface SvgExportOptions {
+    /** UTF-8 output ceiling. May lower, but never raise, the 16 MiB safety limit. */
+    maxBytes?: number;
+}
+export interface SvgExportResult {
+    readonly svg: string;
+    readonly byteLength: number;
+    readonly pageIndex: number;
+    readonly pageName: string;
+    /** Saved page dimensions in inches, independent of viewport zoom. */
+    readonly width: number;
+    readonly height: number;
+    readonly diagnostics: CompatibilityNote[];
+}
+/**
+ * Export one page through the shared renderer, including its resolved backgrounds.
+ * Requires a browser DOM at call time, never uploads, downloads or mutates viewer state.
+ * Conservative preflight limits can reject a page whose eventual serialization would be smaller.
+ */
+export declare function exportPageSvg(model: VisioDocument, pageIndex?: number, options?: SvgExportOptions): SvgExportResult;
+/** @internal Call only after canonical scene validation. Shared conservative allocation preflight. */
+export declare function estimatePageSvgBytes(model: VisioDocument, page: VisioPage, maxBytes: number): number;

package/dist/visio/index.d.ts

@@ -0,0 +1,14 @@
+export { ViewerController, type ViewerState } from './controller.js';
+export { mountViewer, type MountedViewer } from './binding.js';
+export { VisioViewerElement, registerVisioViewer } from './viewer-element.js';
+export { renderPage, type RenderResult, type RenderOptions } from './render-svg.js';
+export { exportPageSvg, MAX_SVG_EXPORT_BYTES, type SvgExportOptions, type SvgExportResult, } from './export-svg.js';
+export { createPrintSnapshot, PRINT_SNAPSHOT_LIMITS, type PrintSnapshot, type PrintSnapshotPage, type PrintSnapshotOptions, type PrintSnapshotLimits, type PrintSnapshotUsage, type CurrentPagePrintSnapshotOptions, } from './print-snapshot.js';
+export { eventKeys, propertyKeys, type ViewerProperties, type ViewerEvents, type ViewerCallbacks, type ViewerOptions, type VsdxSource, } from 'ooxml-core/visio/ui';
+export type { VisioDocument, VisioPage, VisioShape, VisioDiagnostic } from 'ooxml-core/visio';
+export { createWorkerParser, type CancellableParser } from './worker-parser.js';
+export { compatibilityNotes, compatibilityText, type CompatibilityNote } from 'ooxml-core/visio/ui';
+export { TEXT_SEARCH_LIMITS, type TextSearchResult, type TextSearchState, } from 'ooxml-core/visio/ui';
+export { VIEWER_LAYER_LIMITS, type LayerVisibilityOverride } from './viewer-layers.js';
+export type { ViewerEditState, VsdxExportResult } from 'ooxml-core/visio/ui';
+export type { VisioEdit, VisioGeometryEdit } from 'ooxml-core/visio';

package/dist/visio/office-ui.d.ts

@@ -0,0 +1,2 @@
+/** Define the shared Office controls the viewer chrome uses. Idempotent; browser only. */
+export declare function registerViewerControls(registry?: CustomElementRegistry): void;

package/dist/visio/paragraph-layout.d.ts

@@ -0,0 +1,18 @@
+import type { VisioParagraph, VisioText } from 'ooxml-core/visio';
+import { type TextLayoutBudget, type MeasureText, type TextLine } from './text-layout.js';
+export interface PositionedLine extends TextLine {
+    x: number;
+    y: number;
+    availableWidth: number;
+    align: VisioParagraph['horizontalAlign'];
+    direction: 'ltr' | 'rtl';
+    last: boolean;
+    bullet?: NonNullable<VisioParagraph['bullet']> & {
+        x: number;
+    };
+}
+export interface ParagraphLayout {
+    lines: PositionedLine[];
+    height: number;
+}
+export declare function layoutParagraphs(text: VisioText, measure?: MeasureText, budget?: TextLayoutBudget): ParagraphLayout;

package/dist/visio/parse-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/visio/print-snapshot.d.ts

@@ -0,0 +1,87 @@
+import { type VisioDocument } from 'ooxml-core/visio';
+import type { CompatibilityNote } from 'ooxml-core/visio/ui';
+/** Application guardrails, not printer capabilities or Microsoft Visio limits. */
+export declare const PRINT_SNAPSHOT_LIMITS: Readonly<{
+    maxPages: 32;
+    maxTotalBytes: number;
+    maxPageBytes: number;
+    maxShapeInstances: 100000;
+    maxGeometryInstances: 100000;
+    maxPathCharacters: 16000000;
+    maxTextCharacters: 1000000;
+    maxTextRuns: 100000;
+    maxImageBytes: number;
+    maxUniqueImagePixels: 64000000;
+    maxImageInstancePixels: 256000000;
+    maxVectorNodes: 100000;
+    maxVectorCommands: 400000;
+    maxVectorOperands: 1000000;
+    maxPageAxisCssPixels: 4096;
+    maxPageAreaCssPixels: 16000000;
+    maxTotalAreaCssPixels: 64000000;
+    maxValidationShapeVisits: 1000000;
+    maxValidationWork: number;
+}>;
+export type PrintSnapshotLimits = {
+    -readonly [K in keyof typeof PRINT_SNAPSHOT_LIMITS]: number;
+};
+export interface PrintSnapshotOptions {
+    /** Explicit output order. Background pages are included as sheets only when selected. */
+    readonly pageIndices: readonly number[];
+    /** Positive integer limits may lower, but never raise, the hard ceilings. */
+    readonly limits?: Partial<PrintSnapshotLimits>;
+}
+/** Viewer handles always capture exactly the current page. */
+export type CurrentPagePrintSnapshotOptions = Omit<PrintSnapshotOptions, 'pageIndices'>;
+export interface PrintSnapshotPage {
+    readonly pageIndex: number;
+    readonly pageId: string;
+    readonly pageName: string;
+    /** Saved drawing dimensions, not printer paper, margins, orientation or scale. */
+    readonly drawingSize: Readonly<{
+        width: number;
+        height: number;
+        unit: 'in';
+    }>;
+    /** An isolated SVG document. Do not concatenate page trees with colliding resource IDs. */
+    readonly svg: string;
+    readonly byteLength: number;
+    readonly diagnostics: readonly Readonly<CompatibilityNote>[];
+}
+export interface PrintSnapshotUsage {
+    readonly estimatedSvgBytes: number;
+    readonly svgBytes: number;
+    readonly shapeInstances: number;
+    readonly geometryInstances: number;
+    readonly pathCharacters: number;
+    readonly textCharacters: number;
+    readonly textRuns: number;
+    /** Raw resources counted once per byte identity per output page, including backgrounds. */
+    readonly imageBytes: number;
+    readonly uniqueImagePixels: number;
+    readonly imageInstancePixels: number;
+    /** Includes all clip reference expansions and repeated/background vector instances. */
+    readonly vectorNodes: number;
+    readonly vectorCommands: number;
+    readonly vectorOperands: number;
+    readonly totalAreaCssPixels: number;
+    readonly validationShapeVisits: number;
+    /** Conservative bytes, characters and records across validation and the private copy pass. */
+    readonly validationWork: number;
+}
+export interface PrintSnapshot {
+    readonly appearance: 'saved-display';
+    readonly pageIndices: readonly number[];
+    readonly pages: readonly PrintSnapshotPage[];
+    readonly byteLength: number;
+    readonly limits: Readonly<PrintSnapshotLimits>;
+    readonly usage: PrintSnapshotUsage;
+    readonly limitations: readonly string[];
+}
+/**
+ * Synchronously prepare bounded, immutable page artifacts through the shared SVG renderer.
+ * Requires its DOM/serializer, but never mounts nodes, downloads, fetches, opens frames or prints.
+ * Canonical scene/raster validation is repeated on every call. No source object is frozen.
+ * Conservative budgets include hidden content and can reject otherwise exportable individual pages.
+ */
+export declare function createPrintSnapshot(model: VisioDocument, options: PrintSnapshotOptions): PrintSnapshot;

package/dist/visio/render-fill.d.ts

@@ -0,0 +1,2 @@
+import type { VisioStyle } from 'ooxml-core/visio';
+export declare function fillPaint(style: VisioStyle, defs: SVGDefsElement): string;

package/dist/visio/render-foreign-vector-shape.d.ts

@@ -0,0 +1,4 @@
+import type { VisioShape } from 'ooxml-core/visio';
+import type { ForeignVectorBudget } from 'ooxml-core/visio/ui';
+/** Core supplies shape-local placement; converter coordinates have a downward Y axis. */
+export declare function renderForeignVectorShape(shape: VisioShape, budget: ForeignVectorBudget): SVGGElement | undefined;

package/dist/visio/render-foreign-vector.d.ts

@@ -0,0 +1,3 @@
+import { ForeignVectorBudget } from 'ooxml-core/visio/ui';
+/** Render an independently validated inert scene. Never forwards source tags, IDs or attributes. */
+export declare function renderForeignVector(source: unknown, owner?: Document, budget?: ForeignVectorBudget): SVGSVGElement;

package/dist/visio/render-image.d.ts

@@ -0,0 +1,4 @@
+import type { VisioShape } from 'ooxml-core/visio';
+import type { RenderResources } from './render-resources.js';
+/** URLs are created only from bounded embedded raster bytes, never from document strings. */
+export declare function renderImage(shape: VisioShape, resources: RenderResources): SVGGElement | undefined;