@bluemarble/bi 0.6.2 → 0.6.4

package/dist/{ModelDictionary-BlDeDyAE.js → ModelDictionary-Dib4Vk3i.js}

@@ -1,5 +1,5 @@
 import { s as AGGREGATION_LABEL, t as canonicalJson, u as isAggregate } from "./codegen-DkfI6UJr.js";
-import { g as resolveChartTypes } from "./layout-DAFeHIuP.js";
+import { g as resolveChartTypes } from "./layout-nViz3MdU.js";
 import { Box, Table, TableBody, TableCell, TableContainer, TableHead, TableRow, Typography } from "@mui/material";
 import { Suspense, createContext, lazy, useCallback, useContext, useEffect, useId, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -115,6 +115,58 @@ function createLayoutStore() {
 	};
 }
 //#endregion
+//#region src/client/batchQueries.ts
+/**
+* Manda num request só (`{ model, queries }`) as consultas de um modelo feitas no mesmo ciclo — as
+* de um render da página. O servidor junta numa SQL só as que dão para juntar (mesmas dimensões,
+* filtros e fatos; ver `runBatch`): os KPIs viram uma consulta com todas as medidas, e "Vol. Total"
+* (fórmula de "Vol. Convencional" + "Vol. Esteira") reaproveita as agregações dos outros dois.
+*
+* Consultas do devtools (`query.devtools`) e de metadados passam direto. Se o lote falhar (ou o
+* servidor for de uma versão sem lote), cada consulta é refeita sozinha.
+*/
+function batchQueries(fetcher) {
+	const batches = /* @__PURE__ */ new Map();
+	const alone = ({ query, resolve, reject }) => fetcher(query).then(resolve, reject);
+	const flush = (model) => {
+		const members = batches.get(model) ?? [];
+		batches.delete(model);
+		if (members.length === 1) return alone(members[0]);
+		fetcher({
+			model,
+			queries: members.map(({ query: { dimensions, measures, filters } }) => ({
+				dimensions,
+				measures,
+				filters
+			}))
+		}).then(({ results }) => {
+			if (results?.length !== members.length) return members.forEach(alone);
+			members.forEach(({ resolve, reject }, index) => {
+				const { error, ...result } = results[index];
+				if (error) reject(new Error(error));
+				else resolve(result);
+			});
+		}, () => members.forEach(alone));
+	};
+	return (query) => {
+		if (query.meta || query.devtools || query.queries) return fetcher(query);
+		return new Promise((resolve, reject) => {
+			const members = batches.get(query.model);
+			if (members) return void members.push({
+				query,
+				resolve,
+				reject
+			});
+			batches.set(query.model, [{
+				query,
+				resolve,
+				reject
+			}]);
+			setTimeout(() => flush(query.model), 0);
+		});
+	};
+}
+//#endregion
 //#region src/devtools/store.ts
 const MAX_HISTORY = 100;
 /** `STORM_RUNS` execuções da mesma instância dentro de `STORM_WINDOW_MS` = consulta em loop. */
@@ -193,10 +245,11 @@ function createDevtoolsStore() {
 			emit();
 			return run.runId;
 		},
-		succeed: (runId, rows, debug) => update(runId, {
+		succeed: (runId, rows, debug, batched) => update(runId, {
 			status: "success",
 			rows,
-			debug
+			debug,
+			batched
 		}),
 		fail: (runId, error) => update(runId, {
 			status: "error",
@@ -230,7 +283,7 @@ function createDevtoolsStore() {
 //#endregion
 //#region src/client/DashboardProvider.tsx
 const DashboardContext = createContext(null);
-const DashboardDevtools = lazy(() => import("./DashboardDevtools-BT9mJrmJ.js"));
+const DashboardDevtools = lazy(() => import("./DashboardDevtools-CSRt9lib.js"));
 const DEVTOOLS_DEFAULT = process.env.NODE_ENV === "development";
 const draftStorageKey = (model) => `bm-dashboard-devtools:draft:${model}`;
 function loadDraft(model) {
@@ -245,7 +298,7 @@ function loadDraft(model) {
 * Guarda os filtros do dashboard. Todo componente dentro dele (filtros, gráficos, tabelas) consulta o
 * mesmo modelo com os mesmos filtros — é o que faz um slicer filtrar a página inteira, como no BI.
 */
-function DashboardProvider({ model, fetcher, defaultFilters = {}, devtools = DEVTOOLS_DEFAULT, charts, children }) {
+function DashboardProvider({ model, fetcher, defaultFilters = {}, devtools = DEVTOOLS_DEFAULT, charts, batch = true, children }) {
 	const chartTypes = useMemo(() => resolveChartTypes(charts), [charts]);
 	const chartComponents = useMemo(() => Object.fromEntries(Object.entries(charts ?? {}).map(([name, spec]) => [name, spec.component])), [charts]);
 	const [filters, setFilters] = useState(defaultFilters);
@@ -287,6 +340,7 @@ function DashboardProvider({ model, fetcher, defaultFilters = {}, devtools = DEV
 		devtools,
 		draft
 	]);
+	const queryFetcher = useMemo(() => batch ? batchQueries(effectiveFetcher) : effectiveFetcher, [batch, effectiveFetcher]);
 	const rawFetcher = useMemo(() => (query) => fetcher({
 		...query,
 		devtools: {
@@ -326,7 +380,7 @@ function DashboardProvider({ model, fetcher, defaultFilters = {}, devtools = DEV
 		model,
 		filters,
 		setFilter,
-		fetcher: effectiveFetcher,
+		fetcher: queryFetcher,
 		meta,
 		refreshKey,
 		chartTypes,
@@ -336,7 +390,7 @@ function DashboardProvider({ model, fetcher, defaultFilters = {}, devtools = DEV
 		model,
 		filters,
 		setFilter,
-		effectiveFetcher,
+		queryFetcher,
 		meta,
 		refreshKey,
 		chartTypes,
@@ -463,7 +517,7 @@ function useModelQuery({ dimensions, measures, ignoreFilters, label, skip = fals
 			if (cancelado) return;
 			setRows(result.rows);
 			setError(void 0);
-			if (runId) store?.succeed(runId, result.rows, result.devtools?.debug);
+			if (runId) store?.succeed(runId, result.rows, result.devtools?.debug, result.batched);
 		}).catch((err) => {
 			if (cancelado) return;
 			setError(err);
@@ -572,4 +626,4 @@ function ModelDictionary() {
 //#endregion
 export { formatCurrency as a, measureFormat as c, useDashboard as d, errorMessage as f, parseLayoutItemKey as h, fieldLabel as i, measureFormatter as l, layoutItemKey as m, INSPECT_ATTRIBUTE as n, formatMeasure as o, LAYOUT_ITEM_ATTRIBUTE as p, useModelQuery as r, formatNumber as s, ModelDictionary as t, DashboardProvider as u };
 
-//# sourceMappingURL=ModelDictionary-BlDeDyAE.js.map
+//# sourceMappingURL=ModelDictionary-Dib4Vk3i.js.map

package/dist/ModelDictionary-Dib4Vk3i.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelDictionary-Dib4Vk3i.js","names":["loadDraft"],"sources":["../src/devtools/layoutStore.ts","../src/client/batchQueries.ts","../src/devtools/store.ts","../src/client/DashboardProvider.tsx","../src/client/format.ts","../src/client/useModelQuery.ts","../src/client/ModelDictionary.tsx"],"sourcesContent":["import { canonicalJson } from '../codegen'\nimport type { ChartsLayout } from '../layout'\n\n/**\n * Layouts montados na página (`<DashboardCharts>` / `<DashboardFilters>`) e o rascunho de cada um,\n * editado na aba Layout do devtools. Store externo como o de consultas: editar um gráfico\n * re-renderiza só os componentes daquele layout e o painel.\n */\n\n/** Parte do layout que um componente renderiza. */\nexport type LayoutPart = 'charts' | 'filters' | 'canvas'\n\nexport type LayoutEntry = {\n  /** O layout que veio do arquivo (o que a página passou ao `<DashboardCharts>`). */\n  registered: ChartsLayout\n  /** Rascunho editado no devtools; `null` = página usando o registrado. */\n  draft: ChartsLayout | null\n  /**\n   * Partes montadas na página e os formatters que cada uma recebeu (`formatDimension`,\n   * `formatLabel`). Parte ausente = a página não renderiza (ex.: sem `<DashboardFilters>`).\n   */\n  parts: Partial<Record<LayoutPart, string[]>>\n}\n\n/**\n * Marca o elemento de cada item do layout com `<layoutId>/chart:<id>` ou\n * `<layoutId>/filter:<dimensão>` (destaque e inspetor do devtools).\n */\nexport const LAYOUT_ITEM_ATTRIBUTE = 'data-bm-dashboard-layout-item'\n\nexport const layoutItemKey = (layoutId: string, item: LayoutItem) =>\n  `${layoutId}/${item.kind}:${item.key}`\n\nexport type LayoutItem = { kind: 'chart' | 'filter'; key: string }\n\nexport function parseLayoutItemKey(value: string): { layoutId: string; item: LayoutItem } | null {\n  const match = /^([^/]+)\\/(chart|filter):(.+)$/.exec(value)\n  return match\n    ? {\n        layoutId: match[1] as string,\n        item: { kind: match[2] as LayoutItem['kind'], key: match[3] as string }\n      }\n    : null\n}\n\nconst draftKey = (id: string) => `bm-dashboard-devtools:layout:${id}`\n\nconst sameLayout = (a: ChartsLayout | null, b: ChartsLayout | null) =>\n  canonicalJson(a) === canonicalJson(b)\n\nfunction loadDraft(id: string): ChartsLayout | null {\n  try {\n    const saved = sessionStorage.getItem(draftKey(id))\n    return saved ? (JSON.parse(saved) as ChartsLayout) : null\n  } catch {\n    return null\n  }\n}\n\nfunction storeDraft(id: string, draft: ChartsLayout | null) {\n  try {\n    if (draft) sessionStorage.setItem(draftKey(id), JSON.stringify(draft))\n    else sessionStorage.removeItem(draftKey(id))\n  } catch {}\n}\n\nexport function createLayoutStore() {\n  const entries = new Map<string, LayoutEntry>()\n  // Montagens por layout e parte (`<id>\\u0000<parte>`)\n  const mounts = new Map<string, number>()\n  let snapshot: LayoutEntry[] = []\n  const listeners = new Set<() => void>()\n  // Edições da aba Layout ainda não aplicadas: sobrevivem a trocar de aba (o painel desmonta)\n  const pending = new Map<string, ChartsLayout>()\n\n  const emit = () => {\n    snapshot = [...entries.values()]\n    for (const listener of listeners) listener()\n  }\n\n  const setDraft = (id: string, next: ChartsLayout | null) => {\n    const entry = entries.get(id)\n    if (!entry) return\n    // Rascunho igual ao arquivo não é rascunho (ex.: desfez tudo à mão)\n    const draft = next && !sameLayout(next, entry.registered) ? next : null\n    storeDraft(id, draft)\n    entries.set(id, { ...entry, draft })\n    emit()\n  }\n\n  return {\n    subscribe(listener: () => void) {\n      listeners.add(listener)\n      return () => listeners.delete(listener)\n    },\n    getSnapshot: () => snapshot,\n    get: (id: string) => entries.get(id) ?? null,\n    /** Rascunho do layout, mesmo antes de registrar (evita renderizar o registrado e trocar). */\n    draftOf(layout: ChartsLayout) {\n      const entry = entries.get(layout.id)\n      if (entry) return entry.draft\n      const draft = loadDraft(layout.id)\n      return draft && !sameLayout(draft, layout) ? draft : null\n    },\n\n    /** Chamado pelo `<DashboardCharts>`/`<DashboardFilters>` ao montar e quando o arquivo muda (HMR). */\n    register(layout: ChartsLayout, part: LayoutPart, formatters: string[]) {\n      const current = entries.get(layout.id)\n      let draft = current ? current.draft : loadDraft(layout.id)\n      // Depois de \"Salvar no arquivo\" o Next recarrega o JSON: o rascunho virou o registrado\n      if (draft && sameLayout(draft, layout)) {\n        draft = null\n        storeDraft(layout.id, null)\n      }\n      const parts = { ...current?.parts, [part]: formatters }\n      entries.set(layout.id, { registered: layout, draft, parts })\n      const mountKey = `${layout.id}\\u0000${part}`\n      mounts.set(mountKey, (mounts.get(mountKey) ?? 0) + 1)\n      emit()\n      return () => {\n        const count = (mounts.get(mountKey) ?? 1) - 1\n        mounts.set(mountKey, count)\n        const entry = entries.get(layout.id)\n        if (count > 0 || !entry) return\n        const { [part]: _, ...rest } = entry.parts\n        // O rascunho continua no sessionStorage e volta na próxima montagem\n        if (Object.keys(rest).length) entries.set(layout.id, { ...entry, parts: rest })\n        else entries.delete(layout.id)\n        emit()\n      }\n    },\n    setDraft,\n    /** Edições ainda não aplicadas do layout (só em memória). */\n    pendingOf: (id: string) => pending.get(id) ?? null,\n    setPending(id: string, layout: ChartsLayout | null) {\n      if (layout) pending.set(id, layout)\n      else pending.delete(id)\n    }\n  }\n}\n\nexport type LayoutStore = ReturnType<typeof createLayoutStore>\n","import type { DashboardQuery, DashboardResult } from '../types'\n\ntype Fetcher = (query: DashboardQuery) => Promise<DashboardResult>\n\ntype Pending = {\n  query: DashboardQuery\n  resolve: (result: DashboardResult) => void\n  reject: (error: unknown) => void\n}\n\n/**\n * Manda num request só (`{ model, queries }`) as consultas de um modelo feitas no mesmo ciclo — as\n * de um render da página. O servidor junta numa SQL só as que dão para juntar (mesmas dimensões,\n * filtros e fatos; ver `runBatch`): os KPIs viram uma consulta com todas as medidas, e \"Vol. Total\"\n * (fórmula de \"Vol. Convencional\" + \"Vol. Esteira\") reaproveita as agregações dos outros dois.\n *\n * Consultas do devtools (`query.devtools`) e de metadados passam direto. Se o lote falhar (ou o\n * servidor for de uma versão sem lote), cada consulta é refeita sozinha.\n */\nexport function batchQueries(fetcher: Fetcher): Fetcher {\n  const batches = new Map<string, Pending[]>()\n\n  const alone = ({ query, resolve, reject }: Pending) => fetcher(query).then(resolve, reject)\n\n  const flush = (model: string) => {\n    const members = batches.get(model) ?? []\n    batches.delete(model)\n    if (members.length === 1) return alone(members[0])\n    const queries = members.map(({ query: { dimensions, measures, filters } }) => ({\n      dimensions,\n      measures,\n      filters\n    }))\n    fetcher({ model, queries }).then(\n      ({ results }) => {\n        if (results?.length !== members.length) return members.forEach(alone)\n        members.forEach(({ resolve, reject }, index) => {\n          const { error, ...result } = results[index]\n          if (error) reject(new Error(error))\n          else resolve(result)\n        })\n      },\n      () => members.forEach(alone)\n    )\n  }\n\n  return (query) => {\n    if (query.meta || query.devtools || query.queries) return fetcher(query)\n    return new Promise((resolve, reject) => {\n      const members = batches.get(query.model)\n      if (members) return void members.push({ query, resolve, reject })\n      batches.set(query.model, [{ query, resolve, reject }])\n      // As consultas de uma renderização disparam todas nos efeitos do mesmo commit\n      setTimeout(() => flush(query.model), 0)\n    })\n  }\n}\n","import type { DashboardQuery, DashboardQueryDebug, DashboardRow } from '../types'\n\n/**\n * Registro das consultas feitas pelos componentes (`useModelQuery`), lido pelo painel do devtools.\n * É um store externo (`useSyncExternalStore`) para que registrar uma consulta não re-renderize a\n * página inteira — só o painel.\n */\n\nexport type RunStatus = 'loading' | 'success' | 'error' | 'cancelled'\n\nexport type QueryRun = {\n  runId: number\n  instanceId: string\n  label: string\n  query: DashboardQuery\n  status: RunStatus\n  startedAt: number\n  /** Ida e volta medida no browser. */\n  durationMs?: number\n  rows?: DashboardRow[]\n  error?: string\n  debug?: DashboardQueryDebug\n  /** Foi num request junto com outras consultas (quantas, contando ela); o `debug` é do conjunto. */\n  batched?: number\n}\n\nexport type TrackedInstance = {\n  instanceId: string\n  label: string\n  runs: number\n  last: QueryRun\n  /** Refeita muitas vezes em pouco tempo: sinal de re-render em loop (ex.: array novo a cada render). */\n  storm: boolean\n}\n\nexport type DevtoolsSnapshot = {\n  instances: TrackedInstance[]\n  /** Execuções mais recentes primeiro. */\n  history: QueryRun[]\n}\n\nconst MAX_HISTORY = 100\n/** `STORM_RUNS` execuções da mesma instância dentro de `STORM_WINDOW_MS` = consulta em loop. */\nconst STORM_RUNS = 6\nconst STORM_WINDOW_MS = 5000\n\nexport function errorMessage(error: unknown): string {\n  const err = error as {\n    response?: { data?: { error?: string; message?: string } }\n    message?: string\n  }\n  return err?.response?.data?.error ?? err?.response?.data?.message ?? err?.message ?? String(error)\n}\n\nexport function createDevtoolsStore() {\n  const instances = new Map<string, TrackedInstance>()\n  let history: QueryRun[] = []\n  // Execuções em andamento (o histórico é limitado e pode já ter descartado uma consulta lenta)\n  const pending = new Map<number, QueryRun>()\n  const recentStarts = new Map<string, number[]>()\n  // Re-execuções pedidas pelo próprio devtools (refresh, aplicar rascunho) não contam como loop\n  let expectedUntil = 0\n  let snapshot: DevtoolsSnapshot = { instances: [], history: [] }\n  let nextRunId = 1\n  const listeners = new Set<() => void>()\n\n  const emit = () => {\n    snapshot = { instances: [...instances.values()], history }\n    for (const listener of listeners) listener()\n  }\n\n  const update = (runId: number, patch: Partial<QueryRun>) => {\n    const current = pending.get(runId)\n    if (!current) return\n    pending.delete(runId)\n    const run = { ...current, ...patch, durationMs: Date.now() - current.startedAt }\n    history = history.map((item) => (item.runId === runId ? run : item))\n    const instance = instances.get(run.instanceId)\n    if (instance?.last.runId === runId) instances.set(run.instanceId, { ...instance, last: run })\n    emit()\n  }\n\n  return {\n    subscribe(listener: () => void) {\n      listeners.add(listener)\n      return () => listeners.delete(listener)\n    },\n    getSnapshot: () => snapshot,\n\n    start(instanceId: string, label: string, query: DashboardQuery) {\n      const run: QueryRun = {\n        runId: nextRunId++,\n        instanceId,\n        label,\n        query,\n        status: 'loading',\n        startedAt: Date.now()\n      }\n      pending.set(run.runId, run)\n      history = [run, ...history].slice(0, MAX_HISTORY)\n      const previous = instances.get(instanceId)\n      const expected = run.startedAt <= expectedUntil\n      const starts = [\n        ...(recentStarts.get(instanceId) ?? []),\n        ...(expected ? [] : [run.startedAt])\n      ].filter((time) => run.startedAt - time <= STORM_WINDOW_MS)\n      recentStarts.set(instanceId, starts)\n      const storm = previous?.storm || starts.length >= STORM_RUNS\n      if (storm && !previous?.storm)\n        console.warn(\n          `[@bluemarble/bi] \"${label}\" executou ${starts.length}x em ${STORM_WINDOW_MS / 1000}s. ` +\n            'Confira se o componente não recria dimensions/measures/filtros a cada render.'\n        )\n      instances.set(instanceId, {\n        instanceId,\n        label,\n        runs: (previous?.runs ?? 0) + 1,\n        last: run,\n        storm\n      })\n      emit()\n      return run.runId\n    },\n    succeed: (runId: number, rows: DashboardRow[], debug?: DashboardQueryDebug, batched?: number) =>\n      update(runId, { status: 'success', rows, debug, batched }),\n    fail: (runId: number, error: unknown) =>\n      update(runId, { status: 'error', error: errorMessage(error) }),\n    /** Consulta descartada antes de responder (filtro mudou, componente desmontou). */\n    cancel: (runId: number) => update(runId, { status: 'cancelled' }),\n\n    remove(instanceId: string) {\n      recentStarts.delete(instanceId)\n      if (instances.delete(instanceId)) emit()\n    },\n    /** Avisa que todas as consultas vão refazer agora, de propósito. */\n    expectRefetch() {\n      expectedUntil = Date.now() + 500\n    },\n    /** Zera os alertas de loop (depois de corrigir o componente, sem recarregar a página). */\n    resetStorms() {\n      recentStarts.clear()\n      for (const [id, instance] of instances) instances.set(id, { ...instance, storm: false })\n      emit()\n    },\n    clearHistory() {\n      history = []\n      emit()\n    }\n  }\n}\n\nexport type DevtoolsStore = ReturnType<typeof createDevtoolsStore>\n","import {\n  type ComponentType,\n  createContext,\n  lazy,\n  type ReactNode,\n  Suspense,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState\n} from 'react'\nimport { createLayoutStore, type LayoutStore } from '../devtools/layoutStore'\nimport { batchQueries } from './batchQueries'\nimport { createDevtoolsStore, type DevtoolsStore } from '../devtools/store'\nimport { type ChartTypeSpec, type ChartTypes, resolveChartTypes } from '../layout'\nimport type { ModelDef, ModelMeta } from '../model'\nimport type { DashboardFilters, DashboardQuery, DashboardResult, FilterValue } from '../types'\n\nexport type DashboardFetcher = (query: DashboardQuery) => Promise<DashboardResult>\n\n/**\n * Tipo de gráfico do app: os campos do JSON (`ChartTypeSpec`) e o componente que os renderiza. O\n * componente recebe os campos como props (com os `default` aplicados e formatters já resolvidos) e\n * `queryLabel` — ver `ChartComponentProps`.\n */\n// biome-ignore lint/suspicious/noExplicitAny: cada tipo tem as próprias props, vindas do JSON\nexport type ChartComponentSpec = ChartTypeSpec & { component: ComponentType<any> }\n\n/** Props de um componente registrado em `charts`: os campos do tipo + `queryLabel`. */\nexport type ChartComponentProps<Fields extends object = Record<string, unknown>> = Fields & {\n  /** Nome da consulta no devtools (`<título> · <tipo>`): passe ao `useModelQuery({ label })`. */\n  queryLabel: string\n}\n\n/** Só existe com o devtools ligado. */\nexport type DashboardDevtoolsContext = {\n  store: DevtoolsStore\n  /** Layouts da página (`<DashboardCharts>`/`<DashboardFilters>`) e os rascunhos da aba Layout. */\n  layouts: LayoutStore\n  /** Consulta o modelo registrado, ignorando o rascunho (comparações, snapshots). */\n  rawFetcher: DashboardFetcher\n  /** Rascunho do modelo aplicado: todas as consultas da página passam a usá-lo. */\n  draft: ModelDef | null\n  setDraft: (draft: ModelDef | null) => void\n  /** Refaz todas as consultas da página. */\n  refresh: () => void\n  defaultFilters: DashboardFilters\n  setFilters: (filters: DashboardFilters) => void\n}\n\ntype DashboardContextValue = {\n  model: string\n  filters: DashboardFilters\n  setFilter: (dimension: string, values: FilterValue[]) => void\n  fetcher: DashboardFetcher\n  /** Dicionário do modelo (rótulos, descrições, formatos); `null` até carregar. */\n  meta: ModelMeta | null\n  /** Muda quando o devtools pede para refazer as consultas. */\n  refreshKey: number\n  /** Tipos de gráfico do layout: os da lib e os do app (`charts`). */\n  chartTypes: ChartTypes\n  /** Componentes dos tipos do app, por nome. */\n  chartComponents: Record<string, ChartComponentSpec['component']>\n  devtools: DashboardDevtoolsContext | null\n}\n\nconst DashboardContext = createContext<DashboardContextValue | null>(null)\n\n// Lazy: o painel não entra no bundle da página, só é baixado quando o devtools está ligado\nconst DashboardDevtools = lazy(() => import('../devtools/DashboardDevtools'))\n\nconst DEVTOOLS_DEFAULT = process.env.NODE_ENV === 'development'\n\nconst draftStorageKey = (model: string) => `bm-dashboard-devtools:draft:${model}`\n\nfunction loadDraft(model: string): ModelDef | null {\n  try {\n    const saved = sessionStorage.getItem(draftStorageKey(model))\n    return saved ? (JSON.parse(saved) as ModelDef) : null\n  } catch {\n    return null\n  }\n}\n\ntype DashboardProviderProps = {\n  /** Nome do modelo no servidor (chave do registro de modelos do app). */\n  model: string\n  /** Como chamar o endpoint do app (ex.: `(q) => api.post('/dashboard/query', q).then((r) => r.data)`). */\n  fetcher: DashboardFetcher\n  defaultFilters?: DashboardFilters\n  /**\n   * Painel de desenvolvimento (debug das consultas, edição do modelo). Padrão: ligado só com\n   * `NODE_ENV=development`. O endpoint também precisa de `runQuery(..., { devtools: true })`.\n   */\n  devtools?: boolean\n  /**\n   * Tipos de gráfico do app, usáveis no layout JSON (`\"type\": \"<nome>\"`) e no editor do devtools.\n   * Declare fora do componente (referência estável). O servidor precisa dos mesmos campos em\n   * `devtools.chartTypes` para salvar o layout.\n   */\n  charts?: Record<string, ChartComponentSpec>\n  /**\n   * Manda as consultas de um render num request só; o servidor junta numa SQL as que têm as mesmas\n   * dimensões, filtros e fatos (ex.: os KPIs). Padrão: ligado.\n   */\n  batch?: boolean\n  children: ReactNode\n}\n\n/**\n * Guarda os filtros do dashboard. Todo componente dentro dele (filtros, gráficos, tabelas) consulta o\n * mesmo modelo com os mesmos filtros — é o que faz um slicer filtrar a página inteira, como no BI.\n */\nexport function DashboardProvider({\n  model,\n  fetcher,\n  defaultFilters = {},\n  devtools = DEVTOOLS_DEFAULT,\n  charts,\n  batch = true,\n  children\n}: DashboardProviderProps) {\n  const chartTypes = useMemo(() => resolveChartTypes(charts), [charts])\n  const chartComponents = useMemo(\n    () =>\n      Object.fromEntries(\n        Object.entries(charts ?? {}).map(([name, spec]) => [name, spec.component])\n      ),\n    [charts]\n  )\n  const [filters, setFilters] = useState<DashboardFilters>(defaultFilters)\n  const defaultsRef = useRef(defaultFilters)\n\n  const setFilter = useCallback(\n    (dimension: string, values: FilterValue[]) =>\n      setFilters((current) => ({ ...current, [dimension]: values })),\n    []\n  )\n\n  // --- devtools ---\n  const store = useMemo(() => (devtools ? createDevtoolsStore() : null), [devtools])\n  const layouts = useMemo(() => (devtools ? createLayoutStore() : null), [devtools])\n  // O rascunho aplicado sobrevive ao reload da aba (útil enquanto se edita o modelo)\n  const [draft, setDraftState] = useState<ModelDef | null>(() =>\n    devtools && typeof window !== 'undefined' ? loadDraft(model) : null\n  )\n  const [refreshKey, setRefreshKey] = useState(0)\n  const [mounted, setMounted] = useState(false)\n  useEffect(() => setMounted(true), [])\n\n  const setDraft = useCallback(\n    (next: ModelDef | null) => {\n      store?.expectRefetch()\n      setDraftState(next)\n      try {\n        if (next) sessionStorage.setItem(draftStorageKey(model), JSON.stringify(next))\n        else sessionStorage.removeItem(draftStorageKey(model))\n      } catch {}\n    },\n    [model, store]\n  )\n\n  const refresh = useCallback(() => {\n    store?.expectRefetch()\n    setRefreshKey((key) => key + 1)\n  }, [store])\n\n  // Com o devtools ligado, toda consulta pede debug e, se houver, roda contra o rascunho\n  const effectiveFetcher = useMemo<DashboardFetcher>(() => {\n    if (!devtools) return fetcher\n    return (query) =>\n      fetcher({\n        ...query,\n        devtools: { debug: true, ...(draft && { model: draft }), ...query.devtools }\n      })\n  }, [fetcher, devtools, draft])\n  const queryFetcher = useMemo(\n    () => (batch ? batchQueries(effectiveFetcher) : effectiveFetcher),\n    [batch, effectiveFetcher]\n  )\n\n  const rawFetcher = useMemo<DashboardFetcher>(\n    () => (query) => fetcher({ ...query, devtools: { debug: true, ...query.devtools } }),\n    [fetcher]\n  )\n\n  // Dicionário: segue o rascunho, para os rótulos editados aparecerem na hora\n  const [meta, setMeta] = useState<ModelMeta | null>(null)\n  useEffect(() => {\n    let cancelado = false\n    effectiveFetcher({ model, meta: true })\n      .then((result) => !cancelado && setMeta(result.meta ?? null))\n      .catch(() => !cancelado && setMeta(null))\n    return () => {\n      cancelado = true\n    }\n  }, [effectiveFetcher, model])\n\n  const devtoolsValue = useMemo(\n    () =>\n      store &&\n      layouts && {\n        store,\n        layouts,\n        rawFetcher,\n        draft,\n        setDraft,\n        refresh,\n        defaultFilters: defaultsRef.current,\n        setFilters\n      },\n    [store, layouts, rawFetcher, draft, setDraft, refresh]\n  )\n\n  const value = useMemo(\n    () => ({\n      model,\n      filters,\n      setFilter,\n      fetcher: queryFetcher,\n      meta,\n      refreshKey,\n      chartTypes,\n      chartComponents,\n      devtools: devtoolsValue\n    }),\n    [\n      model,\n      filters,\n      setFilter,\n      queryFetcher,\n      meta,\n      refreshKey,\n      chartTypes,\n      chartComponents,\n      devtoolsValue\n    ]\n  )\n\n  return (\n    <DashboardContext.Provider value={value}>\n      {children}\n      {/* Só depois de montar: o painel lê localStorage e não deve participar da hidratação */}\n      {devtoolsValue && mounted && (\n        <Suspense fallback={null}>\n          <DashboardDevtools />\n        </Suspense>\n      )}\n    </DashboardContext.Provider>\n  )\n}\n\nexport function useDashboard() {\n  const context = useContext(DashboardContext)\n  if (!context) throw new Error('useDashboard precisa estar dentro de <DashboardProvider>')\n  return context\n}\n","import type { ChartNumberFormat } from '../layout'\nimport type { ModelMeta } from '../model'\n\nconst formatters = new Map<string, Intl.NumberFormat>()\n\n/** `compact`: notação curta do pt-BR (1,2 mil / 3,4 mi / 5,6 bi). */\nexport function formatNumber(\n  value: number | string | null | undefined,\n  decimals = 2,\n  compact = false\n) {\n  if (value === null || value === undefined || value === '') return ''\n  const number = Number(value)\n  if (Number.isNaN(number)) return String(value)\n  const key = `${decimals}:${compact}`\n  let formatter = formatters.get(key)\n  if (!formatter) {\n    formatter = new Intl.NumberFormat('pt-BR', {\n      minimumFractionDigits: decimals,\n      maximumFractionDigits: decimals,\n      ...(compact && { notation: 'compact' })\n    })\n    formatters.set(key, formatter)\n  }\n  return formatter.format(number)\n}\n\nexport const formatCurrency = (\n  value: number | string | null | undefined,\n  decimals = 2,\n  compact = false\n) => {\n  const text = formatNumber(value, decimals, compact)\n  return text && `R$ ${text}`\n}\n\n/**\n * Formata pelo dicionário do modelo (`format`/`decimals` da medida) ou pelo formato do gráfico.\n * `fallbackDecimals` é o padrão do componente quando nenhum dos dois define `decimals`.\n */\nexport function formatMeasure(\n  value: number | string | null | undefined,\n  meta: ChartNumberFormat | undefined,\n  fallbackDecimals = 2\n) {\n  if (value === null || value === undefined || value === '') return ''\n  const decimals = meta?.decimals ?? (meta?.format === 'integer' ? 0 : fallbackDecimals)\n  const compact = meta?.compact ?? false\n  let text: string\n  switch (meta?.format) {\n    case 'currency':\n      text = formatCurrency(value, decimals, compact)\n      break\n    case 'percent': {\n      const number = formatNumber(Number(value) * 100, decimals, compact)\n      text = number && `${number}%`\n      break\n    }\n    default:\n      text = formatNumber(value, decimals, compact)\n  }\n  return text && `${meta?.prefix ?? ''}${text}${meta?.suffix ?? ''}`\n}\n\n/** Dicionário do modelo com o formato do gráfico por cima. */\nexport function measureFormat(\n  meta: ModelMeta | null,\n  measure: string,\n  formats?: Record<string, ChartNumberFormat>\n): ChartNumberFormat | undefined {\n  const fromModel = meta?.measures[measure]\n  const fromChart = formats?.[measure]\n  if (!fromChart) return fromModel\n  return {\n    ...(fromModel?.format !== undefined && { format: fromModel.format }),\n    ...(fromModel?.decimals !== undefined && { decimals: fromModel.decimals }),\n    ...fromChart\n  }\n}\n\n/**\n * Formatter de uma medida: o `formats` do gráfico (se houver) por cima do dicionário do modelo; sem\n * `format`, número com `fallbackDecimals`.\n */\nexport function measureFormatter(\n  meta: ModelMeta | null,\n  measure: string,\n  fallbackDecimals = 2,\n  formats?: Record<string, ChartNumberFormat>\n): (value: number | string | null | undefined) => string {\n  const format = measureFormat(meta, measure, formats)\n  return (value) => formatMeasure(value, format, fallbackDecimals)\n}\n\n/** Rótulo de uma dimensão/medida: o `labels` do gráfico, o dicionário do modelo ou o nome. */\nexport function fieldLabel(\n  meta: ModelMeta | null,\n  name: string,\n  labels?: Record<string, string>\n): string {\n  return labels?.[name] || meta?.dimensions[name]?.label || meta?.measures[name]?.label || name\n}\n","import { useEffect, useId, useMemo, useState } from 'react'\nimport type { DashboardFilters, DashboardRow } from '../types'\nimport { useDashboard } from './DashboardProvider'\n\nexport const INSPECT_ATTRIBUTE = 'data-bm-dashboard-query'\n\ntype UseModelQueryParams = {\n  dimensions?: string[]\n  measures?: string[]\n  /**\n   * Filtros do dashboard que esta consulta NÃO deve respeitar. Um filtro ignora a si mesmo para\n   * listar as opções (senão, ao escolher um navio, a lista mostraria só ele).\n   */\n  ignoreFilters?: string[]\n  /** Nome da consulta no devtools (padrão: dimensões × medidas). */\n  label?: string\n  /** Não consulta (devolve `rows: []`); ex.: a linha de total de uma tabela que não mostra total. */\n  skip?: boolean\n}\n\nexport function useModelQuery({\n  dimensions,\n  measures,\n  ignoreFilters,\n  label,\n  skip = false\n}: UseModelQueryParams) {\n  const { model, filters, fetcher, refreshKey, devtools } = useDashboard()\n  const instanceId = useId()\n\n  const applied: DashboardFilters = {}\n  for (const [dimension, values] of Object.entries(filters)) {\n    if (values.length && !ignoreFilters?.includes(dimension)) applied[dimension] = values\n  }\n\n  // Chave por valor: só refaz a consulta quando o que vai pro servidor muda (não a cada render,\n  // nem quando muda um filtro que esta consulta ignora)\n  const key = JSON.stringify([model, dimensions, measures, applied])\n  const query = useMemo(() => ({ model, dimensions, measures, filters: applied }), [key])\n\n  const [rows, setRows] = useState<DashboardRow[]>([])\n  const [isLoading, setIsLoading] = useState(true)\n  const [error, setError] = useState<unknown>()\n\n  const store = devtools?.store\n  const debugLabel =\n    label ?? [dimensions?.join(', '), measures?.join(', ')].filter(Boolean).join(' × ')\n\n  useEffect(() => {\n    if (skip) {\n      setRows([])\n      setIsLoading(false)\n      return\n    }\n    let cancelado = false\n    setIsLoading(true)\n    const runId = store?.start(instanceId, debugLabel, query)\n    fetcher(query)\n      .then((result) => {\n        if (cancelado) return\n        setRows(result.rows)\n        setError(undefined)\n        if (runId) store?.succeed(runId, result.rows, result.devtools?.debug, result.batched)\n      })\n      .catch((err) => {\n        if (cancelado) return\n        setError(err)\n        if (runId) store?.fail(runId, err)\n      })\n      .finally(() => !cancelado && setIsLoading(false))\n    return () => {\n      cancelado = true\n      if (runId) store?.cancel(runId)\n    }\n  }, [fetcher, query, refreshKey, skip])\n\n  useEffect(() => (store ? () => store.remove(instanceId) : undefined), [store, instanceId, skip])\n\n  // Espalhar no elemento raiz do componente: é como o inspetor do devtools acha o componente na tela\n  const inspectProps = store && !skip ? { [INSPECT_ATTRIBUTE]: instanceId } : {}\n\n  return { rows, isLoading, error, inspectProps }\n}\n","import {\n  Box,\n  Table,\n  TableBody,\n  TableCell,\n  TableContainer,\n  TableHead,\n  TableRow,\n  Typography\n} from '@mui/material'\nimport { AGGREGATION_LABEL, isAggregate, type ModelMeta, type ValueFormat } from '../model'\nimport { useDashboard } from './DashboardProvider'\n\nconst FORMAT_LABEL: Record<ValueFormat, string> = {\n  number: 'Número',\n  integer: 'Inteiro',\n  currency: 'Moeda (R$)',\n  percent: 'Percentual'\n}\n\n/** Como a medida é calculada, em termos de negócio (o SQL não sai do servidor). */\nfunction formula(meta: ModelMeta, name: string) {\n  const measure = meta.measures[name]\n  const label = (ref: string) => meta.measures[ref]?.label ?? ref\n  if (measure.type === 'formula' && measure.refs?.length)\n    return `Combina ${measure.refs.map(label).join(', ')}`\n  if (isAggregate(measure)) return AGGREGATION_LABEL[measure.type]\n  if (measure.type !== 'ratio' || !measure.numerator || !measure.denominator) return '—'\n  return `${label(measure.numerator)} ÷ ${label(measure.denominator)}`\n}\n\n/**\n * Dicionário do modelo do `DashboardProvider`: o que cada filtro/eixo e cada número significa. É\n * montado a partir de `label`/`description` das dimensões e medidas — documentação que não\n * desatualiza, porque é a mesma definição que calcula os números.\n */\nexport function ModelDictionary() {\n  const { meta } = useDashboard()\n  if (!meta) return null\n\n  const header = (labels: string[]) => (\n    <TableHead>\n      <TableRow>\n        {labels.map((label) => (\n          <TableCell key={label} sx={{ fontWeight: 700 }}>\n            {label}\n          </TableCell>\n        ))}\n      </TableRow>\n    </TableHead>\n  )\n\n  return (\n    <Box sx={{ display: 'flex', flexDirection: 'column', gap: 2 }}>\n      <Box>\n        <Typography sx={{ fontWeight: 700, mb: 1 }}>Indicadores</Typography>\n        <TableContainer>\n          <Table size=\"small\">\n            {header(['Indicador', 'Descrição', 'Cálculo', 'Formato'])}\n            <TableBody>\n              {Object.entries(meta.measures).map(([name, measure]) => (\n                <TableRow key={name}>\n                  <TableCell sx={{ whiteSpace: 'nowrap' }}>{measure.label ?? name}</TableCell>\n                  <TableCell>{measure.description ?? '—'}</TableCell>\n                  <TableCell sx={{ whiteSpace: 'nowrap' }}>{formula(meta, name)}</TableCell>\n                  <TableCell sx={{ whiteSpace: 'nowrap' }}>\n                    {measure.format ? FORMAT_LABEL[measure.format] : '—'}\n                  </TableCell>\n                </TableRow>\n              ))}\n            </TableBody>\n          </Table>\n        </TableContainer>\n      </Box>\n      <Box>\n        <Typography sx={{ fontWeight: 700, mb: 1 }}>Filtros e agrupamentos</Typography>\n        <TableContainer>\n          <Table size=\"small\">\n            {header(['Campo', 'Descrição'])}\n            <TableBody>\n              {Object.entries(meta.dimensions).map(([name, dimension]) => (\n                <TableRow key={name}>\n                  <TableCell sx={{ whiteSpace: 'nowrap' }}>{dimension.label ?? name}</TableCell>\n                  <TableCell>{dimension.description ?? '—'}</TableCell>\n                </TableRow>\n              ))}\n            </TableBody>\n          </Table>\n        </TableContainer>\n      </Box>\n    </Box>\n  )\n}\n"],"mappings":"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"}

package/dist/client/index.d.ts

@@ -1,16 +1,25 @@
-import { A as DashboardRow, C as ColumnVerticalAlign, D as DashboardQuery, E as DashboardFilters$1, K as ModelDef, N as FilterValue, O as DashboardQueryDebug, S as ColumnAlign, d as ChartsLayout, i as CardStyle, k as DashboardResult, l as ChartTypeSpec, o as ChartDef, q as ModelMeta, s as ChartNumberFormat, u as ChartTypes, w as FormatRule } from "../layout-B7eYgNyR.js";
+import { A as DashboardQueryDebug, C as ColumnVerticalAlign, F as FilterValue, J as ModelDef, M as DashboardRow, O as DashboardFilters$1, S as ColumnAlign, Y as ModelMeta, d as ChartsLayout, i as CardStyle, j as DashboardResult, k as DashboardQuery, l as ChartTypeSpec, o as ChartDef, s as ChartNumberFormat, u as ChartTypes, w as FormatRule } from "../layout-CoGyGWYM.js";
 import { ComponentType, MouseEvent, ReactNode } from "react";
 //#region src/client/BarChart.d.ts
 type BarChartProps = {
   /** Dimensão das categorias. */
   dimension: string;
-  /** Uma série por medida (cores fixas pela posição). */
+  /** Uma série por medida (cores fixas pela posição); com `series`, só a primeira. */
   measures: string[];
+  /**
+   * Dimensão da legenda: quebra a medida pelos valores dela, uma série por valor (a "Legenda" do
+   * Power BI). A cor de cada valor é fixa (ordem do total sem filtros), mesmo que um filtro tire
+   * outro valor do gráfico.
+   */
+  series?: string;
+  formatSeries?: (value: FilterValue) => string;
+  /** Com `series`: as menores além dessa quantidade viram "Outros" (no máximo 8). Padrão: 6. */
+  maxSeries?: number;
   /** `horizontal` cabe nomes longos; com muitas categorias, rola dentro da altura. */
   orientation?: 'vertical' | 'horizontal';
   /** Empilha as séries (só faz sentido com partes de um total). */
   stacked?: boolean;
-  /** `dimension` = ordem da consulta; `desc`/`asc` = pela primeira medida. */
+  /** `dimension` = ordem da consulta; `desc`/`asc` = pela primeira medida (com `series`, pelo total). */
   sort?: 'dimension' | 'desc' | 'asc';
   /** Só os N primeiros depois de ordenar. */
   limit?: number;
@@ -31,8 +40,10 @@ type BarChartProps = {
 /**
  * Barras de uma ou mais medidas por uma dimensão. Ex.:
  * `<BarChart dimension="navio" measures={['custoTotal']} orientation="horizontal" sort="desc" limit={10} />`.
+ * Com `series`, uma medida quebrada pelos valores de outra dimensão:
+ * `<BarChart dimension="mes" series="tipo_descarga" measures={['volume']} stacked />`.
  */
-declare function BarChart({ dimension, measures, orientation, stacked, sort, limit, formatDimension, hideEmpty, showValues, clickToFilter, height, labels, formats: formatsByMeasure, queryLabel }: BarChartProps): import("react").JSX.Element;
+declare function BarChart({ dimension, measures: measureList, series, formatSeries, maxSeries, orientation, stacked, sort, limit, formatDimension, hideEmpty, showValues, clickToFilter, height, labels, formats: formatsByMeasure, queryLabel }: BarChartProps): import("react").JSX.Element;
 //#endregion
 //#region src/client/ComboChart.d.ts
 type ComboChartProps = {
@@ -249,6 +260,8 @@ type QueryRun = {
   rows?: DashboardRow[];
   error?: string;
   debug?: DashboardQueryDebug;
+  /** Foi num request junto com outras consultas (quantas, contando ela); o `debug` é do conjunto. */
+  batched?: number;
 };
 type TrackedInstance = {
   instanceId: string;
@@ -267,7 +280,7 @@ declare function createDevtoolsStore(): {
   subscribe(listener: () => void): () => boolean;
   getSnapshot: () => DevtoolsSnapshot;
   start(instanceId: string, label: string, query: DashboardQuery): number;
-  succeed: (runId: number, rows: DashboardRow[], debug?: DashboardQueryDebug) => void;
+  succeed: (runId: number, rows: DashboardRow[], debug?: DashboardQueryDebug, batched?: number) => void;
   fail: (runId: number, error: unknown) => void;
   /** Consulta descartada antes de responder (filtro mudou, componente desmontou). */
   cancel: (runId: number) => void;
@@ -342,13 +355,18 @@ type DashboardProviderProps = {
    * `devtools.chartTypes` para salvar o layout.
    */
   charts?: Record<string, ChartComponentSpec>;
+  /**
+   * Manda as consultas de um render num request só; o servidor junta numa SQL as que têm as mesmas
+   * dimensões, filtros e fatos (ex.: os KPIs). Padrão: ligado.
+   */
+  batch?: boolean;
   children: ReactNode;
 };
 /**
  * Guarda os filtros do dashboard. Todo componente dentro dele (filtros, gráficos, tabelas) consulta o
  * mesmo modelo com os mesmos filtros — é o que faz um slicer filtrar a página inteira, como no BI.
  */
-declare function DashboardProvider({ model, fetcher, defaultFilters, devtools, charts, children }: DashboardProviderProps): import("react").JSX.Element;
+declare function DashboardProvider({ model, fetcher, defaultFilters, devtools, charts, batch, children }: DashboardProviderProps): import("react").JSX.Element;
 declare function useDashboard(): DashboardContextValue;
 //#endregion
 //#region src/client/DataTable.d.ts