@rippling/pebble-sdui-web 0.15.2 → 0.18.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/catalogs/custom-apps/action-params.d.ts +3 -0
- package/dist/catalogs/custom-apps/actions.d.ts +2 -1
- package/dist/catalogs/custom-apps/catalog.d.ts +1 -1
- package/dist/catalogs/custom-apps/component-events.d.ts +4 -0
- package/dist/catalogs/custom-apps/component-props.d.ts +102 -1
- package/dist/catalogs/custom-apps/components.d.ts +42 -38
- package/dist/catalogs/custom-apps/index.cjs +4 -2
- package/dist/catalogs/custom-apps/index.cjs.map +1 -1
- package/dist/catalogs/custom-apps/index.d.ts +5 -5
- package/dist/catalogs/custom-apps/index.js +12811 -384
- package/dist/catalogs/custom-apps/index.js.map +1 -1
- package/dist/core/component-utils.cjs +1 -1
- package/dist/core/component-utils.cjs.map +1 -1
- package/dist/core/component-utils.d.ts +16 -2
- package/dist/core/component-utils.js +4 -4
- package/dist/core/component-utils.js.map +1 -1
- package/dist/core/spec.cjs +1 -1
- package/dist/core/spec.cjs.map +1 -1
- package/dist/core/spec.d.ts +1 -0
- package/dist/core/spec.js +63 -56
- package/dist/core/spec.js.map +1 -1
- package/dist/docs/typescript/web/catalogs/custom-apps/actions.md +28 -0
- package/dist/docs/typescript/web/catalogs/custom-apps/components.md +162 -4
- package/dist/docs/typescript/web/catalogs/custom-apps/definitions.md +95 -0
- package/dist/docs/typescript/web/catalogs/custom-apps/readme.md +1 -1
- package/dist/docs/typescript/web/catalogs/custom-apps/types.md +41 -0
- package/package.json +1 -1
|
@@ -1,7 +1,9 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../../core/component-utils.cjs"),a=require("../../core/action-utils.cjs"),D=require("../../2020-C_v5qH0D.cjs"),C=require("../../core/catalog-validation.cjs"),R=require("../../core/component-markdown.cjs"),P=require("../../core/spec.cjs"),A=e=>t.buildNode("ActionCard",e),E=e=>t.buildNode("AiIcon",e),x=e=>t.buildNode("Alert",e),N=e=>t.buildNode("Animation",e),L=e=>t.buildNode("ApiError",e),k=e=>t.buildNode("AppGroupLoader",e),M=e=>t.buildNode("AppGroupSelect",e),_=e=>t.buildNode("AppNavBar",e),j=e=>t.buildNode("AtomsSeparator",e),F=e=>t.buildNode("Avatar",e),q=e=>t.buildNode("AvatarList",e),U=e=>t.buildNode("Badge",e),B=e=>t.buildNode("Box",e),H=e=>t.buildNode("BrandBadge",e),V=e=>t.buildNode("Breadcrumb",e),G=e=>t.buildNode("Button",e),W=e=>t.buildNode("ButtonGroup",e),z=e=>t.buildNode("Calendar",e),X=e=>t.buildNode("Card",e),$=e=>t.buildNode("CardGroup",e),Y=e=>t.buildNode("Carousel",e),K=e=>t.buildNode("ChartLoader",e),Q=e=>t.buildNode("Checkbox",e),J=e=>t.buildNode("CheckboxGroup",e),Z=e=>t.buildNode("CheckList",e),ee=e=>t.buildNode("Chip",e),te=e=>t.buildNode("ChipGroup",e),ie=e=>t.buildNode("Circle",e),oe=e=>t.buildNode("ColorPicker",e),re=e=>t.buildNode("ContentLoader",e),ne=e=>t.buildNode("CountDown",e),ae=e=>t.buildNode("Country",e),se=e=>t.buildNode("Currency",e),pe=e=>t.buildNode("Dashboard",e),le=e=>t.buildNode("Date",e),ce=e=>t.buildNode("DateInlineMulti",e),de=e=>t.buildNode("DateRange",e),ye=e=>t.buildNode("DaySelector",e),ue=e=>t.buildNode("DistributionBar",e),he=e=>t.buildNode("Divider",e),me=e=>t.buildNode("DraggableList",e),be=e=>t.buildNode("Drawer",e),ge=e=>t.buildNode("Dropdown",e),fe=e=>t.buildNode("Email",e),Se=e=>t.buildNode("EmojiPicker",e),ve=e=>t.buildNode("EmployeeSearch",e),Oe=e=>t.buildNode("ExpansionPanel",e),we=e=>t.buildNode("ExpansionPanelGroup",e),Ie=e=>t.buildNode("Field",e),Te=e=>t.buildNode("File",e),De=e=>t.buildNode("FileDrop",e),Ce=e=>t.buildNode("FloatingButton",e),Re=e=>t.buildNode("Form",e),Pe=e=>t.buildNode("FormCheckbox",e),Ae=e=>t.buildNode("FormCheckboxGroup",e),Ee=e=>t.buildNode("FormContent",e),xe=e=>t.buildNode("FormCurrency",e),Ne=e=>t.buildNode("FormDate",e),Le=e=>t.buildNode("FormDateRange",e),ke=e=>t.buildNode("FormDaySelector",e),Me=e=>t.buildNode("FormEmail",e),_e=e=>t.buildNode("FormEmployeeSearch",e),je=e=>t.buildNode("FormFile",e),Fe=e=>t.buildNode("FormFileDrop",e),qe=e=>t.buildNode("FormGroup",e),Ue=e=>t.buildNode("FormGroupHeader",e),Be=e=>t.buildNode("FormHidden",e),He=e=>t.buildNode("FormInlineGroup",e),Ve=e=>t.buildNode("FormInputGroup",e),Ge=e=>t.buildNode("FormMasker",e),We=e=>t.buildNode("FormNumber",e),ze=e=>t.buildNode("FormPassword",e),Xe=e=>t.buildNode("FormPercentage",e),$e=e=>t.buildNode("FormPhone",e),Ye=e=>t.buildNode("FormRadio",e),Ke=e=>t.buildNode("FormSegmentedControl",e),Qe=e=>t.buildNode("FormSelect",e),Je=e=>t.buildNode("FormSelectableGroup",e),Ze=e=>t.buildNode("FormSignature",e),et=e=>t.buildNode("FormSin",e),tt=e=>t.buildNode("FormSlider",e),it=e=>t.buildNode("FormSsn",e),ot=e=>t.buildNode("FormSurvey",e),rt=e=>t.buildNode("FormSwitch",e),nt=e=>t.buildNode("FormText",e),at=e=>t.buildNode("FormTextarea",e),st=e=>t.buildNode("FormTextAutoSuggest",e),pt=e=>t.buildNode("FormTime",e),lt=e=>t.buildNode("FormTimezone",e),ct=e=>t.buildNode("FormTree",e),dt=e=>t.buildNode("FormTreeSelect",e),yt=e=>t.buildNode("FormWorkEmail",e),ut=e=>t.buildNode("Grid",e),ht=e=>t.buildNode("Heading",e),mt=e=>t.buildNode("Hidden",e),bt=e=>t.buildNode("HStack",e),gt=e=>t.buildNode("Icon",e),ft=e=>t.buildNode("IconButton",e),St=e=>t.buildNode("Image",e),vt=e=>t.buildNode("ImageViewer",e),Ot=e=>t.buildNode("InputGroup",e),wt=e=>t.buildNode("ItemNavigator",e),It=e=>t.buildNode("Label",e),Tt=e=>t.buildNode("LabelGroup",e),Dt=e=>t.buildNode("Layout",e),Ct=e=>t.buildNode("LayoutCard",e),Rt=e=>t.buildNode("Link",e),Pt=e=>t.buildNode("ListItem",e),At=e=>t.buildNode("LoaderCard",e),Et=e=>t.buildNode("LocationCard",e),xt=e=>t.buildNode("LottiePlayer",e),Nt=e=>t.buildNode("Masker",e),Lt=e=>t.buildNode("MenuList",e),kt=e=>t.buildNode("Modal",e),Mt=e=>t.buildNode("ModalCloseButton",e),_t=e=>t.buildNode("ModalFooter",e),jt=e=>t.buildNode("NestedList",e),Ft=e=>t.buildNode("Number",e),qt=e=>t.buildNode("ObjectListView",e),Ut=e=>t.buildNode("ObjectUI",e),Bt=e=>t.buildNode("ObjectUIContent",e),Ht=e=>t.buildNode("ObjectUIHeader",e),Vt=e=>t.buildNode("ObjectUIStats",e),Gt=e=>t.buildNode("ObjectUITemplate",e),Wt=e=>t.buildNode("PageAppLogo",e),zt=e=>t.buildNode("PageContent",e),Xt=e=>t.buildNode("PageFooter",e),$t=e=>t.buildNode("PageHeader",e),Yt=e=>t.buildNode("Paginate",e),Kt=e=>t.buildNode("PaginateList",e),Qt=e=>t.buildNode("Pane",e),Jt=e=>t.buildNode("Password",e),Zt=e=>t.buildNode("Percentage",e),ei=e=>t.buildNode("Phone",e),ti=e=>t.buildNode("ProgressBar",e),ii=e=>t.buildNode("ProgressSteps",e),oi=e=>t.buildNode("Radio",e),ri=e=>t.buildNode("RangeSlider",e),ni=e=>t.buildNode("ReportLoader",e),ai=e=>t.buildNode("Reports",e),si=e=>t.buildNode("ReportShareLoader",e),pi=e=>t.buildNode("ReportViewerLoader",e),li=e=>t.buildNode("ResizableBoard",e),ci=e=>t.buildNode("Responsive",e),di=e=>t.buildNode("SegmentedControl",e),yi=e=>t.buildNode("Select",e),ui=e=>t.buildNode("SelectableGroup",e),hi=e=>t.buildNode("SelectableMenu",e),mi=e=>t.buildNode("SettingsLoader",e),bi=e=>t.buildNode("ShowMore",e),gi=e=>t.buildNode("Signature",e),fi=e=>t.buildNode("Sin",e),Si=e=>t.buildNode("Skeleton",e),vi=e=>t.buildNode("Slider",e),Oi=e=>t.buildNode("SnackBar",e),wi=e=>t.buildNode("Spinner",e),Ii=e=>t.buildNode("SplitButton",e),Ti=e=>t.buildNode("SplitPane",e),Di=e=>t.buildNode("Ssn",e),Ci=e=>t.buildNode("Status",e),Ri=e=>t.buildNode("Stepper",e),Pi=e=>t.buildNode("SupportButton",e),Ai=e=>t.buildNode("Survey",e),Ei=e=>t.buildNode("Switch",e),xi=e=>t.buildNode("Tab",e),Ni=e=>t.buildNode("TableBasic",e),Li=e=>t.buildNode("Text",e),ki=e=>t.buildNode("Textarea",e),Mi=e=>t.buildNode("TextAutoSuggest",e),_i=e=>t.buildNode("TextClip",e),ji=e=>t.buildNode("TextInput",e),Fi=e=>t.buildNode("TextSnippet",e),qi=e=>t.buildNode("Time",e),Ui=e=>t.buildNode("TimeRange",e),Bi=e=>t.buildNode("Timezone",e),Hi=e=>t.buildNode("Tip",e),Vi=e=>t.buildNode("TitleCaption",e),Gi=e=>t.buildNode("ToggleableArrow",e),Wi=e=>t.buildNode("Tree",e),zi=e=>t.buildNode("TreeSelect",e),Xi=e=>t.buildNode("Video",e),$i=e=>t.buildNode("VStack",e),Yi=e=>t.buildNode("WorkEmail",e),Ki=(e,i)=>a.buildAction("navigate",e,i),Qi=(e,i)=>a.buildAction("openChatAssistantWithMessage",e,i),Ji=(e,i)=>a.buildAction("pushState",e,i),Zi=(e,i)=>a.buildAction("removeState",e,i),eo=(e,i)=>a.buildAction("setState",e,i),to=(e,i)=>a.buildAction("showNotification",e,i),io=(e,i)=>a.buildAction("triggerFunction",e,i),f="custom-apps",S="1.5.4",r={ActionCard:{description:"Placeholder for states like empty, success, error, and loading, featuring animations, icons, text, and action buttons.",events:["pressPrimary","pressSecondary"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alignment:{description:"Content alignment within the card. Default: CENTER",enum:["LEFT","CENTER","RIGHT"],type:"string"},animation:{description:"Lottie animation name to display as the card asset instead of an icon",enum:["ADD","AIRPLANE","BAR_CHART_DECREASE","BAR_CHART_INCREASE","BRAIN","BRAIN_AI","CALENDAR","CHECK_MARK","CLOCK","COINS_USD","CREDIT_CARD","DOCUMENT","ENTERPRISE","EXCLAMATION_MARK","FOLDERS","GEAR","GEAR_HEART","GEAR_PLAY","GLOBE","GRAD_CAP","HANDSHAKE","HEART","INTEGRATION","INVENTORY_MANAGEMENT","LAPTOP","LAPTOP_DEV","LIGHTNING_BOLT","LOCK","LOCK_UNLOCKED","MAGNIFYING_GLASS","MAGNIFYING_GLASS_QUESTION_MARK","NO_WIFI","OFFBOARDING","ONBOARDING","PAYROLL_EURO","PAYROLL_RUPEE","PAYROLL_USD","PAYROLL_YEN","QUESTION_MARK","RECEIPT","REFRESH","SHIELD_CHECK","SPEECH_BUBBLE","THIRD_PARTY","TRAIN","UNIFIED_SYSTEM","X"],type:"string"},caption:{anyOf:[{type:"string"},{type:"number"}],description:"Card caption/description text"},icon:{description:"Icon type string from Icon.TYPES for the card asset",type:"string"},iconColor:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},padding:{additionalProperties:!1,description:"Override container padding per side using Pebble spacing tokens",properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"},primaryAction:{additionalProperties:!1,description:"Primary action button configuration",properties:{icon:{description:"Icon type string for the action button",type:"string"},isDisabled:{description:"Disable the action button. Default: false",type:"boolean"},title:{description:"Action button label",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Navigation destination for the action. String URL or { path, openInNewTab? }"}},required:["title"],type:"object"},secondaryAction:{additionalProperties:!1,description:"Secondary action button configuration",properties:{icon:{description:"Icon type string for the action button",type:"string"},isDisabled:{description:"Disable the action button. Default: false",type:"boolean"},title:{description:"Action button label",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Navigation destination for the action. String URL or { path, openInNewTab? }"}},required:["title"],type:"object"},shouldShowAsset:{description:"Show the icon/animation asset. Default: true",type:"boolean"},title:{description:"Card title text",type:"string"}},required:["caption"],type:"object"},acceptsChildren:!1},AiIcon:{description:'Branded Rippling AI icon used to indicate AI-powered features or content. Displays the Rippling AI star icon with optional "Rippling AI" label text.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{"aria-label":{description:"Accessible label for the icon",type:"string"},showText:{description:'Whether to show the "Rippling AI" text alongside the icon. Default: true',type:"boolean"},size:{description:"Size of the AI icon. One of: SMALL, MEDIUM, LARGE. Default: MEDIUM",enum:["SMALL","MEDIUM","LARGE"],type:"string"}},type:"object"},acceptsChildren:!1},Alert:{description:"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).",events:["pressPrimary","pressSecondary","dismiss"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{description:{description:"Main description content to display in the alert",type:"string"},isCloseable:{description:"Shows close button when true. Default: false",type:"boolean"},isFluid:{description:"If true, the alert takes full width of its container. Default: false",type:"boolean"},primaryAction:{additionalProperties:!1,description:"Primary action button configuration",properties:{icon:{description:"Icon type string from Icon.TYPES for the action button",type:"string"},isDisabled:{description:"Disable the action button. Default: false",type:"boolean"},shouldShowSpinner:{description:"Show spinner on the action button. Default: false",type:"boolean"},title:{description:"Action button label",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Navigation destination for the action. String URL or { path, openInNewTab? }"}},required:["title"],type:"object"},secondaryAction:{additionalProperties:!1,description:"Secondary action button configuration",properties:{icon:{description:"Icon type string from Icon.TYPES for the action button",type:"string"},isDisabled:{description:"Disable the action button. Default: false",type:"boolean"},shouldShowSpinner:{description:"Show spinner on the action button. Default: false",type:"boolean"},title:{description:"Action button label",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Navigation destination for the action. String URL or { path, openInNewTab? }"}},required:["title"],type:"object"},title:{description:"Alert title text displayed above the message",type:"string"},type:{description:"Alert type determining color and icon. Default: Info",enum:["Info","Success","Warning","Error","Neutral"],type:"string"}},type:"object"},acceptsChildren:!1},Animation:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{type:{description:"The animation type to render from the pre-built library",enum:["ADD","AIRPLANE","BAR_CHART_DECREASE","BAR_CHART_INCREASE","BRAIN","BRAIN_AI","CALENDAR","CHECK_MARK","CLOCK","COINS_USD","CREDIT_CARD","DOCUMENT","ENTERPRISE","EXCLAMATION_MARK","FOLDERS","GEAR","GEAR_HEART","GEAR_PLAY","GLOBE","GRAD_CAP","HANDSHAKE","HEART","INTEGRATION","INVENTORY_MANAGEMENT","LAPTOP","LAPTOP_DEV","LIGHTNING_BOLT","LOCK","LOCK_UNLOCKED","MAGNIFYING_GLASS","MAGNIFYING_GLASS_QUESTION_MARK","NO_WIFI","OFFBOARDING","ONBOARDING","PAYROLL_EURO","PAYROLL_RUPEE","PAYROLL_USD","PAYROLL_YEN","QUESTION_MARK","RECEIPT","REFRESH","SHIELD_CHECK","SPEECH_BUBBLE","THIRD_PARTY","TRAIN","UNIFIED_SYSTEM","X"],type:"string"}},required:["type"],type:"object"},acceptsChildren:!1},ApiError:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{fixedWindowCentered:{description:"Positions the error component fixed in the center of the browser viewport. Default: false",type:"boolean"},message:{description:"Custom error message to display. Default: i18n fallback message",type:"string"},windowCentered:{description:"Positions the error component absolutely in the center of the nearest positioned parent container. Default: false",type:"boolean"}},type:"object"},acceptsChildren:!1},AppGroupLoader:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!1},AppGroupSelect:{description:"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.",events:["change","blur","focus","paste","menuToggle"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this select",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this select",type:"string"},canClear:{description:"Show clear button to deselect all",type:"boolean"},canSelectAll:{description:"Show select-all toggle",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},creatable:{description:"Allow creating new options not in the list",type:"boolean"},defaultSearchQuery:{description:"Initial search input value",type:"string"},dropdownHeight:{description:"Sets dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query entered",type:"string"},onNoSearchResults:{description:"Placeholder when search returns no results",type:"string"}},type:"object"}],description:"Placeholder when dropdown list is empty. Can be string or object with state-specific placeholders"},footer:{additionalProperties:!1,description:"Fixed footer at bottom of dropdown menu",properties:{label:{description:"Footer link text",type:"string"},onClick:{description:"Event name to emit when footer is clicked",type:"string"}},required:["label","onClick"],type:"object"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing fuzzy search behavior",propertyNames:{type:"string"},type:"object"},id:{description:"HTML id attribute for the select input",type:"string"},isDisabled:{description:"Disables the select",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu will be open by default",type:"boolean"},isPositionFixed:{description:"Position dropdown relative to viewport instead of parent",type:"boolean"},isReadOnly:{description:"Makes the select read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isSearchable:{description:"Enable type-to-search filtering",type:"boolean"},label:{description:"Label text above the select",type:"string"},list:{description:"Array of options or grouped options. Supports flat list or nested groups with label and list properties",items:{anyOf:[{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},{additionalProperties:!1,properties:{label:{description:"Group label/header",type:"string"},list:{description:"Options within this group",items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"}},required:["label","list"],type:"object"}]},type:"array"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Max height of multi-select container (CSS value)"},maxTruncationLines:{description:'Max rows of chips visible before "+X" overflow chip appears',type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},placement:{description:"Dropdown position relative to input. Default: bottom-start",enum:["auto","auto-start","auto-end","top","top-start","top-end","bottom","bottom-start","bottom-end","right","right-start","right-end","left","left-start","left-end"],type:"string"},rows:{description:"Minimum number of rows to show",type:"number"},scrollThreshold:{description:"Extra pixels to render above/below viewport for smoother scrolling (pagination mode)",type:"number"},selectedOptionsModalClassName:{description:"CSS class for the modal showing all selected options (+X chip)",type:"string"},shouldFocusFirstElement:{description:"Auto-focus first menu item when dropdown opens",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix when isSearchable is true",type:"boolean"},shouldUsePortal:{description:"Render dropdown in a React Portal. Default: false",type:"boolean"},size:{description:"Select input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{},{items:{},type:"array"}],description:"Currently selected value(s) bound to state. Always an array in multi-select mode"}},type:"object"},acceptsChildren:!1},AppNavBar:{description:"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.",events:["navigate","action"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{actionClickedId:{description:"Stores the id of the clicked action button. Bind to state to access in the action event handler",type:"string"},actions:{description:"Array of action buttons displayed in the nav bar. Each emits an action event with its id",items:{additionalProperties:!1,properties:{appearance:{description:"Button visual style. Default: PRIMARY",enum:["PRIMARY","DESTRUCTIVE","OUTLINE","GHOST","ACCENT","SUCCESS","INFO","WARNING"],type:"string"},icon:{description:"Icon name from Icon.TYPES (e.g. ADD, EDIT_OUTLINE)",type:"string"},id:{description:"Unique identifier for the action. Written to actionClickedId state on click",type:"string"},isDisabled:{description:"Disables the button. Default: false",type:"boolean"},label:{description:"Button text",type:"string"},size:{description:"Button size. Default: M",enum:["L","M","S","XS"],type:"string"}},required:["id","label"],type:"object"},type:"array"},activeUrl:{description:"The currently active URL path. Use $bindState to two-way bind this to state — the value updates automatically when the user clicks a nav item.",type:"string"},baseURL:{description:"Base URL prefix prepended to all link paths",type:"string"},isLogoRound:{description:"If true, logo has rounded corners",type:"boolean"},isVertical:{description:"If true, renders a vertical sidebar navigation instead of horizontal tabs",type:"boolean"},links:{description:"Array of navigation items defining the nav structure",items:{$ref:"#/$defs/AppNavBarNavItem"},type:"array"},logoUrl:{description:"URL for a logo image in the header area",type:"string"},shouldPersistQueryParams:{description:"If true, existing query parameters are preserved across navigation",type:"boolean"},size:{description:"Fixed width in pixels for horizontal layout. 0 or omitted for fluid width",type:"number"},subtitle:{description:"Subtitle text below the title",type:"string"},supportLink:{description:"URL for a support/help link",type:"string"},theme:{description:"Visual theme: BOX (default with border), NO_PADDING (no padding), BOX_HEADER (border on header only)",enum:["BOX","NO_PADDING","BOX_HEADER"],type:"string"},title:{description:"Title displayed in the nav bar header area",type:"string"}},required:["links"],type:"object"},acceptsChildren:!0},AtomsSeparator:{description:'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.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{text:{description:"Optional text displayed in the center of the separator",type:"string"},theme:{description:"Separator line style. Omit for solid",enum:["DASHED"],type:"string"}},type:"object"},acceptsChildren:!1},Avatar:{description:"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.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Color appearance variant for background/text",enum:["NEUTRAL_LIGHT","NEUTRAL_DARK","PRIMARY_LIGHT","PRIMARY_DARK","INFO_LIGHT","INFO_DARK","ERROR_LIGHT","ERROR_DARK","WARNING_LIGHT","WARNING_DARK","SUCCESS_LIGHT","SUCCESS_DARK"],type:"string"},"aria-label":{description:"Accessible label for the avatar",type:"string"},"aria-labelledby":{description:"ID of element that labels the avatar",type:"string"},"aria-role":{description:"ARIA role for the avatar element",type:"string"},badge:{additionalProperties:!1,description:"Badge overlay configuration for the avatar",properties:{"aria-label":{description:"Accessible label for the badge",type:"string"},char:{description:"Single character to display in the badge overlay",type:"string"}},required:["aria-label"],type:"object"},caption:{description:"Secondary text shown below the title",type:"string"},flagCountryCode:{description:"ISO country code (e.g. US, IN) to show a flag overlay on the avatar",type:"string"},icon:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{backgroundColor:{enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},color:{enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{type:"string"}},required:["type"],type:"object"}],description:"Icon name from Icon.TYPES (e.g. EDIT_OUTLINE) or { type, color?, backgroundColor? } when type is ICON"},image:{description:"Image URL for the avatar",type:"string"},imageBackground:{description:"Surface color token behind the avatar image",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},isCompact:{description:"Compact mode hides title and caption. Default: false",type:"boolean"},isRounded:{description:"Fully rounded (circle) shape. Default: true",type:"boolean"},size:{anyOf:[{const:24,type:"number"},{const:32,type:"number"},{const:40,type:"number"},{const:56,type:"number"},{const:64,type:"number"}],description:"Avatar size in pixels. One of: 24, 32, 40, 56, 64. Default: 40"},surfaceColor:{description:"Surface color for flag background. Pebble color token. Required with flagCountryCode",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},tip:{additionalProperties:!1,description:"Tooltip shown on avatar hover. Object with content string and optional title",properties:{appearance:{description:"Tooltip appearance. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},title:{description:"Tooltip title text",type:"string"}},required:["content"],type:"object"},title:{description:"Display name shown below or beside the avatar",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Navigation destination. String URL or { path, openInNewTab? }. Use instead of click event if click is just for navigation"},truncate:{description:"Truncate title and caption with ellipsis. Default: true",type:"boolean"},type:{description:"Avatar content type. Default: USER",enum:["USER","ICON","TEXT","NUMBER","RIPPLING"],type:"string"}},type:"object"},acceptsChildren:!1},AvatarList:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes the avatar list",type:"string"},"aria-label":{description:"Accessible label for the avatar list",type:"string"},"aria-labelledby":{description:"ID of element that labels the avatar list",type:"string"},isRounded:{description:"If false, avatars render as rounded squares",type:"boolean"},limit:{description:"Maximum number of avatars to display before +N overflow",type:"number"},modalTitle:{description:"Title of the modal shown when clicking overflow",type:"string"},roles:{description:"Array of role/person objects for avatars",items:{additionalProperties:!1,properties:{fullName:{description:"Display name",type:"string"},id:{description:"Unique identifier",type:"string"},image:{description:"Avatar image URL",type:"string"},inviteEmail:{description:"Invite email (fallback label if fullName/workEmail absent)",type:"string"},partnerCompany:{additionalProperties:{},description:"Partner company data for profile URL routing",propertyNames:{type:"string"},type:"object"},user_cache:{additionalProperties:{},description:"User cache data with smallPhoto fallback",properties:{smallPhoto:{description:"Small photo URL",type:"string"}},type:"object"},workEmail:{description:"Work email",type:"string"}},type:"object"},type:"array"},size:{anyOf:[{const:24,type:"number"},{const:32,type:"number"},{const:40,type:"number"},{const:56,type:"number"},{const:64,type:"number"}],description:"Avatar size in pixels. One of: 24, 32, 40, 56, 64. Default: 40"},totalCount:{description:"Total count for overflow indicator",type:"number"},type:{description:"Avatar content type",enum:["USER","ICON","TEXT","NUMBER","RIPPLING"],type:"string"}},type:"object"},acceptsChildren:!1},Badge:{description:"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).",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Visual appearance variant (INFO_DARK, SUCCESS_DARK, etc.). Default: INFO_DARK",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},"aria-hidden":{description:"Hide badge from screen readers",type:"boolean"},"aria-label":{description:"Accessibility label for screen readers",type:"string"},size:{description:"Size of the badge. One of: EXTRA_SMALL, SMALL, MEDIUM, LARGE. Default: SMALL",enum:["EXTRA_SMALL","SMALL","MEDIUM","LARGE"],type:"string"},text:{description:"Text content to display in the badge. Required.",type:"string"},tip:{additionalProperties:!1,description:"Tooltip configuration to show on hover",properties:{appearance:{description:"Tooltip theme. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},isDelayed:{description:"Add delay before showing/hiding the tooltip. Default: false",type:"boolean"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Max width of tooltip. Number in px or CSS string"},placement:{description:"Tooltip position relative to badge. Default: bottom",enum:["top","bottom","left","right","top-start","top-end","bottom-start","bottom-end"],type:"string"}},required:["content"],type:"object"}},required:["text"],type:"object"},acceptsChildren:!1},Box:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{align:{description:'Align items on cross axis. CSS align-items value (e.g., "center", "flex-start")',type:"string"},alignSelf:{description:'Align this child on cross axis. CSS align-self value (e.g., "center", "flex-end")',type:"string"},"aria-describedby":{description:"ID of element that describes this Box",type:"string"},"aria-disabled":{description:"Marks this Box as disabled for assistive technology",type:"boolean"},"aria-hidden":{description:"Hide this Box from assistive technology",type:"boolean"},"aria-label":{description:"Accessible label",type:"string"},"aria-labelledby":{description:"ID of element that labels this Box",type:"string"},backgroundColor:{description:"Background surface color token",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},basis:{anyOf:[{type:"number"},{type:"string"}],description:"Flex basis value. Number (pixels) or CSS string"},border:{anyOf:[{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}]},{additionalProperties:!1,properties:{bottom:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Bottom border"},left:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Left border"},right:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Right border"},top:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Top border"}},type:"object"}],description:"Border value. CSS string, strict token parts, or directional border object"},boxSizing:{description:'CSS box-sizing value. "content-box" or "border-box". Default: content-box',type:"string"},changeDirectionAbove:{description:"Breakpoint in pixels at which to reverse flex direction. Uses container queries. Requires container prop for named containers",type:"number"},child:{description:"Whether this Box is a flex child. Changes display to initial",type:"boolean"},color:{description:"Text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},container:{anyOf:[{type:"boolean"},{type:"string"}],description:"Container query target. true for unnamed container, string for named container. Used with changeDirectionAbove"},containerType:{description:"CSS container-type value. Defines the element as a query container",type:"string"},direction:{description:'Flex direction. CSS flex-direction value (e.g., "row", "column")',type:"string"},flex:{description:'CSS flex shorthand (e.g., "1", "0 1 auto")',type:"string"},gap:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{column:{description:"Column gap spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},row:{description:"Row gap spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Gap between flex children. Spacing token or {row, column} spacing-token object"},grow:{anyOf:[{type:"number"},{type:"string"}],description:"Flex grow factor. Number value"},height:{anyOf:[{type:"number"},{type:"string"}],description:'Height value. Number (pixels) or CSS string (e.g., "100px", "50%")'},id:{description:"HTML id attribute",type:"string"},inset:{anyOf:[{type:"number"},{type:"string"}],description:"Offsets a positioned Box on all sides. Number (pixels) or CSS string"},isInline:{description:"Use inline-flex instead of flex. Default: false",type:"boolean"},justify:{description:'Justify content on main axis. CSS justify-content value (e.g., "center", "space-between")',type:"string"},margin:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Margin value. Spacing token or {top, right, bottom, left} spacing-token object"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height value. Number (pixels) or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width value. Number (pixels) or CSS string"},minHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum height value. Number (pixels) or CSS string"},minWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum width value. Number (pixels) or CSS string"},overflow:{description:'CSS overflow value (e.g., "hidden", "auto", "scroll")',type:"string"},padding:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Padding value. Spacing token or {top, right, bottom, left} spacing-token object"},pointerEvents:{description:"CSS pointer-events value controlling whether the Box receives pointer input",type:"string"},position:{description:'CSS position value (e.g., "relative", "absolute", "fixed")',type:"string"},radius:{anyOf:[{enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},{additionalProperties:!1,properties:{bottomLeft:{description:"Bottom-left corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},bottomRight:{description:"Bottom-right corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},topLeft:{description:"Top-left corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},topRight:{description:"Top-right corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"}},type:"object"}],description:"Border radius. Radius token or {topLeft, topRight, bottomLeft, bottomRight} radius-token object"},reverse:{description:"Reverse the flex direction. Combines with direction prop",type:"boolean"},role:{description:"ARIA role attribute",type:"string"},shrink:{anyOf:[{type:"number"},{type:"string"}],description:"Flex shrink factor. Number value"},width:{anyOf:[{type:"number"},{type:"string"}],description:'Width value. Number (pixels) or CSS string (e.g., "200px", "100%")'},wrap:{description:'Flex wrap behavior. CSS flex-wrap value (e.g., "wrap", "nowrap")',type:"string"},zIndex:{anyOf:[{type:"number"},{type:"string"}],description:"Z-index stacking order. Number value"}},type:"object"},acceptsChildren:!0},BrandBadge:{description:'Displays Rippling brand badges with consistent styling. Badges come in animated (Lottie-based) and static (SVG) variants. Use for decorative brand moments, empty states, success confirmations, or feature illustrations. Animated badges play once by default; use motion="static" to freeze them.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{motion:{description:'Controls animation behavior. Only applies to animated badge types. "animated" plays animation, "static" shows first frame. Default: animated',enum:["animated","static"],type:"string"},type:{description:"Badge type/icon to display. Choose from animated or static badge types",enum:["ADD","AIRPLANE","BAR_CHART_DECREASE","BAR_CHART_INCREASE","BRAIN","BRAIN_AI","CALENDAR","CHECK_MARK","CLOCK","COINS_USD","CREDIT_CARD","DOCUMENT","ENTERPRISE","EXCLAMATION_MARK","FOLDERS","GEAR","GEAR_HEART","GEAR_PLAY","GLOBE","GRAD_CAP","HANDSHAKE","HEART","INTEGRATION","INVENTORY_MANAGEMENT","LAPTOP","LAPTOP_DEV","LIGHTNING_BOLT","LOCK","LOCK_UNLOCKED","MAGNIFYING_GLASS","MAGNIFYING_GLASS_QUESTION_MARK","NO_WIFI","OFFBOARDING","ONBOARDING","PAYROLL_EURO","PAYROLL_RUPEE","PAYROLL_USD","PAYROLL_YEN","QUESTION_MARK","RECEIPT","REFRESH","SHIELD_CHECK","SPEECH_BUBBLE","THIRD_PARTY","TRAIN","UNIFIED_SYSTEM","X","API_ERROR","APPROVAL_STAMP","AVATAR","BRIEFCASE","CAR","CONFETTI","CRYSTAL_BALL","EXPENSE","EXPLOSION","EYE","FIRE","FLAG","GOVERNMENT","HAND_POINTING","HAND_WAVING","HAPPY_SAD_FACE","HEADCOUNT_PLANNING","KEY","LIGHTBULB","LIGHTNING_BOLT_HEXAGON","MEGAPHONE","METER","MID_SIZE_BUILDINGS","ORG_CHART_HORIZONTAL","ORG_CHART_VERTICAL","PENCIL","PHONE","PIE_CHART","ROCKET","ROCKING_CHAIR","SHIELD_STAR","SHOOTING_STAR","SKULL","SMALL_BUSINESS_BUILDING","SPARKLE","TEAM","THUMBS_UP","TICKET","TOOTH","TROPHY"],type:"string"}},required:["type"],type:"object"},acceptsChildren:!1},Breadcrumb:{description:"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.",events:["select"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{active:{description:"Value of the active breadcrumb item. Default: last item",type:"string"},"aria-describedby":{description:"ID of element that describes the breadcrumb nav",type:"string"},"aria-label":{description:"Accessible label for the breadcrumb nav",type:"string"},"aria-labelledby":{description:"ID of element that labels the breadcrumb nav",type:"string"},items:{description:"Array of breadcrumb items: {title, value, isDisabled?, href?}",items:{additionalProperties:!1,properties:{href:{description:"URL to navigate to when clicked",type:"string"},isDisabled:{description:"Disables the breadcrumb item",type:"boolean"},title:{description:"Display label for the breadcrumb item",type:"string"},value:{description:"Unique value identifier for the item",type:"string"}},required:["title","value"],type:"object"},type:"array"},noMargin:{description:"Remove default margin from the component. Default: false",type:"boolean"},shouldCollapseMiddle:{description:"Collapse middle items into a dropdown on desktop. Default: false",type:"boolean"},shouldTruncateItems:{description:"Truncate breadcrumb item text to one line at 128px and show full text in a tooltip on overflow. Default: false",type:"boolean"}},required:["items"],type:"object"},acceptsChildren:!1},Button:{description:"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.",events:["press","pressWhileDisabled","mouseEnter","mouseLeave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Visual style variant. Default: PRIMARY",enum:["PRIMARY","DESTRUCTIVE","OUTLINE","GHOST","ACCENT","SUCCESS","INFO","WARNING","SOLID","ACTIVE"],type:"string"},"aria-controls":{description:"ID of element controlled by this button",type:"string"},"aria-describedby":{description:"ID of element that describes this button",type:"string"},"aria-expanded":{description:"Indicates whether controlled element is expanded",type:"boolean"},"aria-haspopup":{anyOf:[{type:"boolean"},{enum:["menu","listbox","tree","grid","dialog"],type:"string"}],description:"Indicates button triggers a popup element"},"aria-label":{description:"Accessibility label for the button",type:"string"},"aria-labelledby":{description:"ID of element that labels this button",type:"string"},"aria-pressed":{anyOf:[{type:"boolean"},{enum:["mixed"],type:"string"}],description:"Indicates button pressed state (for toggle buttons)"},badge:{description:"Badge text shown on the button",type:"string"},contentAlignment:{description:"Horizontal alignment of button content. Default: CENTER",enum:["CENTER","START"],type:"string"},fontInherit:{description:"When variant is TEXT, inherit font from parent element. Only works with TEXT variant. Default: false",type:"boolean"},icon:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{alignment:{description:"Icon alignment relative to label. Default: LEFT",enum:["LEFT","RIGHT"],type:"string"},color:{description:"Pebble text/icon color token. Only supported for OUTLINE, SOLID, GHOST appearances",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:'Icon type name (e.g., "CHECK", "EDIT_OUTLINE")',type:"string"}},required:["type"],type:"object"}],description:"Icon to show in button. Can be icon name string or object with type, color, alignment"},id:{description:"DOM id selector for the button element",type:"string"},inverseDisabledColors:{description:"Use inverse color tokens for disabled buttons on dark backgrounds. Default: false",type:"boolean"},isDisabled:{description:"Disables the button. Default: false",type:"boolean"},isFluid:{description:"Stretch to full container width. Default: false",type:"boolean"},label:{description:"Button text content",type:"string"},shouldShowSpinner:{description:"Show loading spinner explicitly. Default: false",type:"boolean"},size:{description:"Button size. Default: M",enum:["L","M","S","XS"],type:"string"},tabIndex:{description:"Tab order index for keyboard navigation",type:"number"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Control tooltip visibility from parent",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max height (number in px or CSS string)"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max width (number in px or CSS string)"},placement:{description:"Tooltip placement relative to button. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip configuration. Can be simple string content or object with appearance/placement"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{description:"Open link in new tab. Default: false",type:"boolean"},path:{description:"URL path for navigation",type:"string"}},required:["path"],type:"object"}],description:"Navigation destination. When provided, button renders as anchor and handles navigation automatically"},type:{description:"HTML button type attribute. Default: button",enum:["button","reset","submit"],type:"string"},variant:{description:"Button variant type. Default: NORMAL",enum:["NORMAL","TEXT"],type:"string"}},type:"object"},acceptsChildren:!1,category:["buttons"],keywords:["button","cta","call to action","submit","save","action","click","primary action"],anatomy:{parts:[{name:"label",required:!0,role:"Verb-led action text passed as children"},{name:"icon",role:"Optional glyph via the icon prop when it aids recognition"},{name:"badge",role:"Optional short status text beside the label"}],summary:"A sized container holding a verb-led text label, with an optional leading icon and an optional short badge beside the label."},guidance:{doNotUseWhen:["Navigating to another page or URL — use Anchor","Icon-only action without an accessible name — use Button.Icon with aria-label","Toggleable selected state — use a segmented control or Switch","Dense repeated row actions — use a Menu or overflow pattern"],useWhen:["Submitting a form or confirming an action","Primary call-to-action on a page, card, or modal footer","Starting a flow (add, create, invite)","Icon-only action via Button.Icon with an accessible name"]},antiPatterns:[{instead:"Use Button.Icon with aria-label",pattern:"Icon-only actions built as Button with an icon prop and no label",why:"Ambiguous hierarchy and missing accessible name"},{instead:"Use Button.Icon",pattern:"Plain clickable Icon used for actions",why:"No button semantics, focus, or hit-area guarantees"},{instead:"Use Anchor with href",pattern:"Navigation implemented as Button + onClick router push",why:"Breaks link semantics, middle-click, and screen reader expectations"},{instead:"Keep the CTA enabled and surface inline validation errors",pattern:"Disabled primary CTA on forms and footers",why:"Users cannot trigger validation feedback"},{instead:"Open a confirmation Modal and place the destructive Button in Modal.Footer",pattern:"DESTRUCTIVE appearance used inline outside a confirmation modal",why:"Destructive actions need a confirmation step"},{instead:"Use PRIMARY for emphasis; reserve ACTIVE for selected state",pattern:"ACTIVE appearance used as a static color",why:"ACTIVE communicates selected/on state, not emphasis"},{instead:"Pick one size per surface (default M)",pattern:"Mixed button sizes on the same surface",why:"Breaks visual hierarchy"},{instead:"Use Button.Icon or a Menu for dense repeated actions",pattern:"Text variant used for dense toolbar or row actions",why:"Hierarchy and component choice become unclear"},{instead:"Always compose from Button",pattern:"Custom button-like control built from raw elements",why:"Loses accessibility, theming, and state-layer behavior"},{instead:"Use Button.SIZES",pattern:"Legacy BUTTON_SIZES constant",why:"Deprecated alias"},{instead:'Use a single verb-led label like "Save changes"',pattern:"Vague, compound, or non-verb-led labels",why:"Users cannot predict the outcome"},{instead:"Only add an icon when it disambiguates the action",pattern:"Decorative icon added to a labeled Button without clear necessity",why:"Adds noise without aiding recognition"}],propGuidance:[{guidance:"PRIMARY for the single main action on a surface; OUTLINE or GHOST for secondary actions; DESTRUCTIVE only inside confirmation flows.",pitfall:"ACTIVE is a selected/on state, not a static emphasis color.",prop:"appearance"},{guidance:"TEXT is for low-emphasis inline actions where context makes the target obvious; default to NORMAL.",prop:"variant"},{guidance:"Default M. Use S/XS only in dense surfaces and keep one size per surface.",prop:"size"},{guidance:"Accepts a glyph string or IconConfig with alignment and color. For icon-only actions use Button.Icon instead.",prop:"icon"},{guidance:"Avoid disabling the primary form CTA; let users attempt submission and show validation errors.",prop:"isDisabled"},{guidance:"Use for async actions to prevent double submits; pair with a label that stays stable while loading.",prop:"isLoading"}],selection:{confusedWith:[{component:"Anchor",distinguishBy:"Anchor navigates (href); Button performs an action (onClick). If the result is a URL change, use Anchor."},{component:"Button.Icon",distinguishBy:"Icon-only action → Button.Icon with aria-label; labeled action → Button."},{component:"SplitButton",distinguishBy:"One primary action with related alternatives in a menu → SplitButton."},{component:"FloatingButton",distinguishBy:"Action that must stay visible over scrolling content → FloatingButton."}]},relatedComponents:[{name:"Button.Icon",note:"Icon-only variant; requires aria-label",relationship:["child"]},{name:"SplitButton",note:"Primary action plus related alternatives",relationship:["child"]},{name:"FloatingButton",note:"Fixed-position action over content",relationship:["child"]},{name:"Anchor",note:"Navigation instead of action",relationship:["alternative"]},{name:"ButtonGroup",note:"Groups related buttons with shared sizing",relationship:["complement"]},{name:"Modal.Footer",note:"Canonical placement for modal action buttons",relationship:["complement"]}],subComponents:{"Button.Icon":{antiPatterns:[{instead:"Pass aria-label describing the action",pattern:"Button.Icon without aria-label or aria-labelledby",why:"Screen readers announce nothing meaningful"}],description:"Icon-only button for compact actions; always requires an accessible name."}}},ButtonGroup:{description:"Layout container for arranging multiple Button elements horizontally or vertically with configurable placement, alignment, gap, and wrapping.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alignment:{description:"Cross-axis alignment. Default: center",enum:["center","flex-start","flex-end"],type:"string"},containerHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Height of the button group container"},flexWrap:{description:"Whether buttons wrap to the next line",enum:["nowrap","wrap","wrap-reverse"],type:"string"},gap:{description:"Gap between buttons as a spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},placement:{description:"Layout placement of buttons. Default: horizontallyLeft",enum:["horizontallyLeft","horizontallyCenter","horizontallyRight","horizontallySpaceBetween","verticallyTop","verticallyCenter","verticallyBottom","verticallySpaceBetween"],type:"string"}},type:"object"},acceptsChildren:!0},Calendar:{description:"An inline calendar for selecting single or multiple dates. Displays a monthly view with navigation controls. Use for date selection UI without input field — when the calendar should always be visible. Use Date input for calendar in a popover; use DateInlineMulti for multiple date selection with different layout options.",events:["click","clear","confirmMobile"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{displayDate:{description:"Month to show initially as an ISO date string",type:"string"},format:{description:"Date display format. Default: MM/dd/yyyy",enum:["yyyy/MM/dd","yyyy-MM-dd","MM/dd/yyyy","dd/MM/yyyy","yyyy/MM/dd hh:mm a","yyyy-MM-dd hh:mm a","MM/dd/yyyy hh:mm a","dd/MM/yyyy hh:mm a","yyyy/MM/dd hh:mm:ss a","yyyy-MM-dd hh:mm:ss a","MM/dd/yyyy hh:mm:ss a","dd/MM/yyyy hh:mm:ss a","ISO_STRING"],type:"string"},isDisabled:{description:"Disables the calendar",type:"boolean"},isLarge:{description:"Renders large calendar when true. Default: false",type:"boolean"},locale:{description:"Locale string used to determine the start of week",type:"string"},maxDate:{description:"Latest selectable date as ISO string",type:"string"},minDate:{description:"Earliest selectable date as ISO string",type:"string"},shouldShowFooter:{description:"Controls footer visibility. Default: true",type:"boolean"},shouldShowHeader:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{headerActions:{description:"Show month/year navigation",type:"boolean"}},required:["headerActions"],type:"object"}],description:"Controls header visibility. Default: true"},shouldShowWeekDayInitials:{description:"If false, hides week day initials. Default: true",type:"boolean"},showMonthYearPicker:{description:"Show month and year picker in the calendar header. Default: false",type:"boolean"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Selected date(s) as ISO string(s). Single date or array for multi-select"}},type:"object"},acceptsChildren:!1},Card:{description:"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).",events:["edit","delete","add","click","action"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{actions:{description:'Array of action objects {id, label, icon}. Displayed as dropdown options. Emits "action" event with clicked action id written to actionId state',items:{additionalProperties:!1,properties:{icon:{description:'Icon name from Icon.TYPES (e.g. "EDIT", "DELETE")',type:"string"},id:{description:"Unique identifier for the action",type:"string"},label:{description:"Label text for the action",type:"string"}},required:["id","label"],type:"object"},type:"array"},actionsDropdownWidth:{description:"Width in pixels for the actions dropdown",type:"number"},content:{description:"Text content to display in the card body",type:"string"},fluid:{description:"Layout mode only. When true, the card fills its parent width (including inside row layouts, where it would otherwise size to its content). Ignored when title or content is set (basic card mode). Default: false",type:"boolean"},isAddCard:{description:'Render as add card with plus icon. Emits "add" event when clicked. Default: false',type:"boolean"},isDisabled:{description:"Whether the card is disabled. Default: false",type:"boolean"},minCardHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum height of card. Number values are pixels. Default: 150"},padding:{anyOf:[{const:0,type:"number"},{const:8,type:"number"},{const:16,type:"number"},{const:24,type:"number"},{const:32,type:"number"},{type:"string"}],description:"Padding for layout mode. Supports Card.Layout PADDINGS values or CSS string"},selectedActionId:{description:'Bound state path for the selected action id. Written before "action" event fires',type:"string"},showDelete:{description:'Show delete button. Emits "delete" event when clicked. Default: false',type:"boolean"},showEdit:{description:'Show edit button. Emits "edit" event when clicked. Default: false',type:"boolean"},theme:{description:"Visual theme for layout mode. DEFAULT or SELECTABLE",enum:["DEFAULT","SELECTABLE"],type:"string"},title:{description:"Card header title text",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Route destination. String URL or object with {path, openInNewTab}. Card renders as anchor when provided"},value:{description:"Identifier value for the card, passed to event handlers"}},type:"object"},acceptsChildren:!0},CardGroup:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{minCardHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum height of each card. Number values are pixels. Default: 150"},placement:{description:"Horizontal alignment of cards within the container. One of: HORIZONTALLY_LEFT, HORIZONTALLY_CENTER, HORIZONTALLY_RIGHT, HORIZONTALLY_SPACE_BETWEEN",enum:["HORIZONTALLY_LEFT","HORIZONTALLY_CENTER","HORIZONTALLY_RIGHT","HORIZONTALLY_SPACE_BETWEEN"],type:"string"}},type:"object"},acceptsChildren:!0},Carousel:{description:"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.",events:["done"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{slides:{description:"Array of slide configurations with heading and image",items:{additionalProperties:!1,properties:{alt:{description:"Alt text for the slide image",type:"string"},heading:{description:"Slide heading text",type:"string"},img:{description:"Slide image URL",type:"string"}},required:["heading","img"],type:"object"},type:"array"}},required:["slides"],type:"object"},acceptsChildren:!1},ChartLoader:{description:"A skeleton placeholder shown while chart or graph content is loading. Use when the content area will contain a chart and you want to reduce perceived loading time and prevent layout shift.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!1},Checkbox:{description:'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.',events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the checkbox",type:"string"},"aria-describedby":{description:"ID of element that describes this checkbox",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this checkbox",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial checked state when uncontrolled",type:"boolean"},isDisabled:{description:"Disables the checkbox",type:"boolean"},isIndeterminate:{description:"Sets checkbox to indeterminate (neither checked nor unchecked) state",type:"boolean"},isReadOnly:{description:"Makes the checkbox read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text for the checkbox. Ignored when the element has children (rich label).",type:"string"},secondaryLabel:{description:"Secondary text below the label",type:"string"},theme:{description:"Visual theme variant",enum:["FLUID_WIDTH","REVERSE","FLUID_WIDTH_SPACE_BETWEEN_REVERSE"],type:"string"},tip:{description:"Tooltip text shown on hover",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Checked state bound to state",type:"boolean"},variant:{description:"Display variant",enum:["BOX","LIST","GRID"],type:"string"}},type:"object"},acceptsChildren:!0},CheckboxGroup:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this checkbox group",type:"string"},"aria-label":{description:"Accessibility label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this checkbox group",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial values when uncontrolled",items:{},type:"array"},id:{description:"HTML id attribute for the checkbox group",type:"string"},isDisabled:{description:"Disables all checkbox options",type:"boolean"},isHorizontal:{description:"Arrange options in a row",type:"boolean"},isReadOnly:{description:"Makes the checkbox group read-only (displays as chips)",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the checkbox group",type:"string"},list:{description:"Array of { label, value } checkbox option objects",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this specific checkbox",type:"boolean"},label:{description:"Display text for the checkbox option",type:"string"},secondaryLabel:{description:"Secondary text below the option label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance style",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},label:{description:"Tag label text",type:"string"}},required:["label"],type:"object"}],description:"Optional tag/label displayed with the option"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when document scrolls. Default: false",type:"boolean"},isDelayed:{description:"Add delay before showing tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning relative to viewport. Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from state",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip content"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip content"},onlyIfChildOverflow:{description:"Only show tooltip if any child content overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if content overflows. Default: false",type:"boolean"},overwriteMiddleware:{description:"Overwrite default floating-UI middleware. Default: false",type:"boolean"},padding:{description:"CSS padding value for tooltip content",type:"string"},placement:{description:"Tooltip placement relative to the checkbox option",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"},shallSkipOverflowY:{description:"Skip overflow check on Y axis. Default: false",type:"boolean"},tipHideDelay:{description:"Milliseconds to wait before hiding tooltip when delayed",type:"number"},tipShowDelay:{description:"Milliseconds to wait before showing tooltip when delayed",type:"number"},title:{description:"Tooltip title text",type:"string"},truncateClassName:{description:"CSS class when onlyIfOverflow is enabled",type:"string"}},required:["content"],type:"object"}],description:"Tooltip shown on hover. Can be simple string text or a TipTypes object"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},theme:{description:"Theme styling: FLUID_WIDTH for full-width options, REVERSE for reversed theme",enum:["FLUID_WIDTH","REVERSE","FLUID_WIDTH_SPACE_BETWEEN_REVERSE"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Currently selected values bound to state",items:{},type:"array"},variant:{description:"Visual variant: BOX for boxed layout, LIST for list layout, GRID for grid layout",enum:["BOX","LIST","GRID"],type:"string"}},type:"object"},acceptsChildren:!1},CheckList:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{canSelectAll:{description:'Show a "Select All" option at the top. Default: false',type:"boolean"},hasIndependentActions:{description:"Checking/unchecking an item does not affect parent or child items",type:"boolean"},hasIndependentChildActions:{description:"Checking/unchecking a child does not affect ancestor items",type:"boolean"},indent:{description:"Indentation in pixels for nested children",type:"number"},list:{description:"Array of checklist items with nested branches",items:{$ref:"#/$defs/CheckListItem"},type:"array"},selectAllText:{description:"Custom label for the select all option",type:"string"},shouldHaveNegativeCheckbox:{description:"Show negative (red) checkbox style when type is CHECKBOX",type:"boolean"},shouldShowIndeterminate:{description:"Show indeterminate state on parent when some children are checked",type:"boolean"},showMoreSize:{description:'Number of items shown before "show more" toggle at global level',type:"number"},theme:{description:"Visual theme controlling border and padding: NO_PADDING, NO_BORDER, or NO_PADDING_NO_BORDER",enum:["NO_PADDING","NO_BORDER","NO_PADDING_NO_BORDER"],type:"string"},title:{description:"Checklist title text",type:"string"},type:{description:"Input type for all items: SWITCH or CHECKBOX",enum:["SWITCH","CHECKBOX"],type:"string"}},required:["list","title","type"],type:"object"},acceptsChildren:!1},Chip:{description:'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.',events:["dismiss","press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Visual style (NEUTRAL, NEGATIVE, ACTIVE). Default: NEUTRAL",enum:["NEUTRAL","NEGATIVE","ACTIVE"],type:"string"},"aria-describedby":{description:"ID of element that describes this chip",type:"string"},"aria-label":{description:"Accessibility label for the chip",type:"string"},"aria-labelledby":{description:"ID of element that labels this chip",type:"string"},avatar:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{image:{description:"Avatar image URL",type:"string"},imageProps:{additionalProperties:!1,properties:{alt:{description:"Alt text for avatar image",type:"string"}},type:"object"},title:{description:"Title for generating initials when no image",type:"string"}},type:"object"}],description:"Avatar to display at the beginning. Can be image URL string or object with image/title/imageProps"},icon:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{alignment:{description:"Icon position relative to text. Default: Left",enum:["Left","Right","None"],type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:'Icon type name (e.g., "CHECK", "USERS_OUTLINE")',type:"string"}},required:["type"],type:"object"}],description:"Icon to display. Can be string name or object with type/color/alignment"},isActive:{description:"If true, applies active/selected styling (used inside SelectableGroup)",type:"boolean"},isCloseable:{description:"Shows close button when true. Default: false",type:"boolean"},isDisabled:{description:"If true, the chip is visually and functionally disabled",type:"boolean"},isFluid:{description:"If true, the chip takes all available width. Default: false",type:"boolean"},maxWidth:{description:"Maximum width in pixels. Default: 400px",type:"number"},size:{description:"Size of the chip (SMALL, MEDIUM, LARGE, EXTRA_LARGE). Default: LARGE",enum:["SMALL","MEDIUM","LARGE","EXTRA_LARGE"],type:"string"},text:{description:"Text content to display in the chip",type:"string"},tip:{additionalProperties:!1,description:"Tooltip configuration. Chip has default overflow tooltip behavior",properties:{appearance:{description:"Tooltip appearance (LIGHT, DARK). Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Control tooltip visibility from parent",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max height (number in px or CSS string)"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max width (number in px or CSS string)"},placement:{description:"Tooltip placement relative to chip. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{description:"Open link in new tab",type:"boolean"},path:{description:"Navigation path or URL",type:"string"}},required:["path"],type:"object"}],description:"Navigation destination. Renders chip as anchor with router integration. Use for guaranteed navigation"}},type:"object"},acceptsChildren:!1},ChipGroup:{description:'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.',events:["overflowChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{batchSize:{description:"Number of elements rendered in each incremental step, optimizing performance for large datasets",type:"number"},gap:{description:"Spacing token for the flex gap between chip items. Default: theme default spacing",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},maxLinesToWrap:{description:'Maximum number of lines to display before showing overflow modal. When set, chips exceeding this limit are hidden with a "+N more" trigger that opens a modal',type:"number"},overflowModalIsOpen:{description:"Bindable state value written when the overflow modal opens or closes. True when open, false when closed",type:"boolean"},overflowModalTitle:{description:"Title text shown in the overflow modal header when maxLinesToWrap limit is exceeded",type:"string"}},type:"object"},acceptsChildren:!0},Circle:{description:"Circular graphic element for status or decoration",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{color:{description:"Foreground fill color token of the circle. Default: current theme colorInfo",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},isHollow:{description:"When true, renders a hollow (outlined) circle instead of a filled one. Default: false",type:"boolean"},size:{description:"Diameter of the circle in pixels. Default: 10",type:"number"}},type:"object"},acceptsChildren:!1},ColorPicker:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},allowCustomColors:{description:"Allow users to input custom hex colors. Default: false",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},colorPerRow:{description:"Number of color swatches to display per row",type:"number"},colors:{description:"Array of hex color strings to show in the palette",items:{type:"string"},type:"array"},columnGap:{description:"Horizontal spacing between color columns as a spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},defaultValue:{description:"Default hex color value for reset functionality",type:"string"},isDisabled:{description:"Disables the color picker",type:"boolean"},isReadOnly:{description:"Makes the color picker read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},rowGap:{description:"Vertical spacing between color rows as a spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},showReset:{description:"Show reset link to restore default color. Default: true",type:"boolean"},title:{description:"Title displayed at the top of the color picker panel",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:'Selected hex color string, e.g. "#FF5733"',type:"string"}},type:"object"},acceptsChildren:!1},ContentLoader:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{animate:{description:"Enable animation. Default: true",type:"boolean"},backgroundColor:{description:"Background surface color token. Default: #f5f6f7",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},backgroundOpacity:{description:"Opacity of background color. Default: 1",type:"number"},foregroundColor:{description:"Foreground shimmer color token. Default: #eee",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},foregroundOpacity:{description:"Opacity of foreground shimmer. Default: 1",type:"number"},gradientRatio:{description:"Width of the animated gradient as a ratio. Default: 2",type:"number"},height:{description:"SVG height in px. Default: 130",type:"number"},rtl:{description:"Right-to-left animation direction. Default: false",type:"boolean"},speed:{description:"Animation speed in seconds. Default: 2",type:"number"},width:{description:"SVG width in px. Default: 400",type:"number"}},type:"object"},acceptsChildren:!1},CountDown:{description:"Countdown timer displaying time remaining until a target date",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{date:{description:'ISO 8601 date-time string representing the target future date (e.g. "2025-12-31T23:59:59Z"). The countdown counts down to this date.',type:"string"},isInline:{description:"When true, the countdown renders as an inline element. Default: false",type:"boolean"},shouldUseShortString:{description:"When true, uses abbreviated labels (d, h, m, s) instead of full words (days, hours, minutes, seconds). Default: false",type:"boolean"}},required:["date"],type:"object"},acceptsChildren:!1},Country:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{countryCode:{description:'ISO country code (e.g. "US", "IN", "GB"). Used to display the country flag and name.',type:"string"},icon:{anyOf:[{description:'Icon type name as a string (e.g. "INFO_CIRCLE_OUTLINE")',type:"string"},{additionalProperties:!1,properties:{alignment:{description:'Alignment of the icon within the container. Use "RIGHT" to push icon to the right.',enum:["RIGHT"],type:"string"},"aria-describedby":{description:"ID of element that describes the icon",type:"string"},"aria-label":{description:"Accessible label for the icon",type:"string"},"aria-labelledby":{description:"ID of element that labels the icon",type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},isDisabled:{description:"Sets icon interactions as disabled",type:"boolean"},isFocused:{description:"Shows icon backdrop when focused",type:"boolean"},showCursor:{description:"Shows pointer cursor and hover background",type:"boolean"},size:{anyOf:[{type:"number"},{type:"string"}],description:"Icon size in pixels or CSS units"},tip:{description:"Tooltip content shown on icon hover",type:"string"},type:{description:'Icon type name (e.g. "INFO_CIRCLE_OUTLINE")',type:"string"}},required:["type"],type:"object"}],description:"Icon displayed alongside the country. Accepts a string icon name or an object with type, alignment, tip, color, size, state, and ARIA props."},onlyFlag:{description:"When true, shows only the flag without rendering the country name. Default: false",type:"boolean"},shouldShowFlag:{description:"When false, hides the country flag and shows only the country name. Default: true",type:"boolean"},shouldShowTipOnOverflow:{description:"When false, disables the tooltip that appears when the country name overflows. Default: true",type:"boolean"},size:{description:"Size of the country flag. SMALL, MEDIUM, or LARGE. Default: LARGE",enum:["SMALL","MEDIUM","LARGE"],type:"string"}},required:["countryCode"],type:"object"},acceptsChildren:!1},Currency:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},allowNegative:{description:"Whether negative values are allowed. Default: true",type:"boolean"},"aria-describedby":{description:"ID of element that provides additional description",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},autoComplete:{description:"HTML autocomplete attribute value for browser autofill",type:"string"},autoFocus:{description:"If true, input will be focused on mount",type:"boolean"},canSelectCurrencyType:{description:"If true, displays a dropdown to select currency type",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},currencyTypeProps:{additionalProperties:!1,description:"Nested Select props for the currency selector",properties:{name:{description:"Unique identifier for the currency selector",type:"string"},"aria-describedby":{description:"ID of element that describes the currency selector",type:"string"},"aria-label":{description:"Accessible label for the currency selector",type:"string"},"aria-labelledby":{description:"ID of element that labels the currency selector",type:"string"},canClear:{description:"Show clear button to deselect",type:"boolean"},defaultSearchQuery:{description:"Initial search input value",type:"string"},defaultValue:{description:"Initial selected currency code"},dropdownHeight:{description:"Dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query entered",type:"string"},onNoSearchResults:{description:"Placeholder when search returns no results",type:"string"}},type:"object"}],description:"Placeholder when dropdown list is empty"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options",propertyNames:{type:"string"},type:"object"},isDisabled:{description:"Disables the currency selector",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu opens by default",type:"boolean"},isPositionFixed:{description:"Position dropdown relative to viewport",type:"boolean"},isReadOnly:{description:"Makes the currency selector read-only",type:"boolean"},isRequired:{description:"Marks the currency selector as required",type:"boolean"},isSearchable:{description:"Enable type-to-search filtering",type:"boolean"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Dropdown max height"},placeholder:{description:"Placeholder text when empty",type:"string"},scrollThreshold:{description:"Extra virtual scroll render threshold",type:"number"},shouldFocusFirstElement:{description:"Auto-focus first menu item",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix",type:"boolean"},shouldUsePortal:{description:"Render dropdown in a React Portal",type:"boolean"},size:{description:"Select input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},value:{description:"Currently selected currency code"}},type:"object"},decimalPlaces:{description:"Number of decimal places allowed. Default: 2",type:"number"},defaultValue:{anyOf:[{type:"string"},{type:"number"},{additionalProperties:!1,properties:{type:{description:"Currency code paired with the amount, e.g. USD or EUR",type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Currency amount value"}},required:["value","type"],type:"object"}],description:"Initial value for uncontrolled component. Use { value, type } with shouldSendCurrencyType"},isDisabled:{description:"Disables the input",type:"boolean"},isIntegerOnly:{description:"If true, only integer values will be allowed. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for number formatting (e.g. en-US). Overrides shouldLocalize when set.",type:"string"},max:{description:"Maximum allowed value",type:"number"},maxLength:{description:"Maximum number of characters allowed",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},min:{description:"Minimum allowed value",type:"number"},minLength:{description:"Minimum number of characters required",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Currency symbol or code shown as prefix. Default: USD",type:"string"},shouldAllowCalculation:{description:"If true, input allows arithmetic operators and evaluates equation on blur",type:"boolean"},shouldDisableRedundantZeroFormatting:{description:"If false, redundant zeros are removed using parseFloat. If true (default), zeros are preserved. Default: true",type:"boolean"},shouldLocalize:{description:"If true, currency format is determined from user locale setting. Default: true",type:"boolean"},shouldSendCurrencyType:{description:"If true, onChange writes { value, type } using currencyTypeProps value/defaultValue",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},step:{description:"Value to add/subtract on pressing arrow up/down respectively. Default: 1",type:"number"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"},{additionalProperties:!1,properties:{type:{description:"Currency code paired with the amount, e.g. USD or EUR",type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Currency amount value"}},required:["value","type"],type:"object"}],description:"Current currency value bound to state. Use { value, type } with shouldSendCurrencyType"}},type:"object"},acceptsChildren:!1},Dashboard:{description:"Embeds a saved Rippling Analytics dashboard by id. Loading, permissions, missing-dashboard, and widget behavior are handled by the dashboard viewer.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{dashboardId:{description:"Id of a saved Rippling Analytics dashboard. The dashboard loads its own data and handles loading, access, missing, and widget behavior.",type:"string"}},required:["dashboardId"],type:"object"},acceptsChildren:!1},Date:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},alwaysShowTimezone:{description:"If true, timezone abbreviation will always be shown when shouldShowTime is true. Default: false",type:"boolean"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},canClear:{description:"Show clear button",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{type:"string"},{type:"null"}],description:"Initial ISO date string or null for uncontrolled usage"},divider:{description:'Separator between date units (e.g. "/" or "-")',type:"string"},format:{description:"Date display format. Default: MM/dd/yyyy",enum:["yyyy/MM/dd","yyyy-MM-dd","MM/dd/yyyy","dd/MM/yyyy","yyyy/MM/dd hh:mm a","yyyy-MM-dd hh:mm a","MM/dd/yyyy hh:mm a","dd/MM/yyyy hh:mm a","yyyy/MM/dd hh:mm:ss a","yyyy-MM-dd hh:mm:ss a","MM/dd/yyyy hh:mm:ss a","dd/MM/yyyy hh:mm:ss a","ISO_STRING"],type:"string"},hideStepper:{description:"If true, arrow navigation key to increment/decrement date will be hidden. Default: false",type:"boolean"},id:{description:"HTML id attribute for the input",type:"string"},isCalendarDefaultOpen:{description:"If true, calendar will be open by default on mount",type:"boolean"},isDisabled:{description:"Disables the date picker",type:"boolean"},isLarge:{description:"Renders large calendar when true. Default: false",type:"boolean"},isPickerVisible:{description:"If false, hides the calendar picker. Default: true",type:"boolean"},isReadOnly:{description:"Makes the date picker read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the date picker",type:"string"},locale:{description:"Locale for date formatting. Default: en-US",type:"string"},maxDate:{description:"Latest selectable date as ISO string",type:"string"},minDate:{description:"Earliest selectable date as ISO string",type:"string"},shouldDisplaySeconds:{description:"Display seconds in the time input when shouldShowTime is true",type:"boolean"},shouldFormatInTimezone:{description:"If true, values will transform according to global timezone. Defaults to true when shouldShowTime is true",type:"boolean"},shouldLocalize:{description:"If true, display format will be determined from user locale setting. Default: false for explicit format control",type:"boolean"},shouldShowTime:{description:"Include time selection",type:"boolean"},shouldShowTimezoneLabel:{description:"If false, timezone label will not be shown. Default: true",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Visual theme variant. NO_BOX removes input box styling",enum:["NO_BOX"],type:"string"},timeProps:{additionalProperties:!1,description:"Configuration for time picker. Sets initial time value independently of date input",properties:{defaultValue:{description:"Default time as ISO string when no date is selected",type:"string"}},required:["defaultValue"],type:"object"},timezone:{description:'Timezone name (e.g. "America/New_York"). Used with shouldShowTime',type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"null"}],description:"ISO date string or null bound to state"}},type:"object"},acceptsChildren:!1},DateInlineMulti:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial array of selected ISO 8601 date strings",items:{type:"string"},type:"array"},format:{description:"Date display format. Default: yyyy-MM-dd",enum:["yyyy/MM/dd","yyyy-MM-dd","MM/dd/yyyy","dd/MM/yyyy","yyyy/MM/dd hh:mm a","yyyy-MM-dd hh:mm a","MM/dd/yyyy hh:mm a","dd/MM/yyyy hh:mm a","yyyy/MM/dd hh:mm:ss a","yyyy-MM-dd hh:mm:ss a","MM/dd/yyyy hh:mm:ss a","dd/MM/yyyy hh:mm:ss a","ISO_STRING"],type:"string"},isDisabled:{description:"Disables the calendar",type:"boolean"},isReadOnly:{description:"Makes the calendar read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the calendar",type:"string"},locale:{description:"Locale for date formatting",type:"string"},maxDate:{description:"Latest selectable date as ISO string",type:"string"},minDate:{description:"Earliest selectable date as ISO string",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{items:{type:"string"},type:"array"},{type:"null"}],description:"Array of selected ISO 8601 date strings or null bound to state"}},type:"object"},acceptsChildren:!1},DateRange:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},alwaysShowTimezone:{description:"If true, timezone abbreviation will always be shown when shouldShowTime is true. Default: false",type:"boolean"},"aria-describedby":{description:"ID of element that describes the date range picker",type:"string"},"aria-label":{description:"Accessibility label for the date range picker",type:"string"},"aria-labelledby":{description:"ID of element that labels the date range picker",type:"string"},canClear:{description:"Show clear button",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{items:{anyOf:[{type:"string"},{type:"null"}]},type:"array"},{type:"null"}],description:"Initial null or array of ISO date strings/null entries [start, end]"},divider:{description:'Separator between date units (e.g. "/" or "-")',type:"string"},endDateLabel:{description:"Label for the end date field",type:"string"},format:{description:"Date display format. Default: MM/dd/yyyy",enum:["yyyy/MM/dd","yyyy-MM-dd","MM/dd/yyyy","dd/MM/yyyy","yyyy/MM/dd hh:mm a","yyyy-MM-dd hh:mm a","MM/dd/yyyy hh:mm a","dd/MM/yyyy hh:mm a","yyyy/MM/dd hh:mm:ss a","yyyy-MM-dd hh:mm:ss a","MM/dd/yyyy hh:mm:ss a","dd/MM/yyyy hh:mm:ss a","ISO_STRING"],type:"string"},hideStepper:{description:"If true, arrow navigation key to increment/decrement date will be hidden. Default: false",type:"boolean"},id:{description:"HTML id attribute for the date range input",type:"string"},isCalendarDefaultOpen:{description:"If true, calendar will be open by default on mount",type:"boolean"},isDisabled:{description:"Disables the date range picker",type:"boolean"},isLarge:{description:"Renders large calendar when true. Default: false",type:"boolean"},isReadOnly:{description:"Makes the date range picker read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the date range picker",type:"string"},locale:{description:"Locale for date formatting",type:"string"},maxDate:{description:"Latest selectable date as ISO string",type:"string"},minDate:{description:"Earliest selectable date as ISO string",type:"string"},shouldDisplaySeconds:{description:"Display seconds in the time input when shouldShowTime is true",type:"boolean"},shouldFormatInTimezone:{description:"If true, values will transform according to global timezone. Defaults to true when shouldShowTime is true",type:"boolean"},shouldLocalize:{description:"If true, display format is determined from user locale. Default: true",type:"boolean"},shouldShowTime:{description:"Include time selection",type:"boolean"},shouldShowTimezoneLabel:{description:"If false, timezone label will not be shown. Default: true",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},startDateLabel:{description:"Label for the start date field",type:"string"},theme:{description:"Visual theme variant. NO_BOX removes input box styling",enum:["NO_BOX"],type:"string"},timezone:{description:"Timezone for date/time display and storage. Used with shouldShowTime",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{items:{anyOf:[{type:"string"},{type:"null"}]},type:"array"},{type:"null"}],description:"Null or array of ISO date strings/null entries [start, end] bound to state"}},type:"object"},acceptsChildren:!1},DaySelector:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{enum:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],type:"string"},{items:{enum:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],type:"string"},type:"array"}],description:"Initial day(s) when uncontrolled"},isMulti:{description:"Allow multiple day selection. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},renderProps:{additionalProperties:{additionalProperties:!1,properties:{isDisabled:{type:"boolean"},tip:{additionalProperties:!1,properties:{content:{type:"string"}},required:["content"],type:"object"}},type:"object"},description:"Per-day configuration. Keys are day names (Sunday, Monday, etc.). Each can have isDisabled (boolean) and tip (object with content string)",propertyNames:{type:"string"},type:"object"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{enum:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],type:"string"},{items:{enum:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],type:"string"},type:"array"}],description:"Selected day(s). Single string when isMulti is false, array when true"}},type:"object"},acceptsChildren:!1},DistributionBar:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{segments:{description:"Array of segments with value and color",items:{additionalProperties:!1,properties:{segmentColor:{anyOf:[{enum:["chartColorSeries1Chart1","chartColorSeries1Chart2","chartColorSeries1Chart3","chartColorSeries1Chart4","chartColorSeries1Chart5","chartColorSeries2Chart1","chartColorSeries2Chart2","chartColorSeries2Chart3","chartColorSeries2Chart4","chartColorSeries2Chart5","chartColorSeries3Chart1","chartColorSeries3Chart2","chartColorSeries3Chart3","chartColorSeries3Chart4","chartColorSeries3Chart5","chartColorSeries4Chart1","chartColorSeries4Chart2","chartColorSeries4Chart3","chartColorSeries4Chart4","chartColorSeries4Chart5","chartColorSeries5Chart1","chartColorSeries5Chart2","chartColorSeries5Chart3","chartColorSeries5Chart4","chartColorSeries5Chart5","chartColorSeries6Chart1","chartColorSeries6Chart2","chartColorSeries6Chart3","chartColorSeries6Chart4","chartColorSeries6Chart5"],type:"string"},{enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh","colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorOnSuccess","colorOnSuccessContainer","colorOnInfo","colorOnInfoContainer","colorOnWarning","colorOnWarningContainer","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorOutline","colorOutlineVariant","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse"],type:"string"}],description:"Pebble chart color token, or semantic color token for status-related visualizations."},value:{description:"Numeric value of this segment",type:"number"}},required:["value","segmentColor"],type:"object"},type:"array"},size:{description:"Bar thickness variant. Default: standard",enum:["standard","compact"],type:"string"},totalValue:{description:"Total value the bar represents. If omitted, computed as sum of segment values. Segments exceeding totalValue trigger an error.",type:"number"}},required:["segments"],type:"object"},acceptsChildren:!1},Divider:{description:"Horizontal line to visually separate content sections",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{spacing:{description:"Vertical margin spacing token above and below the divider",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},text:{description:"Optional text displayed in the center of the divider line",type:"string"},theme:{description:"Line styles",enum:["SOLID","DASHED"],type:"string"}},type:"object"},acceptsChildren:!1},DraggableList:{description:"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.",events:["update","remove","dragStart","dragEnd"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{dragContainerMinHeight:{description:"Minimum height of drag container in pixels. Default: 0",type:"number"},groupName:{description:'List group identifier for dragging among multiple lists. Default: "group"',type:"string"},isDragDisabled:{description:"Disable drag functionality. Default: false",type:"boolean"},isHorizontal:{description:"Display the list horizontally. Default: false",type:"boolean"},isRemovable:{description:"Allow elements of the list to be removed. Default: false",type:"boolean"},labelKey:{description:"Key name in each item used to generate chip label",type:"string"},limitDragToDragIcon:{description:"Restrict dragging to only the drag icon. Only works when showDragIcon is true. Default: false",type:"boolean"},list:{description:"Array of draggable items. Each item must have an id (string or number). Additional keys are allowed.",items:{additionalProperties:{},properties:{id:{anyOf:[{type:"string"},{type:"number"}],description:"Unique identifier for the item"},label:{description:"Display label for the item",type:"string"}},required:["id"],type:"object"},type:"array"},showDragIcon:{description:"Show drag icon for each item. Default: false",type:"boolean"},tip:{additionalProperties:!1,description:"Tooltip configuration for the default chip renderer",properties:{appearance:{description:"Tooltip appearance. Default: DARK",enum:["LIGHT","DARK"],type:"string"},contentKey:{description:"List item key used as tooltip content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when document scrolls",type:"boolean"},isDelayed:{description:"Add delay before showing tooltip",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices",type:"boolean"},isPositionFixed:{description:"Use fixed positioning relative to viewport",type:"boolean"},isVisible:{description:"Control tooltip visibility",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum tooltip height"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum tooltip width"},onlyIfChildOverflow:{description:"Only show tooltip if any child content overflows",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if content overflows",type:"boolean"},overwriteMiddleware:{description:"Overwrite default floating-UI middleware",type:"boolean"},padding:{description:"CSS padding value for tooltip content",type:"string"},placement:{description:"Tooltip placement",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"},shallSkipOverflowY:{description:"Skip overflow check on Y axis",type:"boolean"},tipHideDelay:{description:"Milliseconds to wait before hiding delayed tooltip",type:"number"},tipShowDelay:{description:"Milliseconds to wait before showing delayed tooltip",type:"number"},title:{description:"Static tooltip title",type:"string"},titleKey:{description:"List item key used as tooltip title",type:"string"},truncateClassName:{description:"CSS class when overflow-only tooltip is enabled",type:"string"}},type:"object"},width:{description:"Width of the list. Default: 100%",type:"string"}},required:["list","labelKey"],type:"object"},acceptsChildren:!1},Drawer:{description:"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.",events:["close"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{caption:{description:"Subtext below the title in the drawer header",type:"string"},isCompact:{description:"Renders drawer in compact view",type:"boolean"},isVisible:{description:"Whether the drawer is visible. Bind to state to control open/close",type:"boolean"},maxWidth:{anyOf:[{type:"string"},{type:"number"}],description:"Maximum width of the drawer. Default: 80vw"},shouldAttachToRoot:{description:"Renders drawer in a portal at document root. Default: true",type:"boolean"},shouldCloseOnBackdropClick:{description:"Close drawer when clicking the backdrop. Default: true",type:"boolean"},shouldCloseOnEscape:{description:"Close drawer on ESC key press",type:"boolean"},shouldNotAnimate:{description:"Disables open/close animations. Default: false",type:"boolean"},theme:{description:"Visual style theme for the drawer",enum:["BACKGROUND_V2_GRAY","GRAY","NO_PADDING"],type:"string"},title:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{kind:{const:"BREADCRUMB",description:"Render the drawer title as a Breadcrumb",type:"string"},props:{additionalProperties:!1,description:"Breadcrumb props for the drawer title",properties:{active:{description:"Value of the active breadcrumb item",type:"string"},"aria-describedby":{description:"ID of element that describes the breadcrumb nav",type:"string"},"aria-label":{description:"Accessible label for the breadcrumb nav",type:"string"},"aria-labelledby":{description:"ID of element that labels the breadcrumb nav",type:"string"},items:{description:"Breadcrumb items shown in the drawer header",items:{additionalProperties:!1,properties:{href:{description:"URL to navigate to when clicked",type:"string"},isDisabled:{description:"Disables the breadcrumb item",type:"boolean"},title:{description:"Display label for the breadcrumb item",type:"string"},value:{description:"Unique value identifier for the item",type:"string"}},required:["title","value"],type:"object"},type:"array"},noMargin:{description:"Remove default breadcrumb margin",type:"boolean"},shouldCollapseMiddle:{description:"Collapse middle breadcrumb items",type:"boolean"}},required:["items"],type:"object"}},required:["kind","props"],type:"object"}],description:"Title displayed in the drawer header as text or breadcrumb config"},width:{anyOf:[{type:"string"},{type:"number"}],description:"Width of the drawer. Default: 80vw"}},type:"object"},acceptsChildren:!0},Dropdown:{description:"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.",events:["change","toggle","action"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{clickedValue:{description:"Bindable last clicked item value, written before the action event emits"},defaultValue:{description:"Initially selected value"},dropdownIsOpen:{description:"Bindable state written when the dropdown opens or closes",type:"boolean"},footer:{additionalProperties:{},description:"Footer item rendered at the bottom of the list",properties:{disabledInfo:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{type:"string"}},required:["content"],type:"object"}],description:"Tooltip content shown when the option is disabled"},isDisabled:{description:"Disables this option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon name to show next to the label",type:"string"},leftIconType:{description:"Icon name to show on the left side of the item",type:"string"},quaternaryLabel:{description:"Quaternary text below the tertiary label",type:"string"},secondaryLabel:{description:"Secondary text below the main label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text",type:"string"}},required:["text"],type:"object"}],description:"Tag shown beside the option text"},tertiaryLabel:{description:"Tertiary text below the secondary label",type:"string"},type:{description:"Visual style type for the option (WARNING or ALERT)",enum:["WARNING","ALERT"],type:"string"},value:{description:"Value for the option"}},type:"object"},isCompact:{description:"Render in compact mode",type:"boolean"},isDisabled:{description:"Disable the dropdown trigger",type:"boolean"},list:{description:"Array of dropdown options: {label, value, isDisabled?}",items:{anyOf:[{additionalProperties:{},properties:{disabledInfo:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{type:"string"}},required:["content"],type:"object"}],description:"Tooltip content shown when the option is disabled"},isDisabled:{description:"Disables this option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon name to show next to the label",type:"string"},leftIconType:{description:"Icon name to show on the left side of the item",type:"string"},quaternaryLabel:{description:"Quaternary text below the tertiary label",type:"string"},secondaryLabel:{description:"Secondary text below the main label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text",type:"string"}},required:["text"],type:"object"}],description:"Tag shown beside the option text"},tertiaryLabel:{description:"Tertiary text below the secondary label",type:"string"},type:{description:"Visual style type for the option (WARNING or ALERT)",enum:["WARNING","ALERT"],type:"string"},value:{description:"Value for the option"}},type:"object"},{additionalProperties:{},properties:{isDisabled:{description:"Disables this option",type:"boolean"},isNestedMenu:{description:"Marks this item as a nested menu",type:"boolean"},label:{description:"Display text for the nested menu item",type:"string"},labelIcon:{description:"Icon name to show next to the label",type:"string"},leftIconType:{description:"Icon name to show on the left side of the item",type:"string"},list:{description:"Nested flat list items",items:{additionalProperties:{},properties:{disabledInfo:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{type:"string"}},required:["content"],type:"object"}],description:"Tooltip content shown when the option is disabled"},isDisabled:{description:"Disables this option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon name to show next to the label",type:"string"},leftIconType:{description:"Icon name to show on the left side of the item",type:"string"},quaternaryLabel:{description:"Quaternary text below the tertiary label",type:"string"},secondaryLabel:{description:"Secondary text below the main label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text",type:"string"}},required:["text"],type:"object"}],description:"Tag shown beside the option text"},tertiaryLabel:{description:"Tertiary text below the secondary label",type:"string"},type:{description:"Visual style type for the option (WARNING or ALERT)",enum:["WARNING","ALERT"],type:"string"},value:{description:"Value for the option"}},type:"object"},type:"array"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text",type:"string"}},required:["text"],type:"object"}],description:"Tag shown beside the option text"},value:{description:"Value for the nested option"}},required:["label","list"],type:"object"},{additionalProperties:!1,properties:{isSeparator:{const:!0,description:"Render a visual separator",type:"boolean"}},required:["isSeparator"],type:"object"}]},type:"array"},maxHeight:{description:"Max height of the dropdown list in px. Default: 224",type:"number"},placement:{description:"Popover position. Default: bottom-start",enum:["bottom-start","bottom","bottom-end","top-start","top","top-end","left-start","left","left-end","right-start","right","right-end"],type:"string"},searchable:{description:"Enable search within the dropdown list",type:"boolean"},shouldAutoClose:{description:"Auto-close after item selection",type:"boolean"},shouldCloseOnScroll:{description:"Close on document scroll",type:"boolean"},showSelectedLabel:{description:"Display the selected option label in the trigger. Defaults to false; empty or unmatched values use triggerLabel",type:"boolean"},triggerAriaLabel:{description:"Accessible label for the trigger button. Recommended for icon-only triggers.",type:"string"},triggerIcon:{description:"Icon.TYPES name to render in the dropdown trigger button. Provide it for icon-only or icon-plus-label triggers.",type:"string"},triggerLabel:{description:"Visible label for the dropdown trigger button. Omit it for an icon-only trigger.",type:"string"},triggerSize:{description:"Size of the trigger button (XS, S, M, L). Default: M",enum:["XS","S","M","L"],type:"string"},value:{description:"Currently selected value. Bind to state for selection tracking"},width:{description:"Width of the dropdown list in px. Default: 192",type:"number"}},required:["list"],type:"object"},acceptsChildren:!1},Email:{description:"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.",events:["change","blur","focus","click","keydown","keyup","paste","mouseenter","mouseleave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},shouldAllowAutoFill:{description:"Allow browser autofill",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},shouldStopEventPropagation:{description:"Stop automatic input focus when clicking container",type:"boolean"},shrinkToPlaceholder:{description:"Input spans as much as its placeholder when true. Only applies when placeholder is visible",type:"boolean"},shrinkToValue:{description:"Input spans as much as its value when true. Only applies when value is present",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},theme:{description:"Theme name from Input.Text.THEMES or custom theme",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"null"}],description:"Current email value bound to state"}},type:"object"},acceptsChildren:!1},EmojiPicker:{description:"An emoji picker that lets users browse and select emojis by category or search. Can be rendered inline or in a popover. onChange emits the selected emoji data including native representation, name, and keywords.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{autoFocus:{description:"If true, automatically focuses the search input. Default: false",type:"boolean"},categories:{description:"Array of emoji categories to display",items:{enum:["frequent","people","nature","foods","activity","places","objects","symbols","flags"],type:"string"},type:"array"},excludeIds:{description:"Emoji IDs to hide from the picker",items:{type:"string"},type:"array"},fluid:{description:"If true, makes width 100% of container. Default: false",type:"boolean"},height:{description:"Height CSS value of the emoji picker",type:"string"},inline:{description:"If true, renders the emoji picker inline. Default: false",type:"boolean"},minHeight:{description:"Minimum height CSS value of the emoji picker",type:"string"},minWidth:{description:"Minimum width CSS value of the emoji picker",type:"string"},popperProps:{additionalProperties:!1,description:"Serializable popover options; middleware functions are not supported",properties:{placement:{description:"Popover placement",enum:["top-start","top","top-end","right-start","right","right-end","bottom-end","bottom","bottom-start","left-end","left","left-start"],type:"string"},shouldFlipIfNoSpace:{description:"Whether the popover flips when there is not enough space",type:"boolean"}},type:"object"},preventCloseOnSelect:{description:"Prevents the popover from closing when an emoji is selected",type:"boolean"},selectedEmoji:{additionalProperties:!1,description:"Bindable selected emoji data written before the change event emits",properties:{name:{description:"Descriptive emoji name",type:"string"},id:{description:"Unique identifier for the emoji",type:"string"},keywords:{description:"Search keywords for the emoji",items:{type:"string"},type:"array"},native:{description:"Native emoji character",type:"string"},shortcodes:{description:"Short-form emoji representation",type:"string"},unified:{description:"Unicode representation for the emoji",type:"string"}},required:["id","name","native","shortcodes","keywords","unified"],type:"object"},triggerIcon:{description:"Icon.TYPES name to render as the default popover trigger",type:"string"},width:{description:"Width CSS value of the emoji picker",type:"string"}},type:"object"},acceptsChildren:!1},EmployeeSearch:{description:"Search for and select one or more employees outside of a registered form. Supports ACTIVE; GOOD (HIRED, ACCEPTED, and ACTIVE); ACCEPTED_AND_ACTIVE (excluding HIRED); NON_INIT (all employee states except INIT, including TERMINATED); INIT (hiring started but not completed; the backend preset is roleState INIT and is not employee-constrained); and TERMINATED. The change event is notification-only and has no payload.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{canClear:{description:"Controls whether the current selection can be cleared. When omitted, the underlying select default applies.",type:"boolean"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Initial uncontrolled selection as an employee role id for single select or role id array for multi-select. Defaults to no selection."},isDisabled:{description:"When true, disables searching and selection changes. Defaults to false.",type:"boolean"},isMulti:{description:"When true, allows multiple employee selections and uses role id arrays. Defaults to false (single select).",type:"boolean"},isReadOnly:{description:"When true, displays the selection without allowing changes. Defaults to false.",type:"boolean"},isRequired:{description:"When true, marks the field as required. Defaults to the form control default (not required).",type:"boolean"},label:{description:"Label displayed for the search field. Defaults to no label.",type:"string"},placeholder:{description:"Placeholder displayed when the search field is empty. When omitted, the component default placeholder is used.",type:"string"},roleIdsToExclude:{description:"Removes the specified employee role ids from search results when no inclusion list is provided. When both lists are provided, inclusion takes precedence. When omitted, no role ids are explicitly excluded.",items:{type:"string"},type:"array"},roleIdsToInclude:{description:"Limits search results to the specified employee role ids. When both inclusion and exclusion lists are provided, inclusion takes precedence. When omitted, results are not restricted by an inclusion list.",items:{type:"string"},type:"array"},roleTypes:{description:"Limits search results using backend role-type presets. ACTIVE selects active employees. GOOD selects HIRED, ACCEPTED, and ACTIVE employees. ACCEPTED_AND_ACTIVE selects ACCEPTED and ACTIVE employees and excludes HIRED. NON_INIT selects all employee states except INIT, including TERMINATED. INIT selects the backend roleState INIT preset (hiring started but not completed) and is not additionally constrained to employees. TERMINATED selects terminated employees. Requires at least one value; defaults to GOOD.",items:{enum:["ACTIVE","GOOD","ACCEPTED_AND_ACTIVE","NON_INIT","INIT","TERMINATED"],type:"string"},minItems:1,type:"array"},tip:{description:"Supplementary tip displayed with the label. Defaults to no tip.",type:"string"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Controlled selection as an employee role id for single select or role id array for multi-select. When omitted, the component is uncontrolled. When value and defaultValue are both provided, value takes precedence."}},type:"object"},acceptsChildren:!1},ExpansionPanel:{description:"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.",events:["toggle"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{depth:{description:"Nesting depth for tree views",type:"number"},horizontalCollapsedArrow:{description:"Arrow points right when collapsed instead of down",type:"boolean"},indent:{description:"Indentation amount in px",type:"number"},isDefaultOpen:{description:"Start expanded. Default: false",type:"boolean"},isDisabled:{description:"Disable the panel. Default: false",type:"boolean"},isOpen:{description:"Controlled expansion state. Bind to state for control",type:"boolean"},isOutlined:{description:"Show border. Default: true",type:"boolean"},shouldNotAnimate:{description:"Disable CSS animation. Default: false",type:"boolean"},shouldNotUnmountChild:{description:"Keep child mounted when collapsed. Default: false",type:"boolean"},theme:{description:"Visual style variant",enum:["COMPACT","NO_PADDING","REVERSED","UNDERLINED","LIST","NO_TOGGLE","NESTEDTAB_PADDING","HOVERBALE","TRANSPARENT","NESTEDTAB_PADDING_TRANSPARENT","NO_PADDING_TRANSPARENT","NO_PADDING_UNDERLINED","NO_PADDING_REVERSED","REVERSED_TRANSPARENT_LIST","REVERSED_UNDERLINED_LIST","REVERSED_TRANSPARENT_LIST_NO_TOGGLE","REVERSED_UNDERLINED_LIST_NO_TOGGLE","LIST_NO_TOGGLE_REVERSED","NO_TOGGLE_TRANSPARENT","SURFACE_BACKGROUND"],type:"string"},title:{description:"Header text displayed in the expansion panel",type:"string"},toggleIcon:{additionalProperties:!1,description:"Toggle icon layout options",properties:{align:{description:"CSS align-self value for the toggle icon",type:"string"},margin:{description:"CSS margin around the toggle icon container",type:"string"},size:{anyOf:[{type:"number"},{type:"string"}],description:"Toggle icon size. Default: 24px"}},type:"object"}},required:["title"],type:"object"},acceptsChildren:!0},ExpansionPanelGroup:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{isSingleOpen:{description:"Only allow one panel open at a time. Default: false",type:"boolean"}},type:"object"},acceptsChildren:!0},Field:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{helperMessage:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{message:{description:"Helper or error message text",type:"string"},status:{description:'Message status, e.g. "ERROR" for validation errors',type:"string"}},required:["message"],type:"object"}],description:"Helper text below the field, or object with message and status"},isHiddenInput:{description:"Hides the input portion of the field",type:"boolean"},isInline:{description:"Renders label and input on the same line",type:"boolean"},isReadOnly:{description:"Renders the field in read-only mode",type:"boolean"},isRequired:{description:"Shows required asterisk next to the label",type:"boolean"},label:{description:"Label text displayed above the field",type:"string"},theme:{description:"Predefined style theme for margin/padding adjustments",enum:["NO_MARGIN","NO_PADDING","NO_PADDING_NO_MARGIN"],type:"string"},tip:{description:"Tooltip text shown next to the label via an info icon",type:"string"}},type:"object"},acceptsChildren:!0},File:{description:"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.",events:["change","delete","chipClick"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the file input",type:"string"},allowCameraCapture:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{quality:{description:"Captured image quality",type:"number"}},type:"object"}],description:"Allow camera capture for image files; object form supports quality"},clickedFile:{additionalProperties:!1,description:"Bindable clicked file metadata written before chipClick emits",properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},isMultipart:{description:"Whether this is a multipart upload",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},size:{description:"File size in bytes",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},cropperConfig:{additionalProperties:!1,description:"Image cropper configuration",properties:{aspectRatio:{description:"Aspect ratio for cropper",enum:["16:9","4:3","1:1"],type:"string"},enforceAspectRatio:{description:"Enforce cropper aspect ratio",type:"boolean"},showUploadButton:{description:"Show upload button on cropper",type:"boolean"},title:{description:"Title for the cropper modal",type:"string"}},type:"object"},defaultValue:{description:"Default files to show when no value is provided",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},isMultipart:{description:"Whether this is a multipart upload",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},size:{description:"File size in bytes",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"},icon:{description:"Icon name from Icon.TYPES to show above placeholder",type:"string"},isDisabled:{description:"Disables the file input",type:"boolean"},isInvalid:{description:"Shows error styling on the input",type:"boolean"},isReadOnly:{description:"Makes the file input read-only (download only)",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},maxFileSize:{description:"Max file size in MB per file. Default: 2048",type:"number"},maxTotalFileSize:{description:"Max total file size in MB for all files",type:"number"},multiple:{description:"Allow multiple file uploads. Default: false",type:"boolean"},placeholder:{description:"Label shown when no files are selected",type:"string"},showProgress:{description:"Show upload progress bar. Default: false",type:"boolean"},supportTypes:{description:'Array of supported file extensions, e.g. [".pdf", ".doc"]',items:{type:"string"},type:"array"},type:{description:"File input display type. Default: DEFAULT",enum:["DEFAULT","RECEIPT"],type:"string"},value:{description:"Array of file objects bound to state",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},isMultipart:{description:"Whether this is a multipart upload",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},size:{description:"File size in bytes",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"}},type:"object"},acceptsChildren:!1},FileDrop:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the file input",type:"string"},allowCameraCapture:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{quality:{description:"Captured image quality",type:"number"}},type:"object"}],description:"Allow camera capture for image files; object form supports quality"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},cropperConfig:{additionalProperties:!1,description:"Cropper configuration",properties:{aspectRatio:{description:"Aspect ratio for cropper. Default: 1:1",enum:["16:9","4:3","1:1"],type:"string"},enforceAspectRatio:{description:"Enforce the aspect ratio on cropper. Default: true",type:"boolean"},showUploadButton:{description:"Show upload button on cropper. Default: true",type:"boolean"},title:{description:"Title for the cropper modal",type:"string"}},type:"object"},defaultValue:{description:"Default files to show when no value is provided",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"},enableCropper:{description:"Enable image cropping for selected images",type:"boolean"},icon:{description:"Icon name from Icon.TYPES to show above placeholder",type:"string"},id:{description:"HTML id attribute for the file input",type:"string"},isDisabled:{description:"Disables the file input",type:"boolean"},isReadOnly:{description:"Makes the file input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the file drop area",type:"string"},maxFileSize:{description:"Max file size in MB per attachment",type:"number"},maxTotalFileSize:{description:"Max total size in MB for all attachments",type:"number"},metadata:{description:"JSON-serializable metadata sent with upload requests"},module:{description:"Deprecated upload bucket hint; prefer metadata.module when possible",type:"string"},multiPartUpload:{description:"Enables multipart upload flow for files larger than 100MB",type:"boolean"},multiple:{description:"Allow selecting multiple files",type:"boolean"},placeholder:{description:"Text shown when no files are selected",type:"string"},supportTypes:{description:'Supported file extensions with dot prefix, e.g. [".pdf", ".png", ".jpg"]. Do NOT use MIME types.',items:{type:"string"},type:"array"},type:{description:"Type of file drop: upload (shows progress bars automatically) or content. Default: content",enum:["upload","content"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Array of file objects bound to state",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"}},type:"object"},acceptsChildren:!1},FloatingButton:{description:"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.",events:["press","pressWhileDisabled","mouseEnter","mouseLeave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{"aria-controls":{description:"ID of element controlled by the button",type:"string"},"aria-describedby":{description:"ID of element that describes the button",type:"string"},"aria-expanded":{description:"Indicates expanded state (for toggles)",type:"boolean"},"aria-haspopup":{anyOf:[{type:"boolean"},{type:"string"}],description:"Indicates the button opens a popup/menu"},"aria-label":{description:"Accessible label for the button. Required if aria-labelledby is not provided.",type:"string"},"aria-labelledby":{description:"ID of element that labels the button. Required if aria-label is not provided.",type:"string"},"aria-pressed":{anyOf:[{type:"boolean"},{const:"mixed",type:"string"}],description:"Indicates pressed state (for toggle buttons)"},icon:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type from Icon.TYPES",type:"string"}},required:["type"],type:"object"}],description:"Icon to display. Can be icon name string or object with type and color"},id:{description:"DOM id selector for the button element",type:"string"},inverseDisabledColors:{description:"Uses inverse color tokens for disabled state. Useful for dark backgrounds. Default: false",type:"boolean"},isDisabled:{description:"If true, button is disabled. Default: false",type:"boolean"},shouldPreventFocus:{description:"If true, the button will not be focusable (tabIndex -1). Default: false",type:"boolean"},shouldShowSpinner:{description:"If true, shows loading spinner instead of icon",type:"boolean"},size:{description:"Size of the button (XS, S, M, L). Default: M",enum:["XS","S","M","L"],type:"string"},tabIndex:{description:"Tab order for keyboard navigation",type:"number"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Control tooltip visibility from parent",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max height (number in px or CSS string)"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max width (number in px or CSS string)"},placement:{description:"Tooltip placement relative to button. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip text or tooltip configuration object"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{description:"Open link in new tab. Default: false",type:"boolean"},path:{description:"URL path for navigation",type:"string"}},required:["path"],type:"object"}],description:"Navigation destination. When provided, button renders as anchor and handles navigation automatically"},type:{description:"HTML button type attribute (button, submit, reset). Default: button",enum:["button","submit","reset"],type:"string"}},required:["icon"],type:"object"},acceptsChildren:!1},Form:{description:"A form container that groups inputs together with shared submit/cancel/validation behavior. Use to collect a set of related field values and submit them as one unit. Supports a settings mode with edit/readonly toggling.",events:["change","submit","valid","invalid","cancel","edit","skip"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{bottomPadding:{description:"Adds bottom padding to the form. Default: true",type:"boolean"},caption:{description:"Subtext shown beneath the title",type:"string"},editButton:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{disabledTip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Control tooltip visibility from parent",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max height (number in px or CSS string)"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max width (number in px or CSS string)"},placement:{description:"Tooltip placement",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip shown when the settings edit button is disabled"},isDisabled:{description:"Disable the settings edit button",type:"boolean"},show:{description:"Show or hide the settings edit button. Default: true",type:"boolean"}},type:"object"}],description:"Settings edit button visibility/configuration. Default: true"},inlineLabel:{description:"Renders fields with inline labels (label and input side-by-side)",type:"boolean"},isDefaultEdit:{description:"Initial edit state in settings mode. Requires isSettings: true",type:"boolean"},isDisabled:{description:"Disables the entire form",type:"boolean"},isEdit:{description:"Bind to state to externally control settings edit mode. Requires isSettings: true",type:"boolean"},isFluid:{description:"Stretches fields to fill horizontal space. Default: true when settings/inlineLabel",type:"boolean"},isSettings:{description:"Renders form with edit/readonly modes (settings form)",type:"boolean"},noFooter:{description:"Removes the form footer. Default: false",type:"boolean"},noVerticalSpacing:{description:"Removes vertical margin from settings form",type:"boolean"},shouldHaveStickyFooter:{description:"Pins the footer to the bottom of the screen",type:"boolean"},shouldHaveStickyFooterOffset:{description:"Adds offset to prevent overlap when footer is sticky. Default: true",type:"boolean"},shouldStopFormPropagation:{description:"Stops form-submit event from bubbling — for nested forms",type:"boolean"},shouldTriggerChangeOnInputUnmount:{description:"Fires change event when an input unmounts. Default: false",type:"boolean"},shouldTrimOnSubmit:{description:"Trims string values on submit. Default: false",type:"boolean"},skipButton:{additionalProperties:!1,description:"Secondary skip action. Click emits the skip event.",properties:{label:{description:"Skip button label. Defaults to the Pebble skip label",type:"string"}},type:"object"},submitButtonLabel:{description:"Deprecated submit button label. Prefer submitButtonProps.label for new specs",type:"string"},submitButtonProps:{additionalProperties:!1,description:"Configuration for the form submit button",properties:{icon:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{alignment:{description:"Icon alignment relative to button label. Default: LEFT",enum:["LEFT","RIGHT"],type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name from Icon.TYPES",type:"string"}},required:["type"],type:"object"}],description:"Icon to show in the submit button"},isDisabled:{description:"Disable submit button",type:"boolean"},isFluid:{description:"Stretch submit button to fill width",type:"boolean"},isLoading:{description:"Show loading spinner on submit button. Bind to state for manual control.",type:"boolean"},label:{description:"Submit button label",type:"string"},size:{description:"Submit button size",enum:["L","M","S","XS"],type:"string"}},type:"object"},successMessage:{description:"Message shown in a snackbar after a successful submit",type:"string"},theme:{description:"Predefined form style theme",enum:["NO_CARD","NO_MARGIN_Y","V2"],type:"string"},title:{description:"Form title shown in header",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"External validation errors keyed by input name",propertyNames:{type:"string"},type:"object"},values:{additionalProperties:{},description:"Form values model. Written to state on change/submit (read-only — push-only)",propertyNames:{type:"string"},type:"object"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Custom form container width (applies only to settings forms)"}},type:"object"},acceptsChildren:!0},FormCheckbox:{description:"A Form-registered checkbox for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial checked state when uncontrolled",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isIndeterminate:{description:"Sets checkbox to indeterminate (neither checked nor unchecked) state",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text for the checkbox. Ignored when the element has children (rich label).",type:"string"},secondaryLabel:{description:"Secondary text below the label",type:"string"},shouldPreventFocus:{description:"Prevent the checkbox from receiving focus",type:"boolean"},theme:{description:"Visual theme variant",enum:["FLUID_WIDTH","REVERSE","FLUID_WIDTH_SPACE_BETWEEN_REVERSE"],type:"string"},tip:{description:"Tooltip text shown on hover",type:"string"},title:{description:"Form field label shown outside the checkbox",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"boolean"},variant:{description:"Display variant",enum:["BOX","LIST","GRID"],type:"string"}},required:["name"],type:"object"},acceptsChildren:!0},FormCheckboxGroup:{description:"A Form-registered checkbox group for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial array of selected values when uncontrolled",items:{},type:"array"},id:{description:"HTML id attribute for the checkbox group",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isHorizontal:{description:"Arrange options in a row",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the checkbox group",type:"string"},list:{description:"Array of {label, value} checkbox items",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this specific checkbox",type:"boolean"},label:{description:"Display text for the checkbox option",type:"string"},secondaryLabel:{description:"Secondary text below the option label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance style",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},label:{description:"Tag label text",type:"string"}},required:["label"],type:"object"}],description:"Optional tag/label displayed with the option"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when document scrolls. Default: false",type:"boolean"},isDelayed:{description:"Add delay before showing tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning relative to viewport. Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from state",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip content"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip content"},onlyIfChildOverflow:{description:"Only show tooltip if any child content overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if content overflows. Default: false",type:"boolean"},overwriteMiddleware:{description:"Overwrite default floating-UI middleware. Default: false",type:"boolean"},padding:{description:"CSS padding value for tooltip content",type:"string"},placement:{description:"Tooltip placement relative to the checkbox option",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"},shallSkipOverflowY:{description:"Skip overflow check on Y axis. Default: false",type:"boolean"},tipHideDelay:{description:"Milliseconds to wait before hiding tooltip when delayed",type:"number"},tipShowDelay:{description:"Milliseconds to wait before showing tooltip when delayed",type:"number"},title:{description:"Tooltip title text",type:"string"},truncateClassName:{description:"CSS class when onlyIfOverflow is enabled",type:"string"}},required:["content"],type:"object"}],description:"Tooltip shown on hover. Can be simple string text or a TipTypes object"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},theme:{description:"Theme styling: FLUID_WIDTH for full-width options, REVERSE for reversed theme",enum:["FLUID_WIDTH","REVERSE","FLUID_WIDTH_SPACE_BETWEEN_REVERSE"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Array of selected values bound to state ($bindState)",items:{},type:"array"},variant:{description:"Visual variant: BOX for boxed layout, LIST for list layout, GRID for grid layout",enum:["BOX","LIST","GRID"],type:"string"}},required:["name","list"],type:"object"},acceptsChildren:!1},FormContent:{description:"A Form layout helper that aligns non-input content to the same width and spacing rules as form fields.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{isFluid:{description:"Overrides whether content follows fluid form width. Defaults to the parent Form.",type:"boolean"}},type:"object"},acceptsChildren:!0},FormCurrency:{description:"A Form-registered currency field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},allowNegative:{description:"Whether negative values are allowed. Default: true",type:"boolean"},canSelectCurrencyType:{description:"If true, displays a dropdown to select currency type",type:"boolean"},currencyTypeProps:{additionalProperties:!1,description:"Nested Select props for the currency selector",properties:{name:{description:"Unique identifier for the currency selector",type:"string"},"aria-describedby":{description:"ID of element that describes the currency selector",type:"string"},"aria-label":{description:"Accessible label for the currency selector",type:"string"},"aria-labelledby":{description:"ID of element that labels the currency selector",type:"string"},canClear:{description:"Show clear button to deselect",type:"boolean"},defaultSearchQuery:{description:"Initial search input value",type:"string"},defaultValue:{description:"Initial selected currency code"},dropdownHeight:{description:"Dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query entered",type:"string"},onNoSearchResults:{description:"Placeholder when search returns no results",type:"string"}},type:"object"}],description:"Placeholder when dropdown list is empty"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options",propertyNames:{type:"string"},type:"object"},isDisabled:{description:"Disables the currency selector",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu opens by default",type:"boolean"},isPositionFixed:{description:"Position dropdown relative to viewport",type:"boolean"},isReadOnly:{description:"Makes the currency selector read-only",type:"boolean"},isRequired:{description:"Marks the currency selector as required",type:"boolean"},isSearchable:{description:"Enable type-to-search filtering",type:"boolean"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Dropdown max height"},placeholder:{description:"Placeholder text when empty",type:"string"},scrollThreshold:{description:"Extra virtual scroll render threshold",type:"number"},shouldFocusFirstElement:{description:"Auto-focus first menu item",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix",type:"boolean"},shouldUsePortal:{description:"Render dropdown in a React Portal",type:"boolean"},size:{description:"Select input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},value:{description:"Currently selected currency code"}},type:"object"},decimalPlaces:{description:"Number of decimal places allowed. Default: 2",type:"number"},defaultValue:{anyOf:[{type:"string"},{type:"number"},{type:"null"},{additionalProperties:!1,properties:{type:{description:"Currency code paired with the amount, e.g. USD or EUR",type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Currency amount value"}},required:["value","type"],type:"object"}],description:"Initial currency value set in Form on mount"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for number formatting (e.g. en-US). Overrides shouldLocalize when set.",type:"string"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Currency symbol or code shown as prefix. Default: USD",type:"string"},shouldSendCurrencyType:{description:"If true, onChange writes { value, type } using currencyTypeProps value/defaultValue",type:"boolean"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"number"},{type:"null"},{additionalProperties:!1,properties:{type:{description:"Currency code paired with the amount, e.g. USD or EUR",type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Currency amount value"}},required:["value","type"],type:"object"}],description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormDate:{description:"A Form-registered date picker for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},canClear:{description:"Show clear button",type:"boolean"},defaultValue:{anyOf:[{type:"string"},{type:"null"}],description:"Initial date value (yyyy-MM-dd) or null set in Form on mount"},format:{description:"Date display format. Default: MM/dd/yyyy",enum:["yyyy/MM/dd","yyyy-MM-dd","MM/dd/yyyy","dd/MM/yyyy","yyyy/MM/dd hh:mm a","yyyy-MM-dd hh:mm a","MM/dd/yyyy hh:mm a","dd/MM/yyyy hh:mm a","yyyy/MM/dd hh:mm:ss a","yyyy-MM-dd hh:mm:ss a","MM/dd/yyyy hh:mm:ss a","dd/MM/yyyy hh:mm:ss a","ISO_STRING"],type:"string"},id:{description:"HTML id attribute for the input",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the date picker",type:"string"},locale:{description:"Locale for date formatting. Default: en-US",type:"string"},maxDate:{description:"Latest selectable date as ISO string",type:"string"},minDate:{description:"Earliest selectable date as ISO string",type:"string"},shouldLocalize:{description:"If true, display format will be determined from user locale setting. Default: false for explicit format control",type:"boolean"},shouldShowTime:{description:"Include time selection",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Visual theme variant. NO_BOX removes input box styling",enum:["NO_BOX"],type:"string"},timezone:{description:'Timezone name (e.g. "America/New_York"). Used with shouldShowTime',type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"null"}],description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormDateRange:{description:"A Form-registered date range picker for selecting start and end dates inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},alwaysShowTimezone:{description:"If true, timezone abbreviation will always be shown when shouldShowTime is true. Default: false",type:"boolean"},canClear:{description:"Show clear button",type:"boolean"},defaultValue:{anyOf:[{items:{anyOf:[{type:"string"},{type:"null"}]},type:"array"},{type:"null"}],description:"Initial date range value [start, end] or null set in Form on mount"},divider:{description:'Separator between date units (e.g. "/" or "-")',type:"string"},endDateLabel:{description:"Label for the end date field",type:"string"},format:{description:"Date display format. Default: MM/dd/yyyy",enum:["yyyy/MM/dd","yyyy-MM-dd","MM/dd/yyyy","dd/MM/yyyy","yyyy/MM/dd hh:mm a","yyyy-MM-dd hh:mm a","MM/dd/yyyy hh:mm a","dd/MM/yyyy hh:mm a","yyyy/MM/dd hh:mm:ss a","yyyy-MM-dd hh:mm:ss a","MM/dd/yyyy hh:mm:ss a","dd/MM/yyyy hh:mm:ss a","ISO_STRING"],type:"string"},hideStepper:{description:"If true, arrow navigation key to increment/decrement date will be hidden. Default: false",type:"boolean"},id:{description:"HTML id attribute for the date range input",type:"string"},isCalendarDefaultOpen:{description:"If true, calendar will be open by default on mount",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isLarge:{description:"Renders large calendar when true. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the date range picker",type:"string"},locale:{description:"Locale for date formatting",type:"string"},maxDate:{description:"Latest selectable date as ISO string",type:"string"},minDate:{description:"Earliest selectable date as ISO string",type:"string"},shouldFormatInTimezone:{description:"If true, values will transform according to global timezone. Defaults to true when shouldShowTime is true",type:"boolean"},shouldLocalize:{description:"If true, display format is determined from user locale. Default: true",type:"boolean"},shouldShowTime:{description:"Include time selection",type:"boolean"},shouldShowTimezoneLabel:{description:"If false, timezone label will not be shown. Default: true",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},startDateLabel:{description:"Label for the start date field",type:"string"},theme:{description:"Visual theme variant. NO_BOX removes input box styling",enum:["NO_BOX"],type:"string"},timezone:{description:"Timezone for date/time display and storage. Used with shouldShowTime",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{items:{anyOf:[{type:"string"},{type:"null"}]},type:"array"},{type:"null"}],description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormDaySelector:{description:"A Form-registered day-of-week selector for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{anyOf:[{enum:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],type:"string"},{items:{enum:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],type:"string"},type:"array"}],description:"Initial day(s) when uncontrolled"},isDisabled:{description:"Disables the input",type:"boolean"},isMulti:{description:"Allow multiple day selection. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},renderProps:{additionalProperties:{additionalProperties:!1,properties:{isDisabled:{type:"boolean"},tip:{additionalProperties:!1,properties:{content:{type:"string"}},required:["content"],type:"object"}},type:"object"},description:"Per-day configuration. Keys are day names (Sunday, Monday, etc.). Each can have isDisabled (boolean) and tip (object with content string)",propertyNames:{type:"string"},type:"object"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormEmail:{description:"A Form-registered email field with built-in email validation, for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"null"}],description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormEmployeeSearch:{description:"Search for and select one or more employees as a registered form field. Supports ACTIVE; GOOD (HIRED, ACCEPTED, and ACTIVE); ACCEPTED_AND_ACTIVE (excluding HIRED); NON_INIT (all employee states except INIT, including TERMINATED); INIT (hiring started but not completed; the backend preset is roleState INIT and is not employee-constrained); and TERMINATED. The change event is notification-only and has no payload.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Non-empty field name used to register this employee role-id value with the parent form.",minLength:1,type:"string"},canClear:{description:"Controls whether the current selection can be cleared. When omitted, the underlying select default applies.",type:"boolean"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Initial uncontrolled selection as an employee role id for single select or role id array for multi-select. Defaults to no selection."},isDisabled:{description:"When true, disables searching and selection changes. Defaults to false.",type:"boolean"},isMulti:{description:"When true, allows multiple employee selections and uses role id arrays. Defaults to false (single select).",type:"boolean"},isReadOnly:{description:"When true, displays the selection without allowing changes. Defaults to false.",type:"boolean"},isRequired:{description:"When true, marks the field as required. Defaults to the form control default (not required).",type:"boolean"},label:{description:"Label displayed for the search field. Defaults to no label.",type:"string"},placeholder:{description:"Placeholder displayed when the search field is empty. When omitted, the component default placeholder is used.",type:"string"},roleIdsToExclude:{description:"Removes the specified employee role ids from search results when no inclusion list is provided. When both lists are provided, inclusion takes precedence. When omitted, no role ids are explicitly excluded.",items:{type:"string"},type:"array"},roleIdsToInclude:{description:"Limits search results to the specified employee role ids. When both inclusion and exclusion lists are provided, inclusion takes precedence. When omitted, results are not restricted by an inclusion list.",items:{type:"string"},type:"array"},roleTypes:{description:"Limits search results using backend role-type presets. ACTIVE selects active employees. GOOD selects HIRED, ACCEPTED, and ACTIVE employees. ACCEPTED_AND_ACTIVE selects ACCEPTED and ACTIVE employees and excludes HIRED. NON_INIT selects all employee states except INIT, including TERMINATED. INIT selects the backend roleState INIT preset (hiring started but not completed) and is not additionally constrained to employees. TERMINATED selects terminated employees. Requires at least one value; defaults to GOOD.",items:{enum:["ACTIVE","GOOD","ACCEPTED_AND_ACTIVE","NON_INIT","INIT","TERMINATED"],type:"string"},minItems:1,type:"array"},tip:{description:"Supplementary tip displayed with the label. Defaults to no tip.",type:"string"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Controlled selection as an employee role id for single select or role id array for multi-select. When omitted, the component is uncontrolled. When value and defaultValue are both provided, value takes precedence."}},required:["name"],type:"object"},acceptsChildren:!1},FormFile:{description:"A Form-registered file upload field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},allowCameraCapture:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{quality:{description:"Captured image quality",type:"number"}},type:"object"}],description:"Allow camera capture for image files; object form supports quality"},cropperConfig:{additionalProperties:!1,description:"Cropper configuration",properties:{aspectRatio:{description:"Aspect ratio for cropper. Default: 1:1",enum:["16:9","4:3","1:1"],type:"string"},enforceAspectRatio:{description:"Enforce the aspect ratio on cropper. Default: true",type:"boolean"},showUploadButton:{description:"Show upload button on cropper. Default: true",type:"boolean"},title:{description:"Title for the cropper modal",type:"string"}},type:"object"},defaultValue:{description:"Default files to show when no value is provided",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},isMultipart:{description:"Whether this is a multipart upload",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},size:{description:"File size in bytes",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"},enableCropper:{description:"Enable image cropping for selected images",type:"boolean"},icon:{description:"Icon name from Icon.TYPES to show above placeholder",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the file drop area",type:"string"},maxFileSize:{description:"Max file size in MB per attachment",type:"number"},maxTotalFileSize:{description:"Max total size in MB for all attachments",type:"number"},multiple:{description:"Allow selecting multiple files",type:"boolean"},placeholder:{description:"Text shown when no files are selected",type:"string"},showProgress:{description:"Show upload progress bar. Default: false",type:"boolean"},supportTypes:{description:'Supported file extensions with dot prefix, e.g. [".pdf", ".png", ".jpg"]. Do NOT use MIME types.',items:{type:"string"},type:"array"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},type:{description:"File input display type. Default: DEFAULT",enum:["DEFAULT","RECEIPT"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Array of file objects bound to state",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},isMultipart:{description:"Whether this is a multipart upload",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},size:{description:"File size in bytes",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"}},required:["name"],type:"object"},acceptsChildren:!1},FormFileDrop:{description:"A Form-registered file upload field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},allowCameraCapture:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{quality:{description:"Captured image quality",type:"number"}},type:"object"}],description:"Allow camera capture for image files; object form supports quality"},cropperConfig:{additionalProperties:!1,description:"Cropper configuration",properties:{aspectRatio:{description:"Aspect ratio for cropper. Default: 1:1",enum:["16:9","4:3","1:1"],type:"string"},enforceAspectRatio:{description:"Enforce the aspect ratio on cropper. Default: true",type:"boolean"},showUploadButton:{description:"Show upload button on cropper. Default: true",type:"boolean"},title:{description:"Title for the cropper modal",type:"string"}},type:"object"},defaultValue:{description:"Default files to show when no value is provided",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"},enableCropper:{description:"Enable image cropping for selected images",type:"boolean"},icon:{description:"Icon name from Icon.TYPES to show above placeholder",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the file drop area",type:"string"},maxFileSize:{description:"Max file size in MB per attachment",type:"number"},maxTotalFileSize:{description:"Max total size in MB for all attachments",type:"number"},metadata:{description:"JSON-serializable metadata sent with upload requests"},multiPartUpload:{description:"Enables multipart upload flow for files larger than 100MB",type:"boolean"},multiple:{description:"Allow selecting multiple files",type:"boolean"},placeholder:{description:"Text shown when no files are selected",type:"string"},supportTypes:{description:'Supported file extensions with dot prefix, e.g. [".pdf", ".png", ".jpg"]. Do NOT use MIME types.',items:{type:"string"},type:"array"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},type:{description:"Type of file drop: upload (shows progress bars automatically) or content. Default: content",enum:["upload","content"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Array of file objects bound to state",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"}},required:["name"],type:"object"},acceptsChildren:!1},FormGroup:{description:"A Form subsection container with an optional title, caption, and tooltip for grouping related fields.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{caption:{description:"Supporting text shown below the group title",type:"string"},tip:{description:"Tooltip text shown beside the group title",type:"string"},title:{description:"Group heading text",type:"string"}},type:"object"},acceptsChildren:!0},FormGroupHeader:{description:"Deprecated Form group header primitive. Prefer FormGroup for new specs because it owns both header and grouped children.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{caption:{description:"Supporting text shown below the group title",type:"string"},tip:{description:"Tooltip text shown beside the group title",type:"string"},title:{description:"Group heading text",type:"string"}},type:"object"},acceptsChildren:!1},FormHidden:{description:"A Form-registered hidden field for use inside a Form. Renders no UI — use to inject computed values into the Form submit payload.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial value to register with Form on mount"}},required:["name"],type:"object"},acceptsChildren:!1},FormInlineGroup:{description:"A Form layout helper that arranges two or three child fields side by side in a single row.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{customChildWidths:{description:"Per-child widths. Must match child count and sum to 100%.",items:{description:'Percentage width string, e.g. "50%" or "33.3%"',pattern:"^\\d+(\\.\\d+)?%$",type:"string"},type:"array"},tip:{description:"Tooltip text shown beside the group label",type:"string"},title:{description:"Inline group label text",type:"string"}},type:"object"},acceptsChildren:!0},FormInputGroup:{description:"A Form-registered grouped input layout that combines one main input with optional prefix and suffix inputs.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial value for the main input on mount"},hasSeparateFormControls:{description:"When true, prefix and suffix input configurations are rendered as separate Form fields inside the group",type:"boolean"},input:{additionalProperties:!1,description:"Main input configuration with type and inputProps",properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},isDisabled:{description:"Disables all inputs in the group",type:"boolean"},isReadOnly:{description:"Makes all inputs in the group read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text shown by the Form field wrapper",type:"string"},prefix:{anyOf:[{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},{items:{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},type:"array"}],description:"Prefix input configuration(s) prepended to the main input"},prefixMaxWidthPercent:{description:"Max width percentage for the prefix container",type:"number"},prefixMinWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum width for the prefix container"},shouldHideAddons:{description:"Hides prefix/suffix without destroying them",type:"boolean"},size:{description:"Size of all inputs in the group. Default: M",enum:["XS","S","M","L"],type:"string"},suffix:{anyOf:[{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},{items:{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},type:"array"}],description:"Suffix input configuration(s) appended to the main input"},suffixMaxWidthPercent:{description:"Max width percentage for the suffix container",type:"number"},suffixMinWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum width for the suffix container"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name","input"],type:"object"},acceptsChildren:!1},FormMasker:{description:"A Form-registered masked text input for values with a fixed format.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},"aria-label":{description:"Accessible label when no visible label",type:"string"},autoComplete:{description:"Browser autocomplete hint. Default: off",type:"string"},autoFocus:{description:"Auto-focus input on mount",type:"boolean"},defaultValue:{description:"Initial masked value set in Form on mount",type:"string"},fixedCharsPrefix:{description:"Fixes characters at the beginning of the value",type:"string"},fixedCharsSuffix:{description:"Fixes characters at the end of the value",type:"string"},id:{description:"Explicit HTML element id",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isSensitive:{description:"Marks input as sensitive for privacy/security",type:"boolean"},label:{description:"Label text above the input",type:"string"},mask:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:'Mask pattern. Use 9 for digit, a for letter, * for any character. Can be string ("999-999-9999") or array of patterns (["99.9a-999", "99.99/99-9"]) for multi-mask support'},maxLength:{description:"Maximum character length",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character length",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},shouldEnforceUpperCase:{description:"Enforces uppercase on input characters",type:"boolean"},shouldSkipInitialFormatting:{description:"If true, skip applying mask on the default/initial value",type:"boolean"},shouldUnmaskValue:{description:"If true, onChange passes the unmasked value (without mask characters)",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name","mask"],type:"object"},acceptsChildren:!1},FormNumber:{description:"A Form-registered numeric field for use inside a Form component.",events:["change","blur","changeRaw","changeCalculationState"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoComplete:{description:'Browser autocomplete hint. Default: "off"',type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},decimalPlaces:{description:"Number of decimal places. Default: 2",type:"number"},defaultValue:{anyOf:[{type:"string"},{type:"number"}],description:"Initial default value for uncontrolled usage"},isDisabled:{description:"Disables the input",type:"boolean"},isIntegerOnly:{description:"Restrict to integer values only",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:'Locale string for number formatting (e.g. "en-US", "de-DE")',type:"string"},max:{description:"Maximum allowed value",type:"number"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},min:{description:"Minimum allowed value. Default: 0",type:"number"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text prefix inside the input",type:"string"},shouldAllowCalculation:{description:"If true, input allows arithmetic operators and evaluates on blur",type:"boolean"},shouldDisableFormatting:{description:"If true, number formatting will not be applied. Default: true",type:"boolean"},shouldDisableRedundantZeroFormatting:{description:"If true, redundant zeros are preserved. Default: true",type:"boolean"},shouldStripLeadingZeros:{description:"If true, leading zeros are stripped from the numeric value",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},step:{description:"Increment/decrement step size. Default: 1",type:"number"},stringPadding:{additionalProperties:!1,description:"Adds padding characters to the input value",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Position to pad (start or end)",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text suffix inside the input",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormPassword:{description:"A Form-registered password field with show/hide toggle, for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},shouldAllowReveal:{description:"Show password reveal toggle. Default: true",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormPercentage:{description:"A Form-registered percentage field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},allowNegative:{description:"Whether negative values are allowed. Default: false",type:"boolean"},decimalPlaces:{description:"Number of decimal places allowed. Default: 2",type:"number"},defaultValue:{description:"Default percentage value when uncontrolled",type:"number"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for percentage formatting (e.g. en-US)",type:"string"},lowerLimit:{description:"Minimum allowed percentage value",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},shouldDisableFormatting:{description:"If true, percentage formatting will not be applied",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},step:{description:"Increment/decrement step size. Default: 1",type:"number"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},upperLimit:{description:"Maximum allowed percentage value. Default: 100",type:"number"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormPhone:{description:"A Form-registered phone number field with region-based formatting, for use inside a Form component.",events:["change","blur","countryCodeChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoComplete:{description:'Browser autocomplete hint, e.g. "tel"',type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},countryCode:{anyOf:[{description:'Fixed country code prefix as a string, e.g. "91" or "1"',type:"string"},{additionalProperties:!1,description:"Country-code dropdown configuration preserving the serializable CountryCodeProp shape",properties:{name:{description:"Name for the country-code select input",type:"string"},"aria-describedby":{description:"ID of the element that describes the country-code dropdown",type:"string"},"aria-label":{description:"Accessible label for the country-code dropdown",type:"string"},"aria-labelledby":{description:"ID of the element that labels the country-code dropdown",type:"string"},canClear:{description:"Show clear button in the country-code dropdown",type:"boolean"},defaultSearchQuery:{description:"Initial search query for the country-code dropdown",type:"string"},defaultValue:{description:"Initial selected country code for the dropdown branch",type:"string"},dropdownHeight:{description:"Country-code dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while the dropdown list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query is entered",type:"string"},onNoSearchResults:{description:"Placeholder shown when no matching regions are found",type:"string"}},type:"object"}],description:"Placeholder shown when the country-code dropdown list is empty"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for the country-code dropdown",propertyNames:{type:"string"},type:"object"},id:{description:"HTML id attribute for the country-code select input",type:"string"},isDisabled:{description:"Disables the country-code dropdown",type:"boolean"},isMenuDefaultOpen:{description:"If true, the country-code dropdown opens by default",type:"boolean"},isPositionFixed:{description:"Position the country-code dropdown relative to the viewport",type:"boolean"},isReadOnly:{description:"Makes the country-code dropdown read-only",type:"boolean"},isRequired:{description:"Marks the country-code dropdown as required",type:"boolean"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Maximum dropdown height or chip container height as a CSS value"},placement:{description:"Country-code dropdown placement. Default: bottom-start",enum:["auto","auto-start","auto-end","top","top-start","top-end","bottom","bottom-start","bottom-end","right","right-start","right-end","left","left-start","left-end"],type:"string"},rows:{description:"Minimum row count for the country-code dropdown",type:"number"},scrollThreshold:{description:"Extra pixels rendered above and below the viewport in paginated mode",type:"number"},shouldFocusFirstElement:{description:"Auto-focus the first dropdown item when the menu opens",type:"boolean"},shouldShowSearchIcon:{description:"Show the search icon inside the country-code dropdown",type:"boolean"},shouldUsePortal:{description:"Render the country-code dropdown in a React portal",type:"boolean"},size:{description:"Country-code dropdown size. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Country-code dropdown theme variant",enum:["TRANSPARENT_BORDER","TOP_NAV","INLINE_TRANSPARENT_BORDER","INLINE_TOP_NAV","NO_PADDING_RIGHT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_RIGHT_NO_BOX_TOP_NAV","NO_PADDING_LEFT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_LEFT_NO_BOX_TOP_NAV"],type:"string"},value:{anyOf:[{type:"string"},{type:"null"}],description:"Controlled selected country code for the dropdown branch"}},type:"object"}],description:"Either a fixed country code string or a country-code dropdown configuration object"},countryCodeDefaultValue:{description:"[Deprecated] Use countryCode.defaultValue instead. Initial selected country code for the legacy dropdown shape",type:"string"},countryCodeValue:{description:"[Deprecated] Use countryCode.value instead. Bound selected country code for the legacy dropdown shape",type:"string"},defaultRegion:{description:'Default country region code for formatting, e.g. "US", "IN", "CA". Default: US',type:"string"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isCountryCodeDisabled:{description:"[Deprecated] Use countryCode.isDisabled instead for the legacy dropdown shape",type:"boolean"},isCountryCodeReadOnly:{description:"[Deprecated] Use countryCode.isReadOnly instead for the legacy dropdown shape",type:"boolean"},isCountryCodeRequired:{description:"[Deprecated] Use countryCode.isRequired instead for the legacy dropdown shape",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormRadio:{description:"A Form-registered radio group for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial value when uncontrolled"},isDisabled:{description:"Disables the input",type:"boolean"},isHorizontal:{description:"Arrange options in a row",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the radio group",type:"string"},list:{description:"Array of {label, value} radio options",items:{additionalProperties:!1,properties:{isActive:{description:"Controls focus state of the option",type:"boolean"},isDisabled:{description:"Disables this specific option",type:"boolean"},label:{description:"Display text for the option",type:"string"},secondaryLabel:{description:"Secondary text below the option label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance style",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},label:{description:"Tag label text",type:"string"}},required:["label"],type:"object"}],description:"Optional tag/label displayed with the option"},tip:{description:"Tooltip text shown on hover",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},theme:{description:"Theme styling: FLUID_WIDTH for full-width options, REVERSE for reversed theme",enum:["FLUID_WIDTH","REVERSE","FLUID_WIDTH_SPACE_BETWEEN_REVERSE"],type:"string"},tip:{description:"Tooltip text shown alongside the label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"},variant:{description:"Visual variant: BOX for boxed layout, LIST for list layout, GRID for grid layout",enum:["BOX","LIST","GRID"],type:"string"}},required:["name","list"],type:"object"},acceptsChildren:!1},FormSegmentedControl:{description:"A Form-registered segmented control for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},appearance:{description:"Visual style variant. Default: PRIMARY",enum:["PRIMARY","POSITIVE","NEGATIVE","NEUTRAL"],type:"string"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Initial value when uncontrolled"},isDisabled:{description:"Disables the input",type:"boolean"},isFluid:{description:"Stretches control to fill container width",type:"boolean"},isMulti:{description:"Allows selecting multiple options",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isVertical:{description:"Renders options in a vertical layout",type:"boolean"},label:{description:"Label text above the segmented control",type:"string"},list:{description:"Array of { label, value } segmented control options",items:{additionalProperties:!1,properties:{appearance:{description:"Visual style for this specific option",enum:["PRIMARY","POSITIVE","NEGATIVE","NEUTRAL"],type:"string"},"aria-label":{description:"Accessible label, required if label is not provided (e.g. for icon-only items)",type:"string"},icon:{description:"Icon to display for icon-only items. Requires aria-label or label for accessibility",type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},label:{description:"Display text for the option",type:"string"},tip:{additionalProperties:!1,description:"Tooltip to show on hover for this option",properties:{content:{description:"Tooltip text content",type:"string"}},required:["content"],type:"object"},value:{description:"Value stored when option is selected",type:"string"}},required:["value"],type:"object"},type:"array"},rangeLabels:{additionalProperties:!1,description:"Labels to display at the start and end of the control range",properties:{end:{description:"Label at the end of the range",type:"string"},start:{description:"Label at the start of the range",type:"string"}},required:["start","end"],type:"object"},size:{description:"Control size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormSelect:{description:"A Form-registered dropdown select for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},canClear:{description:"Show clear button to deselect all",type:"boolean"},canSelectAll:{description:"Show select-all toggle. Requires isMulti to be true",type:"boolean"},creatable:{description:"Allow creating new options not in the list",type:"boolean"},defaultSearchQuery:{description:"Initial search input value",type:"string"},defaultValue:{anyOf:[{items:{},type:"array"},{}],description:"Initial selected value or values when uncontrolled"},dropdownHeight:{description:"Sets dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query entered",type:"string"},onNoSearchResults:{description:"Placeholder when search returns no results",type:"string"}},type:"object"}],description:"Placeholder when dropdown list is empty. Can be string or object with state-specific placeholders"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing fuzzy search behavior",propertyNames:{type:"string"},type:"object"},isDisabled:{description:"Disables the input",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu will be open by default",type:"boolean"},isMulti:{description:"Allow multiple selections",type:"boolean"},isPositionFixed:{description:"Position dropdown relative to viewport instead of parent",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isSearchable:{description:"Enable type-to-search filtering",type:"boolean"},label:{description:"Label text above the select",type:"string"},list:{anyOf:[{items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},{items:{additionalProperties:!1,properties:{isNestedMenu:{description:"Render the group as a nested submenu",type:"boolean"},label:{description:"Group label shown above its options",type:"string"},list:{description:"Options contained in this group",items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"}},required:["label","list"],type:"object"},type:"array"}],description:"Flat array of {label, value} options, or nested array of {label, list} groups for grouped/submenu options"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Max height of multi-select container (CSS value)"},maxTruncationLines:{description:'Max rows of chips visible before "+X" overflow chip appears (multi-select only)',type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},placement:{description:"Dropdown position relative to input. Default: bottom-start",enum:["auto","auto-start","auto-end","top","top-start","top-end","bottom","bottom-start","bottom-end","right","right-start","right-end","left","left-start","left-end"],type:"string"},shouldFocusFirstElement:{description:"Auto-focus first menu item when dropdown opens",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix when isSearchable is true",type:"boolean"},shouldUsePortal:{description:"Render dropdown in a React Portal. Default: false",type:"boolean"},size:{description:"Select input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormSelectableGroup:{description:"A Form-registered card-based selection group for single or multi-choice choices inside a Form.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},"aria-describedby":{description:"ID of element that describes this input for screen readers",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input for screen readers",type:"string"},defaultValue:{anyOf:[{type:"string"},{type:"number"},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Initial selection when uncontrolled"},id:{description:"Unique DOM id for the input element",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isMulti:{description:"Allow multiple selection. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Array of item objects to render as selectable cards",items:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},type:"array"},renderer:{description:"JSON-only constrained renderer choice: BASIC_CARD or LOCATION_CARD",enum:["BASIC_CARD","LOCATION_CARD"],type:"string"},testId:{description:"Deprecated testing-only prop kept for backward compatibility",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"number"},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Current value bound to state"},valueIdentifier:{description:'Key name to extract unique value from each list item. Default: "value"',type:"string"}},required:["name","list","renderer"],type:"object"},acceptsChildren:!1},FormSignature:{description:"A Form-registered signature capture input for drawing or typing a signature inside a Form.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},defaultValue:{description:"Initial default signature value",type:"string"},id:{description:"Unique DOM element ID",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isTypeSignatureDisabled:{description:"Only show draw input, hide type input. Default: false",type:"boolean"},label:{description:"Label text above the input",type:"string"},penColor:{description:"Pen color token for drawing",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},placeholder:{description:"Placeholder text for the drawing area",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},typePlaceholder:{description:"Placeholder text for the type signature input",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormSin:{description:"A Form-registered SIN (Social Insurance Number) masked field for use inside a Form. Applies the Canadian SIN format mask (999 999 999) automatically.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial masked value set in Form on mount",type:"string"},fixedCharsPrefix:{description:"Fixes characters at the beginning of the value",type:"string"},fixedCharsSuffix:{description:"Fixes characters at the end of the value",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},placeholder:{description:'Placeholder text. Default: "XXX XXX XXX"',type:"string"},shouldEnforceUpperCase:{description:"Enforces uppercase on input characters",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormSlider:{description:"A Form-registered slider for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},appearance:{description:"Sets slider appearance. Default: PRIMARY",enum:["PRIMARY","ERROR","SUCCESS","WARNING"],type:"string"},defaultValue:{description:"Initial value when uncontrolled. Default: 0",type:"number"},hideTooltip:{description:"Hide the value tooltip. Default: false",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isDotsVisible:{description:"If true renders slider with dots. Default: true",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the slider",type:"string"},marks:{additionalProperties:{type:"string"},description:"Named marks on the slider track. Keys are numeric positions, values are labels",propertyNames:{type:"string"},type:"object"},max:{description:"Maximum value. Default: 100",type:"number"},min:{description:"Minimum value. Default: 0",type:"number"},shouldShowMarker:{description:"Controls visibility of marker. Default: true",type:"boolean"},step:{anyOf:[{type:"number"},{type:"null"}],description:"Step size. Set to null to use marks as steps. Default: 1"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormSsn:{description:"A Form-registered SSN (Social Security Number) masked field for use inside a Form. Applies the US SSN format mask (999-99-9999) automatically.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial masked value set in Form on mount",type:"string"},fixedCharsPrefix:{description:"Fixes characters at the beginning of the value",type:"string"},fixedCharsSuffix:{description:"Fixes characters at the end of the value",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},placeholder:{description:'Placeholder text. Default: "XXX-XX-XXXX"',type:"string"},shouldEnforceUpperCase:{description:"Enforces uppercase on input characters",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormSurvey:{description:"A Form-registered survey/rating input for collecting a bounded opinion or score inside a Form.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},caption:{description:"Caption text displayed below the survey",type:"string"},defaultValue:{anyOf:[{anyOf:[{type:"string"},{type:"number"}]},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Initial selected value(s) set on mount"},isDisabled:{description:"Disables the input",type:"boolean"},isMulti:{description:"Allow multiple selections. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isVertical:{description:"Stack options vertically. Default: false",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Array of survey option items with label and value",items:{additionalProperties:!1,properties:{icon:{description:"Pebble icon name displayed for the option",type:"string"},isDisabled:{description:"Disable this specific option",type:"boolean"},label:{anyOf:[{type:"string"},{type:"number"}],description:"Display label for the option"},selectionColor:{description:"Override selected surface color token for this option",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Value when selected"}},required:["value"],type:"object"},type:"array"},rangeLabels:{additionalProperties:!1,description:"Labels for lowest and highest options",properties:{lower:{description:"Label for the lowest option",type:"string"},upper:{description:"Label for the highest option",type:"string"}},required:["lower","upper"],type:"object"},theme:{description:"Survey theme. TWO_LINE stacks label below value",enum:["TWO_LINE"],type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{anyOf:[{type:"string"},{type:"number"}]},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Current value bound to state"}},required:["name","list"],type:"object"},acceptsChildren:!1},FormSwitch:{description:"A Form-registered toggle switch for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},compact:{description:"Use compact size variant",type:"boolean"},defaultValue:{description:"Initial toggle state when uncontrolled",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Field-level label shown above the switch",type:"string"},offLabel:{description:"Label text when switch is off",type:"string"},onLabel:{description:"Label text when switch is on",type:"string"},rightAlign:{description:"Align switch to the right",type:"boolean"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip theme. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when the document is scrolled. Default: false",type:"boolean"},isDelayed:{description:"Add delay before showing/hiding the tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning for the tooltip. Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from parent. Overrides hover behavior when set",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Max height of tooltip content. Number in px or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Max width of tooltip. Number in px or CSS string. Default: 360"},onlyIfChildOverflow:{description:"Only show tooltip if a child element overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if the trigger element overflows. Default: false",type:"boolean"},placement:{description:"Tooltip position relative to child. Default: bottom",enum:["top","top-start","top-end","bottom","bottom-start","bottom-end","left","left-start","left-end","right","right-start","right-end"],type:"string"},tipHideDelay:{description:"Custom delay in ms before tooltip hides",type:"number"},tipShowDelay:{description:"Custom delay in ms before tooltip appears",type:"number"},title:{description:"Optional bold title above tooltip content",type:"string"}},required:["content"],type:"object"}],description:"Tooltip text or serializable tip config shown alongside the switch labels"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"boolean"}},required:["name"],type:"object"},acceptsChildren:!1},FormText:{description:"A Form-registered text field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},canClear:{description:"Show clear button",type:"boolean"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormTextarea:{description:"A Form-registered multi-line textarea for use inside a Form component.",events:["change","blur","focus"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},hasCharsLimit:{description:"Show character count indicator. Requires maxLength to be set",type:"boolean"},height:{description:"Fixed height in pixels",type:"number"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxHeight:{description:"Maximum height in pixels",type:"number"},maxLength:{description:"Maximum character count. Default: 10000",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},rows:{description:"Number of visible text rows",type:"number"},theme:{description:"Visual theme variant",enum:["NO_BOX"],type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormTextAutoSuggest:{description:"A Form-registered text field with auto-suggest dropdown for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial value set in Form on mount",type:"string"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing suggestion filtering",propertyNames:{type:"string"},type:"object"},isDisabled:{description:"Disables the input",type:"boolean"},isPositionFixed:{description:"Use fixed positioning for dropdown menu. Useful in scrollable containers",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Flat suggestion list matching the React `list` item shape",items:{additionalProperties:{},properties:{isDisabled:{description:"Disables selection for this suggestion item",type:"boolean"},label:{description:"Display text shown for the suggestion item",type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Value written when the suggestion is selected"}},type:"object"},type:"array"},maxLength:{description:"Maximum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},shouldShowMenuOnFocus:{description:"Show dropdown menu on input focus. Default: false",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix. Default: false",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Current value bound to state"}},required:["name","list"],type:"object"},acceptsChildren:!1},FormTime:{description:"A Form-registered time picker field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},alwaysShowTimezone:{description:"If true, timezone abbreviation will always be shown. Default: false",type:"boolean"},defaultSelectionStartTime:{description:'Time to start the selection scroll from when shouldAllowTimeSelection is true (e.g. "08:00 AM")',type:"string"},defaultValue:{description:'Initial value — ISO 8601 or "HH:MM AM/PM" time string',type:"string"},isDateTimeInline:{description:"Make input inline, removes border, padding and width fits input/placeholder content",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for time formatting (e.g. en-US)",type:"string"},maxWidth:{description:"Maximum width CSS value",type:"string"},pickClosestMeridiem:{description:"When user does not enter AM/PM, pick the closest meridiem to the inputted hour value. Default: false",type:"boolean"},referenceDate:{description:"ISO date string used as reference for timezone calculations and DST determination. Defaults to current date.",type:"string"},shouldAllowTimeSelection:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{reference:{description:"Reference ISO time for period labels",type:"string"}},type:"object"}],description:"Show a time selection dropdown for picking times"},shouldDisplaySeconds:{description:"Display seconds in the time input",type:"boolean"},shouldFormatInTimezone:{description:"If true, values will transform according to global timezone when timezone prop is not passed explicitly",type:"boolean"},shouldLocalize:{description:"If true, display format will be determined from user locale setting",type:"boolean"},shouldReturnISO:{description:"Always return value in ISO 8601 format",type:"boolean"},shouldShowTimezoneLabel:{description:"If false, timezone label will not be shown. Default: true",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},timezone:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{name:{description:"Input name for the timezone selector",type:"string"},isRequired:{description:"Marks the timezone selector as required",type:"boolean"},value:{description:"Selected timezone value",type:"string"}},required:["name"],type:"object"}],description:"Show time relative to this timezone or configure the timezone selector"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormTimezone:{description:"A Form-registered timezone selector for choosing an IANA timezone inside a Form.",events:["change","blur","focus"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},canClear:{description:"Shows a clear button to reset selection",type:"boolean"},defaultValue:{description:"Initial IANA timezone identifier",type:"string"},displayIANA:{description:"Display IANA timezone name. Default: true",type:"boolean"},displayShortFormat:{description:"Display timezone abbreviation",type:"boolean"},dropdownHeight:{description:"Height of the dropdown menu in pixels",type:"number"},emptyListPlaceholder:{description:"Placeholder text shown when no timezone matches the search",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isMenuDefaultOpen:{description:"If true, the dropdown menu will be open by default on mount",type:"boolean"},isPositionFixed:{description:"Use fixed positioning for dropdown (useful in scrollable containers)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isSearchable:{description:"Enables search filtering. Default: true",type:"boolean"},label:{description:"Label text above the input",type:"string"},placeholder:{description:"Placeholder text when empty",type:"string"},placement:{description:"Dropdown placement position. Default: BOTTOM_START",enum:["TOP_START","TOP","TOP_END","RIGHT_START","RIGHT","RIGHT_END","BOTTOM_END","BOTTOM","BOTTOM_START","LEFT_END","LEFT","LEFT_START"],type:"string"},referenceDate:{description:"ISO 8601 date string to determine timezone offsets (e.g. 2024-01-15T12:00:00Z)",type:"string"},shouldShowSearchIcon:{description:"If true, shows a search icon in the dropdown",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Visual theme variant for the input",enum:["TRANSPARENT_BORDER","TOP_NAV","INLINE_TRANSPARENT_BORDER","INLINE_TOP_NAV","NO_PADDING_RIGHT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_RIGHT_NO_BOX_TOP_NAV","NO_PADDING_LEFT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_LEFT_NO_BOX_TOP_NAV"],type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormTree:{description:"A Form-registered tree selection field for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},canSelectAll:{description:"Show select all toggle in multi mode",type:"boolean"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"},{type:"null"}],description:"Initial selection set in Form on mount"},dropdownWidth:{description:"Override internal dropdown width in pixels",type:"number"},emptyListPlaceholder:{description:"Placeholder text when list is empty",type:"string"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing search behavior",propertyNames:{type:"string"},type:"object"},hasIndependentActions:{description:"In multiSelect, action on an item does not affect selection of parent or child items",type:"boolean"},hasIndependentChildActions:{description:"Actions on child in multi select do not affect selection of ancestors",type:"boolean"},hasStaticParentNodes:{description:"Makes parent nodes non-actionable (only manage hierarchy)",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isMulti:{description:"Allow multiple selection. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isSearchable:{description:"Enable search filtering. Default: true",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Flat array of tree items with parent references. Root items have parent: null, children reference parent value",items:{additionalProperties:!1,properties:{disabledInfo:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{description:"Tooltip content text",type:"string"},isMobileSupported:{description:"Show tooltip on mobile devices",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum tooltip height"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum tooltip width"}},required:["content"],type:"object"}],description:"Tooltip shown when item is disabled"},isDisabled:{description:"Disable this item",type:"boolean"},isLeaf:{description:"Marks the item as a leaf node",type:"boolean"},label:{description:"Display label for the item",type:"string"},parent:{anyOf:[{type:"string"},{type:"null"}],description:"Parent item value, null for root items"},secondaryLabel:{description:"Supporting text below the label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:'Label appearance (e.g., "primary", "error", "success")',type:"string"},text:{description:"Tag text to display",type:"string"}},required:["text"],type:"object"}],description:"Chip/tag to display next to the label"},value:{description:"Unique identifier for the item",type:"string"}},required:["label","value"],type:"object"},type:"array"},maxHeight:{description:"Maximum height of the tree list in pixels",type:"number"},selectionCount:{description:"Show count of selected items in multi-select mode",type:"boolean"},shouldExpandNodeOnSelection:{description:"Auto-expand node when selected. Default: false",type:"boolean"},shouldShowFolderStructure:{description:"Renders folder structure for tree items",type:"boolean"},size:{description:"Input size. Options: XS, S, M, L. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Tree theme for styling variants",enum:["NO_BORDER","NO_PADDING","REVERSE","NO_BOX"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name","list"],type:"object"},acceptsChildren:!1},FormTreeSelect:{description:"A Form-registered tree-select dropdown field for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},canSelectAll:{description:"Show select all toggle in multi mode",type:"boolean"},defaultSearchQuery:{description:"Default search input value",type:"string"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"},{type:"null"}],description:"Initial value set. Single string when isMulti is false, array when true"},dropdownWidth:{description:"Custom dropdown width in pixels",type:"number"},emptyListPlaceholder:{description:"Placeholder shown when list is empty",type:"string"},fuseOptions:{additionalProperties:{},description:'Fuse.js search configuration. Default: { keys: ["label", "name"] }',propertyNames:{type:"string"},type:"object"},hasIndependentActions:{description:"In multiSelect, action on an item does not affect selection of parent or child items",type:"boolean"},hasIndependentChildActions:{description:"Actions on child in multi select do not affect selection of ancestors",type:"boolean"},hasStaticParentNodes:{description:"Makes parent nodes non-actionable (only manage hierarchy)",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu will be open by default",type:"boolean"},isMulti:{description:"Allow multiple selection. Default: false",type:"boolean"},isPositionFixed:{description:"Sets dropdown position as fixed (relative to viewport)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Flat array of tree items with parent references. Root items have parent: null, children reference parent value",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disable this item",type:"boolean"},isLeaf:{description:"Marks the item as a leaf node",type:"boolean"},label:{description:"Display label for the item",type:"string"},parent:{anyOf:[{type:"string"},{type:"null"}],description:"Parent item value, null for root items"},secondaryLabel:{description:"Supporting text below the label",type:"string"},value:{description:"Unique identifier for the item",type:"string"}},required:["label","value"],type:"object"},type:"array"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Max height of tags container (CSS value)"},placeholder:{description:"Placeholder text when no selection",type:"string"},placement:{description:"Dropdown position. Default: bottom-end",enum:["top-start","top","top-end","right-start","right","right-end","bottom-end","bottom","bottom-start","left-end","left","left-start"],type:"string"},shouldExpandNodeOnSelection:{description:"Auto expands a node to show its children once selected. Default: false",type:"boolean"},shouldShowFolderStructure:{description:"Renders folder structure view",type:"boolean"},shouldShowSelectionPath:{description:"Show parent-to-child path in selected chips. Default: false",type:"boolean"},size:{description:"Input size. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Custom theme styling",enum:["NO_BOX"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name","list"],type:"object"},acceptsChildren:!1},FormWorkEmail:{description:"A Form-registered work email field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},domainList:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"},{items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this specific domain option",type:"boolean"},label:{description:"Display label for the domain option",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Optional semantic appearance for the tag",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text displayed with the domain option",type:"string"}},required:["text"],type:"object"}],description:"Optional tag shown with the domain option"},value:{description:"Domain option value",type:"string"}},required:["value"],type:"object"},type:"array"},{items:{additionalProperties:!1,properties:{label:{description:"Group label for a nested domain list",type:"string"},list:{description:"Grouped domain options",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this specific domain option",type:"boolean"},label:{description:"Display label for the domain option",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Optional semantic appearance for the tag",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text displayed with the domain option",type:"string"}},required:["text"],type:"object"}],description:"Optional tag shown with the domain option"},value:{description:"Domain option value",type:"string"}},required:["value"],type:"object"},type:"array"}},required:["label","list"],type:"object"},type:"array"}],description:'Email domain list for selection. Can be: single string, array of strings ["acme.com"], array of {label, value, tag?} objects (FlatList), or array of {label, list} objects (NestedList) for grouped domains'},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},Grid:{description:"A structured key-value grid for displaying labeled data fields with automatic responsive column sizing. Use for read-only detail views such as profile summaries, record details, or settings overviews. Supports action buttons for edit/delete operations on the displayed data.",events:["actionClick"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{actionClickedId:{description:"Stores the id of the clicked action. Bind to state path to access in actionClick event handler",type:"string"},actions:{description:"Array of action buttons displayed at the bottom of the grid. Each action emits actionClick event with id in state",items:{additionalProperties:!1,properties:{"aria-label":{description:"Accessibility label for the action button",type:"string"},"aria-labelledby":{description:"ID of element that labels the action button",type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},iconType:{description:'Icon type name (e.g., "EDIT_OUTLINE", "DELETE")',type:"string"},id:{description:"Unique identifier for this action. Written to state on click",type:"string"},isDisabled:{description:"Disable the action button. Default: false",type:"boolean"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Force tooltip to always be visible",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip"},placement:{description:"Tooltip placement position",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip for the action button. Can be a simple string or tooltip configuration object"}},required:["id","iconType"],type:"object"},type:"array"},list:{description:"Array of cells to display in the grid. Each cell has a label and renderer with props",items:{anyOf:[{additionalProperties:!1,properties:{label:{anyOf:[{type:"string"},{type:"number"}],description:"Label displayed in the cell header. String or number value"},props:{additionalProperties:!1,description:"Props passed to LabelRenderer. Icon colors must be Pebble text/icon color tokens.",properties:{appearance:{description:"Color scheme of the label. Default: NEUTRAL",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},children:{description:"Text content of the label",type:"string"},leftIcon:{anyOf:[{description:'Icon type name (e.g., "CHECK_CIRCLE_OUTLINE", "HIGH_PRIORITY")',type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token. Only applicable for TRANSPARENT appearance",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name",type:"string"}},required:["type"],type:"object"}],description:"Icon displayed on the left side of the label"},maxWidth:{description:"Maximum width CSS value for truncation",type:"string"},rightIcon:{anyOf:[{description:'Icon type name (e.g., "CHECK_CIRCLE_OUTLINE", "HIGH_PRIORITY")',type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token. Only applicable for TRANSPARENT appearance",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name",type:"string"}},required:["type"],type:"object"}],description:"Icon displayed on the right side of the label"},size:{description:"Size of the label. Default: LARGE",enum:["SMALL","MEDIUM","LARGE","EXTRA_LARGE"],type:"string"},text:{description:"Text content of the label. Converted to children for LabelRenderer.",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},className:{description:"CSS class name for tooltip",type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when document scrolls. Default: false",type:"boolean"},isDelayed:{description:"Add 300ms delay before showing tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning (relative to viewport). Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from parent component",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip content"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip content"},onlyIfChildOverflow:{description:"Only show tooltip if any child content overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if content overflows. Default: false",type:"boolean"},overwriteMiddleware:{description:"Overwrite default floating-UI middleware. Default: false",type:"boolean"},padding:{description:"CSS padding value for tooltip content",type:"string"},placement:{description:"Tooltip placement relative to label. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"},shallSkipOverflowY:{description:"Skip overflow check on Y axis. Default: false",type:"boolean"},tipHideDelay:{description:"Milliseconds to wait before hiding tooltip (when isDelayed is true)",type:"number"},tipShowDelay:{description:"Milliseconds to wait before showing tooltip (when isDelayed is true)",type:"number"},title:{description:"Tooltip title text",type:"string"},truncateClassName:{description:"CSS class when onlyIfOverflow is enabled",type:"string"}},required:["content"],type:"object"}],description:"Tooltip shown on hover. Can be simple string or object with appearance, placement, and other options"}},type:"object"},renderer:{const:"LABEL",description:"Renderer type for the cell value. LABEL renders a Label component.",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Force tooltip to always be visible",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip"},placement:{description:"Tooltip placement position",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip for the cell label. Can be a simple string or tooltip configuration object"}},required:["label","renderer","props"],type:"object"},{additionalProperties:!1,properties:{label:{anyOf:[{type:"string"},{type:"number"}],description:"Label displayed in the cell header. String or number value"},props:{additionalProperties:{},description:"Props passed to TextRenderer: { value, color? }. Color must be a Pebble text/icon color token.",properties:{color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Text value to display"}},required:["value"],type:"object"},renderer:{const:"TEXT",description:"Renderer type for the cell value. TEXT displays plain text. Default: TEXT",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Force tooltip to always be visible",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip"},placement:{description:"Tooltip placement position",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip for the cell label. Can be a simple string or tooltip configuration object"}},required:["label","props"],type:"object"}]},type:"array"},theme:{description:"Visual theme variant. NO_CARD removes card styling, TRANSPARENT uses transparent theme, NO_PADDING removes padding. Default: card with padding",enum:["NO_CARD","TRANSPARENT","NO_PADDING"],type:"string"}},required:["list"],type:"object"},acceptsChildren:!1},Heading:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{align:{description:"Text alignment",enum:["left","center","right"],type:"string"},color:{description:"Pebble text/icon color token resolved via the current theme.",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},decoration:{description:'Text decoration CSS value (e.g. "underline", "line-through")',type:"string"},inline:{description:"Display as inline element instead of block",type:"boolean"},level:{anyOf:[{const:1,type:"number"},{const:2,type:"number"},{const:3,type:"number"},{const:4,type:"number"},{const:5,type:"number"},{const:6,type:"number"}],description:"Heading level (h1=1, h2=2, h3=3, h4=4, h5=5, h6=6)"},lineClamp:{description:"Max visible lines before truncation with ellipsis",type:"number"},maxWidth:{description:"Maximum width CSS value for the text element",type:"string"},mono:{description:"Apply monospace font family",type:"boolean"},text:{description:"Heading text content",type:"string"},transform:{description:'Text transform CSS value (e.g. "uppercase", "capitalize")',type:"string"}},type:"object"},acceptsChildren:!1},Hidden:{description:"A hidden form input for passing fixed or derived values through form submission without any visible UI.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name used in form submission data",type:"string"},defaultValue:{description:"Initial value for uncontrolled usage",type:"string"},value:{description:"The value submitted with the form, bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},HStack:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{align:{description:"Cross-axis alignment",enum:["flex-start","center","flex-end","stretch","baseline"],type:"string"},alignSelf:{description:"Align self override when inside a flex parent",enum:["auto","flex-start","center","flex-end","stretch","baseline"],type:"string"},backgroundColor:{description:"Background surface color token",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},basis:{anyOf:[{type:"number"},{type:"string"}],description:"Flex basis value"},boxSizing:{description:"Box sizing model",enum:["content-box","border-box"],type:"string"},color:{description:"Text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},gap:{description:"Spacing token for gap between children",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},grow:{description:"Flex grow factor",type:"number"},height:{anyOf:[{type:"number"},{type:"string"}],description:"Height in pixels (number) or CSS string"},justify:{description:"Main-axis alignment",enum:["flex-start","center","flex-end","space-between","space-around","space-evenly"],type:"string"},margin:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Margin as a spacing token or directional spacing-token object {top, right, bottom, left}"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Max height in pixels or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Max width in pixels or CSS string"},minHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Min height in pixels or CSS string"},minWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Min width in pixels or CSS string"},overflow:{description:"Overflow behavior",enum:["visible","hidden","scroll","auto"],type:"string"},padding:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Padding as a spacing token or directional spacing-token object {top, right, bottom, left}"},radius:{description:"Border radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},shrink:{description:"Flex shrink factor",type:"number"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Width in pixels (number) or CSS string"},wrap:{description:"Flex wrap behavior",enum:["nowrap","wrap","wrap-reverse"],type:"string"}},type:"object"},acceptsChildren:!0},Icon:{description:"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.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{"aria-controls":{description:"ID of element controlled by this icon",type:"string"},"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-expanded":{description:"Indicates if controlled element is expanded",type:"boolean"},"aria-haspopup":{description:"Indicates the icon triggers a popup",enum:["true","false","menu","listbox","tree","grid","dialog"],type:"string"},"aria-label":{description:"Accessible label. Required when onClick is used",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},isDisabled:{description:"Disable the icon. Default: false",type:"boolean"},isFocused:{description:"Show icon backdrop when focused. Use only with interactive icons (onClick). Default: false",type:"boolean"},showCursor:{description:"Show pointer cursor and backdrop on hover. Use only with interactive icons (onClick). Default: false",type:"boolean"},size:{description:"Icon size token",enum:["sizeIcon2xl","sizeIcon2xs","sizeIcon3xl","sizeIcon3xs","sizeIcon4xl","sizeIconLg","sizeIconMd","sizeIconSm","sizeIconXl","sizeIconXs"],type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Max height in px or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Max width in px or CSS string"},placement:{description:"Tooltip placement. Default: BOTTOM",enum:["TOP_START","TOP","TOP_END","RIGHT_START","RIGHT","RIGHT_END","BOTTOM_START","BOTTOM","BOTTOM_END","LEFT_START","LEFT","LEFT_END"],type:"string"},title:{description:"Tooltip title text",type:"string"}},required:["content"],type:"object"}],description:"Tooltip. String for simple text, or object for advanced options"},type:{description:"Icon type string from Icon.TYPES (e.g. ADD, CHECK, CLOSE, EDIT_OUTLINE)",type:"string"}},required:["type"],type:"object"},acceptsChildren:!1},IconButton:{description:"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.",events:["press","pressWhileDisabled","mouseEnter","mouseLeave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Visual appearance style (PRIMARY, GHOST, OUTLINE, SOLID, DESTRUCTIVE, SUCCESS, INFO, WARNING, ACCENT, ACTIVE). Default: PRIMARY",enum:["PRIMARY","GHOST","OUTLINE","SOLID","DESTRUCTIVE","SUCCESS","INFO","WARNING","ACCENT","ACTIVE"],type:"string"},"aria-controls":{description:"ID of element controlled by the button",type:"string"},"aria-describedby":{description:"ID of element that describes the button",type:"string"},"aria-expanded":{description:"Indicates expanded state (for toggles)",type:"boolean"},"aria-haspopup":{anyOf:[{type:"boolean"},{type:"string"}],description:"Indicates the button opens a popup/menu"},"aria-label":{description:"Accessible label for the button. Required if aria-labelledby is not provided.",type:"string"},"aria-labelledby":{description:"ID of element that labels the button. Required if aria-label is not provided.",type:"string"},"aria-pressed":{anyOf:[{type:"boolean"},{const:"mixed",type:"string"}],description:"Indicates pressed state (for toggle buttons)"},icon:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type from Icon.TYPES",type:"string"}},required:["type"],type:"object"}],description:"Icon to display. Can be icon name string or object with type and color"},id:{description:"DOM id selector for the button element",type:"string"},isDisabled:{description:"If true, button is disabled. Default: false",type:"boolean"},shouldPreventFocus:{description:"If true, the button will not be focusable (tabIndex -1). Default: false",type:"boolean"},shouldShowSpinner:{description:"If true, shows loading spinner instead of icon",type:"boolean"},size:{description:"Size of the button (XS, S, M, L). Default: M",enum:["XS","S","M","L"],type:"string"},tabIndex:{description:"Tab order for keyboard navigation",type:"number"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Control tooltip visibility from parent",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max height (number in px or CSS string)"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max width (number in px or CSS string)"},placement:{description:"Tooltip placement relative to button. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip text or tooltip configuration object"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{description:"Open link in new tab. Default: false",type:"boolean"},path:{description:"URL path for navigation",type:"string"}},required:["path"],type:"object"}],description:"Navigation destination. When provided, button renders as anchor and handles navigation automatically"},type:{description:"HTML button type attribute (button, submit, reset). Default: button",enum:["button","submit","reset"],type:"string"}},required:["icon"],type:"object"},acceptsChildren:!1},Image:{description:"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.",events:["press","load","error"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alt:{description:"Alt text for accessibility. Required for screen readers",type:"string"},assetFilter:{description:"Apply dark mode filter for dark themes. Default: false",type:"boolean"},borderRadius:{description:'Border radius token, e.g. "shapeCornerMd"',enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},height:{anyOf:[{type:"number"},{type:"string"}],description:"Image height in px or CSS string"},loading:{description:"Loading strategy. Default: eager",enum:["eager","lazy"],type:"string"},src:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{dark:{type:"string"},light:{type:"string"}},type:"object"}],description:"Image URL or theme-aware source object with light/dark variants"},theme:{description:"Image theme. COVER for cover positioning",enum:["COVER"],type:"string"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Image width in px or CSS string"}},required:["alt"],type:"object"},acceptsChildren:!1},ImageViewer:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alt:{description:"Alt text for accessibility",type:"string"},imageUrl:{description:"URL of the image to display",type:"string"},maxHeightForExpandedImage:{description:"Max height for expanded image with CSS unit. Example: 80vh",type:"string"}},required:["imageUrl"],type:"object"},acceptsChildren:!1},InputGroup:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{input:{additionalProperties:!1,description:"Main input configuration with type and inputProps",properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},isDisabled:{description:"Disables all inputs in the group",type:"boolean"},isInvalid:{description:"Shows error styling on the group",type:"boolean"},isReadOnly:{description:"Makes all inputs in the group read-only",type:"boolean"},prefix:{anyOf:[{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},{items:{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},type:"array"}],description:"Prefix input configuration(s) prepended to the main input"},prefixMaxWidthPercent:{description:"Max width percentage for the prefix container",type:"number"},prefixMinWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum width for the prefix container"},shouldHideAddons:{description:"Hides prefix/suffix without destroying them",type:"boolean"},size:{description:"Size of all inputs in the group. Default: M",enum:["XS","S","M","L"],type:"string"},suffix:{anyOf:[{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},{items:{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},type:"array"}],description:"Suffix input configuration(s) appended to the main input"},suffixMaxWidthPercent:{description:"Max width percentage for the suffix container",type:"number"},suffixMinWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum width for the suffix container"}},required:["input"],type:"object"},acceptsChildren:!1},ItemNavigator:{description:'A compact control for stepping through items one at a time, with either an "X of Y items" label or clickable position dots. Use for sequential item-by-item navigation such as cycling through detail views, carousel items, search results, or review queues — not for page-based navigation (use Pagination instead).',events:["next","previous","select"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{currentItemIndex:{description:"Current item index (0-based). Range: 0 to totalItems-1",type:"number"},hasMore:{description:'Whether there are more items beyond totalItems. Shows "+" indicator',type:"boolean"},itemLabel:{description:'Singular form of item label used in button labels. Example: "vendor"',type:"string"},itemLabelPlural:{description:'Plural form of item label used in display text. Example: "vendors"',type:"string"},nextDisabled:{description:"Force-disable the next button, overriding default logic",type:"boolean"},nextTip:{description:"Tooltip text for the next button",type:"string"},prevDisabled:{description:"Force-disable the previous button, overriding default logic",type:"boolean"},prevTip:{description:"Tooltip text for the previous button",type:"string"},totalItems:{description:"Total number of items to navigate through",type:"number"},variant:{description:"Display style: LABEL shows the item count; DOTS shows clickable position dots",enum:["LABEL","DOTS"],type:"string"}},required:["totalItems","currentItemIndex","itemLabel","itemLabelPlural"],type:"object"},acceptsChildren:!1},Label:{description:'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.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Color scheme of the label. Default: NEUTRAL",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},leftIcon:{anyOf:[{description:'Icon type name (e.g., "CHECK_CIRCLE_OUTLINE", "HIGH_PRIORITY")',type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token. Only applicable for TRANSPARENT appearance",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name",type:"string"}},required:["type"],type:"object"}],description:"Icon displayed on the left side of the label"},maxWidth:{description:"Maximum width CSS value for truncation",type:"string"},rightIcon:{anyOf:[{description:'Icon type name (e.g., "CHECK_CIRCLE_OUTLINE", "HIGH_PRIORITY")',type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token. Only applicable for TRANSPARENT appearance",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name",type:"string"}},required:["type"],type:"object"}],description:"Icon displayed on the right side of the label"},size:{description:"Size of the label. Default: LARGE",enum:["SMALL","MEDIUM","LARGE","EXTRA_LARGE"],type:"string"},text:{description:"Text content of the label",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},className:{description:"CSS class name for tooltip",type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when document scrolls. Default: false",type:"boolean"},isDelayed:{description:"Add 300ms delay before showing tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning (relative to viewport). Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from parent component",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip content"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip content"},onlyIfChildOverflow:{description:"Only show tooltip if any child content overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if content overflows. Default: false",type:"boolean"},overwriteMiddleware:{description:"Overwrite default floating-UI middleware. Default: false",type:"boolean"},padding:{description:"CSS padding value for tooltip content",type:"string"},placement:{description:"Tooltip placement relative to label. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"},shallSkipOverflowY:{description:"Skip overflow check on Y axis. Default: false",type:"boolean"},tipHideDelay:{description:"Milliseconds to wait before hiding tooltip (when isDelayed is true)",type:"number"},tipShowDelay:{description:"Milliseconds to wait before showing tooltip (when isDelayed is true)",type:"number"},title:{description:"Tooltip title text",type:"string"},truncateClassName:{description:"CSS class when onlyIfOverflow is enabled",type:"string"}},required:["content"],type:"object"}],description:"Tooltip shown on hover. Can be simple string or object with appearance, placement, and other options"}},required:["text"],type:"object"},acceptsChildren:!1},LabelGroup:{description:'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.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{maxLinesToWrap:{description:"Maximum number of lines to display before showing overflow indicator. Labels beyond this wrap into an overflow modal. Default: no limit",type:"number"},overflowModalTitle:{description:'Title for the overflow modal that appears when labels exceed maxLinesToWrap. Default: "View All"',type:"string"}},type:"object"},acceptsChildren:!0},Layout:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{align:{description:"CSS align-items value for flex children alignment",type:"string"},alignSelf:{description:"CSS align-self value to override parent align",type:"string"},backgroundColor:{description:"Background surface color token",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},basis:{anyOf:[{type:"number"},{type:"string"}],description:"CSS flex-basis value"},border:{anyOf:[{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}]},{additionalProperties:!1,properties:{bottom:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Bottom border"},left:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Left border"},right:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Right border"},top:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Top border"}},type:"object"}],description:"Border. CSS string, strict token parts, or directional border object"},boxSizing:{description:"CSS box-sizing model",enum:["content-box","border-box"],type:"string"},color:{description:"Text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},direction:{description:"Flex direction. Default: row",enum:["row","column","row-reverse","column-reverse"],type:"string"},flex:{anyOf:[{type:"number"},{type:"string"}],description:"CSS flex shorthand"},gap:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{column:{description:"Column gap spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},row:{description:"Row gap spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Gap between children. Spacing token or {row, column} spacing-token object"},grow:{description:"CSS flex-grow value",type:"number"},height:{anyOf:[{type:"number"},{type:"string"}],description:"Element height. Number (px) or CSS string"},id:{description:"HTML id attribute",type:"string"},isInline:{description:"Use inline-flex display instead of flex",type:"boolean"},justify:{description:"CSS justify-content value for flex main-axis alignment",type:"string"},margin:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Margin. Spacing token or {left, right, top, bottom} spacing-token object"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height. Number (px) or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width. Number (px) or CSS string"},minHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum height. Number (px) or CSS string"},minWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum width. Number (px) or CSS string"},overflow:{description:"CSS overflow behavior",type:"string"},padding:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Padding. Spacing token or {left, right, top, bottom} spacing-token object"},position:{description:"CSS position value",type:"string"},radius:{anyOf:[{enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},{additionalProperties:!1,properties:{bottomLeft:{description:"Bottom-left corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},bottomRight:{description:"Bottom-right corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},topLeft:{description:"Top-left corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},topRight:{description:"Top-right corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"}},type:"object"}],description:"Border radius. Radius token or directional corner radius token object"},reverse:{description:"Reverse the flex direction",type:"boolean"},role:{description:"ARIA role for the container element",type:"string"},shrink:{description:"CSS flex-shrink value",type:"number"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Element width. Number (px) or CSS string"},wrap:{description:"CSS flex-wrap value",type:"string"},zIndex:{description:"CSS z-index stacking order",type:"number"}},type:"object"},acceptsChildren:!0},LayoutCard:{description:"A standard card container for creating card-based page layouts with configurable padding and an optional selectable theme for selection interfaces.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{fluid:{description:"When true, the card fills its parent width (including inside row layouts, where it would otherwise size to its content). Default: false",type:"boolean"},padding:{description:"Card padding size. Default: PX_24",enum:["PX_0","PX_8","PX_16","PX_24","PX_32"],type:"string"},theme:{description:"Card theme. SELECTABLE adds 2px tertiary border for selection UI. Default: DEFAULT",enum:["DEFAULT","SELECTABLE"],type:"string"}},type:"object"},acceptsChildren:!0},Link:{description:"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.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{"aria-controls":{description:"ID of element controlled by this link",type:"string"},"aria-current":{anyOf:[{type:"boolean"},{enum:["page","step","location","date","time"],type:"string"}],description:"Indicates current item within a set of items"},"aria-haspopup":{anyOf:[{type:"boolean"},{enum:["menu","listbox","tree","grid","dialog"],type:"string"}],description:"Indicates element triggers a popup or menu"},"aria-hidden":{description:"Hide element from accessibility tree",type:"boolean"},"aria-label":{description:"Accessibility label for the link",type:"string"},"aria-labelledby":{description:"ID of element that labels this link",type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},download:{anyOf:[{type:"string"},{type:"boolean"}],description:"Prompts download of the linked URL. Boolean true uses default filename, string sets custom filename"},href:{description:"URL to navigate to",type:"string"},rel:{description:'Relationship between current document and linked URL. Auto-set to "noopener noreferrer" when target is _blank',type:"string"},target:{description:"Link target (_blank or _self). Default: _self",enum:["_blank","_self"],type:"string"},text:{description:"Link text content",type:"string"},typestyle:{description:'Pebble typestyle token name for link text (e.g., "typestyleTitleSmall")',enum:["typestyleBodyLarge","typestyleBodyLarge500","typestyleBodyLarge600","typestyleBodyLargeEmphasized","typestyleBodyMedium","typestyleBodyMedium400","typestyleBodyMedium500","typestyleBodyMedium600","typestyleBodyMediumEmphasized","typestyleBodySmall","typestyleBodySmall400","typestyleBodySmall500","typestyleBodySmall600","typestyleBodySmallEmphasized","typestyleDisplayLarge","typestyleDisplayLarge600","typestyleDisplayMedium600","typestyleDisplaySmall600","typestyleLabelExtraLarge400","typestyleLabelExtraLarge500","typestyleLabelExtraLarge600","typestyleLabelExtraLarge700","typestyleLabelExtraSmall","typestyleLabelExtraSmallWide","typestyleLabelLarge","typestyleLabelLarge400","typestyleLabelLarge500","typestyleLabelLarge600","typestyleLabelMedium","typestyleLabelMedium500","typestyleLabelMedium600","typestyleLabelMedium700","typestyleLabelSmall","typestyleLabelSmall500","typestyleLabelSmall600","typestyleLabelSmallEmphasized","typestyleTitleExtraLarge600","typestyleTitleExtraSmall600Caps","typestyleTitleLarge","typestyleTitleLarge600","typestyleTitleMedium","typestyleTitleMedium600","typestyleTitleSmall","typestyleTitleSmall400","typestyleTitleSmall600","typestyleV2BodyLarge","typestyleV2BodyLargeEmphasized","typestyleV2BodyMedium","typestyleV2BodyMediumEmphasized","typestyleV2BodySmall","typestyleV2BodySmallEmphasized","typestyleV2DisplayLarge","typestyleV2LabelExtraSmall","typestyleV2LabelExtraSmallWide","typestyleV2LabelLarge","typestyleV2LabelMedium","typestyleV2LabelSmall","typestyleV2LabelSmallEmphasized","typestyleV2TitleLarge","typestyleV2TitleMedium","typestyleV2TitleSmall"],type:"string"}},required:["href"],type:"object"},acceptsChildren:!1},ListItem:{description:"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.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{caption:{description:"Secondary text below the title",type:"string"},shouldTruncateCaption:{description:"Truncate caption to single line. Default: true",type:"boolean"},title:{description:"Primary text content of the list item",type:"string"}},type:"object"},acceptsChildren:!1},LoaderCard:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{isGridView:{description:"Display with margin for grid layouts. Default: false",type:"boolean"}},type:"object"},acceptsChildren:!1},LocationCard:{description:"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.",events:["edit","delete","click","action"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{actions:{description:'Array of action objects {id, label, icon}. Displayed as dropdown options. Emits "action" event with clicked action id',items:{additionalProperties:!1,properties:{icon:{description:'Icon name from Icon.TYPES (e.g. "EDIT", "DELETE")',type:"string"},id:{description:"Unique identifier for the action",type:"string"},label:{description:"Label text for the action",type:"string"}},required:["id","label"],type:"object"},type:"array"},location:{additionalProperties:!1,description:"Location object with nickname and address. Required for displaying location information",properties:{address:{additionalProperties:!1,description:"Address object with street, city, state, country, and zip",properties:{city:{anyOf:[{type:"string"},{type:"null"}],description:"City name"},country:{description:"Country code",type:"string"},countyName:{anyOf:[{type:"string"},{type:"null"}],description:"County name"},state:{anyOf:[{type:"string"},{type:"null"}],description:"State or province code"},streetLine1:{description:"Primary street address line",type:"string"},streetLine2:{anyOf:[{type:"string"},{type:"null"}],description:"Secondary street address line"},streetLine3:{anyOf:[{type:"string"},{type:"null"}],description:"Tertiary street address line"},streetLine4:{anyOf:[{type:"string"},{type:"null"}],description:"Quaternary street address line"},zip:{description:"Postal/ZIP code",type:"string"}},required:["streetLine1","country","zip"],type:"object"},nickname:{description:"Location nickname or display name",type:"string"}},required:["nickname","address"],type:"object"},minCardHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum height of card. Number values are pixels. Default: 150"},selectedActionId:{description:'Bound state path for the selected action id. Written before "action" event fires',type:"string"},showDelete:{description:'Show delete button. Emits "delete" event when clicked. Default: false',type:"boolean"},showEdit:{description:'Show edit button. Emits "edit" event when clicked. Default: false',type:"boolean"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Route destination for navigation. String URL or object with {path, openInNewTab}. Card renders as anchor when provided"}},required:["location"],type:"object"},acceptsChildren:!1},LottiePlayer:{description:"Plays Lottie animations (JSON-based vector animations). Use for animated illustrations, loading states, or decorative motion graphics. Supports SVG, Canvas, and HTML rendering. Provide either a path to a Lottie JSON file or the animation data directly through loadConfig.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{height:{description:"Height of the animation container",type:"string"},loadConfig:{additionalProperties:!1,description:"Semantic Lottie load configuration object",properties:{animationData:{additionalProperties:{},description:"Lottie animation JSON object. Required if path is not provided",propertyNames:{type:"string"},type:"object"},autoplay:{description:"Start playing automatically on load. Default: true",type:"boolean"},loop:{anyOf:[{type:"boolean"},{type:"number"}],description:"Loop animation. true for infinite, false for once, or number for specific count"},path:{description:"URL or relative path to the Lottie JSON animation file. Required if animationData is not provided",type:"string"},renderer:{description:"Rendering method for the animation. Default: svg",enum:["svg","canvas","html"],type:"string"}},type:"object"},width:{description:"Width of the animation container",type:"string"}},type:"object"},acceptsChildren:!1},Masker:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-label":{description:"Accessible label when no visible label",type:"string"},autoComplete:{description:"Browser autocomplete hint. Default: off",type:"string"},autoFocus:{description:"Auto-focus input on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},fixedCharsPrefix:{description:"Fixes characters at the beginning of the value",type:"string"},fixedCharsSuffix:{description:"Fixes characters at the end of the value",type:"string"},id:{description:"Explicit HTML element id",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isSensitive:{description:"Marks input as sensitive for privacy/security",type:"boolean"},label:{description:"Label text above the input",type:"string"},mask:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:'Mask pattern. Use 9 for digit, a for letter, * for any character. Can be string ("999-999-9999") or array of patterns (["99.9a-999", "99.99/99-9"]) for multi-mask support'},maxLength:{description:"Maximum character length",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character length",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},shouldEnforceUpperCase:{description:"Enforces uppercase on input characters",type:"boolean"},shouldSkipInitialFormatting:{description:"If true, skip applying mask on the default/initial value",type:"boolean"},shouldUnmaskValue:{description:"If true, onChange passes the unmasked value (without mask characters)",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current masked value bound to state",type:"string"}},required:["mask"],type:"object"},acceptsChildren:!1},MenuList:{description:"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.",events:["select"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{enableSeparator:{description:"Show bottom border between items. Default: false",type:"boolean"},isCompact:{description:"Render in compact mode",type:"boolean"},list:{description:"Array of menu items with label, value, and optional fields (secondaryLabel, tertiaryLabel, quaternaryLabel, rightLabel, description, leftIconType, type, tag, disabledInfo)",items:{additionalProperties:!1,properties:{description:{description:"Description text shown inline with the label",type:"string"},disabledInfo:{description:"Tooltip text shown for disabled items",type:"string"},isDisabled:{description:"Disables this menu item",type:"boolean"},label:{description:"Display text for the menu item",type:"string"},leftIconType:{description:"Icon name to show on the left side of the item",type:"string"},quaternaryLabel:{description:"Quaternary text shown below tertiary label",type:"string"},rightLabel:{description:"Text shown on the right side of the item",type:"string"},secondaryLabel:{description:"Secondary text shown below the label",type:"string"},tag:{description:"Tag label shown beside the item text",type:"string"},tertiaryLabel:{description:"Tertiary text shown below secondary label",type:"string"},type:{description:"Visual style type for the item (WARNING or ALERT)",enum:["WARNING","ALERT"],type:"string"},value:{description:"Unique value for the item",type:"string"}},required:["label","value"],type:"object"},type:"array"},maxHeight:{description:"Max height of the menu list in px. Default: 224",type:"number"},maxWidth:{description:"Maximum width in px",type:"number"},minWidth:{description:"Minimum width in px",type:"number"},searchable:{description:"Enable search within the menu list",type:"boolean"},selectedValues:{description:"Array of selected item values for highlighting",items:{type:"string"},type:"array"},width:{anyOf:[{type:"number"},{const:"auto",type:"string"}],description:'Width of the menu list in px or "auto". Default: 192'}},required:["list"],type:"object"},acceptsChildren:!1},Modal:{description:"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.",events:["close"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{animation:{description:'Modal animation type (e.g., "zoom", "fade"). Default: zoom',type:"string"},backdropAnimation:{description:'Backdrop animation type (e.g., "fade"). Default: fade',type:"string"},isFullScreen:{description:"If true, modal renders full screen. Default: false",type:"boolean"},isVisible:{description:"Controls modal visibility",type:"boolean"},shouldCloseOnBackdropClick:{description:"If true, modal closes when backdrop is clicked. Default: true",type:"boolean"},shouldCloseOnEscape:{description:"If true, modal closes on Escape key press. Defaults to shouldCloseOnBackdropClick value",type:"boolean"},shouldHideCancelIcon:{description:"If true, hides the close button in the header. Default: false",type:"boolean"},shouldNotAnimate:{description:"Disables open/close animation. Should be true if DataGrid is rendered as content",type:"boolean"},theme:{description:"Pre-defined modal styles. GRAY: gray background. NO_PADDING: removes body padding",enum:["GRAY","NO_PADDING"],type:"string"},title:{description:"Modal header title text",type:"string"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Custom modal width in px (number) or CSS string"}},type:"object"},acceptsChildren:!0},ModalCloseButton:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Button visual style. Default: OUTLINE",enum:["ACCENT","ACTIVE","PRIMARY","DESTRUCTIVE","SUCCESS","INFO","WARNING","OUTLINE","SOLID","GHOST"],type:"string"},isDisabled:{description:"If true, disables the button. Default: false",type:"boolean"},label:{description:'Button label text. Default: "Cancel"',type:"string"},size:{description:"Button size. L, M, S, or XS. Default: M",enum:["L","M","S","XS"],type:"string"}},type:"object"},acceptsChildren:!1},ModalFooter:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{bottomSpacing:{description:"Custom bottom spacing token. Default: modal footer height",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},placement:{description:"Button alignment: right-aligned or space-between. Default: right",enum:["right","space-between"],type:"string"},shouldBeSticky:{description:"If true, the footer will be sticky at the bottom of the modal",type:"boolean"},shouldHaveStickyOffset:{description:"If true, adds offset for sticky positioning. Default: true",type:"boolean"}},type:"object"},acceptsChildren:!0},NestedList:{description:"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.",events:["toggle","select"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{depth:{description:"Current node depth in nested tree. Default: 0",type:"number"},indent:{description:"Indentation per nesting level in px. Default: 32",type:"number"},list:{description:"Array of nested tree items: {label, value?, branches?}",items:{$ref:"#/$defs/NestedListItem"},type:"array"},selectedValue:{description:"Currently selected item value. Bind to state for tracking",type:"string"},showMore:{additionalProperties:!1,description:"Configuration for show more behavior",properties:{size:{description:'Number of items to show initially before "show more"',type:"number"}},required:["size"],type:"object"},theme:{description:"ExpansionPanel theme variant",enum:["NO_CARD","TRANSPARENT_NO_SEPARATOR","TRANSPARENT_NO_SEPARATOR_NO_CARD"],type:"string"},title:{description:"Title for the nested list",type:"string"},toggleIcon:{additionalProperties:!1,description:"Toggle icon configuration",properties:{align:{description:"CSS alignSelf value. Default: center",type:"string"},margin:{description:"Margin spacing token for icon alignment",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},size:{description:"Icon size token. Default: 24",enum:["sizeIcon2xl","sizeIcon2xs","sizeIcon3xl","sizeIcon3xs","sizeIcon4xl","sizeIconLg","sizeIconMd","sizeIconSm","sizeIconXl","sizeIconXs"],type:"string"}},type:"object"}},required:["list"],type:"object"},acceptsChildren:!1},Number:{description:"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.",events:["change","blur","changeRaw","changeCalculationState"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},autoComplete:{description:'Browser autocomplete hint. Default: "off"',type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},decimalPlaces:{description:"Number of decimal places. Default: 2",type:"number"},defaultValue:{anyOf:[{type:"string"},{type:"number"}],description:"Initial default value for uncontrolled usage"},isDisabled:{description:"Disables the input",type:"boolean"},isIntegerOnly:{description:"Restrict to integer values only",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:'Locale string for number formatting (e.g. "en-US", "de-DE")',type:"string"},max:{description:"Maximum allowed value",type:"number"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},min:{description:"Minimum allowed value. Default: 0",type:"number"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text prefix inside the input",type:"string"},shouldAllowCalculation:{description:"If true, input allows arithmetic operators and evaluates on blur",type:"boolean"},shouldDisableFormatting:{description:"If true, number formatting will not be applied. Default: true",type:"boolean"},shouldDisableRedundantZeroFormatting:{description:"If true, redundant zeros are preserved. Default: true",type:"boolean"},shouldStripLeadingZeros:{description:"If true, leading zeros are stripped from the numeric value",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},step:{description:"Increment/decrement step size. Default: 1",type:"number"},stringPadding:{additionalProperties:!1,description:"Adds padding characters to the input value",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Position to pad (start or end)",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text suffix inside the input",type:"string"},theme:{description:"Predefined visual theme",enum:["DARK","INLINE_DATE_DAY","INLINE_DATE_MONTH","INLINE_DATE_YEAR","INLINE_SELECT_SEARCH","INLINE_TEXT","INLINE_TIME","INLINE_TIME_WITH_SECONDS","ITALIC_FONT","INLINE_SELECT_SEARCH_DARK","INLINE_SELECT_SEARCH_INLINE_DATE_DAY","INLINE_SELECT_SEARCH_INLINE_DATE_YEAR","INLINE_SELECT_SEARCH_INLINE_TEXT","INLINE_SELECT_SEARCH_ITALIC_FONT","NO_BOX","NO_BOX_INLINE_SELECT_SEARCH","NO_BOX_DARK","NO_BOX_INLINE_DATE_DAY","NO_BOX_INLINE_DATE_YEAR","NO_BOX_INLINE_TEXT","NO_BOX_ITALIC_FONT","NO_BOX_INLINE_SELECT_SEARCH_DARK","NO_BOX_INLINE_SELECT_SEARCH_INLINE_DATE_DAY","NO_BOX_INLINE_SELECT_SEARCH_INLINE_DATE_YEAR","NO_BOX_INLINE_SELECT_SEARCH_INLINE_TEXT","NO_BOX_INLINE_SELECT_SEARCH_ITALIC_FONT","NO_PADDING_NO_BOX_INLINE_SELECT_SEARCH","NO_PADDING_NO_BOX_INLINE_TIME","NO_PADDING_NO_BOX_INLINE_TIME_WITH_SECONDS","NO_PADDING_RIGHT_NO_BOX_DARK","NO_PADDING_NO_BOX_INLINE_DATE_MONTH","NO_PADDING_NO_BOX_INLINE_DATE_YEAR","NO_PADDING_RIGHT_NO_BOX_INLINE_TEXT","NO_PADDING_RIGHT_NO_BOX_ITALIC_FONT","NO_PADDING_RIGHT_NO_BOX_INLINE_SELECT_SEARCH_DARK","NO_PADDING_NO_BOX_INLINE_SELECT_SEARCH_INLINE_DATE","NO_PADDING_RIGHT_NO_BOX_INLINE_SELECT_SEARCH_INLINE_DATE_YEAR","NO_PADDING_RIGHT_NO_BOX_INLINE_SELECT_SEARCH_INLINE_TEXT","NO_PADDING_RIGHT_NO_BOX_INLINE_SELECT_SEARCH_ITALIC_FONT","NO_PADDING_LEFT_NO_BOX_INLINE_SELECT_SEARCH","NO_PADDING_LEFT_NO_BOX_DARK","NO_PADDING_NO_BOX_INLINE_DATE_DAY","NO_PADDING_LEFT_NO_BOX_INLINE_TEXT","NO_PADDING_LEFT_NO_BOX_ITALIC_FONT","NO_PADDING_LEFT_NO_BOX_INLINE_SELECT_SEARCH_DARK","NO_PADDING_LEFT_NO_BOX_INLINE_SELECT_SEARCH_INLINE_DATE_DAY","NO_PADDING_LEFT_NO_BOX_INLINE_SELECT_SEARCH_INLINE_TEXT","NO_PADDING_LEFT_NO_BOX_INLINE_SELECT_SEARCH_ITALIC_FONT","NO_PADDING_NO_BOX_INLINE_TEXT"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Current numeric value bound to state"}},type:"object"},acceptsChildren:!1},ObjectListView:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{objectApiName:{type:"string"}},required:["objectApiName"],type:"object"},acceptsChildren:!1},ObjectUI:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the header",properties:{icon:{description:"Icon type string when type is ICON",type:"string"},image:{description:"Image URL for the avatar",type:"string"},imageBackground:{description:"Surface color token for avatar image background",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},isRound:{description:"If false, square avatar is shown. Default: true",type:"boolean"},type:{description:"Avatar content type",enum:["USER","ICON","TEXT","NUMBER","RIPPLING"],type:"string"}},type:"object"},caption:{description:"Header caption text below the title",type:"string"},title:{description:"Header title text",type:"string"}},type:"object"},acceptsChildren:!0},ObjectUIContent:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!0},ObjectUIHeader:{description:"Header section of an entity overview (person, organization, device) displaying an avatar, title, caption, optional label chip, and an optional primary action. Used at the top of ObjectUI layouts to identify the entity at a glance.",events:["primaryAction"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the header",properties:{icon:{description:"Icon type string when type is ICON",type:"string"},image:{description:"Image URL for the avatar",type:"string"},imageBackground:{description:"Surface color token for avatar image background",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},isRound:{description:"If false, square avatar is shown. Default: true",type:"boolean"},type:{description:"Avatar content type",enum:["USER","ICON","TEXT","NUMBER","RIPPLING"],type:"string"}},type:"object"},caption:{description:"Header caption text below the title",type:"string"},label:{additionalProperties:!1,description:"Label chip displayed next to the title",properties:{appearance:{description:"Label appearance. Default: NEUTRAL",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},children:{description:"Label text displayed in the chip",type:"string"},leftIcon:{anyOf:[{description:"Icon type string to render inside the label",type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of the element describing the icon",type:"string"},"aria-label":{description:"Accessible label for the icon",type:"string"},"aria-labelledby":{description:"ID of the element labelling the icon",type:"string"},color:{description:"Optional icon color value",type:"string"},type:{description:"Icon type string to render inside the label",type:"string"}},required:["type"],type:"object"}],description:"Left icon shown inside the label"},maxWidth:{description:"Maximum label width as a CSS value",type:"string"},rightIcon:{anyOf:[{description:"Icon type string to render inside the label",type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of the element describing the icon",type:"string"},"aria-label":{description:"Accessible label for the icon",type:"string"},"aria-labelledby":{description:"ID of the element labelling the icon",type:"string"},color:{description:"Optional icon color value",type:"string"},type:{description:"Icon type string to render inside the label",type:"string"}},required:["type"],type:"object"}],description:"Right icon shown inside the label"},size:{description:"Label size. Default: LARGE",enum:["SMALL","MEDIUM","LARGE","EXTRA_LARGE"],type:"string"},tip:{description:"Tooltip text for the label. String tip content only in SDUI",type:"string"}},type:"object"},primaryAction:{additionalProperties:!1,description:"Primary action button. Clicking it emits the primaryAction event",properties:{icon:{description:"Icon type string for the primary button",type:"string"},label:{description:"Label of the primary button",type:"string"},size:{description:"Primary button size. Default: M",enum:["L","M","S","XS"],type:"string"}},required:["label"],type:"object"},primaryActionLabel:{description:"Deprecated. Use primaryAction.label instead for the primary action button text",type:"string"},title:{description:"Header title text",type:"string"}},type:"object"},acceptsChildren:!1},ObjectUIStats:{description:"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.",events:["actionClick"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{actionClickedId:{description:"Stores the id of the clicked action. Bind to state path to access in actionClick event handler",type:"string"},actions:{description:"Array of action buttons displayed at the bottom of the grid. Each action emits actionClick event with id in state",items:{additionalProperties:!1,properties:{"aria-label":{description:"Accessibility label for the action button",type:"string"},"aria-labelledby":{description:"ID of element that labels the action button",type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},iconType:{description:'Icon type name (e.g., "EDIT_OUTLINE", "DELETE")',type:"string"},id:{description:"Unique identifier for this action. Written to state on click",type:"string"},isDisabled:{description:"Disable the action button. Default: false",type:"boolean"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Force tooltip to always be visible",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip"},placement:{description:"Tooltip placement position",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip for the action button. Can be a simple string or tooltip configuration object"}},required:["id","iconType"],type:"object"},type:"array"},list:{description:"Array of cells to display in the stats grid. Each cell has a label and renderer with props",items:{anyOf:[{additionalProperties:!1,properties:{label:{anyOf:[{type:"string"},{type:"number"}],description:"Label displayed in the cell header. String or number value"},props:{additionalProperties:!1,description:"Props passed to LabelRenderer. Icon colors must be Pebble text/icon color tokens.",properties:{appearance:{description:"Color scheme of the label. Default: NEUTRAL",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},children:{description:"Text content of the label",type:"string"},leftIcon:{anyOf:[{description:'Icon type name (e.g., "CHECK_CIRCLE_OUTLINE", "HIGH_PRIORITY")',type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token. Only applicable for TRANSPARENT appearance",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name",type:"string"}},required:["type"],type:"object"}],description:"Icon displayed on the left side of the label"},maxWidth:{description:"Maximum width CSS value for truncation",type:"string"},rightIcon:{anyOf:[{description:'Icon type name (e.g., "CHECK_CIRCLE_OUTLINE", "HIGH_PRIORITY")',type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token. Only applicable for TRANSPARENT appearance",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name",type:"string"}},required:["type"],type:"object"}],description:"Icon displayed on the right side of the label"},size:{description:"Size of the label. Default: LARGE",enum:["SMALL","MEDIUM","LARGE","EXTRA_LARGE"],type:"string"},text:{description:"Text content of the label. Converted to children for LabelRenderer.",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},className:{description:"CSS class name for tooltip",type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when document scrolls. Default: false",type:"boolean"},isDelayed:{description:"Add 300ms delay before showing tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning (relative to viewport). Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from parent component",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip content"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip content"},onlyIfChildOverflow:{description:"Only show tooltip if any child content overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if content overflows. Default: false",type:"boolean"},overwriteMiddleware:{description:"Overwrite default floating-UI middleware. Default: false",type:"boolean"},padding:{description:"CSS padding value for tooltip content",type:"string"},placement:{description:"Tooltip placement relative to label. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"},shallSkipOverflowY:{description:"Skip overflow check on Y axis. Default: false",type:"boolean"},tipHideDelay:{description:"Milliseconds to wait before hiding tooltip (when isDelayed is true)",type:"number"},tipShowDelay:{description:"Milliseconds to wait before showing tooltip (when isDelayed is true)",type:"number"},title:{description:"Tooltip title text",type:"string"},truncateClassName:{description:"CSS class when onlyIfOverflow is enabled",type:"string"}},required:["content"],type:"object"}],description:"Tooltip shown on hover. Can be simple string or object with appearance, placement, and other options"}},type:"object"},renderer:{const:"LABEL",description:"Renderer type for the cell value. LABEL renders a Label component.",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Force tooltip to always be visible",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip"},placement:{description:"Tooltip placement position",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip for the cell label. Can be a simple string or tooltip configuration object"}},required:["label","renderer","props"],type:"object"},{additionalProperties:!1,properties:{label:{anyOf:[{type:"string"},{type:"number"}],description:"Label displayed in the cell header. String or number value"},props:{additionalProperties:{},description:"Props passed to TextRenderer: { value, color? }. Color must be a Pebble text/icon color token.",properties:{color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Text value to display"}},required:["value"],type:"object"},renderer:{const:"TEXT",description:"Renderer type for the cell value. TEXT displays plain text. Default: TEXT",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Force tooltip to always be visible",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip"},placement:{description:"Tooltip placement position",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip for the cell label. Can be a simple string or tooltip configuration object"}},required:["label","props"],type:"object"}]},type:"array"}},required:["list"],type:"object"},acceptsChildren:!1},ObjectUITemplate:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!0},PageAppLogo:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{isLogoRound:{description:"If true, logo image is displayed as a circle. Default: false",type:"boolean"},isUnderlined:{description:"If true, a line is added at the bottom. Default: false",type:"boolean"},logoUrl:{description:"URL for the logo image",type:"string"},size:{description:"Logo area width. STANDARD (936px) or FLUID (full width)",enum:["STANDARD","FLUID"],type:"string"},subtitle:{description:"Secondary text displayed below the title",type:"string"},supportLink:{description:"URL for a support/help link displayed next to the title",type:"string"},theme:{description:"Visual theme. NO_PADDING_TOP removes top padding",enum:["NO_PADDING_TOP"],type:"string"},title:{description:"Main title displayed in the app logo header",type:"string"}},required:["title"],type:"object"},acceptsChildren:!1},PageContent:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alignment:{description:"Content horizontal alignment within the page",enum:["CENTER","LEFT","RIGHT"],type:"string"},size:{description:"Maximum content width. 584, 776, 1160, 1544 (px) or FLUID for full width",enum:["584","776","1160","1544","FLUID"],type:"string"},theme:{description:"Layout adjustment: NO_BOTTOM_PADDING removes bottom padding, NO_MARGIN removes horizontal margins, PADDING_APP_NAV_BAR adds top padding to clear an app navigation bar",enum:["NO_BOTTOM_PADDING","NO_MARGIN","PADDING_APP_NAV_BAR"],type:"string"}},type:"object"},acceptsChildren:!0},PageFooter:{description:'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.',events:["continue"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{bottomSpacing:{description:"Bottom padding spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},continueBtnLabel:{description:'Label for the continue button. Default: "Continue"',type:"string"},isContinueDisabled:{description:"If true, the continue button is disabled. Default: false",type:"boolean"},shouldBeSticky:{description:"If true, footer is sticky at the bottom. Default: false",type:"boolean"},shouldHaveStickyOffset:{description:"If true, adds spacing above sticky footer to prevent content overlap. Default: true",type:"boolean"},stickyPosition:{description:"CSS position for sticky footer. Default: fixed",enum:["absolute","fixed"],type:"string"}},type:"object"},acceptsChildren:!0},PageHeader:{description:"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.",events:["action"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{actionClickedId:{description:"Bind to state to receive the clicked action ID when an action is clicked",type:"string"},actions:{description:"JSON-only extension for serializable button actions. React Page.Header actions is a ReactNode slot; this array renders Button actions and emits an action event on click.",items:{additionalProperties:!1,properties:{actionType:{description:"JSON-only extension. Type of action renderer. Default: button",enum:["button"],type:"string"},appearance:{description:"Button visual style. Default: PRIMARY",enum:["PRIMARY","DESTRUCTIVE","OUTLINE","GHOST","ACCENT","SUCCESS","INFO","WARNING"],type:"string"},icon:{description:"Icon name from Icon.TYPES (e.g. ADD, EDIT_OUTLINE)",type:"string"},id:{description:"Unique identifier for the action. Written to actionClickedId state on click",type:"string"},isDisabled:{description:"Disables the button. Default: false",type:"boolean"},label:{description:"Button text",type:"string"},size:{description:"Button size. Default: M",enum:["L","M","S","XS"],type:"string"},variant:{description:"Button variant. Default: NORMAL",enum:["NORMAL","TEXT"],type:"string"}},required:["id","label"],type:"object"},type:"array"},caption:{description:"Caption text displayed below the title",type:"string"},id:{description:"HTML id attribute for the title/caption container",type:"string"},shouldBeLeftAligned:{description:"If true, header is left-aligned instead of centered. Default: false",type:"boolean"},shouldBeUnderlined:{description:"If true, header has an underline",type:"boolean"},size:{description:"Maximum header width. 584, 776, 1160, 1544 (px) or FLUID for full width",enum:["584","776","1160","1544","FLUID"],type:"string"},theme:{description:"Visual theme. NO_MARGIN removes all margins, NO_TOP_MARGIN removes top margin only",enum:["NO_MARGIN","NO_TOP_MARGIN"],type:"string"},title:{description:"Title text for the page header",type:"string"}},type:"object"},acceptsChildren:!1},Paginate:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alignment:{description:"Alignment of pagination controls",enum:["LEFT","CENTER","RIGHT"],type:"string"},forcePage:{description:"Override selected page with parent control (0-indexed). Bind to state",type:"number"},initialPage:{description:"Initially selected page (0-indexed)",type:"number"},marginPagesDisplayed:{description:"Pages shown at start and end of pagination",type:"number"},pageCount:{description:"Total number of pages",type:"number"},pageRangeDisplayed:{description:"Range of pages displayed around current",type:"number"},theme:{description:"Visual style variant",enum:["NO_MARGIN"],type:"string"}},required:["pageCount"],type:"object"},acceptsChildren:!1},PaginateList:{description:"A paginated list that divides items across pages with built-in navigation controls. Use when displaying a client-side list that is too long for a single view and needs page-by-page browsing.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{initialPage:{description:"Initial page number to display (0-indexed)",type:"number"},list:{description:"JSON-only subset of the React list prop. Each item must have an id and label for the built-in renderer.",items:{additionalProperties:!1,properties:{id:{anyOf:[{type:"string"},{type:"number"}],description:"Unique identifier for the item"},label:{description:"Display text for the item",type:"string"}},required:["id","label"],type:"object"},type:"array"},pageSize:{description:"Number of items displayed per page. Default: 10",type:"number"}},required:["list"],type:"object"},acceptsChildren:!1},Pane:{description:"Define one adaptive pane",events:["collapsedChange","dismissedChange","committedSizeChange","presentationChange","headerAction","footerAction"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{adaptation:{description:"Ordered breakpoint-token rules for bottomDock, overlay, or hidden presentation.",items:{$ref:"#/$defs/PaneAdaptationRule"},type:"array"},ariaLabel:{description:"Accessible name for the pane region.",type:"string"},ariaLabelledBy:{description:"Space-separated element id list that labels the pane region.",type:"string"},body:{$ref:"#/$defs/PaneBodyDescriptor",description:"Body scrolling and padding behavior."},collapseControl:{description:"Authored Collapse and temporary Hide control location while open. Every collapsed Pane restores from the shared divider rail. Auto uses the header when present and the divider otherwise; header falls back to the divider when no header exists. Default: auto.",enum:["auto","header","divider"],type:"string"},collapsed:{description:"Controlled explicit collapsed state. Bind for SDUI controlled use.",type:"boolean"},collapsible:{description:"Enable explicit user collapse. Automatic adaptation remains independent. Default: false.",type:"boolean"},committedSize:{$ref:"#/$defs/PaneCommittedSize",description:"Controlled committed pixel size by orientation. Bind for SDUI controlled use."},controlTips:{$ref:"#/$defs/PaneControlTips",description:"Tooltip overrides for built-in Pane controls."},defaultCollapsed:{description:"Initial explicit collapsed state for uncontrolled use. Default: false.",type:"boolean"},defaultCommittedSize:{$ref:"#/$defs/PaneCommittedSize",description:"Initial committed pixel size by orientation for uncontrolled use."},defaultDismissed:{description:"Initial dismissed state for uncontrolled use. Default: false.",type:"boolean"},dismissControl:{description:"Authored dismiss control location. Auto uses the header when present and the divider otherwise; header also falls back to the divider when no header exists. Default: auto.",enum:["auto","header","divider"],type:"string"},dismissed:{description:"Controlled dismissed state. Bind for SDUI controlled use.",type:"boolean"},dismissible:{description:"Enable explicit user dismissal. Default: false.",type:"boolean"},footer:{$ref:"#/$defs/PaneFooterDescriptor",description:"Serializable fixed footer rendered outside the scrolling body."},footerActionId:{description:"JSON-only event metadata. Bind to receive the activated footer action id before footerAction emits.",type:"string"},header:{$ref:"#/$defs/PaneHeaderDescriptor",description:"Serializable fixed header descriptor rendered outside the scrolling body."},headerActionId:{description:"JSON-only event metadata. Bind to receive the activated header action id before headerAction emits.",type:"string"},id:{description:"Stable identifier, unique among direct siblings in one SplitPane.",type:"string"},pin:{description:"Pin to a logical edge and exclude this pane from priority collapse.",enum:["start","end"],type:"string"},presentation:{description:"JSON-only event metadata. Bind to receive the resolved presentation before presentationChange emits; this does not control presentation.",enum:["docked","collapsed","hidden","bottomDock","overlay"],type:"string"},priority:{description:"Retention priority: TERTIARY collapses first, then SECONDARY; PRIMARY remains open.",enum:["PRIMARY","SECONDARY","TERTIARY"],type:"string"},reflowSizing:{$ref:"#/$defs/PaneSizing",description:"Sizing descriptor used while the parent SplitPane is reflowed."},sizing:{$ref:"#/$defs/PaneSizing",description:"Docked sizing descriptor. Omit for equal fill sizing without implicit bounds."}},required:["id","priority"],type:"object"},acceptsChildren:!0},Password:{description:"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.",events:["change","blur","focus","click","keydown","keyup","paste","mouseenter","mouseleave","revealChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},shouldAllowReveal:{description:"Show password reveal toggle. Default: true",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},shrinkToPlaceholder:{description:"Input spans as much as its placeholder when true. Only applies when placeholder is visible",type:"boolean"},shrinkToValue:{description:"Input spans as much as its value when true. Only applies when value is present",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},theme:{description:"Theme name from Input.Password.THEMES or custom theme",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current password value bound to state",type:"string"}},type:"object"},acceptsChildren:!1},Percentage:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},allowNegative:{description:"Whether negative values are allowed. Default: false",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},decimalPlaces:{description:"Number of decimal places allowed. Default: 2",type:"number"},defaultValue:{description:"Default percentage value when uncontrolled",type:"number"},id:{description:"HTML id attribute for the input",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for percentage formatting (e.g. en-US)",type:"string"},lowerLimit:{description:"Minimum allowed percentage value",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},placeholder:{description:"Placeholder text when empty",type:"string"},shouldDisableFormatting:{description:"If true, percentage formatting will not be applied",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},step:{description:"Increment/decrement step size. Default: 1",type:"number"},upperLimit:{description:"Maximum allowed percentage value. Default: 100",type:"number"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Current percentage value bound to state"}},type:"object"},acceptsChildren:!1},Phone:{description:"A specialized input for entering and editing phone numbers with automatic region-based formatting, international support, and an optional country code dropdown selector.",events:["change","blur","focus","click","keydown","keyup","paste","mouseenter","mouseleave","countryCodeChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:'Browser autocomplete hint, e.g. "tel"',type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},countryCode:{anyOf:[{description:'Fixed country code prefix as a string, e.g. "91" or "1"',type:"string"},{additionalProperties:!1,description:"Country-code dropdown configuration preserving the serializable CountryCodeProp shape",properties:{name:{description:"Name for the country-code select input",type:"string"},"aria-describedby":{description:"ID of the element that describes the country-code dropdown",type:"string"},"aria-label":{description:"Accessible label for the country-code dropdown",type:"string"},"aria-labelledby":{description:"ID of the element that labels the country-code dropdown",type:"string"},canClear:{description:"Show clear button in the country-code dropdown",type:"boolean"},defaultSearchQuery:{description:"Initial search query for the country-code dropdown",type:"string"},defaultValue:{description:"Initial selected country code for the dropdown branch",type:"string"},dropdownHeight:{description:"Country-code dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while the dropdown list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query is entered",type:"string"},onNoSearchResults:{description:"Placeholder shown when no matching regions are found",type:"string"}},type:"object"}],description:"Placeholder shown when the country-code dropdown list is empty"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for the country-code dropdown",propertyNames:{type:"string"},type:"object"},id:{description:"HTML id attribute for the country-code select input",type:"string"},isDisabled:{description:"Disables the country-code dropdown",type:"boolean"},isMenuDefaultOpen:{description:"If true, the country-code dropdown opens by default",type:"boolean"},isPositionFixed:{description:"Position the country-code dropdown relative to the viewport",type:"boolean"},isReadOnly:{description:"Makes the country-code dropdown read-only",type:"boolean"},isRequired:{description:"Marks the country-code dropdown as required",type:"boolean"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Maximum dropdown height or chip container height as a CSS value"},placement:{description:"Country-code dropdown placement. Default: bottom-start",enum:["auto","auto-start","auto-end","top","top-start","top-end","bottom","bottom-start","bottom-end","right","right-start","right-end","left","left-start","left-end"],type:"string"},rows:{description:"Minimum row count for the country-code dropdown",type:"number"},scrollThreshold:{description:"Extra pixels rendered above and below the viewport in paginated mode",type:"number"},shouldFocusFirstElement:{description:"Auto-focus the first dropdown item when the menu opens",type:"boolean"},shouldShowSearchIcon:{description:"Show the search icon inside the country-code dropdown",type:"boolean"},shouldUsePortal:{description:"Render the country-code dropdown in a React portal",type:"boolean"},size:{description:"Country-code dropdown size. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Country-code dropdown theme variant",enum:["TRANSPARENT_BORDER","TOP_NAV","INLINE_TRANSPARENT_BORDER","INLINE_TOP_NAV","NO_PADDING_RIGHT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_RIGHT_NO_BOX_TOP_NAV","NO_PADDING_LEFT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_LEFT_NO_BOX_TOP_NAV"],type:"string"},value:{anyOf:[{type:"string"},{type:"null"}],description:"Controlled selected country code for the dropdown branch"}},type:"object"}],description:"Either a fixed country code string or a country-code dropdown configuration object"},countryCodeDefaultValue:{description:"[Deprecated] Use countryCode.defaultValue instead. Initial selected country code for the legacy dropdown shape",type:"string"},countryCodeValue:{description:"[Deprecated] Use countryCode.value instead. Bound selected country code for the legacy dropdown shape",type:"string"},defaultRegion:{description:'Default country region code for formatting, e.g. "US", "IN", "CA". Default: US',type:"string"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},fixedCharsPrefix:{description:"Fixed characters at the beginning of value",type:"string"},fixedCharsSuffix:{description:"Fixed characters at the end of value",type:"string"},id:{description:"HTML element ID",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isCountryCodeDisabled:{description:"[Deprecated] Use countryCode.isDisabled instead for the legacy dropdown shape",type:"boolean"},isCountryCodeReadOnly:{description:"[Deprecated] Use countryCode.isReadOnly instead for the legacy dropdown shape",type:"boolean"},isCountryCodeRequired:{description:"[Deprecated] Use countryCode.isRequired instead for the legacy dropdown shape",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isSensitive:{description:"Marks field as containing sensitive data",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},region:{description:"[Deprecated] Use defaultRegion instead. Region code for phone formatting",type:"string"},shouldAllowAutoFill:{description:"Allow browser autofill",type:"boolean"},shouldEnforceUpperCase:{description:"Enforce upper case input",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},shouldSkipInitialFormatting:{description:"Skip masking on default value",type:"boolean"},shouldStopEventPropagation:{description:"Stop automatic input focus when clicking container",type:"boolean"},shrinkToPlaceholder:{description:"Input spans as much as its placeholder when true. Only applies when placeholder is visible",type:"boolean"},shrinkToValue:{description:"Input spans as much as its value when true. Only applies when value is present",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},testId:{description:"Deprecated testing-only prop kept for backward compatibility",type:"string"},theme:{description:"Theme name from Input.Phone.THEMES or custom theme",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current phone number value bound to state",type:"string"}},type:"object"},acceptsChildren:!1},ProgressBar:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Visual appearance style",enum:["PRIMARY","SECONDARY","TERTIARY","ERROR","SUCCESS","WARNING","INFO"],type:"string"},"aria-describedby":{description:"ID of element that describes this progress bar",type:"string"},"aria-label":{description:"Accessibility label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this progress bar",type:"string"},"aria-valuetext":{description:"Human-readable text alternative for the current value",type:"string"},completedPercent:{description:"Progress percentage (0-100). Canonical ProgressBar value prop",maximum:100,minimum:0,type:"number"},isIndeterminate:{description:"Shows indeterminate loading animation",type:"boolean"},label:{description:"Deprecated compatibility prop for wrapper-level label text outside ProgressBar",type:"string"},showPercentage:{description:"Deprecated compatibility prop for wrapper-level percentage text outside ProgressBar",type:"boolean"},testId:{description:"Deprecated testing-only prop kept for backward compatibility. Default: progress-bar",type:"string"},value:{description:"Deprecated. Use completedPercent instead",maximum:100,minimum:0,type:"number"}},type:"object"},acceptsChildren:!1},ProgressSteps:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{isFluid:{description:"Steps take remaining space if true",type:"boolean"},isHorizontal:{description:"Renders steps horizontally if true",type:"boolean"},isNumeric:{description:"Shows numeric step indicators instead of icons",type:"boolean"},steps:{description:"Array of step configurations with title, subtitle, icon, hasError, and isDisabled",items:{additionalProperties:!1,properties:{hasError:{description:"Marks the step as having an error",type:"boolean"},icon:{description:"Icon type from Icon.TYPES to display for the step",type:"string"},isDisabled:{description:"Disables the step",type:"boolean"},subtitle:{description:"Subtitle text for the step",type:"string"},title:{description:"Title text for the step",type:"string"}},type:"object"},type:"array"},stepsCompleted:{description:"Number of steps completed, starting from 1. Default: 0",type:"number"}},required:["steps"],type:"object"},acceptsChildren:!1},Radio:{description:"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.",events:["change","blur","mouseenter","mouseleave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this radio group",type:"string"},"aria-label":{description:"Accessibility label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this radio group",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial value when uncontrolled"},hoveredValue:{description:"Value of currently hovered option, bound to state"},id:{description:"HTML id attribute for the radio group",type:"string"},isDisabled:{description:"Disables all radio options",type:"boolean"},isHorizontal:{description:"Arrange options in a row",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isReadOnly:{description:"Makes the radio group read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the radio group",type:"string"},list:{description:"Array of { label, value } option objects",items:{additionalProperties:!1,properties:{isActive:{description:"Controls focus state of the option",type:"boolean"},isDisabled:{description:"Disables this specific option",type:"boolean"},label:{description:"Display text for the option",type:"string"},secondaryLabel:{description:"Secondary text below the option label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance style",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},label:{description:"Tag label text",type:"string"}},required:["label"],type:"object"}],description:"Optional tag/label displayed with the option"},tip:{description:"Tooltip text shown on hover",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},theme:{description:"Theme styling: FLUID_WIDTH for full-width options, REVERSE for reversed theme",enum:["FLUID_WIDTH","REVERSE","FLUID_WIDTH_SPACE_BETWEEN_REVERSE"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Currently selected value bound to state"},variant:{description:"Visual variant: BOX for boxed layout, LIST for list layout, GRID for grid layout",enum:["BOX","LIST","GRID"],type:"string"}},type:"object"},acceptsChildren:!1},RangeSlider:{description:"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.",events:["change","beforeChange","afterChange","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},appearance:{description:"Visual appearance of the slider track. Default: PRIMARY",enum:["PRIMARY","ERROR","SUCCESS","WARNING"],type:"string"},"aria-describedby":{description:"ID of element that describes this slider",type:"string"},"aria-label":{description:"Accessibility label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this slider",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial range values [min, max] when uncontrolled. Default: [0, 100]",items:{type:"number"},maxItems:2,minItems:2,type:"array"},hideTooltip:{description:"Hides the value tooltips above the slider handles. Default: false",type:"boolean"},id:{description:"HTML id attribute for the range slider",type:"string"},isDisabled:{description:"Disables the slider. Default: false",type:"boolean"},isDotsVisible:{description:"Shows dots at each step position. Default: true",type:"boolean"},isReadOnly:{description:"Displays range as read-only text instead of interactive slider. Default: false",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the range slider",type:"string"},marks:{additionalProperties:{type:"string"},description:'Marks on slider as {position: label} object (e.g. {10: "10$", 50: "50$"})',propertyNames:{type:"number"},type:"object"},max:{description:"Maximum value of the slider range. Default: 100",type:"number"},min:{description:"Minimum value of the slider range. Default: 0",type:"number"},shouldShowMarker:{description:"Shows mark labels below the slider. Default: true",type:"boolean"},step:{anyOf:[{type:"number"},{type:"null"}],description:"Value increment/decrement per step. max-min should be evenly divisible by step. Set to null when using marks as steps. Default: 1"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current range values [min, max] bound to state",items:{type:"number"},maxItems:2,minItems:2,type:"array"}},type:"object"},acceptsChildren:!1},ReportLoader:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!1},Reports:{description:"Embeds a saved Rippling Analytics Report by id. Mounts the EmbeddedReport viewer in STANDALONE mode; the viewer owns fetch, loading, and 403–404 surfaces.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{reportId:{description:"Id of a saved Rippling Analytics Report. The viewer fetches the report and derives grid-vs-chart from its saved configuration.",type:"string"}},required:["reportId"],type:"object"},acceptsChildren:!1},ReportShareLoader:{description:"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).",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!1},ReportViewerLoader:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!1},ResizableBoard:{description:"A responsive 12-column grid for dashboard widgets that supports drag-to-rearrange and resize-from-any-corner. Use for user-curated dashboards where end-users decide which tiles appear where and how large they are. Each direct child element's spec id must match a `layouts[].identifier`; that layout entry controls the child's size and per-block styling.",events:["layoutChange","breakpointChange","dragStart","dragStop","resizeStart","resizeStop"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{blockShapeCorner:{description:'Shape-corner radius token applied to every block, e.g. "shapeCornerMd". Per-entry `layouts[].shapeCorner` overrides this for individual blocks.',enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},containerPadding:{description:"Padding inside the board container in pixels [x, y].",prefixItems:[{type:"number"},{type:"number"}],type:"array"},isStatic:{description:"Locks all blocks: disables both drag and resize together. Default: false.",type:"boolean"},layouts:{description:"Layout descriptor for each block. Every entry's `identifier` must match the spec id of one of the board's direct children — that's how a block is wired to its widget content. Optional `x`/`y` positions are respected; when omitted, the board auto-places blocks. Drag/resize will respect optional min/max bounds.",items:{additionalProperties:!1,properties:{border:{description:'CSS border applied to the block wrapper, e.g. "1px solid #E0E0E0".',type:"string"},height:{description:"Height in grid units. Default: 1",type:"number"},identifier:{description:"Unique identifier for this layout entry. MUST exactly match the spec id of one of the board's direct child elements — that child is rendered inside this block.",type:"string"},maxHeight:{description:"Maximum height in grid units",type:"number"},maxWidth:{description:"Maximum width in grid units",type:"number"},minHeight:{description:"Minimum height in grid units",type:"number"},minWidth:{description:"Minimum width in grid units. Default: 1",type:"number"},shadow:{description:'Shadow token applied to the block wrapper, e.g. "shadowSm".',enum:["shadow2xl","shadowLg","shadowMd","shadowNone","shadowSm","shadowXl","shadowXs"],type:"string"},shapeCorner:{description:'Shape-corner radius token for this block, e.g. "shapeCornerMd". Overrides the parent board `blockShapeCorner` for this entry only.',enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},width:{description:"Width in grid units (1–12). Default: 3",type:"number"},x:{description:"Horizontal position in grid units. Auto-calculated when omitted.",type:"number"},y:{description:"Vertical position in grid units. Auto-calculated when omitted.",type:"number"}},required:["identifier"],type:"object"},type:"array"},margin:{description:"Horizontal and vertical gutter between blocks in pixels. Default: [24, 24].",prefixItems:[{type:"number"},{type:"number"}],type:"array"},rowHeight:{description:"Pixel height of one vertical grid unit. Default: 100.",type:"number"}},required:["layouts"],type:"object"},acceptsChildren:!0},Responsive:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{above:{description:"Min-width breakpoint token. Children visible at this width and above (mobile-first). Do not use with below",enum:["breakpoint2xl","breakpointLg","breakpointMd","breakpointSm","breakpointXl"],type:"string"},below:{description:"Max-width breakpoint token. Children visible below this width (desktop-first). Do not use with above",enum:["breakpoint2xl","breakpointLg","breakpointMd","breakpointSm","breakpointXl"],type:"string"},mode:{description:"Whether to show or hide children at the breakpoint. Default: show",enum:["show","hide"],type:"string"},viewport:{description:"Use viewport media queries instead of shell container queries. Default: false",type:"boolean"}},type:"object"},acceptsChildren:!0},SegmentedControl:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},appearance:{description:"Visual style variant. Default: PRIMARY",enum:["PRIMARY","POSITIVE","NEGATIVE","NEUTRAL"],type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Initial value when uncontrolled"},isDisabled:{description:"Disables the entire control",type:"boolean"},isFluid:{description:"Stretches control to fill container width",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isMulti:{description:"Allows selecting multiple options",type:"boolean"},isReadOnly:{description:"Makes the control read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isVertical:{description:"Renders options in a vertical layout",type:"boolean"},label:{description:"Label text above the segmented control",type:"string"},list:{description:"Array of { label, value } option objects",items:{additionalProperties:!1,properties:{appearance:{description:"Visual style for this specific option",enum:["PRIMARY","POSITIVE","NEGATIVE","NEUTRAL"],type:"string"},"aria-label":{description:"Accessible label, required if label is not provided (e.g. for icon-only items)",type:"string"},icon:{description:"Icon to display for icon-only items. Requires aria-label or label for accessibility",type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},label:{description:"Display text for the option",type:"string"},tip:{additionalProperties:!1,description:"Tooltip to show on hover for this option",properties:{content:{description:"Tooltip text content",type:"string"}},required:["content"],type:"object"},value:{description:"Value stored when option is selected",type:"string"}},required:["value"],type:"object"},type:"array"},options:{description:"[Deprecated] Use list. Legacy alias for segmented control options",items:{additionalProperties:!1,properties:{appearance:{description:"Visual style for this specific option",enum:["PRIMARY","POSITIVE","NEGATIVE","NEUTRAL"],type:"string"},"aria-label":{description:"Accessible label, required if label is not provided (e.g. for icon-only items)",type:"string"},icon:{description:"Icon to display for icon-only items. Requires aria-label or label for accessibility",type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},label:{description:"Display text for the option",type:"string"},tip:{additionalProperties:!1,description:"Tooltip to show on hover for this option",properties:{content:{description:"Tooltip text content",type:"string"}},required:["content"],type:"object"},value:{description:"Value stored when option is selected",type:"string"}},required:["value"],type:"object"},type:"array"},rangeLabels:{additionalProperties:!1,description:"Labels to display at the start and end of the control range",properties:{end:{description:"Label at the end of the range",type:"string"},start:{description:"Label at the start of the range",type:"string"}},required:["start","end"],type:"object"},size:{description:"Control size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Currently selected value bound to state"}},required:["list"],type:"object"},acceptsChildren:!1},Select:{description:"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.",events:["change","blur","focus","paste","menuToggle"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this select",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this select",type:"string"},canClear:{description:"Show clear button to deselect all",type:"boolean"},canSelectAll:{description:"Show select-all toggle. Requires isMulti to be true",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},creatable:{description:"Allow creating new options not in the list",type:"boolean"},defaultSearchQuery:{description:"Initial search input value",type:"string"},defaultValue:{anyOf:[{items:{},type:"array"},{}],description:"Initial selected value or values when uncontrolled"},dropdownHeight:{description:"Sets dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query entered",type:"string"},onNoSearchResults:{description:"Placeholder when search returns no results",type:"string"}},type:"object"}],description:"Placeholder when dropdown list is empty. Can be string or object with state-specific placeholders"},footer:{additionalProperties:!1,description:"Fixed footer at bottom of dropdown menu",properties:{label:{description:"Footer link text",type:"string"},onClick:{description:"Event name to emit when footer is clicked",type:"string"}},required:["label","onClick"],type:"object"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing fuzzy search behavior",propertyNames:{type:"string"},type:"object"},id:{description:"HTML id attribute for the select input",type:"string"},isDisabled:{description:"Disables the select",type:"boolean"},isInvalid:{description:"Shows invalid styling on the select",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu will be open by default",type:"boolean"},isMulti:{description:"Allow multiple selections",type:"boolean"},isPositionFixed:{description:"Position dropdown relative to viewport instead of parent",type:"boolean"},isReadOnly:{description:"Makes the select read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isSearchable:{description:"Enable type-to-search filtering",type:"boolean"},label:{description:"Label text above the select",type:"string"},list:{anyOf:[{items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},{items:{additionalProperties:!1,properties:{isNestedMenu:{description:"Render the group as a nested submenu",type:"boolean"},label:{description:"Group label shown above its options",type:"string"},list:{description:"Options contained in this group",items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"}},required:["label","list"],type:"object"},type:"array"}],description:"Selectable options. Supports a flat array of options or a nested array of {label, list} groups"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Max height of multi-select container (CSS value)"},maxTruncationLines:{description:'Max rows of chips visible before "+X" overflow chip appears (multi-select only)',type:"number"},options:{anyOf:[{items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},{items:{additionalProperties:!1,properties:{isNestedMenu:{description:"Render the group as a nested submenu",type:"boolean"},label:{description:"Group label shown above its options",type:"string"},list:{description:"Options contained in this group",items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"}},required:["label","list"],type:"object"},type:"array"}],description:"Deprecated alias for list. Use list for new specs"},placeholder:{description:"Placeholder text when empty",type:"string"},placement:{description:"Dropdown position relative to input. Default: bottom-start",enum:["auto","auto-start","auto-end","top","top-start","top-end","bottom","bottom-start","bottom-end","right","right-start","right-end","left","left-start","left-end"],type:"string"},rows:{description:"Minimum number of rows to show",type:"number"},scrollThreshold:{description:"Extra pixels to render above/below viewport for smoother scrolling (pagination mode)",type:"number"},selectedOptionsModalClassName:{description:"CSS class for the modal showing all selected options (multi-select +X chip)",type:"string"},shouldFocusFirstElement:{description:"Auto-focus first menu item when dropdown opens",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix when isSearchable is true",type:"boolean"},shouldUsePortal:{description:"Render dropdown in a React Portal. Default: false",type:"boolean"},size:{description:"Select input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Visual theme variant for customized styling",enum:["TRANSPARENT_BORDER","TOP_NAV","INLINE_TRANSPARENT_BORDER","INLINE_TOP_NAV","NO_PADDING_RIGHT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_RIGHT_NO_BOX_TOP_NAV","NO_PADDING_LEFT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_LEFT_NO_BOX_TOP_NAV"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Currently selected value bound to state"}},type:"object"},acceptsChildren:!1},SelectableGroup:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input for screen readers",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input for screen readers",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{type:"string"},{type:"number"},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Initial selection when uncontrolled"},id:{description:"Unique DOM id for the input element",type:"string"},isDisabled:{description:"Disables all items in the group",type:"boolean"},isInvalid:{description:"Shows invalid styling on the group",type:"boolean"},isMulti:{description:"Allow multiple selection. Default: false",type:"boolean"},isReadOnly:{description:"Makes the group read-only",type:"boolean"},isRequired:{description:"Marks as required. In multi-select, prevents deselecting the last item",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Array of item objects to render as selectable cards",items:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},type:"array"},renderer:{description:"JSON-only constrained renderer choice: BASIC_CARD or LOCATION_CARD",enum:["BASIC_CARD","LOCATION_CARD"],type:"string"},testId:{description:"Deprecated testing-only prop kept for backward compatibility",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Selected value(s). Single value when isMulti is false, array when true"},valueIdentifier:{description:'Key name to extract unique value from each list item. Default: "value"',type:"string"}},required:["list","renderer"],type:"object"},acceptsChildren:!1},SelectableMenu:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{defaultValue:{description:"Initially selected value",type:"string"},isCompact:{description:"Render in compact mode",type:"boolean"},isDisabled:{description:"Disable the menu trigger",type:"boolean"},isScrollbarAlwaysVisible:{description:"Always show scrollbar in the menu list",type:"boolean"},list:{description:"Array of menu options: {label, value, isDisabled?}",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this option",type:"boolean"},label:{description:"Display text for the option",type:"string"},value:{description:"Unique value for the option",type:"string"}},required:["label","value"],type:"object"},type:"array"},maxHeight:{description:"Max height of the menu in px",type:"number"},placement:{description:"Menu position. Default: bottom-start",enum:["bottom-start","bottom","bottom-end","top-start","top","top-end"],type:"string"},searchable:{description:"Enable search within the menu",type:"boolean"},shouldAutoClose:{description:"Auto-close after item selection",type:"boolean"},shouldCloseOnScroll:{description:"Close dropdown on document scroll. Default: false",type:"boolean"},shouldScrollToSelectedValue:{description:"Auto-scroll to the selected value in the list",type:"boolean"},theme:{description:"Visual theme for the trigger. Available: BOLD",enum:["BOLD"],type:"string"},value:{description:"Currently selected value. Bind to state for selection tracking",type:"string"},virtualizeWhenItemCountExceeds:{description:"Virtualize the list when item count exceeds this number",type:"number"},width:{description:"Width of the menu in px. Default: 312",type:"number"}},required:["list"],type:"object"},acceptsChildren:!1},SettingsLoader:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{isCenter:{description:"Center the loader horizontally using auto margins. Default: false",type:"boolean"},margin:{anyOf:[{type:"string"},{type:"number"}],description:'Custom margin for the loader container. Accepts a CSS string (e.g. "16px") or a number (applied as px). Overrides default top margin when provided.'}},type:"object"},acceptsChildren:!1},ShowMore:{description:'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.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{buttonSize:{description:"Size of the show more/less toggle button",enum:["XS","S","M","L"],type:"string"},leftOffset:{description:"Left padding for the toggle button in pixels",type:"number"},showMoreSuffix:{description:'Suffix text appended to "Show all N" button text. Default: "items"',type:"string"},size:{description:"Number of items to show initially before requiring expansion. Default: 3",type:"number"}},type:"object"},acceptsChildren:!0},Signature:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial default signature value",type:"string"},id:{description:"Unique DOM element ID",type:"string"},isDisabled:{description:"Disables the signature input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isReadOnly:{description:"Shows signature image only, no input",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isTypeSignatureDisabled:{description:"Only show draw input, hide type input. Default: false",type:"boolean"},label:{description:"Label text above the input",type:"string"},penColor:{description:"Pen color token for drawing",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},placeholder:{description:"Placeholder text for the drawing area",type:"string"},typePlaceholder:{description:"Placeholder text for the type signature input",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Signature as base64 PNG data URL string",type:"string"}},type:"object"},acceptsChildren:!1},Sin:{description:'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.',events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-label":{description:"Accessible label when no visible label",type:"string"},autoComplete:{description:"Browser autocomplete hint. Default: off",type:"string"},autoFocus:{description:"Auto-focus input on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial unmasked SIN value",type:"string"},fixedCharsPrefix:{description:"Fixes characters at the beginning of the value",type:"string"},fixedCharsSuffix:{description:"Fixes characters at the end of the value",type:"string"},id:{description:"Explicit HTML element id",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character length",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character length",type:"number"},placeholder:{description:'Placeholder text. Default: "XXX XXX XXX"',type:"string"},shouldEnforceUpperCase:{description:"Enforces uppercase on input characters",type:"boolean"},shouldSkipInitialFormatting:{description:"If true, skip applying mask on the default/initial value",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Unmasked SIN value (9 digits, no spaces)",type:"string"}},type:"object"},acceptsChildren:!1},Skeleton:{description:"An animated placeholder that mimics the shape of content while it loads, available in text (lines), circle, and box variants.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{animation:{description:"Loading animation style. Default: wave",enum:["wave","pulse","none"],type:"string"},borderRadius:{description:"Border radius token (BOX variant)",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},gap:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{type:"string"},{type:"number"}],description:"Gap between lines when lines > 1 (TEXT variant). Spacing token, CSS string, or number. Default: 4px"},height:{anyOf:[{type:"number"},{type:"string"}],description:"Height in px or CSS string (BOX variant)"},initialTimestamp:{description:"Initial mount timestamp for animation delay calculation. Used to coordinate animations across multiple skeletons. Default: Date.now()",type:"number"},lineHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Line height of text skeleton for pixel-perfect match (TEXT variant). Default: 15px"},lines:{description:"Number of text lines (TEXT variant). Default: 1",type:"number"},show:{description:"Whether the skeleton is loading. true renders the skeleton, false renders nothing. Default: true",type:"boolean"},size:{anyOf:[{type:"number"},{type:"string"}],description:"Diameter in px or CSS string (CIRCLE variant). Default: 40"},variant:{description:"Skeleton shape variant. Default: text",enum:["text","circle","box"],type:"string"},width:{anyOf:[{type:"string"},{type:"number"}],description:"Width of the skeleton (number in px or CSS string)"}},type:"object"},acceptsChildren:!1},Slider:{description:"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.",events:["change","blur","beforeChange","afterChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},appearance:{description:"Sets slider appearance. Default: PRIMARY",enum:["PRIMARY","ERROR","SUCCESS","WARNING"],type:"string"},"aria-describedby":{description:"ID of element that describes this slider",type:"string"},"aria-label":{description:"Accessibility label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this slider",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial value when uncontrolled. Default: 0",type:"number"},hideTooltip:{description:"Hide the value tooltip. Default: false",type:"boolean"},isDisabled:{description:"Disables the slider",type:"boolean"},isDotsVisible:{description:"If true renders slider with dots. Default: true",type:"boolean"},isReadOnly:{description:"Makes the slider read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the slider",type:"string"},marks:{additionalProperties:{type:"string"},description:"Named marks on the slider track. Keys are numeric positions, values are labels",propertyNames:{type:"string"},type:"object"},max:{description:"Maximum value. Default: 100",type:"number"},min:{description:"Minimum value. Default: 0",type:"number"},shouldShowMarker:{description:"Controls visibility of marker. Default: true",type:"boolean"},step:{anyOf:[{type:"number"},{type:"null"}],description:"Step size between values. Set to null to use marks as steps. Default: 1"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current slider value bound to state",type:"number"}},type:"object"},acceptsChildren:!1},SnackBar:{description:"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.",events:["dismiss"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Snackbar appearance type. Default: INFO",enum:["SUCCESS","INFO","WARNING","ERROR"],type:"string"},canDismiss:{description:"Show dismiss button. Default: true",type:"boolean"},id:{description:"Unique identifier for the snackbar. Prevents duplicates and resets auto-dismiss timer on update",type:"string"},isVisible:{description:"Controls snackbar visibility. Bind to state to show/hide programmatically",type:"boolean"},metadata:{additionalProperties:{},description:'Arbitrary key/value context forwarded to the global SnackBar.onTrigger callback. Useful for analytics/logging (e.g. { source: "ProfilePage" })',propertyNames:{type:"string"},type:"object"},persist:{description:"If true, snackbar will not auto-close",type:"boolean"},text:{description:"Message text to display in the snackbar",type:"string"},title:{description:"Custom text for the dismiss button instead of close icon",type:"string"}},required:["text"],type:"object"},acceptsChildren:!1},Spinner:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alignment:{description:"Horizontal alignment. Default: CENTER",enum:["LEFT","CENTER","RIGHT"],type:"string"},appearance:{description:"Spinner color variant. Default: PRIMARY",enum:["PRIMARY","SECONDARY","TERTIARY","NEUTRAL","INVERSE"],type:"string"},description:{description:"Description text below the spinner",type:"string"},fixedWindowCentered:{description:"Fixed-positioned centered in browser viewport. Default: false",type:"boolean"},showAfter:{description:"Delay in milliseconds before spinner appears. Default: 0",type:"number"},size:{description:"Spinner size variant. Default: M",enum:["3XS","2XS","XS","S","M","L","XL"],type:"string"},title:{description:"Title text above the spinner",type:"string"},windowCentered:{description:"Absolutely centered within parent container. Default: false",type:"boolean"}},type:"object"},acceptsChildren:!1},SplitButton:{description:'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").',events:["press","dropdownChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Visual style variant. Ghost and Solid are not available. Default: PRIMARY",enum:["PRIMARY","ACCENT","OUTLINE","SUCCESS","INFO","DESTRUCTIVE","WARNING","ACTIVE"],type:"string"},dropdownList:{description:"List of items for the trailing dropdown menu",items:{additionalProperties:!1,properties:{label:{description:"Display text for the dropdown item",type:"string"},value:{description:"Value identifier for the dropdown item",type:"string"}},required:["label","value"],type:"object"},type:"array"},isDisabled:{description:"Disables both primary and trailing sections",type:"boolean"},isFluid:{description:"Expands button to full container width",type:"boolean"},label:{description:"Text content of the primary button section",type:"string"},size:{description:"Button size. Default: M",enum:["L","M","S","XS"],type:"string"},startIcon:{description:"Icon type from Icon.TYPES shown at start of primary section",type:"string"}},required:["label"],type:"object"},acceptsChildren:!1},SplitPane:{description:"Compose adaptive multi-pane layouts",events:["activePaneChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{activePaneId:{anyOf:[{type:"string"},{type:"null"}],description:"Controlled active pane id for single reflow. Bind for SDUI controlled use."},adaptation:{$ref:"#/$defs/SplitPaneAdaptation",description:"Container-driven priority collapse, reflow, and overflow behavior."},ariaLabel:{description:"Accessible name for the pane group.",type:"string"},ariaLabelledBy:{description:"Space-separated element id list that labels the pane group.",type:"string"},defaultActivePaneId:{description:"Initial active pane id for uncontrolled single reflow.",type:"string"},disableAnimation:{description:"Disable structural motion. Reduced-motion preferences always take precedence.",type:"boolean"},divider:{$ref:"#/$defs/SplitPaneDivider",description:"Divider line and resize-grip visibility."},gap:{description:"SDUI spacing-token name resolved to the numeric gutter size expected by React. Used when showGutter is true; default: space300.",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},id:{description:"Stable identifier for this pane group.",type:"string"},orientation:{description:"Main-axis layout direction. Default: horizontal.",enum:["horizontal","vertical"],type:"string"},persistence:{$ref:"#/$defs/SplitPanePersistence",description:"Selected uncontrolled pane state persisted by the group."},showGutter:{description:"Enable guttered Pane treatment. Default: false.",type:"boolean"}},required:["id"],type:"object"},acceptsChildren:!0},Ssn:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-label":{description:"Accessible label when no visible label",type:"string"},autoComplete:{description:"Browser autocomplete hint. Default: off",type:"string"},autoFocus:{description:"Auto-focus input on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial unmasked SSN value",type:"string"},fixedCharsPrefix:{description:"Fixes characters at the beginning of the value",type:"string"},fixedCharsSuffix:{description:"Fixes characters at the end of the value",type:"string"},id:{description:"Explicit HTML element id",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character length",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character length",type:"number"},placeholder:{description:'Placeholder text. Default: "XXX-XX-XXXX"',type:"string"},shouldEnforceUpperCase:{description:"Enforces uppercase on input characters",type:"boolean"},shouldSkipInitialFormatting:{description:"If true, skip applying mask on the default/initial value",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Unmasked SSN value (9 digits, no hyphens)",type:"string"}},type:"object"},acceptsChildren:!1},Status:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Semantic appearance: PRIMARY/TERTIARY for neutral information, SUCCESS for positive outcomes, ERROR for failures or critical issues, WARNING for preemptive alerts, DISABLED for inactive or non-current states.",enum:["PRIMARY","SUCCESS","ERROR","WARNING","TERTIARY","DISABLED"],type:"string"},outlined:{description:"When true, renders status with a border outline. Default: false",type:"boolean"},size:{description:"Size of the status indicator (S, M, L, XL). Default: L",enum:["S","M","L","XL"],type:"string"},text:{description:"Text label to display in the status indicator. Required.",type:"string"}},required:["text","appearance"],type:"object"},acceptsChildren:!1},Stepper:{description:"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.",events:["click"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{activeStepIndex:{description:"Index of the currently active step (0-based)",type:"number"},activeStepType:{description:"Type of active step. Default: NORMAL",enum:["NORMAL","STANDALONE"],type:"string"},"aria-describedby":{description:"ID of element that describes the stepper",type:"string"},"aria-label":{description:"Accessibility label for the stepper",type:"string"},"aria-labelledby":{description:"ID of element that labels the stepper",type:"string"},isCompact:{description:"Renders compact version with reduced spacing",type:"boolean"},standAloneSteps:{description:"Array of standalone step configurations, displayed separately from main steps",items:{additionalProperties:!1,properties:{avatar:{additionalProperties:!1,description:"Avatar configuration to display with the step. Supports image URLs",properties:{imageUrl:{description:"URL of the avatar image",type:"string"},type:{description:"Avatar type",enum:["ICON","RIPPLING","TEXT","USER","NUMBER"],type:"string"}},type:"object"},badge:{additionalProperties:!1,description:"Badge configuration to display alongside the step title",properties:{appearance:{description:"Badge color appearance",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},"aria-label":{description:"Accessibility label for the badge",type:"string"},text:{description:"Badge text content",type:"string"}},required:["text"],type:"object"},description:{description:"Optional step description",type:"string"},href:{description:"URL for the step. Renders the step as an anchor tag with this href (semantic HTML only)",type:"string"},status:{description:"Step status indicator",enum:["COMPLETE","ERROR","TODO","SKIPPED"],type:"string"},title:{description:"Step title text",type:"string"}},required:["title"],type:"object"},type:"array"},steps:{description:"Array of step configurations",items:{additionalProperties:!1,properties:{avatar:{additionalProperties:!1,description:"Avatar configuration to display with the step. Supports image URLs",properties:{imageUrl:{description:"URL of the avatar image",type:"string"},type:{description:"Avatar type",enum:["ICON","RIPPLING","TEXT","USER","NUMBER"],type:"string"}},type:"object"},badge:{additionalProperties:!1,description:"Badge configuration to display alongside the step title",properties:{appearance:{description:"Badge color appearance",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},"aria-label":{description:"Accessibility label for the badge",type:"string"},text:{description:"Badge text content",type:"string"}},required:["text"],type:"object"},description:{description:"Optional step description",type:"string"},href:{description:"URL for the step. Renders the step as an anchor tag with this href (semantic HTML only)",type:"string"},status:{description:"Step status indicator",enum:["COMPLETE","ERROR","TODO","SKIPPED"],type:"string"},title:{description:"Step title text",type:"string"}},required:["title"],type:"object"},type:"array"},testId:{description:"Test identifier for the stepper. Default: stepper",type:"string"}},required:["steps"],type:"object"},acceptsChildren:!1},SupportButton:{description:"A prominent card-like action button with title, caption, icon or image, and optional badge for dashboard entry points.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{badge:{description:"Badge indicator type shown on the avatar (NEGATIVE, WARNING, POSITIVE, NEUTRAL)",enum:["NEGATIVE","WARNING","POSITIVE","NEUTRAL"],type:"string"},caption:{description:"Secondary descriptive text below the title",type:"string"},icon:{description:"Icon type from Icon.TYPES. Default: HEADPHONES_FILLED",type:"string"},id:{description:"DOM id selector for the button element",type:"string"},image:{description:"Image URL displayed instead of an icon in the avatar",type:"string"},imageBackground:{description:"Surface color token for the avatar when using an image",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},title:{description:"Primary text label displayed on the button",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{description:"Open link in new tab. Default: false",type:"boolean"},path:{description:"URL path for navigation",type:"string"}},required:["path"],type:"object"}],description:"Navigation destination. When provided, button handles navigation automatically"}},required:["title"],type:"object"},acceptsChildren:!1},Survey:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},caption:{description:"Caption text displayed below the survey",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{anyOf:[{type:"string"},{type:"number"}]},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Initial selected value(s) when uncontrolled"},isDisabled:{description:"Disables all survey buttons",type:"boolean"},isInvalid:{description:"Marks the survey as invalid",type:"boolean"},isMulti:{description:"Allow multiple selections. Default: false",type:"boolean"},isReadOnly:{description:"Makes the survey read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isVertical:{description:"Stack options vertically. Default: false",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Array of survey option items with label and value",items:{additionalProperties:!1,properties:{icon:{description:"Pebble icon name displayed for the option",type:"string"},isDisabled:{description:"Disable this specific option",type:"boolean"},label:{anyOf:[{type:"string"},{type:"number"}],description:"Display label for the option"},selectionColor:{description:"Override selected surface color token for this option",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Value when selected"}},required:["value"],type:"object"},type:"array"},rangeLabels:{additionalProperties:!1,description:"Labels for lowest and highest options",properties:{lower:{description:"Label for the lowest option",type:"string"},upper:{description:"Label for the highest option",type:"string"}},required:["lower","upper"],type:"object"},theme:{description:"Survey theme. TWO_LINE stacks label below value",enum:["TWO_LINE"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{anyOf:[{type:"string"},{type:"number"}]},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Selected value(s). Single value when isMulti is false, array when true"}},required:["list"],type:"object"},acceptsChildren:!1},Switch:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the switch",type:"string"},"aria-label":{description:"ARIA label for accessibility",type:"string"},"aria-labelledby":{description:"ARIA labelledby reference",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},compact:{description:"Use compact size variant",type:"boolean"},defaultValue:{description:"Initial toggle state when uncontrolled",type:"boolean"},isDisabled:{description:"Disables the switch",type:"boolean"},isReadOnly:{description:"Makes the switch read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the switch",type:"string"},offLabel:{description:"Label text when switch is off",type:"string"},onLabel:{description:"Label text when switch is on",type:"string"},rightAlign:{description:"Align switch to the right",type:"boolean"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{description:"Tooltip text content",type:"string"},placement:{description:"Tooltip placement relative to the switch",enum:["top","top-start","top-end","right","right-start","right-end","bottom","bottom-start","bottom-end","left","left-start","left-end","auto","auto-start","auto-end"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip text or basic tooltip configuration to display"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Toggle state bound to state",type:"boolean"}},type:"object"},acceptsChildren:!1},Tab:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{activeIndex:{description:"Controlled active tab index",type:"number"},"aria-label":{description:"Accessible label for the tabs",type:"string"},"aria-labelledby":{description:"ID of element that labels the tabs",type:"string"},defaultActiveIndex:{description:"Tab index to be active by default",type:"number"},isCompact:{description:"Use compact spacing",type:"boolean"},isLogoRound:{description:"Whether to display logo with rounded corners",type:"boolean"},isVertical:{description:"Display tabs in vertical orientation (only for LINK type)",type:"boolean"},items:{description:"JSON-only selection model for state-bound tabs with title, value, and optional icon/badge/tip",items:{additionalProperties:!1,properties:{badge:{additionalProperties:!1,description:"Badge to display on the tab",properties:{appearance:{description:"Badge appearance variant: INFO_DARK, INFO_LIGHT, ERROR_DARK, ERROR_LIGHT, PRIMARY_DARK, PRIMARY_LIGHT, SUCCESS_DARK, SUCCESS_LIGHT, WARNING_DARK, WARNING_LIGHT, NEUTRAL, BLACK",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},text:{description:"Text to display in the badge",type:"string"}},required:["text"],type:"object"},href:{description:"Semantic href for LINK tabs; navigation is prevented by Pebble Tabs",type:"string"},icon:{description:"Icon name for the tab (e.g., FOLDER_OUTLINE)",type:"string"},isDisabled:{description:"Whether this tab is disabled",type:"boolean"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{description:"Tip content text",type:"string"},testId:{description:"Test ID for the tip",type:"string"}},required:["content"],type:"object"}],description:"Tooltip to show on hover"},title:{description:"Display text for the tab",type:"string"},value:{description:"JSON-only tab value stored when the tab changes"}},required:["title","value"],type:"object"},type:"array"},list:{description:"React Tabs list branch for LINK tabs, including optional nested links",items:{additionalProperties:!1,properties:{badge:{additionalProperties:!1,description:"Badge to display on the link tab",properties:{appearance:{description:"Badge appearance variant: INFO_DARK, INFO_LIGHT, ERROR_DARK, ERROR_LIGHT, PRIMARY_DARK, PRIMARY_LIGHT, SUCCESS_DARK, SUCCESS_LIGHT, WARNING_DARK, WARNING_LIGHT, NEUTRAL, BLACK",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},text:{description:"Text to display in the badge",type:"string"}},required:["text"],type:"object"},links:{description:"Nested link tabs for vertical LINK tabs",items:{additionalProperties:!1,properties:{badge:{additionalProperties:!1,description:"Badge to display on the nested link tab",properties:{appearance:{description:"Badge appearance variant: INFO_DARK, INFO_LIGHT, ERROR_DARK, ERROR_LIGHT, PRIMARY_DARK, PRIMARY_LIGHT, SUCCESS_DARK, SUCCESS_LIGHT, WARNING_DARK, WARNING_LIGHT, NEUTRAL, BLACK",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},text:{description:"Text to display in the badge",type:"string"}},required:["text"],type:"object"},title:{description:"Display text for the nested link tab",type:"string"}},required:["title"],type:"object"},type:"array"},title:{description:"Display text for the link-style tab",type:"string"}},required:["title"],type:"object"},type:"array"},logoUrl:{description:"URL of logo image to display with title",type:"string"},stretchH:{description:"Stretch tabs horizontally",type:"boolean"},stretchV:{description:"Stretch tabs vertically to fill available height",type:"boolean"},subtitle:{description:"Subtitle text",type:"string"},supportLink:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{href:{description:"URL for the support/help link",type:"string"},icon:{description:"Pebble icon name for the support link",type:"string"},text:{description:"Visible support link text override",type:"string"}},type:"object"}],description:"Support/help link as a URL string or a serializable object branch"},theme:{description:"Visual theme: BOX, BOX_HEADER, CENTER, GREY_OVERFLOW_GRADIENT, WHITE_OVERFLOW_GRADIENT, NO_PADDING",enum:["BOX","BOX_HEADER","CENTER","GREY_OVERFLOW_GRADIENT","WHITE_OVERFLOW_GRADIENT","NO_PADDING"],type:"string"},title:{description:"Title text to display above tabs",type:"string"},titleContent:{description:"Subtitle or additional content below the title",type:"string"},type:{description:"Visual style: BASIC, SWITCH, LINK, or SWITCH_WITH_ICON_ONLY",enum:["BASIC","SWITCH","LINK","SWITCH_WITH_ICON_ONLY"],type:"string"},value:{description:"JSON-only selected tab value metadata bound to state when using items"},width:{description:"Width of the tab container in pixels",type:"number"}},type:"object"},acceptsChildren:!1},TableBasic:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{columns:{description:"JSON-only table abstraction: column definitions {header, key, align?, width?, wrapText?}",items:{additionalProperties:!1,properties:{align:{description:"Text alignment for this column",enum:["left","center","right"],type:"string"},header:{description:"Column header text",type:"string"},key:{description:"Key to look up cell value in each row object",type:"string"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Column width in px (number) or CSS string"},wrapText:{description:"Whether to wrap text in cells of this column. Default: false (nowrap)",type:"boolean"}},required:["header","key"],type:"object"},type:"array"},rowHeight:{description:"Custom height in px for all table rows",type:"number"},rows:{description:"JSON-only table abstraction: row objects keyed by column key",items:{additionalProperties:{anyOf:[{type:"string"},{type:"number"},{type:"boolean"},{type:"null"}]},propertyNames:{type:"string"},type:"object"},type:"array"},title:{description:"Title displayed above the table",type:"string"},width:{description:"Table container width in px",type:"number"}},required:["columns","rows"],type:"object"},acceptsChildren:!1},Text:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{align:{description:"Text alignment",enum:["left","center","right"],type:"string"},as:{description:'HTML element to render (e.g. "p", "span", "div", "pre"). Default: p',type:"string"},color:{description:"Pebble text/icon color token resolved via the current theme.",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},decoration:{description:'Text decoration CSS value (e.g. "underline", "line-through")',type:"string"},inline:{description:"Display as inline element instead of block",type:"boolean"},lineClamp:{description:"Max visible lines before truncation with ellipsis",type:"number"},maxWidth:{description:'Maximum width CSS value for the text element (e.g. "200px", "50%")',type:"string"},mono:{description:"Apply monospace font family",type:"boolean"},text:{description:"Text content",type:"string"},transform:{description:'Text transform CSS value (e.g. "uppercase", "capitalize", "lowercase")',type:"string"},typestyle:{description:'Pebble typestyle token name (e.g. "typestyleBodyMedium"). Default: typestyleBodyMedium',enum:["typestyleBodyLarge","typestyleBodyLarge500","typestyleBodyLarge600","typestyleBodyLargeEmphasized","typestyleBodyMedium","typestyleBodyMedium400","typestyleBodyMedium500","typestyleBodyMedium600","typestyleBodyMediumEmphasized","typestyleBodySmall","typestyleBodySmall400","typestyleBodySmall500","typestyleBodySmall600","typestyleBodySmallEmphasized","typestyleDisplayLarge","typestyleDisplayLarge600","typestyleDisplayMedium600","typestyleDisplaySmall600","typestyleLabelExtraLarge400","typestyleLabelExtraLarge500","typestyleLabelExtraLarge600","typestyleLabelExtraLarge700","typestyleLabelExtraSmall","typestyleLabelExtraSmallWide","typestyleLabelLarge","typestyleLabelLarge400","typestyleLabelLarge500","typestyleLabelLarge600","typestyleLabelMedium","typestyleLabelMedium500","typestyleLabelMedium600","typestyleLabelMedium700","typestyleLabelSmall","typestyleLabelSmall500","typestyleLabelSmall600","typestyleLabelSmallEmphasized","typestyleTitleExtraLarge600","typestyleTitleExtraSmall600Caps","typestyleTitleLarge","typestyleTitleLarge600","typestyleTitleMedium","typestyleTitleMedium600","typestyleTitleSmall","typestyleTitleSmall400","typestyleTitleSmall600","typestyleV2BodyLarge","typestyleV2BodyLargeEmphasized","typestyleV2BodyMedium","typestyleV2BodyMediumEmphasized","typestyleV2BodySmall","typestyleV2BodySmallEmphasized","typestyleV2DisplayLarge","typestyleV2LabelExtraSmall","typestyleV2LabelExtraSmallWide","typestyleV2LabelLarge","typestyleV2LabelMedium","typestyleV2LabelSmall","typestyleV2LabelSmallEmphasized","typestyleV2TitleLarge","typestyleV2TitleMedium","typestyleV2TitleSmall"],type:"string"}},type:"object"},acceptsChildren:!1},Textarea:{description:"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.",events:["change","blur","focus","keydown"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this textarea",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this textarea",type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},hasCharsLimit:{description:"Show character count indicator. Requires maxLength to be set",type:"boolean"},height:{description:"Fixed height in pixels",type:"number"},id:{description:"Unique DOM id for the textarea element",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxHeight:{description:"Maximum height in pixels",type:"number"},maxLength:{description:"Maximum character count. Default: 10000",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},rows:{description:"Number of visible text rows",type:"number"},theme:{description:"Visual theme variant",enum:["NO_BOX"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current text value bound to state",type:"string"}},type:"object"},acceptsChildren:!1},TextAutoSuggest:{description:"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.",events:["change","blur","focus","click"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint. Default: off",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{type:"string"},{type:"number"}],description:"Initial value when uncontrolled"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing suggestion filtering",propertyNames:{type:"string"},type:"object"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isPositionFixed:{description:"Use fixed positioning for dropdown menu. Useful in scrollable containers",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Array of { label, value } suggestion objects matching the React list prop",items:{additionalProperties:!1,properties:{label:{description:"Display text for the suggestion",type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Value stored when suggestion is selected"}},required:["label","value"],type:"object"},type:"array"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},shouldAllowAutoFill:{description:"Allow browser autofill",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},shouldShowMenuOnFocus:{description:"Show dropdown menu on input focus. Default: false",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix. Default: false",type:"boolean"},shouldStopEventPropagation:{description:"Stop automatic input focus when clicking container",type:"boolean"},shrinkToPlaceholder:{description:"Input spans as much as its placeholder when true. Only applies when placeholder is visible",type:"boolean"},shrinkToValue:{description:"Input spans as much as its value when true. Only applies when value is present",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},theme:{description:"Theme name from Input.Text.THEMES or custom theme",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Current value bound to state"}},type:"object"},acceptsChildren:!1},TextClip:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{buttonLabels:{additionalProperties:!1,description:"Labels for the expand and collapse buttons",properties:{collapse:{description:"Label for the collapse button. Default: Show less",type:"string"},expand:{description:"Label for the expand button. Default: Show more",type:"string"}},required:["expand","collapse"],type:"object"},maxHeight:{description:"Max height in px before content is clipped and expand/collapse is shown",type:"number"},theme:{description:"Visual theme variant. NO_CARD removes the card styling",enum:["NO_CARD"],type:"string"}},required:["maxHeight"],type:"object"},acceptsChildren:!0},TextInput:{description:"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.",events:["change","blur","focus","click","keydown","keyup","paste","mouseenter","mouseleave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-activedescendant":{description:"ID of active descendant",type:"string"},"aria-autocomplete":{description:"ARIA autocomplete state",enum:["none","inline","list","both"],type:"string"},"aria-controls":{description:"ID of controlled element",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-details":{description:"ID of element with additional details",type:"string"},"aria-expanded":{description:"ARIA expanded state",type:"boolean"},"aria-haspopup":{description:"ARIA haspopup state",enum:["true","false","menu","listbox","tree","grid","dialog"],type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},"aria-required":{description:"ARIA required state",type:"boolean"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},canClear:{description:"Show clear button",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},role:{description:"ARIA role",type:"string"},shouldAllowAutoFill:{description:"Allow browser autofill",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},shouldStopEventPropagation:{description:"Stop automatic input focus when clicking container",type:"boolean"},shrinkToPlaceholder:{description:"Input spans as much as its placeholder when true. Only applies when placeholder is visible",type:"boolean"},shrinkToValue:{description:"Input spans as much as its value when true. Only applies when value is present",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},theme:{description:"Theme name from Input.Text.THEMES or custom theme",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current text value bound to state",type:"string"}},type:"object"},acceptsChildren:!1},TextSnippet:{description:'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. Accepts either a plain "content" string or arbitrary children for rich/formatted content.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{content:{description:"Plain text content to display in the snippet. Omit and pass children instead when the snippet needs rich content (formatting, inline highlights, etc.)",type:"string"},fileName:{description:"File name for download type. Default: rippling.txt",type:"string"},showFullContent:{description:"Show full content without truncation. Default: false",type:"boolean"},type:{description:"Snippet action type. Default: Copy",enum:["Copy","Download"],type:"string"},wordBreak:{description:"CSS word-break value for content. Default: break-all",type:"string"}},type:"object"},acceptsChildren:!0},Time:{description:"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.",events:["change","blur","inferredTimeChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},alwaysShowTimezone:{description:"If true, timezone abbreviation will always be shown. Default: false",type:"boolean"},"aria-describedby":{description:"ARIA describedby reference for accessibility",type:"string"},"aria-label":{description:"ARIA label for accessibility",type:"string"},"aria-labelledby":{description:"ARIA labelledby reference for accessibility",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultSelectionStartTime:{description:'Time to start the selection scroll from when shouldAllowTimeSelection is true (e.g. "08:00 AM")',type:"string"},defaultValue:{description:"Initial time value when uncontrolled",type:"string"},id:{description:"HTML id attribute for the input",type:"string"},inferredTime:{anyOf:[{type:"string"},{type:"null"}],description:"JSON-only inferred time metadata written before inferredTimeChange emits"},isDateTimeInline:{description:"Make input inline, removes border, padding and width fits input/placeholder content",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Marks the input as invalid",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for time formatting (e.g. en-US)",type:"string"},maxWidth:{description:"Maximum width CSS value",type:"string"},pickClosestMeridiem:{description:"When user does not enter AM/PM, pick the closest meridiem to the inputted hour value. Default: false",type:"boolean"},referenceDate:{description:"ISO date string used as reference for timezone calculations and DST determination. Defaults to current date.",type:"string"},shouldAllowTimeSelection:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{reference:{description:"Reference ISO time for period labels",type:"string"}},type:"object"}],description:"Show a time selection dropdown for picking times"},shouldDisplaySeconds:{description:"Display seconds in the time input",type:"boolean"},shouldFormatInTimezone:{description:"If true, values will transform according to global timezone when timezone prop is not passed explicitly",type:"boolean"},shouldLocalize:{description:"If true, display format will be determined from user locale setting",type:"boolean"},shouldReturnISO:{description:"Always return value in ISO 8601 format",type:"boolean"},shouldShowTimezoneLabel:{description:"If false, timezone label will not be shown. Default: true",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Custom theme to apply to the input",type:"string"},timezone:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{name:{description:"Input name for the timezone selector",type:"string"},isRequired:{description:"Marks the timezone selector as required",type:"boolean"},value:{description:"Selected timezone value",type:"string"}},required:["name"],type:"object"}],description:"Show time relative to this timezone or configure the timezone selector"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Time value bound to state (ISO 8601 or HH:mm format)",type:"string"}},type:"object"},acceptsChildren:!1},TimeRange:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input. Default: TimeRange",type:"string"},alwaysShowTimezone:{description:"If true, timezone abbreviation will always be shown",type:"boolean"},"aria-describedby":{description:"ARIA describedby reference for accessibility",type:"string"},"aria-label":{description:"ARIA label for accessibility",type:"string"},"aria-labelledby":{description:"ARIA labelledby reference for accessibility",type:"string"},canClear:{description:"Shows a clear icon button to reset both time values to empty",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultSelectionStartTime:{description:'Time to start the selection scroll from when shouldAllowTimeSelection is true (e.g. "08:00 AM")',type:"string"},defaultValue:{description:"Initial time range when uncontrolled [startTime, endTime]",prefixItems:[{anyOf:[{type:"string"},{type:"null"}]},{anyOf:[{type:"string"},{type:"null"}]}],type:"array"},hideDayDifference:{description:"Hides the next day indicator when end time is on the next day. Default: false (indicator is shown)",type:"boolean"},hideTimeIcon:{description:"Hides the prefix clock icon in the input. Default: false",type:"boolean"},id:{description:"HTML id attribute for the input",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Marks the input as invalid",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for time formatting (e.g. en-US)",type:"string"},referenceDate:{description:"ISO date string used as reference for timezone calculations and DST determination. Defaults to current date.",type:"string"},shouldAllowTimeSelection:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{reference:{description:"Reference ISO time for period labels",type:"string"}},type:"object"}],description:"Show a time selection dropdown for picking times. Default: true"},shouldDisplaySeconds:{description:"Display seconds in the time inputs",type:"boolean"},shouldFormatInTimezone:{description:"If true, values will transform according to global timezone when timezone prop is not passed explicitly. Default: true",type:"boolean"},shouldLocalize:{description:"If true, display format will be determined from user locale setting",type:"boolean"},theme:{description:"Custom theme to apply to the input",type:"string"},timezone:{description:"Show times relative to this timezone (IANA identifier, e.g. America/New_York)",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Time range value bound to state [startTime, endTime]. Each time must be an ISO 8601 string with UTC offset",prefixItems:[{anyOf:[{type:"string"},{type:"null"}]},{anyOf:[{type:"string"},{type:"null"}]}],type:"array"}},type:"object"},acceptsChildren:!1},Timezone:{description:"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.",events:["change","blur","focus"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},canClear:{description:"Shows a clear button to reset selection",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial IANA timezone identifier",type:"string"},displayIANA:{description:"Display IANA timezone name. Default: true",type:"boolean"},displayShortFormat:{description:"Display timezone abbreviation",type:"boolean"},dropdownHeight:{description:"Height of the dropdown menu in pixels",type:"number"},emptyListPlaceholder:{description:"Placeholder text shown when no timezone matches the search",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isMenuDefaultOpen:{description:"If true, the dropdown menu will be open by default on mount",type:"boolean"},isPositionFixed:{description:"Use fixed positioning for dropdown (useful in scrollable containers)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isSearchable:{description:"Enables search filtering. Default: true",type:"boolean"},label:{description:"Label text above the input",type:"string"},placeholder:{description:"Placeholder text when empty",type:"string"},placement:{description:"Dropdown placement position. Default: BOTTOM_START",enum:["TOP_START","TOP","TOP_END","RIGHT_START","RIGHT","RIGHT_END","BOTTOM_END","BOTTOM","BOTTOM_START","LEFT_END","LEFT","LEFT_START"],type:"string"},referenceDate:{description:"ISO 8601 date string to determine timezone offsets (e.g. 2024-01-15T12:00:00Z)",type:"string"},shouldShowSearchIcon:{description:"If true, shows a search icon in the dropdown",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Visual theme variant for the input",enum:["TRANSPARENT_BORDER","TOP_NAV","INLINE_TRANSPARENT_BORDER","INLINE_TOP_NAV","NO_PADDING_RIGHT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_RIGHT_NO_BOX_TOP_NAV","NO_PADDING_LEFT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_LEFT_NO_BOX_TOP_NAV"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"IANA timezone identifier bound to state (e.g. America/New_York)",type:"string"}},type:"object"},acceptsChildren:!1},Tip:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Tooltip theme. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when the document is scrolled. Default: false",type:"boolean"},isDelayed:{description:"Add delay before showing/hiding the tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning for the tooltip. Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from parent. Overrides hover behavior when set",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Max height of tooltip content. Number in px or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Max width of tooltip. Number in px or CSS string. Default: 360"},onlyIfChildOverflow:{description:"Only show tooltip if a child element overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if the trigger element overflows. Default: false",type:"boolean"},placement:{description:"Tooltip position relative to child. Default: bottom",enum:["top","top-start","top-end","bottom","bottom-start","bottom-end","left","left-start","left-end","right","right-start","right-end"],type:"string"},tipHideDelay:{description:"Custom delay in ms before tooltip hides",type:"number"},tipShowDelay:{description:"Custom delay in ms before tooltip appears",type:"number"},title:{description:"Optional bold title above tooltip content",type:"string"}},required:["content"],type:"object"},acceptsChildren:!0},TitleCaption:{description:"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.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{caption:{description:"Secondary caption text displayed below the title in body-small typestyle. Accepts string only.",type:"string"},captionColor:{description:"Pebble text/icon color token for the caption text. Default: theme colorOnSurfaceVariant",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},title:{description:"Primary title text displayed in body-large typestyle",type:"string"}},required:["title"],type:"object"},acceptsChildren:!1},ToggleableArrow:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{"aria-controls":{description:"ARIA controls attribute linking the arrow to the element it controls",type:"string"},"aria-describedby":{description:"References another element ID to use as the accessible description",type:"string"},"aria-label":{description:"Accessible label for the arrow button",type:"string"},"aria-labelledby":{description:"References another element ID to use as the accessible label",type:"string"},arrowDownColor:{description:"Color of the arrow when pointing down (collapsed state). Defaults to colorOnSurfaceVariant.",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},arrowUpColor:{description:"Color of the arrow when pointing up (expanded state). Defaults to colorPrimary.",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},horizontalCollapsedPosition:{description:"When true, the arrow icon is in horizontal position when collapsed. Default: false",type:"boolean"},isArrowDown:{description:"Controls whether the arrow points down (collapsed). Default: true",type:"boolean"},isDisabled:{description:"When true, disables the arrow and prevents interaction",type:"boolean"},isFocused:{description:"When true, renders the icon in focused state",type:"boolean"},showCursor:{description:"When true, shows a pointer cursor on hover. Default: true",type:"boolean"},size:{description:"Icon size token. Default: 24",enum:["sizeIcon2xl","sizeIcon2xs","sizeIcon3xl","sizeIcon3xs","sizeIcon4xl","sizeIconLg","sizeIconMd","sizeIconSm","sizeIconXl","sizeIconXs"],type:"string"}},type:"object"},acceptsChildren:!1},Tree:{description:"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.",events:["change","footerAction"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this tree",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this tree",type:"string"},canSelectAll:{description:"Show select all toggle in multi mode",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Initial selected value(s) when uncontrolled"},dropdownWidth:{description:"Override internal dropdown width in pixels",type:"number"},emptyListPlaceholder:{description:"Placeholder text when list is empty",type:"string"},footer:{additionalProperties:!1,description:"Fixed footer with clickable action at bottom of tree",properties:{label:{description:"Footer button text",type:"string"}},required:["label"],type:"object"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing search behavior",propertyNames:{type:"string"},type:"object"},hasIndependentActions:{description:"In multiSelect, action on an item does not affect selection of parent or child items",type:"boolean"},hasIndependentChildActions:{description:"Actions on child in multi select do not affect selection of ancestors",type:"boolean"},hasStaticParentNodes:{description:"Makes parent nodes non-actionable (only manage hierarchy)",type:"boolean"},id:{description:"HTML id attribute for accessibility",type:"string"},isDisabled:{description:"Disables the tree input",type:"boolean"},isMulti:{description:"Allow multiple selection. Default: false",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isSearchable:{description:"Enable search filtering. Default: true",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Flat array of tree items with parent references. Root items have parent: null, children reference parent value",items:{additionalProperties:!1,properties:{disabledInfo:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{description:"Tooltip content text",type:"string"},isMobileSupported:{description:"Show tooltip on mobile devices",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum tooltip height"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum tooltip width"}},required:["content"],type:"object"}],description:"Tooltip shown when item is disabled"},isDisabled:{description:"Disable this item",type:"boolean"},isLeaf:{description:"Marks the item as a leaf node",type:"boolean"},label:{description:"Display label for the item",type:"string"},parent:{anyOf:[{type:"string"},{type:"null"}],description:"Parent item value, null for root items"},secondaryLabel:{description:"Supporting text below the label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:'Label appearance (e.g., "primary", "error", "success")',type:"string"},text:{description:"Tag text to display",type:"string"}},required:["text"],type:"object"}],description:"Chip/tag to display next to the label"},value:{description:"Unique identifier for the item",type:"string"}},required:["label","value"],type:"object"},type:"array"},maxHeight:{description:"Maximum height of the tree list in pixels",type:"number"},selectionCount:{description:"Show count of selected items in multi-select mode",type:"boolean"},shouldExpandNodeOnSelection:{description:"Auto-expand node when selected. Default: false",type:"boolean"},shouldShowFolderStructure:{description:"Renders folder structure for tree items",type:"boolean"},size:{description:"Input size. Options: XS, S, M, L. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Tree theme for styling variants",enum:["NO_BORDER","NO_PADDING","REVERSE","NO_BOX"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Selected value(s). Single string when isMulti is false, array when true"}},required:["list"],type:"object"},acceptsChildren:!1},TreeSelect:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes the input",type:"string"},"aria-label":{description:"Accessible label for the input",type:"string"},"aria-labelledby":{description:"ID of element that labels the input",type:"string"},canSelectAll:{description:"Show select all toggle in multi mode",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultSearchQuery:{description:"Default search input value",type:"string"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"},{type:"null"}],description:"Initial value set. Single string when isMulti is false, array when true"},dropdownWidth:{description:"Custom dropdown width in pixels",type:"number"},emptyListPlaceholder:{description:"Placeholder shown when list is empty",type:"string"},fuseOptions:{additionalProperties:{},description:'Fuse.js search configuration. Default: { keys: ["label", "name"] }',propertyNames:{type:"string"},type:"object"},hasIndependentActions:{description:"In multiSelect, action on an item does not affect selection of parent or child items",type:"boolean"},hasIndependentChildActions:{description:"Actions on child in multi select do not affect selection of ancestors",type:"boolean"},hasStaticParentNodes:{description:"Makes parent nodes non-actionable (only manage hierarchy)",type:"boolean"},id:{description:"HTML id attribute",type:"string"},isDisabled:{description:"Disables the tree select",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu will be open by default",type:"boolean"},isMulti:{description:"Allow multiple selection. Default: false",type:"boolean"},isPositionFixed:{description:"Sets dropdown position as fixed (relative to viewport)",type:"boolean"},isReadOnly:{description:"Makes the tree select read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Flat array of tree items with parent references. Root items have parent: null, children reference parent value",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disable this item",type:"boolean"},isLeaf:{description:"Marks the item as a leaf node",type:"boolean"},label:{description:"Display label for the item",type:"string"},parent:{anyOf:[{type:"string"},{type:"null"}],description:"Parent item value, null for root items"},secondaryLabel:{description:"Supporting text below the label",type:"string"},value:{description:"Unique identifier for the item",type:"string"}},required:["label","value"],type:"object"},type:"array"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Max height of tags container (CSS value)"},placeholder:{description:"Placeholder text when no selection",type:"string"},placement:{description:"Dropdown position. Default: bottom-end",enum:["top-start","top","top-end","right-start","right","right-end","bottom-end","bottom","bottom-start","left-end","left","left-start"],type:"string"},selectedOptionsModalClassName:{description:"Class name for selected options modal (multi-select only)",type:"string"},shouldExpandNodeOnSelection:{description:"Auto expands a node to show its children once selected. Default: false",type:"boolean"},shouldShowFolderStructure:{description:"Renders folder structure view",type:"boolean"},shouldShowSelectionPath:{description:"Show parent-to-child path in selected chips. Default: false",type:"boolean"},size:{description:"Input size. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Custom theme styling",enum:["NO_BOX"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"},{type:"null"}],description:"Selected value(s). Single string when isMulti is false, array when true"}},required:["list"],type:"object"},acceptsChildren:!1},Video:{description:"Embedded video player with 16:9 aspect ratio",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Name attribute for the iframe element",type:"string"},allowFullScreen:{description:"Allow fullscreen mode. Default: true",type:"boolean"},loading:{description:"Iframe loading strategy. Default: eager",enum:["eager","lazy"],type:"string"},src:{description:"Video URL or embed URL (e.g. YouTube, Vimeo)",type:"string"},width:{description:"Width of the video player in pixels. Default: 912",type:"number"}},required:["src"],type:"object"},acceptsChildren:!1},VStack:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{align:{description:"Cross-axis alignment",enum:["flex-start","center","flex-end","stretch","baseline"],type:"string"},alignSelf:{description:"Align self override when inside a flex parent",enum:["auto","flex-start","center","flex-end","stretch","baseline"],type:"string"},backgroundColor:{description:"Background surface color token",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},basis:{anyOf:[{type:"number"},{type:"string"}],description:"Flex basis value"},boxSizing:{description:"Box sizing model",enum:["content-box","border-box"],type:"string"},color:{description:"Text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},gap:{description:"Spacing token for gap between children",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},grow:{description:"Flex grow factor",type:"number"},height:{anyOf:[{type:"number"},{type:"string"}],description:"Height in pixels (number) or CSS string"},justify:{description:"Main-axis alignment",enum:["flex-start","center","flex-end","space-between","space-around","space-evenly"],type:"string"},margin:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Margin as a spacing token or directional spacing-token object {top, right, bottom, left}"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Max height in pixels or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Max width in pixels or CSS string"},minHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Min height in pixels or CSS string"},minWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Min width in pixels or CSS string"},overflow:{description:"Overflow behavior",enum:["visible","hidden","scroll","auto"],type:"string"},padding:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Padding as a spacing token or directional spacing-token object {top, right, bottom, left}"},radius:{description:"Border radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},shrink:{description:"Flex shrink factor",type:"number"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Width in pixels (number) or CSS string"},wrap:{description:"Flex wrap behavior",enum:["nowrap","wrap","wrap-reverse"],type:"string"}},type:"object"},acceptsChildren:!0},WorkEmail:{description:"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",events:["change","blur","focus","click","keydown","keyup","paste","mouseenter","mouseleave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},domainList:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"},{items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this specific domain option",type:"boolean"},label:{description:"Display label for the domain option",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Optional semantic appearance for the tag",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text displayed with the domain option",type:"string"}},required:["text"],type:"object"}],description:"Optional tag shown with the domain option"},value:{description:"Domain option value",type:"string"}},required:["value"],type:"object"},type:"array"},{items:{additionalProperties:!1,properties:{label:{description:"Group label for a nested domain list",type:"string"},list:{description:"Grouped domain options",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this specific domain option",type:"boolean"},label:{description:"Display label for the domain option",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Optional semantic appearance for the tag",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text displayed with the domain option",type:"string"}},required:["text"],type:"object"}],description:"Optional tag shown with the domain option"},value:{description:"Domain option value",type:"string"}},required:["value"],type:"object"},type:"array"}},required:["label","list"],type:"object"},type:"array"}],description:'Email domain list for selection. Can be: single string, array of strings ["acme.com"], array of {label, value, tag?} objects (FlatList), or array of {label, list} objects (NestedList) for grouped domains'},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},shouldAllowAutoFill:{description:"Allow browser autofill",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},shouldStopEventPropagation:{description:"Stop automatic input focus when clicking container",type:"boolean"},shrinkToPlaceholder:{description:"Input spans as much as its placeholder when true. Only applies when placeholder is visible",type:"boolean"},shrinkToValue:{description:"Input spans as much as its value when true. Only applies when value is present",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},theme:{description:"Theme name from Input.WorkEmail.THEMES or custom theme",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current work email value bound to state",type:"string"}},type:"object"},acceptsChildren:!1}},u={navigate:{description:"Navigate to a URL path.",docs:"Page URLs: `/custom-apps/{app_id}/sdui/{page_id}`. Use openInNewTab for external links.",paramsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}},openChatAssistantWithMessage:{description:"Open Chat Assistant and send an initial message in a new conversation.",docs:`text: prompt/message that should be sent immediately after Chat Assistant opens.
|
|
1
|
+
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../../core/component-utils.cjs"),s=require("../../core/action-utils.cjs"),D=require("../../2020-C_v5qH0D.cjs"),k=require("../../core/catalog-validation.cjs"),A=require("../../core/component-markdown.cjs"),P=require("../../core/spec.cjs"),L=e=>t.buildNode("ActionCard",e),R=e=>t.buildNode("AiIcon",e),E=e=>t.buildNode("Alert",e),N=e=>t.buildNode("Animation",e),M=e=>t.buildNode("ApiError",e),B=e=>t.buildNode("AppGroupLoader",e),F=e=>t.buildNode("AppGroupSelect",e),j=e=>t.buildNode("AppNavBar",e),q=e=>t.buildNode("AtomsSeparator",e),_=e=>t.buildNode("Avatar",e),U=e=>t.buildNode("AvatarList",e),W=e=>t.buildNode("Badge",e),H=e=>t.buildNode("Box",e),G=e=>t.buildNode("BrandBadge",e),z=e=>t.buildNode("Breadcrumb",e),V=e=>t.buildNode("Button",e),X=e=>t.buildNode("ButtonGroup",e),$=e=>t.buildNode("Calendar",e),Y=e=>t.buildNode("Card",e),K=e=>t.buildNode("CardGroup",e),J=e=>t.buildNode("Carousel",e),Q=e=>t.buildNode("ChartLoader",e),Z=e=>t.buildNode("Checkbox",e),ee=e=>t.buildNode("CheckboxGroup",e),te=e=>t.buildNode("CheckList",e),ie=e=>t.buildNode("Chip",e),oe=e=>t.buildNode("ChipGroup",e),ne=e=>t.buildNode("Circle",e),ae=e=>t.buildNode("ColorPicker",e),re=e=>t.buildNode("ContentLoader",e),se=e=>t.buildNode("CountDown",e),le=e=>t.buildNode("Country",e),pe=e=>t.buildNode("Currency",e),ce=e=>t.buildNode("Dashboard",e),de=e=>t.buildNode("Date",e),ue=e=>t.buildNode("DateInlineMulti",e),he=e=>t.buildNode("DateRange",e),me=e=>t.buildNode("DaySelector",e),ye=e=>t.buildNode("DistributionBar",e),ge=e=>t.buildNode("Divider",e),be=e=>t.buildNode("DraggableList",e),fe=e=>t.buildNode("Drawer",e),we=e=>t.buildNode("Dropdown",e),ve=e=>t.buildNode("Email",e),Se=e=>t.buildNode("EmojiPicker",e),Ie=e=>t.buildNode("EmployeeSearch",e),Ce=e=>t.buildNode("ExpansionPanel",e),xe=e=>t.buildNode("ExpansionPanelGroup",e),Te=e=>t.buildNode("Field",e),Oe=e=>t.buildNode("File",e),De=e=>t.buildNode("FileDrop",e),ke=e=>t.buildNode("FloatingButton",e),Ae=e=>t.buildNode("Form",e),Pe=e=>t.buildNode("FormCheckbox",e),Le=e=>t.buildNode("FormCheckboxGroup",e),Re=e=>t.buildNode("FormContent",e),Ee=e=>t.buildNode("FormCurrency",e),Ne=e=>t.buildNode("FormDate",e),Me=e=>t.buildNode("FormDateRange",e),Be=e=>t.buildNode("FormDaySelector",e),Fe=e=>t.buildNode("FormEmail",e),je=e=>t.buildNode("FormEmployeeSearch",e),qe=e=>t.buildNode("FormFile",e),_e=e=>t.buildNode("FormFileDrop",e),Ue=e=>t.buildNode("FormGroup",e),We=e=>t.buildNode("FormGroupHeader",e),He=e=>t.buildNode("FormHidden",e),Ge=e=>t.buildNode("FormInlineGroup",e),ze=e=>t.buildNode("FormInputGroup",e),Ve=e=>t.buildNode("FormMasker",e),Xe=e=>t.buildNode("FormNumber",e),$e=e=>t.buildNode("FormPassword",e),Ye=e=>t.buildNode("FormPercentage",e),Ke=e=>t.buildNode("FormPhone",e),Je=e=>t.buildNode("FormRadio",e),Qe=e=>t.buildNode("FormRecordLookup",e),Ze=e=>t.buildNode("FormSegmentedControl",e),et=e=>t.buildNode("FormSelect",e),tt=e=>t.buildNode("FormSelectableGroup",e),it=e=>t.buildNode("FormSignature",e),ot=e=>t.buildNode("FormSin",e),nt=e=>t.buildNode("FormSlider",e),at=e=>t.buildNode("FormSsn",e),rt=e=>t.buildNode("FormSurvey",e),st=e=>t.buildNode("FormSwitch",e),lt=e=>t.buildNode("FormText",e),pt=e=>t.buildNode("FormTextarea",e),ct=e=>t.buildNode("FormTextAutoSuggest",e),dt=e=>t.buildNode("FormTime",e),ut=e=>t.buildNode("FormTimezone",e),ht=e=>t.buildNode("FormTree",e),mt=e=>t.buildNode("FormTreeSelect",e),yt=e=>t.buildNode("FormWorkEmail",e),gt=e=>t.buildNode("Grid",e),bt=e=>t.buildNode("Heading",e),ft=e=>t.buildNode("Hidden",e),wt=e=>t.buildNode("HStack",e),vt=e=>t.buildNode("Icon",e),St=e=>t.buildNode("IconButton",e),It=e=>t.buildNode("Image",e),Ct=e=>t.buildNode("ImageViewer",e),xt=e=>t.buildNode("InputGroup",e),Tt=e=>t.buildNode("Interval",e),Ot=e=>t.buildNode("ItemNavigator",e),Dt=e=>t.buildNode("Label",e),kt=e=>t.buildNode("LabelGroup",e),At=e=>t.buildNode("Layout",e),Pt=e=>t.buildNode("LayoutCard",e),Lt=e=>t.buildNode("Link",e),Rt=e=>t.buildNode("ListItem",e),Et=e=>t.buildNode("LoaderCard",e),Nt=e=>t.buildNode("LocationCard",e),Mt=e=>t.buildNode("LottiePlayer",e),Bt=e=>t.buildNode("Masker",e),Ft=e=>t.buildNode("MenuList",e),jt=e=>t.buildNode("Modal",e),qt=e=>t.buildNode("ModalCloseButton",e),_t=e=>t.buildNode("ModalFooter",e),Ut=e=>t.buildNode("NestedList",e),Wt=e=>t.buildNode("Number",e),Ht=e=>t.buildNode("ObjectListView",e),Gt=e=>t.buildNode("ObjectUI",e),zt=e=>t.buildNode("ObjectUIContent",e),Vt=e=>t.buildNode("ObjectUIHeader",e),Xt=e=>t.buildNode("ObjectUIStats",e),$t=e=>t.buildNode("ObjectUITemplate",e),Yt=e=>t.buildNode("PageAppLogo",e),Kt=e=>t.buildNode("PageContent",e),Jt=e=>t.buildNode("PageFooter",e),Qt=e=>t.buildNode("PageHeader",e),Zt=e=>t.buildNode("Paginate",e),ei=e=>t.buildNode("PaginateList",e),ti=e=>t.buildNode("Pane",e),ii=e=>t.buildNode("Password",e),oi=e=>t.buildNode("Percentage",e),ni=e=>t.buildNode("Phone",e),ai=e=>t.buildNode("ProgressBar",e),ri=e=>t.buildNode("ProgressSteps",e),si=e=>t.buildNode("Radio",e),li=e=>t.buildNode("RangeSlider",e),pi=e=>t.buildNode("RecordLookup",e),ci=e=>t.buildNode("ReportLoader",e),di=e=>t.buildNode("Reports",e),ui=e=>t.buildNode("ReportShareLoader",e),hi=e=>t.buildNode("ReportViewerLoader",e),mi=e=>t.buildNode("ResizableBoard",e),yi=e=>t.buildNode("Responsive",e),gi=e=>t.buildNode("SegmentedControl",e),bi=e=>t.buildNode("Select",e),fi=e=>t.buildNode("SelectableGroup",e),wi=e=>t.buildNode("SelectableMenu",e),vi=e=>t.buildNode("SettingsLoader",e),Si=e=>t.buildNode("ShowMore",e),Ii=e=>t.buildNode("Signature",e),Ci=e=>t.buildNode("Sin",e),xi=e=>t.buildNode("Skeleton",e),Ti=e=>t.buildNode("Slider",e),Oi=e=>t.buildNode("SnackBar",e),Di=e=>t.buildNode("Spinner",e),ki=e=>t.buildNode("SplitButton",e),Ai=e=>t.buildNode("SplitPane",e),Pi=e=>t.buildNode("Ssn",e),Li=e=>t.buildNode("Status",e),Ri=e=>t.buildNode("Stepper",e),Ei=e=>t.buildNode("SuperGrid",e),Ni=e=>t.buildNode("SupportButton",e),Mi=e=>t.buildNode("Survey",e),Bi=e=>t.buildNode("Switch",e),Fi=e=>t.buildNode("Tab",e),ji=e=>t.buildNode("TableBasic",e),qi=e=>t.buildNode("Text",e),_i=e=>t.buildNode("Textarea",e),Ui=e=>t.buildNode("TextAutoSuggest",e),Wi=e=>t.buildNode("TextClip",e),Hi=e=>t.buildNode("TextInput",e),Gi=e=>t.buildNode("TextSnippet",e),zi=e=>t.buildNode("Time",e),Vi=e=>t.buildNode("TimeRange",e),Xi=e=>t.buildNode("Timezone",e),$i=e=>t.buildNode("Tip",e),Yi=e=>t.buildNode("TitleCaption",e),Ki=e=>t.buildNode("ToggleableArrow",e),Ji=e=>t.buildNode("Tree",e),Qi=e=>t.buildNode("TreeSelect",e),Zi=e=>t.buildNode("Video",e),eo=e=>t.buildNode("VStack",e),to=e=>t.buildNode("WorkEmail",e),io=(e,i)=>s.buildAction("invalidateSuperGridData",e,i),oo=(e,i)=>s.buildAction("navigate",e,i),no=(e,i)=>s.buildAction("openChatAssistantWithMessage",e,i),ao=(e,i)=>s.buildAction("pushState",e,i),ro=(e,i)=>s.buildAction("removeState",e,i),so=(e,i)=>s.buildAction("setState",e,i),lo=(e,i)=>s.buildAction("showNotification",e,i),po=(e,i)=>s.buildAction("triggerFunction",e,i),w="custom-apps",v="1.9.2",a={ActionCard:{description:"Placeholder for states like empty, success, error, and loading, featuring animations, icons, text, and action buttons.",events:["pressPrimary","pressSecondary"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alignment:{description:"Content alignment within the card. Default: CENTER",enum:["LEFT","CENTER","RIGHT"],type:"string"},animation:{description:"Lottie animation name to display as the card asset instead of an icon",enum:["ADD","AIRPLANE","BAR_CHART_DECREASE","BAR_CHART_INCREASE","BRAIN","BRAIN_AI","CALENDAR","CHECK_MARK","CLOCK","COINS_USD","CREDIT_CARD","DOCUMENT","ENTERPRISE","EXCLAMATION_MARK","FOLDERS","GEAR","GEAR_HEART","GEAR_PLAY","GLOBE","GRAD_CAP","HANDSHAKE","HEART","INTEGRATION","INVENTORY_MANAGEMENT","LAPTOP","LAPTOP_DEV","LIGHTNING_BOLT","LOCK","LOCK_UNLOCKED","MAGNIFYING_GLASS","MAGNIFYING_GLASS_QUESTION_MARK","NO_WIFI","OFFBOARDING","ONBOARDING","PAYROLL_EURO","PAYROLL_RUPEE","PAYROLL_USD","PAYROLL_YEN","QUESTION_MARK","RECEIPT","REFRESH","SHIELD_CHECK","SPEECH_BUBBLE","THIRD_PARTY","TRAIN","UNIFIED_SYSTEM","X"],type:"string"},caption:{anyOf:[{type:"string"},{type:"number"}],description:"Card caption/description text"},icon:{description:"Icon type string from Icon.TYPES for the card asset",type:"string"},iconColor:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},padding:{additionalProperties:!1,description:"Override container padding per side using Pebble spacing tokens",properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"},primaryAction:{additionalProperties:!1,description:"Primary action button configuration",properties:{icon:{description:"Icon type string for the action button",type:"string"},isDisabled:{description:"Disable the action button. Default: false",type:"boolean"},title:{description:"Action button label",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Navigation destination for the action. String URL or { path, openInNewTab? }"}},required:["title"],type:"object"},secondaryAction:{additionalProperties:!1,description:"Secondary action button configuration",properties:{icon:{description:"Icon type string for the action button",type:"string"},isDisabled:{description:"Disable the action button. Default: false",type:"boolean"},title:{description:"Action button label",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Navigation destination for the action. String URL or { path, openInNewTab? }"}},required:["title"],type:"object"},shouldShowAsset:{description:"Show the icon/animation asset. Default: true",type:"boolean"},title:{description:"Card title text",type:"string"}},required:["caption"],type:"object"},acceptsChildren:!1,category:["card"],keywords:["action card","actioncard","empty state","success state","error state","placeholder","no results","404","page not found","next step","setup complete","onboarding complete","no permission","upsell card","illustration card"],anatomy:{parts:[{name:"Graphic asset",required:!1,role:"Icon (icon/iconColor) or Animation (animation, often BrandBadge.TYPES.*); supply only one"},{name:"Title",required:!0,role:`Headline stating the state (e.g. "You're all set")`},{name:"Caption",required:!1,role:"Supporting explanation and orientation for the user"},{name:"Actions",required:!1,role:"Optional primaryAction and/or secondaryAction with title + onClick"}],summary:"A centered (or left/right-aligned) card: a graphic asset on top (icon or animation, never both), a title, a caption explaining the state, and an optional row of primary/secondary action buttons at the bottom. shouldShowAsset={false} renders text and actions only."},guidance:{doNotUseWhen:["Grouping arbitrary content — use Card instead","Inline warning or info within existing content — use Notice","A plain API failure with standard copy — use Atoms.ApiError","A loading indicator — use Spinner or Skeleton instead","The action is the whole point with no state to explain — use a Button directly"],useWhen:['Empty states for lists, grids, and dashboards ("You currently have no applicants")','Success or completion screens at the end of a flow ("Setup complete")',"Error, permission-denied, and 404 / page-not-found fallbacks with a recovery action","Next-step or upsell prompts that need a headline, explanation, and a CTA","Any placeholder that benefits from a branded icon or animation above the copy"]},antiPatterns:["State conveyed through ad-hoc icon tinting instead of consistent assets","Next-step buttons placed outside the card instead of on it","Placeholder shown without any visual asset (no icon or animation)","Empty caption — headline on the card, explanation or actions elsewhere","Headline missing — users only see caption text","Both icon and animation supplied on the same card","Empty-state copy lacks orientation or a clear next step"],selection:{confusedWith:[{component:"Card",distinguishBy:"Card is a generic container for arbitrary content; ActionCard is a purpose-built state placeholder with asset, title, caption, and actions baked in"},{component:"Notice",distinguishBy:"Notice is an inline banner that supplements surrounding content; ActionCard owns the whole surface as the standalone empty/success/error state"},{component:"Atoms.ApiError",distinguishBy:"Atoms.ApiError is the fixed API-failure error block; ActionCard covers custom error, empty, success, and next-step states with your own asset, copy, and actions"},{component:"Modal",distinguishBy:"Modal interrupts the flow in an overlay; ActionCard renders inline in place of missing or completed content"}]},relatedComponents:[{name:"Icon",note:"Static asset via the icon prop, tinted with iconColor (e.g. theme.colorSuccess / colorWarning)",relationship:["complement"]},{name:"BrandBadge",note:"Source of animated assets: animation={BrandBadge.TYPES.*} (e.g. EXCLAMATION_MARK, MAGNIFYING_GLASS_QUESTION_MARK)",relationship:["complement"]},{name:"Animation",note:"Alternative animation source via the animation prop",relationship:["complement"]},{name:"Card",note:"Generic content container when the surface is not a state placeholder",relationship:["alternative"]},{name:"Notice",note:"Inline contextual banner instead of a full-surface placeholder",relationship:["alternative"]},{name:"Atoms.ApiError",note:"Standard API-failure display when no custom copy or actions are needed",relationship:["alternative"]},{name:"Spinner",note:"Pair for loading states; ActionCard takes over for the empty/success/error outcomes",relationship:["complement"]}]},AiIcon:{description:'Branded Rippling AI icon used to indicate AI-powered features or content. Displays the Rippling AI star icon with optional "Rippling AI" label text.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{"aria-label":{description:"Accessible label for the icon",type:"string"},showText:{description:'Whether to show the "Rippling AI" text alongside the icon. Default: true',type:"boolean"},size:{description:"Size of the AI icon. One of: SMALL, MEDIUM, LARGE. Default: MEDIUM",enum:["SMALL","MEDIUM","LARGE"],type:"string"}},type:"object"},acceptsChildren:!1,category:["atom"],keywords:["ai icon","aiicon","rippling ai","ai sparkle","ai star","ai label","ai branding","ai-generated","ai feature","artificial intelligence"],anatomy:{parts:[{name:"AI sparkle glyph",required:!0,role:"The Rippling AI star icon identifying AI-powered content"},{name:"Label text",required:!1,role:'Optional canonical "Rippling AI" text shown next to the glyph via showText'}],summary:'A display-only marker: the Rippling AI sparkle glyph at one of three sizes (S, M, L) plus an optional adjacent "Rippling AI" text label via showText. It renders no interactive chrome — it is a marker, not a button.'},guidance:{doNotUseWhen:["Any new feature — use Icon.TYPES.RIPPLING_AI_* through Icon, Button, or Button.Icon","Clickable AI actions — AiIcon is display-only; use Button.Icon with the AI icon type","Decorative sparkle on non-AI surfaces or status signaling — use Status or Notice for outcomes","Tooltip triggers — place a separate info icon next to the AI marker instead"],useWhen:["Legacy call sites only — AiIcon is deprecated; use Icon.TYPES.RIPPLING_AI_* for new AI branding","Marking key AI moments: primary AI actions, AI workflows, or AI-generated content needing clear identification",'Inline AI labels where the canonical "Rippling AI" text must accompany the sparkle']},antiPatterns:["Deprecated `AiIcon` used instead of `Icon.TYPES.RIPPLING_AI_*` for AI branding","AI star shown on non-AI or decorative surfaces without clarifying copy",'Redundant adjacent "AI" copy when canonical label would suffice',"AI sparkle used as a bare clickable trigger instead of Button or Button.Icon","AI icon used as a status signal or tinted with semantic status color","Filled AI icon used as bare decoration instead of outline variant","AI-generated content shown without visible Rippling AI disclosure","AI icon repeated across every grid or list row","AI icon used as tooltip trigger instead of adjacent info icon"],aiGuardrails:[{details:["Use the Rippling AI sparkle only for key AI moments: primary AI actions, AI workflows, or AI-generated content that needs clear identification.","Pair AI-generated, summarized, recommended, or materially AI-shaped content with visible text that explains what happened, such as “Summarized by Rippling AI”. Add explainers or disclaimers when users may rely on the output.","Do not use the AI sparkle itself as a bare interactive control. Put `Icon.TYPES.RIPPLING_AI_*` inside Button or Button.Icon when it represents an action, and use a separate info icon or tooltip trigger when explaining behavior.","Use the outline AI sparkle for passive disclosure. Reserve filled variants for active/enabled state or component slots where the guideline explicitly allows it."],guardrail:"Do not use `AiIcon` for new AI branding. Use `Icon.TYPES.RIPPLING_AI_*` through the appropriate Icon, Button, or Button.Icon slot, and follow the AI icon and labels guideline for labels, explainers, and disclaimers.",section:"AI icon and labels"}],selection:{confusedWith:[{component:"Icon",distinguishBy:"AiIcon is deprecated for new AI branding — use Icon with Icon.TYPES.RIPPLING_AI_OUTLINE or RIPPLING_AI_FILLED; Icon also covers all non-AI iconography"},{component:"Button.Icon",distinguishBy:"AiIcon is a passive display marker; when the AI sparkle triggers an action, put Icon.TYPES.RIPPLING_AI_* inside Button.Icon instead"},{component:"Status",distinguishBy:"Status communicates success/warning/error state with semantic color; the AI sparkle identifies AI involvement, not status — never tint it with status colors"},{component:"Tip",distinguishBy:"Explanatory AI copy belongs in a Tip anchored to a separate info icon; do not make the AI sparkle itself a tooltip trigger"}]},relatedComponents:[{name:"Icon",note:"Canonical replacement — Icon.TYPES.RIPPLING_AI_OUTLINE / RIPPLING_AI_FILLED / RIPPLING_AI_STAR",relationship:["alternative"]},{name:"Button.Icon",note:"Interactive AI actions — wrap Icon.TYPES.RIPPLING_AI_* instead of clicking a bare sparkle",relationship:["alternative"]},{name:"Status",note:"Semantic status messaging instead of AI identification",relationship:["alternative"]},{name:"Tip",note:"Explainers about AI behavior, anchored to an info icon adjacent to the AI marker",relationship:["complement"]},{name:"Notice",note:"Disclaimers for AI-generated content users may rely on",relationship:["complement"]}]},Alert:{description:"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).",events:["pressPrimary","pressSecondary","dismiss"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{description:{description:"Main description content to display in the alert",type:"string"},isCloseable:{description:"Shows close button when true. Default: false",type:"boolean"},isFluid:{description:"If true, the alert takes full width of its container. Default: false",type:"boolean"},primaryAction:{additionalProperties:!1,description:"Primary action button configuration",properties:{icon:{description:"Icon type string from Icon.TYPES for the action button",type:"string"},isDisabled:{description:"Disable the action button. Default: false",type:"boolean"},shouldShowSpinner:{description:"Show spinner on the action button. Default: false",type:"boolean"},title:{description:"Action button label",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Navigation destination for the action. String URL or { path, openInNewTab? }"}},required:["title"],type:"object"},secondaryAction:{additionalProperties:!1,description:"Secondary action button configuration",properties:{icon:{description:"Icon type string from Icon.TYPES for the action button",type:"string"},isDisabled:{description:"Disable the action button. Default: false",type:"boolean"},shouldShowSpinner:{description:"Show spinner on the action button. Default: false",type:"boolean"},title:{description:"Action button label",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Navigation destination for the action. String URL or { path, openInNewTab? }"}},required:["title"],type:"object"},title:{description:"Alert title text displayed above the message",type:"string"},type:{description:"Alert type determining color and icon. Default: Info",enum:["Info","Success","Warning","Error","Neutral"],type:"string"}},type:"object"},acceptsChildren:!1,category:["complex"],keywords:["notice","banner","inline alert","callout","alert","inline message","warning message","error message","info box","system status","announcement","heads up"],anatomy:{parts:[{name:"Container",required:!0,role:"Colored surface indicating severity; adapts width, truncates or wraps long text"},{name:"Icon",required:!0,role:"Severity-linked icon (info, success, warning, error); not customizable"},{name:"Title",role:"Short scannable headline for longer messages; no trailing period"},{name:"Description",role:"One or two concise sentences: what happened, why, and how to resolve; may include inline Anchors"},{name:"Primary action",role:"Verb-led button offering the clear next step"},{name:"Secondary action / dismiss",role:"Optional link for details, and a close affordance when isCloseable (requires onClose)"}],summary:"A colored container (color signals urgency) with a mandatory severity icon on the left, an optional scannable title, a concise body, and optional actions — secondary link, primary action, and a contextual dismiss button. Actions sit inline-right on large screens and stack below the content on narrow ones. isFluid stretches it full width below the page header."},guidance:{doNotUseWhen:["Quick post-action confirmation (saved, copied, sent) — use SnackBar","The user must stop and decide before continuing — use Modal","Form validation feedback — use inline field errors, not a Notice","Marketing, upsell, promo, or engagement content — Notice is not a promotional surface","Field- or element-specific help — use Tip or helper text instead","More than one message on the same view — show a single Notice and rotate by priority"],useWhen:["Global or high-priority messages affecting a whole system — maintenance, required upgrade, outage","A page or feature stays in a degraded state until the user fixes something","Warning about potential problems that need attention before proceeding","Confirming significant state changes (successful submission of a large flow)","The message needs rich actions — multiple buttons or inline Anchors"]},antiPatterns:["Legacy spacing wrappers around notices break vertical rhythm","Multiple notices rendered together on the same view","Form validation feedback shown as a Notice instead of inline field errors","Dismissible notice without an `onClose` handler","Untranslated hardcoded English in notice title or description","Marketing or cross-sell content delivered through Notice","Raw API or backend error text passed directly into notice description","Notice used for quick post-action confirmation (should be SnackBar)","Section-specific Notice rendered as a fluid full-width alert","Long or structured Notice body rendered without a scannable title","Notice copy lacks context or a clear next step"],selection:{confusedWith:[{component:"SnackBar",distinguishBy:"SnackBar is transient, bottom-of-screen feedback that auto-dismisses after a user action (saved, copied); Notice is persistent in-flow until the issue is fixed or dismissed"},{component:"Modal",distinguishBy:"Modal blocks the flow and demands an immediate decision; Notice informs inline without interrupting — escalate to Modal when the user must stop and answer before continuing"},{component:"Tip",distinguishBy:"Tip is on-demand contextual help revealed by hover/focus on an element; Notice is an always-visible page- or feature-level message"},{component:"Status",distinguishBy:"Status is a small pill labeling an entity's state (Active, Pending); Notice communicates a message with context and next steps"}]},relatedComponents:[{name:"Notice.Info",note:"Neutral informational variant; polite aria-live",relationship:["child"]},{name:"Notice.Success",note:"Confirmation of completed state changes (not instant post-action feedback — that is SnackBar)",relationship:["child"]},{name:"Notice.Warning",note:"Potential problems needing attention; assertive aria-live",relationship:["child"]},{name:"Notice.Error",note:"Failures and broken states; role=alert",relationship:["child"]},{name:"Notice.Neutral",note:"Contextual message without urgency coloring",relationship:["child"]},{name:"SnackBar",note:"Transient post-action confirmation; use instead of Notice for quick feedback",relationship:["alternative"]},{name:"Modal",note:"Blocking feedback requiring an immediate decision or input",relationship:["alternative"]},{name:"Form.Content",note:"Wraps Notices inside forms so they align to the input column; field validation stays inline, not in a Notice",relationship:["complement"]}]},Animation:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{type:{description:"The animation type to render from the pre-built library",enum:["ADD","AIRPLANE","BAR_CHART_DECREASE","BAR_CHART_INCREASE","BRAIN","BRAIN_AI","CALENDAR","CHECK_MARK","CLOCK","COINS_USD","CREDIT_CARD","DOCUMENT","ENTERPRISE","EXCLAMATION_MARK","FOLDERS","GEAR","GEAR_HEART","GEAR_PLAY","GLOBE","GRAD_CAP","HANDSHAKE","HEART","INTEGRATION","INVENTORY_MANAGEMENT","LAPTOP","LAPTOP_DEV","LIGHTNING_BOLT","LOCK","LOCK_UNLOCKED","MAGNIFYING_GLASS","MAGNIFYING_GLASS_QUESTION_MARK","NO_WIFI","OFFBOARDING","ONBOARDING","PAYROLL_EURO","PAYROLL_RUPEE","PAYROLL_USD","PAYROLL_YEN","QUESTION_MARK","RECEIPT","REFRESH","SHIELD_CHECK","SPEECH_BUBBLE","THIRD_PARTY","TRAIN","UNIFIED_SYSTEM","X"],type:"string"}},required:["type"],type:"object"},acceptsChildren:!1,category:["other"],keywords:["animation","lottie","empty state","success animation","check mark","onboarding","celebration","status illustration","motion"],anatomy:{parts:[{name:"Animation canvas",required:!0,role:"The Lottie render surface; sized by its parent container, content chosen via type"}],summary:"A single Lottie animation chosen by the required type prop from Animation.TYPES, playing on mount inside a consumer-sized container. Wrap it in an element with explicit height and width to prevent clipping and layout shift."},guidance:{doNotUseWhen:["Any new code — use BrandBadge, the supported replacement","Indeterminate loading — use Spinner","Measurable progress — use ProgressBar","Custom animation assets or playback control — use LottiePlayer"],useWhen:["Nothing — Animation is deprecated; use BrandBadge for new illustrated empty states, onboarding, and status moments","Legacy call sites only until migrated to BrandBadge"]},antiPatterns:["Deprecated `Animation` import used instead of `BrandBadge`","Animation used for indeterminate loading instead of `Spinner`","Hardcoded 300px container sizing instead of theme spacing tokens","Success animation paired with in-progress or ambiguous outcome copy","Search empty state built as custom layout instead of `ActionCard`","Parallel feature still on `Animation` while sibling code migrated to `BrandBadge`"],selection:{confusedWith:[{component:"BrandBadge",distinguishBy:"BrandBadge is the replacement — Animation is deprecated and now wraps it; migrate all new and existing usage to BrandBadge"},{component:"Spinner",distinguishBy:"Spinner signals indeterminate loading while work completes; Animation (via BrandBadge) is for illustrated outcomes and empty states, not waiting"},{component:"LottiePlayer",distinguishBy:"LottiePlayer plays custom, non-curated animation assets with playback control; Animation only renders the curated Pebble library types"},{component:"ProgressBar",distinguishBy:"ProgressBar shows measurable, known-duration progress; Animation communicates a state or moment, not completion percentage"}]},relatedComponents:[{name:"BrandBadge",note:"Replacement for the deprecated Animation — use for all new illustrated moments",relationship:["alternative"]},{name:"Spinner",note:"Indeterminate loading indicator instead of outcome illustration",relationship:["alternative"]},{name:"LottiePlayer",note:"Custom animation assets and runtime playback control",relationship:["alternative"]},{name:"ProgressBar",note:"Known-duration, measurable progress instead of status moments",relationship:["alternative"]},{name:"ActionCard",note:"Structured empty-state layout with title, caption, and action — prefer it over hand-built empty states",relationship:["complement"]}]},ApiError:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{fixedWindowCentered:{description:"Positions the error component fixed in the center of the browser viewport. Default: false",type:"boolean"},message:{description:"Custom error message to display. Default: i18n fallback message",type:"string"},windowCentered:{description:"Positions the error component absolutely in the center of the nearest positioned parent container. Default: false",type:"boolean"}},type:"object"},acceptsChildren:!1,category:["atom"],keywords:["api error","apierror","error state","server error","full screen error","loading failure","failed to load","error boundary fallback","500 error","refresh page","request failed"],anatomy:{parts:[{name:"Exclamation icon",required:!0,role:"Animated icon signaling the failure state"},{name:"Message",required:!1,role:"User-facing copy naming what failed and how to recover; omit to use the localized default"}],summary:"A centered animated exclamation-mark icon with an error message beneath it. By default it fills its container; windowCentered absolutely centers it inside a relatively-positioned parent panel, and fixedWindowCentered fixes it to the viewport for page-level failures (use one, not both)."},guidance:{doNotUseWhen:["Inline field or form validation errors — use form error patterns or Notice","Partial failures where the rest of the page is usable — show a localized Notice","Requests still retrying automatically — use Spinner or inline status feedback","No-data scenarios that are not errors — use an empty-state pattern such as ActionCard"],useWhen:["An API call fails and the entire content area should show an error instead of content","Error boundary or withSpinner fallbacks for page- and section-level load failures","A single panel fails to load — use windowCentered inside its positioned container","Page-level failures that must stay centered in the viewport — use fixedWindowCentered"]},antiPatterns:["Atoms.ApiError rendered without a recovery-oriented message"],selection:{confusedWith:[{component:"Notice",distinguishBy:"Notice is an inline banner for localized or partial failures while the rest of the UI stays usable; Atoms.ApiError replaces the entire content area after a request failure"},{component:"ActionCard",distinguishBy:"ActionCard is an actionable empty/error card with its own call-to-action; Atoms.ApiError is a plain full-area failure placeholder with message only"},{component:"Spinner",distinguishBy:"Spinner indicates in-progress loading or automatic retries; Atoms.ApiError is the terminal state once the request has failed"}]},relatedComponents:[{name:"Atoms",note:"Imported as Atoms.ApiError from '@rippling/pebble'",relationship:["parent"]},{name:"WithErrorBoundary",note:"Error boundaries and withSpinner wrappers commonly render Atoms.ApiError as their fallback",relationship:["complement"]},{name:"Spinner",note:"Shown while the request is in flight or retrying; swap to Atoms.ApiError on failure",relationship:["complement"]},{name:"Notice",note:"Inline feedback for partial failures or validation errors",relationship:["alternative"]},{name:"ActionCard",note:"Empty or error states that need an explicit call-to-action button",relationship:["alternative"]}]},AppGroupLoader:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!1},AppGroupSelect:{description:"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.",events:["change","blur","focus","paste","menuToggle"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this select",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this select",type:"string"},canClear:{description:"Show clear button to deselect all",type:"boolean"},canSelectAll:{description:"Show select-all toggle",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},creatable:{description:"Allow creating new options not in the list",type:"boolean"},defaultSearchQuery:{description:"Initial search input value",type:"string"},dropdownHeight:{description:"Sets dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query entered",type:"string"},onNoSearchResults:{description:"Placeholder when search returns no results",type:"string"}},type:"object"}],description:"Placeholder when dropdown list is empty. Can be string or object with state-specific placeholders"},footer:{additionalProperties:!1,description:"Fixed footer at bottom of dropdown menu",properties:{label:{description:"Footer link text",type:"string"},onClick:{description:"Event name to emit when footer is clicked",type:"string"}},required:["label","onClick"],type:"object"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing fuzzy search behavior",propertyNames:{type:"string"},type:"object"},id:{description:"HTML id attribute for the select input",type:"string"},isDisabled:{description:"Disables the select",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu will be open by default",type:"boolean"},isPositionFixed:{description:"Position dropdown relative to viewport instead of parent",type:"boolean"},isReadOnly:{description:"Makes the select read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isSearchable:{description:"Enable type-to-search filtering",type:"boolean"},label:{description:"Label text above the select",type:"string"},list:{description:"Array of options or grouped options. Supports flat list or nested groups with label and list properties",items:{anyOf:[{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},{additionalProperties:!1,properties:{label:{description:"Group label/header",type:"string"},list:{description:"Options within this group",items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"}},required:["label","list"],type:"object"}]},type:"array"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Max height of multi-select container (CSS value)"},maxTruncationLines:{description:'Max rows of chips visible before "+X" overflow chip appears',type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},placement:{description:"Dropdown position relative to input. Default: bottom-start",enum:["auto","auto-start","auto-end","top","top-start","top-end","bottom","bottom-start","bottom-end","right","right-start","right-end","left","left-start","left-end"],type:"string"},rows:{description:"Minimum number of rows to show",type:"number"},scrollThreshold:{description:"Extra pixels to render above/below viewport for smoother scrolling (pagination mode)",type:"number"},selectedOptionsModalClassName:{description:"CSS class for the modal showing all selected options (+X chip)",type:"string"},shouldFocusFirstElement:{description:"Auto-focus first menu item when dropdown opens",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix when isSearchable is true",type:"boolean"},shouldUsePortal:{description:"Render dropdown in a React Portal. Default: false",type:"boolean"},size:{description:"Select input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{},{items:{},type:"array"}],description:"Currently selected value(s) bound to state. Always an array in multi-select mode"}},type:"object"},acceptsChildren:!1},AppNavBar:{description:"Application navigation bar with optional routing. Displays a header without tabs when links are omitted or empty. With links, it displays a horizontal tab bar or vertical sidebar with icons, badges, and optional nested sub-navigation.",events:["navigate","action"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{actionClickedId:{description:"Stores the id of the clicked action button. Bind to state to access in the action event handler",type:"string"},actions:{description:"Array of action buttons displayed in the nav bar. Each emits an action event with its id",items:{additionalProperties:!1,properties:{appearance:{description:"Button visual style. Default: PRIMARY",enum:["PRIMARY","DESTRUCTIVE","OUTLINE","GHOST","ACCENT","SUCCESS","INFO","WARNING"],type:"string"},icon:{description:"Icon name from Icon.TYPES (e.g. ADD, EDIT_OUTLINE)",type:"string"},id:{description:"Unique identifier for the action. Written to actionClickedId state on click",type:"string"},isDisabled:{description:"Disables the button. Default: false",type:"boolean"},label:{description:"Button text",type:"string"},size:{description:"Button size. Default: M",enum:["L","M","S","XS"],type:"string"}},required:["id","label"],type:"object"},type:"array"},activeUrl:{description:"The currently active URL path. Use $bindState to two-way bind this to state — the value updates automatically when the user clicks a nav item.",type:"string"},baseURL:{description:"Base URL prefix prepended to all link paths",type:"string"},isLogoRound:{description:"If true, logo has rounded corners",type:"boolean"},isVertical:{description:"If true, renders a vertical sidebar navigation instead of horizontal tabs",type:"boolean"},links:{description:"Navigation items. Omit or pass an empty array to render the header without tabs",items:{$ref:"#/$defs/AppNavBarNavItem"},type:"array"},logoUrl:{description:"URL for a logo image in the header area",type:"string"},shouldPersistQueryParams:{description:"If true, existing query parameters are preserved across navigation",type:"boolean"},size:{description:"Fixed width in pixels for horizontal layout. 0 or omitted for fluid width",type:"number"},subtitle:{description:"Subtitle text below the title",type:"string"},supportLink:{description:"URL for a support/help link",type:"string"},theme:{description:"Visual theme: BOX (default with border), NO_PADDING (no padding), BOX_HEADER (border on header only)",enum:["BOX","NO_PADDING","BOX_HEADER"],type:"string"},title:{description:"Title displayed in the nav bar header area",type:"string"}},type:"object"},acceptsChildren:!0,category:["navigation"],keywords:["app nav bar","appnavbar","navigation","nav tabs","route tabs","section navigation","nested navigation","tab migration","product navigation","settings nav"],anatomy:{parts:[{name:"Title / logo",required:!1,role:"App name (title) or logoUrl image anchoring the bar"},{name:"Links",required:!1,role:"Tabbed navigation items; each maps title + path to a URL-backed route with content"},{name:"Child links",required:!1,role:"Optional nested links[] under a parent, exposing second-level pages on child-path routes"},{name:"Icon / badge",required:!1,role:"Per-link visual metadata — icons reinforce the label; badges surface counts or status"}],summary:"A horizontal bar with an app title or logo on the left and a row of route-backed tab links. Each link can carry an icon, a badge (with optional tooltip), and nested child links rendered as second-level navigation. Active state follows the URL, or is driven explicitly via activeUrl."},guidance:{doNotUseWhen:["In-page content switching without routes — use Tabs instead","Hierarchical 'where am I' trails — use Breadcrumb instead","Sections without durable URLs — define routes first, or keep content-level Tabs","New vertical navigation — isVertical is deprecated; use the horizontal layout","Action triggers or boolean toggles — use Button or a Switch input instead"],useWhen:["Top-level product navigation where each item maps to a URL-backed route","App headers with no routes, where only the title and actions should be shown","Nested section hierarchies via parent links with child links on child-path routes","Migrating Tabs that were acting as page navigation into route-backed navigation","Sections needing visual status — badges for counts, icons for recognition","Route-driven active state via activeUrl when default URL matching is insufficient"]},antiPatterns:["Stale filters and scope leak across sections","Visual selection manually overridden instead of routing","Second-level navigation stuck on query-param URLs","Deprecated vertical layout still in use","Parent tab with no real destination route","Location breadcrumb rendered inside the nav content area","AppNavBar added to ObjectUI record detail summaries instead of existing app shell"],selection:{confusedWith:[{component:"Tabs",distinguishBy:"Tabs switch in-page content panels without routes; AppNavBar items map to URL-backed routes for app-level navigation — migrate route-backed Tabs to AppNavBar"},{component:"Breadcrumb",distinguishBy:"Breadcrumb shows a hierarchical 'where am I' path trail; AppNavBar shows peer-level sections, not ancestry"}]},relatedComponents:[{name:"Tabs",note:"In-page content switching that does not represent route navigation",relationship:["alternative"]},{name:"Breadcrumb",note:"Hierarchical 'where am I' trail instead of peer-level section navigation; often also complements AppNavBar inside Page.Header",relationship:["alternative"]},{name:"Page.Header",note:"Page title and actions for the screen the AppNavBar routes to",relationship:["complement"]},{name:"Icon",note:"Per-link icons via links[].icon — reinforce, never replace, the text label",relationship:["complement"]},{name:"Atoms.Badge",note:"Notification counts and status via links[].badge with optional tip",relationship:["complement"]}]},AtomsSeparator:{description:'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.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{text:{description:"Optional text displayed in the center of the separator",type:"string"},theme:{description:"Separator line style. Omit for solid",enum:["DASHED"],type:"string"}},type:"object"},acceptsChildren:!1,category:["layout"],keywords:["separator","divider","hr","horizontal rule","line","or divider","section break","dashed line","form sections","menu divider"],anatomy:{parts:[{name:"Line",required:!0,role:"The horizontal rule itself; solid by default, dashed via theme"},{name:"Text",required:!1,role:"Optional centered relationship label (OR, AND); keep to 1–3 words"}],summary:"A full-width horizontal line rendered as an hr. When children are provided, a short label (1–3 words like OR) sits centered in a gap in the line. Atoms.Separator.THEMES.DASHED renders a lighter dashed variant. No sub-components."},guidance:{doNotUseWhen:["You need space without a visible line — use layout gap/padding instead","Dividing a layout into resizable sections — use Layout.SplitPane","Between list items — rely on the list component's built-in dividers","Long phrases as separator text — use a heading or label instead"],useWhen:["Visually dividing groups of related content within a page or card","Inline text divider (OR, AND) between alternative options or actions","Clear visual breaks between distinct sections of a long form","Grouping items in a dropdown or menu that lacks built-in dividers"]},antiPatterns:["Layout.Box 1px divider instead of Atoms.Separator","Spacer boxes flanking Atoms.Separator","Long phrase as separator text","Custom hr/div dividers without Atoms.Separator","Atoms.Separator used where gap-only spacing suffices"],selection:{confusedWith:[{component:"Layout.Box",distinguishBy:"A 1px Layout.Box used as a divider is an anti-pattern; Atoms.Separator is the semantic hr with theme variants and optional text"},{component:"SplitPane",distinguishBy:"Layout.SplitPane divides a layout into resizable panes; Atoms.Separator is a static visual divider between content sections"},{component:"Layout.VStack",distinguishBy:"Layout.VStack gap spaces children without a visible line; add Atoms.Separator only when the visual boundary reinforces conceptual grouping"},{component:"MenuList",distinguishBy:"MenuList and menus provide their own section grouping; insert Atoms.Separator only when the container lacks built-in dividers"}]},relatedComponents:[{name:"Layout.Box",note:"Hand-rolled 1px Layout.Box dividers are an anti-pattern — use Atoms.Separator",relationship:["alternative"]},{name:"SplitPane",note:"Resizable layout sections instead of a static divider",relationship:["alternative"]},{name:"Layout.VStack",note:"Gap-only spacing when no visible line is needed",relationship:["alternative"]},{name:"MenuList",note:"Menus with built-in item grouping",relationship:["alternative"]},{name:"Card",note:"Divides content sections within cards",relationship:["complement"]},{name:"Form",note:"Visual breaks between sections of a long form",relationship:["complement"]},{name:"Button",note:"OR divider between alternative actions (e.g. sign-in options)",relationship:["complement"]}]},Avatar:{description:"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.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Color appearance variant for background/text",enum:["NEUTRAL_LIGHT","NEUTRAL_DARK","PRIMARY_LIGHT","PRIMARY_DARK","INFO_LIGHT","INFO_DARK","ERROR_LIGHT","ERROR_DARK","WARNING_LIGHT","WARNING_DARK","SUCCESS_LIGHT","SUCCESS_DARK"],type:"string"},"aria-label":{description:"Accessible label for the avatar",type:"string"},"aria-labelledby":{description:"ID of element that labels the avatar",type:"string"},"aria-role":{description:"ARIA role for the avatar element",type:"string"},badge:{additionalProperties:!1,description:"Badge overlay configuration for the avatar",properties:{"aria-label":{description:"Accessible label for the badge",type:"string"},char:{description:"Single character to display in the badge overlay",type:"string"}},required:["aria-label"],type:"object"},caption:{description:"Secondary text shown below the title",type:"string"},flagCountryCode:{description:"ISO country code (e.g. US, IN) to show a flag overlay on the avatar",type:"string"},icon:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{backgroundColor:{enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},color:{enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{type:"string"}},required:["type"],type:"object"}],description:"Icon name from Icon.TYPES (e.g. EDIT_OUTLINE) or { type, color?, backgroundColor? } when type is ICON"},image:{description:"Image URL for the avatar",type:"string"},imageBackground:{description:"Surface color token behind the avatar image",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},isCompact:{description:"Compact mode hides title and caption. Default: false",type:"boolean"},isRounded:{description:"Fully rounded (circle) shape. Default: true",type:"boolean"},size:{anyOf:[{const:24,type:"number"},{const:32,type:"number"},{const:40,type:"number"},{const:56,type:"number"},{const:64,type:"number"}],description:"Avatar size in pixels. One of: 24, 32, 40, 56, 64. Default: 40"},surfaceColor:{description:"Surface color for flag background. Pebble color token. Required with flagCountryCode",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},tip:{additionalProperties:!1,description:"Tooltip shown on avatar hover. Object with content string and optional title",properties:{appearance:{description:"Tooltip appearance. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},title:{description:"Tooltip title text",type:"string"}},required:["content"],type:"object"},title:{description:"Display name shown below or beside the avatar",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Navigation destination. String URL or { path, openInNewTab? }. Use instead of click event if click is just for navigation"},truncate:{description:"Truncate title and caption with ellipsis. Default: true",type:"boolean"},type:{description:"Avatar content type. Default: USER",enum:["USER","ICON","TEXT","NUMBER","RIPPLING"],type:"string"}},type:"object"},acceptsChildren:!1,category:["atom"],keywords:["avatar","profile photo","user image","initials","person","employee","assignee","owner","company logo","org icon","app icon","user menu","collaborators","mention"],anatomy:{parts:[{name:"Container",required:!0,role:"Circular (people) or rounded-square (objects/brands) image, initials, or icon area; sized via Avatar.SIZES"},{name:"Atoms.Badge / flag",role:"Optional corner overlay for status or country (flagCountryCode)"},{name:"Title",role:"Primary label (usually the person's or entity's name) beside the container; doubles as accessible name"},{name:"Caption",role:"Secondary line under the title (role, email, company)"}],summary:"A sized container showing an image, initials, number, or icon (circle for people, rounded square for objects/brands), with an optional badge or country-flag overlay in the corner. In non-compact mode a title label sits to the right with an optional caption below it."},guidance:{doNotUseWhen:["Showing a group of people — use AvatarList for the overlapping stack with overflow","A decorative or status glyph with no entity behind it — use Icon","Displaying a full-size photo or image content — use Atoms.Image or ImageViewer","You need a selectable row with meta and actions — use ListItem"],useWhen:["Representing a person, role, company, app, or product with an image, initials, number, or icon","Showing the actor/owner/assignee in grids, tables, timelines, and audit trails","Profile or account navigation — pass to={...} instead of onClick for link behavior","Compact identity markers where a tip prop reveals the full name","Brand or object entities — use isRounded={false} for the rounded-square shape"]},antiPatterns:["Object and brand avatars rendered as circles instead of rounded squares","Photo or image avatars missing an accessible name (`title`)","Profile navigation implemented with `onClick` / `window.open` instead of `to`","Compact avatars shown without tooltip when the name is not visible nearby","External `Tip` wrapper used when Avatar's built-in `tip` prop would work","Clickable image-only avatars with no visible or announced name","Brand / Rippling entity avatars not using rounded-square shape","Raw pixel sizes passed instead of `Avatar.SIZES` tokens","Duplicate adjacent name or title text when Avatar already owns `title` or `caption`"],selection:{confusedWith:[{component:"AvatarList",distinguishBy:"AvatarList renders an overlapping stack of several people with overflow count; Avatar represents a single entity"},{component:"Icon",distinguishBy:"Icon is a bare decorative/status glyph; use Avatar type ICON when the glyph represents an entity (team, app, group) and may need a title, caption, or badge"},{component:"ListItem",distinguishBy:"ListItem is a full selectable row with meta and actions; use Avatar when you only need the identity element (image/initials plus name), not a whole row"}]},relatedComponents:[{name:"AvatarList",note:"Overlapping stack for showing a group of people with overflow count",relationship:["alternative"]},{name:"Icon",note:"Bare glyph when there is no entity identity to represent",relationship:["alternative"]},{name:"ListItem",note:"Full row with selection/meta/actions when Avatar's title+caption row is not enough",relationship:["alternative"]},{name:"Tip",note:"Tooltip for truncated names; prefer Avatar's built-in tip prop over an external Tip wrapper",relationship:["complement"]},{name:"Dropdown",note:"Avatar is a common trigger for account/user menus",relationship:["complement"]}]},AvatarList:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes the avatar list",type:"string"},"aria-label":{description:"Accessible label for the avatar list",type:"string"},"aria-labelledby":{description:"ID of element that labels the avatar list",type:"string"},isRounded:{description:"If false, avatars render as rounded squares",type:"boolean"},limit:{description:"Maximum number of avatars to display before +N overflow",type:"number"},modalTitle:{description:"Title of the modal shown when clicking overflow",type:"string"},roles:{description:"Array of role/person objects for avatars",items:{additionalProperties:!1,properties:{fullName:{description:"Display name",type:"string"},id:{description:"Unique identifier",type:"string"},image:{description:"Avatar image URL",type:"string"},inviteEmail:{description:"Invite email (fallback label if fullName/workEmail absent)",type:"string"},partnerCompany:{additionalProperties:{},description:"Partner company data for profile URL routing",propertyNames:{type:"string"},type:"object"},user_cache:{additionalProperties:{},description:"User cache data with smallPhoto fallback",properties:{smallPhoto:{description:"Small photo URL",type:"string"}},type:"object"},workEmail:{description:"Work email",type:"string"}},type:"object"},type:"array"},size:{anyOf:[{const:24,type:"number"},{const:32,type:"number"},{const:40,type:"number"},{const:56,type:"number"},{const:64,type:"number"}],description:"Avatar size in pixels. One of: 24, 32, 40, 56, 64. Default: 40"},totalCount:{description:"Total count for overflow indicator",type:"number"},type:{description:"Avatar content type",enum:["USER","ICON","TEXT","NUMBER","RIPPLING"],type:"string"}},type:"object"},acceptsChildren:!1,category:["dataDisplay"],keywords:["avatar list","avatarlist","avatar group","avatars","assignees","participants","team members","people stack","overflow count","shared with","collaborators"],anatomy:{parts:[{name:"avatar stack",required:!0,role:"Overlapping avatars for the first `limit` roles"},{name:"overflow pill",required:!1,role:'"+N" indicator for hidden roles; opens the full-list modal'},{name:"overflow modal",required:!1,role:"Scrollable roster of all roles; titled via modalTitle, supports per-role actions and lazy pagination"}],summary:'A compact horizontal stack of overlapping circular avatars (image or initials, per type), sized via AvatarList.SIZES. When roles exceed the limit, a "+N" pill appears at the end; clicking it opens a modal listing every role with optional per-role actions.'},guidance:{doNotUseWhen:["Representing one person — use Avatar","Each person needs name, caption, or per-row actions inline — use ListItem rows","The items are not people — use Chip for tags or ListItem for generic records","An accessible group label cannot be provided — the collection needs an aria-label"],useWhen:["Showing assignees, participants, or members as a compact row of people on a task, project, or team","Summarizing group membership with a +N overflow count and a modal to inspect everyone","Dense surfaces — table rows, compact cards — where collaborators must show without adding vertical height","Role lists fetched on demand via cursor-based pagination"]},antiPatterns:["Accessible group label missing — no `aria-label` on the avatar collection","Overflow modal opens without a descriptive `modalTitle`","Avatar type not matched to data — USER/default used when initials would fit","Built-in avatar interactions suppressed via `pointer-events: none` wrappers","Empty `modalTitle` string passed explicitly","Manual multi-avatar stack by mapping single-role AvatarLists","AvatarList used where a single `Avatar` would suffice"],selection:{confusedWith:[{component:"Avatar",distinguishBy:"Avatar represents a single person; AvatarList summarizes multiple people with an overflow count and roster modal"},{component:"ListItem",distinguishBy:"ListItem rows give each person a full title/caption row; AvatarList is a compact inline stack when vertical space is scarce"},{component:"Chip",distinguishBy:"Chip shows text tags/tokens; AvatarList shows people as avatars with identity (image/initials) and a roster modal"}]},relatedComponents:[{name:"Avatar",note:"Each entry renders as an Avatar; size constants are shared (AvatarList.SIZES)",relationship:["child"]},{name:"Modal",note:"Built-in overflow modal listing all roles; give it a descriptive modalTitle",relationship:["child"]},{name:"TableBasic",note:"Common host — avatar stacks inside table cells for owners/assignees columns",relationship:["complement"]},{name:"Avatar",note:"Use for a single person; never stack single-role AvatarLists manually",relationship:["alternative"]},{name:"ListItem",note:"Use when each person needs a full row with caption and actions",relationship:["alternative"]},{name:"Chip",note:"Use for non-people tag/token collections",relationship:["alternative"]}]},Badge:{description:"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).",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Visual appearance variant (INFO_DARK, SUCCESS_DARK, etc.). Default: INFO_DARK",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},"aria-hidden":{description:"Hide badge from screen readers",type:"boolean"},"aria-label":{description:"Accessibility label for screen readers",type:"string"},size:{description:"Size of the badge. One of: EXTRA_SMALL, SMALL, MEDIUM, LARGE. Default: SMALL",enum:["EXTRA_SMALL","SMALL","MEDIUM","LARGE"],type:"string"},text:{description:"Text content to display in the badge. Required.",type:"string"},tip:{additionalProperties:!1,description:"Tooltip configuration to show on hover",properties:{appearance:{description:"Tooltip theme. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},isDelayed:{description:"Add delay before showing/hiding the tooltip. Default: false",type:"boolean"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Max width of tooltip. Number in px or CSS string"},placement:{description:"Tooltip position relative to badge. Default: bottom",enum:["top","bottom","left","right","top-start","top-end","bottom-start","bottom-end"],type:"string"}},required:["content"],type:"object"}},required:["text"],type:"object"},acceptsChildren:!1,category:["atom"],keywords:["badge","count","notification count","unread","pending count","number pill","tab count","metric","quantity","new items","atoms badge"],anatomy:{parts:[{name:"container",required:!0,role:"Colored pill whose appearance tints the count"},{name:"label",required:!0,role:"Short text — typically numeric; empty text renders nothing"},{name:"tip",role:"Optional tooltip explaining what the count represents"}],summary:"A small filled pill containing a short label — usually a count — with sizes XS through L and semantic appearances. An optional `tip` adds a hover tooltip for extra context. Round large quantities (nearest hundred/thousand with a trailing '+') to keep it compact."},guidance:{doNotUseWhen:['Workflow or state words ("Canceled", "Primary", "Not started") — use Status',"Category or tag text — use Label","Showing the number of results in a table — put it in visible text instead","Actions — Badges are not clickable; use a Button"],useWhen:["Unread or pending counts on tabs, navigation items, and icons","Notification or metric quantities in compact UI","Round non-critical large numbers to the nearest hundred/thousand with a trailing '+'","Add a tip when the number alone needs explanation"]},antiPatterns:["Non-numeric or long text used where Label or Status is appropriate","Workflow/state words in Atoms.Badge instead of Status component",'Atoms.Badge used for categorical tags ("Canceled", "Primary") in dense UI'],selection:{confusedWith:[{component:"Status",distinguishBy:"Atoms.Badge shows numeric counts and quantities; Status shows non-numeric workflow/process state as dot + text"},{component:"Label",distinguishBy:'Label carries category or tag keywords ("Payroll", "Recommended") as non-numeric text; Atoms.Badge is for numbers and counts'},{component:"Chip",distinguishBy:"Chip is selectable/dismissible and represents filters or entities; Atoms.Badge is read-only numeric display"},{component:"BrandBadge",distinguishBy:"BrandBadge is a curated Lottie/SVG brand illustration for empty states and milestones; Atoms.Badge is a tiny numeric pill — unrelated despite the name"}]},relatedComponents:[{name:"Status",note:"Workflow or process state text instead of a count",relationship:["alternative"]},{name:"Label",note:"Category or tag text rather than numeric values",relationship:["alternative"]},{name:"Chip",note:"Selectable, dismissible criteria or entity representation",relationship:["alternative"]},{name:"BrandBadge",note:"Curated brand illustration — a different component family entirely",relationship:["alternative"]},{name:"Tabs",note:"Classic host — unread or pending counts on tab labels",relationship:["complement"]},{name:"Button",note:"Badges are never actions; pair with a Button when the count needs a click target",relationship:["complement"]}]},Box:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{align:{description:'Align items on cross axis. CSS align-items value (e.g., "center", "flex-start")',type:"string"},alignSelf:{description:'Align this child on cross axis. CSS align-self value (e.g., "center", "flex-end")',type:"string"},"aria-describedby":{description:"ID of element that describes this Box",type:"string"},"aria-disabled":{description:"Marks this Box as disabled for assistive technology",type:"boolean"},"aria-hidden":{description:"Hide this Box from assistive technology",type:"boolean"},"aria-label":{description:"Accessible label",type:"string"},"aria-labelledby":{description:"ID of element that labels this Box",type:"string"},backgroundColor:{description:"Background surface color token",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},basis:{anyOf:[{type:"number"},{type:"string"}],description:"Flex basis value. Number (pixels) or CSS string"},border:{anyOf:[{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}]},{additionalProperties:!1,properties:{bottom:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Bottom border"},left:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Left border"},right:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Right border"},top:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Top border"}},type:"object"}],description:"Border value. CSS string, strict token parts, or directional border object"},boxSizing:{description:'CSS box-sizing value. "content-box" or "border-box". Default: content-box',type:"string"},changeDirectionAbove:{description:"Breakpoint in pixels at which to reverse flex direction. Uses container queries. Requires container prop for named containers",type:"number"},child:{description:"Whether this Box is a flex child. Changes display to initial",type:"boolean"},color:{description:"Text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},container:{anyOf:[{type:"boolean"},{type:"string"}],description:"Container query target. true for unnamed container, string for named container. Used with changeDirectionAbove"},containerType:{description:"CSS container-type value. Defines the element as a query container",type:"string"},direction:{description:'Flex direction. CSS flex-direction value (e.g., "row", "column")',type:"string"},flex:{description:'CSS flex shorthand (e.g., "1", "0 1 auto")',type:"string"},gap:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{column:{description:"Column gap spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},row:{description:"Row gap spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Gap between flex children. Spacing token or {row, column} spacing-token object"},grow:{anyOf:[{type:"number"},{type:"string"}],description:"Flex grow factor. Number value"},height:{anyOf:[{type:"number"},{type:"string"}],description:'Height value. Number (pixels) or CSS string (e.g., "100px", "50%")'},id:{description:"HTML id attribute",type:"string"},inset:{anyOf:[{type:"number"},{type:"string"}],description:"Offsets a positioned Box on all sides. Number (pixels) or CSS string"},isInline:{description:"Use inline-flex instead of flex. Default: false",type:"boolean"},justify:{description:'Justify content on main axis. CSS justify-content value (e.g., "center", "space-between")',type:"string"},margin:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Margin value. Spacing token or {top, right, bottom, left} spacing-token object"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height value. Number (pixels) or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width value. Number (pixels) or CSS string"},minHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum height value. Number (pixels) or CSS string"},minWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum width value. Number (pixels) or CSS string"},overflow:{description:'CSS overflow value (e.g., "hidden", "auto", "scroll")',type:"string"},padding:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Padding value. Spacing token or {top, right, bottom, left} spacing-token object"},pointerEvents:{description:"CSS pointer-events value controlling whether the Box receives pointer input",type:"string"},position:{description:'CSS position value (e.g., "relative", "absolute", "fixed")',type:"string"},radius:{anyOf:[{enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},{additionalProperties:!1,properties:{bottomLeft:{description:"Bottom-left corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},bottomRight:{description:"Bottom-right corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},topLeft:{description:"Top-left corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},topRight:{description:"Top-right corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"}},type:"object"}],description:"Border radius. Radius token or {topLeft, topRight, bottomLeft, bottomRight} radius-token object"},reverse:{description:"Reverse the flex direction. Combines with direction prop",type:"boolean"},role:{description:"ARIA role attribute",type:"string"},shrink:{anyOf:[{type:"number"},{type:"string"}],description:"Flex shrink factor. Number value"},width:{anyOf:[{type:"number"},{type:"string"}],description:'Width value. Number (pixels) or CSS string (e.g., "200px", "100%")'},wrap:{description:'Flex wrap behavior. CSS flex-wrap value (e.g., "wrap", "nowrap")',type:"string"},zIndex:{anyOf:[{type:"number"},{type:"string"}],description:"Z-index stacking order. Number value"}},type:"object"},acceptsChildren:!0,category:["layout"],keywords:["box","flex","flexbox","container","layout","spacing","padding","gap","wrap","surface","panel","chip row","responsive layout","inline"],anatomy:{parts:[{name:"Children",required:!0,role:"Arbitrary content arranged by the flex props; semantics stay on the underlying elements"}],summary:"A single flex container (no sub-components) wrapping arbitrary children. Token-aware props control direction, align, justify, gap, padding/margin, sizing, backgroundColor, border, and radius. changeDirectionAbove switches the flex axis at a breakpoint (optionally container-scoped via container); wrap='wrap' enables multi-line flows; isInline makes it inline-level."},guidance:{doNotUseWhen:["Simple one-axis rows or columns — use Layout.HStack or Layout.VStack instead","Read-only label/value summaries — use Layout.Grid","Semantic page landmarks or document structure — use semantic elements and place Layout.Box inside for spacing","The same Layout.Box structure repeats across screens — extract a purpose-built component"],useWhen:["Combining custom flex behaviors — direction, align, justify, gap, and sizing in one container","Layouts that switch axis at a breakpoint via changeDirectionAbove (optionally container-scoped)","Wrapped chip/tag rows or compact collections with predictable spacing (wrap='wrap' + gap)","Ad-hoc lightweight panels using padding, radius, backgroundColor, and border without a new component"]},antiPatterns:["Manual spacer elements instead of parent gap","Magic-number spacing instead of design tokens","Simple column Layout.Box instead of Layout.VStack","Simple row Layout.Box instead of Layout.HStack","Layout.Box used for card-like surfacing","Layout.Box used as horizontal divider"],selection:{confusedWith:[{component:"Layout.HStack",distinguishBy:"Layout.HStack is Layout.Box with direction fixed to row; use Layout.HStack for a plain horizontal row and Layout.Box only when combining multiple flex behaviors or switching axis responsively"},{component:"Layout.VStack",distinguishBy:"Layout.VStack is Layout.Box with direction fixed to column; use Layout.VStack for a plain vertical stack and Layout.Box for multi-axis or styled-surface layouts"},{component:"Layout.Grid",distinguishBy:"Layout.Grid is a data-driven read-only label/value summary grid, not a generic layout primitive; Layout.Box is for free-form arrangement of children"},{component:"Card",distinguishBy:"Card provides a semantic surfaced container for content blocks; Layout.Box styling props are only for ad-hoc lightweight panels, not card-like surfacing"}]},relatedComponents:[{name:"Layout.HStack",note:"Prefer for simple horizontal rows",relationship:["alternative"]},{name:"Layout.VStack",note:"Prefer for simple vertical stacks",relationship:["alternative"]},{name:"Layout.Grid",note:"Data-driven label/value summaries with built-in responsive reflow",relationship:["alternative"]},{name:"Card",note:"Semantic surfaced container; do not fake cards with Layout.Box styling props",relationship:["alternative"]},{name:"Chip",note:"Common child in wrap='wrap' tag/chip rows",relationship:["complement"]},{name:"Show",note:"Pair with Hide to swap whole trees at a breakpoint instead of changeDirectionAbove",relationship:["complement"]},{name:"Responsive.Hide",note:"Pair with Show for breakpoint layout swaps",relationship:["complement"]}]},BrandBadge:{description:'Displays Rippling brand badges with consistent styling. Badges come in animated (Lottie-based) and static (SVG) variants. Use for decorative brand moments, empty states, success confirmations, or feature illustrations. Animated badges play once by default; use motion="static" to freeze them.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{motion:{description:'Controls animation behavior. Only applies to animated badge types. "animated" plays animation, "static" shows first frame. Default: animated',enum:["animated","static"],type:"string"},type:{description:"Badge type/icon to display. Choose from animated or static badge types",enum:["ADD","AIRPLANE","BAR_CHART_DECREASE","BAR_CHART_INCREASE","BRAIN","BRAIN_AI","CALENDAR","CHECK_MARK","CLOCK","COINS_USD","CREDIT_CARD","DOCUMENT","ENTERPRISE","EXCLAMATION_MARK","FOLDERS","GEAR","GEAR_HEART","GEAR_PLAY","GLOBE","GRAD_CAP","HANDSHAKE","HEART","INTEGRATION","INVENTORY_MANAGEMENT","LAPTOP","LAPTOP_DEV","LIGHTNING_BOLT","LOCK","LOCK_UNLOCKED","MAGNIFYING_GLASS","MAGNIFYING_GLASS_QUESTION_MARK","NO_WIFI","OFFBOARDING","ONBOARDING","PAYROLL_EURO","PAYROLL_RUPEE","PAYROLL_USD","PAYROLL_YEN","QUESTION_MARK","RECEIPT","REFRESH","SHIELD_CHECK","SPEECH_BUBBLE","THIRD_PARTY","TRAIN","UNIFIED_SYSTEM","X","API_ERROR","APPROVAL_STAMP","AVATAR","BRIEFCASE","CAR","CONFETTI","CRYSTAL_BALL","EXPENSE","EXPLOSION","EYE","FIRE","FLAG","GOVERNMENT","HAND_POINTING","HAND_WAVING","HAPPY_SAD_FACE","HEADCOUNT_PLANNING","KEY","LIGHTBULB","LIGHTNING_BOLT_HEXAGON","MEGAPHONE","METER","MID_SIZE_BUILDINGS","ORG_CHART_HORIZONTAL","ORG_CHART_VERTICAL","PENCIL","PHONE","PIE_CHART","ROCKET","ROCKING_CHAIR","SHIELD_STAR","SHOOTING_STAR","SKULL","SMALL_BUSINESS_BUILDING","SPARKLE","TEAM","THUMBS_UP","TICKET","TOOTH","TROPHY"],type:"string"}},required:["type"],type:"object"},acceptsChildren:!1,category:["atom"],keywords:["brand badge","brandbadge","lottie","illustration","empty state","success animation","onboarding","animated badge","milestone","setup complete","feature education","confirmation graphic"],anatomy:{parts:[{name:"illustration",required:!0,role:"Curated Lottie or SVG asset selected by type (CHECK_MARK, REFRESH, MAGNIFYING_GLASS_QUESTION_MARK, ...)"},{name:"sized container",required:!0,role:"Caller-provided wrapper with explicit height and width that sizes the badge"},{name:"adjacent copy",role:"Nearby text describing the outcome — the artwork must never be the only explanation"}],summary:'A single brand illustration whose `type` picks the asset from the curated registry (animated Lottie or static SVG — encoded per type). Animated types accept motion="static" to freeze on the first frame. Sizes to its parent, which must have explicit height and width to avoid clipping and layout shift.'},guidance:{doNotUseWhen:["Unknown-duration loading — use Spinner","Known-duration progress — use ProgressBar","Predictable layout loading placeholders — use Spinner.FieldLoader or Skeleton","Custom animation assets or playback control — use LottiePlayer","Pure decoration without state meaning — use Icon"],useWhen:["Illustrated empty states — zero-data screens that should feel intentional","Onboarding and setup milestones — payroll setup complete, hardware configured, flow finished","Contextual status feedback — success, warning, or error moments needing more than an icon","Feature education moments — short looped motion introducing unfamiliar flows","Always wrap in a container with explicit height and width"]},antiPatterns:["Illustrated state without adjacent explanatory copy","Legacy `Animation` component still used instead of BrandBadge","Raw `LottiePlayer` pointed at Pebble badge CDN paths","BrandBadge in loading contexts where Spinner is documented"],selection:{confusedWith:[{component:"Icon",distinguishBy:"Icon is a small functional glyph tied to meaning or action; BrandBadge is a large curated illustration reinforcing an emotional or milestone moment"},{component:"LottiePlayer",distinguishBy:"LottiePlayer plays arbitrary custom Lottie JSON with runtime playback control; BrandBadge renders only Pebble-curated assets via BrandBadge.TYPES"},{component:"Animation",distinguishBy:"Animation is the legacy component BrandBadge supersedes — migrate to BrandBadge.TYPES"},{component:"Spinner",distinguishBy:"Spinner signals in-progress work of unknown duration; BrandBadge celebrates or illustrates a state, never a loading wait"}]},relatedComponents:[{name:"Animation",note:"Deprecated predecessor — use BrandBadge instead",relationship:["alternative"]},{name:"LottiePlayer",note:"Custom, non-curated Lottie assets or fine-grained playback control",relationship:["alternative"]},{name:"Icon",note:"Non-essential decoration or small functional glyphs",relationship:["alternative"]},{name:"Spinner",note:"Unknown-duration loading states",relationship:["alternative"]},{name:"ProgressBar",note:"Known-duration, measurable progress",relationship:["alternative"]}]},Breadcrumb:{description:"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.",events:["select"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{active:{description:"Value of the active breadcrumb item. Default: last item",type:"string"},"aria-describedby":{description:"ID of element that describes the breadcrumb nav",type:"string"},"aria-label":{description:"Accessible label for the breadcrumb nav",type:"string"},"aria-labelledby":{description:"ID of element that labels the breadcrumb nav",type:"string"},items:{description:"Array of breadcrumb items: {title, value, isDisabled?, href?}",items:{additionalProperties:!1,properties:{href:{description:"URL to navigate to when clicked",type:"string"},isDisabled:{description:"Disables the breadcrumb item",type:"boolean"},title:{description:"Display label for the breadcrumb item",type:"string"},value:{description:"Unique value identifier for the item",type:"string"}},required:["title","value"],type:"object"},type:"array"},noMargin:{description:"Remove default margin from the component. Default: false",type:"boolean"},shouldCollapseMiddle:{description:"Collapse middle items into a dropdown on desktop. Default: false",type:"boolean"},shouldTruncateItems:{description:"Truncate breadcrumb item text to one line at 128px and show full text in a tooltip on overflow. Default: false",type:"boolean"}},required:["items"],type:"object"},acceptsChildren:!1,category:["navigation"],keywords:["breadcrumb","breadcrumbs","navigation trail","hierarchy","path trail","back navigation","location trail","parent pages","deep navigation","record detail","drill down","list to detail"],anatomy:{parts:[{name:"Items",required:!0,role:"Ordered { title, value } links from the hierarchy root to the current page"},{name:"Delimiter",required:!0,role:"Atoms.Separator rendered between consecutive items"},{name:"Overflow menu",required:!1,role:"Dropdown of collapsed middle items when shouldCollapseMiddle is set"},{name:"Active item",required:!1,role:"The current page; mark with the active prop or isDisabled, never an empty destination"}],summary:"A horizontal trail of labeled links separated by delimiters, ending at the current page. Long hierarchies collapse middle items into an overflow dropdown (shouldCollapseMiddle); individual labels can truncate to one line with an automatic tooltip (shouldTruncateItems). Typically rendered inside Page.Header."},guidance:{doNotUseWhen:["Flat page structures with no hierarchy — a simple back Anchor or Button suffices","Peer-level section or tab navigation — use AppNavBar or Tabs instead","Linear step navigation in multi-page forms or flows — use ProgressSteps instead","Rendering items without a navigation handler — the trail must actually navigate","Marking the current page with an empty destination — use isDisabled on the item instead"],useWhen:["Pages deep in a hierarchical information architecture — show the path back to higher levels","Record detail pages reached from a list — the trail above ObjectUI.Header","Alongside primary navigation (menus, tabs) as a quick way up without cluttering the UI","Long trails that need middle collapse (shouldCollapseMiddle) or per-item truncation","Inside Page.Header as the page's location context"]},antiPatterns:["Legacy CSS margin wrappers used instead of `noMargin` and layout spacing","Current-page item uses empty destination instead of `isDisabled`","Deep hierarchy rendered without middle collapse","Custom Emotion or styled wrappers apply hardcoded spacing on top of Breadcrumb","Hand-rolled breadcrumb trail built from Text, Icon, or buttons instead of Breadcrumb","Breadcrumb rendered with `items` but no navigation handler","Fixed-position page chrome with hardcoded colors around the trail","Legacy or incorrect component API (`list` prop instead of `items`)"],selection:{confusedWith:[{component:"Tabs",distinguishBy:"Tabs switch between peer-level content panels; Breadcrumb walks a hierarchical ancestry path back to higher-level pages"},{component:"AppNavBar",distinguishBy:"AppNavBar is app-level route navigation across peer sections; Breadcrumb shows the hierarchical path to the current page"},{component:"Anchor",distinguishBy:"A single back link or Anchor suffices for flat structures; Breadcrumb earns its place only with a real multi-level hierarchy"},{component:"ProgressSteps",distinguishBy:"ProgressSteps shows linear step progress through a flow; Breadcrumb is a hierarchical location trail — do not use it as a step navigator in multi-page forms"}]},relatedComponents:[{name:"Page.Header",note:"Breadcrumbs belong as child content inside Page.Header, not standalone elsewhere on the page",relationship:["parent"]},{name:"AppNavBar",note:"Peer-level route navigation instead of a hierarchical trail",relationship:["alternative"]},{name:"Tabs",note:"Peer-level in-page or route switching instead of ancestry navigation; often co-exists with Breadcrumb on list-to-detail pages",relationship:["alternative"]},{name:"Anchor",note:"Single back link for flat structures with no hierarchy",relationship:["alternative"]},{name:"ProgressSteps",note:"Linear step progress for multi-page flows, not a location trail",relationship:["alternative"]},{name:"ObjectUI.Header",note:"Record summary header on detail pages the trail leads to",relationship:["complement"]},{name:"Dropdown",note:"Renders the collapsed-middle overflow menu",relationship:["complement"]}]},Button:{description:"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.",events:["press","pressWhileDisabled","mouseEnter","mouseLeave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Visual style variant. Default: PRIMARY",enum:["PRIMARY","DESTRUCTIVE","OUTLINE","GHOST","ACCENT","SUCCESS","INFO","WARNING","SOLID","ACTIVE"],type:"string"},"aria-controls":{description:"ID of element controlled by this button",type:"string"},"aria-describedby":{description:"ID of element that describes this button",type:"string"},"aria-expanded":{description:"Indicates whether controlled element is expanded",type:"boolean"},"aria-haspopup":{anyOf:[{type:"boolean"},{enum:["menu","listbox","tree","grid","dialog"],type:"string"}],description:"Indicates button triggers a popup element"},"aria-label":{description:"Accessibility label for the button",type:"string"},"aria-labelledby":{description:"ID of element that labels this button",type:"string"},"aria-pressed":{anyOf:[{type:"boolean"},{enum:["mixed"],type:"string"}],description:"Indicates button pressed state (for toggle buttons)"},badge:{description:"Badge text shown on the button",type:"string"},contentAlignment:{description:"Horizontal alignment of button content. Default: CENTER",enum:["CENTER","START"],type:"string"},fontInherit:{description:"When variant is TEXT, inherit font from parent element. Only works with TEXT variant. Default: false",type:"boolean"},icon:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{alignment:{description:"Icon alignment relative to label. Default: LEFT",enum:["LEFT","RIGHT"],type:"string"},color:{description:"Pebble text/icon color token. Only supported for OUTLINE, SOLID, GHOST appearances",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:'Icon type name (e.g., "CHECK", "EDIT_OUTLINE")',type:"string"}},required:["type"],type:"object"}],description:"Icon to show in button. Can be icon name string or object with type, color, alignment"},id:{description:"DOM id selector for the button element",type:"string"},inverseDisabledColors:{description:"Use inverse color tokens for disabled buttons on dark backgrounds. Default: false",type:"boolean"},isDisabled:{description:"Disables the button. Default: false",type:"boolean"},isFluid:{description:"Stretch to full container width. Default: false",type:"boolean"},label:{description:"Button text content",type:"string"},shouldShowSpinner:{description:"Show loading spinner explicitly. Default: false",type:"boolean"},size:{description:"Button size. Default: M",enum:["L","M","S","XS"],type:"string"},tabIndex:{description:"Tab order index for keyboard navigation",type:"number"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Control tooltip visibility from parent",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max height (number in px or CSS string)"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max width (number in px or CSS string)"},placement:{description:"Tooltip placement relative to button. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip configuration. Can be simple string content or object with appearance/placement"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{description:"Open link in new tab. Default: false",type:"boolean"},path:{description:"URL path for navigation",type:"string"}},required:["path"],type:"object"}],description:"Navigation destination. When provided, button renders as anchor and handles navigation automatically"},type:{description:"HTML button type attribute. Default: button",enum:["button","reset","submit"],type:"string"},variant:{description:"Button variant type. Default: NORMAL",enum:["NORMAL","TEXT"],type:"string"}},type:"object"},acceptsChildren:!1,category:["buttons"],keywords:["button","cta","call to action","submit","save","action","click","primary action"],anatomy:{parts:[{name:"label",required:!0,role:"Verb-led action text passed as children"},{name:"icon",role:"Optional glyph via the icon prop when it aids recognition"},{name:"badge",role:"Optional short status text beside the label"}],summary:"A sized container holding a verb-led text label, with an optional leading icon and an optional short badge beside the label."},guidance:{doNotUseWhen:["Navigating to another page or URL — use Anchor","Icon-only action without an accessible name — use Button.Icon with aria-label","Toggleable selected state — use a segmented control or Switch","Dense repeated row actions — use a Menu or overflow pattern"],useWhen:["Submitting a form or confirming an action","Primary call-to-action on a page, card, or modal footer","Starting a flow (add, create, invite)","Icon-only action via Button.Icon with an accessible name"]},antiPatterns:[{instead:"Use Button.Icon with aria-label",pattern:"Icon-only actions built as Button with an icon prop and no label",why:"Ambiguous hierarchy and missing accessible name"},{instead:"Use Button.Icon",pattern:"Plain clickable Icon used for actions",why:"No button semantics, focus, or hit-area guarantees"},{instead:"Use Anchor with href",pattern:"Navigation implemented as Button + onClick router push",why:"Breaks link semantics, middle-click, and screen reader expectations"},{instead:"Keep the CTA enabled and surface inline validation errors",pattern:"Disabled primary CTA on forms and footers",why:"Users cannot trigger validation feedback"},{instead:"Open a confirmation Modal and place the destructive Button in Modal.Footer",pattern:"DESTRUCTIVE appearance used inline outside a confirmation modal",why:"Destructive actions need a confirmation step"},{instead:"Use PRIMARY for emphasis; reserve ACTIVE for selected state",pattern:"ACTIVE appearance used as a static color",why:"ACTIVE communicates selected/on state, not emphasis"},{instead:"Pick one size per surface (default M)",pattern:"Mixed button sizes on the same surface",why:"Breaks visual hierarchy"},{instead:"Use Button.Icon or a Menu for dense repeated actions",pattern:"Text variant used for dense toolbar or row actions",why:"Hierarchy and component choice become unclear"},{instead:"Always compose from Button",pattern:"Custom button-like control built from raw elements",why:"Loses accessibility, theming, and state-layer behavior"},{instead:"Use Button.SIZES",pattern:"Legacy BUTTON_SIZES constant",why:"Deprecated alias"},{instead:'Use a single verb-led label like "Save changes"',pattern:"Vague, compound, or non-verb-led labels",why:"Users cannot predict the outcome"},{instead:"Only add an icon when it disambiguates the action",pattern:"Decorative icon added to a labeled Button without clear necessity",why:"Adds noise without aiding recognition"}],propGuidance:[{guidance:"PRIMARY for the single main action on a surface; OUTLINE or GHOST for secondary actions; DESTRUCTIVE only inside confirmation flows.",pitfall:"ACTIVE is a selected/on state, not a static emphasis color.",prop:"appearance"},{guidance:"TEXT is for low-emphasis inline actions where context makes the target obvious; default to NORMAL.",prop:"variant"},{guidance:"Default M. Use S/XS only in dense surfaces and keep one size per surface.",prop:"size"},{guidance:"Accepts a glyph string or IconConfig with alignment and color. For icon-only actions use Button.Icon instead.",prop:"icon"},{guidance:"Avoid disabling the primary form CTA; let users attempt submission and show validation errors.",prop:"isDisabled"},{guidance:"Use for async actions to prevent double submits; pair with a label that stays stable while loading.",prop:"isLoading"}],selection:{confusedWith:[{component:"Anchor",distinguishBy:"Anchor navigates (href); Button performs an action (onClick). If the result is a URL change, use Anchor."},{component:"Button.Icon",distinguishBy:"Icon-only action → Button.Icon with aria-label; labeled action → Button."},{component:"SplitButton",distinguishBy:"One primary action with related alternatives in a menu → SplitButton."},{component:"FloatingButton",distinguishBy:"Action that must stay visible over scrolling content → FloatingButton."}]},relatedComponents:[{name:"Button.Icon",note:"Icon-only variant; requires aria-label",relationship:["child"]},{name:"SplitButton",note:"Primary action plus related alternatives",relationship:["child"]},{name:"FloatingButton",note:"Fixed-position action over content",relationship:["child"]},{name:"Anchor",note:"Navigation instead of action",relationship:["alternative"]},{name:"ButtonGroup",note:"Groups related buttons with shared sizing",relationship:["complement"]},{name:"Modal.Footer",note:"Canonical placement for modal action buttons",relationship:["complement"]}],subComponents:{"Button.Icon":{antiPatterns:[{instead:"Pass aria-label describing the action",pattern:"Button.Icon without aria-label or aria-labelledby",why:"Screen readers announce nothing meaningful"}],description:"Icon-only button for compact actions; always requires an accessible name."}}},ButtonGroup:{description:"Layout container for arranging multiple Button elements horizontally or vertically with configurable placement, alignment, gap, and wrapping.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alignment:{description:"Cross-axis alignment. Default: center",enum:["center","flex-start","flex-end"],type:"string"},containerHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Height of the button group container"},flexWrap:{description:"Whether buttons wrap to the next line",enum:["nowrap","wrap","wrap-reverse"],type:"string"},gap:{description:"Gap between buttons as a spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},placement:{description:"Layout placement of buttons. Default: horizontallyLeft",enum:["horizontallyLeft","horizontallyCenter","horizontallyRight","horizontallySpaceBetween","verticallyTop","verticallyCenter","verticallyBottom","verticallySpaceBetween"],type:"string"}},type:"object"},acceptsChildren:!0,category:["layout"],keywords:["button group","buttongroup","action row","footer actions","save cancel","confirm actions","form actions","dialog footer","toolbar buttons","button layout","button stack"],anatomy:{parts:[{name:"Container",required:!0,role:"Flex container whose placement prop aligns/distributes children (HORIZONTALLY_RIGHT for footers, SPACE_BETWEEN for back/next)"},{name:"Button children",required:!0,role:"Two or more Buttons in DOM order; primary action last in left/right-aligned groups"}],summary:"A layout-only flex container (plain div, no ARIA role) wrapping two or more Button children. Placement controls distribution (left, right, center, space-between, vertical variants); gap controls spacing and flexWrap handles overflow. All semantics and labels live on the child Buttons."},guidance:{doNotUseWhen:["Writing new code — use Layout.HStack or Layout.VStack from Layout instead","A single button — render Button directly; a group wrapper adds nothing","Navigation links — use Anchor or Tabs, not action buttons","Mutually exclusive option selection — use Input.SegmentedControl or RadioInput","Multi-select filter toggles — use Chip"],useWhen:["Legacy code only — ButtonGroup is deprecated; use Layout.HStack or Layout.VStack for new button layouts","Maintaining existing form action rows (Save/Cancel) and dialog footers with HORIZONTALLY_RIGHT","Wizard-style back/next pairs spread via HORIZONTALLY_SPACE_BETWEEN","Vertical button stacks in narrow side panels (vertical placements with containerHeight)"]},antiPatterns:["Deprecated ButtonGroup still used instead of Layout.HStack/Layout.VStack","ButtonGroup wraps only one button — unnecessary layout wrapper","Confirmation/footer actions not right- or space-between-aligned in page/modal footers","Deprecated `spacing` prop used instead of `gap` or theme tokens","ButtonGroup used for multi-select filter toggles instead of Chip","Redundant custom styled wrapper around ButtonGroup duplicates layout concerns","Center-aligned action rows in footers where users expect primary action on the right","Mixed import styles (barrel `@rippling/pebble` vs sub-path) increase inconsistent migration paths"],selection:{confusedWith:[{component:"Layout.HStack",distinguishBy:"Layout's Layout.HStack/Layout.VStack is the supported replacement — ButtonGroup is deprecated; use Layout.HStack/Layout.VStack with gap for all new button layouts"},{component:"SplitButton",distinguishBy:"SplitButton is one primary action with related alternatives behind a chevron; ButtonGroup lays out multiple independent peer buttons"},{component:"Input.SegmentedControl",distinguishBy:"Input.SegmentedControl is a single-choice selection control (radio-like); ButtonGroup triggers independent actions with no selected state"},{component:"Chip",distinguishBy:"Chip handles multi-select filter toggles with selected appearance; ButtonGroup buttons fire actions, not filter selection"}]},relatedComponents:[{name:"Button",note:"The only intended children; each Button owns its own label, appearance, and accessible name",relationship:["child"]},{name:"Layout.HStack",note:"Supported replacement for horizontal button rows (ButtonGroup is deprecated)",relationship:["alternative"]},{name:"Layout.VStack",note:"Supported replacement for vertical button stacks",relationship:["alternative"]},{name:"SplitButton",note:"One primary action plus related alternatives in a menu",relationship:["alternative"]},{name:"Input.SegmentedControl",note:"Mutually exclusive option selection instead of action buttons",relationship:["alternative"]},{name:"Chip",note:"Multi-select filter toggles instead of action buttons",relationship:["alternative"]},{name:"Modal.Footer",note:"Footer container where HORIZONTALLY_RIGHT groups of confirm/cancel buttons live",relationship:["complement"]}]},Calendar:{description:"An inline calendar for selecting single or multiple dates. Displays a monthly view with navigation controls. Use for date selection UI without input field — when the calendar should always be visible. Use Date input for calendar in a popover; use DateInlineMulti for multiple date selection with different layout options.",events:["click","clear","confirmMobile"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{displayDate:{description:"Month to show initially as an ISO date string",type:"string"},format:{description:"Date display format. Default: MM/dd/yyyy",enum:["yyyy/MM/dd","yyyy-MM-dd","MM/dd/yyyy","dd/MM/yyyy","yyyy/MM/dd hh:mm a","yyyy-MM-dd hh:mm a","MM/dd/yyyy hh:mm a","dd/MM/yyyy hh:mm a","yyyy/MM/dd hh:mm:ss a","yyyy-MM-dd hh:mm:ss a","MM/dd/yyyy hh:mm:ss a","dd/MM/yyyy hh:mm:ss a","ISO_STRING"],type:"string"},isDisabled:{description:"Disables the calendar",type:"boolean"},isLarge:{description:"Renders large calendar when true. Default: false",type:"boolean"},locale:{description:"Locale string used to determine the start of week",type:"string"},maxDate:{description:"Latest selectable date as ISO string",type:"string"},minDate:{description:"Earliest selectable date as ISO string",type:"string"},shouldShowFooter:{description:"Controls footer visibility. Default: true",type:"boolean"},shouldShowHeader:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{headerActions:{description:"Show month/year navigation",type:"boolean"}},required:["headerActions"],type:"object"}],description:"Controls header visibility. Default: true"},shouldShowWeekDayInitials:{description:"If false, hides week day initials. Default: true",type:"boolean"},showMonthYearPicker:{description:"Show month and year picker in the calendar header. Default: false",type:"boolean"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Selected date(s) as ISO string(s). Single date or array for multi-select"}},type:"object"},acceptsChildren:!1,category:["date"],keywords:["calendar","month view","date grid","inline calendar","booking","month picker","year picker","date picker popover"],anatomy:{parts:[{name:"header",required:!0,role:"Month/year label with prev/next navigation; showMonthYearPicker adds quick jumps"},{name:"weekday row",required:!0,role:"Column headers for days of the week"},{name:"day grid",required:!0,role:"Day cells with selected/disabled/today states; honors minDate, maxDate, filterDate"}],summary:"A month-grid date picker: a header with the month/year label and prev/next navigation (optionally a month/year picker for distant jumps), a weekday header row, and day cells with selected, disabled, and today states. Rendered inline with no text field."},guidance:{doNotUseWhen:["Standard form date entry — use Input.Date, which adds a text field and popover","Start/end date pair — use Input.Date.Range (Input.Date.Range)","Form-ready multi-date selection with chips — use Input.Date.InlineMulti","Displaying a date without interaction — use Text"],useWhen:["Always-visible date picking without a text field trigger — booking pages, time-off requests","Selecting several non-contiguous dates directly on a month grid","Restricting selection with minDate/maxDate or filterDate (weekends, booked dates)","Jumping to distant months with showMonthYearPicker (birthdates, historical dates)","Setting displayDate so the initial month matches the context"]},antiPatterns:["Inline calendar without initial month aligned to context","Availability disabling without adjacent explanation","Calendar used where Input.Date form field is expected"],selection:{confusedWith:[{component:"Input.Date",distinguishBy:"Input.Date wraps the calendar in a labeled text field with popover for standard form use; Calendar is the bare always-visible grid"},{component:"Input.Date.InlineMulti",distinguishBy:"Input.Date.InlineMulti is the form-ready inline multi-date selector with chips; Calendar is the lower-level grid it and the date inputs are built on"},{component:"Input.Date.Range",distinguishBy:"Input.Date.Range (Input.Date.Range) selects a start/end pair via field popovers; Calendar shows a single grid for direct day clicks"}]},relatedComponents:[{name:"Input.Date",note:"Text field plus calendar popover for forms; Input.Date and Input.Date.Range render Calendar internally",relationship:["alternative"]},{name:"Input.Date.Range",note:"Start/end date pair",relationship:["alternative"]},{name:"Input.Date.InlineMulti",note:"Form-ready multi-date selection with chips",relationship:["alternative"]},{name:"Text",note:"Displaying a date with no interaction",relationship:["alternative"]}]},Card:{description:"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).",events:["edit","delete","add","click","action"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{actions:{description:'Array of action objects {id, label, icon}. Displayed as dropdown options. Emits "action" event with clicked action id written to actionId state',items:{additionalProperties:!1,properties:{icon:{description:'Icon name from Icon.TYPES (e.g. "EDIT", "DELETE")',type:"string"},id:{description:"Unique identifier for the action",type:"string"},label:{description:"Label text for the action",type:"string"}},required:["id","label"],type:"object"},type:"array"},actionsDropdownWidth:{description:"Width in pixels for the actions dropdown",type:"number"},content:{description:"Text content to display in the card body",type:"string"},fluid:{description:"Layout mode only. When true, the card fills its parent width (including inside row layouts, where it would otherwise size to its content). Ignored when title or content is set (basic card mode). Default: false",type:"boolean"},isAddCard:{description:'Render as add card with plus icon. Emits "add" event when clicked. Default: false',type:"boolean"},isDisabled:{description:"Whether the card is disabled. Default: false",type:"boolean"},minCardHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum height of card. Number values are pixels. Default: 150"},padding:{anyOf:[{const:0,type:"number"},{const:8,type:"number"},{const:16,type:"number"},{const:24,type:"number"},{const:32,type:"number"},{type:"string"}],description:"Padding for layout mode. Supports Card.Layout PADDINGS values or CSS string"},selectedActionId:{description:'Bound state path for the selected action id. Written before "action" event fires',type:"string"},showDelete:{description:'Show delete button. Emits "delete" event when clicked. Default: false',type:"boolean"},showEdit:{description:'Show edit button. Emits "edit" event when clicked. Default: false',type:"boolean"},theme:{description:"Visual theme for layout mode. DEFAULT or SELECTABLE",enum:["DEFAULT","SELECTABLE"],type:"string"},title:{description:"Card header title text",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Route destination. String URL or object with {path, openInNewTab}. Card renders as anchor when provided"},value:{description:"Identifier value for the card, passed to event handlers"}},type:"object"},acceptsChildren:!0,category:["card"],keywords:["card","tile","panel","module","entity summary","edit delete actions","add card","card grid","selectable card","dashboard","settings panel","location card","onboarding","setup guide","time off"],anatomy:{parts:[{name:"Container",required:!0,role:"Rounded, bordered surface with elevation"},{name:"Title",required:!1,role:"Heading identifying the entity on the card; pass via the title prop, not inside content"},{name:"Content",required:!0,role:"Free-form body content; keep it brief and scannable"},{name:"Actions",required:!1,role:"Edit/delete/add affordances or a dropdown via the actions prop; `to` renders the whole card as a link"}],summary:"Card.Basic: an elevated container with a title at top, concise body content in the middle, and optional inline edit / delete / add affordances or an overflow dropdown of custom actions on the trailing edge. Cards render standalone or in an auto-sizing Card.Group grid; `to` turns a card into a navigable link."},guidance:{doNotUseWhen:["Pure navigation to another page or section — use an Anchor instead","Scannable lists of related records — use ListItem instead","Dense datasets for reference or comparison — use TableBasic instead","High-priority information needing immediate attention — use a Modal instead","Unrelated content or general page layout — use Layout.Box or Layout.VStack instead","Empty/success/error placeholder states — use ActionCard instead"],useWhen:["Grouping related information or actions into discrete panels — settings modules, dashboards, onboarding setup guides","Guiding users toward specific actions or navigation for an entity (edit, delete, open details)","Presenting single or multiple selection options as a card grid (Card.Group + SELECTABLE theme)","Listing a small set of entities with inline edit/delete, plus an add-card affordance","Navigation cards — pass `to` to render the whole card as a link"]},antiPatterns:["Semantic cards built with `Card.Layout` and manual headings instead of `Card.Basic` with `title`","`Card.Basic` used without the `title` prop — headings buried inside content","Multiple stacked `Card.Layout` sections fragment detail views without grouping","`Card.Basic` wrapping dense tables or grids meant for reference scanning","Full-bleed marketing or hero content forced through `Card.Layout` with zero padding","Deprecated `Input.SelectableGroup` basic/location card renderer still in use","Nested icon actions inside a clickable `Card.Layout` — ambiguous click targets","Interactive `Card.Layout` missing `SELECTABLE` theme — weak selection affordance","Every page section wrapped in Cards instead of reserving cards for discrete panels"],selection:{confusedWith:[{component:"ActionCard",distinguishBy:"ActionCard is a purpose-built state placeholder (empty/success/error) with asset, title, caption, and CTA baked in; Card is a generic container for an entity's content and actions"},{component:"ListItem",distinguishBy:"ListItem presents a related set of records as scannable rows; Card is for discrete panels of related information that benefit from a segmented surface"},{component:"Card.Layout",distinguishBy:"Card.Layout is the bare bordered container with configurable padding; use Card.Basic when the card needs a title and built-in edit/delete/actions"},{component:"TableBasic",distinguishBy:"TableBasic presents intricate datasets for reference, comparison, or selection; Card presents concise, actionable information about one entity"},{component:"Anchor",distinguishBy:"Anchor is preferable when the only job is navigating to another page, section, or external link; Card groups content and actions, not just a link"}]},relatedComponents:[{name:"Card.Group",note:"Auto-sizing responsive grid for Card.Basic / Card.Location / Card.Loader children",relationship:["child"]},{name:"Card.Layout",note:"Bare card container with configurable padding and a SELECTABLE theme for selection UIs",relationship:["child"]},{name:"Card.Location",note:"Specialized card rendering a location nickname and formatted address",relationship:["child"]},{name:"Card.Loader",note:"Skeleton placeholder shown in place of a card while its data loads",relationship:["child"]},{name:"ActionCard",note:"Purpose-built empty/success/error state surface with asset, caption, and CTA",relationship:["alternative"]},{name:"ListItem",note:"Scannable row format for related records instead of segmented cards",relationship:["alternative"]},{name:"Anchor",note:"Plain navigation when no content grouping is needed",relationship:["alternative"]},{name:"TableBasic",note:"Dense tabular display for reference or comparison of many records",relationship:["alternative"]}]},CardGroup:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{minCardHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum height of each card. Number values are pixels. Default: 150"},placement:{description:"Horizontal alignment of cards within the container. One of: HORIZONTALLY_LEFT, HORIZONTALLY_CENTER, HORIZONTALLY_RIGHT, HORIZONTALLY_SPACE_BETWEEN",enum:["HORIZONTALLY_LEFT","HORIZONTALLY_CENTER","HORIZONTALLY_RIGHT","HORIZONTALLY_SPACE_BETWEEN"],type:"string"}},type:"object"},acceptsChildren:!0,category:["card"],keywords:["card group","card grid","tiles","card layout","cardgroup (card.group)","location grid","responsive cards","add card","uniform card width","bank accounts","risk grid"],anatomy:{parts:[{name:"Layout.Grid container",required:!0,role:"Responsive wrapper that computes uniform card widths and alignment"},{name:"Card children",required:!0,role:"Card.Basic, Card.Location, or Card.Loader items; semantic cards only, not layout containers"},{name:"Add card",required:!1,role:"Optional trailing Card.Basic with onAdd for creating new entities"}],summary:"A wrapping grid of uniformly sized card children. Card.Group computes each card's width from the container space; placement controls horizontal alignment and minCardHeight sets a shared minimum height. A trailing Card.Basic with onAdd conventionally serves as the add-card tile."},guidance:{doNotUseWhen:["A single card — render the card directly without a wrapper","Non-card children or arbitrary layout content — use Layout.Box or Layout.VStack instead","Scannable record rows — use ListItem with ListItem.Layout instead","Page-level sections — one Card.Layout or page layout region, not stacked card groups"],useWhen:["Displaying a collection of Card.Basic or Card.Location cards as a responsive grid","Entity collections that need uniform tile sizing — locations, bank accounts, time-off summaries, risk/super-user images","Card grids that include a trailing add-card affordance (Card.Basic with onAdd)","Aligning grouped cards horizontally via the placement prop"]},antiPatterns:["Card.Group wrapping layout containers instead of semantic card children","Group used for a single card — unnecessary wrapper","Card.Basic tiles in groups missing `title` — anonymous grid cells","Manual flex/grid layouts duplicating Card.Group sizing","Risk/super-user image grids without add-card affordance"],selection:{confusedWith:[{component:"Layout.Grid",distinguishBy:"Layout.Grid renders a data-driven read-only label/value summary of one record; Card.Group arranges multiple semantic cards as uniform tiles"},{component:"Card.Layout",distinguishBy:"Card.Layout is a single bordered container for arbitrary content; Card.Group arranges multiple semantic cards in a grid"},{component:"ListItem",distinguishBy:"ListItem renders records as scannable rows; Card.Group renders entities as segmented card tiles when edit/add affordances matter"}]},relatedComponents:[{name:"Card.Basic",note:"Standard grouped child; use onAdd on a trailing card for the add-entity tile",relationship:["child"]},{name:"Card.Location",note:"Location cards as grouped tiles",relationship:["child"]},{name:"Card.Loader",note:"Loading placeholders inside the grid",relationship:["child"]},{name:"Card",note:"Namespace owning Card.Group and the card variants it arranges",relationship:["parent"]},{name:"Layout.Grid",note:"Data-driven label/value summary grid instead of card tiles",relationship:["alternative"]},{name:"Card.Layout",note:"A single bordered container; not a multi-card grid",relationship:["alternative"]},{name:"ListItem",note:"Row-based presentation instead of card tiles",relationship:["alternative"]}]},Carousel:{description:"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.",events:["done"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{slides:{description:"Array of slide configurations with heading and image",items:{additionalProperties:!1,properties:{alt:{description:"Alt text for the slide image",type:"string"},heading:{description:"Slide heading text",type:"string"},img:{description:"Slide image URL",type:"string"}},required:["heading","img"],type:"object"},type:"array"}},required:["slides"],type:"object"},acceptsChildren:!1,category:["complex"],keywords:["onboarding tour","product tour","walkthrough","feature announcement","slides","cross-sell","what's new","getting started"],anatomy:{parts:[{name:"Slide image",required:!0,role:"Illustration carrying the slide's message; needs dedicated alt text"},{name:"Slide heading",required:!0,role:"Short title for the slide — no paragraphs or links"},{name:"Pagination",required:!0,role:"Progress indicator through the slide sequence"},{name:"Done action",required:!0,role:"Final-slide completion handoff via onDone"}],summary:"A dialog containing one slide at a time: an illustration image with a heading, pagination indicating progress through the sequence, back/next navigation, and a Done action on the final slide."},guidance:{doNotUseWhen:["Multi-step flows with forms, inputs, or validation — use Stepper","Auto-advancing or marketing-style rotating banners — Carousel does not support auto-advance; do not work around it","Slides that need paragraphs, links, or rich content beyond image-and-heading","A single message or confirmation — use a Modal"],useWhen:["Guiding new users through a product or feature for the first time with a linear sequence of image-and-heading slides","Explaining a newly shipped feature in 3–5 contextual slides before the user starts interacting","Cross-sell or what's-new announcements that end in an explicit Done handoff"]},antiPatterns:["Pebble Carousel bypassed — custom CarouselDialog used for onboarding tours","Slides include paragraph descriptions and links beyond image-and-heading","Slide images rendered without dedicated alt text for assistive technology","Final-slide completion handoff missing — users exit via X instead of Done","Auto-advancing rotation enabled in CrossSell carousel infrastructure","Campaign-driven slide count unbounded — can exceed 5–6 slide readability limit"],selection:{confusedWith:[{component:"Stepper",distinguishBy:"Stepper walks users through a multi-step flow with forms and validation; Carousel is image-and-heading intro slides only"},{component:"Modal",distinguishBy:"Modal delivers a single message or decision; Carousel is a linear multi-slide sequence with a Done handoff"},{component:"ActionCard",distinguishBy:"ActionCard is a single inline empty/success/error state; Carousel is a multi-slide guided tour"}]},relatedComponents:[{name:"Stepper",note:"Multi-step flows with forms or complex content",relationship:["alternative"]},{name:"Modal",note:"Single message or confirmation instead of a slide sequence",relationship:["alternative"]},{name:"ActionCard",note:"Single inline state placeholder instead of a tour",relationship:["alternative"]},{name:"BrandBadge",note:"Curated illustrations commonly used as slide artwork",relationship:["complement"]}]},ChartLoader:{description:"A skeleton placeholder shown while chart or graph content is loading. Use when the content area will contain a chart and you want to reduce perceived loading time and prevent layout shift.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!1},Checkbox:{description:'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.',events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the checkbox",type:"string"},"aria-describedby":{description:"ID of element that describes this checkbox",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this checkbox",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial checked state when uncontrolled",type:"boolean"},isDisabled:{description:"Disables the checkbox",type:"boolean"},isIndeterminate:{description:"Sets checkbox to indeterminate (neither checked nor unchecked) state",type:"boolean"},isReadOnly:{description:"Makes the checkbox read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text for the checkbox. Ignored when the element has children (rich label).",type:"string"},secondaryLabel:{description:"Secondary text below the label",type:"string"},theme:{description:"Visual theme variant",enum:["FLUID_WIDTH","REVERSE","FLUID_WIDTH_SPACE_BETWEEN_REVERSE"],type:"string"},tip:{description:"Tooltip text shown on hover",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Checked state bound to state",type:"boolean"},variant:{description:"Display variant",enum:["BOX","LIST","GRID"],type:"string"}},type:"object"},acceptsChildren:!0,category:["input"],keywords:["checkbox","check box","tick box","boolean","agree","consent","terms","acknowledgment","select all","row selection","filter checkbox"],anatomy:{parts:[{name:"box",required:!0,role:"Square control showing unchecked, checked, or indeterminate state"},{name:"label",required:!0,role:"Text naming the option; empty only when an aria-label or adjacent text names it"},{name:"tip",role:"Optional tooltip explaining the option"}],summary:"A square box that is unchecked, checked, or indeterminate, paired with a label and an optional tooltip (tip). Used standalone for one boolean, as a select-all header with indeterminate state, or as a row-selection control in Layout.Grid and list renderers."},guidance:{doNotUseWhen:["The change must apply instantly with no submit — use Input.Switch","Exactly one of several mutually exclusive options — use Input.Radio","A related list of multi-select options — use Input.Checkbox.Group instead of mapping standalone checkboxes","Raw HTML <input type=checkbox> — always use the Pebble component"],useWhen:["A single on/off option saved with a form submit (include/exclude, opt-in)","Terms, consent, or acknowledgment checkboxes — validate with the isTrue validator","Select-all controls with an indeterminate state over partial selections","Row selection in grids, task lists, and multi-level selectors","Boolean filters applied to a visible list or table"]},antiPatterns:["Multi-select option lists built by mapping individual checkboxes instead of Input.Checkbox.Group","Standalone checkbox inside a Form submit flow, bypassing Form validation","Empty checkbox label with the visible name on nearby text only","Deferred settings row using Input.Checkbox with immediate onChange outside Form","Input.Checkbox group rendered outside Form without a group accessible name","Invalid checkbox styling without an inline error message on the field","Raw HTML checkbox instead of the Pebble Input.Checkbox component","Required acknowledgment checkbox missing the isTrue validator"],selection:{confusedWith:[{component:"Input.Switch",distinguishBy:"Input.Checkbox records a choice submitted later (supports error/indeterminate states); Switch applies the change instantly with no submit"},{component:"Input.Radio",distinguishBy:"Radio forces exactly one of several mutually exclusive options; Input.Checkbox is an independent yes/no per item"},{component:"Input.Checkbox.Group",distinguishBy:"Input.Checkbox.Group manages a multi-value list with one name and shared onChange; standalone Input.Checkbox is a single boolean field"}]},relatedComponents:[{name:"Input.Checkbox.Group",note:"Input.Checkbox.Group renders a list of checkboxes as one multi-select field",relationship:["child"]},{name:"Form.Input.Checkbox",note:"Form-aware variant; always use inside a Form instead of standalone Input.Checkbox",relationship:["complement"]},{name:"Form",note:"Owns validation and submission; required acknowledgments use the isTrue validator",relationship:["complement"]},{name:"Layout.Grid",note:"Row-selection and select-all checkboxes in grid headers/cells",relationship:["complement"]},{name:"Input.Switch",note:"Instant on/off setting with no submit step",relationship:["alternative"]},{name:"Input.Radio",note:"Mutually exclusive single choice from a list",relationship:["alternative"]}]},CheckboxGroup:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this checkbox group",type:"string"},"aria-label":{description:"Accessibility label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this checkbox group",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial values when uncontrolled",items:{},type:"array"},id:{description:"HTML id attribute for the checkbox group",type:"string"},isDisabled:{description:"Disables all checkbox options",type:"boolean"},isHorizontal:{description:"Arrange options in a row",type:"boolean"},isReadOnly:{description:"Makes the checkbox group read-only (displays as chips)",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the checkbox group",type:"string"},list:{description:"Array of { label, value } checkbox option objects",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this specific checkbox",type:"boolean"},label:{description:"Display text for the checkbox option",type:"string"},secondaryLabel:{description:"Secondary text below the option label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance style",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},label:{description:"Tag label text",type:"string"}},required:["label"],type:"object"}],description:"Optional tag/label displayed with the option"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when document scrolls. Default: false",type:"boolean"},isDelayed:{description:"Add delay before showing tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning relative to viewport. Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from state",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip content"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip content"},onlyIfChildOverflow:{description:"Only show tooltip if any child content overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if content overflows. Default: false",type:"boolean"},overwriteMiddleware:{description:"Overwrite default floating-UI middleware. Default: false",type:"boolean"},padding:{description:"CSS padding value for tooltip content",type:"string"},placement:{description:"Tooltip placement relative to the checkbox option",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"},shallSkipOverflowY:{description:"Skip overflow check on Y axis. Default: false",type:"boolean"},tipHideDelay:{description:"Milliseconds to wait before hiding tooltip when delayed",type:"number"},tipShowDelay:{description:"Milliseconds to wait before showing tooltip when delayed",type:"number"},title:{description:"Tooltip title text",type:"string"},truncateClassName:{description:"CSS class when onlyIfOverflow is enabled",type:"string"}},required:["content"],type:"object"}],description:"Tooltip shown on hover. Can be simple string text or a TipTypes object"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},theme:{description:"Theme styling: FLUID_WIDTH for full-width options, REVERSE for reversed theme",enum:["FLUID_WIDTH","REVERSE","FLUID_WIDTH_SPACE_BETWEEN_REVERSE"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Currently selected values bound to state",items:{},type:"array"},variant:{description:"Visual variant: BOX for boxed layout, LIST for list layout, GRID for grid layout",enum:["BOX","LIST","GRID"],type:"string"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["checkbox group","multi select","multiple options","filter checkboxes","bulk select","column picker","permission picker","filter sidebar","checkboxgroup"],anatomy:{parts:[{name:"group label",required:!0,role:"Accessible name for the whole group; wire visible headings to it"},{name:"checkbox option",required:!0,role:"One selectable row/box from the list entries (label + value)"},{name:"secondary label / tag / tip",role:"Optional per-option description, status chip, or tooltip"}],summary:"A named group (name prop) rendering a stacked list of checkbox rows, each with label, optional secondaryLabel, tag, and tip. Variants change the option chrome (default dot-box, LIST rows, BOX/GRID cards); themes like FLUID_WIDTH stretch options and REVERSE places the box after the label. isHorizontal lays options side by side."},guidance:{doNotUseWhen:["Exactly one option may be chosen — use Input.Radio","A single boolean option — use standalone Input.Checkbox","The list is long or space is tight — use Input.Select with multi-select","Options need rich custom card content — use Input.SelectableGroup with isMulti","Changes must apply instantly per option — consider Input.Switch rows instead"],useWhen:["Users may select none, some, or all options from a related list","Filter sidebars and filter drawers (brands, amenities, statuses, columns)","Bulk-selection pickers in modals (tasks, documents, permissions)","Options benefit from visible comparison with secondary labels or tags","Multi-value field in a Form — use Form.Input.Checkbox.Group for validation"]},antiPatterns:["Input.Checkbox.Group rendered outside Form with manual controlled state","Same static `name` repeated on Input.Checkbox.Group inside a `.map()` loop","Filter sidebar group with visual heading not programmatically linked","Input.Checkbox.Group instance missing the `name` prop","Controlled filter group with immediate `onChange` using list variant styling"],selection:{confusedWith:[{component:"Input.Radio",distinguishBy:"Input.Checkbox.Group allows none/some/all selections; Radio forces exactly one mutually exclusive choice"},{component:"Input.Checkbox",distinguishBy:"Standalone Input.Checkbox is a single boolean field; Input.Checkbox.Group manages a multi-value list under one name"},{component:"Input.SelectableGroup",distinguishBy:"Input.SelectableGroup renders rich custom cards per option; Input.Checkbox.Group covers text-label options with built-in variants"},{component:"Input.Select",distinguishBy:"Input.Select multi collapses long lists into a dropdown field; Input.Checkbox.Group keeps a short list visible for comparison"}]},relatedComponents:[{name:"Input.Checkbox",note:"Group is a sub-component: Input.Checkbox.Group",relationship:["parent"]},{name:"Form.Input.Checkbox.Group",note:"Form-aware variant; always use inside a Form instead of standalone Input.Checkbox.Group",relationship:["complement"]},{name:"Form",note:"Owns validation and submission for the group's selected values",relationship:["complement"]},{name:"Input.Radio",note:"Single mutually exclusive selection from a list",relationship:["alternative"]},{name:"Input.SelectableGroup",note:"Multi-select with rich card content per option",relationship:["alternative"]},{name:"Input.Select",note:"Compact multi-select dropdown when the list is long or space is tight",relationship:["alternative"]}]},CheckList:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{canSelectAll:{description:'Show a "Select All" option at the top. Default: false',type:"boolean"},hasIndependentActions:{description:"Checking/unchecking an item does not affect parent or child items",type:"boolean"},hasIndependentChildActions:{description:"Checking/unchecking a child does not affect ancestor items",type:"boolean"},indent:{description:"Indentation in pixels for nested children",type:"number"},list:{description:"Array of checklist items with nested branches",items:{$ref:"#/$defs/CheckListItem"},type:"array"},selectAllText:{description:"Custom label for the select all option",type:"string"},shouldHaveNegativeCheckbox:{description:"Show negative (red) checkbox style when type is CHECKBOX",type:"boolean"},shouldShowIndeterminate:{description:"Show indeterminate state on parent when some children are checked",type:"boolean"},showMoreSize:{description:'Number of items shown before "show more" toggle at global level',type:"number"},theme:{description:"Visual theme controlling border and padding: NO_PADDING, NO_BORDER, or NO_PADDING_NO_BORDER",enum:["NO_PADDING","NO_BORDER","NO_PADDING_NO_BORDER"],type:"string"},title:{description:"Checklist title text",type:"string"},type:{description:"Input type for all items: SWITCH or CHECKBOX",enum:["SWITCH","CHECKBOX"],type:"string"}},required:["list","title","type"],type:"object"},acceptsChildren:!1,category:["input"],keywords:["check list","checklist","multi select","multiple selection","checkbox list","switch list","select all","permissions","toggles","feature flags","nested checkboxes"],anatomy:{parts:[{name:"title",required:!1,role:"Header giving context for the whole list"},{name:"list rows",required:!0,role:"Label + checkbox or switch per item (type=CHECKBOX or SWITCH)"},{name:"expandable arrows",required:!1,role:"Reveal nested branches under a parent row"},{name:"select all",required:!1,role:"Optional bulk-toggle row via canSelectAll/selectAllText"},{name:"show more",required:!1,role:"Collapses long lists behind an expander via showMoreSize"}],summary:"A titled, bordered list of rows where each row is a label with a checkbox or switch. Nested items (via branches) sit indented under expandable arrows, parents show an indeterminate state when partially selected, an optional select-all row checks everything, and long lists collapse behind a show-more link."},guidance:{doNotUseWhen:["Only one option can be chosen — use Input.Radio or Input.Select","A simple flat checkbox group in a form — use Input.Checkbox.Group or Form.Input.Checkbox.Group","Options need rich card-style content — use Input.SelectableGroup","Rows need no interaction — use ListItem or plain typography","Space is tight and options can hide behind a trigger — use Input.Select"],useWhen:["Users select multiple options from a visible list — permissions, privileges, notification preferences","Options nest in parent-child groups needing indeterminate parent state (shouldShowIndeterminate)","On/off feature toggles managed as a set (type=SWITCH)","Bulk selection with select-all and truncated long lists (canSelectAll + showMoreSize)"]},antiPatterns:["Nested lists without indeterminate parent state","List title omitted while the same heading is rendered elsewhere",'Built-in "show more" truncation disabled on long lists','Synthetic "select all" row hand-rolled into list data',"Validation errors shown as ad-hoc styled text instead of standard feedback","Missing explicit `type` prop on CheckList instance","Theme variant passed as raw string instead of `CheckList.THEMES` constant"],selection:{confusedWith:[{component:"Input.Checkbox.Group",distinguishBy:"Input.Checkbox.Group is a flat group of checkboxes for form fields; CheckList adds list chrome — title, nesting, select-all, and show-more truncation"},{component:"Input.SelectableGroup",distinguishBy:"Input.SelectableGroup renders options as selectable cards with rich content; CheckList rows are plain label + checkbox/switch"},{component:"ListItem",distinguishBy:"ListItem rows display content with slots; CheckList rows exist to be toggled and report their checked state via onChange"},{component:"Input.Switch",distinguishBy:"Input.Switch toggles one setting; CheckList type=SWITCH manages a whole list of on/off toggles together"},{component:"Input.Select",distinguishBy:"Input.Select hides options behind a dropdown to save space; CheckList keeps all options visible for scanning and bulk toggling"}]},relatedComponents:[{name:"Input.Checkbox",note:"Row control when type=CHECKBOX",relationship:["child"]},{name:"Input.Switch",note:"Row control when type=SWITCH for on/off feature toggles",relationship:["child"]},{name:"Modal",note:"Common container for bulk-selection dialogs (recipients, plans, modules)",relationship:["complement"]},{name:"Form",note:"Used inside settings flows; wire checked state through onChange",relationship:["complement"]},{name:"Input.Checkbox.Group",note:"Use for a simple flat checkbox group without list chrome or nesting",relationship:["alternative"]},{name:"Input.SelectableGroup",note:"Use when each option needs rich card content instead of a plain label",relationship:["alternative"]},{name:"Input.Radio",note:"Use when only one option may be chosen",relationship:["alternative"]}]},Chip:{description:'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.',events:["dismiss","press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Visual style (NEUTRAL, NEGATIVE, ACTIVE). Default: NEUTRAL",enum:["NEUTRAL","NEGATIVE","ACTIVE"],type:"string"},"aria-describedby":{description:"ID of element that describes this chip",type:"string"},"aria-label":{description:"Accessibility label for the chip",type:"string"},"aria-labelledby":{description:"ID of element that labels this chip",type:"string"},avatar:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{image:{description:"Avatar image URL",type:"string"},imageProps:{additionalProperties:!1,properties:{alt:{description:"Alt text for avatar image",type:"string"}},type:"object"},title:{description:"Title for generating initials when no image",type:"string"}},type:"object"}],description:"Avatar to display at the beginning. Can be image URL string or object with image/title/imageProps"},icon:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{alignment:{description:"Icon position relative to text. Default: Left",enum:["Left","Right","None"],type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:'Icon type name (e.g., "CHECK", "USERS_OUTLINE")',type:"string"}},required:["type"],type:"object"}],description:"Icon to display. Can be string name or object with type/color/alignment"},isActive:{description:"If true, applies active/selected styling (used inside SelectableGroup)",type:"boolean"},isCloseable:{description:"Shows close button when true. Default: false",type:"boolean"},isDisabled:{description:"If true, the chip is visually and functionally disabled",type:"boolean"},isFluid:{description:"If true, the chip takes all available width. Default: false",type:"boolean"},maxWidth:{description:"Maximum width in pixels. Default: 400px",type:"number"},size:{description:"Size of the chip (SMALL, MEDIUM, LARGE, EXTRA_LARGE). Default: LARGE",enum:["SMALL","MEDIUM","LARGE","EXTRA_LARGE"],type:"string"},text:{description:"Text content to display in the chip",type:"string"},tip:{additionalProperties:!1,description:"Tooltip configuration. Chip has default overflow tooltip behavior",properties:{appearance:{description:"Tooltip appearance (LIGHT, DARK). Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Control tooltip visibility from parent",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max height (number in px or CSS string)"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max width (number in px or CSS string)"},placement:{description:"Tooltip placement relative to chip. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{description:"Open link in new tab",type:"boolean"},path:{description:"Navigation path or URL",type:"string"}},required:["path"],type:"object"}],description:"Navigation destination. Renders chip as anchor with router integration. Use for guaranteed navigation"}},type:"object"},acceptsChildren:!1,category:["atom"],keywords:["chip","tag","filter","filter tag","applied filters","pill","selected option","dismissible","removable","token","person","avatar chip","filter bar","multi select"],anatomy:{parts:[{name:"Container",required:!0,role:"Pill-shaped surface; appearance (NEUTRAL/ACTIVE/NEGATIVE) and size (S–XL)"},{name:"Start icon / avatar",required:!1,role:"Optional icon prop or avatar prop (e.g. person chip) before the label"},{name:"Label",required:!0,role:"Single short string naming the entity, filter, or option"},{name:"End icon",required:!1,role:"Optional trailing icon via icon alignment RIGHT"},{name:"Dismiss action",required:!1,role:"× button shown when isCloseable, wired through onClose"}],summary:"A pill-shaped container holding a short text label, with an optional start icon or avatar, an optional end icon, and an optional dismiss (×) action when isCloseable. Related chips are laid out together with Chip.Group; interactive chips respond to onClick/onClose."},guidance:{doNotUseWhen:["Static read-only metadata or semantic color highlights — use Label",'Workflow or process state like "In review" or "Failed" — use Status',"Numeric unread or pending counts — use Atoms.Badge","A call to action that opens a modal, navigates, or submits — use Button","A single chip row of toggles — use Input.SelectableGroup's chip renderer instead"],useWhen:["Showing user-selected filters or applied conditions above a list or grid (isCloseable to remove)","Selectable option groups in single or multi-select flows (via Input.SelectableGroup chip renderer)","Representing a person, place, policy rule, or other entity compactly","Compact attribute sets such as tags or conditions that may become interactive","Quick refine/remove actions on displayed criteria"]},antiPatterns:["Static read-only Chip used where Label is the correct component","Multiple related chips rendered without `Chip.Group`","Complex nested content inside Chip instead of a single string label","Semantic Chip appearances used to highlight static metadata or state","External `Tip` wrapper used instead of Chip's built-in `tip` prop","Manual click-toggle chip rows instead of `Input.SelectableGroup` chip renderer","Workflow or process state shown with Chip instead of Status","Fake interactivity — empty `onClick` handler on non-actionable chips"],selection:{confusedWith:[{component:"Atoms.Badge",distinguishBy:"Atoms.Badge is a numeric count overlaid on nav, tabs, or icons; Chip represents an entity, tag, or selected filter as standalone text with optional actions"},{component:"Label",distinguishBy:'Label is static text that highlights a property ("New", "Recommended") with semantic color; Chip represents a user-selected filter or entity and is often interactive or dismissible'},{component:"Status",distinguishBy:'Status communicates workflow or process state ("In review", "Failed"); Chip represents user-applied criteria, tags, or entities, not lifecycle state'},{component:"Button",distinguishBy:"Button is a call to action; Chip represents an entity — its actions are limited to investigating details or dismissing it"}]},relatedComponents:[{name:"Chip.Group",note:"Lays out multiple related chips with consistent spacing",relationship:["child"]},{name:"Input.SelectableGroup",note:"Use its chip renderer for single/multi-select chip rows instead of hand-rolled click-toggle chips",relationship:["complement"]},{name:"Tip",note:"Use Chip's built-in tip prop for hover context rather than wrapping in Tip",relationship:["complement"]},{name:"Icon",note:"Start/end glyphs via the icon prop",relationship:["complement"]},{name:"Avatar",note:"Person chips via the avatar prop (initials or image)",relationship:["complement"]},{name:"Atoms.Badge",note:"Unread/pending numeric counts on nav or icons",relationship:["alternative"]},{name:"Label",note:"Static metadata with semantic color, no interaction",relationship:["alternative"]},{name:"Status",note:"Workflow/process state display",relationship:["alternative"]}]},ChipGroup:{description:'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.',events:["overflowChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{batchSize:{description:"Number of elements rendered in each incremental step, optimizing performance for large datasets",type:"number"},gap:{description:"Spacing token for the flex gap between chip items. Default: theme default spacing",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},maxLinesToWrap:{description:'Maximum number of lines to display before showing overflow modal. When set, chips exceeding this limit are hidden with a "+N more" trigger that opens a modal',type:"number"},overflowModalIsOpen:{description:"Bindable state value written when the overflow modal opens or closes. True when open, false when closed",type:"boolean"},overflowModalTitle:{description:"Title text shown in the overflow modal header when maxLinesToWrap limit is exceeded",type:"string"}},type:"object"},acceptsChildren:!0},Circle:{description:"Circular graphic element for status or decoration",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{color:{description:"Foreground fill color token of the circle. Default: current theme colorInfo",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},isHollow:{description:"When true, renders a hollow (outlined) circle instead of a filled one. Default: false",type:"boolean"},size:{description:"Diameter of the circle in pixels. Default: 10",type:"number"}},type:"object"},acceptsChildren:!1,category:["atom"],keywords:["circle","dot","status dot","indicator","marker","legend","color swatch","online status","bullet","decoration"],anatomy:{parts:[{name:"Disc",required:!0,role:"The colored circle itself; solid by default, outlined with isHollow"}],summary:"A single colored disc sized by the size prop in px (typically 6–8px inline status dots, 10–12px list markers). isHollow renders an outline-only variant for de-emphasized states. Purely visual with no text or semantics; the color prop should use theme tokens so it adapts across light and dark themes."},guidance:{doNotUseWhen:["You need a recognizable glyph — use Icon","Representing a person — use Avatar","Showing counts or short text — use Atoms.Badge","Interactive controls — Circle has no button semantics","Conveying meaning by color alone — always pair with visible text or an aria-label"],useWhen:["Status dots (active/inactive/pending, online/offline) paired with a text label","Small color markers next to list items or categories","Color legend keys in charts or data visualizations","Light decorative accents where a full icon would be too heavy"]},antiPatterns:["Status communicated by color dot without consistent text pairing","Default Circle with no color prop — invisible or ambiguous in DM","Hardcoded hex colors instead of theme tokens","Circle used as interactive control without button semantics"],selection:{confusedWith:[{component:"Status",distinguishBy:"Status maps states to consistent indicator + text treatments; Circle is a bare colored dot you must label and color yourself"},{component:"Atoms.Badge",distinguishBy:"Atoms.Badge displays numeric counts or short text; Circle carries no text"},{component:"Avatar",distinguishBy:"Avatar represents a person with photo or initials and an accessible name; Circle is not a person representation"},{component:"Icon",distinguishBy:"Icon renders meaningful glyphs (checkmark, warning); Circle is an abstract marker with no inherent meaning"}]},relatedComponents:[{name:"Status",note:"Consistent status indicator with built-in appearance mapping",relationship:["alternative"]},{name:"Atoms.Badge",note:"Numeric counts or short text labels",relationship:["alternative"]},{name:"Avatar",note:"Person representation with photo or initials",relationship:["alternative"]},{name:"Icon",note:"Recognizable glyphs for meaningful states",relationship:["alternative"]},{name:"Layout.HStack",note:"Typical container for dot + text label rows",relationship:["complement"]},{name:"Text",note:"Text label that must accompany the dot to convey its meaning",relationship:["complement"]}]},ColorPicker:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},allowCustomColors:{description:"Allow users to input custom hex colors. Default: false",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},colorPerRow:{description:"Number of color swatches to display per row",type:"number"},colors:{description:"Array of hex color strings to show in the palette",items:{type:"string"},type:"array"},columnGap:{description:"Horizontal spacing between color columns as a spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},defaultValue:{description:"Default hex color value for reset functionality",type:"string"},isDisabled:{description:"Disables the color picker",type:"boolean"},isReadOnly:{description:"Makes the color picker read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},rowGap:{description:"Vertical spacing between color rows as a spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},showReset:{description:"Show reset link to restore default color. Default: true",type:"boolean"},title:{description:"Title displayed at the top of the color picker panel",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:'Selected hex color string, e.g. "#FF5733"',type:"string"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["color picker","colorpicker","color palette","brand color","theme color","accent color","hex input","swatch","text color","chart color","conditional formatting","color selection"],anatomy:{parts:[{name:"Trigger",required:!0,role:"Render-prop children; must spread all returned props for focus and ARIA correctness"},{name:"Palette panel",required:!0,role:"Popover grid of selectable swatches from colors or the default palette"},{name:"Custom hex input",required:!1,role:"Free-form hex entry when allowCustomColors is set"},{name:"Reset action",required:!1,role:"Restores defaultValue when showReset is set"}],summary:"A consumer-supplied trigger (render prop receives onClick, ref, and ARIA attributes — spread them all) opens a popover panel containing a grid of color swatches (colors, colorPerRow), an optional custom hex input, and an optional reset action. The trigger should show the current swatch and hex value."},guidance:{doNotUseWhen:["Binary color modes (dark mode on/off) — use Input.Switch","Read-only color display — render a plain swatch with the hex value, not a disabled Input.ColorPicker","Full HSL/RGB/alpha gradient control — Input.ColorPicker is palette-focused; use a dedicated color-wheel library","Dropping the render-prop props — always spread them onto the trigger for accessibility"],useWhen:["Brand, theme, or accent color selection in settings and customization flows","Text/background color choice in editors or report conditional formatting","Choosing from a curated palette — keep it focused, roughly 5–15 colors","Color-based tagging or categorization with live preview (controlled value + onChange)"]},antiPatterns:["Custom color picker instead of Pebble Input.ColorPicker","Legacy Popper grid retained beside Input.ColorPicker","Native HTML color input for form fields"],selection:{confusedWith:[{component:"Input.Select",distinguishBy:"Select lists textual options; Input.ColorPicker presents visual swatches with hex values and a custom-color hex input — use it whenever the choice itself is a color"},{component:"Input.Switch",distinguishBy:"Switch is for binary on/off (e.g. dark mode); Input.ColorPicker is for choosing one color from many"}]},relatedComponents:[{name:"Button",note:"Typical trigger rendered by the children render prop, showing the current swatch and hex value",relationship:["complement"]},{name:"Input.Select",note:"For non-color option lists",relationship:["alternative"]},{name:"Input.Switch",note:"For binary color-mode toggles like dark mode",relationship:["alternative"]}]},ContentLoader:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{animate:{description:"Enable animation. Default: true",type:"boolean"},backgroundColor:{description:"Background surface color token. Default: #f5f6f7",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},backgroundOpacity:{description:"Opacity of background color. Default: 1",type:"number"},foregroundColor:{description:"Foreground shimmer color token. Default: #eee",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},foregroundOpacity:{description:"Opacity of foreground shimmer. Default: 1",type:"number"},gradientRatio:{description:"Width of the animated gradient as a ratio. Default: 2",type:"number"},height:{description:"SVG height in px. Default: 130",type:"number"},rtl:{description:"Right-to-left animation direction. Default: false",type:"boolean"},speed:{description:"Animation speed in seconds. Default: 2",type:"number"},width:{description:"SVG width in px. Default: 400",type:"number"}},type:"object"},acceptsChildren:!1,category:["atom"],keywords:["content loader","contentloader","svg skeleton","shimmer","loading placeholder","skeleton screen","react-content-loader","card loading","table row placeholder","layout-matched loader"],anatomy:{parts:[{name:"SVG viewport",required:!0,role:"viewBox coordinate system sized to the real content's pixel dimensions"},{name:"shimmer gradient",role:"Animated sweep; cadence set by speed, disabled via animate={false}"},{name:"SVG children",role:"rect/circle shapes mirroring the final layout (avatar circle + text-line rects, table-row columns)"}],summary:"An SVG viewport with an animated gradient sweep. With no children it renders a generic 3-line preset; with children, caller-supplied rect and circle elements (positioned via x/y/width/height, rounded via rx/ry) reproduce the real content's layout inside a matching viewBox."},guidance:{doNotUseWhen:["Generic loading states — use Spinner","Pebble components with native skeleton support — use their Skeleton prop instead of wrapping in ContentLoader","Full-page loading gates — a centered Spinner is less disruptive than a viewport-spanning skeleton","Simple text/box/circle placeholders — Skeleton covers those without hand-written SVG"],useWhen:["Layout-matched placeholders — avatar + text lines, travel/product cards, table rows with known column widths","Deferred content in modals so the dialog does not appear empty or collapse","Custom shapes must mirror the final content exactly (viewBox + rect/circle) to avoid layout shift","Always pass a stable uniqueKey to avoid SVG gradient ID collisions during SSR hydration"]},antiPatterns:["Missing `uniqueKey` on Pebble ContentLoader instances","Loading region without `aria-busy` / accessible loading label","Third-party `react-content-loader` instead of Pebble component","Generic skeleton where Spinner or native Skeleton prop is appropriate"],selection:{confusedWith:[{component:"Skeleton",distinguishBy:"ContentLoader takes raw SVG children for pixel-exact shapes; Skeleton offers TEXT/BOX/CIRCLE variants with theme tokens plus provider mode wrapping real content"},{component:"Spinner",distinguishBy:"ContentLoader is a layout-aware placeholder for known content structure; Spinner is the generic busy indicator when layout is unknown or the wait is small"},{component:"Spinner.FieldLoader",distinguishBy:"Spinner.*Loader sub-loaders are ready-made skeleton presets for common layouts; ContentLoader is for bespoke shapes those presets do not cover"}]},relatedComponents:[{name:"Skeleton",note:"Simpler theme-token shapes and provider mode when pixel-exact matching is not needed",relationship:["alternative"]},{name:"Spinner",note:"Generic loading indicator or full-page gate",relationship:["alternative"]},{name:"Spinner.FieldLoader",note:"Preset skeleton layouts (fields, settings, charts, reports) — prefer over hand-drawn SVG when one fits",relationship:["alternative"]},{name:"Layout.Box",note:"Sized wrapper that carries aria-busy and the accessible loading label",relationship:["complement"]}]},CountDown:{description:"Countdown timer displaying time remaining until a target date",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{date:{description:'ISO 8601 date-time string representing the target future date (e.g. "2025-12-31T23:59:59Z"). The countdown counts down to this date.',type:"string"},isInline:{description:"When true, the countdown renders as an inline element. Default: false",type:"boolean"},shouldUseShortString:{description:"When true, uses abbreviated labels (d, h, m, s) instead of full words (days, hours, minutes, seconds). Default: false",type:"boolean"}},required:["date"],type:"object"},acceptsChildren:!1,category:["date"],keywords:["countdown","timer","deadline","time remaining","expires","payroll run","approve by","revert to draft","approval deadline","session expiry","urgency","count down"],anatomy:{parts:[{name:"duration segments",required:!0,role:"Days, hours, minutes, seconds values that tick on an adaptive interval"},{name:"segment labels",role:"Full words (days/hours) or abbreviations (d/h/m/s) with shouldUseShortString"}],summary:"A duration readout split into day/hour/minute/second segments with labels — full words by default or d/h/m/s abbreviations via shouldUseShortString. The isInline variant renders within a sentence. It has no container or label of its own; surrounding copy must explain what expires."},guidance:{doNotUseWhen:['Elapsed time ("3 hours ago") — use a formatted date string via Text',"Static durations that do not tick — use Text","Percentage or step completion — use ProgressBar or ProgressSteps","Past or unvalidated dates — it renders null; guard in the data layer"],useWhen:["Deadlines — enrollment, submission, or task cutoffs users must pace against","Payroll run deadlines — approve-by / revert-to-draft timers in run lists, overviews, and notices","Expiration notices — session tokens, offers, time-limited access (isInline in sentences)","Layout.Grid cells and compact layouts via shouldUseShortString abbreviated labels",'Wrapped in an aria-live="polite" region when the countdown is a primary user cue']},antiPatterns:["Primary deadline timer without `aria-live` region for screen readers",'Countdown embedded without visible "what expires" label nearby',"Past-date risk — countdown may silently render blank"],selection:{confusedWith:[{component:"ProgressBar",distinguishBy:"ProgressBar shows percentage-based completion; Atoms.CountDown communicates time remaining, not progress"},{component:"ProgressSteps",distinguishBy:"ProgressSteps shows step-based completion of a flow; Atoms.CountDown ticks toward a future date"},{component:"Text",distinguishBy:"Text renders a static formatted date or duration; Atoms.CountDown updates live toward a future date"}]},relatedComponents:[{name:"Label",note:"Adjacent visible label explaining what expires or starts",relationship:["complement"]},{name:"Notice",note:"Common container for expiry and deadline warnings embedding a Atoms.CountDown",relationship:["complement"]},{name:"ProgressBar",note:"Percentage-based completion",relationship:["alternative"]},{name:"ProgressSteps",note:"Step-based completion",relationship:["alternative"]},{name:"Text",note:"Static dates, durations, or elapsed time",relationship:["alternative"]}]},Country:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{countryCode:{description:'ISO country code (e.g. "US", "IN", "GB"). Used to display the country flag and name.',type:"string"},icon:{anyOf:[{description:'Icon type name as a string (e.g. "INFO_CIRCLE_OUTLINE")',type:"string"},{additionalProperties:!1,properties:{alignment:{description:'Alignment of the icon within the container. Use "RIGHT" to push icon to the right.',enum:["RIGHT"],type:"string"},"aria-describedby":{description:"ID of element that describes the icon",type:"string"},"aria-label":{description:"Accessible label for the icon",type:"string"},"aria-labelledby":{description:"ID of element that labels the icon",type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},isDisabled:{description:"Sets icon interactions as disabled",type:"boolean"},isFocused:{description:"Shows icon backdrop when focused",type:"boolean"},showCursor:{description:"Shows pointer cursor and hover background",type:"boolean"},size:{anyOf:[{type:"number"},{type:"string"}],description:"Icon size in pixels or CSS units"},tip:{description:"Tooltip content shown on icon hover",type:"string"},type:{description:'Icon type name (e.g. "INFO_CIRCLE_OUTLINE")',type:"string"}},required:["type"],type:"object"}],description:"Icon displayed alongside the country. Accepts a string icon name or an object with type, alignment, tip, color, size, state, and ARIA props."},onlyFlag:{description:"When true, shows only the flag without rendering the country name. Default: false",type:"boolean"},shouldShowFlag:{description:"When false, hides the country flag and shows only the country name. Default: true",type:"boolean"},shouldShowTipOnOverflow:{description:"When false, disables the tooltip that appears when the country name overflows. Default: true",type:"boolean"},size:{description:"Size of the country flag. SMALL, MEDIUM, or LARGE. Default: LARGE",enum:["SMALL","MEDIUM","LARGE"],type:"string"}},required:["countryCode"],type:"object"},acceptsChildren:!1,category:["atom"],keywords:["country","flag","country code","iso code","locale","region","international","entity country","address country","country name"],anatomy:{parts:[{name:"Flag",required:!0,role:"Country flag resolved from the ISO countryCode prop"},{name:"Country name",required:!1,role:"Localized country label; hidden when onlyFlag is set"},{name:"Icon",required:!1,role:"Optional trailing icon, often paired with a Tip for setup or info actions"}],summary:"A horizontal row: a flag glyph resolved from the ISO countryCode, the localized country name (omitted with onlyFlag), and an optional trailing icon (e.g. with a Tip) for contextual actions. Size controlled via Country.SIZES."},guidance:{doNotUseWhen:["Letting the user pick a country — use Input.Select with country options","Single-country applications where a plain text label suffices","Contexts where flags are culturally sensitive — use a neutral text presentation","Rendering a flag without the country meaning — use Image only for non-country assets"],useWhen:["Displaying a user's or entity's country in profiles, address books, and lists","Table rows or compact items needing quick visual country recognition (onlyFlag)","Surfacing regional context such as currency, language, or time zone","Bank account or entity filing lists keyed by countryCode"]},antiPatterns:["Text-only country name where Country atom would aid recognition","Country card lists without icon tip for setup actions","Flag + language locale mixed in same selector UI"],selection:{confusedWith:[{component:"Input.Select",distinguishBy:"Input.Select lets the user choose a country in a form; Country is read-only display of an already-known country code"},{component:"Atoms.Image",distinguishBy:"Hand-rolled flag <Image src={flagUrl}> duplicates what Country provides; Country resolves flag + localized name from the code alone"}]},relatedComponents:[{name:"Input.Select",note:"Picking a country in a form instead of displaying one",relationship:["alternative"]},{name:"Atoms.Image",note:"Raw flag asset rendering; prefer Country for flag + name",relationship:["alternative"]},{name:"Tip",note:"Tooltips on the optional trailing icon",relationship:["complement"]},{name:"Layout.Grid",note:"Common container; Country renders inside table cells and list rows",relationship:["complement"]}]},Currency:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},allowNegative:{description:"Whether negative values are allowed. Default: true",type:"boolean"},"aria-describedby":{description:"ID of element that provides additional description",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},autoComplete:{description:"HTML autocomplete attribute value for browser autofill",type:"string"},autoFocus:{description:"If true, input will be focused on mount",type:"boolean"},canSelectCurrencyType:{description:"If true, displays a dropdown to select currency type",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},currencyTypeProps:{additionalProperties:!1,description:"Nested Select props for the currency selector",properties:{name:{description:"Unique identifier for the currency selector",type:"string"},"aria-describedby":{description:"ID of element that describes the currency selector",type:"string"},"aria-label":{description:"Accessible label for the currency selector",type:"string"},"aria-labelledby":{description:"ID of element that labels the currency selector",type:"string"},canClear:{description:"Show clear button to deselect",type:"boolean"},defaultSearchQuery:{description:"Initial search input value",type:"string"},defaultValue:{description:"Initial selected currency code"},dropdownHeight:{description:"Dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query entered",type:"string"},onNoSearchResults:{description:"Placeholder when search returns no results",type:"string"}},type:"object"}],description:"Placeholder when dropdown list is empty"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options",propertyNames:{type:"string"},type:"object"},isDisabled:{description:"Disables the currency selector",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu opens by default",type:"boolean"},isPositionFixed:{description:"Position dropdown relative to viewport",type:"boolean"},isReadOnly:{description:"Makes the currency selector read-only",type:"boolean"},isRequired:{description:"Marks the currency selector as required",type:"boolean"},isSearchable:{description:"Enable type-to-search filtering",type:"boolean"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Dropdown max height"},placeholder:{description:"Placeholder text when empty",type:"string"},scrollThreshold:{description:"Extra virtual scroll render threshold",type:"number"},shouldFocusFirstElement:{description:"Auto-focus first menu item",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix",type:"boolean"},shouldUsePortal:{description:"Render dropdown in a React Portal",type:"boolean"},size:{description:"Select input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},value:{description:"Currently selected currency code"}},type:"object"},decimalPlaces:{description:"Number of decimal places allowed. Default: 2",type:"number"},defaultValue:{anyOf:[{type:"string"},{type:"number"},{additionalProperties:!1,properties:{type:{description:"Currency code paired with the amount, e.g. USD or EUR",type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Currency amount value"}},required:["value","type"],type:"object"}],description:"Initial value for uncontrolled component. Use { value, type } with shouldSendCurrencyType"},isDisabled:{description:"Disables the input",type:"boolean"},isIntegerOnly:{description:"If true, only integer values will be allowed. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for number formatting (e.g. en-US). Overrides shouldLocalize when set.",type:"string"},max:{description:"Maximum allowed value",type:"number"},maxLength:{description:"Maximum number of characters allowed",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},min:{description:"Minimum allowed value",type:"number"},minLength:{description:"Minimum number of characters required",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Currency symbol or code shown as prefix. Default: USD",type:"string"},shouldAllowCalculation:{description:"If true, input allows arithmetic operators and evaluates equation on blur",type:"boolean"},shouldDisableRedundantZeroFormatting:{description:"If false, redundant zeros are removed using parseFloat. If true (default), zeros are preserved. Default: true",type:"boolean"},shouldLocalize:{description:"If true, currency format is determined from user locale setting. Default: true",type:"boolean"},shouldSendCurrencyType:{description:"If true, onChange writes { value, type } using currencyTypeProps value/defaultValue",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},step:{description:"Value to add/subtract on pressing arrow up/down respectively. Default: 1",type:"number"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"},{additionalProperties:!1,properties:{type:{description:"Currency code paired with the amount, e.g. USD or EUR",type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Currency amount value"}},required:["value","type"],type:"object"}],description:"Current currency value bound to state. Use { value, type } with shouldSendCurrencyType"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["currency input","currencyinput","money","amount","price","salary","compensation","dollar","payment","benefits amount","claim amount","spend limit","budget","currency selector"],anatomy:{parts:[{name:"Label",required:!0,role:"Describes the field; shows required indicator when isRequired"},{name:"Prefix",required:!1,role:"Currency symbol derived from the selected currency type"},{name:"Currency type selector",required:!1,role:"Dropdown to pick the currency (canSelectCurrencyType); disabled or hidden for fixed-currency fields"},{name:"Input field",required:!0,role:"Locale-formatted monetary value entry"},{name:"Helper/Error text",required:!1,role:"Guidance below the field; error message replaces it when invalid"}],summary:"A label (with optional required indicator and tooltip) above a text field that shows a currency symbol prefix and formats the value per locale; an optional currency-type dropdown on the left lets users switch currencies, and an optional suffix can follow the value. Helper text below is replaced by error text on validation failure."},guidance:{doNotUseWhen:["Purely numeric, non-monetary values (quantities, percentages, measurements) — use Input.Number or Input.Percentage","Non-numeric input — use Input.Text or another variant","Read-only display of an amount — prefer isReadOnly over isDisabled, or plain text if never edited"],useWhen:["Entering monetary values — salaries, claim amounts, coverage amounts, spend limits, policy triggers","Standardized, locale-aware money formatting is required","Users should pick the currency — enable canSelectCurrencyType for global/multi-currency experiences","Displaying an editable amount alongside a fixed company currency (currencyTypeProps with selection off)"]},antiPatterns:["`currencyTypeProps` omitted — currency type not shown","Currency fields missing label or title","Currency selector enabled without default currency code","Text input with dollar prefix used for money","Error styling without inline amount error message","Disabled instead of read-only for display amounts"],selection:{confusedWith:[{component:"Input.Number",distinguishBy:"Number is for unitless quantities and counts; Currency is specifically for monetary amounts and shows a currency symbol prefix with optional currency-type selection"},{component:"Input.Percentage",distinguishBy:"Percentage is for rate/ratio values with an automatic % suffix; Currency always represents money"},{component:"Input.Text",distinguishBy:"A text input with a hand-added '$' prefix loses locale formatting and currency-type handling; Currency provides both"}]},relatedComponents:[{name:"Form",note:"Data-entry flows use Form.Input.Currency inside a Form for validation and submission",relationship:["complement"]},{name:"Input.Number",note:"Unitless numeric values that are not money",relationship:["alternative"]},{name:"Input.Percentage",note:"Percentage rates instead of absolute amounts",relationship:["alternative"]},{name:"Input.Text",note:"Non-monetary free-form values; do not fake currency with a text prefix",relationship:["alternative"]}]},Dashboard:{description:"Embeds a saved Rippling Analytics dashboard by id. Loading, permissions, missing-dashboard, and widget behavior are handled by the dashboard viewer.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{dashboardId:{description:"Id of a saved Rippling Analytics dashboard. The dashboard loads its own data and handles loading, access, missing, and widget behavior.",type:"string"}},required:["dashboardId"],type:"object"},acceptsChildren:!1},Date:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},alwaysShowTimezone:{description:"If true, timezone abbreviation will always be shown when shouldShowTime is true. Default: false",type:"boolean"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},canClear:{description:"Show clear button",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{type:"string"},{type:"null"}],description:"Initial ISO date string or null for uncontrolled usage"},divider:{description:'Separator between date units (e.g. "/" or "-")',type:"string"},format:{description:"Date display format. Default: MM/dd/yyyy",enum:["yyyy/MM/dd","yyyy-MM-dd","MM/dd/yyyy","dd/MM/yyyy","yyyy/MM/dd hh:mm a","yyyy-MM-dd hh:mm a","MM/dd/yyyy hh:mm a","dd/MM/yyyy hh:mm a","yyyy/MM/dd hh:mm:ss a","yyyy-MM-dd hh:mm:ss a","MM/dd/yyyy hh:mm:ss a","dd/MM/yyyy hh:mm:ss a","ISO_STRING"],type:"string"},hideStepper:{description:"If true, arrow navigation key to increment/decrement date will be hidden. Default: false",type:"boolean"},id:{description:"HTML id attribute for the input",type:"string"},isCalendarDefaultOpen:{description:"If true, calendar will be open by default on mount",type:"boolean"},isDisabled:{description:"Disables the date picker",type:"boolean"},isLarge:{description:"Renders large calendar when true. Default: false",type:"boolean"},isPickerVisible:{description:"If false, hides the calendar picker. Default: true",type:"boolean"},isReadOnly:{description:"Makes the date picker read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the date picker",type:"string"},locale:{description:"Locale for date formatting. Default: en-US",type:"string"},maxDate:{description:"Latest selectable date as ISO string",type:"string"},minDate:{description:"Earliest selectable date as ISO string",type:"string"},shouldDisplaySeconds:{description:"Display seconds in the time input when shouldShowTime is true",type:"boolean"},shouldFormatInTimezone:{description:"If true, values will transform according to global timezone. Defaults to true when shouldShowTime is true",type:"boolean"},shouldLocalize:{description:"If true, display format will be determined from user locale setting. Default: false for explicit format control",type:"boolean"},shouldShowTime:{description:"Include time selection",type:"boolean"},shouldShowTimezoneLabel:{description:"If false, timezone label will not be shown. Default: true",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Visual theme variant. NO_BOX removes input box styling",enum:["NO_BOX"],type:"string"},timeProps:{additionalProperties:!1,description:"Configuration for time picker. Sets initial time value independently of date input",properties:{defaultValue:{description:"Default time as ISO string when no date is selected",type:"string"}},required:["defaultValue"],type:"object"},timezone:{description:'Timezone name (e.g. "America/New_York"). Used with shouldShowTime',type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"null"}],description:"ISO date string or null bound to state"}},type:"object"},acceptsChildren:!1,category:["date"],keywords:["date input","date picker","calendar picker","dob","birthdate","start date","effective date","check date","go live date","scheduling","deadline","date filter","calendar header","datetime","dateinput"],anatomy:{parts:[{name:"label",required:!0,role:"Field label (title in forms) announcing what date is required"},{name:"date field",required:!0,role:"Text entry with calendar icon trigger; parses typed dates against format"},{name:"calendar popover",role:"Month grid for picking the date; honors minDate/maxDate and filterDate"},{name:"time section",role:"Optional time-of-day entry when shouldShowTime is set"},{name:"timezone label/select",role:"Optional timezone display or selector alongside time"},{name:"helper/error text",role:"Supportive text below the field; replaced by inline error or warning text"}],summary:"A labeled text field with a calendar icon that opens a calendar popover for picking one date; typed entry is parsed and validated against the format. With shouldShowTime the popover gains a time section and optional timezone label or selector. Helper, error, or warning text sits below the field."},guidance:{doNotUseWhen:["Start/end pair or from/to date filter — use Input.Date.Range, not two side-by-side Input.Date fields","Multiple non-contiguous dates — use Input.Date.InlineMulti","Days of the week for recurring schedules — use Input.DaySelector","Time of day only — use Input.Time","Always-visible calendar without a text field — use Input.Date.Calendar"],useWhen:["Asking for an exact, approximate, or memorable date — DOB, hire date, check date, effective date","Compact date navigation in calendar headers and scheduling toolbars (hideStepper, NO_BOX theme, small sizes)","Single-date filter controls on dashboards and grids","Date + time capture with timezone via shouldShowTime and timezone props","Constraining selectable dates via minDate/maxDate or filterDate (e.g. valid pay dates)","In data-entry flows use the form-aware Form.Input.Date inside a Form"]},antiPatterns:["Date fields in data-submit flows built outside Form","Standalone date fields missing an accessible name","Error styling on date fields without inline error message","`new Date()` used as default value (timezone drift)","Dual Form date field plus external state bypassing Form validation","Native HTML date input instead of DateInput"],selection:{confusedWith:[{component:"Input.Date.Range",distinguishBy:"Input.Date picks one date; Input.Date.Range picks a start/end pair — two side-by-side Input.Date fields for from/to filters are a common hand-assembled substitute"},{component:"Input.Date.InlineMulti",distinguishBy:"Input.Date.InlineMulti is an always-visible calendar for multiple non-contiguous dates; Input.Date is a text field with popover for one date"},{component:"Input.Date.Calendar",distinguishBy:"Input.Date.Calendar is the bare always-visible month grid; Input.Date wraps it in a labeled text field with popover for standard form use"},{component:"Input.Time",distinguishBy:"Input.Time captures a time of day only; Input.Date captures a calendar date (add shouldShowTime for date+time)"},{component:"Input.DaySelector",distinguishBy:"Input.DaySelector picks days of the week for recurring schedules, not a specific calendar date"}]},relatedComponents:[{name:"Form",note:"In data-entry flows use the form-aware Form.Input.Date inside Form, not standalone Input.Date",relationship:["complement"]},{name:"Input.Timezone",note:"Standalone timezone picker when the zone itself is user-editable; otherwise use the timezone prop",relationship:["complement"]},{name:"Input.Date.Range",note:"Start/end date pair",relationship:["alternative"]},{name:"Input.Date.InlineMulti",note:"Multiple non-contiguous dates on an inline calendar",relationship:["alternative"]},{name:"Input.Date.Calendar",note:"Bare always-visible month grid (Input.Date renders it inside its popover)",relationship:["alternative"]},{name:"Input.Time",note:"Time of day without a date",relationship:["alternative"]},{name:"Input.DaySelector",note:"Recurring day-of-week selection",relationship:["alternative"]}]},DateInlineMulti:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial array of selected ISO 8601 date strings",items:{type:"string"},type:"array"},format:{description:"Date display format. Default: yyyy-MM-dd",enum:["yyyy/MM/dd","yyyy-MM-dd","MM/dd/yyyy","dd/MM/yyyy","yyyy/MM/dd hh:mm a","yyyy-MM-dd hh:mm a","MM/dd/yyyy hh:mm a","dd/MM/yyyy hh:mm a","yyyy/MM/dd hh:mm:ss a","yyyy-MM-dd hh:mm:ss a","MM/dd/yyyy hh:mm:ss a","dd/MM/yyyy hh:mm:ss a","ISO_STRING"],type:"string"},isDisabled:{description:"Disables the calendar",type:"boolean"},isReadOnly:{description:"Makes the calendar read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the calendar",type:"string"},locale:{description:"Locale for date formatting",type:"string"},maxDate:{description:"Latest selectable date as ISO string",type:"string"},minDate:{description:"Earliest selectable date as ISO string",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{items:{type:"string"},type:"array"},{type:"null"}],description:"Array of selected ISO 8601 date strings or null bound to state"}},type:"object"},acceptsChildren:!1,category:["date"],keywords:["multi date picker","inline calendar","multiple dates","non-contiguous dates","interview scheduling","candidate availability","custom dates","time off","date chips","dateinlinemulti"],anatomy:{parts:[{name:"calendar",required:!0,role:"Always-visible month grid; day cells toggle selection on click"},{name:"navigation",role:"Prev/next month controls; view initializes to the earliest selected date"},{name:"selected date chips",role:"Removable chips below the calendar listing chosen dates"}],summary:"An always-visible month calendar with prev/next navigation; clicking day cells toggles them selected. Chosen dates render as removable chips below the calendar. There is no text field trigger — the calendar itself is the input."},guidance:{doNotUseWhen:["A single date — use Input.Date","A contiguous start/end period — use Input.Date.Range (Input.Date.Range)","Days of the week rather than specific dates — use Input.DaySelector","Compact layouts where an always-visible calendar is too large — use Input.Date"],useWhen:["Selecting several non-contiguous dates — interview availability offers, time-off days, event dates","Date selection is the page's primary task, so the calendar stays visible","Bounding the window with minDate/maxDate and filterDate (e.g. tomorrow through three weeks out)","In data-entry flows use the form-aware Form.Input.Date.InlineMulti inside a Form"]},antiPatterns:["Multi-date field missing an accessible name","Date-count validation shown away from the calendar field","Shared form fields use manual onChange instead of Form registration"],selection:{confusedWith:[{component:"Input.Date.Range",distinguishBy:"Input.Date.Range (Input.Date.Range) selects one contiguous start/end period; Input.Date.InlineMulti selects many individual non-contiguous dates"},{component:"Input.Date",distinguishBy:"Input.Date is a text field with popover for a single date; Input.Date.InlineMulti is an always-visible calendar for many dates"},{component:"Input.Date.Calendar",distinguishBy:"Input.Date.Calendar is the low-level standalone month grid; Input.Date.InlineMulti adds form-ready multi-select state and selected-date chips"},{component:"Input.DaySelector",distinguishBy:"Input.DaySelector picks recurring days of the week; Input.Date.InlineMulti picks specific calendar dates"}]},relatedComponents:[{name:"Form",note:"In data-entry flows use the form-aware Form.Input.Date.InlineMulti inside Form",relationship:["complement"]},{name:"Input.Date.Range",note:"Contiguous start/end period",relationship:["alternative"]},{name:"Input.Date",note:"Single date in a compact field",relationship:["alternative"]},{name:"Input.Date.Calendar",note:"Low-level month grid without multi-select state or chips",relationship:["alternative"]},{name:"Input.DaySelector",note:"Recurring days of the week rather than specific dates",relationship:["alternative"]}]},DateRange:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},alwaysShowTimezone:{description:"If true, timezone abbreviation will always be shown when shouldShowTime is true. Default: false",type:"boolean"},"aria-describedby":{description:"ID of element that describes the date range picker",type:"string"},"aria-label":{description:"Accessibility label for the date range picker",type:"string"},"aria-labelledby":{description:"ID of element that labels the date range picker",type:"string"},canClear:{description:"Show clear button",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{items:{anyOf:[{type:"string"},{type:"null"}]},type:"array"},{type:"null"}],description:"Initial null or array of ISO date strings/null entries [start, end]"},divider:{description:'Separator between date units (e.g. "/" or "-")',type:"string"},endDateLabel:{description:"Label for the end date field",type:"string"},format:{description:"Date display format. Default: MM/dd/yyyy",enum:["yyyy/MM/dd","yyyy-MM-dd","MM/dd/yyyy","dd/MM/yyyy","yyyy/MM/dd hh:mm a","yyyy-MM-dd hh:mm a","MM/dd/yyyy hh:mm a","dd/MM/yyyy hh:mm a","yyyy/MM/dd hh:mm:ss a","yyyy-MM-dd hh:mm:ss a","MM/dd/yyyy hh:mm:ss a","dd/MM/yyyy hh:mm:ss a","ISO_STRING"],type:"string"},hideStepper:{description:"If true, arrow navigation key to increment/decrement date will be hidden. Default: false",type:"boolean"},id:{description:"HTML id attribute for the date range input",type:"string"},isCalendarDefaultOpen:{description:"If true, calendar will be open by default on mount",type:"boolean"},isDisabled:{description:"Disables the date range picker",type:"boolean"},isLarge:{description:"Renders large calendar when true. Default: false",type:"boolean"},isReadOnly:{description:"Makes the date range picker read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the date range picker",type:"string"},locale:{description:"Locale for date formatting",type:"string"},maxDate:{description:"Latest selectable date as ISO string",type:"string"},minDate:{description:"Earliest selectable date as ISO string",type:"string"},shouldDisplaySeconds:{description:"Display seconds in the time input when shouldShowTime is true",type:"boolean"},shouldFormatInTimezone:{description:"If true, values will transform according to global timezone. Defaults to true when shouldShowTime is true",type:"boolean"},shouldLocalize:{description:"If true, display format is determined from user locale. Default: true",type:"boolean"},shouldShowTime:{description:"Include time selection",type:"boolean"},shouldShowTimezoneLabel:{description:"If false, timezone label will not be shown. Default: true",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},startDateLabel:{description:"Label for the start date field",type:"string"},theme:{description:"Visual theme variant. NO_BOX removes input box styling",enum:["NO_BOX"],type:"string"},timezone:{description:"Timezone for date/time display and storage. Used with shouldShowTime",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{items:{anyOf:[{type:"string"},{type:"null"}]},type:"array"},{type:"null"}],description:"Null or array of ISO date strings/null entries [start, end] bound to state"}},type:"object"},acceptsChildren:!1,category:["date"],keywords:["date range","start end date","from to","report period","date filter","activity log","analytics","enrollment window","pay period","effective period","daterange"],anatomy:{parts:[{name:"start date field",required:!0,role:"Text entry with calendar popover for the range start (startDateLabel)"},{name:"end date field",required:!0,role:"Text entry with calendar popover for the range end (endDateLabel)"},{name:"dual calendars",role:"Side-by-side month grids honoring minDate/maxDate and per-side filterDate"},{name:"time section",role:"Optional start/end times when shouldShowTime is set"},{name:"timezone label/select",role:"Optional timezone display or selector alongside time"},{name:"helper/error text",role:"Supportive text below the fields; replaced by inline error text"}],summary:"Two labeled text fields (start and end) joined by a separator icon, each opening a calendar popover; on wide screens the dual calendars sit side by side, on narrow screens they stack. Optional time and timezone sections appear with shouldShowTime, and helper or error text sits below the fields."},guidance:{doNotUseWhen:["A single date — use Input.Date","Multiple non-contiguous dates — use Input.Date.InlineMulti","Start/end times within one day — use Input.Time.Range (Input.Time.Range)","Always-visible calendar without text fields — use Input.Date.Calendar"],useWhen:["Dashboard, report, and log filters — activity logs, audit grids, analytics (compact sizes, canClear)","Effective periods, enrollment windows, and pay periods in forms","Ranges that also need time of day or timezone via shouldShowTime and timezone","Different constraints per side via filterDate { start, end } or minDate/maxDate","In data-entry flows use the form-aware Form.Input.Date.Range inside a Form"]},antiPatterns:["Date range filters built standalone outside Form","Date range missing an accessible name","Controlled range value without explicit format or localization","Form date range rendered without title or bound labels","Min/max bounds passed as raw Date objects inconsistent with format"],selection:{confusedWith:[{component:"Input.Date",distinguishBy:"Input.Date picks one date; Input.Date.Range picks a start/end pair with dual calendars"},{component:"Input.Date.InlineMulti",distinguishBy:"Input.Date.InlineMulti selects multiple non-contiguous dates on an always-visible calendar; Input.Date.Range selects one contiguous start/end period in a field"},{component:"Input.Time.Range",distinguishBy:"Input.Time.Range (Input.Time.Range) selects start/end times within a day; Input.Date.Range selects start/end dates"},{component:"Input.Date.Calendar",distinguishBy:"Input.Date.Calendar is the bare always-visible month grid; Input.Date.Range is a labeled field pair with calendar popovers for form use"}]},relatedComponents:[{name:"Form",note:"In data-entry flows use the form-aware Form.Input.Date.Range inside Form",relationship:["complement"]},{name:"Input.Date",note:"Single date",relationship:["alternative"]},{name:"Input.Date.InlineMulti",note:"Multiple non-contiguous dates",relationship:["alternative"]},{name:"Input.Time.Range",note:"Start/end times within a day",relationship:["alternative"]},{name:"Input.Date.Calendar",note:"Bare always-visible month grid (Input.Date.Range renders dual Calendars in its popovers)",relationship:["alternative"]}]},DaySelector:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{enum:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],type:"string"},{items:{enum:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],type:"string"},type:"array"}],description:"Initial day(s) when uncontrolled"},isMulti:{description:"Allow multiple day selection. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},renderProps:{additionalProperties:{additionalProperties:!1,properties:{isDisabled:{type:"boolean"},tip:{additionalProperties:!1,properties:{content:{type:"string"}},required:["content"],type:"object"}},type:"object"},description:"Per-day configuration. Keys are day names (Sunday, Monday, etc.). Each can have isDisabled (boolean) and tip (object with content string)",propertyNames:{type:"string"},type:"object"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{enum:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],type:"string"},{items:{enum:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],type:"string"},type:"array"}],description:"Selected day(s). Single string when isMulti is false, array when true"}},type:"object"},acceptsChildren:!1,category:["date"],keywords:["day of week","weekday picker","recurring schedule","availability","weekly repeat","work days","workweek start","weekly trigger","working hours","dayselector"],anatomy:{parts:[{name:"container",required:!0,role:"Row grouping the seven day buttons with radio or checkbox semantics"},{name:"day button",required:!0,role:"One toggle per weekday; supports disabled state and per-day tip via renderProps"}],summary:"A container holding seven day buttons (S M T W T F S) in a horizontal row. Single-select behaves as a Radio input; the Multi variant behaves as a Input.Checkbox group. Individual days can be disabled and given tooltips via renderProps."},guidance:{doNotUseWhen:["A specific calendar date — use Input.Date","Multiple specific dates — use Input.Date.InlineMulti","Generic non-day choice lists — use Radio, Input.Checkbox.Group, or Input.Select"],useWhen:["Recurring weekly schedules — work days, availability, repeat-on settings","Workweek start day and work days in time and attendance policies","Weekly recurring triggers — scheduled workflows and data refresh pipelines","One day via Input.DaySelector or several via the Multi variant (isMulti)","Disabling non-viable days (e.g. weekends) with explanatory tips via renderProps","In data-entry flows use the form-aware Form.Input.DaySelector inside a Form"]},antiPatterns:["Day-of-week control missing an accessible name","Standalone Input.DaySelector outside Form submit validation","Group header used as visual-only label without field title"],selection:{confusedWith:[{component:"Input.Date",distinguishBy:"Input.Date picks a specific calendar date; Input.DaySelector picks days of the week for recurring rules"},{component:"Input.Date.InlineMulti",distinguishBy:"Input.Date.InlineMulti picks specific dates on a calendar; Input.DaySelector picks recurring weekdays independent of any date"},{component:"Input.Checkbox",distinguishBy:"Input.Checkbox.Group is a generic on/off choice list; Input.DaySelector is purpose-built for the seven weekdays with radio/checkbox roles and keyboard behavior built in"},{component:"Radio",distinguishBy:"Radio is a generic single choice; single-select Input.DaySelector already behaves as a radio group over the weekdays"}]},relatedComponents:[{name:"Input.DaySelector.Multi",note:"Multi variant for selecting several days; behaves as a Input.Checkbox group",relationship:["child"]},{name:"Form",note:"In data-entry flows use the form-aware Form.Input.DaySelector inside Form",relationship:["complement"]},{name:"Tip",note:"Per-day tooltips via renderProps, e.g. explaining disabled weekend days",relationship:["complement"]},{name:"Input.Time.Range",note:"Working-hours forms pair day-of-week selection with per-day start/end time ranges",relationship:["complement"]},{name:"Input.Date",note:"Specific calendar date",relationship:["alternative"]},{name:"Input.Date.InlineMulti",note:"Multiple specific dates",relationship:["alternative"]},{name:"Input.Checkbox",note:"Generic non-day choice lists",relationship:["alternative"]},{name:"Radio",note:"Generic single-choice lists",relationship:["alternative"]}]},DistributionBar:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{segments:{description:"Array of segments with value and color",items:{additionalProperties:!1,properties:{segmentColor:{anyOf:[{enum:["chartColorSeries1Chart1","chartColorSeries1Chart2","chartColorSeries1Chart3","chartColorSeries1Chart4","chartColorSeries1Chart5","chartColorSeries2Chart1","chartColorSeries2Chart2","chartColorSeries2Chart3","chartColorSeries2Chart4","chartColorSeries2Chart5","chartColorSeries3Chart1","chartColorSeries3Chart2","chartColorSeries3Chart3","chartColorSeries3Chart4","chartColorSeries3Chart5","chartColorSeries4Chart1","chartColorSeries4Chart2","chartColorSeries4Chart3","chartColorSeries4Chart4","chartColorSeries4Chart5","chartColorSeries5Chart1","chartColorSeries5Chart2","chartColorSeries5Chart3","chartColorSeries5Chart4","chartColorSeries5Chart5","chartColorSeries6Chart1","chartColorSeries6Chart2","chartColorSeries6Chart3","chartColorSeries6Chart4","chartColorSeries6Chart5"],type:"string"},{enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh","colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorOnSuccess","colorOnSuccessContainer","colorOnInfo","colorOnInfoContainer","colorOnWarning","colorOnWarningContainer","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorOutline","colorOutlineVariant","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse"],type:"string"}],description:"Pebble chart color token, or semantic color token for status-related visualizations."},value:{description:"Numeric value of this segment",type:"number"}},required:["value","segmentColor"],type:"object"},type:"array"},size:{description:"Bar thickness variant. Default: standard",enum:["standard","compact"],type:"string"},totalValue:{description:"Total value the bar represents. If omitted, computed as sum of segment values. Segments exceeding totalValue trigger an error.",type:"number"}},required:["segments"],type:"object"},acceptsChildren:!1,category:["atom"],keywords:["distribution bar","distributionbar","stacked bar","composition","breakdown","proportion","percentage split","budget utilization","headcount distribution","status mix","segment bar"],anatomy:{parts:[{name:"Track",required:!0,role:"Full-width bar representing totalValue, including any empty remainder"},{name:"Segments",required:!0,role:"Colored portions, one per { value, segmentColor } entry, in array order"},{name:"Legend",required:!1,role:"External labels or tooltips identifying each segment; order must match the bar"}],summary:"A single horizontal track divided into colored segments sized proportionally to their value relative to totalValue (pass totalValue explicitly when segments do not sum to the full scale, so the empty remainder shows). SIZES.COMPACT suits in-row analytics. Pair with a legend or labels in matching order."},guidance:{doNotUseWhen:["A single value progressing toward 100% — use ProgressBar","Time-series or trended data needing axes — use a chart library","Side-by-side comparison across multiple groups — use a grouped bar chart","Segments without labels or tooltips — color alone is not accessible"],useWhen:["Visualising how a total breaks down across categories (budget by cost center, headcount by department)","Compact in-row analytics inside cards or table cells where a full chart is too heavy","Status mix in pipelines — open/in-progress/completed ratios at a glance","Showing partial utilization with an explicit totalValue so the empty portion renders"]},antiPatterns:["Distribution bar used for single-value progress instead of composition","Bar rendered without a visible legend or segment labels","Legend order does not match bar segment order","Category shown in legend but omitted from the bar (remainder pattern)"],selection:{confusedWith:[{component:"ProgressBar",distinguishBy:"ProgressBar tracks a single value toward completion; DistributionBar shows how a whole splits across multiple categories"}]},relatedComponents:[{name:"ProgressBar",note:"Single-value determinate progress toward 100%",relationship:["alternative"]},{name:"Card",note:"Common container for compact distribution summaries",relationship:["complement"]},{name:"Layout.Grid",note:"Embedded in table cells for in-row proportional context",relationship:["complement"]},{name:"Tip",note:"Segment tooltips when a visible legend is not present",relationship:["complement"]}]},Divider:{description:"Horizontal line to visually separate content sections",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{spacing:{description:"Vertical margin spacing token above and below the divider",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},text:{description:"Optional text displayed in the center of the divider line",type:"string"},theme:{description:"Line styles",enum:["SOLID","DASHED"],type:"string"}},type:"object"},acceptsChildren:!1,category:["layout"],keywords:["separator","divider","hr","horizontal rule","line","or divider","section break","dashed line","form sections","menu divider"],anatomy:{parts:[{name:"Line",required:!0,role:"The horizontal rule itself; solid by default, dashed via theme"},{name:"Text",required:!1,role:"Optional centered relationship label (OR, AND); keep to 1–3 words"}],summary:"A full-width horizontal line rendered as an hr. When children are provided, a short label (1–3 words like OR) sits centered in a gap in the line. Atoms.Separator.THEMES.DASHED renders a lighter dashed variant. No sub-components."},guidance:{doNotUseWhen:["You need space without a visible line — use layout gap/padding instead","Dividing a layout into resizable sections — use Layout.SplitPane","Between list items — rely on the list component's built-in dividers","Long phrases as separator text — use a heading or label instead"],useWhen:["Visually dividing groups of related content within a page or card","Inline text divider (OR, AND) between alternative options or actions","Clear visual breaks between distinct sections of a long form","Grouping items in a dropdown or menu that lacks built-in dividers"]},antiPatterns:["Layout.Box 1px divider instead of Atoms.Separator","Spacer boxes flanking Atoms.Separator","Long phrase as separator text","Custom hr/div dividers without Atoms.Separator","Atoms.Separator used where gap-only spacing suffices"],selection:{confusedWith:[{component:"Layout.Box",distinguishBy:"A 1px Layout.Box used as a divider is an anti-pattern; Atoms.Separator is the semantic hr with theme variants and optional text"},{component:"SplitPane",distinguishBy:"Layout.SplitPane divides a layout into resizable panes; Atoms.Separator is a static visual divider between content sections"},{component:"Layout.VStack",distinguishBy:"Layout.VStack gap spaces children without a visible line; add Atoms.Separator only when the visual boundary reinforces conceptual grouping"},{component:"MenuList",distinguishBy:"MenuList and menus provide their own section grouping; insert Atoms.Separator only when the container lacks built-in dividers"}]},relatedComponents:[{name:"Layout.Box",note:"Hand-rolled 1px Layout.Box dividers are an anti-pattern — use Atoms.Separator",relationship:["alternative"]},{name:"SplitPane",note:"Resizable layout sections instead of a static divider",relationship:["alternative"]},{name:"Layout.VStack",note:"Gap-only spacing when no visible line is needed",relationship:["alternative"]},{name:"MenuList",note:"Menus with built-in item grouping",relationship:["alternative"]},{name:"Card",note:"Divides content sections within cards",relationship:["complement"]},{name:"Form",note:"Visual breaks between sections of a long form",relationship:["complement"]},{name:"Button",note:"OR divider between alternative actions (e.g. sign-in options)",relationship:["complement"]}]},DraggableList:{description:"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.",events:["update","remove","dragStart","dragEnd"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{dragContainerMinHeight:{description:"Minimum height of drag container in pixels. Default: 0",type:"number"},groupName:{description:'List group identifier for dragging among multiple lists. Default: "group"',type:"string"},isDragDisabled:{description:"Disable drag functionality. Default: false",type:"boolean"},isHorizontal:{description:"Display the list horizontally. Default: false",type:"boolean"},isRemovable:{description:"Allow elements of the list to be removed. Default: false",type:"boolean"},labelKey:{description:"Key name in each item used to generate chip label",type:"string"},limitDragToDragIcon:{description:"Restrict dragging to only the drag icon. Only works when showDragIcon is true. Default: false",type:"boolean"},list:{description:"Array of draggable items. Each item must have an id (string or number). Additional keys are allowed.",items:{additionalProperties:{},properties:{id:{anyOf:[{type:"string"},{type:"number"}],description:"Unique identifier for the item"},label:{description:"Display label for the item",type:"string"}},required:["id"],type:"object"},type:"array"},showDragIcon:{description:"Show drag icon for each item. Default: false",type:"boolean"},tip:{additionalProperties:!1,description:"Tooltip configuration for the default chip renderer",properties:{appearance:{description:"Tooltip appearance. Default: DARK",enum:["LIGHT","DARK"],type:"string"},contentKey:{description:"List item key used as tooltip content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when document scrolls",type:"boolean"},isDelayed:{description:"Add delay before showing tooltip",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices",type:"boolean"},isPositionFixed:{description:"Use fixed positioning relative to viewport",type:"boolean"},isVisible:{description:"Control tooltip visibility",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum tooltip height"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum tooltip width"},onlyIfChildOverflow:{description:"Only show tooltip if any child content overflows",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if content overflows",type:"boolean"},overwriteMiddleware:{description:"Overwrite default floating-UI middleware",type:"boolean"},padding:{description:"CSS padding value for tooltip content",type:"string"},placement:{description:"Tooltip placement",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"},shallSkipOverflowY:{description:"Skip overflow check on Y axis",type:"boolean"},tipHideDelay:{description:"Milliseconds to wait before hiding delayed tooltip",type:"number"},tipShowDelay:{description:"Milliseconds to wait before showing delayed tooltip",type:"number"},title:{description:"Static tooltip title",type:"string"},titleKey:{description:"List item key used as tooltip title",type:"string"},truncateClassName:{description:"CSS class when overflow-only tooltip is enabled",type:"string"}},type:"object"},width:{description:"Width of the list. Default: 100%",type:"string"}},required:["list","labelKey"],type:"object"},acceptsChildren:!1,category:["complex"],keywords:["draggable list","draggablelist","drag and drop","reorder","sortable","rearrange","ranking","priority order","chips","column order","sequence"],anatomy:{parts:[{name:"chip container",required:!0,role:"Default item shell; replaced wholesale when a custom renderer is supplied"},{name:"drag handle",required:!0,role:"Grip affordance indicating the item can be reordered; must stay visible in custom renderers"},{name:"label",required:!1,role:"Item text resolved via labelKey; only meaningful with the default chip renderer"},{name:"remove button",required:!1,role:"Optional per-item removal enabled by isRemovable with onRemove"}],summary:"A vertical (default) or horizontal stack of items, each rendered as a chip containing a drag handle, the item label (or custom renderer content), and an optional remove button. Items can be pinned in place (fixed state), and lists sharing a groupName allow dragging items between them."},guidance:{doNotUseWhen:["List order is fixed — use ListItem with ListItem.Layout","The goal is selecting items, not ordering them — use CheckList or Input.Checkbox.Group","Hierarchical data — use NestedList","Display-only chip/tag collections — use Chip","Keyboard-only reordering is required — drag-and-drop has no keyboard support here"],useWhen:["Users must rearrange items dynamically — assigning departments, ranking options, reordering form content","Ordering grid/table columns or settings panels where sequence matters","Ordered lists that also need per-item removal (isRemovable + onRemove)","Moving items between multiple lists via a shared groupName","Horizontal chip-style ordering of compact items (isHorizontal)"]},antiPatterns:["Custom renderer with no visible drag affordance","Drag handles missing accessible names","Placeholder or fake `labelKey` when chips are not used","Reorder not persisted — `onUpdate` missing while drag is enabled","Item removal reimplemented in renderer instead of `isRemovable`","DraggableList used as a static list container (`isDragDisabled`)","Fixed-position items handled by splitting lists instead of `shouldDisableItem`","Parallel drag library alongside DraggableList"],selection:{confusedWith:[{component:"ListItem",distinguishBy:"ListItem rows display content in a fixed order; DraggableList exists only when the user must rearrange the order by drag-and-drop"},{component:"CheckList",distinguishBy:"CheckList is for selecting items via checkboxes/switches; DraggableList is for ordering items, not selecting them"},{component:"Chip",distinguishBy:"Chip is a single static tag/token; DraggableList renders many chip-like items with reorder and removal behavior"},{component:"NestedList",distinguishBy:"NestedList displays hierarchical trees; DraggableList is a flat list whose value is the user-defined order"}]},relatedComponents:[{name:"Icon",note:"Drag-handle and action glyphs inside custom renderers; handles need accessible names",relationship:["complement"]},{name:"Button",note:"Per-item actions inside custom renderers",relationship:["complement"]},{name:"Form",note:"Common container when reordering is part of a settings/edit flow; persist via onUpdate",relationship:["complement"]},{name:"Modal",note:"Common container for reorder dialogs (e.g. column order, deduction order)",relationship:["complement"]},{name:"ListItem",note:"Use when order is fixed and rows just display content",relationship:["alternative"]},{name:"CheckList",note:"Use for selection without reordering",relationship:["alternative"]},{name:"Chip",note:"Use for static tag display with no reordering",relationship:["alternative"]}]},Drawer:{description:"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.",events:["close"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{caption:{description:"Subtext below the title in the drawer header",type:"string"},isCompact:{description:"Renders drawer in compact view",type:"boolean"},isVisible:{description:"Whether the drawer is visible. Bind to state to control open/close",type:"boolean"},maxWidth:{anyOf:[{type:"string"},{type:"number"}],description:"Maximum width of the drawer. Default: 80vw"},shouldAttachToRoot:{description:"Renders drawer in a portal at document root. Default: true",type:"boolean"},shouldCloseOnBackdropClick:{description:"Close drawer when clicking the backdrop. Default: true",type:"boolean"},shouldCloseOnEscape:{description:"Close drawer on ESC key press",type:"boolean"},shouldNotAnimate:{description:"Disables open/close animations. Default: false",type:"boolean"},theme:{description:"Visual style theme for the drawer",enum:["BACKGROUND_V2_GRAY","GRAY","NO_PADDING"],type:"string"},title:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{kind:{const:"BREADCRUMB",description:"Render the drawer title as a Breadcrumb",type:"string"},props:{additionalProperties:!1,description:"Breadcrumb props for the drawer title",properties:{active:{description:"Value of the active breadcrumb item",type:"string"},"aria-describedby":{description:"ID of element that describes the breadcrumb nav",type:"string"},"aria-label":{description:"Accessible label for the breadcrumb nav",type:"string"},"aria-labelledby":{description:"ID of element that labels the breadcrumb nav",type:"string"},items:{description:"Breadcrumb items shown in the drawer header",items:{additionalProperties:!1,properties:{href:{description:"URL to navigate to when clicked",type:"string"},isDisabled:{description:"Disables the breadcrumb item",type:"boolean"},title:{description:"Display label for the breadcrumb item",type:"string"},value:{description:"Unique value identifier for the item",type:"string"}},required:["title","value"],type:"object"},type:"array"},noMargin:{description:"Remove default breadcrumb margin",type:"boolean"},shouldCollapseMiddle:{description:"Collapse middle breadcrumb items",type:"boolean"}},required:["items"],type:"object"}},required:["kind","props"],type:"object"}],description:"Title displayed in the drawer header as text or breadcrumb config"},width:{anyOf:[{type:"string"},{type:"number"}],description:"Width of the drawer. Default: 80vw"}},type:"object"},acceptsChildren:!0,category:["modal"],keywords:["drawer","side panel","slide over","sliding panel","side sheet","right panel","secondary task","edit panel","record details","drill down","detail view","contextual panel","form panel","sub flow","slide-over"],anatomy:{parts:[{name:"Container",required:!0,role:"The sliding panel itself; width via width/maxWidth, theme via Drawer.THEMES"},{name:"Header",required:!1,role:"Title (string or { kind: 'BREADCRUMB' } config for drill-down) plus optional caption"},{name:"Content area",required:!0,role:"Scrollable body — forms, record details, tabs, or lists"},{name:"Drawer.Footer",required:!1,role:"Bottom action bar with primary/secondary buttons"},{name:"Drawer.CloseButton",required:!1,role:"Standard Cancel button; must be placed inside Drawer.Footer"},{name:"Overlay",required:!0,role:"Semi-transparent backdrop dimming the main content"}],summary:"A full-height panel sliding in from the right over a dimmed backdrop. Header holds the title (plain string or breadcrumb config) and optional caption; the content area scrolls; Drawer.Footer at the bottom holds action buttons with Drawer.CloseButton as the standard Cancel. isCompact reduces padding and typography for narrow views."},guidance:{doNotUseWhen:["Short confirmations or destructive-action prompts — use Modal","A primary, multi-step flow that deserves its own URL — use Page","Small content anchored to a trigger (menus, pickers) — use Popper or MenuList","Nesting drawers inside drawers — use breadcrumb drill-down within one Drawer","Rendering a data table inside without shouldNotAnimate and a fixed table height"],useWhen:["Secondary tasks (edit, configure, review) that must preserve the user's page context","Record detail or drill-down views opened from a list, grid row, or table","Multi-field forms too large for a Modal — embed a Form with noFooter","Flows needing breadcrumb drill-down within one surface (title breadcrumb config)","Side content like change history, comments, or email previews alongside the main view"]},antiPatterns:["Data tables inside drawers without disabling drawer animation","Custom drawer sizing instead of the compact standard","Stacked nested drawers instead of breadcrumb drill-down in one drawer","Drawer missing a proper header title","Hardcoded English text in drawer titles","Footer actions without the standard Cancel/Close button","Custom breadcrumb navigation built inside drawer body"],aiGuardrails:[{guardrail:"For record-review drawers, Drawer owns the container, title, caption, and footer actions; it should not define custom field/value preview layouts. If the drawer body previews editable or reviewable record data, prefer `Form isSettings` for read-only/settings-style display, and switch to a regular `Form` for edit mode. Keep approve/reject/save/archive buttons in `Drawer.Footer`.",section:"Record-review drawers"}],selection:{confusedWith:[{component:"Modal",distinguishBy:"Modal is a centered blocking dialog for short, focused tasks and confirmations; Drawer slides from the edge for larger secondary tasks that must preserve page context"},{component:"Page",distinguishBy:"Page is a full navigable route for primary flows; Drawer is an in-context overlay for secondary flows that should not change the URL or lose the underlying view"},{component:"Popper",distinguishBy:"Popper is a small anchored overlay (menus, pickers) tied to a trigger element; Drawer is a full-height task panel with header, scrolling body, and footer actions"},{component:"ExpansionPanel",distinguishBy:"ExpansionPanel reveals detail inline within a list or page; Drawer takes the task into a separate overlay surface with its own header and actions"}]},relatedComponents:[{name:"Drawer.Footer",note:"Canonical placement for the drawer's action buttons",relationship:["child"]},{name:"Drawer.CloseButton",note:"Standard Cancel button; only valid inside Drawer.Footer",relationship:["child"]},{name:"Form",note:"Common body content; embed with noFooter so Drawer.Footer owns the actions",relationship:["complement"]},{name:"Tabs",note:"Frequently used to split drawer content into sections",relationship:["complement"]},{name:"Notice",note:"Inline callouts at the top of the drawer body (e.g. blocked-state banners)",relationship:["complement"]},{name:"Modal",note:"Short focused tasks or confirmations that should fully block the page",relationship:["alternative"]},{name:"Page",note:"Primary flows that deserve their own route and URL",relationship:["alternative"]},{name:"Popper",note:"Small anchored content that stays attached to its trigger",relationship:["alternative"]}]},Dropdown:{description:"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.",events:["change","toggle","action"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{clickedValue:{description:"Bindable last clicked item value, written before the action event emits"},defaultValue:{description:"Initially selected value"},dropdownIsOpen:{description:"Bindable state written when the dropdown opens or closes",type:"boolean"},footer:{additionalProperties:{},description:"Footer item rendered at the bottom of the list",properties:{disabledInfo:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{type:"string"}},required:["content"],type:"object"}],description:"Tooltip content shown when the option is disabled"},isDisabled:{description:"Disables this option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon name to show next to the label",type:"string"},leftIconType:{description:"Icon name to show on the left side of the item",type:"string"},quaternaryLabel:{description:"Quaternary text below the tertiary label",type:"string"},secondaryLabel:{description:"Secondary text below the main label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text",type:"string"}},required:["text"],type:"object"}],description:"Tag shown beside the option text"},tertiaryLabel:{description:"Tertiary text below the secondary label",type:"string"},type:{description:"Visual style type for the option (WARNING or ALERT)",enum:["WARNING","ALERT"],type:"string"},value:{description:"Value for the option"}},type:"object"},isCompact:{description:"Render in compact mode",type:"boolean"},isDisabled:{description:"Disable the dropdown trigger",type:"boolean"},list:{description:"Array of dropdown options: {label, value, isDisabled?}",items:{anyOf:[{additionalProperties:{},properties:{disabledInfo:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{type:"string"}},required:["content"],type:"object"}],description:"Tooltip content shown when the option is disabled"},isDisabled:{description:"Disables this option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon name to show next to the label",type:"string"},leftIconType:{description:"Icon name to show on the left side of the item",type:"string"},quaternaryLabel:{description:"Quaternary text below the tertiary label",type:"string"},secondaryLabel:{description:"Secondary text below the main label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text",type:"string"}},required:["text"],type:"object"}],description:"Tag shown beside the option text"},tertiaryLabel:{description:"Tertiary text below the secondary label",type:"string"},type:{description:"Visual style type for the option (WARNING or ALERT)",enum:["WARNING","ALERT"],type:"string"},value:{description:"Value for the option"}},type:"object"},{additionalProperties:{},properties:{isDisabled:{description:"Disables this option",type:"boolean"},isNestedMenu:{description:"Marks this item as a nested menu",type:"boolean"},label:{description:"Display text for the nested menu item",type:"string"},labelIcon:{description:"Icon name to show next to the label",type:"string"},leftIconType:{description:"Icon name to show on the left side of the item",type:"string"},list:{description:"Nested flat list items",items:{additionalProperties:{},properties:{disabledInfo:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{type:"string"}},required:["content"],type:"object"}],description:"Tooltip content shown when the option is disabled"},isDisabled:{description:"Disables this option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon name to show next to the label",type:"string"},leftIconType:{description:"Icon name to show on the left side of the item",type:"string"},quaternaryLabel:{description:"Quaternary text below the tertiary label",type:"string"},secondaryLabel:{description:"Secondary text below the main label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text",type:"string"}},required:["text"],type:"object"}],description:"Tag shown beside the option text"},tertiaryLabel:{description:"Tertiary text below the secondary label",type:"string"},type:{description:"Visual style type for the option (WARNING or ALERT)",enum:["WARNING","ALERT"],type:"string"},value:{description:"Value for the option"}},type:"object"},type:"array"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text",type:"string"}},required:["text"],type:"object"}],description:"Tag shown beside the option text"},value:{description:"Value for the nested option"}},required:["label","list"],type:"object"},{additionalProperties:!1,properties:{isSeparator:{const:!0,description:"Render a visual separator",type:"boolean"}},required:["isSeparator"],type:"object"}]},type:"array"},maxHeight:{description:"Max height of the dropdown list in px. Default: 224",type:"number"},placement:{description:"Popover position. Default: bottom-start",enum:["bottom-start","bottom","bottom-end","top-start","top","top-end","left-start","left","left-end","right-start","right","right-end"],type:"string"},searchable:{description:"Enable search within the dropdown list",type:"boolean"},shouldAutoClose:{description:"Auto-close after item selection",type:"boolean"},shouldCloseOnScroll:{description:"Close on document scroll",type:"boolean"},showSelectedLabel:{description:"Display the selected option label in the trigger. Defaults to false; empty or unmatched values use triggerLabel",type:"boolean"},triggerAriaLabel:{description:"Accessible label for the trigger button. Recommended for icon-only triggers.",type:"string"},triggerIcon:{description:"Icon.TYPES name to render in the dropdown trigger button. Provide it for icon-only or icon-plus-label triggers.",type:"string"},triggerLabel:{description:"Visible label for the dropdown trigger button. Omit it for an icon-only trigger.",type:"string"},triggerSize:{description:"Size of the trigger button (XS, S, M, L). Default: M",enum:["XS","S","M","L"],type:"string"},value:{description:"Currently selected value. Bind to state for selection tracking"},width:{description:"Width of the dropdown list in px. Default: 192",type:"number"}},required:["list"],type:"object"},acceptsChildren:!1,category:["complex"],keywords:["dropdown","menu","overflow menu","more actions","kebab","context menu","action menu","row actions","options menu","three dots","ellipsis menu","account switcher","language switcher"],anatomy:{parts:[{name:"Trigger",required:!0,role:"Child element that opens the menu; icon-only triggers need aria-label; render-prop gives full control"},{name:"Menu list",required:!0,role:"Floating option list built from the list prop; flat, grouped, or nested via enableNestedMenus"},{name:"Menu item",role:"Label plus optional leftIconType, avatarProps, flag, tag, secondary labels, disabledInfo, and trailing control"},{name:"Search",role:"Optional searchable header (object or per-level function) for long lists"},{name:"Footer",role:"Sticky bottom action item (e.g. 'Add new') separated by a border"}],summary:"A trigger element (children — usually Button.Icon with MORE_HORIZONTAL/VERTICAL) plus a floating menu rendered from the list prop. Menu cells have a prefix (icon/avatar/flag), label with optional secondary/tertiary/quaternary text, and a suffix (selected check, label icon, tooltip, trailing checkbox/switch/text). Grouped lists add section labels and separators; menus support search, nested submenus, a sticky footer item, and scrolling."},guidance:{doNotUseWhen:["Selecting a value in a form — use Input.Select (Dropdown's trigger looks like a button, not an input)","Fewer than 3 options with room to show them — render inline Buttons, Radio, or Input.Checkbox instead","Options should remain visible — use SelectableMenu or an inline list","One dominant action with related alternatives — use SplitButton","Mobile-first surfaces — prefer a bottom-sheet pattern"],useWhen:["Grouping 3–15 related actions without cluttering the UI — row actions, overflow 'more' menus, grid toolbars","Overflow menus on cards, tables, and grids triggered by a MORE icon button","Switchers anchored to a custom trigger (account, company, language, workspace)","Long or grouped option lists needing search, nested submenus, or a sticky footer action","Menus with per-row trailing controls (checkbox multi-select, switch toggles, quiet text)"]},antiPatterns:["Menus missing fixed positioning — clipped or hidden inside scroll areas","Icon-only menu triggers missing an accessible name","Overflow menus with fewer than three options — extra click for actions that could be inline","Inconsistent icons across items in the same menu","Destructive or high-risk actions without warning styling","Dropdown used as a form select instead of Input.Select","Disabled menu items with no explanation for why they are unavailable","Portal rendering disabled — menu clipped by parent overflow"],selection:{confusedWith:[{component:"Input.Select",distinguishBy:"Input.Select is a form field that looks and behaves like an input (label, validation, form registration); Dropdown is a button/icon-triggered menu of actions or options — never use Dropdown as a form select"},{component:"SelectableMenu",distinguishBy:"SelectableMenu renders an always-visible selectable list inline; Dropdown hides options behind a trigger to save space"},{component:"SplitButton",distinguishBy:"SplitButton is one labeled primary action with related alternatives in a chevron menu; Dropdown is a generic trigger (often icon-only) opening a menu with no dominant action"}]},relatedComponents:[{name:"Button.Icon",note:"The canonical trigger (MORE_HORIZONTAL/VERTICAL); always pass aria-label and a tip",relationship:["complement"]},{name:"MenuList",note:"Renders the option list; Dropdown re-exports its OPTION_TYPES and TRAILING_TYPES",relationship:["child"]},{name:"Input.Select",note:"Use for value selection inside forms with labels and validation",relationship:["alternative"]},{name:"SelectableMenu",note:"Use when options should stay visible inline instead of behind a trigger",relationship:["alternative"]},{name:"SplitButton",note:"Use when there is one primary action plus a few related alternatives",relationship:["alternative"]},{name:"Popper",note:"Underlying positioning engine; PLACEMENTS and MIDDLEWARES come from Popper",relationship:["complement"]}]},Email:{description:"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.",events:["change","blur","focus","click","keydown","keyup","paste","mouseenter","mouseleave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},shouldAllowAutoFill:{description:"Allow browser autofill",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},shouldStopEventPropagation:{description:"Stop automatic input focus when clicking container",type:"boolean"},shrinkToPlaceholder:{description:"Input spans as much as its placeholder when true. Only applies when placeholder is visible",type:"boolean"},shrinkToValue:{description:"Input spans as much as its value when true. Only applies when value is present",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},theme:{description:"Theme name from Input.Text.THEMES or custom theme",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"null"}],description:"Current email value bound to state"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["email","email input","emailinput","email address","recipient email","contact","registration","login","subscription","notification"],anatomy:{parts:[{name:"Label",required:!0,role:"Persistent field label; placeholder alone is not sufficient"},{name:"Email field",required:!0,role:"Native input[type=email] entry with built-in format validation"},{name:"Helper/Error text",required:!1,role:"Guidance below the field; replaced by error text when invalid"}],summary:"A persistent label/title above a single-line email text field with a placeholder indicating the expected format; helper text sits below and is replaced by a red border plus descriptive error message on validation failure. Accessibility attributes are inherited from the base Text input."},guidance:{doNotUseWhen:["Work emails restricted to company domains — use Input.WorkEmail with a domainList","Non-email values (phone numbers, usernames) — use Input.Text or Input.Phone","Standalone data-submit flows outside a Form — wrap with Form.Input.Email instead","Redundant custom isEmail validation on top of the built-in email validation"],useWhen:["Collecting email addresses for registration, login, subscriptions, or report recipients","Automatic email-format validation is needed to reduce entry errors","Email is a communication channel for account notifications and system updates","Inside a Form for data-submit flows (use Form.Input.Email)"]},antiPatterns:["Email field identified by placeholder only, without a persistent title","Redundant custom `isEmail` validation on a field already using Email input","Standalone `Input.Email` outside Form for data-submit flows"],selection:{confusedWith:[{component:"Input.WorkEmail",distinguishBy:"WorkEmail restricts addresses to company-owned domains via a dropdown and takes only the username; Email accepts any valid email address"},{component:"Input.Text",distinguishBy:"Text has no email semantics; Email uses input[type=email] for built-in browser validation and mobile email keyboards"}]},relatedComponents:[{name:"Form",note:"Data-submit flows use Form.Input.Email inside a Form for validation and submission",relationship:["complement"]},{name:"Input.WorkEmail",note:"Work emails restricted to company-owned domains",relationship:["alternative"]},{name:"Input.Text",note:"Free-form values that are not email addresses",relationship:["alternative"]},{name:"Input.Phone",note:"Commonly paired in contact forms (email + phone)",relationship:["complement"]}]},EmojiPicker:{description:"An emoji picker that lets users browse and select emojis by category or search. Can be rendered inline or in a popover. onChange emits the selected emoji data including native representation, name, and keywords.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{autoFocus:{description:"If true, automatically focuses the search input. Default: false",type:"boolean"},categories:{description:"Array of emoji categories to display",items:{enum:["frequent","people","nature","foods","activity","places","objects","symbols","flags"],type:"string"},type:"array"},excludeIds:{description:"Emoji IDs to hide from the picker",items:{type:"string"},type:"array"},fluid:{description:"If true, makes width 100% of container. Default: false",type:"boolean"},height:{description:"Height CSS value of the emoji picker",type:"string"},inline:{description:"If true, renders the emoji picker inline. Default: false",type:"boolean"},minHeight:{description:"Minimum height CSS value of the emoji picker",type:"string"},minWidth:{description:"Minimum width CSS value of the emoji picker",type:"string"},popperProps:{additionalProperties:!1,description:"Serializable popover options; middleware functions are not supported",properties:{placement:{description:"Popover placement",enum:["top-start","top","top-end","right-start","right","right-end","bottom-end","bottom","bottom-start","left-end","left","left-start"],type:"string"},shouldFlipIfNoSpace:{description:"Whether the popover flips when there is not enough space",type:"boolean"}},type:"object"},preventCloseOnSelect:{description:"Prevents the popover from closing when an emoji is selected",type:"boolean"},selectedEmoji:{additionalProperties:!1,description:"Bindable selected emoji data written before the change event emits",properties:{name:{description:"Descriptive emoji name",type:"string"},id:{description:"Unique identifier for the emoji",type:"string"},keywords:{description:"Search keywords for the emoji",items:{type:"string"},type:"array"},native:{description:"Native emoji character",type:"string"},shortcodes:{description:"Short-form emoji representation",type:"string"},unified:{description:"Unicode representation for the emoji",type:"string"}},required:["id","name","native","shortcodes","keywords","unified"],type:"object"},triggerIcon:{description:"Icon.TYPES name to render as the default popover trigger",type:"string"},width:{description:"Width CSS value of the emoji picker",type:"string"}},type:"object"},acceptsChildren:!1,category:["forms"],keywords:["emoji picker","emojipicker","emoji","reaction","add reaction","emoji status","chat","message composer","emoji select","smiley"],anatomy:{parts:[{name:"Trigger",required:!0,role:"Custom button rendered via triggerRenderer; must wire the provided id, ref, and onClick onto one element to keep focus and click handling intact"},{name:"Picker panel",required:!0,role:"Popover (or inline region) with search field and categorized emoji grid; powered by Popper"}],summary:"A trigger element (supplied via triggerRenderer, receiving id, ref, and onClick) that opens a popover panel containing emoji search and a categorized emoji grid. The selected emoji is returned through onChange as { native } — a Unicode character, not an image or icon key."},guidance:{doNotUseWhen:["Choosing from predefined product icons — use Icon-based selection; EmojiPicker covers Unicode emoji only","Only 3–5 fixed emoji options are ever needed — use a simple Button group instead","Free-text fields that merely allow emoji — let the OS keyboard handle insertion via Input.Text"],useWhen:["Emoji reactions on messages, comments, or posts","Letting users pick an emoji icon for policies, rules, or statuses they configure","Inserting emojis into chat or rich-text composers","Dedicated inline emoji-selection interfaces (use the inline variant)"]},antiPatterns:["Custom trigger splits ref/id and click handler across nested elements","Custom trigger chrome uses hardcoded colors, spacing, or radius instead of theme tokens","Partial trigger click target — only a sub-control opens the picker","Focus trap and keyboard navigation compromised on custom triggers","Broken accessible naming on custom emoji trigger","Icon-only reaction trigger omits `id` wiring in compact mode"],selection:{confusedWith:[{component:"Icon",distinguishBy:"EmojiPicker selects Unicode emoji characters for user content; Icon renders fixed product iconography — for choosing product icons build an Icon-based selector instead"},{component:"Dropdown",distinguishBy:"Dropdown selects from a defined option list of labels/values; EmojiPicker is a searchable Unicode emoji grid returning emoji characters"},{component:"Input.Text",distinguishBy:"Input.Text collects free text (where the OS emoji keyboard handles emoji); EmojiPicker is a picker UI for explicitly choosing an emoji as data"}]},relatedComponents:[{name:"Popper",note:"Powers the picker's popover; pass popperProps (e.g. focusLock: false) when nesting inside other focus-trapped overlays",relationship:["parent"]},{name:"Button",note:"Typical trigger content — Button or Button.Icon wired with the provided id, ref, onClick",relationship:["complement"]},{name:"Icon",note:"Predefined product icon selection instead of Unicode emoji",relationship:["alternative"]},{name:"Dropdown",note:"Label/value option selection instead of emoji characters",relationship:["alternative"]},{name:"Input.Text",note:"Common pairing in policy/rule builders — emoji trigger next to a name text field",relationship:["complement"]}]},EmployeeSearch:{description:"Search for and select one or more employees outside of a registered form. Supports ACTIVE; GOOD (HIRED, ACCEPTED, and ACTIVE); ACCEPTED_AND_ACTIVE (excluding HIRED); NON_INIT (all employee states except INIT, including TERMINATED); INIT (hiring started but not completed; the backend preset is roleState INIT and is not employee-constrained); and TERMINATED. The change event is notification-only and has no payload.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{canClear:{description:"Controls whether the current selection can be cleared. When omitted, the underlying select default applies.",type:"boolean"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Initial uncontrolled selection as an employee role id for single select or role id array for multi-select. Defaults to no selection."},isDisabled:{description:"When true, disables searching and selection changes. Defaults to false.",type:"boolean"},isMulti:{description:"When true, allows multiple employee selections and uses role id arrays. Defaults to false (single select).",type:"boolean"},isReadOnly:{description:"When true, displays the selection without allowing changes. Defaults to false.",type:"boolean"},isRequired:{description:"When true, marks the field as required. Defaults to the form control default (not required).",type:"boolean"},label:{description:"Label displayed for the search field. Defaults to no label.",type:"string"},placeholder:{description:"Placeholder displayed when the search field is empty. When omitted, the component default placeholder is used.",type:"string"},roleIdsToExclude:{description:"Removes the specified employee role ids from search results when no inclusion list is provided. When both lists are provided, inclusion takes precedence. When omitted, no role ids are explicitly excluded.",items:{type:"string"},type:"array"},roleIdsToInclude:{description:"Limits search results to the specified employee role ids. When both inclusion and exclusion lists are provided, inclusion takes precedence. When omitted, results are not restricted by an inclusion list.",items:{type:"string"},type:"array"},roleTypes:{description:"Limits search results using backend role-type presets. ACTIVE selects active employees. GOOD selects HIRED, ACCEPTED, and ACTIVE employees. ACCEPTED_AND_ACTIVE selects ACCEPTED and ACTIVE employees and excludes HIRED. NON_INIT selects all employee states except INIT, including TERMINATED. INIT selects the backend roleState INIT preset (hiring started but not completed) and is not additionally constrained to employees. TERMINATED selects terminated employees. Requires at least one value; defaults to GOOD.",items:{enum:["ACTIVE","GOOD","ACCEPTED_AND_ACTIVE","NON_INIT","INIT","TERMINATED"],type:"string"},minItems:1,type:"array"},tip:{description:"Supplementary tip displayed with the label. Defaults to no tip.",type:"string"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Controlled selection as an employee role id for single select or role id array for multi-select. When omitted, the component is uncontrolled. When value and defaultValue are both provided, value takes precedence."}},type:"object"},acceptsChildren:!1},ExpansionPanel:{description:"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.",events:["toggle"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{depth:{description:"Nesting depth for tree views",type:"number"},horizontalCollapsedArrow:{description:"Arrow points right when collapsed instead of down",type:"boolean"},indent:{description:"Indentation amount in px",type:"number"},isDefaultOpen:{description:"Start expanded. Default: false",type:"boolean"},isDisabled:{description:"Disable the panel. Default: false",type:"boolean"},isOpen:{description:"Controlled expansion state. Bind to state for control",type:"boolean"},isOutlined:{description:"Show border. Default: true",type:"boolean"},shouldNotAnimate:{description:"Disable CSS animation. Default: false",type:"boolean"},shouldNotUnmountChild:{description:"Keep child mounted when collapsed. Default: false",type:"boolean"},theme:{description:"Visual style variant",enum:["COMPACT","NO_PADDING","REVERSED","UNDERLINED","LIST","NO_TOGGLE","NESTEDTAB_PADDING","HOVERBALE","TRANSPARENT","NESTEDTAB_PADDING_TRANSPARENT","NO_PADDING_TRANSPARENT","NO_PADDING_UNDERLINED","NO_PADDING_REVERSED","REVERSED_TRANSPARENT_LIST","REVERSED_UNDERLINED_LIST","REVERSED_TRANSPARENT_LIST_NO_TOGGLE","REVERSED_UNDERLINED_LIST_NO_TOGGLE","LIST_NO_TOGGLE_REVERSED","NO_TOGGLE_TRANSPARENT","SURFACE_BACKGROUND"],type:"string"},title:{description:"Header text displayed in the expansion panel",type:"string"},toggleIcon:{additionalProperties:!1,description:"Toggle icon layout options",properties:{align:{description:"CSS align-self value for the toggle icon",type:"string"},margin:{description:"CSS margin around the toggle icon container",type:"string"},size:{anyOf:[{type:"number"},{type:"string"}],description:"Toggle icon size. Default: 24px"}},type:"object"}},required:["title"],type:"object"},acceptsChildren:!0,category:["layout"],keywords:["accordion","collapsible","expand collapse","disclosure","collapsible section","filter panel","side panel sections","advanced options","progressive disclosure"],anatomy:{parts:[{name:"Header",required:!0,role:"Always-visible row with the panel title; toggles the body on click"},{name:"Toggle arrow",required:!0,role:"Chevron indicating expanded/collapsed state"},{name:"Body",required:!0,role:"Collapsible content region revealed on expand"}],summary:"A header row (title plus a toggle arrow on one side) above a collapsible body region. Panels stack inside ExpansionPanel.Group, which can enforce single-open accordion behavior via isSingleOpen."},guidance:{doNotUseWhen:["Critical information that needs immediate visibility — keep it on the page","Users are likely to read all the content — use a full scrolling page with headers instead of adding clicks","Switching between mutually exclusive views — use Tabs","Content belongs in a separate overlay surface — use a Drawer"],useWhen:["Extensive related content must fit in limited space, like a side panel — users scan headers and expand only what they need","Secondary or advanced content that should not clutter the default view (advanced filters, optional settings, debug details)","Long pages that read better as scannable collapsible sections than one scrolling column","Multiple stacked panels — wrap them in ExpansionPanel.Group"]},antiPatterns:["Inline header/body renderers that remount on every toggle","Interactive controls placed in the expandable header","Collapsible forms without preserving child state","Multiple panels stacked without Group wrapper","Too many sections left expanded by default","Manual single-open accordion without `isSingleOpen`"],selection:{confusedWith:[{component:"Drawer",distinguishBy:"ExpansionPanel reveals content inline within the page; Drawer takes the content into an edge-sliding overlay"},{component:"ShowMore",distinguishBy:"ShowMore truncates a list by item count; ExpansionPanel toggles whole titled sections"},{component:"Tabs",distinguishBy:"Tabs switch between mutually exclusive sibling panes; ExpansionPanel lets several sections stay open at once on the same page"}]},relatedComponents:[{name:"ExpansionPanel.Group",note:"Wraps multiple stacked panels; isSingleOpen gives accordion behavior",relationship:["child"]},{name:"Atoms.ToggleableArrow",note:"The standalone expand/collapse chevron used inside custom disclosure UIs",relationship:["complement"]},{name:"Drawer",note:"Content belongs in an overlay instead of inline",relationship:["alternative"]},{name:"ShowMore",note:"Truncating a long list rather than toggling sections",relationship:["alternative"]},{name:"Tabs",note:"Mutually exclusive panes instead of stackable sections",relationship:["alternative"]}]},ExpansionPanelGroup:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{isSingleOpen:{description:"Only allow one panel open at a time. Default: false",type:"boolean"}},type:"object"},acceptsChildren:!0},Field:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{helperMessage:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{message:{description:"Helper or error message text",type:"string"},status:{description:'Message status, e.g. "ERROR" for validation errors',type:"string"}},required:["message"],type:"object"}],description:"Helper text below the field, or object with message and status"},isHiddenInput:{description:"Hides the input portion of the field",type:"boolean"},isInline:{description:"Renders label and input on the same line",type:"boolean"},isReadOnly:{description:"Renders the field in read-only mode",type:"boolean"},isRequired:{description:"Shows required asterisk next to the label",type:"boolean"},label:{description:"Label text displayed above the field",type:"string"},theme:{description:"Predefined style theme for margin/padding adjustments",enum:["NO_MARGIN","NO_PADDING","NO_PADDING_NO_MARGIN"],type:"string"},tip:{description:"Tooltip text shown next to the label via an info icon",type:"string"}},type:"object"},acceptsChildren:!0},File:{description:"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.",events:["change","delete","chipClick"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the file input",type:"string"},allowCameraCapture:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{quality:{description:"Captured image quality",type:"number"}},type:"object"}],description:"Allow camera capture for image files; object form supports quality"},clickedFile:{additionalProperties:!1,description:"Bindable clicked file metadata written before chipClick emits",properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},isMultipart:{description:"Whether this is a multipart upload",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},size:{description:"File size in bytes",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},cropperConfig:{additionalProperties:!1,description:"Image cropper configuration",properties:{aspectRatio:{description:"Aspect ratio for cropper",enum:["16:9","4:3","1:1"],type:"string"},enforceAspectRatio:{description:"Enforce cropper aspect ratio",type:"boolean"},showUploadButton:{description:"Show upload button on cropper",type:"boolean"},title:{description:"Title for the cropper modal",type:"string"}},type:"object"},defaultValue:{description:"Default files to show when no value is provided",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},isMultipart:{description:"Whether this is a multipart upload",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},size:{description:"File size in bytes",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"},icon:{description:"Icon name from Icon.TYPES to show above placeholder",type:"string"},isDisabled:{description:"Disables the file input",type:"boolean"},isInvalid:{description:"Shows error styling on the input",type:"boolean"},isReadOnly:{description:"Makes the file input read-only (download only)",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},maxFileSize:{description:"Max file size in MB per file. Default: 2048",type:"number"},maxTotalFileSize:{description:"Max total file size in MB for all files",type:"number"},multiple:{description:"Allow multiple file uploads. Default: false",type:"boolean"},placeholder:{description:"Label shown when no files are selected",type:"string"},showProgress:{description:"Show upload progress bar. Default: false",type:"boolean"},supportTypes:{description:'Array of supported file extensions, e.g. [".pdf", ".doc"]',items:{type:"string"},type:"array"},type:{description:"File input display type. Default: DEFAULT",enum:["DEFAULT","RECEIPT"],type:"string"},value:{description:"Array of file objects bound to state",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},isMultipart:{description:"Whether this is a multipart upload",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},size:{description:"File size in bytes",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["file input","fileinput","file upload","attach file","attachment","browse files","choose file","receipt upload","camera capture","image cropper","document upload","csv upload","read-only attachments"],anatomy:{parts:[{name:"Label",required:!0,role:"Describes what to upload; required for accessibility"},{name:"Upload trigger",required:!0,role:"Click-to-browse button opening the native file picker; no drag-and-drop zone"},{name:"File chips",required:!1,role:"Selected/uploaded files with remove action and optional progress"},{name:"Helper/Error text",required:!1,role:"States accepted types, size limits, or upload errors"}],summary:"A label above a compact upload trigger (button-styled browse affordance), with selected files shown as removable chips below and helper/error text underneath. With isReadOnly, only the file chips render — no trigger."},guidance:{doNotUseWhen:["Drag-and-drop upload is expected — use FileDrop","Uploads should go straight to S3 with progress — use FileDrop type={FileDrop.TYPES.UPLOAD} with metadata","Embedding files in rich text or document content — use the RichTextEditor FileUpload feature","Plain text entry — use Input.Text; FileInput is for binary file data only"],useWhen:["Attaching a small number of files (receipts, documents, images) via a browse button in a form","Mobile camera capture for receipts or ID documents (allowCameraCapture)","Image uploads that need cropping first (enableCropper with SUPPORTED_TYPES.IMAGES)","Read-only display of previously uploaded attachments (isReadOnly with defaultValue)","Programmatic file picking triggered from a custom button via ref"]},antiPatterns:["File upload feedback sent via toast instead of on the field","File upload field missing an accessible label","Async uploads without progress feedback on the control","File type restrictions not configured","Hidden file input used as a custom trigger without accessible association","Read-only file display without type configuration"],selection:{confusedWith:[{component:"FileDrop",distinguishBy:"FileDrop adds a drag-and-drop zone and a built-in S3 upload flow (type, metadata); Input.File is click-to-browse only and hands the consumer a raw File object to process"},{component:"FileUpload",distinguishBy:"FileUpload is a RichTextEditor/DocumentEditor feature for embedding files in editor content; Input.File is a standalone form field"}]},relatedComponents:[{name:"Form",note:"Use Form.Input.File inside a Form for validation and submission; common for document uploads (W-9s, void checks, CSV imports)",relationship:["complement"]},{name:"FileDrop",note:"Drag-and-drop uploads with managed S3 upload; also exposed as Input.FileDrop",relationship:["alternative"]},{name:"FileUpload",note:"Editor feature for inserting files into rich text, not a form field",relationship:["alternative"]}]},FileDrop:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the file input",type:"string"},allowCameraCapture:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{quality:{description:"Captured image quality",type:"number"}},type:"object"}],description:"Allow camera capture for image files; object form supports quality"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},cropperConfig:{additionalProperties:!1,description:"Cropper configuration",properties:{aspectRatio:{description:"Aspect ratio for cropper. Default: 1:1",enum:["16:9","4:3","1:1"],type:"string"},enforceAspectRatio:{description:"Enforce the aspect ratio on cropper. Default: true",type:"boolean"},showUploadButton:{description:"Show upload button on cropper. Default: true",type:"boolean"},title:{description:"Title for the cropper modal",type:"string"}},type:"object"},defaultValue:{description:"Default files to show when no value is provided",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"},enableCropper:{description:"Enable image cropping for selected images",type:"boolean"},icon:{description:"Icon name from Icon.TYPES to show above placeholder",type:"string"},id:{description:"HTML id attribute for the file input",type:"string"},isDisabled:{description:"Disables the file input",type:"boolean"},isReadOnly:{description:"Makes the file input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the file drop area",type:"string"},maxFiles:{description:"Max number of files allowed in total",exclusiveMinimum:0,maximum:9007199254740991,type:"integer"},maxFileSize:{description:"Max file size in MB per attachment",type:"number"},maxTotalFileSize:{description:"Max total size in MB for all attachments",type:"number"},metadata:{description:"JSON-serializable metadata sent with upload requests"},module:{description:"Deprecated upload bucket hint; prefer metadata.module when possible",type:"string"},multiPartUpload:{description:"Enables multipart upload flow for files larger than 100MB",type:"boolean"},multiple:{description:"Allow selecting multiple files",type:"boolean"},placeholder:{description:"Text shown when no files are selected",type:"string"},supportTypes:{description:'Supported file extensions with dot prefix, e.g. [".pdf", ".png", ".jpg"]. Do NOT use MIME types.',items:{type:"string"},type:"array"},type:{description:"Type of file drop: upload (shows progress bars automatically) or content. Default: content",enum:["upload","content"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Array of file objects bound to state",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["file drop","filedrop","drag and drop","dropzone","file upload","s3 upload","bulk upload","csv import","receipt upload","document upload","attachment","image cropper","multipart upload","camera capture"],anatomy:{parts:[{name:"Label",required:!0,role:"Describes the upload section; standard input labeling rules apply"},{name:"Drop zone",required:!0,role:"Outlined area accepting drag-and-drop or click-to-browse"},{name:"Camera button",required:!1,role:"Optional capture-from-camera affordance (allowCameraCapture)"},{name:"File chips",required:!1,role:"Uploaded files with remove and retry-on-error actions"},{name:"Helper/Error text",required:!1,role:"Communicates type/size limits up front and inline failure guidance"}],summary:"A label above a large outlined drop zone with instructional text and a 'browse' link (plus optional camera button). Dropped/selected files render as removable chips below the zone with per-file upload progress; failed uploads show a negative chip that retries on click. Helper/error text sits under the field."},guidance:{doNotUseWhen:["A compact browse button fits better than a drop zone — use Input.File","Embedding files in rich text — use the RichTextEditor FileUpload feature","Multiple-file upload inside a modal or drawer — the vertical chip list is hard to manage there","Setting upload mode via string literals — use FileDrop.TYPES constants"],useWhen:["Users drag files from their file system — bulk CSV imports, document packets, expense receipts","Uploads should go directly to S3 with progress — type={FileDrop.TYPES.UPLOAD} with metadata.module","Reading file contents locally without a server upload — type={FileDrop.TYPES.CONTENT}","Large files over 100MB — enable multiPartUpload","Image uploads needing crop or camera capture","Read-only display of attachments on detail/approval pages (isReadOnly)"]},antiPatterns:["File limits not communicated in field help text","No per-file size limit configured on the component","S3 upload missing storage module configuration","Multiple-file upload inside modals or drawers","Custom file-picker UI instead of FileDrop","Upload error state without inline guidance text","Upload mode set via string literals instead of TYPES constants","Manual S3 upload pipeline bypassing FileDrop's built-in flow","Base file input used where drag-and-drop upload is expected","Custom wrapper replaces standard drop zone and remove affordances"],selection:{confusedWith:[{component:"Input.File",distinguishBy:"Input.File is a compact click-to-browse button that returns raw File objects; FileDrop provides the drag-and-drop zone and a managed S3 upload pipeline (type, metadata, multiPartUpload)"},{component:"FileUpload",distinguishBy:"FileUpload is a RichTextEditor/DocumentEditor feature for embedding files in editor content; FileDrop is a standalone form field"}]},relatedComponents:[{name:"Form",note:"Form.Input.FileDrop is the dominant usage — document onboarding, I-9/W-9 uploads, expense attachments; always use it inside a Form",relationship:["complement"]},{name:"Input.File",note:"Compact click-to-browse input without drag-and-drop or managed S3 upload",relationship:["alternative"]},{name:"FileUpload",note:"Editor feature for inline files in rich text, not a form field",relationship:["alternative"]}]},FloatingButton:{description:"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.",events:["press","pressWhileDisabled","mouseEnter","mouseLeave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{"aria-controls":{description:"ID of element controlled by the button",type:"string"},"aria-describedby":{description:"ID of element that describes the button",type:"string"},"aria-expanded":{description:"Indicates expanded state (for toggles)",type:"boolean"},"aria-haspopup":{anyOf:[{type:"boolean"},{type:"string"}],description:"Indicates the button opens a popup/menu"},"aria-label":{description:"Accessible label for the button. Required if aria-labelledby is not provided.",type:"string"},"aria-labelledby":{description:"ID of element that labels the button. Required if aria-label is not provided.",type:"string"},"aria-pressed":{anyOf:[{type:"boolean"},{const:"mixed",type:"string"}],description:"Indicates pressed state (for toggle buttons)"},icon:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type from Icon.TYPES",type:"string"}},required:["type"],type:"object"}],description:"Icon to display. Can be icon name string or object with type and color"},id:{description:"DOM id selector for the button element",type:"string"},inverseDisabledColors:{description:"Uses inverse color tokens for disabled state. Useful for dark backgrounds. Default: false",type:"boolean"},isDisabled:{description:"If true, button is disabled. Default: false",type:"boolean"},shouldPreventFocus:{description:"If true, the button will not be focusable (tabIndex -1). Default: false",type:"boolean"},shouldShowSpinner:{description:"If true, shows loading spinner instead of icon",type:"boolean"},size:{description:"Size of the button (XS, S, M, L). Default: M",enum:["XS","S","M","L"],type:"string"},tabIndex:{description:"Tab order for keyboard navigation",type:"number"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Control tooltip visibility from parent",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max height (number in px or CSS string)"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max width (number in px or CSS string)"},placement:{description:"Tooltip placement relative to button. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip text or tooltip configuration object"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{description:"Open link in new tab. Default: false",type:"boolean"},path:{description:"URL path for navigation",type:"string"}},required:["path"],type:"object"}],description:"Navigation destination. When provided, button renders as anchor and handles navigation automatically"},type:{description:"HTML button type attribute (button, submit, reset). Default: button",enum:["button","submit","reset"],type:"string"}},required:["icon"],type:"object"},acceptsChildren:!1,category:["buttons"],keywords:["floating button","fab","floating action button","scroll to top","scroll to bottom","collapse sidebar","expand panel","carousel navigation","close overlay","back button","fixed action"],anatomy:{parts:[{name:"Container",required:!0,role:"Circular elevated button surface floating above content"},{name:"Icon",required:!0,role:"Single glyph describing the action (arrow, chevron, close)"},{name:"Tooltip",required:!1,role:"Hover context for the icon-only action via the tip prop"}],summary:"A circular, shadowed container holding a single icon, positioned over content. Icon-only, so it always needs an accessible name (aria-label) and should pair with a tooltip via the tip prop. Sizes come from Button.Floating.SIZES, not Button.SIZES."},guidance:{doNotUseWhen:["The action needs a text label for context — use Button","An inline icon action within the layout flow — use Button.Icon","Constant visibility is not required — use Button in the normal layout","Multiple floating actions on the same screen — hierarchy collapses; keep one","Replacing established navigation patterns or support entry points — use Button.Support for help"],useWhen:["A screen's high-emphasis action must remain constantly visible while scrolling","Scroll-to-top/bottom on long lists, grids, and message threads","Collapsing or expanding sidebars, panels, and drawers","Carousel, photo, or graph previous/next navigation overlaid on media","Closing full-screen overlays and flows"]},antiPatterns:["Floating buttons without tooltips — icon-only FABs lack hover context","Multiple floating buttons on the same screen — hierarchy collapse","FAB used as list-row or inline control instead of page-level action","Missing accessible name on floating button","Wrong size API (`Button.SIZES` instead of `Button.Floating.SIZES`)"],selection:{confusedWith:[{component:"Button",distinguishBy:"Button carries a text label for actions needing context; Button.Floating is icon-only for actions that must float above scrolling content"},{component:"Button.Icon",distinguishBy:"Button.Icon is an inline icon-only action within the layout flow; Button.Floating is the elevated, fixed-position variant over content"}]},relatedComponents:[{name:"Button",note:"Use plain Button when the action needs a text label or does not need constant visibility",relationship:["parent"]},{name:"Button.Icon",note:"Inline icon-only action that does not float over content",relationship:["alternative"]},{name:"Button.Support",note:"Support/help entry point with title and caption instead of a generic FAB",relationship:["alternative"]},{name:"Tip",note:"Tooltip for the icon-only action via the tip prop",relationship:["complement"]}]},Form:{description:"A form container that groups inputs together with shared submit/cancel/validation behavior. Use to collect a set of related field values and submit them as one unit. Supports a settings mode with edit/readonly toggling.",events:["change","submit","valid","invalid","cancel","edit","skip"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{bottomPadding:{description:"Adds bottom padding to the form. Default: true",type:"boolean"},caption:{description:"Subtext shown beneath the title",type:"string"},editButton:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{disabledTip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Control tooltip visibility from parent",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max height (number in px or CSS string)"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max width (number in px or CSS string)"},placement:{description:"Tooltip placement",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip shown when the settings edit button is disabled"},isDisabled:{description:"Disable the settings edit button",type:"boolean"},show:{description:"Show or hide the settings edit button. Default: true",type:"boolean"}},type:"object"}],description:"Settings edit button visibility/configuration. Default: true"},inlineLabel:{description:"Renders fields with inline labels (label and input side-by-side)",type:"boolean"},isDefaultEdit:{description:"Initial edit state in settings mode. Requires isSettings: true",type:"boolean"},isDisabled:{description:"Disables the entire form",type:"boolean"},isEdit:{description:"Bind to state to externally control settings edit mode. Requires isSettings: true",type:"boolean"},isFluid:{description:"Stretches fields to fill horizontal space. Default: true when settings/inlineLabel",type:"boolean"},isSettings:{description:"Renders form with edit/readonly modes (settings form)",type:"boolean"},noFooter:{description:"Removes the form footer. Default: false",type:"boolean"},noVerticalSpacing:{description:"Removes vertical margin from settings form",type:"boolean"},shouldHaveStickyFooter:{description:"Pins the footer to the bottom of the screen",type:"boolean"},shouldHaveStickyFooterOffset:{description:"Adds offset to prevent overlap when footer is sticky. Default: true",type:"boolean"},shouldStopFormPropagation:{description:"Stops form-submit event from bubbling — for nested forms",type:"boolean"},shouldTriggerChangeOnInputUnmount:{description:"Fires change event when an input unmounts. Default: false",type:"boolean"},shouldTrimOnSubmit:{description:"Trims string values on submit. Default: false",type:"boolean"},skipButton:{additionalProperties:!1,description:"Secondary skip action. Click emits the skip event.",properties:{label:{description:"Skip button label. Defaults to the Pebble skip label",type:"string"}},type:"object"},submitButtonLabel:{description:"Deprecated submit button label. Prefer submitButtonProps.label for new specs",type:"string"},submitButtonProps:{additionalProperties:!1,description:"Configuration for the form submit button",properties:{icon:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{alignment:{description:"Icon alignment relative to button label. Default: LEFT",enum:["LEFT","RIGHT"],type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name from Icon.TYPES",type:"string"}},required:["type"],type:"object"}],description:"Icon to show in the submit button"},isDisabled:{description:"Disable submit button",type:"boolean"},isFluid:{description:"Stretch submit button to fill width",type:"boolean"},isLoading:{description:"Show loading spinner on submit button. Bind to state for manual control.",type:"boolean"},label:{description:"Submit button label",type:"string"},size:{description:"Submit button size",enum:["L","M","S","XS"],type:"string"}},type:"object"},successMessage:{description:"Message shown in a snackbar after a successful submit",type:"string"},theme:{description:"Predefined form style theme",enum:["NO_CARD","NO_MARGIN_Y","V2"],type:"string"},title:{description:"Form title shown in header",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"External validation errors keyed by input name",propertyNames:{type:"string"},type:"object"},values:{additionalProperties:{},description:"Form values model. Written to state on change/submit (read-only — push-only)",propertyNames:{type:"string"},type:"object"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Custom form container width (applies only to settings forms)"}},type:"object"},acceptsChildren:!0,category:["form"],keywords:["form","data entry","data collection","multi-field","validation","submit","settings form","edit mode","read-only edit toggle","onboarding","wizard","input fields","account setup","bank details"],anatomy:{parts:[{name:"Title",required:!1,role:"Header text establishing what the form is about"},{name:"Caption",required:!1,role:"Additional context and instructions under the title"},{name:"Form body",required:!0,role:"Input fields (Form.Input.*) where users provide information"},{name:"Footer",required:!1,role:"Submit/cancel actions; label overridden via submitButtonLabel"}],summary:"A vertical stack: optional header (title + caption), a single-column body of form-aware input fields (fluid, max 576px), and an optional footer with submit/cancel actions. Form.Group titles subsections, Form.InlineGroup places inputs side by side, Form.Content aligns non-input content to the column. isSettings renders cards with side-by-side labels and a read-only/edit toggle."},guidance:{doNotUseWhen:["Single, simple actions — use a Button or Switch instead","A single self-contained input like a search or filter bar — use standalone Input.* without a Form","Displaying review-style data that is rarely edited — prefer Form isSettings read-only or a DetailsCard","Inside Page.Content — Form owns its own page layout"],useWhen:["Collecting user data for processing — account creation, settings changes, feedback","Multiple inputs are required to complete a task","Settings-style pages that need a read-only/edit pattern (isSettings)","Data-entry flows inside a Drawer or Modal (use noFooter; the container owns actions)","Any flow needing field-level validation with inline error messages"]},antiPatterns:["Form wrapped inside `Page.Content`","`Form.GroupHeader` used instead of `Form.Group`","Custom `footer=` prop used instead of `submitButtonLabel`","`noFooter` combined with `isSettings`","`Form.InlineGroup` inside Settings Form","`Modal.Footer` placed outside Form as a sibling","Submit button disabled via `submitButtonProps.isDisabled`","Form inputs missing native validation props (most critical)","Input missing `name` so native validation cannot bind","Validation errors surfaced through non-native surfaces instead of inline field errors","Plain `Input.*` component used inside `Form` instead of `Form.Input.*`","Legacy `Field` wrapper around standalone inputs in data-entry flows","Multi-field data-entry flow built from standalone `Input.*` instead of Form","Mixed Radio or Input.Checkbox.Group variants in the same form","Hand-rolled settings edit/read-only mode instead of `Form isSettings`","Review-style data display rendered as an always-editable Form instead of `Form isSettings`"],aiGuardrails:[{guardrail:"Before using `submitButtonLabel` or Form's built-in actions, check whether the Form is embedded in Drawer, Modal, or another container with its own footer. In those cases, default to the parent container's footer actions.",section:"Container-owned form actions"},{guardrail:"For settings/preferences pages, default to `isSettings` — it provides the read-only review state, edit toggle, and Save/Cancel actions. Never rebuild that pattern by hand, and never place the Form inside Page.Content or put its submit button in Page.Footer.",section:"Settings pages"}],propGuidance:[{guidance:"Default for settings/preferences pages: renders sections as read-only cards with an Edit toggle and built-in Save/Cancel; returns to read-only after save. Pass a SettingsFormConfig to control edit state externally.",pitfall:"Combining with noFooter removes the Save/Cancel the pattern depends on",prop:"isSettings"},{guidance:"Use only when a container (Modal, Drawer) owns the actions; render the container's footer INSIDE the Form so the submit button is within the <form> element.",pitfall:"A type=submit button outside the Form (e.g. in Page.Footer) never submits it",prop:"noFooter"},{guidance:"Custom footer render prop receiving { submitBtnJsx, cancelBtnJsx } — use only to rearrange the built-in buttons, not to replace them with custom ones.",pitfall:"Rendering custom buttons instead of submitBtnJsx loses validation gating",prop:"footer"},{guidance:"Product-native confirmation shown after a successful submit; prefer it over firing a manual SnackBar for ordinary form saves.",prop:"successMessage"},{guidance:"Titled subsection that must WRAP its Form.Input.* children. In isSettings mode each group renders as its own read/edit card.",pitfall:"Self-closing <Form.Group title=... /> renders null — the section header disappears",prop:"Form.Group"}],selection:{confusedWith:[{component:"Input.Text",distinguishBy:"Standalone Input.* is for one self-contained input (search bar, filter) with no submission; Form is for multi-field data entry that needs validation and a submit action"},{component:"DetailsCard",distinguishBy:"DetailsCard displays label-value data read-only; use Form isSettings when the same record data needs an edit mode"},{component:"Field",distinguishBy:"Field is a legacy label wrapper around a single input; Form owns the whole data-entry flow — registration, validation, layout, submission"}]},relatedComponents:[{name:"Form.Input",note:"Form-aware inputs (Text, Select, Radio, Input.Checkbox, Date, etc.); always use these inside a Form, not plain Input.*",relationship:["child"]},{name:"Form.Group",note:"Titled subsection inside a form",relationship:["child"]},{name:"Form.InlineGroup",note:"Two or three inputs side by side in a row; not supported in Settings Form",relationship:["child"]},{name:"Form.Content",note:"Wraps non-input content (callouts, Notices) to the input column width",relationship:["child"]},{name:"Form.GroupHeader",note:"Deprecated — use Form.Group",relationship:["child"]},{name:"DetailsCard",note:"Read-only label-value display when no editing is needed",relationship:["alternative"]},{name:"Drawer",note:"Common container; the Drawer footer owns actions, so the embedded Form uses noFooter",relationship:["complement"]},{name:"Modal",note:"Common container for short forms; Modal.Footer owns actions",relationship:["complement"]},{name:"Notice",note:"Inline callouts inside Form.Content",relationship:["complement"]}]},FormCheckbox:{description:"A Form-registered checkbox for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial checked state when uncontrolled",type:"boolean"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isIndeterminate:{description:"Sets checkbox to indeterminate (neither checked nor unchecked) state",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text for the checkbox. Ignored when the element has children (rich label).",type:"string"},secondaryLabel:{description:"Secondary text below the label",type:"string"},shouldPreventFocus:{description:"Prevent the checkbox from receiving focus",type:"boolean"},theme:{description:"Visual theme variant",enum:["FLUID_WIDTH","REVERSE","FLUID_WIDTH_SPACE_BETWEEN_REVERSE"],type:"string"},tip:{description:"Tooltip text shown on hover",type:"string"},title:{description:"Form field label shown outside the checkbox",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"boolean"},variant:{description:"Display variant",enum:["BOX","LIST","GRID"],type:"string"}},required:["name"],type:"object"},acceptsChildren:!0},FormCheckboxGroup:{description:"A Form-registered checkbox group for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial array of selected values when uncontrolled",items:{},type:"array"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},id:{description:"HTML id attribute for the checkbox group",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isHorizontal:{description:"Arrange options in a row",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the checkbox group",type:"string"},list:{description:"Array of {label, value} checkbox items",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this specific checkbox",type:"boolean"},label:{description:"Display text for the checkbox option",type:"string"},secondaryLabel:{description:"Secondary text below the option label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance style",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},label:{description:"Tag label text",type:"string"}},required:["label"],type:"object"}],description:"Optional tag/label displayed with the option"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when document scrolls. Default: false",type:"boolean"},isDelayed:{description:"Add delay before showing tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning relative to viewport. Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from state",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip content"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip content"},onlyIfChildOverflow:{description:"Only show tooltip if any child content overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if content overflows. Default: false",type:"boolean"},overwriteMiddleware:{description:"Overwrite default floating-UI middleware. Default: false",type:"boolean"},padding:{description:"CSS padding value for tooltip content",type:"string"},placement:{description:"Tooltip placement relative to the checkbox option",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"},shallSkipOverflowY:{description:"Skip overflow check on Y axis. Default: false",type:"boolean"},tipHideDelay:{description:"Milliseconds to wait before hiding tooltip when delayed",type:"number"},tipShowDelay:{description:"Milliseconds to wait before showing tooltip when delayed",type:"number"},title:{description:"Tooltip title text",type:"string"},truncateClassName:{description:"CSS class when onlyIfOverflow is enabled",type:"string"}},required:["content"],type:"object"}],description:"Tooltip shown on hover. Can be simple string text or a TipTypes object"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},theme:{description:"Theme styling: FLUID_WIDTH for full-width options, REVERSE for reversed theme",enum:["FLUID_WIDTH","REVERSE","FLUID_WIDTH_SPACE_BETWEEN_REVERSE"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Array of selected values bound to state ($bindState)",items:{},type:"array"},variant:{description:"Visual variant: BOX for boxed layout, LIST for list layout, GRID for grid layout",enum:["BOX","LIST","GRID"],type:"string"}},required:["name","list"],type:"object"},acceptsChildren:!1},FormContent:{description:"A Form layout helper that aligns non-input content to the same width and spacing rules as form fields.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{isFluid:{description:"Overrides whether content follows fluid form width. Defaults to the parent Form.",type:"boolean"}},type:"object"},acceptsChildren:!0},FormCurrency:{description:"A Form-registered currency field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},allowNegative:{description:"Whether negative values are allowed. Default: true",type:"boolean"},canSelectCurrencyType:{description:"If true, displays a dropdown to select currency type",type:"boolean"},currencyTypeProps:{additionalProperties:!1,description:"Nested Select props for the currency selector",properties:{name:{description:"Unique identifier for the currency selector",type:"string"},"aria-describedby":{description:"ID of element that describes the currency selector",type:"string"},"aria-label":{description:"Accessible label for the currency selector",type:"string"},"aria-labelledby":{description:"ID of element that labels the currency selector",type:"string"},canClear:{description:"Show clear button to deselect",type:"boolean"},defaultSearchQuery:{description:"Initial search input value",type:"string"},defaultValue:{description:"Initial selected currency code"},dropdownHeight:{description:"Dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query entered",type:"string"},onNoSearchResults:{description:"Placeholder when search returns no results",type:"string"}},type:"object"}],description:"Placeholder when dropdown list is empty"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options",propertyNames:{type:"string"},type:"object"},isDisabled:{description:"Disables the currency selector",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu opens by default",type:"boolean"},isPositionFixed:{description:"Position dropdown relative to viewport",type:"boolean"},isReadOnly:{description:"Makes the currency selector read-only",type:"boolean"},isRequired:{description:"Marks the currency selector as required",type:"boolean"},isSearchable:{description:"Enable type-to-search filtering",type:"boolean"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Dropdown max height"},placeholder:{description:"Placeholder text when empty",type:"string"},scrollThreshold:{description:"Extra virtual scroll render threshold",type:"number"},shouldFocusFirstElement:{description:"Auto-focus first menu item",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix",type:"boolean"},shouldUsePortal:{description:"Render dropdown in a React Portal",type:"boolean"},size:{description:"Select input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},value:{description:"Currently selected currency code"}},type:"object"},decimalPlaces:{description:"Number of decimal places allowed. Default: 2",type:"number"},defaultValue:{anyOf:[{type:"string"},{type:"number"},{type:"null"},{additionalProperties:!1,properties:{type:{description:"Currency code paired with the amount, e.g. USD or EUR",type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Currency amount value"}},required:["value","type"],type:"object"}],description:"Initial currency value set in Form on mount"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for number formatting (e.g. en-US). Overrides shouldLocalize when set.",type:"string"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Currency symbol or code shown as prefix. Default: USD",type:"string"},shouldSendCurrencyType:{description:"If true, onChange writes { value, type } using currencyTypeProps value/defaultValue",type:"boolean"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"number"},{type:"null"},{additionalProperties:!1,properties:{type:{description:"Currency code paired with the amount, e.g. USD or EUR",type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Currency amount value"}},required:["value","type"],type:"object"}],description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormDate:{description:"A Form-registered date picker for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},canClear:{description:"Show clear button",type:"boolean"},defaultValue:{anyOf:[{type:"string"},{type:"null"}],description:"Initial date value (yyyy-MM-dd) or null set in Form on mount"},format:{description:"Date display format. Default: MM/dd/yyyy",enum:["yyyy/MM/dd","yyyy-MM-dd","MM/dd/yyyy","dd/MM/yyyy","yyyy/MM/dd hh:mm a","yyyy-MM-dd hh:mm a","MM/dd/yyyy hh:mm a","dd/MM/yyyy hh:mm a","yyyy/MM/dd hh:mm:ss a","yyyy-MM-dd hh:mm:ss a","MM/dd/yyyy hh:mm:ss a","dd/MM/yyyy hh:mm:ss a","ISO_STRING"],type:"string"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},id:{description:"HTML id attribute for the input",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the date picker",type:"string"},locale:{description:"Locale for date formatting. Default: en-US",type:"string"},maxDate:{description:"Latest selectable date as ISO string",type:"string"},minDate:{description:"Earliest selectable date as ISO string",type:"string"},shouldLocalize:{description:"If true, display format will be determined from user locale setting. Default: false for explicit format control",type:"boolean"},shouldShowTime:{description:"Include time selection",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Visual theme variant. NO_BOX removes input box styling",enum:["NO_BOX"],type:"string"},timezone:{description:'Timezone name (e.g. "America/New_York"). Used with shouldShowTime',type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"null"}],description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormDateRange:{description:"A Form-registered date range picker for selecting start and end dates inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},alwaysShowTimezone:{description:"If true, timezone abbreviation will always be shown when shouldShowTime is true. Default: false",type:"boolean"},canClear:{description:"Show clear button",type:"boolean"},defaultValue:{anyOf:[{items:{anyOf:[{type:"string"},{type:"null"}]},type:"array"},{type:"null"}],description:"Initial date range value [start, end] or null set in Form on mount"},divider:{description:'Separator between date units (e.g. "/" or "-")',type:"string"},endDateLabel:{description:"Label for the end date field",type:"string"},format:{description:"Date display format. Default: MM/dd/yyyy",enum:["yyyy/MM/dd","yyyy-MM-dd","MM/dd/yyyy","dd/MM/yyyy","yyyy/MM/dd hh:mm a","yyyy-MM-dd hh:mm a","MM/dd/yyyy hh:mm a","dd/MM/yyyy hh:mm a","yyyy/MM/dd hh:mm:ss a","yyyy-MM-dd hh:mm:ss a","MM/dd/yyyy hh:mm:ss a","dd/MM/yyyy hh:mm:ss a","ISO_STRING"],type:"string"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},hideStepper:{description:"If true, arrow navigation key to increment/decrement date will be hidden. Default: false",type:"boolean"},id:{description:"HTML id attribute for the date range input",type:"string"},isCalendarDefaultOpen:{description:"If true, calendar will be open by default on mount",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isLarge:{description:"Renders large calendar when true. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the date range picker",type:"string"},locale:{description:"Locale for date formatting",type:"string"},maxDate:{description:"Latest selectable date as ISO string",type:"string"},minDate:{description:"Earliest selectable date as ISO string",type:"string"},shouldFormatInTimezone:{description:"If true, values will transform according to global timezone. Defaults to true when shouldShowTime is true",type:"boolean"},shouldLocalize:{description:"If true, display format is determined from user locale. Default: true",type:"boolean"},shouldShowTime:{description:"Include time selection",type:"boolean"},shouldShowTimezoneLabel:{description:"If false, timezone label will not be shown. Default: true",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},startDateLabel:{description:"Label for the start date field",type:"string"},theme:{description:"Visual theme variant. NO_BOX removes input box styling",enum:["NO_BOX"],type:"string"},timezone:{description:"Timezone for date/time display and storage. Used with shouldShowTime",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{items:{anyOf:[{type:"string"},{type:"null"}]},type:"array"},{type:"null"}],description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormDaySelector:{description:"A Form-registered day-of-week selector for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{anyOf:[{enum:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],type:"string"},{items:{enum:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],type:"string"},type:"array"}],description:"Initial day(s) when uncontrolled"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isMulti:{description:"Allow multiple day selection. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},renderProps:{additionalProperties:{additionalProperties:!1,properties:{isDisabled:{type:"boolean"},tip:{additionalProperties:!1,properties:{content:{type:"string"}},required:["content"],type:"object"}},type:"object"},description:"Per-day configuration. Keys are day names (Sunday, Monday, etc.). Each can have isDisabled (boolean) and tip (object with content string)",propertyNames:{type:"string"},type:"object"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormEmail:{description:"A Form-registered email field with built-in email validation, for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"null"}],description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormEmployeeSearch:{description:"Search for and select one or more employees as a registered form field. Supports ACTIVE; GOOD (HIRED, ACCEPTED, and ACTIVE); ACCEPTED_AND_ACTIVE (excluding HIRED); NON_INIT (all employee states except INIT, including TERMINATED); INIT (hiring started but not completed; the backend preset is roleState INIT and is not employee-constrained); and TERMINATED. The change event is notification-only and has no payload.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Non-empty field name used to register this employee role-id value with the parent form.",minLength:1,type:"string"},canClear:{description:"Controls whether the current selection can be cleared. When omitted, the underlying select default applies.",type:"boolean"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Initial uncontrolled selection as an employee role id for single select or role id array for multi-select. Defaults to no selection."},isDisabled:{description:"When true, disables searching and selection changes. Defaults to false.",type:"boolean"},isMulti:{description:"When true, allows multiple employee selections and uses role id arrays. Defaults to false (single select).",type:"boolean"},isReadOnly:{description:"When true, displays the selection without allowing changes. Defaults to false.",type:"boolean"},isRequired:{description:"When true, marks the field as required. Defaults to the form control default (not required).",type:"boolean"},label:{description:"Label displayed for the search field. Defaults to no label.",type:"string"},placeholder:{description:"Placeholder displayed when the search field is empty. When omitted, the component default placeholder is used.",type:"string"},roleIdsToExclude:{description:"Removes the specified employee role ids from search results when no inclusion list is provided. When both lists are provided, inclusion takes precedence. When omitted, no role ids are explicitly excluded.",items:{type:"string"},type:"array"},roleIdsToInclude:{description:"Limits search results to the specified employee role ids. When both inclusion and exclusion lists are provided, inclusion takes precedence. When omitted, results are not restricted by an inclusion list.",items:{type:"string"},type:"array"},roleTypes:{description:"Limits search results using backend role-type presets. ACTIVE selects active employees. GOOD selects HIRED, ACCEPTED, and ACTIVE employees. ACCEPTED_AND_ACTIVE selects ACCEPTED and ACTIVE employees and excludes HIRED. NON_INIT selects all employee states except INIT, including TERMINATED. INIT selects the backend roleState INIT preset (hiring started but not completed) and is not additionally constrained to employees. TERMINATED selects terminated employees. Requires at least one value; defaults to GOOD.",items:{enum:["ACTIVE","GOOD","ACCEPTED_AND_ACTIVE","NON_INIT","INIT","TERMINATED"],type:"string"},minItems:1,type:"array"},tip:{description:"Supplementary tip displayed with the label. Defaults to no tip.",type:"string"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Controlled selection as an employee role id for single select or role id array for multi-select. When omitted, the component is uncontrolled. When value and defaultValue are both provided, value takes precedence."}},required:["name"],type:"object"},acceptsChildren:!1},FormFile:{description:"A Form-registered file upload field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},allowCameraCapture:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{quality:{description:"Captured image quality",type:"number"}},type:"object"}],description:"Allow camera capture for image files; object form supports quality"},cropperConfig:{additionalProperties:!1,description:"Cropper configuration",properties:{aspectRatio:{description:"Aspect ratio for cropper. Default: 1:1",enum:["16:9","4:3","1:1"],type:"string"},enforceAspectRatio:{description:"Enforce the aspect ratio on cropper. Default: true",type:"boolean"},showUploadButton:{description:"Show upload button on cropper. Default: true",type:"boolean"},title:{description:"Title for the cropper modal",type:"string"}},type:"object"},defaultValue:{description:"Default files to show when no value is provided",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},isMultipart:{description:"Whether this is a multipart upload",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},size:{description:"File size in bytes",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"},enableCropper:{description:"Enable image cropping for selected images",type:"boolean"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},icon:{description:"Icon name from Icon.TYPES to show above placeholder",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the file drop area",type:"string"},maxFileSize:{description:"Max file size in MB per attachment",type:"number"},maxTotalFileSize:{description:"Max total size in MB for all attachments",type:"number"},multiple:{description:"Allow selecting multiple files",type:"boolean"},placeholder:{description:"Text shown when no files are selected",type:"string"},showProgress:{description:"Show upload progress bar. Default: false",type:"boolean"},supportTypes:{description:'Supported file extensions with dot prefix, e.g. [".pdf", ".png", ".jpg"]. Do NOT use MIME types.',items:{type:"string"},type:"array"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},type:{description:"File input display type. Default: DEFAULT",enum:["DEFAULT","RECEIPT"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Array of file objects bound to state",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},isMultipart:{description:"Whether this is a multipart upload",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},size:{description:"File size in bytes",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"}},required:["name"],type:"object"},acceptsChildren:!1},FormFileDrop:{description:"A Form-registered file upload field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},allowCameraCapture:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{quality:{description:"Captured image quality",type:"number"}},type:"object"}],description:"Allow camera capture for image files; object form supports quality"},cropperConfig:{additionalProperties:!1,description:"Cropper configuration",properties:{aspectRatio:{description:"Aspect ratio for cropper. Default: 1:1",enum:["16:9","4:3","1:1"],type:"string"},enforceAspectRatio:{description:"Enforce the aspect ratio on cropper. Default: true",type:"boolean"},showUploadButton:{description:"Show upload button on cropper. Default: true",type:"boolean"},title:{description:"Title for the cropper modal",type:"string"}},type:"object"},defaultValue:{description:"Default files to show when no value is provided",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"},enableCropper:{description:"Enable image cropping for selected images",type:"boolean"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},icon:{description:"Icon name from Icon.TYPES to show above placeholder",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the file drop area",type:"string"},maxFiles:{description:"Max number of files allowed in total",exclusiveMinimum:0,maximum:9007199254740991,type:"integer"},maxFileSize:{description:"Max file size in MB per attachment",type:"number"},maxTotalFileSize:{description:"Max total size in MB for all attachments",type:"number"},metadata:{description:"JSON-serializable metadata sent with upload requests"},multiPartUpload:{description:"Enables multipart upload flow for files larger than 100MB",type:"boolean"},multiple:{description:"Allow selecting multiple files",type:"boolean"},placeholder:{description:"Text shown when no files are selected",type:"string"},supportTypes:{description:'Supported file extensions with dot prefix, e.g. [".pdf", ".png", ".jpg"]. Do NOT use MIME types.',items:{type:"string"},type:"array"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},type:{description:"Type of file drop: upload (shows progress bars automatically) or content. Default: content",enum:["upload","content"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Array of file objects bound to state",items:{additionalProperties:!1,properties:{name:{description:"File name",type:"string"},content:{description:"File content as a base64 data URL",type:"string"},hasError:{description:"Whether the file has an error",type:"boolean"},previewUrl:{description:"Preview URL for the file",type:"string"},progress:{description:"Upload progress 0-100",type:"number"},tooltipText:{description:"Tooltip text shown on error",type:"string"},type:{description:"MIME type of the file",type:"string"},url:{description:"URL of the uploaded file",type:"string"}},type:"object"},type:"array"}},required:["name"],type:"object"},acceptsChildren:!1},FormGroup:{description:"A Form subsection container with an optional title, caption, and tooltip for grouping related fields.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{caption:{description:"Supporting text shown below the group title",type:"string"},tip:{description:"Tooltip text shown beside the group title",type:"string"},title:{description:"Group heading text",type:"string"}},type:"object"},acceptsChildren:!0},FormGroupHeader:{description:"Deprecated Form group header primitive. Prefer FormGroup for new specs because it owns both header and grouped children.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{caption:{description:"Supporting text shown below the group title",type:"string"},tip:{description:"Tooltip text shown beside the group title",type:"string"},title:{description:"Group heading text",type:"string"}},type:"object"},acceptsChildren:!1},FormHidden:{description:"A Form-registered hidden field for use inside a Form. Renders no UI — use to inject computed values into the Form submit payload.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial value to register with Form on mount"}},required:["name"],type:"object"},acceptsChildren:!1},FormInlineGroup:{description:"A Form layout helper that arranges two or three child fields side by side in a single row.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{customChildWidths:{description:"Per-child widths. Must match child count and sum to 100%.",items:{description:'Percentage width string, e.g. "50%" or "33.3%"',pattern:"^\\d+(\\.\\d+)?%$",type:"string"},type:"array"},tip:{description:"Tooltip text shown beside the group label",type:"string"},title:{description:"Inline group label text",type:"string"}},type:"object"},acceptsChildren:!0},FormInputGroup:{description:"A Form-registered grouped input layout that combines one main input with optional prefix and suffix inputs.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial value for the main input on mount"},hasSeparateFormControls:{description:"When true, prefix and suffix input configurations are rendered as separate Form fields inside the group",type:"boolean"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},input:{additionalProperties:!1,description:"Main input configuration with type and inputProps",properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},isDisabled:{description:"Disables all inputs in the group",type:"boolean"},isReadOnly:{description:"Makes all inputs in the group read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text shown by the Form field wrapper",type:"string"},prefix:{anyOf:[{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},{items:{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},type:"array"}],description:"Prefix input configuration(s) prepended to the main input"},prefixMaxWidthPercent:{description:"Max width percentage for the prefix container",type:"number"},prefixMinWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum width for the prefix container"},shouldHideAddons:{description:"Hides prefix/suffix without destroying them",type:"boolean"},size:{description:"Size of all inputs in the group. Default: M",enum:["XS","S","M","L"],type:"string"},suffix:{anyOf:[{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},{items:{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},type:"array"}],description:"Suffix input configuration(s) appended to the main input"},suffixMaxWidthPercent:{description:"Max width percentage for the suffix container",type:"number"},suffixMinWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum width for the suffix container"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name","input"],type:"object"},acceptsChildren:!1},FormMasker:{description:"A Form-registered masked text input for values with a fixed format.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},"aria-label":{description:"Accessible label when no visible label",type:"string"},autoComplete:{description:"Browser autocomplete hint. Default: off",type:"string"},autoFocus:{description:"Auto-focus input on mount",type:"boolean"},defaultValue:{description:"Initial masked value set in Form on mount",type:"string"},fixedCharsPrefix:{description:"Fixes characters at the beginning of the value",type:"string"},fixedCharsSuffix:{description:"Fixes characters at the end of the value",type:"string"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},id:{description:"Explicit HTML element id",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isSensitive:{description:"Marks input as sensitive for privacy/security",type:"boolean"},label:{description:"Label text above the input",type:"string"},mask:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:'Mask pattern. Use 9 for digit, a for letter, * for any character. Can be string ("999-999-9999") or array of patterns (["99.9a-999", "99.99/99-9"]) for multi-mask support'},maxLength:{description:"Maximum character length",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character length",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},shouldEnforceUpperCase:{description:"Enforces uppercase on input characters",type:"boolean"},shouldSkipInitialFormatting:{description:"If true, skip applying mask on the default/initial value",type:"boolean"},shouldUnmaskValue:{description:"If true, onChange passes the unmasked value (without mask characters)",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name","mask"],type:"object"},acceptsChildren:!1},FormNumber:{description:"A Form-registered numeric field for use inside a Form component.",events:["change","blur","changeRaw","changeCalculationState"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoComplete:{description:'Browser autocomplete hint. Default: "off"',type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},decimalPlaces:{description:"Number of decimal places. Default: 2",type:"number"},defaultValue:{anyOf:[{type:"string"},{type:"number"}],description:"Initial default value for uncontrolled usage"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isIntegerOnly:{description:"Restrict to integer values only",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:'Locale string for number formatting (e.g. "en-US", "de-DE")',type:"string"},max:{description:"Maximum allowed value",type:"number"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},min:{description:"Minimum allowed value. Default: 0",type:"number"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text prefix inside the input",type:"string"},shouldAllowCalculation:{description:"If true, input allows arithmetic operators and evaluates on blur",type:"boolean"},shouldDisableFormatting:{description:"If true, number formatting will not be applied. Default: true",type:"boolean"},shouldDisableRedundantZeroFormatting:{description:"If true, redundant zeros are preserved. Default: true",type:"boolean"},shouldStripLeadingZeros:{description:"If true, leading zeros are stripped from the numeric value",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},step:{description:"Increment/decrement step size. Default: 1",type:"number"},stringPadding:{additionalProperties:!1,description:"Adds padding characters to the input value",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Position to pad (start or end)",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text suffix inside the input",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormPassword:{description:"A Form-registered password field with show/hide toggle, for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},shouldAllowReveal:{description:"Show password reveal toggle. Default: true",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormPercentage:{description:"A Form-registered percentage field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},allowNegative:{description:"Whether negative values are allowed. Default: false",type:"boolean"},decimalPlaces:{description:"Number of decimal places allowed. Default: 2",type:"number"},defaultValue:{description:"Default percentage value when uncontrolled",type:"number"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for percentage formatting (e.g. en-US)",type:"string"},lowerLimit:{description:"Minimum allowed percentage value",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},shouldDisableFormatting:{description:"If true, percentage formatting will not be applied",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},step:{description:"Increment/decrement step size. Default: 1",type:"number"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},upperLimit:{description:"Maximum allowed percentage value. Default: 100",type:"number"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormPhone:{description:"A Form-registered phone number field with region-based formatting, for use inside a Form component.",events:["change","blur","countryCodeChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoComplete:{description:'Browser autocomplete hint, e.g. "tel"',type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},countryCode:{anyOf:[{description:'Fixed country code prefix as a string, e.g. "91" or "1"',type:"string"},{additionalProperties:!1,description:"Country-code dropdown configuration preserving the serializable CountryCodeProp shape",properties:{name:{description:"Name for the country-code select input",type:"string"},"aria-describedby":{description:"ID of the element that describes the country-code dropdown",type:"string"},"aria-label":{description:"Accessible label for the country-code dropdown",type:"string"},"aria-labelledby":{description:"ID of the element that labels the country-code dropdown",type:"string"},canClear:{description:"Show clear button in the country-code dropdown",type:"boolean"},defaultSearchQuery:{description:"Initial search query for the country-code dropdown",type:"string"},defaultValue:{description:"Initial selected country code for the dropdown branch",type:"string"},dropdownHeight:{description:"Country-code dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while the dropdown list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query is entered",type:"string"},onNoSearchResults:{description:"Placeholder shown when no matching regions are found",type:"string"}},type:"object"}],description:"Placeholder shown when the country-code dropdown list is empty"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for the country-code dropdown",propertyNames:{type:"string"},type:"object"},id:{description:"HTML id attribute for the country-code select input",type:"string"},isDisabled:{description:"Disables the country-code dropdown",type:"boolean"},isMenuDefaultOpen:{description:"If true, the country-code dropdown opens by default",type:"boolean"},isPositionFixed:{description:"Position the country-code dropdown relative to the viewport",type:"boolean"},isReadOnly:{description:"Makes the country-code dropdown read-only",type:"boolean"},isRequired:{description:"Marks the country-code dropdown as required",type:"boolean"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Maximum dropdown height or chip container height as a CSS value"},placement:{description:"Country-code dropdown placement. Default: bottom-start",enum:["auto","auto-start","auto-end","top","top-start","top-end","bottom","bottom-start","bottom-end","right","right-start","right-end","left","left-start","left-end"],type:"string"},rows:{description:"Minimum row count for the country-code dropdown",type:"number"},scrollThreshold:{description:"Extra pixels rendered above and below the viewport in paginated mode",type:"number"},shouldFocusFirstElement:{description:"Auto-focus the first dropdown item when the menu opens",type:"boolean"},shouldShowSearchIcon:{description:"Show the search icon inside the country-code dropdown",type:"boolean"},shouldUsePortal:{description:"Render the country-code dropdown in a React portal",type:"boolean"},size:{description:"Country-code dropdown size. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Country-code dropdown theme variant",enum:["TRANSPARENT_BORDER","TOP_NAV","INLINE_TRANSPARENT_BORDER","INLINE_TOP_NAV","NO_PADDING_RIGHT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_RIGHT_NO_BOX_TOP_NAV","NO_PADDING_LEFT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_LEFT_NO_BOX_TOP_NAV"],type:"string"},value:{anyOf:[{type:"string"},{type:"null"}],description:"Controlled selected country code for the dropdown branch"}},type:"object"}],description:"Either a fixed country code string or a country-code dropdown configuration object"},countryCodeDefaultValue:{description:"[Deprecated] Use countryCode.defaultValue instead. Initial selected country code for the legacy dropdown shape",type:"string"},countryCodeValue:{description:"[Deprecated] Use countryCode.value instead. Bound selected country code for the legacy dropdown shape",type:"string"},defaultRegion:{description:'Default country region code for formatting, e.g. "US", "IN", "CA". Default: US',type:"string"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isCountryCodeDisabled:{description:"[Deprecated] Use countryCode.isDisabled instead for the legacy dropdown shape",type:"boolean"},isCountryCodeReadOnly:{description:"[Deprecated] Use countryCode.isReadOnly instead for the legacy dropdown shape",type:"boolean"},isCountryCodeRequired:{description:"[Deprecated] Use countryCode.isRequired instead for the legacy dropdown shape",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormRadio:{description:"A Form-registered radio group for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial value when uncontrolled"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isHorizontal:{description:"Arrange options in a row",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the radio group",type:"string"},list:{description:"Array of {label, value} radio options",items:{additionalProperties:!1,properties:{isActive:{description:"Controls focus state of the option",type:"boolean"},isDisabled:{description:"Disables this specific option",type:"boolean"},label:{description:"Display text for the option",type:"string"},secondaryLabel:{description:"Secondary text below the option label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance style",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},label:{description:"Tag label text",type:"string"}},required:["label"],type:"object"}],description:"Optional tag/label displayed with the option"},tip:{description:"Tooltip text shown on hover",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},theme:{description:"Theme styling: FLUID_WIDTH for full-width options, REVERSE for reversed theme",enum:["FLUID_WIDTH","REVERSE","FLUID_WIDTH_SPACE_BETWEEN_REVERSE"],type:"string"},tip:{description:"Tooltip text shown alongside the label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"},variant:{description:"Visual variant: BOX for boxed layout, LIST for list layout, GRID for grid layout",enum:["BOX","LIST","GRID"],type:"string"}},required:["name","list"],type:"object"},acceptsChildren:!1},FormRecordLookup:{description:"Searches and selects a record from a searchable model, such as custom objects, Employee, Department, Team, Work Location, Computer, Job Requisition, or Applicant, as a registered form field.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Non-empty field name used to register the lookup with the parent form.",minLength:1,type:"string"},canClear:{description:"Controls whether the value can be cleared.",type:"boolean"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Initial uncontrolled record id, or record id array when isMulti is true."},isDisabled:{description:"Disables searching and selection changes.",type:"boolean"},isMenuDefaultOpen:{description:"Opens the menu when the field mounts.",type:"boolean"},isMulti:{description:"Allows selecting multiple records.",type:"boolean"},isReadOnly:{description:"Displays the value without allowing changes.",type:"boolean"},isRequired:{description:"Marks the field required in its parent form.",type:"boolean"},label:{description:"Label displayed above the lookup.",type:"string"},objectApiName:{description:"RQL API name of the model whose records can be searched. The backend rejects models that are not lookup-supported or that the viewer cannot access.",minLength:1,type:"string"},placeholder:{description:"Search input placeholder.",type:"string"},shouldShowSearchIcon:{description:"Controls whether the search icon is shown.",type:"boolean"},tip:{description:"Supplementary text displayed with the label.",type:"string"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Controlled record id, or record id array when isMulti is true."}},required:["objectApiName","name"],type:"object"},acceptsChildren:!1},FormSegmentedControl:{description:"A Form-registered segmented control for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},appearance:{description:"Visual style variant. Default: PRIMARY",enum:["PRIMARY","POSITIVE","NEGATIVE","NEUTRAL"],type:"string"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Initial value when uncontrolled"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isFluid:{description:"Stretches control to fill container width",type:"boolean"},isMulti:{description:"Allows selecting multiple options",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isVertical:{description:"Renders options in a vertical layout",type:"boolean"},label:{description:"Label text above the segmented control",type:"string"},list:{description:"Array of { label, value } segmented control options",items:{additionalProperties:!1,properties:{appearance:{description:"Visual style for this specific option",enum:["PRIMARY","POSITIVE","NEGATIVE","NEUTRAL"],type:"string"},"aria-label":{description:"Accessible label, required if label is not provided (e.g. for icon-only items)",type:"string"},icon:{description:"Icon to display for icon-only items. Requires aria-label or label for accessibility",type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},label:{description:"Display text for the option",type:"string"},tip:{additionalProperties:!1,description:"Tooltip to show on hover for this option",properties:{content:{description:"Tooltip text content",type:"string"}},required:["content"],type:"object"},value:{description:"Value stored when option is selected",type:"string"}},required:["value"],type:"object"},type:"array"},rangeLabels:{additionalProperties:!1,description:"Labels to display at the start and end of the control range",properties:{end:{description:"Label at the end of the range",type:"string"},start:{description:"Label at the start of the range",type:"string"}},required:["start","end"],type:"object"},size:{description:"Control size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormSelect:{description:"A Form-registered dropdown select for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},canClear:{description:"Show clear button to deselect all",type:"boolean"},canSelectAll:{description:"Show select-all toggle. Requires isMulti to be true",type:"boolean"},creatable:{description:"Allow creating new options not in the list",type:"boolean"},defaultSearchQuery:{description:"Initial search input value",type:"string"},defaultValue:{anyOf:[{items:{},type:"array"},{}],description:"Initial selected value or values when uncontrolled"},dropdownHeight:{description:"Sets dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query entered",type:"string"},onNoSearchResults:{description:"Placeholder when search returns no results",type:"string"}},type:"object"}],description:"Placeholder when dropdown list is empty. Can be string or object with state-specific placeholders"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing fuzzy search behavior",propertyNames:{type:"string"},type:"object"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu will be open by default",type:"boolean"},isMulti:{description:"Allow multiple selections",type:"boolean"},isPositionFixed:{description:"Position dropdown relative to viewport instead of parent",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isSearchable:{description:"Enable type-to-search filtering",type:"boolean"},label:{description:"Label text above the select",type:"string"},list:{anyOf:[{items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},{items:{additionalProperties:!1,properties:{isNestedMenu:{description:"Render the group as a nested submenu",type:"boolean"},label:{description:"Group label shown above its options",type:"string"},list:{description:"Options contained in this group",items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"}},required:["label","list"],type:"object"},type:"array"}],description:"Flat array of {label, value} options, or nested array of {label, list} groups for grouped/submenu options"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Max height of multi-select container (CSS value)"},maxTruncationLines:{description:'Max rows of chips visible before "+X" overflow chip appears (multi-select only)',type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},placement:{description:"Dropdown position relative to input. Default: bottom-start",enum:["auto","auto-start","auto-end","top","top-start","top-end","bottom","bottom-start","bottom-end","right","right-start","right-end","left","left-start","left-end"],type:"string"},shouldFocusFirstElement:{description:"Auto-focus first menu item when dropdown opens",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix when isSearchable is true",type:"boolean"},shouldUsePortal:{description:"Render dropdown in a React Portal. Default: false",type:"boolean"},size:{description:"Select input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormSelectableGroup:{description:"A Form-registered card-based selection group for single or multi-choice choices inside a Form.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},"aria-describedby":{description:"ID of element that describes this input for screen readers",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input for screen readers",type:"string"},defaultValue:{anyOf:[{type:"string"},{type:"number"},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Initial selection when uncontrolled"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},id:{description:"Unique DOM id for the input element",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isMulti:{description:"Allow multiple selection. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Array of item objects to render as selectable cards",items:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},type:"array"},renderer:{description:"JSON-only constrained renderer choice: BASIC_CARD or LOCATION_CARD",enum:["BASIC_CARD","LOCATION_CARD"],type:"string"},testId:{description:"Deprecated testing-only prop kept for backward compatibility",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"number"},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Current value bound to state"},valueIdentifier:{description:'Key name to extract unique value from each list item. Default: "value"',type:"string"}},required:["name","list","renderer"],type:"object"},acceptsChildren:!1},FormSignature:{description:"A Form-registered signature capture input for drawing or typing a signature inside a Form.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},defaultValue:{description:"Initial default signature value",type:"string"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},id:{description:"Unique DOM element ID",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isTypeSignatureDisabled:{description:"Only show draw input, hide type input. Default: false",type:"boolean"},label:{description:"Label text above the input",type:"string"},penColor:{description:"Pen color token for drawing",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},placeholder:{description:"Placeholder text for the drawing area",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},typePlaceholder:{description:"Placeholder text for the type signature input",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormSin:{description:"A Form-registered SIN (Social Insurance Number) masked field for use inside a Form. Applies the Canadian SIN format mask (999 999 999) automatically.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial masked value set in Form on mount",type:"string"},fixedCharsPrefix:{description:"Fixes characters at the beginning of the value",type:"string"},fixedCharsSuffix:{description:"Fixes characters at the end of the value",type:"string"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},placeholder:{description:'Placeholder text. Default: "XXX XXX XXX"',type:"string"},shouldEnforceUpperCase:{description:"Enforces uppercase on input characters",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormSlider:{description:"A Form-registered slider for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},appearance:{description:"Sets slider appearance. Default: PRIMARY",enum:["PRIMARY","ERROR","SUCCESS","WARNING"],type:"string"},defaultValue:{description:"Initial value when uncontrolled. Default: 0",type:"number"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},hideTooltip:{description:"Hide the value tooltip. Default: false",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isDotsVisible:{description:"If true renders slider with dots. Default: true",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the slider",type:"string"},marks:{additionalProperties:{type:"string"},description:"Named marks on the slider track. Keys are numeric positions, values are labels",propertyNames:{type:"string"},type:"object"},max:{description:"Maximum value. Default: 100",type:"number"},min:{description:"Minimum value. Default: 0",type:"number"},shouldShowMarker:{description:"Controls visibility of marker. Default: true",type:"boolean"},step:{anyOf:[{type:"number"},{type:"null"}],description:"Step size. Set to null to use marks as steps. Default: 1"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name"],type:"object"},acceptsChildren:!1},FormSsn:{description:"A Form-registered SSN (Social Security Number) masked field for use inside a Form. Applies the US SSN format mask (999-99-9999) automatically.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial masked value set in Form on mount",type:"string"},fixedCharsPrefix:{description:"Fixes characters at the beginning of the value",type:"string"},fixedCharsSuffix:{description:"Fixes characters at the end of the value",type:"string"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},placeholder:{description:'Placeholder text. Default: "XXX-XX-XXXX"',type:"string"},shouldEnforceUpperCase:{description:"Enforces uppercase on input characters",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormSurvey:{description:"A Form-registered survey/rating input for collecting a bounded opinion or score inside a Form.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},caption:{description:"Caption text displayed below the survey",type:"string"},defaultValue:{anyOf:[{anyOf:[{type:"string"},{type:"number"}]},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Initial selected value(s) set on mount"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isMulti:{description:"Allow multiple selections. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isVertical:{description:"Stack options vertically. Default: false",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Array of survey option items with label and value",items:{additionalProperties:!1,properties:{icon:{description:"Pebble icon name displayed for the option",type:"string"},isDisabled:{description:"Disable this specific option",type:"boolean"},label:{anyOf:[{type:"string"},{type:"number"}],description:"Display label for the option"},selectionColor:{description:"Override selected surface color token for this option",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Value when selected"}},required:["value"],type:"object"},type:"array"},rangeLabels:{additionalProperties:!1,description:"Labels for lowest and highest options",properties:{lower:{description:"Label for the lowest option",type:"string"},upper:{description:"Label for the highest option",type:"string"}},required:["lower","upper"],type:"object"},theme:{description:"Survey theme. TWO_LINE stacks label below value",enum:["TWO_LINE"],type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{anyOf:[{type:"string"},{type:"number"}]},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Current value bound to state"}},required:["name","list"],type:"object"},acceptsChildren:!1},FormSwitch:{description:"A Form-registered toggle switch for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},compact:{description:"Use compact size variant",type:"boolean"},defaultValue:{description:"Initial toggle state when uncontrolled",type:"boolean"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Field-level label shown above the switch",type:"string"},offLabel:{description:"Label text when switch is off",type:"string"},onLabel:{description:"Label text when switch is on",type:"string"},rightAlign:{description:"Align switch to the right",type:"boolean"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip theme. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when the document is scrolled. Default: false",type:"boolean"},isDelayed:{description:"Add delay before showing/hiding the tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning for the tooltip. Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from parent. Overrides hover behavior when set",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Max height of tooltip content. Number in px or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Max width of tooltip. Number in px or CSS string. Default: 360"},onlyIfChildOverflow:{description:"Only show tooltip if a child element overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if the trigger element overflows. Default: false",type:"boolean"},placement:{description:"Tooltip position relative to child. Default: bottom",enum:["top","top-start","top-end","bottom","bottom-start","bottom-end","left","left-start","left-end","right","right-start","right-end"],type:"string"},tipHideDelay:{description:"Custom delay in ms before tooltip hides",type:"number"},tipShowDelay:{description:"Custom delay in ms before tooltip appears",type:"number"},title:{description:"Optional bold title above tooltip content",type:"string"}},required:["content"],type:"object"}],description:"Tooltip text or serializable tip config shown alongside the switch labels"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"boolean"}},required:["name"],type:"object"},acceptsChildren:!1},FormText:{description:"A Form-registered text field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},canClear:{description:"Show clear button",type:"boolean"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormTextarea:{description:"A Form-registered multi-line textarea for use inside a Form component.",events:["change","blur","focus"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},hasCharsLimit:{description:"Show character count indicator. Requires maxLength to be set",type:"boolean"},height:{description:"Fixed height in pixels",type:"number"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxHeight:{description:"Maximum height in pixels",type:"number"},maxLength:{description:"Maximum character count. Default: 10000",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},rows:{description:"Number of visible text rows",type:"number"},theme:{description:"Visual theme variant",enum:["NO_BOX"],type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormTextAutoSuggest:{description:"A Form-registered text field with auto-suggest dropdown for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},defaultValue:{description:"Initial value set in Form on mount",type:"string"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing suggestion filtering",propertyNames:{type:"string"},type:"object"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isPositionFixed:{description:"Use fixed positioning for dropdown menu. Useful in scrollable containers",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Flat suggestion list matching the React `list` item shape",items:{additionalProperties:{},properties:{isDisabled:{description:"Disables selection for this suggestion item",type:"boolean"},label:{description:"Display text shown for the suggestion item",type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Value written when the suggestion is selected"}},type:"object"},type:"array"},maxLength:{description:"Maximum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},shouldShowMenuOnFocus:{description:"Show dropdown menu on input focus. Default: false",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix. Default: false",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Current value bound to state"}},required:["name","list"],type:"object"},acceptsChildren:!1},FormTime:{description:"A Form-registered time picker field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},alwaysShowTimezone:{description:"If true, timezone abbreviation will always be shown. Default: false",type:"boolean"},defaultSelectionStartTime:{description:'Time to start the selection scroll from when shouldAllowTimeSelection is true (e.g. "08:00 AM")',type:"string"},defaultValue:{description:'Initial value — ISO 8601 or "HH:MM AM/PM" time string',type:"string"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDateTimeInline:{description:"Make input inline, removes border, padding and width fits input/placeholder content",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for time formatting (e.g. en-US)",type:"string"},maxWidth:{description:"Maximum width CSS value",type:"string"},pickClosestMeridiem:{description:"When user does not enter AM/PM, pick the closest meridiem to the inputted hour value. Default: false",type:"boolean"},referenceDate:{description:"ISO date string used as reference for timezone calculations and DST determination. Defaults to current date.",type:"string"},shouldAllowTimeSelection:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{reference:{description:"Reference ISO time for period labels",type:"string"}},type:"object"}],description:"Show a time selection dropdown for picking times"},shouldDisplaySeconds:{description:"Display seconds in the time input",type:"boolean"},shouldFormatInTimezone:{description:"If true, values will transform according to global timezone when timezone prop is not passed explicitly",type:"boolean"},shouldLocalize:{description:"If true, display format will be determined from user locale setting",type:"boolean"},shouldReturnISO:{description:"Always return value in ISO 8601 format",type:"boolean"},shouldShowTimezoneLabel:{description:"If false, timezone label will not be shown. Default: true",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},timezone:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{name:{description:"Input name for the timezone selector",type:"string"},isRequired:{description:"Marks the timezone selector as required",type:"boolean"},value:{description:"Selected timezone value",type:"string"}},required:["name"],type:"object"}],description:"Show time relative to this timezone or configure the timezone selector"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormTimezone:{description:"A Form-registered timezone selector for choosing an IANA timezone inside a Form.",events:["change","blur","focus"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},canClear:{description:"Shows a clear button to reset selection",type:"boolean"},defaultValue:{description:"Initial IANA timezone identifier",type:"string"},displayIANA:{description:"Display IANA timezone name. Default: true",type:"boolean"},displayShortFormat:{description:"Display timezone abbreviation",type:"boolean"},dropdownHeight:{description:"Height of the dropdown menu in pixels",type:"number"},emptyListPlaceholder:{description:"Placeholder text shown when no timezone matches the search",type:"string"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isMenuDefaultOpen:{description:"If true, the dropdown menu will be open by default on mount",type:"boolean"},isPositionFixed:{description:"Use fixed positioning for dropdown (useful in scrollable containers)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isSearchable:{description:"Enables search filtering. Default: true",type:"boolean"},label:{description:"Label text above the input",type:"string"},placeholder:{description:"Placeholder text when empty",type:"string"},placement:{description:"Dropdown placement position. Default: BOTTOM_START",enum:["TOP_START","TOP","TOP_END","RIGHT_START","RIGHT","RIGHT_END","BOTTOM_END","BOTTOM","BOTTOM_START","LEFT_END","LEFT","LEFT_START"],type:"string"},referenceDate:{description:"ISO 8601 date string to determine timezone offsets (e.g. 2024-01-15T12:00:00Z)",type:"string"},shouldShowSearchIcon:{description:"If true, shows a search icon in the dropdown",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Visual theme variant for the input",enum:["TRANSPARENT_BORDER","TOP_NAV","INLINE_TRANSPARENT_BORDER","INLINE_TOP_NAV","NO_PADDING_RIGHT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_RIGHT_NO_BOX_TOP_NAV","NO_PADDING_LEFT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_LEFT_NO_BOX_TOP_NAV"],type:"string"},tip:{description:"Tooltip text shown alongside the field label",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},FormTree:{description:"A Form-registered tree selection field for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},canSelectAll:{description:"Show select all toggle in multi mode",type:"boolean"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"},{type:"null"}],description:"Initial selection set in Form on mount"},dropdownWidth:{description:"Override internal dropdown width in pixels",type:"number"},emptyListPlaceholder:{description:"Placeholder text when list is empty",type:"string"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing search behavior",propertyNames:{type:"string"},type:"object"},hasIndependentActions:{description:"In multiSelect, action on an item does not affect selection of parent or child items",type:"boolean"},hasIndependentChildActions:{description:"Actions on child in multi select do not affect selection of ancestors",type:"boolean"},hasStaticParentNodes:{description:"Makes parent nodes non-actionable (only manage hierarchy)",type:"boolean"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isMulti:{description:"Allow multiple selection. Default: false",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},isSearchable:{description:"Enable search filtering. Default: true",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Flat array of tree items with parent references. Root items have parent: null, children reference parent value",items:{additionalProperties:!1,properties:{disabledInfo:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{description:"Tooltip content text",type:"string"},isMobileSupported:{description:"Show tooltip on mobile devices",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum tooltip height"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum tooltip width"}},required:["content"],type:"object"}],description:"Tooltip shown when item is disabled"},isDisabled:{description:"Disable this item",type:"boolean"},isLeaf:{description:"Marks the item as a leaf node",type:"boolean"},label:{description:"Display label for the item",type:"string"},parent:{anyOf:[{type:"string"},{type:"null"}],description:"Parent item value, null for root items"},secondaryLabel:{description:"Supporting text below the label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:'Label appearance (e.g., "primary", "error", "success")',type:"string"},text:{description:"Tag text to display",type:"string"}},required:["text"],type:"object"}],description:"Chip/tag to display next to the label"},value:{description:"Unique identifier for the item",type:"string"}},required:["label","value"],type:"object"},type:"array"},maxHeight:{description:"Maximum height of the tree list in pixels",type:"number"},selectionCount:{description:"Show count of selected items in multi-select mode",type:"boolean"},shouldExpandNodeOnSelection:{description:"Auto-expand node when selected. Default: false",type:"boolean"},shouldShowFolderStructure:{description:"Renders folder structure for tree items",type:"boolean"},size:{description:"Input size. Options: XS, S, M, L. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Tree theme for styling variants",enum:["NO_BORDER","NO_PADDING","REVERSE","NO_BOX"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name","list"],type:"object"},acceptsChildren:!1},FormTreeSelect:{description:"A Form-registered tree-select dropdown field for use inside a Form component.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},canSelectAll:{description:"Show select all toggle in multi mode",type:"boolean"},defaultSearchQuery:{description:"Default search input value",type:"string"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"},{type:"null"}],description:"Initial value set. Single string when isMulti is false, array when true"},dropdownWidth:{description:"Custom dropdown width in pixels",type:"number"},emptyListPlaceholder:{description:"Placeholder shown when list is empty",type:"string"},fuseOptions:{additionalProperties:{},description:'Fuse.js search configuration. Default: { keys: ["label", "name"] }',propertyNames:{type:"string"},type:"object"},hasIndependentActions:{description:"In multiSelect, action on an item does not affect selection of parent or child items",type:"boolean"},hasIndependentChildActions:{description:"Actions on child in multi select do not affect selection of ancestors",type:"boolean"},hasStaticParentNodes:{description:"Makes parent nodes non-actionable (only manage hierarchy)",type:"boolean"},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu will be open by default",type:"boolean"},isMulti:{description:"Allow multiple selection. Default: false",type:"boolean"},isPositionFixed:{description:"Sets dropdown position as fixed (relative to viewport)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Flat array of tree items with parent references. Root items have parent: null, children reference parent value",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disable this item",type:"boolean"},isLeaf:{description:"Marks the item as a leaf node",type:"boolean"},label:{description:"Display label for the item",type:"string"},parent:{anyOf:[{type:"string"},{type:"null"}],description:"Parent item value, null for root items"},secondaryLabel:{description:"Supporting text below the label",type:"string"},value:{description:"Unique identifier for the item",type:"string"}},required:["label","value"],type:"object"},type:"array"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Max height of tags container (CSS value)"},placeholder:{description:"Placeholder text when no selection",type:"string"},placement:{description:"Dropdown position. Default: bottom-end",enum:["top-start","top","top-end","right-start","right","right-end","bottom-end","bottom","bottom-start","left-end","left","left-start"],type:"string"},shouldExpandNodeOnSelection:{description:"Auto expands a node to show its children once selected. Default: false",type:"boolean"},shouldShowFolderStructure:{description:"Renders folder structure view",type:"boolean"},shouldShowSelectionPath:{description:"Show parent-to-child path in selected chips. Default: false",type:"boolean"},size:{description:"Input size. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Custom theme styling",enum:["NO_BOX"],type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state"}},required:["name","list"],type:"object"},acceptsChildren:!1},FormWorkEmail:{description:"A Form-registered work email field for use inside a Form component.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name — drives the Form value key inside the parent Form",type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},domainList:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"},{items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this specific domain option",type:"boolean"},label:{description:"Display label for the domain option",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Optional semantic appearance for the tag",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text displayed with the domain option",type:"string"}},required:["text"],type:"object"}],description:"Optional tag shown with the domain option"},value:{description:"Domain option value",type:"string"}},required:["value"],type:"object"},type:"array"},{items:{additionalProperties:!1,properties:{label:{description:"Group label for a nested domain list",type:"string"},list:{description:"Grouped domain options",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this specific domain option",type:"boolean"},label:{description:"Display label for the domain option",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Optional semantic appearance for the tag",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text displayed with the domain option",type:"string"}},required:["text"],type:"object"}],description:"Optional tag shown with the domain option"},value:{description:"Domain option value",type:"string"}},required:["value"],type:"object"},type:"array"}},required:["label","list"],type:"object"},type:"array"}],description:'Email domain list for selection. Can be: single string, array of strings ["acme.com"], array of {label, value, tag?} objects (FlatList), or array of {label, list} objects (NestedList) for grouped domains'},helperMessage:{description:"Persistent supporting text below the input. Validation errors temporarily replace it.",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks field required and blocks form submit when empty",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},validationErrors:{additionalProperties:{type:"string"},description:"Map of rule name to error message",propertyNames:{type:"string"},type:"object"},validations:{description:'Comma-separated Form rule string example: "isEmail,minLength:5"',type:"string"},value:{description:"Current value bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1},Grid:{description:"A structured key-value grid for displaying labeled data fields with automatic responsive column sizing. Use for read-only detail views such as profile summaries, record details, or settings overviews. Supports action buttons for edit/delete operations on the displayed data.",events:["actionClick"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{actionClickedId:{description:"Stores the id of the clicked action. Bind to state path to access in actionClick event handler",type:"string"},actions:{description:"Array of action buttons displayed at the bottom of the grid. Each action emits actionClick event with id in state",items:{additionalProperties:!1,properties:{"aria-label":{description:"Accessibility label for the action button",type:"string"},"aria-labelledby":{description:"ID of element that labels the action button",type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},iconType:{description:'Icon type name (e.g., "EDIT_OUTLINE", "DELETE")',type:"string"},id:{description:"Unique identifier for this action. Written to state on click",type:"string"},isDisabled:{description:"Disable the action button. Default: false",type:"boolean"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Force tooltip to always be visible",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip"},placement:{description:"Tooltip placement position",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip for the action button. Can be a simple string or tooltip configuration object"}},required:["id","iconType"],type:"object"},type:"array"},list:{description:"Array of cells to display in the grid. Each cell has a label and renderer with props",items:{anyOf:[{additionalProperties:!1,properties:{label:{anyOf:[{type:"string"},{type:"number"}],description:"Label displayed in the cell header. String or number value"},props:{additionalProperties:!1,description:"Props passed to LabelRenderer. Icon colors must be Pebble text/icon color tokens.",properties:{appearance:{description:"Color scheme of the label. Default: NEUTRAL",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},children:{description:"Text content of the label",type:"string"},leftIcon:{anyOf:[{description:'Icon type name (e.g., "CHECK_CIRCLE_OUTLINE", "HIGH_PRIORITY")',type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token. Only applicable for TRANSPARENT appearance",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name",type:"string"}},required:["type"],type:"object"}],description:"Icon displayed on the left side of the label"},maxWidth:{description:"Maximum width CSS value for truncation",type:"string"},rightIcon:{anyOf:[{description:'Icon type name (e.g., "CHECK_CIRCLE_OUTLINE", "HIGH_PRIORITY")',type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token. Only applicable for TRANSPARENT appearance",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name",type:"string"}},required:["type"],type:"object"}],description:"Icon displayed on the right side of the label"},size:{description:"Size of the label. Default: LARGE",enum:["SMALL","MEDIUM","LARGE","EXTRA_LARGE"],type:"string"},text:{description:"Text content of the label. Converted to children for LabelRenderer.",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},className:{description:"CSS class name for tooltip",type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when document scrolls. Default: false",type:"boolean"},isDelayed:{description:"Add 300ms delay before showing tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning (relative to viewport). Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from parent component",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip content"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip content"},onlyIfChildOverflow:{description:"Only show tooltip if any child content overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if content overflows. Default: false",type:"boolean"},overwriteMiddleware:{description:"Overwrite default floating-UI middleware. Default: false",type:"boolean"},padding:{description:"CSS padding value for tooltip content",type:"string"},placement:{description:"Tooltip placement relative to label. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"},shallSkipOverflowY:{description:"Skip overflow check on Y axis. Default: false",type:"boolean"},tipHideDelay:{description:"Milliseconds to wait before hiding tooltip (when isDelayed is true)",type:"number"},tipShowDelay:{description:"Milliseconds to wait before showing tooltip (when isDelayed is true)",type:"number"},title:{description:"Tooltip title text",type:"string"},truncateClassName:{description:"CSS class when onlyIfOverflow is enabled",type:"string"}},required:["content"],type:"object"}],description:"Tooltip shown on hover. Can be simple string or object with appearance, placement, and other options"}},type:"object"},renderer:{const:"LABEL",description:"Renderer type for the cell value. LABEL renders a Label component.",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Force tooltip to always be visible",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip"},placement:{description:"Tooltip placement position",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip for the cell label. Can be a simple string or tooltip configuration object"}},required:["label","renderer","props"],type:"object"},{additionalProperties:!1,properties:{label:{anyOf:[{type:"string"},{type:"number"}],description:"Label displayed in the cell header. String or number value"},props:{additionalProperties:{},description:"Props passed to TextRenderer: { value, color? }. Color must be a Pebble text/icon color token.",properties:{color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Text value to display"}},required:["value"],type:"object"},renderer:{const:"TEXT",description:"Renderer type for the cell value. TEXT displays plain text. Default: TEXT",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Force tooltip to always be visible",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip"},placement:{description:"Tooltip placement position",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip for the cell label. Can be a simple string or tooltip configuration object"}},required:["label","props"],type:"object"}]},type:"array"},theme:{description:"Visual theme variant. NO_CARD removes card styling, TRANSPARENT uses transparent theme, NO_PADDING removes padding. Default: card with padding",enum:["NO_CARD","TRANSPARENT","NO_PADDING"],type:"string"}},required:["list"],type:"object"},acceptsChildren:!1,category:["layout"],keywords:["grid","label value","details","summary","profile details","metadata","read-only","detail view","record","description list","drawer details","settings summary"],anatomy:{parts:[{name:"Cell label",required:!0,role:"Short caption for the value; may carry a tip for extra context"},{name:"Cell renderer",required:!0,role:"Component that renders the value from props; prefer stable references over inline arrows"},{name:"Actions",required:!1,role:"Optional record-level icon actions (edit, delete, share)"}],summary:"A card-surfaced, responsive multi-column grid (collapses to fewer columns as the container narrows) of label/value cells. Each cell pairs a label with a value rendered by a renderer component (commonly Layout.Grid.Renderer.TextRenderer or Layout.Grid.Renderer.LabelRenderer) plus an optional tip icon. An optional actions list attaches icon buttons to the record."},guidance:{doNotUseWhen:["Tabular data across multiple records with sorting or selection — use TableBasic","Editable data entry — use a Form with labeled inputs","Free-form child positioning — use Layout.Box, Layout.HStack, or Layout.VStack","Hand-rolled label/value Layout.HStack pairs — Layout.Grid gives consistent styling and reflow for free"],useWhen:["Read-only label/value summaries — employee profiles, document metadata, settings overviews","Detail views needing automatic responsive column reflow without writing grid CSS","Attaching record-level icon actions (edit, delete, share) to the displayed data","Embedding a summary inside a card or drawer — use theme NO_CARD, NO_PADDING, or TRANSPARENT"]},antiPatterns:["Inline arrow renderers in list cells","Styled Layout.Grid override instead of theme prop","Layout.Grid embedded without NO_CARD inside Card","Hardcoded colors in Layout.Grid companion styles","Custom label/value Layout.HStack instead of Layout.Grid","Interactive record table hand-rolled with custom rows or CSS grid instead of Layout.Grid"],selection:{confusedWith:[{component:"TableBasic",distinguishBy:"TableBasic is for tabular data across many records with sorting or row selection; Layout.Grid displays the label/value fields of a single record"},{component:"Form",distinguishBy:"Form isSettings also shows read-only record data but owns an edit mode; Layout.Grid is pure display with custom renderers and no editing"},{component:"Layout.VStack",distinguishBy:"Layout.VStack is a free-form vertical layout primitive; Layout.Grid is data-driven label/value cells with built-in responsive reflow and styling"},{component:"Layout.Box",distinguishBy:"Layout.Box arranges arbitrary children with flexbox; Layout.Grid takes a data list and renders a consistent label/value summary"}]},relatedComponents:[{name:"Layout.Grid.Renderer.TextRenderer",note:"Default renderer for plain text values",relationship:["child"]},{name:"Layout.Grid.Renderer.LabelRenderer",note:"Renderer for values shown as status Labels",relationship:["child"]},{name:"TableBasic",note:"Multi-record tabular data with sorting/selection",relationship:["alternative"]},{name:"Form",note:"Form isSettings when the same record data needs an edit mode",relationship:["alternative"]},{name:"Layout.Box",note:"Free-form layout when cells are not label/value pairs",relationship:["alternative"]},{name:"Card",note:"Common container; embed Layout.Grid with theme NO_CARD or TRANSPARENT so the card owns the surface",relationship:["complement"]},{name:"Drawer",note:"Frequent host for record detail grids (transaction details, leave balances)",relationship:["complement"]},{name:"Tip",note:"Cell-level explanations via the tip field",relationship:["complement"]}]},Heading:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{align:{description:"Text alignment",enum:["left","center","right"],type:"string"},color:{description:"Pebble text/icon color token resolved via the current theme.",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},decoration:{description:'Text decoration CSS value (e.g. "underline", "line-through")',type:"string"},inline:{description:"Display as inline element instead of block",type:"boolean"},level:{anyOf:[{const:1,type:"number"},{const:2,type:"number"},{const:3,type:"number"},{const:4,type:"number"},{const:5,type:"number"},{const:6,type:"number"}],description:"Heading level (h1=1, h2=2, h3=3, h4=4, h5=5, h6=6)"},lineClamp:{description:"Max visible lines before truncation with ellipsis",type:"number"},maxWidth:{description:"Maximum width CSS value for the text element",type:"string"},mono:{description:"Apply monospace font family",type:"boolean"},text:{description:"Heading text content",type:"string"},transform:{description:'Text transform CSS value (e.g. "uppercase", "capitalize")',type:"string"}},type:"object"},acceptsChildren:!1},Hidden:{description:"A hidden form input for passing fixed or derived values through form submission without any visible UI.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Field name used in form submission data",type:"string"},defaultValue:{description:"Initial value for uncontrolled usage",type:"string"},value:{description:"The value submitted with the form, bound to state",type:"string"}},required:["name"],type:"object"},acceptsChildren:!1,category:["input"],keywords:["hidden input","hiddeninput","hidden field","form submission value","derived value","fixed value","invisible input","form state","composite input backing value","validation gate"],anatomy:{parts:[{name:"Hidden input element",required:!0,role:"Native input[type=hidden] carrying name + value into form submission"}],summary:"Renders no visible UI — only a native hidden input in the DOM. Inside a Form (Form.Input.Hidden), it registers a name/value pair into the submitted payload and can participate in validation (e.g. isRequired gating) without rendering anything."},guidance:{doNotUseWhen:["The value should be visible to the user — use Input.Text with isDisabled or isReadOnly","Storing secrets — hidden inputs are inspectable in the DOM; never rely on them for security","State that never needs to be submitted — use React state instead of shadowing UI state in hidden fields","Outside a Form's submit context — a hidden input without submission carries nothing"],useWhen:["Including fixed values (IDs, country codes, provider names) in a Form's submitted payload","Passing derived/computed values (lookup IDs, RQL formulas, calculated totals) through submission","Gating form submission on async state via isRequired or validations on the hidden value","Backing composite inputs (address, lookup fields) that submit a structured value under one name"]},antiPatterns:["Sensitive values placed in hidden fields","Many hidden fields used to mirror complex filter UI state","Invalid styling applied to hidden fields","Hidden fields used outside Form submit context"],selection:{confusedWith:[{component:"Hide",distinguishBy:"Hide responsively hides visible content at breakpoints; Input.Hidden renders no UI at all and exists only to submit a value with a Form"},{component:"Input.Text",distinguishBy:"If the user should see the value (even read-only), use Input.Text with isDisabled or isReadOnly; Input.Hidden is invisible and user-uneditable"}]},relatedComponents:[{name:"Form",note:"Nearly all real usage is Form.Input.Hidden — carrying IDs, derived values, and isRequired validation gates through submission",relationship:["parent"]},{name:"Hide",note:"Name-collision risk: Hide is for responsive visibility of rendered content, not form values",relationship:["alternative"]},{name:"Input.Text",note:"For values the user should see, use a disabled or read-only text input instead",relationship:["alternative"]}]},HStack:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{align:{description:"Cross-axis alignment",enum:["flex-start","center","flex-end","stretch","baseline"],type:"string"},alignSelf:{description:"Align self override when inside a flex parent",enum:["auto","flex-start","center","flex-end","stretch","baseline"],type:"string"},backgroundColor:{description:"Background surface color token",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},basis:{anyOf:[{type:"number"},{type:"string"}],description:"Flex basis value"},boxSizing:{description:"Box sizing model",enum:["content-box","border-box"],type:"string"},color:{description:"Text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},gap:{description:"Spacing token for gap between children",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},grow:{description:"Flex grow factor",type:"number"},height:{anyOf:[{type:"number"},{type:"string"}],description:"Height in pixels (number) or CSS string"},justify:{description:"Main-axis alignment",enum:["flex-start","center","flex-end","space-between","space-around","space-evenly"],type:"string"},margin:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Margin as a spacing token or directional spacing-token object {top, right, bottom, left}"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Max height in pixels or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Max width in pixels or CSS string"},minHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Min height in pixels or CSS string"},minWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Min width in pixels or CSS string"},overflow:{description:"Overflow behavior",enum:["visible","hidden","scroll","auto"],type:"string"},padding:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Padding as a spacing token or directional spacing-token object {top, right, bottom, left}"},radius:{description:"Border radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},shrink:{description:"Flex shrink factor",type:"number"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Width in pixels (number) or CSS string"},wrap:{description:"Flex wrap behavior",enum:["nowrap","wrap","wrap-reverse"],type:"string"}},type:"object"},acceptsChildren:!0,category:["layout"],keywords:["h stack","hstack","horizontal","row","flex row","toolbar","action row","inline","button group","avatar name","label value","gap"],anatomy:{parts:[{name:"Children",required:!0,role:"Row items — commonly Buttons, Avatar + text, Icon + label, or Chips"}],summary:"A single-row flex container (no sub-components): children flow left to right with token-based gap. align controls vertical (cross-axis) alignment, justify controls horizontal distribution, wrap='wrap' allows multi-line rows, and changeDirectionAbove flips to a column below a container breakpoint."},guidance:{doNotUseWhen:["Vertical stacking — use Layout.VStack","Multi-axis layouts or custom CSS — use Layout.Box","Deeply nested Layout.HStack/Layout.VStack trees — flatten to a single container with gap","Segmented joined buttons — use ButtonGroup"],useWhen:["Aligning items in a row — toolbar buttons, avatar + name, icon + label, label + value","Token-based horizontal spacing without writing flex CSS","Inline action groups (Save/Cancel) needing uniform gap; add role='group' and aria-label","Rows that should stack vertically on narrow containers via changeDirectionAbove"]},antiPatterns:["Magic-number spacing instead of design tokens","Action rows without responsive stacking","Button groups missing accessible group labeling","Hardcoded margin objects on Layout.HStack","Layout.HStack used as vertical spacer"],selection:{confusedWith:[{component:"Layout.VStack",distinguishBy:"Layout.VStack stacks children vertically; Layout.HStack is strictly a horizontal row"},{component:"Layout.Box",distinguishBy:"Layout.Box with direction='row' equals Layout.HStack; prefer Layout.HStack for plain rows and Layout.Box when combining extra flex behaviors or surface styling"},{component:"Layout.Grid",distinguishBy:"Layout.Grid is a data-driven read-only label/value summary grid, not a generic row layout"},{component:"ButtonGroup",distinguishBy:"ButtonGroup joins buttons into one segmented control; Layout.HStack keeps buttons as separate, evenly-gapped actions"}]},relatedComponents:[{name:"Layout.Box",note:"Layout.HStack is a convenience wrapper around Layout.Box with direction fixed to row",relationship:["parent"]},{name:"Layout.VStack",note:"Vertical stacking",relationship:["alternative"]},{name:"Layout.Grid",note:"Data-driven label/value summaries instead of hand-assembled label/value rows",relationship:["alternative"]},{name:"ButtonGroup",note:"Segmented joined buttons instead of separate gapped actions",relationship:["alternative"]},{name:"Button",note:"Action rows (Save/Cancel); add role='group' and aria-label for toolbars",relationship:["complement"]},{name:"Avatar",note:"Avatar + name/title rows",relationship:["complement"]},{name:"Chip",note:"Tag rows with wrap='wrap'",relationship:["complement"]}]},Icon:{description:"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.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{"aria-controls":{description:"ID of element controlled by this icon",type:"string"},"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-expanded":{description:"Indicates if controlled element is expanded",type:"boolean"},"aria-haspopup":{description:"Indicates the icon triggers a popup",enum:["true","false","menu","listbox","tree","grid","dialog"],type:"string"},"aria-label":{description:"Accessible label. Required when onClick is used",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},isDisabled:{description:"Disable the icon. Default: false",type:"boolean"},isFocused:{description:"Show icon backdrop when focused. Use only with interactive icons (onClick). Default: false",type:"boolean"},showCursor:{description:"Show pointer cursor and backdrop on hover. Use only with interactive icons (onClick). Default: false",type:"boolean"},size:{description:"Icon size token",enum:["sizeIcon2xl","sizeIcon2xs","sizeIcon3xl","sizeIcon3xs","sizeIcon4xl","sizeIconLg","sizeIconMd","sizeIconSm","sizeIconXl","sizeIconXs"],type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Max height in px or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Max width in px or CSS string"},placement:{description:"Tooltip placement. Default: BOTTOM",enum:["TOP_START","TOP","TOP_END","RIGHT_START","RIGHT","RIGHT_END","BOTTOM_START","BOTTOM","BOTTOM_END","LEFT_START","LEFT","LEFT_END"],type:"string"},title:{description:"Tooltip title text",type:"string"}},required:["content"],type:"object"}],description:"Tooltip. String for simple text, or object for advanced options"},type:{description:"Icon type string from Icon.TYPES (e.g. ADD, CHECK, CLOSE, EDIT_OUTLINE)",type:"string"}},required:["type"],type:"object"},acceptsChildren:!1,category:["atom"],keywords:["icon","glyph","symbol","pictogram","status icon","info icon","help icon","chevron","close icon","warning icon","icon font","tooltip marker"],anatomy:{parts:[{name:"glyph",required:!0,role:"The icon-font character referenced by an Icon.TYPES semantic name"},{name:"tooltip",role:"Optional hover tooltip via the tip prop for help/info markers"},{name:"state backdrop",role:"Visual focus/hover/disabled treatments via isFocused and isDisabled"}],summary:"A single inline SVG/font glyph sized via the size prop and colored via theme tokens. No sub-components — composition happens by placing Icon inside other components (Button, Chip, Label) or attaching the built-in tip tooltip."},guidance:{doNotUseWhen:["Standalone icon-only action — use Button.Icon or IconButton for button semantics","A purpose-built component exists for the same glyph (Avatar, Spinner) — use that instead","Rippling AI branded star iconography — use the RIPPLING_AI_* Icon.TYPES entries, not deprecated AiIcon","Close/dismiss controls — use Button.Icon, not a plain clickable Icon"],useWhen:["Decorative or semantic glyphs alongside text in labels, headings, list items, or table cells","Inline status feedback paired with a theme color token (success, warning, error)","Help/info markers that surface context on hover — use the built-in tip prop","Adding iconography inside Button, Chip, Label, or similar components","Lightweight inline triggers (copy, expand, visibility toggle) — always with aria-label"]},antiPatterns:["Help and info icons shown without tooltip or accessible description","`Tip` component wrapping `Icon` instead of Icon's built-in `tip` prop","Icon colors not using theme tokens — breaks in dark mode","Custom clickable icon wrappers without accessible name on the glyph","Interactive icons missing accessible name (`onClick` without `aria-label`)","Deprecated `AiIcon` used instead of `Icon.TYPES.RIPPLING_AI_*` for AI-branded glyphs","Close and dismiss controls implemented as plain clickable `Icon` instead of `Button.Icon`","Decorative Icon rendered beside visible content without `aria-hidden`"],propGuidance:[{guidance:"Pass a number (px) or CSS size string, e.g. size={20}. Match the surrounding text/control size.",pitfall:"Icon.SIZES.M does not exist — size is a number, not a constant; Icon.SIZES is undefined at runtime",prop:"size"},{guidance:"Always Icon.TYPES.* — resolve the exact key with get-component-info rather than guessing a name.",pitfall:'Passing a string like type="check" or a name= prop — neither exists',prop:"type"}],selection:{confusedWith:[{component:"Button.Icon",distinguishBy:"Button.Icon is the correct element for icon-only actions (button semantics, focus, hit area); a bare clickable Icon is an anti-pattern"},{component:"IconButton",distinguishBy:"IconButton is the standalone compact icon trigger with accessible focus state; Icon alone is for decorative or inline glyphs"},{component:"Avatar",distinguishBy:"Avatar renders a person or entity image/initials; Icon renders abstract UI glyphs"},{component:"Text",distinguishBy:"Text renders character content bound to a typestyle token; Icon renders a pictographic glyph"}]},relatedComponents:[{name:"Button.Icon",note:"Icon-only actions — provides button semantics and requires an accessible name",relationship:["alternative"]},{name:"IconButton",note:"Standalone compact icon-only trigger with correct focus state",relationship:["alternative"]},{name:"Avatar",note:"Purpose-built component for person/entity imagery",relationship:["alternative"]},{name:"Text",note:"Glyphs are commonly placed beside Text labels to reinforce meaning",relationship:["complement"]},{name:"Tip",note:"Prefer Icon's built-in tip prop over wrapping in Tip",relationship:["complement"]},{name:"Button",note:"Pass Icon via Button's icon prop when the glyph aids recognition of a labeled action",relationship:["complement"]}]},IconButton:{description:"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.",events:["press","pressWhileDisabled","mouseEnter","mouseLeave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Visual appearance style (PRIMARY, GHOST, OUTLINE, SOLID, DESTRUCTIVE, SUCCESS, INFO, WARNING, ACCENT, ACTIVE). Default: PRIMARY",enum:["PRIMARY","GHOST","OUTLINE","SOLID","DESTRUCTIVE","SUCCESS","INFO","WARNING","ACCENT","ACTIVE"],type:"string"},"aria-controls":{description:"ID of element controlled by the button",type:"string"},"aria-describedby":{description:"ID of element that describes the button",type:"string"},"aria-expanded":{description:"Indicates expanded state (for toggles)",type:"boolean"},"aria-haspopup":{anyOf:[{type:"boolean"},{type:"string"}],description:"Indicates the button opens a popup/menu"},"aria-label":{description:"Accessible label for the button. Required if aria-labelledby is not provided.",type:"string"},"aria-labelledby":{description:"ID of element that labels the button. Required if aria-label is not provided.",type:"string"},"aria-pressed":{anyOf:[{type:"boolean"},{const:"mixed",type:"string"}],description:"Indicates pressed state (for toggle buttons)"},icon:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type from Icon.TYPES",type:"string"}},required:["type"],type:"object"}],description:"Icon to display. Can be icon name string or object with type and color"},id:{description:"DOM id selector for the button element",type:"string"},isDisabled:{description:"If true, button is disabled. Default: false",type:"boolean"},shouldPreventFocus:{description:"If true, the button will not be focusable (tabIndex -1). Default: false",type:"boolean"},shouldShowSpinner:{description:"If true, shows loading spinner instead of icon",type:"boolean"},size:{description:"Size of the button (XS, S, M, L). Default: M",enum:["XS","S","M","L"],type:"string"},tabIndex:{description:"Tab order for keyboard navigation",type:"number"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Control tooltip visibility from parent",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max height (number in px or CSS string)"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Tooltip max width (number in px or CSS string)"},placement:{description:"Tooltip placement relative to button. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip text or tooltip configuration object"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{description:"Open link in new tab. Default: false",type:"boolean"},path:{description:"URL path for navigation",type:"string"}},required:["path"],type:"object"}],description:"Navigation destination. When provided, button renders as anchor and handles navigation automatically"},type:{description:"HTML button type attribute (button, submit, reset). Default: button",enum:["button","submit","reset"],type:"string"}},required:["icon"],type:"object"},acceptsChildren:!1,category:["buttons"],keywords:["icon button","icon-only action","close button","kebab menu","more actions","toolbar action","row action","overflow menu trigger","edit icon","copy button","delete icon","iconbutton"],anatomy:{parts:[{name:"container",required:!0,role:"Button hit area with appearance and size"},{name:"icon",required:!0,role:"The glyph conveying the action; accepts an icon type or config with color"},{name:"tip",role:"Tooltip describing the action (not the icon); pairs with aria-label"}],summary:"A square button container holding a single icon — no text label. An optional tooltip via the tip prop explains the action on hover. Supports the same appearances, sizes, and async spinner behavior as Button; filled icons read better at small sizes."},guidance:{doNotUseWhen:["Critical or unfamiliar actions that need context — use a labeled Button","Navigation — use Anchor or the `to` prop, never onClick router push","Display-only icons with no action — use Icon","Without an accessible name — Button.Icon always requires aria-label (and a tip for sighted users)"],useWhen:["Compact repeated actions in toolbars, grid rows, and card headers (edit, copy, close, expand)","Well-known icons (search, close, more) where a text label adds nothing","Dense surfaces with multiple equally weighted actions","Triggering an overflow or kebab menu via Popper or Dropdown"]},antiPatterns:["Icon-only buttons missing an accessible name on at least one instance","Icon buttons without tooltips — sighted users lack action context","Destructive appearance on inline row icon buttons — stress without guardrails","Empty or placeholder `aria-label` values","Navigation opened via `onClick` instead of `to` on icon buttons","Icon-only button used where a text Button is required"],selection:{confusedWith:[{component:"Icon",distinguishBy:"Icon is display-only with no button semantics, focus, or hit area; Button.Icon performs an action"},{component:"Button",distinguishBy:"Critical actions or meanings that need text -> Button; well-known icons in dense or repeated UI -> Button.Icon"},{component:"Dropdown",distinguishBy:"One direct action -> Button.Icon; a menu of several actions -> Dropdown (often triggered by a Button.Icon)"},{component:"Anchor",distinguishBy:"Outcome is navigation to a URL -> Anchor or the `to` prop, never onClick router push"}]},relatedComponents:[{name:"Button",note:"Shares appearances, sizes, and spinner; use Button when the action needs a text label",relationship:["parent"]},{name:"Icon",note:"Display-only iconography with no action",relationship:["alternative"]},{name:"Anchor",note:"Navigation to another page or URL",relationship:["alternative"]},{name:"Dropdown",note:"Consolidating many row- or toolbar-level actions into one menu",relationship:["alternative"]},{name:"Tip",note:"The tip prop supplies the tooltip; keep its text aligned with aria-label",relationship:["complement"]}]},Image:{description:"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.",events:["press","load","error"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alt:{description:"Alt text for accessibility. Required for screen readers",type:"string"},assetFilter:{description:"Apply dark mode filter for dark themes. Default: false",type:"boolean"},borderRadius:{description:'Border radius token, e.g. "shapeCornerMd"',enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},height:{anyOf:[{type:"number"},{type:"string"}],description:"Image height in px or CSS string"},loading:{description:"Loading strategy. Default: eager",enum:["eager","lazy"],type:"string"},src:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{dark:{type:"string"},light:{type:"string"}},type:"object"}],description:"Image URL or theme-aware source object with light/dark variants"},theme:{description:"Image theme. COVER for cover positioning",enum:["COVER"],type:"string"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Image width in px or CSS string"}},required:["alt"],type:"object"},acceptsChildren:!1,category:["atom"],keywords:["image","img","picture","logo","thumbnail","illustration","empty state","dark mode image","theme-aware image","asset filter","cover image","photo","cdn image"],anatomy:{parts:[{name:"Source",required:!0,role:"Image URL or { light, dark } theme-aware pair via the src prop"},{name:"Alt text",required:!1,role:"Accessible description via alt; empty string only for purely decorative images"},{name:"Sizing",required:!1,role:"Explicit width/height (number or CSS value) to prevent layout shift"},{name:"Border radius",required:!1,role:"Rounding via shape tokens (e.g. theme.shapeCornerLg) for thumbnails and logos"}],summary:"A single img element with explicit width/height sizing. The src prop accepts a plain URL or a { light, dark } pair for theme-aware assets; assetFilter applies a dark-mode filter when no dedicated dark asset exists; borderRadius takes shape tokens; THEMES.COVER applies object-fit cover."},guidance:{doNotUseWhen:["Browsing multiple images with zoom and navigation — use ImageViewer","User profile pictures or initials — use Avatar","Purely decorative backgrounds — use CSS background-image instead of DOM noise","Animated illustrations — use LottiePlayer","Vector iconography — use Icon"],useWhen:["Displaying static images — logos, illustrations, thumbnails, empty-state art","Theme-aware images with different light/dark sources via the src object syntax","Cover images that must fill their container (theme={Image.THEMES.COVER})","Dark mode adaptation via assetFilter when no dedicated dark asset exists","Rounded product images or partner logos via borderRadius with shape tokens"]},antiPatterns:["Informative Image missing `alt` attribute","Over-reliance on `assetFilter` instead of theme-aware `src`","Raw `<img>` tags instead of Pebble Image in product UI","Hardcoded pixel `borderRadius` instead of shape tokens"],selection:{confusedWith:[{component:"ImageViewer",distinguishBy:"Image renders a single static image inline; ImageViewer is for browsing multiple images with zoom and navigation"},{component:"Avatar",distinguishBy:"Avatar is for user/profile pictures with initials fallback; Image is for logos, illustrations, and generic media"},{component:"Icon",distinguishBy:"Icon renders vector glyphs from the icon library; Image renders raster/SVG assets from a URL"},{component:"LottiePlayer",distinguishBy:"LottiePlayer plays animated .json illustrations; Image is for static assets"}]},relatedComponents:[{name:"ImageViewer",note:"Multi-image gallery with zoom and navigation",relationship:["alternative"]},{name:"Avatar",note:"User profile pictures and initials",relationship:["alternative"]},{name:"Icon",note:"Vector iconography instead of hosted image assets",relationship:["alternative"]},{name:"LottiePlayer",note:"Animated illustrations instead of static images",relationship:["alternative"]},{name:"Card",note:"Common container; Image renders card thumbnails, logos, and header art",relationship:["complement"]},{name:"Modal",note:"Onboarding and upsell modals frequently embed illustrative Images",relationship:["complement"]}]},ImageViewer:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alt:{description:"Alt text for accessibility",type:"string"},imageUrl:{description:"URL of the image to display",type:"string"},maxHeightForExpandedImage:{description:"Max height for expanded image with CSS unit. Example: 80vh",type:"string"}},required:["imageUrl"],type:"object"},acceptsChildren:!1,category:["complex"],keywords:["image viewer","imageviewer","image preview","click to expand","document preview","receipt","invoice","attachment","contract","screenshot","scanned document","lightbox"],anatomy:{parts:[{name:"Thumbnail",required:!0,role:"Inline image sized by its container; clicking it opens the expanded preview"},{name:"Expanded preview",required:!1,role:"Viewport-constrained overlay of the full-resolution image, bounded by maxHeightForExpandedImage"}],summary:"A thumbnail image that acts as a button; clicking opens an expanded overlay showing the full image constrained to the viewport via maxHeightForExpandedImage. Always supply alt so the preview is described to screen readers."},guidance:{doNotUseWhen:["Multi-image browsing with navigation — use Carousel instead","Decorative or promotional imagery — use Atoms.Image so users don't get unexpected click-to-expand","Video or multi-page PDF content — use Video or a dedicated document viewer","Non-image file URLs — preview only static image files"],useWhen:["Previewing user-uploaded images — photos, receipts, or attachments users must inspect before acting","Showing scanned documents inline — invoices, contracts, ID and verification documents","Setup or instruction screenshots where users need to zoom to full size","Any thumbnail that should expand to a viewport-fitted full view on click"]},antiPatterns:["Expanded preview not constrained to viewport — `maxHeightForExpandedImage` omitted","Screen reader users get no image description — `alt` omitted","Shared wrapper components propagate missing accessibility props","Non-image file URLs passed to image preview","Promotional or decorative imagery given misleading click-to-expand behavior","Competing click targets — external link wrapped around expandable thumbnail"],selection:{confusedWith:[{component:"Atoms.Image",distinguishBy:"Atoms.Image is a non-interactive display image; ImageViewer adds click-to-expand inspection for user-supplied documents and photos"},{component:"Carousel",distinguishBy:"Carousel browses multiple images with navigation controls; ImageViewer previews a single image"},{component:"FileDrop",distinguishBy:"FileDrop is for uploading files; ImageViewer is for inspecting already-attached images after upload"}]},relatedComponents:[{name:"Atoms.Image",note:"Plain non-interactive image display — logos, illustrations, decorative imagery",relationship:["alternative"]},{name:"Carousel",note:"Multi-image galleries with navigation instead of single-image preview",relationship:["alternative"]},{name:"Modal",note:"Expanded preview renders as an overlay; ImageViewer often appears inside Modal or Tabs for document review",relationship:["complement"]},{name:"Tabs",note:"Frequently composed with Tabs to preview multiple attachments of one record",relationship:["complement"]},{name:"FileDrop",note:"Upload counterpart — FileDrop captures files, ImageViewer previews the uploaded images",relationship:["complement"]}]},InputGroup:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{input:{additionalProperties:!1,description:"Main input configuration with type and inputProps",properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},isDisabled:{description:"Disables all inputs in the group",type:"boolean"},isInvalid:{description:"Shows error styling on the group",type:"boolean"},isReadOnly:{description:"Makes all inputs in the group read-only",type:"boolean"},prefix:{anyOf:[{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},{items:{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},type:"array"}],description:"Prefix input configuration(s) prepended to the main input"},prefixMaxWidthPercent:{description:"Max width percentage for the prefix container",type:"number"},prefixMinWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum width for the prefix container"},shouldHideAddons:{description:"Hides prefix/suffix without destroying them",type:"boolean"},size:{description:"Size of all inputs in the group. Default: M",enum:["XS","S","M","L"],type:"string"},suffix:{anyOf:[{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},{items:{additionalProperties:!1,properties:{inputProps:{additionalProperties:{},description:"Props to pass to the input component",propertyNames:{type:"string"},type:"object"},type:{description:"Input component type",enum:["Text","Number","Currency","Masker","Password","Percentage","Phone","Select","TextAutoSuggest","Time","Date","Timezone"],type:"string"}},required:["type","inputProps"],type:"object"},type:"array"}],description:"Suffix input configuration(s) appended to the main input"},suffixMaxWidthPercent:{description:"Max width percentage for the suffix container",type:"number"},suffixMinWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum width for the suffix container"}},required:["input"],type:"object"},acceptsChildren:!1},Interval:{description:"Emits a tick event repeatedly after the configured delay. Renders no UI and stops when unmounted.",events:["tick"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{delay:{description:"Time in milliseconds between tick events.",maximum:9007199254740991,minimum:0,type:"integer"}},required:["delay"],type:"object"},acceptsChildren:!1},ItemNavigator:{description:'A compact control for stepping through items one at a time, with either an "X of Y items" label or clickable position dots. Use for sequential item-by-item navigation such as cycling through detail views, carousel items, search results, or review queues — not for page-based navigation (use Pagination instead).',events:["next","previous","select"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{currentItemIndex:{description:"Current item index (0-based). Range: 0 to totalItems-1",type:"number"},hasMore:{description:'Whether there are more items beyond totalItems. Shows "+" indicator',type:"boolean"},itemLabel:{description:'Singular form of item label used in button labels. Example: "vendor"',type:"string"},itemLabelPlural:{description:'Plural form of item label used in display text. Example: "vendors"',type:"string"},nextDisabled:{description:"Force-disable the next button, overriding default logic",type:"boolean"},nextTip:{description:"Tooltip text for the next button",type:"string"},prevDisabled:{description:"Force-disable the previous button, overriding default logic",type:"boolean"},prevTip:{description:"Tooltip text for the previous button",type:"string"},totalItems:{description:"Total number of items to navigate through",type:"number"},variant:{description:"Display style: LABEL shows the item count; DOTS shows clickable position dots",enum:["LABEL","DOTS"],type:"string"}},required:["totalItems","currentItemIndex","itemLabel","itemLabelPlural"],type:"object"},acceptsChildren:!1},Label:{description:'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.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Color scheme of the label. Default: NEUTRAL",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},leftIcon:{anyOf:[{description:'Icon type name (e.g., "CHECK_CIRCLE_OUTLINE", "HIGH_PRIORITY")',type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token. Only applicable for TRANSPARENT appearance",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name",type:"string"}},required:["type"],type:"object"}],description:"Icon displayed on the left side of the label"},maxWidth:{description:"Maximum width CSS value for truncation",type:"string"},rightIcon:{anyOf:[{description:'Icon type name (e.g., "CHECK_CIRCLE_OUTLINE", "HIGH_PRIORITY")',type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token. Only applicable for TRANSPARENT appearance",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name",type:"string"}},required:["type"],type:"object"}],description:"Icon displayed on the right side of the label"},size:{description:"Size of the label. Default: LARGE",enum:["SMALL","MEDIUM","LARGE","EXTRA_LARGE"],type:"string"},text:{description:"Text content of the label",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},className:{description:"CSS class name for tooltip",type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when document scrolls. Default: false",type:"boolean"},isDelayed:{description:"Add 300ms delay before showing tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning (relative to viewport). Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from parent component",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip content"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip content"},onlyIfChildOverflow:{description:"Only show tooltip if any child content overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if content overflows. Default: false",type:"boolean"},overwriteMiddleware:{description:"Overwrite default floating-UI middleware. Default: false",type:"boolean"},padding:{description:"CSS padding value for tooltip content",type:"string"},placement:{description:"Tooltip placement relative to label. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"},shallSkipOverflowY:{description:"Skip overflow check on Y axis. Default: false",type:"boolean"},tipHideDelay:{description:"Milliseconds to wait before hiding tooltip (when isDelayed is true)",type:"number"},tipShowDelay:{description:"Milliseconds to wait before showing tooltip (when isDelayed is true)",type:"number"},title:{description:"Tooltip title text",type:"string"},truncateClassName:{description:"CSS class when onlyIfOverflow is enabled",type:"string"}},required:["content"],type:"object"}],description:"Tooltip shown on hover. Can be simple string or object with appearance, placement, and other options"}},required:["text"],type:"object"},acceptsChildren:!1,category:["atom"],keywords:["label","tag","category","metadata","status chip","badge text","new","beta","recommended","semantic color","colored chip","grid cell label"],anatomy:{parts:[{name:"container",required:!0,role:"Color-coded pill sized by the size prop"},{name:"text",required:!0,role:"Single short string of metadata passed as children"},{name:"leftIcon / rightIcon",role:"Optional icons flanking the text; give them accessible names if they carry meaning"},{name:"tip",role:"Optional built-in tooltip for extra context — prefer over an external Tip wrapper"}],summary:"A small rounded container holding a single short text string, with optional start and end icons and an optional tooltip via the tip prop. Color comes from the semantic appearance (Primary, Neutral, Info, Success, Warning, Error, Transparent, Disabled). Label.Group lays out multiple related labels with consistent sizing."},guidance:{doNotUseWhen:["Interactive, dismissible, or selectable tags (applied filters) — use Chip","Workflow or process state that changes — use Status","Unread counts or numeric-only badges — use the badge support on Button/Tabs, not Label","Elements that open modals or navigate — use Button or Anchor","Long descriptive content — use Text with a Tip for additional context"],useWhen:["Short category or metadata tags on items (New, Recommended, Beta)","Bucketing items by a shared attribute in cards, lists, and grid cells","Semantic color (Success, Warning, Error, Info) conveying the meaning of a static value","Multiple related labels rendered together via Label.Group with one consistent size"]},antiPatterns:["Workflow or process state shown with Label instead of Status","Multiple related labels rendered side by side without `Label.Group`","Too many saturated semantic colors on one surface — visual noise instead of hierarchy","`PRIMARY` appearance used for routine metadata where neutral or transparent would suffice","External `Tip` + wrapper `div` used when Label's built-in `tip` prop would work","`DISABLED` appearance used for active or in-flux states (draft, unsaved, closed-on-date)","Icons on labels without accessible names when icon supplements or replaces visible meaning","Mixed label sizes within the same component surface"],selection:{confusedWith:[{component:"Chip",distinguishBy:"Chip is interactive — clickable, dismissible, or selectable (applied filters); Label is read-only static metadata"},{component:"Status",distinguishBy:"Workflow/process state that changes (In review, Failed) -> Status; relatively static categories and metadata -> Label"},{component:"Button",distinguishBy:"Label never interacts; if the element triggers an action, modal, or link -> Button or Anchor"},{component:"Text",distinguishBy:"Plain body or caption copy -> Text; a short color-coded metadata pill -> Label"}]},relatedComponents:[{name:"Label.Group",note:"Lays out multiple related labels with consistent sizing",relationship:["child"]},{name:"Chip",note:"Interactive, dismissible, or selectable tags such as applied filters",relationship:["alternative"]},{name:"Status",note:"Live workflow/process state display",relationship:["alternative"]},{name:"Button",note:"Any element that triggers an action",relationship:["alternative"]},{name:"Text",note:"Plain copy without a color-coded container",relationship:["alternative"]},{name:"Tip",note:"Prefer Label's built-in tip prop over wrapping Label in an external Tip",relationship:["complement"]}]},LabelGroup:{description:'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.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{maxLinesToWrap:{description:"Maximum number of lines to display before showing overflow indicator. Labels beyond this wrap into an overflow modal. Default: no limit",type:"number"},overflowModalTitle:{description:'Title for the overflow modal that appears when labels exceed maxLinesToWrap. Default: "View All"',type:"string"}},type:"object"},acceptsChildren:!0},Layout:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{align:{description:"CSS align-items value for flex children alignment",type:"string"},alignSelf:{description:"CSS align-self value to override parent align",type:"string"},backgroundColor:{description:"Background surface color token",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},basis:{anyOf:[{type:"number"},{type:"string"}],description:"CSS flex-basis value"},border:{anyOf:[{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}]},{additionalProperties:!1,properties:{bottom:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Bottom border"},left:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Left border"},right:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Right border"},top:{anyOf:[{description:"CSS border string. Pebble border width and border color tokens are resolved",type:"string"},{additionalProperties:!1,description:"Structured border using strict token parts",properties:{color:{description:"Border color token",enum:["colorError","colorOutline","colorOutlineVariant","colorSuccess","colorInfo","colorWarning","colorDisabled","colorOutlineFocus","colorOutlineInvalid","colorHover","colorHoverInverse","colorPressed","colorPressedInverse","colorOutlineInverse","colorOutlineVariantInverse","colorDisabledInverse"],type:"string"},style:{description:"CSS border style",enum:["none","hidden","dotted","dashed","solid","double","groove","ridge","inset","outset"],type:"string"},width:{description:"Border width token",enum:["shapeBorderWidthLg","shapeBorderWidthMd","shapeBorderWidthNone","shapeBorderWidthSm","shapeBorderWidthXl","shapeBorderWidthXs"],type:"string"}},type:"object"}],description:"Top border"}},type:"object"}],description:"Border. CSS string, strict token parts, or directional border object"},boxSizing:{description:"CSS box-sizing model",enum:["content-box","border-box"],type:"string"},color:{description:"Text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},direction:{description:"Flex direction. Default: row",enum:["row","column","row-reverse","column-reverse"],type:"string"},flex:{anyOf:[{type:"number"},{type:"string"}],description:"CSS flex shorthand"},gap:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{column:{description:"Column gap spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},row:{description:"Row gap spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Gap between children. Spacing token or {row, column} spacing-token object"},grow:{description:"CSS flex-grow value",type:"number"},height:{anyOf:[{type:"number"},{type:"string"}],description:"Element height. Number (px) or CSS string"},id:{description:"HTML id attribute",type:"string"},isInline:{description:"Use inline-flex display instead of flex",type:"boolean"},justify:{description:"CSS justify-content value for flex main-axis alignment",type:"string"},margin:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Margin. Spacing token or {left, right, top, bottom} spacing-token object"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height. Number (px) or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width. Number (px) or CSS string"},minHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum height. Number (px) or CSS string"},minWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum width. Number (px) or CSS string"},overflow:{description:"CSS overflow behavior",type:"string"},padding:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Padding. Spacing token or {left, right, top, bottom} spacing-token object"},position:{description:"CSS position value",type:"string"},radius:{anyOf:[{enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},{additionalProperties:!1,properties:{bottomLeft:{description:"Bottom-left corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},bottomRight:{description:"Bottom-right corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},topLeft:{description:"Top-left corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},topRight:{description:"Top-right corner radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"}},type:"object"}],description:"Border radius. Radius token or directional corner radius token object"},reverse:{description:"Reverse the flex direction",type:"boolean"},role:{description:"ARIA role for the container element",type:"string"},shrink:{description:"CSS flex-shrink value",type:"number"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Element width. Number (px) or CSS string"},wrap:{description:"CSS flex-wrap value",type:"string"},zIndex:{description:"CSS z-index stacking order",type:"number"}},type:"object"},acceptsChildren:!0},LayoutCard:{description:"A standard card container for creating card-based page layouts with configurable padding and an optional selectable theme for selection interfaces.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{fluid:{description:"When true, the card fills its parent width (including inside row layouts, where it would otherwise size to its content). Default: false",type:"boolean"},padding:{description:"Card padding size. Default: PX_24",enum:["PX_0","PX_8","PX_16","PX_24","PX_32"],type:"string"},theme:{description:"Card theme. SELECTABLE adds 2px tertiary border for selection UI. Default: DEFAULT",enum:["DEFAULT","SELECTABLE"],type:"string"}},type:"object"},acceptsChildren:!0,category:["card"],keywords:["layout card","layoutcard (card.layout)","card container","panel","section container","bordered surface","card padding","selectable card","card shell","dashboard panel","asset card","width","stretch","fill width","flex item","shrink to fit","fluid"],anatomy:{parts:[{name:"Container",required:!0,role:"Outer card wrapper with rounded corners and border; SELECTABLE theme for interactive cards"},{name:"Content",required:!0,role:"Body text or custom JSX placed inside the container"},{name:"Padding",required:!1,role:"Configurable 0/8/16/24/32px spacing between the container edge and content (PADDINGS constants)"}],summary:"A rounded, bordered container with configurable padding (0–32px per side via PADDINGS, default PX_24) wrapping free-form content — body text or custom JSX. The SELECTABLE theme renders a heavier border and is required when the card itself is clickable."},guidance:{doNotUseWhen:["The card represents an entity with a title and actions — use Card.Basic instead","Grouping multiple cards — use Card.Group","No card surface is needed — use Layout.Box or Layout.VStack instead","Empty/success/error placeholder states — use ActionCard instead","Full-bleed or marketing/hero content — do not force it through Card.Layout with PX_0"],useWhen:["Building card-based page sections that need the bordered card surface around custom content","Content panels with non-standard internal layout that Card.Basic cannot express","Wrapping dashboard or report display panels that need the card surface","Interactive selection or asset cards — always pair onClick with the SELECTABLE theme (most usages miss this)","Controlling exact inner spacing via the PADDINGS constants (PX_16 and PX_0 are the most common overrides)"]},antiPatterns:["Semantic entity cards built with Card.Layout and manual title typography","Hardcoded numeric padding instead of PADDINGS constants","Multiple stacked Card.Layout sections fragment detail views","Interactive Card.Layout missing SELECTABLE theme on same tag","Full-bleed content with PX_0 layout — accidental tight or flush clipping","Hardcoded padding instead of PADDINGS constants","Missing explicit padding (relies on default)","Layout.Box used for card-like surfacing nearby","onClick without SELECTABLE theme","Nested card surfaces without inner theme","Decorative gradients, glass, or blur effects used on product Card surfaces"],selection:{confusedWith:[{component:"Card",distinguishBy:"Card.Basic is a semantic entity card with title and built-in edit/delete/actions; Card.Layout is a bare container — reach for it only when you need the card surface without the semantic chrome"},{component:"Layout.Box",distinguishBy:"Layout.Box is a styleless layout primitive; Card.Layout adds the rounded, bordered, padded card surface"},{component:"ActionCard",distinguishBy:"ActionCard is the purpose-built empty/success/error placeholder; Card.Layout with custom content is not a state placeholder"}]},relatedComponents:[{name:"Card",note:"Namespace; Card.Basic is the semantic card variant with title and actions",relationship:["parent"]},{name:"Card.Basic",note:"Semantic card with title and edit/delete/actions — prefer it over manual headings in Card.Layout",relationship:["alternative"]},{name:"Layout.Box",note:"Styleless layout primitive when no card surface is needed",relationship:["alternative"]},{name:"ActionCard",note:"State placeholder (empty/success/error) instead of a custom layout card",relationship:["alternative"]},{name:"Input.Radio",note:"Selection controls composed inside SELECTABLE-theme layout cards",relationship:["complement"]}]},Link:{description:"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.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{"aria-controls":{description:"ID of element controlled by this link",type:"string"},"aria-current":{anyOf:[{type:"boolean"},{enum:["page","step","location","date","time"],type:"string"}],description:"Indicates current item within a set of items"},"aria-haspopup":{anyOf:[{type:"boolean"},{enum:["menu","listbox","tree","grid","dialog"],type:"string"}],description:"Indicates element triggers a popup or menu"},"aria-hidden":{description:"Hide element from accessibility tree",type:"boolean"},"aria-label":{description:"Accessibility label for the link",type:"string"},"aria-labelledby":{description:"ID of element that labels this link",type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},download:{anyOf:[{type:"string"},{type:"boolean"}],description:"Prompts download of the linked URL. Boolean true uses default filename, string sets custom filename"},href:{description:"URL to navigate to",type:"string"},rel:{description:'Relationship between current document and linked URL. Auto-set to "noopener noreferrer" when target is _blank',type:"string"},target:{description:"Link target (_blank or _self). Default: _self",enum:["_blank","_self"],type:"string"},text:{description:"Link text content",type:"string"},typestyle:{description:'Pebble typestyle token name for link text (e.g., "typestyleTitleSmall")',enum:["typestyleBodyLarge","typestyleBodyLarge500","typestyleBodyLarge600","typestyleBodyLargeEmphasized","typestyleBodyMedium","typestyleBodyMedium400","typestyleBodyMedium500","typestyleBodyMedium600","typestyleBodyMediumEmphasized","typestyleBodySmall","typestyleBodySmall400","typestyleBodySmall500","typestyleBodySmall600","typestyleBodySmallEmphasized","typestyleDisplayLarge","typestyleDisplayLarge600","typestyleDisplayMedium600","typestyleDisplaySmall600","typestyleLabelExtraLarge400","typestyleLabelExtraLarge500","typestyleLabelExtraLarge600","typestyleLabelExtraLarge700","typestyleLabelExtraSmall","typestyleLabelExtraSmallWide","typestyleLabelLarge","typestyleLabelLarge400","typestyleLabelLarge500","typestyleLabelLarge600","typestyleLabelMedium","typestyleLabelMedium500","typestyleLabelMedium600","typestyleLabelMedium700","typestyleLabelSmall","typestyleLabelSmall500","typestyleLabelSmall600","typestyleLabelSmallEmphasized","typestyleTitleExtraLarge600","typestyleTitleExtraSmall600Caps","typestyleTitleLarge","typestyleTitleLarge600","typestyleTitleMedium","typestyleTitleMedium600","typestyleTitleSmall","typestyleTitleSmall400","typestyleTitleSmall600","typestyleV2BodyLarge","typestyleV2BodyLargeEmphasized","typestyleV2BodyMedium","typestyleV2BodyMediumEmphasized","typestyleV2BodySmall","typestyleV2BodySmallEmphasized","typestyleV2DisplayLarge","typestyleV2LabelExtraSmall","typestyleV2LabelExtraSmallWide","typestyleV2LabelLarge","typestyleV2LabelMedium","typestyleV2LabelSmall","typestyleV2LabelSmallEmphasized","typestyleV2TitleLarge","typestyleV2TitleMedium","typestyleV2TitleSmall"],type:"string"}},required:["href"],type:"object"},acceptsChildren:!1,category:["atom"],keywords:["anchor","link","hyperlink","href","external link","inline link","help center link","download link","navigation","new tab","url"],anatomy:{parts:[{name:"link text",required:!0,role:"Short, action-oriented copy naming the destination, passed as children"},{name:"href",required:!0,role:"Required destination — internal path (soft navigation), external URL (new tab), or file resource"}],summary:"An inline <a> element styled with Pebble link tokens. When nested in Text it inherits the surrounding typography; standalone usages should set typestyle explicitly (commonly typestyleBodyLargeEmphasized). Optional trailing icon content and download/new-tab behavior via props."},guidance:{doNotUseWhen:["Triggering an in-product action (save, submit, delete) — use Button","Icon-only controls with no visible text — use IconButton or Button.Icon",'Faking a button with href="#" or an empty href — use Button variant TEXT with fontInherit',"Opening internal app routes in a new tab — let internal hrefs soft-navigate in place"],useWhen:["Inline navigation inside body copy, labels, or helper text (nest inside Text)","Linking to external resources like help center articles or policy pages (auto new tab + rel)","In-app navigation where the result is a URL change — internal hrefs get soft router navigation","File downloads via the download prop","Standalone links with an explicit typestyle to avoid unintended typography inheritance"]},antiPatterns:['New-tab links missing `rel="noopener noreferrer"`',"Deprecated `Typography.Anchor` still used instead of `Anchor`","Standalone links missing explicit `typestyle` outside `Text`",'`Anchor` used as a button (`href="#"` / empty `href` + `onClick`)',"Redundant navigation pathways in alerts — link duplicates an existing notice action",'In-app routes opened in a new tab (`target="_blank"` on internal `href`)',"Incomplete `rel` value (`noopener` without `noreferrer`)","Invalid `target` typo (`__blank` instead of `_blank`)"],selection:{confusedWith:[{component:"Button",distinguishBy:"Anchor navigates to a URL (href); Button performs an action (onClick). If the click mutates state or submits, use Button — TEXT variant with fontInherit for link-styled actions"},{component:"Typography",distinguishBy:"Typography.Anchor is the deprecated legacy link; always use the standalone Anchor component"},{component:"IconButton",distinguishBy:"IconButton is for icon-only controls with no visible text label; Anchor always carries visible link text"}]},relatedComponents:[{name:"Text",note:"Canonical host — Anchor nested in Text inherits the surrounding typography",relationship:["complement"]},{name:"Button",note:"Actions instead of navigation; variant TEXT + fontInherit mimics link styling",relationship:["alternative"]},{name:"Typography",note:"Deprecated Typography.Anchor — migrate to Anchor",relationship:["alternative"]},{name:"IconButton",note:"Icon-only control when there is no visible text label",relationship:["alternative"]},{name:"Tip",note:"Wrap for hover tooltips; keep critical links visible, not tooltip-only",relationship:["complement"]},{name:"Icon",note:"Trailing glyph (e.g. arrow) occasionally composed inside link content",relationship:["complement"]}]},ListItem:{description:"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.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{caption:{description:"Secondary text below the title",type:"string"},shouldTruncateCaption:{description:"Truncate caption to single line. Default: true",type:"boolean"},title:{description:"Primary text content of the list item",type:"string"}},type:"object"},acceptsChildren:!1,category:["dataDisplay"],keywords:["list item","listitem","list row","row","title caption row","record list","label value row","people list","settings list","detail row","stacked rows","clickable row","row action"],anatomy:{parts:[{name:"LeftRenderer",required:!1,role:"Leading slot: Avatar, Icon, or Input.Checkbox via ListItem.LeftRenderer.* sub-components"},{name:"title",required:!0,role:"Primary row label; keep it the main text, do not bury it in caption"},{name:"caption",required:!1,role:"Secondary text under the title; truncates to two lines by default"},{name:"RightRenderer",required:!1,role:"Trailing slot: PlainText, Text, Labels, Date, Buttons, Icons, or Select via ListItem.RightRenderer.* sub-components"},{name:"ListItem.Layout",required:!1,role:"Wrapper that spaces and divides a group of ListItems, with an optional group title"}],summary:"A horizontal row: optional leading slot (avatar, icon, checkbox, radio) on the left, a title with an optional two-line-truncating caption in the middle, and an optional trailing slot (text, label, buttons, date, select) on the right. Rows are stacked inside ListItem.Layout, which adds dividers, spacing, and an optional group title on a card surface."},guidance:{doNotUseWhen:["Data needs column headers or multi-column comparison — use TableBasic","The goal is selecting multiple options — use CheckList or Input.Checkbox.Group","Hierarchical parent-child data — use NestedList","Options belong behind a trigger to save space — use MenuList or Input.Select","Static prose content — use typography (numbered/bulleted text), not ListItem"],useWhen:["Showing a set of related records upfront — reports, documents, payments, people — each as a title/caption row","Rows need per-item content or actions in leading/trailing slots (avatar, icon, buttons, labels, date)","Label-value detail rows on dashboards and summary surfaces (RightRenderer.PlainText for the value)","Navigate-to-detail rows with a trailing chevron icon and onClick","Grouping rows under a section title via ListItem.Layout title"]},antiPatterns:["Multiple related ListItems rendered without `ListItem.Layout`","Raw `Input.*` controls in `rightRenderer` instead of `RightRenderer` slots","`Card.Layout` or card body used as list grouping without `ListItem.Layout`","Custom `Layout.HStack`/`Layout` wrappers in `rightRenderer` instead of `RightRenderer` sub-components","`caption` used as the primary row label with no `title` (inverted anatomy)","Read-only values shown as text-style `RightRenderer.Buttons`","Custom `Text` JSX in `title` for de-emphasized label styling","Long captions with truncation disabled (`shouldTruncateCaption={false}`)","Bare `Icon` or `Button.Icon` with onClick in `rightRenderer` instead of `ListItem.RightRenderer.Icons`","`Layout.Box` or margin wrappers around `leftRenderer`/`rightRenderer` content — ListItem slots already own spacing and alignment"],aiGuardrails:[{guardrail:"When a row needs a trailing action (remove, edit, navigate), use the ListItem.RightRenderer.* anatomy (Icons for icon actions, Buttons for labeled actions) rather than a bare Icon/Button.Icon with onClick. Pass slot content directly to leftRenderer/rightRenderer without Layout.Box or margin wrappers; the slots own spacing and vertical alignment.",section:"Row actions and slot content"}],selection:{confusedWith:[{component:"TableBasic",distinguishBy:"ListItem rows have one flexible text block plus slots; use TableBasic when data needs aligned multi-column headers and scannable columns"},{component:"Card",distinguishBy:"Card is a standalone container for a self-contained chunk of content; ListItem is one row inside a grouped list wrapped in ListItem.Layout"},{component:"CheckList",distinguishBy:"CheckList is a multi-select control where every row is a checkbox/switch; ListItem displays content rows and may hold a checkbox only as a leading slot"},{component:"MenuList",distinguishBy:"MenuList is a dropdown/overlay menu of actions or navigation options; ListItem shows persisted content rows on the page surface"},{component:"DetailsCard",distinguishBy:"DetailsCard is a block for read-only label-value record display; use ListItem rows when you need custom leading/trailing slots or per-row actions"}]},relatedComponents:[{name:"ListItem.Layout",note:"Always wrap related ListItems in it; supplies group title, spacing, and dividers",relationship:["child"]},{name:"ListItem.LeftRenderer",note:"Leading slots: Avatar, Icon, Input.Checkbox — prefer these over hand-built Layout.Box wrappers",relationship:["child"]},{name:"ListItem.RightRenderer",note:"Trailing slots: PlainText, Text, Labels, Date, Buttons, Icons, Select — use instead of raw Input.* or custom Layout.HStack",relationship:["child"]},{name:"Avatar",note:"Common leading-slot content for people rows; use ListItem.LeftRenderer.Avatar",relationship:["complement"]},{name:"Icon",note:"Leading icon or trailing chevron for clickable navigate-to-detail rows",relationship:["complement"]},{name:"TableBasic",note:"Use when the same data needs column headers and multi-column scanning",relationship:["alternative"]},{name:"CheckList",note:"Use when the list's purpose is multi-selection rather than display",relationship:["alternative"]},{name:"MenuList",note:"Use for action/option menus hidden behind a trigger, not on-page content rows",relationship:["alternative"]}]},LoaderCard:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{isGridView:{description:"Display with margin for grid layouts. Default: false",type:"boolean"}},type:"object"},acceptsChildren:!1},LocationCard:{description:"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.",events:["edit","delete","click","action"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{actions:{description:'Array of action objects {id, label, icon}. Displayed as dropdown options. Emits "action" event with clicked action id',items:{additionalProperties:!1,properties:{icon:{description:'Icon name from Icon.TYPES (e.g. "EDIT", "DELETE")',type:"string"},id:{description:"Unique identifier for the action",type:"string"},label:{description:"Label text for the action",type:"string"}},required:["id","label"],type:"object"},type:"array"},location:{additionalProperties:!1,description:"Location object with nickname and address. Required for displaying location information",properties:{address:{additionalProperties:!1,description:"Address object with street, city, state, country, and zip",properties:{city:{anyOf:[{type:"string"},{type:"null"}],description:"City name"},country:{description:"Country code",type:"string"},countyName:{anyOf:[{type:"string"},{type:"null"}],description:"County name"},state:{anyOf:[{type:"string"},{type:"null"}],description:"State or province code"},streetLine1:{description:"Primary street address line",type:"string"},streetLine2:{anyOf:[{type:"string"},{type:"null"}],description:"Secondary street address line"},streetLine3:{anyOf:[{type:"string"},{type:"null"}],description:"Tertiary street address line"},streetLine4:{anyOf:[{type:"string"},{type:"null"}],description:"Quaternary street address line"},zip:{description:"Postal/ZIP code",type:"string"}},required:["streetLine1","country","zip"],type:"object"},nickname:{description:"Location nickname or display name",type:"string"}},required:["nickname","address"],type:"object"},minCardHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Minimum height of card. Number values are pixels. Default: 150"},selectedActionId:{description:'Bound state path for the selected action id. Written before "action" event fires',type:"string"},showDelete:{description:'Show delete button. Emits "delete" event when clicked. Default: false',type:"boolean"},showEdit:{description:'Show edit button. Emits "edit" event when clicked. Default: false',type:"boolean"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}],description:"Route destination for navigation. String URL or object with {path, openInNewTab}. Card renders as anchor when provided"}},required:["location"],type:"object"},acceptsChildren:!1,category:["card"],keywords:["location card","locationcard (card.location)","address card","office location","work location","physical address","location grid","address display","company locations","billing address","work location card"],anatomy:{parts:[{name:"Nickname title",required:!0,role:'Location nickname (e.g. "Work Main") rendered as the card title'},{name:"Address content",required:!0,role:"Formatted address built from the location.address object"},{name:"Actions",required:!1,role:"Optional onEdit/onDelete affordances, custom actions dropdown, or `to` navigation"}],summary:"A card surface with the location nickname as the title, the formatted address (street, city, state, zip, country) as the body, and optional edit/delete affordances or a dropdown of custom actions on the trailing edge. Passing `to` renders the card as a navigable link; typically arranged in a Card.Group grid with a trailing add card."},guidance:{doNotUseWhen:["Non-location content — use Card.Basic instead","Rendering a single country name or flag — use Atoms.Country instead","Scannable lists of many records — use ListItem or TableBasic instead","Address data entry — use the address form inputs, not a display card"],useWhen:["Displaying physical locations — offices, work sites, billing addresses — as cards (rare standalone; only a handful of webapp usages)","Location collections in a Card.Group grid with an add-location affordance","Address summaries that need edit/delete actions or navigation to a location detail page","Anywhere a nickname-plus-formatted-address pair is the primary unit of information"]},antiPatterns:["Physical locations rendered with Card.Basic or custom JSX instead of Card.Location","Deprecated Input.SelectableGroup location card renderer still in use","Location grids without Card.Group — inconsistent tile widths","Incomplete address objects — missing zip/country formatting","Edit/delete on location tiles implemented as manual icon rows"],selection:{confusedWith:[{component:"Card",distinguishBy:"Card.Basic renders arbitrary title/content; Card.Location is purpose-built for physical locations with nickname and formatted address — never hand-assemble address cards from Card.Basic"},{component:"Atoms.Country",distinguishBy:"Atoms.Country displays a country flag/name pair; Card.Location displays a full physical address with edit/navigation actions"},{component:"ListItem",distinguishBy:"ListItem is a scannable row for record lists; Card.Location is a tile for a small set of physical locations with edit/add affordances"}]},relatedComponents:[{name:"Card.Group",note:"Layout.Grid container for multiple location cards, usually with a trailing add card",relationship:["parent"]},{name:"Card",note:"Namespace; Card.Basic is the generic variant for non-location content",relationship:["parent"]},{name:"Atoms.Country",note:"Displaying a single country with flag, not a full address",relationship:["alternative"]},{name:"ListItem",note:"Row-based presentation when locations appear in a scannable list",relationship:["alternative"]}]},LottiePlayer:{description:"Plays Lottie animations (JSON-based vector animations). Use for animated illustrations, loading states, or decorative motion graphics. Supports SVG, Canvas, and HTML rendering. Provide either a path to a Lottie JSON file or the animation data directly through loadConfig.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{height:{description:"Height of the animation container",type:"string"},loadConfig:{additionalProperties:!1,description:"Semantic Lottie load configuration object",properties:{animationData:{additionalProperties:{},description:"Lottie animation JSON object. Required if path is not provided",propertyNames:{type:"string"},type:"object"},autoplay:{description:"Start playing automatically on load. Default: true",type:"boolean"},loop:{anyOf:[{type:"boolean"},{type:"number"}],description:"Loop animation. true for infinite, false for once, or number for specific count"},path:{description:"URL or relative path to the Lottie JSON animation file. Required if animationData is not provided",type:"string"},renderer:{description:"Rendering method for the animation. Default: svg",enum:["svg","canvas","html"],type:"string"}},type:"object"},width:{description:"Width of the animation container",type:"string"}},type:"object"},acceptsChildren:!1,category:["atom"],keywords:["lottie","lottie player","animation","animated illustration","loading animation","success animation","error state","empty state","json animation","motion","processing state"],anatomy:{parts:[{name:"Container",required:!0,role:"Sized parent element that determines the animation's dimensions"},{name:"Animation",required:!0,role:"Lottie .json asset loaded via loadConfig.path with autoplay/loop/renderer options"}],summary:"A sized parent container (the player fills it, so the parent must have dimensions) rendering a Lottie animation loaded via loadConfig: path to the .json asset plus playback options like autoplay, loop, and renderer ('svg' recommended). Exposes the AnimationItem for programmatic control."},guidance:{doNotUseWhen:["The animation exists in BrandBadge.TYPES — use BrandBadge instead","Static iconography — use Icon","GIF or hosted video content — use Video","Static illustrations — use Atoms.Image"],useWhen:["Playing Lottie .json files for loading, success, or error feedback","Animated illustrations in empty states, confirmations, or feature highlights","Programmatic playback control via the AnimationItem (speed, pause, seek, reverse)","One-off product-team Lottie files not in the BrandBadge.TYPES library"]},antiPatterns:["Pebble badge JSON paths via LottiePlayer instead of BrandBadge","`loadConfig` without `renderer: 'svg'`","Lottie without sized parent container","Meaningful animation without visible text or aria-live"],selection:{confusedWith:[{component:"BrandBadge",distinguishBy:"If the animation exists in BrandBadge.TYPES, use BrandBadge — it handles the Lottie setup; LottiePlayer is for one-off custom .json files"},{component:"Video",distinguishBy:"Video embeds hosted video with player controls; LottiePlayer plays lightweight vector animations for UI feedback"},{component:"Icon",distinguishBy:"Icon is static vector iconography; LottiePlayer is for animated illustrations"},{component:"Atoms.Image",distinguishBy:"Atoms.Image renders static assets; LottiePlayer renders motion — do not ship a static frame when the design calls for animation"}]},relatedComponents:[{name:"BrandBadge",note:"Pre-built Pebble badge animations; prefer over raw LottiePlayer when the type exists",relationship:["alternative"]},{name:"Video",note:"Hosted video content instead of vector animation",relationship:["alternative"]},{name:"Icon",note:"Static iconography when no motion is needed",relationship:["alternative"]},{name:"Atoms.Image",note:"Static illustration when no motion is needed",relationship:["alternative"]},{name:"Notice",note:"Feedback surfaces frequently pair a Lottie animation with Notice copy",relationship:["complement"]}]},Masker:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-label":{description:"Accessible label when no visible label",type:"string"},autoComplete:{description:"Browser autocomplete hint. Default: off",type:"string"},autoFocus:{description:"Auto-focus input on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},fixedCharsPrefix:{description:"Fixes characters at the beginning of the value",type:"string"},fixedCharsSuffix:{description:"Fixes characters at the end of the value",type:"string"},id:{description:"Explicit HTML element id",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isSensitive:{description:"Marks input as sensitive for privacy/security",type:"boolean"},label:{description:"Label text above the input",type:"string"},mask:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:'Mask pattern. Use 9 for digit, a for letter, * for any character. Can be string ("999-999-9999") or array of patterns (["99.9a-999", "99.99/99-9"]) for multi-mask support'},maxLength:{description:"Maximum character length",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character length",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},shouldEnforceUpperCase:{description:"Enforces uppercase on input characters",type:"boolean"},shouldSkipInitialFormatting:{description:"If true, skip applying mask on the default/initial value",type:"boolean"},shouldUnmaskValue:{description:"If true, onChange passes the unmasked value (without mask characters)",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current masked value bound to state",type:"string"}},required:["mask"],type:"object"},acceptsChildren:!1,category:["input"],keywords:["masker input","maskerinput","masked input","format pattern","EIN","employer identification number","UBI number","postal code","fixed format","tax id","structured data"],anatomy:{parts:[{name:"Label",required:!0,role:"Identifies the structured value; placeholder alone is not sufficient"},{name:"Masked field",required:!0,role:"Entry constrained to the mask pattern; literals auto-inserted while typing"},{name:"Helper/Error text",required:!1,role:"Format guidance; replaced by a descriptive error on validation failure"}],summary:"A label above a single-line text field that inserts mask literals (dashes, spaces) as the user types, blocking characters that do not fit the pattern; helper or error text appears below. Sensitive variants can hide entered digits."},guidance:{doNotUseWhen:["US Social Security Numbers — use Input.Ssn, which is purpose-built and sensitive by default","Canadian SINs — use Input.Sin","Phone numbers — use Input.Phone for region-aware formatting","Free-form or variable-length text — use Input.Text"],useWhen:["Fixed-format identifiers with a known, immutable pattern — EINs (99-9999999), UBI numbers, postal codes","Custom formatted codes where the structure should guide users as they type","Values that may match several patterns — pass an array of mask strings","Sensitive formatted IDs (EIN/tax) that should hide digits via isSensitive"]},antiPatterns:["SSN collected via Masker instead of dedicated SsnInput","Masked field uses placeholder as only visible label","Wrong validation rule paired with mask pattern (EIN rule on SSN)","EIN/tax mask field missing isSensitive in enrollment flows"],selection:{confusedWith:[{component:"Input.Ssn",distinguishBy:"US Social Security Numbers should use the purpose-built Input.Ssn (fixed XXX-XX-XXXX mask, sensitive by default) instead of a hand-configured Masker"},{component:"Input.Sin",distinguishBy:"Canadian Social Insurance Numbers should use Input.Sin (XXX XXX XXX) instead of a custom mask"},{component:"Input.Phone",distinguishBy:"Phone numbers should use Input.Phone for region-aware formatting; Masker suits only a single fixed phone pattern"},{component:"Input.Text",distinguishBy:"Text imposes no format; Masker is for known, immutable fixed-length patterns where structure guides entry"}]},relatedComponents:[{name:"Form",note:"Tax/vendor flows use Form.Input.Masker with validations (e.g. isValidEIN) inside a Form",relationship:["complement"]},{name:"Input.Ssn",note:"Purpose-built US SSN input — prefer it over a Masker SSN mask",relationship:["alternative"]},{name:"Input.Sin",note:"Purpose-built Canadian SIN input",relationship:["alternative"]},{name:"Input.Phone",note:"Purpose-built phone input with region-aware formatting",relationship:["alternative"]},{name:"Input.Text",note:"Free-form values without a fixed format",relationship:["alternative"]}]},MenuList:{description:"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.",events:["select"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{enableSeparator:{description:"Show bottom border between items. Default: false",type:"boolean"},isCompact:{description:"Render in compact mode",type:"boolean"},list:{description:"Array of menu items with label, value, and optional fields (secondaryLabel, tertiaryLabel, quaternaryLabel, rightLabel, description, leftIconType, type, tag, disabledInfo)",items:{additionalProperties:!1,properties:{description:{description:"Description text shown inline with the label",type:"string"},disabledInfo:{description:"Tooltip text shown for disabled items",type:"string"},isDisabled:{description:"Disables this menu item",type:"boolean"},label:{description:"Display text for the menu item",type:"string"},leftIconType:{description:"Icon name to show on the left side of the item",type:"string"},quaternaryLabel:{description:"Quaternary text shown below tertiary label",type:"string"},rightLabel:{description:"Text shown on the right side of the item",type:"string"},secondaryLabel:{description:"Secondary text shown below the label",type:"string"},tag:{description:"Tag label shown beside the item text",type:"string"},tertiaryLabel:{description:"Tertiary text shown below secondary label",type:"string"},type:{description:"Visual style type for the item (WARNING or ALERT)",enum:["WARNING","ALERT"],type:"string"},value:{description:"Unique value for the item",type:"string"}},required:["label","value"],type:"object"},type:"array"},maxHeight:{description:"Max height of the menu list in px. Default: 224",type:"number"},maxWidth:{description:"Maximum width in px",type:"number"},minWidth:{description:"Minimum width in px",type:"number"},searchable:{description:"Enable search within the menu list",type:"boolean"},selectedValues:{description:"Array of selected item values for highlighting",items:{type:"string"},type:"array"},width:{anyOf:[{type:"number"},{const:"auto",type:"string"}],description:'Width of the menu list in px or "auto". Default: 192'}},required:["list"],type:"object"},acceptsChildren:!1},Modal:{description:"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.",events:["close"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{animation:{description:'Modal animation type (e.g., "zoom", "fade"). Default: zoom',type:"string"},backdropAnimation:{description:'Backdrop animation type (e.g., "fade"). Default: fade',type:"string"},isFullScreen:{description:"If true, modal renders full screen. Default: false",type:"boolean"},isVisible:{description:"Controls modal visibility",type:"boolean"},shouldCloseOnBackdropClick:{description:"If true, modal closes when backdrop is clicked. Default: true",type:"boolean"},shouldCloseOnEscape:{description:"If true, modal closes on Escape key press. Defaults to shouldCloseOnBackdropClick value",type:"boolean"},shouldHideCancelIcon:{description:"If true, hides the close button in the header. Default: false",type:"boolean"},shouldNotAnimate:{description:"Disables open/close animation. Should be true if DataGrid is rendered as content",type:"boolean"},theme:{description:"Pre-defined modal styles. GRAY: gray background. NO_PADDING: removes body padding",enum:["GRAY","NO_PADDING"],type:"string"},title:{description:"Modal header title text",type:"string"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Custom modal width in px (number) or CSS string"}},type:"object"},acceptsChildren:!0,category:["overlays"],keywords:["modal","dialog","confirmation","confirm","popup","overlay","delete confirmation","alert dialog"],anatomy:{parts:[{name:"title",required:!0,role:"Accessible header text via the title prop; required for screen reader announcement"},{name:"body",role:"Main content passed as children; scrolls independently of the footer"},{name:"footer",required:!1,role:"Modal.Footer owning submit/cancel/destructive actions"},{name:"close",role:"Built-in dismiss control; never hide it on a dismissible modal"}],summary:"A centered overlay panel with a header (title prop + built-in close), a scrolling body for content, and a footer action region (Modal.Footer) pinned below the body."},guidance:{doNotUseWhen:["Long or multi-step forms — use a dedicated page or Drawer","Non-blocking contextual info — use Tip","Navigation between views — use pages and Anchor","Displaying API error payloads — format errors into readable copy first"],useWhen:["Confirming destructive or irreversible actions","Short focused tasks that must be completed or dismissed before continuing","Forms with 1-3 fields that belong to the current page context"]},antiPatterns:[{instead:"Place submit/cancel/destructive actions in Modal.Footer",pattern:"Action buttons rendered in the modal body instead of Modal.Footer",why:"Buttons scroll away with content and escape the modal's action region"},{instead:"Let the modal own the action region via Modal.Footer",pattern:"Form footer rendered inside the Modal body",why:"The action row scrolls with content instead of staying pinned"},{instead:"Always pass a concise title",pattern:"Modal without the title prop",why:"No accessible header or screen reader announcement"},{instead:"Use the title prop only",pattern:"Title text recreated in the body instead of the title prop",why:"Duplicates the header and loses the accessible name"},{instead:"Rely on the built-in close and onClose",pattern:"Custom close mechanism alongside or instead of the built-in dismiss",why:"Redundant or bypassed dismissal confuses keyboard and screen reader users"},{instead:"Keep the default close control visible",pattern:"Close icon hidden on a dismissible Modal",why:"Users lose a visible escape path"},{instead:'State the consequence in the title and use a verb-led CTA like "Delete chart"',pattern:'Confirmation copy uses vague "Are you sure?" with yes/no CTAs',why:"Users must re-read to know what is being confirmed"},{instead:"Map errors to user-readable messages",pattern:"Raw API error data rendered in Modal content",why:"Exposes internals and unreadable copy"},{instead:"Compose with Modal.Footer",pattern:"Direct ModalFooter subpath import",why:"Bypasses the compound component contract"},{instead:"Route all copy through translations",pattern:"Untranslated English text in titles and action labels",why:"Breaks i18n coverage"}],aiGuardrails:[{guardrail:"When a Form or other interactive component is embedded in Modal, check whether the modal owns the action region. Prefer `Modal.Footer` for submit, cancel, and destructive actions instead of adding action buttons inside the body.",section:"Modal footer actions"}],propGuidance:[{guidance:'Always provide it; this is the accessible name. For confirmations, state the consequence ("Delete this chart?") rather than "Are you sure?".',prop:"title"},{guidance:"Control from parent state; close via onClose after the action resolves, not before async work completes.",prop:"isOpen"},{guidance:"Use the smallest size that fits the content; confirmations should stay small.",prop:"size"}],selection:{confusedWith:[{component:"Drawer",distinguishBy:"Drawer is for side-panel tasks that coexist with page content; Modal blocks the page for a focused decision or short task."},{component:"Tip",distinguishBy:"Tip is non-blocking contextual content anchored to an element; Modal is blocking and centered."},{component:"ActionCard",distinguishBy:"ActionCard is inline empty-state/next-step content on the page; Modal interrupts the flow."},{component:"Notice",distinguishBy:"Notice is passive inline feedback; Modal demands a decision."}]},relatedComponents:[{name:"Modal.Footer",note:"Owns the action region",relationship:["child"]},{name:"Modal.Header",note:"Custom header when the title prop is not enough",relationship:["child"]},{name:"Drawer",note:"Non-blocking side panel for larger tasks",relationship:["alternative"]},{name:"Button",note:"Footer actions; DESTRUCTIVE appearance belongs here",relationship:["complement"]},{name:"Form",note:"Embedded forms should still let Modal.Footer own actions",relationship:["complement"]}],subComponents:{"Modal.Footer":{description:"Pinned action region for modal submit/cancel/destructive buttons.",guidance:{doNotUseWhen:["Purely informational modals with only a close control"],useWhen:["Any modal with actions the user must take"]}}}},ModalCloseButton:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Button visual style. Default: OUTLINE",enum:["ACCENT","ACTIVE","PRIMARY","DESTRUCTIVE","SUCCESS","INFO","WARNING","OUTLINE","SOLID","GHOST"],type:"string"},isDisabled:{description:"If true, disables the button. Default: false",type:"boolean"},label:{description:'Button label text. Default: "Cancel"',type:"string"},size:{description:"Button size. L, M, S, or XS. Default: M",enum:["L","M","S","XS"],type:"string"}},type:"object"},acceptsChildren:!1},ModalFooter:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{bottomSpacing:{description:"Custom bottom spacing token. Default: modal footer height",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},placement:{description:"Button alignment: right-aligned or space-between. Default: right",enum:["right","space-between"],type:"string"},shouldBeSticky:{description:"If true, the footer will be sticky at the bottom of the modal",type:"boolean"},shouldHaveStickyOffset:{description:"If true, adds offset for sticky positioning. Default: true",type:"boolean"}},type:"object"},acceptsChildren:!0},NestedList:{description:"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.",events:["toggle","select"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{depth:{description:"Current node depth in nested tree. Default: 0",type:"number"},indent:{description:"Indentation per nesting level in px. Default: 32",type:"number"},list:{description:"Array of nested tree items: {label, value?, branches?}",items:{$ref:"#/$defs/NestedListItem"},type:"array"},selectedValue:{description:"Currently selected item value. Bind to state for tracking",type:"string"},showMore:{additionalProperties:!1,description:"Configuration for show more behavior",properties:{size:{description:'Number of items to show initially before "show more"',type:"number"}},required:["size"],type:"object"},theme:{description:"ExpansionPanel theme variant",enum:["NO_CARD","TRANSPARENT_NO_SEPARATOR","TRANSPARENT_NO_SEPARATOR_NO_CARD"],type:"string"},title:{description:"Title for the nested list",type:"string"},toggleIcon:{additionalProperties:!1,description:"Toggle icon configuration",properties:{align:{description:"CSS alignSelf value. Default: center",type:"string"},margin:{description:"Margin spacing token for icon alignment",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},size:{description:"Icon size token. Default: 24",enum:["sizeIcon2xl","sizeIcon2xs","sizeIcon3xl","sizeIcon3xs","sizeIcon4xl","sizeIconLg","sizeIconMd","sizeIconSm","sizeIconXl","sizeIconXs"],type:"string"}},type:"object"}},required:["list"],type:"object"},acceptsChildren:!1,category:["dataDisplay"],keywords:["nested list","nestedlist","tree","tree view","hierarchy","hierarchical data","expandable list","collapsible","org structure","categories subcategories","parent child"],anatomy:{parts:[{name:"title",required:!1,role:"Optional header for the whole tree"},{name:"parent row",required:!0,role:"Expandable/collapsible branch row with chevron toggle"},{name:"child rows",required:!1,role:"Nested items under branches, indented per depth level"},{name:"renderer",required:!0,role:"Custom JSX per item; receives item, depth, and collapse state"},{name:"showMore",required:!1,role:"Truncates long branches behind a show-more link"}],summary:"A card (optional, per theme) with a title and rows arranged as an indented tree: parent rows carry a chevron to expand/collapse their branches, children indent one level at a time (configurable via indent), long branches collapse behind a show-more affordance, and each row's content comes from a custom renderer."},guidance:{doNotUseWhen:["Flat single-level data — use ListItem with ListItem.Layout","Selecting a value from a hierarchy in a form — use Input.Tree","Multi-select with checkboxes on nested options — use CheckList","Single-level expandable content — use ExpansionPanel","Primary product navigation — use Tabs with Breadcrumb","Large scannable columnar datasets — use TableBasic"],useWhen:["Displaying true hierarchical data — org structures, department trees, permission or category nesting","Multi-level data where each branch should expand/collapse independently","Row content needs custom JSX per item via the renderer prop","Explainability/debug trees and grouped record details in superuser or admin surfaces"]},antiPatterns:["Theme prop omitted — default card chrome appears in wrong contexts","Row actions implemented as bare clickable icons","`stopPropagation` on row wrappers blocks tree keyboard behavior","Hardcoded inline styles in custom renderers","NestedList used for flat, single-level data","Show-more truncation effectively disabled","Heavy inline editing embedded inside row renderers","`getCurrentTheme()` used instead of `useTheme()` in renderers","Icon actions with vague `aria-labelledby` references","NestedList used as a navigate-to-detail list pattern"],selection:{confusedWith:[{component:"Input.Tree",distinguishBy:"Input.Tree is a form input for picking a value from a tree; NestedList is a read-oriented display of hierarchical data with custom row content"},{component:"ExpansionPanel",distinguishBy:"ExpansionPanel expands a single level of content; NestedList renders multi-level parent-child trees with indentation and per-branch toggles"},{component:"ListItem",distinguishBy:"ListItem.Layout handles flat single-level rows; NestedList is only worth it when data actually nests two or more levels"},{component:"CheckList",distinguishBy:"CheckList nests items for multi-select with checkboxes and indeterminate parents; NestedList rows are display content, not selection controls"},{component:"TableBasic",distinguishBy:"TableBasic suits large scannable datasets viewed horizontally in columns; NestedList keeps multi-level info as indented labels instead of columns"}]},relatedComponents:[{name:"ListItem",note:"Commonly rendered inside the NestedList renderer for structured row content",relationship:["complement"]},{name:"Icon",note:"Row glyphs and toggle indicators; give icon actions explicit accessible names",relationship:["complement"]},{name:"Card",note:"Default theme supplies card chrome; pick a NO_CARD/TRANSPARENT theme on custom backgrounds",relationship:["complement"]},{name:"Input.Tree",note:"Use when the user must select a node from the hierarchy as form input",relationship:["alternative"]},{name:"ExpansionPanel",note:"Use for single-level expandable sections",relationship:["alternative"]},{name:"ListItem",note:"Use ListItem.Layout for flat, non-hierarchical lists",relationship:["alternative"]},{name:"CheckList",note:"Use when nested items exist to be multi-selected, not just displayed",relationship:["alternative"]},{name:"Tabs",note:"Use link tabs plus breadcrumbs for product navigation; NestedList is not primary navigation",relationship:["alternative"]}]},Number:{description:"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.",events:["change","blur","changeRaw","changeCalculationState"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},autoComplete:{description:'Browser autocomplete hint. Default: "off"',type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},decimalPlaces:{description:"Number of decimal places. Default: 2",type:"number"},defaultValue:{anyOf:[{type:"string"},{type:"number"}],description:"Initial default value for uncontrolled usage"},isDisabled:{description:"Disables the input",type:"boolean"},isIntegerOnly:{description:"Restrict to integer values only",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:'Locale string for number formatting (e.g. "en-US", "de-DE")',type:"string"},max:{description:"Maximum allowed value",type:"number"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},min:{description:"Minimum allowed value. Default: 0",type:"number"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text prefix inside the input",type:"string"},shouldAllowCalculation:{description:"If true, input allows arithmetic operators and evaluates on blur",type:"boolean"},shouldDisableFormatting:{description:"If true, number formatting will not be applied. Default: true",type:"boolean"},shouldDisableRedundantZeroFormatting:{description:"If true, redundant zeros are preserved. Default: true",type:"boolean"},shouldStripLeadingZeros:{description:"If true, leading zeros are stripped from the numeric value",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},step:{description:"Increment/decrement step size. Default: 1",type:"number"},stringPadding:{additionalProperties:!1,description:"Adds padding characters to the input value",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Position to pad (start or end)",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text suffix inside the input",type:"string"},theme:{description:"Predefined visual theme",enum:["DARK","INLINE_DATE_DAY","INLINE_DATE_MONTH","INLINE_DATE_YEAR","INLINE_SELECT_SEARCH","INLINE_TEXT","INLINE_TIME","INLINE_TIME_WITH_SECONDS","ITALIC_FONT","INLINE_SELECT_SEARCH_DARK","INLINE_SELECT_SEARCH_INLINE_DATE_DAY","INLINE_SELECT_SEARCH_INLINE_DATE_YEAR","INLINE_SELECT_SEARCH_INLINE_TEXT","INLINE_SELECT_SEARCH_ITALIC_FONT","NO_BOX","NO_BOX_INLINE_SELECT_SEARCH","NO_BOX_DARK","NO_BOX_INLINE_DATE_DAY","NO_BOX_INLINE_DATE_YEAR","NO_BOX_INLINE_TEXT","NO_BOX_ITALIC_FONT","NO_BOX_INLINE_SELECT_SEARCH_DARK","NO_BOX_INLINE_SELECT_SEARCH_INLINE_DATE_DAY","NO_BOX_INLINE_SELECT_SEARCH_INLINE_DATE_YEAR","NO_BOX_INLINE_SELECT_SEARCH_INLINE_TEXT","NO_BOX_INLINE_SELECT_SEARCH_ITALIC_FONT","NO_PADDING_NO_BOX_INLINE_SELECT_SEARCH","NO_PADDING_NO_BOX_INLINE_TIME","NO_PADDING_NO_BOX_INLINE_TIME_WITH_SECONDS","NO_PADDING_RIGHT_NO_BOX_DARK","NO_PADDING_NO_BOX_INLINE_DATE_MONTH","NO_PADDING_NO_BOX_INLINE_DATE_YEAR","NO_PADDING_RIGHT_NO_BOX_INLINE_TEXT","NO_PADDING_RIGHT_NO_BOX_ITALIC_FONT","NO_PADDING_RIGHT_NO_BOX_INLINE_SELECT_SEARCH_DARK","NO_PADDING_NO_BOX_INLINE_SELECT_SEARCH_INLINE_DATE","NO_PADDING_RIGHT_NO_BOX_INLINE_SELECT_SEARCH_INLINE_DATE_YEAR","NO_PADDING_RIGHT_NO_BOX_INLINE_SELECT_SEARCH_INLINE_TEXT","NO_PADDING_RIGHT_NO_BOX_INLINE_SELECT_SEARCH_ITALIC_FONT","NO_PADDING_LEFT_NO_BOX_INLINE_SELECT_SEARCH","NO_PADDING_LEFT_NO_BOX_DARK","NO_PADDING_NO_BOX_INLINE_DATE_DAY","NO_PADDING_LEFT_NO_BOX_INLINE_TEXT","NO_PADDING_LEFT_NO_BOX_ITALIC_FONT","NO_PADDING_LEFT_NO_BOX_INLINE_SELECT_SEARCH_DARK","NO_PADDING_LEFT_NO_BOX_INLINE_SELECT_SEARCH_INLINE_DATE_DAY","NO_PADDING_LEFT_NO_BOX_INLINE_SELECT_SEARCH_INLINE_TEXT","NO_PADDING_LEFT_NO_BOX_INLINE_SELECT_SEARCH_ITALIC_FONT","NO_PADDING_NO_BOX_INLINE_TEXT"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Current numeric value bound to state"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["number input","numberinput","numeric","quantity","count","stepper","integer","decimal","threshold","duration","days","min max","settings"],anatomy:{parts:[{name:"Label",required:!0,role:"Describes the field's purpose; mandatory unless exempted"},{name:"Input field",required:!0,role:"Numeric entry; supports min/max, step, decimalPlaces, and formatting"},{name:"Prefix/Suffix",required:!1,role:"Unit or symbol shown beside the value (e.g. days, minutes)"},{name:"Helper text",required:!1,role:"Context and format guidance under the field; replaced by error text"}],summary:"A label (mandatory, with required asterisk) above a single-line numeric field with an optional prefix or suffix (e.g. 'days', '%'); helper text or a help-icon tooltip sits below and is replaced by error text on validation failure. Arrow keys step the value by the configured increment."},guidance:{doNotUseWhen:["Monetary amounts — use Input.Currency for symbol prefix and currency-type selection","Percentage values — use Input.Percentage for the automatic % suffix and bounds","Continuous variables with exact values in a wide range (prices, distances) — use Input.Text","Imprecise selection within a bounded range — use Input.Slider"],useWhen:["Collecting whole or decimal numbers — quantities, counts, thresholds, durations, notice periods","Users adjust small values incrementally with Up/Down arrow keys","Locale-aware number formatting or fixed decimal places are needed","Numeric fields inside a settings or policy form (use Form.Input.Number within a Form)"]},antiPatterns:["Range limits set via `min`/`max` props instead of Form validation","Standalone number field missing an accessible name","Monetary amounts collected via Number with prefix instead of Currency input","Numeric data-entry fields built outside Form, bypassing integrated validation","Error styling on number fields without an inline error message","Legacy `INPUT_SIZES` constant used instead of `Input.Text.SIZES`","Raw number input placed in ListItem `rightRenderer` instead of slot pattern","Plain numeric entry forced through text input instead of `Input.Number`"],selection:{confusedWith:[{component:"Input.Currency",distinguishBy:"Currency is for monetary amounts and shows a currency symbol prefix plus optional currency-type selector; Number is for unitless counts, quantities, and measurements"},{component:"Input.Percentage",distinguishBy:"Percentage adds an automatic % suffix with lower/upper bounds; use Number only for non-percentage numeric values"},{component:"Input.Text",distinguishBy:"For continuous variables where the exact value matters across a wide range (prices, distances), docs recommend a text input; Number suits constrained, step-able values"},{component:"Input.Slider",distinguishBy:"Slider is for imprecise selection within a bounded range; Number is for entering an exact numeric value"}]},relatedComponents:[{name:"Form",note:"Multi-field data entry with validation uses Form.Input.Number inside a Form, not standalone Input.Number",relationship:["complement"]},{name:"Input.Currency",note:"Monetary amounts with currency symbol and type selection",relationship:["alternative"]},{name:"Input.Percentage",note:"Percentage values with automatic % suffix and bounds",relationship:["alternative"]},{name:"Input.Text",note:"Continuous variables (prices, distances) where exact wide-range values matter",relationship:["alternative"]},{name:"Input.Slider",note:"Imprecise value selection within a bounded range",relationship:["alternative"]}]},ObjectListView:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{objectApiName:{type:"string"}},required:["objectApiName"],type:"object"},acceptsChildren:!1},ObjectUI:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the header",properties:{icon:{description:"Icon type string when type is ICON",type:"string"},image:{description:"Image URL for the avatar",type:"string"},imageBackground:{description:"Surface color token for avatar image background",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},isRound:{description:"If false, square avatar is shown. Default: true",type:"boolean"},type:{description:"Avatar content type",enum:["USER","ICON","TEXT","NUMBER","RIPPLING"],type:"string"}},type:"object"},caption:{description:"Header caption text below the title",type:"string"},title:{description:"Header title text",type:"string"}},type:"object"},acceptsChildren:!0},ObjectUIContent:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!0,category:["layout"],keywords:["object ui content","details body","entity details section","record content","content panel","object body","detail section","objectui"],anatomy:{parts:[{name:"Content area",required:!0,role:"Free-form JSX detail content for the entity (grids, text, custom visualizations)"},{name:"Border-radius theme",required:!1,role:"THEMES.NO_BORDER_RADIUS / TOP / BOTTOM / BORDER_RADIUS controlling how the section stacks"}],summary:"A bordered, padded section that stacks below ObjectUI.Header and ObjectUI.Stats inside ObjectUI.Template, holding arbitrary JSX detail content. The theme prop controls corner rounding (NO_BORDER_RADIUS by default inside a Template, BORDER_RADIUS standalone) so stacked sections join seamlessly."},guidance:{doNotUseWhen:["Content is simple label-value pairs — use ObjectUI.Stats","Building the entity title row or actions — use ObjectUI.Header","Outside ObjectUI.Template as a generic panel — use Card.Layout","Wrapping Header or Stats inside Content — they are direct Template children"],useWhen:["An ObjectUI.Template needs free-form detail sections below the Header and Stats","Stacking multiple content sections on one record (use themes to control corner radius)","Wrapping custom JSX (grids, visualizations, forms) in the ObjectUI bordered-section styling"]},antiPatterns:["Header and Stats wrapped inside Content","Entity title row built inside Content instead of Header","Content placed before Header in Template","Content used outside Template as pseudo entity layout"],selection:{confusedWith:[{component:"ObjectUI.Stats",distinguishBy:"ObjectUI.Stats is the structured label-value cell grid; ObjectUI.Content is for free-form JSX sections that are not simple key-value pairs"},{component:"Card.Layout",distinguishBy:"Card.Layout is a generic card arrangement for any content; ObjectUI.Content is the ObjectUI-aware body section whose border-radius themes stack with Header and Stats"},{component:"ObjectUI.Header",distinguishBy:"ObjectUI.Header owns the entity title row, avatar, and actions; do not rebuild a title row inside Content"}]},relatedComponents:[{name:"ObjectUI.Template",note:"Content sections belong inside a Template, below Header and Stats",relationship:["parent"]},{name:"ObjectUI.Header",note:"Entity title and actions; always above Content, never inside it",relationship:["complement"]},{name:"Layout.Grid",note:"Organize Content children with a grid and even spacing",relationship:["complement"]},{name:"ObjectUI.Stats",note:"Use Stats instead when the content is simple label-value pairs",relationship:["alternative"]},{name:"Card.Layout",note:"Generic card container for content outside an ObjectUI entity view",relationship:["alternative"]}]},ObjectUIHeader:{description:"Header section of an entity overview (person, organization, device) displaying an avatar, title, caption, optional label chip, and an optional primary action. Used at the top of ObjectUI layouts to identify the entity at a glance.",events:["primaryAction"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the header",properties:{icon:{description:"Icon type string when type is ICON",type:"string"},image:{description:"Image URL for the avatar",type:"string"},imageBackground:{description:"Surface color token for avatar image background",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},isRound:{description:"If false, square avatar is shown. Default: true",type:"boolean"},type:{description:"Avatar content type",enum:["USER","ICON","TEXT","NUMBER","RIPPLING"],type:"string"}},type:"object"},caption:{description:"Header caption text below the title",type:"string"},label:{additionalProperties:!1,description:"Label chip displayed next to the title",properties:{appearance:{description:"Label appearance. Default: NEUTRAL",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},children:{description:"Label text displayed in the chip",type:"string"},leftIcon:{anyOf:[{description:"Icon type string to render inside the label",type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of the element describing the icon",type:"string"},"aria-label":{description:"Accessible label for the icon",type:"string"},"aria-labelledby":{description:"ID of the element labelling the icon",type:"string"},color:{description:"Optional icon color value",type:"string"},type:{description:"Icon type string to render inside the label",type:"string"}},required:["type"],type:"object"}],description:"Left icon shown inside the label"},maxWidth:{description:"Maximum label width as a CSS value",type:"string"},rightIcon:{anyOf:[{description:"Icon type string to render inside the label",type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of the element describing the icon",type:"string"},"aria-label":{description:"Accessible label for the icon",type:"string"},"aria-labelledby":{description:"ID of the element labelling the icon",type:"string"},color:{description:"Optional icon color value",type:"string"},type:{description:"Icon type string to render inside the label",type:"string"}},required:["type"],type:"object"}],description:"Right icon shown inside the label"},size:{description:"Label size. Default: LARGE",enum:["SMALL","MEDIUM","LARGE","EXTRA_LARGE"],type:"string"},tip:{description:"Tooltip text for the label. String tip content only in SDUI",type:"string"}},type:"object"},primaryAction:{additionalProperties:!1,description:"Primary action button. Clicking it emits the primaryAction event",properties:{icon:{description:"Icon type string for the primary button",type:"string"},label:{description:"Label of the primary button",type:"string"},size:{description:"Primary button size. Default: M",enum:["L","M","S","XS"],type:"string"}},required:["label"],type:"object"},primaryActionLabel:{description:"Deprecated. Use primaryAction.label instead for the primary action button text",type:"string"},title:{description:"Header title text",type:"string"}},type:"object"},acceptsChildren:!1,category:["complex"],keywords:["object ui header","record header","profile header","details page","entity title","object header","header actions","overflow actions","avatar title","status label","objectui"],anatomy:{parts:[{name:"Avatar",required:!1,role:"Entity image or icon; round for people, square for non-person entities"},{name:"Title",required:!0,role:"Plain-string entity name; do not pass React components"},{name:"Label",required:!1,role:"Status chip with semantic appearance (e.g. Label.APPEARANCES.SUCCESS)"},{name:"Caption / subtext",required:!1,role:"Secondary context line under the title"},{name:"Actions",required:!1,role:"Record-level buttons/icons from actions.list; items past actions.limit overflow into a dropdown"},{name:"Primary action",required:!1,role:"Single most important action via primaryAction, rendered with primary emphasis"}],summary:"Avatar on the left (round for people, square via avatarProps.isRound=false, or icon-based), a middle column with title, optional status Label, and caption/subtext, and an actions area on the right. All actions go in actions.list (or primaryAction for the single most important one); actions beyond the limit overflow into a dropdown."},guidance:{doNotUseWhen:["Page-level titles or navigation — use Page.Header","A simple title with caption and no actions or avatar — use Atoms.TitleCaption","Outside ObjectUI.Template — it is designed to stack with Stats and Content","Hand-placing standalone buttons next to the header — put every action in actions.list"],useWhen:["Top of an ObjectUI.Template for an entity detail view (profile, company, device, invoice)","The record has global-level actions that need managed overflow into a dropdown","The header needs an avatar and/or a semantic status label alongside the title","Icon-only actions need tooltip/overflow text via the action's description prop"]},antiPatterns:["Deprecated `tip` used on header actions instead of `description`","Icon actions missing accessible label","Header nested inside Content instead of direct Template child","React components passed to the title prop","Status label chip without semantic appearance","Icon actions missing `description` for tooltip and overflow text","Primary header action split into `primaryAction` while other actions use `actions.list`","Header rendered outside `ObjectUI.Template`"],aiGuardrails:[{details:["Use the `actions` prop for all buttons rendered in `ObjectUI.Header`. Do not add standalone buttons next to, above, below, or outside the header to represent object-level actions.","The `actions.list` array is the canonical action model for `ObjectUI.Header`. It controls action placement, ordering, and overflow behavior. Include primary and secondary object-level actions in this array so the component can manage responsive overflow correctly.","When a header has a primary action, put it first in `actions.list`. Prefer at most one primary action per `ObjectUI.Header`; additional actions should be secondary, tertiary or outline. Use the component's documented action props to express emphasis rather than bypassing the action list.","Do not use `primaryAction` unless the ObjectUI.Header documentation explicitly says this pattern should bypass `actions.list`."],guardrail:"Never hand-place header buttons for `ObjectUI.Header`. Always put every header button in `actions.list`, including the most important action. This preserves the component's overflow behavior.",section:"Header actions"}],selection:{confusedWith:[{component:"Page.Header",distinguishBy:"Page.Header is page-level chrome (breadcrumbs, page title) for the whole page; ObjectUI.Header is the record-level identity and action bar inside an ObjectUI.Template"},{component:"Atoms.TitleCaption",distinguishBy:"Atoms.TitleCaption is a simple title-plus-caption text pairing; ObjectUI.Header adds avatar, status label, and a managed action list with overflow"},{component:"ListItem",distinguishBy:"ListItem represents one row in a homogeneous list of records; ObjectUI.Header tops the detail view of a single record with record-level actions"}]},relatedComponents:[{name:"ObjectUI.Template",note:"Always render Header as the direct first child of ObjectUI.Template",relationship:["parent"]},{name:"ObjectUI.Stats",note:"Stats grid placed directly below the Header",relationship:["complement"]},{name:"ObjectUI.Content",note:"Content sections below Header and Stats",relationship:["complement"]},{name:"Avatar",note:"Configured through avatarProps (image, icon, isRound)",relationship:["complement"]},{name:"Label",note:"Status chip via the label prop; use a semantic appearance",relationship:["complement"]},{name:"Page.Header",note:"Page-level title and breadcrumbs instead of a record header",relationship:["alternative"]},{name:"Atoms.TitleCaption",note:"Plain title/caption text when no avatar or actions are needed",relationship:["alternative"]}]},ObjectUIStats:{description:"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.",events:["actionClick"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{actionClickedId:{description:"Stores the id of the clicked action. Bind to state path to access in actionClick event handler",type:"string"},actions:{description:"Array of action buttons displayed at the bottom of the grid. Each action emits actionClick event with id in state",items:{additionalProperties:!1,properties:{"aria-label":{description:"Accessibility label for the action button",type:"string"},"aria-labelledby":{description:"ID of element that labels the action button",type:"string"},color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},iconType:{description:'Icon type name (e.g., "EDIT_OUTLINE", "DELETE")',type:"string"},id:{description:"Unique identifier for this action. Written to state on click",type:"string"},isDisabled:{description:"Disable the action button. Default: false",type:"boolean"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Force tooltip to always be visible",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip"},placement:{description:"Tooltip placement position",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip for the action button. Can be a simple string or tooltip configuration object"}},required:["id","iconType"],type:"object"},type:"array"},list:{description:"Array of cells to display in the stats grid. Each cell has a label and renderer with props",items:{anyOf:[{additionalProperties:!1,properties:{label:{anyOf:[{type:"string"},{type:"number"}],description:"Label displayed in the cell header. String or number value"},props:{additionalProperties:!1,description:"Props passed to LabelRenderer. Icon colors must be Pebble text/icon color tokens.",properties:{appearance:{description:"Color scheme of the label. Default: NEUTRAL",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},children:{description:"Text content of the label",type:"string"},leftIcon:{anyOf:[{description:'Icon type name (e.g., "CHECK_CIRCLE_OUTLINE", "HIGH_PRIORITY")',type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token. Only applicable for TRANSPARENT appearance",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name",type:"string"}},required:["type"],type:"object"}],description:"Icon displayed on the left side of the label"},maxWidth:{description:"Maximum width CSS value for truncation",type:"string"},rightIcon:{anyOf:[{description:'Icon type name (e.g., "CHECK_CIRCLE_OUTLINE", "HIGH_PRIORITY")',type:"string"},{additionalProperties:!1,properties:{"aria-describedby":{description:"ID of element that describes this icon",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this icon",type:"string"},color:{description:"Pebble text/icon color token. Only applicable for TRANSPARENT appearance",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},type:{description:"Icon type name",type:"string"}},required:["type"],type:"object"}],description:"Icon displayed on the right side of the label"},size:{description:"Size of the label. Default: LARGE",enum:["SMALL","MEDIUM","LARGE","EXTRA_LARGE"],type:"string"},text:{description:"Text content of the label. Converted to children for LabelRenderer.",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},className:{description:"CSS class name for tooltip",type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when document scrolls. Default: false",type:"boolean"},isDelayed:{description:"Add 300ms delay before showing tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning (relative to viewport). Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from parent component",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip content"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip content"},onlyIfChildOverflow:{description:"Only show tooltip if any child content overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if content overflows. Default: false",type:"boolean"},overwriteMiddleware:{description:"Overwrite default floating-UI middleware. Default: false",type:"boolean"},padding:{description:"CSS padding value for tooltip content",type:"string"},placement:{description:"Tooltip placement relative to label. Default: TOP_START",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"},shallSkipOverflowY:{description:"Skip overflow check on Y axis. Default: false",type:"boolean"},tipHideDelay:{description:"Milliseconds to wait before hiding tooltip (when isDelayed is true)",type:"number"},tipShowDelay:{description:"Milliseconds to wait before showing tooltip (when isDelayed is true)",type:"number"},title:{description:"Tooltip title text",type:"string"},truncateClassName:{description:"CSS class when onlyIfOverflow is enabled",type:"string"}},required:["content"],type:"object"}],description:"Tooltip shown on hover. Can be simple string or object with appearance, placement, and other options"}},type:"object"},renderer:{const:"LABEL",description:"Renderer type for the cell value. LABEL renders a Label component.",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Force tooltip to always be visible",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip"},placement:{description:"Tooltip placement position",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip for the cell label. Can be a simple string or tooltip configuration object"}},required:["label","renderer","props"],type:"object"},{additionalProperties:!1,properties:{label:{anyOf:[{type:"string"},{type:"number"}],description:"Label displayed in the cell header. String or number value"},props:{additionalProperties:{},description:"Props passed to TextRenderer: { value, color? }. Color must be a Pebble text/icon color token.",properties:{color:{description:"Pebble text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Text value to display"}},required:["value"],type:"object"},renderer:{const:"TEXT",description:"Renderer type for the cell value. TEXT displays plain text. Default: TEXT",type:"string"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tooltip appearance style",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip content text",type:"string"},isVisible:{description:"Force tooltip to always be visible",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum height for tooltip"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum width for tooltip"},placement:{description:"Tooltip placement position",enum:["TOP","TOP_START","TOP_END","BOTTOM","BOTTOM_START","BOTTOM_END","LEFT","LEFT_START","LEFT_END","RIGHT","RIGHT_START","RIGHT_END"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip for the cell label. Can be a simple string or tooltip configuration object"}},required:["label","props"],type:"object"}]},type:"array"}},required:["list"],type:"object"},acceptsChildren:!1,category:["complex"],keywords:["object ui stats","key value grid","stats row","label value","record stats","entity attributes","details grid","metadata row","stat cells","objectui"],anatomy:{parts:[{name:"Stat item",required:!0,role:"One labeled data point in the grid"},{name:"Key (label)",required:!0,role:"Plain-string caption naming the data point; do not pass JSX"},{name:"Value",required:!0,role:"Rendered cell content via TextRenderer, LabelRenderer, or a custom renderer"},{name:"Tooltip",required:!1,role:"Optional per-cell explanatory tip"},{name:"UI actions",required:!1,role:"Optional icon-button actions along the stats grid; each needs an accessible label"}],summary:"A wrapping grid of stat cells; each cell shows a small label (key) above a rendered value. Cells use a built-in renderer — TextRenderer for plain text via props.value, LabelRenderer for a semantic Label chip via props.children — or a custom render function. An optional tooltip (tip) explains a cell, and icon-button actions can run along the grid. Border-radius themes control corner rounding when stacking between Header and Content."},guidance:{doNotUseWhen:["Content is not simple label-value pairs — use ObjectUI.Content with free-form JSX","Standalone read-only record details outside ObjectUI — use DetailsCard","Communicating status as plain text — use LabelRenderer with a semantic appearance, not TextRenderer","Rich JSX inside a TextRenderer value — use a custom renderer or ObjectUI.Content"],useWhen:["Highlighting a record's key attributes as short label-value pairs in an ObjectUI summary","Status values that read better as semantic Label chips (use LabelRenderer with appearance)","Secondary/tertiary stats sections stacked between Header and Content (use themes for corner radius)","Cells need a small tooltip explaining the value (tip)"]},antiPatterns:["Rich JSX injected into TextRenderer value","LabelRenderer without semantic appearance","Status communicated via TextRenderer not Label","JSX passed as cell label instead of string"],selection:{confusedWith:[{component:"DetailsCard",distinguishBy:"DetailsCard is a standalone read-only label-value card section; ObjectUI.Stats is the inline stats strip inside an ObjectUI.Template summary, with renderer-based cells and stacking themes"},{component:"ObjectUI.Content",distinguishBy:"ObjectUI.Content holds free-form JSX detail content; ObjectUI.Stats is the structured label-value cell grid driven by the list prop and renderers"},{component:"DistributionBar",distinguishBy:"DistributionBar visualizes proportional segments of a whole; ObjectUI.Stats presents discrete labeled attribute values for one record"}]},relatedComponents:[{name:"ObjectUI.Stats.Renderer.TextRenderer",note:"Built-in renderer for plain text values via props.value",relationship:["child"]},{name:"ObjectUI.Stats.Renderer.LabelRenderer",note:"Built-in renderer for status chips; pass appearance for semantic color",relationship:["child"]},{name:"ObjectUI.Template",note:"Stats sits between ObjectUI.Header and ObjectUI.Content inside the Template",relationship:["parent"]},{name:"Label",note:"Rendered by LabelRenderer for status values; always set a semantic appearance",relationship:["complement"]},{name:"DetailsCard",note:"Standalone read-only label-value display outside an ObjectUI summary",relationship:["alternative"]},{name:"ObjectUI.Content",note:"Free-form content sections when cells are not simple label-value pairs",relationship:["alternative"]}]},ObjectUITemplate:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!0,category:["layout"],keywords:["object ui template","entity detail","record summary","object page","profile page","details view","overview page","employee profile","device details","invoice details","record page","objectui"],anatomy:{parts:[{name:"ObjectUI.Header",required:!0,role:"Entity identity (avatar, title, caption, status label) plus record-level actions with overflow"},{name:"ObjectUI.Stats",required:!1,role:"Layout.Grid(s) of labeled key-value cells highlighting the record's key attributes"},{name:"ObjectUI.Content",required:!1,role:"One or more bordered sections for detailed free-form content below the summary"}],summary:"A vertical stack summarizing one entity: ObjectUI.Header first (avatar, title, status label, actions), then one or more ObjectUI.Stats grids (labeled key-value cells), then ObjectUI.Content sections holding free-form detail content. Border-radius themes on Stats/Content make the sections stack seamlessly."},guidance:{doNotUseWhen:["Comparing or interacting with many similar items — use NestedList or TableBasic","Large datasets needing sorting, filtering, and pagination — use TableBasic","Building an app shell or full page chrome — use Page and the product shell","Presenting detailed read-only record data without overview actions — use DetailsCard","As a repeating card container inside a list — it summarizes exactly one record"],useWhen:["Providing a quick at-a-glance overview of a single entity (person, company, device, transaction)","Record detail views that need a header with global-level actions plus key stats","Detail drawers, modals, or detail tabs that summarize one business record","Summarizing heterogeneous data (identity, stats, free-form sections) for one record"]},antiPatterns:["Template rendered without Header child","Non-Header content placed before Header","Template used as repeating list card container","Nested Template inside Template","ObjectUI.Template used as an app shell or full record page container","Related record tabs nested inside ObjectUI.Template instead of outside the summary"],aiGuardrails:[{details:["Keep ObjectUI.Template focused on the essential record summary: ObjectUI.Header, ObjectUI.Stats, and sectioned ObjectUI.Content.","Do not overload ObjectUI.Template with every related detail. Put broader related content in tabs or sections outside the template within the existing page/app shell.","Do not pair ObjectUI.Template with a new AppNavBar or Page.Header just to create record-detail chrome. Use ObjectUI.Header for the record header and the surrounding product shell for navigation.","When related record content needs tabs, keep the tab organization outside the ObjectUI.Template summary and avoid wrapping the tabs in an extra card."],guardrail:"Use ObjectUI.Template as the compact summary pattern for one business record, not as an app shell or a container for the whole record page.",section:"Record detail summary"}],selection:{confusedWith:[{component:"DetailsCard",distinguishBy:"DetailsCard is a read-only label-value card for a slice of record data; ObjectUI.Template is the full entity summary with identity header, record-level actions, stats, and content sections"},{component:"Card.Layout",distinguishBy:"Card.Layout is a generic card arrangement; ObjectUI.Template is the opinionated entity-overview composition with a required Header and stacking Stats/Content themes"},{component:"Page",distinguishBy:"Page is the app-shell scaffold (navigation, page title, page content); ObjectUI.Template is a record summary rendered inside a page, drawer, or modal — never a page shell itself"},{component:"TableBasic",distinguishBy:"TableBasic presents large homogeneous datasets with sorting/filtering; ObjectUI.Template gives an at-a-glance overview of one record with mixed data types"}]},relatedComponents:[{name:"ObjectUI.Header",note:"Required first child — entity title, avatar, status label, and actions",relationship:["child"]},{name:"ObjectUI.Stats",note:"Labeled key-value stats grid placed between Header and Content",relationship:["child"]},{name:"ObjectUI.Content",note:"Free-form content sections below the summary; default theme is NO_BORDER_RADIUS inside a Template",relationship:["child"]},{name:"Drawer",note:"Very common container — record detail drawers across products embed an ObjectUI.Template",relationship:["complement"]},{name:"Modal",note:"Used for detail modals (wire info, enrollment, enrollment details)",relationship:["complement"]},{name:"Tabs",note:"Related-record tabs belong outside the Template summary, not nested inside it",relationship:["complement"]},{name:"DetailsCard",note:"Read-only label-value card when no header actions or overview layout are needed",relationship:["alternative"]},{name:"Card.Layout",note:"Generic card arrangement for non-entity content",relationship:["alternative"]}]},PageAppLogo:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{isLogoRound:{description:"If true, logo image is displayed as a circle. Default: false",type:"boolean"},isUnderlined:{description:"If true, a line is added at the bottom. Default: false",type:"boolean"},logoUrl:{description:"URL for the logo image",type:"string"},size:{description:"Logo area width. STANDARD (936px) or FLUID (full width)",enum:["STANDARD","FLUID"],type:"string"},subtitle:{description:"Secondary text displayed below the title",type:"string"},supportLink:{description:"URL for a support/help link displayed next to the title",type:"string"},theme:{description:"Visual theme. NO_PADDING_TOP removes top padding",enum:["NO_PADDING_TOP"],type:"string"},title:{description:"Main title displayed in the app logo header",type:"string"}},required:["title"],type:"object"},acceptsChildren:!1},PageContent:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alignment:{description:"Content horizontal alignment within the page",enum:["CENTER","LEFT","RIGHT"],type:"string"},size:{description:"Maximum content width. 584, 776, 1160, 1544 (px) or FLUID for full width",enum:["584","776","1160","1544","FLUID"],type:"string"},theme:{description:"Layout adjustment: NO_BOTTOM_PADDING removes bottom padding, NO_MARGIN removes horizontal margins, PADDING_APP_NAV_BAR adds top padding to clear an app navigation bar",enum:["NO_BOTTOM_PADDING","NO_MARGIN","PADDING_APP_NAV_BAR"],type:"string"}},type:"object"},acceptsChildren:!0},PageFooter:{description:'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.',events:["continue"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{bottomSpacing:{description:"Bottom padding spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},continueBtnLabel:{description:'Label for the continue button. Default: "Continue"',type:"string"},isContinueDisabled:{description:"If true, the continue button is disabled. Default: false",type:"boolean"},shouldBeSticky:{description:"If true, footer is sticky at the bottom. Default: false",type:"boolean"},shouldHaveStickyOffset:{description:"If true, adds spacing above sticky footer to prevent content overlap. Default: true",type:"boolean"},stickyPosition:{description:"CSS position for sticky footer. Default: fixed",enum:["absolute","fixed"],type:"string"}},type:"object"},acceptsChildren:!0},PageHeader:{description:"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.",events:["action"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{actionClickedId:{description:"Bind to state to receive the clicked action ID when an action is clicked",type:"string"},actions:{description:"JSON-only extension for serializable button actions. React Page.Header actions is a ReactNode slot; this array renders Button actions and emits an action event on click.",items:{additionalProperties:!1,properties:{actionType:{description:"JSON-only extension. Type of action renderer. Default: button",enum:["button"],type:"string"},appearance:{description:"Button visual style. Default: PRIMARY",enum:["PRIMARY","DESTRUCTIVE","OUTLINE","GHOST","ACCENT","SUCCESS","INFO","WARNING"],type:"string"},icon:{description:"Icon name from Icon.TYPES (e.g. ADD, EDIT_OUTLINE)",type:"string"},id:{description:"Unique identifier for the action. Written to actionClickedId state on click",type:"string"},isDisabled:{description:"Disables the button. Default: false",type:"boolean"},label:{description:"Button text",type:"string"},size:{description:"Button size. Default: M",enum:["L","M","S","XS"],type:"string"},variant:{description:"Button variant. Default: NORMAL",enum:["NORMAL","TEXT"],type:"string"}},required:["id","label"],type:"object"},type:"array"},caption:{description:"Caption text displayed below the title",type:"string"},id:{description:"HTML id attribute for the title/caption container",type:"string"},shouldBeLeftAligned:{description:"If true, header is left-aligned instead of centered. Default: false",type:"boolean"},shouldBeUnderlined:{description:"If true, header has an underline",type:"boolean"},size:{description:"Maximum header width. 584, 776, 1160, 1544 (px) or FLUID for full width",enum:["584","776","1160","1544","FLUID"],type:"string"},theme:{description:"Visual theme. NO_MARGIN removes all margins, NO_TOP_MARGIN removes top margin only",enum:["NO_MARGIN","NO_TOP_MARGIN"],type:"string"},title:{description:"Title text for the page header",type:"string"}},type:"object"},acceptsChildren:!1},Paginate:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alignment:{description:"Alignment of pagination controls",enum:["LEFT","CENTER","RIGHT"],type:"string"},forcePage:{description:"Override selected page with parent control (0-indexed). Bind to state",type:"number"},initialPage:{description:"Initially selected page (0-indexed)",type:"number"},marginPagesDisplayed:{description:"Pages shown at start and end of pagination",type:"number"},pageCount:{description:"Total number of pages",type:"number"},pageRangeDisplayed:{description:"Range of pages displayed around current",type:"number"},theme:{description:"Visual style variant",enum:["NO_MARGIN"],type:"string"}},required:["pageCount"],type:"object"},acceptsChildren:!1,category:["navigation"],keywords:["paginate","pagination","page numbers","paging","next page","previous page","table pagination","search results","directory","server-side pagination","page navigation"],anatomy:{parts:[{name:"Selected page button",required:!0,role:"The current page the user is viewing"},{name:"Unselected page buttons",required:!0,role:"Pages the user can jump to directly"},{name:"Overflow ellipsis",role:"Collapses pages that cannot fit in the current viewport"},{name:"Previous / next buttons",required:!0,role:"Step one page backward or forward"}],summary:"A horizontal row of page buttons: a previous arrow, numbered page buttons with a selected state, ellipsis overflow buttons collapsing hidden pages, and a next arrow. Alignment via ALIGNMENTS (left/center/right); marginless via THEMES.NO_MARGIN."},guidance:{doNotUseWhen:["Fully loaded client-side list — use PaginateList, which slices and renders for you","Linear multi-step flows like forms or wizards — use Stepper or ProgressSteps","Short datasets that fit on one page — pagination adds needless complexity","Sequential single-item content (flashcards, carousels) — use Carousel"],useWhen:["Large datasets split across pages — tables, search results, directories, audit trails","Server-side or cursor-style fetching where you render the page content yourself","Loading all data at once would hurt performance or overwhelm the view","Parent owns page state — bind with forcePage + onPageChange, not initialPage"]},antiPatterns:["Pagination navigation missing an accessible name","Parent-managed page state bound with initialPage instead of forcePage","Client-side list paging hand-rolled instead of PaginateList","Legacy utility-class spacing on the control","Active page indicator bound to wrong state variable","Paginate used for sequential single-item content (flashcard deck)",'Approximate pageCount for cursor-style "has next page" APIs',"Pagination placed above list summary text, inverting scan order"],selection:{confusedWith:[{component:"PaginateList",distinguishBy:"PaginateList renders the items and owns page state for a fully loaded client-side list; Paginate is the control only — you render content and can fetch server-side"},{component:"Stepper",distinguishBy:"Stepper tracks sequential workflow completion (wizard steps with statuses); Paginate navigates unordered pages of data"},{component:"ProgressBar",distinguishBy:"ProgressBar shows percent completion of a single task; Paginate jumps between discrete numbered pages"}]},relatedComponents:[{name:"PaginateList",note:"Client-side full-list pagination with built-in item rendering and managed state",relationship:["alternative"]},{name:"TableBasic",note:"Common pairing — Paginate sits below a server-paginated table",relationship:["complement"]},{name:"Stepper",note:"Sequential multi-step flows, not data pages",relationship:["alternative"]},{name:"ProgressBar",note:"Percent-complete feedback, not page navigation",relationship:["alternative"]}]},PaginateList:{description:"A paginated list that divides items across pages with built-in navigation controls. Use when displaying a client-side list that is too long for a single view and needs page-by-page browsing.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{initialPage:{description:"Initial page number to display (0-indexed)",type:"number"},list:{description:"JSON-only subset of the React list prop. Each item must have an id and label for the built-in renderer.",items:{additionalProperties:!1,properties:{id:{anyOf:[{type:"string"},{type:"number"}],description:"Unique identifier for the item"},label:{description:"Display text for the item",type:"string"}},required:["id","label"],type:"object"},type:"array"},pageSize:{description:"Number of items displayed per page. Default: 10",type:"number"}},required:["list"],type:"object"},acceptsChildren:!1,category:["dataDisplay"],keywords:["paginate list","paginatelist","client-side pagination","list paging","page size","list renderer","card list","catalog","directory","document list"],anatomy:{parts:[{name:"List region",required:!0,role:'Current page of items rendered via listItemRenderer; grouped with role="group"'},{name:"Pagination control",required:!0,role:"Page numbers with previous/next; slices the full list by pageSize"}],summary:`A vertical stack of rendered list items (wrapped in role="group") with a pagination control below. Items come from the consumer's listItemRenderer — rows, cards, or link items; the control is the standard Paginate page-number row.`},guidance:{doNotUseWhen:["Items are fetched page-by-page from an API — use Paginate and render the list yourself","Progressive loading on scroll — use an infinite-scroll pattern instead","All items fit on one page — pagination adds unnecessary complexity","Tabular data with columns — use TableBasic"],useWhen:["Fully loaded client-side list that needs splitting into pages to reduce scrolling","Simple paginated views where one component should own list rendering and page state","Document, link, catalog, or product lists with a consistent per-item renderer","Choose pageSize to fill the viewport — 10–20 for compact rows, 5–10 for tall cards"]},antiPatterns:["`pageSize` omitted for tall card or expandable rows — default 10 may overwhelm the viewport","`ExpansionPanel` / accordion content paginated inside `PaginateList`","`listItemRenderer` returns elements without a stable `key`","Barrel import from `@rippling/pebble` instead of documented sub-path","Default-open / selection state tied to page-local index instead of item identity","Competing pagination and truncation controls on the same dataset","Action-required items hidden on non-visible pages without a summary affordance"],selection:{confusedWith:[{component:"Paginate",distinguishBy:"Paginate is the standalone control — consumer renders items and can fetch per page; PaginateList needs the full client-side list and renders items plus controls together"},{component:"TableBasic",distinguishBy:"TableBasic is for tabular data with columns and row semantics; PaginateList renders arbitrary item layouts (cards, link rows) via a render function"}]},relatedComponents:[{name:"Paginate",note:"Standalone control for server-side or consumer-rendered pagination",relationship:["alternative"]},{name:"TableBasic",note:"Columnar tabular data instead of free-form list items",relationship:["alternative"]},{name:"Card",note:"Common item layout rendered inside listItemRenderer",relationship:["complement"]}]},Pane:{description:"Define one adaptive pane",events:["collapsedChange","dismissedChange","committedSizeChange","presentationChange","headerAction","footerAction"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{adaptation:{description:"Ordered breakpoint-token rules for bottomDock, overlay, or hidden presentation.",items:{$ref:"#/$defs/PaneAdaptationRule"},type:"array"},ariaLabel:{description:"Accessible name for the pane region.",type:"string"},ariaLabelledBy:{description:"Space-separated element id list that labels the pane region.",type:"string"},body:{$ref:"#/$defs/PaneBodyDescriptor",description:"Body scrolling and padding behavior."},collapseControl:{description:"Authored Collapse and temporary Hide control location while open. Every collapsed Pane restores from the shared divider rail. Auto uses the header when present and the divider otherwise; header falls back to the divider when no header exists. Default: auto.",enum:["auto","header","divider"],type:"string"},collapsed:{description:"Controlled explicit collapsed state. Bind for SDUI controlled use.",type:"boolean"},collapsible:{description:"Enable explicit user collapse. Automatic adaptation remains independent. Default: false.",type:"boolean"},committedSize:{$ref:"#/$defs/PaneCommittedSize",description:"Controlled committed pixel size by orientation. Bind for SDUI controlled use."},controlTips:{$ref:"#/$defs/PaneControlTips",description:"Tooltip overrides for built-in Pane controls."},defaultCollapsed:{description:"Initial explicit collapsed state for uncontrolled use. Default: false.",type:"boolean"},defaultCommittedSize:{$ref:"#/$defs/PaneCommittedSize",description:"Initial committed pixel size by orientation for uncontrolled use."},defaultDismissed:{description:"Initial dismissed state for uncontrolled use. Default: false.",type:"boolean"},dismissControl:{description:"Authored dismiss control location. Auto uses the header when present and the divider otherwise; header also falls back to the divider when no header exists. Default: auto.",enum:["auto","header","divider"],type:"string"},dismissed:{description:"Controlled dismissed state. Bind for SDUI controlled use.",type:"boolean"},dismissible:{description:"Enable explicit user dismissal. Default: false.",type:"boolean"},footer:{$ref:"#/$defs/PaneFooterDescriptor",description:"Serializable fixed footer rendered outside the scrolling body."},footerActionId:{description:"JSON-only event metadata. Bind to receive the activated footer action id before footerAction emits.",type:"string"},header:{$ref:"#/$defs/PaneHeaderDescriptor",description:"Serializable fixed header descriptor rendered outside the scrolling body."},headerActionId:{description:"JSON-only event metadata. Bind to receive the activated header action id before headerAction emits.",type:"string"},id:{description:"Stable identifier, unique among direct siblings in one SplitPane.",type:"string"},pin:{description:"Pin to a logical edge and exclude this pane from priority collapse.",enum:["start","end"],type:"string"},presentation:{description:"JSON-only event metadata. Bind to receive the resolved presentation before presentationChange emits; this does not control presentation.",enum:["docked","collapsed","hidden","bottomDock","overlay"],type:"string"},priority:{description:"Retention priority: TERTIARY collapses first, then SECONDARY; PRIMARY remains open.",enum:["PRIMARY","SECONDARY","TERTIARY"],type:"string"},reflowSizing:{$ref:"#/$defs/PaneSizing",description:"Sizing descriptor used while the parent SplitPane is reflowed."},sizing:{$ref:"#/$defs/PaneSizing",description:"Docked sizing descriptor. Omit for equal fill sizing without implicit bounds."}},required:["id","priority"],type:"object"},acceptsChildren:!0},Password:{description:"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.",events:["change","blur","focus","click","keydown","keyup","paste","mouseenter","mouseleave","revealChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},shouldAllowReveal:{description:"Show password reveal toggle. Default: true",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},shrinkToPlaceholder:{description:"Input spans as much as its placeholder when true. Only applies when placeholder is visible",type:"boolean"},shrinkToValue:{description:"Input spans as much as its value when true. Only applies when value is present",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},theme:{description:"Theme name from Input.Password.THEMES or custom theme",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current password value bound to state",type:"string"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["password input","passwordinput","password","secret","pin","credentials","api key","access token","client secret","login","signup","change password","masked input","reveal password","confirm password"],anatomy:{parts:[{name:"Label",required:!0,role:"Identifies the field; required for accessibility"},{name:"Masked input",required:!0,role:"Data-entry field that hides typed characters by default"},{name:"Reveal toggle",required:!1,role:"Eye icon that shows/hides the password; enabled via shouldAllowReveal"},{name:"Helper/Error text",required:!1,role:"Guidance (e.g. password policy) or inline validation message"}],summary:"A label above a masked single-line input (dots instead of characters), with an optional eye-icon reveal toggle at the trailing edge, plus helper or error text below. In a Form, the label/title and inline validation are wired up by Form.Input.Password."},guidance:{doNotUseWhen:["Non-sensitive text — use Input.Text; masking adds friction with no benefit","US Social Security Numbers — use Input.Ssn, which adds the fixed mask and validation","Fixed-format identifiers that must remain visible — use Input.Masker","Standalone use inside a Form — use Form.Input.Password so validation and submission are wired up"],useWhen:['Login, signup, and change-password flows, including confirm-password pairs (validations="equalsField:<name>")',"Collecting API tokens, client secrets, SFTP passwords, or other credentials in connector and integration setup forms","Numeric PINs or passcodes that should be masked (e.g. kiosk PINs)","Any free-form secret that must be hidden while typing, with optional reveal via shouldAllowReveal"]},antiPatterns:["Placeholder used as the only field label on password inputs","Password fields built outside Form, bypassing integrated validation","Visual label present but not programmatically linked to standalone password input","Error styling on password fields without an inline error message"],selection:{confusedWith:[{component:"Input.Text",distinguishBy:"Input.Text shows characters in the clear; Input.Password masks the value and offers a reveal toggle — use it for any secret (password, PIN, token), not just login passwords"},{component:"Input.Ssn",distinguishBy:"Input.Ssn is a fixed-format masked identifier (XXX-XX-XXXX) with its own validation; Input.Password accepts free-form secrets with no fixed format"},{component:"Input.Masker",distinguishBy:"Masker enforces a character pattern while typing but does not hide the value as sensitive; Password hides the value and suits arbitrary-length secrets"}]},relatedComponents:[{name:"Form",note:"Most usage is Form.Input.Password inside a Form (login, registration, connector credentials) with validations like isStrongPassword or equalsField for confirm-password",relationship:["complement"]},{name:"Input.Text",note:"For non-sensitive free-form text",relationship:["alternative"]},{name:"Input.Ssn",note:"For US Social Security Numbers specifically",relationship:["alternative"]},{name:"Input.Masker",note:"For fixed-format values that must stay visible while typing",relationship:["alternative"]}]},Percentage:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},allowNegative:{description:"Whether negative values are allowed. Default: false",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},decimalPlaces:{description:"Number of decimal places allowed. Default: 2",type:"number"},defaultValue:{description:"Default percentage value when uncontrolled",type:"number"},id:{description:"HTML id attribute for the input",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for percentage formatting (e.g. en-US)",type:"string"},lowerLimit:{description:"Minimum allowed percentage value",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},placeholder:{description:"Placeholder text when empty",type:"string"},shouldDisableFormatting:{description:"If true, percentage formatting will not be applied",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},step:{description:"Increment/decrement step size. Default: 1",type:"number"},upperLimit:{description:"Maximum allowed percentage value. Default: 100",type:"number"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Current percentage value bound to state"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["percentage input","percentageinput","percent","rate","ratio","contribution percentage","discount","growth rate","allocation","utilization","tax rate"],anatomy:{parts:[{name:"Label",required:!0,role:"Describes the percentage being collected"},{name:"Input field",required:!0,role:"Numeric entry bounded by lowerLimit/upperLimit with decimal precision"},{name:"% suffix",required:!0,role:"Percentage symbol automatically appended to the value"},{name:"Helper text",required:!1,role:"Context or expected-range guidance; replaced by error text"}],summary:"A label above a numeric text field that automatically appends a % suffix to the entered value; a placeholder indicates the expected format (e.g. '50'), helper text sits below, and validation shows a red border with an error message replacing the helper text."},guidance:{doNotUseWhen:["Non-numeric data or free text — use Input.Text","Absolute monetary amounts — use Input.Currency","Unitless counts or quantities — use Input.Number","Read-only display — use isReadOnly, not isDisabled"],useWhen:["Entering percentage values — contribution rates, discounts, growth rates, price caps, allocations","Financial calculations or statistical entries expressed as a rate","Bounded percentages that need lower/upper limits enforced (e.g. 0–100)","Inside a Form for data-submit flows (use Form.Input.Percentage)"]},antiPatterns:["Percentage captured via Number input with manual `%` suffix instead of PercentageInput","Standalone `Input.Percentage` in data-submit panels without Form validation","Visual label on nearby Text without `label`/`title` on standalone PercentageInput","Read-only percentage shown with `isDisabled` instead of `isReadOnly`"],selection:{confusedWith:[{component:"Input.Number",distinguishBy:"Number with a manual '%' suffix loses bounds and consistent formatting; Percentage is purpose-built with % suffix and lower/upper limits"},{component:"Input.Currency",distinguishBy:"Currency is for absolute monetary amounts with a currency symbol; Percentage is for relative rates"},{component:"Input.Slider",distinguishBy:"Slider suits imprecise 0–100 selection; Percentage is for entering an exact rate, including decimals or values above 100"}]},relatedComponents:[{name:"Form",note:"Data-submit panels use Form.Input.Percentage inside a Form for validation",relationship:["complement"]},{name:"Input.Number",note:"Parent component; use only for non-percentage numerics",relationship:["alternative"]},{name:"Input.Currency",note:"Absolute monetary amounts instead of relative rates",relationship:["alternative"]},{name:"Input.Slider",note:"Imprecise bounded-range selection",relationship:["alternative"]}]},Phone:{description:"A specialized input for entering and editing phone numbers with automatic region-based formatting, international support, and an optional country code dropdown selector.",events:["change","blur","focus","click","keydown","keyup","paste","mouseenter","mouseleave","countryCodeChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:'Browser autocomplete hint, e.g. "tel"',type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},countryCode:{anyOf:[{description:'Fixed country code prefix as a string, e.g. "91" or "1"',type:"string"},{additionalProperties:!1,description:"Country-code dropdown configuration preserving the serializable CountryCodeProp shape",properties:{name:{description:"Name for the country-code select input",type:"string"},"aria-describedby":{description:"ID of the element that describes the country-code dropdown",type:"string"},"aria-label":{description:"Accessible label for the country-code dropdown",type:"string"},"aria-labelledby":{description:"ID of the element that labels the country-code dropdown",type:"string"},canClear:{description:"Show clear button in the country-code dropdown",type:"boolean"},defaultSearchQuery:{description:"Initial search query for the country-code dropdown",type:"string"},defaultValue:{description:"Initial selected country code for the dropdown branch",type:"string"},dropdownHeight:{description:"Country-code dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while the dropdown list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query is entered",type:"string"},onNoSearchResults:{description:"Placeholder shown when no matching regions are found",type:"string"}},type:"object"}],description:"Placeholder shown when the country-code dropdown list is empty"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for the country-code dropdown",propertyNames:{type:"string"},type:"object"},id:{description:"HTML id attribute for the country-code select input",type:"string"},isDisabled:{description:"Disables the country-code dropdown",type:"boolean"},isMenuDefaultOpen:{description:"If true, the country-code dropdown opens by default",type:"boolean"},isPositionFixed:{description:"Position the country-code dropdown relative to the viewport",type:"boolean"},isReadOnly:{description:"Makes the country-code dropdown read-only",type:"boolean"},isRequired:{description:"Marks the country-code dropdown as required",type:"boolean"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Maximum dropdown height or chip container height as a CSS value"},placement:{description:"Country-code dropdown placement. Default: bottom-start",enum:["auto","auto-start","auto-end","top","top-start","top-end","bottom","bottom-start","bottom-end","right","right-start","right-end","left","left-start","left-end"],type:"string"},rows:{description:"Minimum row count for the country-code dropdown",type:"number"},scrollThreshold:{description:"Extra pixels rendered above and below the viewport in paginated mode",type:"number"},shouldFocusFirstElement:{description:"Auto-focus the first dropdown item when the menu opens",type:"boolean"},shouldShowSearchIcon:{description:"Show the search icon inside the country-code dropdown",type:"boolean"},shouldUsePortal:{description:"Render the country-code dropdown in a React portal",type:"boolean"},size:{description:"Country-code dropdown size. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Country-code dropdown theme variant",enum:["TRANSPARENT_BORDER","TOP_NAV","INLINE_TRANSPARENT_BORDER","INLINE_TOP_NAV","NO_PADDING_RIGHT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_RIGHT_NO_BOX_TOP_NAV","NO_PADDING_LEFT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_LEFT_NO_BOX_TOP_NAV"],type:"string"},value:{anyOf:[{type:"string"},{type:"null"}],description:"Controlled selected country code for the dropdown branch"}},type:"object"}],description:"Either a fixed country code string or a country-code dropdown configuration object"},countryCodeDefaultValue:{description:"[Deprecated] Use countryCode.defaultValue instead. Initial selected country code for the legacy dropdown shape",type:"string"},countryCodeValue:{description:"[Deprecated] Use countryCode.value instead. Bound selected country code for the legacy dropdown shape",type:"string"},defaultRegion:{description:'Default country region code for formatting, e.g. "US", "IN", "CA". Default: US',type:"string"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},fixedCharsPrefix:{description:"Fixed characters at the beginning of value",type:"string"},fixedCharsSuffix:{description:"Fixed characters at the end of value",type:"string"},id:{description:"HTML element ID",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isCountryCodeDisabled:{description:"[Deprecated] Use countryCode.isDisabled instead for the legacy dropdown shape",type:"boolean"},isCountryCodeReadOnly:{description:"[Deprecated] Use countryCode.isReadOnly instead for the legacy dropdown shape",type:"boolean"},isCountryCodeRequired:{description:"[Deprecated] Use countryCode.isRequired instead for the legacy dropdown shape",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isSensitive:{description:"Marks field as containing sensitive data",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},region:{description:"[Deprecated] Use defaultRegion instead. Region code for phone formatting",type:"string"},shouldAllowAutoFill:{description:"Allow browser autofill",type:"boolean"},shouldEnforceUpperCase:{description:"Enforce upper case input",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},shouldSkipInitialFormatting:{description:"Skip masking on default value",type:"boolean"},shouldStopEventPropagation:{description:"Stop automatic input focus when clicking container",type:"boolean"},shrinkToPlaceholder:{description:"Input spans as much as its placeholder when true. Only applies when placeholder is visible",type:"boolean"},shrinkToValue:{description:"Input spans as much as its value when true. Only applies when value is present",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},testId:{description:"Deprecated testing-only prop kept for backward compatibility",type:"string"},theme:{description:"Theme name from Input.Phone.THEMES or custom theme",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current phone number value bound to state",type:"string"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["phone input","phoneinput","phone number","telephone","mobile","contact","country code","dialing prefix","international number","contact form"],anatomy:{parts:[{name:"Label",required:!0,role:"Describes whose/which phone number is collected"},{name:"Country code dropdown",required:!1,role:"Selects dialing prefix and region formatting (keyboard: Enter to open, arrows to navigate)"},{name:"Phone field",required:!0,role:"Auto-formatted number entry for the selected region"},{name:"Helper/Error text",required:!1,role:"Format guidance; replaced by a descriptive error when invalid"}],summary:"A label above a composite field: an optional country-code dropdown (flag + dialing prefix) on the left and a phone number text field on the right that auto-formats digits to the selected region's pattern. Helper or error text appears below."},guidance:{doNotUseWhen:["Free-form contact handles or IDs — use Input.Text","Fixed-format identifiers that are not phone numbers (EIN, UBI) — use Input.Masker","Email addresses — use Input.Email","Collecting a phone number that is not essential to the flow — prefer omitting the field"],useWhen:["Any form or flow that requires a phone number — contact forms, employee/device setup","International candidate or employee flows needing country-code selection (countryCode prop)","Region-aware automatic formatting and validation of phone numbers"]},antiPatterns:["Phone number collected via plain Text input instead of PhoneInput","PhoneInput block missing accessible name (`label`/`title`/`aria-label`)","International candidate/employee flows using Phone without `countryCode`/`region`","Custom phone wrapper duplicating PhoneInput behaviour"],selection:{confusedWith:[{component:"Input.Text",distinguishBy:"A plain text input collects phone numbers without region formatting or validation; Phone formats per region and supports a country-code selector"},{component:"Input.Masker",distinguishBy:"Masker with a hard-coded phone mask handles one fixed format only; Phone adapts formatting to the selected country and validates international numbers"}]},relatedComponents:[{name:"Form",note:"Contact/employee forms use Form.Input.Phone inside a Form",relationship:["complement"]},{name:"Input.Text",note:"Non-phone free-form contact values",relationship:["alternative"]},{name:"Input.Masker",note:"Parent component; use only for fixed-format masks Phone does not cover",relationship:["alternative"]},{name:"Input.Email",note:"Commonly paired in contact forms (email + phone)",relationship:["complement"]}]},ProgressBar:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Visual appearance style",enum:["PRIMARY","SECONDARY","TERTIARY","ERROR","SUCCESS","WARNING","INFO"],type:"string"},"aria-describedby":{description:"ID of element that describes this progress bar",type:"string"},"aria-label":{description:"Accessibility label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this progress bar",type:"string"},"aria-valuetext":{description:"Human-readable text alternative for the current value",type:"string"},completedPercent:{description:"Progress percentage (0-100). Canonical ProgressBar value prop",maximum:100,minimum:0,type:"number"},isIndeterminate:{description:"Shows indeterminate loading animation",type:"boolean"},label:{description:"Deprecated compatibility prop for wrapper-level label text outside ProgressBar",type:"string"},showPercentage:{description:"Deprecated compatibility prop for wrapper-level percentage text outside ProgressBar",type:"boolean"},testId:{description:"Deprecated testing-only prop kept for backward compatibility. Default: progress-bar",type:"string"},value:{description:"Deprecated. Use completedPercent instead",maximum:100,minimum:0,type:"number"}},type:"object"},acceptsChildren:!1,category:["atom"],keywords:["progress bar","progressbar","percent complete","upload progress","completion","determinate","indeterminate","loading bar","task progress","enrollment progress","import progress"],anatomy:{parts:[{name:"track",required:!0,role:"Full-width background channel representing 0–100%"},{name:"indicator",required:!0,role:"Fill showing current completion; animates when isIndeterminate"},{name:"label",role:"Optional text (e.g. percent) accompanying the bar; required context in compact uses"}],summary:"A track with a filled indicator whose width equals completedPercent (or animates back and forth when indeterminate). Optional label text; semantic appearances (PRIMARY, SUCCESS, WARNING, ERROR, INFO) tint the fill. Compact in tables and banner cells."},guidance:{doNotUseWhen:["User action is required to advance — use ProgressSteps for multi-step flows","Duration is always unknown and space is limited — use Spinner","Time-until-deadline — use Atoms.CountDown","Signaling status or health with semantic color — that is Status, not progress"],useWhen:["Measurable operations — file uploads, imports, processing batches, enrollment completion","Forms, uploads, or operations where the user must wait for completion","Layout.Grid cells and banners reporting record-level progress (e.g. request or payroll progress)","Start indeterminate when progress is unknown, then switch to determinate as it becomes measurable"]},antiPatterns:["Progress bar has no accessible name for screen reader users","Semantic color used to signal status or health instead of completion progress","Bar repurposed as step segment or status lamp — fill does not reflect completion","Indeterminate loading never switches to determinate when progress becomes known","Contradictory indeterminate and determinate props on the same bar","Compact progress bar with no visible text — context only in hover tooltip"],selection:{confusedWith:[{component:"ProgressSteps",distinguishBy:"ProgressBar passively reports percent completion of one operation; ProgressSteps shows a multi-step flow where the user acts to advance between steps"},{component:"Spinner",distinguishBy:"ProgressBar communicates how far along work is; Spinner only says 'busy' — prefer it when duration is unknown and space is tight"},{component:"Atoms.CountDown",distinguishBy:"Atoms.CountDown communicates time remaining toward a deadline; ProgressBar shows percentage of work completed"},{component:"Skeleton",distinguishBy:"Skeleton is a content placeholder preserving layout while data loads; ProgressBar reports measurable progress of an active operation"}]},relatedComponents:[{name:"ProgressSteps",note:"Step-based flows requiring user action between steps",relationship:["alternative"]},{name:"Spinner",note:"Unknown-duration waits or cramped inline spaces",relationship:["alternative"]},{name:"Atoms.CountDown",note:"Time-remaining deadlines rather than percent completion",relationship:["alternative"]},{name:"Skeleton",note:"Layout placeholder while content loads, not operation progress",relationship:["alternative"]},{name:"Notice",note:"Banner copy accompanying long-running operations the bar reports on",relationship:["complement"]}]},ProgressSteps:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{isFluid:{description:"Steps take remaining space if true",type:"boolean"},isHorizontal:{description:"Renders steps horizontally if true",type:"boolean"},isNumeric:{description:"Shows numeric step indicators instead of icons",type:"boolean"},steps:{description:"Array of step configurations with title, subtitle, icon, hasError, and isDisabled",items:{additionalProperties:!1,properties:{hasError:{description:"Marks the step as having an error",type:"boolean"},icon:{description:"Icon type from Icon.TYPES to display for the step",type:"string"},isDisabled:{description:"Disables the step",type:"boolean"},subtitle:{description:"Subtitle text for the step",type:"string"},title:{description:"Title text for the step",type:"string"}},type:"object"},type:"array"},stepsCompleted:{description:"Number of steps completed, starting from 1. Default: 0",type:"number"}},required:["steps"],type:"object"},acceptsChildren:!1,category:["feedback"],keywords:["progress steps","progresssteps","progress indicator","timeline","step tracker","onboarding progress","checkout progress","status timeline","numeric steps","wizard progress"],anatomy:{parts:[{name:"Status indicator",required:!0,role:"Communicates completed, current, not started, disabled, or error"},{name:"Step line",required:!0,role:"Connector line — active for completed/current, inactive for upcoming or error"},{name:"Label",required:!0,role:"Step title communicating what the user accomplishes; numbering aids sequence"},{name:"Helper text",role:"Subtitle marking a step optional or describing an error"}],summary:"A vertical (default) or horizontal sequence of steps joined by connector lines. Each step has a status indicator (completed, current, not started, error, disabled), a label (title), and optional helper text (subtitle) or custom content. isNumeric swaps icons for numbers; isFluid stretches steps to fill space."},guidance:{doNotUseWhen:["New interactive or navigable multi-step flows — use Stepper","Fewer than three steps — surface the process upfront on a single screen","Non-linear workflows or dynamic step counts that change with user choices","Percent-complete feedback for a single task — use ProgressBar"],useWhen:["Read-only display of a linear process with three or more sequential steps","Status timelines — payment instructions, transaction history, application pipelines","Extended forms and onboarding sequences needing validated sequential input","Vertical layouts or numeric/icon-based step indicators"]},antiPatterns:["Step labels built as custom JSX in `content` instead of `title`/`subtitle`","Undocumented `stepsCompleted={-1}` used to suppress progress highlighting","Navigable multi-step flows show ProgressSteps without reflecting live progress","`stepsCompleted` omitted — component defaults to first step as “current”","Fewer than three steps rendered in a progress indicator","Historical timelines mark every event completed (`stepsCompleted={*.length}`)","Parallel custom progress components duplicate Pebble ProgressSteps"],selection:{confusedWith:[{component:"Stepper",distinguishBy:"Stepper is the modern stepper — clickable navigation, statuses, badges, avatars, compact mode; ProgressSteps is the legacy display-oriented indicator"},{component:"ProgressBar",distinguishBy:"ProgressBar is a single percent-complete bar; ProgressSteps shows discrete named stages in a sequence"},{component:"Tabs",distinguishBy:"Tabs switch between independent sibling panels; ProgressSteps visualizes a linear process completed in order"}]},relatedComponents:[{name:"Stepper",note:"Preferred replacement for new interactive multi-step flows",relationship:["alternative"]},{name:"ProgressBar",note:"Percent completion of a single task without discrete steps",relationship:["alternative"]},{name:"Tabs",note:"Independent sibling views, not sequential progress",relationship:["alternative"]},{name:"Icon",note:"Custom per-step icons via the step's icon field",relationship:["complement"]}]},Radio:{description:"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.",events:["change","blur","mouseenter","mouseleave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this radio group",type:"string"},"aria-label":{description:"Accessibility label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this radio group",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial value when uncontrolled"},hoveredValue:{description:"Value of currently hovered option, bound to state"},id:{description:"HTML id attribute for the radio group",type:"string"},isDisabled:{description:"Disables all radio options",type:"boolean"},isHorizontal:{description:"Arrange options in a row",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isReadOnly:{description:"Makes the radio group read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the radio group",type:"string"},list:{description:"Array of { label, value } option objects",items:{additionalProperties:!1,properties:{isActive:{description:"Controls focus state of the option",type:"boolean"},isDisabled:{description:"Disables this specific option",type:"boolean"},label:{description:"Display text for the option",type:"string"},secondaryLabel:{description:"Secondary text below the option label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Tag appearance style",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},label:{description:"Tag label text",type:"string"}},required:["label"],type:"object"}],description:"Optional tag/label displayed with the option"},tip:{description:"Tooltip text shown on hover",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},theme:{description:"Theme styling: FLUID_WIDTH for full-width options, REVERSE for reversed theme",enum:["FLUID_WIDTH","REVERSE","FLUID_WIDTH_SPACE_BETWEEN_REVERSE"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Currently selected value bound to state"},variant:{description:"Visual variant: BOX for boxed layout, LIST for list layout, GRID for grid layout",enum:["BOX","LIST","GRID"],type:"string"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["radio","radio button","radio group","single select","mutually exclusive","one choice","option list","onboarding choice","setup wizard","radioinput"],anatomy:{parts:[{name:"group label",required:!0,role:"Question text wired to the radio group (label prop, not a separate Text heading)"},{name:"radio option",required:!0,role:"Radio circle + label for one mutually exclusive choice"},{name:"secondary label",role:"Supporting description under an option label (secondaryLabel in list entries)"},{name:"tag",role:"Status chip on an option (e.g. 'Current Status', 'Most Common') via tag in list entries"},{name:"error text",role:"Inline validation message below the group when isInvalid"}],summary:"A vertical (or horizontal) group of options, each a radio circle with a label, optional secondaryLabel, tag, and tip; the group carries a question label via the label prop. LIST variant renders full-width rows, BOX/GRID render card-like options for high-importance comparative choices."},guidance:{doNotUseWhen:["Multiple selections are allowed — use Input.Checkbox.Group","The list is long or space is constrained — use Input.Select","A single on/off setting with immediate effect — use Input.Switch","2-5 short-label options acting as an instant filter or view switch — use Input.SegmentedControl","Options need rich custom card content — use Input.SelectableGroup"],useWhen:["Exactly one option must be picked from a short list (2-7) shown inline","Options need comparison — descriptions via secondaryLabel, status via tag","High-importance choices in onboarding, setup wizards, and modals (LIST/BOX variants)","A mutually exclusive question in a Form — use Form.Input.Radio for validation","Choosing between named modes, formats, or statuses (e.g. payment method, billing cadence)"]},antiPatterns:["Default dot variant used where LIST rows would improve scanability","Radio configuration built outside Form — validation disconnected from fields","Required radio group with no pre-selected option","Group question label in separate Text heading, not wired to the radio group","High-importance comparative choice missing BOX/GRID card variant","Error styling on radio without inline error message","Legacy Field wrapper instead of Radio `label` prop"],selection:{confusedWith:[{component:"Input.Checkbox.Group",distinguishBy:"Radio allows exactly one selection; Input.Checkbox.Group allows none, some, or all"},{component:"Input.Select",distinguishBy:"Radio shows all options inline for short lists; Input.Select collapses long lists into a dropdown field"},{component:"Input.SegmentedControl",distinguishBy:"Input.SegmentedControl is a compact pill row for 2-5 short-label options applied immediately; Radio is a labeled field for comparative choices, often submitted"},{component:"Input.SelectableGroup",distinguishBy:"Input.SelectableGroup renders rich custom cards per option; Radio covers text-label options with built-in LIST/BOX/GRID variants"},{component:"Input.Switch",distinguishBy:"Switch is an instant on/off toggle for one setting; Radio chooses between two or more named alternatives"}]},relatedComponents:[{name:"Form.Input.Radio",note:"Form-aware variant; always use inside a Form instead of standalone Input.Radio",relationship:["complement"]},{name:"Form",note:"Owns registration, validation, and submission for radio fields in data-entry flows",relationship:["complement"]},{name:"Input.Checkbox.Group",note:"When more than one option may be selected",relationship:["alternative"]},{name:"Input.Select",note:"When the option list is long or space is tight",relationship:["alternative"]},{name:"Input.SegmentedControl",note:"When 2-5 short-label options should apply immediately in a compact row",relationship:["alternative"]},{name:"Input.SelectableGroup",note:"When options need rich card content beyond label/secondaryLabel",relationship:["alternative"]},{name:"Input.Switch",note:"When the choice is a single instant on/off setting",relationship:["alternative"]}]},RangeSlider:{description:"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.",events:["change","beforeChange","afterChange","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},appearance:{description:"Visual appearance of the slider track. Default: PRIMARY",enum:["PRIMARY","ERROR","SUCCESS","WARNING"],type:"string"},"aria-describedby":{description:"ID of element that describes this slider",type:"string"},"aria-label":{description:"Accessibility label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this slider",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial range values [min, max] when uncontrolled. Default: [0, 100]",items:{type:"number"},maxItems:2,minItems:2,type:"array"},hideTooltip:{description:"Hides the value tooltips above the slider handles. Default: false",type:"boolean"},id:{description:"HTML id attribute for the range slider",type:"string"},isDisabled:{description:"Disables the slider. Default: false",type:"boolean"},isDotsVisible:{description:"Shows dots at each step position. Default: true",type:"boolean"},isReadOnly:{description:"Displays range as read-only text instead of interactive slider. Default: false",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the range slider",type:"string"},marks:{additionalProperties:{type:"string"},description:'Marks on slider as {position: label} object (e.g. {10: "10$", 50: "50$"})',propertyNames:{type:"number"},type:"object"},max:{description:"Maximum value of the slider range. Default: 100",type:"number"},min:{description:"Minimum value of the slider range. Default: 0",type:"number"},shouldShowMarker:{description:"Shows mark labels below the slider. Default: true",type:"boolean"},step:{anyOf:[{type:"number"},{type:"null"}],description:"Value increment/decrement per step. max-min should be evenly divisible by step. Set to null when using marks as steps. Default: 1"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current range values [min, max] bound to state",items:{type:"number"},maxItems:2,minItems:2,type:"array"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["range slider","dual slider","min max","price range","deductible range","interval filter","time range slider","rangeslider"],anatomy:{parts:[{name:"label",required:!0,role:"Field label above the track; must be programmatically linked to the group"},{name:"track",required:!0,role:"Horizontal bar spanning min to max"},{name:"lower/upper handles",required:!0,role:"Two draggable thumbs setting the interval endpoints"},{name:"marks/tooltips",role:"Endpoint labels and value bubbles, formatted via marks and tooltipFormatter"}],summary:"A horizontal track with two draggable handles marking the lower and upper bounds of the selected interval, optional marks at the endpoints, and tooltips showing each bound (formattable, e.g. as currency). Value is a two-element number array."},guidance:{doNotUseWhen:["A single value — use Input.Slider","Exact endpoints matter — use two Input.Number fields","Extremely large or tiny ranges — slider precision breaks down; use Input.Number","Date ranges — use Input.Date.Range"],useWhen:["Filtering or configuring a numeric interval — price, deductible, out-of-pocket max ranges","Approximate time-of-day windows (e.g. minutes-of-day with step 30)","Bounded intervals where a visual scale helps more than exact entry","Endpoint labels via marks and currency formatting via tooltipFormatter"]},antiPatterns:["Range slider embedded without accessible field name","Range endpoints padded beyond business min/max without helper text","Custom dual-thumb slider instead of RangeSlider"],selection:{confusedWith:[{component:"Input.Slider",distinguishBy:"Slider.Range selects a min/max interval with two handles; Input.Slider selects one value with a single handle"},{component:"Input.Number",distinguishBy:"Two Input.Number fields capture exact endpoints; Slider.Range suits approximate interval filtering on a visual scale"}]},relatedComponents:[{name:"Input.Slider",note:"Single-handle variant for one value; Range is its dual-thumb sub-component",relationship:["parent"]},{name:"Form.Input.Slider.Range",note:"Form-aware variant; use inside a Form for validation and submission",relationship:["complement"]},{name:"Form",note:"Container when the selected interval is part of a submitted form",relationship:["complement"]},{name:"Input.Number",note:"Exact endpoint entry via two numeric fields",relationship:["alternative"]}]},RecordLookup:{description:"Searches and selects a record from a searchable model, such as custom objects, Employee, Department, Team, Work Location, Computer, Job Requisition, or Applicant.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{canClear:{description:"Controls whether the value can be cleared.",type:"boolean"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Initial uncontrolled record id, or record id array when isMulti is true."},isDisabled:{description:"Disables searching and selection changes.",type:"boolean"},isMenuDefaultOpen:{description:"Opens the menu when the field mounts.",type:"boolean"},isMulti:{description:"Allows selecting multiple records.",type:"boolean"},isReadOnly:{description:"Displays the value without allowing changes.",type:"boolean"},label:{description:"Label displayed above the lookup.",type:"string"},objectApiName:{description:"RQL API name of the model whose records can be searched. The backend rejects models that are not lookup-supported or that the viewer cannot access.",minLength:1,type:"string"},placeholder:{description:"Search input placeholder.",type:"string"},shouldShowSearchIcon:{description:"Controls whether the search icon is shown.",type:"boolean"},tip:{description:"Supplementary text displayed with the label.",type:"string"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Controlled record id, or record id array when isMulti is true."}},required:["objectApiName"],type:"object"},acceptsChildren:!1},ReportLoader:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!1},Reports:{description:"Embeds a saved Rippling Analytics Report by id. Mounts the EmbeddedReport viewer in STANDALONE mode; the viewer owns fetch, loading, and 403–404 surfaces.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{reportId:{description:"Id of a saved Rippling Analytics Report. The viewer fetches the report and derives grid-vs-chart from its saved configuration.",type:"string"}},required:["reportId"],type:"object"},acceptsChildren:!1},ReportShareLoader:{description:"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).",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!1},ReportViewerLoader:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{},type:"object"},acceptsChildren:!1},ResizableBoard:{description:"A responsive 12-column grid for dashboard widgets that supports drag-to-rearrange and resize-from-any-corner. Use for user-curated dashboards where end-users decide which tiles appear where and how large they are. Each direct child element's spec id must match a `layouts[].identifier`; that layout entry controls the child's size and per-block styling.",events:["layoutChange","breakpointChange","dragStart","dragStop","resizeStart","resizeStop"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{blockShapeCorner:{description:'Shape-corner radius token applied to every block, e.g. "shapeCornerMd". Per-entry `layouts[].shapeCorner` overrides this for individual blocks.',enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},containerPadding:{description:"Padding inside the board container in pixels [x, y].",prefixItems:[{type:"number"},{type:"number"}],type:"array"},isStatic:{description:"Locks all blocks: disables both drag and resize together. Default: false.",type:"boolean"},layouts:{description:"Layout descriptor for each block. Every entry's `identifier` must match the spec id of one of the board's direct children — that's how a block is wired to its widget content. Optional `x`/`y` positions are respected; when omitted, the board auto-places blocks. Drag/resize will respect optional min/max bounds.",items:{additionalProperties:!1,properties:{border:{description:'CSS border applied to the block wrapper, e.g. "1px solid #E0E0E0".',type:"string"},height:{description:"Height in grid units. Default: 1",type:"number"},identifier:{description:"Unique identifier for this layout entry. MUST exactly match the spec id of one of the board's direct child elements — that child is rendered inside this block.",type:"string"},maxHeight:{description:"Maximum height in grid units",type:"number"},maxWidth:{description:"Maximum width in grid units",type:"number"},minHeight:{description:"Minimum height in grid units",type:"number"},minWidth:{description:"Minimum width in grid units. Default: 1",type:"number"},shadow:{description:'Shadow token applied to the block wrapper, e.g. "shadowSm".',enum:["shadow2xl","shadowLg","shadowMd","shadowNone","shadowSm","shadowXl","shadowXs"],type:"string"},shapeCorner:{description:'Shape-corner radius token for this block, e.g. "shapeCornerMd". Overrides the parent board `blockShapeCorner` for this entry only.',enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},width:{description:"Width in grid units (1–12). Default: 3",type:"number"},x:{description:"Horizontal position in grid units. Auto-calculated when omitted.",type:"number"},y:{description:"Vertical position in grid units. Auto-calculated when omitted.",type:"number"}},required:["identifier"],type:"object"},type:"array"},margin:{description:"Horizontal and vertical gutter between blocks in pixels. Default: [24, 24].",prefixItems:[{type:"number"},{type:"number"}],type:"array"},rowHeight:{description:"Pixel height of one vertical grid unit. Default: 100.",type:"number"}},required:["layouts"],type:"object"},acceptsChildren:!0,category:["layout"],keywords:["resizable board","resizableboard","dashboard","widgets","grid layout","drag and drop","resize","rearrange","customizable dashboard","reports dashboard","12-column grid","tiles"],anatomy:{parts:[{name:"Board",required:!0,role:"12-column grid container; owns rowHeight, margin, containerPadding, and edit mode"},{name:"ResizableBoard.Block",required:!0,role:"Widget tile keyed by a stable identifier matching its layouts entry"},{name:"Layout config",required:!0,role:"Per-block { identifier, width, height, minWidth, maxWidth } entries passed via layouts"}],summary:"A board container rendering ResizableBoard.Block children positioned by the layouts prop (identifier, width, height, optional min/max constraints) on a 12-column grid with vertical compaction. isStatic toggles edit mode; onLayoutChange emits the new arrangement for persistence."},guidance:{doNotUseWhen:["Static content layouts — use Layout.HStack, Layout.VStack, or Layout.SplitPane; the board carries grid-library and ResizeObserver cost","Free-form absolute positioning — use Layout.Box with plain CSS","Forms — use Form; tabular data — use Layout.Grid or TableBasic","Permanently fixed arrangements — set isStatic or pick a simpler layout"],useWhen:["User-curated dashboards where users decide which widgets appear where and how large","Mixed-size widget grids that should snap to a consistent 12-column grid","Editable layouts that must persist per user via onLayoutChange","Reports and analytics homepages with an edit/rearrange mode (isStatic toggle)"]},antiPatterns:["Layout editing has no keyboard-accessible alternative","Board used for permanently static layouts","Block chrome duplicated on inner wrappers","Barrel import instead of sub-path","Fixed pixel height inside resizable blocks","Index-based block identifiers","Editable board missing layout persistence","CSS overrides hiding grid resize affordances"],selection:{confusedWith:[{component:"Layout.SplitPane",distinguishBy:"SplitPane divides a page into two resizable panes; ResizableBoard arranges many dashboard widgets on a 12-column grid"},{component:"Layout.Grid",distinguishBy:"Layout.Grid renders tabular data with cell renderers; ResizableBoard positions free-form widget content, not rows of records"},{component:"Layout.HStack",distinguishBy:"Layout.HStack/Layout.VStack are static flex layouts; ResizableBoard is for user-editable widget arrangements that persist"}]},relatedComponents:[{name:"ResizableBoard.Block",note:"Widget tile; identifier must match its layouts entry and be stable (not index-based)",relationship:["child"]},{name:"Layout.SplitPane",note:"Two-pane resizable page layout instead of a widget grid",relationship:["alternative"]},{name:"Layout.Grid",note:"Tabular data display instead of widget arrangement",relationship:["alternative"]},{name:"Layout.HStack",note:"Static layouts that never need rearranging",relationship:["alternative"]},{name:"Layout.VStack",note:"Simple vertical stacking without drag/resize",relationship:["alternative"]},{name:"Card",note:"Typical widget content rendered inside each Block",relationship:["complement"]}]},Responsive:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{above:{description:"Min-width breakpoint token. Children visible at this width and above (mobile-first). Do not use with below",enum:["breakpoint2xl","breakpointLg","breakpointMd","breakpointSm","breakpointXl"],type:"string"},below:{description:"Max-width breakpoint token. Children visible below this width (desktop-first). Do not use with above",enum:["breakpoint2xl","breakpointLg","breakpointMd","breakpointSm","breakpointXl"],type:"string"},mode:{description:"Whether to show or hide children at the breakpoint. Default: show",enum:["show","hide"],type:"string"},viewport:{description:"Use viewport media queries instead of shell container queries. Default: false",type:"boolean"}},type:"object"},acceptsChildren:!0},SegmentedControl:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},appearance:{description:"Visual style variant. Default: PRIMARY",enum:["PRIMARY","POSITIVE","NEGATIVE","NEUTRAL"],type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Initial value when uncontrolled"},isDisabled:{description:"Disables the entire control",type:"boolean"},isFluid:{description:"Stretches control to fill container width",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isMulti:{description:"Allows selecting multiple options",type:"boolean"},isReadOnly:{description:"Makes the control read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isVertical:{description:"Renders options in a vertical layout",type:"boolean"},label:{description:"Label text above the segmented control",type:"string"},list:{description:"Array of { label, value } option objects",items:{additionalProperties:!1,properties:{appearance:{description:"Visual style for this specific option",enum:["PRIMARY","POSITIVE","NEGATIVE","NEUTRAL"],type:"string"},"aria-label":{description:"Accessible label, required if label is not provided (e.g. for icon-only items)",type:"string"},icon:{description:"Icon to display for icon-only items. Requires aria-label or label for accessibility",type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},label:{description:"Display text for the option",type:"string"},tip:{additionalProperties:!1,description:"Tooltip to show on hover for this option",properties:{content:{description:"Tooltip text content",type:"string"}},required:["content"],type:"object"},value:{description:"Value stored when option is selected",type:"string"}},required:["value"],type:"object"},type:"array"},options:{description:"[Deprecated] Use list. Legacy alias for segmented control options",items:{additionalProperties:!1,properties:{appearance:{description:"Visual style for this specific option",enum:["PRIMARY","POSITIVE","NEGATIVE","NEUTRAL"],type:"string"},"aria-label":{description:"Accessible label, required if label is not provided (e.g. for icon-only items)",type:"string"},icon:{description:"Icon to display for icon-only items. Requires aria-label or label for accessibility",type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},label:{description:"Display text for the option",type:"string"},tip:{additionalProperties:!1,description:"Tooltip to show on hover for this option",properties:{content:{description:"Tooltip text content",type:"string"}},required:["content"],type:"object"},value:{description:"Value stored when option is selected",type:"string"}},required:["value"],type:"object"},type:"array"},rangeLabels:{additionalProperties:!1,description:"Labels to display at the start and end of the control range",properties:{end:{description:"Label at the end of the range",type:"string"},start:{description:"Label at the start of the range",type:"string"}},required:["start","end"],type:"object"},size:{description:"Control size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Currently selected value bound to state"}},required:["list"],type:"object"},acceptsChildren:!1,category:["input"],keywords:["segmented control","pill toggle","view switcher","filter tabs","button group","monthly annually","unit toggle","severity filter","segmentedcontrol"],anatomy:{parts:[{name:"label",role:"Optional field label above the control"},{name:"segment",required:!0,role:"One button in the row; short label (a couple of words max) or icon"},{name:"help/error text",role:"Supportive or validation text below the control"}],summary:"An optional label above a row (or fluid-width strip) of adjacent segment buttons, with help or error text below. Each segment is a short text label or an icon (icon-only segments need aria-label). The active segment is visually highlighted."},guidance:{doNotUseWhen:["Navigating between pages or content sections — use Tabs","Binary yes/no or on/off decisions — use Input.Switch","Options have long labels or need descriptions — use Input.Radio","More than five options — use Input.Select"],useWhen:["2-5 closely related options with short labels (one or two words) that apply immediately","View or display-mode switchers — list/grid, UI/JSON, color-by","Toolbar and filter-bar controls — status or severity filters, display units","Compact inline choices like monthly/annually or percentage/absolute","A submitted form value — use Form.Input.SegmentedControl inside a Form"]},antiPatterns:["More than five options passed without Select fallback intent","Input.SegmentedControl used for route/page navigation (Tabs job)","Icon-only segments missing `aria-label`","Binary yes/no choices on Input.SegmentedControl (toggle job)"],selection:{confusedWith:[{component:"Tabs",distinguishBy:"Tabs navigate between pages or content regions; Input.SegmentedControl sets an input value (filter, mode, unit) that applies immediately"},{component:"Input.Radio",distinguishBy:"Radio handles longer labels, descriptions, and comparative choices in a form; Input.SegmentedControl is for a few short-label options in a compact row"},{component:"Input.Switch",distinguishBy:"Switch is a single on/off control; Input.SegmentedControl switches between two or more named options"},{component:"Input.Select",distinguishBy:"Input.Select handles long option lists in a dropdown; Input.SegmentedControl keeps a maximum of 5 options visible"}]},relatedComponents:[{name:"Form.Input.SegmentedControl",note:"Form-aware variant when the selection is a submitted form value",relationship:["complement"]},{name:"Form",note:"Container when the selection participates in validated data entry",relationship:["complement"]},{name:"Tabs",note:"Navigating between content areas or routes instead of setting a value",relationship:["alternative"]},{name:"Input.Radio",note:"Options with longer labels or descriptions, or submitted comparative choices",relationship:["alternative"]},{name:"Input.Switch",note:"A single binary on/off setting",relationship:["alternative"]},{name:"Input.Select",note:"More than five options or very constrained space",relationship:["alternative"]}]},Select:{description:"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.",events:["change","blur","focus","paste","menuToggle"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this select",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this select",type:"string"},canClear:{description:"Show clear button to deselect all",type:"boolean"},canSelectAll:{description:"Show select-all toggle. Requires isMulti to be true",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},creatable:{description:"Allow creating new options not in the list",type:"boolean"},defaultSearchQuery:{description:"Initial search input value",type:"string"},defaultValue:{anyOf:[{items:{},type:"array"},{}],description:"Initial selected value or values when uncontrolled"},dropdownHeight:{description:"Sets dropdown menu height in pixels",type:"number"},emptyListPlaceholder:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{onLoading:{description:"Placeholder shown while list is loading",type:"string"},onNoSearchQuery:{description:"Placeholder when no search query entered",type:"string"},onNoSearchResults:{description:"Placeholder when search returns no results",type:"string"}},type:"object"}],description:"Placeholder when dropdown list is empty. Can be string or object with state-specific placeholders"},footer:{additionalProperties:!1,description:"Fixed footer at bottom of dropdown menu",properties:{label:{description:"Footer link text",type:"string"},onClick:{description:"Event name to emit when footer is clicked",type:"string"}},required:["label","onClick"],type:"object"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing fuzzy search behavior",propertyNames:{type:"string"},type:"object"},id:{description:"HTML id attribute for the select input",type:"string"},isDisabled:{description:"Disables the select",type:"boolean"},isInvalid:{description:"Shows invalid styling on the select",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu will be open by default",type:"boolean"},isMulti:{description:"Allow multiple selections",type:"boolean"},isPositionFixed:{description:"Position dropdown relative to viewport instead of parent",type:"boolean"},isReadOnly:{description:"Makes the select read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isSearchable:{description:"Enable type-to-search filtering",type:"boolean"},label:{description:"Label text above the select",type:"string"},list:{anyOf:[{items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},{items:{additionalProperties:!1,properties:{isNestedMenu:{description:"Render the group as a nested submenu",type:"boolean"},label:{description:"Group label shown above its options",type:"string"},list:{description:"Options contained in this group",items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"}},required:["label","list"],type:"object"},type:"array"}],description:"Selectable options. Supports a flat array of options or a nested array of {label, list} groups"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Max height of multi-select container (CSS value)"},maxTruncationLines:{description:'Max rows of chips visible before "+X" overflow chip appears (multi-select only)',type:"number"},options:{anyOf:[{items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"},{items:{additionalProperties:!1,properties:{isNestedMenu:{description:"Render the group as a nested submenu",type:"boolean"},label:{description:"Group label shown above its options",type:"string"},list:{description:"Options contained in this group",items:{additionalProperties:!1,properties:{avatarProps:{additionalProperties:!1,description:"Avatar configuration for the option",properties:{image:{description:"URL of avatar image",type:"string"},title:{description:"Title/alt text for avatar",type:"string"}},type:"object"},description:{description:"Description text shown below the label",type:"string"},flag:{description:'Two-letter country code for flag icon (e.g. "US", "IN")',type:"string"},isDisabled:{description:"Disables this specific option",type:"boolean"},isRecommended:{description:"Marks option as recommended with a badge",type:"boolean"},isSeparator:{description:"Renders as a visual separator instead of selectable option",type:"boolean"},label:{description:"Display text for the option",type:"string"},labelIcon:{description:"Icon glyph name to show next to the label",type:"string"},leftIconType:{description:'Icon glyph name to show on the left. E.g. "CHECK_CIRCLE_OUTLINE"',type:"string"},quaternaryLabel:{description:"Quaternary label shown below tertiary label",type:"string"},rightLabel:{description:"Label aligned to the right side of the option",type:"string"},secondaryLabel:{description:"Secondary label shown below the main label",type:"string"},tertiaryLabel:{description:"Tertiary label shown below secondary label",type:"string"},value:{description:"Value stored when option is selected"}},required:["label","value"],type:"object"},type:"array"}},required:["label","list"],type:"object"},type:"array"}],description:"Deprecated alias for list. Use list for new specs"},placeholder:{description:"Placeholder text when empty",type:"string"},placement:{description:"Dropdown position relative to input. Default: bottom-start",enum:["auto","auto-start","auto-end","top","top-start","top-end","bottom","bottom-start","bottom-end","right","right-start","right-end","left","left-start","left-end"],type:"string"},rows:{description:"Minimum number of rows to show",type:"number"},scrollThreshold:{description:"Extra pixels to render above/below viewport for smoother scrolling (pagination mode)",type:"number"},selectedOptionsModalClassName:{description:"CSS class for the modal showing all selected options (multi-select +X chip)",type:"string"},shouldFocusFirstElement:{description:"Auto-focus first menu item when dropdown opens",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix when isSearchable is true",type:"boolean"},shouldUsePortal:{description:"Render dropdown in a React Portal. Default: false",type:"boolean"},size:{description:"Select input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Visual theme variant for customized styling",enum:["TRANSPARENT_BORDER","TOP_NAV","INLINE_TRANSPARENT_BORDER","INLINE_TOP_NAV","NO_PADDING_RIGHT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_RIGHT_NO_BOX_TOP_NAV","NO_PADDING_LEFT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_LEFT_NO_BOX_TOP_NAV"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Currently selected value bound to state"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["select","dropdown input","option picker","combobox","multi-select","typeahead","filter","sort by","entity selector","country picker","currency picker","searchable select","async options","grid filter","selectinput"],anatomy:{parts:[{name:"label",required:!0,role:"Field label via title; required for form data-entry usage"},{name:"field",required:!0,role:"Always-visible control showing placeholder or selected value(s)"},{name:"menu",role:"Dropdown list of options with optional search box and footer"},{name:"chips",role:"Selected values rendered as removable chips in Input.Select.Multi"},{name:"helper/error text",role:"Supportive text below the field; replaced by error or warning text"}],summary:"A labeled field that opens a dropdown menu of options. The field shows a placeholder or the selected value (chips in multi mode) with optional prefix icon, clear-all action, and validation icon; the menu offers an optional search box, option rows with labels/icons/avatars, and an optional footer. Helper, error, or warning text sits below the field."},guidance:{doNotUseWhen:["2-5 fixed options that deserve visibility — use Radio or Input.Checkbox cards","Multi-field data entry needing validation and submission — use Form with Form.Input.Select","Transient action menus behind a trigger — use Dropdown","Free text with optional suggestions — use Input.TextAutoSuggest","A few independent on/off toggles — use Input.Checkbox.Group"],useWhen:["Choosing one or more values from a predefined or asynchronously fetched list","Long option lists (employees, countries, currencies) that need search filtering","Filter, sort, and group-by controls on grids and toolbars (size S/XS)","Entity pickers such as company, vendor, or app selectors in page headers","Multi-select with chips via Input.Select.Multi","Async or paginated lists via a list function (pair pre-selected values with resolveSelectedValues)"]},antiPatterns:["Filter and toolbar selects missing an accessible name","Form select rendered without a `title` label","Dropdown used for small fixed choice sets better served by radio","Form select using placeholder instead of `title`","Required data-entry select built outside Form","Legacy `INPUT_SIZES` constant instead of `Input.Select.SIZES`","React element used as option label in list items","Pre-selected async/paginated value without `resolveSelectedValues`"],selection:{confusedWith:[{component:"Dropdown",distinguishBy:"Dropdown is a transient action/option menu opened from a trigger; Input.Select is an input whose selected value persists in the field"},{component:"Radio",distinguishBy:"2-5 fixed options that benefit from always-visible choices -> Radio; longer lists or constrained space -> Input.Select"},{component:"Input.TextAutoSuggest",distinguishBy:"Free text with optional as-you-type suggestions -> Input.TextAutoSuggest; value must come from a predefined list -> Input.Select"},{component:"Input.Checkbox",distinguishBy:"A few independent on/off toggles -> Input.Checkbox/Input.Checkbox.Group; picking several values from a longer list -> Input.Select.Multi"}]},relatedComponents:[{name:"Input.Select.Multi",note:"Multi-select variant rendering selected values as removable chips",relationship:["child"]},{name:"Input.Select.AppGroup",note:"Grouped multi-select for nested category/child option lists",relationship:["child"]},{name:"Form",note:"In data-entry flows use the form-aware Form.Input.Select inside Form, not standalone Input.Select",relationship:["complement"]},{name:"Dropdown",note:"Transient action menus behind a trigger, not a persistent value",relationship:["alternative"]},{name:"Radio",note:"Small fixed choice sets that deserve full visibility",relationship:["alternative"]},{name:"Input.TextAutoSuggest",note:"Free text entry with optional suggestions",relationship:["alternative"]},{name:"Input.Checkbox",note:"A few independent boolean toggles",relationship:["alternative"]}]},SelectableGroup:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input for screen readers",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input for screen readers",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{type:"string"},{type:"number"},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Initial selection when uncontrolled"},id:{description:"Unique DOM id for the input element",type:"string"},isDisabled:{description:"Disables all items in the group",type:"boolean"},isInvalid:{description:"Shows invalid styling on the group",type:"boolean"},isMulti:{description:"Allow multiple selection. Default: false",type:"boolean"},isReadOnly:{description:"Makes the group read-only",type:"boolean"},isRequired:{description:"Marks as required. In multi-select, prevents deselecting the last item",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Array of item objects to render as selectable cards",items:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},type:"array"},renderer:{description:"JSON-only constrained renderer choice: BASIC_CARD or LOCATION_CARD",enum:["BASIC_CARD","LOCATION_CARD"],type:"string"},testId:{description:"Deprecated testing-only prop kept for backward compatibility",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Selected value(s). Single value when isMulti is false, array when true"},valueIdentifier:{description:'Key name to extract unique value from each list item. Default: "value"',type:"string"}},required:["list","renderer"],type:"object"},acceptsChildren:!1,category:["input"],keywords:["selectable group","selectable cards","card picker","card selection","account picker","plan picker","onboarding cards","rich options","selectablegroup"],anatomy:{parts:[{name:"item card",required:!0,role:"One selectable option rendered from a list entry via the renderer"},{name:"selection indicator",required:!0,role:"Radio (single) or checkbox (isMulti) semantics marking the chosen cards"},{name:"additionalJsx",role:"Optional trailing content such as a Card.Basic 'add new' tile"}],summary:"A vertical or wrapping layout of selectable card items driven by a list of data objects and a renderer (built-in BASIC_CARD or LOCATION_CARD, or a custom renderer). Each card shows a title, content, and a selection indicator; an additionalJsx slot can append extra cards such as an 'add new' action."},guidance:{doNotUseWhen:["Options are simple text labels — use Input.Radio or Input.Checkbox.Group","The option list is long — cards overwhelm the layout; use Input.Select","Displaying checklist progress — use CheckList","Chips as selectable options — RENDERERS.CHIP is deprecated for accessibility"],useWhen:["Choosing among a few rich options that need custom card content — accounts, plans, strategies","Single or multi (isMulti) selection presented as selectable cards","Onboarding and setup flows picking a payment account, base plan, or grouping strategy","Options keyed by a data field via valueIdentifier rather than a simple string"]},antiPatterns:["Missing `name` prop on Input.SelectableGroup","Deprecated `RENDERERS.CHIP` still in use","Card group without `aria-label` / `aria-labelledby`","Long option lists that overwhelm card layout"],selection:{confusedWith:[{component:"Input.Radio",distinguishBy:"Radio's BOX/GRID variants cover text-label cards; Input.SelectableGroup is for options needing fully custom card content (accounts, plans, strategies)"},{component:"Input.Checkbox.Group",distinguishBy:"Input.Checkbox.Group renders text-label rows/boxes for multi-select; Input.SelectableGroup renders rich custom cards with isMulti"},{component:"CheckList",distinguishBy:"CheckList displays checklist progress/status; Input.SelectableGroup is an input for choosing among items"},{component:"Input.Select",distinguishBy:"Input.Select collapses long text-option lists into a dropdown; Input.SelectableGroup shows a few rich cards inline"}]},relatedComponents:[{name:"Card.Basic",note:"Common additionalJsx tile for an 'add new' action alongside the options",relationship:["complement"]},{name:"Form",note:"Use the form-aware Form.Input.SelectableGroup inside a Form for validation",relationship:["complement"]},{name:"Input.Radio",note:"Single selection among text-label options (BOX/GRID variants)",relationship:["alternative"]},{name:"Input.Checkbox.Group",note:"Multi-select among text-label options",relationship:["alternative"]},{name:"CheckList",note:"Displaying checklist status rather than collecting a selection",relationship:["alternative"]},{name:"Input.Select",note:"Long text-option lists or constrained space",relationship:["alternative"]}]},SelectableMenu:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{defaultValue:{description:"Initially selected value",type:"string"},isCompact:{description:"Render in compact mode",type:"boolean"},isDisabled:{description:"Disable the menu trigger",type:"boolean"},isScrollbarAlwaysVisible:{description:"Always show scrollbar in the menu list",type:"boolean"},list:{description:"Array of menu options: {label, value, isDisabled?}",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this option",type:"boolean"},label:{description:"Display text for the option",type:"string"},value:{description:"Unique value for the option",type:"string"}},required:["label","value"],type:"object"},type:"array"},maxHeight:{description:"Max height of the menu in px",type:"number"},placement:{description:"Menu position. Default: bottom-start",enum:["bottom-start","bottom","bottom-end","top-start","top","top-end"],type:"string"},searchable:{description:"Enable search within the menu",type:"boolean"},shouldAutoClose:{description:"Auto-close after item selection",type:"boolean"},shouldCloseOnScroll:{description:"Close dropdown on document scroll. Default: false",type:"boolean"},shouldScrollToSelectedValue:{description:"Auto-scroll to the selected value in the list",type:"boolean"},theme:{description:"Visual theme for the trigger. Available: BOLD",enum:["BOLD"],type:"string"},value:{description:"Currently selected value. Bind to state for selection tracking",type:"string"},virtualizeWhenItemCountExceeds:{description:"Virtualize the list when item count exceeds this number",type:"number"},width:{description:"Width of the menu in px. Default: 312",type:"number"}},required:["list"],type:"object"},acceptsChildren:!1,category:["input"],keywords:["selectable menu","dropdown trigger","period picker","month picker","legacy dropdown","selectablemenu"],anatomy:{parts:[{name:"trigger",required:!0,role:"Button-like target showing the selected option label"},{name:"options list",required:!0,role:"Dropdown menu of selectable items from the list prop"}],summary:"A trigger button displaying the current selection that opens a dropdown list of options. Wraps Dropdown and auto-renders the target; supports themes (e.g. BOLD), custom widths, and standard dropdown positioning (isPositionFixed, shouldFlipIfNoSpace)."},guidance:{doNotUseWhen:["Any new implementation — use Dropdown with a trigger label","A labeled form field with validation — use Input.Select or Form.Input.Select","Toolbar filters on new screens — compose Dropdown or a filter pattern instead"],useWhen:["Maintaining legacy screens that already use it — prefer migrating to Dropdown","Nothing else: no new usage should be introduced"]},antiPatterns:["Deprecated component still used with no migration to Dropdown","Uncontrolled selection (`defaultValue`) while React state owns the current value","Bare period/filter trigger with no visible field label","Inconsistent selection controls on the same screen (labeled Form/Input select + bare SelectableMenu)","Multiple visible menus sharing one change handler — selection in one menu affects unrelated data","Missing `isPositionFixed` inside scrollable grid layouts"],selection:{confusedWith:[{component:"Dropdown",distinguishBy:"Dropdown is the supported replacement — you compose the trigger yourself; SelectableMenu is deprecated and only remains in legacy screens"},{component:"Input.Select",distinguishBy:"Input.Select is a labeled form field with validation; SelectableMenu is an unlabeled toolbar-style trigger menu"}]},relatedComponents:[{name:"Dropdown",note:"Replacement — use Dropdown with a trigger label for all new implementations",relationship:["alternative"]},{name:"Input.Select",note:"Labeled select field when the choice is a form value (Form.Input.Select inside a Form)",relationship:["alternative"]}]},SettingsLoader:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{isCenter:{description:"Center the loader horizontally using auto margins. Default: false",type:"boolean"},margin:{anyOf:[{type:"string"},{type:"number"}],description:'Custom margin for the loader container. Accepts a CSS string (e.g. "16px") or a number (applied as px). Overrides default top margin when provided.'}},type:"object"},acceptsChildren:!1},ShowMore:{description:'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.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{buttonSize:{description:"Size of the show more/less toggle button",enum:["XS","S","M","L"],type:"string"},leftOffset:{description:"Left padding for the toggle button in pixels",type:"number"},showMoreSuffix:{description:'Suffix text appended to "Show all N" button text. Default: "items"',type:"string"},size:{description:"Number of items to show initially before requiring expansion. Default: 3",type:"number"}},type:"object"},acceptsChildren:!0,category:["layout"],keywords:["show more","showmore","show less","list truncation","truncated list","expand list","see all","view all","long list","limited items","collapsible list","item preview"],anatomy:{parts:[{name:"Items list",required:!0,role:"Array rendered via itemRenderer; initially sliced to `size`, expanded in `steps`"},{name:"ShowMore.Button",required:!1,role:"Expand/collapse toggle rendered automatically; sized via buttonSize, labeled via showMoreSuffix"}],summary:"Renders the first `size` items of an `items` array via `itemRenderer`, followed by a Show more / Show less toggle (optionally revealing `steps` more items per click). The button label gets a contextual suffix via showMoreSuffix (e.g. 'Show all reviews')."},guidance:{doNotUseWhen:["Clipping one block of text or rich content by height — use TextClip","Custom expand/collapse of non-list content — use ShowMore.Button with consumer-managed state","Multiple sections needing individual expand/collapse with titles — use ExpansionPanel","Full data browsing with search/paging — use TableBasic or Layout.Grid"],useWhen:["A list has more items than should render at once — direct reports, reviews, invitees, documents, errors","The first N items give enough context and the rest are revealed on demand (size, steps)","Lists inside cards, notices, or modals where space is constrained","Labeling the toggle with context via showMoreSuffix ('Show all reviews')"]},antiPatterns:["Expand button missing expanded state for assistive technology","List truncation reimplemented manually instead of using ShowMore","Redundant accessibility attributes duplicated on the expand button","Truncated list hidden inside a hover tooltip","Non-canonical props break list truncation behavior"],selection:{confusedWith:[{component:"TextClip",distinguishBy:"TextClip clips one continuous block of content by pixel height; ShowMore truncates a list of discrete items by count and renders them for you"},{component:"ShowMore.Button",distinguishBy:"ShowMore.Button is only the toggle — the consumer manages expanded state and content slicing; ShowMore owns the whole list-truncation flow"},{component:"ExpansionPanel",distinguishBy:"ExpansionPanel toggles titled, bordered sections of content; ShowMore reveals more items of a single homogeneous list"}]},relatedComponents:[{name:"ShowMore.Button",note:"The toggle button; also usable standalone for custom expand/collapse",relationship:["child"]},{name:"TextClip",note:"Height-based clipping of a single content block instead of item-count truncation",relationship:["alternative"]},{name:"ExpansionPanel",note:"Multiple titled sections that each expand independently",relationship:["alternative"]},{name:"ListItem",note:"Common itemRenderer output for simple rows",relationship:["complement"]}]},Signature:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial default signature value",type:"string"},id:{description:"Unique DOM element ID",type:"string"},isDisabled:{description:"Disables the signature input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isReadOnly:{description:"Shows signature image only, no input",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isTypeSignatureDisabled:{description:"Only show draw input, hide type input. Default: false",type:"boolean"},label:{description:"Label text above the input",type:"string"},penColor:{description:"Pen color token for drawing",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},placeholder:{description:"Placeholder text for the drawing area",type:"string"},typePlaceholder:{description:"Placeholder text for the type signature input",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Signature as base64 PNG data URL string",type:"string"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["signature","sign document","e-signature","draw signature","type to sign","legal agreement","consent","acknowledgment","w-4","ach authorization","contract signing","attestation"],anatomy:{parts:[{name:"Label",required:!0,role:"Identifies what is being signed; required for accessibility"},{name:"Draw canvas",required:!0,role:"Freehand signature capture with configurable penColor"},{name:"Type-to-sign input",required:!1,role:"Typed-name signature; disabled via isTypeSignatureDisabled"},{name:"Clear action",required:!1,role:"Removes all strokes so the user can re-sign"}],summary:"A label above a signature container offering two modes: a draw canvas (mouse, stylus, or touch, with custom penColor) and a type-to-sign input that renders the name in a script style. A clear/refresh action resets the canvas. Helper or error text appears below."},guidance:{doNotUseWhen:["Capturing typed names or initials — use Input.Text instead","Simple yes/no consent — use Input.Checkbox","Contexts where a digital signature carries no legal or audit weight","Outside a Form when validation is needed — use Form.Input.Signature"],useWhen:["A digital signature is required for document approval, consent, or formal acknowledgment","Legally binding flows — tax forms (W-4), ACH/bank authorizations, COBRA, PEO agreements","Timesheet or compliance attestations that must capture who signed","Use Form.Input.Signature with isRequired so an unsigned form cannot submit"]},antiPatterns:["Input.Signature field missing an accessible name","Input.Signature validation or upload errors shown only via toast","Input.Signature capture outside Form validation layer","Legally binding flow omits helper text on signature field"],selection:{confusedWith:[{component:"Input.Text",distinguishBy:"Input.Text captures a typed name or initials as plain text; Input.Signature captures a drawn/typed signature artifact for legally binding flows"},{component:"Input.Checkbox",distinguishBy:"A checkbox is enough for simple consent ('I agree'); use Input.Signature when a formal, attributable signature is required on a document"}]},relatedComponents:[{name:"Form",note:"Most usage is Form.Input.Signature with isRequired in W-4/state tax, ACH authorization, PEO, and benefits document flows",relationship:["complement"]},{name:"Modal",note:"Common container for sign-and-confirm dialogs (timesheet submission, document signing)",relationship:["complement"]},{name:"Input.Text",note:"For typed names or initials when a signature artifact is not needed",relationship:["alternative"]},{name:"Input.Checkbox",note:"For lightweight consent without a legally binding signature",relationship:["alternative"]}]},Sin:{description:'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.',events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-label":{description:"Accessible label when no visible label",type:"string"},autoComplete:{description:"Browser autocomplete hint. Default: off",type:"string"},autoFocus:{description:"Auto-focus input on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial unmasked SIN value",type:"string"},fixedCharsPrefix:{description:"Fixes characters at the beginning of the value",type:"string"},fixedCharsSuffix:{description:"Fixes characters at the end of the value",type:"string"},id:{description:"Explicit HTML element id",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character length",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character length",type:"number"},placeholder:{description:'Placeholder text. Default: "XXX XXX XXX"',type:"string"},shouldEnforceUpperCase:{description:"Enforces uppercase on input characters",type:"boolean"},shouldSkipInitialFormatting:{description:"If true, skip applying mask on the default/initial value",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Unmasked SIN value (9 digits, no spaces)",type:"string"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["sin input","sininput","social insurance number","sin","canada","canadian tax id","T4","ROE","payroll","identity verification","sensitive"],anatomy:{parts:[{name:"Title/Label",required:!0,role:"Visible field label — required; aria-label alone is not sufficient"},{name:"Masked field",required:!0,role:"9-digit entry auto-formatted as XXX XXX XXX; stores unmasked digits"},{name:"Helper/Error text",required:!1,role:"Format guidance; replaced by a descriptive error on validation failure"}],summary:"A visible title/label above a masked 9-digit field that formats as XXX XXX XXX while the user types; helper or error text appears below for format guidance and validation feedback."},guidance:{doNotUseWhen:["US Social Security Numbers — use Input.Ssn (XXX-XX-XXXX) with US-specific sensitive handling","Custom format patterns not covered by a purpose-built input — use Input.Masker","Free-form text — use Input.Text; a fixed SIN mask blocks valid non-SIN entries","Non-Canadian identifiers — use Input.Masker with a country-specific mask"],useWhen:["Canadian employee forms collecting SINs for payroll, tax, or HR purposes","Canadian tax-related forms that require a SIN (T4, T4A, ROE)","Identity verification in Canadian onboarding or compliance workflows"]},antiPatterns:["SIN field rendered without a visible title (empty or missing)","SIN collected via generic text input instead of SinInput","Dynamic EOR SIN uses aria-label without guaranteed visible title"],selection:{confusedWith:[{component:"Input.Ssn",distinguishBy:"Ssn is for US Social Security Numbers (XXX-XX-XXXX); Sin is the Canadian equivalent with XXX XXX XXX formatting — pick by the worker's country"},{component:"Input.Masker",distinguishBy:"Masker with a custom mask replicates the format but misses Sin's purpose-built validation; use Masker only for patterns no dedicated input covers"},{component:"Input.Text",distinguishBy:"Text imposes no format; SINs need the fixed 9-digit mask and validation Sin provides"}]},relatedComponents:[{name:"Form",note:"Canadian employee setup flows use Form.Input.Sin inside a Form",relationship:["complement"]},{name:"Input.Ssn",note:"US Social Security Number equivalent",relationship:["alternative"]},{name:"Input.Masker",note:"Parent component; use for other country-specific fixed-format identifiers",relationship:["alternative"]},{name:"Input.Text",note:"Free-form identifiers without a fixed format",relationship:["alternative"]}]},Skeleton:{description:"An animated placeholder that mimics the shape of content while it loads, available in text (lines), circle, and box variants.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{animation:{description:"Loading animation style. Default: wave",enum:["wave","pulse","none"],type:"string"},borderRadius:{description:"Border radius token (BOX variant)",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},gap:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{type:"string"},{type:"number"}],description:"Gap between lines when lines > 1 (TEXT variant). Spacing token, CSS string, or number. Default: 4px"},height:{anyOf:[{type:"number"},{type:"string"}],description:"Height in px or CSS string (BOX variant)"},initialTimestamp:{description:"Initial mount timestamp for animation delay calculation. Used to coordinate animations across multiple skeletons. Default: Date.now()",type:"number"},lineHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Line height of text skeleton for pixel-perfect match (TEXT variant). Default: 15px"},lines:{description:"Number of text lines (TEXT variant). Default: 1",type:"number"},show:{description:"Whether the skeleton is loading. true renders the skeleton, false renders nothing. Default: true",type:"boolean"},size:{anyOf:[{type:"number"},{type:"string"}],description:"Diameter in px or CSS string (CIRCLE variant). Default: 40"},variant:{description:"Skeleton shape variant. Default: text",enum:["text","circle","box"],type:"string"},width:{anyOf:[{type:"string"},{type:"number"}],description:"Width of the skeleton (number in px or CSS string)"}},type:"object"},acceptsChildren:!1,category:["atom"],keywords:["skeleton","loading placeholder","shimmer","skeleton screen","content placeholder","loading state","placeholder","wave animation","pulse","layout shift","grid loading","card loading","pending content"],anatomy:{parts:[{name:"shape",required:!0,role:"TEXT, BOX, or CIRCLE placeholder matched to the content it stands in for"},{name:"animation",role:"WAVE shimmer (default), PULSE, or NONE for static placeholders"},{name:"children",role:"Provider mode: the real content rendered when `show` is false"}],summary:"A single animated shape — TEXT lines for paragraphs (default), BOX rectangle with width/height for blocks and images, CIRCLE with size for avatars and icons. In provider mode the Skeleton wraps real children and swaps between its shapes and the content via `show`; nested providers inherit the parent's state."},guidance:{doNotUseWhen:["Small inline or button-triggered waits — use Spinner or Button's isLoading","Pixel-exact custom layouts — use ContentLoader with SVG children","Empty states (no data, not loading) — use an empty-state pattern with BrandBadge or copy","Operations under ~200ms — skeletons add visual noise; render content directly"],useWhen:["Layout-level loading where the incoming content's structure is known — cards, grid cells, profile rows, page sections","Provider mode: wrap a section in Skeleton with `show` so it swaps to real content when data arrives","Progressive loading — wrap the smallest meaningful section so loaded parts render while others stream in","Match shape to content: CIRCLE for avatars/icons, BOX for images and blocks, TEXT lines for paragraphs"]},antiPatterns:["Loading skeleton regions lack screen-reader status announcements","Skeleton shapes use hardcoded pixel dimensions instead of theme tokens or typestyle","Loading state swaps in a separate skeleton tree instead of Skeleton provider wrapping real content","TEXT skeletons sized with raw `lineHeight` instead of matching `typestyle`","Suspense fallback renders skeleton layout without accessible status wrapper","BOX variant used for single-line text instead of TEXT variant","Avatar/icon placeholders use BOX squares instead of CIRCLE variant","Animation disabled on in-progress loading skeletons"],selection:{confusedWith:[{component:"ContentLoader",distinguishBy:"Skeleton offers three theme-token shapes plus provider wrapping of real content; ContentLoader takes custom SVG children for pixel-exact layout matching"},{component:"Spinner",distinguishBy:"Skeleton preserves the incoming layout and avoids shift; Spinner is an indeterminate ring for unknown layouts, route changes, or tiny inline waits"},{component:"Spinner.FieldLoader",distinguishBy:"Spinner.*Loader sub-loaders are preset skeletons for common layouts (fields, settings, charts); Skeleton composes custom arrangements of shapes"}]},relatedComponents:[{name:"ContentLoader",note:"Custom SVG shimmer shapes when exact layout matching is needed",relationship:["alternative"]},{name:"Spinner",note:"Indeterminate ring when layout cannot be estimated or the wait is tiny/inline",relationship:["alternative"]},{name:"Spinner.FieldLoader",note:"Preset skeleton layouts (fields, settings, charts, reports) without manual shape composition",relationship:["alternative"]},{name:"Avatar",note:"Pair CIRCLE skeletons with the real Avatar's size to avoid layout shift",relationship:["complement"]},{name:"Layout.Box",note:"Common wrapper providing role=status and aria-busy around skeleton regions",relationship:["complement"]}]},Slider:{description:"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.",events:["change","blur","beforeChange","afterChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},appearance:{description:"Sets slider appearance. Default: PRIMARY",enum:["PRIMARY","ERROR","SUCCESS","WARNING"],type:"string"},"aria-describedby":{description:"ID of element that describes this slider",type:"string"},"aria-label":{description:"Accessibility label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this slider",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial value when uncontrolled. Default: 0",type:"number"},hideTooltip:{description:"Hide the value tooltip. Default: false",type:"boolean"},isDisabled:{description:"Disables the slider",type:"boolean"},isDotsVisible:{description:"If true renders slider with dots. Default: true",type:"boolean"},isReadOnly:{description:"Makes the slider read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the slider",type:"string"},marks:{additionalProperties:{type:"string"},description:"Named marks on the slider track. Keys are numeric positions, values are labels",propertyNames:{type:"string"},type:"object"},max:{description:"Maximum value. Default: 100",type:"number"},min:{description:"Minimum value. Default: 0",type:"number"},shouldShowMarker:{description:"Controls visibility of marker. Default: true",type:"boolean"},step:{anyOf:[{type:"number"},{type:"null"}],description:"Step size between values. Set to null to use marks as steps. Default: 1"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current slider value bound to state",type:"number"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["slider","range input","numeric scale","percentage slider","price cap","buffer percentage","multiplier","approximate value","sliderinput"],anatomy:{parts:[{name:"label",required:!0,role:"Field label above the track, left-aligned; must be programmatically linked"},{name:"track",required:!0,role:"Horizontal bar spanning min to max"},{name:"handle",required:!0,role:"Draggable thumb indicating the selected value"},{name:"marks/dots",role:"Optional labeled stops (marks) or step dots along the track"},{name:"tooltip",role:"Value bubble while dragging; keep visible for value-selection sliders"}],summary:"A label above a horizontal track showing the min/max range, with a draggable handle marking the current value, optional marks or dots at step intervals, and a tooltip showing the value being selected (formattable via tooltipFormatter)."},guidance:{doNotUseWhen:["Exact values matter — use Input.Number (optionally paired alongside)","Extremely large (1-1000) or tiny (1-3) ranges — slider precision breaks down; use Input.Number","Selecting a min/max interval — use Slider.Range","Non-numeric or complex values — sliders only handle numbers"],useWhen:["Selecting an approximate single value in a bounded range, ideally 0-100","Percent-style settings where the scale is visual — price caps, buffers, multipliers","Limiting options to discrete steps with marks or dots","Live preview scenarios where dragging should update content (use onAfterChange for expensive updates)"]},antiPatterns:["Standalone slider with visual label not programmatically linked","Slider range far outside recommended bounds","Duplicate slider and number control without linked accessible name","Tooltip hidden on value-selection slider"],selection:{confusedWith:[{component:"Slider.Range",distinguishBy:"Input.Slider picks one value with a single handle; Slider.Range picks a min/max interval with two handles"},{component:"Input.Number",distinguishBy:"Input.Number enters an exact numeric value; Slider trades precision for an approachable visual scale"},{component:"Input.Percentage",distinguishBy:"Input.Percentage is a text field for exact percents; Slider suits approximate percent selection (e.g. buffers, caps)"}]},relatedComponents:[{name:"Slider.Range",note:"Dual-thumb variant for selecting a min/max interval",relationship:["child"]},{name:"Form.Input.Slider",note:"Form-aware variant; use inside a Form for validation and submission",relationship:["complement"]},{name:"Form",note:"Container when the slider value is part of a submitted form",relationship:["complement"]},{name:"Input.Number",note:"Exact numeric entry or very large ranges",relationship:["alternative"]},{name:"Input.Percentage",note:"Exact percent entry instead of an approximate slider",relationship:["alternative"]}]},SnackBar:{description:"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.",events:["dismiss"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Snackbar appearance type. Default: INFO",enum:["SUCCESS","INFO","WARNING","ERROR"],type:"string"},canDismiss:{description:"Show dismiss button. Default: true",type:"boolean"},id:{description:"Unique identifier for the snackbar. Prevents duplicates and resets auto-dismiss timer on update",type:"string"},isVisible:{description:"Controls snackbar visibility. Bind to state to show/hide programmatically",type:"boolean"},metadata:{additionalProperties:{},description:'Arbitrary key/value context forwarded to the global SnackBar.onTrigger callback. Useful for analytics/logging (e.g. { source: "ProfilePage" })',propertyNames:{type:"string"},type:"object"},persist:{description:"If true, snackbar will not auto-close",type:"boolean"},text:{description:"Message text to display in the snackbar",type:"string"},title:{description:"Custom text for the dismiss button instead of close icon",type:"string"}},required:["text"],type:"object"},acceptsChildren:!1,category:["atom"],keywords:["snackbar","snack bar","toast","notification","success message","error message","save confirmation","transient","auto-dismiss","passive feedback","copied","saved"],anatomy:{parts:[{name:"container",required:!0,role:"Global bottom-of-screen surface hosting the queued notification"},{name:"icon",role:"Severity glyph matching the info/success/warning/error variant"},{name:"message",required:!0,role:"Single sentence, sentence case, no terminal period"},{name:"action",role:"Optional single button (e.g. Undo); never a destructive confirmation"},{name:"dismiss",role:"Close control; keyboard-focusable, contextual on persist"}],summary:"A bottom-of-screen container holding a severity icon, a single-sentence message, an optional action button, and a contextual dismiss control. Messages auto-dismiss unless `persist` is set; an `id` replaces an existing snack bar instead of stacking."},guidance:{doNotUseWhen:["Input or form validation feedback — surface inline field errors through Form instead","The user must stop and act before continuing — use Modal or Modal.confirm","System-wide or persistent page states — use Notice","In-progress work — use a loading surface (Spinner, ProgressBar), then SnackBar the outcome"],useWhen:["Passive confirmation right after a user action — saved, copied, sent, deleted","Non-critical, supplementary updates that are fine to auto-dismiss","Optional single action on the message (e.g. Undo); persist until the user interacts","Fire from anywhere via SnackBar.success/info/warning/error — no local state or container needed"]},antiPatterns:["Notification messages contain untranslated English text","Inconsistent notification pattern — SnackBar wrapped in custom helpers that obscure the raw API error","Incorrect severity variant — any mismatch between what happened and the signal users receive","**SnackBar used for input/form validation feedback — the single most damaging misuse of SnackBar**","Persistent SnackBar used for passive feedback without an action","Single-sentence SnackBar copy ends with terminal punctuation","Raw backend or API detail interpolated into SnackBar copy","In-progress work announced through SnackBar instead of a loading or progress surface","SnackBar action used as destructive confirmation instead of Modal.confirm","SnackBar error copy lacks recovery guidance"],selection:{confusedWith:[{component:"Notice",distinguishBy:"SnackBar is a transient, global, post-action confirmation that auto-dismisses; Notice is a persistent inline callout for page/feature states that stay wrong until fixed"},{component:"Modal",distinguishBy:"Modal (or Modal.confirm) interrupts and requires acknowledgment or a decision; SnackBar is passive and must never gate the user"},{component:"Status",distinguishBy:"Status is a persistent dot-and-text state indicator on a record; SnackBar announces an event that just happened, then disappears"}]},relatedComponents:[{name:"Notice",note:"Persistent inline callouts — system-wide messages, unresolved page states, rich actions",relationship:["alternative"]},{name:"Modal",note:"Feedback requiring user action or acknowledgment — use Modal.confirm for destructive confirms",relationship:["alternative"]},{name:"Status",note:"Persistent record state, not an event announcement",relationship:["alternative"]},{name:"Form",note:"Form submission success is a classic trigger; validation errors belong inline on fields, not in a SnackBar",relationship:["complement"]},{name:"Button",note:"The user action that triggers the confirmation",relationship:["complement"]}]},Spinner:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{alignment:{description:"Horizontal alignment. Default: CENTER",enum:["LEFT","CENTER","RIGHT"],type:"string"},appearance:{description:"Spinner color variant. Default: PRIMARY",enum:["PRIMARY","SECONDARY","TERTIARY","NEUTRAL","INVERSE"],type:"string"},description:{description:"Description text below the spinner",type:"string"},fixedWindowCentered:{description:"Fixed-positioned centered in browser viewport. Default: false",type:"boolean"},showAfter:{description:"Delay in milliseconds before spinner appears. Default: 0",type:"number"},size:{description:"Spinner size variant. Default: M",enum:["3XS","2XS","XS","S","M","L","XL"],type:"string"},title:{description:"Title text above the spinner",type:"string"},windowCentered:{description:"Absolutely centered within parent container. Default: false",type:"boolean"}},type:"object"},acceptsChildren:!1,category:["atom"],keywords:["spinner","loading","loading indicator","loader","async","loading state","waiting","busy","page loading","suspense fallback","fetching","processing"],anatomy:{parts:[{name:"loading animation",required:!0,role:"Animated ring communicating that work is in progress"},{name:"title",role:"Short label for what is loading; recommended for full-page or long waits"},{name:"description",role:"Supporting detail under the title for potentially long-running operations"}],summary:"An animated loading ring, optionally followed by a title and description for longer waits. Can be centered in its positioned container (windowCentered) or over the viewport (fixedWindowCentered). Skeleton sub-loaders (Spinner.FieldLoader, Spinner.SettingsLoader, Spinner.ChartLoader, Spinner.ReportLoader, Spinner.AppGroupLoader) render layout-shaped placeholders instead of the ring."},guidance:{doNotUseWhen:["Progress toward a known completion time — use ProgressBar","The incoming content's layout can be estimated — use Skeleton or a Spinner.*Loader sub-loader to avoid layout shift","A button-triggered async action — use Button's isLoading instead of swapping in a Spinner","Blocking the whole viewport for a single panel — scope the spinner to its container instead of fixedWindowCentered"],useWhen:["Immediate feedback that an action triggered async work of unknown duration","Route-level or lazy-chunk loading — Spinner windowCentered is the common Suspense fallback","Inline loading inside fields, menus, or panels — use a small size (S/M), not L/XL","Full-page or long waits — add title and description so users know what is happening","Loading common layouts — use the matching skeleton sub-loader (FieldLoader, SettingsLoader, ChartLoader)"]},antiPatterns:["React Suspense fallbacks use a generic animated spinner instead of layout-preserving skeleton loaders","Page or section loading returns a bare `<Spinner />` with no skeleton, centering, or context","`withSpinner` data-fetch wrappers use the default animated ring instead of a skeleton sub-loader","Oversized spinner (`L` or `XL`) used for inline, header, or compact refresh contexts","Full-page or centered loaders run without `title` or `description` for potentially long waits","`fixedWindowCentered` blocks the entire viewport while only a panel or section loads","Manual CSS centering wrappers duplicate `windowCentered` behavior inconsistently"],selection:{confusedWith:[{component:"Skeleton",distinguishBy:"Skeleton preserves the incoming content's layout and avoids shift; Spinner is an indeterminate ring for when layout cannot be estimated (route changes, lazy chunks, unknown content)"},{component:"ContentLoader",distinguishBy:"ContentLoader renders custom SVG shimmer shapes matching a known layout; Spinner is the generic animated ring (its skeleton sub-loaders cover common presets)"},{component:"ProgressBar",distinguishBy:"ProgressBar shows determinate progress toward a known completion; Spinner is for unknown or variable durations"}]},relatedComponents:[{name:"Spinner.FieldLoader",note:"Skeleton loader for stacks of label-and-input fields",relationship:["child"]},{name:"Spinner.SettingsLoader",note:"Skeleton loader sized for a settings page layout",relationship:["child"]},{name:"Spinner.ChartLoader",note:"Bar-chart-shaped skeleton; position absolute inside a positioned container",relationship:["child"]},{name:"Spinner.ReportLoader",note:"Skeleton loader for report row lists (plus ReportShareLoader / ReportViewerLoader variants)",relationship:["child"]},{name:"Spinner.AppGroupLoader",note:"Skeleton loader for a group of app tiles or cards",relationship:["child"]},{name:"Skeleton",note:"Layout-preserving placeholder when the incoming content's structure is known",relationship:["alternative"]},{name:"ContentLoader",note:"Custom SVG shimmer shapes for known layouts",relationship:["alternative"]},{name:"ProgressBar",note:"Determinate progress when completion time is measurable",relationship:["alternative"]}]},SplitButton:{description:'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").',events:["press","dropdownChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Visual style variant. Ghost and Solid are not available. Default: PRIMARY",enum:["PRIMARY","ACCENT","OUTLINE","SUCCESS","INFO","DESTRUCTIVE","WARNING","ACTIVE"],type:"string"},dropdownList:{description:"List of items for the trailing dropdown menu",items:{additionalProperties:!1,properties:{label:{description:"Display text for the dropdown item",type:"string"},value:{description:"Value identifier for the dropdown item",type:"string"}},required:["label","value"],type:"object"},type:"array"},isDisabled:{description:"Disables both primary and trailing sections",type:"boolean"},isFluid:{description:"Expands button to full container width",type:"boolean"},label:{description:"Text content of the primary button section",type:"string"},size:{description:"Button size. Default: M",enum:["L","M","S","XS"],type:"string"},startIcon:{description:"Icon type from Icon.TYPES shown at start of primary section",type:"string"}},required:["label"],type:"object"},acceptsChildren:!1,category:["buttons"],keywords:["split button","primary action with menu","dropdown button","action variants","save options","export options"],anatomy:{parts:[{name:"Primary segment",required:!0,role:"Labeled button firing the dominant action on click"},{name:"Chevron segment",required:!0,role:"Opens the menu of related secondary actions; needs trailingAriaLabel"},{name:"Secondary actions menu",required:!0,role:"Dropdown listing the related variants of the primary action"}],summary:"Two joined segments: a primary button that fires the default action, and a chevron segment that opens a dropdown of closely related secondary actions."},guidance:{doNotUseWhen:["Navigation — use Anchor links, never SplitButton (or any button) for taking the user to a new page","The actions are peers with no dominant default — use a Dropdown","The related actions should all be icon buttons — use multiple Button.Icon","Peer actions that deserve separate visible buttons — do not bury them in the trailing menu"],useWhen:["One-click access to a primary action that has closely related but clearly secondary actions better grouped together","The secondary actions are variants of the primary (e.g. Save vs Save and close, Export vs Export as CSV)"]},antiPatterns:["Trailing dropdown without accessible name (`trailingAriaLabel`)","Dropdown lists peer actions that should be separate buttons","Primary navigation via SplitButton instead of link pattern","Destructive split buttons for routine export/download actions","Missing primary tooltip on icon-heavy split labels"],selection:{confusedWith:[{component:"Button",distinguishBy:"Button is a single action; SplitButton is one dominant action plus closely related variants behind a chevron"},{component:"Dropdown",distinguishBy:"Dropdown is a menu of peer actions with no dominant default; SplitButton always has a primary action that fires directly"},{component:"Button.Icon",distinguishBy:"Use multiple icon buttons when the related actions should all be icon-only; SplitButton has a labeled primary action"}]},relatedComponents:[{name:"Button",note:"Single-action button; SplitButton extends it with a secondary-actions menu",relationship:["parent"]},{name:"Dropdown",note:"Peer actions with no dominant default",relationship:["alternative"]},{name:"Button.Icon",note:"Related actions that should all be icon-only",relationship:["alternative"]},{name:"Anchor",note:"Navigation instead of actions — never use SplitButton for links",relationship:["alternative"]}]},SplitPane:{description:"Compose adaptive multi-pane layouts",events:["activePaneChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{activePaneId:{anyOf:[{type:"string"},{type:"null"}],description:"Controlled active pane id for single reflow. Bind for SDUI controlled use."},adaptation:{$ref:"#/$defs/SplitPaneAdaptation",description:"Container-driven priority collapse, reflow, and overflow behavior."},ariaLabel:{description:"Accessible name for the pane group.",type:"string"},ariaLabelledBy:{description:"Space-separated element id list that labels the pane group.",type:"string"},defaultActivePaneId:{description:"Initial active pane id for uncontrolled single reflow.",type:"string"},disableAnimation:{description:"Disable structural motion. Reduced-motion preferences always take precedence.",type:"boolean"},divider:{$ref:"#/$defs/SplitPaneDivider",description:"Divider line and resize-grip visibility."},gap:{description:"SDUI spacing-token name resolved to the numeric gutter size expected by React. Used when showGutter is true; default: space300.",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},id:{description:"Stable identifier for this pane group.",type:"string"},orientation:{description:"Main-axis layout direction. Default: horizontal.",enum:["horizontal","vertical"],type:"string"},persistence:{$ref:"#/$defs/SplitPanePersistence",description:"Selected uncontrolled pane state persisted by the group."},showGutter:{description:"Enable guttered Pane treatment. Default: false.",type:"boolean"}},required:["id"],type:"object"},acceptsChildren:!0},Ssn:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-label":{description:"Accessible label when no visible label",type:"string"},autoComplete:{description:"Browser autocomplete hint. Default: off",type:"string"},autoFocus:{description:"Auto-focus input on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial unmasked SSN value",type:"string"},fixedCharsPrefix:{description:"Fixes characters at the beginning of the value",type:"string"},fixedCharsSuffix:{description:"Fixes characters at the end of the value",type:"string"},id:{description:"Explicit HTML element id",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character length",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character length",type:"number"},placeholder:{description:'Placeholder text. Default: "XXX-XX-XXXX"',type:"string"},shouldEnforceUpperCase:{description:"Enforces uppercase on input characters",type:"boolean"},shouldSkipInitialFormatting:{description:"If true, skip applying mask on the default/initial value",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Unmasked SSN value (9 digits, no hyphens)",type:"string"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["ssn input","ssninput","social security number","ssn","tax id","W-4","I-9","payroll","identity verification","sensitive","dependent ssn"],anatomy:{parts:[{name:"Title/Label",required:!0,role:"Visible field label — required; aria-label alone is not sufficient"},{name:"Masked field",required:!0,role:"9-digit entry auto-formatted as XXX-XX-XXXX; stores unmasked digits"},{name:"Helper/Error text",required:!1,role:"Format guidance; replaced by a descriptive error on validation failure"}],summary:"A visible title/label above a masked 9-digit field that formats as XXX-XX-XXXX while the user types; entered digits are hidden (sensitive by default), and helper or error text appears below for format guidance and validation feedback."},guidance:{doNotUseWhen:["Canadian Social Insurance Numbers — use Input.Sin (XXX XXX XXX)","Custom format patterns not covered by a purpose-built input — use Input.Masker","Free-form text — use Input.Text; the SSN mask blocks anything that is not a 9-digit pattern","Non-US identifiers — use Input.Masker with a country-specific mask"],useWhen:["US employee forms collecting SSNs for payroll, tax, or HR purposes","US tax-related forms that require an SSN (W-4, W-2, I-9)","Identity verification during onboarding or compliance workflows","Dependent, beneficiary, or owner SSN collection — keep isSensitive enabled"]},antiPatterns:["SSN collected via generic text or manual masker instead of SsnInput","Explicit `isSensitive` omitted on Form.Input.Ssn (relying on implicit default)","Dynamic EOR fields use `aria-label` only without visible `title`"],selection:{confusedWith:[{component:"Input.Masker",distinguishBy:"Masker with a 999-99-9999 mask replicates the format but misses SSN's built-in sensitive handling and validation; Ssn is purpose-built for US SSNs"},{component:"Input.Sin",distinguishBy:"Sin is the Canadian equivalent (XXX XXX XXX); use Ssn only for US Social Security Numbers"},{component:"Input.Text",distinguishBy:"Text imposes no format or sensitivity; SSNs need the fixed mask, validation, and digit-masking Ssn provides"}]},relatedComponents:[{name:"Form",note:"Onboarding/dependent/owner flows use Form.Input.Ssn with isSensitive inside a Form",relationship:["complement"]},{name:"Input.Sin",note:"Canadian Social Insurance Number equivalent",relationship:["alternative"]},{name:"Input.Masker",note:"Parent component; use for other fixed-format identifiers (EIN, UBI)",relationship:["alternative"]},{name:"Input.Text",note:"Free-form identifiers without a fixed format",relationship:["alternative"]}]},Status:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Semantic appearance: PRIMARY/TERTIARY for neutral information, SUCCESS for positive outcomes, ERROR for failures or critical issues, WARNING for preemptive alerts, DISABLED for inactive or non-current states.",enum:["PRIMARY","SUCCESS","ERROR","WARNING","TERTIARY","DISABLED"],type:"string"},outlined:{description:"When true, renders status with a border outline. Default: false",type:"boolean"},size:{description:"Size of the status indicator (S, M, L, XL). Default: L",enum:["S","M","L","XL"],type:"string"},text:{description:"Text label to display in the status indicator. Required.",type:"string"}},required:["text","appearance"],type:"object"},acceptsChildren:!1,category:["atom"],keywords:["status","state indicator","status dot","active","inactive","workflow state","in review","failed","published","table status","sync status","connection status","dot indicator"],anatomy:{parts:[{name:"color dot",required:!0,role:"Semantic color signal for the state"},{name:"label",required:!0,role:"Short state text (e.g. Active, In review) — plain strings only, localized"},{name:"outline",role:"Optional border treatment via the outlined prop"}],summary:"A small colored dot immediately followed by a short text label, optionally wrapped in an outline. Sizes SMALL through EXTRA_LARGE; appearance carries the semantic meaning (SUCCESS for positive outcomes, ERROR for failures, WARNING for preemptive alerts, SURFACE/DISABLED for inactive states)."},guidance:{doNotUseWhen:["Categories, tags, or metadata keywords — use Label","Unread or pending counts — use Atoms.Badge","User-selected or dismissible filter criteria — use Chip","Rich or formatted content — Status text is a plain short string"],useWhen:["Real-time state of an item, process, or workflow — Active, In review, Failed, Published","Dense tables and long lists where users scan many rows' states at once (performant by design)","Layout.Grid status cells, integration sync states, and approval lifecycle readouts","Semantic color matched to meaning — ERROR only for actual failures, SURFACE for inactive states"]},antiPatterns:["Extra-large Status used in compact inline or dense table contexts","Error appearance applied to inactive or lapsed states (not failures)","Label and Status used interchangeably for the same kind of state on one screen","Numeric counts displayed through Status text instead of Atoms.Badge","Rich or formatted content forced into the Status text prop","Hardcoded English strings on Status labels (missing localization)","Custom dot-and-text status built locally alongside official Status usage","Status appearance used as decorative category color instead of semantic state"],selection:{confusedWith:[{component:"Label",distinguishBy:'Status communicates real-time workflow/process state with a colored dot; Label categorizes or tags items with keyword metadata ("Payroll", "Recommended") on a filled pill'},{component:"Atoms.Badge",distinguishBy:"Atoms.Badge shows numeric counts (unread, pending quantities) on tabs and icons; Status shows non-numeric state text"},{component:"Chip",distinguishBy:"Chip represents user-selected, dismissible filters or entities; Status is read-only state display"}]},relatedComponents:[{name:"Label",note:"Category/tag metadata rather than state; pick one per screen and stay consistent",relationship:["alternative"]},{name:"Atoms.Badge",note:"Numeric counts and quantities",relationship:["alternative"]},{name:"Chip",note:"Selectable or dismissible filter criteria and entity representations",relationship:["alternative"]}]},Stepper:{description:"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.",events:["click"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{activeStepIndex:{description:"Index of the currently active step (0-based)",type:"number"},activeStepType:{description:"Type of active step. Default: NORMAL",enum:["NORMAL","STANDALONE"],type:"string"},"aria-describedby":{description:"ID of element that describes the stepper",type:"string"},"aria-label":{description:"Accessibility label for the stepper",type:"string"},"aria-labelledby":{description:"ID of element that labels the stepper",type:"string"},isCompact:{description:"Renders compact version with reduced spacing",type:"boolean"},standAloneSteps:{description:"Array of standalone step configurations, displayed separately from main steps",items:{additionalProperties:!1,properties:{avatar:{additionalProperties:!1,description:"Avatar configuration to display with the step. Supports image URLs",properties:{imageUrl:{description:"URL of the avatar image",type:"string"},type:{description:"Avatar type",enum:["ICON","RIPPLING","TEXT","USER","NUMBER"],type:"string"}},type:"object"},badge:{additionalProperties:!1,description:"Badge configuration to display alongside the step title",properties:{appearance:{description:"Badge color appearance",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},"aria-label":{description:"Accessibility label for the badge",type:"string"},text:{description:"Badge text content",type:"string"}},required:["text"],type:"object"},description:{description:"Optional step description",type:"string"},href:{description:"URL for the step. Renders the step as an anchor tag with this href (semantic HTML only)",type:"string"},status:{description:"Step status indicator",enum:["COMPLETE","ERROR","TODO","SKIPPED"],type:"string"},title:{description:"Step title text",type:"string"}},required:["title"],type:"object"},type:"array"},steps:{description:"Array of step configurations",items:{additionalProperties:!1,properties:{avatar:{additionalProperties:!1,description:"Avatar configuration to display with the step. Supports image URLs",properties:{imageUrl:{description:"URL of the avatar image",type:"string"},type:{description:"Avatar type",enum:["ICON","RIPPLING","TEXT","USER","NUMBER"],type:"string"}},type:"object"},badge:{additionalProperties:!1,description:"Badge configuration to display alongside the step title",properties:{appearance:{description:"Badge color appearance",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},"aria-label":{description:"Accessibility label for the badge",type:"string"},text:{description:"Badge text content",type:"string"}},required:["text"],type:"object"},description:{description:"Optional step description",type:"string"},href:{description:"URL for the step. Renders the step as an anchor tag with this href (semantic HTML only)",type:"string"},status:{description:"Step status indicator",enum:["COMPLETE","ERROR","TODO","SKIPPED"],type:"string"},title:{description:"Step title text",type:"string"}},required:["title"],type:"object"},type:"array"},testId:{description:"Test identifier for the stepper. Default: stepper",type:"string"}},required:["steps"],type:"object"},acceptsChildren:!1,category:["navigation"],keywords:["stepper","wizard","multi-step form","onboarding","progress tracker","setup flow","funnel","checkout","guided setup","workflow stages","step navigation"],anatomy:{parts:[{name:"Step indicator",required:!0,role:"Visual status of the step — complete, skipped, error, active, or upcoming"},{name:"Step title",required:!0,role:"Concise label describing the step's content (one or two words)"},{name:"Description",role:"Supplementary context under the title"},{name:"Atoms.Badge / avatar",role:"Critical metadata such as a count or an assignee waiting on the step"},{name:"Standalone steps",role:"Extra steps (e.g. final confirmation) rendered after the main group"}],summary:"A horizontal row of steps connected by progress lines. Each step has a status indicator (default, complete, skipped, error), a title, and optional description, badge, or avatar. isCompact shrinks it for drawers, modals, and cards; standAloneSteps render extra steps after the main group."},guidance:{doNotUseWhen:["Navigating pages of data — use Paginate","Switching between independent content panels with no sequence — use Tabs","Single-step or non-sequential status — use Status or Notice","Simple percent-complete feedback — use ProgressBar","Letting users jump ahead — validate prior steps before allowing forward clicks"],useWhen:["Wizards and multi-page forms where users advance through a sequence of steps","Onboarding, funnel, and guided setup flows that visualize progress","Checkpoints in long-running workflows that must surface the current stage and errors","Navigable flows — wire onClick so users can return to completed steps","Space-constrained containers (modals, drawers, cards) — use isCompact"]},antiPatterns:["Progress indicator shown but steps are not clickable in navigable flows","Compact layout omitted in modals and other space-constrained containers","Step labels hardcoded in English instead of localized copy","Stepper used for tab-style section switching instead of sequential workflow","Clickable stepper allows jumping ahead without validating prior steps","Step status not updated when a step fails — errors only surfaced elsewhere","Legacy `ProgressSteps` or custom stepper UI used where Stepper is appropriate"],selection:{confusedWith:[{component:"ProgressSteps",distinguishBy:"ProgressSteps is the legacy display-oriented indicator (vertical/horizontal, numeric/icons); Stepper is the modern stepper with statuses, badges, avatars, and clickable navigation"},{component:"ProgressBar",distinguishBy:"ProgressBar shows a single percent-complete bar; Stepper shows discrete named stages with per-step status"},{component:"Tabs",distinguishBy:"Tabs switch between independent sibling panels with no notion of progress; Stepper implies sequential completion of a workflow"},{component:"Paginate",distinguishBy:"Paginate navigates unordered pages of data; Stepper tracks position in an ordered workflow"}]},relatedComponents:[{name:"ProgressSteps",note:"Legacy progress indicator; prefer Stepper for new multi-step flows",relationship:["alternative"]},{name:"ProgressBar",note:"Single-task percent completion without discrete steps",relationship:["alternative"]},{name:"Tabs",note:"Independent sibling views, not sequential progress",relationship:["alternative"]},{name:"Paginate",note:"Paging through data, not completing workflow steps",relationship:["alternative"]},{name:"Modal",note:"Common container for short flows — use isCompact",relationship:["complement"]},{name:"Drawer",note:"Common container for multi-step creation flows — use isCompact",relationship:["complement"]}]},SuperGrid:{description:"Server-configured data grid. The backend owns column definitions, sorting, search, quick filters, and empty-state messaging — only `gridId` is required. Use `contextFilters` to scope rows and filter options from external page state (e.g. a record selector).",events:["rowClick","rowActionClick"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{caption:{description:"Optional caption rendered below the grid title.",type:"string"},configContext:{additionalProperties:{type:"string"},description:"Query context sent to dynamic config modifiers for backend-owned variants.",propertyNames:{type:"string"},type:"object"},contextFilters:{description:"Filters derived from external state that scope data and filter-dropdown queries. Applied in addition to any user-applied filters.",items:{additionalProperties:!1,properties:{field:{type:"string"},operation:{enum:["eq","ne","gt","ge","lt","le","in","ni","contains","starts_with","ends_with","is_empty","is_not_empty"],type:"string"},value:{}},required:["field","operation","value"],type:"object"},type:"array"},gridId:{description:"Unique identifier for the grid configuration fetched from the backend.",type:"string"},height:{description:'Any CSS height string (e.g. "400px", "60vh"). When omitted the grid auto-sizes to its rows.',type:"string"},rowActionClickedData:{description:"Bind to state with $bindState to receive clicked row action row data before rowActionClick emits."},rowActionClickedId:{description:"Bind to state with $bindState to receive the clicked row action id before rowActionClick emits.",type:"string"},rowActions:{description:"Static row action buttons. On click, SuperGrid writes rowActionClickedId and rowActionClickedData before emitting rowActionClick.",items:{additionalProperties:!1,properties:{appearance:{description:"Button appearance. Defaults to GHOST.",enum:["OUTLINE","GHOST"],type:"string"},icon:{description:"Icon name from Icon.TYPES, such as EDIT_OUTLINE.",type:"string"},iconColor:{description:"Icon color token or CSS color string.",type:"string"},id:{description:"Unique identifier for the row action.",type:"string"},isDisabled:{description:"Disable the action for every row.",type:"boolean"},isHidden:{description:"Hide the action for every row.",type:"boolean"},label:{description:"Visible label for the row action.",type:"string"},placement:{description:"Where the action is rendered. Defaults to the Grid row-actions behavior.",enum:["inline","menu"],type:"string"},tip:{description:"Tooltip text for the action.",type:"string"},type:{description:"Button style to render. Defaults to Button.",enum:["Button","IconButton"],type:"string"}},required:["id","label"],type:"object"},type:"array"},rowClickedData:{description:"Bind to state with $bindState to receive clicked row data before rowClick emits."},width:{anyOf:[{type:"string"},{type:"number"}],description:"Grid width as a CSS width string or pixel number."}},required:["gridId"],type:"object"},acceptsChildren:!1},SupportButton:{description:"A prominent card-like action button with title, caption, icon or image, and optional badge for dashboard entry points.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{badge:{description:"Badge indicator type shown on the avatar (NEGATIVE, WARNING, POSITIVE, NEUTRAL)",enum:["NEGATIVE","WARNING","POSITIVE","NEUTRAL"],type:"string"},caption:{description:"Secondary descriptive text below the title",type:"string"},icon:{description:"Icon type from Icon.TYPES. Default: HEADPHONES_FILLED",type:"string"},id:{description:"DOM id selector for the button element",type:"string"},image:{description:"Image URL displayed instead of an icon in the avatar",type:"string"},imageBackground:{description:"Surface color token for the avatar when using an image",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},title:{description:"Primary text label displayed on the button",type:"string"},to:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{openInNewTab:{description:"Open link in new tab. Default: false",type:"boolean"},path:{description:"URL path for navigation",type:"string"}},required:["path"],type:"object"}],description:"Navigation destination. When provided, button handles navigation automatically"}},required:["title"],type:"object"},acceptsChildren:!1,category:["buttons"],keywords:["support button","supportbutton","support","help","customer support","chat","contact us","help center","assistance","get help"],anatomy:{parts:[{name:"Graphic",required:!0,role:"Leading icon, avatar, or image identifying the support channel"},{name:"Title",required:!0,role:"Primary label for the support action"},{name:"Caption",required:!1,role:"Secondary text with context such as availability or response time"},{name:"Atoms.Badge",required:!1,role:"Optional status indicator (e.g. online, unread count)"}],summary:"An elevated container with a leading graphic (icon, avatar, or image), a title plus secondary caption text, and an optional status badge. More prominent than a plain Button — designed to be discoverable as the help entry point."},guidance:{doNotUseWhen:["The action is not support-related — use Button","The action must remain visible throughout the journey — use Button.Floating","A simple link to help documentation — use Anchor","Hiding support behind overflow menus — keep the entry discoverable"],useWhen:["Providing immediate access to customer support resources (chat, call, help desk)","Products where user guidance or a customer executive is frequently required","Support entries needing title + caption hierarchy, a graphic, or a status badge"]},antiPatterns:["Support entry built with custom cards/links instead of SupportButton","Generic primary Button used for help entry — missing caption hierarchy","Customer chat triggers hidden in overflow menus — support hard to discover"],selection:{confusedWith:[{component:"Button",distinguishBy:"Button is a generic labeled action; Button.Support is the support-specific entry with title + caption hierarchy and graphic"},{component:"Button.Floating",distinguishBy:"Button.Floating is an icon-only FAB for screen actions; Button.Support is a labeled support entry with caption and optional badge"},{component:"Card",distinguishBy:"Hand-assembled cards or links for support entry lose the built-in hierarchy and a11y; Button.Support provides it out of the box"}]},relatedComponents:[{name:"Button",note:"Use plain Button for non-support actions that need visibility",relationship:["parent"]},{name:"Button.Floating",note:"Icon-only floating action that must stay visible across the journey",relationship:["alternative"]},{name:"Card",note:"Custom surfaces; avoid rebuilding support entry from cards or links",relationship:["alternative"]},{name:"Anchor",note:"Simple navigation to help docs when no support action is involved",relationship:["alternative"]}]},Survey:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},caption:{description:"Caption text displayed below the survey",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{anyOf:[{type:"string"},{type:"number"}]},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Initial selected value(s) when uncontrolled"},isDisabled:{description:"Disables all survey buttons",type:"boolean"},isInvalid:{description:"Marks the survey as invalid",type:"boolean"},isMulti:{description:"Allow multiple selections. Default: false",type:"boolean"},isReadOnly:{description:"Makes the survey read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isVertical:{description:"Stack options vertically. Default: false",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Array of survey option items with label and value",items:{additionalProperties:!1,properties:{icon:{description:"Pebble icon name displayed for the option",type:"string"},isDisabled:{description:"Disable this specific option",type:"boolean"},label:{anyOf:[{type:"string"},{type:"number"}],description:"Display label for the option"},selectionColor:{description:"Override selected surface color token for this option",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Value when selected"}},required:["value"],type:"object"},type:"array"},rangeLabels:{additionalProperties:!1,description:"Labels for lowest and highest options",properties:{lower:{description:"Label for the lowest option",type:"string"},upper:{description:"Label for the highest option",type:"string"}},required:["lower","upper"],type:"object"},theme:{description:"Survey theme. TWO_LINE stacks label below value",enum:["TWO_LINE"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{anyOf:[{type:"string"},{type:"number"}]},{items:{anyOf:[{type:"string"},{type:"number"}]},type:"array"}],description:"Selected value(s). Single value when isMulti is false, array when true"}},required:["list"],type:"object"},acceptsChildren:!1,category:["input"],keywords:["survey input","surveyinput","deprecated","rating scale","likert scale","nps","net promoter score","agree disagree","yes no","numeric scale","feedback","performance review question"],anatomy:{parts:[{name:"Segments",required:!0,role:"Selectable options from the list prop; text or icons, not both"},{name:"Range labels",required:!1,role:"Lower/upper anchor labels framing the scale (e.g. 'Not like' / 'Like')"}],summary:"A single-row (or vertical, via isVertical) strip of up to 5 selectable segments built from the list prop — each with a label and/or icon and optional selectionColor — with optional upper/lower range labels at the ends. THEMES.TWO_LINE lets long options like 'Strongly Disagree' wrap to two lines."},guidance:{doNotUseWhen:["Writing new code — use Input.SegmentedControl instead","Navigating between content areas — use Tabs","Binary decisions like yes/no or on/off — use Input.Switch or a toggle","Options with several words or long phrases — use Input.Radio","Mixing icons and text in the same control — pick one per design guidelines"],useWhen:["Maintaining existing survey scales in performance-review custom forms (Likert, NPS, numeric, yes/no)","Nothing else — this component is deprecated; use Input.SegmentedControl for all new implementations"]},antiPatterns:["Deprecated Survey used instead of Input.SegmentedControl","Live survey answer rendered without field name or programmatic label","Icon and text combined in the same segment control","Four-option icon scale used where docs recommend toggle for binary decisions"],selection:{confusedWith:[{component:"Input.SegmentedControl",distinguishBy:"Input.SegmentedControl is the supported replacement — Survey is deprecated and will be removed; always pick Input.SegmentedControl for new code"},{component:"Input.Radio",distinguishBy:"Radio suits options of several words or longer phrases; Survey/Input.SegmentedControl works best with options of at most a couple of words"},{component:"Input.Switch",distinguishBy:"Switch is for binary yes/no or on/off decisions; scales with 3–5 related options are what Survey (now Input.SegmentedControl) is for"}]},relatedComponents:[{name:"Input.SegmentedControl",note:"Replacement — migrate existing Survey usages and use it for all new implementations",relationship:["alternative"]},{name:"Input.Radio",note:"For choices with longer phrase labels",relationship:["alternative"]},{name:"Input.Switch",note:"For binary decisions instead of a two-option scale",relationship:["alternative"]},{name:"Tabs",note:"For navigating between content segments — segmented controls are for input, not navigation",relationship:["alternative"]}]},Switch:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the switch",type:"string"},"aria-label":{description:"ARIA label for accessibility",type:"string"},"aria-labelledby":{description:"ARIA labelledby reference",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},compact:{description:"Use compact size variant",type:"boolean"},defaultValue:{description:"Initial toggle state when uncontrolled",type:"boolean"},isDisabled:{description:"Disables the switch",type:"boolean"},isReadOnly:{description:"Makes the switch read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the switch",type:"string"},offLabel:{description:"Label text when switch is off",type:"string"},onLabel:{description:"Label text when switch is on",type:"string"},rightAlign:{description:"Align switch to the right",type:"boolean"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{description:"Tooltip text content",type:"string"},placement:{description:"Tooltip placement relative to the switch",enum:["top","top-start","top-end","right","right-start","right-end","bottom","bottom-start","bottom-end","left","left-start","left-end","auto","auto-start","auto-end"],type:"string"}},required:["content"],type:"object"}],description:"Tooltip text or basic tooltip configuration to display"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Toggle state bound to state",type:"boolean"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["switch","toggle","on off","enable disable","settings toggle","feature flag","instant setting","activation","filter toggle","switchinput"],anatomy:{parts:[{name:"handle",required:!0,role:"Circular thumb indicating the current on/off state"},{name:"track",required:!0,role:"Elongated shape the handle slides along"},{name:"label",role:"Text naming the setting (onLabel/offLabel, often the same string for both states)"}],summary:"An elongated track with a circular handle that slides between on and off states, with an optional label next to it (onLabel/offLabel). Common layouts: standalone with state labels, compact (label-free, needs aria-label or nearby text), and rightAlign rows where the setting name sits left and the switch sits right."},guidance:{doNotUseWhen:["The choice is deferred until a Save/Apply submit — use Input.Checkbox inside a Form","A required acknowledgment (terms, consent) — use Input.Checkbox with isTrue validation","Choosing between 2+ named options — use Input.Radio or Input.SegmentedControl","The state needs an error or indeterminate display — Switch cannot show one"],useWhen:["An on/off setting that takes effect instantly, with no save or submit step","Feature flags, dev-tool toggles, and visibility filters (show/hide completed)","Settings list rows — use rightAlign with the setting name on the left","Layout.Grid/toolbar controls such as locking filters or showing invalid rows","Inside a Form's data-entry flow, use Form.Input.Switch"]},antiPatterns:["Switch used for deferred batch-save settings instead of Input.Checkbox","Switch with no label props when setting name is not wired elsewhere","Standalone Switch inside Form submit flows","Settings list row with Switch missing rightAlign layout","Yes/No state labels on the switch while the setting name lives elsewhere","Switch changes staged behind SettingsFooter — appears instant but requires Save","Legacy Field wrapper around Switch instead of built-in label or ListItem row"],selection:{confusedWith:[{component:"Input.Checkbox",distinguishBy:"Switch applies instantly with no submit and cannot show error/indeterminate states; Input.Checkbox records a selection submitted with a form"},{component:"Input.SegmentedControl",distinguishBy:"Input.SegmentedControl switches between two or more named options; Switch is a single binary on/off control"},{component:"Input.Radio",distinguishBy:"Radio presents mutually exclusive named choices for comparison; Switch toggles one independent setting"}]},relatedComponents:[{name:"Form.Input.Switch",note:"Form-aware variant when the toggle value is part of a submitted form",relationship:["complement"]},{name:"Form",note:"Container when the switch participates in validated data entry",relationship:["complement"]},{name:"ListItem",note:"Common settings-row container; switch right-aligned with the setting name on the left",relationship:["complement"]},{name:"Input.Checkbox",note:"Deferred on/off saved via form submit, or acknowledgment requiring validation",relationship:["alternative"]},{name:"Input.SegmentedControl",note:"Switching between two or more named modes rather than on/off",relationship:["alternative"]},{name:"Input.Radio",note:"Mutually exclusive named choices instead of a binary toggle",relationship:["alternative"]}]},Tab:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{activeIndex:{description:"Controlled active tab index",type:"number"},"aria-label":{description:"Accessible label for the tabs",type:"string"},"aria-labelledby":{description:"ID of element that labels the tabs",type:"string"},defaultActiveIndex:{description:"Tab index to be active by default",type:"number"},isCompact:{description:"Use compact spacing",type:"boolean"},isLogoRound:{description:"Whether to display logo with rounded corners",type:"boolean"},isVertical:{description:"Display tabs in vertical orientation (only for LINK type)",type:"boolean"},items:{description:"JSON-only selection model for state-bound tabs with title, value, and optional icon/badge/tip",items:{additionalProperties:!1,properties:{badge:{additionalProperties:!1,description:"Badge to display on the tab",properties:{appearance:{description:"Badge appearance variant: INFO_DARK, INFO_LIGHT, ERROR_DARK, ERROR_LIGHT, PRIMARY_DARK, PRIMARY_LIGHT, SUCCESS_DARK, SUCCESS_LIGHT, WARNING_DARK, WARNING_LIGHT, NEUTRAL, BLACK",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},text:{description:"Text to display in the badge",type:"string"}},required:["text"],type:"object"},href:{description:"Semantic href for LINK tabs; navigation is prevented by Pebble Tabs",type:"string"},icon:{description:"Icon name for the tab (e.g., FOLDER_OUTLINE)",type:"string"},isDisabled:{description:"Whether this tab is disabled",type:"boolean"},tip:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{description:"Tip content text",type:"string"},testId:{description:"Test ID for the tip",type:"string"}},required:["content"],type:"object"}],description:"Tooltip to show on hover"},title:{description:"Display text for the tab",type:"string"},value:{description:"JSON-only tab value stored when the tab changes"}},required:["title","value"],type:"object"},type:"array"},list:{description:"React Tabs list branch for LINK tabs, including optional nested links",items:{additionalProperties:!1,properties:{badge:{additionalProperties:!1,description:"Badge to display on the link tab",properties:{appearance:{description:"Badge appearance variant: INFO_DARK, INFO_LIGHT, ERROR_DARK, ERROR_LIGHT, PRIMARY_DARK, PRIMARY_LIGHT, SUCCESS_DARK, SUCCESS_LIGHT, WARNING_DARK, WARNING_LIGHT, NEUTRAL, BLACK",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},text:{description:"Text to display in the badge",type:"string"}},required:["text"],type:"object"},links:{description:"Nested link tabs for vertical LINK tabs",items:{additionalProperties:!1,properties:{badge:{additionalProperties:!1,description:"Badge to display on the nested link tab",properties:{appearance:{description:"Badge appearance variant: INFO_DARK, INFO_LIGHT, ERROR_DARK, ERROR_LIGHT, PRIMARY_DARK, PRIMARY_LIGHT, SUCCESS_DARK, SUCCESS_LIGHT, WARNING_DARK, WARNING_LIGHT, NEUTRAL, BLACK",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},text:{description:"Text to display in the badge",type:"string"}},required:["text"],type:"object"},title:{description:"Display text for the nested link tab",type:"string"}},required:["title"],type:"object"},type:"array"},title:{description:"Display text for the link-style tab",type:"string"}},required:["title"],type:"object"},type:"array"},logoUrl:{description:"URL of logo image to display with title",type:"string"},stretchH:{description:"Stretch tabs horizontally",type:"boolean"},stretchV:{description:"Stretch tabs vertically to fill available height",type:"boolean"},subtitle:{description:"Subtitle text",type:"string"},supportLink:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{href:{description:"URL for the support/help link",type:"string"},icon:{description:"Pebble icon name for the support link",type:"string"},text:{description:"Visible support link text override",type:"string"}},type:"object"}],description:"Support/help link as a URL string or a serializable object branch"},theme:{description:"Visual theme: BOX, BOX_HEADER, CENTER, GREY_OVERFLOW_GRADIENT, WHITE_OVERFLOW_GRADIENT, NO_PADDING",enum:["BOX","BOX_HEADER","CENTER","GREY_OVERFLOW_GRADIENT","WHITE_OVERFLOW_GRADIENT","NO_PADDING"],type:"string"},title:{description:"Title text to display above tabs",type:"string"},titleContent:{description:"Subtitle or additional content below the title",type:"string"},type:{description:"Visual style: BASIC, SWITCH, LINK, or SWITCH_WITH_ICON_ONLY",enum:["BASIC","SWITCH","LINK","SWITCH_WITH_ICON_ONLY"],type:"string"},value:{description:"JSON-only selected tab value metadata bound to state when using items"},width:{description:"Width of the tab container in pixels",type:"number"}},type:"object"},acceptsChildren:!1,category:["navigation"],keywords:["tabs","tab bar","tab navigation","switch views","tabbed interface","tab","sections","sub-pages","details page sections","settings sections","admin panels"],anatomy:{parts:[{name:"Tab bar",required:!0,role:"Container of tab items with active indicator; stretchH fills available width, isCompact shrinks footprint"},{name:"Tabs.Tab",required:!0,role:"Single tab + its content panel; title required, optional icon, badge, tip, and id"},{name:"Header",role:"Optional logoUrl + title + titleContent above the bar"},{name:"Atoms.Badge",role:"Optional count or indicator on a tab item"}],summary:"A horizontal bar of clickable tab items (optionally with a header logo/title above), each with an active indicator. A tab item contains an optional icon, a label, and an optional badge count; the active tab's content panel renders below the bar. Variants: Basic (underlined), Tabs.SWITCH (toggle-style), Tabs.LINK (navigation-style, supports isVertical left rail with nested TabGroup/TabSection)."},guidance:{doNotUseWhen:["Making a single choice that reshapes the current view (filter/sort/mode) — use Input.SegmentedControl","Showing nested location within the app — use Breadcrumb","Passing both children and list — list wins; pick one composition style","Vertical layouts with Basic tabs — isVertical works only for Tabs.LINK","Deeply different pages — navigate with routes, not tabs"],useWhen:["Organizing groups of related content at the same hierarchy level on one page","Detail/admin pages split into sibling views (structure, details, history, settings)","Selection must sync to URL or external state — control via activeIndex + onChange","Top-level page sections with route-style navigation — use Tabs.LINK (supports vertical left rail and nesting)","Compact or dense regions needing a smaller tab footprint — isCompact or Tabs.SWITCH"]},selection:{confusedWith:[{component:"Input.SegmentedControl",distinguishBy:"Input.SegmentedControl picks one option that reshapes the current view (filter/sort/mode, radio-like); Tabs switch between entirely separate sibling content panes"},{component:"Tabs.SWITCH",distinguishBy:"Tabs.SWITCH is the toggle-style variant for finer, more granular splits in dense UI; default Tabs (Basic) is for clear top-level sibling views"},{component:"Tabs.LINK",distinguishBy:"Tabs.LINK is for navigation-style tabbing tied to routes (also the only variant supporting vertical left-rail and nested groups); Basic Tabs keep content switching in-page"},{component:"Breadcrumb",distinguishBy:"Breadcrumb shows where the user is in a nested hierarchy; Tabs navigate between parallel siblings at the same level"}]},relatedComponents:[{name:"Tabs.Tab",note:"Tab item plus its content panel; pass title, optional icon/badge/tip/id",relationship:["child"]},{name:"Tabs.LINK",note:"Navigation-style variant; supports isVertical and route sync",relationship:["child"]},{name:"Tabs.SWITCH",note:"Toggle-style variant for compact, granular view splits",relationship:["child"]},{name:"Tabs.TabGroup",note:"Groups nested tabs; only for vertical link tabs",relationship:["child"]},{name:"Tabs.TabSection",note:"Section wrapper inside vertical nested tab structures",relationship:["child"]},{name:"Input.SegmentedControl",note:"Single-choice selection that alters the current view instead of swapping panes",relationship:["alternative"]},{name:"Breadcrumb",note:"Wayfinding in nested hierarchy, not parallel siblings",relationship:["alternative"]}]},TableBasic:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{columns:{description:"JSON-only table abstraction: column definitions {header, key, align?, width?, wrapText?}",items:{additionalProperties:!1,properties:{align:{description:"Text alignment for this column",enum:["left","center","right"],type:"string"},header:{description:"Column header text",type:"string"},key:{description:"Key to look up cell value in each row object",type:"string"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Column width in px (number) or CSS string"},wrapText:{description:"Whether to wrap text in cells of this column. Default: false (nowrap)",type:"boolean"}},required:["header","key"],type:"object"},type:"array"},rowHeight:{description:"Custom height in px for all table rows",type:"number"},rows:{description:"JSON-only table abstraction: row objects keyed by column key",items:{additionalProperties:{anyOf:[{type:"string"},{type:"number"},{type:"boolean"},{type:"null"}]},propertyNames:{type:"string"},type:"object"},type:"array"},title:{description:"Title displayed above the table",type:"string"},width:{description:"Table container width in px",type:"number"}},required:["columns","rows"],type:"object"},acceptsChildren:!1,category:["dataDisplay"],keywords:["table basic","tablebasic","table","data table","grid","rows and columns","column headers","spreadsheet","comparison","tabular data","read-only table"],anatomy:{parts:[{name:"TableBasic.THead",required:!1,role:"Header section holding the column-heading row"},{name:"TableBasic.Th",required:!1,role:"Column header cell; concise sentence-case labels"},{name:"TableBasic.TBody",required:!0,role:"Body section holding data rows"},{name:"TableBasic.Tr",required:!0,role:"One data row; height adjustable"},{name:"TableBasic.Td",required:!0,role:"Data cell; supports alignment, width, and text wrapping"}],summary:"A card-wrapped table: an optional title on top, a header row of Th cells inside THead, and body rows (Tr) of Td cells inside TBody, separated by dividers. Columns are fluid by default and can be given fixed widths; cell content is primarily text."},guidance:{doNotUseWhen:["Sorting, filtering, pagination, or cell editing is needed — use the interactive Layout.Grid","No column headings are needed or many cells would be empty — use ListItem","Data is hierarchical — use NestedList","Rows/columns are just for layout rather than data — use Layout primitives","Long-form content dominates — a list format reads better"],useWhen:["Displaying read-only multi-column data users scan and compare row by row","Primarily text content organized under clear column headers","Mapping or summary tables — stage mappings, country codes, wire details, permission descriptions","Admin/superuser dashboards showing parameter-value style tabular data"]},antiPatterns:["Structured data tables missing column headers","Interactive grid behaviors built on a presentational table","Center alignment applied beyond icons and ratings","Raw developer field names shown as row labels","Styled overrides on table primitives breaking DS surfaces","Inner table primitive used without the card wrapper","Nested tables inside cells","Hardcoded pixel widths on header or body cells"],selection:{confusedWith:[{component:"ListItem",distinguishBy:"ListItem rows are title+caption with slots and no column alignment; TableBasic is for data that needs column headers and cross-row comparison"},{component:"Layout.Grid",distinguishBy:"Layout.Grid (block) is the interactive data grid — sorting, filtering, editing, cell interaction; TableBasic is presentational and read-only"},{component:"NestedList",distinguishBy:"NestedList shows hierarchical multi-level data as an indented tree; TableBasic shows flat rows in aligned columns"},{component:"DetailsCard",distinguishBy:"DetailsCard is label-value pairs for a single record; TableBasic compares many records across shared columns"},{component:"Card",distinguishBy:"Card is a generic content container; TableBasic is specifically a styled semantic table with table primitives"}]},relatedComponents:[{name:"TableBasic.THead",note:"Wraps the header row; structured data tables should always have column headers",relationship:["child"]},{name:"TableBasic.TBody",note:"Wraps data rows",relationship:["child"]},{name:"TableBasic.Tr",note:"Row primitive",relationship:["child"]},{name:"TableBasic.Th",note:"Header cell; TableBasic.ALIGNMENTS and LAYOUT constants cover alignment and layout",relationship:["child"]},{name:"TableBasic.Td",note:"Body cell; reserve center alignment for icons and ratings",relationship:["child"]},{name:"ListItem",note:"Use when no column headings are needed or cells would often be empty",relationship:["alternative"]},{name:"NestedList",note:"Use for multi-level information with concise labels instead of a columnar structure",relationship:["alternative"]},{name:"Layout.Grid",note:"Use for sorting, filtering, pagination, or editable/interactive cells",relationship:["alternative"]}]},Text:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{align:{description:"Text alignment",enum:["left","center","right"],type:"string"},as:{description:'HTML element to render (e.g. "p", "span", "div", "pre"). Default: p',type:"string"},color:{description:"Pebble text/icon color token resolved via the current theme.",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},decoration:{description:'Text decoration CSS value (e.g. "underline", "line-through")',type:"string"},inline:{description:"Display as inline element instead of block",type:"boolean"},lineClamp:{description:"Max visible lines before truncation with ellipsis",type:"number"},maxWidth:{description:'Maximum width CSS value for the text element (e.g. "200px", "50%")',type:"string"},mono:{description:"Apply monospace font family",type:"boolean"},text:{description:"Text content",type:"string"},transform:{description:'Text transform CSS value (e.g. "uppercase", "capitalize", "lowercase")',type:"string"},typestyle:{description:'Pebble typestyle token name (e.g. "typestyleBodyMedium"). Default: typestyleBodyMedium',enum:["typestyleBodyLarge","typestyleBodyLarge500","typestyleBodyLarge600","typestyleBodyLargeEmphasized","typestyleBodyMedium","typestyleBodyMedium400","typestyleBodyMedium500","typestyleBodyMedium600","typestyleBodyMediumEmphasized","typestyleBodySmall","typestyleBodySmall400","typestyleBodySmall500","typestyleBodySmall600","typestyleBodySmallEmphasized","typestyleDisplayLarge","typestyleDisplayLarge600","typestyleDisplayMedium600","typestyleDisplaySmall600","typestyleLabelExtraLarge400","typestyleLabelExtraLarge500","typestyleLabelExtraLarge600","typestyleLabelExtraLarge700","typestyleLabelExtraSmall","typestyleLabelExtraSmallWide","typestyleLabelLarge","typestyleLabelLarge400","typestyleLabelLarge500","typestyleLabelLarge600","typestyleLabelMedium","typestyleLabelMedium500","typestyleLabelMedium600","typestyleLabelMedium700","typestyleLabelSmall","typestyleLabelSmall500","typestyleLabelSmall600","typestyleLabelSmallEmphasized","typestyleTitleExtraLarge600","typestyleTitleExtraSmall600Caps","typestyleTitleLarge","typestyleTitleLarge600","typestyleTitleMedium","typestyleTitleMedium600","typestyleTitleSmall","typestyleTitleSmall400","typestyleTitleSmall600","typestyleV2BodyLarge","typestyleV2BodyLargeEmphasized","typestyleV2BodyMedium","typestyleV2BodyMediumEmphasized","typestyleV2BodySmall","typestyleV2BodySmallEmphasized","typestyleV2DisplayLarge","typestyleV2LabelExtraSmall","typestyleV2LabelExtraSmallWide","typestyleV2LabelLarge","typestyleV2LabelMedium","typestyleV2LabelSmall","typestyleV2LabelSmallEmphasized","typestyleV2TitleLarge","typestyleV2TitleMedium","typestyleV2TitleSmall"],type:"string"}},type:"object"},acceptsChildren:!1,category:["atom"],keywords:["text","typography","body text","label","heading","title","caption","truncation","ellipsis","line clamp","monospace","copy","paragraph","typestyle"],anatomy:{parts:[{name:"content",required:!0,role:"Character content passed as children — prose, headings, or UI copy"},{name:"typestyle",required:!0,role:"Required theme typography token (e.g. theme.typestyleBodyLarge) that drives font metrics and element semantics"},{name:"overflow tooltip",role:"Built-in tooltip shown on hover when lineClamp truncates content (tipOnOverflow)"}],summary:"A single styled text element. The typestyle prop picks the typography token and the rendered HTML element is derived from it (overridable via as). Optional color token, lineClamp truncation with a built-in tipOnOverflow tooltip, and mono fixed-width rendering."},guidance:{doNotUseWhen:["Clicking should navigate — use Anchor (nest it inside Text for inline links)","Labeling a form input — use Label or Field for the correct accessibility association","Rendering a glyph or graphic — use Icon","A plain semantic element with no typography token — use native <span>/<p>/<pre> instead of a dummy typestyle"],useWhen:["Rendering any visible body, label, heading, or display copy in a Pebble app","Typography must adapt to the active theme and color mode via typestyle tokens","Truncating long strings — lineClamp plus tipOnOverflow keeps the full value readable","Monospace rendering for code snippets, IDs, or numeric strings (mono prop)","Loading states — wrap in Skeleton so the placeholder inherits typestyle metrics"]},antiPatterns:["Static theme lookup (`getCurrentTheme()`) instead of reactive `useTheme()` hook","Legacy `Typography` and `Text` mixed in the same file","External `Tip` wrapper used for text overflow instead of `tipOnOverflow`","Truncated text with no way to read the full value (`lineClamp` without tooltip)","Missing required `typestyle` prop on `Text`","Emphasis via raw `<b>` tags instead of emphasised typestyle tokens","Nested styled spans inside `Text` overriding color or typography",'`color="inherit"` bypassing theme color tokens',"Manual CSS ellipsis (`textOverflow`) instead of `lineClamp` + `tipOnOverflow`","Standalone legacy `Typography` usage without `Text` migration"],selection:{confusedWith:[{component:"Typography",distinguishBy:"Typography is the legacy text API being migrated away from; Text is the canonical token-driven component — never mix both in one file"},{component:"Anchor",distinguishBy:"Anchor navigates via href; Text renders non-interactive copy. For inline links, nest Anchor inside Text"},{component:"Label",distinguishBy:"Label is tied to a form control with the correct accessibility association; Text is for standalone copy with no input relationship"},{component:"Icon",distinguishBy:"Icon renders a glyph from the icon font; Text renders character content only"}]},relatedComponents:[{name:"Anchor",note:"Nest inside Text for inline links that inherit surrounding typography",relationship:["complement"]},{name:"Skeleton",note:"Wrap Text while loading; the skeleton inherits typestyle metrics to prevent layout shift",relationship:["complement"]},{name:"Typography",note:"Legacy predecessor — migrate usages to Text",relationship:["alternative"]},{name:"Label",note:"Use for form-control labels and captions needing accessibility associations",relationship:["alternative"]},{name:"Icon",note:"Use for glyphs, not character content",relationship:["alternative"]}]},Textarea:{description:"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.",events:["change","blur","focus","keydown"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this textarea",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this textarea",type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},hasCharsLimit:{description:"Show character count indicator. Requires maxLength to be set",type:"boolean"},height:{description:"Fixed height in pixels",type:"number"},id:{description:"Unique DOM id for the textarea element",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxHeight:{description:"Maximum height in pixels",type:"number"},maxLength:{description:"Maximum character count. Default: 10000",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},rows:{description:"Number of visible text rows",type:"number"},theme:{description:"Visual theme variant",enum:["NO_BOX"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current text value bound to state",type:"string"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["textarea","multi-line text","comment","note","description","message","reason","feedback","long text","paragraph","free-form text","character limit"],anatomy:{parts:[{name:"Label",required:!0,role:"Guides the user on what to enter; mandatory unless exempted for accessibility"},{name:"Container",required:!0,role:"Multi-line field capturing the user's free-form text"},{name:"Help / error text",required:!1,role:"Supporting hint or inline validation message below the field"},{name:"Counter",required:!1,role:"Shows entered vs permitted characters when maxLength is set with hasCharsLimit"},{name:"Resize handle",required:!1,role:"Lets users adjust the field height"}],summary:"A labeled multi-line text container. Label sits above the field with an optional required indicator and tooltip; the container holds the user's paragraph-length input; help or error text appears below, with an optional character counter and a resize handle for adjusting height."},guidance:{doNotUseWhen:["Short single-line entries like names or titles — use Input.Text","Specific formats such as dates or emails — use Input.Date or Input.Email","Free-form text that should offer suggestions — use Input.TextAutoSuggest","Rich formatted content (bold, lists, links) — use the rich text editor instead"],useWhen:["Longer free-form text: descriptions, comments, notes, rejection reasons, personalized messages","A single multi-line field in a Modal.confirm or Drawer flow","Entries with a character limit — pair maxLength with hasCharsLimit for a visible counter","Displaying a multi-line value read-only via isReadOnly (not isDisabled)","Multi-line data entry inside a Form — use Form.Input.Textarea with title and validations"]},antiPatterns:["Multi-line data-entry fields built outside Form, bypassing integrated validation","Visual label present but not programmatically linked to the textarea","Character limit set without visible counter for users","Form textarea missing a `title` (accessible field name)","Field validation surfaced via toast instead of inline textarea errors","Placeholder-only textarea with no persistent label","Error styling on textarea without an inline error message","Read-only output shown in disabled textarea instead of `isReadOnly`"],selection:{confusedWith:[{component:"Input.Text",distinguishBy:"Input.Text is single-line for short entries (names, titles); Textarea keeps all text visible across rows for paragraph-length input"},{component:"Input.TextAutoSuggest",distinguishBy:"Input.TextAutoSuggest is a single-line input with a suggestions dropdown; Textarea has no suggestions and accepts multi-line text"},{component:"Field",distinguishBy:"Field is a legacy label wrapper around a single input; Textarea is the input itself — use Form.Input.Textarea for label + validation inside a Form"}]},relatedComponents:[{name:"Form.Input.Textarea",note:"Form-aware variant with title, validation, and error display; always prefer it inside a Form",relationship:["complement"]},{name:"Form",note:"Container for multi-field data entry; register the textarea via Form.Input.Textarea",relationship:["complement"]},{name:"Modal",note:"Very common container — reason/message textareas inside confirm and edit modals",relationship:["complement"]},{name:"Input.Text",note:"Short single-line entries like names or titles",relationship:["alternative"]},{name:"Input.TextAutoSuggest",note:"Single-line free text with a suggestions dropdown",relationship:["alternative"]},{name:"Field",note:"Legacy label wrapper; avoid in new data-entry flows",relationship:["alternative"]}]},TextAutoSuggest:{description:"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.",events:["change","blur","focus","click"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint. Default: off",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{type:"string"},{type:"number"}],description:"Initial value when uncontrolled"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing suggestion filtering",propertyNames:{type:"string"},type:"object"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isPositionFixed:{description:"Use fixed positioning for dropdown menu. Useful in scrollable containers",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Array of { label, value } suggestion objects matching the React list prop",items:{additionalProperties:!1,properties:{label:{description:"Display text for the suggestion",type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Value stored when suggestion is selected"}},required:["label","value"],type:"object"},type:"array"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},shouldAllowAutoFill:{description:"Allow browser autofill",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},shouldShowMenuOnFocus:{description:"Show dropdown menu on input focus. Default: false",type:"boolean"},shouldShowSearchIcon:{description:"Show search icon prefix. Default: false",type:"boolean"},shouldStopEventPropagation:{description:"Stop automatic input focus when clicking container",type:"boolean"},shrinkToPlaceholder:{description:"Input spans as much as its placeholder when true. Only applies when placeholder is visible",type:"boolean"},shrinkToValue:{description:"Input spans as much as its value when true. Only applies when value is present",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},theme:{description:"Theme name from Input.Text.THEMES or custom theme",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{type:"number"}],description:"Current value bound to state"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["autocomplete","autosuggest","typeahead","suggestions","search or create","address autocomplete","combobox","free text with suggestions","search input","type to search"],anatomy:{parts:[{name:"Label",required:!0,role:"Field label with optional required indicator and tooltip"},{name:"Text field",required:!0,role:"Single-line input accepting free-form text"},{name:"Prefix",required:!1,role:"Leading adornment, typically the search icon (shouldShowSearchIcon)"},{name:"Suggestions popover",required:!0,role:"Dropdown of matching options filtered as the user types; async lists supported"},{name:"Help / error text",required:!1,role:"Hint or inline validation message below the field"}],summary:"A single-line text field (same anatomy as Input.Text) with a suggestions popover below it. The field can carry a prefix (search icon), a clear action, and a suffix (validation icon or loading Spinner); the popover lists matching options as the user types and can open on focus via shouldShowMenuOnFocus."},guidance:{doNotUseWhen:["The value must be restricted to valid options only — use Input.Select","No suggestions exist to offer — use Input.Text","Choosing people with role/status filtering — use EmployeeSearch","Multi-line text entry — use Input.Textarea"],useWhen:["Free-form entry where suggestions speed up or standardize input — addresses, cities, locations","Search-or-create flows: pick an existing option or type a new value","Search/filter bars over a known dataset (products, employees, carriers)","Autocomplete backed by a server — pass an async function as list","Validated autocomplete inside a Form via Form.Input.TextAutoSuggest"]},antiPatterns:["Search and filter auto-suggest fields missing accessible name on the input","Standalone Input.TextAutoSuggest filters outside Form bypassing integrated validation","Placeholder carries format requirements instead of helper text or label","Input.TextAutoSuggest used where Select would enforce valid-only choices"],selection:{confusedWith:[{component:"Input.Select",distinguishBy:"Input.Select (including async lists) restricts the value to returned options; Input.TextAutoSuggest accepts free-form text not in the suggestions (search-or-create, addresses)"},{component:"Input.Text",distinguishBy:"Input.Text has no suggestions dropdown; Input.TextAutoSuggest filters and offers matching options as the user types"}]},relatedComponents:[{name:"Form.Input.TextAutoSuggest",note:"Form-aware variant with title, validations, and inline errors; use inside a Form",relationship:["complement"]},{name:"Form",note:"Container for validated data entry; register via Form.Input.TextAutoSuggest",relationship:["complement"]},{name:"Input.Select",note:"When the value must be one of a fixed option set — also supports async list functions",relationship:["alternative"]},{name:"Input.Text",note:"Plain single-line text with no suggestions",relationship:["alternative"]}]},TextClip:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{buttonLabels:{additionalProperties:!1,description:"Labels for the expand and collapse buttons",properties:{collapse:{description:"Label for the collapse button. Default: Show less",type:"string"},expand:{description:"Label for the expand button. Default: Show more",type:"string"}},required:["expand","collapse"],type:"object"},maxHeight:{description:"Max height in px before content is clipped and expand/collapse is shown",type:"number"},theme:{description:"Visual theme variant. NO_CARD removes the card styling",enum:["NO_CARD"],type:"string"}},required:["maxHeight"],type:"object"},acceptsChildren:!0,category:["layout"],keywords:["text clip","textclip","truncation","show more","show less","read more","expandable text","long description","clipped content","max height","collapsible text","preview"],anatomy:{parts:[{name:"Body content",required:!0,role:"Arbitrary string or JSX (Text, lists, tables, rendered HTML/markdown) clipped to maxHeight when collapsed"},{name:"Expand/collapse button",required:!1,role:"CTA that toggles between the clipped preview and full content; labels via buttonLabels"},{name:"Card container",required:!1,role:"Optional bordered card around the content; removed with THEMES.NO_CARD"}],summary:"A body of content clipped to maxHeight (optionally inside a bordered card), with a Show more / Show less CTA button below. theme={TextClip.THEMES.NO_CARD} removes the card chrome for embedding inside other containers. Button labels are overridable via buttonLabels."},guidance:{doNotUseWhen:["Truncating a list of items — use ShowMore (item-count based)","Plain text that just needs N-line ellipsis — use Text with lineClamp and tipOnOverflow","Multiple sections that each expand independently — use ExpansionPanel","Brief content shown only on hover — use Tip instead","Copyable tokens, URLs, or code strings — use TextSnippet.Copy / TextSnippet.Download"],useWhen:["Displaying a large block of text or rich content in limited space — descriptions, reviews, feedback summaries, AI output","Offering a preview of longer content without pushing the rest of the page down","Wrapping rendered HTML or markdown that must be height-clipped (theme={TextClip.THEMES.NO_CARD} inside existing cards/drawers)","Content needs inline expand/collapse with customizable button labels (buttonLabels)"]},antiPatterns:["Bordered card theme inside already-elevated containers","Collapsed preview height too aggressive to provide context","Interactive or structural UI wrapped for text truncation","Explicit maxHeight omitted — layout relies on component default","Shared HtmlPreview wrapper omits NO_CARD when clipping","Nested truncation controls inside TextClip"],selection:{confusedWith:[{component:"Text",distinguishBy:"Text with lineClamp truncates plain text to N lines with an optional tipOnOverflow tooltip and no expansion; TextClip clips rich JSX content by pixel height and lets the user expand it inline"},{component:"ShowMore",distinguishBy:"ShowMore truncates a list by item count (size/steps); TextClip truncates a single block of content by pixel height"},{component:"ExpansionPanel",distinguishBy:"ExpansionPanel toggles titled, bordered sections; TextClip previews the top of one continuous block of content with a height cutoff"},{component:"TextSnippet",distinguishBy:"TextSnippet is a read-only string with copy/download affordances; TextClip expands and collapses long content but offers no copy/download action"}]},relatedComponents:[{name:"ShowMore",note:"Truncating a list of items by count instead of one content block by height",relationship:["alternative"]},{name:"ShowMore.Button",note:"Standalone expand/collapse button for fully custom reveal logic",relationship:["complement"]},{name:"Text",note:"lineClamp for simple N-line ellipsis on plain text",relationship:["alternative"]},{name:"ExpansionPanel",note:"Multiple independently collapsible titled sections",relationship:["alternative"]},{name:"TextSnippet",note:"Read-only copyable/downloadable plain-text snippet",relationship:["alternative"]}]},TextInput:{description:"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.",events:["change","blur","focus","click","keydown","keyup","paste","mouseenter","mouseleave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-activedescendant":{description:"ID of active descendant",type:"string"},"aria-autocomplete":{description:"ARIA autocomplete state",enum:["none","inline","list","both"],type:"string"},"aria-controls":{description:"ID of controlled element",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-details":{description:"ID of element with additional details",type:"string"},"aria-expanded":{description:"ARIA expanded state",type:"boolean"},"aria-haspopup":{description:"ARIA haspopup state",enum:["true","false","menu","listbox","tree","grid","dialog"],type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},"aria-required":{description:"ARIA required state",type:"boolean"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},canClear:{description:"Show clear button",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},role:{description:"ARIA role",type:"string"},shouldAllowAutoFill:{description:"Allow browser autofill",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},shouldStopEventPropagation:{description:"Stop automatic input focus when clicking container",type:"boolean"},shrinkToPlaceholder:{description:"Input spans as much as its placeholder when true. Only applies when placeholder is visible",type:"boolean"},shrinkToValue:{description:"Input spans as much as its value when true. Only applies when value is present",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},stringPadding:{additionalProperties:!1,description:"Pads input value with character until reaching maxLength",properties:{character:{description:"Character to use for padding",type:"string"},maxLength:{description:"Target length after padding",type:"number"},position:{description:"Where to add padding: start or end",enum:["start","end"],type:"string"}},required:["position","maxLength","character"],type:"object"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},theme:{description:"Theme name from Input.Text.THEMES or custom theme",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current text value bound to state",type:"string"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["text input","text field","input","text box","form field","name field","search field","textinput"],anatomy:{parts:[{name:"label",required:!0,role:"Programmatically linked field label"},{name:"input",required:!0,role:"The single-line text entry control"},{name:"addons",role:"Optional leading/trailing icon or text affixes"},{name:"error",role:"Inline validation message region below the field"}],summary:"A labeled single-line input with optional leading/trailing addons (icons, text), placeholder, and an inline error/message region below."},guidance:{doNotUseWhen:["Multi-line text — use Input.Textarea","Choosing from a fixed set — use Input.Select or Radio","Numbers, dates, phones, or currency — use the dedicated Input.* variant","Read-only display — use isReadOnly, not disabled, or plain Text"],useWhen:["Free-text single-line data entry inside a Form","Search or filter fields with an accessible name","Fields needing inline validation feedback"]},antiPatterns:[{instead:"Place Input.Text inside Form with a field name",pattern:"Data-entry text fields built outside Form",why:"Bypasses integrated validation and submission wiring"},{instead:"Use the label prop so the htmlFor/id linkage is automatic",pattern:"Visual label present but not programmatically linked",why:"Screen readers cannot associate the label with the input"},{instead:"Provide aria-label when no visible label exists",pattern:"Search and filter text fields missing an accessible name",why:"Icon-only search fields announce nothing to screen readers"},{instead:"Use the input's inline error state",pattern:"Validation surfaced via toast instead of inline errors",why:"Errors detach from the field and disappear"},{instead:"Always pair error styling with a message",pattern:"Error styling without an inline error message",why:"Users see red but learn nothing"},{instead:"Use Input.Text.SIZES",pattern:"Legacy INPUT_SIZES constant",why:"Deprecated alias"},{instead:"Use isReadOnly on a text input",pattern:"Read-only content shown in a disabled textarea",why:"Disabled controls are skipped by assistive tech and look editable-but-broken"}],propGuidance:[{guidance:"Always provide a visible label for data-entry fields; it is automatically linked to the input.",pitfall:"Placeholder text is not a label — it disappears on input and fails accessibility.",prop:"label"},{guidance:"Set inline error messages from form validation; never rely on toast for field errors.",prop:"error"},{guidance:"Use for values the user should see and copy but not edit; prefer over isDisabled for display.",prop:"isReadOnly"},{guidance:"Default M; match the density of the surrounding form via Input.Text.SIZES.",prop:"size"}],selection:{confusedWith:[{component:"Input.Textarea",distinguishBy:"Multi-line free text (descriptions, notes) → Textarea; single-line values → Input.Text."},{component:"Input.Select",distinguishBy:"Value comes from a fixed option set → Select; free text → Input.Text."},{component:"Input.TextAutoSuggest",distinguishBy:"Free text that should offer suggestions as the user types → Input.TextAutoSuggest."},{component:"InlineEditor",distinguishBy:"Click-to-edit display of an existing value → InlineEditor; always-editable form field → Input.Text."}]},relatedComponents:[{name:"Form",note:"Owns validation and submission for data-entry fields",relationship:["parent"]},{name:"Input.Textarea",note:"Multi-line variant",relationship:["alternative"]},{name:"Input.Select",note:"Fixed option sets",relationship:["alternative"]},{name:"Input.TextAutoSuggest",note:"Free text that offers suggestions as the user types",relationship:["alternative"]},{name:"InlineEditor",note:"Click-to-edit display of an existing value",relationship:["alternative"]},{name:"Label",note:"Provided automatically via the label prop",relationship:["complement"]}]},TextSnippet:{description:'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. Accepts either a plain "content" string or arbitrary children for rich/formatted content.',events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{content:{description:"Plain text content to display in the snippet. Omit and pass children instead when the snippet needs rich content (formatting, inline highlights, etc.)",type:"string"},fileName:{description:"File name for download type. Default: rippling.txt",type:"string"},showFullContent:{description:"Show full content without truncation. Default: false",type:"boolean"},type:{description:"Snippet action type. Default: Copy",enum:["Copy","Download"],type:"string"},wordBreak:{description:"CSS word-break value for content. Default: break-all",type:"string"}},type:"object"},acceptsChildren:!0,category:["atom"],keywords:["text snippet","textsnippet","code snippet","copy to clipboard","copyable text","download text","token","api key","url","certificate","saml metadata","json payload","webhook url","sftp key","read-only text"],anatomy:{parts:[{name:"Content",required:!0,role:"Plain-text string displayed in the snippet (pass strings, not rich JSX); truncated by default, full with showFullContent"},{name:"Action icon",required:!0,role:"Trailing affordance — copy-to-clipboard (Copy) or file download (Download)"}],summary:"A read-only string shown truncated to a few lines (or in full with showFullContent), followed by a trailing icon button for the copy or download action. The bare TextSnippet base is essentially never used directly — consumers pick TextSnippet.Copy or TextSnippet.Download."},guidance:{doNotUseWhen:["Long-form content that should expand inline — use TextClip instead","Plain readable text with no copy/download need — use Text or Typography","Highly sensitive values that should not be easily shared","Rich or interactive JSX content — content should be a plain-text string"],useWhen:["Users need to copy a value to use elsewhere — API keys, tokens, webhook URLs, SSO/SAML endpoints","Displaying machine-oriented strings (JSON payloads, certificates, scripts) with a copy or download action","Setup/instruction flows where users transfer values into third-party systems","Use showFullContent for multi-line content the user must read in full before copying"]},antiPatterns:["Multi-line or structured copyable content left in default truncated view","Separate manual download control duplicates `TextSnippet.Copy`","Custom copy UI built in-product instead of `TextSnippet`","Rich JSX passed as `content` instead of plain text","`TextSnippet.Download` rarely used where download is the primary action"],selection:{confusedWith:[{component:"TextClip",distinguishBy:"TextClip expands long rich content inline by pixel height; TextSnippet displays a plain string with a copy or download action, not an expander"},{component:"Text",distinguishBy:"Text renders styled copy for reading; TextSnippet adds a built-in copy/download affordance for strings users must reuse elsewhere"},{component:"Button",distinguishBy:"A Button only fires an action; TextSnippet pairs the visible value with the copy/download action so users see exactly what they are copying"}]},relatedComponents:[{name:"TextSnippet.Copy",note:"Copies content to clipboard — tokens, API keys, URLs, JSON payloads, certificates",relationship:["child"]},{name:"TextSnippet.Download",note:"Downloads content as a file via fileName — SAML metadata XML, certificates, CSV templates",relationship:["child"]},{name:"TextClip",note:"Long content that needs inline expand/collapse rather than a copy/download action",relationship:["alternative"]},{name:"Text",note:"Styled text for reading only, with no copy/download need",relationship:["alternative"]}]},Time:{description:"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.",events:["change","blur","inferredTimeChange"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},alwaysShowTimezone:{description:"If true, timezone abbreviation will always be shown. Default: false",type:"boolean"},"aria-describedby":{description:"ARIA describedby reference for accessibility",type:"string"},"aria-label":{description:"ARIA label for accessibility",type:"string"},"aria-labelledby":{description:"ARIA labelledby reference for accessibility",type:"string"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultSelectionStartTime:{description:'Time to start the selection scroll from when shouldAllowTimeSelection is true (e.g. "08:00 AM")',type:"string"},defaultValue:{description:"Initial time value when uncontrolled",type:"string"},id:{description:"HTML id attribute for the input",type:"string"},inferredTime:{anyOf:[{type:"string"},{type:"null"}],description:"JSON-only inferred time metadata written before inferredTimeChange emits"},isDateTimeInline:{description:"Make input inline, removes border, padding and width fits input/placeholder content",type:"boolean"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Marks the input as invalid",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for time formatting (e.g. en-US)",type:"string"},maxWidth:{description:"Maximum width CSS value",type:"string"},pickClosestMeridiem:{description:"When user does not enter AM/PM, pick the closest meridiem to the inputted hour value. Default: false",type:"boolean"},referenceDate:{description:"ISO date string used as reference for timezone calculations and DST determination. Defaults to current date.",type:"string"},shouldAllowTimeSelection:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{reference:{description:"Reference ISO time for period labels",type:"string"}},type:"object"}],description:"Show a time selection dropdown for picking times"},shouldDisplaySeconds:{description:"Display seconds in the time input",type:"boolean"},shouldFormatInTimezone:{description:"If true, values will transform according to global timezone when timezone prop is not passed explicitly",type:"boolean"},shouldLocalize:{description:"If true, display format will be determined from user locale setting",type:"boolean"},shouldReturnISO:{description:"Always return value in ISO 8601 format",type:"boolean"},shouldShowTimezoneLabel:{description:"If false, timezone label will not be shown. Default: true",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Custom theme to apply to the input",type:"string"},timezone:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{name:{description:"Input name for the timezone selector",type:"string"},isRequired:{description:"Marks the timezone selector as required",type:"boolean"},value:{description:"Selected timezone value",type:"string"}},required:["name"],type:"object"}],description:"Show time relative to this timezone or configure the timezone selector"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Time value bound to state (ISO 8601 or HH:mm format)",type:"string"}},type:"object"},acceptsChildren:!1,category:["date"],keywords:["time input","time picker","time of day","clock","shift time","clock in out","workday start","availability","scheduled trigger","meeting time","am pm","24 hour","timeinput"],anatomy:{parts:[{name:"label",required:!0,role:"Field label (title in forms) indicating what time is required"},{name:"time field",required:!0,role:"Text entry with auto-formatting; shows the selected time"},{name:"time dropdown",role:"Selectable times in 15-minute increments (shouldAllowTimeSelection)"},{name:"timezone select",role:"Optional timezone display or picker via the timezone prop"},{name:"helper/error text",role:"Supportive text below the field; replaced by inline error or warning text"}],summary:"A labeled text field for a time of day; typing auto-formats (digits plus A/P for AM/PM) and focusing opens an optional dropdown of times in 15-minute increments. A timezone label or selector can sit alongside. Helper, error, or warning text appears below the field."},guidance:{doNotUseWhen:["Start/end time span such as shift hours — use Input.Time.Range, not two Input.Time fields","Choosing a timezone itself — use Input.Timezone (Input.Timezone)","A calendar date or date+time — use Input.Date with shouldShowTime","Displaying live remaining time — use Atoms.CountDown"],useWhen:["Entering or selecting a specific time of day in forms","Shift, availability, and clock in/out times in scheduling and timesheets","Scheduled triggers and jobs — workflow start times, refresh schedules, enforcement windows","Scheduling with timezone display or a timezone selector alongside","Typed entry with auto-formatting or dropdown selection in 15-minute increments","In data-entry flows use the form-aware Form.Input.Time inside a Form"]},antiPatterns:["Date and time split into separate fields with manual merge logic","Future-dated scheduling with timezone but no reference date","Input.Timezone UI suppressed via CSS instead of supported props","Form time validation duplicated in submit handler via toast"],selection:{confusedWith:[{component:"Input.Time.Range",distinguishBy:"Input.Time captures a single time of day; Input.Time.Range captures a start/end pair — two Input.Time fields for from/to times are a common hand-assembled substitute"},{component:"Input.Timezone",distinguishBy:"Input.Timezone (Input.Timezone) is a select whose value is an IANA timezone; Input.Time enters a time of day and only displays or selects a zone alongside"},{component:"Input.Date",distinguishBy:"Input.Date captures a calendar date (optionally with time via shouldShowTime); Input.Time captures only a time of day"}]},relatedComponents:[{name:"Form",note:"In data-entry flows use the form-aware Form.Input.Time inside Form, not standalone Input.Time",relationship:["complement"]},{name:"Input.Time.Range",note:"Start/end time pair such as shift hours",relationship:["alternative"]},{name:"Input.Timezone",note:"When the timezone itself is the value being collected",relationship:["alternative"]},{name:"Input.Date",note:"Calendar date or date+time capture (shouldShowTime)",relationship:["alternative"]}]},TimeRange:{description:"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.",events:["change","blur"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input. Default: TimeRange",type:"string"},alwaysShowTimezone:{description:"If true, timezone abbreviation will always be shown",type:"boolean"},"aria-describedby":{description:"ARIA describedby reference for accessibility",type:"string"},"aria-label":{description:"ARIA label for accessibility",type:"string"},"aria-labelledby":{description:"ARIA labelledby reference for accessibility",type:"string"},canClear:{description:"Shows a clear icon button to reset both time values to empty",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultSelectionStartTime:{description:'Time to start the selection scroll from when shouldAllowTimeSelection is true (e.g. "08:00 AM")',type:"string"},defaultValue:{description:"Initial time range when uncontrolled [startTime, endTime]",prefixItems:[{anyOf:[{type:"string"},{type:"null"}]},{anyOf:[{type:"string"},{type:"null"}]}],type:"array"},hideDayDifference:{description:"Hides the next day indicator when end time is on the next day. Default: false (indicator is shown)",type:"boolean"},hideTimeIcon:{description:"Hides the prefix clock icon in the input. Default: false",type:"boolean"},id:{description:"HTML id attribute for the input",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Marks the input as invalid",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},locale:{description:"Locale string for time formatting (e.g. en-US)",type:"string"},referenceDate:{description:"ISO date string used as reference for timezone calculations and DST determination. Defaults to current date.",type:"string"},shouldAllowTimeSelection:{anyOf:[{type:"boolean"},{additionalProperties:!1,properties:{reference:{description:"Reference ISO time for period labels",type:"string"}},type:"object"}],description:"Show a time selection dropdown for picking times. Default: true"},shouldDisplaySeconds:{description:"Display seconds in the time inputs",type:"boolean"},shouldFormatInTimezone:{description:"If true, values will transform according to global timezone when timezone prop is not passed explicitly. Default: true",type:"boolean"},shouldLocalize:{description:"If true, display format will be determined from user locale setting",type:"boolean"},theme:{description:"Custom theme to apply to the input",type:"string"},timezone:{description:"Show times relative to this timezone (IANA identifier, e.g. America/New_York)",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Time range value bound to state [startTime, endTime]. Each time must be an ISO 8601 string with UTC offset",prefixItems:[{anyOf:[{type:"string"},{type:"null"}]},{anyOf:[{type:"string"},{type:"null"}]}],type:"array"}},type:"object"},acceptsChildren:!1,category:["date"],keywords:["time range","shift hours","working hours","work pattern","availability window","start end time","labor plan","overnight shift","business hours","timerange"],anatomy:{parts:[{name:"label",required:!0,role:'Field label (title in forms) naming the span, e.g. "Shift hours"'},{name:"start time field",required:!0,role:"Text entry with dropdown for the range start"},{name:"end time field",required:!0,role:"Text entry with dropdown for the range end"},{name:"timezone select",role:"Optional timezone display or picker via the timezone prop"},{name:"next-day indicator",role:"Marks ranges whose end time lands on the following day"}],summary:"A labeled pair of time fields — start and end — each with typed entry and a dropdown of times in 15-minute increments. An optional timezone label or selector sits alongside, a clear action resets both values, and a next-day indicator appears when the end time falls on the following day."},guidance:{doNotUseWhen:["A single time of day — use Input.Time","Start/end dates rather than times — use Input.Date.Range (Input.Date.Range)","Choosing only a timezone — use Input.Timezone (Input.Timezone)","Two unrelated times — use separate Input.Time fields, not a range"],useWhen:["Defining a span of time — shift hours, working hours, availability windows, business hours","Weekly working-hours forms, paired with Input.DaySelector for the days","Scheduling across timezones (pass a timezone string or selector object)","Overnight ranges — the next-day indicator flags ends on the following day","In data-entry flows use the form-aware Form.Input.Time.Range inside a Form"]},antiPatterns:["Next-day indicator hidden where overnight shifts are possible","Heavy ISO conversion wrapper around Time.Range values","Duplicate time-range fields instead of one range control"],selection:{confusedWith:[{component:"Input.Time",distinguishBy:"Input.Time captures a single time of day; Input.Time.Range captures a start/end pair and detects overnight spans"},{component:"Input.Date.Range",distinguishBy:"Input.Date.Range (Input.Date.Range) selects a start/end date pair via calendars; Input.Time.Range selects times within a day"},{component:"Input.Timezone",distinguishBy:"Input.Timezone (Input.Timezone) collects only an IANA timezone; Input.Time.Range collects the time pair and can show or select a zone alongside"}]},relatedComponents:[{name:"Form",note:"In data-entry flows use the form-aware Form.Input.Time.Range inside Form",relationship:["complement"]},{name:"Input.DaySelector",note:"Weekly working-hours forms pair day-of-week selection with per-day time ranges",relationship:["complement"]},{name:"Input.Time",note:"Single time of day",relationship:["alternative"]},{name:"Input.Date.Range",note:"Start/end dates rather than times",relationship:["alternative"]},{name:"Input.Timezone",note:"When only the timezone is needed; also composable via the timezone selector object",relationship:["alternative"]}]},Timezone:{description:"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.",events:["change","blur","focus"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},canClear:{description:"Shows a clear button to reset selection",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial IANA timezone identifier",type:"string"},displayIANA:{description:"Display IANA timezone name. Default: true",type:"boolean"},displayShortFormat:{description:"Display timezone abbreviation",type:"boolean"},dropdownHeight:{description:"Height of the dropdown menu in pixels",type:"number"},emptyListPlaceholder:{description:"Placeholder text shown when no timezone matches the search",type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isMenuDefaultOpen:{description:"If true, the dropdown menu will be open by default on mount",type:"boolean"},isPositionFixed:{description:"Use fixed positioning for dropdown (useful in scrollable containers)",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isSearchable:{description:"Enables search filtering. Default: true",type:"boolean"},label:{description:"Label text above the input",type:"string"},placeholder:{description:"Placeholder text when empty",type:"string"},placement:{description:"Dropdown placement position. Default: BOTTOM_START",enum:["TOP_START","TOP","TOP_END","RIGHT_START","RIGHT","RIGHT_END","BOTTOM_END","BOTTOM","BOTTOM_START","LEFT_END","LEFT","LEFT_START"],type:"string"},referenceDate:{description:"ISO 8601 date string to determine timezone offsets (e.g. 2024-01-15T12:00:00Z)",type:"string"},shouldShowSearchIcon:{description:"If true, shows a search icon in the dropdown",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Visual theme variant for the input",enum:["TRANSPARENT_BORDER","TOP_NAV","INLINE_TRANSPARENT_BORDER","INLINE_TOP_NAV","NO_PADDING_RIGHT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_RIGHT_NO_BOX_TOP_NAV","NO_PADDING_LEFT_NO_BOX_TRANSPARENT_BORDER","NO_PADDING_LEFT_NO_BOX_TOP_NAV"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"IANA timezone identifier bound to state (e.g. America/New_York)",type:"string"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["timezone","time zone","tz picker","iana","utc offset","dst","schedule settings","calendar header","view timezone","notification timezone","tz"],anatomy:{parts:[{name:"label",required:!0,role:"Field label (title in forms) indicating a timezone is required"},{name:"timezone field",required:!0,role:"Select control showing the chosen timezone"},{name:"timezone dropdown",role:"Searchable list of all IANA timezones with name, abbreviation, identifier"},{name:"helper/error text",role:"Supportive text below the field; replaced by inline error text"}],summary:"A labeled select field that opens a searchable dropdown of IANA timezones; options show the long name, abbreviation, and IANA identifier (each configurable via display props). Helper, error, or warning text sits below the field."},guidance:{doNotUseWhen:["Entering a time of day — use Input.Time (it has built-in timezone display/selector)","Generic option lists — use Input.Select","Picking a country or locale — use Atoms.Country"],useWhen:["The timezone itself is the value — schedule settings, candidate profiles, notification delivery","Compact view-context switcher in schedule and calendar headers (displayShortFormat, NO_BOX themes, size S)","Cross-timezone scheduling where users must pick their zone explicitly","Searchable IANA list with long, short, or IANA-identifier display formats","In data-entry flows use the form-aware Form.Input.Timezone inside a Form"]},antiPatterns:["Standalone timezone picker missing accessible name","Placeholder used as only field name in compact headers","Form timezone field missing title","Hand-built timezone Select instead of Input.Timezone"],selection:{confusedWith:[{component:"Input.Select",distinguishBy:"Input.Select is a generic option list; Input.Timezone is pre-populated with IANA timezones and timezone display formats — never hand-build a timezone Select"},{component:"Input.Time",distinguishBy:"Input.Time enters a time of day (it can display or select a zone alongside); Input.Timezone is the standalone picker when the zone itself is the value"},{component:"Atoms.Country",distinguishBy:"Atoms.Country picks a country, not a timezone — one country spans multiple timezones"}]},relatedComponents:[{name:"Form",note:"In data-entry flows use the form-aware Form.Input.Timezone inside Form",relationship:["complement"]},{name:"Input.Select",note:"Generic option lists; Input.Timezone wraps Select with a pre-populated IANA list and display formats",relationship:["alternative"]},{name:"Input.Time",note:"Time-of-day entry with incidental timezone display",relationship:["alternative"]},{name:"Atoms.Country",note:"Atoms.Country or locale selection",relationship:["alternative"]}]},Tip:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{appearance:{description:"Tooltip theme. Default: LIGHT",enum:["LIGHT","DARK"],type:"string"},content:{description:"Tooltip text content",type:"string"},hideOnDocumentScroll:{description:"Hide tooltip when the document is scrolled. Default: false",type:"boolean"},isDelayed:{description:"Add delay before showing/hiding the tooltip. Default: false",type:"boolean"},isMobileSupported:{description:"Show tooltip on mobile devices. Default: false",type:"boolean"},isPositionFixed:{description:"Use fixed positioning for the tooltip. Default: false",type:"boolean"},isVisible:{description:"Control tooltip visibility from parent. Overrides hover behavior when set",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Max height of tooltip content. Number in px or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Max width of tooltip. Number in px or CSS string. Default: 360"},onlyIfChildOverflow:{description:"Only show tooltip if a child element overflows. Default: false",type:"boolean"},onlyIfOverflow:{description:"Only show tooltip if the trigger element overflows. Default: false",type:"boolean"},placement:{description:"Tooltip position relative to child. Default: bottom",enum:["top","top-start","top-end","bottom","bottom-start","bottom-end","left","left-start","left-end","right","right-start","right-end"],type:"string"},tipHideDelay:{description:"Custom delay in ms before tooltip hides",type:"number"},tipShowDelay:{description:"Custom delay in ms before tooltip appears",type:"number"},title:{description:"Optional bold title above tooltip content",type:"string"}},required:["content"],type:"object"},acceptsChildren:!0,category:["atom"],keywords:["tip","tooltip","info icon","contextual help","hint","hover text","truncated text","ellipsis","overflow","help text","question mark icon","clarification"],anatomy:{parts:[{name:"Trigger",required:!0,role:"The single wrapped child element the tooltip is anchored to"},{name:"Container",required:!0,role:"The floating tooltip surface, light by default (DARK only for rare approved cases)"},{name:"Title",required:!1,role:"Optional bold heading above the content"},{name:"Content",required:!0,role:"Short supplementary text — 1–2 short sentences at most, no actions or links"}],summary:"An invisible wrapper around one trigger element; on hover/focus a floating container appears near the trigger holding an optional title and short content. Placement is configurable (top/right/bottom/left, with _START/_END variants) and onlyIfOverflow limits it to truncated content."},guidance:{doNotUseWhen:["Information is critical or a user action is required — use a Modal","Content needs links, buttons, or rich interaction — use Popper instead","The message must always be visible — use Notice, Label, or helper text","A component already accepts a tip prop (Button, Chip, Avatar, Icon) — pass it there","The copy just repeats the trigger label — rewrite or drop the tooltip"],useWhen:["Adding supplementary context or hints to a button, icon, or other element","Describing what an icon-only control does","Revealing full text of truncated content (onlyIfOverflow)","Explaining jargon or how a value is used — helpful but not crucial","Explaining why a disabled control is unavailable (pair with an accessible name)"]},antiPatterns:["Icon or icon-adjacent controls rely on tooltip as the only description — no accessible name","Dark tooltip appearance used outside rare, designer-approved cases","Tooltip visibility manually overridden — controlled `isVisible` fights default hover/focus behavior","Truncated UI shows tooltip even when text is not overflowing — `onlyIfOverflow` omitted","Actionable links embedded inside tooltip content","Rich multi-section tooltip content used as a mini detail panel","Tooltip strings hardcoded in English without i18n","Disabled or blocked controls explain _why_ only through a hover tooltip",'Tooltip copy repeats the trigger label or says "Click to…"'],selection:{confusedWith:[{component:"Popper",distinguishBy:"Popper is the generic positioned overlay for interactive, click-opened content; Tip is hover/focus-only, non-interactive, and holds short passive text"},{component:"Modal",distinguishBy:"Modal interrupts the user for critical information or required actions; Tip is for supplementary, missable context only"},{component:"Notice",distinguishBy:"Notice is a persistent inline message that is always visible; Tip hides context behind hover/focus on a specific element"},{component:"Label",distinguishBy:"Label renders persistent inline text/metadata on the surface; Tip reveals transient explanation on hover"}]},relatedComponents:[{name:"Button",note:"Accepts a tip prop directly — no Tip wrapper needed for buttons",relationship:["complement"]},{name:"Chip",note:"Accepts a tip prop directly; prefer it over wrapping Chip in Tip",relationship:["complement"]},{name:"Icon",note:"Common trigger: a small question/info icon next to a label revealing help text",relationship:["complement"]},{name:"Text",note:"Truncated Text paired with Tip onlyIfOverflow to reveal full content",relationship:["complement"]},{name:"Popper",note:"Interactive or click-triggered overlay content",relationship:["alternative"]},{name:"Modal",note:"Critical information or required user action",relationship:["alternative"]},{name:"Notice",note:"Persistent inline message that must always be visible",relationship:["alternative"]},{name:"Label",note:"Always-visible metadata text instead of hidden hover context",relationship:["alternative"]}]},TitleCaption:{description:"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.",events:["press"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{caption:{description:"Secondary caption text displayed below the title in body-small typestyle. Accepts string only.",type:"string"},captionColor:{description:"Pebble text/icon color token for the caption text. Default: theme colorOnSurfaceVariant",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},title:{description:"Primary title text displayed in body-large typestyle",type:"string"}},required:["title"],type:"object"},acceptsChildren:!1,category:["atom"],keywords:["title caption","titlecaption","name and role","subtitle","primary secondary text","truncated label","entity summary","profile name","job title","two line text","display name","timestamp","admin grid"],anatomy:{parts:[{name:"Title",required:!0,role:"Primary identifying text — a person's name or record display name; concise noun phrase"},{name:"Caption",required:!1,role:"Secondary context — job title, department, timestamp, record ID; keep under ~40 characters"},{name:"Overflow tooltip",required:!1,role:"Built-in tooltip on hover/focus when either line truncates; never wrap in Tip"}],summary:"A two-line text stack: the title on top in body-large typestyle and the caption below in a de-emphasized style (tintable via captionColor with a theme token). Both lines truncate with ellipsis on overflow and show the full value in a built-in tooltip on hover or keyboard focus."},guidance:{doNotUseWhen:["Rich, formatted, or multi-line copy — use Text with the appropriate typestyle","A standalone heading with no secondary descriptor — use Text instead","Clickable text that navigates or triggers an action — use Anchor or Button","Primary identifying information in the caption — the title always carries the identity"],useWhen:["Name and role pairs — a person's name with job title, department, or reporting line","Dates or display names with secondary context in admin grids (formatted date title + descriptor caption)","Primary/secondary text hierarchy in dense layouts (table rows, cards, list items) that may overflow","Constrained spaces needing ellipsis truncation with an automatic tooltip — no manual Tip wrapper","Entity summary blocks in ObjectUI.Header, profile cards, or record listings"]},antiPatterns:["Atoms.TitleCaption without `caption` when secondary context exists","Wrapped in `Tip` — duplicate overflow tooltips","Primary/caption hierarchy inverted (role in title)","Hand-built title/caption stacks instead of Atoms.TitleCaption"],selection:{confusedWith:[{component:"Text",distinguishBy:"Text is the general-purpose typography primitive for rich, styled, or multi-line copy; Atoms.TitleCaption is the fixed single-line title + caption pair with built-in truncation and tooltip"},{component:"Page.Header",distinguishBy:"Page.Header is the top-of-page title region with actions; Atoms.TitleCaption is a compact in-content label pair for cards, table cells, and list items"},{component:"Anchor",distinguishBy:"Anchor is clickable text that navigates or triggers an action; Atoms.TitleCaption is display-only"}]},relatedComponents:[{name:"Atoms",note:"Atoms.TitleCaption is exported from the Atoms namespace: import { Atoms.TitleCaption } from '@rippling/pebble/Atoms'",relationship:["parent"]},{name:"Text",note:"Rich, styled, or multi-line text, or a standalone heading with no caption",relationship:["alternative"]},{name:"Anchor",note:"Clickable text that navigates or triggers an action",relationship:["alternative"]},{name:"Tip",note:"Do not wrap Atoms.TitleCaption in Tip — the overflow tooltip is built in",relationship:["alternative"]},{name:"Page.Header",note:"Top-of-page title region with actions, not an in-content label pair",relationship:["alternative"]},{name:"ListItem",note:"Row container whose title/caption slots carry the same primary/secondary pattern",relationship:["complement"]}]},ToggleableArrow:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{"aria-controls":{description:"ARIA controls attribute linking the arrow to the element it controls",type:"string"},"aria-describedby":{description:"References another element ID to use as the accessible description",type:"string"},"aria-label":{description:"Accessible label for the arrow button",type:"string"},"aria-labelledby":{description:"References another element ID to use as the accessible label",type:"string"},arrowDownColor:{description:"Color of the arrow when pointing down (collapsed state). Defaults to colorOnSurfaceVariant.",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},arrowUpColor:{description:"Color of the arrow when pointing up (expanded state). Defaults to colorPrimary.",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},horizontalCollapsedPosition:{description:"When true, the arrow icon is in horizontal position when collapsed. Default: false",type:"boolean"},isArrowDown:{description:"Controls whether the arrow points down (collapsed). Default: true",type:"boolean"},isDisabled:{description:"When true, disables the arrow and prevents interaction",type:"boolean"},isFocused:{description:"When true, renders the icon in focused state",type:"boolean"},showCursor:{description:"When true, shows a pointer cursor on hover. Default: true",type:"boolean"},size:{description:"Icon size token. Default: 24",enum:["sizeIcon2xl","sizeIcon2xs","sizeIcon3xl","sizeIcon3xs","sizeIcon4xl","sizeIconLg","sizeIconMd","sizeIconSm","sizeIconXl","sizeIconXs"],type:"string"}},type:"object"},acceptsChildren:!1,category:["atom"],keywords:["chevron","expand arrow","collapse arrow","disclosure triangle","accordion arrow","caret"],anatomy:{parts:[{name:"Arrow glyph",required:!0,role:"Chevron communicating expanded/collapsed state via rotation"}],summary:"A single chevron glyph in a focusable hit area; the glyph rotates between collapsed (pointing right/down) and expanded orientations."},guidance:{doNotUseWhen:["A whole collapsible section is needed — use ExpansionPanel instead of assembling header and arrow by hand","The chevron is purely decorative and never toggles content — a plain Icon is enough","There is no linked expand/collapse content — an arrow without controlled content is meaningless"],useWhen:["Building a custom disclosure UI (collapsible rows, tree nodes, expandable cards) that needs the standard expand/collapse arrow","The arrow must be focusable and reflect expanded state with the correct rotation"]},antiPatterns:["Controlled arrow without `aria-controls` on focusable instances","Arrow displayed without linked expand/collapse content","Custom chevron Icon instead of Atoms.ToggleableArrow","Hardcoded chevron colors instead of theme tokens"],selection:{confusedWith:[{component:"Icon",distinguishBy:"A plain chevron Icon has no toggle semantics, rotation, or accessibility wiring — Atoms.ToggleableArrow is the supported expand/collapse arrow"},{component:"ExpansionPanel",distinguishBy:"ExpansionPanel is the full header-plus-collapsible-body section; Atoms.ToggleableArrow is only the arrow for custom disclosure UIs"}]},relatedComponents:[{name:"ExpansionPanel",note:"Full collapsible section; prefer it over assembling header + Atoms.ToggleableArrow by hand",relationship:["complement"]},{name:"Icon",note:"Decorative chevrons only — never for interactive toggles",relationship:["alternative"]}]},Tree:{description:"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.",events:["change","footerAction"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this tree",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this tree",type:"string"},canSelectAll:{description:"Show select all toggle in multi mode",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Initial selected value(s) when uncontrolled"},dropdownWidth:{description:"Override internal dropdown width in pixels",type:"number"},emptyListPlaceholder:{description:"Placeholder text when list is empty",type:"string"},footer:{additionalProperties:!1,description:"Fixed footer with clickable action at bottom of tree",properties:{label:{description:"Footer button text",type:"string"}},required:["label"],type:"object"},fuseOptions:{additionalProperties:{},description:"Fuse.js search options for customizing search behavior",propertyNames:{type:"string"},type:"object"},hasIndependentActions:{description:"In multiSelect, action on an item does not affect selection of parent or child items",type:"boolean"},hasIndependentChildActions:{description:"Actions on child in multi select do not affect selection of ancestors",type:"boolean"},hasStaticParentNodes:{description:"Makes parent nodes non-actionable (only manage hierarchy)",type:"boolean"},id:{description:"HTML id attribute for accessibility",type:"string"},isDisabled:{description:"Disables the tree input",type:"boolean"},isMulti:{description:"Allow multiple selection. Default: false",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},isSearchable:{description:"Enable search filtering. Default: true",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Flat array of tree items with parent references. Root items have parent: null, children reference parent value",items:{additionalProperties:!1,properties:{disabledInfo:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{content:{description:"Tooltip content text",type:"string"},isMobileSupported:{description:"Show tooltip on mobile devices",type:"boolean"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum tooltip height"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Maximum tooltip width"}},required:["content"],type:"object"}],description:"Tooltip shown when item is disabled"},isDisabled:{description:"Disable this item",type:"boolean"},isLeaf:{description:"Marks the item as a leaf node",type:"boolean"},label:{description:"Display label for the item",type:"string"},parent:{anyOf:[{type:"string"},{type:"null"}],description:"Parent item value, null for root items"},secondaryLabel:{description:"Supporting text below the label",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:'Label appearance (e.g., "primary", "error", "success")',type:"string"},text:{description:"Tag text to display",type:"string"}},required:["text"],type:"object"}],description:"Chip/tag to display next to the label"},value:{description:"Unique identifier for the item",type:"string"}},required:["label","value"],type:"object"},type:"array"},maxHeight:{description:"Maximum height of the tree list in pixels",type:"number"},selectionCount:{description:"Show count of selected items in multi-select mode",type:"boolean"},shouldExpandNodeOnSelection:{description:"Auto-expand node when selected. Default: false",type:"boolean"},shouldShowFolderStructure:{description:"Renders folder structure for tree items",type:"boolean"},size:{description:"Input size. Options: XS, S, M, L. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Tree theme for styling variants",enum:["NO_BORDER","NO_PADDING","REVERSE","NO_BOX"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"}],description:"Selected value(s). Single string when isMulti is false, array when true"}},required:["list"],type:"object"},acceptsChildren:!1,category:["input"],keywords:["tree","hierarchy","hierarchical select","parent child","nested options","org structure","departments","folder picker","permissions tree","expand collapse","multi-level select","classification"],anatomy:{parts:[{name:"Label",required:!0,role:"Text description of the tree"},{name:"Search field",required:!1,role:"Filters tree nodes and shows current selections as chips (isSearchable)"},{name:"Branch node",required:!0,role:"Parent node with children; expands/collapses to reveal child nodes"},{name:"Leaf node",required:!0,role:"Selectable node with no children, at any level of the hierarchy"},{name:"Check suffix",required:!1,role:"Check icon (or checkbox in Tree.Multi) indicating node selection"}],summary:"A labeled, always-visible tree panel (no dropdown). An optional search field at the top filters nodes and shows selections as chips; below it, branch nodes with expand/collapse icons contain nested leaf nodes; selected nodes show a check suffix, or checkboxes in Tree.Multi."},guidance:{doNotUseWhen:["Compact filter bars, popovers, or tight forms — use Input.TreeSelect","Flat option lists with no parent-child structure — use Input.Select","Read-only hierarchical display or navigation — use NestedList or an accordion","Primary page navigation — use the app shell's left panel and breadcrumbs"],useWhen:["Selecting from deeply nested data — org structures, departments, document folders, permission trees","Users benefit from seeing the full hierarchy while choosing","Multi-select across levels with parent-child cascade — use Input.Tree.Multi with canSelectAll","Side panels or wide layouts with room for an always-visible tree","Validated hierarchical selection inside a Form via Form.Input.Tree"]},antiPatterns:["Always-visible tree used in compact filter popovers where Input.TreeSelect fits better","Standalone tree multi-filters built outside Form without inline validation","Tree selector rendered without label or title on the control","Disabled tree nodes without explanatory disabledInfo"],selection:{confusedWith:[{component:"Input.TreeSelect",distinguishBy:"Input.TreeSelect keeps the tree collapsed behind a dropdown trigger; Input.Tree is always visible — pick it when there is room and seeing the full structure aids selection"},{component:"NestedList",distinguishBy:"NestedList displays/navigates a hierarchy; Input.Tree is a form input that returns selected value(s) with optional search and multi-select"},{component:"Input.Select",distinguishBy:"Input.Select handles flat option lists; Input.Tree is for parent-child hierarchies needing expand/collapse"}]},relatedComponents:[{name:"Input.Tree.Multi",note:"Multi-select variant with checkboxes, canSelectAll, and selection counts",relationship:["child"]},{name:"Form.Input.Tree",note:"Form-aware variant with title and validation; use inside a Form",relationship:["complement"]},{name:"Input.TreeSelect",note:"Same hierarchical selection collapsed into a dropdown — better for compact filter bars and popovers",relationship:["alternative"]},{name:"NestedList",note:"Display or navigation of hierarchical data without input semantics",relationship:["alternative"]},{name:"Input.Select",note:"Flat (non-hierarchical) option lists",relationship:["alternative"]}]},TreeSelect:{description:"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.",events:["change"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes the input",type:"string"},"aria-label":{description:"Accessible label for the input",type:"string"},"aria-labelledby":{description:"ID of element that labels the input",type:"string"},canSelectAll:{description:"Show select all toggle in multi mode",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultSearchQuery:{description:"Default search input value",type:"string"},defaultValue:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"},{type:"null"}],description:"Initial value set. Single string when isMulti is false, array when true"},dropdownWidth:{description:"Custom dropdown width in pixels",type:"number"},emptyListPlaceholder:{description:"Placeholder shown when list is empty",type:"string"},fuseOptions:{additionalProperties:{},description:'Fuse.js search configuration. Default: { keys: ["label", "name"] }',propertyNames:{type:"string"},type:"object"},hasIndependentActions:{description:"In multiSelect, action on an item does not affect selection of parent or child items",type:"boolean"},hasIndependentChildActions:{description:"Actions on child in multi select do not affect selection of ancestors",type:"boolean"},hasStaticParentNodes:{description:"Makes parent nodes non-actionable (only manage hierarchy)",type:"boolean"},id:{description:"HTML id attribute",type:"string"},isDisabled:{description:"Disables the tree select",type:"boolean"},isMenuDefaultOpen:{description:"If true, dropdown menu will be open by default",type:"boolean"},isMulti:{description:"Allow multiple selection. Default: false",type:"boolean"},isPositionFixed:{description:"Sets dropdown position as fixed (relative to viewport)",type:"boolean"},isReadOnly:{description:"Makes the tree select read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},list:{description:"Flat array of tree items with parent references. Root items have parent: null, children reference parent value",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disable this item",type:"boolean"},isLeaf:{description:"Marks the item as a leaf node",type:"boolean"},label:{description:"Display label for the item",type:"string"},parent:{anyOf:[{type:"string"},{type:"null"}],description:"Parent item value, null for root items"},secondaryLabel:{description:"Supporting text below the label",type:"string"},value:{description:"Unique identifier for the item",type:"string"}},required:["label","value"],type:"object"},type:"array"},maxHeight:{anyOf:[{type:"string"},{type:"number"}],description:"Max height of tags container (CSS value)"},placeholder:{description:"Placeholder text when no selection",type:"string"},placement:{description:"Dropdown position. Default: bottom-end",enum:["top-start","top","top-end","right-start","right","right-end","bottom-end","bottom","bottom-start","left-end","left","left-start"],type:"string"},selectedOptionsModalClassName:{description:"Class name for selected options modal (multi-select only)",type:"string"},shouldExpandNodeOnSelection:{description:"Auto expands a node to show its children once selected. Default: false",type:"boolean"},shouldShowFolderStructure:{description:"Renders folder structure view",type:"boolean"},shouldShowSelectionPath:{description:"Show parent-to-child path in selected chips. Default: false",type:"boolean"},size:{description:"Input size. Default: M",enum:["XS","S","M","L"],type:"string"},theme:{description:"Custom theme styling",enum:["NO_BOX"],type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"},{type:"null"}],description:"Selected value(s). Single string when isMulti is false, array when true"}},required:["list"],type:"object"},acceptsChildren:!1,category:["input"],keywords:["tree select","hierarchical dropdown","nested select","parent child dropdown","department picker","folder select","cascading select","tree dropdown","hierarchy filter","grouped options","lazy load tree"],anatomy:{parts:[{name:"Label",required:!0,role:"Text description of the field"},{name:"Trigger field",required:!0,role:"Select-style input showing selections as chips; opens the tree panel"},{name:"Search field",required:!1,role:"Auto-filters tree nodes as the user types"},{name:"Branch node",required:!0,role:"Parent node with children; expands/collapses inside the dropdown panel"},{name:"Leaf node",required:!0,role:"Selectable node with no children"},{name:"Footer",required:!1,role:"Optional sticky footer with actions inside the dropdown panel"}],summary:"A select-style input field (label, chips for selections, dropdown chevron) that opens a dropdown panel containing a hierarchical tree. The panel has a search field, branch nodes with expand/collapse icons, leaf nodes, and check indicators; multi-select adds checkboxes and can show a sticky footer with actions."},guidance:{doNotUseWhen:["Flat option lists with no parent-child structure — use Input.Select","Users should browse the full hierarchy on screen — use Input.Tree","Inside a Modal or overflow-hidden container without isPositionFixed — the dropdown will clip","Read-only hierarchical display — use NestedList"],useWhen:["Hierarchical single or multi selection in forms — parent folder, parent goal, department","Layout.Grid/list filter bars over hierarchical data (departments, leave types, categories)","Limited space where an always-visible Input.Tree would not fit","Multi-select across levels — Input.TreeSelect.Multi with canSelectAll and hasIndependentActions as needed","Validated hierarchical fields inside a Form via Form.Input.TreeSelect"]},antiPatterns:["Multi-select chips show leaf label only on deep hierarchies without selection path","Parent–child cascade expected but default independent actions left enabled","Input.TreeSelect in modal without fixed positioning — clipped dropdown risk","Form tree-select missing title in modal data-entry flows"],selection:{confusedWith:[{component:"Input.Tree",distinguishBy:"Input.Tree is always visible on the page; Input.TreeSelect collapses the same hierarchy behind a dropdown trigger — pick it for compact forms and filter bars"},{component:"Input.Select",distinguishBy:"Input.Select lists flat options; Input.TreeSelect shows parent-child hierarchy with expand/collapse inside the dropdown"},{component:"NestedList",distinguishBy:"NestedList displays a hierarchy inline for browsing; Input.TreeSelect is a form input returning selected value(s) from a dropdown"}]},relatedComponents:[{name:"Input.TreeSelect.Multi",note:"Multi-select variant with chips, canSelectAll, and selection path display",relationship:["child"]},{name:"Form.Input.TreeSelect",note:"Form-aware variant with title, validation, and inline errors; use inside a Form",relationship:["complement"]},{name:"Input.Tree",note:"Always-visible tree when the layout has room and the full structure should stay on screen",relationship:["alternative"]},{name:"Input.Select",note:"Flat option lists with no hierarchy",relationship:["alternative"]},{name:"NestedList",note:"Inline hierarchical display without input semantics",relationship:["alternative"]}]},Video:{description:"Embedded video player with 16:9 aspect ratio",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Name attribute for the iframe element",type:"string"},allowFullScreen:{description:"Allow fullscreen mode. Default: true",type:"boolean"},loading:{description:"Iframe loading strategy. Default: eager",enum:["eager","lazy"],type:"string"},src:{description:"Video URL or embed URL (e.g. YouTube, Vimeo)",type:"string"},width:{description:"Width of the video player in pixels. Default: 912",type:"number"}},required:["src"],type:"object"},acceptsChildren:!1,category:["atom"],keywords:["video","embed","youtube","wistia","loom","iframe","tutorial","walkthrough","training video","help article","onboarding video","product tour","marketing video"],anatomy:{parts:[{name:"Container",required:!0,role:"16:9 aspect-ratio box sized by the width prop (default 912px)"},{name:"Iframe embed",required:!0,role:"Third-party player loaded from an embed URL passed via src"}],summary:'A responsive container with an enforced 16:9 aspect ratio (width prop controls size, default 912px; height is derived) wrapping a third-party iframe embed. Supports native iframe attributes like loading="lazy".'},guidance:{doNotUseWhen:["Self-hosted MP4 files you control — use a native <video> element for full playback control","Audio-only content — use a dedicated audio solution","Autoplay ambient or background video — iframe embeds do not autoplay reliably; use <video>","Standard watch URLs (youtube.com/watch?v=...) — normalize to embed URLs first"],useWhen:["Embedding tutorial or marketing videos in a responsive 16:9 container","Inline product walkthroughs (Loom, Wistia) on feature introduction pages","Onboarding and training content in help panels, modals, or flows","Help center articles pairing support videos with written instructions"]},antiPatterns:["Default 912px width used inside narrow sidebars, widgets, and help cards","Embed URLs passed without normalization from CMS or user input",'Below-the-fold videos load immediately because `loading="lazy"` is omitted',"URLs that already include query parameters may break when passed to Video","Fixed narrow width (252px) in rail cards while sibling surfaces use 912px default"],selection:{confusedWith:[{component:"LottiePlayer",distinguishBy:"LottiePlayer plays lightweight .json vector animations for UI feedback; Video embeds hosted video content with player controls"},{component:"Atoms.Image",distinguishBy:"Atoms.Image renders a static visual or thumbnail; Video renders playable hosted video — do not fake video with a thumbnail image"}]},relatedComponents:[{name:"LottiePlayer",note:"Animated UI feedback instead of hosted video",relationship:["alternative"]},{name:"Atoms.Image",note:"Static visual when no playback is needed",relationship:["alternative"]},{name:"Modal",note:"Common container for onboarding and walkthrough videos",relationship:["complement"]},{name:"Card",note:"Rail and help cards embed narrow Videos — always set an explicit width",relationship:["complement"]}]},VStack:{description:"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.",events:[],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{align:{description:"Cross-axis alignment",enum:["flex-start","center","flex-end","stretch","baseline"],type:"string"},alignSelf:{description:"Align self override when inside a flex parent",enum:["auto","flex-start","center","flex-end","stretch","baseline"],type:"string"},backgroundColor:{description:"Background surface color token",enum:["colorPrimary","colorSecondary","colorTertiary","colorPrimaryContainer","colorSecondaryContainer","colorTertiaryContainer","colorError","colorErrorContainer","colorSurface","colorSurfaceDim","colorSurfaceBright","colorSurfaceContainer","colorSurfaceContainerHighest","colorSurfaceInverse","colorSuccess","colorSuccessContainer","colorInfo","colorInfoContainer","colorWarning","colorWarningContainer","colorDisabled","colorOverlay","colorDisabledSurfaceSelected","colorOverlayInverse","colorDisabledSurfaceInverse","colorSecondaryVariant","colorPrimaryVariant","colorTertiaryVariant","colorDisabledInverse","colorDisabledSurface","colorSurfaceContainerLowest","colorSurfaceContainerLow","colorSurfaceContainerHigh"],type:"string"},basis:{anyOf:[{type:"number"},{type:"string"}],description:"Flex basis value"},boxSizing:{description:"Box sizing model",enum:["content-box","border-box"],type:"string"},color:{description:"Text/icon color token",enum:["colorOnPrimary","colorOnSecondary","colorOnTertiary","colorOnPrimaryContainer","colorOnSecondaryContainer","colorOnTertiaryContainer","colorError","colorOnError","colorOnErrorContainer","colorOnSurface","colorOnSurfaceVariant","colorOnSurfaceInverse","colorSuccess","colorOnSuccess","colorOnSuccessContainer","colorInfo","colorOnInfo","colorOnInfoContainer","colorWarning","colorOnWarning","colorOnWarningContainer","colorDisabled","colorOnDisabledSurface","colorOnDisabledSurfaceInverse","colorOnSecondaryVariant","colorOnPrimaryVariant","colorOnTertiaryVariant","colorDisabledInverse"],type:"string"},gap:{description:"Spacing token for gap between children",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},grow:{description:"Flex grow factor",type:"number"},height:{anyOf:[{type:"number"},{type:"string"}],description:"Height in pixels (number) or CSS string"},justify:{description:"Main-axis alignment",enum:["flex-start","center","flex-end","space-between","space-around","space-evenly"],type:"string"},margin:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Margin as a spacing token or directional spacing-token object {top, right, bottom, left}"},maxHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Max height in pixels or CSS string"},maxWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Max width in pixels or CSS string"},minHeight:{anyOf:[{type:"number"},{type:"string"}],description:"Min height in pixels or CSS string"},minWidth:{anyOf:[{type:"number"},{type:"string"}],description:"Min width in pixels or CSS string"},overflow:{description:"Overflow behavior",enum:["visible","hidden","scroll","auto"],type:"string"},padding:{anyOf:[{enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},{additionalProperties:!1,properties:{bottom:{description:"Bottom spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},left:{description:"Left spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},right:{description:"Right spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"},top:{description:"Top spacing token",enum:["space0","space25","space50","space75","space100","space125","space150","space175","space200","space225","space250","space275","space300","space350","space400","space450","space500","space600","space700","space800","space900","space1000","space1100","space1200","space1400","space1600","space2000","space2400","space2800","space3200","space3600","space4000","space4400","space4800","space5200","space5600","space6000","space6400","space7200","space8000","space9600"],type:"string"}},type:"object"}],description:"Padding as a spacing token or directional spacing-token object {top, right, bottom, left}"},radius:{description:"Border radius token",enum:["shapeCornerNone","shapeCornerXs","shapeCornerSm","shapeCornerMd","shapeCornerLg","shapeCornerXl","shapeCorner2xl","shapeCorner3xl","shapeCorner4xl","shapeCornerFull"],type:"string"},shrink:{description:"Flex shrink factor",type:"number"},width:{anyOf:[{type:"number"},{type:"string"}],description:"Width in pixels (number) or CSS string"},wrap:{description:"Flex wrap behavior",enum:["nowrap","wrap","wrap-reverse"],type:"string"}},type:"object"},acceptsChildren:!0,category:["layout"],keywords:["v stack","vstack","vertical","column","stack","form fields","card sections","list items","spacing","gap","wizard steps","settings section"],anatomy:{parts:[{name:"Children",required:!0,role:"Stacked items — commonly form fields, card sections, list items, or text blocks"}],summary:"A single-column flex container (no sub-components): children stack top to bottom with token-based gap. align controls horizontal (cross-axis) alignment — children stretch to full container width by default; set align='flex-start' for inline-width children. justify distributes vertically; changeDirectionAbove flips to a row above a container breakpoint."},guidance:{doNotUseWhen:["Horizontal rows — use Layout.HStack","Multi-field data entry needing validation and submit — use Form","Deeply nested Layout.VStack trees — flatten to a single container with gap","Inline-width children like buttons — children stretch by default; set align='flex-start'"],useWhen:["Stacking content in a column — form fields, card sections, list items","Token-based vertical spacing without writing flex CSS","Wizard steps or settings sections needing consistent vertical separation","Columns that become rows on wide containers via changeDirectionAbove"]},antiPatterns:["Magic-number spacing instead of design tokens","Horizontal action buttons stacked in Layout.VStack","Hardcoded margin objects on Layout.VStack","Manual spacer elements alongside Layout.VStack","Deeply nested Layout.VStack trees"],selection:{confusedWith:[{component:"Layout.HStack",distinguishBy:"Layout.HStack lays children out in a horizontal row; Layout.VStack is strictly a vertical column"},{component:"Layout.Box",distinguishBy:"Layout.Box with direction='column' equals Layout.VStack; prefer Layout.VStack for plain columns and Layout.Box for multi-axis or styled-surface layouts"},{component:"Layout.Grid",distinguishBy:"Layout.Grid renders data-driven label/value cells with responsive columns; Layout.VStack is free-form stacking of arbitrary children"},{component:"Form",distinguishBy:"Form owns input registration, validation, layout, and submission for data entry; Layout.VStack only spaces arbitrary content"}]},relatedComponents:[{name:"Layout.Box",note:"Layout.VStack is a convenience wrapper around Layout.Box with direction fixed to column",relationship:["parent"]},{name:"Layout.HStack",note:"Horizontal rows",relationship:["alternative"]},{name:"Layout.Grid",note:"Data-driven label/value summaries with built-in reflow",relationship:["alternative"]},{name:"Form",note:"Multi-field data entry with validation and submit",relationship:["alternative"]},{name:"Atoms.Separator",note:"Visual divider between stacked sections",relationship:["complement"]},{name:"Card",note:"Layout.VStack is the typical content layout inside cards and drawers",relationship:["complement"]}]},WorkEmail:{description:"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",events:["change","blur","focus","click","keydown","keyup","paste","mouseenter","mouseleave"],propsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{name:{description:"Unique identifier for the input",type:"string"},"aria-describedby":{description:"ID of element that describes this input",type:"string"},"aria-label":{description:"Accessible label for screen readers",type:"string"},"aria-labelledby":{description:"ID of element that labels this input",type:"string"},autoCapitalize:{description:"Auto-capitalization: off, none, on, sentences, words, or characters",enum:["off","none","on","sentences","words","characters"],type:"string"},autoComplete:{description:"Browser autocomplete hint",type:"string"},autoCorrect:{description:"Auto-correct: off or on",enum:["off","on"],type:"string"},autoFocus:{description:"Auto-focus on mount",type:"boolean"},checks:{description:"Array of {type, message, args?} validation rule objects. Requires validateOn to be set",items:{additionalProperties:!1,properties:{args:{additionalProperties:{},propertyNames:{type:"string"},type:"object"},message:{type:"string"},type:{type:"string"}},required:["type","message"],type:"object"},type:"array"},defaultValue:{description:"Initial default value for uncontrolled usage",type:"string"},domainList:{anyOf:[{type:"string"},{items:{type:"string"},type:"array"},{items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this specific domain option",type:"boolean"},label:{description:"Display label for the domain option",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Optional semantic appearance for the tag",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text displayed with the domain option",type:"string"}},required:["text"],type:"object"}],description:"Optional tag shown with the domain option"},value:{description:"Domain option value",type:"string"}},required:["value"],type:"object"},type:"array"},{items:{additionalProperties:!1,properties:{label:{description:"Group label for a nested domain list",type:"string"},list:{description:"Grouped domain options",items:{additionalProperties:!1,properties:{isDisabled:{description:"Disables this specific domain option",type:"boolean"},label:{description:"Display label for the domain option",type:"string"},tag:{anyOf:[{type:"string"},{additionalProperties:!1,properties:{appearance:{description:"Optional semantic appearance for the tag",enum:["PRIMARY","NEUTRAL","WARNING","INFO","ERROR","SUCCESS","TRANSPARENT","DISABLED"],type:"string"},text:{description:"Tag text displayed with the domain option",type:"string"}},required:["text"],type:"object"}],description:"Optional tag shown with the domain option"},value:{description:"Domain option value",type:"string"}},required:["value"],type:"object"},type:"array"}},required:["label","list"],type:"object"},type:"array"}],description:'Email domain list for selection. Can be: single string, array of strings ["acme.com"], array of {label, value, tag?} objects (FlatList), or array of {label, list} objects (NestedList) for grouped domains'},inputMode:{description:"Virtual keyboard type hint",enum:["none","text","decimal","numeric","tel","search","email","url"],type:"string"},isDisabled:{description:"Disables the input",type:"boolean"},isInvalid:{description:"Shows invalid styling (in addition to validation)",type:"boolean"},isOriginalInputReadOnly:{description:"Sets readonly mode directly on input HTML element",type:"boolean"},isReadOnly:{description:"Makes the input read-only",type:"boolean"},isRequired:{description:"Marks the field as required",type:"boolean"},label:{description:"Label text above the input",type:"string"},maxLength:{description:"Maximum character count",type:"number"},maxWidth:{description:"Maximum width CSS value",type:"string"},minLength:{description:"Minimum character count",type:"number"},placeholder:{description:"Placeholder text when empty",type:"string"},prefix:{description:"Text or icon name from Icon.TYPES to show before the input value",type:"string"},readOnlyAffixSpacing:{description:"Controls gap between affixes and value in read-only mode. Default: true. Set false to remove gap",type:"boolean"},shouldAllowAutoFill:{description:"Allow browser autofill",type:"boolean"},shouldPersistCursorPosition:{description:"Persist cursor position for controlled input. Default: false",type:"boolean"},shouldStopEventPropagation:{description:"Stop automatic input focus when clicking container",type:"boolean"},shrinkToPlaceholder:{description:"Input spans as much as its placeholder when true. Only applies when placeholder is visible",type:"boolean"},shrinkToValue:{description:"Input spans as much as its value when true. Only applies when value is present",type:"boolean"},size:{description:"Input size variant. Default: M",enum:["XS","S","M","L"],type:"string"},spellCheck:{description:"Enable spell checking",type:"boolean"},suffix:{description:"Text or icon name from Icon.TYPES to show after the input value",type:"string"},theme:{description:"Theme name from Input.WorkEmail.THEMES or custom theme",type:"string"},validateOn:{description:"When to run validation checks. Requires checks to be set",enum:["change","blur","submit"],type:"string"},value:{description:"Current work email value bound to state",type:"string"}},type:"object"},acceptsChildren:!1,category:["input"],keywords:["work email","work email input","workemailinput","company email","email domain","domain dropdown","employee onboarding","work email assignment","domain-restricted email"],anatomy:{parts:[{name:"Label",required:!0,role:"Describes the work email being assigned"},{name:"Username field",required:!0,role:"Text entry for the local part of the address"},{name:"Domain dropdown",required:!1,role:"Select from company-owned domains (domainList); supports grouped entries"},{name:"Helper/Error text",required:!1,role:"Guidance via helperMessage; keep field-level error association intact"}],summary:"A label above a split field: the user types only the username portion in a text field on the left, followed by an @ separator and a domain dropdown on the right listing company-owned domains (optionally grouped). Helper or error text appears below. With no domainList it collapses to a plain text field that blocks multiple @ signs."},guidance:{doNotUseWhen:["Personal or unrestricted email addresses — use Input.Email","Free-form text or non-email identifiers (usernames, IDs) — use Input.Text","Wiring Form validation with `validationError` — WorkEmail expects `validationErrors`"],useWhen:["Assigning work emails during onboarding or employee setup where users pick from company-owned domains","Domain-restricted email entry that must prevent cross-domain assignments","Organizations with many domains — group domainList entries into named groups","Read-only display of an assigned work email (renders as plain text)"]},antiPatterns:["Form validation message wired with `validationError` instead of `validationErrors`","Work email field rendered without `domainList` when domain-restricted entry is expected","Rich `helperMessage` node replaces guidance without preserving field-level error association"],selection:{confusedWith:[{component:"Input.Email",distinguishBy:"Input.Email accepts any valid email address; WorkEmail restricts the domain to a predefined company list so users type only the username"},{component:"Input.Text",distinguishBy:"Text provides no email structure; WorkEmail splits username and domain and blocks multiple @ signs even without a domainList"}]},relatedComponents:[{name:"Form",note:"Employee setup flows use Form.Input.WorkEmail with domainList inside a Form",relationship:["complement"]},{name:"Input.Email",note:"General email addresses without domain restrictions",relationship:["alternative"]},{name:"Input.Text",note:"Non-email identifiers such as usernames or IDs",relationship:["alternative"]}]}},h={invalidateSuperGridData:{description:"Invalidate cached SuperGrid data for a grid and request a backend cache bust.",docs:`Use after an SDUI mutation changes rows displayed by a SuperGrid.
|
|
2
|
+
Run this after any prerequisite actions, such as triggerApi, in an ordered event action array or runActions chain.
|
|
3
|
+
The action invalidates SuperGrid data and dropdown queries for gridId. Backend cache bust is attempted when the grid supports it.`,paramsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{gridId:{description:"SuperGrid id whose cached data and dropdown queries should be invalidated.",type:"string"}},required:["gridId"],type:"object"}},navigate:{description:"Navigate to a URL path.",docs:"Page URLs: `/custom-apps/{app_id}/sdui/{page_id}`. Use openInNewTab for external links.",paramsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{openInNewTab:{type:"boolean"},path:{type:"string"}},required:["path"],type:"object"}},openChatAssistantWithMessage:{description:"Open Chat Assistant and send an initial message in a new conversation.",docs:`text: prompt/message that should be sent immediately after Chat Assistant opens.
|
|
2
4
|
target: optional Chat Assistant surface target. Omit to use the default chat surface.`,paramsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{target:{description:"Optional Chat Assistant surface target.",enum:["sidepane","fullscreen","copilot"],type:"string"},text:{description:"Initial message to send in a new Chat Assistant conversation. Must contain at least one non-whitespace character.",minLength:1,pattern:"\\S",type:"string"}},required:["text"],type:"object"}},pushState:{description:"Append an item to an array in state. Optionally clear another state path.",docs:void 0,paramsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{clearStatePath:{type:"string"},statePath:{type:"string"},value:{}},required:["statePath","value"],type:"object"}},removeState:{description:"Remove an item from an array in state by index.",docs:void 0,paramsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{index:{type:"number"},statePath:{type:"string"}},required:["statePath","index"],type:"object"}},setState:{description:"Update a value in the state model at the given statePath.",docs:void 0,paramsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{statePath:{type:"string"},value:{}},required:["statePath","value"],type:"object"}},showNotification:{description:"Show a toast notification. Auto-dismisses after 7 seconds.",docs:void 0,paramsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{message:{type:"string"},variant:{enum:["info","success","warning","error"],type:"string"}},required:["message","variant"],type:"object"}},triggerFunction:{description:"Call a Rippling Function. params.inputs is sent as event.parameters.",docs:`functionApiName: API name of the function to invoke.
|
|
3
5
|
inputs: function inputs. Must include action; extra keys are sent to the server as event.parameters.
|
|
4
6
|
responsePath (client-side): stores response body at that state path. Body must match the state shape (e.g. array, NOT wrapped in { data: [...] }).
|
|
5
7
|
onSuccess (client-side): runs after handler resolves. Must use { set: { "/path": value } } format, NOT actions.set().
|
|
6
|
-
onError (client-side): runs if handler throws. Same format as onSuccess.`,paramsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{functionApiName:{type:"string"},inputs:{additionalProperties:{},properties:{action:{type:"string"}},required:["action"],type:"object"},onError:{},onSuccess:{},responsePath:{type:"string"}},required:["functionApiName","inputs"],type:"object"}}},y={},oo={},v={AppNavBarNavItem:{additionalProperties:!1,id:"AppNavBarNavItem",properties:{badge:{additionalProperties:!1,description:"Badge shown next to the nav item title",properties:{appearance:{description:"Badge visual style",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},text:{description:"Text to display in the badge",type:"string"}},required:["text"],type:"object"},icon:{description:"Icon name from Icon.TYPES (e.g. FOLDER_OUTLINE)",type:"string"},isSection:{description:"If true, renders as a non-interactive section header (vertical mode only)",type:"boolean"},links:{description:"Nested sub-navigation items",items:{$ref:"#/$defs/AppNavBarNavItem"},type:"array"},path:{description:"URL path segment for this nav item",type:"string"},queryParams:{additionalProperties:{type:"string"},description:"Query parameters to append when navigating to this item",propertyNames:{type:"string"},type:"object"},size:{description:"Width constraint for this navigation item in pixels",type:"number"},title:{description:"Display label for this nav item",type:"string"}},required:["title"],type:"object"},CheckListItem:{additionalProperties:!1,id:"CheckListItem",properties:{branches:{description:"Nested child items",items:{$ref:"#/$defs/CheckListItem"},type:"array"},checkListOptions:{additionalProperties:!1,description:"Per-item input type overrides",properties:{shouldHaveNegativeCheckbox:{description:"Override negative checkbox for this item",type:"boolean"},type:{description:"Override input type for this item",enum:["SWITCH","CHECKBOX"],type:"string"}},type:"object"},isChecked:{description:"Whether this item is checked",type:"boolean"},isDefaultOpen:{description:"If true, nested items are expanded by default",type:"boolean"},isDisabled:{description:"Disables interaction for this item",type:"boolean"},label:{description:"Display text for this item",type:"string"},showMoreSize:{description:'Number of child items shown before "show more" toggle',type:"number"},value:{description:"Unique identifier for this item",type:"string"}},required:["label","value","isChecked"],type:"object"},NestedListItem:{additionalProperties:!1,id:"NestedListItem",properties:{branches:{description:"Child items",items:{$ref:"#/$defs/NestedListItem"},type:"array"},isDefaultOpen:{description:"Start expanded",type:"boolean"},label:{description:"Display text for the item",type:"string"},value:{description:"Unique value for the item",type:"string"}},required:["label"],type:"object"},PaneAdaptationRule:{additionalProperties:!1,id:"PaneAdaptationRule",properties:{below:{description:"Pebble breakpoint token below which this rule applies.",enum:["breakpoint2xl","breakpointLg","breakpointMd","breakpointSm","breakpointXl"],type:"string"},presentation:{description:"Alternate presentation used below the breakpoint.",enum:["bottomDock","overlay","hidden"],type:"string"}},required:["below","presentation"],type:"object"},PaneBodyDescriptor:{additionalProperties:!1,id:"PaneBodyDescriptor",properties:{noPadding:{description:"Remove the default space300 body padding. Default: false.",type:"boolean"},scroll:{description:"Body scroll ownership. Default: auto.",enum:["auto","none"],type:"string"}},type:"object"},PaneCommittedSize:{additionalProperties:!1,id:"PaneCommittedSize",properties:{horizontal:{description:"Committed horizontal size in pixels.",type:"number"},vertical:{description:"Committed vertical size in pixels.",type:"number"}},type:"object"},PaneControlTips:{additionalProperties:!1,id:"PaneControlTips",properties:{collapse:{anyOf:[{type:"string"},{type:"null"}],description:"Collapse-control tooltip override."},dismiss:{anyOf:[{type:"string"},{type:"null"}],description:"Dismiss-control tooltip override."},hide:{anyOf:[{type:"string"},{type:"null"}],description:"Temporary hide-control tooltip override."},restore:{anyOf:[{type:"string"},{type:"null"}],description:"Restore-control tooltip override."},show:{anyOf:[{type:"string"},{type:"null"}],description:"Temporary show-control tooltip override."}},type:"object"},PaneDimension:{anyOf:[{description:"Pixel size.",type:"number"},{additionalProperties:!1,properties:{unit:{const:"percent",description:"Percentage unit discriminator.",type:"string"},value:{description:"Percentage value.",type:"number"}},required:["value","unit"],type:"object"}],id:"PaneDimension"},PaneFooterActionDescriptor:{additionalProperties:!1,id:"PaneFooterActionDescriptor",properties:{appearance:{description:"Pebble Button appearance. Default: OUTLINE.",enum:["ACCENT","ACTIVE","PRIMARY","DESTRUCTIVE","SUCCESS","INFO","WARNING","OUTLINE","SOLID","GHOST"],type:"string"},icon:{description:"Optional Pebble icon name.",type:"string"},id:{description:"Stable action identifier emitted when activated.",type:"string"},isDisabled:{description:"Whether the action is disabled. Default: false.",type:"boolean"},label:{description:"Visible button label.",type:"string"},placement:{description:"Footer side where the action is rendered. Default: end.",enum:["start","end"],type:"string"},shouldShowSpinner:{description:"Whether to show the action loading spinner. Default: false.",type:"boolean"}},required:["id","label"],type:"object"},PaneFooterDescriptor:{additionalProperties:!1,id:"PaneFooterDescriptor",properties:{actions:{description:"Footer button actions.",items:{$ref:"#/$defs/PaneFooterActionDescriptor"},type:"array"}},required:["actions"],type:"object"},PaneHeaderActionDescriptor:{additionalProperties:!1,id:"PaneHeaderActionDescriptor",properties:{appearance:{description:"Pebble IconButton appearance. Default: GHOST.",enum:["ACCENT","ACTIVE","PRIMARY","DESTRUCTIVE","SUCCESS","INFO","WARNING","OUTLINE","SOLID","GHOST"],type:"string"},ariaLabel:{description:"Accessible name for the icon-only action.",type:"string"},icon:{description:"Icon displayed by the header action.",type:"string"},id:{description:"Stable action identifier emitted when activated.",type:"string"},isDisabled:{description:"Whether the action is disabled. Default: false.",type:"boolean"},placement:{description:"Side of the title where the action is rendered. Default: end.",enum:["start","end"],type:"string"},tip:{anyOf:[{type:"string"},{type:"null"}],description:"Tooltip override. Defaults to ariaLabel; null disables the tooltip."}},required:["id","icon","ariaLabel"],type:"object"},PaneHeaderDescriptor:{additionalProperties:!1,id:"PaneHeaderDescriptor",properties:{actions:{description:"Header actions. Excess actions move into the Pebble Dropdown overflow menu.",items:{$ref:"#/$defs/PaneHeaderActionDescriptor"},type:"array"},leadingIcon:{description:"Optional icon before the title.",type:"string"},title:{description:"Pane header title.",type:"string"}},required:["title"],type:"object"},PaneSizing:{id:"PaneSizing",oneOf:[{additionalProperties:!1,properties:{mode:{const:"fixed",description:"Use an exact pane size.",type:"string"},size:{$ref:"#/$defs/PaneDimension",description:"Fixed pane size."}},required:["mode","size"],type:"object"},{additionalProperties:!1,properties:{maxSize:{$ref:"#/$defs/PaneDimension",description:"Optional maximum content size."},minSize:{$ref:"#/$defs/PaneDimension",description:"Optional minimum content size."},mode:{const:"content",description:"Size the pane from its content.",type:"string"}},required:["mode"],type:"object"},{additionalProperties:!1,properties:{growWeight:{description:"Relative share of available growth. Default: 1.",type:"number"},maxSize:{$ref:"#/$defs/PaneDimension",description:"Optional maximum pane size."},minSize:{$ref:"#/$defs/PaneDimension",description:"Optional minimum pane size."},mode:{description:"Fill available space or allow user resizing.",enum:["fill","resizable"],type:"string"},preferredSize:{$ref:"#/$defs/PaneDimension",description:"Preferred pane size."},shrinkWeight:{description:"Relative share of required shrinking. Default: 1.",type:"number"}},required:["mode","preferredSize"],type:"object"}]},SplitPaneAdaptation:{additionalProperties:!1,id:"SplitPaneAdaptation",properties:{collapseBelow:{$ref:"#/$defs/SplitPaneCollapseBelow",description:"Priority collapse thresholds using Pebble breakpoint tokens."},overflow:{const:"horizontal",description:"Allow horizontal overflow when non-collapsible panes cannot fit.",type:"string"},reflow:{$ref:"#/$defs/SplitPaneReflow",description:"Responsive stack or single-pane reflow rule."}},type:"object"},SplitPaneCollapseBelow:{additionalProperties:!1,id:"SplitPaneCollapseBelow",properties:{SECONDARY:{description:"Breakpoint below which SECONDARY panes collapse.",enum:["breakpoint2xl","breakpointLg","breakpointMd","breakpointSm","breakpointXl"],type:"string"},TERTIARY:{description:"Breakpoint below which TERTIARY panes collapse.",enum:["breakpoint2xl","breakpointLg","breakpointMd","breakpointSm","breakpointXl"],type:"string"}},type:"object"},SplitPaneDivider:{additionalProperties:!1,id:"SplitPaneDivider",properties:{resizeGrip:{description:"Resize grip visibility for resizable boundaries. Default: visible.",enum:["visible","hidden"],type:"string"},visibility:{description:"Divider line visibility. Default: visible.",enum:["visible","hidden"],type:"string"}},type:"object"},SplitPanePersistence:{additionalProperties:!1,id:"SplitPanePersistence",properties:{fields:{description:"Uncontrolled state fields persisted for this pane group.",items:{enum:["committedSize","collapsed","dismissed","activePaneId"],type:"string"},type:"array"},key:{description:"Stable application-global localStorage key.",type:"string"}},required:["key","fields"],type:"object"},SplitPaneReflow:{additionalProperties:!1,id:"SplitPaneReflow",properties:{below:{description:"Breakpoint below which reflow applies.",enum:["breakpoint2xl","breakpointLg","breakpointMd","breakpointSm","breakpointXl"],type:"string"},mode:{description:"Stack every pane vertically or show one active pane at a time.",enum:["stack","single"],type:"string"}},required:["below","mode"],type:"object"}},ro=[{field:"category",title:"Categories"},{field:"keywords",title:"Keywords"},{field:"anatomy",title:"Anatomy"},{field:"guidance",title:"Guidance"},{field:"antiPatterns",title:"Anti-patterns"},{field:"aiGuardrails",title:"AI guardrails"},{field:"propGuidance",title:"Prop guidance"},{field:"selection",title:"Component selection"},{field:"relatedComponents",title:"Related components"},{field:"subComponents",title:"Sub-components"}];function no(){return Object.fromEntries(Object.entries(r).map(([e,i])=>[e,String(i.description??"")]))}function ao(){return Object.fromEntries(Object.entries(u).map(([e,i])=>[e,String(i.description??"")]))}function so(){return Object.fromEntries(Object.entries(y).map(([e,i])=>[e,String(i.description??"")]))}function po(){return y}function lo(){return v}function co(e){if(!Object.hasOwn(r,e))throw new Error(`Unknown component '${e}'. Available: ${Object.keys(r).join(", ")}`);const i={...r[e]};return delete i.example,i}function yo(e){if(!Object.hasOwn(r,e))throw new Error(`Unknown component '${e}'. Available: ${Object.keys(r).join(", ")}`);return R.renderComponentMarkdown(e,r[e],ro)}function uo(e){if(!(e in u))throw new Error(`Unknown action '${e}'. Available: ${Object.keys(u).join(", ")}`);return u[e]}function ho(e){if(!(e in y))throw new Error(`Unknown function '${e}'. Available: ${Object.keys(y).join(", ")}`);return y[e]}function mo(e){return e?e.slice(1).split("/").map(i=>i.replace(/~1/g,"/").replace(/~0/g,"~")).join("."):"(root)"}function O(e,i){const c=new D._2020Exports.Ajv2020({allErrors:!0,strict:!1});c.removeKeyword("id");const s=c.compile(e);if(s(i))return[];const n=s.errors??[],p=new Set(n.filter(o=>o.keyword==="anyOf").map(o=>o.instancePath));return n.filter(o=>o.keyword==="anyOf"||!(o.schemaPath.includes("/anyOf/")&&p.has(o.instancePath))).map(o=>{const l=mo(o.instancePath);return o.keyword==="anyOf"?`props ${l}: must match the declared schema or a reactive reference`:`props ${l}: ${o.message??"failed schema validation"}`})}const g=C.createCatalogSchemaValidator({defs:v,directives:oo,supportsStandardDirectives:!0,validateSchema:O});function bo(e){const i=[],c=e.elements??{},s=e.root;s&&!(s in c)&&i.push(`Root element '${s}' not found in elements map`);for(const[n,p]of Object.entries(c)){const o=p.type??"";if(!(o in r)){i.push(`Element '${n}': unknown type '${o}'`);continue}const l=r[o],m=l.propsSchema;if(m){const d=p.props??{};for(const h of O(g.preparePropsSchema(m),d))i.push(`Element '${n}': ${h}`);for(const[h,I]of Object.entries(d))for(const T of g.nestedDirectiveErrors(I,h))i.push(`Element '${n}': ${T}`)}const w=p.on??{},b=l.events??[];for(const d of Object.keys(w))b.includes(d)||i.push(`Element '${n}': unknown event '${d}'. Valid: ${b.join(", ")}`);(p.children??[]).length>0&&!l.acceptsChildren&&i.push(`Element '${n}': '${o}' does not accept children`)}return i}function go(e){return{...P.renderElementTree(e.root,e.state),platform:"web",catalog:f,catalogVersion:S}}exports.ActionCard=A;exports.AiIcon=E;exports.Alert=x;exports.Animation=N;exports.ApiError=L;exports.AppGroupLoader=k;exports.AppGroupSelect=M;exports.AppNavBar=_;exports.AtomsSeparator=j;exports.Avatar=F;exports.AvatarList=q;exports.Badge=U;exports.Box=B;exports.BrandBadge=H;exports.Breadcrumb=V;exports.Button=G;exports.ButtonGroup=W;exports.CATALOG_NAME=f;exports.CATALOG_VERSION=S;exports.Calendar=z;exports.Card=X;exports.CardGroup=$;exports.Carousel=Y;exports.ChartLoader=K;exports.CheckList=Z;exports.Checkbox=Q;exports.CheckboxGroup=J;exports.Chip=ee;exports.ChipGroup=te;exports.Circle=ie;exports.ColorPicker=oe;exports.ContentLoader=re;exports.CountDown=ne;exports.Country=ae;exports.Currency=se;exports.Dashboard=pe;exports.Date=le;exports.DateInlineMulti=ce;exports.DateRange=de;exports.DaySelector=ye;exports.DistributionBar=ue;exports.Divider=he;exports.DraggableList=me;exports.Drawer=be;exports.Dropdown=ge;exports.Email=fe;exports.EmojiPicker=Se;exports.EmployeeSearch=ve;exports.ExpansionPanel=Oe;exports.ExpansionPanelGroup=we;exports.Field=Ie;exports.File=Te;exports.FileDrop=De;exports.FloatingButton=Ce;exports.Form=Re;exports.FormCheckbox=Pe;exports.FormCheckboxGroup=Ae;exports.FormContent=Ee;exports.FormCurrency=xe;exports.FormDate=Ne;exports.FormDateRange=Le;exports.FormDaySelector=ke;exports.FormEmail=Me;exports.FormEmployeeSearch=_e;exports.FormFile=je;exports.FormFileDrop=Fe;exports.FormGroup=qe;exports.FormGroupHeader=Ue;exports.FormHidden=Be;exports.FormInlineGroup=He;exports.FormInputGroup=Ve;exports.FormMasker=Ge;exports.FormNumber=We;exports.FormPassword=ze;exports.FormPercentage=Xe;exports.FormPhone=$e;exports.FormRadio=Ye;exports.FormSegmentedControl=Ke;exports.FormSelect=Qe;exports.FormSelectableGroup=Je;exports.FormSignature=Ze;exports.FormSin=et;exports.FormSlider=tt;exports.FormSsn=it;exports.FormSurvey=ot;exports.FormSwitch=rt;exports.FormText=nt;exports.FormTextAutoSuggest=st;exports.FormTextarea=at;exports.FormTime=pt;exports.FormTimezone=lt;exports.FormTree=ct;exports.FormTreeSelect=dt;exports.FormWorkEmail=yt;exports.Grid=ut;exports.HStack=bt;exports.Heading=ht;exports.Hidden=mt;exports.Icon=gt;exports.IconButton=ft;exports.Image=St;exports.ImageViewer=vt;exports.InputGroup=Ot;exports.ItemNavigator=wt;exports.Label=It;exports.LabelGroup=Tt;exports.Layout=Dt;exports.LayoutCard=Ct;exports.Link=Rt;exports.ListItem=Pt;exports.LoaderCard=At;exports.LocationCard=Et;exports.LottiePlayer=xt;exports.Masker=Nt;exports.MenuList=Lt;exports.Modal=kt;exports.ModalCloseButton=Mt;exports.ModalFooter=_t;exports.NestedList=jt;exports.Number=Ft;exports.ObjectListView=qt;exports.ObjectUI=Ut;exports.ObjectUIContent=Bt;exports.ObjectUIHeader=Ht;exports.ObjectUIStats=Vt;exports.ObjectUITemplate=Gt;exports.PageAppLogo=Wt;exports.PageContent=zt;exports.PageFooter=Xt;exports.PageHeader=$t;exports.Paginate=Yt;exports.PaginateList=Kt;exports.Pane=Qt;exports.Password=Jt;exports.Percentage=Zt;exports.Phone=ei;exports.ProgressBar=ti;exports.ProgressSteps=ii;exports.Radio=oi;exports.RangeSlider=ri;exports.ReportLoader=ni;exports.ReportShareLoader=si;exports.ReportViewerLoader=pi;exports.Reports=ai;exports.ResizableBoard=li;exports.Responsive=ci;exports.SegmentedControl=di;exports.Select=yi;exports.SelectableGroup=ui;exports.SelectableMenu=hi;exports.SettingsLoader=mi;exports.ShowMore=bi;exports.Signature=gi;exports.Sin=fi;exports.Skeleton=Si;exports.Slider=vi;exports.SnackBar=Oi;exports.Spinner=wi;exports.SplitButton=Ii;exports.SplitPane=Ti;exports.Ssn=Di;exports.Status=Ci;exports.Stepper=Ri;exports.SupportButton=Pi;exports.Survey=Ai;exports.Switch=Ei;exports.Tab=xi;exports.TableBasic=Ni;exports.Text=Li;exports.TextAutoSuggest=Mi;exports.TextClip=_i;exports.TextInput=ji;exports.TextSnippet=Fi;exports.Textarea=ki;exports.Time=qi;exports.TimeRange=Ui;exports.Timezone=Bi;exports.Tip=Hi;exports.TitleCaption=Vi;exports.ToggleableArrow=Gi;exports.Tree=Wi;exports.TreeSelect=zi;exports.VStack=$i;exports.Video=Xi;exports.WorkEmail=Yi;exports.getAction=uo;exports.getActions=ao;exports.getComponent=co;exports.getComponentMarkdown=yo;exports.getComponents=no;exports.getComputedFunctions=po;exports.getDefs=lo;exports.getFunction=ho;exports.getFunctions=so;exports.navigate=Ki;exports.openChatAssistantWithMessage=Qi;exports.pushState=Ji;exports.removeState=Zi;exports.render=go;exports.setState=eo;exports.showNotification=to;exports.triggerFunction=io;exports.validate=bo;
|
|
8
|
+
onError (client-side): runs if handler throws. Same format as onSuccess.`,paramsSchema:{$schema:"https://json-schema.org/draft/2020-12/schema",additionalProperties:!1,properties:{functionApiName:{type:"string"},inputs:{additionalProperties:{},properties:{action:{type:"string"}},required:["action"],type:"object"},onError:{},onSuccess:{},responsePath:{type:"string"}},required:["functionApiName","inputs"],type:"object"}}},u={},co={},S={AppNavBarNavItem:{additionalProperties:!1,id:"AppNavBarNavItem",properties:{badge:{additionalProperties:!1,description:"Badge shown next to the nav item title",properties:{appearance:{description:"Badge visual style",enum:["INFO_DARK","INFO_LIGHT","ERROR_DARK","ERROR_LIGHT","PRIMARY_DARK","PRIMARY_LIGHT","SUCCESS_DARK","SUCCESS_LIGHT","WARNING_DARK","WARNING_LIGHT","NEUTRAL","BLACK"],type:"string"},text:{description:"Text to display in the badge",type:"string"}},required:["text"],type:"object"},icon:{description:"Icon name from Icon.TYPES (e.g. FOLDER_OUTLINE)",type:"string"},isSection:{description:"If true, renders as a non-interactive section header (vertical mode only)",type:"boolean"},links:{description:"Nested sub-navigation items",items:{$ref:"#/$defs/AppNavBarNavItem"},type:"array"},path:{description:"URL path segment for this nav item",type:"string"},queryParams:{additionalProperties:{type:"string"},description:"Query parameters to append when navigating to this item",propertyNames:{type:"string"},type:"object"},size:{description:"Width constraint for this navigation item in pixels",type:"number"},title:{description:"Display label for this nav item",type:"string"}},required:["title"],type:"object"},CheckListItem:{additionalProperties:!1,id:"CheckListItem",properties:{branches:{description:"Nested child items",items:{$ref:"#/$defs/CheckListItem"},type:"array"},checkListOptions:{additionalProperties:!1,description:"Per-item input type overrides",properties:{shouldHaveNegativeCheckbox:{description:"Override negative checkbox for this item",type:"boolean"},type:{description:"Override input type for this item",enum:["SWITCH","CHECKBOX"],type:"string"}},type:"object"},isChecked:{description:"Whether this item is checked",type:"boolean"},isDefaultOpen:{description:"If true, nested items are expanded by default",type:"boolean"},isDisabled:{description:"Disables interaction for this item",type:"boolean"},label:{description:"Display text for this item",type:"string"},showMoreSize:{description:'Number of child items shown before "show more" toggle',type:"number"},value:{description:"Unique identifier for this item",type:"string"}},required:["label","value","isChecked"],type:"object"},NestedListItem:{additionalProperties:!1,id:"NestedListItem",properties:{branches:{description:"Child items",items:{$ref:"#/$defs/NestedListItem"},type:"array"},isDefaultOpen:{description:"Start expanded",type:"boolean"},label:{description:"Display text for the item",type:"string"},value:{description:"Unique value for the item",type:"string"}},required:["label"],type:"object"},PaneAdaptationRule:{additionalProperties:!1,id:"PaneAdaptationRule",properties:{below:{description:"Pebble breakpoint token below which this rule applies.",enum:["breakpoint2xl","breakpointLg","breakpointMd","breakpointSm","breakpointXl"],type:"string"},presentation:{description:"Alternate presentation used below the breakpoint.",enum:["bottomDock","overlay","hidden"],type:"string"}},required:["below","presentation"],type:"object"},PaneBodyDescriptor:{additionalProperties:!1,id:"PaneBodyDescriptor",properties:{noPadding:{description:"Remove the default space300 body padding. Default: false.",type:"boolean"},scroll:{description:"Body scroll ownership. Default: auto.",enum:["auto","none"],type:"string"}},type:"object"},PaneCommittedSize:{additionalProperties:!1,id:"PaneCommittedSize",properties:{horizontal:{description:"Committed horizontal size in pixels.",type:"number"},vertical:{description:"Committed vertical size in pixels.",type:"number"}},type:"object"},PaneControlTips:{additionalProperties:!1,id:"PaneControlTips",properties:{collapse:{anyOf:[{type:"string"},{type:"null"}],description:"Collapse-control tooltip override."},dismiss:{anyOf:[{type:"string"},{type:"null"}],description:"Dismiss-control tooltip override."},hide:{anyOf:[{type:"string"},{type:"null"}],description:"Temporary hide-control tooltip override."},restore:{anyOf:[{type:"string"},{type:"null"}],description:"Restore-control tooltip override."},show:{anyOf:[{type:"string"},{type:"null"}],description:"Temporary show-control tooltip override."}},type:"object"},PaneDimension:{anyOf:[{description:"Pixel size.",type:"number"},{additionalProperties:!1,properties:{unit:{const:"percent",description:"Percentage unit discriminator.",type:"string"},value:{description:"Percentage value.",type:"number"}},required:["value","unit"],type:"object"}],id:"PaneDimension"},PaneFooterActionDescriptor:{additionalProperties:!1,id:"PaneFooterActionDescriptor",properties:{appearance:{description:"Pebble Button appearance. Default: OUTLINE.",enum:["ACCENT","ACTIVE","PRIMARY","DESTRUCTIVE","SUCCESS","INFO","WARNING","OUTLINE","SOLID","GHOST"],type:"string"},icon:{description:"Optional Pebble icon name.",type:"string"},id:{description:"Stable action identifier emitted when activated.",type:"string"},isDisabled:{description:"Whether the action is disabled. Default: false.",type:"boolean"},label:{description:"Visible button label.",type:"string"},placement:{description:"Footer side where the action is rendered. Default: end.",enum:["start","end"],type:"string"},shouldShowSpinner:{description:"Whether to show the action loading spinner. Default: false.",type:"boolean"}},required:["id","label"],type:"object"},PaneFooterDescriptor:{additionalProperties:!1,id:"PaneFooterDescriptor",properties:{actions:{description:"Footer button actions.",items:{$ref:"#/$defs/PaneFooterActionDescriptor"},type:"array"}},required:["actions"],type:"object"},PaneHeaderActionDescriptor:{additionalProperties:!1,id:"PaneHeaderActionDescriptor",properties:{appearance:{description:"Pebble IconButton appearance. Default: GHOST.",enum:["ACCENT","ACTIVE","PRIMARY","DESTRUCTIVE","SUCCESS","INFO","WARNING","OUTLINE","SOLID","GHOST"],type:"string"},ariaLabel:{description:"Accessible name for the icon-only action.",type:"string"},icon:{description:"Icon displayed by the header action.",type:"string"},id:{description:"Stable action identifier emitted when activated.",type:"string"},isDisabled:{description:"Whether the action is disabled. Default: false.",type:"boolean"},placement:{description:"Side of the title where the action is rendered. Default: end.",enum:["start","end"],type:"string"},tip:{anyOf:[{type:"string"},{type:"null"}],description:"Tooltip override. Defaults to ariaLabel; null disables the tooltip."}},required:["id","icon","ariaLabel"],type:"object"},PaneHeaderDescriptor:{additionalProperties:!1,id:"PaneHeaderDescriptor",properties:{actions:{description:"Header actions. Excess actions move into the Pebble Dropdown overflow menu.",items:{$ref:"#/$defs/PaneHeaderActionDescriptor"},type:"array"},leadingIcon:{description:"Optional icon before the title.",type:"string"},title:{description:"Pane header title.",type:"string"}},required:["title"],type:"object"},PaneSizing:{id:"PaneSizing",oneOf:[{additionalProperties:!1,properties:{mode:{const:"fixed",description:"Use an exact pane size.",type:"string"},size:{$ref:"#/$defs/PaneDimension",description:"Fixed pane size."}},required:["mode","size"],type:"object"},{additionalProperties:!1,properties:{maxSize:{$ref:"#/$defs/PaneDimension",description:"Optional maximum content size."},minSize:{$ref:"#/$defs/PaneDimension",description:"Optional minimum content size."},mode:{const:"content",description:"Size the pane from its content.",type:"string"}},required:["mode"],type:"object"},{additionalProperties:!1,properties:{growWeight:{description:"Relative share of available growth. Default: 1.",type:"number"},maxSize:{$ref:"#/$defs/PaneDimension",description:"Optional maximum pane size."},minSize:{$ref:"#/$defs/PaneDimension",description:"Optional minimum pane size."},mode:{description:"Fill available space or allow user resizing.",enum:["fill","resizable"],type:"string"},preferredSize:{$ref:"#/$defs/PaneDimension",description:"Preferred pane size."},shrinkWeight:{description:"Relative share of required shrinking. Default: 1.",type:"number"}},required:["mode","preferredSize"],type:"object"}]},SplitPaneAdaptation:{additionalProperties:!1,id:"SplitPaneAdaptation",properties:{collapseBelow:{$ref:"#/$defs/SplitPaneCollapseBelow",description:"Priority collapse thresholds using Pebble breakpoint tokens."},overflow:{const:"horizontal",description:"Allow horizontal overflow when non-collapsible panes cannot fit.",type:"string"},reflow:{$ref:"#/$defs/SplitPaneReflow",description:"Responsive stack or single-pane reflow rule."}},type:"object"},SplitPaneCollapseBelow:{additionalProperties:!1,id:"SplitPaneCollapseBelow",properties:{SECONDARY:{description:"Breakpoint below which SECONDARY panes collapse.",enum:["breakpoint2xl","breakpointLg","breakpointMd","breakpointSm","breakpointXl"],type:"string"},TERTIARY:{description:"Breakpoint below which TERTIARY panes collapse.",enum:["breakpoint2xl","breakpointLg","breakpointMd","breakpointSm","breakpointXl"],type:"string"}},type:"object"},SplitPaneDivider:{additionalProperties:!1,id:"SplitPaneDivider",properties:{resizeGrip:{description:"Resize grip visibility for resizable boundaries. Default: visible.",enum:["visible","hidden"],type:"string"},visibility:{description:"Divider line visibility. Default: visible.",enum:["visible","hidden"],type:"string"}},type:"object"},SplitPanePersistence:{additionalProperties:!1,id:"SplitPanePersistence",properties:{fields:{description:"Uncontrolled state fields persisted for this pane group.",items:{enum:["committedSize","collapsed","dismissed","activePaneId"],type:"string"},type:"array"},key:{description:"Stable application-global localStorage key.",type:"string"}},required:["key","fields"],type:"object"},SplitPaneReflow:{additionalProperties:!1,id:"SplitPaneReflow",properties:{below:{description:"Breakpoint below which reflow applies.",enum:["breakpoint2xl","breakpointLg","breakpointMd","breakpointSm","breakpointXl"],type:"string"},mode:{description:"Stack every pane vertically or show one active pane at a time.",enum:["stack","single"],type:"string"}},required:["below","mode"],type:"object"}},uo=[{field:"category",title:"Categories"},{field:"keywords",title:"Keywords"},{field:"anatomy",title:"Anatomy"},{field:"guidance",title:"Guidance"},{field:"antiPatterns",title:"Anti-patterns"},{field:"aiGuardrails",title:"AI guardrails"},{field:"propGuidance",title:"Prop guidance"},{field:"selection",title:"Component selection"},{field:"relatedComponents",title:"Related components"},{field:"subComponents",title:"Sub-components"}];function ho(){return Object.fromEntries(Object.entries(a).map(([e,i])=>[e,String(i.description??"")]))}function mo(){return Object.fromEntries(Object.entries(h).map(([e,i])=>[e,String(i.description??"")]))}function yo(){return Object.fromEntries(Object.entries(u).map(([e,i])=>[e,String(i.description??"")]))}function go(){return u}function bo(){return S}function fo(e){if(!Object.hasOwn(a,e))throw new Error(`Unknown component '${e}'. Available: ${Object.keys(a).join(", ")}`);const i={...a[e]};return delete i.example,i}function wo(e){if(!Object.hasOwn(a,e))throw new Error(`Unknown component '${e}'. Available: ${Object.keys(a).join(", ")}`);return A.renderComponentMarkdown(e,a[e],uo)}function vo(e){if(!(e in h))throw new Error(`Unknown action '${e}'. Available: ${Object.keys(h).join(", ")}`);return h[e]}function So(e){if(!(e in u))throw new Error(`Unknown function '${e}'. Available: ${Object.keys(u).join(", ")}`);return u[e]}function Io(e){return e?e.slice(1).split("/").map(i=>i.replace(/~1/g,"/").replace(/~0/g,"~")).join("."):"(root)"}function I(e,i){const d=new D._2020Exports.Ajv2020({allErrors:!0,strict:!1});d.removeKeyword("id");const c=d.compile(e);if(c(i))return[];const n=c.errors??[],l=new Set(n.filter(o=>o.keyword==="anyOf").map(o=>o.instancePath));return n.filter(o=>o.keyword==="anyOf"||!(o.schemaPath.includes("/anyOf/")&&l.has(o.instancePath))).map(o=>{const p=Io(o.instancePath);return o.keyword==="anyOf"?`props ${p}: must match the declared schema or a reactive reference`:`props ${p}: ${o.message??"failed schema validation"}`})}const f=k.createCatalogSchemaValidator({defs:S,directives:co,supportsStandardDirectives:!0,validateSchema:I});function Co(e){const i=[],d=e.elements??{},c=e.root;c&&!(c in d)&&i.push(`Root element '${c}' not found in elements map`);for(const[n,l]of Object.entries(d)){const o=l.type??"";if(!(o in a)){i.push(`Element '${n}': unknown type '${o}'`);continue}const p=a[o],y=p.propsSchema;if(y){const r=l.props??{};for(const m of I(f.preparePropsSchema(y),r))i.push(`Element '${n}': ${m}`);for(const[m,T]of Object.entries(r))for(const O of f.nestedDirectiveErrors(T,m))i.push(`Element '${n}': ${O}`)}const C=l.on??{},g=p.events??[];for(const r of Object.keys(C))g.includes(r)||i.push(`Element '${n}': unknown event '${r}'. Valid: ${g.join(", ")}`);(l.children??[]).length>0&&!p.acceptsChildren&&i.push(`Element '${n}': '${o}' does not accept children`);const x=l.slots??{},b=p.slots??[];for(const r of Object.keys(x))b.includes(r)||i.push(`Element '${n}': unknown slot '${r}'. Valid: ${b.join(", ")}`)}return i}function xo(e){return{...P.renderElementTree(e.root,e.state),platform:"web",catalog:w,catalogVersion:v}}exports.ActionCard=L;exports.AiIcon=R;exports.Alert=E;exports.Animation=N;exports.ApiError=M;exports.AppGroupLoader=B;exports.AppGroupSelect=F;exports.AppNavBar=j;exports.AtomsSeparator=q;exports.Avatar=_;exports.AvatarList=U;exports.Badge=W;exports.Box=H;exports.BrandBadge=G;exports.Breadcrumb=z;exports.Button=V;exports.ButtonGroup=X;exports.CATALOG_NAME=w;exports.CATALOG_VERSION=v;exports.Calendar=$;exports.Card=Y;exports.CardGroup=K;exports.Carousel=J;exports.ChartLoader=Q;exports.CheckList=te;exports.Checkbox=Z;exports.CheckboxGroup=ee;exports.Chip=ie;exports.ChipGroup=oe;exports.Circle=ne;exports.ColorPicker=ae;exports.ContentLoader=re;exports.CountDown=se;exports.Country=le;exports.Currency=pe;exports.Dashboard=ce;exports.Date=de;exports.DateInlineMulti=ue;exports.DateRange=he;exports.DaySelector=me;exports.DistributionBar=ye;exports.Divider=ge;exports.DraggableList=be;exports.Drawer=fe;exports.Dropdown=we;exports.Email=ve;exports.EmojiPicker=Se;exports.EmployeeSearch=Ie;exports.ExpansionPanel=Ce;exports.ExpansionPanelGroup=xe;exports.Field=Te;exports.File=Oe;exports.FileDrop=De;exports.FloatingButton=ke;exports.Form=Ae;exports.FormCheckbox=Pe;exports.FormCheckboxGroup=Le;exports.FormContent=Re;exports.FormCurrency=Ee;exports.FormDate=Ne;exports.FormDateRange=Me;exports.FormDaySelector=Be;exports.FormEmail=Fe;exports.FormEmployeeSearch=je;exports.FormFile=qe;exports.FormFileDrop=_e;exports.FormGroup=Ue;exports.FormGroupHeader=We;exports.FormHidden=He;exports.FormInlineGroup=Ge;exports.FormInputGroup=ze;exports.FormMasker=Ve;exports.FormNumber=Xe;exports.FormPassword=$e;exports.FormPercentage=Ye;exports.FormPhone=Ke;exports.FormRadio=Je;exports.FormRecordLookup=Qe;exports.FormSegmentedControl=Ze;exports.FormSelect=et;exports.FormSelectableGroup=tt;exports.FormSignature=it;exports.FormSin=ot;exports.FormSlider=nt;exports.FormSsn=at;exports.FormSurvey=rt;exports.FormSwitch=st;exports.FormText=lt;exports.FormTextAutoSuggest=ct;exports.FormTextarea=pt;exports.FormTime=dt;exports.FormTimezone=ut;exports.FormTree=ht;exports.FormTreeSelect=mt;exports.FormWorkEmail=yt;exports.Grid=gt;exports.HStack=wt;exports.Heading=bt;exports.Hidden=ft;exports.Icon=vt;exports.IconButton=St;exports.Image=It;exports.ImageViewer=Ct;exports.InputGroup=xt;exports.Interval=Tt;exports.ItemNavigator=Ot;exports.Label=Dt;exports.LabelGroup=kt;exports.Layout=At;exports.LayoutCard=Pt;exports.Link=Lt;exports.ListItem=Rt;exports.LoaderCard=Et;exports.LocationCard=Nt;exports.LottiePlayer=Mt;exports.Masker=Bt;exports.MenuList=Ft;exports.Modal=jt;exports.ModalCloseButton=qt;exports.ModalFooter=_t;exports.NestedList=Ut;exports.Number=Wt;exports.ObjectListView=Ht;exports.ObjectUI=Gt;exports.ObjectUIContent=zt;exports.ObjectUIHeader=Vt;exports.ObjectUIStats=Xt;exports.ObjectUITemplate=$t;exports.PageAppLogo=Yt;exports.PageContent=Kt;exports.PageFooter=Jt;exports.PageHeader=Qt;exports.Paginate=Zt;exports.PaginateList=ei;exports.Pane=ti;exports.Password=ii;exports.Percentage=oi;exports.Phone=ni;exports.ProgressBar=ai;exports.ProgressSteps=ri;exports.Radio=si;exports.RangeSlider=li;exports.RecordLookup=pi;exports.ReportLoader=ci;exports.ReportShareLoader=ui;exports.ReportViewerLoader=hi;exports.Reports=di;exports.ResizableBoard=mi;exports.Responsive=yi;exports.SegmentedControl=gi;exports.Select=bi;exports.SelectableGroup=fi;exports.SelectableMenu=wi;exports.SettingsLoader=vi;exports.ShowMore=Si;exports.Signature=Ii;exports.Sin=Ci;exports.Skeleton=xi;exports.Slider=Ti;exports.SnackBar=Oi;exports.Spinner=Di;exports.SplitButton=ki;exports.SplitPane=Ai;exports.Ssn=Pi;exports.Status=Li;exports.Stepper=Ri;exports.SuperGrid=Ei;exports.SupportButton=Ni;exports.Survey=Mi;exports.Switch=Bi;exports.Tab=Fi;exports.TableBasic=ji;exports.Text=qi;exports.TextAutoSuggest=Ui;exports.TextClip=Wi;exports.TextInput=Hi;exports.TextSnippet=Gi;exports.Textarea=_i;exports.Time=zi;exports.TimeRange=Vi;exports.Timezone=Xi;exports.Tip=$i;exports.TitleCaption=Yi;exports.ToggleableArrow=Ki;exports.Tree=Ji;exports.TreeSelect=Qi;exports.VStack=eo;exports.Video=Zi;exports.WorkEmail=to;exports.getAction=vo;exports.getActions=mo;exports.getComponent=fo;exports.getComponentMarkdown=wo;exports.getComponents=ho;exports.getComputedFunctions=go;exports.getDefs=bo;exports.getFunction=So;exports.getFunctions=yo;exports.invalidateSuperGridData=io;exports.navigate=oo;exports.openChatAssistantWithMessage=no;exports.pushState=ao;exports.removeState=ro;exports.render=xo;exports.setState=so;exports.showNotification=lo;exports.triggerFunction=po;exports.validate=Co;
|
|
7
9
|
//# sourceMappingURL=index.cjs.map
|