@sisense/sdk-ai-core 0.9.0 → 0.10.1

package/dist/engines/manage-perspectives/types.d.ts

@@ -327,4 +327,41 @@ export interface PerspectiveEngineContext {
     toolCallId: string;
     httpClient?: HttpClient;
 }
+/**
+ * Canonical tool description for listDataModels — reusable by any host.
+ * When getDataSources is also registered, prefer getDataSources for discovery (it includes drafts and live sources); use this tool for Elasticube-only model lists if needed.
+ */
+export declare const listDataModelsToolDescription = "Lists all Sisense data models (Elasticubes) available in the instance. Data models and data sources overlap in Sisense \u2014 when getDataSources is available, prefer it for unified discovery.\n\nReturns each model's OID (UUID), title, and type. At the start of a perspective workflow, call this as the ONLY tool in the turn if you use it \u2014 never use an OID from memory, prior context, or examples. After it returns, present the model list and stop; wait for the user to pick a model before calling getModelSchema. Do NOT chain into getModelSchema in the same turn.";
+/**
+ * Canonical tool description for getModelSchema — reusable by any host.
+ */
+export declare const getModelSchemaToolDescription = "Fetches the full schema of a Sisense data model: all tables with their OIDs and columns (with OIDs and types), plus all relation OIDs.\n\nIMPORTANT: The datamodelOid parameter MUST be a UUID \u2014 use the `oid` field from a `getDataSources` or `listDataModels` result in the current conversation. Never use an OID from memory, context, or examples. Perspective OIDs and legacy datasource string IDs (e.g. \"localhost_aSampleECommerce\") are NOT valid here.\n\nThis is the canonical \"show / explore / view / open the data model\" action (including drafts for inspection). When the user picks a model or uses those verbs about a specific model by name, use the model's oid from the latest getDataSources result. Do not ask \"schema or build?\" for a simple show-model request. Do not use getDataSourceFields as the default exploration action \u2014 that returns a flat field list, not the model diagram.\n\nThis is step 2 of the perspective workflow. After this returns, propose 2-4 concrete perspective ideas (each with: name, tables included, columns hidden, intended audience) and ASK the user which one to create. STOP and wait \u2014 do NOT call createPerspective in the same turn.\n\nPerspective workflow pacing: prefer one major conversational step per assistant reply where possible \u2014 list what exists, inspect and discuss the schema with the user, agree on a design, then call createPerspective in a later focused turn once choices are clear (rather than jumping from first discovery straight to creation in one reply when the user has not confirmed direction).";
+/**
+ * Canonical tool description for addRelation — reusable by any host.
+ */
+export declare const addRelationToolDescription = "Creates a join relationship between two tables in a Sisense data model.\n\nCall getModelSchema first \u2014 all three IDs (dataset, table, column) must be UUIDs from that response.\nSource = the \"many\" side (fact/transaction table with the FK column).\nTarget = the \"one\" side (dimension/lookup table with the PK column).\n\nCall once per join. The host may refresh the model diagram as each addRelation succeeds.\n\nAfter all addRelation calls succeed in a turn, briefly summarize the joins you created and ASK the user whether to trigger a build now (so the new joins become queryable). Do NOT call triggerBuild automatically \u2014 it requires explicit user agreement.";
+/**
+ * Canonical tool description for removeRelation — reusable by any host.
+ */
+export declare const removeRelationToolDescription = "Removes a join relationship from a Sisense data model.\n\nCall getModelSchema first to obtain the relations[].oid you want to remove. Pass that as relationOid; the engine validates it exists on the given datamodelOid before sending the mutation.\n\nCall once per relation. The host may refresh the model diagram as each removeRelation succeeds.\n\nAfter all removeRelation calls succeed in a turn, briefly summarize what you removed and ASK the user whether to trigger a build now. Do NOT call triggerBuild automatically \u2014 it requires explicit user agreement.";
+/**
+ * Canonical tool description for createPerspective — reusable by any host.
+ */
+export declare const createPerspectiveToolDescription = "Creates a new perspective (filtered sub-model) on a Sisense data model. This is step 3 \u2014 the final step \u2014 of the perspective workflow.\n\nFor a new perspective, work in stages: first discover models and wait for the user to pick one, then fetch schema and wait for design agreement, then call this tool in its own turn with OIDs from that schema \u2014 never skip discovery or schema in the same turn as create.\n\nCall getModelSchema first (step 2) to get exact table OIDs, column OIDs, and relation OIDs. Use ONLY OIDs from that schema response \u2014 never invent or guess OIDs.\n\nAfter the user picks a perspective option (or describes a custom one), call this tool IMMEDIATELY in the same turn. Do not ask further confirmation. The host typically opens an interactive diagram of the perspective \u2014 reply with a one-line confirmation; do not narrate the diagram in detail.\n\ndiffType rules:\n- \"include\": allowlist \u2014 only columns listed with enabled:true are visible. Use when exposing a small subset.\n- \"exclude\": denylist \u2014 all columns visible except those listed with enabled:false. Use when hiding a few sensitive columns.\n\ncolumnsDiff must never be empty \u2014 for \"include\" list every visible column with enabled:true; for \"exclude\" list at least one hidden column with enabled:false.\n\nInclude a relation OID only when both connected tables are in the perspective's tables list.";
+/**
+ * Canonical tool description for updatePerspective — reusable by any host.
+ */
+export declare const updatePerspectiveToolDescription = "Updates an existing Sisense PERSPECTIVE (a saved filtered sub-model / view). This tool does NOT modify the underlying data model \u2014 it only changes which tables/columns/relations a specific perspective exposes.\n\nDO NOT call this tool when the user asks to add, remove, or modify RELATIONS on the data model itself \u2014 that operates on the model, not on a perspective. (To add a relation, use addRelation. To remove a relation, use removeRelation.)\n\nSend only the fields you want to change:\n- To rename a perspective: pass only name.\n- To update column visibility within the perspective: pass the full tables array (it replaces the existing one).\n- To expose another existing table in the perspective: include all existing tables plus the new one in the tables array.\n\nAfter a successful update, call getPerspective with the same perspectiveOid in the next turn so the user sees the refreshed diagram.";
+/**
+ * Canonical tool description for getPerspective — reusable by any host.
+ */
+export declare const getPerspectiveToolDescription = "Fetches the current state of a Sisense perspective. The host typically renders an interactive diagram when supported.\n\nCall ONLY when the user references a specific perspective by name, asks to view/open/show that perspective, after listPerspectives when they pick one, or directly after a successful updatePerspective.\n\nDo NOT call as a follow-up to getModelSchema for a generic \"show me the model diagram\" \u2014 that is model-level (getModelSchema). Do NOT also call when the user only named the parent data model unless they named a perspective.\n\nThis always fetches fresh state from the server \u2014 never rely on cached args from prior tool calls.\n\nReply with a one-line confirmation; do not narrate the diagram in detail.";
+/**
+ * Canonical tool description for triggerBuild — reusable by any host.
+ */
+export declare const triggerBuildToolDescription = "Triggers a full build of a Sisense Elasticube and (by default) waits for it to finish.\n\nFull cube rebuilds are disruptive \u2014 long-running and they can block or delay query and chart use on that model until they finish. NEVER call without explicit user agreement in the current conversation.\n\nDESTRUCTIVE / EXPENSIVE: a build recomputes the entire cube and can take 20-90s for small CSV cubes (longer for big ones).\n\nWorkflow rule: after addRelation, table edits, or any other schema change, briefly summarize the change and ASK the user whether to build now. Do not call this tool until the user has explicitly said yes (\"yes, build\", \"go ahead\", \"rebuild now\", etc.). If the user said \"I'll build it myself\" or hasn't responded, do nothing.\n\nPass wait:false only if the user explicitly says \"kick off the build, don't wait\", otherwise leave wait undefined (defaults to true).\n\nConfirm completion in one short line (\"Build done in 32s.\") \u2014 do not narrate progress steps.";
+/**
+ * Canonical tool description for listPerspectives — reusable by any host.
+ */
+export declare const listPerspectivesToolDescription = "Lists Sisense perspectives. Use whenever the user asks to:\n- \"see / list / show me the perspectives\" (with or without a specific model)\n- \"what perspectives exist on this model\"\n- review existing perspectives before deciding to create / update / delete one\n\nPass datamodelOid to scope to a single model; omit it for a global list across every model the user has access to. Set includeDefault:false to hide the auto-generated Default perspectives.\n\nAfter the result, present the user with a short numbered/bulleted summary (name, table count, default vs custom) and ask which one they want to inspect \u2014 then call getPerspective to render its diagram.";
 //# sourceMappingURL=types.d.ts.map

package/dist/engines/manage-perspectives/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/manage-perspectives/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/manage-perspectives/types.ts"],"names":[],"mappings":"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"}

package/dist/engines/recommend-queries/recommend-queries-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recommend-queries-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/recommend-queries/recommend-queries-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAK5C,OAAO,EACN,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EAEtB,6BAA6B,EAG7B,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,GAChB,SAAS,GAAG,SAAS,CAQvB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,EAAE,GACxB,MAAM,GAAG,SAAS,CAyBpB;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,EAC9C,OAAO,EAAE,uBAAuB,EAChC,qBAAqB,CAAC,EAAE,6BAA6B,GACnD,OAAO,CAAC,sBAAsB,CAAC,CAoGjC"}
+{"version":3,"file":"recommend-queries-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/recommend-queries/recommend-queries-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,OAAO,EACN,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EAEtB,6BAA6B,EAG7B,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,GAChB,SAAS,GAAG,SAAS,CAQvB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,EAAE,GACxB,MAAM,GAAG,SAAS,CAyBpB;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,EAC9C,OAAO,EAAE,uBAAuB,EAChC,qBAAqB,CAAC,EAAE,6BAA6B,GACnD,OAAO,CAAC,sBAAsB,CAAC,CAsGjC"}

package/dist/engines/recommend-queries/types.d.ts

@@ -2,6 +2,11 @@ import { z } from 'zod';
 import { WidgetProps, ChartType } from '@sisense/sdk-ui';
 import { HttpClient } from '@sisense/sdk-rest-client';
 import { OpenAI } from 'openai';
+/**
+ * Canonical tool description for recommendQueries — reusable by any host (sdk-assistant, MCP server, custom integrations).
+ * Hosts may append host-specific notes but should not duplicate or contradict this text.
+ */
+export declare const recommendQueriesToolDescription = "Recommend natural language queries to ask on a data source based on explicit user prompt and context.\n\nIMPORTANT:\n- NEVER assume a data source title is valid. If no fresh getDataSources result exists in this conversation, call getDataSources first to validate the data source exists and is queryable (not draft), or ask the user to specify one.\n- Use userPrompt to filter and prioritize relevant recommendations (e.g. \"revenue dashboard\", \"sales analysis\").\n- Use existingWidgets to avoid duplicate recommendations when adding to existing dashboards.\n- Extract chart types from user prompts (e.g. \"bar chart\", \"line chart\") and pass through to chart generation when the host supports it.\n\nDo not call recommendQueries on a draft data model \u2014 drafts are not queryable until built.";
 /**
  * Default number of query recommendations to return
  */

package/dist/engines/recommend-queries/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/recommend-queries/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAkBjC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACzC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CAClB,GAAG,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,eAAe,EAAE,2BAA2B,EAAE,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAC3C,eAAe,EAAE,2BAA2B,EAAE,KAC1C,IAAI,CAAC;AAEV;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAYzD,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engines/recommend-queries/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,+BAA+B,qyBAQ+C,CAAC;AAE5F;;GAEG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAkBjC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACzC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CAClB,GAAG,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,eAAe,EAAE,2BAA2B,EAAE,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAC3C,eAAe,EAAE,2BAA2B,EAAE,KAC1C,IAAI,CAAC;AAEV;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAYzD,CAAC"}

package/dist/engines/shared/get-filters-json-for-llm-summary.d.ts

@@ -0,0 +1,12 @@
+import { Filter, FilterRelations, FunctionCall } from '@sisense/sdk-data';
+/**
+ * Compact filter list for LLM-facing chart/dashboard summaries.
+ * Translates CSDK {@link Filter} instances via {@link translateQueryToJSON}.
+ */
+export declare function getFiltersJsonForLlmSummary(csdkFilters: Filter[] | FilterRelations | readonly Filter[] | undefined | null): unknown[];
+/**
+ * Same as {@link getFiltersJsonForLlmSummary}, narrowed to compose-tree
+ * {@link FunctionCall} nodes for typed LLM payloads (unknown entries are dropped).
+ */
+export declare function getFunctionCallFiltersForLlmSummary(csdkFilters: Filter[] | FilterRelations | readonly Filter[] | undefined | null): FunctionCall[];
+//# sourceMappingURL=get-filters-json-for-llm-summary.d.ts.map

package/dist/engines/shared/get-filters-json-for-llm-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-filters-json-for-llm-summary.d.ts","sourceRoot":"","sources":["../../../src/engines/shared/get-filters-json-for-llm-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAyB/E;;;GAGG;AACH,wBAAgB,2BAA2B,CAC1C,WAAW,EACR,MAAM,EAAE,GACR,eAAe,GACf,SAAS,MAAM,EAAE,GACjB,SAAS,GACT,IAAI,GACL,OAAO,EAAE,CA6BX;AAUD;;;GAGG;AACH,wBAAgB,mCAAmC,CAClD,WAAW,EACR,MAAM,EAAE,GACR,eAAe,GACf,SAAS,MAAM,EAAE,GACjB,SAAS,GACT,IAAI,GACL,YAAY,EAAE,CAEhB"}

package/dist/engines/shared/nlq-query-helpers.d.ts

@@ -1,5 +1,15 @@
-import { NlqV3Result } from '../../services/nlq/nlq-service';
+import { QueryExecutionResult, QueryState } from '../../services/nlq/nlq-service';
 import { HttpClient } from '@sisense/sdk-rest-client';
-/** Call NLQ V3 smartQuery API */
-export declare function executeNlqV3Query(dataSourceTitle: string, queryPrompt: string, httpClient?: HttpClient, commonFilters?: unknown): Promise<NlqV3Result | null>;
+/**
+ * Layer-2 NLQ fallback when wire `chartState` is disabled (`isNlqDeltaEnabled === false`):
+ * prepend a machine-readable JSON snapshot of the prior structural state, then the user's
+ * prompt. NLQ receives a single `text` field (no `chartState`). Truncate very large states
+ * to cap token growth; truncation is logged.
+ */
+export declare function augmentNlqTextWithPriorState(userText: string, priorState: QueryState): {
+    text: string;
+    truncated: boolean;
+};
+/** Call NLQ V3 smartQuery API; maps wire `chartState` to domain `queryState`. */
+export declare function executeNlqV3Query(dataSourceTitle: string, queryPrompt: string, httpClient?: HttpClient, commonFilters?: unknown, priorQueryState?: QueryState, isNlqDeltaEnabled?: boolean): Promise<QueryExecutionResult | null>;
 //# sourceMappingURL=nlq-query-helpers.d.ts.map

package/dist/engines/shared/nlq-query-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nlq-query-helpers.d.ts","sourceRoot":"","sources":["../../../src/engines/shared/nlq-query-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,WAAW,EACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,iCAAiC;AACjC,wBAAsB,iBAAiB,CACtC,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,UAAU,EACvB,aAAa,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAS7B"}
+{"version":3,"file":"nlq-query-helpers.d.ts","sourceRoot":"","sources":["../../../src/engines/shared/nlq-query-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,oBAAoB,EACpB,UAAU,EACV,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AA6CtD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC3C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAStC;AAED,iFAAiF;AACjF,wBAAsB,iBAAiB,CACtC,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,UAAU,EACvB,aAAa,CAAC,EAAE,OAAO,EACvB,eAAe,CAAC,EAAE,UAAU,EAC5B,iBAAiB,UAAO,GACtB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAyBtC"}

package/dist/index.d.ts

@@ -1,7 +1,17 @@
 export * from './engines';
+export { buildQueryToolDescription } from './engines/build-query/types';
+export { buildChartToolDescription } from './engines/build-chart/types';
+export { buildDashboardToolDescription } from './engines/build-dashboard/types';
+export { getDataSourcesToolDescription } from './engines/get-data-sources/types';
+export { getDataSourceFieldsToolDescription } from './engines/get-data-source-fields/types';
+export { getDashboardsToolDescription } from './engines/get-dashboards/types';
+export { uploadFilesToolDescription, buildDataModelFromUploadsToolDescription, } from './engines/build-csv-model/types';
+export { recommendQueriesToolDescription } from './engines/recommend-queries/types';
+export { listDataModelsToolDescription, getModelSchemaToolDescription, addRelationToolDescription, removeRelationToolDescription, createPerspectiveToolDescription, updatePerspectiveToolDescription, getPerspectiveToolDescription, triggerBuildToolDescription, listPerspectivesToolDescription, } from './engines/manage-perspectives/types';
 export * from './constants';
 export { zodFunction, zodToReadableType, excludeSchemaProperties, filterSchemaProperties, } from './utils/zod-utils';
 export * from './utils/id-utils';
+export * from './utils/dev-debug';
 export * from './utils/utils';
 export * from './utils/http-client';
 export * from './utils/openai-client';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC;AAG1B,cAAc,aAAa,CAAC;AAG5B,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,eAAe,CAAC;AAE9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAG7C,cAAc,qBAAqB,CAAC;AAGpC,cAAc,+BAA+B,CAAC;AAG9C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iDAAiD,CAAC;AAChE,cAAc,0CAA0C,CAAC;AACzD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC;AAG1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAAE,kCAAkC,EAAE,MAAM,wCAAwC,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EACN,0BAA0B,EAC1B,wCAAwC,GACxC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EACN,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAC1B,6BAA6B,EAC7B,gCAAgC,EAChC,gCAAgC,EAChC,6BAA6B,EAC7B,2BAA2B,EAC3B,+BAA+B,GAC/B,MAAM,qCAAqC,CAAC;AAG7C,cAAc,aAAa,CAAC;AAG5B,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,eAAe,CAAC;AAE9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAG7C,cAAc,qBAAqB,CAAC;AAGpC,cAAc,+BAA+B,CAAC;AAG9C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iDAAiD,CAAC;AAChE,cAAc,0CAA0C,CAAC;AACzD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC"}