lucid-extension-sdk 0.0.447 → 0.0.449

package/commandtypes.d.ts

@@ -252,8 +252,8 @@ export type CommandArgs = {
         result: CancelDragBlockToCanvasResult;
     };
     [CommandName.CheckUserFlagAssignment]: {
-        query: CheckUserFlagAssignmentQuery;
-        result: CheckUserFlagAssignmentResult;
+        query: CheckUserFeatureFlagAssignmentQuery;
+        result: CheckUserFeatureFlagAssignmentResult;
     };
     [CommandName.Confirm]: {
         query: ConfirmQuery;
@@ -765,6 +765,13 @@ export type AutoSyncSettings = {
     'gsf': string;
     'sqs'?: string | undefined;
     'syqs'?: string | undefined;
+    /** If specified, setup fields that allow user to create query template that auto applies to dynamic tables when created*/
+    'dpf'?: {
+        /** Get search fields action */
+        'gsf': string;
+        /** Generate preset value action */
+        'gpv': string;
+    } | undefined;
 };
 export type SerializedFieldConfiguration = {
     /** Callback to get field definitions for all fields supported by the card integration */
@@ -773,6 +780,10 @@ export type SerializedFieldConfiguration = {
     'osfc'?: string | undefined;
     /** Field name -> callback name tuples for searching for legal field values in an enum */
     'fvsc'?: [string, string][] | undefined;
+    /** Field name -> callback name tuples for some function that should be called before the field value is updated */
+    'fttic'?: [string, string][] | undefined;
+    /** Field type -> callback name tuples for searching for legal field values in an enum */
+    'ftvsc'?: [string, string][] | undefined;
     /** Default search callback for searching for legal field values in an enum */
     'dsc'?: string | undefined;
     /** Custom field display settings */
@@ -821,6 +832,8 @@ export type AddCardIntegrationQuery = {
         'mmw'?: number | undefined;
         /** Use Isolated Search Bar */
         'uisbui'?: boolean;
+        /** Use Updated Filter UI */
+        'uufui'?: boolean;
         /** Get search fields action */
         'gsf': string;
         /** Search action */
@@ -926,8 +939,9 @@ export type AddCardIntegrationQuery = {
         'ilp'?: string;
     } | undefined;
     /**
-     * If provided, this data is used to turn links pasted on the canvas that match the domain into primary keys and
+     * If provided, this data is used to turn links pasted on the canvas that match the domain(s) into primary keys and
      * other helpful data, which are sent back to the extension as an import action.
+     * The 'd' field can be a single domain string or an array of domain strings.
      */
     'icfpl'?: {
         'd': string | string[];
@@ -939,6 +953,15 @@ export type AddCardIntegrationQuery = {
     'cei'?: string | undefined;
     /** getAdditionalPanelTabsForCard -- Cards' additional details via tabs in panel */
     'gaptfc'?: string | undefined;
+    /** Instance switching configuration */
+    'is'?: {
+        /** Get instances action */
+        'gi': string;
+        /** On instance change action */
+        'oic': string;
+        /** Get selected instance ID action */
+        'gsii': string;
+    } | undefined;
 };
 export type AddCardIntegrationResult = undefined;
 export type AddLineTextAreaQuery = {
@@ -1042,6 +1065,10 @@ export type AddShapeDataQuery = {
 export type AddShapeDataResult = undefined;
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export type AddSpreadsheetIntegrationQuery = {
+    /** Item label */
+    'il'?: string;
+    /** Items label */
+    'isl'?: string;
     /** labelDescription */
     'ld': string;
     /** labelIconUrl */
@@ -2064,9 +2091,9 @@ export type ZOrderQuery = {
     'o': ZOrderOperation;
 };
 export type ZOrderResult = undefined;
-export type CheckUserFlagAssignmentQuery = {
+export type CheckUserFeatureFlagAssignmentQuery = {
     /** The name of the flag that will be checked */
     'f': string;
 };
-export type CheckUserFlagAssignmentResult = boolean;
+export type CheckUserFeatureFlagAssignmentResult = boolean;
 export {};

package/commandtypes.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZOrderOperation = exports.isRawSendXHRResponse = exports.MermaidDiagramType = exports.GetLLMContextType = exports.GetItemsAtSearchType = exports.GetDocumentChunksType = exports.HashAlgorithmEnum = exports.AuthorizationFlowHandlerStage = exports.commandTitles = void 0;
+exports.ZOrderOperation = exports.MermaidDiagramType = exports.GetLLMContextType = exports.GetItemsAtSearchType = exports.GetDocumentChunksType = exports.HashAlgorithmEnum = exports.AuthorizationFlowHandlerStage = exports.commandTitles = void 0;
+exports.isRawSendXHRResponse = isRawSendXHRResponse;
 const checks_1 = require("./core/checks");
 /** @ignore */
 exports.commandTitles = new Map([
@@ -194,7 +195,6 @@ var MermaidDiagramType;
 function isRawSendXHRResponse(val) {
     return (0, checks_1.isString)(val['url']) && (0, checks_1.isString)(val['t']) && (0, checks_1.isNumber)(val['s']) && (0, checks_1.isObject)(val['h']);
 }
-exports.isRawSendXHRResponse = isRawSendXHRResponse;
 var ZOrderOperation;
 (function (ZOrderOperation) {
     ZOrderOperation[ZOrderOperation["UP"] = 1] = "UP";

package/core/assertnever.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertNever = void 0;
+exports.assertNever = assertNever;
 /**
  * Use this to assert that a type check is exhaustive at build-time. There should never be a code path that reaches this function.
  * @param x the value to assert is never reached
@@ -8,4 +8,3 @@ exports.assertNever = void 0;
 function assertNever(x) {
     throw new Error(`Assertion failed! Expected assertNever to not be called, but it was called with parameter ${JSON.stringify(x)}`);
 }
-exports.assertNever = assertNever;

package/core/base64.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.encodeBase64 = exports.decodeBase64 = void 0;
+exports.decodeBase64 = decodeBase64;
+exports.encodeBase64 = encodeBase64;
 const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
 //This gives a ~8x speedup vs. using alphabet.indexOf() in the main decode loop.
 const charCodeToEncodedInt = [];
@@ -45,7 +46,6 @@ function decodeBase64(base64String) {
     }
     return output;
 }
-exports.decodeBase64 = decodeBase64;
 function encodeBase64(byteArray) {
     // 3 bytes of input become 4 chars of output
     // i.e. every 6 bits of input becomes 1 char of output
@@ -85,4 +85,3 @@ function encodeBase64(byteArray) {
     }
     return output.join('');
 }
-exports.encodeBase64 = encodeBase64;

package/core/cardintegration/cardfielddisplaysettings.d.ts

@@ -65,7 +65,7 @@ export declare enum FieldDisplayType {
      */
     CustomTextField = "CustomTextField"
 }
-export declare const isFieldDisplayType: (x: unknown) => x is FieldDisplayType;
+export declare const isFieldDisplayType: (x: unknown) => x is {} extends typeof FieldDisplayType ? never : FieldDisplayType;
 /**
  * When configuring a field on a LucidCardBlock to be displayed as a data graphic, this click handler value
  * specifies what to do when the user clicks on the data graphic produced.
@@ -98,7 +98,7 @@ export declare enum OnClickHandlerKeys {
      */
     OpenTargetTab = "OpenTargetTab"
 }
-export declare const isOnClickHandlerKey: (x: unknown) => x is OnClickHandlerKeys;
+export declare const isOnClickHandlerKey: (x: unknown) => x is {} extends typeof OnClickHandlerKeys ? never : OnClickHandlerKeys;
 declare const TextBadgeSettingsFormatter: import("../format/format").Format<import("../format/objectformat").ObjectFormatSerializedType<{
     readonly rounding: readonly ["rounding", import("../format/format").Format<number | null | undefined, number | null | undefined>];
     readonly bold: readonly ["bold", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];

package/core/cardintegration/cardfielddisplaysettings.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LucidCardFields = exports.StatusValues = exports.deserializeLucidCardFieldDisplaySettings = exports.serializeLucidCardFieldDisplaySettings = exports.copyLucidCardFieldDisplaySettings = exports.isSerializedLucidCardFieldDisplaySettings = exports.CardFieldDisplaySettingsFormatter = exports.isOnClickHandlerKey = exports.OnClickHandlerKeys = exports.isFieldDisplayType = exports.FieldDisplayType = void 0;
+exports.LucidCardFields = exports.StatusValues = exports.deserializeLucidCardFieldDisplaySettings = exports.serializeLucidCardFieldDisplaySettings = exports.isSerializedLucidCardFieldDisplaySettings = exports.CardFieldDisplaySettingsFormatter = exports.isOnClickHandlerKey = exports.OnClickHandlerKeys = exports.isFieldDisplayType = exports.FieldDisplayType = void 0;
+exports.copyLucidCardFieldDisplaySettings = copyLucidCardFieldDisplaySettings;
 const enumformat_1 = require("../format/enumformat");
 const format_1 = require("../format/format");
 const objectformat_1 = require("../format/objectformat");
@@ -204,7 +205,6 @@ exports.isSerializedLucidCardFieldDisplaySettings = exports.CardFieldDisplaySett
 function copyLucidCardFieldDisplaySettings(settings) {
     return (0, exports.deserializeLucidCardFieldDisplaySettings)((0, exports.serializeLucidCardFieldDisplaySettings)(settings));
 }
-exports.copyLucidCardFieldDisplaySettings = copyLucidCardFieldDisplaySettings;
 /** @ignore */
 exports.serializeLucidCardFieldDisplaySettings = exports.CardFieldDisplaySettingsFormatter.toJson;
 /** @ignore */

package/core/cardintegration/cardintegrationautosyncconfig.d.ts

@@ -1,5 +1,6 @@
 import type { SerializedFieldType } from '../data/serializedfield/serializedfields';
 import type { ExtensionCardFieldDefinition, ImportResult, SearchResult } from '../sharedcardintegration/cardintegrationdefinitions';
+import type { DocumentPresetSetupFields } from './lucidcardintegrationpresetsetupmodal';
 /**
  * The amount of results that will be displayed per page when using pagination. To enable pagination, define the
  * {@link SearchResult.itemsPerSearchResult} field in your search results and return workitems equal to this variable's
@@ -39,6 +40,15 @@ export interface CardIntegrationAutoSyncConfig {
      * @returns the ImportResult for the query string.
      */
     syncQueryString?: (queryString: string, otherFields: Map<string, SerializedFieldType>) => Promise<ImportResult | ImportResult[]>;
+    /**
+     * @experimental
+     * Document preset setup configuration for this card integration's auto sync.
+     *
+     * When specified, this enables your card integration to participate in Lucid's document preset
+     * system, which allows users to configure dynamic matrix templates that automatically populate new
+     * documents with cards from your integration.
+     */
+    documentPresetSetupFields?: DocumentPresetSetupFields | undefined;
 }
 export interface AutoSyncConfigPhrasesType {
     /**
@@ -70,4 +80,4 @@ export declare enum SupportedAutoSyncGeneratorType {
     Timeline = "timeline",
     DynamicMatrix = "dynamic matrix"
 }
-export declare const isSupportedAutoSyncGeneratorType: (x: unknown) => x is SupportedAutoSyncGeneratorType;
+export declare const isSupportedAutoSyncGeneratorType: (x: unknown) => x is {} extends typeof SupportedAutoSyncGeneratorType ? never : SupportedAutoSyncGeneratorType;

package/core/cardintegration/cardintegrationconfig.d.ts

@@ -1,3 +1,4 @@
+import { DisplayOptionType } from '../data/serializedfield/serializeddisplayoption';
 import { type FormatToDeserializedType, type FormatToSerializedType } from '../format/format';
 import type { DeepWritable } from '../mutable';
 declare const CardIntegrationConfigFormatter: import("../format/format").Format<import("../format/objectformat").ObjectFormatSerializedType<{
@@ -185,14 +186,32 @@ declare const CardIntegrationConfigFormatter: import("../format/format").Format<
              * If true then the visibility of this field in the details panel cannot be modified by a user.
              */
             readonly locked: readonly ["l", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
+            /**
+             * Optional display options for the field (e.g., helper text)
+             */
+            readonly displayOptions: readonly ["do", import("../format/format").Format<readonly import("../format/objectformat").ObjectFormatSerializedType<{
+                readonly type: readonly ["Type", import("../format/format").Format<DisplayOptionType, DisplayOptionType>];
+                readonly value: readonly ["Details", import("../format/format").Format<string | null | undefined, string | null | undefined>];
+            }>[] | null | undefined, readonly {
+                readonly type: DisplayOptionType;
+                readonly value?: string | null | undefined;
+            }[] | null | undefined>];
         }>[], readonly {
             readonly name: string;
             readonly locked?: boolean | null | undefined;
+            readonly displayOptions?: readonly {
+                readonly type: DisplayOptionType;
+                readonly value?: string | null | undefined;
+            }[] | null | undefined;
         }[]>];
     }>, {
         readonly fields: readonly {
             readonly name: string;
             readonly locked?: boolean | null | undefined;
+            readonly displayOptions?: readonly {
+                readonly type: DisplayOptionType;
+                readonly value?: string | null | undefined;
+            }[] | null | undefined;
         }[];
     }>];
 }>, {
@@ -242,6 +261,10 @@ declare const CardIntegrationConfigFormatter: import("../format/format").Format<
         readonly fields: readonly {
             readonly name: string;
             readonly locked?: boolean | null | undefined;
+            readonly displayOptions?: readonly {
+                readonly type: DisplayOptionType;
+                readonly value?: string | null | undefined;
+            }[] | null | undefined;
         }[];
     };
 }>;

package/core/cardintegration/cardintegrationconfig.js

@@ -2,12 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deserializeCardIntegrationConfig = exports.serializeCardIntegrationConfig = exports.isSerializedCardIntegrationConfig = void 0;
 const textstyle_1 = require("../../document/text/textstyle");
+const serializeddisplayoption_1 = require("../data/serializedfield/serializeddisplayoption");
 const arrayformat_1 = require("../format/arrayformat");
+const enumformat_1 = require("../format/enumformat");
 const format_1 = require("../format/format");
 const mapformat_1 = require("../format/mapformat");
 const objectformat_1 = require("../format/objectformat");
 const primitiveformat_1 = require("../format/primitiveformat");
 const cardfielddisplaysettings_1 = require("./cardfielddisplaysettings");
+const DisplayOptionDefinitionFormatter = (0, objectformat_1.ObjectFormat)({
+    type: ['Type', (0, enumformat_1.EnumFormat)(serializeddisplayoption_1.DisplayOptionType)],
+    value: ['Details', (0, format_1.OptionFormat)(primitiveformat_1.StringFormat)],
+});
 const CardIntegrationConfigFormatter = (0, objectformat_1.ObjectFormat)({
     cardConfig: [
         'cc',
@@ -47,6 +53,10 @@ const CardIntegrationConfigFormatter = (0, objectformat_1.ObjectFormat)({
                      * If true then the visibility of this field in the details panel cannot be modified by a user.
                      */
                     locked: ['l', (0, format_1.OptionFormat)(primitiveformat_1.BooleanFormat)],
+                    /**
+                     * Optional display options for the field (e.g., helper text)
+                     */
+                    displayOptions: ['do', (0, format_1.OptionFormat)((0, arrayformat_1.ArrayFormat)(DisplayOptionDefinitionFormatter))],
                 })),
             ],
         }),

package/core/cardintegration/cardintegrationparams.d.ts

@@ -110,4 +110,14 @@ export interface DataItemCallbackParam {
 export interface ImportFromSerializedFieldsCallbackParam {
     'sf': SerializedFields[];
 }
+/** @ignore */
+export interface FieldTypeValueToItemsCallbackParams {
+    'd'?: string | undefined;
+    'v': SerializedFieldType;
+    'f': string;
+}
+/** @ignore */
+export interface GeneratePresetValueParam {
+    'f': [string, SerializedFieldType][];
+}
 export {};

package/core/cardintegration/cardpaneltabs/tab.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deserializeLucidCardPanelTab = exports.serializeLucidCardPanelTab = exports.isValidSerializedLucidCardPanelTab = exports.isValidLucidCardPanelTab = void 0;
+exports.isValidSerializedLucidCardPanelTab = exports.isValidLucidCardPanelTab = void 0;
+exports.serializeLucidCardPanelTab = serializeLucidCardPanelTab;
+exports.deserializeLucidCardPanelTab = deserializeLucidCardPanelTab;
 const assertnever_1 = require("../../assertnever");
 const validators_1 = require("../../validators/validators");
 const listtab_1 = require("./tabs/listtab");
@@ -17,7 +19,6 @@ function serializeLucidCardPanelTab(concrete) {
             (0, assertnever_1.assertNever)(concrete.type);
     }
 }
-exports.serializeLucidCardPanelTab = serializeLucidCardPanelTab;
 /** @ignore */
 function deserializeLucidCardPanelTab(serialized) {
     switch (serialized.type) {
@@ -27,4 +28,3 @@ function deserializeLucidCardPanelTab(serialized) {
             (0, assertnever_1.assertNever)(serialized.type);
     }
 }
-exports.deserializeLucidCardPanelTab = deserializeLucidCardPanelTab;

package/core/cardintegration/cardpaneltabs/tabs/listtab.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deserializeLucidCardPanelListTab = exports.serializeLucidCardPanelListTab = exports.isValidSerializedLucidCardPanelListTab = exports.isValidLucidCardPanelListTab = void 0;
+exports.isValidSerializedLucidCardPanelListTab = exports.isValidLucidCardPanelListTab = void 0;
+exports.serializeLucidCardPanelListTab = serializeLucidCardPanelListTab;
+exports.deserializeLucidCardPanelListTab = deserializeLucidCardPanelListTab;
 const checks_1 = require("../../../checks");
 const validators_1 = require("../../../validators/validators");
 const extensiondatapanellistitem_1 = require("../../extensiondatapanel/extensiondatapanellistitem");
@@ -24,7 +26,6 @@ function serializeLucidCardPanelListTab(concrete) {
         'i': concrete.items.map(extensiondatapanellistitem_1.serializeExtensionDataPanelListItem),
     };
 }
-exports.serializeLucidCardPanelListTab = serializeLucidCardPanelListTab;
 /** @ignore */
 function deserializeLucidCardPanelListTab(serialized) {
     return {
@@ -33,4 +34,3 @@ function deserializeLucidCardPanelListTab(serialized) {
         items: serialized['i'].map(extensiondatapanellistitem_1.deserializeExtensionDataPanelListItem),
     };
 }
-exports.deserializeLucidCardPanelListTab = deserializeLucidCardPanelListTab;

package/core/cardintegration/cardpaneltabs/tabs.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deserializeTabsCallback = exports.registerGetAdditionalPanelTabsForCardCallback = exports.deserializeLucidCardPanelTabs = exports.serializeLucidCardPanelTabs = exports.areValidSerializedLucidCardPanelTabs = exports.areValidLucidCardPanelTabs = void 0;
+exports.areValidSerializedLucidCardPanelTabs = exports.areValidLucidCardPanelTabs = void 0;
+exports.serializeLucidCardPanelTabs = serializeLucidCardPanelTabs;
+exports.deserializeLucidCardPanelTabs = deserializeLucidCardPanelTabs;
+exports.registerGetAdditionalPanelTabsForCardCallback = registerGetAdditionalPanelTabsForCardCallback;
+exports.deserializeTabsCallback = deserializeTabsCallback;
 const collectionproxy_1 = require("../../../data/collectionproxy");
 const dataitemproxy_1 = require("../../../data/dataitemproxy");
 const datasourceproxy_1 = require("../../../data/datasourceproxy");
@@ -14,12 +18,10 @@ exports.areValidSerializedLucidCardPanelTabs = (0, validators_1.arrayValidator)(
 function serializeLucidCardPanelTabs(concrete) {
     return concrete.map(tab_1.serializeLucidCardPanelTab);
 }
-exports.serializeLucidCardPanelTabs = serializeLucidCardPanelTabs;
 /** @ignore */
 function deserializeLucidCardPanelTabs(serialized) {
     return serialized.map(tab_1.deserializeLucidCardPanelTab);
 }
-exports.deserializeLucidCardPanelTabs = deserializeLucidCardPanelTabs;
 /** @ignore */
 function registerGetAdditionalPanelTabsForCardCallback(client, tabsCallback, serialized, actionName) {
     serialized['gaptfc'] = actionName;
@@ -40,7 +42,6 @@ function registerGetAdditionalPanelTabsForCardCallback(client, tabsCallback, ser
     };
     client.registerAction(actionName, serializedAction);
 }
-exports.registerGetAdditionalPanelTabsForCardCallback = registerGetAdditionalPanelTabsForCardCallback;
 /** @ignore */
 function deserializeTabsCallback(callbackHookName, postMessage) {
     // Serializes, runs callback, and deserializes the result
@@ -59,4 +60,3 @@ function deserializeTabsCallback(callbackHookName, postMessage) {
     };
     return wrappedCallback;
 }
-exports.deserializeTabsCallback = deserializeTabsCallback;

package/core/cardintegration/extensiondatapanel/extensiondatapanellistitem.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerGetListItemsForFieldCallback = exports.deserializeExtensionDataPanelListItem = exports.serializeExtensionDataPanelListItem = exports.isValidSerializedExtensionDataPanelListItemArray = exports.isValidSerializedExtensionDataPanelListItem = exports.isValidExtensionDataPanelListItem = void 0;
+exports.isValidSerializedExtensionDataPanelListItemArray = exports.isValidSerializedExtensionDataPanelListItem = exports.isValidExtensionDataPanelListItem = void 0;
+exports.serializeExtensionDataPanelListItem = serializeExtensionDataPanelListItem;
+exports.deserializeExtensionDataPanelListItem = deserializeExtensionDataPanelListItem;
+exports.registerGetListItemsForFieldCallback = registerGetListItemsForFieldCallback;
 const collectionproxy_1 = require("../../../data/collectionproxy");
 const dataitemproxy_1 = require("../../../data/dataitemproxy");
 const datasourceproxy_1 = require("../../../data/datasourceproxy");
@@ -32,14 +35,12 @@ exports.isValidSerializedExtensionDataPanelListItemArray = (0, validators_1.arra
 function serializeExtensionDataPanelListItem(concrete) {
     return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (concrete.title !== undefined ? { 't': concrete.title } : {})), (concrete.description !== undefined ? { 'd': concrete.description } : {})), (concrete.caption !== undefined ? { 'c': concrete.caption } : {})), (concrete.icon !== undefined ? { 'i': concrete.icon } : {})), (concrete.externalLink !== undefined ? { 'el': concrete.externalLink } : {})), (concrete.tags !== undefined ? { 'ts': concrete.tags.map(extensiondatapanellistitemtag_1.serializeExtensionDataPanelListItemTag) } : {}));
 }
-exports.serializeExtensionDataPanelListItem = serializeExtensionDataPanelListItem;
 /** @ignore */
 function deserializeExtensionDataPanelListItem(serialized) {
     return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (serialized['t'] !== undefined ? { title: serialized['t'] } : {})), (serialized['d'] !== undefined ? { description: serialized['d'] } : {})), (serialized['c'] !== undefined ? { caption: serialized['c'] } : {})), (serialized['i'] !== undefined ? { icon: serialized['i'] } : {})), (serialized['el'] !== undefined ? { externalLink: serialized['el'] } : {})), (serialized['ts'] !== undefined
         ? { tags: serialized['ts'].map(extensiondatapanellistitemtag_1.deserializeExtensionDataPanelListItemTag) }
         : {}));
 }
-exports.deserializeExtensionDataPanelListItem = deserializeExtensionDataPanelListItem;
 /** @ignore */
 function registerGetListItemsForFieldCallback(client, listItemsCallback, serialized, actionName) {
     serialized['fc']['gliff'] = actionName;
@@ -60,4 +61,3 @@ function registerGetListItemsForFieldCallback(client, listItemsCallback, seriali
     };
     client.registerAction(actionName, serializedAction);
 }
-exports.registerGetListItemsForFieldCallback = registerGetListItemsForFieldCallback;

package/core/cardintegration/extensiondatapanel/extensiondatapanellistitemtag.js

@@ -1,19 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deserializeExtensionDataPanelListItemTag = exports.serializeExtensionDataPanelListItemTag = exports.isValidSerializedExtensionDataPanelListItemTag = exports.isValidExtensionDataPanelListItemTag = void 0;
+exports.isValidExtensionDataPanelListItemTag = isValidExtensionDataPanelListItemTag;
+exports.isValidSerializedExtensionDataPanelListItemTag = isValidSerializedExtensionDataPanelListItemTag;
+exports.serializeExtensionDataPanelListItemTag = serializeExtensionDataPanelListItemTag;
+exports.deserializeExtensionDataPanelListItemTag = deserializeExtensionDataPanelListItemTag;
 const extensiondatapanellistitemtexttag_1 = require("./extensiondatapanellistitemtexttag");
 const extensiondatapanellistitemusertag_1 = require("./extensiondatapanellistitemusertag");
 /** @ignore */
 function isValidExtensionDataPanelListItemTag(value) {
     return (0, extensiondatapanellistitemtexttag_1.isValidExtensionDataPanelListItemTextTag)(value) || (0, extensiondatapanellistitemusertag_1.isValidExtensionDataPanelListItemUserTag)(value);
 }
-exports.isValidExtensionDataPanelListItemTag = isValidExtensionDataPanelListItemTag;
 /** @ignore */
 function isValidSerializedExtensionDataPanelListItemTag(value) {
     return ((0, extensiondatapanellistitemtexttag_1.isValidSerializedExtensionDataPanelListItemTextTag)(value) ||
         (0, extensiondatapanellistitemusertag_1.isValidSerializedExtensionDataPanelListItemUserTag)(value));
 }
-exports.isValidSerializedExtensionDataPanelListItemTag = isValidSerializedExtensionDataPanelListItemTag;
 /** @ignore */
 function serializeExtensionDataPanelListItemTag(concrete) {
     if ('users' in concrete) {
@@ -21,7 +22,6 @@ function serializeExtensionDataPanelListItemTag(concrete) {
     }
     return (0, extensiondatapanellistitemtexttag_1.serializeExtensionDataPanelListItemTextTag)(concrete);
 }
-exports.serializeExtensionDataPanelListItemTag = serializeExtensionDataPanelListItemTag;
 /** @ignore */
 function deserializeExtensionDataPanelListItemTag(serialized) {
     if ('u' in serialized) {
@@ -29,4 +29,3 @@ function deserializeExtensionDataPanelListItemTag(serialized) {
     }
     return (0, extensiondatapanellistitemtexttag_1.deserializeExtensionDataPanelListItemTextTag)(serialized);
 }
-exports.deserializeExtensionDataPanelListItemTag = deserializeExtensionDataPanelListItemTag;

package/core/cardintegration/extensiondatapanel/extensiondatapanellistitemtexttag.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deserializeExtensionDataPanelListItemTextTag = exports.serializeExtensionDataPanelListItemTextTag = exports.isValidSerializedExtensionDataPanelListItemTextTag = exports.isValidExtensionDataPanelListItemTextTag = void 0;
+exports.isValidSerializedExtensionDataPanelListItemTextTag = exports.isValidExtensionDataPanelListItemTextTag = void 0;
+exports.serializeExtensionDataPanelListItemTextTag = serializeExtensionDataPanelListItemTextTag;
+exports.deserializeExtensionDataPanelListItemTextTag = deserializeExtensionDataPanelListItemTextTag;
 const checks_1 = require("../../checks");
 const validators_1 = require("../../validators/validators");
 /** @ignore */
@@ -19,9 +21,7 @@ exports.isValidSerializedExtensionDataPanelListItemTextTag = (0, validators_1.ob
 function serializeExtensionDataPanelListItemTextTag(concrete) {
     return Object.assign(Object.assign({ 't': concrete.text }, (concrete.color !== undefined ? { 'c': concrete.color } : {})), (concrete.tooltip !== undefined ? { 'tt': concrete.tooltip } : {}));
 }
-exports.serializeExtensionDataPanelListItemTextTag = serializeExtensionDataPanelListItemTextTag;
 /** @ignore */
 function deserializeExtensionDataPanelListItemTextTag(serialized) {
     return Object.assign(Object.assign({ text: serialized['t'] }, (serialized['c'] !== undefined ? { color: serialized['c'] } : {})), (serialized['tt'] !== undefined ? { tooltip: serialized['tt'] } : {}));
 }
-exports.deserializeExtensionDataPanelListItemTextTag = deserializeExtensionDataPanelListItemTextTag;

package/core/cardintegration/extensiondatapanel/extensiondatapanellistitemusertag.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deserializeExtensionDataPanelListItemUserTag = exports.serializeExtensionDataPanelListItemUserTag = exports.isValidSerializedExtensionDataPanelListItemUserTag = exports.isValidExtensionDataPanelListItemUserTag = void 0;
+exports.isValidSerializedExtensionDataPanelListItemUserTag = exports.isValidExtensionDataPanelListItemUserTag = void 0;
+exports.serializeExtensionDataPanelListItemUserTag = serializeExtensionDataPanelListItemUserTag;
+exports.deserializeExtensionDataPanelListItemUserTag = deserializeExtensionDataPanelListItemUserTag;
 const cardintegrationdefinitions_1 = require("../../sharedcardintegration/cardintegrationdefinitions");
 const validators_1 = require("../../validators/validators");
 /** @ignore */
@@ -17,11 +19,9 @@ function serializeExtensionDataPanelListItemUserTag(concrete) {
         'u': concrete.users.map(cardintegrationdefinitions_1.serializeCardUserData),
     };
 }
-exports.serializeExtensionDataPanelListItemUserTag = serializeExtensionDataPanelListItemUserTag;
 /** @ignore */
 function deserializeExtensionDataPanelListItemUserTag(serialized) {
     return {
         users: serialized['u'].map(cardintegrationdefinitions_1.deserializeCardUserData),
     };
 }
-exports.deserializeExtensionDataPanelListItemUserTag = deserializeExtensionDataPanelListItemUserTag;

package/core/cardintegration/lucidcardintegration.d.ts

@@ -2,13 +2,14 @@ import { ImportCardsResult } from '../../commandtypes';
 import { CollectionProxy } from '../../data/collectionproxy';
 import { DataItemProxy } from '../../data/dataitemproxy';
 import { DataSourceProxy } from '../../data/datasourceproxy';
+import { DisplayOptionDefinition } from '../../data/displayoptiondefinition';
 import type { TextStyle } from '../../document/text/textstyle';
 import { EditorClient } from '../../editorclient';
 import { isString } from '../checks';
 import type { SerializedFieldType, SerializedFields } from '../data/serializedfield/serializedfields';
 import type { ImportCardFromDetails } from '../importcardfromdetails/importcardfromdetails';
 import type { ImportCardFromPastedLinkCallback } from '../importcardfrompastedlink/importcardfrompastedlinkcallback';
-import type { DependenciesForItems, ExtensionCardFieldDefinition, ExtensionFieldConfiguration, ImportResult } from '../sharedcardintegration/cardintegrationdefinitions';
+import { DependenciesForItems, ExtensionCardFieldDefinition, ExtensionFieldConfiguration, ImportResult, Instance } from '../sharedcardintegration/cardintegrationdefinitions';
 import type { CardIntegrationAutoSyncConfig } from './cardintegrationautosyncconfig';
 import type { CardIntegrationConfig } from './cardintegrationconfig';
 import type { AdditionalPanelTabsCallback } from './cardpaneltabs/tabs';
@@ -25,11 +26,18 @@ export interface FieldDescriptor {
      * This is useful for fields that should always be shown, such as a "name" field.
      */
     locked?: boolean | undefined;
+    /**
+     * @experimental
+     * Optional display options for the field (e.g., helper text, multi-user select UI).
+     * Controls how the field is rendered in the card details panel.
+     */
+    displayOptions?: DisplayOptionDefinition[] | undefined;
 }
 export declare const isFieldDescriptor: (subject: unknown) => subject is import("../guards").DestructureGuardedTypeObj<{
     name: typeof isString;
     label: (x: unknown) => x is string | undefined;
     locked: (x: unknown) => x is boolean | undefined;
+    displayOptions: (x: unknown) => x is DisplayOptionDefinition[] | undefined;
 }>;
 export declare abstract class LucidCardIntegration {
     protected readonly client: EditorClient;
@@ -158,11 +166,14 @@ export declare abstract class LucidCardIntegration {
      * A definition of the details required to import a card onto the canvas from a pasted url. The callback returns
      * necessary data to import cards onto the canvas, or `undefined` if the link couldn't be interpreted.
      *
-     * If the domain has already been registered by another card integration for importing cards from pasted links, this
-     * callback will be prevented from being registered.
+     * Domain can be a single string or an array of strings. Each domain will be registered separately.
+     * Supports wildcard domains like '*.example.com' to match any subdomain.
+     *
+     * If any domain has already been registered by another card integration for importing cards from pasted links,
+     * that specific domain registration will be prevented.
      */
     importCardFromPastedLink?: {
-        domain: string;
+        domain: string | string[];
         callback: ImportCardFromPastedLinkCallback;
     };
     /**
@@ -181,4 +192,23 @@ export declare abstract class LucidCardIntegration {
      * via tabs that are configured by the extension and displayed in the card details panel.
      */
     getAdditionalPanelTabsForCard?: AdditionalPanelTabsCallback;
+    /**
+     * Configuration for instance switching. An instance is a singular context for which a user can perform search actions
+     * or import actions in. Switching between instances will reset the state for searching and creating.
+     */
+    instanceSwitching?: {
+        /**
+         * Returns available instances the user can switch between.
+         */
+        getInstances: () => Promise<Instance[]>;
+        /**
+         * Called when the user selects a different instance.
+         * The extension should update its state for subsequent operations.
+         */
+        onInstanceChange: (instance: Instance) => Promise<void>;
+        /**
+         * Returns the currently selected instance ID.
+         */
+        getSelectedInstanceId: () => string | undefined;
+    };
 }

package/core/cardintegration/lucidcardintegration.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LucidCardIntegration = exports.isFieldDescriptor = void 0;
+const displayoptiondefinition_1 = require("../../data/displayoptiondefinition");
 const checks_1 = require("../checks");
 const validators_1 = require("../validators/validators");
 exports.isFieldDescriptor = (0, validators_1.objectValidator)({
     name: checks_1.isString,
     label: (0, validators_1.option)(checks_1.isString),
     locked: (0, validators_1.option)(checks_1.isBoolean),
+    displayOptions: (0, validators_1.option)((0, validators_1.arrayValidator)(displayoptiondefinition_1.isDisplayOptionDefinition)),
 });
 class LucidCardIntegration {
     constructor(client) {

package/core/cardintegration/lucidcardintegrationpresetsetupmodal.d.ts

@@ -0,0 +1,29 @@
+import { SerializedFieldType } from '../data/serializedfield/serializedfields';
+import { type FormatToSerializedType } from '../format/format';
+import { ExtensionCardFieldDefinition } from '../sharedcardintegration/cardintegrationdefinitions';
+declare const ExtensionGeneratorDocumentPresetInputSourceFormatter: import("../format/format").Format<import("../format/objectformat").ObjectFormatSerializedType<{
+    readonly dataConnectorName: readonly ["dcn", import("../format/format").Format<string, string>];
+    readonly instanceId: readonly ["iid", import("../format/format").Format<string, string>];
+    readonly query: readonly ["q", import("../format/format").Format<string, string>];
+}>, {
+    readonly dataConnectorName: string;
+    readonly instanceId: string;
+    readonly query: string;
+}>;
+export interface ExtensionGeneratorDocumentPresetInputSource {
+    dataConnectorName: string;
+    instanceId: string;
+    query: string;
+}
+/** @ignore */
+export type SerializedExtensionGeneratorDocumentPresetInputSource = FormatToSerializedType<typeof ExtensionGeneratorDocumentPresetInputSourceFormatter>;
+export declare const isSerializedExtensionGeneratorDocumentPresetInputSource: typeof ExtensionGeneratorDocumentPresetInputSourceFormatter.validator;
+/** @ignore */
+export declare const serializeExtensionGeneratorDocumentPresetInputSource: typeof ExtensionGeneratorDocumentPresetInputSourceFormatter.toJson;
+/** @ignore */
+export declare const deserializeExtensionGeneratorDocumentPresetInputSource: typeof ExtensionGeneratorDocumentPresetInputSourceFormatter.fromJson;
+export interface DocumentPresetSetupFields {
+    getSearchFields: (searchSoFar: Map<string, SerializedFieldType>) => Promise<ExtensionCardFieldDefinition[]>;
+    generatePresetValue: (fields: Map<string, SerializedFieldType>) => Promise<ExtensionGeneratorDocumentPresetInputSource>;
+}
+export {};