ooxml-ui 1.7.0 → 1.8.0

package/dist/ribbon/add-in-tabs.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Ribbon add-in tabs: tabs a host application adds after the product's own, as an Office add-in
+ * does (Visio's and Excel's ACROBAT tab). The host describes each tab with plain data; every
+ * product editor exposes the list as its `ribbonAddIns` property and renders it with
+ * `syncRibbonAddIns`, so one descriptor works in every editor. An add-in command never reaches
+ * the product's own command router: it runs its `run` callback and is announced with the
+ * `office-ribbon-add-in` event, which leaves the editor's shadow tree. The descriptor itself is
+ * DOM-free and lives in `ooxml-core/ribbon`, so the binding contracts in the core share it.
+ */
+import { type RibbonAddInCommandDetail, type RibbonAddInTab } from 'ooxml-core/ribbon';
+export { RIBBON_ADD_IN_EVENT, type RibbonAddInCommand, type RibbonAddInCommandDetail, type RibbonAddInGroup, type RibbonAddInTab, } from 'ooxml-core/ribbon';
+/**
+ * Defines the shared elements an add-in panel is built from. A product whose own ribbon uses
+ * other controls (Word's is hand-built) never registered them, and an undefined
+ * `office-ui-button` is an empty, inert tag: the panel would show nothing.
+ */
+export declare function defineRibbonAddInElements(registry: CustomElementRegistry | undefined): void;
+/** Bubbling and composed, dispatched from the ribbon when an add-in command is chosen. */
+export type OfficeRibbonAddInEvent = CustomEvent<RibbonAddInCommandDetail>;
+export interface RibbonAddInOptions {
+    /** Class of each tab panel, for products that style their own panels (`ribbon-content`). */
+    panelClass?: string;
+    /** Wraps the groups of a panel, for products whose panels hold one toolbar row. */
+    wrap?: (doc: Document, tab: RibbonAddInTab, groups: HTMLElement[]) => HTMLElement[];
+}
+/**
+ * Shows `tabs` as the add-in panels of `ribbon` (an `office-ui-ribbon`), after the product's own
+ * panels and in the given order. A tab whose id is empty, repeated or already a product tab is
+ * skipped, so an add-in can never replace a built-in tab. The selected tab is kept when it still
+ * exists. Returns the ids that are shown.
+ *
+ * The panels are rebuilt only when something visible changed. A framework that passes a new
+ * array with new `run` callbacks on every render therefore keeps its panels (and an open
+ * drop-down), and a command always runs the callback of the latest descriptor.
+ */
+export declare function syncRibbonAddIns(ribbon: HTMLElement, tabs: readonly RibbonAddInTab[], options?: RibbonAddInOptions): string[];

package/dist/ribbon/group-overflow.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Ribbon overflow for ribbons built from `office-ui-ribbon-group` elements: when the visible tab
+ * panel is narrower than its groups, the groups collapse from the right, each into the one button
+ * the group element already draws (`data-collapsed`), and that button opens the group's commands
+ * in a popup (`data-open`). This is what Office does when a window narrows; the panel scrolls only
+ * when even the collapsed groups do not fit.
+ *
+ * `createRibbonOverflow` (overflow.ts) does the same for ribbons made of plain `.ribbon-group`
+ * elements (Word, Excel) by moving their controls; here the controls never leave the group, so
+ * the product's own listeners and state hooks keep working.
+ */
+export interface RibbonGroupOverflowOptions {
+    /** The registered icon of a collapsed group (by element); the group's `icon` attribute wins. */
+    icon?(group: HTMLElement): string | undefined;
+    /** Below this window width nothing collapses (a product's phone layout takes over). */
+    minWidth?: number;
+}
+export interface RibbonGroupOverflow {
+    /** Re-measures the visible panel now (after a tab switch or new tabs). */
+    refit(): void;
+    /** Closes the open group popup. */
+    close(): void;
+    destroy(): void;
+}
+/**
+ * Collapses groups of `panel` from the right until it no longer overflows. Returns the labels of
+ * the collapsed groups, rightmost first.
+ */
+export declare function fitRibbonGroups(panel: HTMLElement, options?: RibbonGroupOverflowOptions): string[];
+/**
+ * Keeps the visible panel of `ribbon` (an `office-ui-ribbon`) fitted as the ribbon resizes, the
+ * tab changes and panels are added, and owns which collapsed group is open: a press on a
+ * collapsed group's button toggles its popup; Escape, a click elsewhere or a command chosen in
+ * the popup closes it.
+ */
+export declare function attachRibbonGroupOverflow(ribbon: HTMLElement, options?: RibbonGroupOverflowOptions): RibbonGroupOverflow;
+//# sourceMappingURL=group-overflow.d.ts.map

package/dist/ribbon/group-overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-overflow.d.ts","sourceRoot":"","sources":["../../src/ribbon/group-overflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,0BAA0B;IAC1C,gGAAgG;IAChG,IAAI,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IACnC,0EAA0E;IAC1E,KAAK,IAAI,IAAI,CAAC;IACd,mCAAmC;IACnC,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CAChB;AAoBD;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,0BAA+B,GACtC,MAAM,EAAE,CAkBV;AAiBD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,0BAA+B,GACtC,mBAAmB,CAyGrB"}

package/dist/ribbon/ribbon-tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ribbon-tabs.d.ts","sourceRoot":"","sources":["../../src/ribbon/ribbon-tabs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAuB,MAAM,SAAS,CAAC;AAK7D,gGAAgG;AAChG,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEnE,UAAU,SAAS;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAChD,OAAgB,MAAM,4BAAsB;IAC5C,OAAgB,UAAU;;YAEb,IAAI;YAAU,UAAU;;;YAC3B,IAAI;;;YACA,SAAS;YAAgB,IAAI;;;;;;;;;;;;YAE1B,SAAS;YAAmB,IAAI;;;YAClC,SAAS;YAAiB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;YAI3B,SAAS;YAAoB,IAAI;;;YAC1C,KAAK;;MACZ;IACM,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,SAAS,EAAE,CAAC;IAC1B,OAAO,CAAC,MAAM,CAAuB;IAErC,cAYC;IAED,IAAI,QAAQ,IAAI,MAAM,CAIrB;IACD,IAAI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAI9B;IAED,+EAA+E;IAC/E,SAAS,IAAI,IAAI,CAEhB;IAED,8BAA8B;IAC9B,QAAQ,IAAI,IAAI,CAEf;IAED,yEAAyE;IACzE,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAE/C;IAED,iEAAiE;IACjE,UAAU,IAAI,iBAAiB,GAAG,IAAI,CAErC;IAED;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAS/D;IAED,OAAO,CAAC,MAAM;IAMd,sEAAsE;IACtE,OAAO,CAAC,KAAK;IAIb,2FAA2F;IAC3F,OAAO,CAAC,KAAK;IAmBb,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,SAAS,CAEf;IAEF,OAAO,CAAC,gBAAgB;IAKxB,mFAAmF;IACnF,OAAO,CAAC,YAAY;IAOpB,UAAmB,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,IAAI,CAMtE;IAED,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,UAAU;IAKlB,4EAA4E;IAC5E,OAAO,CAAC,SAAS,CAKf;IAEF,OAAO,CAAC,KAAK;IAsBb,2EAA2E;IAC3E,OAAO,CAAC,OAAO,CAA+B;IAErC,iBAAiB,IAAI,IAAI,CAWjC;IAEQ,oBAAoB,IAAI,IAAI,CAMpC;IAED,+BAA+B;IAC/B,UAAmB,OAAO,IAAI,IAAI,CAKjC;IAED,UAAmB,MAAM,oCAyDxB;CACD;AAED,eAAO,MAAM,YAAY,+BAAoD,CAAC"}
+{"version":3,"file":"ribbon-tabs.d.ts","sourceRoot":"","sources":["../../src/ribbon/ribbon-tabs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAuB,MAAM,SAAS,CAAC;AAK7D,gGAAgG;AAChG,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEnE,UAAU,SAAS;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAChD,OAAgB,MAAM,4BAAsB;IAC5C,OAAgB,UAAU;;YAEb,IAAI;YAAU,UAAU;;;YAC3B,IAAI;;;YACA,SAAS;YAAgB,IAAI;;;;;;;;;;;;YAE1B,SAAS;YAAmB,IAAI;;;YAClC,SAAS;YAAiB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;YAI3B,SAAS;YAAoB,IAAI;;;YAC1C,KAAK;;MACZ;IACM,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,SAAS,EAAE,CAAC;IAC1B,OAAO,CAAC,MAAM,CAAuB;IAErC,cAYC;IAED,IAAI,QAAQ,IAAI,MAAM,CAIrB;IACD,IAAI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAI9B;IAED,+EAA+E;IAC/E,SAAS,IAAI,IAAI,CAEhB;IAED,8BAA8B;IAC9B,QAAQ,IAAI,IAAI,CAEf;IAED,yEAAyE;IACzE,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAE/C;IAED,iEAAiE;IACjE,UAAU,IAAI,iBAAiB,GAAG,IAAI,CAErC;IAED;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAS/D;IAED,OAAO,CAAC,MAAM;IAMd,sEAAsE;IACtE,OAAO,CAAC,KAAK;IAIb,2FAA2F;IAC3F,OAAO,CAAC,KAAK;IAmBb,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,SAAS,CAEf;IAEF,OAAO,CAAC,gBAAgB;IAKxB,mFAAmF;IACnF,OAAO,CAAC,YAAY;IAOpB,UAAmB,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,IAAI,CAMtE;IAED,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,UAAU;IAKlB,4EAA4E;IAC5E,OAAO,CAAC,SAAS,CAKf;IAEF,OAAO,CAAC,KAAK;IAsBb,2EAA2E;IAC3E,OAAO,CAAC,OAAO,CAA+B;IAErC,iBAAiB,IAAI,IAAI,CAWjC;IAEQ,oBAAoB,IAAI,IAAI,CAMpC;IAED,+BAA+B;IAC/B,UAAmB,OAAO,IAAI,IAAI,CAKjC;IAED,UAAmB,MAAM,oCA0DxB;CACD;AAED,eAAO,MAAM,YAAY,+BAAoD,CAAC"}

package/dist/teams/app/index.d.ts

@@ -3,7 +3,7 @@ export { TeamsSettings, defineTeamsSettings, parseIceLines } from './teams-setti
 export { TeamsController } from './controller.js';
 export { TeamsChannelTab, defineTeamsChannelTab } from './channel-tab.js';
 export { TeamsFilesPanel, defineTeamsFilesPanel } from './files-panel.js';
-export { TeamsPresentationPreview, defineTeamsPresentationPreview, } from './presentation-preview.js';
+export { TeamsPresentationPreview, defineTeamsPresentationPreview } from './presentation-preview.js';
 export { TeamsContentPreview, defineTeamsContentPreview, type FileEmbeds, type SaveFileCopy, } from './content-preview.js';
 export { applyTeamsProps, listenTeamsEvents, type TeamsProps } from './bind.js';
 export * from './store.js';

package/dist/teams.js

@@ -1,7 +1,7 @@
-export { EMOJI, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_TAGS, TeamsApp, TeamsChannelTab, TeamsContentPreview, TeamsController, TeamsElement, TeamsFilesPanel, TeamsSettings, applyTeamsProps, colorFor, createTeams, dayLabel, defineAppRail, defineAvatar, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, definePrejoin, defineTeamsApp, defineTeamsChannelTab, defineTeamsContentPreview, defineTeamsFilesPanel, defineTeamsSettings, formatElapsed, formatSize, formatTime, icon, listenTeamsEvents, loadConfig, loadIdentity, parseIceLines, registerTeams, safeStorage, saveConfig, saveIdentity, withStyles } from './chunk-6UPGM3X2.js';
+export { EMOJI, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_TAGS, TeamsApp, TeamsChannelTab, TeamsContentPreview, TeamsController, TeamsElement, TeamsFilesPanel, TeamsSettings, applyTeamsProps, colorFor, createTeams, dayLabel, defineAppRail, defineAvatar, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, definePrejoin, defineTeamsApp, defineTeamsChannelTab, defineTeamsContentPreview, defineTeamsFilesPanel, defineTeamsSettings, formatElapsed, formatSize, formatTime, icon, listenTeamsEvents, loadConfig, loadIdentity, parseIceLines, registerTeams, safeStorage, saveConfig, saveIdentity, withStyles } from './chunk-7US5GCXF.js';
 export { TeamsPresentationPreview, defineTeamsPresentationPreview } from './chunk-SNV6YKPC.js';
 import './chunk-BCH2ZLWI.js';
-import './chunk-SCWCZSTE.js';
+import './chunk-O7APCA5N.js';
 import './chunk-M6GF5ED2.js';
 import './chunk-L7JV5FVE.js';
 import './chunk-OGNNNTKI.js';

package/dist/visio/format-pane-fields.d.ts

@@ -0,0 +1,42 @@
+import { type VisioShape, type VisioShapeFormatEdit } from 'ooxml-core/visio';
+import { visioShapeEffectValues, visioShapeFormattingState } from 'ooxml-core/visio/ui';
+export type PanePatch = Omit<VisioShapeFormatEdit, 'type' | 'pageId' | 'shapeId'>;
+/** Where a field sits: under the fill choices, under the line choices, or in Effects. */
+export type PaneFieldGroup = 'fill' | 'line' | 'effects';
+/** What a field reads its value from: the selection and its common formatting. */
+export interface PaneFieldContext {
+    shapes: readonly VisioShape[];
+    common: ReturnType<typeof visioShapeFormattingState>;
+    effects: readonly ReturnType<typeof visioShapeEffectValues>[];
+}
+export interface PaneField {
+    key: string;
+    label: string;
+    group: PaneFieldGroup;
+    /** A list of choices; without it the field is a number. */
+    options?: readonly {
+        value: string;
+        label: string;
+    }[];
+    /** Largest number accepted, and what the reason calls the value. */
+    max?: number;
+    step?: string;
+    name?: string;
+    /** The selection's value as field text; empty when the shapes differ. */
+    read(context: PaneFieldContext): string;
+    patch(value: number, context: PaneFieldContext): PanePatch;
+}
+/**
+ * The Format Shape pane's fields beyond colour, transparency, width and dash: Visio's fill
+ * pattern, line cap, line ends and rounding, and the Effects section. Each is one existing
+ * `format-shape` property, read from the selection and applied at once.
+ */
+export declare const PANE_FIELDS: readonly PaneField[];
+export declare function paneFieldContext(shapes: readonly VisioShape[]): PaneFieldContext;
+/** The glow colour is a colour control of its own; the patch keeps the glow's other values. */
+export declare const glowColorPatch: (shapes: readonly VisioShape[], color: string) => PanePatch;
+/** One labelled row with a select or number input carrying `data-pane-field`. */
+export declare function paneFieldRow(doc: Document, field: PaneField): {
+    row: HTMLLabelElement;
+    input: HTMLInputElement | HTMLSelectElement;
+};

package/dist/visio/format-pane-view.d.ts

@@ -0,0 +1,44 @@
+import type { OfficeUiColorGrid } from '../controls.js';
+import { type PaneFieldGroup } from './format-pane-fields.js';
+export type PaneTarget = 'fill' | 'line';
+export type PaneNumber = 'fillTransparency' | 'lineTransparency' | 'lineWeight';
+/** Every colour the pane sets: the two paints, the pattern's background and the glow. */
+export type PaneColor = PaneTarget | 'fillBackground' | 'glow';
+export type PaneSection = PaneFieldGroup;
+/** A button showing a colour that opens the shared colour grid under it. */
+export interface FormatPaneColor {
+    row: HTMLElement;
+    button: HTMLButtonElement;
+    grid: OfficeUiColorGrid;
+}
+export interface FormatPaneSection {
+    set: HTMLFieldSetElement;
+    none: HTMLInputElement;
+    solid: HTMLInputElement;
+    /** Everything that only applies to a visible fill or line. */
+    details: HTMLElement;
+}
+export interface FormatPaneView {
+    section: HTMLElement;
+    hint: HTMLElement;
+    fill: FormatPaneSection;
+    line: FormatPaneSection;
+    effects: HTMLFieldSetElement;
+    colors: Record<PaneColor, FormatPaneColor>;
+    numbers: Record<PaneNumber, HTMLInputElement>;
+    dash: HTMLSelectElement;
+    /** The fields of `PANE_FIELDS`, by key. */
+    fields: Map<string, HTMLInputElement | HTMLSelectElement>;
+}
+export declare const GRADIENT_UNSUPPORTED = "A gradient fill is shown as saved, but its stops, angle and type cannot be changed yet.";
+/** Visio's dash types 1-23; 0 (no line) is the No line choice. */
+export declare const DASH_TYPES: {
+    value: string;
+    label: string;
+}[];
+/**
+ * The Format Shape task pane view: Fill, Line and Effects, as plain controls the pane class
+ * drives. Fill and Line start with their none/solid choice, colour and transparency; the rest of
+ * each section comes from `PANE_FIELDS`.
+ */
+export declare function createFormatPaneView(doc: Document): FormatPaneView;

package/dist/visio/index.d.ts

@@ -16,3 +16,4 @@ export type { ViewerEditState, VsdxExportResult } from 'ooxml-core/visio/ui';
 export type { VisioEdit, VisioGeometryEdit } from 'ooxml-core/visio';
 /** The built-in demo document, for the demo and tests. */
 export { demoDocument } from 'ooxml-core/visio/ui';
+export { RIBBON_ADD_IN_EVENT, type OfficeRibbonAddInEvent, type RibbonAddInCommand, type RibbonAddInCommandDetail, type RibbonAddInGroup, type RibbonAddInTab, } from '../ribbon/add-in-tabs.js';

package/dist/visio/page-setup-action.d.ts

@@ -26,4 +26,8 @@ export type VisioPageSetupCommand = {
     style: VisioBorderStyle | null;
 } | {
     op: 'page-breaks';
+}
+/** Design > Connectors > Show Line Jumps: the page's LineJumpCode on (1) or off (0). */
+ | {
+    op: 'line-jumps';
 };

package/dist/visio/ribbon-action.d.ts

@@ -1,3 +1,4 @@
+import type { VisioThemeColorRef } from 'ooxml-core/visio';
 import type { VisioBuiltInThemeId, VisioCalloutStyle, VisioChangeShapeTarget, VisioContainerStyle, VisioConnectorRoute, VisioShapeFormatEdit } from 'ooxml-core/visio';
 import type { TextCaseMode, VisioArrangement, VisioRuleSetId, VisioLayoutStyle } from 'ooxml-core/visio/ui';
 import type { VisioPageSetupCommand } from './page-setup-action.js';
@@ -8,8 +9,13 @@ export type VisioFormattingAction = {
 } | {
     type: 'font-color';
     value?: string;
+    theme?: VisioThemeColorRef;
 } | {
     type: 'text-bullets';
+}
+/** Home > Paragraph > Rotate Text: the text block turns 90 degrees counter-clockwise. */
+ | {
+    type: 'text-rotate';
 } | {
     type: 'text-indent';
     direction: 'increase' | 'decrease';
@@ -63,7 +69,7 @@ export type VisioDiagramPartAction = {
     style: VisioCalloutStyle;
 };
 /** Data-tab commands: import, refresh, data graphics, legend, windows and Shape Data. */
-export type VisioDataCommand = 'quick-import' | 'custom-import' | 'refresh' | 'graphic-text' | 'graphic-bar' | 'graphic-icon' | 'graphic-color' | 'graphic-remove' | 'legend' | 'external-data-window' | 'define-shape-data';
+export type VisioDataCommand = 'quick-import' | 'custom-import' | 'refresh' | 'graphic-text' | 'graphic-bar' | 'graphic-icon' | 'graphic-color' | 'graphic-remove' | 'legend' | 'legend-horizontal' | 'external-data-window' | 'define-shape-data';
 /** Arrangement, layout, layer, selection, view and output commands (viewer-layout and friends). */
 export type VisioLayoutAction = {
     type: 'auto-align';
@@ -84,6 +90,8 @@ export type VisioLayoutAction = {
     type: 'guides';
 } | {
     type: 'dynamic-grid';
+} | {
+    type: 'auto-connect';
 } | {
     type: 'drawing-explorer';
 } | {
@@ -116,10 +124,11 @@ export type VisioRibbonAction = VisioFormattingAction | VisioLayoutAction | {
 } | {
     type: 'text-feature';
     feature: VisioTextFeature;
-} | {
-    type: 'paint-properties';
-} | {
+}
+/** Opens the Format Shape task pane, at one of its sections when given. */
+ | {
     type: 'format-shape-pane';
+    section?: 'fill' | 'line' | 'effects';
 } | {
     type: 'page-theme';
     theme?: VisioBuiltInThemeId | 'none';
@@ -144,9 +153,11 @@ export type VisioRibbonAction = VisioFormattingAction | VisioLayoutAction | {
 } | {
     type: 'flip';
     axis: 'horizontal' | 'vertical';
-} | {
+}
+/** A Basic Shapes outline, or `document:<id>` for a master of the drawing's own stencil. */
+ | {
     type: 'change-shape';
-    shape: VisioChangeShapeTarget;
+    shape: VisioChangeShapeTarget | `document:${string}`;
 } | VisioDiagramPartAction | {
     type: 'pane';
     pane: 'shapes' | 'inspector';

package/dist/visio/ribbon-change-shape.d.ts

@@ -1,11 +1,22 @@
 import type { OfficeGalleryState, OfficeUiGallery } from '../ribbon/gallery.js';
-/** Gallery state for the Basic Shapes; `reason` disables every tile and names why. */
-export declare function changeShapeState(reason: string | undefined): OfficeGalleryState;
+/** A master of the drawing a stencil shape can change to; `preview` is its drawn SVG markup. */
+export interface ChangeShapeMaster {
+    id: string;
+    name: string;
+    preview?: string;
+}
 /**
- * Home > Editing > Change Shape: the shared `office-ui-gallery` of the Basic Shapes masters. A
- * pick raises `{ type: 'change-shape', shape }`; the viewer keeps `disabled` and the trigger's
- * tooltip in step with the selection (`syncChangeShape`).
+ * Gallery state: the Basic Shapes for a shape drawn here; for a stencil shape the other masters
+ * of the Document Stencil (`masters`) and, when `builtIn` allows, the Basic Shapes too (the shape
+ * then becomes an instance of that built-in master). `reason` disables every tile and names why.
+ */
+export declare function changeShapeState(reason: string | undefined, masters?: readonly ChangeShapeMaster[], builtIn?: boolean): OfficeGalleryState;
+/**
+ * Home > Editing > Change Shape: the shared `office-ui-gallery`. A pick raises
+ * `{ type: 'change-shape', shape }`, where `shape` is a Basic Shapes outline or `document:<id>`
+ * for a master of the drawing; the viewer keeps the tiles, `disabled` and the trigger's tooltip
+ * in step with the selection (`syncChangeShape`).
  */
 export declare function changeShapeGallery(doc: Document): OfficeUiGallery;
 /** Enable the gallery, or disable it with the reason as its tooltip (as unsupported commands do). */
-export declare function syncChangeShape(gallery: OfficeUiGallery, reason: string | undefined): void;
+export declare function syncChangeShape(gallery: OfficeUiGallery, reason: string | undefined, masters?: readonly ChangeShapeMaster[], builtIn?: boolean): void;

package/dist/visio/ribbon-color-menu.d.ts

@@ -0,0 +1,29 @@
+import { type VisioPage, type VisioThemeColorRef } from 'ooxml-core/visio';
+import type { OfficeColorPick, OfficeUiColorGrid } from '../controls.js';
+import type { VisioFormattingAction } from './ribbon-action.js';
+/** What a colour menu paints: a shape's fill, its line, or its text. */
+export type ColorTarget = 'fill' | 'line' | 'font';
+export declare const MORE_COLORS = "More Colors...";
+/**
+ * Office's colour picker for a ribbon menu or the Format Shape pane: Theme Colors, Standard
+ * Colors, recent colours, No Fill or No Line, and More Colors. `data-color-grid` names the target.
+ */
+export declare function colorGrid(doc: Document, target: ColorTarget): OfficeUiColorGrid;
+/**
+ * The formatting action a picked colour (`#rrggbb` or `'none'`) stands for. `theme` is the Theme
+ * Colors swatch it came from: the colour is then saved as Visio's theme formula.
+ */
+export declare function colorAction(target: ColorTarget, color: string, theme?: VisioThemeColorRef): VisioFormattingAction;
+export declare const THEME_COLUMN_NAMES: readonly string[];
+/** The page's Theme Colors as the picker shows them: ten columns and the variant colours row. */
+export declare function pageThemeGrid(page: VisioPage | undefined): {
+    colors: string[];
+    variants: {
+        hex: string;
+        label: string;
+    }[];
+};
+/** The theme reference a pick from the grid stands for; undefined for a fixed colour. */
+export declare function pickedThemeColor(pick: OfficeColorPick): VisioThemeColorRef | undefined;
+/** The value all `values` share, or undefined when they differ or there are none. */
+export declare function commonColor(values: readonly (string | undefined)[]): string | undefined;

package/dist/visio/ribbon-inline-galleries.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Visio shows Quick Styles, Themes and Variants as a row of tiles in the ribbon, with a More
+ * button for the whole gallery. The shared `office-ui-gallery` draws that row (`mode="inline"`);
+ * this module decides how many tiles fit, because the ribbon does not fold its groups: a narrow
+ * viewer shows fewer tiles, and a phone-sized one shows the labelled drop-down button instead.
+ */
+/**
+ * `[minimum viewer width, tiles shown]`, widest first. The widths are where the Home and Design
+ * rows still fit the viewer with that many tiles. Two tiles are no wider than the labelled
+ * drop-down button, so they stay down to the phone layout, where the button returns.
+ */
+export declare const INLINE_GALLERY_STEPS: Readonly<Record<string, readonly (readonly [number, number])[]>>;
+/** How many tiles of gallery `id` a viewer `width` pixels wide shows inline (0: a drop-down). */
+export declare function inlineGalleryTiles(id: string, width: number): number;
+/** Marks a gallery inline at its widest size; `wireInlineGalleries` narrows it to the viewer. */
+export declare function inlineGallery(gallery: HTMLElement, id: string): void;
+/** Fits every inline gallery under `root` to a viewer `width` pixels wide. */
+export declare function fitInlineGalleries(root: ParentNode, width: number): void;
+/** Keeps the inline galleries fitted to the viewer's width. Returns the disposer. */
+export declare function wireInlineGalleries(host: HTMLElement, root: ParentNode): () => void;

package/dist/visio/ribbon-overflow.d.ts

@@ -0,0 +1,7 @@
+import { type RibbonGroupOverflow } from '../ribbon/group-overflow.js';
+/**
+ * Visio collapses ribbon groups into buttons, from the right, when the window is too narrow for
+ * them (on Home: Editing first, Clipboard last). The folding is ooxml-ui's shared
+ * `attachRibbonGroupOverflow`; this supplies Visio's group icons.
+ */
+export declare function wireRibbonOverflow(ribbon: HTMLElement): RibbonGroupOverflow;

package/dist/visio/ribbon-review.d.ts

@@ -1,4 +1,7 @@
-/** Visio's Process tab: Subprocess and Diagram Validation (this viewer's generic rules). */
+/**
+ * Visio's Process tab: Subprocess, Diagram Validation (this viewer's generic rules) and SharePoint
+ * Workflow, which is shown disabled because no server is connected.
+ */
 export declare function buildProcessPanel(doc: Document, panel: HTMLElement): void;
-/** Visio's Review tab: Proofing, Language, Comments and Reports. */
+/** Visio's Review tab: Proofing, Accessibility, Language, Comments and Reports. */
 export declare function buildReviewPanel(doc: Document, panel: HTMLElement): void;

package/dist/visio/ribbon-router.d.ts

@@ -29,8 +29,8 @@ export interface RibbonTargets {
     insert(item: VisioInsertItem): void;
     data(command: VisioDataCommand): void;
     textFeature(feature: VisioTextFeature): void;
-    showPaintProperties(): void;
-    showFormatShape(): void;
+    /** Opens the Format Shape task pane, at a section when given. */
+    showFormatPane(section?: 'fill' | 'line' | 'effects'): void;
     pageTheme(action: Extract<VisioRibbonAction, {
         type: 'page-theme';
     }>): void;
@@ -45,7 +45,7 @@ export interface RibbonTargets {
     toggleFullscreen(): void;
     present(): void;
     togglePane(pane: 'shapes' | 'inspector'): void;
-    reveal(panel: 'edit' | 'notes' | 'selection', focusText: boolean): void;
+    reveal(panel: 'edit' | 'notes' | 'selection' | 'format', focusText: boolean): void;
     fit(mode: 'page' | 'width'): void;
     focusSearch(): void;
     focusReplace(): void;

package/dist/visio/ribbon-shape-styles.d.ts

@@ -7,7 +7,10 @@ export declare const quickStyleItemId: (color: VisioQuickStyleColor, matrix: num
 /** The gallery's items: one row per style matrix, one column per theme colour, as in Visio. */
 export declare function quickStyleItems(): OfficeGalleryItem[];
 export declare function quickStyleGalleryState(disabled: boolean): OfficeGalleryState;
-/** Home > Shape Styles > Quick Styles: the shared Office gallery raising typed format actions. */
+/**
+ * Home > Shape Styles > Quick Styles: the shared Office gallery, shown as Visio's row of tiles with
+ * a More button, raising typed format actions.
+ */
 export declare function quickStyleGallery(doc: Document): HTMLElement;
 /** Stable menu ids of the effect presets, shared with the selection state sync. */
 export declare const glowItemId: (size: number, accent: number) => string;

package/dist/visio/ribbon-style-options.d.ts

@@ -1,5 +1,6 @@
 import type { CommandSpec } from './ribbon-parts.js';
-/** The common Office solid font colors, with an explicit typed action per entry. */
-export declare function fontColorOptions(): CommandSpec[];
-/** Supported solid paints use the shared Office menu and source-backed format actions. */
+/**
+ * The commands under the colour grid of Home > Fill and Line (`colorGrid` supplies the colours,
+ * No Fill or No Line and More Colors): line weight and pattern, and the paint options dialog.
+ */
 export declare function paintOptions(target: 'fill' | 'line'): CommandSpec[];

package/dist/visio/shapes-document.d.ts

@@ -0,0 +1,29 @@
+import { type VisioDocument, type VisioMaster } from 'ooxml-core/visio';
+import type { Master } from './stencil-catalog.js';
+/** The stencil of the drawing's own masters, as Visio's Document Stencil. */
+export declare const DOCUMENT_STENCIL_ID = "document";
+export declare const DOCUMENT_STENCIL_NAME = "Document Stencil";
+/** `data-master` and drag payload prefix of a document master; the rest is the master ID. */
+export declare const DOCUMENT_MASTER_PREFIX = "document:";
+/** Masters drawn in the Shapes window; a drawing with more lists the first ones. */
+export declare const DOCUMENT_MASTER_LIMIT = 200;
+/** What the Shapes window shows for one drawing. */
+export interface ShapesDocument {
+    /** Changes when the list has to be drawn again. */
+    key: string;
+    /** The document stencil's masters; empty when the drawing has none. */
+    masters: readonly Master[];
+    /** Built-in stencils the drawing docks (its Stencil windows), in window order. */
+    docked: readonly string[];
+    /** Docked stencil files with no built-in counterpart, by file name: listed, not openable. */
+    unavailable: readonly string[];
+    /** Masters beyond `DOCUMENT_MASTER_LIMIT` that are not listed. */
+    omitted: number;
+}
+export declare const EMPTY_SHAPES_DOCUMENT: ShapesDocument;
+/** The drawing's master for a `document:<id>` master id. */
+export declare function documentMaster(model: VisioDocument | null | undefined, id: string): VisioMaster | undefined;
+/** The Shapes window content of a drawing: its document stencil and the stencils it docks. */
+export declare function shapesDocument(model: VisioDocument | null | undefined): ShapesDocument;
+/** The Shapes window section of a docked stencil file that has no built-in stand-in. */
+export declare function unavailableStencil(doc: Document, file: string): HTMLElement;

package/dist/visio/shapes-sections.d.ts

@@ -1,12 +1,26 @@
 import { type Master } from './stencil-catalog.js';
-/** Per-viewer Shapes window preferences: opened stencils and each stencil's Quick Shapes. */
-export declare const SHAPES_STORAGE_KEY = "ooxml-ui.visio.shapes";
+import { type ShapesDocument } from './shapes-document.js';
+export { SHAPES_STORAGE_KEY, currentQuickShapes } from './shapes-storage.js';
+/** The Stencils view of one Shapes window. */
+export interface StencilsView {
+    /** The More Shapes and master menus; the caller puts them on the pane. */
+    menus: HTMLElement[];
+    /**
+     * Show a drawing's document stencil and the stencils it docks; a no-op for the same content.
+     * `opened` is false after an edit of the drawing that is showing: folded and unfolded stencils
+     * stay as the user has them, and a Document Stencil that appears then starts folded.
+     */
+    setDocument(next: ShapesDocument, opened?: boolean): void;
+}
 /** One master button: drag it onto the page, or activate it to add it at the page centre. */
 export declare function masterButton(doc: Document, master: Master): HTMLLIElement;
 export declare function masterList(doc: Document, masters: readonly Master[]): HTMLUListElement;
 /**
  * The Stencils view below the view tabs: More Shapes (a menu of the built-in stencils), Quick
- * Shapes (favourites across the open stencils) and one collapsible section per open stencil,
- * Basic Shapes first. Opened stencils and Quick Shapes persist per viewer in localStorage.
+ * Shapes (favourites across the open stencils) and one collapsible section per open stencil.
+ * A drawing's own masters come first as its Document Stencil, then the stencils the drawing docks,
+ * then Basic Shapes and the stencils the user opened. The first of the drawing's stencils is the
+ * one showing, as in Visio; the others start folded. Opened stencils and Quick Shapes persist per
+ * viewer in localStorage; what a drawing docks is not persisted.
  */
-export declare function buildStencilsView(doc: Document, panel: HTMLElement, pane: HTMLElement): HTMLElement[];
+export declare function buildStencilsView(doc: Document, panel: HTMLElement, pane: HTMLElement): StencilsView;

package/dist/visio/shapes-storage.d.ts

@@ -0,0 +1,15 @@
+import { type Master } from './stencil-catalog.js';
+/** Per-viewer Shapes window preferences: opened stencils and each stencil's Quick Shapes. */
+export declare const SHAPES_STORAGE_KEY = "ooxml-ui.visio.shapes";
+export interface SavedShapes {
+    open: string[];
+    quick: Record<string, string[]>;
+}
+export declare function loadShapes(doc: Document): SavedShapes;
+export declare function saveShapes(doc: Document, saved: SavedShapes): void;
+/**
+ * The Quick Shapes of the current stencil, for the AutoConnect mini toolbar: the stencil the user
+ * opened last, else the first one the drawing docks (`docked`), else Basic Shapes. Reads the
+ * saved preferences, so it follows the Shapes window.
+ */
+export declare function currentQuickShapes(doc: Document, docked?: readonly string[], limit?: number): Master[];

package/dist/visio/shapes-window.d.ts

@@ -1,3 +1,10 @@
+import type { ShapesDocument } from './shapes-document.js';
+/**
+ * Show a drawing in a Shapes window: its Document Stencil, the stencils it docks, and its masters
+ * in Search shapes. Cheap to call again for the same drawing. `opened` is false when the same
+ * drawing was only edited, so the stencils the user unfolded stay as they are.
+ */
+export declare function setShapesDocument(pane: HTMLElement, next: ShapesDocument, opened?: boolean): void;
 export { BASIC_SHAPES, findMaster, masterCreation, type Master, type MasterCreation, } from './stencil-catalog.js';
 /** Drag payload type for a stencil master; the value is the master id. */
 export declare const MASTER_MIME = "application/x-visio-viewer-master";

package/dist/visio/stencil-catalog.d.ts

@@ -9,6 +9,10 @@ export interface Master {
         width: number;
         height: number;
     };
+    /** A drawn preview that replaces `path` (a master of the drawing's own stencil). */
+    draw?: () => SVGElement | undefined;
+    /** Why the master cannot be dropped; it is listed disabled with this reason. */
+    unsupported?: string;
 }
 export interface Stencil {
     id: string;

package/dist/visio/text-measurer.d.ts

@@ -0,0 +1,25 @@
+import { type VisioTextMeasurer } from 'ooxml-core/visio';
+/** The part of a 2D canvas context that measuring needs; a worker's OffscreenCanvas has it too. */
+export interface MeasureContext {
+    font: string;
+    fontKerning?: string;
+    measureText(text: string): {
+        width: number;
+    };
+}
+/**
+ * Measures text with the browser's fonts for what the core's own tables do not cover (other
+ * families, italics, non-ASCII text). Visio's TEXTWIDTH adds up unkerned, unhinted advances, so
+ * kerning is turned off and the text is measured at 1000 px and scaled.
+ *
+ * A canvas silently draws a missing font with a fallback, which would measure a wrong size: a
+ * family counts as installed only when it measures differently from both generic fallbacks, and
+ * anything else is reported as not measurable. Superscript, subscript and small caps are not
+ * measured either.
+ */
+export declare function createCanvasTextMeasurer(context: MeasureContext): VisioTextMeasurer;
+/**
+ * Give the core a browser measurer where a canvas exists (the page, or a worker with
+ * OffscreenCanvas). Without one the core measures only what its own tables cover.
+ */
+export declare function installBrowserTextMeasurer(): boolean;

package/dist/visio/viewer-auto-connect-parts.d.ts

@@ -0,0 +1,12 @@
+import type { VisioAutoConnectDirection } from 'ooxml-core/visio/ui';
+import type { Master } from './stencil-catalog.js';
+/** An arrow or bar position in viewport pixels. */
+export interface AutoConnectArrow {
+    direction: VisioAutoConnectDirection;
+    x: number;
+    y: number;
+}
+/** One AutoConnect arrow. Out of the tab order: the arrows are a pointer aid. */
+export declare function autoConnectArrow(doc: Document, arrow: AutoConnectArrow, hasNeighbour: boolean): HTMLButtonElement;
+/** The mini toolbar of Quick Shapes beside an arrow. */
+export declare function autoConnectBar(doc: Document, arrow: AutoConnectArrow, masters: readonly Master[]): HTMLElement;

package/dist/visio/viewer-auto-connect.d.ts

@@ -0,0 +1,33 @@
+import { type VisioAutoConnectDirection } from 'ooxml-core/visio/ui';
+import type { ViewerController, ViewerState } from './controller.js';
+export interface AutoConnectHost {
+    /** The viewer's shadow root (a document in tests): the ribbon check box and event scope. */
+    root: ShadowRoot | Document;
+    viewport: HTMLElement;
+    controller: ViewerController;
+    announce(message: string): void;
+    edit(run: () => Promise<void>, message: string): void;
+    /** Arrows belong to the Pointer tool. */
+    pointerTool(): boolean;
+}
+/**
+ * View > Visual Aids > AutoConnect, on by default as in Visio. Resting the mouse on a top-level
+ * two-dimensional shape with the Pointer tool shows an arrow outside each side. An arrow shows a
+ * mini toolbar with the current stencil's first four Quick Shapes: choosing one adds it one gap
+ * away in that direction with a connector glued to both shapes, as one undoable step. Clicking
+ * the arrow itself connects to the neighbouring shape it points at, or adds the first Quick Shape
+ * when there is none. Arrows are a mouse and pen aid: touch and the keyboard never show them.
+ */
+export declare class ViewerAutoConnect {
+    #private;
+    private readonly host;
+    constructor(host: AutoConnectHost);
+    get enabled(): boolean;
+    /** The shape whose arrows show, for tests and status text. */
+    get source(): string | undefined;
+    toggle(): void;
+    render(state: ViewerState): void;
+    /** Connects in `direction`: to `masterId` as a new shape, else to the neighbour or first Quick Shape. */
+    connect(direction: VisioAutoConnectDirection, masterId?: string): void;
+    wire(): () => void;
+}