@sisense/sdk-ui-vue 2.29.0 → 2.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -151,6 +151,12 @@ export declare const ChartWidget: import("vue").DefineComponent<{
151
151
  * @category Widget
152
152
  */
153
153
  styleOptions: PropType<import("@sisense/sdk-ui-preact").ChartWidgetStyleOptions | undefined>;
154
+ /**
155
+ * Configuration for AI-powered widget features such as automated narrative generation
156
+ * @alpha
157
+ * @category Widget
158
+ */
159
+ aiOptions: PropType<import("@sisense/sdk-ui-preact").WidgetAiOptions | undefined>;
154
160
  /**
155
161
  * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.title}
156
162
  *
@@ -271,6 +277,12 @@ export declare const ChartWidget: import("vue").DefineComponent<{
271
277
  * @category Widget
272
278
  */
273
279
  styleOptions: PropType<import("@sisense/sdk-ui-preact").ChartWidgetStyleOptions | undefined>;
280
+ /**
281
+ * Configuration for AI-powered widget features such as automated narrative generation
282
+ * @alpha
283
+ * @category Widget
284
+ */
285
+ aiOptions: PropType<import("@sisense/sdk-ui-preact").WidgetAiOptions | undefined>;
274
286
  /**
275
287
  * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.title}
276
288
  *
@@ -3,6 +3,13 @@ import type { PropType } from 'vue';
3
3
  export { WithCommonWidgetProps, TextWidgetProps, CustomWidgetProps };
4
4
  export interface PivotTableWidgetProps extends PivotTableWidgetPropsPreact {
5
5
  }
6
+ /**
7
+ * Configuration for AI-powered widget features such as automated narrative generation.
8
+ * Shared by chart and pivot {@link Widget} instances.
9
+ *
10
+ * @alpha
11
+ */
12
+ export type WidgetAiOptions = NonNullable<ChartWidgetProps['aiOptions']>;
6
13
  /**
7
14
  * Props of the {@link @sisense/sdk-ui-vue!Widget | `Widget`} component.
8
15
  */
@@ -108,6 +115,12 @@ export declare const Widget: import("vue").DefineComponent<{
108
115
  * @category Widget
109
116
  */
110
117
  styleOptions: PropType<import("@sisense/sdk-ui-preact").TextWidgetStyleOptions | import("@sisense/sdk-ui-preact").CustomWidgetStyleOptions | import("@sisense/sdk-ui-preact").PivotTableWidgetStyleOptions | import("@sisense/sdk-ui-preact").ChartWidgetStyleOptions | undefined>;
118
+ /**
119
+ * Configuration for AI-powered widget features such as automated narrative generation
120
+ * @alpha
121
+ * @category Widget
122
+ */
123
+ aiOptions: PropType<import("@sisense/sdk-ui-preact").WidgetAiOptions>;
111
124
  /**
112
125
  * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.drilldownOptions}
113
126
  *
@@ -233,6 +246,12 @@ export declare const Widget: import("vue").DefineComponent<{
233
246
  * @category Widget
234
247
  */
235
248
  styleOptions: PropType<import("@sisense/sdk-ui-preact").TextWidgetStyleOptions | import("@sisense/sdk-ui-preact").CustomWidgetStyleOptions | import("@sisense/sdk-ui-preact").PivotTableWidgetStyleOptions | import("@sisense/sdk-ui-preact").ChartWidgetStyleOptions | undefined>;
249
+ /**
250
+ * Configuration for AI-powered widget features such as automated narrative generation
251
+ * @alpha
252
+ * @category Widget
253
+ */
254
+ aiOptions: PropType<import("@sisense/sdk-ui-preact").WidgetAiOptions>;
236
255
  /**
237
256
  * {@inheritDoc @sisense/sdk-ui!ChartWidgetProps.drilldownOptions}
238
257
  *
@@ -37,9 +37,36 @@ import type { MaybeRefOrWithRefs } from '../types';
37
37
  * - `isError`: Indicates if an error occurred during query execution.
38
38
  * - `isSuccess`: Indicates if the query executed successfully without errors.
39
39
  * - `error`: Contains the error object if an error occurred during the query.
40
+ * - `rowCount`: The total row count of the query result, ignoring the `count` and `offset` paging.
41
+ * Populated only when `includeRowCount` is enabled in the params and the Sisense instance supports
42
+ * the row count API (`@beta`); `undefined` otherwise.
40
43
  *
41
44
  * This composable facilitates integrating Sisense data fetching into Vue applications, enabling developers
42
45
  * to easily manage query states and dynamically adjust query parameters based on application needs.
43
46
  * @group Queries
44
47
  */
45
- export declare const useExecuteQuery: (params: MaybeRefOrWithRefs<ExecuteQueryParams>) => import("vue").ToRefs<import("@sisense/sdk-ui-preact").QueryState>;
48
+ export declare const useExecuteQuery: (params: MaybeRefOrWithRefs<ExecuteQueryParams>) => {
49
+ rowCount: import("vue").Ref<number | undefined>;
50
+ isLoading: import("vue").Ref<true>;
51
+ isError: import("vue").Ref<false>;
52
+ isSuccess: import("vue").Ref<false>;
53
+ error: import("vue").Ref<undefined>;
54
+ data: import("vue").Ref<import("@sisense/sdk-data").QueryResultData | undefined>;
55
+ status: import("vue").Ref<"loading">;
56
+ } | {
57
+ rowCount: import("vue").Ref<number | undefined>;
58
+ isLoading: import("vue").Ref<false>;
59
+ isError: import("vue").Ref<true>;
60
+ isSuccess: import("vue").Ref<false>;
61
+ error: import("vue").Ref<Error>;
62
+ data: import("vue").Ref<undefined>;
63
+ status: import("vue").Ref<"error">;
64
+ } | {
65
+ rowCount: import("vue").Ref<number | undefined>;
66
+ isLoading: import("vue").Ref<false>;
67
+ isError: import("vue").Ref<false>;
68
+ isSuccess: import("vue").Ref<true>;
69
+ error: import("vue").Ref<undefined>;
70
+ data: import("vue").Ref<import("@sisense/sdk-data").QueryResultData>;
71
+ status: import("vue").Ref<"success">;
72
+ };
@@ -0,0 +1,224 @@
1
+ import type { SisenseContextProviderProps as SisenseContextProviderPropsPreact } from '@sisense/sdk-ui-preact';
2
+ import type { PropType } from 'vue';
3
+ /**
4
+ * Configurations and authentication for Sisense Context.
5
+ *
6
+ * Use one of the following to authenticate:
7
+ *
8
+ * - {@link @sisense/sdk-ui-vue!SisenseContextProviderProps.ssoEnabled | `ssoEnabled`}
9
+ * - {@link @sisense/sdk-ui-vue!SisenseContextProviderProps.token | `token`}
10
+ * - {@link @sisense/sdk-ui-vue!SisenseContextProviderProps.wat | `wat`}
11
+ */
12
+ export interface SisenseContextProviderProps extends SisenseContextProviderPropsPreact {
13
+ }
14
+ /**
15
+ * Sisense Context Provider Component allowing you to connect to
16
+ * a Sisense instance and provide that context
17
+ * to all Compose SDK components in your application.
18
+ *
19
+ * @example
20
+ * Here's how to use the `SisenseContextProvider` component to wrap your Sisense-enabled application:
21
+ * Add SisenseContextProvider to the main component of your app as below and then wrap
22
+ * other SDK components inside this component.
23
+ * ```vue
24
+ * <template>
25
+ * <SisenseContextProvider
26
+ * :url="sisenseUrl"
27
+ * :defaultDataSource="defaultDataSource"
28
+ * :ssoEnabled="true"
29
+ * :token="authToken"
30
+ * :wat="watToken"
31
+ * :appConfig="appConfigurations"
32
+ * >
33
+ * <!-- Your application components here -->
34
+ * </SisenseContextProvider>
35
+ * </template>
36
+ *
37
+ * <script>
38
+ * import { ref } from 'vue';
39
+ * import SisenseContextProvider from './SisenseContextProvider.vue';
40
+ *
41
+ * export default {
42
+ * components: { SisenseContextProvider },
43
+ * setup() {
44
+ * const sisenseUrl = ref('https://your-sisense-instance.com');
45
+ * const defaultDataSource = ref('default_datasource_id');
46
+ * const authToken = ref('your_auth_token');
47
+ * const watToken = ref('your_wat_token');
48
+ * const appConfigurations = ref({});
49
+ *
50
+ * return { sisenseUrl, defaultDataSource, authToken, watToken, appConfigurations };
51
+ * }
52
+ * };
53
+ * </script>
54
+ * ```
55
+ *
56
+ * @param props - Sisense context provider props
57
+ * @returns A Sisense Context Provider Component
58
+ * @group Contexts
59
+ */
60
+ export declare const SisenseContextProvider: import("vue").DefineComponent<{
61
+ /**
62
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.defaultDataSource}
63
+ *
64
+ * @category Sisense App
65
+ */
66
+ defaultDataSource: PropType<import("@sisense/sdk-data").DataSource | undefined>;
67
+ /**
68
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.url}
69
+ *
70
+ * @category Sisense App
71
+ */
72
+ url: {
73
+ type: PropType<string>;
74
+ required: true;
75
+ };
76
+ /**
77
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.ssoEnabled}
78
+ *
79
+ * @category Sisense Authentication
80
+ */
81
+ ssoEnabled: PropType<boolean | undefined>;
82
+ /**
83
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.enableSilentPreAuth}
84
+ *
85
+ * @category Sisense Authentication
86
+ */
87
+ enableSilentPreAuth: {
88
+ type: PropType<boolean | undefined>;
89
+ default: boolean;
90
+ };
91
+ /**
92
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.token}
93
+ *
94
+ * @category Sisense Authentication
95
+ */
96
+ token: PropType<string | null | undefined>;
97
+ /**
98
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.wat}
99
+ *
100
+ * @category Sisense Authentication
101
+ */
102
+ wat: PropType<string | null | undefined>;
103
+ /**
104
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.appConfig}
105
+ *
106
+ * @category Sisense App
107
+ */
108
+ appConfig: PropType<import("@sisense/sdk-ui-preact").AppConfig | undefined>;
109
+ /**
110
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.plugins}
111
+ *
112
+ * @category Sisense App
113
+ * @internal
114
+ */
115
+ plugins: {
116
+ type: PropType<import("@sisense/sdk-ui-preact").Plugin[] | undefined>;
117
+ default: () => never[];
118
+ };
119
+ /**
120
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.ssoMaxAuthRedirectAttempts}
121
+ *
122
+ * @category Sisense Authentication
123
+ * @alpha
124
+ */
125
+ ssoMaxAuthRedirectAttempts: PropType<number | undefined>;
126
+ /**
127
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.ssoRedirectAttemptsTtlMs}
128
+ *
129
+ * @category Sisense Authentication
130
+ * @alpha
131
+ */
132
+ ssoRedirectAttemptsTtlMs: PropType<number | undefined>;
133
+ /**
134
+ * @internal
135
+ */
136
+ showRuntimeErrors: {
137
+ type: PropType<boolean | undefined>;
138
+ default: boolean;
139
+ };
140
+ }, () => import("vue/jsx-runtime").JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
141
+ /**
142
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.defaultDataSource}
143
+ *
144
+ * @category Sisense App
145
+ */
146
+ defaultDataSource: PropType<import("@sisense/sdk-data").DataSource | undefined>;
147
+ /**
148
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.url}
149
+ *
150
+ * @category Sisense App
151
+ */
152
+ url: {
153
+ type: PropType<string>;
154
+ required: true;
155
+ };
156
+ /**
157
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.ssoEnabled}
158
+ *
159
+ * @category Sisense Authentication
160
+ */
161
+ ssoEnabled: PropType<boolean | undefined>;
162
+ /**
163
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.enableSilentPreAuth}
164
+ *
165
+ * @category Sisense Authentication
166
+ */
167
+ enableSilentPreAuth: {
168
+ type: PropType<boolean | undefined>;
169
+ default: boolean;
170
+ };
171
+ /**
172
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.token}
173
+ *
174
+ * @category Sisense Authentication
175
+ */
176
+ token: PropType<string | null | undefined>;
177
+ /**
178
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.wat}
179
+ *
180
+ * @category Sisense Authentication
181
+ */
182
+ wat: PropType<string | null | undefined>;
183
+ /**
184
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.appConfig}
185
+ *
186
+ * @category Sisense App
187
+ */
188
+ appConfig: PropType<import("@sisense/sdk-ui-preact").AppConfig | undefined>;
189
+ /**
190
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.plugins}
191
+ *
192
+ * @category Sisense App
193
+ * @internal
194
+ */
195
+ plugins: {
196
+ type: PropType<import("@sisense/sdk-ui-preact").Plugin[] | undefined>;
197
+ default: () => never[];
198
+ };
199
+ /**
200
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.ssoMaxAuthRedirectAttempts}
201
+ *
202
+ * @category Sisense Authentication
203
+ * @alpha
204
+ */
205
+ ssoMaxAuthRedirectAttempts: PropType<number | undefined>;
206
+ /**
207
+ * {@inheritDoc @sisense/sdk-ui!SisenseContextProviderProps.ssoRedirectAttemptsTtlMs}
208
+ *
209
+ * @category Sisense Authentication
210
+ * @alpha
211
+ */
212
+ ssoRedirectAttemptsTtlMs: PropType<number | undefined>;
213
+ /**
214
+ * @internal
215
+ */
216
+ showRuntimeErrors: {
217
+ type: PropType<boolean | undefined>;
218
+ default: boolean;
219
+ };
220
+ }>>, {
221
+ plugins: import("@sisense/sdk-ui-preact").Plugin[] | undefined;
222
+ enableSilentPreAuth: boolean | undefined;
223
+ showRuntimeErrors: boolean | undefined;
224
+ }, {}>;
package/package.json CHANGED
@@ -11,7 +11,7 @@
11
11
  "Sisense",
12
12
  "Compose SDK"
13
13
  ],
14
- "version": "2.29.0",
14
+ "version": "2.30.0",
15
15
  "type": "module",
16
16
  "main": "./dist/index.cjs",
17
17
  "module": "./dist/index.js",
@@ -72,8 +72,8 @@
72
72
  "clean": "rm -rf ./dist && rm -rf ./coverage && rm -rf tsconfig.tsbuildinfo"
73
73
  },
74
74
  "dependencies": {
75
- "@sisense/sdk-data": "2.29.0",
76
- "@sisense/sdk-ui-preact": "2.29.0",
75
+ "@sisense/sdk-data": "2.30.0",
76
+ "@sisense/sdk-ui-preact": "2.30.0",
77
77
  "deepmerge": "^4.3.1",
78
78
  "lodash-es": "^4.17.21",
79
79
  "vue": "^3.3.2"