Item models

The built-in item models: what a list, a menu, a tab strip or a tree is bound to when it is not bound to a model of your own. Every item carries an Id, which is the only thing it is ever addressed by; a model of your own implements the same interface and is observable through [RecursiveMember].

`BadgeItem`

A data model describing a badge item's icon and text for use in lists/collections bound to IBadgeModel.

Every styling property starts at null; what an item leaves unsaid is decided by the template drawing it.

Property	Type	Description
`Id` fixed	`string`	The stable item identifier. Init-only and non-notifying: a keyed collection indexes its items by this, so re-keying after insertion would break the id map.
`BadgeStyle`	`UIBadgeType?`	The badge visual variant.
`BadgeColor`	`UIThemeColor?`	The badge's own colour, overriding `IBadgeModel.BadgeStyle` when set — a tag or a category swatch, which the closed style enum cannot name.
`BadgeIcon`	`string`	The icon shown beside the badge text, by name from the registered icon font/set. translatable
`BadgeIconColor`	`UIThemeColor?`	The badge icon's colour, defaulting to `IBadgeModel.DefaultBadgeIconColor`.
`BadgeIconSize`	`UIIconSize?`	The badge icon size. Left unset the glyph is as tall as the badge's own text.
`BadgeText`	`string`	The short text drawn inside the badge, beside its icon. translatable
`BadgeTextType`	`UITextAppearance?`	The badge text's role, defaulting to `IBadgeModel.DefaultBadgeTextType`.
`BadgeTooltip`	`string`	The tooltip for the badge content. translatable
`BadgeTooltipPlacement`	`UIPopupPlacement?`	The side the badge's own tooltip prefers, placed against the badge rather than against the row.

`BreadcrumbItem`

A data model describing one step of a trail, for use in collections bound to IBreadcrumbItemModel.

Property	Type	Description
`Url`	`string`	The route this step leads back to. A step may carry a URL, a click command, or both.
`CanSelect`	`bool?`	Whether the item may be chosen; unset means it may.
`CanDrag`	`bool?`	Whether the item may be dragged, where its host drags at all; unset means it may.
`CanRemove`	`bool?`	Whether the item may be removed by the host's own gesture — a tab's close, a row's Delete key; unset means it may.
`CanRename`	`bool?`	Whether the item may be renamed in place, where its host renames at all; unset means it may.
`CanShowContextMenu`	`bool?`	Whether a right-click on the item opens the menu its template carries; unset means it does.
`Icon`	`string`	The icon shown before the title, by name from the registered icon font/set. translatable
`IconColor`	`UIThemeColor?`	The leading icon's colour, defaulting to `ITextBaseModel.DefaultIconColor`.
`IconSize`	`UIIconSize?`	The leading icon size; left unset the glyph is as tall as the title beside it.
`Title`	`string`	The label text drawn as the title; nothing renders when it is unset. translatable
`TitleType`	`UITextAppearance?`	The primary text type.
`TitleColor`	`UIThemeColor?`	The primary text colour, which also colours the icon and the description unless either is overridden by `ITextModel.DescriptionColor` or `IconColor`.
`Selectable`	`bool?`	Whether the text can be selected with the pointer; content says yes, a control's caption says no.
`BadgePlacement`	`UITextBadgePlacement?`	Where badge content is placed.
`Tooltip`	`string`	The tooltip shown on hover and on focus. On a button-shaped control with no title of its own — an icon button — it is also the name a screen reader gets. translatable
`TooltipPlacement`	`UIPopupPlacement?`	The side the tooltip prefers; flips to the opposite side when there is no room for it there.
`Visibility`	`UIResponsive<UIVisibility>?`	What the model does with the room it was given, optionally overridden per breakpoint.
`Enabled`	`bool?`	Whether this item is enabled; a default row template binds it to the row's own Enabled, so one item can disable itself independent of its siblings.
`Id` fixed	`string`	The stable item identifier. Init-only and non-notifying: a keyed collection indexes its items by this, so re-keying after insertion would break the id map.
`BadgeStyle`	`UIBadgeType?`	The badge visual variant.
`BadgeColor`	`UIThemeColor?`	The badge's own colour, overriding `IBadgeModel.BadgeStyle` when set — a tag or a category swatch, which the closed style enum cannot name.
`BadgeIcon`	`string`	The icon shown beside the badge text, by name from the registered icon font/set. translatable
`BadgeIconColor`	`UIThemeColor?`	The badge icon's colour, defaulting to `IBadgeModel.DefaultBadgeIconColor`.
`BadgeIconSize`	`UIIconSize?`	The badge icon size. Left unset the glyph is as tall as the badge's own text.
`BadgeText`	`string`	The short text drawn inside the badge, beside its icon. translatable
`BadgeTextType`	`UITextAppearance?`	The badge text's role, defaulting to `IBadgeModel.DefaultBadgeTextType`.
`BadgeTooltip`	`string`	The tooltip for the badge content. translatable
`BadgeTooltipPlacement`	`UIPopupPlacement?`	The side the badge's own tooltip prefers, placed against the badge rather than against the row.

`ButtonItem`

A data model describing a button item's text and style for use in lists/collections bound to IButtonModel.

Property	Type	Description
`Type`	`UIButtonType?`	The button's visual variant — Primary, Accent, Danger, Outline, Ghost, Link, or Surface.
`Size`	`UIButtonSize?`	How much room the button takes — Small, Medium, or Large.
`Group`	`string`	The group this button belongs to; a command bar draws its `GroupSeparator` where the group changes.
`Description`	`string`	The secondary text. translatable
`DescriptionType`	`UITextAppearance?`	The secondary text type.
`DescriptionColor`	`UIThemeColor?`	The secondary text color.
`TextAlignment`	`UITextAlignment?`	How the title and description align within their box — Start, Center, End, or Justify; default Start.
`CanSelect`	`bool?`	Whether the item may be chosen; unset means it may.
`CanDrag`	`bool?`	Whether the item may be dragged, where its host drags at all; unset means it may.
`CanRemove`	`bool?`	Whether the item may be removed by the host's own gesture — a tab's close, a row's Delete key; unset means it may.
`CanRename`	`bool?`	Whether the item may be renamed in place, where its host renames at all; unset means it may.
`CanShowContextMenu`	`bool?`	Whether a right-click on the item opens the menu its template carries; unset means it does.
`Icon`	`string`	The icon shown before the title, by name from the registered icon font/set. translatable
`IconColor`	`UIThemeColor?`	The leading icon's colour, defaulting to `ITextBaseModel.DefaultIconColor`.
`IconSize`	`UIIconSize?`	The leading icon size; left unset the glyph is as tall as the title beside it.
`Title`	`string`	The label text drawn as the title; nothing renders when it is unset. translatable
`TitleType`	`UITextAppearance?`	The primary text type.
`TitleColor`	`UIThemeColor?`	The primary text colour, which also colours the icon and the description unless either is overridden by `ITextModel.DescriptionColor` or `IconColor`.
`Selectable`	`bool?`	Whether the text can be selected with the pointer; content says yes, a control's caption says no.
`BadgePlacement`	`UITextBadgePlacement?`	Where badge content is placed.
`Tooltip`	`string`	The tooltip shown on hover and on focus. On a button-shaped control with no title of its own — an icon button — it is also the name a screen reader gets. translatable
`TooltipPlacement`	`UIPopupPlacement?`	The side the tooltip prefers; flips to the opposite side when there is no room for it there.
`Visibility`	`UIResponsive<UIVisibility>?`	What the model does with the room it was given, optionally overridden per breakpoint.
`Enabled`	`bool?`	Whether this item is enabled; a default row template binds it to the row's own Enabled, so one item can disable itself independent of its siblings.
`Id` fixed	`string`	The stable item identifier. Init-only and non-notifying: a keyed collection indexes its items by this, so re-keying after insertion would break the id map.
`BadgeStyle`	`UIBadgeType?`	The badge visual variant.
`BadgeColor`	`UIThemeColor?`	The badge's own colour, overriding `IBadgeModel.BadgeStyle` when set — a tag or a category swatch, which the closed style enum cannot name.
`BadgeIcon`	`string`	The icon shown beside the badge text, by name from the registered icon font/set. translatable
`BadgeIconColor`	`UIThemeColor?`	The badge icon's colour, defaulting to `IBadgeModel.DefaultBadgeIconColor`.
`BadgeIconSize`	`UIIconSize?`	The badge icon size. Left unset the glyph is as tall as the badge's own text.
`BadgeText`	`string`	The short text drawn inside the badge, beside its icon. translatable
`BadgeTextType`	`UITextAppearance?`	The badge text's role, defaulting to `IBadgeModel.DefaultBadgeTextType`.
`BadgeTooltip`	`string`	The tooltip for the badge content. translatable
`BadgeTooltipPlacement`	`UIPopupPlacement?`	The side the badge's own tooltip prefers, placed against the badge rather than against the row.

`KeyValueActionItem`

A data model describing a key/value pair with an associated action button for use in lists/collections bound to IKeyValueActionModel.

Property	Type	Description
`Id`	`string`	The stable item identifier.
`Key`	`ITextModel`	The content rendered in the row's key slot.
`Value`	`ITextModel`	The content rendered in the row's value slot.
`Action`	`IButtonModel`	The content rendered in the row's action slot.
`ShowInput`	`bool?`	Whether the row shows its value as an input: editing state is the row's, so it survives anything the page does around it.
`EditValue`	`object`	The draft the input edits; `Value` stays what the row shows until a save moves the draft over.
`InputTemplate`	`string`	Which typed input the row opens with, naming a variant registered on the list; unset, the list's default input.

`MenuItem`

A data model describing one menu entry for use in collections bound to IMenuItemModel.

Property	Type	Description
`Kind`	`UIMenuItemKind?`	What this entry is. `null` reads as `UIMenuItemKind.Item`.
`Url`	`string`	The route this entry navigates to. An entry may carry a URL, a click command, or both.
`Selected`	`bool?`	Whether this entry is the current one.
`Expanded`	`bool?`	Whether this entry's sub-entries start out open; meaningless on an entry with none. This is the initial position only — the live state afterwards is kept client-side.
`Shortcut`	`string`	The key combination that fires this entry, written as `Ctrl+Shift+P` and matched by physical key so it keeps working on a non-Latin layout.
`Checked`	`bool?`	Whether a `UIMenuItemKind.Check` entry is on.
`Value`	`string`	What a `UIMenuItemKind.Select` entry currently says at its end — the chosen option's name, as the controller words it.
`Items` fixed	`RecursiveCollection<MenuItem>`	The nested entries. See `IMenuItemModel.Items` on how deep a menu actually renders.
`CanSelect`	`bool?`	Whether the item may be chosen; unset means it may.
`CanDrag`	`bool?`	Whether the item may be dragged, where its host drags at all; unset means it may.
`CanRemove`	`bool?`	Whether the item may be removed by the host's own gesture — a tab's close, a row's Delete key; unset means it may.
`CanRename`	`bool?`	Whether the item may be renamed in place, where its host renames at all; unset means it may.
`CanShowContextMenu`	`bool?`	Whether a right-click on the item opens the menu its template carries; unset means it does.
`Icon`	`string`	The icon shown before the title, by name from the registered icon font/set. translatable
`IconColor`	`UIThemeColor?`	The leading icon's colour, defaulting to `ITextBaseModel.DefaultIconColor`.
`IconSize`	`UIIconSize?`	The leading icon size; left unset the glyph is as tall as the title beside it.
`Title`	`string`	The label text drawn as the title; nothing renders when it is unset. translatable
`TitleType`	`UITextAppearance?`	The primary text type.
`TitleColor`	`UIThemeColor?`	The primary text colour, which also colours the icon and the description unless either is overridden by `ITextModel.DescriptionColor` or `IconColor`.
`Selectable`	`bool?`	Whether the text can be selected with the pointer; content says yes, a control's caption says no.
`BadgePlacement`	`UITextBadgePlacement?`	Where badge content is placed.
`Tooltip`	`string`	The tooltip shown on hover and on focus. On a button-shaped control with no title of its own — an icon button — it is also the name a screen reader gets. translatable
`TooltipPlacement`	`UIPopupPlacement?`	The side the tooltip prefers; flips to the opposite side when there is no room for it there.
`Visibility`	`UIResponsive<UIVisibility>?`	What the model does with the room it was given, optionally overridden per breakpoint.
`Enabled`	`bool?`	Whether this item is enabled; a default row template binds it to the row's own Enabled, so one item can disable itself independent of its siblings.
`Id` fixed	`string`	The stable item identifier. Init-only and non-notifying: a keyed collection indexes its items by this, so re-keying after insertion would break the id map.
`BadgeStyle`	`UIBadgeType?`	The badge visual variant.
`BadgeColor`	`UIThemeColor?`	The badge's own colour, overriding `IBadgeModel.BadgeStyle` when set — a tag or a category swatch, which the closed style enum cannot name.
`BadgeIcon`	`string`	The icon shown beside the badge text, by name from the registered icon font/set. translatable
`BadgeIconColor`	`UIThemeColor?`	The badge icon's colour, defaulting to `IBadgeModel.DefaultBadgeIconColor`.
`BadgeIconSize`	`UIIconSize?`	The badge icon size. Left unset the glyph is as tall as the badge's own text.
`BadgeText`	`string`	The short text drawn inside the badge, beside its icon. translatable
`BadgeTextType`	`UITextAppearance?`	The badge text's role, defaulting to `IBadgeModel.DefaultBadgeTextType`.
`BadgeTooltip`	`string`	The tooltip for the badge content. translatable
`BadgeTooltipPlacement`	`UIPopupPlacement?`	The side the badge's own tooltip prefers, placed against the badge rather than against the row.

`OptionItem`

A data model describing a selectable option's text, group and selection state for use in lists/collections bound to IOptionModel.

Property	Type	Description
`Group`	`string`	The group key, or `null` when the item is not grouped.
`Selected`	`bool?`	Whether this option's key is currently among the chosen ones.
`Description`	`string`	The secondary text. translatable
`DescriptionType`	`UITextAppearance?`	The secondary text type.
`DescriptionColor`	`UIThemeColor?`	The secondary text color.
`TextAlignment`	`UITextAlignment?`	How the title and description align within their box — Start, Center, End, or Justify; default Start.
`CanSelect`	`bool?`	Whether the item may be chosen; unset means it may.
`CanDrag`	`bool?`	Whether the item may be dragged, where its host drags at all; unset means it may.
`CanRemove`	`bool?`	Whether the item may be removed by the host's own gesture — a tab's close, a row's Delete key; unset means it may.
`CanRename`	`bool?`	Whether the item may be renamed in place, where its host renames at all; unset means it may.
`CanShowContextMenu`	`bool?`	Whether a right-click on the item opens the menu its template carries; unset means it does.
`Icon`	`string`	The icon shown before the title, by name from the registered icon font/set. translatable
`IconColor`	`UIThemeColor?`	The leading icon's colour, defaulting to `ITextBaseModel.DefaultIconColor`.
`IconSize`	`UIIconSize?`	The leading icon size; left unset the glyph is as tall as the title beside it.
`Title`	`string`	The label text drawn as the title; nothing renders when it is unset. translatable
`TitleType`	`UITextAppearance?`	The primary text type.
`TitleColor`	`UIThemeColor?`	The primary text colour, which also colours the icon and the description unless either is overridden by `ITextModel.DescriptionColor` or `IconColor`.
`Selectable`	`bool?`	Whether the text can be selected with the pointer; content says yes, a control's caption says no.
`BadgePlacement`	`UITextBadgePlacement?`	Where badge content is placed.
`Tooltip`	`string`	The tooltip shown on hover and on focus. On a button-shaped control with no title of its own — an icon button — it is also the name a screen reader gets. translatable
`TooltipPlacement`	`UIPopupPlacement?`	The side the tooltip prefers; flips to the opposite side when there is no room for it there.
`Visibility`	`UIResponsive<UIVisibility>?`	What the model does with the room it was given, optionally overridden per breakpoint.
`Enabled`	`bool?`	Whether this item is enabled; a default row template binds it to the row's own Enabled, so one item can disable itself independent of its siblings.
`Id` fixed	`string`	The stable item identifier. Init-only and non-notifying: a keyed collection indexes its items by this, so re-keying after insertion would break the id map.
`BadgeStyle`	`UIBadgeType?`	The badge visual variant.
`BadgeColor`	`UIThemeColor?`	The badge's own colour, overriding `IBadgeModel.BadgeStyle` when set — a tag or a category swatch, which the closed style enum cannot name.
`BadgeIcon`	`string`	The icon shown beside the badge text, by name from the registered icon font/set. translatable
`BadgeIconColor`	`UIThemeColor?`	The badge icon's colour, defaulting to `IBadgeModel.DefaultBadgeIconColor`.
`BadgeIconSize`	`UIIconSize?`	The badge icon size. Left unset the glyph is as tall as the badge's own text.
`BadgeText`	`string`	The short text drawn inside the badge, beside its icon. translatable
`BadgeTextType`	`UITextAppearance?`	The badge text's role, defaulting to `IBadgeModel.DefaultBadgeTextType`.
`BadgeTooltip`	`string`	The tooltip for the badge content. translatable
`BadgeTooltipPlacement`	`UIPopupPlacement?`	The side the badge's own tooltip prefers, placed against the badge rather than against the row.

`TabItem`

One tab of a tabs view: a text item with a place in the strip. A tab that cannot be closed says so with TextBaseItem.CanRemove.

Property	Type	Description
`Order`	`double?`	Where the tab sits in the strip, ascending; a drag writes the new position back.
`Pinned`	`bool?`	Whether the tab is pinned: drawn with a pin, without its close control, and left where it is by a drag.
`CanSelect`	`bool?`	Whether the item may be chosen; unset means it may.
`CanDrag`	`bool?`	Whether the item may be dragged, where its host drags at all; unset means it may.
`CanRemove`	`bool?`	Whether the item may be removed by the host's own gesture — a tab's close, a row's Delete key; unset means it may.
`CanRename`	`bool?`	Whether the item may be renamed in place, where its host renames at all; unset means it may.
`CanShowContextMenu`	`bool?`	Whether a right-click on the item opens the menu its template carries; unset means it does.
`Icon`	`string`	The icon shown before the title, by name from the registered icon font/set. translatable
`IconColor`	`UIThemeColor?`	The leading icon's colour, defaulting to `ITextBaseModel.DefaultIconColor`.
`IconSize`	`UIIconSize?`	The leading icon size; left unset the glyph is as tall as the title beside it.
`Title`	`string`	The label text drawn as the title; nothing renders when it is unset. translatable
`TitleType`	`UITextAppearance?`	The primary text type.
`TitleColor`	`UIThemeColor?`	The primary text colour, which also colours the icon and the description unless either is overridden by `ITextModel.DescriptionColor` or `IconColor`.
`Selectable`	`bool?`	Whether the text can be selected with the pointer; content says yes, a control's caption says no.
`BadgePlacement`	`UITextBadgePlacement?`	Where badge content is placed.
`Tooltip`	`string`	The tooltip shown on hover and on focus. On a button-shaped control with no title of its own — an icon button — it is also the name a screen reader gets. translatable
`TooltipPlacement`	`UIPopupPlacement?`	The side the tooltip prefers; flips to the opposite side when there is no room for it there.
`Visibility`	`UIResponsive<UIVisibility>?`	What the model does with the room it was given, optionally overridden per breakpoint.
`Enabled`	`bool?`	Whether this item is enabled; a default row template binds it to the row's own Enabled, so one item can disable itself independent of its siblings.
`Id` fixed	`string`	The stable item identifier. Init-only and non-notifying: a keyed collection indexes its items by this, so re-keying after insertion would break the id map.
`BadgeStyle`	`UIBadgeType?`	The badge visual variant.
`BadgeColor`	`UIThemeColor?`	The badge's own colour, overriding `IBadgeModel.BadgeStyle` when set — a tag or a category swatch, which the closed style enum cannot name.
`BadgeIcon`	`string`	The icon shown beside the badge text, by name from the registered icon font/set. translatable
`BadgeIconColor`	`UIThemeColor?`	The badge icon's colour, defaulting to `IBadgeModel.DefaultBadgeIconColor`.
`BadgeIconSize`	`UIIconSize?`	The badge icon size. Left unset the glyph is as tall as the badge's own text.
`BadgeText`	`string`	The short text drawn inside the badge, beside its icon. translatable
`BadgeTextType`	`UITextAppearance?`	The badge text's role, defaulting to `IBadgeModel.DefaultBadgeTextType`.
`BadgeTooltip`	`string`	The tooltip for the badge content. translatable
`BadgeTooltipPlacement`	`UIPopupPlacement?`	The side the badge's own tooltip prefers, placed against the badge rather than against the row.

`TextBaseItem`

A data model describing an item's icon and title, plus visibility/enabled state, for use in lists/collections bound to ITextBaseModel.

Styling starts at null; TextBaseItem.Visibility and TextBaseItem.Enabled keep their defaults, being state rather than style. The abilities are read by the built-in row templates, which bind them live; a custom template's row keeps the abilities it was rendered with, and a model that is never a row (a menu entry) carries them unread.

Property	Type	Description
`CanSelect`	`bool?`	Whether the item may be chosen; unset means it may.
`CanDrag`	`bool?`	Whether the item may be dragged, where its host drags at all; unset means it may.
`CanRemove`	`bool?`	Whether the item may be removed by the host's own gesture — a tab's close, a row's Delete key; unset means it may.
`CanRename`	`bool?`	Whether the item may be renamed in place, where its host renames at all; unset means it may.
`CanShowContextMenu`	`bool?`	Whether a right-click on the item opens the menu its template carries; unset means it does.
`Icon`	`string`	The icon shown before the title, by name from the registered icon font/set. translatable
`IconColor`	`UIThemeColor?`	The leading icon's colour, defaulting to `ITextBaseModel.DefaultIconColor`.
`IconSize`	`UIIconSize?`	The leading icon size; left unset the glyph is as tall as the title beside it.
`Title`	`string`	The label text drawn as the title; nothing renders when it is unset. translatable
`TitleType`	`UITextAppearance?`	The primary text type.
`TitleColor`	`UIThemeColor?`	The primary text colour, which also colours the icon and the description unless either is overridden by `ITextModel.DescriptionColor` or `IconColor`.
`Selectable`	`bool?`	Whether the text can be selected with the pointer; content says yes, a control's caption says no.
`BadgePlacement`	`UITextBadgePlacement?`	Where badge content is placed.
`Tooltip`	`string`	The tooltip shown on hover and on focus. On a button-shaped control with no title of its own — an icon button — it is also the name a screen reader gets. translatable
`TooltipPlacement`	`UIPopupPlacement?`	The side the tooltip prefers; flips to the opposite side when there is no room for it there.
`Visibility`	`UIResponsive<UIVisibility>?`	What the model does with the room it was given, optionally overridden per breakpoint.
`Enabled`	`bool?`	Whether this item is enabled; a default row template binds it to the row's own Enabled, so one item can disable itself independent of its siblings.
`Id` fixed	`string`	The stable item identifier. Init-only and non-notifying: a keyed collection indexes its items by this, so re-keying after insertion would break the id map.
`BadgeStyle`	`UIBadgeType?`	The badge visual variant.
`BadgeColor`	`UIThemeColor?`	The badge's own colour, overriding `IBadgeModel.BadgeStyle` when set — a tag or a category swatch, which the closed style enum cannot name.
`BadgeIcon`	`string`	The icon shown beside the badge text, by name from the registered icon font/set. translatable
`BadgeIconColor`	`UIThemeColor?`	The badge icon's colour, defaulting to `IBadgeModel.DefaultBadgeIconColor`.
`BadgeIconSize`	`UIIconSize?`	The badge icon size. Left unset the glyph is as tall as the badge's own text.
`BadgeText`	`string`	The short text drawn inside the badge, beside its icon. translatable
`BadgeTextType`	`UITextAppearance?`	The badge text's role, defaulting to `IBadgeModel.DefaultBadgeTextType`.
`BadgeTooltip`	`string`	The tooltip for the badge content. translatable
`BadgeTooltipPlacement`	`UIPopupPlacement?`	The side the badge's own tooltip prefers, placed against the badge rather than against the row.

`TextItem`

A data model describing an item's title and description text for use in lists/collections bound to ITextModel.

Property	Type	Description
`Description`	`string`	The secondary text. translatable
`DescriptionType`	`UITextAppearance?`	The secondary text type.
`DescriptionColor`	`UIThemeColor?`	The secondary text color.
`TextAlignment`	`UITextAlignment?`	How the title and description align within their box — Start, Center, End, or Justify; default Start.
`CanSelect`	`bool?`	Whether the item may be chosen; unset means it may.
`CanDrag`	`bool?`	Whether the item may be dragged, where its host drags at all; unset means it may.
`CanRemove`	`bool?`	Whether the item may be removed by the host's own gesture — a tab's close, a row's Delete key; unset means it may.
`CanRename`	`bool?`	Whether the item may be renamed in place, where its host renames at all; unset means it may.
`CanShowContextMenu`	`bool?`	Whether a right-click on the item opens the menu its template carries; unset means it does.
`Icon`	`string`	The icon shown before the title, by name from the registered icon font/set. translatable
`IconColor`	`UIThemeColor?`	The leading icon's colour, defaulting to `ITextBaseModel.DefaultIconColor`.
`IconSize`	`UIIconSize?`	The leading icon size; left unset the glyph is as tall as the title beside it.
`Title`	`string`	The label text drawn as the title; nothing renders when it is unset. translatable
`TitleType`	`UITextAppearance?`	The primary text type.
`TitleColor`	`UIThemeColor?`	The primary text colour, which also colours the icon and the description unless either is overridden by `ITextModel.DescriptionColor` or `IconColor`.
`Selectable`	`bool?`	Whether the text can be selected with the pointer; content says yes, a control's caption says no.
`BadgePlacement`	`UITextBadgePlacement?`	Where badge content is placed.
`Tooltip`	`string`	The tooltip shown on hover and on focus. On a button-shaped control with no title of its own — an icon button — it is also the name a screen reader gets. translatable
`TooltipPlacement`	`UIPopupPlacement?`	The side the tooltip prefers; flips to the opposite side when there is no room for it there.
`Visibility`	`UIResponsive<UIVisibility>?`	What the model does with the room it was given, optionally overridden per breakpoint.
`Enabled`	`bool?`	Whether this item is enabled; a default row template binds it to the row's own Enabled, so one item can disable itself independent of its siblings.
`Id` fixed	`string`	The stable item identifier. Init-only and non-notifying: a keyed collection indexes its items by this, so re-keying after insertion would break the id map.
`BadgeStyle`	`UIBadgeType?`	The badge visual variant.
`BadgeColor`	`UIThemeColor?`	The badge's own colour, overriding `IBadgeModel.BadgeStyle` when set — a tag or a category swatch, which the closed style enum cannot name.
`BadgeIcon`	`string`	The icon shown beside the badge text, by name from the registered icon font/set. translatable
`BadgeIconColor`	`UIThemeColor?`	The badge icon's colour, defaulting to `IBadgeModel.DefaultBadgeIconColor`.
`BadgeIconSize`	`UIIconSize?`	The badge icon size. Left unset the glyph is as tall as the badge's own text.
`BadgeText`	`string`	The short text drawn inside the badge, beside its icon. translatable
`BadgeTextType`	`UITextAppearance?`	The badge text's role, defaulting to `IBadgeModel.DefaultBadgeTextType`.
`BadgeTooltip`	`string`	The tooltip for the badge content. translatable
`BadgeTooltipPlacement`	`UIPopupPlacement?`	The side the badge's own tooltip prefers, placed against the badge rather than against the row.

`TreeNode`

A data model for one node of a tree — a text item with the key of the node above it — for lists bound to ITreeNodeModel.

Property	Type	Description
`ParentId`	`string`	The key of the node this one sits under, or `null` at the root.
`Kind`	`string`	The kind naming the node template variant that draws this node, or `null` for the default.
`HasChildren`	`bool?`	Whether the node has children even when none are in the list yet; the first unfold asks the controller for them.
`Expanded`	`bool?`	Whether the node starts unfolded; the viewer's own fold takes over from there.
`DropTarget`	`string`	The key of the node this one was dropped on, empty for the tree's ground; written by a drop, read on `move`.
`CanSelect`	`bool?`	Whether the item may be chosen; unset means it may.
`CanDrag`	`bool?`	Whether the item may be dragged, where its host drags at all; unset means it may.
`CanRemove`	`bool?`	Whether the item may be removed by the host's own gesture — a tab's close, a row's Delete key; unset means it may.
`CanRename`	`bool?`	Whether the item may be renamed in place, where its host renames at all; unset means it may.
`CanShowContextMenu`	`bool?`	Whether a right-click on the item opens the menu its template carries; unset means it does.
`Icon`	`string`	The icon shown before the title, by name from the registered icon font/set. translatable
`IconColor`	`UIThemeColor?`	The leading icon's colour, defaulting to `ITextBaseModel.DefaultIconColor`.
`IconSize`	`UIIconSize?`	The leading icon size; left unset the glyph is as tall as the title beside it.
`Title`	`string`	The label text drawn as the title; nothing renders when it is unset. translatable
`TitleType`	`UITextAppearance?`	The primary text type.
`TitleColor`	`UIThemeColor?`	The primary text colour, which also colours the icon and the description unless either is overridden by `ITextModel.DescriptionColor` or `IconColor`.
`Selectable`	`bool?`	Whether the text can be selected with the pointer; content says yes, a control's caption says no.
`BadgePlacement`	`UITextBadgePlacement?`	Where badge content is placed.
`Tooltip`	`string`	The tooltip shown on hover and on focus. On a button-shaped control with no title of its own — an icon button — it is also the name a screen reader gets. translatable
`TooltipPlacement`	`UIPopupPlacement?`	The side the tooltip prefers; flips to the opposite side when there is no room for it there.
`Visibility`	`UIResponsive<UIVisibility>?`	What the model does with the room it was given, optionally overridden per breakpoint.
`Enabled`	`bool?`	Whether this item is enabled; a default row template binds it to the row's own Enabled, so one item can disable itself independent of its siblings.
`Id` fixed	`string`	The stable item identifier. Init-only and non-notifying: a keyed collection indexes its items by this, so re-keying after insertion would break the id map.
`BadgeStyle`	`UIBadgeType?`	The badge visual variant.
`BadgeColor`	`UIThemeColor?`	The badge's own colour, overriding `IBadgeModel.BadgeStyle` when set — a tag or a category swatch, which the closed style enum cannot name.
`BadgeIcon`	`string`	The icon shown beside the badge text, by name from the registered icon font/set. translatable
`BadgeIconColor`	`UIThemeColor?`	The badge icon's colour, defaulting to `IBadgeModel.DefaultBadgeIconColor`.
`BadgeIconSize`	`UIIconSize?`	The badge icon size. Left unset the glyph is as tall as the badge's own text.
`BadgeText`	`string`	The short text drawn inside the badge, beside its icon. translatable
`BadgeTextType`	`UITextAppearance?`	The badge text's role, defaulting to `IBadgeModel.DefaultBadgeTextType`.
`BadgeTooltip`	`string`	The tooltip for the badge content. translatable
`BadgeTooltipPlacement`	`UIPopupPlacement?`	The side the badge's own tooltip prefers, placed against the badge rather than against the row.

`UIOptionValue<T>`

Wraps a plain value as a selectable option, taking both the option's identity and its displayed title from the value itself.

The option-shaped counterpart of UIValueItem, for Select, Search and RadioGroup.

Property	Type	Description
`Value` fixed	`T`	The wrapped value. See `UIValueItem.Value` for why this does not change after construction.
`Group`	`string`	The group key, or `null` when the item is not grouped.
`Selected`	`bool?`	Whether this option's key is currently among the chosen ones.
`Description`	`string`	The secondary text. translatable
`DescriptionType`	`UITextAppearance?`	The secondary text type.
`DescriptionColor`	`UIThemeColor?`	The secondary text color.
`TextAlignment`	`UITextAlignment?`	How the title and description align within their box — Start, Center, End, or Justify; default Start.
`CanSelect`	`bool?`	Whether the item may be chosen; unset means it may.
`CanDrag`	`bool?`	Whether the item may be dragged, where its host drags at all; unset means it may.
`CanRemove`	`bool?`	Whether the item may be removed by the host's own gesture — a tab's close, a row's Delete key; unset means it may.
`CanRename`	`bool?`	Whether the item may be renamed in place, where its host renames at all; unset means it may.
`CanShowContextMenu`	`bool?`	Whether a right-click on the item opens the menu its template carries; unset means it does.
`Icon`	`string`	The icon shown before the title, by name from the registered icon font/set. translatable
`IconColor`	`UIThemeColor?`	The leading icon's colour, defaulting to `ITextBaseModel.DefaultIconColor`.
`IconSize`	`UIIconSize?`	The leading icon size; left unset the glyph is as tall as the title beside it.
`Title`	`string`	The label text drawn as the title; nothing renders when it is unset. translatable
`TitleType`	`UITextAppearance?`	The primary text type.
`TitleColor`	`UIThemeColor?`	The primary text colour, which also colours the icon and the description unless either is overridden by `ITextModel.DescriptionColor` or `IconColor`.
`Selectable`	`bool?`	Whether the text can be selected with the pointer; content says yes, a control's caption says no.
`BadgePlacement`	`UITextBadgePlacement?`	Where badge content is placed.
`Tooltip`	`string`	The tooltip shown on hover and on focus. On a button-shaped control with no title of its own — an icon button — it is also the name a screen reader gets. translatable
`TooltipPlacement`	`UIPopupPlacement?`	The side the tooltip prefers; flips to the opposite side when there is no room for it there.
`Visibility`	`UIResponsive<UIVisibility>?`	What the model does with the room it was given, optionally overridden per breakpoint.
`Enabled`	`bool?`	Whether this item is enabled; a default row template binds it to the row's own Enabled, so one item can disable itself independent of its siblings.
`Id` fixed	`string`	The stable item identifier. Init-only and non-notifying: a keyed collection indexes its items by this, so re-keying after insertion would break the id map.
`BadgeStyle`	`UIBadgeType?`	The badge visual variant.
`BadgeColor`	`UIThemeColor?`	The badge's own colour, overriding `IBadgeModel.BadgeStyle` when set — a tag or a category swatch, which the closed style enum cannot name.
`BadgeIcon`	`string`	The icon shown beside the badge text, by name from the registered icon font/set. translatable
`BadgeIconColor`	`UIThemeColor?`	The badge icon's colour, defaulting to `IBadgeModel.DefaultBadgeIconColor`.
`BadgeIconSize`	`UIIconSize?`	The badge icon size. Left unset the glyph is as tall as the badge's own text.
`BadgeText`	`string`	The short text drawn inside the badge, beside its icon. translatable
`BadgeTextType`	`UITextAppearance?`	The badge text's role, defaulting to `IBadgeModel.DefaultBadgeTextType`.
`BadgeTooltip`	`string`	The tooltip for the badge content. translatable
`BadgeTooltipPlacement`	`UIPopupPlacement?`	The side the badge's own tooltip prefers, placed against the badge rather than against the row.

`UIValueItem<T>`

Wraps a plain value as a bindable item, taking the item's identity from the value itself.

The identity is the value, so a list holding the same value twice is refused; use UIOptionValue for Select/Search/RadioGroup.

Property	Type	Description
`Id` fixed	`string`	The stable item identifier.
`Value` fixed	`T`	The wrapped value. Read-only: the id is derived from it, so replace the item to change the value.