@talxis/base-controls 1.2605.1 → 1.2606.2

package/dist/components/TaskGrid/{data-providers/custom-columns-data-provider/TalxisCustomColumnsDataProviderStrategy.js → extensions/dataverse/DataverseCustomColumnsStrategy.js}

@@ -1,21 +1,48 @@
-import { Attribute, DatasetConstants, Sanitizer, DataTypes, FieldValue } from '@talxis/client-libraries';
+import { DatasetConstants, Attribute, Sanitizer, DataTypes } from '@talxis/client-libraries';
 import { DynamicEntityDefinition } from '@talxis/client-metadata';
 
 const ATTRIBUTE_DEFINITION_ENTITY_NAME = 'talxis_attributedefinition';
 const ATTRIBUTE_VALUE_ENTITY_NAME = 'talxis_attributevalue';
 const CUSTOM_COLUMNS_REFERENED_ENTITY_NAVIGATION_NAME = 'talxis_task_talxis_attributevalue_regardingobjectid';
-class TalxisCustomColumnsStrategy {
+/**
+ * Work-in-progress {@link ICustomColumnsStrategy} implementation for the Dataverse / Talxis platform.
+ *
+ * Dynamic (user-defined) columns are modelled as `talxis_attributedefinition` records.
+ * Column values are stored as `talxis_attributevalue` records linked to the task record.
+ *
+ * WARNING: This strategy is still WIP and should not yet be used in production.
+ *
+ * Pass an instance to the `onCreateCustomColumnsStrategy` hook of your descriptor to enable the
+ * custom-columns feature in the TaskGrid.
+ */
+class DataverseCustomColumnsStrategy {
+    /** @param parameters — see {@link IDataverseCustomColumnsStrategyParameters}. */
     constructor(parameters) {
         this._attributes = [];
         this._attributeIdsMap = new Map();
         this._entityName = parameters.entityName;
         this._recordId = parameters.recordId;
     }
+    /** Fetches the latest `talxis_attributedefinition` records for the entity/record scope and returns them as `IColumn[]`. */
     async onRefresh() {
         const entityDefinition = await DynamicEntityDefinition.fetchForRecord(this._entityName, this._recordId);
         this._attributes = entityDefinition.Attributes;
         return this.onGetColumns();
     }
+    //get all attribute values based given the 
+    async onGetRawRecords() {
+        return [];
+    }
+    async onGetRawRecord(recordId) {
+        throw new Error('Method not implemented.');
+    }
+    getAttributeDefinitionIdFromColumnName(columnName) {
+        return columnName.split(`${DatasetConstants.CUSTOM_COLUMN_NAME_SUFFIX}`)[0];
+    }
+    getNavigationPropertyName() {
+        return CUSTOM_COLUMNS_REFERENED_ENTITY_NAVIGATION_NAME;
+    }
+    /** Returns the currently cached attribute definitions as `IColumn[]` without a network fetch. */
     onGetColumns() {
         return this._attributes.map(attr => {
             const dataType = Attribute.GetDataTypeFromMetadata({ ...attr, attributeDescriptor: attr });
@@ -29,12 +56,14 @@ class TalxisCustomColumnsStrategy {
             };
         });
     }
+    /** Deletes the `talxis_attributedefinition` record backing `columnName`, then refreshes the column list. Returns the deleted column name. */
     async onDeleteColumn(columnName) {
         const id = columnName.split(`${DatasetConstants.CUSTOM_COLUMN_NAME_SUFFIX}`)[0];
         await window.Xrm.WebApi.deleteRecord(ATTRIBUTE_DEFINITION_ENTITY_NAME, id);
         await this.onRefresh();
         return columnName;
     }
+    /** Opens the `talxis_attributedefinition` entity record form in a side dialog. Returns the new column name (with the custom-column suffix) when the record is saved, or `null` when the dialog is dismissed. */
     async onCreateColumn() {
         const { savedEntityReference } = await window.Xrm.Navigation.navigateTo({
             entityName: ATTRIBUTE_DEFINITION_ENTITY_NAME,
@@ -55,6 +84,12 @@ class TalxisCustomColumnsStrategy {
         else
             return null;
     }
+    getExpand() {
+        return `${CUSTOM_COLUMNS_REFERENED_ENTITY_NAVIGATION_NAME}(
+                $select=talxis_serialized_value,talxis_text_value,talxis_int_value,talxis_decimal_value,_talxis_choice_value_value,talxis_bit_value,talxis_date_value,talxis_datetime_userlocal_value,talxis_datetime_tzi_value,_talxis_attributedefinitionid_value
+        )`;
+    }
+    /** Opens the existing `talxis_attributedefinition` record in a side dialog for editing, then refreshes columns. Returns `columnName` unchanged. */
     async onUpdateColumn(columnName) {
         const attributeDefinitionId = columnName.split(`${DatasetConstants.CUSTOM_COLUMN_NAME_SUFFIX}`)[0];
         await window.Xrm.Navigation.navigateTo({
@@ -67,31 +102,26 @@ class TalxisCustomColumnsStrategy {
         await this.onRefresh();
         return columnName;
     }
-    async saveValueToCustomColumn(record) {
-        const dirtyField = record.getFields().find(field => field.isDirty());
-        const column = dirtyField?.getColumn();
-        if (!column?.name.endsWith(DatasetConstants.CUSTOM_COLUMN_NAME_SUFFIX)) {
-            return {
-                success: true,
-                fields: [],
-                recordId: record.getRecordId(),
-            };
-        }
+    /**
+     * Upserts the `talxis_attributevalue` record for the dirty custom-column field on `record`.
+     * Creates a new record when no value exists yet; updates the existing one otherwise.
+     * @returns A save-operation result indicating success or the encountered error.
+     */
+    async onSaveValue(regardingRecordId, column, value) {
         const attributeDefinitionId = column.name.split(`${DatasetConstants.CUSTOM_COLUMN_NAME_SUFFIX}`)[0];
-        const regardingObjectId = record.getRecordId();
-        const attributeValueId = this._attributeIdsMap.get(`${regardingObjectId}_${attributeDefinitionId}`);
+        const attributeValueId = this._attributeIdsMap.get(`${regardingRecordId}_${attributeDefinitionId}`);
         const payload = {
-            [this._getFieldNameForColumn(column)]: this._getValueForPayload(record.getValue(column.name), column),
-            'talxis_serialized_value': this._getSerializedValue(record.getValue(column.name)),
+            [this._getFieldNameForColumn(column)]: this._getValueForPayload(value, column),
+            'talxis_serialized_value': this._getSerializedValue(value),
         };
         try {
             if (!attributeValueId) {
                 const result = await window.Xrm.WebApi.createRecord(ATTRIBUTE_VALUE_ENTITY_NAME, {
                     ...payload,
                     'talxis_attributedefinitionid@odata.bind': `/talxis_attributedefinitions(${attributeDefinitionId})`,
-                    'talxis_regardingobjectid_task@odata.bind': `/tasks(${regardingObjectId})`,
+                    'talxis_regardingobjectid_task@odata.bind': `/tasks(${regardingRecordId})`,
                 });
-                this._attributeIdsMap.set(`${regardingObjectId}_${attributeDefinitionId}`, result.id);
+                this._attributeIdsMap.set(`${regardingRecordId}_${attributeDefinitionId}`, result.id);
                 return {
                     success: true,
                     recordId: result.id,
@@ -121,6 +151,11 @@ class TalxisCustomColumnsStrategy {
             };
         }
     }
+    /**
+     * Resolves the typed value for `column` from the embedded `talxis_attributevalue` collection inside `rawRecord`.
+     * Also caches the `talxis_attributevalueid` for subsequent upsert calls in {@link saveValueToCustomColumn}.
+     * @returns The typed column value, or `null` when no matching attribute value record is found.
+     */
     getValueFromRawRecord(recordId, rawRecord, column) {
         const attribute = this._getAttributeFromRawRecord(recordId, rawRecord, column);
         if (attribute == null) {
@@ -133,7 +168,7 @@ class TalxisCustomColumnsStrategy {
             const option = optionSet.find((option) => option.OptionId == attribute['_talxis_choice_value_value']);
             return option ? option.Value : null;
         }
-        return new FieldValue(attribute[fieldName], column.dataType).getValue();
+        return attribute[fieldName];
     }
     _getAttributeFromRawRecord(recordId, rawRecord, column) {
         const attributes = rawRecord[CUSTOM_COLUMNS_REFERENED_ENTITY_NAVIGATION_NAME] ?? [];
@@ -223,5 +258,5 @@ class TalxisCustomColumnsStrategy {
     }
 }
 
-export { ATTRIBUTE_DEFINITION_ENTITY_NAME, ATTRIBUTE_VALUE_ENTITY_NAME, CUSTOM_COLUMNS_REFERENED_ENTITY_NAVIGATION_NAME, TalxisCustomColumnsStrategy };
-//# sourceMappingURL=TalxisCustomColumnsDataProviderStrategy.js.map
+export { ATTRIBUTE_DEFINITION_ENTITY_NAME, ATTRIBUTE_VALUE_ENTITY_NAME, DataverseCustomColumnsStrategy };
+//# sourceMappingURL=DataverseCustomColumnsStrategy.js.map

package/dist/components/TaskGrid/extensions/dataverse/DataverseCustomColumnsStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataverseCustomColumnsStrategy.js","sources":["../../../../../src/components/TaskGrid/extensions/dataverse/DataverseCustomColumnsStrategy.ts"],"sourcesContent":["import { Attribute, DatasetConstants, DataType, DataTypes, FieldValue, IColumn, IEventEmitter, IRawRecord, IRecord, IRecordSaveOperationResult, Sanitizer } from \"@talxis/client-libraries\";\nimport { DynamicEntityDefinition } from \"@talxis/client-metadata\";\nimport { Attribute as IAttribute } from '@talxis/client-metadata/dist/interfaces/entity/IEntityDefinition';\nimport { ICustomColumnsStrategy } from \"../../providers/custom-columns/CustomColumnsDataProvider\";\n\nexport const ATTRIBUTE_DEFINITION_ENTITY_NAME = 'talxis_attributedefinition';\nexport const ATTRIBUTE_VALUE_ENTITY_NAME = 'talxis_attributevalue';\nconst CUSTOM_COLUMNS_REFERENED_ENTITY_NAVIGATION_NAME = 'talxis_task_talxis_attributevalue_regardingobjectid';\n\n/** Constructor parameters for {@link DataverseCustomColumnsStrategy}. */\ninterface IDataverseCustomColumnsStrategyParameters {\n    /** Logical name of the entity for which dynamic attribute definitions are managed (e.g. `\"task\"`). */\n    entityName: string;\n    /** Optional record ID used to scope attribute definitions to a specific parent record. */\n    recordId?: string;\n}\n\n/**\n * Extends {@link ICustomColumnsStrategy} with Dataverse-specific accessors needed to persist\n * custom column values through the `talxis_attributevalue` entity.\n */\nexport interface IDataverseCustomColumnsStrategy extends ICustomColumnsStrategy {\n    getNavigationPropertyName: () => string;\n    getAttributeDefinitionIdFromColumnName: (columnName: string) => string;\n    /** Returns the `$expand` query parameter needed to fetch the related `talxis_attributevalue` records. */\n    getExpand: () => string;\n    /** Reads and returns the typed value for `column` from the raw attribute-value payload embedded in `rawRecord`. */\n    getValueFromRawRecord: (recordId: string, rawRecord: IRawRecord, column: IColumn) => any;\n}\n\n/**\n * Work-in-progress {@link ICustomColumnsStrategy} implementation for the Dataverse / Talxis platform.\n *\n * Dynamic (user-defined) columns are modelled as `talxis_attributedefinition` records.\n * Column values are stored as `talxis_attributevalue` records linked to the task record.\n *\n * WARNING: This strategy is still WIP and should not yet be used in production.\n *\n * Pass an instance to the `onCreateCustomColumnsStrategy` hook of your descriptor to enable the\n * custom-columns feature in the TaskGrid.\n */\nexport class DataverseCustomColumnsStrategy implements IDataverseCustomColumnsStrategy {\n    private _entityName: string;\n    private _recordId?: string;\n    private _attributes: IAttribute[] = [];\n    private _attributeIdsMap: Map<string, string> = new Map();\n\n    /** @param parameters — see {@link IDataverseCustomColumnsStrategyParameters}. */\n    constructor(parameters: IDataverseCustomColumnsStrategyParameters) {\n        this._entityName = parameters.entityName;\n        this._recordId = parameters.recordId;\n    }\n\n    /** Fetches the latest `talxis_attributedefinition` records for the entity/record scope and returns them as `IColumn[]`. */\n    public async onRefresh(): Promise<IColumn[]> {\n        const entityDefinition = await DynamicEntityDefinition.fetchForRecord(this._entityName, this._recordId);\n        this._attributes = entityDefinition.Attributes;\n        return this.onGetColumns();\n    }\n\n    //get all attribute values based given the \n    public async onGetRawRecords(): Promise<IRawRecord[]> {\n        return [];\n    }\n\n    public async onGetRawRecord(recordId: string): Promise<IRawRecord> {\n        throw new Error('Method not implemented.');\n    }\n\n    public getAttributeDefinitionIdFromColumnName(columnName: string): string {\n        return columnName.split(`${DatasetConstants.CUSTOM_COLUMN_NAME_SUFFIX}`)[0];\n    }\n\n    public getNavigationPropertyName(): string {\n        return CUSTOM_COLUMNS_REFERENED_ENTITY_NAVIGATION_NAME;\n    }\n\n    /** Returns the currently cached attribute definitions as `IColumn[]` without a network fetch. */\n    public onGetColumns(): IColumn[] {\n        return this._attributes.map(attr => {\n            const dataType = Attribute.GetDataTypeFromMetadata({ ...attr as any, attributeDescriptor: attr });\n            return {\n                name: `${attr.LogicalName}${DatasetConstants.CUSTOM_COLUMN_NAME_SUFFIX}`,\n                isVirtual: true,\n                displayName: attr.DisplayName,\n                dataType: dataType,\n                visualSizeFactor: 200,\n                metadata: this._getMetadataForDataType(dataType, attr) as any\n            }\n        })\n    }\n\n    /** Deletes the `talxis_attributedefinition` record backing `columnName`, then refreshes the column list. Returns the deleted column name. */\n    public async onDeleteColumn(columnName: string): Promise<string | null> {\n        const id = columnName.split(`${DatasetConstants.CUSTOM_COLUMN_NAME_SUFFIX}`)[0];\n        await window.Xrm.WebApi.deleteRecord(ATTRIBUTE_DEFINITION_ENTITY_NAME, id);\n        await this.onRefresh();\n        return columnName\n    }\n\n    /** Opens the `talxis_attributedefinition` entity record form in a side dialog. Returns the new column name (with the custom-column suffix) when the record is saved, or `null` when the dialog is dismissed. */\n    public async onCreateColumn(): Promise<string | null> {\n        const { savedEntityReference } = await window.Xrm.Navigation.navigateTo({\n            entityName: ATTRIBUTE_DEFINITION_ENTITY_NAME,\n            pageType: 'entityrecord',\n            data: {\n                'talxis_entityname': this._entityName,\n                'talxis_recordid': this._recordId,\n            }\n        }, {\n            target: 2,\n        });\n        if (savedEntityReference && savedEntityReference.length > 0) {\n            const entityReference = savedEntityReference[0];\n            const id = Sanitizer.Guid.removeGuidBrackets(entityReference.id);\n            await this.onRefresh();\n            return `${id}${DatasetConstants.CUSTOM_COLUMN_NAME_SUFFIX}`;\n        }\n        else return null\n    }\n\n    public getExpand(): string {\n        return `${CUSTOM_COLUMNS_REFERENED_ENTITY_NAVIGATION_NAME}(\n                $select=talxis_serialized_value,talxis_text_value,talxis_int_value,talxis_decimal_value,_talxis_choice_value_value,talxis_bit_value,talxis_date_value,talxis_datetime_userlocal_value,talxis_datetime_tzi_value,_talxis_attributedefinitionid_value\n        )`\n    }\n\n    /** Opens the existing `talxis_attributedefinition` record in a side dialog for editing, then refreshes columns. Returns `columnName` unchanged. */\n    public async onUpdateColumn(columnName: string): Promise<string | null> {\n        const attributeDefinitionId = columnName.split(`${DatasetConstants.CUSTOM_COLUMN_NAME_SUFFIX}`)[0];\n        await window.Xrm.Navigation.navigateTo({\n            entityName: ATTRIBUTE_DEFINITION_ENTITY_NAME,\n            pageType: 'entityrecord',\n            entityId: attributeDefinitionId\n        }, {\n            target: 2,\n        });\n        await this.onRefresh();\n        return columnName;\n    }\n\n    /**\n     * Upserts the `talxis_attributevalue` record for the dirty custom-column field on `record`.\n     * Creates a new record when no value exists yet; updates the existing one otherwise.\n     * @returns A save-operation result indicating success or the encountered error.\n     */\n    public async onSaveValue(regardingRecordId: string, column: IColumn, value: any): Promise<IRecordSaveOperationResult> {\n        const attributeDefinitionId = column.name.split(`${DatasetConstants.CUSTOM_COLUMN_NAME_SUFFIX}`)[0];\n        const attributeValueId = this._attributeIdsMap.get(`${regardingRecordId}_${attributeDefinitionId}`);\n        const payload = {\n            [this._getFieldNameForColumn(column)]: this._getValueForPayload(value, column),\n            'talxis_serialized_value': this._getSerializedValue(value),\n        }\n\n        try {\n\n            if (!attributeValueId) {\n                const result = await window.Xrm.WebApi.createRecord(ATTRIBUTE_VALUE_ENTITY_NAME, {\n                    ...payload,\n                    'talxis_attributedefinitionid@odata.bind': `/talxis_attributedefinitions(${attributeDefinitionId})`,\n                    'talxis_regardingobjectid_task@odata.bind': `/tasks(${regardingRecordId})`,\n                });\n                this._attributeIdsMap.set(`${regardingRecordId}_${attributeDefinitionId}`, result.id);\n                return {\n                    success: true,\n                    recordId: result.id,\n                    fields: [column.name]\n                }\n            }\n\n            else {\n                await window.Xrm.WebApi.updateRecord(ATTRIBUTE_VALUE_ENTITY_NAME, attributeValueId, {\n                    ...payload\n                });\n                return {\n                    success: true,\n                    recordId: attributeValueId,\n                    fields: [column.name]\n                }\n            }\n        }\n        catch (err: any) {\n            return {\n                success: false,\n                recordId: attributeValueId ?? '',\n                fields: [column.name],\n                errors: [{\n                    message: err.message,\n                    fieldName: column.name\n                }]\n            }\n        }\n    }\n\n    /**\n     * Resolves the typed value for `column` from the embedded `talxis_attributevalue` collection inside `rawRecord`.\n     * Also caches the `talxis_attributevalueid` for subsequent upsert calls in {@link saveValueToCustomColumn}.\n     * @returns The typed column value, or `null` when no matching attribute value record is found.\n     */\n    public getValueFromRawRecord(recordId: string, rawRecord: IRawRecord, column: IColumn) {\n        const attribute = this._getAttributeFromRawRecord(recordId, rawRecord, column);\n        if (attribute == null) {\n            return null;\n        }\n        const fieldName = this._getFieldNameForColumn(column);\n\n        if (column.dataType === DataTypes.OptionSet) {\n            const metadata = column.metadata as any;\n            const optionSet = metadata.OptionSet as any;\n            const option = optionSet.find((option: any) => option.OptionId == attribute['_talxis_choice_value_value']);\n            return option ? option.Value : null;\n        }\n        return attribute[fieldName];\n    }\n\n    private _getAttributeFromRawRecord(recordId: string, rawRecord: IRawRecord, column: IColumn) {\n        const attributes: any[] = rawRecord[CUSTOM_COLUMNS_REFERENED_ENTITY_NAVIGATION_NAME] ?? [];\n        if (attributes.length === 0) {\n            return null;\n        }\n        const attributeDefinitionId = column.name.split(`${DatasetConstants.CUSTOM_COLUMN_NAME_SUFFIX}`)[0];\n        const attribute = attributes.find(attr => attr['_talxis_attributedefinitionid_value'] === attributeDefinitionId);\n        if (attribute) {\n            this._attributeIdsMap.set(`${recordId}_${attributeDefinitionId}`, attribute['talxis_attributevalueid']);\n        }\n        return attribute;\n    }\n\n    private _getFieldNameForColumn(column: IColumn): string {\n        switch (column.dataType) {\n            case DataTypes.WholeNone:\n            case DataTypes.WholeDuration:\n            case DataTypes.WholeLanguage:\n            case DataTypes.WholeTimeZone:\n                return 'talxis_int_value';\n            case DataTypes.Decimal:\n                return 'talxis_decimal_value';\n            case DataTypes.OptionSet:\n                return 'talxis_choice_value@odata.bind';\n            case DataTypes.TwoOptions:\n                return 'talxis_bit_value';\n            case DataTypes.DateAndTimeDateOnly:\n                return 'talxis_date_value';\n            case DataTypes.DateAndTimeDateAndTime: {\n                return column.metadata?.Behavior === 3 ? 'talxis_datetime_tzi_value' : 'talxis_datetime_userlocal_value';\n            }\n            default:\n                return 'talxis_text_value';\n        }\n    }\n\n    private _getValueForPayload(value: any, column: IColumn): any {\n        switch (column.dataType) {\n            case 'TwoOptions': {\n                return value == '1' ? true : false;\n            }\n            case 'OptionSet': {\n                const attribute: IAttribute = column.metadata as any;\n                const optionSet = attribute.OptionSet as any;\n                const optionId = optionSet.find((option: any) => option.Value == value)?.OptionId;\n                if (optionId) {\n                    return `/talxis_attributeoptions(${optionId})`;\n                }\n                return null;\n            }\n            case 'DateAndTime.DateAndTime':\n            case 'DateAndTime.DateOnly': {\n                return value;\n            }\n            default: {\n                return value;\n            }\n        }\n    }\n\n    //this is wrong, but it has been developed as part of dynamic attributes like this\n    private _getSerializedValue(value: any) {\n        return JSON.stringify({\n            raw: value,\n            error: false,\n            errorMessage: ''\n        })\n    }\n\n    private _getMetadataForDataType(dataType: DataType, attr: IAttribute) {\n        switch (dataType) {\n            case DataTypes.OptionSet:\n            case DataTypes.TwoOptions: {\n                return {\n                    ...attr,\n                    OptionSet: attr.OptionSet?.Options.map(option => {\n                        return {\n                            Label: option.Label,\n                            Value: option.Value,\n                            Color: option.Color,\n                            OptionId: option.talxis_OptionId\n                        }\n                    })\n                }\n            }\n            default: {\n                return attr;\n            }\n        }\n    }\n}"],"names":[],"mappings":"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"}

package/dist/components/TaskGrid/extensions/dataverse/DataverseGridCustomizerStrategy.d.ts

@@ -0,0 +1,20 @@
+import { ColDef, IGridCustomizer, IGridCustomizerStrategy } from "../../components/grid";
+/**
+ * Ready-to-use {@link IGridCustomizerStrategy} for the Dataverse / Talxis platform.
+ *
+ * Automatically applies custom cell renderers to lookup-many columns (columns whose
+ * `metadata.LookupMany` is set). Returned by {@link DataverseTaskGridDescriptor} by default.
+ *
+ * Extend or replace this class via `onCreateGridCustomizerStrategy` on your descriptor when
+ * you need additional AG Grid column, editor, or row-class customizations.
+ */
+export declare class DataverseGridCustomizerStrategy implements IGridCustomizerStrategy {
+    private _customizer;
+    private _provider?;
+    private _gridApi;
+    /** Stores references to the customizer, task data provider, and grid API. Called once by the internal `GridCustomizer` after the AG Grid instance is ready. */
+    onInitialize(customizer: IGridCustomizer): void;
+    /** Injects the lookup-many {@link CellRenderer} and sets `autoHeight`/non-editable flags for any column whose `metadata.LookupMany` is set. */
+    onGetColumnDefinitions(colDefs: ColDef[]): ColDef[];
+    private _getProvider;
+}

package/dist/components/TaskGrid/extensions/dataverse/DataverseGridCustomizerStrategy.js

@@ -0,0 +1,41 @@
+import { FetchXmlLookupManyCellRenderer } from './lookup-many/cell-renderer/FetchXmlLookupManyCellRenderer.js';
+
+/**
+ * Ready-to-use {@link IGridCustomizerStrategy} for the Dataverse / Talxis platform.
+ *
+ * Automatically applies custom cell renderers to lookup-many columns (columns whose
+ * `metadata.LookupMany` is set). Returned by {@link DataverseTaskGridDescriptor} by default.
+ *
+ * Extend or replace this class via `onCreateGridCustomizerStrategy` on your descriptor when
+ * you need additional AG Grid column, editor, or row-class customizations.
+ */
+class DataverseGridCustomizerStrategy {
+    /** Stores references to the customizer, task data provider, and grid API. Called once by the internal `GridCustomizer` after the AG Grid instance is ready. */
+    onInitialize(customizer) {
+        this._customizer = customizer;
+        this._provider = customizer.getTaskDataProvider();
+        this._gridApi = customizer.getGridApi();
+    }
+    /** Injects the lookup-many {@link CellRenderer} and sets `autoHeight`/non-editable flags for any column whose `metadata.LookupMany` is set. */
+    onGetColumnDefinitions(colDefs) {
+        for (const colDef of colDefs) {
+            const column = this._getProvider().getColumnsMap()[colDef.field];
+            if (column?.metadata?.LookupMany) {
+                colDef.cellRenderer = FetchXmlLookupManyCellRenderer;
+                colDef.autoHeight = true;
+                colDef.editable = false;
+                colDef.suppressKeyboardEvent = () => true;
+            }
+        }
+        return colDefs;
+    }
+    _getProvider() {
+        if (!this._provider) {
+            throw new Error('TaskDataProvider is not available in GridCustomizerStrategy. Have you called onInitialize?');
+        }
+        return this._provider;
+    }
+}
+
+export { DataverseGridCustomizerStrategy };
+//# sourceMappingURL=DataverseGridCustomizerStrategy.js.map

package/dist/components/TaskGrid/extensions/dataverse/DataverseGridCustomizerStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataverseGridCustomizerStrategy.js","sources":["../../../../../src/components/TaskGrid/extensions/dataverse/DataverseGridCustomizerStrategy.ts"],"sourcesContent":["import { ColDef, GridApi, IGridCustomizer, IGridCustomizerStrategy } from \"../../components/grid\";\nimport { ITaskDataProvider } from \"../../providers\";\nimport { FetchXmlLookupManyCellRenderer } from \"./lookup-many/cell-renderer/FetchXmlLookupManyCellRenderer\";\n\n/**\n * Ready-to-use {@link IGridCustomizerStrategy} for the Dataverse / Talxis platform.\n *\n * Automatically applies custom cell renderers to lookup-many columns (columns whose\n * `metadata.LookupMany` is set). Returned by {@link DataverseTaskGridDescriptor} by default.\n *\n * Extend or replace this class via `onCreateGridCustomizerStrategy` on your descriptor when\n * you need additional AG Grid column, editor, or row-class customizations.\n */\nexport class DataverseGridCustomizerStrategy implements IGridCustomizerStrategy {\n    private _customizer!: IGridCustomizer;\n    private _provider?: ITaskDataProvider;\n    private _gridApi!: GridApi;\n\n    /** Stores references to the customizer, task data provider, and grid API. Called once by the internal `GridCustomizer` after the AG Grid instance is ready. */\n    public onInitialize(customizer: IGridCustomizer): void {\n        this._customizer = customizer;\n        this._provider = customizer.getTaskDataProvider();\n        this._gridApi = customizer.getGridApi();\n    }\n\n    /** Injects the lookup-many {@link CellRenderer} and sets `autoHeight`/non-editable flags for any column whose `metadata.LookupMany` is set. */\n    public onGetColumnDefinitions(colDefs: ColDef[]): ColDef[] {\n        for (const colDef of colDefs) {\n            const column = this._getProvider().getColumnsMap()[colDef.field!];\n            if (column?.metadata?.LookupMany) {\n                colDef.cellRenderer = FetchXmlLookupManyCellRenderer;\n                colDef.autoHeight = true;\n                colDef.editable = false;\n                colDef.suppressKeyboardEvent = () => true;\n            }\n        }\n        return colDefs;\n    }\n\n    private _getProvider(): ITaskDataProvider {\n        if (!this._provider) {\n            throw new Error('TaskDataProvider is not available in GridCustomizerStrategy. Have you called onInitialize?');\n        }\n        return this._provider;\n    }\n\n}"],"names":[],"mappings":";;AAIA;;;;;;;;AAQG;MACU,+BAA+B,CAAA;;AAMjC,IAAA,YAAY,CAAC,UAA2B,EAAA;AAC3C,QAAA,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;AAC9B,QAAA,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,mBAAmB,EAAE,CAAC;AAClD,QAAA,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC;KAC3C;;AAGM,IAAA,sBAAsB,CAAC,OAAiB,EAAA;AAC3C,QAAA,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;AAC1B,YAAA,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,KAAM,CAAC,CAAC;AAClE,YAAA,IAAI,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE;AAC9B,gBAAA,MAAM,CAAC,YAAY,GAAG,8BAA8B,CAAC;AACrD,gBAAA,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;AACzB,gBAAA,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;AACxB,gBAAA,MAAM,CAAC,qBAAqB,GAAG,MAAM,IAAI,CAAC;AAC7C,aAAA;AACJ,SAAA;AACD,QAAA,OAAO,OAAO,CAAC;KAClB;IAEO,YAAY,GAAA;AAChB,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;AACjB,YAAA,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;AACjH,SAAA;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;KACzB;AAEJ;;;;"}

package/dist/components/TaskGrid/extensions/dataverse/DataverseSavedQueryStrategy.d.ts

@@ -0,0 +1,49 @@
+import { FetchXmlDataProvider } from "@talxis/client-libraries";
+import { IDeletedUserQueriesResult, ISavedQuery, ISavedQueryStrategy } from "../../providers/saved-query/SavedQueryDataProvider";
+/**
+ * Parameters for constructing a {@link DataverseSavedQueryStrategy}.
+ */
+interface IDataverseSavedQueryStrategyParameters {
+    /** Callback that retrieves the system (shared) saved queries. */
+    onGetSystemQueries: () => Promise<ISavedQuery[]>;
+    /** Logical name of the entity whose queries are managed (used as `talxis_returnedtypecode`). */
+    entityName: string;
+    /** Optional record ID used to scope queries to a specific record (`talxis_recordid`). When omitted, only queries with a null `talxis_recordid` are returned. */
+    recordId?: string;
+    /** Optional owner ID used to filter queries by owner (`ownerid`). */
+    ownerId?: string;
+}
+/**
+ * Ready-to-use {@link ISavedQueryStrategy} implementation for the Dataverse / Talxis platform.
+ *
+ * Persists user-defined saved views as `talxis_userquery` records, optionally scoped to a
+ * specific parent record (`talxis_recordid`) and/or owner (`ownerid`).
+ * System queries are supplied via the `onGetSystemQueries` callback and are never persisted.
+ *
+ * Also acts as an `IDataProvider` (extends `FetchXmlDataProvider`) so it can be passed directly
+ * to the user-query creation dialog.
+ */
+export declare class DataverseSavedQueryStrategy extends FetchXmlDataProvider implements ISavedQueryStrategy {
+    private _recordId?;
+    private _parentEntityName;
+    private _onGetSystemQueries;
+    constructor(parameters: IDataverseSavedQueryStrategyParameters);
+    /** Fetches all `talxis_userquery` records matching the configured entity/record/owner scope and maps them to {@link ISavedQuery}. */
+    onGetUserQueries(): Promise<ISavedQuery[]>;
+    /** Delegates to the `onGetSystemQueries` callback supplied at construction time. */
+    onGetSystemQueries(): Promise<ISavedQuery[]>;
+    /** Deletes the specified `talxis_userquery` records and returns a per-query success/failure result. */
+    onDeleteUserQueries(queryIds: string[]): Promise<IDeletedUserQueriesResult>;
+    /** Serialises the current query metadata (columns, filters, sorting, …) to `talxis_layoutjson` and saves the record. Returns the query ID on success. */
+    onUpdateUserQuery(currentQuery: ISavedQuery): Promise<string | null>;
+    /**
+     * Creates a new `talxis_userquery` record that captures the current grid state (columns, filters, sorting, …).
+     * A deterministic ID is generated with a `00001111` prefix so it sorts predictably alongside Dataverse-native GUIDs.
+     * @returns The new record ID on success.
+     */
+    onCreateUserQuery(newQuery: {
+        name: string;
+        description?: string;
+    }, currentQuery: ISavedQuery): Promise<string | null>;
+}
+export {};

package/dist/components/TaskGrid/{data-providers/saved-query-data-provider/TalxisSavedQueryDataProvider.js → extensions/dataverse/DataverseSavedQueryStrategy.js}

@@ -1,4 +1,5 @@
-import { FetchXmlDataProvider, FetchXmlBuilder } from '@talxis/client-libraries';
+import { FetchXmlDataProvider } from '@talxis/client-libraries';
+import { Liquid } from 'liquidjs';
 import { ErrorHelper } from '../../../../utils/error-handling/ErrorHelper.js';
 
 const FETCH_XML = `
@@ -8,31 +9,44 @@ const FETCH_XML = `
         <attribute name="talxis_name" />
         <attribute name="talxis_description" />
         <attribute name="talxis_layoutjson" />
+        <filter type="and">
+            <condition attribute="talxis_returnedtypecode" operator="eq" value="{{ entityName }}" />
+            {% if ownerId %}
+            <condition attribute="ownerid" operator="eq" value="{{ ownerId }}" />
+            {% endif %}
+            {% if recordId %}
+            <condition attribute="talxis_recordid" operator="eq" value="{{ recordId }}" />
+            {% else %}
+            <condition attribute="talxis_recordid" operator="null" />
+            {% endif %}
+        </filter>
         <order attribute="talxis_name" />
     </entity>
 </fetch>
 `;
-const _getFetchXml = (recordId, ownerId) => {
-    const fetch = FetchXmlBuilder.fetch.fromXml(FETCH_XML);
-    if (recordId || ownerId) {
-        const filter = new FetchXmlBuilder.filter("and");
-        if (recordId) {
-            filter.addCondition(new FetchXmlBuilder.condition("talxis_recordid", FetchXmlBuilder.Operator.Equal, [new FetchXmlBuilder.value(recordId)]));
-        }
-        if (ownerId) {
-            filter.addCondition(new FetchXmlBuilder.condition("ownerid", FetchXmlBuilder.Operator.Equal, [new FetchXmlBuilder.value(ownerId)]));
-        }
-        fetch.entity.addFilter(filter);
-    }
-    return fetch.toXml();
+const LIQUID = new Liquid();
+const _getFetchXml = (entityName, recordId, ownerId) => {
+    return LIQUID.parseAndRenderSync(FETCH_XML, { entityName, recordId, ownerId });
 };
-class TalxisSavedQueryStrategy extends FetchXmlDataProvider {
+/**
+ * Ready-to-use {@link ISavedQueryStrategy} implementation for the Dataverse / Talxis platform.
+ *
+ * Persists user-defined saved views as `talxis_userquery` records, optionally scoped to a
+ * specific parent record (`talxis_recordid`) and/or owner (`ownerid`).
+ * System queries are supplied via the `onGetSystemQueries` callback and are never persisted.
+ *
+ * Also acts as an `IDataProvider` (extends `FetchXmlDataProvider`) so it can be passed directly
+ * to the user-query creation dialog.
+ */
+class DataverseSavedQueryStrategy extends FetchXmlDataProvider {
     constructor(parameters) {
-        const fetchXml = _getFetchXml(parameters.recordId, parameters.ownerId);
+        const fetchXml = _getFetchXml(parameters.entityName, parameters.recordId, parameters.ownerId);
         super({ fetchXml });
+        this._parentEntityName = parameters.entityName;
         this._recordId = parameters.recordId;
         this._onGetSystemQueries = parameters.onGetSystemQueries;
     }
+    /** Fetches all `talxis_userquery` records matching the configured entity/record/owner scope and maps them to {@link ISavedQuery}. */
     async onGetUserQueries() {
         const result = await this.refresh();
         return result.map(r => {
@@ -44,9 +58,11 @@ class TalxisSavedQueryStrategy extends FetchXmlDataProvider {
             };
         });
     }
+    /** Delegates to the `onGetSystemQueries` callback supplied at construction time. */
     async onGetSystemQueries() {
         return this._onGetSystemQueries();
     }
+    /** Deletes the specified `talxis_userquery` records and returns a per-query success/failure result. */
     async onDeleteUserQueries(queryIds) {
         const result = await this.deleteRecords(queryIds);
         if (result.success) {
@@ -63,6 +79,7 @@ class TalxisSavedQueryStrategy extends FetchXmlDataProvider {
             };
         }
     }
+    /** Serialises the current query metadata (columns, filters, sorting, …) to `talxis_layoutjson` and saves the record. Returns the query ID on success. */
     async onUpdateUserQuery(currentQuery) {
         const record = this.getRecordsMap()[currentQuery.id];
         if (!record) {
@@ -76,6 +93,11 @@ class TalxisSavedQueryStrategy extends FetchXmlDataProvider {
         }
         return currentQuery.id;
     }
+    /**
+     * Creates a new `talxis_userquery` record that captures the current grid state (columns, filters, sorting, …).
+     * A deterministic ID is generated with a `00001111` prefix so it sorts predictably alongside Dataverse-native GUIDs.
+     * @returns The new record ID on success.
+     */
     async onCreateUserQuery(newQuery, currentQuery) {
         const userqueryid = `00001111${crypto.randomUUID().substring(8)}`;
         const { name, description } = newQuery;
@@ -85,7 +107,7 @@ class TalxisSavedQueryStrategy extends FetchXmlDataProvider {
             'talxis_layoutjson': JSON.stringify(queryMetadata),
             'talxis_name': name,
             'talxis_description': description,
-            'talxis_returnedtypecode': this.getEntityName(),
+            'talxis_returnedtypecode': this._parentEntityName,
             'talxis_recordid': this._recordId ?? null,
         };
         const result = await window.Xrm.WebApi.createRecord('talxis_userquery', rawData);
@@ -93,5 +115,5 @@ class TalxisSavedQueryStrategy extends FetchXmlDataProvider {
     }
 }
 
-export { TalxisSavedQueryStrategy };
-//# sourceMappingURL=TalxisSavedQueryDataProvider.js.map
+export { DataverseSavedQueryStrategy };
+//# sourceMappingURL=DataverseSavedQueryStrategy.js.map

package/dist/components/TaskGrid/extensions/dataverse/DataverseSavedQueryStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataverseSavedQueryStrategy.js","sources":["../../../../../src/components/TaskGrid/extensions/dataverse/DataverseSavedQueryStrategy.ts"],"sourcesContent":["import { FetchXmlDataProvider } from \"@talxis/client-libraries\";\nimport { Liquid } from \"liquidjs\";\nimport { IDeletedUserQueriesResult, ISavedQuery, ISavedQueryStrategy } from \"../../providers/saved-query/SavedQueryDataProvider\";\nimport { ErrorHelper } from \"../../../../utils/error-handling\";\n\nconst FETCH_XML = `\n<fetch count=\"5000\" page=\"1\">\n    <entity name=\"talxis_userquery\">\n        <attribute name=\"talxis_userqueryid\" />\n        <attribute name=\"talxis_name\" />\n        <attribute name=\"talxis_description\" />\n        <attribute name=\"talxis_layoutjson\" />\n        <filter type=\"and\">\n            <condition attribute=\"talxis_returnedtypecode\" operator=\"eq\" value=\"{{ entityName }}\" />\n            {% if ownerId %}\n            <condition attribute=\"ownerid\" operator=\"eq\" value=\"{{ ownerId }}\" />\n            {% endif %}\n            {% if recordId %}\n            <condition attribute=\"talxis_recordid\" operator=\"eq\" value=\"{{ recordId }}\" />\n            {% else %}\n            <condition attribute=\"talxis_recordid\" operator=\"null\" />\n            {% endif %}\n        </filter>\n        <order attribute=\"talxis_name\" />\n    </entity>\n</fetch>\n`\n\nconst LIQUID = new Liquid();\n\nconst _getFetchXml = (entityName: string, recordId?: string, ownerId?: string) => {\n    return LIQUID.parseAndRenderSync(FETCH_XML, { entityName, recordId, ownerId });\n}\n\n/**\n * Parameters for constructing a {@link DataverseSavedQueryStrategy}.\n */\ninterface IDataverseSavedQueryStrategyParameters {\n    /** Callback that retrieves the system (shared) saved queries. */\n    onGetSystemQueries: () => Promise<ISavedQuery[]>;\n    /** Logical name of the entity whose queries are managed (used as `talxis_returnedtypecode`). */\n    entityName: string;\n    /** Optional record ID used to scope queries to a specific record (`talxis_recordid`). When omitted, only queries with a null `talxis_recordid` are returned. */\n    recordId?: string;\n    /** Optional owner ID used to filter queries by owner (`ownerid`). */\n    ownerId?: string;\n}\n\n/**\n * Ready-to-use {@link ISavedQueryStrategy} implementation for the Dataverse / Talxis platform.\n *\n * Persists user-defined saved views as `talxis_userquery` records, optionally scoped to a\n * specific parent record (`talxis_recordid`) and/or owner (`ownerid`).\n * System queries are supplied via the `onGetSystemQueries` callback and are never persisted.\n *\n * Also acts as an `IDataProvider` (extends `FetchXmlDataProvider`) so it can be passed directly\n * to the user-query creation dialog.\n */\nexport class DataverseSavedQueryStrategy extends FetchXmlDataProvider implements ISavedQueryStrategy {\n    private _recordId?: string;\n    private _parentEntityName: string;\n    private _onGetSystemQueries: () => Promise<ISavedQuery[]>;\n\n    constructor(parameters: IDataverseSavedQueryStrategyParameters) {\n        const fetchXml = _getFetchXml(parameters.entityName, parameters.recordId, parameters.ownerId);\n        super({ fetchXml });\n        this._parentEntityName = parameters.entityName;\n        this._recordId = parameters.recordId;\n        this._onGetSystemQueries = parameters.onGetSystemQueries;\n    }\n\n    /** Fetches all `talxis_userquery` records matching the configured entity/record/owner scope and maps them to {@link ISavedQuery}. */\n    public async onGetUserQueries(): Promise<ISavedQuery[]> {\n        const result = await this.refresh();\n        return result.map(r => {\n            return {\n                id: r.getValue('talxis_userqueryid'),\n                name: r.getValue('talxis_name'),\n                description: r.getValue('talxis_description'),\n                ...JSON.parse(r.getValue('talxis_layoutjson'))\n            }\n        });\n    }\n\n    /** Delegates to the `onGetSystemQueries` callback supplied at construction time. */\n    public async onGetSystemQueries(): Promise<ISavedQuery[]> {\n        return this._onGetSystemQueries();\n    }\n\n    /** Deletes the specified `talxis_userquery` records and returns a per-query success/failure result. */\n    public async onDeleteUserQueries(queryIds: string[]): Promise<IDeletedUserQueriesResult> {\n        const result = await this.deleteRecords(queryIds);\n        if (result.success) {\n            return {\n                success: true,\n                deletedQueryIds: queryIds\n            }\n        }\n        else {\n            return {\n                success: false,\n                deletedQueryIds: result.results.filter(r => r.success).map(r => r.recordId),\n                errors: result.results.filter(r => !r.success).map(r => ({ queryId: r.recordId, error: r.errorMessage }))\n            }\n        }\n    }\n\n    /** Serialises the current query metadata (columns, filters, sorting, …) to `talxis_layoutjson` and saves the record. Returns the query ID on success. */\n    public async onUpdateUserQuery(currentQuery: ISavedQuery): Promise<string | null> {\n        const record = this.getRecordsMap()[currentQuery.id];\n        if (!record) {\n            throw new Error(`Query record with id ${currentQuery.id} not found`);\n        }\n        const { name, id, ...queryMetadata } = currentQuery;\n        record.setValue('talxis_layoutjson', JSON.stringify(queryMetadata));\n        const result = await record.save();\n        if (!result.success) {\n            throw new Error(`Failed to update query with id ${currentQuery.id}: ${ErrorHelper.getMessageFromError(result.errors?.map((e: any) => e.message).join('\\n'))}`);\n        }\n        return currentQuery.id;\n    }\n\n    /**\n     * Creates a new `talxis_userquery` record that captures the current grid state (columns, filters, sorting, …).\n     * A deterministic ID is generated with a `00001111` prefix so it sorts predictably alongside Dataverse-native GUIDs.\n     * @returns The new record ID on success.\n     */\n    public async onCreateUserQuery(newQuery: { name: string; description?: string; }, currentQuery: ISavedQuery): Promise<string | null> {\n        const userqueryid = `00001111${crypto.randomUUID().substring(8)}`;\n        const { name, description } = newQuery;\n        const { id, name: queryName, ...queryMetadata } = currentQuery;\n\n        const rawData = {\n            'talxis_userqueryid': userqueryid,\n            'talxis_layoutjson': JSON.stringify(queryMetadata),\n            'talxis_name': name,\n            'talxis_description': description,\n            'talxis_returnedtypecode': this._parentEntityName,\n            'talxis_recordid': this._recordId ?? null,\n        }\n        const result = await window.Xrm.WebApi.createRecord('talxis_userquery', rawData);\n\n        return result.id;\n    }\n}"],"names":[],"mappings":"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"}

package/dist/components/TaskGrid/extensions/dataverse/DataverseTaskGridDescriptor.d.ts

@@ -0,0 +1,102 @@
+import { IDataProvider, ISingleRecord } from "@talxis/client-libraries";
+import { ICustomColumnsStrategy, ISavedQuery, ISavedQueryStrategy, ITaskDataProviderStrategy } from "../../providers";
+import { IFieldMapping as IFieldMappingBase, ITaskGridDescriptor, ITaskGridParameters, ITaskStrategyDeps } from "../../interfaces";
+import { IGridCustomizerStrategy } from "../../components/grid";
+/** Dataverse-specific field mapping. Extends the base with an optional project lookup column. */
+export interface IFieldMapping extends Omit<IFieldMappingBase, 'stateCode'> {
+    /** Logical name of the lookup attribute that points to the parent project record. Required when `projectRecord` is set on the descriptor. */
+    projectId?: string;
+}
+/** Lightweight entity reference shape used when only logical name + id are available. */
+export interface IEntityRecordReference {
+    entityName: string;
+    id: string;
+}
+/** Input accepted for source/project: either a fully hydrated record or an entity reference. */
+export type RecordInput = IEntityRecordReference | ISingleRecord;
+/** Constructor parameters for {@link DataverseTaskGridDescriptor}. */
+export interface IDataverseTaskGridDescriptorParams {
+    /** FetchXML that drives the initial data load. May use Liquid template variables (e.g. `{{ projectId }}`). */
+    baseFetchXml: string;
+    /** Maps logical entity attribute names to the roles expected by TaskGrid (e.g. `statecode` → `stateCode`). */
+    fieldMapping: IFieldMapping;
+    /** System (non-deletable) views exposed in the view switcher. At least one is required. */
+    systemQueries: ISavedQuery[];
+    /** Optional source record. If provided, it's data will be propagated into liquid fetch XML templates. */
+    sourceRecord?: RecordInput;
+    projectRecord?: RecordInput;
+    height?: string;
+    /** Fine-grained feature flags forwarded to the grid. See {@link ITaskGridParameters}. */
+    gridParameters?: ITaskGridParameters;
+    /** When set, the hierarchy is rooted at this task ID instead of showing all top-level tasks. */
+    rootTaskId?: string;
+    /** ID of the currently logged-in user. Used to scope user queries to the current owner. */
+    userId?: string;
+    /** Form ID to open when editing a single existing task. */
+    editFormId?: string;
+    /** Form ID to open when creating a new task via the dialog flow (non-inline). */
+    createFormId?: string;
+    /** Form ID to open for bulk-editing multiple selected tasks. */
+    bulkEditFormId?: string;
+    /** Set to `true` to enable cascade delete when deleting tasks with children. Defaults to `false`. */
+    enableCascadeDelete?: boolean;
+    /** Set to `true` to allow deletion of tasks that have child tasks. When `false`, such tasks are excluded from deletion and an error is returned. Defaults to `false`. */
+    enableDeletingTasksWithChildren?: boolean;
+}
+/**
+ * Ready-to-use {@link ITaskGridDescriptor} implementation for the Dataverse / Talxis platform.
+ *
+ * Wires together all required strategies — task CRUD, saved queries, grid customization — from
+ * a single constructor parameter object. Pass an instance to `TaskGridDatasetControlFactory.createInstance`.
+ *
+ * @example
+ * ```ts
+ * const descriptor = new DataverseTaskGridDescriptor({
+ *   baseFetchXml: myFetchXml,
+ *   fieldMapping: { parentId: 'talxis_parenttaskid', subject: 'subject', stackRank: 'talxis_stackrank' },
+ *   systemQueries: [myDefaultView],
+ * });
+ * const control = await TaskGridDatasetControlFactory.createInstance({ taskGridDescriptor: descriptor, ... });
+ * ```
+ */
+export declare class DataverseTaskGridDescriptor implements ITaskGridDescriptor {
+    private _fetchXml;
+    private _fieldMapping;
+    private _systemQueries;
+    private _taskEntityName;
+    private _editFormId?;
+    private _createFormId?;
+    private _bulkEditFormId?;
+    private _userId?;
+    private _rootTaskId?;
+    private _projectRecord?;
+    private _sourceRecord?;
+    private _params;
+    private _gridParameters?;
+    private _height?;
+    private _onInitialize;
+    /** @param params — see {@link IDataverseTaskGridDescriptorParams} for full documentation of each option. */
+    constructor(params: {
+        onInitialize: () => Promise<IDataverseTaskGridDescriptorParams>;
+        height?: string;
+    });
+    /** Resolves the project entity reference (fetches display name when not supplied). Called once by the factory before any strategy is created. */
+    onLoadDependencies(): Promise<void>;
+    /** Returns the field mapping with `stateCode` hard-coded to `"statecode"` (standard Dataverse attribute name). */
+    onGetFieldMapping(): IFieldMappingBase;
+    onGetHeight(): string | undefined;
+    /** Returns a {@link DataverseSavedQueryStrategy} when `enableUserQueries` is `true`, otherwise a read-only stub that exposes only the system queries. */
+    onCreateSavedQueryStrategy(): ISavedQueryStrategy;
+    onCreateCustomColumnsStrategy(): ICustomColumnsStrategy | undefined;
+    /** Returns a {@link DataverseTaskStrategy} configured with the descriptor's FetchXML, form IDs, and project reference. */
+    onCreateTaskStrategy(deps: ITaskStrategyDeps): ITaskDataProviderStrategy;
+    /** Returns a {@link DataverseSavedQueryStrategy} pre-configured as a data provider for the user-query creation/update dialog, with `talxis_name` and `talxis_description` columns. */
+    onCreateUserQueryDataProvider(): IDataProvider;
+    /** Returns the feature flags supplied at construction time, or an empty object (all features enabled) when omitted. */
+    onGetGridParameters(): ITaskGridParameters;
+    /** Returns a {@link DataverseGridCustomizerStrategy} that adds lookup-many cell renderers for columns whose name ends with the lookup-many suffix. */
+    onCreateGridCustomizerStrategy(): IGridCustomizerStrategy;
+    private _getProjectRecord;
+    private _getSourceRecord;
+    private _getTaskEntityNameFromFetchXml;
+}