@proyecto-viviana/solidaria-components 0.2.9 → 0.3.0

package/src/DateRangePickerContext.tsx

@@ -0,0 +1,44 @@
+import { createContext, useContext } from "solid-js";
+import { type createDateRangePicker } from "@proyecto-viviana/solidaria";
+import {
+  type DateFieldState,
+  type DateValue,
+  type RangeCalendarState,
+} from "@proyecto-viviana/solid-stately";
+
+export interface DateRangePickerFieldContextValue {
+  state: DateFieldState<DateValue>;
+  aria: {
+    labelProps: Record<string, unknown>;
+    inputProps: Record<string, unknown>;
+    descriptionProps: Record<string, unknown>;
+    errorMessageProps: Record<string, unknown>;
+  };
+}
+
+export interface DateRangePickerContextValue {
+  calendarState: RangeCalendarState<DateValue>;
+  startFieldState: DateFieldState<DateValue>;
+  endFieldState: DateFieldState<DateValue>;
+  startFieldContext: DateRangePickerFieldContextValue;
+  endFieldContext: DateRangePickerFieldContextValue;
+  overlayState: {
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+  };
+  triggerRef: () => HTMLElement | null;
+  setTriggerRef: (element: HTMLElement | null) => void;
+  pickerAria: ReturnType<typeof createDateRangePicker>;
+}
+
+export const DateRangePickerContext = createContext<DateRangePickerContextValue | null>(null);
+
+export function useDateRangePickerContext(): DateRangePickerContextValue {
+  const context = useContext(DateRangePickerContext);
+  if (!context) {
+    throw new Error("DateRangePicker components must be used within a DateRangePicker");
+  }
+  return context;
+}

package/src/Dialog.tsx

@@ -15,14 +15,18 @@ import {
   useContext,
   Switch,
   Match,
-} from 'solid-js'
+} from "solid-js";
 import {
   createDialog,
   createOverlayTrigger,
+  focusSafely,
   type AriaDialogProps,
-} from '@proyecto-viviana/solidaria'
-import { createOverlayTriggerState } from '@proyecto-viviana/solid-stately'
-import { DialogTriggerContext, useOverlayTriggerState } from './contexts'
+} from "@proyecto-viviana/solidaria";
+import {
+  createOverlayTriggerState,
+  type OverlayTriggerState,
+} from "@proyecto-viviana/solid-stately";
+import { DialogTriggerContext, useOverlayTriggerState } from "./contexts";
 import {
   type RenderChildren,
   type ClassNameOrFunction,
@@ -30,181 +34,206 @@ import {
   type SlotProps,
   useRenderProps,
   filterDOMProps,
-} from './utils'
-
-// ============================================
-// TYPES
-// ============================================
+} from "./utils";
 
 export interface DialogRenderProps {
   /** Function to close the dialog */
-  close: () => void
+  close: () => void;
 }
 
-export interface DialogProps extends Omit<AriaDialogProps, 'class' | 'style'>, SlotProps {
+export interface DialogProps extends Omit<AriaDialogProps, "class" | "style">, SlotProps {
   /** The children of the component - can be JSX or render function. */
-  children?: RenderChildren<DialogRenderProps>
+  children?: RenderChildren<DialogRenderProps>;
   /** The CSS className for the element. */
-  class?: ClassNameOrFunction<DialogRenderProps>
+  class?: ClassNameOrFunction<DialogRenderProps>;
   /** The inline style for the element. */
-  style?: StyleOrFunction<DialogRenderProps>
+  style?: StyleOrFunction<DialogRenderProps>;
   /** Callback when dialog should close */
-  onClose?: () => void
+  onClose?: () => void;
 }
 
 export interface DialogTriggerProps {
   /** The children - should include a trigger and modal/popover content. */
-  children: JSX.Element
+  children: JSX.Element;
   /** Whether the dialog is open (controlled). */
-  isOpen?: boolean
+  isOpen?: boolean;
   /** Whether the dialog is open by default (uncontrolled). */
-  defaultOpen?: boolean
+  defaultOpen?: boolean;
   /** Callback when open state changes. */
-  onOpenChange?: (isOpen: boolean) => void
+  onOpenChange?: (isOpen: boolean) => void;
 }
 
-// ============================================
-// CONTEXTS
-// ============================================
-
 interface DialogContextValue {
-  close: () => void
-  titleId?: string
+  close: () => void;
+  titleId?: string;
 }
 
-export const DialogContext = createContext<DialogContextValue | null>(null)
+export const DialogContext = createContext<DialogContextValue | null>(null);
 
-// Re-export DialogTriggerContext from shared contexts (also imported above for local use)
-export { DialogTriggerContext, useDialogTrigger } from './contexts'
-
-// ============================================
-// DIALOG TRIGGER COMPONENT
-// ============================================
+export { DialogTriggerContext, useDialogTrigger } from "./contexts";
 
 /**
  * A DialogTrigger opens a dialog when a trigger element is pressed.
  * Children should include a trigger element (e.g. Button) and the dialog content.
  */
 export function DialogTrigger(props: DialogTriggerProps): JSX.Element {
-  const [local] = splitProps(props, ['isOpen', 'defaultOpen', 'onOpenChange'])
+  const [local] = splitProps(props, ["isOpen", "defaultOpen", "onOpenChange"]);
 
-  // Create overlay trigger state
   const state = createOverlayTriggerState({
     get isOpen() {
-      return local.isOpen
+      return local.isOpen;
     },
     get defaultOpen() {
-      return local.defaultOpen
+      return local.defaultOpen;
     },
     onOpenChange: local.onOpenChange,
-  })
-
-  // Ref for the trigger element
-  let triggerRef: HTMLElement | null = null
-  const triggerId = createUniqueId()
-
-  // Create overlay trigger props (used via context, not directly applied)
-  createOverlayTrigger(
-    { type: 'dialog' },
-    state,
-    () => triggerRef
-  )
+  });
+
+  let triggerRef: HTMLElement | null = null;
+  const triggerId = createUniqueId();
+
+  // Create overlay trigger props so registered trigger components can expose
+  // the same expanded/controls relationship as React Aria DialogTrigger.
+  const triggerAria = createOverlayTrigger({ type: "dialog" }, state, () => triggerRef);
+
+  const restoreFocusToTrigger = () => {
+    const trigger = triggerRef;
+    if (!trigger?.isConnected) return;
+
+    const win = trigger.ownerDocument.defaultView ?? window;
+    win.requestAnimationFrame(() => {
+      win.requestAnimationFrame(() => {
+        if (trigger.isConnected && !state.isOpen()) {
+          focusSafely(trigger);
+        }
+      });
+    });
+  };
+
+  const stateWithFocusRestore: OverlayTriggerState = {
+    isOpen: state.isOpen,
+    setOpen: (isOpen) => {
+      state.setOpen(isOpen);
+      if (!isOpen) {
+        restoreFocusToTrigger();
+      }
+    },
+    open: state.open,
+    close: () => {
+      state.close();
+      restoreFocusToTrigger();
+    },
+    toggle: () => {
+      const wasOpen = state.isOpen();
+      state.toggle();
+      if (wasOpen) {
+        restoreFocusToTrigger();
+      }
+    },
+  };
 
   const setTriggerRef = (el: HTMLElement | null) => {
-    if (!el) return
+    if (!el) return;
     if (!triggerRef || !triggerRef.isConnected) {
-      triggerRef = el
+      triggerRef = el;
     }
-  }
+  };
 
   // Context value - memoized to avoid unnecessary re-renders
   const contextValue = createMemo(() => ({
-    state,
+    state: stateWithFocusRestore,
     triggerRef: () => triggerRef,
     setTriggerRef,
     triggerId,
-  }))
+    triggerProps: triggerAria.triggerProps,
+    overlayProps: triggerAria.overlayProps,
+  }));
 
   // In SolidJS, we simply render children directly within the provider
-  // The children will have access to the context
   return (
     <DialogTriggerContext.Provider value={contextValue()}>
       {props.children}
     </DialogTriggerContext.Provider>
-  )
+  );
 }
 
-// ============================================
-// DIALOG COMPONENT
-// ============================================
-
 /**
  * A dialog is an overlay shown above other content in an application.
  */
 export function Dialog(props: DialogProps): JSX.Element {
   const [local, ariaProps, rest] = splitProps(
     props,
-    ['class', 'style', 'slot', 'onClose'],
-    ['role', 'aria-label', 'aria-labelledby', 'aria-describedby']
-  )
+    ["class", "style", "slot", "onClose"],
+    ["role", "aria-label", "aria-labelledby", "aria-describedby"],
+  );
 
-  let dialogRef!: HTMLDivElement
+  let dialogRef!: HTMLDivElement;
 
   // Get trigger context for aria-labelledby fallback
-  const triggerContext = useContext(DialogTriggerContext)
+  const triggerContext = useContext(DialogTriggerContext);
 
   // createDialog returns dialogProps AND titleProps (with the id for the Heading)
   const { dialogProps, titleProps } = createDialog(
     {
       get role() {
-        return ariaProps.role
+        return ariaProps.role;
       },
-      get 'aria-label'() {
-        return ariaProps['aria-label']
+      get "aria-label"() {
+        return ariaProps["aria-label"];
       },
-      get 'aria-labelledby'() {
-        return ariaProps['aria-labelledby']
+      get "aria-labelledby"() {
+        return ariaProps["aria-labelledby"];
       },
-      get 'aria-describedby'() {
-        return ariaProps['aria-describedby']
+      get "aria-describedby"() {
+        return ariaProps["aria-describedby"];
       },
     },
-    () => dialogRef
-  )
+    () => dialogRef,
+  );
 
   // Get titleId from titleProps - this links Dialog's aria-labelledby to Heading's id
-  const titleId = () => titleProps()?.id
+  const titleId = () => titleProps()?.id as string | undefined;
 
   // Get close function from OverlayTriggerState context or onClose prop
-  const overlayState = useOverlayTriggerState()
+  const overlayState = useOverlayTriggerState();
 
   const close = () => {
-    local.onClose?.()
+    local.onClose?.();
     if (overlayState) {
-      overlayState.close()
-      return
+      overlayState.close();
+      return;
+    }
+    triggerContext?.state.close();
+  };
+
+  createEffect(() => {
+    if (!dialogRef || ariaProps["aria-label"] || ariaProps["aria-labelledby"]) return;
+    const labelledBy = dialogRef.getAttribute("aria-labelledby");
+    if (labelledBy && dialogRef.ownerDocument.getElementById(labelledBy)) return;
+
+    const trigger = triggerContext?.triggerRef();
+    if (trigger?.id) {
+      dialogRef.setAttribute("aria-labelledby", trigger.id);
     }
-    triggerContext?.state.close()
-  }
+  });
 
-  // Render props values
   const renderValues = createMemo<DialogRenderProps>(() => ({
     close,
-  }))
+  }));
 
-  // Resolve render props
   const renderProps = useRenderProps(
     {
       children: props.children,
       class: local.class,
       style: local.style,
-      defaultClassName: 'solidaria-Dialog',
+      defaultClassName: "solidaria-Dialog",
     },
-    renderValues
-  )
+    renderValues,
+  );
 
-  // Filter DOM props
-  const domProps = createMemo(() => filterDOMProps(rest as Record<string, unknown>, { global: true }))
+  const domProps = createMemo(() =>
+    filterDOMProps(rest as Record<string, unknown>, { global: true }),
+  );
 
   return (
     <DialogContext.Provider value={{ close, titleId: titleId() }}>
@@ -214,26 +243,23 @@ export function Dialog(props: DialogProps): JSX.Element {
         ref={dialogRef}
         class={renderProps.class()}
         style={renderProps.style()}
+        slot={local.slot}
       >
         {renderProps.renderChildren()}
       </div>
     </DialogContext.Provider>
-  )
+  );
 }
 
-// ============================================
-// HEADING COMPONENT
-// ============================================
-
 export interface HeadingProps {
   /** The children of the heading. */
-  children: JSX.Element
+  children: JSX.Element;
   /** The CSS className. */
-  class?: string
+  class?: string;
   /** The heading level (1-6). Defaults to 2. */
-  level?: 1 | 2 | 3 | 4 | 5 | 6
+  level?: 1 | 2 | 3 | 4 | 5 | 6;
   /** The slot to render into. */
-  slot?: string
+  slot?: string;
 }
 
 /**
@@ -241,53 +267,65 @@ export interface HeadingProps {
  * When rendered inside a Dialog, automatically gets the titleProps.
  */
 export function Heading(props: HeadingProps): JSX.Element {
-  const dialogContext = useContext(DialogContext)
-  const level = () => props.level ?? 2
-  const id = () => dialogContext?.titleId
-  let headingRef: HTMLHeadingElement | undefined
+  const dialogContext = useContext(DialogContext);
+  const level = () => props.level ?? 2;
+  const id = () => dialogContext?.titleId;
+  let headingRef: HTMLHeadingElement | undefined;
 
   createEffect(() => {
-    const el = headingRef
-    if (!el) return
+    const el = headingRef;
+    if (!el) return;
 
-    const contextId = id()
+    const contextId = id();
     if (contextId) {
-      el.id = contextId
-      return
+      el.id = contextId;
+      return;
     }
 
     if (!el.id) {
-      const dialog = el.closest('[role="dialog"],[role="alertdialog"]')
-      const labelledBy = dialog?.getAttribute('aria-labelledby')
+      const dialog = el.closest('[role="dialog"],[role="alertdialog"]');
+      const labelledBy = dialog?.getAttribute("aria-labelledby");
       if (labelledBy && !el.ownerDocument.getElementById(labelledBy)) {
-        el.id = labelledBy
+        el.id = labelledBy;
       }
     }
-  })
+  });
 
   return (
     <Switch>
       <Match when={level() === 1}>
-        <h1 ref={headingRef} id={id()} class={props.class}>{props.children}</h1>
+        <h1 ref={headingRef} id={id()} class={props.class}>
+          {props.children}
+        </h1>
       </Match>
       <Match when={level() === 2}>
-        <h2 ref={headingRef} id={id()} class={props.class}>{props.children}</h2>
+        <h2 ref={headingRef} id={id()} class={props.class}>
+          {props.children}
+        </h2>
       </Match>
       <Match when={level() === 3}>
-        <h3 ref={headingRef} id={id()} class={props.class}>{props.children}</h3>
+        <h3 ref={headingRef} id={id()} class={props.class}>
+          {props.children}
+        </h3>
       </Match>
       <Match when={level() === 4}>
-        <h4 ref={headingRef} id={id()} class={props.class}>{props.children}</h4>
+        <h4 ref={headingRef} id={id()} class={props.class}>
+          {props.children}
+        </h4>
       </Match>
       <Match when={level() === 5}>
-        <h5 ref={headingRef} id={id()} class={props.class}>{props.children}</h5>
+        <h5 ref={headingRef} id={id()} class={props.class}>
+          {props.children}
+        </h5>
       </Match>
       <Match when={level() === 6}>
-        <h6 ref={headingRef} id={id()} class={props.class}>{props.children}</h6>
+        <h6 ref={headingRef} id={id()} class={props.class}>
+          {props.children}
+        </h6>
       </Match>
     </Switch>
-  )
+  );
 }
 
 // Keep backward compatibility
-export { Heading as DialogHeading }
+export { Heading as DialogHeading };