@js-empire/emperor-ui 1.3.10 → 1.3.12

package/src/components/organisms/listings/stories/list-listings.stories.tsx

@@ -0,0 +1,171 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { Listings } from "@/components";
+import { getStorybookDecorators } from "@/utils";
+import { getListings, MOCK_LISTINGS } from "@/mocks";
+import type { MockItemType } from "@/mocks";
+import { useMemo, useState } from "react";
+import { useEffect } from "react";
+import { ListingsProps } from "@/types";
+import { usePagination } from "@heroui/pagination";
+
+const meta: Meta<typeof Listings> = {
+  title: "Organisms/Listings/List",
+  component: Listings,
+  parameters: {
+    layout: "centered",
+  },
+  tags: ["autodocs"],
+  decorators: getStorybookDecorators({
+    config: {
+      layout: {
+        withScaffold: false,
+      },
+    },
+  }),
+};
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  args: {
+    layout: "list",
+  },
+  render: (args: ListingsProps) => {
+    return (
+      <main className="w-screen container mx-auto p-5">
+        <Listings
+          {...args}
+          items={MOCK_LISTINGS.map((item) => ({
+            item: {
+              key: String(item.id),
+              title: item?.title,
+              description: item.description,
+              image: { src: item?.image, alt: item?.title },
+            },
+          }))}
+        />
+      </main>
+    );
+  },
+};
+
+export const WithLoading: Story = {
+  args: {
+    layout: "list",
+  },
+  render: (args: ListingsProps) => {
+    const [items, setItems] = useState<MockItemType[]>([]);
+    const [isLoading, setIsLoading] = useState(true);
+
+    useEffect(() => {
+      (async () => {
+        const { items } = await getListings({});
+
+        setItems(items);
+        setIsLoading(false);
+      })();
+    }, []);
+
+    return (
+      <Listings
+        {...args}
+        isLoading={isLoading}
+        items={items.map((item) => ({
+          item: {
+            key: String(item.id),
+            title: item?.title,
+            description: item.description,
+            image: { src: item?.image, alt: item?.title },
+          },
+        }))}
+      />
+    );
+  },
+};
+
+export const WithActions: Story = {
+  args: {
+    layout: "list",
+    items: MOCK_LISTINGS.map((item) => ({
+      item: {
+        key: String(item.id),
+        title: item?.title,
+        description: item.description,
+        image: { src: item?.image, alt: item?.title },
+      },
+      actions: [
+        { key: "view", label: "View details" },
+        { key: "edit", label: "Edit" },
+        { key: "delete", label: "Delete" },
+      ],
+    })),
+  },
+};
+
+export const WithPagination: Story = {
+  args: {
+    layout: "list",
+  },
+  render: (args: ListingsProps) => {
+    const [items, setItems] = useState<MockItemType[]>([]);
+    const [isLoading, setIsLoading] = useState(true);
+
+    const pageSize = 6;
+    const totalItemsCount = MOCK_LISTINGS.length;
+    const pagesCount = useMemo(
+      () => Math.ceil(totalItemsCount / pageSize),
+      [totalItemsCount, pageSize],
+    );
+
+    const { activePage: page, setPage } = usePagination({
+      total: pagesCount,
+      initialPage: 1,
+    });
+
+    useEffect(() => {
+      (async () => {
+        setIsLoading(true);
+
+        const { items } = await getListings({
+          page,
+          pageSize,
+        });
+
+        setItems(items);
+        setIsLoading(false);
+      })();
+    }, [page]);
+
+    return (
+      <Listings
+        {...args}
+        isLoading={isLoading}
+        items={items.map((item) => ({
+          item: {
+            key: String(item.id),
+            title: item?.title,
+            description: item.description,
+            image: { src: item?.image, alt: item?.title },
+            banner: item?.isBestSeller ? "Best Seller" : undefined,
+            chips: item?.categories || [],
+          },
+        }))}
+        pagination={{
+          page,
+          setPage,
+          pageSize,
+          totalItemsCount,
+          pagesCount,
+        }}
+      />
+    );
+  },
+};
+
+export const EmptyListings: Story = {
+  args: {
+    items: [],
+  },
+};

package/src/components/organisms/listings/styles/classes.ts

@@ -0,0 +1,49 @@
+import { cva } from "class-variance-authority";
+
+export const listingsClasses = cva(["w-full p-4 gap-4 relative"], {
+  variants: {
+    layout: {
+      grid: "grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4",
+      list: "flex flex-col gap-4",
+      carousel: "flex flex-col gap-4",
+    },
+  },
+  defaultVariants: {},
+  compoundVariants: [],
+});
+
+export const listingsItemClasses = cva([""], {
+  variants: {
+    layout: {
+      grid: "size-full",
+      list: "w-full h-fit",
+      carousel: "",
+    },
+  },
+  defaultVariants: {},
+  compoundVariants: [],
+});
+
+export const listingsPaginationClasses = cva(["mx-auto my-5 col-span-full"], {
+  variants: {
+    layout: {
+      grid: "",
+      list: "",
+      carousel: "",
+    },
+  },
+  defaultVariants: {},
+  compoundVariants: [],
+});
+
+export const emptyListingsClasses = cva(
+  [
+    "flex flex-col items-center justify-center min-h-[280px] w-full py-12 px-4",
+    "text-center",
+  ],
+  {
+    variants: {},
+    defaultVariants: {},
+    compoundVariants: [],
+  },
+);

package/src/components/organisms/listings/styles/index.ts

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

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

@@ -0,0 +1,6 @@
+import { CSSProperties } from "react";
+
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type, no-empty-pattern
+export const listingsStyles = ({}: {}): CSSProperties => {
+  return {};
+};

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/animations.ts

@@ -0,0 +1,14 @@
+/* eslint-disable no-empty-pattern */
+import { ItemCardHoverEffect } from "@/types";
+import { MotionProps } from "framer-motion";
+
+export const getCardMotion = ({}: {
+  hoverEffect: ItemCardHoverEffect;
+}): MotionProps => ({
+  initial: { opacity: 0, y: 12 },
+  animate: { opacity: 1, y: 0 },
+  transition: { duration: 0.3, ease: "easeOut" as const },
+  whileHover: {
+    y: -4,
+  },
+});

package/src/constants/card.tsx

@@ -0,0 +1,42 @@
+/* eslint-disable react-refresh/only-export-components */
+import { Eye, Pencil, Trash2 } from "lucide-react";
+import { ItemCardAction } from "@/types";
+
+export const ITEM_CARD_ACTIONS: ItemCardAction[] = [
+  {
+    key: "view",
+    label: "View details",
+    color: "primary",
+    variant: "flat",
+    size: "sm",
+    startContent: <Eye className="size-4" />,
+  },
+  {
+    key: "edit",
+    label: "Edit",
+    color: "secondary",
+    variant: "flat",
+    size: "sm",
+    startContent: <Pencil className="size-4" />,
+  },
+  {
+    key: "delete",
+    label: "Delete",
+    color: "danger",
+    variant: "flat",
+    size: "sm",
+    startContent: <Trash2 className="size-4" />,
+  },
+];
+
+export const ITEM_CARD_ACTIONS_OVERLAY: ItemCardAction[] =
+  ITEM_CARD_ACTIONS.map((action) => ({
+    ...action,
+    variant: "solid",
+    size: "lg",
+    startContent: {
+      view: <Eye className="size-5" />,
+      edit: <Pencil className="size-5" />,
+      delete: <Trash2 className="size-5" />,
+    }[action?.key],
+  }));

package/src/constants/defaults.ts

@@ -0,0 +1,59 @@
+import { en, ar } from "@/i18n";
+import type { EmperorUIConfig } from "@/types";
+
+export const defaultEmperorUIConfig: EmperorUIConfig = {
+  layout: {
+    withScaffold: true,
+  },
+  interLocalization: {
+    lang: "en",
+    languages: ["en", "ar"],
+    defaultLanguage: "en",
+    dir: "ltr",
+    isMultiLingual: false,
+    locales: {
+      en,
+      ar,
+    },
+  },
+  theme: {
+    components: {
+      input: {
+        variant: "faded",
+        labelPlacement: "outside",
+        size: "sm",
+      },
+      textarea: {
+        variant: "faded",
+        labelPlacement: "outside",
+        size: "sm",
+      },
+      button: {
+        variant: "faded",
+        size: "sm",
+      },
+      select: {
+        variant: "faded",
+        labelPlacement: "outside",
+        placeholder: "Select an option",
+        size: "sm",
+      },
+      selectItem: {
+        variant: "faded",
+      },
+      autocomplete: {
+        variant: "faded",
+        labelPlacement: "outside",
+        size: "sm",
+      },
+      autocompleteItem: {
+        variant: "faded",
+      },
+      datePicker: {
+        variant: "faded",
+        labelPlacement: "outside",
+        size: "sm",
+      },
+    },
+  },
+};

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

@@ -0,0 +1,6 @@
+export * from "./defaults";
+export * from "./fake";
+export * from "./uploader";
+export * from "./footer";
+export * from "./animations";
+export * from "./card";

package/src/constants/uploader.ts

@@ -0,0 +1,33 @@
+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 ALLOWED_SHEET_TYPES = [
+  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  "application/vnd.ms-excel",
+  "text/csv",
+];
+
+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", ".xls", ".csv"],
+};

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

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

package/src/context/form-builder-context.tsx

@@ -0,0 +1,8 @@
+"use client";
+
+import { createContext } from "react";
+import { FormBuilderValue } from "@/types";
+import { FieldValues } from "react-hook-form";
+
+export const FormBuilderContext =
+  createContext<FormBuilderValue<FieldValues> | null>(null);

package/src/context/index.ts

@@ -0,0 +1,4 @@
+export * from "./emperor-ui-context";
+export * from "./navigation-context";
+export * from "./uploader-context";
+export * from "./form-builder-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);