lucid-extension-sdk 0.0.450 → 0.0.452

package/commandtypes.d.ts

@@ -830,6 +830,8 @@ export type AutoSyncSettings = {
     'p'?: {
         /** Header */
         'h': string;
+        /** Label */
+        'l'?: string | undefined;
         /** query placeholder */
         'qph': string;
         /**remove non matching label */

package/core/cardintegration/cardintegrationautosyncconfig.d.ts

@@ -63,6 +63,10 @@ export interface AutoSyncConfigPhrasesType {
      * The header to display for the integration in the autosync modal.
      */
     header: string;
+    /**
+     * The label to display next to the toggle in the import modal (e.g. WIQL/JQL).
+     */
+    label?: string | undefined;
     /**
      * The query placeholder string to display for the integration. For example, the Jira integration displays "Search with a JQL query..."
      */
@@ -87,9 +91,11 @@ export interface AutoSyncConfigPhrasesType {
 export declare const SupportedAutoSyncGeneratorType: {
     readonly Timeline: "timeline";
     readonly DynamicMatrix: "dynamic matrix";
+    readonly Frame: "frame";
 };
 export type SupportedAutoSyncGeneratorType = (typeof SupportedAutoSyncGeneratorType)[keyof typeof SupportedAutoSyncGeneratorType];
 export declare const isSupportedAutoSyncGeneratorType: (x: unknown) => x is {} extends {
     readonly Timeline: "timeline";
     readonly DynamicMatrix: "dynamic matrix";
-} ? never : "timeline" | "dynamic matrix";
+    readonly Frame: "frame";
+} ? never : "timeline" | "dynamic matrix" | "frame";

package/core/cardintegration/cardintegrationautosyncconfig.js

@@ -11,5 +11,6 @@ exports.AutoSyncPaginationSize = 50;
 exports.SupportedAutoSyncGeneratorType = {
     Timeline: 'timeline',
     DynamicMatrix: 'dynamic matrix',
+    Frame: 'frame',
 };
 exports.isSupportedAutoSyncGeneratorType = (0, validators_1.stringEnumValidator)(exports.SupportedAutoSyncGeneratorType);

package/core/cardintegration/cardintegrationconfig.d.ts

@@ -130,6 +130,7 @@ declare const CardIntegrationConfigFormatter: import("../format/format").Format<
                 } | null | undefined;
             } | null | undefined;
         }> | null | undefined>];
+        readonly supportsParentCards: readonly ["spc", import("../format/format").Format<boolean | null | undefined, boolean | null | undefined>];
     }>, {
         readonly fieldNames: readonly string[];
         readonly fieldStyles?: Map<string, {
@@ -171,6 +172,7 @@ declare const CardIntegrationConfigFormatter: import("../format/format").Format<
                 } | null | undefined;
             } | null | undefined;
         }> | null | undefined;
+        readonly supportsParentCards?: boolean | null | undefined;
     }>];
     readonly cardDetailsPanelConfig: readonly ["cdpc", import("../format/format").Format<import("../format/objectformat").ObjectFormatSerializedType<{
         /**
@@ -255,6 +257,7 @@ declare const CardIntegrationConfigFormatter: import("../format/format").Format<
                 } | null | undefined;
             } | null | undefined;
         }> | null | undefined;
+        readonly supportsParentCards?: boolean | null | undefined;
     };
     readonly cardDetailsPanelConfig: {
         readonly fields: readonly {

package/core/cardintegration/cardintegrationconfig.js

@@ -34,6 +34,7 @@ const CardIntegrationConfigFormatter = (0, objectformat_1.ObjectFormat)({
                 'fd',
                 (0, format_1.OptionFormat)((0, mapformat_1.MapEntriesFormat)(primitiveformat_1.StringFormat, cardfielddisplaysettings_1.CardFieldDisplaySettingsFormatter)),
             ],
+            supportsParentCards: ['spc', (0, format_1.OptionFormat)(primitiveformat_1.BooleanFormat)],
         }),
     ],
     cardDetailsPanelConfig: [

package/core/cardintegration/lucidcardintegrationregistry.js

@@ -343,6 +343,7 @@ class LucidCardIntegrationRegistry {
             if (autoSync.phrases) {
                 serialized['as']['p'] = {
                     'h': autoSync.phrases.header,
+                    'l': autoSync.phrases.label,
                     'qph': autoSync.phrases.queryPlaceholder,
                     'rnml': LucidCardIntegrationRegistry.nextHookName(),
                     'nml': autoSync.phrases.noMatchedLabel,

package/core/checks.d.ts

@@ -134,7 +134,8 @@ export declare function isMap(val: unknown): val is Map<unknown, unknown>;
 export type Tuple<T, N extends number> = N extends N ? (number extends N ? T[] : TupleOfHelper<T, N, []>) : never;
 type TupleOfHelper<T, N extends number, R extends unknown[]> = R['length'] extends N ? R : TupleOfHelper<T, N, [T, ...R]>;
 export declare function isExactLength<T, N extends number>(arr: readonly T[], exactLength: N): arr is Tuple<T, N>;
-export declare function isAtLeastLength<T, N extends number>(arr: readonly T[], minimumLength: N): arr is [...Tuple<T, N>, ...T[]];
+export type ArrayAtLeastLength<T, N extends number> = [...Tuple<T, N>, ...T[]];
+export declare function isAtLeastLength<T, N extends number>(arr: readonly T[], minimumLength: N): arr is ArrayAtLeastLength<T, N>;
 /**
  * Returns true if the specified value is a tuple where the first element, T, passes the tGuard function
  * and the second element, U, passes the uGuard function

package/core/data/datasource/semanticcollection.d.ts

@@ -17,6 +17,11 @@ export declare const SemanticCollection: {
      * This collection contains changes for {@link BranchedCollection}
      */
     readonly Patch: "Patch";
+    /**
+     * This collection is populated by a query (e.g., JQL, WIQL) executed during background sync.
+     * Query collections contain foreign key references to an items collection rather than duplicated data.
+     */
+    readonly Query: "Query";
 };
 export type SemanticCollection = (typeof SemanticCollection)[keyof typeof SemanticCollection];
 export declare const isSemanticCollection: (x: unknown) => x is {} extends {
@@ -33,4 +38,9 @@ export declare const isSemanticCollection: (x: unknown) => x is {} extends {
      * This collection contains changes for {@link BranchedCollection}
      */
     readonly Patch: "Patch";
-} ? never : "Patch" | "Items" | "Metadata";
+    /**
+     * This collection is populated by a query (e.g., JQL, WIQL) executed during background sync.
+     * Query collections contain foreign key references to an items collection rather than duplicated data.
+     */
+    readonly Query: "Query";
+} ? never : "Patch" | "Items" | "Metadata" | "Query";

package/core/data/datasource/semanticcollection.js

@@ -21,5 +21,10 @@ exports.SemanticCollection = {
      * This collection contains changes for {@link BranchedCollection}
      */
     Patch: 'Patch',
+    /**
+     * This collection is populated by a query (e.g., JQL, WIQL) executed during background sync.
+     * Query collections contain foreign key references to an items collection rather than duplicated data.
+     */
+    Query: 'Query',
 };
 exports.isSemanticCollection = (0, validators_1.enumValidator)(exports.SemanticCollection);

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

@@ -42,6 +42,7 @@ export declare const isSerializedDataSourceProperties: (subject: unknown) => sub
             ShowOnlyIfHasInward: (x: unknown) => x is boolean | null | undefined;
             SkipOutwardRelationships: (x: unknown) => x is boolean | null | undefined;
             ShowOnlyIfHasOutward: (x: unknown) => x is boolean | null | undefined;
+            SuppressLinkedItems: (x: unknown) => x is string | null | undefined;
         }>> | undefined;
     }>[] | null | undefined;
 }>;

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

@@ -83,6 +83,7 @@ export declare const isSerializedImportedDataSource: (subject: unknown) => subje
                 ShowOnlyIfHasInward: (x: unknown) => x is boolean | null | undefined;
                 SkipOutwardRelationships: (x: unknown) => x is boolean | null | undefined;
                 ShowOnlyIfHasOutward: (x: unknown) => x is boolean | null | undefined;
+                SuppressLinkedItems: (x: unknown) => x is string | null | undefined;
             }>> | undefined;
         }>[] | null | undefined;
     }>;
@@ -142,6 +143,7 @@ export declare const isSerializedPreviewData: (subject: unknown) => subject is i
                 ShowOnlyIfHasInward: (x: unknown) => x is boolean | null | undefined;
                 SkipOutwardRelationships: (x: unknown) => x is boolean | null | undefined;
                 ShowOnlyIfHasOutward: (x: unknown) => x is boolean | null | undefined;
+                SuppressLinkedItems: (x: unknown) => x is string | null | undefined;
             }>> | undefined;
         }>[] | null | undefined;
     }>;

package/core/data/datasource/serializedsourceforeignkey.d.ts

@@ -1,8 +1,10 @@
 import { isString } from '../../checks';
 export type SerializedHierarchicalRelationshipFilterConfig = {
     'ShowOnlyIfHasInward'?: boolean | null | undefined;
+    /** @deprecated Use `SuppressLinkedItems` instead */
     'SkipOutwardRelationships'?: boolean | null | undefined;
     'ShowOnlyIfHasOutward'?: boolean | null | undefined;
+    'SuppressLinkedItems'?: string | null | undefined;
 };
 export type SerializedSourceForeignKey = {
     'Id': string;
@@ -30,6 +32,7 @@ export declare const isSerializedHierarchicalRelationshipFilterConfig: (subject:
     ShowOnlyIfHasInward: (x: unknown) => x is boolean | null | undefined;
     SkipOutwardRelationships: (x: unknown) => x is boolean | null | undefined;
     ShowOnlyIfHasOutward: (x: unknown) => x is boolean | null | undefined;
+    SuppressLinkedItems: (x: unknown) => x is string | null | undefined;
 }>>;
 export declare const isSerializedSourceForeignKey: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
     Id: typeof isString;
@@ -41,5 +44,6 @@ export declare const isSerializedSourceForeignKey: (subject: unknown) => subject
         ShowOnlyIfHasInward: (x: unknown) => x is boolean | null | undefined;
         SkipOutwardRelationships: (x: unknown) => x is boolean | null | undefined;
         ShowOnlyIfHasOutward: (x: unknown) => x is boolean | null | undefined;
+        SuppressLinkedItems: (x: unknown) => x is string | null | undefined;
     }>> | undefined;
 }>;

package/core/data/datasource/serializedsourceforeignkey.js

@@ -7,6 +7,7 @@ exports.isSerializedHierarchicalRelationshipFilterConfig = (0, validators_1.part
     'ShowOnlyIfHasInward': (0, validators_1.nullableOption)(checks_1.isBoolean),
     'SkipOutwardRelationships': (0, validators_1.nullableOption)(checks_1.isBoolean),
     'ShowOnlyIfHasOutward': (0, validators_1.nullableOption)(checks_1.isBoolean),
+    'SuppressLinkedItems': (0, validators_1.nullableOption)(checks_1.isString),
 });
 exports.isSerializedSourceForeignKey = (0, validators_1.objectValidator)({
     'Id': checks_1.isString,

package/core/data/datasource/sourceforeignkeys.d.ts

@@ -1,4 +1,34 @@
 import type { SerializedHierarchicalRelationshipFilterConfig, SerializedSourceForeignKey } from './serializedsourceforeignkey';
+export declare const SuppressLinkedItems: {
+    /**
+     * Suppress only the outward direction of this relationship in the linked items panel.
+     * "Outward" means items that this item points to via the source field
+     * (e.g. a parent item that stores a list of child IDs — the children are outward).
+     * The inward direction (items that point back to this item) remains visible.
+     *
+     * Use this when items on one end of the relationship should show the relationship
+     * in the linked items panel, but items on the other end should not.
+     */
+    readonly Outward: "outward";
+    /**
+     * Suppress only the inward direction of this relationship in the linked items panel.
+     * "Inward" means items that point to this item via their own source field
+     * (i.e. items for which this item appears in their outward lookup).
+     * The outward direction (items this item points to) remains visible.
+     */
+    readonly Inward: "inward";
+    /**
+     * Suppress both directions of this relationship in the linked items panel.
+     * Neither the items this item points to (outward) nor the items that point
+     * to this item (inward) will appear in the linked items panel.
+     *
+     * Use this when the relationship is already represented elsewhere in your UI
+     * (e.g. a dedicated parent/child hierarchy view) and should not also appear
+     * as a linked item.
+     */
+    readonly Both: "both";
+};
+export type SuppressLinkedItems = (typeof SuppressLinkedItems)[keyof typeof SuppressLinkedItems];
 /**
  * Optional configuration for filtering hierarchical relationships.
  */
@@ -10,8 +40,8 @@ export type HierarchicalRelationshipFilterConfig = {
      */
     showOnlyIfHasInward?: boolean;
     /**
+     * @deprecated Use `suppressLinkedItems` instead.
      * If true, skip outward relationships in linked items display.
-     * Example: ADO "Child" FK should not show children on parent cards.
      */
     skipOutwardRelationships?: boolean;
     /**
@@ -20,6 +50,21 @@ export type HierarchicalRelationshipFilterConfig = {
      * but is filtered out on parent cards (parent has no outward "parent" field).
      */
     showOnlyIfHasOutward?: boolean;
+    /**
+     * Controls which directions of this foreign key relationship are hidden from
+     * the linked items panel.
+     *
+     * A foreign key has two directions:
+     * - **Outward**: items that the current item points to(it's "children") via its source field.
+     * - **Inward**: items that point to the current item(it's "parent") via their own source field.
+     *
+     * Use `'outward'` to hide outward links while keeping inward links visible.
+     * Use `'inward'` to hide inward links while keeping outward links visible.
+     * Use `'both'` to hide all links for this relationship from the linked items panel.
+     *
+     * When omitted, both directions are shown normally.
+     */
+    suppressLinkedItems?: SuppressLinkedItems;
 };
 export type SourceForeignKey = {
     id: string;

package/core/data/datasource/sourceforeignkeys.js

@@ -1,14 +1,50 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SuppressLinkedItems = void 0;
 exports.serializeHierarchicalFilterConfig = serializeHierarchicalFilterConfig;
 exports.deserializeHierarchicalFilterConfig = deserializeHierarchicalFilterConfig;
 exports.serializeSourceForeignKey = serializeSourceForeignKey;
 exports.deserializeSourceForeignKey = deserializeSourceForeignKey;
+const validators_1 = require("../../validators/validators");
+exports.SuppressLinkedItems = {
+    /**
+     * Suppress only the outward direction of this relationship in the linked items panel.
+     * "Outward" means items that this item points to via the source field
+     * (e.g. a parent item that stores a list of child IDs — the children are outward).
+     * The inward direction (items that point back to this item) remains visible.
+     *
+     * Use this when items on one end of the relationship should show the relationship
+     * in the linked items panel, but items on the other end should not.
+     */
+    Outward: 'outward',
+    /**
+     * Suppress only the inward direction of this relationship in the linked items panel.
+     * "Inward" means items that point to this item via their own source field
+     * (i.e. items for which this item appears in their outward lookup).
+     * The outward direction (items this item points to) remains visible.
+     */
+    Inward: 'inward',
+    /**
+     * Suppress both directions of this relationship in the linked items panel.
+     * Neither the items this item points to (outward) nor the items that point
+     * to this item (inward) will appear in the linked items panel.
+     *
+     * Use this when the relationship is already represented elsewhere in your UI
+     * (e.g. a dedicated parent/child hierarchy view) and should not also appear
+     * as a linked item.
+     */
+    Both: 'both',
+};
+const isSuppressLinkedItems = (0, validators_1.stringEnumValidator)(exports.SuppressLinkedItems);
+function parseSuppressLinkedItems(value) {
+    return value != null && isSuppressLinkedItems(value) ? value : undefined;
+}
 function serializeHierarchicalFilterConfig(config) {
     return {
         'ShowOnlyIfHasInward': config.showOnlyIfHasInward,
         'SkipOutwardRelationships': config.skipOutwardRelationships,
         'ShowOnlyIfHasOutward': config.showOnlyIfHasOutward,
+        'SuppressLinkedItems': config.suppressLinkedItems,
     };
 }
 function deserializeHierarchicalFilterConfig(config) {
@@ -17,6 +53,7 @@ function deserializeHierarchicalFilterConfig(config) {
         showOnlyIfHasInward: (_a = config['ShowOnlyIfHasInward']) !== null && _a !== void 0 ? _a : undefined,
         skipOutwardRelationships: (_b = config['SkipOutwardRelationships']) !== null && _b !== void 0 ? _b : undefined,
         showOnlyIfHasOutward: (_c = config['ShowOnlyIfHasOutward']) !== null && _c !== void 0 ? _c : undefined,
+        suppressLinkedItems: parseSuppressLinkedItems(config['SuppressLinkedItems']),
     };
 }
 function serializeSourceForeignKey(foreignKey) {

package/core/validators/validators.d.ts

@@ -263,6 +263,7 @@ export declare const isPartialSize: (subject: unknown) => subject is Partial<Des
 }>>;
 export declare function isPositiveNumber(x: unknown): x is number;
 export declare function isDate(x: unknown): x is Date;
+export declare function isUrl(x: unknown): x is URL;
 export declare function maxLengthValidator(max: number): (x: unknown) => x is string;
 export declare function minLengthValidator(min: number): (x: unknown) => x is string;
 export declare function isEmptyObject(x: unknown): x is {};

package/core/validators/validators.js

@@ -33,6 +33,7 @@ exports.isTrue = isTrue;
 exports.isFalse = isFalse;
 exports.isPositiveNumber = isPositiveNumber;
 exports.isDate = isDate;
+exports.isUrl = isUrl;
 exports.maxLengthValidator = maxLengthValidator;
 exports.minLengthValidator = minLengthValidator;
 exports.isEmptyObject = isEmptyObject;
@@ -515,6 +516,9 @@ function isPositiveNumber(x) {
 function isDate(x) {
     return x instanceof Date;
 }
+function isUrl(x) {
+    return x instanceof URL;
+}
 function maxLengthValidator(max) {
     return (x) => (0, checks_1.isString)(x) && x.length <= max;
 }

package/package.json

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