ooxml-ui 1.24.0 → 1.26.0

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

@@ -0,0 +1,212 @@
+/**
+ * What a chart Format pane reads: a neutral view of the selected element
+ * (colours as `#RRGGBB`, transparency and sizes in the pane's own units) and
+ * of its options, supplied by a {@link ChartFormatSource}. `chartSpaceFormatSource`
+ * reads a `ChartSpace` (`ooxml-core/chart`); a product whose chart model is
+ * not a `ChartSpace` yet supplies its own source. Effects, 3-D and text views
+ * are optional extension sections: a source that cannot read or write them
+ * leaves them out and the pane does not offer them. The shapes match
+ * PowerPoint's `ChartElementFormatView`, which they were taken from.
+ *
+ * @module chart/format-pane-view
+ */
+import type { ChartFormatTarget, ChartGradientFill } from 'ooxml-core/chart';
+import type { ChartFormatChoice, ChartFormatTargetOption, ChartFormatText } from './format-pane-types.js';
+/** The sections an element supports. */
+export interface ChartFormatSupport {
+    fill: boolean;
+    gradient: boolean;
+    pattern: boolean;
+    picture: boolean;
+    threeD: boolean;
+    text: boolean;
+    /** The Border (Line) section; absent means supported. */
+    line?: boolean;
+    /** Gradient lines, compound, join and arrow types; absent means supported. */
+    lineDetails?: boolean;
+    /** The Effects tab; absent means supported. */
+    effects?: boolean;
+}
+export type ChartFormatFillKind = 'none' | 'solid' | 'gradient' | 'pattern' | 'picture' | 'automatic';
+export interface ChartFormatFillView {
+    kind: ChartFormatFillKind;
+    /** `#RRGGBB`. */
+    color?: string;
+    /** 0 (opaque) through 100 (clear). */
+    transparency?: number;
+    gradient?: ChartGradientFill;
+    pattern?: {
+        preset: string;
+        foreground: string;
+        background: string;
+    };
+    picture?: {
+        src?: string;
+        relId?: string;
+        tile?: boolean;
+        transparency?: number;
+    };
+}
+export interface ChartFormatLineView {
+    kind: 'none' | 'solid' | 'gradient' | 'automatic';
+    color?: string;
+    gradient?: ChartGradientFill;
+    transparency?: number;
+    /** Points. */
+    width?: number;
+    dash?: string;
+    compound?: string;
+    cap?: string;
+    join?: string;
+    beginArrow?: string;
+    endArrow?: string;
+}
+export interface ChartFormatShadowView {
+    color: string;
+    transparency?: number;
+    blur: number;
+    distance: number;
+    angle: number;
+}
+export interface ChartFormatGlowView {
+    color: string;
+    transparency?: number;
+    radius: number;
+}
+export interface ChartFormatEffectsView {
+    shadow?: ChartFormatShadowView | null;
+    glow?: ChartFormatGlowView | null;
+    softEdge?: number | null;
+}
+export interface ChartFormatBevelView {
+    type: string;
+    width: number;
+    height: number;
+}
+export interface ChartFormatThreeDView {
+    bevelTop?: ChartFormatBevelView | null;
+    bevelBottom?: ChartFormatBevelView | null;
+    depth?: {
+        size: number;
+        color?: string;
+    } | null;
+    contour?: {
+        size: number;
+        color?: string;
+    } | null;
+    material?: string | null;
+    lighting?: string | null;
+}
+export interface ChartFormatTextView {
+    fill?: {
+        kind: 'none' | 'solid' | 'gradient' | 'automatic';
+        color?: string;
+        transparency?: number;
+        gradient?: ChartGradientFill;
+    };
+    outline?: {
+        kind: 'none' | 'solid' | 'automatic';
+        color?: string;
+        transparency?: number;
+        width?: number;
+        dash?: string;
+    };
+    effects?: {
+        shadow?: ChartFormatShadowView | null;
+        glow?: ChartFormatGlowView | null;
+    };
+    rotation?: number | null;
+    direction?: string | null;
+    anchor?: string | null;
+}
+/** The element's shape and text formatting. */
+export interface ChartFormatElementView {
+    support: ChartFormatSupport;
+    fill: ChartFormatFillView;
+    line: ChartFormatLineView;
+    effects?: ChartFormatEffectsView;
+    threeD?: ChartFormatThreeDView;
+    text?: ChartFormatTextView;
+}
+/**
+ * A chart type in PowerPoint's names, which decide the options a series and its labels offer:
+ * `bar`, `bar3D`, `pie`, `pie3D`, `doughnut`, `ofPie`, `line`, `scatter`, `bubble` are recognised,
+ * any other name gets the options every type has.
+ */
+export type ChartFormatChartType = string;
+export interface ChartFormatSeriesOptionsView {
+    /** Undefined for a combination chart. */
+    chartType?: ChartFormatChartType;
+    /** On the secondary axis; undefined when the source cannot move a series between axes. */
+    secondaryAxis?: boolean;
+    overlap?: number;
+    gapWidth?: number;
+    firstSliceAngle?: number;
+    holeSize?: number;
+    /** Draw sliders beside the spacing boxes. */
+    sliders?: boolean;
+}
+export interface ChartFormatAxisView {
+    kind: 'cat' | 'val' | 'date' | 'ser';
+    min?: number;
+    max?: number;
+    majorUnit?: number;
+    minorUnit?: number;
+    crosses?: string;
+    crossesAt?: number;
+    displayUnits?: string;
+    logScale?: boolean;
+    logBase?: number;
+    reverse: boolean;
+    majorTickMark?: string;
+    minorTickMark?: string;
+    tickLabelPosition?: string;
+    /** A format code not linked to the source; empty when the axis follows its data. */
+    numberFormat?: string;
+}
+export interface ChartFormatLegendView {
+    position?: string;
+    overlay?: boolean;
+    /** Whether the overlay switch is offered; absent means yes. */
+    overlaySupported?: boolean;
+}
+export interface ChartFormatLabelsView {
+    chartType?: ChartFormatChartType;
+    /** The options of one series' labels (each flag falling back to the chart's). */
+    seriesScoped: boolean;
+    showSeriesName?: boolean;
+    showCategory?: boolean;
+    showValue?: boolean;
+    showPercent?: boolean;
+    showLegendKey?: boolean;
+    position?: string;
+}
+/** How an axis reads in a caption ("Secondary Vertical (Value) Axis"). */
+export interface ChartFormatAxisInfo {
+    kind: 'cat' | 'val' | 'date' | 'ser';
+    vertical: boolean;
+    secondary: boolean;
+}
+/** Everything a Format pane reads from one chart. */
+export interface ChartFormatSource {
+    /** The element picker's entries, in order; the first is the fallback target. */
+    readonly targets: readonly ChartFormatTargetOption[];
+    /** A valid target the picker does not list, or undefined. */
+    resolve?(key: string): ChartFormatTargetOption | undefined;
+    element(target: ChartFormatTarget): ChartFormatElementView;
+    seriesOptions?(seriesIndex: number): ChartFormatSeriesOptionsView | undefined;
+    axisOptions?(axisIndex: number): ChartFormatAxisView | undefined;
+    legendOptions?(): ChartFormatLegendView | undefined;
+    labelOptions?(seriesIndex: number | undefined): ChartFormatLabelsView | undefined;
+    /** Pattern presets the pattern fill offers. */
+    readonly patternPresets?: readonly ChartFormatChoice[];
+    /** Sections the host draws itself, by section id, mapped to the pane's slot names. */
+    readonly slots?: Readonly<Partial<Record<'fill', string>>>;
+    /** Whether the Text Options toggle is offered (disabled where an element has no text); default yes. */
+    readonly textOptions?: boolean;
+    /** Show every section on one page, without tabs. */
+    readonly flat?: boolean;
+    /** Caption of the element picker (default "Chart Options"). */
+    readonly picker?: ChartFormatText;
+}
+//# sourceMappingURL=format-pane-view.d.ts.map

package/dist/chart/format-pane-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-pane-view.d.ts","sourceRoot":"","sources":["../../src/chart/format-pane-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE7E,OAAO,KAAK,EACX,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,MAAM,qBAAqB,CAAC;AAE7B,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,mBAAmB,GAC5B,MAAM,GACN,OAAO,GACP,UAAU,GACV,SAAS,GACT,SAAS,GACT,WAAW,CAAC;AAEf,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClF;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACtC,MAAM,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACtC,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1C,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;KAC7B,CAAC;IACF,OAAO,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;QACrC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAA;KAAE,CAAC;IACvF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,+CAA+C;AAC/C,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE1C,MAAM,WAAW,4BAA4B;IAC5C,yCAAyC;IACzC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,0FAA0F;IAC1F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACrC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,iFAAiF;IACjF,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IACjC,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACrD,6DAA6D;IAC7D,OAAO,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAAC;IAC3D,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,sBAAsB,CAAC;IAC3D,aAAa,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,4BAA4B,GAAG,SAAS,CAAC;IAC9E,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IACjE,aAAa,CAAC,IAAI,qBAAqB,GAAG,SAAS,CAAC;IACpD,YAAY,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,qBAAqB,GAAG,SAAS,CAAC;IAClF,+CAA+C;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvD,sFAAsF;IACtF,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3D,uGAAuG;IACvG,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CAClC"}

package/dist/chart/format-pane.d.ts

@@ -0,0 +1,128 @@
+import { type PropertyValues, type TemplateResult } from 'lit';
+import type { ChartEditIntent, ChartSpace } from 'ooxml-core/chart';
+import type { DrawingColorTheme } from 'ooxml-core/drawingml';
+import { OfficeElement } from '../base.js';
+import { type ChartFormatTranslate } from './format-pane-common.js';
+import { type ChartFormatControlTags } from './format-pane-fields.js';
+import type { ChartFormatFieldValue, ChartFormatPaneModel, ChartFormatText } from './format-pane-types.js';
+import type { ChartFormatSource } from './format-pane-view.js';
+/** What `office-chart-format-edit` carries: the field change and, where one exists, its intent. */
+export interface ChartFormatEditDetail {
+    /** The target key (`chartArea`, `series:0`, `axis:1`...). */
+    target: string;
+    /** The field id (`fill.color`, `series.gapWidth`...). */
+    field: string;
+    value: ChartFormatFieldValue;
+    /** The neutral chart edit, or `null` for a field no neutral operation covers. */
+    intent: ChartEditIntent | null;
+}
+export type ChartFormatEditEvent = CustomEvent<ChartFormatEditDetail>;
+export type ChartFormatTargetEvent = CustomEvent<{
+    target: string;
+}>;
+/**
+ * `<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.
+ */
+export declare class OfficeUiChartFormatPane extends OfficeElement {
+    static editEvent: string;
+    static targetEvent: string;
+    static closeEvent: string;
+    static controlTags: ChartFormatControlTags;
+    static styles: import("lit").CSSResult[];
+    static properties: {
+        disabled: {
+            type: BooleanConstructor;
+            reflect: true;
+            converter: {
+                fromAttribute: (value: string | null) => boolean;
+                toAttribute: (value: unknown) => string | null;
+            };
+        };
+    };
+    /** Properties a host may set before the element is defined; replayed through their setters. */
+    static replayed: readonly string[];
+    /** Every control is read-only and nothing is emitted. */
+    disabled: boolean;
+    private sourceValue;
+    private spaceValue;
+    private themeValue;
+    private targetValue;
+    private translator;
+    private localeValue;
+    /** The translator captions go through: the product's, then the pane's own dictionary. */
+    private captions;
+    private paneTab;
+    private paneMode;
+    private collapsed;
+    /** After an edit, write the model's values even into the focused box (a refused value). */
+    private forceSync;
+    /** The pane title, the host's accessible name. */
+    private hostLabel;
+    /** The value each box and select was last given, to tell typing from a stale value. */
+    private synced;
+    constructor();
+    connectedCallback(): void;
+    /** What the pane reads; replaces `chartSpace`. */
+    get source(): ChartFormatSource | undefined;
+    set source(value: ChartFormatSource | undefined);
+    /** A chart part model, read through `chartSpaceFormatSource` with `theme`. */
+    get chartSpace(): ChartSpace | undefined;
+    set chartSpace(value: ChartSpace | undefined);
+    /** Resolves scheme colours of a `chartSpace`. */
+    get theme(): DrawingColorTheme | undefined;
+    set theme(value: DrawingColorTheme | undefined);
+    /** The element the pane formats (`chartArea`, `series:0`, `axis:1`, ...). */
+    get target(): string;
+    set target(value: string);
+    /** Translates captions: `(key, params, fallback)`, returning the key when it has none. */
+    get translateLabel(): ChartFormatTranslate;
+    set translateLabel(value: ChartFormatTranslate | undefined);
+    /**
+     * The display locale of the pane's own captions (`en`, `fr`, `de`, `es`, `zh-CN`; any BCP 47
+     * tag maps onto them). `translateLabel` still wins where it knows a key.
+     */
+    get locale(): string;
+    set locale(value: string | undefined);
+    private themeOptions;
+    private statics;
+    protected tr: (text: ChartFormatText) => string;
+    private label;
+    /** The pane for the current source, target, tab and mode, or undefined without a source. */
+    protected model(): ChartFormatPaneModel | undefined;
+    /** A committed field: its edit (with the neutral intent) goes to {@link commit}. */
+    private edit;
+    /**
+     * Fires the edit event. A product subclass that applies edits itself overrides this (PowerPoint
+     * maps the edit onto its own chart model); either way the pane repaints afterwards.
+     */
+    protected commit(edit: ChartFormatEditDetail): void;
+    /** Repaints every value from the model, even the box being typed in (a refused value). */
+    protected refreshValues(): void;
+    protected pickTarget(target: string): void;
+    protected requestClose(): void;
+    private toggleText;
+    private onKey;
+    private preview;
+    private section;
+    render(): TemplateResult;
+    protected updated(changed: PropertyValues): void;
+}
+export declare const defineChartFormatPane: import("../registry.js").Definer;
+declare global {
+    interface HTMLElementTagNameMap {
+        'office-ui-chart-format-pane': OfficeUiChartFormatPane;
+    }
+}
+//# sourceMappingURL=format-pane.d.ts.map

package/dist/chart/format-pane.d.ts.map

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

package/dist/chart/gallery-tiles.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Tile previews for the Chart Design galleries every product shares (Chart Styles, Change Colors,
+ * Quick Layout): a small clustered-column chart in the given colours, a palette's swatch strip and
+ * a schematic of a Quick Layout's element set. Each tile is one self-contained `<svg>` string.
+ *
+ * Moved from `src/ui/src/pptx/render/ribbon-galleries/chart-gallery-tiles.ts`.
+ *
+ * @module chart/gallery-tiles
+ */
+import type { ChartLayoutSketch } from 'ooxml-core/chart';
+export { swatchStripSvg } from '../ribbon/color-preview.js';
+export type { ChartLayoutSketch } from 'ooxml-core/chart';
+/** A clustered column chart: three categories of `colors.length` (max 4) bars. */
+export declare function columnChartTileSvg(colors: readonly string[], size: {
+    width: number;
+    height: number;
+}): string;
+/** A schematic of a Quick Layout: title bar, legend box, axis titles, gridlines, labels, table. */
+export declare function chartLayoutTileSvg(sketch: ChartLayoutSketch, size: {
+    width: number;
+    height: number;
+}): string;
+//# sourceMappingURL=gallery-tiles.d.ts.map

package/dist/chart/gallery-tiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gallery-tiles.d.ts","sourceRoot":"","sources":["../../src/chart/gallery-tiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAI1D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAQ1D,kFAAkF;AAClF,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC,MAAM,CAoBR;AAKD,mGAAmG;AACnG,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC,MAAM,CAwER"}

package/dist/chart-format-locales.js

@@ -0,0 +1 @@
+export { CHART_FORMAT_LOCALES, CHART_FORMAT_STRINGS, prefixChartFormatStrings } from './chunk-VM6ZTKB3.js';

package/dist/chunk-CDAXY5KC.js

@@ -0,0 +1,118 @@
+// src/bindings/tracker.ts
+function createPropTracker() {
+  const sent = /* @__PURE__ */ new Map();
+  const changed = (key, value, same = Object.is) => {
+    if (sent.has(key) && same(sent.get(key), value)) return false;
+    sent.set(key, value);
+    return true;
+  };
+  return Object.assign(changed, {
+    seed: (key, value) => void sent.set(key, value),
+    sent: (key) => sent.get(key)
+  });
+}
+
+// src/bindings/bind-element.ts
+function listenEvents(element, events, handlers, onEvent) {
+  const listeners = /* @__PURE__ */ new Map();
+  for (const [name, rule] of Object.entries(events)) {
+    const listener = (event) => {
+      const custom = event;
+      onEvent?.(name, custom);
+      const handler = handlers()[rule.option];
+      if (typeof handler === "function")
+        handler(...rule.args?.(custom) ?? [custom.detail]);
+    };
+    listeners.set(name, listener);
+    element.addEventListener(name, listener);
+  }
+  return (names = [...listeners.keys()]) => {
+    for (const name of names) {
+      const listener = listeners.get(name);
+      if (!listener) continue;
+      element.removeEventListener(name, listener);
+      listeners.delete(name);
+    }
+  };
+}
+function bindElement(element, contract, handlers, options = {}) {
+  const tracker = createPropTracker();
+  const rules = Object.entries(contract.props);
+  for (const [key, rule] of rules) if ("initial" in rule) tracker.seed(key, rule.initial);
+  const unlisten = listenEvents(element, contract.events, handlers, options.onEvent);
+  return {
+    update(next) {
+      const values = next;
+      for (const [key, rule] of rules) {
+        if (rule.forward === "manual") continue;
+        const raw = values[key];
+        if (rule.forward === "defined" && raw === void 0) continue;
+        const value = raw === void 0 && rule.fallback !== void 0 ? rule.fallback : raw;
+        if (rule.forward !== "always" && !tracker(key, value, rule.same)) continue;
+        if (rule.apply) rule.apply(element, value);
+        else element[key] = value;
+      }
+    },
+    sent: (key) => tracker.sent(key),
+    unlisten
+  };
+}
+var tokens = (value) => value?.split(/\s+/u).filter(Boolean) ?? [];
+function syncClassName(element, previous, next) {
+  if (previous === next) return;
+  element.classList.remove(...tokens(previous));
+  element.classList.add(...tokens(next));
+}
+
+// src/bindings/equality.ts
+function sameList(a, b) {
+  if (a === b) return true;
+  const left = a ?? [];
+  const right = b ?? [];
+  return left.length === right.length && left.every((item, index) => item === right[index]);
+}
+function shallowEqual(a, b) {
+  if (a === b) return true;
+  const left = { ...a };
+  const right = { ...b };
+  const keys = Object.keys(left);
+  return keys.length === Object.keys(right).length && keys.every((key) => left[key] === right[key]);
+}
+
+// src/bindings/src-loader.ts
+function nameFromUrl(url) {
+  const last = url.split(/[?#]/u)[0]?.split("/").pop();
+  if (!last) return void 0;
+  try {
+    return decodeURIComponent(last);
+  } catch {
+    return last;
+  }
+}
+function createSrcLoader(load, report) {
+  let generation = 0;
+  let controller;
+  const cancel = () => {
+    generation++;
+    controller?.abort();
+    controller = void 0;
+  };
+  return {
+    cancel,
+    fetch(url, fileName) {
+      cancel();
+      const current = generation;
+      const signal = typeof AbortController === "undefined" ? void 0 : new AbortController();
+      controller = signal;
+      const live = () => current === generation;
+      void Promise.resolve().then(() => fetch(url, signal ? { signal: signal.signal } : void 0)).then(async (response) => {
+        if (!response.ok) throw new Error(`Could not fetch ${url}: HTTP ${response.status}`);
+        return new Uint8Array(await response.arrayBuffer());
+      }).then((bytes) => live() ? load(bytes, fileName ?? nameFromUrl(url)) : void 0).catch((error) => {
+        if (live()) report(error);
+      });
+    }
+  };
+}
+
+export { bindElement, createPropTracker, createSrcLoader, listenEvents, nameFromUrl, sameList, shallowEqual, syncClassName };

package/dist/chunk-FN7IF6M6.js

@@ -0,0 +1,25 @@
+// src/ribbon/safe-svg.ts
+var BLOCKED_ELEMENTS = /* @__PURE__ */ new Set(["script", "foreignobject", "iframe", "object", "embed"]);
+function parseSvgPreview(doc, svg) {
+  const Parser = doc.defaultView?.DOMParser ?? globalThis.DOMParser;
+  if (typeof Parser !== "function") return null;
+  const parsed = new Parser().parseFromString(svg, "image/svg+xml");
+  const root = parsed.documentElement;
+  if (root.localName !== "svg" || parsed.getElementsByTagName("parsererror").length > 0)
+    return null;
+  for (const node of Array.from(root.querySelectorAll("*"))) {
+    if (BLOCKED_ELEMENTS.has(node.localName.toLowerCase())) {
+      node.remove();
+      continue;
+    }
+    for (const attribute of Array.from(node.attributes))
+      if (/^on/iu.test(attribute.name) || /^\s*javascript:/iu.test(attribute.value))
+        node.removeAttribute(attribute.name);
+  }
+  for (const attribute of Array.from(root.attributes))
+    if (/^on/iu.test(attribute.name) || /^\s*javascript:/iu.test(attribute.value))
+      root.removeAttribute(attribute.name);
+  return doc.importNode(root, true);
+}
+
+export { parseSvgPreview };

package/dist/{chunk-4AARUBIF.js → chunk-HGLCXNCT.js}

@@ -1,6 +1,8 @@
 import { TeamsLitElement, LOCALE_HOST, teamsI18n, inheritLocale, pushLocale } from './chunk-FHO7TEWA.js';
+import { listenEvents, bindElement, syncClassName } from './chunk-CDAXY5KC.js';
+import { eventArgs, pickProps } from './chunk-NDUD5JJB.js';
 import { THEME_CSS, installOfficeUiTheme } from './chunk-T5ARELU2.js';
-import { defineMenuButton, defineMenuItem, registerControls, defineSwitch } from './chunk-DQEV4EMA.js';
+import { defineMenuButton, defineMenuItem, registerControls, defineSwitch } from './chunk-WDOWQKKC.js';
 import { registerIcon, getIcon } from './chunk-M6GF5ED2.js';
 import { initialsOf, definePresence } from './chunk-YZH2QS7J.js';
 import { definer, OfficeElement, controlStyles } from './chunk-QLHCGV4C.js';
@@ -6903,31 +6905,55 @@ function defineTeamsApp(registry = globalThis.customElements) {
 }
 
 // src/teams/app/bind.ts
-var SCALARS = ["workspaceId", "userName", "userId", "locale"];
+var TEAMS_CONTRACT = {
+  props: {
+    workspaceId: { forward: "changed", fallback: "demo" },
+    userName: { forward: "changed", fallback: "" },
+    userId: { forward: "changed", fallback: "" },
+    locale: { forward: "changed", fallback: "" },
+    // `null` clears the server settings; an omitted config keeps the dialog's or local mode.
+    config: { forward: "defined" },
+    uploadFile: { forward: "changed" },
+    openers: { forward: "changed", apply: (el, value) => el.openers = value ?? {} },
+    embeds: { forward: "changed", apply: (el, value) => el.embeds = value ?? {} }
+  },
+  events: {
+    "teams-ready": { option: "onReady" },
+    "teams-open-file": { option: "onOpenFile", args: eventArgs.detailAndEvent },
+    "teams-config-change": { option: "onConfigChange" }
+  },
+  handle: {}
+};
 function applyTeamsProps(el, props, prev = {}) {
-  for (const key of SCALARS) {
-    if (props[key] === prev[key]) continue;
-    el[key] = props[key] ?? (key === "workspaceId" ? "demo" : "");
-  }
-  if (props.config !== prev.config && props.config !== void 0) el.config = props.config;
-  if (props.uploadFile !== prev.uploadFile) el.uploadFile = props.uploadFile;
-  if (props.openers !== prev.openers) el.openers = props.openers ?? {};
-  if (props.embeds !== prev.embeds) el.embeds = props.embeds ?? {};
+  const next = props;
+  const before = prev;
+  for (const [key, rule] of Object.entries(TEAMS_CONTRACT.props)) {
+    const value = next[key];
+    if (value === before[key] || rule.forward === "defined" && value === void 0) continue;
+    const written = value === void 0 && rule.fallback !== void 0 ? rule.fallback : value;
+    if (rule.apply) rule.apply(el, written);
+    else el[key] = written;
+  }
 }
 function listenTeamsEvents(el, get) {
-  const ready = (e) => get().onReady?.(e.detail);
-  const open = (e) => {
-    const ce = e;
-    get().onOpenFile?.(ce.detail, ce);
-  };
-  const config = (e) => get().onConfigChange?.(e.detail);
-  el.addEventListener("teams-ready", ready);
-  el.addEventListener("teams-open-file", open);
-  el.addEventListener("teams-config-change", config);
-  return () => {
-    el.removeEventListener("teams-ready", ready);
-    el.removeEventListener("teams-open-file", open);
-    el.removeEventListener("teams-config-change", config);
+  const unlisten = listenEvents(el, TEAMS_CONTRACT.events, get);
+  return () => unlisten();
+}
+function pickTeamsProps(source) {
+  const picked = pickProps(TEAMS_CONTRACT, source, true);
+  if (source.className) picked.className = source.className;
+  return picked;
+}
+function bindTeams(el, get) {
+  let className;
+  const bound = bindElement(el, TEAMS_CONTRACT, get);
+  return {
+    update(next) {
+      bound.update(next);
+      syncClassName(el, className, next.className);
+      className = next.className;
+    },
+    destroy: () => bound.unlisten()
   };
 }
 function createTeams(options) {
@@ -6966,4 +6992,4 @@ function registerTeams() {
   defineCalendarAgenda();
 }
 
-export { EMOJI, OfficeUiActivityFeed, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCalendarAgenda, OfficeUiCalendarView, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiChatSidebar, OfficeUiPeoplePicker, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_TAGS, TeamsApp, TeamsChannelTab, TeamsContentPreview, TeamsController, TeamsElement, TeamsFilesPanel, TeamsSettings, XLSX_EDITOR_EVENTS, activityTime, announceFileCommand, applyTeamsProps, blobFor, colorFor, createTeams, dayKind, dayLabel, defineActivityFeed, defineAppRail, defineAvatar, defineCalendarAgenda, defineCalendarView, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, defineChatSidebar, definePeoplePicker, definePrejoin, defineTeamsApp, defineTeamsChannelTab, defineTeamsContentPreview, defineTeamsFilesPanel, defineTeamsSettings, downloadBytes, emit, emitEvent, formatElapsed, formatSize, formatTime, formatWhen, icon, listenTeamsEvents, loadConfig, loadIdentity, parseIceLines, pickFile, registerTeams, safeStorage, saveConfig, saveExtension, saveIdentity, withExtension, withStyles };
+export { EMOJI, OfficeUiActivityFeed, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCalendarAgenda, OfficeUiCalendarView, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiChatSidebar, OfficeUiPeoplePicker, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_CONTRACT, TEAMS_TAGS, TeamsApp, TeamsChannelTab, TeamsContentPreview, TeamsController, TeamsElement, TeamsFilesPanel, TeamsSettings, XLSX_EDITOR_EVENTS, activityTime, announceFileCommand, applyTeamsProps, bindTeams, blobFor, colorFor, createTeams, dayKind, dayLabel, defineActivityFeed, defineAppRail, defineAvatar, defineCalendarAgenda, defineCalendarView, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, defineChatSidebar, definePeoplePicker, definePrejoin, defineTeamsApp, defineTeamsChannelTab, defineTeamsContentPreview, defineTeamsFilesPanel, defineTeamsSettings, downloadBytes, emit, emitEvent, formatElapsed, formatSize, formatTime, formatWhen, icon, listenTeamsEvents, loadConfig, loadIdentity, parseIceLines, pickFile, pickTeamsProps, registerTeams, safeStorage, saveConfig, saveExtension, saveIdentity, withExtension, withStyles };