@sykoramaros/marosh-components 0.1.17 → 0.2.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sykoramaros/marosh-components",
   "private": false,
-  "version": "0.1.17",
+  "version": "0.2.3",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -23,13 +23,15 @@
     "README.md"
   ],
   "scripts": {
-    "dev": "bun run vite",
+    "dev": "storybook dev -p 6006",
     "build": "bun run build:lib && bun run build:cli",
     "build:lib": "bun run vite build",
     "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",
@@ -37,46 +39,60 @@
   },
   "dependencies": {
     "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
     "@radix-ui/react-navigation-menu": "^1.2.14",
     "@radix-ui/react-separator": "^1.1.8",
     "@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",
-    "tailwind-merge": "^3.4.0"
+    "tailwind-merge": "^3.6.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.1",
-    "@inquirer/prompts": "^8.2.0",
-    "@tailwindcss/vite": "^4.1.18",
+    "@eslint/js": "^9.39.4",
+    "@inquirer/prompts": "^8.4.3",
+    "@tanstack/react-router": "^1.169.2",
+    "@tanstack/router-cli": "^1.166.43",
+    "@tanstack/router-plugin": "^1.167.35",
+    "ajv": "^8.20.0",
+    "@tailwindcss/vite": "^4.3.0",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^25.0.10",
-    "@types/react": "^19.2.5",
+    "@types/node": "^25.8.0",
+    "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^5.1.1",
-    "autoprefixer": "^10.4.23",
-    "commander": "^14.0.2",
-    "eslint": "^9.39.1",
-    "eslint-plugin-react-hooks": "^7.0.1",
-    "eslint-plugin-react-refresh": "^0.4.24",
-    "fs-extra": "^11.3.3",
+    "@vitejs/plugin-react": "^5.2.0",
+    "autoprefixer": "^10.5.0",
+    "commander": "^14.0.3",
+    "eslint": "^9.39.4",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-react-refresh": "^0.4.26",
+    "fs-extra": "^11.3.5",
     "globals": "^16.5.0",
-    "postcss": "^8.5.6",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "tailwindcss": "^4.0.0",
+    "postcss": "^8.5.14",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "tailwindcss": "^4.3.0",
     "tsup": "^8.5.1",
     "tw-animate-css": "^1.4.0",
     "typescript": "~5.9.3",
-    "typescript-eslint": "^8.46.4",
-    "vite": "^7.2.4",
-    "vite-plugin-dts": "^4.5.4"
+    "typescript-eslint": "^8.59.3",
+    "vite": "^7.3.3",
+    "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
@@ -18,13 +18,21 @@ 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 (
@@ -34,27 +42,27 @@ export const Footer = ({
           {socialProfiles.map((item) => {
             const Icon = typeof item.icon === "string" ? null : item.icon
             return (
-              <Link
+              <LinkComponent
                 to={item.url}
                 className="rounded-xl"
                 key={item.title}
                 target="_blank"
               >
                 {Icon && <Icon />}
-              </Link>
+              </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/LanguageSwitcher.stories.tsx

@@ -0,0 +1,52 @@
+import type { Meta, StoryObj } from "@storybook/tanstack-react"
+import { useState } from "react"
+import { LanguageSwitcher } from "./LanguageSwitcher"
+
+const LANGUAGES = [
+  { code: "en", label: "English", flag: "🇺🇸" },
+  { code: "fr", label: "Français", flag: "🇫🇷" },
+  { code: "es", label: "Español", flag: "🇪🇸" },
+  { code: "cs", label: "Čeština", flag: "🇨🇿" },
+]
+
+const meta: Meta<typeof LanguageSwitcher> = {
+  title: "Components/LanguageSwitcher",
+  component: LanguageSwitcher,
+  tags: ["autodocs"],
+  parameters: {
+    layout: "centered",
+  },
+}
+
+export default meta
+type Story = StoryObj<typeof LanguageSwitcher>
+
+export const Default: Story = {
+  render: () => {
+    const [lang, setLang] = useState("en")
+    return <LanguageSwitcher languages={LANGUAGES} value={lang} onChange={setLang} />
+  },
+}
+
+export const Bubble: Story = {
+  render: () => {
+    const [lang, setLang] = useState("en")
+    return <LanguageSwitcher languages={LANGUAGES} value={lang} onChange={setLang} variant="bubble" />
+  },
+}
+
+export const TwoLanguages: Story = {
+  render: () => {
+    const [lang, setLang] = useState("en")
+    return (
+      <LanguageSwitcher
+        languages={[
+          { code: "en", label: "English", flag: "🇺🇸" },
+          { code: "cs", label: "Čeština", flag: "🇨🇿" },
+        ]}
+        value={lang}
+        onChange={setLang}
+      />
+    )
+  },
+}

package/src/components/basicComponents/LanguageSwitcher.tsx

@@ -0,0 +1,84 @@
+import { ChevronDown } from "lucide-react"
+import { cn } from "@/lib/utils"
+import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu"
+
+export interface Language {
+  code: string
+  label: string
+  flag: string
+}
+
+export interface LanguageSwitcherProps {
+  languages: Language[]
+  value: string
+  onChange: (code: string) => void
+  variant?: "default" | "bubble"
+  className?: string
+}
+
+export function LanguageSwitcher({
+  languages,
+  value,
+  onChange,
+  variant = "default",
+  className,
+}: LanguageSwitcherProps) {
+  const current = languages.find((l) => l.code === value) ?? languages[0]
+  const isBubble = variant === "bubble"
+
+  return (
+    <DropdownMenuPrimitive.Root>
+      <DropdownMenuPrimitive.Trigger
+        className={cn(
+          "flex items-center transition-colors focus:outline-none",
+          isBubble
+            ? "gap-1 rounded-lg border border-border bg-background px-2 py-0.5 text-sm font-medium shadow-sm hover:bg-accent"
+            : "gap-1.5 rounded-md px-2.5 py-1.5 text-sm font-medium hover:bg-accent",
+          className
+        )}
+      >
+        <span className={cn("leading-none", isBubble ? "text-lg" : "text-base")}>{current.flag}</span>
+        {!isBubble && <span>{current.code.toUpperCase()}</span>}
+        <ChevronDown className={cn("opacity-60", isBubble ? "h-3 w-3 opacity-50" : "h-3.5 w-3.5")} />
+      </DropdownMenuPrimitive.Trigger>
+
+      <DropdownMenuPrimitive.Portal>
+        <DropdownMenuPrimitive.Content
+          align="end"
+          sideOffset={isBubble ? 10 : 4}
+          className={cn(
+            "relative z-50 overflow-visible p-1.5",
+            "data-[state=open]:animate-in data-[state=closed]:animate-out",
+            "data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0",
+            "data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95",
+            "data-[side=bottom]:slide-in-from-top-2",
+            isBubble
+              ? "group min-w-37.5 rounded-2xl border border-border bg-white shadow-xl"
+              : "min-w-35 rounded-md border bg-popover text-popover-foreground shadow-md"
+          )}
+        >
+          {isBubble && (
+            <span className="absolute right-4 h-3.5 w-3.5 rotate-45 border-border bg-white group-data-[side=bottom]:-top-1.75 group-data-[side=bottom]:rounded-tl-sm group-data-[side=bottom]:border-l group-data-[side=bottom]:border-t group-data-[side=top]:-bottom-1.75 group-data-[side=top]:rounded-br-sm group-data-[side=top]:border-r group-data-[side=top]:border-b" />
+          )}
+
+          {languages.map((lang) => (
+            <DropdownMenuPrimitive.Item
+              key={lang.code}
+              onSelect={() => onChange(lang.code)}
+              className={cn(
+                "flex cursor-pointer select-none items-center outline-none transition-colors focus:bg-accent",
+                isBubble
+                  ? "gap-3 rounded-xl px-3 py-2 text-sm"
+                  : "gap-2.5 rounded-sm px-2 py-1.5 text-sm",
+                lang.code === value && (isBubble ? "bg-accent font-medium" : "bg-accent")
+              )}
+            >
+              <span className={cn("leading-none", isBubble ? "text-xl" : "text-base")}>{lang.flag}</span>
+              <span>{lang.label}</span>
+            </DropdownMenuPrimitive.Item>
+          ))}
+        </DropdownMenuPrimitive.Content>
+      </DropdownMenuPrimitive.Portal>
+    </DropdownMenuPrimitive.Root>
+  )
+}

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>,
+  },
+}