@epam/statgpt-conversation-view 0.4.1 → 0.4.2

package/models/actions.d.ts

@@ -1,4 +1,4 @@
-import { GetAttachmentContent, GetAttachmentBlob, GetBucket, GetDatasetData, GetDatasetDetails, UpdateConversation, getConstraints, CreateConversation, RateResponse, PutOnboardingFile, PutFile } from '../types/actions';
+import { GetAttachmentContent, GetAttachmentBlob, GetBucket, GetDatasetData, GetDatasetDetails, UpdateConversation, getConstraints, CreateConversation, RateResponse, PutOnboardingFile, PutFile, GetPythonAttachment } from '../types/actions';
 import { DataQuery } from '../../../shared-toolkit/src/index';
 import { Dataflow } from '../../../sdmx-toolkit/src/index';
 import { DownloadDatasetAction } from '../../../download-panel/src/types/actions';
@@ -14,6 +14,7 @@ export interface AttachmentsActions {
     updateCurrentDataQuery: (dataQuery?: DataQuery) => void;
     updateDataQueries: (dataQueries?: DataQuery[]) => void;
     updateDatasets: (datasets?: Dataflow[]) => void;
+    getPythonAttachment?: GetPythonAttachment;
 }
 export type ConversationViewActions = AttachmentsActions & {
     getConversation: GetConversation;

package/models/attachments-styles.d.ts

@@ -18,8 +18,11 @@ export interface AttachmentsStyles {
     columnsTitle?: string;
     columnsResetTitle?: string;
     closeTitle?: string;
+    infoDownloadIcon?: ReactNode;
     successDownloadIcon?: ReactNode;
     errorDownloadIcon?: ReactNode;
+    downloadInProgressActionIcon?: ReactNode;
+    downloadErrorActionIcon?: ReactNode;
     datasetIcon?: ReactNode;
     isDisplayDatasetIcon?: boolean;
     isDownloadDescriptionVisible?: boolean;

package/models/attachments.d.ts

@@ -19,6 +19,7 @@ export interface CrossDatasetGridAttachmentType extends Attachment {
 }
 export interface CustomChartAttachmentType extends Attachment {
     charting_data?: ChartingData;
+    getChartingData?: () => ChartingData;
 }
 export interface CustomCodeAttachment extends Attachment {
     language?: string;

package/models/charting.d.ts

@@ -9,6 +9,7 @@ export interface ChartUnit extends ChartUnitRows {
     dimensions: DimensionInfo[];
     limitedByRowsAmountTo: number | undefined;
 }
+export type ChartUnitValue = ChartUnit | (() => ChartUnit);
 export interface ChartUnitGroup {
     title?: string;
     units: ChartUnit[];

package/models/filters.d.ts

@@ -94,7 +94,7 @@ export interface FiltersProps {
     attachmentsDataQuery?: DataQuery;
     dataQueries?: DataQuery[];
     onFiltersChange?: (filterParams: DatasetQueryFilters, constraints: DataConstraints[], modalFilters?: Filter[]) => void;
-    onMultipleDataFiltersChange?: (filterParamsMap: Map<string, DatasetQueryFilters>, constraintsMap?: Map<string, DataConstraints[] | undefined>, dataQueries?: DataQuery[]) => void;
+    onMultipleDataFiltersChange?: (filterParamsMap: Map<string, DatasetQueryFilters>, constraintsMap?: Map<string, DataConstraints[] | undefined>, dataQueries?: DataQuery[], filtersMap?: Map<string, Filter[]>, filters?: Filter[]) => void;
     locale?: string;
     timeRangeOptions?: TimeRangeOptions[];
     titles?: ConversationViewTitles;

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@epam/statgpt-conversation-view",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "license": "MIT",
   "dependencies": {
     "classnames": "^2.5.1",
     "@epam/ai-dial-shared": "^0.43.3",
     "@tabler/icons-react": "^3.34.1",
-    "@epam/statgpt-shared-toolkit": "0.4.1",
-    "@epam/statgpt-ui-components": "0.4.1",
-    "@epam/statgpt-sdmx-toolkit": "0.4.1",
+    "@epam/statgpt-shared-toolkit": "0.4.2",
+    "@epam/statgpt-ui-components": "0.4.2",
+    "@epam/statgpt-sdmx-toolkit": "0.4.2",
     "react-window": "^1.8.11",
     "react-virtualized-auto-sizer": "^1.0.26",
     "ag-grid-community": "33.3.2",
@@ -16,10 +16,10 @@
     "@floating-ui/react": "^0.27.14",
     "echarts": "^5.6.0",
     "echarts-for-react": "^3.0.2",
-    "@epam/statgpt-dial-toolkit": "0.4.1",
+    "@epam/statgpt-dial-toolkit": "0.4.2",
     "react-markdown": "^10.1.0",
     "remark-gfm": "^4.0.1",
-    "@epam/statgpt-conversation-list": "0.4.1",
+    "@epam/statgpt-conversation-list": "0.4.2",
     "flatpickr": "4.6.13",
     "react-flatpickr": "^4.0.11",
     "date-fns": "^4.1.0",

package/types/actions.d.ts

@@ -1,6 +1,6 @@
 import { GridAttachmentContent, UpdateConversationRequest } from '../../../dial-toolkit/src/index';
 import { DataMessage, DatasetQueryFilters, SdmxReferences, SeriesFilterDto, StructuralMetaData } from '../../../sdmx-toolkit/src/index';
-import { OnboardingFileSchema, TimeRange } from '../../../shared-toolkit/src/index';
+import { DataQuery, OnboardingFileSchema, TimeRange } from '../../../shared-toolkit/src/index';
 import { Conversation, ConversationInfo, Entity } from '@epam/ai-dial-shared';
 export type GetAttachmentContent = (fileId: string) => Promise<GridAttachmentContent | null>;
 export type GetAttachmentBlob = (fileId: string) => Promise<Blob>;
@@ -15,3 +15,6 @@ export type getConstraints = (urn: string, filters?: SeriesFilterDto[], timeRang
 export type RateResponse = (id: string, rate: boolean, deploymentId: string) => Promise<void>;
 export type PutOnboardingFile = (fileName: string, filePath: string, fileData: OnboardingFileSchema) => Promise<Entity | null>;
 export type PutFile = (filePath: string, file: Blob) => Promise<void>;
+export type GetPythonAttachment = (queries: DataQuery[]) => Promise<{
+    python_code: string;
+} | null>;

package/utils/attachments/attachment-parser.d.ts

@@ -12,3 +12,4 @@ export declare function isChartAttachment(attachment: Attachment): boolean;
 export declare function isCustomCodeSampleAttachment(attachment: Attachment): boolean;
 export declare function isCrossDatasetGrid(attachment: Attachment): boolean;
 export declare function isAnyGridAttachment(attachment: Attachment): boolean;
+export declare function hasPythonCodeAttachment(attachments?: Attachment[]): boolean;

package/utils/attachments/attachments-data.d.ts

@@ -3,5 +3,5 @@ import { DataConstraints, DatasetQueryFilters } from '../../../../sdmx-toolkit/s
 import { getConstraints, GetDatasetData, GetDatasetDetails } from '../../types/actions';
 import { DatasetData, StructureDataMaps } from '../../models/structure-data';
 export declare const getDataConstraintsMap: (dataQueries: DataQuery[], getConstraintsAction: getConstraints) => Promise<Map<string, DataConstraints[]>>;
-export declare const getStructureDataMaps: (dataQueries: DataQuery[], getDataSetAction: GetDatasetDetails, getDataSetDataAction: GetDatasetData, setIsLoadingGridData: (isLoading: boolean) => void) => Promise<StructureDataMaps>;
+export declare const getStructureDataMaps: (dataQueries: DataQuery[], getDataSetAction: GetDatasetDetails, getDataSetDataAction: GetDatasetData, setIsLoadingGridData: (isLoading: boolean) => void, getFilterParamsMap?: (structureDataMaps: StructureDataMaps) => Map<string, DatasetQueryFilters> | undefined | Promise<Map<string, DatasetQueryFilters> | undefined>) => Promise<StructureDataMaps>;
 export declare const getDataSetData: (dataQuery: DataQuery, filterParams: DatasetQueryFilters, getDataSetDataAction: GetDatasetData) => Promise<DatasetData>;

package/utils/attachments/charting/chart-data.d.ts

@@ -4,5 +4,6 @@ import { ChartingStyles } from '../../../models/attachments-styles';
 import { GridData } from '../../../types/data-grid/grid-data';
 import { ChartingData, ChartUnit, ChartUnitRows } from '../../../models/charting';
 export declare function buildChartData(structures: StructuralData, data: DataMessage, dataQuery: DataQuery | undefined, locale: string, styles?: ChartingStyles): ChartingData;
+export declare function createChartDataResolver(structures: StructuralData, data: DataMessage, dataQuery: DataQuery | undefined, locale: string, styles?: ChartingStyles): () => ChartingData;
 export declare function buildSingleLineUnit(row: GridData, sortedTimePeriods: string[], structures: StructuralData, dataQuery: DataQuery | undefined, locale: string, styles?: ChartingStyles): ChartUnit;
 export declare function buildUnit(unit: ChartUnitRows, structures: StructuralData, dataQuery: DataQuery | undefined, timePeriods: string[], locale: string, styles?: ChartingStyles): ChartUnit;

package/utils/attachments/charting/cross-dataset-chart-data.d.ts

@@ -0,0 +1,6 @@
+import { DataMessage, StructuralData } from '../../../../../sdmx-toolkit/src/index';
+import { DataQuery } from '../../../../../shared-toolkit/src/index';
+import { ChartingData } from '../../../models/charting';
+import { ChartingStyles } from '../../../models/attachments-styles';
+export declare function createCrossDatasetChartingDataResolver(structuresMap: Map<string, StructuralData | undefined>, dataMessagesMap: Map<string, DataMessage | null>, dataQueries: DataQuery[], locale: string, chartStyles?: ChartingStyles): () => ChartingData;
+export declare function buildCrossDatasetChartingData(structuresMap: Map<string, StructuralData | undefined>, dataMessagesMap: Map<string, DataMessage | null>, dataQueries: DataQuery[], locale: string, chartStyles?: ChartingStyles): ChartingData;

package/utils/attachments/data-grid/rows-data.d.ts

@@ -2,4 +2,8 @@ import { DataMessage, StructuralData } from '../../../../../sdmx-toolkit/src/ind
 import { DataQuery } from '../../../../../shared-toolkit/src/index';
 import { GridData } from '../../../types/data-grid/grid-data';
 import { ChartingStyles } from '../../../models/attachments-styles';
-export declare function getRowsData(data: DataMessage, structures: StructuralData, dataQuery: DataQuery | undefined, locale: string, chartStyles?: ChartingStyles): GridData[];
+interface GetRowsDataOptions {
+    includeChartData?: boolean;
+}
+export declare function getRowsData(data: DataMessage, structures: StructuralData, dataQuery: DataQuery | undefined, locale: string, chartStyles?: ChartingStyles, options?: GetRowsDataOptions): GridData[];
+export {};

package/utils/attachments/python-attachment.d.ts

@@ -0,0 +1,26 @@
+import { RefObject } from 'react';
+import { Attachment } from '@epam/ai-dial-shared';
+import { DataQuery } from '../../../../shared-toolkit/src/index';
+import { CustomCodeAttachment } from '../../models/attachments';
+import { GetPythonAttachment } from '../../types/actions';
+/**
+ * Calls the python attachment API with stale-request protection and applies
+ * the result to local state and the persisted conversation.
+ *
+ * @param options.getPythonAttachment - Action that fetches refreshed python code for the given queries.
+ * @param options.dataQueries - Dataset queries (with merged UI filters) to pass to the API.
+ * @param options.requestIdRef - Ref counter used to discard responses from superseded requests.
+ * @param options.codeTitle - Title for the `CUSTOM_CODE_SAMPLE` attachment shown in the UI.
+ * @param options.markdownTitle - Title for the raw markdown attachment written back to the conversation.
+ * @param options.setCodeAttachments - State setter that replaces the current code attachment list.
+ * @param options.onCodeAttachmentUpdated - Optional callback to persist the updated markdown attachment.
+ */
+export declare function invokePythonAttachment(options: {
+    getPythonAttachment: GetPythonAttachment;
+    dataQueries: DataQuery[];
+    requestIdRef: RefObject<number>;
+    codeTitle: string;
+    markdownTitle: string;
+    setCodeAttachments: (attachments: CustomCodeAttachment[]) => void;
+    onCodeAttachmentUpdated?: (attachment: Attachment) => void;
+}): void;

package/utils/attachments/replace-python-attachment.d.ts

@@ -0,0 +1,10 @@
+import { Attachment } from '@epam/ai-dial-shared';
+import { Message } from '../../../../dial-toolkit/src/index';
+/**
+ * Replaces the python code-sample attachment in a message's attachment list.
+ * When messageId is provided the matching message is targeted; otherwise the
+ * latest system message is used (AdvancedView path, which has no id).
+ * Returns the updated messages array, or null when the target message is not
+ * found or is not a System message.
+ */
+export declare function replacePythonAttachment(messages: Message[], newAttachment: Attachment, messageId?: string): Message[] | null;

package/utils/deferred-work.d.ts

@@ -0,0 +1,3 @@
+type CancelDeferredWork = () => void;
+export declare function scheduleDeferredWork(callback: () => void): CancelDeferredWork;
+export {};

package/utils/filters.d.ts

@@ -1,7 +1,6 @@
 import { DataConstraints, Dimension, Hierarchy, StructuralData, StructureItemBase } from '../../../sdmx-toolkit/src/index';
 import { Filter, FilterTreeNodeProps, FilterValue } from '../models/filters';
 import { DataQuery } from '../../../shared-toolkit/src/index';
-import { FilterDisplayMode } from '../constants/filter-display-mode';
 import { ConversationViewTitles } from '../models/titles';
 export declare const getDatasetFilters: (dimensions?: Dimension[], structures?: StructuralData, structureDimensions?: StructureItemBase[], locale?: string, datasetUrn?: string) => Filter[];
 export declare const isSharedFilter: (filter?: Filter) => boolean;
@@ -46,10 +45,6 @@ export declare const updateFiltersWithDisabledOption: (filters: Filter[]) => ({
 export declare const getFilterValuesTree: (filterValues?: FilterValue[]) => FilterTreeNodeProps[];
 export declare const getFilterTreeNodePadding: (level: number, isHasChildren?: boolean) => string;
 export declare const getFilterNodesBySelection: (node: FilterTreeNodeProps) => FilterTreeNodeProps[];
-export declare const getFilterDisplaySettings: (titles?: ConversationViewTitles) => {
-    key: FilterDisplayMode;
-    title: string;
-}[];
 export declare const getHierarchyOptions: ({ isHierarchical, availableHierarchies, titles, }: {
     isHierarchical?: boolean;
     availableHierarchies?: Hierarchy[];

package/utils/get-series-filters.d.ts

@@ -1,7 +1,7 @@
-import { SeriesFilterDto } from '../../../sdmx-toolkit/src/index';
+import { DatasetDimensionsMetadataMap, SeriesFilterDto } from '../../../sdmx-toolkit/src/index';
 import { TimeRange } from '../../../shared-toolkit/src/index';
 import { Filter } from '../models/filters';
-export declare const getSeriesFilterDto: (filters: Filter[], datasetUrn?: string) => SeriesFilterDto[];
+export declare const getSeriesFilterDto: (filters: Filter[], datasetUrn?: string, datasetDimensionsMetadataMap?: DatasetDimensionsMetadataMap) => SeriesFilterDto[];
 export declare const getTimeSeriesFilterDto: (timeRange: TimeRange | null | undefined, id: string) => SeriesFilterDto[];
 export declare const ONE_DAY_MS: number;
 export declare const getTimeFilter: (date: Date, increment?: number) => string;

package/utils/multiple-filters.d.ts

@@ -10,7 +10,7 @@ export declare const COMMON_COUNTRY_FILTER_ID = "COUNTRY";
 export declare const COMMON_FREQUENCY_FILTER_ID = "FREQUENCY";
 export declare const COMMON_TIME_PERIOD_FILTER_ID = "TIME_PERIOD";
 export declare const SHARED_FILTER_IDS: Set<string>;
-export declare const getFilledDatasetFiltersMap: (structureDataMaps?: StructureDataMaps, locale?: string) => Map<string, ({
+export declare const getFilledDatasetFiltersMap: (structureDataMaps?: StructureDataMaps, locale?: string, requireDataMessages?: boolean) => Map<string, ({
     dimensionValues: import('../../../sdmx-toolkit/src/index').Codelist[];
     filterType: "dataset";
     datasetUrn?: string;
@@ -39,8 +39,11 @@ export declare const getFilledDatasetFiltersMap: (structureDataMaps?: StructureD
 })[]>;
 export declare const getFiltersPreselectedByDataQueries: (filtersMap: Map<string, Filter[]>, dataQueries?: DataQuery[], constraintsMap?: Map<string, DataConstraints[] | undefined>, datasetDimensionsMetadataMap?: DatasetDimensionsMetadataMap) => Filter[];
 export declare const buildFiltersMap: (filters: Filter[], constraintsMap?: Map<string, DataConstraints[] | undefined>, applySharedFallback?: boolean, datasetDimensionsMetadataMap?: DatasetDimensionsMetadataMap) => Map<string, Filter[]>;
-export declare const getCompatibleDatasetUrns: (filters: Filter[], dataQueryUrns: string[]) => Set<string>;
+export declare const getCompatibleDatasetUrns: (filters: Filter[], dataQueryUrns: string[], dataQueries?: DataQuery[], datasetDimensionsMetadataMap?: DatasetDimensionsMetadataMap) => Set<string>;
+export declare const filterDataQueriesByActiveDatasetUrns: (dataQueries: DataQuery[] | undefined, activeDatasetUrns: Set<string> | null) => DataQuery[];
+export declare const filterMapByActiveDatasetUrns: <T>(map: Map<string, T>, activeDatasetUrns: Set<string> | null) => Map<string, T>;
 export declare const getRestoredActiveDatasetUrns: (dataQueries?: DataQuery[], datasetDimensionsMetadataMap?: DatasetDimensionsMetadataMap) => string[] | undefined;
+export declare const getDataQueriesWithExpandedSharedDimensionFilters: (dataQueries: DataQuery[], constraintsMap: Map<string, DataConstraints[] | undefined> | undefined, datasetDimensionsMetadataMap?: DatasetDimensionsMetadataMap) => DataQuery[];
 export declare const getCrossDatasetSnapshotKey: (dataQueries?: DataQuery[]) => string;
 export declare const getFiltersByConstraints: (filtersMap: Map<string, Filter[]>, structureDataMaps?: StructureDataMaps, locale?: Locale, datasetDimensionsMetadataMap?: DatasetDimensionsMetadataMap) => Filter[];
 export declare const getFiltersForQueryContext: (filters: Filter[], datasetUrn?: string, datasetDimensionsMetadataMap?: DatasetDimensionsMetadataMap) => Filter[];
@@ -48,13 +51,18 @@ export declare const getDatasetNameFromFilters: (filter: Filter, structuresMap?:
 export declare const isStructureDataMapsReady: (dataQueries?: FiltersProps["dataQueries"], structureDataMaps?: FiltersProps["structureDataMaps"]) => boolean;
 export declare const getConstraintsRequests: (dataQueries?: DataQuery[], filtersMap?: Map<string, Filter[]>, actions?: {
     getConstraints: (urn: string, filters?: SeriesFilterDto[]) => Promise<StructuralMetaData>;
-}) => Promise<ExtendedStructuralMetadata>[];
+}, datasetDimensionsMetadataMap?: DatasetDimensionsMetadataMap, filters?: Filter[]) => Promise<ExtendedStructuralMetadata>[];
 export declare const hasUncachedConstraintRequests: (dataQueries?: DataQuery[], filtersMap?: Map<string, Filter[]>, actions?: {
     getConstraints: (urn: string, filters?: SeriesFilterDto[]) => Promise<StructuralMetaData>;
-}) => boolean;
+}, datasetDimensionsMetadataMap?: DatasetDimensionsMetadataMap, filters?: Filter[]) => boolean;
+export declare const hasImplicitSharedWildcard: (dataQueries: DataQuery[], structureDataMaps: StructureDataMaps, datasetDimensionsMetadataMap?: DatasetDimensionsMetadataMap) => boolean;
 export declare const getConstraintsMap: (constraintsData: ExtendedStructuralMetadata[]) => Map<string, DataConstraints[] | undefined>;
 export declare const getConstraintsMapFromSettledResults: (constraintsResults: PromiseSettledResult<ExtendedStructuralMetadata>[]) => Map<string, DataConstraints[] | undefined>;
 export declare const mergeConstraintsMaps: (baseConstraintsMap: Map<string, DataConstraints[] | undefined> | undefined, updatedConstraintsMap: Map<string, DataConstraints[] | undefined>) => Map<string, DataConstraints[] | undefined>;
 export declare const getInitialConstraints: (isCrossDatasetModeOn: boolean, filter?: Filter, initialConstraints?: DataConstraints[], initialConstraintsMap?: Map<string, DataConstraints[] | undefined>) => DataConstraints[];
 export declare const getQueryFiltersMap: (filtersMap: Map<string, Filter[]>, dataQueries?: DataQuery[], dimensionsMap?: Map<string, Dimension[]>) => Map<string, DatasetQueryFilters>;
+export declare const getImplicitSharedWildcardFilterParams: (dataQueries: DataQuery[], structureDataMaps: StructureDataMaps, constraintsMap: Map<string, DataConstraints[] | undefined> | undefined, locale: string, datasetDimensionsMetadataMap?: DatasetDimensionsMetadataMap) => {
+    compatibleUrns: Set<string>;
+    filterParamsMap: Map<string, DatasetQueryFilters>;
+} | undefined;
 export declare const setDataQueryFiltersMap: (dataQueries?: DataQuery[], filtersMap?: Map<string, Filter[]>) => Map<string, QueryFilter[]>;

package/utils/query-filters.d.ts

@@ -4,4 +4,6 @@ import { Filter } from '../models/filters';
 export declare const getQueryTimeSeriesFilters: (filters: Filter[]) => QueryFilter[];
 export declare const getTimeQueryFilterFromAttachment: (dataQuery: DataQuery, dimensions?: DimensionList) => string | null;
 export declare const getQueryFilters: (filters: Filter[], dimensions?: Dimension[], datasetUrn?: string) => DatasetQueryFilters;
+export declare const buildDataQueryWithMergedFilters: (dataQuery: DataQuery, uiFilters: Filter[]) => DataQuery;
 export declare const setDataQueryFilters: (filters: Filter[], datasetUrn?: string) => QueryFilter[];
+export declare const buildQueryFiltersForPythonAttachment: (filters: Filter[], datasetUrn?: string) => QueryFilter[];

package/utils/timezone.d.ts

@@ -0,0 +1 @@
+export declare const getTimezone: () => string;