@shift-css/core 0.4.0 → 0.6.0

package/README.md

@@ -0,0 +1,110 @@
+# @shift-css/core
+
+A zero-runtime, OKLCH-native CSS framework with automatic theming.
+
+[![npm version](https://img.shields.io/npm/v/@shift-css/core)](https://www.npmjs.com/package/@shift-css/core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## Installation
+
+```bash
+npm install @shift-css/core
+# or
+bun add @shift-css/core
+# or
+pnpm add @shift-css/core
+```
+
+## Usage
+
+```css
+/* Full framework */
+@import "@shift-css/core";
+
+/* Or minified for production */
+@import "@shift-css/core/min";
+```
+
+```html
+<div s-surface="raised">
+  <h2>Hello Shift</h2>
+  <button s-btn="primary">Get Started</button>
+</div>
+```
+
+No configuration, no JavaScript, no build step for customization.
+
+## Features
+
+- **Zero JavaScript** - Theming works without any runtime code
+- **Perceptually uniform colors** - OKLCH ensures consistent brightness across your palette
+- **Automatic contrast** - Text colors adapt to any background automatically
+- **Clean specificity** - Cascade layers mean no more `!important` battles
+- **One-line customization** - Change a single hue variable to transform your entire palette
+
+```css
+/* Change your entire brand palette with one line */
+:root {
+  --shift-hue-primary: 280; /* Purple instead of blue */
+}
+```
+
+## Customization
+
+Override seed hues to transform your entire palette:
+
+```css
+:root {
+  --shift-hue-primary: 280; /* Purple */
+  --shift-hue-secondary: 200; /* Teal */
+  --shift-hue-accent: 45; /* Gold */
+  --shift-hue-neutral: 280; /* Purple-tinted grays */
+}
+```
+
+## Modular Imports
+
+Import only what you need:
+
+```css
+/* Reset only */
+@import "@shift-css/core/reset";
+
+/* Tokens only */
+@import "@shift-css/core/tokens";
+```
+
+## Bundle Size
+
+| File            | Size   |
+| --------------- | ------ |
+| `shift.css`     | ~55 KB |
+| `shift.min.css` | ~41 KB |
+| Gzipped         | ~10 KB |
+
+## Browser Support
+
+| Browser | Minimum Version |
+| ------- | --------------- |
+| Chrome  | 131+            |
+| Firefox | 133+            |
+| Safari  | 18+             |
+| Edge    | 131+            |
+
+## Documentation
+
+Full documentation at [getshiftcss.com](https://getshiftcss.com)
+
+## CLI
+
+Use the CLI to initialize Shift CSS with proper cascade layers:
+
+```bash
+npx shift-css init
+```
+
+See [@shift-css/cli](https://www.npmjs.com/package/@shift-css/cli) for details.
+
+## License
+
+MIT

package/dist/components/badge.css

@@ -0,0 +1,162 @@
+:where([s-badge]) {
+  --_badge-bg: var(--s-neutral-200);
+  --_badge-text: var(--s-text-primary);
+  justify-content: center;
+  align-items: center;
+  gap: var(--s-space-1);
+  padding: var(--s-space-1) var(--s-space-2);
+  border-radius: var(--s-radius-sm);
+  font-weight: var(--s-font-medium);
+  font-size: var(--s-text-xs);
+  white-space: nowrap;
+  vertical-align: middle;
+  background-color: var(--_badge-bg);
+  color: var(--_badge-text);
+  line-height: 1.25;
+  display: inline-flex;
+
+  @supports (color: oklch(from red l c h)) {
+    color: oklch(from var(--_badge-bg) clamp(.15, calc((.55 - l) * 1000 + .15), .95) 0 0);
+  }
+
+  @supports (color: contrast-color(red)) {
+    color: contrast-color(var(--_badge-bg));
+  }
+}
+
+[s-badge="primary"] {
+  --_badge-bg: var(--s-primary-700);
+  background-color: var(--s-primary-700);
+  color: #fff;
+}
+
+[s-badge="secondary"] {
+  --_badge-bg: var(--s-neutral-700);
+  background-color: var(--s-neutral-700);
+  color: #fff;
+}
+
+[s-badge="success"] {
+  --_badge-bg: var(--s-success-700);
+  background-color: var(--s-success-700);
+  color: #fff;
+}
+
+[s-badge="warning"] {
+  --_badge-bg: var(--s-warning-400);
+  background-color: var(--s-warning-400);
+  color: var(--s-warning-950);
+}
+
+[s-badge="danger"] {
+  --_badge-bg: var(--s-danger-700);
+  background-color: var(--s-danger-700);
+  color: #fff;
+}
+
+[s-badge="accent"] {
+  --_badge-bg: var(--s-accent-700);
+  background-color: var(--s-accent-700);
+  color: #fff;
+}
+
+[s-badge="outline"] {
+  --_badge-bg: transparent;
+  color: var(--s-text-primary);
+  box-shadow: inset 0 0 0 1px var(--s-border-default);
+  background-color: #0000;
+}
+
+[s-badge="outline-primary"] {
+  --_badge-bg: transparent;
+  background-color: oklch(from var(--s-primary-500) l c h / .1);
+  color: light-dark(var(--s-primary-700), var(--s-primary-300));
+  box-shadow: inset 0 0 0 1px light-dark(var(--s-primary-500), var(--s-primary-400));
+}
+
+[s-badge="outline-success"] {
+  --_badge-bg: transparent;
+  background-color: oklch(from var(--s-success-500) l c h / .1);
+  color: light-dark(var(--s-success-700), var(--s-success-300));
+  box-shadow: inset 0 0 0 1px light-dark(var(--s-success-500), var(--s-success-400));
+}
+
+[s-badge="outline-warning"] {
+  --_badge-bg: transparent;
+  background-color: oklch(from var(--s-warning-500) l c h / .1);
+  color: light-dark(var(--s-warning-800), var(--s-warning-300));
+  box-shadow: inset 0 0 0 1px light-dark(var(--s-warning-500), var(--s-warning-400));
+}
+
+[s-badge="outline-danger"] {
+  --_badge-bg: transparent;
+  background-color: oklch(from var(--s-danger-500) l c h / .1);
+  color: light-dark(var(--s-danger-800), var(--s-danger-300));
+  box-shadow: inset 0 0 0 1px light-dark(var(--s-danger-500), var(--s-danger-400));
+}
+
+[s-badge][s-size="sm"] {
+  padding: .125rem .375rem;
+  font-size: .625rem;
+}
+
+[s-badge][s-size="lg"] {
+  padding: var(--s-space-2) var(--s-space-4);
+  font-size: var(--s-text-sm);
+}
+
+[s-badge][s-pill] {
+  border-radius: var(--s-radius-full);
+}
+
+[s-badge][s-dot] {
+  border-radius: var(--s-radius-full);
+  width: .5rem;
+  height: .5rem;
+  padding: 0;
+}
+
+[s-badge][s-dot][s-size="sm"] {
+  width: .375rem;
+  height: .375rem;
+}
+
+[s-badge][s-dot][s-size="lg"] {
+  width: .75rem;
+  height: .75rem;
+}
+
+@media (forced-colors: active) {
+  [s-badge] {
+    border: 1px solid canvastext;
+  }
+}
+
+@supports (container-type: inline-size) {
+  @container surface style(--_surface-depth: 1) {
+    :where([s-badge=""]) {
+      --_badge-bg: var(--s-neutral-300);
+    }
+
+    :where([s-badge="outline"]) {
+      box-shadow: inset 0 0 0 1px var(--s-border-strong);
+    }
+  }
+
+  @container surface style(--_surface-depth: 2) {
+    :where([s-badge=""]) {
+      --_badge-bg: var(--s-neutral-300);
+      box-shadow: var(--s-shadow-sm);
+    }
+
+    :where([s-badge="outline"]) {
+      box-shadow: inset 0 0 0 1px var(--s-border-strong);
+    }
+  }
+
+  @container surface style(--_surface-depth: -1) {
+    :where([s-badge=""]) {
+      --_badge-bg: var(--s-neutral-100);
+    }
+  }
+}

package/dist/components/button.css

@@ -0,0 +1,214 @@
+:where([s-btn]) {
+  --_btn-bg: var(--s-interactive-primary);
+  --_btn-text: var(--s-text-inverse);
+  --_btn-border: transparent;
+  justify-content: center;
+  align-items: center;
+  gap: var(--s-space-2);
+  padding: var(--s-space-2) var(--s-space-4);
+  border-radius: var(--s-radius-md);
+  font-weight: var(--s-font-semibold);
+  font-size: var(--s-text-sm);
+  white-space: nowrap;
+  background-color: var(--_btn-bg);
+  color: var(--_btn-text);
+  border: 1px solid var(--_btn-border);
+  line-height: 1;
+  display: inline-flex;
+
+  @supports (color: oklch(from red l c h)) {
+    color: oklch(from var(--_btn-bg) clamp(.15, calc((.55 - l) * 1000 + .15), .95) 0 0);
+  }
+
+  @supports (color: contrast-color(red)) {
+    color: contrast-color(var(--_btn-bg));
+  }
+
+  transition: background-color var(--s-duration-150) var(--s-ease-out), border-color var(--s-duration-150) var(--s-ease-out), transform var(--s-duration-100) var(--s-ease-out);
+  cursor: pointer;
+  user-select: none;
+
+  &:hover:not(:disabled) {
+    background-color: var(--s-interactive-primary-hover);
+
+    @supports (color: oklch(from red l c h)) and (color: light-dark(red, blue)) {
+      background-color: light-dark(oklch(from var(--_btn-bg) calc(l * .92) c h), oklch(from var(--_btn-bg) min(calc(l * 1.1), .95) c h));
+    }
+  }
+
+  &:active:not(:disabled) {
+    background-color: var(--s-interactive-primary-active);
+
+    @supports (color: oklch(from red l c h)) and (color: light-dark(red, blue)) {
+      background-color: light-dark(oklch(from var(--_btn-bg) calc(l * .85) c h), oklch(from var(--_btn-bg) min(calc(l * 1.2), .98) c h));
+    }
+
+    transform: scale(.98);
+  }
+
+  &:focus-visible {
+    outline: 2px solid var(--s-focus-ring);
+    outline-offset: 2px;
+  }
+
+  &:disabled {
+    opacity: .5;
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+}
+
+[s-btn="primary"] {
+  --_btn-bg: var(--s-interactive-primary);
+  --_btn-text: var(--s-text-inverse);
+}
+
+[s-btn="secondary"] {
+  --_btn-bg: var(--s-surface-raised);
+  --_btn-text: var(--s-text-primary);
+  --_btn-border: var(--s-border-default);
+  color: var(--_btn-text);
+}
+
+[s-btn="ghost"] {
+  --_btn-bg: transparent;
+  --_btn-text: var(--s-interactive-primary);
+  color: var(--_btn-text);
+
+  &:hover:not(:disabled) {
+    --_btn-bg: var(--s-surface-sunken);
+  }
+}
+
+[s-btn="link"] {
+  --_btn-bg: transparent;
+  --_btn-text: var(--s-interactive-primary);
+  --_btn-border: transparent;
+  color: var(--_btn-text);
+  text-underline-offset: 2px;
+  text-decoration: underline;
+
+  &:hover:not(:disabled) {
+    --_btn-text: var(--s-interactive-primary-hover);
+    color: var(--_btn-text);
+  }
+}
+
+[s-btn="outline"] {
+  --_btn-bg: transparent;
+  --_btn-text: var(--s-interactive-primary);
+  --_btn-border: var(--s-interactive-primary);
+  color: var(--_btn-text);
+
+  &:hover:not(:disabled) {
+    --_btn-bg: var(--s-interactive-primary);
+    background-color: var(--s-interactive-primary);
+    color: var(--s-text-inverse);
+  }
+}
+
+[s-btn="danger"] {
+  --_btn-bg: var(--s-state-danger);
+}
+
+[s-btn="success"] {
+  --_btn-bg: var(--s-state-success);
+}
+
+[s-btn="warning"] {
+  --_btn-bg: var(--s-state-warning);
+}
+
+[s-btn][s-size="sm"] {
+  padding: var(--s-space-1) var(--s-space-3);
+  font-size: var(--s-text-xs);
+}
+
+[s-btn][s-size="lg"] {
+  padding: var(--s-space-3) var(--s-space-6);
+  font-size: var(--s-text-base);
+}
+
+[s-btn][s-size="xl"] {
+  padding: var(--s-space-4) var(--s-space-8);
+  font-size: var(--s-text-lg);
+}
+
+[s-btn][s-icon] {
+  padding: var(--s-space-2);
+  aspect-ratio: 1;
+}
+
+[s-btn][s-block] {
+  width: 100%;
+}
+
+[s-btn][s-loading] {
+  color: var(--_btn-bg);
+  pointer-events: none;
+  position: relative;
+
+  &:after {
+    content: "";
+    border: 2px solid var(--s-text-inverse);
+    border-right-color: #0000;
+    border-radius: 50%;
+    width: 1em;
+    height: 1em;
+    margin: auto;
+    animation: .6s linear infinite s-btn-spin;
+    position: absolute;
+    inset: 0;
+  }
+}
+
+@keyframes s-btn-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+[s-btn-group] {
+  display: inline-flex;
+
+  & > [s-btn] {
+    border-radius: 0;
+
+    &:first-child {
+      border-radius: var(--s-radius-md) 0 0 var(--s-radius-md);
+    }
+
+    &:last-child {
+      border-radius: 0 var(--s-radius-md) var(--s-radius-md) 0;
+    }
+
+    &:not(:last-child) {
+      border-right: none;
+    }
+  }
+}
+
+@supports (container-type: inline-size) {
+  @container surface style(--_surface-depth: 1) {
+    :where([s-btn="secondary"]) {
+      --_btn-border: var(--s-border-strong);
+    }
+  }
+
+  @container surface style(--_surface-depth: 2) {
+    :where([s-btn="secondary"]) {
+      --_btn-border: var(--s-border-strong);
+      --_btn-bg: var(--s-surface-base);
+    }
+
+    :where([s-btn="ghost"]) {
+      --_btn-border: var(--s-border-muted);
+    }
+  }
+
+  @container surface style(--_surface-depth: -1) {
+    :where([s-btn="secondary"]) {
+      --_btn-bg: var(--s-surface-base);
+    }
+  }
+}

package/dist/components/card.css

@@ -0,0 +1,185 @@
+:where([s-card]) {
+  --_card-bg: var(--s-surface-raised);
+  --_card-border: var(--s-border-muted);
+  --_card-radius: var(--s-radius-xl);
+  --_card-shadow: var(--s-shadow-base);
+  --_card-padding: var(--s-space-4);
+  background-color: var(--_card-bg);
+  border: 1px solid var(--_card-border);
+  border-radius: var(--_card-radius);
+  box-shadow: var(--_card-shadow);
+  color: var(--s-text-primary);
+  flex-direction: column;
+  display: flex;
+  overflow: hidden;
+  container-type: inline-size;
+
+  @supports (color: oklch(from red l c h)) {
+    color: oklch(from var(--_card-bg) clamp(.15, calc((.55 - l) * 1000 + .15), .95) 0 0);
+  }
+}
+
+[s-card-header] {
+  padding: var(--_card-padding, var(--s-space-4));
+  border-bottom: 1px solid var(--_card-border, var(--s-border-muted));
+}
+
+[s-card-body] {
+  padding: var(--_card-padding, var(--s-space-4));
+  flex: 1;
+}
+
+[s-card-footer] {
+  padding: var(--_card-padding, var(--s-space-4));
+  border-top: 1px solid var(--_card-border, var(--s-border-muted));
+}
+
+[s-card-media] {
+  aspect-ratio: 16 / 9;
+  overflow: hidden;
+
+  & > img {
+    object-fit: cover;
+    width: 100%;
+    height: 100%;
+  }
+}
+
+[s-card-title] {
+  font-size: var(--s-text-lg);
+  font-weight: var(--s-font-semibold);
+  line-height: var(--s-leading-tight);
+  margin-bottom: var(--s-space-1);
+}
+
+[s-card-subtitle] {
+  font-size: var(--s-text-sm);
+  color: var(--s-text-secondary);
+}
+
+[s-card="flat"] {
+  --_card-shadow: none;
+  --_card-border: var(--s-border-default);
+}
+
+[s-card="elevated"], [s-card][s-surface="raised"] {
+  --_card-shadow: var(--s-shadow-lg);
+  --_card-border: oklch(0% 0 0 / 0);
+}
+
+[s-card][s-surface="floating"] {
+  --_card-shadow: var(--s-shadow-xl);
+  --_card-border: oklch(0% 0 0 / 0);
+}
+
+[s-card="outline"] {
+  --_card-shadow: none;
+  --_card-border: var(--s-border-strong);
+  --_card-bg: transparent;
+}
+
+[s-card][s-interactive] {
+  cursor: pointer;
+  transition: transform var(--s-duration-200) var(--s-ease-out), box-shadow var(--s-duration-200) var(--s-ease-out), border-color var(--s-duration-200) var(--s-ease-out);
+
+  &:hover {
+    --_card-shadow: var(--s-shadow-xl);
+    transform: translateY(-4px);
+
+    @supports (color: oklch(from red l c h)) {
+      border-color: oklch(from var(--_card-border) max(calc(l - .1), .05) c h);
+    }
+  }
+
+  &:active {
+    transform: translateY(-2px);
+  }
+
+  &:focus-visible {
+    outline: 2px solid var(--s-focus-ring);
+    outline-offset: 2px;
+  }
+}
+
+[s-card][s-link] {
+  position: relative;
+
+  & a:after {
+    content: "";
+    position: absolute;
+    inset: 0;
+  }
+}
+
+[s-card][s-horizontal] {
+  flex-direction: row;
+
+  & [s-card-media] {
+    aspect-ratio: 1;
+    flex-shrink: 0;
+    width: 33%;
+  }
+}
+
+@container (width <= 24rem) {
+  [s-card][s-horizontal] {
+    flex-direction: column;
+
+    & [s-card-media] {
+      aspect-ratio: 16 / 9;
+      width: 100%;
+    }
+  }
+}
+
+[s-card][s-size="sm"] {
+  --_card-padding: var(--s-space-3);
+  --_card-radius: var(--s-radius-lg);
+}
+
+[s-card][s-size="lg"] {
+  --_card-padding: var(--s-space-6);
+}
+
+[s-card="feature"] {
+  text-align: center;
+  --_card-padding: var(--s-space-6);
+}
+
+[s-card-icon] {
+  font-size: var(--s-text-4xl);
+  margin-bottom: var(--s-space-4);
+}
+
+[s-card-grid] {
+  gap: var(--s-space-4);
+  grid-template-columns: repeat(auto-fill, minmax(min(100%, 18rem), 1fr));
+  display: grid;
+}
+
+[s-card-stack] {
+  gap: var(--s-space-4);
+  flex-direction: column;
+  display: flex;
+}
+
+@supports (container-type: inline-size) {
+  @container surface style(--_surface-depth: 1) {
+    :where([s-card]) {
+      --_card-shadow: var(--s-shadow-sm);
+    }
+  }
+
+  @container surface style(--_surface-depth: 2) {
+    :where([s-card]) {
+      --_card-shadow: none;
+      --_card-border: var(--s-border-default);
+    }
+  }
+
+  @container surface style(--_surface-depth: -1) {
+    :where([s-card]) {
+      --_card-shadow: var(--s-shadow-md);
+    }
+  }
+}