@rippling/rippling-sdk 0.2.0-alpha.37 → 0.2.0-alpha.39

package/lib/sdui/components.js

@@ -1,17 +1,19 @@
 "use strict";
 /**
- * AUTO-GENERATED from component-manifest.json
- * Generated at: 2026-04-17T04:10:01.126Z
- * Components: 128
+ * AUTO-GENERATED from catalog-schema.json
+ * Components: 154
  *
- * Do not edit manually. Run: npx tsx scripts/codegen-builder.ts
+ * Do not edit manually. Run: node tools/sdui/builder/build.js
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ListItem = exports.Label = exports.Icon = exports.Divider = exports.ContentLoader = exports.Card = exports.Chip = exports.Badge = exports.Avatar = exports.Alert = exports.ActionCard = exports.Field = exports.InputGroup = exports.File = exports.TreeSelect = exports.Tree = exports.Survey = exports.Signature = exports.Sin = exports.Ssn = exports.SelectableGroup = exports.ColorPicker = exports.DaySelector = exports.Masker = exports.RangeSlider = exports.Slider = exports.Timezone = exports.TimeRange = exports.Time = exports.SegmentedControl = exports.Percentage = exports.WorkEmail = exports.Currency = exports.TextAutoSuggest = exports.FileDrop = exports.Switch = exports.Password = exports.Phone = exports.Radio = exports.Textarea = exports.DateInlineMulti = exports.DateRange = exports.Date = exports.Number = exports.Email = exports.CheckboxGroup = exports.Checkbox = exports.AppGroupSelect = exports.Select = exports.TextInput = void 0;
-exports.ExpansionPanel = exports.Dropdown = exports.Drawer = exports.DraggableList = exports.ButtonGroup = exports.Button = exports.Breadcrumb = exports.AiIcon = exports.TitleCaption = exports.ToggleableArrow = exports.Country = exports.CountDown = exports.Circle = exports.ApiError = exports.Status = exports.ModalCloseButton = exports.ChipGroup = exports.SettingsLoader = exports.ReportViewerLoader = exports.ReportShareLoader = exports.ReportLoader = exports.ChartLoader = exports.AppGroupLoader = exports.LayoutCard = exports.LoaderCard = exports.LocationCard = exports.TableBasic = exports.Carousel = exports.AtomsSeparator = exports.Image = exports.AvatarList = exports.Video = exports.SnackBar = exports.ObjectUIStats = exports.ObjectUIContent = exports.ObjectUIHeader = exports.ObjectUITemplate = exports.ObjectUI = exports.ImageViewer = exports.DistributionBar = exports.CheckList = exports.Tip = exports.TextSnippet = exports.TextClip = exports.Stepper = exports.Spinner = exports.Skeleton = exports.ProgressBar = exports.ModalFooter = exports.Modal = void 0;
-exports.ObjectListView = exports.CustomObjectGrid = exports.VStack = exports.SplitPane = exports.Responsive = exports.Pane = exports.PageFooter = exports.PageAppLogo = exports.PageHeader = exports.PageContent = exports.Layout = exports.LabelGroup = exports.HStack = exports.Grid = exports.Box = exports.Text = exports.Heading = exports.Tab = exports.ShowMore = exports.SelectableMenu = exports.Paginate = exports.NestedList = exports.MenuList = exports.Link = exports.ItemNavigator = exports.IconButton = exports.FloatingButton = exports.ExpansionPanelGroup = void 0;
+exports.Heading = exports.HStack = exports.Grid = exports.FloatingButton = exports.FileDrop = exports.File = exports.Field = exports.ExpansionPanelGroup = exports.ExpansionPanel = exports.Email = exports.Dropdown = exports.Drawer = exports.DraggableList = exports.Divider = exports.DistributionBar = exports.DaySelector = exports.DateRange = exports.DateInlineMulti = exports.Date = exports.Currency = exports.Country = exports.CountDown = exports.ContentLoader = exports.ColorPicker = exports.Circle = exports.ChipGroup = exports.Chip = exports.CheckboxGroup = exports.Checkbox = exports.CheckList = exports.ChartLoader = exports.Carousel = exports.CardGroup = exports.Card = exports.ButtonGroup = exports.Button = exports.Breadcrumb = exports.Box = exports.Badge = exports.AvatarList = exports.Avatar = exports.AtomsSeparator = exports.AppNavBar = exports.AppGroupSelect = exports.AppGroupLoader = exports.ApiError = exports.Animation = exports.Alert = exports.AiIcon = exports.ActionCard = void 0;
+exports.Signature = exports.ShowMore = exports.SettingsLoader = exports.SelectableMenu = exports.SelectableGroup = exports.Select = exports.SegmentedControl = exports.Responsive = exports.ReportViewerLoader = exports.ReportShareLoader = exports.ReportLoader = exports.RangeSlider = exports.Radio = exports.ProgressSteps = exports.ProgressBar = exports.Phone = exports.Percentage = exports.Password = exports.Pane = exports.Paginate = exports.PageHeader = exports.PageFooter = exports.PageContent = exports.PageAppLogo = exports.ObjectUITemplate = exports.ObjectUIStats = exports.ObjectUIHeader = exports.ObjectUIContent = exports.ObjectUI = exports.Number = exports.NestedList = exports.ModalFooter = exports.ModalCloseButton = exports.Modal = exports.MenuList = exports.Masker = exports.LocationCard = exports.LoaderCard = exports.ListItem = exports.Link = exports.LayoutCard = exports.Layout = exports.LabelGroup = exports.Label = exports.ItemNavigator = exports.InputGroup = exports.ImageViewer = exports.Image = exports.IconButton = exports.Icon = void 0;
+exports.RadarFilledChart = exports.RadarChart = exports.WithSpinner = exports.SunburstChart = exports.GaugeChart = exports.FunnelChart = exports.ScatterChart = exports.PieChart = exports.CombinationChart = exports.HorizontalBarChart = exports.LineChart = exports.BarChart = exports.ObjectListView = exports.CustomObjectGrid = exports.DashboardRichText = exports.RichText = exports.EChart = exports.ResizableBoard = exports.AnalyticsCard = exports.WorkEmail = exports.Video = exports.VStack = exports.TreeSelect = exports.Tree = exports.ToggleableArrow = exports.TitleCaption = exports.Tip = exports.Timezone = exports.TimeRange = exports.Time = exports.Textarea = exports.TextSnippet = exports.TextInput = exports.TextClip = exports.TextAutoSuggest = exports.Text = exports.TableBasic = exports.Tab = exports.Switch = exports.Survey = exports.Stepper = exports.Status = exports.Ssn = exports.SplitPane = exports.SplitButton = exports.Spinner = exports.SnackBar = exports.Slider = exports.Skeleton = exports.Sin = void 0;
+exports.SqlHighlight = exports.TreemapChart = exports.HeatmapChart = exports.HeatmapCalendarChart = void 0;
+const hasOwn = Object.prototype.hasOwnProperty;
 function createComponent(type, eventMap = {}) {
-    return (props = {}) => {
+    return (...args) => {
+        const props = (args[0] ?? {});
         const node = { type, props: {}, children: [] };
         for (const [key, value] of Object.entries(props)) {
             if (key === 'children') {
@@ -26,105 +28,260 @@ function createComponent(type, eventMap = {}) {
             else if (key === 'repeat') {
                 node.repeat = value;
             }
-            else if (eventMap[key]) {
-                node.on = node.on || {};
-                node.on[eventMap[key]] = value;
-            }
             else {
-                node.props[key] = value;
+                // hasOwn guards against Object.prototype keys (toString, etc.)
+                // matching as events via the prototype chain.
+                const eventName = hasOwn.call(eventMap, key) ? eventMap[key] : undefined;
+                if (eventName) {
+                    node.on = node.on || {};
+                    node.on[eventName] = value;
+                }
+                else {
+                    node.props[key] = value;
+                }
             }
         }
         return node;
     };
 }
-exports.TextInput = createComponent('TextInput', {
-    onChange: 'change',
-    onBlur: 'blur',
-    onFocus: 'focus',
-    onClick: 'click',
-    onKeydown: 'keydown',
-    onKeyup: 'keyup',
-    onPaste: 'paste',
-    onMouseenter: 'mouseenter',
-    onMouseleave: 'mouseleave',
+/**
+ * Placeholder for states like empty, success, error, and loading, featuring animations, icons, text, and action buttons.
+ */
+exports.ActionCard = createComponent('ActionCard', {
+    onPressPrimary: 'pressPrimary',
+    onPressSecondary: 'pressSecondary',
 });
-exports.Select = createComponent('Select', {
+/**
+ * Branded Rippling AI icon used to indicate AI-powered features or content. Displays the Rippling AI star icon with optional "Rippling AI" label text.
+ */
+exports.AiIcon = createComponent('AiIcon');
+/**
+ * A persistent, high-priority notice that conveys critical information (errors, warnings, success confirmations, or informational messages) and guides users to proceed or resolve issues. Appears with page content and remains visible until dismissed or resolved. Use for system-level or page-level messaging, not for ephemeral feedback (use SnackBar instead) or for interruptions requiring immediate input (use Modal instead).
+ */
+exports.Alert = createComponent('Alert', {
+    onPressPrimary: 'pressPrimary',
+    onPressSecondary: 'pressSecondary',
+    onDismiss: 'dismiss',
+});
+/**
+ * Renders pre-built Lottie animations from a curated library. Each animation type maps to an SVG animation that plays on mount. Use for empty states, onboarding flows, status illustrations, and feature highlights.
+ */
+exports.Animation = createComponent('Animation');
+/**
+ * A full-screen error state placeholder for API or server failures, displaying an animated exclamation icon and an error message. Use when an API call fails and the entire content area should show an error instead of the expected content.
+ */
+exports.ApiError = createComponent('ApiError');
+/**
+ * A skeleton placeholder shown while app group content is loading. Use when the layout of the app group area is known and you want to reduce perceived loading time and prevent layout shift.
+ */
+exports.AppGroupLoader = createComponent('AppGroupLoader');
+/**
+ * A multi-select dropdown for choosing multiple options from grouped categories, with app-group styling. Use when users need to pick several items organized into labeled groups (e.g. apps by category). For single selection or ungrouped options, use Select instead.
+ */
+exports.AppGroupSelect = createComponent('AppGroupSelect', {
     onChange: 'change',
     onBlur: 'blur',
     onFocus: 'focus',
     onPaste: 'paste',
     onMenuToggle: 'menuToggle',
 });
-exports.AppGroupSelect = createComponent('AppGroupSelect', {
+/**
+ * Application navigation bar with routing support. Displays a horizontal tab bar or vertical sidebar with links, icons, badges, and optional nested sub-navigation. Use for top-level page navigation.
+ */
+exports.AppNavBar = createComponent('AppNavBar', {
+    onNavigate: 'navigate',
+    onAction: 'action',
+});
+/**
+ * A horizontal rule that visually divides sections of content, with optional centered text (e.g. "OR"). Use for content separation — use Divider for separating individual list items.
+ */
+exports.AtomsSeparator = createComponent('AtomsSeparator');
+/**
+ * A visual representation of an entity, such as a user, organization, or product. Use circular shape (isRounded=true) for people and rounded square (isRounded=false) for non-human entities like organizations or brands.
+ */
+exports.Avatar = createComponent('Avatar', {
+    onPress: 'press',
+});
+/**
+ * Displays a list of avatars with a configurable maximum limit that automatically truncates with a number indicating the remaining entities. Use to represent a group of people or organizations.
+ */
+exports.AvatarList = createComponent('AvatarList');
+/**
+ * A static indicator for displaying notifications, counts, or numerical status information. Use for unread counts, pending items, and quantity metrics — not for categories (use Label) or actions (use Button).
+ */
+exports.Badge = createComponent('Badge');
+/**
+ * A general-purpose flexbox layout container with full control over direction, alignment, spacing, dimensions, styling, and responsive direction switching via container queries. Use Box when you need fine-grained CSS control (custom dimensions, borders, backgrounds, positioning, responsive breakpoints) beyond what VStack/HStack provide. Prefer VStack or HStack for simple vertical or horizontal stacking with token-based spacing.
+ */
+exports.Box = createComponent('Box');
+/**
+ * A sequential series of links that mark the nested hierarchy and navigational context for a user's location within an app. Use for complex information architectures where users need a clear path back to higher-level pages.
+ */
+exports.Breadcrumb = createComponent('Breadcrumb', {
+    onSelect: 'select',
+});
+/**
+ * An interactive element that allows users to trigger actions or events with a single click. Use for actions, not navigation — use links for navigation. Use IconButton when space is limited and the action is not critical.
+ */
+exports.Button = createComponent('Button', {
+    onPress: 'press',
+    onPressWhileDisabled: 'pressWhileDisabled',
+    onMouseEnter: 'mouseEnter',
+    onMouseLeave: 'mouseLeave',
+});
+/**
+ * Layout container for arranging multiple Button elements horizontally or vertically with configurable placement, alignment, gap, and wrapping.
+ */
+exports.ButtonGroup = createComponent('ButtonGroup');
+/**
+ * Visually groups related information and components into a contained, interactive card. Use for summarizing content, facilitating comparisons, or guiding users toward specific actions. Renders as a simple layout container when used with children only (no title/content).
+ */
+exports.Card = createComponent('Card', {
+    onEdit: 'edit',
+    onDelete: 'delete',
+    onAdd: 'add',
+    onClick: 'click',
+    onAction: 'action',
+});
+/**
+ * A layout container that arranges Card children (Card, LocationCard, LoaderCard) in an auto-sizing responsive grid. Automatically computes a uniform card width based on available container space.
+ */
+exports.CardGroup = createComponent('CardGroup');
+/**
+ * A step-through image carousel for onboarding flows and guided walkthroughs. Each slide has a heading and image, with built-in navigation controls. Emits a done event when the user advances past the last slide.
+ */
+exports.Carousel = createComponent('Carousel', {
+    onDone: 'done',
+});
+/**
+ * Chart-specific replacement for `WithSpinner`. While `isLoading` is true and `error` is empty, renders a chart-shaped stencil (the same `ChartVisualizationStencil` bar-chart animation the Analytics Report uses) instead of a generic Pebble spinner. When `error` is non-null/non-false, renders a status-aware `ChartError` fallback that picks an animation + copy variant from the HTTP status (403 forbidden, 404 not found, 400 bad request, 500-or-default), mirroring the Analytics Report `VisualizationErrorFallback`. Otherwise renders children. Emits `load` once on mount so a handler can kick off the data fetch.
+ */
+exports.ChartLoader = createComponent('ChartLoader', {
+    onLoad: 'load',
+});
+/**
+ * A flexible multi-select interface with nested lists, allowing users to toggle selections using switches or checkboxes. Use for hierarchical options with parent-child relationships, bulk selection, or settings where multiple configurations can be enabled simultaneously.
+ */
+exports.CheckList = createComponent('CheckList', {
+    onChange: 'change',
+});
+/**
+ * A checkbox that lets users select or unselect an option. Use for toggling a single boolean (e.g. "I agree") or selecting multiple items from a list. Use Radio for mutually exclusive choices; use Toggle when the change takes effect immediately.
+ */
+exports.Checkbox = createComponent('Checkbox', {
     onChange: 'change',
     onBlur: 'blur',
-    onFocus: 'focus',
-    onPaste: 'paste',
-    onMenuToggle: 'menuToggle',
 });
-exports.Checkbox = createComponent('Checkbox', { onChange: 'change', onBlur: 'blur' });
-exports.CheckboxGroup = createComponent('CheckboxGroup', { onChange: 'change', onBlur: 'blur' });
-exports.Email = createComponent('Email', {
+/**
+ * A group of checkboxes that lets users select multiple options from a predefined list. Use when users can choose all, some, or none of the options. Use Radio instead for mutually exclusive single selection, or Toggle for immediate on/off activation.
+ */
+exports.CheckboxGroup = createComponent('CheckboxGroup', {
     onChange: 'change',
     onBlur: 'blur',
-    onFocus: 'focus',
-    onClick: 'click',
-    onKeydown: 'keydown',
-    onKeyup: 'keyup',
-    onPaste: 'paste',
-    onMouseenter: 'mouseenter',
-    onMouseleave: 'mouseleave',
 });
-exports.Number = createComponent('Number', {
+/**
+ * A compact, interactive element for representing entities, attributes, filters, or complex criteria. Use for user-selected tags, filter conditions, or dismissible items. Use Label instead for static semantic color-coded metadata like "New" or "Caution", and Button for calls to action.
+ */
+exports.Chip = createComponent('Chip', {
+    onDismiss: 'dismiss',
+    onPress: 'press',
+});
+/**
+ * A layout container for grouping multiple Chip components (tags, filters, attributes), managing arrangement with configurable gap spacing, overflow behavior that collapses excess chips into a "+N more" modal, and incremental batch rendering for large datasets.
+ */
+exports.ChipGroup = createComponent('ChipGroup', {
+    onOverflowChange: 'overflowChange',
+});
+/**
+ * Circular graphic element for status or decoration
+ */
+exports.Circle = createComponent('Circle');
+/**
+ * A form input for selecting a color from a predefined palette or entering a custom hex value. Use for brand color selection, theme customization, or any setting where users choose a specific color.
+ */
+exports.ColorPicker = createComponent('ColorPicker', {
     onChange: 'change',
     onBlur: 'blur',
-    onChangeRaw: 'changeRaw',
-    onChangeCalculationState: 'changeCalculationState',
 });
-exports.Date = createComponent('Date', { onChange: 'change', onBlur: 'blur' });
-exports.DateRange = createComponent('DateRange', { onChange: 'change', onBlur: 'blur' });
-exports.DateInlineMulti = createComponent('DateInlineMulti', { onChange: 'change', onBlur: 'blur' });
-exports.Textarea = createComponent('Textarea', { onChange: 'change', onBlur: 'blur', onFocus: 'focus' });
-exports.Radio = createComponent('Radio', {
+/**
+ * A low-level SVG shimmer placeholder used to indicate loading state. Renders a plain animated rectangle whose dimensions you control. For shaped placeholders (text lines, circles, boxes), use Skeleton instead.
+ */
+exports.ContentLoader = createComponent('ContentLoader');
+/**
+ * Countdown timer displaying time remaining until a target date
+ */
+exports.CountDown = createComponent('CountDown');
+/**
+ * Displays a country by its ISO code, showing flag and/or name. Can show both (default), flag only, or name only. Ideal for profiles, address settings, or regional customization contexts where country identification is needed.
+ */
+exports.Country = createComponent('Country');
+/**
+ * Specialized input for entering monetary amounts with currency symbol/code prefix and locale-aware number formatting. Supports arithmetic expression evaluation, currency type selection via dropdown, and decimal precision control.
+ */
+exports.Currency = createComponent('Currency', {
     onChange: 'change',
     onBlur: 'blur',
-    onMouseenter: 'mouseenter',
-    onMouseleave: 'mouseleave',
 });
-exports.Phone = createComponent('Phone', {
+/**
+ * A date input that lets users select a single date via calendar or keyboard entry. Use for collecting exact, approximate, or memorable dates (e.g. birth date, start date) and for scheduling. Optionally includes time selection with timezone support. Use DateRange for start/end date pairs; use DateInlineMulti for selecting multiple individual dates without an input field.
+ */
+exports.Date = createComponent('Date', {
     onChange: 'change',
     onBlur: 'blur',
-    onFocus: 'focus',
-    onClick: 'click',
-    onKeydown: 'keydown',
-    onKeyup: 'keyup',
-    onPaste: 'paste',
-    onMouseenter: 'mouseenter',
-    onMouseleave: 'mouseleave',
-    onCountryCodeChange: 'countryCodeChange',
 });
-exports.Password = createComponent('Password', {
+/**
+ * An always-visible inline calendar for selecting multiple individual dates without an input field. Use when users need to pick several non-contiguous dates (e.g. holidays, blocked days). Use Date for single-date entry with an input field, or DateRange for start/end date pairs.
+ */
+exports.DateInlineMulti = createComponent('DateInlineMulti', {
     onChange: 'change',
     onBlur: 'blur',
-    onFocus: 'focus',
-    onClick: 'click',
-    onKeydown: 'keydown',
-    onKeyup: 'keyup',
-    onPaste: 'paste',
-    onMouseenter: 'mouseenter',
-    onMouseleave: 'mouseleave',
-    onReveal: 'reveal',
 });
-exports.Switch = createComponent('Switch', { onChange: 'change', onBlur: 'blur' });
-exports.FileDrop = createComponent('FileDrop', { onChange: 'change', onBlur: 'blur' });
-exports.TextAutoSuggest = createComponent('TextAutoSuggest', {
+/**
+ * A date range picker for selecting a start date and end date pair, such as travel dates, leave periods, or reporting intervals. Use Date instead when only a single date is needed.
+ */
+exports.DateRange = createComponent('DateRange', {
     onChange: 'change',
     onBlur: 'blur',
-    onFocus: 'focus',
-    onClick: 'click',
 });
-exports.Currency = createComponent('Currency', { onChange: 'change', onBlur: 'blur' });
-exports.WorkEmail = createComponent('WorkEmail', {
+/**
+ * A form input for selecting one or more days of the week (Sunday through Saturday). Use for recurring schedules, availability preferences, or any scenario requiring day-of-week choices.
+ */
+exports.DaySelector = createComponent('DaySelector', {
+    onChange: 'change',
+});
+/**
+ * A horizontal stacked bar that visualizes proportional distribution of values across categories. Use to show how parts contribute to a whole, such as budget allocation, storage usage breakdown, or workforce composition.
+ */
+exports.DistributionBar = createComponent('DistributionBar');
+/**
+ * Horizontal line to visually separate content sections
+ */
+exports.Divider = createComponent('Divider');
+/**
+ * A reorderable drag-and-drop list for dynamically rearranging items. Supports vertical and horizontal layouts; use when item order flexibility is crucial to the user experience.
+ */
+exports.DraggableList = createComponent('DraggableList', {
+    onUpdate: 'update',
+    onRemove: 'remove',
+    onDragStart: 'dragStart',
+    onDragEnd: 'dragEnd',
+});
+/**
+ * A sliding panel that appears from the edge of the screen, allowing users to access additional information or complete secondary tasks like forms without losing context of their primary workflow. Use instead of Modal when preserving the user's place on the page is important.
+ */
+exports.Drawer = createComponent('Drawer', {
+    onClose: 'close',
+});
+/**
+ * A popover menu that displays a list of actions or selectable options. Use for 3–15 choices triggered by a button; for form field selection, use Select instead.
+ */
+exports.Dropdown = createComponent('Dropdown', {
+    onChange: 'change',
+});
+/**
+ * A form input field for collecting email addresses with built-in format validation. Use for registration, login, subscriptions, and any context requiring a valid email. Do not use for non-email text like phone numbers or usernames — use Text instead.
+ */
+exports.Email = createComponent('Email', {
     onChange: 'change',
     onBlur: 'blur',
     onFocus: 'focus',
@@ -135,169 +292,640 @@ exports.WorkEmail = createComponent('WorkEmail', {
     onMouseenter: 'mouseenter',
     onMouseleave: 'mouseleave',
 });
-exports.Percentage = createComponent('Percentage', { onChange: 'change', onBlur: 'blur' });
-exports.SegmentedControl = createComponent('SegmentedControl', { onChange: 'change', onBlur: 'blur' });
-exports.Time = createComponent('Time', { onChange: 'change', onBlur: 'blur' });
-exports.TimeRange = createComponent('TimeRange', { onChange: 'change', onBlur: 'blur' });
-exports.Timezone = createComponent('Timezone', { onChange: 'change', onBlur: 'blur', onFocus: 'focus' });
-exports.Slider = createComponent('Slider', {
+/**
+ * A collapsible panel that expands or contracts to reveal additional detailed information. Use to organize related content within limited space, such as FAQs, settings menus, or side panels. Prefer a full scrolling page when users need to read all content.
+ */
+exports.ExpansionPanel = createComponent('ExpansionPanel', { onToggle: 'toggle' });
+/**
+ * A container that coordinates multiple ExpansionPanel children, optionally enforcing accordion behavior where only one panel can be open at a time. Use to organize related content into collapsible sections within limited space.
+ */
+exports.ExpansionPanelGroup = createComponent('ExpansionPanelGroup');
+/**
+ * A layout wrapper that provides consistent structure around form inputs, including a label, required indicator, helper or error message, tooltip, read-only mode, and inline (side-by-side) layout option. Use Field to wrap any form input component.
+ */
+exports.Field = createComponent('Field');
+/**
+ * A compact file upload input for selecting one or more files via browse or drag-and-drop. Supports file type restrictions, size limits, and upload progress. Use for inline file fields in forms; use FileDrop for larger drag-and-drop zones with labels and validation.
+ */
+exports.File = createComponent('File', {
     onChange: 'change',
-    onBlur: 'blur',
-    onBeforeChange: 'beforeChange',
-    onAfterChange: 'afterChange',
+    onDelete: 'delete',
 });
-exports.RangeSlider = createComponent('RangeSlider', {
+/**
+ * A file upload input that allows users to drag and drop files into a drop zone or click to browse. Supports single or multiple file uploads with configurable file type restrictions, size limits, and optional image cropping.
+ */
+exports.FileDrop = createComponent('FileDrop', {
     onChange: 'change',
-    onBeforeChange: 'beforeChange',
-    onAfterChange: 'afterChange',
     onBlur: 'blur',
 });
-exports.Masker = createComponent('Masker', { onChange: 'change', onBlur: 'blur' });
-exports.DaySelector = createComponent('DaySelector', { onChange: 'change' });
-exports.ColorPicker = createComponent('ColorPicker', { onChange: 'change', onBlur: 'blur' });
-exports.SelectableGroup = createComponent('SelectableGroup', { onChange: 'change' });
-exports.Ssn = createComponent('Ssn', { onChange: 'change', onBlur: 'blur' });
-exports.Sin = createComponent('Sin', { onChange: 'change', onBlur: 'blur' });
-exports.Signature = createComponent('Signature', { onChange: 'change' });
-exports.Survey = createComponent('Survey', { onChange: 'change' });
-exports.Tree = createComponent('Tree', { onChange: 'change', onFooterAction: 'footerAction' });
-exports.TreeSelect = createComponent('TreeSelect', { onChange: 'change' });
-exports.File = createComponent('File', { onChange: 'change', onDelete: 'delete' });
-exports.InputGroup = createComponent('InputGroup');
-exports.Field = createComponent('Field');
-exports.ActionCard = createComponent('ActionCard', {
-    onPressPrimary: 'pressPrimary',
-    onPressSecondary: 'pressSecondary',
-});
-exports.Alert = createComponent('Alert', {
-    onPressPrimary: 'pressPrimary',
-    onPressSecondary: 'pressSecondary',
-    onDismiss: 'dismiss',
+/**
+ * A floating action button (FAB) that highlights the primary action on a screen, staying visible above other content. Uses an icon only (no text label) and typically appears once per screen for key tasks like creating, favoriting, or sharing.
+ */
+exports.FloatingButton = createComponent('FloatingButton', {
+    onPress: 'press',
+    onPressWhileDisabled: 'pressWhileDisabled',
+    onMouseEnter: 'mouseEnter',
+    onMouseLeave: 'mouseLeave',
 });
-exports.Avatar = createComponent('Avatar', { onPress: 'press' });
-exports.Badge = createComponent('Badge');
-exports.Chip = createComponent('Chip', { onDismiss: 'dismiss', onPress: 'press' });
-exports.Card = createComponent('Card', {
-    onEdit: 'edit',
-    onDelete: 'delete',
-    onAdd: 'add',
-    onClick: 'click',
-    onAction: 'action',
+/**
+ * Data grid for displaying tabular data. Each column defines a header, data key path, and cell type. Use $bindState on selectedRow to capture clicked row data. Data is an array of row objects with _key as unique identifier.
+ */
+exports.Grid = createComponent('Grid', {
+    onRowClick: 'rowClick',
+    onRowAction: 'rowAction',
+    onHeaderAction: 'headerAction',
 });
-exports.ContentLoader = createComponent('ContentLoader');
-exports.Divider = createComponent('Divider');
+/**
+ * Horizontal stack layout that arranges children side-by-side in a row with token-based spacing. Use for placing elements next to each other horizontally — e.g. side-by-side form fields, button groups, or inline icon-and-text pairs. Prefer VStack for vertical stacking and Box for complex layouts needing custom dimensions, borders, or backgrounds.
+ */
+exports.HStack = createComponent('HStack');
+/**
+ * A semantic heading element (h1–h6) for page titles and section headers that establishes document hierarchy. Use for structural headings only — for body text or paragraphs use Paragraph, and for a title paired with a subtitle use TitleCaption.
+ */
+exports.Heading = createComponent('Heading');
+/**
+ * A standalone icon element from the Pebble icon set. Use for decorative or interactive icon displays — as clickable action triggers, status indicators, or visual accents. Supports tooltips and full ARIA attributes for accessibility.
+ */
 exports.Icon = createComponent('Icon', { onPress: 'press' });
-exports.Label = createComponent('Label');
-exports.ListItem = createComponent('ListItem', { onPress: 'press' });
-exports.Modal = createComponent('Modal', { onClose: 'close' });
-exports.ModalFooter = createComponent('ModalFooter');
-exports.ProgressBar = createComponent('ProgressBar');
-exports.Skeleton = createComponent('Skeleton');
-exports.Spinner = createComponent('Spinner');
-exports.Stepper = createComponent('Stepper', { onClick: 'click' });
-exports.TextClip = createComponent('TextClip');
-exports.TextSnippet = createComponent('TextSnippet');
-exports.Tip = createComponent('Tip');
-exports.CheckList = createComponent('CheckList', { onChange: 'change' });
-exports.DistributionBar = createComponent('DistributionBar');
+/**
+ * An icon-only button for repeated, common, or persistent actions when screen real estate is limited. Use for well-known actions like search, refresh, edit, or navigation — use a regular Button with text when the action is critical or requires more context.
+ */
+exports.IconButton = createComponent('IconButton', {
+    onPress: 'press',
+    onPressWhileDisabled: 'pressWhileDisabled',
+    onMouseEnter: 'mouseEnter',
+    onMouseLeave: 'mouseLeave',
+});
+/**
+ * Displays an image with optional theme-aware light/dark sources, lazy loading, and click interaction. Use for static or decorative images — use Avatar for user profile pictures, Icon for symbolic glyphs, or ImageViewer for zoomable image galleries.
+ */
+exports.Image = createComponent('Image', {
+    onPress: 'press',
+    onLoad: 'load',
+    onError: 'error',
+});
+/**
+ * Displays an image thumbnail that expands into a full-size overlay with zoom when clicked. Use for previewing images such as uploaded documents, photos, or screenshots where users need to inspect detail.
+ */
 exports.ImageViewer = createComponent('ImageViewer');
-exports.ObjectUI = createComponent('ObjectUI');
-exports.ObjectUITemplate = createComponent('ObjectUITemplate');
-exports.ObjectUIHeader = createComponent('ObjectUIHeader');
-exports.ObjectUIContent = createComponent('ObjectUIContent');
-exports.ObjectUIStats = createComponent('ObjectUIStats', { onActionClick: 'actionClick' });
-exports.SnackBar = createComponent('SnackBar', { onDismiss: 'dismiss' });
-exports.Video = createComponent('Video');
-exports.AvatarList = createComponent('AvatarList');
-exports.Image = createComponent('Image', { onPress: 'press', onLoad: 'load', onError: 'error' });
-exports.AtomsSeparator = createComponent('AtomsSeparator');
-exports.Carousel = createComponent('Carousel', { onDone: 'done' });
-exports.TableBasic = createComponent('TableBasic');
+/**
+ * Combines multiple input fields (e.g. a Select prefix with a Text input) into a single visually unified group with shared sizing, disabled, invalid, and read-only state. Use for composite inputs like currency amount with currency selector, or phone number with country code.
+ */
+exports.InputGroup = createComponent('InputGroup');
+/**
+ * A compact prev/next control for stepping through items one at a time, displaying "X of Y items" with previous and next buttons. Use for sequential item-by-item navigation such as cycling through detail views of records, search results, or review queues — not for page-based navigation (use Pagination instead).
+ */
+exports.ItemNavigator = createComponent('ItemNavigator', {
+    onNext: 'next',
+    onPrevious: 'previous',
+});
+/**
+ * A static, non-interactive identifier representing a status, property, or other highlighted metadata about an item. Use for categorizing or labeling items with short keywords like "New", "Recommended", or "High Priority". For interactive tagging use Chip; for live status updates use Status.
+ */
+exports.Label = createComponent('Label');
+/**
+ * A layout container for grouping multiple Label components together, with automatic wrapping and overflow handling. When labels exceed a configured row limit, excess labels collapse into a "+N more" indicator that opens a modal. Use when displaying a set of categorization or metadata labels on an item.
+ */
+exports.LabelGroup = createComponent('LabelGroup');
+/**
+ * A flex-based container for arranging child elements with control over direction, alignment, spacing, dimensions, and styling. Use Layout for general-purpose page structure and custom layouts. Prefer VStack or HStack for simple vertical or horizontal stacking.
+ */
+exports.Layout = createComponent('Layout');
+/**
+ * A standard card container for creating card-based page layouts with configurable padding and an optional selectable theme for selection interfaces.
+ */
+exports.LayoutCard = createComponent('LayoutCard', {
+    onPress: 'press',
+});
+/**
+ * A clickable text hyperlink for navigating to URLs or downloading files. Use for inline or standalone text links — use Button for actions that don't navigate, and Breadcrumb for hierarchical navigation trails.
+ */
+exports.Link = createComponent('Link', { onPress: 'press' });
+/**
+ * A structured list entry for displaying related entities vertically, with a title and optional caption. Use within grouped lists to present items for scanning, selection, or action.
+ */
+exports.ListItem = createComponent('ListItem', {
+    onPress: 'press',
+});
+/**
+ * A skeleton placeholder shaped like a card, shown while card content is loading. Use inside a Card.Group context to match card dimensions and reduce perceived loading time. Set isGridView for grid-based layouts.
+ */
+exports.LoaderCard = createComponent('LoaderCard');
+/**
+ * A specialized card for displaying a physical location with its nickname and formatted address. Supports edit/delete actions, custom dropdown actions, and navigation links to location details.
+ */
 exports.LocationCard = createComponent('LocationCard', {
     onEdit: 'edit',
     onDelete: 'delete',
     onClick: 'click',
     onAction: 'action',
 });
-exports.LoaderCard = createComponent('LoaderCard');
-exports.LayoutCard = createComponent('LayoutCard', { onPress: 'press' });
-exports.AppGroupLoader = createComponent('AppGroupLoader');
-exports.ChartLoader = createComponent('ChartLoader');
-exports.ReportLoader = createComponent('ReportLoader');
-exports.ReportShareLoader = createComponent('ReportShareLoader');
-exports.ReportViewerLoader = createComponent('ReportViewerLoader');
-exports.SettingsLoader = createComponent('SettingsLoader');
-exports.ChipGroup = createComponent('ChipGroup', { onOverflowChange: 'overflowChange' });
-exports.ModalCloseButton = createComponent('ModalCloseButton');
-exports.Status = createComponent('Status');
-exports.ApiError = createComponent('ApiError');
-exports.Circle = createComponent('Circle');
-exports.CountDown = createComponent('CountDown');
-exports.Country = createComponent('Country');
-exports.ToggleableArrow = createComponent('ToggleableArrow');
-exports.TitleCaption = createComponent('TitleCaption');
-exports.AiIcon = createComponent('AiIcon');
-exports.Breadcrumb = createComponent('Breadcrumb', { onSelect: 'select' });
-exports.Button = createComponent('Button', {
-    onPress: 'press',
-    onPressWhileDisabled: 'pressWhileDisabled',
-    onMouseEnter: 'mouseEnter',
-    onMouseLeave: 'mouseLeave',
+/**
+ * A text input that enforces a specific format pattern using mask characters (e.g. phone numbers, SSNs, postal codes). Use when the input value must conform to a known fixed-length pattern with digit, letter, or mixed character slots.
+ */
+exports.Masker = createComponent('Masker', {
+    onChange: 'change',
+    onBlur: 'blur',
 });
-exports.ButtonGroup = createComponent('ButtonGroup');
-exports.DraggableList = createComponent('DraggableList', {
-    onUpdate: 'update',
-    onRemove: 'remove',
-    onDragStart: 'dragStart',
-    onDragEnd: 'dragEnd',
+/**
+ * A dropdown menu list that displays selectable actions or options. Use for context menus, action menus, or option pickers where items need to be selected from a list. Items can use WARNING type for cautionary actions or ALERT type for destructive actions like delete.
+ */
+exports.MenuList = createComponent('MenuList', {
+    onSelect: 'select',
 });
-exports.Drawer = createComponent('Drawer', { onClose: 'close' });
-exports.Dropdown = createComponent('Dropdown', { onChange: 'change' });
-exports.ExpansionPanel = createComponent('ExpansionPanel', { onToggle: 'toggle' });
-exports.ExpansionPanelGroup = createComponent('ExpansionPanelGroup');
-exports.FloatingButton = createComponent('FloatingButton', {
-    onPress: 'press',
-    onPressWhileDisabled: 'pressWhileDisabled',
-    onMouseEnter: 'mouseEnter',
-    onMouseLeave: 'mouseLeave',
+/**
+ * An interactive overlay that demands user attention and input, isolating specific tasks or information above the main page content. Use for confirmations, urgent notifications, or brief focused tasks that require an immediate response.
+ */
+exports.Modal = createComponent('Modal', { onClose: 'close' });
+/**
+ * A button placed inside a Modal that dismisses the dialog when clicked. Used as the cancel or close action in modal footers, allowing users to exit without completing the modal task.
+ */
+exports.ModalCloseButton = createComponent('ModalCloseButton');
+/**
+ * Footer section of a Modal that holds primary action buttons for task completion or cancellation. Use inside a Modal as the bottom bar for confirm/cancel actions.
+ */
+exports.ModalFooter = createComponent('ModalFooter');
+/**
+ * A hierarchical nested list for displaying complex data structures like categories and subcategories, supporting up to four levels of expandable/collapsible nesting. Use for organizing large amounts of nested information such as organizational structures or department lists.
+ */
+exports.NestedList = createComponent('NestedList', {
+    onToggle: 'toggle',
+    onSelect: 'select',
 });
-exports.IconButton = createComponent('IconButton', {
-    onPress: 'press',
-    onPressWhileDisabled: 'pressWhileDisabled',
-    onMouseEnter: 'mouseEnter',
-    onMouseLeave: 'mouseLeave',
+/**
+ * A general-purpose numeric input for entering whole or decimal numbers. Supports min/max range constraints, step increments, locale-aware formatting, and inline arithmetic evaluation. Use for quantities, counts, measurements, or any plain number entry — use Currency for monetary amounts, Percentage for percent values, or Slider/RangeSlider for visual range selection.
+ */
+exports.Number = createComponent('Number', {
+    onChange: 'change',
+    onBlur: 'blur',
+    onChangeRaw: 'changeRaw',
+    onChangeCalculationState: 'changeCalculationState',
 });
-exports.ItemNavigator = createComponent('ItemNavigator', { onNext: 'next', onPrevious: 'previous' });
-exports.Link = createComponent('Link', { onPress: 'press' });
-exports.MenuList = createComponent('MenuList', { onSelect: 'select' });
-exports.NestedList = createComponent('NestedList', { onToggle: 'toggle', onSelect: 'select' });
-exports.Paginate = createComponent('Paginate', { onChange: 'change' });
-exports.SelectableMenu = createComponent('SelectableMenu', { onChange: 'change' });
-exports.ShowMore = createComponent('ShowMore');
-exports.Tab = createComponent('Tab', { onChange: 'change' });
-exports.Heading = createComponent('Heading');
-exports.Text = createComponent('Text');
-exports.Box = createComponent('Box');
-exports.Grid = createComponent('Grid', {
-    onRowClick: 'rowClick',
-    onRowAction: 'rowAction',
-    onHeaderAction: 'headerAction',
+/**
+ * A modular component that presents a high-level overview of an entity (person, organization, device) with an avatar, title, and caption. Typically placed at the top of a detail page below navigation. Use Cards for detailed entity info, Lists for comparing multiple items, or Tables for large sortable datasets.
+ */
+exports.ObjectUI = createComponent('ObjectUI');
+/**
+ * The main body content area of an ObjectUI entity detail page. Place below ObjectUIHeader (and optionally ObjectUIStats) inside ObjectUITemplate to hold the detailed content for the entity.
+ */
+exports.ObjectUIContent = createComponent('ObjectUIContent');
+/**
+ * Header section of an entity overview (person, organization, device) displaying an avatar, title, and caption. Used at the top of ObjectUI layouts to identify the entity at a glance.
+ */
+exports.ObjectUIHeader = createComponent('ObjectUIHeader');
+/**
+ * A grid section within ObjectUI that displays key-value statistics about an entity (person, organization, device), with optional tooltips on stat labels and icon action buttons.
+ */
+exports.ObjectUIStats = createComponent('ObjectUIStats', {
+    onActionClick: 'actionClick',
 });
-exports.HStack = createComponent('HStack');
-exports.LabelGroup = createComponent('LabelGroup');
-exports.Layout = createComponent('Layout');
+/**
+ * The root container for an ObjectUI entity detail page that presents a high-level overview of an entity (person, organization, device). Place ObjectUIHeader, ObjectUIStats, and ObjectUIContent as children. Use ObjectUITemplate when you need a structured entity overview at the top of a page; use Cards for detailed entity info, Lists for comparing multiple items, or Tables for large sortable datasets.
+ */
+exports.ObjectUITemplate = createComponent('ObjectUITemplate');
+/**
+ * Branded header for an application or module page, displaying the app logo, title, optional subtitle, and optional help/support link. Use at the top of a page to identify which app the user is in.
+ */
+exports.PageAppLogo = createComponent('PageAppLogo');
+/**
+ * The standard wrapper for a page's main body area. Controls maximum content width (584–1544px or FLUID for edge-to-edge) and horizontal alignment (center, left, right). Use PageContent for every page-level content region, whether constrained to a fixed width or stretched full-width.
+ */
 exports.PageContent = createComponent('PageContent');
+/**
+ * A persistent footer bar at the bottom of a page, typically used for primary navigation actions like "Continue" or "Submit". Supports a built-in continue button (via the continue event) or custom child content for more complex footer layouts. Use shouldBeSticky to keep it visible at the bottom of the viewport as the user scrolls.
+ */
+exports.PageFooter = createComponent('PageFooter', {
+    onContinue: 'continue',
+});
+/**
+ * A top-of-page header displaying a title and optional caption, used inside a page layout alongside PageContent and PageFooter. Use size to match the PageContent width.
+ */
 exports.PageHeader = createComponent('PageHeader');
-exports.PageAppLogo = createComponent('PageAppLogo');
-exports.PageFooter = createComponent('PageFooter', { onContinue: 'continue' });
+/**
+ * A navigation control that breaks large content into smaller pages, commonly used with data tables and content-rich views. Use when loading all data at once is impractical or when content is too large for a single view.
+ */
+exports.Paginate = createComponent('Paginate', {
+    onChange: 'change',
+});
+/**
+ * An individual panel within a SplitPane container. Each Pane defines its own size constraints, collapse priority, and resize behavior. Must be a direct child of SplitPane.
+ */
 exports.Pane = createComponent('Pane', {
     onCollapsedChange: 'collapsedChange',
     onDismiss: 'dismiss',
     onResize: 'resize',
 });
+/**
+ * A secure input field for entering or creating passwords, with automatic character masking and an optional visibility toggle. Use in login, signup, or verification flows.
+ */
+exports.Password = createComponent('Password', {
+    onChange: 'change',
+    onBlur: 'blur',
+    onFocus: 'focus',
+    onClick: 'click',
+    onKeydown: 'keydown',
+    onKeyup: 'keyup',
+    onPaste: 'paste',
+    onMouseenter: 'mouseenter',
+    onMouseleave: 'mouseleave',
+    onReveal: 'reveal',
+});
+/**
+ * A numeric input for entering and editing percentage values. Automatically appends a % suffix, supports decimal precision, negative values, and upper/lower bounds. Use for financial calculations, progress indicators, or statistical entries requiring percentage values.
+ */
+exports.Percentage = createComponent('Percentage', {
+    onChange: 'change',
+    onBlur: 'blur',
+});
+/**
+ * A specialized input for entering and editing phone numbers with automatic region-based formatting, international support, and an optional country code dropdown selector.
+ */
+exports.Phone = createComponent('Phone', {
+    onChange: 'change',
+    onBlur: 'blur',
+    onFocus: 'focus',
+    onClick: 'click',
+    onKeydown: 'keydown',
+    onKeyup: 'keyup',
+    onPaste: 'paste',
+    onMouseenter: 'mouseenter',
+    onMouseleave: 'mouseleave',
+    onCountryCodeChange: 'countryCodeChange',
+});
+/**
+ * Communicates the status of an ongoing process, like downloading or uploading files, to inform the user of the remaining wait time. Use determinate mode when progress percentage is known, or indeterminate when wait time cannot be calculated. For multi-step processes requiring user action, use ProgressSteps instead; for a simple busy indicator, use Spinner.
+ */
+exports.ProgressBar = createComponent('ProgressBar');
+/**
+ * A multi-step progress indicator that visually shows completed, current, and upcoming steps in a sequential workflow. Use for onboarding flows, form wizards, or any multi-part process where users need to see their progress.
+ */
+exports.ProgressSteps = createComponent('ProgressSteps');
+/**
+ * Radio buttons let users choose a single option from two or more mutually exclusive options. Prefer over Select when showing 5 or fewer options that need to be immediately visible. Use Checkbox instead when multiple selections are allowed.
+ */
+exports.Radio = createComponent('Radio', {
+    onChange: 'change',
+    onBlur: 'blur',
+    onMouseenter: 'mouseenter',
+    onMouseleave: 'mouseleave',
+});
+/**
+ * A two-handle slider for selecting a numeric range within a track. Use for defining min/max boundaries such as price filters or value ranges.
+ */
+exports.RangeSlider = createComponent('RangeSlider', {
+    onChange: 'change',
+    onBeforeChange: 'beforeChange',
+    onAfterChange: 'afterChange',
+    onBlur: 'blur',
+});
+/**
+ * A skeleton placeholder shown while tabular report content is loading. Use when the content area will contain a data report with header and detail rows, and you want to reduce perceived loading time and prevent layout shift.
+ */
+exports.ReportLoader = createComponent('ReportLoader');
+/**
+ * A skeleton placeholder shown while report sharing content is loading. Use when the report share dialog or page layout is known and you want to reduce perceived loading time and prevent layout shift. Renders a header, description, and two side-by-side content blocks (stacking on mobile).
+ */
+exports.ReportShareLoader = createComponent('ReportShareLoader');
+/**
+ * A skeleton placeholder shown while report viewer content is loading. Use when the content area will contain a report viewer with sidebar navigation and a main report content area, and you want to reduce perceived loading time and prevent layout shift.
+ */
+exports.ReportViewerLoader = createComponent('ReportViewerLoader');
+/**
+ * Conditionally show or hide content based on container or viewport width breakpoints, enabling responsive layouts that adapt to different screen and panel sizes. Use to hide non-essential UI at narrow widths or show alternative layouts at wider breakpoints.
+ */
 exports.Responsive = createComponent('Responsive');
+/**
+ * A linear set of buttons for toggling between closely related choices (2-5 short-label options) and instantly applying a selection. Supports single, multi, and range selection modes. NOT suitable for binary (2-option) choices — use Toggle or ToggleButton instead. Prefer over Radio when options are short labels needing a compact inline layout; use Radio for longer phrases, Tabs for content navigation.
+ */
+exports.SegmentedControl = createComponent('SegmentedControl', {
+    onChange: 'change',
+    onBlur: 'blur',
+});
+/**
+ * A dropdown input that lets users choose one or more options from a predefined list. Use for long lists, searchable lists, or constrained spaces. Use Radio or Checkbox cards instead when there are few options and the selection is a key part of the flow.
+ */
+exports.Select = createComponent('Select', {
+    onChange: 'change',
+    onBlur: 'blur',
+    onFocus: 'focus',
+    onPaste: 'paste',
+    onMenuToggle: 'menuToggle',
+});
+/**
+ * A card-based selection input that renders a group of selectable cards for single or multi-choice picking. Use when users need to choose from a small set of visually rich options displayed as cards (e.g. plans, locations, tiers). Use Radio for simple text-only single choice, or Select for long option lists in a dropdown.
+ */
+exports.SelectableGroup = createComponent('SelectableGroup', {
+    onChange: 'change',
+});
+/**
+ * A dropdown menu that displays selectable options, allowing users to choose from a list of actions or settings. Includes a built-in trigger button. Deprecated — prefer Dropdown for new specs.
+ */
+exports.SelectableMenu = createComponent('SelectableMenu', { onChange: 'change' });
+/**
+ * A skeleton placeholder shown while settings page content is loading. Use when the content area will contain a settings form with label/value rows, and you want to reduce perceived loading time and prevent layout shift. Supports optional centering and custom margin.
+ */
+exports.SettingsLoader = createComponent('SettingsLoader');
+/**
+ * A container that truncates a list of child elements, showing only the first N items with a "Show all" / "Show less" toggle button. Use to reduce visual clutter in long lists while keeping all items accessible on demand.
+ */
+exports.ShowMore = createComponent('ShowMore');
+/**
+ * A signature capture input that lets users sign by drawing on a canvas or typing their name. Use for legally binding agreements, contracts, or any workflow requiring a personal signature.
+ */
+exports.Signature = createComponent('Signature', {
+    onChange: 'change',
+});
+/**
+ * A specialized masked input for entering Canadian Social Insurance Numbers (SIN). Automatically formats the 9-digit value as "XXX XXX XXX" while storing the unmasked digits. Use for Canadian employee or tax forms requiring a SIN — use Ssn for US Social Security Numbers, or Masker for other custom-format masked inputs.
+ */
+exports.Sin = createComponent('Sin', {
+    onChange: 'change',
+    onBlur: 'blur',
+});
+/**
+ * An animated placeholder that mimics the shape of content while it loads, available in text (lines), circle, and box variants.
+ */
+exports.Skeleton = createComponent('Skeleton');
+/**
+ * An interactive control for selecting a single numeric value within a defined range by dragging a handle along a horizontal track. Use for numeric ranges like 0–100; do not use for extremely large ranges (e.g. 1–1000) or non-numeric values.
+ */
+exports.Slider = createComponent('Slider', {
+    onChange: 'change',
+    onBlur: 'blur',
+    onBeforeChange: 'beforeChange',
+    onAfterChange: 'afterChange',
+});
+/**
+ * A passive notification that appears at the bottom of the screen to provide quick, at-a-glance feedback on the outcome of an action. Use for non-critical, supplementary messages that do not require user action — for critical messages requiring acknowledgment, use a Modal instead.
+ */
+exports.SnackBar = createComponent('SnackBar', {
+    onDismiss: 'dismiss',
+});
+/**
+ * A progress indicator for communicating that a process or task is currently underway without a known completion time. Use ProgressBar instead when the completion percentage is known.
+ */
+exports.Spinner = createComponent('Spinner');
+/**
+ * A compound button that combines a primary action with a secondary trailing button, typically opening a dropdown of alternative actions. Use when the user has a main action with related alternatives (e.g. "Save" with "Save as draft", "Save and publish").
+ */
+exports.SplitButton = createComponent('SplitButton', {
+    onPress: 'press',
+    onDropdownChange: 'dropdownChange',
+});
+/**
+ * A multi-pane layout container that arranges child Pane components side-by-side with support for resizing, collapsing, and responsive behavior. Use for master-detail views, sidebars, and split-screen interfaces where panels need independent sizing and collapse control.
+ */
 exports.SplitPane = createComponent('SplitPane');
+/**
+ * A specialized masked input for collecting US Social Security Numbers (SSN). Automatically formats display as XXX-XX-XXXX while storing the raw 9-digit value. Use for any form field that requires an SSN; use Text for general text or Password for secret credentials.
+ */
+exports.Ssn = createComponent('Ssn', {
+    onChange: 'change',
+    onBlur: 'blur',
+});
+/**
+ * A static indicator of real-time state or condition, such as availability, progress, or publication status. Displays a colored dot alongside a text label. Use Label instead for categorizing or organizing items with keywords.
+ */
+exports.Status = createComponent('Status');
+/**
+ * A progress indicator that guides users through multi-step sequential workflows by displaying completed steps, current position, and upcoming tasks. Best for linear processes with 3-7 steps such as checkout flows, onboarding sequences, or form wizards. Not suitable for non-linear workflows or processes with fewer than three steps.
+ */
+exports.Stepper = createComponent('Stepper', {
+    onClick: 'click',
+});
+/**
+ * A button-group input for collecting ratings or opinions on a Likert scale (e.g. 1–5 or 1–10). Renders each option as a clickable button with optional range labels for the endpoints. Supports single or multi-select. Use for satisfaction surveys, NPS scores, or opinion scales. Use Radio for mutually exclusive text choices, SegmentedControl for toggling between named options, or Slider for continuous numeric ranges.
+ */
+exports.Survey = createComponent('Survey', {
+    onChange: 'change',
+});
+/**
+ * A toggle that lets users switch instantly between on and off states. Use for activation settings that take effect immediately; use Checkbox instead for selection or agreement scenarios that require submission.
+ */
+exports.Switch = createComponent('Switch', {
+    onChange: 'change',
+    onBlur: 'blur',
+});
+/**
+ * Labeled controls for alternating between related views within the same page or context. Use to organize groups of related content at the same hierarchy level; for selection within a single view, use a segmented control instead.
+ */
+exports.Tab = createComponent('Tab', { onChange: 'change' });
+/**
+ * A read-only data table for displaying moderately large amounts of information in rows and columns. Use for structured, text-based data that benefits from systematic organization and easy scanning. For sorting, filtering, or cell-level interaction, use Grid instead; for simple vertical lists without column headings, use ListItem.
+ */
+exports.TableBasic = createComponent('TableBasic');
+/**
+ * A general-purpose text component for rendering body copy, descriptions, captions, and other non-heading text content. Defaults to a paragraph (<p>) with body-medium typestyle. Use Heading instead for section titles (h1–h6), and TitleCaption for a title paired with a subtitle.
+ */
+exports.Text = createComponent('Text');
+/**
+ * An autocomplete input that offers text suggestions in a dropdown menu as the user types. Unlike Select, users can either manually type free-form text or pick from the suggestions list.
+ */
+exports.TextAutoSuggest = createComponent('TextAutoSuggest', {
+    onChange: 'change',
+    onBlur: 'blur',
+    onFocus: 'focus',
+    onClick: 'click',
+});
+/**
+ * Displays extensive text or content in a compact area by clipping it at a specified height, with an expand/collapse toggle for full viewing. Use when space is limited but more information is available. Use ExpansionPanel instead for multiple collapsible sections, or Tooltip for brief hover-only content.
+ */
+exports.TextClip = createComponent('TextClip');
+/**
+ * A single-line text input for collecting short-form text data such as names, emails, URLs, or search queries. Use TextArea for multi-line content or Number for numeric-only values.
+ */
+exports.TextInput = createComponent('TextInput', {
+    onChange: 'change',
+    onBlur: 'blur',
+    onFocus: 'focus',
+    onClick: 'click',
+    onKeydown: 'keydown',
+    onKeyup: 'keyup',
+    onPaste: 'paste',
+    onMouseenter: 'mouseenter',
+    onMouseleave: 'mouseleave',
+});
+/**
+ * A read-only text block with a one-click action to copy its content to the clipboard or download it as a file. Use for command-line instructions, code snippets, API keys, or any text the user needs to grab verbatim.
+ */
+exports.TextSnippet = createComponent('TextSnippet');
+/**
+ * A multi-line text input for entering longer free-form text such as comments, descriptions, or paragraphs. Use TextInput instead for short single-line entries.
+ */
+exports.Textarea = createComponent('Textarea', {
+    onChange: 'change',
+    onBlur: 'blur',
+    onFocus: 'focus',
+});
+/**
+ * A form input for entering or selecting a specific time of day. Supports typed entry, optional dropdown time selection, timezone display, and locale-aware formatting.
+ */
+exports.Time = createComponent('Time', {
+    onChange: 'change',
+    onBlur: 'blur',
+});
+/**
+ * A time range input for selecting a start and end time pair, such as work schedules, shifts, or availability windows. Stores a [startTime, endTime] tuple of ISO 8601 strings. Supports timezone display and next-day span detection.
+ */
+exports.TimeRange = createComponent('TimeRange', {
+    onChange: 'change',
+    onBlur: 'blur',
+});
+/**
+ * A specialized select component for choosing a timezone. Lists all IANA timezones with search filtering. Use this when the user needs to pick a standalone timezone; use Time with timezone instead when selecting a time together with a timezone.
+ */
+exports.Timezone = createComponent('Timezone', {
+    onChange: 'change',
+    onBlur: 'blur',
+    onFocus: 'focus',
+});
+/**
+ * A supportive floating text box that offers contextual details about an associated element when hovered over or focused. Use for supplementary, non-critical information such as labelling icon buttons or describing ambiguous UI elements.
+ */
+exports.Tip = createComponent('Tip');
+/**
+ * A compact title-and-caption pair for displaying a primary label with an optional secondary descriptor, such as a person's name with their job title or a heading with a subtitle.
+ */
+exports.TitleCaption = createComponent('TitleCaption');
+/**
+ * A chevron arrow indicator that toggles between down (collapsed) and up (expanded) directions. Use as a standalone expand/collapse affordance, such as in custom collapsible sections or tree nodes.
+ */
+exports.ToggleableArrow = createComponent('ToggleableArrow');
+/**
+ * A hierarchical selector for choosing from a tree-structured list of parent-child relationships with expand/collapse navigation. Use for selecting from deeply nested data like org structures, file systems, directories, or classification hierarchies.
+ */
+exports.Tree = createComponent('Tree', {
+    onChange: 'change',
+    onFooterAction: 'footerAction',
+});
+/**
+ * A dropdown select component with a hierarchical tree structure for choosing from nested parent-child options. Use when users need to pick from deeply nested data like org structures, file systems, or classification hierarchies, but the tree should stay collapsed behind a dropdown trigger. Use Tree instead when the hierarchy should be visible at all times.
+ */
+exports.TreeSelect = createComponent('TreeSelect', {
+    onChange: 'change',
+});
+/**
+ * Vertical stack layout that arranges children top-to-bottom in a column with token-based spacing. Use for stacking elements vertically — e.g. form field groups, page sections, or lists of content blocks. Prefer HStack for horizontal side-by-side arrangement and Box for complex layouts needing custom dimensions, borders, or backgrounds.
+ */
 exports.VStack = createComponent('VStack');
+/**
+ * Embedded video player with 16:9 aspect ratio
+ */
+exports.Video = createComponent('Video');
+/**
+ * A specialized email input for entering work email addresses, featuring a domain suffix dropdown selector so users type only the username while choosing from a predefined list of company domains
+ */
+exports.WorkEmail = createComponent('WorkEmail', {
+    onChange: 'change',
+    onBlur: 'blur',
+    onFocus: 'focus',
+    onClick: 'click',
+    onKeydown: 'keydown',
+    onKeyup: 'keyup',
+    onPaste: 'paste',
+    onMouseenter: 'mouseenter',
+    onMouseleave: 'mouseleave',
+});
+/**
+ * Dashboard tile chrome with a fixed header (start: heading + sub-heading; end: optional configure button) and a children body. The header renders immediately when the spec lands so the chrome is visible while the body subtree resolves its run_query data through a WithSpinner. Use this instead of the legacy Card for every dashboard tile (KPI, visual chart, grid).
+ */
+exports.AnalyticsCard = createComponent('AnalyticsCard', {
+    onConfigure: 'configure',
+});
+/**
+ * Resizable dashboard board for AI widget layouts. Wraps each child in a Pebble ResizableBoard block.
+ */
+exports.ResizableBoard = createComponent('ResizableBoard');
+/**
+ * Raw ECharts renderer for SDUI. Provide a JSON-safe ECharts option object. It fills its parent card by default and keeps a usable minimum height when no fixed parent height exists; optional height/width can override sizing.
+ */
+exports.EChart = createComponent('EChart', {
+    onClick: 'click',
+    onLegendChange: 'legendChange',
+    onDataZoomChange: 'dataZoomChange',
+});
+/**
+ * Read-only HTML content rendered with the shared RichTextEditor (non-editable). Generic SDUI building block for narrative or explanatory copy in any product layout.
+ */
+exports.RichText = createComponent('RichText');
+/**
+ * Deprecated alias for RichText. Same props; prefer type `RichText` in new specs.
+ */
+exports.DashboardRichText = createComponent('DashboardRichText');
+/**
+ * Auto-fetching grid for Rippling Custom Objects. Provide objectApiName and fieldApiNames to display records with auto-generated columns, pagination, sorting, and field-type formatting. Increment refreshKey to force a data refresh after mutations.
+ */
 exports.CustomObjectGrid = createComponent('CustomObjectGrid');
+/**
+ * Full-featured object list page with list view management. Supports multiple list views, view switching, inline editing, bulk actions, and record management. Use objectApiName to specify the object. Optionally set defaultListViewId to pre-select a specific list view.
+ */
 exports.ObjectListView = createComponent('ObjectListView');
+/**
+ * Vertical bar chart powered by ECharts. Provide series (name + data array) and optional categories for the x-axis. Use showStackedPercent for 100%-stacked bars, showBarLabel to render values on bars, and showLegend to display a series legend. Use $bindState on selected to capture the clicked bar.
+ */
+exports.BarChart = createComponent('BarChart', {
+    onBarClick: 'barClick',
+});
+/**
+ * Line chart powered by ECharts. Provide series (name + data array) and optional categories for the x-axis. Use connectNulls to bridge null gaps, showAreaPercent for 100%-stacked area, and showLegend to display a series legend.
+ */
+exports.LineChart = createComponent('LineChart');
+/**
+ * Horizontal bar chart powered by ECharts. Same data shape as BarChart but renders bars horizontally. Categories appear on the y-axis and values on the x-axis.
+ */
+exports.HorizontalBarChart = createComponent('HorizontalBarChart');
+/**
+ * Combination chart with bars and lines on dual Y-axes. Bars use the left Y-axis by default; lines can use the right Y-axis via yAxisIndex: 1.
+ */
+exports.CombinationChart = createComponent('CombinationChart');
+/**
+ * Pie / donut chart. Each series entry has a data array of {name, value} pairs. Use radius: ["50%", "70%"] for a donut hole.
+ */
+exports.PieChart = createComponent('PieChart');
+/**
+ * Scatter plot. Each series contains [x, y] data pairs plotted as individual points.
+ */
+exports.ScatterChart = createComponent('ScatterChart');
+/**
+ * Funnel chart for conversion or stage-based data. Data items are ordered by value (largest at top).
+ */
+exports.FunnelChart = createComponent('FunnelChart');
+/**
+ * Gauge (speedometer) chart. Displays a single numeric value against colored segments. Segments define the scale breakpoints and their colors.
+ */
+exports.GaugeChart = createComponent('GaugeChart');
+/**
+ * Sunburst (multi-level pie) chart for hierarchical data. Each node has a name, optional value, and optional children array.
+ */
+exports.SunburstChart = createComponent('SunburstChart');
+/**
+ * Wrapper that shows a spinner while loading. Emits `load` once on mount so a handler can start fetching data. Renders children only when `isLoading` is false.
+ */
+exports.WithSpinner = createComponent('WithSpinner', {
+    onLoad: 'load',
+});
+/**
+ * Radar (spider) chart for comparing multiple variables across categories. Each indicator defines a spoke axis. Provide radarIndicators (axis definitions) and radarOptions (series data).
+ */
+exports.RadarChart = createComponent('RadarChart');
+/**
+ * Radar chart with filled area between data points and the center. Same data shape as RadarChart but renders with semi-transparent area fill for each series.
+ */
+exports.RadarFilledChart = createComponent('RadarFilledChart');
+/**
+ * Calendar heatmap chart that renders data points on a calendar grid. Each cell represents a day, colored by value intensity. Provide heatmapOptions with [date, value] data and calendarOptions with a date range.
+ */
+exports.HeatmapCalendarChart = createComponent('HeatmapCalendarChart');
+/**
+ * Grid-based heatmap chart for showing magnitude across two dimensions. Data format: [[xIndex, yIndex, value], …]. Provide category labels for both axes.
+ */
+exports.HeatmapChart = createComponent('HeatmapChart');
+/**
+ * Treemap chart for visualizing hierarchical data as nested rectangles. Each node has a name and either a numeric value (leaf) or children (branch). Rectangle size represents the value.
+ */
+exports.TreemapChart = createComponent('TreemapChart');
+/**
+ * Read-only SQL syntax highlighter powered by Monaco Editor. Renders a formatted, non-editable SQL block with auto-height based on line count and a max height cap.
+ */
+exports.SqlHighlight = createComponent('SqlHighlight');
 //# sourceMappingURL=components.js.map