ooxml-ui 0.30.0 → 0.31.0

package/dist/pptx/render/autosave-recovery.d.ts.map

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

package/dist/pptx/render/autosave-store.d.ts

@@ -0,0 +1,49 @@
+/**
+ * IndexedDB-backed autosave recovery store, shared by every binding.
+ *
+ * Extracted from the React `useAutosave` hook so Vue/Angular reuse the same
+ * database (`pptx-viewer-autosave` / `recoveryVersions`) instead of each
+ * binding growing its own copy. Records are keyed by the host-supplied file
+ * path; on quota exhaustion the oldest record is evicted and the write is
+ * retried once.
+ */
+export declare const AUTOSAVE_DB_NAME = "pptx-viewer-autosave";
+export declare const AUTOSAVE_DB_VERSION = 1;
+export declare const AUTOSAVE_STORE_NAME = "recoveryVersions";
+/** Default autosave interval in seconds. */
+export declare const AUTOSAVE_DEFAULT_INTERVAL_SECONDS = 120;
+/** Minimum allowed autosave interval in seconds. */
+export declare const AUTOSAVE_MIN_INTERVAL_SECONDS = 10;
+/** Clamp a user-supplied interval (seconds) and convert to milliseconds. */
+export declare function autosaveIntervalMs(intervalSeconds: number): number;
+export declare function openAutosaveDb(): Promise<IDBDatabase>;
+/** Delete the oldest entry in the autosave store. Returns true if one was removed. */
+export declare function deleteOldestAutosaveEntry(): Promise<boolean>;
+export interface AutosaveRecord {
+    key: string;
+    data: Uint8Array;
+    timestamp: number;
+    size: number;
+}
+/**
+ * Retrieve a single autosave snapshot by file path.
+ * Returns undefined when no snapshot exists.
+ */
+export declare function getAutosaveSnapshot(filePath: string): Promise<AutosaveRecord | undefined>;
+/**
+ * List all autosave snapshots (without the heavy `data` blob).
+ * Useful for showing a recovery picker on app start.
+ */
+export declare function listAutosaveSnapshots(): Promise<Array<{
+    key: string;
+    timestamp: number;
+    size: number;
+}>>;
+/** Delete a snapshot, rejecting when IndexedDB cannot commit the transaction. */
+export declare function deleteAutosaveSnapshot(filePath: string): Promise<boolean>;
+/**
+ * Persist a recovery snapshot. On QuotaExceededError the oldest record is
+ * dropped and the write retried once.
+ */
+export declare function saveAutosaveSnapshot(filePath: string, data: Uint8Array): Promise<boolean>;
+//# sourceMappingURL=autosave-store.d.ts.map

package/dist/pptx/render/autosave-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autosave-store.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/autosave-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AACvD,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAEtD,4CAA4C;AAC5C,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAErD,oDAAoD;AACpD,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAYrD;AAED,sFAAsF;AACtF,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,OAAO,CAAC,CAuClE;AA8BD,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAe/F;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CACrD,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CACvD,CAiCA;AAED,iFAAiF;AACjF,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0B/E;AAMD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAc/F"}

package/dist/pptx/render/autosave-tick.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview Should this autosave tick actually write a recovery snapshot?
+ *
+ * ## The divergence this closes
+ *
+ * Five bindings, two engine shapes. Vue, Svelte and Vanilla DEBOUNCE: an edit
+ * reassigns the slides array, that arms a timer, the timer writes once. React
+ * and Angular POLL: a `setInterval` fires every N seconds and writes whenever
+ * the document is dirty. The document stays dirty until the user performs a
+ * real save, so the polling pair re-serialized the whole deck and rewrote an
+ * identical IndexedDB record every tick, for as long as the tab stayed open.
+ *
+ * This module gives the polling engines the debounce engines' trigger without
+ * giving up the fixed cadence: the tick still fires, but it only does work when
+ * something the snapshot captures has been reassigned since the last snapshot.
+ *
+ * ## Why identity, and why it is safe
+ *
+ * The bindings rebuild editable state immutably, which is exactly what the
+ * debounce engines already rely on: Vanilla arms on
+ * `state.slides !== previous.slides` and Vue watches `[slides,
+ * templateElements]`. Comparing the same references here therefore adds no new
+ * blind spot, it only brings React and Angular onto the trigger the other three
+ * have always used.
+ *
+ * Every ambiguous case resolves to WRITING. No previous mark, a different file,
+ * a different number of sources, a source that is not a stable reference: all
+ * of them write. A redundant snapshot costs a few milliseconds; a suppressed
+ * one costs the user their crash recovery, so the asymmetry is deliberate and
+ * must stay that way.
+ *
+ * An explicit `triggerAutosave()` is never gated. It is a request, not a poll.
+ *
+ * @module render/autosave-tick
+ */
+/** What the last written snapshot captured. */
+export interface AutosaveSnapshotMark {
+    /** IndexedDB key the snapshot was written under. */
+    readonly filePath: string;
+    /** Opaque object/function identity tokens and unchanged primitive values. */
+    readonly sources: readonly unknown[];
+}
+export interface AutosaveTickInput {
+    /** IndexedDB key for the recovery snapshot. Autosave is inert without one. */
+    readonly filePath: string | undefined;
+    /** Whether the document has unsaved edits. */
+    readonly isDirty: boolean;
+    /** Whether a snapshot write is already in flight. */
+    readonly saving: boolean;
+    /**
+     * The values a snapshot is built from, read fresh on this tick: the slides
+     * array, the template-element map, and anything else the binding's
+     * serializer reads that is reassigned rather than mutated. Pass an empty
+     * array to opt out of redundancy suppression entirely.
+     */
+    readonly sources: readonly unknown[];
+    /** The mark left by the last snapshot this engine wrote, if any. */
+    readonly lastSnapshot: AutosaveSnapshotMark | undefined;
+}
+/** Capture the state a just-written snapshot represents. */
+export declare function autosaveSnapshotMark(filePath: string, sources: readonly unknown[]): AutosaveSnapshotMark;
+/**
+ * True when this tick has real work to do.
+ *
+ * Read it as the four questions the engines used to ask inline, plus the one
+ * they never asked: "has anything changed since the snapshot I already wrote?"
+ */
+export declare function shouldWriteAutosaveSnapshot(input: AutosaveTickInput): boolean;
+//# sourceMappingURL=autosave-tick.d.ts.map

package/dist/pptx/render/autosave-tick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autosave-tick.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/autosave-tick.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAkBH,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACpC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACxD;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,OAAO,EAAE,GACzB,oBAAoB,CAEtB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAgB7E"}

package/dist/pptx/render/background-shade-to-title.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Legacy PowerPoint 97-2003 "shade to title colour" background effect.
+ *
+ * `<p:bgPr shadeToTitle="1">` (ECMA-376 Part 1, Section 19.3.1.2,
+ * `CT_BackgroundProperties`) marks a slide's background gradient to shade
+ * toward the title placeholder. It was exposed in the PowerPoint 97-2003
+ * "Background" dialog's two-colour shaded-fill picker as a "Shade to title
+ * color" checkbox; no PowerPoint version since 2007 exposes a UI control that
+ * writes it, and it has never been observed in this project's real-world
+ * corpus (see `docs/guide/limitations.md`).
+ *
+ * COM-measured ground truth (2026-09-06, PowerPoint 2016 x64, via a hand-built
+ * two-stop `<a:gradFill>` blue(0%)/green(100%) linear gradient plus a real
+ * `ctrTitle` placeholder, `Slide.Export` PNG diffed pixel-by-pixel, then a
+ * finer 40-sample scan along both axes): the name is misleading. PowerPoint
+ * does NOT recolour any stop toward the title's text colour (an earlier
+ * implementation's guess, disproven by the first coarse measurement).
+ * Instead it converts the fill into a rectangular *path* gradient (like
+ * authoring "Shading style: From center" but with a rectangle instead of an
+ * ellipse) whose inner box is the title placeholder's OWN bounding rectangle
+ * (not some inset/padded variant of it) and whose ORIGINAL stop colours are
+ * preserved unchanged: the gradient's first stop fills the title box, the
+ * last stop reaches the slide's outer edges, with a smooth ramp between.
+ *
+ * On a 960x540pt slide with a `ctrTitle` at fractions l=0.125, t=0.16366,
+ * r=0.875, b=0.51181 (`Title.Left/.Top/.Width/.Height` over
+ * `PageSetup.SlideWidth/Height`), a 40-sample fine scan of the exported PNG
+ * found the rendered gradient pure (matching the inner stop colour exactly)
+ * across x in [0.150, 0.850] and y in [0.175, 0.500], and pure again (matching
+ * the outer stop) at every slide edge, with a monotonic ramp in between whose
+ * measured half-pixel-accurate boundary sits at the title's own edge in every
+ * one of the four directions (the small asymmetry that made an earlier,
+ * coarser reading look like a *different* inner rectangle was 0.025-fraction
+ * quantization noise from an 11-point grid sample, not a real offset).
+ * Because the title sits high and roughly centred, the ramp above and beside
+ * it is a thin band while the ramp below it (title bottom at 0.512, slide
+ * bottom at 1.0) is a wide, gradual one; that asymmetry falls straight out of
+ * treating each of the four edges independently (see
+ * {@link computeShadeToTitleFillToRect} and `path-gradient-rect.ts`), not from
+ * any special-cased "different formula for the bottom" - moving the title
+ * (re-measured, not a fixed legacy-template constant) moves the same
+ * lopsided shape with it. PowerPoint did not repair the file and the
+ * shape/slide counts were unchanged with the flag on or off.
+ *
+ * This module reproduces that field exactly, reusing the same nested-rect
+ * band engine `svg-gradient-rect-path.ts` / `path-gradient-rect.ts` already
+ * use for a shape's own `a:path type="rect"` gradient: the slide plays the
+ * role of "the shape", and the title placeholder's bounds (expressed as
+ * `RectPathGradientFillToRect` insets of the SLIDE) play the role of
+ * `a:fillToRect`. No new rendering primitive was needed, only a title-bounds
+ * -> `fillToRect` conversion ({@link computeShadeToTitleFillToRect}) and a way
+ * to recover the gradient's stop colours from the CSS string
+ * `PptxSlide.backgroundGradient` already carries
+ * ({@link parseGradientCssStops}): core stores the resolved background
+ * gradient only as a finished CSS `linear-gradient()` / `radial-gradient()`
+ * string (see `PptxGradientStyleCodec.extractGradientFillCss`), not as
+ * structured stops, so this module parses its own project's deterministic
+ * `<color> <position>%` token shape back out rather than widen the core model
+ * for a legacy flag no real-world deck has ever been seen to use.
+ *
+ * Inheritance behaviour, COM-verified (2026-09-06, PowerPoint 2016 x64): this
+ * only finds a title when the SLIDE's own XML carries a title/ctrTitle
+ * placeholder shape (`resolveShadeToTitleRect` reads `PptxSlide.elements`,
+ * where placeholder geometry inherited from the layout/master is already
+ * resolved onto the slide's own shape - see
+ * `PptxHandlerRuntimeShapeParsing.ts`'s `findPlaceholderContext` merge). That
+ * is not an approximation this project accepted: a slide that relies on the
+ * layout's title purely by NOT defining a title shape at all renders the
+ * plain, unanchored gradient IN REAL POWERPOINT TOO. Three decks were built
+ * from a real-world corpus fixture (`themed-layout-placeholders.pptx`) and
+ * `Slide.Export`-ed to PNG: (1) a slide with no shapes of its own, pointed at
+ * a "Title Slide" layout whose `ctrTitle` carries its own layout-level
+ * `<a:xfrm>` distinct from the master's; (2) a slide with no shapes of its
+ * own, pointed at the "Blank" layout, which defines no title anywhere and
+ * whose master only has a `title` (no `ctrTitle`); (3) a baseline slide that
+ * keeps its own `title` placeholder shape. A pixel scan (20-sample rows and
+ * columns) found (1) and (2) byte-identical to each other and to the same
+ * gradient with `shadeToTitle` OFF: a plain axis-aligned ramp, x-invariant
+ * along a horizontal scan, that only LOOKS non-linear because of the
+ * fixture's `<a:lin scaled="1">` (scaling a linear gradient to a non-square
+ * region warps the ramp's rate but not its shape). (3) diverges from that
+ * exact same baseline at the same coordinates once the slide owns a title
+ * shape, confirming the anchoring only engages then. In short: core's
+ * layout/master element extraction (`PptxHandlerRuntimeLayoutElements.ts`)
+ * deliberately excludes placeholder shapes from the elements it returns (they
+ * only feed placeholder-default/style inheritance), so no layout-only title's
+ * geometry is reachable from a `PptxSlide` at all - and that is correct,
+ * because PowerPoint's own renderer does not consult the layout or master
+ * for this effect either. See `docs/guide/limitations.md`.
+ *
+ * Pure, framework-agnostic, and consumed by every binding through
+ * {@link getSlideBackgroundStyle} in `slide-background.ts` (see CLAUDE.md
+ * Rule 2).
+ *
+ * @module render/background-shade-to-title
+ */
+import type { PptxSlide } from 'ooxml-core/pptx';
+import type { RectPathGradientFillToRect, RectPathGradientStop } from './path-gradient-rect.js';
+/** A title placeholder's bounds, in the same slide-relative px space as every `PptxElement`. */
+export interface TitlePlaceholderRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Find the slide's own title/ctrTitle placeholder and return its bounds, or
+ * `undefined` when the slide carries no title placeholder shape (see the
+ * module docstring's "known residual gap") or that shape has no usable size.
+ */
+export declare function resolveShadeToTitleRect(slide: PptxSlide | undefined): TitlePlaceholderRect | undefined;
+/**
+ * Convert a title placeholder's px bounds into the `RectPathGradientFillToRect`
+ * insets `path-gradient-rect.ts`'s band engine expects, treating the whole
+ * SLIDE as the "shape" the gradient fills (see the module docstring). Returns
+ * `undefined` for a non-positive slide size.
+ */
+export declare function computeShadeToTitleFillToRect(title: TitlePlaceholderRect, slideWidthPx: number, slideHeightPx: number): RectPathGradientFillToRect | undefined;
+/**
+ * Recover a gradient's colour stops from the finished CSS string
+ * `PptxSlide.backgroundGradient` carries.
+ *
+ * Not a general CSS gradient parser: this project's own
+ * `PptxGradientStyleCodec.buildGradientCssFromStops` is the only producer of
+ * that string, and it always emits stops as `<colour> <position>%` tokens
+ * (`#rrggbb` or `rgba(r, g, b, a)` colours) in gradient order regardless of
+ * `linear-gradient(...)` / `radial-gradient(...)` wrapping, so matching that
+ * exact shape back out is reliable here even though it would not be for
+ * arbitrary author-supplied CSS. The direction/shape keywords the gradient
+ * function itself carries (angle, `at 50% 50%`, ...) are intentionally
+ * discarded: PowerPoint's `shadeToTitle` effect replaces the gradient's
+ * geometry entirely and keeps only its stop colours (see module docstring).
+ */
+export declare function parseGradientCssStops(css: string): RectPathGradientStop[];
+/**
+ * Build the anchored rect-path gradient's `background-image` CSS value for a
+ * slide flagged `shadeToTitle`, or `undefined` when the effect does not apply:
+ * no gradient background, no title placeholder shape on the slide (COM-verified
+ * to match real PowerPoint, which does not fall back to a layout- or
+ * master-inherited title either - see the module docstring), or the caller
+ * could not supply the slide's pixel size (a binding not yet updated to pass
+ * one - see `getSlideBackgroundStyle`). Callers should keep rendering
+ * `slide.backgroundGradient` unchanged in every one of those cases.
+ */
+export declare function resolveShadeToTitleBackgroundImage(slide: PptxSlide | undefined, slideWidthPx: number | undefined, slideHeightPx: number | undefined): string | undefined;
+//# sourceMappingURL=background-shade-to-title.d.ts.map

package/dist/pptx/render/background-shade-to-title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-shade-to-title.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/background-shade-to-title.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+FG;AACH,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAW7F,gGAAgG;AAChG,MAAM,WAAW,oBAAoB;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,SAAS,GAAG,SAAS,GAC1B,oBAAoB,GAAG,SAAS,CAMlC;AAMD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,oBAAoB,EAC3B,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACnB,0BAA0B,GAAG,SAAS,CAUxC;AAoCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAUzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CACjD,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,aAAa,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,GAAG,SAAS,CAoBpB"}

package/dist/pptx/render/backstage-cards.d.ts

@@ -0,0 +1,35 @@
+import type { BackstagePage } from './backstage.js';
+/**
+ * Every action card the File-tab backstage can show, keyed by the operation it
+ * triggers rather than by its wording.
+ *
+ * The five bindings used to hardcode a title and a body string each, which made
+ * the whole backstage untranslatable and let the copy drift: the same card
+ * carried four different descriptions depending on which binding you opened it
+ * in. Both halves now live here as a dictionary key plus an English fallback,
+ * so a wording change lands everywhere at once and a translator only has to
+ * translate it once.
+ */
+export type BackstageCardId = 'protect' | 'inspect' | 'embedFonts' | 'signatures' | 'versionHistory' | 'saveAsPptx' | 'saveAsPpsx' | 'saveAsPptm' | 'saveAsPpt' | 'pdf' | 'png' | 'video' | 'gif' | 'json' | 'copyImage' | 'print' | 'share';
+export interface BackstageCard {
+    id: BackstageCardId;
+    /** English fallback, used when the host supplies no dictionary. */
+    title: string;
+    /** English fallback for the one-line description under the title. */
+    body: string;
+    titleKey: string;
+    bodyKey: string;
+}
+export declare const BACKSTAGE_CARDS: Readonly<Record<BackstageCardId, BackstageCard>>;
+/**
+ * Which cards a backstage page shows, in order.
+ *
+ * `saveAsPptm` is listed on Save As but only rendered when the open deck
+ * actually has macros; that gating stays in the bindings because only they know
+ * the current document. Every other entry is unconditional, so a binding that
+ * renders this list in order matches the others by construction.
+ */
+export declare const BACKSTAGE_PAGE_CARDS: Readonly<Partial<Record<BackstagePage, readonly BackstageCardId[]>>>;
+/** The cards for a page, already resolved to their descriptors. */
+export declare function backstageCardsFor(page: BackstagePage): readonly BackstageCard[];
+//# sourceMappingURL=backstage-cards.d.ts.map

package/dist/pptx/render/backstage-cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backstage-cards.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/backstage-cards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GACxB,SAAS,GACT,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,gBAAgB,GAChB,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,KAAK,GACL,KAAK,GACL,OAAO,GACP,KAAK,GACL,MAAM,GACN,WAAW,GACX,OAAO,GACP,OAAO,CAAC;AAEX,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,eAAe,CAAC;IACpB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB;AAUD,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,CA8D5E,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAC1C,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,eAAe,EAAE,CAAC,CAAC,CAO1D,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,aAAa,EAAE,CAE/E"}

package/dist/pptx/render/backstage.d.ts

@@ -0,0 +1,86 @@
+import type { PptxSlide } from 'ooxml-core/pptx';
+/** The recent-files search control is visually owned by its outer frame. */
+export declare const BACKSTAGE_SEARCH_CLASSES: {
+    readonly box: 'mt-8 flex h-10 w-full max-w-[540px] items-center gap-2 border border-input bg-card px-3 text-muted-foreground focus-within:border-ring';
+    readonly icon: 'size-4 shrink-0';
+    readonly input: 'h-full min-w-0 flex-1 border-0 bg-transparent text-[13px] text-card-foreground outline-none placeholder:text-muted-foreground';
+};
+/** Shared Tailwind treatment for the File backstage navigation rows. */
+export declare const BACKSTAGE_NAV_CLASSES: {
+    readonly row: 'flex min-h-10 shrink-0 items-center gap-3 border-l-2 px-4 text-left text-[12px] max-md:whitespace-nowrap max-md:border-l-0 max-md:border-b-2 max-md:px-3';
+    readonly active: 'border-primary bg-card text-primary';
+    readonly inactive: 'border-transparent hover:bg-accent';
+};
+/** The back row is short and clickable across the full desktop rail. */
+export declare const BACKSTAGE_BACK_CLASSES: {
+    readonly row: 'flex h-10 shrink-0 border-b border-border max-md:h-12 max-md:w-12 max-md:border-b-0 max-md:border-r';
+    readonly button: 'grid h-10 w-full place-items-center text-xl hover:bg-accent max-md:h-12 max-md:w-12';
+};
+export type BackstagePage = 'home' | 'new' | 'open' | 'info' | 'save' | 'saveAs' | 'print' | 'share' | 'export' | 'close' | 'account' | 'options';
+export interface BackstageRecentFile {
+    key: string;
+    name: string;
+    location: string;
+    timestamp: number;
+    size: number;
+}
+export interface BackstageTemplate {
+    id: string;
+    name: string;
+    description: string;
+    /** Dictionary key for `name`, so bindings can render a translated gallery. */
+    nameKey: string;
+    /** Dictionary key for `description`. */
+    descriptionKey: string;
+    preview: string;
+}
+/**
+ * Look up a dotted UI string. Matches the call shape every binding's
+ * translation function already has (react-i18next / vue-i18n `t`,
+ * ngx-translate's `instant`, and the Vanilla/Svelte `Translator`), so a
+ * binding can pass its own `t` straight through.
+ */
+export type BackstageTranslate = (key: string, params?: Record<string, string | number>) => string;
+/**
+ * `label` stays the English fallback so a host that renders the nav without a
+ * dictionary still gets readable text; `labelKey` is what the bindings feed to
+ * their translator. Both live here rather than in five view layers so the nav
+ * cannot drift between bindings.
+ */
+export declare const BACKSTAGE_NAV: ReadonlyArray<{
+    id: BackstagePage;
+    label: string;
+    labelKey: string;
+    group?: 'footer';
+}>;
+export declare const BACKSTAGE_TEMPLATES: readonly BackstageTemplate[];
+/** Build a fresh one-slide deck from a backstage template selection. */
+export declare function createBackstagePresentation(templateId: string): PptxSlide[];
+/**
+ * Recent autosave snapshots, newest first. `translate` only covers the two
+ * fallback labels for a snapshot with no usable path; pass the binding's `t`
+ * so those read in the user's language rather than English.
+ *
+ * @param limit File > Options > Advanced > "Quickly access this number of
+ *   Recent Documents" (`options.advanced.recentPresentationsCount`, 0-50).
+ *   Truncates the list to this many entries; `0` returns an empty list
+ *   (PowerPoint's own semantics for the setting). Omit to keep every stored
+ *   snapshot (existing callers that predate the option).
+ */
+export declare function listBackstageRecentFiles(translate?: BackstageTranslate, limit?: number): Promise<BackstageRecentFile[]>;
+/**
+ * Load a recent file's bytes for File > Open > Recent.
+ *
+ * Like the picker (see `openPptxFile`), the reopened deck is remembered for
+ * this browser tab: the viewer swaps it in without telling the host, so a host
+ * that restores on load would otherwise reopen the deck it handed in.
+ */
+export declare function readBackstageRecentFile(key: string): Promise<Uint8Array | undefined>;
+/**
+ * Relative "date modified" for a recent-files row. `translate` is optional so
+ * existing two-argument calls keep working; without it the English wording is
+ * used, which is also what the unit tests pin.
+ */
+export declare function formatBackstageDate(timestamp: number, now?: number, translate?: BackstageTranslate): string;
+export declare function formatBackstageSize(bytes: number): string;
+//# sourceMappingURL=backstage.d.ts.map

package/dist/pptx/render/backstage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backstage.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/backstage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAMjD,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB;aACpC,GAAG,EAAE,wIAAwI;aAC7I,IAAI,EAAE,iBAAiB;aACvB,KAAK,EACJ,+HAA+H;CACvH,CAAC;AAEX,wEAAwE;AACxE,eAAO,MAAM,qBAAqB;aACjC,GAAG,EAAE,0JAA0J;aAC/J,MAAM,EAAE,qCAAqC;aAC7C,QAAQ,EAAE,oCAAoC;CACrC,CAAC;AAEX,wEAAwE;AACxE,eAAO,MAAM,sBAAsB;aAClC,GAAG,EAAE,qGAAqG;aAC1G,MAAM,EAAE,qFAAqF;CACpF,CAAC;AAEX,MAAM,MAAM,aAAa,GACtB,MAAM,GACN,KAAK,GACL,MAAM,GACN,MAAM,GACN,MAAM,GACN,QAAQ,GACR,OAAO,GACP,OAAO,GACP,QAAQ,GACR,OAAO,GACP,SAAS,GACT,SAAS,CAAC;AAEb,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;AAEnG;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC;IACzC,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;CACjB,CAaA,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,SAAS,iBAAiB,EAiD3D,CAAC;AA6BF,wEAAwE;AACxE,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,CAG3E;AAgBD;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC7C,SAAS,CAAC,EAAE,kBAAkB,EAC9B,KAAK,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAahC;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAS1F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,MAAM,EACjB,GAAG,SAAa,EAChB,SAAS,CAAC,EAAE,kBAAkB,GAC5B,MAAM,CAcR;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKzD"}

package/dist/pptx/render/bar-chart-3d-hit-test.d.ts

@@ -0,0 +1,21 @@
+/** The (series, category) a raycast hit landed on, plus its authored value. */
+export interface BarChart3DHit {
+    seriesIndex: number;
+    categoryIndex: number;
+    value: number;
+}
+/** The subset of {@link BarChart3DSceneOptions} the hover tooltip needs. */
+export interface BarChart3DHoverTooltipData {
+    categoryLabels: ReadonlyArray<string>;
+    seriesNames: ReadonlyArray<string>;
+    numberFormats?: ReadonlyArray<string | undefined>;
+}
+/**
+ * Build the hover-tooltip text for a raycast hit on a bar3D box mesh, or
+ * `undefined` when there is no hit.
+ *
+ * Mirrors `buildMarkTooltip`'s "<series>, <category>: <value>" text exactly,
+ * so a bar3D box's tooltip reads identically to the flat SVG bar renderer's.
+ */
+export declare function buildBarChart3DHoverTooltip(hit: BarChart3DHit | null | undefined, data: BarChart3DHoverTooltipData): string | undefined;
+//# sourceMappingURL=bar-chart-3d-hit-test.d.ts.map

package/dist/pptx/render/bar-chart-3d-hit-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bar-chart-3d-hit-test.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/bar-chart-3d-hit-test.ts"],"names":[],"mappings":"AAiBA,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,4EAA4E;AAC5E,MAAM,WAAW,0BAA0B;IAC1C,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAClD;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAC1C,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACrC,IAAI,EAAE,0BAA0B,GAC9B,MAAM,GAAG,SAAS,CAUpB"}

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

@@ -0,0 +1,92 @@
+/**
+ * broadcast-helpers.ts: framework-agnostic helpers for the Broadcast dialog,
+ * shared by the React, Vue and Angular bindings.
+ *
+ * A broadcast is a one-way collaboration session: the presenter drives slide
+ * navigation and viewers follow along via a shareable link. These helpers
+ * cover the testable, framework-agnostic parts of each binding's broadcast
+ * dialog: room-id generation, form validation, and the viewer-link builder.
+ *
+ * No `any`; all regexes use the `/u` flag; no `String.prototype.replaceAll`,
+ * no regex named-capture-groups (Angular vendors this source under its
+ * ng-packagr lib target). Room ids are generated with `secureRandomToken`
+ * (cryptographically strong), read inside the generator at call time, never
+ * at module eval.
+ */
+import type { CollaborationTransport } from '../types.js';
+/** Default y-websocket server URL used when no default is supplied. */
+export declare const DEFAULT_BROADCAST_SERVER_URL = "ws://localhost:1234";
+/** Optional seed values for the broadcast start form. */
+export interface BroadcastDefaults {
+    roomId?: string;
+    serverUrl?: string;
+}
+/** The configuration emitted when a broadcast starts. */
+export interface BroadcastConfig {
+    roomId: string;
+    serverUrl: string;
+    /** Derived from serverUrl: empty server means peer-to-peer (webrtc). */
+    transport?: CollaborationTransport;
+}
+/**
+ * Resolve the transport implied by a server-URL form field: a blank server
+ * URL selects the serverless y-webrtc transport (peers meet via WebRTC
+ * signaling plus same-browser BroadcastChannel); anything else is a
+ * y-websocket server URL.
+ */
+export declare function resolveTransportForServerUrl(serverUrl: string): CollaborationTransport;
+/** Generate a fresh, broadcast-scoped room id (`broadcast-<suffix>`). */
+export declare function generateBroadcastRoomId(): string;
+/**
+ * Seed the start form from the (optional) defaults, generating a fresh room id
+ * when none is supplied and falling back to the default server URL.
+ */
+export declare function seedBroadcastFields(defaults?: BroadcastDefaults): BroadcastConfig;
+/**
+ * Whether the form can start: the room id is required; the server URL may be
+ * blank, which selects the serverless webrtc transport.
+ */
+export declare function canStartBroadcast(fields: BroadcastConfig): boolean;
+/**
+ * Assemble a {@link BroadcastConfig} from the (trimmed) form fields, or `null`
+ * when incomplete. A blank server URL yields `transport: 'webrtc'`.
+ */
+export declare function buildBroadcastConfig(fields: BroadcastConfig): BroadcastConfig | null;
+/**
+ * Build a shareable link that carries a session id under `paramName`: either
+ * `?<paramName>=<id>&transport=webrtc` (blank server URL, peer-to-peer) or
+ * `?<paramName>=<id>&server=<url>`. Returns just the id when no
+ * `origin`/`pathname` are available (non-browser environments).
+ *
+ * The one query-link builder behind both {@link buildBroadcastViewerUrl}
+ * (`paramName: 'broadcast'`) and Angular's `buildShareUrl`
+ * (`paramName: 'room'`, re-exported here) - the two diverged only in that one
+ * literal, so a room/broadcast link cannot drift apart on the query shape.
+ */
+export declare function buildQueryLinkUrl(id: string, serverUrl: string, location: {
+    origin: string;
+    pathname: string;
+} | undefined, paramName: string): string;
+/**
+ * Build the shareable viewer follow-link for a broadcast. Returns just the
+ * room id when no `origin`/`pathname` are available (non-browser environments).
+ * A blank server URL produces a `transport=webrtc` link instead of a
+ * `server=` parameter.
+ */
+export declare function buildBroadcastViewerUrl(roomId: string, serverUrl: string, location?: {
+    origin: string;
+    pathname: string;
+}): string;
+/**
+ * Build a shareable join URL for a (non-broadcast) collaboration session.
+ * Identical shape to {@link buildBroadcastViewerUrl}, but under the `room=`
+ * query key Angular's Share dialog uses. Returns just the room id when no
+ * `origin`/`pathname` are available (e.g. non-browser environments).
+ */
+export declare function buildShareUrl(roomId: string, serverUrl: string, location?: {
+    origin: string;
+    pathname: string;
+}): string;
+/** Whether the runtime exposes a usable async clipboard write API. */
+export declare function canUseClipboard(nav: Navigator | undefined): boolean;
+//# sourceMappingURL=broadcast-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast-helpers.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/broadcast-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAGvD,uEAAuE;AACvE,eAAO,MAAM,4BAA4B,wBAAwB,CAAC;AAElE,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAEtF;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAKjF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAElE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,GAAG,IAAI,CAUpF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAChC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAC1D,SAAS,EAAE,MAAM,GACf,MAAM,CAWR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7C,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7C,MAAM,CAER;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAMnE"}

package/dist/pptx/render/bullet-autonum-scripts.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Script-specific numeral converters for OOXML `ST_TextAutonumberScheme`
+ * auto-numbered bullets: the East-Asian (`ea1*`), Hebrew, Arabic, Hindi
+ * (Devanagari) and Thai numbering families.
+ *
+ * The implementation lives in `ooxml-core/pptx`
+ * (`core/utils/auto-number-scripts`) so the load path and the render layer
+ * format a marker identically; see {@link ./bullet-autonum} for why. This
+ * module stays as the render-layer entry point (and keeps the shape its tests
+ * and callers expect).
+ */
+export { formatScriptAutoNumber, bijectiveLabel, toChineseNumeral, toHebrewNumeral, toArabicAbjadNumeral, toDevanagariDigits, toThaiDigits, toFullWidthDigits, HINDI_VOWELS, HINDI_CONSONANTS, THAI_CONSONANTS, ARABIC_HIJAI_LETTERS, } from 'ooxml-core/pptx';
+//# sourceMappingURL=bullet-autonum-scripts.d.ts.map

package/dist/pptx/render/bullet-autonum-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullet-autonum-scripts.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/bullet-autonum-scripts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACN,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,oBAAoB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/pptx/render/bullet-autonum.d.ts

@@ -0,0 +1,2 @@
+export { formatAutoNumber, romanNumeral, alphaLabel, TEXT_AUTONUMBER_SCHEMES, } from 'ooxml-core/pptx/editor/render/bullet-autonum';
+//# sourceMappingURL=bullet-autonum.d.ts.map

package/dist/pptx/render/bullet-autonum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullet-autonum.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/bullet-autonum.ts"],"names":[],"mappings":"AACA,OAAO,EACN,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,uBAAuB,GACvB,MAAM,8CAA8C,CAAC"}

package/dist/pptx/render/bullet-list.d.ts

@@ -0,0 +1,3 @@
+export { resolvePictureBullet, resolveParagraphBullet, bulletIndentPx, resolveParagraphIndent, } from 'ooxml-core/pptx/editor/render/bullet-list';
+export type { ParagraphBulletResult, PictureBulletMarker, ParagraphIndent, ParagraphIndentLayout, } from 'ooxml-core/pptx/editor/render/bullet-list';
+//# sourceMappingURL=bullet-list.d.ts.map

package/dist/pptx/render/bullet-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullet-list.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/bullet-list.ts"],"names":[],"mappings":"AACA,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,sBAAsB,GACtB,MAAM,2CAA2C,CAAC;AACnD,YAAY,EACX,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,GACrB,MAAM,2CAA2C,CAAC"}

package/dist/pptx/render/bullet-toggle-selection.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Selection-scoped Bullets / Numbering: PowerPoint applies the ribbon's list
+ * buttons to the paragraphs the text selection intersects, and to the whole
+ * body when the shape (not a text range) is selected.
+ *
+ * `toggleSelectionBullets` is the one decision every binding's Bullets /
+ * Numbering click routes through: it rewrites only the in-scope paragraphs
+ * via the existing paragraph-range setter and remaps the inline selection over the
+ * marker segments it inserted or removed, so the binding can restore the
+ * caret exactly where the user had it.
+ */
+import type { PptxElement, TextSegment } from 'ooxml-core/pptx';
+import type { ElementBulletKind, ParagraphBulletKind } from './bullet-toggle.js';
+import type { InlineTextSelection } from './inline-selection-utils.js';
+/** What a selection-scoped bullet edit hands back to the binding. */
+export interface BulletToggleResult {
+    /** The element patch to apply through the binding's update-element operation. */
+    patch: Partial<PptxElement>;
+    /** The selection remapped onto the new segments; `null` when there was none. */
+    newSelection: InlineTextSelection | null;
+}
+/**
+ * The list state the ribbon buttons should show for the current selection:
+ * the kind shared by the paragraphs it intersects (every paragraph when there
+ * is none), `'mixed'` when they disagree.
+ *
+ * @param segments - A fresher copy of the element's segments (a live inline
+ *   edit); defaults to the element's own.
+ */
+export declare function selectionBulletKind(element: PptxElement, selection: InlineTextSelection | null, segments?: readonly TextSegment[]): ElementBulletKind;
+/**
+ * Set every paragraph the selection intersects to `kind` (every paragraph
+ * when there is no selection), returning the element patch and the selection
+ * remapped onto the rewritten segments. Numbered paragraphs are counted
+ * consecutively so the renderer shows "1. 2. 3.".
+ */
+export declare function setSelectionBullets(element: PptxElement, kind: ParagraphBulletKind, selection: InlineTextSelection | null, segments?: readonly TextSegment[]): BulletToggleResult;
+/**
+ * The ribbon button behaviour: pressing Bullets (or Numbering) when every
+ * in-scope paragraph is already that kind turns them off; otherwise (none, the
+ * other kind, or mixed) it applies that kind to all of them.
+ */
+export declare function toggleSelectionBullets(element: PptxElement, kind: Exclude<ParagraphBulletKind, 'none'>, selection: InlineTextSelection | null, segments?: readonly TextSegment[]): BulletToggleResult;
+//# sourceMappingURL=bullet-toggle-selection.d.ts.map

package/dist/pptx/render/bullet-toggle-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullet-toggle-selection.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/bullet-toggle-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGhE,OAAO,KAAK,EAAmB,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAM/F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IAClC,iFAAiF;IACjF,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5B,gFAAgF;IAChF,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACzC;AAgBD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,mBAAmB,GAAG,IAAI,EACrC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,GAC/B,iBAAiB,CAGnB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,mBAAmB,GAAG,IAAI,EACrC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,GAC/B,kBAAkB,CAWpB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,EAC1C,SAAS,EAAE,mBAAmB,GAAG,IAAI,EACrC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,GAC/B,kBAAkB,CAGpB"}