@signalflare-ai/ui 0.5.0

package/dist/src/components/meter/meter.d.ts

@@ -0,0 +1,44 @@
+import { Meter as BaseMeter } from '@base-ui/react/meter';
+import { ComponentPropsWithoutRef } from 'react';
+/** Meter variant definitions (currently empty, reserved for future additions). */
+export declare const SF_METER_VARIANTS: {};
+export declare const SF_METER_DEFAULT_VARIANTS: {};
+export interface SFMeterVariantsProps {
+}
+export declare function meterVariants(_props?: SFMeterVariantsProps): string;
+type RootProps = ComponentPropsWithoutRef<typeof BaseMeter.Root>;
+/**
+ * Meter component props.
+ *
+ * @example
+ * ```tsx
+ * <Meter label="Storage used" value={65} />
+ * <Meter label="API requests" value={75} customValue="750 / 1,000" />
+ * ```
+ */
+export interface MeterProps extends RootProps, SFMeterVariantsProps {
+    /** Custom formatted value text (e.g. "750 / 1,000") displayed instead of percentage. */
+    customValue?: string;
+    /** Label text displayed above the meter track. */
+    label: string;
+    /**
+     * Whether to display the percentage value next to the label.
+     * @default true
+     */
+    showValue?: boolean;
+    /** Additional CSS classes for the track (background bar). */
+    trackClassName?: string;
+    /** Additional CSS classes for the indicator (filled bar). */
+    indicatorClassName?: string;
+}
+/**
+ * Progress bar showing a measured value within a known range (e.g. quota usage).
+ *
+ * @example
+ * ```tsx
+ * <Meter label="Storage" value={65} />
+ * ```
+ */
+export declare function Meter({ value, customValue, label, showValue, className, trackClassName, indicatorClassName, ...props }: MeterProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=meter.d.ts.map

package/dist/src/components/meter/meter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter.d.ts","sourceRoot":"","sources":["../../../../src/components/meter/meter.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,OAAO,CAAC;AAItD,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,IAEpB,CAAC;AAEX,eAAO,MAAM,yBAAyB,IAAc,CAAC;AAGrD,MAAM,WAAW,oBAAoB;CAAG;AAExC,wBAAgB,aAAa,CAAC,MAAM,GAAE,oBAAyB,UAK9D;AAED,KAAK,SAAS,GAAG,wBAAwB,CAAC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAW,SAAQ,SAAS,EAAE,oBAAoB;IACjE,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,WAAW,EACX,KAAK,EACL,SAAgB,EAChB,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,GAAG,KAAK,EACT,EAAE,UAAU,2CAsCZ"}

package/dist/src/components/pagination/index.d.ts

@@ -0,0 +1,2 @@
+export { Pagination } from './pagination';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/components/pagination/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/pagination/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/src/components/pagination/pagination.d.ts

@@ -0,0 +1,60 @@
+/** Pagination controls variant definitions. */
+export declare const SF_PAGINATION_VARIANTS: {
+    readonly controls: {
+        readonly full: {
+            readonly classes: "";
+            readonly description: "Full pagination controls with first, previous, page input, next, and last buttons";
+        };
+        readonly simple: {
+            readonly classes: "";
+            readonly description: "Simple pagination controls with only previous and next buttons";
+        };
+    };
+};
+export type SFPaginationControls = keyof typeof SF_PAGINATION_VARIANTS.controls;
+export declare const SF_PAGINATION_DEFAULT_VARIANTS: {
+    readonly controls: "full";
+};
+export interface SFPaginationVariantsProps {
+    controls?: SFPaginationControls;
+}
+export declare function paginationVariants({ controls, }?: SFPaginationVariantsProps): string;
+/**
+ * Pagination component props.
+ *
+ * @example
+ * ```tsx
+ * <Pagination page={page} setPage={setPage} perPage={10} totalCount={100} />
+ * <Pagination page={page} setPage={setPage} perPage={10} totalCount={100} controls="simple" />
+ * ```
+ */
+export interface PaginationProps extends SFPaginationVariantsProps {
+    /** Callback fired when the current page changes. */
+    setPage: (page: number) => void;
+    /**
+     * Current page number (1-indexed).
+     * @default 1
+     */
+    page?: number;
+    /** Number of items displayed per page. */
+    perPage?: number;
+    /** Total number of items across all pages. */
+    totalCount?: number;
+    /** Method to provide custom pagination text  */
+    text?: (props: {
+        page?: number;
+        perPage?: number;
+        totalCount?: number;
+        pageShowingRange: string;
+    }) => React.ReactNode;
+}
+/**
+ * Page navigation controls with page count display.
+ *
+ * @example
+ * ```tsx
+ * <Pagination page={page} setPage={setPage} perPage={10} totalCount={100} />
+ * ```
+ */
+export declare function Pagination({ page, perPage, totalCount, setPage, text, controls, }: PaginationProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/src/components/pagination/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../../src/components/pagination/pagination.tsx"],"names":[],"mappings":"AAWA,+CAA+C;AAC/C,eAAO,MAAM,sBAAsB;;;;;;;;;;;CAazB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,sBAAsB,CAAC,QAAQ,CAAC;AAEhF,eAAO,MAAM,8BAA8B;;CAEjC,CAAC;AAEX,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC;AAED,wBAAgB,kBAAkB,CAAC,EACjC,QAAkD,GACnD,GAAE,yBAA8B,UAKhC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAgB,SAAQ,yBAAyB;IAChE,oDAAoD;IACpD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,KAAK,KAAK,CAAC,SAAS,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAQ,EACR,OAAO,EACP,UAAU,EACV,OAAO,EACP,IAAI,EACJ,QAAkD,GACnD,EAAE,eAAe,2CA2GjB"}

package/dist/src/components/popover/index.d.ts

@@ -0,0 +1,3 @@
+export { Popover, PopoverRoot, PopoverTrigger, PopoverContent, PopoverTitle, PopoverDescription, PopoverClose, SF_POPOVER_VARIANTS, SF_POPOVER_DEFAULT_VARIANTS, } from './popover';
+export type { PopoverRootProps, PopoverTriggerProps, PopoverContentProps, PopoverTitleProps, PopoverDescriptionProps, PopoverCloseProps, SFPopoverSide, SFPopoverVariantsProps, } from './popover';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/components/popover/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/popover/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,WAAW,EACX,cAAc,EACd,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,sBAAsB,GACvB,MAAM,WAAW,CAAC"}

package/dist/src/components/popover/popover.d.ts

@@ -0,0 +1,138 @@
+import { Popover as PopoverBase } from '@base-ui/react/popover';
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+/** Popover side variant definitions mapping positions to their Tailwind classes. */
+export declare const SF_POPOVER_VARIANTS: {
+    readonly side: {
+        readonly top: {
+            readonly classes: "";
+            readonly description: "Popover appears above the trigger";
+        };
+        readonly bottom: {
+            readonly classes: "";
+            readonly description: "Popover appears below the trigger";
+        };
+        readonly left: {
+            readonly classes: "";
+            readonly description: "Popover appears to the left of the trigger";
+        };
+        readonly right: {
+            readonly classes: "";
+            readonly description: "Popover appears to the right of the trigger";
+        };
+    };
+};
+export declare const SF_POPOVER_DEFAULT_VARIANTS: {
+    readonly side: "bottom";
+};
+export type SFPopoverSide = keyof typeof SF_POPOVER_VARIANTS.side;
+export interface SFPopoverVariantsProps {
+    /**
+     * Which side of the trigger the popover appears on.
+     * - `"top"` — Above the trigger
+     * - `"bottom"` — Below the trigger
+     * - `"left"` — Left of the trigger
+     * - `"right"` — Right of the trigger
+     * @default "bottom"
+     */
+    side?: SFPopoverSide;
+}
+type BasePopoverRootProps = ComponentPropsWithoutRef<typeof PopoverBase.Root>;
+export type PopoverRootProps = BasePopoverRootProps;
+declare function PopoverRoot({ children, ...props }: PopoverRootProps): import("react/jsx-runtime").JSX.Element;
+declare namespace PopoverRoot {
+    var displayName: string;
+}
+type BasePopoverTriggerProps = ComponentPropsWithoutRef<typeof PopoverBase.Trigger>;
+export type PopoverTriggerProps = BasePopoverTriggerProps & {
+    /** When true, the trigger element will be the child element */
+    asChild?: boolean;
+};
+declare function PopoverTrigger({ children, className, asChild, ...props }: PopoverTriggerProps): import("react/jsx-runtime").JSX.Element;
+declare namespace PopoverTrigger {
+    var displayName: string;
+}
+/** Alignment options for popover positioning */
+type PopoverAlign = "start" | "center" | "end";
+/**
+ * Popover content panel props.
+ *
+ * @example
+ * ```tsx
+ * <Popover.Content side="top" align="start" sideOffset={12}>
+ *   <p>Popover body</p>
+ * </Popover.Content>
+ * ```
+ */
+export type PopoverContentProps = SFPopoverVariantsProps & {
+    /**
+     * How to align the popover relative to the trigger.
+     * @default "center"
+     */
+    align?: PopoverAlign;
+    /**
+     * Distance between the trigger and the popover in pixels.
+     * @default 8
+     */
+    sideOffset?: number;
+    /**
+     * Additional offset along the alignment axis in pixels.
+     * @default 0
+     */
+    alignOffset?: number;
+    /** Additional CSS classes merged via `cn()`. */
+    className?: string;
+    /** Content to render inside the popover. */
+    children?: ReactNode;
+};
+declare function PopoverContent({ children, side, align, sideOffset, alignOffset, className, }: PopoverContentProps): import("react/jsx-runtime").JSX.Element;
+declare namespace PopoverContent {
+    var displayName: string;
+}
+type BasePopoverTitleProps = ComponentPropsWithoutRef<typeof PopoverBase.Title>;
+export type PopoverTitleProps = BasePopoverTitleProps;
+declare function PopoverTitle({ className, ...props }: PopoverTitleProps): import("react/jsx-runtime").JSX.Element;
+declare namespace PopoverTitle {
+    var displayName: string;
+}
+type BasePopoverDescriptionProps = ComponentPropsWithoutRef<typeof PopoverBase.Description>;
+export type PopoverDescriptionProps = BasePopoverDescriptionProps;
+declare function PopoverDescription({ className, ...props }: PopoverDescriptionProps): import("react/jsx-runtime").JSX.Element;
+declare namespace PopoverDescription {
+    var displayName: string;
+}
+type BasePopoverCloseProps = ComponentPropsWithoutRef<typeof PopoverBase.Close>;
+export type PopoverCloseProps = BasePopoverCloseProps & {
+    /** When true, the close element will be the child element */
+    asChild?: boolean;
+};
+declare function PopoverClose({ children, className, asChild, ...props }: PopoverCloseProps): import("react/jsx-runtime").JSX.Element;
+declare namespace PopoverClose {
+    var displayName: string;
+}
+/**
+ * Popover component for displaying accessible popup content anchored to a trigger.
+ *
+ * @example
+ * ```tsx
+ * <Popover>
+ *   <Popover.Trigger asChild>
+ *     <Button>Open</Button>
+ *   </Popover.Trigger>
+ *   <Popover.Content>
+ *     <Popover.Title>Notifications</Popover.Title>
+ *     <Popover.Description>You are all caught up!</Popover.Description>
+ *   </Popover.Content>
+ * </Popover>
+ * ```
+ *
+ * @see https://base-ui.com/react/components/popover
+ */
+export declare const Popover: typeof PopoverRoot & {
+    Trigger: typeof PopoverTrigger;
+    Content: typeof PopoverContent;
+    Title: typeof PopoverTitle;
+    Description: typeof PopoverDescription;
+    Close: typeof PopoverClose;
+};
+export { PopoverRoot, PopoverTrigger, PopoverContent, PopoverTitle, PopoverDescription, PopoverClose, };
+//# sourceMappingURL=popover.d.ts.map

package/dist/src/components/popover/popover.d.ts.map

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

package/dist/src/components/radio/index.d.ts

@@ -0,0 +1,2 @@
+export { Radio, RadioGroup, SF_RADIO_VARIANTS, SF_RADIO_DEFAULT_VARIANTS, radioVariants, type RadioGroupProps, type RadioItemProps, type RadioControlPosition, type SFRadioVariant, type SFRadioVariantsProps, type RadioVariant, } from './radio';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/components/radio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/radio/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,UAAU,EACV,iBAAiB,EACjB,yBAAyB,EACzB,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}

package/dist/src/components/radio/radio.d.ts

@@ -0,0 +1,163 @@
+import { ReactNode } from 'react';
+/** Radio variant definitions mapping variant names to their Tailwind classes. */
+export declare const SF_RADIO_VARIANTS: {
+    readonly variant: {
+        readonly default: {
+            readonly classes: "ring-sf-line";
+            readonly description: "Default radio appearance";
+        };
+        readonly error: {
+            readonly classes: "ring-destructive";
+            readonly description: "Error state for validation failures";
+        };
+    };
+};
+export declare const SF_RADIO_DEFAULT_VARIANTS: {
+    readonly variant: "default";
+};
+export type SFRadioVariant = keyof typeof SF_RADIO_VARIANTS.variant;
+export interface SFRadioVariantsProps {
+    /**
+     * Visual variant.
+     * - `"default"` — Standard radio appearance
+     * - `"error"` — Error state for validation failures
+     * @default "default"
+     */
+    variant?: SFRadioVariant;
+}
+export declare function radioVariants({ variant, }?: SFRadioVariantsProps): string;
+export type RadioVariant = SFRadioVariant;
+/** Position of the radio control relative to its label */
+export type RadioControlPosition = "start" | "end";
+/**
+ * Radio group component props (with built-in Fieldset and RadioGroup)
+ *
+ * @example
+ * // Basic usage
+ * ```tsx
+ * <Radio.Group legend="Notification preference" defaultValue="email">
+ *   <Radio.Item label="Email" value="email" />
+ *   <Radio.Item label="SMS" value="sms" />
+ *   <Radio.Item label="Push" value="push" />
+ * </Radio.Group>
+ * ```
+ *
+ * @example
+ * // Horizontal layout
+ * ```tsx
+ * <Radio.Group legend="Size" orientation="horizontal" defaultValue="md">
+ *   <Radio.Item label="Small" value="sm" />
+ *   <Radio.Item label="Medium" value="md" />
+ *   <Radio.Item label="Large" value="lg" />
+ * </Radio.Group>
+ * ```
+ *
+ * @example
+ * // With error and description
+ * ```tsx
+ * <Radio.Group
+ *   legend="Payment method"
+ *   error="Please select a payment method"
+ *   description="Choose how you'd like to pay"
+ * >
+ *   <Radio.Item label="Credit Card" value="card" />
+ *   <Radio.Item label="PayPal" value="paypal" />
+ * </Radio.Group>
+ * ```
+ *
+ * @example
+ * // Controlled
+ * ```tsx
+ * const [value, setValue] = useState("email");
+ * <Radio.Group legend="Contact" value={value} onValueChange={setValue}>
+ *   <Radio.Item label="Email" value="email" />
+ *   <Radio.Item label="Phone" value="phone" />
+ * </Radio.Group>
+ * ```
+ *
+ * @example
+ * // Label before radio (controlPosition="end")
+ * ```tsx
+ * <Radio.Group legend="Options" controlPosition="end" defaultValue="a">
+ *   <Radio.Item label="Option A" value="a" />
+ *   <Radio.Item label="Option B" value="b" />
+ * </Radio.Group>
+ * ```
+ */
+export interface RadioGroupProps {
+    /** Legend text for the group (required for accessibility) */
+    legend: string;
+    /** Child Radio.Item components */
+    children: ReactNode;
+    /** Layout direction of the radio items */
+    orientation?: "vertical" | "horizontal";
+    /** Error message for the group */
+    error?: string;
+    /** Helper text for the group */
+    description?: ReactNode;
+    /** Value of the radio that should be initially selected (uncontrolled) */
+    defaultValue?: string;
+    /** Value of the radio that should be selected (controlled) */
+    value?: string;
+    /** Event handler called when radio value changes */
+    onValueChange?: (value: string) => void;
+    /** Whether all radios in the group are disabled */
+    disabled?: boolean;
+    /** Position of radio control relative to label: "start" (default) puts radio before label, "end" puts label before radio */
+    controlPosition?: RadioControlPosition;
+    /** Form submission name for the radio group */
+    name?: string;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Individual radio item within a group
+ *
+ * @example
+ * ```tsx
+ * <Radio.Item label="Option A" value="a" />
+ * ```
+ *
+ * @example
+ * // Disabled item
+ * ```tsx
+ * <Radio.Item label="Unavailable" value="unavailable" disabled />
+ * ```
+ */
+export type RadioItemProps = {
+    /** Visual variant: "default" or "error" for validation failures */
+    variant?: RadioVariant;
+    /** Label text displayed next to radio (required) */
+    label: string;
+    /** Value of the radio (required) */
+    value: string;
+    /** Additional CSS classes for the label wrapper */
+    className?: string;
+    /** Whether the radio is disabled */
+    disabled?: boolean;
+};
+declare function RadioGroup({ legend, children, orientation, error, description, defaultValue, value, onValueChange, disabled, controlPosition, name, className, }: RadioGroupProps): import("react/jsx-runtime").JSX.Element;
+declare namespace RadioGroup {
+    var displayName: string;
+}
+export { RadioGroup };
+/**
+ * Radio — radio button group for single-select choices.
+ *
+ * Compound component: `Radio.Group` (with built-in Fieldset) and `Radio.Item`.
+ * Built on `@base-ui/react/radio-group` + `@base-ui/react/radio`.
+ *
+ * @example
+ * ```tsx
+ * <Radio.Group legend="Notification preference" defaultValue="email">
+ *   <Radio.Item label="Email" value="email" />
+ *   <Radio.Item label="SMS" value="sms" />
+ *   <Radio.Item label="Push" value="push" />
+ * </Radio.Group>
+ * ```
+ */
+export declare const Radio: {
+    Item: import('react').ForwardRefExoticComponent<RadioItemProps & import('react').RefAttributes<HTMLButtonElement>>;
+    Group: typeof RadioGroup;
+};
+//# sourceMappingURL=radio.d.ts.map

package/dist/src/components/radio/radio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio.d.ts","sourceRoot":"","sources":["../../../../src/components/radio/radio.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAyC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI9E,iFAAiF;AACjF,eAAO,MAAM,iBAAiB;;;;;;;;;;;CAWpB,CAAC;AAEX,eAAO,MAAM,yBAAyB;;CAE5B,CAAC;AAGX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,iBAAiB,CAAC,OAAO,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAAC,EAC5B,OAA2C,GAC5C,GAAE,oBAAyB,UAE3B;AAGD,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC;AAE1C,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,KAAK,CAAC;AASnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,SAAS,CAAC;IACpB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACxC,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4HAA4H;IAC5H,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,mEAAmE;IACnE,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AA2CF,iBAAS,UAAU,CAAC,EAClB,MAAM,EACN,QAAQ,EACR,WAAwB,EACxB,KAAK,EACL,WAAW,EACX,YAAY,EACZ,KAAK,EACL,aAAa,EACb,QAAQ,EACR,eAAyB,EACzB,IAAI,EACJ,SAAS,GACV,EAAE,eAAe,2CAmCjB;kBAhDQ,UAAU;;;AAqDnB,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK;;;CAGjB,CAAC"}

package/dist/src/components/select/index.d.ts

@@ -0,0 +1,2 @@
+export { Select } from './select';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/components/select/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/select/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/components/select/select.d.ts

@@ -0,0 +1,150 @@
+import { Select as SelectBase } from '@base-ui/react/select';
+import { ReactNode } from 'react';
+import { FieldErrorMatch } from '../field/field';
+/** Select variant definitions (currently empty, reserved for future additions). */
+export declare const SF_SELECT_VARIANTS: {};
+export declare const SF_SELECT_DEFAULT_VARIANTS: {};
+/**
+ * Select component styling metadata for Figma plugin code generation
+ * Extracted from select.tsx implementation (source of truth)
+ */
+export declare const SF_SELECT_STYLING: {
+    readonly trigger: {
+        readonly height: 36;
+        readonly paddingX: 12;
+        readonly borderRadius: 8;
+        readonly background: "color-secondary";
+        readonly text: "text-color-surface";
+        readonly ring: "color-border";
+        readonly fontSize: 16;
+        readonly fontWeight: 400;
+    };
+    readonly stateTokens: {
+        readonly focus: {
+            readonly ring: "color-active";
+        };
+        readonly disabled: {
+            readonly opacity: 0.5;
+        };
+    };
+    readonly icons: {
+        readonly caret: {
+            readonly name: "ph-caret-up-down";
+            readonly size: 20;
+        };
+        readonly check: {
+            readonly name: "ph-check";
+            readonly size: 20;
+        };
+    };
+    readonly popup: {
+        readonly background: "color-secondary";
+        readonly ring: "color-border";
+        readonly borderRadius: 8;
+        readonly padding: 6;
+    };
+    readonly option: {
+        readonly paddingX: 8;
+        readonly paddingY: 6;
+        readonly borderRadius: 4;
+        readonly fontSize: 16;
+        readonly highlightBackground: "color-surface-secondary";
+    };
+};
+export interface SFSelectVariantsProps {
+}
+export declare function selectVariants(_props?: SFSelectVariantsProps): string;
+type SelectPropsGeneric<T, Multiple extends boolean | undefined = false> = SelectBase.Root.Props<T, Multiple> & SFSelectVariantsProps & {
+    multiple?: Multiple;
+    renderValue?: (value: Multiple extends true ? T[] : T) => ReactNode;
+    className?: string;
+    /** Label content for the select (enables Field wrapper) - can be a string or any React node */
+    label?: ReactNode;
+    /** Visually hide the label (sr-only). Set to `false` for a visible label. @default true */
+    hideLabel?: boolean;
+    placeholder?: string;
+    loading?: boolean;
+    /** Tooltip content to display next to the label via an info icon */
+    labelTooltip?: ReactNode;
+    /** Helper text displayed below the select */
+    description?: ReactNode;
+    /** Error message or validation error object */
+    error?: string | {
+        message: ReactNode;
+        match: FieldErrorMatch;
+    };
+};
+/**
+ * Select component props.
+ *
+ * @example
+ * ```tsx
+ * <Select label="Country" onValueChange={setValue}>
+ *   <Select.Option value="us">United States</Select.Option>
+ *   <Select.Option value="uk">United Kingdom</Select.Option>
+ * </Select>
+ * ```
+ */
+export interface SelectProps {
+    /** Additional CSS classes merged via `cn()`. */
+    className?: string;
+    /** Label content for the select (enables Field wrapper) — can be a string or any React node. */
+    label?: ReactNode;
+    /**
+     * Visually hide the label while keeping it accessible to screen readers.
+     * Set to `false` to show a visible label above the select via the Field wrapper.
+     * @default true
+     */
+    hideLabel?: boolean;
+    /** Placeholder text shown when no value is selected. */
+    placeholder?: string;
+    /** When `true`, shows a skeleton loader in place of the selected value. */
+    loading?: boolean;
+    /** Whether the select is disabled. */
+    disabled?: boolean;
+    /** Whether the select is required. When `false`, shows "(optional)" text. */
+    required?: boolean;
+    /** Tooltip content displayed next to the label via an info icon. */
+    labelTooltip?: ReactNode;
+    /** Currently selected value (controlled mode). */
+    value?: unknown;
+    /** Initial value for uncontrolled mode. */
+    defaultValue?: unknown;
+    /** Callback fired when the selected value changes. */
+    onValueChange?: (value: unknown) => void;
+    /** Enable multi-select mode. */
+    multiple?: boolean;
+    /** `Select.Option` elements to render in the dropdown. */
+    children?: ReactNode;
+    /** Helper text displayed below the select. */
+    description?: ReactNode;
+    /** Error message string or validation error object with `match` key. */
+    error?: string | {
+        message: ReactNode;
+        match: FieldErrorMatch;
+    };
+}
+/**
+ * Dropdown for selecting a value from a list of options.
+ * Wraps Base UI Select with SF styling and optional Field integration.
+ *
+ * @example
+ * ```tsx
+ * <Select label="Fruit" onValueChange={setFruit}>
+ *   <Select.Option value="apple">Apple</Select.Option>
+ *   <Select.Option value="banana">Banana</Select.Option>
+ * </Select>
+ * ```
+ */
+export declare function Select<T, Multiple extends boolean | undefined = false>({ children, className, renderValue, label, hideLabel, placeholder, loading, labelTooltip, description, error, required, ...props }: SelectPropsGeneric<T, Multiple> & {
+    required?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export declare namespace Select {
+    var Option: <T>({ children, value }: OptionProps<T>) => import("react/jsx-runtime").JSX.Element;
+}
+type OptionProps<T> = {
+    children: ReactNode;
+    value: T;
+};
+export {};
+//# sourceMappingURL=select.d.ts.map

package/dist/src/components/select/select.d.ts.map

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

package/dist/src/components/sensitive-input/index.d.ts

@@ -0,0 +1,2 @@
+export { SensitiveInput, type SensitiveInputProps, SF_SENSITIVE_INPUT_VARIANTS, SF_SENSITIVE_INPUT_DEFAULT_VARIANTS, } from './sensitive-input';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/components/sensitive-input/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/sensitive-input/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,EACxB,2BAA2B,EAC3B,mCAAmC,GACpC,MAAM,mBAAmB,CAAC"}