aura-omni-search 3.0.0

package/README.md

@@ -0,0 +1,72 @@
+# aura-omni-search 🔍 (v3.0.0)
+
+A professional, **Tailwind-Native** Spotlight Search component for React and Next.js. Engineered to blend perfectly into your existing design system without shipping any global CSS resets or side effects.
+
+## 🏛 Architecture (v3.0.0)
+
+Version 3 is "Tailwind-Native". Instead of shipping a giant, compiled CSS file with internal resets, this library uses standard Tailwind classes that are compiled by **YOUR** application's Tailwind build.
+
+### Key Benefits:
+
+- **Zero Style Leaks**: No bundled resets. Your `body`, `button`, and `h1` styles remain yours.
+- **Microscopic Bundle Size**: Only ships the logic. Your Tailwind build handles the styles.
+- **Perfect Design Parity**: Inherits your fonts, colors, and layout rules natively.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install aura-omni-search
+```
+
+## 🛠 Integration (Required)
+
+Because v3 uses standard Tailwind classes, you **must** tell Tailwind to scan the library for styles.
+
+### 1. Update `tailwind.config.js`
+
+Add the library path to your `content` array:
+
+```javascript
+/** @type {import('tailwindcss').Config} */
+export default {
+  content: [
+    "./index.html",
+    "./src/**/*.{js,ts,jsx,tsx}",
+    "./node_modules/aura-omni-search/**/*.{js,ts,jsx,tsx}", // <--- ADD THIS
+  ],
+  // ...
+};
+```
+
+### 2. (Optional) Import Default Variables
+
+If you want to use our default colors, import the minimal variable sheet in your `layout.tsx` or `index.css`:
+
+```tsx
+import "aura-omni-search/dist/style.css";
+```
+
+---
+
+## 🌓 Customization
+
+Since we use standard Tailwind, you can customize the theme using CSS variables in your global CSS:
+
+```css
+:root {
+  --spotlight-primary: #3b82f6;
+  --spotlight-background: #ffffff;
+}
+
+.dark {
+  --spotlight-background: #0f172a;
+}
+```
+
+---
+
+## 📄 License
+
+MIT © Dhruv

package/dist/Spotlight.d.ts

@@ -0,0 +1,2 @@
+import { SpotlightProps } from './types';
+export declare function Spotlight({ isOpen, onClose, items, onNavigate, searchPlaceholder, }: SpotlightProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/adapters/routes.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode } from "react";
+import { SpotlightItem } from "../types";
+export interface RouteConfig {
+    path: string;
+    label?: string;
+    name?: string;
+    title?: string;
+    icon?: ReactNode;
+    children?: RouteConfig[];
+    [key: string]: unknown;
+}
+/**
+ * Recursively extracts spotlight items from a route configuration.
+ * @param routes The list of routes to traverse.
+ * @param baseUrl The base URL for the current level (used for recursion).
+ * @param parentGroup The group name to assign (defaults to "Pages").
+ */
+export declare function getSpotlightItemsFromRoutes(routes: RouteConfig[], baseUrl?: string, parentGroup?: string): SpotlightItem[];

package/dist/adapters/useReactRouterItems.d.ts

@@ -0,0 +1,8 @@
+import { RouteObject } from "react-router-dom";
+import { SpotlightItem } from "../types";
+/**
+ * Recursively extracts spotlight items from route configuration
+ * @param routes The React Router route definitions
+ * @param parentPath The path accumulator for recursion
+ */
+export declare function getSpotlightItemsFromRoutes(routes: RouteObject[], parentPath?: string): SpotlightItem[];

package/dist/aura-omni-search.css

@@ -0,0 +1 @@
+:root{--spotlight-background: #ffffff;--spotlight-foreground: #020817;--spotlight-muted: #f1f5f9;--spotlight-muted-foreground: #64748b;--spotlight-popover: #ffffff;--spotlight-border: #e2e8f0;--spotlight-accent: #f1f5f9;--spotlight-accent-foreground: #0f172a;--spotlight-ring: #94a3b8;--spotlight-primary: #0f172a}.dark{--spotlight-background: #020817;--spotlight-foreground: #f8fafc;--spotlight-muted: #1e293b;--spotlight-muted-foreground: #94a3b8;--spotlight-popover: #020817;--spotlight-border: #1e293b;--spotlight-accent: #1e293b;--spotlight-accent-foreground: #f8fafc;--spotlight-ring: #1e293b;--spotlight-primary: #f8fafc}@media(prefers-color-scheme:dark){:root:not(.light){--spotlight-background: #020817;--spotlight-foreground: #f8fafc;--spotlight-muted: #1e293b;--spotlight-muted-foreground: #94a3b8;--spotlight-popover: #020817;--spotlight-border: #1e293b;--spotlight-accent: #1e293b;--spotlight-accent-foreground: #f8fafc;--spotlight-ring: #1e293b;--spotlight-primary: #f8fafc}}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import "./index.css";
+export * from "./types";
+export * from "./Spotlight";
+export * from "./adapters/routes";