@talxis/base-controls 1.2605.1 → 1.2606.2

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="@types/powerapps-component-framework" />
 /// <reference types="react" />
 import { ITheme, ICommandBarProps, ITextFieldProps, ICalloutProps as ICalloutProps$1, IDatePickerProps, ITagPickerProps, IComboBoxProps } from '@talxis/react-components';
-import { DeepPartial, DataType, IDataset, IEventEmitter, IColumn, IAvailableRelatedColumn, IInterceptor, ICommand, AggregationFunction, IRecord, IRawRecord, IAvailableColumnOptions, IRecordSaveOperationResult, IDataProvider, Dataset } from '@talxis/client-libraries';
+import { DeepPartial, DataType, IDataset, IEventEmitter, IColumn, IAvailableRelatedColumn, IInterceptor, ICommand, AggregationFunction, IRecord, IRawRecord, IRecordSaveOperationResult, IAvailableColumnOptions, IDataProvider, Dataset } from '@talxis/client-libraries';
 import { ITheme as ITheme$1, ThemeProviderProps, IShimmerProps, IButtonProps, IMessageBarProps, ITextProps, ILabelProps, IIconProps, ILinkProps, IImageProps, ISpinnerProps, IMessageBar, IToggleProps } from '@fluentui/react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
@@ -891,6 +891,14 @@ declare const lookupTranslations: {
         1033: string;
         1029: string;
     };
+    record: {
+        1033: string;
+        1029: string;
+    };
+    all: {
+        1033: string;
+        1029: string;
+    };
 };
 
 interface ILookup extends IControl<ILookupParameters, ILookupOutputs, Partial<ITranslations<typeof lookupTranslations>>, ITagPickerProps> {
@@ -993,6 +1001,14 @@ declare const useLookup: (props: ILookup) => [ComponentFramework.LookupValue[],
         1033: string;
         1029: string;
     };
+    record: {
+        1033: string;
+        1029: string;
+    };
+    all: {
+        1033: string;
+        1029: string;
+    };
 }>>>, {
     create: (entityName: string) => void;
     select: (record: ComponentFramework.LookupValue[] | undefined) => void;
@@ -1372,6 +1388,7 @@ interface ITaskGridLabels {
     templateCreatedSuccessfully: string;
     description: string;
     noTaskTemplates: string;
+    path: string;
     addChild: string;
     addCustomColumn: string;
     confirmColumnDelete: string;
@@ -1414,21 +1431,6 @@ interface ITaskGridLabels {
     unexpectedErrorOccurred: string;
     deletingUserQueriesError: string;
 }
-interface ILocalizationService<T> {
-    getLocalizedString: (key: keyof T, variables?: {
-        [key: string]: string;
-    }) => string;
-}
-declare class LocalizationService<T extends {
-    [K in keyof T]: string;
-}> implements ILocalizationService<T> {
-    private _getLabels;
-    private _liquidEngine;
-    constructor(getLabels: () => T);
-    getLocalizedString(key: keyof T, variables?: {
-        [key: string]: string;
-    }): string;
-}
 
 interface ISkeletonProps {
     height: string;
@@ -1448,18 +1450,152 @@ interface ITreeNode {
     parent?: IRecord;
 }
 interface IRecordTree {
+    /** Builds (or rebuilds) the node map from the current provider records. Returns the resulting map keyed by record id. */
     build(): Map<string, ITreeNode>;
+    /** Returns the current node map keyed by record id without triggering a rebuild. */
     getNodeMap(): Map<string, ITreeNode>;
+    /** Returns the tree node for the given record id. Pass `null` to get the virtual root node. */
     getNode(recordId: string | null): ITreeNode;
+    /** Returns the total number of unique records in the tree. */
     getTotalCount(): number;
+    /** Returns `true` when the tree is in flat-list mode (no parent-child hierarchy). */
     isFlat(): boolean;
+    /** Returns `true` when the record with the given id has at least one direct child. */
     hasChildren(recordId: string): boolean;
+    /** Returns a map of records that match the current search/filter, keyed by record id. */
     getMatchingRecords(): {
         [recordId: string]: IRecord;
     };
+    /** Returns record ids in their computed display order (depth-first, stack-rank sorted). */
     getSortedIds(): string[];
 }
 
+/** Strategy interface for managing user-defined (dynamic) column definitions. */
+interface ICustomColumnsStrategy {
+    /** @returns The created column name, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
+    onCreateColumn: () => Promise<string | null>;
+    /** @returns The deleted column name, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
+    onDeleteColumn: (columnName: string) => Promise<string | null>;
+    /** @returns The updated column name, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
+    onUpdateColumn: (columnName: string) => Promise<string | null>;
+    /** Fetches/reloads all custom column definitions and returns the resolved `IColumn[]`. */
+    onRefresh: () => Promise<IColumn[]>;
+    /** Returns the currently loaded custom columns synchronously without a network fetch. */
+    onGetColumns: () => IColumn[];
+    /** Fetches the raw records for custom columns. */
+    onGetRawRecords: () => Promise<IRawRecord[]>;
+    /** Fetches a single raw record by its ID. */
+    onGetRawRecord: (recordId: string) => Promise<IRawRecord>;
+    /** Persists a cell value for a custom column on the given record. */
+    onSaveValue: (regardingRecordId: string, column: IColumn, value: any) => Promise<IRecordSaveOperationResult>;
+}
+/** Manages the lifecycle of dynamic (user-defined) columns and wraps the strategy with error handling. */
+interface ICustomColumnsDataProvider {
+    /** EventEmitter for error events raised by column operations. */
+    events: IEventEmitter<ICustomColumnsDataProviderEvents>;
+    /** @returns The created column name, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
+    createColumn: () => Promise<string | null>;
+    /** @returns The deleted column name, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
+    deleteColumn: (columnName: string) => Promise<string | null>;
+    /** @returns The updated column name, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
+    updateColumn: (columnName: string) => Promise<string | null>;
+    /** Refreshes the list of custom columns from the underlying strategy. */
+    refresh: () => Promise<IColumn[]>;
+    /** Returns the currently cached list of custom columns. */
+    getColumns: () => IColumn[];
+    /** Persists a cell value for a custom column on the given record. */
+    saveValue: (regardingRecordId: string, column: IColumn, value: any) => Promise<IRecordSaveOperationResult>;
+    /** Returns the underlying strategy cast to the given type for strategy-specific operations. */
+    getStrategy<T extends ICustomColumnsStrategy>(): T;
+    /** Returns `true` when the given column name is a custom (dynamic) column. */
+    isCustomColumn: (columnName: string) => boolean;
+    /** Disposes event listeners and releases all resources held by the provider. */
+    destroy: () => void;
+}
+interface ICustomColumnsDataProviderEvents {
+    onError: (error: any, message: string) => void;
+}
+
+interface ICreateUserQueryParams {
+    name: string;
+    provider: ITaskDataProvider;
+    description?: string;
+}
+interface ISavedQueryDataProviderEvents {
+    onBeforeUserQueriesDeleted: (queryIds: string[]) => void;
+    onAfterUserQueriesDeleted: (result: IDeletedUserQueriesResult) => void;
+    onBeforeUserQueryUpdated: (queryId: string) => void;
+    onAfterUserQueryUpdated: (result: string | null) => void;
+    onBeforeUserQueryCreated: (queryName: string) => void;
+    onAfterUserQueryCreated: (result: string | null) => void;
+    onError: (error: any, message: string) => void;
+}
+type IDeletedUserQueriesResult = {
+    success: true;
+    deletedQueryIds: string[];
+} | {
+    success: false;
+    deletedQueryIds: string[];
+    errors: {
+        queryId: string;
+        error: any;
+    }[];
+};
+interface ISavedQuery extends ISavedQueryMetadata {
+    id: string;
+    name: string;
+}
+interface ISavedQueryMetadata {
+    columns: IColumn[];
+    sorting?: ComponentFramework.PropertyHelper.DataSetApi.SortStatus[];
+    filtering?: ComponentFramework.PropertyHelper.DataSetApi.FilterExpression;
+    linking?: ComponentFramework.PropertyHelper.DataSetApi.LinkEntityExposedExpression[];
+    isFlatListEnabled?: boolean;
+    searchQuery?: string | undefined;
+    quickFindColumns?: string[];
+}
+/** Strategy interface for loading and persisting system and user-defined saved views (queries). */
+interface ISavedQueryStrategy {
+    /** Returns the built-in (non-deletable) views. At least one system query must be returned. */
+    onGetSystemQueries: () => Promise<ISavedQuery[]>;
+    /** Returns views saved by the current user. */
+    onGetUserQueries: () => Promise<ISavedQuery[]>;
+    /** Deletes the specified user views. Returns a per-query success/failure result. */
+    onDeleteUserQueries: (queryIds: string[]) => Promise<IDeletedUserQueriesResult>;
+    /** @returns The updated query id, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
+    onUpdateUserQuery: (currentQuery: ISavedQuery) => Promise<string | null>;
+    /** @returns The created query id, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
+    onCreateUserQuery: (newQuery: {
+        name: string;
+        description?: string;
+    }, currentQuery: ISavedQuery) => Promise<string | null>;
+}
+/** Manages system and user-defined saved views and exposes view lifecycle operations. */
+interface ISavedQueryDataProvider {
+    /** EventEmitter for saved-query lifecycle events (create, update, delete, errors). */
+    queryEvents: IEventEmitter<ISavedQueryDataProviderEvents>;
+    /** Returns the full list of non-deletable system views. */
+    getSystemQueries: () => ISavedQuery[];
+    /** Returns the full list of user-created views. */
+    getUserQueries: () => ISavedQuery[];
+    /** Returns the currently active saved query. Throws if `refresh` has not been called yet. */
+    getCurrentQuery: () => ISavedQuery;
+    /** Looks up a query by id across system and user queries. Throws if not found. */
+    getSavedQuery(id: string): ISavedQuery;
+    /** @returns The created query id, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
+    createUserQuery: (params: ICreateUserQueryParams) => Promise<string | null>;
+    /** Returns `true` when the given query id belongs to a user view (as opposed to a system view). */
+    isUserQuery: (queryId: string) => boolean;
+    /** @returns The updated query id, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
+    updateUserQuery: (provider: ITaskDataProvider) => Promise<string | null>;
+    /** Deletes the specified user views. Returns a per-query success/failure result. */
+    deleteUserQueries: (queryIds: string[]) => Promise<IDeletedUserQueriesResult>;
+    /** Fetches system and user queries from the strategy and sets the initial active query. */
+    refresh: () => Promise<void>;
+    /** Disposes event listeners and releases all resources held by the provider. */
+    destroy: () => void;
+}
+
 interface IFailedRecord {
     id: string;
     error: any;
@@ -1472,7 +1608,7 @@ type IDeleteTasksResult = {
     deletedTaskIds: string[];
     errors: IFailedRecord[];
 };
-type IEditTasksResult = {
+type IOpenDatasetItemsResult = {
     success: true;
     updatedRecords: IRawRecord[];
 } | {
@@ -1483,8 +1619,7 @@ type IEditTasksResult = {
 /** Strategy interface that handles all data access and mutation operations for tasks. */
 interface ITaskDataProviderStrategy {
     /**
-     * Called once on first load. Must return the initial columns, raw task records, and provider metadata.
-     * An empty `ids` array instructs the strategy to fetch all records.
+     * Called when the provider needs to retrieve latest data for specific tasks to synchronize the grid with the server.
      */
     onGetRawRecords: (ids: string[]) => Promise<IRawRecord[]>;
     /** Called once on first load. Must return the initial columns, raw task records, and entity metadata. */
@@ -1497,8 +1632,6 @@ interface ITaskDataProviderStrategy {
     onGetAvailableColumns: (options?: IAvailableColumnOptions) => Promise<IColumn[]>;
     /** Returns linked-entity columns that can be used for filtering and sorting. */
     onGetAvailableRelatedColumns: () => Promise<IAvailableRelatedColumn[]>;
-    /** Returns the attribute names that are searched when the user types in the quick-find input. */
-    onGetQuickFindColumns: () => string[];
     /** @returns The created task raw record, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
     onCreateTask(parentTaskId?: string): Promise<IRawRecord | null>;
     /**
@@ -1512,27 +1645,16 @@ interface ITaskDataProviderStrategy {
     /** @returns The created task raw records, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
     onCreateTasksFromTemplate(templateId: string, parentTaskId?: string): Promise<IRawRecord[] | null>;
     /**
-     * @returns Result indicating which tasks were updated and which failed, or `null` if the operation was cancelled by the user.
-     * `success: true` means all tasks were updated. `success: false` means some or all failed.
-     * Throws on unexpected failure.
+     * Opens one or more dataset items. When `isTaskEntity` is `true` the references point to task records;
+     * when `false` they point to a related entity (e.g. a lookup target).
      */
-    onEditTasks(taskIds: string[]): Promise<IEditTasksResult | null>;
+    onOpenDatasetItems(entityReferences: ComponentFramework.EntityReference[], isTaskEntity: boolean): Promise<IOpenDatasetItemsResult | null>;
     /** Moves a task to a new position relative to another task. Returns the updated raw records, or `null` on cancellation. */
     onMoveTask(movingTaskId: string, movingToTaskId: string, position: 'above' | 'below' | 'child'): Promise<IRawRecord[] | null>;
     /** Persists inline cell edits for the given record. */
     onRecordSave(record: IRecord): Promise<IRecordSaveOperationResult>;
     /** Returns whether the given task record is currently active (non-completed). */
     onIsRecordActive(recordId: string): boolean;
-    /** Opens the record detail view. Called when a user clicks a non-subject cell. */
-    onOpenDatasetItem(entityReference: ComponentFramework.EntityReference, context?: {
-        columnName?: string;
-    }): void;
-    /** Return `false` to disable task creation (hide the *New* button). Defaults to `true`. */
-    onIsTaskAddingEnabled?(): boolean;
-    /** Return `false` to disable inline cell editing. Defaults to `true`. */
-    onIsTaskEditingEnabled?(): boolean;
-    /** Return `false` to disable task deletion (hide the *Delete* button). Defaults to `true`. */
-    onIsTaskDeletingEnabled?(): boolean;
     /** When provided, the task tree is scoped to the subtree of the returned task id. */
     onGetRootTaskId?: () => string | undefined;
 }
@@ -1545,10 +1667,10 @@ interface ITaskDataProviderEventListener {
     onAfterTasksCreated: (records: IRawRecord[] | null, parentId?: string) => void;
     onBeforeTaskMoved: () => void;
     onAfterTaskMoved: (movingFromTaskId: string, movingToTaskId: string, position: 'above' | 'below' | 'child') => void;
-    onBeforeTasksEdited: (taskIds: string[]) => void;
     onTaskDataUpdated: (data: IRawRecord[]) => void;
-    onAfterTasksEdited: (result: IEditTasksResult | null) => void;
     onRecordTreeUpdated: (updatedParentIds: (string | undefined)[]) => void;
+    onBeforeDatasetItemsOpened: (entityReferences: ComponentFramework.EntityReference[], isTaskEntity: boolean) => void;
+    onAfterDatasetItemsOpened: (entityReferences: ComponentFramework.EntityReference[], isTaskEntity: boolean, result: IOpenDatasetItemsResult | null) => void;
     onError: (error: any, message: string) => void;
 }
 /** Extended data provider interface for task records. Adds task-specific operations on top of `IDataProvider`. */
@@ -1568,11 +1690,10 @@ interface ITaskDataProvider extends IDataProvider {
     /** Applies updated raw record data in-place and rebuilds the tree if hierarchy changed. */
     updateTaskData(newData: IRawRecord[]): void;
     /**
-     * @returns Result indicating which tasks were updated and which failed, or `null` if the operation was cancelled by the user.
-     * `success: true` means all tasks were updated. `success: false` means some or all failed — `updatedRecords` still contains the records that succeeded.
-     * Throws on unexpected failure.
+     * Opens one or more task records by id. Builds entity references from the current records map
+     * and delegates to `strategy.onOpenDatasetItems` with `isTaskEntity: true`.
      */
-    editTasks(taskIds: string[]): Promise<IEditTasksResult | null>;
+    openTaskItems(taskIds: string[]): Promise<IOpenDatasetItemsResult | null>;
     /** @returns The created task raw record, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
     createTask(parentTaskId?: string): Promise<IRawRecord | null>;
     /**
@@ -1588,11 +1709,6 @@ interface ITaskDataProvider extends IDataProvider {
     /** Returns `true` when the grid is displaying a flat list instead of a tree hierarchy. */
     isFlatListEnabled(): boolean;
     /** Returns `true` when task creation is allowed (from `ITaskDataProviderStrategy.onIsTaskAddingEnabled`). */
-    isTaskAddingEnabled(): boolean;
-    /** Returns `true` when inline cell editing is allowed (from `ITaskDataProviderStrategy.onIsTaskEditingEnabled`). */
-    isTaskEditingEnabled(): boolean;
-    /** Returns `true` when task deletion is allowed (from `ITaskDataProviderStrategy.onIsTaskDeletingEnabled`). */
-    isTaskDeletingEnabled(): boolean;
     /** Returns the root task id when the tree is scoped to a subtree, or `null` for a full tree. */
     getRootTaskId: () => string | null;
     /** Moves a task to a position relative to another task. Returns the updated raw records, or `null` on cancellation. */
@@ -1610,12 +1726,6 @@ interface IGridCustomizerStrategy {
     onGetColumnDefinitions?: (columnDefs: ColDef[]) => ColDef[];
     /** Receives the default row class rules map and may return an extended or overridden version. */
     onGetRowClassRules?: (rules: RowClassRules) => RowClassRules;
-    /** Return a custom cell renderer component for the given column definition, or `undefined` to use the default. */
-    onGetCellRenderer?: (colDef: ColDef) => any;
-    /** Return a custom cell editor component for the given column definition, or `undefined` to use the default. */
-    onGetCellEditor?: (colDef: ColDef) => any;
-    /** Receives the raw AG Grid `GridApi` instance, useful if the strategy needs to retain a reference. */
-    onRetrieveGridApi?: (gridApi: GridApi) => void;
 }
 /** Provides access to the AG Grid instance and the TaskGrid control to code running inside `IGridCustomizerStrategy`. */
 interface IGridCustomizer {
@@ -1632,125 +1742,6 @@ interface IGridCustomizer {
     registerExpressionDecorator(columnName: string, registrator: () => void): void;
 }
 
-/** Strategy interface for managing user-defined (dynamic) column definitions. */
-interface ICustomColumnsStrategy {
-    /** @returns The created column name, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
-    onCreateColumn: () => Promise<string | null>;
-    /** @returns The deleted column name, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
-    onDeleteColumn: (columnName: string) => Promise<string | null>;
-    /** @returns The updated column name, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
-    onUpdateColumn: (columnName: string) => Promise<string | null>;
-    /** Fetches/reloads all custom column definitions and returns the resolved `IColumn[]`. */
-    onRefresh: () => Promise<IColumn[]>;
-    /** Returns the currently loaded custom columns synchronously without a network fetch. */
-    onGetColumns: () => IColumn[];
-}
-/** Manages the lifecycle of dynamic (user-defined) columns and wraps the strategy with error handling. */
-interface ICustomColumnsDataProvider {
-    /** EventEmitter for error events raised by column operations. */
-    events: IEventEmitter<ICustomColumnsDataProviderEvents>;
-    /** @returns The created column name, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
-    createColumn: () => Promise<string | null>;
-    /** @returns The deleted column name, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
-    deleteColumn: (columnName: string) => Promise<string | null>;
-    /** @returns The updated column name, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
-    updateColumn: (columnName: string) => Promise<string | null>;
-    /** Refreshes the list of custom columns from the underlying strategy. */
-    refresh: () => Promise<IColumn[]>;
-    /** Returns the currently cached list of custom columns. */
-    getColumns: () => IColumn[];
-    /** Returns the underlying strategy cast to the given type for strategy-specific operations. */
-    getStrategy<T extends ICustomColumnsStrategy>(): T;
-    /** Returns `true` when the given column name is a custom (dynamic) column. */
-    isCustomColumn: (columnName: string) => boolean;
-    destroy: () => void;
-}
-interface ICustomColumnsDataProviderEvents {
-    onError: (error: any, message: string) => void;
-}
-
-interface ICreateUserQueryParams {
-    name: string;
-    provider: ITaskDataProvider;
-    description?: string;
-}
-interface ISavedQueryDataProviderEvents {
-    onBeforeUserQueriesDeleted: (queryIds: string[]) => void;
-    onAfterUserQueriesDeleted: (result: IDeletedUserQueriesResult) => void;
-    onBeforeUserQueryUpdated: (queryId: string) => void;
-    onAfterUserQueryUpdated: (result: string | null) => void;
-    onBeforeUserQueryCreated: (queryName: string) => void;
-    onAfterUserQueryCreated: (result: string | null) => void;
-    onError: (error: any, message: string) => void;
-}
-type IDeletedUserQueriesResult = {
-    success: true;
-    deletedQueryIds: string[];
-} | {
-    success: false;
-    deletedQueryIds: string[];
-    errors: {
-        queryId: string;
-        error: any;
-    }[];
-};
-interface ISavedQuery extends ISavedQueryMetadata {
-    id: string;
-    name: string;
-}
-interface ISavedQueryMetadata {
-    columns: IColumn[];
-    sorting?: ComponentFramework.PropertyHelper.DataSetApi.SortStatus[];
-    filtering?: ComponentFramework.PropertyHelper.DataSetApi.FilterExpression;
-    linking?: ComponentFramework.PropertyHelper.DataSetApi.LinkEntityExposedExpression[];
-    isFlatListEnabled?: boolean;
-    searchQuery?: string | undefined;
-}
-/** Strategy interface for loading and persisting system and user-defined saved views (queries). */
-interface ISavedQueryStrategy {
-    /** Returns the built-in (non-deletable) views. At least one system query must be returned. */
-    onGetSystemQueries: () => Promise<ISavedQuery[]>;
-    /** Returns views saved by the current user. */
-    onGetUserQueries: () => Promise<ISavedQuery[]>;
-    /** Deletes the specified user views. Returns a per-query success/failure result. */
-    onDeleteUserQueries: (queryIds: string[]) => Promise<IDeletedUserQueriesResult>;
-    /** @returns The updated query id, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
-    onUpdateUserQuery: (currentQuery: ISavedQuery) => Promise<string | null>;
-    /** @returns The created query id, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
-    onCreateUserQuery: (newQuery: {
-        name: string;
-        description?: string;
-    }, currentQuery: ISavedQuery) => Promise<string | null>;
-}
-/** Manages system and user-defined saved views and exposes view lifecycle operations. */
-interface ISavedQueryDataProvider {
-    /** EventEmitter for saved-query lifecycle events (create, update, delete, errors). */
-    queryEvents: IEventEmitter<ISavedQueryDataProviderEvents>;
-    /** Returns the full list of non-deletable system views. */
-    getSystemQueries: () => ISavedQuery[];
-    /** Returns the full list of user-created views. */
-    getUserQueries: () => ISavedQuery[];
-    /** Returns the currently active saved query. Throws if `refresh` has not been called yet. */
-    getCurrentQuery: () => ISavedQuery;
-    /** Looks up a query by id across system and user queries. Throws if not found. */
-    getSavedQuery(id: string): ISavedQuery;
-    /** @returns The created query id, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
-    createUserQuery: (params: ICreateUserQueryParams) => Promise<string | null>;
-    /** Returns `true` when the given query id belongs to a user view (as opposed to a system view). */
-    isUserQuery: (queryId: string) => boolean;
-    /** @returns The updated query id, or `null` if the operation was cancelled by the user. Throws on unexpected failure. */
-    updateUserQuery: (provider: ITaskDataProvider) => Promise<string | null>;
-    /** Deletes the specified user views. Returns a per-query success/failure result. */
-    deleteUserQueries: (queryIds: string[]) => Promise<IDeletedUserQueriesResult>;
-    /** Fetches system and user queries from the strategy and sets the initial active query. */
-    refresh: () => Promise<void>;
-    /** Ensures all required native columns (subject, parentId, stackRank, path, stateCode) are present in the provided columns array. */
-    includeRequiredColumns: (columns: IColumn[]) => void;
-    /** Enforces column constraints: subject is never hidden; path column is always read-only. */
-    harmonizeColumns: (columns: IColumn[]) => void;
-    destroy: () => void;
-}
-
 interface ITaskGridState {
     savedQuery?: Partial<ISavedQuery> & {
         id: string;
@@ -1769,7 +1760,7 @@ interface ITaskGridDatasetControlParameters {
     onGetPcfContext: () => ComponentFramework.Context<any>;
 }
 /** Maps functional column roles to the physical attribute (field) names in the consuming entity's schema. */
-interface INativeColumns {
+interface IFieldMapping {
     /** Lookup attribute pointing to the parent task — drives the tree hierarchy. */
     parentId: string;
     /** Display name / title attribute. Always pinned left; never hidden by the control. */
@@ -1778,43 +1769,62 @@ interface INativeColumns {
     stackRank: string;
     /** Active/inactive status attribute. Used by the "Hide inactive tasks" filter. */
     stateCode: string;
-    /** Virtual breadcrumb column. Its value is computed automatically from ancestor names and is never editable. */
+}
+interface INativeColumns extends IFieldMapping {
     path: string;
-    /** (Optional) Numeric completion percentage. When present, rendered with a progress-bar cell renderer. */
-    percentComplete?: string;
 }
 /** Feature flags that control which UI elements are rendered in the grid header and ribbon. */
 interface ITaskGridParameters {
-    /** Explicit CSS height for the grid container. When omitted the grid sizes to fit its parent. */
-    height?: string;
-    /** Show drag handles and allow rows to be dragged for reordering. Defaults to `true`. Automatically suppressed when flat-list mode is active or sorting by a non-stack-rank column. */
+    agGridLicenseKey?: string;
+    /** Show drag handles and allow rows to be dragged for reordering. Defaults to `false`. Automatically suppressed when flat-list mode is active or sorting by a non-stack-rank column. */
     enableRowDragging?: boolean;
-    /** Show the *Edit Columns* button in the ribbon. Defaults to `true`. */
+    /** Show the *Edit Columns* button in the ribbon. Defaults to `false`. */
     enableEditColumns?: boolean;
-    /** Show the search / quick-find input. Defaults to `true`. */
+    /** Enable editing of tasks directly in the grid. Defaults to `false`. */
+    enableTaskEditing?: boolean;
+    /** Enable creation of new tasks. Defaults to `false`. */
+    enableTaskCreation?: boolean;
+    /** Enable deletion of tasks. Defaults to `false`. */
+    enableTaskDeletion?: boolean;
+    /** Show the search / quick-find input. Defaults to `false`. */
     enableQuickFind?: boolean;
-    /** Show the view-switcher dropdown. Defaults to `true`. */
+    /** Show the view-switcher dropdown. Defaults to `false`. */
     enableViewSwitcher?: boolean;
-    /** Show the *Show hierarchy* toggle. Defaults to `true`. */
+    /** Show the *Show hierarchy* toggle. Defaults to `false`. */
     enableShowHierarchyToggle?: boolean;
-    /** Show the *Hide inactive tasks* toggle. Defaults to `true`. */
+    /** Show the *Hide inactive tasks* toggle. Defaults to `false`. */
     enableHideInactiveTasksToggle?: boolean;
-    /** Show the personal/system scope selector inside the Edit Columns panel. Defaults to `true`. */
+    /** Show the personal/system scope selector inside the Edit Columns panel. Defaults to `false`. */
     enableEditColumnsScopeSelector?: boolean;
-    /** Enable user queries. Defaults to `true`. */
+    /** Enable user queries. Defaults to `false`. */
     enableUserQueries?: boolean;
-    /** Show the query manager. Defaults to `true`. */
+    /** Show the query manager. Defaults to `false`. */
     enableQueryManager?: boolean;
-    /** Show the "Save as new" button in the query manager. Defaults to `true`. */
+    /** Show the "Save as new" button in the query manager. Defaults to `false`. */
     enableSaveAsNewQuery?: boolean;
-    /** Show the "Save changes" button in the query manager. Defaults to `true`. */
-    enableSaveChangesToQuery?: boolean;
+    /** Show the "Save changes" button in the query manager. Defaults to `false`. */
+    enableSaveQueryChanges?: boolean;
+    /** Enable creation of custom columns. Defaults to `false`. */
     enableCustomColumnCreation?: boolean;
+    /** Enable editing of custom columns. Defaults to `false`. */
     enableCustomColumnEditing?: boolean;
+    /** Enable deletion of custom columns. Defaults to `false`. */
     enableCustomColumnDeletion?: boolean;
+    /** Enable inline creation of tasks. Defaults to `false`. */
+    enableInlineCreation?: boolean;
+    /** Enable navigation within the grid. Defaults to `false`. */
+    enableNavigation?: boolean;
+    /** Enable column sorting in the grid. Defaults to `false`. */
+    enableSorting?: boolean;
+    /** Enable column filtering in the grid. Defaults to `false`. */
+    enableFiltering?: boolean;
+    /** Override the default row height in pixels. Uses the AG Grid default when omitted. */
+    rowHeight?: number;
 }
 /** Available data providers injected into `ITaskDataProviderStrategy` at construction time. */
 interface ITaskStrategyDeps {
+    enableInlineCreation: boolean;
+    enableTaskEditing: boolean;
     /** Present when the consumer provided `onCreateCustomColumnsStrategy`. */
     customColumnsDataProvider?: ICustomColumnsDataProvider;
     /** Present when the consumer provided `onCreateTemplateDataProvider`. */
@@ -1826,21 +1836,21 @@ interface ITaskStrategyDeps {
  */
 interface ITaskGridDescriptor {
     /** Returns the mapping of logical column roles to physical schema attribute names. */
-    onGetNativeColumns: () => INativeColumns;
+    onGetFieldMapping: () => IFieldMapping;
     /** Returns the strategy responsible for loading system/user views and persisting view changes. */
     onCreateSavedQueryStrategy: () => ISavedQueryStrategy;
     /** Returns the strategy that handles all task CRUD, move, template and record-save operations. */
     onCreateTaskStrategy: (deps: ITaskStrategyDeps) => ITaskDataProviderStrategy;
     /** Returns an `IDataProvider` that drives the user-query creation/update dialog. */
     onCreateUserQueryDataProvider: () => IDataProvider;
+    /** (Optional) Returns the container height as a CSS string. Falls back to a default stretch when omitted. */
+    onGetHeight?: () => string | undefined;
     /** (Optional) Returns the strategy for managing dynamic (user-defined) columns. When provided, the custom-columns feature is enabled. */
     onCreateCustomColumnsStrategy?: () => ICustomColumnsStrategy | undefined;
     /** (Optional) Returns an `IDataProvider` for task templates. When provided, the template-based task creation feature is enabled. */
     onCreateTemplateDataProvider?: () => IDataProvider | undefined;
     /** (Optional) Returns a strategy for deep customization of AG Grid column definitions, renderers, editors, and row class rules. */
     onCreateGridCustomizerStrategy?: () => IGridCustomizerStrategy | undefined;
-    /** (Optional) Returns the AG Grid Enterprise license key. */
-    onGetAgGridLicenseKey?: () => string;
     /** (Optional) Returns a stable DOM/control identifier. Auto-generated as a UUID when omitted. */
     onGetControlId?: () => string;
     /** (Optional) Async hook called before any data provider is created. Use for lazy loading or authentication. */
@@ -1893,13 +1903,23 @@ interface ITaskGridDatasetControl extends IDatasetControl {
     isEditColumnsScopeSelectorEnabled: () => boolean;
     /** Returns `true` when a template data provider was supplied through the descriptor. */
     isTemplatingEnabled: () => boolean;
+    /** Returns `true` when inline creation of tasks is enabled. */
+    isTaskCreatingEnabled: () => boolean;
+    /** Returns `true` when inline editing of tasks is enabled. */
+    isTaskEditingEnabled: () => boolean;
+    /** Returns `true` when task deletion is enabled. */
+    isTaskDeletingEnabled: () => boolean;
+    /** Whether the view-switcher dropdown is visible (from `ITaskGridParameters.enableViewSwitcher`). */
+    isViewSwitcherEnabled: () => boolean;
+    /** Whether grid navigation is enabled (from `ITaskGridParameters.enableNavigation`). */
+    isNavigationEnabled: () => boolean;
     /** Returns `true` when a custom columns strategy was supplied through the descriptor. */
     isCustomColumnsEnabled: () => boolean;
     /** Whether the view manager is enabled (from `ITaskGridParameters.enableQueryManager`). */
     isViewManagerEnabled: () => boolean;
     /** Whether the "Save as new" button is enabled (from `ITaskGridParameters.enableSaveAsNewQuery`). */
     isSaveQueryAsNewEnabled: () => boolean;
-    /** Whether the "Save changes" button is enabled (from `ITaskGridParameters.enableSaveChangesToQuery`). */
+    /** Whether the "Save changes" button is enabled (from `ITaskGridParameters.enableSaveQueryChanges`). */
     isSaveQueryChangesEnabled: () => boolean;
     /** Whether custom column creation is enabled (from `ITaskGridParameters.enableCustomColumnCreation`). */
     isCustomColumnCreationEnabled: () => boolean;
@@ -1909,6 +1929,8 @@ interface ITaskGridDatasetControl extends IDatasetControl {
     isCustomColumnDeletionEnabled: () => boolean;
     /** Whether user queries are enabled (from `ITaskGridParameters.enableUserQueries`). */
     isUserQueriesFeatureEnabled: () => boolean;
+    /** Whether inline task creation is enabled (from `ITaskGridParameters.enableInlineCreation`). */
+    isInlineCreateEnabled: () => boolean;
 }
 
 interface ITaskGridProps {
@@ -1925,10 +1947,10 @@ declare const TaskDataProviderContext: React$1.Context<ITaskDataProvider | null>
 declare const TaskGridComponentsContext: React$1.Context<ITaskGridComponents>;
 declare const TaskGridDescriptorContext: React$1.Context<ITaskGridDescriptor | null>;
 declare const RootElementIdContext: React$1.Context<string>;
-declare const LocalizationServiceContext: React$1.Context<LocalizationService<ITaskGridLabels> | null>;
+declare const LocalizationServiceContext: React$1.Context<ILocalizationService<ITaskGridLabels> | null>;
 declare const AgGridLicenseKeyContext: React$1.Context<string | null>;
 declare const useTaskGridDescriptor: () => ITaskGridDescriptor;
-declare const useLocalizationService: () => LocalizationService<ITaskGridLabels>;
+declare const useLocalizationService: () => ILocalizationService<ITaskGridLabels>;
 declare const useRootElementId: () => string;
 declare const useDatasetControl: () => ITaskGridDatasetControl;
 declare const useTaskGridComponents: () => ITaskGridComponents;
@@ -2090,6 +2112,22 @@ declare class ErrorHelper {
     static getMessageFromError(error: any): string;
 }
 
+interface ILocalizationService<T> {
+    getLocalizedString: (key: keyof T, variables?: {
+        [key: string]: string;
+    }) => string;
+}
+declare class LocalizationService<T extends {
+    [K in keyof T]: string;
+}> implements ILocalizationService<T> {
+    private _labels;
+    private _liquidEngine;
+    constructor(labels: T);
+    getLocalizedString(key: keyof T, variables?: {
+        [key: string]: string;
+    }): string;
+}
+
 interface IOutputs$1 {
     [key: string]: any;
 }
@@ -2200,4 +2238,4 @@ declare const useIsMounted: () => () => boolean;
 
 declare const useIsLoading: <TArgs extends unknown[], TResult>(fn: (...args: TArgs) => Promise<TResult>) => [boolean, (...args: TArgs) => Promise<TResult>];
 
-export { AgGridLicenseKeyContext, BaseControl, BaseControls, ControlTheme, DatasetAdapter, DatasetControl, DatasetControlContext, DateTime, Decimal, Duration, ErrorHelper, Grid, GridCellRenderer, GridInlineRibbon, IBinding, IColorfulOptionSetValueRendererProps, IColorfulOptionValueRendererProps, IComponentProps$1 as IComponentProps, IContext, IControl, IControlController, IControlStates, IDatasetControlComponentProps, IDatasetControlParameters, IDatasetControlProps, IDateTime, IDateTimeOutputs, IDateTimeParameters, IDateTimeProperty, IDecimal, IDecimalNumberProperty, IDecimalOutputs, IDecimalParameters, IDefaultTranslations, IDuration, IDurationOutputs, IDurationParameters, IEntity, IFileProperty, IFileRendererProps, IFluentDesignState, IFooterProps, IGrid, IGridCellRenderer, IGridCellRendererComponentProps, IGridCellRendererParameters, IGridInlineRibbon, IGridOutputs, IGridParameters, IHeaderProps, ILayout, ILookup, ILookupOutputs, ILookupParameters, ILookupProperty, IMetadata, IMultiSelectOptionSet, IMultiSelectOptionSetOutputs, IMultiSelectOptionSetParameters, IMultiSelectOptionSetProperty, INativeColumns, INestedControlRenderer, INestedControlRendererComponentProps, INestedControlRendererParameters, IOptionSet, IOptionSetOutputs, IOptionSetParameters, IOptionSetProperty, IOutputs, IPaginationProps, IParameters, IProperty, IQuickFindProps, IRibbonParameters, IRibbonQuickFindWrapperProps, IStringProperty, ITaskGridDatasetControl, ITaskGridDatasetControlParameters, ITaskGridDescriptor, ITaskGridParameters, ITaskStrategyDeps, ITextField, ITextFieldOutputs, ITextFieldParameters, ITranslation, ITranslations, ITwoOptions, ITwoOptionsOutputs, ITwoOptionsParameters, ITwoOptionsProperty, IValueRendererProps, IWholeNumberProperty, LocalizationServiceContext, Lookup, MultiSelectOptionSet, NestedControlRenderer, OptionSet, PcfContext, RootElementIdContext, TaskDataProviderContext, TaskGrid, TaskGridComponentsContext, TaskGridDescriptorContext, TextField, ThemeWrapper, TwoOptions, VirtualDatasetAdapter, useAgGridLicenseKey, useControl, useControlLabels, useControlSizing, useControlTheme, useControlThemeGenerator, useDatasetControl, useDateTime, useEventEmitter, useFocusIn, useInputBasedControl, useIsLoading, useIsMounted, useLocalizationService, useLookup, useMouseOver, usePcfContext, useRootElementId, useTaskDataProvider, useTaskGridComponents, useTaskGridDescriptor };
+export { AgGridLicenseKeyContext, BaseControl, BaseControls, ControlTheme, DatasetAdapter, DatasetControl, DatasetControlContext, DateTime, Decimal, Duration, ErrorHelper, Grid, GridCellRenderer, GridInlineRibbon, IBinding, IColorfulOptionSetValueRendererProps, IColorfulOptionValueRendererProps, IComponentProps$1 as IComponentProps, IContext, IControl, IControlController, IControlStates, IDatasetControlComponentProps, IDatasetControlParameters, IDatasetControlProps, IDateTime, IDateTimeOutputs, IDateTimeParameters, IDateTimeProperty, IDecimal, IDecimalNumberProperty, IDecimalOutputs, IDecimalParameters, IDefaultTranslations, IDuration, IDurationOutputs, IDurationParameters, IEntity, IFieldMapping, IFileProperty, IFileRendererProps, IFluentDesignState, IFooterProps, IGrid, IGridCellRenderer, IGridCellRendererComponentProps, IGridCellRendererParameters, IGridInlineRibbon, IGridOutputs, IGridParameters, IHeaderProps, ILayout, ILocalizationService, ILookup, ILookupOutputs, ILookupParameters, ILookupProperty, IMetadata, IMultiSelectOptionSet, IMultiSelectOptionSetOutputs, IMultiSelectOptionSetParameters, IMultiSelectOptionSetProperty, INativeColumns, INestedControlRenderer, INestedControlRendererComponentProps, INestedControlRendererParameters, IOptionSet, IOptionSetOutputs, IOptionSetParameters, IOptionSetProperty, IOutputs, IPaginationProps, IParameters, IProperty, IQuickFindProps, IRibbonParameters, IRibbonQuickFindWrapperProps, IStringProperty, ITaskGridDatasetControl, ITaskGridDatasetControlParameters, ITaskGridDescriptor, ITaskGridParameters, ITaskStrategyDeps, ITextField, ITextFieldOutputs, ITextFieldParameters, ITranslation, ITranslations, ITwoOptions, ITwoOptionsOutputs, ITwoOptionsParameters, ITwoOptionsProperty, IValueRendererProps, IWholeNumberProperty, LocalizationService, LocalizationServiceContext, Lookup, MultiSelectOptionSet, NestedControlRenderer, OptionSet, PcfContext, RootElementIdContext, TaskDataProviderContext, TaskGrid, TaskGridComponentsContext, TaskGridDescriptorContext, TextField, ThemeWrapper, TwoOptions, VirtualDatasetAdapter, useAgGridLicenseKey, useControl, useControlLabels, useControlSizing, useControlTheme, useControlThemeGenerator, useDatasetControl, useDateTime, useEventEmitter, useFocusIn, useInputBasedControl, useIsLoading, useIsMounted, useLocalizationService, useLookup, useMouseOver, usePcfContext, useRootElementId, useTaskDataProvider, useTaskGridComponents, useTaskGridDescriptor };