@instincthub/react-ui 0.1.4 → 0.1.5

package/dist/src/types/components/ui/Badge.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-export type BadgeVariant = "default" | "primary" | "success" | "warning" | "danger" | "info";
+export type BadgeVariant = "default" | "primary" | "secondary" | "success" | "warning" | "danger" | "info";
 export type BadgeSize = "small" | "medium" | "large";
 export type BadgeShape = "rounded" | "pill" | "square";
 export interface BadgeProps {
@@ -7,9 +7,13 @@ export interface BadgeProps {
      * The content to display inside the badge
      */
     children?: React.ReactNode;
+    /**
+     * Text content to display (alias for children)
+     */
+    text?: string;
     /**
      * The visual style variant of the badge
-     * @default 'default'
+     * @default 'default | default primary | success | warning | danger | info'
      */
     variant?: BadgeVariant;
     /**
@@ -60,3 +64,58 @@ export interface BadgeProps {
  */
 declare const Badge: React.FC<BadgeProps>;
 export default Badge;
+/**
+ * @example
+ * // Basic usage
+ * <Badge>New</Badge>
+ *
+ * @example
+ * // Different variants
+ * <Badge variant="primary">Primary</Badge>
+ * <Badge variant="success">Success</Badge>
+ * <Badge variant="warning">Warning</Badge>
+ * <Badge variant="danger">Danger</Badge>
+ * <Badge variant="info">Info</Badge>
+ *
+ * @example
+ * // Different sizes
+ * <Badge size="small">Small</Badge>
+ * <Badge size="medium">Medium</Badge>
+ * <Badge size="large">Large</Badge>
+ *
+ * @example
+ * // Different shapes
+ * <Badge shape="rounded">Rounded</Badge>
+ * <Badge shape="pill">Pill</Badge>
+ * <Badge shape="square">Square</Badge>
+ *
+ * @example
+ * // Outlined style
+ * <Badge variant="primary" outlined>Outlined</Badge>
+ *
+ * @example
+ * // Count badges
+ * <Badge count={5} variant="danger" />
+ * <Badge count={150} maxCount={99} variant="primary" />
+ *
+ * @example
+ * // Dot badge (status indicator)
+ * <Badge dot variant="success" />
+ *
+ * @example
+ * // Clickable badge
+ * <Badge
+ *   variant="primary"
+ *   onClick={(e) => console.log('Badge clicked')}
+ * >
+ *   Clickable
+ * </Badge>
+ *
+ * @example
+ * // Usage recommendations:
+ * // 1. For status indicators: use 'dot' prop with appropriate variant
+ * // 2. For notification counts: use 'count' prop with 'danger' or 'primary' variant
+ * // 3. For labels/tags: use text content with 'pill' shape
+ * // 4. For action badges: add onClick handler and use 'primary' variant
+ * // 5. For subtle indicators: use 'outlined' prop with muted variants
+ */

package/dist/src/types/components/ui/LibraryList.d.ts

@@ -0,0 +1,2 @@
+declare const LibraryList: () => import("react/jsx-runtime").JSX.Element;
+export default LibraryList;

package/dist/src/types/components/ui/index.d.ts

@@ -12,5 +12,6 @@ export { default as Action } from "./Action";
 export { default as Dropdown } from "./Dropdown";
 export { default as ColorPicker } from "./ColorPicker";
 export { default as ComponentLists } from "./ComponentLists";
+export { default as LibraryList } from "./LibraryList";
 export * from "./cards";
 export * from "./charts";

package/dist/src/types/components/ui/tables/IHubTableServer.d.ts

@@ -1,6 +1,9 @@
 import React from "react";
 import { ApiResponseType, TableColumnType } from "@/types";
 import { FetchParamsType } from "@/types";
+export interface IHubTableServerRef {
+    refresh: () => void;
+}
 interface IHubTableServerPropsType<T> {
     /** Token for authentication */
     token?: string | null;
@@ -41,6 +44,7 @@ interface IHubTableServerPropsType<T> {
  *
  * @example
  * ```tsx
+ * // Basic usage
  * <IHubTableServer
  *   columns={columns}
  *   endpointPath={"/api/program-courses"}
@@ -60,8 +64,20 @@ interface IHubTableServerPropsType<T> {
  *   rowsPerPageOptions={[10, 25, 50, 100]}
  *   defaultRowsPerPage={10}
  *   onFetchError={handleFetchError}
- *   refreshable={true}
- *   onRefresh={handleRefresh}
+ * />
+ *
+ * // With refresh control from parent
+ * const tableRef = useRef<IHubTableServerRef>(null);
+ *
+ * const handleExternalRefresh = () => {
+ *   tableRef.current?.refresh();
+ * };
+ *
+ * <IHubTableServer
+ *   ref={tableRef}
+ *   columns={columns}
+ *   endpointPath={"/api/program-courses"}
+ *   // ... other props
  * />
  * ```
  * @prop {string} token - The token for authentication
@@ -87,5 +103,5 @@ interface IHubTableServerPropsType<T> {
  *
  * @link https://github.com/instincthub/instincthub-react-ui/blob/main/src/__examples__/src/components/ui/TableServerExamples.tsx
  */
-export declare function IHubTableServer<T extends object>({ token, columns, defaultData, endpointPath, initialParams, dataAdapter, title, emptyStateMessage, emptyStateIcon, actions, showSearch, searchPlaceholder, searchDebounceMs, enableSorting, enableExport, exportOptions, rowsPerPageOptions, defaultRowsPerPage, onRowClick, onFetchError, expandable, renderExpandedRow, keyExtractor, stickyHeader, maxHeight, hideHeaderOnMobile, }: IHubTableServerPropsType<T>): JSX.Element;
+export declare const IHubTableServer: React.ForwardRefExoticComponent<IHubTableServerPropsType<any> & React.RefAttributes<IHubTableServerRef>>;
 export default IHubTableServer;

package/dist/src/types/index.d.ts

@@ -47,11 +47,17 @@ export { default as ToggleButton } from "./components/forms/ToggleButton";
 export { default as CheckBoxesField } from "./components/forms/CheckboxesField";
 export { default as CheckBoxes } from "./components/forms/CheckBoxes";
 export { default as DateInputPicker } from "./components/forms/DateInputPicker";
+export { default as DateTimePicker } from "./components/forms/DateTimePicker";
+export { default as TimePicker } from "./components/forms/TimePicker";
 export { default as ChipsInput } from "./components/forms/ChipsInput";
 export { default as RadioButton } from "./components/forms/radio-btn/RadioButton";
 export { default as RadioGroup } from "./components/forms/radio-btn/RadioGroup";
 export { default as InputAmount } from "./components/forms/InputAmount";
 export { default as FileField } from "./components/forms/FileField";
+export { default as CountryInput } from "./components/forms/CountryInput";
+export { default as CountryStateInput } from "./components/forms/CountryStateInput";
+export { default as InputSearchDropdown } from "./components/forms/InputSearchDropdown";
+export { default as RangeRadio } from "./components/forms/RangeRadio";
 export { default as ChannelListAvatar } from "./components/navbar/ChannelListAvatar";
 export { default as MenuDropdown } from "./components/navbar/MenuDropdown";
 export { default as Breadcrumb } from "./components/navbar/Breadcrumb";
@@ -65,6 +71,7 @@ export { default as ContentViewOrEdit } from "./components/ui/viewer/ContentView
 export { default as CodeDisplay } from "./components/ui/viewer/CodeDisplay";
 export { default as IHubTable } from "./components/ui/tables/IHubTable";
 export { default as IHubTableServer } from "./components/ui/tables/IHubTableServer";
+export type { IHubTableServerRef } from "./components/ui/tables/IHubTableServer";
 export { default as OrDivider } from "./components/ui/OrDivider";
 export { default as RandomGradientImage } from "./components/ui/images/RandomGradientImage";
 export { default as ComponentLists } from "./components/ui/ComponentLists";
@@ -99,4 +106,14 @@ export { default as Unauthorized } from "./components/status/Unauthorized";
 export { default as Tabs } from "./components/tabs/Tabs";
 export { default as VerticalTabs } from "./components/tabs/VerticalTabs";
 export { default as TabContent } from "./components/tabs/TabContent";
+export { default as Cursor } from "./components/cursors/Cursor";
+export { default as CursorControlDemo } from "./components/cursors/CursorControlDemo";
+export { default as MagneticButton } from "./components/cursors/MagneticButton";
+export { default as useCursorInteraction } from "./components/cursors/useCursorInteraction";
+export { default as useClientSide } from "./components/auth/useClientSide";
+export { default as useFormattedDate } from "./components/auth/useFormattedDate";
+export { default as useStableRandom } from "./components/auth/useStableRandom";
+export { default as useExternalData } from "./components/auth/useExternalData";
+export { default as ClientOnly } from "./components/auth/ClientOnly";
+export { default as SideNavbarContext } from "./components/navbar/SideNavbarContext";
 export * from "./components/lib/redux";

package/dist/src/types/types/auth.d.ts

@@ -0,0 +1,309 @@
+import { User as AuthUser } from "next-auth";
+export type ChannelId = string & {
+    readonly brand: unique symbol;
+};
+export type UserId = string & {
+    readonly brand: unique symbol;
+};
+export type WorkspaceId = string & {
+    readonly brand: unique symbol;
+};
+export type SubscriptionId = string & {
+    readonly brand: unique symbol;
+};
+export type PlanType = "free" | "starter" | "pro" | "enterprise";
+export type PlanStatus = "active" | "inactive" | "cancelled" | "past_due";
+export type UserRole = "owner" | "admin" | "member" | "viewer";
+export type ThemePreference = "light" | "dark" | "system";
+export type RateLimitWindow = "minute" | "hour" | "day";
+export type Permissions = "LEARNER" | "BLOGGER" | "EVENT" | "MODERATOR" | "INSTRUCTOR" | "ADMIN" | "REGISTRAR" | "FINANCE" | "SUPER_ADMIN" | any;
+/**
+ * Base channel structure representing a user's channel membership
+ */
+export interface Channel {
+    /** Unique channel identifier */
+    id: ChannelId;
+    /** Display name of the channel */
+    name: string;
+    /** Unique username for the channel */
+    username: string;
+    /** Channel thumbnail image URL */
+    thumbnail?: string;
+    /** User's role within this channel */
+    role: UserRole;
+    /** Current subscription plan for this channel */
+    plan: PlanType;
+    /** Current status of the channel's plan */
+    planStatus: PlanStatus;
+    /** Start date of current billing period */
+    currentPeriodStart?: Date;
+    /** End date of current billing period */
+    currentPeriodEnd?: Date;
+    /** Whether plan will be cancelled at period end */
+    cancelAtPeriodEnd?: boolean;
+    /** Custom primary color for channel branding */
+    primaryColor?: string;
+    /** Channel-specific permissions for this user */
+    permissions?: Permissions[];
+    /** Date when user joined this channel */
+    joinedAt: Date;
+    /** Last time user accessed this channel */
+    lastAccessedAt?: Date;
+    /** Channel-specific user settings */
+    settings?: Record<string, any>;
+}
+/**
+ * Container for user's channel information
+ */
+export interface UserChannels {
+    /** Currently active/selected channel */
+    active: Channel | null;
+    /** List of all channels user has access to */
+    list: Channel[];
+    /** Total number of channels */
+    count: number;
+}
+/**
+ * User subscription details and billing information
+ */
+export interface UserSubscription {
+    /** Unique subscription identifier */
+    id: SubscriptionId;
+    /** Current subscription plan */
+    plan: PlanType;
+    /** Current subscription status */
+    status: PlanStatus;
+    /** Start date of current billing period */
+    currentPeriodStart: Date;
+    /** End date of current billing period */
+    currentPeriodEnd: Date;
+    /** Whether subscription will be cancelled at period end */
+    cancelAtPeriodEnd?: boolean;
+    /** Trial end date if applicable */
+    trialEnd?: Date;
+    /** List of enabled features */
+    features?: string[];
+    /** Usage limits for this subscription */
+    limits?: {
+        /** Maximum number of channels allowed */
+        channels?: number;
+        /** Storage limit in bytes */
+        storage?: number;
+        /** Bandwidth limit in bytes */
+        bandwidth?: number;
+        /** API calls limit per period */
+        apiCalls?: number;
+    };
+}
+/**
+ * Workspace/organization context
+ */
+export interface Workspace {
+    /** Unique workspace identifier */
+    id: WorkspaceId;
+    /** Display name of the workspace */
+    name: string;
+    /** Parent organization identifier */
+    organizationId: string;
+    /** Whether this is the user's default workspace */
+    isDefault?: boolean;
+}
+/**
+ * API rate limiting information
+ */
+export interface RateLimit {
+    /** Maximum requests allowed in the window */
+    limit: number;
+    /** Remaining requests in current window */
+    remaining: number;
+    /** When the rate limit window resets */
+    reset: Date;
+    /** Duration of the rate limit window */
+    window: RateLimitWindow;
+}
+/**
+ * User notification preferences
+ */
+export interface NotificationPreferences {
+    /** Enable email notifications */
+    email?: boolean;
+    /** Enable push notifications */
+    push?: boolean;
+    /** Enable SMS notifications */
+    sms?: boolean;
+}
+/**
+ * User application preferences
+ */
+export interface UserPreferences {
+    /** Notification settings */
+    notifications?: NotificationPreferences;
+    /** UI theme preference */
+    theme?: ThemePreference;
+    /** Preferred language code */
+    language?: string;
+}
+/**
+ * Complete user structure extending NextAuth User
+ */
+export interface User extends AuthUser {
+    /** Unique user identifier */
+    id: UserId;
+    /** Unique UUID for the user */
+    uuid: string;
+    /** User's email address */
+    email: string;
+    /** User's display name */
+    name: string;
+    /** User's first name */
+    firstName?: string;
+    /** User's last name */
+    lastName?: string;
+    /** Unique username */
+    username?: string;
+    /** Profile image URL */
+    image?: string;
+    /** Is user email verfied? */
+    emailVerified?: boolean;
+    /** User's phone number */
+    phoneNumber?: string;
+    /** Phone verification status */
+    phoneVerified?: boolean;
+    /** Whether 2FA is enabled */
+    twoFactorEnabled?: boolean;
+    /** Last login timestamp */
+    lastLoginAt?: Date;
+    /** IP address of last login */
+    lastLoginIp?: string;
+    /** Total number of logins */
+    loginCount?: number;
+    /** Account creation timestamp */
+    createdAt?: Date;
+    /** Last profile update timestamp */
+    updatedAt?: Date;
+    /** User's locale preference */
+    locale?: string;
+    /** User's timezone */
+    timezone?: string;
+    /** Preferred currency */
+    currency?: string;
+    /** User application preferences */
+    preferences?: UserPreferences;
+}
+/**
+ * API quota tracking information
+ */
+export interface ApiQuota {
+    /** Number of API calls used in current period */
+    used: number;
+    /** Maximum API calls allowed in period */
+    limit: number;
+    /** When the quota resets */
+    resetAt: Date;
+}
+/**
+ * Geographic location information
+ */
+export interface GeoLocation {
+    /** Country code */
+    country?: string;
+    /** Region/state */
+    region?: string;
+    /** City name */
+    city?: string;
+}
+/**
+ * Session error types
+ */
+export type SessionError = "RefreshAccessTokenError" | "SessionExpired" | "Unauthorized";
+/**
+ * Complete Session interface for authenticated users
+ */
+export interface Session {
+    /** Full user information */
+    user: User;
+    /** User's channel memberships */
+    channels: UserChannels;
+    /** OAuth access token */
+    accessToken: string;
+    /** OAuth refresh token */
+    refreshToken?: string;
+    /** OpenID Connect ID token */
+    idToken?: string;
+    /** CSRF protection token */
+    csrfToken?: string;
+    /** OAuth provider name */
+    provider?: string;
+    /** Provider-specific account ID */
+    providerAccountId?: string;
+    /** OAuth scopes granted */
+    scope?: string;
+    /** Token type (usually "Bearer") */
+    tokenType?: string;
+    /** User's API key */
+    apiKey?: string;
+    /** Bearer token for API access */
+    bearerToken?: string;
+    /** Webhook secret for secure callbacks */
+    webhookSecret?: string;
+    /** Session expiration time (ISO string) */
+    expires: string;
+    /** Session expiration as Date object */
+    expiresAt?: Date;
+    /** Session creation timestamp */
+    issuedAt?: Date;
+    /** Current active workspace */
+    workspace?: Workspace;
+    /** All workspaces user has access to */
+    workspaces?: Workspace[];
+    /** User's global roles */
+    roles?: string[];
+    /** User's contextual permissions */
+    permissions?: string[];
+    /** User's global permissions */
+    globalPermissions?: string[];
+    /** User's subscription information */
+    userSubscription?: UserSubscription;
+    /** Billing contact email */
+    billingEmail?: string;
+    /** Stripe customer identifier */
+    stripeCustomerId?: string;
+    /** Enabled features map */
+    features?: Record<string, boolean>;
+    /** A/B test experiments */
+    experiments?: Record<string, string>;
+    /** API rate limiting information */
+    rateLimit?: RateLimit;
+    /** API quota usage information */
+    apiQuota?: ApiQuota;
+    /** Client IP address */
+    ipAddress?: string;
+    /** Client user agent string */
+    userAgent?: string;
+    /** Geographic location information */
+    geoLocation?: GeoLocation;
+    /** Terms and privacy consent timestamp */
+    consentedAt?: Date;
+    /** Privacy policy version accepted */
+    privacyPolicyVersion?: string;
+    /** Terms of service version accepted */
+    termsVersion?: string;
+    /** Session error type if applicable */
+    error?: SessionError;
+    /** Human-readable error description */
+    errorDescription?: string;
+    /** Additional custom session data */
+    metadata?: Record<string, any>;
+}
+export declare const isValidSession: (session: any) => session is Session;
+export declare const isValidUser: (user: any) => user is User;
+export declare const isValidChannel: (channel: any) => channel is Channel;
+export declare const DEFAULT_USER_PREFERENCES: UserPreferences;
+export declare const DEFAULT_USER_CHANNELS: UserChannels;
+export declare const PLAN_TYPES: readonly PlanType[];
+export declare const USER_ROLES: readonly UserRole[];
+export declare const PLAN_STATUSES: readonly PlanStatus[];
+export declare const createUserId: (id: string) => UserId;
+export declare const createChannelId: (id: string) => ChannelId;
+export declare const createWorkspaceId: (id: string) => WorkspaceId;
+export declare const createSubscriptionId: (id: string) => SubscriptionId;

package/dist/src/types/types/channels.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Channel-related type definitions
+ */
+export interface CurrencyType {
+    id: string;
+    title: string;
+    country: string;
+    code: string;
+    symbol: string;
+    timestamp: string;
+}
+export interface ChannelCurrencyType {
+    id: number;
+    currency_object: CurrencyType;
+    last_action_timestamp: string;
+    timestamp: string;
+    channel: string;
+    currency: string;
+    last_action_user: number;
+}
+export interface PlanType {
+    id: string;
+    title: string;
+    display_type: string;
+    access_type: string | null;
+    active: boolean;
+    channel: string;
+    owner: number;
+}
+export interface SubscriptionType {
+    id: string;
+    plan: PlanType | string | null;
+    email: string | null;
+    reference: string | null;
+    object_id: string | null;
+    start_date: string;
+    end_date: string;
+    status: "ACTIVATED" | "DEACTIVATED" | "PENDING" | "EXPIRED";
+    interval: "ONETIME" | "MONTHLY" | "YEARLY" | "WEEKLY";
+    reminder_count: string;
+    last_action: string;
+    timestamp: string;
+    owner: number;
+    user: number;
+    channel: string;
+    user_payment: string | null;
+    content_type: string | null;
+}
+export interface ChannelAdmission {
+    domain: string;
+    status: string | null;
+    owner: number | null;
+    channel: string | null;
+}
+export interface ChannelPortalType {
+    id: string;
+    domain: string;
+    subdomain: string;
+    prefix: string | null;
+    min_units: string;
+    max_units: string;
+    final_year_units: string;
+    status: "ACTIVE" | "INACTIVE" | "PENDING";
+    last_action: string;
+    timestamp: string;
+    owner: number;
+    channel: string;
+}
+export interface ChannelType {
+    id: string;
+    subscription?: SubscriptionType;
+    currency?: ChannelCurrencyType;
+    channel_admission?: ChannelAdmission;
+    channel_portal?: ChannelPortalType;
+    name: string;
+    username: string;
+    email: string;
+    phone: string | null;
+    company_size: string;
+    primary_color: string;
+    thumbnail: string;
+    description: string;
+    address: string | null;
+    plagiarism_declaration: string;
+    library_message: string;
+    ledger_balance: string;
+    main_balance: string;
+    website_url: string;
+    twitter_url: string;
+    linkedin_url: string;
+    facebook_url: string;
+    instagram_url: string;
+    discord_url: string;
+    github_url: string;
+    admission_url: string | null;
+    ip_data: Record<string, any>;
+    verified: boolean;
+    status: "ACTIVE" | "INACTIVE" | "SUSPENDED" | "PENDING";
+    timestamp: string;
+    owner: number;
+    industry: string;
+    detail?: string | null;
+    [key: string]: any;
+}