ooxml-ui 0.30.0 → 0.31.0

package/dist/pptx/render/title-bar-state.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Shared model for the title bar and quick-access strip (`pptx-ui-title-bar`).
+ *
+ * Five bindings hand-built this row and drifted on gating, ordering, tooltips
+ * and icons (#394). The element owns the markup and the rules below; hosts own
+ * every effect (saving, history, command dispatch, Find & Replace).
+ *
+ * Decisions, applied identically everywhere:
+ * - Order: Save, Undo, Redo (catalog order, each individually gated), then the
+ *   other configured commands in the order File > Options lists them.
+ * - Gating: AutoSave, strip, status and search show only while `editing`;
+ *   the strip also needs `quickAccess.visible`. `showSave` hides Save, and
+ *   `showUndo`/`showRedo` hide those two (host `hiddenActions`).
+ * - Tooltip: every strip button has `aria-label` = its label and `title` =
+ *   `screenTip(tooltip)`; Undo/Redo name the pending action when known.
+ * - Placement: `titleBar` renders the whole row (the extras only while the
+ *   position is `above`); `belowRibbon` renders just the extras row.
+ */
+import type { CommandSearchEntry } from './command-search.js';
+import type { QuickAccessPosition } from './options/viewer-options.js';
+import type { TitleBarAutosaveState } from './title-bar.js';
+import type { ToolbarActionId } from './toolbar-actions.js';
+export type TitleBarTranslate = (key: string, params?: Record<string, string | number>) => string;
+export type TitleBarPlacement = 'titleBar' | 'belowRibbon';
+export type TitleBarTone = 'idle' | 'saving' | 'error';
+/** Identifier of a strip button. Catalog ids; Save, Undo and Redo are dedicated. */
+export type TitleBarCommandId = string;
+export interface TitleBarAutosaveView {
+    enabled: boolean;
+    /** Default true. False renders the switch inert (host policy `autosave: false`). */
+    toggleAvailable?: boolean;
+    /** Translation key from `resolveTitleBarStatusKey`. */
+    statusKey: string;
+    /** Colour of the status text; only meaningful while `enabled`. */
+    tone?: TitleBarTone;
+}
+export interface TitleBarHistoryState {
+    canUndo: boolean;
+    canRedo: boolean;
+    /** Description of the pending action, e.g. "Delete shape". */
+    undoLabel?: string | null;
+    redoLabel?: string | null;
+    /** Default true. Maps to `hiddenActions: ['undo']`. */
+    showUndo?: boolean;
+    /** Default true. Maps to `hiddenActions: ['redo']`. */
+    showRedo?: boolean;
+}
+export interface TitleBarQuickAccessView {
+    visible: boolean;
+    position: QuickAccessPosition;
+    showCommandLabels: boolean;
+    /** Ordered catalog ids (File > Options > Quick Access Toolbar). */
+    commandIds: readonly string[];
+}
+export interface TitleBarViewState {
+    /** Edit mode with an editable deck. Gates AutoSave, the strip, status and search. */
+    editing: boolean;
+    /** Whether the command search shows; hosts pass `editing`. */
+    searchVisible: boolean;
+    /** Display name; the translated default shows when empty. */
+    fileName?: string;
+    autosave: TitleBarAutosaveView;
+    history: TitleBarHistoryState;
+    /** Default true. */
+    showSave?: boolean;
+    quickAccess: TitleBarQuickAccessView;
+    /** Search catalogue; defaults to the shared `COMMAND_SEARCH_ENTRIES`. */
+    commands?: readonly CommandSearchEntry[];
+    /** Default true. False drops the "Find in Slides" fallback row. */
+    contentSearch?: boolean;
+    /** ScreenTip rule (Options > General); returning undefined suppresses the title. */
+    screenTip?: (label: string) => string | undefined;
+    translate?: TitleBarTranslate;
+}
+/** Detail of `command-search`: a chosen catalogue command, or content search. */
+export interface TitleBarSearchDetail {
+    query: string;
+    /** Present when a catalogue command was chosen; absent means "search content". */
+    command?: string;
+}
+export interface TitleBarEventDetails {
+    'toggle-autosave': null;
+    save: null;
+    undo: null;
+    redo: null;
+    'quick-command': {
+        id: TitleBarCommandId;
+    };
+    'command-search': TitleBarSearchDetail;
+}
+export declare const TITLE_BAR_DEDICATED_IDS: readonly ['save', 'undo', 'redo'];
+/** One resolved strip button, in display order. */
+export interface TitleBarStripItem {
+    id: TitleBarCommandId;
+    icon: string;
+    labelKey: string;
+    dedicated: boolean;
+}
+/**
+ * The strip's buttons for one placement. Unknown ids are dropped and duplicates
+ * collapse, so a stale options file cannot render an unlabeled button.
+ */
+export declare function resolveTitleBarStrip(state: TitleBarViewState, placement: TitleBarPlacement): TitleBarStripItem[];
+/** Tone for the status text from the autosave engine state (idle unless enabled). */
+export declare function titleBarTone(enabled: boolean, state: string | undefined): TitleBarTone;
+/** What every binding already knows; buildTitleBarState turns it into the element state. */
+export interface TitleBarHostInput {
+    /** Edit mode with an editable deck (hosts compute this once). */
+    editing: boolean;
+    fileName?: string;
+    isDirty: boolean;
+    autosaveState?: TitleBarAutosaveState;
+    /** Reason code while autosaveState is 'disabled'. */
+    autosaveReason?: string;
+    autosaveEnabled: boolean;
+    /** Default true; false when the host passed autosave: false. */
+    autosaveToggleAvailable?: boolean;
+    canUndo: boolean;
+    canRedo: boolean;
+    undoLabel?: string | null;
+    redoLabel?: string | null;
+    hiddenActions?: readonly ToolbarActionId[];
+    /** Default true; React hides Save when the host gives no save handler. */
+    showSave?: boolean;
+    quickAccess: TitleBarQuickAccessView;
+    commands?: readonly CommandSearchEntry[];
+    contentSearch?: boolean;
+    screenTip?: (label: string) => string | undefined;
+    translate: TitleBarTranslate;
+}
+/** The one place the title bar's gating table and status rule live. */
+export declare function buildTitleBarState(input: TitleBarHostInput): TitleBarViewState;
+//# sourceMappingURL=title-bar-state.d.ts.map

package/dist/pptx/render/title-bar-state.d.ts.map

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

package/dist/pptx/render/title-bar.d.ts

@@ -0,0 +1,67 @@
+/**
+ * PowerPoint-style title bar: shared pure logic + Tailwind class tokens.
+ *
+ * The title bar is the top chrome row above the ribbon (AutoSave toggle,
+ * quick-access Save/Undo/Redo, file name + save-location status, centred
+ * search box). Every binding (React/Vue/Angular) renders its own thin view
+ * from these tokens so the three stay pixel-identical.
+ */
+/** Lifecycle state of the autosave engine, normalised across bindings. */
+export type TitleBarAutosaveState = 'idle' | 'saving' | 'saved' | 'error' | 'disabled';
+export interface ResolveTitleBarStatusInput {
+    /** Current autosave lifecycle state. */
+    autosaveState: TitleBarAutosaveState;
+    /** Whether the document has unsaved changes. */
+    isDirty: boolean;
+    /** Whether the AutoSave toggle is on. */
+    autosaveEnabled: boolean;
+    /** When autosaveState is 'disabled', the reason code. */
+    disabledReason?: string;
+}
+/**
+ * Resolve the i18n key for the save-status text shown next to the file name
+ * (PowerPoint shows "Saved to this PC" there).
+ */
+export declare function resolveTitleBarStatusKey(input: ResolveTitleBarStatusInput): string;
+/** Default document name shown when the host supplies no file name. */
+export declare const TITLE_BAR_DEFAULT_FILE_KEY = "pptx.titleBar.defaultFileName";
+export declare const TITLE_BAR_CLASSES: {
+    /** Outer row container. Hidden on mobile (the compact toolbar covers it). */
+    readonly container: 'flex items-center gap-1 h-9 px-2 border-b border-border/60 bg-secondary/80 text-[11px] select-none max-md:hidden';
+    /** Small square app mark on the far left. */
+    readonly logo: 'flex items-center justify-center w-5 h-5 rounded-sm bg-[#c43e1c] text-white text-[10px] font-bold shrink-0';
+    /** Wrapper for the AutoSave label + switch. */
+    readonly autosaveGroup: 'flex items-center gap-1.5 pl-1.5 pr-0.5 shrink-0';
+    readonly autosaveLabel: 'text-[11px] text-muted-foreground whitespace-nowrap';
+    /** Switch track, base classes; combine with on/off variant. */
+    readonly toggleTrack: 'relative inline-flex items-center w-7 h-3.5 rounded-full transition-colors cursor-pointer disabled:opacity-40 disabled:cursor-not-allowed';
+    readonly toggleTrackOn: 'bg-primary';
+    readonly toggleTrackOff: 'bg-muted-foreground/40';
+    /** Switch knob, base classes; combine with on/off variant. */
+    readonly toggleKnob: 'absolute w-2.5 h-2.5 rounded-full bg-white shadow-sm transition-transform';
+    readonly toggleKnobOn: 'translate-x-[15px]';
+    readonly toggleKnobOff: 'translate-x-0.5';
+    /** Quick-access icon button (Save / Undo / Redo). */
+    readonly quickButton: 'p-1 rounded-sm transition-colors hover:bg-accent/60 text-muted-foreground disabled:opacity-40 disabled:cursor-not-allowed active:scale-90 active:opacity-70';
+    readonly separator: 'w-px h-4 bg-border/60 mx-1 shrink-0';
+    /** File name + status wrapper (centred block in PowerPoint sits left of search). */
+    readonly fileGroup: 'flex items-baseline gap-1.5 px-1 min-w-0 shrink';
+    readonly fileName: 'text-[12px] font-medium text-foreground whitespace-nowrap overflow-hidden text-ellipsis max-w-[240px]';
+    readonly statusDot: 'text-muted-foreground/70';
+    readonly statusText: 'text-[11px] text-muted-foreground whitespace-nowrap';
+    readonly statusError: 'text-red-400';
+    readonly statusSaving: 'text-yellow-500';
+    /** Centred search area. */
+    readonly searchWrap: 'flex-1 flex justify-center min-w-0 px-2';
+    readonly searchBox: 'flex items-center gap-2 w-full max-w-md px-3 py-[3px] rounded-md bg-background/70 border border-border/60 text-muted-foreground hover:bg-background hover:text-foreground focus-within:border-ring transition-colors';
+    readonly searchIcon: 'w-3 h-3 shrink-0';
+    readonly searchLabel: 'text-[11px] truncate';
+    /** Right-hand spacer mirroring the left block so search stays centred. */
+    readonly rightSpacer: 'flex items-center justify-end gap-1 shrink-0';
+};
+/** Ribbon tab-row right-side actions (Record + Share live on the tab row). */
+export declare const TAB_ROW_ACTION_CLASSES: {
+    readonly record: 'inline-flex items-center gap-1.5 px-2.5 py-1 mr-1 rounded-sm text-[11px] font-medium text-foreground hover:bg-accent/60 transition-colors whitespace-nowrap';
+    readonly recordDot: 'w-2 h-2 rounded-full bg-red-600 shrink-0';
+};
+//# sourceMappingURL=title-bar.d.ts.map

package/dist/pptx/render/title-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-bar.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/title-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,0EAA0E;AAC1E,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvF,MAAM,WAAW,0BAA0B;IAC1C,wCAAwC;IACxC,aAAa,EAAE,qBAAqB,CAAC;IACrC,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,eAAe,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAqBlF;AAED,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,kCAAkC,CAAC;AAM1E,eAAO,MAAM,iBAAiB;IAC7B,6EAA6E;aAC7E,SAAS,EACR,kHAAkH;IACnH,6CAA6C;aAC7C,IAAI,EAAE,4GAA4G;IAClH,+CAA+C;aAC/C,aAAa,EAAE,kDAAkD;aACjE,aAAa,EAAE,qDAAqD;IACpE,+DAA+D;aAC/D,WAAW,EACV,2IAA2I;aAC5I,aAAa,EAAE,YAAY;aAC3B,cAAc,EAAE,wBAAwB;IACxC,8DAA8D;aAC9D,UAAU,EAAE,2EAA2E;aACvF,YAAY,EAAE,oBAAoB;aAClC,aAAa,EAAE,iBAAiB;IAChC,qDAAqD;aACrD,WAAW,EACV,6JAA6J;aAC9J,SAAS,EAAE,qCAAqC;IAChD,oFAAoF;aACpF,SAAS,EAAE,iDAAiD;aAC5D,QAAQ,EACP,uGAAuG;aACxG,SAAS,EAAE,0BAA0B;aACrC,UAAU,EAAE,qDAAqD;aACjE,WAAW,EAAE,cAAc;aAC3B,YAAY,EAAE,iBAAiB;IAC/B,2BAA2B;aAC3B,UAAU,EAAE,yCAAyC;aACrD,SAAS,EACR,sNAAsN;aACvN,UAAU,EAAE,kBAAkB;aAC9B,WAAW,EAAE,sBAAsB;IACnC,0EAA0E;aAC1E,WAAW,EAAE,8CAA8C;CAClD,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB;aAClC,MAAM,EACL,6JAA6J;aAC9J,SAAS,EAAE,0CAA0C;CAC5C,CAAC"}

package/dist/pptx/render/toolbar-actions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Toolbar action / ribbon-tab visibility: a single, framework-agnostic
+ * catalogue of every top-level toolbar button and ribbon tab a host app can
+ * independently hide. Each binding exposes a `hiddenActions?: ToolbarActionId[]`
+ * prop, threads it down to the relevant render sites, and gates them with
+ * `isActionHidden`. Default (`undefined` / `[]`) hides nothing, matching
+ * today's always-visible behaviour.
+ *
+ * `TOOLBAR_TABS` is also the canonical ribbon-tab list/order, replacing the
+ * copy hand-duplicated in each binding (React's `TOOLBAR_SECTIONS`, Vue's
+ * `ribbon-constants.ts`, Angular's `RIBBON_TABS`, etc.) so the tab set can't
+ * drift between bindings. Per-tab icons stay in each binding (icon libraries
+ * differ per framework); only id + i18n key + order are shared here.
+ */
+/**
+ * A single toolbar button/control that can be hidden independently of the
+ * ribbon tab it may also appear inside. `zoom` and `navigation` each cover a
+ * whole control cluster (zoom in/out/fit, prev/next) rather than each button
+ * in it, matching how hosts actually want to hide/keep them as a unit.
+ */
+export type ToolbarButtonId = 'share' | 'broadcast' | 'export' | 'undo' | 'redo' | 'record' | 'notes' | 'fullscreen' | 'zoom' | 'navigation' | 'mergeShapes' | 'crop';
+/** A top-level ribbon tab. `record` intentionally shares its id with the quick-access Record button above: both surface the same recording feature, so hiding one hides the other. */
+export type ToolbarTabId = 'file' | 'home' | 'insert' | 'draw' | 'design' | 'transitions' | 'animations' | 'slideShow' | 'record' | 'review' | 'view' | 'help';
+export type ToolbarActionId = ToolbarButtonId | ToolbarTabId;
+/**
+ * PowerPoint's contextual tabs: they join the tab row only while the
+ * selection is of their kind (see `contextualTabsForElement` in
+ * `ribbon-galleries/`). Kept apart from `ToolbarTabId` because they are not
+ * part of the fixed tab order every binding renders.
+ */
+export type RibbonContextualTabId = 'shapeFormat' | 'pictureFormat' | 'tableDesign' | 'chartDesign' | 'smartArtDesign';
+export interface RibbonContextualTabDefinition {
+    id: RibbonContextualTabId;
+    labelKey: string;
+}
+/** The contextual tabs, in the order PowerPoint appends them. */
+export declare const RIBBON_CONTEXTUAL_TABS: readonly RibbonContextualTabDefinition[];
+export interface ToolbarTabDefinition {
+    id: ToolbarTabId;
+    labelKey: string;
+}
+export declare const TOOLBAR_TABS: ToolbarTabDefinition[];
+/** True when `id` is present in the host's `hiddenActions` list. */
+export declare function isActionHidden(id: ToolbarActionId, hiddenActions: readonly ToolbarActionId[] | undefined): boolean;
+/** Filters a ribbon-tab list down to the ones the host hasn't hidden. */
+export declare function filterVisibleTabs<T extends {
+    id: ToolbarTabId;
+}>(tabs: readonly T[], hiddenActions: readonly ToolbarActionId[] | undefined): T[];
+//# sourceMappingURL=toolbar-actions.d.ts.map

package/dist/pptx/render/toolbar-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar-actions.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/toolbar-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACxB,OAAO,GACP,WAAW,GACX,QAAQ,GACR,MAAM,GACN,MAAM,GACN,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,aAAa,GACb,MAAM,CAAC;AAEV,sLAAsL;AACtL,MAAM,MAAM,YAAY,GACrB,MAAM,GACN,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,CAAC;AAEV,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,YAAY,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAC9B,aAAa,GACb,eAAe,GACf,aAAa,GACb,aAAa,GACb,gBAAgB,CAAC;AAEpB,MAAM,WAAW,6BAA6B;IAC7C,EAAE,EAAE,qBAAqB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,EAAE,SAAS,6BAA6B,EAM1E,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,YAAY,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,YAAY,EAAE,oBAAoB,EAa9C,CAAC;AAEF,oEAAoE;AACpE,wBAAgB,cAAc,CAC7B,EAAE,EAAE,eAAe,EACnB,aAAa,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GACnD,OAAO,CAET;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,YAAY,CAAA;CAAE,EAC/D,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,aAAa,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GACnD,CAAC,EAAE,CAKL"}

package/dist/pptx/render/touch-gestures.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Framework-agnostic touch-gesture state machine for the viewer canvas.
+ *
+ * Recognises three gestures from raw DOM `TouchEvent`s and emits callbacks:
+ *   - Pinch-to-zoom: two-finger spread/pinch, scaled by the distance ratio.
+ *   - Swipe: single-finger horizontal swipe (slide navigation).
+ *   - Long-press: single-finger hold (context-menu trigger).
+ *
+ * The recogniser holds all mutable pinch/swipe/long-press state internally and
+ * exposes four event handlers plus a `cancel()`. The listener attach/detach
+ * lifecycle (and any framework reactivity) stays in each binding; only this
+ * pure state machine is shared.
+ *
+ * @module touch-gestures
+ */
+/** The minimum horizontal distance (px) to recognise a swipe. */
+export declare const SWIPE_THRESHOLD_PX = 50;
+/** Maximum vertical deviation (px) for a swipe to still count. */
+export declare const SWIPE_MAX_VERTICAL_PX = 100;
+/** The hold duration (ms) for a long-press. */
+export declare const LONG_PRESS_DURATION_MS = 500;
+/** If the finger moves more than this (px) during a hold, cancel the long-press. */
+export declare const LONG_PRESS_MOVE_TOLERANCE_PX = 10;
+/** The subset of a DOM `Touch` this state machine reads. */
+export interface TouchPoint {
+    readonly clientX: number;
+    readonly clientY: number;
+}
+/** The subset of a DOM `TouchEvent` this state machine reads. */
+export interface TouchEventLike {
+    readonly touches: ArrayLike<TouchPoint>;
+    readonly changedTouches: ArrayLike<TouchPoint>;
+    readonly preventDefault: () => void;
+}
+/** Compute the Euclidean distance between two touch points. */
+export declare function getTouchDistance(t1: TouchPoint, t2: TouchPoint): number;
+/**
+ * Clamp a scale value into the allowed zoom range. The bounds are parameters
+ * (not imported constants) to keep this module framework- and binding-agnostic.
+ */
+export declare function clampScale(value: number, minScale: number, maxScale: number): number;
+export interface TouchGestureCallbacks {
+    /** Called continuously during a pinch gesture with the new (clamped) scale. */
+    onPinchZoom?: (newScale: number) => void;
+    /** Called when a horizontal swipe is detected. direction: -1 = left, 1 = right. */
+    onSwipe?: (direction: -1 | 1) => void;
+    /** Called when a long-press is detected, with the press coordinates. */
+    onLongPress?: (clientX: number, clientY: number) => void;
+}
+export interface TouchGestureConfig {
+    /** Returns the current zoom scale; used as the baseline for pinch gestures. */
+    getScale: () => number;
+    /** Minimum zoom scale for clamping. */
+    minScale: number;
+    /** Maximum zoom scale for clamping. */
+    maxScale: number;
+    /** Gesture-event callbacks. */
+    callbacks: TouchGestureCallbacks;
+}
+export interface TouchGestureRecognizer {
+    readonly onTouchStart: (e: TouchEventLike) => void;
+    readonly onTouchMove: (e: TouchEventLike) => void;
+    readonly onTouchEnd: (e: TouchEventLike) => void;
+    readonly onTouchCancel: () => void;
+    /** Cancel any pending long-press timer and reset transient pinch state. */
+    readonly cancel: () => void;
+}
+/**
+ * Create a stateful touch-gesture recogniser. The returned handlers mirror the
+ * React viewer's native `touch*` listeners exactly, including `preventDefault()`
+ * on the pinch path and the `setTimeout`-based long-press timer.
+ */
+export declare function createTouchGestureRecognizer(config: TouchGestureConfig): TouchGestureRecognizer;
+//# sourceMappingURL=touch-gestures.d.ts.map

package/dist/pptx/render/touch-gestures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touch-gestures.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/touch-gestures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,kEAAkE;AAClE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,+CAA+C;AAC/C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,oFAAoF;AACpF,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAM/C,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;CACpC;AAMD,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,MAAM,CAIvE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpF;AAMD,MAAM,WAAW,qBAAqB;IACrC,+EAA+E;IAC/E,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,mFAAmF;IACnF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IACtC,wEAAwE;IACxE,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,kBAAkB;IAClC,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,SAAS,EAAE,qBAAqB,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC5B;AAMD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,kBAAkB,GAAG,sBAAsB,CAuH/F"}

package/dist/pptx/render/transition-preview.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `transition-preview` - Transitions > Preview, as one behaviour every binding
+ * calls instead of five different non-behaviours.
+ *
+ * WHY shared, and why it does not simply re-commit the transition: the button
+ * was a no-op in vanilla, started the whole slide show in angular, and in
+ * react/vue/svelte re-committed the slide's OWN transition, which writes the
+ * values the slide already had. That last one is a no-op the user can see
+ * nothing of, and no assertion can tell it apart from the vanilla version. What
+ * PowerPoint's Preview does is REPLAY the transition on the slide being edited,
+ * without touching the deck, so that is what this does.
+ *
+ * The replay is built out of the same `slide-transition-css` animation the
+ * presentation overlay plays, so a preview cannot drift from the real thing.
+ * Two layers are added INSIDE the stage element (never around it: the stage
+ * carries the editor's `transform: scale(...)`, and a CSS animation that
+ * animates `transform` on that element would drop the zoom for the length of
+ * the preview, which is what a first attempt at this did):
+ *
+ *  1. a cover painted with the stage's own background, hiding the slide, and
+ *  2. a static clone of the slide's content, animated with the transition's
+ *     INCOMING animation, so the content arrives exactly as it would in a show.
+ *
+ * Both layers are inert (`aria-hidden`, `pointer-events: none`, and stripped of
+ * the `data-element-id` markers the specs count) and are removed when the
+ * animation ends. While a preview is running the stage carries
+ * `data-pptx-transition-preview="<type>"`, which is the framework-neutral hook
+ * the e2e suite asserts on: a Preview button wired to nothing never sets it.
+ *
+ * @module render/transition-preview
+ */
+import type { PptxSlideTransition } from 'ooxml-core/pptx';
+/** Marks the stage element for as long as a preview is playing. */
+export declare const TRANSITION_PREVIEW_ATTR = "data-pptx-transition-preview";
+/**
+ * The slide the user is editing.
+ *
+ * `aria-roledescription="slide"` is the region marker all five bindings emit
+ * and every framework-neutral spec already selects on; thumbnails reuse it in
+ * some bindings, and all five render the main canvas ahead of the rail, so the
+ * FIRST match is the editing surface.
+ */
+export declare function findSlideStage(doc: Document): HTMLElement | null;
+/**
+ * Replay `transition` on the slide stage. Returns false when there is nothing
+ * to play (no stage, no transition, or an instant one), so a caller can leave
+ * the control inert rather than pretending.
+ */
+export declare function playSlideTransitionPreview(transition: PptxSlideTransition | undefined, doc: Document): boolean;
+//# sourceMappingURL=transition-preview.d.ts.map

package/dist/pptx/render/transition-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-preview.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/transition-preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAK3D,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AAQtE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAEhE;AAyDD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,GAAG,EAAE,QAAQ,GACX,OAAO,CAqCT"}

package/dist/pptx/render/unicode-script-detection.d.ts

@@ -0,0 +1,3 @@
+/** Compatibility entry; shared text primitives are owned by ooxml-core. */
+export { detectFontScript, segmentByScript, resolveFontForScript, hasDistinctScriptFonts, type FontScriptCategory, type ScriptRun, } from 'ooxml-core/text';
+//# sourceMappingURL=unicode-script-detection.d.ts.map

package/dist/pptx/render/unicode-script-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unicode-script-detection.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/unicode-script-detection.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,EACN,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,SAAS,GACd,MAAM,iBAAiB,CAAC"}

package/dist/pptx/render/update-text-segment-style.d.ts

@@ -0,0 +1,6 @@
+import type { TextSegment, TextStyle } from 'ooxml-core/pptx';
+/** Keep a runless paragraph's future body formatting in the same style edit. */
+export declare function updateTextSegmentStyle(segment: TextSegment, updates: Partial<TextStyle>, options?: {
+    updateBodyStyle?: boolean;
+}): TextSegment;
+//# sourceMappingURL=update-text-segment-style.d.ts.map

package/dist/pptx/render/update-text-segment-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-text-segment-style.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/update-text-segment-style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE9D,gFAAgF;AAChF,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,EAC3B,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,WAAW,CAQb"}

package/dist/pptx/render/used-fonts.d.ts

@@ -0,0 +1,6 @@
+import type { PptxElement, PptxSlide } from 'ooxml-core/pptx';
+/** Recursively add every explicit font family referenced by an element. */
+export declare function collectFontsFromElement(element: PptxElement, fonts: Set<string>): void;
+/** Collect the sorted unique font families referenced across a presentation. */
+export declare function collectUsedFonts(slides: readonly PptxSlide[]): string[];
+//# sourceMappingURL=used-fonts.d.ts.map

package/dist/pptx/render/used-fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"used-fonts.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/used-fonts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE9D,2EAA2E;AAC3E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAgBtF;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,EAAE,CAQvE"}

package/dist/pptx/render/vector-subpath-paint.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Pure paint-decision logic for per-sub-path geometry, shared by custom
+ * geometry (`a:custGeom`) AND multi-sub-path preset shapes (`a:prstGeom`).
+ *
+ * Kept free of any view-layer concern (JSX, Vue/Angular templates, DOM) so it
+ * is unit-testable in isolation; each binding's SVG emission is a thin ~10-line
+ * mapping over its result. Originally lived only in the React package
+ * (`viewer/utils/vector-subpath-paint.ts`), which meant Vue and Vanilla (and,
+ * for preset shapes, every binding including React) had no way to honour a
+ * sub-path's own `@fill`/`@stroke` flags: they flattened every sub-path into
+ * one merged path with a single element-level fill, so a stroke-only sub-path
+ * inside a filled shape (an open eye/mouth on `smileyFace`) or a shading
+ * sub-path (`lighten`/`darken`, the bevel highlight on `actionButton*`) either
+ * rendered filled-and-distorted or vanished outright.
+ *
+ * Both geometry kinds evaluate to the exact same per-sub-path shape -
+ * `{ d, fillMode, stroke }` - which is what lets ONE function
+ * ({@link buildSubpathPaints}) paint either: `customGeometryPathsToSvgSubpaths`
+ * (core) already returns that shape for custom geometry, and preset geometry's
+ * `PresetSubpathResult` (`{ d, fill, stroke }`, from core's
+ * `evaluatePresetShape`) is a one-line rename away - see
+ * `./subpath-fill-overlay`, which resolves *which* elements need this
+ * treatment and calls this to build the actual paints.
+ */
+import type { CustomGeometrySubpathSvg } from 'ooxml-core/pptx';
+/**
+ * Adjust a fill colour for an OOXML `@fill` mode (`a:path/@fill` on a custom
+ * geometry sub-path, or the equivalent flag on a preset sub-path). `norm` /
+ * `undefined` return the colour unchanged; `lighten` / `lightenLess` blend
+ * towards white and `darken` / `darkenLess` towards black (the `*Less`
+ * variants half as strongly). `none` is handled by the caller (no fill
+ * emitted) and returns the input here.
+ */
+export declare function adjustFillForMode(fillHex: string, mode: CustomGeometrySubpathSvg['fillMode']): string;
+/** Resolved paint intent for a single geometry sub-path. */
+export interface SubpathPaint {
+    /** SVG path data for this sub-path. */
+    d: string;
+    /** Resolved fill paint, or `'none'` when this sub-path opts out of fill. */
+    fill: string;
+    /** Whether this sub-path draws its stroke (`@stroke` !== 0). */
+    stroked: boolean;
+}
+/**
+ * Resolve each sub-path's fill/stroke intent from its `@fill`/`@stroke` flags.
+ *
+ * A sub-path fills only when the shape has a fill *and* its own mode is not
+ * `none`; the fill colour is adjusted per the sub-path's mode. Stroke is drawn
+ * unless the sub-path sets `@stroke="0"` (`stroke === false`).
+ *
+ * Shared between custom geometry and multi-sub-path preset shapes; the caller
+ * adapts whichever core evaluator result it has into the common
+ * `{ d, fillMode, stroke }` shape first (see `./subpath-fill-overlay`).
+ */
+export declare function buildSubpathPaints(subpaths: CustomGeometrySubpathSvg[], hasFill: boolean, fillColor: string, fillOpacity: number | undefined): SubpathPaint[];
+//# sourceMappingURL=vector-subpath-paint.d.ts.map

package/dist/pptx/render/vector-subpath-paint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-subpath-paint.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/vector-subpath-paint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAuBhE;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,wBAAwB,CAAC,UAAU,CAAC,GACxC,MAAM,CAaR;AAED,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC5B,uCAAuC;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,wBAAwB,EAAE,EACpC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAAG,SAAS,GAC7B,YAAY,EAAE,CAWhB"}

package/dist/pptx/render/verified-text-rect-presets.d.ts

@@ -0,0 +1,84 @@
+/**
+ * The allowlist of preset names whose geometry text rectangle
+ * (`evaluatePresetShape(...).textRect`) is COM-verified against real
+ * PowerPoint, consumed by `text-body-rect.ts`.
+ *
+ * Split out of that module to keep it under the repo's 300-LOC file-size
+ * convention; see `resolveTextBodyRectPadding` there for how this set gates
+ * rendering.
+ *
+ * @module render/verified-text-rect-presets
+ */
+/**
+ * Preset names whose `rect` in core's geometry table is VERIFIED against
+ * PowerPoint, lower-cased.
+ *
+ * Nothing had ever read `PresetShapeGeometryDefinition.rect`, so nothing had
+ * ever checked it. Measuring PowerPoint directly (a deck of one shape per
+ * preset, opened through COM, with `TextFrame.TextRange.Bound*` read off
+ * single-glyph and wrapped-text probes at zero body insets on a 200x100pt box)
+ * originally put 65 of 194 preset rects within 0.02 of PowerPoint and found
+ * **117 that disagree**, several catastrophically: `pentagon` evaluated to a
+ * NEGATIVE bottom edge, `heart` and `moon` collapsed to zero (both referenced
+ * a `3wd4`/`3hd4` guide that does not exist: the built-in `wd`/`hd` family is
+ * division-only, `wd2..wd12`/`hd2..hd12`, with no multiples), `flowChartDecision`
+ * and `diamond` returned a quarter-size box (mirroring bug: `r`/`b` reused the
+ * CENTER guide instead of the far-edge mirror of `l`/`t`), and the whole
+ * ellipse and rounded-rect families reported the full bounding box where
+ * PowerPoint insets by 0.1464 and 0.0244 respectively. A follow-up pass
+ * (2026-09, gap G1) re-derived and re-measured `ellipse`, `roundRect`,
+ * `diamond`, `pentagon`, `heart`, `moon`, `plus`, the whole `round*Rect`/
+ * `snip*Rect` family, `flowChartDecision`, `triangle`, `rtTriangle`, `hexagon`
+ * and the `math*` symbols (all now on this list). `mathMultiply`,
+ * `parallelogram` and `trapezoid` resisted re-derivation from path guides;
+ * wave 2 transcribed the spec's own `<a:rect>` formulas for every preset
+ * (core `preset-text-rect-*.ts`, consulted ahead of the old table), and those
+ * three match their COM measurements within ~0.1px, so they are listed too.
+ * A wave-2 follow-up then COM-measured every remaining ECMA-transcribed
+ * preset in that table (all 93 entries total): all but one (`sun`, see below)
+ * matched within tolerance and are listed here, so the table now has no
+ * unverified entries left.
+ *
+ * So the rectangle is honoured only for the presets on this list. That is not
+ * timidity: consuming an unverified preset would move text on common shapes to
+ * measurably WRONG places, which is worse than the (also wrong) full box they
+ * use otherwise. The remaining entries belong to whoever owns
+ * `ooxml-core/src/pptx/core/geometry`; as each is corrected against the same
+ * measurement it can simply be added here.
+ *
+ * Lower-cased raw preset names, deliberately NOT `getShapeType`: that
+ * normaliser folds whole families together (`can` -> `cylinder`,
+ * `oval` -> `ellipse`), and this is a per-PRESET fact, keyed the way core's own
+ * `lookupPresetShape` keys it.
+ *
+ * `pie`'s entry in `preset-text-rect-table.ts` is a corrected reading of a
+ * genuinely broken ECMA source (the spec's own `<rect>` has `t`/`r` swapped,
+ * see that file's comment), fixed BY ANALOGY to `noSmoking`/`smileyFace`/
+ * `teardrop` (the same idx/idy/il/ir/it/ib guide set); this wave's COM
+ * measurement confirms the corrected reading matches PowerPoint exactly, so
+ * `pie` is listed below with the rest.
+ *
+ * `sun` IS now listed (2026-09-06). At the time this comment was first written
+ * it deliberately kept a pre-existing hand-derived `rect`
+ * (`preset-shape-definitions-misc.ts`, `discL`/`discT`/`discR`/`discB`, the
+ * central disc's own extents), and a COM measurement showed that rect was
+ * wrong: at 200x100pt and the default `adj`, PowerPoint measures
+ * l=64.65,t=32.32,r=135.27,b=67.68, while the disc rect evaluated to
+ * l=50,t=25,r=150,b=75 (7.3% off, well outside the 0.02 tolerance every other
+ * entry here meets), and the closest re-derivation tried then (the diagonal
+ * ray's inner band edge) still missed by ~1.5% on every edge. A later
+ * geometry fix (`preset-shape-definitions-misc.ts`, commit `1da163776`)
+ * replaced the rect with the disc's OWN inscribed axis-aligned rectangle
+ * (touching the disc ellipse at 45deg, the same construction `ellipse`'s own
+ * text rect uses against its full bounding ellipse): `trl`/`trt`/`trr`/`trb`,
+ * built from `cos`/`sin` guides against the disc radius. Re-measured via COM
+ * (PowerPoint 2016) against that same target (l=64.65,t=32.32,r=135.27,
+ * b=67.68 at 200x100pt) and a second aspect ratio (l=51.72,t=38.79,
+ * r=108.22,b=81.21 at 160x120pt), the new formula matches both within 0.1%,
+ * so `sun` now belongs on this list too (see
+ * `preset-text-rect.test.ts`'s `sun` case for the regression guard). This
+ * closes the module's last remaining gap: every preset this project carries a
+ * geometry-table `rect` for is now COM-verified.
+ */
+export declare const VERIFIED_TEXT_RECT_PRESETS: ReadonlySet<string>;
+//# sourceMappingURL=verified-text-rect-presets.d.ts.map

package/dist/pptx/render/verified-text-rect-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verified-text-rect-presets.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/verified-text-rect-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAyMzD,CAAC"}