lucid-extension-sdk 0.0.124 → 0.0.126

package/package.json

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

package/sdk/commandtypes.d.ts

@@ -27,6 +27,7 @@ export declare const enum CommandName {
     AddSpreadsheetIntegration = "asi",
     Alert = "a",
     AnimateViewport = "av",
+    AwaitDataSourceImport = "adi",
     AwaitImport = "ai",
     Bootstrap = "b",
     CancelDragBlockToCanvas = "cdc",
@@ -149,6 +150,10 @@ export declare type CommandArgs = {
         query: AnimateViewportQuery;
         result: AnimateViewportResult;
     };
+    [CommandName.AwaitDataSourceImport]: {
+        query: AwaitDataSourceImportQuery;
+        result: AwaitDataSourceImportResult;
+    };
     [CommandName.AwaitImport]: {
         query: AwaitImportQuery;
         result: AwaitImportResult;
@@ -501,6 +506,8 @@ export declare type AddCardIntegrationQuery = {
     'isl': string;
     /** Icon url */
     'u': string;
+    /** Text style */
+    'ts'?: Partial<TextStyle> | undefined;
     /** Field configuration */
     'fc': {
         /** Callback to get field definitions for all fields supported by the card integration */
@@ -610,6 +617,14 @@ export declare type AlertQuery = {
 };
 /** True if they click OK, false otherwise */
 export declare type AlertResult = Promise<boolean>;
+export declare type AwaitDataSourceImportQuery = {
+    /** Data Connector Name */
+    'n': string;
+    /** Sync data source ID Nonce */
+    's': string;
+};
+/** Promise resolving to the data source ID where the data arrived */
+export declare type AwaitDataSourceImportResult = Promise<string>;
 export declare type AwaitImportQuery = {
     /** Data Connector Name */
     'n': string;
@@ -991,6 +1006,8 @@ export declare type RegisterPanelQuery = {
     'i': string;
     /** tooltip */
     'to'?: string;
+    /** If true, we will persist the panel's iframe */
+    'p'?: boolean;
 };
 export declare type RegisterPanelResult = undefined;
 export declare type RegisterUnfurlQuery = {

package/sdk/commandtypes.js

@@ -11,6 +11,7 @@ exports.commandTitles = new Map([
     ["asi" /* CommandName.AddSpreadsheetIntegration */, 'AddSpreadsheetIntegration'],
     ["a" /* CommandName.Alert */, 'Alert'],
     ["av" /* CommandName.AnimateViewport */, 'AnimateViewport'],
+    ["adi" /* CommandName.AwaitDataSourceImport */, 'AwaitDataSourceImport'],
     ["ai" /* CommandName.AwaitImport */, 'AwaitImport'],
     ["b" /* CommandName.Bootstrap */, 'Bootstrap'],
     ["ceps" /* CommandName.CanEditPackageSettings */, 'CanEditPackageSettings'],

package/sdk/core/cardintegration/cardintegrationconfig.d.ts

@@ -1,3 +1,4 @@
+import { TextStyle } from '../../document/text/textstyle';
 import { LucidCardFieldDisplaySettings, SerializedLucidCardFieldDisplaySettings } from './cardfielddisplaysettings';
 export interface CardIntegrationConfig {
     cardConfig: {
@@ -5,6 +6,11 @@ export interface CardIntegrationConfig {
          * The data fields to be displayed on cards, as data-linked text fields
          */
         fieldNames: string[];
+        /**
+         * The default text style to set on each of the above fields for new cards. Any style not specified
+         * will use a default value, and any field name not present will use all defaults.
+         */
+        fieldStyles?: Map<string, Partial<TextStyle>>;
         /**
          * The data fields to be displayed on cards as data graphics
          */
@@ -30,7 +36,8 @@ export interface CardIntegrationConfig {
 export declare type SerializedCardIntegrationConfig = {
     'cc': {
         'f': string[];
-        'fd'?: [string, SerializedLucidCardFieldDisplaySettings][];
+        'fd'?: [string, SerializedLucidCardFieldDisplaySettings][] | undefined;
+        'fs'?: [string, Partial<TextStyle>][] | undefined;
         'id'?: string | undefined;
     };
     'cdpc': {

package/sdk/core/cardintegration/cardintegrationconfig.js

@@ -13,6 +13,7 @@ function serializeCardIntegrationConfig(config) {
                     (0, cardfielddisplaysettings_1.serializeLucidCardFieldDisplaySettings)(settings),
                 ])
                 : undefined,
+            'fs': config.cardConfig.fieldStyles ? [...config.cardConfig.fieldStyles] : undefined,
         },
         'cdpc': {
             'f': config.cardDetailsPanelConfig.fields.map((field) => {
@@ -30,6 +31,7 @@ function deserializeCardIntegrationConfig(raw) {
     return {
         cardConfig: {
             fieldNames: raw['cc']['f'],
+            fieldStyles: raw['cc']['fs'] ? new Map(raw['cc']['fs']) : undefined,
             fieldDisplaySettings: raw['cc']['fd']
                 ? new Map(raw['cc']['fd'].map(([key, settings]) => [
                     key,

package/sdk/core/cardintegration/cardintegrationdefinitions.d.ts

@@ -1,7 +1,7 @@
 import { FieldDefinition } from '../../data/schemadefinition';
 import { isString } from '../checks';
 import { isSerializedFieldTypeDefinition } from '../data/fieldtypedefinition/fieldtypedefinition';
-import { FieldConstraintType, SerializedFieldDefinition } from '../data/serializedfield/serializedfielddefinition';
+import { SerializedFieldDefinition } from '../data/serializedfield/serializedfielddefinition';
 import { isSerializedFieldType, SerializedFieldType } from '../data/serializedfield/serializedfields';
 /** For fields with Option or ApiOption type, the label and value for each available option */
 export interface ExtensionCardFieldOption {
@@ -62,17 +62,13 @@ export declare const isSerializedFieldOptions: (p1: unknown) => p1 is import("..
     v: typeof isSerializedFieldType;
     i: (x: unknown) => x is string | undefined;
 }>[];
-export declare const isSerializedFieldConstraint: (subject: unknown) => subject is import("../guards").DestructureGuardedTypeObj<{
-    Type: (x: unknown) => x is FieldConstraintType;
-    Details: (x: unknown) => x is number | undefined;
-}>;
 /** @ignore */
 export declare const isSerializedExtensionCardFieldDefinition: (subject: unknown) => subject is import("../guards").DestructureGuardedTypeObj<{
     Name: typeof isString;
     Type: typeof isSerializedFieldTypeDefinition;
     Constraints: (x: unknown) => x is import("../guards").DestructureGuardedTypeObj<{
-        Type: (x: unknown) => x is FieldConstraintType;
-        Details: (x: unknown) => x is number | undefined;
+        Type: (x: unknown) => x is import("../data/serializedfield/serializedfielddefinition").FieldConstraintType;
+        Details: (x: unknown) => x is unknown;
     }>[] | undefined;
     l: typeof isString;
     d: (x: unknown) => x is string | undefined;

package/sdk/core/cardintegration/cardintegrationdefinitions.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deserializeCardFieldArrayDefinition = exports.deserializeCardFieldDefinition = exports.isSerializedExtensionCardFieldDefinition = exports.isSerializedFieldConstraint = exports.isSerializedFieldOptions = exports.isSerializedFieldOption = exports.deserializeFieldOption = exports.serializeCardFieldArrayDefinition = exports.serializeCardFieldDefinition = exports.serializeCardFieldOption = void 0;
+exports.deserializeCardFieldArrayDefinition = exports.deserializeCardFieldDefinition = exports.isSerializedExtensionCardFieldDefinition = exports.isSerializedFieldOptions = exports.isSerializedFieldOption = exports.deserializeFieldOption = exports.serializeCardFieldArrayDefinition = exports.serializeCardFieldDefinition = exports.serializeCardFieldOption = void 0;
 const schemadefinition_1 = require("../../data/schemadefinition");
 const checks_1 = require("../checks");
 const fieldtypedefinition_1 = require("../data/fieldtypedefinition/fieldtypedefinition");
@@ -42,15 +42,11 @@ exports.isSerializedFieldOption = (0, validators_1.objectValidator)({
     'i': (0, validators_1.option)(checks_1.isString),
 });
 exports.isSerializedFieldOptions = (0, validators_1.arrayValidator)(exports.isSerializedFieldOption);
-exports.isSerializedFieldConstraint = (0, validators_1.objectValidator)({
-    'Type': (0, validators_1.enumValidator)(serializedfielddefinition_1.FieldConstraintType),
-    'Details': (0, validators_1.option)(checks_1.isNumber),
-});
 /** @ignore */
 exports.isSerializedExtensionCardFieldDefinition = (0, validators_1.objectValidator)({
     'Name': checks_1.isString,
     'Type': fieldtypedefinition_1.isSerializedFieldTypeDefinition,
-    'Constraints': (0, validators_1.option)((0, validators_1.arrayValidator)(exports.isSerializedFieldConstraint)),
+    'Constraints': (0, validators_1.option)((0, validators_1.arrayValidator)(serializedfielddefinition_1.isSerializedFieldConstraint)),
     'l': checks_1.isString,
     'd': (0, validators_1.option)(checks_1.isString),
     'def': (0, validators_1.option)(serializedfields_1.isSerializedFieldType),

package/sdk/core/cardintegration/lucidcardintegration.d.ts

@@ -1,6 +1,7 @@
 import { CollectionDefinition } from '../../data/collectiondefinition';
 import { CollectionProxy } from '../../data/collectionproxy';
 import { DataSourceProxy } from '../../data/datasourceproxy';
+import { TextStyle } from '../../document/text/textstyle';
 import { EditorClient } from '../../editorclient';
 import { SerializedFieldType } from '../data/serializedfield/serializedfields';
 import { CardIntegrationConfig } from './cardintegrationconfig';
@@ -29,6 +30,12 @@ export declare abstract class LucidCardIntegration {
      * The name of the data connector associated with the card integration.
      */
     abstract dataConnectorName: string;
+    /**
+     * The default text style to use on cards created as part of this integration.
+     * These can be overridden by values in getDefaultConfig().fieldStyles for
+     * individual fields that should have different styles.
+     */
+    textStyle?: Partial<TextStyle>;
     abstract fieldConfiguration: {
         /**
          * Callback to provide a list of all supported field names for the card integration.

package/sdk/core/cardintegration/lucidcardintegrationregistry.js

@@ -60,6 +60,7 @@ class LucidCardIntegrationRegistry {
             'il': cardIntegration.itemLabel,
             'isl': cardIntegration.itemsLabel,
             'u': cardIntegration.iconUrl,
+            'ts': cardIntegration.textStyle,
             'fc': {
                 'gf': getFieldsActionName,
                 'osfc': onSelectedFieldsChangeActionName,

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

@@ -1,6 +1,17 @@
+import { isString } from '../../checks';
 import { SerializedUpstreamConfig } from './serializedupstreamconfig';
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedDataSourceProperties {
     'Name': string;
     'UpstreamConfig'?: SerializedUpstreamConfig | null | undefined;
 }
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare const isSerializedDataSourceProperties: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    Name: typeof isString;
+    UpstreamConfig: (x: unknown) => x is import("../../guards").DestructureGuardedTypeObj<{
+        SourceType: (x: unknown) => x is import("./datasourcetype").DataSourceType;
+        UpdateType: (x: unknown) => x is import("./upstreamupdatetype").UpstreamUpdateType;
+        PatchType: (x: unknown) => x is import("./upstreampatchtype").UpstreamPatchType | null | undefined;
+        SourceConfig: typeof import("../../checks").isObject;
+    }> | null | undefined;
+}>;

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

@@ -1,2 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSerializedDataSourceProperties = void 0;
+const checks_1 = require("../../checks");
+const validators_1 = require("../../validators/validators");
+const serializedupstreamconfig_1 = require("./serializedupstreamconfig");
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+exports.isSerializedDataSourceProperties = (0, validators_1.strictObjectValidator)({
+    'Name': checks_1.isString,
+    'UpstreamConfig': (0, validators_1.nullableOption)(serializedupstreamconfig_1.isSerializedUpstreamConfig),
+});

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

@@ -1,5 +1,6 @@
-import { SerializedDataItems } from '../serializedfield/serializeddataitems';
-import { SerializedSchema } from '../serializedfield/serializedschema';
+import { isObject, isString } from '../../checks';
+import { isSerializedDataItems, SerializedDataItems } from '../serializedfield/serializeddataitems';
+import { isSerializedSchema, SerializedSchema } from '../serializedfield/serializedschema';
 import { SerializedDataSourceProperties } from './serializeddatasourceproperties';
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedImportedMetadataCollection {
@@ -8,6 +9,12 @@ export interface SerializedImportedMetadataCollection {
     'Items': SerializedDataItems;
 }
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare const isSerializedImportedMetadataCollection: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    Name: typeof isString;
+    Schema: typeof isSerializedSchema;
+    Items: typeof isSerializedDataItems;
+}>;
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedImportedCollection {
     'Name': string;
     'Schema': SerializedSchema;
@@ -20,7 +27,42 @@ export interface SerializedImportedCollection {
     };
 }
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare const isSerializedImportedCollection: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    Name: typeof isString;
+    Schema: typeof isSerializedSchema;
+    Items: typeof isSerializedDataItems;
+    UpstreamConfig: typeof isObject;
+    Metadata: (val: unknown) => val is Record<string, import("../../guards").DestructureGuardedTypeObj<{
+        Name: typeof isString;
+        Schema: typeof isSerializedSchema;
+        Items: typeof isSerializedDataItems;
+    }>>;
+}>;
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedImportedDataSource {
     'Properties': SerializedDataSourceProperties;
     'Collections': SerializedImportedCollection[];
 }
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare const isSerializedImportedDataSource: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    Properties: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+        Name: typeof isString;
+        UpstreamConfig: (x: unknown) => x is import("../../guards").DestructureGuardedTypeObj<{
+            SourceType: (x: unknown) => x is import("./datasourcetype").DataSourceType;
+            UpdateType: (x: unknown) => x is import("./upstreamupdatetype").UpstreamUpdateType;
+            PatchType: (x: unknown) => x is import("./upstreampatchtype").UpstreamPatchType | null | undefined;
+            SourceConfig: typeof isObject;
+        }> | null | undefined;
+    }>;
+    Collections: (val: unknown) => val is import("../../guards").DestructureGuardedTypeObj<{
+        Name: typeof isString;
+        Schema: typeof isSerializedSchema;
+        Items: typeof isSerializedDataItems;
+        UpstreamConfig: typeof isObject;
+        Metadata: (val: unknown) => val is Record<string, import("../../guards").DestructureGuardedTypeObj<{
+            Name: typeof isString;
+            Schema: typeof isSerializedSchema;
+            Items: typeof isSerializedDataItems;
+        }>>;
+    }>[];
+}>;

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

@@ -1,2 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSerializedImportedDataSource = exports.isSerializedImportedCollection = exports.isSerializedImportedMetadataCollection = void 0;
+const checks_1 = require("../../checks");
+const validators_1 = require("../../validators/validators");
+const serializeddataitems_1 = require("../serializedfield/serializeddataitems");
+const serializedschema_1 = require("../serializedfield/serializedschema");
+const serializeddatasourceproperties_1 = require("./serializeddatasourceproperties");
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+exports.isSerializedImportedMetadataCollection = (0, validators_1.strictObjectValidator)({
+    'Name': checks_1.isString,
+    'Schema': serializedschema_1.isSerializedSchema,
+    'Items': serializeddataitems_1.isSerializedDataItems,
+});
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+exports.isSerializedImportedCollection = (0, validators_1.strictObjectValidator)({
+    'Name': checks_1.isString,
+    'Schema': serializedschema_1.isSerializedSchema,
+    'Items': serializeddataitems_1.isSerializedDataItems,
+    'UpstreamConfig': checks_1.isObject,
+    'Metadata': (0, checks_1.isRecord)(exports.isSerializedImportedMetadataCollection),
+});
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+exports.isSerializedImportedDataSource = (0, validators_1.strictObjectValidator)({
+    'Properties': serializeddatasourceproperties_1.isSerializedDataSourceProperties,
+    'Collections': (0, checks_1.isTypedArray)(exports.isSerializedImportedCollection),
+});

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

@@ -1,3 +1,4 @@
+import { isObject } from '../../checks';
 import { DataSourceType } from './datasourcetype';
 import { UpstreamPatchType } from './upstreampatchtype';
 import { UpstreamUpdateType } from './upstreamupdatetype';
@@ -10,3 +11,10 @@ export interface SerializedUpstreamConfig {
         [index: string]: any;
     };
 }
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare const isSerializedUpstreamConfig: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    SourceType: (x: unknown) => x is DataSourceType;
+    UpdateType: (x: unknown) => x is UpstreamUpdateType;
+    PatchType: (x: unknown) => x is UpstreamPatchType | null | undefined;
+    SourceConfig: typeof isObject;
+}>;

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

@@ -1,2 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSerializedUpstreamConfig = void 0;
+const checks_1 = require("../../checks");
+const validators_1 = require("../../validators/validators");
+const datasourcetype_1 = require("./datasourcetype");
+const upstreampatchtype_1 = require("./upstreampatchtype");
+const upstreamupdatetype_1 = require("./upstreamupdatetype");
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+exports.isSerializedUpstreamConfig = (0, validators_1.strictObjectValidator)({
+    'SourceType': (0, validators_1.enumValidator)(datasourcetype_1.DataSourceType),
+    'UpdateType': (0, validators_1.enumValidator)(upstreamupdatetype_1.UpstreamUpdateType),
+    'PatchType': (0, validators_1.nullableOption)((0, validators_1.enumValidator)(upstreampatchtype_1.UpstreamPatchType)),
+    'SourceConfig': checks_1.isObject,
+});

package/sdk/core/data/serializedfield/serializedfielddefinition.d.ts

@@ -1,13 +1,7 @@
+import { isString } from '../../checks';
 import { JsonSerializable } from '../../jsonserializable';
-import { SerializedFieldTypeDefinition } from '../fieldtypedefinition/fieldtypedefinition';
+import { isSerializedFieldTypeDefinition, SerializedFieldTypeDefinition } from '../fieldtypedefinition/fieldtypedefinition';
 import { SemanticKind } from '../fieldtypedefinition/semantickind';
-export declare type SerializedFieldDefinition = {
-    'Name': string;
-    'Type': SerializedFieldTypeDefinition;
-    'Constraints'?: SerializedFieldConstraint[] | undefined;
-    'SyncSchema'?: string | undefined;
-    'Mapping'?: readonly SemanticKind[] | undefined;
-};
 export declare enum FieldConstraintType {
     REQUIRED = "required",
     LOCKED = "locked",
@@ -21,3 +15,24 @@ export declare type SerializedFieldConstraint = {
     'Type': FieldConstraintType;
     'Details'?: JsonSerializable;
 };
+export declare const isSerializedFieldConstraint: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    Type: (x: unknown) => x is FieldConstraintType;
+    Details: (x: unknown) => x is unknown;
+}>;
+export declare type SerializedFieldDefinition = {
+    'Name': string;
+    'Type': SerializedFieldTypeDefinition;
+    'Constraints'?: SerializedFieldConstraint[] | undefined;
+    'SyncSchema'?: string | undefined;
+    'Mapping'?: readonly SemanticKind[] | undefined;
+};
+export declare const isSerializedFieldDefinition: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    Name: typeof isString;
+    Type: typeof isSerializedFieldTypeDefinition;
+    Constraints: (x: unknown) => x is import("../../guards").DestructureGuardedTypeObj<{
+        Type: (x: unknown) => x is FieldConstraintType;
+        Details: (x: unknown) => x is unknown;
+    }>[] | undefined;
+    SyncSchema: (x: unknown) => x is string | undefined;
+    Mapping: (x: unknown) => x is SemanticKind[] | undefined;
+}>;

package/sdk/core/data/serializedfield/serializedfielddefinition.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isFieldConstraintType = exports.FieldConstraintType = void 0;
+exports.isSerializedFieldDefinition = exports.isSerializedFieldConstraint = exports.isFieldConstraintType = exports.FieldConstraintType = void 0;
+const checks_1 = require("../../checks");
 const validators_1 = require("../../validators/validators");
+const fieldtypedefinition_1 = require("../fieldtypedefinition/fieldtypedefinition");
+const semantickind_1 = require("../fieldtypedefinition/semantickind");
 // The options here must match com.lucidchart.data.model.fielddefinition.FieldConstraintType on the backend
 var FieldConstraintType;
 (function (FieldConstraintType) {
@@ -13,3 +16,14 @@ var FieldConstraintType;
     FieldConstraintType["NO_WHITESPACE"] = "noWhitespace";
 })(FieldConstraintType = exports.FieldConstraintType || (exports.FieldConstraintType = {}));
 exports.isFieldConstraintType = (0, validators_1.enumValidator)(FieldConstraintType);
+exports.isSerializedFieldConstraint = (0, validators_1.objectValidator)({
+    'Type': (0, validators_1.enumValidator)(FieldConstraintType),
+    'Details': (0, validators_1.option)(checks_1.isUnknown),
+});
+exports.isSerializedFieldDefinition = (0, validators_1.strictObjectValidator)({
+    'Name': checks_1.isString,
+    'Type': fieldtypedefinition_1.isSerializedFieldTypeDefinition,
+    'Constraints': (0, validators_1.option)((0, validators_1.arrayValidator)(exports.isSerializedFieldConstraint)),
+    'SyncSchema': (0, validators_1.option)(checks_1.isString),
+    'Mapping': (0, validators_1.option)((0, validators_1.arrayValidator)((0, validators_1.stringEnumValidator)(semantickind_1.SemanticKind))),
+});

package/sdk/core/data/serializedfield/serializedschema.d.ts

@@ -7,3 +7,4 @@ export declare type SerializedSchema = {
     'PrimaryKey': string[];
     'FieldLabelOverrides'?: SerializedLabelOverrides | undefined;
 };
+export declare function isSerializedSchema(schema: any): schema is SerializedSchema;

package/sdk/core/data/serializedfield/serializedschema.js

@@ -1,2 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSerializedSchema = void 0;
+const checks_1 = require("../../checks");
+const validators_1 = require("../../validators/validators");
+const serializedfielddefinition_1 = require("./serializedfielddefinition");
+function isSerializedSchema(schema) {
+    if (schema == null) {
+        return false;
+    }
+    const fields = schema['Fields'];
+    const primaryKey = schema['PrimaryKey'];
+    const fieldLabelOverrides = schema['FieldLabelOverrides'];
+    const validOverrides = (0, checks_1.isDefAndNotNull)(fieldLabelOverrides)
+        ? (0, checks_1.isRecord)(checks_1.isString)(fieldLabelOverrides) && !(0, checks_1.isArray)(fieldLabelOverrides)
+        : true; // Optional field
+    return ((0, checks_1.isTypedArray)(serializedfielddefinition_1.isSerializedFieldDefinition)(fields) &&
+        (0, validators_1.arrayValidator)(serializedfielddefinition_1.isSerializedFieldDefinition)(fields) &&
+        (0, checks_1.isArray)(primaryKey) &&
+        primaryKey.every(checks_1.isString) &&
+        validOverrides);
+}
+exports.isSerializedSchema = isSerializedSchema;

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

@@ -1,5 +1,5 @@
-import { CollectionProxy } from '../../data/collectionproxy';
 import { SerializedImportedDataSource } from '../data/datasource/serializedimporteddatasource';
+import { JsonSerializable } from '../jsonserializable';
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export declare enum LucidSpreadsheetIntegrationFailureType {
     AuthorizationFailure = "AuthorizationFailure",
@@ -9,12 +9,16 @@ export declare enum LucidSpreadsheetIntegrationFailureType {
 /** @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> {
+export declare abstract class LucidSpreadsheetIntegration<CONFIG extends JsonSerializable, SHEET extends JsonSerializable> {
     abstract name: string;
     abstract label: string;
     abstract iconUrl: string;
-    abstract getSpreadsheetToImportDetails: () => Promise<CONFIG | LucidSpreadsheetIntegrationFailureType>;
+    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>;
+    abstract getPreviewData(spreadsheetDetails: CONFIG, sheetsToPreview: SHEET[]): Promise<SerializedImportedDataSource | LucidSpreadsheetIntegrationFailureType>;
+    abstract importSheets(spreadsheetDetails: CONFIG, sheetsToImportConfig: {
+        'sheet': SHEET;
+        'headerRowIndex': number;
+        'primaryKeys': string[];
+    }[]): Promise<string | LucidSpreadsheetIntegrationFailureType>;
 }

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

@@ -1,4 +1,5 @@
 import { EditorClient } from '../../editorclient';
+import { JsonSerializable } from '../jsonserializable';
 import { LucidSpreadsheetIntegration } from './lucidspreadsheetintegration';
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export declare class LucidSpreadsheetIntegrationRegistry {
@@ -7,5 +8,5 @@ export declare class LucidSpreadsheetIntegrationRegistry {
     /**
      * Register a spreadsheet integration.
      */
-    static addSpreadsheetIntegration<CONFIG, SHEET>(client: EditorClient, spreadsheetIntegration: LucidSpreadsheetIntegration<CONFIG, SHEET>): void;
+    static addSpreadsheetIntegration<CONFIG extends JsonSerializable, SHEET extends JsonSerializable>(client: EditorClient, spreadsheetIntegration: LucidSpreadsheetIntegration<CONFIG, SHEET>): void;
 }

package/sdk/core/spreadsheetintegration/lucidspreadsheetintegrationregistry.js

@@ -13,29 +13,42 @@ class LucidSpreadsheetIntegrationRegistry {
     static addSpreadsheetIntegration(client, spreadsheetIntegration) {
         const getSpreadsheetToImportDetailsActionName = LucidSpreadsheetIntegrationRegistry.nextHookName();
         client.registerAction(getSpreadsheetToImportDetailsActionName, async () => {
-            const result = await spreadsheetIntegration.getSpreadsheetToImportDetails();
-            return result;
+            try {
+                return await spreadsheetIntegration.getSpreadsheetToImportDetails();
+            }
+            catch (error) { }
+            return lucidspreadsheetintegration_1.LucidSpreadsheetIntegrationFailureType.GenericFailure;
         });
         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);
+            try {
+                const result = await spreadsheetIntegration.getSpreadsheetSheetIdsAndNames(message['dataDetails']);
+                if ((0, lucidspreadsheetintegration_1.lucidSpreadsheetIntegrationFailureTypeValidator)(result)) {
+                    return result;
+                }
+                else {
+                    // Serialize the Map
+                    return Array.from(result);
+                }
             }
+            catch (error) { }
+            return lucidspreadsheetintegration_1.LucidSpreadsheetIntegrationFailureType.GenericFailure;
         });
         const getPreviewDataActionName = LucidSpreadsheetIntegrationRegistry.nextHookName();
         client.registerAction(getPreviewDataActionName, async (message) => {
-            const result = await spreadsheetIntegration.getPreviewData(message['dataDetails'], message['sheetIds']);
-            return result;
+            try {
+                return await spreadsheetIntegration.getPreviewData(message['dataDetails'], message['sheets']);
+            }
+            catch (error) { }
+            return lucidspreadsheetintegration_1.LucidSpreadsheetIntegrationFailureType.GenericFailure;
         });
         const importSheetsActionName = LucidSpreadsheetIntegrationRegistry.nextHookName();
         client.registerAction(importSheetsActionName, async (message) => {
-            const result = await spreadsheetIntegration.importSheets(message['dataDetails'], message['sheetIds']);
-            return result;
+            try {
+                return await spreadsheetIntegration.importSheets(message['dataDetails'], message['sheetsToImportConfig']);
+            }
+            catch (error) { }
+            return lucidspreadsheetintegration_1.LucidSpreadsheetIntegrationFailureType.GenericFailure;
         });
         const serialized = {
             'n': spreadsheetIntegration.name,

package/sdk/editorclient.d.ts

@@ -92,6 +92,8 @@ export declare class EditorClient {
      */
     canEditPackageSettings(): Promise<boolean>;
     awaitDataImport(dataConnectorName: string, syncDataSourceId: undefined | string, syncCollectionId: string, primaryKeys: string[], timeout?: number): Promise<CollectionProxy>;
+    /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+    awaitDataSourceImport(dataConnectorName: string, syncDataSourceIdNonce: string): Promise<string>;
     /**
      * Make a network request
      * @param request Settings for the network request

package/sdk/editorclient.js

@@ -158,6 +158,13 @@ class EditorClient {
             't': timeout,
         }), this);
     }
+    /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+    async awaitDataSourceImport(dataConnectorName, syncDataSourceIdNonce) {
+        return await this.sendCommand("adi" /* CommandName.AwaitDataSourceImport */, {
+            'n': dataConnectorName,
+            's': syncDataSourceIdNonce,
+        });
+    }
     xhr(request) {
         const responseFormat = request.responseFormat || 'utf8';
         return this.sendCommand("xhr" /* CommandName.SendXHR */, {

package/sdk/ui/panel.d.ts

@@ -24,6 +24,8 @@ export interface PanelConfig {
     iconUrl: string;
     /** A tool tip to be displayed when hovering over the activation icon. */
     toolTip?: string;
+    /** If set true, we will persist the panel's iframe in the background if it's not currently active*/
+    persist?: boolean;
 }
 /**
  * Extend this class to show a custom panel to the user, whose contents are displayed in a sandboxed

package/sdk/ui/panel.js

@@ -37,6 +37,7 @@ class Panel extends iframeui_1.IframeUI {
             'v': this.config.visibleAction,
             'i': this.config.iconUrl,
             'to': this.config.toolTip,
+            'p': this.config.persist,
         });
     }
     /**