mtrl 0.0.0 → 0.0.1

package/src/components/menu/features/visibility.js

@@ -0,0 +1,179 @@
+// src/components/menu/features/visibility.js
+import { MENU_EVENTS } from '../constants'
+
+/**
+ * Adds visibility management functionality to a menu component
+ * @param {Object} config - Menu configuration
+ * @param {string} config.prefix - CSS class prefix
+ * @returns {Function} Component enhancer
+ */
+export const withVisibility = (config) => (component) => {
+  let isVisible = false
+  let outsideClickHandler = null
+  let keydownHandler = null
+
+  // Create the component interface with hide/show methods first
+  const enhancedComponent = {
+    ...component,
+
+    /**
+     * Shows the menu
+     */
+    show () {
+      if (isVisible) return this
+
+      // First set visibility to true to prevent multiple calls
+      isVisible = true
+
+      // Make sure the element is in the DOM
+      if (!component.element.parentNode) {
+        document.body.appendChild(component.element)
+      }
+
+      // Always clean up previous handlers before adding new ones
+      if (outsideClickHandler) {
+        document.removeEventListener('mousedown', outsideClickHandler)
+      }
+
+      // Setup outside click handler for closing
+      outsideClickHandler = handleOutsideClick
+
+      // Use setTimeout to ensure the handler is not triggered immediately
+      setTimeout(() => {
+        document.addEventListener('mousedown', outsideClickHandler)
+      }, 0)
+
+      // Setup keyboard navigation
+      if (!keydownHandler) {
+        keydownHandler = handleKeydown
+        document.addEventListener('keydown', keydownHandler)
+      }
+
+      // Add display block first for transition to work
+      component.element.style.display = 'block'
+
+      // Force a reflow before adding the visible class for animation
+      component.element.offsetHeight
+      component.element.classList.add(`${config.prefix}-menu--visible`)
+      component.element.setAttribute('aria-hidden', 'false')
+
+      // Emit open event
+      component.emit(MENU_EVENTS.OPEN)
+
+      return this
+    },
+
+    /**
+     * Hides the menu
+     */
+    hide () {
+      // Return early if already hidden
+      if (!isVisible) return this
+
+      // First set the visibility flag to false
+      isVisible = false
+
+      // Close any open submenus first
+      if (component.closeSubmenus) {
+        component.closeSubmenus()
+      }
+
+      // Remove ALL event listeners
+      if (outsideClickHandler) {
+        document.removeEventListener('mousedown', outsideClickHandler)
+        outsideClickHandler = null
+      }
+
+      if (keydownHandler) {
+        document.removeEventListener('keydown', keydownHandler)
+        keydownHandler = null
+      }
+
+      // Hide the menu with visual indication first
+      component.element.classList.remove(`${config.prefix}-menu--visible`)
+      component.element.setAttribute('aria-hidden', 'true')
+
+      // Define a reliable cleanup function
+      const cleanupElement = () => {
+        // Safety check to prevent errors
+        if (component.element) {
+          component.element.style.display = 'none'
+
+          // Remove from DOM if still attached
+          if (component.element.parentNode) {
+            component.element.remove()
+          }
+        }
+      }
+
+      // Try to use transition end for smooth animation
+      const handleTransitionEnd = (e) => {
+        if (e.propertyName === 'opacity' || e.propertyName === 'transform') {
+          component.element.removeEventListener('transitionend', handleTransitionEnd)
+          cleanupElement()
+        }
+      }
+
+      component.element.addEventListener('transitionend', handleTransitionEnd)
+
+      // Fallback timeout in case transition events don't fire
+      // This ensures the menu always gets removed
+      setTimeout(cleanupElement, 300)
+
+      // Emit close event
+      component.emit(MENU_EVENTS.CLOSE)
+
+      return this
+    },
+
+    /**
+     * Returns whether the menu is currently visible
+     * @returns {boolean} Visibility state
+     */
+    isVisible () {
+      return isVisible
+    }
+  }
+
+  /**
+   * Handles clicks outside the menu
+   * @param {MouseEvent} event - Mouse event
+   */
+  const handleOutsideClick = (event) => {
+    if (!isVisible) return
+
+    // Store the opening button if available
+    const openingButton = config.openingButton?.element
+
+    // Check if click is outside the menu but not on the opening button
+    const clickedElement = event.target
+
+    // Don't close if the click is inside the menu
+    if (component.element.contains(clickedElement)) {
+      return
+    }
+
+    // Don't close if the click is on the opening button (it will handle opening/closing)
+    if (openingButton && (openingButton === clickedElement || openingButton.contains(clickedElement))) {
+      return
+    }
+
+    // If we got here, close the menu
+    enhancedComponent.hide()
+  }
+
+  /**
+   * Handles keyboard events
+   * @param {KeyboardEvent} event - Keyboard event
+   */
+  const handleKeydown = (event) => {
+    if (!isVisible) return
+
+    if (event.key === 'Escape') {
+      event.preventDefault()
+      enhancedComponent.hide()
+    }
+  }
+
+  return enhancedComponent
+}

package/src/components/menu/index.js

@@ -0,0 +1,2 @@
+// src/components/menu/index.js
+export { default } from './menu.js'

package/src/components/menu/menu-item.js

@@ -0,0 +1,41 @@
+// src/components/menu/menu-item.js
+
+/**
+ * Creates a menu item element
+ * @param {Object} itemConfig - Item configuration
+ * @param {string} prefix - CSS class prefix
+ * @returns {HTMLElement} Menu item element
+ */
+export const createMenuItem = (itemConfig, prefix) => {
+  const item = document.createElement('li')
+  item.className = `${prefix}-menu-item`
+
+  if (itemConfig.type === 'divider') {
+    item.className = `${prefix}-menu-divider`
+    return item
+  }
+
+  if (itemConfig.class) {
+    item.className += ` ${itemConfig.class}`
+  }
+
+  if (itemConfig.disabled) {
+    item.setAttribute('aria-disabled', 'true')
+    item.className += ` ${prefix}-menu-item--disabled`
+  }
+
+  if (itemConfig.name) {
+    item.setAttribute('data-name', itemConfig.name)
+  }
+
+  item.textContent = itemConfig.text || ''
+
+  if (itemConfig.items?.length) {
+    item.className += ` ${prefix}-menu-item--submenu`
+    item.setAttribute('aria-haspopup', 'true')
+    item.setAttribute('aria-expanded', 'false')
+    // We don't need to add a submenu indicator as it's handled by CSS ::after
+  }
+
+  return item
+}

package/src/components/menu/menu.js

@@ -0,0 +1,54 @@
+// src/components/menu/menu.js
+
+import { PREFIX } from '../../core/config'
+import { pipe } from '../../core/compose'
+import { createBase, withElement } from '../../core/compose/component'
+import { withEvents, withLifecycle } from '../../core/compose/features'
+import { withAPI } from './api'
+import { withVisibility } from './features/visibility'
+import { withItemsManager } from './features/items-manager'
+import { withPositioning } from './features/positioning'
+import { withKeyboardNavigation } from './features/keyboard-navigation'
+
+/**
+ * Creates a new Menu component
+ * @param {Object} config - Menu configuration
+ * @param {Array} [config.items] - Menu items
+ * @param {string} [config.class] - Additional CSS classes
+ * @param {HTMLElement} [config.target] - Target element for positioning
+ * @param {boolean} [config.stayOpenOnSelect] - Whether to keep the menu open after an item is selected
+ * @param {HTMLElement} [config.openingButton] - Button that opens the menu
+ * @returns {Object} Menu component instance
+ */
+const createMenu = (config = {}) => {
+  const baseConfig = {
+    ...config,
+    componentName: 'menu',
+    prefix: PREFIX
+  }
+
+  return pipe(
+    createBase,
+    withEvents(),
+    withElement({
+      tag: 'div',
+      componentName: 'menu',
+      className: config.class,
+      attrs: {
+        role: 'menu',
+        tabindex: '-1',
+        'aria-hidden': 'true'
+      }
+    }),
+    withLifecycle(),
+    withItemsManager(baseConfig),
+    withVisibility(baseConfig),
+    withPositioning,
+    withKeyboardNavigation(baseConfig),
+    comp => withAPI({
+      lifecycle: comp.lifecycle
+    })(comp)
+  )(baseConfig)
+}
+
+export default createMenu

package/src/components/menu/styles.scss

@@ -0,0 +1,150 @@
+// src/components/menu/styles.scss
+@use 'sass:map';
+@use '../../styles/abstract/config' as c;
+@use '../../styles/abstract/mixins' as m;
+@use '../../styles/abstract/variables' as v;
+
+.#{c.$prefix}-menu {
+  // Base styles
+  @include c.typography('body-medium');
+  @include c.shape('small');
+  
+  position: fixed;
+  z-index: map.get(v.$z-index, 'menu');
+  min-width: 112px;
+  max-width: 280px;
+  padding: 8px 0;
+  background-color: var(--mtrl-sys-color-surface-container);
+  color: var(--mtrl-sys-color-on-surface);
+  @include c.elevation(2);
+  
+  display: none;
+  opacity: 0;
+  transform: scale(0.8);
+  transform-origin: top left;
+  pointer-events: none;
+  transition: opacity 150ms cubic-bezier(0.4, 0, 0.2, 1),
+              transform 150ms cubic-bezier(0.4, 0, 0.2, 1);
+  
+  &--visible {
+    display: block;
+    opacity: 1;
+    transform: scale(1);
+    pointer-events: auto;
+  }
+  
+  &--submenu {
+    position: absolute;
+    z-index: map.get(v.$z-index, 'menu') + 1;
+  }
+
+  // List container
+  &-list {
+    margin: 0;
+    padding: 0;
+    list-style: none;
+    overflow-y: auto;
+    max-height: calc(100vh - 96px);
+    @include m.scrollbar;
+  }
+
+  // Menu items
+  &-item {
+    @include c.typography('body-large');
+    @include m.flex-row;
+    
+    position: relative;
+    min-height: 48px;
+    padding: 12px 16px;
+    cursor: pointer;
+    user-select: none;
+    color: var(--mtrl-sys-color-on-surface);
+    transition: background-color 150ms cubic-bezier(0.4, 0, 0.2, 1);
+    
+    &:hover {
+      @include c.state-layer(var(--mtrl-sys-color-on-surface), 'hover');
+    }
+    
+    &:focus {
+      @include c.state-layer(var(--mtrl-sys-color-on-surface), 'focus');
+      outline: none;
+    }
+    
+    &:active {
+      @include c.state-layer(var(--mtrl-sys-color-on-surface), 'pressed');
+    }
+
+    // Submenu indicator
+    &--submenu {
+      padding-right: 48px;
+      
+      &::after {
+        @include m.icon('chevron_right');
+        position: absolute;
+        right: 16px;
+        top: 50%;
+        transform: translateY(-50%);
+        opacity: 0.87;
+      }
+      
+      &[aria-expanded="true"] {
+        @include c.state-layer(var(--mtrl-sys-color-on-surface), 'hover');
+        
+        &::after {
+          opacity: 1;
+        }
+      }
+    }
+
+    // Disabled state
+    &--disabled {
+      pointer-events: none;
+      color: rgba(var(--mtrl-sys-color-on-surface-rgb), 0.38);
+    }
+  }
+
+  // Divider
+  &-divider {
+    height: 1px;
+    margin: 8px 0;
+    background-color: var(--mtrl-sys-color-outline-variant);
+  }
+
+  // Accessibility
+  @include c.focus-ring('.#{c.$prefix}-menu-item:focus-visible');
+  
+  @include c.reduced-motion {
+    transition: none;
+  }
+  
+  @include c.high-contrast {
+    border: 1px solid CurrentColor;
+    
+    .#{c.$prefix}-menu-divider {
+      background-color: CurrentColor;
+    }
+    
+    .#{c.$prefix}-menu-item--disabled {
+      opacity: 1;
+      color: GrayText;
+    }
+  }
+
+  // RTL Support
+  @include c.rtl {
+    transform-origin: top right;
+    
+    .#{c.$prefix}-menu-item {
+      &--submenu {
+        padding-right: 16px;
+        padding-left: 48px;
+        
+        &::after {
+          right: auto;
+          left: 16px;
+          transform: translateY(-50%) rotate(180deg);
+        }
+      }
+    }
+  }
+}

package/src/index.js

@@ -3,9 +3,10 @@ export { createElement } from './core/dom/create'
 export { default as createLayout } from './core/layout'
 export { default as createButton } from './components/button'
 export { default as createCheckbox } from './components/checkbox'
-export { default as createTextfield } from './components/textfield'
-export { default as createSwitch } from './components/switch'
 export { default as createContainer } from './components/container'
-export { default as createSnackbar } from './components/snackbar'
+export { default as createMenu } from './components/menu'
 export { default as createNavigation } from './components/navigation'
+export { default as createSnackbar } from './components/snackbar'
+export { default as createSwitch } from './components/switch'
+export { default as createTextfield } from './components/textfield'
 export { default as createList } from './components/list'

package/src/styles/abstract/_config.scss

@@ -25,4 +25,4 @@
   rtl,
   touch-target,
   custom-scrollbar,
-  print;
+  print;

package/src/styles/abstract/_mixins.scss

@@ -1,9 +1,31 @@
 // src/styles/abstract/_mixins.scss
 @use 'sass:map';
 @use 'sass:list';
+@use 'sass:math';
 @use 'variables' as v;
 @use 'functions' as f;
 
+// Common icons map
+$icons: (
+  'chevron_right': 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"%3E%3Cpolyline points="9 18 15 12 9 6"%3E%3C/polyline%3E%3C/svg%3E',
+  'chevron_down': 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"%3E%3Cpolyline points="6 9 12 15 18 9"%3E%3C/polyline%3E%3C/svg%3E',
+  'check': 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"%3E%3Cpolyline points="20 6 9 17 4 12"%3E%3C/polyline%3E%3C/svg%3E'
+);
+
+@mixin icon($name, $size: 24px) {
+  $icon-url: map.get($icons, $name);
+  @if $icon-url {
+    content: '';
+    display: inline-block;
+    width: $size;
+    height: $size;
+    background-image: url($icon-url);
+    background-size: contain;
+    background-position: center;
+    background-repeat: no-repeat;
+  }
+}
+
 // Typography
 @mixin typography($scale) {
   $styles: f.get-typography($scale);
@@ -253,6 +275,59 @@
   }
 }
 
+
+// Scrollbar mixin for consistent styling across components
+@mixin scrollbar(
+  $width: 8px,
+  $track-color: rgba(0, 0, 0, 0.05),
+  $thumb-color: rgba(0, 0, 0, 0.2)
+) {
+  &::-webkit-scrollbar {
+    width: $width;
+  }
+  
+  &::-webkit-scrollbar-track {
+    background: $track-color;
+  }
+  
+  &::-webkit-scrollbar-thumb {
+    background: $thumb-color;
+    border-radius: math.div($width, 2);
+  }
+  
+  // Firefox scrollbar (future compatibility)
+  scrollbar-width: thin;
+  scrollbar-color: $thumb-color $track-color;
+}
+
+
+// Flexbox layout mixins
+@mixin flex-row($align: center, $justify: flex-start, $gap: 0) {
+  display: flex;
+  flex-direction: row;
+  align-items: $align;
+  justify-content: $justify;
+  @if $gap > 0 {
+    gap: $gap;
+  }
+}
+
+@mixin flex-column($align: flex-start, $justify: flex-start, $gap: 0) {
+  display: flex;
+  flex-direction: column;
+  align-items: $align;
+  justify-content: $justify;
+  @if $gap > 0 {
+    gap: $gap;
+  }
+}
+
+@mixin flex-center {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
 // Print
 @mixin print {
   @media print {

package/src/styles/abstract/_variables.scss

@@ -151,6 +151,7 @@ $z-index: (
   'dialog': 700,
   'dropdown': 600,
   'tooltip': 500,
+  'menu': 700,
   'sticky': 100,
   'fixed': 50,
   'default': 1,