reflex-silverpoint-react 0.1.0__tar.gz → 0.2.0__tar.gz

{reflex_silverpoint_react-0.1.0 → reflex_silverpoint_react-0.2.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: reflex-silverpoint-react
-Version: 0.1.0
-Summary: The 33 silverpoint charts (Renaissance silverpoint drawing style) for Reflex, wrapping @silverpoint/react
+Version: 0.2.0
+Summary: The 33 silverpoint charts and the linked Dashboard (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,9 +33,17 @@ 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.1.1 and exposes
-**all 33 charts**, the `SilverpointProvider`, the interaction events, custom readouts and the
-imperative handle (SVG export and geometry) as Python.
+It wraps [`@silverpoint/react`](https://www.npmjs.com/package/@silverpoint/react) 0.2.0 and exposes
+**all 33 charts**, the **`Dashboard`** (a laid-out, linkable grid of charts), 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.2
+
+- **`dashboard`**, **`dashboard_cell`** and **`dashboard_link`**: a titled grid of cards laid out from
+  a data-only layout, charts sized to their cells, and charts linked on a datum field.
+- **The `cyanotype` ground**: a white line on Prussian blue. Tone is the weight of an exact line, so
+  nothing is hatched. Use `ground="cyanotype"` on a chart, the provider or a dashboard.
 
 ![The gallery of the demo app](docs/gallery.png)
 
@@ -107,8 +115,8 @@ its own props (`COMMON_PROPS` holds the shared ones), handy for galleries and do
 
 | Prop | Default | |
 |---|---|---|
-| `data` | demo dataset | The rows to draw: a list of dicts. |
-| `ground` / `substrate` / `mode` | `"silverpoint"` / `"cream"` / `"ink"` | Style. Substrates: `cream`, `green`, `blue`, `ochre`. `mode="precision"` turns the inking off. |
+| `data` | demo dataset | The rows to draw: a list of dicts. Without it, the accessor props (`*_key`, `keys`, `names`) are ignored. |
+| `ground` / `substrate` / `mode` | `"silverpoint"` / `"cream"` / `"ink"` | Style. Grounds: `silverpoint` and `cyanotype`. The `silverpoint` substrates are `cream`, `green`, `blue` and `ochre`; `cyanotype` has one, `prussian`, whatever substrate a chart names. `mode="precision"` turns the inking off. |
 | `seed`, `id` | derived, stable | The hand drawing is deterministic: same props, same strokes. |
 | `height`, `width` | `160`, container width | Size of the drawing area in px. |
 | `chrome` | `"card"` | `"bare"` draws only the plot. |
@@ -136,6 +144,54 @@ silverpoint_provider(
 A prop on a chart always wins over the provider. The provider's props can be state vars, so one
 select can re-ground a whole dashboard.
 
+## Dashboards
+
+`dashboard` lays charts out in a titled grid. The layout is plain data: the number of columns, each
+cell's column and row spans (per breakpoint if you like), the row height and the gap. The
+breakpoints are the dashboard's own width: `sm` below 640 px, `md` up to 1024 px, and `lg` above.
+The defaults are 1, 2 and 4 columns. Each chart is sized to its cell, and `ground`, `substrate`,
+`mode` and `locale` pass to every chart inside.
+
+```python
+from reflex_silverpoint_react import (
+    bar_chart,
+    dashboard,
+    dashboard_cell,
+    dashboard_cell_layout,
+    dashboard_layout,
+    kpi_card,
+    line_chart,
+)
+
+dashboard(
+    dashboard_cell(kpi_card(title="Revenue", metric="thousands", delta=6.4), cell="revenue"),
+    dashboard_cell(line_chart(data=State.ops, x_key="hour", value_key="hits", title="Traffic"), cell="traffic"),
+    dashboard_cell(bar_chart(data=State.ops, x_key="hour", value_key="errors", title="Errors"), cell="errors"),
+    id="ops",  # required
+    title="Operations",  # or label=... for no visible heading
+    description="Service health over the last day.",
+    layout=dashboard_layout(
+        ["revenue", dashboard_cell_layout("traffic", col_span={"md": 2, "lg": 3}, row_span=2), "errors"],
+        columns={"sm": 1, "md": 2, "lg": 4},
+        row_height=240,
+        gap=16,
+    ),
+    link="hour",  # link the charts on the rows' "hour" field
+    on_link_change=State.on_link,  # {"key": "hour", "value": "18"}, or None when it clears
+)
+```
+
+- `dashboard_cell(chart, cell="id")` puts a chart in a named layout cell. Children without one follow
+  the named cells, in source order, with span 1.
+- With `link`, pointing at or focusing an item in one chart marks every item in the other charts
+  that has the same value in that field. `dashboard_link(..., link="hour")` does the same for charts
+  you lay out yourself, outside a dashboard grid.
+- `heading_level` (2-6) sets the title's heading level. `ssr_width` is the width the grid is laid
+  out for before the browser measures it.
+- `dashboard_layout` and `dashboard_cell_layout` write the camelCase keys the component reads. You
+  can also pass a plain dict.
+- The layout values and the charts' props can be state vars.
+
 ## Interaction
 
 ```python
@@ -205,8 +261,10 @@ uv run reflex run
 Pages: **Start** (quickstart, provider, ink vs precision), **Gallery** (the 33 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) and one **reference
-page per chart** (`/chart/<slug>`) with its props.
+volvelle that turns on click, 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) and one **reference page per chart** (`/chart/<slug>`)
+with its props. The Gallery and Playground also get a ground control, for `cyanotype`.
 
 ![Interaction page](docs/interaction.png)
 

{reflex_silverpoint_react-0.1.0 → reflex_silverpoint_react-0.2.0}/README.md

@@ -7,9 +7,17 @@ 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.1.1 and exposes
-**all 33 charts**, the `SilverpointProvider`, the interaction events, custom readouts and the
-imperative handle (SVG export and geometry) as Python.
+It wraps [`@silverpoint/react`](https://www.npmjs.com/package/@silverpoint/react) 0.2.0 and exposes
+**all 33 charts**, the **`Dashboard`** (a laid-out, linkable grid of charts), 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.2
+
+- **`dashboard`**, **`dashboard_cell`** and **`dashboard_link`**: a titled grid of cards laid out from
+  a data-only layout, charts sized to their cells, and charts linked on a datum field.
+- **The `cyanotype` ground**: a white line on Prussian blue. Tone is the weight of an exact line, so
+  nothing is hatched. Use `ground="cyanotype"` on a chart, the provider or a dashboard.
 
 ![The gallery of the demo app](docs/gallery.png)
 
@@ -81,8 +89,8 @@ its own props (`COMMON_PROPS` holds the shared ones), handy for galleries and do
 
 | Prop | Default | |
 |---|---|---|
-| `data` | demo dataset | The rows to draw: a list of dicts. |
-| `ground` / `substrate` / `mode` | `"silverpoint"` / `"cream"` / `"ink"` | Style. Substrates: `cream`, `green`, `blue`, `ochre`. `mode="precision"` turns the inking off. |
+| `data` | demo dataset | The rows to draw: a list of dicts. Without it, the accessor props (`*_key`, `keys`, `names`) are ignored. |
+| `ground` / `substrate` / `mode` | `"silverpoint"` / `"cream"` / `"ink"` | Style. Grounds: `silverpoint` and `cyanotype`. The `silverpoint` substrates are `cream`, `green`, `blue` and `ochre`; `cyanotype` has one, `prussian`, whatever substrate a chart names. `mode="precision"` turns the inking off. |
 | `seed`, `id` | derived, stable | The hand drawing is deterministic: same props, same strokes. |
 | `height`, `width` | `160`, container width | Size of the drawing area in px. |
 | `chrome` | `"card"` | `"bare"` draws only the plot. |
@@ -110,6 +118,54 @@ silverpoint_provider(
 A prop on a chart always wins over the provider. The provider's props can be state vars, so one
 select can re-ground a whole dashboard.
 
+## Dashboards
+
+`dashboard` lays charts out in a titled grid. The layout is plain data: the number of columns, each
+cell's column and row spans (per breakpoint if you like), the row height and the gap. The
+breakpoints are the dashboard's own width: `sm` below 640 px, `md` up to 1024 px, and `lg` above.
+The defaults are 1, 2 and 4 columns. Each chart is sized to its cell, and `ground`, `substrate`,
+`mode` and `locale` pass to every chart inside.
+
+```python
+from reflex_silverpoint_react import (
+    bar_chart,
+    dashboard,
+    dashboard_cell,
+    dashboard_cell_layout,
+    dashboard_layout,
+    kpi_card,
+    line_chart,
+)
+
+dashboard(
+    dashboard_cell(kpi_card(title="Revenue", metric="thousands", delta=6.4), cell="revenue"),
+    dashboard_cell(line_chart(data=State.ops, x_key="hour", value_key="hits", title="Traffic"), cell="traffic"),
+    dashboard_cell(bar_chart(data=State.ops, x_key="hour", value_key="errors", title="Errors"), cell="errors"),
+    id="ops",  # required
+    title="Operations",  # or label=... for no visible heading
+    description="Service health over the last day.",
+    layout=dashboard_layout(
+        ["revenue", dashboard_cell_layout("traffic", col_span={"md": 2, "lg": 3}, row_span=2), "errors"],
+        columns={"sm": 1, "md": 2, "lg": 4},
+        row_height=240,
+        gap=16,
+    ),
+    link="hour",  # link the charts on the rows' "hour" field
+    on_link_change=State.on_link,  # {"key": "hour", "value": "18"}, or None when it clears
+)
+```
+
+- `dashboard_cell(chart, cell="id")` puts a chart in a named layout cell. Children without one follow
+  the named cells, in source order, with span 1.
+- With `link`, pointing at or focusing an item in one chart marks every item in the other charts
+  that has the same value in that field. `dashboard_link(..., link="hour")` does the same for charts
+  you lay out yourself, outside a dashboard grid.
+- `heading_level` (2-6) sets the title's heading level. `ssr_width` is the width the grid is laid
+  out for before the browser measures it.
+- `dashboard_layout` and `dashboard_cell_layout` write the camelCase keys the component reads. You
+  can also pass a plain dict.
+- The layout values and the charts' props can be state vars.
+
 ## Interaction
 
 ```python
@@ -179,8 +235,10 @@ uv run reflex run
 Pages: **Start** (quickstart, provider, ink vs precision), **Gallery** (the 33 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) and one **reference
-page per chart** (`/chart/<slug>`) with its props.
+volvelle that turns on click, 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) and one **reference page per chart** (`/chart/<slug>`)
+with its props. The Gallery and Playground also get a ground control, for `cyanotype`.
 
 ![Interaction page](docs/interaction.png)
 

{reflex_silverpoint_react-0.1.0 → reflex_silverpoint_react-0.2.0}/custom_components/reflex_silverpoint_react/__init__.py

@@ -7,6 +7,7 @@ from .base import (
     SILVERPOINT_LIBRARY,
     SILVERPOINT_STYLESHEETS,
     SILVERPOINT_VERSION,
+    GroundName,
     SilverpointChart,
     SilverpointProvider,
     silverpoint_provider,
@@ -80,11 +81,23 @@ from .charts import (
     waterfall_chart,
     wind_rose,
 )
+from .dashboard import (
+    DASHBOARD_DEFAULTS,
+    Dashboard,
+    DashboardCell,
+    DashboardLink,
+    dashboard,
+    dashboard_cell,
+    dashboard_cell_layout,
+    dashboard_layout,
+    dashboard_link,
+)
 from .helpers import chart_ref, download_svg, get_geometry, get_svg, tooltip_template
 
 __all__ = [
     "CHARTS",
     "COMMON_PROPS",
+    "DASHBOARD_DEFAULTS",
     "FAMILIES",
     "SILVERPOINT_LIBRARY",
     "SILVERPOINT_STYLESHEETS",
@@ -99,9 +112,13 @@ __all__ = [
     "ChordRing",
     "ComposedChart",
     "CoxcombChart",
+    "Dashboard",
+    "DashboardCell",
+    "DashboardLink",
     "DonutChart",
     "FunnelChart",
     "GaugeArc",
+    "GroundName",
     "HeatmapChart",
     "KpiCard",
     "LineChart",
@@ -138,6 +155,11 @@ __all__ = [
     "chord_ring",
     "composed_chart",
     "coxcomb_chart",
+    "dashboard",
+    "dashboard_cell",
+    "dashboard_cell_layout",
+    "dashboard_layout",
+    "dashboard_link",
     "donut_chart",
     "download_svg",
     "funnel_chart",

{reflex_silverpoint_react-0.1.0 → reflex_silverpoint_react-0.2.0}/custom_components/reflex_silverpoint_react/base.py

@@ -5,7 +5,7 @@ on a prepared ground, tone built from hatching, and white heightening on the liv
 irregularity lives only in the ornament; the data geometry is exact, and every chart has a
 ``precision`` mode that switches the inking off.
 
-The npm side is ``@silverpoint/react`` (client components), ``@silverpoint/grounds`` (the
+The npm side is ``@silverpoint/react`` (client components, and since 0.2 the ``Dashboard`` grid), ``@silverpoint/grounds`` (the
 stylesheet that colours the strokes, required) and ``@silverpoint/fonts`` (self-hosted
 EB Garamond). Both stylesheets are imported once by any page that renders a chart.
 """
@@ -15,7 +15,7 @@ from typing import Any, Literal
 import reflex as rx
 
 #: The silverpoint npm release these wrappers are written against.
-SILVERPOINT_VERSION = "0.1.1"
+SILVERPOINT_VERSION = "0.2.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).
@@ -27,6 +27,12 @@ SILVERPOINT_STYLESHEETS = (
     "@silverpoint/grounds/styles.css",
 )
 
+#: The grounds ``@silverpoint/grounds`` registers by default. ``silverpoint`` builds tone by
+#: hatching; ``cyanotype`` (new in 0.2) by the weight of an exact white line on Prussian blue.
+GroundName = Literal["silverpoint", "cyanotype"]
+
+#: The ``silverpoint`` ground's substrates. ``cyanotype`` has one substrate (``prussian``) and
+#: prints on it whatever substrate a chart names.
 Substrate = Literal["cream", "green", "blue", "ochre"]
 InkMode = Literal["ink", "precision"]
 Chrome = Literal["card", "bare"]
@@ -88,8 +94,8 @@ class SilverpointChart(_SilverpointBase):
     # Rows to draw. If omitted, the chart renders its own demo dataset.
     data: rx.Var[list[dict[str, Any]]]
 
-    # Style ground, by name (``"silverpoint"``) or as a complete ground object.
-    ground: rx.Var[str | dict[str, Any]]
+    # Style ground, by name (``"silverpoint"`` or ``"cyanotype"``) or as a complete ground object.
+    ground: rx.Var[GroundName | str | dict[str, Any]]
 
     # Prepared substrate within the ground: cream (default), green, blue or ochre.
     substrate: rx.Var[Substrate]
@@ -164,8 +170,8 @@ class SilverpointProvider(_SilverpointBase):
 
     tag = "SilverpointProvider"
 
-    # Style ground for every chart below.
-    ground: rx.Var[str | dict[str, Any]]
+    # Style ground for every chart below: ``"silverpoint"``, ``"cyanotype"`` or a ground object.
+    ground: rx.Var[GroundName | str | dict[str, Any]]
 
     # Substrate for every chart below.
     substrate: rx.Var[Substrate]

{reflex_silverpoint_react-0.1.0 → reflex_silverpoint_react-0.2.0}/custom_components/reflex_silverpoint_react/base.pyi

@@ -4,23 +4,25 @@
 # This file was generated by `reflex/utils/pyi_generator.py`!
 # ------------------------------------------------------
 from collections.abc import Mapping, Sequence
-from typing import Any, Literal, Optional
-from reflex_components_core.core.breakpoints import Breakpoints
+from typing import Any, Literal, TypeAlias
+
+import reflex as rx
 from reflex_base.event import (
     EventType,
     PointerEventInfo,
 )
 from reflex_base.vars.base import Var
-import reflex as rx
+from reflex_components_core.core.breakpoints import Breakpoints
 
-SILVERPOINT_VERSION = "0.1.1"
-SILVERPOINT_LIBRARY = f"@silverpoint/react@{SILVERPOINT_VERSION}"
+SILVERPOINT_VERSION = "0.2.0"
+SILVERPOINT_LIBRARY = ...
 SILVERPOINT_STYLESHEETS = ("@silverpoint/fonts/fonts.css", "@silverpoint/grounds/styles.css")
-Substrate = Literal["cream", "green", "blue", "ochre"]
-InkMode = Literal["ink", "precision"]
-Chrome = Literal["card", "bare"]
-HatchFill = Literal["tile", "per-shape"]
-DataTable = Literal["visible", "hidden", "none"]
+GroundName: TypeAlias = Literal["silverpoint", "cyanotype"]
+Substrate: TypeAlias = Literal["cream", "green", "blue", "ochre"]
+InkMode: TypeAlias = Literal["ink", "precision"]
+Chrome: TypeAlias = Literal["card", "bare"]
+HatchFill: TypeAlias = Literal["tile", "per-shape"]
+DataTable: TypeAlias = Literal["visible", "hidden", "none"]
 
 class _SilverpointBase(rx.Component):
     def add_imports(self) -> dict[str, list[str]]: ...
@@ -34,24 +36,24 @@ class _SilverpointBase(rx.Component):
         ref: Var | None = None,
         class_name: Any | None = None,
         custom_attrs: dict[str, Any | Var] | None = None,
-        on_blur: Optional[EventType[()]] = None,
-        on_click: Optional[EventType[()] | EventType[PointerEventInfo]] = None,
-        on_context_menu: Optional[EventType[()] | EventType[PointerEventInfo]] = None,
-        on_double_click: Optional[EventType[()] | EventType[PointerEventInfo]] = None,
-        on_focus: Optional[EventType[()]] = None,
-        on_mount: Optional[EventType[()]] = None,
-        on_mouse_down: Optional[EventType[()]] = None,
-        on_mouse_enter: Optional[EventType[()]] = None,
-        on_mouse_leave: Optional[EventType[()]] = None,
-        on_mouse_move: Optional[EventType[()]] = None,
-        on_mouse_out: Optional[EventType[()]] = None,
-        on_mouse_over: Optional[EventType[()]] = None,
-        on_mouse_up: Optional[EventType[()]] = None,
-        on_scroll: Optional[EventType[()]] = None,
-        on_scroll_end: Optional[EventType[()]] = None,
-        on_unmount: Optional[EventType[()]] = None,
+        on_blur: EventType[()] | None = None,
+        on_click: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_context_menu: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_double_click: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_focus: EventType[()] | None = None,
+        on_mount: EventType[()] | None = None,
+        on_mouse_down: EventType[()] | None = None,
+        on_mouse_enter: EventType[()] | None = None,
+        on_mouse_leave: EventType[()] | None = None,
+        on_mouse_move: EventType[()] | None = None,
+        on_mouse_out: EventType[()] | None = None,
+        on_mouse_over: EventType[()] | None = None,
+        on_mouse_up: EventType[()] | None = None,
+        on_scroll: EventType[()] | None = None,
+        on_scroll_end: EventType[()] | None = None,
+        on_unmount: EventType[()] | None = None,
         **props,
-    ) -> "_SilverpointBase":
+    ) -> _SilverpointBase:
         """Create the component.
 
         Args:
@@ -81,9 +83,7 @@ class _SilverpointBase(rx.Component):
             **props: The props of the component.
 
         Returns:
-            The component.
-        """
-        ...
+            The component."""
 
 class SilverpointChart(_SilverpointBase):
     @classmethod
@@ -91,19 +91,23 @@ class SilverpointChart(_SilverpointBase):
         cls,
         *children,
         data: Var[list[dict[str, Any]]] | list[dict[str, Any]] | None = None,
-        ground: Var[dict[str, Any] | str] | dict[str, Any] | str | None = None,
+        ground: Literal["cyanotype", "silverpoint"]
+        | Var[Literal["cyanotype", "silverpoint"] | dict[str, Any] | str]
+        | dict[str, Any]
+        | str
+        | None = None,
         substrate: Literal["blue", "cream", "green", "ochre"]
         | Var[Literal["blue", "cream", "green", "ochre"]]
         | None = None,
         mode: Literal["ink", "precision"] | Var[Literal["ink", "precision"]] | None = None,
         seed: Var[int | str] | int | str | None = None,
-        height: Var[float | int] | float | int | None = None,
-        width: Var[float | int] | float | int | None = None,
+        height: Var[float | int] | float | None = None,
+        width: Var[float | int] | float | None = None,
         chrome: Literal["bare", "card"] | Var[Literal["bare", "card"]] | None = None,
         hatch_fill: Literal["per-shape", "tile"] | Var[Literal["per-shape", "tile"]] | None = None,
         title: Var[str] | str | None = None,
         badge: Var[str] | str | None = None,
-        value: Var[float | int | str] | float | int | str | None = None,
+        value: Var[float | int | str] | float | str | None = None,
         unit: Var[str] | str | None = None,
         footer_left: Var[str] | str | None = None,
         footer_right: Var[str] | str | None = None,
@@ -119,26 +123,26 @@ class SilverpointChart(_SilverpointBase):
         ref: Var | None = None,
         class_name: Any | None = None,
         custom_attrs: dict[str, Any | Var] | None = None,
-        on_active_change: Optional[EventType[Any]] = None,
-        on_blur: Optional[EventType[()]] = None,
-        on_click: Optional[EventType[()] | EventType[PointerEventInfo]] = None,
-        on_context_menu: Optional[EventType[()] | EventType[PointerEventInfo]] = None,
-        on_double_click: Optional[EventType[()] | EventType[PointerEventInfo]] = None,
-        on_focus: Optional[EventType[()]] = None,
-        on_mount: Optional[EventType[()]] = None,
-        on_mouse_down: Optional[EventType[()]] = None,
-        on_mouse_enter: Optional[EventType[()]] = None,
-        on_mouse_leave: Optional[EventType[()]] = None,
-        on_mouse_move: Optional[EventType[()]] = None,
-        on_mouse_out: Optional[EventType[()]] = None,
-        on_mouse_over: Optional[EventType[()]] = None,
-        on_mouse_up: Optional[EventType[()]] = None,
-        on_scroll: Optional[EventType[()]] = None,
-        on_scroll_end: Optional[EventType[()]] = None,
-        on_select: Optional[EventType[Any]] = None,
-        on_unmount: Optional[EventType[()]] = None,
+        on_active_change: EventType[Any] | None = None,
+        on_blur: EventType[()] | None = None,
+        on_click: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_context_menu: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_double_click: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_focus: EventType[()] | None = None,
+        on_mount: EventType[()] | None = None,
+        on_mouse_down: EventType[()] | None = None,
+        on_mouse_enter: EventType[()] | None = None,
+        on_mouse_leave: EventType[()] | None = None,
+        on_mouse_move: EventType[()] | None = None,
+        on_mouse_out: EventType[()] | None = None,
+        on_mouse_over: EventType[()] | None = None,
+        on_mouse_up: EventType[()] | None = None,
+        on_scroll: EventType[()] | None = None,
+        on_scroll_end: EventType[()] | None = None,
+        on_select: EventType[Any] | None = None,
+        on_unmount: EventType[()] | None = None,
         **props,
-    ) -> "SilverpointChart":
+    ) -> SilverpointChart:
         """Create the component.
 
         Args:
@@ -191,16 +195,18 @@ class SilverpointChart(_SilverpointBase):
             **props: The props of the component.
 
         Returns:
-            The component.
-        """
-        ...
+            The component."""
 
 class SilverpointProvider(_SilverpointBase):
     @classmethod
     def create(
         cls,
         *children,
-        ground: Var[dict[str, Any] | str] | dict[str, Any] | str | None = None,
+        ground: Literal["cyanotype", "silverpoint"]
+        | Var[Literal["cyanotype", "silverpoint"] | dict[str, Any] | str]
+        | dict[str, Any]
+        | str
+        | None = None,
         substrate: Literal["blue", "cream", "green", "ochre"]
         | Var[Literal["blue", "cream", "green", "ochre"]]
         | None = None,
@@ -212,29 +218,29 @@ class SilverpointProvider(_SilverpointBase):
         ref: Var | None = None,
         class_name: Any | None = None,
         custom_attrs: dict[str, Any | Var] | None = None,
-        on_blur: Optional[EventType[()]] = None,
-        on_click: Optional[EventType[()] | EventType[PointerEventInfo]] = None,
-        on_context_menu: Optional[EventType[()] | EventType[PointerEventInfo]] = None,
-        on_double_click: Optional[EventType[()] | EventType[PointerEventInfo]] = None,
-        on_focus: Optional[EventType[()]] = None,
-        on_mount: Optional[EventType[()]] = None,
-        on_mouse_down: Optional[EventType[()]] = None,
-        on_mouse_enter: Optional[EventType[()]] = None,
-        on_mouse_leave: Optional[EventType[()]] = None,
-        on_mouse_move: Optional[EventType[()]] = None,
-        on_mouse_out: Optional[EventType[()]] = None,
-        on_mouse_over: Optional[EventType[()]] = None,
-        on_mouse_up: Optional[EventType[()]] = None,
-        on_scroll: Optional[EventType[()]] = None,
-        on_scroll_end: Optional[EventType[()]] = None,
-        on_unmount: Optional[EventType[()]] = None,
+        on_blur: EventType[()] | None = None,
+        on_click: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_context_menu: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_double_click: EventType[()] | EventType[PointerEventInfo] | None = None,
+        on_focus: EventType[()] | None = None,
+        on_mount: EventType[()] | None = None,
+        on_mouse_down: EventType[()] | None = None,
+        on_mouse_enter: EventType[()] | None = None,
+        on_mouse_leave: EventType[()] | None = None,
+        on_mouse_move: EventType[()] | None = None,
+        on_mouse_out: EventType[()] | None = None,
+        on_mouse_over: EventType[()] | None = None,
+        on_mouse_up: EventType[()] | None = None,
+        on_scroll: EventType[()] | None = None,
+        on_scroll_end: EventType[()] | None = None,
+        on_unmount: EventType[()] | None = None,
         **props,
-    ) -> "SilverpointProvider":
+    ) -> SilverpointProvider:
         """Create the component.
 
         Args:
             *children: The children of the component.
-            ground: Style ground for every chart below.
+            ground: Style ground for every chart below: ``"silverpoint"``, ``"cyanotype"`` or a ground object.
             substrate: Substrate for every chart below.
             mode: Inking mode for every chart below.
             locale: Locale for every chart below.
@@ -263,8 +269,6 @@ class SilverpointProvider(_SilverpointBase):
             **props: The props of the component.
 
         Returns:
-            The component.
-        """
-        ...
+            The component."""
 
 silverpoint_provider = SilverpointProvider.create

{reflex_silverpoint_react-0.1.0 → reflex_silverpoint_react-0.2.0}/custom_components/reflex_silverpoint_react/catalog.py

@@ -45,8 +45,18 @@ class ChartInfo:
 
 #: Props every chart takes.
 COMMON_PROPS: tuple[PropDoc, ...] = (
-    PropDoc("data", "data", "readonly Datum[]", "Rows to draw. If omitted, the demo dataset is rendered (REQ-093)."),
-    PropDoc("ground", "ground", "GroundRef", "Style ground. Defaults to the app provider's, or `silverpoint`."),
+    PropDoc(
+        "data",
+        "data",
+        "readonly Datum[]",
+        "Rows to draw. If omitted, the demo dataset is rendered (REQ-093) and the accessor props (`…_key`, `keys`, `names`) are ignored.",
+    ),
+    PropDoc(
+        "ground",
+        "ground",
+        "GroundRef",
+        "Style ground: `silverpoint` or `cyanotype`, or a ground object. Defaults to the app provider's, or `silverpoint`.",
+    ),
     PropDoc("substrate", "substrate", "SubstrateName", "Prepared substrate within the ground (REQ-046)."),
     PropDoc("mode", "mode", "InkMode", "`ink` by default; `precision` disables inking (REQ-021)."),
     PropDoc("seed", "seed", "Seed", "Seed. If omitted, it is derived from `id` stably (REQ-003)."),