@nikala-ui/core 0.6.0

package/registry/theme-manager.json

@@ -0,0 +1,38 @@
+{
+  "name": "theme-manager",
+  "title": "Theme Manager",
+  "description": "Zero-dependency ThemeProvider and ThemeToggle component for switching light, dark, and system themes.",
+  "type": "registry:ui",
+  "dependencies": [
+    "clsx",
+    "tailwind-merge",
+    "@kobalte/core",
+    "lucide-solid"
+  ],
+  "registryDependencies": [
+    "button",
+    "dropdown-menu"
+  ],
+  "files": [
+    {
+      "path": "providers/theme-provider.tsx",
+      "content": "import {\n  createContext,\n  createEffect,\n  createSignal,\n  onCleanup,\n  onMount,\n  useContext,\n  type ParentComponent,\n  type Accessor,\n} from \"solid-js\";\n\nexport type Theme = \"light\" | \"dark\" | \"system\";\nexport type AccentColor = \"wine\" | \"violet\" | \"sky\" | \"emerald\" | \"rose\" | \"amber\" | \"zinc\";\nexport type Radius = \"0\" | \"0.3\" | \"0.5\" | \"0.75\" | \"1.0\";\n\nexport interface ThemeProviderProps {\n  /** Initial default theme mode if no saved preference is found in localStorage */\n  defaultTheme?: Theme;\n  /** Initial default accent color override if needed */\n  defaultAccent?: AccentColor;\n  /** Initial default border radius override if needed */\n  defaultRadius?: Radius;\n  /** Key used to store theme preferences in localStorage */\n  storageKey?: string;\n}\n\nconst ACCENT_COLORS: Record<\n  AccentColor,\n  { light: string; dark: string; lightFg: string; darkFg: string }\n> = {\n  wine: { light: \"#722f37\", dark: \"#9e3b47\", lightFg: \"#ffffff\", darkFg: \"#ffffff\" },\n  violet: { light: \"#7c3aed\", dark: \"#8b5cf6\", lightFg: \"#ffffff\", darkFg: \"#ffffff\" },\n  sky: { light: \"#0284c7\", dark: \"#38bdf8\", lightFg: \"#ffffff\", darkFg: \"#0f172a\" },\n  emerald: { light: \"#059669\", dark: \"#34d399\", lightFg: \"#ffffff\", darkFg: \"#052e16\" },\n  rose: { light: \"#e11d48\", dark: \"#fb7185\", lightFg: \"#ffffff\", darkFg: \"#ffffff\" },\n  amber: { light: \"#d97706\", dark: \"#fbbf24\", lightFg: \"#ffffff\", darkFg: \"#111827\" },\n  zinc: { light: \"#18181b\", dark: \"#fafafa\", lightFg: \"#fafafa\", darkFg: \"#18181b\" },\n};\n\ninterface ThemeProviderContextValue {\n  theme: Accessor<Theme>;\n  setTheme: (theme: Theme) => void;\n  accent: Accessor<AccentColor | undefined>;\n  setAccent: (accent: AccentColor) => void;\n  radius: Accessor<Radius | undefined>;\n  setRadius: (radius: Radius) => void;\n}\n\nconst ThemeProviderContext = createContext<ThemeProviderContextValue>();\n\n/**\n * Context provider managing application theme state (light/dark/system), accent colors, and border radius.\n */\nexport const ThemeProvider: ParentComponent<ThemeProviderProps> = (props) => {\n  const storageKey = props.storageKey || \"nikala-theme\";\n  const defaultTheme = props.defaultTheme || \"system\";\n\n  // Safely read saved values from localStorage without forcing unnecessary fallbacks\n  const getInitialTheme = (): Theme => {\n    if (typeof window === \"undefined\") return defaultTheme;\n    try {\n      const saved = localStorage.getItem(`${storageKey}-mode`);\n      if (saved === \"light\" || saved === \"dark\" || saved === \"system\") return saved;\n    } catch { }\n    return defaultTheme;\n  };\n\n  const getInitialAccent = (): AccentColor | undefined => {\n    if (typeof window === \"undefined\") return props.defaultAccent;\n    try {\n      const saved = localStorage.getItem(`${storageKey}-accent`);\n      if (saved && ACCENT_COLORS[saved as AccentColor]) return saved as AccentColor;\n    } catch { }\n    return props.defaultAccent;\n  };\n\n  const getInitialRadius = (): Radius | undefined => {\n    if (typeof window === \"undefined\") return props.defaultRadius;\n    try {\n      const saved = localStorage.getItem(`${storageKey}-radius`);\n      if (saved) return saved as Radius;\n    } catch { }\n    return props.defaultRadius;\n  };\n\n  const [theme, setThemeSignal] = createSignal<Theme>(getInitialTheme());\n  const [accent, setAccentSignal] = createSignal<AccentColor | undefined>(getInitialAccent());\n  const [radius, setRadiusSignal] = createSignal<Radius | undefined>(getInitialRadius());\n\n  // Applies classes and CSS custom properties when custom overrides are explicitly set\n  const applyTheme = (\n    targetTheme: Theme,\n    currentAccent: AccentColor | undefined,\n    currentRadius: Radius | undefined\n  ) => {\n    if (typeof window === \"undefined\") return;\n\n    const root = document.documentElement;\n    root.classList.remove(\"light\", \"dark\");\n\n    let resolvedDark = false;\n    if (targetTheme === \"system\") {\n      resolvedDark = window.matchMedia(\"(prefers-color-scheme: dark)\").matches;\n      root.classList.add(resolvedDark ? \"dark\" : \"light\");\n    } else {\n      resolvedDark = targetTheme === \"dark\";\n      root.classList.add(targetTheme);\n    }\n\n    // Override --primary CSS variables ONLY if explicitly chosen\n    if (currentAccent && ACCENT_COLORS[currentAccent]) {\n      const accentData = ACCENT_COLORS[currentAccent];\n      const primaryHex = resolvedDark ? accentData.dark : accentData.light;\n      const primaryFgHex = resolvedDark ? accentData.darkFg : accentData.lightFg;\n\n      root.style.setProperty(\"--primary\", primaryHex);\n      root.style.setProperty(\"--primary-foreground\", primaryFgHex);\n    }\n\n    // Override --radius CSS variable ONLY if explicitly chosen\n    if (currentRadius) {\n      root.style.setProperty(\"--radius\", `${currentRadius}rem`);\n    }\n  };\n\n  // Reactively apply theme updates and store preferences in localStorage\n  createEffect(() => {\n    const t = theme();\n    const a = accent();\n    const r = radius();\n\n    applyTheme(t, a, r);\n\n    if (typeof window !== \"undefined\") {\n      try {\n        localStorage.setItem(`${storageKey}-mode`, t);\n        if (a) localStorage.setItem(`${storageKey}-accent`, a);\n        if (r) localStorage.setItem(`${storageKey}-radius`, r);\n      } catch { }\n    }\n  });\n\n  onMount(() => {\n    if (typeof window === \"undefined\") return;\n\n    const mediaQuery = window.matchMedia(\"(prefers-color-scheme: dark)\");\n\n    const handleSystemChange = (e: MediaQueryListEvent) => {\n      if (theme() === \"system\") {\n        const root = document.documentElement;\n        root.classList.remove(\"light\", \"dark\");\n        root.classList.add(e.matches ? \"dark\" : \"light\");\n\n        const currentAccent = accent();\n        if (currentAccent && ACCENT_COLORS[currentAccent]) {\n          const accentData = ACCENT_COLORS[currentAccent];\n          const primaryHex = e.matches ? accentData.dark : accentData.light;\n          const primaryFgHex = e.matches ? accentData.darkFg : accentData.lightFg;\n\n          root.style.setProperty(\"--primary\", primaryHex);\n          root.style.setProperty(\"--primary-foreground\", primaryFgHex);\n        }\n      }\n    };\n\n    if (mediaQuery.addEventListener) {\n      mediaQuery.addEventListener(\"change\", handleSystemChange);\n    } else if (\"addListener\" in mediaQuery) {\n      (mediaQuery as any).addListener(handleSystemChange);\n    }\n\n    onCleanup(() => {\n      if (mediaQuery.removeEventListener) {\n        mediaQuery.removeEventListener(\"change\", handleSystemChange);\n      } else if (\"removeListener\" in mediaQuery) {\n        (mediaQuery as any).removeListener(handleSystemChange);\n      }\n    });\n  });\n\n  const value: ThemeProviderContextValue = {\n    theme,\n    setTheme: (newTheme: Theme) => setThemeSignal(newTheme),\n    accent,\n    setAccent: (newAccent: AccentColor) => setAccentSignal(newAccent),\n    radius,\n    setRadius: (newRadius: Radius) => setRadiusSignal(newRadius),\n  };\n\n  return (\n    <ThemeProviderContext.Provider value={value}>\n      {props.children}\n    </ThemeProviderContext.Provider>\n  );\n};\n\n/**\n * Accesses Nikala UI theme state, accent colors, border radius, and update functions.\n */\nexport function useTheme(): ThemeProviderContextValue {\n  const context = useContext(ThemeProviderContext);\n  if (!context) {\n    throw new Error(\"useTheme must be used within a ThemeProvider\");\n  }\n  return context;\n}\n\nexport { ThemeScript, type ThemeScriptProps } from \"./theme-script\";",
+      "type": "registry:ui"
+    },
+    {
+      "path": "providers/theme-transitions.ts",
+      "content": "export type ThemeEffect = \"none\" | \"circular\" | \"fade\";\n\n/**\n * Injects required CSS view-transition pseudo-element styles to prevent browser mix-blend artifacts.\n */\nfunction ensureTransitionStyles() {\n  if (typeof document === \"undefined\") return;\n  const styleId = \"nikala-view-transition-styles\";\n  if (!document.getElementById(styleId)) {\n    const style = document.createElement(\"style\");\n    style.id = styleId;\n    style.textContent = `\n      ::view-transition-old(root),\n      ::view-transition-new(root) {\n        animation: none;\n        mix-blend-mode: normal;\n      }\n      ::view-transition-old(root) {\n        z-index: 1;\n      }\n      ::view-transition-new(root) {\n        z-index: 9999;\n      }\n    `;\n    document.head.appendChild(style);\n  }\n}\n\n/**\n * Executes a theme change with the specified transition effect using the Web View Transitions API.\n *\n * @param effect - Desired transition animation (\"none\", \"circular\", \"fade\")\n * @param event - Mouse or Pointer event to calculate transition center coordinates\n * @param updateThemeCallback - Callback function performing the actual theme state change\n */\nexport function runThemeTransition(\n  effect: ThemeEffect = \"none\",\n  event: MouseEvent | undefined,\n  updateThemeCallback: () => void\n) {\n  // Safe fallback if View Transitions API is unsupported or user prefers reduced motion\n  if (\n    effect === \"none\" ||\n    typeof document === \"undefined\" ||\n    !(document as any).startViewTransition ||\n    window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches\n  ) {\n    updateThemeCallback();\n    return;\n  }\n\n  ensureTransitionStyles();\n\n  // Circular expanding ripple transition originating from click coordinates\n  if (effect === \"circular\" && event) {\n    const x = event.clientX;\n    const y = event.clientY;\n\n    const endRadius = Math.hypot(\n      Math.max(x, window.innerWidth - x),\n      Math.max(y, window.innerHeight - y)\n    );\n\n    const transition = (document as any).startViewTransition(() => {\n      updateThemeCallback();\n    });\n\n    transition.ready.then(() => {\n      document.documentElement.animate(\n        {\n          clipPath: [\n            `circle(0px at ${x}px ${y}px)`,\n            `circle(${endRadius}px at ${x}px ${y}px)`,\n          ],\n        },\n        {\n          duration: 500,\n          easing: \"ease-in-out\",\n          pseudoElement: \"::view-transition-new(root)\",\n        }\n      );\n    });\n    return;\n  }\n\n  // Smooth opacity fade view transition\n  if (effect === \"fade\") {\n    const transition = (document as any).startViewTransition(() => {\n      updateThemeCallback();\n    });\n\n    transition.ready.then(() => {\n      document.documentElement.animate(\n        {\n          opacity: [0, 1],\n        },\n        {\n          duration: 350,\n          easing: \"ease-in-out\",\n          pseudoElement: \"::view-transition-new(root)\",\n        }\n      );\n    });\n    return;\n  }\n\n  updateThemeCallback();\n}",
+      "type": "registry:ui"
+    },
+    {
+      "path": "providers/theme-script.tsx",
+      "content": "import { type Component } from \"solid-js\";\n\nexport interface ThemeScriptProps {\n  /** Storage key namespace used in localStorage (default: \"nikala-theme\") */\n  storageKey?: string;\n  /** Initial default theme mode if no saved preference exists (default: \"system\") */\n  defaultTheme?: \"light\" | \"dark\" | \"system\";\n  /** Initial default primary accent color if no saved preference exists */\n  defaultAccent?: string;\n  /** Initial default border radius if no saved preference exists */\n  defaultRadius?: string;\n}\n\n/**\n * Pre-hydration inline script executed synchronously before DOM paint to prevent theme flickering (anti-FOUC).\n */\nexport const ThemeScript: Component<ThemeScriptProps> = (props) => {\n  const key = props.storageKey || \"nikala-theme\";\n  const defTheme = props.defaultTheme || \"system\";\n  const defAccent = props.defaultAccent || \"\";\n  const defRadius = props.defaultRadius || \"\";\n\n  const scriptText = `(function(){try{\n  var key = '${key}';\n  var mode = localStorage.getItem(key + '-mode') || '${defTheme}';\n  var accent = localStorage.getItem(key + '-accent') || '${defAccent}';\n  var radius = localStorage.getItem(key + '-radius') || '${defRadius}';\n\n  var isDark = window.matchMedia('(prefers-color-scheme: dark)').matches;\n  var resolvedDark = mode === 'dark' || (mode === 'system' && isDark);\n\n  var root = document.documentElement;\n  root.classList.remove('light', 'dark');\n  root.classList.add(resolvedDark ? 'dark' : 'light');\n  root.style.colorScheme = resolvedDark ? 'dark' : 'light';\n\n  var colorMap = {\n    wine: resolvedDark ? '#9e3b47' : '#722f37',\n    violet: resolvedDark ? '#8b5cf6' : '#7c3aed',\n    sky: resolvedDark ? '#38bdf8' : '#0284c7',\n    emerald: resolvedDark ? '#34d399' : '#059669',\n    rose: resolvedDark ? '#fb7185' : '#e11d48',\n    amber: resolvedDark ? '#fbbf24' : '#d97706',\n    zinc: resolvedDark ? '#fafafa' : '#18181b'\n  };\n\n  if (accent && colorMap[accent]) {\n    root.style.setProperty('--primary', colorMap[accent]);\n  }\n\n  if (radius) {\n    var radVal = radius.endsWith('rem') ? radius : radius + 'rem';\n    root.style.setProperty('--radius', radVal);\n  }\n}catch(e){}})();`;\n\n  return <script innerHTML={scriptText} />;\n};",
+      "type": "registry:ui"
+    },
+    {
+      "path": "ui/theme-toggle.tsx",
+      "content": "import { splitProps, type Component, For, Show } from \"solid-js\";\nimport { Sun, Moon, Monitor } from \"lucide-solid\";\nimport {\n  useTheme,\n  type AccentColor,\n  type Radius,\n  type Theme,\n} from \"../../providers/theme-provider\";\nimport {\n  runThemeTransition,\n  type ThemeEffect,\n} from \"../../providers/theme-transitions\";\nimport { Button } from \"./button\";\nimport {\n  DropdownMenu,\n  DropdownMenuTrigger,\n  DropdownMenuContent,\n  DropdownMenuItem,\n  DropdownMenuLabel,\n  DropdownMenuSeparator,\n} from \"./dropdown-menu\";\nimport { cn } from \"@/lib/cn\";\n\nexport interface ThemeToggleProps {\n  /** Display mode: \"mini\" for compact dropdown, \"max\" for full customizer panel (default: \"mini\") */\n  mode?: \"mini\" | \"max\";\n  /** Transition animation effect when changing themes (\"none\", \"circular\", \"fade\") */\n  effect?: ThemeEffect;\n  class?: string;\n}\n\nconst ACCENT_OPTIONS: { name: AccentColor; label: string; color: string }[] = [\n  { name: \"wine\", label: \"Wine\", color: \"bg-[#722f37]\" },\n  { name: \"violet\", label: \"Violet\", color: \"bg-[#7c3aed]\" },\n  { name: \"sky\", label: \"Sky\", color: \"bg-[#0284c7]\" },\n  { name: \"emerald\", label: \"Emerald\", color: \"bg-[#059669]\" },\n  { name: \"rose\", label: \"Rose\", color: \"bg-[#e11d48]\" },\n  { name: \"amber\", label: \"Amber\", color: \"bg-[#d97706]\" },\n  { name: \"zinc\", label: \"Zinc\", color: \"bg-[#18181b]\" },\n];\n\nconst RADIUS_OPTIONS: { value: Radius; label: string }[] = [\n  { value: \"0\", label: \"0\" },\n  { value: \"0.3\", label: \"0.3\" },\n  { value: \"0.5\", label: \"0.5\" },\n  { value: \"0.75\", label: \"0.75\" },\n  { value: \"1.0\", label: \"1.0\" },\n];\n\n/**\n * Interactive UI theme switcher supporting mini/max modes and View Transition animations.\n */\nexport const ThemeToggle: Component<ThemeToggleProps> = (props) => {\n  const [local] = splitProps(props, [\"mode\", \"effect\", \"class\"]);\n  const { theme, setTheme, accent, setAccent, radius, setRadius } = useTheme();\n\n  const mode = () => local.mode || \"mini\";\n  const effect = () => local.effect || \"none\";\n\n  /* Reactive accessor determining whether dark mode is active */\n  const isDarkMode = () => {\n    const currentTheme = theme();\n    if (currentTheme === \"dark\") return true;\n    if (currentTheme === \"light\") return false;\n    return (\n      typeof window !== \"undefined\" &&\n      window.matchMedia(\"(prefers-color-scheme: dark)\").matches\n    );\n  };\n\n  const changeThemeWithEffect = (newTheme: Theme, e: MouseEvent) => {\n    runThemeTransition(effect(), e, () => {\n      setTheme(newTheme);\n    });\n  };\n\n  return (\n    <DropdownMenu placement=\"bottom-end\">\n      <DropdownMenuTrigger\n        as={Button}\n        variant=\"outline\"\n        size=\"icon\"\n        class={cn(\"relative h-9 w-9 cursor-pointer\", local.class)}\n      >\n        {/* Reactive Sun / Moon Icon Toggle */}\n        <Show\n          when={isDarkMode()}\n          fallback={<Sun class=\"h-4 w-4 text-foreground transition-transform\" />}\n        >\n          <Moon class=\"h-4 w-4 text-foreground transition-transform\" />\n        </Show>\n\n        <span class=\"sr-only\">Toggle theme</span>\n      </DropdownMenuTrigger>\n\n      <Show\n        when={mode() === \"max\"}\n        fallback={\n          /* Mini Mode: Compact Dropdown */\n          <DropdownMenuContent>\n            <DropdownMenuItem onClick={(e: MouseEvent) => changeThemeWithEffect(\"light\", e)}>\n              <Sun class=\"mr-2 h-4 w-4 text-muted-foreground\" />\n              Light\n            </DropdownMenuItem>\n\n            <DropdownMenuItem onClick={(e: MouseEvent) => changeThemeWithEffect(\"dark\", e)}>\n              <Moon class=\"mr-2 h-4 w-4 text-muted-foreground\" />\n              Dark\n            </DropdownMenuItem>\n\n            <DropdownMenuItem onClick={(e: MouseEvent) => changeThemeWithEffect(\"system\", e)}>\n              <Monitor class=\"mr-2 h-4 w-4 text-muted-foreground\" />\n              System\n            </DropdownMenuItem>\n          </DropdownMenuContent>\n        }\n      >\n        {/* Max Mode: Full Theme Customizer Panel */}\n        <DropdownMenuContent class=\"w-64 p-3\">\n          <DropdownMenuLabel class=\"px-0 pt-0 text-xs font-semibold uppercase tracking-wider text-muted-foreground\">\n            Theme Mode\n          </DropdownMenuLabel>\n          <div class=\"grid grid-cols-3 gap-1 my-1.5\">\n            <Button\n              variant={theme() === \"light\" ? \"default\" : \"outline\"}\n              size=\"sm\"\n              onClick={(e: MouseEvent) => changeThemeWithEffect(\"light\", e)}\n              class=\"h-8 text-xs cursor-pointer\"\n            >\n              Light\n            </Button>\n            <Button\n              variant={theme() === \"dark\" ? \"default\" : \"outline\"}\n              size=\"sm\"\n              onClick={(e: MouseEvent) => changeThemeWithEffect(\"dark\", e)}\n              class=\"h-8 text-xs cursor-pointer\"\n            >\n              Dark\n            </Button>\n            <Button\n              variant={theme() === \"system\" ? \"default\" : \"outline\"}\n              size=\"sm\"\n              onClick={(e: MouseEvent) => changeThemeWithEffect(\"system\", e)}\n              class=\"h-8 text-xs cursor-pointer\"\n            >\n              System\n            </Button>\n          </div>\n\n          <DropdownMenuSeparator class=\"my-2\" />\n\n          <DropdownMenuLabel class=\"px-0 text-xs font-semibold uppercase tracking-wider text-muted-foreground\">\n            Brand Accent Color\n          </DropdownMenuLabel>\n          <div class=\"flex flex-wrap gap-1.5 my-1.5\">\n            <For each={ACCENT_OPTIONS}>\n              {(opt) => (\n                <button\n                  type=\"button\"\n                  title={opt.label}\n                  onClick={() => setAccent(opt.name)}\n                  class={cn(\n                    \"h-6 w-6 rounded-md transition-all cursor-pointer border border-border flex items-center justify-center\",\n                    opt.color,\n                    accent() === opt.name ? \"ring-2 ring-primary ring-offset-2 ring-offset-background scale-110\" : \"hover:scale-105\"\n                  )}\n                />\n              )}\n            </For>\n          </div>\n\n          <DropdownMenuSeparator class=\"my-2\" />\n\n          <DropdownMenuLabel class=\"px-0 text-xs font-semibold uppercase tracking-wider text-muted-foreground\">\n            Border Radius\n          </DropdownMenuLabel>\n          <div class=\"grid grid-cols-5 gap-1 my-1.5\">\n            <For each={RADIUS_OPTIONS}>\n              {(r) => (\n                <Button\n                  variant={radius() === r.value ? \"default\" : \"outline\"}\n                  size=\"sm\"\n                  onClick={() => setRadius(r.value)}\n                  class=\"h-7 text-xs px-1 cursor-pointer\"\n                >\n                  {r.label}\n                </Button>\n              )}\n            </For>\n          </div>\n        </DropdownMenuContent>\n      </Show>\n    </DropdownMenu>\n  );\n};",
+      "type": "registry:ui"
+    }
+  ]
+}

package/src/index.css

@@ -0,0 +1,11 @@
+// src/index.css
+@import "tailwindcss";
+
+@theme {
+  --color-primary: #722f37;
+  --color-primary-hover: #4a1c21;
+  --color-surface: #1a1a1a;
+  --color-surface-light: #2a2a2a;
+  --color-text: #f5f5dc;
+  --color-text-muted: #a0a0a0;
+}

package/src/lib/cn.ts

@@ -0,0 +1,9 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+/**
+ * Combines multiple class names and resolves Tailwind CSS conflicts.
+ */
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/src/registry/components/ui/accordion.tsx

@@ -0,0 +1,128 @@
+import { splitProps, type JSX, type ValidComponent } from "solid-js";
+import * as AccordionPrimitive from "@kobalte/core/accordion";
+import type { PolymorphicProps } from "@kobalte/core/polymorphic";
+import { cn } from "@/lib/cn";
+
+export type AccordionRootProps<T extends ValidComponent = "div"> = Omit<
+  AccordionPrimitive.AccordionRootProps<T>,
+  "value" | "defaultValue"
+> & {
+  /** Accordion mode: "single" allows one open item, "multiple" allows many */
+  type?: "single" | "multiple";
+  /** Controlled value (single string or array of strings) */
+  value?: string | string[];
+  /** Default initial value (single string or array of strings) */
+  defaultValue?: string | string[];
+  class?: string;
+};
+
+/**
+ * Root Accordion component built on top of Kobalte headless primitives.
+ */
+export const Accordion = <T extends ValidComponent = "div">(
+  props: PolymorphicProps<T, AccordionRootProps<T>>
+) => {
+  const [local, rest] = splitProps(props as AccordionRootProps, [
+    "class",
+    "type",
+    "multiple",
+  ]);
+
+  // Support both `type="multiple"` and `multiple={true}`
+  const isMultiple = () => local.multiple ?? local.type === "multiple";
+
+  return (
+    <AccordionPrimitive.Root
+      multiple={isMultiple()}
+      class={cn("w-full divide-y divide-border", local.class)}
+      {...(rest as any)}
+    />
+  );
+};
+
+export type AccordionItemProps<T extends ValidComponent = "div"> =
+  AccordionPrimitive.AccordionItemProps<T> & {
+    class?: string;
+    value: string;
+  };
+
+/**
+ * Individual Accordion section item wrapper.
+ */
+export const AccordionItem = <T extends ValidComponent = "div">(
+  props: PolymorphicProps<T, AccordionItemProps<T>>
+) => {
+  const [local, rest] = splitProps(props as AccordionItemProps, ["class"]);
+
+  return (
+    <AccordionPrimitive.Item
+      class={cn("border-b border-border", local.class)}
+      {...rest}
+    />
+  );
+};
+
+export type AccordionTriggerProps<T extends ValidComponent = "button"> =
+  AccordionPrimitive.AccordionTriggerProps<T> & {
+    class?: string;
+    children?: JSX.Element;
+  };
+
+/**
+ * Header trigger button toggling the expansion of an AccordionItem.
+ */
+export const AccordionTrigger = <T extends ValidComponent = "button">(
+  props: PolymorphicProps<T, AccordionTriggerProps<T>>
+) => {
+  const [local, rest] = splitProps(props as AccordionTriggerProps, ["class", "children"]);
+
+  return (
+    <AccordionPrimitive.Header class="flex">
+      <AccordionPrimitive.Trigger
+        class={cn(
+          "flex flex-1 items-center justify-between py-4 text-sm font-medium transition-all hover:underline [&[data-expanded]>svg]:rotate-180 cursor-pointer text-foreground",
+          local.class
+        )}
+        {...rest}
+      >
+        {local.children}
+        <svg
+          class="h-4 w-4 shrink-0 text-muted-foreground transition-transform duration-200"
+          viewBox="0 0 24 24"
+          fill="none"
+          stroke="currentColor"
+          stroke-width="2"
+        >
+          <path stroke-linecap="round" stroke-linejoin="round" d="M19 9l-7 7-7-7" />
+        </svg>
+      </AccordionPrimitive.Trigger>
+    </AccordionPrimitive.Header>
+  );
+};
+
+export type AccordionContentProps<T extends ValidComponent = "div"> =
+  AccordionPrimitive.AccordionContentProps<T> & {
+    class?: string;
+    children?: JSX.Element;
+  };
+
+/**
+ * Collapsible content panel revealed when the associated AccordionItem is open.
+ */
+export const AccordionContent = <T extends ValidComponent = "div">(
+  props: PolymorphicProps<T, AccordionContentProps<T>>
+) => {
+  const [local, rest] = splitProps(props as AccordionContentProps, ["class", "children"]);
+
+  return (
+    <AccordionPrimitive.Content
+      class={cn(
+        "overflow-hidden text-sm text-muted-foreground transition-all",
+        local.class
+      )}
+      {...rest}
+    >
+      <div class="pb-4 pt-0">{local.children}</div>
+    </AccordionPrimitive.Content>
+  );
+};

package/src/registry/components/ui/alert.tsx

@@ -0,0 +1,155 @@
+import {
+  createSignal,
+  splitProps,
+  onMount,
+  onCleanup,
+  Show,
+  type Component,
+  type JSX,
+} from "solid-js";
+import { cva, type VariantProps } from "class-variance-authority";
+import { cn } from "@/lib/cn";
+
+/**
+ * CVA variants for Alert status styles and color themes.
+ */
+export const alertVariants = cva(
+  "relative w-full rounded-lg border p-4 transition-all duration-200 [&>svg~*]:pl-7 [&>svg+div]:translate-y-[-3px] [&>svg]:absolute [&>svg]:left-4 [&>svg]:top-4 [&>svg]:text-foreground",
+  {
+    variants: {
+      variant: {
+        default:
+          "bg-background text-foreground border-border",
+        info:
+          "bg-blue-50 text-blue-900 border-blue-200 dark:bg-blue-950/50 dark:text-blue-200 dark:border-blue-900/50",
+        success:
+          "bg-emerald-50 text-emerald-900 border-emerald-200 dark:bg-emerald-950/50 dark:text-emerald-200 dark:border-emerald-900/50",
+        warning:
+          "bg-amber-50 text-amber-900 border-amber-200 dark:bg-amber-950/50 dark:text-amber-200 dark:border-amber-950/50",
+        destructive:
+          "bg-destructive/15 text-destructive border-destructive/30",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  }
+);
+
+export interface AlertProps
+  extends JSX.HTMLAttributes<HTMLDivElement>,
+    VariantProps<typeof alertVariants> {
+  /** Display an interactive close (X) button */
+  closable?: boolean;
+  /** Auto-dismiss timer duration in milliseconds */
+  duration?: number;
+  /** Callback fired when the alert is dismissed */
+  onClose?: () => void;
+  class?: string;
+}
+
+/**
+ * Nikala UI Alert notification banner with auto-dismiss timer and theme variants.
+ */
+export const Alert: Component<AlertProps> = (props) => {
+  const [local, rest] = splitProps(props, [
+    "variant",
+    "closable",
+    "duration",
+    "onClose",
+    "class",
+    "children",
+  ]);
+
+  const [isVisible, setIsVisible] = createSignal(true);
+  let timer: ReturnType<typeof setTimeout> | undefined;
+
+  const handleClose = () => {
+    setIsVisible(false);
+    if (typeof local.onClose === "function") {
+      local.onClose();
+    }
+  };
+
+  onMount(() => {
+    if (local.duration && local.duration > 0) {
+      timer = setTimeout(() => {
+        handleClose();
+      }, local.duration);
+    }
+  });
+
+  onCleanup(() => {
+    if (timer) clearTimeout(timer);
+  });
+
+  return (
+    <Show when={isVisible()}>
+      <div
+        role="alert"
+        class={cn(
+          alertVariants({ variant: local.variant }),
+          "animate-in fade-in-0 duration-200",
+          local.class
+        )}
+        {...rest}
+      >
+        {local.children}
+        <Show when={local.closable || typeof local.onClose === "function"}>
+          <button
+            type="button"
+            aria-label="Close alert"
+            onClick={handleClose}
+            class="absolute right-3 top-3 rounded-md p-1 text-zinc-500 hover:bg-zinc-100 hover:text-zinc-900 dark:text-zinc-400 dark:hover:bg-zinc-800 dark:hover:text-zinc-50 transition-colors cursor-pointer"
+          >
+            <svg
+              class="h-4 w-4"
+              viewBox="0 0 24 24"
+              fill="none"
+              stroke="currentColor"
+              stroke-width="2"
+            >
+              <path stroke-linecap="round" stroke-linejoin="round" d="M6 18L18 6M6 6l12 12" />
+            </svg>
+          </button>
+        </Show>
+      </div>
+    </Show>
+  );
+};
+
+export interface AlertTitleProps extends JSX.HTMLAttributes<HTMLHeadingElement> {
+  class?: string;
+}
+
+/**
+ * Header title element for the Alert banner.
+ */
+export const AlertTitle: Component<AlertTitleProps> = (props) => {
+  const [local, rest] = splitProps(props, ["class"]);
+
+  return (
+    <h5
+      class={cn("mb-1 font-medium leading-none tracking-tight text-foreground", local.class)}
+      {...rest}
+    />
+  );
+};
+
+export interface AlertDescriptionProps extends JSX.HTMLAttributes<HTMLDivElement> {
+  class?: string;
+}
+
+/**
+ * Body text content for the Alert banner.
+ */
+export const AlertDescription: Component<AlertDescriptionProps> = (props) => {
+  const [local, rest] = splitProps(props, ["class"]);
+
+  return (
+    <div
+      class={cn("text-sm [&_p]:leading-relaxed text-muted-foreground", local.class)}
+      {...rest}
+    />
+  );
+};

package/src/registry/components/ui/avatar.tsx

@@ -0,0 +1,114 @@
+import {
+  createSignal,
+  createEffect,
+  Show,
+  splitProps,
+  type Component,
+  type JSX,
+} from "solid-js";
+import { cn } from "@/lib/cn";
+
+export interface AvatarProps extends JSX.HTMLAttributes<HTMLDivElement> {
+  class?: string;
+}
+
+/**
+ * Root Avatar container component.
+ */
+export const Avatar: Component<AvatarProps> = (props) => {
+  const [local, rest] = splitProps(props, ["class"]);
+
+  return (
+    <div
+      class={cn(
+        "relative flex h-10 w-10 shrink-0 overflow-hidden rounded-full border border-border bg-muted",
+        local.class
+      )}
+      {...rest}
+    />
+  );
+};
+
+export interface AvatarImageProps
+  extends JSX.ImgHTMLAttributes<HTMLImageElement> {
+  class?: string;
+}
+
+/**
+ * Image element for the Avatar component with background status loader.
+ */
+export const AvatarImage: Component<AvatarImageProps> = (props) => {
+  const [local, rest] = splitProps(props, [
+    "class",
+    "src",
+    "alt",
+    "onLoad",
+    "onError",
+  ]);
+  const [status, setStatus] = createSignal<"loading" | "loaded" | "error">(
+    "loading"
+  );
+
+  /* Pre-test image loading in background JS to prevent native broken icon flashes */
+  createEffect(() => {
+    const src = local.src;
+    if (!src) {
+      setStatus("error");
+      return;
+    }
+
+    const img = new Image();
+    img.src = src;
+    img.onload = () => setStatus("loaded");
+    img.onerror = () => setStatus("error");
+  });
+
+  const handleLoad: JSX.EventHandlerUnion<HTMLImageElement, Event> = (e) => {
+    setStatus("loaded");
+    if (typeof local.onLoad === "function") {
+      (local.onLoad as (e: Event) => void)(e);
+    }
+  };
+
+  const handleError: JSX.EventHandlerUnion<HTMLImageElement, Event> = (e) => {
+    setStatus("error");
+    if (typeof local.onError === "function") {
+      (local.onError as (e: Event) => void)(e);
+    }
+  };
+
+  return (
+    <Show when={status() === "loaded"}>
+      <img
+        src={local.src}
+        alt={local.alt}
+        class={cn("aspect-square h-full w-full object-cover", local.class)}
+        onLoad={handleLoad}
+        onError={handleError}
+        {...rest}
+      />
+    </Show>
+  );
+};
+
+export interface AvatarFallbackProps
+  extends JSX.HTMLAttributes<HTMLDivElement> {
+  class?: string;
+}
+
+/**
+ * Fallback container for rendering initials or icons when avatar image is missing/broken.
+ */
+export const AvatarFallback: Component<AvatarFallbackProps> = (props) => {
+  const [local, rest] = splitProps(props, ["class"]);
+
+  return (
+    <div
+      class={cn(
+        "flex h-full w-full items-center justify-center bg-muted text-sm font-medium text-muted-foreground select-none",
+        local.class
+      )}
+      {...rest}
+    />
+  );
+};

package/src/registry/components/ui/badge.tsx

@@ -0,0 +1,50 @@
+import { splitProps, type Component, type JSX } from "solid-js";
+import { cva, type VariantProps } from "class-variance-authority";
+import { cn } from "@/lib/cn";
+
+/**
+ * Class variance authority configuration for badge styling variants.
+ */
+export const badgeVariants = cva(
+  "inline-flex items-center rounded-md border px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2",
+  {
+    variants: {
+      variant: {
+        default:
+          "border-transparent bg-primary text-primary-foreground shadow hover:bg-primary/80",
+        secondary:
+          "border-transparent bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        destructive:
+          "border-transparent bg-destructive text-destructive-foreground shadow hover:bg-destructive/80",
+        outline:
+          "text-foreground border-border",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  }
+);
+
+/**
+ * Props interface for the Badge component extending standard HTML div attributes.
+ */
+export interface BadgeProps
+  extends JSX.HTMLAttributes<HTMLDivElement>,
+    VariantProps<typeof badgeVariants> {
+  class?: string;
+}
+
+/**
+ * Nikala UI Badge component built for SolidJS with Tailwind CSS v4 styling.
+ */
+export const Badge: Component<BadgeProps> = (props) => {
+  // Use splitProps to preserve SolidJS reactivity
+  const [local, rest] = splitProps(props, ["variant", "class", "children"]);
+
+  return (
+    <div class={cn(badgeVariants({ variant: local.variant }), local.class)} {...rest}>
+      {local.children}
+    </div>
+  );
+};