ooxml-ui 0.30.1 → 0.31.0

package/dist/pptx/ai/change-diff.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Structured element-level diff for AI change animations. Given the deck's
+ * slides before and after an AI edit, {@link diffChangedElements} returns a flat
+ * list of what changed per element (added / removed / moved / resized /
+ * restyled / text), with the old and new bounds where relevant. A binding turns
+ * that list into on-canvas motion (glide old->new, fade/scale in-out) plus a
+ * glow-pulse highlight, so the user watches the edit happen.
+ *
+ * Pure and framework-agnostic: no DOM, no timing. The animator
+ * ({@link createAiChangeAnimator}) owns timing; the binding owns rendering.
+ */
+import type { PptxSlide } from 'ooxml-core/pptx';
+/** What kind of change an element underwent. */
+export type AiChangeKind = 'added' | 'removed' | 'moved' | 'resized' | 'restyled' | 'text';
+/** Axis-aligned bounds in slide (CSS pixel) coordinates. */
+export interface AiChangeBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** One element's change, with old/new bounds for motion. */
+export interface AiElementChange {
+    slideIndex: number;
+    elementId: string;
+    kind: AiChangeKind;
+    /** Bounds before the edit (present for removed / moved / resized). */
+    from?: AiChangeBounds;
+    /** Bounds after the edit (present for added / moved / resized / restyled / text). */
+    to?: AiChangeBounds;
+}
+/**
+ * Diff two slide arrays into per-element changes. Slides are matched by id (then
+ * falls back to index), elements by id. Returns an empty array when nothing an
+ * animation would show changed.
+ */
+export declare function diffChangedElements(before: PptxSlide[], after: PptxSlide[]): AiElementChange[];
+//# sourceMappingURL=change-diff.d.ts.map

package/dist/pptx/ai/change-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-diff.d.ts","sourceRoot":"","sources":["../../../src/pptx/ai/change-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE9D,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAE3F,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,sEAAsE;IACtE,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,qFAAqF;IACrF,EAAE,CAAC,EAAE,cAAc,CAAC;CACpB;AAkDD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,eAAe,EAAE,CAkC9F"}

package/dist/pptx/ai/chat-history-controller.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Framework-free chat-history controller for the AI panel, mirroring the React
+ * binding's `useAiHistory` semantics for the other bindings (Vue / Angular /
+ * Svelte / Vanilla). It debounce-saves the running transcript under a per-deck
+ * id via the shared {@link createChatHistoryStore}, lists prior chats, and
+ * swaps the active transcript when the user resumes / starts / clears a chat.
+ *
+ * The transcript itself is owned by the binding's chat engine; this controller
+ * only reads it through `getMessages` and drives `setMessages`, so switching
+ * chats stays clean. Bindings call {@link AiChatHistoryController.notifyMessagesChanged}
+ * whenever the transcript changes (a watcher / effect / subscribe callback).
+ */
+import type { PptxAiBridge } from './bridge.js';
+import type { PptxAiChatStore, PptxAiChatSummary } from './chat-history-store.js';
+import type { PptxAiUIMessage } from './config.js';
+/** Fresh chat id (matches the React binding's format). */
+export declare function newChatId(): string;
+/** First user message text -> a short chat title (empty when none yet). */
+export declare function deriveChatTitle(messages: readonly PptxAiUIMessage[]): string;
+/**
+ * Derive a stable-ish per-deck id for scoping saved chats. There is no true
+ * document id available to the viewer, so we combine the deck title (file name /
+ * first-slide title) with the slide count; good enough to keep one deck's chats
+ * grouped without colliding across obviously-different decks.
+ */
+export declare function deckIdFromBridge(bridge: PptxAiBridge): string;
+export interface AiChatHistoryControllerDeps {
+    /** Deck the chats are scoped to (see {@link deckIdFromBridge}). */
+    deckId: string;
+    /** Injectable for tests; defaults to the shared IndexedDB-first store. */
+    store?: PptxAiChatStore;
+    /** Read the live transcript from the binding's chat engine. */
+    getMessages(): PptxAiUIMessage[];
+    /** Replace the transcript in the binding's chat engine. */
+    setMessages(messages: PptxAiUIMessage[]): void;
+    /** Notified whenever the saved-chat list changes (initial load included). */
+    onChatsChanged?(chats: PptxAiChatSummary[]): void;
+    /** Title used when the transcript has no user text yet. */
+    untitledLabel?: string;
+}
+export interface AiChatHistoryController {
+    /** The saved chats for this deck, newest first (latest known snapshot). */
+    chats(): PptxAiChatSummary[];
+    /** Id the running transcript is (or will be) saved under. */
+    activeChatId(): string;
+    /** Re-list the saved chats from the store. */
+    refresh(): Promise<void>;
+    /** Debounced (800ms) save of the current transcript; empty transcripts are skipped. */
+    notifyMessagesChanged(): void;
+    /** Start a fresh chat: new id, cleared transcript. */
+    newChat(): void;
+    /** Load a stored chat and swap it in as the active transcript. */
+    resumeChat(id: string): Promise<void>;
+    /** Delete a stored chat (clearing the transcript when it is the active one). */
+    deleteChat(id: string): Promise<void>;
+    /** Clear the running transcript, keeping the active chat id. */
+    clearCurrent(): void;
+    /** Cancel any pending debounced save and stop notifying. */
+    dispose(): void;
+}
+/** Create a chat-history controller. Lists the deck's chats immediately. */
+export declare function createAiChatHistoryController(deps: AiChatHistoryControllerDeps): AiChatHistoryController;
+//# sourceMappingURL=chat-history-controller.d.ts.map

package/dist/pptx/ai/chat-history-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-history-controller.d.ts","sourceRoot":"","sources":["../../../src/pptx/ai/chat-history-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAKhD,0DAA0D;AAC1D,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAe5E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAI7D;AAED,MAAM,WAAW,2BAA2B;IAC3C,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,+DAA+D;IAC/D,WAAW,IAAI,eAAe,EAAE,CAAC;IACjC,2DAA2D;IAC3D,WAAW,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAC/C,6EAA6E;IAC7E,cAAc,CAAC,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IAClD,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACvC,2EAA2E;IAC3E,KAAK,IAAI,iBAAiB,EAAE,CAAC;IAC7B,6DAA6D;IAC7D,YAAY,IAAI,MAAM,CAAC;IACvB,8CAA8C;IAC9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,uFAAuF;IACvF,qBAAqB,IAAI,IAAI,CAAC;IAC9B,sDAAsD;IACtD,OAAO,IAAI,IAAI,CAAC;IAChB,kEAAkE;IAClE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,gFAAgF;IAChF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,gEAAgE;IAChE,YAAY,IAAI,IAAI,CAAC;IACrB,4DAA4D;IAC5D,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAC5C,IAAI,EAAE,2BAA2B,GAC/B,uBAAuB,CA6FzB"}

package/dist/pptx/ai/chat-history-idb.d.ts

@@ -0,0 +1,20 @@
+/**
+ * IndexedDB backend for {@link createChatHistoryStore}. Kept in its own module
+ * so the localStorage fallback and the public factory stay within the per-file
+ * size budget. Uses the raw IndexedDB API with tiny promise wrappers so no new
+ * runtime dependency is pulled in.
+ *
+ * Every browser global is touched lazily from inside a function, never at module
+ * load, so importing this file in a non-DOM environment (Node, SSR) never throws.
+ */
+import type { ChatBackend } from './chat-history-store.js';
+/** Object store holding one record per chat, keyed by `id`. */
+export declare const CHAT_STORE = "chats";
+/**
+ * Open (and if needed create/upgrade) the chat database. Throws when there is no
+ * `indexedDB` global so the caller can transparently fall back to localStorage.
+ */
+export declare function openChatDb(dbName: string): Promise<IDBDatabase>;
+/** Create an IndexedDB-backed {@link ChatBackend}. */
+export declare function createIdbBackend(db: IDBDatabase): ChatBackend;
+//# sourceMappingURL=chat-history-idb.d.ts.map

package/dist/pptx/ai/chat-history-idb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-history-idb.d.ts","sourceRoot":"","sources":["../../../src/pptx/ai/chat-history-idb.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAuC,MAAM,sBAAsB,CAAC;AAG7F,+DAA+D;AAC/D,eAAO,MAAM,UAAU,UAAU,CAAC;AAqBlC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAkB/D;AAeD,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CAwC7D"}

package/dist/pptx/ai/chat-history-store.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Persistent chat-history store for the AI assistant panel.
+ *
+ * The store is IndexedDB-first: {@link createChatHistoryStore} opens IndexedDB
+ * on first use and, when that global is missing or fails to open (private mode,
+ * blocked, or a non-DOM environment), transparently falls back to localStorage.
+ * Both backends expose the identical {@link PptxAiChatStore} surface so callers
+ * never branch on which one is live.
+ *
+ * All browser globals are read lazily from inside methods, so importing this
+ * module in Node (SSR / tests) never throws.
+ */
+import type { PptxAiUIMessage } from './config.js';
+/** A chat conversation persisted for later resumption. */
+export interface PptxAiStoredChat {
+    /** Stable id (also the storage key). */
+    id: string;
+    /** Human-readable title (usually derived from the first user message). */
+    title: string;
+    /** Deck this chat is scoped to, when known. Enables per-deck listing. */
+    deckId?: string;
+    /** Full UI-message transcript. */
+    messages: PptxAiUIMessage[];
+    /** Epoch ms when first saved. */
+    createdAt: number;
+    /** Epoch ms of the most recent save. */
+    updatedAt: number;
+}
+/** Lightweight listing entry (no message bodies) for the history sidebar. */
+export interface PptxAiChatSummary {
+    id: string;
+    title: string;
+    deckId?: string;
+    createdAt: number;
+    updatedAt: number;
+    messageCount: number;
+}
+/** Storage-agnostic chat history API. */
+export interface PptxAiChatStore {
+    /** List chat summaries newest-first, optionally filtered by deck. */
+    listChats(opts?: {
+        deckId?: string;
+    }): Promise<PptxAiChatSummary[]>;
+    /** Load one full chat, or null when it does not exist. */
+    loadChat(id: string): Promise<PptxAiStoredChat | null>;
+    /** Upsert a chat. Always refreshes `updatedAt` (and `createdAt` if unset). */
+    saveChat(chat: PptxAiStoredChat): Promise<void>;
+    /** Delete one chat by id (no-op when absent). */
+    deleteChat(id: string): Promise<void>;
+    /** Delete every chat, or every chat for one deck when `deckId` is given. */
+    clearChats(opts?: {
+        deckId?: string;
+    }): Promise<void>;
+}
+/**
+ * Internal backend contract shared by the IndexedDB and localStorage
+ * implementations. The public store wraps this with opts unwrapping + timestamp
+ * normalisation so both backends behave identically.
+ */
+export interface ChatBackend {
+    list(deckId: string | undefined): Promise<PptxAiChatSummary[]>;
+    load(id: string): Promise<PptxAiStoredChat | null>;
+    save(chat: PptxAiStoredChat): Promise<void>;
+    remove(id: string): Promise<void>;
+    clear(deckId: string | undefined): Promise<void>;
+}
+/** Derive a summary (no message bodies) from a full stored chat. */
+export declare function toChatSummary(chat: PptxAiStoredChat): PptxAiChatSummary;
+/** Create a localStorage-backed {@link ChatBackend} under a key namespace. */
+export declare function createLocalStorageBackend(namespace: string): ChatBackend;
+/**
+ * Create a persistent chat store. IndexedDB is preferred; localStorage is the
+ * transparent fallback. The backend is chosen once, lazily, on the first call.
+ *
+ * @param options.dbName - IndexedDB database name (default `pptx-ai-chats`).
+ * @param options.namespace - localStorage key prefix (default: `dbName`).
+ */
+export declare function createChatHistoryStore(options?: {
+    dbName?: string;
+    namespace?: string;
+}): PptxAiChatStore;
+//# sourceMappingURL=chat-history-store.d.ts.map

package/dist/pptx/ai/chat-history-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-history-store.d.ts","sourceRoot":"","sources":["../../../src/pptx/ai/chat-history-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAChC,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC/B,qEAAqE;IACrE,SAAS,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACpE,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACvD,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,iDAAiD;IACjD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,4EAA4E;IAC5E,UAAU,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC/D,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CASvE;AAkBD,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAyExE;AAaD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,eAAe,CAgClB"}

package/dist/pptx/ai/chat-log-export.d.ts

@@ -0,0 +1,84 @@
+import type { PptxAiChatStore, PptxAiStoredChat } from './chat-history-store.js';
+/** One tool invocation captured with its full technical detail. */
+export interface AiLogToolCall {
+    toolName: string;
+    toolCallId: string;
+    state: string;
+    input: unknown;
+    output: unknown;
+    errorText?: string;
+}
+/** One message: its role, concatenated prose, and any tool calls it made. */
+export interface AiLogMessage {
+    role: string;
+    text: string;
+    toolCalls: AiLogToolCall[];
+}
+/** One chat conversation in export form. */
+export interface AiLogChat {
+    id: string;
+    title: string;
+    deckId?: string;
+    createdAt: number;
+    updatedAt: number;
+    createdAtIso: string;
+    updatedAtIso: string;
+    messageCount: number;
+    messages: AiLogMessage[];
+}
+/** Top-level detailed export document. */
+export interface AiLogExport {
+    format: 'pptx-ai-chat-log';
+    version: 1;
+    exportedAt: string;
+    /** Whether tool inputs/outputs are included (see `detailed` option). */
+    detailed: boolean;
+    chatCount: number;
+    chats: AiLogChat[];
+}
+/** Options controlling how the export document is built. */
+export interface BuildChatLogOptions {
+    /** Include tool-call inputs/outputs. Default `true`. When false, tool calls
+     * still list name + state but omit the (potentially large) payloads. */
+    detailed?: boolean;
+    /** Epoch ms stamped as `exportedAt`. Default `Date.now()`. */
+    now?: number;
+}
+/** Convert one stored chat into its detailed export form. */
+export declare function toLogChat(chat: PptxAiStoredChat, detailed: boolean): AiLogChat;
+/** Build the detailed export document from already-loaded chats (pure). */
+export declare function buildChatLogExport(chats: readonly PptxAiStoredChat[], options?: BuildChatLogOptions): AiLogExport;
+/** Render one tool call as a Markdown bullet (+ fenced JSON when `detailed`). */
+export declare function toolCallLine(call: AiLogToolCall, detailed: boolean): string;
+/** Render the same detailed export as a human-readable Markdown transcript. */
+export declare function buildChatLogMarkdown(doc: AiLogExport): string;
+/** Load every stored chat (newest first) in full detail from a store. */
+export declare function collectStoredChats(store?: PptxAiChatStore): Promise<PptxAiStoredChat[]>;
+/** File format to export. */
+export type AiLogFormat = 'json' | 'markdown';
+/** Metadata controlling {@link exportAiChatLogs}'s output. */
+export interface ExportAiChatLogsMeta {
+    /** `'json'` (default) or `'markdown'`. */
+    format?: AiLogFormat;
+    /** Include tool inputs/outputs. Default `true`. */
+    detailed?: boolean;
+    /** Epoch ms for the filename + `exportedAt`. Default `Date.now()`. */
+    now?: number;
+}
+/**
+ * The DOM-touching part of a chat-log export, injected by the caller so this
+ * module never constructs a `Blob` or references `document`. `content` is the
+ * already-serialized file body (JSON or Markdown text); the binding decides how
+ * to turn it into a download (e.g. wrap in a `Blob` and trigger an anchor click).
+ */
+export type SaveChatLogFile = (filename: string, content: string, mime: string) => void;
+/**
+ * Build the detailed export document from already-loaded chats and hand its
+ * serialized body to `save`. Pure aside from that one injected callback: no
+ * store access, no Blob construction, no DOM.
+ *
+ * @returns the number of chats exported. When `0`, `save` is not called so the
+ *   caller can surface an empty-state message instead.
+ */
+export declare function exportAiChatLogs(chats: readonly PptxAiStoredChat[], meta: ExportAiChatLogsMeta | undefined, save: SaveChatLogFile): number;
+//# sourceMappingURL=chat-log-export.d.ts.map

package/dist/pptx/ai/chat-log-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-log-export.d.ts","sourceRoot":"","sources":["../../../src/pptx/ai/chat-log-export.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG9E,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IACnC;4EACwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAOD,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,GAAG,SAAS,CAoC9E;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAClC,OAAO,CAAC,EAAE,mBAAmB,GAC3B,WAAW,CAWb;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAgB3E;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAiC7D;AAED,yEAAyE;AACzE,wBAAsB,kBAAkB,CACvC,KAAK,GAAE,eAA0C,GAC/C,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAU7B;AAYD,6BAA6B;AAC7B,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9C,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACpC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAExF;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAClC,IAAI,EAAE,oBAAoB,GAAG,SAAS,EACtC,IAAI,EAAE,eAAe,GACnB,MAAM,CAcR"}

package/dist/pptx/ai/config.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Host-facing configuration types for the framework-agnostic AI assistant, plus
+ * {@link resolveChatTransport}, which turns a declarative {@link PptxAiConnection}
+ * into a concrete AI SDK `ChatTransport`.
+ *
+ * All `ai` imports here are type-only; the runtime SDK is threaded in by the
+ * caller (see {@link loadAiSdk}) so this module never forces the optional peer
+ * to be present.
+ */
+import type { ChatTransport, LanguageModel, ToolSet, UIMessage } from 'ai';
+import type { AiChangeAnimationConfig } from './change-animator.js';
+import type { AiSdkModule } from './loader.js';
+/** The UI message shape exchanged with the assistant. Alias of the SDK type. */
+export type PptxAiUIMessage = UIMessage;
+/**
+ * Canonical name of every tool the assistant can call. Document tools mirror the
+ * `pptx-viewer-mcp` server exactly (they ARE the same functions, run against the
+ * live deck); the viewer-only tools (navigation, deck outline, element/notes
+ * readers, table merge) have no MCP counterpart.
+ */
+export type PptxAiToolName = 'get_deck_overview' | 'get_slide' | 'get_element' | 'get_speaker_notes' | 'find_text' | 'get_theme' | 'go_to_slide' | 'select_elements' | 'merge_tables' | 'get_metadata' | 'get_layouts' | 'find_placeholders' | 'get_presentation_properties' | 'run_accessibility_check' | 'convert_to_markdown' | 'export_to_json' | 'add_element' | 'update_element' | 'delete_elements' | 'arrange_elements' | 'clone_element' | 'set_element_animation' | 'group_elements' | 'ungroup_elements' | 'batch_update_elements' | 'update_element_style' | 'replace_geometry' | 'set_element_lock' | 'manage_hyperlinks' | 'replace_text' | 'manage_comments' | 'update_table_cells' | 'manage_table_structure' | 'create_chart' | 'update_chart' | 'add_chart_series' | 'remove_chart_series' | 'update_chart_series_data' | 'manage_smart_art' | 'apply_template' | 'add_slide' | 'duplicate_slide' | 'delete_slides' | 'reorder_slides' | 'update_slide_properties' | 'set_slide_transition' | 'apply_theme_preset' | 'update_theme_colors' | 'update_theme_fonts' | 'set_canvas_size' | 'update_metadata' | 'manage_sections' | 'update_presentation_properties' | 'import_from_json' | 'apply_layout';
+type Resolvable<T> = T | (() => T | Promise<T>);
+/** How the assistant reaches a language model. */
+export type PptxAiConnection = 
+/**
+ * Post messages to a host backend route (recommended for production so the
+ * provider API key stays server-side). Maps to `DefaultChatTransport`.
+ */
+{
+    kind: 'endpoint';
+    api: string;
+    headers?: Resolvable<Record<string, string>>;
+    body?: Resolvable<Record<string, unknown>>;
+    credentials?: RequestCredentials;
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * Run a language model in-process in the browser (bring-your-own key /
+ * local model). Maps to a `ToolLoopAgent` behind a `DirectChatTransport`.
+ */
+ | {
+    kind: 'model';
+    model: LanguageModel;
+    system?: string;
+    maxSteps?: number;
+}
+/** Provide a fully-constructed transport (advanced / testing escape hatch). */
+ | {
+    kind: 'transport';
+    transport: ChatTransport<PptxAiUIMessage>;
+};
+/** How writes proposed by the assistant reach the document. */
+export type PptxAiWritePolicy = 'stage' | 'approve' | 'auto';
+/** Which deck context is fed to the model with each turn. */
+export type PptxAiContextStrategy = 'outline' | 'current-slide' | 'none';
+/** Optional per-session history persistence hooks. */
+export interface PptxAiHistoryHooks {
+    load?(id: string): Promise<PptxAiUIMessage[]>;
+    save?(id: string, messages: PptxAiUIMessage[]): Promise<void>;
+}
+/** Complete host configuration for an AI chat session. */
+export interface PptxAiConfig {
+    connection: PptxAiConnection;
+    /** Extra host instructions appended to the base system prompt. */
+    systemPromptExtras?: string;
+    tools?: {
+        /** Allowlist. When set, only these tools are exposed. */
+        enabled?: PptxAiToolName[];
+        /** Denylist, applied after `enabled`. */
+        disabled?: PptxAiToolName[];
+        /** Additional host-defined tools merged into the tool set. */
+        extra?: ToolSet;
+    };
+    /** Default `'stage'`. */
+    writePolicy?: PptxAiWritePolicy;
+    /** Default `'outline'`. */
+    contextStrategy?: PptxAiContextStrategy;
+    history?: PptxAiHistoryHooks;
+    /**
+     * How AI edits are animated on the canvas so the user can watch them land
+     * (glide old->new, fade/scale in-out, glow-pulse). Omit for the defaults;
+     * set `{ enabled: false }` to turn it off.
+     */
+    changeAnimation?: AiChangeAnimationConfig;
+    onError?(error: Error): void;
+}
+/** Options threaded into {@link resolveChatTransport} by the session builder. */
+export interface ResolveTransportOptions {
+    /** The loaded AI SDK module. */
+    sdk: AiSdkModule;
+    connection: PptxAiConnection;
+    /**
+     * Tool set WITH `execute` implementations, used only by the in-process
+     * `'model'` connection so the agent's tool loop can run locally.
+     */
+    toolsWithExecute?: ToolSet;
+    /** System prompt for the `'model'` connection's agent. */
+    system?: string;
+    /** Max agent tool-loop steps for the `'model'` connection. Default `16`. */
+    maxSteps?: number;
+}
+/**
+ * Resolve a {@link PptxAiConnection} into a concrete AI SDK `ChatTransport`.
+ *
+ * @throws Error when a `'model'` connection is requested but no
+ *   `toolsWithExecute` set was supplied.
+ */
+export declare function resolveChatTransport(options: ResolveTransportOptions): ChatTransport<PptxAiUIMessage>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/pptx/ai/config.d.ts.map

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

package/dist/pptx/ai/context.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Deck-context builders: turn the live deck into compact text the model can
+ * reason over. Two granularities are offered - a whole-deck {@link buildDeckOutline}
+ * and a single-slide {@link buildSlideMarkdown} (via core's PptxMarkdownConverter,
+ * with a rough token budget so a large deck never blows the context window).
+ */
+import type { PptxSlide } from 'ooxml-core/pptx';
+import type { PptxAiDeckMeta } from './bridge.js';
+/** Estimate the token cost of a string. */
+export declare function estimateTokens(text: string): number;
+/** Truncate `text` so it fits within `maxTokens`, appending a marker if cut. */
+export declare function clampToTokenBudget(text: string, maxTokens: number): string;
+/** Best-effort slide title: the first non-empty text on the slide. */
+export declare function slideTitle(slide: PptxSlide): string | undefined;
+/**
+ * Build a compact, whole-deck outline: one line per slide with its title and a
+ * breakdown of element types. Honours an optional slide cap and a token budget.
+ */
+export declare function buildDeckOutline(slides: PptxSlide[], meta: PptxAiDeckMeta, options?: {
+    maxSlides?: number;
+    maxTokens?: number;
+}): string;
+/**
+ * Render a single slide to markdown via the core converter. Falls back to a
+ * plain-text extraction if conversion fails (e.g. an exotic element). Never
+ * writes to disk (uses a null filesystem) and is capped by a token budget.
+ */
+export declare function buildSlideMarkdown(slides: PptxSlide[], slideIndex: number, meta: PptxAiDeckMeta, options?: {
+    includeSpeakerNotes?: boolean;
+    maxTokens?: number;
+}): Promise<string>;
+//# sourceMappingURL=context.d.ts.map

package/dist/pptx/ai/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/pptx/ai/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAA4C,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAY/C,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM1E;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAO/D;AAWD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,SAAS,EAAE,EACnB,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,MAAM,CAgBR;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,SAAS,EAAE,EACnB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACjE,OAAO,CAAC,MAAM,CAAC,CA6BjB"}

package/dist/pptx/ai/deck-data-diff.d.ts

@@ -0,0 +1,18 @@
+/**
+ * deckDataFieldChanged: structural-equality check used by every binding's AI
+ * bridge `applyDeckData()` to decide whether a top-level `PptxData` field
+ * changed before committing it back through the binding's own history/write
+ * path.
+ *
+ * Before this module existed, React, Vue, Angular, Svelte and Vanilla each
+ * declared the identical `const differs = (a, b) => JSON.stringify(a) !==
+ * JSON.stringify(b)` locally inside their `useAiBridge` / `ai-bridge`
+ * modules: a pure helper with no framework imports, duplicated five times
+ * (the exact Rule 2 extraction trigger in CLAUDE.md). Bindings should import
+ * this instead of re-declaring their own copy.
+ *
+ * @module ai/deck-data-diff
+ */
+/** True when `a` and `b` are not structurally (deep-value) equal. */
+export declare function deckDataFieldChanged(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=deck-data-diff.d.ts.map

package/dist/pptx/ai/deck-data-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deck-data-diff.d.ts","sourceRoot":"","sources":["../../../src/pptx/ai/deck-data-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEpE"}

package/dist/pptx/ai/focus-targets.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Pure helpers that turn the live canvas selection into AI "focused targets"
+ * (the slides / elements the assistant should scope its work to) and into the
+ * short chip labels shown in the AI panel.
+ *
+ * Shared by each binding's AI bridge (so `getFocusedTargets` reflects live
+ * selection) and by the panel's focus chips / canvas highlight overlay, so all
+ * five agree on what "the current focus" is and on the two-table merge
+ * shortcut.
+ */
+import type { PptxSlide } from 'ooxml-core/pptx';
+import type { PptxAiFocusedTarget } from './bridge.js';
+/** The selection inputs the focus derivation reads. */
+export interface FocusSelectionInput {
+    activeSlideIndex: number;
+    selectedElementIds: readonly string[];
+    selectedElementId: string | null;
+}
+/** One element ring to draw on the canvas: an explicit pick or a live-tool focus. */
+export interface AiCanvasHighlight {
+    slideIndex: number;
+    elementId: string;
+    /** `pick` = persistent user pick; `active` = transient AI-is-working ring. */
+    variant: 'pick' | 'active';
+}
+/**
+ * Derive focused targets from the live selection: one `element` target per
+ * selected element on the active slide, or a single whole-`slide` target when
+ * nothing is selected. Order and multiplicity are preserved (multi-select and
+ * tables included) so callers can detect e.g. "exactly two tables".
+ */
+export declare function computeFocusTargets(input: FocusSelectionInput): PptxAiFocusedTarget[];
+/** A renderable focus chip. `title` carries the full element id for hover. */
+export interface FocusChip {
+    key: string;
+    label: string;
+    title: string;
+}
+/**
+ * Build display chips for the given targets. Slide targets read `Slide N`;
+ * element targets read `<Type> <n>` (a friendly short label, full id on hover),
+ * or `<Type> (missing)` when the element is no longer on the slide.
+ */
+export declare function focusTargetChips(targets: readonly PptxAiFocusedTarget[], slides: readonly PptxSlide[]): FocusChip[];
+/** Whether the focus is exactly two table elements (drives the merge action). */
+export declare function isTwoTableFocus(targets: readonly PptxAiFocusedTarget[], slides: readonly PptxSlide[]): false | {
+    slideIndex: number;
+    elementIdA: string;
+    elementIdB: string;
+};
+/** Build the directive that fires `merge_tables` without a confirmation round-trip. */
+export declare function mergeTablesDirective(slideIndex: number, elementIdA: string, elementIdB: string): string;
+//# sourceMappingURL=focus-targets.d.ts.map

package/dist/pptx/ai/focus-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-targets.d.ts","sourceRoot":"","sources":["../../../src/pptx/ai/focus-targets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CAYrF;AAaD,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd;AA6BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,MAAM,EAAE,SAAS,SAAS,EAAE,GAC1B,SAAS,EAAE,CAiBb;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAC9B,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,MAAM,EAAE,SAAS,SAAS,EAAE,GAC1B,KAAK,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAexE;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAChB,MAAM,CAKR"}

package/dist/pptx/ai/focused-context.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Focused-target context: when the user scopes the assistant to specific slides
+ * or elements (via {@link PptxAiBridge.getFocusedTargets}), this module turns
+ * those targets into a compact text block the model is told to focus on, and
+ * assembles the full per-turn deck context (the normal {@link PptxAiContextStrategy}
+ * output plus the focus block).
+ */
+import type { PptxAiBridge } from './bridge.js';
+import type { PptxAiContextStrategy } from './config.js';
+/** Tuning knobs for the focus block (all optional, with conservative defaults). */
+export interface FocusedContextOptions {
+    /** Token cap for the entire focus block. Default `1500`. */
+    maxTokens?: number;
+    /** Max table cells rendered per element target before truncation. Default `60`. */
+    maxTableCells?: number;
+}
+/**
+ * Build the focus block for the bridge's current focused targets, or `undefined`
+ * when the bridge exposes no targets (method absent or empty). The block is
+ * prefixed so the model treats these targets as the scope of the request.
+ */
+export declare function buildFocusedTargetsContext(bridge: PptxAiBridge, options?: FocusedContextOptions): string | undefined;
+/**
+ * Assemble the full per-turn deck context: the configured
+ * {@link PptxAiContextStrategy} output (whole-deck outline / current slide /
+ * none) followed by the focused-targets block when the user has scoped the
+ * assistant. Returns an empty string when there is nothing to add.
+ */
+export declare function buildDeckContext(bridge: PptxAiBridge, options: {
+    strategy: PptxAiContextStrategy;
+    maxTokens?: number;
+    focus?: FocusedContextOptions;
+}): Promise<string>;
+//# sourceMappingURL=focused-context.d.ts.map

package/dist/pptx/ai/focused-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focused-context.d.ts","sourceRoot":"","sources":["../../../src/pptx/ai/focused-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,UAAU,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGtD,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACrC,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAkFD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,qBAA0B,GACjC,MAAM,GAAG,SAAS,CAkBpB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE;IACR,QAAQ,EAAE,qBAAqB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC9B,GACC,OAAO,CAAC,MAAM,CAAC,CAoBjB"}