@mohasinac/appkit 2.3.1 → 2.4.0

package/dist/react/hooks/useBulkSelection.d.ts

@@ -1,40 +1,23 @@
-import type { Dispatch, SetStateAction } from "react";
 export interface UseBulkSelectionOptions<T> {
-    /** The current page / list of items being displayed. */
     items: T[];
-    /** Extract a stable unique key from each item (e.g. `item => item.id`). */
     keyExtractor: (item: T) => string;
-    /**
-     * Maximum number of IDs that can be selected at once.
-     * @default 100
-     */
     maxSelection?: number;
 }
 export interface UseBulkSelectionReturn {
+    /** Stable array of selected IDs — for backward-compat serialisation / API calls. */
     selectedIds: string[];
+    /** O(1) membership set — prefer this over `selectedIds.includes()` in render. */
+    selectedIdSet: Set<string>;
     selectedCount: number;
-    /** Returns `true` if the given ID is currently selected. */
+    /** `true` when at least one item is selected — drives selection-mode UI. */
+    isSelecting: boolean;
     isSelected: (id: string) => boolean;
-    /** `true` when every item on the current page is selected. */
     isAllSelected: boolean;
-    /**
-     * `true` when some — but not all — items are selected.
-     * Use to set the indeterminate state on the header checkbox.
-     */
     isIndeterminate: boolean;
-    /** Toggle one item in or out of the selection. Respects `maxSelection`. */
     toggle: (id: string) => void;
-    /**
-     * Select all items on the current page (up to `maxSelection`),
-     * or deselect all if every item is already selected.
-     */
     toggleAll: () => void;
-    /** Deselect everything. Call this after a bulk action completes. */
     clearSelection: () => void;
-    /**
-     * Direct state setter — pass straight to a table's `onSelectionChange`
-     * or use when you need to replace the entire selection programmatically.
-     */
-    setSelectedIds: Dispatch<SetStateAction<string[]>>;
+    /** Replace entire selection programmatically. */
+    setSelectedIds: (ids: string[]) => void;
 }
 export declare function useBulkSelection<T>({ items, keyExtractor, maxSelection, }: UseBulkSelectionOptions<T>): UseBulkSelectionReturn;

package/dist/react/hooks/useBulkSelection.js

@@ -1,52 +1,45 @@
 "use client";
-/**
- * useBulkSelection
- *
- * Generic multi-select state hook for list/table rows.
- * Pairs with any table component that accepts `selectedIds` and
- * `onSelectionChange` props.
- *
- * @example
- * ```tsx
- * const selection = useBulkSelection({ items, keyExtractor: (p) => p.id });
- *
- * <DataTable
- *   selectable
- *   selectedIds={selection.selectedIds}
- *   onSelectionChange={selection.setSelectedIds}
- * />
- * ```
- */
 import { useState, useCallback, useMemo } from "react";
 /** Default API limit — match the `z.array().max(N)` on your bulk endpoint */
 const BULK_MAX_IDS = 100;
 export function useBulkSelection({ items, keyExtractor, maxSelection = BULK_MAX_IDS, }) {
-    const [selectedIds, setSelectedIds] = useState([]);
+    const [selectedSet, setSelectedSet] = useState(() => new Set());
     const allIds = useMemo(() => items.map(keyExtractor), [items, keyExtractor]);
-    const isSelected = useCallback((id) => selectedIds.includes(id), [selectedIds]);
     const toggle = useCallback((id) => {
-        setSelectedIds((prev) => {
-            if (prev.includes(id))
-                return prev.filter((s) => s !== id);
-            if (prev.length >= maxSelection)
-                return prev;
-            return [...prev, id];
+        setSelectedSet((prev) => {
+            const next = new Set(prev);
+            if (next.has(id)) {
+                next.delete(id);
+            }
+            else if (next.size < maxSelection) {
+                next.add(id);
+            }
+            return next;
         });
     }, [maxSelection]);
     const toggleAll = useCallback(() => {
-        setSelectedIds((prev) => {
-            const allSelected = prev.length === allIds.length && allIds.length > 0;
+        setSelectedSet((prev) => {
+            const allSelected = prev.size === allIds.length && allIds.length > 0;
             if (allSelected)
-                return [];
-            return allIds.slice(0, maxSelection);
+                return new Set();
+            return new Set(allIds.slice(0, maxSelection));
         });
     }, [allIds, maxSelection]);
-    const clearSelection = useCallback(() => setSelectedIds([]), []);
-    const isAllSelected = allIds.length > 0 && selectedIds.length === allIds.length;
-    const isIndeterminate = selectedIds.length > 0 && selectedIds.length < allIds.length;
+    const clearSelection = useCallback(() => setSelectedSet(new Set()), []);
+    const setSelectedIds = useCallback((ids) => {
+        setSelectedSet(new Set(ids.slice(0, maxSelection)));
+    }, [maxSelection]);
+    const isSelected = useCallback((id) => selectedSet.has(id), [selectedSet]);
+    const selectedIds = useMemo(() => Array.from(selectedSet), [selectedSet]);
+    const selectedCount = selectedSet.size;
+    const isSelecting = selectedCount > 0;
+    const isAllSelected = allIds.length > 0 && selectedCount === allIds.length;
+    const isIndeterminate = selectedCount > 0 && selectedCount < allIds.length;
     return {
         selectedIds,
-        selectedCount: selectedIds.length,
+        selectedIdSet: selectedSet,
+        selectedCount,
+        isSelecting,
         isSelected,
         isAllSelected,
         isIndeterminate,

package/dist/react/hooks/useLongPress.d.ts

@@ -1,21 +1,8 @@
 /**
- * useLongPress Hook
- *
  * Fires `callback` after the element is held for `ms` milliseconds.
- * A quick tap (pointer-up before the threshold) does NOT fire the callback.
- * Safe to use on both mouse and touch devices.
- *
- * @param callback - Function to call on long-press
- * @param ms       - Hold duration in ms before callback fires (default: 500)
- *
- * @example
- * ```tsx
- * const longPress = useLongPress(() => openContextMenu(), 500);
- *
- * return (
- *   <tr {...longPress}>…</tr>
- * );
- * ```
+ * Quick taps (pointer-up before threshold) do NOT fire the callback.
+ * Triggers haptic feedback via `navigator.vibrate` on mobile.
+ * Safe for both mouse and touch devices.
  */
 export declare function useLongPress(callback: () => void, ms?: number): {
     onMouseDown: () => void;

package/dist/react/hooks/useLongPress.js

@@ -1,33 +1,20 @@
 "use client";
 import { useRef, useCallback, useEffect } from "react";
 /**
- * useLongPress Hook
- *
  * Fires `callback` after the element is held for `ms` milliseconds.
- * A quick tap (pointer-up before the threshold) does NOT fire the callback.
- * Safe to use on both mouse and touch devices.
- *
- * @param callback - Function to call on long-press
- * @param ms       - Hold duration in ms before callback fires (default: 500)
- *
- * @example
- * ```tsx
- * const longPress = useLongPress(() => openContextMenu(), 500);
- *
- * return (
- *   <tr {...longPress}>…</tr>
- * );
- * ```
+ * Quick taps (pointer-up before threshold) do NOT fire the callback.
+ * Triggers haptic feedback via `navigator.vibrate` on mobile.
+ * Safe for both mouse and touch devices.
  */
 export function useLongPress(callback, ms = 500) {
     const timerRef = useRef(null);
-    // Keep callback ref stable — avoids re-attaching on every render
     const callbackRef = useRef(callback);
     useEffect(() => {
         callbackRef.current = callback;
     }, [callback]);
     const start = useCallback(() => {
         timerRef.current = setTimeout(() => {
+            navigator.vibrate?.(30);
             callbackRef.current();
         }, ms);
     }, [ms]);
@@ -37,14 +24,8 @@ export function useLongPress(callback, ms = 500) {
             timerRef.current = null;
         }
     }, []);
-    // Clean up any pending timer on unmount
-    useEffect(() => {
-        return () => {
-            if (timerRef.current !== null) {
-                clearTimeout(timerRef.current);
-            }
-        };
-    }, []);
+    useEffect(() => () => { if (timerRef.current !== null)
+        clearTimeout(timerRef.current); }, []);
     return {
         onMouseDown: start,
         onMouseUp: cancel,

package/dist/react/index.d.ts

@@ -27,6 +27,7 @@ export { useCamera } from "./hooks/useCamera";
 export type { UseCameraOptions, UseCameraReturn } from "./hooks/useCamera";
 export { useBulkSelection } from "./hooks/useBulkSelection";
 export type { UseBulkSelectionOptions, UseBulkSelectionReturn, } from "./hooks/useBulkSelection";
+export { useSyncManager } from "../core/hooks/useSyncManager";
 export { useUrlTable } from "./hooks/useUrlTable";
 export type { UseUrlTableOptions } from "./hooks/useUrlTable";
 export { usePendingFilters } from "./hooks/usePendingFilters";

package/dist/react/index.js

@@ -24,6 +24,8 @@ export { useCountdown } from "./hooks/useCountdown";
 export { useCamera } from "./hooks/useCamera";
 // Multi-select / bulk operations
 export { useBulkSelection } from "./hooks/useBulkSelection";
+// Local-first cart + wishlist sync
+export { useSyncManager } from "../core/hooks/useSyncManager";
 // URL-driven table / list state
 export { useUrlTable } from "./hooks/useUrlTable";
 // Staged (pending) filter management

package/dist/repositories/index.d.ts

@@ -34,4 +34,7 @@ export { EventEntryRepository, EventEntriesRepository, eventEntryRepository, } f
 export { NewsletterRepository, newsletterRepository, } from "../core/newsletter.repository";
 export type { NewsletterSubscriberDocument, NewsletterSubscriberCreateInput, NewsletterSubscriberUpdateInput, NewsletterListModel, } from "../core/newsletter.repository";
 export { CopilotLogRepository, copilotLogRepository } from "../core";
+export { BrandsRepository, brandsRepository, } from "../features/brands/repository/brands.repository";
+export type { BrandDocument, BrandCreateInput, BrandUpdateInput, } from "../features/brands/schemas";
 export type { CopilotFeedback, CopilotLogDocument, CopilotLogCreateInput, } from "../core";
+export { ScammerRepository, scammerRepository, } from "../features/scams/repository/scammer.repository";

package/dist/repositories/index.js

@@ -37,3 +37,5 @@ export { EventRepository, EventsRepository, eventRepository, } from "../features
 export { EventEntryRepository, EventEntriesRepository, eventEntryRepository, } from "../features/events/repository/event-entry.repository";
 export { NewsletterRepository, newsletterRepository, } from "../core/newsletter.repository";
 export { CopilotLogRepository, copilotLogRepository } from "../core";
+export { BrandsRepository, brandsRepository, } from "../features/brands/repository/brands.repository";
+export { ScammerRepository, scammerRepository, } from "../features/scams/repository/scammer.repository";

package/dist/seed/actions/demo-seed-actions.d.ts

@@ -1,12 +1,12 @@
 /**
  * Demo Seed Domain Actions — appkit
  *
- * Dev-only actions for loading/deleting seed data.
+ * Admin-controlled seed actions.
  * Delegates to the consumer's POST /api/demo/seed route which contains
  * the actual collection-specific seeding logic (800+ lines with PII encryption,
  * Auth user creation, subcollection handling, etc.).
  */
-export type SeedCollectionName = "users" | "addresses" | "categories" | "stores" | "products" | "orders" | "reviews" | "bids" | "coupons" | "carouselSlides" | "homepageSections" | "siteSettings" | "faqs" | "notifications" | "payouts" | "blogPosts" | "events" | "eventEntries" | "sessions" | "storeAddresses" | "carts" | "wishlists";
+export type SeedCollectionName = "users" | "addresses" | "brands" | "categories" | "stores" | "products" | "orders" | "reviews" | "bids" | "coupons" | "carouselSlides" | "homepageSections" | "siteSettings" | "faqs" | "notifications" | "payouts" | "blogPosts" | "events" | "eventEntries" | "sessions" | "storeAddresses" | "carts" | "wishlists" | "conversations" | "sublistingCategories" | "groupedListings" | "scammerProfiles";
 export interface SeedOperationResult {
     success?: boolean;
     message: string;

package/dist/seed/actions/demo-seed-actions.js

@@ -1,7 +1,7 @@
 /**
  * Demo Seed Domain Actions — appkit
  *
- * Dev-only actions for loading/deleting seed data.
+ * Admin-controlled seed actions.
  * Delegates to the consumer's POST /api/demo/seed route which contains
  * the actual collection-specific seeding logic (800+ lines with PII encryption,
  * Auth user creation, subcollection handling, etc.).