@ids-group-ltd/ids-design-system 0.3.0 → 0.5.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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ids-group-ltd/ids-design-system",
3
- "version": "0.3.0",
3
+ "version": "0.5.0",
4
4
  "description": "IDS Group Angular design system: components, tokens, themes",
5
5
  "license": "MIT",
6
6
  "homepage": "https://ids-ds.proto.ids-group.co.uk/",
@@ -0,0 +1,50 @@
1
+ // Breakpoint scale — SINGLE source for both representations:
2
+ // --bp-* runtime custom properties (regular rules, JS via getComputedStyle)
3
+ // $bp-* compile-time Sass aliases, usable inside @media
4
+ //
5
+ // Why $bp-* exist: a custom property CANNOT be used in a @media condition
6
+ // (`@media (width >= var(--bp-md))` is ignored — the condition is evaluated
7
+ // before custom-property resolution). Sass variables resolve at build time, so
8
+ // they can. Use this partial wherever a media query needs the scale:
9
+ // @use 'breakpoints' as bp; // same dir; relative path elsewhere
10
+ // @include bp.up(md) { … } // width >= 768px
11
+ // @include bp.down(sm) { … } // width < 640px
12
+ // @media (width >= #{bp.$bp-lg}) { } // or read an alias directly
13
+
14
+ @use 'sass:map';
15
+
16
+ $breakpoints: (
17
+ 'xs': 480px,
18
+ 'sm': 640px,
19
+ 'md': 768px,
20
+ 'lg': 1024px,
21
+ 'xl': 1441px, // page-grid wide-tier threshold (12 cols, caps at --col-cap-content)
22
+ '2xl': 1536px,
23
+ );
24
+ $bp-xs: map.get($breakpoints, 'xs');
25
+ $bp-sm: map.get($breakpoints, 'sm');
26
+ $bp-md: map.get($breakpoints, 'md');
27
+ $bp-lg: map.get($breakpoints, 'lg');
28
+ $bp-xl: map.get($breakpoints, 'xl');
29
+ $bp-2xl: map.get($breakpoints, '2xl');
30
+
31
+ // width >= breakpoint — mobile-first / min-width semantics.
32
+ @mixin up($name) {
33
+ @media (width >= #{map.get($breakpoints, $name)}) {
34
+ @content;
35
+ }
36
+ }
37
+
38
+ // width < breakpoint — max-width semantics, exclusive of the breakpoint itself.
39
+ @mixin down($name) {
40
+ @media (width < #{map.get($breakpoints, $name)}) {
41
+ @content;
42
+ }
43
+ }
44
+
45
+ // Runtime mirror — emitted from the same map so the two never drift.
46
+ :root {
47
+ @each $name, $value in $breakpoints {
48
+ --bp-#{$name}: #{$value};
49
+ }
50
+ }
@@ -72,6 +72,7 @@
72
72
  cursor: pointer;
73
73
  border-radius: var(--radius-sm);
74
74
  text-align: left;
75
+ transition: background-color var(--duration-fast) var(--ease-standard);
75
76
 
76
77
  .option-icon {
77
78
  color: var(--icon-default);
@@ -0,0 +1,36 @@
1
+ // Scoped accent recolour. A `ds-color="<family>"` attribute — on a zone
2
+ // container, on a component host, or applied via the ds.color() mixin in
3
+ // consumer config — flips the --accent-* pointer family to another brand/status
4
+ // family for its subtree. Components read --accent-* for their accent (the
5
+ // Phase 2 sweep), so the whole subtree recolours from this one rule. Pairs with
6
+ // the button/icon-button `color` input (Phase 1), which flips the same pointers
7
+ // per instance. With no attribute, --accent-* stays the primary family (see
8
+ // themes/_semantic.scss), so the default theme is unchanged.
9
+
10
+ @mixin family-vars($family) {
11
+ --accent: var(--#{$family});
12
+ --accent-hover: var(--#{$family}-hover);
13
+ --accent-pressed: var(--#{$family}-pressed);
14
+ --accent-strong: var(--#{$family}-strong);
15
+ --accent-subtitle: var(--#{$family}-subtitle);
16
+ --accent-muted: var(--#{$family}-muted);
17
+ --accent-muted-strong: var(--#{$family}-muted-strong);
18
+ --accent-on: var(--#{$family}-on);
19
+ --accent-focus-ring: var(--focus-ring-#{$family});
20
+ --accent-focus-field: var(--focus-field-#{$family});
21
+ --accent-surface-tint: var(--#{$family}-subtitle);
22
+ }
23
+
24
+ /// Recolour the DS accent for a type or scope from consumer SCSS, e.g.
25
+ /// `ds-switch { @include ds.color(secondary); }`.
26
+ @mixin color($family) {
27
+ @include family-vars($family);
28
+ }
29
+
30
+ $families: secondary, tertiary, error, success, warning;
31
+
32
+ @each $family in $families {
33
+ [ds-color='#{$family}'] {
34
+ @include family-vars($family);
35
+ }
36
+ }
@@ -0,0 +1,17 @@
1
+ // Enter motion for CDK-overlay panels that carry the `ds-overlay-pane`
2
+ // panelClass (select, autocomplete, multi-select, date-picker, time-picker,
3
+ // color-picker, popover, tooltip). Animates the panel's ROOT CHILD, not the
4
+ // pane itself, so CDK's positioning transforms on `.cdk-overlay-pane` are left
5
+ // untouched. The leave/exit animation was removed (close is instant) — see the
6
+ // TODO(overlay-leave) in components/overlay-motion.ts to reinstate it.
7
+
8
+ .cdk-overlay-pane.ds-overlay-pane > * {
9
+ animation: ds-overlay-in var(--duration-fast) var(--ease-decelerate);
10
+ }
11
+
12
+ @keyframes ds-overlay-in {
13
+ from {
14
+ opacity: 0;
15
+ transform: translateY(-4px);
16
+ }
17
+ }
@@ -8,15 +8,17 @@
8
8
  //
9
9
  // Tier | Range | Cols | Gutter | Margin | Cap
10
10
  // ------------ | -------------- | ---- | ------------- | ------------- | ----------------
11
- // Mobile | <= 640px | 4 | --space-3 (12px) | --space-4 (16px) | fluid
12
- // Tablet | 641-1024px | 8 | --space-4 (16px) | --space-6 (24px) | fluid
13
- // Desktop | 1025-1440px | 12 | --space-5 (20px) | --space-8 (32px) | fluid
11
+ // Mobile | < 640px | 4 | --space-3 (12px) | --space-4 (16px) | fluid
12
+ // Tablet | 640-1023px | 8 | --space-4 (16px) | --space-6 (24px) | fluid
13
+ // Desktop | 1024-1440px | 12 | --space-5 (20px) | --space-8 (32px) | fluid
14
14
  // Desktop wide | >= 1441px | 12 | --space-6 (24px) | --space-10 (40px) | --col-cap-content (1280px)
15
15
  //
16
16
  // Snap to columns, not pixels: 8+4 / 6+6 / 9+3 are canonical splits;
17
17
  // 7+5 is forbidden. Prose blocks cap at --col-cap-text (720px) regardless
18
18
  // of grid width.
19
19
 
20
+ @use 'breakpoints' as bp;
21
+
20
22
  .page-grid {
21
23
  display: grid;
22
24
  gap: var(--page-gutter);
@@ -24,22 +26,22 @@
24
26
  max-width: var(--col-cap-content);
25
27
  margin: 0 auto;
26
28
 
27
- // Mobile (default, <= 640px) — 4 columns
29
+ // Mobile (default, < 640px) — 4 columns
28
30
  --page-gutter: var(--page-gutter-mobile);
29
31
  --page-margin: var(--page-margin-mobile);
30
32
 
31
33
  grid-template-columns: repeat(4, minmax(0, 1fr));
32
34
 
33
- // Tablet (641-1024px) — 8 columns
34
- @media (width >= 641px) {
35
+ // Tablet (640-1023px) — 8 columns
36
+ @include bp.up(sm) {
35
37
  --page-gutter: var(--page-gutter-tablet);
36
38
  --page-margin: var(--page-margin-tablet);
37
39
 
38
40
  grid-template-columns: repeat(8, minmax(0, 1fr));
39
41
  }
40
42
 
41
- // Desktop (1025-1440px) — 12 columns, fluid width
42
- @media (width >= 1025px) {
43
+ // Desktop (1024-1440px) — 12 columns, fluid width
44
+ @include bp.up(lg) {
43
45
  --page-gutter: var(--page-gutter-desktop);
44
46
  --page-margin: var(--page-margin-desktop);
45
47
 
@@ -47,7 +49,7 @@
47
49
  }
48
50
 
49
51
  // Desktop wide (>= 1441px) — 12 columns, container capped at --col-cap-content
50
- @media (width >= 1441px) {
52
+ @include bp.up(xl) {
51
53
  --page-gutter: var(--page-gutter-wide);
52
54
  --page-margin: var(--page-margin-wide);
53
55
  }
@@ -0,0 +1,28 @@
1
+ // Rounded press feedback — Recipe C (approved by Stas 2026-07-02).
2
+ //
3
+ // Complements the global tap-highlight reset (_reset.scss). The native mobile
4
+ // tap overlay was a rectangle that ignored border-radius; we removed it, and
5
+ // this gives each interactive control a press state that INHERITS its shape:
6
+ // `filter` + `transform` apply to the rendered element, so any border-radius /
7
+ // clip is followed automatically, and neither conflicts with the box-shadow
8
+ // focus rings (different properties).
9
+ //
10
+ // Usage — @include INSIDE the clickable element's own selector, so `&:active`
11
+ // resolves to that element:
12
+ // @use '../../styles/press' as press; // relative path from the component
13
+ // .check { …; @include press.feedback; }
14
+ //
15
+ // Tunable per component (read-with-fallback, like the --ds-* layer):
16
+ // --ds-press-brightness (default .9) darken amount on press
17
+ // --ds-press-scale (default .97) micro press-scale
18
+ //
19
+ // Intentionally does NOT declare `transition` — that would clobber the host
20
+ // element's existing transition. Press is immediate (crisp on tap); components
21
+ // wanting an eased release add `filter`/`transform` to their own transition.
22
+
23
+ @mixin feedback {
24
+ &:active:not(:disabled):not([disabled]):not(.is-disabled) {
25
+ filter: brightness(var(--ds-press-brightness, 0.9));
26
+ transform: scale(var(--ds-press-scale, 0.97));
27
+ }
28
+ }
@@ -13,6 +13,15 @@ html, body {
13
13
  background: var(--surface-canvas);
14
14
  -webkit-font-smoothing: antialiased;
15
15
  text-rendering: optimizelegibility;
16
+
17
+ /* Suppress the native mobile tap-highlight. Android Chrome paints a flat
18
+ rectangular overlay on tap whose geometry is browser-controlled (ignores
19
+ border-radius, NOT clipped by overflow), so on pill/rounded controls it
20
+ pokes square corners out past the shape. We can only set its colour, not
21
+ reshape it — so we remove it and let each control's own rounded
22
+ :active/:focus-visible state provide press feedback. Inherited → covers all
23
+ descendants. */
24
+ -webkit-tap-highlight-color: transparent;
16
25
  }
17
26
  button, input, select, textarea { font-family: inherit; }
18
27
 
@@ -9,6 +9,7 @@ html { scrollbar-width: thin; scrollbar-color: var(--scrollbar-thumb) transparen
9
9
  border-radius: var(--radius-pill);
10
10
  border: var(--space-0-5) solid transparent;
11
11
  background-clip: padding-box;
12
+ transition: background-color var(--duration-fast) var(--ease-standard);
12
13
  }
13
14
  *::-webkit-scrollbar-thumb:hover { background: var(--scrollbar-thumb-hover); background-clip: padding-box; }
14
15
  *::-webkit-scrollbar-thumb:active { background: var(--scrollbar-thumb-active); background-clip: padding-box; }
@@ -0,0 +1,49 @@
1
+ // =========================================================================
2
+ // Theme activation.
3
+ //
4
+ // Light is the DEFAULT — applied at bare :root, no attribute needed. Dark is
5
+ // OPT-IN via <html data-theme="dark">; because the dark block declares the
6
+ // complete token set (palette + roles + overrides), the more-specific
7
+ // [data-theme='dark'] selector fully replaces light when present — it is not
8
+ // a delta-patch.
9
+ //
10
+ // There is no automatic prefers-color-scheme switch. To follow the OS, a
11
+ // consumer opts in at the app root: provideDsTheme({ followSystem: true })
12
+ // (exported from the package; see themes/README.md).
13
+ //
14
+ // Order matters: the dark block comes LAST so it wins over the light-context
15
+ // overrides (brand-gray neutrals) at equal specificity.
16
+ // =========================================================================
17
+
18
+ @use '../themes/light/theme' as light;
19
+ @use '../themes/dark/theme' as dark;
20
+
21
+ :root {
22
+ color-scheme: light; // native UI (scrollbars, form controls) match; opts out of UA force-dark
23
+
24
+ @include light.theme;
25
+ }
26
+
27
+ // Brand-gray neutral family — opt-in light-context switch (ds-docs tweaks panel).
28
+ // A light-theme feature: dark ships its own neutral ramp and wins below.
29
+ :root[data-neutrals='brand'] {
30
+ --neutral-0: var(--brand-gray-0);
31
+ --neutral-50: var(--brand-gray-50);
32
+ --neutral-100: var(--brand-gray-100);
33
+ --neutral-150: var(--brand-gray-150);
34
+ --neutral-200: var(--brand-gray-200);
35
+ --neutral-300: var(--brand-gray-300);
36
+ --neutral-400: var(--brand-gray-400);
37
+ --neutral-500: var(--brand-gray-500);
38
+ --neutral-600: var(--brand-gray-600);
39
+ --neutral-700: var(--brand-gray-700);
40
+ --neutral-800: var(--brand-gray-800);
41
+ --neutral-900: var(--brand-gray-900);
42
+ --neutral-950: var(--brand-gray-950);
43
+ }
44
+
45
+ :root[data-theme='dark'] {
46
+ color-scheme: dark; // native UI (scrollbars, form controls) render dark to match
47
+
48
+ @include dark.theme;
49
+ }
@@ -2,9 +2,9 @@
2
2
  Design Tokens — Tier 3 component + scale layer.
3
3
 
4
4
  Tier 1 colour primitives (ramps + HSL channels) live in
5
- ../themes/default/_palette.scss. Tier 2 semantic role assignments
5
+ ../themes/light/_palette.scss. Tier 2 semantic role assignments
6
6
  (surface, border, text, primary/secondary/tertiary, status, focus)
7
- live in ../themes/default/_theme.scss.
7
+ live in ../themes/light/_theme.scss.
8
8
 
9
9
  THIS file owns the theme-INDEPENDENT layer:
10
10
  · scales — spacing, radius, sizes, hit targets, breakpoints
@@ -43,6 +43,12 @@
43
43
  --space-24: 96px;
44
44
  --space-32: 128px;
45
45
 
46
+ /* Semantic spacing aliases — default rhythm for the layout primitives
47
+ (ds-stack / ds-inline). Components default their gap to these so the
48
+ vertical/horizontal rhythm retunes in one place. */
49
+ --space-stack: var(--space-4); /* 16px — vertical rhythm between stacked blocks */
50
+ --space-inline: var(--space-2); /* 8px — horizontal cluster gap */
51
+
46
52
  /* ============================================================
47
53
  Radius — six-stop scale.
48
54
  Each step is functionally distinct; adjacent steps are
@@ -75,6 +81,10 @@
75
81
  --border-width-default: 1px; /* every border, divider, field outline */
76
82
  --border-width-strong: 2px; /* radio dot, slider thumb, tabs underline, focus ring inner band, dropzone dash */
77
83
 
84
+ /* Focus outline-offset — gap between an element edge and its focus ring;
85
+ unifies the 2px offset repeated across stepper/table/dropzone/color-picker. */
86
+ --focus-ring-offset: 2px;
87
+
78
88
  /* ============================================================
79
89
  Elevation
80
90
  Channel-split substrate so a re-skin can re-tint shadows.
@@ -85,7 +95,7 @@
85
95
  hue/saturation/lightness become configurable.
86
96
  ============================================================ */
87
97
 
88
- /* --shadow-tint-h/s/l live in themes/default/_palette.scss — palette-level
98
+ /* --shadow-tint-h/s/l live in themes/light/_palette.scss — palette-level
89
99
  so dark palettes can override --shadow-tint-l → ~95% for soft light glows. */
90
100
 
91
101
  --shadow-1: 0 1px 2px hsl(var(--shadow-tint-h) var(--shadow-tint-s) var(--shadow-tint-l) / 6%),
@@ -173,14 +183,10 @@
173
183
  --opacity-state-active: 0.24; /* deepest pressed layer (e.g. tag close on :active) */
174
184
 
175
185
  /* ============================================================
176
- Breakpoints
186
+ Breakpoints — moved to _breakpoints.scss, the single source for both
187
+ the --bp-* custom properties (still emitted, now from that partial)
188
+ AND the $bp-* Sass aliases usable inside @media.
177
189
  ============================================================ */
178
- --bp-xs: 480px;
179
- --bp-sm: 640px;
180
- --bp-md: 768px;
181
- --bp-lg: 1024px;
182
- --bp-xl: 1441px; /* Page-grid wide-tier threshold (12 cols, container caps at --col-cap-content). */
183
- --bp-2xl:1536px;
184
190
 
185
191
  /* ============================================================
186
192
  Page grid — tier-specific gutters + margins.
@@ -210,7 +216,7 @@
210
216
 
211
217
  /* ============================================================
212
218
  Typography scale (theme-independent). Font FAMILIES are a theme
213
- choice and live in themes/default/_theme.scss (--font-sans/mono/
219
+ choice and live in themes/light/_theme.scss (--font-sans/mono/
214
220
  display/heading); the size/weight/leading/tracking scale below is
215
221
  constant across themes.
216
222
  ============================================================ */
@@ -287,7 +293,7 @@
287
293
  /* Shared focus indicators — components default their own --ds-*-focus-shadow
288
294
  to these, so a consumer retunes focus per-group at once (field vs control)
289
295
  or per-component. Two families: fields get the soft halo, interactive
290
- controls/nav get the crisp ring (see themes/default/_theme.scss). */
296
+ controls/nav get the crisp ring (see themes/light/_theme.scss). */
291
297
  --ds-field-focus-shadow: var(--focus-field);
292
298
  --ds-field-focus-shadow-error: var(--focus-field-error);
293
299
  --ds-control-focus-shadow: var(--focus-ring);
@@ -304,6 +310,10 @@
304
310
  --check-indet-h: 2px;
305
311
  --radio-dot-size: 10px;
306
312
  --radio-bw-checked: var(--border-width-strong);
313
+ --check-glyph-sm: 14px; /* .size-sm / .size-lg control box — fixed, not density-scaled */
314
+ --check-glyph-lg: 24px;
315
+ --radio-glyph-sm: 14px;
316
+ --radio-glyph-lg: 24px;
307
317
 
308
318
  /* Switch */
309
319
  --switch-track-w: 36px;
@@ -369,8 +379,12 @@
369
379
  --modal-w-sm: 480px;
370
380
  --modal-w-md: 640px;
371
381
  --modal-w-lg: 800px;
382
+ --modal-w-xl: 1024px;
383
+ --modal-w-fullscreen: calc(100vw - var(--space-6));
384
+ --modal-h-fullscreen: calc(100vh - var(--space-6));
372
385
 
373
386
  /* Drawer */
387
+ --drawer-w-sm: 320px;
374
388
  --drawer-w-md: 480px;
375
389
  --drawer-w-lg: 640px;
376
390
 
@@ -378,7 +392,7 @@
378
392
  --popover-maxh: 360px;
379
393
 
380
394
  /* Field */
381
- --field-gap-label: var(--space-1-5); /* label↔control */
395
+ --field-label-gap: var(--space-1-5); /* field vertical rhythm: label↔control & control↔hint */
382
396
  --field-gap-req: var(--space-1); /* label↔asterisk */
383
397
  --field-h-sm: var(--hit-min);
384
398
  --field-h-md: var(--hit-cozy);
@@ -392,7 +406,19 @@
392
406
 
393
407
  /* Search */
394
408
  --search-h: var(--hit-md);
395
- --search-maxw: 320px;
409
+
410
+ /* OTP / PIN input — one box per digit. */
411
+ --otp-cell-w: var(--space-12); /* 48px */
412
+ --otp-cell-h: var(--space-14); /* 56px */
413
+ --otp-gap: var(--space-2); /* 8px between cells */
414
+
415
+ /* Color picker */
416
+ --color-picker-swatch: var(--space-6); /* 24px preset swatch */
417
+ --color-picker-preview: var(--space-10); /* 40px panel preview */
418
+ --color-picker-panel-w: 240px; /* picker overlay width */
419
+ --color-picker-sv-h: 160px; /* saturation/value plane height */
420
+ --color-picker-hue-h: var(--space-3); /* 12px hue slider height */
421
+ --color-picker-thumb: 14px; /* draggable thumb diameter */
396
422
 
397
423
  /* ============================================================
398
424
  3b · COMPONENT-SCOPED dimensions (Phase 4 additions)
@@ -409,6 +435,7 @@
409
435
  --sidenav-logo-size: var(--hit-sm); /* 28px — square brand mark */
410
436
  --sidenav-collapsed-item: var(--hit-cozy); /* 40px — collapsed nav-item hit area */
411
437
  --sidenav-section-pad-b: var(--space-1-5); /* nav-section bottom padding */
438
+ --sidenav-item-rail-width: 3px; /* active-item left rail */
412
439
 
413
440
  /* Form section grid */
414
441
  --form-section-label-w: 280px; /* labels column width */
@@ -416,6 +443,10 @@
416
443
  /* Page header */
417
444
  --page-header-sub-mt: var(--space-1); /* subtitle top margin */
418
445
 
446
+ /* Bottom sheet */
447
+ --bottom-sheet-handle-w: 36px; /* drag-handle bar */
448
+ --bottom-sheet-handle-h: 4px;
449
+
419
450
  /* Field internals */
420
451
  --field-textarea-rows-min: 60px; /* min-h for inline textarea inside the field wrapper */
421
452
  --field-floating-pad-t: 18px; /* top padding when --floating, leaves room for label */
@@ -425,6 +456,7 @@
425
456
  /* Button group */
426
457
  --btn-group-overlap: calc(var(--border-width-default) * -1); /* -1px — collapses adjacent borders */
427
458
  --btn-link-uloff: 3px; /* underline-offset on link buttons */
459
+ --breadcrumbs-link-uloff: 2px; /* underline-offset on breadcrumb links */
428
460
 
429
461
  /* Card */
430
462
  --card-hover-lift: 1px; /* translateY on .card--hover */
@@ -433,6 +465,7 @@
433
465
  /* Sort icon (table headers) */
434
466
  --sort-ic-size: var(--icon-xs); /* 12px */
435
467
  --sort-ic-gap: var(--space-1-5); /* 6px */
468
+ --sort-ic-opacity-idle: 0.4; /* unsorted column icon */
436
469
 
437
470
  /* Tag close glyph (when literal svg sits inside .tag .x) */
438
471
  --tag-close-glyph: var(--icon-xs); /* 12px */
@@ -444,6 +477,11 @@
444
477
  --menu-minw: 200px; /* dropdown menu min width */
445
478
  --menu-sep-h: var(--border-width-default);
446
479
 
480
+ /* List / list-item — density-aware row padding + leading/trailing gap. */
481
+ --list-item-pad-y: var(--space-3); /* 12px */
482
+ --list-item-pad-x: var(--space-4); /* 16px */
483
+ --list-item-gap: var(--space-3); /* 12px leading↔body↔trailing */
484
+
447
485
  /* Tooltip */
448
486
  --tooltip-maxw: 240px;
449
487
  --tooltip-arrow: var(--space-2); /* 8px — caret edge length, halved for offset */
@@ -474,9 +512,9 @@
474
512
  --cmdk-list-maxh: var(--popover-maxh); /* alias — keeps cmdk + popover synced */
475
513
 
476
514
  /* Datepicker */
477
- --datepicker-w: 280px;
478
- --datepicker-cell-gap: var(--space-0-5); /* 2px — grid gap between day cells */
479
- --datepicker-nav-size: var(--hit-xs); /* 24px — month-step buttons */
515
+ --date-picker-w: 280px;
516
+ --date-picker-cell-gap: var(--space-0-5); /* 2px — grid gap between day cells */
517
+ --date-picker-nav-size: var(--hit-xs); /* 24px — month-step buttons */
480
518
 
481
519
  /* Modal close button */
482
520
  --modal-close-size: var(--hit-xs); /* 24px */
@@ -513,6 +551,16 @@
513
551
  --calendar-bar-h: var(--space-8); /* 32px */
514
552
  --calendar-bar-inset-y: var(--space-2); /* 8px from top of cell */
515
553
 
554
+ /* Timeline / activity feed */
555
+ --timeline-node-size: var(--hit-sm); /* 28px event node */
556
+ --timeline-spine-w: var(--border-width-strong); /* 2px connector spine */
557
+ --timeline-gap: var(--space-5); /* vertical gap between events */
558
+
559
+ /* Tree-view */
560
+ --tree-indent: var(--space-5); /* 20px per nesting level */
561
+ --tree-row-pad-y: var(--space-1-5); /* 6px */
562
+ --tree-row-pad-x: var(--space-3); /* 12px base inset */
563
+
516
564
  /* Bin pack visualisation */
517
565
  --binpack-bay-h: var(--hit-touch); /* 48px */
518
566
 
@@ -560,13 +608,20 @@
560
608
  --duration-base: 0ms;
561
609
  --duration-slow: 0ms;
562
610
  --duration-slower: 0ms;
563
- --duration-loop-fast: 0ms;
564
- --duration-loop-slow: 0ms;
611
+
612
+ /* Looping status indicators (spinners, indeterminate progress) stay
613
+ visible but calmer — slowed, never frozen: a stopped spinner reads as
614
+ "hung", not "loading". The one large motion we DO halt is the page-wide
615
+ skeleton sweep, which stops itself in _skeleton-shimmer.scss. */
616
+ --duration-loop-fast: 1400ms;
617
+ --duration-loop-slow: 2800ms;
565
618
  }
619
+
620
+ /* Kill one-shot motion only. Every entrance/transition animation is
621
+ token-driven, so zeroing the one-shot durations above already makes them
622
+ instant — loops must NOT be blanket-zeroed here or they freeze. */
566
623
  *, *::before, *::after {
567
624
  transition-duration: 0ms !important;
568
- animation-duration: 0ms !important;
569
- animation-iteration-count: 1 !important;
570
625
  }
571
626
  }
572
627
 
package/styles/ds.scss CHANGED
@@ -1,27 +1,33 @@
1
1
  // Public DS stylesheet entry. Consumers import once at the top of their styles.scss:
2
2
  // @use 'styles/ds';
3
3
  //
4
- // Bundles the default palette + theme for out-of-the-box rendering. Layers:
5
- // default/palette — Tier 1 concrete colours (ramps + HSL channels)
6
- // default/theme — Tier 2 semantic role → palette assignments + font families
7
- // tokens — Tier 3 geometry / typography scale / motion / component tokens
8
- // Advanced consumers can swap the palette/theme and keep tokens — global
9
- // side-effects (fonts, link) are then opt-in:
10
- // @use 'themes/X/palette'; @use 'themes/X/theme'; @use 'styles/tokens';
4
+ // Bundles the base palette (theme-independent ramps + channels + statics + fonts)
5
+ // and the theme activation (light + dark, sibling themes + OS-default media rule).
6
+ // Layers:
7
+ // base-palette — Tier 1a theme-independent primitives (ramps, channels,
8
+ // statics, shadow h/s, font families) emitted at :root
9
+ // theme-activation — Tier 1b + Tier 2: per-theme palette + role assignments,
10
+ // scoped to mutually-exclusive :root selectors
11
+ // tokens — Tier 3 geometry / typography scale / motion / component tokens
12
+ // Advanced consumers can compose themes individually instead of using ds:
13
+ // @use 'themes/base-palette'; @use 'styles/theme-activation'; @use 'styles/tokens';
11
14
  // @use 'styles/fonts'; @use 'styles/link'; …
12
15
 
13
- @forward '../themes/default/palette';
14
- @forward '../themes/default/theme';
16
+ @forward '../themes/base-palette';
17
+ @forward 'theme-activation';
15
18
  @forward 'tokens';
19
+ @forward 'breakpoints';
16
20
  @forward 'tokens-charts';
17
21
  @forward 'fonts';
18
22
  @forward 'reset';
19
23
  @forward 'typography';
20
24
  @forward 'link';
25
+ @forward 'ds-color';
21
26
  @forward 'layout-utils';
22
27
  @forward 'page-grid';
23
28
  @forward 'scrollbar';
24
29
  @forward 'icon-base';
25
30
  @forward 'dropdown-overlay';
26
31
  @forward 'toast-overlay';
32
+ @forward 'overlay-motion';
27
33
  @forward 'skeleton-shimmer';