@konstructio/ui 0.1.2-alpha.11 → 0.1.2-alpha.110

package/dist/lib/components/PhoneNumberInput/components/Wrapper.d.ts

@@ -0,0 +1,3 @@
+import { ComponentRef, ForwardRefExoticComponent, RefAttributes } from 'react';
+import { Props } from '../PhoneNumberInput.types';
+export declare const Wrapper: ForwardRefExoticComponent<Props & RefAttributes<ComponentRef<'input'>>>;

package/dist/lib/components/PhoneNumberInput/components/index.d.ts

@@ -0,0 +1,2 @@
+export { FlagSelectorList } from './FlagSelectorList/FlagSelectorList';
+export { Wrapper } from './Wrapper';

package/dist/lib/components/PhoneNumberInput/contexts/index.d.ts

@@ -0,0 +1,3 @@
+export * from './phone-number.context';
+export * from './phone-number.provider';
+export * from './phone-number.hook';

package/dist/lib/components/PhoneNumberInput/contexts/phone-number.context.d.ts

@@ -0,0 +1,20 @@
+import { RegionCode } from 'google-libphonenumber';
+import { FC } from 'react';
+export type Country = {
+    code: RegionCode;
+    flag: FC;
+    name: string;
+    prefix: string;
+};
+export type ContextType = {
+    countries: Country[];
+    isOpenSelector: boolean;
+    selectedCountry: Country;
+    termOfSearch: string;
+    value: string;
+    handleOpenSelector: (status?: boolean) => void;
+    handleSelectCountry: (country: Country) => void;
+    onChangeTermOfSearch: (term: string) => void;
+    onChangeValue: (value: string) => void;
+};
+export declare const PhoneNumberContext: import('react').Context<ContextType>;

package/dist/lib/components/PhoneNumberInput/contexts/phone-number.hook.d.ts

@@ -0,0 +1,2 @@
+import { ContextType } from './phone-number.context';
+export declare const usePhoneNumberContext: () => ContextType;

package/dist/lib/components/PhoneNumberInput/contexts/phone-number.provider.d.ts

@@ -0,0 +1,6 @@
+import { FC, PropsWithChildren } from 'react';
+type Props = PropsWithChildren & {
+    defaultCountryCode: string;
+};
+export declare const PhoneNumberProvider: FC<Props>;
+export {};

package/dist/lib/components/PhoneNumberInput/utils/index.d.ts

@@ -0,0 +1,2 @@
+import { Country } from '../contexts';
+export declare const getPhoneMask: (country: Country) => string | undefined;

package/dist/lib/components/PieChart/PieChart.d.ts

@@ -0,0 +1,20 @@
+import { FC } from 'react';
+import { Props } from './PieChart.types';
+/**
+ * A doughnut/pie chart component for data visualization.
+ * Built on Chart.js with support for center text labels.
+ *
+ * @example
+ * ```tsx
+ * <PieChart
+ *   values={[25, 75]}
+ *   colors={['#94a3b8', '#22c55e']}
+ *   title="75%"
+ *   subtitle="Progress"
+ *   cutoutPercentage={80}
+ * />
+ * ```
+ *
+ * @see {@link https://konstructio.github.io/konstruct-ui/?path=/docs/components-piechart--docs Storybook}
+ */
+export declare const PieChart: FC<Props>;

package/dist/lib/components/PieChart/PieChart.types.d.ts

@@ -0,0 +1,90 @@
+type HexColor = `#${string}`;
+type CSSColor = `var(--${string})` | `rgb(${number}, ${number}, ${number})` | `rgba(${number}, ${number}, ${number}, ${number})` | `hsl(${number}, ${number}%, ${number}%)` | `hsla(${number}, ${number}%, ${number}%, ${number})`;
+/**
+ * Props for the PieChart component.
+ * A doughnut/pie chart built on Chart.js for data visualization.
+ *
+ * @example
+ * ```tsx
+ * <PieChart
+ *   values={[30, 70]}
+ *   colors={['#ef4444', '#22c55e']}
+ *   title="70%"
+ *   subtitle="Complete"
+ *   cutoutPercentage={75}
+ * />
+ * ```
+ */
+export type Props = {
+    /**
+     * Array of hexadecimal colors for the borders of the pie chart segments
+     * @default [resolveColor('--color-white'), resolveColor('--color-white')]
+     */
+    borderColors?: HexColor[] | CSSColor[] | (HexColor | CSSColor)[];
+    /**
+     * Width of the border for pie chart segments in pixels
+     * @default 0
+     */
+    borderWidth?: number;
+    /**
+     * Array of hexadecimal colors for filling the pie chart segments
+     * @default [resolveColor('--color-neutral-600'), resolveColor('--color-emerald-400')]
+     */
+    colors?: HexColor[] | CSSColor[] | (HexColor | CSSColor)[];
+    /**
+     * Percentage of the pie chart's center that should be cut out, creating a donut chart effect
+     * @default 80
+     */
+    cutoutPercentage?: number;
+    /**
+     * Whether to redraw the entire chart when props change
+     * @default true
+     */
+    redraw?: boolean;
+    /**
+     * Hexadecimal color for the subtitle text
+     * @default resolveColor('--color-gray-500')
+     */
+    subtitleColor?: HexColor;
+    /**
+     * Font size for the subtitle in pixels
+     * @default 14
+     */
+    subtitleFontSize?: number;
+    /**
+     * Font weight for the subtitle
+     * @default 'normal'
+     */
+    subtitleFontWeight?: 'bold' | 'normal';
+    /**
+     * Hexadecimal color for the title text
+     * @default resolveColor('--color-gray-900')
+     */
+    titleColor?: HexColor;
+    /**
+     * Font size for the title in pixels
+     * @default 16
+     */
+    titleFontSize?: number;
+    /**
+     * Font weight for the title
+     * @default 'bold'
+     */
+    titleFontWeight?: 'bold' | 'normal';
+    /**
+     * Array of numeric values representing data for each segment of the pie chart
+     * @required
+     */
+    values: number[];
+} /**
+ * Union type that enforces either:
+ * - No title and no subtitle
+ * - Title with optional subtitle
+ */ & ({
+    title?: undefined;
+    subtitle?: never;
+} | {
+    title: string;
+    subtitle?: string;
+});
+export {};

package/dist/lib/components/ProgressBar/ProgressBar.d.ts

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

package/dist/lib/components/ProgressBar/ProgressBar.types.d.ts

@@ -0,0 +1,24 @@
+import { ReactNode } from 'react';
+import { VariantProps } from 'class-variance-authority';
+import { Theme } from '../../domain/theme';
+import { progressBarFillVariants } from './ProgressBar.variants';
+export interface Props extends VariantProps<typeof progressBarFillVariants> {
+    /** Accessible name announced for the progress bar */
+    ariaLabel?: string;
+    /** Additional CSS classes for the outer wrapper */
+    className?: string;
+    /** Custom CSS class for the progress bar fill (e.g., "bg-purple-500") */
+    fillClassName?: string;
+    /** Content displayed on the left side (e.g., "26%") */
+    leftContent?: ReactNode;
+    /** Progress percentage (0-100) */
+    percent: number;
+    /** Content displayed on the right side (e.g., "130/500 GB") */
+    rightContent?: ReactNode;
+    /** Theme override for this component */
+    theme?: Theme;
+    /** Custom CSS class for the track background (e.g., "bg-gray-200") */
+    trackClassName?: string;
+}
+/** @deprecated Use Props instead */
+export type ProgressBarProps = Props;

package/dist/lib/components/ProgressBar/ProgressBar.variants.d.ts

@@ -0,0 +1,4 @@
+export declare const progressBarTrackVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;
+export declare const progressBarFillVariants: (props?: ({
+    status?: "success" | "warning" | "error" | "default" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;

package/dist/lib/components/Radio/Radio.d.ts

@@ -0,0 +1,22 @@
+import { FC } from 'react';
+import { Props } from './Radio.types';
+/**
+ * A radio button component with label and optional description.
+ * Use RadioGroup to manage a group of radio buttons.
+ *
+ * @example
+ * ```tsx
+ * <Radio
+ *   name="plan"
+ *   value="basic"
+ *   label="Basic Plan"
+ *   description="Free forever"
+ *   checked={plan === 'basic'}
+ *   onChange={(value) => setPlan(value)}
+ * />
+ * ```
+ *
+ * @see {@link https://konstructio.github.io/konstruct-ui/?path=/docs/components-radio--docs Storybook}
+ */
+declare const Radio: FC<Props>;
+export { Radio };

package/dist/lib/components/Radio/Radio.types.d.ts

@@ -0,0 +1,46 @@
+import { VariantProps } from 'class-variance-authority';
+import { InputHTMLAttributes, ReactNode } from 'react';
+import { Theme } from '../../domain/theme';
+import { radioVariants } from './Radio.variants';
+/**
+ * Props for the Radio component.
+ *
+ * @example
+ * ```tsx
+ * <Radio
+ *   name="plan"
+ *   value="basic"
+ *   label="Basic Plan"
+ *   checked={selected === 'basic'}
+ *   onChange={(value) => setSelected(value)}
+ * />
+ * ```
+ */
+export interface Props extends Omit<InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'disabled'>, VariantProps<typeof radioVariants> {
+    /** Whether the radio is checked */
+    checked?: boolean;
+    /** Initial checked state (uncontrolled) */
+    defaultChecked?: boolean;
+    /** Whether the radio is disabled */
+    disabled?: boolean;
+    /** Label text or element */
+    label?: string | ReactNode;
+    /** CSS classes for the label text */
+    labelTextClassName?: string;
+    /** Form field name (groups radios together) */
+    name: string;
+    /** Description text below the label */
+    description?: string | ReactNode;
+    /** CSS classes for the description */
+    descriptionClassName?: string;
+    /** Value submitted when selected */
+    value: string;
+    /** CSS classes for the wrapper */
+    wrapperClassName?: string;
+    /** Theme override for this component */
+    theme?: Theme;
+    /** Callback when selected */
+    onChange?: (value: string) => void;
+}
+/** @deprecated Use Props instead */
+export type RadioProps = Props;

package/dist/lib/components/Radio/Radio.variants.d.ts

@@ -0,0 +1,8 @@
+export declare const wrapperRadioVariants: (props?: ({
+    disabled?: boolean | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const radioVariants: (props?: ({
+    disabled?: boolean | null | undefined;
+    checked?: boolean | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export declare const labelRadioVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;

package/dist/lib/components/RadioCard/RadioCard.d.ts

@@ -0,0 +1,22 @@
+import { FC } from 'react';
+import { Props } from './RadioCard.types';
+/**
+ * A card-style radio button for visually prominent selection options.
+ * Use RadioCardGroup to manage a group of radio cards.
+ *
+ * @example
+ * ```tsx
+ * <RadioCard
+ *   name="tier"
+ *   value="enterprise"
+ *   label="Enterprise"
+ *   description="Custom pricing"
+ *   checked={tier === 'enterprise'}
+ *   onChange={(value) => setTier(value)}
+ * />
+ * ```
+ *
+ * @see {@link https://konstructio.github.io/konstruct-ui/?path=/docs/components-radiocard--docs Storybook}
+ */
+declare const RadioCard: FC<Props>;
+export { RadioCard };

package/dist/lib/components/RadioCard/RadioCard.types.d.ts

@@ -0,0 +1,25 @@
+import { Theme } from '../../domain/theme';
+import { Props as CardProps } from '../Card/Card.types';
+import { Props as RadioProps } from '../Radio/Radio.types';
+/**
+ * Props for the RadioCard component.
+ * Combines Card styling with Radio functionality.
+ *
+ * @example
+ * ```tsx
+ * <RadioCard
+ *   name="plan"
+ *   value="pro"
+ *   label="Pro Plan"
+ *   description="$29/month"
+ *   checked={selected === 'pro'}
+ *   onChange={(value) => setSelected(value)}
+ * />
+ * ```
+ */
+export type Props = Omit<CardProps, 'canHover' | 'isActive'> & Pick<RadioProps, 'name' | 'value' | 'checked' | 'onChange' | 'label' | 'disabled' | 'defaultChecked' | 'labelTextClassName' | 'description' | 'descriptionClassName'> & {
+    labelWrapperClassName?: string;
+    theme?: Theme;
+};
+/** @deprecated Use Props instead */
+export type RadioCardProps = Props;

package/dist/lib/components/RadioCard/RadioCard.variants.d.ts

@@ -0,0 +1 @@
+export declare const radioCardVariants: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;

package/dist/lib/components/RadioCardGroup/RadioCardGroup.d.ts

@@ -0,0 +1,23 @@
+import { FC } from 'react';
+import { Props } from './RadioCardGroup.types';
+/**
+ * A group of card-style radio buttons with shared state management.
+ *
+ * @example
+ * ```tsx
+ * <RadioCardGroup
+ *   name="plan"
+ *   direction="row"
+ *   options={[
+ *     { value: 'starter', label: 'Starter', description: 'For individuals' },
+ *     { value: 'team', label: 'Team', description: 'For small teams' },
+ *     { value: 'business', label: 'Business', description: 'For organizations' },
+ *   ]}
+ *   defaultChecked="team"
+ *   onValueChange={(value) => console.log(value)}
+ * />
+ * ```
+ *
+ * @see {@link https://konstructio.github.io/konstruct-ui/?path=/docs/components-radiocardgroup--docs Storybook}
+ */
+export declare const RadioCardGroup: FC<Props>;

package/dist/lib/components/RadioCardGroup/RadioCardGroup.types.d.ts

@@ -0,0 +1,32 @@
+import { Theme } from '../../domain/theme';
+import { Props as RadioCardProps } from '../RadioCard/RadioCard.types';
+/**
+ * Props for the RadioCardGroup component.
+ *
+ * @example
+ * ```tsx
+ * <RadioCardGroup
+ *   name="pricing"
+ *   options={[
+ *     { value: 'basic', label: 'Basic', description: '$9/mo' },
+ *     { value: 'pro', label: 'Pro', description: '$29/mo' },
+ *     { value: 'enterprise', label: 'Enterprise', description: 'Custom' },
+ *   ]}
+ *   defaultChecked="pro"
+ *   onValueChange={(value) => setTier(value)}
+ * />
+ * ```
+ */
+export type Props = {
+    asChild?: boolean;
+    className?: string;
+    defaultChecked?: string;
+    direction?: 'row' | 'col';
+    name: string;
+    options: Omit<RadioCardProps, 'name' | 'checked' | 'defaultChecked'>[];
+    theme?: Theme;
+    wrapperClassName?: string;
+    onValueChange?: (value: string) => void;
+};
+/** @deprecated Use Props instead */
+export type RadioCardGroupProps = Props;

package/dist/lib/components/RadioCardGroup/RadioCardGroup.variants.d.ts

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

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

@@ -0,0 +1,34 @@
+import { FC } from 'react';
+import { Props } 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<Props>;

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

@@ -0,0 +1,46 @@
+import { ReactNode } from 'react';
+import { Theme } from '../../domain/theme';
+import { Props as 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 Props {
+    /** 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); `null` selects nothing */
+    value?: string | null;
+    /** CSS classes for the wrapper */
+    wrapperClassName?: string;
+    /** Callback when selection changes */
+    onValueChange?: (value: string) => void;
+}
+/** @deprecated Use Props instead */
+export type RadioGroupProps = Props;

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

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

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

@@ -0,0 +1,21 @@
+import { FC } from 'react';
+import { Props } 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<Props>;

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

@@ -0,0 +1,44 @@
+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 Props 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;
+}
+/** @deprecated Use Props instead */
+export type RangeProps = Props;

package/dist/lib/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/lib/components/Select/Select.d.ts

@@ -0,0 +1,37 @@
+import { FC } from 'react';
+import { Props } 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<Props>;