ooxml-ui 0.30.1 → 1.0.0

package/dist/pptx/render/text-warp.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Text warp / WordArt logic: Vue port of the React
+ * `viewer/utils/warp-path-generators.ts` + `text-warp-classifier.ts`.
+ *
+ * Pure, framework-agnostic helpers that classify an OOXML `prstTxWarp` preset
+ * and build the SVG path `d` attribute for a single warped text baseline.
+ *
+ * A text element signals WordArt via `element.textStyle.textWarpPreset`
+ * (`a:bodyPr/a:prstTxWarp/@prst`), with optional `textWarpAdj` / `textWarpAdj2`
+ * adjustment values (raw OOXML 1/60000th units). Use {@link hasTextWarp} to
+ * detect a warped element and {@link shouldUseSvgWarp} to decide whether the
+ * SVG `<textPath>` renderer applies.
+ */
+import type { PptxElement, PptxTextWarpPreset, TextSegment } from 'ooxml-core/pptx';
+/**
+ * Rendering-strategy category for a warp preset.
+ *  - `path`:     renders along an SVG `<textPath>` (arcs, waves, circles,
+ *                slant/fade/cascade, …)
+ *  - `envelope`: non-uniform vertical stretch (inflate/deflate/can). Also
+ *                renders along an SVG `<textPath>`; kept as its own category
+ *                for documentation/grouping only (see {@link ENVELOPE_PRESETS}).
+ *  - `simple`:   unused (kept for API stability; no preset classifies here
+ *                any more, see {@link SIMPLE_PRESETS}).
+ *  - `none`:     no warp (`textNoShape`, `textPlain`, unknown)
+ *
+ * Every classified preset (`path` and `envelope` alike) should be routed to
+ * SVG `<textPath>` rendering via {@link shouldUseSvgWarp}; a binding that
+ * instead branches on this category to decide path-vs-CSS-transform will
+ * wrongly fall back to a flat CSS-transform approximation for the `envelope`
+ * family. Use `shouldUseSvgWarp` for that decision, not `classifyTextWarp`.
+ */
+export type WarpCategory = 'path' | 'envelope' | 'simple' | 'none';
+/**
+ * Classify a warp preset into a rendering-strategy category.
+ *
+ * Returns `'none'` for empty/unknown presets so callers can skip rendering
+ * without an explicit allowlist check.
+ */
+export declare function classifyTextWarp(preset: string | undefined): WarpCategory;
+/** All classified warp presets (excludes `none`). */
+export declare const ALL_CLASSIFIED_PRESETS: ReadonlySet<string>;
+/** A single warp/WordArt paragraph: the runs that flow along one baseline. */
+export interface WarpParagraph {
+    /** Text segments belonging to this paragraph (no paragraph-break segments). */
+    segments: TextSegment[];
+}
+/** Minimal element shape the warp paragraph splitter needs. */
+export interface WarpTextSource {
+    text?: string;
+    textSegments?: TextSegment[];
+}
+/**
+ * Optional per-segment transform applied while grouping. Returns the segment to
+ * emit for the given input segment; callers use it to substitute field text
+ * (slide number / date / footer …). Returning the same segment is a no-op.
+ */
+export type WarpSegmentTransform = (segment: TextSegment) => TextSegment;
+/**
+ * Group an element's `textSegments` into paragraphs delimited by paragraph
+ * SEPARATOR segments (the break markers themselves are excluded): see
+ * {@link isParagraphSeparatorSegment} for what counts as one. A caller that
+ * checked only `isParagraphBreak` here used to miss the far more common
+ * slide-load case (a bare `text: '\n'` segment with no flag at all), so a
+ * freshly-opened multi-paragraph WordArt block never split into separate
+ * lines: the literal `"\n"` fell into the first paragraph's own run list and
+ * was measured and rendered as its own glyph, which also flipped the
+ * vertical ordering of a multi-line envelope (paragraph 2's text ended up
+ * sharing paragraph 1's line instead of occupying its own band).
+ *
+ * Falls back to a single synthetic paragraph carrying `element.text` when no
+ * segments are present, and to an empty array when there is neither text nor
+ * segments.
+ *
+ * When `transform` is supplied each non-break segment is passed through it
+ * before being collected; this is how the React renderer substitutes field
+ * values (slide number, date, footer, …) into warped text. The transform is a
+ * separate concern kept out of this pure splitter so Vue/Angular can call it
+ * without pulling in field-substitution logic.
+ *
+ * @param source    Element (or element-like) carrying `text` / `textSegments`.
+ * @param transform Optional per-segment substitution callback.
+ */
+export declare function groupIntoParagraphs(source: WarpTextSource, transform?: WarpSegmentTransform): WarpParagraph[];
+/** Produces an SVG path `d` attribute for a single text line at vertical
+ *  position `t` (0 = top, 1 = bottom). Optional adj/adj2 are raw OOXML units. */
+export type WarpPathGenerator = (w: number, h: number, t: number, adj?: number, adj2?: number) => string;
+/** Presets that require SVG textPath rendering (all others fall back to flat). */
+export declare const SVG_WARP_PRESETS: ReadonlySet<string>;
+/** Cascading up: lines tilt from lower-left to upper-right. */
+export declare function cascadeUpPath(w: number, h: number, t: number, adj?: number): string;
+/** Cascading down: lines tilt from upper-left to lower-right. */
+export declare function cascadeDownPath(w: number, h: number, t: number, adj?: number): string;
+export declare const WARP_PATH_GENERATORS: Readonly<Record<string, WarpPathGenerator>>;
+/** Returns `true` when the preset should use SVG `<textPath>` rendering. */
+export declare function shouldUseSvgWarp(preset: PptxTextWarpPreset | undefined): boolean;
+/**
+ * Predicate: does this element carry a WordArt/text-warp preset that the SVG
+ * `<textPath>` renderer should handle? The warp field lives on
+ * `element.textStyle.textWarpPreset`.
+ */
+export declare function hasTextWarp(element: PptxElement): boolean;
+/**
+ * Build the SVG path `d` attribute for a warp preset at a given line position.
+ *
+ * @param preset    OOXML `prstTxWarp` preset name.
+ * @param width     Box width in px.
+ * @param height    Box height in px.
+ * @param lineIndex Zero-based index of the line/paragraph.
+ * @param lineCount Total number of lines/paragraphs.
+ * @param adj       Optional primary adjustment (raw OOXML 1/60000th units).
+ * @param adj2      Optional secondary adjustment (raw OOXML 1/60000th units).
+ */
+export declare function buildWarpPath(preset: PptxTextWarpPreset, width: number, height: number, lineIndex: number, lineCount: number, adj?: number, adj2?: number): string;
+/**
+ * Alias for {@link buildWarpPath}, kept under the original React/Angular symbol
+ * name (`getWarpPath`) so binding renderers can import it directly from shared
+ * without renaming their call sites.
+ */
+export declare const getWarpPath: typeof buildWarpPath;
+/**
+ * Framework-agnostic CSS-transform approximation for a warp preset.
+ *
+ * `path` presets render along an SVG `<textPath>`; `envelope`/`simple`
+ * presets cannot bend individual glyphs, so the visual effect is hinted with
+ * a `transform` (perspective / rotateX / rotateY / skew / scale) plus the
+ * `transform-origin` that anchors it. Port of the React `getEnvelopeCssTransform`
+ * + `getSimpleCssTransform` generators (`viewer/utils/text-warp-classifier.ts`)
+ * and the simpler `getTextWarpStyle` map (`viewer/utils/text-warp-css.tsx`).
+ */
+export interface WarpCssTransform {
+    /** The CSS `transform` value. */
+    transform: string;
+    /** The CSS `transform-origin` value. */
+    transformOrigin: string;
+}
+/**
+ * CSS-transform approximation for an `envelope` preset (inflate/deflate/can).
+ *
+ * Envelope warps distort text non-uniformly (e.g. inflate widens the middle
+ * lines, narrows the top/bottom). CSS cannot bend glyphs, so `scaleX`/`scaleY`,
+ * `perspective`, and `rotateX` give a reasonable hint scaled by the `adj1`
+ * intensity. Returns `undefined` for a non-envelope preset.
+ *
+ * @param preset One of the envelope warp preset names.
+ * @param adj1   Optional first adjustment value (raw OOXML units).
+ * @param adj2   Optional second adjustment value (raw OOXML units; reserved).
+ */
+export declare function getEnvelopeCssTransform(preset: string, adj1?: number, adj2?: number): WarpCssTransform | undefined;
+/**
+ * CSS-transform approximation for a `simple` preset (slant/fade/cascade).
+ *
+ * These warps are well-modelled by basic 2D transforms (`skewY`, `perspective`,
+ * `rotateX`/`rotateY`) scaled by the `adj1` value. Returns `undefined` for a
+ * non-simple preset.
+ *
+ * @param preset One of the simple warp preset names.
+ * @param adj1   Optional adjustment value (raw OOXML units).
+ */
+export declare function getSimpleCssTransform(preset: string, adj1?: number): WarpCssTransform | undefined;
+/**
+ * Dispatch a preset to its CSS-transform approximation based on its
+ * {@link classifyTextWarp} category.
+ *
+ * Returns the `envelope`/`simple` transform, or `undefined` for `path`/`none`
+ * presets (which render via `<textPath>` or flat text respectively). This is
+ * the CSS-transform counterpart to {@link buildWarpPath}.
+ *
+ * @param preset OOXML `prstTxWarp` preset name.
+ * @param adj    Optional primary adjustment (raw OOXML 1/60000th units).
+ * @param adj2   Optional secondary adjustment (raw OOXML 1/60000th units).
+ */
+export declare function getWarpCssTransform(preset: PptxTextWarpPreset | string | undefined, adj?: number, adj2?: number): WarpCssTransform | undefined;
+//# sourceMappingURL=text-warp.d.ts.map

package/dist/pptx/render/text-warp.d.ts.map

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

package/dist/pptx/render/text-wrap-estimate.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Word wrapping for contexts where the real glyph advances cannot be measured.
+ *
+ * Some render targets have no text-measurement API available at the point the
+ * layout is decided: a PDF content stream being assembled, or SVG labels that
+ * must be laid out before the document is in a document. Both need to break a
+ * string into lines that will roughly fit a width, and both are better served
+ * by one approximation than by two that drift apart.
+ *
+ * This is deliberately not a substitute for measured text. Anything that can
+ * measure (the paragraph renderers, which resolve real advances) must.
+ *
+ * @module text-wrap-estimate
+ */
+/**
+ * Estimate the rendered width of a single line of `text` at `fontSize`,
+ * without a real text-measurement API (see the module doc comment for when
+ * that applies). Used to size layout reservations ahead of render, such as
+ * how much horizontal space a chart must leave for its widest label.
+ *
+ * @param text - The line to measure. Only its own glyphs are considered; this
+ *   does not wrap or split the string.
+ * @param fontSize - Font size used to estimate glyph advances.
+ * @returns The estimated width in the same units as `fontSize`.
+ */
+export declare function estimateTextWidth(text: string, fontSize: number): number;
+/** Options for {@link wrapTextByEstimatedWidth}. */
+export interface EstimatedWrapOptions {
+    /**
+     * Keep an empty line for each blank authored paragraph. Paginated text wants
+     * the vertical gap preserved; a label centred in a shape does not.
+     */
+    keepBlankLines?: boolean;
+}
+/**
+ * Break `text` into lines that approximately fit `maxWidth`.
+ *
+ * Authored line breaks are always honoured. Words are never split or dropped:
+ * a single word longer than the line gets a line of its own and overflows,
+ * which is what PowerPoint does too.
+ *
+ * @param text - The text to wrap.
+ * @param maxWidth - Available width, in the same units as `fontSize`.
+ * @param fontSize - Font size used to estimate glyph advances.
+ * @param options - See {@link EstimatedWrapOptions}.
+ * @returns The wrapped lines, empty when there is nothing to render.
+ */
+export declare function wrapTextByEstimatedWidth(text: string, maxWidth: number, fontSize: number, options?: EstimatedWrapOptions): string[];
+//# sourceMappingURL=text-wrap-estimate.d.ts.map

package/dist/pptx/render/text-wrap-estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-wrap-estimate.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/text-wrap-estimate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgCH;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE;AA6BD,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,oBAAyB,GAChC,MAAM,EAAE,CAkDV"}

package/dist/pptx/render/theme-color-field-commit.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The exact model field pair each colour-picker surface writes on a commit
+ * ({@link ThemeColorPickerCommit}), named once so five bindings cannot each
+ * spell `backgroundColorRef` / `colorRef` differently (or forget the ref
+ * field entirely, which is how a swatch pick silently degraded to a plain
+ * hex in the ribbon Shape Fill/Outline pickers before this module existed).
+ *
+ * Every helper here is a trivial field rename: the interesting decision
+ * logic (which swatch is selected, what a click vs. a custom hex commits)
+ * already lives in {@link ./theme-color-picker-state}. This module
+ * only exists so that decision's OUTPUT lands on the right property names
+ * for each surface (gradient stop, table cell fill, table cell text).
+ *
+ * @module render/theme-color-field-commit
+ */
+import type { PptxTableCellStyle } from 'ooxml-core/pptx';
+import type { GradientStop } from './gradient-picker.js';
+import type { ThemeColorPickerCommit } from './theme-color-picker-state.js';
+/**
+ * The `color` / `colorRef` patch a gradient stop editor writes for one stop,
+ * in any binding. Pass to `updateGradientStopPatch(el, index, ...)` or merge
+ * directly into the stop object a binding's own gradient state holds.
+ */
+export declare function gradientStopColorCommitPatch(commit: ThemeColorPickerCommit): Pick<GradientStop, 'color' | 'colorRef'>;
+/**
+ * The `backgroundColor` / `backgroundColorRef` patch a table cell fill
+ * picker writes, mirroring `ShapeStyle.fillColorRef`'s "ref wins on save"
+ * contract.
+ */
+export declare function tableCellFillColorCommitPatch(commit: ThemeColorPickerCommit): Pick<PptxTableCellStyle, 'backgroundColor' | 'backgroundColorRef'>;
+/**
+ * The `color` / `colorRef` patch a table cell text colour picker writes,
+ * mirroring `TextStyle.colorRef`'s "ref wins on save" contract.
+ */
+export declare function tableCellTextColorCommitPatch(commit: ThemeColorPickerCommit): Pick<PptxTableCellStyle, 'color' | 'colorRef'>;
+//# sourceMappingURL=theme-color-field-commit.d.ts.map

package/dist/pptx/render/theme-color-field-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-color-field-commit.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/theme-color-field-commit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,sBAAsB,GAC5B,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,UAAU,CAAC,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC5C,MAAM,EAAE,sBAAsB,GAC5B,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,GAAG,oBAAoB,CAAC,CAEpE;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC5C,MAAM,EAAE,sBAAsB,GAC5B,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,UAAU,CAAC,CAEhD"}

package/dist/pptx/render/theme-color-picker-state.d.ts

@@ -0,0 +1,4 @@
+/** Compatibility entry: the implementation lives in ooxml-core/pptx/ui (`theme-color-picker-state.ts`). */
+export { customColorCommit, findSelectedThemeSwatch, themeColorRefsEqual, themeColorSwatchRows, themeSwatchCommit, } from 'ooxml-core/pptx/ui';
+export type { ThemeColorPickerCommit } from 'ooxml-core/pptx/ui';
+//# sourceMappingURL=theme-color-picker-state.d.ts.map

package/dist/pptx/render/theme-color-picker-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-color-picker-state.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/theme-color-picker-state.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,OAAO,EACN,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/pptx/render/theme-color-swatches.d.ts

@@ -0,0 +1,4 @@
+/** Compatibility entry: the implementation lives in ooxml-core/pptx/ui (`theme-color-swatches.ts`). */
+export { buildThemeColorSwatchGrid, describeThemeColorSwatch, themeColorVariantOfRef, themeColorVariantToRef, themeColorVariantsForLuminance, } from 'ooxml-core/pptx/ui';
+export type { ThemeColorSwatch, ThemeColorSwatchColumn, ThemeColorVariant, } from 'ooxml-core/pptx/ui';
+//# sourceMappingURL=theme-color-swatches.d.ts.map

package/dist/pptx/render/theme-color-swatches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-color-swatches.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/theme-color-swatches.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,OAAO,EACN,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,8BAA8B,GAC9B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACX,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/pptx/render/theme-editor-model.d.ts

@@ -0,0 +1,3 @@
+export { createCustomThemeEdit, THEME_EDITOR_LABEL_KEYS, THEME_EDITOR_COLOR_LABELS, themeEditorLabels, createThemeEditorEdit, themeEditorHex, } from 'ooxml-core/pptx/editor/render/theme-editor-model';
+export type { ThemeEditorEdit, ThemeEditorLabels, } from 'ooxml-core/pptx/editor/render/theme-editor-model';
+//# sourceMappingURL=theme-editor-model.d.ts.map

package/dist/pptx/render/theme-editor-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-editor-model.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/theme-editor-model.ts"],"names":[],"mappings":"AACA,OAAO,EACN,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,GACd,MAAM,kDAAkD,CAAC;AAC1D,YAAY,EACX,eAAe,EACf,iBAAiB,GACjB,MAAM,kDAAkD,CAAC"}

package/dist/pptx/render/theme-editor-presets.d.ts

@@ -0,0 +1,3 @@
+export { PRESET_THEMES, DEFAULT_THEME_COLOR_SCHEME, COMMON_FONTS, } from 'ooxml-core/pptx/editor/render/theme-editor-presets';
+export type { PresetTheme } from 'ooxml-core/pptx/editor/render/theme-editor-presets';
+//# sourceMappingURL=theme-editor-presets.d.ts.map

package/dist/pptx/render/theme-editor-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-editor-presets.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/theme-editor-presets.ts"],"names":[],"mappings":"AACA,OAAO,EACN,aAAa,EACb,0BAA0B,EAC1B,YAAY,GACZ,MAAM,oDAAoD,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAC"}

package/dist/pptx/render/title-bar-state.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Shared model for the title bar and quick-access strip (`pptx-ui-title-bar`).
+ *
+ * Five bindings hand-built this row and drifted on gating, ordering, tooltips
+ * and icons (#394). The element owns the markup and the rules below; hosts own
+ * every effect (saving, history, command dispatch, Find & Replace).
+ *
+ * Decisions, applied identically everywhere:
+ * - Order: Save, Undo, Redo (catalog order, each individually gated), then the
+ *   other configured commands in the order File > Options lists them.
+ * - Gating: AutoSave, strip, status and search show only while `editing`;
+ *   the strip also needs `quickAccess.visible`. `showSave` hides Save, and
+ *   `showUndo`/`showRedo` hide those two (host `hiddenActions`).
+ * - Tooltip: every strip button has `aria-label` = its label and `title` =
+ *   `screenTip(tooltip)`; Undo/Redo name the pending action when known.
+ * - Placement: `titleBar` renders the whole row (the extras only while the
+ *   position is `above`); `belowRibbon` renders just the extras row.
+ */
+import type { CommandSearchEntry } from './command-search.js';
+import type { QuickAccessPosition } from './options/viewer-options.js';
+import type { TitleBarAutosaveState } from './title-bar.js';
+import type { ToolbarActionId } from './toolbar-actions.js';
+export type TitleBarTranslate = (key: string, params?: Record<string, string | number>) => string;
+export type TitleBarPlacement = 'titleBar' | 'belowRibbon';
+export type TitleBarTone = 'idle' | 'saving' | 'error';
+/** Identifier of a strip button. Catalog ids; Save, Undo and Redo are dedicated. */
+export type TitleBarCommandId = string;
+export interface TitleBarAutosaveView {
+    enabled: boolean;
+    /** Default true. False renders the switch inert (host policy `autosave: false`). */
+    toggleAvailable?: boolean;
+    /** Translation key from `resolveTitleBarStatusKey`. */
+    statusKey: string;
+    /** Colour of the status text; only meaningful while `enabled`. */
+    tone?: TitleBarTone;
+}
+export interface TitleBarHistoryState {
+    canUndo: boolean;
+    canRedo: boolean;
+    /** Description of the pending action, e.g. "Delete shape". */
+    undoLabel?: string | null;
+    redoLabel?: string | null;
+    /** Default true. Maps to `hiddenActions: ['undo']`. */
+    showUndo?: boolean;
+    /** Default true. Maps to `hiddenActions: ['redo']`. */
+    showRedo?: boolean;
+}
+export interface TitleBarQuickAccessView {
+    visible: boolean;
+    position: QuickAccessPosition;
+    showCommandLabels: boolean;
+    /** Ordered catalog ids (File > Options > Quick Access Toolbar). */
+    commandIds: readonly string[];
+}
+export interface TitleBarViewState {
+    /** Edit mode with an editable deck. Gates AutoSave, the strip, status and search. */
+    editing: boolean;
+    /** Whether the command search shows; hosts pass `editing`. */
+    searchVisible: boolean;
+    /** Display name; the translated default shows when empty. */
+    fileName?: string;
+    autosave: TitleBarAutosaveView;
+    history: TitleBarHistoryState;
+    /** Default true. */
+    showSave?: boolean;
+    quickAccess: TitleBarQuickAccessView;
+    /** Search catalogue; defaults to the shared `COMMAND_SEARCH_ENTRIES`. */
+    commands?: readonly CommandSearchEntry[];
+    /** Default true. False drops the "Find in Slides" fallback row. */
+    contentSearch?: boolean;
+    /** ScreenTip rule (Options > General); returning undefined suppresses the title. */
+    screenTip?: (label: string) => string | undefined;
+    translate?: TitleBarTranslate;
+}
+/** Detail of `command-search`: a chosen catalogue command, or content search. */
+export interface TitleBarSearchDetail {
+    query: string;
+    /** Present when a catalogue command was chosen; absent means "search content". */
+    command?: string;
+}
+export interface TitleBarEventDetails {
+    'toggle-autosave': null;
+    save: null;
+    undo: null;
+    redo: null;
+    'quick-command': {
+        id: TitleBarCommandId;
+    };
+    'command-search': TitleBarSearchDetail;
+}
+export declare const TITLE_BAR_DEDICATED_IDS: readonly ['save', 'undo', 'redo'];
+/** One resolved strip button, in display order. */
+export interface TitleBarStripItem {
+    id: TitleBarCommandId;
+    icon: string;
+    labelKey: string;
+    dedicated: boolean;
+}
+/**
+ * The strip's buttons for one placement. Unknown ids are dropped and duplicates
+ * collapse, so a stale options file cannot render an unlabeled button.
+ */
+export declare function resolveTitleBarStrip(state: TitleBarViewState, placement: TitleBarPlacement): TitleBarStripItem[];
+/** Tone for the status text from the autosave engine state (idle unless enabled). */
+export declare function titleBarTone(enabled: boolean, state: string | undefined): TitleBarTone;
+/** What every binding already knows; buildTitleBarState turns it into the element state. */
+export interface TitleBarHostInput {
+    /** Edit mode with an editable deck (hosts compute this once). */
+    editing: boolean;
+    fileName?: string;
+    isDirty: boolean;
+    autosaveState?: TitleBarAutosaveState;
+    /** Reason code while autosaveState is 'disabled'. */
+    autosaveReason?: string;
+    autosaveEnabled: boolean;
+    /** Default true; false when the host passed autosave: false. */
+    autosaveToggleAvailable?: boolean;
+    canUndo: boolean;
+    canRedo: boolean;
+    undoLabel?: string | null;
+    redoLabel?: string | null;
+    hiddenActions?: readonly ToolbarActionId[];
+    /** Default true; React hides Save when the host gives no save handler. */
+    showSave?: boolean;
+    quickAccess: TitleBarQuickAccessView;
+    commands?: readonly CommandSearchEntry[];
+    contentSearch?: boolean;
+    screenTip?: (label: string) => string | undefined;
+    translate: TitleBarTranslate;
+}
+/** The one place the title bar's gating table and status rule live. */
+export declare function buildTitleBarState(input: TitleBarHostInput): TitleBarViewState;
+//# sourceMappingURL=title-bar-state.d.ts.map

package/dist/pptx/render/title-bar-state.d.ts.map

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

package/dist/pptx/render/title-bar.d.ts

@@ -0,0 +1,67 @@
+/**
+ * PowerPoint-style title bar: shared pure logic + Tailwind class tokens.
+ *
+ * The title bar is the top chrome row above the ribbon (AutoSave toggle,
+ * quick-access Save/Undo/Redo, file name + save-location status, centred
+ * search box). Every binding (React/Vue/Angular) renders its own thin view
+ * from these tokens so the three stay pixel-identical.
+ */
+/** Lifecycle state of the autosave engine, normalised across bindings. */
+export type TitleBarAutosaveState = 'idle' | 'saving' | 'saved' | 'error' | 'disabled';
+export interface ResolveTitleBarStatusInput {
+    /** Current autosave lifecycle state. */
+    autosaveState: TitleBarAutosaveState;
+    /** Whether the document has unsaved changes. */
+    isDirty: boolean;
+    /** Whether the AutoSave toggle is on. */
+    autosaveEnabled: boolean;
+    /** When autosaveState is 'disabled', the reason code. */
+    disabledReason?: string;
+}
+/**
+ * Resolve the i18n key for the save-status text shown next to the file name
+ * (PowerPoint shows "Saved to this PC" there).
+ */
+export declare function resolveTitleBarStatusKey(input: ResolveTitleBarStatusInput): string;
+/** Default document name shown when the host supplies no file name. */
+export declare const TITLE_BAR_DEFAULT_FILE_KEY = "pptx.titleBar.defaultFileName";
+export declare const TITLE_BAR_CLASSES: {
+    /** Outer row container. Hidden on mobile (the compact toolbar covers it). */
+    readonly container: 'flex items-center gap-1 h-9 px-2 border-b border-border/60 bg-secondary/80 text-[11px] select-none max-md:hidden';
+    /** Small square app mark on the far left. */
+    readonly logo: 'flex items-center justify-center w-5 h-5 rounded-sm bg-[#c43e1c] text-white text-[10px] font-bold shrink-0';
+    /** Wrapper for the AutoSave label + switch. */
+    readonly autosaveGroup: 'flex items-center gap-1.5 pl-1.5 pr-0.5 shrink-0';
+    readonly autosaveLabel: 'text-[11px] text-muted-foreground whitespace-nowrap';
+    /** Switch track, base classes; combine with on/off variant. */
+    readonly toggleTrack: 'relative inline-flex items-center w-7 h-3.5 rounded-full transition-colors cursor-pointer disabled:opacity-40 disabled:cursor-not-allowed';
+    readonly toggleTrackOn: 'bg-primary';
+    readonly toggleTrackOff: 'bg-muted-foreground/40';
+    /** Switch knob, base classes; combine with on/off variant. */
+    readonly toggleKnob: 'absolute w-2.5 h-2.5 rounded-full bg-white shadow-sm transition-transform';
+    readonly toggleKnobOn: 'translate-x-[15px]';
+    readonly toggleKnobOff: 'translate-x-0.5';
+    /** Quick-access icon button (Save / Undo / Redo). */
+    readonly quickButton: 'p-1 rounded-sm transition-colors hover:bg-accent/60 text-muted-foreground disabled:opacity-40 disabled:cursor-not-allowed active:scale-90 active:opacity-70';
+    readonly separator: 'w-px h-4 bg-border/60 mx-1 shrink-0';
+    /** File name + status wrapper (centred block in PowerPoint sits left of search). */
+    readonly fileGroup: 'flex items-baseline gap-1.5 px-1 min-w-0 shrink';
+    readonly fileName: 'text-[12px] font-medium text-foreground whitespace-nowrap overflow-hidden text-ellipsis max-w-[240px]';
+    readonly statusDot: 'text-muted-foreground/70';
+    readonly statusText: 'text-[11px] text-muted-foreground whitespace-nowrap';
+    readonly statusError: 'text-red-400';
+    readonly statusSaving: 'text-yellow-500';
+    /** Centred search area. */
+    readonly searchWrap: 'flex-1 flex justify-center min-w-0 px-2';
+    readonly searchBox: 'flex items-center gap-2 w-full max-w-md px-3 py-[3px] rounded-md bg-background/70 border border-border/60 text-muted-foreground hover:bg-background hover:text-foreground focus-within:border-ring transition-colors';
+    readonly searchIcon: 'w-3 h-3 shrink-0';
+    readonly searchLabel: 'text-[11px] truncate';
+    /** Right-hand spacer mirroring the left block so search stays centred. */
+    readonly rightSpacer: 'flex items-center justify-end gap-1 shrink-0';
+};
+/** Ribbon tab-row right-side actions (Record + Share live on the tab row). */
+export declare const TAB_ROW_ACTION_CLASSES: {
+    readonly record: 'inline-flex items-center gap-1.5 px-2.5 py-1 mr-1 rounded-sm text-[11px] font-medium text-foreground hover:bg-accent/60 transition-colors whitespace-nowrap';
+    readonly recordDot: 'w-2 h-2 rounded-full bg-red-600 shrink-0';
+};
+//# sourceMappingURL=title-bar.d.ts.map

package/dist/pptx/render/title-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-bar.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/title-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,0EAA0E;AAC1E,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvF,MAAM,WAAW,0BAA0B;IAC1C,wCAAwC;IACxC,aAAa,EAAE,qBAAqB,CAAC;IACrC,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,eAAe,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAqBlF;AAED,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,kCAAkC,CAAC;AAM1E,eAAO,MAAM,iBAAiB;IAC7B,6EAA6E;aAC7E,SAAS,EACR,kHAAkH;IACnH,6CAA6C;aAC7C,IAAI,EAAE,4GAA4G;IAClH,+CAA+C;aAC/C,aAAa,EAAE,kDAAkD;aACjE,aAAa,EAAE,qDAAqD;IACpE,+DAA+D;aAC/D,WAAW,EACV,2IAA2I;aAC5I,aAAa,EAAE,YAAY;aAC3B,cAAc,EAAE,wBAAwB;IACxC,8DAA8D;aAC9D,UAAU,EAAE,2EAA2E;aACvF,YAAY,EAAE,oBAAoB;aAClC,aAAa,EAAE,iBAAiB;IAChC,qDAAqD;aACrD,WAAW,EACV,6JAA6J;aAC9J,SAAS,EAAE,qCAAqC;IAChD,oFAAoF;aACpF,SAAS,EAAE,iDAAiD;aAC5D,QAAQ,EACP,uGAAuG;aACxG,SAAS,EAAE,0BAA0B;aACrC,UAAU,EAAE,qDAAqD;aACjE,WAAW,EAAE,cAAc;aAC3B,YAAY,EAAE,iBAAiB;IAC/B,2BAA2B;aAC3B,UAAU,EAAE,yCAAyC;aACrD,SAAS,EACR,sNAAsN;aACvN,UAAU,EAAE,kBAAkB;aAC9B,WAAW,EAAE,sBAAsB;IACnC,0EAA0E;aAC1E,WAAW,EAAE,8CAA8C;CAClD,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB;aAClC,MAAM,EACL,6JAA6J;aAC9J,SAAS,EAAE,0CAA0C;CAC5C,CAAC"}

package/dist/pptx/render/toolbar-actions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Toolbar action / ribbon-tab visibility: a single, framework-agnostic
+ * catalogue of every top-level toolbar button and ribbon tab a host app can
+ * independently hide. Each binding exposes a `hiddenActions?: ToolbarActionId[]`
+ * prop, threads it down to the relevant render sites, and gates them with
+ * `isActionHidden`. Default (`undefined` / `[]`) hides nothing, matching
+ * today's always-visible behaviour.
+ *
+ * `TOOLBAR_TABS` is also the canonical ribbon-tab list/order, replacing the
+ * copy hand-duplicated in each binding (React's `TOOLBAR_SECTIONS`, Vue's
+ * `ribbon-constants.ts`, Angular's `RIBBON_TABS`, etc.) so the tab set can't
+ * drift between bindings. Per-tab icons stay in each binding (icon libraries
+ * differ per framework); only id + i18n key + order are shared here.
+ */
+/**
+ * A single toolbar button/control that can be hidden independently of the
+ * ribbon tab it may also appear inside. `zoom` and `navigation` each cover a
+ * whole control cluster (zoom in/out/fit, prev/next) rather than each button
+ * in it, matching how hosts actually want to hide/keep them as a unit.
+ */
+export type ToolbarButtonId = 'share' | 'broadcast' | 'export' | 'undo' | 'redo' | 'record' | 'notes' | 'fullscreen' | 'zoom' | 'navigation' | 'mergeShapes' | 'crop';
+/** A top-level ribbon tab. `record` intentionally shares its id with the quick-access Record button above: both surface the same recording feature, so hiding one hides the other. */
+export type ToolbarTabId = 'file' | 'home' | 'insert' | 'draw' | 'design' | 'transitions' | 'animations' | 'slideShow' | 'record' | 'review' | 'view' | 'help';
+export type ToolbarActionId = ToolbarButtonId | ToolbarTabId;
+/**
+ * PowerPoint's contextual tabs: they join the tab row only while the
+ * selection is of their kind (see `contextualTabsForElement` in
+ * `ribbon-galleries/`). Kept apart from `ToolbarTabId` because they are not
+ * part of the fixed tab order every binding renders.
+ */
+export type RibbonContextualTabId = 'shapeFormat' | 'pictureFormat' | 'tableDesign' | 'chartDesign' | 'smartArtDesign';
+export interface RibbonContextualTabDefinition {
+    id: RibbonContextualTabId;
+    labelKey: string;
+}
+/** The contextual tabs, in the order PowerPoint appends them. */
+export declare const RIBBON_CONTEXTUAL_TABS: readonly RibbonContextualTabDefinition[];
+export interface ToolbarTabDefinition {
+    id: ToolbarTabId;
+    labelKey: string;
+}
+export declare const TOOLBAR_TABS: ToolbarTabDefinition[];
+/** True when `id` is present in the host's `hiddenActions` list. */
+export declare function isActionHidden(id: ToolbarActionId, hiddenActions: readonly ToolbarActionId[] | undefined): boolean;
+/** Filters a ribbon-tab list down to the ones the host hasn't hidden. */
+export declare function filterVisibleTabs<T extends {
+    id: ToolbarTabId;
+}>(tabs: readonly T[], hiddenActions: readonly ToolbarActionId[] | undefined): T[];
+//# sourceMappingURL=toolbar-actions.d.ts.map

package/dist/pptx/render/toolbar-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar-actions.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/toolbar-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACxB,OAAO,GACP,WAAW,GACX,QAAQ,GACR,MAAM,GACN,MAAM,GACN,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,aAAa,GACb,MAAM,CAAC;AAEV,sLAAsL;AACtL,MAAM,MAAM,YAAY,GACrB,MAAM,GACN,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,CAAC;AAEV,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,YAAY,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAC9B,aAAa,GACb,eAAe,GACf,aAAa,GACb,aAAa,GACb,gBAAgB,CAAC;AAEpB,MAAM,WAAW,6BAA6B;IAC7C,EAAE,EAAE,qBAAqB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,EAAE,SAAS,6BAA6B,EAM1E,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,YAAY,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,YAAY,EAAE,oBAAoB,EAa9C,CAAC;AAEF,oEAAoE;AACpE,wBAAgB,cAAc,CAC7B,EAAE,EAAE,eAAe,EACnB,aAAa,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GACnD,OAAO,CAET;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,YAAY,CAAA;CAAE,EAC/D,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,aAAa,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GACnD,CAAC,EAAE,CAKL"}