@sheetxl/sdk 0.7.21 → 0.7.23-beta.2

package/types/src/color/IColor.d.ts

@@ -0,0 +1,1110 @@
+import { ColorSpace } from './ColorSpace';
+/**
+ * Represents a color with optional adjustments applied.
+ *
+ * An `IColor` consists of:
+ * - `baseColor`: The underlying color, which can be a scheme color (e.g., Accent1), a built-in color (e.g., 'red', 'blue'),
+ *   or defined using various color models (RGB, Hex, HSL).
+ * - `adjustments` (optional): An ordered list of color adjustments that modify the `baseColor`.
+ *   These adjustments can include effects like grayscale, inversion, or modifications to specific color components (red, alpha, etc.).
+ * @see
+ * {@link AdjustmentType}
+ */
+export interface IColor {
+    /**
+     * The base value for the color before adjustments.
+     */
+    getVal(): string;
+    /**
+     * Return the color adjustments.
+     */
+    getAdjustments(): readonly IColor.Adjustment[];
+    /**
+     * Return as RGBA with adjustments applied.
+     * @param darkMode
+     */
+    toRGBA(darkMode?: boolean): IColor.ISpace.RGBA;
+    /**
+     * Return as HSLA with adjustments applied.
+     * @param darkMode
+     */
+    toHSLA(darkMode?: boolean): IColor.ISpace.HSLA;
+    /**
+     * Return a HEX with adjustments applied.
+     * @param darkMode
+     */
+    toHex(darkMode?: boolean): IColor.ISpace.HEX;
+    /**
+     * Return a string usable with CSS color properties.
+     *
+     * @param mode `false`/`true` bake a concrete light/dark value — use when the output leaves
+     * live CSS (clipboard HTML, export, canvas). `'adaptive'` emits a `light-dark()` expression the
+     * browser re-resolves from the subtree's `color-scheme` — a light/dark flip needs no re-render
+     * (renderers should prefer this; see {@link IColor.CSSMode}).
+     * @param alpha If `true` alpha will be applied.
+     */
+    toCSS(mode?: IColor.CSSMode, alpha?: boolean): string;
+    /**
+     * Returns a new color that is derived from this color with the adjustments applied.
+     * @param adjustments An array of Adjustments
+     */
+    adjust(adjustments: readonly IColor.Adjustment[]): IColor;
+    /**
+     * Returns the base color without any adjustments applied.
+     */
+    getBaseColor(): IColor;
+    /**
+     * For a system color, returns the authored fallback value (OOXML `lastClr`) as a 6-digit hex
+     * string (no leading `#`), or `null` if none. This is the value used when no
+     * {@link IColor.SystemLookup} resolves the color (e.g. headless rendering).
+     */
+    getLastColor(): string | null;
+    /**
+     * Returns the color as either 'black or white' depending on the luminance.
+     *
+     * @param threshold The threshold to determine if the color is dark or light. @defaultValue '186'
+     */
+    toBlackOrWhite(darkMode?: boolean, threshold?: number): IColor;
+    /**
+     * Return the color as a string.
+     * @remarks
+     */
+    toString(): string;
+    /**
+     * Return the type of color value used (e.g., scheme, named, index, hsl, rgb, hex).
+     */
+    getType(): IColor.Type;
+    /**
+     * Returns true if the other color will resolve to the same rgb values as this color.
+     * @param other The other color to compare.
+     */
+    isEqual(other: any): boolean;
+    /**
+     * For runtime type checking.
+     */
+    readonly isIColor: true;
+}
+/**
+ * {@inheritDoc IColor}
+ * @see
+ * ### **Interface**
+ *
+ * {@link IColor}
+ *
+ * ### **Implementation**
+ *
+ * {@link IColor}
+ */
+export declare namespace IColor {
+    /**
+     * The rendering mode for `toCSS`-style methods.
+     *
+     * - `false` / `true` — bake a concrete value for that one mode. Required when the output leaves
+     *   live CSS (clipboard HTML — external apps don't parse `light-dark()` — export, canvas,
+     *   image/data-URI generation).
+     * - `'adaptive'` — emit a `light-dark(lightVal, darkVal)` expression. The browser re-resolves it
+     *   from the subtree's `color-scheme`, so a light/dark flip is a pure attribute change: cached
+     *   DOM (e.g. the grid's tile snapshots) re-colors with NO re-render and no invalidation.
+     *
+     * Renderers should pass `'adaptive'`; only leave-the-page consumers bake.
+     */
+    type CSSMode = boolean | 'adaptive';
+    /**
+     * Represents a color space.
+     */
+    namespace ISpace {
+        /**
+         * A color in the Red, Green, Blue color space.
+         */
+        type RGBA = ColorSpace.RGBA;
+        /**
+         * A color in the Hue, Saturation, Luminosity color space.
+         */
+        type HSLA = ColorSpace.HSLA;
+        /**
+         * A color (Red, Green, Blue) encoded in hexadecimal.
+         */
+        type HEX = ColorSpace.HEX;
+    }
+    /**
+     * Represents various adjustment types for color properties, allowing fine-tuned control over
+     * attributes such as transparency, hue, saturation, luminance, and RGB components.
+     *
+     * The adjusts are based on the DrawML OOXML specification, with an additional adjustment type (`ETint`)
+     * based on the Excel tint shading algorithm.
+     *
+     * * Adjustments can be chained to achieve complex color transformations.
+     */
+    const AdjustmentType: {
+        /**
+         * Adjusts the transparency level of a color.
+         */
+        readonly Alpha: "alpha";
+        /**
+         * Adjusts the transparency offset of a color.
+         */
+        readonly AlphaOff: "alphaOff";
+        /**
+         * Modifies the transparency of a color by a multiplier.
+         */
+        readonly AlphaMod: "alphaMod";
+        /**
+         * Adjusts the hue of a color.
+         */
+        readonly Hue: "hue";
+        /**
+         * Adjusts the saturation of a color.
+         */
+        readonly Sat: "sat";
+        /**
+         * Adjusts the luminance (brightness) of a color.
+         */
+        readonly Lum: "lum";
+        /**
+         * Applies an offset to the hue of a color.
+         */
+        readonly HueOff: "hueOff";
+        /**
+         * Applies an offset to the saturation of a color.
+         */
+        readonly SatOff: "satOff";
+        /**
+         * Applies an offset to the luminance of a color.
+         */
+        readonly LumOff: "lumOff";
+        /**
+         * Modifies the hue of a color by a multiplier.
+         */
+        readonly HueMod: "hueMod";
+        /**
+         * Modifies the saturation of a color by a multiplier.
+         */
+        readonly SatMod: "satMod";
+        /**
+         * Modifies the luminance of a color by a multiplier.
+         */
+        readonly LumMod: "lumMod";
+        /**
+         * Adjusts the red component of a color.
+         */
+        readonly Red: "red";
+        /**
+         * Adjusts the green component of a color.
+         */
+        readonly Green: "green";
+        /**
+         * Adjusts the blue component of a color.
+         */
+        readonly Blue: "blue";
+        /**
+         * Applies an offset to the red component of a color.
+         */
+        readonly RedOff: "redOff";
+        /**
+         * Applies an offset to the green component of a color.
+         */
+        readonly GreenOff: "greenOff";
+        /**
+         * Applies an offset to the blue component of a color.
+         */
+        readonly BlueOff: "blueOff";
+        /**
+         * Modifies the red component of a color by a multiplier.
+         */
+        readonly RedMod: "redMod";
+        /**
+         * Modifies the green component of a color by a multiplier.
+         */
+        readonly GreenMod: "greenMod";
+        /**
+         * Modifies the blue component of a color by a multiplier.
+         */
+        readonly BlueMod: "blueMod";
+        /**
+         * Shades a color, making it darker by reducing its luminance.
+         */
+        readonly Shade: "shade";
+        /**
+         * Tints a color, making it lighter by increasing its luminance.
+         */
+        readonly Tint: "tint";
+        /**
+         * Tints a color based on Excel's specific tint shading algorithm.
+         */
+        readonly ETint: "eTint";
+        /**
+         * Converts a color to grayscale.
+         */
+        readonly Gray: "gray";
+        /**
+         * Creates a complementary color.
+         */
+        readonly Comp: "comp";
+        /**
+         * Inverts a color.
+         */
+        readonly Inv: "inv";
+        /**
+         * Applies gamma correction to a color.
+         */
+        readonly Gamma: "gamma";
+        /**
+         * Inverts the gamma correction of a color.
+         */
+        readonly InvGamma: "invGamma";
+    };
+    type AdjustmentType = typeof AdjustmentType[keyof typeof AdjustmentType];
+    /**
+     * Represents a color adjustment.
+     *
+     * @remarks
+     * All percentages are expresses as 0-100 except alpha which is 0-1.
+     */
+    type Adjustment = {
+        [key in IColor.AdjustmentType]?: boolean | number;
+    };
+    /**
+     * Represents a value and adjustment.
+     */
+    interface Definition {
+        val: string;
+        adjs?: readonly IColor.Adjustment[];
+        /**
+         * For a system color, the authored fallback value (OOXML `lastClr`) as a 6-digit hex
+         * string (no leading `#`). Serialized as a trailing `lastClr <hex>` token.
+         */
+        last?: string;
+    }
+    /**
+     * Associate a color definition with a human-readable label.
+     * @remarks
+     * Useful for displaying color options in a UI.
+     */
+    interface DefinitionWithLabel {
+        description: string;
+        definition: IColor.Definition;
+    }
+    type Serializable = string | IColor | (string | IColor);
+    /**
+     * Resolve a scheme key (e.g. `tx1`, `accent1`) to a color. This should consult a DocTheme if
+     * available.
+     *
+     * @remarks
+     * This is *key* resolution (key -> color), distinct from *space* resolution
+     * (color -> {@link IColor.ISpace.RGBA} via {@link IColor.toRGBA}). Returning an `IColor`
+     * (rather than a flattened RGBA) preserves the resolved color's identity — e.g. that `tx1`
+     * resolved to the system color `windowText` — which the caller can use (and then space-resolve
+     * itself).
+     */
+    type SchemeLookup = (key: IColor.Scheme) => IColor;
+    /**
+     * Resolve a system color (e.g. `windowText`, `window`, `btnFace`) to a color from the host
+     * environment.
+     *
+     * @remarks
+     * System colors are environment-dependent. A host (for example the VSCode extension)
+     * can supply this to theme the rendered grid to match its own light/dark theme. Returning
+     * `null` falls through to the color's `lastClr` (if any) and then the built-in baked value,
+     * so a missing entry is always safe. The returned color should be a concrete color (not itself
+     * a system color, to avoid re-entrancy).
+     *
+     * @param named The system color key.
+     * @param darkMode If `true` the host should return the value for its dark theme.
+     * @see
+     * {@link https://learn.microsoft.com/openspecs/office_standards/ms-oi29500 | ST_SystemColorVal}
+     */
+    type SystemLookup = (named: IColor.Named, darkMode?: boolean) => IColor | null;
+    /**
+     * Resolve an indexed (legacy palette) value to a color, or `null` to use the built-in palette.
+     * @see
+     * {@link https://github.com/closedxml/closedxml/wiki/Excel-Indexed-Colors | Excel Indexed Colors}
+     */
+    type IndexedLookup = (index: number) => IColor | null;
+    /**
+     * Named (builtin) colors defined in DrawingML aka known/system colors
+     *
+     * This enum provides a comprehensive list of named colors, including system-defined colors,
+     * standard HTML colors, and additional named colors. Each color is represented as a string
+     * corresponding to its name.
+     *
+     * @see
+     * * {@link https://msdn.microsoft.com/library/system.drawing.knowncolor.aspx | KnownColor Enumeration}
+     * * {@link https://msdn.microsoft.com/library/system.windows.media.colors.aspx | Colors Class}
+     */
+    const Named: {
+        /**
+         * The system-defined color of the active window's border.
+         */
+        readonly ActiveBorder: "activeBorder";
+        /**
+         * The system-defined color of the active window's caption.
+         */
+        readonly ActiveCaption: "activeCaption";
+        /**
+         * The system-defined color of the text in the active window's caption.
+         */
+        readonly CaptionText: "captionText";
+        /**
+         * The system-defined color of the application workspace.
+         */
+        readonly AppWorkspace: "appWorkspace";
+        /**
+         * The system-defined color of the face of a button.
+         */
+        readonly BtnFace: "btnFace";
+        /**
+         * The system-defined color of the shadow of a button.
+         */
+        readonly BtnShadow: "btnShadow";
+        /**
+         * The system-defined color of a 3D dark shadow.
+         */
+        readonly DkShadow3d: "3dDkShadow";
+        /**
+         * The system-defined color of the highlight of a button.
+         */
+        readonly BtnHighlight: "btnHighlight";
+        /**
+         * The system-defined color of a 3D light.
+         */
+        readonly Light3d: "3dLight";
+        /**
+         * The system-defined color of the text on a button.
+         */
+        readonly BtnText: "btnText";
+        /**
+         * The system-defined color of the background.
+         */
+        readonly Background: "background";
+        /**
+         * The system-defined color of gray text.
+         */
+        readonly GrayText: "grayText";
+        /**
+         * The system-defined color of the highlight.
+         */
+        readonly Highlight: "highlight";
+        /**
+         * The system-defined color of the text in the highlight.
+         */
+        readonly HighlightText: "highlightText";
+        /**
+         * The system-defined color of a hot light.
+         */
+        readonly HotLight: "hotLight";
+        /**
+         * The system-defined color of the inactive window's border.
+         */
+        readonly InactiveBorder: "inactiveBorder";
+        /**
+         * The system-defined color of the inactive window's caption.
+         */
+        readonly InactiveCaption: "inactiveCaption";
+        /**
+         * The system-defined color of the text in the inactive window's caption.
+         */
+        readonly InactiveCaptionText: "inactiveCaptionText";
+        /**
+         * The system-defined color of the background of an information tooltip.
+         */
+        readonly InfoBk: "infoBk";
+        /**
+         * The system-defined color of the text in an information tooltip.
+         */
+        readonly InfoText: "infoText";
+        /**
+         * The system-defined color of a menu.
+         */
+        readonly Menu: "menu";
+        /**
+         * The system-defined color of the text in a menu.
+         */
+        readonly MenuText: "menuText";
+        /**
+         * The system-defined color of a scroll bar.
+         */
+        readonly ScrollBar: "scrollBar";
+        /**
+         * The system-defined color of a window.
+         */
+        readonly Window: "window";
+        /**
+         * The system-defined color of a window frame.
+         */
+        readonly WindowFrame: "windowFrame";
+        /**
+         * The system-defined color of the text in a window.
+         */
+        readonly WindowText: "windowText";
+        /**
+         * The system-defined color of transparency.
+         */
+        readonly Transparent: "transparent";
+        /**
+         * The color AliceBlue.
+         */
+        readonly AliceBlue: "aliceBlue";
+        /**
+         * The color AntiqueWhite.
+         */
+        readonly AntiqueWhite: "antiqueWhite";
+        /**
+         * The color Aqua.
+         */
+        readonly Aqua: "aqua";
+        /**
+         * The color Aquamarine.
+         */
+        readonly Aquamarine: "aquamarine";
+        /**
+         * The color Azure.
+         */
+        readonly Azure: "azure";
+        /**
+         * The color Beige.
+         */
+        readonly Beige: "beige";
+        /**
+         * The color Bisque.
+         */
+        readonly Bisque: "bisque";
+        /**
+         * The color Black.
+         */
+        readonly Black: "black";
+        /**
+         * The color BlanchedAlmond.
+         */
+        readonly BlanchedAlmond: "blanchedAlmond";
+        /**
+         * The color Blue.
+         */
+        readonly Blue: "blue";
+        /**
+         * The color BlueViolet.
+         */
+        readonly BlueViolet: "blueViolet";
+        /**
+         * The color Brown.
+         */
+        readonly Brown: "brown";
+        /**
+         * The color BurlyWood.
+         */
+        readonly BurlyWood: "burlyWood";
+        /**
+         * The color CadetBlue.
+         */
+        readonly CadetBlue: "cadetBlue";
+        /**
+         * The color Chartreuse.
+         */
+        readonly Chartreuse: "chartreuse";
+        /**
+         * The color Chocolate.
+         */
+        readonly Chocolate: "chocolate";
+        /**
+         * The color Coral.
+         */
+        readonly Coral: "coral";
+        /**
+         * The color CornflowerBlue.
+         */
+        readonly CornflowerBlue: "cornflowerBlue";
+        /**
+         * The color Cornsilk.
+         */
+        readonly Cornsilk: "cornsilk";
+        /**
+         * The color Crimson.
+         */
+        readonly Crimson: "crimson";
+        /**
+         * The color Cyan.
+         */
+        readonly Cyan: "cyan";
+        /**
+         * The color DarkBlue.
+         */
+        readonly DkBlue: "dkBlue";
+        /**
+         * The color DarkCyan.
+         */
+        readonly DkCyan: "dkCyan";
+        /**
+         * The color DarkGoldenrod.
+         */
+        readonly DkGoldenrod: "dkGoldenrod";
+        /**
+         * The color DarkGray.
+         */
+        readonly DkGray: "dkGray";
+        /**
+         * The color DarkGreen.
+         */
+        readonly DkGreen: "dkGreen";
+        /**
+         * The color DarkKhaki.
+         */
+        readonly DkKhaki: "dkKhaki";
+        /**
+         * The color DarkMagenta.
+         */
+        readonly DkMagenta: "dkMagenta";
+        /**
+         * The color DarkOliveGreen.
+         */
+        readonly DkOliveGreen: "dkOliveGreen";
+        /**
+         * The color DarkOrange.
+         */
+        readonly DkOrange: "dkOrange";
+        /**
+         * The color DarkOrchid.
+         */
+        readonly DkOrchid: "dkOrchid";
+        /**
+         * The color DarkRed.
+         */
+        readonly DkRed: "dkRed";
+        /**
+         * The color DarkSalmon.
+         */
+        readonly DkSalmon: "dkSalmon";
+        /**
+         * The color DarkSeaGreen.
+         */
+        readonly DkSeaGreen: "dkSeaGreen";
+        /**
+         * The color DarkSlateBlue.
+         */
+        readonly DkSlateBlue: "dkSlateBlue";
+        /**
+         * The color DarkSlateGray.
+         */
+        readonly DkSlateGray: "dkSlateGray";
+        /**
+         * The color DarkTurquoise.
+         */
+        readonly DkTurquoise: "dkTurquoise";
+        /**
+         * The color DarkViolet.
+         */
+        readonly DkViolet: "dkViolet";
+        /**
+         * The color DeepPink.
+         */
+        readonly DeepPink: "deepPink";
+        /**
+         * The color DeepSkyBlue.
+         */
+        readonly DeepSkyBlue: "deepSkyBlue";
+        /**
+         * The color DimGray.
+         */
+        readonly DimGray: "dimGray";
+        /**
+         * The color DodgerBlue.
+         */
+        readonly DodgerBlue: "dodgerBlue";
+        /**
+         * The color Firebrick.
+         */
+        readonly Firebrick: "firebrick";
+        /**
+         * The color FloralWhite.
+         */
+        readonly FloralWhite: "floralWhite";
+        /**
+         * The color ForestGreen.
+         */
+        readonly ForestGreen: "forestGreen";
+        /**
+         * The color Fuchsia.
+         */
+        readonly Fuchsia: "fuchsia";
+        /**
+         * The color Gainsboro.
+         */
+        readonly Gainsboro: "gainsboro";
+        /**
+         * The color GhostWhite.
+         */
+        readonly GhostWhite: "ghostWhite";
+        /**
+         * The color Gold.
+         */
+        readonly Gold: "gold";
+        /**
+         * The color Goldenrod.
+         */
+        readonly Goldenrod: "goldenrod";
+        /**
+         * The color Gray.
+         */
+        readonly Gray: "gray";
+        /**
+         * The color Grey.
+         */
+        readonly Grey: "grey";
+        /**
+         * The color Green.
+         */
+        readonly Green: "green";
+        /**
+         * The color GreenYellow.
+         */
+        readonly GreenYellow: "greenYellow";
+        /**
+         * The color Honeydew.
+         */
+        readonly Honeydew: "honeydew";
+        /**
+         * The color HotPink.
+         */
+        readonly HotPink: "hotPink";
+        /**
+         * The color IndianRed.
+         */
+        readonly IndianRed: "indianRed";
+        /**
+         * The color Indigo.
+         */
+        readonly Indigo: "indigo";
+        /**
+         * The color Ivory.
+         */
+        readonly Ivory: "ivory";
+        /**
+         * The color Khaki.
+         */
+        readonly Khaki: "khaki";
+        /**
+         * The color Lavender.
+         */
+        readonly Lavender: "lavender";
+        /**
+         * The color LavenderBlush.
+         */
+        readonly LavenderBlush: "lavenderBlush";
+        /**
+         * The color LawnGreen.
+         */
+        readonly LawnGreen: "lawnGreen";
+        /**
+         * The color LemonChiffon.
+         */
+        readonly LemonChiffon: "lemonChiffon";
+        /**
+         * The color LightBlue.
+         */
+        readonly LtBlue: "ltBlue";
+        /**
+         * The color LightCoral.
+         */
+        readonly LtCoral: "ltCoral";
+        /**
+         * The color LightCyan.
+         */
+        readonly LtCyan: "ltCyan";
+        /**
+         * The color LightGoldenrodYellow.
+         */
+        readonly LtGoldenrodYellow: "ltGoldenrodYellow";
+        /**
+         * The color LightGray.
+         */
+        readonly LtGray: "ltGray";
+        /**
+         * The color LightGreen.
+         */
+        readonly LtGreen: "ltGreen";
+        /**
+         * The color LightPink.
+         */
+        readonly LtPink: "ltPink";
+        /**
+         * The color LightSalmon.
+         */
+        readonly LtSalmon: "ltSalmon";
+        /**
+         * The color LightSeaGreen.
+         */
+        readonly LtSeaGreen: "ltSeaGreen";
+        /**
+         * The color LightSkyBlue.
+         */
+        readonly LtSkyBlue: "ltSkyBlue";
+        /**
+         * The color LightSlateGray.
+         */
+        readonly LtSlateGray: "ltSlateGray";
+        /**
+         * The color LightSteelBlue.
+         */
+        readonly LtSteelBlue: "ltSteelBlue";
+        /**
+         * The color LightYellow.
+         */
+        readonly LtYellow: "ltYellow";
+        /**
+         * The color Lime.
+         */
+        readonly Lime: "lime";
+        /**
+         * The color LimeGreen.
+         */
+        readonly LimeGreen: "limeGreen";
+        /**
+         * The color Linen.
+         */
+        readonly Linen: "linen";
+        /**
+         * The color Magenta.
+         */
+        readonly Magenta: "magenta";
+        /**
+         * The color Maroon.
+         */
+        readonly Maroon: "maroon";
+        /**
+         * The color MediumAquamarine.
+         */
+        readonly MedAquamarine: "medAquamarine";
+        /**
+         * The color MediumBlue.
+         */
+        readonly MedBlue: "medBlue";
+        /**
+         * The color MediumOrchid.
+         */
+        readonly MedOrchid: "medOrchid";
+        /**
+         * The color MediumPurple.
+         */
+        readonly MedPurple: "medPurple";
+        /**
+         * The color MediumSeaGreen.
+         */
+        readonly MedSeaGreen: "medSeaGreen";
+        /**
+         * The color MediumSlateBlue.
+         */
+        readonly MedSlateBlue: "medSlateBlue";
+        /**
+         * The color MediumSpringGreen.
+         */
+        readonly MedSpringGreen: "medSpringGreen";
+        /**
+         * The color MediumTurquoise.
+         */
+        readonly MedTurquoise: "medTurquoise";
+        /**
+         * The color MediumVioletRed.
+         */
+        readonly MedVioletRed: "medVioletRed";
+        /**
+         * The color MidnightBlue.
+         */
+        readonly MidnightBlue: "midnightBlue";
+        /**
+         * The color MintCream.
+         */
+        readonly MintCream: "mintCream";
+        /**
+         * The color MistyRose.
+         */
+        readonly MistyRose: "mistyRose";
+        /**
+         * The color Moccasin.
+         */
+        readonly Moccasin: "moccasin";
+        /**
+         * The color NavajoWhite.
+         */
+        readonly NavajoWhite: "navajoWhite";
+        /**
+         * The color Navy.
+         */
+        readonly Navy: "navy";
+        /**
+         * The color OldLace.
+         */
+        readonly OldLace: "oldLace";
+        /**
+         * The color Olive.
+         */
+        readonly Olive: "olive";
+        /**
+         * The color OliveDrab.
+         */
+        readonly OliveDrab: "oliveDrab";
+        /**
+         * The color Orange.
+         */
+        readonly Orange: "orange";
+        /**
+         * The color OrangeRed.
+         */
+        readonly OrangeRed: "orangeRed";
+        /**
+         * The color Orchid.
+         */
+        readonly Orchid: "orchid";
+        /**
+         * The color PaleGoldenrod.
+         */
+        readonly PaleGoldenrod: "paleGoldenrod";
+        /**
+         * The color PaleGreen.
+         */
+        readonly PaleGreen: "paleGreen";
+        /**
+         * The color PaleTurquoise.
+         */
+        readonly PaleTurquoise: "paleTurquoise";
+        /**
+         * The color PaleVioletRed.
+         */
+        readonly PaleVioletRed: "paleVioletRed";
+        /**
+         * The color PapayaWhip.
+         */
+        readonly PapayaWhip: "papayaWhip";
+        /**
+         * The color PeachPuff.
+         */
+        readonly PeachPuff: "peachPuff";
+        /**
+         * The color Peru.
+         */
+        readonly Peru: "peru";
+        /**
+         * The color Pink.
+         */
+        readonly Pink: "pink";
+        /**
+         * The color Plum.
+         */
+        readonly Plum: "plum";
+        /**
+         * The color PowderBlue.
+         */
+        readonly PowderBlue: "powderBlue";
+        /**
+         * The color Purple.
+         */
+        readonly Purple: "purple";
+        /**
+         * The color Red.
+         */
+        readonly Red: "red";
+        /**
+         * The color RosyBrown.
+         */
+        readonly RosyBrown: "rosyBrown";
+        /**
+         * The color RoyalBlue.
+         */
+        readonly RoyalBlue: "royalBlue";
+        /**
+         * The color SaddleBrown.
+         */
+        readonly SaddleBrown: "saddleBrown";
+        /**
+         * The color Salmon.
+         */
+        readonly Salmon: "salmon";
+        /**
+         * The color SandyBrown.
+         */
+        readonly SandyBrown: "sandyBrown";
+        /**
+         * The color SeaGreen.
+         */
+        readonly SeaGreen: "seaGreen";
+        /**
+         * The color SeaShell.
+         */
+        readonly SeaShell: "seaShell";
+        /**
+         * The color Sienna.
+         */
+        readonly Sienna: "sienna";
+        /**
+         * The color Silver.
+         */
+        readonly Silver: "silver";
+        /**
+         * The color SkyBlue.
+         */
+        readonly SkyBlue: "skyBlue";
+        /**
+         * The color SlateBlue.
+         */
+        readonly SlateBlue: "slateBlue";
+        /**
+         * The color SlateGray.
+         */
+        readonly SlateGray: "slateGray";
+        /**
+         * The color Snow.
+         */
+        readonly Snow: "snow";
+        /**
+         * The color SpringGreen.
+         */
+        readonly SpringGreen: "springGreen";
+        /**
+         * The color SteelBlue.
+         */
+        readonly SteelBlue: "steelBlue";
+        /**
+         * The color Tan.
+         */
+        readonly Tan: "tan";
+        /**
+         * The color Teal.
+         */
+        readonly Teal: "teal";
+        /**
+         * The color Thistle.
+         */
+        readonly Thistle: "thistle";
+        /**
+         * The color Tomato.
+         */
+        readonly Tomato: "tomato";
+        /**
+         * The color Turquoise.
+         */
+        readonly Turquoise: "turquoise";
+        /**
+         * The color Violet.
+         */
+        readonly Violet: "violet";
+        /**
+         * The color Wheat.
+         */
+        readonly Wheat: "wheat";
+        /**
+         * The color White.
+         */
+        readonly White: "white";
+        /**
+         * The color WhiteSmoke.
+         */
+        readonly WhiteSmoke: "whiteSmoke";
+        /**
+         * The color Yellow.
+         */
+        readonly Yellow: "yellow";
+        /**
+         * The color YellowGreen.
+         */
+        readonly YellowGreen: "yellowGreen";
+        /**
+         * The system-defined color of the face of a button.
+         */
+        readonly ButtonFace: "buttonFace";
+        /**
+         * The system-defined color of the highlight of a button.
+         */
+        readonly ButtonHighlight: "buttonHighlight";
+        /**
+         * The system-defined color of the shadow of a button.
+         */
+        readonly ButtonShadow: "buttonShadow";
+        /**
+         * The system-defined color of the gradient active caption.
+         */
+        readonly GradientActiveCaption: "gradientActiveCaption";
+        /**
+         * The system-defined color of the gradient inactive caption.
+         */
+        readonly GradientInactiveCaption: "gradientInactiveCaption";
+        /**
+         * The system-defined color of the menu bar.
+         */
+        readonly MenuBar: "menuBar";
+        /**
+         * The system-defined color of the menu highlight.
+         */
+        readonly MenuHighlight: "menuHighlight";
+    };
+    type Named = typeof Named[keyof typeof Named];
+    /**
+     * Represents predefined colors from a color scheme, used in document themes.
+     */
+    const Scheme: {
+        /**
+         * Background color 1.
+         */
+        readonly Bg1: "bg1";
+        /**
+         * Background color 2.
+         */
+        readonly Bg2: "bg2";
+        /**
+         * Text color 1.
+         */
+        readonly Tx1: "tx1";
+        /**
+         * Text color 2.
+         */
+        readonly Tx2: "tx2";
+        /**
+         * Accent color 1.
+         */
+        readonly Accent1: "accent1";
+        /**
+         * Accent color 2.
+         */
+        readonly Accent2: "accent2";
+        /**
+         * Accent color 3.
+         */
+        readonly Accent3: "accent3";
+        /**
+         * Accent color 4.
+         */
+        readonly Accent4: "accent4";
+        /**
+         * Accent color 5.
+         */
+        readonly Accent5: "accent5";
+        /**
+         * Accent color 6.
+         */
+        readonly Accent6: "accent6";
+        /**
+         * Hyperlink color.
+         */
+        readonly Hlink: "hlink";
+        /**
+         * Followed hyperlink color.
+         */
+        readonly FolHlink: "folHlink";
+    };
+    type Scheme = typeof Scheme[keyof typeof Scheme];
+    /**
+     * Indicates the Color Type used.
+     */
+    const Type: {
+        readonly Scheme: "scheme";
+        readonly Named: "named";
+        readonly Index: "index";
+        /**
+         * The automatic color (Excel `auto="1"`, indexed 64). Resolves to the system `windowText`
+         * color (via {@link IColor.SystemLookup}) and round-trips back to `auto="1"`.
+         */
+        readonly Auto: "auto";
+        readonly HSL: "hsl";
+        readonly RGB: "rgb";
+        readonly LRGB: "lrgb";
+        readonly Hex: "hex";
+    };
+    type Type = typeof Type[keyof typeof Type];
+}
+//# sourceMappingURL=IColor.d.ts.map