@mccustomapps/helaui 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,341 @@
+/** Default Sinhala font stack used by HelaUI. */
+declare const SINHALA_FONT_FAMILY = "\"Noto Sans Sinhala\", \"Iskoola Pota\", \"FM Abhaya\", sans-serif";
+/** Inline styles object for applying Sinhala typography. */
+declare const sinhalaFontStyles: {
+    readonly fontFamily: "\"Noto Sans Sinhala\", \"Iskoola Pota\", \"FM Abhaya\", sans-serif";
+};
+/** CSS class name applied by {@link applySinhalaFont}. */
+declare const SINHALA_FONT_CLASS = "helaui-sinhala";
+/**
+ * Applies Sinhala font styling to a DOM element.
+ * Import `helaui/sinhala.css` once in your app for the font files to load.
+ */
+declare function applySinhalaFont(element: HTMLElement): void;
+
+/** Supported HelaUI locales. */
+type HelaLocale = 'en' | 'si';
+interface TextFieldStrings {
+    label: string;
+    placeholder: string;
+    value?: string;
+}
+interface HelaTextFieldTranslations {
+    name: TextFieldStrings;
+    password: TextFieldStrings;
+    email: TextFieldStrings;
+    disabled: TextFieldStrings;
+}
+interface CalendarStrings {
+    monthNames: [string, string, string, string, string, string, string, string, string, string, string, string];
+    sinhalaMonthNames: [string, string, string, string, string, string, string, string, string, string, string, string];
+    weekdayNames: [string, string, string, string, string, string, string];
+    shortWeekdayNames: [string, string, string, string, string, string, string];
+    buddhistEra: string;
+    today: string;
+    clear: string;
+    selectMonth: string;
+    poyaDay: string;
+}
+/** Built-in translation shape shipped with HelaUI. */
+interface HelaTranslations {
+    textField: HelaTextFieldTranslations;
+    calendar: CalendarStrings;
+}
+type TextFieldVariant = keyof HelaTextFieldTranslations;
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+/** User overrides may extend built-in keys with custom translation trees. */
+type LocaleTranslationOverrides = DeepPartial<HelaTranslations> & {
+    [key: string]: unknown;
+};
+type HelaTranslationOverrides = Partial<Record<HelaLocale, LocaleTranslationOverrides>>;
+
+/** Default HelaUI translations — English and Sinhala. */
+declare const defaultTranslations: Record<HelaLocale, HelaTranslations>;
+
+interface ApplyTranslationsOptions {
+    /** Active locale. When omitted, keeps the current locale. */
+    locale?: HelaLocale;
+    /** Partial overrides merged on top of built-in defaults (per locale). */
+    overrides?: HelaTranslationOverrides;
+}
+/**
+ * Sets the active locale and/or merges user translation overrides.
+ * Follows the same partial-override pattern as `applyTheme`.
+ *
+ * @example
+ * setLocale('si');
+ * applyTranslations({ overrides: { en: { textField: { name: { label: 'Full name' } } } } });
+ */
+declare function applyTranslations(options?: ApplyTranslationsOptions): LocaleTranslationOverrides;
+/** Sets the active locale and notifies locale-aware components. */
+declare function setLocale(locale: HelaLocale): LocaleTranslationOverrides;
+/** Returns the active locale. */
+declare function getLocale(): HelaLocale;
+/** Resets user overrides back to built-in defaults. */
+declare function resetTranslations(): LocaleTranslationOverrides;
+/**
+ * Resolves a dot-separated translation key for the active (or given) locale.
+ * Falls back to English, then returns the key if unresolved.
+ */
+declare function t(path: string, locale?: HelaLocale): string;
+/** Built-in TextField strings for a variant in the active (or given) locale. */
+declare function getTextFieldTranslation(variant: TextFieldVariant, locale?: HelaLocale): TextFieldStrings;
+/** Built-in Calendar strings for the active (or given) locale. */
+declare function getCalendarTranslation(locale?: HelaLocale): CalendarStrings;
+/** Subscribe to locale or override changes. Returns an unsubscribe function. */
+declare function subscribeLocaleChange(listener: () => void): () => void;
+
+interface TextFieldOptions {
+    /**
+  
+     * Built-in translation variant — resolves label and placeholder from the active locale.
+  
+     * User-provided `label` / `placeholder` take precedence over variant strings.
+  
+     */
+    variant?: TextFieldVariant;
+    /** Translation key for label (dot path, e.g. `textField.name.label`). */
+    labelKey?: string;
+    /** Translation key for placeholder (dot path, e.g. `textField.name.placeholder`). */
+    placeholderKey?: string;
+    /** Explicit label — overrides variant and labelKey. */
+    label?: string;
+    /** Explicit placeholder — overrides variant and placeholderKey. */
+    placeholder?: string;
+    type?: 'text' | 'password' | 'email';
+    value?: string;
+    id?: string;
+    /** Apply Sinhala font styling. When omitted on locale-aware fields, follows active locale. */
+    sinhala?: boolean;
+}
+declare class TextField {
+    readonly element: HTMLDivElement;
+    readonly input: HTMLInputElement;
+    private readonly labelEl?;
+    private readonly unsubscribeLocale?;
+    private readonly localeAware;
+    private readonly fixedLabel?;
+    private readonly fixedPlaceholder?;
+    private readonly fixedValue?;
+    private readonly variant?;
+    private readonly labelKey?;
+    private readonly placeholderKey?;
+    private readonly sinhalaExplicit;
+    private readonly sinhalaEnabled;
+    constructor(options?: TextFieldOptions);
+    private resolveStrings;
+    private applyLocaleStrings;
+    getValue(): string;
+    setValue(value: string): void;
+    focus(): void;
+    setDisabled(disabled: boolean): void;
+    setLabel(label: string): void;
+    setPlaceholder(placeholder: string): void;
+    setSinhala(enabled: boolean): void;
+    /** Removes locale subscription. Call when discarding the field. */
+    destroy(): void;
+}
+
+/** Built-in rain sprite URLs shipped with HelaUI. */
+declare const BUILTIN_RAIN_IMAGES: readonly [string, string, string, string];
+
+interface RainBackgroundOptions {
+    /** Image URLs used as falling particles. Defaults to {@link BUILTIN_RAIN_IMAGES}. */
+    images?: string[];
+    /** Number of particles visible at once. Defaults to 28. */
+    density?: number;
+    /** Minimum particle width in pixels. Defaults to 28. */
+    minSize?: number;
+    /** Maximum particle width in pixels. Defaults to 72. */
+    maxSize?: number;
+    /** Minimum fall duration in seconds. Defaults to 8. */
+    minDuration?: number;
+    /** Maximum fall duration in seconds. Defaults to 18. */
+    maxDuration?: number;
+    /** Container to mount into. Defaults to `document.body`. */
+    target?: HTMLElement;
+    /** Stacking order. Defaults to 0. */
+    zIndex?: number;
+}
+/** Full-screen animated background with falling image particles. */
+declare class RainBackground {
+    readonly element: HTMLDivElement;
+    constructor(options?: RainBackgroundOptions);
+    private createDrop;
+    /** Removes the background from the DOM. */
+    destroy(): void;
+}
+/** Default rain sprite filenames shipped with HelaUI. */
+declare const DEFAULT_RAIN_IMAGES: readonly ["fritter.png", "swirl.png", "kokis.png", "leaf.png"];
+/** Builds image URLs from a base path (e.g. `/assets/rain/`). */
+declare function getDefaultRainImageUrls(basePath: string): string[];
+
+interface CalendarOptions {
+    /** Initial selected date (Date instance or YYYY-MM-DD string) */
+    value?: Date | string;
+    /** Initial displayed year & month (defaults to active value or current date) */
+    initialDate?: Date;
+    /** Minimum selectable date */
+    minDate?: Date;
+    /** Maximum selectable date */
+    maxDate?: Date;
+    /** Display Buddhist Era (බුද්ධ වර්ෂ / BE Year) in header. Default: true */
+    showBuddhistEra?: boolean;
+    /** Force Sinhala font styling on/off. If undefined, follows active i18n locale */
+    sinhala?: boolean;
+    /** Custom Poya dates (YYYY-MM-DD strings or Date objects) */
+    poyaDates?: (string | Date)[];
+    /** Highlight today's date. Default: true */
+    highlightToday?: boolean;
+    /**
+     * Fixed width of the calendar. Accepts any valid CSS value (e.g. '360px', '24rem', '100%').
+     * Defaults to 360px when not provided.
+     */
+    width?: string;
+    /**
+     * Fixed height of the calendar. Accepts any valid CSS value (e.g. '420px', '30rem').
+     * Defaults to 420px when not provided.
+     */
+    height?: string;
+    /** Callback fired when a date is selected */
+    onSelect?: (date: Date, sinhalaFormattedDate: string) => void;
+    /** Callback fired when month or year changes */
+    onMonthChange?: (year: number, month: number) => void;
+}
+/** Converts a number string or integer into Sinhala numerals. */
+declare function formatSinhalaNumeral(num: number | string): string;
+/** 12 Traditional Sinhala Month names (දුරුතු to උඳුඅප්). */
+declare const SINHALA_MONTH_NAMES: readonly ["දුරුතු", "නවම්", "මැදින්", "බක්", "වෙසක්", "පොසොන්", "ඇසළ", "නිකිණි", "බිනර", "වප්", "ඉල්", "උඳුඅප්"];
+declare class Calendar {
+    readonly element: HTMLDivElement;
+    private selectedDate;
+    private viewYear;
+    private viewMonth;
+    private showBuddhistEra;
+    private highlightToday;
+    private sinhalaExplicit;
+    private sinhalaEnabled;
+    private minDate?;
+    private maxDate?;
+    private poyaDatesSet;
+    private onSelectCallback?;
+    private onMonthChangeCallback?;
+    private unsubscribeLocale?;
+    /** True when the caller passed an explicit height — prevents auto six-row adjustment */
+    private readonly customHeight;
+    private monthTitleEl;
+    private subTitleEl;
+    private eraBadgeEl;
+    private weekdaysEl;
+    private daysGridEl;
+    private footerEl;
+    private selectedTextEl;
+    private monthPopoverEl;
+    constructor(options?: CalendarOptions);
+    private renderSkeleton;
+    private render;
+    private createDayButton;
+    private updateSelectedText;
+    /** Gets formatted string e.g. "2026 වෙසක් 15" (Western digits) */
+    getFormattedSinhalaDate(date: Date): string;
+    selectDate(date: Date): void;
+    getValue(): Date | null;
+    setValue(value: Date | string | null): void;
+    setSinhala(enabled: boolean): void;
+    setShowBuddhistEra(show: boolean): void;
+    nextMonth(): void;
+    prevMonth(): void;
+    goToToday(): void;
+    clear(): void;
+    private toggleMonthPopover;
+    private openMonthPopover;
+    private closeMonthPopover;
+    /** Cleans up subscriptions and event listeners */
+    destroy(): void;
+}
+
+/** Built-in Sri Lankan Ira Handa (sun face) mandala artwork. */
+declare const BUILTIN_SUN_MANDALA_IMAGE: string;
+
+interface SunMandalaOptions {
+    /** Image URL. Defaults to the built-in Ira Handa artwork. */
+    src?: string;
+    /** Accessible label for the artwork. */
+    alt?: string;
+    /**
+     * Display size (width & height). Accepts any valid CSS length.
+     * Defaults to `280px`.
+     */
+    size?: string;
+    /**
+     * Full rotation duration in seconds. Lower = faster.
+     * Defaults to `36`.
+     */
+    duration?: number;
+    /**
+     * Clip radius of the static face overlay (CSS length or %).
+     * Tuned so only the face stays still while rays + rings spin.
+     * Defaults to `22%`.
+     */
+    faceRadius?: string;
+    /** Start with rotation paused. Defaults to `false`. */
+    paused?: boolean;
+}
+/**
+ * Decorative Sri Lankan sun mandala (Ira Handa).
+ * The face stays still while the aura (rays + outer rings) rotates.
+ */
+declare class SunMandala {
+    readonly element: HTMLDivElement;
+    private readonly spinEl;
+    private readonly faceEl;
+    private readonly spinImg;
+    private readonly faceImg;
+    constructor(options?: SunMandalaOptions);
+    /** Pause or resume the aura rotation. */
+    setPaused(paused: boolean): void;
+    isPaused(): boolean;
+    /** Set full-circle rotation duration in seconds. */
+    setDuration(seconds: number): void;
+    /** Update display size (width & height). */
+    setSize(size: string): void;
+    /** Update the static face clip radius. */
+    setFaceRadius(radius: string): void;
+    destroy(): void;
+}
+
+/** HelaUI brand palette — all values are customizable. */
+interface HelaTheme {
+    primary: string;
+    secondary: string;
+    success: string;
+    accent: string;
+    black: string;
+    white: string;
+    grey: string;
+}
+type HelaThemeKey = keyof HelaTheme;
+
+/**
+ * Applies theme colors to a DOM element via CSS custom properties.
+ * Pass partial overrides to customize individual colors.
+ *
+ * @example
+ * applyTheme({ primary: '#1a1a2e' });
+ * applyTheme(customTheme, document.getElementById('my-app')!);
+ */
+declare function applyTheme(overrides?: Partial<HelaTheme>, target?: HTMLElement): HelaTheme;
+/** Removes inline theme overrides so CSS defaults take effect again. */
+declare function resetTheme(target?: HTMLElement): HelaTheme;
+/** Returns a CSS string of custom properties for inline styles or SSR. */
+declare function createThemeStyle(theme?: Partial<HelaTheme>): string;
+
+/** Default HelaUI theme — Sri Lankan inspired palette. */
+declare const defaultTheme: HelaTheme;
+
+/** Maps theme keys to CSS custom property names. */
+declare const THEME_VAR_MAP: Record<HelaThemeKey, string>;
+
+export { type ApplyTranslationsOptions, BUILTIN_RAIN_IMAGES, BUILTIN_SUN_MANDALA_IMAGE, Calendar, type CalendarOptions, type CalendarStrings, DEFAULT_RAIN_IMAGES, type DeepPartial, type HelaLocale, type HelaTextFieldTranslations, type HelaTheme, type HelaThemeKey, type HelaTranslationOverrides, type HelaTranslations, type LocaleTranslationOverrides, RainBackground, type RainBackgroundOptions, SINHALA_FONT_CLASS, SINHALA_FONT_FAMILY, SINHALA_MONTH_NAMES, SunMandala, type SunMandalaOptions, THEME_VAR_MAP, TextField, type TextFieldOptions, type TextFieldStrings, type TextFieldVariant, applySinhalaFont, applyTheme, applyTranslations, createThemeStyle, defaultTheme, defaultTranslations, formatSinhalaNumeral, getCalendarTranslation, getDefaultRainImageUrls, getLocale, getTextFieldTranslation, resetTheme, resetTranslations, setLocale, sinhalaFontStyles, subscribeLocaleChange, t };

package/dist/index.d.ts

@@ -0,0 +1,341 @@
+/** Default Sinhala font stack used by HelaUI. */
+declare const SINHALA_FONT_FAMILY = "\"Noto Sans Sinhala\", \"Iskoola Pota\", \"FM Abhaya\", sans-serif";
+/** Inline styles object for applying Sinhala typography. */
+declare const sinhalaFontStyles: {
+    readonly fontFamily: "\"Noto Sans Sinhala\", \"Iskoola Pota\", \"FM Abhaya\", sans-serif";
+};
+/** CSS class name applied by {@link applySinhalaFont}. */
+declare const SINHALA_FONT_CLASS = "helaui-sinhala";
+/**
+ * Applies Sinhala font styling to a DOM element.
+ * Import `helaui/sinhala.css` once in your app for the font files to load.
+ */
+declare function applySinhalaFont(element: HTMLElement): void;
+
+/** Supported HelaUI locales. */
+type HelaLocale = 'en' | 'si';
+interface TextFieldStrings {
+    label: string;
+    placeholder: string;
+    value?: string;
+}
+interface HelaTextFieldTranslations {
+    name: TextFieldStrings;
+    password: TextFieldStrings;
+    email: TextFieldStrings;
+    disabled: TextFieldStrings;
+}
+interface CalendarStrings {
+    monthNames: [string, string, string, string, string, string, string, string, string, string, string, string];
+    sinhalaMonthNames: [string, string, string, string, string, string, string, string, string, string, string, string];
+    weekdayNames: [string, string, string, string, string, string, string];
+    shortWeekdayNames: [string, string, string, string, string, string, string];
+    buddhistEra: string;
+    today: string;
+    clear: string;
+    selectMonth: string;
+    poyaDay: string;
+}
+/** Built-in translation shape shipped with HelaUI. */
+interface HelaTranslations {
+    textField: HelaTextFieldTranslations;
+    calendar: CalendarStrings;
+}
+type TextFieldVariant = keyof HelaTextFieldTranslations;
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+/** User overrides may extend built-in keys with custom translation trees. */
+type LocaleTranslationOverrides = DeepPartial<HelaTranslations> & {
+    [key: string]: unknown;
+};
+type HelaTranslationOverrides = Partial<Record<HelaLocale, LocaleTranslationOverrides>>;
+
+/** Default HelaUI translations — English and Sinhala. */
+declare const defaultTranslations: Record<HelaLocale, HelaTranslations>;
+
+interface ApplyTranslationsOptions {
+    /** Active locale. When omitted, keeps the current locale. */
+    locale?: HelaLocale;
+    /** Partial overrides merged on top of built-in defaults (per locale). */
+    overrides?: HelaTranslationOverrides;
+}
+/**
+ * Sets the active locale and/or merges user translation overrides.
+ * Follows the same partial-override pattern as `applyTheme`.
+ *
+ * @example
+ * setLocale('si');
+ * applyTranslations({ overrides: { en: { textField: { name: { label: 'Full name' } } } } });
+ */
+declare function applyTranslations(options?: ApplyTranslationsOptions): LocaleTranslationOverrides;
+/** Sets the active locale and notifies locale-aware components. */
+declare function setLocale(locale: HelaLocale): LocaleTranslationOverrides;
+/** Returns the active locale. */
+declare function getLocale(): HelaLocale;
+/** Resets user overrides back to built-in defaults. */
+declare function resetTranslations(): LocaleTranslationOverrides;
+/**
+ * Resolves a dot-separated translation key for the active (or given) locale.
+ * Falls back to English, then returns the key if unresolved.
+ */
+declare function t(path: string, locale?: HelaLocale): string;
+/** Built-in TextField strings for a variant in the active (or given) locale. */
+declare function getTextFieldTranslation(variant: TextFieldVariant, locale?: HelaLocale): TextFieldStrings;
+/** Built-in Calendar strings for the active (or given) locale. */
+declare function getCalendarTranslation(locale?: HelaLocale): CalendarStrings;
+/** Subscribe to locale or override changes. Returns an unsubscribe function. */
+declare function subscribeLocaleChange(listener: () => void): () => void;
+
+interface TextFieldOptions {
+    /**
+  
+     * Built-in translation variant — resolves label and placeholder from the active locale.
+  
+     * User-provided `label` / `placeholder` take precedence over variant strings.
+  
+     */
+    variant?: TextFieldVariant;
+    /** Translation key for label (dot path, e.g. `textField.name.label`). */
+    labelKey?: string;
+    /** Translation key for placeholder (dot path, e.g. `textField.name.placeholder`). */
+    placeholderKey?: string;
+    /** Explicit label — overrides variant and labelKey. */
+    label?: string;
+    /** Explicit placeholder — overrides variant and placeholderKey. */
+    placeholder?: string;
+    type?: 'text' | 'password' | 'email';
+    value?: string;
+    id?: string;
+    /** Apply Sinhala font styling. When omitted on locale-aware fields, follows active locale. */
+    sinhala?: boolean;
+}
+declare class TextField {
+    readonly element: HTMLDivElement;
+    readonly input: HTMLInputElement;
+    private readonly labelEl?;
+    private readonly unsubscribeLocale?;
+    private readonly localeAware;
+    private readonly fixedLabel?;
+    private readonly fixedPlaceholder?;
+    private readonly fixedValue?;
+    private readonly variant?;
+    private readonly labelKey?;
+    private readonly placeholderKey?;
+    private readonly sinhalaExplicit;
+    private readonly sinhalaEnabled;
+    constructor(options?: TextFieldOptions);
+    private resolveStrings;
+    private applyLocaleStrings;
+    getValue(): string;
+    setValue(value: string): void;
+    focus(): void;
+    setDisabled(disabled: boolean): void;
+    setLabel(label: string): void;
+    setPlaceholder(placeholder: string): void;
+    setSinhala(enabled: boolean): void;
+    /** Removes locale subscription. Call when discarding the field. */
+    destroy(): void;
+}
+
+/** Built-in rain sprite URLs shipped with HelaUI. */
+declare const BUILTIN_RAIN_IMAGES: readonly [string, string, string, string];
+
+interface RainBackgroundOptions {
+    /** Image URLs used as falling particles. Defaults to {@link BUILTIN_RAIN_IMAGES}. */
+    images?: string[];
+    /** Number of particles visible at once. Defaults to 28. */
+    density?: number;
+    /** Minimum particle width in pixels. Defaults to 28. */
+    minSize?: number;
+    /** Maximum particle width in pixels. Defaults to 72. */
+    maxSize?: number;
+    /** Minimum fall duration in seconds. Defaults to 8. */
+    minDuration?: number;
+    /** Maximum fall duration in seconds. Defaults to 18. */
+    maxDuration?: number;
+    /** Container to mount into. Defaults to `document.body`. */
+    target?: HTMLElement;
+    /** Stacking order. Defaults to 0. */
+    zIndex?: number;
+}
+/** Full-screen animated background with falling image particles. */
+declare class RainBackground {
+    readonly element: HTMLDivElement;
+    constructor(options?: RainBackgroundOptions);
+    private createDrop;
+    /** Removes the background from the DOM. */
+    destroy(): void;
+}
+/** Default rain sprite filenames shipped with HelaUI. */
+declare const DEFAULT_RAIN_IMAGES: readonly ["fritter.png", "swirl.png", "kokis.png", "leaf.png"];
+/** Builds image URLs from a base path (e.g. `/assets/rain/`). */
+declare function getDefaultRainImageUrls(basePath: string): string[];
+
+interface CalendarOptions {
+    /** Initial selected date (Date instance or YYYY-MM-DD string) */
+    value?: Date | string;
+    /** Initial displayed year & month (defaults to active value or current date) */
+    initialDate?: Date;
+    /** Minimum selectable date */
+    minDate?: Date;
+    /** Maximum selectable date */
+    maxDate?: Date;
+    /** Display Buddhist Era (බුද්ධ වර්ෂ / BE Year) in header. Default: true */
+    showBuddhistEra?: boolean;
+    /** Force Sinhala font styling on/off. If undefined, follows active i18n locale */
+    sinhala?: boolean;
+    /** Custom Poya dates (YYYY-MM-DD strings or Date objects) */
+    poyaDates?: (string | Date)[];
+    /** Highlight today's date. Default: true */
+    highlightToday?: boolean;
+    /**
+     * Fixed width of the calendar. Accepts any valid CSS value (e.g. '360px', '24rem', '100%').
+     * Defaults to 360px when not provided.
+     */
+    width?: string;
+    /**
+     * Fixed height of the calendar. Accepts any valid CSS value (e.g. '420px', '30rem').
+     * Defaults to 420px when not provided.
+     */
+    height?: string;
+    /** Callback fired when a date is selected */
+    onSelect?: (date: Date, sinhalaFormattedDate: string) => void;
+    /** Callback fired when month or year changes */
+    onMonthChange?: (year: number, month: number) => void;
+}
+/** Converts a number string or integer into Sinhala numerals. */
+declare function formatSinhalaNumeral(num: number | string): string;
+/** 12 Traditional Sinhala Month names (දුරුතු to උඳුඅප්). */
+declare const SINHALA_MONTH_NAMES: readonly ["දුරුතු", "නවම්", "මැදින්", "බක්", "වෙසක්", "පොසොන්", "ඇසළ", "නිකිණි", "බිනර", "වප්", "ඉල්", "උඳුඅප්"];
+declare class Calendar {
+    readonly element: HTMLDivElement;
+    private selectedDate;
+    private viewYear;
+    private viewMonth;
+    private showBuddhistEra;
+    private highlightToday;
+    private sinhalaExplicit;
+    private sinhalaEnabled;
+    private minDate?;
+    private maxDate?;
+    private poyaDatesSet;
+    private onSelectCallback?;
+    private onMonthChangeCallback?;
+    private unsubscribeLocale?;
+    /** True when the caller passed an explicit height — prevents auto six-row adjustment */
+    private readonly customHeight;
+    private monthTitleEl;
+    private subTitleEl;
+    private eraBadgeEl;
+    private weekdaysEl;
+    private daysGridEl;
+    private footerEl;
+    private selectedTextEl;
+    private monthPopoverEl;
+    constructor(options?: CalendarOptions);
+    private renderSkeleton;
+    private render;
+    private createDayButton;
+    private updateSelectedText;
+    /** Gets formatted string e.g. "2026 වෙසක් 15" (Western digits) */
+    getFormattedSinhalaDate(date: Date): string;
+    selectDate(date: Date): void;
+    getValue(): Date | null;
+    setValue(value: Date | string | null): void;
+    setSinhala(enabled: boolean): void;
+    setShowBuddhistEra(show: boolean): void;
+    nextMonth(): void;
+    prevMonth(): void;
+    goToToday(): void;
+    clear(): void;
+    private toggleMonthPopover;
+    private openMonthPopover;
+    private closeMonthPopover;
+    /** Cleans up subscriptions and event listeners */
+    destroy(): void;
+}
+
+/** Built-in Sri Lankan Ira Handa (sun face) mandala artwork. */
+declare const BUILTIN_SUN_MANDALA_IMAGE: string;
+
+interface SunMandalaOptions {
+    /** Image URL. Defaults to the built-in Ira Handa artwork. */
+    src?: string;
+    /** Accessible label for the artwork. */
+    alt?: string;
+    /**
+     * Display size (width & height). Accepts any valid CSS length.
+     * Defaults to `280px`.
+     */
+    size?: string;
+    /**
+     * Full rotation duration in seconds. Lower = faster.
+     * Defaults to `36`.
+     */
+    duration?: number;
+    /**
+     * Clip radius of the static face overlay (CSS length or %).
+     * Tuned so only the face stays still while rays + rings spin.
+     * Defaults to `22%`.
+     */
+    faceRadius?: string;
+    /** Start with rotation paused. Defaults to `false`. */
+    paused?: boolean;
+}
+/**
+ * Decorative Sri Lankan sun mandala (Ira Handa).
+ * The face stays still while the aura (rays + outer rings) rotates.
+ */
+declare class SunMandala {
+    readonly element: HTMLDivElement;
+    private readonly spinEl;
+    private readonly faceEl;
+    private readonly spinImg;
+    private readonly faceImg;
+    constructor(options?: SunMandalaOptions);
+    /** Pause or resume the aura rotation. */
+    setPaused(paused: boolean): void;
+    isPaused(): boolean;
+    /** Set full-circle rotation duration in seconds. */
+    setDuration(seconds: number): void;
+    /** Update display size (width & height). */
+    setSize(size: string): void;
+    /** Update the static face clip radius. */
+    setFaceRadius(radius: string): void;
+    destroy(): void;
+}
+
+/** HelaUI brand palette — all values are customizable. */
+interface HelaTheme {
+    primary: string;
+    secondary: string;
+    success: string;
+    accent: string;
+    black: string;
+    white: string;
+    grey: string;
+}
+type HelaThemeKey = keyof HelaTheme;
+
+/**
+ * Applies theme colors to a DOM element via CSS custom properties.
+ * Pass partial overrides to customize individual colors.
+ *
+ * @example
+ * applyTheme({ primary: '#1a1a2e' });
+ * applyTheme(customTheme, document.getElementById('my-app')!);
+ */
+declare function applyTheme(overrides?: Partial<HelaTheme>, target?: HTMLElement): HelaTheme;
+/** Removes inline theme overrides so CSS defaults take effect again. */
+declare function resetTheme(target?: HTMLElement): HelaTheme;
+/** Returns a CSS string of custom properties for inline styles or SSR. */
+declare function createThemeStyle(theme?: Partial<HelaTheme>): string;
+
+/** Default HelaUI theme — Sri Lankan inspired palette. */
+declare const defaultTheme: HelaTheme;
+
+/** Maps theme keys to CSS custom property names. */
+declare const THEME_VAR_MAP: Record<HelaThemeKey, string>;
+
+export { type ApplyTranslationsOptions, BUILTIN_RAIN_IMAGES, BUILTIN_SUN_MANDALA_IMAGE, Calendar, type CalendarOptions, type CalendarStrings, DEFAULT_RAIN_IMAGES, type DeepPartial, type HelaLocale, type HelaTextFieldTranslations, type HelaTheme, type HelaThemeKey, type HelaTranslationOverrides, type HelaTranslations, type LocaleTranslationOverrides, RainBackground, type RainBackgroundOptions, SINHALA_FONT_CLASS, SINHALA_FONT_FAMILY, SINHALA_MONTH_NAMES, SunMandala, type SunMandalaOptions, THEME_VAR_MAP, TextField, type TextFieldOptions, type TextFieldStrings, type TextFieldVariant, applySinhalaFont, applyTheme, applyTranslations, createThemeStyle, defaultTheme, defaultTranslations, formatSinhalaNumeral, getCalendarTranslation, getDefaultRainImageUrls, getLocale, getTextFieldTranslation, resetTheme, resetTranslations, setLocale, sinhalaFontStyles, subscribeLocaleChange, t };