reflex-silverpoint-react 0.3.0__tar.gz → 0.6.0__tar.gz

{reflex_silverpoint_react-0.3.0 → reflex_silverpoint_react-0.6.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: reflex-silverpoint-react
-Version: 0.3.0
-Summary: The 33 silverpoint charts, the linked Dashboard and the 17 UI components (Renaissance silverpoint drawing style) for Reflex, wrapping @silverpoint/react
+Version: 0.6.0
+Summary: The 60 silverpoint charts, the linked Dashboard and the 17 UI components (Renaissance silverpoint drawing style) for Reflex, wrapping @silverpoint/react
 Author-email: Ernesto Crespo <ecrespo@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/ecrespo/reflex-silverpoint-react
@@ -33,12 +33,26 @@ prepared ground, tone built from hatching, and white heightening on the live val
 The hand-drawn irregularity lives only in the ornament. The data geometry is exact, and every chart
 has a `precision` mode that turns the inking off.
 
-It wraps [`@silverpoint/react`](https://www.npmjs.com/package/@silverpoint/react) 0.3.0 and exposes
-**all 33 charts**, the **`Dashboard`** (a laid-out, linkable grid of charts), the **17 UI
+It wraps [`@silverpoint/react`](https://www.npmjs.com/package/@silverpoint/react) 0.6.0 and exposes
+**all 60 charts**, the **`Dashboard`** (a laid-out, linkable grid of charts), the **17 UI
 components** (buttons, inputs, tabs, cards, alerts…), the `SilverpointProvider`, both grounds
 (`silverpoint` and `cyanotype`), the interaction events, custom readouts and the imperative handle
 (SVG export and geometry) as Python.
 
+### New in 0.6
+
+- **27 new charts**, the second catalog of silverpoint 0.6:
+  - distributions & comparisons: `histogram_chart`, `ecdf_chart`, `box_plot_chart`, `violin_chart`,
+    `ridgeline_chart`, `beeswarm_chart`, `lollipop_chart`, `dumbbell_chart`, `slope_chart`,
+    `bump_chart`, `error_bar_chart`, `interval_chart`, `diverging_bar_chart`, `connected_scatter_chart`;
+  - hierarchies & dimensions: `waffle_chart`, `marimekko_chart`, `squarified_treemap`,
+    `sunburst_chart`, `tree_chart`, `parallel_coordinates_chart`, `polar_line_chart`,
+    `polar_scatter_chart`;
+  - fields & networks: `density_bin_chart`, `contour_chart`, `delaunay_chart`, `vector_field_chart`,
+    `network_chart` (with the `network_node` helper).
+- **Drill-down** on `squarified_treemap` and `sunburst_chart`: `root_id` plus the `on_root_change`
+  event. See [Drill-down](#drill-down).
+
 ### New in 0.3
 
 - **17 UI components**, drawn as the charts are: `sp_button`, `sp_input`, `sp_checkbox`,
@@ -109,7 +123,7 @@ Props are the React props in `snake_case`: `xKey` → `x_key`, `hatchFill` → `
 `footerRight` → `footer_right`, `centerLabel` → `center_label`, and so on. `data` and every prop can
 be a Reflex state var.
 
-## The 33 charts
+## The 60 charts
 
 | Family | Charts |
 |---|---|
@@ -119,11 +133,60 @@ be a Reflex state var.
 | Points & grids | `scatter_chart`, `bubble_chart`, `heatmap_chart`, `treemap_chart`, `activity_grid` |
 | Flows | `sankey_chart`, `chord_ring` |
 | Radial | `donut_chart`, `radar_chart`, `polar_bar_chart`, `radial_arc_group`, `radial_rings`, `gauge_arc`, `meter_chart`, `coxcomb_chart`, `wind_rose`, `volvelle_chart`, `orbit_chart` |
+| Distributions & comparisons (0.6) | `histogram_chart`, `ecdf_chart`, `box_plot_chart`, `violin_chart`, `ridgeline_chart`, `beeswarm_chart`, `lollipop_chart`, `dumbbell_chart`, `slope_chart`, `bump_chart`, `error_bar_chart`, `interval_chart`, `diverging_bar_chart`, `connected_scatter_chart` |
+| Hierarchies & dimensions (0.6) | `waffle_chart`, `marimekko_chart`, `squarified_treemap`, `sunburst_chart`, `tree_chart`, `parallel_coordinates_chart`, `polar_line_chart`, `polar_scatter_chart` |
+| Fields & networks (0.6) | `density_bin_chart`, `contour_chart`, `delaunay_chart`, `vector_field_chart`, `network_chart` |
 
 Every factory has a class of the same name in `PascalCase` (`LineChart`, `WindRose`…).
 `reflex_silverpoint_react.CHARTS` is the whole catalog with each chart's family and the reference of
 its own props (`COMMON_PROPS` holds the shared ones), handy for galleries and documentation.
 
+With your own `data`, `ridgeline_chart` needs `group_key`, `diverging_bar_chart` needs `levels` (the
+level columns, most negative first) and `parallel_coordinates_chart` needs `dimensions` (the columns,
+in axis order). The demo datasets ignore them.
+
+`network_chart` lays its nodes out by force, the same on the server and in every browser for a given
+`seed`. Pass `nodes` to name and group them, built with `network_node`. A node with an `x` and a `y`
+is drawn there, and when every node has both no layout runs:
+
+```python
+from reflex_silverpoint_react import network_chart, network_node
+
+network_chart(
+    data=State.links,  # [{"source": "a", "target": "b", "weight": 3}, ...]
+    source_key="source",
+    target_key="target",
+    value_key="weight",
+    nodes=[network_node("a", label="Archive", group="storage"), network_node("b", label="Billing")],
+)
+```
+
+### Drill-down
+
+`squarified_treemap` and `sunburst_chart` drill down under your control. The chart keeps no root of
+its own: a click, Enter or Space on a node sends its id to `on_root_change` (the parent's id from the
+centre or the frame, `None` at the top), and you pass it back as `root_id`:
+
+```python
+class Budget(rx.State):
+    root: str | None = None
+
+    @rx.event
+    def drill(self, node_id: str | None):
+        self.root = node_id
+
+
+squarified_treemap(
+    data=rows,  # one row per node: {"id": ..., "parent": ... or None, "name": ..., "amount": ...}
+    id_key="id",
+    parent_key="parent",
+    label_key="name",
+    value_key="amount",
+    root_id=Budget.root,
+    on_root_change=Budget.drill,
+)
+```
+
 ## Props every chart shares
 
 | Prop | Default | |
@@ -353,10 +416,10 @@ cd silverpoint_react_demo
 uv run reflex run
 ```
 
-Pages: **Start** (quickstart, provider, ink vs precision), **Gallery** (the 33 charts, ground
+Pages: **Start** (quickstart, provider, ink vs precision), **Gallery** (the 60 charts, ground
 controls, demo datasets vs data from Python state with a re-roll), **Playground** (one chart, every
 rendering choice and the Python that reproduces it), **Interaction** (events, custom readout, a
-volvelle that turns on click, live KPI/gauge/meter, SVG and geometry export), **Dashboard** (a
+volvelle that turns on click, a treemap and a sunburst that drill down together, live KPI/gauge/meter, SVG and geometry export), **Dashboard** (a
 linked operations dashboard fed from Python state with ground, substrate, mode and column controls, a
 KPI strip, and `dashboard_link` on its own), **UI components** (`/ui`: the components controlled from
 Python state with a native form submit, and the three reference panels of the upstream example apps

{reflex_silverpoint_react-0.3.0 → reflex_silverpoint_react-0.6.0}/README.md

@@ -7,12 +7,26 @@ prepared ground, tone built from hatching, and white heightening on the live val
 The hand-drawn irregularity lives only in the ornament. The data geometry is exact, and every chart
 has a `precision` mode that turns the inking off.
 
-It wraps [`@silverpoint/react`](https://www.npmjs.com/package/@silverpoint/react) 0.3.0 and exposes
-**all 33 charts**, the **`Dashboard`** (a laid-out, linkable grid of charts), the **17 UI
+It wraps [`@silverpoint/react`](https://www.npmjs.com/package/@silverpoint/react) 0.6.0 and exposes
+**all 60 charts**, the **`Dashboard`** (a laid-out, linkable grid of charts), the **17 UI
 components** (buttons, inputs, tabs, cards, alerts…), the `SilverpointProvider`, both grounds
 (`silverpoint` and `cyanotype`), the interaction events, custom readouts and the imperative handle
 (SVG export and geometry) as Python.
 
+### New in 0.6
+
+- **27 new charts**, the second catalog of silverpoint 0.6:
+  - distributions & comparisons: `histogram_chart`, `ecdf_chart`, `box_plot_chart`, `violin_chart`,
+    `ridgeline_chart`, `beeswarm_chart`, `lollipop_chart`, `dumbbell_chart`, `slope_chart`,
+    `bump_chart`, `error_bar_chart`, `interval_chart`, `diverging_bar_chart`, `connected_scatter_chart`;
+  - hierarchies & dimensions: `waffle_chart`, `marimekko_chart`, `squarified_treemap`,
+    `sunburst_chart`, `tree_chart`, `parallel_coordinates_chart`, `polar_line_chart`,
+    `polar_scatter_chart`;
+  - fields & networks: `density_bin_chart`, `contour_chart`, `delaunay_chart`, `vector_field_chart`,
+    `network_chart` (with the `network_node` helper).
+- **Drill-down** on `squarified_treemap` and `sunburst_chart`: `root_id` plus the `on_root_change`
+  event. See [Drill-down](#drill-down).
+
 ### New in 0.3
 
 - **17 UI components**, drawn as the charts are: `sp_button`, `sp_input`, `sp_checkbox`,
@@ -83,7 +97,7 @@ Props are the React props in `snake_case`: `xKey` → `x_key`, `hatchFill` → `
 `footerRight` → `footer_right`, `centerLabel` → `center_label`, and so on. `data` and every prop can
 be a Reflex state var.
 
-## The 33 charts
+## The 60 charts
 
 | Family | Charts |
 |---|---|
@@ -93,11 +107,60 @@ be a Reflex state var.
 | Points & grids | `scatter_chart`, `bubble_chart`, `heatmap_chart`, `treemap_chart`, `activity_grid` |
 | Flows | `sankey_chart`, `chord_ring` |
 | Radial | `donut_chart`, `radar_chart`, `polar_bar_chart`, `radial_arc_group`, `radial_rings`, `gauge_arc`, `meter_chart`, `coxcomb_chart`, `wind_rose`, `volvelle_chart`, `orbit_chart` |
+| Distributions & comparisons (0.6) | `histogram_chart`, `ecdf_chart`, `box_plot_chart`, `violin_chart`, `ridgeline_chart`, `beeswarm_chart`, `lollipop_chart`, `dumbbell_chart`, `slope_chart`, `bump_chart`, `error_bar_chart`, `interval_chart`, `diverging_bar_chart`, `connected_scatter_chart` |
+| Hierarchies & dimensions (0.6) | `waffle_chart`, `marimekko_chart`, `squarified_treemap`, `sunburst_chart`, `tree_chart`, `parallel_coordinates_chart`, `polar_line_chart`, `polar_scatter_chart` |
+| Fields & networks (0.6) | `density_bin_chart`, `contour_chart`, `delaunay_chart`, `vector_field_chart`, `network_chart` |
 
 Every factory has a class of the same name in `PascalCase` (`LineChart`, `WindRose`…).
 `reflex_silverpoint_react.CHARTS` is the whole catalog with each chart's family and the reference of
 its own props (`COMMON_PROPS` holds the shared ones), handy for galleries and documentation.
 
+With your own `data`, `ridgeline_chart` needs `group_key`, `diverging_bar_chart` needs `levels` (the
+level columns, most negative first) and `parallel_coordinates_chart` needs `dimensions` (the columns,
+in axis order). The demo datasets ignore them.
+
+`network_chart` lays its nodes out by force, the same on the server and in every browser for a given
+`seed`. Pass `nodes` to name and group them, built with `network_node`. A node with an `x` and a `y`
+is drawn there, and when every node has both no layout runs:
+
+```python
+from reflex_silverpoint_react import network_chart, network_node
+
+network_chart(
+    data=State.links,  # [{"source": "a", "target": "b", "weight": 3}, ...]
+    source_key="source",
+    target_key="target",
+    value_key="weight",
+    nodes=[network_node("a", label="Archive", group="storage"), network_node("b", label="Billing")],
+)
+```
+
+### Drill-down
+
+`squarified_treemap` and `sunburst_chart` drill down under your control. The chart keeps no root of
+its own: a click, Enter or Space on a node sends its id to `on_root_change` (the parent's id from the
+centre or the frame, `None` at the top), and you pass it back as `root_id`:
+
+```python
+class Budget(rx.State):
+    root: str | None = None
+
+    @rx.event
+    def drill(self, node_id: str | None):
+        self.root = node_id
+
+
+squarified_treemap(
+    data=rows,  # one row per node: {"id": ..., "parent": ... or None, "name": ..., "amount": ...}
+    id_key="id",
+    parent_key="parent",
+    label_key="name",
+    value_key="amount",
+    root_id=Budget.root,
+    on_root_change=Budget.drill,
+)
+```
+
 ## Props every chart shares
 
 | Prop | Default | |
@@ -327,10 +390,10 @@ cd silverpoint_react_demo
 uv run reflex run
 ```
 
-Pages: **Start** (quickstart, provider, ink vs precision), **Gallery** (the 33 charts, ground
+Pages: **Start** (quickstart, provider, ink vs precision), **Gallery** (the 60 charts, ground
 controls, demo datasets vs data from Python state with a re-roll), **Playground** (one chart, every
 rendering choice and the Python that reproduces it), **Interaction** (events, custom readout, a
-volvelle that turns on click, live KPI/gauge/meter, SVG and geometry export), **Dashboard** (a
+volvelle that turns on click, a treemap and a sunburst that drill down together, live KPI/gauge/meter, SVG and geometry export), **Dashboard** (a
 linked operations dashboard fed from Python state with ground, substrate, mode and column controls, a
 KPI strip, and `dashboard_link` on its own), **UI components** (`/ui`: the components controlled from
 Python state with a native form submit, and the three reference panels of the upstream example apps

{reflex_silverpoint_react-0.3.0 → reflex_silverpoint_react-0.6.0}/custom_components/reflex_silverpoint_react/__init__.py

@@ -18,67 +18,122 @@ from .charts import (
     ActivityGrid,
     AreaChart,
     BarChart,
+    BeeswarmChart,
+    BoxPlotChart,
     BubbleChart,
     BulletChart,
+    BumpChart,
     CandlestickChart,
     ChordRing,
     ComposedChart,
+    ConnectedScatterChart,
+    ContourChart,
     CoxcombChart,
+    DelaunayChart,
+    DensityBinChart,
+    DivergingBarChart,
     DonutChart,
+    DumbbellChart,
+    EcdfChart,
+    ErrorBarChart,
     FunnelChart,
     GaugeArc,
     HeatmapChart,
+    HistogramChart,
+    IntervalChart,
     KpiCard,
     LineChart,
+    LollipopChart,
+    MarimekkoChart,
     MeterChart,
+    NetworkChart,
     OrbitChart,
+    ParallelCoordinatesChart,
     PolarBarChart,
+    PolarLineChart,
+    PolarScatterChart,
     PyramidChart,
     RadarChart,
     RadialArcGroup,
     RadialRings,
     RangeBandChart,
+    RidgelineChart,
     SankeyChart,
     ScatterChart,
+    SlopeChart,
     SparklineRows,
+    SquarifiedTreemap,
     StackedBarChart,
     StepChart,
     StreamChart,
+    SunburstChart,
+    TreeChart,
     TreemapChart,
+    VectorFieldChart,
+    ViolinChart,
     VolvelleChart,
+    WaffleChart,
     WaterfallChart,
     WindRose,
     activity_grid,
     area_chart,
     bar_chart,
+    beeswarm_chart,
+    box_plot_chart,
     bubble_chart,
     bullet_chart,
+    bump_chart,
     candlestick_chart,
     chord_ring,
     composed_chart,
+    connected_scatter_chart,
+    contour_chart,
     coxcomb_chart,
+    delaunay_chart,
+    density_bin_chart,
+    diverging_bar_chart,
     donut_chart,
+    dumbbell_chart,
+    ecdf_chart,
+    error_bar_chart,
     funnel_chart,
     gauge_arc,
     heatmap_chart,
+    histogram_chart,
+    interval_chart,
     kpi_card,
     line_chart,
+    lollipop_chart,
+    marimekko_chart,
     meter_chart,
+    network_chart,
+    network_node,
     orbit_chart,
+    parallel_coordinates_chart,
     polar_bar_chart,
+    polar_line_chart,
+    polar_scatter_chart,
     pyramid_chart,
     radar_chart,
     radial_arc_group,
     radial_rings,
     range_band_chart,
+    ridgeline_chart,
     sankey_chart,
     scatter_chart,
+    slope_chart,
     sparkline_rows,
+    squarified_treemap,
     stacked_bar_chart,
     step_chart,
     stream_chart,
+    sunburst_chart,
+    tree_chart,
     treemap_chart,
+    vector_field_chart,
+    violin_chart,
     volvelle_chart,
+    waffle_chart,
     waterfall_chart,
     wind_rose,
 )
@@ -164,37 +219,58 @@ __all__ = [
     "ActivityGrid",
     "AreaChart",
     "BarChart",
+    "BeeswarmChart",
+    "BoxPlotChart",
     "BubbleChart",
     "BulletChart",
+    "BumpChart",
     "CandlestickChart",
     "ChartInfo",
     "ChordRing",
     "ComposedChart",
+    "ConnectedScatterChart",
+    "ContourChart",
     "CoxcombChart",
     "Dashboard",
     "DashboardCell",
     "DashboardLink",
+    "DelaunayChart",
+    "DensityBinChart",
+    "DivergingBarChart",
     "DonutChart",
+    "DumbbellChart",
+    "EcdfChart",
+    "ErrorBarChart",
     "FunnelChart",
     "GaugeArc",
     "GroundName",
     "HeatmapChart",
+    "HistogramChart",
+    "IntervalChart",
     "KpiCard",
     "LineChart",
+    "LollipopChart",
+    "MarimekkoChart",
     "MeterChart",
+    "NetworkChart",
     "OrbitChart",
+    "ParallelCoordinatesChart",
     "PolarBarChart",
+    "PolarLineChart",
+    "PolarScatterChart",
     "PropDoc",
     "PyramidChart",
     "RadarChart",
     "RadialArcGroup",
     "RadialRings",
     "RangeBandChart",
+    "RidgelineChart",
     "SankeyChart",
     "ScatterChart",
     "SilverpointChart",
     "SilverpointProvider",
     "SilverpointUi",
+    "SlopeChart",
     "SpAlert",
     "SpBadge",
     "SpButton",
@@ -214,51 +290,79 @@ __all__ = [
     "SpTabs",
     "SpTag",
     "SparklineRows",
+    "SquarifiedTreemap",
     "StackedBarChart",
     "StepChart",
     "StreamChart",
+    "SunburstChart",
+    "TreeChart",
     "TreemapChart",
     "UiComponentInfo",
+    "VectorFieldChart",
+    "ViolinChart",
     "VolvelleChart",
+    "WaffleChart",
     "WaterfallChart",
     "WindRose",
     "activity_grid",
     "area_chart",
     "bar_chart",
+    "beeswarm_chart",
+    "box_plot_chart",
     "bubble_chart",
     "bullet_chart",
+    "bump_chart",
     "candlestick_chart",
     "chart_by_name",
     "chart_by_slug",
     "chart_ref",
     "chord_ring",
     "composed_chart",
+    "connected_scatter_chart",
+    "contour_chart",
     "coxcomb_chart",
     "dashboard",
     "dashboard_cell",
     "dashboard_cell_layout",
     "dashboard_layout",
     "dashboard_link",
+    "delaunay_chart",
+    "density_bin_chart",
+    "diverging_bar_chart",
     "donut_chart",
     "download_svg",
+    "dumbbell_chart",
+    "ecdf_chart",
+    "error_bar_chart",
     "funnel_chart",
     "gauge_arc",
     "get_geometry",
     "get_svg",
     "heatmap_chart",
+    "histogram_chart",
+    "interval_chart",
     "kpi_card",
     "line_chart",
+    "lollipop_chart",
+    "marimekko_chart",
     "meter_chart",
+    "network_chart",
+    "network_node",
     "orbit_chart",
+    "parallel_coordinates_chart",
     "polar_bar_chart",
+    "polar_line_chart",
+    "polar_scatter_chart",
     "pyramid_chart",
     "radar_chart",
     "radial_arc_group",
     "radial_rings",
     "range_band_chart",
+    "ridgeline_chart",
     "sankey_chart",
     "scatter_chart",
     "silverpoint_provider",
+    "slope_chart",
     "sp_alert",
     "sp_badge",
     "sp_button",
@@ -278,16 +382,22 @@ __all__ = [
     "sp_tabs",
     "sp_tag",
     "sparkline_rows",
+    "squarified_treemap",
     "stacked_bar_chart",
     "step_chart",
     "step_item",
     "stream_chart",
+    "sunburst_chart",
     "tooltip_template",
+    "tree_chart",
     "treemap_chart",
     "ui_component_by_slug",
     "ui_demo",
     "ui_item",
+    "vector_field_chart",
+    "violin_chart",
     "volvelle_chart",
+    "waffle_chart",
     "waterfall_chart",
     "wind_rose",
 ]

{reflex_silverpoint_react-0.3.0 → reflex_silverpoint_react-0.6.0}/custom_components/reflex_silverpoint_react/base.py

@@ -16,7 +16,7 @@ from typing import Any, Literal
 import reflex as rx
 
 #: The silverpoint npm release these wrappers are written against.
-SILVERPOINT_VERSION = "0.3.0"
+SILVERPOINT_VERSION = "0.6.0"
 
 #: The npm package every chart is imported from (the barrel; it is side-effect free, so the
 #: bundler keeps only the charts a page uses).