@proyecto-viviana/solidaria 0.2.4 → 0.2.8

package/src/landmark/index.ts

@@ -1,8 +1,8 @@
-export {
-  createLandmark,
-  getLandmarkController,
-  type AriaLandmarkRole,
-  type AriaLandmarkProps,
-  type LandmarkAria,
-  type LandmarkController,
-} from './createLandmark';
+export {
+  createLandmark,
+  getLandmarkController,
+  type AriaLandmarkRole,
+  type AriaLandmarkProps,
+  type LandmarkAria,
+  type LandmarkController,
+} from './createLandmark';

package/src/link/createLink.ts

@@ -27,10 +27,29 @@ export interface AriaLinkProps {
   elementType?: string;
   /** The URL to link to. */
   href?: string;
+  /** Additional options forwarded to client-side router navigation handlers. */
+  routerOptions?: Record<string, unknown>;
   /** The target window for the link. */
   target?: string;
   /** The relationship between the linked resource and the current page. */
   rel?: string;
+  /** Hints the language of the linked resource. */
+  hrefLang?: string;
+  /** Instructs the browser to download the URL instead of navigating to it. */
+  download?: string | boolean;
+  /** Space-separated list of URLs to ping when following the link. */
+  ping?: string;
+  /** Referrer policy for fetches initiated by this link. */
+  referrerPolicy?:
+    | ''
+    | 'no-referrer'
+    | 'no-referrer-when-downgrade'
+    | 'origin'
+    | 'origin-when-cross-origin'
+    | 'same-origin'
+    | 'strict-origin'
+    | 'strict-origin-when-cross-origin'
+    | 'unsafe-url';
   /** Handler that is called when the press is released over the target. */
   onPress?: (e: PressEvent) => void;
   /** Handler that is called when a press interaction starts. */
@@ -120,13 +139,6 @@ export function createLink(
       };
     }
 
-    // Add link-specific props
-    if (elType === 'a') {
-      if (p.href) baseProps.href = p.href;
-      if (p.target) baseProps.target = p.target;
-      if (p.rel) baseProps.rel = p.rel;
-    }
-
     // ARIA attributes
     const ariaProps: Record<string, unknown> = {
       'aria-disabled': disabled || undefined,
@@ -164,7 +176,10 @@ export function createLink(
     };
 
     return mergeProps(
-      filterDOMProps(p as Record<string, unknown>, { labelable: true }),
+      filterDOMProps(p as Record<string, unknown>, {
+        labelable: true,
+        isLink: elType === 'a',
+      }),
       baseProps,
       ariaProps,
       focusableProps as Record<string, unknown>,

package/src/listbox/createListBox.ts

@@ -1,269 +1,308 @@
-/**
- * Provides the behavior and accessibility implementation for a listbox component.
- * A listbox displays a list of options and allows a user to select one or more of them.
- * Based on @react-aria/listbox useListBox.
- */
-
-import { createEffect, onCleanup, type JSX } from 'solid-js';
-import { createFocusWithin } from '../interactions/createFocusWithin';
-import { createLabel } from '../label/createLabel';
-import { createTypeSelect } from '../selection/createTypeSelect';
-import { filterDOMProps } from '../utils/filterDOMProps';
-import { mergeProps } from '../utils/mergeProps';
-import { createId } from '../ssr';
-import { access, type MaybeAccessor } from '../utils/reactivity';
-import { isDevEnv } from '../utils/env';
-import type { ListState, Key } from '@proyecto-viviana/solid-stately';
-
-export interface AriaListBoxProps {
-  /** An ID for the listbox. */
-  id?: string;
-  /** Whether the listbox is disabled. */
-  isDisabled?: boolean;
-  /** The label for the listbox. */
-  label?: JSX.Element;
-  /** An accessible label for the listbox when no visible label is provided. */
-  'aria-label'?: string;
-  /** The ID of an element that labels the listbox. */
-  'aria-labelledby'?: string;
-  /** The ID of an element that describes the listbox. */
-  'aria-describedby'?: string;
-  /** Handler called when focus moves into the listbox. */
-  onFocus?: (e: FocusEvent) => void;
-  /** Handler called when focus moves out of the listbox. */
-  onBlur?: (e: FocusEvent) => void;
-  /** Handler called when the focus state changes. */
-  onFocusChange?: (isFocused: boolean) => void;
-  /** Handler called when an item is activated (pressed). */
-  onAction?: (key: Key) => void;
-  /** Whether focus should automatically wrap around. */
-  shouldFocusWrap?: boolean;
-  /** Whether selection should occur on press up. */
-  shouldSelectOnPressUp?: boolean;
-  /** Whether to focus items on hover. */
-  shouldFocusOnHover?: boolean;
-  /** Whether type-to-select is disabled. @default false */
-  disallowTypeAhead?: boolean;
-}
-
-export interface ListBoxAria {
-  /** Props for the listbox element. */
-  listBoxProps: JSX.HTMLAttributes<HTMLElement>;
-  /** Props for the listbox's label element (if any). */
-  labelProps: JSX.HTMLAttributes<HTMLElement>;
-}
-
-// Shared data between listbox and options
-const listBoxData = new WeakMap<object, ListBoxData>();
-
-interface ListBoxData {
-  id: string;
-  onAction?: (key: Key) => void;
-  shouldSelectOnPressUp?: boolean;
-  shouldFocusOnHover?: boolean;
-}
-
-export function getListBoxData(state: ListState): ListBoxData | undefined {
-  return listBoxData.get(state);
-}
-
-/**
- * Provides the behavior and accessibility implementation for a listbox component.
- * A listbox displays a list of options and allows a user to select one or more of them.
- */
-export function createListBox<T>(
-  props: MaybeAccessor<AriaListBoxProps>,
-  state: ListState<T>,
-  _ref?: () => HTMLElement | null
-): ListBoxAria {
-  const getProps = () => access(props);
-  const id = createId(getProps().id);
-
-  // Development-time warning for missing accessibility labels
-  if (isDevEnv()) {
-    const p = getProps();
-    if (!p.label && !p['aria-label'] && !p['aria-labelledby']) {
-      console.warn(
-        '[solidaria] A ListBox requires an aria-label or aria-labelledby attribute for accessibility.'
-      );
-    }
-  }
-
-  // Filter DOM props
-  const domProps = () => filterDOMProps(getProps() as unknown as Record<string, unknown>, { labelable: true });
-
-  // Share data with child options
-  createEffect(() => {
-    const p = getProps();
-    listBoxData.set(state, {
-      id,
-      onAction: p.onAction,
-      shouldSelectOnPressUp: p.shouldSelectOnPressUp,
-      shouldFocusOnHover: p.shouldFocusOnHover,
-    });
-
-    onCleanup(() => {
-      listBoxData.delete(state);
-    });
-  });
-
-  // Handle focus within
-  const { focusWithinProps } = createFocusWithin({
-    onFocusWithin: (e) => getProps().onFocus?.(e),
-    onBlurWithin: (e) => getProps().onBlur?.(e),
-    onFocusWithinChange: (isFocused) => {
-      getProps().onFocusChange?.(isFocused);
-      state.setFocused(isFocused);
-    },
-  });
-
-  // Label handling
-  const { labelProps, fieldProps } = createLabel({
-    get id() {
-      return id;
-    },
-    get label() {
-      return getProps().label;
-    },
-    get 'aria-label'() {
-      return getProps()['aria-label'];
-    },
-    get 'aria-labelledby'() {
-      return getProps()['aria-labelledby'];
-    },
-    labelElementType: 'span',
-  });
-
-  // Type-to-select
-  const { typeSelectProps } = createTypeSelect({
-    collection: () => state.collection(),
-    focusedKey: () => state.focusedKey(),
-    onFocusedKeyChange: (key) => state.setFocusedKey(key),
-    isKeyDisabled: (key) => state.isDisabled(key),
-    get isDisabled() {
-      return getProps().disallowTypeAhead ?? false;
-    },
-  });
-
-  // Keyboard navigation
-  const onKeyDown: JSX.EventHandler<HTMLElement, KeyboardEvent> = (e) => {
-    if (getProps().isDisabled) return;
-
-    const collection = state.collection();
-
-    switch (e.key) {
-      case 'ArrowDown': {
-        e.preventDefault();
-        const currentKey = state.focusedKey();
-        const nextKey = currentKey ? collection.getKeyAfter(currentKey) : collection.getFirstKey();
-        if (nextKey) {
-          state.setFocusedKey(nextKey);
-          if (!e.shiftKey && state.selectionMode() === 'single') {
-            state.replaceSelection(nextKey);
-          } else if (e.shiftKey && state.selectionMode() === 'multiple') {
-            state.extendSelection(nextKey, collection);
-          }
-        }
-        break;
-      }
-      case 'ArrowUp': {
-        e.preventDefault();
-        const currentKey = state.focusedKey();
-        const prevKey = currentKey ? collection.getKeyBefore(currentKey) : collection.getLastKey();
-        if (prevKey) {
-          state.setFocusedKey(prevKey);
-          if (!e.shiftKey && state.selectionMode() === 'single') {
-            state.replaceSelection(prevKey);
-          } else if (e.shiftKey && state.selectionMode() === 'multiple') {
-            state.extendSelection(prevKey, collection);
-          }
-        }
-        break;
-      }
-      case 'Home': {
-        e.preventDefault();
-        const firstKey = collection.getFirstKey();
-        if (firstKey) {
-          state.setFocusedKey(firstKey);
-          if (e.ctrlKey && e.shiftKey && state.selectionMode() === 'multiple') {
-            // Select from current to first
-            state.extendSelection(firstKey, collection);
-          } else if (!e.shiftKey && state.selectionMode() === 'single') {
-            state.replaceSelection(firstKey);
-          }
-        }
-        break;
-      }
-      case 'End': {
-        e.preventDefault();
-        const lastKey = collection.getLastKey();
-        if (lastKey) {
-          state.setFocusedKey(lastKey);
-          if (e.ctrlKey && e.shiftKey && state.selectionMode() === 'multiple') {
-            // Select from current to last
-            state.extendSelection(lastKey, collection);
-          } else if (!e.shiftKey && state.selectionMode() === 'single') {
-            state.replaceSelection(lastKey);
-          }
-        }
-        break;
-      }
-      case ' ':
-      case 'Enter': {
-        e.preventDefault();
-        const focusedKey = state.focusedKey();
-        if (focusedKey != null) {
-          if (state.selectionMode() !== 'none') {
-            state.toggleSelection(focusedKey);
-          }
-          getProps().onAction?.(focusedKey);
-        }
-        break;
-      }
-      case 'a': {
-        if (e.ctrlKey && state.selectionMode() === 'multiple') {
-          e.preventDefault();
-          state.selectAll();
-        }
-        break;
-      }
-      case 'Escape': {
-        e.preventDefault();
-        if (!state.disallowEmptySelection()) {
-          state.clearSelection();
-        }
-        break;
-      }
-    }
-  };
-
-  return {
-    get labelProps() {
-      return labelProps as JSX.HTMLAttributes<HTMLElement>;
-    },
-    get listBoxProps() {
-      const p = getProps();
-      const selectionMode = state.selectionMode();
-
-      const baseProps = mergeProps(
-        domProps(),
-        focusWithinProps as Record<string, unknown>,
-        fieldProps as Record<string, unknown>,
-        {
-          role: 'listbox',
-          tabIndex: p.isDisabled ? undefined : 0,
-          'aria-disabled': p.isDisabled || undefined,
-          'aria-multiselectable': selectionMode === 'multiple' ? true : undefined,
-          onKeyDown,
-        }
-      );
-
-      // Add type-select props if enabled
-      if (!p.disallowTypeAhead) {
-        return mergeProps(baseProps, typeSelectProps as Record<string, unknown>) as JSX.HTMLAttributes<HTMLElement>;
-      }
-
-      return baseProps as JSX.HTMLAttributes<HTMLElement>;
-    },
-  };
-}
+/**
+ * Provides the behavior and accessibility implementation for a listbox component.
+ * A listbox displays a list of options and allows a user to select one or more of them.
+ * Based on @react-aria/listbox useListBox.
+ */
+
+import { createEffect, onCleanup, type JSX } from 'solid-js';
+import { createFocusWithin } from '../interactions/createFocusWithin';
+import { createLabel } from '../label/createLabel';
+import { createTypeSelect } from '../selection/createTypeSelect';
+import { filterDOMProps } from '../utils/filterDOMProps';
+import { mergeProps } from '../utils/mergeProps';
+import { createId } from '../ssr';
+import { access, type MaybeAccessor } from '../utils/reactivity';
+import { isDevEnv } from '../utils/env';
+import type { ListState, Key } from '@proyecto-viviana/solid-stately';
+
+export interface AriaListBoxProps {
+  /** An ID for the listbox. */
+  id?: string;
+  /** Whether the listbox is disabled. */
+  isDisabled?: boolean;
+  /** The label for the listbox. */
+  label?: JSX.Element;
+  /** An accessible label for the listbox when no visible label is provided. */
+  'aria-label'?: string;
+  /** The ID of an element that labels the listbox. */
+  'aria-labelledby'?: string;
+  /** The ID of an element that describes the listbox. */
+  'aria-describedby'?: string;
+  /** Handler called when focus moves into the listbox. */
+  onFocus?: (e: FocusEvent) => void;
+  /** Handler called when focus moves out of the listbox. */
+  onBlur?: (e: FocusEvent) => void;
+  /** Handler called when the focus state changes. */
+  onFocusChange?: (isFocused: boolean) => void;
+  /** Handler called when an item is activated (pressed). */
+  onAction?: (key: Key) => void;
+  /** Whether focus should automatically wrap around. */
+  shouldFocusWrap?: boolean;
+  /** Whether selection should occur on press up. */
+  shouldSelectOnPressUp?: boolean;
+  /** Whether to focus items on hover. */
+  shouldFocusOnHover?: boolean;
+  /** Whether type-to-select is disabled. @default false */
+  disallowTypeAhead?: boolean;
+}
+
+export interface ListBoxAria {
+  /** Props for the listbox element. */
+  listBoxProps: JSX.HTMLAttributes<HTMLElement>;
+  /** Props for the listbox's label element (if any). */
+  labelProps: JSX.HTMLAttributes<HTMLElement>;
+}
+
+// Shared data between listbox and options
+const listBoxData = new WeakMap<object, ListBoxData>();
+
+interface ListBoxData {
+  id: string;
+  onAction?: (key: Key) => void;
+  shouldSelectOnPressUp?: boolean;
+  shouldFocusOnHover?: boolean;
+  isDisabled?: boolean;
+}
+
+export function getListBoxData(state: ListState): ListBoxData | undefined {
+  return listBoxData.get(state);
+}
+
+function findNextEnabledKey<T>(
+  state: ListState<T>,
+  currentKey: Key | null,
+  direction: 'next' | 'prev',
+  wrap: boolean
+): Key | null {
+  const collection = state.collection();
+  const getAdjacentKey = direction === 'next'
+    ? (key: Key) => collection.getKeyAfter(key)
+    : (key: Key) => collection.getKeyBefore(key);
+  const getBoundaryKey = direction === 'next'
+    ? () => collection.getFirstKey()
+    : () => collection.getLastKey();
+
+  let key = currentKey != null ? getAdjacentKey(currentKey) : getBoundaryKey();
+  while (key != null && state.isDisabled(key)) {
+    key = getAdjacentKey(key);
+  }
+
+  if (key == null && wrap) {
+    key = getBoundaryKey();
+    while (key != null && state.isDisabled(key)) {
+      key = getAdjacentKey(key);
+    }
+  }
+
+  return key;
+}
+
+/**
+ * Provides the behavior and accessibility implementation for a listbox component.
+ * A listbox displays a list of options and allows a user to select one or more of them.
+ */
+export function createListBox<T>(
+  props: MaybeAccessor<AriaListBoxProps>,
+  state: ListState<T>,
+  _ref?: () => HTMLElement | null
+): ListBoxAria {
+  const getProps = () => access(props);
+  const id = createId(getProps().id);
+
+  // Development-time warning for missing accessibility labels
+  if (isDevEnv()) {
+    const p = getProps();
+    if (!p.label && !p['aria-label'] && !p['aria-labelledby']) {
+      console.warn(
+        '[solidaria] A ListBox requires an aria-label or aria-labelledby attribute for accessibility.'
+      );
+    }
+  }
+
+  // Filter DOM props
+  const domProps = () => filterDOMProps(getProps() as unknown as Record<string, unknown>, { labelable: true });
+
+  const updateSharedData = () => {
+    const p = getProps();
+    listBoxData.set(state, {
+      id,
+      onAction: p.onAction,
+      shouldSelectOnPressUp: p.shouldSelectOnPressUp,
+      shouldFocusOnHover: p.shouldFocusOnHover,
+      isDisabled: p.isDisabled,
+    });
+  };
+
+  // Ensure options created in the same render pass can read parent metadata.
+  updateSharedData();
+
+  // Share data with child options
+  createEffect(() => {
+    updateSharedData();
+
+    onCleanup(() => {
+      listBoxData.delete(state);
+    });
+  });
+
+  // Handle focus within
+  const { focusWithinProps } = createFocusWithin({
+    onFocusWithin: (e) => getProps().onFocus?.(e),
+    onBlurWithin: (e) => getProps().onBlur?.(e),
+    onFocusWithinChange: (isFocused) => {
+      getProps().onFocusChange?.(isFocused);
+      state.setFocused(isFocused);
+    },
+  });
+
+  // Label handling
+  const { labelProps, fieldProps } = createLabel({
+    get id() {
+      return id;
+    },
+    get label() {
+      return getProps().label;
+    },
+    get 'aria-label'() {
+      return getProps()['aria-label'];
+    },
+    get 'aria-labelledby'() {
+      return getProps()['aria-labelledby'];
+    },
+    labelElementType: 'span',
+  });
+
+  // Type-to-select
+  const { typeSelectProps } = createTypeSelect({
+    collection: () => state.collection(),
+    focusedKey: () => state.focusedKey(),
+    onFocusedKeyChange: (key) => state.setFocusedKey(key),
+    isKeyDisabled: (key) => state.isDisabled(key),
+    get isDisabled() {
+      return getProps().disallowTypeAhead ?? false;
+    },
+  });
+
+  // Keyboard navigation
+  const onKeyDown: JSX.EventHandler<HTMLElement, KeyboardEvent> = (e) => {
+    const p = getProps();
+    if (p.isDisabled) return;
+
+    const collection = state.collection();
+    const shouldWrap = p.shouldFocusWrap ?? false;
+
+    switch (e.key) {
+      case 'ArrowDown': {
+        e.preventDefault();
+        const nextKey = findNextEnabledKey(state, state.focusedKey(), 'next', shouldWrap);
+        if (nextKey != null) {
+          state.setFocusedKey(nextKey);
+          if (!e.shiftKey && state.selectionMode() === 'single') {
+            state.replaceSelection(nextKey);
+          } else if (e.shiftKey && state.selectionMode() === 'multiple') {
+            state.extendSelection(nextKey, collection);
+          }
+        }
+        break;
+      }
+      case 'ArrowUp': {
+        e.preventDefault();
+        const prevKey = findNextEnabledKey(state, state.focusedKey(), 'prev', shouldWrap);
+        if (prevKey != null) {
+          state.setFocusedKey(prevKey);
+          if (!e.shiftKey && state.selectionMode() === 'single') {
+            state.replaceSelection(prevKey);
+          } else if (e.shiftKey && state.selectionMode() === 'multiple') {
+            state.extendSelection(prevKey, collection);
+          }
+        }
+        break;
+      }
+      case 'Home': {
+        e.preventDefault();
+        const firstKey = findNextEnabledKey(state, null, 'next', false);
+        if (firstKey != null) {
+          state.setFocusedKey(firstKey);
+          if (e.ctrlKey && e.shiftKey && state.selectionMode() === 'multiple') {
+            // Select from current to first
+            state.extendSelection(firstKey, collection);
+          } else if (!e.shiftKey && state.selectionMode() === 'single') {
+            state.replaceSelection(firstKey);
+          }
+        }
+        break;
+      }
+      case 'End': {
+        e.preventDefault();
+        const lastKey = findNextEnabledKey(state, null, 'prev', false);
+        if (lastKey != null) {
+          state.setFocusedKey(lastKey);
+          if (e.ctrlKey && e.shiftKey && state.selectionMode() === 'multiple') {
+            // Select from current to last
+            state.extendSelection(lastKey, collection);
+          } else if (!e.shiftKey && state.selectionMode() === 'single') {
+            state.replaceSelection(lastKey);
+          }
+        }
+        break;
+      }
+      case ' ':
+      case 'Enter': {
+        e.preventDefault();
+        const focusedKey = state.focusedKey();
+        if (focusedKey != null && !state.isDisabled(focusedKey)) {
+          if (state.selectionMode() !== 'none') {
+            state.toggleSelection(focusedKey);
+          }
+          p.onAction?.(focusedKey);
+        }
+        break;
+      }
+      case 'a': {
+        if ((e.ctrlKey || e.metaKey) && state.selectionMode() === 'multiple') {
+          e.preventDefault();
+          state.selectAll();
+        }
+        break;
+      }
+      case 'Escape': {
+        e.preventDefault();
+        if (!state.disallowEmptySelection()) {
+          state.clearSelection();
+        }
+        break;
+      }
+    }
+  };
+
+  return {
+    get labelProps() {
+      return labelProps as JSX.HTMLAttributes<HTMLElement>;
+    },
+    get listBoxProps() {
+      const p = getProps();
+      const selectionMode = state.selectionMode();
+
+      const baseProps = mergeProps(
+        domProps(),
+        focusWithinProps as Record<string, unknown>,
+        fieldProps as Record<string, unknown>,
+        {
+          role: 'listbox',
+          tabIndex: p.isDisabled ? undefined : 0,
+          'aria-disabled': p.isDisabled || undefined,
+          'aria-multiselectable': selectionMode === 'multiple' ? true : undefined,
+          'aria-activedescendant': state.focusedKey() != null ? String(state.focusedKey()) : undefined,
+          onKeyDown,
+        }
+      );
+
+      // Add type-select props if enabled
+      if (!p.disallowTypeAhead) {
+        return mergeProps(baseProps, typeSelectProps as Record<string, unknown>) as JSX.HTMLAttributes<HTMLElement>;
+      }
+
+      return baseProps as JSX.HTMLAttributes<HTMLElement>;
+    },
+  };
+}