@js-empire/emperor-ui 1.0.1 → 1.2.0

package/src/components/organisms/header/styles/styles.ts

@@ -0,0 +1,39 @@
+import { CSSProperties } from "react";
+import { HeaderGlassEffect, HeaderStylesProps } from "@/types";
+
+export const getGlassEffectStyles = ({
+  glassEffect,
+}: {
+  glassEffect: HeaderGlassEffect;
+}): CSSProperties => ({
+  backgroundColor: glassEffect?.backgroundColor
+    ? `${glassEffect?.backgroundColor}${glassEffect?.opacity ?? 30}`
+    : "transparent",
+  backdropFilter: `blur(${glassEffect?.blur ?? 0}px)`,
+  color: glassEffect?.foregroundColor,
+});
+
+export const headerStyles = ({
+  primaryColor,
+  foregroundColor,
+  variant,
+  glassEffect,
+}: HeaderStylesProps): CSSProperties => {
+  if (glassEffect?.enabled && variant !== "segmented-floating") {
+    return getGlassEffectStyles({
+      glassEffect: {
+        ...glassEffect,
+        foregroundColor: glassEffect?.foregroundColor ?? foregroundColor,
+      },
+    });
+  }
+
+  if (["default", "floating"].includes(variant ?? "")) {
+    return {
+      backgroundColor: primaryColor,
+      color: foregroundColor,
+    };
+  }
+
+  return {};
+};

package/src/components/organisms/index.ts

@@ -0,0 +1,4 @@
+export * from "./item-details";
+export * from "./listings";
+export * from "./footer";
+export * from "./header";

package/src/components/{item-details → organisms/item-details}/item-details.tsx

@@ -1,5 +1,5 @@
-import type { ItemDetailsProps } from "src";
-import { cn } from "@utils";
+import type { ItemDetailsProps } from "@/types";
+import { cn } from "@/utils";
 
 export function ItemDetails({ className }: ItemDetailsProps) {
   return <div className={cn("", className)}>ItemDetails Component</div>;

package/src/components/{listings → organisms/listings}/listings.tsx

@@ -1,5 +1,5 @@
-import type { ListingsProps } from "src";
-import { cn } from "@utils";
+import type { ListingsProps } from "@/types";
+import { cn } from "@/utils";
 
 export function Listings({ className }: ListingsProps) {
   return <div className={cn("", className)}>Listings Component</div>;

package/src/components/templates/index.ts

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

package/src/components/templates/landing-page/index.ts

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

package/src/components/templates/landing-page/landing-page.stories.tsx

@@ -0,0 +1,21 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { LandingPage } from "@/components";
+import { getStorybookDecorators } from "@/utils";
+
+const meta: Meta<typeof LandingPage> = {
+  title: "Templates/LandingPage",
+  component: LandingPage,
+  parameters: {
+    layout: "fullscreen",
+  },
+  tags: ["autodocs"],
+  decorators: getStorybookDecorators({}),
+};
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  args: {},
+};

package/src/components/templates/landing-page/landing-page.tsx

@@ -0,0 +1,57 @@
+import { forwardRef, ComponentProps } from "react";
+import { VariantProps } from "class-variance-authority";
+import { cn } from "@/utils";
+import { LandingPageProps } from "@/types";
+import { landingPageClasses } from "./styles";
+import { Brand, Header, NavBar } from "@/components";
+import { MOCK_HEADER_ITEMS_WITH_SUB_ITEMS } from "@/mocks";
+import { FAKE_PARAGRAPH } from "@/constants";
+
+const GLASS_EFFECT_CONFIG = {
+  enabled: true,
+  blur: 10,
+  backgroundColor: "#006fed",
+  foregroundColor: "#fff",
+  opacity: 40,
+};
+
+/**
+ * This component is not for general use nor it is reusable, it is intended to be used as a demo page.
+ */
+export const LandingPage = forwardRef<
+  HTMLDivElement,
+  ComponentProps<"main"> &
+    VariantProps<typeof landingPageClasses> &
+    LandingPageProps
+>(({ className, variant = "default", children, ...props }, ref) => {
+  return (
+    <main
+      ref={ref}
+      data-slot="emperor-landing-page"
+      className={cn(landingPageClasses({ className }))}
+      {...props}
+    >
+      <Header variant="floating" glassEffect={GLASS_EFFECT_CONFIG}>
+        <Brand />
+
+        <NavBar
+          items={MOCK_HEADER_ITEMS_WITH_SUB_ITEMS}
+          hoverEffect="none"
+          variant="default"
+          className="hidden md:flex"
+          subItemsColumns={4}
+        />
+      </Header>
+
+      <main className="w-full container mx-auto p-5 pt-24 flex flex-col gap-6">
+        <p>{FAKE_PARAGRAPH}</p>
+        <p>{FAKE_PARAGRAPH}</p>
+        <p>{FAKE_PARAGRAPH}</p>
+        <p>{FAKE_PARAGRAPH}</p>
+        <p>{FAKE_PARAGRAPH}</p>
+      </main>
+
+      {children}
+    </main>
+  );
+});

package/src/components/templates/landing-page/styles/classes.ts

@@ -0,0 +1,11 @@
+import { cva } from "class-variance-authority";
+
+export const landingPageClasses = cva(["flex flex-col w-full"], {
+  variants: {
+    variant: {
+      default: [],
+    },
+  },
+  defaultVariants: {},
+  compoundVariants: [],
+});

package/src/components/templates/landing-page/styles/index.ts

@@ -0,0 +1 @@
+export * from "./classes";

package/src/constants/defaults.ts

@@ -1,14 +1,14 @@
-import type { ColorsPalette, EmperorUIConfig } from "@types";
+import type { ColorsPalette, EmperorUIConfig } from "@/types";
 
 export const defaultColorsPalette: ColorsPalette = {
-  primary: "#1E40AF",
-  secondary: "#F59E0B",
-  background: "#FFFFFF",
-  text: "#111827",
-  danger: "#DC2626",
-  warning: "#D97706",
+  primary: "#006FEE",
+  secondary: "#9353d3",
+  background: "#3f3f46",
+  foreground: "#ECEDEE",
+  success: "#17c964",
+  warning: "#f5a524",
+  danger: "#f31260",
   info: "#3B82F6",
-  success: "#16A34A",
 };
 
 export const defaultEmperorUIConfig: EmperorUIConfig = {
@@ -19,4 +19,39 @@ export const defaultEmperorUIConfig: EmperorUIConfig = {
   layout: {
     withScaffold: true,
   },
+  interLocalization: {
+    lang: "en",
+    languages: ["en", "ar"],
+    defaultLanguage: "en",
+    dir: "ltr",
+    isMultiLingual: false,
+    locales: {
+      en: {
+        dropHere: "Drop file here",
+        selectFile: "Select a file or drag and drop here",
+        selectionTypes: "JPG, PNG or PDF, file size no more than 10MB",
+        selectBtn: "Select file",
+        errorUploadingFile: "No file was uploaded",
+        maxNumImages: "Maximum number of uploaded images exceeded: ",
+        errorUploadedTypes: "You can only upload files within these types: ",
+        maxSizeExceededError:
+          "You can only upload files/images with less than MAX_FILE_SIZE Mega Bytes, you're file's size is UPLOADED_FILE_SIZE Mega Bytes",
+        duplicatesDenied:
+          "You can't upload images with duplicate names, you may rename them before the upload process",
+      },
+      ar: {
+        dropHere: "أسقط الملف هنا",
+        selectFile: "حدد ملفًا أو اسحبه وأفلته هنا",
+        selectionTypes: "JPG, PNG أو PDF، حجم الملف لا يزيد عن 10MB",
+        selectBtn: "حدد ملف",
+        errorUploadingFile: "لم يتم تحميل أي ملف",
+        maxNumImages: "تم تجاوز الحد الأقصى للصور المرفوعة: ",
+        errorUploadedTypes: "يمكنك فقط تحميل الملفات من الأنواع التالية: ",
+        maxSizeExceededError:
+          "يمكنك فقط رفع ملفات/صور بحجم أقل من MAX_FILE_SIZE ميغابايت، بينما حجم الملف الذي رفعته هو UPLOADED_FILE_SIZE ميغابايت",
+        duplicatesDenied:
+          "لا يمكنك رفع صور تحمل نفس الاسم، يمكنك إعادة تسميتها قبل عملية الرفع",
+      },
+    },
+  },
 };

package/src/constants/fake.ts

@@ -0,0 +1,5 @@
+export const FAKE_SENTENCE =
+  "Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor.";
+
+export const FAKE_PARAGRAPH =
+  "Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque eu, pretium quis, sem. Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu. In enim justo, rhoncus ut, imperdiet a, venenatis vitae, justo. Nullam dictum felis eu pede mollis pretium. Integer tincidunt. Cras dapibus. Vivamus elementum semper nisi. Aenean vulputate eleifend tellus. Aenean leo ligula, porttitor eu, consequat vitae, eleifend ac, enim. Aliquam lorem ante, dapibus in, viverra quis, feugiat a, tellus. Phasellus viverra nulla ut metus varius laoreet. Quisque rutrum. Aenean imperdiet. Etiam ultricies nisi vel augue. Curabitur ullamcorper ultricies nisi. Nam eget dui. Etiam rhoncus. Maecenas tempus, tellus eget condimentum rhoncus, sem quam semper libero, sit amet adipiscing sem neque sed ipsum. Nam quam nunc, blandit vel, luctus pulvinar, hendrerit id, lorem. Maecenas nec odio et ante tincidunt tempus. Donec vitae sapien ut libero venenatis faucibus. Nullam quis ante. Etiam sit amet orci eget eros faucibus tincidunt. Duis leo. Sed fringilla mauris sit amet nibh. Donec sodales sagittis magna. Sed consequat, leo eget bibendum sodales, augue velit cursus nunc,";

package/src/constants/footer.tsx

@@ -0,0 +1,157 @@
+import {
+  CopyRights,
+  Contacts,
+  QuickLink,
+  QuickLinkCollection,
+  SocialLink,
+} from "@/types";
+
+import {
+  FacebookIcon,
+  InstagramIcon,
+  LinkedinIcon,
+  TwitterIcon,
+  YoutubeIcon,
+} from "lucide-react";
+
+export const quickLinks: QuickLinkCollection[] = [
+  {
+    title: "Products",
+    links: [
+      {
+        label: "Product 1",
+        href: "/product-1",
+      },
+      {
+        label: "Product 2",
+        href: "/product-2",
+      },
+      {
+        label: "Product 3",
+        href: "/product-3",
+      },
+    ],
+  },
+  {
+    title: "Services",
+    links: [
+      {
+        label: "Service 1",
+        href: "/service-1",
+      },
+      {
+        label: "Service 2",
+        href: "/service-2",
+      },
+      {
+        label: "Service 3",
+        href: "/service-3",
+      },
+      {
+        label: "Service 4",
+        href: "/service-4",
+      },
+    ],
+  },
+  {
+    title: "Resources",
+    links: [
+      {
+        label: "Resource 1",
+        href: "/resource-1",
+      },
+    ],
+  },
+  {
+    title: "Company",
+    links: [
+      {
+        label: "About Us",
+        href: "/about-us",
+      },
+      {
+        label: "Careers",
+        href: "/careers",
+      },
+      {
+        label: "Blog",
+        href: "/blog",
+      },
+    ],
+  },
+  {
+    title: "Support",
+    links: [
+      {
+        label: "Contact Us",
+        href: "/contact-us",
+      },
+    ],
+  },
+];
+
+export const policies: QuickLink[] = [
+  {
+    label: "Privacy Policy",
+    href: "/privacy-policy",
+  },
+  {
+    label: "Terms of Service",
+    href: "/terms-of-service",
+  },
+  {
+    label: "Cookie Policy",
+    href: "/cookie-policy",
+  },
+];
+
+export const copyRights: CopyRights = {
+  year: 2026,
+  text: "All rights reserved - Emperor UI",
+};
+
+export const contacts: Contacts = {
+  mobile: "+964 770 000 0000",
+  email: "contact@emperorui.com",
+  website: "https://jsempire.com",
+  workingHours: "Monday - Friday: 9:00 AM - 5:00 PM",
+  addresses: [
+    {
+      country: "Jordan",
+      street: "Amman, Jordan",
+      city: "Amman",
+      state: "Amman",
+      zip: "11111",
+    },
+    {
+      country: "Saudi Arabia",
+      street: "Riyadh, Saudi Arabia",
+      city: "Riyadh",
+      state: "Riyadh",
+      zip: "11111",
+    },
+  ],
+};
+
+export const socialLinks: SocialLink[] = [
+  {
+    href: "https://facebook.com",
+    icon: <FacebookIcon />,
+  },
+  {
+    href: "https://twitter.com",
+    icon: <TwitterIcon />,
+  },
+  {
+    href: "https://instagram.com",
+    icon: <InstagramIcon />,
+  },
+  {
+    href: "https://linkedin.com",
+    icon: <LinkedinIcon />,
+  },
+  {
+    href: "https://youtube.com",
+    icon: <YoutubeIcon />,
+  },
+];

package/src/constants/index.ts

@@ -1 +1,4 @@
 export * from "./defaults";
+export * from "./fake";
+export * from "./uploader";
+export * from "./footer";

package/src/constants/uploader.ts

@@ -0,0 +1,27 @@
+export const ALLOWED_IMAGES_TYPES = [
+  "image/jpeg",
+  "image/jpg",
+  "image/png",
+  "image/webp",
+  "image/gif",
+  "image/bmp",
+  "image/svg+xml",
+  "image/tiff",
+  "image/x-icon",
+];
+
+export const ALLOWED_PDF_TYPES = ["application/pdf"];
+
+export const ALLOWED_DOC_TYPES = [
+  "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+];
+
+export const ONE_MEGABYTE = 1024;
+
+export const fileTypesMapping: { [key: string]: string[] } = {
+  image: [".jpg", ".jpeg", ".png"],
+  doc: [".doc", ".docx"],
+  pdf: [".pdf"],
+  video: [".mp4"],
+  sheet: [".xlsx", ".xlx"],
+};

package/src/context/emperor-ui-context.ts

@@ -1,6 +1,6 @@
-import type { EmperorUIContextState } from "@types";
+import type { ConfigContextState } from "@/types";
 import { createContext } from "react";
 
-export const EmperorUIContext = createContext<
-  EmperorUIContextState | undefined
->(undefined);
+export const EmperorUIContext = createContext<ConfigContextState | undefined>(
+  undefined,
+);

package/src/context/index.ts

@@ -1 +1,3 @@
 export * from "./emperor-ui-context";
+export * from "./navigation-context";
+export * from "./uploader-context";

package/src/context/navigation-context.ts

@@ -0,0 +1,6 @@
+import type { NavigationContextState } from "@/types";
+import { createContext } from "react";
+
+export const NavigationContext = createContext<
+  NavigationContextState | undefined
+>(undefined);

package/src/context/uploader-context.ts

@@ -0,0 +1,6 @@
+import type { UploaderContextState } from "@/types";
+import { createContext } from "react";
+
+export const UploaderContext = createContext<UploaderContextState | undefined>(
+  undefined,
+);

package/src/enums/index.ts

@@ -0,0 +1,2 @@
+export * from "./preserved-keys";
+export * from "./placeholders";

package/src/enums/placeholders.ts

@@ -0,0 +1,4 @@
+export enum Placeholders {
+  PLACEHOLDER_MALE_AVATAR = "/images/placeholder-male-avatar.png",
+  PLACEHOLDER_FEMALE_AVATAR = "/images/placeholder-female-avatar.png",
+}

package/src/enums/preserved-keys.ts

@@ -0,0 +1,3 @@
+export enum PreservedKeys {
+  COMPACT_SIDEBAR_ID = "emperor-compact-sidebar",
+}

package/src/hooks/index.ts

@@ -1 +1,4 @@
 export * from "./use-emperor-ui";
+export * from "./use-navigation";
+export * from "./use-uploader-context";
+export * from "./use-uploader";

package/src/hooks/use-emperor-ui.ts

@@ -1,4 +1,4 @@
-import { EmperorUIContext } from "@context";
+import { EmperorUIContext } from "@/context";
 import { useContext } from "react";
 
 export function useEmperorUI() {

package/src/hooks/use-navigation.ts

@@ -0,0 +1,12 @@
+import { NavigationContext } from "@/context";
+import { useContext } from "react";
+
+export function useNavigation() {
+  const context = useContext(NavigationContext);
+
+  if (!context) {
+    throw new Error("useNavigation must be used within a NavigationProvider");
+  }
+
+  return context;
+}

package/src/hooks/use-uploader-context.ts

@@ -0,0 +1,14 @@
+import { UploaderContext } from "@/context";
+import { useContext } from "react";
+
+export function useUploaderContext() {
+  const context = useContext(UploaderContext);
+
+  if (!context) {
+    throw new Error(
+      "useUploaderContext must be used within a UploaderProvider",
+    );
+  }
+
+  return context;
+}

package/src/hooks/use-uploader.tsx

@@ -0,0 +1,151 @@
+"use client";
+
+import { addToast } from "@heroui/react";
+import { FileObject, UseUploadFileProps, UseUploadFileReturn } from "@/types";
+import { useState } from "react";
+import { useEmperorUI } from "@/hooks";
+import {
+  validateUploadedFiles,
+  getAllowedTypes,
+  refineUploadedFiles,
+} from "@/utils";
+import { ONE_MEGABYTE } from "@/constants";
+
+export const useUploader = ({
+  labelContent,
+  labelId,
+  fileTypes,
+  isRequired = false,
+  isDraggable = true,
+  isMulti = false,
+  preventDuplicates = true,
+  maxCount = 10,
+  maxFileSize = ONE_MEGABYTE * 10,
+  compressFiles = false,
+  onChange = () => {},
+}: UseUploadFileProps): UseUploadFileReturn => {
+  const { config } = useEmperorUI();
+  const [files, setFiles] = useState<FileObject[]>([]);
+  const [isLoading, setIsLoading] = useState(false);
+
+  const locales = config?.interLocalization?.locales;
+  const lang = config?.interLocalization?.lang;
+
+  const locale = locales?.[lang || "en"];
+
+  // remove a specific uploaded file
+  const handleClearFile = (fileName?: string) => {
+    setFiles((prev) => prev?.filter((file) => file?.file?.name !== fileName));
+
+    // Reset the input value to allow re-uploading the same file
+    if (labelId) {
+      const input = document.getElementById(labelId) as HTMLInputElement;
+      if (input) {
+        input.value = "";
+      }
+    }
+  };
+
+  // handle the uploading process including the window upload and the drag-and-drop upload
+  const onInputChange = async (
+    event: React.ChangeEvent<HTMLInputElement> &
+      React.DragEvent<HTMLLabelElement>,
+  ): Promise<void | string | null> => {
+    console.log("files: ", event.target.files);
+
+    if (
+      (!event.target.files || !event.target.files?.[0]) &&
+      (!event?.dataTransfer?.files || !event?.dataTransfer?.files[0])
+    ) {
+      return addToast({
+        title: locale?.errorUploadingFile,
+      });
+    }
+
+    // validate the file type according to the given allowed types
+    const allowedTypes = getAllowedTypes(fileTypes);
+
+    // verify if the files exist
+    if (!event.target.files && !event.dataTransfer.files) return;
+
+    // get the uploaded files
+    const uploadedFiles = Array.from(
+      event.target.files || event.dataTransfer.files,
+    );
+
+    // validate the files' length and prevent exceeded files only in the multiple-mode
+    if (
+      isMulti &&
+      (uploadedFiles?.length > maxCount ||
+        files?.length + uploadedFiles?.length > maxCount)
+    ) {
+      addToast({
+        title: `${locale?.maxNumImages} ${maxCount}`,
+      });
+      return;
+    }
+
+    // validate the files' types according to the given allowed types
+    if (
+      !uploadedFiles
+        ?.map((file) => file?.type)
+        ?.every((type) => allowedTypes.includes(type))
+    ) {
+      addToast({
+        title: `${locale?.errorUploadedTypes} ${allowedTypes.join(", ")}`,
+      });
+      return;
+    }
+
+    // validate the files' sizes if none of them exceeds the maximum allowed size
+    // validate files' names to ensure there are no duplicates if specified
+    const { compressedFiles, isInValid } = await validateUploadedFiles({
+      uploadedFiles,
+      maxFileSize,
+      compressFiles,
+      preventDuplicates,
+      files,
+      locale,
+    });
+
+    if (isInValid) return;
+
+    setIsLoading(true);
+
+    await Promise.all(
+      await refineUploadedFiles({
+        uploadedFiles: compressedFiles,
+        locale,
+        allowedTypes,
+        isMulti,
+        setFiles,
+      }),
+    ).finally(() => {
+      setIsLoading(false);
+    });
+
+    setTimeout(() => {
+      onChange();
+    }, 200);
+
+    // Reset the input value to allow re-uploading the same file
+    // Only reset for input change events, not drag events
+    if (event.target && "value" in event.target && event.target.files) {
+      (event.target as HTMLInputElement).value = "";
+    }
+  };
+
+  return {
+    files,
+    fileTypes,
+    labelId,
+    isRequired,
+    labelContent,
+    isDraggable,
+    isMulti,
+    handleClearFile,
+    onInputChange,
+    setFiles,
+    isLoading,
+  };
+};