@cognitap/radiant 0.0.3 → 0.0.5

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.
Files changed (118) hide show
  1. package/CHANGELOG.md +69 -0
  2. package/README.md +28 -15
  3. package/dist/library/Card.d.ts.map +1 -1
  4. package/dist/library/Card.js +8 -6
  5. package/dist/library/Card.js.map +1 -1
  6. package/dist/library/Checkbox.js +2 -2
  7. package/dist/library/Checkbox.js.map +1 -1
  8. package/dist/library/Collapsible.d.ts.map +1 -1
  9. package/dist/library/Collapsible.js +5 -4
  10. package/dist/library/Collapsible.js.map +1 -1
  11. package/dist/library/Dialog.d.ts.map +1 -1
  12. package/dist/library/Dialog.js +8 -6
  13. package/dist/library/Dialog.js.map +1 -1
  14. package/dist/library/Field.js +4 -4
  15. package/dist/library/Field.js.map +1 -1
  16. package/dist/library/Input.d.ts.map +1 -1
  17. package/dist/library/Input.js +4 -3
  18. package/dist/library/Input.js.map +1 -1
  19. package/dist/library/Link.d.ts.map +1 -1
  20. package/dist/library/Link.js +0 -1
  21. package/dist/library/Link.js.map +1 -1
  22. package/dist/library/RadioGroup.js +2 -2
  23. package/dist/library/RadioGroup.js.map +1 -1
  24. package/dist/library/ThemeScope.js +1 -1
  25. package/dist/library/ThemeScope.js.map +1 -1
  26. package/dist/library/actionStyles.js +2 -2
  27. package/dist/library/actionStyles.js.map +1 -1
  28. package/dist/library/cn.d.ts +2 -1
  29. package/dist/library/cn.d.ts.map +1 -1
  30. package/dist/library/cn.js +22 -1
  31. package/dist/library/cn.js.map +1 -1
  32. package/dist/library/color/colorFamilies.d.ts +3 -0
  33. package/dist/library/color/colorFamilies.d.ts.map +1 -0
  34. package/dist/library/color/colorFamilies.js +20 -0
  35. package/dist/library/color/colorFamilies.js.map +1 -0
  36. package/dist/library/color/generateColorWall.d.ts +54 -0
  37. package/dist/library/color/generateColorWall.d.ts.map +1 -0
  38. package/dist/library/color/generateColorWall.js +231 -0
  39. package/dist/library/color/generateColorWall.js.map +1 -0
  40. package/dist/library/color/index.d.ts +5 -0
  41. package/dist/library/color/index.d.ts.map +1 -0
  42. package/dist/library/color/index.js +3 -0
  43. package/dist/library/color/index.js.map +1 -0
  44. package/dist/library/color/oklch.d.ts +17 -0
  45. package/dist/library/color/oklch.d.ts.map +1 -0
  46. package/dist/library/color/oklch.js +79 -0
  47. package/dist/library/color/oklch.js.map +1 -0
  48. package/dist/library/color/recommendColorPalette.d.ts +65 -0
  49. package/dist/library/color/recommendColorPalette.d.ts.map +1 -0
  50. package/dist/library/color/recommendColorPalette.js +263 -0
  51. package/dist/library/color/recommendColorPalette.js.map +1 -0
  52. package/dist/library/index.d.ts +10 -2
  53. package/dist/library/index.d.ts.map +1 -1
  54. package/dist/library/index.js +5 -1
  55. package/dist/library/index.js.map +1 -1
  56. package/dist/library/styles.css +1 -1
  57. package/dist/library/themes/defineTheme.d.ts.map +1 -1
  58. package/dist/library/themes/defineTheme.js +5 -1
  59. package/dist/library/themes/defineTheme.js.map +1 -1
  60. package/dist/library/themes/index.d.ts +4 -0
  61. package/dist/library/themes/index.d.ts.map +1 -1
  62. package/dist/library/themes/index.js +2 -0
  63. package/dist/library/themes/index.js.map +1 -1
  64. package/dist/library/themes/themeDocument.d.ts +16 -0
  65. package/dist/library/themes/themeDocument.d.ts.map +1 -0
  66. package/dist/library/themes/themeDocument.js +332 -0
  67. package/dist/library/themes/themeDocument.js.map +1 -0
  68. package/dist/library/themes/themeDocumentTypes.d.ts +80 -0
  69. package/dist/library/themes/themeDocumentTypes.d.ts.map +1 -0
  70. package/dist/library/themes/themeDocumentTypes.js +2 -0
  71. package/dist/library/themes/themeDocumentTypes.js.map +1 -0
  72. package/dist/library/themes/tokens.d.ts +7 -0
  73. package/dist/library/themes/tokens.d.ts.map +1 -1
  74. package/dist/library/themes/tokens.js +99 -0
  75. package/dist/library/themes/tokens.js.map +1 -1
  76. package/dist/library/themes/updateThemeAppearance.d.ts +29 -0
  77. package/dist/library/themes/updateThemeAppearance.d.ts.map +1 -0
  78. package/dist/library/themes/updateThemeAppearance.js +138 -0
  79. package/dist/library/themes/updateThemeAppearance.js.map +1 -0
  80. package/dist/library/typography/index.d.ts +72 -0
  81. package/dist/library/typography/index.d.ts.map +1 -0
  82. package/dist/library/typography/index.js +160 -0
  83. package/dist/library/typography/index.js.map +1 -0
  84. package/dist/library/typography/types.d.ts +78 -0
  85. package/dist/library/typography/types.d.ts.map +1 -0
  86. package/dist/library/typography/types.js +2 -0
  87. package/dist/library/typography/types.js.map +1 -0
  88. package/docs/system.md +20 -0
  89. package/docs/theming.md +616 -0
  90. package/package.json +17 -5
  91. package/src/Card.tsx +8 -6
  92. package/src/Checkbox.tsx +2 -2
  93. package/src/Collapsible.tsx +5 -4
  94. package/src/Dialog.tsx +8 -6
  95. package/src/Field.tsx +4 -4
  96. package/src/Input.tsx +4 -3
  97. package/src/Link.tsx +0 -1
  98. package/src/RadioGroup.tsx +2 -2
  99. package/src/ThemeScope.tsx +1 -1
  100. package/src/actionStyles.ts +2 -2
  101. package/src/cn.ts +25 -1
  102. package/src/color/colorFamilies.ts +19 -0
  103. package/src/color/generateColorWall.ts +358 -0
  104. package/src/color/index.ts +11 -0
  105. package/src/color/oklch.ts +95 -0
  106. package/src/color/recommendColorPalette.ts +375 -0
  107. package/src/index.ts +40 -0
  108. package/src/styles.css +1 -0
  109. package/src/themes/baseline.css +131 -0
  110. package/src/themes/defineTheme.ts +5 -1
  111. package/src/themes/index.ts +25 -0
  112. package/src/themes/themeDocument.ts +370 -0
  113. package/src/themes/themeDocumentTypes.ts +88 -0
  114. package/src/themes/tokens.ts +137 -0
  115. package/src/themes/updateThemeAppearance.ts +172 -0
  116. package/src/typography/index.ts +199 -0
  117. package/src/typography/types.ts +92 -0
  118. package/src/typography.css +336 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/typography/index.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n freezeTree,\n typographyRoles,\n typographyStyles,\n typographyTokens\n} from '../themes/tokens.js'\nimport type {\n TypographyAssignment,\n TypographyFont,\n TypographyInput,\n TypographyProfile,\n TypographyProseRhythm,\n TypographyResult\n} from './types.js'\nexport type * from './types.js'\nexport { typographyRoles }\n\nconst inter = { family: 'Inter, system-ui, sans-serif', profile: 'inter' } as const\nconst serif = { family: '\"Source Serif 4\", Georgia, serif', profile: 'source-serif-4' } as const\nconst plex = { family: '\"IBM Plex Sans\", system-ui, sans-serif', profile: 'plex-sans' } as const\nconst mono = { family: '\"IBM Plex Mono\", ui-monospace, monospace', profile: 'plex-mono' } as const\nexport const typographyPresets = freezeTree({\n inter: { name: 'Inter', fonts: { body: inter, headings: inter, ui: inter, code: mono } },\n 'source-serif': {\n name: 'Source Serif 4 + Inter',\n fonts: { body: serif, headings: serif, ui: inter, code: mono }\n },\n plex: {\n name: 'Plex Sans + Plex Mono',\n fonts: { body: plex, headings: plex, ui: plex, code: mono }\n }\n} as const)\nconst assignments: readonly TypographyAssignment[] = ['body', 'headings', 'ui', 'code']\nconst profiles: readonly TypographyProfile[] = [\n 'inter',\n 'source-serif-4',\n 'plex-sans',\n 'plex-mono',\n 'manual'\n]\nconst bodyProfiles: Partial<Record<TypographyProfile, readonly [number, number, number]>> = {\n inter: [20, 1.6, 64],\n 'source-serif-4': [21, 1.65, 62],\n 'plex-sans': [20, 1.6, 62]\n}\nconst weights: Partial<Record<TypographyProfile, readonly [number, number]>> = {\n inter: [100, 900],\n 'source-serif-4': [200, 900],\n 'plex-sans': [100, 700],\n 'plex-mono': [100, 700]\n}\nfunction record(value: unknown, path: string): void {\n if (\n !value ||\n typeof value !== 'object' ||\n Array.isArray(value) ||\n ![Object.prototype, null].includes(Object.getPrototypeOf(value))\n )\n throw new TypeError(`${path} must be a plain object.`)\n}\nfunction keys(value: object, allowed: readonly string[], path: string) {\n for (const key of Object.keys(value))\n if (!allowed.includes(key)) throw new TypeError(`Unknown key: ${path}.${key}.`)\n}\nfunction number(value: unknown, min: number, max: number, path: string) {\n if (typeof value !== 'number' || !Number.isFinite(value) || value < min || value > max)\n throw new TypeError(`${path} must be a finite number from ${min} to ${max}.`)\n}\nfunction metrics(value: object, bounds: Record<string, readonly [number, number]>, path: string) {\n record(value, path)\n keys(value, Object.keys(bounds), path)\n for (const [key, item] of Object.entries(value))\n if (item !== undefined) number(item, ...bounds[key], `${path}.${key}`)\n}\n\n/** Pure, server-safe calculations. Input omits automatic metrics; output never loads a font. */\nexport function generateTypography(input: TypographyInput = {}): TypographyResult {\n record(input, 'typography')\n keys(input, ['preset', 'fonts', 'prose', 'ui', 'styles'], 'typography')\n const preset = input.preset === undefined ? 'inter' : input.preset\n if (typeof preset !== 'string' || !Object.hasOwn(typographyPresets, preset))\n throw new TypeError('Unknown typography.preset.')\n const fonts = { ...typographyPresets[preset].fonts } as Record<\n TypographyAssignment,\n TypographyFont\n >\n if (input.fonts !== undefined) {\n record(input.fonts, 'typography.fonts')\n keys(input.fonts, assignments, 'typography.fonts')\n for (const key of assignments) {\n const font = input.fonts[key]\n if (font === undefined) continue\n record(font, `typography.fonts.${key}`)\n keys(font, ['family', 'profile'], `typography.fonts.${key}`)\n if (\n typeof font.family !== 'string' ||\n !font.family.trim() ||\n /[;{}@]|url\\s*\\(/i.test(font.family) ||\n [...font.family].some(\n character => character.charCodeAt(0) < 32 || character.charCodeAt(0) === 127\n )\n )\n throw new TypeError(`typography.fonts.${key}.family must be a CSS font-family list.`)\n if (font.profile !== undefined && !profiles.includes(font.profile))\n throw new TypeError(`Unknown typography.fonts.${key}.profile.`)\n fonts[key] = { family: font.family, profile: font.profile ?? 'manual' }\n }\n }\n const manualProse = input.prose === undefined ? {} : input.prose,\n manualUI = input.ui === undefined ? {} : input.ui\n metrics(\n manualProse,\n {\n size: [12, 40],\n lineHeight: [1, 3],\n paragraphSpacing: [0, 4],\n measure: [20, 120],\n headingScale: [1.1, 1.5]\n },\n 'typography.prose'\n )\n metrics(manualUI, { size: [12, 32], lineHeight: [1, 3] }, 'typography.ui')\n const profile = bodyProfiles[fonts.body.profile ?? 'manual']\n const prose: TypographyProseRhythm = {\n size: profile?.[0] ?? 20,\n lineHeight: profile?.[1] ?? 1.65,\n measure: profile?.[2] ?? 64,\n paragraphSpacing: 1.25,\n headingScale: 1.25,\n ...defined(manualProse)\n }\n const ui = { size: 16, lineHeight: 1.5, ...defined(manualUI) }\n const styles = typographyStyles(prose, ui)\n const overrides = input.styles === undefined ? {} : input.styles\n record(overrides, 'typography.styles')\n keys(overrides, typographyRoles, 'typography.styles')\n for (const role of typographyRoles) {\n const override = overrides[role]\n if (override === undefined) continue\n record(override, `typography.styles.${role}`)\n const { assignment, ...numeric } = override\n if (assignment !== undefined && !assignments.includes(assignment))\n throw new TypeError(`Unknown typography.styles.${role}.assignment.`)\n metrics(\n numeric,\n {\n narrow: [8, 256],\n wide: [8, 512],\n weight: [1, 1000],\n lineHeight: [0.8, 3],\n tracking: [-0.2, 0.5],\n measure: [0, 120]\n },\n `typography.styles.${role}`\n )\n styles[role] = { ...styles[role], ...defined(override) }\n if (styles[role].wide < styles[role].narrow)\n throw new TypeError(`typography.styles.${role}.wide must be at least narrow.`)\n }\n const warnings: TypographyResult['warnings'][number][] = []\n for (const role of typographyRoles) {\n const s = styles[role],\n range = weights[fonts[s.assignment].profile ?? 'manual']\n if (range && (s.weight < range[0] || s.weight > range[1]))\n warnings.push({ role, requestedWeight: s.weight, supportedWeights: range })\n }\n return freezeTree({\n input: {\n preset,\n fonts,\n prose: defined(manualProse),\n ui: defined(manualUI),\n styles: Object.fromEntries(\n Object.entries(overrides)\n .filter(([, v]) => v !== undefined)\n .map(([k, v]) => [k, defined(v!)])\n )\n },\n prose,\n ui,\n styles,\n tokens: typographyTokens(\n styles,\n Object.fromEntries(assignments.map(key => [key, fonts[key].family])) as Record<\n TypographyAssignment,\n string\n >,\n prose.paragraphSpacing\n ),\n recommendations: {\n body: !!profile,\n ui: fonts.ui.profile === 'inter' || fonts.ui.profile === 'plex-sans'\n },\n warnings\n })\n}\nfunction defined<T extends object>(value: T): T {\n return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== undefined)) as T\n}\n"]}
@@ -0,0 +1,78 @@
1
+ /** Stable text styles; presentation is independent of the element's HTML semantics. */
2
+ export type TypographyRole = 'prose-title' | 'prose-heading' | 'prose-subheading' | 'prose-body' | 'prose-lead' | 'prose-small' | 'prose-quote' | 'ui-title' | 'ui-body' | 'ui-label' | 'ui-supporting' | 'ui-caption' | 'ui-metric' | 'ui-eyebrow' | 'display' | 'code';
3
+ export type TypographyAssignment = 'body' | 'headings' | 'ui' | 'code';
4
+ export type TypographyProfile = 'inter' | 'source-serif-4' | 'plex-sans' | 'plex-mono' | 'manual';
5
+ export type TypographyPreset = 'inter' | 'source-serif' | 'plex';
6
+ export interface TypographyFont {
7
+ /** CSS font-family list; choosing it never loads a font. */
8
+ readonly family: string;
9
+ /** Explicit provenance of a studied font. Omitted for an unfamiliar/manual font. */
10
+ readonly profile?: TypographyProfile;
11
+ }
12
+ export interface TypographyProseRhythm {
13
+ /** Reference pixels at a 16px root, emitted as rem. */
14
+ readonly size: number;
15
+ readonly lineHeight: number;
16
+ readonly paragraphSpacing: number;
17
+ readonly measure: number;
18
+ readonly headingScale: number;
19
+ }
20
+ export interface TypographyUIRhythm {
21
+ readonly size: number;
22
+ readonly lineHeight: number;
23
+ }
24
+ export interface TypographyStyle {
25
+ readonly assignment: TypographyAssignment;
26
+ /** Reference pixels at a 16px root. */
27
+ readonly narrow: number;
28
+ readonly wide: number;
29
+ readonly weight: number;
30
+ readonly lineHeight: number;
31
+ /** em; zero is deliberately not the old global negative tracking. */
32
+ readonly tracking: number;
33
+ /** ch; zero means the layout owns measure. */
34
+ readonly measure: number;
35
+ }
36
+ export interface TypographyInput {
37
+ readonly preset?: TypographyPreset;
38
+ readonly fonts?: Readonly<Partial<Record<TypographyAssignment, TypographyFont>>>;
39
+ /** Only manual settings belong here; omission keeps a profile-derived default live. */
40
+ readonly prose?: Partial<TypographyProseRhythm>;
41
+ readonly ui?: Partial<TypographyUIRhythm>;
42
+ readonly styles?: Readonly<Partial<Record<TypographyRole, Partial<TypographyStyle>>>>;
43
+ }
44
+ export interface TypographyRoleTokens {
45
+ readonly family: string;
46
+ readonly size: string;
47
+ readonly fluidSize: string;
48
+ readonly weight: number | string;
49
+ readonly lineHeight: string;
50
+ readonly letterSpacing: string;
51
+ readonly measure: string;
52
+ }
53
+ export interface TypographyTokens {
54
+ readonly roles: Readonly<Record<TypographyRole, TypographyRoleTokens>>;
55
+ readonly flow: {
56
+ readonly paragraph: string;
57
+ readonly headingBefore: string;
58
+ readonly headingAfter: string;
59
+ };
60
+ }
61
+ export interface TypographyResult {
62
+ /** Replayable input retains manual/automatic ownership rather than pinning computed defaults. */
63
+ readonly input: TypographyInput;
64
+ readonly prose: TypographyProseRhythm;
65
+ readonly ui: TypographyUIRhythm;
66
+ readonly styles: Readonly<Record<TypographyRole, TypographyStyle>>;
67
+ readonly tokens: TypographyTokens;
68
+ readonly recommendations: {
69
+ readonly body: boolean;
70
+ readonly ui: boolean;
71
+ };
72
+ readonly warnings: readonly {
73
+ readonly role: TypographyRole;
74
+ readonly requestedWeight: number;
75
+ readonly supportedWeights: readonly [number, number];
76
+ }[];
77
+ }
78
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/typography/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/typography/types.ts"],"names":[],"mappings":"","sourcesContent":["/** Stable text styles; presentation is independent of the element's HTML semantics. */\nexport type TypographyRole =\n | 'prose-title'\n | 'prose-heading'\n | 'prose-subheading'\n | 'prose-body'\n | 'prose-lead'\n | 'prose-small'\n | 'prose-quote'\n | 'ui-title'\n | 'ui-body'\n | 'ui-label'\n | 'ui-supporting'\n | 'ui-caption'\n | 'ui-metric'\n | 'ui-eyebrow'\n | 'display'\n | 'code'\n\nexport type TypographyAssignment = 'body' | 'headings' | 'ui' | 'code'\nexport type TypographyProfile = 'inter' | 'source-serif-4' | 'plex-sans' | 'plex-mono' | 'manual'\nexport type TypographyPreset = 'inter' | 'source-serif' | 'plex'\n\nexport interface TypographyFont {\n /** CSS font-family list; choosing it never loads a font. */\n readonly family: string\n /** Explicit provenance of a studied font. Omitted for an unfamiliar/manual font. */\n readonly profile?: TypographyProfile\n}\nexport interface TypographyProseRhythm {\n /** Reference pixels at a 16px root, emitted as rem. */\n readonly size: number\n readonly lineHeight: number\n readonly paragraphSpacing: number\n readonly measure: number\n readonly headingScale: number\n}\nexport interface TypographyUIRhythm {\n readonly size: number\n readonly lineHeight: number\n}\nexport interface TypographyStyle {\n readonly assignment: TypographyAssignment\n /** Reference pixels at a 16px root. */\n readonly narrow: number\n readonly wide: number\n readonly weight: number\n readonly lineHeight: number\n /** em; zero is deliberately not the old global negative tracking. */\n readonly tracking: number\n /** ch; zero means the layout owns measure. */\n readonly measure: number\n}\nexport interface TypographyInput {\n readonly preset?: TypographyPreset\n readonly fonts?: Readonly<Partial<Record<TypographyAssignment, TypographyFont>>>\n /** Only manual settings belong here; omission keeps a profile-derived default live. */\n readonly prose?: Partial<TypographyProseRhythm>\n readonly ui?: Partial<TypographyUIRhythm>\n readonly styles?: Readonly<Partial<Record<TypographyRole, Partial<TypographyStyle>>>>\n}\nexport interface TypographyRoleTokens {\n readonly family: string\n readonly size: string\n readonly fluidSize: string\n readonly weight: number | string\n readonly lineHeight: string\n readonly letterSpacing: string\n readonly measure: string\n}\nexport interface TypographyTokens {\n readonly roles: Readonly<Record<TypographyRole, TypographyRoleTokens>>\n readonly flow: {\n readonly paragraph: string\n readonly headingBefore: string\n readonly headingAfter: string\n }\n}\nexport interface TypographyResult {\n /** Replayable input retains manual/automatic ownership rather than pinning computed defaults. */\n readonly input: TypographyInput\n readonly prose: TypographyProseRhythm\n readonly ui: TypographyUIRhythm\n readonly styles: Readonly<Record<TypographyRole, TypographyStyle>>\n readonly tokens: TypographyTokens\n readonly recommendations: { readonly body: boolean; readonly ui: boolean }\n readonly warnings: readonly {\n readonly role: TypographyRole\n readonly requestedWeight: number\n readonly supportedWeights: readonly [number, number]\n }[]\n}\n"]}
package/docs/system.md CHANGED
@@ -50,6 +50,26 @@ fonts in your application; choosing a theme never downloads a font. The
50
50
  [theming reference](theming.md#define-and-apply-a-theme) owns the authoring
51
51
  example, token defaults, preset IDs, font families/weights and migration steps.
52
52
 
53
+ For public workshop editing, use the versioned `ThemeDocument` authoring API.
54
+ Its token sections compile through `defineTheme` into the same `ThemeScope`
55
+ contract. Section imports preserve unrelated settings and deliberate component
56
+ exceptions. See [portable documents and import semantics](theming.md#portable-workshop-documents). The pure
57
+ `generateTypography` interface and `typography.typesetting` recipe supply opt-in
58
+ font assignments, 16 text styles and independent prose/UI rhythms through the
59
+ same compiler. Use the semantic HTML hooks and local container documented under
60
+ [responsive typography](theming.md#responsive-typography); production component text consumes the shared UI roles. Control sizes retain
61
+ their font-size/geometry metrics, and inline links inherit their surrounding text.
62
+ The baseline UI roles bridge the legacy typography leaves; recipes and explicit
63
+ role values take ownership when supplied. The pure
64
+ `generateColorWall` interface supplies calibrated sRGB palette metadata through
65
+ `@cognitap/radiant/color`; see [color-wall inputs and output](theming.md#generate-a-color-wall). Use
66
+ `colorCalibrationPresets` for independent wall/ramp treatments (Classic, Balanced,
67
+ Expressive; Balanced by default), and `recommendColorPalette` to select a limited working set, map light/dark color and
68
+ canvas layers, and inspect named contrast pairs before compiling a theme.
69
+ Apply these together with bounded geometry using `updateThemeAppearance`; it
70
+ updates existing spacing, control and surface roles without removing authored
71
+ component exceptions. See [appearance settings](theming.md#apply-palette-spacing-and-surfaces-together).
72
+
53
73
  | Token group | Shared responsibility |
54
74
  | ------------ | ---------------------------------------------------------------------------------- |
55
75
  | `color` | Surface, foreground, borders, focus, invalid/disabled colors and action tone pairs |