@fabio.caffarello/react-design-system 4.8.0 → 4.9.0

package/dist/ui/components/EmptyState/EmptyStateBase.d.ts

@@ -0,0 +1,52 @@
+import { type HTMLAttributes, type ReactNode } from "react";
+export interface EmptyStateBaseProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    title: string;
+    /**
+     * Descriptive message below the title. Optional — several empty states
+     * have only a title. When absent, `aria-label` is just the title and no
+     * `<p>` element is rendered.
+     */
+    message?: string;
+    /**
+     * Optional decorative illustration (icon, SVG, image). Rendered
+     * `aria-hidden` above the title.
+     */
+    illustration?: ReactNode;
+    /**
+     * Action slot — any ReactNode (link, button, custom CTA). Rendered
+     * below the message (or title when message is absent).
+     *
+     * Use a plain `<a href>` or `next/link` here to keep the component
+     * zero-JS in Server Components; the slot is passed through with no
+     * wrapper or event handler added.
+     *
+     * @example
+     * // Zero-JS link — Server Component safe
+     * <EmptyStateBase
+     *   title="Sem resultados"
+     *   action={<a href="/">Limpar filtros</a>}
+     * />
+     */
+    action?: ReactNode;
+}
+/**
+ * EmptyStateBase — the **server-safe presentational core** of `EmptyState`
+ * (issue #252 follow-up).
+ *
+ * It holds no React client state (no hooks, no `"use client"` directive), so
+ * it can be imported from `@fabio.caffarello/react-design-system/server` and
+ * rendered inside React Server Components and zero-JS routes.
+ *
+ * ### Trade-off vs `EmptyState`
+ *
+ * | Feature                      | EmptyStateBase       | EmptyState                  |
+ * |------------------------------|----------------------|-----------------------------|
+ * | `action` ReactNode slot      | ✅                   | ✅                          |
+ * | `onAction` callback button   | ❌ (needs client JS) | ✅                          |
+ * | `./server` exportable        | ✅                   | ❌ (barrel pulls Input/useId)|
+ *
+ * Use `EmptyState` when you need a client-driven callback button (`onAction`).
+ * Use `EmptyStateBase` in Server Components where the CTA is a zero-JS link.
+ */
+declare const EmptyStateBase: import("react").ForwardRefExoticComponent<EmptyStateBaseProps & import("react").RefAttributes<HTMLDivElement>>;
+export default EmptyStateBase;

package/dist/ui/components/EmptyState/index.d.ts

@@ -1,2 +1,4 @@
 export { default } from "./EmptyState";
 export type { EmptyStateProps } from "./EmptyState";
+export { default as EmptyStateBase } from "./EmptyStateBase";
+export type { EmptyStateBaseProps } from "./EmptyStateBase";

package/dist/ui/server.d.ts

@@ -31,6 +31,8 @@ export { Stack } from "./layouts/Stack/Stack";
 export type { StackProps } from "./layouts/Stack/Stack";
 export { default as Breadcrumb } from "./components/Breadcrumb/Breadcrumb";
 export type { BreadcrumbItem } from "./components/Breadcrumb/Breadcrumb";
+export { default as EmptyStateBase } from "./components/EmptyState/EmptyStateBase";
+export type { EmptyStateBaseProps } from "./components/EmptyState/EmptyStateBase";
 export { default as Card } from "./components/Card/Card";
 export type { CardProps } from "./components/Card/Card";
 export { CardHeader } from "./components/Card/CardHeader";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fabio.caffarello/react-design-system",
   "private": false,
-  "version": "4.8.0",
+  "version": "4.9.0",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",