@rojaostudio/ds 2.0.0-next.12 → 2.0.0-next.14

package/README.md

@@ -26,7 +26,7 @@ Add `dark` to `<html>` (or any element) for dark mode:
 <html class="dark">
 ```
 
-The stylesheet declares its layers first (`rds.theme`, `rds.tokens`, `rds.components`), so your own unlayered CSS
+The stylesheet declares its layers first (`rds.legacy`, `rds.theme`, `rds.tokens`, `rds.components`), so your own unlayered CSS
 always wins over the design system without `!important`. The components need no Tailwind and no other stylesheet.
 
 ### Legacy: `base.css` (deprecated)
@@ -42,6 +42,41 @@ utilities (`bg-surface-*`, `text-fg-*`, `h-control-*`…) and its CSS variables,
 @import "@rojaostudio/ds/styles/rds.css";
 ```
 
+Both stylesheets declare the same layer order, `rds.legacy, rds.theme, rds.tokens, rds.components`, and everything
+in `base.css` (its variables, the primitives, the `h1`–`h6` rule, the `rojao-*` animations) lives in `rds.legacy`.
+So, whatever the import order, the 2.0 wins wherever the two declare the same variable: 31 names, among them
+`--surface-page`, `--text-muted`, `--text-disabled`, `--border-default`, `--border-strong`, `--radius-card`,
+`--radius-control`, `--z-modal`, `--z-dropdown`, `--z-tooltip`, `--space-4` … `--space-64`, `--toast-text`,
+`--toast-border`. A 1.x utility that reads one of them (`bg-surface-page`, `text-fg-muted` through
+`--text-muted`) shows the 2.0 value while both are imported; the 1.x-only names (`--brand-primary`,
+`--surface-default`…) keep theirs. Tailwind's `@utility` and `@theme` blocks stay at the top level, as Tailwind
+requires, and the focus ring stays in Tailwind's `base` layer, so `outline-none` still wins over it. Your own
+unlayered CSS wins over all of it.
+
+## Theme scopes
+
+The shipped theme switches on `.dark`, `.ds-plate` and `.ds-scope`, and on three generic attributes:
+`data-rds-mode="dark"`, `data-rds-plate` and `data-rds-scope`. The component tokens are declared again on each of
+them (`RDS_SCOPE_SELECTORS` in `@rojaostudio/ds-core/generate`): a component token holds `var(--theme-role)`, which
+resolves where it is declared, so a theme switched on an element none of them match would repaint the roles but
+not the components inside.
+
+```html
+<section data-rds-mode="dark">…</section>   <!-- a dark section on a light page -->
+```
+
+For your own theme, `emitRdsCss(theme, { scope, dark, plate })` checks each selector against that list and throws
+on one the components would not follow:
+
+```ts
+emitRdsCss(theme, { scope: ".my-scope[data-rds-scope]" });          // <div class="my-scope" data-rds-scope>
+emitRdsCss(theme, { scope: ":root", dark: ':root[data-theme="dark"]' }); // next-themes, attribute="data-theme"
+emitRdsCss(theme, { scope: ".my-scope" });                           // throws: add data-rds-scope
+```
+
+A dark selector anchored at the root (`:root[…]`, `html…`) is used as is, which is where next-themes puts its
+attribute. `allowUncovered: true` skips the check, for a theme read only by your own CSS.
+
 ## Import the component, not the barrel
 
 ```tsx
@@ -99,7 +134,7 @@ renders itself (the × of Alert, Dialog and Toast, the Calendar and Carousel arr
 ## Requirements
 
 React 19. Tailwind CSS is an **optional** peer: only the legacy `base.css` needs it. A few components bring an
-optional peer of their own, installed only if you use them: `react-image-crop` (ImageCropModal, ImageUpload) and
+optional peer of their own, installed only if you use them: `react-image-crop` (ImageCropDialog, ImageUpload) and
 `react-international-phone` (PhoneInput).
 
 ## Icons
@@ -115,6 +150,11 @@ import { PixIcon } from '@rojaostudio/ds/icons';
 
 ## React Native
 
+> **Experimental, outside semver in 2.0.** The native target (`@rojaostudio/ds/native/*`) still follows the 1.x
+> API (`Button variant="primary"`, `Modal`, `Menu`…) and the 1.x theme (`generateTheme`). It will be aligned with
+> the 2.0 components in 2.1; until then it may change in any release, minor and patch included. Pin an exact
+> version if you depend on it. The web components never import from it.
+
 ```tsx
 import { DSThemeProvider } from '@rojaostudio/ds/native/components';
 

package/THIRD_PARTY_NOTICES.md

@@ -55,7 +55,7 @@ O símbolo do Pix (`packages/ds/icons/pix.tsx`) é marca do Banco Central do Bra
 |---|---|---|
 | `@radix-ui/react-*` | MIT | comportamento acessível de overlays, menus, abas e afins |
 | `lucide-react` (peer opcional) | ISC | re-exportação de ícones em `@rojaostudio/ds/icons` |
-| `react-image-crop` (peer opcional) | ISC | recorte do `ImageCropModal` |
+| `react-image-crop` (peer opcional) | ISC | recorte do `ImageCropDialog` |
 | `react-international-phone` (peer opcional) | MIT | campo e bandeiras do `PhoneInput` |
 
 ## Fontes (referenciadas pelo nome, não distribuídas)

package/dist/components/floating-stepper.d.ts

@@ -1,33 +1,16 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
+import { Stepper, StepperProps, StepperStep } from './stepper.js';
+import 'react';
 
 /**
- * FloatingStepper — a composition of the Card (as a pill) and Buttons (Figma [RDS] Actions/Button, neutral): the
- * floating steps of a flow (point of sale, checkout). The current step is the filled Button (aria-current="step");
- * earlier steps go back, later ones are disabled; `canNavigate` changes the rule. `action` is a last Button after
- * a vertical Separator (Reset). Where it floats is the caller's (className or a wrapper). Styles: floating-stepper.css.
+ * floating-stepper — the 1.x and 2.0-next name of the Stepper, kept so `@rojaostudio/ds/components/floating-stepper`
+ * and `FloatingStepper` still work in 2.0. The codemod (`npx @rojaostudio/ds-codemod`) renames both.
  */
-type FloatingStepperStep = {
-    key: string;
-    label: string;
-};
-interface FloatingStepperProps {
-    steps: FloatingStepperStep[];
-    /** key da etapa atual */
-    current: string;
-    onNavigate?: (key: string) => void;
-    /** Regra de navegação por etapa. Default: só etapas anteriores à atual. */
-    canNavigate?: (key: string, index: number, currentIndex: number) => boolean;
-    /** Ação à direita, separada por divisor (ex.: Reset). */
-    action?: {
-        label: string;
-        icon?: ReactNode;
-        onClick: () => void;
-    };
-    className?: string;
-    /** The navigation's name. Default "Etapas". */
-    'aria-label'?: string;
-}
-declare function FloatingStepper({ steps, current, onNavigate, canNavigate, action, className, 'aria-label': ariaLabel }: FloatingStepperProps): react.JSX.Element;
+
+/** @deprecated Renamed to `Stepper` (`@rojaostudio/ds/components/stepper`) in 2.0. Same props. */
+declare const FloatingStepper: typeof Stepper;
+/** @deprecated Renamed to `StepperProps` in 2.0. */
+type FloatingStepperProps = StepperProps;
+/** @deprecated Renamed to `StepperStep` in 2.0. */
+type FloatingStepperStep = StepperStep;
 
 export { FloatingStepper, type FloatingStepperProps, type FloatingStepperStep };

package/dist/components/floating-stepper.js

@@ -1,36 +1,7 @@
 "use client";
 import "../chunk-ORMEWXMH.js";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { Button } from "./button.js";
-import { Card } from "./card.js";
-import { Separator } from "./separator.js";
-function FloatingStepper({ steps, current, onNavigate, canNavigate, action, className, "aria-label": ariaLabel = "Etapas" }) {
-  const currentIdx = steps.findIndex((s) => s.key === current);
-  return /* @__PURE__ */ jsxs(Card, { as: "div", size: "sm", role: "navigation", "aria-label": ariaLabel, className: ["rds-floating-stepper", className].filter(Boolean).join(" "), children: [
-    steps.map((s, idx) => {
-      const isCurrent = idx === currentIdx;
-      const canGo = canNavigate ? canNavigate(s.key, idx, currentIdx) : idx < currentIdx;
-      return /* @__PURE__ */ jsx(
-        Button,
-        {
-          tone: "neutral",
-          variant: isCurrent ? "fill" : "ghost",
-          disabled: !canGo && !isCurrent,
-          "aria-current": isCurrent ? "step" : void 0,
-          onClick: () => {
-            if (canGo && !isCurrent) onNavigate == null ? void 0 : onNavigate(s.key);
-          },
-          children: s.label
-        },
-        s.key
-      );
-    }),
-    action && /* @__PURE__ */ jsxs(Fragment, { children: [
-      /* @__PURE__ */ jsx(Separator, { orientation: "vertical", className: "rds-floating-stepper__divider" }),
-      /* @__PURE__ */ jsx(Button, { tone: "neutral", variant: "ghost", icon: action.icon, onClick: action.onClick, children: action.label })
-    ] })
-  ] });
-}
+import { Stepper } from "./stepper.js";
+const FloatingStepper = Stepper;
 export {
   FloatingStepper
 };

package/dist/components/image-crop-dialog.d.ts

@@ -0,0 +1,60 @@
+import * as react from 'react';
+
+/**
+ * ImageCropDialog — Figma [RDS] Overlays/ImageCropDialog: a composition of the Dialog, a ToggleGroup (the aspect
+ * presets), the Alert (an aspect out of bounds) and the Spinner: crops an image before upload. Needs
+ * `react-image-crop` (an optional peer, needed only here). The crop's shade, line and handles and the stage's
+ * background are its own tokens (Overlays, image-crop-dialog/*). Styles: image-crop-dialog.css.
+ *
+ * Uso:
+ *   <ImageCropDialog
+ *     open={open}
+ *     file={selectedFile}
+ *     onCancel={() => setOpen(false)}
+ *     onConfirm={(blob) => uploadCroppedImage(blob)}
+ *   />
+ *
+ * Presets default: Livre (1:2 a 2:1), 1:1, 4:5, 16:9.
+ * Customize via prop `presets`.
+ */
+interface CropPreset {
+    id: string;
+    label: string;
+    /** Aspect ratio fixo. undefined = livre (com bounds MIN/MAX_ASPECT). */
+    aspect?: number;
+    /** Ícone opcional exibido antes do rótulo (ajuda quem não decodifica "16:9"). */
+    icon?: React.ReactNode;
+}
+interface ImageCropDialogProps {
+    open: boolean;
+    file: File | null;
+    /** Label de contexto pro título (ex: "Foto 2 de 4"). */
+    position?: string;
+    onCancel: () => void;
+    /**
+     * Recebe o blob do recorte. Pode ser assíncrono (ex.: upload) — o modal AGUARDA a promise
+     * e mantém o botão travado/carregando até resolver, evitando duplo-clique que duplicaria a
+     * imagem (o upload roda fora do `busy` se o modal não esperar).
+     */
+    onConfirm: (blob: Blob) => void | Promise<void>;
+    /** Presets disponíveis. default = Livre + 1:1 + 4:5 + 16:9. */
+    presets?: CropPreset[];
+    /** Limite mínimo de aspect ratio (alto-baixo). default = 0.5 (1:2). */
+    minAspect?: number;
+    /** Limite máximo de aspect ratio (largo-baixo). default = 2.0 (2:1). */
+    maxAspect?: number;
+    /** Título do modal. default = "Ajustar foto". */
+    title?: string;
+    /** Label do botão confirmar. default = "Aplicar e enviar". */
+    confirmLabel?: string;
+    /**
+     * Teto de tamanho do blob de saída (bytes). Quando definido, a saída do crop
+     * é forçada a JPEG e comprimida (qualidade + downscale) até caber no limite —
+     * evita que foto de celular grande estoure o limite de upload. Sem ele, a
+     * saída mantém o tipo original e qualidade fixa (comportamento inalterado).
+     */
+    maxSizeBytes?: number;
+}
+declare function ImageCropDialog({ open, file, position, onCancel, onConfirm, presets, minAspect, maxAspect, title, confirmLabel, maxSizeBytes, }: ImageCropDialogProps): react.JSX.Element;
+
+export { type CropPreset, ImageCropDialog, type ImageCropDialogProps };

package/dist/components/image-crop-dialog.js

@@ -0,0 +1,240 @@
+"use client";
+import "../chunk-ORMEWXMH.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import ReactCrop, { centerCrop } from "react-image-crop";
+import "react-image-crop/dist/ReactCrop.css";
+import { Alert } from "./alert.js";
+import { Button } from "./button.js";
+import { Dialog } from "./dialog.js";
+import { RectangleHorizontalIcon, RectangleVerticalIcon, SquareDashedIcon, SquareIcon } from "./internal/icons.js";
+import { Spinner } from "./spinner.js";
+import { ToggleGroup, ToggleGroupItem } from "./toggle-group.js";
+const DEFAULT_PRESETS = [
+  { id: "square", label: "1:1", aspect: 1, icon: /* @__PURE__ */ jsx(SquareIcon, {}) },
+  { id: "portrait", label: "4:5", aspect: 4 / 5, icon: /* @__PURE__ */ jsx(RectangleVerticalIcon, {}) },
+  { id: "landscape", label: "16:9", aspect: 16 / 9, icon: /* @__PURE__ */ jsx(RectangleHorizontalIcon, {}) },
+  { id: "free", label: "Livre", icon: /* @__PURE__ */ jsx(SquareDashedIcon, {}) }
+];
+const DEFAULT_MIN_ASPECT = 0.5;
+const DEFAULT_MAX_ASPECT = 2;
+function buildInitialCrop(width, height, aspect) {
+  if (!aspect) {
+    return { unit: "%", x: 0, y: 0, width: 100, height: 100 };
+  }
+  const imageAspect = width / height;
+  let cropW;
+  let cropH;
+  if (aspect >= imageAspect) {
+    cropW = 100;
+    cropH = imageAspect / aspect * 100;
+  } else {
+    cropH = 100;
+    cropW = aspect / imageAspect * 100;
+  }
+  return centerCrop({ unit: "%", x: 0, y: 0, width: cropW, height: cropH }, width, height);
+}
+const QUALITY_STEPS = [0.85, 0.75, 0.65, 0.55];
+const MAX_SIDE_STEPS = [1600, 1200];
+function canvasToBlob(canvas, mimeType, quality) {
+  return new Promise((resolve, reject) => {
+    canvas.toBlob((blob) => blob ? resolve(blob) : reject(new Error("toBlob failed")), mimeType, quality);
+  });
+}
+function drawCrop(image, crop, maxSide) {
+  const canvas = document.createElement("canvas");
+  const scaleX = image.naturalWidth / image.width;
+  const scaleY = image.naturalHeight / image.height;
+  let outW = Math.round(crop.width * scaleX);
+  let outH = Math.round(crop.height * scaleY);
+  if (maxSide && Math.max(outW, outH) > maxSide) {
+    const ratio = maxSide / Math.max(outW, outH);
+    outW = Math.round(outW * ratio);
+    outH = Math.round(outH * ratio);
+  }
+  canvas.width = outW;
+  canvas.height = outH;
+  const ctx = canvas.getContext("2d");
+  if (!ctx) throw new Error("Canvas not supported");
+  ctx.drawImage(
+    image,
+    crop.x * scaleX,
+    crop.y * scaleY,
+    crop.width * scaleX,
+    crop.height * scaleY,
+    0,
+    0,
+    outW,
+    outH
+  );
+  return canvas;
+}
+async function cropToBlob(image, crop, mimeType, maxSizeBytes) {
+  const baseCanvas = drawCrop(image, crop);
+  if (!maxSizeBytes) {
+    return canvasToBlob(baseCanvas, mimeType, 0.92);
+  }
+  const out = await canvasToBlob(baseCanvas, "image/jpeg", 0.92);
+  if (out.size <= maxSizeBytes) return out;
+  let best = out;
+  for (const q of QUALITY_STEPS) {
+    const candidate = await canvasToBlob(baseCanvas, "image/jpeg", q);
+    best = candidate;
+    if (candidate.size <= maxSizeBytes) return candidate;
+  }
+  for (const side of MAX_SIDE_STEPS) {
+    const scaledCanvas = drawCrop(image, crop, side);
+    for (const q of QUALITY_STEPS) {
+      const candidate = await canvasToBlob(scaledCanvas, "image/jpeg", q);
+      best = candidate;
+      if (candidate.size <= maxSizeBytes) return candidate;
+    }
+  }
+  return best;
+}
+function ImageCropDialog({
+  open,
+  file,
+  position,
+  onCancel,
+  onConfirm,
+  presets = DEFAULT_PRESETS,
+  minAspect = DEFAULT_MIN_ASPECT,
+  maxAspect = DEFAULT_MAX_ASPECT,
+  title = "Ajustar foto",
+  confirmLabel = "Aplicar e enviar",
+  maxSizeBytes
+}) {
+  const [src, setSrc] = useState(null);
+  const [preset, setPreset] = useState(presets[0]);
+  const [crop, setCrop] = useState();
+  const [completedCrop, setCompletedCrop] = useState(null);
+  const [aspectError, setAspectError] = useState(null);
+  const [busy, setBusy] = useState(false);
+  const [imgLoaded, setImgLoaded] = useState(false);
+  const imgRef = useRef(null);
+  useEffect(() => {
+    if (!file) {
+      setSrc(null);
+      setImgLoaded(false);
+      return;
+    }
+    const url = URL.createObjectURL(file);
+    setSrc(url);
+    setPreset(presets[0]);
+    setCrop(void 0);
+    setCompletedCrop(null);
+    setAspectError(null);
+    setImgLoaded(false);
+    return () => URL.revokeObjectURL(url);
+  }, [file, presets]);
+  function handleImageLoad(e) {
+    var _a, _b, _c, _d;
+    const { width, height } = e.currentTarget;
+    const initial = buildInitialCrop(width, height, preset.aspect);
+    setCrop(initial);
+    const pixelInitial = {
+      unit: "px",
+      x: ((_a = initial.x) != null ? _a : 0) / 100 * width,
+      y: ((_b = initial.y) != null ? _b : 0) / 100 * height,
+      width: ((_c = initial.width) != null ? _c : 0) / 100 * width,
+      height: ((_d = initial.height) != null ? _d : 0) / 100 * height
+    };
+    setCompletedCrop(pixelInitial);
+    setImgLoaded(true);
+  }
+  function applyPreset(p) {
+    setPreset(p);
+    setAspectError(null);
+    if (imgRef.current) {
+      const { width, height } = imgRef.current;
+      setCrop(buildInitialCrop(width, height, p.aspect));
+    }
+  }
+  function validateFreeAspect(c) {
+    if (preset.aspect) return true;
+    if (!c.width || !c.height) return false;
+    const ratio = c.width / c.height;
+    if (ratio < minAspect) {
+      setAspectError(`Recorte muito alto. M\xEDnimo permitido: ${minAspect.toFixed(1)}.`);
+      return false;
+    }
+    if (ratio > maxAspect) {
+      setAspectError(`Recorte muito largo. M\xE1ximo permitido: ${maxAspect.toFixed(1)}.`);
+      return false;
+    }
+    setAspectError(null);
+    return true;
+  }
+  async function handleConfirm() {
+    if (busy) return;
+    if (!completedCrop || !imgRef.current || !file) return;
+    if (!validateFreeAspect(completedCrop)) return;
+    setBusy(true);
+    try {
+      const blob = await cropToBlob(imgRef.current, completedCrop, file.type || "image/jpeg", maxSizeBytes);
+      await onConfirm(blob);
+    } catch (err) {
+      console.error("cropToBlob error", err);
+    } finally {
+      setBusy(false);
+    }
+  }
+  return /* @__PURE__ */ jsx(
+    Dialog,
+    {
+      open,
+      onOpenChange: (next) => {
+        if (!next) onCancel();
+      },
+      size: "lg",
+      title: position ? `${title} \xB7 ${position}` : title,
+      footer: /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx(Button, { tone: "neutral", variant: "ghost", onClick: onCancel, children: "Cancelar" }),
+        /* @__PURE__ */ jsx(Button, { onClick: handleConfirm, disabled: busy || !completedCrop || !!aspectError, loading: busy, children: busy ? "Aplicando\u2026" : confirmLabel })
+      ] }),
+      children: /* @__PURE__ */ jsxs("div", { className: "rds-image-crop", children: [
+        presets.length > 1 && /* @__PURE__ */ jsx(
+          ToggleGroup,
+          {
+            type: "single",
+            "aria-label": "Propor\xE7\xE3o",
+            value: preset.id,
+            onValueChange: (id) => {
+              const next = presets.find((p) => p.id === id);
+              if (next) applyPreset(next);
+            },
+            className: "rds-image-crop__presets",
+            children: presets.map((p) => /* @__PURE__ */ jsx(ToggleGroupItem, { value: p.id, icon: p.icon, children: p.label }, p.id))
+          }
+        ),
+        /* @__PURE__ */ jsxs("div", { className: "rds-image-crop__stage", children: [
+          src && /* @__PURE__ */ jsx(
+            ReactCrop,
+            {
+              crop,
+              onChange: (_, percentCrop) => setCrop(percentCrop),
+              onComplete: (c) => {
+                setCompletedCrop(c);
+                validateFreeAspect(c);
+              },
+              aspect: preset.aspect,
+              keepSelection: true,
+              minWidth: 50,
+              minHeight: 50,
+              className: "rds-image-crop__crop",
+              children: /* @__PURE__ */ jsx("img", { ref: imgRef, src, alt: "", onLoad: handleImageLoad, className: "rds-image-crop__image" })
+            }
+          ),
+          !imgLoaded && /* @__PURE__ */ jsx("div", { className: "rds-image-crop__layer", children: /* @__PURE__ */ jsx(Spinner, { size: "lg", label: "Carregando imagem\u2026" }) }),
+          busy && /* @__PURE__ */ jsx("div", { className: "rds-image-crop__layer rds-image-crop__layer--busy", children: /* @__PURE__ */ jsx(Spinner, { size: "lg", tone: "inverse", label: "Enviando\u2026" }) })
+        ] }),
+        aspectError && /* @__PURE__ */ jsx(Alert, { tone: "danger", title: aspectError, announce: "alert" }),
+        !aspectError && imgLoaded && !busy && /* @__PURE__ */ jsx("p", { className: "rds-image-crop__hint", children: preset.aspect ? "Arraste as al\xE7as para ajustar o recorte." : `Livre: propor\xE7\xE3o entre ${minAspect.toFixed(1)} (vertical) e ${maxAspect.toFixed(1)} (horizontal).` })
+      ] })
+    }
+  );
+}
+export {
+  ImageCropDialog
+};

package/dist/components/image-crop-modal.d.ts

@@ -1,60 +1,16 @@
-import * as react from 'react';
+import { ImageCropDialog, ImageCropDialogProps } from './image-crop-dialog.js';
+export { CropPreset } from './image-crop-dialog.js';
+import 'react';
 
 /**
- * ImageCropModal — Figma [RDS] Overlays/ImageCropModal: a composition of the Dialog, a ToggleGroup (the aspect
- * presets), the Alert (an aspect out of bounds) and the Spinner: crops an image before upload. Needs
- * `react-image-crop` (an optional peer, needed only here). The crop's shade, line and handles and the stage's
- * background are its own tokens (Overlays, image-crop-modal/*). Styles: image-crop-modal.css.
- *
- * Uso:
- *   <ImageCropModal
- *     open={open}
- *     file={selectedFile}
- *     onCancel={() => setOpen(false)}
- *     onConfirm={(blob) => uploadCroppedImage(blob)}
- *   />
- *
- * Presets default: Livre (1:2 a 2:1), 1:1, 4:5, 16:9.
- * Customize via prop `presets`.
+ * image-crop-modal — the 1.x and 2.0-next name of the ImageCropDialog, kept so
+ * `@rojaostudio/ds/components/image-crop-modal` and `ImageCropModal` still work in 2.0. The codemod
+ * (`npx @rojaostudio/ds-codemod`) renames both. Like the dialog, it needs the optional peer `react-image-crop`.
  */
-interface CropPreset {
-    id: string;
-    label: string;
-    /** Aspect ratio fixo. undefined = livre (com bounds MIN/MAX_ASPECT). */
-    aspect?: number;
-    /** Ícone opcional exibido antes do rótulo (ajuda quem não decodifica "16:9"). */
-    icon?: React.ReactNode;
-}
-interface ImageCropModalProps {
-    open: boolean;
-    file: File | null;
-    /** Label de contexto pro título (ex: "Foto 2 de 4"). */
-    position?: string;
-    onCancel: () => void;
-    /**
-     * Recebe o blob do recorte. Pode ser assíncrono (ex.: upload) — o modal AGUARDA a promise
-     * e mantém o botão travado/carregando até resolver, evitando duplo-clique que duplicaria a
-     * imagem (o upload roda fora do `busy` se o modal não esperar).
-     */
-    onConfirm: (blob: Blob) => void | Promise<void>;
-    /** Presets disponíveis. default = Livre + 1:1 + 4:5 + 16:9. */
-    presets?: CropPreset[];
-    /** Limite mínimo de aspect ratio (alto-baixo). default = 0.5 (1:2). */
-    minAspect?: number;
-    /** Limite máximo de aspect ratio (largo-baixo). default = 2.0 (2:1). */
-    maxAspect?: number;
-    /** Título do modal. default = "Ajustar foto". */
-    title?: string;
-    /** Label do botão confirmar. default = "Aplicar e enviar". */
-    confirmLabel?: string;
-    /**
-     * Teto de tamanho do blob de saída (bytes). Quando definido, a saída do crop
-     * é forçada a JPEG e comprimida (qualidade + downscale) até caber no limite —
-     * evita que foto de celular grande estoure o limite de upload. Sem ele, a
-     * saída mantém o tipo original e qualidade fixa (comportamento inalterado).
-     */
-    maxSizeBytes?: number;
-}
-declare function ImageCropModal({ open, file, position, onCancel, onConfirm, presets, minAspect, maxAspect, title, confirmLabel, maxSizeBytes, }: ImageCropModalProps): react.JSX.Element;
 
-export { type CropPreset, ImageCropModal, type ImageCropModalProps };
+/** @deprecated Renamed to `ImageCropDialog` (`@rojaostudio/ds/components/image-crop-dialog`) in 2.0. Same props. */
+declare const ImageCropModal: typeof ImageCropDialog;
+/** @deprecated Renamed to `ImageCropDialogProps` in 2.0. */
+type ImageCropModalProps = ImageCropDialogProps;
+
+export { ImageCropModal, type ImageCropModalProps };