@rt-tools/ui-kit 0.0.16 → 0.0.20

package/src/lib/ui-kit/table/components/table-base-cell/table-base-cell.component.scss

@@ -21,20 +21,18 @@ $base-cell: (
         icon-size: 1rem,
     ),
     copy-button-complete: (
-        color: var(--clr-black-100),
+        color: var(--rt-text-base-strong),
     ),
 );
 
 :host {
-    height: 100%;
-    width: 100%;
-
+    position: relative;
     display: flex;
+    width: 100%;
+    height: 100%;
     align-items: center;
     gap: var(--rt-table-base-cell-host-gap);
 
-    position: relative;
-
     @each $element, $elements in $base-cell {
         @each $style-token, $value in $elements {
             #{mixins.generateCssVar('table-base-cell', #{$element}, #{$style-token})}: #{$value};
@@ -49,16 +47,16 @@ $base-cell: (
         }
 
         &__title {
-            width: 100%;
             display: table;
+            width: 100%;
             table-layout: fixed;
 
             &-text {
+                overflow: hidden;
                 width: 100%;
                 padding: var(--rt-table-base-cell-title-padding);
-                white-space: nowrap;
-                overflow: hidden;
                 text-overflow: ellipsis;
+                white-space: nowrap;
             }
 
             &--align {
@@ -90,14 +88,15 @@ $base-cell: (
 
         &__copy-button {
             position: absolute;
-            visibility: hidden;
             padding: var(--rt-table-base-cell-copy-button-padding);
             background-color: var(--rt-table-base-cell-copy-button-background-color);
+            visibility: hidden;
 
             &--position {
                 &--left {
                     left: var(--rt-table-base-cell-copy-button-position-left);
                 }
+
                 &--right {
                     right: var(--rt-table-base-cell-copy-button-position-right);
                 }

package/src/lib/ui-kit/table/components/table-config-aside/rt-table-config-aside.component.scss

@@ -1,4 +1,4 @@
 :host {
-    height: 100%;
     width: 100%;
+    height: 100%;
 }

package/src/lib/ui-kit/table/components/table-container/table-container.component.scss

@@ -6,13 +6,13 @@ $table-container: (
         margin: 0 0.65rem,
     ),
     selector-label: (
-        color: var(--clr-black-60),
+        color: var(--rt-text-base-secondary),
     ),
     selector-label-hover: (
-        color: var(--clr-black-100),
+        color: var(--rt-text-base-strong),
     ),
     selector-counter: (
-        color: var(--clr-black-60),
+        color: var(--rt-text-base-secondary),
         font-size: 0.875rem,
     ),
     toolbar-mobile: (
@@ -26,7 +26,7 @@ $table-container: (
     ),
     toolbar-actions-divider: (
         height: 2rem,
-        border-left: 1px solid var(--clr-gray-20),
+        border-left: 1px solid var(--rt-border-neutral-divider),
     ),
     toolbar-search: (
         width: 22rem,
@@ -44,24 +44,26 @@ $table-container: (
 );
 
 :host {
-    width: 100%;
     position: relative;
     display: flex;
     overflow: hidden;
+    width: 100%;
 
     // initial table container scrollbar styles
     ::-webkit-scrollbar-track:hover {
-        border: 1px solid var(--clr-gray-10);
+        border: 1px solid var(--rt-border-neutral-subtle);
     }
+
     ::-webkit-scrollbar-thumb {
-        background: var(--clr-gray-20);
         border: 3px solid transparent;
-        border-radius: 6px;
+        border-radius: var(--rt-radius-sm);
+        background: var(--rt-scrollbar-thumb);
         background-clip: content-box;
     }
+
     ::-webkit-scrollbar-thumb:hover {
-        background: var(--clr-black-40);
         border: 2px solid transparent;
+        background: var(--rt-scrollbar-thumb-hover);
         background-clip: content-box;
     }
 
@@ -94,10 +96,10 @@ $table-container: (
     .table-container {
         &__selectors {
             display: flex;
-            justify-content: flex-start;
-            align-items: center;
-            flex-grow: 1;
             width: 100%;
+            flex-grow: 1;
+            align-items: center;
+            justify-content: flex-start;
             margin: var(--rt-table-container-selectors-margin);
             gap: var(--rt-table-container-toolbar-actions-gap);
 
@@ -110,16 +112,16 @@ $table-container: (
             }
 
             &-counter {
-                font-size: var(--rt-table-container-selector-counter-font-size);
                 color: var(--rt-table-container-selector-counter-color);
+                font-size: var(--rt-table-container-selector-counter-font-size);
             }
         }
 
         &__toolbar {
-            width: 100%;
             display: flex;
-            justify-content: flex-end;
+            width: 100%;
             align-items: center;
+            justify-content: flex-end;
 
             &-actions {
                 display: flex;
@@ -143,9 +145,9 @@ $table-container: (
         }
 
         &__content {
+            overflow: auto;
             width: 100%;
             flex-grow: 1;
-            overflow: auto;
             padding: var(--rt-table-container-content-padding);
 
             &::-webkit-scrollbar {
@@ -155,12 +157,12 @@ $table-container: (
         }
 
         &__placeholder {
+            display: flex;
             width: var(--rt-table-container-placeholder-width);
             height: var(--rt-table-container-placeholder-height);
-            display: flex;
             flex-direction: column;
-            justify-content: center;
             align-items: center;
+            justify-content: center;
             gap: var(--rt-table-container-placeholder-gap);
 
             &-icon {
@@ -203,8 +205,8 @@ $table-container: (
 
                 &-search {
                     width: 100%;
-                    grid-row: 1;
                     justify-content: center;
+                    grid-row: 1;
                 }
             }
         }

package/src/lib/ui-kit/table/components/table-header-cell/table-header-cell.component.scss

@@ -12,17 +12,17 @@ $header-cell: (
     ),
     icon: (
         margin: 0 0 0 1rem,
-        color: var(--clr-black-40),
+        color: var(--rt-text-base-disabled),
     ),
     icon-active: (
-        color: var(--clr-black-100),
+        color: var(--rt-text-base-strong),
     ),
 );
 
 :host {
     display: flex;
-    justify-content: space-between;
     align-items: center;
+    justify-content: space-between;
     cursor: pointer;
 
     @each $element, $elements in $header-cell {
@@ -38,8 +38,8 @@ $header-cell: (
     }
 
     .header-cell-label {
-        flex-grow: 1;
         display: flex;
+        flex-grow: 1;
         align-items: center;
         gap: var(--rt-table-header-cell-label-gap);
 
@@ -64,9 +64,9 @@ $header-cell: (
         }
 
         &__text {
-            white-space: nowrap;
             overflow: hidden;
             text-overflow: ellipsis;
+            white-space: nowrap;
         }
 
         &__suffix {
@@ -85,10 +85,9 @@ $header-cell: (
     .header-cell-icons {
         display: flex;
         flex-direction: column;
-        justify-content: center;
         align-items: center;
+        justify-content: center;
         margin: var(--rt-table-header-cell-icon-margin);
-
         visibility: hidden;
 
         &--active {
@@ -98,12 +97,12 @@ $header-cell: (
         &__icon {
             width: 0;
             height: 0;
-            border-left: 3px solid transparent;
             border-right: 3px solid transparent;
             border-bottom: 5.2px solid var(--rt-table-header-cell-icon-color);
+            border-left: 3px solid transparent;
 
             &--second {
-                margin-top: 2px;
+                margin-top: var(--rt-spacing-2);
                 transform: scaleY(-1);
             }
 

package/src/lib/ui-kit/table/components/table-header-filter-cell/table-header-filter-cell.component.scss

@@ -1,9 +1,9 @@
 :host {
-    width: 100%;
     display: flex;
-    justify-content: flex-start;
+    width: 100%;
     align-items: center;
-    gap: 0.5rem;
+    justify-content: flex-start;
+    gap: var(--rt-spacing-8);
 
     .table-header-cell-filter-input {
         width: 100%;

package/src/lib/ui-kit/table/dynamic-list.component.scss

@@ -1,6 +1,6 @@
 :host {
-    width: 100%;
-    height: 100%;
     display: flex;
     overflow: hidden;
+    width: 100%;
+    height: 100%;
 }

package/src/lib/ui-kit/table/stories/dynamic-list/test-dynamic-list.component.scss

@@ -1,7 +1,7 @@
 :host {
+    display: flex;
     width: 100vw;
     height: 100vh;
-    display: flex;
     flex-direction: column;
     margin: -1rem;
 

package/src/lib/ui-kit/table/stories/pagination/test-pagination-component.scss

@@ -1,16 +1,16 @@
 :host {
+    position: relative;
+    display: flex;
+    overflow: hidden;
     width: 100vw;
     height: 100vh;
-    display: flex;
     flex-direction: column;
     margin: -1rem;
-    position: relative;
-    overflow: hidden;
 
     .pagination {
-        width: 100%;
         position: absolute;
         top: 0;
         left: 0;
+        width: 100%;
     }
 }

package/src/lib/ui-kit/table/stories/table/test-table-component.scss

@@ -1,7 +1,7 @@
 :host {
+    display: flex;
     width: 100vw;
     height: 100vh;
-    display: flex;
     flex-direction: column;
     margin: -1rem;
 }

package/src/lib/ui-kit/toggle/rtui-toggle.component.scss

@@ -12,31 +12,31 @@ $toggle: (
     ),
     toggle: (
         border-radius: 6.25rem,
-        background-color: var(--clr-gray-5),
-        box-shadow: inset 0 0 0.125rem 0.0625rem rgba(0, 0, 0, 0.05),
+        background-color: var(--rt-bg-base-subtle),
+        box-shadow: inset 0 0 0.125rem 0.0625rem rgb(0 0 0 / 5%),
     ),
     toggle-check: (
-        box-shadow: inset 0 0 0 1.25rem var(--clr-black-80),
+        box-shadow: inset 0 0 0 1.25rem var(--rt-control-checked),
     ),
     toggle-switch: (
         border-radius: 2.25rem,
-        background-color: var(--clr-white-100),
-        box-shadow: 0 0.0625rem 0.125rem rgba(0, 0, 0, 0.2),
+        background-color: var(--rt-control-thumb),
+        box-shadow: 0 0.0625rem 0.125rem rgb(0 0 0 / 20%),
     ),
     toggle-track: (
-        background-color: var(--clr-gray-10),
+        background-color: var(--rt-control-track),
         border-radius: 2.5rem,
-        border: 0.0625rem solid var(--clr-gray-15),
+        border: 0.0625rem solid var(--rt-border-neutral-medium),
     ),
     label: (
-        color: var(--clr-black-60),
+        color: var(--rt-text-base-secondary),
         font-size: 0.875rem,
     ),
     label-active: (
-        color: var(--clr-black-100),
+        color: var(--rt-text-base-strong),
     ),
     label-hover: (
-        color: var(--clr-black-100),
+        color: var(--rt-text-base-strong),
         cursor: pointer,
     ),
 );
@@ -79,12 +79,12 @@ $toggle: (
 
         .rtui-toggle {
             position: relative;
+            overflow: hidden;
             width: 3.125rem;
             min-width: 3.125rem;
             height: 1.875rem;
             border-radius: var(--rt-toggle-toggle-border-radius);
             background-color: var(--rt-toggle-toggle-background-color);
-            overflow: hidden;
             box-shadow: var(--rt-toggle-toggle-box-shadow);
             cursor: pointer;
 
@@ -103,36 +103,30 @@ $toggle: (
                     right: 0.125rem;
                     left: 1.375rem;
                     transition: 0.35s cubic-bezier(0.785, 0.135, 0.15, 0.86);
-                    transition-property: left, right;
                     transition-delay: 0.05s, 0s;
+                    transition-property: left, right;
                 }
             }
 
             &__switch {
                 position: absolute;
-                left: 0.125rem;
-                top: 0.125rem;
-                bottom: 0.125rem;
-                right: 1.375rem;
-                background-color: var(--rt-toggle-toggle-switch-background-color);
-                border-radius: var(--rt-toggle-toggle-switch-border-radius);
                 z-index: 1;
+                border-radius: var(--rt-toggle-toggle-switch-border-radius);
+                background-color: var(--rt-toggle-toggle-switch-background-color);
+                box-shadow: var(--rt-toggle-toggle-switch-box-shadow);
+                inset: 0.125rem 1.375rem 0.125rem 0.125rem;
                 transition: 0.35s cubic-bezier(0.785, 0.135, 0.15, 0.86);
-                transition-property: left, right;
                 transition-delay: 0s, 0.05s;
-                box-shadow: var(--rt-toggle-toggle-switch-box-shadow);
+                transition-property: left, right;
             }
 
             &__track {
                 position: absolute;
-                left: 0;
-                top: 0;
-                right: 0;
-                bottom: 0;
-                transition: 0.35s cubic-bezier(0.785, 0.135, 0.15, 0.86);
-                background-color: var(--rt-toggle-toggle-track-background-color);
-                border-radius: var(--rt-toggle-toggle-track-border-radius);
                 border: var(--rt-toggle-toggle-track-border);
+                border-radius: var(--rt-toggle-toggle-track-border-radius);
+                background-color: var(--rt-toggle-toggle-track-background-color);
+                inset: 0;
+                transition: 0.35s cubic-bezier(0.785, 0.135, 0.15, 0.86);
             }
 
             // modify
@@ -148,8 +142,8 @@ $toggle: (
                 }
 
                 .rtui-toggle__check:checked ~ .rtui-toggle__switch {
-                    left: 1.625rem;
                     right: 0.125rem;
+                    left: 1.625rem;
                 }
             }
 
@@ -165,8 +159,8 @@ $toggle: (
                 }
 
                 .rtui-toggle__check:checked ~ .rtui-toggle__switch {
-                    left: 0.75rem;
                     right: 0.125rem;
+                    left: 0.75rem;
                 }
             }
         }

package/src/lib/ui-kit/toggle/stories/component/test-toggle.component.scss

@@ -1,9 +1,9 @@
 :host {
+    display: flex;
     width: 100vw;
     height: 100vh;
-    display: flex;
     flex-direction: column;
-    justify-content: center;
     align-items: center;
+    justify-content: center;
     margin: -1rem;
 }

package/src/lib/ui-kit/toolbar/toolbar.component.scss

@@ -13,7 +13,7 @@ $toolbar: (
     bars: (
         border-bottom-style: solid,
         border-bottom-width: 1px,
-        border-bottom-color: var(--clr-black-20),
+        border-bottom-color: var(--rt-border-neutral-default),
     ),
     bars-left: (
         width: fit-content,
@@ -40,9 +40,8 @@ $toolbar: (
         --mat-toolbar-standard-height: var(--rt-toolbar-body-mobile-height);
         --mdc-secondary-navigation-tab-container-height: var(--rt-toolbar-body-mobile-height);
 
-        min-height: var(--rt-toolbar-body-mobile-height);
         height: var(--rt-toolbar-body-mobile-height);
-
+        min-height: var(--rt-toolbar-body-mobile-height);
         padding: var(--rt-toolbar-body-padding);
         background-color: transparent;
 
@@ -61,25 +60,21 @@ $toolbar: (
 
         .bars {
             position: relative;
-
             display: flex;
             width: 100%;
             height: 100%;
-
+            border-bottom: var(--rt-toolbar-bars-border-bottom-width) var(--rt-toolbar-bars-border-bottom-style)
+                var(--rt-toolbar-bars-border-bottom-color);
             background-color: var(--rt-toolbar-body-background-color);
 
-            border-bottom-style: var(--rt-toolbar-bars-border-bottom-style);
-            border-bottom-width: var(--rt-toolbar-bars-border-bottom-width);
-            border-bottom-color: var(--rt-toolbar-bars-border-bottom-color);
-
             &__bar {
                 &--left {
                     width: var(--rt-toolbar-bars-left-width);
                 }
 
                 &--center {
-                    width: var(--rt-toolbar-bars-center-width);
                     overflow: hidden;
+                    width: var(--rt-toolbar-bars-center-width);
                 }
 
                 &--right {
@@ -89,8 +84,8 @@ $toolbar: (
                 &--left,
                 &--center,
                 &--right {
-                    height: 100%;
                     display: flex;
+                    height: 100%;
                     align-items: center;
                 }
             }

package/src/styles/TOKENS.md

@@ -0,0 +1,121 @@
+# rt-tools CSS Design Tokens (v2)
+
+GMT-style three-tier CSS custom property system. **Full documentation lives in
+Storybook**: Foundation/Design Tokens/{Overview, Colors, Semantic, Spacing},
+Foundation/Theming, How to use tokens (`projects/ui-kit/docs/*.mdx`).
+
+```
+Tier 1  primitives   --rt-color-*                      base/_tokens.scss
+Tier 2  semantic     --rt-{bg,text,icon,border}-*      base/_tokens.scss (light-dark())
+Tier 3  component    --rt-<component>-<el>-<token>     per-component SCSS maps
+```
+
+Quick facts:
+
+- Light default; `.rt-dark` global switch; `data-rt-theme` nested local contexts;
+  `.rt-theme-auto` follows the OS. Runtime: `RtThemeService` / `RtThemeDirective`.
+- Angular Material hybrid: semantic tokens are `var(--mat-sys-*, light-dark(…))`
+  fallback chains. Opt out: `@use '...main' with ($tokens-use-material: false)`.
+- Accent roles `{primary,success,warning,danger,info,neutral}`,
+  steps `{subtle,solid,hover,disabled}` (simplified vs GMT).
+- Accent indirection: the accent semantic tier derives from `--rt-color-{role}-{0..100}`
+  ramps (`{primary,info,success,warning,danger,brand}`). Custom brand palettes
+  override only those rows — see **Custom color schemes** below.
+- Foundations: `--rt-spacing-{0..64}` (px-named, rem values), `--rt-radius-*`,
+  `--rt-font-*`, `--rt-shadow-*`, `--rt-transition-*`, `--rt-z-index-*`.
+- Prebuilt CSS for non-sass consumers: `dist/ui-kit/styles/tokens.css`
+  (`pnpm run build:tokens`).
+- Figma parity: collections `core` (`rt/color/*`) and `theme` (`rt/{bg,text,icon,border}/*`,
+  Light/Dark modes) in the “RT-Tools UI Kit” file mirror these names 1:1.
+- App-defined (never set by the kit): `--font-default`, mat theme colors.
+
+## Component theming API (Tier 3 contract)
+
+Tier-3 vars are split into a **public theming API** and **internal implementation details**.
+Only the public set is a compatibility promise; internal vars may be renamed or stop being
+emitted in the next major release.
+
+**Public** (override these from your app):
+
+1. Every var matching `--rt-<component>-*-{color,background-color,bg,shadow,indicator}` —
+   the color surface of each component.
+2. Documented size hooks proven by consumers:
+   `--rt-table-row-height`, `--rt-toolbar-body-height`, `--rt-toolbar-body-mobile-height`,
+   `--rt-aside-error-box-height`, `--rt-aside-host-width`,
+   `--rt-image-upload-host-min-height`, `--rt-image-upload-image-container-image-max-height`.
+
+**Internal** (everything else): layout paddings/margins/gaps/font-sizes generated from SCSS maps.
+They currently _are_ emitted (≈380 vars total, ~14% actually themed by consumers) — in the next
+major the internal set stops being emitted and gets inlined into rules.
+
+### `:root` vs `:host` emission — override semantics
+
+- Vars emitted at **`:root`** (global stylesheets + `ViewEncapsulation.None` components like
+  aside-panel) are overridable from any ancestor scope: `.dark-mode { --rt-aside-host-background-color: …; }`.
+- Vars emitted at **`:host`** are set on the element itself and **win over inherited values** —
+  consumers must target the element (`rtui-toolbar { --rt-toolbar-body-height: … !important; }`).
+  This asymmetry is why some consumers need `!important` for toolbar/toggle but not for aside/table.
+- Planned unification (major): emit defaults via `var(--override, default)` indirection so all
+  components are ancestor-overridable without `!important`.
+
+## Buttons: legacy vs rtui
+
+`.c-button` (\_button.scss) is **deprecated**; `.rtui-btn` (\_rtui_button.scss) is the system.
+Both stay until the next major because consumers apply `.c-button` classes and override
+`--rt-button-*` directly. Migration map:
+
+| legacy `.c-button`        | `.rtui-btn`                                                           |
+| ------------------------- | --------------------------------------------------------------------- |
+| `--fill-green` / `-light` | `rtui-btn-success` / `-light`                                         |
+| `--fill-red` / `-light`   | `rtui-btn-error` / `-light`                                           |
+| `--fill-blue`             | `rtui-btn-accent-light`                                               |
+| `--fill-base/black/gray`  | `rtui-btn-secondary` (+`-light`)                                      |
+| `--outline-{blue,base}`   | `rtui-btn-{accent,secondary}-outline`                                 |
+| `--txt-*`, `--fab`        | no equivalent yet — needs a text/icon appearance in `.rtui-btn` first |
+| `--size-{sm,md,l}`        | `rtui-btn-{sm,md,lg}` (+`-full`)                                      |
+
+## Material bridge
+
+All **global** Material/CDK overrides live in `styles/components/_material-bridge.scss`
+(single file to review on a Material upgrade). Component-scoped piercings stay with their
+component; the bridge header keeps the inventory of those locations.
+
+## Custom color schemes (brand palettes)
+
+The accent semantic tier never hardcodes color — it derives from an indirection layer,
+the **accent-role ramps** `--rt-color-{role}-{0..100}` for
+`{primary, info, success, warning, danger, brand}`. A custom brand palette overrides
+**only** those rows; the kit derives `--rt-{bg,text,icon,border}-accent-*`,
+hover/subtle/disabled and `--rt-border-focus` from them. The block is scoped to
+`[data-rt-scheme="<name>"]` on `<html>`, set raw → it wins over `--mat-sys-*`.
+
+```scss
+@use '@rt-tools/ui-kit/src/styles/main' as rt;
+@include rt.color-scheme(
+    'teal',
+    (
+        primary: (
+            20: #b3e3e1,
+            40: #5cb8b5,
+            60: #1a9d99,
+            100: #008582,
+        ),
+        brand: (
+            20: #e8e8e8,
+            100: #008582,
+        ),
+    )
+);
+```
+
+```typescript
+// runtime twin (browser-only); prefer the Sass path for SSR/brand-critical schemes
+theme.registerColorScheme('teal', { primary: { 100: '#008582' /* … */ } });
+theme.setColorScheme('teal'); // data-rt-scheme="teal"; persisted to rt-color-scheme
+theme.setColorScheme(null); // back to the default palette
+```
+
+- Orthogonal to light/dark (one ramp per role serves both modes).
+- Δ0: with no scheme the accent layer is byte-for-byte the historical palette
+  (regression-tested in `styles/color-scheme.spec.ts`); Sass↔JS generator parity is tested too.
+- Full guide: Storybook **Foundation/Theming/Custom color schemes** (`docs/ColorSchemes.mdx`).

package/src/styles/base/_base.scss

@@ -1,8 +1,6 @@
-@use './mixin' as mixins;
-
 $palette: (
     white: (
-        100: #ffffff,
+        100: #fff,
     ),
     gray: (
         5: #f5f6f8,
@@ -12,7 +10,7 @@ $palette: (
     ),
     black: (
         10: #f3f3f3,
-        15: #eeeeee,
+        15: #eee,
         20: #e0e0e0,
         30: #b2cbca,
         40: #a3a3a3,
@@ -55,17 +53,11 @@ $palette: (
     ),
 );
 
-:root {
-    @each $family, $set in $palette {
-        @each $saturate, $clr in $set {
-            #{mixins.generateCssClrVar($family, $saturate)}: #{$clr};
-        }
-    }
-
-    --clr-base-accent: #0d1c2b;
-    --clr-txt: rgba(0, 0, 0, 0.87);
-    --clr-white-rgb: 255, 255, 255;
+// NOTE: the $palette map above is kept for backwards compatibility (consumers may @use it).
+// All CSS custom property emission lives in base/_tokens.scss:
+//   --rt-color-* primitives, --rt-{bg,text,icon,border}-* semantic, and foundations.
 
+:root {
     // Buttons
-    --rt-button-box-shadow: 0 3px 5px -1px rgba(0, 0, 0, 0.2), 0 6px 10px 0 rgba(0, 0, 0, 0.12), 0 1px 18px 0 rgba(0, 0, 0, 0.14);
+    --rt-button-box-shadow: 0 3px 5px -1px rgb(0 0 0 / 20%), 0 6px 10px 0 rgb(0 0 0 / 12%), 0 1px 18px 0 rgb(0 0 0 / 14%);
 }