@proyecto-viviana/solidaria 0.2.5 → 0.3.0

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

@@ -8,17 +8,13 @@
  * This is a 1:1 port of @react-aria/link's useLink hook.
  */
 
-import { type Accessor } from 'solid-js';
-import { createPress } from '../interactions/createPress';
-import { createFocusable } from '../interactions/createFocusable';
-import { mergeProps } from '../utils/mergeProps';
-import { filterDOMProps } from '../utils/filterDOMProps';
-import { type MaybeAccessor, access } from '../utils/reactivity';
-import { type PressEvent } from '../interactions/PressEvent';
-
-// ============================================
-// TYPES
-// ============================================
+import { type Accessor } from "solid-js";
+import { createPress } from "../interactions/createPress";
+import { createFocusable } from "../interactions/createFocusable";
+import { mergeProps } from "../utils/mergeProps";
+import { filterDOMProps } from "../utils/filterDOMProps";
+import { type MaybeAccessor, access } from "../utils/reactivity";
+import { type PressEvent } from "../interactions/PressEvent";
 
 export interface AriaLinkProps {
   /** Whether the link is disabled. */
@@ -27,16 +23,39 @@ 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. */
   onPressStart?: (e: PressEvent) => void;
   /** Handler that is called when a press interaction ends. */
   onPressEnd?: (e: PressEvent) => void;
+  /** Handler that is called when a press is released over the target. */
+  onPressUp?: (e: PressEvent) => void;
+  /** Handler that is called when the press state changes. */
+  onPressChange?: (isPressed: boolean) => void;
   /** Handler that is called when the element is clicked. */
   onClick?: (e: MouseEvent) => void;
   /** Handler that is called when the element receives focus. */
@@ -52,13 +71,15 @@ export interface AriaLinkProps {
   /** Whether to autofocus the element. */
   autoFocus?: boolean;
   /** Indicates the current "page" or state within a set of related elements. */
-  'aria-current'?: 'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false' | boolean;
+  "aria-current"?: "page" | "step" | "location" | "date" | "time" | "true" | "false" | boolean;
   /** Defines a string value that labels the current element. */
-  'aria-label'?: string;
+  "aria-label"?: string;
   /** Identifies the element (or elements) that labels the current element. */
-  'aria-labelledby'?: string;
+  "aria-labelledby"?: string;
   /** Identifies the element (or elements) that describes the object. */
-  'aria-describedby'?: string;
+  "aria-describedby"?: string;
+  /** Identifies the element (or elements) that provide a detailed description. */
+  "aria-details"?: string;
 }
 
 export interface LinkAria {
@@ -68,40 +89,62 @@ export interface LinkAria {
   isPressed: Accessor<boolean>;
 }
 
-// ============================================
-// IMPLEMENTATION
-// ============================================
-
 /**
  * Provides the behavior and accessibility implementation for a link component.
  * A link allows a user to navigate to another page or resource within a web page
  * or application.
  */
-export function createLink(
-  props: MaybeAccessor<AriaLinkProps> = {}
-): LinkAria {
+export function createLink(props: MaybeAccessor<AriaLinkProps> = {}): LinkAria {
   const getProps = () => access(props);
 
   const isDisabled = () => getProps().isDisabled ?? false;
-  const elementType = () => getProps().elementType ?? 'a';
+  const elementType = () => getProps().elementType ?? "a";
 
   // Create press handling
   const { pressProps, isPressed } = createPress({
-    get isDisabled() { return isDisabled(); },
-    get onPress() { return getProps().onPress; },
-    get onPressStart() { return getProps().onPressStart; },
-    get onPressEnd() { return getProps().onPressEnd; },
+    get isDisabled() {
+      return isDisabled();
+    },
+    get onPress() {
+      return getProps().onPress;
+    },
+    get onPressStart() {
+      return getProps().onPressStart;
+    },
+    get onPressEnd() {
+      return getProps().onPressEnd;
+    },
+    get onPressUp() {
+      return getProps().onPressUp;
+    },
+    get onPressChange() {
+      return getProps().onPressChange;
+    },
   });
 
   // Create focusable handling
   const { focusableProps } = createFocusable({
-    get isDisabled() { return isDisabled(); },
-    get autoFocus() { return getProps().autoFocus; },
-    get onFocus() { return getProps().onFocus; },
-    get onBlur() { return getProps().onBlur; },
-    get onFocusChange() { return getProps().onFocusChange; },
-    get onKeyDown() { return getProps().onKeyDown; },
-    get onKeyUp() { return getProps().onKeyUp; },
+    get isDisabled() {
+      return isDisabled();
+    },
+    get autoFocus() {
+      return getProps().autoFocus;
+    },
+    get onFocus() {
+      return getProps().onFocus;
+    },
+    get onBlur() {
+      return getProps().onBlur;
+    },
+    get onFocusChange() {
+      return getProps().onFocusChange;
+    },
+    get onKeyDown() {
+      return getProps().onKeyDown;
+    },
+    get onKeyUp() {
+      return getProps().onKeyUp;
+    },
   });
 
   // Build link props
@@ -113,36 +156,32 @@ export function createLink(
     let baseProps: Record<string, unknown> = {};
 
     // If not an <a>, add role and tabIndex
-    if (elType !== 'a') {
+    if (elType !== "a") {
       baseProps = {
-        role: 'link',
+        role: "link",
         tabIndex: disabled ? undefined : 0,
       };
     }
 
-    // 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,
+      "aria-disabled": disabled || undefined,
     };
 
-    if (p['aria-current'] !== undefined) {
-      ariaProps['aria-current'] = p['aria-current'];
+    if (p["aria-current"] !== undefined) {
+      ariaProps["aria-current"] = p["aria-current"];
+    }
+    if (p["aria-label"]) {
+      ariaProps["aria-label"] = p["aria-label"];
     }
-    if (p['aria-label']) {
-      ariaProps['aria-label'] = p['aria-label'];
+    if (p["aria-labelledby"]) {
+      ariaProps["aria-labelledby"] = p["aria-labelledby"];
     }
-    if (p['aria-labelledby']) {
-      ariaProps['aria-labelledby'] = p['aria-labelledby'];
+    if (p["aria-describedby"]) {
+      ariaProps["aria-describedby"] = p["aria-describedby"];
     }
-    if (p['aria-describedby']) {
-      ariaProps['aria-describedby'] = p['aria-describedby'];
+    if (p["aria-details"]) {
+      ariaProps["aria-details"] = p["aria-details"];
     }
 
     // Handle onClick - prevent default navigation when appropriate
@@ -164,12 +203,15 @@ 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>,
       pressProps as Record<string, unknown>,
-      { onClick }
+      { onClick },
     );
   };
 

package/src/link/index.ts

@@ -1 +1 @@
-export { createLink, type AriaLinkProps, type LinkAria } from './createLink';
+export { createLink, type AriaLinkProps, type LinkAria } from "./createLink";