h2o-wave 1.0.2__py3-none-macosx_10_9_x86_64.whl → 1.1.1__py3-none-macosx_10_9_x86_64.whl

h2o_wave/cli.py

@@ -132,6 +132,10 @@ def run(app: str, no_reload: bool, no_autostart: bool):
     # uvicorn.main() does this before calling uvicorn.run().
     sys.path.insert(0, '.')
 
+    # Allow relative paths from bash autocomplete. E.g. wave run ./foo.py
+    if app.startswith(f'.{os.path.sep}'):
+        app = app[2:]
+
     # DevX: treat foo/bar/baz.py as foo.bar.baz
     app_path, ext = os.path.splitext(app)
     if ext.lower() == '.py':
@@ -150,6 +154,7 @@ def run(app: str, no_reload: bool, no_autostart: bool):
     waved_path = os.path.join(sys.exec_prefix, 'waved.exe' if IS_WINDOWS else 'waved')
     # OS agnostic wheels do not include waved - needed for HAC.
     is_waved_present = os.path.isfile(waved_path)
+    is_auto_started = server_not_running
 
     try:
         if autostart and is_waved_present and server_not_running:
@@ -171,7 +176,7 @@ def run(app: str, no_reload: bool, no_autostart: bool):
             print('Could not connect to Wave server. Please start the Wave server (waved or waved.exe) prior to running any app.')
             return
 
-        if not os.environ.get('H2O_WAVE_WAVED_DIR') and is_waved_present:
+        if not os.environ.get('H2O_WAVE_WAVED_DIR') and is_auto_started:
             os.environ['H2O_WAVE_WAVED_DIR'] = sys.exec_prefix
         reload_exclude = os.environ.get('H2O_WAVE_RELOAD_EXCLUDE', None)
         if reload_exclude:

h2o_wave/types.py

@@ -160,6 +160,8 @@ class Command:
             icon: Optional[str] = None,
             items: Optional[List['Command']] = None,
             value: Optional[str] = None,
+            path: Optional[str] = None,
+            download: Optional[bool] = None,
     ):
         _guard_scalar('Command.name', name, (str,), True, False, False)
         _guard_scalar('Command.label', label, (str,), False, True, False)
@@ -167,6 +169,8 @@ class Command:
         _guard_scalar('Command.icon', icon, (str,), False, True, False)
         _guard_vector('Command.items', items, (Command,), False, True, False)
         _guard_scalar('Command.value', value, (str,), False, True, False)
+        _guard_scalar('Command.path', path, (str,), False, True, False)
+        _guard_scalar('Command.download', download, (bool,), False, True, False)
         self.name = name
         """An identifying name for this component. If the name is prefixed with a '#', the command sets the location hash to the name when executed."""
         self.label = label
@@ -179,6 +183,10 @@ class Command:
         """Sub-commands, if any"""
         self.value = value
         """Data associated with this command, if any."""
+        self.path = path
+        """The path or URL to link to. The 'items' and 'value' props are ignored when specified."""
+        self.download = download
+        """True if the link should prompt the user to save the linked URL instead of navigating to it."""
 
     def dump(self) -> Dict:
         """Returns the contents of this object as a dict."""
@@ -188,6 +196,8 @@ class Command:
         _guard_scalar('Command.icon', self.icon, (str,), False, True, False)
         _guard_vector('Command.items', self.items, (Command,), False, True, False)
         _guard_scalar('Command.value', self.value, (str,), False, True, False)
+        _guard_scalar('Command.path', self.path, (str,), False, True, False)
+        _guard_scalar('Command.download', self.download, (bool,), False, True, False)
         return _dump(
             name=self.name,
             label=self.label,
@@ -195,6 +205,8 @@ class Command:
             icon=self.icon,
             items=None if self.items is None else [__e.dump() for __e in self.items],
             value=self.value,
+            path=self.path,
+            download=self.download,
         )
 
     @staticmethod
@@ -212,12 +224,18 @@ class Command:
         _guard_vector('Command.items', __d_items, (dict,), False, True, False)
         __d_value: Any = __d.get('value')
         _guard_scalar('Command.value', __d_value, (str,), False, True, False)
+        __d_path: Any = __d.get('path')
+        _guard_scalar('Command.path', __d_path, (str,), False, True, False)
+        __d_download: Any = __d.get('download')
+        _guard_scalar('Command.download', __d_download, (bool,), False, True, False)
         name: str = __d_name
         label: Optional[str] = __d_label
         caption: Optional[str] = __d_caption
         icon: Optional[str] = __d_icon
         items: Optional[List['Command']] = None if __d_items is None else [Command.load(__e) for __e in __d_items]
         value: Optional[str] = __d_value
+        path: Optional[str] = __d_path
+        download: Optional[bool] = __d_download
         return Command(
             name,
             label,
@@ -225,6 +243,8 @@ class Command:
             icon,
             items,
             value,
+            path,
+            download,
         )
 
 
@@ -969,6 +989,15 @@ class MessageBar:
         )
 
 
+_TextboxType = ['text', 'number', 'tel']
+
+
+class TextboxType:
+    TEXT = 'text'
+    NUMBER = 'number'
+    TEL = 'tel'
+
+
 class Textbox:
     """Create a text box.
 
@@ -998,6 +1027,7 @@ class Textbox:
             visible: Optional[bool] = None,
             tooltip: Optional[str] = None,
             spellcheck: Optional[bool] = None,
+            type: Optional[str] = None,
     ):
         _guard_scalar('Textbox.name', name, (str,), True, False, False)
         _guard_scalar('Textbox.label', label, (str,), False, True, False)
@@ -1019,6 +1049,7 @@ class Textbox:
         _guard_scalar('Textbox.visible', visible, (bool,), False, True, False)
         _guard_scalar('Textbox.tooltip', tooltip, (str,), False, True, False)
         _guard_scalar('Textbox.spellcheck', spellcheck, (bool,), False, True, False)
+        _guard_enum('Textbox.type', type, _TextboxType, True)
         self.name = name
         """An identifying name for this component."""
         self.label = label
@@ -1059,6 +1090,8 @@ class Textbox:
         """An optional tooltip message displayed when a user clicks the help icon to the right of the component."""
         self.spellcheck = spellcheck
         """True if the text may be checked for spelling errors. Defaults to True."""
+        self.type = type
+        """Keyboard to be shown on mobile devices. Defaults to 'text'. One of 'text', 'number', 'tel'. See enum h2o_wave.ui.TextboxType."""
 
     def dump(self) -> Dict:
         """Returns the contents of this object as a dict."""
@@ -1082,6 +1115,7 @@ class Textbox:
         _guard_scalar('Textbox.visible', self.visible, (bool,), False, True, False)
         _guard_scalar('Textbox.tooltip', self.tooltip, (str,), False, True, False)
         _guard_scalar('Textbox.spellcheck', self.spellcheck, (bool,), False, True, False)
+        _guard_enum('Textbox.type', self.type, _TextboxType, True)
         return _dump(
             name=self.name,
             label=self.label,
@@ -1103,6 +1137,7 @@ class Textbox:
             visible=self.visible,
             tooltip=self.tooltip,
             spellcheck=self.spellcheck,
+            type=self.type,
         )
 
     @staticmethod
@@ -1148,6 +1183,8 @@ class Textbox:
         _guard_scalar('Textbox.tooltip', __d_tooltip, (str,), False, True, False)
         __d_spellcheck: Any = __d.get('spellcheck')
         _guard_scalar('Textbox.spellcheck', __d_spellcheck, (bool,), False, True, False)
+        __d_type: Any = __d.get('type')
+        _guard_enum('Textbox.type', __d_type, _TextboxType, True)
         name: str = __d_name
         label: Optional[str] = __d_label
         placeholder: Optional[str] = __d_placeholder
@@ -1168,6 +1205,7 @@ class Textbox:
         visible: Optional[bool] = __d_visible
         tooltip: Optional[str] = __d_tooltip
         spellcheck: Optional[bool] = __d_spellcheck
+        type: Optional[str] = __d_type
         return Textbox(
             name,
             label,
@@ -1189,6 +1227,7 @@ class Textbox:
             visible,
             tooltip,
             spellcheck,
+            type,
         )
 
 
@@ -5823,12 +5862,14 @@ class Stat:
             caption: Optional[str] = None,
             icon: Optional[str] = None,
             icon_color: Optional[str] = None,
+            name: Optional[str] = None,
     ):
         _guard_scalar('Stat.label', label, (str,), False, False, False)
         _guard_scalar('Stat.value', value, (str,), False, True, False)
         _guard_scalar('Stat.caption', caption, (str,), False, True, False)
         _guard_scalar('Stat.icon', icon, (str,), False, True, False)
         _guard_scalar('Stat.icon_color', icon_color, (str,), False, True, False)
+        _guard_scalar('Stat.name', name, (str,), False, True, False)
         self.label = label
         """The label for the metric."""
         self.value = value
@@ -5839,6 +5880,8 @@ class Stat:
         """An optional icon, displayed next to the label."""
         self.icon_color = icon_color
         """The color of the icon."""
+        self.name = name
+        """An identifying name for this item."""
 
     def dump(self) -> Dict:
         """Returns the contents of this object as a dict."""
@@ -5847,12 +5890,14 @@ class Stat:
         _guard_scalar('Stat.caption', self.caption, (str,), False, True, False)
         _guard_scalar('Stat.icon', self.icon, (str,), False, True, False)
         _guard_scalar('Stat.icon_color', self.icon_color, (str,), False, True, False)
+        _guard_scalar('Stat.name', self.name, (str,), False, True, False)
         return _dump(
             label=self.label,
             value=self.value,
             caption=self.caption,
             icon=self.icon,
             icon_color=self.icon_color,
+            name=self.name,
         )
 
     @staticmethod
@@ -5868,17 +5913,21 @@ class Stat:
         _guard_scalar('Stat.icon', __d_icon, (str,), False, True, False)
         __d_icon_color: Any = __d.get('icon_color')
         _guard_scalar('Stat.icon_color', __d_icon_color, (str,), False, True, False)
+        __d_name: Any = __d.get('name')
+        _guard_scalar('Stat.name', __d_name, (str,), False, True, False)
         label: str = __d_label
         value: Optional[str] = __d_value
         caption: Optional[str] = __d_caption
         icon: Optional[str] = __d_icon
         icon_color: Optional[str] = __d_icon_color
+        name: Optional[str] = __d_name
         return Stat(
             label,
             value,
             caption,
             icon,
             icon_color,
+            name,
         )
 
 
@@ -5903,12 +5952,14 @@ class Stats:
             inset: Optional[bool] = None,
             width: Optional[str] = None,
             visible: Optional[bool] = None,
+            name: Optional[str] = None,
     ):
         _guard_vector('Stats.items', items, (Stat,), False, False, False)
         _guard_enum('Stats.justify', justify, _StatsJustify, True)
         _guard_scalar('Stats.inset', inset, (bool,), False, True, False)
         _guard_scalar('Stats.width', width, (str,), False, True, False)
         _guard_scalar('Stats.visible', visible, (bool,), False, True, False)
+        _guard_scalar('Stats.name', name, (str,), False, True, False)
         self.items = items
         """The individual stats to be displayed."""
         self.justify = justify
@@ -5919,6 +5970,8 @@ class Stats:
         """The width of the stats, e.g. '100px'."""
         self.visible = visible
         """True if the component should be visible. Defaults to True."""
+        self.name = name
+        """An identifying name for this component."""
 
     def dump(self) -> Dict:
         """Returns the contents of this object as a dict."""
@@ -5927,12 +5980,14 @@ class Stats:
         _guard_scalar('Stats.inset', self.inset, (bool,), False, True, False)
         _guard_scalar('Stats.width', self.width, (str,), False, True, False)
         _guard_scalar('Stats.visible', self.visible, (bool,), False, True, False)
+        _guard_scalar('Stats.name', self.name, (str,), False, True, False)
         return _dump(
             items=[__e.dump() for __e in self.items],
             justify=self.justify,
             inset=self.inset,
             width=self.width,
             visible=self.visible,
+            name=self.name,
         )
 
     @staticmethod
@@ -5948,17 +6003,21 @@ class Stats:
         _guard_scalar('Stats.width', __d_width, (str,), False, True, False)
         __d_visible: Any = __d.get('visible')
         _guard_scalar('Stats.visible', __d_visible, (bool,), False, True, False)
+        __d_name: Any = __d.get('name')
+        _guard_scalar('Stats.name', __d_name, (str,), False, True, False)
         items: List[Stat] = [Stat.load(__e) for __e in __d_items]
         justify: Optional[str] = __d_justify
         inset: Optional[bool] = __d_inset
         width: Optional[str] = __d_width
         visible: Optional[bool] = __d_visible
+        name: Optional[str] = __d_name
         return Stats(
             items,
             justify,
             inset,
             width,
             visible,
+            name,
         )
 
 
@@ -7054,12 +7113,14 @@ class CopyableText:
             name: Optional[str] = None,
             multiline: Optional[bool] = None,
             height: Optional[str] = None,
+            width: Optional[str] = None,
     ):
         _guard_scalar('CopyableText.value', value, (str,), False, False, False)
         _guard_scalar('CopyableText.label', label, (str,), False, False, False)
         _guard_scalar('CopyableText.name', name, (str,), False, True, False)
         _guard_scalar('CopyableText.multiline', multiline, (bool,), False, True, False)
         _guard_scalar('CopyableText.height', height, (str,), False, True, False)
+        _guard_scalar('CopyableText.width', width, (str,), False, True, False)
         self.value = value
         """Text to be displayed inside the component."""
         self.label = label
@@ -7070,6 +7131,8 @@ class CopyableText:
         """True if the component should allow multi-line text entry."""
         self.height = height
         """Custom height in px (e.g. '200px') or '1' to fill the remaining card space. Requires `multiline` to be set."""
+        self.width = width
+        """The width of the copyable text , e.g. '100px'."""
 
     def dump(self) -> Dict:
         """Returns the contents of this object as a dict."""
@@ -7078,12 +7141,14 @@ class CopyableText:
         _guard_scalar('CopyableText.name', self.name, (str,), False, True, False)
         _guard_scalar('CopyableText.multiline', self.multiline, (bool,), False, True, False)
         _guard_scalar('CopyableText.height', self.height, (str,), False, True, False)
+        _guard_scalar('CopyableText.width', self.width, (str,), False, True, False)
         return _dump(
             value=self.value,
             label=self.label,
             name=self.name,
             multiline=self.multiline,
             height=self.height,
+            width=self.width,
         )
 
     @staticmethod
@@ -7099,17 +7164,21 @@ class CopyableText:
         _guard_scalar('CopyableText.multiline', __d_multiline, (bool,), False, True, False)
         __d_height: Any = __d.get('height')
         _guard_scalar('CopyableText.height', __d_height, (str,), False, True, False)
+        __d_width: Any = __d.get('width')
+        _guard_scalar('CopyableText.width', __d_width, (str,), False, True, False)
         value: str = __d_value
         label: str = __d_label
         name: Optional[str] = __d_name
         multiline: Optional[bool] = __d_multiline
         height: Optional[str] = __d_height
+        width: Optional[str] = __d_width
         return CopyableText(
             value,
             label,
             name,
             multiline,
             height,
+            width,
         )
 
 
@@ -8206,6 +8275,65 @@ class ChatCard:
         )
 
 
+class ChatSuggestion:
+    """Create a chat prompt suggestion displayed as button below the last response in the chatbot component.
+    """
+    def __init__(
+            self,
+            name: str,
+            label: str,
+            caption: Optional[str] = None,
+            icon: Optional[str] = None,
+    ):
+        _guard_scalar('ChatSuggestion.name', name, (str,), True, False, False)
+        _guard_scalar('ChatSuggestion.label', label, (str,), False, False, False)
+        _guard_scalar('ChatSuggestion.caption', caption, (str,), False, True, False)
+        _guard_scalar('ChatSuggestion.icon', icon, (str,), False, True, False)
+        self.name = name
+        """An identifying name for this component."""
+        self.label = label
+        """The text displayed for this suggestion."""
+        self.caption = caption
+        """The caption displayed below the label."""
+        self.icon = icon
+        """The icon to be displayed for this suggestion."""
+
+    def dump(self) -> Dict:
+        """Returns the contents of this object as a dict."""
+        _guard_scalar('ChatSuggestion.name', self.name, (str,), True, False, False)
+        _guard_scalar('ChatSuggestion.label', self.label, (str,), False, False, False)
+        _guard_scalar('ChatSuggestion.caption', self.caption, (str,), False, True, False)
+        _guard_scalar('ChatSuggestion.icon', self.icon, (str,), False, True, False)
+        return _dump(
+            name=self.name,
+            label=self.label,
+            caption=self.caption,
+            icon=self.icon,
+        )
+
+    @staticmethod
+    def load(__d: Dict) -> 'ChatSuggestion':
+        """Creates an instance of this class using the contents of a dict."""
+        __d_name: Any = __d.get('name')
+        _guard_scalar('ChatSuggestion.name', __d_name, (str,), True, False, False)
+        __d_label: Any = __d.get('label')
+        _guard_scalar('ChatSuggestion.label', __d_label, (str,), False, False, False)
+        __d_caption: Any = __d.get('caption')
+        _guard_scalar('ChatSuggestion.caption', __d_caption, (str,), False, True, False)
+        __d_icon: Any = __d.get('icon')
+        _guard_scalar('ChatSuggestion.icon', __d_icon, (str,), False, True, False)
+        name: str = __d_name
+        label: str = __d_label
+        caption: Optional[str] = __d_caption
+        icon: Optional[str] = __d_icon
+        return ChatSuggestion(
+            name,
+            label,
+            caption,
+            icon,
+        )
+
+
 class ChatbotCard:
     """Create a chatbot card to allow getting prompts from users and providing them with LLM generated answers.
     """
@@ -8217,6 +8345,8 @@ class ChatbotCard:
             placeholder: Optional[str] = None,
             events: Optional[List[str]] = None,
             generating: Optional[bool] = None,
+            suggestions: Optional[List[ChatSuggestion]] = None,
+            disabled: Optional[bool] = None,
             commands: Optional[List[Command]] = None,
     ):
         _guard_scalar('ChatbotCard.box', box, (str,), False, False, False)
@@ -8224,6 +8354,8 @@ class ChatbotCard:
         _guard_scalar('ChatbotCard.placeholder', placeholder, (str,), False, True, False)
         _guard_vector('ChatbotCard.events', events, (str,), False, True, False)
         _guard_scalar('ChatbotCard.generating', generating, (bool,), False, True, False)
+        _guard_vector('ChatbotCard.suggestions', suggestions, (ChatSuggestion,), False, True, False)
+        _guard_scalar('ChatbotCard.disabled', disabled, (bool,), False, True, False)
         _guard_vector('ChatbotCard.commands', commands, (Command,), False, True, False)
         self.box = box
         """A string indicating how to place this component on the page."""
@@ -8234,9 +8366,13 @@ class ChatbotCard:
         self.placeholder = placeholder
         """Chat input box placeholder. Use for prompt examples."""
         self.events = events
-        """The events to capture on this chatbot. One of 'stop'."""
+        """The events to capture on this chatbot. One of 'stop' | 'scroll_up' | 'feedback' | 'suggestion'."""
         self.generating = generating
         """True to show a button to stop the text generation. Defaults to False."""
+        self.suggestions = suggestions
+        """Clickable prompt suggestions shown below the last response."""
+        self.disabled = disabled
+        """True if the user input should be disabled."""
         self.commands = commands
         """Contextual menu commands for this component."""
 
@@ -8247,6 +8383,8 @@ class ChatbotCard:
         _guard_scalar('ChatbotCard.placeholder', self.placeholder, (str,), False, True, False)
         _guard_vector('ChatbotCard.events', self.events, (str,), False, True, False)
         _guard_scalar('ChatbotCard.generating', self.generating, (bool,), False, True, False)
+        _guard_vector('ChatbotCard.suggestions', self.suggestions, (ChatSuggestion,), False, True, False)
+        _guard_scalar('ChatbotCard.disabled', self.disabled, (bool,), False, True, False)
         _guard_vector('ChatbotCard.commands', self.commands, (Command,), False, True, False)
         return _dump(
             view='chatbot',
@@ -8256,6 +8394,8 @@ class ChatbotCard:
             placeholder=self.placeholder,
             events=self.events,
             generating=self.generating,
+            suggestions=None if self.suggestions is None else [__e.dump() for __e in self.suggestions],
+            disabled=self.disabled,
             commands=None if self.commands is None else [__e.dump() for __e in self.commands],
         )
 
@@ -8273,6 +8413,10 @@ class ChatbotCard:
         _guard_vector('ChatbotCard.events', __d_events, (str,), False, True, False)
         __d_generating: Any = __d.get('generating')
         _guard_scalar('ChatbotCard.generating', __d_generating, (bool,), False, True, False)
+        __d_suggestions: Any = __d.get('suggestions')
+        _guard_vector('ChatbotCard.suggestions', __d_suggestions, (dict,), False, True, False)
+        __d_disabled: Any = __d.get('disabled')
+        _guard_scalar('ChatbotCard.disabled', __d_disabled, (bool,), False, True, False)
         __d_commands: Any = __d.get('commands')
         _guard_vector('ChatbotCard.commands', __d_commands, (dict,), False, True, False)
         box: str = __d_box
@@ -8281,6 +8425,8 @@ class ChatbotCard:
         placeholder: Optional[str] = __d_placeholder
         events: Optional[List[str]] = __d_events
         generating: Optional[bool] = __d_generating
+        suggestions: Optional[List[ChatSuggestion]] = None if __d_suggestions is None else [ChatSuggestion.load(__e) for __e in __d_suggestions]
+        disabled: Optional[bool] = __d_disabled
         commands: Optional[List[Command]] = None if __d_commands is None else [Command.load(__e) for __e in __d_commands]
         return ChatbotCard(
             box,
@@ -8289,6 +8435,8 @@ class ChatbotCard:
             placeholder,
             events,
             generating,
+            suggestions,
+            disabled,
             commands,
         )
 
@@ -9608,11 +9756,13 @@ class MarkdownCard:
             title: str,
             content: str,
             data: Optional[PackedRecord] = None,
+            compact: Optional[bool] = None,
             commands: Optional[List[Command]] = None,
     ):
         _guard_scalar('MarkdownCard.box', box, (str,), False, False, False)
         _guard_scalar('MarkdownCard.title', title, (str,), False, False, False)
         _guard_scalar('MarkdownCard.content', content, (str,), False, False, False)
+        _guard_scalar('MarkdownCard.compact', compact, (bool,), False, True, False)
         _guard_vector('MarkdownCard.commands', commands, (Command,), False, True, False)
         self.box = box
         """A string indicating how to place this component on the page."""
@@ -9622,6 +9772,8 @@ class MarkdownCard:
         """The markdown content. Supports Github Flavored Markdown (GFM): https://guides.github.com/features/mastering-markdown/"""
         self.data = data
         """Additional data for the card."""
+        self.compact = compact
+        """Make spacing tighter. Defaults to True."""
         self.commands = commands
         """Contextual menu commands for this component."""
 
@@ -9630,6 +9782,7 @@ class MarkdownCard:
         _guard_scalar('MarkdownCard.box', self.box, (str,), False, False, False)
         _guard_scalar('MarkdownCard.title', self.title, (str,), False, False, False)
         _guard_scalar('MarkdownCard.content', self.content, (str,), False, False, False)
+        _guard_scalar('MarkdownCard.compact', self.compact, (bool,), False, True, False)
         _guard_vector('MarkdownCard.commands', self.commands, (Command,), False, True, False)
         return _dump(
             view='markdown',
@@ -9637,6 +9790,7 @@ class MarkdownCard:
             title=self.title,
             content=self.content,
             data=self.data,
+            compact=self.compact,
             commands=None if self.commands is None else [__e.dump() for __e in self.commands],
         )
 
@@ -9650,18 +9804,22 @@ class MarkdownCard:
         __d_content: Any = __d.get('content')
         _guard_scalar('MarkdownCard.content', __d_content, (str,), False, False, False)
         __d_data: Any = __d.get('data')
+        __d_compact: Any = __d.get('compact')
+        _guard_scalar('MarkdownCard.compact', __d_compact, (bool,), False, True, False)
         __d_commands: Any = __d.get('commands')
         _guard_vector('MarkdownCard.commands', __d_commands, (dict,), False, True, False)
         box: str = __d_box
         title: str = __d_title
         content: str = __d_content
         data: Optional[PackedRecord] = __d_data
+        compact: Optional[bool] = __d_compact
         commands: Optional[List[Command]] = None if __d_commands is None else [Command.load(__e) for __e in __d_commands]
         return MarkdownCard(
             box,
             title,
             content,
             data,
+            compact,
             commands,
         )
 
@@ -12684,15 +12842,19 @@ class TallStatsCard:
             self,
             box: str,
             items: List[Stat],
+            name: Optional[str] = None,
             commands: Optional[List[Command]] = None,
     ):
         _guard_scalar('TallStatsCard.box', box, (str,), False, False, False)
         _guard_vector('TallStatsCard.items', items, (Stat,), False, False, False)
+        _guard_scalar('TallStatsCard.name', name, (str,), False, True, False)
         _guard_vector('TallStatsCard.commands', commands, (Command,), False, True, False)
         self.box = box
         """A string indicating how to place this component on the page."""
         self.items = items
         """The individual stats to be displayed."""
+        self.name = name
+        """An identifying name for this component."""
         self.commands = commands
         """Contextual menu commands for this component."""
 
@@ -12700,11 +12862,13 @@ class TallStatsCard:
         """Returns the contents of this object as a dict."""
         _guard_scalar('TallStatsCard.box', self.box, (str,), False, False, False)
         _guard_vector('TallStatsCard.items', self.items, (Stat,), False, False, False)
+        _guard_scalar('TallStatsCard.name', self.name, (str,), False, True, False)
         _guard_vector('TallStatsCard.commands', self.commands, (Command,), False, True, False)
         return _dump(
             view='tall_stats',
             box=self.box,
             items=[__e.dump() for __e in self.items],
+            name=self.name,
             commands=None if self.commands is None else [__e.dump() for __e in self.commands],
         )
 
@@ -12715,14 +12879,18 @@ class TallStatsCard:
         _guard_scalar('TallStatsCard.box', __d_box, (str,), False, False, False)
         __d_items: Any = __d.get('items')
         _guard_vector('TallStatsCard.items', __d_items, (dict,), False, False, False)
+        __d_name: Any = __d.get('name')
+        _guard_scalar('TallStatsCard.name', __d_name, (str,), False, True, False)
         __d_commands: Any = __d.get('commands')
         _guard_vector('TallStatsCard.commands', __d_commands, (dict,), False, True, False)
         box: str = __d_box
         items: List[Stat] = [Stat.load(__e) for __e in __d_items]
+        name: Optional[str] = __d_name
         commands: Optional[List[Command]] = None if __d_commands is None else [Command.load(__e) for __e in __d_commands]
         return TallStatsCard(
             box,
             items,
+            name,
             commands,
         )