@aintela/bi 0.2.0

package/README.md

@@ -0,0 +1,299 @@
+# `@aintela/bi`
+
+React BI components for the AIA platform, extracted from Envision's dashboard app (Issue 1210, plan in
+`AIA-Solution/Docs/BI/BiLibrary_ExtractionPlan.md` §1.2). It pairs with `@aintela/chat`: the chat library runs the
+LLM-emitted TSX, this package is what that TSX imports.
+
+```
+@aintela/bi            flat union of every subpath — what LLM code imports
+@aintela/bi/data       DataResult, defineSchema / InferModel, coercers, formatters, computeDomain/Ticks, trend helpers
+@aintela/bi/cards      ChartCard, DataTableCard (MUI X Pro), MetricCard, MetricGroupCard, GaugeCard, GaugeGroup, TreeMapCard, MapBubblesCard, MapConnectionsCard
+@aintela/bi/grid       GridLayout, GridCard, GridCardPlaceHolder, useGridConfigTranslator, BiErrorBoundary
+@aintela/bi/inline     Chart (PNG artifact card), Metric, MetricGroup, IFrame — the explorer's present_* vocabulary
+@aintela/bi/hooks      useDashboardData, useDashboardLazyData, DashboardParametersProvider
+@aintela/bi/filters    VizAutoComplete, VizDateRangePicker, VizDatePicker, VizSelect, VizTextField, VizTriggerButton, createFilterComponent
+@aintela/bi/viewer     useDashboardBundle (headless), ScriptDashboardViewer, ScriptDashboardViewerVertical
+@aintela/bi/runtime    registerBiModules, createBiUiTools, loadDashboardBundle / instantiateDashboardBundle, BI_RUNTIME_VERSION
+@aintela/bi/theme      createBiTheme / withBiPalette, useBiPalette, biSeriesColor, BiThemeBridge, biLightPalette, biDarkPalette
+@aintela/bi/client     createBiClient, BiClientProvider, useBiClient (+ the Dashboard / DashboardFolder document routes)
+@aintela/bi/composer   ComposerView, DashboardPad, DashboardPadSketch, ComposerProvider / useComposer, the LLM pad helpers, the environment API
+@aintela/bi/style.css  the grid + inline + composer stylesheet (token-driven, no colours of its own)
+```
+
+## Install
+
+```bash
+npm i @aintela/bi @aintela/chat
+```
+
+Peer dependencies (the host installs them, this package never bundles them):
+
+| peer | version | note |
+|---|---|---|
+| `react`, `react-dom` | ^18.2 | React 18 — `@types/react` must be 18 too |
+| `@mui/material`, `@mui/icons-material` | ^7 | |
+| `@emotion/react`, `@emotion/styled` | ^11.14 | |
+| `@mui/x-data-grid-pro` | ^8 | **Pro** — see the licence note |
+| `@mui/x-date-pickers`, `@mui/x-date-pickers-pro` | ^8 | optional; only the `filters` subpath needs them |
+| `recharts` | ^2.15 | |
+| `react-grid-layout` | ^2.2 | the 2.x major with the `/core` subpath |
+| `react-simple-maps` | ^3 | |
+| `dayjs` | ^1.11 | |
+| `zustand` | ^5 | optional for every other subpath; the `composer` subpath creates its store with it |
+| `framer-motion` | ^11.18 \|\| ^12 | optional; only the `composer` subpath imports it (the splash ↔ execution morph, the side panel, the sketch chips) |
+| `@aintela/chat` | ^0.4.25 | the `runtime` subpath (registry, uiTools) and the `composer` subpath (`PromptV2`, `EnvironmentProvider`, the v2 icons) import it at runtime |
+
+Bundler note: dedupe `react`, `react-dom`, `@mui/material`, `@mui/material/styles`, `@mui/icons-material`,
+`@emotion/react`, `@emotion/styled`, `zustand` across `@aintela/bi` and `@aintela/chat` (obtapp's `vite.config.ts` already
+does this for the chat library — add `@aintela/bi`). Otherwise `useTheme()` reads a different `ThemeContext` than the
+one you created the theme in.
+
+### MUI X licence
+
+`DataTableCard` is MUI X **DataGrid Pro**. The licence key is the host's, set once before the first render:
+
+```ts
+import { LicenseInfo } from '@mui/x-license';
+LicenseInfo.setLicenseKey(import.meta.env.VITE_MUI_LICENSE_KEY);
+```
+
+This package ships no key. If none is set the grid renders MUI's watermark and the card logs one
+`[@aintela/bi] MUI X licence key not set …` warning per session.
+
+## Wiring a host
+
+```tsx
+import { LicenseInfo } from '@mui/x-license';
+import { ThemeProvider, createTheme } from '@mui/material/styles';
+import { AiChatProvider } from '@aintela/chat';
+import { createBiClient, BiClientProvider, createBiTheme, BiThemeBridge, registerBiModules, createBiUiTools } from '@aintela/bi';
+import '@aintela/bi/style.css';
+
+LicenseInfo.setLicenseKey(MUI_KEY);
+
+// 1. Make the library resolvable from LLM-generated code (once, at boot).
+registerBiModules({ specifiers: ['@aintela/bi'] });
+// envision-abi keeps its legacy keys alive forever:
+// registerBiModules({ specifiers: ['@aintela/bi', '@envision/ui-library', '@envision/ui-library/components', '@envision/aichat'], extraScope: VizLibraryShim });
+
+// 2. One client per server. Routes default to the legacy WSServer layout; override what differs.
+const bi = createBiClient({
+    baseUrl: import.meta.env.VITE_BI_BASE_URL,
+    getAuthHeader: () => `Bearer ${getAccessToken()}`,
+    routes: { artifact: (src, { sessionId }) => `${AGENTS_URL}/artifacts/${sessionId}/${src}` },
+});
+
+// 3. present_chart / present_metric / present_metric_group / present_iframe; the host adds the rest.
+const uiTools = createBiUiTools({ client: bi })
+    .render('present_dashboard', (a) => <ScriptDashboardViewer dashboardId={a.id} />)
+    .build();
+
+// 4. Theme: your theme + the BI palette (light and dark defaults ship; set `palette.bi` to override).
+const theme = createBiTheme(createTheme({ palette: { mode: 'light', primary: { main: BRAND } } }));
+
+<ThemeProvider theme={theme}>
+  <BiThemeBridge>                          {/* publishes the --bi-* CSS variables the stylesheet reads */}
+    <BiClientProvider client={bi} sessionId={sessionId}>
+      <AiChatProvider uiTools={uiTools} …/>
+    </BiClientProvider>
+  </BiThemeBridge>
+</ThemeProvider>
+```
+
+`registerBiModules` calls the chat library's `extendModuleRegistry(specifier, surface)` once per specifier,
+`extendDefaultScope(surface)` once, and seeds the dashboard-bundle loader's `require()` map under the same strings.
+`BI_RUNTIME_VERSION` is the package version — log a mismatch against the server's `AIntelA.Bi.Agents` at handshake.
+
+### `BiClientProvider` / `createBiClient`
+
+Every server call in the package goes through one `BiClient`: `useDashboardData`, `useDashboardLazyData` (page,
+distinct values, CSV/XLSX export), `VizAutoComplete` options, `useDashboardBundle` (dashboard document, bundle code,
+sub-agent status) and the inline `Chart` / `IFrame` URLs (`client.artifactUrl(src, { sessionId?, dashboardId? })`).
+Nothing reads `process.env`, `import.meta.env` or a hard-coded host. `fetch` is injectable (tests, custom transports);
+`getAuthHeader` may be async.
+
+### Data hooks
+
+```tsx
+const { toDataResult, loading } = useDashboardData('<query hash>');   // inside a DashboardParametersProvider
+const data = toDataResult({ month: 'date', spend: 'number' });
+<ChartCard data={data} type="barV" xAxis="month" series={[{ dataKey: 'spend' }]} loading={loading} />
+
+const lazy = useDashboardLazyData('<view id>', { airline: { type: 'string', values: 'distinct' }, total: 'number' });
+<DataTableCard lazyData={lazy} />                                       // server-side page / sort / filter / export
+```
+
+## Theming contract (plan §2.3, decision D8)
+
+**No colour literal exists in this package outside `src/theme/biPalette.ts`.** Components read the MUI theme
+(`theme.palette.divider`, `text.secondary`, `action.hover`, `background.paper`, `alpha(text.primary, 0.08)` for
+translucent overlays, `error/warning/success` for gauge bands); the two stylesheets read `--bi-*` custom properties
+that `<BiThemeBridge/>` (or `useBiCssVars()`) derives from the theme; DataGrid Pro is styled through `sx` tokens.
+
+The series palette is a theme augmentation:
+
+```ts
+declare module '@mui/material/styles' {
+  interface Palette { bi: { series: string[]; positive: string; negative: string; neutral: string } }
+}
+```
+
+`createBiTheme(theme)` / `withBiPalette(theme)` fill `palette.bi` from `biLightPalette` or `biDarkPalette` by
+`palette.mode` when the host did not set it; `useBiPalette()` and `biSeriesColor(theme, i)` read it;
+`ChartCardDefaultsProvider palette={…}` is the per-dashboard override.
+
+Enforced three ways: ESLint `no-restricted-syntax` on `#hex` / `rgb(a)` / `hsl(a)` literals in `.ts/.tsx`
+(`src/theme/biPalette.ts` is the only override), stylelint `color-no-hex` + `color-named: never` +
+`function-disallowed-list` on `.css`, and `tests/theme/colourLiterals.test.ts`, which walks `src/` and fails on any
+literal outside the palette file.
+
+## Composer (`@aintela/bi/composer`)
+
+The authoring UI extracted from the dashboard app's `components/dashboardPad/**` + `views/composer/**` (plan §1.2, Phase 4
+item 20): the sketch pad the user draws a dashboard on, the composer screen around it, and the DOM "environment" the
+dashboard agent drives through action tools and live TSX.
+
+### Providers and what the host still owns
+
+```tsx
+import { AiChatProvider, AiChatV2Pane, RunProgressPanelV2, RunProgressStripV2, EnvironmentProvider, LiveTsxConfigProvider } from '@aintela/chat/components';
+import { BiClientProvider, createBiClient, createBiUiTools } from '@aintela/bi';
+import { ComposerProvider, ComposerView, ComposerChatBinding, useComposerChatBridge, useComposerEnvironment } from '@aintela/bi/composer';
+
+function ComposerScreen({ routeSessionId, navigate }) {
+  return (
+    <BiClientProvider client={bi}>
+      <ComposerProvider>                       {/* one zustand store per instance — no module singleton */}
+        <ComposerHost routeSessionId={routeSessionId} navigate={navigate} />
+      </ComposerProvider>
+    </BiClientProvider>
+  );
+}
+
+function ComposerHost({ routeSessionId, navigate }) {
+  const bridge = useComposerChatBridge();       // onRenderPrompt / onTurnOpen / onTurnComplete / ingestToolEvent / environment
+  const uiTools = useMemo(() => createBiUiTools({ client: bi, environment: bridge.environment })
+      .render('present_dashboard', (a) => <ScriptDashboardViewer dashboardId={a.id} />)
+      .build(), [bridge.environment]);
+
+  return (
+    <LiveTsxConfigProvider maxCharsForFull={10000}>
+      <AiChatProvider
+        key={routeSessionId ?? 'new'}
+        agentContext={{ agentConfig: { id: DASHBOARD_AGENT_ID, name: 'Dashboard Agent' }, customer }}   // the host picks the agent
+        serverBaseUrl={SERVER} sessionId={routeSessionId} user={user} storageService={storage} eventBusService={bus}
+        uiTools={uiTools} hidePromptInput autoCreateSession
+        onRenderPrompt={bridge.onRenderPrompt} onTurnOpen={bridge.onTurnOpen} onTurnComplete={bridge.onTurnComplete}
+      >
+        <EnvironmentProvider value={bridge.environment}>
+          <ComposerChatBinding />               {/* mirrors the live session id + forwards gateway tool events */}
+          <ComposerView
+            routeSessionId={routeSessionId}
+            sessionId={liveSessionId}          {/* or let ComposerChatBinding set it in the store */}
+            chatPane={<AiChatV2Pane hideHeader />}
+            renderProgressPanel={({ hasDashboard, dashboardCollapsed, turnOpen }) => (
+              <RunProgressPanelV2 width={hasDashboard ? '22%' : '30%'} defaultCollapsed={(!dashboardCollapsed || !turnOpen) && hasDashboard} />
+            )}
+            progressStrip={<RunProgressStripV2 />}
+            onSelectSession={(sid) => navigate(`/composer/${sid}`)}
+            onDashboardNameChange={setBreadcrumb}
+            datasetControls={isAdmin && <DatasetParameterizationControls orientation="column" datasets={datasets} agents={agents} agentId={agentId} onAgentChange={pickAgent} />}
+          />
+        </EnvironmentProvider>
+      </AiChatProvider>
+    </LiveTsxConfigProvider>
+  );
+}
+```
+
+What the **host** owns, deliberately: `AiChatProvider` / `AiChatV2Pane` / the progress panel (the chat is not inside the
+package); the **agent ids** (`agentContext`) — the legacy `DEFAULT_DASHBOARD_AGENT_ID` and the customer/Envision agent pair
+are gone, `DatasetParameterizationControls` takes `agents` + `agentId` + `onAgentChange`; routing (`routeSessionId` in,
+`onSelectSession` / `onSearchAllSessions` out); the breadcrumb (`onDashboardNameChange`); `isAdmin` (render
+`datasetControls` or not); `LiveTsxConfigProvider`; the `pt-BR` `dayjs` locale (the composer never calls `dayjs.locale`);
+the "Abrir" picker body on `DashboardPad` (`renderDashboardPicker`); Markdown for card descriptions (`renderDescription`
+— default is plain text).
+
+### Components
+
+| export | what it is | key props |
+|---|---|---|
+| `ComposerView` | splash → execution layout, drafts, guided tour | `chatPane` (required), `sessionId`, `routeSessionId`, `renderProgressPanel`, `progressStrip`, `onBeforeSend`, `resolveGuideElement`, `suggestions`, `templates`, `recentSessions`, `onSelectSession`, `onSearchAllSessions`, `onDashboardNameChange`, `datasetControls`, `renderDescription`, `sidePanelWidth` |
+| `DashboardPad` | the V1 pad: toolbar (Sketch/Dashboard, ToolBox, Novo/Salvar/Atualizar/Abrir/Compose) + sketch or viewer | `sessionId`, `dashboardId`, `turnOpen`, `onCompose`, `onChange`, `onBack`, `renderDashboardPicker`, `showDebug`, `headerExtra`, `renderDescription` |
+| `DashboardPadSketch` | the grid of `CardSketch` cells + filter chips (ref: `DashboardPadHandle` = `addGenericCell` / `addTypedCell` / `handleAddFilter`) | `hideInternalHeader`, `hideFiltersInSketch`, `zoomLevel`, `onAddCard`, `headerExtra`, `renderDescription` |
+| `CardSketch` (alias `CardScketch`), `FilterSketch`, `TitleSketch` (aliases `TextSketh`, `TitleSkath`), `ToolBox`, `HoverButton`, `ClonedComponent` | the pad's pieces | |
+| `DashboardPadEditor` | tabbed shell (`DashboardPadEditorHandle`) | `renderContent`, `addMenuItems`, `tabs`, `onTab*` |
+| `DatasetParameterizationControls` | admin block: "DataSet Dinâmico" toggle + default dataset + agent picker | `orientation`, `datasets`, `defaultTemplateDataset`, `agents`, `agentId`, `recommendedAgentId`, `onAgentChange` |
+| `DrawablePrompt` | `PromptV2` with the sketch in its `topSlot` (rail + pad, the sketch chips, the queued-changes chip) | `onCreateSketch`, `onBeforeSend`, `sketchExpanded`, `onSketchExpandedChange`, `seedDraft`, `compact`, `zoomLevel`, `datasetControls` |
+| `EntryEmptyState`, `SpotlightOverlay`, `DashboardSidePanel`, `DashboardPin` | the splash, the tour, the two dashboard surfaces | `suggestions`/`templates`/`onSearchAllSessions`; `steps`/`resolveElement`; `width`/`defaultCollapsed` |
+| `CardTypeIconsProvider` / `useCardTypeIcons` | swap the pad's icons (`category` / `specificType` / `filterType` maps; MUI defaults) | |
+
+Data that used to be hardcoded is now a default you can replace: `defaultComposerSuggestions` (`{ label, prompt }[]`),
+`defaultComposerTemplates` (+ `seedFromTemplate`, `TEMPLATE_KIND_TO_SKETCH`), `CARD_TYPE_CATALOG`, `FILTER_TYPE_CATALOG` —
+all Portuguese travel-BI text.
+
+### Store — `ComposerProvider`, `useComposer()`
+
+`ComposerProvider` creates one zustand store (`createComposerStore`) per mount; `useComposer(selector)` subscribes,
+`useComposerStore()` gives the API for `getState()` in handlers, `useComposerEnvironment()` returns the
+`DashboardEnvironment`. The store keeps the legacy semantics: `dashboardDefinition` (live), `publishedDashboard` (what the
+viewer renders — advances `VIEWER_COMMIT_DEBOUNCE_MS` = 3 s after the last edit, never mid-turn, immediately on
+`commitForSend()` / load / `dashboardGenerated` / `refreshDashboard`), `lastSentDashboard` (the queued-changes chip's
+baseline), `renderGeneration` (bundle CODE changed → `codeGeneration`), `llmCounter` (→ `llmRenderCount`), `agentPulseTick`,
+`todosByCardKey`, `recordSketchChange` / `clearClientSideChanges` (the per-turn hint the prompt carries), the guide state,
+and the autosave (`DRAFT_SAVE_DEBOUNCE_MS` = 800 ms, POST `/Dashboard` through the `BiClient`; `client={null}` disables it).
+
+### The environment object
+
+`DashboardEnvironment` = `highlightComponent(target, { durationMs, scrollIntoView })`, `cloneComponent(target, { includeHidden })`,
+`createDashboardPad(def)`, `updateDashboardPad(def)`, `refreshDashboard()`, `showGuide(steps, options)`, `dismissGuide()`.
+Targets resolve against `[data-env-id]`, `[data-env-key]`, `[data-env-name]`, `#id`, `.class` or a raw selector
+(`resolveEnvironmentElements`, `resolveGuideElement`). Pass it to `EnvironmentProvider` (live TSX calls `useEnvironment()`),
+and to `createBiUiTools({ environment })`, which then also registers the agent's three ACTION tools: `refresh_dashboard`,
+`present_dashboard_pad` (`{ definitionJson, mode: 'create' | 'update' }`) and `present_guide` (`{ stepsJson }`).
+`getBiModuleSurface()` exposes the whole subpath, so LLM code reaches `ExamplePad`, `ExampleCardSketh` (legacy spelling kept
+as an alias of `ExampleCardSketch`), `PrototypePad`, `useDashboardPad`, `c`, `dateRange`, `datePicker`, `autoComplete`,
+`EnvironmentProvider`, `useEnvironment` under every registered specifier.
+
+### Theming
+
+Same contract as the rest of the package. `composer.css` reads `--bi-*` only; the bridge gained `--bi-secondary`,
+`--bi-secondary-soft`, `--bi-sketch-dash`, `--bi-sketch-dash-faint`, `--bi-sketch-selection` (`alpha(primary, .12)`),
+`--bi-scrim`, `--bi-highlight-outline`, `--bi-highlight-glow`. The v2 chat theme's extra tokens (`palette.surface.raised`,
+`palette.surface.hover`, `palette.border.soft`, `typography.fontFamilyMono`) are read when present and fall back to
+`background.paper` / `action.hover` / `divider` / a monospace stack (`resolveComposerSurfaces`). Framer-motion timings are
+unchanged; every animated colour is a theme token.
+
+## What changed from the dashboard app
+
+- **Providers now required**: `BiClientProvider` (or a `client` prop) for every hook / viewer / inline component;
+  `DashboardParametersProvider` around cards (as before); `BiThemeBridge` for the stylesheets to have colours.
+- **Removed exports**: `CHART_COLORS`, `chartColor`, `chartShade` (from `data`; `chartShade` lives in `cards`,
+  built on MUI `alpha()`), `GEO_URL` / `DEFAULT_GEO_LAYERS` (now `GEO_URL_WORLD` / `worldGeoLayers` /
+  `brazilGeoLayers` + `GeoLayersProvider`), the `VizLibrary` compat pieces, `ContainTable`, `DataAnalysis`.
+- **Signature changes**: `loadDashboardBundle(client, sessionId, id)` / `instantiateDashboardBundle(client, …)`
+  take the client first; `Chart` lost `partial`, `runaround`, `showHeader`, `eventBusService`, `parentComponent`
+  and gained `onExpand`; `IFrame` gained `onExpand` / `height`; `VizTriggerButton` requires `onTrigger`;
+  `VizDatePicker` / `VizSelect` / `VizTextField` read `DashboardParametersContext` (the Python `DashboardContext` is gone).
+- **Viewer**: `ScriptDashboardViewer` takes `onExportPdf`, `onSchedule`, `onEdit`, `onLayoutCommit`, `datasetOverride`,
+  `isAdmin`, `datasetOverrideControl`, `resolveCardIcon`, `isPrintPreview` instead of reading the composer / app
+  stores, `react-router`, `react-js-cron`, `useCustomers` and the PDF endpoint. `headerRender` is unchanged.
+  `dashboardWaiting` gained `sessionId`.
+- Map cards default to the world base layer only; pass `geoUrl={brazilGeoLayers}` (or a `GeoLayersProvider`) for the
+  legacy world + Brazil-states pair.
+- `loading` is optional on every card (default `false`).
+- `Metric.description` renders as plain text (the app rendered Markdown).
+- Portuguese UI strings are kept as they were.
+- **Composer**: `useComposerViewStore` (module singleton, `devtools`) → a per-`ComposerProvider` store; `DashboardService`
+  → `BiClient` (`listDashboards`, `getDashboardBySession`, `upsertDashboard`, `updateDashboard`, `deleteDashboard`,
+  `dashboardAction`, `listFolders` / `getFolder` / `createFolder` / `updateFolder` / `deleteFolder` / `folderAction`,
+  `getDashboardHierarchy`; the draft envelope lives in `toDraftPayload` / `fromUpsertResponse`); `ComposerViewV2` →
+  `ComposerView` + `useComposerChatBridge` (no `AiChatProvider`, no router, no `useDashboardAppStore`); `ExampleFilterSketch`
+  and `TestCard` were not carried over (unused); `CardSketch` renders the description as plain text unless
+  `renderDescription` is given (was `react-markdown`); `DashboardPad`'s debug panel is a `<pre>` (was `MarkdownExtended`);
+  the "Buscar todas as sessões" link fires `onSearchAllSessions` instead of clicking `[data-v2-search-trigger]`;
+  `SketchCardItem.muiIconName` now stores the icon's export name (was the constant `'SvgIcon'`).
+
+## Scripts
+
+`npm run build` (vite lib + `.d.ts`) · `npm test` · `npm run lint` (eslint + stylelint) · `npm run typecheck`.

package/dist/BiClientProvider-CWJochvi.js

@@ -0,0 +1,219 @@
+var m = Object.defineProperty;
+var o = (d, l) => m(d, "name", { value: l, configurable: !0 });
+import { jsx as E } from "react/jsx-runtime";
+import { useMemo as g, useContext as w, createContext as x } from "react";
+function C(d) {
+  return d.endsWith("/") ? d.slice(0, -1) : d;
+}
+o(C, "trimSlash");
+function u(d) {
+  return encodeURIComponent(d);
+}
+o(u, "enc");
+function S(d, l) {
+  const i = C(d), n = /* @__PURE__ */ o(() => l ? `?t=${Date.now()}` : "", "bust");
+  return {
+    query: /* @__PURE__ */ o((r, a, { noCache: h }) => `${i}/Query/${u(r)}/${u(a)}${h ? "?noCache=true" : ""}`, "query"),
+    queryPage: /* @__PURE__ */ o((r, a) => `${i}/Query/${u(r)}/${u(a)}/page`, "queryPage"),
+    queryDistinct: /* @__PURE__ */ o((r, a, h) => `${i}/Query/${u(r)}/${u(a)}/distinct/${u(h)}`, "queryDistinct"),
+    queryExport: /* @__PURE__ */ o((r, a, h) => `${i}/Query/${u(r)}/${u(a)}/${h === "xlsx" ? "export-xlsx" : "export"}`, "queryExport"),
+    filterOptions: /* @__PURE__ */ o((r, a) => `${i}/Query/${u(r)}/${u(a)}`, "filterOptions"),
+    dashboard: /* @__PURE__ */ o((r) => `${i}/Dashboard/${u(r)}/draft`, "dashboard"),
+    subAgentStatus: /* @__PURE__ */ o((r, a) => `${i}/SubAgent/${u(r)}/${u(a)}`, "subAgentStatus"),
+    dashboardBundle: /* @__PURE__ */ o((r, a) => `${i}/open/dashboard/${u(r)}/${u(a)}/true`, "dashboardBundle"),
+    artifact: /* @__PURE__ */ o((r, a) => {
+      const h = a.dashboardId ? `dashboard/${u(a.dashboardId)}` : a.sessionId ? u(a.sessionId) : void 0;
+      return `${i}/open/getImage/${h ? `${h}/` : ""}${r}${n()}`;
+    }, "artifact"),
+    htmlArtifact: /* @__PURE__ */ o((r, a) => `${i}/open/dashboard/${a.sessionId ? `${u(a.sessionId)}/` : ""}${r}/true`, "htmlArtifact"),
+    dashboardList: /* @__PURE__ */ o(() => `${i}/Dashboard/List`, "dashboardList"),
+    dashboardBySession: /* @__PURE__ */ o((r) => `${i}/Dashboard/session/${u(r)}/draft`, "dashboardBySession"),
+    dashboardUpsert: /* @__PURE__ */ o(() => `${i}/Dashboard`, "dashboardUpsert"),
+    dashboardUpdate: /* @__PURE__ */ o((r) => `${i}/Dashboard/${u(r)}`, "dashboardUpdate"),
+    dashboardDelete: /* @__PURE__ */ o((r) => `${i}/Dashboard/${u(r)}`, "dashboardDelete"),
+    dashboardAction: /* @__PURE__ */ o((r, a) => `${i}/Dashboard/${u(r)}/${a}`, "dashboardAction"),
+    folders: /* @__PURE__ */ o(() => `${i}/DashboardFolder`, "folders"),
+    folder: /* @__PURE__ */ o((r) => `${i}/DashboardFolder/${u(r)}`, "folder"),
+    folderAction: /* @__PURE__ */ o((r, a) => `${i}/DashboardFolder/${u(r)}/${a}`, "folderAction"),
+    folderHierarchy: /* @__PURE__ */ o(() => `${i}/DashboardFolder/hierarchy`, "folderHierarchy")
+  };
+}
+o(S, "defaultBiRoutes");
+function f(d, l) {
+  if (typeof l == "string" && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?$/.test(l)) {
+    const i = new Date(l);
+    if (!Number.isNaN(i.getTime())) return i;
+  }
+  return l;
+}
+o(f, "biDateReviver");
+function T(d) {
+  const l = C(d.baseUrl), i = d.fetch ?? ((t, e) => globalThis.fetch(t, e)), n = { ...S(l, d.cacheBustArtifacts ?? !1), ...d.routes ?? {} };
+  async function r(t, e = {}) {
+    const s = /^https?:\/\//i.test(t) ? t : `${l}${t.startsWith("/") ? "" : "/"}${t}`, c = new Headers(e.headers ?? {});
+    for (const [p, B] of Object.entries(d.headers ?? {})) c.has(p) || c.set(p, B);
+    const b = d.getAuthHeader ? await d.getAuthHeader() : void 0;
+    return b && !c.has("Authorization") && c.set("Authorization", b), i(s, { ...e, headers: c });
+  }
+  o(r, "request");
+  async function a(t, e) {
+    const s = await r(t, e);
+    if (!s.ok) {
+      const c = await s.text().catch(() => "");
+      throw new Error(`[BiClient] ${(e == null ? void 0 : e.method) ?? "GET"} ${t} failed (${s.status})${c ? `: ${c.slice(0, 300)}` : ""}`);
+    }
+    return s;
+  }
+  o(a, "requestOk");
+  const h = /* @__PURE__ */ o((t, e) => ({
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(t),
+    ...e
+  }), "json"), $ = { "Cache-Control": "no-cache", Pragma: "no-cache", Expires: "0" };
+  return {
+    baseUrl: l,
+    routes: n,
+    request: r,
+    requestOk: a,
+    async runQuery(t, e, s, c) {
+      return (await a(n.query(t, e, { noCache: c == null ? void 0 : c.noCache }), h(s, { signal: c == null ? void 0 : c.signal }))).json();
+    },
+    async getQueryPage(t, e, s) {
+      return (await a(n.queryPage(t, e), h(s))).json();
+    },
+    async getDistinctValues(t, e, s, c) {
+      const b = await r(n.queryDistinct(t, e, s), h(c));
+      return b.ok ? b.json() : null;
+    },
+    async exportQuery(t, e, s, c) {
+      return (await a(n.queryExport(t, e, s), h(c))).blob();
+    },
+    async getFilterOptions(t, e) {
+      const s = await r(n.filterOptions(t, e), { method: "GET" });
+      if (s.status === 404) return null;
+      if (!s.ok) throw new Error(`[BiClient] filter options failed (${s.status})`);
+      return s.json();
+    },
+    async getDashboard(t) {
+      const e = await r(n.dashboard(t), { method: "GET", headers: $ });
+      if (e.status === 404) throw new Error(`Dashboard with ID '${t}' not found`);
+      if (!e.ok) throw new Error(`[BiClient] dashboard fetch failed (${e.status})`);
+      return JSON.parse(await e.text(), f);
+    },
+    async getSubAgentStatus(t, e) {
+      const s = await r(n.subAgentStatus(t, e), { method: "GET", headers: $ });
+      if (s.status === 404) return null;
+      if (!s.ok) throw new Error(`Failed to fetch sub-agent status (HTTP ${s.status})`);
+      return JSON.parse(await s.text(), f);
+    },
+    async fetchDashboardBundle(t, e) {
+      const s = await r(n.dashboardBundle(t, e), { method: "GET", cache: "no-store" });
+      if (!s.ok) throw new Error(`Failed to fetch dashboard bundle (${s.status}): ${n.dashboardBundle(t, e)}`);
+      return s.text();
+    },
+    artifactUrl(t, e = {}) {
+      return n.artifact(t, e);
+    },
+    iframeUrl(t, e = {}) {
+      return n.htmlArtifact(t, e);
+    },
+    async listDashboards() {
+      const t = await a(n.dashboardList(), { method: "GET", headers: $ });
+      return JSON.parse(await t.text(), f);
+    },
+    async getDashboardBySession(t) {
+      const e = await r(n.dashboardBySession(t), { method: "GET", headers: $ });
+      if (e.status === 404) return null;
+      if (!e.ok) throw new Error(`[BiClient] dashboard-by-session fetch failed (${e.status})`);
+      return JSON.parse(await e.text(), f);
+    },
+    async upsertDashboard(t) {
+      const e = await a(n.dashboardUpsert(), h(t, { headers: { "Content-Type": "application/json", ...$ } }));
+      return JSON.parse(await e.text(), f);
+    },
+    async updateDashboard(t, e) {
+      await a(n.dashboardUpdate(t), h(e));
+    },
+    async deleteDashboard(t) {
+      const e = await r(n.dashboardDelete(t), { method: "DELETE" });
+      if (e.status === 404) return !1;
+      if (!e.ok) throw new Error(`[BiClient] dashboard delete failed (${e.status})`);
+      return !0;
+    },
+    async dashboardAction(t, e) {
+      const s = await r(n.dashboardAction(t, e), { method: "POST" });
+      if (!s.ok) {
+        const c = await s.text().catch(() => "");
+        throw new Error(c || `[BiClient] dashboard ${e} failed (${s.status})`);
+      }
+    },
+    async listFolders() {
+      const t = await a(n.folders(), { method: "GET", headers: $ });
+      return JSON.parse(await t.text(), f);
+    },
+    async getFolder(t) {
+      const e = await r(n.folder(t), { method: "GET", headers: $ });
+      if (e.status === 404) throw new Error(`Folder '${t}' not found`);
+      if (!e.ok) throw new Error(`[BiClient] folder fetch failed (${e.status})`);
+      return JSON.parse(await e.text(), f);
+    },
+    async createFolder(t, e) {
+      const s = await a(n.folders(), h({ name: t, description: e }));
+      return JSON.parse(await s.text(), f);
+    },
+    async updateFolder(t, e) {
+      const s = await a(n.folder(t), h(e, { method: "PATCH" }));
+      return JSON.parse(await s.text(), f);
+    },
+    async deleteFolder(t) {
+      const e = await r(n.folder(t), { method: "DELETE" });
+      if (e.status === 404) return !1;
+      if (!e.ok) throw new Error(`[BiClient] folder delete failed (${e.status})`);
+      return !0;
+    },
+    async folderAction(t, e) {
+      await a(n.folderAction(t, e), { method: "POST" });
+    },
+    async getDashboardHierarchy() {
+      const t = await a(n.folderHierarchy(), { method: "GET", headers: $ });
+      return JSON.parse(await t.text(), f);
+    }
+  };
+}
+o(T, "createBiClient");
+const y = x(null), D = x(void 0), N = /* @__PURE__ */ o(({ client: d, options: l, sessionId: i, children: n }) => {
+  const r = g(() => {
+    if (d) return d;
+    if (l) return T(l);
+    throw new Error("[@aintela/bi] BiClientProvider needs either `client` or `options`.");
+  }, [d, l]);
+  return /* @__PURE__ */ E(y.Provider, { value: r, children: /* @__PURE__ */ E(D.Provider, { value: i, children: n }) });
+}, "BiClientProvider");
+function P() {
+  const d = w(y);
+  if (!d)
+    throw new Error(
+      "[@aintela/bi] No BiClient in scope. Wrap the BI surface in <BiClientProvider client={createBiClient({ baseUrl })}>."
+    );
+  return d;
+}
+o(P, "useBiClient");
+function F() {
+  return w(y);
+}
+o(F, "useBiClientOptional");
+function J() {
+  return w(D);
+}
+o(J, "useBiSessionId");
+export {
+  N as B,
+  F as a,
+  f as b,
+  T as c,
+  S as d,
+  J as e,
+  P as u
+};
+//# sourceMappingURL=BiClientProvider-CWJochvi.js.map

package/dist/BiClientProvider-CWJochvi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BiClientProvider-CWJochvi.js","sources":["../src/client/BiClient.ts","../src/client/BiClientProvider.tsx"],"sourcesContent":["/**\n * The one seam between this package and a server. Every hook, viewer and\n * inline component reaches the network through a `BiClient`; nothing in the\n * package reads `process.env`, `import.meta.env` or a hard-coded host.\n *\n * `createBiClient({ baseUrl })` gives you the default REST layout the legacy\n * .NET WSServer exposes (`/Query/...`, `/Dashboard/...`, `/SubAgent/...`,\n * `/open/...`). Every route is a function on `routes`, so a host whose server\n * lays the endpoints out differently (the AIA `aia-bi` API, an AgentsServer\n * artifact route) overrides just the routes it changes.\n */\n\nexport type BiFetch = (input: string, init?: RequestInit) => Promise<Response>;\n\nexport interface ArtifactUrlScope {\n    /** Chat session that produced the artifact (the default scope). */\n    sessionId?: string;\n    /** When set, takes priority over `sessionId` — the artifact belongs to a saved dashboard. */\n    dashboardId?: string;\n}\n\nexport interface QueryExecutionBody {\n    parameters?: Record<string, unknown>;\n    /** Admin-only runtime dataset override (parameterised dashboards). */\n    datasetOverride?: string;\n}\n\nexport interface PagedQueryBody extends QueryExecutionBody {\n    page: number;\n    pageSize: number;\n    sort: Array<{ field: string; dir: 'asc' | 'desc' }>;\n    filter: Array<{ field: string; op: string; value: unknown }>;\n}\n\nexport interface ExportQueryBody extends QueryExecutionBody {\n    sort: Array<{ field: string; dir: 'asc' | 'desc' }>;\n    filter: Array<{ field: string; op: string; value: unknown }>;\n}\n\nexport interface BiRoutes {\n    /** POST — run a registered query (by hash) for a dashboard. */\n    query(dashboardId: string, queryHash: string, opts: { noCache?: boolean }): string;\n    /** POST — one page of a server-side view. */\n    queryPage(dashboardId: string, viewId: string): string;\n    /** POST — distinct values of one column of a view (filter dropdowns). */\n    queryDistinct(dashboardId: string, viewId: string, field: string): string;\n    /** POST — full-rowset export of a view. */\n    queryExport(dashboardId: string, viewId: string, format: 'csv' | 'xlsx'): string;\n    /** GET — the option rows behind an auto-complete filter. */\n    filterOptions(dashboardId: string, filterId: string): string;\n    /** GET — a dashboard document (draft). */\n    dashboard(dashboardId: string): string;\n    /** GET — sub-agent status while a dashboard is being generated. */\n    subAgentStatus(sessionId: string, subAgentId: string): string;\n    /** GET — the compiled CJS dashboard bundle. */\n    dashboardBundle(sessionId: string, scriptFileName: string): string;\n    /** URL of an image artifact (matplotlib PNG) for `<img src>`. */\n    artifact(src: string, scope: ArtifactUrlScope): string;\n    /** URL of an HTML artifact for `<iframe src>`. */\n    htmlArtifact(src: string, scope: ArtifactUrlScope): string;\n\n    // ── Dashboard documents + folders (the composer's authoring calls) ──\n    /** GET — every dashboard the caller can see (lean list). */\n    dashboardList(): string;\n    /** GET — the draft whose `originalSessionId` is `sessionId` (404 when none). */\n    dashboardBySession(sessionId: string): string;\n    /** POST — create or update a dashboard document (`{ ...metadata, draft: {...} }`). */\n    dashboardUpsert(): string;\n    /** POST — overwrite one dashboard (move to folder, rename, …). */\n    dashboardUpdate(dashboardId: string): string;\n    /** DELETE — remove a dashboard. */\n    dashboardDelete(dashboardId: string): string;\n    /** POST — one of the verb routes: share / unshare / pin / unpin / publishAsDefault / unpublishAsDefault. */\n    dashboardAction(dashboardId: string, action: DashboardActionName): string;\n    /** GET (list) / POST (create) — dashboard folders. */\n    folders(): string;\n    /** GET / PATCH / DELETE — one folder. */\n    folder(folderId: string): string;\n    /** POST — share / unshare a folder (cascades to its dashboards). */\n    folderAction(folderId: string, action: FolderActionName): string;\n    /** GET — folders with their dashboards plus the root-level dashboards. */\n    folderHierarchy(): string;\n}\n\nexport type DashboardActionName = 'share' | 'unshare' | 'pin' | 'unpin' | 'publishAsDefault' | 'unpublishAsDefault';\nexport type FolderActionName = 'share' | 'unshare';\n\nexport interface BiClientOptions {\n    /** Server origin, e.g. `https://bi.example.com`. No trailing slash needed. */\n    baseUrl: string;\n    /** `fetch` implementation (defaults to `globalThis.fetch`); inject for tests or a custom transport. */\n    fetch?: BiFetch;\n    /** Returns the `Authorization` header value (`Bearer …`) or `undefined` for none. May be async. */\n    getAuthHeader?: () => string | undefined | Promise<string | undefined>;\n    /** Extra headers on every request. */\n    headers?: Record<string, string>;\n    /** Route overrides — any subset of {@link BiRoutes}. */\n    routes?: Partial<BiRoutes>;\n    /**\n     * Legacy image URLs carried a `?t=<now>` cache-buster because the proxy\n     * served mutable files. Off by default; a host fronting a mutable store\n     * can turn it back on.\n     */\n    cacheBustArtifacts?: boolean;\n}\n\nexport interface BiClient {\n    readonly baseUrl: string;\n    readonly routes: BiRoutes;\n    /** Low-level request: prefixes `baseUrl` on relative paths and adds auth + default headers. */\n    request(path: string, init?: RequestInit): Promise<Response>;\n    /** Same as `request`, but throws a descriptive `Error` on a non-2xx status. */\n    requestOk(path: string, init?: RequestInit): Promise<Response>;\n\n    runQuery<T = unknown>(dashboardId: string, queryHash: string, body: QueryExecutionBody, opts?: { noCache?: boolean; signal?: AbortSignal }): Promise<T>;\n    getQueryPage<T = unknown>(dashboardId: string, viewId: string, body: PagedQueryBody): Promise<T>;\n    getDistinctValues(dashboardId: string, viewId: string, field: string, body: QueryExecutionBody): Promise<{ values: Array<string | null>; truncated?: boolean } | null>;\n    exportQuery(dashboardId: string, viewId: string, format: 'csv' | 'xlsx', body: ExportQueryBody): Promise<Blob>;\n    getFilterOptions<T = unknown>(dashboardId: string, filterId: string): Promise<T | null>;\n    getDashboard<T = unknown>(dashboardId: string): Promise<T>;\n    getSubAgentStatus<T = unknown>(sessionId: string, subAgentId: string): Promise<T | null>;\n    fetchDashboardBundle(sessionId: string, scriptFileName: string): Promise<string>;\n\n    artifactUrl(src: string, scope?: ArtifactUrlScope): string;\n    iframeUrl(src: string, scope?: ArtifactUrlScope): string;\n\n    // ── Dashboard documents + folders (used by `@aintela/bi/composer`) ──\n    listDashboards<T = unknown>(): Promise<T[]>;\n    /** `null` when no dashboard is bound to the session. */\n    getDashboardBySession<T = unknown>(sessionId: string): Promise<T | null>;\n    /** POST the upsert payload; resolves to the server's document (raw, un-flattened). */\n    upsertDashboard<T = unknown>(payload: unknown): Promise<T>;\n    updateDashboard(dashboardId: string, dashboard: unknown): Promise<void>;\n    /** `false` when the server answered 404. */\n    deleteDashboard(dashboardId: string): Promise<boolean>;\n    dashboardAction(dashboardId: string, action: DashboardActionName): Promise<void>;\n    listFolders<T = unknown>(): Promise<T[]>;\n    getFolder<T = unknown>(folderId: string): Promise<T>;\n    createFolder<T = unknown>(name: string, description?: string): Promise<T>;\n    updateFolder<T = unknown>(folderId: string, patch: unknown): Promise<T>;\n    deleteFolder(folderId: string): Promise<boolean>;\n    folderAction(folderId: string, action: FolderActionName): Promise<void>;\n    getDashboardHierarchy<T = unknown>(): Promise<T>;\n}\n\nfunction trimSlash(s: string): string {\n    return s.endsWith('/') ? s.slice(0, -1) : s;\n}\n\nfunction enc(s: string): string {\n    return encodeURIComponent(s);\n}\n\n/** The legacy WSServer / Express layout. Override per route through `BiClientOptions.routes`. */\nexport function defaultBiRoutes(baseUrl: string, cacheBust: boolean): BiRoutes {\n    const base = trimSlash(baseUrl);\n    const bust = () => (cacheBust ? `?t=${Date.now()}` : '');\n    return {\n        query: (d, h, { noCache }) => `${base}/Query/${enc(d)}/${enc(h)}${noCache ? '?noCache=true' : ''}`,\n        queryPage: (d, v) => `${base}/Query/${enc(d)}/${enc(v)}/page`,\n        queryDistinct: (d, v, f) => `${base}/Query/${enc(d)}/${enc(v)}/distinct/${enc(f)}`,\n        queryExport: (d, v, fmt) => `${base}/Query/${enc(d)}/${enc(v)}/${fmt === 'xlsx' ? 'export-xlsx' : 'export'}`,\n        filterOptions: (d, f) => `${base}/Query/${enc(d)}/${enc(f)}`,\n        dashboard: (d) => `${base}/Dashboard/${enc(d)}/draft`,\n        subAgentStatus: (s, a) => `${base}/SubAgent/${enc(s)}/${enc(a)}`,\n        dashboardBundle: (s, f) => `${base}/open/dashboard/${enc(s)}/${enc(f)}/true`,\n        artifact: (src, scope) => {\n            const prefix = scope.dashboardId ? `dashboard/${enc(scope.dashboardId)}` : scope.sessionId ? enc(scope.sessionId) : undefined;\n            return `${base}/open/getImage/${prefix ? `${prefix}/` : ''}${src}${bust()}`;\n        },\n        htmlArtifact: (src, scope) => `${base}/open/dashboard/${scope.sessionId ? `${enc(scope.sessionId)}/` : ''}${src}/true`,\n        dashboardList: () => `${base}/Dashboard/List`,\n        dashboardBySession: (s) => `${base}/Dashboard/session/${enc(s)}/draft`,\n        dashboardUpsert: () => `${base}/Dashboard`,\n        dashboardUpdate: (d) => `${base}/Dashboard/${enc(d)}`,\n        dashboardDelete: (d) => `${base}/Dashboard/${enc(d)}`,\n        dashboardAction: (d, a) => `${base}/Dashboard/${enc(d)}/${a}`,\n        folders: () => `${base}/DashboardFolder`,\n        folder: (f) => `${base}/DashboardFolder/${enc(f)}`,\n        folderAction: (f, a) => `${base}/DashboardFolder/${enc(f)}/${a}`,\n        folderHierarchy: () => `${base}/DashboardFolder/hierarchy`,\n    };\n}\n\n/**\n * ISO-8601 date strings → `Date` on JSON parse (the .NET server serialises\n * `DateTime` as ISO). Same shape as the chat library's `dateReviver`, kept\n * local so this subpath has no runtime dependency on it.\n */\nexport function biDateReviver(_key: string, value: unknown): unknown {\n    if (typeof value === 'string' && /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})?$/.test(value)) {\n        const d = new Date(value);\n        if (!Number.isNaN(d.getTime())) return d;\n    }\n    return value;\n}\n\nexport function createBiClient(options: BiClientOptions): BiClient {\n    const baseUrl = trimSlash(options.baseUrl);\n    const doFetch: BiFetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));\n    const routes: BiRoutes = { ...defaultBiRoutes(baseUrl, options.cacheBustArtifacts ?? false), ...(options.routes ?? {}) };\n\n    async function request(path: string, init: RequestInit = {}): Promise<Response> {\n        const url = /^https?:\\/\\//i.test(path) ? path : `${baseUrl}${path.startsWith('/') ? '' : '/'}${path}`;\n        const headers = new Headers(init.headers ?? {});\n        for (const [k, v] of Object.entries(options.headers ?? {})) if (!headers.has(k)) headers.set(k, v);\n        const auth = options.getAuthHeader ? await options.getAuthHeader() : undefined;\n        if (auth && !headers.has('Authorization')) headers.set('Authorization', auth);\n        return doFetch(url, { ...init, headers });\n    }\n\n    async function requestOk(path: string, init?: RequestInit): Promise<Response> {\n        const resp = await request(path, init);\n        if (!resp.ok) {\n            const text = await resp.text().catch(() => '');\n            throw new Error(`[BiClient] ${init?.method ?? 'GET'} ${path} failed (${resp.status})${text ? `: ${text.slice(0, 300)}` : ''}`);\n        }\n        return resp;\n    }\n\n    const json = (body: unknown, extra?: RequestInit): RequestInit => ({\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify(body),\n        ...extra,\n    });\n\n    const noCacheHeaders = { 'Cache-Control': 'no-cache', Pragma: 'no-cache', Expires: '0' };\n\n    return {\n        baseUrl,\n        routes,\n        request,\n        requestOk,\n\n        async runQuery(dashboardId, queryHash, body, opts) {\n            const resp = await requestOk(routes.query(dashboardId, queryHash, { noCache: opts?.noCache }), json(body, { signal: opts?.signal }));\n            return resp.json();\n        },\n        async getQueryPage(dashboardId, viewId, body) {\n            const resp = await requestOk(routes.queryPage(dashboardId, viewId), json(body));\n            return resp.json();\n        },\n        async getDistinctValues(dashboardId, viewId, field, body) {\n            const resp = await request(routes.queryDistinct(dashboardId, viewId, field), json(body));\n            if (!resp.ok) return null;\n            return resp.json();\n        },\n        async exportQuery(dashboardId, viewId, format, body) {\n            const resp = await requestOk(routes.queryExport(dashboardId, viewId, format), json(body));\n            return resp.blob();\n        },\n        async getFilterOptions(dashboardId, filterId) {\n            const resp = await request(routes.filterOptions(dashboardId, filterId), { method: 'GET' });\n            if (resp.status === 404) return null;\n            if (!resp.ok) throw new Error(`[BiClient] filter options failed (${resp.status})`);\n            return resp.json();\n        },\n        async getDashboard(dashboardId) {\n            const resp = await request(routes.dashboard(dashboardId), { method: 'GET', headers: noCacheHeaders });\n            if (resp.status === 404) throw new Error(`Dashboard with ID '${dashboardId}' not found`);\n            if (!resp.ok) throw new Error(`[BiClient] dashboard fetch failed (${resp.status})`);\n            return JSON.parse(await resp.text(), biDateReviver);\n        },\n        async getSubAgentStatus(sessionId, subAgentId) {\n            const resp = await request(routes.subAgentStatus(sessionId, subAgentId), { method: 'GET', headers: noCacheHeaders });\n            if (resp.status === 404) return null;\n            if (!resp.ok) throw new Error(`Failed to fetch sub-agent status (HTTP ${resp.status})`);\n            return JSON.parse(await resp.text(), biDateReviver);\n        },\n        async fetchDashboardBundle(sessionId, scriptFileName) {\n            // `no-store` bypasses every browser cache layer; the compiled-bundle\n            // cache in the runtime is keyed on the bytes, so a stale fetch can\n            // never resolve a regenerated bundle to old code.\n            const resp = await request(routes.dashboardBundle(sessionId, scriptFileName), { method: 'GET', cache: 'no-store' });\n            if (!resp.ok) throw new Error(`Failed to fetch dashboard bundle (${resp.status}): ${routes.dashboardBundle(sessionId, scriptFileName)}`);\n            return resp.text();\n        },\n\n        artifactUrl(src, scope = {}) {\n            return routes.artifact(src, scope);\n        },\n        iframeUrl(src, scope = {}) {\n            return routes.htmlArtifact(src, scope);\n        },\n\n        async listDashboards() {\n            const resp = await requestOk(routes.dashboardList(), { method: 'GET', headers: noCacheHeaders });\n            return JSON.parse(await resp.text(), biDateReviver);\n        },\n        async getDashboardBySession(sessionId) {\n            const resp = await request(routes.dashboardBySession(sessionId), { method: 'GET', headers: noCacheHeaders });\n            if (resp.status === 404) return null;\n            if (!resp.ok) throw new Error(`[BiClient] dashboard-by-session fetch failed (${resp.status})`);\n            return JSON.parse(await resp.text(), biDateReviver);\n        },\n        async upsertDashboard(payload) {\n            const resp = await requestOk(routes.dashboardUpsert(), json(payload, { headers: { 'Content-Type': 'application/json', ...noCacheHeaders } }));\n            return JSON.parse(await resp.text(), biDateReviver);\n        },\n        async updateDashboard(dashboardId, dashboard) {\n            await requestOk(routes.dashboardUpdate(dashboardId), json(dashboard));\n        },\n        async deleteDashboard(dashboardId) {\n            const resp = await request(routes.dashboardDelete(dashboardId), { method: 'DELETE' });\n            if (resp.status === 404) return false;\n            if (!resp.ok) throw new Error(`[BiClient] dashboard delete failed (${resp.status})`);\n            return true;\n        },\n        async dashboardAction(dashboardId, action) {\n            const resp = await request(routes.dashboardAction(dashboardId, action), { method: 'POST' });\n            if (!resp.ok) {\n                const text = await resp.text().catch(() => '');\n                throw new Error(text || `[BiClient] dashboard ${action} failed (${resp.status})`);\n            }\n        },\n        async listFolders() {\n            const resp = await requestOk(routes.folders(), { method: 'GET', headers: noCacheHeaders });\n            return JSON.parse(await resp.text(), biDateReviver);\n        },\n        async getFolder(folderId) {\n            const resp = await request(routes.folder(folderId), { method: 'GET', headers: noCacheHeaders });\n            if (resp.status === 404) throw new Error(`Folder '${folderId}' not found`);\n            if (!resp.ok) throw new Error(`[BiClient] folder fetch failed (${resp.status})`);\n            return JSON.parse(await resp.text(), biDateReviver);\n        },\n        async createFolder(name, description) {\n            const resp = await requestOk(routes.folders(), json({ name, description }));\n            return JSON.parse(await resp.text(), biDateReviver);\n        },\n        async updateFolder(folderId, patch) {\n            const resp = await requestOk(routes.folder(folderId), json(patch, { method: 'PATCH' }));\n            return JSON.parse(await resp.text(), biDateReviver);\n        },\n        async deleteFolder(folderId) {\n            const resp = await request(routes.folder(folderId), { method: 'DELETE' });\n            if (resp.status === 404) return false;\n            if (!resp.ok) throw new Error(`[BiClient] folder delete failed (${resp.status})`);\n            return true;\n        },\n        async folderAction(folderId, action) {\n            await requestOk(routes.folderAction(folderId, action), { method: 'POST' });\n        },\n        async getDashboardHierarchy() {\n            const resp = await requestOk(routes.folderHierarchy(), { method: 'GET', headers: noCacheHeaders });\n            return JSON.parse(await resp.text(), biDateReviver);\n        },\n    };\n}\n","import React, { createContext, useContext, useMemo } from 'react';\nimport { createBiClient, type BiClient, type BiClientOptions } from './BiClient';\n\nconst BiClientContext = createContext<BiClient | null>(null);\n\nexport interface BiClientProviderProps {\n    /** A ready client — or pass `options` and let the provider build one. */\n    client?: BiClient;\n    options?: BiClientOptions;\n    /**\n     * Session the inline components (`Chart`, `IFrame`) scope their artifact\n     * URLs to when the tool call did not name one. Typically the active chat\n     * session id.\n     */\n    sessionId?: string;\n    children: React.ReactNode;\n}\n\nconst BiSessionContext = createContext<string | undefined>(undefined);\n\nexport const BiClientProvider: React.FC<BiClientProviderProps> = ({ client, options, sessionId, children }) => {\n    const value = useMemo(() => {\n        if (client) return client;\n        if (options) return createBiClient(options);\n        throw new Error('[@aintela/bi] BiClientProvider needs either `client` or `options`.');\n    }, [client, options]);\n    return (\n        <BiClientContext.Provider value={value}>\n            <BiSessionContext.Provider value={sessionId}>{children}</BiSessionContext.Provider>\n        </BiClientContext.Provider>\n    );\n};\n\n/** The ambient client. Throws with a clear message when no provider is mounted. */\nexport function useBiClient(): BiClient {\n    const client = useContext(BiClientContext);\n    if (!client) {\n        throw new Error(\n            '[@aintela/bi] No BiClient in scope. Wrap the BI surface in <BiClientProvider client={createBiClient({ baseUrl })}>.',\n        );\n    }\n    return client;\n}\n\n/** Same as {@link useBiClient} but returns `null` instead of throwing. */\nexport function useBiClientOptional(): BiClient | null {\n    return useContext(BiClientContext);\n}\n\n/** The session id the nearest `BiClientProvider` was given, if any. */\nexport function useBiSessionId(): string | undefined {\n    return useContext(BiSessionContext);\n}\n"],"names":["trimSlash","s","__name","enc","defaultBiRoutes","baseUrl","cacheBust","base","bust","d","h","noCache","v","f","fmt","src","scope","prefix","biDateReviver","_key","value","createBiClient","options","doFetch","input","init","routes","request","path","url","headers","k","auth","requestOk","resp","text","json","body","extra","noCacheHeaders","dashboardId","queryHash","opts","viewId","field","format","filterId","sessionId","subAgentId","scriptFileName","payload","dashboard","action","folderId","name","description","patch","BiClientContext","createContext","BiSessionContext","BiClientProvider","client","children","useMemo","jsx","useBiClient","useContext","useBiClientOptional","useBiSessionId"],"mappings":"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"}

package/dist/ChartCardDefaultsContext-Cl5T25H0.js

@@ -0,0 +1,32 @@
+var c = Object.defineProperty;
+var e = (t, r) => c(t, "name", { value: r, configurable: !0 });
+import { jsx as C } from "react/jsx-runtime";
+import { createContext as f, useRef as l, useMemo as i, useContext as x } from "react";
+const s = f({});
+function D() {
+  return x(s);
+}
+e(D, "useChartCardDefaults");
+const h = /* @__PURE__ */ e(({
+  palette: t,
+  monoShadePerCategory: r,
+  rotateBasePerChart: o,
+  children: u
+}) => {
+  const a = l(0), n = i(
+    () => ({
+      palette: t,
+      monoShadePerCategory: r,
+      rotateBasePerChart: o,
+      allocateChartSlot: /* @__PURE__ */ e(() => a.current++, "allocateChartSlot")
+    }),
+    [t, r, o]
+  );
+  return /* @__PURE__ */ C(s.Provider, { value: n, children: u });
+}, "ChartCardDefaultsProvider");
+export {
+  s as C,
+  h as a,
+  D as u
+};
+//# sourceMappingURL=ChartCardDefaultsContext-Cl5T25H0.js.map

package/dist/ChartCardDefaultsContext-Cl5T25H0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartCardDefaultsContext-Cl5T25H0.js","sources":["../src/data/ChartCardDefaultsContext.tsx"],"sourcesContent":["import React, { createContext, useContext, useMemo, useRef } from 'react';\n\n/**\n * Chart defaults — a host (or a dashboard viewer) can override the series\n * palette for a subtree and turn on \"mono-shade per category\" so single-series\n * bar charts use shades of one hue instead of the categorical palette.\n *\n * `palette` is the per-dashboard override; when absent, charts read\n * `theme.palette.bi.series` (see `useBiPalette`).\n */\nexport interface ChartCardDefaults {\n    /** Replaces `theme.palette.bi.series` for series and pie / donut slice colours. */\n    palette?: readonly string[];\n    /**\n     * When true, single-series bar charts colour each *category* (data row)\n     * with a different opacity of the base series colour.\n     */\n    monoShadePerCategory?: boolean;\n    /**\n     * When true, each ChartCard mounted under the provider gets a different\n     * primer colour from the palette in round-robin mount order.\n     */\n    rotateBasePerChart?: boolean;\n    /**\n     * Internal: provider-supplied counter used by ChartCard to claim a slot\n     * index on first mount. Use `ChartCardDefaultsProvider` rather than\n     * setting this directly.\n     */\n    allocateChartSlot?: () => number;\n}\n\nexport const ChartCardDefaultsContext = createContext<ChartCardDefaults>({});\n\nexport function useChartCardDefaults(): ChartCardDefaults {\n    return useContext(ChartCardDefaultsContext);\n}\n\nexport interface ChartCardDefaultsProviderProps {\n    palette?: readonly string[];\n    monoShadePerCategory?: boolean;\n    rotateBasePerChart?: boolean;\n    children: React.ReactNode;\n}\n\n/**\n * Wraps a subtree in a `ChartCardDefaultsContext`. Keeps a monotonically\n * increasing counter across child ChartCard mounts so each captures a stable\n * slot index on first render (not reset on parent re-renders).\n */\nexport const ChartCardDefaultsProvider: React.FC<ChartCardDefaultsProviderProps> = ({\n    palette,\n    monoShadePerCategory,\n    rotateBasePerChart,\n    children,\n}) => {\n    const counterRef = useRef(0);\n    const value = useMemo<ChartCardDefaults>(\n        () => ({\n            palette,\n            monoShadePerCategory,\n            rotateBasePerChart,\n            allocateChartSlot: () => counterRef.current++,\n        }),\n        [palette, monoShadePerCategory, rotateBasePerChart],\n    );\n    return <ChartCardDefaultsContext.Provider value={value}>{children}</ChartCardDefaultsContext.Provider>;\n};\n"],"names":["ChartCardDefaultsContext","createContext","useChartCardDefaults","useContext","__name","ChartCardDefaultsProvider","palette","monoShadePerCategory","rotateBasePerChart","children","counterRef","useRef","value","useMemo","jsx"],"mappings":";;;;AA+BO,MAAMA,IAA2BC,EAAiC,CAAA,CAAE;AAEpE,SAASC,IAA0C;AACtD,SAAOC,EAAWH,CAAwB;AAC9C;AAFgBI,EAAAF,GAAA;AAgBT,MAAMG,IAAsE,gBAAAD,EAAA,CAAC;AAAA,EAChF,SAAAE;AAAA,EACA,sBAAAC;AAAA,EACA,oBAAAC;AAAA,EACA,UAAAC;AACJ,MAAM;AACF,QAAMC,IAAaC,EAAO,CAAC,GACrBC,IAAQC;AAAA,IACV,OAAO;AAAA,MACH,SAAAP;AAAA,MACA,sBAAAC;AAAA,MACA,oBAAAC;AAAA,MACA,mBAAmB,gBAAAJ,EAAA,MAAMM,EAAW,WAAjB;AAAA,IAAiB;AAAA,IAExC,CAACJ,GAASC,GAAsBC,CAAkB;AAAA,EAAA;AAEtD,SAAO,gBAAAM,EAACd,EAAyB,UAAzB,EAAkC,OAAAY,GAAe,UAAAH,EAAA,CAAS;AACtE,GAjBmF;"}