ooxml-ui 0.30.0 → 0.31.0

package/dist/pptx/render/editor-keyboard-focus.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Keep a viewer's keymap live after a canvas gesture.
+ *
+ * A stage pointerdown handler has to call `preventDefault()` (it suppresses the
+ * native drag, the text selection, and the synthetic mouse events a touch would
+ * otherwise emit), but the same call suppresses the focus move the click would
+ * have made. A binding that listens for `keydown` on its own root then never
+ * sees another key: focus is parked on `document.body`, outside the listener,
+ * and every shortcut is silently dead after the most ordinary interaction there
+ * is, clicking a shape.
+ *
+ * Calling {@link armEditorKeyboard} from the gesture handler puts focus back on
+ * the viewer root, which is where a keyboard user lands by tabbing anyway, so
+ * the two paths agree. It is a no-op when focus is already somewhere inside the
+ * viewer, so it cannot steal the caret from an inline text editor or a ribbon
+ * field.
+ *
+ * @module render/editor-keyboard-focus
+ */
+/** A focus target: the viewer root, which every binding renders with a tabindex. */
+export interface EditorKeyboardFocusTarget {
+    contains(other: Node | null): boolean;
+    focus(options?: {
+        preventScroll?: boolean;
+    }): void;
+    readonly ownerDocument: Document | null;
+}
+/**
+ * Ensure the next keystroke is delivered inside `root`.
+ *
+ * Returns true when focus is (now) inside the viewer, false when there was no
+ * root to focus. Focus is only moved when it had fallen outside, so repeated
+ * calls from a pointermove-heavy gesture are free.
+ */
+export declare function armEditorKeyboard(root: EditorKeyboardFocusTarget | null | undefined): boolean;
+/**
+ * Hand the keyboard back to the viewer when an inline editor is about to go
+ * away (a selection-pane rename input, say, committed with Enter or dropped
+ * with Escape).
+ *
+ * {@link armEditorKeyboard} deliberately does nothing while focus is already
+ * inside the viewer, which is exactly the case here: the input still holds
+ * focus at commit time and is removed a tick later, dumping focus on
+ * `document.body`. Every binding that listens for `keydown` on its own root
+ * then goes deaf, so the Ctrl+Z that undoes the edit the user just made is
+ * silently ignored. Call this from the commit/cancel handler, while the
+ * departing node is still in the document.
+ *
+ * The target is the nearest ancestor carrying a `tabindex`, which is the viewer
+ * root in all five bindings. Returns false when there is no such ancestor (the
+ * node is detached, or the host renders a read-only viewer with no tabindex).
+ */
+export declare function restoreEditorKeyboardFocus(from: Element | null | undefined): boolean;
+//# sourceMappingURL=editor-keyboard-focus.d.ts.map

package/dist/pptx/render/editor-keyboard-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-keyboard-focus.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/editor-keyboard-focus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,oFAAoF;AACpF,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC;IACtC,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,aAAa,EAAE,QAAQ,GAAG,IAAI,CAAC;CACxC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAY7F;AAaD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAOpF"}

package/dist/pptx/render/editor-keymap-arrows.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Arrow and paging keys of the editor keymap (`editor-keymap.ts`): the nudge
+ * step an arrow moves a selection by, and when an arrow or paging key moves
+ * between slides instead.
+ *
+ * @module editor-keymap-arrows
+ */
+/**
+ * Slide pixels an unmodified arrow key moves the selection.
+ *
+ * PowerPoint nudges by the smallest unit it can draw, and the ribbon's position
+ * boxes are authored in the same slide-pixel space the renderer lays out in, so
+ * one arrow press must equal one slide pixel or the numbers in the inspector
+ * disagree with what the keyboard does.
+ */
+export declare const NUDGE_SMALL = 1;
+/** Slide pixels a Shift+arrow moves the selection (ten small steps). */
+export declare const NUDGE_LARGE = 10;
+/** Map an arrow key to a nudge delta in slide pixels, or `null` for other keys. */
+export declare function editorNudgeDelta(key: string, large: boolean): {
+    dx: number;
+    dy: number;
+} | null;
+/**
+ * The slide step a key takes in the editor, or `null` when it takes none.
+ *
+ * PageUp / PageDown move between slides in PowerPoint's Normal view even with
+ * a shape selected; they never nudge. With nothing selected every arrow pages
+ * too, as in PowerPoint's thumbnail pane: Left / Up go back, Right / Down go on.
+ * With a selection the arrows nudge it instead (see {@link editorNudgeDelta}).
+ */
+export declare function editorSlideStep(key: string, hasSelection: boolean, withModifier: boolean): 'prevSlide' | 'nextSlide' | null;
+//# sourceMappingURL=editor-keymap-arrows.d.ts.map

package/dist/pptx/render/editor-keymap-arrows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-keymap-arrows.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/editor-keymap-arrows.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,wEAAwE;AACxE,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAc/F;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC9B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,OAAO,EACrB,YAAY,EAAE,OAAO,GACnB,WAAW,GAAG,WAAW,GAAG,IAAI,CAoBlC"}

package/dist/pptx/render/editor-keymap-chords.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The Ctrl/Cmd chord tables for {@link ./editor-keymap}: clipboard/history
+ * (undo, copy, paste, duplicate, group, new slide, ...) and PowerPoint's text
+ * commands (paragraph alignment, font-size ladder, format painter, hyperlink
+ * dialog, clear-character-formatting), plus Ctrl/Cmd+B/I/U.
+ *
+ * Split into its own module purely to keep `editor-keymap.ts` under this
+ * repo's file-size limit; the modules are one logical unit and
+ * `editor-keymap.ts` is where their combined behaviour is documented and
+ * tested.
+ *
+ * @module render/editor-keymap-chords
+ */
+import type { EditorKeyInput, EditorKeyResult } from './editor-keymap.js';
+/**
+ * Resolve a plain Ctrl/Cmd chord (clipboard, history, selection, grouping,
+ * new slide): the commands that stay gated behind `mapEditorKey`'s typing
+ * gate, unlike {@link resolveLiveFormatChord}'s text commands.
+ */
+export declare function resolveChord(key: string, shiftKey: boolean, hasSelection: boolean): EditorKeyResult | null;
+/**
+ * Resolve the Ctrl/Cmd chords that must survive `mapEditorKey`'s typing
+ * gate: paragraph alignment, PowerPoint's font-size ladder, format painter
+ * copy/paste, the hyperlink dialog and clear-character-formatting. Kept
+ * separate from {@link resolveChord} because the caller applies a different,
+ * narrower guard to whatever this returns (see `mapEditorKey`).
+ *
+ * The `>`/`<` cases also match the unshifted `.`/`,` so a layout or synthetic
+ * event that reports the base key (rather than the shifted glyph) still
+ * resolves, as long as `shiftKey` is set; `]`/`[` need no Shift at all,
+ * PowerPoint's second, single-key spelling of the same two commands.
+ */
+export declare function resolveLiveFormatChord(key: string, shiftKey: boolean): EditorKeyResult | null;
+/** A character-level formatting property toggled by Ctrl/Cmd+B/I/U. */
+export type InlineTextFormatProperty = 'bold' | 'italic' | 'underline';
+/**
+ * Resolve Ctrl/Cmd+B/I/U while text is under active edit.
+ *
+ * This is deliberately NOT part of `mapEditorKey`: that map's typing gate
+ * exists precisely to keep shortcuts out of text fields, while
+ * bold/italic/underline are exactly the shortcuts a user reaches for with the
+ * caret already inside a run of text, so a host calls this directly from its
+ * inline text editor's own key handler instead. React, Vue and Angular each
+ * hand-derived this same three-way switch inside their inline text editors;
+ * it lives here once so Svelte, Vanilla and any future binding do not
+ * hand-port it a fourth and fifth time.
+ */
+export declare function mapInlineTextFormatKey(input: EditorKeyInput): InlineTextFormatProperty | null;
+//# sourceMappingURL=editor-keymap-chords.d.ts.map

package/dist/pptx/render/editor-keymap-chords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-keymap-chords.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/editor-keymap-chords.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,OAAO,GACnB,eAAe,GAAG,IAAI,CAwBxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAmC7F;AAMD,uEAAuE;AACvE,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEvE;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,wBAAwB,GAAG,IAAI,CAc7F"}

package/dist/pptx/render/editor-keymap.d.ts

@@ -0,0 +1,91 @@
+/**
+ * The editor keymap: one source of truth for "what does this key do".
+ *
+ * The keymap is the part of the editor a user memorises, so it is also the part
+ * that must be identical in every binding. Before this module each binding
+ * carried its own hand-ported copy (a React `switch`, a Vue matcher table, an
+ * Angular service, two vanilla/Svelte handlers), and they drifted: the nudge
+ * step was 2/20 in two of them and 1/10 in the other three, Ctrl+A existed in
+ * three, Ctrl+G in one, and `?` in one. Key-to-action resolution therefore lives
+ * here, framework-free and unit-testable, and each binding only supplies the
+ * guard state and the callbacks.
+ *
+ * The same drift recurred with Ctrl+F: all five bindings ship a find bar, but
+ * only React and Vue ever hand-wired the chord to open it, so on Angular,
+ * Svelte and Vanilla the shortcut fell through to the browser's own find (which
+ * cannot see text inside the slide model). It is in the map now, which is the
+ * point: a shortcut that is not here is a shortcut three bindings will miss.
+ *
+ * Deliberately NOT here: what "escape" or "toggleShortcuts" then does. Closing a
+ * format painter, an inline editor, a context menu or the help panel is view
+ * state that only the binding owns, so the map stops at naming the action.
+ *
+ * @module render/editor-keymap
+ */
+export { NUDGE_LARGE, NUDGE_SMALL, editorNudgeDelta, editorSlideStep, } from './editor-keymap-arrows.js';
+export { mapInlineTextFormatKey } from './editor-keymap-chords.js';
+export { isEditorControlTarget, isEditorTextInputTarget } from './editor-key-target.js';
+export type { InlineTextFormatProperty } from './editor-keymap-chords.js';
+/** A logical editor command produced by one key press. */
+export type EditorKeyActionName = 'undo' | 'redo' | 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'selectAll' | 'group' | 'ungroup' | 'nudge' | 'prevSlide' | 'nextSlide' | 'escape' | 'find' | 'findReplace' | 'toggleShortcuts' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'increaseFontSize' | 'decreaseFontSize' | 'copyFormat' | 'pasteFormat' | 'newSlide' | 'hyperlink' | 'clearFormatting' | 'cycleSelectionNext' | 'cycleSelectionPrev' | 'pasteSpecial';
+/** Result of resolving one key press; `null` means "not ours, leave it alone". */
+export interface EditorKeyResult {
+    action: EditorKeyActionName | null;
+    /** Horizontal nudge in slide pixels (only set when `action === 'nudge'`). */
+    dx?: number;
+    /** Vertical nudge in slide pixels (only set when `action === 'nudge'`). */
+    dy?: number;
+}
+/** Keyboard event shape consumed by {@link mapEditorKey}. */
+export interface EditorKeyInput {
+    key: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+}
+/** The binding state the keymap gates on. */
+export interface EditorKeyGuard {
+    /** Editing is enabled on the host. */
+    canEdit: boolean;
+    /** A slide show is running; the show keymap owns the keyboard instead. */
+    isPresenting: boolean;
+    /** At least one element is selected. */
+    hasSelection: boolean;
+    /** False leaves paste to the browser/host when no internal paste is available. */
+    canPaste?: boolean;
+    /** An inline text or table-cell editor is open. */
+    isEditingText: boolean;
+    /** A drawing tool other than the selection arrow is armed. */
+    isDrawing: boolean;
+    /** The event originated in an `<input>`, `<textarea>`, `<select>` or contenteditable. */
+    isTextInputTarget: boolean;
+    /**
+     * The event originated on a focusable chrome control (see
+     * `isEditorControlTarget`), where Tab is the browser's focus navigation.
+     */
+    isControlTarget: boolean;
+}
+/**
+ * Resolve one key press to an editor command.
+ *
+ * Order is load-bearing:
+ *  1. the mode gate (no editing while presenting or on a read-only host);
+ *  2. `Escape`, which stays live even mid-edit so it can always cancel;
+ *  3. Ctrl/Cmd+F and Ctrl/Cmd+H, live mid-edit for the same reason (see below);
+ *  4. the live-format chords (alignment, font size, format painter, hyperlink,
+ *     clear formatting), which survive the typing gate but only when the key
+ *     press targets our own text (mid-edit, or a selection with nothing else
+ *     focused) so a foreign input field is never hijacked;
+ *  5. the typing gates, so every other shortcut never fires out of a text field;
+ *  6. `?` and Ctrl/Cmd+`/` (one command, two keys), before the other chords,
+ *     because `?` is a bare printable key;
+ *  7. Delete/Backspace, Tab (selection cycling), chords, arrows.
+ *
+ * Selection-gated commands (copy, cut, duplicate, delete, nudge, group,
+ * ungroup) return `null` with an empty selection rather than firing a no-op, so
+ * the caller does not `preventDefault()` a key it did not act on. Undo, redo,
+ * paste, select-all and the help panel are not selection-gated.
+ */
+export declare function mapEditorKey(input: EditorKeyInput, guard?: Partial<EditorKeyGuard>): EditorKeyResult;
+//# sourceMappingURL=editor-keymap.d.ts.map

package/dist/pptx/render/editor-keymap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-keymap.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/editor-keymap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,EACN,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,eAAe,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACrF,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAUvE,0DAA0D;AAC1D,MAAM,MAAM,mBAAmB,GAC5B,MAAM,GACN,MAAM,GACN,MAAM,GACN,KAAK,GACL,OAAO,GACP,WAAW,GACX,QAAQ,GACR,WAAW,GACX,OAAO,GACP,SAAS,GACT,OAAO,GACP,WAAW,GACX,WAAW,GACX,QAAQ,GACR,MAAM,GACN,aAAa,GACb,iBAAiB,GACjB,WAAW,GACX,aAAa,GACb,YAAY,GACZ,cAAc,GACd,kBAAkB,GAClB,kBAAkB,GAClB,YAAY,GACZ,aAAa,GACb,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,oBAAoB,GACpB,oBAAoB,GACpB,cAAc,CAAC;AAElB,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,6EAA6E;IAC7E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,EAAE,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC9B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,YAAY,EAAE,OAAO,CAAC;IACtB,wCAAwC;IACxC,YAAY,EAAE,OAAO,CAAC;IACtB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,aAAa,EAAE,OAAO,CAAC;IACvB,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB,yFAAyF;IACzF,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;CACzB;AA4BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,cAAc,EACrB,KAAK,GAAE,OAAO,CAAC,cAAc,CAAM,GACjC,eAAe,CA8GjB"}

package/dist/pptx/render/editor-mutations.d.ts

@@ -0,0 +1,3 @@
+export { findSlideElement, mapSlideElements, updateElement, patchElementGeometry, removeElement, duplicateElementOnSlide, cloneSlides, reorderElementOnSlide, appendElementOnSlide, updateSlideNotes, updateSlide, updateAllSlides, } from 'ooxml-core/pptx/editor/render/editor-mutations';
+export type { ElementBoxPatch } from 'ooxml-core/pptx/editor/render/editor-mutations';
+//# sourceMappingURL=editor-mutations.d.ts.map

package/dist/pptx/render/editor-mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-mutations.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/editor-mutations.ts"],"names":[],"mappings":"AACA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,uBAAuB,EACvB,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,eAAe,GACf,MAAM,gDAAgD,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC"}

package/dist/pptx/render/effect-sound-catalogue.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `effect-sound-catalogue`: PowerPoint's built-in stock sound gallery (the 19
+ * entries under Animation "Effect Options... > Sound" and under
+ * "Transitions > Sound"), as pure framework-neutral data.
+ *
+ * Microsoft's own WAV assets (`C:\Program Files\Microsoft Office\root\
+ * Office16\Media\*.WAV`) cannot be redistributed, so `effect-sound-synth.ts`
+ * synthesises a distinct, recognisable placeholder for each entry instead.
+ * What DOES matter for interop is {@link EffectSoundCatalogueEntry.canonicalName}:
+ * COM-verified against real PowerPoint 2016 (2026-09-06,
+ * `Effect.EffectInformation.SoundEffect.ImportFromFile` and
+ * `Slide.SlideShowTransition.SoundEffect.ImportFromFile`), importing one of
+ * PowerPoint's own stock WAVs writes ONLY a relationship plus this exact
+ * upper-case file name into the `@_name` attribute (`p:snd`/`p:sndTgt`).
+ * There is no separate "this is a built-in sound" flag anywhere in the
+ * schema, nor anything PowerPoint itself writes: reopening the ground-truth
+ * file and reading `EffectInformation.SoundEffect.Name`/`.Type` back
+ * confirmed name-matching alone is what PowerPoint's own object model uses.
+ * Writing the same canonical name against our own synthesised bytes is
+ * therefore both necessary and sufficient for PowerPoint to recognise a deck
+ * we saved as carrying that stock sound.
+ *
+ * The 19 names were read directly off a real Office install's MEDIA folder
+ * (`APPLAUSE.WAV` .. `WIND.WAV`) and match PowerPoint's own gallery order
+ * (alphabetical by display name).
+ *
+ * @module render/effect-sound-catalogue
+ */
+/** One entry of PowerPoint's built-in stock sound gallery. */
+export interface EffectSoundCatalogueEntry {
+    /** Stable id used by the picker UI and `effect-sound-synth.ts`'s generator map. */
+    id: string;
+    /** i18n key for the display label, e.g. `pptx.animation.sound.chime`. */
+    i18nKey: string;
+    /** The exact `@_name` PowerPoint writes for this stock sound (COM-verified). */
+    canonicalName: string;
+}
+/** PowerPoint's own stock sound gallery, in its own (alphabetical) order. */
+export declare const EFFECT_SOUND_CATALOGUE: readonly EffectSoundCatalogueEntry[];
+/** Look up a catalogue entry by its stable id. */
+export declare function effectSoundCatalogueEntry(id: string): EffectSoundCatalogueEntry | undefined;
+/**
+ * Match a saved `@_name` (from `p:snd`/`p:sndTgt`, either ours or a genuine
+ * PowerPoint-authored deck's) back to its catalogue entry, tolerant of case
+ * and of a missing `.WAV` extension (some third-party writers omit it).
+ * Returns `undefined` for a custom (non-stock) sound file name.
+ */
+export declare function findEffectSoundCatalogueEntry(name: string | undefined): EffectSoundCatalogueEntry | undefined;
+//# sourceMappingURL=effect-sound-catalogue.d.ts.map

package/dist/pptx/render/effect-sound-catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-sound-catalogue.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/effect-sound-catalogue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,8DAA8D;AAC9D,MAAM,WAAW,yBAAyB;IACzC,mFAAmF;IACnF,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,EAAE,SAAS,yBAAyB,EAwBtE,CAAC;AAOF,kDAAkD;AAClD,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS,CAE3F;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC5C,IAAI,EAAE,MAAM,GAAG,SAAS,GACtB,yBAAyB,GAAG,SAAS,CAWvC"}

package/dist/pptx/render/effect-sound-dsp.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pure, deterministic PCM synthesis primitives for the stock effect-sound
+ * gallery (see `effect-sound-catalogue.ts` / `effect-sound-generators.ts`).
+ *
+ * Every helper is a function of its numeric parameters only: no DOM API, no
+ * `Math.random()`. `noiseAt` replaces `Math.random()` with a deterministic
+ * hash-of-index generator so a noise-based sound (applause, drum roll, ...)
+ * synthesises byte-for-byte identical samples on every run, which is what
+ * `effect-sound-synth.test.ts` asserts.
+ *
+ * @module render/effect-sound-dsp
+ */
+/** Sample rate every stock sound is synthesised at (22.05 kHz mono). */
+export declare const SAMPLE_RATE = 22050;
+/** Number of samples spanning `durationSec` at {@link SAMPLE_RATE}. */
+export declare function samplesFor(durationSec: number): number;
+/** `durationSec` of silence. */
+export declare function silence(durationSec: number): Float32Array;
+/** Deterministic white noise, `seed` selecting a distinct sequence. */
+export declare function whiteNoise(durationSec: number, seed?: number): Float32Array;
+/** One-pole low-pass filter; smaller `alpha` means heavier smoothing. */
+export declare function lowpass(input: Float32Array, alpha: number): Float32Array;
+/** A pure sine tone at `freqHz` for `durationSec`. */
+export declare function sineTone(freqHz: number, durationSec: number, phase?: number): Float32Array;
+/** A linear frequency sweep (chirp) from `freqStartHz` to `freqEndHz`. */
+export declare function sweepTone(freqStartHz: number, freqEndHz: number, durationSec: number): Float32Array;
+/** Exponential decay envelope: 1 at sample 0, decaying toward 0. */
+export declare function decayEnvelope(n: number, decayRate: number): Float32Array;
+/** Linear attack/decay envelope: 0 -> 1 over `attackSec`, then 1 -> 0. */
+export declare function adEnvelope(n: number, attackSec: number): Float32Array;
+/** Element-wise multiply, truncated to the shorter input. */
+export declare function multiply(a: Float32Array, b: Float32Array): Float32Array;
+/** Uniform gain. */
+export declare function scale(a: Float32Array, gain: number): Float32Array;
+/** Sum multiple buffers (mixing), sized to the longest input. */
+export declare function add(...arrays: Float32Array[]): Float32Array;
+/** Sequence buffers end-to-end (splicing, not mixing). */
+export declare function concat(...arrays: Float32Array[]): Float32Array;
+/** Scale so the loudest sample hits `peak` (default 0.9, leaving headroom). */
+export declare function normalize(samples: Float32Array, peak?: number): Float32Array;
+//# sourceMappingURL=effect-sound-dsp.d.ts.map

package/dist/pptx/render/effect-sound-dsp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-sound-dsp.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/effect-sound-dsp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,wEAAwE;AACxE,eAAO,MAAM,WAAW,QAAQ,CAAC;AAQjC,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,gCAAgC;AAChC,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,YAAY,CAOtE;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAQxE;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,YAAY,CAOrF;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CACxB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GACjB,YAAY,CAWd;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAMxE;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAOrE;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,YAAY,CAOvE;AAED,oBAAoB;AACpB,wBAAgB,KAAK,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAMjE;AAED,iEAAiE;AACjE,wBAAgB,GAAG,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAS3D;AAED,0DAA0D;AAC1D,wBAAgB,MAAM,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAS9D;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,SAAM,GAAG,YAAY,CAMzE"}

package/dist/pptx/render/effect-sound-generators.d.ts

@@ -0,0 +1,5 @@
+type EffectSoundGenerator = () => Float32Array;
+/** Sample generator for every catalogue id in `effect-sound-catalogue.ts`. */
+export declare const EFFECT_SOUND_GENERATORS: Readonly<Record<string, EffectSoundGenerator>>;
+export {};
+//# sourceMappingURL=effect-sound-generators.d.ts.map

package/dist/pptx/render/effect-sound-generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-sound-generators.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/effect-sound-generators.ts"],"names":[],"mappings":"AA+EA,KAAK,oBAAoB,GAAG,MAAM,YAAY,CAAC;AAE/C,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAqBlF,CAAC"}

package/dist/pptx/render/effect-sound-synth.d.ts

@@ -0,0 +1,17 @@
+/** A synthesised stock sound, ready to embed or play. */
+export interface EffectSoundAsset {
+    /** Catalogue id, e.g. `"chime"`. */
+    id: string;
+    /** The canonical PowerPoint file name (also the OOXML `@_name` to write). */
+    fileName: string;
+    /** Raw 16-bit mono WAV bytes. */
+    bytes: Uint8Array;
+    /** `data:audio/wav;base64,...` form of {@link bytes}, ready for playback or staging as a pending embed. */
+    dataUrl: string;
+}
+/**
+ * Synthesise (or return the cached synthesis of) the stock sound named by
+ * `id`. Returns `undefined` for an id absent from the catalogue.
+ */
+export declare function getEffectSoundAsset(id: string): EffectSoundAsset | undefined;
+//# sourceMappingURL=effect-sound-synth.d.ts.map

package/dist/pptx/render/effect-sound-synth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-sound-synth.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/effect-sound-synth.ts"],"names":[],"mappings":"AAYA,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAChC,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,KAAK,EAAE,UAAU,CAAC;IAClB,2GAA2G;IAC3G,OAAO,EAAE,MAAM,CAAC;CAChB;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAmB5E"}

package/dist/pptx/render/effect-sound-wav-encoder.d.ts

@@ -0,0 +1,10 @@
+/** Encode float samples (expected range roughly [-1, 1]) as a 16-bit mono WAV file. */
+export declare function encodeWav(samples: Float32Array, sampleRate?: number): Uint8Array;
+/**
+ * Encode bytes as base64 without `Buffer`/`btoa`, for portability across
+ * browser bindings and `packages/core`'s Node-based Vitest environment.
+ */
+export declare function bytesToBase64(bytes: Uint8Array): string;
+/** Wrap WAV bytes in a `data:audio/wav;base64,...` URL. */
+export declare function wavDataUrl(bytes: Uint8Array): string;
+//# sourceMappingURL=effect-sound-wav-encoder.d.ts.map

package/dist/pptx/render/effect-sound-wav-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-sound-wav-encoder.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/effect-sound-wav-encoder.ts"],"names":[],"mappings":"AAgBA,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,GAAE,MAAoB,GAAG,UAAU,CA4B7F;AAUD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAavD;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD"}

package/dist/pptx/render/effects-helpers.d.ts

@@ -0,0 +1,66 @@
+/**
+ * effects-helpers.ts: Pure (no framework) helpers for the effects panel.
+ *
+ * Readers extract effect values from a PptxElement (with sensible defaults),
+ * and patch-builders produce shallow-merge-ready Partial<PptxElement> objects
+ * for the binding's element-update path. Shared across React, Vue, and Angular.
+ *
+ * Outer/inner shadow are split into `effects-shadow-helpers.ts` to keep this
+ * file under the 300-LOC budget; both are re-exported here so a consumer can
+ * still import everything from one module.
+ */
+import type { PptxElement } from 'ooxml-core/pptx';
+import type { InnerShadowState, OuterShadowState } from './effects-shadow-helpers.js';
+export * from './effects-shadow-helpers.js';
+/** Editable glow state. */
+export interface GlowState {
+    enabled: boolean;
+    color: string;
+    radius: number;
+    opacity: number;
+}
+/** Editable reflection state. */
+export interface ReflectionState {
+    enabled: boolean;
+    blurRadius: number;
+    startOpacity: number;
+    endOpacity: number;
+    distance: number;
+    direction: number;
+}
+/** Editable soft-edge (blur) state. */
+export interface SoftEdgeState {
+    enabled: boolean;
+    radius: number;
+}
+/** All effect values collected for the panel. */
+export interface EffectsState {
+    outerShadow: OuterShadowState;
+    innerShadow: InnerShadowState;
+    glow: GlowState;
+    reflection: ReflectionState;
+    softEdge: SoftEdgeState;
+}
+/**
+ * Extract the full EffectsState from an element's shapeStyle.
+ * Falls back to disabled defaults when the element carries no effects or is not
+ * a shape-property element.
+ */
+export declare function effectsStateOf(el: PptxElement): EffectsState;
+/** Enable glow with current or default values. */
+export declare function enableGlowPatch(el: PptxElement, state: GlowState): Partial<PptxElement>;
+/** Disable glow. */
+export declare function disableGlowPatch(el: PptxElement): Partial<PptxElement>;
+/** Update a single glow field. */
+export declare function updateGlowPatch(el: PptxElement, changes: Partial<GlowState>): Partial<PptxElement>;
+/** Enable reflection with current or default values. */
+export declare function enableReflectionPatch(el: PptxElement, state: ReflectionState): Partial<PptxElement>;
+/** Disable reflection. */
+export declare function disableReflectionPatch(el: PptxElement): Partial<PptxElement>;
+/** Update a single reflection field. */
+export declare function updateReflectionPatch(el: PptxElement, changes: Partial<ReflectionState>): Partial<PptxElement>;
+/** Enable soft edge with the given radius. */
+export declare function enableSoftEdgePatch(el: PptxElement, radius: number): Partial<PptxElement>;
+/** Disable soft edge. */
+export declare function disableSoftEdgePatch(el: PptxElement): Partial<PptxElement>;
+//# sourceMappingURL=effects-helpers.d.ts.map

package/dist/pptx/render/effects-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects-helpers.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/effects-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,iBAAiB,CAAC;AAI/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,cAAc,0BAA0B,CAAC;AAEzC,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC5B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,aAAa,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,WAAW,GAAG,YAAY,CAS5D;AAqCD,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAMvF;AAED,oBAAoB;AACpB,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAEtE;AAED,kCAAkC;AAClC,wBAAgB,eAAe,CAC9B,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GACzB,OAAO,CAAC,WAAW,CAAC,CAQtB;AAED,wDAAwD;AACxD,wBAAgB,qBAAqB,CACpC,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,eAAe,GACpB,OAAO,CAAC,WAAW,CAAC,CAQtB;AAED,0BAA0B;AAC1B,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAQ5E;AAED,wCAAwC;AACxC,wBAAgB,qBAAqB,CACpC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAC/B,OAAO,CAAC,WAAW,CAAC,CAItB;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAEzF;AAED,yBAAyB;AACzB,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAE1E"}

package/dist/pptx/render/effects-shadow-helpers.d.ts

@@ -0,0 +1,55 @@
+/**
+ * effects-shadow-helpers.ts: Pure (no framework) outer/inner shadow helpers
+ * for the effects panel.
+ *
+ * Split out of `effects-helpers.ts` (glow/reflection/soft-edge stay there) to
+ * keep both files under this repo's 300-LOC-per-file budget; `EffectsState`
+ * still composes both halves into one shape for the panel.
+ */
+import type { PptxElement, ShapeStyle } from 'ooxml-core/pptx';
+/** Editable outer shadow state. */
+export interface OuterShadowState {
+    enabled: boolean;
+    color: string;
+    opacity: number;
+    blur: number;
+    /** Direction angle in degrees. */
+    angle: number;
+    /** Distance in px. */
+    distance: number;
+    /**
+     * Whether the shadow rotates along with the shape (`a:outerShdw@rotWithShape`).
+     * Defaults `true`, matching PowerPoint's own default when the attribute is
+     * absent.
+     */
+    rotateWithShape: boolean;
+}
+/** Editable inner shadow state. */
+export interface InnerShadowState {
+    enabled: boolean;
+    color: string;
+    opacity: number;
+    blur: number;
+    offsetX: number;
+    offsetY: number;
+}
+/** Extract the current outer-shadow state from a shapeStyle, with defaults. */
+export declare function outerShadowStateOf(ss: ShapeStyle | undefined): OuterShadowState;
+/** Extract the current inner-shadow state from a shapeStyle, with defaults. */
+export declare function innerShadowStateOf(ss: ShapeStyle | undefined): InnerShadowState;
+/** Enable outer shadow with current or default values. */
+export declare function enableOuterShadowPatch(el: PptxElement, state: OuterShadowState): Partial<PptxElement>;
+/** Disable outer shadow by setting transparent. */
+export declare function disableOuterShadowPatch(el: PptxElement): Partial<PptxElement>;
+/**
+ * Update a single outer-shadow field. Re-derives offsetX/Y from angle+distance
+ * when either is changed to keep the coordinate pair consistent.
+ */
+export declare function updateOuterShadowPatch(el: PptxElement, changes: Partial<OuterShadowState>): Partial<PptxElement>;
+/** Enable inner shadow with current or default values. */
+export declare function enableInnerShadowPatch(el: PptxElement, state: InnerShadowState): Partial<PptxElement>;
+/** Disable inner shadow. */
+export declare function disableInnerShadowPatch(el: PptxElement): Partial<PptxElement>;
+/** Update a single inner-shadow field. */
+export declare function updateInnerShadowPatch(el: PptxElement, changes: Partial<InnerShadowState>): Partial<PptxElement>;
+//# sourceMappingURL=effects-shadow-helpers.d.ts.map

package/dist/pptx/render/effects-shadow-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects-shadow-helpers.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/effects-shadow-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG/D,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;CACzB;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAeD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,SAAS,GAAG,gBAAgB,CAS/E;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,SAAS,GAAG,gBAAgB,CAS/E;AAED,0DAA0D;AAC1D,wBAAgB,sBAAsB,CACrC,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,gBAAgB,GACrB,OAAO,CAAC,WAAW,CAAC,CAYtB;AAED,mDAAmD;AACnD,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAE7E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAChC,OAAO,CAAC,WAAW,CAAC,CActB;AAED,0DAA0D;AAC1D,wBAAgB,sBAAsB,CACrC,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,gBAAgB,GACrB,OAAO,CAAC,WAAW,CAAC,CAQtB;AAED,4BAA4B;AAC5B,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAE7E;AAED,0CAA0C;AAC1C,wBAAgB,sBAAsB,CACrC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAChC,OAAO,CAAC,WAAW,CAAC,CAUtB"}

package/dist/pptx/render/element-accessibility-dom.d.ts

@@ -0,0 +1,14 @@
+import type { PptxElement } from 'ooxml-core/pptx';
+/** Options for {@link applyRenderedElementAccessibility}. */
+export interface RenderedElementAccessibilityOptions {
+    /**
+     * True when this stage is a RUNNING slide show, which marks it so
+     * {@link PRESENTATION_HIT_TEST_CSS} can make its scenery pointer-
+     * transparent (only action shapes, media transport and links stay
+     * clickable, exactly as in PowerPoint).
+     */
+    presenting?: boolean;
+}
+/** Apply the shared role and accessible-name model at a rendered stage boundary. */
+export declare function applyRenderedElementAccessibility(stage: ParentNode, elements: readonly PptxElement[], options?: RenderedElementAccessibilityOptions): number;
+//# sourceMappingURL=element-accessibility-dom.d.ts.map

package/dist/pptx/render/element-accessibility-dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-accessibility-dom.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/element-accessibility-dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMnD,6DAA6D;AAC7D,MAAM,WAAW,mCAAmC;IACnD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAaD,oFAAoF;AACpF,wBAAgB,iCAAiC,CAChD,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,OAAO,GAAE,mCAAwC,GAC/C,MAAM,CAiDR"}

package/dist/pptx/render/element-action-affordance-dom.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Paint the on-canvas action affordances (see `element-action-affordance`) at a
+ * rendered stage boundary, for the bindings that cannot paint them inline.
+ *
+ * React renders the badge and the tooltip as JSX children of its element
+ * container, which wraps EVERY element type. The other four bindings do not
+ * wrap: their element renderer dispatches straight to a per-type component
+ * (image, chart, table, media, ole, zoom, ...) whose single root IS the element
+ * node, so there is no shared parent to hang extra children off. Reproducing
+ * the affordance inside all twelve per-type components in each of four bindings
+ * would be forty-odd copies of the same markup, which is precisely the drift
+ * this change exists to remove.
+ *
+ * So the four bindings decorate after render instead, exactly as they already
+ * do for the role / name / `data-pptx-action` half of the element contract
+ * (`applyRenderedElementAccessibility`), and call this alongside it. The pass is
+ * idempotent and re-runs on every slide / element-list change, so a framework
+ * re-render that discards the nodes simply gets them back.
+ *
+ * @module render/element-action-affordance-dom
+ */
+import type { PptxElement } from 'ooxml-core/pptx';
+import type { ActionAffordanceLabels } from './element-action-affordance.js';
+/** Where and with what text to paint the affordances. */
+export interface ElementActionAffordanceDomOptions {
+    /** The live editing canvas is showing these elements. */
+    canInteract: boolean;
+    /** This stage is a running slide show; suppresses everything. */
+    presenting?: boolean;
+    labels: ActionAffordanceLabels;
+}
+/**
+ * Paint / refresh / remove the action affordances for every top-level element
+ * on `stage`, returning how many elements ended up carrying one.
+ *
+ * Group CHILDREN are deliberately not decorated: PowerPoint treats a group as
+ * one object, the click resolves up to it (`resolveTopLevelElementId`), and
+ * React badges only its top-level container. A grouped child's own action is
+ * still followed, and still announced, it just does not get its own badge.
+ */
+export declare function applyElementActionAffordances(stage: ParentNode, elements: readonly PptxElement[], options: ElementActionAffordanceDomOptions): number;
+//# sourceMappingURL=element-action-affordance-dom.d.ts.map

package/dist/pptx/render/element-action-affordance-dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-action-affordance-dom.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/element-action-affordance-dom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAcnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAO1E,yDAAyD;AACzD,MAAM,WAAW,iCAAiC;IACjD,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,sBAAsB,CAAC;CAC/B;AA0ED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,OAAO,EAAE,iCAAiC,GACxC,MAAM,CAiDR"}