@bluemarble/bi 0.3.1 → 0.5.0

package/dist/{types-DUJS2Zmx.d.ts → types-FdrY0FOZ.d.ts}

@@ -86,13 +86,17 @@ type ModelDef = {
   dimensions: Record<string, DimensionDef>;
   measures: Record<string, MeasureDef>;
   /**
-   * Posição de cada card no diagrama do devtools (tabela -> canto superior esquerdo). Só visual: não muda nenhuma consulta. Card sem posição entra no layout automático.
+   * Posição de cada card no diagrama do devtools (tabela -> canto superior esquerdo) e, se foi
+   * redimensionado, o tamanho. Só visual: não muda nenhuma consulta. Card sem posição entra no
+   * layout automático; sem tamanho, tem a largura padrão e a altura do conteúdo.
    */
   diagram?: Record<string, DiagramPosition>;
 };
 type DiagramPosition = {
   x: number;
   y: number;
+  width?: number;
+  height?: number;
 };
 /** Só os metadados (sem SQL): é o que o client recebe fora do devtools. */
 type ModelMeta = {
@@ -128,15 +132,34 @@ type BaseChartDef = {
   /** Aparência do card deste gráfico (sobrepõe o `cards` do layout). */
   card?: CardStyle;
 };
-type ComboChartDef = BaseChartDef & {
+/**
+ * Formato de uma medida num gráfico: sobrepõe o `format`/`decimals` do dicionário do modelo só
+ * naquele gráfico.
+ */
+type ChartNumberFormat = {
+  format?: ValueFormat;
+  /** Casas decimais (0 a 10). */
+  decimals?: number;
+  /** Notação curta: 1,2 mil / 3,4 mi. */
+  compact?: boolean;
+  /** Texto antes do número (ex.: "US$ "). */
+  prefix?: string;
+  /** Texto depois do número (ex.: " t"). */
+  suffix?: string;
+};
+/** Rótulos e formatos do gráfico, por nome de dimensão/medida (sobrepõem o dicionário). */
+type ColumnsDisplay = {
+  /** `{ dimensãoOuMedida: 'Rótulo' }`: legenda, tooltip e cabeçalho. */
+  labels?: Record<string, string>;
+  /** `{ medida: { decimals: 1, ... } }`. */
+  formats?: Record<string, ChartNumberFormat>;
+};
+type ComboChartDef = BaseChartDef & ColumnsDisplay & {
   type: 'combo';
   dimension: string;
   bar: string;
   line: string;
   detail?: string;
-  barLabel?: string;
-  lineLabel?: string;
-  detailLabel?: string;
   /** Nome de um formatter passado ao `<DashboardCharts formatters>` (funções não cabem no JSON). */
   formatDimension?: string;
   clickToFilter?: boolean;
@@ -145,7 +168,7 @@ type ComboChartDef = BaseChartDef & {
   barColor?: string;
   lineColor?: string;
 };
-type BarChartDef = BaseChartDef & {
+type BarChartDef = BaseChartDef & ColumnsDisplay & {
   type: 'bar';
   dimension: string;
   /** Uma série por medida. */
@@ -161,16 +184,18 @@ type BarChartDef = BaseChartDef & {
   hideEmpty?: boolean;
   showValues?: boolean;
 };
-type DonutChartDef = BaseChartDef & {
+type DonutChartDef = BaseChartDef & ColumnsDisplay & {
   type: 'donut';
   dimension: string;
   measure: string;
   /** Fatias além dessa quantidade viram "Outros". */
   maxSlices?: number;
+  /** Casas decimais do percentual. Padrão: 1. */
+  percentDecimals?: number;
   formatDimension?: string;
   clickToFilter?: boolean;
 };
-type TableChartDef = BaseChartDef & {
+type TableChartDef = BaseChartDef & ColumnsDisplay & {
   type: 'table';
   dimensions?: string[];
   measures: string[];
@@ -179,6 +204,13 @@ type TableChartDef = BaseChartDef & {
    * está em `measures` é consultada só para o percentual.
    */
   percentOf?: string[];
+  /** Casas decimais das colunas de percentual. Padrão: 1. */
+  percentDecimals?: number;
+  /**
+   * Ordem das colunas misturando dimensões e medidas (ex.: uma medida antes de uma dimensão).
+   * Ausente = dimensões e depois medidas.
+   */
+  columnOrder?: string[];
   /** Formatter por dimensão (`{ mes: 'nomeMes' }`). */
   formatDimensions?: Record<string, string>;
   /** Linha de total, consultada sem as dimensões (razões saem certas, não somadas). */
@@ -188,13 +220,12 @@ type TableChartDef = BaseChartDef & {
   sortDirection?: 'asc' | 'desc';
   clickToFilter?: boolean;
 };
-type KpiChartDef = Omit<BaseChartDef, 'height'> & {
+type KpiChartDef = Omit<BaseChartDef, 'height'> & ColumnsDisplay & {
   type: 'kpi';
   /** Medida do número grande (total com os filtros da página). */
   measure: string;
   /** Medida extra numa linha menor embaixo (ex.: volume, custo/t). */
   secondary?: string;
-  secondaryLabel?: string;
 };
 /** Gráficos da lib (`type` em `CHART_TYPES`). */
 type BuiltinChartDef = KpiChartDef | ComboChartDef | BarChartDef | DonutChartDef | TableChartDef;
@@ -261,7 +292,7 @@ type FieldSpec = {
   label: string;
   hint?: string;
   /** Agrupamento no formulário do devtools. */
-  section: 'Gráfico' | 'Dados' | 'Aparência' | 'Filtro' | 'Tela' | 'Card';
+  section: 'Gráfico' | 'Dados' | 'Aparência' | 'Rótulos e formatos' | 'Filtro' | 'Tela' | 'Card';
   required?: boolean;
   /** Valor que o componente usa quando o campo não está no JSON. */
   default?: unknown;
@@ -297,6 +328,21 @@ type FieldSpec = {
 /** Uma das dimensões/medidas escolhidas no próprio gráfico. */
 {
   kind: 'column';
+} |
+/** `{ dimensãoOuMedida: rótulo }` das colunas do gráfico. */
+{
+  kind: 'labels';
+} |
+/** `{ medida: ChartNumberFormat }` das medidas do gráfico. */
+{
+  kind: 'formats';
+} |
+/**
+ * Ordem das colunas (dimensões e medidas misturadas). O devtools junta os campos `dimensions` e
+ * `measures` da mesma seção numa lista só e grava a ordem aqui quando não é a padrão.
+ */
+{
+  kind: 'columnOrder';
 });
 /**
  * Tipo de gráfico: nome no devtools e campos do JSON. Para um tipo do app, `title`, `span` e
@@ -485,5 +531,5 @@ type DashboardResult = {
   };
 };
 //#endregion
-export { KpiChartDef as A, MeasureDef as B, ChartTypes as C, DonutChartDef as D, CustomChartDef as E, AggregateMeasure as F, RelationshipDef as G, ModelDef as H, Aggregation as I, ValueFormat as J, SumMeasure as K, DimensionDef as L, layoutModelWarnings as M, resolveChartTypes as N, FieldSpec as O, validateLayout as P, FieldMeta as R, ChartTypeSpec as S, ComboChartDef as T, ModelMeta as U, MeasureMeta as V, RatioMeasure as W, validateModel as X, modelMeta as Y, CanvasDef as _, DashboardResult as a, ChartDef as b, DevtoolsCapabilities as c, ModelValidation as d, ProfileStep as f, BuiltinChartDef as g, BarChartDef as h, DashboardQueryDebug as i, TableChartDef as j, FilterDef as k, FilterValue as l, SchemaTable as m, DashboardFilters as n, DashboardRow as o, SaveModelResult as p, TableDef as q, DashboardQuery as r, DashboardSnapshot as s, DashboardDevtoolsRequest as t, ModelColumns as u, CardStyle as v, ChartsLayout as w, ChartType as x, CardsStyle as y, FormulaMeasure as z };
-//# sourceMappingURL=types-DUJS2Zmx.d.ts.map
+export { FilterDef as A, FormulaMeasure as B, ChartTypeSpec as C, CustomChartDef as D, ComboChartDef as E, validateLayout as F, RatioMeasure as G, MeasureMeta as H, AggregateMeasure as I, TableDef as J, RelationshipDef as K, Aggregation as L, TableChartDef as M, layoutModelWarnings as N, DonutChartDef as O, resolveChartTypes as P, DimensionDef as R, ChartType as S, ChartsLayout as T, ModelDef as U, MeasureDef as V, ModelMeta as W, modelMeta as X, ValueFormat as Y, validateModel as Z, CanvasDef as _, DashboardResult as a, ChartDef as b, DevtoolsCapabilities as c, ModelValidation as d, ProfileStep as f, BuiltinChartDef as g, BarChartDef as h, DashboardQueryDebug as i, KpiChartDef as j, FieldSpec as k, FilterValue as l, SchemaTable as m, DashboardFilters as n, DashboardRow as o, SaveModelResult as p, SumMeasure as q, DashboardQuery as r, DashboardSnapshot as s, DashboardDevtoolsRequest as t, ModelColumns as u, CardStyle as v, ChartTypes as w, ChartNumberFormat as x, CardsStyle as y, FieldMeta as z };
+//# sourceMappingURL=types-FdrY0FOZ.d.ts.map

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-import { A as KpiChartDef, B as MeasureDef, C as ChartTypes, D as DonutChartDef, E as CustomChartDef, G as RelationshipDef, H as ModelDef, J as ValueFormat, L as DimensionDef, O as FieldSpec, R as FieldMeta, S as ChartTypeSpec, T as ComboChartDef, U as ModelMeta, V as MeasureMeta, _ as CanvasDef, a as DashboardResult, b as ChartDef, c as DevtoolsCapabilities, d as ModelValidation, f as ProfileStep, g as BuiltinChartDef, h as BarChartDef, i as DashboardQueryDebug, j as TableChartDef, k as FilterDef, l as FilterValue, m as SchemaTable, n as DashboardFilters, o as DashboardRow, p as SaveModelResult, q as TableDef, r as DashboardQuery, s as DashboardSnapshot, t as DashboardDevtoolsRequest, u as ModelColumns, v as CardStyle, w as ChartsLayout, x as ChartType, y as CardsStyle, z as FormulaMeasure } from "./types-DUJS2Zmx.js";
-export { type BarChartDef, type BuiltinChartDef, type CanvasDef, type CardStyle, type CardsStyle, type ChartDef, type ChartType, type ChartTypeSpec, type ChartTypes, type ChartsLayout, type ComboChartDef, type CustomChartDef, DashboardDevtoolsRequest, DashboardFilters, DashboardQuery, DashboardQueryDebug, DashboardResult, DashboardRow, DashboardSnapshot, DevtoolsCapabilities, type DimensionDef, type DonutChartDef, type FieldMeta, type FieldSpec, type FilterDef, FilterValue, type FormulaMeasure, type KpiChartDef, type MeasureDef, type MeasureMeta, ModelColumns, type ModelDef, type ModelMeta, ModelValidation, ProfileStep, type RelationshipDef, SaveModelResult, SchemaTable, type TableChartDef, type TableDef, type ValueFormat };
+import { A as FilterDef, B as FormulaMeasure, C as ChartTypeSpec, D as CustomChartDef, E as ComboChartDef, H as MeasureMeta, J as TableDef, K as RelationshipDef, M as TableChartDef, O as DonutChartDef, R as DimensionDef, S as ChartType, T as ChartsLayout, U as ModelDef, V as MeasureDef, W as ModelMeta, Y as ValueFormat, _ as CanvasDef, a as DashboardResult, b as ChartDef, c as DevtoolsCapabilities, d as ModelValidation, f as ProfileStep, g as BuiltinChartDef, h as BarChartDef, i as DashboardQueryDebug, j as KpiChartDef, k as FieldSpec, l as FilterValue, m as SchemaTable, n as DashboardFilters, o as DashboardRow, p as SaveModelResult, r as DashboardQuery, s as DashboardSnapshot, t as DashboardDevtoolsRequest, u as ModelColumns, v as CardStyle, w as ChartTypes, x as ChartNumberFormat, y as CardsStyle, z as FieldMeta } from "./types-FdrY0FOZ.js";
+export { type BarChartDef, type BuiltinChartDef, type CanvasDef, type CardStyle, type CardsStyle, type ChartDef, type ChartNumberFormat, type ChartType, type ChartTypeSpec, type ChartTypes, type ChartsLayout, type ComboChartDef, type CustomChartDef, DashboardDevtoolsRequest, DashboardFilters, DashboardQuery, DashboardQueryDebug, DashboardResult, DashboardRow, DashboardSnapshot, DevtoolsCapabilities, type DimensionDef, type DonutChartDef, type FieldMeta, type FieldSpec, type FilterDef, FilterValue, type FormulaMeasure, type KpiChartDef, type MeasureDef, type MeasureMeta, ModelColumns, type ModelDef, type ModelMeta, ModelValidation, ProfileStep, type RelationshipDef, SaveModelResult, SchemaTable, type TableChartDef, type TableDef, type ValueFormat };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluemarble/bi",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "Camada semântica (defineModel) + componentes de dashboard e devtools para substituir o Power BI",
   "license": "MIT",
   "author": "bluemarble",