blip-tokens 2.2.1 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,72 +1,88 @@
1
1
  :where([data-uai-theme]:not([data-uai-theme] *)) {
2
- /* Border width. 1px. Standard borders. */
2
+ /* Border width 1px. Default for every border: inputs, selects, checkboxes, cards and dividers, including the solid focus border of inputs. */
3
3
  --uai-border-width-default: 1px;
4
- /* Border width. 0px. */
4
+ /* Border width 0px. Use: removing a border explicitly. */
5
5
  --uai-border-width-none: 0px;
6
- /* Border width. 2px. Focus rings and emphasis borders. */
6
+ /* Border width 2px. Use: focus rings and halos, the checked radio border and emphasis borders. */
7
7
  --uai-border-width-thick: 2px;
8
- /* Border radius. 24px. */
8
+ /* Control height 24px. Compact controls: 24px icon-only buttons and the compact uai-button, toolbars and dense tables. Pair: radius/md and caption text. Avoid: primary actions and form fields in regular forms. Avoid: spacing tokens for heights. */
9
+ --uai-control-height-compact: 1.5rem;
10
+ /* Control height 56px. Large controls: 56px buttons for prominent single actions, such as hero or empty-state calls to action. Pair: radius/lg and spacing/md horizontal padding. Avoid: dense forms and tables. Avoid: spacing tokens for heights. */
11
+ --uai-control-height-large: 3.5rem;
12
+ /* Control height 40px. Default control height: buttons, inputs, selects, datepickers and header actions. Pair: radius/lg, spacing/sm horizontal padding and body/base text. Use this size when unsure. Avoid: spacing tokens for heights. */
13
+ --uai-control-height-medium: 2.5rem;
14
+ /* Control height 32px. Short controls: 32px buttons, inputs and selects in dense areas such as filters, table toolbars and breadcrumb items. Pair: radius/lg and body/base text. Avoid: spacing tokens for heights. */
15
+ --uai-control-height-short: 2rem;
16
+ /* Opacity of a disabled control: 50 percent in Figma, unitless 0.5 in web outputs. Use only where the component contract dims the whole control, such as uai-button. Avoid: inputs and selection controls, which use content/disabled colors instead. */
17
+ --uai-opacity-disabled: 0.5;
18
+ /* Opacity of the supplementary outer focus halo: 30 percent in Figma, unitless 0.3 in web outputs. Apply only to the halo layer and keep a solid border/ring focus indicator. Avoid: the whole control, or the halo as the only focus cue. */
19
+ --uai-opacity-focus-ring: 0.3;
20
+ /* Corner radius 24px. Reserved for very large surfaces; no UAI component uses it yet. Confirm with design before applying. */
9
21
  --uai-radius-2xl: 1.5rem;
10
- /* Border radius. Full round. */
22
+ /* Fully rounded corners (pill or circle). Use: avatars, radio buttons, the radio hover halo, badges and pill-shaped chips. */
11
23
  --uai-radius-full: 624.9375rem;
12
- /* Border radius. 12px. */
24
+ /* Corner radius 12px. Default for controls and the panels they open: inputs, selects, buttons (32 to 56px), dropdown and listbox panels, menu items, datepicker day cells and header actions. */
13
25
  --uai-radius-lg: 0.75rem;
14
- /* Border radius. 8px. */
26
+ /* Corner radius 8px. Use: compact 24px controls, such as the compact uai-button, and other small interactive elements. */
15
27
  --uai-radius-md: 0.5rem;
16
- /* Border radius. 0px. */
28
+ /* Corner radius 0px. Use: square corners on full-bleed surfaces, table cells and edges that touch other elements. */
17
29
  --uai-radius-none: 0rem;
18
- /* Border radius. 4px. */
30
+ /* Corner radius 4px. Use: checkboxes, chip remove buttons, small badges and other small inner elements. */
19
31
  --uai-radius-sm: 0.25rem;
20
- /* Border radius. 16px. */
32
+ /* Corner radius 16px. Reserved for large surfaces; no UAI component uses it yet. Confirm with design before applying. */
21
33
  --uai-radius-xl: 1rem;
22
- /* Border radius. 2px. */
34
+ /* Corner radius 2px. Use: tiny inner marks and indicators. Avoid: controls and containers. */
23
35
  --uai-radius-xs: 0.125rem;
24
- /* Fixed size. 40px. Medium avatars. */
36
+ /* Fixed size 40px. Use: small avatar and square icon containers. Avoid: control heights of buttons, inputs and selects; use control-height/medium. */
25
37
  --uai-sizing-2xl: 2.5rem;
26
- /* Fixed size. 48px. Large avatars. */
38
+ /* Fixed size 8px. Use: the tooltip arrow, notification dots on header actions and other very small indicators. Avoid: padding and gaps; use spacing/*. */
39
+ --uai-sizing-2xs: 0.5rem;
40
+ /* Fixed size 48px. Use: standard avatar. */
27
41
  --uai-sizing-3xl: 3rem;
28
- /* Fixed size. 64px. Extra large avatars. */
42
+ /* Fixed size 64px. Use: large avatar. */
29
43
  --uai-sizing-4xl: 4rem;
30
- /* Fixed size. 24px. Icon medium (default). */
44
+ /* Fixed size 72px. Use: extra-large avatar. */
45
+ --uai-sizing-5xl: 4.5rem;
46
+ /* Fixed size 24px. Use: default icons (uai-icon size medium) and the micro avatar. Avoid: control heights; use control-height/compact. */
31
47
  --uai-sizing-lg: 1.5rem;
32
- /* Fixed size. 20px. Icon small. */
48
+ /* Fixed size 20px. Use: small icons (uai-icon size small), checkbox and radio controls. */
33
49
  --uai-sizing-md: 1.25rem;
34
- /* Fixed size. 16px. Icon x-small. */
50
+ /* Fixed size 16px. Use: x-small icons (uai-icon size x-small), such as the header breadcrumb chevrons. */
35
51
  --uai-sizing-sm: 1rem;
36
- /* Fixed size. 32px. Small avatars. */
52
+ /* Fixed size 32px. Use: extra-small avatar, the radio hover halo and datepicker day cells. Avoid: control heights; use control-height/short. */
37
53
  --uai-sizing-xl: 2rem;
38
- /* Fixed size. 12px. Status dots, tiny indicators. */
54
+ /* Fixed size 12px. Use: status dots, tiny indicators and the selected radio dot. Avoid: padding and gaps; use spacing/*. */
39
55
  --uai-sizing-xs: 0.75rem;
40
- /* Spacing. 40px. */
56
+ /* Spacing 40px. Layout spacing between large page regions. Avoid: control heights; use control-height/medium. */
41
57
  --uai-spacing-2xl: 2.5rem;
42
- /* Spacing. 4px. */
58
+ /* Spacing 4px. Smallest gap between related items: label to field and field to message in inputs, and the offset of a dropdown or popover from its trigger. */
43
59
  --uai-spacing-2xs: 0.25rem;
44
- /* Spacing. 48px. */
60
+ /* Spacing 48px. Layout spacing between large page regions. */
45
61
  --uai-spacing-3xl: 3rem;
46
- /* Spacing. 2px. */
62
+ /* Spacing 2px. Hairline gaps and offsets inside small elements, such as the side padding of avatar initials. Avoid: widths and heights; use sizing/*. */
47
63
  --uai-spacing-3xs: 0.125rem;
48
- /* Spacing. 56px. */
64
+ /* Spacing 56px. Layout spacing for page margins and large regions. Avoid: control heights; use control-height/large. */
49
65
  --uai-spacing-4xl: 3.5rem;
50
- /* Spacing. 64px. */
66
+ /* Spacing 64px. Layout spacing for page margins and large regions. */
51
67
  --uai-spacing-5xl: 4rem;
52
- /* Spacing. 72px. */
68
+ /* Spacing 72px. Layout spacing for page margins and large regions. Avoid: the header height, which comes from its content and padding. */
53
69
  --uai-spacing-6xl: 4.5rem;
54
- /* Spacing. 80px. */
70
+ /* Spacing 80px. Layout spacing for page margins and hero areas. */
55
71
  --uai-spacing-7xl: 5rem;
56
- /* Spacing. 88px. */
72
+ /* Spacing 88px. Layout spacing for page margins and hero areas. */
57
73
  --uai-spacing-8xl: 5.5rem;
58
- /* Spacing. 96px. */
74
+ /* Spacing 96px. Largest layout spacing, for hero and landing areas. */
59
75
  --uai-spacing-9xl: 6rem;
60
- /* Spacing. 24px. */
76
+ /* Spacing 24px. Gap between groups of content and between navigation bar items (uai-navbar). */
61
77
  --uai-spacing-lg: 1.5rem;
62
- /* Spacing. 16px. */
78
+ /* Spacing 16px. Default padding of containers such as the app header, cards and dropdown search rows. The header height comes from sizing/2xl content plus this padding above and below. */
63
79
  --uai-spacing-md: 1rem;
64
- /* Spacing. 0px. */
80
+ /* Spacing 0px. Use: removing gaps or padding explicitly. */
65
81
  --uai-spacing-none: 0rem;
66
- /* Spacing. 12px. */
82
+ /* Spacing 12px. Horizontal padding of buttons and other controls. */
67
83
  --uai-spacing-sm: 0.75rem;
68
- /* Spacing. 32px. */
84
+ /* Spacing 32px. Layout spacing between page sections. */
69
85
  --uai-spacing-xl: 2rem;
70
- /* Spacing. 8px. */
86
+ /* Spacing 8px. Gap between an icon and its label, between a checkbox or radio and its label, and between header actions; minimum distance from the viewport edge for floating panels and the tooltip offset from its trigger. */
71
87
  --uai-spacing-xs: 0.5rem;
72
88
  }
@@ -0,0 +1,26 @@
1
+ :where([data-uai-theme]:not([data-uai-theme] *)) {
2
+ /* Stacking order 100 (z-index). Use: Page content that must stay above the page background, such as sticky table headers inside the page. Overlays (dropdowns, tooltips, dialogs, drawers, toasts) do not use layers; they open in the browser top layer. Avoid: raising other elements above the header. */
3
+ --uai-layer-content: 100;
4
+ /* Stacking order 500 (z-index). Use: The application header (uai-header), above content and navigation. Overlays (dropdowns, tooltips, dialogs, drawers, toasts) do not use layers; they open in the browser top layer. Avoid: raising other elements above the header. */
5
+ --uai-layer-header: 500;
6
+ /* Stacking order 400 (z-index). Use: The application side menu. Overlays (dropdowns, tooltips, dialogs, drawers, toasts) do not use layers; they open in the browser top layer. Avoid: raising other elements above the header. */
7
+ --uai-layer-navigation: 400;
8
+ /* Stacking order 300 (z-index). Use: Backdrop shown behind the expanded side menu on narrow screens. Overlays (dropdowns, tooltips, dialogs, drawers, toasts) do not use layers; they open in the browser top layer. Avoid: raising other elements above the header. */
9
+ --uai-layer-navigation-overlay: 300;
10
+ /* Layout width 1112px. Use: Maximum width of page content; pages center their content within it. Avoid: fixed widths for fields or menus that should follow their content. */
11
+ --uai-width-content: 69.5rem;
12
+ /* Layout width 424px. Use: Width of standard dialogs (uai-dialog). On narrow screens the dialog uses the viewport minus spacing/md on each side. Avoid: fixed widths for fields or menus that should follow their content. */
13
+ --uai-width-dialog: 26.5rem;
14
+ /* Layout width 224px. Use: Minimum width of contextual menus and action lists (uai-dropdown). Menus grow with content up to the viewport minus spacing/xs on each side. Avoid: fixed widths for fields or menus that should follow their content. */
15
+ --uai-width-menu: 14rem;
16
+ /* Layout width 288px. Use: Width of rich dropdown panels such as alerts, organization switcher and profile menus. Avoid: fixed widths for fields or menus that should follow their content. */
17
+ --uai-width-panel: 18rem;
18
+ /* Layout width 288px. Use: Width of the expanded application side menu. Avoid: fixed widths for fields or menus that should follow their content. */
19
+ --uai-width-side-menu: 18rem;
20
+ /* Layout width 80px. Use: Width of the collapsed application side menu (icons only). Avoid: fixed widths for fields or menus that should follow their content. */
21
+ --uai-width-side-menu-collapsed: 5rem;
22
+ /* Layout width 470px. Use: Width of side panels and drawers that overlay the page, such as the Brain sidebar. Avoid: fixed widths for fields or menus that should follow their content. */
23
+ --uai-width-sidebar: 29.375rem;
24
+ /* Layout width 240px. Use: Maximum width of tooltips; longer text wraps. Avoid: fixed widths for fields or menus that should follow their content. */
25
+ --uai-width-tooltip: 15rem;
26
+ }
@@ -0,0 +1,14 @@
1
+ :where([data-uai-theme]:not([data-uai-theme] *)) {
2
+ /* Motion duration 150ms. Use: control state changes such as hover, focus, pressed, checked and selected, and chevron rotation. Pair: easing/standard. Respect prefers-reduced-motion. */
3
+ --uai-duration-fast: 150ms;
4
+ /* Motion duration 65ms. Use: feedback that must not delay reading, such as tooltips appearing and hiding. Pair: easing/standard. Respect prefers-reduced-motion. */
5
+ --uai-duration-instant: 65ms;
6
+ /* Motion duration 800ms. Use: one cycle of a continuous animation, such as a loading spinner rotation. Pair: easing/linear. Under prefers-reduced-motion, slow it down or stop it. */
7
+ --uai-duration-loop: 800ms;
8
+ /* Motion duration 200ms. Use: overlays entering and leaving, such as dropdowns, listboxes, popovers and toasts. Pair: easing/standard. Respect prefers-reduced-motion. */
9
+ --uai-duration-moderate: 200ms;
10
+ /* Motion easing, CSS linear. Use: continuous animations at constant speed, such as spinners. Pair: duration/loop. Avoid: state changes; use easing/standard. */
11
+ --uai-easing-linear: cubic-bezier(0, 0, 1, 1);
12
+ /* Motion easing, CSS ease. Default curve for state changes and overlays. Pair: duration/instant, duration/fast or duration/moderate. */
13
+ --uai-easing-standard: cubic-bezier(0.25, 0.1, 0.25, 1);
14
+ }
@@ -1,52 +1,72 @@
1
1
  :where([data-uai-theme]:not([data-uai-theme] *)) {
2
- /* Body Base — 14px. Default application text. */
2
+ /* Body Base font size: 14px. Default for application text: paragraphs, input values, button labels, list and menu items, table cells. Pair: body/base/line-height (22px). Use this role when unsure. */
3
3
  --uai-body-base-font-size: 0.875rem;
4
- /* Body Base — 22px. */
4
+ /* Body Base line height: 22px. Pair: body/base/font-size (14px). */
5
5
  --uai-body-base-line-height: 1.375rem;
6
- /* Caption — 12px. Helpers, badges, small body text. */
6
+ /* Body Large — 16px. Lead text and large body copy. */
7
+ --uai-body-lg-font-size: 1rem;
8
+ /* Body Large — 24px line height. */
9
+ --uai-body-lg-line-height: 1.5rem;
10
+ /* Body Small — 12px. Compact secondary text. */
11
+ --uai-body-sm-font-size: 0.75rem;
12
+ /* Body Small — 20px line height. */
13
+ --uai-body-sm-line-height: 1.25rem;
14
+ /* Caption font size: 12px. Use: input labels, helper, error and success messages, compact button labels, badges, metadata and timestamps. Pair: caption/line-height (20px). Avoid: long reading text; use body/base. */
7
15
  --uai-caption-font-size: 0.75rem;
8
- /* Caption — 20px. */
16
+ /* Caption line height: 20px. Pair: caption/font-size (12px). */
9
17
  --uai-caption-line-height: 1.25rem;
10
- /* Display — 40px. Hero, landing pages. */
18
+ /* Display font size: 40px. Use: hero and landing-page headlines, at most one per view. Pair: display/line-height (48px) and font-family/display. Avoid: in-app page titles; use heading/xl. */
11
19
  --uai-display-font-size: 2.5rem;
12
- /* Display — 48px. */
20
+ /* Display line height: 48px. Pair: display/font-size (40px). Use only with display text. */
13
21
  --uai-display-line-height: 3rem;
14
- /* Display font for hero and marketing titles. Figtree today; may diverge per product. */
22
+ /* Typeface for display and marketing headlines: Figtree today, may diverge per product. Use: display text only. Avoid: interface text, which uses font-family/sans. */
15
23
  --uai-font-family-display: Figtree;
16
- /* Primary font for all interface text. Figtree. */
24
+ /* Typeface for all interface text: Figtree. Use: every UI text, through the text styles in designs and this token in code. Pair: the size, line-height and weight tokens of one role (body/base, caption, title, heading, display). Avoid: typing the family name in code or designs. */
17
25
  --uai-font-family-sans: Figtree;
18
- /* Bold weight (700). Titles, strong emphasis. */
26
+ /* Font weight 700. Strong emphasis in titles and short inline text. Avoid: long passages and whole paragraphs. */
19
27
  --uai-font-weight-bold: 700;
20
- /* ExtraBold weight (800). Hero emphasis; maps to blip-ds bold="extra-bold". */
28
+ /* Font weight 800. Hero emphasis only; equivalent to blip-ds bold='extra-bold'. Avoid: regular interface text. */
21
29
  --uai-font-weight-extrabold: 800;
22
- /* Medium weight (500). Labels, buttons. */
30
+ /* Font weight 500. Light emphasis: button labels, avatar initials and active navigation items. */
23
31
  --uai-font-weight-medium: 500;
24
- /* Regular weight (400). Default body text. */
32
+ /* Font weight 400. Default for body text, input values and helper, error and success messages. */
25
33
  --uai-font-weight-regular: 400;
26
- /* SemiBold weight (600). Subtitles, navigation. */
34
+ /* Font weight 600. Emphasis for labels and titles: input labels (caption semibold), card and section titles. */
27
35
  --uai-font-weight-semibold: 600;
28
- /* Heading LG — 24px. Content sections. */
36
+ /* Heading LG font size: 24px. Use: titles of content sections within a page. Pair: heading/lg/line-height (32px). */
29
37
  --uai-heading-lg-font-size: 1.5rem;
30
- /* Heading LG — 32px. */
38
+ /* Heading LG line height: 32px. Pair: heading/lg/font-size (24px). */
31
39
  --uai-heading-lg-line-height: 2rem;
32
- /* Heading MD — 20px. Subsections. */
40
+ /* Heading MD font size: 20px. Use: subsection titles below heading/lg. Pair: heading/md/line-height (28px). */
33
41
  --uai-heading-md-font-size: 1.25rem;
34
- /* Heading MD — 28px. */
42
+ /* Heading MD line height: 28px. Pair: heading/md/font-size (20px). */
35
43
  --uai-heading-md-line-height: 1.75rem;
36
- /* Heading XL — 32px. Main page title. */
44
+ /* Heading XL font size: 32px. Use: the main title of a page, one per view. Pair: heading/xl/line-height (40px). Avoid: section titles; use heading/lg. */
37
45
  --uai-heading-xl-font-size: 2rem;
38
- /* Heading XL — 40px. */
46
+ /* Heading XL line height: 40px. Pair: heading/xl/font-size (32px). */
39
47
  --uai-heading-xl-line-height: 2.5rem;
40
- /* Expanded letter spacing (0.2em). Spaced body variant. */
48
+ /* Letter spacing 2.8px (0.2em at 14px). Use only for the spaced body variant (body/base/regular-space). Avoid: headings, long text and small sizes. */
41
49
  --uai-letter-spacing-expanded: 2.8px;
42
- /* Default letter spacing for all text styles. */
50
+ /* Letter spacing 0px. Default tracking for every text role. Use unless a text style explicitly asks for expanded tracking. */
43
51
  --uai-letter-spacing-normal: 0px;
44
- /* Overline — 10px. Tags, restricted use. */
52
+ /* Overline font size: 10px. Restricted use: tags and small category labels. Pair: overline/line-height (16px). Avoid: body copy or any essential information. */
45
53
  --uai-overline-font-size: 0.625rem;
46
- /* Overline — 16px. */
54
+ /* Overline line height: 16px. Pair: overline/font-size (10px). */
47
55
  --uai-overline-line-height: 1rem;
48
- /* Title — 16px. Card titles, strong labels, navigation. Use regular weight for large body text. */
56
+ /* Title compatibility alias for title/md — 16px. */
49
57
  --uai-title-font-size: 1rem;
50
- /* Title — 24px. */
58
+ /* Title Large — 18px. Primary page titles. */
59
+ --uai-title-lg-font-size: 1.125rem;
60
+ /* Title Large — 24px line height. */
61
+ --uai-title-lg-line-height: 1.5rem;
62
+ /* Title compatibility alias for title/md — 24px. */
51
63
  --uai-title-line-height: 1.5rem;
64
+ /* Title Medium — 16px. Card titles, strong labels, navigation. */
65
+ --uai-title-md-font-size: 1rem;
66
+ /* Title Medium — 24px line height. */
67
+ --uai-title-md-line-height: 1.5rem;
68
+ /* Title Small — 14px. Compact titles and labels. */
69
+ --uai-title-sm-font-size: 0.875rem;
70
+ /* Title Small — 20px line height. */
71
+ --uai-title-sm-line-height: 1.25rem;
52
72
  }
package/build/css/uai.css CHANGED
@@ -1,4 +1,6 @@
1
1
  @import "./uai-colors.css";
2
2
  @import "./uai-typography.css";
3
3
  @import "./uai-dimensions.css";
4
+ @import "./uai-layout.css";
5
+ @import "./uai-motion.css";
4
6
  @import "./uai-shadows.css";