@iamsaroj/smart-ui 0.2.0

package/dist/search-engine/smart-search-form.d.ts

@@ -0,0 +1,92 @@
+import * as React from "react";
+import { z } from "zod";
+import { type FieldRegistry } from "@iamsaroj/smart-ui/form-engine";
+import type { SearchFieldDefinition } from "./types";
+export interface SmartSearchFormProps<T extends Record<string, unknown>> {
+    /** Search fields — same shape as form-engine fields, narrowed to search controls. */
+    fields: SearchFieldDefinition<T>[];
+    /**
+     * Zod schema — validated before a search fires. Optional: with no schema every
+     * value is accepted. When present, required-ness / the asterisk derive from it.
+     */
+    schema?: z.ZodType<T>;
+    /** Controlled search state. Own it in the parent to wire URL-sync or presets. */
+    data?: T;
+    /** Kept in sync with every field edit. */
+    setData?: (data: T) => void;
+    /**
+     * The empty state Reset returns to. Defaults to each field type's blank value
+     * (from the registry), so you rarely need to pass it.
+     */
+    defaultValues?: T;
+    /** Grid columns on desktop. Collapses responsively (2 on tablet, 1 on mobile). Default `1`. */
+    columns?: 1 | 2 | 3 | 4;
+    /**
+     * Manual search: show the Search button and only emit on submit / Enter.
+     * Default `true`. Pass `search={false}` (or {@link autoSearch}) for auto mode.
+     */
+    search?: boolean;
+    /**
+     * Auto search: emit automatically (debounced) whenever a filter changes, with
+     * no Search button. Takes precedence over {@link search}.
+     */
+    autoSearch?: boolean;
+    /** Debounce for auto search, in ms. Default `400`. */
+    debounce?: number;
+    /** Show the Reset button. Default `true`. */
+    reset?: boolean;
+    /** In manual mode, also run the search after a reset. Default `false`. */
+    searchOnReset?: boolean;
+    /** Called with the pruned, validated query — only meaningful values. */
+    onSearch?: (query: Partial<T>) => void;
+    /** Alias of {@link onSearch} to match the `<SForm onSubmit>` convention. */
+    onSubmit?: (query: Partial<T>) => void;
+    /** Called after fields are cleared to their defaults. */
+    onReset?: () => void;
+    /** Show a spinner + disable actions while a search is in flight. */
+    loading?: boolean;
+    /** Show a badge with the active-filter count on the Search button. */
+    showCount?: boolean;
+    searchLabel?: React.ReactNode;
+    resetLabel?: React.ReactNode;
+    /** Extra controls rendered at the start of the action bar (before Reset). */
+    actions?: React.ReactNode;
+    /** Custom field registry, merged over the built-in one (e.g. async selects). */
+    registry?: FieldRegistry;
+    className?: string;
+}
+/**
+ * A declarative, reusable **search / filter bar** built on {@link SmartForm}.
+ * Supply the fields (and optionally a Zod schema) and it renders the right
+ * control per filter, validates, prunes empty values into a clean query, and
+ * emits it — either on demand (manual) or automatically as filters change.
+ *
+ * ```tsx
+ * // Manual — search on click / Enter
+ * <SmartSearchForm
+ *   data={search}
+ *   setData={setSearch}
+ *   fields={searchFields}
+ *   schema={searchSchema}
+ *   columns={4}
+ *   reset
+ *   onSearch={(query) => setFilters(toFilters(query))}
+ * />
+ *
+ * // Auto — debounced search as you type
+ * <SmartSearchForm data={search} setData={setSearch} fields={searchFields} autoSearch />
+ * ```
+ *
+ * @remarks
+ * Composes `SmartForm` rather than reimplementing it, so validation, required
+ * derivation, layout, and error display are shared. Keep `data`/`setData` in the
+ * parent to layer URL synchronization, saved searches, or filter presets on top
+ * without changes here.
+ */
+export declare const SmartSearchForm: <T extends Record<string, unknown>>({ fields, schema, data, setData, defaultValues, columns, search, autoSearch, debounce, reset, searchOnReset, onSearch, onSubmit, onReset, loading, showCount, searchLabel, resetLabel, actions, registry, className, }: SmartSearchFormProps<T>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Alias of {@link SmartSearchForm}. Provided so `<SearchEngine … />` reads
+ * naturally at call sites that think in terms of a "search engine" block.
+ */
+export declare const SearchEngine: <T extends Record<string, unknown>>({ fields, schema, data, setData, defaultValues, columns, search, autoSearch, debounce, reset, searchOnReset, onSearch, onSubmit, onReset, loading, showCount, searchLabel, resetLabel, actions, registry, className, }: SmartSearchFormProps<T>) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=smart-search-form.d.ts.map

package/dist/search-engine/smart-search-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-search-form.d.ts","sourceRoot":"","sources":["../../src/search-engine/smart-search-form.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,gCAAgC,CAAA;AAEvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAmBpD,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE,qFAAqF;IACrF,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAA;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACrB,iFAAiF;IACjF,IAAI,CAAC,EAAE,CAAC,CAAA;IACR,0CAA0C;IAC1C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,CAAA;IACjB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAEvB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,0EAA0E;IAC1E,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IACtC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IACtC,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAEpB,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sEAAsE;IACtE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC5B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAEzB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,wNAsBhE,oBAAoB,CAAC,CAAC,CAAC,4CAgIzB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,GA5JO,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,0NAsB9D,oBAAoB,CAAC,CAAC,CAAC,4CAsIiB,CAAA"}

package/dist/search-engine/smart-search-form.js

@@ -0,0 +1,136 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { z } from "zod";
+import { Loader2, RotateCcw, Search } from "lucide-react";
+import { cn } from "@iamsaroj/smart-ui/lib/utils";
+import { Button } from "@iamsaroj/smart-ui/components/button";
+import { Badge } from "@iamsaroj/smart-ui/components/badge";
+import { SmartForm, defaultFieldRegistry, } from "@iamsaroj/smart-ui/form-engine";
+import { buildSearchQuery, countActiveFilters } from "./build-query";
+/** Loose fallback schema when the consumer supplies none — validates nothing. */
+const PASSTHROUGH_SCHEMA = z.looseObject({});
+/**
+ * Responsive column classes per `columns` setting. Unlike SmartForm's fixed
+ * grid, a search bar should collapse on smaller screens: one column on mobile,
+ * two on tablet, the requested count on desktop. Passed as SmartForm's
+ * `className`, where tailwind-merge lets it override the fixed `grid-cols-*`.
+ */
+const RESPONSIVE_COLS = {
+    1: "grid-cols-1",
+    2: "grid-cols-1 sm:grid-cols-2",
+    3: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-3",
+    4: "grid-cols-1 sm:grid-cols-2 lg:grid-cols-4",
+};
+/**
+ * A declarative, reusable **search / filter bar** built on {@link SmartForm}.
+ * Supply the fields (and optionally a Zod schema) and it renders the right
+ * control per filter, validates, prunes empty values into a clean query, and
+ * emits it — either on demand (manual) or automatically as filters change.
+ *
+ * ```tsx
+ * // Manual — search on click / Enter
+ * <SmartSearchForm
+ *   data={search}
+ *   setData={setSearch}
+ *   fields={searchFields}
+ *   schema={searchSchema}
+ *   columns={4}
+ *   reset
+ *   onSearch={(query) => setFilters(toFilters(query))}
+ * />
+ *
+ * // Auto — debounced search as you type
+ * <SmartSearchForm data={search} setData={setSearch} fields={searchFields} autoSearch />
+ * ```
+ *
+ * @remarks
+ * Composes `SmartForm` rather than reimplementing it, so validation, required
+ * derivation, layout, and error display are shared. Keep `data`/`setData` in the
+ * parent to layer URL synchronization, saved searches, or filter presets on top
+ * without changes here.
+ */
+export const SmartSearchForm = ({ fields, schema, data, setData, defaultValues, columns = 1, search = true, autoSearch, debounce = 400, reset = true, searchOnReset = false, onSearch, onSubmit, onReset, loading = false, showCount = false, searchLabel = "Search", resetLabel = "Reset", actions, registry, className, }) => {
+    const auto = autoSearch === true || !search;
+    const emitFn = onSearch ?? onSubmit;
+    // The blank state a Reset returns to: each field type's registry default,
+    // overlaid with any explicit `defaultValues`.
+    const defaults = React.useMemo(() => {
+        const reg = registry ?? defaultFieldRegistry;
+        const base = {};
+        for (const field of fields)
+            base[field.name] = reg[field.type]?.defaultValue;
+        return { ...base, ...defaultValues };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [fields, registry]);
+    // Live values: the controlled `data` is the source of truth when provided;
+    // otherwise fall back to internal state so an uncontrolled bar still works and
+    // auto-search has something to observe. Deriving (rather than mirroring in an
+    // effect) keeps external `data` changes — async load, URL restore — in sync
+    // with no extra render.
+    const isControlled = data !== undefined;
+    const [internal, setInternal] = React.useState(() => ({
+        ...defaults,
+        ...data,
+    }));
+    const values = isControlled ? data : internal;
+    const handleSetData = React.useCallback((next) => {
+        if (!isControlled)
+            setInternal(next);
+        setData?.(next);
+    }, [isControlled, setData]);
+    // Serialized last-emitted query — dedupes auto-search so identical filter
+    // states don't refire. Seeded on mount so the initial render doesn't search.
+    const lastEmittedRef = React.useRef(undefined);
+    const emit = React.useCallback((raw, { dedupe }) => {
+        const query = buildSearchQuery(raw);
+        const serialized = JSON.stringify(query);
+        if (dedupe && serialized === lastEmittedRef.current)
+            return;
+        lastEmittedRef.current = serialized;
+        emitFn?.(query);
+    }, [emitFn]);
+    // Auto search: debounce on value changes, gated by schema validation so an
+    // invalid filter (bad email, reversed range) never fires a request. Seed the
+    // dedupe ref on the first run so mount doesn't trigger an unwanted search.
+    const mountedRef = React.useRef(false);
+    React.useEffect(() => {
+        if (!auto)
+            return;
+        if (!mountedRef.current) {
+            mountedRef.current = true;
+            lastEmittedRef.current = JSON.stringify(buildSearchQuery(values));
+            return;
+        }
+        const id = setTimeout(() => {
+            if (schema && !schema.safeParse(values).success)
+                return;
+            emit(values, { dedupe: true });
+        }, debounce);
+        return () => clearTimeout(id);
+    }, [auto, values, debounce, schema, emit]);
+    const handleReset = React.useCallback(() => {
+        handleSetData(defaults);
+        lastEmittedRef.current = undefined;
+        onReset?.();
+        // Auto mode re-searches via the debounced effect once `values` updates; in
+        // manual mode only re-run when explicitly asked.
+        if (!auto && searchOnReset)
+            emit(defaults, { dedupe: false });
+    }, [handleSetData, defaults, onReset, auto, searchOnReset, emit]);
+    const activeCount = React.useMemo(() => countActiveFilters(values), [values]);
+    const showSearchButton = !auto;
+    const showResetButton = reset;
+    const hasActions = showSearchButton || showResetButton || actions != null;
+    const actionBar = hasActions ? (_jsxs("div", { className: "flex items-center justify-end gap-2 pt-1", children: [actions, showResetButton && (_jsxs(Button, { type: "button", variant: "ghost", disabled: loading, onClick: handleReset, children: [_jsx(RotateCcw, {}), resetLabel] })), showSearchButton && (_jsxs(Button, { type: "submit", disabled: loading, children: [loading ? _jsx(Loader2, { className: "animate-spin" }) : _jsx(Search, {}), searchLabel, showCount && activeCount > 0 && (_jsx(Badge, { variant: "secondary", className: "ml-1", children: activeCount }))] }))] })) : null;
+    return (_jsx(SmartForm, { schema: schema ?? PASSTHROUGH_SCHEMA, data: values, setData: handleSetData, fields: fields, columns: columns, registry: registry, className: cn(RESPONSIVE_COLS[columns], className), 
+        // Manual submit path: SmartForm validates, then hands over the valid
+        // values — prune and emit (no dedupe: an explicit Search should always run).
+        onSubmit: (valid) => emit(valid, { dedupe: false }), submitLabel: null, children: actionBar ?? undefined }));
+};
+/**
+ * Alias of {@link SmartSearchForm}. Provided so `<SearchEngine … />` reads
+ * naturally at call sites that think in terms of a "search engine" block.
+ */
+export const SearchEngine = SmartSearchForm;
+//# sourceMappingURL=smart-search-form.js.map

package/dist/search-engine/smart-search-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-search-form.js","sourceRoot":"","sources":["../../src/search-engine/smart-search-form.tsx"],"names":[],"mappings":"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"}

package/dist/search-engine/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Search-engine field typing. Rather than fork the form engine, the search
+ * field definition is **derived** from {@link FieldDefinition}: intersecting the
+ * full discriminated union with a narrowed `type` distributes over the union, so
+ * every member keeps its own per-type extras (options, decimalScale, …) while
+ * the set of allowed `type`s is constrained to search-relevant controls. The
+ * result is still assignable to `FieldDefinition<T>[]`, so it flows straight into
+ * {@link SmartForm} and reuses the entire field registry unchanged.
+ */
+import type { FieldDefinition } from "@iamsaroj/smart-ui/form-engine";
+/**
+ * The subset of {@link FieldType} that makes sense as a search/filter control.
+ * Excludes authoring-only inputs (password, textarea, slug, rich text) that have
+ * no place in a filter bar.
+ *
+ * `combobox` / `autocomplete` are the searchable single-selects — use them for
+ * "async select" style fields; supply their `options` from your own loaded data,
+ * or register a custom async field type via the `registry` prop for true
+ * server-side option loading.
+ */
+export type SearchFieldType = "text" | "email" | "url" | "number" | "integer" | "decimal" | "currency" | "percentage" | "select" | "combobox" | "autocomplete" | "multiselect" | "radio" | "segmented" | "checkbox" | "checkbox-group" | "switch" | "yesno" | "date" | "daterange" | "month" | "year" | "time" | "datetime";
+/**
+ * A single search field's configuration — the same discriminated union as
+ * {@link FieldDefinition}, but with `type` constrained to {@link SearchFieldType}.
+ * Authoring keeps full per-type autocomplete and rejects non-search field types
+ * at compile time.
+ *
+ * ```tsx
+ * const fields: SearchFieldDefinition<UserSearch>[] = [
+ *   { name: "name", label: "Name", type: "text", placeholder: "Search name…" },
+ *   { name: "role", type: "select", options: roleOptions },
+ *   { name: "status", type: "multiselect", options: statusOptions },
+ *   { name: "createdAt", type: "daterange" },
+ * ]
+ * ```
+ */
+export type SearchFieldDefinition<T extends Record<string, unknown> = Record<string, unknown>> = FieldDefinition<T> & {
+    type: SearchFieldType;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/search-engine/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/search-engine/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAErE;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAEvB,MAAM,GACN,OAAO,GACP,KAAK,GAEL,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GAEZ,QAAQ,GACR,UAAU,GACV,cAAc,GACd,aAAa,GACb,OAAO,GACP,WAAW,GAEX,UAAU,GACV,gBAAgB,GAChB,QAAQ,GACR,OAAO,GAEP,MAAM,GACN,WAAW,GACX,OAAO,GACP,MAAM,GACN,MAAM,GACN,UAAU,CAAA;AAEd;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,qBAAqB,CAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD,eAAe,CAAC,CAAC,CAAC,GAAG;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAA"}

package/dist/search-engine/types.js

@@ -0,0 +1,11 @@
+/**
+ * Search-engine field typing. Rather than fork the form engine, the search
+ * field definition is **derived** from {@link FieldDefinition}: intersecting the
+ * full discriminated union with a narrowed `type` distributes over the union, so
+ * every member keeps its own per-type extras (options, decimalScale, …) while
+ * the set of allowed `type`s is constrained to search-relevant controls. The
+ * result is still assignable to `FieldDefinition<T>[]`, so it flows straight into
+ * {@link SmartForm} and reuses the entire field registry unchanged.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/search-engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/search-engine/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/smart-components/buttons/action-button.d.ts

@@ -0,0 +1,66 @@
+import * as React from "react";
+import { TooltipContent } from "@iamsaroj/smart-ui/components/tooltip";
+import { type SmartButtonProps } from "@iamsaroj/smart-ui/smart-components/smart-button";
+import { type ActionKind } from "./action-config";
+export type ActionPermissionChecker = (action: ActionKind) => boolean;
+/**
+ * Optional role/permission gate for all `ActionButton`s underneath. Buttons
+ * whose action `can(action)` rejects are hidden (or disabled, per their
+ * `deniedBehavior`). A per-button `permission` prop overrides the checker.
+ *
+ * ```tsx
+ * <ActionPermissionProvider can={(action) => role === "admin" || action !== "delete"}>
+ *   <EditButton onClick={edit} />
+ *   <DeleteButton onClick={remove} />
+ * </ActionPermissionProvider>
+ * ```
+ */
+export declare const ActionPermissionProvider: ({ can, children, }: {
+    can: ActionPermissionChecker;
+    children: React.ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export interface ActionButtonProps extends SmartButtonProps {
+    /** Which entry of `ACTION_BUTTON_CONFIG` supplies the defaults. */
+    action: ActionKind;
+    /** Override the default icon; pass `null` to render without an icon. */
+    icon?: React.ReactNode;
+    /**
+     * Render only the icon (switches to the matching `icon-*` size). The default
+     * label is kept as `aria-label` and shown as a tooltip.
+     */
+    iconOnly?: boolean;
+    /**
+     * Tooltip content. `true` uses the default label, `false` disables the
+     * automatic icon-only tooltip. Defaults to the label when `iconOnly`.
+     */
+    tooltip?: React.ReactNode | boolean;
+    tooltipSide?: React.ComponentProps<typeof TooltipContent>["side"];
+    /** Explicit permission override; wins over `ActionPermissionProvider`. */
+    permission?: boolean;
+    /** What to do when the action is not permitted. @default "hide" */
+    deniedBehavior?: "hide" | "disable";
+}
+/**
+ * `SmartButton` pre-configured for a named action: default icon, label,
+ * variant, loading text, and button type all come from
+ * `ACTION_BUTTON_CONFIG[action]`; every prop stays overridable. Prefer the
+ * named presets (`<AddButton />`, `<DeleteButton />`, …) — this component is
+ * the escape hatch for choosing the action dynamically.
+ *
+ * ```tsx
+ * <ActionButton action="save" loading={isSaving} onClick={save} />
+ * <ActionButton action="delete" iconOnly onClick={remove} />
+ * ```
+ */
+export declare const ActionButton: ({ action, icon, iconOnly, tooltip, tooltipSide, permission, deniedBehavior, variant, size, type, loadingText, disabled, children, "aria-label": ariaLabel, ...props }: ActionButtonProps) => import("react/jsx-runtime").JSX.Element | null;
+export type ActionButtonPresetProps = Omit<ActionButtonProps, "action">;
+/**
+ * Builds a named preset bound to one action. Used for all built-in buttons in
+ * `action-buttons.tsx`; call it yourself after extending
+ * `ACTION_BUTTON_CONFIG` with a new action.
+ */
+export declare const createActionButton: (action: ActionKind, displayName: string) => {
+    (props: ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=action-button.d.ts.map

package/dist/smart-components/buttons/action-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-button.d.ts","sourceRoot":"","sources":["../../../src/smart-components/buttons/action-button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAEL,cAAc,EAGf,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,kDAAkD,CAAA;AAEzD,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAA;AAExB,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAA;AAKrE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,GAAI,oBAGtC;IACD,GAAG,EAAE,uBAAuB,CAAA;IAC5B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,4CAIA,CAAA;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,mEAAmE;IACnE,MAAM,EAAE,UAAU,CAAA;IAClB,wEAAwE;IACxE,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,OAAO,CAAA;IACnC,WAAW,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;IACjE,0EAA0E;IAC1E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAqBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GAAI,uKAgB1B,iBAAiB,mDA4CnB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAA;AAEvE;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,UAAU,EAAE,aAAa,MAAM;YACrC,uBAAuB;;CAK3D,CAAA"}

package/dist/smart-components/buttons/action-button.js

@@ -0,0 +1,79 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, } from "@iamsaroj/smart-ui/components/tooltip";
+import { SmartButton, } from "@iamsaroj/smart-ui/smart-components/smart-button";
+import { ACTION_BUTTON_CONFIG, } from "./action-config";
+const ActionPermissionContext = React.createContext(null);
+/**
+ * Optional role/permission gate for all `ActionButton`s underneath. Buttons
+ * whose action `can(action)` rejects are hidden (or disabled, per their
+ * `deniedBehavior`). A per-button `permission` prop overrides the checker.
+ *
+ * ```tsx
+ * <ActionPermissionProvider can={(action) => role === "admin" || action !== "delete"}>
+ *   <EditButton onClick={edit} />
+ *   <DeleteButton onClick={remove} />
+ * </ActionPermissionProvider>
+ * ```
+ */
+export const ActionPermissionProvider = ({ can, children, }) => (_jsx(ActionPermissionContext.Provider, { value: can, children: children }));
+const toIconOnlySize = (size) => {
+    switch (size) {
+        case undefined:
+        case null:
+        case "default":
+            return "icon";
+        case "xs":
+            return "icon-xs";
+        case "sm":
+            return "icon-sm";
+        case "lg":
+            return "icon-lg";
+        default:
+            return size;
+    }
+};
+/**
+ * `SmartButton` pre-configured for a named action: default icon, label,
+ * variant, loading text, and button type all come from
+ * `ACTION_BUTTON_CONFIG[action]`; every prop stays overridable. Prefer the
+ * named presets (`<AddButton />`, `<DeleteButton />`, …) — this component is
+ * the escape hatch for choosing the action dynamically.
+ *
+ * ```tsx
+ * <ActionButton action="save" loading={isSaving} onClick={save} />
+ * <ActionButton action="delete" iconOnly onClick={remove} />
+ * ```
+ */
+export const ActionButton = ({ action, icon, iconOnly = false, tooltip, tooltipSide, permission, deniedBehavior = "hide", variant, size, type, loadingText, disabled, children, "aria-label": ariaLabel, ...props }) => {
+    const can = React.useContext(ActionPermissionContext);
+    const allowed = permission ?? can?.(action) ?? true;
+    if (!allowed && deniedBehavior === "hide")
+        return null;
+    const config = ACTION_BUTTON_CONFIG[action];
+    const DefaultIcon = config.icon;
+    const resolvedIcon = icon === undefined ? _jsx(DefaultIcon, { "aria-hidden": true }) : icon;
+    const label = children ?? config.label;
+    const iconSide = config.iconSide ?? "start";
+    const button = (_jsxs(SmartButton, { variant: variant ?? config.variant, size: iconOnly ? toIconOnlySize(size) : size, type: type ?? config.type ?? "button", loadingText: loadingText ?? (iconOnly ? "" : config.loadingText), disabled: disabled || !allowed, "aria-label": ariaLabel ?? (iconOnly ? config.label : undefined), ...props, children: [iconSide === "start" && resolvedIcon, !iconOnly && label, iconSide === "end" && resolvedIcon] }));
+    const tooltipContent = tooltip === true
+        ? config.label
+        : tooltip === false
+            ? null
+            : (tooltip ?? (iconOnly ? config.label : null));
+    if (tooltipContent == null)
+        return button;
+    return (_jsx(TooltipProvider, { children: _jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { render: button }), _jsx(TooltipContent, { side: tooltipSide, children: tooltipContent })] }) }));
+};
+/**
+ * Builds a named preset bound to one action. Used for all built-in buttons in
+ * `action-buttons.tsx`; call it yourself after extending
+ * `ACTION_BUTTON_CONFIG` with a new action.
+ */
+// eslint-disable-next-line react-refresh/only-export-components
+export const createActionButton = (action, displayName) => {
+    const ActionButtonPreset = (props) => (_jsx(ActionButton, { action: action, ...props }));
+    ActionButtonPreset.displayName = displayName;
+    return ActionButtonPreset;
+};
+//# sourceMappingURL=action-button.js.map

package/dist/smart-components/buttons/action-button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-button.js","sourceRoot":"","sources":["../../../src/smart-components/buttons/action-button.tsx"],"names":[],"mappings":"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"}

package/dist/smart-components/buttons/action-buttons.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Named presets — one per `ACTION_BUTTON_CONFIG` entry. Each is a
+ * `SmartButton` with the action's icon, label, variant, loading text, and
+ * accessibility defaults baked in; all props remain overridable.
+ *
+ * ```tsx
+ * <AddButton onClick={openCreate} />                    // "+ Add", primary
+ * <DeleteButton iconOnly onClick={remove} />            // trash icon, destructive, tooltip
+ * <SaveButton loading={isSaving} onClick={save} />      // spinner + "Saving…"
+ * <ExportButton permission={canExport} onClick={run} /> // hidden unless permitted
+ * <AddButton>New user</AddButton>                       // custom label
+ * ```
+ */
+export declare const AddButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const EditButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const DeleteButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const SaveButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const CancelButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const SearchButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const RefreshButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const SyncButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const DownloadButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const UploadButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const ImportButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const ExportButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const CopyButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const PrintButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const FilterButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const ResetButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const SubmitButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const ApproveButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const RejectButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const ViewButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const CloseButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const BackButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const NextButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const PreviousButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const DuplicateButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const ArchiveButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const RestoreButton: {
+    (props: import("./action-button").ActionButtonPresetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=action-buttons.d.ts.map

package/dist/smart-components/buttons/action-buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-buttons.d.ts","sourceRoot":"","sources":["../../../src/smart-components/buttons/action-buttons.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS;;;CAAyC,CAAA;AAC/D,eAAO,MAAM,UAAU;;;CAA2C,CAAA;AAClE,eAAO,MAAM,YAAY;;;CAA+C,CAAA;AACxE,eAAO,MAAM,UAAU;;;CAA2C,CAAA;AAClE,eAAO,MAAM,YAAY;;;CAA+C,CAAA;AACxE,eAAO,MAAM,YAAY;;;CAA+C,CAAA;AACxE,eAAO,MAAM,aAAa;;;CAAiD,CAAA;AAC3E,eAAO,MAAM,UAAU;;;CAA2C,CAAA;AAClE,eAAO,MAAM,cAAc;;;CAAmD,CAAA;AAC9E,eAAO,MAAM,YAAY;;;CAA+C,CAAA;AACxE,eAAO,MAAM,YAAY;;;CAA+C,CAAA;AACxE,eAAO,MAAM,YAAY;;;CAA+C,CAAA;AACxE,eAAO,MAAM,UAAU;;;CAA2C,CAAA;AAClE,eAAO,MAAM,WAAW;;;CAA6C,CAAA;AACrE,eAAO,MAAM,YAAY;;;CAA+C,CAAA;AACxE,eAAO,MAAM,WAAW;;;CAA6C,CAAA;AACrE,eAAO,MAAM,YAAY;;;CAA+C,CAAA;AACxE,eAAO,MAAM,aAAa;;;CAAiD,CAAA;AAC3E,eAAO,MAAM,YAAY;;;CAA+C,CAAA;AACxE,eAAO,MAAM,UAAU;;;CAA2C,CAAA;AAClE,eAAO,MAAM,WAAW;;;CAA6C,CAAA;AACrE,eAAO,MAAM,UAAU;;;CAA2C,CAAA;AAClE,eAAO,MAAM,UAAU;;;CAA2C,CAAA;AAClE,eAAO,MAAM,cAAc;;;CAAmD,CAAA;AAC9E,eAAO,MAAM,eAAe;;;CAG3B,CAAA;AACD,eAAO,MAAM,aAAa;;;CAAiD,CAAA;AAC3E,eAAO,MAAM,aAAa;;;CAAiD,CAAA"}

package/dist/smart-components/buttons/action-buttons.js

@@ -0,0 +1,42 @@
+import { createActionButton } from "./action-button";
+/**
+ * Named presets — one per `ACTION_BUTTON_CONFIG` entry. Each is a
+ * `SmartButton` with the action's icon, label, variant, loading text, and
+ * accessibility defaults baked in; all props remain overridable.
+ *
+ * ```tsx
+ * <AddButton onClick={openCreate} />                    // "+ Add", primary
+ * <DeleteButton iconOnly onClick={remove} />            // trash icon, destructive, tooltip
+ * <SaveButton loading={isSaving} onClick={save} />      // spinner + "Saving…"
+ * <ExportButton permission={canExport} onClick={run} /> // hidden unless permitted
+ * <AddButton>New user</AddButton>                       // custom label
+ * ```
+ */
+export const AddButton = createActionButton("add", "AddButton");
+export const EditButton = createActionButton("edit", "EditButton");
+export const DeleteButton = createActionButton("delete", "DeleteButton");
+export const SaveButton = createActionButton("save", "SaveButton");
+export const CancelButton = createActionButton("cancel", "CancelButton");
+export const SearchButton = createActionButton("search", "SearchButton");
+export const RefreshButton = createActionButton("refresh", "RefreshButton");
+export const SyncButton = createActionButton("sync", "SyncButton");
+export const DownloadButton = createActionButton("download", "DownloadButton");
+export const UploadButton = createActionButton("upload", "UploadButton");
+export const ImportButton = createActionButton("import", "ImportButton");
+export const ExportButton = createActionButton("export", "ExportButton");
+export const CopyButton = createActionButton("copy", "CopyButton");
+export const PrintButton = createActionButton("print", "PrintButton");
+export const FilterButton = createActionButton("filter", "FilterButton");
+export const ResetButton = createActionButton("reset", "ResetButton");
+export const SubmitButton = createActionButton("submit", "SubmitButton");
+export const ApproveButton = createActionButton("approve", "ApproveButton");
+export const RejectButton = createActionButton("reject", "RejectButton");
+export const ViewButton = createActionButton("view", "ViewButton");
+export const CloseButton = createActionButton("close", "CloseButton");
+export const BackButton = createActionButton("back", "BackButton");
+export const NextButton = createActionButton("next", "NextButton");
+export const PreviousButton = createActionButton("previous", "PreviousButton");
+export const DuplicateButton = createActionButton("duplicate", "DuplicateButton");
+export const ArchiveButton = createActionButton("archive", "ArchiveButton");
+export const RestoreButton = createActionButton("restore", "RestoreButton");
+//# sourceMappingURL=action-buttons.js.map