@burdenoff/microfe-bigconsole 2026.930.2 → 2026.1001.2

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/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"}

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

@@ -0,0 +1,79 @@
+/**
+ * useCrossFilter Hook
+ *
+ * Enables cross-filtering functionality for dashboard widgets.
+ * When a user clicks on a data point in a widget, it can update global filters.
+ */
+export type CrossFilterMode = 'replace' | 'add' | 'toggle';
+export interface CrossFilterMapping {
+    /** The field from clicked data */
+    sourceField: string;
+    /** The target filter ID */
+    targetFilterId: string;
+    /** Transform function for the value */
+    transform?: (value: unknown) => unknown;
+}
+export interface CrossFilterConfig {
+    /** Filter mappings from source fields to target filters */
+    mappings: CrossFilterMapping[];
+    /** How to apply the filter: replace, add to array, or toggle */
+    mode?: CrossFilterMode;
+    /** Whether to emit an event when cross-filtering */
+    emitEvent?: boolean;
+    /** Callback when cross-filter is applied */
+    onApply?: (filters: Record<string, unknown>) => void;
+}
+export interface CrossFilterClickData {
+    /** The raw data from the clicked element */
+    data: Record<string, unknown>;
+    /** The widget ID that triggered the click */
+    widgetId: string;
+    /** Optional label for the clicked element */
+    label?: string;
+    /** Optional series name (for charts) */
+    series?: string;
+    /** The original event */
+    event?: MouseEvent;
+}
+export interface UseCrossFilterOptions {
+    /** Default configuration for cross-filtering */
+    config?: CrossFilterConfig;
+    /** Whether cross-filtering is enabled */
+    enabled?: boolean;
+    /** Debounce delay in ms */
+    debounceMs?: number;
+}
+export interface UseCrossFilterResult {
+    /** Apply cross-filter from clicked data */
+    applyCrossFilter: (clickData: CrossFilterClickData, config?: CrossFilterConfig) => void;
+    /** Clear cross-filter for specific filter IDs */
+    clearCrossFilter: (filterIds: string[]) => void;
+    /** Clear all cross-filters */
+    clearAllCrossFilters: () => void;
+    /** Check if a value is cross-filtered */
+    isCrossFiltered: (filterId: string, value: unknown) => boolean;
+    /** Get the source of a cross-filter */
+    getCrossFilterSource: (filterId: string) => string | null;
+    /** Whether cross-filtering is currently active */
+    hasCrossFilters: boolean;
+    /** Map of filter IDs to their source widget IDs */
+    crossFilterSources: Record<string, string>;
+}
+export declare function useCrossFilter(options?: UseCrossFilterOptions): UseCrossFilterResult;
+/**
+ * Create a cross-filter mapping for common chart click scenarios
+ */
+export declare function createChartCrossFilterMapping(categoryField: string, targetFilterId: string, options?: {
+    mode?: CrossFilterMode;
+    transform?: (value: unknown) => unknown;
+}): CrossFilterConfig;
+/**
+ * Create cross-filter mappings for date range selection
+ */
+export declare function createDateRangeCrossFilterMapping(startField: string, endField: string, targetFilterId: string): CrossFilterConfig;
+/**
+ * Create cross-filter mappings for multi-value selection (e.g., legend clicks)
+ */
+export declare function createMultiSelectCrossFilterMapping(sourceField: string, targetFilterId: string): CrossFilterConfig;
+export default useCrossFilter;
+//# sourceMappingURL=useCrossFilter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCrossFilter.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/hooks/useCrossFilter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,gEAAgE;IAChE,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,gBAAgB,EAAE,CAAC,SAAS,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACxF,iDAAiD;IACjD,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAChD,8BAA8B;IAC9B,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,yCAAyC;IACzC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC/D,uCAAuC;IACvC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC1D,kDAAkD;IAClD,eAAe,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAMD,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,oBAAoB,CAiLxF;AAMD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;IACR,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACzC,GACA,iBAAiB,CAWnB;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,iBAAiB,CAcnB;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,iBAAiB,CAUlH;AAED,eAAe,cAAc,CAAC"}

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

@@ -0,0 +1,72 @@
+import { DashboardEmbedTheme } from '../../generated/wspace-types';
+import { EmbedThemeMode } from '../components/embed/types';
+
+export type EmbedPolicyStatus = 'DRAFT' | 'ACTIVE' | 'NEEDS_REVIEW' | 'BROKEN' | 'REVOKED' | 'EXPIRED';
+/**
+ * Owner-facing color mode (BOFF-5735); maps to the backend {@link DashboardEmbedTheme}
+ * enum. Same shape as the render-model's {@link EmbedThemeMode} — aliased to avoid a
+ * duplicate union.
+ */
+export type EmbedThemeChoice = EmbedThemeMode;
+/**
+ * Publish-time presentation options the owner controls in the Share dialog.
+ * Branding is deliberately absent: every embed carries the "Powered by
+ * BigConsole" footer (Burdenoff does no white-labelling).
+ */
+export interface EmbedPresentationChoice {
+    theme: EmbedThemeChoice;
+    showTitle: boolean;
+}
+/** Map the backend enum back to the lowercase owner-facing choice (defaults to light). */
+export declare function themeChoiceFromPolicy(value: string | null | undefined): EmbedThemeChoice;
+export interface DashboardEmbedPolicy {
+    id: string;
+    dashboardId: string;
+    status: EmbedPolicyStatus;
+    accessMode: string;
+    version: number;
+    allowedParentOrigins: string[];
+    expiresAt?: string | null;
+    sessionTtlSeconds: number;
+    contentReviewState: string;
+    presentationTheme: DashboardEmbedTheme;
+    showDashboardTitle: boolean;
+    activePublicationId?: string | null;
+    locatorPublicId?: string | null;
+    fingerprint?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    activatedAt?: string | null;
+    revokedAt?: string | null;
+}
+/** Returned once on create / rotate — carries the secret embed URL + snippet. */
+export interface EmbedPolicySecret {
+    embedUrl: string;
+    iframeSnippet: string;
+    fingerprint: string;
+    policy: DashboardEmbedPolicy;
+}
+export interface UseDashboardEmbedPolicyResult {
+    /** The dashboard's active (or most recent) embed policy, if any. */
+    policy: DashboardEmbedPolicy | null;
+    /** The one-time secret from the last create/rotate (embed URL + iframe snippet). */
+    secret: EmbedPolicySecret | null;
+    loading: boolean;
+    error: Error | null;
+    fetchPolicy: (dashboardId: string) => Promise<DashboardEmbedPolicy | null>;
+    /** Create (if needed) + publish → returns the live embed secret. */
+    publishToWeb: (dashboardId: string, allowedParentOrigins: string[], contentSafetyAttested: boolean, presentation?: EmbedPresentationChoice) => Promise<EmbedPolicySecret | null>;
+    /**
+     * Persist the presentation options of an already-published policy. They are
+     * read live by the embed renderer, so the change applies on the next render
+     * with no re-publish — the embed link/key are untouched.
+     */
+    applyPresentation: (policyId: string, presentation: EmbedPresentationChoice) => Promise<DashboardEmbedPolicy | null>;
+    setAllowedOrigins: (policyId: string, allowedParentOrigins: string[]) => Promise<DashboardEmbedPolicy | null>;
+    rotateKey: (policyId: string) => Promise<EmbedPolicySecret | null>;
+    /** Unpublish: revoke the policy (embed stops serving immediately). */
+    unpublish: (policyId: string) => Promise<boolean>;
+}
+export declare function useDashboardEmbedPolicy(): UseDashboardEmbedPolicyResult;
+export default useDashboardEmbedPolicy;
+//# sourceMappingURL=useDashboardEmbedPolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDashboardEmbedPolicy.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/hooks/useDashboardEmbedPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAMhE,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvG;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,gBAAgB,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB;AAQD,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,CASxF;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,mBAAmB,CAAC;IACvC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,6BAA6B;IAC5C,oEAAoE;IACpE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC,oFAAoF;IACpF,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAC3E,oEAAoE;IACpE,YAAY,EAAE,CACZ,WAAW,EAAE,MAAM,EACnB,oBAAoB,EAAE,MAAM,EAAE,EAC9B,qBAAqB,EAAE,OAAO,EAC9B,YAAY,CAAC,EAAE,uBAAuB,KACnC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACvC;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,uBAAuB,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACrH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAC9G,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACnE,sEAAsE;IACtE,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACnD;AAcD,wBAAgB,uBAAuB,IAAI,6BAA6B,CA2MvE;AAED,eAAe,uBAAuB,CAAC"}

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

@@ -0,0 +1,18 @@
+import { RefObject } from 'react';
+
+export interface UseDashboardImageExportOptions {
+    /** Ref to the board/grid container element to rasterize. */
+    containerRef: RefObject<HTMLElement | null>;
+    /** Human-readable dashboard name, used for the download filename. */
+    name?: string;
+}
+export interface UseDashboardImageExportResult {
+    /** Export the whole board as a single PNG image. */
+    exportPNG: (filename?: string) => Promise<void>;
+    /** Export the board as a PDF via the browser's print-to-PDF (board image only). */
+    exportPDF: () => Promise<void>;
+    isExporting: boolean;
+}
+export declare function useDashboardImageExport(options: UseDashboardImageExportOptions): UseDashboardImageExportResult;
+export default useDashboardImageExport;
+//# sourceMappingURL=useDashboardImageExport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDashboardImageExport.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/hooks/useDashboardImageExport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9D,MAAM,WAAW,8BAA8B;IAC7C,4DAA4D;IAC5D,YAAY,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC5C,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,6BAA6B;IAC5C,oDAAoD;IACpD,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,mFAAmF;IACnF,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,WAAW,EAAE,OAAO,CAAC;CACtB;AAwED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,6BAA6B,CA6D9G;AAED,eAAe,uBAAuB,CAAC"}