ooxml-ui 1.30.0 → 1.32.0

package/dist/docx.js

@@ -1,9 +1,9 @@
-import { defineChartExOptions, chartExSpaceFormatSource, statusLayout, watchStatusWidth, compactPageText } from './chunk-E4H3Y7M4.js';
-import { syncRibbonAddIns, createHostBackstagePages, withHostMenuItems } from './chunk-SXVOXSTE.js';
-export { RIBBON_ADD_IN_EVENT } from './chunk-SXVOXSTE.js';
-import { defineSmartArt, smartArtColorsGalleryState, smartArtStylesGalleryState, SmartArtTextPaneController, defineSmartArtPicker } from './chunk-BKHWBIXP.js';
+import { defineChartExOptions, chartExSpaceFormatSource, statusLayout, watchStatusWidth, compactPageText } from './chunk-6TS7ASDJ.js';
+import { syncRibbonAddIns, createHostBackstagePages, withHostMenuItems } from './chunk-CDC5MAZS.js';
+export { RIBBON_ADD_IN_EVENT } from './chunk-CDC5MAZS.js';
+import { defineSmartArt, smartArtColorsGalleryState, smartArtStylesGalleryState, SmartArtTextPaneController, defineSmartArtPicker } from './chunk-CALEXPBD.js';
 import { legacyThemeAliases, legacyThemeBridge, installOfficeUiThemeFor } from './chunk-T5ARELU2.js';
-import { createRibbonOverflow, defineRibbon, defineChartFormatPane, defineRuler, defineChartDataSheet, defineChartPicker, defineCommentsPane, defineDialog, defineGallery, defineSearchField, defineSwitch, defineTitleBar, defineRibbonActions, defineBackstage, defineStatusBar, defineZoomSlider, defineContextMenu, defineColorGrid, runKeyTips, defineOptionsDialog, assignKeyTips, optionsLabels, userInterfaceSection, personalizeSection, optionText, unavailableCategory } from './chunk-HNREZW5U.js';
+import { createRibbonOverflow, defineRibbon, defineChartFormatPane, defineRuler, defineChartDataSheet, defineChartPicker, createDialogSession, defineCommentsPane, defineDialog, buildFontCatalog, defineGallery, defineSearchField, defineSwitch, defineTitleBar, defineRibbonActions, defineBackstage, defineStatusBar, defineZoomSlider, defineContextMenu, defineColorGrid, runKeyTips, defineOptionsDialog, assignKeyTips, optionsLabels, userInterfaceSection, personalizeSection, optionText, unavailableCategory } from './chunk-KYXSQFDB.js';
 import { registerIcon } from './chunk-M6GF5ED2.js';
 import './chunk-4OBMFPGF.js';
 import './chunk-YZH2QS7J.js';
@@ -25,6 +25,7 @@ import { EditorView, Decoration, DecorationSet } from 'prosemirror-view';
 import { keymap } from 'prosemirror-keymap';
 import { createLayoutSession, layoutDocumentModel, pageNumbers, createFakeMeasurer, ligatureCss, cssFontStack, tokenizeRun, reviewSourceLength, placeTab, cellVerticalOffset, fieldDisplayText, DEFAULT_FONT_SIZE_PT, pageNumberValues, sectionPageCounts, pageStyleRefs, headerFooterSlotForPage, headerFooterForPage, paragraphFloats, floatPosition } from 'ooxml-core/docx/layout';
 import { chainCommands, baseKeymap, selectAll, splitBlock } from 'prosemirror-commands';
+import { imageContentType } from 'ooxml-core/drawingml';
 import { applyChartExEditIntent, applyChartEditIntent, applyChartExEditAction, setChartType, setChartLegend, setChartExLegend } from 'ooxml-core/chart';
 import { sendableSteps, getVersion } from 'prosemirror-collab';
 import { isCapabilityEnabled, capabilityHiddenActions, mergeHiddenActions, saveToStorage, documentSaveMeta, fileCommandDetail, withoutHiddenEntries } from 'ooxml-core/embedding';
@@ -5727,7 +5728,9 @@ function comboBox(label2, items, parse5, action, options = {}) {
   input.setAttribute("aria-haspopup", "listbox");
   input.autocomplete = "off";
   input.spellcheck = false;
-  input.comboItems = [...items];
+  input.comboItems = options.preview ? buildFontCatalog({ allFonts: items }).flatMap(
+    (group3) => group3.entries.map((entry) => entry.family)
+  ) : [...items];
   let committed = "";
   const commit = (raw) => {
     const value = parse5(raw);
@@ -8530,7 +8533,7 @@ function placeholder(diagram) {
   return body;
 }
 var infoCounter = 0;
-function smartArtNodeView(node, diagram, theme, locale = "en") {
+function smartArtNodeView(node, diagram, theme, locale = "en", pictureResolver) {
   registerSmartArt();
   const dom = box(node, diagram);
   const info = document.createElement("button");
@@ -8591,6 +8594,7 @@ function smartArtNodeView(node, diagram, theme, locale = "en") {
       ...theme?.fonts.major.latin ? { major: theme.fonts.major.latin } : {},
       ...theme?.fonts.minor.latin ? { minor: theme.fonts.minor.latin } : {}
     };
+    if (pictureResolver) element.pictureResolver = pictureResolver;
     element.drawing = themed.drawing;
     dom.append(element);
   } else {
@@ -12565,7 +12569,14 @@ function imageNodeView(cache, options = {}) {
   return (node, view, getPos) => {
     if (node.attrs.shape) return shapeNodeView(node, view, getPos, () => options.theme?.());
     const diagram = parseDiagram(node.attrs.diagram);
-    if (diagram) return smartArtNodeView(node, diagram, options.theme?.(), options.locale?.());
+    if (diagram)
+      return smartArtNodeView(
+        node,
+        diagram,
+        options.theme?.(),
+        options.locale?.(),
+        (part) => cache.urlFor(part, imageContentType(part))
+      );
     if (node.attrs.chart) return chartNodeView(node, view, getPos, options);
     const content = renderSpec(node);
     if (content.tagName !== "IMG") return { dom: content, ignoreMutation: () => true };
@@ -16327,20 +16338,25 @@ function createZoomDialog(host) {
     const size = value === "custom" ? parseZoomPercent(percent.value) : Number(value);
     preview.style.fontSize = `${Math.round((size ?? 100) / 100 * 14)}px`;
   };
-  const hide = () => {
+  let session;
+  const cleanup = () => {
     setDialogOpen(element, false);
     element.replaceChildren();
     host.restoreFocus();
   };
+  const hide = () => session?.close();
   const submit = () => {
     const value = chosen();
     if (value === "width" || value === "page" || value === "pages") host.fit(value);
     else {
       const next = value === "custom" ? parseZoomPercent(percent.value) : Number(value);
-      if (next === null) return percent.focus();
+      if (next === null) {
+        percent.focus();
+        return;
+      }
       host.setPercent(next);
     }
-    hide();
+    return true;
   };
   for (const input of radios.values()) input.addEventListener("change", showPreview);
   percent.addEventListener("input", () => {
@@ -16348,18 +16364,10 @@ function createZoomDialog(host) {
     if (radio) radio.checked = true;
     showPreview();
   });
-  cancel.addEventListener("click", hide);
-  confirm2.addEventListener("click", submit);
-  onDialogDismiss(element, hide);
-  element.addEventListener("keydown", (event) => {
-    if (event.key === "Enter" && event.target instanceof HTMLInputElement) {
-      event.preventDefault();
-      submit();
-    }
-  });
   return {
     element,
     open() {
+      session?.dispose();
       element.replaceChildren(...content);
       localizeDialog(element, locale);
       const current2 = host.percent();
@@ -16368,6 +16376,14 @@ function createZoomDialog(host) {
       const radio = radios.get(preset ?? "custom");
       if (radio) radio.checked = true;
       showPreview();
+      session = createDialogSession({
+        element,
+        confirm: confirm2,
+        cancel,
+        submit,
+        finish: cleanup,
+        enter: (event) => event.target?.tagName === "INPUT"
+      });
       setDialogOpen(element, true);
       (radio ?? percent).focus();
     },

package/dist/fonts/availability.d.ts

@@ -0,0 +1,10 @@
+/** Minimal browser FontFaceSet surface used by the viewer bindings. */
+export interface FontAvailabilitySource {
+    readonly ready: PromiseLike<unknown>;
+    check(font: string): boolean;
+}
+/** Check whether a font family resolves through the browser font set. */
+export declare function isFontFamilyAvailable(family: string, source?: FontAvailabilitySource | undefined): boolean;
+/** Wait for fonts to settle, then return every locally available family. */
+export declare function scanAvailableFontFamilies(families: readonly string[], source?: FontAvailabilitySource | undefined): Promise<Set<string>>;
+//# sourceMappingURL=availability.d.ts.map

package/dist/fonts/availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.d.ts","sourceRoot":"","sources":["../../src/fonts/availability.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B;AAMD,yEAAyE;AACzE,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,sBAAsB,GAAG,SAA+B,GAC9D,OAAO,CAUT;AAED,4EAA4E;AAC5E,wBAAsB,yBAAyB,CAC9C,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,MAAM,GAAE,sBAAsB,GAAG,SAA+B,GAC9D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAUtB"}

package/dist/fonts/catalog.d.ts

@@ -0,0 +1,63 @@
+/**
+ * font-catalog.ts: grouping for the Home-tab font dropdown.
+ *
+ * PowerPoint splits its font list into headed groups: the two theme fonts
+ * first (labelled "Headings" and "Body"), then any fonts embedded in the
+ * presentation, then the full alphabetical catalogue. Reproducing that in five
+ * bindings means five copies of the same dedup rules, so the grouping decision
+ * is made once here and each binding only renders the returned sections.
+ *
+ * @module render/font-catalog
+ */
+/** Identifies a group so bindings can label and style it. */
+export type FontCatalogGroupId = 'theme' | 'embedded' | 'custom' | 'all';
+/** One selectable font. */
+export interface FontCatalogEntry {
+    /** The family name written into the run's `fontFamily`. */
+    family: string;
+    /**
+     * Which theme slot this family fills, for the "(Headings)" / "(Body)" hint
+     * PowerPoint shows beside its two theme fonts. Absent for other entries.
+     */
+    themeRole?: 'heading' | 'body';
+}
+/** A headed group of fonts. */
+export interface FontCatalogGroup {
+    id: FontCatalogGroupId;
+    /** i18n key for the group heading. */
+    labelKey: string;
+    entries: FontCatalogEntry[];
+}
+/** Inputs describing what the current deck and session make available. */
+export interface FontCatalogInput {
+    /** `a:fontScheme` major/minor latin faces from the active theme. */
+    themeFonts?: {
+        heading?: string;
+        body?: string;
+    };
+    /** Families embedded in the presentation via `p:embeddedFontLst`. */
+    embeddedFonts?: readonly string[];
+    /** Families the user registered this session from a local font file. */
+    customFonts?: readonly string[];
+    /** The host's catalogue; an omitted list adds no alphabetical group. */
+    allFonts?: readonly string[];
+    /** Product translations stay with the host rather than the shared grouping rules. */
+    labelKeys?: Partial<Record<FontCatalogGroupId, string>>;
+}
+/**
+ * Build the grouped font list for the Home-tab dropdown.
+ *
+ * A family promoted into the theme, embedded or custom group is removed from
+ * the alphabetical group, so no family is offered twice and clicking either
+ * copy would not produce different results.
+ *
+ * @returns Only the non-empty groups, in PowerPoint's order.
+ *
+ * @example
+ * ```ts
+ * const groups = buildFontCatalog({ themeFonts: { heading: "Aptos Display" } });
+ * // => groups[0].id === "theme"
+ * ```
+ */
+export declare function buildFontCatalog(input?: FontCatalogInput): FontCatalogGroup[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/fonts/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/fonts/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEzE,2BAA2B;AAC3B,MAAM,WAAW,gBAAgB;IAChC,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC/B;AAED,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,kBAAkB,CAAC;IACvB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAChC,oEAAoE;IACpE,UAAU,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,qEAAqE;IACrE,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,wEAAwE;IACxE,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,gBAAqB,GAAG,gBAAgB,EAAE,CAyCjF"}

package/dist/fonts/custom-fonts.d.ts

@@ -0,0 +1,75 @@
+/**
+ * custom-fonts.ts: registering a user-supplied font file with the document.
+ *
+ * Backs the opt-in "Custom fonts" pane under File > Options. The viewer cannot
+ * render a family the browser has never heard of, so a deck authored with a
+ * corporate face falls back to a substitute; letting the user hand the font
+ * file over fixes that for the session.
+ *
+ * Nothing here is persisted: the registration lives in the page's font set and
+ * disappears on reload. That is deliberate, because keeping a licensed font
+ * binary in local storage is not ours to decide.
+ *
+ * @module render/custom-fonts
+ */
+/** Recognised font file extensions, in the order the file input advertises. */
+export declare const CUSTOM_FONT_EXTENSIONS: readonly string[];
+/** `accept` attribute for a font file input. */
+export declare const CUSTOM_FONT_ACCEPT: string;
+/** Style axes recovered from a font file's name. */
+export interface CustomFontDescriptor {
+    /** Family name, with the style suffix and separators stripped. */
+    family: string;
+    /** CSS `font-weight` for the face. */
+    weight: string;
+    /** CSS `font-style` for the face. */
+    style: string;
+}
+/**
+ * Derive a family name, weight and style from a font file's name.
+ *
+ * Foundries encode the face in the filename (`Inter-SemiBoldItalic.woff2`),
+ * and registering every file under its full filename would give the user a
+ * dropdown of near-duplicate families that never combine with the bold and
+ * italic buttons. Splitting the axes out means the four files of a family all
+ * register as one selectable name.
+ *
+ * @param fileName - The uploaded file's name, extension included.
+ * @returns The descriptor; `family` is empty when the name carried nothing but
+ *   style tokens, which callers should treat as unusable.
+ *
+ * @example
+ * ```ts
+ * deriveCustomFontDescriptor("Inter-SemiBoldItalic.woff2");
+ * // => { family: "Inter", weight: "600", style: "italic" }
+ * ```
+ */
+export declare function deriveCustomFontDescriptor(fileName: string): CustomFontDescriptor;
+/** Outcome of a registration attempt. */
+export interface CustomFontRegistration {
+    family: string;
+    descriptor: CustomFontDescriptor;
+}
+/** A new browser registration with an explicit lifetime; the original result shape stays valid. */
+export interface OwnedCustomFontRegistration extends CustomFontRegistration {
+    /** Remove this registration only; other documents' faces are untouched. Idempotent. */
+    dispose(): void;
+}
+/**
+ * Load a font file and add it to the document's font set.
+ *
+ * @param file - The user-selected font file.
+ * @param target - Font set to add to; defaults to the ambient `document`.
+ *   Injectable so tests and non-browser hosts can supply their own.
+ * @returns The registered family, or `null` when the environment has no
+ *   `FontFace` support or the filename yields no usable family.
+ * @throws Whatever `FontFace.load` rejects with when the file is not a font,
+ *   so callers can surface a message instead of silently doing nothing.
+ */
+export declare function registerCustomFont(file: File, target?: FontFaceSet): Promise<OwnedCustomFontRegistration | null>;
+/** Session-owned browser fonts. A registration finishing after disposal is removed immediately. */
+export declare function createFontFaceScope(target?: FontFaceSet): {
+    register(file: File): Promise<OwnedCustomFontRegistration | null>;
+    dispose(): void;
+};
+//# sourceMappingURL=custom-fonts.d.ts.map

package/dist/fonts/custom-fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-fonts.d.ts","sourceRoot":"","sources":["../../src/fonts/custom-fonts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAAwC,CAAC;AAE7F,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,QAMpB,CAAC;AAEZ,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACpC,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACd;AAwED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CA0BjF;AAED,yCAAyC;AACzC,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,oBAAoB,CAAC;CACjC;AAED,mGAAmG;AACnG,MAAM,WAAW,2BAA4B,SAAQ,sBAAsB;IAC1E,uFAAuF;IACvF,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACvC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAmB7C;AAED,mGAAmG;AACnG,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,WAAW;IAIhD,QAAQ,OAAO,IAAI,GAAG,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC;IAWvE,OAAO,IAAI,IAAI;EAOhB"}

package/dist/form/color-input/live-color-input.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Live preview for a native colour input (`<input type="color">`), decided once for every
+ * binding.
+ *
+ * The picker fires `input` for every shade a drag passes and `change` once the pick settles
+ * (and in some browsers no `change` at all when the pick ends where it started, or on Escape).
+ * PowerPoint shows each shade on the slide while the user drags and makes the settled pick ONE
+ * undo step and ONE Recent Colors entry. A binding that applied every shade through its normal
+ * edit path recorded one undo step per shade; one that applied only on `change` showed nothing
+ * until the picker closed. This controller is the rule between the two:
+ *
+ * - `input`: show the shade live, with no undo step, dirty flag or recent colour;
+ * - `change`, or `blur` for a drag no `change` ended: put back what the previews changed, then
+ *   commit the settled colour through the binding's normal edit path, so its one undo step
+ *   returns to the colour from before the drag, and add it to the recent colours. A pick that
+ *   settles where the drag started is no edit at all: the previews are put back (theme ref
+ *   included) and no undo step is recorded. A `change` there is still the user's pick, so its
+ *   colour goes into the recent colours like any other; a `blur` there is not a pick (an
+ *   Escape, a drag back to the start), so it records nothing.
+ *
+ * The previews own only the leaves they wrote (`shapeStyle.fillColor`, its theme ref, ...),
+ * each remembered with the value it had before the drag. Putting a drag back and committing
+ * its pick are both rebased on the target as it is NOW: only those leaves go back, and the
+ * commit is built on the result, so an edit another hand made to the same element during the
+ * drag (a collaborator's line width, an assistant's text) survives, and the undo step returns
+ * to a state that existed.
+ *
+ * A drag belongs to one target (`key`, the element). It carries over to the next event only
+ * while the control edits that target and the model still shows the drag's work: the value it
+ * last read (a binding that has not re-rendered since), or a colour the drag itself put there.
+ * When the control has moved to another target, the drag is put back on its own target as it
+ * is then (`lookup`; the binding's writes are addressed by key; nothing is written if the
+ * target is gone) and the event that ends it is dropped: a pick made in
+ * a picker opened for one element never lands on another. When the target is the same but its
+ * colour was changed by another hand (a theme swatch, an undo), the drag is dropped as it is,
+ * since putting it back would overwrite that newer colour.
+ *
+ * @module render/live-color-input
+ */
+/** What a colour control edits at the moment of an event. */
+export interface LiveColorSource<T> {
+    /** The edited target's identity (the element id). A drag never crosses targets. */
+    readonly key: string;
+    /** The colour the control shows now. */
+    readonly color: string;
+    /** The target as the binding holds it now: the element, or the style a field reads. */
+    readonly value: T;
+}
+/** What a binding gives {@link createLiveColorInput}; called afresh on every event. */
+export interface LiveColorInputOptions<T, P extends object> {
+    /** The control's target now, or `undefined` when nothing can be edited. */
+    read(): LiveColorSource<T> | undefined;
+    /** The patch that sets `hex` on `value`; `undefined` when `value` cannot take a colour. */
+    patch(value: T, hex: string): P | undefined;
+    /**
+     * The target `key` as the model holds it now (the element by id, or the style a field
+     * reads on it), or `undefined` when it is gone: what a drag the control has left is put
+     * back on. A drag whose target cannot be found is not put back at all.
+     */
+    lookup(key: string): T | undefined;
+    /**
+     * Merge `patch` into the target `key` live: no undo step, dirty flag or recent colour. `key`
+     * can name a target the control has left, when the drag started there is put back.
+     */
+    preview(patch: P, key: string): void;
+    /**
+     * Merge the settled pick into the current target `key` through the normal edit path: ONE
+     * undo step and the dirty flag. The drag is already put back and `patch` is built on it.
+     */
+    commit(patch: P, key: string, hex: string): void;
+    /**
+     * Add `hex` to the recent colours: with every commit (just before it), and for a `change`
+     * that settles on the colour the drag started from (a pick, though not an edit).
+     */
+    remember(hex: string): void;
+}
+/** The native events of one colour input, each with the input's current value. */
+export interface LiveColorInput {
+    /** An `input` event: one shade of a drag. */
+    input(hex: string): void;
+    /** A `change` event: the pick settled. */
+    change(hex: string): void;
+    /** A `blur` event: settles a drag no `change` ended, at the value the input shows. */
+    blur(hex: string): void;
+}
+/** Build the controller for one colour input. */
+export declare function createLiveColorInput<T, P extends object>(options: LiveColorInputOptions<T, P>): LiveColorInput;
+/**
+ * Route a native colour input's DOM `input`, `change` or `blur` event to `control`, with the
+ * value the input shows. Any other event, or an input without a value, is ignored.
+ */
+export declare function handleLiveColorEvent(control: LiveColorInput, event: Event): void;
+//# sourceMappingURL=live-color-input.d.ts.map

package/dist/form/color-input/live-color-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-color-input.d.ts","sourceRoot":"","sources":["../../../src/form/color-input/live-color-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAKH,6DAA6D;AAC7D,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CAClB;AAED,uFAAuF;AACvF,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM;IACzD,2EAA2E;IAC3E,IAAI,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACvC,2FAA2F;IAC3F,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC5C;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC9B,6CAA6C;IAC7C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0CAA0C;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,sFAAsF;IACtF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAgBD,iDAAiD;AACjD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EACvD,OAAO,EAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,GAClC,cAAc,CA8FhB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAahF"}

package/dist/form/color-input/live-color-leaves.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The leaves a live colour drag writes, and how they are put back (see `live-color-input.ts`).
+ *
+ * A colour patch writes whole top-level entries (`{ shapeStyle: { ...style, fillColor } }`),
+ * but the drag owns only the leaves inside them that changed. Those are found by a structural
+ * diff of plain objects and arrays, each remembered with the value it had before the drag,
+ * and put back onto the target as it is at that moment, so everything else in the same entry
+ * keeps whatever it holds now. When a preview creates an object the target did not have (a
+ * text colour on an element with no `textStyle`), the drag owns the entries it put inside, not
+ * the object: putting it back removes those, and the object itself only if nothing else went
+ * into it since.
+ *
+ * @module render/live-color-leaves
+ */
+type LiveColorPath = readonly string[];
+/** One leaf a drag's previews wrote, with what the target held there before the first one. */
+export interface LiveColorLeaf {
+    readonly path: LiveColorPath;
+    readonly present: boolean;
+    readonly value: unknown;
+    /** An object the previews created: it goes again once putting the drag back leaves it empty. */
+    readonly created?: boolean;
+}
+/** Note every leaf `patch` writes on `value` that the drag has not written yet. */
+export declare function recordLiveColorLeaves(leaves: Map<string, LiveColorLeaf>, value: unknown, patch: object): void;
+/**
+ * The patch that puts every leaf a drag wrote back to what it was before the drag, rebased on
+ * `value` (the target now): the top-level entries it names are `value`'s own, with only those
+ * leaves changed. An object the drag created goes again if that leaves it empty; a top-level
+ * entry the target did not have comes back as `undefined`.
+ */
+export declare function liveColorRevertPatch<P extends object>(value: unknown, leaves: Iterable<LiveColorLeaf>): P;
+export {};
+//# sourceMappingURL=live-color-leaves.d.ts.map

package/dist/form/color-input/live-color-leaves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-color-leaves.d.ts","sourceRoot":"","sources":["../../../src/form/color-input/live-color-leaves.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,KAAK,aAAa,GAAG,SAAS,MAAM,EAAE,CAAC;AAEvC,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,gGAAgG;IAChG,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC3B;AAqED,mFAAmF;AACnF,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EAClC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACX,IAAI,CA6BN;AAyBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EACpD,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC7B,CAAC,CAmCH"}

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from './presence.js';
 export * from './smartart.js';
 export * from './teams/index.js';
 export * from './theme.js';
+export * from './recovery-scheduler.js';
 export { CONTRACT_REVISION, type Definer } from './registry.js';
 /** Every ooxml-ui tag this package defines, in registration order. */
 export declare const OFFICE_UI_TAGS: readonly ["office-ui-icon", "office-ui-button", "office-ui-checkbox", "office-ui-switch", "office-ui-select", "office-ui-ribbon-group", "office-ui-ribbon-stack", "office-ui-menu-item", "office-ui-menu-button", "office-ui-menu-separator", "office-ui-context-menu", "office-ui-command-search", "office-ui-toolbar", "office-ui-dialog", "office-ui-status-bar", "office-ui-status-item", "office-ui-zoom-slider", "office-ui-tab-strip", "office-ui-task-pane", "office-ui-options-dialog", "office-ui-account", "office-ui-ribbon", "office-ui-ribbon-actions", "office-ui-find-bar", "office-ui-ruler", "office-ui-backstage", "office-ui-print-preview", "office-ui-radio", "office-ui-search", "office-ui-ribbon-toggle", "office-ui-dialog-footer", "office-ui-toasts", "office-ui-read-only-banner", "office-ui-paste-options", "office-ui-title-bar", "office-ui-ribbon-section", "office-ui-gallery", "office-ui-comments-pane", "office-ui-chart-format-pane", "office-ui-symbol-picker", "office-ui-color-grid", "office-ui-color-custom", "office-ui-chart-picker", "office-ui-chart-data-sheet", "office-ui-progress-dialog", "office-ui-presence", "office-ui-smartart", "office-ui-smartart-picker", "office-ui-smartart-text-pane", "office-ui-avatar", "office-ui-app-rail", "office-ui-activity-feed", "office-ui-channel-list", "office-ui-chat-list", "office-ui-chat-composer", "office-ui-prejoin", "office-ui-call-grid", "office-ui-call-controls", "office-ui-chat-sidebar", "office-ui-people-picker", "office-ui-calendar-view", "office-ui-calendar-agenda"];

package/dist/index.js

@@ -1,13 +1,14 @@
-export { OFFICE_UI_TAGS, registerOfficeUi } from './chunk-SBBFNAKM.js';
-export { HOST_REGION_ATTRIBUTE, HostRegionHost, RIBBON_ADD_IN_EVENT, createHostBackstagePages, defineRibbonAddInElements, syncHostMenuChildren, syncRibbonAddIns, tidyMenuSeparators, withHostMenuItems } from './chunk-SXVOXSTE.js';
-export { OfficeUiSmartArt, OfficeUiSmartArtPicker, OfficeUiSmartArtTextPane, SmartArtTextPaneController, defineSmartArt, defineSmartArtPicker, defineSmartArtTextPane, renderDiagramDrawing, smartArtColorsGalleryState, smartArtLayoutTileSvg, smartArtStylesGalleryState, smartArtTileSvg } from './chunk-BKHWBIXP.js';
-export { EMOJI, OfficeUiActivityFeed, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCalendarAgenda, OfficeUiCalendarView, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiChatSidebar, OfficeUiPeoplePicker, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_CONTRACT, TEAMS_TAGS, TeamsApp, TeamsChannelTab, TeamsContentPreview, TeamsController, TeamsElement, TeamsFilesPanel, TeamsSettings, activityTime, applyTeamsProps, bindTeams, colorFor, createTeams, dayKind, dayLabel, defineActivityFeed, defineAppRail, defineAvatar, defineCalendarAgenda, defineCalendarView, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, defineChatSidebar, definePeoplePicker, definePrejoin, defineTeamsApp, defineTeamsChannelTab, defineTeamsContentPreview, defineTeamsFilesPanel, defineTeamsSettings, formatElapsed, formatSize, formatTime, formatWhen, icon, listenTeamsEvents, loadConfig, loadIdentity, parseIceLines, pickTeamsProps, registerTeams, safeStorage, saveConfig, saveIdentity, withStyles } from './chunk-IE6HKH4X.js';
+export { OFFICE_UI_TAGS, registerOfficeUi } from './chunk-32P252JS.js';
+export { createRecoveryScheduler } from './chunk-DA57FPSN.js';
+export { HOST_REGION_ATTRIBUTE, HostRegionHost, RIBBON_ADD_IN_EVENT, createHostBackstagePages, defineRibbonAddInElements, syncHostMenuChildren, syncRibbonAddIns, tidyMenuSeparators, withHostMenuItems } from './chunk-CDC5MAZS.js';
+export { OfficeUiSmartArt, OfficeUiSmartArtPicker, OfficeUiSmartArtTextPane, SmartArtTextPaneController, defineSmartArt, defineSmartArtPicker, defineSmartArtTextPane, renderDiagramDrawing, smartArtColorsGalleryState, smartArtLayoutTileSvg, smartArtStylesGalleryState, smartArtTileSvg } from './chunk-CALEXPBD.js';
+export { EMOJI, OfficeUiActivityFeed, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCalendarAgenda, OfficeUiCalendarView, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiChatSidebar, OfficeUiPeoplePicker, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_CONTRACT, TEAMS_TAGS, TeamsApp, TeamsChannelTab, TeamsContentPreview, TeamsController, TeamsElement, TeamsFilesPanel, TeamsSettings, activityTime, applyTeamsProps, bindTeams, colorFor, createTeams, dayKind, dayLabel, defineActivityFeed, defineAppRail, defineAvatar, defineCalendarAgenda, defineCalendarView, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, defineChatSidebar, definePeoplePicker, definePrejoin, defineTeamsApp, defineTeamsChannelTab, defineTeamsContentPreview, defineTeamsFilesPanel, defineTeamsSettings, formatElapsed, formatSize, formatTime, formatWhen, icon, listenTeamsEvents, loadConfig, loadIdentity, parseIceLines, pickTeamsProps, registerTeams, safeStorage, saveConfig, saveIdentity, withStyles } from './chunk-OKEFAQJT.js';
 export { TeamsPresentationPreview, defineTeamsPresentationPreview } from './chunk-WYKMVMX4.js';
 import './chunk-CDAXY5KC.js';
 import './chunk-NDUD5JJB.js';
 import './chunk-KJMAVPQB.js';
 export { BUILDING_BLOCKS_CSS, LEGACY_OFFICE_THEME_TOKENS, THEME_CSS, THEME_STYLE_ID, installOfficeUiTheme, installOfficeUiThemeFor, legacyThemeAliases, legacyThemeBridge, prepareOfficeUiBlock, shadcnBridge, themeBridge } from './chunk-T5ARELU2.js';
-export { CONTROL_DEFINERS, DEFAULT_COMMENTS_LABELS, DEFAULT_OFFICE_PROFILE, EMPTY_MENU_STATE, OFFICE_AVATAR_SWATCHES, OFFICE_COLOR_SWATCHES, OFFICE_COLOR_SWATCH_HEXES, OFFICE_PROFILE_STORAGE_KEY, OFFICE_SYMBOLS, OFFICE_TITLE_BAR_SEARCH_LIMIT, OFFICE_TOAST_VISIBLE_LIMIT, OfficeUiChartFormatPane, assignKeyTips, attachKeyTips, attachRibbonGroupOverflow, buildChartFormatModel, chartFormatFieldIntent, chartFormatLocale, chartFormatPaneTitle, chartFormatSourceTabs, chartFormatTargetLabel, chartFormatTargetOptions, chartFormatTranslator, chartSpaceFormatSource, clampFlyoutPosition, clampOptionNumber, clearOfficeProfile, commentInitials, createRibbonOverflow, defaultPaneGradient, defineAccount, defineBackstage, defineButton, defineChartDataSheet, defineChartFormatPane, defineChartPicker, defineCheckbox, defineColorCustom, defineColorGrid, defineCommandSearch, defineCommentsPane, defineContextMenu, defineDialog, defineDialogFooter, defineFindBar, defineGallery, defineIcon, defineMenuButton, defineMenuItem, defineMenuSeparator, defineOptionsDialog, definePasteOptions, definePrintPreview, defineProgressDialog, defineRadio, defineReadOnlyBanner, defineRibbon, defineRibbonActions, defineRibbonGroup, defineRibbonSection, defineRibbonStack, defineRibbonToggle, defineRuler, defineSearchField, defineSelect, defineStatusBar, defineStatusItem, defineSwitch, defineSymbolPicker, defineTabStrip, defineTaskPane, defineTitleBar, defineToasts, defineToolbar, defineZoomSlider, drawingColorFromHex, drawingGradientFrom, fitRibbonGroups, formatCommentTime, glyph, hexForInput, nextEnabledIndex, optionText, optionsLabels, parseOfficeSymbolCode, personalizeSection, profileInitials, readOfficeProfile, registerControls, resolveChartFormatSourceTarget, rulerDivisions, runKeyTips, sanitizeOfficeProfile, translateChartFormatText, typeAheadIndex, unavailableCategory, unavailableControl, userInterfaceSection, writeOfficeProfile } from './chunk-HNREZW5U.js';
+export { CONTROL_DEFINERS, CUSTOM_FONT_ACCEPT, CUSTOM_FONT_EXTENSIONS, DEFAULT_COMMENTS_LABELS, DEFAULT_OFFICE_PROFILE, EMPTY_MENU_STATE, OFFICE_AVATAR_SWATCHES, OFFICE_COLOR_SWATCHES, OFFICE_COLOR_SWATCH_HEXES, OFFICE_PROFILE_STORAGE_KEY, OFFICE_SYMBOLS, OFFICE_TITLE_BAR_SEARCH_LIMIT, OFFICE_TOAST_VISIBLE_LIMIT, OfficeUiChartFormatPane, assignKeyTips, attachKeyTips, attachRibbonGroupOverflow, buildChartFormatModel, buildFontCatalog, chartFormatFieldIntent, chartFormatLocale, chartFormatPaneTitle, chartFormatSourceTabs, chartFormatTargetLabel, chartFormatTargetOptions, chartFormatTranslator, chartSpaceFormatSource, clampFlyoutPosition, clampOptionNumber, clearOfficeProfile, commentInitials, createDialogSession, createFontFaceScope, createLiveColorInput, createRibbonOverflow, defaultPaneGradient, defineAccount, defineBackstage, defineButton, defineChartDataSheet, defineChartFormatPane, defineChartPicker, defineCheckbox, defineColorCustom, defineColorGrid, defineCommandSearch, defineCommentsPane, defineContextMenu, defineDialog, defineDialogFooter, defineFindBar, defineGallery, defineIcon, defineMenuButton, defineMenuItem, defineMenuSeparator, defineOptionsDialog, definePasteOptions, definePrintPreview, defineProgressDialog, defineRadio, defineReadOnlyBanner, defineRibbon, defineRibbonActions, defineRibbonGroup, defineRibbonSection, defineRibbonStack, defineRibbonToggle, defineRuler, defineSearchField, defineSelect, defineStatusBar, defineStatusItem, defineSwitch, defineSymbolPicker, defineTabStrip, defineTaskPane, defineTitleBar, defineToasts, defineToolbar, defineZoomSlider, deriveCustomFontDescriptor, drawingColorFromHex, drawingGradientFrom, fitRibbonGroups, formatCommentTime, glyph, handleLiveColorEvent, hexForInput, isFontFamilyAvailable, liveColorRevertPatch, nextEnabledIndex, optionText, optionsLabels, parseOfficeSymbolCode, personalizeSection, profileInitials, readOfficeProfile, recordLiveColorLeaves, registerControls, registerCustomFont, resolveChartFormatSourceTarget, rulerDivisions, runKeyTips, sanitizeOfficeProfile, scanAvailableFontFamilies, translateChartFormatText, typeAheadIndex, unavailableCategory, unavailableControl, userInterfaceSection, writeOfficeProfile } from './chunk-KYXSQFDB.js';
 export { createIconSvg, getIcon, listIcons, paintIcon, registerIcon } from './chunk-M6GF5ED2.js';
 export { CHART_FORMAT_LOCALES, CHART_FORMAT_STRINGS, prefixChartFormatStrings } from './chunk-4OBMFPGF.js';
 export { OfficeUiPresence, definePresence, initialsOf, participantsFromAwareness } from './chunk-YZH2QS7J.js';

package/dist/picture-effects.d.ts

@@ -0,0 +1,6 @@
+import { type DrawingPictureEffect } from 'ooxml-core/drawingml';
+/** Ordered supported picture effects. Unknown operations remain in the model and are reported. */
+export declare function pictureEffectFilter(doc: Document, defs: SVGDefsElement, effects: readonly DrawingPictureEffect[]): {
+    filter?: string;
+    unapplied: string[];
+};