@bluemarble/bi 0.5.0 → 0.6.0

package/dist/{ModelDictionary-D3JzCd6x.js → ModelDictionary-C2tzlOY8.js}

@@ -1,4 +1,5 @@
-import { C as AGGREGATION_LABEL, E as isAggregate, g as resolveChartTypes, v as canonicalJson } from "./layout-QuOYFmp1.js";
+import { l as isAggregate, o as AGGREGATION_LABEL, t as canonicalJson } from "./codegen-DBe4-XW_.js";
+import { g as resolveChartTypes } from "./layout-BS51SQcJ.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";
@@ -229,7 +230,7 @@ function createDevtoolsStore() {
 //#endregion
 //#region src/client/DashboardProvider.tsx
 const DashboardContext = createContext(null);
-const DashboardDevtools = lazy(() => import("./DashboardDevtools-6v5HDe-A.js"));
+const DashboardDevtools = lazy(() => import("./DashboardDevtools-SCewfQGR.js"));
 const DEVTOOLS_DEFAULT = process.env.NODE_ENV === "development";
 const draftStorageKey = (model) => `bm-dashboard-devtools:draft:${model}`;
 function loadDraft(model) {
@@ -571,4 +572,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-D3JzCd6x.js.map
+//# sourceMappingURL=ModelDictionary-C2tzlOY8.js.map

package/dist/{ModelDictionary-D3JzCd6x.js.map → ModelDictionary-C2tzlOY8.js.map}

@@ -1 +1 @@
-{"version":3,"file":"ModelDictionary-D3JzCd6x.js","names":["loadDraft"],"sources":["../src/devtools/layoutStore.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, 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}\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) =>\n      update(runId, { status: 'success', rows, debug }),\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 { 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  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  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\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: effectiveFetcher,\n      meta,\n      refreshKey,\n      chartTypes,\n      chartComponents,\n      devtools: devtoolsValue\n    }),\n    [\n      model,\n      filters,\n      setFilter,\n      effectiveFetcher,\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)\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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"}
+{"version":3,"file":"ModelDictionary-C2tzlOY8.js","names":["loadDraft"],"sources":["../src/devtools/layoutStore.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, 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}\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) =>\n      update(runId, { status: 'success', rows, debug }),\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 { 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  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  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\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: effectiveFetcher,\n      meta,\n      refreshKey,\n      chartTypes,\n      chartComponents,\n      devtools: devtoolsValue\n    }),\n    [\n      model,\n      filters,\n      setFilter,\n      effectiveFetcher,\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)\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/cli.d.ts

@@ -0,0 +1 @@
+export {}

package/dist/cli.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+import { i as toModelCode } from "./codegen-DBe4-XW_.js";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { parseArgs } from "node:util";
+//#region src/cli/scaffold.ts
+/**
+* Arquivos de um dashboard novo: o modelo vazio (`models/<nome>.ts`), o registro dele no
+* `models/index.ts` e o layout vazio (`layouts/<id>.json`). Tudo como texto, sem tocar no disco —
+* quem grava é o CLI (`bm-bi new`).
+*/
+var ScaffoldError = class extends Error {};
+const IDENTIFIER = /^[A-Za-z_$][\w$]*$/;
+const LAYOUT_ID = /^[\w-]+$/;
+function checkModelName(name) {
+	if (!IDENTIFIER.test(name)) throw new ScaffoldError(`Nome de modelo inválido: "${name}" (use um identificador JS, ex.: analiseCusto)`);
+}
+function checkLayoutId(id) {
+	if (!LAYOUT_ID.test(id)) throw new ScaffoldError(`Id de layout inválido: "${id}" (só letras, números, _ e -)`);
+}
+/** Modelo vazio, pronto para montar pelo diagrama da aba Modelo do devtools. */
+function modelFileCode(name) {
+	checkModelName(name);
+	return toModelCode({
+		name,
+		tables: {},
+		dimensions: {},
+		measures: {}
+	}).replace("export const", "/** Monte tabelas, relacionamentos, dimensões e medidas pela aba Modelo do devtools. */\nexport const");
+}
+/** Layout vazio, pronto para montar pela aba Layout do devtools. */
+function layoutFileCode(id) {
+	checkLayoutId(id);
+	return `${JSON.stringify({
+		id,
+		filters: [],
+		charts: []
+	}, null, 2)}\n`;
+}
+/** `models/index.ts` novo, com só este modelo. */
+function modelIndexCode(name) {
+	checkModelName(name);
+	return [
+		`import { ${name} } from './${name}'`,
+		"",
+		"/** Modelos expostos pelo endpoint do dashboard (`runQuery(dashboardModels, ...)`). */",
+		"export const dashboardModels = {",
+		`  ${name}`,
+		"}",
+		""
+	].join("\n");
+}
+/**
+* Acrescenta o modelo ao `models/index.ts` existente: o import depois do último import e o nome no
+* primeiro `export const x = { ... }`. Devolve `null` se o modelo já está registrado.
+*/
+function registerModel(source, name) {
+	checkModelName(name);
+	if (new RegExp(`from\\s+['"]\\./${name}(\\.ts)?['"]`).test(source)) return null;
+	const object = /export\s+const\s+\w+(?:\s*:[^=]+)?\s*=\s*\{/.exec(source);
+	if (!object) throw new ScaffoldError("Não encontrei `export const <nome> = { ... }` no models/index.ts — registre o modelo à mão.");
+	const open = object.index + object[0].length - 1;
+	let depth = 0;
+	let close = -1;
+	for (let i = open; i < source.length; i++) if (source[i] === "{") depth++;
+	else if (source[i] === "}" && --depth === 0) {
+		close = i;
+		break;
+	}
+	if (close === -1) throw new ScaffoldError("Objeto de modelos do models/index.ts sem `}`.");
+	const body = source.slice(open + 1, close);
+	const items = body.trimEnd();
+	let newBody;
+	if (!items.trim()) newBody = `\n  ${name}\n`;
+	else if (!body.includes("\n")) newBody = ` ${items.trim().replace(/,$/, "")}, ${name} `;
+	else newBody = `${items.endsWith(",") ? items : `${items},`}\n  ${name}\n`;
+	let result = `${source.slice(0, open + 1)}${newBody}${source.slice(close)}`;
+	const line = `import { ${name} } from './${name}'\n`;
+	const last = [...result.matchAll(/^import[\s\S]*?from\s+['"][^'"]+['"];?[^\n]*\n/gm)].at(-1);
+	const at = last ? last.index + last[0].length : 0;
+	result = `${result.slice(0, at)}${line}${last ? "" : "\n"}${result.slice(at)}`;
+	return result;
+}
+//#endregion
+//#region src/cli/index.ts
+const HELP = `Uso: bm-bi new <nome> [opções]
+
+Cria um dashboard vazio: o modelo (models/<nome>.ts, registrado em models/index.ts) e o layout
+(layouts/<id>.json). Depois é montar tudo pelas abas Modelo e Layout do devtools.
+
+Opções:
+  --id <id>          id do layout (padrão: o nome do modelo)
+  --dir <pasta>      pasta dos dashboards (padrão: src/dashboard)
+  --models <pasta>   pasta dos modelos (padrão: <dir>/models)
+  --layouts <pasta>  pasta dos layouts (padrão: <dir>/layouts)
+  -h, --help         esta ajuda
+`;
+function main(argv) {
+	const { values, positionals } = parseArgs({
+		args: argv,
+		allowPositionals: true,
+		options: {
+			id: { type: "string" },
+			dir: {
+				type: "string",
+				default: "src/dashboard"
+			},
+			models: { type: "string" },
+			layouts: { type: "string" },
+			help: {
+				type: "boolean",
+				short: "h"
+			}
+		}
+	});
+	const [command, name, ...rest] = positionals;
+	if (values.help || !command) {
+		process.stdout.write(HELP);
+		return;
+	}
+	if (command !== "new") throw new ScaffoldError(`Comando desconhecido: ${command}\n\n${HELP}`);
+	if (!name) throw new ScaffoldError(`Falta o nome do modelo.\n\n${HELP}`);
+	if (rest.length) throw new ScaffoldError(`Argumentos a mais: ${rest.join(" ")}`);
+	const id = values.id ?? name;
+	checkModelName(name);
+	checkLayoutId(id);
+	const cwd = process.cwd();
+	const modelsDir = join(cwd, values.models ?? join(values.dir, "models"));
+	const layoutsDir = join(cwd, values.layouts ?? join(values.dir, "layouts"));
+	const modelPath = join(modelsDir, `${name}.ts`);
+	const indexPath = join(modelsDir, "index.ts");
+	const layoutPath = join(layoutsDir, `${id}.json`);
+	for (const path of [modelPath, layoutPath]) if (existsSync(path)) throw new ScaffoldError(`Já existe: ${relative(cwd, path)}`);
+	const index = existsSync(indexPath) ? registerModel(readFileSync(indexPath, "utf8"), name) : modelIndexCode(name);
+	const written = [];
+	const write = (path, content) => {
+		mkdirSync(dirname(path), { recursive: true });
+		writeFileSync(path, content);
+		written.push(relative(cwd, path));
+	};
+	write(modelPath, modelFileCode(name));
+	if (index !== null) write(indexPath, index);
+	write(layoutPath, layoutFileCode(id));
+	process.stdout.write([
+		...written.map((path) => `✓ ${path}`),
+		"",
+		"Falta a página, com o layout:",
+		`  <DashboardProvider model="${name}" fetcher={fetcher}>`,
+		"    <DashboardFilters layout={layout} />",
+		"    <DashboardCharts layout={layout} />",
+		"  </DashboardProvider>",
+		""
+	].join("\n"));
+}
+try {
+	main(process.argv.slice(2));
+} catch (error) {
+	if (!(error instanceof ScaffoldError) && !(error instanceof TypeError)) throw error;
+	process.stderr.write(`${error.message}\n`);
+	process.exitCode = 1;
+}
+//#endregion
+
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli/scaffold.ts","../src/cli/index.ts"],"sourcesContent":["import { toModelCode } from '../codegen'\nimport type { ChartsLayout } from '../layout'\n\n/**\n * Arquivos de um dashboard novo: o modelo vazio (`models/<nome>.ts`), o registro dele no\n * `models/index.ts` e o layout vazio (`layouts/<id>.json`). Tudo como texto, sem tocar no disco —\n * quem grava é o CLI (`bm-bi new`).\n */\n\nexport class ScaffoldError extends Error {}\n\nconst IDENTIFIER = /^[A-Za-z_$][\\w$]*$/\nconst LAYOUT_ID = /^[\\w-]+$/\n\nexport function checkModelName(name: string) {\n  if (!IDENTIFIER.test(name))\n    throw new ScaffoldError(\n      `Nome de modelo inválido: \"${name}\" (use um identificador JS, ex.: analiseCusto)`\n    )\n}\n\nexport function checkLayoutId(id: string) {\n  if (!LAYOUT_ID.test(id))\n    throw new ScaffoldError(`Id de layout inválido: \"${id}\" (só letras, números, _ e -)`)\n}\n\n/** Modelo vazio, pronto para montar pelo diagrama da aba Modelo do devtools. */\nexport function modelFileCode(name: string) {\n  checkModelName(name)\n  return toModelCode({ name, tables: {}, dimensions: {}, measures: {} }).replace(\n    'export const',\n    '/** Monte tabelas, relacionamentos, dimensões e medidas pela aba Modelo do devtools. */\\nexport const'\n  )\n}\n\n/** Layout vazio, pronto para montar pela aba Layout do devtools. */\nexport function layoutFileCode(id: string) {\n  checkLayoutId(id)\n  const layout: ChartsLayout = { id, filters: [], charts: [] }\n  return `${JSON.stringify(layout, null, 2)}\\n`\n}\n\n/** `models/index.ts` novo, com só este modelo. */\nexport function modelIndexCode(name: string) {\n  checkModelName(name)\n  return [\n    `import { ${name} } from './${name}'`,\n    '',\n    '/** Modelos expostos pelo endpoint do dashboard (`runQuery(dashboardModels, ...)`). */',\n    'export const dashboardModels = {',\n    `  ${name}`,\n    '}',\n    ''\n  ].join('\\n')\n}\n\n/**\n * Acrescenta o modelo ao `models/index.ts` existente: o import depois do último import e o nome no\n * primeiro `export const x = { ... }`. Devolve `null` se o modelo já está registrado.\n */\nexport function registerModel(source: string, name: string): string | null {\n  checkModelName(name)\n  const importPath = new RegExp(`from\\\\s+['\"]\\\\./${name}(\\\\.ts)?['\"]`)\n  if (importPath.test(source)) return null\n\n  const object = /export\\s+const\\s+\\w+(?:\\s*:[^=]+)?\\s*=\\s*\\{/.exec(source)\n  if (!object)\n    throw new ScaffoldError(\n      'Não encontrei `export const <nome> = { ... }` no models/index.ts — registre o modelo à mão.'\n    )\n  const open = object.index + object[0].length - 1\n  let depth = 0\n  let close = -1\n  for (let i = open; i < source.length; i++) {\n    if (source[i] === '{') depth++\n    else if (source[i] === '}' && --depth === 0) {\n      close = i\n      break\n    }\n  }\n  if (close === -1) throw new ScaffoldError('Objeto de modelos do models/index.ts sem `}`.')\n\n  const body = source.slice(open + 1, close)\n  const items = body.trimEnd()\n  let newBody: string\n  if (!items.trim()) newBody = `\\n  ${name}\\n`\n  else if (!body.includes('\\n')) newBody = ` ${items.trim().replace(/,$/, '')}, ${name} `\n  else newBody = `${items.endsWith(',') ? items : `${items},`}\\n  ${name}\\n`\n  let result = `${source.slice(0, open + 1)}${newBody}${source.slice(close)}`\n\n  // Import logo depois do último import do arquivo (ou no topo, se não houver)\n  const line = `import { ${name} } from './${name}'\\n`\n  const imports = [...result.matchAll(/^import[\\s\\S]*?from\\s+['\"][^'\"]+['\"];?[^\\n]*\\n/gm)]\n  const last = imports.at(-1)\n  const at = last ? last.index + last[0].length : 0\n  result = `${result.slice(0, at)}${line}${last ? '' : '\\n'}${result.slice(at)}`\n  return result\n}\n","#!/usr/bin/env node\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\nimport { dirname, join, relative } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport {\n  checkLayoutId,\n  checkModelName,\n  layoutFileCode,\n  modelFileCode,\n  modelIndexCode,\n  registerModel,\n  ScaffoldError\n} from './scaffold'\n\nconst HELP = `Uso: bm-bi new <nome> [opções]\n\nCria um dashboard vazio: o modelo (models/<nome>.ts, registrado em models/index.ts) e o layout\n(layouts/<id>.json). Depois é montar tudo pelas abas Modelo e Layout do devtools.\n\nOpções:\n  --id <id>          id do layout (padrão: o nome do modelo)\n  --dir <pasta>      pasta dos dashboards (padrão: src/dashboard)\n  --models <pasta>   pasta dos modelos (padrão: <dir>/models)\n  --layouts <pasta>  pasta dos layouts (padrão: <dir>/layouts)\n  -h, --help         esta ajuda\n`\n\nfunction main(argv: string[]) {\n  const { values, positionals } = parseArgs({\n    args: argv,\n    allowPositionals: true,\n    options: {\n      id: { type: 'string' },\n      dir: { type: 'string', default: 'src/dashboard' },\n      models: { type: 'string' },\n      layouts: { type: 'string' },\n      help: { type: 'boolean', short: 'h' }\n    }\n  })\n  const [command, name, ...rest] = positionals\n  if (values.help || !command) {\n    process.stdout.write(HELP)\n    return\n  }\n  if (command !== 'new') throw new ScaffoldError(`Comando desconhecido: ${command}\\n\\n${HELP}`)\n  if (!name) throw new ScaffoldError(`Falta o nome do modelo.\\n\\n${HELP}`)\n  if (rest.length) throw new ScaffoldError(`Argumentos a mais: ${rest.join(' ')}`)\n\n  const id = values.id ?? name\n  checkModelName(name)\n  checkLayoutId(id)\n\n  const cwd = process.cwd()\n  const modelsDir = join(cwd, values.models ?? join(values.dir, 'models'))\n  const layoutsDir = join(cwd, values.layouts ?? join(values.dir, 'layouts'))\n  const modelPath = join(modelsDir, `${name}.ts`)\n  const indexPath = join(modelsDir, 'index.ts')\n  const layoutPath = join(layoutsDir, `${id}.json`)\n\n  // Confere tudo antes de escrever: ou cria o dashboard inteiro, ou nada\n  for (const path of [modelPath, layoutPath])\n    if (existsSync(path)) throw new ScaffoldError(`Já existe: ${relative(cwd, path)}`)\n  const index = existsSync(indexPath)\n    ? registerModel(readFileSync(indexPath, 'utf8'), name)\n    : modelIndexCode(name)\n\n  const written: string[] = []\n  const write = (path: string, content: string) => {\n    mkdirSync(dirname(path), { recursive: true })\n    writeFileSync(path, content)\n    written.push(relative(cwd, path))\n  }\n  write(modelPath, modelFileCode(name))\n  if (index !== null) write(indexPath, index)\n  write(layoutPath, layoutFileCode(id))\n\n  process.stdout.write(\n    [\n      ...written.map((path) => `✓ ${path}`),\n      '',\n      'Falta a página, com o layout:',\n      `  <DashboardProvider model=\"${name}\" fetcher={fetcher}>`,\n      '    <DashboardFilters layout={layout} />',\n      '    <DashboardCharts layout={layout} />',\n      '  </DashboardProvider>',\n      ''\n    ].join('\\n')\n  )\n}\n\ntry {\n  main(process.argv.slice(2))\n} catch (error) {\n  if (!(error instanceof ScaffoldError) && !(error instanceof TypeError)) throw error\n  process.stderr.write(`${error.message}\\n`)\n  process.exitCode = 1\n}\n"],"mappings":"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"}

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ChartTypeSpec, T as ChartsLayout, U as ModelDef, W as ModelMeta, a as DashboardResult, b as ChartDef, i as DashboardQueryDebug, l as FilterValue, n as DashboardFilters$1, o as DashboardRow, r as DashboardQuery, v as CardStyle, w as ChartTypes, x as ChartNumberFormat } from "../types-FdrY0FOZ.js";
+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 { ComponentType, MouseEvent, ReactNode } from "react";
 //#region src/client/BarChart.d.ts
 type BarChartProps = {
@@ -370,7 +370,11 @@ type DataTableProps = {
    * linhas.
    */
   showTotal?: boolean;
-  /** Coluna da ordem inicial (dimensão ou medida); quem usa reordena clicando no cabeçalho. */
+  /**
+   * Coluna da ordem inicial (dimensão, medida ou `%:medida`); quem usa reordena clicando no
+   * cabeçalho. Dimensão/medida fora da tabela entra na consulta sem coluna (ex.: número do mês para
+   * ordenar o nome do mês) — uma dimensão de fora divide as linhas se tiver mais de um valor por linha.
+   */
   sortBy?: string;
   sortDirection?: SortDirection;
   /** Clicar numa linha filtra o dashboard pela primeira dimensão. */
@@ -384,10 +388,27 @@ type DataTableProps = {
   /** Casas decimais das colunas de percentual. Padrão: 1. */
   percentDecimals?: number;
   /**
-   * Ordem das colunas misturando dimensões e medidas (ex.: `['custoTotal', 'navio']`); o que não
-   * estiver nela vai depois. Padrão: dimensões e depois medidas.
+   * Ordem das colunas misturando dimensões, medidas e percentuais (ex.: `['custoTotal',
+   * '%:custoTotal', 'navio']`); o que não estiver nela vai depois. Padrão: dimensões e depois
+   * medidas, cada percentual logo depois da medida.
    */
   columnOrder?: string[];
+  /**
+   * Formatação condicional: cor do texto/fundo e negrito da célula ou da linha conforme o valor de
+   * uma dimensão/medida (da tabela, de fora dela ou `%:medida`).
+   */
+  formatRules?: FormatRule[];
+  /** Bordas entre as células (grade). Padrão: só a linha embaixo de cada linha. */
+  cellBorders?: boolean;
+  /** Cor das bordas da grade. Padrão: `#e0e0e0`. */
+  borderColor?: string;
+  /**
+   * Alinhamento horizontal por coluna (`%:medida` para o percentual): cabeçalho, células e total.
+   * Padrão: dimensão à esquerda, número à direita.
+   */
+  align?: Record<string, ColumnAlign>;
+  /** Alinhamento vertical por coluna (`top`, `middle`, `bottom`). Padrão: `middle`. */
+  verticalAlign?: Record<string, ColumnVerticalAlign>;
   /** Nome da consulta no devtools. */
   queryLabel?: string;
 };
@@ -395,7 +416,7 @@ type DataTableProps = {
  * Tabela de medidas por dimensões, com total e ordenação pelo cabeçalho. Ex.:
  * `<DataTable dimensions={['navio']} measures={['volTotal', 'custoTotal', 'custoTon']} />`.
  */
-declare function DataTable({ dimensions, measures, percentOf, formatDimensions, showTotal, sortBy, sortDirection, clickToFilter, height, labels, formats: formatsByMeasure, percentDecimals, columnOrder, queryLabel }: DataTableProps): import("react").JSX.Element;
+declare function DataTable({ dimensions, measures, percentOf, formatDimensions, showTotal, sortBy, sortDirection, clickToFilter, height, labels, formats: formatsByMeasure, percentDecimals, columnOrder, formatRules, cellBorders, borderColor, align, verticalAlign, queryLabel }: DataTableProps): import("react").JSX.Element;
 //#endregion
 //#region src/client/DonutChart.d.ts
 type DonutChartProps = {