fix: icon type auto-generation and normalization

plugins/ui/README.md

@@ -73,4 +73,14 @@ python make_docs.py
 ```
 
 The files will be built into `docs/build/markdown`.
-Note that these built files should not be committed to the repository.
+Note that these built files should not be committed to the repository.
+
+## Update Icon Types
+Available IconTypes can be generated automatically using icon TypeScript definitions in node_modules.
+
+Writes to `icon_types.py`. 
+
+```shell
+cd plugins/ui
+python make_docs.py
+```

plugins/ui/make_icon_types.py

@@ -0,0 +1,30 @@
+relative_path = "./src/js/node_modules/@deephaven/icons/dist/index.d.ts"
+
+icons = []
+with open(relative_path, "r") as file:
+    content = file.read()
+    words = content.split()
+    for word in words:
+        index = words.index(word)
+        if index < len(words) - 1:
+            next_word = words[index + 1]
+            if next_word == "IconDefinition;":
+                icon = word[:-1]
+                icons.append(icon)
+
+output_file_path = "./src/deephaven/ui/components/types/icon_types.py"
+
+with open(output_file_path, "w") as output_file:
+    output_file.truncate(0)
+
+    output_file.write(
+        "from __future__ import annotations"
+        + "\n"
+        + "from typing import Literal"
+        + "\n\n"
+    )
+    output_file.write("Icons = Literal[" + "\n")
+    for icon in icons:
+        output_file.write('    "' + icon + '"\n')
+
+    output_file.write("]" + "\n")

plugins/ui/src/deephaven/ui/components/icon.py

@@ -10,12 +10,13 @@
     Position,
     IconSize,
     IconColor,
+    IconTypes,
 )
 from .._internal.utils import create_props
 
 
 def icon(
-    name: str,
+    name: IconTypes,
     size: IconSize | None = None,
     color: IconColor | None = None,
     flex: LayoutFlex | None = None,

plugins/ui/src/deephaven/ui/components/types/__init__.py

@@ -4,3 +4,4 @@
 from .events import *
 from .layout import *
 from .validate import *
+from .icon_types import *