@epam/statgpt-conversation-view 0.4.0-rc.9 → 0.4.1

package/components/AdvancedView/TableSettings/AgGridColumnPanel/helpers/columnPanelMapping.d.ts

@@ -0,0 +1,50 @@
+import { ColDef, GridApi } from 'ag-grid-community';
+import { DraggableListNode } from '../../../../../../../ui-components/src/index';
+import { ColumnPanelFilter } from '../types';
+/**
+ * Default predicate that includes a column in the panel when it has a non-empty
+ * label and has not been suppressed via `suppressColumnsToolPanel`.
+ *
+ * @param label - Resolved display label for the column.
+ * @param colDef - AG Grid column definition for the column.
+ */
+export declare const DEFAULT_INCLUDE_COLUMN: ColumnPanelFilter;
+/**
+ * Returns the stable identifier for a column definition, preferring `colId` over `field`.
+ *
+ * @param def - AG Grid column definition to extract the identifier from.
+ * @returns The column id string, or `null` if neither `colId` nor `field` is set.
+ */
+export declare function getColId(def: ColDef): string | null;
+/**
+ * Resolves the human-readable label for a column definition, falling back through
+ * `headerName`, `field`, and `colId` in that order.
+ *
+ * @param def - AG Grid column definition to extract the label from.
+ */
+export declare function getColLabel(def: ColDef): string;
+/**
+ * Builds a map from column id to its current AG Grid column state.
+ *
+ * @param api - AG Grid API instance used to retrieve the current column state.
+ * @returns A `Map` keyed by `colId` with the corresponding column state as the value.
+ */
+export declare function buildColumnStateMap(api: GridApi): Map<string, import('ag-grid-community').ColumnState>;
+/**
+ * Converts the grid's column definitions into draggable panel items sorted by
+ * the current column order, applying the provided filter to exclude columns.
+ *
+ * @param api - AG Grid API instance used to read column definitions and state.
+ * @param includeColumn - Predicate that determines whether a column should appear in the panel.
+ */
+export declare function mapColumnsToPanelItems(api: GridApi, includeColumn: ColumnPanelFilter): DraggableListNode[];
+/**
+ * Merges a reordered subset of column ids back into the full column order,
+ * replacing each included position with the next id from the reordered subset
+ * while leaving excluded column positions unchanged.
+ *
+ * @param fullOrder - The complete list of all column ids in their current order.
+ * @param includedOrder - The reordered ids for only the columns that are included in the panel.
+ * @param includedSet - A set of column ids that belong to the included subset, used for fast lookup.
+ */
+export declare function mergeIncludedOrderIntoFullOrder(fullOrder: string[], includedOrder: string[], includedSet: Set<string>): string[];

package/components/AdvancedView/TableSettings/AgGridColumnPanel/helpers/columnStateSnapshot.d.ts

@@ -0,0 +1,16 @@
+import { GridApi } from 'ag-grid-community';
+import { AgGridInitialColumnsState } from '../types';
+/**
+ * Reads the current column and column-group state from an AG Grid instance and returns it as a snapshot.
+ *
+ * @param api - The AG Grid API instance to read column state from.
+ * @returns A snapshot containing both column state and column group state.
+ */
+export declare function captureInitialColumnsState(api: GridApi): AgGridInitialColumnsState;
+/**
+ * Applies a previously captured column state snapshot back to an AG Grid instance.
+ *
+ * @param api - The AG Grid API instance to restore column state on.
+ * @param initialState - The snapshot to restore; does nothing when absent or null.
+ */
+export declare function restoreInitialColumnsState(api: GridApi, initialState?: AgGridInitialColumnsState | null): void;

package/components/AdvancedView/TableSettings/AgGridColumnPanel/helpers/draggableListUtils.d.ts

@@ -0,0 +1,34 @@
+import { DraggableListItemNode, DraggableListNode } from '../../../../../../../ui-components/src/index';
+/**
+ * Traverses a tree of draggable list nodes along a path of IDs and returns the item node at the end.
+ *
+ * @param nodes - The top-level array of nodes to start traversal from.
+ * @param path - Ordered sequence of node IDs representing the path to the target item.
+ * @returns The item node found at the given path, or `undefined` if any segment is missing or the final node is not an item.
+ */
+export declare function getItemNodeByPath(nodes: DraggableListNode[], path: readonly string[]): DraggableListItemNode | undefined;
+/**
+ * Ensures the last visible leaf item inside every named group of an enriched
+ * draggable list item cannot be unchecked, preventing a column group from
+ * becoming completely empty.
+ *
+ * A leaf is considered visible when `isChecked` is not explicitly `false`.
+ * When exactly one visible leaf remains in a group, the visible leaf is
+ * returned with `checkable: false`, and all item leaves in that group are
+ * returned with `draggable: false`. Groups with zero or two or more visible
+ * leaves are left unchanged.
+ *
+ * @param item - A top-level draggable list item node, potentially containing
+ *   named group sub-nodes with leaf items.
+ * @returns A new item node with the last-visible-leaf protection applied, or
+ *   the original node if no protection is needed.
+ */
+export declare function protectLastVisibleLeafInGroups(item: DraggableListItemNode): DraggableListItemNode;
+/**
+ * Recursively collects IDs of all leaf item nodes from a draggable list tree.
+ *
+ * @param nodes - The array of nodes to flatten.
+ * @param isLeaf - Optional predicate that marks a node as a leaf, stopping further descent into its children.
+ * @returns A flat array of IDs for all resolved leaf item nodes in depth-first order.
+ */
+export declare function flattenIncludedLeafIds(nodes: DraggableListNode[], isLeaf?: (node: DraggableListItemNode) => boolean): string[];

package/components/AdvancedView/TableSettings/AgGridColumnPanel/hooks/useAgGridColumnGridListeners.d.ts

@@ -0,0 +1,6 @@
+import { GridApi } from 'ag-grid-community';
+/**
+ * Registers AG Grid column-change event listeners on the provided grid API and cleans them up on unmount,
+ * invoking the given callback whenever column visibility, order, pinning, or structure changes.
+ */
+export declare function useAgGridColumnGridListeners(api: GridApi | null | undefined, listener: () => void): void;

package/components/AdvancedView/TableSettings/AgGridColumnPanel/{useAgGridColumnPreferences.d.ts → hooks/useAgGridColumnPreferences.d.ts}

@@ -1,5 +1,10 @@
 import { GridApi } from 'ag-grid-community';
-import { AgGridInitialColumnsState } from './types';
+import { AgGridInitialColumnsState } from '../types';
+/**
+ * Manages per-URN AG Grid column state, capturing the initial column layout on
+ * grid ready and restoring any user-applied column preferences when the active
+ * URN changes.
+ */
 export declare function useAgGridColumnPreferences({ currentUrn, }: {
     currentUrn: string;
 }): {

package/components/AdvancedView/TableSettings/AgGridColumnPanel/{useAgGridColumnsPanel.d.ts → hooks/useAgGridColumnsPanel.d.ts}

@@ -1,11 +1,18 @@
-import { DraggableListItemNode, DraggableListNode, ItemClickEvent, ToggleCheckedEvent, ToggleExpandedEvent } from '../../../../../../ui-components/src/index';
-import { ColumnPanelFilter } from './types';
+import { DraggableListItemNode, DraggableListNode, ItemClickEvent, ToggleCheckedEvent, ToggleExpandedEvent } from '../../../../../../../ui-components/src/index';
+import { ColumnPanelFilter } from '../types';
 import { GridApi } from 'ag-grid-community';
-export declare function useAgGridColumnsPanel({ api, searchQuery, includeColumn, enrichItem, }: {
+/**
+ * Manages column panel state for an AG Grid instance, deriving a draggable item
+ * tree from the grid's column state and returning handlers for toggling visibility,
+ * reordering columns, and expanding or collapsing grouped entries.
+ */
+export declare function useAgGridColumnsPanel({ api, searchQuery, includeColumn, enrichItem, onSubItemOrderChange, onSubItemVisibilityChange, }: {
     api: GridApi | null;
     searchQuery: string;
     includeColumn?: ColumnPanelFilter;
     enrichItem?: (item: DraggableListItemNode) => DraggableListItemNode;
+    onSubItemOrderChange?: (urn: string, colId: string, order: string[]) => void;
+    onSubItemVisibilityChange?: (urn: string, colId: string, dimensionKey: string, hidden: boolean) => void;
 }): {
     items: DraggableListNode[];
     visibleItems: DraggableListNode[];

package/components/AdvancedView/TableSettings/helpers/crossDatasetEnrichment.d.ts

@@ -0,0 +1,44 @@
+import { DraggableListItemNode } from '../../../../../../ui-components/src/index';
+import { DatasetDimensionsScheme, DimensionConfig, StructuralData } from '../../../../../../sdmx-toolkit/src/index';
+import { DimensionCustomizationMap, DimensionKeyCustomization } from '../types';
+/**
+ * Column IDs that can be enriched with per-dataset group nodes.
+ * Pass a subset as `enrichedColIds` to limit which columns get the grouped sub-items treatment.
+ */
+export declare const ALL_AGGREGATED_COL_IDS: ReadonlySet<string>;
+/**
+ * Default set of columns that receive the grouped sub-items treatment.
+ * Only the indicator column is enriched by default; country and frequency
+ * columns show a flat value without internal dimension breakdown.
+ */
+export declare const DEFAULT_ENRICHED_COL_IDS: ReadonlySet<string>;
+interface CrossDatasetColumnsInfo {
+    dataQueries: Array<{
+        urn: string;
+    }>;
+    structuresMap: Map<string, StructuralData | undefined>;
+    getDimensionsScheme: (urn: string) => DatasetDimensionsScheme | undefined;
+    getDimensionConfig: (urn: string, dimKey: string) => DimensionConfig | undefined;
+    locale: string;
+    dimensionCustomization?: DimensionCustomizationMap;
+    enrichedColIds?: ReadonlySet<string>;
+}
+/**
+ * Applies ordering and hidden-key filtering from a customization record to a list of dimension keys.
+ *
+ * @param dimensionKeys - The original ordered list of dimension keys for a column.
+ * @param custom - Optional customization describing explicit ordering and a set of keys to hide.
+ * @returns A reordered and filtered array of dimension keys.
+ */
+export declare function applyDimensionKeyCustomization(dimensionKeys: string[], custom: DimensionKeyCustomization | undefined): string[];
+/**
+ * Returns a mapping function that enriches an aggregated draggable list item with
+ * per-dataset dimension sub-items and group nodes derived from cross-dataset structural data.
+ *
+ * @param info - Context containing data queries, structural metadata, dimension scheme resolvers,
+ *   locale, and optional dimension customizations used to build child groups.
+ * @returns A function that transforms a `DraggableListItemNode`, replacing aggregated column
+ *   items with nested group/leaf nodes; non-aggregated items are returned unchanged.
+ */
+export declare function buildCrossDatasetEnrichItem(info: CrossDatasetColumnsInfo): (item: DraggableListItemNode) => DraggableListItemNode;
+export {};

package/components/AdvancedView/TableSettings/helpers/dimensionSubItemId.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Builds a composite sub-item identifier by joining a URN and a dimension key with a separator.
+ *
+ * @param urn - The URN of the parent dimension item.
+ * @param dimensionKey - The key that identifies the specific sub-item within the dimension.
+ * @returns A string combining the URN and dimension key, suitable for use as a unique sub-item ID.
+ */
+export declare function buildDimensionSubItemId(urn: string, dimensionKey: string): string;
+/**
+ * Returns whether the given ID was produced by `buildDimensionSubItemId` and encodes a sub-item.
+ *
+ * @param id - The ID string to test.
+ * @returns `true` when the ID contains the sub-item separator, `false` otherwise.
+ */
+export declare function isDimensionSubItemId(id: string): boolean;
+/**
+ * Splits a composite sub-item ID created by `buildDimensionSubItemId` back into its parts.
+ *
+ * @param id - A sub-item ID previously produced by `buildDimensionSubItemId`.
+ * @returns An object containing the original `urn` and `dimensionKey` encoded in the ID.
+ */
+export declare function parseDimensionSubItemId(id: string): {
+    urn: string;
+    dimensionKey: string;
+};

package/components/AdvancedView/TableSettings/types.d.ts

@@ -0,0 +1,5 @@
+export type DimensionKeyCustomization = {
+    order: string[];
+    hidden: Set<string>;
+};
+export type DimensionCustomizationMap = Map<string, Map<string, DimensionKeyCustomization>>;

package/components/Attachments/GridCellRenderers/helpers/get-external-link-from-context.d.ts

@@ -0,0 +1 @@
+export declare function getExternalLinkFromContext(context: unknown, urn: string | undefined): string | undefined;

package/index.d.ts

@@ -23,3 +23,4 @@ export { ConversationViewSidePanelProvider, useConversationViewSidePanelOptional
 export type { ConversationViewSidePanelConfig, ConversationViewSidePanelScope, } from './components/ConversationView/SidePanel/ConversationViewSidePanelContext';
 export { ConversationViewFeatureTogglesProvider, useConversationViewFeatureToggles, } from './context/ConversationViewFeatureTogglesContext';
 export type { ConversationViewFeatureToggles } from './context/ConversationViewFeatureTogglesContext';
+export { CrossDatasetAttachmentsProvider, useCrossDatasetAttachments, } from './context/CrossDatasetAttachmentsContext';