randmarcomps 1.0.0

package/README.md

@@ -0,0 +1,92 @@
+# randmarcomps
+
+A simple TypeScript React component library with Tailwind CSS v4 styling.
+
+## Installation
+
+```bash
+npm install randmarcomps
+```
+
+## Requirements
+
+This component library requires the following dependencies:
+
+### Tailwind CSS v4
+
+```bash
+npm install tailwindcss@^4.0.0
+```
+
+For Tailwind CSS v4, you need to add a source directive to your CSS file to include the styles from randmarcomps:
+
+```css
+/* In your main CSS file (e.g., src/index.css) */
+@import 'tailwindcss';
+@source "../node_modules/randmarcomps/dist";
+
+/* Rest of your CSS */
+```
+
+This directive tells Tailwind to process the components from randmarcomps when generating your CSS.
+
+If you're using a different path structure, adjust the path accordingly. The path should be relative to your CSS file.
+
+### React Router
+
+Several components (like Navbar and Topbar) require React Router:
+
+```bash
+npm install react-router-dom@^7.3.0
+```
+
+Components that use React Router include:
+- Navbar (uses useParams, Link)
+- Topbar (uses useNavigate, useParams)
+
+## Usage
+
+Import the components directly:
+
+```tsx
+import {
+  InputOTP,
+  InputOTPGroup,
+  InputOTPSeparator,
+  InputOTPSlot,
+} from 'randmarcomps';
+
+function App() {
+  return (
+    <InputOTP maxLength={6}>
+      <InputOTPGroup>
+        <InputOTPSlot index={0} />
+        <InputOTPSlot index={1} />
+        <InputOTPSlot index={2} />
+      </InputOTPGroup>
+      <InputOTPSeparator />
+      <InputOTPGroup>
+        <InputOTPSlot index={3} />
+        <InputOTPSlot index={4} />
+        <InputOTPSlot index={5} />
+      </InputOTPGroup>
+    </InputOTP>);
+}
+```
+
+## Compatibility
+
+This library is designed to work with:
+- React 19
+- React Router 7
+- Tailwind CSS v4
+
+If you're using earlier versions, you may encounter compatibility issues:
+- Tailwind v3: You may encounter styling issues due to differences in the CSS layer system
+- React Router <7: The API may have changed between versions
+
+## Development
+
+- `npm run dev` - Start development server
+- `npm run build` - Build the library
+- `npm run lint` - Lint the code

package/dist/randmarcomps.d.ts

@@ -0,0 +1,304 @@
+import { ButtonProps as ButtonProps_2 } from './button';
+import { ClassProp } from 'class-variance-authority/types';
+import { JSX } from 'react/jsx-runtime';
+import { OTPInput } from 'input-otp';
+import * as React_2 from 'react';
+import * as SeparatorPrimitive from '@radix-ui/react-separator';
+import { SeparatorProps } from '@radix-ui/react-separator';
+import * as SheetPrimitive from '@radix-ui/react-dialog';
+import * as ToastPrimitives from '@radix-ui/react-toast';
+import * as TooltipPrimitive from '@radix-ui/react-tooltip';
+import { VariantProps } from 'class-variance-authority';
+
+export declare const Button: React_2.ForwardRefExoticComponent<ButtonProps & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare interface ButtonProps extends React_2.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    asChild?: boolean;
+}
+
+export declare const buttonVariants: (props?: ({
+    variant?: "link" | "default" | "none" | "destructive" | "outline" | "defaultOutline" | "secondary" | "ghost" | "blue" | "red" | null | undefined;
+    size?: "default" | "sm" | "lg" | "icon" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Input: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & React_2.RefAttributes<HTMLInputElement>>;
+
+export declare function InputOTP({ className, containerClassName, ...props }: React_2.ComponentProps<typeof OTPInput> & {
+    containerClassName?: string;
+}): JSX.Element;
+
+export declare function InputOTPGroup({ className, ...props }: React_2.ComponentProps<"div">): JSX.Element;
+
+export declare function InputOTPSeparator({ ...props }: React_2.ComponentProps<"div">): JSX.Element;
+
+export declare function InputOTPSlot({ index, className, ...props }: React_2.ComponentProps<"div"> & {
+    index: number;
+}): JSX.Element;
+
+export declare function Layout({ children, routes, searchResultsRouteName, getMyAccountPath, accountData, applicationName, dashboardTitle, onSignOut, }: LayoutProps): JSX.Element;
+
+/**
+ * Props for the Layout component
+ */
+declare interface LayoutProps {
+    /**
+     * Child components to render within the layout
+     */
+    children: React.ReactNode;
+    /**
+     * Array of application routes for navigation
+     */
+    routes: NavRoute[];
+    /**
+     * Route name for search results page
+     * @default "search"
+     */
+    searchResultsRouteName?: string;
+    /**
+     * Function to get the path to the account page for a given appID
+     */
+    getMyAccountPath: (appId: string) => string;
+    /**
+     * Account data containing partner information
+     */
+    accountData?: {
+        PublicName?: string;
+    };
+    /**
+     * Application name from the user profile
+     */
+    applicationName?: string;
+    /**
+     * Title to display in the dashboard header
+     * @default "Partner Dashboard"
+     */
+    dashboardTitle?: string;
+    /**
+     * Function to handle sign out action
+     */
+    onSignOut: () => void;
+}
+
+export declare function Navbar({ routes, getMyAccountPath, publicName, applicationName, dashboardTitle }: NavbarProps): JSX.Element;
+
+declare interface NavbarProps {
+    /**
+     * Array of application routes to display in the navigation
+     */
+    routes: NavRoute[];
+    /**
+     * Function to get the path to the account page for a given appID
+     */
+    getMyAccountPath: (appId: string) => string;
+    /**
+     * Public name of the partner
+     */
+    publicName?: string;
+    /**
+     * Application name from the user profile
+     */
+    applicationName?: string;
+    /**
+     * Title to display in the dashboard header
+     * @default "Partner Dashboard"
+     */
+    dashboardTitle?: string;
+}
+
+/**
+ * Minimal interface for route configuration needed by the navbar
+ */
+export declare interface NavRoute {
+    key: string;
+    path: string;
+    label?: string;
+    icon?: React.ComponentType<React.SVGProps<SVGSVGElement>>;
+    showInNav?: boolean;
+}
+
+export declare const Separator: React_2.ForwardRefExoticComponent<Omit<SeparatorPrimitive.SeparatorProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const Sheet: React_2.FC<SheetPrimitive.DialogProps>;
+
+export declare const SheetClose: React_2.ForwardRefExoticComponent<SheetPrimitive.DialogCloseProps & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare const SheetContent: React_2.ForwardRefExoticComponent<SheetContentProps & React_2.RefAttributes<HTMLDivElement>>;
+
+declare interface SheetContentProps extends React_2.ComponentPropsWithoutRef<typeof SheetPrimitive.Content>, VariantProps<typeof sheetVariants> {
+}
+
+export declare const SheetDescription: React_2.ForwardRefExoticComponent<Omit<SheetPrimitive.DialogDescriptionProps & React_2.RefAttributes<HTMLParagraphElement>, "ref"> & React_2.RefAttributes<HTMLParagraphElement>>;
+
+export declare const SheetFooter: {
+    ({ className, ...props }: React_2.HTMLAttributes<HTMLDivElement>): JSX.Element;
+    displayName: string;
+};
+
+export declare const SheetHeader: {
+    ({ className, ...props }: React_2.HTMLAttributes<HTMLDivElement>): JSX.Element;
+    displayName: string;
+};
+
+export declare const SheetOverlay: React_2.ForwardRefExoticComponent<Omit<SheetPrimitive.DialogOverlayProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SheetPortal: React_2.FC<SheetPrimitive.DialogPortalProps>;
+
+export declare const SheetTitle: React_2.ForwardRefExoticComponent<Omit<SheetPrimitive.DialogTitleProps & React_2.RefAttributes<HTMLHeadingElement>, "ref"> & React_2.RefAttributes<HTMLHeadingElement>>;
+
+export declare const SheetTrigger: React_2.ForwardRefExoticComponent<SheetPrimitive.DialogTriggerProps & React_2.RefAttributes<HTMLButtonElement>>;
+
+declare const sheetVariants: (props?: ({
+    side?: "top" | "bottom" | "left" | "right" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Sidebar: React_2.ForwardRefExoticComponent<Omit<React_2.ClassAttributes<HTMLDivElement> & React_2.HTMLAttributes<HTMLDivElement> & {
+    side?: "left" | "right";
+    variant?: "sidebar" | "floating" | "inset";
+    collapsible?: "offcanvas" | "icon" | "none";
+}, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SidebarContent: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+declare type SidebarContext = {
+    state: "expanded" | "collapsed";
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    openMobile: boolean;
+    setOpenMobile: (open: boolean) => void;
+    isMobile: boolean;
+    toggleSidebar: () => void;
+};
+
+declare const SidebarContext: React_2.Context<SidebarContext | null>;
+
+export declare const SidebarFooter: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SidebarGroup: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SidebarGroupAction: React_2.ForwardRefExoticComponent<Omit<React_2.ClassAttributes<HTMLButtonElement> & React_2.ButtonHTMLAttributes<HTMLButtonElement> & {
+    asChild?: boolean;
+}, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare const SidebarGroupContent: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SidebarGroupLabel: React_2.ForwardRefExoticComponent<Omit<React_2.ClassAttributes<HTMLDivElement> & React_2.HTMLAttributes<HTMLDivElement> & {
+    asChild?: boolean;
+}, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SidebarHeader: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SidebarInput: React_2.ForwardRefExoticComponent<Omit<Omit<React_2.DetailedHTMLProps<React_2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & React_2.RefAttributes<HTMLInputElement>, "ref"> & React_2.RefAttributes<HTMLInputElement>>;
+
+export declare const SidebarInset: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SidebarMenu: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.HTMLAttributes<HTMLUListElement>, HTMLUListElement>, "ref"> & React_2.RefAttributes<HTMLUListElement>>;
+
+export declare const SidebarMenuAction: React_2.ForwardRefExoticComponent<Omit<React_2.ClassAttributes<HTMLButtonElement> & React_2.ButtonHTMLAttributes<HTMLButtonElement> & {
+    asChild?: boolean;
+    showOnHover?: boolean;
+}, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare const SidebarMenuBadge: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SidebarMenuButton: React_2.ForwardRefExoticComponent<Omit<React_2.ClassAttributes<HTMLButtonElement> & React_2.ButtonHTMLAttributes<HTMLButtonElement> & {
+    asChild?: boolean;
+    isActive?: boolean;
+    tooltip?: string | React_2.ComponentProps<typeof TooltipContent>;
+} & VariantProps<(props?: ({
+    variant?: "default" | "outline" | null | undefined;
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string>, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare const SidebarMenuItem: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & React_2.RefAttributes<HTMLLIElement>>;
+
+export declare const SidebarMenuSkeleton: React_2.ForwardRefExoticComponent<Omit<React_2.ClassAttributes<HTMLDivElement> & React_2.HTMLAttributes<HTMLDivElement> & {
+    showIcon?: boolean;
+}, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SidebarMenuSub: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.HTMLAttributes<HTMLUListElement>, HTMLUListElement>, "ref"> & React_2.RefAttributes<HTMLUListElement>>;
+
+export declare const SidebarMenuSubButton: React_2.ForwardRefExoticComponent<Omit<React_2.ClassAttributes<HTMLAnchorElement> & React_2.AnchorHTMLAttributes<HTMLAnchorElement> & {
+    asChild?: boolean;
+    size?: "sm" | "md";
+    isActive?: boolean;
+}, "ref"> & React_2.RefAttributes<HTMLAnchorElement>>;
+
+export declare const SidebarMenuSubItem: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & React_2.RefAttributes<HTMLLIElement>>;
+
+export declare const SidebarProvider: React_2.ForwardRefExoticComponent<Omit<React_2.ClassAttributes<HTMLDivElement> & React_2.HTMLAttributes<HTMLDivElement> & {
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SidebarRail: React_2.ForwardRefExoticComponent<Omit<React_2.DetailedHTMLProps<React_2.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare const SidebarSeparator: React_2.ForwardRefExoticComponent<Omit<Omit<SeparatorProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const SidebarTrigger: React_2.ForwardRefExoticComponent<Omit<ButtonProps_2 & React_2.RefAttributes<HTMLButtonElement>, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare function Skeleton({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): JSX.Element;
+
+export declare const Toast: React_2.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastProps & React_2.RefAttributes<HTMLLIElement>, "ref"> & VariantProps<(props?: ({
+    variant?: "default" | "destructive" | "outline" | "secondary" | "success" | "warning" | "info" | null | undefined;
+} & ClassProp) | undefined) => string> & React_2.RefAttributes<HTMLLIElement>>;
+
+export declare function toast({ ...props }: Toast_2): {
+    id: string;
+    dismiss: () => void;
+    update: (props: ToasterToast) => void;
+};
+
+declare type Toast_2 = Omit<ToasterToast, "id">;
+
+export declare const ToastAction: React_2.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastActionProps & React_2.RefAttributes<HTMLButtonElement>, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare type ToastActionElement = React_2.ReactElement<typeof ToastAction>;
+
+export declare const ToastClose: React_2.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastCloseProps & React_2.RefAttributes<HTMLButtonElement>, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare const ToastDescription: React_2.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastDescriptionProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare function Toaster(): JSX.Element;
+
+declare type ToasterToast = ToastProps & {
+    id: string;
+    title?: React_2.ReactNode;
+    description?: React_2.ReactNode;
+    action?: ToastActionElement;
+};
+
+export declare type ToastProps = React_2.ComponentPropsWithoutRef<typeof Toast>;
+
+export declare const ToastProvider: React_2.FC<ToastPrimitives.ToastProviderProps>;
+
+export declare const ToastTitle: React_2.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastTitleProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const ToastViewport: React_2.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastViewportProps & React_2.RefAttributes<HTMLOListElement>, "ref"> & React_2.RefAttributes<HTMLOListElement>>;
+
+export declare const Tooltip: React_2.FC<TooltipPrimitive.TooltipProps>;
+
+export declare const TooltipContent: React_2.ForwardRefExoticComponent<Omit<TooltipPrimitive.TooltipContentProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare const TooltipProvider: React_2.FC<TooltipPrimitive.TooltipProviderProps>;
+
+export declare const TooltipTrigger: React_2.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare function Topbar({ onSignOut, searchResultsRouteName }: TopbarProps): JSX.Element;
+
+declare interface TopbarProps {
+    onSignOut: () => void;
+    searchResultsRouteName: string;
+}
+
+export declare function useIsMobile(): boolean;
+
+export declare function useSidebar(): SidebarContext;
+
+export declare function useToast(): {
+    toast: typeof toast;
+    dismiss: (toastId?: string) => void;
+    toasts: ToasterToast[];
+};
+
+export { }