paris 0.17.7 → 0.17.9

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # paris
 
+## 0.17.9
+
+### Patch Changes
+
+- 7d24348: fix(tilt): Replace react-parallax-tilt with a custom functional component to fix TypeError crash during React 19 concurrent rendering unmount
+
+## 0.17.8
+
+### Patch Changes
+
+- 0ca30b7: fix(drawer): make bottom panel spacer padding conditional on bottomPanelPadding prop
+  fix(accordionselect): add padding to check icon for better tap target
+  feat(combobox): add customValueOption override for independent styling
+
 ## 0.17.7
 
 ### Patch Changes

package/package.json

@@ -2,7 +2,7 @@
   "name": "paris",
   "author": "Sanil Chawla <sanil@slingshot.fm> (https://sanil.co)",
   "description": "Paris is Slingshot's React design system. It's a collection of reusable components, design tokens, and guidelines that help us build consistent, accessible, and performant user interfaces.",
-  "version": "0.17.7",
+  "version": "0.17.9",
   "homepage": "https://paris.slingshot.fm",
   "license": "MIT",
   "repository": {
@@ -77,7 +77,6 @@
     "framer-motion": "^12.24.10",
     "pte": "^0.5.0",
     "react-hot-toast": "^2.4.1",
-    "react-parallax-tilt": "^1.7.315",
     "react-tiny-popover": "^8.1.6",
     "ts-deepmerge": "^6.0.3"
   },

package/src/stories/accordionselect/AccordionSelect.module.scss

@@ -94,6 +94,10 @@
             background: transparent;
         }
     }
+
+    .check {
+        padding: 4px;
+    }
 }
 
 .optionContent {

package/src/stories/accordionselect/AccordionSelect.tsx

@@ -136,7 +136,7 @@ export const AccordionSelect: FC<AccordionSelectProps> = ({
 
     useEffect(() => {
         if (!closeOnClickOutside || !open) {
-            return () => {};
+            return () => { };
         }
 
         const handleClickOutside = (e: MouseEvent) => {
@@ -253,7 +253,7 @@ export const AccordionSelect: FC<AccordionSelectProps> = ({
                                                 )}
                                         </div>
                                         {isOptionSelected && (
-                                            <Icon icon={Check} size={13} />
+                                            <Icon icon={Check} size={13} className={styles.check} />
                                         )}
                                     </button>
                                 );

package/src/stories/combobox/Combobox.stories.ts

@@ -164,6 +164,47 @@ export const AllowCustomValue: Story = {
     },
 };
 
+export const CustomValueWithDivider: Story = {
+    args: {
+        ...ComboboxArgs,
+        allowCustomValue: true,
+        customValueString: 'Add "%v"',
+    },
+    render: function Render(args) {
+        const [selected, setSelected] = useState<Option | null>(null);
+        const [inputValue, setInputValue] = useState<string>('');
+        return createElement(
+            'div',
+            {
+                style: { minHeight: '200px' },
+            },
+            createElement(Combobox<{ name: string }>, {
+                ...args,
+                value:
+          selected?.id === null
+              ? {
+                  id: null,
+                  node: inputValue,
+                  metadata: {
+                      name: inputValue,
+                  },
+              }
+              : (selected as Option<{ name: string }> | null),
+                options: (args.options as Option<{ name: string }>[]).filter((o) => ((o.metadata?.name as string) || '')
+                    .toLowerCase()
+                    .includes(inputValue.toLowerCase())),
+                onChange: (e) => setSelected(e),
+                onInputChange: (e) => setInputValue(e),
+                overrides: {
+                    customValueOption: {
+                        style: { borderBottom: '5px solid var(--pte-new-colors-borderMedium)' },
+                    },
+                },
+            }),
+        );
+    },
+};
+
 export const HideOptionsInitially: Story = {
     args: ComboboxArgs,
     render: function Render(args) {

package/src/stories/combobox/Combobox.tsx

@@ -113,6 +113,7 @@ export type ComboboxProps<T extends Record<string, any>> = {
         input?: ComponentPropsWithoutRef<'input'>;
         optionsContainer?: ComponentPropsWithoutRef<'ul'>;
         option?: ComponentPropsWithoutRef<'li'>;
+        customValueOption?: ComponentPropsWithoutRef<'li'>;
         label?: TextProps<'label'>;
         description?: TextProps<'p'>;
         startEnhancerContainer?: ComponentPropsWithoutRef<'div'>;
@@ -249,11 +250,6 @@ export function Combobox<T extends Record<string, any> = Record<string, any>>({
                                         });
                                     }
                                 }}
-                                onBlur={(e) => {
-                                    setQuery('');
-                                    if (onInputChange) onInputChange('');
-                                    if (overrides?.input?.onBlur) overrides.input.onBlur(e);
-                                }}
                                 aria-disabled={disabled}
                                 data-status={disabled ? 'disabled' : (status || 'default')}
                                 className={clsx(
@@ -324,10 +320,10 @@ export function Combobox<T extends Record<string, any> = Record<string, any>>({
                                 value={query}
                                 data-selected={false}
                                 className={clsx(
-                                    overrides?.option?.className,
+                                    overrides?.customValueOption?.className,
                                     styles.option,
                                 )}
-                                {...overrides?.option}
+                                {...overrides?.customValueOption}
                             >
                                 <Text as="span" kind="paragraphSmall">
                                     {customValueString.replace('%v', query)}

package/src/stories/drawer/Drawer.module.scss

@@ -423,6 +423,11 @@ $panelAnimationDelay: var(--pte-animations-duration-fast);
 
 .bottomPanelSpacer {
     padding: 20px;
+
+    &.noPadding {
+        padding: 0;
+    }
+
     opacity: 0;
     pointer-events: none;
 }

package/src/stories/drawer/Drawer.tsx

@@ -150,7 +150,7 @@ export type DrawerProps<T extends string[] | readonly string[] = string[]> = {
 */
 export const Drawer = <T extends string[] | readonly string[] = string[]>({
     isOpen = false,
-    onClose = () => {},
+    onClose = () => { },
     title,
     hideTitle = false,
     hideCloseButton = false,
@@ -383,7 +383,7 @@ export const Drawer = <T extends string[] | readonly string[] = string[]>({
                                 </div>
                                 {bottomPanel && (
                                     <>
-                                        <div tabIndex={-1} aria-hidden="true" className={clsx(styles.bottomPanelSpacer, overrides?.bottomPanelSpacer?.className)}>
+                                        <div tabIndex={-1} aria-hidden="true" className={clsx(styles.bottomPanelSpacer, { [styles.noPadding]: !bottomPanelPadding }, overrides?.bottomPanelSpacer?.className)}>
                                             {bottomPanel}
                                         </div>
                                         <div className={clsx(styles.bottomPanel, overrides?.bottomPanel?.className)}>

package/src/stories/tilt/Tilt.module.scss

@@ -1 +1,22 @@
-.container {}
+.container {
+    position: relative;
+}
+
+.glareWrapper {
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    overflow: hidden;
+    -webkit-mask-image: -webkit-radial-gradient(white, black);
+    pointer-events: none;
+}
+
+.glare {
+    position: absolute;
+    top: 50%;
+    left: 50%;
+    transform-origin: 0% 0%;
+    pointer-events: none;
+}

package/src/stories/tilt/Tilt.tsx

@@ -1,26 +1,116 @@
 'use client';
 
-import type { FC, ReactNode } from 'react';
-import RPTilt from 'react-parallax-tilt';
+import {
+    useCallback,
+    useEffect,
+    useRef,
+    useState,
+} from 'react';
+import type {
+    CSSProperties,
+    FC,
+    MouseEvent as ReactMouseEvent,
+    ReactNode,
+    TouchEvent as ReactTouchEvent,
+} from 'react';
+import { clsx } from 'clsx';
 import styles from './Tilt.module.scss';
 
+type GlarePosition = 'top' | 'right' | 'bottom' | 'left' | 'all';
+
+export type OnMoveParams = {
+    tiltAngleX: number;
+    tiltAngleY: number;
+    tiltAngleXPercentage: number;
+    tiltAngleYPercentage: number;
+    glareAngle: number;
+    glareOpacity: number;
+};
+
 export type TiltProps = {
-    /**
-     * Disables the tilt effect.
-     * @default false
-     */
+    /** Disables the tilt effect. @default false */
     disableTilt?: boolean;
-    /** The contents of the Tilt. */
     children?: ReactNode | ReactNode[];
-    /** The class names to apply to this element. */
     className?: string;
-} & RPTilt['props'];
+    style?: CSSProperties;
+    /** Scale on hover (1.05 = 105%). @default 1.05 */
+    scale?: number;
+    /** Max tilt on X axis in degrees. @default 12.5 */
+    tiltMaxAngleX?: number;
+    /** Max tilt on Y axis in degrees. @default 12.5 */
+    tiltMaxAngleY?: number;
+    /** Manual tilt on X axis in degrees. Overrides mouse input when non-null. */
+    tiltAngleXManual?: number | null;
+    /** Manual tilt on Y axis in degrees. Overrides mouse input when non-null. */
+    tiltAngleYManual?: number | null;
+    /** CSS perspective distance in px. @default 1000 */
+    perspective?: number;
+    /** Transition speed in ms for enter/leave. @default 400 */
+    transitionSpeed?: number;
+    /** Transition easing function. @default 'cubic-bezier(.03,.98,.52,.99)' */
+    transitionEasing?: string;
+    /** Reset tilt on mouse leave. @default true */
+    reset?: boolean;
+    /** Enable glare overlay. @default true */
+    glareEnable?: boolean;
+    /** Max glare opacity (0-1). @default 0.5 */
+    glareMaxOpacity?: number;
+    /** Glare gradient color. @default '#ffffff' */
+    glareColor?: string;
+    /** Glare gradient origin position. @default 'bottom' */
+    glarePosition?: GlarePosition;
+    /** Reverse glare direction. @default false */
+    glareReverse?: boolean;
+    /** CSS border-radius for glare wrapper. Derived from style.borderRadius by default. */
+    glareBorderRadius?: string;
+    onEnter?: (params: { event: ReactMouseEvent | ReactTouchEvent }) => void;
+    onLeave?: (params: { event: ReactMouseEvent | ReactTouchEvent }) => void;
+    onMove?: (params: OnMoveParams) => void;
+};
+
+type TiltState = {
+    tiltAngleX: number;
+    tiltAngleY: number;
+    currentScale: number;
+    glareAngle: number;
+    glareOpacity: number;
+    transitioning: boolean;
+};
+
+const INITIAL_STATE: TiltState = {
+    tiltAngleX: 0,
+    tiltAngleY: 0,
+    currentScale: 1,
+    glareAngle: 0,
+    glareOpacity: 0,
+    transitioning: false,
+};
+
+const clamp = (value: number, min: number, max: number) => Math.min(Math.max(value, min), max);
+
+function computeGlareOpacity(
+    xPct: number,
+    yPct: number,
+    position: GlarePosition,
+    reverse: boolean,
+    maxOpacity: number,
+): number {
+    const g = reverse ? -1 : 1;
+    let raw = 0;
+    switch (position) {
+        case 'top': raw = -xPct * g; break;
+        case 'right': raw = yPct * g; break;
+        case 'left': raw = -yPct * g; break;
+        case 'all': raw = Math.hypot(xPct, yPct); break;
+        case 'bottom':
+        default: raw = xPct * g; break;
+    }
+    return clamp(raw, 0, 100) * maxOpacity / 100;
+}
 
 /**
  * Tilt components allow you to add a parallax tilt effect to any component.
  *
- * Based on [react-parallax-tilt](https://github.com/mkosir/react-parallax-tilt), customized with our preferred defaults.
- *
  * > Card components include a Tilt component by default, by setting the `tilt` prop to `true`. You can override any of the underlying Tilt props by passing them to the Card component's `overrides.tilt` prop.
  *
  * <hr />
@@ -37,29 +127,215 @@ export const Tilt: FC<TiltProps> = ({
     scale = 1.05,
     tiltMaxAngleX = 12.5,
     tiltMaxAngleY = 12.5,
-    glareEnable = true,
-    glareMaxOpacity = 0.5,
-    style = {},
     tiltAngleXManual = null,
     tiltAngleYManual = null,
     perspective = 1000,
+    transitionSpeed = 400,
+    transitionEasing = 'cubic-bezier(.03,.98,.52,.99)',
+    reset = true,
+    glareEnable = true,
+    glareMaxOpacity = 0.5,
+    glareColor = '#ffffff',
+    glarePosition = 'bottom',
+    glareReverse = false,
+    glareBorderRadius,
+    style = {},
+    className,
     children,
-    ...props
-}) => (
-    <RPTilt
-        scale={disableTilt ? 1 : scale}
-        tiltMaxAngleX={disableTilt ? 0 : tiltMaxAngleX}
-        tiltMaxAngleY={disableTilt ? 0 : tiltMaxAngleY}
-        glareEnable={!disableTilt && glareEnable}
-        glareMaxOpacity={disableTilt ? 0 : glareMaxOpacity}
-        style={style}
-        glareBorderRadius={`calc(${style?.borderRadius || '1px'} - 1px)`}
-        tiltAngleXManual={disableTilt ? 0 : tiltAngleXManual}
-        tiltAngleYManual={disableTilt ? 0 : tiltAngleYManual}
-        perspective={perspective}
-        {...props}
-        className={`${styles.container} ${props.className}`}
-    >
-        {children}
-    </RPTilt>
-);
+    onEnter,
+    onLeave,
+    onMove,
+}) => {
+    const containerRef = useRef<HTMLDivElement>(null);
+    const rafID = useRef<number | null>(null);
+    const rectRef = useRef<DOMRect | null>(null);
+    const pendingRef = useRef<TiltState | null>(null);
+
+    const [tilt, setTilt] = useState<TiltState>(INITIAL_STATE);
+
+    const effectiveScale = disableTilt ? 1 : scale;
+    const effectiveMaxX = disableTilt ? 0 : tiltMaxAngleX;
+    const effectiveMaxY = disableTilt ? 0 : tiltMaxAngleY;
+    const effectiveGlare = !disableTilt && glareEnable;
+    const effectiveGlareMax = disableTilt ? 0 : glareMaxOpacity;
+    const effectiveManualX = disableTilt ? 0 : tiltAngleXManual;
+    const effectiveManualY = disableTilt ? 0 : tiltAngleYManual;
+
+    const computedGlareBorderRadius = glareBorderRadius ?? `calc(${style?.borderRadius || '1px'} - 1px)`;
+    const isManual = effectiveManualX !== null || effectiveManualY !== null;
+
+    // Cancel any pending rAF on unmount
+    useEffect(() => () => {
+        if (rafID.current !== null) cancelAnimationFrame(rafID.current);
+    }, []);
+
+    const flushToState = useCallback(() => {
+        if (!pendingRef.current) return;
+        const next = pendingRef.current;
+        pendingRef.current = null;
+        setTilt(next);
+    }, []);
+
+    const scheduleUpdate = useCallback((next: TiltState) => {
+        pendingRef.current = next;
+        if (rafID.current !== null) cancelAnimationFrame(rafID.current);
+        rafID.current = requestAnimationFrame(flushToState);
+    }, [flushToState]);
+
+    const computeTilt = useCallback((pageX: number, pageY: number): TiltState => {
+        const rect = rectRef.current;
+        if (!rect) return { ...INITIAL_STATE, currentScale: effectiveScale };
+
+        const xPct = clamp(((pageX - rect.left) / rect.width) * 200 - 100, -100, 100);
+        const yPct = clamp(((pageY - rect.top) / rect.height) * 200 - 100, -100, 100);
+
+        const angleX = (effectiveManualX !== null) ? effectiveManualX : (yPct * effectiveMaxX / 100);
+        const angleY = (effectiveManualY !== null) ? effectiveManualY : (xPct * effectiveMaxY / 100 * -1);
+
+        const glareAngle = xPct ? Math.atan2(yPct, -xPct) * (180 / Math.PI) : 0;
+        const glareOpacity = effectiveGlare
+            ? computeGlareOpacity(xPct, yPct, glarePosition, glareReverse, effectiveGlareMax)
+            : 0;
+
+        return {
+            tiltAngleX: clamp(angleX, -90, 90),
+            tiltAngleY: clamp(angleY, -90, 90),
+            currentScale: effectiveScale,
+            glareAngle,
+            glareOpacity,
+            transitioning: false,
+        };
+    }, [effectiveScale, effectiveMaxX, effectiveMaxY, effectiveManualX, effectiveManualY, effectiveGlare, effectiveGlareMax, glarePosition, glareReverse]);
+
+    const handleMouseEnter = useCallback((e: ReactMouseEvent<HTMLDivElement>) => {
+        if (!containerRef.current) return;
+        rectRef.current = containerRef.current.getBoundingClientRect();
+
+        const next = computeTilt(e.pageX, e.pageY);
+        setTilt({ ...next, transitioning: true });
+        onEnter?.({ event: e });
+    }, [computeTilt, onEnter]);
+
+    const handleMouseMove = useCallback((e: ReactMouseEvent<HTMLDivElement>) => {
+        if (!containerRef.current || !rectRef.current) return;
+        if (effectiveManualX !== null || effectiveManualY !== null) return;
+
+        const next = computeTilt(e.pageX, e.pageY);
+        scheduleUpdate(next);
+
+        if (onMove) {
+            onMove({
+                tiltAngleX: next.tiltAngleX,
+                tiltAngleY: next.tiltAngleY,
+                tiltAngleXPercentage: effectiveMaxX ? (next.tiltAngleX / effectiveMaxX) * 100 : 0,
+                tiltAngleYPercentage: effectiveMaxY ? (next.tiltAngleY / effectiveMaxY) * 100 : 0,
+                glareAngle: next.glareAngle,
+                glareOpacity: next.glareOpacity,
+            });
+        }
+    }, [computeTilt, scheduleUpdate, onMove, effectiveManualX, effectiveManualY, effectiveMaxX, effectiveMaxY]);
+
+    const handleMouseLeave = useCallback((e: ReactMouseEvent<HTMLDivElement>) => {
+        if (!containerRef.current) return;
+        rectRef.current = null;
+
+        if (reset) {
+            setTilt({ ...INITIAL_STATE, transitioning: true });
+        }
+        onLeave?.({ event: e });
+    }, [reset, onLeave]);
+
+    const handleTouchStart = useCallback((e: ReactTouchEvent<HTMLDivElement>) => {
+        if (!containerRef.current || !e.touches[0]) return;
+        rectRef.current = containerRef.current.getBoundingClientRect();
+
+        const touch = e.touches[0];
+        const next = computeTilt(touch.pageX, touch.pageY);
+        setTilt({ ...next, transitioning: true });
+        onEnter?.({ event: e });
+    }, [computeTilt, onEnter]);
+
+    const handleTouchMove = useCallback((e: ReactTouchEvent<HTMLDivElement>) => {
+        if (!containerRef.current || !rectRef.current || !e.touches[0]) return;
+        if (effectiveManualX !== null || effectiveManualY !== null) return;
+
+        const touch = e.touches[0];
+        const next = computeTilt(touch.pageX, touch.pageY);
+        scheduleUpdate(next);
+    }, [computeTilt, scheduleUpdate, effectiveManualX, effectiveManualY]);
+
+    const handleTouchEnd = useCallback((e: ReactTouchEvent<HTMLDivElement>) => {
+        if (!containerRef.current) return;
+        rectRef.current = null;
+
+        if (reset) {
+            setTilt({ ...INITIAL_STATE, transitioning: true });
+        }
+        onLeave?.({ event: e });
+    }, [reset, onLeave]);
+
+    // Compute glare element size (diagonal of container)
+    const [glareSize, setGlareSize] = useState(0);
+    useEffect(() => {
+        if (!effectiveGlare || !containerRef.current) {
+            return undefined;
+        }
+        const el = containerRef.current;
+        const observer = new ResizeObserver(([entry]) => {
+            if (!entry) return;
+            const { width, height } = entry.contentRect;
+            setGlareSize(Math.sqrt(width ** 2 + height ** 2));
+        });
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, [effectiveGlare]);
+
+    // Apply manual angle overrides at render time
+    const finalAngleX = isManual ? (effectiveManualX ?? 0) : tilt.tiltAngleX;
+    const finalAngleY = isManual ? (effectiveManualY ?? 0) : tilt.tiltAngleY;
+    const finalScale = tilt.currentScale;
+
+    const transform = `perspective(${perspective}px) rotateX(${finalAngleX}deg) rotateY(${finalAngleY}deg) scale3d(${finalScale},${finalScale},${finalScale})`;
+
+    const transition = tilt.transitioning || isManual
+        ? `transform ${transitionSpeed}ms ${transitionEasing}`
+        : undefined;
+
+    return (
+        <div
+            ref={containerRef}
+            onMouseEnter={handleMouseEnter}
+            onMouseMove={handleMouseMove}
+            onMouseLeave={handleMouseLeave}
+            onTouchStart={handleTouchStart}
+            onTouchMove={handleTouchMove}
+            onTouchEnd={handleTouchEnd}
+            className={clsx(styles.container, className)}
+            style={{
+                ...style,
+                transform,
+                transition,
+                willChange: tilt.transitioning || finalScale !== 1 || finalAngleX !== 0 || finalAngleY !== 0 ? 'transform' : undefined,
+            }}
+        >
+            {children}
+            {effectiveGlare && (
+                <div
+                    className={styles.glareWrapper}
+                    style={{ borderRadius: computedGlareBorderRadius }}
+                >
+                    <div
+                        className={styles.glare}
+                        style={{
+                            width: glareSize,
+                            height: glareSize,
+                            transform: `rotate(${tilt.glareAngle}deg) translate(-50%, -50%)`,
+                            opacity: tilt.glareOpacity,
+                            background: `linear-gradient(0deg, rgba(255,255,255,0) 0%, ${glareColor} 100%)`,
+                        }}
+                    />
+                </div>
+            )}
+        </div>
+    );
+};