shadcn-app-dock 0.1.0

package/dist/lib/utils.d.ts

@@ -0,0 +1,2 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/shadcn-app-dock-context.d.ts

@@ -0,0 +1,19 @@
+import { type ReactNode } from "react";
+interface CategoryState {
+    currentCategory: any;
+    onCategoryChange: (category: any) => void;
+}
+export declare function CategoryDockProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Hook for pages to register their category state into the global dock.
+ * Call from a page to add category items to the shared dock.
+ */
+export declare function useCategoryDock(currentCategory: any, onCategoryChange: (category: any) => void): void;
+export declare function useCategoryDockState(): CategoryState | null;
+export declare function useCategoryDockVisibility(): {
+    dockHidden: boolean;
+    toggleDock: () => void;
+};
+export {};

package/dist/shadcn-app-dock.d.ts

@@ -0,0 +1,37 @@
+import { type ReactNode } from "react";
+export interface CategoryDockMenu {
+    /** Trigger icon — string src (via `renderImage`) or a node. Falls back to the item's own icon when used inline. */
+    triggerIcon?: ReactNode | string;
+    triggerLabel?: string;
+    contentClassName?: string;
+    /** Full control over the dropdown body. Compose `<ThemeMenu />` here for the theme switcher. */
+    renderContent: (ctx: {
+        side: "top" | "bottom";
+        close: () => void;
+    }) => ReactNode;
+}
+export interface DockNavItem {
+    /** Stable identity for the item (also used for React keys). */
+    key: string;
+    label: string;
+    /** A string is treated as an image src (rendered via `renderImage`); a node is rendered as-is. */
+    icon: ReactNode | string;
+    active?: boolean;
+    onClick?: () => void;
+    /** Optional inline dropdown menu. When set, the item renders as a dropdown trigger instead of a nav button. */
+    menu?: CategoryDockMenu;
+}
+export interface CategoryDockProps {
+    items: DockNavItem[];
+    /** Renders string icons. Defaults to a plain `<img>`; pass next/image for Next apps. */
+    renderImage?: (src: string, alt: string, size: number) => ReactNode;
+    /** Alt+1..n triggers the matching item's `onClick`. Default false. */
+    enableKeyboardShortcuts?: boolean;
+    className?: string;
+    /** Which fixed placements to render. Defaults to both. */
+    placements?: {
+        desktop?: boolean;
+        mobile?: boolean;
+    };
+}
+export declare function CategoryDock({ items, renderImage, enableKeyboardShortcuts, className, placements, }: CategoryDockProps): import("react").JSX.Element;

package/dist/theme-menu.d.ts

@@ -0,0 +1,15 @@
+export interface ThemeMenuProps {
+    /** Show the light/dark/system appearance toggle above the color themes. Default true. */
+    showAppearance?: boolean;
+    /** Default color theme applied when nothing is persisted. Default "modern-minimal". */
+    defaultColorTheme?: string;
+}
+/**
+ * Composable shadcn theme switcher rendered as a fragment of dropdown items.
+ * Drop it inside any `DropdownMenuContent` (e.g. via `CategoryDock`'s menu render prop).
+ *
+ * Handles the light/dark/system appearance toggle (via next-themes) and the shadcn
+ * color-theme picker with hover preview, persisting the selection to localStorage and a
+ * cookie and toggling the `theme-<name>` class on the document element.
+ */
+export declare function ThemeMenu({ showAppearance, defaultColorTheme, }?: ThemeMenuProps): import("react").JSX.Element;

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "shadcn-app-dock",
+  "description": "Prop-driven macOS-style category dock with magnification, a custom dropdown menu, and a built-in shadcn theme switcher",
+  "version": "0.1.0",
+  "author": "vtempest",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OpenSourceAGI/qwksearch-research-agent.git",
+    "directory": "packages/shadcn-app-dock"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "vite build && tsc --project tsconfig.build.json",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "dock",
+    "macos-dock",
+    "navigation",
+    "shadcn",
+    "theme-switcher",
+    "react"
+  ],
+  "peerDependencies": {
+    "next-themes": ">=0.3",
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "@radix-ui/react-dropdown-menu": "^2.1.17",
+    "@radix-ui/react-slot": "^1.2.5",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "framer-motion": "^12.40.0",
+    "lucide-react": "^1.17.0",
+    "shadcn-theme-menu": "^1.1.13",
+    "tailwind-merge": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^6.0.3",
+    "next-themes": "^0.4.6",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "typescript": "^5.7.2",
+    "vite": "^8.1.3"
+  }
+}