@sykoramaros/marosh-components 0.1.15 → 0.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sykoramaros/marosh-components",
   "private": false,
-  "version": "0.1.15",
+  "version": "0.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -29,7 +29,9 @@
     "build:cli": "bun run tsup",
     "lint": "bun run eslint .",
     "preview": "bun run vite preview",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun run build",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -42,10 +44,6 @@
     "@radix-ui/react-slot": "^1.2.4",
     "@radix-ui/react-switch": "^1.2.6",
     "@radix-ui/react-tooltip": "^1.2.8",
-    "@tanstack/react-router": "^1.145.6",
-    "@tanstack/router-cli": "^1.145.6",
-    "@tanstack/router-plugin": "^1.145.6",
-    "ajv": "^8.17.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.562.0",
@@ -54,6 +52,10 @@
   "devDependencies": {
     "@eslint/js": "^9.39.1",
     "@inquirer/prompts": "^8.2.0",
+    "@tanstack/react-router": "^1.145.6",
+    "@tanstack/router-cli": "^1.145.6",
+    "@tanstack/router-plugin": "^1.145.6",
+    "ajv": "^8.17.1",
     "@tailwindcss/vite": "^4.1.18",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^25.0.10",
@@ -76,7 +78,20 @@
     "typescript": "~5.9.3",
     "typescript-eslint": "^8.46.4",
     "vite": "^7.2.4",
-    "vite-plugin-dts": "^4.5.4"
+    "vite-plugin-dts": "^4.5.4",
+    "storybook": "^10.4.0",
+    "@storybook/tanstack-react": "^10.4.0",
+    "@chromatic-com/storybook": "^5.2.1",
+    "@storybook/addon-vitest": "^10.4.0",
+    "@storybook/addon-a11y": "^10.4.0",
+    "@storybook/addon-docs": "^10.4.0",
+    "@storybook/addon-mcp": "^0.6.0",
+    "@tanstack/react-query": "^5.100.10",
+    "eslint-plugin-storybook": "^10.4.0",
+    "vitest": "^4.1.6",
+    "playwright": "^1.60.0",
+    "@vitest/browser-playwright": "^4.1.6",
+    "@vitest/coverage-v8": "^4.1.6"
   },
   "keywords": [
     "react",

package/src/components/basicComponents/CustomButton.stories.tsx

@@ -0,0 +1,60 @@
+import type { Meta, StoryObj } from "@storybook/tanstack-react"
+import { CustomButton } from "./CustomButton"
+
+const meta: Meta<typeof CustomButton> = {
+  title: "Components/CustomButton",
+  component: CustomButton,
+  tags: ["autodocs"],
+  argTypes: {
+    variant: {
+      control: "select",
+      options: ["default", "destructive", "outline", "secondary", "ghost", "link"],
+    },
+    size: {
+      control: "select",
+      options: ["default", "sm", "lg", "icon"],
+    },
+    disabled: { control: "boolean" },
+  },
+}
+
+export default meta
+type Story = StoryObj<typeof CustomButton>
+
+export const Default: Story = {
+  args: { children: "Button", variant: "default", size: "default" },
+}
+
+export const Destructive: Story = {
+  args: { children: "Delete", variant: "destructive" },
+}
+
+export const Outline: Story = {
+  args: { children: "Outline", variant: "outline" },
+}
+
+export const Secondary: Story = {
+  args: { children: "Secondary", variant: "secondary" },
+}
+
+export const Ghost: Story = {
+  args: { children: "Ghost", variant: "ghost" },
+}
+
+export const Disabled: Story = {
+  args: { children: "Disabled", variant: "default", disabled: true },
+}
+
+export const AllVariants: Story = {
+  render: () => (
+    <div className="flex flex-wrap gap-3">
+      {(["default", "destructive", "outline", "secondary", "ghost", "link"] as const).map(
+        (variant) => (
+          <CustomButton key={variant} variant={variant}>
+            {variant}
+          </CustomButton>
+        ),
+      )}
+    </div>
+  ),
+}

package/src/components/basicComponents/Footer.stories.tsx

@@ -0,0 +1,47 @@
+import type { Meta, StoryObj } from "@storybook/tanstack-react"
+import { Link } from "@tanstack/react-router"
+import { Facebook, Gitlab, Linkedin } from "lucide-react"
+import { Footer } from "./Footer"
+
+const meta: Meta<typeof Footer> = {
+  title: "Components/Footer",
+  component: Footer,
+  tags: ["autodocs"],
+}
+
+export default meta
+type Story = StoryObj<typeof Footer>
+
+const links = [
+  { title: "Home", url: "/" },
+  { title: "About", url: "/about" },
+  { title: "Contact", url: "/contact" },
+]
+
+const socialProfiles = [
+  { title: "Facebook", url: "https://facebook.com", icon: Facebook },
+  { title: "GitLab", url: "https://gitlab.com", icon: Gitlab },
+  { title: "LinkedIn", url: "https://linkedin.com", icon: Linkedin },
+]
+
+export const Default: Story = {
+  args: {
+    links,
+    socialProfiles,
+    copyright: `Copyright © ${new Date().getFullYear()}`,
+    LinkComponent: Link,
+  },
+}
+
+export const NoCopyright: Story = {
+  args: { links, socialProfiles, LinkComponent: Link },
+}
+
+export const NoSocial: Story = {
+  args: {
+    links,
+    socialProfiles: [],
+    copyright: `Copyright © ${new Date().getFullYear()}`,
+    LinkComponent: Link,
+  },
+}

package/src/components/basicComponents/Footer.tsx

@@ -1,6 +1,6 @@
-import { Link } from "@tanstack/react-router"
 import { LucideIcon } from "lucide-react"
 import { cn } from "@/lib/utils"
+import type { LinkComponentProps } from "@/components/basicComponents/MainNav"
 
 export interface FooterLinks {
   title: string
@@ -10,7 +10,7 @@ export interface FooterLinks {
 export interface FooterSocial {
   title: string
   url: string
-  icon?: LucideIcon | React.ComponentType
+  icon?: string | LucideIcon | React.ComponentType
 }
 
 export interface FooterItems extends React.ComponentPropsWithoutRef<"footer"> {
@@ -18,40 +18,51 @@ export interface FooterItems extends React.ComponentPropsWithoutRef<"footer"> {
   copyright?: string
   socialProfiles: FooterSocial[]
   className?: string
+  LinkComponent?: React.ComponentType<LinkComponentProps>
 }
 
+const DefaultLink = ({ to, className, children, target }: LinkComponentProps) => (
+  <a href={to} className={className} target={target}>
+    {children}
+  </a>
+)
+
 export const Footer = ({
   links,
   copyright,
   socialProfiles,
   className,
+  LinkComponent = DefaultLink,
   ...props
 }: FooterItems) => {
   return (
     <footer className={cn(className)} {...props}>
       <div className="flex flex-col items-center justify-center gap-5 bg-background py-8 border-t">
         <div className="flex justify-center gap-5 sm:gap-8 xl:gap-13">
-          {socialProfiles.map((item) => (
-            <Link
-              to={item.url}
-              className="rounded-xl"
-              key={item.title}
-              target="_blank"
-            >
-              {item.icon && <item.icon />}
-            </Link>
-          ))}
+          {socialProfiles.map((item) => {
+            const Icon = typeof item.icon === "string" ? null : item.icon
+            return (
+              <LinkComponent
+                to={item.url}
+                className="rounded-xl"
+                key={item.title}
+                target="_blank"
+              >
+                {Icon && <Icon />}
+              </LinkComponent>
+            )
+          })}
         </div>
         <div className="flex justify-center gap-5 sm:gap-8 xl:gap-13">
           {links.map((item) => {
             return (
-              <Link
+              <LinkComponent
                 key={item.title}
                 to={item.url}
                 className="no-underline! text-foreground!"
               >
                 {item.title}
-              </Link>
+              </LinkComponent>
             )
           })}
         </div>

package/src/components/basicComponents/MainNav.stories.tsx

@@ -0,0 +1,34 @@
+import type { Meta, StoryObj } from "@storybook/tanstack-react"
+import { Link } from "@tanstack/react-router"
+import { Home, Info, MessageSquareMore } from "lucide-react"
+import { MainNav } from "./MainNav"
+
+const meta: Meta<typeof MainNav> = {
+  title: "Components/MainNav",
+  component: MainNav,
+  tags: ["autodocs"],
+}
+
+export default meta
+type Story = StoryObj<typeof MainNav>
+
+const navItems = [
+  { title: "Home", url: "/", icon: Home },
+  { title: "About", url: "/about", icon: Info },
+  { title: "Contact", url: "/contact", icon: MessageSquareMore },
+]
+
+export const Default: Story = {
+  args: { navItems, LinkComponent: Link },
+}
+
+export const NoIcons: Story = {
+  args: {
+    navItems: navItems.map(({ title, url }) => ({ title, url })),
+    LinkComponent: Link,
+  },
+}
+
+export const Empty: Story = {
+  args: { navItems: [], LinkComponent: Link },
+}

package/src/components/basicComponents/MainNav.tsx

@@ -9,7 +9,6 @@ import { Sheet, SheetTrigger, SheetContent } from "@/components/ui/sheet"
 import { Button } from "@/components/ui/button"
 import { Menu, type LucideIcon } from "lucide-react"
 import { cn } from "@/lib/utils"
-import { Link } from "@tanstack/react-router"
 
 export interface NavItem {
   title: string
@@ -17,11 +16,30 @@ export interface NavItem {
   icon?: LucideIcon | React.ComponentType
 }
 
+export interface LinkComponentProps {
+  to: string
+  className?: string
+  children?: React.ReactNode
+  target?: string
+}
+
+const DefaultLink = ({ to, className, children, target }: LinkComponentProps) => (
+  <a href={to} className={className} target={target}>
+    {children}
+  </a>
+)
+
 export interface MainNavProps extends React.ComponentPropsWithoutRef<"header"> {
   navItems: NavItem[]
+  LinkComponent?: React.ComponentType<LinkComponentProps>
 }
 
-export const MainNav = ({ navItems, className, ...props }: MainNavProps) => {
+export const MainNav = ({
+  navItems,
+  className,
+  LinkComponent = DefaultLink,
+  ...props
+}: MainNavProps) => {
   return (
     <header className={cn(className)} {...props}>
       <nav className="hidden sm:flex sticky top-0 z-10 items-center px-4 h-14 bg-background">
@@ -33,13 +51,13 @@ export const MainNav = ({ navItems, className, ...props }: MainNavProps) => {
                   asChild
                   className={navigationMenuTriggerStyle()}
                 >
-                  <Link
+                  <LinkComponent
                     to={item.url}
                     className="flex items-center no-underline! text-foreground!"
                   >
                     {item.icon && <item.icon />}
                     <span>{item.title}</span>
-                  </Link>
+                  </LinkComponent>
                 </NavigationMenuLink>
               </NavigationMenuItem>
             ))}
@@ -56,14 +74,14 @@ export const MainNav = ({ navItems, className, ...props }: MainNavProps) => {
           <SheetContent side="top" className="p-8">
             <div className="flex flex-col gap-4">
               {navItems.map((item) => (
-                <Link
+                <LinkComponent
                   key={item.title}
                   to={item.url}
                   className="flex items-center gap-2 no-underline! text-foreground!"
                 >
                   {item.icon && <item.icon />}
                   <span className="text-base font-medium">{item.title}</span>
-                </Link>
+                </LinkComponent>
               ))}
             </div>
           </SheetContent>

package/src/components/basicComponents/MainSidebarLayout.stories.tsx

@@ -0,0 +1,77 @@
+import type { Meta, StoryObj } from "@storybook/tanstack-react"
+import { Link } from "@tanstack/react-router"
+import { Home, Info, MessageSquareMore, Facebook, Gitlab, Linkedin } from "lucide-react"
+import { MainSidebarLayout } from "./MainSidebarLayout"
+
+const meta: Meta<typeof MainSidebarLayout> = {
+  title: "Components/MainSidebarLayout",
+  component: MainSidebarLayout,
+  tags: ["autodocs"],
+  parameters: {
+    layout: "fullscreen",
+  },
+}
+
+export default meta
+type Story = StoryObj<typeof MainSidebarLayout>
+
+const navItems = [
+  { title: "Home", url: "/", icon: Home },
+  { title: "About", url: "/about", icon: Info },
+  { title: "Contact", url: "/contact", icon: MessageSquareMore },
+]
+
+const footerItems = {
+  links: [
+    { title: "Home", url: "/" },
+    { title: "About", url: "/about" },
+  ],
+  socialProfiles: [
+    { title: "Facebook", url: "https://facebook.com", icon: Facebook },
+    { title: "GitLab", url: "https://gitlab.com", icon: Gitlab },
+    { title: "LinkedIn", url: "https://linkedin.com", icon: Linkedin },
+  ],
+  copyright: `Copyright © ${new Date().getFullYear()}`,
+}
+
+export const WithNav: Story = {
+  args: {
+    useMainNav: true,
+    navItems,
+    LinkComponent: Link,
+    children: <div className="p-4">Page content</div>,
+  },
+}
+
+export const WithSidebar: Story = {
+  args: {
+    useSidebar: true,
+    appName: "My App",
+    navItems,
+    LinkComponent: Link,
+    children: <div className="p-4">Page content</div>,
+  },
+}
+
+export const WithSidebarAndFooter: Story = {
+  args: {
+    useSidebar: true,
+    useFooter: true,
+    appName: "My App",
+    navItems,
+    footerItems,
+    LinkComponent: Link,
+    children: <div className="p-4">Page content</div>,
+  },
+}
+
+export const NavAndFooter: Story = {
+  args: {
+    useMainNav: true,
+    useFooter: true,
+    navItems,
+    footerItems,
+    LinkComponent: Link,
+    children: <div className="p-4">Page content</div>,
+  },
+}

package/src/components/basicComponents/MainSidebarLayout.tsx

@@ -10,8 +10,7 @@ import {
   SidebarTrigger,
   SidebarProvider,
 } from "@/components/ui/sidebar"
-import { Link, Outlet } from "@tanstack/react-router"
-import { MainNav, type NavItem } from "@/components/basicComponents/MainNav"
+import { MainNav, type NavItem, type LinkComponentProps } from "@/components/basicComponents/MainNav"
 import { Footer, type FooterItems } from "@/components/basicComponents/Footer"
 
 export interface MainSidebarLayoutProps {
@@ -23,6 +22,7 @@ export interface MainSidebarLayoutProps {
   footerItems?: FooterItems
   sidebarDefaultOpen?: boolean
   children?: React.ReactNode
+  LinkComponent?: React.ComponentType<LinkComponentProps>
 }
 
 export const MainSidebarLayout = ({
@@ -33,25 +33,21 @@ export const MainSidebarLayout = ({
   navItems = [],
   footerItems,
   sidebarDefaultOpen = true,
+  children,
+  LinkComponent,
 }: MainSidebarLayoutProps) => {
-  // Layout bez sidebaru
   if (!useSidebar) {
     return (
       <div className="flex-1 flex min-h-screen flex-col">
-        {useMainNav && <MainNav navItems={navItems} />}
+        {useMainNav && <MainNav navItems={navItems} LinkComponent={LinkComponent} />}
         <main className="flex-1 p-5">
-          <Outlet />
+          {children}
         </main>
-        {useFooter && footerItems && (
-          <footer>
-            <Footer {...footerItems} />
-          </footer>
-        )}
+        {useFooter && footerItems && <Footer {...footerItems} LinkComponent={LinkComponent} />}
       </div>
     )
   }
 
-  // Layout se sidebarem
   return (
     <SidebarProvider defaultOpen={sidebarDefaultOpen}>
       <div className="flex min-h-screen w-full">
@@ -66,16 +62,29 @@ export const MainSidebarLayout = ({
                   {navItems.map((item) => (
                     <SidebarMenuItem key={item.title}>
                       <SidebarMenuButton asChild>
-                        <Link to={item.url}>
-                          {item.icon && (
-                            <span className="inline-flex h-5 w-5 shrink-0 items-center">
-                              <item.icon className="h-full w-full" />
+                        {LinkComponent ? (
+                          <LinkComponent to={item.url}>
+                            {item.icon && (
+                              <span className="inline-flex h-5 w-5 shrink-0 items-center">
+                                <item.icon className="h-full w-full" />
+                              </span>
+                            )}
+                            <span className="text-base font-medium">
+                              {item.title}
                             </span>
-                          )}
-                          <span className="text-base font-medium">
-                            {item.title}
-                          </span>
-                        </Link>
+                          </LinkComponent>
+                        ) : (
+                          <a href={item.url}>
+                            {item.icon && (
+                              <span className="inline-flex h-5 w-5 shrink-0 items-center">
+                                <item.icon className="h-full w-full" />
+                              </span>
+                            )}
+                            <span className="text-base font-medium">
+                              {item.title}
+                            </span>
+                          </a>
+                        )}
                       </SidebarMenuButton>
                     </SidebarMenuItem>
                   ))}
@@ -88,18 +97,14 @@ export const MainSidebarLayout = ({
         <div className="flex-1 flex flex-col">
           <header className="sticky top-0 z-10 flex items-center border-b bg-background px-4 h-14 gap-2">
             <SidebarTrigger />
-            {useMainNav && <MainNav navItems={navItems} />}
+            {useMainNav && <MainNav navItems={navItems} LinkComponent={LinkComponent} />}
           </header>
 
           <main className="flex-1 p-6">
-            <Outlet />
+            {children}
           </main>
 
-          {useFooter && footerItems && (
-            <footer>
-              <Footer {...footerItems} />
-            </footer>
-          )}
+          {useFooter && footerItems && <Footer {...footerItems} LinkComponent={LinkComponent} />}
         </div>
       </div>
     </SidebarProvider>

package/src/components/basicComponents/Switcher.stories.tsx

@@ -0,0 +1,42 @@
+import type { Meta, StoryObj } from "@storybook/tanstack-react"
+import { Moon, Sun } from "lucide-react"
+import { Switcher } from "./Switcher"
+
+const meta: Meta<typeof Switcher> = {
+  title: "Components/Switcher",
+  component: Switcher,
+  tags: ["autodocs"],
+  argTypes: {
+    checked: { control: "boolean" },
+    disabled: { control: "boolean" },
+  },
+}
+
+export default meta
+type Story = StoryObj<typeof Switcher>
+
+export const Default: Story = {
+  args: { checked: false },
+}
+
+export const Checked: Story = {
+  args: { checked: true },
+}
+
+export const WithIcon: Story = {
+  args: {
+    checked: false,
+    icon: <Moon className="h-3 w-3" />,
+  },
+}
+
+export const WithIconChecked: Story = {
+  args: {
+    checked: true,
+    icon: <Sun className="h-3 w-3" />,
+  },
+}
+
+export const Disabled: Story = {
+  args: { checked: false, disabled: true },
+}

package/src/components/basicComponents/Switcher.tsx

@@ -25,3 +25,5 @@ export const Switcher = React.forwardRef<
     </SwitchPrimitives.Thumb>
   </SwitchPrimitives.Root>
 ))
+
+Switcher.displayName = "Switcher"

package/src/index.ts

@@ -1,5 +1,7 @@
 export { cn } from "@/lib/utils.ts"
-export { Link } from "@tanstack/react-router"
+
+// COMPONENTS
+
 export {
   CustomButton,
   type CustomButtonProps,
@@ -8,6 +10,7 @@ export {
   MainNav,
   type NavItem,
   type MainNavProps,
+  type LinkComponentProps,
 } from "@/components/basicComponents/MainNav"
 export {
   Footer,
@@ -20,3 +23,25 @@ export {
   type MainSidebarLayoutProps,
 } from "@/components/basicComponents/MainSidebarLayout"
 export { Switcher } from "@/components/basicComponents/Switcher"
+
+// PROVIDERS
+export {
+  BaseUrlProvider,
+  useBaseUrl,
+  type BaseUrlProviderProps,
+} from "@/providers/BaseUrlProvider"
+
+export {
+  ThemeContextProvider,
+  useThemeContext,
+  type ThemeContextProviderProps,
+  type ThemeConfig,
+  type ThemeRegistry,
+  type ThemeMode,
+} from "@/providers/ThemeContextProvider"
+
+// HOOKS
+// ...
+
+// THEMES
+export { themeData } from "@/themes/index"

package/src/providers/BaseUrlProvider.tsx

@@ -0,0 +1,24 @@
+import { createContext, useContext, ReactNode } from "react"
+
+export const BaseUrlContext = createContext<string | undefined>(undefined)
+
+export interface BaseUrlProviderProps {
+  children: ReactNode
+  value: string
+}
+
+export const BaseUrlProvider = ({ children, value }: BaseUrlProviderProps) => {
+  return (
+    <BaseUrlContext.Provider value={value}>{children}</BaseUrlContext.Provider>
+  )
+}
+
+export const useBaseUrl = (): string => {
+  const context = useContext(BaseUrlContext)
+
+  if (context === undefined) {
+    throw new Error("useBaseUrl must be used within BaseUrlProvider")
+  }
+
+  return context
+}