@ids-group-ltd/ids-design-system 0.6.2 → 0.7.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,26 +1,175 @@
1
1
  // Type utility classes — ported from CLAUDE_DESIGN_DS/tokens.css §Type utilities.
2
2
  // These are GLOBAL by design — consumers apply them via class.
3
+ //
4
+ // Consumer-first token contract (same as components): every token-driven
5
+ // property is a longhand read through a public `--ds-t-<name>-*` custom
6
+ // property that FALLS BACK to the current semantic token, so a consumer can
7
+ // retune a single axis in a scope — e.g.
8
+ // `[data-brand] .t-h3 { --ds-t-h3-font-weight: var(--font-weight-bold) }` —
9
+ // without re-declaring the rest or forking the class. Structural box props
10
+ // (padding / margin / border-width / max-width / overflow) stay raw.
3
11
 
4
- .t-display { font: var(--font-weight-extrabold) var(--font-size-display) / var(--line-height-tight) var(--font-display); letter-spacing: var(--letter-spacing-tight); }
5
- .t-h1 { font: var(--font-weight-extrabold) var(--font-size-h1) / var(--line-height-tight) var(--font-heading); letter-spacing: var(--letter-spacing-tight); }
6
- .t-h2 { font: var(--font-weight-extrabold) var(--font-size-h2) / var(--line-height-snug) var(--font-heading); letter-spacing: var(--letter-spacing-snug); }
7
- .t-h3 { font: var(--font-weight-extrabold) var(--font-size-h3) / var(--line-height-snug) var(--font-heading); letter-spacing: var(--letter-spacing-snug); }
8
- .t-h4 { font: var(--font-weight-bold) var(--font-size-h4) / var(--line-height-snug) var(--font-heading); }
9
- .t-h5 { font: var(--font-weight-bold) var(--font-size-h5) / var(--line-height-snug) var(--font-heading); }
10
- .t-card-title { font: var(--font-weight-bold) var(--card-title-fs) / var(--line-height-snug) var(--font-heading); margin: 0; color: var(--text-primary); }
11
- .t-l { font: var(--font-weight-regular) var(--font-size-l) / var(--line-height-base) var(--font-sans); }
12
- .t-l-bold { font: var(--font-weight-bold) var(--font-size-l) / var(--line-height-base) var(--font-sans); }
13
- .t-m { font: var(--font-weight-regular) var(--font-size-m) / var(--line-height-base) var(--font-sans); }
14
- .t-m-bold { font: var(--font-weight-bold) var(--font-size-m) / var(--line-height-base) var(--font-sans); }
15
- .t-s { font: var(--font-weight-regular) var(--font-size-s) / var(--line-height-base) var(--font-sans); }
16
- .t-s-bold { font: var(--font-weight-bold) var(--font-size-s) / var(--line-height-base) var(--font-sans); }
17
- .t-xs { font: var(--font-weight-regular) var(--font-size-xs) / var(--line-height-base) var(--font-sans); }
18
- .t-xs-bold { font: var(--font-weight-bold) var(--font-size-xs) / var(--line-height-base) var(--font-sans); }
19
- .t-overline { font: var(--font-weight-bold) var(--font-size-2xs) / var(--line-height-base) var(--font-sans); letter-spacing: var(--letter-spacing-wider); text-transform: uppercase; color: var(--text-tertiary); }
20
- .t-caption { font: var(--font-weight-regular) var(--font-size-xs) / var(--line-height-base) var(--font-sans); color: var(--text-tertiary); }
21
- .t-mono { font: var(--font-weight-medium) var(--font-size-mono) / var(--line-height-base) var(--font-mono); }
22
- .t-mono-inline { font: var(--font-weight-regular) var(--font-size-mono) / 1 var(--font-mono); background: var(--surface-secondary); color: var(--text-primary); padding: 1px var(--space-1); border-radius: var(--radius-sm); }
23
- .t-mono-block { font: var(--font-weight-regular) var(--font-size-mono) / var(--line-height-loose) var(--font-mono); background: var(--surface-secondary); border: var(--border-width-default) solid var(--border-divider); border-radius: var(--radius-md); padding: var(--space-3) var(--space-4); max-width: 100%; overflow-x: auto; }
12
+ .t-display {
13
+ font-weight: var(--ds-t-display-font-weight, var(--font-weight-extrabold));
14
+ font-size: var(--ds-t-display-font-size, var(--font-size-display));
15
+ line-height: var(--ds-t-display-line-height, var(--line-height-tight));
16
+ font-family: var(--ds-t-display-font-family, var(--font-display));
17
+ letter-spacing: var(--ds-t-display-letter-spacing, var(--letter-spacing-tight));
18
+ }
19
+
20
+ .t-h1 {
21
+ font-weight: var(--ds-t-h1-font-weight, var(--font-weight-extrabold));
22
+ font-size: var(--ds-t-h1-font-size, var(--font-size-h1));
23
+ line-height: var(--ds-t-h1-line-height, var(--line-height-tight));
24
+ font-family: var(--ds-t-h1-font-family, var(--font-heading));
25
+ letter-spacing: var(--ds-t-h1-letter-spacing, var(--letter-spacing-tight));
26
+ }
27
+
28
+ .t-h2 {
29
+ font-weight: var(--ds-t-h2-font-weight, var(--font-weight-extrabold));
30
+ font-size: var(--ds-t-h2-font-size, var(--font-size-h2));
31
+ line-height: var(--ds-t-h2-line-height, var(--line-height-snug));
32
+ font-family: var(--ds-t-h2-font-family, var(--font-heading));
33
+ letter-spacing: var(--ds-t-h2-letter-spacing, var(--letter-spacing-snug));
34
+ }
35
+
36
+ .t-h3 {
37
+ font-weight: var(--ds-t-h3-font-weight, var(--font-weight-extrabold));
38
+ font-size: var(--ds-t-h3-font-size, var(--font-size-h3));
39
+ line-height: var(--ds-t-h3-line-height, var(--line-height-snug));
40
+ font-family: var(--ds-t-h3-font-family, var(--font-heading));
41
+ letter-spacing: var(--ds-t-h3-letter-spacing, var(--letter-spacing-snug));
42
+ }
43
+
44
+ .t-h4 {
45
+ font-weight: var(--ds-t-h4-font-weight, var(--font-weight-bold));
46
+ font-size: var(--ds-t-h4-font-size, var(--font-size-h4));
47
+ line-height: var(--ds-t-h4-line-height, var(--line-height-snug));
48
+ font-family: var(--ds-t-h4-font-family, var(--font-heading));
49
+ }
50
+
51
+ .t-h5 {
52
+ font-weight: var(--ds-t-h5-font-weight, var(--font-weight-bold));
53
+ font-size: var(--ds-t-h5-font-size, var(--font-size-h5));
54
+ line-height: var(--ds-t-h5-line-height, var(--line-height-snug));
55
+ font-family: var(--ds-t-h5-font-family, var(--font-heading));
56
+ }
57
+
58
+ .t-card-title {
59
+ font-weight: var(--ds-t-card-title-font-weight, var(--font-weight-bold));
60
+ font-size: var(--ds-t-card-title-font-size, var(--card-title-fs));
61
+ line-height: var(--ds-t-card-title-line-height, var(--line-height-snug));
62
+ font-family: var(--ds-t-card-title-font-family, var(--font-heading));
63
+ margin: 0;
64
+ color: var(--ds-t-card-title-color, var(--text-primary));
65
+ }
66
+
67
+ .t-l {
68
+ font-weight: var(--ds-t-l-font-weight, var(--font-weight-regular));
69
+ font-size: var(--ds-t-l-font-size, var(--font-size-l));
70
+ line-height: var(--ds-t-l-line-height, var(--line-height-base));
71
+ font-family: var(--ds-t-l-font-family, var(--font-sans));
72
+ }
73
+
74
+ .t-l-bold {
75
+ font-weight: var(--ds-t-l-bold-font-weight, var(--font-weight-bold));
76
+ font-size: var(--ds-t-l-bold-font-size, var(--font-size-l));
77
+ line-height: var(--ds-t-l-bold-line-height, var(--line-height-base));
78
+ font-family: var(--ds-t-l-bold-font-family, var(--font-sans));
79
+ }
80
+
81
+ .t-m {
82
+ font-weight: var(--ds-t-m-font-weight, var(--font-weight-regular));
83
+ font-size: var(--ds-t-m-font-size, var(--font-size-m));
84
+ line-height: var(--ds-t-m-line-height, var(--line-height-base));
85
+ font-family: var(--ds-t-m-font-family, var(--font-sans));
86
+ }
87
+
88
+ .t-m-bold {
89
+ font-weight: var(--ds-t-m-bold-font-weight, var(--font-weight-bold));
90
+ font-size: var(--ds-t-m-bold-font-size, var(--font-size-m));
91
+ line-height: var(--ds-t-m-bold-line-height, var(--line-height-base));
92
+ font-family: var(--ds-t-m-bold-font-family, var(--font-sans));
93
+ }
94
+
95
+ .t-s {
96
+ font-weight: var(--ds-t-s-font-weight, var(--font-weight-regular));
97
+ font-size: var(--ds-t-s-font-size, var(--font-size-s));
98
+ line-height: var(--ds-t-s-line-height, var(--line-height-base));
99
+ font-family: var(--ds-t-s-font-family, var(--font-sans));
100
+ }
101
+
102
+ .t-s-bold {
103
+ font-weight: var(--ds-t-s-bold-font-weight, var(--font-weight-bold));
104
+ font-size: var(--ds-t-s-bold-font-size, var(--font-size-s));
105
+ line-height: var(--ds-t-s-bold-line-height, var(--line-height-base));
106
+ font-family: var(--ds-t-s-bold-font-family, var(--font-sans));
107
+ }
108
+
109
+ .t-xs {
110
+ font-weight: var(--ds-t-xs-font-weight, var(--font-weight-regular));
111
+ font-size: var(--ds-t-xs-font-size, var(--font-size-xs));
112
+ line-height: var(--ds-t-xs-line-height, var(--line-height-base));
113
+ font-family: var(--ds-t-xs-font-family, var(--font-sans));
114
+ }
115
+
116
+ .t-xs-bold {
117
+ font-weight: var(--ds-t-xs-bold-font-weight, var(--font-weight-bold));
118
+ font-size: var(--ds-t-xs-bold-font-size, var(--font-size-xs));
119
+ line-height: var(--ds-t-xs-bold-line-height, var(--line-height-base));
120
+ font-family: var(--ds-t-xs-bold-font-family, var(--font-sans));
121
+ }
122
+
123
+ .t-overline {
124
+ font-weight: var(--ds-t-overline-font-weight, var(--font-weight-bold));
125
+ font-size: var(--ds-t-overline-font-size, var(--font-size-2xs));
126
+ line-height: var(--ds-t-overline-line-height, var(--line-height-base));
127
+ font-family: var(--ds-t-overline-font-family, var(--font-sans));
128
+ letter-spacing: var(--ds-t-overline-letter-spacing, var(--letter-spacing-wider));
129
+ text-transform: var(--ds-t-overline-text-transform, uppercase);
130
+ color: var(--ds-t-overline-color, var(--text-tertiary));
131
+ }
132
+
133
+ .t-caption {
134
+ font-weight: var(--ds-t-caption-font-weight, var(--font-weight-regular));
135
+ font-size: var(--ds-t-caption-font-size, var(--font-size-xs));
136
+ line-height: var(--ds-t-caption-line-height, var(--line-height-base));
137
+ font-family: var(--ds-t-caption-font-family, var(--font-sans));
138
+ color: var(--ds-t-caption-color, var(--text-tertiary));
139
+ }
140
+
141
+ .t-mono {
142
+ font-weight: var(--ds-t-mono-font-weight, var(--font-weight-medium));
143
+ font-size: var(--ds-t-mono-font-size, var(--font-size-mono));
144
+ line-height: var(--ds-t-mono-line-height, var(--line-height-base));
145
+ font-family: var(--ds-t-mono-font-family, var(--font-mono));
146
+ }
147
+
148
+ .t-mono-inline {
149
+ font-weight: var(--ds-t-mono-inline-font-weight, var(--font-weight-regular));
150
+ font-size: var(--ds-t-mono-inline-font-size, var(--font-size-mono));
151
+ line-height: var(--ds-t-mono-inline-line-height, 1);
152
+ font-family: var(--ds-t-mono-inline-font-family, var(--font-mono));
153
+ color: var(--ds-t-mono-inline-color, var(--text-primary));
154
+ background-color: var(--ds-t-mono-inline-bg-color, var(--surface-secondary));
155
+ padding: 1px var(--space-1);
156
+ border-radius: var(--ds-t-mono-inline-radius, var(--radius-sm));
157
+ }
158
+
159
+ .t-mono-block {
160
+ font-weight: var(--ds-t-mono-block-font-weight, var(--font-weight-regular));
161
+ font-size: var(--ds-t-mono-block-font-size, var(--font-size-mono));
162
+ line-height: var(--ds-t-mono-block-line-height, var(--line-height-loose));
163
+ font-family: var(--ds-t-mono-block-font-family, var(--font-mono));
164
+ background-color: var(--ds-t-mono-block-bg-color, var(--surface-secondary));
165
+ border-width: var(--border-width-default);
166
+ border-style: solid;
167
+ border-color: var(--ds-t-mono-block-border-color, var(--border-divider));
168
+ border-radius: var(--ds-t-mono-block-radius, var(--radius-md));
169
+ padding: var(--space-3) var(--space-4);
170
+ max-width: 100%;
171
+ overflow-x: auto;
172
+ }
24
173
 
25
174
  .sr-only {
26
175
  position: absolute !important;
package/themes/README.md CHANGED
@@ -4,11 +4,11 @@ Colour is layered in three concerns: a **base palette** (theme-independent primi
4
4
 
5
5
  ## Architecture: three layers
6
6
 
7
- | Layer | Lives in | Examples | Applied at |
8
- | ------------------------------ | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ----------------------------------- |
9
- | **Base palette** (primitives) | `themes/_base-palette.scss` | `--blue-600`, `--cool-gray-*`, `--brand-gray-*`, `--red-h/s/l`, `--static-white`, fonts, `--shadow-tint-h/s` | `:root` (theme-independent) |
10
- | **Theme** (role map) | `themes/_semantic.scss` + `themes/<t>/_*.scss` | `--primary`, `--surface-canvas`, `--text-primary`, the `--neutral-*` slot, `--focus-ring` | `:root` (light) / `:root[data-theme='dark']` |
11
- | **Component / scale** | `styles/_tokens.scss`, `*.component.scss` | `--space-*`, `--radius-*`, `--ds-button-bg-color`, `--duration-fast` | `:root` (theme-independent) |
7
+ | Layer | Lives in | Examples | Applied at |
8
+ | ----------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------- |
9
+ | **Base palette** (primitives) | `themes/_base-palette.scss` | `--blue-600`, `--cool-gray-*`, `--brand-gray-*`, `--red-h/s/l`, `--static-white`, fonts, `--shadow-tint-h/s` | `:root` (theme-independent) |
10
+ | **Theme** (role map) | `themes/_semantic.scss` + `themes/<t>/_*.scss` | `--primary`, `--surface-canvas`, `--text-primary`, the `--neutral-*` slot, `--focus-ring` | `:root` (light) / `:root[data-theme='dark']` |
11
+ | **Component / scale** | `styles/_tokens.scss`, `*.component.scss` | `--space-*`, `--radius-*`, `--ds-button-bg-color`, `--duration-fast` | `:root` (theme-independent) |
12
12
 
13
13
  **Hard rule:** components NEVER consume base-palette primitives directly. `var(--blue-600)` inside `button.component.scss` is a bug — use a Tier-2 role (`--primary`, `--text-secondary`) or a component token.
14
14
 
@@ -33,8 +33,12 @@ Colour is layered in three concerns: a **base palette** (theme-independent primi
33
33
  - `<html data-theme="light">` — also light (explicit; same as the default)
34
34
 
35
35
  ```scss
36
- :root { @include light.theme; } // default
37
- :root[data-theme='dark'] { @include dark.theme; } // opt-in (complete set → fully wins)
36
+ :root {
37
+ @include light.theme;
38
+ } // default
39
+ :root[data-theme='dark'] {
40
+ @include dark.theme;
41
+ } // opt-in (complete set → fully wins)
38
42
  ```
39
43
 
40
44
  There is **no automatic `prefers-color-scheme` switch** — light is deterministic by default. To follow the OS, opt in at the app root with `provideDsTheme`: