@cdx-ui/components 0.0.1-alpha.4 → 0.0.1-alpha.41

package/src/components/Dialog/index.tsx

@@ -0,0 +1,304 @@
+import { forwardRef, type ReactNode } from 'react';
+import { Pressable, Text, View, type PressableProps, type ViewProps } from 'react-native';
+import { Close as CloseIcon } from '@cdx-ui/icons';
+import {
+  createDialog,
+  type IDialogBodyProps,
+  type IDialogCloseProps,
+  type IDialogContentProps,
+  type IDialogDescriptionProps,
+  type IDialogFooterProps,
+  type IDialogHeaderProps,
+  type IDialogRootProps,
+  type IDialogTitleProps,
+  type IDialogTriggerProps,
+} from '@cdx-ui/primitives';
+import { cn, useStyleContext, withStyleContext } from '@cdx-ui/utils';
+import { Icon } from '../Icon';
+import {
+  type DialogVariantProps,
+  dialogBodyVariants,
+  dialogCloseIconVariants,
+  dialogCloseVariants,
+  dialogContentVariants,
+  dialogDescriptionVariants,
+  dialogFooterVariants,
+  dialogHeaderVariants,
+  dialogOverlayVariants,
+  dialogTitleVariants,
+} from './styles';
+
+export { useDialog } from '@cdx-ui/primitives';
+
+// =============================================================================
+// STYLE CONTEXT
+// =============================================================================
+
+const SCOPE = 'DIALOG';
+
+const Root = withStyleContext(View, SCOPE);
+
+const useDialogStyleContext = () => useStyleContext(SCOPE) as DialogVariantProps;
+
+// =============================================================================
+// STYLED OVERLAY (internal — not consumer-facing)
+// =============================================================================
+
+const StyledOverlay = forwardRef<View, PressableProps & { className?: string }>(
+  ({ className, ...props }, ref) => (
+    <Pressable ref={ref} className={cn(dialogOverlayVariants(), className)} {...props} />
+  ),
+);
+StyledOverlay.displayName = 'Dialog.Overlay';
+
+// =============================================================================
+// CREATE DIALOG PRIMITIVE
+// =============================================================================
+
+const DialogPrimitive = createDialog({
+  Root,
+  Trigger: Pressable,
+  Overlay: StyledOverlay,
+  Content: View,
+  Header: View,
+  Title: Text,
+  Description: Text,
+  Body: View,
+  Footer: View,
+  Close: Pressable,
+});
+
+// =============================================================================
+// STYLED ROOT
+// =============================================================================
+
+export interface DialogRootProps
+  extends Omit<ViewProps, 'children' | 'role'>, IDialogRootProps, DialogVariantProps {
+  className?: string;
+}
+
+const DialogRoot = forwardRef<View, DialogRootProps>(
+  ({ size = 'md', className, children, style, ...props }, ref) => (
+    <DialogPrimitive ref={ref} className={className} style={style} context={{ size }} {...props}>
+      {children}
+    </DialogPrimitive>
+  ),
+);
+
+DialogRoot.displayName = 'Dialog';
+
+// =============================================================================
+// STYLED TRIGGER
+// =============================================================================
+
+export interface DialogTriggerProps extends IDialogTriggerProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const DialogTrigger = forwardRef<View, DialogTriggerProps>(
+  ({ className, children, style, ...props }, ref) => (
+    <DialogPrimitive.Trigger ref={ref} className={className} style={style} {...props}>
+      {children}
+    </DialogPrimitive.Trigger>
+  ),
+);
+
+DialogTrigger.displayName = 'Dialog.Trigger';
+
+// =============================================================================
+// STYLED CONTENT
+// =============================================================================
+
+export interface DialogContentProps extends IDialogContentProps, DialogVariantProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const DialogContent = forwardRef<View, DialogContentProps>(
+  ({ size: sizeProp, className, children, style, ...props }, ref) => {
+    const { size: contextSize } = useDialogStyleContext();
+    const size = sizeProp ?? contextSize;
+    const computedClassName = cn(dialogContentVariants({ size }), className);
+
+    return (
+      <DialogPrimitive.Content ref={ref} className={computedClassName} style={style} {...props}>
+        {children}
+      </DialogPrimitive.Content>
+    );
+  },
+);
+
+DialogContent.displayName = 'Dialog.Content';
+
+// =============================================================================
+// STYLED HEADER
+// =============================================================================
+
+export interface DialogHeaderProps extends IDialogHeaderProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const DialogHeader = forwardRef<View, DialogHeaderProps>(
+  ({ className, children, style, ...props }, ref) => {
+    const computedClassName = cn(dialogHeaderVariants(), className);
+
+    return (
+      <DialogPrimitive.Header ref={ref} className={computedClassName} style={style} {...props}>
+        {children}
+      </DialogPrimitive.Header>
+    );
+  },
+);
+
+DialogHeader.displayName = 'Dialog.Header';
+
+// =============================================================================
+// STYLED TITLE
+// =============================================================================
+
+export interface DialogTitleProps extends IDialogTitleProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const DialogTitle = forwardRef<Text, DialogTitleProps>(
+  ({ className, children, style, ...props }, ref) => {
+    const computedClassName = cn(dialogTitleVariants(), className);
+
+    return (
+      <DialogPrimitive.Title ref={ref} className={computedClassName} style={style} {...props}>
+        {children}
+      </DialogPrimitive.Title>
+    );
+  },
+);
+
+DialogTitle.displayName = 'Dialog.Title';
+
+// =============================================================================
+// STYLED DESCRIPTION
+// =============================================================================
+
+export interface DialogDescriptionProps extends IDialogDescriptionProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const DialogDescription = forwardRef<Text, DialogDescriptionProps>(
+  ({ className, children, style, ...props }, ref) => {
+    const computedClassName = cn(dialogDescriptionVariants(), className);
+
+    return (
+      <DialogPrimitive.Description ref={ref} className={computedClassName} style={style} {...props}>
+        {children}
+      </DialogPrimitive.Description>
+    );
+  },
+);
+
+DialogDescription.displayName = 'Dialog.Description';
+
+// =============================================================================
+// STYLED BODY
+// =============================================================================
+
+export interface DialogBodyProps extends IDialogBodyProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const DialogBody = forwardRef<View, DialogBodyProps>(
+  ({ className, children, style, ...props }, ref) => {
+    const computedClassName = cn(dialogBodyVariants(), className);
+
+    return (
+      <DialogPrimitive.Body ref={ref} className={computedClassName} style={style} {...props}>
+        {children}
+      </DialogPrimitive.Body>
+    );
+  },
+);
+
+DialogBody.displayName = 'Dialog.Body';
+
+// =============================================================================
+// STYLED FOOTER
+// =============================================================================
+
+export interface DialogFooterProps extends IDialogFooterProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const DialogFooter = forwardRef<View, DialogFooterProps>(
+  ({ className, children, style, ...props }, ref) => {
+    const computedClassName = cn(dialogFooterVariants(), className);
+
+    return (
+      <DialogPrimitive.Footer ref={ref} className={computedClassName} style={style} {...props}>
+        {children}
+      </DialogPrimitive.Footer>
+    );
+  },
+);
+
+DialogFooter.displayName = 'Dialog.Footer';
+
+// =============================================================================
+// STYLED CLOSE
+// =============================================================================
+
+export interface DialogCloseProps extends IDialogCloseProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const DialogClose = forwardRef<View, DialogCloseProps>(
+  ({ className, accessibilityLabel = 'Close', children, style, ...props }, ref) => {
+    const computedClassName = cn(dialogCloseVariants(), className);
+
+    return (
+      <DialogPrimitive.Close
+        ref={ref}
+        className={computedClassName}
+        style={style}
+        hitSlop={12}
+        accessibilityRole="button"
+        accessibilityLabel={accessibilityLabel}
+        {...props}
+      >
+        {children ?? <Icon as={CloseIcon} className={dialogCloseIconVariants()} />}
+      </DialogPrimitive.Close>
+    );
+  },
+);
+
+DialogClose.displayName = 'Dialog.Close';
+
+// =============================================================================
+// COMPOUND COMPONENT
+// =============================================================================
+
+type DialogCompoundComponent = typeof DialogRoot & {
+  Trigger: typeof DialogTrigger;
+  Content: typeof DialogContent;
+  Header: typeof DialogHeader;
+  Title: typeof DialogTitle;
+  Description: typeof DialogDescription;
+  Body: typeof DialogBody;
+  Footer: typeof DialogFooter;
+  Close: typeof DialogClose;
+};
+
+export const Dialog = Object.assign(DialogRoot, {
+  Trigger: DialogTrigger,
+  Content: DialogContent,
+  Header: DialogHeader,
+  Title: DialogTitle,
+  Description: DialogDescription,
+  Body: DialogBody,
+  Footer: DialogFooter,
+  Close: DialogClose,
+}) as DialogCompoundComponent;

package/src/components/Dialog/styles.ts

@@ -0,0 +1,88 @@
+import { Platform } from 'react-native';
+import { cva, type VariantProps } from 'class-variance-authority';
+import {
+  COLOR_BG_INVERSE,
+  COLOR_BG_PRIMARY,
+  COLOR_BORDER_DEFAULT,
+  COLOR_TEXT_PRIMARY,
+  COLOR_TEXT_SECONDARY,
+  RADIUS_MD,
+  SHADOW_MD,
+  TRANSITION_COLORS,
+} from '../../styles/primitives';
+
+// ── Overlay ─────────────────────────────────────────────────
+
+export const dialogOverlayVariants = cva(['absolute inset-0', COLOR_BG_INVERSE, 'opacity-50']);
+
+// ── Content ─────────────────────────────────────────────────
+
+export const dialogContentVariants = cva(
+  [
+    COLOR_BG_PRIMARY,
+    `border ${COLOR_BORDER_DEFAULT}`,
+    RADIUS_MD,
+    Platform.select({ web: SHADOW_MD, default: '' }),
+    'max-h-[85vh] overflow-hidden',
+  ],
+  {
+    variants: {
+      size: {
+        sm: 'w-[90%] max-w-sm',
+        md: 'w-[90%] max-w-md',
+        lg: 'w-[90%] max-w-lg',
+        full: 'w-full mx-4',
+      },
+    },
+    defaultVariants: {
+      size: 'md',
+    },
+  },
+);
+
+// ── Header ──────────────────────────────────────────────────
+
+export const dialogHeaderVariants = cva([
+  'flex-row items-center justify-between shrink-0',
+  'px-6 pt-6 pb-2',
+]);
+
+// ── Title ───────────────────────────────────────────────────
+
+export const dialogTitleVariants = cva(['text-lg font-semibold', COLOR_TEXT_PRIMARY]);
+
+// ── Description ─────────────────────────────────────────────
+
+export const dialogDescriptionVariants = cva(['text-sm mt-1', COLOR_TEXT_SECONDARY]);
+
+// ── Body ────────────────────────────────────────────────────
+
+export const dialogBodyVariants = cva(['px-6 py-4 shrink min-h-0']);
+
+// ── Footer ──────────────────────────────────────────────────
+
+export const dialogFooterVariants = cva([
+  'flex-row items-center justify-end shrink-0',
+  'gap-3 px-6 pt-2 pb-6',
+]);
+
+// ── Close ───────────────────────────────────────────────────
+
+export const dialogCloseVariants = cva([
+  'p-1 -m-1 rounded-full',
+  TRANSITION_COLORS,
+  Platform.select({
+    default: 'data-[active=true]:opacity-70',
+    web: [
+      'data-[hover=true]:bg-slate-100',
+      'data-[active=true]:bg-slate-200',
+      'data-[focus-visible=true]:ring-2 data-[focus-visible=true]:ring-slate-400/50 data-[focus-visible=true]:ring-offset-2',
+    ].join(' '),
+  }),
+]);
+
+// ── Close Icon ──────────────────────────────────────────────
+
+export const dialogCloseIconVariants = cva(['size-5 text-slate-500']);
+
+export type DialogVariantProps = VariantProps<typeof dialogContentVariants>;

package/src/components/Field/FieldLabel.tsx

@@ -0,0 +1,33 @@
+import { forwardRef } from 'react';
+import { Text, TextProps, type GestureResponderEvent } from 'react-native';
+import { composeEventHandlers, useFormControlContext } from '@cdx-ui/utils';
+
+export type BaseFieldLabelProps = TextProps & {
+  /** @platform web — forwarded on web; ignored here (see `FieldLabelRoot.web`). */
+  htmlFor?: string;
+  /** Optional; composed with label tap-to-focus on native. */
+  onPress?: ((event: GestureResponderEvent) => void) | null;
+};
+
+/**
+ * Native: `Text` label row — tap focuses the field input via form context
+ * (parity with `<label htmlFor>` on web).
+ */
+export const BaseFieldLabel = forwardRef<Text, BaseFieldLabelProps>(
+  ({ htmlFor: _omitHtmlFor, onPress, ...props }, ref) => {
+    void _omitHtmlFor;
+
+    const { focusInput, isDisabled } = useFormControlContext();
+
+    return (
+      <Text
+        ref={ref}
+        {...props}
+        disabled={Boolean(isDisabled)}
+        onPress={composeEventHandlers(onPress, () => focusInput?.())}
+      />
+    );
+  },
+);
+
+BaseFieldLabel.displayName = 'BaseFieldLabel';

package/src/components/Field/FieldLabel.web.tsx

@@ -0,0 +1,25 @@
+import React, { forwardRef, type ReactNode } from 'react';
+import type { ViewProps } from 'react-native';
+
+// TODO: Why does dataSet need to be decomposed into individual data attributes?
+
+export type BaseFieldLabelProps = ViewProps & {
+  htmlFor?: string;
+  children?: ReactNode;
+  /** @platform native — ignored on DOM `<label>`; set by form primitive for Uniwind. */
+  dataSet?: Record<string, string>;
+};
+
+/** Real `<label>` so clicking the label focuses the associated control (`htmlFor` → input `id`). */
+export const BaseFieldLabel = forwardRef<HTMLLabelElement, BaseFieldLabelProps>((props, ref) => {
+  return (
+    <label
+      ref={ref}
+      {...(props as React.LabelHTMLAttributes<HTMLLabelElement>)}
+      data-invalid={props.dataSet?.invalid}
+      data-required={props.dataSet?.required}
+    />
+  );
+});
+
+BaseFieldLabel.displayName = 'BaseFieldLabel';

package/src/components/Field/index.tsx

@@ -0,0 +1,171 @@
+import { forwardRef } from 'react';
+import { Text, View } from 'react-native';
+import { ErrorIcon } from '@cdx-ui/icons';
+import {
+  createField,
+  IFieldErrorProps,
+  IFieldHelperProps,
+  IFieldLabelProps,
+  type IFieldRootProps,
+} from '@cdx-ui/primitives';
+import { cn } from '@cdx-ui/utils';
+import { Icon } from '../Icon';
+import { BaseFieldLabel } from './FieldLabel';
+import {
+  fieldErrorIconVariants,
+  fieldErrorTextVariants,
+  fieldErrorVariants,
+  fieldHelperVariants,
+  fieldHelperTextVariants,
+  fieldLabelVariants,
+  fieldRootVariants,
+  type FieldRootVariantProps,
+  type FieldLabelVariantProps,
+  type FieldHelperVariantProps,
+  type FieldErrorVariantProps,
+} from './styles';
+
+// =============================================================================
+// PRIMITIVE
+// =============================================================================
+
+const FieldPrimitive = createField({
+  Root: View,
+  Label: BaseFieldLabel,
+  Helper: View,
+  HelperText: Text,
+  Error: View,
+  ErrorText: Text,
+  ErrorIcon: View,
+});
+
+// =============================================================================
+// FIELD ROOT
+// =============================================================================
+
+/**
+ * Field wrapper + context. For **initial focus**, pass `autoFocus` on `Input.Field` (not here).
+ */
+export interface FieldRootProps extends IFieldRootProps, FieldRootVariantProps {}
+
+const FieldRoot = forwardRef<View, FieldRootProps>(
+  ({ className, children, style, ...props }, ref) => {
+    const computedClassName = cn(fieldRootVariants(), className);
+
+    return (
+      <FieldPrimitive ref={ref} className={computedClassName} style={style} {...props}>
+        {children}
+      </FieldPrimitive>
+    );
+  },
+);
+
+FieldRoot.displayName = 'Field';
+
+// =============================================================================
+// FIELD LABEL
+// =============================================================================
+
+export interface FieldLabelProps extends IFieldLabelProps, FieldLabelVariantProps {}
+
+const FieldLabel = forwardRef<View, FieldLabelProps>(
+  ({ className, children, style, htmlFor, ...props }, ref) => {
+    const labelClassName = cn(fieldLabelVariants(), className);
+
+    return (
+      <FieldPrimitive.Label
+        ref={ref}
+        className={labelClassName}
+        style={style}
+        htmlFor={htmlFor}
+        requiredIndicator={
+          <Text className="text-red-500" aria-hidden>
+            {' *'}
+          </Text>
+        }
+        {...props}
+      >
+        {children}
+      </FieldPrimitive.Label>
+    );
+  },
+);
+
+FieldLabel.displayName = 'Field.Label';
+
+// =============================================================================
+// FIELD HELPER
+// =============================================================================
+
+export interface FieldHelperProps extends IFieldHelperProps, FieldHelperVariantProps {}
+
+const FieldHelper = forwardRef<View, FieldHelperProps>(
+  ({ className, children, style, ...props }, ref) => {
+    const containerClassName = cn(fieldHelperVariants(), className);
+    const textClassName = cn(fieldHelperTextVariants());
+
+    return (
+      <FieldPrimitive.Helper ref={ref} className={containerClassName} style={style} {...props}>
+        <FieldPrimitive.HelperText className={textClassName}>{children}</FieldPrimitive.HelperText>
+      </FieldPrimitive.Helper>
+    );
+  },
+);
+
+FieldHelper.displayName = 'Field.Helper';
+
+// =============================================================================
+// FIELD ERROR (internal icon + text composition)
+// =============================================================================
+
+const FieldErrorIcon = ({ className, style, ...props }: { className?: string; style?: any }) => {
+  const computedClassName = cn(fieldErrorIconVariants(), className);
+
+  return (
+    <Icon
+      as={ErrorIcon}
+      className={computedClassName}
+      style={style}
+      aria-hidden={true}
+      {...props}
+    />
+  );
+};
+
+FieldErrorIcon.displayName = 'Field.ErrorIcon';
+
+export interface FieldErrorProps extends IFieldErrorProps, FieldErrorVariantProps {}
+
+const FieldError = forwardRef<View, FieldErrorProps>(
+  ({ className, children, style, ...props }, ref) => {
+    const containerClassName = cn(fieldErrorVariants(), className);
+    const textClassName = cn(fieldErrorTextVariants());
+
+    return (
+      <FieldPrimitive.Error ref={ref} className={containerClassName} style={style} {...props}>
+        <FieldPrimitive.ErrorIcon>
+          <FieldErrorIcon />
+        </FieldPrimitive.ErrorIcon>
+        <FieldPrimitive.ErrorText className={textClassName}>{children}</FieldPrimitive.ErrorText>
+      </FieldPrimitive.Error>
+    );
+  },
+);
+
+FieldError.displayName = 'Field.Error';
+
+// =============================================================================
+// COMPOUND EXPORT
+// =============================================================================
+
+type FieldCompoundComponent = typeof FieldRoot & {
+  Label: typeof FieldLabel;
+  Helper: typeof FieldHelper;
+  Error: typeof FieldError;
+};
+
+export const Field = Object.assign(FieldRoot, {
+  Label: FieldLabel,
+  Helper: FieldHelper,
+  Error: FieldError,
+}) as FieldCompoundComponent;

package/src/components/Field/styles.ts

@@ -0,0 +1,32 @@
+import { cva, type VariantProps } from 'class-variance-authority';
+import { DISABLED_OPACITY } from '../../styles/primitives';
+
+export const fieldRootVariants = cva(['flex-col gap-2', 'web:last:mb-0', DISABLED_OPACITY]);
+
+export const fieldLabelVariants = cva([
+  'body-md',
+  'font-medium',
+  'text-content-primary',
+  'flex-row items-center',
+  DISABLED_OPACITY,
+  'web:cursor-pointer',
+  'data-[invalid=true]:text-content-danger',
+]);
+
+export const fieldHelperVariants = cva(['flex-row items-center']);
+
+export const fieldHelperTextVariants = cva(['body-sm', 'text-content-tertiary']);
+
+export const fieldErrorVariants = cva(['flex-row items-center gap-1']);
+
+export const fieldErrorTextVariants = cva(['body-sm', 'text-content-danger']);
+
+export const fieldErrorIconVariants = cva(['size-3.5', 'text-content-danger']);
+
+export type FieldRootVariantProps = VariantProps<typeof fieldRootVariants>;
+export type FieldLabelVariantProps = VariantProps<typeof fieldLabelVariants>;
+export type FieldHelperVariantProps = VariantProps<typeof fieldHelperVariants>;
+export type FieldHelperTextVariantProps = VariantProps<typeof fieldHelperTextVariants>;
+export type FieldErrorVariantProps = VariantProps<typeof fieldErrorVariants>;
+export type FieldErrorTextVariantProps = VariantProps<typeof fieldErrorTextVariants>;
+export type FieldErrorIconVariantProps = VariantProps<typeof fieldErrorIconVariants>;

package/src/components/Form/FormRoot.tsx

@@ -0,0 +1,20 @@
+import { forwardRef } from 'react';
+import { View, type ViewProps } from 'react-native';
+
+export type BaseFormRootProps = ViewProps & {
+  onSubmit?: (e: React.SyntheticEvent) => void;
+  action?: string | ((formData: FormData) => void | Promise<void>);
+  method?: string;
+  className?: string;
+};
+
+export const BaseFormRoot = forwardRef<View, BaseFormRootProps>(
+  ({ onSubmit: _onSubmit, action: _action, method: _method, ...props }, ref) => {
+    void _onSubmit;
+    void _action;
+    void _method;
+    return <View ref={ref} {...props} />;
+  },
+);
+
+BaseFormRoot.displayName = 'BaseFormRoot';

package/src/components/Form/FormRoot.web.tsx

@@ -0,0 +1,12 @@
+import React, { forwardRef } from 'react';
+
+export type BaseFormRootProps = React.FormHTMLAttributes<HTMLFormElement> & {
+  className?: string;
+  children?: React.ReactNode;
+};
+
+export const BaseFormRoot = forwardRef<HTMLFormElement, BaseFormRootProps>((props, ref) => {
+  return <form ref={ref} {...props} />;
+});
+
+BaseFormRoot.displayName = 'BaseFormRoot';