@konstructio/ui 0.1.2-alpha.7 → 0.1.2-alpha.71

package/dist/components/RadioGroup/RadioGroup.d.ts

@@ -0,0 +1,34 @@
+import { FC } from 'react';
+import { RadioGroupProps } from './RadioGroup.types';
+/**
+ * A group of radio buttons with shared state management.
+ *
+ * @example
+ * ```tsx
+ * // Vertical layout (default)
+ * <RadioGroup
+ *   name="subscription"
+ *   options={[
+ *     { value: 'monthly', label: 'Monthly', description: '$10/mo' },
+ *     { value: 'yearly', label: 'Yearly', description: '$100/yr' },
+ *   ]}
+ *   defaultChecked="monthly"
+ *   onValueChange={(value) => setSubscription(value)}
+ * />
+ *
+ * // Horizontal layout
+ * <RadioGroup
+ *   name="size"
+ *   direction="row"
+ *   options={[
+ *     { value: 'sm', label: 'Small' },
+ *     { value: 'md', label: 'Medium' },
+ *     { value: 'lg', label: 'Large' },
+ *   ]}
+ *   onValueChange={setSize}
+ * />
+ * ```
+ *
+ * @see {@link https://konstructio.github.io/konstruct-ui/?path=/docs/components-radiogroup--docs Storybook}
+ */
+export declare const RadioGroup: FC<RadioGroupProps>;

package/dist/components/RadioGroup/RadioGroup.js

@@ -1,44 +1,45 @@
-import { jsx as e } from "react/jsx-runtime";
-import { S as k } from "../../index-DQH6odE9.js";
-import { useState as x, useCallback as C } from "react";
-import { cn as r } from "../../utils/index.js";
-import { Radio as G } from "../Radio/Radio.js";
-import { radioGroupVariants as R } from "./RadioGroup.variants.js";
-const y = ({
+import { jsx as s } from "react/jsx-runtime";
+import { S as G } from "../../index-BvoZGpli.js";
+import { useState as R, useCallback as b } from "react";
+import { cn as c } from "../../utils/index.js";
+import { Radio as j } from "../Radio/Radio.js";
+import { radioGroupVariants as u } from "./RadioGroup.variants.js";
+const A = ({
   asChild: m,
-  className: s,
-  defaultChecked: c,
-  name: a,
-  options: i,
-  theme: d,
-  wrapperClassName: n,
-  direction: p,
-  onValueChange: t
+  className: a,
+  defaultChecked: n,
+  direction: i,
+  name: d,
+  options: l,
+  theme: p,
+  value: e,
+  wrapperClassName: f,
+  onValueChange: r
 }) => {
-  const f = m ? k : "div", [l, S] = x(
-    () => c
-  ), h = C(
+  const S = m ? G : "div", t = e !== void 0, [h, C] = R(
+    () => n
+  ), N = t ? e : h, k = b(
     (o) => {
-      S(o), t?.(o);
+      t || C(o), r?.(o);
     },
-    [t]
+    [t, r]
   );
-  return /* @__PURE__ */ e(
-    f,
+  return /* @__PURE__ */ s(
+    S,
     {
-      className: r(
-        R({ className: n, direction: p })
+      className: c(
+        u({ className: f, direction: i })
       ),
-      "data-theme": d,
-      children: i.map(({ value: o, ...N }) => /* @__PURE__ */ e(
-        G,
+      "data-theme": p,
+      children: l.map(({ value: o, ...x }) => /* @__PURE__ */ s(
+        j,
         {
           value: o,
-          name: a,
-          className: r(s),
-          checked: l === o,
-          onChange: () => h(o),
-          ...N
+          name: d,
+          className: c(a),
+          checked: N === o,
+          onChange: () => k(o),
+          ...x
         },
         o
       ))
@@ -46,5 +47,5 @@ const y = ({
   );
 };
 export {
-  y as RadioGroup
+  A as RadioGroup
 };

package/dist/components/RadioGroup/RadioGroup.types.d.ts

@@ -0,0 +1,44 @@
+import { ReactNode } from 'react';
+import { Theme } from '../../domain/theme';
+import { RadioProps } from '../Radio/Radio.types';
+/**
+ * Props for the RadioGroup component.
+ *
+ * @example
+ * ```tsx
+ * <RadioGroup
+ *   name="plan"
+ *   options={[
+ *     { value: 'basic', label: 'Basic' },
+ *     { value: 'pro', label: 'Pro' },
+ *     { value: 'enterprise', label: 'Enterprise' },
+ *   ]}
+ *   defaultChecked="basic"
+ *   onValueChange={(value) => setPlan(value)}
+ * />
+ * ```
+ */
+export interface RadioGroupProps {
+    /** Merge props onto child element */
+    asChild?: boolean;
+    /** CSS classes for each radio option */
+    className?: RadioProps['className'];
+    /** Initially selected value (uncontrolled mode) */
+    defaultChecked?: string;
+    /** Layout direction (row or col) */
+    direction?: 'row' | 'col';
+    /** Label for the group */
+    label?: string | ReactNode;
+    /** Form field name (shared by all radios) */
+    name: string;
+    /** Array of radio options */
+    options: Omit<RadioProps, 'name' | 'checked' | 'defaultChecked'>[];
+    /** Theme override for this component */
+    theme?: Theme;
+    /** Currently selected value (controlled mode) */
+    value?: string;
+    /** CSS classes for the wrapper */
+    wrapperClassName?: string;
+    /** Callback when selection changes */
+    onValueChange?: (value: string) => void;
+}

package/dist/components/RadioGroup/RadioGroup.variants.d.ts

@@ -0,0 +1,3 @@
+export declare const radioGroupVariants: (props?: ({
+    direction?: "col" | "row" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;

package/dist/components/Range/Range.d.ts

@@ -0,0 +1,21 @@
+import { FC } from 'react';
+import { RangeProps } from './Range.types';
+/**
+ * A dual-thumb slider component for selecting a value range.
+ * Built on Radix UI Slider for accessibility.
+ *
+ * @example
+ * ```tsx
+ * <Range
+ *   label="Budget"
+ *   min={0}
+ *   max={10000}
+ *   defaultValue={[2000, 8000]}
+ *   showValue
+ *   name="budget"
+ * />
+ * ```
+ *
+ * @see {@link https://konstructio.github.io/konstruct-ui/?path=/docs/components-range--docs Storybook}
+ */
+export declare const Range: FC<RangeProps>;

package/dist/components/Range/Range.js

@@ -1,37 +1,39 @@
 import { jsxs as r, jsx as e } from "react/jsx-runtime";
-import { R as g, T as R, a as V, b as c } from "../../index-l3NwplN0.js";
-import { forwardRef as v, useRef as b, useState as j, useImperativeHandle as k, useEffect as w, useCallback as y } from "react";
+import { R, T as V, a as v, b as c } from "../../index-Jr0cra7i.js";
+import { forwardRef as b, useRef as j, useState as k, useImperativeHandle as w, useEffect as y, useCallback as C } from "react";
 import { cn as a } from "../../utils/index.js";
-import { rangeOutsideVariants as C, trackVariants as T, thumbVariants as i, rangeVariants as S } from "./Range.variants.js";
-const q = v(
+import { rangeOutsideVariants as T, trackVariants as S, thumbVariants as i, rangeVariants as $ } from "./Range.variants.js";
+const A = b(
   ({
     label: n,
-    defaultValue: u = [0, 100],
-    name: m,
-    theme: o,
+    labelWrapperClassName: u,
+    defaultValue: m = [0, 100],
+    name: o,
+    theme: f,
     size: l,
-    showValue: f,
-    ...d
-  }, h) => {
-    const t = b(null), [s, p] = j(u);
-    k(h, () => t.current, [t]), w(() => {
+    showValue: d,
+    ...h
+  }, p) => {
+    const t = j(null), [s, x] = k(m);
+    w(p, () => t.current, [t]), y(() => {
       t.current && (t.current.value = `[${s.toString()}]`);
     }, [s]);
-    const x = y(
-      (N) => p(N),
+    const N = C(
+      (g) => x(g),
       []
     );
-    return /* @__PURE__ */ r("div", { className: "w-full relative flex flex-col gap-3", "data-theme": o, children: [
+    return /* @__PURE__ */ r("div", { className: "w-full relative flex flex-col gap-3", "data-theme": f, children: [
       /* @__PURE__ */ r(
         "div",
         {
           className: a(
             "flex items-center",
-            n ? "justify-between" : "justify-end"
+            n ? "justify-between" : "justify-end",
+            u
           ),
           children: [
             n ? /* @__PURE__ */ e("label", { children: n }) : null,
-            f ? /* @__PURE__ */ r("span", { className: "text-xs", children: [
+            d ? /* @__PURE__ */ r("span", { className: "text-xs", children: [
               s[0],
               " - ",
               s[1]
@@ -39,16 +41,16 @@ const q = v(
           ]
         }
       ),
-      /* @__PURE__ */ e("input", { ref: t, name: m, className: "hidden", type: "text" }),
+      /* @__PURE__ */ e("input", { ref: t, name: o, className: "hidden", type: "text" }),
       /* @__PURE__ */ r(
-        g,
+        R,
         {
           value: s,
-          className: a(S()),
-          onValueChange: x,
-          ...d,
+          className: a($()),
+          onValueChange: N,
+          ...h,
           children: [
-            /* @__PURE__ */ e(R, { className: a(T({ size: l })), children: /* @__PURE__ */ e(V, { className: a(C()) }) }),
+            /* @__PURE__ */ e(V, { className: a(S({ size: l })), children: /* @__PURE__ */ e(v, { className: a(T()) }) }),
             /* @__PURE__ */ e(c, { className: a(i({ size: l })) }),
             /* @__PURE__ */ e(c, { className: a(i({ size: l })) })
           ]
@@ -58,5 +60,5 @@ const q = v(
   }
 );
 export {
-  q as Range
+  A as Range
 };

package/dist/components/Range/Range.types.d.ts

@@ -0,0 +1,42 @@
+import { SliderProps as SliderPropsBase } from '@radix-ui/react-slider';
+import { VariantProps } from 'class-variance-authority';
+import { Theme } from '../../domain/theme';
+import { rangeVariants } from './Range.variants';
+/**
+ * Props for the Range component.
+ * A dual-thumb slider for selecting a value range.
+ *
+ * @example
+ * ```tsx
+ * <Range
+ *   label="Price Range"
+ *   min={0}
+ *   max={1000}
+ *   defaultValue={[100, 500]}
+ *   showValue
+ *   size="md"
+ * />
+ * ```
+ */
+export interface RangeProps extends VariantProps<typeof rangeVariants> {
+    /** Additional CSS classes */
+    className?: string;
+    /** Initial range values [min, max] */
+    defaultValue?: SliderPropsBase['defaultValue'];
+    /** Label displayed above the range slider */
+    label?: string;
+    /** Additional CSS classes for the label wrapper */
+    labelWrapperClassName?: string;
+    /** Maximum value for the range */
+    max?: SliderPropsBase['max'];
+    /** Minimum value for the range */
+    min?: SliderPropsBase['min'];
+    /** Form field name for the hidden input */
+    name?: string;
+    /** Whether to display the current range values */
+    showValue?: boolean;
+    /** Size of the slider track and thumbs */
+    size?: 'sm' | 'md' | 'lg';
+    /** Theme override for this component */
+    theme?: Theme;
+}

package/dist/components/Range/Range.variants.d.ts

@@ -0,0 +1,8 @@
+export declare const rangeVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;
+export declare const rangeOutsideVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;
+export declare const trackVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const thumbVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;

package/dist/components/Select/Select.d.ts

@@ -0,0 +1,37 @@
+import { FC } from 'react';
+import { SelectProps } from './Select.types';
+export type { OptionGroup, AdditionalOptionGroup } from './Select.types';
+/**
+ * A dropdown select component with search, icons, and infinite scroll support.
+ * Also exported as `Dropdown` for convenience.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <Select
+ *   label="Country"
+ *   options={[
+ *     { value: 'us', label: 'United States' },
+ *     { value: 'uk', label: 'United Kingdom' },
+ *   ]}
+ *   value={selected}
+ *   onChange={(e) => setSelected(e.target.value)}
+ * />
+ *
+ * // Searchable with custom icons
+ * <Select
+ *   label="Select region"
+ *   options={regions.map(r => ({
+ *     value: r.id,
+ *     label: r.name,
+ *     leftIcon: <RegionIcon />,
+ *     subLabel: r.description,
+ *   }))}
+ *   searchable
+ *   highlightSearch
+ * />
+ * ```
+ *
+ * @see {@link https://konstructio.github.io/konstruct-ui/?path=/docs/components-select--docs Storybook}
+ */
+export declare const Select: FC<SelectProps>;

package/dist/components/Select/Select.js

@@ -0,0 +1,71 @@
+import { jsx as r, jsxs as v } from "react/jsx-runtime";
+import { forwardRef as N, useMemo as O } from "react";
+import { cn as a } from "../../utils/index.js";
+import { i as g } from "../../AdditionalOptions-C2FDVZhu.js";
+import { SelectProvider as j } from "./contexts/select.provider.js";
+import { Wrapper as k } from "./components/Wrapper.js";
+const W = N(
+  ({
+    error: e,
+    errorClassName: m,
+    helperText: l,
+    helperTextClassName: n,
+    highlightSearch: o,
+    mainWrapperClassName: p,
+    name: s,
+    value: c,
+    options: t,
+    onChange: d,
+    onBlur: i,
+    ...f
+  }, x) => {
+    const u = O(() => t.length ? g(t.at(0)) ? t.flatMap((h) => h.options) : t : [], [t]);
+    return /* @__PURE__ */ r(
+      j,
+      {
+        highlightSearch: o,
+        name: s,
+        value: c,
+        options: u,
+        onBlur: i,
+        onChange: d,
+        children: /* @__PURE__ */ v("div", { className: a("relative w-full", p), children: [
+          /* @__PURE__ */ r(
+            k,
+            {
+              error: e,
+              name: s,
+              ref: x,
+              onBlur: i,
+              groupedOptions: t,
+              ...f
+            }
+          ),
+          e ? /* @__PURE__ */ r(
+            "span",
+            {
+              className: a(
+                "text-xs text-red-700 dark:text-red-400",
+                m
+              ),
+              children: e
+            }
+          ) : null,
+          !e && l ? /* @__PURE__ */ r(
+            "span",
+            {
+              className: a(
+                "text-xs text-slate-600 dark:text-slate-200",
+                n
+              ),
+              children: l
+            }
+          ) : null
+        ] })
+      }
+    );
+  }
+);
+export {
+  W as Select
+};

package/dist/components/Select/Select.types.d.ts

@@ -0,0 +1,137 @@
+import { VariantProps } from 'class-variance-authority';
+import { InputHTMLAttributes, ReactNode } from 'react';
+import { Theme } from '../../domain/theme';
+import { selectVariants } from './Select.variants';
+/**
+ * Option type for Select dropdown items.
+ *
+ * @example
+ * ```tsx
+ * const options: Option[] = [
+ *   { value: 'us', label: 'United States', leftIcon: <FlagUS /> },
+ *   { value: 'uk', label: 'United Kingdom', subLabel: 'Europe' },
+ * ];
+ * ```
+ */
+export type Option = {
+    /** Display text for the option */
+    label: string;
+    /** Secondary text displayed below the label */
+    subLabel?: string | ReactNode;
+    /** Icon displayed on the left side of the option */
+    leftIcon?: ReactNode | string;
+    /** CSS classes for the left icon */
+    leftIconClassName?: string;
+    /** Show right component when this option is selected */
+    showRightComponentOnselectedValue?: boolean;
+    /** Component displayed on the right side of the option */
+    rightComponent?: ReactNode | string;
+    /** CSS classes for the right component */
+    rightComponentClassName?: string;
+    /** CSS classes for wrapper when this option is selected */
+    wrapperClassNameOnSelectedValue?: string;
+    /** Unique value for the option */
+    value: string;
+};
+/**
+ * A group of options with a non-interactive header label.
+ */
+export type OptionGroup = {
+    groupLabel: string;
+    options: Option[];
+};
+/**
+ * A group of additional options with a non-interactive header label.
+ */
+export type AdditionalOptionGroup = {
+    groupLabel: string;
+    options: ReactNode[];
+};
+export declare const isOptionGroup: (item: Option | OptionGroup) => item is OptionGroup;
+export declare const isAdditionalOptionGroup: (item: unknown) => item is AdditionalOptionGroup;
+type OnChangeFn = (params: {
+    target: {
+        value: string;
+        name: string;
+    };
+}) => void;
+/**
+ * Props for the Select (Dropdown) component.
+ *
+ * @example
+ * ```tsx
+ * // Basic select
+ * <Select
+ *   label="Country"
+ *   options={[
+ *     { value: 'us', label: 'United States' },
+ *     { value: 'uk', label: 'United Kingdom' },
+ *   ]}
+ *   value={country}
+ *   onChange={(e) => setCountry(e.target.value)}
+ * />
+ *
+ * // Searchable select
+ * <Select
+ *   label="Search countries"
+ *   options={countries}
+ *   searchable
+ *   highlightSearch
+ * />
+ *
+ * // With infinite scroll
+ * <Select
+ *   options={options}
+ *   isInfiniteScrollEnabled
+ *   onFetchMoreOptions={async ({ page }) => fetchMore(page)}
+ * />
+ * ```
+ *
+ * @see {@link https://konstructio.github.io/konstruct-ui/?path=/docs/components-select--docs Storybook}
+ */
+export type SelectProps = VariantProps<typeof selectVariants> & Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange'> & {
+    additionalOptions?: ReactNode[] | string[] | AdditionalOptionGroup[];
+    className?: string;
+    disabled?: boolean;
+    error?: string;
+    errorClassName?: string;
+    helperText?: string;
+    helperTextClassName?: string;
+    highlightSearch?: boolean;
+    iconClassName?: string;
+    inputClassName?: string;
+    isLoading?: boolean;
+    isRequired?: boolean;
+    label?: string;
+    labelAction?: ReactNode;
+    labelClassName?: string;
+    labelWrapperClassName?: string;
+    listClassName?: string;
+    listItemClassName?: string;
+    listItemSecondRowClassName?: string;
+    mainWrapperClassName?: string;
+    noOptionsText?: string;
+    options: Option[] | OptionGroup[];
+    searchable?: boolean;
+    showSearchIcon?: boolean;
+    theme?: Theme;
+    value?: string;
+    wrapperClassName?: string;
+    onBlur?: VoidFunction;
+    onChange?: OnChangeFn;
+    onSearchChange?: (searchTerm: string) => void;
+} & ({
+    isInfiniteScrollEnabled: true;
+    onFetchMoreOptions: (params: {
+        page: number;
+        pageSize: number;
+        termOfSearch?: string;
+    }) => Promise<{
+        data: Option[];
+        hasMore: boolean;
+    }>;
+} | {
+    isInfiniteScrollEnabled?: false | undefined;
+    onFetchMoreOptions?: never;
+});
+export {};

package/dist/components/Select/Select.variants.d.ts

@@ -0,0 +1,6 @@
+export declare const selectVariants: (props?: ({
+    hasError?: boolean | null | undefined;
+    disabled?: boolean | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const inputVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;
+export declare const labelVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;

package/dist/components/{Dropdown/Dropdown.variants.js → Select/Select.variants.js}

@@ -11,7 +11,7 @@ const a = e(
     "px-3",
     "py-1",
     "relative",
-    "rounded-md",
+    "rounded",
     "transition-all",
     "w-full",
     "outline-none",
@@ -22,8 +22,9 @@ const a = e(
     "aria-expanded:text-aurora-500",
     "kubefirst:aria-expanded:border-kubefirst-primary",
     "kubefirst:aria-expanded:text-kubefirst-secondary",
-    "dark:border-slate-600",
-    "dark:focus-visible:bg-slate-800"
+    "dark:border-metal-700",
+    "dark:focus-visible:bg-metal-800",
+    "dark:bg-metal-800"
   ],
   {
     variants: {
@@ -32,13 +33,19 @@ const a = e(
           "aria-expanded:border-red-600",
           "aria-expanded:text-red-600",
           "kubefirst:border-red-600",
-          "kubefirst:text-red-600"
+          "kubefirst:text-red-600",
+          "dark:border-red-500"
         ],
         false: ""
+      },
+      disabled: {
+        true: ["cursor-default", "bg-gray-100", "dark:bg-metal-700/80"],
+        false: []
       }
     },
     defaultVariants: {
-      hasError: !1
+      hasError: !1,
+      disabled: !1
     }
   }
 ), t = e([
@@ -46,24 +53,23 @@ const a = e(
   "bg-transparent",
   "border-none",
   "outline-none",
-  "text-zinc-700",
+  "text-metal-700",
   "text-sm",
   "capitalize",
   "placeholder:text-sm",
   "placeholder:normal-case",
   "placeholder:select-none",
-  "dark:placeholder:text-slate-400",
-  "dark:text-slate-50"
-]), n = e([
-  "mb-1",
+  "dark:placeholder:text-metal-400",
+  "dark:text-metal-50"
+]), d = e([
   "cursor-pointer",
   "text-sm",
-  "leading-[20px]",
+  "leading-5",
   "tracking-[0.1px]",
-  "dark:text-slate-50"
+  "dark:text-metal-50"
 ]);
 export {
-  a as dropdownVariants,
   t as inputVariants,
-  n as labelVariants
+  d as labelVariants,
+  a as selectVariants
 };

package/dist/components/Select/components/AdditionalOptions/AdditionalOptions.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+import { Props } from './AdditionalOptions.types';
+export declare const AdditionalOptions: FC<Props>;

package/dist/components/Select/components/AdditionalOptions/AdditionalOptions.js

@@ -0,0 +1,11 @@
+import "react/jsx-runtime";
+import "../../../../index-BvoZGpli.js";
+import "react";
+import "../../../../utils/index.js";
+import { A as s } from "../../../../AdditionalOptions-C2FDVZhu.js";
+import "../List/List.variants.js";
+import "./AdditionalOptions.variants.js";
+import "../../contexts/select.hook.js";
+export {
+  s as AdditionalOptions
+};