npm - @oxyhq/bloom - Versions diffs - 0.15.0 → 0.16.0 - Mend

@oxyhq/bloom 0.15.0 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (188) hide show

package/src/dialog/CenteredDialog.web.tsx DELETED Viewed

@@ -1,374 +0,0 @@
-import React, { useEffect, useMemo, useState } from 'react';
-import { Pressable, ScrollView, StyleSheet, View, type ViewStyle } from 'react-native';
-import { RemoveScrollBar } from 'react-remove-scroll-bar';
-import { useInteractionStates } from '../hooks/useInteractionState';
-import { TimesLarge_Stroke2_Corner0_Rounded as CloseIcon } from '../icons/Times';
-import { Portal } from '../portal/index.web';
-import { createOverlayZIndex } from '../styles/z-index';
-import { useTheme } from '../theme/use-theme';
-import { Text } from '../typography';
-import type { CenteredDialogProps } from './centered-dialog-types';
-import {
-  CARD_RADIUS,
-  DEFAULT_MAX_WIDTH,
-  MAX_HEIGHT_FRACTION,
-  resolveSpacing,
-  VIEWPORT_GUTTER,
-} from './centered-dialog-tokens';
-const FADE_OUT_DURATION = 150;
-const CLOSE_HIT_SLOP = { top: 8, bottom: 8, left: 8, right: 8 } as const;
-const dialogZIndex = createOverlayZIndex();
-/** Stable testID for the dimmed backdrop. Overridden when a `testID` is set. */
-export const CENTERED_DIALOG_BACKDROP_TESTID = 'bloom-centered-dialog-backdrop';
-const stopPropagation = (e: { stopPropagation: () => void }) => e.stopPropagation();
-/**
- * @deprecated Use `<Dialog placement="center">` instead.
- *
- * Web variant of `<CenteredDialog>`.
- *
- * A centered modal card rendered into the Bloom Portal at the end of
- * `document.body`. Identical prop surface to native — `visible`, `onClose`,
- * `title`, `compact`, etc. — so call sites are platform agnostic.
- *
- * Differences from the native fork (necessary, not behavioural):
- *   - Portal + `RemoveScrollBar` lock the underlying page while open.
- *   - `Escape` dismisses (when `dismissible`).
- *   - A `role="dialog"` panel with `aria-label`/`aria-modal` for a11y.
- *   - A CSS fade/zoom keyframe matches the native modal's `fade` animation;
- *     the keyframes are injected once (idempotent) into `<head>`.
- *
- * The backdrop is a sibling element BEHIND the card, and the card stops
- * click/press propagation so a tap on the card never dismisses.
- */
-export function CenteredDialog({
-  visible,
-  onClose,
-  title,
-  dismissible = true,
-  maxWidth = DEFAULT_MAX_WIDTH,
-  compact = true,
-  showClose,
-  children,
-  footer,
-  accessibilityLabel,
-  closeAccessibilityLabel = 'Close dialog',
-  backdropAccessibilityLabel = 'Dismiss dialog',
-  cardStyle,
-  contentStyle,
-  testID,
-}: CenteredDialogProps) {
-  const theme = useTheme();
-  // `rendered` keeps the dialog mounted through its fade-out so a controlled
-  // `visible` flip to `false` still plays an exit animation (matching the
-  // native `Modal animationType="fade"`, which animates both directions).
-  const [rendered, setRendered] = useState(visible);
-  const isClosing = rendered && !visible;
-  useKeyframes();
-  // Mount immediately when opened; defer unmount until the exit animation
-  // has played when closed.
-  useEffect(() => {
-    if (visible) {
-      setRendered(true);
-      return;
-    }
-    if (!rendered) return;
-    const timer = setTimeout(() => setRendered(false), FADE_OUT_DURATION);
-    return () => clearTimeout(timer);
-  }, [visible, rendered]);
-  // Escape-to-close while open. Scoped to the open lifetime so stacked
-  // dialogs don't fight for the keydown — the top-most one wins via
-  // document-level event order.
-  useEffect(() => {
-    if (!visible || !dismissible || typeof document === 'undefined') return;
-    const handler = (e: KeyboardEvent) => {
-      if (e.key === 'Escape') {
-        e.stopPropagation();
-        onClose();
-      }
-    };
-    document.addEventListener('keydown', handler);
-    return () => document.removeEventListener('keydown', handler);
-  }, [visible, dismissible, onClose]);
-  const spacing = useMemo(() => resolveSpacing(compact), [compact]);
-  const resolvedShowClose = showClose ?? Boolean(title);
-  const hasHeader = Boolean(title) || resolvedShowClose;
-  if (!rendered) return null;
-  // While closing, the backdrop must not re-trigger onClose (it's mid-exit).
-  const handleBackdropPress = dismissible && !isClosing ? onClose : undefined;
-  return (
-    <Portal>
-      <RemoveScrollBar />
-      {/* `pointerEvents: 'auto'` opts back in from the Portal root's
-          `pointer-events: none` (set so the idle portal doesn't intercept
-          clicks on the underlying app). */}
-      <View style={[styles.root, { padding: VIEWPORT_GUTTER }]}>
-        <Pressable
-          testID={testID ? `${testID}-backdrop` : CENTERED_DIALOG_BACKDROP_TESTID}
-          onPress={handleBackdropPress}
-          disabled={!dismissible}
-          accessibilityRole="button"
-          accessibilityLabel={backdropAccessibilityLabel}
-          style={[
-            styles.backdrop,
-            { backgroundColor: theme.colors.overlay },
-            backdropAnimation(isClosing),
-          ]}
-        />
-        <View
-          testID={testID}
-          role="dialog"
-          aria-modal
-          aria-label={accessibilityLabel ?? title}
-          onStartShouldSetResponder={returnsTrue}
-          onResponderRelease={stopPropagation}
-          {...({ onClick: stopPropagation } as Record<string, unknown>)}
-          style={[
-            styles.card,
-            {
-              maxWidth,
-              maxHeight: `${MAX_HEIGHT_FRACTION * 100}%`,
-              backgroundColor: theme.colors.card,
-              borderColor: theme.colors.border,
-              shadowColor: theme.colors.shadow,
-            },
-            cardAnimation(isClosing),
-            cardStyle,
-          ]}
-        >
-          {hasHeader ? (
-            <DialogHeader
-              title={title}
-              showClose={resolvedShowClose}
-              padding={spacing.pad}
-              gap={spacing.headerGap}
-              closeAccessibilityLabel={closeAccessibilityLabel}
-              onClose={onClose}
-            />
-          ) : null}
-          <ScrollView
-            style={styles.bodyScroll}
-            contentContainerStyle={[
-              {
-                padding: spacing.pad,
-                paddingTop: hasHeader ? spacing.headerGap : spacing.pad,
-                gap: spacing.contentGap,
-              },
-              contentStyle,
-            ]}
-            showsVerticalScrollIndicator={false}
-            keyboardShouldPersistTaps="handled"
-          >
-            {children}
-          </ScrollView>
-          {footer ? (
-            <View
-              style={[
-                styles.footer,
-                {
-                  padding: spacing.pad,
-                  paddingTop: spacing.footerGap,
-                  borderTopColor: theme.colors.borderLight,
-                },
-              ]}
-            >
-              {footer}
-            </View>
-          ) : null}
-        </View>
-      </View>
-    </Portal>
-  );
-}
-function DialogHeader({
-  title,
-  showClose,
-  padding,
-  gap,
-  closeAccessibilityLabel,
-  onClose,
-}: {
-  title?: string;
-  showClose: boolean;
-  padding: number;
-  gap: number;
-  closeAccessibilityLabel: string;
-  onClose: () => void;
-}) {
-  const theme = useTheme();
-  return (
-    <View
-      style={[
-        styles.header,
-        { paddingHorizontal: padding, paddingTop: padding, gap },
-      ]}
-    >
-      {title ? (
-        <Text
-          accessibilityRole="header"
-          numberOfLines={2}
-          style={[styles.title, { color: theme.colors.text }]}
-        >
-          {title}
-        </Text>
-      ) : (
-        <View style={styles.titleSpacer} />
-      )}
-      {showClose ? (
-        <CloseButton
-          accessibilityLabel={closeAccessibilityLabel}
-          onPress={onClose}
-        />
-      ) : null}
-    </View>
-  );
-}
-function CloseButton({
-  accessibilityLabel,
-  onPress,
-}: {
-  accessibilityLabel: string;
-  onPress: () => void;
-}) {
-  const theme = useTheme();
-  const { hovered, pressed, hoverHandlers, pressHandlers } = useInteractionStates();
-  return (
-    <Pressable
-      onPress={onPress}
-      {...hoverHandlers}
-      {...pressHandlers}
-      hitSlop={CLOSE_HIT_SLOP}
-      accessibilityRole="button"
-      accessibilityLabel={accessibilityLabel}
-      style={[
-        styles.closeButton,
-        { backgroundColor: theme.colors.contrast50 },
-        (hovered || pressed) && styles.closeButtonActive,
-      ]}
-    >
-      <CloseIcon size="sm" fill={theme.colors.textSecondary} />
-    </Pressable>
-  );
-}
-const returnsTrue = () => true;
-function backdropAnimation(isClosing: boolean): ViewStyle {
-  return isClosing
-    ? ({ animation: `bloomCenteredDialogFadeOut ease-in ${FADE_OUT_DURATION}ms forwards` } as ViewStyle)
-    : ({ animation: 'bloomCenteredDialogFadeIn ease-out 150ms' } as ViewStyle);
-}
-function cardAnimation(isClosing: boolean): ViewStyle {
-  return isClosing
-    ? ({ animation: `bloomCenteredDialogZoomOut ease-in ${FADE_OUT_DURATION}ms forwards` } as ViewStyle)
-    : ({ animation: 'bloomCenteredDialogZoomIn cubic-bezier(0.16, 1, 0.3, 1) 200ms' } as ViewStyle);
-}
-const KEYFRAMES_ID = 'bloom-centered-dialog-keyframes';
-/**
- * CSS keyframes powering the web enter/exit animation. Injected once into
- * `<head>` on first mount (keyed by id so re-mounts and multiple dialogs
- * don't duplicate the rule). Mirrors the native modal's `fade` feel with a
- * subtle zoom on the card.
- */
-export const BLOOM_CENTERED_DIALOG_CSS = `
-@keyframes bloomCenteredDialogFadeIn { from { opacity: 0; } to { opacity: 1; } }
-@keyframes bloomCenteredDialogFadeOut { from { opacity: 1; } to { opacity: 0; } }
-@keyframes bloomCenteredDialogZoomIn { from { opacity: 0; transform: scale(0.96); } to { opacity: 1; transform: scale(1); } }
-@keyframes bloomCenteredDialogZoomOut { from { opacity: 1; transform: scale(1); } to { opacity: 0; transform: scale(0.96); } }
-`;
-function useKeyframes(): void {
-  useEffect(() => {
-    if (typeof document === 'undefined') return;
-    if (document.getElementById(KEYFRAMES_ID)) return;
-    const style = document.createElement('style');
-    style.id = KEYFRAMES_ID;
-    style.textContent = BLOOM_CENTERED_DIALOG_CSS;
-    document.head.appendChild(style);
-  }, []);
-}
-const styles = StyleSheet.create({
-  root: {
-    position: 'fixed' as 'absolute',
-    top: 0,
-    left: 0,
-    right: 0,
-    bottom: 0,
-    zIndex: dialogZIndex.backdrop,
-    alignItems: 'center',
-    justifyContent: 'center',
-    pointerEvents: 'auto',
-  },
-  backdrop: {
-    position: 'fixed' as 'absolute',
-    top: 0,
-    left: 0,
-    right: 0,
-    bottom: 0,
-  },
-  card: {
-    position: 'relative',
-    width: '100%',
-    borderRadius: CARD_RADIUS,
-    borderWidth: 1,
-    overflow: 'hidden',
-    shadowOpacity: 0.18,
-    shadowRadius: 24,
-    shadowOffset: { width: 0, height: 8 },
-    zIndex: dialogZIndex.surface,
-  },
-  header: {
-    flexDirection: 'row',
-    alignItems: 'flex-start',
-    justifyContent: 'space-between',
-  },
-  title: {
-    flex: 1,
-    fontSize: 17,
-    fontWeight: '700',
-    lineHeight: 22,
-  },
-  titleSpacer: {
-    flex: 1,
-  },
-  closeButton: {
-    width: 28,
-    height: 28,
-    borderRadius: 14,
-    alignItems: 'center',
-    justifyContent: 'center',
-    cursor: 'pointer',
-  },
-  closeButtonActive: {
-    opacity: 0.7,
-  },
-  bodyScroll: {
-    flexGrow: 0,
-    flexShrink: 1,
-  },
-  footer: {
-    borderTopWidth: 1,
-  },
-});

package/src/dialog/centered-dialog-tokens.ts DELETED Viewed

@@ -1,68 +0,0 @@
-import { borderRadius, space } from '../styles/tokens';
-/**
- * Shared layout constants for `<CenteredDialog>`, kept in one module so the
- * native and web forks render identically. All values are Bloom theme tokens
- * (`styles/tokens`) — no ad-hoc magic numbers.
- *
- * COMPACT is the priority: the `compact` spacing set is the default and is
- * deliberately tight (≈`space.md`), so the card reads snug out of the box.
- * The `cozy` set is the opt-out (`compact={false}`) for roomier dialogs.
- */
-/** Default max card width — comfortable for a compact dialog. */
-export const DEFAULT_MAX_WIDTH = 440;
-/** Card height is capped at this fraction of the viewport; body scrolls. */
-export const MAX_HEIGHT_FRACTION = 0.8;
-/** Card corner radius (token: `borderRadius.lg` = 16). */
-export const CARD_RADIUS = borderRadius.lg;
-/** Outer gutter between the card edge and the viewport edge (token `space.lg`). */
-export const VIEWPORT_GUTTER = space.lg;
-export type DialogSpacing = {
-  /** Card inner padding (horizontal + vertical). */
-  pad: number;
-  /** Gap between the header title row and the body. */
-  headerGap: number;
-  /** Gap between the body and the footer. */
-  footerGap: number;
-  /** Vertical gap between stacked body items (the content container `gap`). */
-  contentGap: number;
-};
-/**
- * Compact (default) — tight, snug spacing built on `space.md` (12).
- *
- *   pad        = space.md  (12)
- *   headerGap  = space.sm  (8)
- *   footerGap  = space.md  (12)
- *   contentGap = space.sm  (8)
- */
-export const COMPACT_SPACING: DialogSpacing = {
-  pad: space.md,
-  headerGap: space.sm,
-  footerGap: space.md,
-  contentGap: space.sm,
-};
-/**
- * Cozy (`compact={false}`) — roomier spacing built on `space.xl` (20).
- *
- *   pad        = space.xl   (20)
- *   headerGap  = space.md   (12)
- *   footerGap  = space.lg   (16)
- *   contentGap = space.md   (12)
- */
-export const COZY_SPACING: DialogSpacing = {
-  pad: space.xl,
-  headerGap: space.md,
-  footerGap: space.lg,
-  contentGap: space.md,
-};
-export function resolveSpacing(compact: boolean): DialogSpacing {
-  return compact ? COMPACT_SPACING : COZY_SPACING;
-}

package/src/dialog/centered-dialog-types.ts DELETED Viewed

@@ -1,74 +0,0 @@
-import type { ReactNode } from 'react';
-import type { StyleProp, ViewStyle } from 'react-native';
-/**
- * @deprecated Use `<Dialog placement="center">` instead. `CenteredDialog` is
- * superseded by the centered placement of the canonical `<Dialog>` and is
- * slated for removal in a future major.
- *
- * Props for the declarative `<CenteredDialog>` primitive.
- *
- * This is the simple, controlled centered-modal surface — distinct from the
- * imperative `useDialogControl()` + `<Dialog control={…}>` API in the same
- * module. Reach for `<CenteredDialog>` when you already own the open/closed
- * boolean (a `useState`, a query flag, a route param) and just want Bloom to
- * render the dimmed backdrop + a snug, theme-styled centered card.
- *
- * All spacing/colour/radius come from Bloom theme tokens — the card reads
- * compact out of the box (`compact` defaults to `true`).
- */
-export type CenteredDialogProps = {
-  /** Whether the dialog is mounted + visible. */
-  visible: boolean;
-  /**
-   * Close request — fired on backdrop tap (when `dismissible`), the close
-   * button, the hardware back button (Android), and `Escape` (web). The
-   * caller owns the visible state, so it must flip `visible` to `false` here.
-   */
-  onClose: () => void;
-  /**
-   * Optional header title. When set (or when `showClose` is `true`) Bloom
-   * renders a tight header row above the content.
-   */
-  title?: string;
-  /**
-   * Tap-outside / back-button / Escape dismisses the dialog. Defaults to
-   * `true`. Set `false` for blocking flows (e.g. a destructive confirm that
-   * must be answered via an explicit action).
-   */
-  dismissible?: boolean;
-  /** Max card width in px. Defaults to {@link DEFAULT_MAX_WIDTH} (440). */
-  maxWidth?: number;
-  /**
-   * Tight, snug spacing (the Bloom default). Set `false` for a roomier card
-   * with larger padding and header/footer gaps. Defaults to `true`.
-   */
-  compact?: boolean;
-  /**
-   * Render a close (✕) icon button in the header. Defaults to `true` when a
-   * `title` is provided, otherwise `false` (a chromeless card owns its own
-   * dismissal affordances).
-   */
-  showClose?: boolean;
-  /** Card body. Scrolls within the height cap when it overflows. */
-  children?: ReactNode;
-  /**
-   * Optional footer slot for actions (e.g. a Bloom `<Button>` row). Rendered
-   * below the scrollable body with a hairline separator.
-   */
-  footer?: ReactNode;
-  /**
-   * Accessibility label for the dialog surface. Falls back to `title` when
-   * omitted.
-   */
-  accessibilityLabel?: string;
-  /** Accessibility label for the header close (✕) button. */
-  closeAccessibilityLabel?: string;
-  /** Accessibility label for the dimmed backdrop's tap-to-dismiss affordance. */
-  backdropAccessibilityLabel?: string;
-  /** Style overrides merged onto the centered card container. */
-  cardStyle?: StyleProp<ViewStyle>;
-  /** Style overrides merged onto the scrollable content container. */
-  contentStyle?: StyleProp<ViewStyle>;
-  testID?: string;
-};

package/src/responsive-sheet/ResponsiveSheet.stories.tsx DELETED Viewed

@@ -1,54 +0,0 @@
-import React, { useState } from 'react';
-import { View } from 'react-native';
-import type { Meta, StoryObj } from '@storybook/react-vite';
-import { ResponsiveSheet } from './index';
-import type { ResponsiveSheetSide } from './types';
-import { Button } from '../button';
-import { Text } from '../typography';
-const meta: Meta = {
-  title: 'Overlays/ResponsiveSheet',
-};
-export default meta;
-type Story = StoryObj;
-function Demo({ side }: { side: ResponsiveSheetSide }) {
-  const [open, setOpen] = useState(false);
-  return (
-    <View style={{ padding: 24, minHeight: 480 }}>
-      <Button onPress={() => setOpen(true)}>Open sheet ({side})</Button>
-      <ResponsiveSheet
-        open={open}
-        onClose={() => setOpen(false)}
-        side={side}
-        width={420}
-        inset={{ top: 16, bottom: 16, left: 16 }}
-        label="Demo sheet"
-      >
-        <View style={{ padding: 20, gap: 12 }}>
-          <Text style={{ fontSize: 20, fontWeight: '700' }}>Responsive sheet</Text>
-          <Text>
-            On a wide viewport this is an anchored side-sheet; below the
-            breakpoint it becomes a bottom-sheet with a drag handle. Resize the
-            preview to switch modes.
-          </Text>
-          <Button variant="secondary" onPress={() => setOpen(false)}>
-            Close
-          </Button>
-        </View>
-      </ResponsiveSheet>
-    </View>
-  );
-}
-export const SideLeft: Story = {
-  render: () => <Demo side="left" />,
-};
-export const SideRight: Story = {
-  render: () => <Demo side="right" />,
-};

package/src/responsive-sheet/ResponsiveSheet.tsx DELETED Viewed

@@ -1,88 +0,0 @@
-import React from 'react';
-import { Dialog } from '../dialog';
-import {
-  BREAKPOINT_LG,
-  BREAKPOINT_MD,
-  BREAKPOINT_SM,
-  BREAKPOINT_XL,
-  DIALOG_SHEET_BACKDROP_TESTID,
-  type ResponsiveDialogPlacement,
-} from '../dialog/placement';
-import type { ResponsiveSheetProps } from './types';
-/**
- * @deprecated Use `<Dialog placement={{ base: 'bottom', md: 'left' }}>` instead.
- *
- * `ResponsiveSheet` is now a thin wrapper that configures the canonical
- * `<Dialog>` — an anchored side-sheet on wide screens collapsing to a
- * bottom-sheet below the breakpoint. It holds ZERO motion/layout logic of its
- * own; it maps its props onto a responsive `Dialog` `placement`. The
- * `@oxyhq/bloom/responsive-sheet` subpath is retained for the migration window.
- *
- * This file is BOTH the package default entry (resolved by downstream `tsc`
- * and non-Metro web bundlers via the `browser` condition through `index.web`)
- * AND a clean delegation, so it carries no platform-specific imports.
- */
-export function ResponsiveSheet({
-  open,
-  onClose,
-  side = 'left',
-  breakpoint = BREAKPOINT_MD,
-  width,
-  maxHeightRatio,
-  inset,
-  showHandle,
-  dismissOnBackdrop,
-  panelStyle,
-  panelClassName,
-  containerStyle,
-  containerClassName,
-  label,
-  children,
-}: ResponsiveSheetProps) {
-  return (
-    <Dialog
-      open={open}
-      onClose={onClose}
-      placement={placementForSide(side, breakpoint)}
-      width={width}
-      maxHeightRatio={maxHeightRatio}
-      inset={inset}
-      showHandle={showHandle}
-      dismissOnBackdrop={dismissOnBackdrop}
-      panelStyle={panelStyle}
-      panelClassName={panelClassName}
-      containerStyle={containerStyle}
-      containerClassName={containerClassName}
-      label={label}
-    >
-      {children}
-    </Dialog>
-  );
-}
-/**
- * Build the `Dialog` `placement` map for a `ResponsiveSheet`: a bottom-sheet
- * below `breakpoint`, the anchored `side` at and above it. The `breakpoint`
- * (px) is bucketed to the nearest Tailwind key so the side-sheet engages at the
- * matching width.
- */
-function placementForSide(
-  side: 'left' | 'right',
-  breakpoint: number,
-): ResponsiveDialogPlacement {
-  if (breakpoint <= BREAKPOINT_SM) return { base: 'bottom', sm: side };
-  if (breakpoint <= BREAKPOINT_MD) return { base: 'bottom', md: side };
-  if (breakpoint <= BREAKPOINT_LG) return { base: 'bottom', lg: side };
-  if (breakpoint <= BREAKPOINT_XL) return { base: 'bottom', xl: side };
-  return { base: 'bottom', xl: side };
-}
-/**
- * @deprecated Stable testID for the dimmed backdrop dismiss button — now
- * provided by the underlying `<Dialog>`'s side/bottom backdrop.
- */
-export const RESPONSIVE_SHEET_BACKDROP_TESTID = DIALOG_SHEET_BACKDROP_TESTID;
-export default ResponsiveSheet;