soltana-ui 0.1.0

package/src/styles/components/_inputs.scss

@@ -0,0 +1,409 @@
+// ---------------------------------------------------------------------------
+// Form Input Components
+// ---------------------------------------------------------------------------
+// Text inputs, selects, textareas, checkboxes, radios, and input groups.
+// Uses --relief-* variables for automatic relief switching.
+// ---------------------------------------------------------------------------
+
+@use '../base/register' as *;
+@use '../base/accessibility' as *;
+@use '../base/transitions' as *;
+
+// ============================================================================
+// TEXT INPUT
+// ============================================================================
+
+@mixin input-base {
+  position: relative;
+  display: block;
+  width: 100%;
+  padding: 0.5rem 0.75rem;
+  font-family: var(--font-sans);
+  font-size: var(--text-base);
+  letter-spacing: var(--tracking-refined);
+  line-height: 1.5;
+  color: var(--text-primary);
+  border: 1px solid var(--input-border);
+  border-radius: var(--radius-lg);
+  box-shadow: var(--relief-shadow-inset);
+  @include finish-surface(var(--input-bg));
+  transition:
+    border-color var(--transition-slow) var(--easing-in-out),
+    box-shadow var(--transition-slow) var(--easing-in-out);
+  appearance: none;
+
+  &::placeholder {
+    color: var(--input-placeholder);
+  }
+
+  &:focus-visible {
+    outline: none;
+    border-color: var(--input-border-focus);
+    box-shadow: var(--relief-shadow-inset), var(--focus-ring-shadow);
+  }
+
+  &:disabled {
+    @include disabled-state;
+    color: var(--state-disabled-text);
+  }
+}
+
+.input {
+  @include input-base;
+}
+
+// ============================================================================
+// INPUT SIZES
+// ============================================================================
+
+.input-sm {
+  padding: 0.375rem 0.625rem;
+  font-size: var(--text-sm);
+}
+
+.input-lg {
+  padding: 0.75rem 1rem;
+  font-size: var(--text-lg);
+}
+
+// ============================================================================
+// INPUT STATES
+// ============================================================================
+
+@each $type in (error, success, warning) {
+  .input-#{$type} {
+    border-color: var(--color-#{$type});
+
+    &:focus-visible {
+      box-shadow:
+        var(--relief-shadow-inset),
+        0 0 0 3px var(--color-#{$type}-subtle);
+    }
+  }
+}
+
+// ============================================================================
+// SELECT
+// ============================================================================
+
+.select {
+  @include input-base;
+  padding-right: 2.5rem;
+  background-image: var(--icon-select-chevron);
+  background-repeat: no-repeat;
+  background-position: right 0.75rem center;
+  background-size: 1rem;
+}
+
+// ============================================================================
+// TEXTAREA
+// ============================================================================
+
+.textarea {
+  @include input-base;
+  min-height: 5rem;
+  resize: vertical;
+}
+
+// ============================================================================
+// CHECKBOX & RADIO
+// ============================================================================
+
+.checkbox,
+.radio {
+  appearance: none;
+  width: 1.125rem;
+  height: 1.125rem;
+  border: 2px solid var(--input-border);
+  background-color: var(--input-bg);
+  cursor: pointer;
+  @include transition-interactive(var(--transition-normal));
+  flex-shrink: 0;
+
+  &:checked {
+    background-color: var(--accent-primary);
+    border-color: var(--accent-primary);
+    box-shadow: 0 0 8px var(--state-focus-ring);
+  }
+
+  &:focus-visible {
+    @include focus-ring-outline;
+  }
+
+  &:disabled {
+    @include disabled-state;
+    border-color: var(--border-subtle);
+  }
+
+  &:disabled:checked {
+    background-color: var(--state-disabled-text);
+    border-color: var(--state-disabled-text);
+  }
+}
+
+.checkbox {
+  border-radius: var(--radius-md);
+  position: relative;
+
+  &:checked::after {
+    content: '';
+    position: absolute;
+    inset: 0;
+    background-color: var(--text-inverse);
+    @include mask(var(--icon-checkbox-mask), 0.75rem, no-repeat, center);
+  }
+}
+
+.radio {
+  border-radius: var(--radius-full);
+  position: relative;
+
+  &:checked::after {
+    content: '';
+    position: absolute;
+    inset: 0;
+    background-color: var(--text-inverse);
+    @include mask(var(--icon-radio-mask), 1rem, no-repeat, center);
+  }
+}
+
+// ============================================================================
+// INPUT GROUP
+// ============================================================================
+
+.input-group {
+  display: flex;
+  flex-direction: column;
+  gap: 0.375rem;
+}
+
+.input-label {
+  font-size: var(--text-sm);
+  font-weight: var(--font-medium);
+  color: var(--text-secondary);
+  letter-spacing: var(--tracking-elegant);
+}
+
+.input-help {
+  font-size: var(--text-xs);
+  color: var(--text-muted);
+}
+
+// ============================================================================
+// VALIDATION STATE TEXT
+// ============================================================================
+
+@each $type in (error, success, warning) {
+  .input-#{$type}-text {
+    font-size: var(--text-xs);
+    color: var(--color-#{$type}-text);
+  }
+}
+
+// Parent-level auto-validation via :valid/:invalid
+.form-validated {
+  .input:valid,
+  .select:valid,
+  .textarea:valid {
+    border-color: var(--color-success);
+  }
+
+  .input:invalid,
+  .select:invalid,
+  .textarea:invalid {
+    border-color: var(--color-error);
+  }
+}
+
+// ============================================================================
+// FILE INPUT
+// ============================================================================
+
+.file-input {
+  @include input-base;
+  cursor: pointer;
+
+  &::file-selector-button {
+    padding: 0.375rem 0.75rem;
+    margin-right: 0.75rem;
+    font-family: var(--font-sans);
+    font-size: var(--text-sm);
+    font-weight: var(--font-medium);
+    color: var(--text-primary);
+    background-color: var(--surface-3);
+    border: 1px solid var(--border-default);
+    border-radius: var(--radius-md);
+    cursor: pointer;
+    @include transition-property(background-color);
+  }
+
+  &:hover::file-selector-button {
+    background-color: var(--state-hover);
+  }
+}
+
+.file-input-sm {
+  padding: 0.25rem 0.625rem;
+  font-size: var(--text-sm);
+
+  &::file-selector-button {
+    padding: 0.25rem 0.5rem;
+    font-size: var(--text-xs);
+  }
+}
+
+.file-input-lg {
+  padding: 0.625rem 1rem;
+  font-size: var(--text-lg);
+
+  &::file-selector-button {
+    padding: 0.5rem 1rem;
+    font-size: var(--text-base);
+  }
+}
+
+// ============================================================================
+// NUMBER INPUT
+// ============================================================================
+
+.input-number {
+  display: inline-flex;
+  align-items: stretch;
+  border-radius: var(--radius-lg);
+  overflow: hidden;
+  border: 1px solid var(--input-border);
+  box-shadow: var(--relief-shadow-inset);
+
+  .input {
+    border: none;
+    border-radius: 0;
+    box-shadow: none;
+    text-align: center;
+    min-width: 3rem;
+
+    // Hide native spinners
+    appearance: textfield;
+
+    &::-webkit-outer-spin-button,
+    &::-webkit-inner-spin-button {
+      appearance: none;
+      margin: 0;
+    }
+  }
+}
+
+.input-number-step {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 2.25rem;
+  padding: 0;
+  border: none;
+  background: var(--surface-2);
+  color: var(--text-secondary);
+  cursor: pointer;
+  font-size: var(--text-lg);
+  font-family: var(--font-sans);
+  user-select: none;
+  @include transition-property(background-color);
+
+  &:hover {
+    background: var(--state-hover);
+    color: var(--text-primary);
+  }
+
+  &:active {
+    background: var(--state-active);
+  }
+
+  &:disabled {
+    color: var(--state-disabled-text);
+    cursor: not-allowed;
+  }
+}
+
+// ============================================================================
+// RANGE SLIDER
+// ============================================================================
+
+.range {
+  appearance: none;
+  width: 100%;
+  height: 0.375rem;
+  background-color: var(--surface-3);
+  border-radius: var(--radius-full);
+  box-shadow: var(--relief-shadow-inset);
+  outline: none;
+  cursor: pointer;
+
+  &::-webkit-slider-thumb {
+    appearance: none;
+    width: 1.125rem;
+    height: 1.125rem;
+    border-radius: var(--radius-full);
+    background-color: var(--accent-primary);
+    border: 2px solid var(--surface-bg);
+    box-shadow: 0 0 0 1px var(--accent-primary);
+    cursor: pointer;
+    @include transition-depth(var(--transition-normal));
+  }
+
+  &::-moz-range-thumb {
+    width: 1.125rem;
+    height: 1.125rem;
+    border-radius: var(--radius-full);
+    background-color: var(--accent-primary);
+    border: 2px solid var(--surface-bg);
+    box-shadow: 0 0 0 1px var(--accent-primary);
+    cursor: pointer;
+  }
+
+  &:hover::-webkit-slider-thumb {
+    transform: scale(1.15);
+  }
+
+  &:focus-visible::-webkit-slider-thumb {
+    box-shadow:
+      0 0 0 1px var(--accent-primary),
+      var(--focus-ring-shadow);
+  }
+
+  &::-webkit-slider-runnable-track {
+    height: 0.375rem;
+    border-radius: var(--radius-full);
+  }
+
+  &::-moz-range-track {
+    height: 0.375rem;
+    background-color: var(--surface-3);
+    border-radius: var(--radius-full);
+  }
+}
+
+.range-sm {
+  height: 0.25rem;
+
+  &::-webkit-slider-thumb {
+    width: 0.875rem;
+    height: 0.875rem;
+  }
+
+  &::-moz-range-thumb {
+    width: 0.875rem;
+    height: 0.875rem;
+  }
+}
+
+.range-lg {
+  height: 0.5rem;
+
+  &::-webkit-slider-thumb {
+    width: 1.5rem;
+    height: 1.5rem;
+  }
+
+  &::-moz-range-thumb {
+    width: 1.5rem;
+    height: 1.5rem;
+  }
+}

package/src/styles/components/_layouts.scss

@@ -0,0 +1,139 @@
+// ---------------------------------------------------------------------------
+// Layout Components
+// ---------------------------------------------------------------------------
+// Reusable application layout primitives: sidebar, header, footer, and
+// grid shell. Consumed by the docs site and available to all consumers.
+// Uses BEM naming (__nav, __link, etc.) for sidebar children — intentional
+// for multi-element structures where parent/child coupling must be explicit.
+// ---------------------------------------------------------------------------
+
+@use '../base/register' as *;
+@use '../base/transitions' as *;
+
+// App shell — two-column grid with configurable sidebar width
+.app-layout {
+  display: grid;
+  grid-template-columns: var(--sidebar-width, 260px) 1fr;
+  min-height: 100vh;
+}
+
+// Sticky page header
+.app-header {
+  position: sticky;
+  top: 0;
+  z-index: var(--z-40);
+  background: var(--surface-1);
+  border-bottom: 1px solid var(--border-subtle);
+}
+
+// Sidebar shell
+.sidebar {
+  position: sticky;
+  top: 0;
+  height: 100vh;
+  overflow-y: auto;
+  padding: 1rem 0;
+  background: var(--surface-1);
+  border-right: 1px solid var(--border-subtle);
+}
+
+.sidebar__nav {
+  display: flex;
+  flex-direction: column;
+}
+
+// Section header — collapsible toggle
+.sidebar__section-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  width: 100%;
+  padding: 0.5rem 1.25rem;
+  font-size: var(--text-base);
+  font-weight: var(--font-semibold);
+  text-transform: uppercase;
+  letter-spacing: var(--tracking-elegant);
+  color: var(--text-tertiary);
+  background: none;
+  border: none;
+  cursor: pointer;
+  @include transition-interactive;
+
+  &:hover {
+    color: var(--text-primary);
+  }
+}
+
+// Chevron rotation on expanded sections
+.sidebar__chevron {
+  @include transition-property(transform);
+}
+
+.sidebar__section--expanded > .sidebar__section-header > .sidebar__chevron {
+  transform: rotate(180deg);
+}
+
+// Collapsible list
+.sidebar__list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  max-height: 0;
+  overflow: hidden;
+  transition: max-height var(--transition-slow) var(--easing-in-out);
+
+  .sidebar__section--expanded > & {
+    max-height: 60rem;
+  }
+}
+
+// Navigation link
+.sidebar__link {
+  display: flex;
+  align-items: center;
+  gap: 0.625rem;
+  padding: 0.625rem 1.25rem 0.625rem 1.5rem;
+  font-size: var(--text-base);
+  color: var(--text-secondary);
+  border-left: 2px solid transparent;
+  text-decoration: none;
+  @include transition-interactive;
+
+  svg {
+    flex-shrink: 0;
+    width: 1.125rem;
+    height: 1.125rem;
+    opacity: 0.6;
+    transition: opacity var(--transition-normal) var(--easing-in-out);
+  }
+
+  &:hover {
+    color: var(--text-primary);
+    background: var(--state-hover);
+
+    svg {
+      opacity: 1;
+    }
+  }
+
+  &--active {
+    color: var(--text-primary);
+    border-left-color: var(--accent-primary);
+    background: color-mix(in srgb, var(--accent-primary) 8%, transparent);
+
+    svg {
+      opacity: 1;
+    }
+  }
+}
+
+// Page footer
+.page-footer {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 1.5rem;
+  font-size: var(--text-sm);
+  color: var(--text-muted);
+  border-top: 1px solid var(--border-subtle);
+}

package/src/styles/components/_lists.scss

@@ -0,0 +1,135 @@
+// ---------------------------------------------------------------------------
+// List & Accordion Components
+// ---------------------------------------------------------------------------
+// Styled lists and collapsible accordion panels.
+// Uses --relief-* variables for automatic relief switching.
+// ---------------------------------------------------------------------------
+
+@use '../base/transitions' as *;
+
+// ============================================================================
+// ACCORDION
+// ============================================================================
+
+.accordion {
+  border: 1px solid var(--border-default);
+  border-radius: var(--radius-xl);
+  overflow: hidden;
+}
+
+.accordion-item {
+  border-bottom: 1px solid var(--border-default);
+
+  &:last-child {
+    border-bottom: 0;
+  }
+}
+
+.accordion-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  width: 100%;
+  padding: 0.875rem 1.25rem;
+  font-family: var(--font-sans);
+  font-size: var(--text-sm);
+  font-weight: var(--font-semibold);
+  letter-spacing: var(--tracking-refined);
+  color: var(--text-primary);
+  background-color: var(--relief-surface-raised);
+  border: none;
+  cursor: pointer;
+  text-align: left;
+  @include transition-interactive(var(--transition-normal));
+  @include hover-state;
+
+  &::after {
+    content: '';
+    display: inline-block;
+    width: 0.625rem;
+    height: 0.625rem;
+    border-right: 2px solid currentcolor;
+    border-bottom: 2px solid currentcolor;
+    transform: rotate(45deg);
+    transition: transform var(--transition-normal) var(--easing-in-out);
+    flex-shrink: 0;
+    margin-left: 0.75rem;
+  }
+}
+
+.accordion-body {
+  max-height: var(--accordion-height, 0);
+  overflow: hidden;
+  transition: max-height var(--transition-slow) var(--easing-in-out);
+  padding: 0 1.25rem;
+
+  > :first-child {
+    margin-top: 0.875rem;
+  }
+
+  > :last-child {
+    margin-bottom: 0.875rem;
+  }
+}
+
+// Expanded state
+.accordion-item.active {
+  .accordion-header::after {
+    transform: rotate(-135deg);
+  }
+
+  .accordion-body {
+    max-height: 100vh;
+  }
+}
+
+// Flush variant (no outer border)
+.accordion-flush {
+  border: 0;
+  border-radius: 0;
+
+  .accordion-item {
+    border-left: 0;
+    border-right: 0;
+  }
+}
+
+// ============================================================================
+// STYLED LISTS
+// ============================================================================
+
+.list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.list-item {
+  padding: 0.625rem 1rem;
+  font-size: var(--text-sm);
+  color: var(--text-primary);
+}
+
+.list-bordered .list-item {
+  border-bottom: 1px solid var(--border-default);
+
+  &:last-child {
+    border-bottom: 0;
+  }
+}
+
+.list-hover .list-item {
+  @include transition-interactive(var(--transition-normal));
+  cursor: pointer;
+  @include hover-state;
+}
+
+.list-flush {
+  .list-item:first-child {
+    padding-top: 0;
+  }
+
+  .list-item:last-child {
+    padding-bottom: 0;
+  }
+}