[{"data":1,"prerenderedAt":2686},["ShallowReactive",2],{"cmdk-index":3,"content:\u002Fguides\u002Fcustomization":236},[4,8,12,16,20,24,28,32,36,40,44,48,52,56,60,64,68,72,76,80,84,88,92,96,100,104,108,112,116,120,124,128,132,136,140,144,148,152,156,160,164,168,172,176,180,184,188,192,196,200,204,208,212,216,220,224,228,232],{"path":5,"title":6,"description":7},"\u002Fcomponents\u002Faccordion","Accordion","A disclosure list built entirely on native \u003Cdetails>\u002F\u003Csummary> elements — zero JavaScript, zero\nARIA reinvention. The browser supplies the disclosure role, aria-expanded, Enter\u002FSpace toggling,\nfocus, and find-in-page expansion for free. Single-open (exclusive) mode uses the platform\nexclusive-accordion feature (Baseline 2024): every \u003Cdetails> shares one auto-generated name, so\nthe browser closes siblings when one opens. multiple drops the shared name so each item opens\nindependently.",{"path":9,"title":10,"description":11},"\u002Fcomponents\u002Falert","Alert","A styled, accessible notification banner. Its live-region politeness is derived from the color —\nurgent danger \u002F warn render role=\"alert\" (assertive), everything else role=\"status\" (polite) —\nso a non-urgent banner isn't announced assertively (override with the live prop). It supports an\noptional icon, a title, body text, an actions row, and a dismiss button.",{"path":13,"title":14,"description":15},"\u002Fcomponents\u002Favatar","Avatar","A data-display component that shows an image, or initials derived from text when there is no\nimage (or while it loads). Supports a title \u002F subtitle column for list and profile UIs.",{"path":17,"title":18,"description":19},"\u002Fcomponents\u002Fbadge","Badge","A small status or count indicator. Attach it to any element as a floating pip, drop it inline next\nto text, or render it standalone — all three modes share the same class surface.",{"path":21,"title":22,"description":23},"\u002Fcomponents\u002Fbutton","Button","A styled, accessible button. Dynamic state is expressed through real attributes — disabled becomes\na true disabled (or aria-disabled for link buttons), loading sets aria-busy, and it ships a\nvisible :focus-visible ring.",{"path":25,"title":26,"description":27},"\u002Fcomponents\u002Fcard","Card","A surface container for grouping related content — a header (prepend slot · title · subtitle ·\nappend slot), a body, and optional action rows. It is the most composed styled component, yet the\nstandalone markup is just nested .ori-card__* elements, so it works without Vue.",{"path":29,"title":30,"description":31},"\u002Fcomponents\u002Fcheckbox","Checkbox","A styled, accessible checkbox built on a real \u003Cinput type=\"checkbox\"> — kept in the DOM\n(visually hidden over a custom box) so keyboard, focus, and native form submission work for free.\nThe accent color and :focus-visible ring are driven by the ori-color token; invalid sets\naria-invalid; disabled is the native attribute.",{"path":33,"title":34,"description":35},"\u002Fcomponents\u002Fcolor-picker","Color picker","An accessible color picker: a 2D saturation × brightness area, a hue slider, a hex field, and\noptional preset swatches — an inline panel you compose into an OriPopover for a\nswatch-triggered flow. Behaviour lives in the framework-agnostic useColorPicker (a zero-dependency sRGB +\n2D-area engine, no adapter or machine); the styled component reuses OriSlider for the\nhue channel and OriInput for the hex field. v-model carries a lowercase color\nstring; the internal working model is HSVA, so the hue survives when you drag into a corner and back.",{"path":37,"title":38,"description":39},"\u002Fcomponents\u002Fcombobox","Combobox","A filterable single-select listbox — type to filter, navigate with the keyboard, pick one. It is the\nfirst component driven end-to-end by @oriui\u002Fheadless: the state machine + prop-getters own the\nbehaviour (open\u002Fclose, filtering, the active-descendant highlight, selection, and the full\nWAI-ARIA keyboard), and OriCombobox renders the styled shell on top. Unlike the pure-CSS\ncomponents, the behaviour needs JavaScript — the standalone classes give you the look, and\nuseCombobox gives you the behaviour for any UI.",{"path":41,"title":42,"description":43},"\u002Fcomponents\u002Fdialog","Dialog","A modal dialog — the library's first genuinely interactive component, built on the native\n\u003Cdialog> element. Unlike the styled-only components, a dialog needs behaviour: focus trap, scroll\nlock, Esc-to-close, click-outside dismissal, and the full WAI-ARIA keyboard contract. All of it comes\nfrom the platform via showModal() — no state-machine dependency and no adapter to wire. The styled\nOriDialog supplies only the markup and tokens.",{"path":45,"title":46,"description":47},"\u002Fcomponents\u002Fdivider","Divider","A horizontal (default) or vertical rule that separates content. An optional centered label turns it\ninto a visual break like the classic \"OR\" between form sections. A pure layout\u002Fstructure primitive —\nno interactive behaviour, no variants, no size scale.",{"path":49,"title":50,"description":51},"\u002Fcomponents\u002Ffield","Field","The shared shell for form controls — one source of truth for the label \u002F hint \u002F error \u002F\nrequired contract that Input, Select,\nTextarea, Combobox, Slider,\nRadioGroup, and ColorPicker otherwise each wire\nby hand. Wrap a control in OriField and it adopts the field's id, aria-describedby,\naria-invalid, required, disabled, and size — and stops rendering its own label and helper, so\nthere is exactly one of each, wired identically every time. Group and composite controls (RadioGroup,\nCombobox's listbox, ColorPicker) name themselves via aria-labelledby pointing at the field's label.",{"path":53,"title":54,"description":55},"\u002Fcomponents\u002Ficon","Icon","A styled, accessible SVG icon. Decorative by default — renders with aria-hidden=\"true\" and no\nrole. Pass a label to expose it to assistive technology as an image: the icon switches to\nrole=\"img\" + aria-label automatically.",{"path":57,"title":58,"description":59},"\u002Fcomponents\u002Finput","Input","A labelled, accessible text field with v-model. State is expressed through real attributes — the\nnative disabled, aria-invalid when there is an error, and an aria-describedby that points at\nthe rendered hint or error. The label is wired to the field with for\u002Fid (auto-generated via\nuseId when you don't pass one), and arbitrary native attributes (name, autocomplete,\ninputmode, …) fall through to the underlying \u003Cinput>.",{"path":61,"title":62,"description":63},"\u002Fcomponents\u002Fjoin","Join","A thin wrapper that collapses the shared radii and borders of adjacent controls so they read as one\nsegmented unit — button groups, input+button combos, segmented toolbars. No visual styling of its\nown: all colour, size, and variant tokens live on the children.",{"path":65,"title":66,"description":67},"\u002Fcomponents\u002Fkbd","Kbd","A keyboard-key chip — a semantic \u003Ckbd> element styled as a monospace bordered chip. Use it to\nrepresent individual keys, modifier keys, or multi-key shortcuts inline in prose or UI hints.",{"path":69,"title":70,"description":71},"\u002Fcomponents\u002Flink","Link","An inline prose link — the right choice when a destination lives in running text. Distinct from\nOriButton rendered as=\"a\": a button that navigates is still a button; a link in a sentence is\nOriLink. Underlined by default (the affordance survives without color), with a _hover mode that\nhides the underline at rest and reveals it on hover. A visible :focus-visible ring uses the same\ncolor as the text.",{"path":73,"title":74,"description":75},"\u002Fcomponents\u002Fmenu","Menu","A WAI-ARIA menu button: a trigger opens a roving-tabindex action list. Unlike the Popover, open\u002Fclose,\nfocus movement, and click-outside dismissal are driven entirely by the @oriui\u002Fheadless menu\nmachine in JavaScript, not the Popover API — so the panel is not top-layer and carries a z-index. The\npanel is still placed with the same CSS Anchor Positioning primitive as the Popover (ori-anchored),\nzero positioning JS.",{"path":77,"title":78,"description":79},"\u002Fcomponents\u002Fpopover","Popover","A positioned overlay for supplementary content — a menu, a filter panel, a rich hint — tethered to a\ntrigger. It runs entirely on the platform: the trigger opens the panel through the Popover API\n(top-layer, light-dismiss, Esc — zero JS), and the panel is placed with CSS Anchor Positioning\n(anchor-name \u002F position-anchor + position-area, with a collision flip via\nposition-try-fallbacks) — zero positioning JS, no scroll\u002Fresize listeners. Baseline 2026, with\ngraceful degradation: an older engine still opens the panel and places it, just without the\ncollision-aware flip.",{"path":81,"title":82,"description":83},"\u002Fcomponents\u002Fprogress","Progress","A horizontal progress bar that communicates task completion. It supports a determinate mode (a\nknown value out of a max) and an indeterminate mode (animated sweep) for tasks with no\nmeasurable progress. State is expressed through ARIA attributes — aria-valuenow is omitted when\nindeterminate, giving screen readers the correct cue automatically.",{"path":85,"title":86,"description":87},"\u002Fcomponents\u002Fradio","Radio","A \"choose one\" compound control. A role=\"radiogroup\" container names the set via\naria-labelledby; each option is a real \u003Cinput type=\"radio\"> sharing a single name — so the\nbrowser enforces single-select and native form submission — visually hidden behind a styled circle.\nPass the options as an array; per-option disabled is supported.",{"path":89,"title":90,"description":91},"\u002Fcomponents\u002Fselect","Select","A native-first styled select control with v-model. The browser owns the dropdown, full keyboard\ninteraction, type-ahead, and all ARIA semantics — oriUI only styles the closed control and draws a\ndecorative chevron. It shares the form-control contract of Input and\nTextarea: a built-in label, hint, error, and required asterisk, all\nwired for accessibility. State is expressed through real attributes — native disabled and\naria-invalid=\"true\" (not classes) — and arbitrary native attrs (name, autocomplete, …) fall\nthrough to the \u003Cselect> via inheritAttrs:false.",{"path":93,"title":94,"description":95},"\u002Fcomponents\u002Fskeleton","Skeleton","A loading placeholder that signals content is on its way. An animated shimmer sweep sweeps across the\nblock; on devices that request reduced motion the shimmer stops and the tinted block alone signals the\nloading state. Size it with an inline style or a utility class — the skeleton itself carries no\nintrinsic width or height beyond a 1em minimum height.",{"path":97,"title":98,"description":99},"\u002Fcomponents\u002Fslider","Slider","A styled, accessible range control built on a native \u003Cinput type=\"range\">. Because the\nunderlying element is real HTML, the browser supplies role=\"slider\", the full keyboard contract\n(arrow keys, Home\u002FEnd, PageUp\u002FPageDown), and screen-reader value announcements for free — no\nJavaScript bridge needed. Colour and the filled-track portion are driven by CSS custom properties;\nv-model carries a number.",{"path":101,"title":102,"description":103},"\u002Fcomponents\u002Fspinner","Spinner","An accessible loading indicator — renders role=\"status\" with an aria-label (default \"Loading\")\nso assistive technology announces the busy state without any extra work. Use it standalone for a\npage-level or section-level loader, or embed it inline inside a button or label.",{"path":105,"title":106,"description":107},"\u002Fcomponents\u002Fstack","Stack","The workhorse layout primitive — two flex modes in one component. A stack (ori-stack) is a\nflex column: children flow top-to-bottom with a consistent gap. A cluster (ori-cluster) is a\nwrapping flex row: children flow left-to-right, wrap onto new lines, and are centered on the\ncross-axis — ideal for tag clouds, button groups, and badge sets.",{"path":109,"title":110,"description":111},"\u002Fcomponents\u002Fsurface","Surface","An elevated floating surface — a lifted panel with a surface background, an optional hairline, a\ncorner radius, and a mode-aware shadow, and nothing else. No padding, no header\u002Ftitle semantics: it\nis just the box, and the caller owns the layout inside. It's the building block for chrome that floats\nover content — a toolbar island, a zoom control, a side panel, a menu popout's container — and the\nelevation counterpart to Card, which is a content card (padding + header \u002F\ntitle \u002F body \u002F actions).",{"path":113,"title":114,"description":115},"\u002Fcomponents\u002Fswitch","Switch","An on\u002Foff toggle built on a real \u003Cinput type=\"checkbox\" role=\"switch\"> — kept in the DOM\n(visually hidden over a track + thumb) so keyboard, focus, and form submission work for free, and\nassistive technology announces it as a switch. v-model is a boolean. The \"on\" track color and the\n:focus-visible ring both come from the ori-color token; the track and thumb scale with\nori-font-size so size is a single prop.",{"path":117,"title":118,"description":119},"\u002Fcomponents\u002Ftabs","Tabs","An accessible tabs widget with automatic activation. The tablist holds a roving tabindex so\nTab \u002F Shift+Tab enter and leave the group as a single keyboard stop; arrow keys move between\ntabs and immediately select them. State is expressed through real ARIA attributes — aria-selected\ndrives both the active indicator and the label colour; disabled is the native button attribute.",{"path":121,"title":122,"description":123},"\u002Fcomponents\u002Ftag","Tag","A compact label for categorising, filtering, or annotating content — status chips, keyword\nbadges, and removable filter pills. State is expressed through real attributes: aria-disabled\ndisables the tag and its close button without removing it from the DOM.",{"path":125,"title":126,"description":127},"\u002Fcomponents\u002Ftextarea","Textarea","A labelled, accessible multiline text field with v-model. State is expressed through real\nattributes — the native disabled, aria-invalid when there is an error, and an aria-describedby\nthat points at the rendered hint or error. The label is wired to the field with for\u002Fid\n(auto-generated via useId when you don't pass one). Unlike a single-line input the field has no\nfixed height — it grows from a rows-based min-height and stays user-resizable.",{"path":129,"title":130,"description":131},"\u002Fcomponents\u002Ftoast","Toast","An imperative notification system. Push a toast from anywhere with useToast() and render\n\u003COriToaster \u002F> once near the app root to display the queue. No event bus, no Vuex, no provide\u002Finject —\njust a module-level reactive queue that every call site shares.",{"path":133,"title":134,"description":135},"\u002Fcomponents\u002Ftoolbar","Toolbar","A WAI-ARIA toolbar: a set of related controls that share a single Tab stop, navigated internally\nwith the arrow keys via roving tabindex (real DOM focus, not aria-activedescendant). Five\ncomponents make it up — OriToolbar (the root, role=\"toolbar\"), OriToolbarButton (an item —\ncomposes OriButton), OriToolbarSeparator (a perpendicular divider), and a paired\nOriToolbarToggleGroup \u002F OriToolbarToggleItem for a segmented single- or multi-select toggle.\nUnlike the data-driven OriMenu (an items array plus a machine), a toolbar is compositional —\nyou assemble it from slotted components in whatever order and combination you need — so the behaviour\nunderneath, useToolbar from @oriui\u002Fheadless, is a provide\u002Finject\nroving-focus context rather than a state machine over an array.",{"path":137,"title":138,"description":139},"\u002Fcomponents\u002Ftooltip","Tooltip","A CSS-driven tooltip that shows additional context when a control is focused or hovered. The bubble\nis always in the DOM (so the aria-describedby reference is never dangling) and shown\u002Fhidden\nentirely in CSS — no JS state machine, no positioning engine. Show is pure :focus-within (keyboard)\nand :hover wrapped in @media (hover: hover) (pointer, without sticking open on touch).",{"path":141,"title":142,"description":143},"\u002Fguides\u002Fcss","Using the CSS layer","oriUI is three independent layers woven around one set of design tokens. The @oriui\u002Fcss layer is\njust standalone .ori-* classes plus the token theming — no Vue, no build step, no Tailwind. You\nship the stylesheet and write classes. This is how oriUI works with htmx, Astro, or plain HTML —\nthe DaisyUI niche, minus Tailwind.",{"path":145,"title":146,"description":147},"\u002Fguides\u002Fcustomization","Customization","Make it yours — without authoring a whole skin. Most products need one thing: their brand color and\ntheir corner radius on top of accessible, ready-made components. oriUI lets you do that by repointing\na handful of design tokens — a few CSS custom properties in your own stylesheet, no rewrite, no fork.\nThis is the prototype fast, scale without rewriting payoff: the same \u003COriButton> you shipped on\nday one becomes on-brand by the time you ship to users, and nothing about the component changes.",{"path":149,"title":150,"description":151},"\u002Fguides\u002Fdesign-tokens","Design tokens","oriUI is three independent layers woven around one set of design tokens. This page is the\ncatalog — every token, and the resolution model that turns a raw value into the colour a component\npaints. The chain is short and deliberate: a primitive feeds a semantic role, a role feeds a\nper-instance alias, and components read only the alias. That indirection is what lets a single\nclass repoint a single token — the whole zero-runtime theming story rests on it.",{"path":153,"title":154,"description":155},"\u002Fguides\u002Fskins","Skin gallery","A skin is a named palette — a set of token overrides applied with one attribute on \u003Chtml>\n(data-ori-skin). Every skin repoints only the four skinnable roles (primary · secondary ·\nsurface · background, each with a -light and -dark source); the status hues (success ·\nwarn · danger · info) stay shared, and every pairing targets WCAG AA for body text. Switching\na skin is a single attribute write — zero runtime, no recompute, no flash.",{"path":157,"title":158,"description":159},"\u002Fguides\u002Ftheming","Theming","A theme is a mode (light or dark) layered over a skin (a named palette). Both are pure\nattribute toggles on \u003Chtml> — flipping either repoints the active --ori-color-* aliases through\nCSS custom properties, so everything reskins at once with no JavaScript, no recompute, no flash.\nThis is the same zero-runtime story across every layer: a Vue app, the standalone @oriui\u002Fcss\nclasses, htmx fragments, or hand-written HTML all theme identically.",{"path":161,"title":162,"description":163},"\u002Fheadless\u002Fcore","Core","The framework-agnostic heart of the headless layer: a behaviour contract plus a zero-dependency\nnative engine, written in vanilla TypeScript. Every framework binding consumes the same contract,\nso a primitive behaves identically wherever it runs — and the behaviour stays swappable per primitive,\nwithout touching markup.",{"path":165,"title":166,"description":167},"\u002Fheadless\u002Fuse-color-picker","useColorPicker","A headless sRGB color picker — a 2D saturation × brightness area, a hue channel, an optional\nalpha channel, a hex field, and optional preset swatches, assembled from ready-to-bind\nprop-getters. It owns the working color as an internal HSVA object (so the hue survives a grayscale\nround-trip when you drag into a corner and back) and composes a zero-dependency sRGB engine plus pure\n2D-area math from the core: parseColor \u002F formatColor (loose parse in, lowercase string out),\nhsvToRgb \u002F rgbToHex \u002F rgbToHsl (hex \u002F rgb \u002F hsv \u002F hsl conversion), readableInk (WCAG-luminance\nink over a swatch), and resolveAreaPosition \u002F stepAreaPosition (pointer → coordinate and keyboard\nstepping across the two axes).",{"path":169,"title":170,"description":171},"\u002Fheadless\u002Fuse-combobox","useCombobox","A headless combobox primitive — an editable text input paired with a popup listbox — implementing\nthe WAI-ARIA combobox with listbox popup pattern: type to filter, navigate with the keyboard via\nactive-descendant, and pick a single option. It owns the behaviour (open\u002Fclose, filtering, the\nhighlight, selection, and the full keyboard) and the ARIA wiring as ready-to-bind prop bags; you own\nthe markup and styles.",{"path":173,"title":174,"description":175},"\u002Fheadless\u002Fuse-dialog","useDialog","A headless modal dialog primitive built on the native \u003Cdialog> element — focus trap, scroll lock,\nEscape to close, focus return, and aria-modal semantics all come from the platform via\nshowModal(). It owns the open state and the ARIA wiring as ready-to-bind prop bags; you own the\nmarkup and styles (you render the \u003Cdialog> and drive showModal() \u002F close() from open).",{"path":177,"title":178,"description":179},"\u002Fheadless\u002Fuse-disclosure","useDisclosure","A headless show \u002F hide primitive for disclosure widgets — expandable panels, accordions, menus,\nthe collapsible sidebar groups on this very site. It owns the open state, the WAI-ARIA wiring, and the\ntoggle handler; you own the markup and the styles.",{"path":181,"title":182,"description":183},"\u002Fheadless\u002Fuse-dismissable","useDismissable","A headless dismiss layer — the \"close the overlay on an outside interaction\" glue a non-platform\noverlay needs, the pattern Radix DismissableLayer \u002F Floating-UI useDismiss standardise. While\nenabled, it attaches document listeners and calls onDismiss() when an interaction lands outside\nthe overlay's own elements. Each overlay picks the strategy that fits it:",{"path":185,"title":186,"description":187},"\u002Fheadless\u002Fuse-menu","useMenu","A headless menu button primitive built on the WAI-ARIA menu-button pattern — a trigger that opens a\npopup menu of actions, with roving tabindex, arrow \u002F Home \u002F End navigation, and Enter \u002F Space\nactivation. It owns the open state and the highlighted item and exposes the ARIA wiring as ready-to-bind\nprop bags; you own the markup, the styles, and the DOM focus (roving needs real focus, and\nclick-outside \u002F focus-return are host concerns a state projection can't reach).",{"path":189,"title":190,"description":191},"\u002Fheadless\u002Fuse-tabs","useTabs","A headless WAI-ARIA tabs widget with automatic activation — a tablist of tabs behind a single\nTab stop, navigated with the arrow keys via roving tabindex (real DOM focus, not\naria-activedescendant), where moving focus also selects. It is data-driven: you pass the tabs\narray plus the selected value, and it returns the tablist prop bag plus per-tab and per-panel\nprop-getters (ids, aria-selected, aria-controls, aria-labelledby, roving tabindex, hidden).",{"path":193,"title":194,"description":195},"\u002Fheadless\u002Fuse-theme","useTheme","A headless light \u002F dark theme controller — it owns the mode setting, resolves auto against the OS\nscheme live, persists the choice, and applies it to the DOM. It applies through applyTheme, which sets\nthe ori-theme_{light,dark} class (removing the opposite — exactly one is on at a time) and works\naround a bug in current Chromium where a runtime theme toggle otherwise leaves styled components\npainting the previous theme's colours until they re-render.",{"path":197,"title":198,"description":199},"\u002Fheadless\u002Fuse-toast","useToast","A headless toast queue — an imperative notification store you call from anywhere (toast('Saved'))\nand render once near the app root. The behaviour is a framework-agnostic engine (a plain array + a Set\nof listeners + auto-dismiss timers) projected into the host framework's reactivity: a Vue reactive\narray and a Svelte readable store. It is a client-side singleton — every useToast() call\nshares the one queue, so a push from anywhere reaches the single renderer.",{"path":201,"title":202,"description":203},"\u002Fheadless\u002Fuse-token","useToken","A reactive token bridge — it resolves an --ori-* design token to its computed value in JS, for\ncanvas \u002F WebGL \u002F chart painters (Konva, ECharts, …) that draw outside the CSS cascade yet must follow the\nactive skin. It reads through a hidden probe, because the obvious API is a trap: getComputedStyle(el).getPropertyValue('--x') hands back the unresolved var() chain (oriUI aliases chain), not a color —\nsubstitution only happens at a real property's computed-value time.",{"path":205,"title":206,"description":207},"\u002Fheadless\u002Fuse-toolbar","useToolbar","A headless WAI-ARIA toolbar — a set of related controls behind a single Tab stop, navigated\ninternally with the arrow keys via roving tabindex (real DOM focus, not aria-activedescendant).\nThe root owns orientation \u002F loop \u002F direction and a single keydown handler; each item registers itself\nand receives its roving tabindex, so a toolbar is assembled from arbitrary slotted components\nrather than a fixed data array.",{"path":209,"title":210,"description":211},"\u002Foverview\u002Faccessibility","Accessibility","Accessibility in oriUI is structural, not a coat of polish on top. The same decisions that make\nthe components correct for assistive technology also make them themeable and framework-agnostic — they\nare the same source of truth, not a separate effort.",{"path":213,"title":214,"description":215},"\u002Foverview\u002Fapplicability","Applicability","oriUI is three independently-consumable layers woven around one token contract. The promise is\nprototype fast, scale without rewriting: reach for the styled Vue components first, drop to the\nheadless behaviour when you need control, or drop to the standalone CSS when you leave Vue entirely —\nwithout changing your design tokens. This page maps each layer to where it runs.",{"path":217,"title":218,"description":219},"\u002Foverview\u002Fcheat-sheet","Cheat sheet","Everything in one page — install, the class model, every component, and the design tokens. For the\nmachine-readable version (e.g. to paste into an AI), fetch \u002Fllms.txt (index) or\n\u002Fllms-full.txt (every page concatenated).",{"path":221,"title":222,"description":223},"\u002Foverview\u002Fcomparisons","Idea & comparisons","oriUI's one-line idea — prototype fast, scale without rewriting — falls out of a single\narchitectural choice: three layers woven around one token contract, so you can change depth\n(styled → headless → CSS) without changing your design system. This page sets that idea next to the\nlibraries oriUI learns from, and is honest about where it does and doesn't compete.",{"path":225,"title":226,"description":227},"\u002Foverview\u002Fget-started","Get started","oriUI is a layered Vue 3 UI library. Install it and import only what you need.",{"path":229,"title":230,"description":231},"\u002Foverview\u002Finstallation","Installation","oriUI is three layers in two packages. Install only the layer you need — they share one token\ncontract, so you can add another later without reworking what you built.",{"path":233,"title":234,"description":235},"\u002Foverview\u002Fintroduction","Introduction","oriUI (織り, ori — \"weaving\") is a layered Vue 3 UI library. The idea in one line:\nprototype fast, scale without rewriting. Start with ready-made styled components; when you need\nmore control, drop down to the behavior or the raw CSS — without throwing away your work, because\nevery layer is woven around the same design tokens.",{"id":237,"title":146,"body":238,"description":147,"extension":2371,"meta":2682,"navigation":749,"path":145,"seo":2683,"stem":2684,"__hash__":2685},"docs\u002Fguides\u002Fcustomization.md",{"type":239,"value":240,"toc":2666},"minimark",[241,245,271,320,325,401,601,623,647,655,683,786,804,841,845,854,926,940,974,979,994,1034,1060,1113,1139,1143,1196,1246,1273,1277,1288,1374,1380,1599,1603,1616,1662,1694,1701,1757,1805,1899,1910,1935,1960,1964,1978,1995,2045,2069,2097,2115,2149,2165,2204,2223,2227,2234,2237,2257,2263,2348,2376,2380,2412,2494,2498,2522,2606,2631,2635,2662],[242,243,146],"h1",{"id":244},"customization",[246,247,248,249,253,254,256,257,261,262,266,267,270],"p",{},"Make it yours — without authoring a whole skin. Most products need one thing: ",[250,251,252],"em",{},"their"," brand color and\n",[250,255,252],{}," corner radius on top of accessible, ready-made components. oriUI lets you do that by repointing\na handful of design tokens — a few CSS custom properties in your own stylesheet, no rewrite, no fork.\nThis is the ",[258,259,260],"strong",{},"prototype fast, scale without rewriting"," payoff: the same ",[263,264,265],"code",{},"\u003COriButton>"," you shipped on\nday one becomes ",[250,268,269],{},"on-brand"," by the time you ship to users, and nothing about the component changes.",[246,272,273,274,277,278,281,282,285,286,289,290,293,294,297,298,301,302,305,306,309,310,313,314,316,317,319],{},"For ",[258,275,276],{},"color"," there are exactly three levels, ordered from safest to most manual: the ",[258,279,280],{},"props","\n(semantic roles with a contrast guarantee — the recommended default), a ",[258,283,284],{},"global brand override","\n(repoint the token sources once, the whole app follows), and ",[258,287,288],{},"per-instance variables"," (the escape\nhatch for a one-off). Around them this page covers ",[258,291,292],{},"styling one instance",", ",[258,295,296],{},"scoping an override to\na subtree",", a ",[258,299,300],{},"5-minute brand walkthrough",", and how customized color reaches ",[258,303,304],{},"icons"," and\n",[258,307,308],{},"JS-painted canvases",". Authoring a complete named skin and switching modes is\n",[311,312,158],"a",{"href":157},"; the exhaustive token inventory is\n",[311,315,150],{"href":149},"; the standalone-class story is ",[311,318,142],{"href":141},".",[321,322,324],"h2",{"id":323},"_1-start-with-the-props-the-semantic-roles","1 · Start with the props — the semantic roles",[246,326,327,328,330,331,334,335,338,339,338,342,338,345,338,348,338,351,338,354,338,357,360,361,330,364,367,368,371,372,375,376,379,380,383,384,383,387,390,391,394,395,397,398,400],{},"Before overriding anything, say what you mean. The styled components take a ",[263,329,276],{}," ",[258,332,333],{},"role"," —\n",[263,336,337],{},"primary"," · ",[263,340,341],{},"secondary",[263,343,344],{},"surface",[263,346,347],{},"background",[263,349,350],{},"success",[263,352,353],{},"warn",[263,355,356],{},"danger",[263,358,359],{},"info"," — and,\nwhere a surface can be painted more than one way, a ",[263,362,363],{},"variant",[258,365,366],{},"mapping"," that decides ",[250,369,370],{},"how"," the role\nis painted: ",[263,373,374],{},"fill"," (role as background, its ",[263,377,378],{},"on-"," color as text), ",[263,381,382],{},"tonal"," \u002F ",[263,385,386],{},"outline",[263,388,389],{},"text"," \u002F\n",[263,392,393],{},"plain"," (role as tint \u002F border \u002F text). Color is the ",[250,396,333],{},", variant is the ",[250,399,366],{}," — the\nbackground-and-text pairing is never yours to hand-assemble.",[402,403,404,408,411,414,529],"example",{},[405,406],"ori-button",{"text":407,"variant":374,"color":337},"Save",[405,409],{"text":410,"variant":386,"color":356},"Delete",[405,412],{"text":413,"variant":382,"color":350},"Done",[415,416,418],"template",{"v-slot:vue":417},"",[419,420,424],"pre",{"className":421,"code":422,"language":423,"meta":417,"style":417},"language-vue shiki shiki-themes github-light github-dark","\u003COriButton text=\"Save\" color=\"primary\" variant=\"fill\" \u002F>\n\u003COriButton text=\"Delete\" color=\"danger\" variant=\"outline\" \u002F>\n\u003COriButton text=\"Done\" color=\"success\" variant=\"tonal\" \u002F>\n","vue",[263,425,426,469,499],{"__ignoreMap":417},[427,428,431,435,439,443,446,450,453,455,458,461,463,466],"span",{"class":429,"line":430},"line",1,[427,432,434],{"class":433},"sVt8B","\u003C",[427,436,438],{"class":437},"s9eBZ","OriButton",[427,440,442],{"class":441},"sScJk"," text",[427,444,445],{"class":433},"=",[427,447,449],{"class":448},"sZZnC","\"Save\"",[427,451,452],{"class":441}," color",[427,454,445],{"class":433},[427,456,457],{"class":448},"\"primary\"",[427,459,460],{"class":441}," variant",[427,462,445],{"class":433},[427,464,465],{"class":448},"\"fill\"",[427,467,468],{"class":433}," \u002F>\n",[427,470,472,474,476,478,480,483,485,487,490,492,494,497],{"class":429,"line":471},2,[427,473,434],{"class":433},[427,475,438],{"class":437},[427,477,442],{"class":441},[427,479,445],{"class":433},[427,481,482],{"class":448},"\"Delete\"",[427,484,452],{"class":441},[427,486,445],{"class":433},[427,488,489],{"class":448},"\"danger\"",[427,491,460],{"class":441},[427,493,445],{"class":433},[427,495,496],{"class":448},"\"outline\"",[427,498,468],{"class":433},[427,500,502,504,506,508,510,513,515,517,520,522,524,527],{"class":429,"line":501},3,[427,503,434],{"class":433},[427,505,438],{"class":437},[427,507,442],{"class":441},[427,509,445],{"class":433},[427,511,512],{"class":448},"\"Done\"",[427,514,452],{"class":441},[427,516,445],{"class":433},[427,518,519],{"class":448},"\"success\"",[427,521,460],{"class":441},[427,523,445],{"class":433},[427,525,526],{"class":448},"\"tonal\"",[427,528,468],{"class":433},[415,530,531],{"v-slot:html":417},[419,532,536],{"className":533,"code":534,"language":535,"meta":417,"style":417},"language-html shiki shiki-themes github-light github-dark","\u003Cbutton class=\"ori-button ori-variant_fill ori-color_primary\">Save\u003C\u002Fbutton>\n\u003Cbutton class=\"ori-button ori-variant_outline ori-color_danger\">Delete\u003C\u002Fbutton>\n\u003Cbutton class=\"ori-button ori-variant_tonal ori-color_success\">Done\u003C\u002Fbutton>\n","html",[263,537,538,561,581],{"__ignoreMap":417},[427,539,540,542,545,548,550,553,556,558],{"class":429,"line":430},[427,541,434],{"class":433},[427,543,544],{"class":437},"button",[427,546,547],{"class":441}," class",[427,549,445],{"class":433},[427,551,552],{"class":448},"\"ori-button ori-variant_fill ori-color_primary\"",[427,554,555],{"class":433},">Save\u003C\u002F",[427,557,544],{"class":437},[427,559,560],{"class":433},">\n",[427,562,563,565,567,569,571,574,577,579],{"class":429,"line":471},[427,564,434],{"class":433},[427,566,544],{"class":437},[427,568,547],{"class":441},[427,570,445],{"class":433},[427,572,573],{"class":448},"\"ori-button ori-variant_outline ori-color_danger\"",[427,575,576],{"class":433},">Delete\u003C\u002F",[427,578,544],{"class":437},[427,580,560],{"class":433},[427,582,583,585,587,589,591,594,597,599],{"class":429,"line":501},[427,584,434],{"class":433},[427,586,544],{"class":437},[427,588,547],{"class":441},[427,590,445],{"class":433},[427,592,593],{"class":448},"\"ori-button ori-variant_tonal ori-color_success\"",[427,595,596],{"class":433},">Done\u003C\u002F",[427,598,544],{"class":437},[427,600,560],{"class":433},[246,602,603,604,606,607,610,611,614,615,618,619,622],{},"Why this is the recommended default: every role ships with a contrast-checked ",[263,605,378],{}," partner, and that\npairing is ",[258,608,609],{},"asserted, not hoped for"," — an automated guard (",[263,612,613],{},"tests\u002Ftokens.contrast.test.ts",") parses\nthe token CSS and fails the suite if any role \u002F ",[263,616,617],{},"on-role"," pair drops below ",[258,620,621],{},"WCAG AA (4.5:1)"," for\nbody text, across light and dark and every preset skin. Stay on the props and accessible contrast is\na build-time guarantee, and your palette keeps following every skin and mode switch for free.",[246,624,625,626,629,630,633,634,637,638,642,643,646],{},"The honest trade-off: the props only speak ",[258,627,628],{},"roles",". There is deliberately no ",[263,631,632],{},"text-color"," or\n",[263,635,636],{},"bg-color"," prop — when a component must be a color that isn't a role, that's the\n",[311,639,641],{"href":640},"#_4-the-escape-hatch-per-instance-color-variables","escape hatch"," below, and the ",[250,644,645],{},"why"," lives there too.",[321,648,650,651,654],{"id":649},"why-an-override-just-works-the-layer-cascade","Why an override just works — the ",[263,652,653],{},"@layer"," cascade",[246,656,657,658,660,661,664,665,668,669,672,673,675,676,679,680,319],{},"oriUI ships every token and utility inside ",[263,659,653],{},", in a fixed order — the canonical list lives on\n",[311,662,150],{"href":663},"\u002Fguides\u002Fdesign-tokens#the-cascade-layer-order",". The rule that makes customization\npainless: ",[258,666,667],{},"unlayered styles always beat layered ones",", regardless of specificity. Your own\n",[263,670,671],{},":root { … }"," — written in your app's stylesheet, outside any ",[263,674,653],{}," — wins over oriUI's\n",[263,677,678],{},"@layer ori.tokens"," declaration of the same token. You never fight specificity, and you never reach for\n",[263,681,682],{},"!important",[419,684,688],{"className":685,"code":686,"language":687,"meta":417,"style":417},"language-css shiki shiki-themes github-light github-dark","\u002F* oriUI ships this (inside @layer ori.tokens) *\u002F\n@layer ori.tokens {\n    :root {\n        --ori-color-primary-light: #0369a1; \u002F* the default azure *\u002F\n    }\n}\n\n\u002F* You write this in your own stylesheet — UNLAYERED, so it wins *\u002F\n:root {\n    --ori-color-primary-light: #16a34a; \u002F* your green *\u002F\n}\n","css",[263,689,690,696,704,712,732,738,744,751,757,765,781],{"__ignoreMap":417},[427,691,692],{"class":429,"line":430},[427,693,695],{"class":694},"sJ8bj","\u002F* oriUI ships this (inside @layer ori.tokens) *\u002F\n",[427,697,698,701],{"class":429,"line":471},[427,699,653],{"class":700},"szBVR",[427,702,703],{"class":433}," ori.tokens {\n",[427,705,706,709],{"class":429,"line":501},[427,707,708],{"class":441},"    :root",[427,710,711],{"class":433}," {\n",[427,713,715,719,722,726,729],{"class":429,"line":714},4,[427,716,718],{"class":717},"s4XuR","        --ori-color-primary-light",[427,720,721],{"class":433},": ",[427,723,725],{"class":724},"sj4cs","#0369a1",[427,727,728],{"class":433},"; ",[427,730,731],{"class":694},"\u002F* the default azure *\u002F\n",[427,733,735],{"class":429,"line":734},5,[427,736,737],{"class":433},"    }\n",[427,739,741],{"class":429,"line":740},6,[427,742,743],{"class":433},"}\n",[427,745,747],{"class":429,"line":746},7,[427,748,750],{"emptyLinePlaceholder":749},true,"\n",[427,752,754],{"class":429,"line":753},8,[427,755,756],{"class":694},"\u002F* You write this in your own stylesheet — UNLAYERED, so it wins *\u002F\n",[427,758,760,763],{"class":429,"line":759},9,[427,761,762],{"class":441},":root",[427,764,711],{"class":433},[427,766,768,771,773,776,778],{"class":429,"line":767},10,[427,769,770],{"class":717},"    --ori-color-primary-light",[427,772,721],{"class":433},[427,774,775],{"class":724},"#16a34a",[427,777,728],{"class":433},[427,779,780],{"class":694},"\u002F* your green *\u002F\n",[427,782,784],{"class":429,"line":783},11,[427,785,743],{"class":433},[246,787,788,789,791,792,795,796,799,800,803],{},"Both are ",[263,790,762],{}," (specificity ",[263,793,794],{},"0,1,0",") — a tie on specificity. The unlayered rule wins purely because it\nsits outside the layers. Every button, switch, and focus ring that resolves ",[263,797,798],{},"--ori-color-primary"," now\nreads your green. ",[258,801,802],{},"That is the whole mechanism."," Override the source token, and the light\u002Fdark\nmachinery and the per-component aliases resolve on top of your value automatically.",[805,806,807],"blockquote",{},[246,808,809,810,813,814,383,817,330,820,823,824,827,828,830,831,833,834,836,837,840],{},"For a ",[258,811,812],{},"global"," brand color, override the ",[263,815,816],{},"*-light",[263,818,819],{},"*-dark",[258,821,822],{},"source"," tokens (e.g.\n",[263,825,826],{},"--ori-color-primary-light",") in ",[263,829,762],{}," — not the resolved alias ",[263,832,798],{},", which the mode\nselectors repoint per mode (overwrite it at ",[263,835,762],{}," and you flatten dark mode). For a ",[258,838,839],{},"single element\nor a region",", it is the reverse — you target the resolved alias (sections 4 and 5).",[321,842,844],{"id":843},"_2-rebrand-globally-override-the-token-sources","2 · Rebrand globally — override the token sources",[246,846,847,848,850,851,853],{},"Drop a ",[263,849,762],{}," block anywhere in your app's CSS (after importing oriUI). A color role is two source\ntokens per mode — the color and its contrast-checked ",[263,852,378],{}," text color. Set both light and dark so the\nbrand holds in either mode:",[419,855,857],{"className":685,"code":856,"language":687,"meta":417,"style":417},":root {\n    \u002F* light mode *\u002F\n    --ori-color-primary-light: #16a34a;\n    --ori-color-on-primary-light: #ffffff;\n    \u002F* dark mode *\u002F\n    --ori-color-primary-dark: #4ade80;\n    --ori-color-on-primary-dark: #052e16;\n}\n",[263,858,859,865,870,881,893,898,910,922],{"__ignoreMap":417},[427,860,861,863],{"class":429,"line":430},[427,862,762],{"class":441},[427,864,711],{"class":433},[427,866,867],{"class":429,"line":471},[427,868,869],{"class":694},"    \u002F* light mode *\u002F\n",[427,871,872,874,876,878],{"class":429,"line":501},[427,873,770],{"class":717},[427,875,721],{"class":433},[427,877,775],{"class":724},[427,879,880],{"class":433},";\n",[427,882,883,886,888,891],{"class":429,"line":714},[427,884,885],{"class":717},"    --ori-color-on-primary-light",[427,887,721],{"class":433},[427,889,890],{"class":724},"#ffffff",[427,892,880],{"class":433},[427,894,895],{"class":429,"line":734},[427,896,897],{"class":694},"    \u002F* dark mode *\u002F\n",[427,899,900,903,905,908],{"class":429,"line":740},[427,901,902],{"class":717},"    --ori-color-primary-dark",[427,904,721],{"class":433},[427,906,907],{"class":724},"#4ade80",[427,909,880],{"class":433},[427,911,912,915,917,920],{"class":429,"line":746},[427,913,914],{"class":717},"    --ori-color-on-primary-dark",[427,916,721],{"class":433},[427,918,919],{"class":724},"#052e16",[427,921,880],{"class":433},[427,923,924],{"class":429,"line":753},[427,925,743],{"class":433},[246,927,928,929,931,932,935,936,939],{},"The ",[263,930,378],{}," token is the label\u002Ficon color that sits ",[250,933,934],{},"on"," the filled color — keep the pair at WCAG AA\n(≥ 4.5:1) yourself, the way the built-in skins do. The contrast test guards the palette the library\n",[250,937,938],{},"ships","; your own sources are your responsibility, and both modes need their own check because dark\ninverts the pairing.",[246,941,942,943,945,946,951,952,955,956,962,963,965,966,968,969,973],{},"This works because the active alias ",[263,944,798],{}," is declared ",[258,947,948,949],{},"and resolved at ",[263,950,762],{}," — it\nreads ",[263,953,954],{},"var(--ori-color-primary-light)"," there (see\n",[311,957,959],{"href":958},"\u002Fguides\u002Fdesign-tokens#colour-three-tiers",[263,960,961],{},"_themes-color-tokens.css","). Override the source at ",[263,964,762],{},"\nand the alias re-resolves, inheriting your value into every component. Overriding all four skinnable\nroles (plus their ",[263,967,378],{}," pairs, per mode) is the same move at scale — at that point consider\n",[311,970,972],{"href":971},"\u002Fguides\u002Ftheming#authoring-a-custom-skin","authoring a named skin"," instead.",[975,976,978],"h3",{"id":977},"text-tone-override-only-to-fine-tune","Text tone — override only to fine-tune",[246,980,981,982,985,986,989,990,993],{},"A role's hue above is engineered as a ",[258,983,984],{},"fill background"," — a component paints it as text (the\nnon-fill button variants, the selected tab, alert, tag) through a separate, dedicated token,\n",[263,987,988],{},"--ori-color-\u003Crole>-text",", so that a light or saturated role never has to double as body text. It\nalready derives an AA-safe tone automatically — a ",[258,991,992],{},"relative color"," that keeps the role's hue and\nchroma and clamps only its lightness, so the text reads as the same colour as the fill, just darker\n(light theme) or lighter (dark theme):",[419,995,997],{"className":685,"code":996,"language":687,"meta":417,"style":417},"\u002F* :root — the light default *\u002F\n--ori-color-primary-text: oklch(from var(--ori-color-primary) min(l, 0.42) c h);\n\n\u002F* .ori-theme_dark \u002F :root.dark — re-declared with the opposite clamp *\u002F\n--ori-color-primary-text: oklch(from var(--ori-color-primary) max(l, 0.86) c h);\n",[263,998,999,1004,1015,1019,1024],{"__ignoreMap":417},[427,1000,1001],{"class":429,"line":430},[427,1002,1003],{"class":694},"\u002F* :root — the light default *\u002F\n",[427,1005,1006,1009,1012],{"class":429,"line":471},[427,1007,1008],{"class":433},"--ori-color-primary-text: oklch(from var(--ori-color-primary) min(l, 0",[427,1010,1011],{"class":441},".42",[427,1013,1014],{"class":433},") c h);\n",[427,1016,1017],{"class":429,"line":501},[427,1018,750],{"emptyLinePlaceholder":749},[427,1020,1021],{"class":429,"line":714},[427,1022,1023],{"class":694},"\u002F* .ori-theme_dark \u002F :root.dark — re-declared with the opposite clamp *\u002F\n",[427,1025,1026,1029,1032],{"class":429,"line":734},[427,1027,1028],{"class":433},"--ori-color-primary-text: oklch(from var(--ori-color-primary) max(l, 0",[427,1030,1031],{"class":441},".86",[427,1033,1014],{"class":433},[246,1035,1036,1037,1040,1041,1044,1045,1048,1049,1051,1052,1055,1056,1059],{},"Because each theme declares its own clamp — light caps lightness at 0.42, dark floors it at 0.86 —\nthe tone tracks the ",[258,1038,1039],{},"active theme"," automatically. And because both formulas read\n",[263,1042,1043],{},"var(--ori-color-primary)",", the tone also tracks any ",[258,1046,1047],{},"skin","'s role override, or your own — rebrand\n",[263,1050,337],{}," above, or ",[311,1053,1054],{"href":971},"author a whole custom skin",", and its\nnon-fill text tone is AA-safe ",[258,1057,1058],{},"for free",". Override the derived value only to fine-tune the exact\nhue:",[1061,1062,1063,1084,1096],"ul",{},[1064,1065,1066,1069,1070,1073,1074,1076,1077,383,1080,1083],"li",{},[258,1067,1068],{},"Global",", every mode and skin: ",[263,1071,1072],{},":root { --ori-color-warn-text: #b45309 }",". A flat override value\nis theme-agnostic — unlike oriUI's own formula above, it needs no light\u002Fdark split — so your\nunlayered ",[263,1075,762],{}," rule beats both oriUI's light default and its dark re-declaration, and one\ndeclaration covers both modes. Nest it inside ",[263,1078,1079],{},".ori-theme_dark",[263,1081,1082],{},":root.dark"," too if you want a\ndifferent dark-mode value.",[1064,1085,1086,721,1089,1092,1093,319],{},[258,1087,1088],{},"Per skin",[263,1090,1091],{},"[data-ori-skin='brand'] { --ori-color-primary-text: … }"," — the same selector shape as\n",[311,1094,1095],{"href":971},"authoring a skin",[1064,1097,1098,1101,1102,1105,1106,383,1109,1112],{},[258,1099,1100],{},"Per instance or subtree",": repoint the resolved alias, ",[263,1103,1104],{},"--ori-color-text",", on a wrapper — the same\nescape hatch as ",[263,1107,1108],{},"--ori-color",[263,1110,1111],{},"--ori-color-on"," (section 4 below).",[246,1114,1115,1116,1119,1120,1122,1123,1125,1126,1128,1129,1131,1132],{},"This replaces the old workaround of targeting a component's fill token directly (e.g.\n",[263,1117,1118],{},".ori-button { --ori-color: … }",") to patch up text contrast — that also repaints the ",[263,1121,374],{}," variant's\nbackground, since ",[263,1124,1108],{}," feeds both. ",[263,1127,1104],{}," is the sanctioned point: it only ever\nfeeds the non-fill \u002F selected-text axis — and now the ",[263,1130,386],{}," variant's border too, so the ring and\nthe label match. ",[250,1133,1134,1135,1138],{},"(Full per-role token reference:\n",[311,1136,150],{"href":1137},"\u002Fguides\u002Fdesign-tokens#text-the-on-surface-foreground",".)",[975,1140,1142],{"id":1141},"radius-and-font-size-the-same-pattern","Radius and font-size — the same pattern",[246,1144,1145,1146,1148,1149,293,1152,1155,1156,1159,1160,383,1163,383,1166,390,1169,1172,1173,1176,1177,1180,1181,330,1184,1187,1188,1191,1192,1195],{},"The size scales live at ",[263,1147,762],{}," too (",[263,1150,1151],{},"--ori-size-radius_*",[263,1153,1154],{},"--ori-font-size_*","), so the same\nunlayered block rebrands them. ",[263,1157,1158],{},"--ori-size-radius_md"," anchors the whole scale — ",[263,1161,1162],{},"xs",[263,1164,1165],{},"sm",[263,1167,1168],{},"lg",[263,1170,1171],{},"xl"," are ",[263,1174,1175],{},"calc()","-derived from it, so one override moves every derived step proportionally (",[263,1178,1179],{},"zero","\nand the ",[263,1182,1183],{},"9999px",[263,1185,1186],{},"rounded"," pill stay fixed). The font ladder pivots on ",[263,1189,1190],{},"--ori-font-size_md"," the same\nway, in fixed ±",[263,1193,1194],{},"0.125rem"," (2px at the browser default) steps:",[419,1197,1199],{"className":685,"code":1198,"language":687,"meta":417,"style":417},":root {\n    --ori-size-radius_md: 4px; \u002F* sm\u002Flg\u002Fxl re-derive — cards (lg) tighten along *\u002F\n    --ori-font-size_md: 15px; \u002F* the control ladder shifts around the new md *\u002F\n}\n",[263,1200,1201,1207,1225,1242],{"__ignoreMap":417},[427,1202,1203,1205],{"class":429,"line":430},[427,1204,762],{"class":441},[427,1206,711],{"class":433},[427,1208,1209,1212,1214,1217,1220,1222],{"class":429,"line":471},[427,1210,1211],{"class":717},"    --ori-size-radius_md",[427,1213,721],{"class":433},[427,1215,1216],{"class":724},"4",[427,1218,1219],{"class":700},"px",[427,1221,728],{"class":433},[427,1223,1224],{"class":694},"\u002F* sm\u002Flg\u002Fxl re-derive — cards (lg) tighten along *\u002F\n",[427,1226,1227,1230,1232,1235,1237,1239],{"class":429,"line":501},[427,1228,1229],{"class":717},"    --ori-font-size_md",[427,1231,721],{"class":433},[427,1233,1234],{"class":724},"15",[427,1236,1219],{"class":700},[427,1238,728],{"class":433},[427,1240,1241],{"class":694},"\u002F* the control ladder shifts around the new md *\u002F\n",[427,1243,1244],{"class":429,"line":714},[427,1245,743],{"class":433},[805,1247,1248],{},[246,1249,1250,1251,1254,1255,1257,1258,1260,1261,1264,1265,1268,1269,1272],{},"A repoint only moves components that resolve a ",[258,1252,1253],{},"derived"," step. Several controls pin a fixed step\non purpose — buttons, badges, tags, and avatars default to ",[263,1256,1186],{}," (the ",[263,1259,1183],{}," pill) — so an\n",[263,1262,1263],{},"_md"," repoint doesn't square a default button. Bring such a control onto your house radius per\ninstance: the ",[263,1266,1267],{},"radius=\"md\""," prop \u002F ",[263,1270,1271],{},"ori-size-radius_md"," class.",[321,1274,1276],{"id":1275},"_3-style-one-instance","3 · Style one instance",[246,1278,1279,1280,1283,1284,1287],{},"When you want to change ",[250,1281,1282],{},"one"," component, not the whole library, reach for the utility classes (CSS) or\nthe matching props (Vue) — no token override needed. Every utility is ",[258,1285,1286],{},"single-class",": one class\nrepoints one token, no paired base class.",[1289,1290,1291,1307],"table",{},[1292,1293,1294],"thead",{},[1295,1296,1297,1301,1304],"tr",{},[1298,1299,1300],"th",{},"Axis",[1298,1302,1303],{},"Utility class",[1298,1305,1306],{},"Vue prop",[1308,1309,1310,1325,1339,1359],"tbody",{},[1295,1311,1312,1316,1321],{},[1313,1314,1315],"td",{},"Color",[1313,1317,1318],{},[263,1319,1320],{},"ori-color_*",[1313,1322,1323],{},[263,1324,276],{},[1295,1326,1327,1330,1335],{},[1313,1328,1329],{},"Variant",[1313,1331,1332],{},[263,1333,1334],{},"ori-variant_*",[1313,1336,1337],{},[263,1338,363],{},[1295,1340,1341,1344,1354],{},[1313,1342,1343],{},"Size",[1313,1345,1346,1349,1350,1353],{},[263,1347,1348],{},"ori-\u003Cname>_*"," sugar (or ",[263,1351,1352],{},"ori-size-action_*",")",[1313,1355,1356],{},[263,1357,1358],{},"size",[1295,1360,1361,1364,1369],{},[1313,1362,1363],{},"Radius",[1313,1365,1366],{},[263,1367,1368],{},"ori-size-radius_*",[1313,1370,1371],{},[263,1372,1373],{},"radius",[246,1375,1376,1377,1379],{},"This table is a quick orientation map; the full per-component class reference lives on each component\npage — see ",[311,1378,22],{"href":21}," for the canonical list.",[402,1381,1382,1385,1388,1391,1394,1513],{},[405,1383],{"text":1384,"variant":374,"color":337},"Brand",[405,1386],{"text":1387,"variant":382,"color":356},"Danger",[405,1389],{"text":1390,"variant":386,"radius":1165},"Squared",[405,1392],{"text":1393,"variant":374,"size":1168},"Large",[415,1395,1396],{"v-slot:vue":417},[419,1397,1399],{"className":421,"code":1398,"language":423,"meta":417,"style":417},"\u003COriButton text=\"Brand\" color=\"primary\" variant=\"fill\" \u002F>\n\u003COriButton text=\"Danger\" color=\"danger\" variant=\"tonal\" \u002F>\n\u003COriButton text=\"Squared\" radius=\"sm\" variant=\"outline\" \u002F>\n\u003COriButton text=\"Large\" size=\"lg\" variant=\"fill\" \u002F>\n",[263,1400,1401,1428,1455,1484],{"__ignoreMap":417},[427,1402,1403,1405,1407,1409,1411,1414,1416,1418,1420,1422,1424,1426],{"class":429,"line":430},[427,1404,434],{"class":433},[427,1406,438],{"class":437},[427,1408,442],{"class":441},[427,1410,445],{"class":433},[427,1412,1413],{"class":448},"\"Brand\"",[427,1415,452],{"class":441},[427,1417,445],{"class":433},[427,1419,457],{"class":448},[427,1421,460],{"class":441},[427,1423,445],{"class":433},[427,1425,465],{"class":448},[427,1427,468],{"class":433},[427,1429,1430,1432,1434,1436,1438,1441,1443,1445,1447,1449,1451,1453],{"class":429,"line":471},[427,1431,434],{"class":433},[427,1433,438],{"class":437},[427,1435,442],{"class":441},[427,1437,445],{"class":433},[427,1439,1440],{"class":448},"\"Danger\"",[427,1442,452],{"class":441},[427,1444,445],{"class":433},[427,1446,489],{"class":448},[427,1448,460],{"class":441},[427,1450,445],{"class":433},[427,1452,526],{"class":448},[427,1454,468],{"class":433},[427,1456,1457,1459,1461,1463,1465,1468,1471,1473,1476,1478,1480,1482],{"class":429,"line":501},[427,1458,434],{"class":433},[427,1460,438],{"class":437},[427,1462,442],{"class":441},[427,1464,445],{"class":433},[427,1466,1467],{"class":448},"\"Squared\"",[427,1469,1470],{"class":441}," radius",[427,1472,445],{"class":433},[427,1474,1475],{"class":448},"\"sm\"",[427,1477,460],{"class":441},[427,1479,445],{"class":433},[427,1481,496],{"class":448},[427,1483,468],{"class":433},[427,1485,1486,1488,1490,1492,1494,1497,1500,1502,1505,1507,1509,1511],{"class":429,"line":714},[427,1487,434],{"class":433},[427,1489,438],{"class":437},[427,1491,442],{"class":441},[427,1493,445],{"class":433},[427,1495,1496],{"class":448},"\"Large\"",[427,1498,1499],{"class":441}," size",[427,1501,445],{"class":433},[427,1503,1504],{"class":448},"\"lg\"",[427,1506,460],{"class":441},[427,1508,445],{"class":433},[427,1510,465],{"class":448},[427,1512,468],{"class":433},[415,1514,1515],{"v-slot:html":417},[419,1516,1518],{"className":533,"code":1517,"language":535,"meta":417,"style":417},"\u003Cbutton class=\"ori-button ori-variant_fill ori-color_primary\">Brand\u003C\u002Fbutton>\n\u003Cbutton class=\"ori-button ori-variant_tonal ori-color_danger\">Danger\u003C\u002Fbutton>\n\u003Cbutton class=\"ori-button ori-size-radius_sm ori-variant_outline\">Squared\u003C\u002Fbutton>\n\u003Cbutton class=\"ori-button ori-button_lg ori-variant_fill\">Large\u003C\u002Fbutton>\n",[263,1519,1520,1539,1559,1579],{"__ignoreMap":417},[427,1521,1522,1524,1526,1528,1530,1532,1535,1537],{"class":429,"line":430},[427,1523,434],{"class":433},[427,1525,544],{"class":437},[427,1527,547],{"class":441},[427,1529,445],{"class":433},[427,1531,552],{"class":448},[427,1533,1534],{"class":433},">Brand\u003C\u002F",[427,1536,544],{"class":437},[427,1538,560],{"class":433},[427,1540,1541,1543,1545,1547,1549,1552,1555,1557],{"class":429,"line":471},[427,1542,434],{"class":433},[427,1544,544],{"class":437},[427,1546,547],{"class":441},[427,1548,445],{"class":433},[427,1550,1551],{"class":448},"\"ori-button ori-variant_tonal ori-color_danger\"",[427,1553,1554],{"class":433},">Danger\u003C\u002F",[427,1556,544],{"class":437},[427,1558,560],{"class":433},[427,1560,1561,1563,1565,1567,1569,1572,1575,1577],{"class":429,"line":501},[427,1562,434],{"class":433},[427,1564,544],{"class":437},[427,1566,547],{"class":441},[427,1568,445],{"class":433},[427,1570,1571],{"class":448},"\"ori-button ori-size-radius_sm ori-variant_outline\"",[427,1573,1574],{"class":433},">Squared\u003C\u002F",[427,1576,544],{"class":437},[427,1578,560],{"class":433},[427,1580,1581,1583,1585,1587,1589,1592,1595,1597],{"class":429,"line":714},[427,1582,434],{"class":433},[427,1584,544],{"class":437},[427,1586,547],{"class":441},[427,1588,445],{"class":433},[427,1590,1591],{"class":448},"\"ori-button ori-button_lg ori-variant_fill\"",[427,1593,1594],{"class":433},">Large\u003C\u002F",[427,1596,544],{"class":437},[427,1598,560],{"class":433},[321,1600,1602],{"id":1601},"_4-the-escape-hatch-per-instance-color-variables","4 · The escape hatch — per-instance color variables",[246,1604,1605,1606,1609,1610,1612,1613,1615],{},"When the color you need isn't one of the eight roles — a data-series swatch, a partner logo tint, one\nmarketing CTA — repoint the ",[258,1607,1608],{},"resolved alias pair"," on the element itself. ",[263,1611,1108],{}," (the accent)\nand ",[263,1614,1111],{}," (its legible partner) are what every variant actually reads:",[419,1617,1619],{"className":421,"code":1618,"language":423,"meta":417,"style":417},"\u003COriButton text=\"One teal button\" style=\"--ori-color: teal; --ori-color-on: white\" \u002F>\n",[263,1620,1621],{"__ignoreMap":417},[427,1622,1623,1625,1627,1629,1631,1634,1637,1639,1642,1644,1646,1649,1651,1653,1655,1658,1660],{"class":429,"line":430},[427,1624,434],{"class":433},[427,1626,438],{"class":437},[427,1628,442],{"class":441},[427,1630,445],{"class":433},[427,1632,1633],{"class":448},"\"One teal button\"",[427,1635,1636],{"class":441}," style",[427,1638,445],{"class":433},[427,1640,1641],{"class":448},"\"",[427,1643,1108],{"class":717},[427,1645,721],{"class":433},[427,1647,1648],{"class":724},"teal",[427,1650,728],{"class":433},[427,1652,1111],{"class":717},[427,1654,721],{"class":433},[427,1656,1657],{"class":724},"white",[427,1659,1641],{"class":448},[427,1661,468],{"class":433},[419,1663,1665],{"className":533,"code":1664,"language":535,"meta":417,"style":417},"\u003Cbutton class=\"ori-button ori-variant_fill\" style=\"--ori-color: teal; --ori-color-on: white\">One teal button\u003C\u002Fbutton>\n",[263,1666,1667],{"__ignoreMap":417},[427,1668,1669,1671,1673,1675,1677,1680,1682,1684,1687,1690,1692],{"class":429,"line":430},[427,1670,434],{"class":433},[427,1672,544],{"class":437},[427,1674,547],{"class":441},[427,1676,445],{"class":433},[427,1678,1679],{"class":448},"\"ori-button ori-variant_fill\"",[427,1681,1636],{"class":441},[427,1683,445],{"class":433},[427,1685,1686],{"class":448},"\"--ori-color: teal; --ori-color-on: white\"",[427,1688,1689],{"class":433},">One teal button\u003C\u002F",[427,1691,544],{"class":437},[427,1693,560],{"class":433},[246,1695,1696,1697,1700],{},"Because you repoint the alias the variants are built on, ",[258,1698,1699],{},"all the machinery keeps working",":",[1061,1702,1703,1723,1737,1744],{},[1064,1704,1705,1706,1708,1709,1711,1712,1714,1715,728,1717,1719,1720,1722],{},"every variant maps your accent correctly — ",[263,1707,374],{}," paints it as the background with ",[263,1710,1111],{},"\ntext; ",[263,1713,382],{},"'s tint derives from ",[263,1716,1108],{},[263,1718,386],{},"'s border reads ",[263,1721,1104],{},", the\nsame tone as its label;",[1064,1724,1725,1726,330,1729,1732,1733,1736],{},"hover and active states stay right, because they are ",[263,1727,1728],{},"color-mix()",[258,1730,1731],{},"derivations of the alias","\n(a filled button hovers to ",[263,1734,1735],{},"color-mix(in srgb, var(--ori-color), white 15%)",") — there is no second\n\"hover color\" to supply;",[1064,1738,1739,1740,1743],{},"the focus ring (",[263,1741,1742],{},"outline: 2px solid var(--ori-color)",") follows;",[1064,1745,1746,1747,293,1750,293,1753,1756],{},"state styling is untouched — it keys off real attributes (",[263,1748,1749],{},"disabled",[263,1751,1752],{},"aria-busy",[263,1754,1755],{},"data-active","),\nnever off the palette.",[246,1758,1759,1762,1763,383,1765,383,1767,383,1769,1771,1772,1775,1776,1778,1779,1781,1782,1785,1786,1788,1789,1792,1793,1795,1796,1799,1800,383,1802,1804],{},[258,1760,1761],{},"On a non-fill variant"," (",[263,1764,382],{},[263,1766,386],{},[263,1768,389],{},[263,1770,393],{},"), the label reads a ",[250,1773,1774],{},"third"," alias,\n",[263,1777,1104],{}," — not ",[263,1780,1108],{}," directly (see\n",[311,1783,1784],{"href":1137},"Text — the on-surface foreground","). CSS custom\nproperties don't re-substitute on inheritance: setting only ",[263,1787,1108],{}," here does ",[258,1790,1791],{},"not"," also\nrecompute ",[263,1794,1104],{}," for you, because nothing on this element redeclares it. Set it alongside\nthe pair when you need a non-fill variant on a one-off color, mirroring the derived formula (the light\nclamp shown here; nest a ",[263,1797,1798],{},"max(l, 0.86)"," version under ",[263,1801,1079],{},[263,1803,1082],{}," for a\ndark-safe one-off too):",[419,1806,1808],{"className":421,"code":1807,"language":423,"meta":417,"style":417},"\u003COriButton\n    text=\"One teal button\"\n    variant=\"tonal\"\n    style=\"--ori-color: teal; --ori-color-on: white; --ori-color-text: oklch(from teal min(l, 0.42) c h)\"\n\u002F>\n",[263,1809,1810,1817,1827,1837,1894],{"__ignoreMap":417},[427,1811,1812,1814],{"class":429,"line":430},[427,1813,434],{"class":433},[427,1815,1816],{"class":437},"OriButton\n",[427,1818,1819,1822,1824],{"class":429,"line":471},[427,1820,1821],{"class":441},"    text",[427,1823,445],{"class":433},[427,1825,1826],{"class":448},"\"One teal button\"\n",[427,1828,1829,1832,1834],{"class":429,"line":501},[427,1830,1831],{"class":441},"    variant",[427,1833,445],{"class":433},[427,1835,1836],{"class":448},"\"tonal\"\n",[427,1838,1839,1842,1844,1846,1848,1850,1852,1854,1856,1858,1860,1862,1864,1866,1869,1872,1874,1877,1880,1883,1885,1888,1891],{"class":429,"line":714},[427,1840,1841],{"class":441},"    style",[427,1843,445],{"class":433},[427,1845,1641],{"class":448},[427,1847,1108],{"class":717},[427,1849,721],{"class":433},[427,1851,1648],{"class":724},[427,1853,728],{"class":433},[427,1855,1111],{"class":717},[427,1857,721],{"class":433},[427,1859,1657],{"class":724},[427,1861,728],{"class":433},[427,1863,1104],{"class":717},[427,1865,721],{"class":433},[427,1867,1868],{"class":724},"oklch",[427,1870,1871],{"class":433},"(from ",[427,1873,1648],{"class":724},[427,1875,1876],{"class":724}," min",[427,1878,1879],{"class":433},"(",[427,1881,1882],{"class":717},"l",[427,1884,293],{"class":433},[427,1886,1887],{"class":724},"0.42",[427,1889,1890],{"class":433},") c h)",[427,1892,1893],{"class":448},"\"\n",[427,1895,1896],{"class":429,"line":734},[427,1897,1898],{"class":433},"\u002F>\n",[246,1900,1901,1902,1905,1906,1909],{},"(The ",[263,1903,1904],{},".ori-color_*"," utility classes handle this for you — they set all three aliases together, which\nis why they're the recommended path over the escape hatch whenever the color ",[250,1907,1908],{},"is"," one of the eight\nroles.)",[246,1911,1912,1913,1915,1916,383,1918,1920,1921,293,1924,1927,1928,1934],{},"This channel is ",[250,1914,645],{}," there are no ",[263,1917,632],{},[263,1919,636],{}," props. A prop pair like that would bypass\nthe variant mapping and re-introduce the manual \"pick a background AND a matching text\" pairing the\nroles abstract away — silently stepping around the AA-asserted pairing from level 1 — and it wouldn't\nstop at two props (",[263,1922,1923],{},"border-color",[263,1925,1926],{},"hover-color",", …). The variable pair is strictly more powerful: one\ndeclaration, every variant, every derived state\n(",[311,1929,1933],{"href":1930,"rel":1931},"https:\u002F\u002Fgithub.com\u002Fmarkgrushevski\u002Foriui\u002Fblob\u002Fmain\u002FDECISIONS.md",[1932],"nofollow","the recorded decision",").",[246,1936,1937,1938,1941,1942,1944,1945,1947,1948,1950,1951,1953,1954,1956,1957,1959],{},"The honest trade-off: ",[258,1939,1940],{},"contrast responsibility shifts to you."," The contrast test asserts the shipped\nrole pairs, not your inline values — always set ",[263,1943,1111],{}," together with ",[263,1946,1108],{},", and pick\na pair that clears 4.5:1 (",[263,1949,1657],{}," on ",[263,1952,1648],{}," above is ~4.8:1). One more sharp edge: don't set\n",[263,1955,826],{}," on the element here — nothing on the element reads it. That source token\nonly re-resolves into the alias up at ",[263,1958,762],{}," (section 2); set directly on the element it is inert.",[321,1961,1963],{"id":1962},"_5-scope-an-override-to-a-subtree","5 · Scope an override to a subtree",[246,1965,1966,1967,1970,1971,1974,1975,319],{},"To restyle a ",[250,1968,1969],{},"region"," — a marketing section, a settings panel, an embedded widget — set inherited tokens\n(or a mode class) on a wrapper. Everything inside inherits; everything outside is untouched. The rule\nfor ",[250,1972,1973],{},"which"," token to set: a wrapper can only feed tokens its descendants ",[258,1976,1977],{},"substitute locally",[246,1979,1980,1983,1984,1987,1988,1990,1991,1994],{},[258,1981,1982],{},"Color:"," components bind the pair per element (",[263,1985,1986],{},".ori-color_primary"," reads\n",[263,1989,1043],{}," right on the component), so repoint the ",[258,1992,1993],{},"resolved role alias"," on the\nwrapper and every descendant that resolves primary picks it up:",[419,1996,1998],{"className":533,"code":1997,"language":535,"meta":417,"style":417},"\u003Csection\n    class=\"promo\"\n    style=\"--ori-color-primary: #16a34a; --ori-color-on-primary: #ffffff; --ori-color-primary-text: oklch(from #16a34a min(l, 0.42) c h)\"\n>\n    \u003C!-- buttons \u002F cards in here render with the green primary; the rest of the page does not -->\n\u003C\u002Fsection>\n",[263,1999,2000,2007,2017,2026,2030,2035],{"__ignoreMap":417},[427,2001,2002,2004],{"class":429,"line":430},[427,2003,434],{"class":433},[427,2005,2006],{"class":437},"section\n",[427,2008,2009,2012,2014],{"class":429,"line":471},[427,2010,2011],{"class":441},"    class",[427,2013,445],{"class":433},[427,2015,2016],{"class":448},"\"promo\"\n",[427,2018,2019,2021,2023],{"class":429,"line":501},[427,2020,1841],{"class":441},[427,2022,445],{"class":433},[427,2024,2025],{"class":448},"\"--ori-color-primary: #16a34a; --ori-color-on-primary: #ffffff; --ori-color-primary-text: oklch(from #16a34a min(l, 0.42) c h)\"\n",[427,2027,2028],{"class":429,"line":714},[427,2029,560],{"class":433},[427,2031,2032],{"class":429,"line":734},[427,2033,2034],{"class":694},"    \u003C!-- buttons \u002F cards in here render with the green primary; the rest of the page does not -->\n",[427,2036,2037,2040,2043],{"class":429,"line":740},[427,2038,2039],{"class":433},"\u003C\u002F",[427,2041,2042],{"class":437},"section",[427,2044,560],{"class":433},[246,2046,2047,2048,2050,2051,2053,2054,2057,2058,2061,2062,2065,2066,2068],{},"Repoint ",[263,2049,988],{}," alongside the pair, as above — CSS custom properties don't\nre-substitute on inheritance, so a descendant's ",[263,2052,1986],{}," (which reads\n",[263,2055,2056],{},"var(--ori-color-primary-text)"," for its non-fill\u002Fselected text) keeps the ",[258,2059,2060],{},"page's"," primary text tone\nunless the wrapper also overrides ",[263,2063,2064],{},"-text"," itself; the fill background\u002Fon-color, by contrast, follows\nthe wrapper fine because the descendant reads ",[263,2067,798],{}," directly.",[246,2070,2071,2072,383,2074,330,2076,2078,2079,2081,2082,2085,2086,390,2089,2091,2092,383,2094,2096],{},"Repointing a ",[263,2073,816],{},[263,2075,819],{},[258,2077,822],{}," token on the wrapper does nothing — the alias was already\nresolved up at ",[263,2080,762],{},", so the wrapper's source value is never read. Setting the alias directly pins it\nfor the region in ",[258,2083,2084],{},"both"," modes; to keep a region mode-aware, wrap it in ",[263,2087,2088],{},".ori-theme_light",[263,2090,1079],{}," and repoint the ",[263,2093,816],{},[263,2095,819],{}," source there — that re-resolves the alias on the\nwrapper, per mode.",[246,2098,2099,2102,2103,2106,2107,2110,2111,2114],{},[258,2100,2101],{},"Radius and font-size"," scope the other way around: their alias is substituted ",[258,2104,2105],{},"on each component","\nfrom the raw step (a card reads ",[263,2108,2109],{},"var(--ori-size-radius_lg)"," on itself), so on a wrapper you repoint\nthe ",[258,2112,2113],{},"raw step",", not the alias:",[419,2116,2118],{"className":533,"code":2117,"language":535,"meta":417,"style":417},"\u003Cdiv style=\"--ori-size-radius_md: 4px; --ori-font-size_md: 15px\">\n    \u003C!-- panels, menus, inputs in here tighten; buttons keep their pinned `rounded` step -->\n\u003C\u002Fdiv>\n",[263,2119,2120,2136,2141],{"__ignoreMap":417},[427,2121,2122,2124,2127,2129,2131,2134],{"class":429,"line":430},[427,2123,434],{"class":433},[427,2125,2126],{"class":437},"div",[427,2128,1636],{"class":441},[427,2130,445],{"class":433},[427,2132,2133],{"class":448},"\"--ori-size-radius_md: 4px; --ori-font-size_md: 15px\"",[427,2135,560],{"class":433},[427,2137,2138],{"class":429,"line":471},[427,2139,2140],{"class":694},"    \u003C!-- panels, menus, inputs in here tighten; buttons keep their pinned `rounded` step -->\n",[427,2142,2143,2145,2147],{"class":429,"line":501},[427,2144,2039],{"class":433},[427,2146,2126],{"class":437},[427,2148,560],{"class":433},[246,2150,2151,2152,2155,2156,383,2158,2160,2161,2164],{},"Or scope ",[258,2153,2154],{},"mode"," to a subtree with ",[263,2157,2088],{},[263,2159,1079],{}," — the same selectors the global\n",[263,2162,2163],{},"html.dark"," toggle uses, but on any element:",[419,2166,2168],{"className":533,"code":2167,"language":535,"meta":417,"style":417},"\u003C!-- a dark callout inside an otherwise-light page -->\n\u003Caside class=\"ori-theme_dark\">\n    \u003C!-- surface, primary, shadows all resolve to their dark values here -->\n\u003C\u002Faside>\n",[263,2169,2170,2175,2191,2196],{"__ignoreMap":417},[427,2171,2172],{"class":429,"line":430},[427,2173,2174],{"class":694},"\u003C!-- a dark callout inside an otherwise-light page -->\n",[427,2176,2177,2179,2182,2184,2186,2189],{"class":429,"line":471},[427,2178,434],{"class":433},[427,2180,2181],{"class":437},"aside",[427,2183,547],{"class":441},[427,2185,445],{"class":433},[427,2187,2188],{"class":448},"\"ori-theme_dark\"",[427,2190,560],{"class":433},[427,2192,2193],{"class":429,"line":501},[427,2194,2195],{"class":694},"    \u003C!-- surface, primary, shadows all resolve to their dark values here -->\n",[427,2197,2198,2200,2202],{"class":429,"line":714},[427,2199,2039],{"class":433},[427,2201,2181],{"class":437},[427,2203,560],{"class":433},[246,2205,2206,2207,2210,2211,2214,2215,2218,2219,2222],{},"To switch the whole palette to a named skin (Sumi, Cyber, …), that's a page-level toggle and a Theming\nconcern — see ",[311,2208,158],{"href":2209},"\u002Fguides\u002Ftheming#scoping-a-skin-or-mode-to-a-subtree",". (Skins are authored on\n",[263,2212,2213],{},":root[data-ori-skin='…']",", so ",[263,2216,2217],{},"data-ori-skin"," on a non-root wrapper matches nothing today; mode scoping\nvia ",[263,2220,2221],{},".ori-theme_*"," works anywhere.)",[321,2224,2226],{"id":2225},"_6-five-minute-brand-walkthrough","6 · Five-minute brand walkthrough",[246,2228,2229,2230,2233],{},"The entire job, start to finish: ",[258,2231,2232],{},"set your primary (light + dark), and a radius if you want one."," Same\ncomponents, no rewrite.",[246,2235,2236],{},"Import oriUI once (the stylesheet, or the Vue package which includes it):",[419,2238,2242],{"className":2239,"code":2240,"language":2241,"meta":417,"style":417},"language-ts shiki shiki-themes github-light github-dark","import '@oriui\u002Fcss'; \u002F\u002F or: import '@oriui\u002Fvue' for the Vue components\n","ts",[263,2243,2244],{"__ignoreMap":417},[427,2245,2246,2249,2252,2254],{"class":429,"line":430},[427,2247,2248],{"class":700},"import",[427,2250,2251],{"class":448}," '@oriui\u002Fcss'",[427,2253,728],{"class":433},[427,2255,2256],{"class":694},"\u002F\u002F or: import '@oriui\u002Fvue' for the Vue components\n",[246,2258,2259,2260,2262],{},"Then add one ",[263,2261,762],{}," block to your stylesheet:",[419,2264,2266],{"className":685,"code":2265,"language":687,"meta":417,"style":417},":root {\n    \u002F* your brand primary, both modes, with legible on-colors *\u002F\n    --ori-color-primary-light: #7c3aed;\n    --ori-color-on-primary-light: #ffffff;\n    --ori-color-primary-dark: #a78bfa;\n    --ori-color-on-primary-dark: #1e1035;\n\n    \u002F* your house radius — the derived scale (xs–xl) follows proportionally *\u002F\n    --ori-size-radius_md: 6px;\n}\n",[263,2267,2268,2274,2279,2290,2300,2311,2322,2326,2331,2344],{"__ignoreMap":417},[427,2269,2270,2272],{"class":429,"line":430},[427,2271,762],{"class":441},[427,2273,711],{"class":433},[427,2275,2276],{"class":429,"line":471},[427,2277,2278],{"class":694},"    \u002F* your brand primary, both modes, with legible on-colors *\u002F\n",[427,2280,2281,2283,2285,2288],{"class":429,"line":501},[427,2282,770],{"class":717},[427,2284,721],{"class":433},[427,2286,2287],{"class":724},"#7c3aed",[427,2289,880],{"class":433},[427,2291,2292,2294,2296,2298],{"class":429,"line":714},[427,2293,885],{"class":717},[427,2295,721],{"class":433},[427,2297,890],{"class":724},[427,2299,880],{"class":433},[427,2301,2302,2304,2306,2309],{"class":429,"line":734},[427,2303,902],{"class":717},[427,2305,721],{"class":433},[427,2307,2308],{"class":724},"#a78bfa",[427,2310,880],{"class":433},[427,2312,2313,2315,2317,2320],{"class":429,"line":740},[427,2314,914],{"class":717},[427,2316,721],{"class":433},[427,2318,2319],{"class":724},"#1e1035",[427,2321,880],{"class":433},[427,2323,2324],{"class":429,"line":746},[427,2325,750],{"emptyLinePlaceholder":749},[427,2327,2328],{"class":429,"line":753},[427,2329,2330],{"class":694},"    \u002F* your house radius — the derived scale (xs–xl) follows proportionally *\u002F\n",[427,2332,2333,2335,2337,2340,2342],{"class":429,"line":759},[427,2334,1211],{"class":717},[427,2336,721],{"class":433},[427,2338,2339],{"class":724},"6",[427,2341,1219],{"class":700},[427,2343,880],{"class":433},[427,2345,2346],{"class":429,"line":767},[427,2347,743],{"class":433},[246,2349,2350,2351,2354,2355,2357,2358,2360,2361,2363,2364,1268,2366,2368,2369,2372,2373,319],{},"That's it. Every primary button, focus ring, switch, and accent across the library is now your violet, in\nlight ",[258,2352,2353],{},"and"," dark — and it stays accessible, because state is real attributes and the ",[263,2356,378],{}," pairing\ncarries the contrast. The radius change reaches every control on a ",[258,2359,1253],{}," step (cards, panels,\ninputs); controls pinned to another step (buttons default to ",[263,2362,1186],{},") keep theirs until you set their\n",[263,2365,1373],{},[263,2367,1271],{}," class to ",[263,2370,2371],{},"md",". No component was edited, no class was added, nothing\nwas forked. Start with the defaults to prototype; drop in this block when you're ready to ship — that's\n",[250,2374,2375],{},"scale without rewriting",[321,2377,2379],{"id":2378},"icons-follow-the-text-color","Icons follow the text color",[246,2381,2382,2383,2386,2387,2390,2391,2394,2395,2398,2399,2402,2403,2405,2406,2408,2409,2411],{},"There is no separate icon-color token — an icon ",[258,2384,2385],{},"is text",", as far as color flows. ",[263,2388,2389],{},".ori-icon","\nresolves its color from ",[263,2392,2393],{},"currentcolor",", and everything inside it paints along\n(",[263,2396,2397],{},".ori-icon > * { fill: currentcolor }","), so whatever colors the text colors the icon: a role class, a\nthemed button, the escape-hatch pair above, or a plain CSS ",[263,2400,2401],{},"color:"," on any wrapper. Inside a filled\nbutton the icon automatically renders in the ",[263,2404,378],{}," color; a standalone icon takes the same ",[263,2407,276],{},"\nprop \u002F ",[263,2410,1320],{}," class as everything else:",[419,2413,2415],{"className":533,"code":2414,"language":535,"meta":417,"style":417},"\u003Cspan style=\"color: teal\">\n    \u003Ci class=\"ori-icon\" aria-hidden=\"true\">\u003Csvg viewBox=\"0 0 24 24\">…\u003C\u002Fsvg>\u003C\u002Fi>\n    teal text, teal icon — one declaration\n\u003C\u002Fspan>\n",[263,2416,2417,2432,2481,2486],{"__ignoreMap":417},[427,2418,2419,2421,2423,2425,2427,2430],{"class":429,"line":430},[427,2420,434],{"class":433},[427,2422,427],{"class":437},[427,2424,1636],{"class":441},[427,2426,445],{"class":433},[427,2428,2429],{"class":448},"\"color: teal\"",[427,2431,560],{"class":433},[427,2433,2434,2437,2440,2442,2444,2447,2450,2452,2455,2458,2461,2464,2466,2469,2472,2474,2477,2479],{"class":429,"line":471},[427,2435,2436],{"class":433},"    \u003C",[427,2438,2439],{"class":437},"i",[427,2441,547],{"class":441},[427,2443,445],{"class":433},[427,2445,2446],{"class":448},"\"ori-icon\"",[427,2448,2449],{"class":441}," aria-hidden",[427,2451,445],{"class":433},[427,2453,2454],{"class":448},"\"true\"",[427,2456,2457],{"class":433},">\u003C",[427,2459,2460],{"class":437},"svg",[427,2462,2463],{"class":441}," viewBox",[427,2465,445],{"class":433},[427,2467,2468],{"class":448},"\"0 0 24 24\"",[427,2470,2471],{"class":433},">…\u003C\u002F",[427,2473,2460],{"class":437},[427,2475,2476],{"class":433},">\u003C\u002F",[427,2478,2439],{"class":437},[427,2480,560],{"class":433},[427,2482,2483],{"class":429,"line":501},[427,2484,2485],{"class":433},"    teal text, teal icon — one declaration\n",[427,2487,2488,2490,2492],{"class":429,"line":714},[427,2489,2039],{"class":433},[427,2491,427],{"class":437},[427,2493,560],{"class":433},[321,2495,2497],{"id":2496},"reading-tokens-from-js","Reading tokens from JS",[246,2499,2500,2501,2504,2505,330,2508,2511,2512,383,2514,2517,2518,2521],{},"CSS variables stop at the canvas edge: Konva, ECharts, WebGL painters draw outside the CSS cascade, and\n",[263,2502,2503],{},"getComputedStyle().getPropertyValue('--x')"," only returns the ",[250,2506,2507],{},"unresolved",[263,2509,2510],{},"var()"," chain. The headless\npackage ships the bridge — ",[263,2513,202],{},[263,2515,2516],{},"useThemeColor"," from ",[263,2519,2520],{},"@oriui\u002Fheadless\u002Fvue"," resolve a token to\nits computed value and re-resolve on every skin \u002F mode flip:",[419,2523,2525],{"className":2239,"code":2524,"language":2241,"meta":417,"style":417},"import { useThemeColor } from '@oriui\u002Fheadless\u002Fvue';\n\nconst brand = useThemeColor('primary'); \u002F\u002F resolved --ori-color-primary; '' until mounted (SSR-safe)\nwatch(brand, (c) => engine.setColor(c || fallback)); \u002F\u002F skin\u002Fmode flips re-push automatically\n",[263,2526,2527,2542,2546,2571],{"__ignoreMap":417},[427,2528,2529,2531,2534,2537,2540],{"class":429,"line":430},[427,2530,2248],{"class":700},[427,2532,2533],{"class":433}," { useThemeColor } ",[427,2535,2536],{"class":700},"from",[427,2538,2539],{"class":448}," '@oriui\u002Fheadless\u002Fvue'",[427,2541,880],{"class":433},[427,2543,2544],{"class":429,"line":471},[427,2545,750],{"emptyLinePlaceholder":749},[427,2547,2548,2551,2554,2557,2560,2562,2565,2568],{"class":429,"line":501},[427,2549,2550],{"class":700},"const",[427,2552,2553],{"class":724}," brand",[427,2555,2556],{"class":700}," =",[427,2558,2559],{"class":441}," useThemeColor",[427,2561,1879],{"class":433},[427,2563,2564],{"class":448},"'primary'",[427,2566,2567],{"class":433},"); ",[427,2569,2570],{"class":694},"\u002F\u002F resolved --ori-color-primary; '' until mounted (SSR-safe)\n",[427,2572,2573,2576,2579,2582,2585,2588,2591,2594,2597,2600,2603],{"class":429,"line":714},[427,2574,2575],{"class":441},"watch",[427,2577,2578],{"class":433},"(brand, (",[427,2580,2581],{"class":717},"c",[427,2583,2584],{"class":433},") ",[427,2586,2587],{"class":700},"=>",[427,2589,2590],{"class":433}," engine.",[427,2592,2593],{"class":441},"setColor",[427,2595,2596],{"class":433},"(c ",[427,2598,2599],{"class":700},"||",[427,2601,2602],{"class":433}," fallback)); ",[427,2604,2605],{"class":694},"\u002F\u002F skin\u002Fmode flips re-push automatically\n",[246,2607,2608,2609,2611,2612,2615,2616,390,2619,2622,2623,319],{},"Colors-only for now — the probe resolves through the ",[263,2610,276],{}," property, so the token must resolve to a\n",[263,2613,2614],{},"\u003Ccolor>",". The full pattern (seeding a canvas engine on mount, the framework-agnostic ",[263,2617,2618],{},"resolveToken",[263,2620,2621],{},"observeTheme"," primitives, the Svelte twin) is in the\n",[311,2624,2627,2630],{"href":2625,"rel":2626},"https:\u002F\u002Fgithub.com\u002Fmarkgrushevski\u002Foriui\u002Fblob\u002Fmain\u002Fpackages\u002Fheadless\u002FREADME.md#reading-tokens-from-js",[1932],[263,2628,2629],{},"@oriui\u002Fheadless"," README",[321,2632,2634],{"id":2633},"see-also","See also",[1061,2636,2637,2645,2650,2655],{},[1064,2638,2639,2641,2642,2644],{},[311,2640,150],{"href":149}," — the full token catalog: the neutral ramp, every role, the\nsize \u002F radius \u002F gap \u002F font scales, and the canonical ",[263,2643,653],{}," order.",[1064,2646,2647,2649],{},[311,2648,158],{"href":157}," — switching whole palettes (named skins) and modes at runtime, and authoring\nyour own skin.",[1064,2651,2652,2654],{},[311,2653,142],{"href":141}," — branding without Vue, in htmx, Astro, or plain HTML.",[1064,2656,2657,338,2659,2661],{},[311,2658,226],{"href":225},[311,2660,22],{"href":21}," — the per-component class reference.",[2663,2664,2665],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}",{"title":417,"searchDepth":471,"depth":471,"links":2667},[2668,2669,2671,2675,2676,2677,2678,2679,2680,2681],{"id":323,"depth":471,"text":324},{"id":649,"depth":471,"text":2670},"Why an override just works — the @layer cascade",{"id":843,"depth":471,"text":844,"children":2672},[2673,2674],{"id":977,"depth":501,"text":978},{"id":1141,"depth":501,"text":1142},{"id":1275,"depth":471,"text":1276},{"id":1601,"depth":471,"text":1602},{"id":1962,"depth":471,"text":1963},{"id":2225,"depth":471,"text":2226},{"id":2378,"depth":471,"text":2379},{"id":2496,"depth":471,"text":2497},{"id":2633,"depth":471,"text":2634},{},{"title":146,"description":147},"guides\u002Fcustomization","SKnLGa2_vcU6RvgG89VZ6RpYJAw817sDdezl5kDQhOk",1783874705224]