ooxml-ui 1.25.0 → 1.26.0

package/README.md

@@ -116,20 +116,22 @@ panel shows its tiles without visible labels, sharing the panel's width with the
 previews at their size, and its arrow keys only move focus: PowerPoint's inspector
 uses it for Text Warp and Quick Styles, whose picks apply at once.
 
-| Entry               | Contents                                                                                                     |
-| ------------------- | ------------------------------------------------------------------------------------------------------------ |
-| `ooxml-ui`          | everything below plus `registerOfficeUi()` and `OFFICE_UI_TAGS`                                              |
-| `ooxml-ui/theme`    | `THEME_CSS`, `installOfficeUiTheme()` (tokens, dark mode, forced-colors, touch targets)                      |
-| `ooxml-ui/icons`    | icon registry (`registerIcon`, `getIcon`, `listIcons`) and `<office-ui-icon>`                                |
-| `ooxml-ui/controls` | button, checkbox, switch, select, ribbon group, toolbar, dialog, status bar and item, zoom slider, tab strip |
-| `ooxml-ui/presence` | `<office-ui-presence>` avatar stack for collaboration awareness                                              |
-| `ooxml-ui/smartart` | `<office-ui-smartart>`: draws a core `DiagramDrawing` as SVG                                                 |
-| `ooxml-ui/teams`    | the Teams elements and `<teams-app>`                                                                         |
-| `ooxml-ui/suite`    | browser document persistence the Office suite uses                                                           |
-| `ooxml-ui/docx`     | the Word editor and viewer elements (`<docx-editor>`)                                                        |
-| `ooxml-ui/xlsx`     | the Excel editor and viewer elements (`<xlsx-editor>`)                                                       |
-| `ooxml-ui/visio`    | the Visio editor and viewer elements (`<visio-viewer>`)                                                      |
-| `ooxml-ui/pptx`     | the PowerPoint renderer, editor and web components; also `/pptx/theme`, `/loader`, `/i18n`, `/ai`, `/dom`    |
+| Entry                           | Contents                                                                                                     |
+| ------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| `ooxml-ui`                      | everything below plus `registerOfficeUi()` and `OFFICE_UI_TAGS`                                              |
+| `ooxml-ui/theme`                | `THEME_CSS`, `installOfficeUiTheme()` (tokens, dark mode, forced-colors, touch targets)                      |
+| `ooxml-ui/icons`                | icon registry (`registerIcon`, `getIcon`, `listIcons`) and `<office-ui-icon>`                                |
+| `ooxml-ui/controls`             | button, checkbox, switch, select, ribbon group, toolbar, dialog, status bar and item, zoom slider, tab strip |
+| `ooxml-ui/presence`             | `<office-ui-presence>` avatar stack for collaboration awareness                                              |
+| `ooxml-ui/smartart`             | `<office-ui-smartart>` (draws a core `DiagramDrawing`), the SmartArt picker, text pane and Design galleries  |
+| `ooxml-ui/chart-format-locales` | the Chart Format pane's own translations (`CHART_FORMAT_STRINGS`), for a product dictionary to extend        |
+| `ooxml-ui/teams`                | the Teams elements and `<teams-app>`                                                                         |
+| `ooxml-ui/bindings`             | the framework binding kit; `/bindings/react`, `/vue` and `/solid` are its component factories                |
+| `ooxml-ui/suite`                | browser document persistence the Office suite uses                                                           |
+| `ooxml-ui/docx`                 | the Word editor and viewer elements (`<docx-editor>`)                                                        |
+| `ooxml-ui/xlsx`                 | the Excel editor and viewer elements (`<xlsx-editor>`)                                                       |
+| `ooxml-ui/visio`                | the Visio editor and viewer elements (`<visio-viewer>`)                                                      |
+| `ooxml-ui/pptx`                 | the PowerPoint renderer, editor and web components; also `/pptx/theme`, `/loader`, `/i18n`, `/ai`, `/dom`    |
 
 Every entry declares an `import` and a `default` export condition, so CommonJS consumers on Node 20.19+ or 22.12+ load it through `require(esm)`.
 
@@ -149,6 +151,39 @@ Importing an entry never touches the DOM (SSR-safe). Elements are defined by the
 `register*` functions, which are idempotent, no-ops without a `window`, and refuse to coexist
 with an incompatible build of this package.
 
+## Framework binding kit (`ooxml-ui/bindings`)
+
+The machinery every product's framework adapters share (Word, Excel, Visio and Teams), so a product
+binding only declares what is its own. It has no framework imports and touches no DOM at import.
+
+- **A contract per product** (`BindingContract`): `props` lists each forwarded prop in forwarding
+  order with its policy (`always`, `changed`, `defined`: written only when set and changed, or
+  `manual`: left to the product's mount function), an optional `fallback`, equality (`same`),
+  `initial` value and `apply`; `events` maps each element event to its handler option
+  (`onDocumentChange`) and arguments (`eventArgs.detail`, `.event` for cancelable events such as
+  `file-command`, `.readOnly`, `.detailAndEvent`, `.field(name)`), and `readOnlyChange` adds the
+  `v-model:readOnly` / `[(readOnly)]` model that mirrors the host's own switch; `handle` lists the
+  imperative handle's members.
+- **`bindElement(element, contract, handlers)`** listens to the events (reading the current
+  handlers at event time) and forwards changed props; the product's mount function keeps what is
+  its own around it (Word's document model after collaboration, Excel's workbook, bytes and `src`
+  supersession, Visio's revision-aware patches, the Teams host class with `syncClassName`).
+- **Helpers**: `createPropTracker`, `shallowEqual`, `sameList`, `createSrcLoader`, `nameFromUrl`,
+  `deferredHandle` (a handle that throws a clear error before mount), `installHandle` (the same
+  members on an Angular component's prototype), `pickProps`, `eventOptions`, `contractOptions`,
+  `angularOutputs` and the framework naming rules (`svelteHandlerName`, `angularOutputName`).
+- **Component factories** for frameworks that need no compiler: `createReactBinding`
+  (`ooxml-ui/bindings/react`, a `forwardRef` component whose ref is the handle), `defineVueBinding`
+  (`/vue`: props, kebab-case emits, `v-model` and `expose` from the contract) and
+  `createSolidBinding` (`/solid`: a host element, reactive options and an `editorRef` callback).
+  React, Vue and Solid are optional peer dependencies. Angular components and `.svelte` files need
+  their compilers, so they stay in each product, as small as the helpers above make them.
+
+Each product checks every adapter against its contract (`contract-parity.test.ts` in the Word,
+Excel and Visio bindings, `bindings-contract.test.ts` in Teams). How a product defines a contract,
+how `bindElement` and the handle work, and how each framework adapter consumes them is in
+`src/ui/src/bindings/README.md`.
+
 ## One theme for composed editors
 
 Use the shared `--office-*` CSS tokens on a common ancestor of the canvas and its standalone
@@ -236,7 +271,12 @@ Arrow navigation stays within the current menu and skips disabled entries.
 | `office-ui-gallery`                                   | `state` `{ id, label, moreLabel?, disabled?, command?, sections: [{ title?, columns, tileWidth, tileHeight, items: [{ id, label, applied?, preview? }] }], inline? }`, `mode` (`inline`, `panel`), `compact` (a panel of unlabelled tiles), `chevron-only`, `icon`; `open`, `disabled`, `close()`; tiles in light DOM (`data-gallery-item`), previews parsed by `parseSvgPreview`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `office-gallery-pick` `{ gallery, itemId }`                                                                                                                                                                                                       |
 | `office-ui-comments-pane`                             | `threads` `[{ id, anchorLabel?, resolved, comments: [{ id, author, initials?, color?, created?, text, edited? }] }]`, `activeThreadId`, `read-only` (controls disabled), `list-only` (navigation list only), `closable`, `add-disabled`, `currentAuthor` (may edit own comments), `labels` (every string), `classNames` (`{ thread?, comment? }` product hook classes), `locale`; arrows, Home and End between threads, Enter or Space selects                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | `comment-add` `{ text }`, `comment-reply` `{ threadId, text }`, `comment-edit` `{ threadId, commentId, text }`, `comment-delete` `{ threadId, commentId }`, `thread-resolve` / `thread-reopen` / `thread-select` `{ threadId }`, `comments-close` |
 | `office-ui-presence`                                  | `participants`, `max`, `label`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | `office-presence-select` `{ id }`                                                                                                                                                                                                                 |
-| `office-ui-smartart`                                  | `drawing` (core `DiagramDrawing`), `schemeColors`, `label`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | `office-smartart-render` (render report)                                                                                                                                                                                                          |
+| `office-ui-smartart`                                  | `drawing` (core `DiagramDrawing`), `schemeColors`, `schemeFonts`, `label`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `office-smartart-render` (render report)                                                                                                                                                                                                          |
+| `office-ui-smartart-picker`                           | `categories`, `layouts`, `labels`, `drawPreview`, `value`, `category`, `items-editor`, `accent`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `office-smartart-change` (every choice or edit), `office-smartart-activate` (double-click or Enter on a tile)                                                                                                                                     |
+| `office-ui-smartart-text-pane`                        | `nodes` (`{ id, text, level, marker?, style?, canMoveUp?, canMoveDown?, canRemove?, canAddChild? }`), `selected`, `labels`, `closable`, `tools`, `disabled`, `appendDisabled`, `notes` (the host applies every request)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | `office-smartart-text-change` `{ id, text }`, `office-smartart-node-add` / `-promote` / `-demote` / `-remove` / `-select` `{ id }`, `office-smartart-text-pane-close`, and with `tools` `-append`, `-move`, `-add-child`, `-style`                |
+| `office-ui-chart-picker`                              | `types`, `groupings`, `groupedTypes`, `labels`, `drawPreview`, `value` `{ type, grouping, title, data? }`, `change-only`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | `office-chart-change` (every edit, detail is the value)                                                                                                                                                                                           |
+| `office-ui-chart-data-sheet`                          | `data` `{ categories, series: [{ name, values }] }`, `labels`, `highlight`, `disabled`, `locale`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | `office-chart-data-change` `{ edits, data }` (the host maps the edits onto its model)                                                                                                                                                             |
+| `office-ui-chart-format-pane`                         | `source` (`ChartFormatSource`) or `chartSpace`, `target`, `theme`, `translateLabel`, `locale`, `disabled`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `office-chart-format-edit` `{ target, field, value, intent }`, `office-chart-format-target` `{ target }`, `office-chart-format-close`                                                                                                             |
 | `office-ui-icon`                                      | `name`, `label`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | none                                                                                                                                                                                                                                              |
 
 The local profile behind `office-ui-account` is stored on the device only, under one suite-wide
@@ -250,6 +290,17 @@ steps back; disabled controls are dimmed and never run.
 
 Elements with intent events read their event name and test-id prefix from static class fields (`requestEvent`, `testIdPrefix`), so a product can register a subclass under its own tag that keeps its published contract.
 
+`office-ui-dialog` keeps focus inside the dialog while it is open. Tab and Shift+Tab cycle through
+the body's controls in order, including the focusable controls inside the shadow root of a composite
+element slotted into the body (a picker such as `office-ui-chart-picker` is not itself focusable), and
+the close button; focus returns to the previous element on close.
+
+Chart and SmartArt editing elements (`office-ui-chart-format-pane`, `office-ui-chart-data-sheet`,
+`office-ui-chart-picker`, `office-ui-smartart-picker`, `office-ui-smartart-text-pane`) take the document
+data as properties and report each change as an event; they never write a model. Their events, the
+Chart Design galleries and the translations are described in `src/ui/src/chart/README.md` and
+`src/ui/src/smartart/README.md`.
+
 Setting a property never emits an event; only user activation does. Controls honour
 `prefers-color-scheme`, `forced-colors: active` (system colours and a visible focus ring) and
 coarse pointers (44px targets through `--office-target-size`).
@@ -353,10 +404,22 @@ event detail (`approximatedGeometries`, `approximatedFills`, `flattened3d`); not
 ## Scope
 
 Only what every Office product needs lives here. Product-specific ribbon content (PowerPoint
-slides, transitions, animations; Word styles and review) lives in the product's own subpath (`src/ui/src/<product>/`), not in the shared entries. The
-`pptx-ui-*` tags are thin subclasses of the `office-ui-*` elements; `docs/ooxml-ui-plan.md` in the
-repository keeps the decisions that still apply (layout, style rules, the tag aliases and the
-token map).
+slides, transitions, animations; Word styles and review) lives in the product's own subpath
+(`src/ui/src/<product>/`), not in the shared entries. Most `pptx-ui-*` tags are thin subclasses of the
+`office-ui-*` elements; the chart and SmartArt dialogs (`pptx-ui-insert-chart-dialog`,
+`pptx-ui-insert-smartart-dialog`) are PowerPoint's own elements built from the shared pickers, and
+`pptx-ui-chart-format-pane` is the one subclass of a shared chart element. The aliases are listed in
+`src/ui/src/pptx/web-components/README.md`. `docs/ooxml-ui-plan.md` in the repository keeps the
+decisions that still apply (layout, style rules, the tag aliases and the token map).
+
+### PowerPoint headless controllers
+
+PowerPoint's framework-free state (undo history, autosave, autosave recovery and the collaboration
+session) lives in `src/ui/src/pptx/render/controller/` as headless
+controllers: plain objects with `getSnapshot()`, `subscribe()` and typed actions, which each binding
+adapts with one generic store adapter. The convention is documented in the header of
+`src/ui/src/pptx/render/controller/controller.ts`; the rule for when logic belongs there or in core is
+Rule 2 of `viewers/pptx/AGENTS.md`.
 
 ## Development
 

package/custom-elements.json

@@ -835,6 +835,140 @@
 				}
 			]
 		},
+		{
+			"kind": "javascript-module",
+			"path": "chart/data-sheet.ts",
+			"declarations": [
+				{
+					"kind": "class",
+					"name": "OfficeUiChartDataSheet",
+					"tagName": "office-ui-chart-data-sheet",
+					"customElement": true,
+					"description": "`<office-ui-chart-data-sheet>`: the categories x series table of a chart's \"Edit Data\" view, shared by every product. Series names run across the header row, category labels down the first column, values in between; the toolbar adds a category or a series and each header has a remove button while more than one is left. Arrow keys, Enter, Tab, F2 and Escape behave as in the spreadsheet PowerPoint opens; pasting a tab-separated block (from Excel, Word or this sheet) fills cells from the focused one, adding the series and categories it needs. Values are read and shown in `locale`'s number convention (the browser's when unset, as Office follows the system's); a value that is not a number is refused and the cell restored. The host sets `data` (`{ categories, series: [{ name, values }] }`), `labels` (translated), `highlight` and `disabled`, and maps `office-chart-data-change` `{ edits, data }` onto its own chart model; the sheet shows the edited data at once and takes whatever `data` the host sets next.",
+					"attributes": [
+						{
+							"name": "disabled"
+						},
+						{
+							"name": "locale"
+						}
+					],
+					"members": [
+						{
+							"kind": "field",
+							"name": "data"
+						},
+						{
+							"kind": "field",
+							"name": "disabled",
+							"type": {
+								"text": "boolean"
+							}
+						},
+						{
+							"kind": "field",
+							"name": "highlight"
+						},
+						{
+							"kind": "field",
+							"name": "labels"
+						},
+						{
+							"kind": "field",
+							"name": "locale",
+							"type": {
+								"text": "string"
+							}
+						}
+					],
+					"events": [
+						{
+							"name": "office-chart-data-change"
+						}
+					]
+				}
+			],
+			"exports": [
+				{
+					"kind": "custom-element-definition",
+					"name": "office-ui-chart-data-sheet",
+					"declaration": {
+						"name": "OfficeUiChartDataSheet"
+					}
+				}
+			]
+		},
+		{
+			"kind": "javascript-module",
+			"path": "chart/format-pane.ts",
+			"declarations": [
+				{
+					"kind": "class",
+					"name": "OfficeUiChartFormatPane",
+					"tagName": "office-ui-chart-format-pane",
+					"customElement": true,
+					"description": "`<office-ui-chart-format-pane>`: the chart Format task pane every product shares (Format Chart Area, Format Data Series, Format Axis, ...): the element picker, Chart Options and Text Options, the icon tabs and their collapsible sections. Give it a `source` (what the chart reads as, see `ChartFormatSource`) or a `chartSpace` (read through `chartSpaceFormatSource`) and a `target` key; it applies nothing itself. Each committed field fires `office-chart-format-edit` with the field, its value and the typed `ChartEditIntent` (`applyChartEditIntent` runs it over a `ChartSpace`; other products map it onto their own edits), then repaints from the source the host sets back. The picker fires `office-chart-format-target`, Close and Escape `office-chart-format-close`. A source with a `slots.fill` name leaves that section to the host's light-DOM child with the same `slot`. Captions (`chartFormat.*` keys) come from the pane's own dictionary for `locale`; `translateLabel(key, params, fallback)` overrides the ones a product words differently. `disabled` makes every control read-only. It lays out in flow; a product docks it.",
+					"attributes": [
+						{
+							"name": "disabled"
+						}
+					],
+					"members": [
+						{
+							"kind": "field",
+							"name": "chartSpace"
+						},
+						{
+							"kind": "field",
+							"name": "disabled",
+							"type": {
+								"text": "boolean"
+							}
+						},
+						{
+							"kind": "field",
+							"name": "locale"
+						},
+						{
+							"kind": "field",
+							"name": "source"
+						},
+						{
+							"kind": "field",
+							"name": "target"
+						},
+						{
+							"kind": "field",
+							"name": "theme"
+						},
+						{
+							"kind": "field",
+							"name": "translateLabel"
+						}
+					],
+					"events": [
+						{
+							"name": "office-chart-format-close"
+						},
+						{
+							"name": "office-chart-format-edit"
+						},
+						{
+							"name": "office-chart-format-target"
+						}
+					]
+				}
+			],
+			"exports": [
+				{
+					"kind": "custom-element-definition",
+					"name": "office-ui-chart-format-pane",
+					"declaration": {
+						"name": "OfficeUiChartFormatPane"
+					}
+				}
+			]
+		},
 		{
 			"kind": "javascript-module",
 			"path": "dialog/chart-picker.ts",
@@ -1331,7 +1465,7 @@
 					"name": "OfficeUiColorGrid",
 					"tagName": "office-ui-color-grid",
 					"customElement": true,
-					"description": "`<office-ui-color-grid>`: Office's colour picker body. From the top: an optional `automatic-label` command (Automatic) and `none-label` command (No Fill, No Line), \"Theme Colors\" (ten columns, a base colour over its five lighter and darker variants, built from `themeColors`), \"Standard Colors\" (preceded by the `extraColors` row when a product has one, such as Visio's variant colours), \"Recent Colors\" when `recentColors` has any, and an optional `more-label` command (More Colors...). `value` (`#rrggbb`, `'none'` or `'automatic'`) marks the current choice. `themeNames` renames the ten columns and `variantLabel` names their variants (for a translated product). A product that computes its own swatches sets `palette` instead (one column per colour it can resolve, each with up to five variants; a missing one leaves its cell empty), and one that stores theme references marks the current swatch with `selectedTheme`. An empty `standardColors` leaves out Standard Colors. Choosing emits `office-color-pick` `{ color, source, label, theme?, index? }` (a theme swatch reports its column and variant, so a product can save a theme reference instead of the colour); the More Colors command emits `office-color-more`. Arrow keys move through the swatches and commands, Home and End jump to the ends; ArrowUp on the first row and ArrowDown on the last are left for a host menu. The element is only the grid: a product puts it in its own menu, popup or pane.",
+					"description": "`<office-ui-color-grid>`: Office's colour picker body. From the top: an optional `automatic-label` command (Automatic) and `none-label` command (No Fill, No Line), \"Theme Colors\" (ten columns, a base colour over its five lighter and darker variants, built from `themeColors`), \"Standard Colors\" (preceded by the `extraColors` row when a product has one, such as Visio's variant colours), \"Recent Colors\" when `recentColors` has any, and an optional `more-label` command (More Colors...). `value` (`#rrggbb`, `'none'` or `'automatic'`) marks the current choice. `themeNames` renames the ten columns and `variantLabel` names their variants (for a translated product). A product that computes its own swatches sets `palette` instead (one column per colour it can resolve, each with up to five variants; a missing one leaves its cell empty), and one that stores theme references marks the current swatch with `selectedTheme`. An empty `palette` leaves out Theme Colors and an empty `standardColors` leaves out Standard Colors, so a product can show Recent Colors on their own. `recentLabel` names the Recent Colors swatches (their hex by default). Choosing emits `office-color-pick` `{ color, source, label, theme?, index? }` (a theme swatch reports its column and variant, so a product can save a theme reference instead of the colour); the More Colors command emits `office-color-more`. Arrow keys move through the swatches and commands, Home and End jump to the ends; ArrowUp on the first row and ArrowDown on the last are left for a host menu. The element is only the grid: a product puts it in its own menu, popup or pane.",
 					"attributes": [
 						{
 							"name": "automatic-label"
@@ -1420,6 +1554,10 @@
 							},
 							"attribute": "recent-heading"
 						},
+						{
+							"kind": "field",
+							"name": "recentLabel"
+						},
 						{
 							"kind": "field",
 							"name": "selectedTheme"
@@ -3841,6 +3979,188 @@
 				}
 			]
 		},
+		{
+			"kind": "javascript-module",
+			"path": "smartart/smartart-picker.ts",
+			"declarations": [
+				{
+					"kind": "class",
+					"name": "OfficeUiSmartArtPicker",
+					"tagName": "office-ui-smartart-picker",
+					"customElement": true,
+					"description": "`<office-ui-smartart-picker>`: the body of every product's Insert SmartArt dialog: a category list, a gallery of layout tiles (`role=\"listbox\"`), and a pane with the chosen layout's large preview, name and its category's description. The product owns the dialog around it, the OK and Cancel buttons and the diagram model. The host sets `categories`, `layouts` and `labels` (translated), and optionally `drawPreview` (a live render; without it each tile draws its layout family in `accent`). `items-editor` adds a text box of node texts, one per line, seeded from the chosen layout's `defaultItems`. Read and write the choice with `value` and the shown category with `category`; choosing a category selects its first layout. Emits `office-smartart-change` with the value on every choice or edit, and `office-smartart-activate` with the value when a tile is double-clicked or Enter is pressed on it (the host inserts, as OK would).",
+					"attributes": [
+						{
+							"name": "accent"
+						},
+						{
+							"name": "items-editor"
+						}
+					],
+					"members": [
+						{
+							"kind": "field",
+							"name": "accent",
+							"type": {
+								"text": "string"
+							}
+						},
+						{
+							"kind": "field",
+							"name": "categories"
+						},
+						{
+							"kind": "field",
+							"name": "category"
+						},
+						{
+							"kind": "field",
+							"name": "drawPreview"
+						},
+						{
+							"kind": "field",
+							"name": "itemsEditor",
+							"type": {
+								"text": "boolean"
+							},
+							"attribute": "items-editor"
+						},
+						{
+							"kind": "field",
+							"name": "labels"
+						},
+						{
+							"kind": "field",
+							"name": "layouts"
+						},
+						{
+							"kind": "field",
+							"name": "value"
+						}
+					],
+					"events": [
+						{
+							"name": "office-smartart-activate"
+						},
+						{
+							"name": "office-smartart-change"
+						}
+					]
+				}
+			],
+			"exports": [
+				{
+					"kind": "custom-element-definition",
+					"name": "office-ui-smartart-picker",
+					"declaration": {
+						"name": "OfficeUiSmartArtPicker"
+					}
+				}
+			]
+		},
+		{
+			"kind": "javascript-module",
+			"path": "smartart/smartart-text-pane.ts",
+			"declarations": [
+				{
+					"kind": "class",
+					"name": "OfficeUiSmartArtTextPane",
+					"tagName": "office-ui-smartart-text-pane",
+					"customElement": true,
+					"description": "`<office-ui-smartart-text-pane>`: the SmartArt text pane every product shares. It shows the diagram's nodes as an outline of text lines indented by level and turns keys into requests the host applies to its diagram model (the pane never edits the model itself): - typing fires `office-smartart-text-change` (`{ id, text }`); - Enter fires `office-smartart-node-add` (add a node after this one, same level); - Tab and Shift+Tab fire `office-smartart-node-demote` and `office-smartart-node-promote`; - Backspace or Delete in an empty line fires `office-smartart-node-remove` (unless the line's `canRemove` is false); - focusing a line fires `office-smartart-node-select`; Up and Down move between lines. The node events carry `{ id }`. The host sets `nodes` again after applying a request and `selected` to the node to focus (the new node after Enter, the previous one after Backspace). `closable` adds a close button that fires `office-smartart-text-pane-close`. Strings come translated through `labels`. `tools` adds PowerPoint's inspector tools: a header button that fires `office-smartart-node-append`, and per line move up and down (`office-smartart-node-move`, `{ id, direction }`), add sub-item (`office-smartart-node-add-child`), remove (`office-smartart-node-remove`) and a style row (fill and text colour, bold, italic) that fires `office-smartart-node-style` (`{ id, style }`). `disabled` makes the pane read-only, `notes` adds hint lines under the outline and `appendDisabled` disables the header button.",
+					"attributes": [
+						{
+							"name": "append-disabled"
+						},
+						{
+							"name": "closable"
+						},
+						{
+							"name": "disabled"
+						},
+						{
+							"name": "selected"
+						},
+						{
+							"name": "tools"
+						}
+					],
+					"members": [
+						{
+							"kind": "field",
+							"name": "appendDisabled",
+							"type": {
+								"text": "boolean"
+							},
+							"attribute": "append-disabled"
+						},
+						{
+							"kind": "field",
+							"name": "closable",
+							"type": {
+								"text": "boolean"
+							}
+						},
+						{
+							"kind": "field",
+							"name": "disabled",
+							"type": {
+								"text": "boolean"
+							}
+						},
+						{
+							"kind": "field",
+							"name": "labels"
+						},
+						{
+							"kind": "field",
+							"name": "nodes"
+						},
+						{
+							"kind": "field",
+							"name": "notes"
+						},
+						{
+							"kind": "field",
+							"name": "selected",
+							"type": {
+								"text": "string"
+							}
+						},
+						{
+							"kind": "field",
+							"name": "tools",
+							"type": {
+								"text": "boolean"
+							}
+						}
+					],
+					"events": [
+						{
+							"name": "office-smartart-node-append"
+						},
+						{
+							"name": "office-smartart-node-select"
+						},
+						{
+							"name": "office-smartart-text-change"
+						},
+						{
+							"name": "office-smartart-text-pane-close"
+						}
+					]
+				}
+			],
+			"exports": [
+				{
+					"kind": "custom-element-definition",
+					"name": "office-ui-smartart-text-pane",
+					"declaration": {
+						"name": "OfficeUiSmartArtTextPane"
+					}
+				}
+			]
+		},
 		{
 			"kind": "javascript-module",
 			"path": "chrome/status-bar.ts",

package/dist/bindings/bind-element.d.ts

@@ -0,0 +1,29 @@
+import type { BindingContract, EventRule } from './contract.js';
+/** Stops some (or, without names, all) of the listeners `listenEvents` added. */
+export type Unlisten = (names?: Iterable<string>) => void;
+/**
+ * Listens to every event in `events` on `element`; each one calls the handler option the rule
+ * names, read through `handlers()` at event time, with the rule's arguments. `onEvent` runs first
+ * (a product records what the element emitted, so it is not echoed back as a prop).
+ */
+export declare function listenEvents(element: EventTarget, events: Readonly<Record<string, EventRule>>, handlers: () => object, onEvent?: (name: string, event: CustomEvent) => void): Unlisten;
+export interface BoundElement<P> {
+    /** Forwards the props whose policy says so (every policy but `manual`). */
+    update(next: {
+        readonly [K in keyof P]?: P[K] | undefined;
+    }): void;
+    /** The value last written for `key`. */
+    sent(key: keyof P & string): unknown;
+    unlisten: Unlisten;
+}
+export interface BindElementOptions {
+    onEvent?: (name: string, event: CustomEvent) => void;
+}
+/**
+ * Wires `element` to a product contract. `handlers()` returns the current handler options (the
+ * latest props), read at event time. Product-specific steps (a document model that must follow
+ * collaboration, `src` supersession) stay in the product's mount function around `update`.
+ */
+export declare function bindElement<E extends EventTarget, P extends object>(element: E, contract: Pick<BindingContract<E, P>, 'props' | 'events'>, handlers: () => object, options?: BindElementOptions): BoundElement<P>;
+/** Swaps the classes a binding added (`previous`) for `next`, leaving the element's own classes. */
+export declare function syncClassName(element: Element, previous: string | undefined, next: string | undefined): void;