@burdenoff/microfe-bigconsole 2026.930.1 → 2026.1001.1

package/dist/bigconsole/contexts/NavigationContext.d.ts

@@ -0,0 +1,45 @@
+import { ReactNode } from 'react';
+import { NavigateOptions, LinkProps } from 'react-router';
+
+interface NavigationContextValue {
+    /** Base path for all routes (e.g., '/bigconsole') */
+    basePath: string;
+    /** Navigate to a path within the microfrontend */
+    navigate: (to: string, options?: NavigateOptions) => void;
+    /** Build a full path with basePath prefix */
+    buildPath: (path: string) => string;
+}
+interface NavigationProviderProps {
+    /** Base path for the microfrontend (e.g., '/bigconsole') */
+    basePath: string;
+    children: ReactNode;
+}
+export declare function NavigationProvider({ basePath, children }: NavigationProviderProps): import("react").JSX.Element;
+/**
+ * Hook to access navigation context
+ * @throws Error if used outside NavigationProvider
+ */
+export declare function useNavigation(): NavigationContextValue;
+/**
+ * Hook for basePath-aware navigation
+ * Returns a navigate function that automatically prepends basePath
+ */
+export declare function useAppNavigate(): (to: string, options?: NavigateOptions) => void;
+/**
+ * Hook to build full paths with basePath prefix
+ */
+export declare function useBuildPath(): (path: string) => string;
+/**
+ * Hook to get the current basePath
+ */
+export declare function useBasePath(): string;
+/**
+ * AppLink - basePath-aware Link component
+ * Automatically prepends basePath to the 'to' prop
+ */
+export interface AppLinkProps extends Omit<LinkProps, 'to'> {
+    to: string;
+}
+export declare const AppLink: import('react').ForwardRefExoticComponent<AppLinkProps & import('react').RefAttributes<HTMLAnchorElement>>;
+export {};
+//# sourceMappingURL=NavigationContext.d.ts.map

package/dist/bigconsole/contexts/NavigationContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationContext.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/contexts/NavigationContext.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA+D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACpG,OAAO,EAA0C,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAM5G,UAAU,sBAAsB;IAC9B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1D,6CAA6C;IAC7C,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAYD,UAAU,uBAAuB;IAC/B,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,uBAAuB,+BAsDjF;AAMD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,sBAAsB,CAMtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,SAjGb,MAAM,YAAY,eAAe,KAAK,IAAI,CAoG1D;AAED;;GAEG;AACH,wBAAgB,YAAY,WAvGR,MAAM,KAAK,MAAM,CA0GpC;AAED;;GAEG;AACH,wBAAgB,WAAW,WAG1B;AAMD;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;IACzD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,eAAO,MAAM,OAAO,4GAIlB,CAAC"}

package/dist/bigconsole/contexts/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * BigConsole Contexts
+ *
+ * React context providers for dashboard functionality.
+ */
+export { CrossFilterContext, CrossFilterProvider, useCrossFilterContext, useWidgetCrossFilter, type CrossFilterContextValue, type CrossFilterProviderProps, } from './CrossFilterContext';
+export { NavigationProvider, useNavigation, useAppNavigate, useBuildPath, useBasePath, AppLink, type AppLinkProps, } from './NavigationContext';
+//# sourceMappingURL=index.d.ts.map

package/dist/bigconsole/contexts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/contexts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,OAAO,EACP,KAAK,YAAY,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/bigconsole/customWidget/CustomWidgetBuilderSheet.d.ts

@@ -0,0 +1,14 @@
+import { FC } from 'react';
+import { CustomWidgetProposalSource } from './proposalSource';
+
+export interface CustomWidgetBuilderSheetProps {
+    isOpen: boolean;
+    onClose: () => void;
+    dashboardId: string;
+    pageId: string;
+    /** Swap for the GraphQL-backed source once BOFF-3021's backend half lands. */
+    source?: CustomWidgetProposalSource;
+}
+export declare const CustomWidgetBuilderSheet: FC<CustomWidgetBuilderSheetProps>;
+export default CustomWidgetBuilderSheet;
+//# sourceMappingURL=CustomWidgetBuilderSheet.d.ts.map

package/dist/bigconsole/customWidget/CustomWidgetBuilderSheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomWidgetBuilderSheet.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/customWidget/CustomWidgetBuilderSheet.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,EAA8B,MAAM,OAAO,CAAC;AAO5D,OAAO,EAEL,KAAK,0BAA0B,EAGhC,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC;AAQD,eAAO,MAAM,wBAAwB,EAAE,EAAE,CAAC,6BAA6B,CA8HrE,CAAC;AAEH,eAAe,wBAAwB,CAAC"}

package/dist/bigconsole/customWidget/CustomWidgetProposalPanel.d.ts

@@ -0,0 +1,25 @@
+import { FC } from 'react';
+import { CustomWidgetProposal } from './proposalContract';
+import { CustomWidgetProposalSource, ProposalCandidateParser, ProposalCandidateSink } from './proposalSource';
+
+export interface CustomWidgetProposalPanelProps {
+    /** Sinks the user may bind to (already RBAC-filtered by the API). */
+    sinks: readonly ProposalCandidateSink[];
+    /** Parsers the user may bind to. */
+    parsers: readonly ProposalCandidateParser[];
+    /**
+     * Resolves the rows a binding would produce, for the preview. Should reject
+     * (or throw) when the user cannot read the binding, so the panel can show the
+     * access-failure state.
+     */
+    resolvePreviewData: (proposal: CustomWidgetProposal) => Promise<unknown>;
+    /** Persists an approved proposal. Resolves once the widget exists. */
+    onApprove: (proposal: CustomWidgetProposal) => Promise<void>;
+    /** Closes the panel without persisting anything. */
+    onClose: () => void;
+    /** Swap for the GraphQL-backed source once BOFF-3021's backend half lands. */
+    source?: CustomWidgetProposalSource;
+}
+export declare const CustomWidgetProposalPanel: FC<CustomWidgetProposalPanelProps>;
+export default CustomWidgetProposalPanel;
+//# sourceMappingURL=CustomWidgetProposalPanel.d.ts.map

package/dist/bigconsole/customWidget/CustomWidgetProposalPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomWidgetProposalPanel.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/customWidget/CustomWidgetProposalPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,EAAmD,MAAM,OAAO,CAAC;AAQjF,OAAO,EAIL,KAAK,oBAAoB,EAG1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAO1B,MAAM,WAAW,8BAA8B;IAC7C,qEAAqE;IACrE,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACxC,oCAAoC;IACpC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC5C;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,sEAAsE;IACtE,SAAS,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,oDAAoD;IACpD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC;AAmED,eAAO,MAAM,yBAAyB,EAAE,EAAE,CAAC,8BAA8B,CAyevE,CAAC;AAEH,eAAe,yBAAyB,CAAC"}

package/dist/bigconsole/customWidget/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * AI custom widget builder (BOFF-5532).
+ *
+ * `proposalContract` is the typed shape + validation, `proposalSource` is the
+ * seam that will swap to the backend operation from BOFF-3021, and
+ * `CustomWidgetProposalPanel` is the review/approve UI.
+ */
+export { CUSTOM_WIDGET_PROPOSAL_VERSION, PROPOSABLE_WIDGET_TYPES, derivePreviewState, isProposableWidgetType, validateProposal, type CustomWidgetProposal, type ProposableWidgetType, type ProposalBinding, type ProposalFieldMapping, type ProposalIssue, type ProposalIssueCode, type ProposalPresentation, type ProposalPreviewState, type ProposalValidation, type ValidateProposalContext, } from './proposalContract';
+export { localProposalSource, type CustomWidgetProposalSource, type ProposalCandidateParser, type ProposalCandidateSink, type ProposalRequest, } from './proposalSource';
+export { CustomWidgetProposalPanel, type CustomWidgetProposalPanelProps } from './CustomWidgetProposalPanel';
+export { CustomWidgetBuilderSheet, type CustomWidgetBuilderSheetProps } from './CustomWidgetBuilderSheet';
+//# sourceMappingURL=index.d.ts.map

package/dist/bigconsole/customWidget/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/customWidget/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,yBAAyB,EAAE,KAAK,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAE7G,OAAO,EAAE,wBAAwB,EAAE,KAAK,6BAA6B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/bigconsole/customWidget/proposalContract.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Custom-widget proposal contract (BOFF-5532 / BOFF-3021).
+ *
+ * The AI custom-widget builder turns a natural-language prompt into a *typed,
+ * reviewable proposal* rather than writing a widget straight to the dashboard.
+ * This module is the single source of truth for that proposal's shape.
+ *
+ * The backend operation that will eventually emit these proposals is owned by
+ * BOFF-3021's backend half and does not exist yet, so the contract is versioned
+ * and lives here. `proposalSource.ts` is the seam that swaps a local generator
+ * for the real GraphQL operation without any UI change.
+ *
+ * Two rules the contract deliberately encodes, from BOFF-3021's scope:
+ *   1. A proposal only ever *references* governed DataSinks and Parsers by id —
+ *      it can never carry inline data or credentials.
+ *   2. Rendering is declarative and allowlisted. A proposal names a built-in
+ *      widget type and a config; it can never carry executable code, remote
+ *      script URLs, or raw HTML.
+ */
+/** Bump when the proposal shape changes incompatibly. */
+export declare const CUSTOM_WIDGET_PROPOSAL_VERSION: "1.0";
+/**
+ * Widget types a proposal is allowed to request.
+ *
+ * Deliberately narrower than the full `WidgetType` union: these are the
+ * federation-accessible types with production-quality renderers, so an approved
+ * proposal is guaranteed to render. Anything else is rejected at validation.
+ */
+export declare const PROPOSABLE_WIDGET_TYPES: readonly ["chart", "funnel_chart", "heatmap", "table", "metric_card", "retention"];
+export type ProposableWidgetType = (typeof PROPOSABLE_WIDGET_TYPES)[number];
+export declare function isProposableWidgetType(value: unknown): value is ProposableWidgetType;
+/**
+ * How a proposal binds to data. References only — never inline rows, never
+ * credentials, always a workspace-scoped id the gateway will RBAC-check.
+ */
+export interface ProposalBinding {
+    /** DataSink id. Required: data may only enter through a governed sink. */
+    dataSinkId: string;
+    /** Human-readable sink key, carried for display and for export/import resolution. */
+    dataSinkKey?: string;
+    /** Parser id that shapes the sink payload into widget-ready output. */
+    parserId?: string;
+    /** Parser display name, for the review UI. */
+    parserName?: string;
+    /** Dot-notation path applied to the parser output. */
+    dataPath?: string;
+}
+/**
+ * Which fields of the parsed rows feed which visual role. Keys are role names
+ * (`xAxisField`, `valueField`, …); values are field names in the parser output.
+ */
+export type ProposalFieldMapping = Record<string, string>;
+/** Presentation settings the reviewer can edit before approving. */
+export interface ProposalPresentation {
+    title: string;
+    description?: string;
+    /** Declarative widget config — merged into the created widget's `config`. */
+    config: Record<string, unknown>;
+}
+/** A single typed custom-widget proposal awaiting review. */
+export interface CustomWidgetProposal {
+    version: typeof CUSTOM_WIDGET_PROPOSAL_VERSION;
+    /** Client-side id for this proposal; not a widget id. */
+    id: string;
+    /** The prompt this proposal came from, kept as provenance. */
+    sourcePrompt: string;
+    /** What produced it — `local-heuristic-v1` today, a model id once wired. */
+    generatedBy: string;
+    widgetType: ProposableWidgetType;
+    binding: ProposalBinding;
+    fieldMapping: ProposalFieldMapping;
+    presentation: ProposalPresentation;
+    /** Optional short plain-language rationale shown to the reviewer. */
+    rationale?: string;
+}
+export type ProposalIssueCode = 'UNSUPPORTED_WIDGET_TYPE' | 'MISSING_DATASINK' | 'DATASINK_NOT_PERMITTED' | 'MISSING_PARSER' | 'PARSER_NOT_PERMITTED' | 'FIELD_MISMATCH' | 'MISSING_TITLE' | 'UNSAFE_CONTENT' | 'VERSION_UNSUPPORTED';
+export interface ProposalIssue {
+    code: ProposalIssueCode;
+    /** `error` blocks approval; `warning` does not. */
+    severity: 'error' | 'warning';
+    message: string;
+    /** Which part of the proposal to highlight, e.g. `binding.parserId`. */
+    path?: string;
+}
+/**
+ * The preview's observable state. These are exactly the states BOFF-5532
+ * requires the preview to cover.
+ */
+export type ProposalPreviewState = 'loading' | 'valid' | 'no-data' | 'field-mismatch' | 'access-error';
+export interface ProposalValidation {
+    issues: ProposalIssue[];
+    /** True when no `error`-severity issue is present. */
+    canApprove: boolean;
+}
+export interface ValidateProposalContext {
+    /** DataSink ids the current user may bind to (already RBAC-filtered by the API). */
+    permittedDataSinkIds: readonly string[];
+    /** Parser ids the current user may bind to. */
+    permittedParserIds: readonly string[];
+    /**
+     * Field names present in the parser's actual output, when known. When
+     * undefined the field mapping is not checked (preview has not resolved yet).
+     */
+    availableFields?: readonly string[];
+}
+/**
+ * Validates a proposal against what the current user is actually permitted to
+ * bind, and against the declarative-rendering rules.
+ *
+ * Permission checks here are a *UX* affordance so the reviewer sees a clear
+ * message instead of a failed write — the gateway's `@rbac` directives remain
+ * the enforcement boundary.
+ */
+export declare function validateProposal(proposal: CustomWidgetProposal, context: ValidateProposalContext): ProposalValidation;
+/** Derives the preview state from validation plus what the preview fetch returned. */
+export declare function derivePreviewState(validation: ProposalValidation, options: {
+    loading: boolean;
+    accessError?: boolean;
+    rowCount?: number;
+}): ProposalPreviewState;
+//# sourceMappingURL=proposalContract.d.ts.map

package/dist/bigconsole/customWidget/proposalContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposalContract.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/customWidget/proposalContract.ts"],"names":[],"mappings":"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"}

package/dist/bigconsole/customWidget/proposalSource.d.ts

@@ -0,0 +1,41 @@
+import { CustomWidgetProposal } from './proposalContract';
+
+/** A sink the current user may bind to, as the panel knows it. */
+export interface ProposalCandidateSink {
+    id: string;
+    key: string;
+    name?: string | null;
+}
+/**
+ * Converts the workspace store into a proposal-safe candidate set. The API
+ * excludes soft-deleted sinks, but this second boundary is intentional:
+ * persisted client state can outlive an out-of-band deletion, and a sink whose
+ * deletion signal is missing from a lightweight list fragment must still be
+ * excluded if its active flag has been cleared.
+ */
+export declare function selectActiveProposalSinks(sinks: ReadonlyArray<ProposalCandidateSink & {
+    deletedAt?: string | null;
+    isActive?: boolean | null;
+}>): ProposalCandidateSink[];
+/** A parser the current user may bind to. */
+export interface ProposalCandidateParser {
+    id: string;
+    name: string;
+    inputSinkKey: string;
+}
+export interface ProposalRequest {
+    prompt: string;
+    sinks: readonly ProposalCandidateSink[];
+    parsers: readonly ProposalCandidateParser[];
+}
+export interface CustomWidgetProposalSource {
+    /** Stable id, surfaced in the UI so reviewers know what produced a proposal. */
+    readonly id: string;
+    propose(request: ProposalRequest): Promise<CustomWidgetProposal>;
+}
+/**
+ * Derives a proposal from the prompt and the workspace's real, permitted sinks
+ * and parsers. Deterministic, so the review UI and its tests behave predictably.
+ */
+export declare const localProposalSource: CustomWidgetProposalSource;
+//# sourceMappingURL=proposalSource.d.ts.map

package/dist/bigconsole/customWidget/proposalSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposalSource.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/customWidget/proposalSource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAEL,KAAK,oBAAoB,EAG1B,MAAM,oBAAoB,CAAC;AAE5B,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,aAAa,CAAC,qBAAqB,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,CAAC,GACrG,qBAAqB,EAAE,CAIzB;AAED,6CAA6C;AAC7C,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACxC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClE;AAkHD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,0BAiCjC,CAAC"}

package/dist/bigconsole/graphql/apollo-compat.d.ts

@@ -0,0 +1,16 @@
+import { OperationVariables } from '@apollo/client';
+import { MutationTuple, MutationHookOptions } from '@apollo/client/react';
+/**
+ * Apollo Client 4.x Compatibility Module
+ *
+ * Apollo Client 4 separated core and React exports.
+ * This module re-exports everything needed by the generated GraphQL operations
+ * from a single namespace, maintaining backward compatibility with codegen output.
+ */
+export * from '@apollo/client';
+export { useMutation, useQuery, useLazyQuery, useSuspenseQuery, skipToken } from '@apollo/client/react';
+export type { SkipToken } from '@apollo/client/react';
+export type { MutationHookOptions, MutationResult, QueryHookOptions, QueryResult, LazyQueryHookOptions, SuspenseQueryHookOptions, UseSuspenseQueryResult, } from '@apollo/client/react';
+export type MutationFunction<TData = unknown, TVariables extends OperationVariables = OperationVariables> = MutationTuple<TData, TVariables>[0];
+export type BaseMutationOptions<TData = unknown, TVariables extends OperationVariables = OperationVariables> = MutationHookOptions<TData, TVariables>;
+//# sourceMappingURL=apollo-compat.d.ts.map

package/dist/bigconsole/graphql/apollo-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apollo-compat.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/graphql/apollo-compat.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAExG,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAW9B,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,MAAM,MAAM,gBAAgB,CAC1B,KAAK,GAAG,OAAO,EACf,UAAU,SAAS,kBAAkB,GAAG,kBAAkB,IACxD,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAMxC,MAAM,MAAM,mBAAmB,CAC7B,KAAK,GAAG,OAAO,EACf,UAAU,SAAS,kBAAkB,GAAG,kBAAkB,IACxD,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC"}

package/dist/bigconsole/graphql/storeTemplates.d.ts

@@ -0,0 +1,9 @@
+export { BrowseDashboardTemplatesDocument as BROWSE_DASHBOARD_TEMPLATES, GetDashboardTemplateDetailDocument as GET_DASHBOARD_TEMPLATE_DETAIL, CreateDashboardTemplateAppDocument as CREATE_TEMPLATE_APP, CreateDashboardTemplateVersionDocument as CREATE_TEMPLATE_VERSION, } from '../../generated/global-operations';
+export declare const IMPORT_DASHBOARD_TEMPLATE: import('graphql').DocumentNode;
+/**
+ * Same interim treatment as IMPORT_DASHBOARD_TEMPLATE, and for the same reason:
+ * buildDashboardTemplateContent is new in wspace-bigconsole-svc and is not yet
+ * in the checked-in wspace schema.
+ */
+export declare const BUILD_DASHBOARD_TEMPLATE_CONTENT: import('graphql').DocumentNode;
+//# sourceMappingURL=storeTemplates.d.ts.map

package/dist/bigconsole/graphql/storeTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeTemplates.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/graphql/storeTemplates.ts"],"names":[],"mappings":"AAyBA,OAAO,EACL,gCAAgC,IAAI,0BAA0B,EAC9D,kCAAkC,IAAI,6BAA6B,EACnE,kCAAkC,IAAI,mBAAmB,EACzD,sCAAsC,IAAI,uBAAuB,GAClE,MAAM,mCAAmC,CAAC;AAE3C,eAAO,MAAM,yBAAyB,gCAmBrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,gCAqB5C,CAAC"}

package/dist/bigconsole/hooks/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * BigConsole Hooks
+ *
+ * Custom React hooks for widget and dashboard functionality.
+ */
+export { useWidgetData, useWidgetsData, default as useWidgetDataDefault } from './useWidgetData';
+export { useWidgetCatalog, default as useWidgetCatalogDefault } from './useWidgetCatalog';
+export type { UseWidgetCatalogParams, UseWidgetCatalogResult } from './useWidgetCatalog';
+export { useAutoRefresh, useWidgetAutoRefresh, formatTimeUntilRefresh, default as useAutoRefreshDefault, } from './useAutoRefresh';
+export { useWidgetOperations, default as useWidgetOperationsDefault } from './useWidgetOperations';
+export { useWidgetComments, WIDGET_COMMENT_ENTITY_TYPE, type WidgetCommentThread, type UseWidgetCommentsResult, default as useWidgetCommentsDefault, } from './useWidgetComments';
+export { useWidgetConfigPersist, type UseWidgetConfigPersistResult, default as useWidgetConfigPersistDefault, } from './useWidgetConfigPersist';
+export { useDashboardOperations, default as useDashboardOperationsDefault, type DashboardListItem, } from './useDashboardOperations';
+export { useWidgetExport, type UseWidgetExportOptions, type UseWidgetExportResult, default as useWidgetExportDefault, } from './useWidgetExport';
+export { useDashboardImageExport, type UseDashboardImageExportOptions, type UseDashboardImageExportResult, default as useDashboardImageExportDefault, } from './useDashboardImageExport';
+export { useDrilldown, type DrilldownContext, type UseDrilldownOptions, type UseDrilldownResult, default as useDrilldownDefault, } from './useDrilldown';
+export { useDrilldownOperations, type CreateDrilldownInput, type UpdateDrilldownInput, type UseDrilldownOperationsResult, default as useDrilldownOperationsDefault, } from './useDrilldownOperations';
+export { useWidgetEvents, createWidgetActionHandler, type EventStatus, type EventLog, type EmitEventInput, type UseWidgetEventsOptions, type UseWidgetEventsResult, default as useWidgetEventsDefault, } from './useWidgetEvents';
+export { useWidgetActions, type ActionType, type ActionStyle, type ActionConfirmation, type WidgetAction, type CreateWidgetActionInput, type UpdateWidgetActionInput, type UseWidgetActionsOptions, type UseWidgetActionsResult, default as useWidgetActionsDefault, } from './useWidgetActions';
+export { useExportDashboard, type ExportDashboardOptions, type UseExportDashboardResult, default as useExportDashboardDefault, } from './useExportDashboard';
+export { useImportDashboard, type ImportDashboardInfo, type ImportValidationError, type ImportValidationWarning, type ImportValidationResult, type ImportStats, type ImportDashboardResult, type ImportDashboardOptions, type UseImportDashboardResult, default as useImportDashboardDefault, } from './useImportDashboard';
+export { useEventWebhooks, type HttpMethod, type RetryPolicy, type EventWebhookMapping, type CreateEventWebhookMappingInput, type UpdateEventWebhookMappingInput, type WebhookTestResult, type UseEventWebhooksOptions, type UseEventWebhooksResult, default as useEventWebhooksDefault, } from './useEventWebhooks';
+export { useEventLogs, getEventStatusColor, getEventStatusLabel, getEventStatusIcon, type EventLog as EventLogType, type EventLogEdge, type EventLogConnection, type UseEventLogsOptions, type UseEventLogsResult, default as useEventLogsDefault, } from './useEventLogs';
+export { useDataSinkOperations, default as useDataSinkOperationsDefault } from './useDataSinkOperations';
+export { useBigConsoleAnalytics, type BigConsoleAnalyticsEventName, type BigConsoleAnalyticsPayloadMap, default as useBigConsoleAnalyticsDefault, } from './useBigConsoleAnalytics';
+export { useParserOperations, default as useParserOperationsDefault } from './useParserOperations';
+export { useWorkflowOperations, default as useWorkflowOperationsDefault } from './useWorkflowOperations';
+export { usePipelineOperations, default as usePipelineOperationsDefault } from './usePipelineOperations';
+export { useGlobalFilters, type FilterType, type GlobalFilter, type CreateGlobalFilterInput, type UpdateGlobalFilterInput, type UseGlobalFiltersResult, default as useGlobalFiltersDefault, } from './useGlobalFilters';
+export { useDashboardSharing, type ShareRecipientType, type SharePermission, type DashboardShare, type ShareDashboardInput, type UpdateShareInput, type UseDashboardSharingResult, default as useDashboardSharingDefault, } from './useDashboardSharing';
+export { useDashboardViews, type DashboardView, type CreateDashboardViewInput, type UpdateDashboardViewInput, type UseDashboardViewsResult, default as useDashboardViewsDefault, } from './useDashboardViews';
+export { useDashboardTemplates, type DashboardCategory, type TemplateComplexity, type TemplateAuthorType, type TemplateStatus, type DashboardTemplate, type DashboardTemplateListItem, type CreateTemplateInput, type UpdateTemplateInput, type InstantiateTemplateInput, type RateTemplateInput, type ListTemplatesFilters, type UseDashboardTemplatesResult, default as useDashboardTemplatesDefault, } from './useDashboardTemplates';
+export { useFilterUrlSync, default as useFilterUrlSyncDefault } from './useFilterUrlSync';
+export { useFilterPresets, type FilterPreset, type CreatePresetInput, type UpdatePresetInput, type UseFilterPresetsResult, default as useFilterPresetsDefault, } from './useFilterPresets';
+export { useCrossFilter, createChartCrossFilterMapping, createDateRangeCrossFilterMapping, createMultiSelectCrossFilterMapping, type CrossFilterMode, type CrossFilterMapping, type CrossFilterConfig, type CrossFilterClickData, type UseCrossFilterOptions, type UseCrossFilterResult, default as useCrossFilterDefault, } from './useCrossFilter';
+export { usePageOperations, type PageLayout, default as usePageOperationsDefault } from './usePageOperations';
+export { useExportParser, type ExportParserOptions, type UseExportParserResult, default as useExportParserDefault, } from './useExportParser';
+export { useImportParser, type ImportParserInfo, type ImportParserValidationError, type ImportParserValidationResult, type ImportParserResult, type ImportParserOptions, type UseImportParserResult, default as useImportParserDefault, } from './useImportParser';
+export { useExportDataSink, type ExportDataSinkOptions, type UseExportDataSinkResult, default as useExportDataSinkDefault, } from './useExportDataSink';
+export { useImportDataSink, type ImportDataSinkInfo, type ImportDataSinkValidationError, type ImportDataSinkValidationResult, type ImportDataSinkResult, type ImportDataSinkOptions, type UseImportDataSinkResult, default as useImportDataSinkDefault, } from './useImportDataSink';
+//# sourceMappingURL=index.d.ts.map

package/dist/bigconsole/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/hooks/index.ts"],"names":[],"mappings":"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"}

package/dist/bigconsole/hooks/useActivePage.d.ts

@@ -0,0 +1,37 @@
+/**
+ * useActivePage Hook (BOFF-7625)
+ *
+ * Keeps a dashboard's active page in the URL (`?page=<pageId>`) instead of
+ * component state, so:
+ * - switching page tabs adds a browser history entry and Back returns to the
+ *   previous page instead of leaving the dashboard;
+ * - a drilldown can land on a specific page (`/dashboards/:id?page=…`), and a
+ *   drilldown into another page of the same dashboard is a plain navigation;
+ * - a reload or a shared link reopens the same page.
+ *
+ * An absent or unknown page id (deleted page, stale link) falls back to the
+ * dashboard's first page.
+ */
+/** URL search param that carries the active page id. */
+export declare const PAGE_PARAM = "page";
+interface PageRef {
+    readonly id: string;
+}
+export interface UseActivePageResult {
+    /** The page to render: the URL's page when it exists, else the first page. */
+    activePageId: string | undefined;
+    /** Raw page id from the URL, even when it does not match a page. */
+    requestedPageId: string | null;
+    /**
+     * Switch page. Pushes a history entry by default; pass `replace` for
+     * corrections that should not be a Back step (e.g. after deleting the page).
+     */
+    setActivePage: (pageId: string, options?: {
+        replace?: boolean;
+    }) => void;
+}
+/** Resolve the page to show from the requested id and the dashboard's pages. */
+export declare function resolveActivePageId(pages: readonly PageRef[] | undefined, requestedPageId: string | null): string | undefined;
+export declare function useActivePage(pages: readonly PageRef[] | undefined): UseActivePageResult;
+export default useActivePage;
+//# sourceMappingURL=useActivePage.d.ts.map

package/dist/bigconsole/hooks/useActivePage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActivePage.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/hooks/useActivePage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,wDAAwD;AACxD,eAAO,MAAM,UAAU,SAAS,CAAC;AAEjC,UAAU,OAAO;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,oEAAoE;IACpE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;OAGG;IACH,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC1E;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,EACrC,eAAe,EAAE,MAAM,GAAG,IAAI,GAC7B,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,GAAG,mBAAmB,CAqBxF;AAED,eAAe,aAAa,CAAC"}

package/dist/bigconsole/hooks/useActivePage.js

@@ -0,0 +1,25 @@
+import { useCallback as e, useMemo as t } from "react";
+import { useLocation as n, useNavigate as r } from "react-router";
+//#region src/bigconsole/hooks/useActivePage.ts
+var i = "page";
+function a(e, t) {
+	if (!(!e || e.length === 0)) return t && e.some((e) => e.id === t) ? t : e[0]?.id;
+}
+function o(o) {
+	let s = n(), c = r(), l = t(() => new URLSearchParams(s.search).get(i), [s.search]);
+	return {
+		activePageId: t(() => a(o, l), [o, l]),
+		requestedPageId: l,
+		setActivePage: e((e, t) => {
+			let n = new URLSearchParams(window.location.search);
+			n.get("page") !== e && (n.set(i, e), c({
+				pathname: s.pathname,
+				search: `?${n.toString()}`
+			}, { replace: t?.replace }));
+		}, [c, s.pathname])
+	};
+}
+//#endregion
+export { i as PAGE_PARAM, o as default };
+
+//# sourceMappingURL=useActivePage.js.map

package/dist/bigconsole/hooks/useActivePage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActivePage.js","names":[],"sources":["../../../src/bigconsole/hooks/useActivePage.ts"],"sourcesContent":["/**\n * useActivePage Hook (BOFF-7625)\n *\n * Keeps a dashboard's active page in the URL (`?page=<pageId>`) instead of\n * component state, so:\n * - switching page tabs adds a browser history entry and Back returns to the\n *   previous page instead of leaving the dashboard;\n * - a drilldown can land on a specific page (`/dashboards/:id?page=…`), and a\n *   drilldown into another page of the same dashboard is a plain navigation;\n * - a reload or a shared link reopens the same page.\n *\n * An absent or unknown page id (deleted page, stale link) falls back to the\n * dashboard's first page.\n */\n\nimport { useCallback, useMemo } from 'react';\nimport { useLocation, useNavigate } from 'react-router';\n\n/** URL search param that carries the active page id. */\nexport const PAGE_PARAM = 'page';\n\ninterface PageRef {\n  readonly id: string;\n}\n\nexport interface UseActivePageResult {\n  /** The page to render: the URL's page when it exists, else the first page. */\n  activePageId: string | undefined;\n  /** Raw page id from the URL, even when it does not match a page. */\n  requestedPageId: string | null;\n  /**\n   * Switch page. Pushes a history entry by default; pass `replace` for\n   * corrections that should not be a Back step (e.g. after deleting the page).\n   */\n  setActivePage: (pageId: string, options?: { replace?: boolean }) => void;\n}\n\n/** Resolve the page to show from the requested id and the dashboard's pages. */\nexport function resolveActivePageId(\n  pages: readonly PageRef[] | undefined,\n  requestedPageId: string | null\n): string | undefined {\n  if (!pages || pages.length === 0) return undefined;\n  if (requestedPageId && pages.some((page) => page.id === requestedPageId)) return requestedPageId;\n  return pages[0]?.id;\n}\n\nexport function useActivePage(pages: readonly PageRef[] | undefined): UseActivePageResult {\n  const location = useLocation();\n  const navigate = useNavigate();\n\n  const requestedPageId = useMemo(() => new URLSearchParams(location.search).get(PAGE_PARAM), [location.search]);\n  const activePageId = useMemo(() => resolveActivePageId(pages, requestedPageId), [pages, requestedPageId]);\n\n  const setActivePage = useCallback(\n    (pageId: string, options?: { replace?: boolean }) => {\n      // Start from the live URL, not the router's copy: the global-filter sync\n      // rewrites `filter_*` params with history.replaceState behind the router,\n      // and rebuilding from `location.search` would drop them.\n      const params = new URLSearchParams(window.location.search);\n      if (params.get(PAGE_PARAM) === pageId) return;\n      params.set(PAGE_PARAM, pageId);\n      navigate({ pathname: location.pathname, search: `?${params.toString()}` }, { replace: options?.replace });\n    },\n    [navigate, location.pathname]\n  );\n\n  return { activePageId, requestedPageId, setActivePage };\n}\n\nexport default useActivePage;\n"],"mappings":";;;AAmBA,IAAa,IAAa;AAmB1B,SAAgB,EACd,GACA,GACoB;AAChB,QAAC,KAAS,EAAM,WAAW,GAE/B,QADI,KAAmB,EAAM,MAAM,MAAS,EAAK,OAAO,EAAgB,GAAS,IAC1E,EAAM,IAAI;;AAGnB,SAAgB,EAAc,GAA4D;CACxF,IAAM,IAAW,GAAa,EACxB,IAAW,GAAa,EAExB,IAAkB,QAAc,IAAI,gBAAgB,EAAS,OAAO,CAAC,IAAI,EAAW,EAAE,CAAC,EAAS,OAAO,CAAC;AAgB9G,QAAO;EAAE,cAfY,QAAc,EAAoB,GAAO,EAAgB,EAAE,CAAC,GAAO,EAAgB,CAAC;EAelF;EAAiB,eAblB,GACnB,GAAgB,MAAoC;GAInD,IAAM,IAAS,IAAI,gBAAgB,OAAO,SAAS,OAAO;AACtD,KAAO,IAAA,OAAe,KAAK,MAC/B,EAAO,IAAI,GAAY,EAAO,EAC9B,EAAS;IAAE,UAAU,EAAS;IAAU,QAAQ,IAAI,EAAO,UAAU;IAAI,EAAE,EAAE,SAAS,GAAS,SAAS,CAAC;KAE3G,CAAC,GAAU,EAAS,SAAS,CAC9B;EAEsD"}

package/dist/bigconsole/hooks/useAutoRefresh.d.ts

@@ -0,0 +1,51 @@
+/**
+ * useAutoRefresh Hook
+ *
+ * Manages automatic data refresh for widgets based on their refresh interval.
+ * Handles pause/resume and manual refresh triggering.
+ */
+interface UseAutoRefreshOptions {
+    /** Refresh interval in seconds (0 to disable) */
+    interval: number | null | undefined;
+    /** Callback to execute on refresh */
+    onRefresh: () => Promise<void> | void;
+    /** Whether auto-refresh is enabled */
+    enabled?: boolean;
+    /** Whether to refresh immediately on mount */
+    immediate?: boolean;
+    /** Callback when refresh completes */
+    onComplete?: () => void;
+    /** Callback when refresh fails */
+    onError?: (error: Error) => void;
+}
+interface UseAutoRefreshResult {
+    /** Whether a refresh is currently in progress */
+    isRefreshing: boolean;
+    /** Whether auto-refresh is currently paused */
+    isPaused: boolean;
+    /** Time until next refresh (in seconds) */
+    timeUntilRefresh: number;
+    /** Pause auto-refresh */
+    pause: () => void;
+    /** Resume auto-refresh */
+    resume: () => void;
+    /** Manually trigger a refresh */
+    refresh: () => Promise<void>;
+    /** Reset the refresh timer */
+    resetTimer: () => void;
+}
+export declare function useAutoRefresh(options: UseAutoRefreshOptions): UseAutoRefreshResult;
+interface UseWidgetAutoRefreshOptions {
+    /** Widget ID */
+    widgetId: string;
+    /** Refresh interval in seconds */
+    refreshInterval: number | null | undefined;
+    /** Refresh callback */
+    onRefresh: () => Promise<void>;
+    /** Whether to enable auto-refresh */
+    enabled?: boolean;
+}
+export declare function useWidgetAutoRefresh(options: UseWidgetAutoRefreshOptions): UseAutoRefreshResult;
+export declare function formatTimeUntilRefresh(seconds: number): string;
+export default useAutoRefresh;
+//# sourceMappingURL=useAutoRefresh.d.ts.map

package/dist/bigconsole/hooks/useAutoRefresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutoRefresh.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/hooks/useAutoRefresh.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,UAAU,qBAAqB;IAC7B,iDAAiD;IACjD,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,qCAAqC;IACrC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtC,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,UAAU,oBAAoB;IAC5B,iDAAiD;IACjD,YAAY,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,iCAAiC;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAMD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CAkJnF;AAMD,UAAU,2BAA2B;IACnC,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,uBAAuB;IACvB,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAiBD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,wBAyBxE;AAMD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO9D;AAED,eAAe,cAAc,CAAC"}

package/dist/bigconsole/hooks/useBigConsoleAnalytics.d.ts

@@ -0,0 +1,48 @@
+export type BigConsoleAnalyticsEventName = 'bigconsole.ai.create_dashboard_clicked' | 'bigconsole.ai.dashboard_created' | 'bigconsole.ai.dashboard_generated' | 'bigconsole.ai.generate_clicked' | 'bigconsole.dashboard.import_clicked' | 'bigconsole.dashboard.imported' | 'bigconsole.dashboard.share_clicked' | 'bigconsole.dashboard.shared' | 'bigconsole.data_sink.import_clicked' | 'bigconsole.data_sink.imported' | 'bigconsole.widget.create_clicked' | 'bigconsole.widget.created' | 'bigconsole.widget.duplicate_clicked' | 'bigconsole.widget.duplicated';
+interface BigConsoleImportPayload {
+    source?: 'import';
+}
+interface BigConsoleDashboardPayload extends BigConsoleImportPayload {
+    dashboardId?: string;
+    originalUpdated?: boolean;
+}
+interface BigConsoleDashboardSharePayload {
+    dashboardId?: string;
+    permission?: string;
+    recipientType?: string;
+}
+interface BigConsoleDataSinkPayload extends BigConsoleImportPayload {
+    dataSinkId?: string;
+    originalUpdated?: boolean;
+}
+interface BigConsoleWidgetPayload {
+    dashboardId?: string;
+    pageId?: string;
+    sourceWidgetId?: string;
+    widgetId?: string;
+    widgetType?: string;
+}
+interface BigConsoleAiPayload {
+    dashboardId?: string;
+    generationId?: string;
+    maxWidgets?: number;
+}
+export interface BigConsoleAnalyticsPayloadMap {
+    'bigconsole.ai.create_dashboard_clicked': BigConsoleAiPayload;
+    'bigconsole.ai.dashboard_created': BigConsoleAiPayload;
+    'bigconsole.ai.dashboard_generated': BigConsoleAiPayload;
+    'bigconsole.ai.generate_clicked': BigConsoleAiPayload;
+    'bigconsole.dashboard.import_clicked': BigConsoleImportPayload;
+    'bigconsole.dashboard.imported': BigConsoleDashboardPayload;
+    'bigconsole.dashboard.share_clicked': BigConsoleDashboardSharePayload;
+    'bigconsole.dashboard.shared': BigConsoleDashboardSharePayload;
+    'bigconsole.data_sink.import_clicked': BigConsoleImportPayload;
+    'bigconsole.data_sink.imported': BigConsoleDataSinkPayload;
+    'bigconsole.widget.create_clicked': BigConsoleWidgetPayload;
+    'bigconsole.widget.created': BigConsoleWidgetPayload;
+    'bigconsole.widget.duplicate_clicked': BigConsoleWidgetPayload;
+    'bigconsole.widget.duplicated': BigConsoleWidgetPayload;
+}
+export declare function useBigConsoleAnalytics(): <TName extends BigConsoleAnalyticsEventName>(name: TName, payload: BigConsoleAnalyticsPayloadMap[TName]) => void;
+export default useBigConsoleAnalytics;
+//# sourceMappingURL=useBigConsoleAnalytics.d.ts.map

package/dist/bigconsole/hooks/useBigConsoleAnalytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBigConsoleAnalytics.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/hooks/useBigConsoleAnalytics.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,4BAA4B,GACpC,wCAAwC,GACxC,iCAAiC,GACjC,mCAAmC,GACnC,gCAAgC,GAChC,qCAAqC,GACrC,+BAA+B,GAC/B,oCAAoC,GACpC,6BAA6B,GAC7B,qCAAqC,GACrC,+BAA+B,GAC/B,kCAAkC,GAClC,2BAA2B,GAC3B,qCAAqC,GACrC,8BAA8B,CAAC;AAEnC,UAAU,uBAAuB;IAC/B,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED,UAAU,0BAA2B,SAAQ,uBAAuB;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,UAAU,+BAA+B;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,yBAA0B,SAAQ,uBAAuB;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,UAAU,uBAAuB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,mBAAmB;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,wCAAwC,EAAE,mBAAmB,CAAC;IAC9D,iCAAiC,EAAE,mBAAmB,CAAC;IACvD,mCAAmC,EAAE,mBAAmB,CAAC;IACzD,gCAAgC,EAAE,mBAAmB,CAAC;IACtD,qCAAqC,EAAE,uBAAuB,CAAC;IAC/D,+BAA+B,EAAE,0BAA0B,CAAC;IAC5D,oCAAoC,EAAE,+BAA+B,CAAC;IACtE,6BAA6B,EAAE,+BAA+B,CAAC;IAC/D,qCAAqC,EAAE,uBAAuB,CAAC;IAC/D,+BAA+B,EAAE,yBAAyB,CAAC;IAC3D,kCAAkC,EAAE,uBAAuB,CAAC;IAC5D,2BAA2B,EAAE,uBAAuB,CAAC;IACrD,qCAAqC,EAAE,uBAAuB,CAAC;IAC/D,8BAA8B,EAAE,uBAAuB,CAAC;CACzD;AAED,wBAAgB,sBAAsB,IAAI,CAAC,KAAK,SAAS,4BAA4B,EACnF,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,6BAA6B,CAAC,KAAK,CAAC,KAC1C,IAAI,CASR;AAED,eAAe,sBAAsB,CAAC"}