@proyecto-viviana/solidaria 0.2.5 → 0.3.0

package/src/utils/reactivity.ts

@@ -4,7 +4,7 @@
  * Provides type-safe utilities for working with SolidJS reactivity patterns.
  */
 
-import { Accessor } from 'solid-js';
+import { Accessor } from "solid-js";
 
 /**
  * A value that may be either a raw value or an accessor function.
@@ -20,7 +20,7 @@ export type MaybeAccessor<T> = T | Accessor<T>;
  * @param value - The value or accessor to unwrap.
  */
 export function access<T>(value: MaybeAccessor<T>): T {
-  return typeof value === 'function' ? (value as Accessor<T>)() : value;
+  return typeof value === "function" ? (value as Accessor<T>)() : value;
 }
 
 /**
@@ -32,5 +32,5 @@ export type MaybeAccessorValue<T> = T | undefined | Accessor<T | undefined>;
  * Checks if a value is an accessor function.
  */
 export function isAccessor<T>(value: MaybeAccessor<T>): value is Accessor<T> {
-  return typeof value === 'function';
+  return typeof value === "function";
 }

package/src/utils/textSelection.ts

@@ -7,14 +7,14 @@
  * we can just set it on the target element.
  */
 
-import { isIOS } from './platform';
-import { getOwnerDocument } from './dom';
+import { isIOS } from "./platform";
+import { getOwnerDocument } from "./dom";
 
-type State = 'default' | 'disabled' | 'restoring';
+type State = "default" | "disabled" | "restoring";
 
 // Global state to manage text selection across multiple press interactions
-let state: State = 'default';
-let savedUserSelect = '';
+let state: State = "default";
+let savedUserSelect = "";
 let modifiedElementMap = new WeakMap<HTMLElement, string>();
 
 /**
@@ -24,18 +24,18 @@ let modifiedElementMap = new WeakMap<HTMLElement, string>();
 export function disableTextSelection(target?: HTMLElement): void {
   if (isIOS()) {
     // iOS requires disabling selection on the entire page
-    if (state === 'default') {
+    if (state === "default") {
       const documentElement = getOwnerDocument(target).documentElement;
       savedUserSelect = documentElement.style.webkitUserSelect;
-      documentElement.style.webkitUserSelect = 'none';
+      documentElement.style.webkitUserSelect = "none";
     }
-    state = 'disabled';
+    state = "disabled";
   } else if (target) {
     // On other platforms, just disable on the target
     const element = target as HTMLElement;
     if (!modifiedElementMap.has(element)) {
       modifiedElementMap.set(element, element.style.userSelect);
-      element.style.userSelect = 'none';
+      element.style.userSelect = "none";
     }
   }
 }
@@ -47,11 +47,11 @@ export function disableTextSelection(target?: HTMLElement): void {
 export function restoreTextSelection(target?: HTMLElement): void {
   if (isIOS()) {
     // Don't restore if another press is active
-    if (state !== 'disabled') {
+    if (state !== "disabled") {
       return;
     }
 
-    state = 'restoring';
+    state = "restoring";
 
     // Wait for iOS to finish any pending selection actions
     // 300ms is the iOS long-press delay
@@ -59,15 +59,15 @@ export function restoreTextSelection(target?: HTMLElement): void {
       // Use runAfterTransition to avoid CSS recomputation during animation
       runAfterTransition(() => {
         // Only restore if still in 'restoring' state (no new press started)
-        if (state === 'restoring') {
+        if (state === "restoring") {
           const documentElement = getOwnerDocument(target).documentElement;
           if (savedUserSelect) {
             documentElement.style.webkitUserSelect = savedUserSelect;
           } else {
-            documentElement.style.removeProperty('-webkit-user-select');
+            documentElement.style.removeProperty("-webkit-user-select");
           }
-          savedUserSelect = '';
-          state = 'default';
+          savedUserSelect = "";
+          state = "default";
         }
       });
     }, 300);
@@ -79,7 +79,7 @@ export function restoreTextSelection(target?: HTMLElement): void {
       if (savedValue) {
         element.style.userSelect = savedValue;
       } else {
-        element.style.removeProperty('user-select');
+        element.style.removeProperty("user-select");
       }
       modifiedElementMap.delete(element);
     }

package/src/visually-hidden/createVisuallyHidden.ts

@@ -1,124 +1,127 @@
-/**
- * createVisuallyHidden hook for solidaria
- *
- * Provides styles and props to visually hide content while keeping it
- * accessible to screen readers.
- *
- * Port of react-aria's useVisuallyHidden.
- */
-
-import { type Accessor, type JSX, createMemo, createSignal } from 'solid-js';
-import { createFocusWithin } from '../interactions/createFocusWithin';
-import { access, type MaybeAccessor } from '../utils';
-
-// ============================================
-// TYPES
-// ============================================
-
-export interface AriaVisuallyHiddenProps {
-  /** Inline styles to merge with the visually hidden styles. */
-  style?: JSX.CSSProperties;
-  /** Whether the element should become visible when focused (e.g., skip links). */
-  isFocusable?: boolean;
-}
-
-export interface VisuallyHiddenAria {
-  /** Props to spread on the visually hidden element. */
-  visuallyHiddenProps: Accessor<JSX.HTMLAttributes<HTMLElement>>;
-}
-
-// ============================================
-// STYLES
-// ============================================
-
-/**
- * CSS styles that visually hide an element while keeping it accessible.
- * These styles ensure the element is read by screen readers but not visible on screen.
- */
-export const visuallyHiddenStyles: JSX.CSSProperties = {
-  border: '0',
-  clip: 'rect(0 0 0 0)',
-  'clip-path': 'inset(50%)',
-  height: '1px',
-  margin: '-1px',
-  overflow: 'hidden',
-  padding: '0',
-  position: 'absolute',
-  width: '1px',
-  'white-space': 'nowrap',
-};
-
-// ============================================
-// HOOK
-// ============================================
-
-/**
- * Provides props for an element that hides its children visually
- * but keeps content visible to assistive technology.
- *
- * @example
- * ```tsx
- * function SkipLink() {
- *   let ref: HTMLAnchorElement | undefined;
- *   const { visuallyHiddenProps } = createVisuallyHidden({ isFocusable: true });
- *
- *   return (
- *     <a
- *       ref={ref}
- *       href="#main-content"
- *       {...visuallyHiddenProps()}
- *     >
- *       Skip to main content
- *     </a>
- *   );
- * }
- *
- * // For content that should always be hidden
- * function ScreenReaderOnly(props: ParentProps) {
- *   const { visuallyHiddenProps } = createVisuallyHidden();
- *
- *   return (
- *     <span {...visuallyHiddenProps()}>
- *       {props.children}
- *     </span>
- *   );
- * }
- * ```
- */
-export function createVisuallyHidden(
-  props: MaybeAccessor<AriaVisuallyHiddenProps> = {}
-): VisuallyHiddenAria {
-  const [isFocused, setIsFocused] = createSignal(false);
-
-  const isFocusable = () => access(props).isFocusable ?? false;
-  const style = () => access(props).style;
-
-  // Track focus within for focusable visually hidden elements
-  const { focusWithinProps } = createFocusWithin({
-    get isDisabled() {
-      return !isFocusable();
-    },
-    onFocusWithinChange: (val: boolean) => setIsFocused(val),
-  });
-
-  // Compute combined styles
-  const combinedStyles = createMemo<JSX.CSSProperties>(() => {
-    if (isFocused()) {
-      // If focused, show the element (for skip links, etc.)
-      return style() ?? {};
-    } else if (style()) {
-      return { ...visuallyHiddenStyles, ...style() };
-    } else {
-      return visuallyHiddenStyles;
-    }
-  });
-
-  const visuallyHiddenProps = createMemo<JSX.HTMLAttributes<HTMLElement>>(() => ({
-    ...focusWithinProps,
-    style: combinedStyles(),
-  }));
-
-  return {
-    visuallyHiddenProps,
-  };
-}
+/**
+ * createVisuallyHidden hook for solidaria
+ *
+ * Provides styles and props to visually hide content while keeping it
+ * accessible to screen readers.
+ *
+ * Port of react-aria's useVisuallyHidden.
+ */
+
+import { type Accessor, type JSX, createMemo, createSignal } from "solid-js";
+import { createFocusWithin } from "../interactions/createFocusWithin";
+import { access, type MaybeAccessor } from "../utils";
+import { mergeProps } from "../utils/mergeProps";
+
+export interface AriaVisuallyHiddenProps {
+  /** Inline styles to merge with the visually hidden styles. */
+  style?: JSX.CSSProperties;
+  /** Whether the element should become visible when focused (e.g., skip links). */
+  isFocusable?: boolean;
+}
+
+export interface VisuallyHiddenAria {
+  /** Props to spread on the visually hidden element. */
+  visuallyHiddenProps: Accessor<JSX.HTMLAttributes<HTMLElement>>;
+}
+
+/**
+ * CSS styles that visually hide an element while keeping it accessible.
+ * These styles ensure the element is read by screen readers but not visible on screen.
+ */
+export const visuallyHiddenStyles: JSX.CSSProperties = {
+  border: "0",
+  clip: "rect(0 0 0 0)",
+  "clip-path": "inset(50%)",
+  height: "1px",
+  margin: "-1px",
+  overflow: "hidden",
+  padding: "0",
+  position: "absolute",
+  width: "1px",
+  "white-space": "nowrap",
+};
+
+/**
+ * Provides props for an element that hides its children visually
+ * but keeps content visible to assistive technology.
+ *
+ * @example
+ * ```tsx
+ * function SkipLink() {
+ *   let ref: HTMLAnchorElement | undefined;
+ *   const { visuallyHiddenProps } = createVisuallyHidden({ isFocusable: true });
+ *
+ *   return (
+ *     <a
+ *       ref={ref}
+ *       href="#main-content"
+ *       {...visuallyHiddenProps()}
+ *     >
+ *       Skip to main content
+ *     </a>
+ *   );
+ * }
+ *
+ * // For content that should always be hidden
+ * function ScreenReaderOnly(props: ParentProps) {
+ *   const { visuallyHiddenProps } = createVisuallyHidden();
+ *
+ *   return (
+ *     <span {...visuallyHiddenProps()}>
+ *       {props.children}
+ *     </span>
+ *   );
+ * }
+ * ```
+ */
+export function createVisuallyHidden(
+  props: MaybeAccessor<AriaVisuallyHiddenProps> = {},
+): VisuallyHiddenAria {
+  const [isFocused, setIsFocused] = createSignal(false);
+
+  const isFocusable = () => access(props).isFocusable ?? false;
+  const style = () => access(props).style;
+
+  // Track focus within for focusable visually hidden elements
+  const { focusWithinProps } = createFocusWithin({
+    get isDisabled() {
+      return !isFocusable();
+    },
+    onFocusWithinChange: (val: boolean) => setIsFocused(val),
+  });
+
+  // Compute combined styles
+  const combinedStyles = createMemo<JSX.CSSProperties | undefined>(() => {
+    if (isFocused()) {
+      // If focused, show the element (for skip links, etc.)
+      return style();
+    } else if (style()) {
+      return { ...visuallyHiddenStyles, ...style() };
+    } else {
+      return visuallyHiddenStyles;
+    }
+  });
+
+  const visuallyHiddenProps = createMemo<JSX.HTMLAttributes<HTMLElement>>(() => ({
+    ...mergeProps(
+      focusWithinProps as unknown as Record<string, unknown>,
+      isFocusable()
+        ? {
+            onFocusIn: () => setIsFocused(true),
+            onFocusOut: (e: FocusEvent) => {
+              const currentTarget = e.currentTarget as Element | null;
+              const relatedTarget = e.relatedTarget as Element | null;
+              if (currentTarget && !currentTarget.contains(relatedTarget)) {
+                setIsFocused(false);
+              }
+            },
+          }
+        : {},
+      { style: combinedStyles() },
+    ),
+  }));
+
+  return {
+    visuallyHiddenProps,
+  };
+}

package/src/visually-hidden/index.ts

@@ -1,6 +1,6 @@
-export {
-  createVisuallyHidden,
-  visuallyHiddenStyles,
-  type AriaVisuallyHiddenProps,
-  type VisuallyHiddenAria,
-} from './createVisuallyHidden';
+export {
+  createVisuallyHidden,
+  visuallyHiddenStyles,
+  type AriaVisuallyHiddenProps,
+  type VisuallyHiddenAria,
+} from "./createVisuallyHidden";

package/dist/i18n/NumberFormatter.d.ts

@@ -1,43 +0,0 @@
-/**
- * NumberFormatter for solidaria
- *
- * A wrapper around Intl.NumberFormat with caching and polyfills.
- *
- * Port of @internationalized/number NumberFormatter.
- */
-export interface NumberFormatOptions extends Intl.NumberFormatOptions {
-    /** Overrides default numbering system for the current locale. */
-    numberingSystem?: string;
-}
-interface NumberRangeFormatPart extends Intl.NumberFormatPart {
-    source: 'startRange' | 'endRange' | 'shared';
-}
-/**
- * A wrapper around Intl.NumberFormat providing additional options, polyfills, and caching.
- *
- * @example
- * ```ts
- * const formatter = new NumberFormatter('en-US', {
- *   style: 'currency',
- *   currency: 'USD',
- * });
- * formatter.format(1234.56); // '$1,234.56'
- * ```
- */
-export declare class NumberFormatter implements Intl.NumberFormat {
-    private numberFormatter;
-    private options;
-    constructor(locale: string, options?: NumberFormatOptions);
-    /** Formats a number value as a string, according to the locale and options. */
-    format(value: number): string;
-    /** Formats a number to an array of parts. */
-    formatToParts(value: number): Intl.NumberFormatPart[];
-    /** Formats a number range as a string. */
-    formatRange(start: number, end: number): string;
-    /** Formats a number range as an array of parts. */
-    formatRangeToParts(start: number, end: number): NumberRangeFormatPart[];
-    /** Returns the resolved formatting options. */
-    resolvedOptions(): Intl.ResolvedNumberFormatOptions;
-}
-export {};
-//# sourceMappingURL=NumberFormatter.d.ts.map

package/dist/i18n/NumberFormatter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"NumberFormatter.d.ts","sourceRoot":"","sources":["../../src/i18n/NumberFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6CH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,mBAAmB;IACnE,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,qBAAsB,SAAQ,IAAI,CAAC,gBAAgB;IAC3D,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;CAC9C;AAuGD;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,YAAW,IAAI,CAAC,YAAY;IACvD,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,OAAO,CAAsB;gBAEzB,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB;IAK7D,+EAA+E;IAC/E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAyB7B,6CAA6C;IAC7C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE;IAIrD,0CAA0C;IAC1C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAa/C,mDAAmD;IACnD,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAkBvE,+CAA+C;IAC/C,eAAe,IAAI,IAAI,CAAC,2BAA2B;CAkBpD"}