@cdx-ui/components 0.0.1-beta.18 → 0.0.1-beta.181

package/src/components/RangeCalendar/index.tsx

@@ -0,0 +1,162 @@
+import { forwardRef, useCallback, useId, useMemo, type ReactNode } from 'react';
+import { View, type ViewProps } from 'react-native';
+import { Calendar as FlashCalendar } from '@marceloterreiro/flash-calendar';
+import {
+  dataAttributes,
+  mergeDataAttributes,
+  RangeCalendarRoot as RangeCalendarRootPrimitive,
+  useRangeCalendarContext,
+  type RangeCalendarRootProps,
+} from '@cdx-ui/primitives';
+import { cn } from '@cdx-ui/utils';
+import { CalendarMonthHeader } from '../Calendar/CalendarMonthHeader';
+import { CalendarYearPickerGrid } from '../Calendar/CalendarYearPickerGrid';
+import {
+  FLASH_CALENDAR_DAY_HEIGHT,
+  FLASH_CALENDAR_RANGE_DAY_SPACING,
+  formatFlashCalendarWeekdayShort,
+  toCalendarDateId,
+  useFlashCalendarRangeTheme,
+} from '../Calendar/flashCalendarAdapter';
+import { calendarRootVariants } from '../Calendar/styles';
+
+export interface RangeCalendarProps
+  extends Omit<RangeCalendarRootProps, 'children'>, Omit<ViewProps, 'children'> {
+  className?: string;
+  children?: ReactNode;
+}
+
+function RangeCalendarDefaultBody() {
+  const { view } = useRangeCalendarContext();
+  return (
+    <>
+      <RangeCalendarHeader />
+      {view === 'year' ? <RangeCalendarYearPicker /> : <RangeCalendarGrid />}
+    </>
+  );
+}
+
+const RangeCalendarRoot = forwardRef<View, RangeCalendarProps>(
+  ({ className, children, style, ...props }, ref) => (
+    <RangeCalendarRootPrimitive
+      ref={ref}
+      className={cn(calendarRootVariants(), className)}
+      style={style}
+      {...props}
+      {...mergeDataAttributes(props, dataAttributes({ slot: 'range-calendar' }))}
+    >
+      {children ?? <RangeCalendarDefaultBody />}
+    </RangeCalendarRootPrimitive>
+  ),
+);
+
+RangeCalendarRoot.displayName = 'RangeCalendar';
+
+const RangeCalendarHeader = forwardRef<View, ViewProps>(({ className, style, ...props }, ref) => {
+  const { monthId, onMonthIdChange, disabled, view, setView, locale, labels } =
+    useRangeCalendarContext();
+  return (
+    <CalendarMonthHeader
+      ref={ref}
+      monthId={monthId}
+      onMonthIdChange={onMonthIdChange}
+      disabled={disabled}
+      view={view}
+      onViewChange={setView}
+      locale={locale}
+      labels={labels}
+      className={className}
+      style={style}
+      {...props}
+    />
+  );
+});
+
+RangeCalendarHeader.displayName = 'RangeCalendar.Header';
+
+const RangeCalendarYearPicker = forwardRef<View, ViewProps>(
+  ({ className, style, ...props }, ref) => {
+    const { monthId, onMonthIdChange, disabled, setView, labels } = useRangeCalendarContext();
+    return (
+      <CalendarYearPickerGrid
+        ref={ref}
+        monthId={monthId}
+        onMonthIdChange={onMonthIdChange}
+        disabled={disabled}
+        onViewChange={setView}
+        labels={labels}
+        className={className}
+        style={style}
+        {...props}
+      />
+    );
+  },
+);
+
+RangeCalendarYearPicker.displayName = 'RangeCalendar.YearPicker';
+
+const RangeCalendarGrid = forwardRef<View, ViewProps>(({ className, style, ...props }, ref) => {
+  const { startId, endId, monthId, minValue, maxValue, disabled, onDayPress, locale } =
+    useRangeCalendarContext();
+  const instanceId = useId();
+  const theme = useFlashCalendarRangeTheme({ startId, endId });
+
+  const formatWeekday = useCallback(
+    (date: Date) => formatFlashCalendarWeekdayShort(date, locale),
+    [locale],
+  );
+
+  const activeRanges = useMemo(() => {
+    if (startId && endId) {
+      return [{ startId, endId }];
+    }
+    if (startId) {
+      return [{ startId, endId: startId }];
+    }
+    return [];
+  }, [endId, startId]);
+
+  const handleDayPress = useCallback(
+    (dateId: string) => {
+      if (!disabled) {
+        onDayPress(toCalendarDateId(dateId));
+      }
+    },
+    [disabled, onDayPress],
+  );
+
+  return (
+    <View ref={ref} className={className} style={style} {...props}>
+      <FlashCalendar
+        calendarInstanceId={instanceId}
+        calendarMonthId={monthId}
+        calendarActiveDateRanges={activeRanges}
+        calendarMinDateId={minValue}
+        calendarMaxDateId={maxValue}
+        calendarMonthHeaderHeight={0}
+        calendarDayHeight={FLASH_CALENDAR_DAY_HEIGHT}
+        calendarWeekHeaderHeight={28}
+        calendarRowVerticalSpacing={4}
+        calendarRowHorizontalSpacing={FLASH_CALENDAR_RANGE_DAY_SPACING}
+        getCalendarMonthFormat={() => ''}
+        getCalendarWeekDayFormat={formatWeekday}
+        onCalendarDayPress={handleDayPress}
+        theme={theme}
+      />
+    </View>
+  );
+});
+
+RangeCalendarGrid.displayName = 'RangeCalendar.Grid';
+
+type RangeCalendarCompound = typeof RangeCalendarRoot & {
+  Header: typeof RangeCalendarHeader;
+  Grid: typeof RangeCalendarGrid;
+  YearPicker: typeof RangeCalendarYearPicker;
+};
+
+export const RangeCalendar = Object.assign(RangeCalendarRoot, {
+  Header: RangeCalendarHeader,
+  Grid: RangeCalendarGrid,
+  YearPicker: RangeCalendarYearPicker,
+}) as RangeCalendarCompound;

package/src/components/ScopedTheme/index.tsx

@@ -0,0 +1,17 @@
+import type { ComponentProps } from 'react';
+import { ScopedTheme as UniwindScopedTheme } from 'uniwind';
+
+export type ScopedThemeProps = ComponentProps<typeof UniwindScopedTheme>;
+
+/**
+ * Forces a specific theme on a component subtree, regardless of the application's
+ * global theme. Useful for marketing heroes, embedded widgets, or preview surfaces
+ * that must render in a fixed mode.
+ *
+ * Wraps Uniwind's `ScopedTheme` to keep `uniwind` an internal implementation detail.
+ *
+ * Web requires `@custom-variant dark (&:where(.dark, .dark *));` in the consuming
+ * app's `global.css`. See the Storybook story (`Theming/ScopedTheme`) for the full
+ * mechanism, light-vs-dark asymmetry, and dynamic-switch caveat.
+ */
+export const ScopedTheme = (props: ScopedThemeProps) => <UniwindScopedTheme {...props} />;

package/src/components/ScrollShadow/index.tsx

@@ -0,0 +1,119 @@
+import { Children, cloneElement, isValidElement, type ReactNode } from 'react';
+import { StyleSheet, View, type ViewStyle } from 'react-native';
+import { cn } from '@cdx-ui/utils';
+import {
+  scrollShadowContainerVariants,
+  scrollShadowOverlayVariants,
+  scrollShadowVariants,
+  type ScrollShadowVariantProps,
+} from './styles';
+import { useScrollShadow, type ScrollShadowCapability } from './useScrollShadow';
+
+export type { ScrollShadowCapability };
+
+export interface ScrollShadowProps extends ScrollShadowVariantProps {
+  children: ReactNode;
+  className?: string;
+  /**
+   * Tailwind `from-*` utility for edge overlays — match the surface behind the scroll area.
+   * Pair with a low opacity (e.g. `from-surface-secondary/40`) for a light fade.
+   * @default 'from-background/35'
+   */
+  fadeFromClassName?: string;
+  /**
+   * Shadow fade size in pixels.
+   * @default 64
+   */
+  size?: number;
+  /**
+   * Scroll offset before showing edge shadows.
+   * @default 0
+   */
+  offset?: number;
+  onCapabilityChange?: (capability: ScrollShadowCapability) => void;
+  style?: ViewStyle;
+}
+
+interface ScrollShadowChildProps {
+  className?: string;
+  style?: ViewStyle;
+  onLayout?: (event: Parameters<ReturnType<typeof useScrollShadow>['handleLayout']>[0]) => void;
+  onContentSizeChange?: (width: number, height: number) => void;
+  onScroll?: (event: Parameters<ReturnType<typeof useScrollShadow>['handleScroll']>[0]) => void;
+  ref?: React.Ref<unknown>;
+}
+
+export function ScrollShadow({
+  children,
+  className,
+  fadeFromClassName = 'from-background/35',
+  hideScrollBar = false,
+  orientation = 'horizontal',
+  offset = 0,
+  onCapabilityChange,
+  size = 64,
+  style,
+}: ScrollShadowProps) {
+  const resolvedOrientation = orientation ?? 'horizontal';
+  const child = Children.only(children);
+
+  if (!isValidElement<ScrollShadowChildProps>(child)) {
+    throw new Error('ScrollShadow expects a single React element child.');
+  }
+
+  const { capability, handleContentSizeChange, handleLayout, handleScroll } = useScrollShadow({
+    offset,
+    onCapabilityChange,
+    orientation: resolvedOrientation,
+  });
+
+  const overlayFade = cn(fadeFromClassName, 'to-transparent');
+  const overlayAxisSize = resolvedOrientation === 'horizontal' ? { width: size } : { height: size };
+
+  return (
+    <View className={cn(scrollShadowContainerVariants(), className)} style={style}>
+      {cloneElement(child, {
+        className: cn(scrollShadowVariants({ hideScrollBar }), child.props.className),
+        onContentSizeChange: (width: number, height: number) => {
+          handleContentSizeChange(width, height);
+          child.props.onContentSizeChange?.(width, height);
+        },
+        onLayout: (event) => {
+          handleLayout(event);
+          child.props.onLayout?.(event);
+        },
+        onScroll: (event) => {
+          handleScroll(event);
+          child.props.onScroll?.(event);
+        },
+        style: StyleSheet.flatten([child.props.style]),
+      })}
+      {capability.canScrollBefore ? (
+        <View
+          pointerEvents="none"
+          className={cn(
+            scrollShadowOverlayVariants({
+              orientation: resolvedOrientation,
+              edge: 'start',
+            }),
+            overlayFade,
+          )}
+          style={overlayAxisSize}
+        />
+      ) : null}
+      {capability.canScrollAfter ? (
+        <View
+          pointerEvents="none"
+          className={cn(
+            scrollShadowOverlayVariants({
+              orientation: resolvedOrientation,
+              edge: 'end',
+            }),
+            overlayFade,
+          )}
+          style={overlayAxisSize}
+        />
+      ) : null}
+    </View>
+  );
+}

package/src/components/ScrollShadow/styles.ts

@@ -0,0 +1,57 @@
+import { cva, type VariantProps } from '@cdx-ui/utils';
+
+export const scrollShadowVariants = cva([], {
+  variants: {
+    orientation: {
+      horizontal: '',
+      vertical: '',
+    },
+    hideScrollBar: {
+      true: 'web:[scrollbar-width:none] web:[&::-webkit-scrollbar]:hidden',
+      false: '',
+    },
+  },
+  defaultVariants: {
+    orientation: 'horizontal',
+    hideScrollBar: false,
+  },
+});
+
+export const scrollShadowContainerVariants = cva('relative min-w-0 w-full');
+
+export const scrollShadowOverlayVariants = cva('pointer-events-none absolute z-10', {
+  variants: {
+    orientation: {
+      horizontal: '',
+      vertical: '',
+    },
+    edge: {
+      start: '',
+      end: '',
+    },
+  },
+  compoundVariants: [
+    {
+      orientation: 'horizontal',
+      edge: 'start',
+      className: 'left-0 top-0 bottom-0 bg-gradient-to-r',
+    },
+    {
+      orientation: 'horizontal',
+      edge: 'end',
+      className: 'right-0 top-0 bottom-0 bg-gradient-to-l',
+    },
+    {
+      orientation: 'vertical',
+      edge: 'start',
+      className: 'left-0 right-0 top-0 bg-gradient-to-b',
+    },
+    {
+      orientation: 'vertical',
+      edge: 'end',
+      className: 'left-0 right-0 bottom-0 bg-gradient-to-t',
+    },
+  ],
+});
+
+export type ScrollShadowVariantProps = VariantProps<typeof scrollShadowVariants>;

package/src/components/ScrollShadow/useScrollShadow.ts

@@ -0,0 +1,110 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import type { LayoutChangeEvent, NativeScrollEvent, NativeSyntheticEvent } from 'react-native';
+
+export interface ScrollShadowCapability {
+  canScrollBefore: boolean;
+  canScrollAfter: boolean;
+}
+
+export interface UseScrollShadowOptions {
+  orientation?: 'horizontal' | 'vertical';
+  offset?: number;
+  onCapabilityChange?: (capability: ScrollShadowCapability) => void;
+}
+
+interface ScrollMetrics {
+  scrollOffset: number;
+  viewportSize: number;
+  contentSize: number;
+}
+
+const INITIAL_METRICS: ScrollMetrics = {
+  scrollOffset: 0,
+  viewportSize: 0,
+  contentSize: 0,
+};
+
+function getScrollCapability(metrics: ScrollMetrics, offset: number): ScrollShadowCapability {
+  const { scrollOffset, viewportSize, contentSize } = metrics;
+
+  if (viewportSize <= 0 || contentSize <= viewportSize) {
+    return { canScrollBefore: false, canScrollAfter: false };
+  }
+
+  return {
+    canScrollBefore: scrollOffset > offset,
+    canScrollAfter: scrollOffset + viewportSize + offset < contentSize,
+  };
+}
+
+export function useScrollShadow({
+  orientation = 'horizontal',
+  offset = 0,
+  onCapabilityChange,
+}: UseScrollShadowOptions = {}) {
+  const metricsRef = useRef<ScrollMetrics>(INITIAL_METRICS);
+  const [capability, setCapability] = useState<ScrollShadowCapability>({
+    canScrollBefore: false,
+    canScrollAfter: false,
+  });
+
+  const updateCapability = useCallback(() => {
+    const nextCapability = getScrollCapability(metricsRef.current, offset);
+
+    setCapability((prev) => {
+      if (
+        prev.canScrollBefore === nextCapability.canScrollBefore &&
+        prev.canScrollAfter === nextCapability.canScrollAfter
+      ) {
+        return prev;
+      }
+
+      onCapabilityChange?.(nextCapability);
+      return nextCapability;
+    });
+  }, [offset, onCapabilityChange]);
+
+  useEffect(() => {
+    updateCapability();
+  }, [updateCapability]);
+
+  const handleLayout = useCallback(
+    (event: LayoutChangeEvent) => {
+      const { width, height } = event.nativeEvent.layout;
+      metricsRef.current.viewportSize = orientation === 'vertical' ? height : width;
+      updateCapability();
+    },
+    [orientation, updateCapability],
+  );
+
+  const handleContentSizeChange = useCallback(
+    (width: number, height: number) => {
+      metricsRef.current.contentSize = orientation === 'vertical' ? height : width;
+      updateCapability();
+    },
+    [orientation, updateCapability],
+  );
+
+  const handleScroll = useCallback(
+    (event: NativeSyntheticEvent<NativeScrollEvent>) => {
+      const { contentOffset, layoutMeasurement, contentSize } = event.nativeEvent;
+
+      metricsRef.current.scrollOffset =
+        orientation === 'vertical' ? contentOffset.y : contentOffset.x;
+      metricsRef.current.viewportSize =
+        orientation === 'vertical' ? layoutMeasurement.height : layoutMeasurement.width;
+      metricsRef.current.contentSize =
+        orientation === 'vertical' ? contentSize.height : contentSize.width;
+
+      updateCapability();
+    },
+    [orientation, updateCapability],
+  );
+
+  return {
+    capability,
+    handleLayout,
+    handleContentSizeChange,
+    handleScroll,
+  };
+}