reflex-silverpoint-react 0.7.1__tar.gz → 0.8.0__tar.gz

{reflex_silverpoint_react-0.7.1 → reflex_silverpoint_react-0.8.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: reflex-silverpoint-react
-Version: 0.7.1
-Summary: The 60 silverpoint charts, the Dashboard, 38 UI, composed and overlay components, palettes and a Knight Lab timeline (Renaissance silverpoint drawing style) for Reflex, wrapping @silverpoint/react 0.7
+Version: 0.8.0
+Summary: The 60 silverpoint charts, the Dashboard, 38 UI, composed and overlay components, palettes and a Knight Lab timeline (Renaissance silverpoint drawing style) for Reflex, wrapping @silverpoint/react 0.8
 Author-email: Ernesto Crespo <ecrespo@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/ecrespo/reflex-silverpoint-react
@@ -34,7 +34,7 @@ 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.7.0** and exposes
+It wraps [`@silverpoint/react`](https://www.npmjs.com/package/@silverpoint/react) **0.8.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 **12 composed components** (table,
 pagination, breadcrumb, avatar…), the **7 overlays** and the toaster (modal, drawer, popover,
@@ -45,6 +45,14 @@ readouts and the imperative handle (SVG export and geometry) as Python.
 Everything it renders is an npm component of silverpoint, under its parity contract: the same
 markup React, Vue and Angular render.
 
+### New in 0.8.0
+
+- Wraps **`@silverpoint/react` 0.8.0**. silverpoint 0.8 adds agent access and changes no API this
+  package wraps, so the Python builders are unchanged.
+- **Agent access:** the `reflex-silverpoint` skill, a Claude plugin with the hosted silverpoint MCP
+  server, and `reflex-catalog.json`, the Reflex catalog silverpoint's agent catalog joins. See
+  [Use with AI](#use-with-ai).
+
 ### New in 0.7.1
 
 - Wraps **`@silverpoint/react` 0.7.0** (0.7.0 wrapped 0.6.0). silverpoint 0.7 took this package's
@@ -587,6 +595,31 @@ The exported SVG carries its own ground colours, so it renders the same outside
 - Accessors are field names (strings). The JavaScript API also accepts functions; from Python, shape
   your rows instead.
 
+## Use with AI
+
+An assistant writes better `reflex-silverpoint-react` code with the **`reflex-silverpoint` skill**
+([`skills/reflex-silverpoint/`](skills/reflex-silverpoint/SKILL.md)): the builders and their
+snake_case props, State patterns, event payloads, the provider and palettes, composed components and
+overlays, the dashboard and the timeline. Its tables are generated from the package, and every Python
+example in it is imported and rendered by the tests.
+
+In Claude Code, the plugin installs the skill together with the hosted silverpoint MCP server
+(`https://silverpointweb.vercel.app/mcp`), which recommends charts, checks props and draws a chart
+as SVG before you write the code:
+
+```text
+/plugin marketplace add ecrespo/reflex-silverpoint-react
+/plugin install reflex-silverpoint@reflex-silverpoint
+```
+
+The MCP server alone: `claude mcp add --transport http silverpoint https://silverpointweb.vercel.app/mcp`.
+
+[`reflex-catalog.json`](reflex-catalog.json) is this package's catalog for agents: every chart and
+component builder with its props (Python name, JS name and type), the deprecated arguments it still
+accepts, the helpers, the package version and the silverpoint version it wraps. silverpoint's agent
+catalog joins it, so its MCP tools answer with the Reflex names too. `scripts/export_catalog.py`
+writes it, CI fails when it is stale, and each GitHub release carries it.
+
 ## Demo app
 
 ```bash

{reflex_silverpoint_react-0.7.1 → reflex_silverpoint_react-0.8.0}/README.md

@@ -7,7 +7,7 @@ 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.7.0** and exposes
+It wraps [`@silverpoint/react`](https://www.npmjs.com/package/@silverpoint/react) **0.8.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 **12 composed components** (table,
 pagination, breadcrumb, avatar…), the **7 overlays** and the toaster (modal, drawer, popover,
@@ -18,6 +18,14 @@ readouts and the imperative handle (SVG export and geometry) as Python.
 Everything it renders is an npm component of silverpoint, under its parity contract: the same
 markup React, Vue and Angular render.
 
+### New in 0.8.0
+
+- Wraps **`@silverpoint/react` 0.8.0**. silverpoint 0.8 adds agent access and changes no API this
+  package wraps, so the Python builders are unchanged.
+- **Agent access:** the `reflex-silverpoint` skill, a Claude plugin with the hosted silverpoint MCP
+  server, and `reflex-catalog.json`, the Reflex catalog silverpoint's agent catalog joins. See
+  [Use with AI](#use-with-ai).
+
 ### New in 0.7.1
 
 - Wraps **`@silverpoint/react` 0.7.0** (0.7.0 wrapped 0.6.0). silverpoint 0.7 took this package's
@@ -560,6 +568,31 @@ The exported SVG carries its own ground colours, so it renders the same outside
 - Accessors are field names (strings). The JavaScript API also accepts functions; from Python, shape
   your rows instead.
 
+## Use with AI
+
+An assistant writes better `reflex-silverpoint-react` code with the **`reflex-silverpoint` skill**
+([`skills/reflex-silverpoint/`](skills/reflex-silverpoint/SKILL.md)): the builders and their
+snake_case props, State patterns, event payloads, the provider and palettes, composed components and
+overlays, the dashboard and the timeline. Its tables are generated from the package, and every Python
+example in it is imported and rendered by the tests.
+
+In Claude Code, the plugin installs the skill together with the hosted silverpoint MCP server
+(`https://silverpointweb.vercel.app/mcp`), which recommends charts, checks props and draws a chart
+as SVG before you write the code:
+
+```text
+/plugin marketplace add ecrespo/reflex-silverpoint-react
+/plugin install reflex-silverpoint@reflex-silverpoint
+```
+
+The MCP server alone: `claude mcp add --transport http silverpoint https://silverpointweb.vercel.app/mcp`.
+
+[`reflex-catalog.json`](reflex-catalog.json) is this package's catalog for agents: every chart and
+component builder with its props (Python name, JS name and type), the deprecated arguments it still
+accepts, the helpers, the package version and the silverpoint version it wraps. silverpoint's agent
+catalog joins it, so its MCP tools answer with the Reflex names too. `scripts/export_catalog.py`
+writes it, CI fails when it is stale, and each GitHub release carries it.
+
 ## Demo app
 
 ```bash

{reflex_silverpoint_react-0.7.1 → reflex_silverpoint_react-0.8.0}/custom_components/reflex_silverpoint_react/__init__.py

@@ -1,7 +1,7 @@
 """reflex-silverpoint-react: silverpoint charts and UI components for Reflex.
 
 Charts and interface components drawn in the manner of a Renaissance silverpoint drawing,
-wrapping ``@silverpoint/react`` 0.7.0: the 60 charts, the dashboard, the 38 UI, composed and overlay
+wrapping ``@silverpoint/react`` 0.8.0: the 60 charts, the dashboard, the 38 UI, composed and overlay
 components, the palettes and the Knight Lab timeline.
 """
 

{reflex_silverpoint_react-0.7.1 → reflex_silverpoint_react-0.8.0}/custom_components/reflex_silverpoint_react/base.py

@@ -20,7 +20,7 @@ import reflex as rx
 from .palette import PaletteLike, apply_palette
 
 #: The silverpoint npm release these wrappers are written against.
-SILVERPOINT_VERSION = "0.7.0"
+SILVERPOINT_VERSION = "0.8.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).

{reflex_silverpoint_react-0.7.1 → reflex_silverpoint_react-0.8.0}/custom_components/reflex_silverpoint_react/base.pyi

@@ -15,7 +15,7 @@ from reflex_components_core.core.breakpoints import Breakpoints
 
 from .palette import Palette, PaletteLike
 
-SILVERPOINT_VERSION = "0.7.0"
+SILVERPOINT_VERSION = "0.8.0"
 SILVERPOINT_LIBRARY = ...
 SILVERPOINT_STYLESHEETS = ("@silverpoint/fonts/fonts.css", "@silverpoint/grounds/styles.css")
 GroundName: TypeAlias = Literal["silverpoint", "cyanotype"]

{reflex_silverpoint_react-0.7.1 → reflex_silverpoint_react-0.8.0}/custom_components/reflex_silverpoint_react/catalog.py

@@ -912,6 +912,12 @@ CHARTS: tuple[ChartInfo, ...] = (
             PropDoc(
                 "root_id", "rootId", "string | null", "The node drawn as root, controlled; the data root by default."
             ),
+            PropDoc(
+                "on_root_change",
+                "onRootChange",
+                "(id: string | null) => void",
+                "A node asked to be drawn as root (`None`: back to the top); pass it back as `root_id`.",
+            ),
         ),
     ),
     ChartInfo(
@@ -934,6 +940,12 @@ CHARTS: tuple[ChartInfo, ...] = (
             PropDoc(
                 "root_id", "rootId", "string | null", "The node drawn as root, controlled; the data root by default."
             ),
+            PropDoc(
+                "on_root_change",
+                "onRootChange",
+                "(id: string | null) => void",
+                "A node asked to be drawn as root (`None`: back to the top); pass it back as `root_id`.",
+            ),
         ),
     ),
     ChartInfo(

{reflex_silverpoint_react-0.7.1 → reflex_silverpoint_react-0.8.0}/custom_components/reflex_silverpoint_react.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: reflex-silverpoint-react
-Version: 0.7.1
-Summary: The 60 silverpoint charts, the Dashboard, 38 UI, composed and overlay components, palettes and a Knight Lab timeline (Renaissance silverpoint drawing style) for Reflex, wrapping @silverpoint/react 0.7
+Version: 0.8.0
+Summary: The 60 silverpoint charts, the Dashboard, 38 UI, composed and overlay components, palettes and a Knight Lab timeline (Renaissance silverpoint drawing style) for Reflex, wrapping @silverpoint/react 0.8
 Author-email: Ernesto Crespo <ecrespo@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/ecrespo/reflex-silverpoint-react
@@ -34,7 +34,7 @@ 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.7.0** and exposes
+It wraps [`@silverpoint/react`](https://www.npmjs.com/package/@silverpoint/react) **0.8.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 **12 composed components** (table,
 pagination, breadcrumb, avatar…), the **7 overlays** and the toaster (modal, drawer, popover,
@@ -45,6 +45,14 @@ readouts and the imperative handle (SVG export and geometry) as Python.
 Everything it renders is an npm component of silverpoint, under its parity contract: the same
 markup React, Vue and Angular render.
 
+### New in 0.8.0
+
+- Wraps **`@silverpoint/react` 0.8.0**. silverpoint 0.8 adds agent access and changes no API this
+  package wraps, so the Python builders are unchanged.
+- **Agent access:** the `reflex-silverpoint` skill, a Claude plugin with the hosted silverpoint MCP
+  server, and `reflex-catalog.json`, the Reflex catalog silverpoint's agent catalog joins. See
+  [Use with AI](#use-with-ai).
+
 ### New in 0.7.1
 
 - Wraps **`@silverpoint/react` 0.7.0** (0.7.0 wrapped 0.6.0). silverpoint 0.7 took this package's
@@ -587,6 +595,31 @@ The exported SVG carries its own ground colours, so it renders the same outside
 - Accessors are field names (strings). The JavaScript API also accepts functions; from Python, shape
   your rows instead.
 
+## Use with AI
+
+An assistant writes better `reflex-silverpoint-react` code with the **`reflex-silverpoint` skill**
+([`skills/reflex-silverpoint/`](skills/reflex-silverpoint/SKILL.md)): the builders and their
+snake_case props, State patterns, event payloads, the provider and palettes, composed components and
+overlays, the dashboard and the timeline. Its tables are generated from the package, and every Python
+example in it is imported and rendered by the tests.
+
+In Claude Code, the plugin installs the skill together with the hosted silverpoint MCP server
+(`https://silverpointweb.vercel.app/mcp`), which recommends charts, checks props and draws a chart
+as SVG before you write the code:
+
+```text
+/plugin marketplace add ecrespo/reflex-silverpoint-react
+/plugin install reflex-silverpoint@reflex-silverpoint
+```
+
+The MCP server alone: `claude mcp add --transport http silverpoint https://silverpointweb.vercel.app/mcp`.
+
+[`reflex-catalog.json`](reflex-catalog.json) is this package's catalog for agents: every chart and
+component builder with its props (Python name, JS name and type), the deprecated arguments it still
+accepts, the helpers, the package version and the silverpoint version it wraps. silverpoint's agent
+catalog joins it, so its MCP tools answer with the Reflex names too. `scripts/export_catalog.py`
+writes it, CI fails when it is stale, and each GitHub release carries it.
+
 ## Demo app
 
 ```bash

{reflex_silverpoint_react-0.7.1 → reflex_silverpoint_react-0.8.0}/custom_components/reflex_silverpoint_react.egg-info/SOURCES.txt

@@ -28,6 +28,9 @@ custom_components/reflex_silverpoint_react.egg-info/dependency_links.txt
 custom_components/reflex_silverpoint_react.egg-info/requires.txt
 custom_components/reflex_silverpoint_react.egg-info/top_level.txt
 custom_components/reflex_silverpoint_react/assets/trigger.jsx
+tests/test_agent_catalog.py
 tests/test_components.py
 tests/test_demo_data.py
+tests/test_plugin.py
+tests/test_skill.py
 tests/test_v07.py

{reflex_silverpoint_react-0.7.1 → reflex_silverpoint_react-0.8.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "reflex-silverpoint-react"
-version = "0.7.1"
-description = "The 60 silverpoint charts, the Dashboard, 38 UI, composed and overlay components, palettes and a Knight Lab timeline (Renaissance silverpoint drawing style) for Reflex, wrapping @silverpoint/react 0.7"
+version = "0.8.0"
+description = "The 60 silverpoint charts, the Dashboard, 38 UI, composed and overlay components, palettes and a Knight Lab timeline (Renaissance silverpoint drawing style) for Reflex, wrapping @silverpoint/react 0.8"
 readme = "README.md"
 license = { text = "MIT" }
 requires-python = ">=3.11"

reflex_silverpoint_react-0.8.0/tests/test_agent_catalog.py

@@ -0,0 +1,162 @@
+"""Feature-005 (silverpoint): the Reflex catalog export, ``reflex-catalog.json`` (Data Model §2.30).
+
+``scripts/export_catalog.py`` builds it from the package itself; silverpoint's agent catalog joins
+it by slug and JS prop name, and marks every Reflex entry stale when ``wraps`` is not its version.
+"""
+
+import importlib.metadata
+import importlib.util
+import json
+import warnings
+from pathlib import Path
+
+import pytest
+import reflex_silverpoint_react as sp
+
+ROOT = Path(__file__).resolve().parent.parent
+FIXTURES = Path(__file__).parent / "fixtures"
+
+
+def _load(name: str):
+    spec = importlib.util.spec_from_file_location(name, ROOT / "scripts" / f"{name}.py")
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+
+export_catalog = _load("export_catalog")
+
+
+@pytest.fixture(scope="module")
+def catalog() -> dict:
+    return export_catalog.build()
+
+
+def _builders(catalog: dict) -> set[str]:
+    return {c["builder"] for c in catalog["charts"]} | {c["builder"] for c in catalog["components"]}
+
+
+def test_req553_catalog_header(catalog):
+    assert catalog["schema"] == 1
+    assert catalog["package"] == "reflex-silverpoint-react"
+    assert catalog["version"] == importlib.metadata.version("reflex-silverpoint-react")
+    assert list(catalog) == ["schema", "package", "version", "wraps", "common", "charts", "components", "helpers"]
+
+
+def test_req556_wraps_is_silverpoint_version(catalog):
+    assert catalog["wraps"] == sp.SILVERPOINT_VERSION
+
+
+def test_req556_export_is_not_a_derived_pin(catalog):
+    # `derived` marks silverpoint's interim pin; the wrapper's own export never carries it.
+    assert "derived" not in catalog
+
+
+def test_req553_every_builder_in_all_is_present(catalog):
+    named = _builders(catalog) | set(catalog["helpers"]) | {"sp_trigger"}
+    lowercase = {name for name in sp.__all__ if name[0].islower()}
+    assert lowercase == named
+    assert {info.factory_name for info in sp.CHARTS} <= _builders(catalog)
+    assert {f"sp_{info.slug.replace('-', '_')}" for info in sp.UI_COMPONENTS} <= _builders(catalog)
+    assert not {name for name in catalog["helpers"] if name.startswith("sp_")}
+
+
+def test_req553_chart_slugs_match_silverpoint(catalog):
+    silverpoint = json.loads((FIXTURES / "silverpoint-slugs.json").read_text())
+    slugs = [c["slug"] for c in catalog["charts"]]
+    # The same 60 slugs; the order is each catalog's own (by family here, by phase there).
+    assert len(slugs) == len(set(slugs)) == 60
+    assert set(slugs) == set(silverpoint["charts"])
+
+
+def test_req553_component_slugs_match_silverpoint(catalog):
+    silverpoint = json.loads((FIXTURES / "silverpoint-slugs.json").read_text())
+    # Besides silverpoint's 38 components: the dashboard and the timeline (catalog entries of their
+    # own there) and the parts a component is built from, which Reflex exposes as builders.
+    parts = {"dashboard", "timeline", "avatar-group", "collapse-item", "tab-panel", "toaster"}
+    assert {c["slug"] for c in catalog["components"]} == set(silverpoint["components"]) | parts
+
+
+def test_req553_props_carry_python_and_js_names(catalog):
+    for entry in [*catalog["charts"], *catalog["components"]]:
+        names = [p["name"] for p in entry["props"]]
+        assert len(names) == len(set(names)), entry["slug"]
+        for prop in entry["props"]:
+            assert set(prop) == {"name", "js", "type"}
+            assert prop["name"] == prop["name"].lower(), prop
+    line = next(c for c in catalog["charts"] if c["slug"] == "line-chart")
+    assert {"name": "x_key", "js": "xKey", "type": "Accessor<string | number>"} in line["props"]
+    assert [p["name"] for p in catalog["common"]["chart"]][:2] == ["data", "ground"]
+    assert "palette" in {p["name"] for p in catalog["common"]["ui"]}
+
+
+def test_req553_drillable_charts_list_on_root_change(catalog):
+    # Declared on a private base class, so only the chart's PropDocs can name it.
+    event = {"name": "on_root_change", "js": "onRootChange", "type": "(id: string | null) => void"}
+    for slug in ("squarified-treemap", "sunburst-chart"):
+        chart = next(c for c in catalog["charts"] if c["slug"] == slug)
+        assert event in chart["props"], slug
+
+
+def test_req553_deprecated_arguments_are_listed(catalog):
+    deprecated = {c["builder"]: c["deprecated"] for c in catalog["components"] if c["deprecated"]}
+    assert deprecated == {
+        "sp_drawer": {"size": "extent"},
+        "sp_input_number": {"input_id": "id"},
+        "sp_popover": {"side_offset": "offset"},
+        "sp_textarea": {"textarea_id": "id"},
+        "sp_toast": {"action_alt": ""},
+        "sp_tooltip": {"side_offset": "offset"},
+    }
+
+
+#: What each builder needs besides the argument under test, and a value for it.
+_REQUIRED: dict[str, tuple[tuple, dict]] = {
+    "sp_popover": (("Body",), {"trigger": "Open"}),
+    "sp_tooltip": (("Hover", "Tip"), {}),
+    "sp_toast": (("Saved",), {}),
+}
+_VALUES = {"extent": 320, "id": "field", "offset": 9}
+
+
+@pytest.mark.parametrize(
+    ("builder", "old", "new"),
+    [(builder, old, new) for builder, names in export_catalog.DEPRECATED.items() for old, new in names.items()],
+)
+def test_req553_deprecated_arguments_still_mean_their_new_name(builder, old, new):
+    build = getattr(sp, builder)
+    args, kwargs = _REQUIRED.get(builder, ((), {}))
+    with warnings.catch_warnings():
+        warnings.simplefilter("ignore", DeprecationWarning)
+        if not new:  # ignored: the build is the same as without it
+            assert str(build(*args, **kwargs, **{old: "x"}).render()) == str(build(*args, **kwargs).render())
+            return
+        value = _VALUES[new]
+        old_render = build(*args, **kwargs, **{old: value}).render()
+        assert str(old_render) == str(build(*args, **kwargs, **{new: value}).render())
+
+
+def test_req553_export_equals_silverpoint_derived_pin(catalog):
+    """While the two agree: silverpoint's interim pin, read from this repository with ``ast``.
+
+    The pin (tests/fixtures/reflex-catalog.derived.json, silverpoint v0.8.0) was derived from 0.7.1
+    wrapping 0.7.0; its reader cannot see a builder's deprecated arguments, and its chart props came
+    from the PropDocs before they named the drill-down event.
+    """
+    pin = json.loads((FIXTURES / "reflex-catalog.derived.json").read_text())
+    derived = pin.pop("derived")
+    assert derived
+    ours = json.loads(json.dumps(catalog))
+    for entry in ours["components"]:
+        entry["deprecated"] = {}
+    for entry in ours["charts"]:
+        entry["props"] = [p for p in entry["props"] if p["name"] != "on_root_change"]
+    for key in ("version", "wraps"):
+        pin.pop(key)
+        ours.pop(key)
+    assert ours == pin
+
+
+def test_req553_committed_catalog_is_current(catalog):
+    committed = (ROOT / "reflex-catalog.json").read_text()
+    assert committed == export_catalog.dumps(catalog), "run: uv run python scripts/export_catalog.py"

{reflex_silverpoint_react-0.7.1 → reflex_silverpoint_react-0.8.0}/tests/test_components.py

@@ -10,7 +10,7 @@ def _props(component: rx.Component) -> dict[str, str]:
     return dict(prop.split(":", 1) for prop in rendered["props"])
 
 
-#: Every chart @silverpoint/react 0.7.0 exports, as its README lists them ("The 60 charts").
+#: Every chart @silverpoint/react 0.8.0 exports, as its README lists them ("The 60 charts").
 UPSTREAM_CHARTS_0_6 = {
     "LineChart", "StepChart", "SparklineRows", "KpiCard", "BarChart", "StackedBarChart",
     "ComposedChart", "WaterfallChart", "FunnelChart", "BulletChart", "PyramidChart",
@@ -105,9 +105,9 @@ def test_provider() -> None:
     assert _props(component)["locale"] == '"es-VE"'
 
 
-def test_version_pins_silverpoint_0_6() -> None:
-    assert sp.SILVERPOINT_VERSION == "0.7.0"
-    assert sp.SILVERPOINT_LIBRARY == "@silverpoint/react@0.7.0"
+def test_version_pins_silverpoint() -> None:
+    assert sp.SILVERPOINT_VERSION == "0.8.0"
+    assert sp.SILVERPOINT_LIBRARY == "@silverpoint/react@0.8.0"
 
 
 def test_cyanotype_ground() -> None:

{reflex_silverpoint_react-0.7.1 → reflex_silverpoint_react-0.8.0}/tests/test_demo_data.py

@@ -83,3 +83,26 @@ def test_drill_path_names_the_nodes_from_the_root() -> None:
     assert drill_path(BUDGET, parent["id"])[-1] == parent["name"]
     assert drill_path(BUDGET, parent["id"])[0] == root["name"]
     assert drill_path(BUDGET, "no-such-node") == [root["name"]]
+
+
+#: The first vite with the fixes for GHSA-587h-7wmj-h5pm, GHSA-r825-w8mm-5pxw and GHSA-698v-4r3x-3vcv.
+VITE_PATCHED = (8, 3, 3)
+
+
+def _version(spec: str) -> tuple[int, ...]:
+    return tuple(int(part) for part in spec.lstrip("^~=v").split("."))
+
+
+def test_demo_pins_a_patched_vite():
+    """The demo's config and its persisted package.json both pin a vite with the advisories fixed."""
+    import json
+
+    from reflex_base.constants.installer import PackageJson
+
+    demo = Path(__file__).resolve().parents[1] / "silverpoint_react_demo"
+    sys.path.insert(0, str(demo))
+    import rxconfig  # noqa: F401  (raises the framework pin)
+
+    assert _version(PackageJson.DEV_DEPENDENCIES["vite"]) >= VITE_PATCHED
+    persisted = json.loads((demo / "reflex.lock" / "package.json").read_text(encoding="utf-8"))
+    assert _version(persisted["devDependencies"]["vite"]) >= VITE_PATCHED

reflex_silverpoint_react-0.8.0/tests/test_plugin.py

@@ -0,0 +1,42 @@
+"""Feature-005 (silverpoint): the Claude plugin of this repository (T-248, REQ-555).
+
+One plugin, `reflex-silverpoint`: the skill and the hosted silverpoint MCP server, declared inline in
+`plugin.json` (a root `.mcp.json` would connect every session opened in this repository).
+"""
+
+import json
+import tomllib
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+PLUGIN_DIR = ROOT / ".claude-plugin"
+VERSION = tomllib.loads((ROOT / "pyproject.toml").read_text())["project"]["version"]
+
+
+def _read(name: str) -> dict:
+    return json.loads((PLUGIN_DIR / name).read_text())
+
+
+def test_req555_marketplace_lists_one_plugin_from_the_repository_root():
+    marketplace = _read("marketplace.json")
+    assert marketplace["name"] == "reflex-silverpoint"
+    [plugin] = marketplace["plugins"]
+    assert plugin["name"] == "reflex-silverpoint"
+    assert plugin["source"] == "./"
+
+
+def test_req555_plugin_holds_the_skill_and_the_hosted_server():
+    plugin = _read("plugin.json")
+    assert plugin["name"] == "reflex-silverpoint"
+    assert plugin["skills"] == ["./skills/reflex-silverpoint"]
+    assert (ROOT / "skills" / "reflex-silverpoint" / "SKILL.md").is_file()
+    assert plugin["mcpServers"] == {"silverpoint": {"type": "http", "url": "https://silverpointweb.vercel.app/mcp"}}
+
+
+def test_req555_no_root_mcp_json():
+    assert not (ROOT / ".mcp.json").exists()
+
+
+def test_req555_plugin_versions_are_the_package_version():
+    assert _read("plugin.json")["version"] == VERSION
+    assert [p["version"] for p in _read("marketplace.json")["plugins"]] == [VERSION]

reflex_silverpoint_react-0.8.0/tests/test_skill.py

@@ -0,0 +1,170 @@
+"""Feature-005 (silverpoint): the `reflex-silverpoint` skill (T-246) and its examples check (T-247).
+
+``scripts/make_skill.py`` writes ``skills/reflex-silverpoint/`` from the hand-written templates and
+``reflex-catalog.json``. Every ``python`` fence of the skill is imported and the components it builds
+are rendered (REQ-557); every other fence is prose.
+"""
+
+import ast
+import importlib.util
+import inspect
+import json
+import re
+import sys
+from pathlib import Path
+
+import pytest
+import reflex as rx
+
+ROOT = Path(__file__).resolve().parent.parent
+SKILL = ROOT / "skills" / "reflex-silverpoint"
+FIXTURES = Path(__file__).parent / "fixtures"
+
+_spec = importlib.util.spec_from_file_location("make_skill", ROOT / "scripts" / "make_skill.py")
+make_skill = importlib.util.module_from_spec(_spec)
+_spec.loader.exec_module(make_skill)
+
+CATALOG = json.loads((ROOT / "reflex-catalog.json").read_text())
+DESCRIPTION = (
+    "Build silverpoint charts, dashboards and UI in Python with Reflex through reflex-silverpoint-react. "
+    "Use whenever code imports reflex_silverpoint_react or the user wants silverpoint in Reflex."
+)
+
+
+def _files() -> dict[str, str]:
+    return {str(p.relative_to(SKILL)): p.read_text() for p in sorted(SKILL.rglob("*.md")) if "templates" not in p.parts}
+
+
+# ── Layout and contents ─────────────────────────────────────────────────────────────────
+
+
+def test_req553_skill_is_current():
+    assert make_skill.render() == _files(), "run: uv run python scripts/make_skill.py"
+
+
+def test_req553_skill_layout():
+    families = [f["slug"] for f in json.loads((FIXTURES / "silverpoint-slugs.json").read_text())["families"]]
+    expected = {"SKILL.md", *(f"references/charts/{slug}.md" for slug in families)}
+    expected |= {
+        f"references/{name}.md"
+        for name in ("components", "overlays", "timeline", "dashboard", "palettes", "state-and-events")
+    }
+    assert set(_files()) == expected
+
+
+def test_req554_skill_md_frontmatter_and_length():
+    text = (SKILL / "SKILL.md").read_text()
+    assert text.startswith(f"---\nname: reflex-silverpoint\ndescription: {DESCRIPTION}\n---\n")
+    assert len(text.splitlines()) < 500
+
+
+def test_req554_every_file_names_the_version_it_describes():
+    stamp = f"reflex-silverpoint-react {CATALOG['version']}"
+    for path, text in _files().items():
+        assert stamp in text, path
+        assert f"silverpoint {CATALOG['wraps']}" in text, path
+
+
+def test_req554_skill_prefers_the_mcp_tools():
+    text = (SKILL / "SKILL.md").read_text()
+    assert "## Prefer the silverpoint MCP tools when they are connected" in text
+    assert "https://silverpointweb.vercel.app/mcp" in text
+
+
+def test_req553_every_builder_and_helper_is_documented():
+    text = "\n".join(_files().values())
+    for name in [c["builder"] for c in CATALOG["charts"] + CATALOG["components"]] + CATALOG["helpers"]:
+        assert f"`{name}`" in text, name
+
+
+def test_req553_chart_props_tables_list_python_and_js_names():
+    lines = (SKILL / "references" / "charts" / "lines.md").read_text()
+    assert "| `x_key` | `xKey` | `Accessor<string \\| number>` |" in lines
+    assert "<!-- generated:family -->" in lines and "<!-- /generated:family -->" in lines
+
+
+def test_req547_overlay_triggers_are_never_sp_button():
+    # The prose names the mistake; no example may make it.
+    for name, code in make_skill.extract_examples(_files()):
+        assert not re.search(r"trigger\s*=\s*sp_button", code), name
+    assert "Never `trigger=sp_button(...)`" in (SKILL / "SKILL.md").read_text()
+
+
+# ── Examples (REQ-557) ──────────────────────────────────────────────────────────────────
+
+
+def test_req557_extract_refuses_a_fence_that_is_neither_python_nor_prose():
+    with pytest.raises(ValueError, match="tsx"):
+        make_skill.extract_examples({"x.md": "```tsx\n<LineChart />\n```\n"})
+    with pytest.raises(ValueError, match="language"):
+        make_skill.extract_examples({"x.md": "```\nplain\n```\n"})
+    assert make_skill.extract_examples({"x.md": "```sh\npip install x\n```\n```json\n[]\n```\n"}) == []
+    found = make_skill.extract_examples({"a/b.md": "```python\nx = 1\n```\n"})
+    assert found == [("a-b-1", "x = 1\n")]
+
+
+EXAMPLES = make_skill.extract_examples(_files())
+
+
+def test_req557_the_skill_has_python_examples():
+    assert len(EXAMPLES) >= 60 + 10
+
+
+def _components(module) -> list[rx.Component]:
+    """Every component the example builds: module-level ones, and what its views return."""
+    found = [v for v in vars(module).values() if isinstance(v, rx.Component)]
+    for fn in vars(module).values():
+        is_view = inspect.isfunction(fn) and fn.__module__ == module.__name__ and not fn.__name__.startswith("_")
+        if is_view and all(p.default is not p.empty for p in inspect.signature(fn).parameters.values()):
+            result = fn()
+            if isinstance(result, rx.Component):
+                found.append(result)
+    return found
+
+
+#: Props Reflex gives every component, besides those the catalog lists.
+_REFLEX_PROPS = {"id", "class_name", "style", "key", "custom_attrs", "on_click"}
+
+
+def _allowed() -> dict[str, set[str]]:
+    chart = {p["name"] for p in CATALOG["common"]["chart"]} | _REFLEX_PROPS
+    ui = {p["name"] for p in CATALOG["common"]["ui"]} | _REFLEX_PROPS
+    allowed = {c["builder"]: {p["name"] for p in c["props"]} | chart for c in CATALOG["charts"]}
+    allowed |= {c["builder"]: {p["name"] for p in c["props"]} | ui for c in CATALOG["components"]}
+    return allowed
+
+
+@pytest.mark.parametrize(("name", "code"), EXAMPLES, ids=[name for name, _ in EXAMPLES])
+def test_req557_python_example_names_only_catalog_props(name, code):
+    # Reflex passes an unknown keyword through to the npm component without a word, so rendering
+    # alone does not catch a misspelt prop: every keyword of a builder call must be in the catalog.
+    allowed = _allowed()
+    tree = ast.parse(code)
+    imported = {
+        alias.asname or alias.name: alias.name
+        for node in ast.walk(tree)
+        if isinstance(node, ast.ImportFrom) and node.module == "reflex_silverpoint_react"
+        for alias in node.names
+    }
+    for node in ast.walk(tree):
+        if isinstance(node, ast.Call) and isinstance(node.func, ast.Name) and imported.get(node.func.id) in allowed:
+            builder = imported[node.func.id]
+            for keyword in node.keywords:
+                assert keyword.arg is None or keyword.arg in allowed[builder], f"{builder} takes no {keyword.arg}"
+
+
+@pytest.mark.parametrize(("name", "code"), EXAMPLES, ids=[name for name, _ in EXAMPLES])
+def test_req557_python_example_imports_and_renders(name, code, tmp_path):
+    path = tmp_path / f"skill_{name.replace('-', '_')}.py"
+    path.write_text(code)
+    spec = importlib.util.spec_from_file_location(path.stem, path)
+    module = importlib.util.module_from_spec(spec)
+    sys.modules[path.stem] = module
+    try:
+        spec.loader.exec_module(module)
+        components = _components(module)
+        assert components, f"{name} builds no component"
+        for component in components:
+            assert component.render()
+    finally:
+        sys.modules.pop(path.stem, None)

{reflex_silverpoint_react-0.7.1 → reflex_silverpoint_react-0.8.0}/tests/test_v07.py

@@ -46,9 +46,11 @@ class _S(rx.State):
 # ── Version ─────────────────────────────────────────────────────────────────────────────
 
 
-def test_wraps_silverpoint_0_7_0() -> None:
-    assert sp.SILVERPOINT_VERSION == "0.7.0"
-    assert sp.SILVERPOINT_LIBRARY == "@silverpoint/react@0.7.0"
+def test_wraps_silverpoint_0_8_0() -> None:
+    # 0.8.0 changed no API of @silverpoint/react, core, grounds or fonts (agent access: the MCP
+    # server and the skills); only their versions moved.
+    assert sp.SILVERPOINT_VERSION == "0.8.0"
+    assert sp.SILVERPOINT_LIBRARY == "@silverpoint/react@0.8.0"
 
 
 # ── Palettes ────────────────────────────────────────────────────────────────────────────