@epicbagel/saas-kit 0.0.0-stage → 1.1.0

package/dist/primitives/resource-card.cjs

@@ -0,0 +1,104 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+
+
+var _chunkBEJJN2SYcjs = require('../chunk-BEJJN2SY.cjs');
+
+
+var _chunkKWLSBTB2cjs = require('../chunk-KWLSBTB2.cjs');
+
+// src/primitives/resource-card.tsx
+var _jsxruntime = require('react/jsx-runtime');
+function ResourceCard({
+  className,
+  children,
+  tone = "default",
+  scrollAnchor = false,
+  interaction = "default",
+  ...props
+}) {
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    "div",
+    {
+      className: _chunkKWLSBTB2cjs.cn.call(void 0, 
+        // The same universal treatment as every other interactive card in the
+        // kit. `interaction` is intentionally ignored: contexts cannot select
+        // their own hover styling.
+        _chunkBEJJN2SYcjs.interactiveCardClass.call(void 0, ),
+        // ResourceCard is a div wrapping a consumer-provided link, so the ring
+        // has to come from focus WITHIN rather than from the card itself.
+        // `overflow-hidden` is this card's own: its header/body/footer dividers
+        // run to the edge and need clipping by the rounded border.
+        "overflow-hidden rounded-lg focus-within:border-foreground/40 focus-within:ring-2 focus-within:ring-ring",
+        tone === "muted" && "opacity-60",
+        scrollAnchor && "scroll-mt-24",
+        className
+      ),
+      ...props,
+      children
+    }
+  );
+}
+function ResourceCardHeader({
+  media,
+  title,
+  subtitle,
+  meta,
+  className
+}) {
+  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
+    "div",
+    {
+      className: _chunkKWLSBTB2cjs.cn.call(void 0, 
+        "flex items-start justify-between gap-3 p-4",
+        className
+      ),
+      children: [
+        media && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "shrink-0", children: media }),
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "min-w-0 flex-1", children: [
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "font-medium truncate", children: title }),
+          subtitle && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "text-sm text-muted-foreground truncate mt-0.5", children: subtitle })
+        ] }),
+        meta && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "shrink-0 text-xs text-muted-foreground/70", children: meta })
+      ]
+    }
+  );
+}
+function ResourceCardBody({
+  className,
+  children,
+  paddingBottom = "none"
+}) {
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    "div",
+    {
+      className: _chunkKWLSBTB2cjs.cn.call(void 0, "border-t border-border px-4", paddingBottom === "default" && "pb-4", className),
+      children
+    }
+  );
+}
+function ResourceCardFooter({
+  className,
+  align = "end",
+  wrap = false,
+  children
+}) {
+  const justify = align === "start" ? "justify-start" : align === "between" ? "justify-between" : "justify-end";
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    "div",
+    {
+      className: _chunkKWLSBTB2cjs.cn.call(void 0, 
+        "border-t border-border px-3 py-2 flex items-center gap-1",
+        justify,
+        wrap && "flex-wrap",
+        className
+      ),
+      children
+    }
+  );
+}
+
+
+
+
+
+exports.ResourceCard = ResourceCard; exports.ResourceCardBody = ResourceCardBody; exports.ResourceCardFooter = ResourceCardFooter; exports.ResourceCardHeader = ResourceCardHeader;

package/dist/primitives/resource-card.d.cts

@@ -0,0 +1,93 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { HTMLAttributes, ReactNode } from 'react';
+
+/**
+ * The "list-item summary card" pattern, packaged. Composes a
+ * clickable header + body region with a footer-action row, and
+ * handles the visual chrome (border, hover, focus ring, dividers)
+ * in one place so every list across every app reads the same.
+ *
+ * Why three sub-components instead of one big prop bag:
+ *   - `<Link>` (consumer-provided) wraps Header + Body so the whole
+ *     summary area is the nav target. Footer sits OUTSIDE the link
+ *     so action buttons inside it (Delete, Cancel, etc.) don't also
+ *     trigger navigation — no stopPropagation gymnastics required.
+ *   - Body content varies wildly across apps (DefinitionList,
+ *     plain text, custom). Slot keeps the primitive flexible.
+ *   - Footer is opt-in; cards without actions render header + body
+ *     only and skip the divider.
+ *
+ * Typical shape:
+ *
+ *   <ResourceCard>
+ *     <Link href={...}>
+ *       <ResourceCardHeader title="…" subtitle="…" />
+ *       <ResourceCardBody>
+ *         <DefinitionList>…</DefinitionList>
+ *       </ResourceCardBody>
+ *     </Link>
+ *     <ResourceCardFooter>
+ *       <Button>Delete</Button>
+ *     </ResourceCardFooter>
+ *   </ResourceCard>
+ *
+ * Drop the Link wrapper for a non-navigable card (display-only).
+ */
+interface ResourceCardProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+    tone?: "default" | "muted";
+    scrollAnchor?: boolean;
+    /**
+     * @deprecated Resource cards now have one universal border-only treatment.
+     * Retained as a no-op so existing consumers do not break during migration.
+     */
+    interaction?: "default" | "border";
+}
+declare function ResourceCard({ className, children, tone, scrollAnchor, interaction, ...props }: ResourceCardProps): react_jsx_runtime.JSX.Element;
+interface ResourceCardHeaderProps {
+    /** Optional leading avatar, logo or icon. Sized by the consumer. */
+    media?: ReactNode;
+    title: ReactNode;
+    /** Muted line under the title — typically "For X" / "Created Y". */
+    subtitle?: ReactNode;
+    /**
+     * Right-aligned shrink-0 region. Use sparingly for a small badge
+     * or status pip; large content here clashes with the title.
+     */
+    meta?: ReactNode;
+    className?: string;
+}
+declare function ResourceCardHeader({ media, title, subtitle, meta, className, }: ResourceCardHeaderProps): react_jsx_runtime.JSX.Element;
+interface ResourceCardBodyProps {
+    className?: string;
+    children: ReactNode;
+    paddingBottom?: "none" | "default";
+}
+/**
+ * Mid-card content. Owns the divider above + the standard
+ * horizontal padding so consumers can drop a DefinitionList or
+ * arbitrary children without worrying about alignment with the
+ * header/footer.
+ */
+declare function ResourceCardBody({ className, children, paddingBottom, }: ResourceCardBodyProps): react_jsx_runtime.JSX.Element;
+interface ResourceCardFooterProps {
+    className?: string;
+    /**
+     * Where actions sit horizontally. Defaults to `"end"` (right-
+     * aligned) because most card footers are 1–2 destructive /
+     * secondary actions. Use `"between"` when the row pairs a
+     * left-leaning meta label with right-leaning actions.
+     */
+    align?: "start" | "end" | "between";
+    wrap?: boolean;
+    children: ReactNode;
+}
+/**
+ * Action row at the bottom of a ResourceCard. Sits OUTSIDE any
+ * `<Link>` wrapper so its buttons don't double-trigger as
+ * navigation. Owns the divider above + tight vertical padding —
+ * actions should feel attached to the card, not floating below it.
+ */
+declare function ResourceCardFooter({ className, align, wrap, children, }: ResourceCardFooterProps): react_jsx_runtime.JSX.Element;
+
+export { ResourceCard, ResourceCardBody, type ResourceCardBodyProps, ResourceCardFooter, type ResourceCardFooterProps, ResourceCardHeader, type ResourceCardHeaderProps, type ResourceCardProps };

package/dist/primitives/resource-card.d.ts

@@ -0,0 +1,93 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { HTMLAttributes, ReactNode } from 'react';
+
+/**
+ * The "list-item summary card" pattern, packaged. Composes a
+ * clickable header + body region with a footer-action row, and
+ * handles the visual chrome (border, hover, focus ring, dividers)
+ * in one place so every list across every app reads the same.
+ *
+ * Why three sub-components instead of one big prop bag:
+ *   - `<Link>` (consumer-provided) wraps Header + Body so the whole
+ *     summary area is the nav target. Footer sits OUTSIDE the link
+ *     so action buttons inside it (Delete, Cancel, etc.) don't also
+ *     trigger navigation — no stopPropagation gymnastics required.
+ *   - Body content varies wildly across apps (DefinitionList,
+ *     plain text, custom). Slot keeps the primitive flexible.
+ *   - Footer is opt-in; cards without actions render header + body
+ *     only and skip the divider.
+ *
+ * Typical shape:
+ *
+ *   <ResourceCard>
+ *     <Link href={...}>
+ *       <ResourceCardHeader title="…" subtitle="…" />
+ *       <ResourceCardBody>
+ *         <DefinitionList>…</DefinitionList>
+ *       </ResourceCardBody>
+ *     </Link>
+ *     <ResourceCardFooter>
+ *       <Button>Delete</Button>
+ *     </ResourceCardFooter>
+ *   </ResourceCard>
+ *
+ * Drop the Link wrapper for a non-navigable card (display-only).
+ */
+interface ResourceCardProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+    tone?: "default" | "muted";
+    scrollAnchor?: boolean;
+    /**
+     * @deprecated Resource cards now have one universal border-only treatment.
+     * Retained as a no-op so existing consumers do not break during migration.
+     */
+    interaction?: "default" | "border";
+}
+declare function ResourceCard({ className, children, tone, scrollAnchor, interaction, ...props }: ResourceCardProps): react_jsx_runtime.JSX.Element;
+interface ResourceCardHeaderProps {
+    /** Optional leading avatar, logo or icon. Sized by the consumer. */
+    media?: ReactNode;
+    title: ReactNode;
+    /** Muted line under the title — typically "For X" / "Created Y". */
+    subtitle?: ReactNode;
+    /**
+     * Right-aligned shrink-0 region. Use sparingly for a small badge
+     * or status pip; large content here clashes with the title.
+     */
+    meta?: ReactNode;
+    className?: string;
+}
+declare function ResourceCardHeader({ media, title, subtitle, meta, className, }: ResourceCardHeaderProps): react_jsx_runtime.JSX.Element;
+interface ResourceCardBodyProps {
+    className?: string;
+    children: ReactNode;
+    paddingBottom?: "none" | "default";
+}
+/**
+ * Mid-card content. Owns the divider above + the standard
+ * horizontal padding so consumers can drop a DefinitionList or
+ * arbitrary children without worrying about alignment with the
+ * header/footer.
+ */
+declare function ResourceCardBody({ className, children, paddingBottom, }: ResourceCardBodyProps): react_jsx_runtime.JSX.Element;
+interface ResourceCardFooterProps {
+    className?: string;
+    /**
+     * Where actions sit horizontally. Defaults to `"end"` (right-
+     * aligned) because most card footers are 1–2 destructive /
+     * secondary actions. Use `"between"` when the row pairs a
+     * left-leaning meta label with right-leaning actions.
+     */
+    align?: "start" | "end" | "between";
+    wrap?: boolean;
+    children: ReactNode;
+}
+/**
+ * Action row at the bottom of a ResourceCard. Sits OUTSIDE any
+ * `<Link>` wrapper so its buttons don't double-trigger as
+ * navigation. Owns the divider above + tight vertical padding —
+ * actions should feel attached to the card, not floating below it.
+ */
+declare function ResourceCardFooter({ className, align, wrap, children, }: ResourceCardFooterProps): react_jsx_runtime.JSX.Element;
+
+export { ResourceCard, ResourceCardBody, type ResourceCardBodyProps, ResourceCardFooter, type ResourceCardFooterProps, ResourceCardHeader, type ResourceCardHeaderProps, type ResourceCardProps };

package/dist/primitives/resource-card.js

@@ -0,0 +1,104 @@
+"use client";
+import {
+  interactiveCardClass
+} from "../chunk-F73ONTCK.js";
+import {
+  cn
+} from "../chunk-G6SRSWXB.js";
+
+// src/primitives/resource-card.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function ResourceCard({
+  className,
+  children,
+  tone = "default",
+  scrollAnchor = false,
+  interaction = "default",
+  ...props
+}) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: cn(
+        // The same universal treatment as every other interactive card in the
+        // kit. `interaction` is intentionally ignored: contexts cannot select
+        // their own hover styling.
+        interactiveCardClass(),
+        // ResourceCard is a div wrapping a consumer-provided link, so the ring
+        // has to come from focus WITHIN rather than from the card itself.
+        // `overflow-hidden` is this card's own: its header/body/footer dividers
+        // run to the edge and need clipping by the rounded border.
+        "overflow-hidden rounded-lg focus-within:border-foreground/40 focus-within:ring-2 focus-within:ring-ring",
+        tone === "muted" && "opacity-60",
+        scrollAnchor && "scroll-mt-24",
+        className
+      ),
+      ...props,
+      children
+    }
+  );
+}
+function ResourceCardHeader({
+  media,
+  title,
+  subtitle,
+  meta,
+  className
+}) {
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        "flex items-start justify-between gap-3 p-4",
+        className
+      ),
+      children: [
+        media && /* @__PURE__ */ jsx("div", { className: "shrink-0", children: media }),
+        /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1", children: [
+          /* @__PURE__ */ jsx("div", { className: "font-medium truncate", children: title }),
+          subtitle && /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground truncate mt-0.5", children: subtitle })
+        ] }),
+        meta && /* @__PURE__ */ jsx("div", { className: "shrink-0 text-xs text-muted-foreground/70", children: meta })
+      ]
+    }
+  );
+}
+function ResourceCardBody({
+  className,
+  children,
+  paddingBottom = "none"
+}) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: cn("border-t border-border px-4", paddingBottom === "default" && "pb-4", className),
+      children
+    }
+  );
+}
+function ResourceCardFooter({
+  className,
+  align = "end",
+  wrap = false,
+  children
+}) {
+  const justify = align === "start" ? "justify-start" : align === "between" ? "justify-between" : "justify-end";
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: cn(
+        "border-t border-border px-3 py-2 flex items-center gap-1",
+        justify,
+        wrap && "flex-wrap",
+        className
+      ),
+      children
+    }
+  );
+}
+export {
+  ResourceCard,
+  ResourceCardBody,
+  ResourceCardFooter,
+  ResourceCardHeader
+};

package/dist/primitives/resource-list.cjs

@@ -0,0 +1,28 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+"use client";
+
+
+var _chunkIH3COANJcjs = require('../chunk-IH3COANJ.cjs');
+require('../chunk-PNWNU6JW.cjs');
+require('../chunk-FNDBM67K.cjs');
+require('../chunk-SGW4FWBX.cjs');
+require('../chunk-PPX2VPGI.cjs');
+require('../chunk-WNXVGUBF.cjs');
+require('../chunk-IQZLUT2Y.cjs');
+require('../chunk-LELBCBDT.cjs');
+require('../chunk-R5L4CM6V.cjs');
+require('../chunk-U2NES7VR.cjs');
+require('../chunk-JH4GAGOQ.cjs');
+require('../chunk-YYFVG5A6.cjs');
+require('../chunk-XLIAY56V.cjs');
+require('../chunk-V5SPFLKW.cjs');
+require('../chunk-PQUSJEXL.cjs');
+require('../chunk-VGTINL5Q.cjs');
+require('../chunk-I6GUOEBO.cjs');
+require('../chunk-VBPPFC7X.cjs');
+require('../chunk-L4DH72UF.cjs');
+require('../chunk-R35FT53G.cjs');
+require('../chunk-KWLSBTB2.cjs');
+
+
+exports.ResourceList = _chunkIH3COANJcjs.ResourceList;

package/dist/primitives/resource-list.d.cts

@@ -0,0 +1,103 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { FilterDefinition } from '../lib/filter-types.cjs';
+import { QuickFilter, QuickFiltersAppearance } from './quick-filters.cjs';
+import { BoardColumn } from './board-view-internals.cjs';
+
+interface BoardConfig<T> {
+    columns: BoardColumn[];
+    getColumnId: (_item: T) => string;
+    getItemId: (_item: T) => string | number;
+    renderCard: (_item: T, _columnId: string) => React.ReactNode;
+    renderColumnHeader?: (_column: BoardColumn, _items: T[]) => React.ReactNode;
+    renderColumnEmpty?: (_column: BoardColumn) => React.ReactNode;
+    onMove?: (_itemId: string | number, _fromColumn: string, _toColumn: string) => void;
+    columnWidth?: string;
+    columnMinHeight?: string;
+    viewport?: "auto" | "bounded";
+}
+interface ResourceListProps<T> {
+    data: T[] | undefined;
+    loading: boolean;
+    error: any;
+    refetch: () => void;
+    filterSchema: FilterDefinition[];
+    filters: Record<string, any>;
+    onFiltersChange: (_filters: Record<string, any>) => void;
+    quickFilters?: QuickFilter[];
+    /** Hide the "Quick filters:" label on the quick-filters row. */
+    quickFiltersShowLabel?: boolean;
+    /** Visual treatment for quick filters. Defaults to the compact surface. */
+    quickFiltersAppearance?: QuickFiltersAppearance;
+    searchTerm?: string;
+    onSearchChange?: (_searchTerm: string) => void;
+    enableServerSearch?: boolean;
+    searchFields?: string[];
+    searchPredicate?: (_item: T, _query: string) => boolean;
+    filterPredicate?: (_item: T, _filters: Record<string, any>) => boolean;
+    renderItem: (_item: T, _index: number) => React.ReactNode;
+    renderTable?: (_items: T[]) => React.ReactNode;
+    renderEmpty?: () => React.ReactNode;
+    renderLoading?: () => React.ReactNode;
+    renderError?: (_error: any) => React.ReactNode;
+    title: string;
+    showTitle?: boolean;
+    totalCount?: number;
+    searchPlaceholder?: string;
+    showSearch?: boolean;
+    showFilters?: boolean;
+    showViewToggle?: boolean;
+    /** Height and padding for the search/action toolbar. Defaults to roomy 48px controls. */
+    toolbarSize?: "compact" | "roomy";
+    /** Suppress search/filter chrome when the backing collection is truly empty. */
+    hideControlsWhenEmpty?: boolean;
+    viewMode?: "card" | "table" | "board";
+    onViewModeChange?: (_mode: "card" | "table" | "board") => void;
+    boardConfig?: BoardConfig<T>;
+    actions?: React.ReactNode;
+    filterActions?: React.ReactNode;
+    sortOptions?: any[];
+    sortValue?: string;
+    onSortChange?: (_value: string) => void;
+    className?: string;
+    containerClassName?: string;
+    cardGridClassName?: string;
+    showPagination?: boolean;
+    currentPage?: number;
+    onPreviousPage?: () => void;
+    onNextPage?: () => void;
+    useCompactSearch?: boolean;
+    /**
+     * Layout shape.
+     *
+     * - `"panel"` (default) — admin-shell layout: full-height flex
+     *   container, padded `p-4 border-b` header, and a fixed-height
+     *   ScrollArea around the content. Use when the list IS the page,
+     *   inside an app shell that owns the chrome.
+     * - `"flush"` — inline layout: no padded header wrapper, no
+     *   ScrollArea, no enforced height. Header controls (search +
+     *   filters) sit flush with the page's own padding; content flows
+     *   in normal document order. Use when the list is one block on a
+     *   page that already has its own container and other sections
+     *   above/below.
+     */
+    variant?: "panel" | "flush";
+    /**
+     * Cursor-style "load more" footer below the content. Pair with a
+     * server action that appends the next page to `data`. The parent
+     * still owns the list — this is just the button. `hasMore` toggles
+     * between the button and the "all caught up" line. Omit entirely
+     * to suppress (useful when `showPagination` page-based controls
+     * are in use instead).
+     */
+    loadMore?: {
+        onClick: () => void;
+        hasMore: boolean;
+        loading?: boolean;
+        label?: React.ReactNode;
+        loadingLabel?: React.ReactNode;
+        doneLabel?: React.ReactNode;
+    };
+}
+declare function ResourceList<T>({ data, loading, error, refetch: _refetch, filterSchema, filters, onFiltersChange, quickFilters, quickFiltersAppearance, searchTerm: externalSearchTerm, onSearchChange, enableServerSearch, searchFields, searchPredicate, filterPredicate, renderItem, renderTable, renderEmpty, renderLoading, renderError, title, showTitle, totalCount, searchPlaceholder, showSearch, showFilters, showViewToggle, toolbarSize, hideControlsWhenEmpty, quickFiltersShowLabel, viewMode, onViewModeChange, boardConfig, actions, filterActions, sortOptions, sortValue, onSortChange, className, containerClassName, cardGridClassName, showPagination, currentPage, onPreviousPage, onNextPage, useCompactSearch, variant, loadMore, }: ResourceListProps<T>): react_jsx_runtime.JSX.Element;
+
+export { BoardColumn, type BoardConfig, ResourceList };

package/dist/primitives/resource-list.d.ts

@@ -0,0 +1,103 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { FilterDefinition } from '../lib/filter-types.js';
+import { QuickFilter, QuickFiltersAppearance } from './quick-filters.js';
+import { BoardColumn } from './board-view-internals.js';
+
+interface BoardConfig<T> {
+    columns: BoardColumn[];
+    getColumnId: (_item: T) => string;
+    getItemId: (_item: T) => string | number;
+    renderCard: (_item: T, _columnId: string) => React.ReactNode;
+    renderColumnHeader?: (_column: BoardColumn, _items: T[]) => React.ReactNode;
+    renderColumnEmpty?: (_column: BoardColumn) => React.ReactNode;
+    onMove?: (_itemId: string | number, _fromColumn: string, _toColumn: string) => void;
+    columnWidth?: string;
+    columnMinHeight?: string;
+    viewport?: "auto" | "bounded";
+}
+interface ResourceListProps<T> {
+    data: T[] | undefined;
+    loading: boolean;
+    error: any;
+    refetch: () => void;
+    filterSchema: FilterDefinition[];
+    filters: Record<string, any>;
+    onFiltersChange: (_filters: Record<string, any>) => void;
+    quickFilters?: QuickFilter[];
+    /** Hide the "Quick filters:" label on the quick-filters row. */
+    quickFiltersShowLabel?: boolean;
+    /** Visual treatment for quick filters. Defaults to the compact surface. */
+    quickFiltersAppearance?: QuickFiltersAppearance;
+    searchTerm?: string;
+    onSearchChange?: (_searchTerm: string) => void;
+    enableServerSearch?: boolean;
+    searchFields?: string[];
+    searchPredicate?: (_item: T, _query: string) => boolean;
+    filterPredicate?: (_item: T, _filters: Record<string, any>) => boolean;
+    renderItem: (_item: T, _index: number) => React.ReactNode;
+    renderTable?: (_items: T[]) => React.ReactNode;
+    renderEmpty?: () => React.ReactNode;
+    renderLoading?: () => React.ReactNode;
+    renderError?: (_error: any) => React.ReactNode;
+    title: string;
+    showTitle?: boolean;
+    totalCount?: number;
+    searchPlaceholder?: string;
+    showSearch?: boolean;
+    showFilters?: boolean;
+    showViewToggle?: boolean;
+    /** Height and padding for the search/action toolbar. Defaults to roomy 48px controls. */
+    toolbarSize?: "compact" | "roomy";
+    /** Suppress search/filter chrome when the backing collection is truly empty. */
+    hideControlsWhenEmpty?: boolean;
+    viewMode?: "card" | "table" | "board";
+    onViewModeChange?: (_mode: "card" | "table" | "board") => void;
+    boardConfig?: BoardConfig<T>;
+    actions?: React.ReactNode;
+    filterActions?: React.ReactNode;
+    sortOptions?: any[];
+    sortValue?: string;
+    onSortChange?: (_value: string) => void;
+    className?: string;
+    containerClassName?: string;
+    cardGridClassName?: string;
+    showPagination?: boolean;
+    currentPage?: number;
+    onPreviousPage?: () => void;
+    onNextPage?: () => void;
+    useCompactSearch?: boolean;
+    /**
+     * Layout shape.
+     *
+     * - `"panel"` (default) — admin-shell layout: full-height flex
+     *   container, padded `p-4 border-b` header, and a fixed-height
+     *   ScrollArea around the content. Use when the list IS the page,
+     *   inside an app shell that owns the chrome.
+     * - `"flush"` — inline layout: no padded header wrapper, no
+     *   ScrollArea, no enforced height. Header controls (search +
+     *   filters) sit flush with the page's own padding; content flows
+     *   in normal document order. Use when the list is one block on a
+     *   page that already has its own container and other sections
+     *   above/below.
+     */
+    variant?: "panel" | "flush";
+    /**
+     * Cursor-style "load more" footer below the content. Pair with a
+     * server action that appends the next page to `data`. The parent
+     * still owns the list — this is just the button. `hasMore` toggles
+     * between the button and the "all caught up" line. Omit entirely
+     * to suppress (useful when `showPagination` page-based controls
+     * are in use instead).
+     */
+    loadMore?: {
+        onClick: () => void;
+        hasMore: boolean;
+        loading?: boolean;
+        label?: React.ReactNode;
+        loadingLabel?: React.ReactNode;
+        doneLabel?: React.ReactNode;
+    };
+}
+declare function ResourceList<T>({ data, loading, error, refetch: _refetch, filterSchema, filters, onFiltersChange, quickFilters, quickFiltersAppearance, searchTerm: externalSearchTerm, onSearchChange, enableServerSearch, searchFields, searchPredicate, filterPredicate, renderItem, renderTable, renderEmpty, renderLoading, renderError, title, showTitle, totalCount, searchPlaceholder, showSearch, showFilters, showViewToggle, toolbarSize, hideControlsWhenEmpty, quickFiltersShowLabel, viewMode, onViewModeChange, boardConfig, actions, filterActions, sortOptions, sortValue, onSortChange, className, containerClassName, cardGridClassName, showPagination, currentPage, onPreviousPage, onNextPage, useCompactSearch, variant, loadMore, }: ResourceListProps<T>): react_jsx_runtime.JSX.Element;
+
+export { BoardColumn, type BoardConfig, ResourceList };

package/dist/primitives/resource-list.js

@@ -0,0 +1,28 @@
+"use client";
+"use client";
+import {
+  ResourceList
+} from "../chunk-HRLP4BHJ.js";
+import "../chunk-LI5EOSQG.js";
+import "../chunk-J3GQXM37.js";
+import "../chunk-MLHNYRFX.js";
+import "../chunk-G76JANB4.js";
+import "../chunk-YG7FBJRM.js";
+import "../chunk-E2TQMDO7.js";
+import "../chunk-H2O6NMLZ.js";
+import "../chunk-RRRD5EUI.js";
+import "../chunk-ZRLUUZHK.js";
+import "../chunk-OICAYRVH.js";
+import "../chunk-62UTAG2C.js";
+import "../chunk-LELFPLTE.js";
+import "../chunk-J6NXDZR5.js";
+import "../chunk-QMA3WVB7.js";
+import "../chunk-H7TETFLB.js";
+import "../chunk-D4ZL2OEQ.js";
+import "../chunk-YEW65ASC.js";
+import "../chunk-HQRWRRZJ.js";
+import "../chunk-PIU5SSUV.js";
+import "../chunk-G6SRSWXB.js";
+export {
+  ResourceList
+};