@rojaostudio/ds 2.0.0-next.2 → 2.0.0-next.20

package/dist/components/date-picker.d.ts

@@ -30,7 +30,7 @@ interface DatePickerProps extends FieldTextProps {
 }
 /**
  * DatePicker — Figma [RDS] Forms/DatePicker. A date field that takes typing (dd/mm/aaaa, the slashes come by
- * themselves) and, from the calendar button, opens the Calendar in a popover (Figma: `menu`). Choosing a day
+ * themselves) and, from the calendar button, opens the Calendar in a popover (Figma: `open`). Choosing a day
  * closes it and gives the focus back to the field; Escape closes without choosing. For a date near today, where
  * seeing the month helps: a birth date is an Input. Styles: date-picker.css, internal/field.css, calendar.css.
  */

package/dist/components/dialog.d.ts

@@ -2,10 +2,13 @@ import * as _radix_ui_react_dialog from '@radix-ui/react-dialog';
 import * as react from 'react';
 import { ModalProps } from './internal/modal.js';
 
-type DialogSize = 'sm' | 'default' | 'lg';
+type DialogSize = 'sm' | 'md' | 'lg';
 interface DialogProps extends ModalProps {
-    /** sm 400 (a question with one field), default 560 (a short form), lg 720 (a table or a preview). */
-    size?: DialogSize;
+    /**
+     * sm 400 (a question with one field), md 560 (a short form, the default), lg 720 (a table or a preview) (Figma:
+     * `size`). `'default'` is deprecated (2.0.0-next): it is `'md'`.
+     */
+    size?: DialogSize | 'default';
 }
 /**
  * Dialog — Figma [RDS] Overlays/Dialog. A window over the screen for a short task: create, edit (Radix Dialog).

package/dist/components/dialog.js

@@ -6,8 +6,8 @@ import {
 import { jsx } from "react/jsx-runtime";
 import { ModalClose, ModalShell } from "./internal/modal.js";
 function Dialog(_a) {
-  var _b = _a, { size = "default" } = _b, props = __objRest(_b, ["size"]);
-  return /* @__PURE__ */ jsx(ModalShell, __spreadValues({ prefix: "rds-dialog", modifiers: [`rds-dialog--${size}`] }, props));
+  var _b = _a, { size = "md" } = _b, props = __objRest(_b, ["size"]);
+  return /* @__PURE__ */ jsx(ModalShell, __spreadValues({ prefix: "rds-dialog", modifiers: [`rds-dialog--${size === "default" ? "md" : size}`] }, props));
 }
 const DialogClose = ModalClose;
 export {

package/dist/components/dropdown-menu.d.ts

@@ -30,8 +30,11 @@ declare function DropdownMenu({ trigger, children, align, side, open, defaultOpe
 interface DropdownMenuItemProps extends MenuItemContentProps {
     /** Runs when the item is chosen (click, Enter or Space); the menu then closes. A destructive action asks first (AlertDialog). */
     onSelect?: () => void;
-    /** danger for what destroys: last, after a separator (Figma: `tone`). */
-    tone?: DropdownMenuItemTone;
+    /**
+     * neutral (default), or danger for what destroys: last, after a separator (Figma: `tone`). `'default'` is
+     * deprecated (2.0.0-next): it is `'neutral'`.
+     */
+    tone?: DropdownMenuItemTone | 'default';
     /** Stays in the list, can't be chosen, and the arrows skip it. */
     disabled?: boolean;
     /** The text typing jumps by, when the label is not plain text. */

package/dist/components/dropzone.d.ts

@@ -2,7 +2,7 @@ import * as react from 'react';
 import { ReactNode } from 'react';
 
 /**
- * @deprecated Use `<FileInput variant="dropzone">` (Figma [RDS] Forms/FileInput), which has the label, the hint, the
+ * @deprecated Use `<FileInput layout="dropzone">` (Figma [RDS] Forms/FileInput), which has the label, the hint, the
  * error and the chosen file's row. Kept as a thin wrapper so 1.x code keeps compiling.
  */
 interface DropzoneProps {
@@ -17,7 +17,7 @@ interface DropzoneProps {
     'aria-label'?: string;
 }
 /**
- * @deprecated Use `<FileInput variant="dropzone">`. A drop target only: it hands the files over and stays empty,
+ * @deprecated Use `<FileInput layout="dropzone">`. A drop target only: it hands the files over and stays empty,
  * ready for the next ones, as the 1.x Dropzone did.
  */
 declare function Dropzone({ onFiles, accept, multiple, disabled, className, children, 'aria-label': ariaLabel, }: DropzoneProps): react.JSX.Element;

package/dist/components/dropzone.js

@@ -14,7 +14,7 @@ function Dropzone({
   return /* @__PURE__ */ jsx(
     FileInput,
     {
-      variant: "dropzone",
+      layout: "dropzone",
       "aria-label": ariaLabel,
       dropTitle: children,
       fileName: "",

package/dist/components/file-input.d.ts

@@ -2,14 +2,19 @@ import * as react from 'react';
 import { ComponentPropsWithRef, ReactNode } from 'react';
 import { FieldTextProps } from './internal/field.js';
 
-type FileInputVariant = 'field' | 'dropzone' | 'tile';
+/** The field's arrangement (Figma: `layout`). */
+type FileInputLayout = 'field' | 'dropzone' | 'tile';
+/** @deprecated Use FileInputLayout (2.0.0-next: `variant` is `layout`). */
+type FileInputVariant = FileInputLayout;
 interface FileInputProps extends Omit<FieldTextProps, 'labelPosition'>, Omit<ComponentPropsWithRef<'input'>, 'type' | 'children' | 'prefix' | 'value' | 'defaultValue' | 'size'> {
     /**
-     * The shape (Figma: `variant`). field (default): the Input's box, for a dense form. dropzone: a dashed area to drop
-     * the file on, when the file is what the screen is about (a receipt, a spreadsheet). tile: a 112 square with the image's
-     * preview, for a photo or a logo.
+     * The arrangement (Figma: `layout`). field (default): the Input's box, for a dense form. dropzone: a dashed area to
+     * drop the file on, when the file is what the screen is about (a receipt, a spreadsheet). tile: a 112 square with
+     * the image's preview, for a photo or a logo.
      */
-    variant?: FileInputVariant;
+    layout?: FileInputLayout;
+    /** @deprecated Use `layout` (2.0.0-next): the same three values. */
+    variant?: FileInputLayout;
     /** Controlled: the name shown (Figma: `fileName`). By default, the chosen file's name. */
     fileName?: string;
     /** Controlled: the size beside the name in the dropzone (Figma: `fileSize`). By default, the chosen file's, as "1,2 MB". */
@@ -43,7 +48,7 @@ interface FileInputProps extends Omit<FieldTextProps, 'labelPosition'>, Omit<Com
 /** "1,2 MB", "830 KB", "512 B": the size the way a person reads it. */
 declare function formatFileSize(bytes: number): string;
 /**
- * FileInput — Figma [RDS] Forms/FileInput. A file field in three shapes (`variant`): field, the Input's box with the
+ * FileInput — Figma [RDS] Forms/FileInput. A file field in three layouts (`layout`): field, the Input's box with the
  * clip, "Escolher arquivo" and the name; dropzone, a dashed area that takes a dragged file; tile, a square with the
  * image's preview and the buttons to swap or remove it. In every shape the native <input type="file"> does the work:
  * it lies transparent over the box, so a click, Enter or Space open the system's chooser, the label names it,
@@ -51,6 +56,6 @@ declare function formatFileSize(bytes: number): string;
  * size in the hint and check them in code (a failure is the errorMessage). Styles: file-input.css and
  * internal/field.css.
  */
-declare function FileInput({ variant, label, hint, error, errorMessage, required, fileName, fileSize, preview, previewAlt, dropTitle, tileText, clearable, onClear, onFiles, clearLabel, replaceLabel, chooseLabel, emptyLabel, id, disabled, className, style, onChange, ref, ...input }: FileInputProps): react.JSX.Element;
+declare function FileInput({ layout: layoutProp, variant, label, hint, error, errorMessage, required, fileName, fileSize, preview, previewAlt, dropTitle, tileText, clearable, onClear, onFiles, clearLabel, replaceLabel, chooseLabel, emptyLabel, id, disabled, className, style, onChange, ref, ...input }: FileInputProps): react.JSX.Element;
 
-export { FileInput, type FileInputProps, type FileInputVariant, formatFileSize };
+export { FileInput, type FileInputLayout, type FileInputProps, type FileInputVariant, formatFileSize };

package/dist/components/file-input.js

@@ -25,7 +25,8 @@ function formatFileSize(bytes) {
 }
 function FileInput(_a) {
   var _b = _a, {
-    variant = "field",
+    layout: layoutProp,
+    variant,
     label,
     hint,
     error,
@@ -51,6 +52,7 @@ function FileInput(_a) {
     onChange,
     ref
   } = _b, input = __objRest(_b, [
+    "layout",
     "variant",
     "label",
     "hint",
@@ -77,23 +79,24 @@ function FileInput(_a) {
     "onChange",
     "ref"
   ]);
-  var _a2, _b2, _c;
+  var _a2, _b2, _c, _d;
+  const layout = (_a2 = layoutProp != null ? layoutProp : variant) != null ? _a2 : "field";
   warnIfUnlabelled("FileInput", label, input["aria-label"], input["aria-labelledby"]);
-  const inside = variant === "dropzone";
+  const inside = layout === "dropzone";
   const ids = useFieldIds(id, inside ? void 0 : hint, error, errorMessage);
   const { controlId, errorId, invalid } = ids;
   const own = useRef(null);
   const [chosen, setChosen] = useState(null);
   const [dragging, setDragging] = useState(false);
   useEffect(() => () => revoke(chosen), [chosen]);
-  const shownName = (_a2 = fileName != null ? fileName : chosen == null ? void 0 : chosen.name) != null ? _a2 : "";
+  const shownName = (_b2 = fileName != null ? fileName : chosen == null ? void 0 : chosen.name) != null ? _b2 : "";
   const shownSize = fileSize != null ? fileSize : fileName === void 0 && chosen ? formatFileSize(chosen.size) : void 0;
-  const shownPreview = (_b2 = preview != null ? preview : chosen == null ? void 0 : chosen.url) != null ? _b2 : "";
-  const filled = variant === "tile" ? Boolean(shownPreview) : Boolean(shownName);
+  const shownPreview = (_c = preview != null ? preview : chosen == null ? void 0 : chosen.url) != null ? _c : "";
+  const filled = layout === "tile" ? Boolean(shownPreview) : Boolean(shownName);
   const showClear = clearable && filled && !disabled;
   const insideHintId = inside && hasContent(hint) && !filled ? `${controlId}-hint` : void 0;
   const describedBy = [inside ? insideHintId : ids.hintId, errorId, input["aria-describedby"]].filter(Boolean).join(" ") || void 0;
-  const removeName = clearLabel != null ? clearLabel : variant === "tile" ? "Remover imagem" : "Remover arquivo";
+  const removeName = clearLabel != null ? clearLabel : layout === "tile" ? "Remover imagem" : "Remover arquivo";
   function change(event) {
     const files = event.target.files;
     if (!(files == null ? void 0 : files.length)) {
@@ -101,7 +104,7 @@ function FileInput(_a) {
     } else {
       const size = Array.from(files).reduce((sum, file) => sum + file.size, 0);
       const first = files[0];
-      const url = variant === "tile" && first.type.startsWith("image/") && typeof URL.createObjectURL === "function" ? URL.createObjectURL(first) : void 0;
+      const url = layout === "tile" && first.type.startsWith("image/") && typeof URL.createObjectURL === "function" ? URL.createObjectURL(first) : void 0;
       setChosen({ name: files.length === 1 ? first.name : `${files.length} arquivos`, size, url });
     }
     onChange == null ? void 0 : onChange(event);
@@ -149,14 +152,14 @@ function FileInput(_a) {
     },
     onDrop: drop
   };
-  const covered = !(variant === "tile" && filled);
+  const covered = !(layout === "tile" && filled);
   const control = /* @__PURE__ */ jsx(
     "input",
     __spreadProps(__spreadValues({}, input), {
       ref: setRef,
       id: controlId,
       type: "file",
-      accept: (_c = input.accept) != null ? _c : variant === "tile" ? "image/*" : void 0,
+      accept: (_d = input.accept) != null ? _d : layout === "tile" ? "image/*" : void 0,
       className: ["rds-field__control", "rds-file-input__control", !covered && "rds-file-input__control--off"].filter(Boolean).join(" "),
       tabIndex: covered ? input.tabIndex : -1,
       required,
@@ -168,7 +171,7 @@ function FileInput(_a) {
   );
   const clearButton = showClear && /* @__PURE__ */ jsx(FieldAction, { label: removeName, icon: /* @__PURE__ */ jsx(CloseIcon, {}), onClick: clear });
   let face;
-  if (variant === "dropzone") {
+  if (layout === "dropzone") {
     face = filled ? /* @__PURE__ */ jsxs("span", { className: "rds-file-input__file", children: [
       /* @__PURE__ */ jsx("span", { className: "rds-file-input__circle", "aria-hidden": "true", children: /* @__PURE__ */ jsx(PaperclipIcon, {}) }),
       /* @__PURE__ */ jsxs("span", { className: "rds-file-input__file-texts", "aria-hidden": "true", children: [
@@ -183,7 +186,7 @@ function FileInput(_a) {
         hasContent(hint) && /* @__PURE__ */ jsx("span", { id: insideHintId, className: "rds-file-input__caption", children: hint })
       ] })
     ] });
-  } else if (variant === "tile") {
+  } else if (layout === "tile") {
     face = filled ? /* @__PURE__ */ jsx("img", { className: "rds-file-input__preview", src: shownPreview, alt: previewAlt != null ? previewAlt : typeof label === "string" ? `Pr\xE9via de ${label}` : "Pr\xE9via" }) : /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsx("span", { className: "rds-file-input__tile-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsx(ImagePlusIcon, {}) }),
       /* @__PURE__ */ jsx("span", { className: "rds-file-input__tile-text", "aria-hidden": "true", children: tileText })
@@ -198,16 +201,16 @@ function FileInput(_a) {
     ] });
   }
   const boxClassName = [
-    variant === "field" && showClear && "rds-field__box--action",
-    variant === "dropzone" && "rds-file-input__area",
-    variant === "tile" && "rds-file-input__area rds-file-input__tile",
-    variant !== "field" && filled && "rds-file-input__area--filled",
-    variant !== "field" && dragging && "rds-file-input__area--dragging"
+    layout === "field" && showClear && "rds-field__box--action",
+    layout === "dropzone" && "rds-file-input__area",
+    layout === "tile" && "rds-file-input__area rds-file-input__tile",
+    layout !== "field" && filled && "rds-file-input__area--filled",
+    layout !== "field" && dragging && "rds-file-input__area--dragging"
   ].filter(Boolean).join(" ");
   return /* @__PURE__ */ jsxs(
     FieldShell,
     {
-      kind: `rds-file-input rds-file-input--${variant}`,
+      kind: `rds-file-input rds-file-input--${layout}`,
       controlId,
       hintId: inside ? void 0 : ids.hintId,
       errorId,
@@ -218,19 +221,19 @@ function FileInput(_a) {
       required,
       disabled,
       boxClassName: boxClassName || void 0,
-      boxProps: variant === "field" ? void 0 : boxProps,
+      boxProps: layout === "field" ? void 0 : boxProps,
       className,
       style,
       children: [
         face,
         control,
-        variant === "tile" ? filled && !disabled && /* @__PURE__ */ jsxs("span", { className: "rds-file-input__actions", children: [
+        layout === "tile" ? filled && !disabled && /* @__PURE__ */ jsxs("span", { className: "rds-file-input__actions", children: [
           /* @__PURE__ */ jsx(FieldAction, { label: replaceLabel, icon: /* @__PURE__ */ jsx(UploadIcon, {}), onClick: () => {
             var _a3;
             return (_a3 = own.current) == null ? void 0 : _a3.click();
           } }),
           clearButton
-        ] }) : variant === "field" && clearButton
+        ] }) : layout === "field" && clearButton
       ]
     }
   );

package/dist/components/filter-chip.d.ts

@@ -8,17 +8,23 @@ interface FilterChipProps extends Omit<ComponentPropsWithRef<'button'>, 'childre
     count?: ReactNode;
     /** An icon before the label, in the label's colour (Figma: `showIcon` + `icon`). Decorative. */
     icon?: ReactNode;
-    /** Controlled: the filter is on (Figma: state=active). */
-    active?: boolean;
+    /** Controlled: the filter is on (Figma: `pressed`), as the Toggle. */
+    pressed?: boolean;
     /** Uncontrolled: on at first. */
-    defaultActive?: boolean;
+    defaultPressed?: boolean;
     /** Called with the new state when the chip is pressed (a button, not a link). */
+    onPressedChange?: (pressed: boolean) => void;
+    /** @deprecated Use `pressed` (2.0.0-next). */
+    active?: boolean;
+    /** @deprecated Use `defaultPressed` (2.0.0-next). */
+    defaultActive?: boolean;
+    /** @deprecated Use `onPressedChange` (2.0.0-next). */
     onActiveChange?: (active: boolean) => void;
     /** Rendered as aria-disabled="true": stays in the tab order and takes focus, but does not turn on or navigate. */
     disabled?: boolean;
     /**
      * Render the single child element (an `<a>`, a framework `Link`) with the chip's classes, for a filter that
-     * lives in the URL and should survive back/forward. The link gets aria-current when active.
+     * lives in the URL and should survive back/forward. The link gets aria-current when pressed.
      */
     asChild?: boolean;
 }
@@ -28,7 +34,7 @@ interface FilterChipProps extends Omit<ComponentPropsWithRef<'button'>, 'childre
  * brand tint, brand border and label. Up to 5 in a FilterChipGroup; more than that, the Select. A value that can
  * be removed is the Chip. Styles: filter-chip.css.
  */
-declare function FilterChip({ children, count, icon, active, defaultActive, onActiveChange, disabled, asChild, type, className, onClick, ...rest }: FilterChipProps): react.JSX.Element;
+declare function FilterChip({ children, count, icon, pressed: pressedProp, defaultPressed, onPressedChange, active, defaultActive, onActiveChange, disabled, asChild, type, className, onClick, ...rest }: FilterChipProps): react.JSX.Element;
 interface FilterChipGroupProps extends HTMLAttributes<HTMLDivElement> {
     /** Required: what the filters cut, such as "Filtrar por tipo". Several groups on a page must be told apart. */
     'aria-label': string;

package/dist/components/filter-chip.js

@@ -13,8 +13,11 @@ function FilterChip(_a) {
     children,
     count,
     icon,
+    pressed: pressedProp,
+    defaultPressed,
+    onPressedChange,
     active,
-    defaultActive = false,
+    defaultActive,
     onActiveChange,
     disabled,
     asChild,
@@ -25,6 +28,9 @@ function FilterChip(_a) {
     "children",
     "count",
     "icon",
+    "pressed",
+    "defaultPressed",
+    "onPressedChange",
     "active",
     "defaultActive",
     "onActiveChange",
@@ -34,20 +40,23 @@ function FilterChip(_a) {
     "className",
     "onClick"
   ]);
-  const [own, setOwn] = useState(defaultActive);
-  const on = active != null ? active : own;
+  var _a2;
+  const pressed = pressedProp != null ? pressedProp : active;
+  const [own, setOwn] = useState((_a2 = defaultPressed != null ? defaultPressed : defaultActive) != null ? _a2 : false);
+  const on = pressed != null ? pressed : own;
   const Root = asChild ? Slot : "button";
   function click(event) {
+    var _a3;
     onClick == null ? void 0 : onClick(event);
     if (event.defaultPrevented || asChild) return;
-    if (active === void 0) setOwn(!on);
-    onActiveChange == null ? void 0 : onActiveChange(!on);
+    if (pressed === void 0) setOwn(!on);
+    (_a3 = onPressedChange != null ? onPressedChange : onActiveChange) == null ? void 0 : _a3(!on);
   }
   return /* @__PURE__ */ jsxs(
     Root,
     __spreadProps(__spreadValues({}, rest), {
       type: asChild ? void 0 : type,
-      className: ["rds-filter-chip", on && "rds-filter-chip--active", className].filter(Boolean).join(" "),
+      className: ["rds-filter-chip", on && "rds-filter-chip--pressed", className].filter(Boolean).join(" "),
       "aria-pressed": asChild ? void 0 : on,
       "aria-current": asChild && on ? "true" : void 0,
       "aria-disabled": disabled || void 0,

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 line (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,35 +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";
-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("span", { className: "rds-floating-stepper__divider", "aria-hidden": "true" }),
-      /* @__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/heading.d.ts

@@ -0,0 +1,42 @@
+import * as react from 'react';
+import { HTMLAttributes, ReactNode } from 'react';
+
+/** The [RDS] type scale for titles: band 36/48, heading 24/30, value 20/30. */
+type HeadingLevel = 'band' | 'heading' | 'value';
+/** neutral: text/heading (navy on light in Rojão, white on dark and on the brand plate). accent: the logo orange. */
+type HeadingTone = 'neutral' | 'accent';
+/** The element in the page outline. The visual level never decides it: the order of the page does. */
+type HeadingElement = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+interface HeadingProps extends HTMLAttributes<HTMLHeadingElement> {
+    /** The size, from the type scale (Figma `level`). */
+    level?: HeadingLevel;
+    /**
+     * The colour of the brand pair (Figma `tone`): neutral (default) or accent. The Mark takes the other one.
+     * `'default'` is deprecated (2.0.0-next): it is `'neutral'`.
+     */
+    tone?: HeadingTone | 'default';
+    /** The heading element. Default h2. */
+    as?: HeadingElement;
+    /** The text (Figma `text`), with an optional <Heading.Mark> stretch (Figma `showMark` + `mark`). */
+    children: ReactNode;
+}
+interface HeadingMarkProps extends HTMLAttributes<HTMLSpanElement> {
+    children: ReactNode;
+}
+/**
+ * Heading.Mark — Figma [RDS] .heading/mark. A stretch of the title in the other colour of the pair: accent inside a
+ * neutral Heading, neutral inside an accent one. A plain span: screen readers read the whole title, unannounced.
+ */
+declare function HeadingMark({ className, children, ...rest }: HeadingMarkProps): react.JSX.Element;
+/**
+ * Heading — Figma [RDS] Content/Heading. A title in the brand pair: one colour, or both in the same title with a
+ * Heading.Mark. The colour is chosen per screen; tone=neutral is the rule. Orange on white fails contrast even for
+ * a large title (2.9:1 in Rojão): tone=accent belongs on dark or on the brand plate. Styles: heading.css.
+ */
+declare function HeadingRoot({ level, tone, as: Tag, className, children, ...rest }: HeadingProps): react.JSX.Element;
+/** `<Heading>` with `<Heading.Mark>` for the stretch in the other colour. */
+declare const Heading: typeof HeadingRoot & {
+    Mark: typeof HeadingMark;
+};
+
+export { Heading, type HeadingElement, type HeadingLevel, HeadingMark, type HeadingMarkProps, type HeadingProps, type HeadingTone };

package/dist/components/heading.js

@@ -0,0 +1,25 @@
+import {
+  __objRest,
+  __spreadProps,
+  __spreadValues
+} from "../chunk-ORMEWXMH.js";
+import { jsx } from "react/jsx-runtime";
+function HeadingMark(_a) {
+  var _b = _a, { className, children } = _b, rest = __objRest(_b, ["className", "children"]);
+  return /* @__PURE__ */ jsx("span", __spreadProps(__spreadValues({}, rest), { className: ["rds-heading__mark", className].filter(Boolean).join(" "), children }));
+}
+function HeadingRoot(_c) {
+  var _d = _c, { level = "heading", tone = "neutral", as: Tag = "h2", className, children } = _d, rest = __objRest(_d, ["level", "tone", "as", "className", "children"]);
+  return /* @__PURE__ */ jsx(
+    Tag,
+    __spreadProps(__spreadValues({}, rest), {
+      className: ["rds-heading", `rds-heading--${level}`, tone === "accent" && "rds-heading--accent", className].filter(Boolean).join(" "),
+      children
+    })
+  );
+}
+const Heading = Object.assign(HeadingRoot, { Mark: HeadingMark });
+export {
+  Heading,
+  HeadingMark
+};

package/dist/components/icon-button.d.ts

@@ -9,7 +9,7 @@ interface IconButtonProps extends Omit<ComponentPropsWithRef<'button'>, 'childre
     label: string;
     /** Same tones as the Button. */
     tone?: ButtonTone;
-    /** Figma calls this property `style`. */
+    /** The emphasis (Figma: `variant`). */
     variant?: ButtonVariant;
     /**
      * The size of the square (Figma: `size`): sm 36 with a 16 icon, md 44 with a 20 icon (default), lg 52 with a 24

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 };