pptx-svelte-viewer 1.4.0 → 2.0.0

package/dist/viewer/state/render-context.d.ts

@@ -1,8 +1,10 @@
-import { ParsedTableStyleMap, PptxThemeColorScheme } from 'pptx-viewer-core';
+import { ParsedTableStyleMap, PptxThemeColorScheme, PptxThemeFontScheme } from 'pptx-viewer-core';
 import { TableStyleContext } from 'pptx-viewer-shared';
 export interface RenderContextSource {
     getColorScheme: () => PptxThemeColorScheme | undefined;
     getTableStyleMap: () => ParsedTableStyleMap | undefined;
+    /** Theme font scheme, so band/header cell text can resolve major/minor fonts. */
+    getFontScheme?: () => PptxThemeFontScheme | undefined;
 }
 export declare function provideRenderContext(source: RenderContextSource): void;
 export declare function useTableStyleContext(): TableStyleContext | undefined;

package/dist/viewer/state/render-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-context.d.ts","sourceRoot":"","sources":["../../../src/viewer/state/render-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAK5D,MAAM,WAAW,mBAAmB;IACnC,cAAc,EAAE,MAAM,oBAAoB,GAAG,SAAS,CAAC;IACvD,gBAAgB,EAAE,MAAM,mBAAmB,GAAG,SAAS,CAAC;CACxD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAEtE;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,SAAS,CAQpE"}
+{"version":3,"file":"render-context.d.ts","sourceRoot":"","sources":["../../../src/viewer/state/render-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAK5D,MAAM,WAAW,mBAAmB;IACnC,cAAc,EAAE,MAAM,oBAAoB,GAAG,SAAS,CAAC;IACvD,gBAAgB,EAAE,MAAM,mBAAmB,GAAG,SAAS,CAAC;IACxD,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,mBAAmB,GAAG,SAAS,CAAC;CACtD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAEtE;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,SAAS,CAWpE"}

package/dist/viewer/state/viewer-effects.svelte.d.ts

@@ -16,6 +16,14 @@ export interface ViewerEffectsDeps {
     getOnload(): ((detail: ViewerLoadDetail) => void) | undefined;
     getOnerror(): ((message: string) => void) | undefined;
     getOnslidechange(): ((index: number) => void) | undefined;
+    /**
+     * Called synchronously right after a completed load is committed to editor
+     * state, before the commit's effects flush. Collaboration re-adopts the
+     * shared doc's slides here so a slow bootstrap load that lands mid-session
+     * cannot clobber content already synced from the room (and the placeholder
+     * deck is never published into the doc).
+     */
+    onContentApplied?(): void;
 }
 /**
  * All of `PowerPointViewer`'s `$effect`-based wiring in one place: keeps

package/dist/viewer/state/viewer-effects.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewer-effects.svelte.d.ts","sourceRoot":"","sources":["../../../src/viewer/state/viewer-effects.svelte.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IACjC,SAAS,IAAI,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IACzD,WAAW,IAAI,OAAO,CAAC;IACvB,eAAe,IAAI,MAAM,CAAC;IAC1B,aAAa,IAAI,UAAU,CAAC;IAC5B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,SAAS,IAAI,CAAC,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC9D,UAAU,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACtD,gBAAgB,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CA8E9D"}
+{"version":3,"file":"viewer-effects.svelte.d.ts","sourceRoot":"","sources":["../../../src/viewer/state/viewer-effects.svelte.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IACjC,SAAS,IAAI,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IACzD,WAAW,IAAI,OAAO,CAAC;IACvB,eAAe,IAAI,MAAM,CAAC;IAC1B,aAAa,IAAI,UAAU,CAAC;IAC5B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,SAAS,IAAI,CAAC,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC9D,UAAU,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACtD,gBAAgB,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC1D;;;;;;OAMG;IACH,gBAAgB,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAkF9D"}

package/dist/viewer/state/viewer-options-context.d.ts

@@ -0,0 +1,10 @@
+import { ViewerOptionsState } from './viewer-options.svelte';
+/** Provide the options state to the component subtree (root component only). */
+export declare function provideViewerOptions(state: ViewerOptionsState): void;
+/**
+ * Consume the nearest provided options state. Falls back to a fresh,
+ * non-persisted default state so components stay renderable when mounted
+ * stand-alone (tests).
+ */
+export declare function useViewerOptions(): ViewerOptionsState;
+//# sourceMappingURL=viewer-options-context.d.ts.map

package/dist/viewer/state/viewer-options-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-options-context.d.ts","sourceRoot":"","sources":["../../../src/viewer/state/viewer-options-context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAU7D,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAGrD"}

package/dist/viewer/state/viewer-options-wiring.svelte.d.ts

@@ -0,0 +1,31 @@
+import { EditorState } from '../editor/editor-state.svelte';
+import { ViewerOptionsState } from './viewer-options.svelte';
+import { ViewerParityUiState } from './viewer-parity-ui.svelte';
+export interface ViewerOptionsWiringDeps {
+    optionsState: ViewerOptionsState;
+    parityUi: ViewerParityUiState;
+    editor: EditorState;
+    getAutosaveEnabled(): boolean;
+    setAutosaveEnabled(enabled: boolean): void;
+    /** Host `onautosavetoggle` callback (skipped for the mount-time hydration). */
+    onAutosaveToggle?(enabled: boolean): void;
+    getLoadCount(): number;
+    /** Protected View: force the viewer read-only after a load. */
+    setEditable(editable: boolean): void;
+}
+/**
+ * `$effect`-based glue between the File > Options store and the legacy
+ * viewer state, mirroring React's guarded bidirectional sync:
+ *
+ *  - options -> legacy: dialog edits (and persisted values on mount) flow
+ *    into `parityUi.preferences` and the title-bar autosave toggle;
+ *  - legacy -> options: the ribbon View toggles and the autosave switch flow
+ *    back into the store (and thus localStorage).
+ *
+ * Both directions only write when a value actually differs, so the pair
+ * converges instead of looping. Also threads the undo depth into the editor
+ * history and applies Trust Center's Protected View on each load. Must be
+ * called during component initialization (registers effects).
+ */
+export declare function useViewerOptionsWiring(deps: ViewerOptionsWiringDeps): void;
+//# sourceMappingURL=viewer-options-wiring.svelte.d.ts.map

package/dist/viewer/state/viewer-options-wiring.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-options-wiring.svelte.d.ts","sourceRoot":"","sources":["../../../src/viewer/state/viewer-options-wiring.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,WAAW,uBAAuB;IACvC,YAAY,EAAE,kBAAkB,CAAC;IACjC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,kBAAkB,IAAI,OAAO,CAAC;IAC9B,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,+EAA+E;IAC/E,gBAAgB,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1C,YAAY,IAAI,MAAM,CAAC;IACvB,+DAA+D;IAC/D,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CACrC;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CA8C1E"}

package/dist/viewer/state/viewer-options.svelte.d.ts

@@ -0,0 +1,55 @@
+import { PrintSettings, ToolbarTabId, ViewerOptionPrimitive, ViewerOptions, ViewerOptionsGroupId, ViewerOptionsStoreInit, ViewerPreferences } from 'pptx-viewer-shared';
+/**
+ * ViewerOptionsState: the runes wrapper around the shared File > Options
+ * store. Owns the reactive `options` snapshot (updated via the store's
+ * subscribe callback, persisted by the store to the shared
+ * `pptx-viewer-prefs` localStorage entry) plus the derived behavior values
+ * the viewer wires: history depth, ribbon visibility, print defaults,
+ * screen tips, root classes, trust gates, and feedback sounds.
+ */
+export declare class ViewerOptionsState {
+    #private;
+    /** Reactive File > Options snapshot; a new object per change. */
+    options: ViewerOptions;
+    constructor(init?: ViewerOptionsStoreInit);
+    /** The legacy six-toggle projection of the current options. */
+    get preferences(): ViewerPreferences;
+    /** Undo depth for the editor history (Advanced > maximum undos). */
+    get historyDepth(): number;
+    /** Ribbon tabs unticked in Customize Ribbon (File never hides). */
+    get hiddenRibbonTabIds(): readonly ToolbarTabId[];
+    /** Print dialog seed, or undefined for "use most recent settings". */
+    get printDefaults(): Partial<PrintSettings> | undefined;
+    /** Viewer-root CSS classes reflecting display-affecting options. */
+    get rootClasses(): string[];
+    setValue(group: ViewerOptionsGroupId, key: string, value: ViewerOptionPrimitive): void;
+    /** Restore a snapshot wholesale (the dialog's Cancel semantics). */
+    restore(snapshot: ViewerOptions): void;
+    setRibbonTabHidden(tabId: ToolbarTabId, hidden: boolean): void;
+    setQuickAccessCommands(commandIds: readonly string[]): void;
+    reset(group?: ViewerOptionsGroupId): void;
+    /**
+     * Push the legacy preference toggles (ribbon View tab, title-bar autosave)
+     * back into the options model. Only writes when a value actually differs,
+     * so the bidirectional sync with `preferences` cannot loop.
+     */
+    applyPreferences(prefs: ViewerPreferences): void;
+    /** Tooltip text under the current ScreenTip style, or undefined for none. */
+    screenTip(label: string, description?: string, shortcut?: string): string | undefined;
+    /**
+     * Trust Center gate for following an external hyperlink. Returns true when
+     * navigation may proceed (gate off, non-http(s) target, or confirmed).
+     */
+    confirmHyperlink(href: string, message: string): boolean;
+    /** Accessibility > "feedback with sound" cue for a completed action. */
+    playFeedback(): void;
+    /**
+     * Autosave debounce in ms: the host prop until the user picks a custom
+     * AutoRecover cadence in Options > Save, which then takes over.
+     */
+    autosaveDebounceMs(hostIntervalMs: number, defaultMinutes: number): number;
+    /** Options > Save > "Delete cached files": drop all recovery snapshots. */
+    clearCache(): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=viewer-options.svelte.d.ts.map

package/dist/viewer/state/viewer-options.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-options.svelte.d.ts","sourceRoot":"","sources":["../../../src/viewer/state/viewer-options.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EAEpB,sBAAsB,EACtB,iBAAiB,EACjB,MAAM,oBAAoB,CAAC;AAgB5B;;;;;;;GAOG;AACH,qBAAa,kBAAkB;;IAC9B,iEAAiE;IACjE,OAAO,gBAAoE;gBAK/D,IAAI,CAAC,EAAE,sBAAsB;IAQzC,+DAA+D;IAC/D,IAAI,WAAW,IAAI,iBAAiB,CAEnC;IAED,oEAAoE;IACpE,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,mEAAmE;IACnE,IAAI,kBAAkB,IAAI,SAAS,YAAY,EAAE,CAEhD;IAED,sEAAsE;IACtE,IAAI,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,CAEtD;IAED,oEAAoE;IACpE,IAAI,WAAW,IAAI,MAAM,EAAE,CAE1B;IAED,QAAQ,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAItF,oEAAoE;IACpE,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAItC,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAI9D,sBAAsB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAI3D,KAAK,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI;IAIzC;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAahD,6EAA6E;IAC7E,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIrF;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAOxD,wEAAwE;IACxE,YAAY,IAAI,IAAI;IAIpB;;;OAGG;IACH,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;IAM1E,2EAA2E;IACrE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,OAAO,IAAI,IAAI;CAGf"}

package/dist/viewer/style/element-style.d.ts

@@ -1,4 +1,4 @@
-import { PptxElement } from 'pptx-viewer-core';
+import { PptxElement, ShapeStyle } from 'pptx-viewer-core';
 import { CssStyleMap } from 'pptx-viewer-shared';
 /**
  * Element style computation for the Svelte binding. Port of the Vue
@@ -14,13 +14,13 @@ export declare function getContainerStyle(el: PptxElement, zIndex: number): CssS
  * binding's `getShapeFillStrokeStyle` (itself a port of React's
  * `getShapeVisualStyle` priority cascade).
  */
-export declare function getShapeFillStrokeStyle(el: PptxElement): CssStyleMap;
+export declare function getShapeFillStrokeStyle(el: PptxElement, parentGroupFill?: ShapeStyle, animatesFill?: boolean, animatesStroke?: boolean): CssStyleMap;
 /**
  * Merge container + shape styles for a shape box, composing the container's
  * rotation/flip transform with any 3D transform from the shape style instead
  * of letting the spread clobber it. Mirrors Vue's `shapeDivStyle`.
  */
-export declare function getShapeBoxStyle(el: PptxElement, zIndex: number): CssStyleMap;
+export declare function getShapeBoxStyle(el: PptxElement, zIndex: number, parentGroupFill?: ShapeStyle, animatesFill?: boolean, animatesStroke?: boolean): CssStyleMap;
 /** Resolve a displayable image source for picture/image/media poster frames. */
 export declare function getImageSrc(el: PptxElement, mediaDataUrls: Map<string, string>): string | undefined;
 //# sourceMappingURL=element-style.d.ts.map

package/dist/viewer/style/element-style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-style.d.ts","sourceRoot":"","sources":["../../../src/viewer/style/element-style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAetD;;;;;GAKG;AAEH,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CAuGpE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAQ7E;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAC1B,EAAE,EAAE,WAAW,EACf,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,GAAG,SAAS,CAEpB"}
+{"version":3,"file":"element-style.d.ts","sourceRoot":"","sources":["../../../src/viewer/style/element-style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAetD;;;;;GAKG;AAEH,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,EAAE,EAAE,WAAW,EACf,eAAe,CAAC,EAAE,UAAU,EAK5B,YAAY,CAAC,EAAE,OAAO,EACtB,cAAc,CAAC,EAAE,OAAO,GACtB,WAAW,CAmHb;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,UAAU,EAC5B,YAAY,CAAC,EAAE,OAAO,EACtB,cAAc,CAAC,EAAE,OAAO,GACtB,WAAW,CAQb;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAC1B,EAAE,EAAE,WAAW,EACf,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,GAAG,SAAS,CAEpB"}

package/dist/viewer/types.d.ts

@@ -1,5 +1,6 @@
 import { PptxSaveFormat } from 'pptx-viewer-core';
 import { AccountAuthConfig, CanvasSize, CollaborationConfig, CollaborationRole, CollaborationTransport, PowerPointViewerAPI, ThemeCatalogEntry, ToolbarActionId, ViewerFontSource, ViewerTheme } from 'pptx-viewer-shared';
+import { PptxAiConfig } from 'pptx-viewer-shared/ai';
 import { LocaleCatalogEntry } from 'pptx-viewer-shared/i18n';
 import { ExportGifOptions, ExportPdfOptions, ExportVideoOptions, PrintOptions } from './export';
 /**
@@ -13,6 +14,7 @@ import { ExportGifOptions, ExportPdfOptions, ExportVideoOptions, PrintOptions }
  *  - **`content` is named `source`.** The viewer accepts raw `.pptx` bytes.
  */
 export type { CanvasSize, CollaborationConfig, CollaborationRole, CollaborationTransport, ToolbarActionId, ViewerTheme, };
+export type { PptxAiConfig };
 /** Payload for the `onload` callback. */
 export interface ViewerLoadDetail {
     /** Number of slides in the loaded presentation. */
@@ -99,11 +101,11 @@ export interface PowerPointViewerProps {
      */
     showNotes?: boolean;
     /**
-     * Opt in to the experimental Three.js (WebGL) SmartArt renderer for
-     * `smartArt` elements, in place of the default SVG renderer. Requires the
-     * optional `three` peer dependency; when it is unavailable, or a diagram
-     * has no renderable nodes, or the WebGL mount fails, the SVG renderer is
-     * used automatically. Default false.
+     * Opt in to the Three.js (WebGL) SmartArt renderer for `smartArt` elements,
+     * in place of the default SVG renderer. Requires the optional `three` peer
+     * dependency; when it is unavailable, or a diagram has no renderable nodes,
+     * or the WebGL mount fails, the SVG renderer is used automatically. Default
+     * false.
      */
     smartArt3D?: boolean;
     /**
@@ -192,6 +194,15 @@ export interface PowerPointViewerProps {
         userName?: string;
         serverUrl?: string;
     };
+    /**
+     * Optional AI assistant configuration. When provided, a Sparkles toggle
+     * appears in the ribbon's command row and opens a right-side chat panel that
+     * can read the open deck and propose edits through the viewer's undo history.
+     * The panel (and the optional `@ai-sdk/svelte` + `ai` peers it needs) is
+     * lazily loaded only when first opened; leaving this undefined ships no AI UI
+     * and never pulls the SDK. See `pptx-viewer-shared/ai`'s `PptxAiConfig`.
+     */
+    ai?: PptxAiConfig;
 }
 /**
  * Imperative editing API exposed on the `<PowerPointViewer>` component

package/dist/viewer/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/viewer/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/viewer/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EACX,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,MAAM,UAAU,CAAC;AAElB;;;;;;;;;GASG;AACH,YAAY,EACX,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,WAAW,GACX,CAAC;AACF,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAChC,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,UAAU,EAAE,UAAU,CAAC;CACvB;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACrC,6DAA6D;IAC7D,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IACpD,8DAA8D;IAC9D,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,iGAAiG;IACjG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sGAAsG;IACtG,eAAe,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oMAAoM;IACpM,gBAAgB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C;;;OAGG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,2DAA2D;IAC3D,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACnD,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACzC;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC7D,gDAAgD;IAChD,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E;;;;;;;OAOG;IACH,EAAE,CAAC,EAAE,YAAY,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC/D,oCAAoC;IACpC,IAAI,IAAI,IAAI,CAAC;IACb,iCAAiC;IACjC,IAAI,IAAI,IAAI,CAAC;IACb,kEAAkE;IAClE,OAAO,IAAI,OAAO,CAAC;IACnB,iEAAiE;IACjE,OAAO,IAAI,OAAO,CAAC;IACnB,oEAAoE;IACpE,cAAc,IAAI,IAAI,CAAC;IACvB,kDAAkD;IAClD,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAAC;IACtC,yEAAyE;IACzE,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,uEAAuE;IACvE,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C;;;;OAIG;IACH,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,2DAA2D;IAC3D,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD;;;OAGG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD;;;;;OAKG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD"}