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

package/src/lib/sdui/components.ts

@@ -1,12 +1,170 @@
 /**
- * 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
  */
 
 import type { ActionBinding } from './actions';
+import type { StateRef, BindStateRef } from './state';
+import type { CondRef, TemplateRef } from './props';
+import type { ItemRef, BindItemRef } from './directives';
+import type {
+  ActionCardCatalogProps,
+  AiIconCatalogProps,
+  AlertCatalogProps,
+  AnimationCatalogProps,
+  ApiErrorCatalogProps,
+  AppGroupLoaderCatalogProps,
+  AppGroupSelectCatalogProps,
+  AppNavBarCatalogProps,
+  AtomsSeparatorCatalogProps,
+  AvatarCatalogProps,
+  AvatarListCatalogProps,
+  BadgeCatalogProps,
+  BoxCatalogProps,
+  BreadcrumbCatalogProps,
+  ButtonCatalogProps,
+  ButtonGroupCatalogProps,
+  CardCatalogProps,
+  CardGroupCatalogProps,
+  CarouselCatalogProps,
+  ChartLoaderCatalogProps,
+  CheckListCatalogProps,
+  CheckboxCatalogProps,
+  CheckboxGroupCatalogProps,
+  ChipCatalogProps,
+  ChipGroupCatalogProps,
+  CircleCatalogProps,
+  ColorPickerCatalogProps,
+  ContentLoaderCatalogProps,
+  CountDownCatalogProps,
+  CountryCatalogProps,
+  CurrencyCatalogProps,
+  DateCatalogProps,
+  DateInlineMultiCatalogProps,
+  DateRangeCatalogProps,
+  DaySelectorCatalogProps,
+  DistributionBarCatalogProps,
+  DividerCatalogProps,
+  DraggableListCatalogProps,
+  DrawerCatalogProps,
+  DropdownCatalogProps,
+  EmailCatalogProps,
+  ExpansionPanelCatalogProps,
+  ExpansionPanelGroupCatalogProps,
+  FieldCatalogProps,
+  FileCatalogProps,
+  FileDropCatalogProps,
+  FloatingButtonCatalogProps,
+  GridCatalogProps,
+  HStackCatalogProps,
+  HeadingCatalogProps,
+  IconCatalogProps,
+  IconButtonCatalogProps,
+  ImageCatalogProps,
+  ImageViewerCatalogProps,
+  InputGroupCatalogProps,
+  ItemNavigatorCatalogProps,
+  LabelCatalogProps,
+  LabelGroupCatalogProps,
+  LayoutCatalogProps,
+  LayoutCardCatalogProps,
+  LinkCatalogProps,
+  ListItemCatalogProps,
+  LoaderCardCatalogProps,
+  LocationCardCatalogProps,
+  MaskerCatalogProps,
+  MenuListCatalogProps,
+  ModalCatalogProps,
+  ModalCloseButtonCatalogProps,
+  ModalFooterCatalogProps,
+  NestedListCatalogProps,
+  NumberCatalogProps,
+  ObjectUICatalogProps,
+  ObjectUIContentCatalogProps,
+  ObjectUIHeaderCatalogProps,
+  ObjectUIStatsCatalogProps,
+  ObjectUITemplateCatalogProps,
+  PageAppLogoCatalogProps,
+  PageContentCatalogProps,
+  PageFooterCatalogProps,
+  PageHeaderCatalogProps,
+  PaginateCatalogProps,
+  PaneCatalogProps,
+  PasswordCatalogProps,
+  PercentageCatalogProps,
+  PhoneCatalogProps,
+  ProgressBarCatalogProps,
+  ProgressStepsCatalogProps,
+  RadioCatalogProps,
+  RangeSliderCatalogProps,
+  ReportLoaderCatalogProps,
+  ReportShareLoaderCatalogProps,
+  ReportViewerLoaderCatalogProps,
+  ResponsiveCatalogProps,
+  SegmentedControlCatalogProps,
+  SelectCatalogProps,
+  SelectableGroupCatalogProps,
+  SelectableMenuCatalogProps,
+  SettingsLoaderCatalogProps,
+  ShowMoreCatalogProps,
+  SignatureCatalogProps,
+  SinCatalogProps,
+  SkeletonCatalogProps,
+  SliderCatalogProps,
+  SnackBarCatalogProps,
+  SpinnerCatalogProps,
+  SplitButtonCatalogProps,
+  SplitPaneCatalogProps,
+  SsnCatalogProps,
+  StatusCatalogProps,
+  StepperCatalogProps,
+  SurveyCatalogProps,
+  SwitchCatalogProps,
+  TabCatalogProps,
+  TableBasicCatalogProps,
+  TextCatalogProps,
+  TextAutoSuggestCatalogProps,
+  TextClipCatalogProps,
+  TextInputCatalogProps,
+  TextSnippetCatalogProps,
+  TextareaCatalogProps,
+  TimeCatalogProps,
+  TimeRangeCatalogProps,
+  TimezoneCatalogProps,
+  TipCatalogProps,
+  TitleCaptionCatalogProps,
+  ToggleableArrowCatalogProps,
+  TreeCatalogProps,
+  TreeSelectCatalogProps,
+  VStackCatalogProps,
+  VideoCatalogProps,
+  WorkEmailCatalogProps,
+  AnalyticsCardCatalogProps,
+  ResizableBoardCatalogProps,
+  EChartCatalogProps,
+  RichTextCatalogProps,
+  DashboardRichTextCatalogProps,
+  CustomObjectGridCatalogProps,
+  ObjectListViewCatalogProps,
+  BarChartCatalogProps,
+  LineChartCatalogProps,
+  HorizontalBarChartCatalogProps,
+  CombinationChartCatalogProps,
+  PieChartCatalogProps,
+  ScatterChartCatalogProps,
+  FunnelChartCatalogProps,
+  GaugeChartCatalogProps,
+  SunburstChartCatalogProps,
+  WithSpinnerCatalogProps,
+  RadarChartCatalogProps,
+  RadarFilledChartCatalogProps,
+  HeatmapCalendarChartCatalogProps,
+  HeatmapChartCatalogProps,
+  TreemapChartCatalogProps,
+  SqlHighlightCatalogProps,
+} from './propTypes';
 
 export interface SpecNode {
   type: string;
@@ -20,8 +178,34 @@ export interface SpecNode {
 
 type EventMap = Record<string, string>;
 
-function createComponent(type: string, eventMap: EventMap = {}) {
-  return (props: Record<string, unknown> = {}): SpecNode => {
+interface ComponentDirectives {
+  visible?: unknown;
+  watch?: Record<string, unknown>;
+  repeat?: { statePath: string; key?: string };
+}
+
+/**
+ * Wrap each prop with the set of runtime refs the renderer accepts in
+ * place of a literal value: state reads/binds, conditional/template
+ * expressions, and per-row item refs (inside repeat loops). This is what
+ * lets callers write `value: state.foo.$bind` or `label: cond(...)`
+ * against typed prop interfaces — the renderer dereferences these at
+ * runtime.
+ */
+type Bindable<T> = {
+  [K in keyof T]: T[K] | StateRef | BindStateRef | CondRef | TemplateRef | ItemRef | BindItemRef;
+};
+
+const hasOwn = Object.prototype.hasOwnProperty;
+
+// Conditional arg shape: when TProps has no required fields, the props
+// arg is optional (Button() works); when it does, it's required
+// (Badge() errors because text is required).
+type CreateComponentArgs<TProps> = {} extends TProps ? [props?: TProps] : [props: TProps];
+
+function createComponent<TProps>(type: string, eventMap: EventMap = {}) {
+  return (...args: CreateComponentArgs<TProps>): SpecNode => {
+    const props = (args[0] ?? {}) as Record<string, unknown>;
     const node: SpecNode = { type, props: {}, children: [] };
     for (const [key, value] of Object.entries(props)) {
       if (key === 'children') {
@@ -32,105 +216,427 @@ function createComponent(type: string, eventMap: EventMap = {}) {
         node.watch = value as Record<string, unknown>;
       } else if (key === 'repeat') {
         node.repeat = value as { statePath: string; key?: string };
-      } else if (eventMap[key]) {
-        node.on = node.on || {};
-        node.on[eventMap[key]] = value as ActionBinding | ActionBinding[];
       } 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 as ActionBinding | ActionBinding[];
+        } else {
+          node.props[key] = value;
+        }
       }
     }
     return node;
   };
 }
 
-export const TextInput = createComponent('TextInput', {
-  onChange: 'change',
-  onBlur: 'blur',
-  onFocus: 'focus',
-  onClick: 'click',
-  onKeydown: 'keydown',
-  onKeyup: 'keyup',
-  onPaste: 'paste',
-  onMouseenter: 'mouseenter',
-  onMouseleave: 'mouseleave',
+export type ActionCardProps = Bindable<ActionCardCatalogProps> & {
+  onPressPrimary?: ActionBinding | ActionBinding[];
+  onPressSecondary?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * Placeholder for states like empty, success, error, and loading, featuring animations, icons, text, and action buttons.
+ */
+export const ActionCard = createComponent<ActionCardProps>('ActionCard', {
+  onPressPrimary: 'pressPrimary',
+  onPressSecondary: 'pressSecondary',
+});
+
+export type AiIconProps = Bindable<AiIconCatalogProps> & ComponentDirectives;
+/**
+ * Branded Rippling AI icon used to indicate AI-powered features or content. Displays the Rippling AI star icon with optional "Rippling AI" label text.
+ */
+export const AiIcon = createComponent<AiIconProps>('AiIcon');
+
+export type AlertProps = Bindable<AlertCatalogProps> & {
+  onPressPrimary?: ActionBinding | ActionBinding[];
+  onPressSecondary?: ActionBinding | ActionBinding[];
+  onDismiss?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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).
+ */
+export const Alert = createComponent<AlertProps>('Alert', {
+  onPressPrimary: 'pressPrimary',
+  onPressSecondary: 'pressSecondary',
+  onDismiss: 'dismiss',
 });
-export const Select = createComponent('Select', {
+
+export type AnimationProps = Bindable<AnimationCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Animation = createComponent<AnimationProps>('Animation');
+
+export type ApiErrorProps = Bindable<ApiErrorCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ApiError = createComponent<ApiErrorProps>('ApiError');
+
+export type AppGroupLoaderProps = Bindable<AppGroupLoaderCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const AppGroupLoader = createComponent<AppGroupLoaderProps>('AppGroupLoader');
+
+export type AppGroupSelectProps = Bindable<AppGroupSelectCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onFocus?: ActionBinding | ActionBinding[];
+  onPaste?: ActionBinding | ActionBinding[];
+  onMenuToggle?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const AppGroupSelect = createComponent<AppGroupSelectProps>('AppGroupSelect', {
   onChange: 'change',
   onBlur: 'blur',
   onFocus: 'focus',
   onPaste: 'paste',
   onMenuToggle: 'menuToggle',
 });
-export const AppGroupSelect = createComponent('AppGroupSelect', {
+
+export type AppNavBarProps = Bindable<AppNavBarCatalogProps> & {
+  onNavigate?: ActionBinding | ActionBinding[];
+  onAction?: ActionBinding | ActionBinding[];
+} & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const AppNavBar = createComponent<AppNavBarProps>('AppNavBar', {
+  onNavigate: 'navigate',
+  onAction: 'action',
+});
+
+export type AtomsSeparatorProps = Bindable<AtomsSeparatorCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const AtomsSeparator = createComponent<AtomsSeparatorProps>('AtomsSeparator');
+
+export type AvatarProps = Bindable<AvatarCatalogProps> & {
+  onPress?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Avatar = createComponent<AvatarProps>('Avatar', {
+  onPress: 'press',
+});
+
+export type AvatarListProps = Bindable<AvatarListCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const AvatarList = createComponent<AvatarListProps>('AvatarList');
+
+export type BadgeProps = Bindable<BadgeCatalogProps> & ComponentDirectives;
+/**
+ * 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).
+ */
+export const Badge = createComponent<BadgeProps>('Badge');
+
+export type BoxProps = Bindable<BoxCatalogProps> & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const Box = createComponent<BoxProps>('Box');
+
+export type BreadcrumbProps = Bindable<BreadcrumbCatalogProps> & {
+  onSelect?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Breadcrumb = createComponent<BreadcrumbProps>('Breadcrumb', {
+  onSelect: 'select',
+});
+
+export type ButtonProps = Bindable<ButtonCatalogProps> & {
+  onPress?: ActionBinding | ActionBinding[];
+  onPressWhileDisabled?: ActionBinding | ActionBinding[];
+  onMouseEnter?: ActionBinding | ActionBinding[];
+  onMouseLeave?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Button = createComponent<ButtonProps>('Button', {
+  onPress: 'press',
+  onPressWhileDisabled: 'pressWhileDisabled',
+  onMouseEnter: 'mouseEnter',
+  onMouseLeave: 'mouseLeave',
+});
+
+export type ButtonGroupProps = Bindable<ButtonGroupCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * Layout container for arranging multiple Button elements horizontally or vertically with configurable placement, alignment, gap, and wrapping.
+ */
+export const ButtonGroup = createComponent<ButtonGroupProps>('ButtonGroup');
+
+export type CardProps = Bindable<CardCatalogProps> & {
+  onEdit?: ActionBinding | ActionBinding[];
+  onDelete?: ActionBinding | ActionBinding[];
+  onAdd?: ActionBinding | ActionBinding[];
+  onClick?: ActionBinding | ActionBinding[];
+  onAction?: ActionBinding | ActionBinding[];
+} & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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).
+ */
+export const Card = createComponent<CardProps>('Card', {
+  onEdit: 'edit',
+  onDelete: 'delete',
+  onAdd: 'add',
+  onClick: 'click',
+  onAction: 'action',
+});
+
+export type CardGroupProps = Bindable<CardGroupCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const CardGroup = createComponent<CardGroupProps>('CardGroup');
+
+export type CarouselProps = Bindable<CarouselCatalogProps> & {
+  onDone?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Carousel = createComponent<CarouselProps>('Carousel', {
+  onDone: 'done',
+});
+
+export type ChartLoaderProps = Bindable<ChartLoaderCatalogProps> & {
+  onLoad?: ActionBinding | ActionBinding[];
+} & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const ChartLoader = createComponent<ChartLoaderProps>('ChartLoader', {
+  onLoad: 'load',
+});
+
+export type CheckListProps = Bindable<CheckListCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const CheckList = createComponent<CheckListProps>('CheckList', {
+  onChange: 'change',
+});
+
+export type CheckboxProps = Bindable<CheckboxCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Checkbox = createComponent<CheckboxProps>('Checkbox', {
   onChange: 'change',
   onBlur: 'blur',
-  onFocus: 'focus',
-  onPaste: 'paste',
-  onMenuToggle: 'menuToggle',
 });
-export const Checkbox = createComponent('Checkbox', { onChange: 'change', onBlur: 'blur' });
-export const CheckboxGroup = createComponent('CheckboxGroup', { onChange: 'change', onBlur: 'blur' });
-export const Email = createComponent('Email', {
+
+export type CheckboxGroupProps = Bindable<CheckboxGroupCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const CheckboxGroup = createComponent<CheckboxGroupProps>('CheckboxGroup', {
   onChange: 'change',
   onBlur: 'blur',
-  onFocus: 'focus',
-  onClick: 'click',
-  onKeydown: 'keydown',
-  onKeyup: 'keyup',
-  onPaste: 'paste',
-  onMouseenter: 'mouseenter',
-  onMouseleave: 'mouseleave',
 });
-export const Number = createComponent('Number', {
+
+export type ChipProps = Bindable<ChipCatalogProps> & {
+  onDismiss?: ActionBinding | ActionBinding[];
+  onPress?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Chip = createComponent<ChipProps>('Chip', {
+  onDismiss: 'dismiss',
+  onPress: 'press',
+});
+
+export type ChipGroupProps = Bindable<ChipGroupCatalogProps> & {
+  onOverflowChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const ChipGroup = createComponent<ChipGroupProps>('ChipGroup', {
+  onOverflowChange: 'overflowChange',
+});
+
+export type CircleProps = Bindable<CircleCatalogProps> & ComponentDirectives;
+/**
+ * Circular graphic element for status or decoration
+ */
+export const Circle = createComponent<CircleProps>('Circle');
+
+export type ColorPickerProps = Bindable<ColorPickerCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ColorPicker = createComponent<ColorPickerProps>('ColorPicker', {
   onChange: 'change',
   onBlur: 'blur',
-  onChangeRaw: 'changeRaw',
-  onChangeCalculationState: 'changeCalculationState',
 });
-export const Date = createComponent('Date', { onChange: 'change', onBlur: 'blur' });
-export const DateRange = createComponent('DateRange', { onChange: 'change', onBlur: 'blur' });
-export const DateInlineMulti = createComponent('DateInlineMulti', { onChange: 'change', onBlur: 'blur' });
-export const Textarea = createComponent('Textarea', { onChange: 'change', onBlur: 'blur', onFocus: 'focus' });
-export const Radio = createComponent('Radio', {
+
+export type ContentLoaderProps = Bindable<ContentLoaderCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ContentLoader = createComponent<ContentLoaderProps>('ContentLoader');
+
+export type CountDownProps = Bindable<CountDownCatalogProps> & ComponentDirectives;
+/**
+ * Countdown timer displaying time remaining until a target date
+ */
+export const CountDown = createComponent<CountDownProps>('CountDown');
+
+export type CountryProps = Bindable<CountryCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Country = createComponent<CountryProps>('Country');
+
+export type CurrencyProps = Bindable<CurrencyCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Currency = createComponent<CurrencyProps>('Currency', {
   onChange: 'change',
   onBlur: 'blur',
-  onMouseenter: 'mouseenter',
-  onMouseleave: 'mouseleave',
 });
-export const Phone = createComponent('Phone', {
+
+export type DateProps = Bindable<DateCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Date = createComponent<DateProps>('Date', {
   onChange: 'change',
   onBlur: 'blur',
-  onFocus: 'focus',
-  onClick: 'click',
-  onKeydown: 'keydown',
-  onKeyup: 'keyup',
-  onPaste: 'paste',
-  onMouseenter: 'mouseenter',
-  onMouseleave: 'mouseleave',
-  onCountryCodeChange: 'countryCodeChange',
 });
-export const Password = createComponent('Password', {
+
+export type DateInlineMultiProps = Bindable<DateInlineMultiCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const DateInlineMulti = createComponent<DateInlineMultiProps>('DateInlineMulti', {
   onChange: 'change',
   onBlur: 'blur',
-  onFocus: 'focus',
-  onClick: 'click',
-  onKeydown: 'keydown',
-  onKeyup: 'keyup',
-  onPaste: 'paste',
-  onMouseenter: 'mouseenter',
-  onMouseleave: 'mouseleave',
-  onReveal: 'reveal',
 });
-export const Switch = createComponent('Switch', { onChange: 'change', onBlur: 'blur' });
-export const FileDrop = createComponent('FileDrop', { onChange: 'change', onBlur: 'blur' });
-export const TextAutoSuggest = createComponent('TextAutoSuggest', {
+
+export type DateRangeProps = Bindable<DateRangeCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const DateRange = createComponent<DateRangeProps>('DateRange', {
   onChange: 'change',
   onBlur: 'blur',
-  onFocus: 'focus',
-  onClick: 'click',
 });
-export const Currency = createComponent('Currency', { onChange: 'change', onBlur: 'blur' });
-export const WorkEmail = createComponent('WorkEmail', {
+
+export type DaySelectorProps = Bindable<DaySelectorCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const DaySelector = createComponent<DaySelectorProps>('DaySelector', {
+  onChange: 'change',
+});
+
+export type DistributionBarProps = Bindable<DistributionBarCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const DistributionBar = createComponent<DistributionBarProps>('DistributionBar');
+
+export type DividerProps = Bindable<DividerCatalogProps> & ComponentDirectives;
+/**
+ * Horizontal line to visually separate content sections
+ */
+export const Divider = createComponent<DividerProps>('Divider');
+
+export type DraggableListProps = Bindable<DraggableListCatalogProps> & {
+  onUpdate?: ActionBinding | ActionBinding[];
+  onRemove?: ActionBinding | ActionBinding[];
+  onDragStart?: ActionBinding | ActionBinding[];
+  onDragEnd?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const DraggableList = createComponent<DraggableListProps>('DraggableList', {
+  onUpdate: 'update',
+  onRemove: 'remove',
+  onDragStart: 'dragStart',
+  onDragEnd: 'dragEnd',
+});
+
+export type DrawerProps = Bindable<DrawerCatalogProps> & {
+  onClose?: ActionBinding | ActionBinding[];
+} & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const Drawer = createComponent<DrawerProps>('Drawer', {
+  onClose: 'close',
+});
+
+export type DropdownProps = Bindable<DropdownCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Dropdown = createComponent<DropdownProps>('Dropdown', {
+  onChange: 'change',
+});
+
+export type EmailProps = Bindable<EmailCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onFocus?: ActionBinding | ActionBinding[];
+  onClick?: ActionBinding | ActionBinding[];
+  onKeydown?: ActionBinding | ActionBinding[];
+  onKeyup?: ActionBinding | ActionBinding[];
+  onPaste?: ActionBinding | ActionBinding[];
+  onMouseenter?: ActionBinding | ActionBinding[];
+  onMouseleave?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Email = createComponent<EmailProps>('Email', {
   onChange: 'change',
   onBlur: 'blur',
   onFocus: 'focus',
@@ -141,168 +647,1077 @@ export const WorkEmail = createComponent('WorkEmail', {
   onMouseenter: 'mouseenter',
   onMouseleave: 'mouseleave',
 });
-export const Percentage = createComponent('Percentage', { onChange: 'change', onBlur: 'blur' });
-export const SegmentedControl = createComponent('SegmentedControl', { onChange: 'change', onBlur: 'blur' });
-export const Time = createComponent('Time', { onChange: 'change', onBlur: 'blur' });
-export const TimeRange = createComponent('TimeRange', { onChange: 'change', onBlur: 'blur' });
-export const Timezone = createComponent('Timezone', { onChange: 'change', onBlur: 'blur', onFocus: 'focus' });
-export const Slider = createComponent('Slider', {
+
+export type ExpansionPanelProps = Bindable<ExpansionPanelCatalogProps> & {
+  onToggle?: ActionBinding | ActionBinding[];
+} & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const ExpansionPanel = createComponent<ExpansionPanelProps>('ExpansionPanel', { onToggle: 'toggle' });
+
+export type ExpansionPanelGroupProps = Bindable<ExpansionPanelGroupCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const ExpansionPanelGroup = createComponent<ExpansionPanelGroupProps>('ExpansionPanelGroup');
+
+export type FieldProps = Bindable<FieldCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const Field = createComponent<FieldProps>('Field');
+
+export type FileProps = Bindable<FileCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onDelete?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const File = createComponent<FileProps>('File', {
   onChange: 'change',
-  onBlur: 'blur',
-  onBeforeChange: 'beforeChange',
-  onAfterChange: 'afterChange',
+  onDelete: 'delete',
 });
-export const RangeSlider = createComponent('RangeSlider', {
+
+export type FileDropProps = Bindable<FileDropCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const FileDrop = createComponent<FileDropProps>('FileDrop', {
   onChange: 'change',
-  onBeforeChange: 'beforeChange',
-  onAfterChange: 'afterChange',
   onBlur: 'blur',
 });
-export const Masker = createComponent('Masker', { onChange: 'change', onBlur: 'blur' });
-export const DaySelector = createComponent('DaySelector', { onChange: 'change' });
-export const ColorPicker = createComponent('ColorPicker', { onChange: 'change', onBlur: 'blur' });
-export const SelectableGroup = createComponent('SelectableGroup', { onChange: 'change' });
-export const Ssn = createComponent('Ssn', { onChange: 'change', onBlur: 'blur' });
-export const Sin = createComponent('Sin', { onChange: 'change', onBlur: 'blur' });
-export const Signature = createComponent('Signature', { onChange: 'change' });
-export const Survey = createComponent('Survey', { onChange: 'change' });
-export const Tree = createComponent('Tree', { onChange: 'change', onFooterAction: 'footerAction' });
-export const TreeSelect = createComponent('TreeSelect', { onChange: 'change' });
-export const File = createComponent('File', { onChange: 'change', onDelete: 'delete' });
-export const InputGroup = createComponent('InputGroup');
-export const Field = createComponent('Field');
-export const ActionCard = createComponent('ActionCard', {
-  onPressPrimary: 'pressPrimary',
-  onPressSecondary: 'pressSecondary',
-});
-export const Alert = createComponent('Alert', {
-  onPressPrimary: 'pressPrimary',
-  onPressSecondary: 'pressSecondary',
-  onDismiss: 'dismiss',
-});
-export const Avatar = createComponent('Avatar', { onPress: 'press' });
-export const Badge = createComponent('Badge');
-export const Chip = createComponent('Chip', { onDismiss: 'dismiss', onPress: 'press' });
-export const Card = createComponent('Card', {
-  onEdit: 'edit',
-  onDelete: 'delete',
-  onAdd: 'add',
-  onClick: 'click',
-  onAction: 'action',
-});
-export const ContentLoader = createComponent('ContentLoader');
-export const Divider = createComponent('Divider');
-export const Icon = createComponent('Icon', { onPress: 'press' });
-export const Label = createComponent('Label');
-export const ListItem = createComponent('ListItem', { onPress: 'press' });
-export const Modal = createComponent('Modal', { onClose: 'close' });
-export const ModalFooter = createComponent('ModalFooter');
-export const ProgressBar = createComponent('ProgressBar');
-export const Skeleton = createComponent('Skeleton');
-export const Spinner = createComponent('Spinner');
-export const Stepper = createComponent('Stepper', { onClick: 'click' });
-export const TextClip = createComponent('TextClip');
-export const TextSnippet = createComponent('TextSnippet');
-export const Tip = createComponent('Tip');
-export const CheckList = createComponent('CheckList', { onChange: 'change' });
-export const DistributionBar = createComponent('DistributionBar');
-export const ImageViewer = createComponent('ImageViewer');
-export const ObjectUI = createComponent('ObjectUI');
-export const ObjectUITemplate = createComponent('ObjectUITemplate');
-export const ObjectUIHeader = createComponent('ObjectUIHeader');
-export const ObjectUIContent = createComponent('ObjectUIContent');
-export const ObjectUIStats = createComponent('ObjectUIStats', { onActionClick: 'actionClick' });
-export const SnackBar = createComponent('SnackBar', { onDismiss: 'dismiss' });
-export const Video = createComponent('Video');
-export const AvatarList = createComponent('AvatarList');
-export const Image = createComponent('Image', { onPress: 'press', onLoad: 'load', onError: 'error' });
-export const AtomsSeparator = createComponent('AtomsSeparator');
-export const Carousel = createComponent('Carousel', { onDone: 'done' });
-export const TableBasic = createComponent('TableBasic');
-export const LocationCard = createComponent('LocationCard', {
-  onEdit: 'edit',
-  onDelete: 'delete',
-  onClick: 'click',
-  onAction: 'action',
-});
-export const LoaderCard = createComponent('LoaderCard');
-export const LayoutCard = createComponent('LayoutCard', { onPress: 'press' });
-export const AppGroupLoader = createComponent('AppGroupLoader');
-export const ChartLoader = createComponent('ChartLoader');
-export const ReportLoader = createComponent('ReportLoader');
-export const ReportShareLoader = createComponent('ReportShareLoader');
-export const ReportViewerLoader = createComponent('ReportViewerLoader');
-export const SettingsLoader = createComponent('SettingsLoader');
-export const ChipGroup = createComponent('ChipGroup', { onOverflowChange: 'overflowChange' });
-export const ModalCloseButton = createComponent('ModalCloseButton');
-export const Status = createComponent('Status');
-export const ApiError = createComponent('ApiError');
-export const Circle = createComponent('Circle');
-export const CountDown = createComponent('CountDown');
-export const Country = createComponent('Country');
-export const ToggleableArrow = createComponent('ToggleableArrow');
-export const TitleCaption = createComponent('TitleCaption');
-export const AiIcon = createComponent('AiIcon');
-export const Breadcrumb = createComponent('Breadcrumb', { onSelect: 'select' });
-export const Button = createComponent('Button', {
+
+export type FloatingButtonProps = Bindable<FloatingButtonCatalogProps> & {
+  onPress?: ActionBinding | ActionBinding[];
+  onPressWhileDisabled?: ActionBinding | ActionBinding[];
+  onMouseEnter?: ActionBinding | ActionBinding[];
+  onMouseLeave?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const FloatingButton = createComponent<FloatingButtonProps>('FloatingButton', {
   onPress: 'press',
   onPressWhileDisabled: 'pressWhileDisabled',
   onMouseEnter: 'mouseEnter',
   onMouseLeave: 'mouseLeave',
 });
-export const ButtonGroup = createComponent('ButtonGroup');
-export const DraggableList = createComponent('DraggableList', {
-  onUpdate: 'update',
-  onRemove: 'remove',
-  onDragStart: 'dragStart',
-  onDragEnd: 'dragEnd',
+
+export type GridProps = Bindable<GridCatalogProps> & {
+  onRowClick?: ActionBinding | ActionBinding[];
+  onRowAction?: ActionBinding | ActionBinding[];
+  onHeaderAction?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Grid = createComponent<GridProps>('Grid', {
+  onRowClick: 'rowClick',
+  onRowAction: 'rowAction',
+  onHeaderAction: 'headerAction',
 });
-export const Drawer = createComponent('Drawer', { onClose: 'close' });
-export const Dropdown = createComponent('Dropdown', { onChange: 'change' });
-export const ExpansionPanel = createComponent('ExpansionPanel', { onToggle: 'toggle' });
-export const ExpansionPanelGroup = createComponent('ExpansionPanelGroup');
-export const FloatingButton = createComponent('FloatingButton', {
+
+export type HStackProps = Bindable<HStackCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const HStack = createComponent<HStackProps>('HStack');
+
+export type HeadingProps = Bindable<HeadingCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Heading = createComponent<HeadingProps>('Heading');
+
+export type IconProps = Bindable<IconCatalogProps> & {
+  onPress?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Icon = createComponent<IconProps>('Icon', { onPress: 'press' });
+
+export type IconButtonProps = Bindable<IconButtonCatalogProps> & {
+  onPress?: ActionBinding | ActionBinding[];
+  onPressWhileDisabled?: ActionBinding | ActionBinding[];
+  onMouseEnter?: ActionBinding | ActionBinding[];
+  onMouseLeave?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const IconButton = createComponent<IconButtonProps>('IconButton', {
   onPress: 'press',
   onPressWhileDisabled: 'pressWhileDisabled',
   onMouseEnter: 'mouseEnter',
   onMouseLeave: 'mouseLeave',
 });
-export const IconButton = createComponent('IconButton', {
+
+export type ImageProps = Bindable<ImageCatalogProps> & {
+  onPress?: ActionBinding | ActionBinding[];
+  onLoad?: ActionBinding | ActionBinding[];
+  onError?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Image = createComponent<ImageProps>('Image', {
   onPress: 'press',
-  onPressWhileDisabled: 'pressWhileDisabled',
-  onMouseEnter: 'mouseEnter',
-  onMouseLeave: 'mouseLeave',
+  onLoad: 'load',
+  onError: 'error',
 });
-export const ItemNavigator = createComponent('ItemNavigator', { onNext: 'next', onPrevious: 'previous' });
-export const Link = createComponent('Link', { onPress: 'press' });
-export const MenuList = createComponent('MenuList', { onSelect: 'select' });
-export const NestedList = createComponent('NestedList', { onToggle: 'toggle', onSelect: 'select' });
-export const Paginate = createComponent('Paginate', { onChange: 'change' });
-export const SelectableMenu = createComponent('SelectableMenu', { onChange: 'change' });
-export const ShowMore = createComponent('ShowMore');
-export const Tab = createComponent('Tab', { onChange: 'change' });
-export const Heading = createComponent('Heading');
-export const Text = createComponent('Text');
-export const Box = createComponent('Box');
-export const Grid = createComponent('Grid', {
-  onRowClick: 'rowClick',
-  onRowAction: 'rowAction',
-  onHeaderAction: 'headerAction',
+
+export type ImageViewerProps = Bindable<ImageViewerCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ImageViewer = createComponent<ImageViewerProps>('ImageViewer');
+
+export type InputGroupProps = Bindable<InputGroupCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const InputGroup = createComponent<InputGroupProps>('InputGroup');
+
+export type ItemNavigatorProps = Bindable<ItemNavigatorCatalogProps> & {
+  onNext?: ActionBinding | ActionBinding[];
+  onPrevious?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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).
+ */
+export const ItemNavigator = createComponent<ItemNavigatorProps>('ItemNavigator', {
+  onNext: 'next',
+  onPrevious: 'previous',
+});
+
+export type LabelProps = Bindable<LabelCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Label = createComponent<LabelProps>('Label');
+
+export type LabelGroupProps = Bindable<LabelGroupCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const LabelGroup = createComponent<LabelGroupProps>('LabelGroup');
+
+export type LayoutProps = Bindable<LayoutCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const Layout = createComponent<LayoutProps>('Layout');
+
+export type LayoutCardProps = Bindable<LayoutCardCatalogProps> & {
+  onPress?: ActionBinding | ActionBinding[];
+} & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * A standard card container for creating card-based page layouts with configurable padding and an optional selectable theme for selection interfaces.
+ */
+export const LayoutCard = createComponent<LayoutCardProps>('LayoutCard', {
+  onPress: 'press',
 });
-export const HStack = createComponent('HStack');
-export const LabelGroup = createComponent('LabelGroup');
-export const Layout = createComponent('Layout');
-export const PageContent = createComponent('PageContent');
-export const PageHeader = createComponent('PageHeader');
-export const PageAppLogo = createComponent('PageAppLogo');
-export const PageFooter = createComponent('PageFooter', { onContinue: 'continue' });
-export const Pane = createComponent('Pane', {
+
+export type LinkProps = Bindable<LinkCatalogProps> & {
+  onPress?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Link = createComponent<LinkProps>('Link', { onPress: 'press' });
+
+export type ListItemProps = Bindable<ListItemCatalogProps> & {
+  onPress?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ListItem = createComponent<ListItemProps>('ListItem', {
+  onPress: 'press',
+});
+
+export type LoaderCardProps = Bindable<LoaderCardCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const LoaderCard = createComponent<LoaderCardProps>('LoaderCard');
+
+export type LocationCardProps = Bindable<LocationCardCatalogProps> & {
+  onEdit?: ActionBinding | ActionBinding[];
+  onDelete?: ActionBinding | ActionBinding[];
+  onClick?: ActionBinding | ActionBinding[];
+  onAction?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const LocationCard = createComponent<LocationCardProps>('LocationCard', {
+  onEdit: 'edit',
+  onDelete: 'delete',
+  onClick: 'click',
+  onAction: 'action',
+});
+
+export type MaskerProps = Bindable<MaskerCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Masker = createComponent<MaskerProps>('Masker', {
+  onChange: 'change',
+  onBlur: 'blur',
+});
+
+export type MenuListProps = Bindable<MenuListCatalogProps> & {
+  onSelect?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const MenuList = createComponent<MenuListProps>('MenuList', {
+  onSelect: 'select',
+});
+
+export type ModalProps = Bindable<ModalCatalogProps> & {
+  onClose?: ActionBinding | ActionBinding[];
+} & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const Modal = createComponent<ModalProps>('Modal', { onClose: 'close' });
+
+export type ModalCloseButtonProps = Bindable<ModalCloseButtonCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ModalCloseButton = createComponent<ModalCloseButtonProps>('ModalCloseButton');
+
+export type ModalFooterProps = Bindable<ModalFooterCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const ModalFooter = createComponent<ModalFooterProps>('ModalFooter');
+
+export type NestedListProps = Bindable<NestedListCatalogProps> & {
+  onToggle?: ActionBinding | ActionBinding[];
+  onSelect?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const NestedList = createComponent<NestedListProps>('NestedList', {
+  onToggle: 'toggle',
+  onSelect: 'select',
+});
+
+export type NumberProps = Bindable<NumberCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onChangeRaw?: ActionBinding | ActionBinding[];
+  onChangeCalculationState?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Number = createComponent<NumberProps>('Number', {
+  onChange: 'change',
+  onBlur: 'blur',
+  onChangeRaw: 'changeRaw',
+  onChangeCalculationState: 'changeCalculationState',
+});
+
+export type ObjectUIProps = Bindable<ObjectUICatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const ObjectUI = createComponent<ObjectUIProps>('ObjectUI');
+
+export type ObjectUIContentProps = Bindable<ObjectUIContentCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const ObjectUIContent = createComponent<ObjectUIContentProps>('ObjectUIContent');
+
+export type ObjectUIHeaderProps = Bindable<ObjectUIHeaderCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ObjectUIHeader = createComponent<ObjectUIHeaderProps>('ObjectUIHeader');
+
+export type ObjectUIStatsProps = Bindable<ObjectUIStatsCatalogProps> & {
+  onActionClick?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ObjectUIStats = createComponent<ObjectUIStatsProps>('ObjectUIStats', {
+  onActionClick: 'actionClick',
+});
+
+export type ObjectUITemplateProps = Bindable<ObjectUITemplateCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const ObjectUITemplate = createComponent<ObjectUITemplateProps>('ObjectUITemplate');
+
+export type PageAppLogoProps = Bindable<PageAppLogoCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const PageAppLogo = createComponent<PageAppLogoProps>('PageAppLogo');
+
+export type PageContentProps = Bindable<PageContentCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const PageContent = createComponent<PageContentProps>('PageContent');
+
+export type PageFooterProps = Bindable<PageFooterCatalogProps> & {
+  onContinue?: ActionBinding | ActionBinding[];
+} & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const PageFooter = createComponent<PageFooterProps>('PageFooter', {
+  onContinue: 'continue',
+});
+
+export type PageHeaderProps = Bindable<PageHeaderCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const PageHeader = createComponent<PageHeaderProps>('PageHeader');
+
+export type PaginateProps = Bindable<PaginateCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Paginate = createComponent<PaginateProps>('Paginate', {
+  onChange: 'change',
+});
+
+export type PaneProps = Bindable<PaneCatalogProps> & {
+  onCollapsedChange?: ActionBinding | ActionBinding[];
+  onDismiss?: ActionBinding | ActionBinding[];
+  onResize?: ActionBinding | ActionBinding[];
+} & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const Pane = createComponent<PaneProps>('Pane', {
   onCollapsedChange: 'collapsedChange',
   onDismiss: 'dismiss',
   onResize: 'resize',
 });
-export const Responsive = createComponent('Responsive');
-export const SplitPane = createComponent('SplitPane');
-export const VStack = createComponent('VStack');
-export const CustomObjectGrid = createComponent('CustomObjectGrid');
-export const ObjectListView = createComponent('ObjectListView');
+
+export type PasswordProps = Bindable<PasswordCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onFocus?: ActionBinding | ActionBinding[];
+  onClick?: ActionBinding | ActionBinding[];
+  onKeydown?: ActionBinding | ActionBinding[];
+  onKeyup?: ActionBinding | ActionBinding[];
+  onPaste?: ActionBinding | ActionBinding[];
+  onMouseenter?: ActionBinding | ActionBinding[];
+  onMouseleave?: ActionBinding | ActionBinding[];
+  onReveal?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Password = createComponent<PasswordProps>('Password', {
+  onChange: 'change',
+  onBlur: 'blur',
+  onFocus: 'focus',
+  onClick: 'click',
+  onKeydown: 'keydown',
+  onKeyup: 'keyup',
+  onPaste: 'paste',
+  onMouseenter: 'mouseenter',
+  onMouseleave: 'mouseleave',
+  onReveal: 'reveal',
+});
+
+export type PercentageProps = Bindable<PercentageCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Percentage = createComponent<PercentageProps>('Percentage', {
+  onChange: 'change',
+  onBlur: 'blur',
+});
+
+export type PhoneProps = Bindable<PhoneCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onFocus?: ActionBinding | ActionBinding[];
+  onClick?: ActionBinding | ActionBinding[];
+  onKeydown?: ActionBinding | ActionBinding[];
+  onKeyup?: ActionBinding | ActionBinding[];
+  onPaste?: ActionBinding | ActionBinding[];
+  onMouseenter?: ActionBinding | ActionBinding[];
+  onMouseleave?: ActionBinding | ActionBinding[];
+  onCountryCodeChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * A specialized input for entering and editing phone numbers with automatic region-based formatting, international support, and an optional country code dropdown selector.
+ */
+export const Phone = createComponent<PhoneProps>('Phone', {
+  onChange: 'change',
+  onBlur: 'blur',
+  onFocus: 'focus',
+  onClick: 'click',
+  onKeydown: 'keydown',
+  onKeyup: 'keyup',
+  onPaste: 'paste',
+  onMouseenter: 'mouseenter',
+  onMouseleave: 'mouseleave',
+  onCountryCodeChange: 'countryCodeChange',
+});
+
+export type ProgressBarProps = Bindable<ProgressBarCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ProgressBar = createComponent<ProgressBarProps>('ProgressBar');
+
+export type ProgressStepsProps = Bindable<ProgressStepsCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ProgressSteps = createComponent<ProgressStepsProps>('ProgressSteps');
+
+export type RadioProps = Bindable<RadioCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onMouseenter?: ActionBinding | ActionBinding[];
+  onMouseleave?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Radio = createComponent<RadioProps>('Radio', {
+  onChange: 'change',
+  onBlur: 'blur',
+  onMouseenter: 'mouseenter',
+  onMouseleave: 'mouseleave',
+});
+
+export type RangeSliderProps = Bindable<RangeSliderCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBeforeChange?: ActionBinding | ActionBinding[];
+  onAfterChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const RangeSlider = createComponent<RangeSliderProps>('RangeSlider', {
+  onChange: 'change',
+  onBeforeChange: 'beforeChange',
+  onAfterChange: 'afterChange',
+  onBlur: 'blur',
+});
+
+export type ReportLoaderProps = Bindable<ReportLoaderCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ReportLoader = createComponent<ReportLoaderProps>('ReportLoader');
+
+export type ReportShareLoaderProps = Bindable<ReportShareLoaderCatalogProps> & ComponentDirectives;
+/**
+ * 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).
+ */
+export const ReportShareLoader = createComponent<ReportShareLoaderProps>('ReportShareLoader');
+
+export type ReportViewerLoaderProps = Bindable<ReportViewerLoaderCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ReportViewerLoader = createComponent<ReportViewerLoaderProps>('ReportViewerLoader');
+
+export type ResponsiveProps = Bindable<ResponsiveCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const Responsive = createComponent<ResponsiveProps>('Responsive');
+
+export type SegmentedControlProps = Bindable<SegmentedControlCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const SegmentedControl = createComponent<SegmentedControlProps>('SegmentedControl', {
+  onChange: 'change',
+  onBlur: 'blur',
+});
+
+export type SelectProps = Bindable<SelectCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onFocus?: ActionBinding | ActionBinding[];
+  onPaste?: ActionBinding | ActionBinding[];
+  onMenuToggle?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Select = createComponent<SelectProps>('Select', {
+  onChange: 'change',
+  onBlur: 'blur',
+  onFocus: 'focus',
+  onPaste: 'paste',
+  onMenuToggle: 'menuToggle',
+});
+
+export type SelectableGroupProps = Bindable<SelectableGroupCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const SelectableGroup = createComponent<SelectableGroupProps>('SelectableGroup', {
+  onChange: 'change',
+});
+
+export type SelectableMenuProps = Bindable<SelectableMenuCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const SelectableMenu = createComponent<SelectableMenuProps>('SelectableMenu', { onChange: 'change' });
+
+export type SettingsLoaderProps = Bindable<SettingsLoaderCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const SettingsLoader = createComponent<SettingsLoaderProps>('SettingsLoader');
+
+export type ShowMoreProps = Bindable<ShowMoreCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const ShowMore = createComponent<ShowMoreProps>('ShowMore');
+
+export type SignatureProps = Bindable<SignatureCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Signature = createComponent<SignatureProps>('Signature', {
+  onChange: 'change',
+});
+
+export type SinProps = Bindable<SinCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Sin = createComponent<SinProps>('Sin', {
+  onChange: 'change',
+  onBlur: 'blur',
+});
+
+export type SkeletonProps = Bindable<SkeletonCatalogProps> & ComponentDirectives;
+/**
+ * An animated placeholder that mimics the shape of content while it loads, available in text (lines), circle, and box variants.
+ */
+export const Skeleton = createComponent<SkeletonProps>('Skeleton');
+
+export type SliderProps = Bindable<SliderCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onBeforeChange?: ActionBinding | ActionBinding[];
+  onAfterChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Slider = createComponent<SliderProps>('Slider', {
+  onChange: 'change',
+  onBlur: 'blur',
+  onBeforeChange: 'beforeChange',
+  onAfterChange: 'afterChange',
+});
+
+export type SnackBarProps = Bindable<SnackBarCatalogProps> & {
+  onDismiss?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const SnackBar = createComponent<SnackBarProps>('SnackBar', {
+  onDismiss: 'dismiss',
+});
+
+export type SpinnerProps = Bindable<SpinnerCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Spinner = createComponent<SpinnerProps>('Spinner');
+
+export type SplitButtonProps = Bindable<SplitButtonCatalogProps> & {
+  onPress?: ActionBinding | ActionBinding[];
+  onDropdownChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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").
+ */
+export const SplitButton = createComponent<SplitButtonProps>('SplitButton', {
+  onPress: 'press',
+  onDropdownChange: 'dropdownChange',
+});
+
+export type SplitPaneProps = Bindable<SplitPaneCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const SplitPane = createComponent<SplitPaneProps>('SplitPane');
+
+export type SsnProps = Bindable<SsnCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Ssn = createComponent<SsnProps>('Ssn', {
+  onChange: 'change',
+  onBlur: 'blur',
+});
+
+export type StatusProps = Bindable<StatusCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Status = createComponent<StatusProps>('Status');
+
+export type StepperProps = Bindable<StepperCatalogProps> & {
+  onClick?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Stepper = createComponent<StepperProps>('Stepper', {
+  onClick: 'click',
+});
+
+export type SurveyProps = Bindable<SurveyCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Survey = createComponent<SurveyProps>('Survey', {
+  onChange: 'change',
+});
+
+export type SwitchProps = Bindable<SwitchCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Switch = createComponent<SwitchProps>('Switch', {
+  onChange: 'change',
+  onBlur: 'blur',
+});
+
+export type TabProps = Bindable<TabCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Tab = createComponent<TabProps>('Tab', { onChange: 'change' });
+
+export type TableBasicProps = Bindable<TableBasicCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const TableBasic = createComponent<TableBasicProps>('TableBasic');
+
+export type TextProps = Bindable<TextCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Text = createComponent<TextProps>('Text');
+
+export type TextAutoSuggestProps = Bindable<TextAutoSuggestCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onFocus?: ActionBinding | ActionBinding[];
+  onClick?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const TextAutoSuggest = createComponent<TextAutoSuggestProps>('TextAutoSuggest', {
+  onChange: 'change',
+  onBlur: 'blur',
+  onFocus: 'focus',
+  onClick: 'click',
+});
+
+export type TextClipProps = Bindable<TextClipCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const TextClip = createComponent<TextClipProps>('TextClip');
+
+export type TextInputProps = Bindable<TextInputCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onFocus?: ActionBinding | ActionBinding[];
+  onClick?: ActionBinding | ActionBinding[];
+  onKeydown?: ActionBinding | ActionBinding[];
+  onKeyup?: ActionBinding | ActionBinding[];
+  onPaste?: ActionBinding | ActionBinding[];
+  onMouseenter?: ActionBinding | ActionBinding[];
+  onMouseleave?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const TextInput = createComponent<TextInputProps>('TextInput', {
+  onChange: 'change',
+  onBlur: 'blur',
+  onFocus: 'focus',
+  onClick: 'click',
+  onKeydown: 'keydown',
+  onKeyup: 'keyup',
+  onPaste: 'paste',
+  onMouseenter: 'mouseenter',
+  onMouseleave: 'mouseleave',
+});
+
+export type TextSnippetProps = Bindable<TextSnippetCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const TextSnippet = createComponent<TextSnippetProps>('TextSnippet');
+
+export type TextareaProps = Bindable<TextareaCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onFocus?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Textarea = createComponent<TextareaProps>('Textarea', {
+  onChange: 'change',
+  onBlur: 'blur',
+  onFocus: 'focus',
+});
+
+export type TimeProps = Bindable<TimeCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Time = createComponent<TimeProps>('Time', {
+  onChange: 'change',
+  onBlur: 'blur',
+});
+
+export type TimeRangeProps = Bindable<TimeRangeCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const TimeRange = createComponent<TimeRangeProps>('TimeRange', {
+  onChange: 'change',
+  onBlur: 'blur',
+});
+
+export type TimezoneProps = Bindable<TimezoneCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onFocus?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Timezone = createComponent<TimezoneProps>('Timezone', {
+  onChange: 'change',
+  onBlur: 'blur',
+  onFocus: 'focus',
+});
+
+export type TipProps = Bindable<TipCatalogProps> & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const Tip = createComponent<TipProps>('Tip');
+
+export type TitleCaptionProps = Bindable<TitleCaptionCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const TitleCaption = createComponent<TitleCaptionProps>('TitleCaption');
+
+export type ToggleableArrowProps = Bindable<ToggleableArrowCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ToggleableArrow = createComponent<ToggleableArrowProps>('ToggleableArrow');
+
+export type TreeProps = Bindable<TreeCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onFooterAction?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const Tree = createComponent<TreeProps>('Tree', {
+  onChange: 'change',
+  onFooterAction: 'footerAction',
+});
+
+export type TreeSelectProps = Bindable<TreeSelectCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const TreeSelect = createComponent<TreeSelectProps>('TreeSelect', {
+  onChange: 'change',
+});
+
+export type VStackProps = Bindable<VStackCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const VStack = createComponent<VStackProps>('VStack');
+
+export type VideoProps = Bindable<VideoCatalogProps> & ComponentDirectives;
+/**
+ * Embedded video player with 16:9 aspect ratio
+ */
+export const Video = createComponent<VideoProps>('Video');
+
+export type WorkEmailProps = Bindable<WorkEmailCatalogProps> & {
+  onChange?: ActionBinding | ActionBinding[];
+  onBlur?: ActionBinding | ActionBinding[];
+  onFocus?: ActionBinding | ActionBinding[];
+  onClick?: ActionBinding | ActionBinding[];
+  onKeydown?: ActionBinding | ActionBinding[];
+  onKeyup?: ActionBinding | ActionBinding[];
+  onPaste?: ActionBinding | ActionBinding[];
+  onMouseenter?: ActionBinding | ActionBinding[];
+  onMouseleave?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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
+ */
+export const WorkEmail = createComponent<WorkEmailProps>('WorkEmail', {
+  onChange: 'change',
+  onBlur: 'blur',
+  onFocus: 'focus',
+  onClick: 'click',
+  onKeydown: 'keydown',
+  onKeyup: 'keyup',
+  onPaste: 'paste',
+  onMouseenter: 'mouseenter',
+  onMouseleave: 'mouseleave',
+});
+
+export type AnalyticsCardProps = Bindable<AnalyticsCardCatalogProps> & {
+  onConfigure?: ActionBinding | ActionBinding[];
+} & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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).
+ */
+export const AnalyticsCard = createComponent<AnalyticsCardProps>('AnalyticsCard', {
+  onConfigure: 'configure',
+});
+
+export type ResizableBoardProps = Bindable<ResizableBoardCatalogProps> &
+  ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * Resizable dashboard board for AI widget layouts. Wraps each child in a Pebble ResizableBoard block.
+ */
+export const ResizableBoard = createComponent<ResizableBoardProps>('ResizableBoard');
+
+export type EChartProps = Bindable<EChartCatalogProps> & {
+  onClick?: ActionBinding | ActionBinding[];
+  onLegendChange?: ActionBinding | ActionBinding[];
+  onDataZoomChange?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const EChart = createComponent<EChartProps>('EChart', {
+  onClick: 'click',
+  onLegendChange: 'legendChange',
+  onDataZoomChange: 'dataZoomChange',
+});
+
+export type RichTextProps = Bindable<RichTextCatalogProps> & ComponentDirectives;
+/**
+ * Read-only HTML content rendered with the shared RichTextEditor (non-editable). Generic SDUI building block for narrative or explanatory copy in any product layout.
+ */
+export const RichText = createComponent<RichTextProps>('RichText');
+
+export type DashboardRichTextProps = Bindable<DashboardRichTextCatalogProps> & ComponentDirectives;
+/**
+ * Deprecated alias for RichText. Same props; prefer type `RichText` in new specs.
+ */
+export const DashboardRichText = createComponent<DashboardRichTextProps>('DashboardRichText');
+
+export type CustomObjectGridProps = Bindable<CustomObjectGridCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const CustomObjectGrid = createComponent<CustomObjectGridProps>('CustomObjectGrid');
+
+export type ObjectListViewProps = Bindable<ObjectListViewCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const ObjectListView = createComponent<ObjectListViewProps>('ObjectListView');
+
+export type BarChartProps = Bindable<BarChartCatalogProps> & {
+  onBarClick?: ActionBinding | ActionBinding[];
+} & ComponentDirectives;
+/**
+ * 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.
+ */
+export const BarChart = createComponent<BarChartProps>('BarChart', {
+  onBarClick: 'barClick',
+});
+
+export type LineChartProps = Bindable<LineChartCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const LineChart = createComponent<LineChartProps>('LineChart');
+
+export type HorizontalBarChartProps = Bindable<HorizontalBarChartCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const HorizontalBarChart = createComponent<HorizontalBarChartProps>('HorizontalBarChart');
+
+export type CombinationChartProps = Bindable<CombinationChartCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const CombinationChart = createComponent<CombinationChartProps>('CombinationChart');
+
+export type PieChartProps = Bindable<PieChartCatalogProps> & ComponentDirectives;
+/**
+ * Pie / donut chart. Each series entry has a data array of {name, value} pairs. Use radius: ["50%", "70%"] for a donut hole.
+ */
+export const PieChart = createComponent<PieChartProps>('PieChart');
+
+export type ScatterChartProps = Bindable<ScatterChartCatalogProps> & ComponentDirectives;
+/**
+ * Scatter plot. Each series contains [x, y] data pairs plotted as individual points.
+ */
+export const ScatterChart = createComponent<ScatterChartProps>('ScatterChart');
+
+export type FunnelChartProps = Bindable<FunnelChartCatalogProps> & ComponentDirectives;
+/**
+ * Funnel chart for conversion or stage-based data. Data items are ordered by value (largest at top).
+ */
+export const FunnelChart = createComponent<FunnelChartProps>('FunnelChart');
+
+export type GaugeChartProps = Bindable<GaugeChartCatalogProps> & ComponentDirectives;
+/**
+ * Gauge (speedometer) chart. Displays a single numeric value against colored segments. Segments define the scale breakpoints and their colors.
+ */
+export const GaugeChart = createComponent<GaugeChartProps>('GaugeChart');
+
+export type SunburstChartProps = Bindable<SunburstChartCatalogProps> & ComponentDirectives;
+/**
+ * Sunburst (multi-level pie) chart for hierarchical data. Each node has a name, optional value, and optional children array.
+ */
+export const SunburstChart = createComponent<SunburstChartProps>('SunburstChart');
+
+export type WithSpinnerProps = Bindable<WithSpinnerCatalogProps> & {
+  onLoad?: ActionBinding | ActionBinding[];
+} & ComponentDirectives & { children?: SpecNode | SpecNode[] };
+/**
+ * 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.
+ */
+export const WithSpinner = createComponent<WithSpinnerProps>('WithSpinner', {
+  onLoad: 'load',
+});
+
+export type RadarChartProps = Bindable<RadarChartCatalogProps> & ComponentDirectives;
+/**
+ * Radar (spider) chart for comparing multiple variables across categories. Each indicator defines a spoke axis. Provide radarIndicators (axis definitions) and radarOptions (series data).
+ */
+export const RadarChart = createComponent<RadarChartProps>('RadarChart');
+
+export type RadarFilledChartProps = Bindable<RadarFilledChartCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const RadarFilledChart = createComponent<RadarFilledChartProps>('RadarFilledChart');
+
+export type HeatmapCalendarChartProps = Bindable<HeatmapCalendarChartCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const HeatmapCalendarChart = createComponent<HeatmapCalendarChartProps>('HeatmapCalendarChart');
+
+export type HeatmapChartProps = Bindable<HeatmapChartCatalogProps> & ComponentDirectives;
+/**
+ * Grid-based heatmap chart for showing magnitude across two dimensions. Data format: [[xIndex, yIndex, value], …]. Provide category labels for both axes.
+ */
+export const HeatmapChart = createComponent<HeatmapChartProps>('HeatmapChart');
+
+export type TreemapChartProps = Bindable<TreemapChartCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const TreemapChart = createComponent<TreemapChartProps>('TreemapChart');
+
+export type SqlHighlightProps = Bindable<SqlHighlightCatalogProps> & ComponentDirectives;
+/**
+ * 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.
+ */
+export const SqlHighlight = createComponent<SqlHighlightProps>('SqlHighlight');