lucid-extension-sdk 0.0.443 → 0.0.445

package/commandtypes.d.ts

@@ -1,18 +1,18 @@
-import { SerializedCardIntegrationConfig } from './core/cardintegration/cardintegrationconfig';
-import { SerializedFieldTypeDefinition } from './core/data/fieldtypedefinition/fieldtypedefinition';
-import { SerializedReferenceKeyType } from './core/data/referencekeys/serializedreferencekey';
-import { SerializedFieldType } from './core/data/serializedfield/serializedfields';
-import { JsonObject, UnsafeJsonSerializableOrUndefined } from './core/jsonserializable';
+import type { SerializedCardIntegrationConfig } from './core/cardintegration/cardintegrationconfig';
+import type { SerializedFieldTypeDefinition } from './core/data/fieldtypedefinition/fieldtypedefinition';
+import type { SerializedReferenceKeyType } from './core/data/referencekeys/serializedreferencekey';
+import type { SerializedFieldType } from './core/data/serializedfield/serializedfields';
+import type { JsonObject, UnsafeJsonSerializableOrUndefined } from './core/jsonserializable';
 import { LucidProduct } from './core/lucidproduct';
-import { LinearOffsetType } from './core/offsettype';
-import { PartialAndNullish } from './core/partialandundefined';
-import { SerializedDataError } from './core/serializeddataerror';
+import type { LinearOffsetType } from './core/offsettype';
+import type { PartialAndNullish } from './core/partialandundefined';
+import type { SerializedDataError } from './core/serializeddataerror';
 import { ShapeDataInheritance } from './core/shapedatainheritance';
 import { DocumentAccessPermission } from './document/documentaccesspermission';
 import { DocumentElementType } from './document/documentelement/documentelementtype';
-import { SerializedLineTextAreaPositioning } from './document/linetextareapositioning';
-import { TextStyle } from './document/text/textstyle';
-import { Box, Point } from './math';
+import type { SerializedLineTextAreaPositioning } from './document/linetextareapositioning';
+import type { TextStyle } from './document/text/textstyle';
+import type { Box, Point } from './math';
 import { MenuLocation, MenuType } from './ui/menu';
 import { PanelLocation } from './ui/panel';
 /**
@@ -752,7 +752,6 @@ export type AddCardsActions = {
     'cc': string;
 };
 export type AutoSyncSettings = {
-    'h': string;
     /** Phrases */
     'p'?: {
         /** Header */
@@ -865,6 +864,11 @@ export type AddCardIntegrationQuery = {
      * Tag callback, to display tag information for any card
      */
     'tc'?: string | undefined;
+    /**
+     * @experimental
+     * Banner action callback, to handle action button clicks in import error banners
+     */
+    'bac'?: string | undefined;
     /**
      * If specified, the text phrases to show in the dependency mapping UI.
      * If not specified, dependency mapping for this integration uses the default fallback phrases.

package/core/cardintegration/cardfielddisplaysettings.d.ts

@@ -1,5 +1,5 @@
-import { FormatToDeserializedType, FormatToSerializedType } from '../format/format';
-import { DeepWritable } from '../mutable';
+import { type FormatToDeserializedType, type FormatToSerializedType } from '../format/format';
+import type { DeepWritable } from '../mutable';
 import { HorizontalBadgePos, VerticalBadgePos } from '../properties/datagraphic/badgeposition';
 /**
  * When configuring a field on a LucidCardBlock to be displayed as a data graphic, one of these values specifies
@@ -91,7 +91,12 @@ export declare enum OnClickHandlerKeys {
     /**
      * Display a panel on the canvas when a stencil is clicked, showing a list of items related to the stencil field
      */
-    ListStencilPanel = "ListStencilPanel"
+    ListStencilPanel = "ListStencilPanel",
+    /**
+     * @experimental
+     * Open the right-hand card details panel and navigate to a specific target tab
+     */
+    OpenTargetTab = "OpenTargetTab"
 }
 export declare const isOnClickHandlerKey: (x: unknown) => x is OnClickHandlerKeys;
 declare const TextBadgeSettingsFormatter: import("../format/format").Format<import("../format/objectformat").ObjectFormatSerializedType<{
@@ -197,6 +202,11 @@ declare const StencilConfigFormatter: import("../format/format").Format<import("
      * If onClickHandlerKey is OpenBrowserWindow, this formula calculates the URL to open.
      */
     readonly linkFormula: readonly ["l", import("../format/format").Format<string | null | undefined, string | null | undefined>];
+    /**
+     * @experimental
+     * If onClickHandlerKey is OpenTargetTab, this specifies the label of the tab to open.
+     */
+    readonly targetTabLabel: readonly ["targetTabLabel", import("../format/format").Format<string | null | undefined, string | null | undefined>];
     /**
      * Allows the same card to have multiple textbadges but have different properties.
      * You can change bold, italic, underline, rounding, minwidth, minheight, maxtextwidth, maxfontsize
@@ -238,6 +248,7 @@ declare const StencilConfigFormatter: import("../format/format").Format<import("
     readonly verticalPosition?: VerticalBadgePos | null | undefined;
     readonly onClickHandlerKey?: OnClickHandlerKeys | null | undefined;
     readonly linkFormula?: string | null | undefined;
+    readonly targetTabLabel?: string | null | undefined;
     readonly textBadgeSettings?: {
         readonly rounding?: number | null | undefined;
         readonly bold?: boolean | null | undefined;
@@ -324,6 +335,11 @@ export declare const CardFieldDisplaySettingsFormatter: import("../format/format
          * If onClickHandlerKey is OpenBrowserWindow, this formula calculates the URL to open.
          */
         readonly linkFormula: readonly ["l", import("../format/format").Format<string | null | undefined, string | null | undefined>];
+        /**
+         * @experimental
+         * If onClickHandlerKey is OpenTargetTab, this specifies the label of the tab to open.
+         */
+        readonly targetTabLabel: readonly ["targetTabLabel", import("../format/format").Format<string | null | undefined, string | null | undefined>];
         /**
          * Allows the same card to have multiple textbadges but have different properties.
          * You can change bold, italic, underline, rounding, minwidth, minheight, maxtextwidth, maxfontsize
@@ -365,6 +381,7 @@ export declare const CardFieldDisplaySettingsFormatter: import("../format/format
         readonly verticalPosition?: VerticalBadgePos | null | undefined;
         readonly onClickHandlerKey?: OnClickHandlerKeys | null | undefined;
         readonly linkFormula?: string | null | undefined;
+        readonly targetTabLabel?: string | null | undefined;
         readonly textBadgeSettings?: {
             readonly rounding?: number | null | undefined;
             readonly bold?: boolean | null | undefined;
@@ -393,6 +410,7 @@ export declare const CardFieldDisplaySettingsFormatter: import("../format/format
         readonly verticalPosition?: VerticalBadgePos | null | undefined;
         readonly onClickHandlerKey?: OnClickHandlerKeys | null | undefined;
         readonly linkFormula?: string | null | undefined;
+        readonly targetTabLabel?: string | null | undefined;
         readonly textBadgeSettings?: {
             readonly rounding?: number | null | undefined;
             readonly bold?: boolean | null | undefined;
@@ -417,446 +435,12 @@ export type LucidCardFieldDisplaySettings = DeepWritable<FormatToDeserializedTyp
 /** @ignore */
 export type SerializedLucidCardFieldDisplaySettings = FormatToSerializedType<typeof CardFieldDisplaySettingsFormatter>;
 /** @ignore */
-export declare const isSerializedLucidCardFieldDisplaySettings: import("../guards").Validator<import("../format/objectformat").ObjectFormatSerializedType<{
-    readonly stencilConfig: readonly ["StencilConfig", import("../format/format").Format<import("../format/objectformat").ObjectFormatSerializedType<{
-        /**
-         * How should we generate the stencil/data graphic from the specified field value?
-         * These are registered in LucidCardsLibrary.registerStencilDisplayTypes.
-         *
-         * The serialized key is `getterKey` for backwards compatible, legacy reasons. We have renamed this field in code,
-         * but need to support the original serialized key.
-         */
-        readonly displayType: readonly ["getterKey", import("../format/format").Format<FieldDisplayType, FieldDisplayType>];
-        /**
-         * For displayType values that support it, you may provide an override for the
-         * background color for this data. If this is not provided, the background color
-         * will default to the background color of the card itself, darkened 5%.
-         *
-         * This may be provided as a literal color hex, e.g. "#00ff00ff" or as a formula
-         * by starting the string with "=", e.g. "=darken("#ffffff", 0.5)"
-         */
-        readonly backgroundColor: readonly ["bg", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * For displayType values that support it, you may provide an override for the
-         * foreground color for this data. If this is not provided, the foreground color
-         * will default to grey.
-         *
-         * This may be provided as a literal color hex, e.g. "#00ff00ff" or as a formula
-         * by starting the string with "=", e.g. "=darken("#ffffff", 0.5)"
-         */
-        readonly foregroundColor: readonly ["fg", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * For displayType values that support it, you may provide a height and a width
-         * for the image size. Images are 24px by 24px by default.
-         *
-         */
-        readonly imageBadgeSettings: readonly ["imageBadgeSettings", import("../format/format").Format<import("../format/objectformat").ObjectFormatSerializedType<{
-            readonly height: readonly ["height", import("../format/format").Format<number, number>];
-            readonly width: readonly ["width", import("../format/format").Format<number, number>];
-        }> | null | undefined, {
-            readonly height: number;
-            readonly width: number;
-        } | null | undefined>];
-        /**
-         * If specified, the result of this formula (executed in the context of the data item
-         * associated with this card) will be used instead of the raw field value when
-         * creating the data graphic. This can be useful if, for example, you want to convert
-         * an ID into a URL.
-         */
-        readonly valueFormula: readonly ["f", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * If specified, the result of this formula (executed in the context of the data item
-         * associated with this card) will be used as a tooltip when the user hovers the
-         * cursor over this data graphic.
-         */
-        readonly tooltipFormula: readonly ["t", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * Each display type has its default location on the card. You can override those
-         * default locations by setting these values.
-         */
-        readonly horizontalPosition: readonly ["h", import("../format/format").Format<HorizontalBadgePos | null | undefined, HorizontalBadgePos | null | undefined>];
-        /**
-         * Each display type has its default location on the card. You can override those
-         * default locations by setting these values.
-         */
-        readonly verticalPosition: readonly ["v", import("../format/format").Format<VerticalBadgePos | null | undefined, VerticalBadgePos | null | undefined>];
-        /**
-         * If specified, what behavior should happen when the user clicks on the data graphic
-         * generated via the above displayType?
-         */
-        readonly onClickHandlerKey: readonly ["onClickHandlerKey", import("../format/format").Format<OnClickHandlerKeys | null | undefined, OnClickHandlerKeys | null | undefined>];
-        /**
-         * If onClickHandlerKey is OpenBrowserWindow, this formula calculates the URL to open.
-         */
-        readonly linkFormula: readonly ["l", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * Allows the same card to have multiple textbadges but have different properties.
-         * You can change bold, italic, underline, rounding, minwidth, minheight, maxtextwidth, maxfontsize
-         */
-        readonly textBadgeSettings: readonly ["textBadgeSettings", 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>];
-            readonly italic: readonly ["italic", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
-            readonly underline: readonly ["underline", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
-            readonly minwidth: readonly ["minwidth", import("../format/format").Format<number | null | undefined, number | null | undefined>];
-            readonly minheight: readonly ["minheight", import("../format/format").Format<number | null | undefined, number | null | undefined>];
-            readonly maxfontsize: readonly ["maxfontsize", import("../format/format").Format<number | null | undefined, number | null | undefined>];
-            readonly maxtextwidth: readonly ["maxtextwidth", import("../format/format").Format<number | null | undefined, number | null | undefined>];
-            readonly iswithinpill: readonly ["iswithinpill", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
-            readonly hasleadingicon: readonly ["hasleadingicon", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
-        }> | null | undefined, {
-            readonly rounding?: number | null | undefined;
-            readonly bold?: boolean | null | undefined;
-            readonly italic?: boolean | null | undefined;
-            readonly underline?: boolean | null | undefined;
-            readonly minwidth?: number | null | undefined;
-            readonly minheight?: number | null | undefined;
-            readonly maxfontsize?: number | null | undefined;
-            readonly maxtextwidth?: number | null | undefined;
-            readonly iswithinpill?: boolean | null | undefined;
-            readonly hasleadingicon?: boolean | null | undefined;
-        } | null | undefined>];
-    }> | null | undefined, {
-        readonly displayType: FieldDisplayType;
-        readonly backgroundColor?: string | null | undefined;
-        readonly foregroundColor?: string | null | undefined;
-        readonly imageBadgeSettings?: {
-            readonly height: number;
-            readonly width: number;
-        } | null | undefined;
-        readonly valueFormula?: string | null | undefined;
-        readonly tooltipFormula?: string | null | undefined;
-        readonly horizontalPosition?: HorizontalBadgePos | null | undefined;
-        readonly verticalPosition?: VerticalBadgePos | null | undefined;
-        readonly onClickHandlerKey?: OnClickHandlerKeys | null | undefined;
-        readonly linkFormula?: string | null | undefined;
-        readonly textBadgeSettings?: {
-            readonly rounding?: number | null | undefined;
-            readonly bold?: boolean | null | undefined;
-            readonly italic?: boolean | null | undefined;
-            readonly underline?: boolean | null | undefined;
-            readonly minwidth?: number | null | undefined;
-            readonly minheight?: number | null | undefined;
-            readonly maxfontsize?: number | null | undefined;
-            readonly maxtextwidth?: number | null | undefined;
-            readonly iswithinpill?: boolean | null | undefined;
-            readonly hasleadingicon?: boolean | null | undefined;
-        } | null | undefined;
-    } | null | undefined>];
-}>>;
+export declare const isSerializedLucidCardFieldDisplaySettings: typeof CardFieldDisplaySettingsFormatter.validator;
 export declare function copyLucidCardFieldDisplaySettings(settings: LucidCardFieldDisplaySettings): LucidCardFieldDisplaySettings;
 /** @ignore */
-export declare const serializeLucidCardFieldDisplaySettings: (x: {
-    readonly stencilConfig?: {
-        readonly displayType: FieldDisplayType;
-        readonly backgroundColor?: string | null | undefined;
-        readonly foregroundColor?: string | null | undefined;
-        readonly imageBadgeSettings?: {
-            readonly height: number;
-            readonly width: number;
-        } | null | undefined;
-        readonly valueFormula?: string | null | undefined;
-        readonly tooltipFormula?: string | null | undefined;
-        readonly horizontalPosition?: HorizontalBadgePos | null | undefined;
-        readonly verticalPosition?: VerticalBadgePos | null | undefined;
-        readonly onClickHandlerKey?: OnClickHandlerKeys | null | undefined;
-        readonly linkFormula?: string | null | undefined;
-        readonly textBadgeSettings?: {
-            readonly rounding?: number | null | undefined;
-            readonly bold?: boolean | null | undefined;
-            readonly italic?: boolean | null | undefined;
-            readonly underline?: boolean | null | undefined;
-            readonly minwidth?: number | null | undefined;
-            readonly minheight?: number | null | undefined;
-            readonly maxfontsize?: number | null | undefined;
-            readonly maxtextwidth?: number | null | undefined;
-            readonly iswithinpill?: boolean | null | undefined;
-            readonly hasleadingicon?: boolean | null | undefined;
-        } | null | undefined;
-    } | null | undefined;
-}) => import("../format/objectformat").ObjectFormatSerializedType<{
-    readonly stencilConfig: readonly ["StencilConfig", import("../format/format").Format<import("../format/objectformat").ObjectFormatSerializedType<{
-        /**
-         * How should we generate the stencil/data graphic from the specified field value?
-         * These are registered in LucidCardsLibrary.registerStencilDisplayTypes.
-         *
-         * The serialized key is `getterKey` for backwards compatible, legacy reasons. We have renamed this field in code,
-         * but need to support the original serialized key.
-         */
-        readonly displayType: readonly ["getterKey", import("../format/format").Format<FieldDisplayType, FieldDisplayType>];
-        /**
-         * For displayType values that support it, you may provide an override for the
-         * background color for this data. If this is not provided, the background color
-         * will default to the background color of the card itself, darkened 5%.
-         *
-         * This may be provided as a literal color hex, e.g. "#00ff00ff" or as a formula
-         * by starting the string with "=", e.g. "=darken("#ffffff", 0.5)"
-         */
-        readonly backgroundColor: readonly ["bg", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * For displayType values that support it, you may provide an override for the
-         * foreground color for this data. If this is not provided, the foreground color
-         * will default to grey.
-         *
-         * This may be provided as a literal color hex, e.g. "#00ff00ff" or as a formula
-         * by starting the string with "=", e.g. "=darken("#ffffff", 0.5)"
-         */
-        readonly foregroundColor: readonly ["fg", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * For displayType values that support it, you may provide a height and a width
-         * for the image size. Images are 24px by 24px by default.
-         *
-         */
-        readonly imageBadgeSettings: readonly ["imageBadgeSettings", import("../format/format").Format<import("../format/objectformat").ObjectFormatSerializedType<{
-            readonly height: readonly ["height", import("../format/format").Format<number, number>];
-            readonly width: readonly ["width", import("../format/format").Format<number, number>];
-        }> | null | undefined, {
-            readonly height: number;
-            readonly width: number;
-        } | null | undefined>];
-        /**
-         * If specified, the result of this formula (executed in the context of the data item
-         * associated with this card) will be used instead of the raw field value when
-         * creating the data graphic. This can be useful if, for example, you want to convert
-         * an ID into a URL.
-         */
-        readonly valueFormula: readonly ["f", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * If specified, the result of this formula (executed in the context of the data item
-         * associated with this card) will be used as a tooltip when the user hovers the
-         * cursor over this data graphic.
-         */
-        readonly tooltipFormula: readonly ["t", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * Each display type has its default location on the card. You can override those
-         * default locations by setting these values.
-         */
-        readonly horizontalPosition: readonly ["h", import("../format/format").Format<HorizontalBadgePos | null | undefined, HorizontalBadgePos | null | undefined>];
-        /**
-         * Each display type has its default location on the card. You can override those
-         * default locations by setting these values.
-         */
-        readonly verticalPosition: readonly ["v", import("../format/format").Format<VerticalBadgePos | null | undefined, VerticalBadgePos | null | undefined>];
-        /**
-         * If specified, what behavior should happen when the user clicks on the data graphic
-         * generated via the above displayType?
-         */
-        readonly onClickHandlerKey: readonly ["onClickHandlerKey", import("../format/format").Format<OnClickHandlerKeys | null | undefined, OnClickHandlerKeys | null | undefined>];
-        /**
-         * If onClickHandlerKey is OpenBrowserWindow, this formula calculates the URL to open.
-         */
-        readonly linkFormula: readonly ["l", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * Allows the same card to have multiple textbadges but have different properties.
-         * You can change bold, italic, underline, rounding, minwidth, minheight, maxtextwidth, maxfontsize
-         */
-        readonly textBadgeSettings: readonly ["textBadgeSettings", 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>];
-            readonly italic: readonly ["italic", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
-            readonly underline: readonly ["underline", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
-            readonly minwidth: readonly ["minwidth", import("../format/format").Format<number | null | undefined, number | null | undefined>];
-            readonly minheight: readonly ["minheight", import("../format/format").Format<number | null | undefined, number | null | undefined>];
-            readonly maxfontsize: readonly ["maxfontsize", import("../format/format").Format<number | null | undefined, number | null | undefined>];
-            readonly maxtextwidth: readonly ["maxtextwidth", import("../format/format").Format<number | null | undefined, number | null | undefined>];
-            readonly iswithinpill: readonly ["iswithinpill", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
-            readonly hasleadingicon: readonly ["hasleadingicon", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
-        }> | null | undefined, {
-            readonly rounding?: number | null | undefined;
-            readonly bold?: boolean | null | undefined;
-            readonly italic?: boolean | null | undefined;
-            readonly underline?: boolean | null | undefined;
-            readonly minwidth?: number | null | undefined;
-            readonly minheight?: number | null | undefined;
-            readonly maxfontsize?: number | null | undefined;
-            readonly maxtextwidth?: number | null | undefined;
-            readonly iswithinpill?: boolean | null | undefined;
-            readonly hasleadingicon?: boolean | null | undefined;
-        } | null | undefined>];
-    }> | null | undefined, {
-        readonly displayType: FieldDisplayType;
-        readonly backgroundColor?: string | null | undefined;
-        readonly foregroundColor?: string | null | undefined;
-        readonly imageBadgeSettings?: {
-            readonly height: number;
-            readonly width: number;
-        } | null | undefined;
-        readonly valueFormula?: string | null | undefined;
-        readonly tooltipFormula?: string | null | undefined;
-        readonly horizontalPosition?: HorizontalBadgePos | null | undefined;
-        readonly verticalPosition?: VerticalBadgePos | null | undefined;
-        readonly onClickHandlerKey?: OnClickHandlerKeys | null | undefined;
-        readonly linkFormula?: string | null | undefined;
-        readonly textBadgeSettings?: {
-            readonly rounding?: number | null | undefined;
-            readonly bold?: boolean | null | undefined;
-            readonly italic?: boolean | null | undefined;
-            readonly underline?: boolean | null | undefined;
-            readonly minwidth?: number | null | undefined;
-            readonly minheight?: number | null | undefined;
-            readonly maxfontsize?: number | null | undefined;
-            readonly maxtextwidth?: number | null | undefined;
-            readonly iswithinpill?: boolean | null | undefined;
-            readonly hasleadingicon?: boolean | null | undefined;
-        } | null | undefined;
-    } | null | undefined>];
-}>;
+export declare const serializeLucidCardFieldDisplaySettings: typeof CardFieldDisplaySettingsFormatter.toJson;
 /** @ignore */
-export declare const deserializeLucidCardFieldDisplaySettings: (x: import("../format/objectformat").ObjectFormatSerializedType<{
-    readonly stencilConfig: readonly ["StencilConfig", import("../format/format").Format<import("../format/objectformat").ObjectFormatSerializedType<{
-        /**
-         * How should we generate the stencil/data graphic from the specified field value?
-         * These are registered in LucidCardsLibrary.registerStencilDisplayTypes.
-         *
-         * The serialized key is `getterKey` for backwards compatible, legacy reasons. We have renamed this field in code,
-         * but need to support the original serialized key.
-         */
-        readonly displayType: readonly ["getterKey", import("../format/format").Format<FieldDisplayType, FieldDisplayType>];
-        /**
-         * For displayType values that support it, you may provide an override for the
-         * background color for this data. If this is not provided, the background color
-         * will default to the background color of the card itself, darkened 5%.
-         *
-         * This may be provided as a literal color hex, e.g. "#00ff00ff" or as a formula
-         * by starting the string with "=", e.g. "=darken("#ffffff", 0.5)"
-         */
-        readonly backgroundColor: readonly ["bg", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * For displayType values that support it, you may provide an override for the
-         * foreground color for this data. If this is not provided, the foreground color
-         * will default to grey.
-         *
-         * This may be provided as a literal color hex, e.g. "#00ff00ff" or as a formula
-         * by starting the string with "=", e.g. "=darken("#ffffff", 0.5)"
-         */
-        readonly foregroundColor: readonly ["fg", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * For displayType values that support it, you may provide a height and a width
-         * for the image size. Images are 24px by 24px by default.
-         *
-         */
-        readonly imageBadgeSettings: readonly ["imageBadgeSettings", import("../format/format").Format<import("../format/objectformat").ObjectFormatSerializedType<{
-            readonly height: readonly ["height", import("../format/format").Format<number, number>];
-            readonly width: readonly ["width", import("../format/format").Format<number, number>];
-        }> | null | undefined, {
-            readonly height: number;
-            readonly width: number;
-        } | null | undefined>];
-        /**
-         * If specified, the result of this formula (executed in the context of the data item
-         * associated with this card) will be used instead of the raw field value when
-         * creating the data graphic. This can be useful if, for example, you want to convert
-         * an ID into a URL.
-         */
-        readonly valueFormula: readonly ["f", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * If specified, the result of this formula (executed in the context of the data item
-         * associated with this card) will be used as a tooltip when the user hovers the
-         * cursor over this data graphic.
-         */
-        readonly tooltipFormula: readonly ["t", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * Each display type has its default location on the card. You can override those
-         * default locations by setting these values.
-         */
-        readonly horizontalPosition: readonly ["h", import("../format/format").Format<HorizontalBadgePos | null | undefined, HorizontalBadgePos | null | undefined>];
-        /**
-         * Each display type has its default location on the card. You can override those
-         * default locations by setting these values.
-         */
-        readonly verticalPosition: readonly ["v", import("../format/format").Format<VerticalBadgePos | null | undefined, VerticalBadgePos | null | undefined>];
-        /**
-         * If specified, what behavior should happen when the user clicks on the data graphic
-         * generated via the above displayType?
-         */
-        readonly onClickHandlerKey: readonly ["onClickHandlerKey", import("../format/format").Format<OnClickHandlerKeys | null | undefined, OnClickHandlerKeys | null | undefined>];
-        /**
-         * If onClickHandlerKey is OpenBrowserWindow, this formula calculates the URL to open.
-         */
-        readonly linkFormula: readonly ["l", import("../format/format").Format<string | null | undefined, string | null | undefined>];
-        /**
-         * Allows the same card to have multiple textbadges but have different properties.
-         * You can change bold, italic, underline, rounding, minwidth, minheight, maxtextwidth, maxfontsize
-         */
-        readonly textBadgeSettings: readonly ["textBadgeSettings", 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>];
-            readonly italic: readonly ["italic", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
-            readonly underline: readonly ["underline", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
-            readonly minwidth: readonly ["minwidth", import("../format/format").Format<number | null | undefined, number | null | undefined>];
-            readonly minheight: readonly ["minheight", import("../format/format").Format<number | null | undefined, number | null | undefined>];
-            readonly maxfontsize: readonly ["maxfontsize", import("../format/format").Format<number | null | undefined, number | null | undefined>];
-            readonly maxtextwidth: readonly ["maxtextwidth", import("../format/format").Format<number | null | undefined, number | null | undefined>];
-            readonly iswithinpill: readonly ["iswithinpill", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
-            readonly hasleadingicon: readonly ["hasleadingicon", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
-        }> | null | undefined, {
-            readonly rounding?: number | null | undefined;
-            readonly bold?: boolean | null | undefined;
-            readonly italic?: boolean | null | undefined;
-            readonly underline?: boolean | null | undefined;
-            readonly minwidth?: number | null | undefined;
-            readonly minheight?: number | null | undefined;
-            readonly maxfontsize?: number | null | undefined;
-            readonly maxtextwidth?: number | null | undefined;
-            readonly iswithinpill?: boolean | null | undefined;
-            readonly hasleadingicon?: boolean | null | undefined;
-        } | null | undefined>];
-    }> | null | undefined, {
-        readonly displayType: FieldDisplayType;
-        readonly backgroundColor?: string | null | undefined;
-        readonly foregroundColor?: string | null | undefined;
-        readonly imageBadgeSettings?: {
-            readonly height: number;
-            readonly width: number;
-        } | null | undefined;
-        readonly valueFormula?: string | null | undefined;
-        readonly tooltipFormula?: string | null | undefined;
-        readonly horizontalPosition?: HorizontalBadgePos | null | undefined;
-        readonly verticalPosition?: VerticalBadgePos | null | undefined;
-        readonly onClickHandlerKey?: OnClickHandlerKeys | null | undefined;
-        readonly linkFormula?: string | null | undefined;
-        readonly textBadgeSettings?: {
-            readonly rounding?: number | null | undefined;
-            readonly bold?: boolean | null | undefined;
-            readonly italic?: boolean | null | undefined;
-            readonly underline?: boolean | null | undefined;
-            readonly minwidth?: number | null | undefined;
-            readonly minheight?: number | null | undefined;
-            readonly maxfontsize?: number | null | undefined;
-            readonly maxtextwidth?: number | null | undefined;
-            readonly iswithinpill?: boolean | null | undefined;
-            readonly hasleadingicon?: boolean | null | undefined;
-        } | null | undefined;
-    } | null | undefined>];
-}>) => {
-    readonly stencilConfig?: {
-        readonly displayType: FieldDisplayType;
-        readonly backgroundColor?: string | null | undefined;
-        readonly foregroundColor?: string | null | undefined;
-        readonly imageBadgeSettings?: {
-            readonly height: number;
-            readonly width: number;
-        } | null | undefined;
-        readonly valueFormula?: string | null | undefined;
-        readonly tooltipFormula?: string | null | undefined;
-        readonly horizontalPosition?: HorizontalBadgePos | null | undefined;
-        readonly verticalPosition?: VerticalBadgePos | null | undefined;
-        readonly onClickHandlerKey?: OnClickHandlerKeys | null | undefined;
-        readonly linkFormula?: string | null | undefined;
-        readonly textBadgeSettings?: {
-            readonly rounding?: number | null | undefined;
-            readonly bold?: boolean | null | undefined;
-            readonly italic?: boolean | null | undefined;
-            readonly underline?: boolean | null | undefined;
-            readonly minwidth?: number | null | undefined;
-            readonly minheight?: number | null | undefined;
-            readonly maxfontsize?: number | null | undefined;
-            readonly maxtextwidth?: number | null | undefined;
-            readonly iswithinpill?: boolean | null | undefined;
-            readonly hasleadingicon?: boolean | null | undefined;
-        } | null | undefined;
-    } | null | undefined;
-};
+export declare const deserializeLucidCardFieldDisplaySettings: typeof CardFieldDisplaySettingsFormatter.fromJson;
 /**
  * These are the six possible values for the status of a basic card block.
  */

package/core/cardintegration/cardfielddisplaysettings.js

@@ -100,6 +100,11 @@ var OnClickHandlerKeys;
      * Display a panel on the canvas when a stencil is clicked, showing a list of items related to the stencil field
      */
     OnClickHandlerKeys["ListStencilPanel"] = "ListStencilPanel";
+    /**
+     * @experimental
+     * Open the right-hand card details panel and navigate to a specific target tab
+     */
+    OnClickHandlerKeys["OpenTargetTab"] = "OpenTargetTab";
 })(OnClickHandlerKeys || (exports.OnClickHandlerKeys = OnClickHandlerKeys = {}));
 exports.isOnClickHandlerKey = (0, validators_1.enumValidator)(OnClickHandlerKeys);
 const TextBadgeSettingsFormatter = (0, objectformat_1.ObjectFormat)({
@@ -180,6 +185,11 @@ const StencilConfigFormatter = (0, objectformat_1.ObjectFormat)({
      * If onClickHandlerKey is OpenBrowserWindow, this formula calculates the URL to open.
      */
     linkFormula: ['l', (0, format_1.OptionFormat)(primitiveformat_1.StringFormat)],
+    /**
+     * @experimental
+     * If onClickHandlerKey is OpenTargetTab, this specifies the label of the tab to open.
+     */
+    targetTabLabel: ['targetTabLabel', (0, format_1.OptionFormat)(primitiveformat_1.StringFormat)],
     /**
      * Allows the same card to have multiple textbadges but have different properties.
      * You can change bold, italic, underline, rounding, minwidth, minheight, maxtextwidth, maxfontsize

package/core/cardintegration/cardintegrationautosyncconfig.d.ts

@@ -1,5 +1,5 @@
-import { SerializedFieldType } from '../data/serializedfield/serializedfields';
-import { ExtensionCardFieldDefinition, ImportResult, SearchResult } from '../sharedcardintegration/cardintegrationdefinitions';
+import type { SerializedFieldType } from '../data/serializedfield/serializedfields';
+import type { ExtensionCardFieldDefinition, ImportResult, SearchResult } from '../sharedcardintegration/cardintegrationdefinitions';
 /**
  * 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
@@ -14,7 +14,7 @@ export interface CardIntegrationAutoSyncConfig {
     /**
      * @deprecated Use AutoSyncConfigPhrasesType instead.
      */
-    header: string;
+    header?: string | undefined;
     /**
      * The phrases to use for the auto sync callout. This is used to display the correct strings in the UI.
      */
@@ -67,6 +67,7 @@ export interface AutoSyncConfigPhrasesType {
     removingGrowlMessage?: ((count: number) => string) | undefined;
 }
 export declare enum SupportedAutoSyncGeneratorType {
-    Timeline = "timeline"
+    Timeline = "timeline",
+    DynamicMatrix = "dynamic matrix"
 }
-export declare const isSupportedAutoSyncGeneratorType: (x: unknown) => x is SupportedAutoSyncGeneratorType.Timeline;
+export declare const isSupportedAutoSyncGeneratorType: (x: unknown) => x is SupportedAutoSyncGeneratorType;

package/core/cardintegration/cardintegrationautosyncconfig.js

@@ -11,5 +11,6 @@ exports.AutoSyncPaginationSize = 50;
 var SupportedAutoSyncGeneratorType;
 (function (SupportedAutoSyncGeneratorType) {
     SupportedAutoSyncGeneratorType["Timeline"] = "timeline";
+    SupportedAutoSyncGeneratorType["DynamicMatrix"] = "dynamic matrix";
 })(SupportedAutoSyncGeneratorType || (exports.SupportedAutoSyncGeneratorType = SupportedAutoSyncGeneratorType = {}));
 exports.isSupportedAutoSyncGeneratorType = (0, validators_1.stringEnumValidator)(SupportedAutoSyncGeneratorType);