najm-kit 0.0.7

package/README.md

@@ -0,0 +1,70 @@
+# najm-kit
+
+Reusable React component library for Najm applications. Provides themed UI primitives, hooks, and form components.
+
+## Install
+
+```bash
+bun add najm-kit
+```
+
+Peer dependencies: `react >=18`, `react-dom >=18`.
+
+Optional peer dependencies: `recharts`, `@tanstack/react-table`, `react-hook-form`, `@tanstack/react-query`.
+
+## Theme Provider
+
+```tsx
+import { NajmThemeProvider } from 'najm-kit';
+
+function App() {
+  return (
+    <NajmThemeProvider appearance={{ mode: 'light', accent: 'indigo' }}>
+      {children}
+    </NajmThemeProvider>
+  );
+}
+```
+
+## Components
+
+Import from `najm-kit`:
+
+```tsx
+import { NButton, buttonVariants } from 'najm-kit';
+import { Input } from 'najm-kit';
+import { Card, CardHeader, CardTitle, CardContent } from 'najm-kit';
+import { Dialog, DialogContent, DialogTrigger } from 'najm-kit';
+import { DataTable } from 'najm-kit';
+import { Form, FormInput, useNForm } from 'najm-kit';
+```
+
+### Available Primitives
+
+| Category | Components |
+|----------|-----------|
+| Actions | NButton, IconButton, toggleVariants |
+| Forms | Input, Textarea, Label, Select, Checkbox, RadioGroup, Switch, DateInput, FileInput |
+| Feedback | Alert, Badge, Progress, Spinner, Toast |
+| Layout | Card, Sheet, Dialog, Popover, DropdownMenu, Tabs |
+| Data | Table (NTable), StatCard, DetailList |
+| Overlays | Command palette, Tooltip, Toast |
+
+## Hooks
+
+```tsx
+import { useKeyboard } from 'najm-kit';
+import { useDelayedLoading } from 'najm-kit';
+import { useClickOutside } from 'najm-kit';
+import { useDebouncedValue } from 'najm-kit';
+import { useInfiniteScroll } from 'najm-kit';
+import { useSelection } from 'najm-kit';
+```
+
+## Production Notes
+
+- Designed for dashboard/admin UIs in Najm-powered applications
+- Uses Radix UI primitives under the hood — accessible by default
+- All components are unstyled by default — apply `buttonVariants()`, `badgeVariants()`, etc. with Tailwind
+- Requires Tailwind CSS in the host application
+- CodeMirror components are optional peer deps — import from `najm-kit/json` only if needed

package/dist/NTableJson-tXqgfZI1.d.ts

@@ -0,0 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function NTableJson(): react_jsx_runtime.JSX.Element;
+
+export { NTableJson as N };

package/dist/adapters/next.d.ts

@@ -0,0 +1,20 @@
+import React__default from 'react';
+
+interface NextLinkAdapterProps extends Record<string, any> {
+    href: string;
+    children: React__default.ReactNode;
+    className?: string;
+    [key: string]: any;
+}
+declare function NextLinkAdapter({ children, ...props }: NextLinkAdapterProps): React__default.DetailedReactHTMLElement<{
+    [key: string]: any;
+    href: string;
+    className?: string;
+}, HTMLElement>;
+declare function useNextNavigationAdapter(): {
+    pathname: string;
+    push: (path: string) => void;
+    replace: (path: string) => void;
+};
+
+export { NextLinkAdapter, type NextLinkAdapterProps, useNextNavigationAdapter };

package/dist/adapters/next.mjs

@@ -0,0 +1,23 @@
+import React from 'react';
+
+// src/adapters/next.tsx
+function NextLinkAdapter({ children, ...props }) {
+  return React.createElement("a", props, children);
+}
+function useNextNavigationAdapter() {
+  return {
+    pathname: typeof window !== "undefined" ? window.location.pathname : "",
+    push: (path) => {
+      if (typeof window !== "undefined") {
+        window.history.pushState(null, "", path);
+      }
+    },
+    replace: (path) => {
+      if (typeof window !== "undefined") {
+        window.history.replaceState(null, "", path);
+      }
+    }
+  };
+}
+
+export { NextLinkAdapter, useNextNavigationAdapter };