@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/smartart/ooxml-style-types.d.ts

@@ -0,0 +1,474 @@
+/**
+ * OOXML SmartArt Style Label Type Definitions
+ *
+ * Defines the type system for SmartArt's 3-file style resolution mechanism:
+ *
+ * 1. **Layout Definition** (`layout#.xml`) assigns `styleLbl` attributes to layout nodes
+ * 2. **Colors Definition** (`colors#.xml`) maps style label names to color lists
+ * 3. **Style Definition** (`quickStyle#.xml`) maps style label names to shape styles
+ *
+ * When rendering a SmartArt shape:
+ * - The layout node's `styleLbl` attribute (e.g., "node1", "sibTrans2D1") is looked up
+ *   in both the colors definition and the style definition
+ * - The colors definition provides fill, line, effect, and text colors
+ * - The style definition provides shape style references (line, fill, effect, font indices)
+ * - Together they fully resolve the visual appearance of every shape
+ *
+ * @see ECMA-376 Section 21.4.7 - Colors Definition
+ * @see ECMA-376 Section 21.4.8 - Style Definition
+ * @see https://learn.microsoft.com/en-us/previous-versions/office/developer/office-2007/dd439445(v=office.12)
+ */
+import type { Scene3D, Shape3D } from '../drawing/three-d';
+/**
+ * All 60+ known OOXML style label names.
+ *
+ * Style labels are assigned to layout nodes in layout definitions and are used
+ * to look up colors and styles from the colors/style definition files.
+ *
+ * The naming convention follows OOXML patterns:
+ * - `node0-4`: Primary content nodes (0 = default/base, 1-4 = accent levels)
+ * - `asst0-4`: Assistant nodes (org charts)
+ * - `fgAcc0-4`: Foreground accent shapes
+ * - `bgAcc1`: Background accent shapes
+ * - `sibTrans*`: Sibling transition connectors (between same-level nodes)
+ * - `parChTrans*`: Parent-child transition connectors
+ * - `bgShp/fgShp`: Background/foreground decorative shapes
+ * - `*ImgPlace*`: Image placeholder shapes
+ * - `*FollowNode*`: Shapes that inherit color from their associated node
+ *
+ * @see ECMA-376 Section 21.4.7.3 - ST_StyleLblName
+ */
+export type OoxmlStyleLabelName = 'node0' | 'node1' | 'node2' | 'node3' | 'node4' | 'asst0' | 'asst1' | 'asst2' | 'asst3' | 'asst4' | 'fgAcc0' | 'fgAcc1' | 'fgAcc2' | 'fgAcc3' | 'fgAcc4' | 'bgAcc1' | 'conFgAcc1' | 'alignNode1' | 'vennNode1' | 'lnNode1' | 'alignAcc1' | 'trAlignAcc1' | 'solidAlignAcc1' | 'solidFgAcc1' | 'solidBgAcc1' | 'alignAccFollowNode1' | 'fgAccFollowNode1' | 'bgAccFollowNode1' | 'fgImgPlace1' | 'alignImgPlace1' | 'bgImgPlace1' | 'sibTrans2D1' | 'fgSibTrans2D1' | 'bgSibTrans2D1' | 'sibTrans1D1' | 'callout' | 'parChTrans2D1' | 'parChTrans2D2' | 'parChTrans2D3' | 'parChTrans2D4' | 'parChTrans1D1' | 'parChTrans1D2' | 'parChTrans1D3' | 'parChTrans1D4' | 'bgShp' | 'dkBgShp' | 'trBgShp' | 'fgShp' | 'revTx';
+/**
+ * Array of all known style label names for iteration and validation.
+ *
+ * @see OoxmlStyleLabelName for the union type
+ */
+export declare const OOXML_STYLE_LABEL_NAMES: readonly OoxmlStyleLabelName[];
+/**
+ * OOXML color transform type.
+ *
+ * Color transforms modify a base scheme color to produce derived colors.
+ * They are applied in sequence to the base color value.
+ *
+ * @see ECMA-376 Section 20.1.2.3 - Color Transforms
+ */
+export type ColorTransformType = 
+/** Luminance modulation - multiply luminance by val/100000 */
+'lumMod'
+/** Luminance offset - add val/100000 to luminance */
+ | 'lumOff'
+/** Saturation modulation - multiply saturation by val/100000 */
+ | 'satMod'
+/** Saturation offset - add val/100000 to saturation */
+ | 'satOff'
+/** Tint - blend toward white by val/100000 */
+ | 'tint'
+/** Shade - blend toward black by val/100000 */
+ | 'shade'
+/** Alpha/transparency - set alpha to val/100000 */
+ | 'alpha'
+/** Hue modulation - multiply hue by val/100000 */
+ | 'hueMod'
+/** Hue offset - add val/100000 to hue angle */
+ | 'hueOff'
+/** Complement - use the complementary (opposite) color */
+ | 'comp'
+/** Inverse - invert the color */
+ | 'inv'
+/** Grayscale - convert to grayscale */
+ | 'gray';
+/**
+ * A single color transform operation.
+ *
+ * Transforms are applied sequentially to a base color. The `val` field
+ * uses OOXML's percentage scale where 100000 = 100%.
+ *
+ * @example
+ * // Make a color 60% as bright:
+ * { type: 'lumMod', val: 60000 }
+ *
+ * @example
+ * // Add 40% luminance offset:
+ * { type: 'lumOff', val: 40000 }
+ *
+ * @example
+ * // Complement has no value:
+ * { type: 'comp' }
+ *
+ * @see ECMA-376 Section 20.1.2.3 - Color Transforms
+ */
+export interface ColorTransform {
+    /** The transform operation type */
+    type: ColorTransformType;
+    /**
+     * Transform value as OOXML percentage (0-100000 where 100000 = 100%).
+     *
+     * Not all transforms require a value:
+     * - `comp`, `inv`, `gray` have no value (they are boolean operations)
+     * - All others require a percentage value
+     */
+    val?: number;
+}
+/**
+ * OOXML scheme color reference.
+ *
+ * Scheme colors are symbolic references to the document's theme color palette.
+ * They are resolved at render time against the active theme, enabling SmartArt
+ * diagrams to automatically adapt when the document theme changes.
+ *
+ * @see ECMA-376 Section 20.1.2.3.29 - schemeClr
+ */
+export interface SchemeColor {
+    /**
+     * Scheme color name referencing a theme color slot.
+     *
+     * Standard values:
+     * - `'dk1'`, `'dk2'` - Dark colors (typically black/dark gray)
+     * - `'lt1'`, `'lt2'` - Light colors (typically white/light gray)
+     * - `'accent1'` through `'accent6'` - Theme accent colors
+     * - `'hlink'` - Hyperlink color
+     * - `'folHlink'` - Followed hyperlink color
+     * - `'tx1'`, `'tx2'` - Text colors
+     * - `'bg1'`, `'bg2'` - Background colors
+     */
+    val: string;
+    /**
+     * Optional color transforms applied sequentially to the base scheme color.
+     *
+     * @example
+     * // accent1 at 80% luminance with 20% luminance offset:
+     * { val: 'accent1', transforms: [{ type: 'lumMod', val: 80000 }, { type: 'lumOff', val: 20000 }] }
+     */
+    transforms?: ColorTransform[];
+}
+/**
+ * A list of scheme colors with a distribution method.
+ *
+ * Used in colors definitions to specify how colors are assigned
+ * to shapes that share the same style label.
+ *
+ * @see ECMA-376 Section 21.4.7.5 - fillClrLst, linClrLst, etc.
+ */
+export interface ColorList {
+    /**
+     * How colors from this list are distributed across shapes:
+     *
+     * - `'repeat'`: Cycle through the color list. Shape N uses color[N % length].
+     *   Most common method; ensures each shape gets a color even if there are more
+     *   shapes than colors.
+     *
+     * - `'span'`: Interpolate across the list. Colors are distributed evenly
+     *   across all shapes, creating a gradient-like effect.
+     */
+    method: 'repeat' | 'span';
+    /**
+     * The ordered list of scheme colors.
+     *
+     * For `method='repeat'`, shapes cycle through this list.
+     * For `method='span'`, colors are interpolated across shapes.
+     */
+    colors: SchemeColor[];
+}
+/**
+ * Color definitions for a single style label.
+ *
+ * Each style label in a colors definition maps to six color lists that
+ * control different aspects of shape rendering:
+ *
+ * - Fill colors: Shape background
+ * - Line colors: Shape border/outline
+ * - Effect colors: Visual effects (shadow, glow)
+ * - Text line colors: Text outline
+ * - Text fill colors: Text foreground
+ * - Text effect colors: Text visual effects
+ *
+ * @see ECMA-376 Section 21.4.7.3 - styleLbl (Colors Definition)
+ */
+export interface StyleLabelColors {
+    /**
+     * Style label name (e.g., 'node1', 'sibTrans2D1').
+     * Matches the `styleLbl` attribute on layout nodes.
+     */
+    name: string;
+    /** Fill color list for shape backgrounds */
+    fillClrLst: ColorList;
+    /** Line/stroke color list for shape outlines */
+    linClrLst: ColorList;
+    /** Effect color list for visual effects (shadow, glow, etc.) */
+    effectClrLst: ColorList;
+    /** Text line/outline color list */
+    txLinClrLst: ColorList;
+    /** Text fill color list */
+    txFillClrLst: ColorList;
+    /** Text effect color list */
+    txEffectClrLst: ColorList;
+}
+/**
+ * OOXML Colors Definition.
+ *
+ * Represents a parsed `colors#.xml` file from a SmartArt diagram.
+ * Each SmartArt has exactly one colors definition that controls
+ * how colors are assigned to shapes based on their style labels.
+ *
+ * The colors definition is selected by the user via the "Change Colors"
+ * gallery in the SmartArt Design tab.
+ *
+ * @see ECMA-376 Section 21.4.7 - Colors Definition
+ */
+export interface ColorsDef {
+    /**
+     * Unique identifier for this colors definition.
+     *
+     * @example 'urn:microsoft.com/office/officeart/2005/8/colors/accent1_2'
+     */
+    uniqueId: string;
+    /** Display title shown in the Change Colors gallery */
+    title: string;
+    /** Description/tooltip text */
+    desc: string;
+    /**
+     * Categories this colors definition belongs to.
+     * Used for grouping in the gallery UI.
+     *
+     * @example [{ type: 'mainScheme', pri: 10100 }]
+     */
+    categories: Array<{
+        type: string;
+        pri: number;
+    }>;
+    /**
+     * Map of style label names to their color definitions.
+     *
+     * When rendering a shape, its layout node's `styleLbl` attribute
+     * is used as the key to look up colors from this map.
+     */
+    styleLabelMap: Map<string, StyleLabelColors>;
+}
+export type { Scene3D } from '../drawing/three-d';
+/**
+ * SmartArt-specific 3D shape properties.
+ *
+ * Extends the shared Shape3D interface with SmartArt's SchemeColor
+ * for extrusion and contour colors (which reference theme color slots).
+ *
+ * @see ECMA-376 Section 20.1.5.12 - sp3d
+ */
+export type ShapeProperties3D = Omit<Shape3D, 'extrusionClr' | 'contourClr'> & {
+    /** Extrusion color (the color of the 3D sides when extruded) */
+    extrusionClr?: SchemeColor;
+    /** Contour color (the color of the outline on 3D shapes) */
+    contourClr?: SchemeColor;
+};
+/**
+ * Text properties for style label styling.
+ *
+ * Defines text formatting that can be applied through style definitions,
+ * including font size, spacing, and 3D text effects.
+ *
+ * @see ECMA-376 Section 21.1.2.2.27 - txPr
+ */
+export interface TextProperties {
+    /**
+     * Default text run properties including font size and style.
+     */
+    defRPr?: {
+        /** Font size in hundredths of a point (e.g., 1200 = 12pt) */
+        sz?: number;
+        /** Bold flag */
+        b?: boolean;
+        /** Italic flag */
+        i?: boolean;
+        /** Font family */
+        latin?: string;
+    };
+    /**
+     * Body properties including text wrapping and anchoring.
+     */
+    bodyPr?: {
+        /** Vertical text anchor: 't' (top), 'ctr' (center), 'b' (bottom) */
+        anchor?: string;
+        /** Horizontal overflow: 'clip' or 'overflow' */
+        horzOverflow?: string;
+        /** Vertical overflow: 'clip' or 'overflow' */
+        vertOverflow?: string;
+    };
+}
+/**
+ * Style reference set for a shape.
+ *
+ * References the document theme's format scheme to resolve line, fill,
+ * effect, and font styles. Each reference has an index into the theme's
+ * style arrays and an optional scheme color override.
+ *
+ * @see ECMA-376 Section 21.4.8.3 - style
+ */
+export interface StyleReference {
+    /**
+     * Line style reference.
+     * idx references a:fmtScheme/a:lnStyleLst entry (0-based).
+     * idx=0 means no line; idx=1,2,3 reference subtle/moderate/intense line styles.
+     */
+    lnRef: {
+        /** Index into the theme's line style list (0 = none) */
+        idx: number;
+        /** Optional scheme color override for the line */
+        schemeClr?: SchemeColor;
+    };
+    /**
+     * Fill style reference.
+     * idx references a:fmtScheme/a:fillStyleLst entry (0-based).
+     * idx=0 means no fill; idx=1,2,3 reference subtle/moderate/intense fills.
+     * idx=1001,1002,1003 reference background fill styles.
+     */
+    fillRef: {
+        /** Index into the theme's fill style list (0 = none) */
+        idx: number;
+        /** Optional scheme color override for the fill */
+        schemeClr?: SchemeColor;
+    };
+    /**
+     * Effect style reference.
+     * idx references a:fmtScheme/a:effectStyleLst entry (0-based).
+     * idx=0 means no effect; idx=1,2,3 reference subtle/moderate/intense effects.
+     */
+    effectRef: {
+        /** Index into the theme's effect style list (0 = none) */
+        idx: number;
+        /** Optional scheme color override for the effect */
+        schemeClr?: SchemeColor;
+    };
+    /**
+     * Font style reference.
+     * idx is a string ('minor', 'major', or 'none') referencing theme fonts.
+     * - 'minor': Body font (typically Calibri)
+     * - 'major': Heading font (typically Calibri Light)
+     * - 'none': No font override
+     */
+    fontRef: {
+        /** Font theme reference: 'minor' (body), 'major' (heading), or 'none' */
+        idx: string;
+        /** Optional scheme color override for the font color */
+        schemeClr?: SchemeColor;
+    };
+}
+/**
+ * Style definitions for a single style label.
+ *
+ * Each style label in a style definition maps to shape style properties
+ * including theme style references, optional 3D properties, and text formatting.
+ *
+ * @see ECMA-376 Section 21.4.8.2 - styleLbl (Style Definition)
+ */
+export interface StyleLabelStyle {
+    /**
+     * Style label name (e.g., 'node1', 'sibTrans2D1').
+     * Matches the `styleLbl` attribute on layout nodes.
+     */
+    name: string;
+    /**
+     * Per-label 3D scene override.
+     * If present, overrides the style definition's top-level scene3d.
+     */
+    scene3d?: Scene3D;
+    /**
+     * Per-label 3D shape properties.
+     * Defines bevel, extrusion, and contour effects for this label's shapes.
+     */
+    sp3d?: ShapeProperties3D;
+    /**
+     * Per-label text property overrides.
+     * Defines text formatting specific to this style label.
+     */
+    txPr?: TextProperties;
+    /**
+     * Shape style references into the document theme.
+     * Provides line, fill, effect, and font references that are resolved
+     * against the theme's format scheme at render time.
+     */
+    style: StyleReference;
+}
+/**
+ * OOXML Style Definition.
+ *
+ * Represents a parsed `quickStyle#.xml` file from a SmartArt diagram.
+ * Each SmartArt has exactly one style definition that controls the
+ * shape styles (line weight, fill intensity, effects, fonts) based
+ * on style labels.
+ *
+ * The style definition is selected by the user via the "SmartArt Styles"
+ * gallery in the SmartArt Design tab.
+ *
+ * Style definitions work in conjunction with colors definitions:
+ * - Colors definition provides the actual colors (from theme scheme colors)
+ * - Style definition provides the style intensity (subtle/moderate/intense)
+ *   via theme format scheme indices
+ *
+ * @see ECMA-376 Section 21.4.8 - Style Definition
+ */
+export interface StyleDef {
+    /**
+     * Unique identifier for this style definition.
+     *
+     * @example 'urn:microsoft.com/office/officeart/2005/8/quickstyle/simple1'
+     */
+    uniqueId: string;
+    /** Display title shown in the SmartArt Styles gallery */
+    title: string;
+    /** Description/tooltip text */
+    desc: string;
+    /**
+     * Categories this style definition belongs to.
+     * Used for grouping in the gallery UI.
+     *
+     * @example [{ type: 'simple', pri: 10100 }]
+     */
+    categories: Array<{
+        type: string;
+        pri: number;
+    }>;
+    /**
+     * Top-level 3D scene settings for this style.
+     * Applies to all shapes unless overridden at the style label level.
+     * Only present for 3D quick styles.
+     */
+    scene3d?: Scene3D;
+    /**
+     * Map of style label names to their style definitions.
+     *
+     * When rendering a shape, its layout node's `styleLbl` attribute
+     * is used as the key to look up style properties from this map.
+     */
+    styleLabelMap: Map<string, StyleLabelStyle>;
+}
+/**
+ * A fully resolved style for a single shape, combining colors and style definitions.
+ *
+ * This is the output of the style label resolution process. It contains
+ * all the information needed to render a shape's visual appearance.
+ */
+export interface ResolvedShapeStyle {
+    /** The style label name that was resolved */
+    styleLbl: string;
+    /** Resolved fill color (hex or CSS color) */
+    fillColor: string;
+    /** Resolved line/stroke color */
+    lineColor: string;
+    /** Resolved effect color */
+    effectColor: string;
+    /** Resolved text fill color */
+    textFillColor: string;
+    /** Resolved text line color */
+    textLineColor: string;
+    /** Resolved text effect color */
+    textEffectColor: string;
+    /** Resolved style reference */
+    style: StyleReference;
+    /** Optional 3D scene settings */
+    scene3d?: Scene3D;
+    /** Optional 3D shape properties */
+    sp3d?: ShapeProperties3D;
+    /** Optional text property overrides */
+    txPr?: TextProperties;
+}
+//# sourceMappingURL=ooxml-style-types.d.ts.map

package/dist/smartart/ooxml-style-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ooxml-style-types.d.ts","sourceRoot":"","sources":["../../src/smartart/ooxml-style-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAM3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,mBAAmB,GAK3B,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GAMP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GAMP,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GAKR,QAAQ,GAKR,WAAW,GAKX,YAAY,GACZ,WAAW,GACX,SAAS,GAQT,WAAW,GACX,aAAa,GACb,gBAAgB,GAKhB,aAAa,GACb,aAAa,GAKb,qBAAqB,GACrB,kBAAkB,GAClB,kBAAkB,GAKlB,aAAa,GACb,gBAAgB,GAChB,aAAa,GAUb,aAAa,GACb,eAAe,GACf,eAAe,GACf,aAAa,GACb,SAAS,GAQT,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,GAQf,OAAO,GACP,SAAS,GACT,SAAS,GAKT,OAAO,GAKP,OAAO,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,mBAAmB,EA+ExD,CAAC;AAMX;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB;AAC5B,8DAA8D;AAC5D,QAAQ;AACV,qDAAqD;GACnD,QAAQ;AACV,gEAAgE;GAC9D,QAAQ;AACV,uDAAuD;GACrD,QAAQ;AACV,8CAA8C;GAC5C,MAAM;AACR,+CAA+C;GAC7C,OAAO;AACT,mDAAmD;GACjD,OAAO;AACT,kDAAkD;GAChD,QAAQ;AACV,+CAA+C;GAC7C,QAAQ;AACV,0DAA0D;GACxD,MAAM;AACR,iCAAiC;GAC/B,KAAK;AACP,uCAAuC;GACrC,MAAM,CAAC;AAEX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,IAAI,EAAE,kBAAkB,CAAC;IAEzB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;OAWG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;;;;OASG;IACH,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAE1B;;;;;OAKG;IACH,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAMD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb,4CAA4C;IAC5C,UAAU,EAAE,SAAS,CAAC;IAEtB,gDAAgD;IAChD,SAAS,EAAE,SAAS,CAAC;IAErB,gEAAgE;IAChE,YAAY,EAAE,SAAS,CAAC;IAExB,mCAAmC;IACnC,WAAW,EAAE,SAAS,CAAC;IAEvB,2BAA2B;IAC3B,YAAY,EAAE,SAAS,CAAC;IAExB,6BAA6B;IAC7B,cAAc,EAAE,SAAS,CAAC;CAC3B;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IAEd,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C;AAQD,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAAC,GAAG;IAC7E,gEAAgE;IAChE,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B,CAAC;AAMF;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,6DAA6D;QAC7D,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,gBAAgB;QAChB,CAAC,CAAC,EAAE,OAAO,CAAC;QACZ,kBAAkB;QAClB,CAAC,CAAC,EAAE,OAAO,CAAC;QACZ,kBAAkB;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,oEAAoE;QACpE,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,gDAAgD;QAChD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,8CAA8C;QAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,KAAK,EAAE;QACL,wDAAwD;QACxD,GAAG,EAAE,MAAM,CAAC;QACZ,kDAAkD;QAClD,SAAS,CAAC,EAAE,WAAW,CAAC;KACzB,CAAC;IAEF;;;;;OAKG;IACH,OAAO,EAAE;QACP,wDAAwD;QACxD,GAAG,EAAE,MAAM,CAAC;QACZ,kDAAkD;QAClD,SAAS,CAAC,EAAE,WAAW,CAAC;KACzB,CAAC;IAEF;;;;OAIG;IACH,SAAS,EAAE;QACT,0DAA0D;QAC1D,GAAG,EAAE,MAAM,CAAC;QACZ,oDAAoD;QACpD,SAAS,CAAC,EAAE,WAAW,CAAC;KACzB,CAAC;IAEF;;;;;;OAMG;IACH,OAAO,EAAE;QACP,yEAAyE;QACzE,GAAG,EAAE,MAAM,CAAC;QACZ,wDAAwD;QACxD,SAAS,CAAC,EAAE,WAAW,CAAC;KACzB,CAAC;CACH;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC;IAEzB;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;;;OAIG;IACH,KAAK,EAAE,cAAc,CAAC;CACvB;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IAEd,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEjD;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC7C;AAMD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IAIjB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAElB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IAEpB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IAEtB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IAEtB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IAIxB,+BAA+B;IAC/B,KAAK,EAAE,cAAc,CAAC;IAEtB,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,mCAAmC;IACnC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IAEzB,uCAAuC;IACvC,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB"}

package/dist/smartart/styles.d.ts

@@ -0,0 +1,137 @@
+/**
+ * SmartArt Style Types
+ *
+ * Type definitions for SmartArt quick styles and color themes.
+ * These match Excel's built-in SmartArt style options.
+ *
+ * Quick Styles: Define shape appearance (fill type, stroke, effects)
+ * Color Themes: Define color palettes and how colors are applied to nodes
+ */
+import type { ShapeEffects } from './types';
+/**
+ * Quick Style preset definition.
+ *
+ * Quick styles define the visual appearance of shapes including:
+ * - Fill type and opacity
+ * - Stroke width and opacity
+ * - Visual effects (shadow, glow, bevel, etc.)
+ *
+ * Excel provides 12 built-in quick styles across 4 categories.
+ */
+export interface QuickStyle {
+    /** Unique style identifier */
+    id: string;
+    /** Display name shown in the style gallery */
+    name: string;
+    /** Style category for grouping in gallery */
+    category: 'subtle' | 'moderate' | 'intense' | '3d';
+    /** Type of fill to apply to shapes */
+    fillType: 'solid' | 'gradient' | 'pattern';
+    /** Fill opacity (0 = transparent, 1 = opaque) */
+    fillOpacity: number;
+    /** Stroke/border width in pixels */
+    strokeWidth: number;
+    /** Stroke opacity (0 = transparent, 1 = opaque) */
+    strokeOpacity: number;
+    /** Visual effects to apply (shadow, glow, bevel, etc.) */
+    effects: ShapeEffects;
+    /** Thumbnail image for the style gallery (base64 data URL or asset URL) */
+    thumbnail: string;
+}
+/**
+ * Color theme definition.
+ *
+ * Color themes define:
+ * - A palette of colors to use
+ * - How colors are applied to nodes (strategy)
+ * - Transparency levels
+ *
+ * Excel provides 32+ built-in color themes.
+ */
+export interface ColorTheme {
+    /** Unique theme identifier */
+    id: string;
+    /** Display name shown in the theme gallery */
+    name: string;
+    /** Theme category for grouping in gallery */
+    category: 'colorful' | 'accent' | 'transparent';
+    /**
+     * Color generation strategy - how colors are applied to nodes:
+     *
+     * - 'sequential': Each node gets the next color in the palette, cycling through
+     * - 'by-level': Color is determined by hierarchy level (level 0 = color 1, etc.)
+     * - 'gradient': Colors transition smoothly through the palette
+     * - 'single': All nodes use the same color (for accent themes)
+     */
+    colorStrategy: 'sequential' | 'by-level' | 'gradient' | 'single';
+    /**
+     * Base colors for the theme.
+     *
+     * If empty, uses the document's theme accent colors.
+     * Colors are CSS color strings (hex, rgb, etc.).
+     */
+    colors: string[];
+    /**
+     * Transparency level for shapes.
+     *
+     * 1 = fully opaque, 0 = fully transparent.
+     * Used primarily for 'transparent' category themes.
+     */
+    opacity: number;
+}
+/**
+ * Built-in quick style IDs matching Excel's SmartArt Styles gallery.
+ *
+ * Excel provides exactly 14 presets organized into 2D and 3D groups:
+ *
+ * 2D Styles (5):
+ * - simple-fill: Solid color fill, no effects
+ * - subtle-line: Low-opacity fill with prominent stroke (White Outline)
+ * - subtle-effect: Solid fill with light shadow
+ * - moderate-effect: Gradient fill with medium shadow
+ * - intense-effect: Gradient fill with strong shadow and glow
+ *
+ * 3D Styles (9):
+ * - polished: Gradient fill with glow
+ * - inset: Solid fill with inset shadow
+ * - 3d-cartoon: Solid fill with bold stroke and soft-round bevel
+ * - powder: Soft solid fill with diffuse shadow
+ * - 3d-polished: Gradient fill with convex bevel and perspective
+ * - 3d-flat-scene: Solid fill with relaxed bevel
+ * - 3d-powder: Soft solid fill with circle bevel
+ * - brick-scene: Solid fill with convex bevel and bottom shadow
+ * - metallic-scene: Gradient fill with reflection
+ * - sunrise-scene: Gradient fill with warm perspective shadow
+ * - birds-eye-scene: Solid fill with top-down shadow
+ *
+ * Note: The category grouping ('subtle'/'moderate'/'intense'/'3d') is
+ * used for gallery UI display. The OOXML quickStyle URIs map to these IDs.
+ */
+export declare const QUICK_STYLE_IDS: readonly ["simple-fill", "subtle-effect", "subtle-line", "moderate-effect", "intense-effect", "polished", "inset", "3d-cartoon", "powder", "3d-polished", "3d-flat-scene", "3d-powder", "brick-scene", "metallic-scene", "sunrise-scene", "birds-eye-scene"];
+/**
+ * Built-in color theme IDs matching Excel's Change Colors gallery.
+ *
+ * Organized by section:
+ * - Colorful (5): Uses multiple accent colors in sequence
+ * - Primary theme colors (5): Uses document dk1/dk2/lt1/lt2 colors
+ * - Accent variations (24): 6 accents x 4 variations each (light, outline, fill, gradient)
+ * - Transparent (2): Semi-transparent variations
+ *
+ * Total: 36 built-in themes
+ */
+export declare const COLOR_THEME_IDS: readonly ["colorful-1", "colorful-2", "colorful-3", "colorful-4", "colorful-5", "dark-1-outline", "light-1-outline", "dark-1-fill", "light-2-outline", "dark-2-fill", "accent-1-light", "accent-1-outline", "accent-1-fill", "accent-1-gradient", "accent-2-light", "accent-2-outline", "accent-2-fill", "accent-2-gradient", "accent-3-light", "accent-3-outline", "accent-3-fill", "accent-3-gradient", "accent-4-light", "accent-4-outline", "accent-4-fill", "accent-4-gradient", "accent-5-light", "accent-5-outline", "accent-5-fill", "accent-5-gradient", "accent-6-light", "accent-6-outline", "accent-6-fill", "accent-6-gradient", "transparent-gradient", "transparent-outline"];
+/**
+ * Type representing valid quick style IDs.
+ *
+ * Union of all built-in quick style IDs.
+ * Use this for type-safe style references.
+ */
+export type QuickStyleId = (typeof QUICK_STYLE_IDS)[number];
+/**
+ * Type representing valid color theme IDs.
+ *
+ * Includes all built-in theme IDs plus `| string` to allow custom themes.
+ * Custom themes can be defined by users or imported from XLSX files.
+ */
+export type ColorThemeId = (typeof COLOR_THEME_IDS)[number] | string;
+//# sourceMappingURL=styles.d.ts.map

package/dist/smartart/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/smartart/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAM5C;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IAEX,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,QAAQ,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC;IAInD,sCAAsC;IACtC,QAAQ,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAE3C,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IAIpB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IAEpB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IAItB,0DAA0D;IAC1D,OAAO,EAAE,YAAY,CAAC;IAItB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IAEX,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,QAAQ,EAAE,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;IAEhD;;;;;;;OAOG;IACH,aAAa,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;IAEjE;;;;;OAKG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,eAAe,8PAoBlB,CAAC;AAMX;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,8pBAsDlB,CAAC;AAMX;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC"}