@sheetxl/sdk 0.7.21 → 0.7.23-beta.2

package/types/src/style/IStyleCollection.d.ts

@@ -0,0 +1,292 @@
+import { IProperties } from '../type';
+import { IListener } from '../listener';
+import { IColor } from '../color';
+import { ITheme } from '../theme';
+import { ITableStyle } from '../table';
+import { IStyle } from '../style';
+/**
+ * Contains collections of Named and Table Styles.
+ */
+export interface IStyleCollection {
+    /**
+     * Returns The named style from either a custom style or a builtIn.
+     *
+     * @remarks
+     * Will try to return:
+     * 1. The custom style for the name
+     * 2. The builtin style for the name.
+     * 3. nul if it doesn't exist.
+     */
+    getNamed(name: string): IStyle.INamed | null;
+    /**
+     * Returns all customized named cell styles.
+     *
+     * @remarks
+     * This includes new style names and builtin overrides.
+     */
+    getCustomNamed(): IStyle.INamed[];
+    /**
+     * This will add or update a cell style.
+     *
+     * @param modifiers The Style or Style Modifiers
+     * @param mergeIfExists If true then the style will be merged with the existing style otherwise is a replace. @defaultValue false
+     * @returns The new style after any merges.
+     *
+     * @remarks
+     * Names are case insensitive; for duplicate detection purposes.
+     */
+    setNamed(modifiers: IStyle.NamedUpdate, mergeIfExists?: boolean): IStyle.INamed;
+    /**
+     * Returns The table style. This can be either a custom or a built in table style.
+     *
+     * @remarks
+     * Will try to return:
+     * 1. The custom style for the name
+     * 2. The builtIn style for the name.
+     * 3. `null` if it doesn't exist.
+     */
+    getTableStyle(name?: string): ITableStyle | null;
+    /**
+     * Returns all customized table styles.
+     *
+     * @remarks
+     * This includes new table styles and builtin overrides.
+     */
+    getCustomTableStyles(): ITableStyle[];
+    /**
+     * This will add or update a table style.
+  
+     * @param name A string of the name of the table.
+     * @param properties The values to set for the table style.
+     * @returns A new `ITableStyle` representing the updated style.
+     *
+     * @remarks
+     * Case insensitive; for duplicate detection purposes.
+     */
+    setCustomTableStyle(name: string, properties: ITableStyle.ResolvableProperties): ITableStyle;
+    /**
+     * Set the default table style to use if a table is created without specifying a style.
+     *
+     * @param name A string of the name of the table
+     * @remarks
+     * The style must exist or the defaultStyle will be set to 'TableStyleMedium2'.
+     */
+    setDefaultTableStyle(name: string): void;
+    /**
+     * Returns the default ITableStyle.
+     * @see
+     * {@link setDefaultTableStyle}
+     */
+    getDefaultTableStyle(): ITableStyle;
+    /**
+     * Returns the current theme
+     */
+    getTheme(): ITheme;
+    /**
+     * Set the theme used to calculate styles.
+     *
+     * @param theme The ITheme to use.
+     */
+    setTheme(theme: ITheme): void;
+    /**
+     * Themes do not contain font sizes but it is possible to set a default font size at the document or application level.
+     */
+    getDefaultFontSize(): number;
+    /**
+     * Set the default fontSize. Note - A theme does NOT contain this.
+     * @param fontSize The new default font size.
+     */
+    setDefaultFontSize(fontSize: number): void;
+    /**
+     * This is available for functions that want to resolve colors for the theme used specifically for this style.
+     */
+    schemeLookup(): IColor.SchemeLookup;
+    /**
+     * This is available for functions that want to resolve colors using the index color palette.
+     * @see
+     * {@link IColor.IndexedLookup}
+     */
+    indexedLookup(): IColor.IndexedLookup;
+    /**
+     * Parses the color using the Theme being used by this style
+     * @param str Any string that represents a color {@link IColor}.
+     */
+    parseColor(str: any): IColor;
+    /**
+     * Returns a list of colors that were added via {@link addRecentColor}.
+     */
+    recentColors(): readonly IColor[];
+    /**
+     * Add a color to the mru list. This is used to populate color pickers.
+     *
+     * @param color The color to record.
+     *
+     * @remarks
+     * Any color can be added but generally this should be limited to custom/non-themed color
+     */
+    addRecentColor(color: IColor): readonly IColor[];
+    /**
+     * Clears the mru color list
+     */
+    clearRecentColors(): void;
+    /**
+     * Returns an array of colors that will be used to resolve any colors that use IndexXX or ColorXX as a key.
+     */
+    getIndexedColors(): readonly IColor[];
+    /**
+     * Override the default indexed colors.
+     * @param colors An array of colors.
+     */
+    setCustomIndexedColors(colors: readonly IColor[]): void;
+    /**
+     * Returns the customized Indexed colors.
+     */
+    getCustomIndexedColors(): readonly IColor[];
+    /**
+     * Add Listeners.
+     *
+     * @see
+     * {@link IListener.ISource.addListeners}
+     */
+    addListeners(listeners: IStyleCollection.IListeners, options?: IListener.Options): IListener.Remove;
+    /**
+     * Converts a list of `IStyle.Modifiers` that contain shorthand values into native values.
+     *
+     * @param modifiers {@link IStyle.Modifiers}
+     * @param name Name used to normalize against. This overrides any specified in the modifiers.
+     * @returns A valid IStyle.Modifiers with values that match the normal style removed.
+     *
+     * @remarks
+     * Will also remove any value that resolve to the same values as the referenced named style (or Normal if this is not specified).
+     */
+    normalize(modifiers: IStyle.Modifiers, name?: string): Partial<IStyle.Modifiers>;
+    /**
+     * Flattens a style against the named style it references, resolving shorthand values as it goes.
+     *
+     * @param modifiers {@link IStyle.Modifiers}
+     * @param name Name used to resolve against. This overrides any specified in the modifiers.
+     * @returns A valid `IStyle.Properties` with the referenced style's values merged in.
+     *
+     * @remarks
+     * The inverse of {@link IStyleCollection.normalize}: where `normalize` reduces a style to what it
+     * authors over its named style, this restores what that authorship actually resolves to. Formats
+     * that store a style as a self-contained record rather than as a delta (OOXML `xf`) need this on
+     * the way out.
+     */
+    resolve(modifiers: IStyle.Modifiers, name?: string): Partial<IStyle.Properties>;
+    /**
+     * Convenience mechanism (and slightly faster) way to call getNamed('Normal').getRanged();
+     */
+    getNormalRanged(): IProperties.ICellRanged<IStyle.Properties>;
+    /**
+     * Return a the Normal styles as an IStyle.;
+     */
+    getNormal(): IStyle;
+    /**
+     * Checks the current name to see if this is a valid sheetName.
+     */
+    validateStyleName(name: string, checkDuplicates?: boolean): void;
+    /**
+     * Start persisting styles.
+     *
+     * * This is used during save/load to allow for styles to be references by an id count.
+     * * This is a stack so multiple begins will need to be matched with an end.
+     * @see
+     * {@link IStyleCollection.IPersistScope}
+     */
+    beginPersist(): IStyleCollection.IPersistScope;
+}
+/**
+ * {@inheritDoc IStyleCollection}
+ * @see
+ * ### **Interface**
+ *
+ * {@link IStyleCollection}
+ */
+export declare namespace IStyleCollection {
+    interface Events {
+        /**
+        * Notify that the named styled has changed
+        */
+        onNamedStylesChange?(source: IStyleCollection): void;
+        onTableStylesChange?(source: IStyleCollection): void;
+        onThemeChange?(source: IStyleCollection): void;
+        onDefaultFontChange?(source: IStyleCollection): void;
+        onAnyChange?(source: IStyleCollection): void;
+    }
+    interface IListeners extends IListener.Callbacks<IStyleCollection, IStyleCollection.Events> {
+    }
+    interface JSON {
+        /**
+         * Used by cells styles.
+         */
+        direct?: IStyle.JSON[];
+        /**
+         * cells styles with a name for quick styling.
+         */
+        named?: IStyle.NamedJSON[];
+        /**
+         * Table styles.
+         */
+        tables?: ITableStyle.JSONS;
+        /**
+         * A list of custom colors.
+         */
+        mruColors?: string[];
+        /**
+         * Overrides for indexed colors.
+         */
+        indexedColors?: string[];
+    }
+    /**
+     * A transient scope for persisting styles with a given
+     * set of StyleIDs.
+     *
+     * @remarks
+     * This is done to ensure that styles across multiple
+     * sheets are rationalized
+     */
+    interface IPersistScope {
+        /**
+         * End the persist scope. This will clear the stack and stop tracking access to this.
+         */
+        endPersist(): void;
+        /**
+         * This can be called multiple times.
+         *
+         * @returns The state as {@link IStyleCollection.JSON}.
+         *
+         * @remarks
+         * Only shared styles that have had the toResourceId called will
+         * be shown in the persisted json.
+         */
+        toJSON(): IStyleCollection.JSON;
+        /**
+         * Load a JSON for a StyleCollection object.
+         *
+         * @remarks
+         * Once this is called the getSharedStyle is available for all
+         * the ids defined in the JSON for the current scope.
+         * @param json {@link IStyleCollection.JSON}
+         */
+        fromJSON(json: IStyleCollection.JSON): void;
+        /**
+         * Given the id return the style.
+         * This assumes that the fromJSON has been called previously.
+         *
+         * @param id
+         */
+        getElementJSON(id: number): IStyle.JSON;
+        /**
+         * A 0-based style id for the given style. If this is a named style
+         * or a style that is not available with the styles then this will return null.
+         *
+         * @remarks
+         * This is a side effect operation. Calling this will cause the style to be persisted as part of the toJSON
+         *
+         * @param json
+         */
+        getElementID(json: IStyle.JSON): number | null;
+    }
+}
+//# sourceMappingURL=IStyleCollection.d.ts.map

package/types/src/style/IStyleCollection.d.ts.map

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

package/types/src/style/StyleCollection.d.ts

@@ -0,0 +1,125 @@
+import { IProperties } from '../type';
+import { IListener } from '../listener';
+import { IColor } from '../color';
+import { ITheme } from '../theme';
+import { ITableStyle } from '../table';
+import { IStyle } from './IStyle';
+import { IStyleCollection } from './IStyleCollection';
+import { ListenerEmitter } from '../listener/ListenerEmitter';
+interface PersistScopeState {
+    byJSONs: Map<string, number>;
+    byIds: Map<number, IStyle.JSON>;
+    openScopes: Set<PersistScope>;
+}
+declare class PersistScope implements IStyleCollection.IPersistScope {
+    protected _state: PersistScopeState;
+    protected _normalJSON: IStyle.JSON;
+    protected _toJSONInternal: (jsonSheetStyleShared: IStyle.JSON[]) => IStyleCollection.JSON;
+    protected _fromJSONInternal: (json: IStyleCollection.JSON) => void;
+    protected _onLastEnd: () => void;
+    protected _isClosed: boolean;
+    constructor(state: PersistScopeState, normalJSON: IStyle.JSON, toJSONInternal: (jsonSheetStyleShared: IStyle.JSON[]) => IStyleCollection.JSON, fromJSONInternal: (json: IStyleCollection.JSON) => void, onLastEnd: () => void);
+    /** {@inheritDoc IStyleCollection.IPersistScope.endPersist} */
+    endPersist(): void;
+    /** {@inheritDoc IStyleCollection.IPersistScope.getElementID} */
+    getElementID(json: IStyle.JSON): number | null;
+    /** {@inheritDoc IStyleCollection.IPersistScope.getElementJSON} */
+    getElementJSON(id: number): IStyle.JSON;
+    /** {@inheritDoc IStyleCollection.IPersistScope.fromJSON} */
+    fromJSON(json: IStyleCollection.JSON): void;
+    /** {@inheritDoc IStyleCollection.IPersistScope.toJSON} */
+    toJSON(): IStyleCollection.JSON;
+}
+/**
+ * Base implementation of {@link IStyleCollection}
+ *
+ * TODO - defaultFontSize move to theme?
+ *
+ */
+export declare class StyleCollection implements IStyleCollection {
+    protected _emitter: ListenerEmitter<IStyleCollection, IStyleCollection.IListeners>;
+    protected _theme: ITheme;
+    protected _defaultFontSize: number;
+    protected _schemeLookup: IColor.SchemeLookup;
+    protected _indexedLookup: IColor.IndexedLookup;
+    protected _builtInsCellStyles: Map<string, IStyle.INamed>;
+    protected _customCellStyles: Map<string, IStyle.INamed>;
+    protected _builtInsTableStyles: Map<string, ITableStyle>;
+    protected _customTableStyles: Map<string, ITableStyle>;
+    protected _emptyTableStyle: ITableStyle.Empty;
+    protected _customIndexedColors: readonly IColor[];
+    protected _mruColors: readonly IColor[];
+    protected _normalStyle: IStyle;
+    protected _normalRanged: IProperties.ICellRanged<IStyle.Properties>;
+    protected _defaultTableStyle: ITableStyle | null;
+    protected _persistCache: PersistScopeState | null;
+    constructor(theme?: ITheme | null, indexedColors?: string[] | null, defaultFontSize?: number);
+    protected _initializeNamedStyles(namedStyles: readonly IStyle.Properties[], builtInStyleMap: Map<string, IStyle.INamed>): void;
+    protected _initializeTableStyles(): Map<string, ITableStyle>;
+    protected _initializeBuiltIns(): void;
+    /** {@inheritDoc IStyleCollection.getNormal} */
+    getNormal(): IStyle;
+    /** {@inheritDoc IStyleCollection.getNormalRanged} */
+    getNormalRanged(): IProperties.ICellRanged<IStyle.Properties>;
+    /** {@inheritDoc IStyleCollection.setTheme} */
+    setTheme(theme: ITheme): void;
+    /** {@inheritDoc IStyleCollection.getTheme} */
+    getTheme(): ITheme;
+    /** {@inheritDoc IStyleCollection.setDefaultFontSize} */
+    setDefaultFontSize(fontSize: number): void;
+    /** {@inheritDoc IStyleCollection.getDefaultFontSize} */
+    getDefaultFontSize(): number;
+    /** {@inheritDoc IStyleCollection.beginPersist} */
+    beginPersist(): IStyleCollection.IPersistScope;
+    /** {@inheritDoc IStyleCollection.getNamed} */
+    getNamed(name: string | IStyle.BuiltInName): IStyle.INamed | null;
+    /** {@inheritDoc IStyleCollection.getCustomNamed} */
+    getCustomNamed(): IStyle.INamed[];
+    /** {@inheritDoc IStyleCollection.setNamed} */
+    setNamed(modifiers: IStyle.NamedUpdate, mergeIfExists?: boolean): IStyle.INamed;
+    protected _setCustomCellStyleInternal(modifiers: IStyle.NamedUpdate, mergeIfExists?: boolean, _i?: number | null): IStyle.INamed;
+    protected _setCustomTableStyleInternal(name: string, properties: ITableStyle.ResolvableProperties): ITableStyle;
+    protected _hideOrRemoveNamed(style: IStyle.INamed | string): boolean;
+    /** {@inheritDoc IStyleCollection.getTableStyle} */
+    getTableStyle(name: string): ITableStyle | null;
+    /** {@inheritDoc IStyleCollection.getCustomTableStyles} */
+    getCustomTableStyles(): ITableStyle[];
+    /** {@inheritDoc IStyleCollection.setDefaultTableStyle} */
+    setDefaultTableStyle(styleName: string): boolean;
+    /** {@inheritDoc IStyleCollection.getDefaultTableStyle} */
+    getDefaultTableStyle(): ITableStyle;
+    protected _deleteCustomTableStyle(styleName: string): boolean;
+    /** {@inheritDoc IStyleCollection.setCustomTableStyle} */
+    setCustomTableStyle(name: string, properties: ITableStyle.ResolvableProperties): ITableStyle;
+    /** {@inheritDoc IStyleCollection.validateStyleName} */
+    validateStyleName(name: string, checkDuplicates?: boolean): void;
+    /** {@inheritDoc IStyleCollection.normalize} */
+    normalize(values: IStyle.Modifiers, name?: string): Partial<IStyle.Properties>;
+    /** {@inheritDoc IStyleCollection.resolve} */
+    resolve(values: IStyle.Modifiers, name?: string): Partial<IStyle.Properties>;
+    /** {@inheritDoc IStyleCollection.schemeLookup} */
+    schemeLookup(): IColor.SchemeLookup;
+    /** {@inheritDoc IStyleCollection.indexedLookup} */
+    indexedLookup(): IColor.IndexedLookup;
+    /** {@inheritDoc IStyleCollection.parseColor} */
+    parseColor(str: string): IColor;
+    /** {@inheritDoc IStyleCollection.recentColors} */
+    recentColors(): readonly IColor[];
+    /** {@inheritDoc IStyleCollection.addRecentColor} */
+    addRecentColor(color: IColor): readonly IColor[];
+    /** {@inheritDoc IStyleCollection.clearRecentColors} */
+    clearRecentColors(): void;
+    /** {@inheritDoc IStyleCollection.getCustomIndexedColors} */
+    getCustomIndexedColors(): readonly IColor[];
+    /** {@inheritDoc IStyleCollection.setCustomIndexedColors} */
+    setCustomIndexedColors(colors: readonly IColor[]): void;
+    /** {@inheritDoc IStyleCollection.getIndexedColors} */
+    getIndexedColors(): readonly IColor[];
+    /** {@inheritDoc IListener.ISource.addListeners} */
+    addListeners(listeners: IStyleCollection.IListeners, options?: IListener.Options): IListener.Remove;
+    protected _toJSONInternal(jsonSheetStyleShared: IStyle.JSON[]): IStyleCollection.JSON;
+    protected _fromJSONIndexedColors(indexedColors: string[] | null | undefined): IColor[];
+    protected _fromJSONInternal(json: IStyleCollection.JSON): void;
+}
+export {};
+//# sourceMappingURL=StyleCollection.d.ts.map

package/types/src/style/StyleCollection.d.ts.map

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

package/types/src/style/_BuiltInStyleDefs.d.ts

@@ -0,0 +1,18 @@
+import { ITextFrame, IStyledFont } from '../text';
+import { IBorder } from '../border';
+import { IStyle } from './IStyle';
+import { ICellProtection } from '../cell';
+/**
+ * To avoid duplicating values.
+ */
+export declare const _EmptyFontProperties: IStyledFont.Properties;
+export declare const _EmptyBorderStrokeProperties: IBorder.StrokeProperties;
+export declare const _EmptyBorderProperties: IBorder.Properties;
+export declare const _EmptyAlignmentProperties: ITextFrame.IAlignment.Properties;
+export declare const _EmptyProtectionProperties: ICellProtection.Properties;
+/**
+ * Because all cells derived from the empty cell this is also the default values.
+ */
+export declare const _EmptyCellStyleProperties: IStyle.Properties<any>;
+export declare const _BuiltInStyleDefs: readonly IStyle.Properties[];
+//# sourceMappingURL=_BuiltInStyleDefs.d.ts.map

package/types/src/style/_BuiltInStyleDefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_BuiltInStyleDefs.d.ts","sourceRoot":"","sources":["../../../../src/style/_BuiltInStyleDefs.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,UAoB7C,CAAC;AAEH,eAAO,MAAM,4BAA4B,EAAE,OAAO,CAAC,gBAKjD,CAAC;AAEH,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,UAW3C,CAAC;AAEH,eAAO,MAAM,yBAAyB,EAAE,UAAU,CAAC,UAAU,CAAC,UAY5D,CAAC;AAGH,eAAO,MAAM,0BAA0B,EAAE,eAAe,CAAC,UAGvD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,CAW3D,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,CAAC,UAAU,EAkTtD,CAAC"}

package/types/src/style/_BuiltInStyleNames.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A localized-display descriptor for a built-in style name: a catalog message
+ * key plus optional ICU params. Resolve it at the display boundary with
+ * `t(key, params)`; the canonical {@link IStyle.BuiltInName} stays the identity.
+ */
+export interface BuiltInStyleNameDisplay {
+    key: string;
+    params?: Record<string, string | number>;
+}
+/**
+ * The localized-display descriptor for a canonical built-in style name, or
+ * `null` for a custom / non-built-in name (render its raw name unchanged).
+ *
+ * @remarks
+ * The canonical {@link IStyle.BuiltInName} remains the API/storage identity; this
+ * only maps it to a display string. Headings and accent tints compose via ICU
+ * params (`Heading {n}`, `{pct}% - Accent{n}`) so each locale ships one template.
+ */
+export declare function builtInStyleNameDisplay(name: string): BuiltInStyleNameDisplay | null;
+//# sourceMappingURL=_BuiltInStyleNames.d.ts.map

package/types/src/style/_BuiltInStyleNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_BuiltInStyleNames.d.ts","sourceRoot":"","sources":["../../../../src/style/_BuiltInStyleNames.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C;AA6CD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAcpF"}

package/types/src/style/index.d.ts

@@ -0,0 +1,5 @@
+export * from './IStyle';
+export * from './IStyleCollection';
+export * from './_BuiltInStyleNames';
+export * from './StyleCollection';
+//# sourceMappingURL=index.d.ts.map

package/types/src/style/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/style/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AAErC,cAAc,mBAAmB,CAAC"}