ooxml-ui 0.24.0 → 0.26.0

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

@@ -6,6 +6,7 @@ export type OfficeRibbonSelectEvent = CustomEvent<{
 interface RibbonTab {
     id: string;
     label: string;
+    contextual: boolean;
     keytip?: string;
     keytipPanel?: string;
 }
@@ -15,8 +16,16 @@ interface RibbonTab {
  * optionally `data-tab-keytip`; the element builds the tabs from them, keeps exactly one panel
  * visible and moves between tabs with the arrow keys, Home and End. Slots: `quick-access`,
  * `search`, `end`. Attributes: `selected`, `label` (tab list name), `file-label` (default "File"),
- * `no-file`, `file-expanded`, `file-keytip`. Events: `office-ribbon-select` `{ tab }`
+ * `no-file`, `file-expanded`, `file-keytip`. A panel with `data-tab-hidden` keeps its content but has
+ * no tab (a contextual tab, or one a customisation removed); if it was selected, the first
+ * remaining tab takes over. `data-contextual` on a panel tints its tab (`--office-ribbon-contextual`),
+ * for tools that apply to the selection, such as a table's. Events: `office-ribbon-select` `{ tab }`
  * (cancelable) and `office-ribbon-file` when File is activated.
+ *
+ * `collapsible` adds Office's collapse button: `collapsed` hides the panels, a click on a tab then
+ * shows its panel over the content (`peek`) until Escape, a command or a click elsewhere. Ctrl+F1 and
+ * a double click on a tab toggle it. `collapse-label` names the button. Event:
+ * `office-ribbon-collapse` `{ collapsed }`.
  */
 export declare class OfficeUiRibbon extends OfficeElement {
     static styles: import("lit").CSSResult[];
@@ -49,6 +58,34 @@ export declare class OfficeUiRibbon extends OfficeElement {
             attribute: string;
             type: StringConstructor;
         };
+        collapsible: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        collapsed: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        peek: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+        collapseLabel: {
+            attribute: string;
+            type: StringConstructor;
+        };
         tabs: {
             state: boolean;
         };
@@ -58,6 +95,10 @@ export declare class OfficeUiRibbon extends OfficeElement {
     noFile: boolean;
     fileExpanded: string | null;
     fileKeytip: string | null;
+    collapsible: boolean;
+    collapsed: boolean;
+    peek: boolean;
+    collapseLabel: string | null;
     tabs: RibbonTab[];
     private chosen;
     constructor();
@@ -67,13 +108,35 @@ export declare class OfficeUiRibbon extends OfficeElement {
     focusFile(): void;
     /** Focus the selected tab. */
     focusTab(): void;
+    /** The rendered tab button of `tab`, or null before the first render. */
+    tabButton(tab: string): HTMLButtonElement | null;
+    /** The rendered File button, or null before the first render. */
+    fileButton(): HTMLButtonElement | null;
+    /**
+     * Hide or show the tab of panel `tab` for one reason (`contextual`, `custom`, ...). The tab shows
+     * only while no reason hides it, so a table's tools and a customisation do not undo each other.
+     */
+    setTabHidden(tab: string, reason: string, hidden: boolean): void;
     private panels;
+    /** The panels that have a tab: those not marked `data-tab-hidden`. */
+    private shown;
     /** Read the tabs off the panels (on connection and whenever the slotted panels change). */
     private build;
+    private setCollapsed;
+    private onOutside;
+    private onTabDoubleClick;
+    /** A command run from an overlaid panel closes it; a menu opener keeps it open. */
+    private onPanelClick;
+    protected willUpdate(changed: Map<PropertyKey, unknown>): void;
     private choose;
     private onTabClick;
+    /** Ctrl+F1 and Escape work from anywhere in the ribbon, panels included. */
+    private onHostKey;
     private onKey;
+    /** Rebuild the tab row when a panel's label or visibility flag changes. */
+    private watcher;
     connectedCallback(): void;
+    disconnectedCallback(): void;
     /** Exactly one panel shows. */
     protected updated(): void;
     protected render(): import("lit").TemplateResult<1>;

package/dist/smartart.js

@@ -1,3 +1,3 @@
-export { OfficeUiSmartArt, defineSmartArt, renderDiagramDrawing } from './chunk-RVZAYXTI.js';
-import './chunk-PCZJV6HQ.js';
-import './chunk-HSJH6SUW.js';
+export { OfficeUiSmartArt, defineSmartArt, renderDiagramDrawing } from './chunk-4VQ6S7QJ.js';
+import './chunk-ZWBP2WTC.js';
+import './chunk-7Q7ZS2CC.js';

package/dist/teams.js

@@ -1,5 +1,5 @@
-export { EMOJI, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_TAGS, TeamsElement, colorFor, dayLabel, defineAppRail, defineAvatar, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, definePrejoin, formatElapsed, formatSize, formatTime, icon, registerTeams, withStyles } from './chunk-TCBUC6BI.js';
+export { EMOJI, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_TAGS, TeamsElement, colorFor, dayLabel, defineAppRail, defineAvatar, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, definePrejoin, formatElapsed, formatSize, formatTime, icon, registerTeams, withStyles } from './chunk-LE4FTRWB.js';
 import './chunk-HZ422LTR.js';
-import './chunk-XQWRKHC2.js';
-import './chunk-PCZJV6HQ.js';
-import './chunk-HSJH6SUW.js';
+import './chunk-V6W5DKJ6.js';
+import './chunk-ZWBP2WTC.js';
+import './chunk-7Q7ZS2CC.js';

package/dist/theme-bridge.d.ts

@@ -0,0 +1,25 @@
+import type { OfficeToken } from './tokens.js';
+/**
+ * Feeds the `--office-*` tokens from a product's own theme, so the shared elements follow it.
+ * Products (docx, xlsx, pptx, visio) already name their theme after shadcn/ui
+ * (`--<prefix>foreground`, `--<prefix>muted-foreground`, ...); `shadcnBridge('--dve-')` is the
+ * whole bridge for such a product. `themeBridge` takes any mapping for the rest.
+ *
+ * The CSS is declared on the selector you give (usually `:host` inside a shadow root, or the
+ * product's root element), not on `:root`: a product's colours often resolve where they are read,
+ * so a nested theme, a dark scheme or a host override keeps working. Pure strings, no DOM.
+ */
+export type ThemeBridgeMap = Partial<Record<OfficeToken, string>>;
+/** `selector { --office-x: value; ... }` for a mapping; entries without a value are skipped. */
+export declare function themeBridge(selector: string, map: ThemeBridgeMap): string;
+export interface ShadcnBridgeOptions {
+    /** Extra or overriding `--office-*` values, for example `{ '--office-font': '...' }`. */
+    extra?: ThemeBridgeMap;
+    /** A literal each theme variable falls back to when the product does not define it. */
+    fallbacks?: Partial<Record<string, string>>;
+}
+/**
+ * The bridge for a product whose theme variables are `<prefix><shadcn-name>`
+ * (`prefix` includes the dashes, for example `'--dve-'` or `'--pptx-'`).
+ */
+export declare function shadcnBridge(selector: string, prefix: string, options?: ShadcnBridgeOptions): string;

package/dist/theme.d.ts

@@ -1,3 +1,4 @@
+export { shadcnBridge, themeBridge, type ShadcnBridgeOptions, type ThemeBridgeMap, } from './theme-bridge.js';
 export { COMPACT, FOCUS_RING, OFFICE_TOKENS, tok, TOUCH, type OfficeToken } from './tokens.js';
 /**
  * Theme-token foundation. Custom properties cross shadow boundaries, so one `<style>` in the

package/dist/theme.js

@@ -1,2 +1,2 @@
-export { THEME_CSS, THEME_STYLE_ID, installOfficeUiTheme } from './chunk-2X6QYQ3Q.js';
-export { COMPACT, FOCUS_RING, OFFICE_TOKENS, TOUCH, tok } from './chunk-HSJH6SUW.js';
+export { THEME_CSS, THEME_STYLE_ID, installOfficeUiTheme, shadcnBridge, themeBridge } from './chunk-7QLJS57B.js';
+export { COMPACT, FOCUS_RING, OFFICE_TOKENS, TOUCH, tok } from './chunk-7Q7ZS2CC.js';

package/dist/tokens.d.ts

@@ -122,6 +122,7 @@ export declare const OFFICE_TOKENS: {
     readonly '--office-switch-thumb': 'var(--office-foreground, #1f2937)';
     readonly '--office-switch-thumb-on': 'var(--office-accent-foreground, #ffffff)';
     readonly '--office-ribbon-tab-height': '35px';
+    readonly '--office-ribbon-contextual': 'var(--office-accent, #2563eb)';
     readonly '--office-ribbon-group-gap': '2px';
     readonly '--office-ribbon-group-height': '78px';
     readonly '--office-ribbon-group-padding': '4px 8px 2px';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ooxml-ui",
-	"version": "0.24.0",
+	"version": "0.26.0",
 	"description": "Shared, format-neutral web components and styles for the Office viewers (Word, PowerPoint, Excel)",
 	"keywords": [
 		"custom-elements",
@@ -23,6 +23,7 @@
 	},
 	"files": [
 		"dist",
+		"custom-elements.json",
 		"LICENSE",
 		"NOTICE",
 		"README.md"
@@ -68,7 +69,8 @@
 			"import": "./dist/teams.js",
 			"default": "./dist/teams.js"
 		},
-		"./package.json": "./package.json"
+		"./package.json": "./package.json",
+		"./custom-elements.json": "./custom-elements.json"
 	},
 	"publishConfig": {
 		"access": "public"
@@ -78,11 +80,12 @@
 		"prepack": "node scripts/ensure-built.mjs",
 		"typecheck": "tsc -p tsconfig.json --noEmit",
 		"test": "vitest run",
-		"test:package": "node scripts/package-smoke.mjs"
+		"test:package": "node scripts/package-smoke.mjs",
+		"gen:manifest": "node scripts/gen-manifest.mjs"
 	},
 	"dependencies": {
 		"lit": "^3.3.3",
-		"ooxml-core": "^0.16.0"
+		"ooxml-core": "^0.17.0"
 	},
 	"devDependencies": {
 		"@types/jsdom": "^30.0.0",
@@ -93,5 +96,6 @@
 	},
 	"engines": {
 		"node": ">=22"
-	}
+	},
+	"customElements": "custom-elements.json"
 }