@ivds/core 0.1.1

package/src/components/checkbox/_checkbox-mixin.scss

@@ -0,0 +1,208 @@
+// Checkbox component mixins and private styles
+// This file contains mixins for checkbox variants, sizes, states, and internal utilities
+
+@use '../../variables/variables' as vars;
+
+// Base checkbox mixin with common styles
+@mixin checkbox-base {
+  position: relative;
+  display: inline-flex;
+  align-items: flex-start;
+  cursor: pointer;
+  user-select: none;
+  
+  &:hover .ivds-checkbox__box {
+    border-color: var(--color-brand-primary-400, #fb923c);
+  }
+}
+
+// Hidden input mixin
+@mixin checkbox-input {
+  position: absolute;
+  opacity: 0;
+  width: 1px;
+  height: 1px;
+  margin: 0;
+  padding: 0;
+  border: 0;
+  clip: rect(0, 0, 0, 0);
+  overflow: hidden;
+}
+
+// Checkbox box mixin
+@mixin checkbox-box($size: 18px, $border-radius: var(--borderRadius-sm, 0.125rem)) {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: $size;
+  height: $size;
+  min-width: $size;
+  border: var(--borderWidth-1, 1px) solid var(--color-semantic-neutral-300, #cbd5e1);
+  border-radius: $border-radius;
+  background-color: var(--color-semantic-neutral-50, #f8fafc);
+  transition: all 0.15s ease-in-out;
+  
+  &::after {
+    content: '';
+    position: absolute;
+    width: 10px;
+    height: 6px;
+    border: 2px solid transparent;
+    border-top: none;
+    border-right: none;
+    transform: rotate(-45deg) scale(0);
+    transition: transform 0.15s ease-in-out;
+  }
+}
+
+// Checkbox label mixin
+@mixin checkbox-label($font-size: var(--fontSize-base, 1rem), $gap: var(--spacing-3, 0.75rem)) {
+  margin-left: $gap;
+  font-size: $font-size;
+  color: var(--color-semantic-neutral-900, #0f172a);
+  line-height: var(--lineHeight-normal, 1.5);
+}
+
+// Checkbox checked state mixin
+@mixin checkbox-checked($bg-color: var(--color-brand-primary-500, #f97316), $border-color: var(--color-brand-primary-500, #f97316)) {
+  background-color: $bg-color;
+  border-color: $border-color;
+  
+  &::after {
+    border-color: var(--color-semantic-neutral-50, #f8fafc);
+    transform: rotate(-45deg) scale(1);
+  }
+}
+
+// Checkbox focus state mixin
+@mixin checkbox-focus {
+  outline: 2px solid var(--color-brand-primary-500, #f97316);
+  outline-offset: 2px;
+}
+
+// Checkbox disabled state mixin
+@mixin checkbox-disabled {
+  cursor: not-allowed;
+  opacity: 0.6;
+  
+  .ivds-checkbox__box {
+    background-color: var(--color-semantic-neutral-100, #f1f5f9);
+    border-color: var(--color-semantic-neutral-200, #e2e8f0);
+    cursor: not-allowed;
+  }
+  
+  .ivds-checkbox__label {
+    color: var(--color-semantic-neutral-500, #64748b);
+    cursor: not-allowed;
+  }
+}
+
+// Checkbox indeterminate state mixin
+@mixin checkbox-indeterminate($bg-color: var(--color-brand-primary-500, #f97316)) {
+  background-color: $bg-color;
+  border-color: $bg-color;
+  
+  &::after {
+    content: '';
+    width: 8px;
+    height: 2px;
+    border: none;
+    background-color: var(--color-semantic-neutral-50, #f8fafc);
+    transform: none;
+    border-radius: 1px;
+  }
+}
+
+// Checkbox error state mixin
+@mixin checkbox-error {
+  .ivds-checkbox__box {
+    border-color: var(--color-semantic-error-500, #ef4444);
+  }
+  
+  &:hover .ivds-checkbox__box {
+    border-color: var(--color-semantic-error-600, #dc2626);
+  }
+  
+  .ivds-checkbox__input:checked + .ivds-checkbox__box {
+    background-color: var(--color-semantic-error-500, #ef4444);
+    border-color: var(--color-semantic-error-500, #ef4444);
+  }
+  
+  .ivds-checkbox__input:focus + .ivds-checkbox__box {
+    outline-color: var(--color-semantic-error-500, #ef4444);
+  }
+}
+
+// Checkbox success state mixin
+@mixin checkbox-success {
+  .ivds-checkbox__box {
+    border-color: var(--color-semantic-success-500, #10b981);
+  }
+  
+  &:hover .ivds-checkbox__box {
+    border-color: var(--color-semantic-success-600, #059669);
+  }
+  
+  .ivds-checkbox__input:checked + .ivds-checkbox__box {
+    background-color: var(--color-semantic-success-500, #10b981);
+    border-color: var(--color-semantic-success-500, #10b981);
+  }
+  
+  .ivds-checkbox__input:focus + .ivds-checkbox__box {
+    outline-color: var(--color-semantic-success-500, #10b981);
+  }
+}
+
+// Checkbox size variants
+@mixin checkbox-small {
+  .ivds-checkbox__box {
+    @include checkbox-box(14px);
+    
+    &::after {
+      width: 7px;
+      height: 4px;
+    }
+  }
+  
+  .ivds-checkbox__label {
+    @include checkbox-label(var(--fontSize-sm, 0.875rem), var(--spacing-2, 0.5rem));
+  }
+}
+
+@mixin checkbox-large {
+  .ivds-checkbox__box {
+    @include checkbox-box(22px);
+    
+    &::after {
+      width: 12px;
+      height: 8px;
+    }
+  }
+  
+  .ivds-checkbox__label {
+    @include checkbox-label(var(--fontSize-lg, 1.125rem), var(--spacing-4, 1rem));
+  }
+}
+
+// Checkbox group mixin
+@mixin checkbox-group($gap: var(--spacing-3, 0.75rem)) {
+  display: flex;
+  flex-direction: column;
+  gap: $gap;
+  
+  &--horizontal {
+    flex-direction: row;
+    flex-wrap: wrap;
+    gap: var(--spacing-6, 1.5rem);
+  }
+}
+
+// Checkbox description mixin
+@mixin checkbox-description {
+  margin-top: var(--spacing-1, 0.25rem);
+  margin-left: calc(18px + var(--spacing-3, 0.75rem));
+  font-size: var(--fontSize-sm, 0.875rem);
+  color: var(--color-semantic-neutral-600, #4b5563);
+  line-height: var(--lineHeight-relaxed, 1.625);
+}

package/src/components/checkbox/checkbox.scss

@@ -0,0 +1,141 @@
+// Checkbox component styles
+// Provides styling for the IVDS checkbox component with all variants, sizes, and states
+
+@use '_checkbox-mixin' as checkbox;
+
+
+
+// Checkbox Base
+.ivds-checkbox {
+  @include checkbox.checkbox-base;
+  
+  // Checkbox box
+  &__box {
+    @include checkbox.checkbox-box;
+  }
+  
+  // Hidden input
+  &__input {
+    @include checkbox.checkbox-input;
+    
+    // Checked state
+    &:checked + .ivds-checkbox__box {
+      @include checkbox.checkbox-checked;
+    }
+    
+    // Focus state
+    &:focus + .ivds-checkbox__box {
+      @include checkbox.checkbox-focus;
+    }
+    
+    // Indeterminate state
+    &:indeterminate + .ivds-checkbox__box {
+      @include checkbox.checkbox-indeterminate;
+    }
+  }
+  
+  // Checkbox label
+  &__label {
+    @include checkbox.checkbox-label;
+  }
+  
+  // Checkbox description
+  &__description {
+    @include checkbox.checkbox-description;
+  }
+  
+  // Disabled state
+  &--disabled {
+    @include checkbox.checkbox-disabled;
+  }
+  
+  // Error state
+  &--error {
+    @include checkbox.checkbox-error;
+  }
+  
+  // Success state
+  &--success {
+    @include checkbox.checkbox-success;
+  }
+}
+
+// Checkbox Sizes
+.ivds-checkbox--small {
+  @include checkbox.checkbox-small;
+}
+
+.ivds-checkbox--large {
+  @include checkbox.checkbox-large;
+}
+
+// Checkbox Group
+.ivds-checkbox-group {
+  @include checkbox.checkbox-group;
+  
+  &--horizontal {
+    @include checkbox.checkbox-group;
+    
+    flex-direction: row;
+    flex-wrap: wrap;
+    gap: var(--spacing-6, 1.5rem);
+  }
+  
+  // Group label
+  &__label {
+    display: block;
+    font-size: var(--fontSize-base, 1rem);
+    font-weight: var(--fontWeight-medium, 500);
+    color: var(--color-semantic-neutral-900, #0f172a);
+    margin-bottom: var(--spacing-3, 0.75rem);
+    
+    &--required::after {
+      content: ' *';
+      color: var(--color-semantic-error-500, #ef4444);
+    }
+  }
+  
+  // Group description
+  &__description {
+    font-size: var(--fontSize-sm, 0.875rem);
+    color: var(--color-semantic-neutral-600, #4b5563);
+    margin-bottom: var(--spacing-3, 0.75rem);
+  }
+  
+  // Group error message
+  &__error {
+    margin-top: var(--spacing-2, 0.5rem);
+    font-size: var(--fontSize-sm, 0.875rem);
+    color: var(--color-semantic-error-600, #dc2626);
+    
+    &::before {
+      content: '⚠ ';
+      margin-right: var(--spacing-1, 0.25rem);
+    }
+  }
+}
+
+// Checkbox Card variant (for more prominent selections)
+.ivds-checkbox--card {
+  padding: var(--spacing-4, 1rem);
+  border: var(--borderWidth-1, 1px) solid var(--color-semantic-neutral-200, #e2e8f0);
+  border-radius: var(--borderRadius-md, 0.375rem);
+  background-color: var(--color-semantic-neutral-50, #f8fafc);
+  transition: all 0.15s ease-in-out;
+  
+  &:hover {
+    border-color: var(--color-brand-primary-300, #fdba74);
+    background-color: var(--color-brand-primary-50, #fff7ed);
+  }
+  
+  .ivds-checkbox__input:checked ~ & {
+    border-color: var(--color-brand-primary-500, #f97316);
+    background-color: var(--color-brand-primary-50, #fff7ed);
+  }
+  
+  .ivds-checkbox__input:focus ~ & {
+    outline: 2px solid var(--color-brand-primary-500, #f97316);
+    outline-offset: 2px;
+  }
+}
+

package/src/components/checkbox/checkbox.stories.js

@@ -0,0 +1,303 @@
+// Checkbox component stories for Storybook
+// Showcases all checkbox variants, sizes, states, and features
+
+export default {
+  title: 'Core/Checkbox',
+  parameters: {
+    docs: {
+      description: {
+        component: 'CSS-only checkbox component using IVDS design tokens. Provides multiple variants, sizes, states, and features for form selections.'
+      }
+    },
+    a11y: {
+      config: {
+        rules: [
+          {
+            id: 'color-contrast',
+            enabled: true
+          },
+          {
+            id: 'label-title-only',
+            enabled: true
+          }
+        ]
+      }
+    }
+  }
+};
+
+// Basic checkbox
+export const Default = () => `
+  <label class="ivds-checkbox">
+    <input type="checkbox" class="ivds-checkbox__input" />
+    <div class="ivds-checkbox__box"></div>
+    <span class="ivds-checkbox__label">Default Checkbox</span>
+  </label>
+`;
+
+// Checkbox with description
+export const WithDescription = () => `
+  <label class="ivds-checkbox">
+    <input type="checkbox" class="ivds-checkbox__input" />
+    <div class="ivds-checkbox__box"></div>
+    <div>
+      <span class="ivds-checkbox__label">Email Notifications</span>
+      <div class="ivds-checkbox__description">
+        Receive email updates about your account activity and important announcements.
+      </div>
+    </div>
+  </label>
+`;
+
+// Checkbox sizes
+export const Sizes = () => `
+  <div style="display: flex; flex-direction: column; gap: 1.5rem;">
+    <label class="ivds-checkbox ivds-checkbox--small">
+      <input type="checkbox" class="ivds-checkbox__input" />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Small Checkbox</span>
+    </label>
+    
+    <label class="ivds-checkbox">
+      <input type="checkbox" class="ivds-checkbox__input" />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Default Checkbox</span>
+    </label>
+    
+    <label class="ivds-checkbox ivds-checkbox--large">
+      <input type="checkbox" class="ivds-checkbox__input" />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Large Checkbox</span>
+    </label>
+  </div>
+`;
+
+// Checkbox states
+export const States = () => `
+  <div style="display: flex; flex-direction: column; gap: 1.5rem;">
+    <label class="ivds-checkbox">
+      <input type="checkbox" class="ivds-checkbox__input" />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Unchecked</span>
+    </label>
+    
+    <label class="ivds-checkbox">
+      <input type="checkbox" class="ivds-checkbox__input" checked />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Checked</span>
+    </label>
+    
+    <label class="ivds-checkbox">
+      <input type="checkbox" class="ivds-checkbox__input" />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Indeterminate</span>
+    </label>
+    
+    <script>
+      // Set indeterminate state for demo
+      document.addEventListener('DOMContentLoaded', function() {
+        const indeterminateCheckbox = document.querySelectorAll('.ivds-checkbox__input')[2];
+        if (indeterminateCheckbox) {
+          indeterminateCheckbox.indeterminate = true;
+        }
+      });
+    </script>
+  </div>
+`;
+
+// Disabled states
+export const DisabledStates = () => `
+  <div style="display: flex; flex-direction: column; gap: 1.5rem;">
+    <label class="ivds-checkbox ivds-checkbox--disabled">
+      <input type="checkbox" class="ivds-checkbox__input" disabled />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Disabled Unchecked</span>
+    </label>
+    
+    <label class="ivds-checkbox ivds-checkbox--disabled">
+      <input type="checkbox" class="ivds-checkbox__input" checked disabled />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Disabled Checked</span>
+    </label>
+  </div>
+`;
+
+// Validation states
+export const ValidationStates = () => `
+  <div style="display: flex; flex-direction: column; gap: 1.5rem;">
+    <label class="ivds-checkbox ivds-checkbox--error">
+      <input type="checkbox" class="ivds-checkbox__input" />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Error State</span>
+    </label>
+    
+    <label class="ivds-checkbox ivds-checkbox--success">
+      <input type="checkbox" class="ivds-checkbox__input" checked />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Success State</span>
+    </label>
+  </div>
+`;
+
+// Checkbox groups
+export const CheckboxGroups = () => `
+  <div style="display: flex; flex-direction: column; gap: 2rem;">
+    <div class="ivds-checkbox-group">
+      <div class="ivds-checkbox-group__label">
+        Preferred Contact Methods
+      </div>
+      <div class="ivds-checkbox-group__description">
+        Select all the ways you'd like us to contact you.
+      </div>
+      
+      <label class="ivds-checkbox">
+        <input type="checkbox" class="ivds-checkbox__input" name="contact" value="email" />
+        <div class="ivds-checkbox__box"></div>
+        <span class="ivds-checkbox__label">Email</span>
+      </label>
+      
+      <label class="ivds-checkbox">
+        <input type="checkbox" class="ivds-checkbox__input" name="contact" value="phone" />
+        <div class="ivds-checkbox__box"></div>
+        <span class="ivds-checkbox__label">Phone</span>
+      </label>
+      
+      <label class="ivds-checkbox">
+        <input type="checkbox" class="ivds-checkbox__input" name="contact" value="sms" />
+        <div class="ivds-checkbox__box"></div>
+        <span class="ivds-checkbox__label">SMS</span>
+      </label>
+    </div>
+    
+    <div class="ivds-checkbox-group ivds-checkbox-group--horizontal">
+      <div class="ivds-checkbox-group__label ivds-checkbox-group__label--required">
+        Terms and Conditions
+      </div>
+      
+      <label class="ivds-checkbox">
+        <input type="checkbox" class="ivds-checkbox__input" required />
+        <div class="ivds-checkbox__box"></div>
+        <span class="ivds-checkbox__label">I agree to the Terms of Service</span>
+      </label>
+      
+      <label class="ivds-checkbox">
+        <input type="checkbox" class="ivds-checkbox__input" />
+        <div class="ivds-checkbox__box"></div>
+        <span class="ivds-checkbox__label">I agree to receive marketing emails</span>
+      </label>
+    </div>
+  </div>
+`;
+
+// Card variant
+export const CardVariant = () => `
+  <div style="display: flex; flex-direction: column; gap: 1rem; max-width: 400px;">
+    <label class="ivds-checkbox">
+      <input type="checkbox" class="ivds-checkbox__input" />
+      <div class="ivds-checkbox__box"></div>
+      <div class="ivds-checkbox--card">
+        <div class="ivds-checkbox__label" style="font-weight: 500; margin-bottom: 0.25rem;">
+          Premium Plan
+        </div>
+        <div class="ivds-checkbox__description" style="margin-left: 0;">
+          Access to all features, priority support, and advanced analytics.
+        </div>
+      </div>
+    </label>
+    
+    <label class="ivds-checkbox">
+      <input type="checkbox" class="ivds-checkbox__input" />
+      <div class="ivds-checkbox__box"></div>
+      <div class="ivds-checkbox--card">
+        <div class="ivds-checkbox__label" style="font-weight: 500; margin-bottom: 0.25rem;">
+          Basic Plan
+        </div>
+        <div class="ivds-checkbox__description" style="margin-left: 0;">
+          Essential features for getting started.
+        </div>
+      </div>
+    </label>
+  </div>
+`;
+
+
+
+// Checkbox group with error
+export const GroupWithError = () => `
+  <div class="ivds-checkbox-group">
+    <div class="ivds-checkbox-group__label ivds-checkbox-group__label--required">
+      Required Selection
+    </div>
+    <div class="ivds-checkbox-group__description">
+      Please select at least one option to continue.
+    </div>
+    
+    <label class="ivds-checkbox ivds-checkbox--error">
+      <input type="checkbox" class="ivds-checkbox__input" name="required-group" />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Option 1</span>
+    </label>
+    
+    <label class="ivds-checkbox ivds-checkbox--error">
+      <input type="checkbox" class="ivds-checkbox__input" name="required-group" />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Option 2</span>
+    </label>
+    
+    <label class="ivds-checkbox ivds-checkbox--error">
+      <input type="checkbox" class="ivds-checkbox__input" name="required-group" />
+      <div class="ivds-checkbox__box"></div>
+      <span class="ivds-checkbox__label">Option 3</span>
+    </label>
+    
+    <div class="ivds-checkbox-group__error">
+      Please select at least one option.
+    </div>
+  </div>
+`;
+
+// Accessibility example
+export const AccessibilityFeatures = () => `
+  <div style="display: flex; flex-direction: column; gap: 1.5rem; max-width: 500px;">
+    <div class="ivds-checkbox-group" role="group" aria-labelledby="preferences-label">
+      <div id="preferences-label" class="ivds-checkbox-group__label">
+        Privacy Preferences
+      </div>
+      <div class="ivds-checkbox-group__description">
+        Choose your privacy settings. You can change these at any time.
+      </div>
+      
+      <label class="ivds-checkbox">
+        <input 
+          type="checkbox" 
+          class="ivds-checkbox__input" 
+          id="analytics-checkbox"
+          aria-describedby="analytics-description"
+        />
+        <div class="ivds-checkbox__box"></div>
+        <div>
+          <span class="ivds-checkbox__label">Allow Analytics</span>
+          <div id="analytics-description" class="ivds-checkbox__description">
+            Help us improve our service by sharing anonymous usage data.
+          </div>
+        </div>
+      </label>
+      
+      <label class="ivds-checkbox">
+        <input 
+          type="checkbox" 
+          class="ivds-checkbox__input" 
+          id="marketing-checkbox"
+          aria-describedby="marketing-description"
+        />
+        <div class="ivds-checkbox__box"></div>
+        <div>
+          <span class="ivds-checkbox__label">Marketing Communications</span>
+          <div id="marketing-description" class="ivds-checkbox__description">
+            Receive updates about new features and special offers.
+          </div>
+        </div>
+      </label>
+    </div>
+  </div>
+`;