[{"data":1,"prerenderedAt":653},["ShallowReactive",2],{"docs-navigation":3,"docs:\u002Fdesign-system\u002Fpatterns-and-safety":494,"docs-surroundings:\u002Fdesign-system\u002Fpatterns-and-safety":650},[4,47,100],{"title":5,"navigation":6,"description":7,"path":8,"stem":9,"children":10,"page":46},"Getting started",true,null,"\u002Fgetting-started","1.getting-started",[11,18,25,32,39],{"title":12,"path":13,"stem":14,"navigation":15,"description":17,"icon":16},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"icon":16},"tabler:book","IPEX is the design system for Igris Labs applications.",{"title":19,"path":20,"stem":21,"navigation":22,"description":24,"icon":23},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation",{"icon":23},"tabler:download","Install the shared packages, theme, utilities, and global configuration once. Then copy the components you need.",{"title":26,"path":27,"stem":28,"navigation":29,"description":31,"icon":30},"Styling","\u002Fgetting-started\u002Fstyling","1.getting-started\u002F3.styling",{"icon":30},"tabler:palette","Change the theme, component defaults, or a single instance.",{"title":33,"path":34,"stem":35,"navigation":36,"description":38,"icon":37},"Usage","\u002Fgetting-started\u002Fusage","1.getting-started\u002F4.usage",{"icon":37},"tabler:adjustments","Import components, bind their state, and set shared defaults.",{"title":40,"path":41,"stem":42,"navigation":43,"description":45,"icon":44},"Contribution guidelines","\u002Fgetting-started\u002Fcontribution","1.getting-started\u002F5.contribution",{"icon":44},"tabler:git-pull-request","Follow the component structure, styling rules, and validation checks when contributing.",false,{"title":48,"navigation":6,"description":7,"path":49,"stem":50,"children":51,"page":46},"Design system","\u002Fdesign-system","2.design-system",[52,59,65,72,79,86,93],{"title":53,"path":54,"stem":55,"navigation":56,"description":58,"icon":57},"Principles","\u002Fdesign-system\u002Fprinciples","2.design-system\u002F1.principles",{"icon":57},"tabler:compass","The decisions that give IPEX its product identity.",{"title":60,"path":61,"stem":62,"navigation":63,"description":64,"icon":30},"Color","\u002Fdesign-system\u002Fcolor","2.design-system\u002F2.color",{"icon":30},"Neutral structure, distinct action colors, and meaningful feedback.",{"title":66,"path":67,"stem":68,"navigation":69,"description":71,"icon":70},"Typography and density","\u002Fdesign-system\u002Ftypography-and-density","2.design-system\u002F3.typography-and-density",{"icon":70},"tabler:typography","Compact product controls, readable prose, and coordinated geometry.",{"title":73,"path":74,"stem":75,"navigation":76,"description":78,"icon":77},"Layout","\u002Fdesign-system\u002Flayout","2.design-system\u002F4.layout",{"icon":77},"tabler:layout","Choose page width from the task, then compose the shell and content around it.",{"title":80,"path":81,"stem":82,"navigation":83,"description":85,"icon":84},"Materials and states","\u002Fdesign-system\u002Fmaterials-and-states","2.design-system\u002F5.materials-and-states",{"icon":84},"tabler:stack-2","Match surface weight to structure, engagement, execution, and stacking.",{"title":87,"path":88,"stem":89,"navigation":90,"description":92,"icon":91},"Motion and accessibility","\u002Fdesign-system\u002Fmotion-and-accessibility","2.design-system\u002F6.motion-and-accessibility",{"icon":91},"tabler:accessible","Fast feedback, continuous transitions, and usable controls across input methods.",{"title":94,"path":95,"stem":96,"navigation":97,"description":99,"icon":98},"Patterns and safety","\u002Fdesign-system\u002Fpatterns-and-safety","2.design-system\u002F7.patterns-and-safety",{"icon":98},"tabler:shield-check","Apply IPEX to forms, operational data, feedback, and consequential writes.",{"title":101,"navigation":6,"description":7,"path":102,"stem":103,"children":104,"page":46},"Components","\u002Fcomponents","3.components",[105,112,119,125,132,139,146,153,160,167,174,181,188,195,202,209,216,223,230,237,244,251,258,265,272,279,286,293,300,307,313,320,327,334,341,348,355,362,369,375,382,389,396,403,410,417,424,431,438,445,452,459,466,473,480,487],{"title":106,"path":107,"stem":108,"navigation":109,"description":111,"icon":110},"Accordion","\u002Fcomponents\u002Faccordion","3.components\u002Faccordion",{"icon":110},"tabler:arrows-vertical","Show related content in sections that expand and collapse.",{"title":113,"path":114,"stem":115,"navigation":116,"description":118,"icon":117},"Alert Dialog","\u002Fcomponents\u002Falert-dialog","3.components\u002Falert-dialog",{"icon":117},"tabler:alert-triangle","Ask for confirmation before an action continues.",{"title":120,"path":121,"stem":122,"navigation":123,"description":124,"icon":77},"App Layout","\u002Fcomponents\u002Fapp-layout","3.components\u002Fapp-layout",{"icon":77},"Arrange a header, sidebars, content, and footer in one application shell.",{"title":126,"path":127,"stem":128,"navigation":129,"description":131,"icon":130},"Avatar","\u002Fcomponents\u002Favatar","3.components\u002Favatar",{"icon":130},"tabler:user-circle","Show a profile image with a fallback when it cannot load.",{"title":133,"path":134,"stem":135,"navigation":136,"description":138,"icon":137},"Button","\u002Fcomponents\u002Fbutton","3.components\u002Fbutton",{"icon":137},"tabler:hand-click","Trigger an action or navigate to another page.",{"title":140,"path":141,"stem":142,"navigation":143,"description":145,"icon":144},"Calendar","\u002Fcomponents\u002Fcalendar","3.components\u002Fcalendar",{"icon":144},"tabler:calendar","Select dates from a calendar with keyboard navigation.",{"title":147,"path":148,"stem":149,"navigation":150,"description":152,"icon":151},"Checkbox","\u002Fcomponents\u002Fcheckbox","3.components\u002Fcheckbox",{"icon":151},"tabler:checkbox","Turn an option on or off.",{"title":154,"path":155,"stem":156,"navigation":157,"description":159,"icon":158},"Checkbox Group","\u002Fcomponents\u002Fcheckbox-group","3.components\u002Fcheckbox-group",{"icon":158},"tabler:list-check","Select one or more options from a group of checkboxes.",{"title":161,"path":162,"stem":163,"navigation":164,"description":166,"icon":165},"Collapsible","\u002Fcomponents\u002Fcollapsible","3.components\u002Fcollapsible",{"icon":165},"tabler:chevron-down","Show or hide a single section of content.",{"title":168,"path":169,"stem":170,"navigation":171,"description":173,"icon":172},"Combobox","\u002Fcomponents\u002Fcombobox","3.components\u002Fcombobox",{"icon":172},"tabler:selector","Search a list of options and select one or more values.",{"title":175,"path":176,"stem":177,"navigation":178,"description":180,"icon":179},"Context Menu","\u002Fcomponents\u002Fcontext-menu","3.components\u002Fcontext-menu",{"icon":179},"tabler:pointer","Show a menu of actions at the pointer when someone right-clicks.",{"title":182,"path":183,"stem":184,"navigation":185,"description":187,"icon":186},"Data Table","\u002Fcomponents\u002Fdata-table","3.components\u002Fdata-table",{"icon":186},"tabler:table","Display records with sorting, filtering, selection, and pagination.",{"title":189,"path":190,"stem":191,"navigation":192,"description":194,"icon":193},"Date Field","\u002Fcomponents\u002Fdate-field","3.components\u002Fdate-field",{"icon":193},"tabler:calendar-event","Enter a date by typing or selecting from a calendar.",{"title":196,"path":197,"stem":198,"navigation":199,"description":201,"icon":200},"Date Range Field","\u002Fcomponents\u002Fdate-range-field","3.components\u002Fdate-range-field",{"icon":200},"tabler:calendar-week","Enter start and end dates in separate editable fields.",{"title":203,"path":204,"stem":205,"navigation":206,"description":208,"icon":207},"Date Range Picker","\u002Fcomponents\u002Fdate-range-picker","3.components\u002Fdate-range-picker",{"icon":207},"tabler:calendar-month","Enter a date range by typing or selecting from a calendar.",{"title":210,"path":211,"stem":212,"navigation":213,"description":215,"icon":214},"Dialog","\u002Fcomponents\u002Fdialog","3.components\u002Fdialog",{"icon":214},"tabler:app-window","Open a modal panel while keeping keyboard focus inside it.",{"title":217,"path":218,"stem":219,"navigation":220,"description":222,"icon":221},"Drawer","\u002Fcomponents\u002Fdrawer","3.components\u002Fdrawer",{"icon":221},"tabler:layout-sidebar-right","Open a panel from an edge of the screen.",{"title":224,"path":225,"stem":226,"navigation":227,"description":229,"icon":228},"Editable","\u002Fcomponents\u002Feditable","3.components\u002Feditable",{"icon":228},"tabler:pencil","Edit text in place, then save or cancel the change.",{"title":231,"path":232,"stem":233,"navigation":234,"description":236,"icon":235},"Field","\u002Fcomponents\u002Ffield","3.components\u002Ffield",{"icon":235},"tabler:forms","Connect a form control to its label, description, and error message.",{"title":238,"path":239,"stem":240,"navigation":241,"description":243,"icon":242},"Fieldset","\u002Fcomponents\u002Ffieldset","3.components\u002Ffieldset",{"icon":242},"tabler:section","Group related form controls under a shared label.",{"title":245,"path":246,"stem":247,"navigation":248,"description":250,"icon":249},"Form","\u002Fcomponents\u002Fform","3.components\u002Fform",{"icon":249},"tabler:clipboard-text","Submit form values and check their validity.",{"title":252,"path":253,"stem":254,"navigation":255,"description":257,"icon":256},"Hover Preview Card","\u002Fcomponents\u002Fhover-preview-card","3.components\u002Fhover-preview-card",{"icon":256},"tabler:id","Show a content preview when someone hovers or focuses a link.",{"title":259,"path":260,"stem":261,"navigation":262,"description":264,"icon":263},"Input","\u002Fcomponents\u002Finput","3.components\u002Finput",{"icon":263},"tabler:cursor-text","Enter text with support for labels, validation, and form submission.",{"title":266,"path":267,"stem":268,"navigation":269,"description":271,"icon":270},"Listbox","\u002Fcomponents\u002Flistbox","3.components\u002Flistbox",{"icon":270},"tabler:list-details","Select one or more values from a list.",{"title":273,"path":274,"stem":275,"navigation":276,"description":278,"icon":277},"Menu","\u002Fcomponents\u002Fmenu","3.components\u002Fmenu",{"icon":277},"tabler:menu-2","Open a menu of actions from a button.",{"title":280,"path":281,"stem":282,"navigation":283,"description":285,"icon":284},"Menubar","\u002Fcomponents\u002Fmenubar","3.components\u002Fmenubar",{"icon":284},"tabler:layout-navbar","Arrange related action menus in a horizontal bar.",{"title":287,"path":288,"stem":289,"navigation":290,"description":292,"icon":291},"Meter","\u002Fcomponents\u002Fmeter","3.components\u002Fmeter",{"icon":291},"tabler:gauge","Display a numeric value within a known range.",{"title":294,"path":295,"stem":296,"navigation":297,"description":299,"icon":298},"Month Picker","\u002Fcomponents\u002Fmonth-picker","3.components\u002Fmonth-picker",{"icon":298},"tabler:calendar-stats","Select one or more months from a grid.",{"title":301,"path":302,"stem":303,"navigation":304,"description":306,"icon":305},"Month Range Picker","\u002Fcomponents\u002Fmonth-range-picker","3.components\u002Fmonth-range-picker",{"icon":305},"tabler:calendar-share","Select a range of months.",{"title":308,"path":309,"stem":310,"navigation":311,"description":312,"icon":57},"Navigation Menu","\u002Fcomponents\u002Fnavigation-menu","3.components\u002Fnavigation-menu",{"icon":57},"Build navigation links with flyouts or expandable groups.",{"title":314,"path":315,"stem":316,"navigation":317,"description":319,"icon":318},"Number Field","\u002Fcomponents\u002Fnumber-field","3.components\u002Fnumber-field",{"icon":318},"tabler:number-123","Enter a number or adjust it with increment and decrement buttons.",{"title":321,"path":322,"stem":323,"navigation":324,"description":326,"icon":325},"Overlay Provider","\u002Fcomponents\u002Foverlay-provider","3.components\u002Foverlay-provider",{"icon":325},"tabler:layers-intersect","Open and manage dialogs and other overlays from code.",{"title":328,"path":329,"stem":330,"navigation":331,"description":333,"icon":332},"Pagination","\u002Fcomponents\u002Fpagination","3.components\u002Fpagination",{"icon":332},"tabler:arrows-horizontal","Move between pages of a collection.",{"title":335,"path":336,"stem":337,"navigation":338,"description":340,"icon":339},"Pin \u002F OTP Input","\u002Fcomponents\u002Fpin-input","3.components\u002Fpin-input",{"icon":339},"tabler:password","Enter a verification code or PIN across separate cells.",{"title":342,"path":343,"stem":344,"navigation":345,"description":347,"icon":346},"Popover","\u002Fcomponents\u002Fpopover","3.components\u002Fpopover",{"icon":346},"tabler:message","Open a floating panel beside a button or another control.",{"title":349,"path":350,"stem":351,"navigation":352,"description":354,"icon":353},"Progress","\u002Fcomponents\u002Fprogress","3.components\u002Fprogress",{"icon":353},"tabler:progress","Show how much of a task has completed.",{"title":356,"path":357,"stem":358,"navigation":359,"description":361,"icon":360},"Radio Group","\u002Fcomponents\u002Fradio-group","3.components\u002Fradio-group",{"icon":360},"tabler:circle-dot","Choose one option from a group.",{"title":363,"path":364,"stem":365,"navigation":366,"description":368,"icon":367},"Rating","\u002Fcomponents\u002Frating","3.components\u002Frating",{"icon":367},"tabler:star","Choose a rating with whole or fractional values.",{"title":370,"path":371,"stem":372,"navigation":373,"description":374,"icon":165},"Select","\u002Fcomponents\u002Fselect","3.components\u002Fselect",{"icon":165},"Choose one or more values from a dropdown.",{"title":376,"path":377,"stem":378,"navigation":379,"description":381,"icon":380},"Separator","\u002Fcomponents\u002Fseparator","3.components\u002Fseparator",{"icon":380},"tabler:separator","Separate related groups of content.",{"title":383,"path":384,"stem":385,"navigation":386,"description":388,"icon":387},"Sidebar","\u002Fcomponents\u002Fsidebar","3.components\u002Fsidebar",{"icon":387},"tabler:layout-sidebar","Build grouped application navigation with desktop and mobile layouts.",{"title":390,"path":391,"stem":392,"navigation":393,"description":395,"icon":394},"Slider","\u002Fcomponents\u002Fslider","3.components\u002Fslider",{"icon":394},"tabler:adjustments-horizontal","Choose a value or range by dragging a handle or using the keyboard.",{"title":397,"path":398,"stem":399,"navigation":400,"description":402,"icon":401},"Stepper","\u002Fcomponents\u002Fstepper","3.components\u002Fstepper",{"icon":401},"tabler:list-numbers","Guide someone through a sequence of steps.",{"title":404,"path":405,"stem":406,"navigation":407,"description":409,"icon":408},"Switch","\u002Fcomponents\u002Fswitch","3.components\u002Fswitch",{"icon":408},"tabler:toggle-left","Turn a setting on or off.",{"title":411,"path":412,"stem":413,"navigation":414,"description":416,"icon":415},"Tabs","\u002Fcomponents\u002Ftabs","3.components\u002Ftabs",{"icon":415},"tabler:folder","Switch between sections of content.",{"title":418,"path":419,"stem":420,"navigation":421,"description":423,"icon":422},"Tags Input","\u002Fcomponents\u002Ftags-input","3.components\u002Ftags-input",{"icon":422},"tabler:tags","Enter and manage a list of tags.",{"title":425,"path":426,"stem":427,"navigation":428,"description":430,"icon":429},"Time Field","\u002Fcomponents\u002Ftime-field","3.components\u002Ftime-field",{"icon":429},"tabler:clock","Enter a time with separate editable segments.",{"title":432,"path":433,"stem":434,"navigation":435,"description":437,"icon":436},"Time Range Field","\u002Fcomponents\u002Ftime-range-field","3.components\u002Ftime-range-field",{"icon":436},"tabler:clock-hour-4","Enter start and end times.",{"title":439,"path":440,"stem":441,"navigation":442,"description":444,"icon":443},"Toast","\u002Fcomponents\u002Ftoast","3.components\u002Ftoast",{"icon":443},"tabler:bell","Show temporary notifications with optional actions.",{"title":446,"path":447,"stem":448,"navigation":449,"description":451,"icon":450},"Toggle","\u002Fcomponents\u002Ftoggle","3.components\u002Ftoggle",{"icon":450},"tabler:square-toggle","Turn a button on or off.",{"title":453,"path":454,"stem":455,"navigation":456,"description":458,"icon":457},"Toggle Group","\u002Fcomponents\u002Ftoggle-group","3.components\u002Ftoggle-group",{"icon":457},"tabler:layout-grid","Choose one or more pressed buttons from a group.",{"title":460,"path":461,"stem":462,"navigation":463,"description":465,"icon":464},"Toolbar","\u002Fcomponents\u002Ftoolbar","3.components\u002Ftoolbar",{"icon":464},"tabler:tools","Group controls for a related set of actions.",{"title":467,"path":468,"stem":469,"navigation":470,"description":472,"icon":471},"Tooltip","\u002Fcomponents\u002Ftooltip","3.components\u002Ftooltip",{"icon":471},"tabler:help-circle","Show a short explanation on hover or keyboard focus.",{"title":474,"path":475,"stem":476,"navigation":477,"description":479,"icon":478},"Tree","\u002Fcomponents\u002Ftree","3.components\u002Ftree",{"icon":478},"tabler:hierarchy-2","Browse and select items in a nested list.",{"title":481,"path":482,"stem":483,"navigation":484,"description":486,"icon":485},"Year Picker","\u002Fcomponents\u002Fyear-picker","3.components\u002Fyear-picker",{"icon":485},"tabler:calendar-due","Select one or more years from a grid.",{"title":488,"path":489,"stem":490,"navigation":491,"description":493,"icon":492},"Year Range Picker","\u002Fcomponents\u002Fyear-range-picker","3.components\u002Fyear-range-picker",{"icon":492},"tabler:calendar-plus","Select a range of years.",{"id":495,"title":94,"body":496,"description":99,"extension":645,"meta":646,"navigation":647,"path":95,"seo":648,"stem":96,"__hash__":649},"docs\u002F2.design-system\u002F7.patterns-and-safety.md",{"type":497,"value":498,"toc":635},"minimark",[499,508,513,516,519,523,526,529,533,536,540,608,615,619,622,625,628,632],[500,501,502,503,507],"p",{},"Use the component recipes within a workflow that explains the task, its impact, and the result. Match page composition to the ",[504,505,506],"a",{"href":74},"layout archetype"," before choosing local spacing.",[509,510,512],"h2",{"id":511},"forms-and-setup","Forms and setup",[500,514,515],{},"Keep labels visible and place helper text near the field. Explain consequences in language the person can act on. Validate on blur or submit unless immediate validation improves the task; avoid showing errors while someone is still entering a valid value.",[500,517,518],{},"Group related settings. Keep numeric steppers and fields planar. In authentication or onboarding, allow enough space around the focal surface to support trust and comprehension.",[509,520,522],{"id":521},"operational-data","Operational data",[500,524,525],{},"Keep text aligned for scanning and quantities aligned for comparison. Preserve column widths during loading. Keep sorting, filtering, selection, pagination, and row actions predictable.",[500,527,528],{},"Show selected counts and place bulk actions near their affected records. Use an explicit review when the action changes a broad set of data. Group related dashboard metrics within a moderate composition width.",[509,530,532],{"id":531},"drag-and-drop","Drag and drop",[500,534,535],{},"Use a quiet idle region, info color for a valid target, and destructive feedback for an invalid target. Make the active destination clear while dragging. Offer a keyboard path to the same action and confirm completion.",[509,537,539],{"id":538},"feedback-and-recovery","Feedback and recovery",[541,542,543,556],"table",{},[544,545,546],"thead",{},[547,548,549,553],"tr",{},[550,551,552],"th",{},"Situation",[550,554,555],{},"Response",[557,558,559,568,576,584,592,600],"tbody",{},[547,560,561,565],{},[562,563,564],"td",{},"A region is loading",[562,566,567],{},"Match the final geometry and keep unrelated work available.",[547,569,570,573],{},[562,571,572],{},"An action is processing",[562,574,575],{},"Keep its dimensions stable and prevent duplicate writes.",[547,577,578,581],{},[562,579,580],{},"A view is empty",[562,582,583],{},"Explain the condition and provide one useful next action.",[547,585,586,589],{},[562,587,588],{},"Work completes",[562,590,591],{},"Confirm the result through status text or a notification.",[547,593,594,597],{},[562,595,596],{},"Work fails",[562,598,599],{},"Say what failed, what it affected, and how to recover.",[547,601,602,605],{},[562,603,604],{},"Some records fail",[562,606,607],{},"Report success and failure counts, identify the failed records, and support retrying those records.",[500,609,610,611,614],{},"Use semantic colors according to ",[504,612,60],{"href":613},"\u002Fdesign-system\u002Fcolor#feedback-and-status",". A lifecycle label such as Queued or Cancelled can remain neutral.",[509,616,618],{"id":617},"confirmation-by-impact","Confirmation by impact",[500,620,621],{},"For a low-risk reversible change, prefer execution with reliable undo. For a broad reversible operation, show the affected count and a review when useful. Require impact confirmation for destructive, hard-to-reverse, external, financial, legal, tax, or irreversible actions.",[500,623,624],{},"A consequential confirmation should make the affected count, old\u002Fnew differences, impact, Cancel action, and final execution action visible. Offer backup or export when appropriate. After execution, show progress and a recovery path for failures.",[500,626,627],{},"Use direct consequence statements, such as “This will overwrite 238 existing barcodes.” Keep the destructive effect clear before the final action.",[509,629,631],{"id":630},"review-a-screen","Review a screen",[500,633,634],{},"Check its working width, resting visual weight, control density, selected states, focus, loading geometry, mobile flow, and recovery messages. Use real product data when evaluating operational screens. Keep demos identifiable as examples.",{"title":636,"searchDepth":637,"depth":637,"links":638},"",2,[639,640,641,642,643,644],{"id":511,"depth":637,"text":512},{"id":521,"depth":637,"text":522},{"id":531,"depth":637,"text":532},{"id":538,"depth":637,"text":539},{"id":617,"depth":637,"text":618},{"id":630,"depth":637,"text":631},"md",{},{"icon":98},{"title":94,"description":99},"_O-4gVjNIklpEfZ9i3y3X5bQKXRxRIo1cFhw_uE9ncw",[651,652],{"title":87,"path":88,"stem":89,"icon":91,"children":-1},{"title":106,"path":107,"stem":108,"icon":110,"children":-1},1793429547625]