param update

Author: MarcSkovMadsen

pyproject.toml

@@ -189,6 +189,16 @@ python_version = '3.11'
 no_implicit_optional = true
 check_untyped_defs = true
 
+# The apps/ package contains demo/dev Panel tools built on param.Parameterized.
+# param 2.4.0 ships inline type hints that turn Parameter objects into generic
+# descriptors (param#1147). For these demo apps that produces noise:
+#   - assignment: reassigning an inherited Boolean param at class level
+#     (e.g. ``pn.pane.Markdown.disable_anchors = True``) now mismatches Boolean[bool]
+# These are silenced only here; union-attr and other checks stay enabled.
+[[tool.mypy.overrides]]
+module = "holoviz_mcp.apps.*"
+disable_error_code = ["assignment"]
+
 [tool.hatch.build.targets.wheel.force-include]
 "skills" = "holoviz_mcp/skills"
 

src/holoviz_mcp/apps/configuration_viewer.py

@@ -8,6 +8,7 @@
 """
 
 import json
+from typing import Literal
 
 import panel as pn
 import panel_material_ui as pmui
@@ -31,7 +32,9 @@ class ConfigViewer(param.Parameterized):
         - Supports dark and light themes
     """
 
-    config_source = param.Selector(objects=["Combined", "Default", "User"], default="Combined", doc="Which configuration to show")
+    config_source: Literal["Combined", "Default", "User"] = param.Selector(
+        objects=["Combined", "Default", "User"], default="Combined", doc="Which configuration to show"
+    )
     dark_theme = param.Boolean(default=False, doc="Use dark theme for the JSON editor", allow_refs=True)
 
     def __init__(self, **params):

src/holoviz_mcp/apps/hv_get.py

@@ -1,5 +1,7 @@
 """An app to retrieve HoloViews element documentation via the hv_get tool."""
 
+from typing import Literal
+
 import panel as pn
 import panel_material_ui as pmui
 import param
@@ -36,8 +38,8 @@
 class GetDocstringConfiguration(param.Parameterized):
     """Configuration for the HoloViews get_docstring tool."""
 
-    element = param.Selector(default="", objects=[""], label="Element")
-    backend = param.Selector(default="bokeh", objects=["bokeh", "matplotlib", "plotly"], label="Backend")
+    element: str = param.Selector(default="", objects=[""], label="Element")
+    backend: Literal["bokeh", "matplotlib", "plotly"] = param.Selector(default="bokeh", objects=["bokeh", "matplotlib", "plotly"], label="Backend")
 
     result = param.String(default="", doc="Docstring result")
     loading = param.Boolean(default=False, doc="Loading state")

src/holoviz_mcp/apps/hvplot_get.py

@@ -58,10 +58,10 @@
 class GetDocstringConfiguration(param.Parameterized):
     """Configuration for hvPlot hvplot_get tool."""
 
-    plot_type = param.Selector(default="line", objects=["line"], label="Plot Type")
+    plot_type: str = param.Selector(default="line", objects=["line"], label="Plot Type")
     docstring = param.Boolean(default=True, label="Include Docstring")
     generic = param.Boolean(default=True, label="Include Generic Options")
-    style = param.Selector(default=True, objects=[True, "matplotlib", "bokeh", "plotly"], label="Style Backend")
+    style: bool | str = param.Selector(default=True, objects=[True, "matplotlib", "bokeh", "plotly"], label="Style Backend")
 
     result = param.String(default="", doc="Docstring result")
     loading = param.Boolean(default=False, doc="Loading state")

src/holoviz_mcp/apps/pn_get.py

@@ -80,7 +80,7 @@ class GetComponentConfiguration(param.Parameterized):
 
     component_name = param.String(default="Button", label="Component Name")
     module_path = param.String(default="", label="Module Path")
-    package = param.Selector(default="panel", objects=[ALL, "panel"], label="Package")
+    package: str = param.Selector(default="panel", objects=[ALL, "panel"], label="Package")
 
     get_component = param.Event(label="Get Component")
 

src/holoviz_mcp/apps/pn_list.py

@@ -60,11 +60,11 @@ class ListComponentsConfiguration(param.Parameterized):
 
     component_name = param.String(default="Button", label="Component Name")
     module_path = param.String(default="", label="Module Path")
-    package = param.Selector(default=ALL, objects=[ALL], label="Package")
+    package: str = param.Selector(default=ALL, objects=[ALL], label="Package")
 
     list_components = param.Event(label="List Components")
 
-    results = param.List(default=[], doc="List results")
+    results: list = param.List(default=[], doc="List results")
     loading = param.Boolean(default=False, doc="Loading state")
     error_message = param.String(default="", doc="Error message if listing fails")
 
@@ -118,7 +118,7 @@ async def _update_results(self):
 class ComponentsListViewer(pn.viewable.Viewer):
     """Viewer for displaying component list as a table."""
 
-    results = param.List(default=[], allow_refs=True, doc="List of components")
+    results: list = param.List(default=[], allow_refs=True, doc="List of components")
 
     data = param.DataFrame(doc="DataFrame of components")
 

src/holoviz_mcp/apps/pn_params.py

@@ -96,7 +96,7 @@ class GetComponentParametersConfiguration(param.Parameterized):
 
     component_name = param.String(default="Button", label="Component Name")
     module_path = param.String(default="", label="Module Path")
-    package = param.Selector(default="panel", objects=[ALL, "panel"], label="Package")
+    package: str = param.Selector(default="panel", objects=[ALL, "panel"], label="Package")
 
     get_parameters = param.Event(label="Get Parameters")
 

src/holoviz_mcp/apps/pn_search.py

@@ -53,12 +53,12 @@ class SearchConfiguration(param.Parameterized):
     """Configuration for Panel component search tool."""
 
     query = param.String(default="Button", label="Search Query")
-    package = param.Selector(default=ALL, objects=[ALL], label="Package")
+    package: str = param.Selector(default=ALL, objects=[ALL], label="Package")
     limit = param.Integer(default=10, bounds=(1, 50), label="Max Results")
 
     search = param.Event(label="Search")
 
-    results = param.List(default=[], doc="Search results")
+    results: list = param.List(default=[], doc="Search results")
     loading = param.Boolean(default=False, doc="Loading state")
     error_message = param.String(default="", doc="Error message if search fails")
 
@@ -114,7 +114,7 @@ async def _update_results(self):
 class SearchResultsViewer(pn.viewable.Viewer):
     """Viewer for displaying search results as a menu list."""
 
-    results = param.List(default=[], allow_refs=True, doc="List of search results")
+    results: list = param.List(default=[], allow_refs=True, doc="List of search results")
 
     data = param.DataFrame(doc="DataFrame of search results")
 

src/holoviz_mcp/apps/search.py

@@ -1,5 +1,7 @@
 """A search application for exploring the HoloViz MCP search tool."""
 
+from typing import Literal
+
 import panel as pn
 import panel_material_ui as pmui
 import param
@@ -99,15 +101,15 @@ class SearchConfiguration(param.Parameterized):
 
     query = param.String(default="What is HoloViz?", doc="Search text for semantic similarity search across the documentation")
 
-    project = param.Selector(
+    project: str = param.Selector(
         default=ALL,
         objects=[ALL, "panel", "hvplot", "datashader", "holoviews", "geoviews", "param", "colorcet", "holoviz"],
         doc="Filter results to a specific project. Select 'all' for all projects.",
     )
 
     max_results = param.Integer(default=5, bounds=(1, 50), doc="Maximum number of search results to return")
 
-    content = param.Selector(
+    content: Literal["truncated", "chunk", "full", "none"] = param.Selector(
         default="truncated",
         objects=["truncated", "chunk", "full", "none"],
         doc='Controls what content is returned. "truncated": full doc smart-truncated around query keywords (default). '
@@ -293,7 +295,10 @@ class SearchApp(pn.viewable.Viewer):
     """
 
     title = param.String(default="HoloViz MCP - search Tool Demo", doc="Title of the search app")
-    config = param.ClassSelector(class_=SearchConfiguration, doc="Configuration for the search app")
+    # Annotated as non-optional (always set in __init__) so param 2.4.0's generic
+    # ClassSelector descriptor does not infer ``SearchConfiguration | None`` and
+    # trigger union-attr errors on ``self.config.param``.
+    config: SearchConfiguration = param.ClassSelector(class_=SearchConfiguration, doc="Configuration for the search app")
 
     def __init__(self, **params):
         """Initialize the SearchApp with default configuration."""

src/holoviz_mcp/apps/skill_get.py

@@ -54,7 +54,7 @@ class SkillConfiguration(param.Parameterized):
     Parameters correspond to the skill selection for viewing skills.
     """
 
-    skill = param.Selector(
+    skill: str | None = param.Selector(
         default=None,
         objects=[],
         doc="Select a skill to view its details",