@js-empire/emperor-ui 1.3.9 → 1.3.10

package/dist/src/types/components/molecules/nav-bar/nav-bar.d.ts

@@ -0,0 +1,45 @@
+import { ComponentRadius, ComponentSize, SharedComponentProps } from '../../..';
+import { ElementType } from 'react';
+export type NavBarClassnames = {
+    base?: string;
+};
+export type NavigationItem = {
+    id: string;
+    label?: string;
+    href?: string;
+    subItems?: NavigationItem[];
+    onClick?: () => void;
+    Icon?: ElementType;
+};
+export type NavBarHoverEffect = "default" | "underline" | "solid" | "ghost" | "bordered" | "none";
+export type NavBarVariant = "default" | "solid" | "bordered";
+export type NavBarStylesProps = {
+    primaryColor?: string;
+    foregroundColor?: string;
+    variant?: NavBarVariant;
+};
+export type NavBarMenuStylesProps = {};
+export type NavBarItemStylesProps = {
+    foregroundColor?: string;
+    primaryColor?: string;
+    hoverEffect: NavBarHoverEffect;
+    isHovered?: boolean;
+    variant?: NavBarVariant;
+};
+export type NavBarProps = SharedComponentProps & {
+    items: NavigationItem[];
+    classNames?: NavBarClassnames;
+    hoverEffect?: NavBarHoverEffect;
+    radius?: ComponentRadius;
+    size?: ComponentSize;
+    variant?: NavBarVariant;
+    subItemsColumns?: number;
+};
+export type NavBarItemProps = {
+    item: NavigationItem;
+    variant: NavBarVariant;
+    hoverEffect: NavBarHoverEffect;
+};
+export type SubItemsBoxProps = {
+    subItemsColumns?: number;
+};

package/dist/src/types/components/molecules/scaffold/index.d.ts

@@ -0,0 +1 @@
+export type * from './scaffold';

package/dist/src/types/components/molecules/scaffold/scaffold.d.ts

@@ -0,0 +1,7 @@
+import { SharedComponentProps } from '../../..';
+export type ScaffoldClassnames = {
+    base?: string;
+};
+export type ScaffoldProps = SharedComponentProps & {
+    classNames?: ScaffoldClassnames;
+};

package/dist/src/types/components/molecules/side-bar/index.d.ts

@@ -0,0 +1 @@
+export type * from './side-bar';

package/dist/src/types/components/molecules/side-bar/side-bar.d.ts

@@ -0,0 +1,36 @@
+import { ButtonProps } from '@heroui/button';
+import { NavigationItem, SharedComponentProps } from '../../..';
+import { ReactNode } from 'react';
+export type SideBarVariant = "default" | "compact";
+export type SideBarClassnames = {
+    base?: string;
+    trigger?: string;
+    title?: string;
+    menu?: string;
+    menuItem?: string;
+    actionsWrapper?: string;
+    actionItem?: string;
+};
+export type SideBarAction = ButtonProps & {
+    key: string;
+    label?: string;
+};
+export type SideBarProps = SharedComponentProps & {
+    classNames?: SideBarClassnames;
+    variant?: SideBarVariant;
+    items: NavigationItem[];
+    actions?: SideBarAction[];
+    triggerProps?: Omit<ButtonProps, "content"> & {
+        content?: ReactNode;
+    };
+    isOpen?: boolean;
+    onOpenChange?: (isOpen: boolean) => void;
+    header?: ReactNode;
+};
+export type SideBarItemStylesProps = {
+    foregroundColor?: string;
+    primaryColor?: string;
+    isHovered?: boolean;
+    variant?: SideBarVariant;
+};
+export type CompactSideBarProps = SideBarProps & {};

package/dist/src/types/components/molecules/theme-switch/index.d.ts

@@ -0,0 +1 @@
+export * from './theme-switch';

package/dist/src/types/components/molecules/theme-switch/theme-switch.d.ts

@@ -0,0 +1,7 @@
+import { SharedComponentProps } from '../../..';
+export type ThemeSwitchClassnames = {
+    base?: string;
+};
+export type ThemeSwitchProps = SharedComponentProps & {
+    classNames?: ThemeSwitchClassnames;
+};

package/dist/src/types/components/organisms/deletion-confirmor/deletion-confirmor.d.ts

@@ -0,0 +1,20 @@
+import { ButtonProps } from '@heroui/button';
+export type DeletionConfirmorClassnames = {
+    base?: string;
+    content?: string;
+    header?: string;
+    body?: string;
+    footer?: string;
+    confirmButton?: string;
+    declineButton?: string;
+};
+export type DeletionConfirmorProps = {
+    isOpen: boolean;
+    onClose: () => void;
+    title: string;
+    description: string;
+    className?: string;
+    classNames?: DeletionConfirmorClassnames;
+    confirmProps?: ButtonProps;
+    declineProps?: ButtonProps;
+};

package/dist/src/types/components/organisms/deletion-confirmor/index.d.ts

@@ -0,0 +1 @@
+export * from './deletion-confirmor';

package/dist/src/types/components/organisms/filters/filters.d.ts

@@ -0,0 +1,9 @@
+import { SharedComponentProps } from '../../..';
+import { ReactNode } from 'react';
+export type FiltersClassnames = {
+    base?: string;
+};
+export type FiltersProps = Omit<SharedComponentProps, "children"> & {
+    classNames?: FiltersClassnames;
+    children: ReactNode;
+};

package/dist/src/types/components/organisms/filters/index.d.ts

@@ -0,0 +1 @@
+export type * from './filters';

package/dist/src/types/components/organisms/form-builder/context.d.ts

@@ -0,0 +1,5 @@
+import { Control, FieldValues } from 'react-hook-form';
+export type FormBuilderValue<TSchema extends FieldValues> = {
+    control: Control<TSchema, any, TSchema>;
+    formValues: Partial<TSchema>;
+};

package/dist/src/types/components/organisms/form-builder/form-builder.d.ts

@@ -0,0 +1,26 @@
+import { SharedComponentProps } from '../../..';
+import { ReactNode } from 'react';
+import { FieldErrors, FieldValues, UseFormProps, UseFormReturn } from 'react-hook-form';
+import { ZodType, z } from 'zod';
+export type FormBuilderSubmitArgs<TFieldValues extends FieldValues> = {
+    values: TFieldValues;
+    form: UseFormReturn<TFieldValues>;
+};
+export type FormBuilderSuccessArgs<TFieldValues extends FieldValues> = {
+    values: TFieldValues;
+    form: UseFormReturn<TFieldValues>;
+};
+export type FormBuilderErrorArgs<TFieldValues extends FieldValues> = {
+    error?: unknown;
+    errors?: FieldErrors<TFieldValues>;
+    form: UseFormReturn<TFieldValues>;
+};
+export type FormBuilderProps<TSchema extends ZodType<any, any, any>> = Omit<SharedComponentProps, "children"> & {
+    children: ReactNode;
+    formProps?: UseFormProps<z.infer<TSchema>>;
+    onSubmit: (values: z.infer<TSchema>) => Promise<unknown> | unknown;
+    onSuccess?: (values: z.infer<TSchema>) => void;
+    onError?: (error: unknown) => void;
+    /** Called whenever form values change. Use this to read values outside FormBuilder (e.g. in parent state). */
+    onValuesChange?: (values: Partial<z.infer<TSchema>>) => void;
+};

package/dist/src/types/components/organisms/form-builder/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './form-builder';
+export type * from './context';

package/dist/src/types/components/organisms/index.d.ts

@@ -0,0 +1,3 @@
+export * from './deletion-confirmor';
+export * from './filters';
+export * from './form-builder';

package/dist/src/types/components/templates/index.d.ts

@@ -0,0 +1 @@
+export type * from './landing-page';

package/dist/src/types/components/templates/landing-page.d.ts

@@ -0,0 +1,8 @@
+import { SharedComponentProps } from '../..';
+export type LandingPageClassnames = {
+    base?: string;
+};
+export type LandingPageProps = SharedComponentProps & {
+    classNames?: LandingPageClassnames;
+    variant?: "default";
+};

package/dist/src/types/context/config.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { EmperorUIInterLocalization, EmperorUITheme } from '..';
+import { ToastProps } from '@heroui/toast';
+export type ConfigContextState = {
+    config: EmperorUIConfig;
+};
+export type ConfigProviderProps = {
+    children: ReactNode;
+    config?: EmperorUIConfig;
+};
+export type EmperorUILayout = {
+    withScaffold: boolean;
+};
+export type EmperorUIConfig = {
+    layout?: Partial<EmperorUILayout>;
+    interLocalization?: Partial<EmperorUIInterLocalization>;
+    toast?: ToastProps;
+    theme?: Partial<EmperorUITheme>;
+};

package/dist/src/types/context/index.d.ts

@@ -0,0 +1,4 @@
+export type * from './config';
+export type * from './navigation';
+export type * from './localization';
+export type * from './theme';

package/dist/src/types/context/localization.d.ts

@@ -0,0 +1,17 @@
+import { Locale } from '../../i18n';
+export type AppDirection = "ltr" | "rtl";
+export type EmperorUILang = "en" | "ar";
+export type EmperorUILocales = Record<EmperorUILang, Partial<{
+    atoms?: {
+        uploader?: Partial<Locale["atoms"]["uploader"]>;
+        colorPicker?: Partial<Locale["atoms"]["colorPicker"]>;
+    };
+}>>;
+export type EmperorUIInterLocalization = {
+    lang?: EmperorUILang;
+    languages?: EmperorUILang[];
+    defaultLanguage?: EmperorUILang;
+    isMultiLingual?: boolean;
+    dir?: AppDirection;
+    locales?: EmperorUILocales;
+};

package/dist/src/types/context/navigation.d.ts

@@ -0,0 +1,15 @@
+import { NavigationItem } from '..';
+import { ReactNode } from 'react';
+export type NavigationContextState = {
+    hoveredItemId: string | null;
+    subItems: NavigationItem[];
+    isSubItemsBoxOpen: boolean;
+    subItemsBoxIsHovered: boolean;
+    setHoveredItemId: (id: string | null) => void;
+    setSubItems: (items: NavigationItem[]) => void;
+    setIsSubItemsBoxOpen: (isOpen: boolean) => void;
+    setSubItemsBoxIsHovered: (isHovered: boolean) => void;
+};
+export type NavigationProviderProps = {
+    children: ReactNode;
+};

package/dist/src/types/context/theme.d.ts

@@ -0,0 +1,32 @@
+import { InputProps, TextAreaProps } from '@heroui/input';
+import { ButtonProps } from '@heroui/button';
+import { CardProps } from '@heroui/card';
+import { DropdownProps } from '@heroui/dropdown';
+import { ModalProps } from '@heroui/modal';
+import { CheckboxGroupProps, CheckboxProps } from '@heroui/checkbox';
+import { AutocompleteItemProps, AutocompleteProps } from '@heroui/autocomplete';
+import { SelectProps, SelectItemProps } from '@heroui/select';
+import { RadioGroupProps } from '@heroui/radio';
+import { SwitchProps } from '@heroui/switch';
+import { DatePickerProps } from '@heroui/date-picker';
+import { SliderProps } from '@heroui/slider';
+export type EmperorUITheme = {
+    components?: {
+        input?: InputProps;
+        textarea?: TextAreaProps;
+        button?: ButtonProps;
+        card?: CardProps;
+        dropdown?: DropdownProps;
+        modal?: ModalProps;
+        checkbox?: CheckboxProps;
+        checkboxGroup?: CheckboxGroupProps;
+        autocomplete?: Omit<AutocompleteProps, "children">;
+        autocompleteItem?: Omit<AutocompleteItemProps, "children">;
+        radio?: Omit<RadioGroupProps, "children">;
+        select?: Omit<SelectProps, "children">;
+        selectItem?: Omit<SelectItemProps, "children">;
+        switch?: SwitchProps;
+        datePicker?: DatePickerProps;
+        slider?: SliderProps;
+    };
+};

package/dist/src/types/index.d.ts

@@ -0,0 +1,3 @@
+export type * from './components';
+export type * from './shared';
+export type * from './context';

package/dist/src/types/shared/components.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+export type SharedComponentProps = {
+    className?: string;
+    classNames?: {
+        base?: string;
+    };
+    children?: ReactNode;
+};
+export type ComponentSize = "xs" | "sm" | "base" | "md" | "lg" | "xl";
+export type ComponentRadius = "none" | "sm" | "md" | "lg" | "full";

package/dist/src/types/shared/index.d.ts

@@ -0,0 +1 @@
+export type * from './components';

package/dist/src/utils/cn.d.ts

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

package/dist/src/utils/compress-images.d.ts

@@ -0,0 +1,2 @@
+import { FileObject } from '../types';
+export declare function compressImage(fileObject: FileObject, maxSizeMB?: number): Promise<FileObject | null>;

package/dist/src/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from './cn';
+export * from './storybook';
+export * from './compress-images';
+export * from './uploader';
+export * from './locales';

package/dist/src/utils/locales.d.ts

@@ -0,0 +1,10 @@
+import { Locale } from '../i18n';
+/**
+ * Deep-merges config locales into default locales. Default values are used as base,
+ * and config values override only the keys they provide. Nested objects are merged
+ * recursively so unrelated keys at any level remain unchanged.
+ */
+export declare const mergeLocales: ({ defaultLocales, configLocales, }: {
+    defaultLocales: Locale;
+    configLocales?: Partial<Locale>;
+}) => Locale;

package/dist/src/utils/storybook.d.ts

@@ -0,0 +1,4 @@
+import { EmperorUIConfig } from '../types';
+export declare const getStorybookDecorators: ({ config, }: {
+    config?: EmperorUIConfig;
+}) => ((Story: any) => import("react/jsx-runtime").JSX.Element)[];

package/dist/src/utils/uploader.d.ts

@@ -0,0 +1,40 @@
+import { FileObject, FileType } from '../types';
+import { Dispatch, SetStateAction } from 'react';
+import { Locale } from '../i18n';
+export declare const mapFileType: (fileType: string) => FileType | null;
+export declare const getAllowedTypes: (fileTypes: FileType[]) => string[];
+export declare const isFileDuplicated: ({ files, fileName, }: {
+    files: FileObject[];
+    fileName: string;
+}) => boolean;
+export declare const isMaxFileSizeExceeded: ({ fileSize, maxFileSize, }: {
+    fileSize: number;
+    maxFileSize: number;
+}) => boolean;
+export declare function validateUploadedFiles({ uploadedFiles, maxFileSize, compressFiles, uploaderLocale, preventDuplicates, files, }: {
+    uploadedFiles: File[];
+    maxFileSize?: number;
+    compressFiles?: boolean;
+    uploaderLocale: Locale["atoms"]["uploader"];
+    preventDuplicates?: boolean;
+    files: FileObject[];
+}): Promise<{
+    compressedFiles: (File | undefined)[];
+    isInValid: boolean;
+}>;
+export declare function refineUploadedFiles({ uploadedFiles, uploaderLocale, allowedTypes, isMulti, setFiles, }: {
+    uploadedFiles: (File | undefined)[];
+    uploaderLocale: Locale["atoms"]["uploader"];
+    allowedTypes: string[];
+    isMulti: boolean;
+    setFiles: Dispatch<SetStateAction<FileObject[]>>;
+}): Promise<void[]>;
+/**
+ * Merges uploader-specific locales with priority:
+ * 1) context-level overrides, 2) config-level locales, 3) default static locales.
+ */
+export declare const mergeUploaderLocale: ({ defaultUploaderLocale, configUploaderLocale, contextUploaderLocale, }: {
+    defaultUploaderLocale: Locale["atoms"]["uploader"];
+    configUploaderLocale?: Locale["atoms"]["uploader"];
+    contextUploaderLocale?: Partial<Locale["atoms"]["uploader"]>;
+}) => Locale["atoms"]["uploader"];

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@js-empire/emperor-ui",
   "description": "They provide the atoms, we provide the empire.",
-  "version": "1.3.9",
+  "version": "1.3.10",
   "author": "JS Empire - Mustafa Alhasanat",
   "license": "ISC",
   "type": "module",
   "main": "./dist/emperor-ui.js",
   "module": "./dist/emperor-ui.js",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/src/index.d.ts",
   "files": [
     "dist",
     "README.md"
@@ -15,7 +15,7 @@
   "keywords": [],
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
+      "types": "./dist/src/index.d.ts",
       "import": "./dist/emperor-ui.js",
       "default": "./dist/emperor-ui.js"
     },