@iamsaroj/smart-ui 0.2.0

package/dist/smart-components/smart-drawer.d.ts

@@ -0,0 +1,48 @@
+import * as React from "react";
+import { DrawerClose } from "@iamsaroj/smart-ui/components/drawer";
+export interface SmartDrawerHeader {
+    title: React.ReactNode;
+    subtitle?: React.ReactNode;
+}
+export interface SmartDrawerProps {
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Element that opens the drawer when clicked. Rendered via `asChild`. */
+    trigger?: React.ReactElement;
+    /** Slide-in direction. @default "bottom" */
+    direction?: "top" | "bottom" | "left" | "right";
+    header?: SmartDrawerHeader;
+    /** Footer content. Use `<DrawerClose asChild>` inside for a close button. */
+    footer?: React.ReactNode;
+    className?: string;
+    children?: React.ReactNode;
+}
+/**
+ * Drawer with integrated trigger, header, scrollable body, and footer.
+ *
+ * ```tsx
+ * // Before
+ * <Drawer open={open} onOpenChange={setOpen}>
+ *   <DrawerTrigger asChild><Button>Open</Button></DrawerTrigger>
+ *   <DrawerContent>
+ *     <DrawerHeader><DrawerTitle>Settings</DrawerTitle></DrawerHeader>
+ *     <div className="overflow-y-auto px-4 py-2">...</div>
+ *     <DrawerFooter><Button onClick={save}>Save</Button></DrawerFooter>
+ *   </DrawerContent>
+ * </Drawer>
+ *
+ * // After
+ * <SmartDrawer
+ *   open={open}
+ *   onOpenChange={setOpen}
+ *   trigger={<Button>Open</Button>}
+ *   header={{ title: "Settings" }}
+ *   footer={<Button onClick={save}>Save</Button>}
+ * >
+ *   ...
+ * </SmartDrawer>
+ * ```
+ */
+export declare const SmartDrawer: ({ open, onOpenChange, trigger, direction, header, footer, className, children, }: SmartDrawerProps) => import("react/jsx-runtime").JSX.Element;
+export { DrawerClose };
+//# sourceMappingURL=smart-drawer.d.ts.map

package/dist/smart-components/smart-drawer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-drawer.d.ts","sourceRoot":"","sources":["../../src/smart-components/smart-drawer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAEL,WAAW,EAOZ,MAAM,sCAAsC,CAAA;AAE7C,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,KAAK,CAAC,YAAY,CAAA;IAC5B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;IAC/C,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,WAAW,GAAI,kFASzB,gBAAgB,4CAgBlB,CAAA;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/smart-components/smart-drawer.js

@@ -0,0 +1,32 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, } from "@iamsaroj/smart-ui/components/drawer";
+/**
+ * Drawer with integrated trigger, header, scrollable body, and footer.
+ *
+ * ```tsx
+ * // Before
+ * <Drawer open={open} onOpenChange={setOpen}>
+ *   <DrawerTrigger asChild><Button>Open</Button></DrawerTrigger>
+ *   <DrawerContent>
+ *     <DrawerHeader><DrawerTitle>Settings</DrawerTitle></DrawerHeader>
+ *     <div className="overflow-y-auto px-4 py-2">...</div>
+ *     <DrawerFooter><Button onClick={save}>Save</Button></DrawerFooter>
+ *   </DrawerContent>
+ * </Drawer>
+ *
+ * // After
+ * <SmartDrawer
+ *   open={open}
+ *   onOpenChange={setOpen}
+ *   trigger={<Button>Open</Button>}
+ *   header={{ title: "Settings" }}
+ *   footer={<Button onClick={save}>Save</Button>}
+ * >
+ *   ...
+ * </SmartDrawer>
+ * ```
+ */
+export const SmartDrawer = ({ open, onOpenChange, trigger, direction = "bottom", header, footer, className, children, }) => (_jsxs(Drawer, { open: open, onOpenChange: onOpenChange, direction: direction, children: [trigger && _jsx(DrawerTrigger, { asChild: true, children: trigger }), _jsxs(DrawerContent, { className: className, children: [header && (_jsxs(DrawerHeader, { children: [_jsx(DrawerTitle, { children: header.title }), header.subtitle && (_jsx(DrawerDescription, { children: header.subtitle }))] })), _jsx("div", { className: "flex-1 overflow-y-auto px-4 py-2", children: children }), footer && _jsx(DrawerFooter, { children: footer })] })] }));
+export { DrawerClose };
+//# sourceMappingURL=smart-drawer.js.map

package/dist/smart-components/smart-drawer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-drawer.js","sourceRoot":"","sources":["../../src/smart-components/smart-drawer.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAGZ,OAAO,EACL,MAAM,EACN,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,GACd,MAAM,sCAAsC,CAAA;AAqB7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAC1B,IAAI,EACJ,YAAY,EACZ,OAAO,EACP,SAAS,GAAG,QAAQ,EACpB,MAAM,EACN,MAAM,EACN,SAAS,EACT,QAAQ,GACS,EAAE,EAAE,CAAC,CACtB,MAAC,MAAM,IAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,aACjE,OAAO,IAAI,KAAC,aAAa,IAAC,OAAO,kBAAE,OAAO,GAAiB,EAC5D,MAAC,aAAa,IAAC,SAAS,EAAE,SAAS,aAChC,MAAM,IAAI,CACT,MAAC,YAAY,eACX,KAAC,WAAW,cAAE,MAAM,CAAC,KAAK,GAAe,EACxC,MAAM,CAAC,QAAQ,IAAI,CAClB,KAAC,iBAAiB,cAAE,MAAM,CAAC,QAAQ,GAAqB,CACzD,IACY,CAChB,EACD,cAAK,SAAS,EAAC,kCAAkC,YAAE,QAAQ,GAAO,EACjE,MAAM,IAAI,KAAC,YAAY,cAAE,MAAM,GAAgB,IAClC,IACT,CACV,CAAA;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/smart-components/smart-field.d.ts

@@ -0,0 +1,47 @@
+import * as React from "react";
+export interface SmartFieldProps {
+    /**
+     * Auto-generated with `useId()` when omitted. Injected into a single
+     * React-element child via `cloneElement` so the Label's `htmlFor`
+     * connects without manual ID threading.
+     */
+    id?: string;
+    /** Field label rendered above the control. */
+    label?: React.ReactNode;
+    /** Supporting hint rendered below the control. Hidden when `error` is set. */
+    description?: React.ReactNode;
+    /** Validation error. Replaces `description` and marks the control invalid. */
+    error?: React.ReactNode;
+    /** Appends a red asterisk to the label. */
+    required?: boolean;
+    /** Appends a muted "(optional)" to the label. */
+    optional?: boolean;
+    className?: string;
+    children: React.ReactNode;
+}
+/**
+ * Generic form-field wrapper: Label → control → hint/error.
+ *
+ * When `children` is a single React element SmartField injects `id`,
+ * `aria-describedby`, and `aria-invalid` automatically so you never
+ * have to thread IDs by hand.
+ *
+ * ```tsx
+ * // Before
+ * <div className="flex flex-col gap-1.5">
+ *   <Label htmlFor="email">Email</Label>
+ *   <Input id="email" type="email" aria-describedby="email-hint" />
+ *   <p id="email-hint" className="text-xs text-muted-foreground">We'll never share your email.</p>
+ * </div>
+ *
+ * // After
+ * <SmartField label="Email" description="We'll never share your email.">
+ *   <Input type="email" />
+ * </SmartField>
+ * ```
+ *
+ * Fall back to raw Label + control when the field needs two controls
+ * (e.g. a start/end date range) — `cloneElement` only works on a single child.
+ */
+export declare const SmartField: ({ id: idProp, label, description, error, required, optional, className, children, }: SmartFieldProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=smart-field.d.ts.map

package/dist/smart-components/smart-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-field.d.ts","sourceRoot":"","sources":["../../src/smart-components/smart-field.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,8CAA8C;IAC9C,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,UAAU,GAAI,qFASxB,eAAe,4CAiDjB,CAAA"}

package/dist/smart-components/smart-field.js

@@ -0,0 +1,44 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { cn } from "@iamsaroj/smart-ui/lib/utils";
+import { Label } from "@iamsaroj/smart-ui/components/label";
+/**
+ * Generic form-field wrapper: Label → control → hint/error.
+ *
+ * When `children` is a single React element SmartField injects `id`,
+ * `aria-describedby`, and `aria-invalid` automatically so you never
+ * have to thread IDs by hand.
+ *
+ * ```tsx
+ * // Before
+ * <div className="flex flex-col gap-1.5">
+ *   <Label htmlFor="email">Email</Label>
+ *   <Input id="email" type="email" aria-describedby="email-hint" />
+ *   <p id="email-hint" className="text-xs text-muted-foreground">We'll never share your email.</p>
+ * </div>
+ *
+ * // After
+ * <SmartField label="Email" description="We'll never share your email.">
+ *   <Input type="email" />
+ * </SmartField>
+ * ```
+ *
+ * Fall back to raw Label + control when the field needs two controls
+ * (e.g. a start/end date range) — `cloneElement` only works on a single child.
+ */
+export const SmartField = ({ id: idProp, label, description, error, required, optional, className, children, }) => {
+    const autoId = React.useId();
+    const resolvedId = idProp ?? autoId;
+    const hasHint = error != null || description != null;
+    const hintId = hasHint ? `${resolvedId}-hint` : undefined;
+    const injected = React.isValidElement(children)
+        ? React.cloneElement(children, {
+            id: children.props.id ?? resolvedId,
+            ...(hintId && { "aria-describedby": hintId }),
+            ...(error != null && { "aria-invalid": true }),
+        })
+        : children;
+    return (_jsxs("div", { "data-slot": "field", className: cn("flex flex-col gap-1.5", className), children: [label != null && (_jsxs(Label, { htmlFor: resolvedId, children: [label, required && (_jsx("span", { className: "text-destructive", "aria-hidden": "true", children: "*" })), optional && (_jsxs("span", { className: "font-normal text-muted-foreground", children: [" ", "(optional)"] }))] })), injected, hasHint && (_jsx("p", { id: hintId, className: cn("text-xs", error != null ? "text-destructive" : "text-muted-foreground"), children: error ?? description }))] }));
+};
+//# sourceMappingURL=smart-field.js.map

package/dist/smart-components/smart-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-field.js","sourceRoot":"","sources":["../../src/smart-components/smart-field.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,EAAE,EAAE,MAAM,8BAA8B,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAuB3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EACzB,EAAE,EAAE,MAAM,EACV,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,GACQ,EAAE,EAAE;IACpB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;IAC5B,MAAM,UAAU,GAAG,MAAM,IAAI,MAAM,CAAA;IACnC,MAAM,OAAO,GAAG,KAAK,IAAI,IAAI,IAAI,WAAW,IAAI,IAAI,CAAA;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IAEzD,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC;QAC7C,CAAC,CAAC,KAAK,CAAC,YAAY,CAChB,QAAuD,EACvD;YACE,EAAE,EAAG,QAAQ,CAAC,KAAyB,CAAC,EAAE,IAAI,UAAU;YACxD,GAAG,CAAC,MAAM,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC;YAC7C,GAAG,CAAC,KAAK,IAAI,IAAI,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;SAC/C,CACF;QACH,CAAC,CAAC,QAAQ,CAAA;IAEZ,OAAO,CACL,4BAAe,OAAO,EAAC,SAAS,EAAE,EAAE,CAAC,uBAAuB,EAAE,SAAS,CAAC,aACrE,KAAK,IAAI,IAAI,IAAI,CAChB,MAAC,KAAK,IAAC,OAAO,EAAE,UAAU,aACvB,KAAK,EACL,QAAQ,IAAI,CACX,eAAM,SAAS,EAAC,kBAAkB,iBAAa,MAAM,kBAE9C,CACR,EACA,QAAQ,IAAI,CACX,gBAAM,SAAS,EAAC,mCAAmC,aAChD,GAAG,kBAEC,CACR,IACK,CACT,EACA,QAAQ,EACR,OAAO,IAAI,CACV,YACE,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,EAAE,CACX,SAAS,EACT,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,uBAAuB,CAC7D,YAEA,KAAK,IAAI,WAAW,GACnB,CACL,IACG,CACP,CAAA;AACH,CAAC,CAAA"}

package/dist/smart-components/smart-input-group.d.ts

@@ -0,0 +1,60 @@
+import * as React from "react";
+export interface SmartInputGroupTrailingButton {
+    icon: React.ReactNode;
+    onClick: () => void;
+    /** Accessible label for the button (required). */
+    label: string;
+}
+export interface SmartInputGroupProps extends React.ComponentProps<"input"> {
+    /** SVG icon shown at the leading edge (left side). */
+    leadingIcon?: React.ReactNode;
+    /** Text shown at the leading edge, e.g. `"https://"` or `"$"`. */
+    leadingText?: string;
+    /** SVG icon shown at the trailing edge (right side). */
+    trailingIcon?: React.ReactNode;
+    /** Text shown at the trailing edge, e.g. `".com"` or `"USD"`. */
+    trailingText?: string;
+    /** Action button at the trailing edge (clear, submit, etc.). */
+    trailingButton?: SmartInputGroupTrailingButton;
+    /** Field label rendered above the group. */
+    label?: React.ReactNode;
+    /** Hint rendered below. Hidden when `error` is set. */
+    description?: React.ReactNode;
+    /** Validation error shown below instead of `description`. */
+    error?: React.ReactNode;
+    required?: boolean;
+    optional?: boolean;
+    fieldClassName?: string;
+    /**
+     * By default the value may not *start* with whitespace: Space at the
+     * beginning is ignored (including a held space bar) and pasted leading
+     * spaces are stripped; spaces after the first character work normally.
+     * Set to `true` to allow a leading space.
+     */
+    allowLeadingSpace?: boolean;
+}
+/**
+ * InputGroup with convenient leading/trailing addon props — no need to
+ * manually compose `InputGroupAddon` / `InputGroupText` / `InputGroupButton`.
+ *
+ * ```tsx
+ * // Icon left, clear button right
+ * <SmartInputGroup
+ *   leadingIcon={<Search />}
+ *   placeholder="Search users…"
+ *   value={query}
+ *   onChange={(e) => setQuery(e.target.value)}
+ *   trailingButton={query ? { icon: <X />, onClick: () => setQuery(""), label: "Clear" } : undefined}
+ * />
+ *
+ * // Text prefix + suffix
+ * <SmartInputGroup
+ *   label="Website"
+ *   leadingText="https://"
+ *   trailingText=".com"
+ *   placeholder="mysite"
+ * />
+ * ```
+ */
+export declare const SmartInputGroup: ({ leadingIcon, leadingText, trailingIcon, trailingText, trailingButton, label, description, error, required, optional, fieldClassName, id: idProp, className, "aria-invalid": ariaInvalid, allowLeadingSpace, onKeyDown, onChange, ...inputProps }: SmartInputGroupProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=smart-input-group.d.ts.map

package/dist/smart-components/smart-input-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-input-group.d.ts","sourceRoot":"","sources":["../../src/smart-components/smart-input-group.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAY9B,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,KAAK,CAAC,SAAS,CAAA;IACrB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,oBAAqB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC;IACzE,sDAAsD;IACtD,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wDAAwD;IACxD,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC9B,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gEAAgE;IAChE,cAAc,CAAC,EAAE,6BAA6B,CAAA;IAE9C,4CAA4C;IAC5C,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,uDAAuD;IACvD,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,eAAe,GAAI,oPAmB7B,oBAAoB,4CA2FtB,CAAA"}

package/dist/smart-components/smart-input-group.js

@@ -0,0 +1,40 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { cn } from "@iamsaroj/smart-ui/lib/utils";
+import { withLeadingSpaceGuard } from "@iamsaroj/smart-ui/lib/leading-space";
+import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, } from "@iamsaroj/smart-ui/components/input-group";
+import { Label } from "@iamsaroj/smart-ui/components/label";
+/**
+ * InputGroup with convenient leading/trailing addon props — no need to
+ * manually compose `InputGroupAddon` / `InputGroupText` / `InputGroupButton`.
+ *
+ * ```tsx
+ * // Icon left, clear button right
+ * <SmartInputGroup
+ *   leadingIcon={<Search />}
+ *   placeholder="Search users…"
+ *   value={query}
+ *   onChange={(e) => setQuery(e.target.value)}
+ *   trailingButton={query ? { icon: <X />, onClick: () => setQuery(""), label: "Clear" } : undefined}
+ * />
+ *
+ * // Text prefix + suffix
+ * <SmartInputGroup
+ *   label="Website"
+ *   leadingText="https://"
+ *   trailingText=".com"
+ *   placeholder="mysite"
+ * />
+ * ```
+ */
+export const SmartInputGroup = ({ leadingIcon, leadingText, trailingIcon, trailingText, trailingButton, label, description, error, required, optional, fieldClassName, id: idProp, className, "aria-invalid": ariaInvalid, allowLeadingSpace, onKeyDown, onChange, ...inputProps }) => {
+    const autoId = React.useId();
+    const id = idProp ?? autoId;
+    const hasHint = error != null || description != null;
+    const hintId = hasHint ? `${id}-hint` : undefined;
+    const hasLeading = leadingIcon != null || leadingText != null;
+    const hasTrailing = trailingIcon != null || trailingText != null || trailingButton != null;
+    return (_jsxs("div", { "data-slot": "field", className: cn("flex flex-col gap-1.5", fieldClassName), children: [label != null && (_jsxs(Label, { htmlFor: id, children: [label, required && (_jsx("span", { className: "text-destructive", "aria-hidden": "true", children: "*" })), optional && (_jsxs("span", { className: "font-normal text-muted-foreground", children: [" ", "(optional)"] }))] })), _jsxs(InputGroup, { children: [hasLeading && (_jsxs(InputGroupAddon, { align: "inline-start", children: [leadingIcon != null && (_jsx("span", { "aria-hidden": "true", className: "[&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3.5", children: leadingIcon })), leadingText != null && (_jsx(InputGroupText, { children: leadingText }))] })), _jsx(InputGroupInput, { id: id, className: className, "aria-describedby": hintId, "aria-invalid": error != null ? true : ariaInvalid, ...inputProps, ...withLeadingSpaceGuard({ onKeyDown, onChange }, allowLeadingSpace) }), hasTrailing && (_jsxs(InputGroupAddon, { align: "inline-end", children: [trailingText != null && (_jsx(InputGroupText, { children: trailingText })), trailingIcon != null && (_jsx("span", { "aria-hidden": "true", className: "[&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-3.5", children: trailingIcon })), trailingButton != null && (_jsx(InputGroupButton, { onClick: trailingButton.onClick, "aria-label": trailingButton.label, children: trailingButton.icon }))] }))] }), hasHint && (_jsx("p", { id: hintId, className: cn("text-xs", error != null ? "text-destructive" : "text-muted-foreground"), children: error ?? description }))] }));
+};
+//# sourceMappingURL=smart-input-group.js.map

package/dist/smart-components/smart-input-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-input-group.js","sourceRoot":"","sources":["../../src/smart-components/smart-input-group.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,EAAE,EAAE,MAAM,8BAA8B,CAAA;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AAC5E,OAAO,EACL,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,2CAA2C,CAAA;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAuC3D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAC9B,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,EAAE,EAAE,MAAM,EACV,SAAS,EACT,cAAc,EAAE,WAAW,EAC3B,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,GAAG,UAAU,EACQ,EAAE,EAAE;IACzB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;IAC5B,MAAM,EAAE,GAAG,MAAM,IAAI,MAAM,CAAA;IAC3B,MAAM,OAAO,GAAG,KAAK,IAAI,IAAI,IAAI,WAAW,IAAI,IAAI,CAAA;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IACjD,MAAM,UAAU,GAAG,WAAW,IAAI,IAAI,IAAI,WAAW,IAAI,IAAI,CAAA;IAC7D,MAAM,WAAW,GACf,YAAY,IAAI,IAAI,IAAI,YAAY,IAAI,IAAI,IAAI,cAAc,IAAI,IAAI,CAAA;IAExE,OAAO,CACL,4BACY,OAAO,EACjB,SAAS,EAAE,EAAE,CAAC,uBAAuB,EAAE,cAAc,CAAC,aAErD,KAAK,IAAI,IAAI,IAAI,CAChB,MAAC,KAAK,IAAC,OAAO,EAAE,EAAE,aACf,KAAK,EACL,QAAQ,IAAI,CACX,eAAM,SAAS,EAAC,kBAAkB,iBAAa,MAAM,kBAE9C,CACR,EACA,QAAQ,IAAI,CACX,gBAAM,SAAS,EAAC,mCAAmC,aAChD,GAAG,kBAEC,CACR,IACK,CACT,EACD,MAAC,UAAU,eACR,UAAU,IAAI,CACb,MAAC,eAAe,IAAC,KAAK,EAAC,cAAc,aAClC,WAAW,IAAI,IAAI,IAAI,CACtB,8BACc,MAAM,EAClB,SAAS,EAAC,oEAAoE,YAE7E,WAAW,GACP,CACR,EACA,WAAW,IAAI,IAAI,IAAI,CACtB,KAAC,cAAc,cAAE,WAAW,GAAkB,CAC/C,IACe,CACnB,EACD,KAAC,eAAe,IACd,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,SAAS,sBACF,MAAM,kBACV,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,KAC5C,UAAU,KACV,qBAAqB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,iBAAiB,CAAC,GACrE,EACD,WAAW,IAAI,CACd,MAAC,eAAe,IAAC,KAAK,EAAC,YAAY,aAChC,YAAY,IAAI,IAAI,IAAI,CACvB,KAAC,cAAc,cAAE,YAAY,GAAkB,CAChD,EACA,YAAY,IAAI,IAAI,IAAI,CACvB,8BACc,MAAM,EAClB,SAAS,EAAC,oEAAoE,YAE7E,YAAY,GACR,CACR,EACA,cAAc,IAAI,IAAI,IAAI,CACzB,KAAC,gBAAgB,IACf,OAAO,EAAE,cAAc,CAAC,OAAO,gBACnB,cAAc,CAAC,KAAK,YAE/B,cAAc,CAAC,IAAI,GACH,CACpB,IACe,CACnB,IACU,EACZ,OAAO,IAAI,CACV,YACE,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,EAAE,CACX,SAAS,EACT,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,uBAAuB,CAC7D,YAEA,KAAK,IAAI,WAAW,GACnB,CACL,IACG,CACP,CAAA;AACH,CAAC,CAAA"}

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

@@ -0,0 +1,46 @@
+import * as React from "react";
+import { Input } from "@iamsaroj/smart-ui/components/input";
+export interface SmartInputProps extends React.ComponentProps<"input"> {
+    /** Field label rendered above the input. */
+    label?: React.ReactNode;
+    /** Hint rendered below the input. Hidden when `error` is set. */
+    description?: React.ReactNode;
+    /** Validation error shown below the input instead of `description`. */
+    error?: React.ReactNode;
+    /** Appends a red asterisk to the label. */
+    required?: boolean;
+    /** Appends a muted "(optional)" to the label. */
+    optional?: boolean;
+    /** Class applied to the outer field wrapper. */
+    fieldClassName?: string;
+    /**
+     * By default the value may not *start* with whitespace: Space at the
+     * beginning is ignored (including a held space bar) and pasted leading
+     * spaces are stripped; spaces after the first character work normally.
+     * Set to `true` to allow a leading space.
+     */
+    allowLeadingSpace?: boolean;
+}
+/**
+ * Input with integrated label, description, and error message.
+ *
+ * ```tsx
+ * // Before
+ * <div className="flex flex-col gap-1.5">
+ *   <Label htmlFor="email">Email</Label>
+ *   <Input id="email" type="email" />
+ *   <p className="text-xs text-destructive">{error}</p>
+ * </div>
+ *
+ * // After
+ * <SmartInput
+ *   label="Email"
+ *   type="email"
+ *   error={error}
+ *   required
+ * />
+ * ```
+ */
+export { Input };
+export declare const SmartInput: ({ label, description, error, required, optional, fieldClassName, className, id: idProp, allowLeadingSpace, onKeyDown, onChange, ...inputProps }: SmartInputProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=smart-input.d.ts.map

package/dist/smart-components/smart-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-input.d.ts","sourceRoot":"","sources":["../../src/smart-components/smart-input.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAG3D,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC;IACpE,4CAA4C;IAC5C,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,iEAAiE;IACjE,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B,uEAAuE;IACvE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,KAAK,EAAE,CAAA;AAEhB,eAAO,MAAM,UAAU,GAAI,iJAaxB,eAAe,4CAgDjB,CAAA"}

package/dist/smart-components/smart-input.js

@@ -0,0 +1,36 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { cn } from "@iamsaroj/smart-ui/lib/utils";
+import { withLeadingSpaceGuard } from "@iamsaroj/smart-ui/lib/leading-space";
+import { Input } from "@iamsaroj/smart-ui/components/input";
+import { Label } from "@iamsaroj/smart-ui/components/label";
+/**
+ * Input with integrated label, description, and error message.
+ *
+ * ```tsx
+ * // Before
+ * <div className="flex flex-col gap-1.5">
+ *   <Label htmlFor="email">Email</Label>
+ *   <Input id="email" type="email" />
+ *   <p className="text-xs text-destructive">{error}</p>
+ * </div>
+ *
+ * // After
+ * <SmartInput
+ *   label="Email"
+ *   type="email"
+ *   error={error}
+ *   required
+ * />
+ * ```
+ */
+export { Input };
+export const SmartInput = ({ label, description, error, required, optional, fieldClassName, className, id: idProp, allowLeadingSpace, onKeyDown, onChange, ...inputProps }) => {
+    const autoId = React.useId();
+    const id = idProp ?? autoId;
+    const hasHint = error != null || description != null;
+    const hintId = hasHint ? `${id}-hint` : undefined;
+    return (_jsxs("div", { "data-slot": "field", className: cn("flex flex-col gap-1.5", fieldClassName), children: [label != null && (_jsxs(Label, { htmlFor: id, children: [label, required && (_jsx("span", { className: "text-destructive", "aria-hidden": "true", children: "*" })), optional && (_jsxs("span", { className: "font-normal text-muted-foreground", children: [" ", "(optional)"] }))] })), _jsx(Input, { id: id, className: className, "aria-describedby": hintId, "aria-invalid": error != null ? true : undefined, ...inputProps, ...withLeadingSpaceGuard({ onKeyDown, onChange }, allowLeadingSpace) }), hasHint && (_jsx("p", { id: hintId, className: cn("text-xs", error != null ? "text-destructive" : "text-muted-foreground"), children: error ?? description }))] }));
+};
+//# sourceMappingURL=smart-input.js.map

package/dist/smart-components/smart-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-input.js","sourceRoot":"","sources":["../../src/smart-components/smart-input.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,EAAE,EAAE,MAAM,8BAA8B,CAAA;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AAC5E,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAwB3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,KAAK,EAAE,CAAA;AAEhB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EACzB,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,EACT,EAAE,EAAE,MAAM,EACV,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,GAAG,UAAU,EACG,EAAE,EAAE;IACpB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;IAC5B,MAAM,EAAE,GAAG,MAAM,IAAI,MAAM,CAAA;IAC3B,MAAM,OAAO,GAAG,KAAK,IAAI,IAAI,IAAI,WAAW,IAAI,IAAI,CAAA;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IAEjD,OAAO,CACL,4BACY,OAAO,EACjB,SAAS,EAAE,EAAE,CAAC,uBAAuB,EAAE,cAAc,CAAC,aAErD,KAAK,IAAI,IAAI,IAAI,CAChB,MAAC,KAAK,IAAC,OAAO,EAAE,EAAE,aACf,KAAK,EACL,QAAQ,IAAI,CACX,eAAM,SAAS,EAAC,kBAAkB,iBAAa,MAAM,kBAE9C,CACR,EACA,QAAQ,IAAI,CACX,gBAAM,SAAS,EAAC,mCAAmC,aAChD,GAAG,kBAEC,CACR,IACK,CACT,EACD,KAAC,KAAK,IACJ,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,SAAS,sBACF,MAAM,kBACV,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,KAC1C,UAAU,KACV,qBAAqB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,iBAAiB,CAAC,GACrE,EACD,OAAO,IAAI,CACV,YACE,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,EAAE,CACX,SAAS,EACT,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,uBAAuB,CAC7D,YAEA,KAAK,IAAI,WAAW,GACnB,CACL,IACG,CACP,CAAA;AACH,CAAC,CAAA"}

package/dist/smart-components/smart-label.d.ts

@@ -0,0 +1,22 @@
+import * as React from "react";
+import { Label } from "@iamsaroj/smart-ui/components/label";
+export interface SmartLabelProps extends React.ComponentProps<"label"> {
+    /** Appends a red asterisk to signal a required field. */
+    required?: boolean;
+    /** Appends a muted "(optional)" hint. */
+    optional?: boolean;
+}
+/**
+ * Label with built-in required / optional indicators.
+ *
+ * ```tsx
+ * <SmartLabel htmlFor="email" required>Email address</SmartLabel>
+ * // → "Email address *"
+ *
+ * <SmartLabel htmlFor="bio" optional>Bio</SmartLabel>
+ * // → "Bio (optional)"
+ * ```
+ */
+export { Label };
+export declare const SmartLabel: ({ required, optional, children, className, ...props }: SmartLabelProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=smart-label.d.ts.map

package/dist/smart-components/smart-label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-label.d.ts","sourceRoot":"","sources":["../../src/smart-components/smart-label.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAE3D,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC;IACpE,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,EAAE,CAAA;AAEhB,eAAO,MAAM,UAAU,GAAI,uDAMxB,eAAe,4CAYjB,CAAA"}

package/dist/smart-components/smart-label.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@iamsaroj/smart-ui/lib/utils";
+import { Label } from "@iamsaroj/smart-ui/components/label";
+/**
+ * Label with built-in required / optional indicators.
+ *
+ * ```tsx
+ * <SmartLabel htmlFor="email" required>Email address</SmartLabel>
+ * // → "Email address *"
+ *
+ * <SmartLabel htmlFor="bio" optional>Bio</SmartLabel>
+ * // → "Bio (optional)"
+ * ```
+ */
+export { Label };
+export const SmartLabel = ({ required, optional, children, className, ...props }) => (_jsxs(Label, { className: cn(className), ...props, children: [children, required && (_jsx("span", { className: "text-destructive", "aria-hidden": "true", children: "*" })), optional && (_jsx("span", { className: "font-normal text-muted-foreground", children: " (optional)" }))] }));
+//# sourceMappingURL=smart-label.js.map

package/dist/smart-components/smart-label.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-label.js","sourceRoot":"","sources":["../../src/smart-components/smart-label.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,8BAA8B,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAS3D;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,EAAE,CAAA;AAEhB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EACzB,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,GAAG,KAAK,EACQ,EAAE,EAAE,CAAC,CACrB,MAAC,KAAK,IAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAM,KAAK,aACvC,QAAQ,EACR,QAAQ,IAAI,CACX,eAAM,SAAS,EAAC,kBAAkB,iBAAa,MAAM,kBAE9C,CACR,EACA,QAAQ,IAAI,CACX,eAAM,SAAS,EAAC,mCAAmC,4BAAmB,CACvE,IACK,CACT,CAAA"}

package/dist/smart-components/smart-month-picker.d.ts

@@ -0,0 +1,30 @@
+import * as React from "react";
+export interface SmartMonthPickerProps {
+    /** Selected month, normalized to the first day of the month (controlled). */
+    value?: Date;
+    onValueChange?: (value: Date | undefined) => void;
+    placeholder?: string;
+    /** Earliest selectable year (inclusive). */
+    fromYear?: number;
+    /** Latest selectable year (inclusive). */
+    toYear?: number;
+    disabled?: boolean;
+    /** Class applied to the trigger button. Defaults to full-width. */
+    className?: string;
+    label?: React.ReactNode;
+    description?: React.ReactNode;
+    error?: React.ReactNode;
+    required?: boolean;
+    optional?: boolean;
+    fieldClassName?: string;
+}
+/**
+ * Popover month picker — a 12-cell month grid with year navigation. Produces
+ * a `Date` fixed to the first day of the chosen month.
+ *
+ * ```tsx
+ * <SmartMonthPicker label="Billing month" value={month} onValueChange={setMonth} />
+ * ```
+ */
+export declare const SmartMonthPicker: ({ value, onValueChange, placeholder, fromYear, toYear, disabled, className, label, description, error, required, optional, fieldClassName, }: SmartMonthPickerProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=smart-month-picker.d.ts.map

package/dist/smart-components/smart-month-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-month-picker.d.ts","sourceRoot":"","sources":["../../src/smart-components/smart-month-picker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AA2B9B,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,GAAG,SAAS,KAAK,IAAI,CAAA;IACjD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAI,8IAc9B,qBAAqB,4CAgHvB,CAAA"}

package/dist/smart-components/smart-month-picker.js

@@ -0,0 +1,53 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { format } from "date-fns";
+import { CalendarIcon, ChevronLeftIcon, ChevronRightIcon } from "lucide-react";
+import { cn } from "@iamsaroj/smart-ui/lib/utils";
+import { Button } from "@iamsaroj/smart-ui/components/button";
+import { Label } from "@iamsaroj/smart-ui/components/label";
+import { Popover, PopoverContent, PopoverTrigger, } from "@iamsaroj/smart-ui/components/popover";
+const MONTHS = [
+    "Jan",
+    "Feb",
+    "Mar",
+    "Apr",
+    "May",
+    "Jun",
+    "Jul",
+    "Aug",
+    "Sep",
+    "Oct",
+    "Nov",
+    "Dec",
+];
+/**
+ * Popover month picker — a 12-cell month grid with year navigation. Produces
+ * a `Date` fixed to the first day of the chosen month.
+ *
+ * ```tsx
+ * <SmartMonthPicker label="Billing month" value={month} onValueChange={setMonth} />
+ * ```
+ */
+export const SmartMonthPicker = ({ value, onValueChange, placeholder = "Pick a month", fromYear = 1970, toYear = new Date().getFullYear() + 10, disabled, className, label, description, error, required, optional, fieldClassName, }) => {
+    const id = React.useId();
+    const hasHint = error != null || description != null;
+    const hintId = hasHint ? `${id}-hint` : undefined;
+    const [open, setOpen] = React.useState(false);
+    const [viewYear, setViewYear] = React.useState(value?.getFullYear() ?? new Date().getFullYear());
+    // Snap the visible year to the selected value each time the popover opens.
+    const handleOpenChange = (next) => {
+        if (next && value)
+            setViewYear(value.getFullYear());
+        setOpen(next);
+    };
+    const select = (monthIndex) => {
+        onValueChange?.(new Date(viewYear, monthIndex, 1));
+        setOpen(false);
+    };
+    return (_jsxs("div", { "data-slot": "field", className: cn("flex flex-col gap-1.5", fieldClassName), children: [label != null && (_jsxs(Label, { children: [label, required && (_jsx("span", { className: "text-destructive", "aria-hidden": "true", children: "*" })), optional && (_jsxs("span", { className: "font-normal text-muted-foreground", children: [" ", "(optional)"] }))] })), _jsxs(Popover, { open: open, onOpenChange: handleOpenChange, children: [_jsxs(PopoverTrigger, { render: _jsx(Button, { variant: "outline", disabled: disabled, className: cn("w-full justify-start text-left font-normal", !value && "text-muted-foreground", className) }), children: [_jsx(CalendarIcon, { className: "mr-2 h-4 w-4" }), value ? format(value, "MMMM yyyy") : _jsx("span", { children: placeholder })] }), _jsxs(PopoverContent, { className: "w-auto p-3", align: "start", children: [_jsxs("div", { className: "mb-2 flex items-center justify-between", children: [_jsx(Button, { size: "icon-sm", variant: "ghost", disabled: viewYear <= fromYear, onClick: () => setViewYear((y) => y - 1), "aria-label": "Previous year", children: _jsx(ChevronLeftIcon, { className: "size-4" }) }), _jsx("span", { className: "text-sm font-medium", children: viewYear }), _jsx(Button, { size: "icon-sm", variant: "ghost", disabled: viewYear >= toYear, onClick: () => setViewYear((y) => y + 1), "aria-label": "Next year", children: _jsx(ChevronRightIcon, { className: "size-4" }) })] }), _jsx("div", { className: "grid grid-cols-3 gap-1", children: MONTHS.map((month, index) => {
+                                    const isSelected = value?.getFullYear() === viewYear && value?.getMonth() === index;
+                                    return (_jsx(Button, { size: "sm", variant: isSelected ? "default" : "ghost", className: "w-16", onClick: () => select(index), children: month }, month));
+                                }) })] })] }), hasHint && (_jsx("p", { id: hintId, className: cn("text-xs", error != null ? "text-destructive" : "text-muted-foreground"), children: error ?? description }))] }));
+};
+//# sourceMappingURL=smart-month-picker.js.map

package/dist/smart-components/smart-month-picker.js.map

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

package/dist/smart-components/smart-multi-select.d.ts

@@ -0,0 +1,38 @@
+import * as React from "react";
+export interface SmartMultiSelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface SmartMultiSelectProps {
+    options: SmartMultiSelectOption[];
+    value?: string[];
+    onValueChange?: (value: string[]) => void;
+    placeholder?: string;
+    searchPlaceholder?: string;
+    emptyText?: string;
+    maxSelected?: number;
+    disabled?: boolean;
+    className?: string;
+    label?: React.ReactNode;
+    description?: React.ReactNode;
+    error?: React.ReactNode;
+    required?: boolean;
+    optional?: boolean;
+    fieldClassName?: string;
+}
+/**
+ * Multi-select with badge chips, search, and checkbox indicators.
+ * Built on Command + Popover.
+ *
+ * ```tsx
+ * <SmartMultiSelect
+ *   label="Skills"
+ *   options={skillOptions}
+ *   value={skills}
+ *   onValueChange={setSkills}
+ * />
+ * ```
+ */
+export declare const SmartMultiSelect: ({ options, value, onValueChange, placeholder, searchPlaceholder, emptyText, maxSelected, disabled, className, label, description, error, required, optional, fieldClassName, }: SmartMultiSelectProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=smart-multi-select.d.ts.map

package/dist/smart-components/smart-multi-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-multi-select.d.ts","sourceRoot":"","sources":["../../src/smart-components/smart-multi-select.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAoB9B,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,sBAAsB,EAAE,CAAA;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IACzC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAAI,gLAgB9B,qBAAqB,4CA0IvB,CAAA"}