@regardio/react 0.4.7 → 0.5.1

package/src/{components → heading}/heading.tsx

@@ -1,43 +1,36 @@
+import { cn, tv } from '@regardio/tailwind/utils';
 import type { ElementType, HTMLAttributes } from 'react';
-import { cn, cva, type VariantProps } from '../utils/cn';
 import { lowerCaseSzett, shy } from '../utils/text';
 
-const heading = cva({
+const levelVariants = {
+  1: ['text-2xl'],
+  2: ['text-xl'],
+  3: ['text-lg'],
+  4: ['text-md'],
+  5: ['text-sm'],
+  6: ['text-xs'],
+} as const;
+
+const heading = tv({
   base: [],
   defaultVariants: {
     level: 3,
   },
   variants: {
-    level: {
-      1: ['text-2xl'],
-      2: ['text-xl'],
-      3: ['text-lg'],
-      4: ['text-md'],
-      5: ['text-sm'],
-      6: ['text-xs'],
-    },
-    variant: {},
+    level: levelVariants,
   },
 });
 
-export interface HeadingProps
-  extends HTMLAttributes<HTMLHeadingElement>,
-    VariantProps<typeof heading> {
+export type HeadingLevel = keyof typeof levelVariants;
+
+export interface HeadingProps extends HTMLAttributes<HTMLHeadingElement> {
   as?: ElementType;
   className?: string;
+  level?: HeadingLevel;
   locale?: string;
 }
 
-export type HeadingLevel = HeadingProps['level'];
-
-export const Heading = ({
-  as,
-  children,
-  className,
-  level = 2,
-  variant,
-  ...props
-}: HeadingProps) => {
+export const Heading = ({ as, children, className, level = 2, ...props }: HeadingProps) => {
   const word = lowerCaseSzett(shy(children));
   const Component: ElementType = as || `h${level}`;
 
@@ -46,7 +39,6 @@ export const Heading = ({
       className={cn(
         heading({
           level,
-          variant,
         }),
         className,
       )}

package/src/heading/index.ts

@@ -0,0 +1,2 @@
+export type { HeadingLevel, HeadingProps } from './heading';
+export { Heading } from './heading';

package/src/{stories/Highlight.stories.tsx → highlight/highlight.stories.tsx}

@@ -1,5 +1,5 @@
 import type { Meta, StoryObj } from '@storybook/react-vite';
-import { Highlight } from '../components/highlight';
+import { Highlight } from './highlight';
 
 const meta: Meta<typeof Highlight> = {
   component: Highlight,

package/src/{components → highlight}/highlight.tsx

@@ -1,25 +1,29 @@
+import { tv } from '@regardio/tailwind/utils';
 import type { ComponentProps } from 'react';
-import { cva, type VariantProps } from '../utils/cn';
 
-const li = cva({
+const highlightVariants = {
+  primary: ['highlight'],
+} as const;
+
+const highlight = tv({
   defaultVariants: {
     variant: 'primary',
   },
   variants: {
-    variant: {
-      primary: ['highlight'],
-    },
+    variant: highlightVariants,
   },
 });
 
-export interface HighlightProps extends ComponentProps<'mark'>, VariantProps<typeof li> {}
+export type HighlightVariant = keyof typeof highlightVariants;
 
-export const Highlight = (props: HighlightProps) => {
-  const { children, className, variant } = props;
+export interface HighlightProps extends ComponentProps<'mark'> {
+  variant?: HighlightVariant;
+}
 
+export const Highlight = ({ children, className, variant }: HighlightProps) => {
   return (
     <mark
-      className={li({
+      className={highlight({
         className,
         variant,
       })}

package/src/highlight/index.ts

@@ -0,0 +1,2 @@
+export type { HighlightProps } from './highlight';
+export { Highlight } from './highlight';

package/src/hooks/use-current-route-data/index.ts

@@ -0,0 +1 @@
+export { useCurrentRouteData } from './use-current-route-data';

package/src/hooks/use-focus-search/index.ts

@@ -0,0 +1 @@
+export { useFocusSearch } from './use-focus-search';

package/src/hooks/use-matches-data/index.ts

@@ -0,0 +1 @@
+export { useMatchesData } from './use-matches-data';

package/src/hooks/use-media-query/index.ts

@@ -0,0 +1 @@
+export { useMediaQuery } from './use-media-query';

package/src/hooks/use-mobile/index.ts

@@ -0,0 +1 @@
+export { useIsMobile } from './use-mobile';

package/src/hooks/use-nonce/index.ts

@@ -0,0 +1 @@
+export { NonceProvider, useNonce } from './use-nonce';

package/src/hooks/use-orientation/index.ts

@@ -0,0 +1 @@
+export { useOrientation } from './use-orientation';

package/src/hooks/use-user/index.ts

@@ -0,0 +1,2 @@
+export type { UserContextProviderProps, UserContextType } from './use-user';
+export { UserContext, UserContextProvider, useUser } from './use-user';

package/src/{stories/IconButton.stories.tsx → icon-button/icon-button.stories.tsx}

@@ -1,5 +1,5 @@
 import type { Meta, StoryObj } from '@storybook/react-vite';
-import { IconButton } from '../components/icon-button';
+import { IconButton } from './icon-button';
 
 const meta: Meta<typeof IconButton> = {
   component: IconButton,

package/src/icon-button/index.ts

@@ -0,0 +1,2 @@
+export type { IconButtonProps } from './icon-button';
+export { IconButton } from './icon-button';

package/src/{stories/If.stories.tsx → if/if.stories.tsx}

@@ -1,5 +1,5 @@
 import type { Meta, StoryObj } from '@storybook/react-vite';
-import { If } from '../components/if';
+import { If } from './if';
 
 const meta: Meta<typeof If> = {
   component: If,

package/src/if/index.ts

@@ -0,0 +1 @@
+export { If } from './if';

package/src/{stories/Iframe.stories.tsx → iframe/iframe.stories.tsx}

@@ -1,5 +1,5 @@
 import type { Meta, StoryObj } from '@storybook/react-vite';
-import { Iframe } from '../components/iframe';
+import { Iframe } from './iframe';
 
 const meta: Meta<typeof Iframe> = {
   component: Iframe,

package/src/{components → iframe}/iframe.tsx

@@ -1,5 +1,5 @@
+import { cn } from '@regardio/tailwind/utils';
 import type React from 'react';
-import { cn } from '../utils/cn';
 
 export type IframeProps = {
   src: string;

package/src/iframe/index.ts

@@ -0,0 +1,2 @@
+export type { IframeProps } from './iframe';
+export { Iframe } from './iframe';

package/src/link/index.ts

@@ -0,0 +1,2 @@
+export type { LinkBaseProps, LinkProps, MarkdownLinkProps, PathResolver } from './link';
+export { Link, LinkBase, MarkdownLink, PathResolverProvider, usePathResolver } from './link';

package/src/{stories/Link.stories.tsx → link/link.stories.tsx}

@@ -1,6 +1,6 @@
 import type { Meta, StoryObj } from '@storybook/react-vite';
 import { MemoryRouter } from 'react-router';
-import { Link } from '../components/link';
+import { Link } from './link';
 
 const meta: Meta<typeof Link> = {
   component: Link,

package/src/{components → link}/link.tsx

@@ -1,7 +1,9 @@
+'use client';
+
+import { tv } from '@regardio/tailwind/utils';
 import { createContext, useCallback, useContext } from 'react';
 import type { NavLinkProps, NavLinkRenderProps } from 'react-router';
 import { NavLink } from 'react-router';
-import { cva, type VariantProps } from '../utils/cn';
 import { lowerCaseSzett } from '../utils/text';
 
 /**
@@ -120,42 +122,51 @@ export const LinkBase = ({
   );
 };
 
-const link = cva({
+const arrowVariants = {
+  darr: 'darr',
+  larr: 'larr',
+  rarr: 'rarr',
+  uarr: 'uarr',
+} as const;
+
+const linkVariants = {
+  button: [
+    'block',
+    'button',
+    'mt-s',
+    'relative',
+    'rarr',
+    'text-right',
+    'text-sm',
+    'tracking-wider',
+    'uppercase',
+  ],
+  code: ['font-monospace'],
+  link: ['rarr', '!bg-transparent', 'uppercase', '!tracking-wider'],
+  navtitle: ['block', 'uppercase', 'tracking-wider'],
+  primary: [],
+  subtitle: ['text-lg'],
+} as const;
+
+const link = tv({
   base: [],
   defaultVariants: {
     variant: 'primary',
   },
   variants: {
-    arrow: {
-      darr: 'darr',
-      larr: 'larr',
-      rarr: 'rarr',
-      uarr: 'uarr',
-    },
-    variant: {
-      button: [
-        'block',
-        'button',
-        'mt-s',
-        'relative',
-        'rarr',
-        'text-right',
-        'text-sm',
-        'tracking-wider',
-        'uppercase',
-      ],
-      code: ['font-monospace'],
-      link: ['rarr', '!bg-transparent', 'uppercase', '!tracking-wider'],
-      navtitle: ['block', 'uppercase', 'tracking-wider'],
-      primary: [],
-      subtitle: ['text-lg'],
-    },
+    arrow: arrowVariants,
+    variant: linkVariants,
   },
 });
 
-export interface LinkProps extends Omit<NavLinkProps, 'to'>, VariantProps<typeof link> {
+export type LinkArrow = keyof typeof arrowVariants;
+export type LinkVariant = keyof typeof linkVariants;
+
+export interface LinkProps extends Omit<NavLinkProps, 'to'> {
+  arrow?: LinkArrow;
   to?: string | Partial<{ pathname?: string; search?: string; hash?: string }>;
   routeKey?: string;
+  variant?: LinkVariant;
   viewTransition?: boolean;
 }
 
@@ -174,7 +185,7 @@ export const Link = ({
       {...props}
       className={link({
         arrow,
-        className,
+        className: typeof className === 'string' ? className : undefined,
         variant,
       })}
       routeKey={routeKey}

package/src/list/index.parts.ts

@@ -0,0 +1,2 @@
+export { ListItem as Item } from './list-item';
+export { ListRoot as Root } from './list-root';

package/src/list/index.ts

@@ -0,0 +1,4 @@
+export * as List from './index.parts';
+export type { ListItemProps } from './list-item';
+export type { ListRootProps } from './list-root';
+export type { ListRootContextValue } from './list-root-context';

package/src/list/list-item.tsx

@@ -0,0 +1,63 @@
+'use client';
+
+import {
+  type ComponentPropsWithoutRef,
+  type ElementType,
+  type ForwardedRef,
+  forwardRef,
+  type ReactNode,
+} from 'react';
+import { useListRootContext } from './list-root-context';
+
+type ListItemElement = 'li' | 'dd' | 'dt' | 'div' | 'span';
+
+export type ListItemProps<T extends ListItemElement = 'li'> = Omit<
+  ComponentPropsWithoutRef<T>,
+  'children'
+> & {
+  /**
+   * The element type to render.
+   * Falls back to the defaultItemElement from ListRoot context, or 'li'.
+   */
+  render?: T;
+  /**
+   * The content of the list item.
+   */
+  children?: ReactNode;
+};
+
+function ListItemImpl<T extends ListItemElement = 'li'>(
+  props: ListItemProps<T>,
+  ref: ForwardedRef<HTMLElement>,
+) {
+  const context = useListRootContext();
+
+  const { render, children, className, ...elementProps } = props;
+
+  const resolvedElement = render ?? context?.defaultItemElement ?? 'li';
+  const resolvedClassName = context?.defaultItemClassName
+    ? className
+      ? `${context.defaultItemClassName} ${className}`
+      : context.defaultItemClassName
+    : className;
+
+  const Component = resolvedElement as ElementType;
+
+  return (
+    <Component
+      className={resolvedClassName}
+      ref={ref}
+      {...elementProps}
+    >
+      {children}
+    </Component>
+  );
+}
+
+export const ListItem = forwardRef(ListItemImpl) as <T extends ListItemElement = 'li'>(
+  props: ListItemProps<T> & { ref?: ForwardedRef<HTMLElement> },
+) => ReturnType<typeof ListItemImpl>;
+
+export namespace ListItem {
+  export type Props<T extends ListItemElement = 'li'> = ListItemProps<T>;
+}

package/src/list/list-root-context.ts

@@ -0,0 +1,21 @@
+'use client';
+
+import { createContext, useContext } from 'react';
+
+export interface ListRootContextValue {
+  /**
+   * Default element type for list items.
+   * @default 'li'
+   */
+  defaultItemElement: 'li' | 'dd' | 'dt' | 'div' | 'span';
+  /**
+   * Default className to apply to all list items.
+   */
+  defaultItemClassName?: string;
+}
+
+export const ListRootContext = createContext<ListRootContextValue | undefined>(undefined);
+
+export function useListRootContext(): ListRootContextValue | undefined {
+  return useContext(ListRootContext);
+}

package/src/list/list-root.tsx

@@ -0,0 +1,81 @@
+'use client';
+
+import {
+  type ComponentPropsWithoutRef,
+  type ElementType,
+  type ForwardedRef,
+  forwardRef,
+  type ReactNode,
+  useMemo,
+} from 'react';
+import { ListRootContext, type ListRootContextValue } from './list-root-context';
+
+type ListRootElement = 'ul' | 'ol' | 'dl' | 'div' | 'menu' | 'nav';
+
+export type ListRootProps<T extends ListRootElement = 'ul'> = Omit<
+  ComponentPropsWithoutRef<T>,
+  'children'
+> & {
+  /**
+   * The element type to render.
+   * @default 'ul'
+   */
+  render?: T;
+  /**
+   * The content of the list.
+   */
+  children?: ReactNode;
+  /**
+   * Default element type for list items.
+   * When render is 'dl', defaults to 'dd'. Otherwise defaults to 'li'.
+   */
+  defaultItemElement?: ListRootContextValue['defaultItemElement'];
+  /**
+   * Default className to apply to all list items.
+   */
+  defaultItemClassName?: string;
+};
+
+function ListRootImpl<T extends ListRootElement = 'ul'>(
+  props: ListRootProps<T>,
+  ref: ForwardedRef<HTMLElement>,
+) {
+  const {
+    render = 'ul' as T,
+    children,
+    defaultItemElement,
+    defaultItemClassName,
+    ...elementProps
+  } = props;
+
+  const resolvedDefaultItemElement = defaultItemElement ?? (render === 'dl' ? 'dd' : 'li');
+
+  const contextValue = useMemo<ListRootContextValue>(
+    () => ({
+      defaultItemClassName,
+      defaultItemElement: resolvedDefaultItemElement,
+    }),
+    [resolvedDefaultItemElement, defaultItemClassName],
+  );
+
+  const Component = render as ElementType;
+
+  return (
+    <ListRootContext.Provider value={contextValue}>
+      <Component
+        ref={ref}
+        {...elementProps}
+      >
+        {children}
+      </Component>
+    </ListRootContext.Provider>
+  );
+}
+
+export const ListRoot = forwardRef(ListRootImpl) as <T extends ListRootElement = 'ul'>(
+  props: ListRootProps<T> & { ref?: ForwardedRef<HTMLElement> },
+) => ReturnType<typeof ListRootImpl>;
+
+export namespace ListRoot {
+  export type Props<T extends ListRootElement = 'ul'> = ListRootProps<T>;
+}

package/src/list/list.css

@@ -0,0 +1,32 @@
+/**
+ * CSS custom properties for List component styling.
+ * These can be overridden at any level to customize the appearance.
+ *
+ * Usage with CSS Modules or plain CSS:
+ * .my-list {
+ *   --list-gap: 1rem;
+ *   --list-padding: 0;
+ * }
+ *
+ * Usage with Tailwind (via arbitrary properties):
+ * <List.Root className="[--list-gap:1rem]">
+ */
+
+:root {
+  /* List Root */
+  --list-gap: 0;
+  --list-padding: 0;
+  --list-margin: 0;
+  --list-style: none;
+
+  /* List Item */
+  --list-item-padding: 0;
+  --list-item-margin: 0;
+
+  /* Definition List specific */
+  --list-dl-grid-columns: auto 1fr;
+  --list-dl-gap-x: 0.5rem;
+  --list-dl-gap-y: 0.25rem;
+  --list-dt-font-weight: 600;
+  --list-dd-margin: 0;
+}

package/src/list/list.stories.tsx

@@ -0,0 +1,119 @@
+import type { Meta, StoryObj } from '@storybook/react-vite';
+import { List } from './index';
+
+const meta: Meta<typeof List.Root> = {
+  component: List.Root,
+  parameters: {
+    layout: 'padded',
+  },
+  tags: ['autodocs'],
+  title: 'Components/List',
+};
+
+export default meta;
+type Story = StoryObj<typeof List.Root>;
+
+export const UnorderedList: Story = {
+  render: () => (
+    <List.Root>
+      <List.Item>First item</List.Item>
+      <List.Item>Second item</List.Item>
+      <List.Item>Third item</List.Item>
+    </List.Root>
+  ),
+};
+
+export const OrderedList: Story = {
+  render: () => (
+    <List.Root render="ol">
+      <List.Item>Step one</List.Item>
+      <List.Item>Step two</List.Item>
+      <List.Item>Step three</List.Item>
+    </List.Root>
+  ),
+};
+
+export const DefinitionList: Story = {
+  render: () => (
+    <List.Root
+      className="grid grid-cols-[auto_1fr] gap-x-4 gap-y-2"
+      render="dl"
+    >
+      <List.Item
+        className="font-semibold"
+        render="dt"
+      >
+        Email
+      </List.Item>
+      <List.Item>contact@example.com</List.Item>
+      <List.Item
+        className="font-semibold"
+        render="dt"
+      >
+        Phone
+      </List.Item>
+      <List.Item>+1 234 567 890</List.Item>
+      <List.Item
+        className="font-semibold"
+        render="dt"
+      >
+        Address
+      </List.Item>
+      <List.Item>123 Main Street, City, Country</List.Item>
+    </List.Root>
+  ),
+};
+
+export const WithDefaultItemClassName: Story = {
+  render: () => (
+    <List.Root defaultItemClassName="py-2 border-b border-gray-200 last:border-0">
+      <List.Item>Styled item one</List.Item>
+      <List.Item>Styled item two</List.Item>
+      <List.Item>Styled item three</List.Item>
+    </List.Root>
+  ),
+};
+
+export const InlineList: Story = {
+  render: () => (
+    <List.Root className="flex flex-wrap gap-2 list-none p-0">
+      <List.Item className="px-2 py-1 bg-gray-100 rounded">Tag 1</List.Item>
+      <List.Item className="px-2 py-1 bg-gray-100 rounded">Tag 2</List.Item>
+      <List.Item className="px-2 py-1 bg-gray-100 rounded">Tag 3</List.Item>
+    </List.Root>
+  ),
+};
+
+export const NavigationMenu: Story = {
+  render: () => (
+    <List.Root
+      className="flex gap-4"
+      defaultItemElement="div"
+      render="nav"
+    >
+      <List.Item className="hover:text-blue-600 cursor-pointer">Home</List.Item>
+      <List.Item className="hover:text-blue-600 cursor-pointer">About</List.Item>
+      <List.Item className="hover:text-blue-600 cursor-pointer">Contact</List.Item>
+    </List.Root>
+  ),
+};
+
+export const CustomElements: Story = {
+  render: () => (
+    <List.Root
+      className="flex gap-2"
+      defaultItemElement="span"
+      render="div"
+    >
+      <List.Item className="px-3 py-1 bg-blue-100 text-blue-800 rounded-full text-sm">
+        React
+      </List.Item>
+      <List.Item className="px-3 py-1 bg-green-100 text-green-800 rounded-full text-sm">
+        TypeScript
+      </List.Item>
+      <List.Item className="px-3 py-1 bg-purple-100 text-purple-800 rounded-full text-sm">
+        Tailwind
+      </List.Item>
+    </List.Root>
+  ),
+};