@blencm/ui 0.0.1

package/dist/types/input.d.ts

@@ -0,0 +1,4 @@
+export type InputVariantProps = 'outline' | 'soft' | 'ghost' | 'filled' | 'flushed' | 'unstyled' | 'link';
+export declare const inputVariants: Record<InputVariantProps, string>;
+export type InputVariant = keyof typeof inputVariants;
+export declare const variants: Record<InputVariant, string>;

package/dist/types/select.d.ts

@@ -0,0 +1,4 @@
+export type SelectVariantProps = 'outline' | 'soft' | 'ghost' | 'filled' | 'flushed' | 'unstyled' | 'link';
+export declare const selectVariants: Record<SelectVariantProps, string>;
+export type SelectVariant = keyof typeof selectVariants;
+export declare const variants: Record<SelectVariant, string>;

package/dist/utils/date-formats.d.ts

@@ -0,0 +1,387 @@
+export declare const dateFormats: {
+    /**
+     * Localized short date.
+     * Example with en-US: 06/04/2026
+     */
+    readonly short: "P";
+    /**
+     * Localized medium date.
+     * Example with en-US: Jun 4, 2026
+     */
+    readonly medium: "PP";
+    /**
+     * Localized long date.
+     * Example with en-US: June 4th, 2026
+     */
+    readonly long: "PPP";
+    /**
+     * Localized full date.
+     * Example with en-US: Thursday, June 4th, 2026
+     */
+    readonly full: "PPPP";
+    /**
+     * Alias for the localized long date format.
+     * Example with en-US: June 4th, 2026
+     */
+    readonly demo: "PPP";
+    /**
+     * ISO date format, recommended for APIs and databases.
+     * Example: 2026-06-04
+     */
+    readonly iso: "yyyy-MM-dd";
+    /**
+     * ISO-like date and time format without timezone.
+     * Example: 2026-06-04T14:30:00
+     */
+    readonly isoDateTime: "yyyy-MM-dd'T'HH:mm:ss";
+    /**
+     * ISO-like date and time format with timezone offset.
+     * Example: 2026-06-04T14:30:00-05:00
+     */
+    readonly isoDateTimeWithZone: "yyyy-MM-dd'T'HH:mm:ssXXX";
+    /**
+     * SQL-style date and time format.
+     * Example: 2026-06-04 14:30:00
+     */
+    readonly sqlDateTime: "yyyy-MM-dd HH:mm:ss";
+    /**
+     * Compact numeric date format.
+     * Example: 20260604
+     */
+    readonly compact: "yyyyMMdd";
+    /**
+     * Compact numeric date and time format.
+     * Example: 20260604143000
+     */
+    readonly compactDateTime: "yyyyMMddHHmmss";
+    /**
+     * Latin America date format.
+     * Example: 04/06/2026
+     */
+    readonly latam: "dd/MM/yyyy";
+    /**
+     * United States date format.
+     * Example: 06/04/2026
+     */
+    readonly us: "MM/dd/yyyy";
+    /**
+     * Year, month, and day with slashes.
+     * Example: 2026/06/04
+     */
+    readonly ymdSlash: "yyyy/MM/dd";
+    /**
+     * Day, month, and year with slashes.
+     * Example: 04/06/2026
+     */
+    readonly dmySlash: "dd/MM/yyyy";
+    /**
+     * Month, day, and year with slashes.
+     * Example: 06/04/2026
+     */
+    readonly mdySlash: "MM/dd/yyyy";
+    /**
+     * Year, month, and day with dashes.
+     * Example: 2026-06-04
+     */
+    readonly ymdDash: "yyyy-MM-dd";
+    /**
+     * Day, month, and year with dashes.
+     * Example: 04-06-2026
+     */
+    readonly dmyDash: "dd-MM-yyyy";
+    /**
+     * Month, day, and year with dashes.
+     * Example: 06-04-2026
+     */
+    readonly mdyDash: "MM-dd-yyyy";
+    /**
+     * Alias for day, month, and year with dashes.
+     * Example: 04-06-2026
+     */
+    readonly dash: "dd-MM-yyyy";
+    /**
+     * Year, month, and day with dots.
+     * Example: 2026.06.04
+     */
+    readonly ymdDot: "yyyy.MM.dd";
+    /**
+     * Day, month, and year with dots.
+     * Example: 04.06.2026
+     */
+    readonly dmyDot: "dd.MM.yyyy";
+    /**
+     * Month, day, and year with dots.
+     * Example: 06.04.2026
+     */
+    readonly mdyDot: "MM.dd.yyyy";
+    /**
+     * Alias for day, month, and year with dots.
+     * Example: 04.06.2026
+     */
+    readonly dot: "dd.MM.yyyy";
+    /**
+     * Short year with slashes.
+     * Example: 04/06/26
+     */
+    readonly shortYearSlash: "dd/MM/yy";
+    /**
+     * Short year with dashes.
+     * Example: 04-06-26
+     */
+    readonly shortYearDash: "dd-MM-yy";
+    /**
+     * Short year with dots.
+     * Example: 04.06.26
+     */
+    readonly shortYearDot: "dd.MM.yy";
+    /**
+     * Date with abbreviated month name.
+     * Example: 04 Jun 2026
+     */
+    readonly shortMonth: "dd MMM yyyy";
+    /**
+     * Date with full month name.
+     * Example: 04 June 2026
+     */
+    readonly longMonth: "dd MMMM yyyy";
+    /**
+     * Month name first with abbreviated month.
+     * Example: Jun 04, 2026
+     */
+    readonly shortMonthFirst: "MMM dd, yyyy";
+    /**
+     * Month name first with full month.
+     * Example: June 04, 2026
+     */
+    readonly longMonthFirst: "MMMM dd, yyyy";
+    /**
+     * Ordinal day with abbreviated month.
+     * Example: 4th Jun 2026
+     */
+    readonly ordinalShortMonth: "do MMM yyyy";
+    /**
+     * Ordinal day with full month.
+     * Example: 4th June 2026
+     */
+    readonly ordinalLongMonth: "do MMMM yyyy";
+    /**
+     * Month and year with abbreviated month.
+     * Example: Jun 2026
+     */
+    readonly shortMonthYear: "MMM yyyy";
+    /**
+     * Month and year with full month.
+     * Example: June 2026
+     */
+    readonly monthYear: "MMMM yyyy";
+    /**
+     * Numeric month and year.
+     * Example: 06/2026
+     */
+    readonly numericMonthYear: "MM/yyyy";
+    /**
+     * Year and numeric month.
+     * Example: 2026-06
+     */
+    readonly yearMonth: "yyyy-MM";
+    /**
+     * Full month only.
+     * Example: June
+     */
+    readonly month: "MMMM";
+    /**
+     * Abbreviated month only.
+     * Example: Jun
+     */
+    readonly monthShort: "MMM";
+    /**
+     * Numeric month only.
+     * Example: 06
+     */
+    readonly monthNumber: "MM";
+    /**
+     * Numeric month only without leading zero.
+     * Example: 6
+     */
+    readonly monthNumberPlain: "M";
+    /**
+     * Date with abbreviated weekday and month names.
+     * Example: Thu, 04 Jun 2026
+     */
+    readonly weekdayShort: "EEE, dd MMM yyyy";
+    /**
+     * Date with full weekday and month names.
+     * Example: Thursday, 04 June 2026
+     */
+    readonly weekdayLong: "EEEE, dd MMMM yyyy";
+    /**
+     * Full weekday with localized long date.
+     * Example: Thursday, June 4th, 2026
+     */
+    readonly weekdayFullLocalized: "EEEE, PPP";
+    /**
+     * Abbreviated weekday only.
+     * Example: Thu
+     */
+    readonly weekdayNameShort: "EEE";
+    /**
+     * Full weekday only.
+     * Example: Thursday
+     */
+    readonly weekdayNameLong: "EEEE";
+    /**
+     * Numeric ISO day of week.
+     * Example: 4
+     */
+    readonly weekdayNumber: "i";
+    /**
+     * Day of month with leading zero.
+     * Example: 04
+     */
+    readonly day: "dd";
+    /**
+     * Day of month without leading zero.
+     * Example: 4
+     */
+    readonly dayPlain: "d";
+    /**
+     * Ordinal day of month.
+     * Example: 4th
+     */
+    readonly dayOrdinal: "do";
+    /**
+     * Day of year.
+     * Example: 155
+     */
+    readonly dayOfYear: "D";
+    /**
+     * Full year.
+     * Example: 2026
+     */
+    readonly year: "yyyy";
+    /**
+     * Short year.
+     * Example: 26
+     */
+    readonly yearShort: "yy";
+    /**
+     * Time using 24-hour format.
+     * Example: 14:30
+     */
+    readonly time24: "HH:mm";
+    /**
+     * Time using 24-hour format with seconds.
+     * Example: 14:30:45
+     */
+    readonly time24Seconds: "HH:mm:ss";
+    /**
+     * Time using 12-hour format.
+     * Example: 02:30 PM
+     */
+    readonly time12: "hh:mm a";
+    /**
+     * Time using 12-hour format with seconds.
+     * Example: 02:30:45 PM
+     */
+    readonly time12Seconds: "hh:mm:ss a";
+    /**
+     * Localized short time.
+     * Example with en-US: 2:30 PM
+     */
+    readonly timeLocalizedShort: "p";
+    /**
+     * Localized long time.
+     * Example with en-US: 2:30:45 PM
+     */
+    readonly timeLocalizedLong: "pp";
+    /**
+     * Date and time using 24-hour format.
+     * Example: 04/06/2026 14:30
+     */
+    readonly dateTime24: "dd/MM/yyyy HH:mm";
+    /**
+     * Date and time using 24-hour format with seconds.
+     * Example: 04/06/2026 14:30:45
+     */
+    readonly dateTime24Seconds: "dd/MM/yyyy HH:mm:ss";
+    /**
+     * Date and time using 12-hour format.
+     * Example: 04/06/2026 02:30 PM
+     */
+    readonly dateTime12: "dd/MM/yyyy hh:mm a";
+    /**
+     * Date and time using 12-hour format with seconds.
+     * Example: 04/06/2026 02:30:45 PM
+     */
+    readonly dateTime12Seconds: "dd/MM/yyyy hh:mm:ss a";
+    /**
+     * Month name date and 24-hour time.
+     * Example: 04 June 2026 14:30
+     */
+    readonly longDateTime24: "dd MMMM yyyy HH:mm";
+    /**
+     * Month name date and 12-hour time.
+     * Example: 04 June 2026 02:30 PM
+     */
+    readonly longDateTime12: "dd MMMM yyyy hh:mm a";
+    /**
+     * Full weekday date and 24-hour time.
+     * Example: Thursday, 04 June 2026 14:30
+     */
+    readonly weekdayDateTime24: "EEEE, dd MMMM yyyy HH:mm";
+    /**
+     * Full weekday date and 12-hour time.
+     * Example: Thursday, 04 June 2026 02:30 PM
+     */
+    readonly weekdayDateTime12: "EEEE, dd MMMM yyyy hh:mm a";
+    /**
+     * Localized short date and time.
+     * Example with en-US: 06/04/2026, 2:30 PM
+     */
+    readonly localizedDateTimeShort: "Pp";
+    /**
+     * Localized medium date and time.
+     * Example with en-US: Jun 4, 2026, 2:30 PM
+     */
+    readonly localizedDateTimeMedium: "PPp";
+    /**
+     * Localized long date and time.
+     * Example with en-US: June 4th, 2026 at 2:30 PM
+     */
+    readonly localizedDateTimeLong: "PPPp";
+    /**
+     * Localized full date and time.
+     * Example with en-US: Thursday, June 4th, 2026 at 2:30 PM
+     */
+    readonly localizedDateTimeFull: "PPPPp";
+    /**
+     * Numeric quarter.
+     * Example: 2
+     */
+    readonly quarter: "Q";
+    /**
+     * Ordinal quarter.
+     * Example: 2nd quarter
+     */
+    readonly quarterOrdinal: "Qo 'quarter'";
+    /**
+     * Quarter and year.
+     * Example: Q2 2026
+     */
+    readonly quarterYear: "'Q'Q yyyy";
+    /**
+     * Ordinal quarter and year.
+     * Example: 2nd quarter 2026
+     */
+    readonly quarterOrdinalYear: "Qo 'quarter' yyyy";
+};
+export type DateFormatKey = keyof typeof dateFormats;
+export type DateFormatValue = DateFormatKey | (string & {});
+export type DateFormatItem = {
+    value: DateFormatKey;
+    label: string;
+    description: string;
+    pattern: string;
+};
+export declare const dateFormatItems: DateFormatItem[];
+export declare function resolveDateFormat(value?: DateFormatValue | null, fallback?: DateFormatKey): "'Q'Q yyyy" | "D" | "EEE" | "EEE, dd MMM yyyy" | "EEEE" | "EEEE, PPP" | "EEEE, dd MMMM yyyy" | "EEEE, dd MMMM yyyy HH:mm" | "EEEE, dd MMMM yyyy hh:mm a" | "HH:mm" | "HH:mm:ss" | "M" | "MM" | "MM-dd-yyyy" | "MM.dd.yyyy" | "MM/dd/yyyy" | "MM/yyyy" | "MMM" | "MMM dd, yyyy" | "MMM yyyy" | "MMMM" | "MMMM dd, yyyy" | "MMMM yyyy" | "P" | "PP" | "PPP" | "PPPP" | "PPPPp" | "PPPp" | "PPp" | "Pp" | "Q" | "Qo 'quarter'" | "Qo 'quarter' yyyy" | "d" | "dd" | "dd MMM yyyy" | "dd MMMM yyyy" | "dd MMMM yyyy HH:mm" | "dd MMMM yyyy hh:mm a" | "dd-MM-yy" | "dd-MM-yyyy" | "dd.MM.yy" | "dd.MM.yyyy" | "dd/MM/yy" | "dd/MM/yyyy" | "dd/MM/yyyy HH:mm" | "dd/MM/yyyy HH:mm:ss" | "dd/MM/yyyy hh:mm a" | "dd/MM/yyyy hh:mm:ss a" | "do" | "do MMM yyyy" | "do MMMM yyyy" | "hh:mm a" | "hh:mm:ss a" | "i" | "p" | "pp" | "yy" | "yyyy" | "yyyy-MM" | "yyyy-MM-dd" | "yyyy-MM-dd HH:mm:ss" | "yyyy-MM-dd'T'HH:mm:ss" | "yyyy-MM-dd'T'HH:mm:ssXXX" | "yyyy.MM.dd" | "yyyy/MM/dd" | "yyyyMMdd" | "yyyyMMddHHmmss";

package/dist/utils/form-utils.d.ts

@@ -0,0 +1,43 @@
+import * as React from "react";
+export type SelectOption<TData = unknown> = {
+    value: string;
+    label: React.ReactNode;
+    disabled?: boolean;
+    data?: TData;
+};
+export type FormInputVariantProps = "outline" | "soft" | "ghost" | "filled" | "flushed" | "unstyled" | "link";
+export declare const formInputVariants: Record<FormInputVariantProps, string>;
+export type InputVariant = keyof typeof formInputVariants;
+/**
+ * Variantes equivalentes para controles compuestos:
+ * SearchableSelect, combobox, wrappers con input interno, etc.
+ * Usan focus-within porque el foco real vive dentro del wrapper.
+ */
+export declare const formCompositeVariants: Record<InputVariant, string>;
+export declare const variants: Record<InputVariant, string>;
+export type SizeProps = "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
+export type VariantProps = InputVariant;
+/**
+ * Backward-compatible aliases.
+ */
+export type FormSizeProps = SizeProps;
+export type FormVariantProps = VariantProps;
+export type SizeClasses = {
+    control: string;
+    flushedControl: string;
+    linkControl: string;
+    selectItem: string;
+    searchInput: string;
+    checkbox: string;
+    label: string;
+    description: string;
+    message: string;
+};
+export type CustomSize = Partial<SizeClasses>;
+export declare const formSizeVariants: Record<SizeProps, SizeClasses>;
+export declare const formControlBase = "relative inline-flex w-full items-center justify-between gap-2 text-foreground outline-none transition data-[placeholder]:text-muted-foreground disabled:cursor-not-allowed disabled:opacity-50";
+export declare const formCompositeControlBase = "relative flex w-full items-center gap-2 text-foreground outline-none transition";
+export declare const formControlErrorClass = "border-destructive focus:border-destructive focus:ring-destructive/20";
+export declare const formCompositeControlErrorClass = "border-destructive focus-within:border-destructive focus-within:ring-destructive/20";
+export declare function getFormSizeClasses(size?: SizeProps, customSize?: CustomSize): SizeClasses;
+export declare function getFormControlSizeClass(variant: VariantProps, sizeClasses: SizeClasses): string;

package/dist/utils/time-formats.d.ts

@@ -0,0 +1,157 @@
+export declare const timeFormats: {
+    /**
+     * Localized short time.
+     * Example with en-US: 2:30 PM
+     */
+    readonly short: "p";
+    /**
+     * Localized medium time.
+     * Example with en-US: 2:30:45 PM
+     */
+    readonly medium: "pp";
+    /**
+     * Localized long time.
+     * Example with en-US: 2:30:45 PM GMT-5
+     */
+    readonly long: "ppp";
+    /**
+     * Localized full time.
+     * Example with en-US: 2:30:45 PM GMT-05:00
+     */
+    readonly full: "pppp";
+    /**
+     * Default time picker format.
+     * Example: 14:30
+     */
+    readonly demo: "HH:mm";
+    /**
+     * Recommended format for APIs when seconds are not required.
+     * Example: 14:30
+     */
+    readonly api: "HH:mm";
+    /**
+     * Recommended database time format.
+     * Example: 14:30:00
+     */
+    readonly database: "HH:mm:ss";
+    /**
+     * HTML time input compatible format.
+     * Example: 14:30
+     */
+    readonly input: "HH:mm";
+    /**
+     * ISO-like time format without timezone.
+     * Example: 14:30:00
+     */
+    readonly iso: "HH:mm:ss";
+    /**
+     * ISO-like time format with milliseconds.
+     * Example: 14:30:00.000
+     */
+    readonly isoMilliseconds: "HH:mm:ss.SSS";
+    /**
+     * Time using 24-hour format.
+     * Example: 14:30
+     */
+    readonly time24: "HH:mm";
+    /**
+     * Time using 24-hour format with seconds.
+     * Example: 14:30:45
+     */
+    readonly time24Seconds: "HH:mm:ss";
+    /**
+     * Time using 24-hour format with milliseconds.
+     * Example: 14:30:45.123
+     */
+    readonly time24Milliseconds: "HH:mm:ss.SSS";
+    /**
+     * Hour only using 24-hour format with leading zero.
+     * Example: 09
+     */
+    readonly hour24: "HH";
+    /**
+     * Hour only using 24-hour format without leading zero.
+     * Example: 9
+     */
+    readonly hour24Plain: "H";
+    /**
+     * Hour and minutes using 24-hour format.
+     * Example: 14:30
+     */
+    readonly hourMinute24: "HH:mm";
+    /**
+     * Hour, minutes, and seconds using 24-hour format.
+     * Example: 14:30:45
+     */
+    readonly hourMinuteSecond24: "HH:mm:ss";
+    /**
+     * Time using 12-hour format.
+     * Example: 02:30 PM
+     */
+    readonly time12: "hh:mm a";
+    /**
+     * Time using 12-hour format with seconds.
+     * Example: 02:30:45 PM
+     */
+    readonly time12Seconds: "hh:mm:ss a";
+    /**
+     * Time using 12-hour format with milliseconds.
+     * Example: 02:30:45.123 PM
+     */
+    readonly time12Milliseconds: "hh:mm:ss.SSS a";
+    /**
+     * Hour only using 12-hour format with leading zero.
+     * Example: 02 PM
+     */
+    readonly hour12: "hh a";
+    /**
+     * Hour only using 12-hour format without leading zero.
+     * Example: 2 PM
+     */
+    readonly hour12Plain: "h a";
+    /**
+     * Hour and minutes using 12-hour format.
+     * Example: 02:30 PM
+     */
+    readonly hourMinute12: "hh:mm a";
+    /**
+     * Hour, minutes, and seconds using 12-hour format.
+     * Example: 02:30:45 PM
+     */
+    readonly hourMinuteSecond12: "hh:mm:ss a";
+    /**
+     * Compact 24-hour time without separator.
+     * Example: 1430
+     */
+    readonly compact: "HHmm";
+    /**
+     * Compact 24-hour time with seconds.
+     * Example: 143045
+     */
+    readonly compactSeconds: "HHmmss";
+    /**
+     * Minutes only.
+     * Example: 30
+     */
+    readonly minutes: "mm";
+    /**
+     * Seconds only.
+     * Example: 45
+     */
+    readonly seconds: "ss";
+    /**
+     * AM/PM marker.
+     * Example: PM
+     */
+    readonly period: "a";
+};
+export type TimeFormatKey = keyof typeof timeFormats;
+export type TimeFormatValue = TimeFormatKey | (string & {});
+export type TimeFormatItem = {
+    value: TimeFormatKey;
+    label: string;
+    description: string;
+    pattern: string;
+};
+export declare const timeFormatItems: TimeFormatItem[];
+export declare function resolveTimeFormat(value?: TimeFormatValue | null, fallback?: TimeFormatKey): "H" | "HH" | "HH:mm" | "HH:mm:ss" | "HH:mm:ss.SSS" | "HHmm" | "HHmmss" | "a" | "h a" | "hh a" | "hh:mm a" | "hh:mm:ss a" | "hh:mm:ss.SSS a" | "mm" | "p" | "pp" | "ppp" | "pppp" | "ss";

package/dist/utils/utils.d.ts

@@ -0,0 +1,2 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;