@collectivetrait/lineaui 0.0.0-stage → 1.0.0

package/scss/blocks/_toolbar.scss

@@ -0,0 +1,67 @@
+@use 'sass:list';
+@use '../settings' as s;
+@use '../tools/bem' as b;
+
+@if list.length(s.$blocks) == 0 or list.index(s.$blocks, 'toolbar') {
+  @layer blocks {
+    @include b.block('toolbar') {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: var(--s2);
+      padding-block: var(--s2);
+
+      @include b.element('start') {
+        display: flex;
+        align-items: center;
+        gap: var(--s2);
+      }
+
+      @include b.element('end') {
+        display: flex;
+        align-items: center;
+        gap: var(--s2);
+      }
+
+      @include b.element('group') {
+        display: flex;
+        align-items: center;
+        gap: var(--s1);
+      }
+
+      @include b.element('search') {
+        max-width: 240px;
+      }
+
+      @include b.element('count') {
+        font: var(--t-body-sm-s)/var(--t-body-sm-lh) var(--f-ui);
+        color: var(--c-muted);
+        white-space: nowrap;
+      }
+
+      @include b.element('divider') {
+        width: 0;
+        height: 24px;
+        border-left: var(--bd1) solid var(--border);
+        margin-inline: var(--s1);
+      }
+
+      @include b.modifier('bulk') {
+        background-color: var(--primary-subtle);
+        padding: var(--s2) var(--s3);
+        border-radius: var(--r-md);
+      }
+
+      @include b.modifier('sticky') {
+        position: sticky;
+        top: 0;
+        z-index: 10;
+        background-color: var(--surface);
+      }
+
+      @include b.modifier('compact') {
+        padding-block: var(--s1);
+      }
+    }
+  }
+}

package/scss/blocks/_tooltip.scss

@@ -0,0 +1,63 @@
+@use 'sass:list';
+@use '../settings' as s;
+@use '../tools/bem' as b;
+
+@if list.length(s.$blocks) == 0 or list.index(s.$blocks, 'tooltip') {
+  @layer blocks {
+    @include b.block('tooltip') {
+      position: absolute;
+      z-index: 1000;
+      max-width: 250px;
+      padding: var(--s1) var(--s2);
+      font: 500 var(--t-meta-s)/var(--t-meta-lh) var(--f-ui);
+      color: var(--c-inverse);
+      background-color: var(--surface-inverse);
+      border-radius: var(--r-md);
+      box-shadow: var(--sh2);
+      pointer-events: none;
+      white-space: normal;
+      word-wrap: break-word;
+
+      @include b.element('arrow') {
+        position: absolute;
+        width: 8px;
+        height: 8px;
+        background-color: var(--surface-inverse);
+        transform: rotate(45deg);
+      }
+
+      // Position modifiers
+      @include b.modifier('top') {
+        .#{s.$prefix}tooltip__arrow {
+          bottom: -4px;
+          left: 50%;
+          margin-left: -4px;
+        }
+      }
+
+      @include b.modifier('bottom') {
+        .#{s.$prefix}tooltip__arrow {
+          top: -4px;
+          left: 50%;
+          margin-left: -4px;
+        }
+      }
+
+      @include b.modifier('start') {
+        .#{s.$prefix}tooltip__arrow {
+          right: -4px;
+          top: 50%;
+          margin-top: -4px;
+        }
+      }
+
+      @include b.modifier('end') {
+        .#{s.$prefix}tooltip__arrow {
+          left: -4px;
+          top: 50%;
+          margin-top: -4px;
+        }
+      }
+    }
+  }
+}

package/scss/helpers/_index.scss

@@ -0,0 +1,2 @@
+@forward 'rhythm';
+@forward 'typography';

package/scss/helpers/_rhythm.scss

@@ -0,0 +1,64 @@
+@layer helpers {
+  .show-grid {
+    --grid-line: rgb(124 58 237 / 0.30);
+    --grid-base: rgb(124 58 237 / 0.15);
+
+    position: relative;
+
+    &::before {
+      content: "";
+      position: absolute;
+      inset: 0;
+      pointer-events: none;
+      z-index: 9999;
+      background-image:
+        repeating-linear-gradient(to bottom, var(--grid-line) 0 1px, transparent 1px 1.5rem),
+        repeating-linear-gradient(to bottom, var(--grid-base) 0 1px, transparent 1px 0.5rem);
+    }
+  }
+
+  @media (prefers-color-scheme: dark) {
+    .show-grid:not([data-theme="light"]) {
+      --grid-line: rgb(139 92 246 / 0.30);
+      --grid-base: rgb(139 92 246 / 0.15);
+    }
+  }
+
+  [data-theme="dark"] .show-grid,
+  .show-grid[data-theme="dark"] {
+    --grid-line: rgb(139 92 246 / 0.30);
+    --grid-base: rgb(139 92 246 / 0.15);
+  }
+
+  .grid-toggle {
+    position: fixed;
+    bottom: var(--s3);
+    right: var(--s3);
+    z-index: 10000;
+    display: inline-grid;
+    place-items: center;
+    width: var(--s4);
+    height: var(--s4);
+    padding: 0;
+    border: none;
+    border-radius: var(--r-sm);
+    background: transparent;
+    color: var(--c-muted);
+    cursor: pointer;
+
+    > i {
+      font-size: 1rem;
+    }
+
+    &:hover {
+      color: var(--text);
+      background: var(--surface-raised);
+    }
+
+    &[aria-pressed="true"] {
+      color: var(--primary-text);
+      background: var(--primary-subtle);
+      box-shadow: inset 0 0 0 1px var(--primary-border);
+    }
+  }
+}

package/scss/helpers/_typography.scss

@@ -0,0 +1,4 @@
+// Typography helpers are now generated as responsive utilities
+// via the utility generator in utilities/_map.scss.
+// This file is kept for the @layer helpers declaration.
+@layer helpers {}

package/scss/layout/_cluster.scss

@@ -0,0 +1,43 @@
+@use '../tools/bem' as b;
+@use '../settings' as s;
+
+@layer layout {
+  @include b.block('cluster') {
+    display: flex;
+    flex-wrap: wrap;
+    gap: var(--_gap, var(--s1));
+    align-items: center;
+
+    @include b.modifier('gap-xs') { --_gap: var(--s1); }
+    @include b.modifier('gap-sm') { --_gap: var(--s2); }
+    @include b.modifier('gap-md') { --_gap: var(--s3); }
+
+    @include b.modifier('justify-start')   { justify-content: flex-start; }
+    @include b.modifier('justify-center')  { justify-content: center; }
+    @include b.modifier('justify-end')     { justify-content: flex-end; }
+    @include b.modifier('justify-between') { justify-content: space-between; }
+
+    @include b.modifier('align-start')    { align-items: flex-start; }
+    @include b.modifier('align-center')   { align-items: center; }
+    @include b.modifier('align-baseline') { align-items: baseline; }
+    @include b.modifier('align-end')      { align-items: flex-end; }
+
+    @include b.modifier('nowrap') { flex-wrap: nowrap; }
+
+    @each $bp, $val in s.$breakpoints {
+      @media (min-width: #{$val}) {
+        &--justify-start\@#{$bp}   { justify-content: flex-start; }
+        &--justify-center\@#{$bp}  { justify-content: center; }
+        &--justify-end\@#{$bp}     { justify-content: flex-end; }
+        &--justify-between\@#{$bp} { justify-content: space-between; }
+
+        &--align-start\@#{$bp}    { align-items: flex-start; }
+        &--align-center\@#{$bp}   { align-items: center; }
+        &--align-baseline\@#{$bp} { align-items: baseline; }
+        &--align-end\@#{$bp}      { align-items: flex-end; }
+
+        &--nowrap\@#{$bp} { flex-wrap: nowrap; }
+      }
+    }
+  }
+}

package/scss/layout/_container.scss

@@ -0,0 +1,26 @@
+@use '../tools/bem' as b;
+
+@layer layout {
+  @include b.block('container') {
+    width: 100%;
+    max-width: var(--container);
+    margin-inline: auto;
+    padding-inline: var(--gutter);
+
+    @include b.modifier('narrow') {
+      max-width: var(--measure);
+    }
+
+    @include b.modifier('wide') {
+      max-width: var(--container-wide);
+    }
+
+    @include b.modifier('full') {
+      max-width: none;
+    }
+
+    @include b.modifier('flush') {
+      padding-inline: 0;
+    }
+  }
+}

package/scss/layout/_grid.scss

@@ -0,0 +1,90 @@
+@use 'sass:map';
+@use '../tools/bem' as b;
+@use '../settings' as s;
+
+@layer layout {
+  @include b.block('grid') {
+    display: grid;
+    gap: var(--_gap, var(--s3));
+
+    @for $i from 1 through 6 {
+      @include b.modifier('cols-#{$i}') {
+        grid-template-columns: repeat(#{$i}, 1fr);
+      }
+    }
+
+    @include b.modifier('cols-12') {
+      grid-template-columns: repeat(12, 1fr);
+    }
+
+    @include b.modifier('auto') {
+      grid-template-columns: repeat(auto-fit, minmax(min(var(--grid-min, 15rem), 100%), 1fr));
+    }
+
+    @include b.modifier('gap-0')  { --_gap: 0; }
+    @include b.modifier('gap-xs') { --_gap: var(--s1); }
+    @include b.modifier('gap-sm') { --_gap: var(--s2); }
+    @include b.modifier('gap-md') { --_gap: var(--s3); }
+    @include b.modifier('gap-lg') { --_gap: var(--s4); }
+
+    // Responsive column modifiers
+    @each $bp, $val in s.$breakpoints {
+      @media (min-width: #{$val}) {
+        @for $i from 1 through 6 {
+          &--cols-#{$i}\@#{$bp} {
+            grid-template-columns: repeat(#{$i}, 1fr);
+          }
+        }
+
+        &--cols-12\@#{$bp} {
+          grid-template-columns: repeat(12, 1fr);
+        }
+      }
+    }
+
+    @include b.element('item') {
+      @for $n from 1 through 12 {
+        @include b.modifier('span-#{$n}') {
+          grid-column: span #{$n};
+        }
+      }
+
+      @include b.modifier('span-full') {
+        grid-column: 1 / -1;
+      }
+
+      @for $n from 1 through 12 {
+        @include b.modifier('start-#{$n}') {
+          grid-column-start: #{$n};
+        }
+      }
+
+      @include b.modifier('subgrid') {
+        display: grid;
+        grid-template-rows: subgrid;
+        grid-row: span var(--rows, 3);
+      }
+
+      // Responsive span modifiers
+      @each $bp, $val in s.$breakpoints {
+        @media (min-width: #{$val}) {
+          @for $n from 1 through 12 {
+            &--span-#{$n}\@#{$bp} {
+              grid-column: span #{$n};
+            }
+          }
+
+          &--span-full\@#{$bp} {
+            grid-column: 1 / -1;
+          }
+
+          @for $n from 1 through 12 {
+            &--start-#{$n}\@#{$bp} {
+              grid-column-start: #{$n};
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/scss/layout/_index.scss

@@ -0,0 +1,5 @@
+@forward 'shell';
+@forward 'container';
+@forward 'grid';
+@forward 'cluster';
+@forward 'section';

package/scss/layout/_section.scss

@@ -0,0 +1,78 @@
+@use 'sass:map';
+@use '../tools/bem' as b;
+@use '../tools/rhythm' as r;
+@use '../settings' as s;
+
+@layer layout {
+  @include b.block('section') {
+    padding-block: var(--s4);
+    position: relative;
+
+    @include b.element('inner') {
+      max-width: var(--container);
+      margin-inline: auto;
+      padding-inline: var(--gutter);
+    }
+
+    @include b.modifier('narrow') {
+      .#{s.$prefix}section__inner { max-width: var(--measure); }
+    }
+
+    @include b.modifier('wide') {
+      .#{s.$prefix}section__inner { max-width: var(--container-wide); }
+    }
+
+    @include b.modifier('space-lg')  { padding-block: r.lines(2); }
+    @include b.modifier('space-xl')  { padding-block: r.lines(3); }
+    @include b.modifier('space-2xl') { padding-block: r.lines(4); }
+    @include b.modifier('space-3xl') { padding-block: r.lines(6); }
+
+    @media (max-width: map.get(s.$breakpoints, md)) {
+      &--space-xl  { padding-block: r.lines(2); }
+      &--space-2xl { padding-block: r.lines(2); }
+      &--space-3xl { padding-block: r.lines(3); }
+    }
+
+    @include b.modifier('surface-sunken') {
+      background: var(--surface-sunken);
+    }
+
+    @include b.modifier('surface-raised') {
+      background: var(--surface);
+    }
+
+    @include b.modifier('surface-inverse') {
+      background: var(--surface-inverse);
+      color: var(--c-inverse);
+    }
+
+
+    @include b.modifier('center') {
+      text-align: center;
+    }
+
+    @include b.element('header') {
+      margin-bottom: var(--s4);
+    }
+
+    @include b.element('eyebrow') {
+      font: 500 var(--t-meta-s)/var(--t-meta-lh) var(--f-mono);
+      letter-spacing: 0.08em;
+      text-transform: uppercase;
+      color: var(--c-muted);
+      margin-bottom: var(--s1);
+    }
+
+    @include b.element('title') {
+      font: 400 var(--t-h2-s)/var(--t-h2-lh) var(--f-prose);
+      letter-spacing: -0.005em;
+      text-wrap: balance;
+    }
+
+    @include b.element('lead') {
+      font-size: var(--t-lead-s);
+      line-height: var(--t-lead-lh);
+      color: var(--c-muted);
+    }
+  }
+}

package/scss/layout/_shell.scss

@@ -0,0 +1,87 @@
+@use '../tools/bem' as b;
+@use '../settings' as s;
+@use 'sass:map';
+
+@layer layout {
+  @include b.block('shell') {
+    display: grid;
+    grid-template-areas:
+      "header header"
+      "sidebar main";
+    grid-template-rows: 48px 1fr; // 2 rhythm lines = 48px
+    grid-template-columns: 240px 1fr;
+    min-block-size: 100svh;
+    background-color: var(--canvas);
+
+    @include b.element('header') {
+      grid-area: header;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      padding-inline: var(--s3);
+      background-color: var(--surface);
+      border-block-end: 1px solid var(--border);
+      position: sticky;
+      top: 0;
+      z-index: 100;
+    }
+
+    @include b.element('sidebar') {
+      grid-area: sidebar;
+      overflow-y: auto;
+      border-inline-end: 1px solid var(--border);
+      background-color: var(--surface);
+      padding-block: var(--s3);
+      position: sticky;
+      top: 48px;
+      block-size: calc(100svh - 48px);
+    }
+
+    @include b.element('main') {
+      grid-area: main;
+      padding: var(--s4);
+      min-inline-size: 0; // prevent grid blowout
+    }
+
+    // Below lg: sidebar hidden, single column
+    @media (max-width: map.get(s.$breakpoints, lg)) {
+      grid-template-areas:
+        "header"
+        "main";
+      grid-template-columns: 1fr;
+
+      @include b.element('sidebar') {
+        position: fixed;
+        top: 0;
+        bottom: 0;
+        left: 0;
+        width: 240px;
+        z-index: 200;
+        transform: translateX(-100%);
+        visibility: hidden;
+        transition: transform var(--dur-base) var(--e-exit),
+                    visibility var(--dur-base) var(--e-exit);
+      }
+
+      &[data-sidebar="open"] &__sidebar {
+        transform: translateX(0);
+        visibility: visible;
+        box-shadow: var(--sh4);
+        transition: transform var(--dur-base) var(--e-enter),
+                    visibility var(--dur-base) var(--e-enter),
+                    box-shadow var(--dur-base) var(--e-enter);
+      }
+
+      &[data-sidebar="open"]::before {
+        content: '';
+        position: fixed;
+        top: 0;
+        left: 0;
+        right: 0;
+        bottom: 0;
+        background: var(--overlay);
+        z-index: 199;
+      }
+    }
+  }
+}

package/scss/settings/_blocks.scss

@@ -0,0 +1,3 @@
+// Empty list = emit all blocks.
+// To restrict output: @use 'lineaui' with ($blocks: (button, card, table));
+$blocks: () !default;

package/scss/settings/_breakpoints.scss

@@ -0,0 +1,7 @@
+$breakpoints: (
+  sm:  576px,
+  md:  768px,
+  lg:  1024px,
+  xl:  1280px,
+  "2xl": 1536px,
+) !default;

package/scss/settings/_fonts.scss

@@ -0,0 +1,5 @@
+$font-prose: Charter, 'Bitstream Charter', 'Sitka Text', Cambria, serif !default;
+$font-ui: Inter, Roboto, 'Helvetica Neue', 'Arial Nova', 'Nimbus Sans', Arial, sans-serif !default;
+$font-mono: ui-monospace, 'Cascadia Code', 'Source Code Pro', Menlo, Consolas, 'DejaVu Sans Mono', monospace !default;
+
+$heading-font: $font-prose !default;

package/scss/settings/_index.scss

@@ -0,0 +1,7 @@
+@forward 'prefix';
+@forward 'rhythm';
+@forward 'fonts';
+@forward 'breakpoints';
+@forward 'blocks';
+@forward 'layout';
+@forward 'utilities';

package/scss/settings/_layout.scss

@@ -0,0 +1,5 @@
+$container:      56.25rem !default;  // 900px
+$container-wide: 75rem    !default;  // 1200px
+$measure:        37.5rem  !default;  // ~70ch at 16px prose
+$gutter:         1rem     !default;  // mobile side gutter
+$gutter-lg:      2rem     !default;  // md+ side gutter

package/scss/settings/_prefix.scss

@@ -0,0 +1 @@
+$prefix: "ln-" !default;

package/scss/settings/_rhythm.scss

@@ -0,0 +1,6 @@
+$g: 8px !default;   // base grid step
+$r: 24px !default;  // line grid step (= 3 × g)
+
+// rem equivalents for rem-based rules
+$g-rem: 0.5rem;
+$r-rem: 1.5rem;

package/scss/settings/_utilities.scss

@@ -0,0 +1,2 @@
+$utilities: () !default;
+$responsive-utilities: null !default;

package/scss/tokens/_borders.scss

@@ -0,0 +1,16 @@
+@layer tokens {
+  :root {
+    --bd1: 1px;
+    --bd2: 2px;
+    --bd3: 3px;
+
+    --r-none:   0;
+    --r-xs:     2px;
+    --r-sm:     4px;
+    --r-md:     8px;
+    --r-lg:     12px;
+    --r-xl:     16px;
+    --r-pill:   9999px;
+    --r-circle: 50%;
+  }
+}

package/scss/tokens/_elevation.scss

@@ -0,0 +1,37 @@
+@layer tokens {
+  :root {
+    --sh0: none;
+    --sh1: 0 0 2px rgb(9 9 11 / 0.05);
+    --sh2: 0 0 12px rgb(9 9 11 / 0.07);
+    --sh3: 0 0 24px rgb(9 9 11 / 0.09);
+    --sh4: 0 0 48px rgb(9 9 11 / 0.12);
+    --sh-inset-1: inset 0 0 2px rgb(0 0 0 / 0.05);
+    --sh-inset-2: inset 0 0 4px rgb(0 0 0 / 0.08);
+    --sh-inset-3: inset 0 0 8px rgb(0 0 0 / 0.12);
+    --sh-inset-4: inset 0 0 16px rgb(0 0 0 / 0.16);
+  }
+
+  @media (prefers-color-scheme: dark) {
+    :root:not([data-theme="light"]) {
+      --sh1: 0 0 2px rgb(0 0 0 / 0.40);
+      --sh2: 0 0 12px rgb(0 0 0 / 0.44);
+      --sh3: 0 0 24px rgb(0 0 0 / 0.48);
+      --sh4: 0 0 48px rgb(0 0 0 / 0.56);
+      --sh-inset-1: inset 0 0 2px rgb(0 0 0 / 0.16);
+      --sh-inset-2: inset 0 0 4px rgb(0 0 0 / 0.22);
+      --sh-inset-3: inset 0 0 8px rgb(0 0 0 / 0.28);
+      --sh-inset-4: inset 0 0 16px rgb(0 0 0 / 0.36);
+    }
+  }
+
+  [data-theme="dark"] {
+    --sh1: 0 0 2px rgb(0 0 0 / 0.40);
+    --sh2: 0 0 12px rgb(0 0 0 / 0.44);
+    --sh3: 0 0 24px rgb(0 0 0 / 0.48);
+    --sh4: 0 0 48px rgb(0 0 0 / 0.56);
+    --sh-inset-1: inset 0 0 2px rgb(0 0 0 / 0.16);
+    --sh-inset-2: inset 0 0 4px rgb(0 0 0 / 0.22);
+    --sh-inset-3: inset 0 0 8px rgb(0 0 0 / 0.28);
+    --sh-inset-4: inset 0 0 16px rgb(0 0 0 / 0.36);
+  }
+}

package/scss/tokens/_index.scss

@@ -0,0 +1,8 @@
+@forward 'palette';
+@forward 'roles';
+@forward 'type';
+@forward 'space';
+@forward 'elevation';
+@forward 'borders';
+@forward 'motion';
+@forward 'layout';

package/scss/tokens/_layout.scss

@@ -0,0 +1,17 @@
+@use 'sass:map';
+@use '../settings' as s;
+
+@layer tokens {
+  :root {
+    --container: #{s.$container};
+    --container-wide: #{s.$container-wide};
+    --measure: #{s.$measure};
+    --gutter: #{s.$gutter};
+  }
+
+  @media (min-width: #{map.get(s.$breakpoints, md)}) {
+    :root {
+      --gutter: #{s.$gutter-lg};
+    }
+  }
+}

package/scss/tokens/_motion.scss

@@ -0,0 +1,17 @@
+@layer tokens {
+  :root {
+    --dur-fast: 120ms;
+    --dur-base: 200ms;
+    --dur-slow: 320ms;
+
+    --e-standard: cubic-bezier(0.4, 0, 0.2, 1);
+    --e-enter:    cubic-bezier(0, 0, 0.2, 1);
+    --e-exit:     cubic-bezier(0.4, 0, 1, 1);
+
+    @media (prefers-reduced-motion: reduce) {
+      --dur-fast: 1ms;
+      --dur-base: 1ms;
+      --dur-slow: 1ms;
+    }
+  }
+}