lucid-extension-sdk 0.0.120 → 0.0.122

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "lucid-extension-sdk",
-    "version": "0.0.120",
+    "version": "0.0.122",
     "description": "Utility classes for writing Lucid Software editor extensions",
     "main": "sdk/index.js",
     "types": "sdk/index.d.ts",

package/sdk/commandtypes.d.ts

@@ -8,6 +8,7 @@ import { SerializedDataError } from './core/serializeddataerror';
 import { ShapeDataInheritance } from './core/shapedatainheritance';
 import { DocumentElementType } from './document/documentelement/documentelementtype';
 import { SerializedLineTextAreaPositioning } from './document/linetextareapositioning';
+import { TextStyle } from './document/text/textstyle';
 import { Box, Point } from './math';
 import { MenuLocation, MenuType } from './ui/menu';
 import { PanelLocation } from './ui/panel';
@@ -23,6 +24,7 @@ export declare const enum CommandName {
     AddLineTextArea = "alta",
     AddMenuItem = "ami",
     AddShapeData = "asd",
+    AddSpreadsheetIntegration = "asi",
     Alert = "a",
     AnimateViewport = "av",
     AwaitImport = "ai",
@@ -59,6 +61,7 @@ export declare const enum CommandName {
     GetRelativeLinePosition = "grlp",
     GetSelection = "gs",
     GetShapeData = "gsd",
+    GetTextStyle = "gts",
     HideModal = "hm",
     HidePanel = "hp",
     HookCreateItems = "hci",
@@ -96,6 +99,7 @@ export declare const enum CommandName {
     SetReferenceKey = "srk",
     SetShapeData = "ssd",
     SetText = "st",
+    SetTextStyle = "sts",
     ShowModal = "sm",
     ShowPanel = "spn",
     ShowPackageSettingsModal = "spsm",
@@ -133,6 +137,10 @@ export declare type CommandArgs = {
         query: AddShapeDataQuery;
         result: AddShapeDataResult;
     };
+    [CommandName.AddSpreadsheetIntegration]: {
+        query: AddSpreadsheetIntegrationQuery;
+        result: AddSpreadsheetIntegrationResult;
+    };
     [CommandName.Alert]: {
         query: AlertQuery;
         result: AlertResult;
@@ -277,6 +285,10 @@ export declare type CommandArgs = {
         query: GetShapeDataQuery;
         result: GetShapeDataResult;
     };
+    [CommandName.GetTextStyle]: {
+        query: GetTextStyleQuery;
+        result: GetTextStyleResult;
+    };
     [CommandName.HideModal]: {
         query: HideModalQuery;
         result: HideModalResult;
@@ -425,6 +437,10 @@ export declare type CommandArgs = {
         query: SetTextQuery;
         result: SetTextResult;
     };
+    [CommandName.SetTextStyle]: {
+        query: SetTextStyleQuery;
+        result: SetTextStyleResult;
+    };
     [CommandName.ShowModal]: {
         query: ShowModalQuery;
         result: ShowModalResult;
@@ -565,6 +581,25 @@ export declare type AddShapeDataQuery = {
     'v'?: SerializedFieldType;
 };
 export declare type AddShapeDataResult = undefined;
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare type AddSpreadsheetIntegrationQuery = {
+    /** name */
+    'n': string;
+    /** label */
+    'l': string;
+    /** iconUrl */
+    'iu': string;
+    /** getSpreadsheetToImportDetails */
+    'gd': string;
+    /** getSpreadsheetSheetIdsAndNames */
+    'gs': string;
+    /** getPreviewData */
+    'gp': string;
+    /** importSheets */
+    'i': string;
+};
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare type AddSpreadsheetIntegrationResult = undefined;
 export declare type AlertQuery = {
     /** Title; defaults to extension title */
     't'?: string | undefined;
@@ -827,6 +862,13 @@ export declare type GetShapeDataQuery = {
     'n': string;
 };
 export declare type GetShapeDataResult = SerializedFieldType | SerializedDataError;
+export declare type GetTextStyleQuery = {
+    /** ID of the element to get text style from */
+    'id': string;
+    /** Name of the text area to get text style from */
+    'n': string;
+};
+export declare type GetTextStyleResult = TextStyle;
 export declare type HideModalQuery = {
     /** Name of the modal's action for receiving events, i.e. ShowModalQuery['n'] */
     'n': string;
@@ -1063,6 +1105,15 @@ export declare type SetTextQuery = {
     'f'?: boolean | undefined;
 };
 export declare type SetTextResult = undefined;
+export declare type SetTextStyleQuery = {
+    /** ID of the element to set text style on */
+    'id': string;
+    /** Name of the text area to set text style on */
+    'n': string;
+    /** Text styles to set */
+    's': Partial<TextStyle>;
+};
+export declare type SetTextStyleResult = Promise<undefined>;
 export declare type ShowModalQuery = {
     /** Name of the modal's action for receiving events; generated automatically by Modal base class */
     'n': string;

package/sdk/commandtypes.js

@@ -8,6 +8,7 @@ exports.commandTitles = new Map([
     ["alta" /* CommandName.AddLineTextArea */, 'AddLineTextArea'],
     ["ami" /* CommandName.AddMenuItem */, 'AddMenuItem'],
     ["asd" /* CommandName.AddShapeData */, 'AddShapeData'],
+    ["asi" /* CommandName.AddSpreadsheetIntegration */, 'AddSpreadsheetIntegration'],
     ["a" /* CommandName.Alert */, 'Alert'],
     ["av" /* CommandName.AnimateViewport */, 'AnimateViewport'],
     ["ai" /* CommandName.AwaitImport */, 'AwaitImport'],
@@ -42,6 +43,7 @@ exports.commandTitles = new Map([
     ["grlp" /* CommandName.GetRelativeLinePosition */, 'GetRelativeLinePosition'],
     ["gs" /* CommandName.GetSelection */, 'GetSelection'],
     ["gsd" /* CommandName.GetShapeData */, 'GetShapeData'],
+    ["gts" /* CommandName.GetTextStyle */, 'GetTextStyle'],
     ["hm" /* CommandName.HideModal */, 'HideModal'],
     ["hp" /* CommandName.HidePanel */, 'HidePanel'],
     ["hci" /* CommandName.HookCreateItems */, 'HookCreateItems'],
@@ -77,6 +79,7 @@ exports.commandTitles = new Map([
     ["sp" /* CommandName.SetProperty */, 'SetProperty'],
     ["srk" /* CommandName.SetReferenceKey */, 'SetReferenceKey'],
     ["ssd" /* CommandName.SetShapeData */, 'SetShapeData'],
+    ["sts" /* CommandName.SetTextStyle */, 'SetTextStyle'],
     ["sm" /* CommandName.ShowModal */, 'ShowModal'],
     ["spsm" /* CommandName.ShowPackageSettingsModal */, 'ShowPackageSettingsModal'],
     ["spn" /* CommandName.ShowPanel */, 'ShowPanel'],

package/sdk/core/checks.d.ts

@@ -17,6 +17,12 @@ export declare function isNull(val: unknown): val is null;
  * @return Whether variable is undefined.
  */
 export declare function isUndefined(val: unknown): val is undefined;
+/**
+ * Returns true if the specified value is undefined.
+ * @param val Variable to test.
+ * @return Whether variable is undefined.
+ */
+export declare function isVoid(x: unknown): x is void;
 /**
  * Returns true if the specified value is defined and not null.
  * @param val Variable to test.

package/sdk/core/checks.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isInstanceOf = exports.isLiteral = exports.isPromise = exports.isUnknown = exports.isAny = exports.isEmptyOrNullishObject = exports.isTypedArray = exports.isArray = exports.isRecord = exports.isObject = exports.isFunction = exports.isInfinite = exports.isInt = exports.isNumber = exports.isBoolean = exports.isString = exports.isNullish = exports.isDefAndNotNull = exports.isUndefined = exports.isNull = exports.isDef = void 0;
+exports.isInstanceOf = exports.isLiteral = exports.isPromise = exports.isUnknown = exports.isAny = exports.isEmptyOrNullishObject = exports.isTypedArray = exports.isArray = exports.isRecord = exports.isObject = exports.isFunction = exports.isInfinite = exports.isInt = exports.isNumber = exports.isBoolean = exports.isString = exports.isNullish = exports.isDefAndNotNull = exports.isVoid = exports.isUndefined = exports.isNull = exports.isDef = void 0;
 /**
  * Returns true if the specified value is not undefined.
  *
@@ -29,6 +29,15 @@ function isUndefined(val) {
     return val === undefined;
 }
 exports.isUndefined = isUndefined;
+/**
+ * Returns true if the specified value is undefined.
+ * @param val Variable to test.
+ * @return Whether variable is undefined.
+ */
+function isVoid(x) {
+    return x === undefined;
+}
+exports.isVoid = isVoid;
 /**
  * Returns true if the specified value is defined and not null.
  * @param val Variable to test.

package/sdk/core/data/datasource/datasourcetype.d.ts

@@ -1,4 +1,4 @@
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export declare enum DataSourceType {
     GoogleSheets = 0,
     CSV = 1,

package/sdk/core/data/datasource/datasourcetype.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DataSourceType = void 0;
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 var DataSourceType;
 (function (DataSourceType) {
     DataSourceType[DataSourceType["GoogleSheets"] = 0] = "GoogleSheets";

package/sdk/core/data/datasource/metadatatypes.d.ts

@@ -1,4 +1,4 @@
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export declare enum MetadataTypes {
     Format = "Format",
     FillColor = "FillColor",

package/sdk/core/data/datasource/metadatatypes.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetadataTypes = void 0;
 // Google Sheets has both notes and comments, we store notes in the comment metadata collection. Comments are not
 // meant to be permanent in Google Sheets whereas they are in Excel, resulting in some confusion with our naming.
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 var MetadataTypes;
 (function (MetadataTypes) {
     MetadataTypes["Format"] = "Format";

package/sdk/core/data/datasource/serializeddatasourceproperties.d.ts

@@ -1,5 +1,5 @@
 import { SerializedUpstreamConfig } from './serializedupstreamconfig';
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedDataSourceProperties {
     'Name': string;
     'UpstreamConfig'?: SerializedUpstreamConfig | null | undefined;

package/sdk/core/data/datasource/serializedimporteddatasource.d.ts

@@ -1,13 +1,13 @@
 import { SerializedDataItems } from '../serializedfield/serializeddataitems';
 import { SerializedSchema } from '../serializedfield/serializedschema';
 import { SerializedDataSourceProperties } from './serializeddatasourceproperties';
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedImportedMetadataCollection {
     'Name': string;
     'Schema': SerializedSchema;
     'Items': SerializedDataItems;
 }
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedImportedCollection {
     'Name': string;
     'Schema': SerializedSchema;
@@ -19,7 +19,7 @@ export interface SerializedImportedCollection {
         [key: string]: SerializedImportedMetadataCollection;
     };
 }
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedImportedDataSource {
     'Properties': SerializedDataSourceProperties;
     'Collections': SerializedImportedCollection[];

package/sdk/core/data/datasource/serializedupstreamconfig.d.ts

@@ -1,7 +1,7 @@
 import { DataSourceType } from './datasourcetype';
 import { UpstreamPatchType } from './upstreampatchtype';
 import { UpstreamUpdateType } from './upstreamupdatetype';
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedUpstreamConfig {
     'SourceType': DataSourceType;
     'UpdateType': UpstreamUpdateType;

package/sdk/core/data/datasource/upstreampatchtype.d.ts

@@ -1,4 +1,4 @@
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export declare enum UpstreamPatchType {
     NONE = 0,
     MANUAL = 2,

package/sdk/core/data/datasource/upstreampatchtype.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpstreamPatchType = void 0;
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 var UpstreamPatchType;
 (function (UpstreamPatchType) {
     UpstreamPatchType[UpstreamPatchType["NONE"] = 0] = "NONE";

package/sdk/core/data/datasource/upstreamupdatetype.d.ts

@@ -1,4 +1,4 @@
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export declare enum UpstreamUpdateType {
     NONE = 0,
     PULL = 1,

package/sdk/core/data/datasource/upstreamupdatetype.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpstreamUpdateType = void 0;
-/** @ignore until spreadsheet integration is ready for launch */
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 var UpstreamUpdateType;
 (function (UpstreamUpdateType) {
     UpstreamUpdateType[UpstreamUpdateType["NONE"] = 0] = "NONE";

package/sdk/core/spreadsheetintegration/lucidspreadsheetintegration.d.ts

@@ -0,0 +1,20 @@
+import { CollectionProxy } from '../../data/collectionproxy';
+import { SerializedImportedDataSource } from '../data/datasource/serializedimporteddatasource';
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare enum LucidSpreadsheetIntegrationFailureType {
+    AuthorizationFailure = "AuthorizationFailure",
+    GenericFailure = "GenericFailure",
+    UserCancelled = "UserCanceled"
+}
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare const lucidSpreadsheetIntegrationFailureTypeValidator: (x: unknown) => x is LucidSpreadsheetIntegrationFailureType;
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare abstract class LucidSpreadsheetIntegration<CONFIG, SHEET> {
+    abstract name: string;
+    abstract label: string;
+    abstract iconUrl: string;
+    abstract getSpreadsheetToImportDetails: () => Promise<CONFIG | LucidSpreadsheetIntegrationFailureType>;
+    abstract getSpreadsheetSheetIdsAndNames(spreadsheetDetails: CONFIG): Promise<Map<SHEET, string> | LucidSpreadsheetIntegrationFailureType>;
+    abstract getPreviewData(spreadsheetDetails: CONFIG, sheetIdsToPreview: SHEET[]): Promise<SerializedImportedDataSource | LucidSpreadsheetIntegrationFailureType>;
+    abstract importSheets(spreadsheetDetails: CONFIG, sheetIdsToImport: SHEET[]): Promise<CollectionProxy[] | LucidSpreadsheetIntegrationFailureType>;
+}

package/sdk/core/spreadsheetintegration/lucidspreadsheetintegration.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LucidSpreadsheetIntegration = exports.lucidSpreadsheetIntegrationFailureTypeValidator = exports.LucidSpreadsheetIntegrationFailureType = void 0;
+const validators_1 = require("../validators/validators");
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+var LucidSpreadsheetIntegrationFailureType;
+(function (LucidSpreadsheetIntegrationFailureType) {
+    LucidSpreadsheetIntegrationFailureType["AuthorizationFailure"] = "AuthorizationFailure";
+    LucidSpreadsheetIntegrationFailureType["GenericFailure"] = "GenericFailure";
+    LucidSpreadsheetIntegrationFailureType["UserCancelled"] = "UserCanceled";
+})(LucidSpreadsheetIntegrationFailureType = exports.LucidSpreadsheetIntegrationFailureType || (exports.LucidSpreadsheetIntegrationFailureType = {}));
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+exports.lucidSpreadsheetIntegrationFailureTypeValidator = (0, validators_1.stringEnumValidator)(LucidSpreadsheetIntegrationFailureType);
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+class LucidSpreadsheetIntegration {
+}
+exports.LucidSpreadsheetIntegration = LucidSpreadsheetIntegration;

package/sdk/core/spreadsheetintegration/lucidspreadsheetintegrationregistry.d.ts

@@ -0,0 +1,11 @@
+import { EditorClient } from '../../editorclient';
+import { LucidSpreadsheetIntegration } from './lucidspreadsheetintegration';
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare class LucidSpreadsheetIntegrationRegistry {
+    private static nextHookId;
+    private static nextHookName;
+    /**
+     * Register a spreadsheet integration.
+     */
+    static addSpreadsheetIntegration<CONFIG, SHEET>(client: EditorClient, spreadsheetIntegration: LucidSpreadsheetIntegration<CONFIG, SHEET>): void;
+}

package/sdk/core/spreadsheetintegration/lucidspreadsheetintegrationregistry.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LucidSpreadsheetIntegrationRegistry = void 0;
+const lucidspreadsheetintegration_1 = require("./lucidspreadsheetintegration");
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+class LucidSpreadsheetIntegrationRegistry {
+    static nextHookName() {
+        return '__lucidspreadsheet__hook' + this.nextHookId++;
+    }
+    /**
+     * Register a spreadsheet integration.
+     */
+    static addSpreadsheetIntegration(client, spreadsheetIntegration) {
+        const getSpreadsheetToImportDetailsActionName = LucidSpreadsheetIntegrationRegistry.nextHookName();
+        client.registerAction(getSpreadsheetToImportDetailsActionName, async () => {
+            const result = await spreadsheetIntegration.getSpreadsheetToImportDetails();
+            return result;
+        });
+        const getSpreadsheetSheetIdsAndNamesActionName = LucidSpreadsheetIntegrationRegistry.nextHookName();
+        client.registerAction(getSpreadsheetSheetIdsAndNamesActionName, async (message) => {
+            const result = await spreadsheetIntegration.getSpreadsheetSheetIdsAndNames(message['dataDetails']);
+            if ((0, lucidspreadsheetintegration_1.lucidSpreadsheetIntegrationFailureTypeValidator)(result)) {
+                return result;
+            }
+            else {
+                // Serialize the Map
+                return Array.from(result);
+            }
+        });
+        const getPreviewDataActionName = LucidSpreadsheetIntegrationRegistry.nextHookName();
+        client.registerAction(getPreviewDataActionName, async (message) => {
+            const result = await spreadsheetIntegration.getPreviewData(message['dataDetails'], message['sheetIds']);
+            return result;
+        });
+        const importSheetsActionName = LucidSpreadsheetIntegrationRegistry.nextHookName();
+        client.registerAction(importSheetsActionName, async (message) => {
+            const result = await spreadsheetIntegration.importSheets(message['dataDetails'], message['sheetIds']);
+            return result;
+        });
+        const serialized = {
+            'n': spreadsheetIntegration.name,
+            'l': spreadsheetIntegration.label,
+            'iu': spreadsheetIntegration.iconUrl,
+            'gd': getSpreadsheetToImportDetailsActionName,
+            'gs': getSpreadsheetSheetIdsAndNamesActionName,
+            'gp': getPreviewDataActionName,
+            'i': importSheetsActionName,
+        };
+        client.sendCommand("asi" /* CommandName.AddSpreadsheetIntegration */, serialized);
+    }
+}
+exports.LucidSpreadsheetIntegrationRegistry = LucidSpreadsheetIntegrationRegistry;
+LucidSpreadsheetIntegrationRegistry.nextHookId = 0;

package/sdk/core/validators/validators.d.ts

@@ -69,6 +69,14 @@ export declare function mapValidator<T>(subValidator: (p1: unknown) => p1 is T):
 export declare function objectValidator<T extends {
     [key: string]: (p1: unknown) => p1 is unknown;
 }>(validatorStructure: T): (subject: unknown) => subject is DestructureGuardedTypeObj<T>;
+/**
+ * Creates a validator which tests if the target is an object
+ * and if the structure of the object matches the structure of the passed-in
+ * validator object, but with every entry being optional.
+ */
+export declare function partialObjectValidator<T extends {
+    [key: string]: (p1: unknown) => p1 is unknown;
+}>(validatorStructure: T): (subject: unknown) => subject is Partial<DestructureGuardedTypeObj<T>>;
 /**
  * Similar to {@link objectValidator}, but if the object has any non-undefined keys, they must also be present in the validator structure.
  * This is useful for things where extra data is unwanted, like Property serialization.

package/sdk/core/validators/validators.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.asAssertion = exports.validatorWithMessage = exports.minLengthValidator = exports.maxLengthValidator = exports.isDate = exports.isPositiveNumber = exports.isSize = exports.isPanelSize = exports.isBoundingBox = exports.isPointLike = exports.isOpacity = exports.isTrue = exports.isFlag = exports.isRestrictions = exports.isStringOrNegativeOne = exports.isBooleanOrEmptyString = exports.isNumberOrEmptyString = exports.isSet = exports.propertyValidator = exports.exclude = exports.both = exports.either = exports.isNullOption = exports.nullableOption = exports.option = exports.nullable = exports.objectOfValidator = exports.recordValidator = exports.strictObjectValidator = exports.objectValidator = exports.mapValidator = exports.someValidator = exports.someValue = exports.tupleValidator = exports.arrayValidator = exports.rangeValidator = exports.enumValidator = exports.stringEnumValidator = void 0;
+exports.asAssertion = exports.validatorWithMessage = exports.minLengthValidator = exports.maxLengthValidator = exports.isDate = exports.isPositiveNumber = exports.isSize = exports.isPanelSize = exports.isBoundingBox = exports.isPointLike = exports.isOpacity = exports.isTrue = exports.isFlag = exports.isRestrictions = exports.isStringOrNegativeOne = exports.isBooleanOrEmptyString = exports.isNumberOrEmptyString = exports.isSet = exports.propertyValidator = exports.exclude = exports.both = exports.either = exports.isNullOption = exports.nullableOption = exports.option = exports.nullable = exports.objectOfValidator = exports.recordValidator = exports.strictObjectValidator = exports.partialObjectValidator = exports.objectValidator = exports.mapValidator = exports.someValidator = exports.someValue = exports.tupleValidator = exports.arrayValidator = exports.rangeValidator = exports.enumValidator = exports.stringEnumValidator = void 0;
 const checks_1 = require("../checks");
 const object_1 = require("../object");
 /*********************************************************************************
@@ -145,6 +145,24 @@ function objectValidator(validatorStructure) {
     };
 }
 exports.objectValidator = objectValidator;
+/**
+ * Creates a validator which tests if the target is an object
+ * and if the structure of the object matches the structure of the passed-in
+ * validator object, but with every entry being optional.
+ */
+function partialObjectValidator(validatorStructure) {
+    return (subject) => {
+        if ((0, checks_1.isArray)(subject) || !(0, checks_1.isObject)(subject)) {
+            return false;
+        }
+        else {
+            return (0, object_1.objectEvery)(validatorStructure, (validator, key) => {
+                return subject[key] === undefined || validator(subject[key]);
+            });
+        }
+    };
+}
+exports.partialObjectValidator = partialObjectValidator;
 /**
  * Similar to {@link objectValidator}, but if the object has any non-undefined keys, they must also be present in the validator structure.
  * This is useful for things where extra data is unwanted, like Property serialization.

package/sdk/document/itemproxy.d.ts

@@ -3,6 +3,7 @@ import { EditorClient } from '../editorclient';
 import { Box, Point } from '../math';
 import { ElementProxy } from './elementproxy';
 import { WriteableMapProxy } from './mapproxy';
+import { TextStyle } from './text/textstyle';
 /**
  * A block, line, or group on a page of the current document.
  */
@@ -16,7 +17,11 @@ export declare class ItemProxy extends ElementProxy {
     /**
      * The plain text in each of the text areas on this item, organized by text area name.
      */
-    readonly textAreas: WriteableMapProxy<string, string>;
+    readonly textAreas: WriteableMapProxy<string, string, undefined, string>;
+    /**
+     * The text style in each of the text areas on this item, organized by text area name.
+     */
+    readonly textStyles: WriteableMapProxy<string, TextStyle, Promise<undefined>, Partial<TextStyle>>;
     /**
      * @returns The bounding box of this item relative to its containing page. As pages may change size
      * to fit the content on them, note that these coordinates may be negative or very large.

package/sdk/document/itemproxy.js

@@ -27,6 +27,17 @@ class ItemProxy extends elementproxy_1.ElementProxy {
             't': plainText,
             'f': options === null || options === void 0 ? void 0 : options.force,
         }));
+        /**
+         * The text style in each of the text areas on this item, organized by text area name.
+         */
+        this.textStyles = new mapproxy_1.WriteableMapProxy(() => this.textAreas.keys(), (name) => this.client.sendCommand("gts" /* CommandName.GetTextStyle */, {
+            'id': this.id,
+            'n': name,
+        }), (name, style) => this.client.sendCommand("sts" /* CommandName.SetTextStyle */, {
+            'id': this.id,
+            'n': name,
+            's': style,
+        }));
     }
     /**
      * @returns The bounding box of this item relative to its containing page. As pages may change size

package/sdk/document/mapproxy.d.ts

@@ -15,10 +15,10 @@ export declare class MapProxy<KEY, VALUE> {
     get(key: KEY): VALUE;
     first(): VALUE | undefined;
 }
-export declare class WriteableMapProxy<KEY, VALUE> extends MapProxy<KEY, VALUE> {
+export declare class WriteableMapProxy<KEY, VALUE, WRITERETURN, WRITEVALUE = VALUE> extends MapProxy<KEY, VALUE> {
     private readonly setter;
-    constructor(getKeys: () => KEY[], getItem: (key: KEY) => VALUE, setter: (key: KEY, val: VALUE, options?: SetterOptions) => void);
-    set(key: KEY, value: VALUE, options?: SetterOptions): void;
+    constructor(getKeys: () => KEY[], getItem: (key: KEY) => VALUE, setter: (key: KEY, val: WRITEVALUE, options?: SetterOptions) => WRITERETURN);
+    set(key: KEY, value: WRITEVALUE, options?: SetterOptions): WRITERETURN;
 }
 export interface SetterOptions {
     force?: boolean;

package/sdk/document/mapproxy.js

@@ -59,7 +59,7 @@ class WriteableMapProxy extends MapProxy {
         this.setter = setter;
     }
     set(key, value, options = {}) {
-        this.setter(key, value, options);
+        return this.setter(key, value, options);
     }
 }
 exports.WriteableMapProxy = WriteableMapProxy;

package/sdk/document/propertystoreproxy.d.ts

@@ -11,7 +11,7 @@ export declare class PropertyStoreProxy {
      * Not all properties are writeable (e.g. "ClassName" on a block).
      * To move or resize elements, use setLocation() or setBoundingBox() or offset() instead.
      */
-    readonly properties: WriteableMapProxy<string, import("..").JsonSerializable>;
+    readonly properties: WriteableMapProxy<string, import("..").JsonSerializable, void, import("..").JsonSerializable>;
     /**
      *
      * @param id ID of this element, or undefined for the document itself

package/sdk/document/shapedataproxy.d.ts

@@ -6,7 +6,7 @@ import { WriteableMapProxy } from './mapproxy';
 /**
  * The shape data fields on a single element of the current document
  */
-export declare class ShapeDataProxy extends WriteableMapProxy<string, SerializedFieldType | SerializedDataError> {
+export declare class ShapeDataProxy extends WriteableMapProxy<string, SerializedFieldType | SerializedDataError, void> {
     readonly id: string | undefined;
     protected readonly client: EditorClient;
     /**

package/sdk/document/text/textstyle.d.ts

@@ -0,0 +1,28 @@
+import { isBoolean, isNumber, isString } from '../../core/checks';
+/**
+ * Text styles that can be read and written with ItemProxy.textStyles.
+ */
+export declare enum TextMarkupNames {
+    Family = "font",
+    Bold = "bold",
+    Italic = "italic",
+    Underline = "underline",
+    Size = "size",
+    Color = "color"
+}
+export interface TextStyle {
+    [TextMarkupNames.Family]: string;
+    [TextMarkupNames.Bold]: boolean;
+    [TextMarkupNames.Italic]: boolean;
+    [TextMarkupNames.Underline]: boolean;
+    [TextMarkupNames.Size]: number;
+    [TextMarkupNames.Color]: string;
+}
+export declare const isPartialTextStyle: (subject: unknown) => subject is Partial<import("../..").DestructureGuardedTypeObj<{
+    font: typeof isString;
+    bold: typeof isBoolean;
+    italic: typeof isBoolean;
+    underline: typeof isBoolean;
+    size: typeof isNumber;
+    color: typeof isString;
+}>>;

package/sdk/document/text/textstyle.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPartialTextStyle = exports.TextMarkupNames = void 0;
+const checks_1 = require("../../core/checks");
+const validators_1 = require("../../core/validators/validators");
+/**
+ * Text styles that can be read and written with ItemProxy.textStyles.
+ */
+var TextMarkupNames;
+(function (TextMarkupNames) {
+    TextMarkupNames["Family"] = "font";
+    TextMarkupNames["Bold"] = "bold";
+    TextMarkupNames["Italic"] = "italic";
+    TextMarkupNames["Underline"] = "underline";
+    TextMarkupNames["Size"] = "size";
+    TextMarkupNames["Color"] = "color";
+})(TextMarkupNames = exports.TextMarkupNames || (exports.TextMarkupNames = {}));
+exports.isPartialTextStyle = (0, validators_1.partialObjectValidator)({
+    [TextMarkupNames.Family]: checks_1.isString,
+    [TextMarkupNames.Bold]: checks_1.isBoolean,
+    [TextMarkupNames.Italic]: checks_1.isBoolean,
+    [TextMarkupNames.Underline]: checks_1.isBoolean,
+    [TextMarkupNames.Size]: checks_1.isNumber,
+    [TextMarkupNames.Color]: checks_1.isString,
+});

package/sdk/index.d.ts

@@ -43,6 +43,8 @@ export * from './core/properties/fillcolor';
 export * from './core/properties/shadow';
 export * from './core/serializeddataerror';
 export * from './core/shapedatainheritance';
+export * from './core/spreadsheetintegration/lucidspreadsheetintegration';
+export * from './core/spreadsheetintegration/lucidspreadsheetintegrationregistry';
 export * from './core/unfurl/unfurlcallbacks';
 export * from './core/unfurl/unfurldetails';
 export * from './core/unfurl/unfurliframe';
@@ -87,6 +89,7 @@ export * from './document/pagedefinition';
 export * from './document/pageproxy';
 export * from './document/propertystoreproxy';
 export * from './document/shapedataproxy';
+export * from './document/text/textstyle';
 export * from './editorclient';
 export * from './index';
 export * from './math';

package/sdk/index.js

@@ -59,6 +59,8 @@ __exportStar(require("./core/properties/fillcolor"), exports);
 __exportStar(require("./core/properties/shadow"), exports);
 __exportStar(require("./core/serializeddataerror"), exports);
 __exportStar(require("./core/shapedatainheritance"), exports);
+__exportStar(require("./core/spreadsheetintegration/lucidspreadsheetintegration"), exports);
+__exportStar(require("./core/spreadsheetintegration/lucidspreadsheetintegrationregistry"), exports);
 __exportStar(require("./core/unfurl/unfurlcallbacks"), exports);
 __exportStar(require("./core/unfurl/unfurldetails"), exports);
 __exportStar(require("./core/unfurl/unfurliframe"), exports);
@@ -103,6 +105,7 @@ __exportStar(require("./document/pagedefinition"), exports);
 __exportStar(require("./document/pageproxy"), exports);
 __exportStar(require("./document/propertystoreproxy"), exports);
 __exportStar(require("./document/shapedataproxy"), exports);
+__exportStar(require("./document/text/textstyle"), exports);
 __exportStar(require("./editorclient"), exports);
 __exportStar(require("./index"), exports);
 __exportStar(require("./math"), exports);