@praxisui/charts 10.0.0-rc.0 → 10.0.0-rc.10

package/README.md

@@ -257,6 +257,26 @@ follows the host. Palette inheritance is preserved. Explicit chart surface/backg
 and text colors remain authoritative; choosing them requires a coherent contrast pair.
 Changing the host theme updates inherited colors without modifying the chart document.
 
+Existing color strings in palette arrays, metric/series colors, surface backgrounds,
+text colors and gauge bands can reference host CSS custom properties (for example,
+`var(--md-sys-color-primary, #1263b4)`). The default engine resolves them against the
+chart host on every render and projects modern CSS colors such as OKLCH into sRGB
+for Canvas. Explicit literal colors and palette overrides retain precedence. Missing
+or invalid tokens use bounded engine defaults; gauge bands retain their semantic
+tone fallback. Persisted documents and source data remain unchanged. A string
+`theme.palette` in `x-ui.chart` still names a registered Praxis palette; use an array
+for individual CSS colors.
+
+Palette array items must be non-empty strings; malformed persisted values are
+rejected by canonical validation with the item path. Direct runtime color fields
+also fall back safely when untyped JSON supplies another value type. Color probes
+isolate their measured color from host CSS rules, including rules with `!important`.
+
+The engine also derives tooltip background, foreground and border from the host's
+existing popover roles, with card/foreground and Material fallbacks. Tooltip
+formatting, triggers and disabled state keep their authored semantics; these
+computed appearance values are transient and never saved into the chart document.
+
 ## Micro Visualizations
 
 Transparent charts inside `WidgetShell` inherit the shell foreground, including fixed dark finishes in a light application theme. The chart's opaque accessible-data panel pairs its own background with the corresponding foreground. Explicit chart text colors keep precedence.
@@ -377,3 +397,10 @@ consumers must explicitly supply their own owner to adopt the same lifecycle.
 ### Cor dos nomes dos eixos
 
 O adaptador ECharts aplica a cor efetiva de texto (`theme.textColor`) tanto aos valores quanto aos nomes dos eixos cartesianos, incluindo eixo secundário, orientação horizontal e dispersão. Essa projeção não cria opções de engine no contrato público nem altera dados ou formatação. A legibilidade final ainda depende da coerência entre a cor de texto e o fundo configurado.
+
+<!-- praxis-npm-catalog-links:start -->
+## Official documentation and examples
+
+- [Canonical technical overview: Overview](https://praxisui.dev/docs/components/praxis-charts)
+- [Praxis Angular public catalog](https://praxisui.dev/angular)
+<!-- praxis-npm-catalog-links:end -->

package/ai/component-registry.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-09-10T12:25:16.581Z",
+  "generatedAt": "2026-10-13T14:47:21.726Z",
   "packageName": "@praxisui/charts",
-  "packageVersion": "10.0.0-rc.0",
+  "packageVersion": "10.0.0-rc.10",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
-  "componentCount": 3,
+  "componentCount": 4,
   "components": {
     "praxis-analytics-presentation": {
       "id": "praxis-analytics-presentation",
@@ -424,6 +424,13 @@
             }
           }
         },
+        {
+          "name": "resourceKey",
+          "type": "string | null",
+          "required": false,
+          "description": "Canonical resource identifier used to automatically discover and execute /stats services on the Praxis backend.",
+          "default": null
+        },
         {
           "name": "data",
           "type": "PraxisChartDataRow[]",
@@ -687,6 +694,22 @@
             "group": "config"
           }
         },
+        {
+          "id": "resourceKey",
+          "label": "Resource Key",
+          "direction": "input",
+          "semanticKind": "value",
+          "description": "Canonical resource identifier used to automatically discover and execute /stats services on the Praxis backend.",
+          "schema": {
+            "id": "string",
+            "kind": "ts-type",
+            "ref": "string"
+          },
+          "exposure": {
+            "public": true,
+            "group": "data"
+          }
+        },
         {
           "id": "pointClick",
           "label": "Point Click",
@@ -3547,9 +3570,9 @@
         {
           "chunkIndex": 0,
           "chunkKind": "summary",
-          "content": "Component ID: praxis-chart\nSelector: praxis-chart\nFriendly Name: Praxis Chart\nDescription: Chart component for analytics and metadata-driven visualizations in Praxis UI.\nLib/Package: @praxisui/charts\nTags: chart, analytics, widget, visualization\nInputs:\n  - config (PraxisChartConfig)\n  - data (PraxisChartDataRow[])\n  - chartDocument (PraxisXUiChartContract | null)\n  - queryContext (PraxisDataQueryContext | null)\n  - remoteDataResolver (PraxisChartRemoteDataResolver | null)\n  - filterCriteria (Record<string, unknown> | null)\n  - enableCustomization (boolean)\n  - availableResources (ReadonlyArray<ChartEditorResourceOption>)\n  - availableFields (ReadonlyArray<ChartEditorFieldOption>)\n  - availableTargets (ReadonlyArray<ChartEditorTargetOption>)\nOutputs:\n  - pointClick (PraxisChartPointEvent)\n  - pointAction (PraxisChartPointActionEvent)\n  - selectionChange (PraxisChartSelectionEvent)\n  - drillDown (PraxisChartDrillDownEvent)\n  - crossFilter (PraxisChartCrossFilterEvent)\n  - queryRequest (PraxisChartQueryRequestEvent)\n  - loadStateChange (PraxisChartLoadState)\n  - chartDocumentApplied (PraxisXUiChartContract)\n  - chartDocumentSaved (PraxisXUiChartContract)\n  - chartDocumentPatchChange (PraxisChartDocumentPatchChangeEvent)\nInsertion Presets:\n  - canonical-chart: Canonical chart - Creates a chart widget from the canonical x-ui.chart authoring document.\n",
+          "content": "Component ID: praxis-chart\nSelector: praxis-chart\nFriendly Name: Praxis Chart\nDescription: Chart component for analytics and metadata-driven visualizations in Praxis UI.\nLib/Package: @praxisui/charts\nTags: chart, analytics, widget, visualization\nInputs:\n  - config (PraxisChartConfig)\n  - resourceKey (string | null)\n  - data (PraxisChartDataRow[])\n  - chartDocument (PraxisXUiChartContract | null)\n  - queryContext (PraxisDataQueryContext | null)\n  - remoteDataResolver (PraxisChartRemoteDataResolver | null)\n  - filterCriteria (Record<string, unknown> | null)\n  - enableCustomization (boolean)\n  - availableResources (ReadonlyArray<ChartEditorResourceOption>)\n  - availableFields (ReadonlyArray<ChartEditorFieldOption>)\n  - availableTargets (ReadonlyArray<ChartEditorTargetOption>)\nOutputs:\n  - pointClick (PraxisChartPointEvent)\n  - pointAction (PraxisChartPointActionEvent)\n  - selectionChange (PraxisChartSelectionEvent)\n  - drillDown (PraxisChartDrillDownEvent)\n  - crossFilter (PraxisChartCrossFilterEvent)\n  - queryRequest (PraxisChartQueryRequestEvent)\n  - loadStateChange (PraxisChartLoadState)\n  - chartDocumentApplied (PraxisXUiChartContract)\n  - chartDocumentSaved (PraxisXUiChartContract)\n  - chartDocumentPatchChange (PraxisChartDocumentPatchChangeEvent)\nInsertion Presets:\n  - canonical-chart: Canonical chart - Creates a chart widget from the canonical x-ui.chart authoring document.\n",
           "sourcePointer": "projects/praxis-charts/src/lib/praxis-chart.metadata.ts",
-          "contentHash": "2ca641ce6260ffda9f9278a77c49b6538d96b1bf61640cf269ba510b521af788",
+          "contentHash": "e1c99961aba854e05112df6c72c6dd3d90a1d9ef8bc3b8d03c5f956f624835cc",
           "sourceKind": "component_definition",
           "sourceId": "praxis-chart",
           "corpusVersion": "1.0.0"
@@ -3839,6 +3862,181 @@
           "corpusVersion": "1.0.0"
         }
       ]
+    },
+    "praxis-micro-visualization": {
+      "id": "praxis-micro-visualization",
+      "description": "Renderiza micro-visualizações ultraleves e autônomas (bullet, radial, sparkline, processFlow, comparison, etc.) como widget independente no canvas ou célula.",
+      "inputs": [
+        {
+          "name": "visualization",
+          "type": "PraxisPresentationVisualizationConfig",
+          "required": false,
+          "description": "Configuração estruturada da micro-visualização (kind, value, target, points, thresholds, tone, etc.).",
+          "default": {
+            "kind": "radial",
+            "value": 75,
+            "total": 100,
+            "tone": "primary",
+            "fallbackText": "75%"
+          }
+        },
+        {
+          "name": "fallbackText",
+          "type": "string",
+          "required": false,
+          "description": "Texto exibido caso a visualização não seja suportada ou esteja em fallback.",
+          "default": ""
+        }
+      ],
+      "outputs": [],
+      "configSchemaId": null,
+      "selector": "praxis-micro-visualization",
+      "friendlyName": "Micro-visualização Analítica",
+      "icon": "ssid_chart",
+      "tags": [
+        "chart",
+        "analytics",
+        "widget",
+        "microchart",
+        "visualization",
+        "sparkline",
+        "bullet",
+        "radial"
+      ],
+      "lib": "@praxisui/charts",
+      "insertionPresets": [
+        {
+          "id": "bullet-kpi",
+          "label": "Bullet Graph KPI",
+          "description": "Microchart do tipo bullet com faixas de tolerância e valor meta.",
+          "icon": "linear_scale",
+          "inputs": {
+            "visualization": {
+              "kind": "bullet",
+              "value": 78,
+              "target": 90,
+              "total": 100,
+              "tone": "success",
+              "fallbackText": "Performance Operacional",
+              "thresholds": [
+                {
+                  "value": 50,
+                  "tone": "danger",
+                  "label": "Crítico"
+                },
+                {
+                  "value": 75,
+                  "tone": "warning",
+                  "label": "Atenção"
+                },
+                {
+                  "value": 100,
+                  "tone": "success",
+                  "label": "Ideal"
+                }
+              ]
+            }
+          }
+        },
+        {
+          "id": "radial-score",
+          "label": "Radial Score",
+          "description": "Medidor circular compacto de pontuação ou progresso percentual.",
+          "icon": "radio_button_checked",
+          "inputs": {
+            "visualization": {
+              "kind": "radial",
+              "value": 85,
+              "total": 100,
+              "tone": "primary",
+              "fallbackText": "Prontidão: 85%"
+            }
+          }
+        },
+        {
+          "id": "sparkline-area",
+          "label": "Sparkline de Tendência (Área)",
+          "description": "Minigráfico contínuo de área para visualização de tendência temporal.",
+          "icon": "show_chart",
+          "inputs": {
+            "visualization": {
+              "kind": "area",
+              "tone": "info",
+              "points": [
+                {
+                  "value": 12,
+                  "label": "Jan"
+                },
+                {
+                  "value": 19,
+                  "label": "Fev"
+                },
+                {
+                  "value": 15,
+                  "label": "Mar"
+                },
+                {
+                  "value": 27,
+                  "label": "Abr"
+                },
+                {
+                  "value": 34,
+                  "label": "Mai"
+                }
+              ],
+              "fallbackText": "Tendência Trimestral"
+            }
+          }
+        },
+        {
+          "id": "process-flow",
+          "label": "Fluxo de Etapas (Process Flow)",
+          "description": "Indicador visual compacto de etapas sequenciais ou esteira de estados.",
+          "icon": "route",
+          "inputs": {
+            "visualization": {
+              "kind": "processFlow",
+              "points": [
+                {
+                  "label": "Triagem",
+                  "icon": "check",
+                  "tone": "success"
+                },
+                {
+                  "label": "Análise",
+                  "icon": "sync",
+                  "tone": "info"
+                },
+                {
+                  "label": "Aprovação",
+                  "icon": "schedule",
+                  "tone": "warning"
+                },
+                {
+                  "label": "Conclusão",
+                  "icon": "flag",
+                  "tone": "neutral"
+                }
+              ],
+              "fallbackText": "Etapa 2/4: Em Análise"
+            }
+          }
+        }
+      ],
+      "source": "projects/praxis-charts/src/lib/praxis-micro-visualization.metadata.ts",
+      "exportName": "PRAXIS_MICRO_VISUALIZATION_COMPONENT_METADATA",
+      "chunks": [
+        {
+          "chunkIndex": 0,
+          "chunkKind": "summary",
+          "content": "Component ID: praxis-micro-visualization\nSelector: praxis-micro-visualization\nFriendly Name: Micro-visualização Analítica\nDescription: Renderiza micro-visualizações ultraleves e autônomas (bullet, radial, sparkline, processFlow, comparison, etc.) como widget independente no canvas ou célula.\nLib/Package: @praxisui/charts\nTags: chart, analytics, widget, microchart, visualization, sparkline, bullet, radial\nInputs:\n  - visualization (PraxisPresentationVisualizationConfig)\n  - fallbackText (string)\nInsertion Presets:\n  - bullet-kpi: Bullet Graph KPI - Microchart do tipo bullet com faixas de tolerância e valor meta.\n  - radial-score: Radial Score - Medidor circular compacto de pontuação ou progresso percentual.\n  - sparkline-area: Sparkline de Tendência (Área) - Minigráfico contínuo de área para visualização de tendência temporal.\n  - process-flow: Fluxo de Etapas (Process Flow) - Indicador visual compacto de etapas sequenciais ou esteira de estados.\n",
+          "sourcePointer": "projects/praxis-charts/src/lib/praxis-micro-visualization.metadata.ts",
+          "contentHash": "455a9d78d9176e7b267f6cb9f0a511dffd981c889b810b09ea1b45952512d060",
+          "sourceKind": "component_definition",
+          "sourceId": "praxis-micro-visualization",
+          "corpusVersion": "1.0.0"
+        }
+      ]
     }
   },
   "note": "Package-scoped Praxis component registry for source-free agent discovery. Use the canonical ingestion registry for cross-package aggregate analysis."