@react-pakistan/util-functions 1.25.32 → 1.25.33

package/factory/generic-component-factory.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Generic Component Factory
+ *
+ * Reusable UI components for CRUD modules with customizable configuration.
+ * Generates tables, forms, drawers, and other common UI patterns.
+ */
+import React, { FC } from 'react';
+import { COMPONENT_TYPE, HeaderAction, TableColumn } from '@appcorp/shadcn/components/enhanced-table';
+export declare const DRAWER_TYPES: {
+    FORM_DRAWER: string;
+    FILTER_DRAWER: string;
+    VIEW_DRAWER: string;
+    MORE_ACTIONS_DRAWER: string;
+};
+export interface ComponentConfig {
+    cancelLabel?: string;
+    drawerDescription?: string;
+    drawerTitle: string;
+    filterContent: React.ReactNode;
+    filterDrawerValue?: string;
+    formContent: React.ReactNode;
+    formDrawerValue?: string;
+    moduleName: string;
+    moreActionsContent: React.ReactNode;
+    saveLabel?: string;
+    searchPlaceholder: string;
+    size?: 'small' | 'medium' | 'large' | 'full';
+    tableColumns: TableColumn[];
+    tableDescription: string;
+    tableTitle: string;
+    viewContent: React.ReactNode;
+    viewDrawerValue?: string;
+}
+export interface TableBodyCol {
+    key?: string | string[];
+    componentType: COMPONENT_TYPE | string;
+    textFormatter?: (value: unknown, row: unknown) => React.ReactNode;
+}
+interface GenericTableProps {
+    config: ComponentConfig;
+    context: any;
+    tableBodyCols: TableBodyCol[];
+    headerActions?: HeaderAction[];
+    rowActions?: any[];
+    iconMap?: Record<string, any>;
+}
+export declare const GenericTable: FC<GenericTableProps>;
+interface GenericDrawerProps {
+    config: ComponentConfig;
+    context: any;
+    formContent?: React.ReactNode;
+    viewContent?: React.ReactNode;
+    filterContent?: React.ReactNode;
+    moreActionsContent?: React.ReactNode;
+}
+export declare const GenericDrawer: FC<GenericDrawerProps>;
+interface GenericModulePageProps {
+    config: ComponentConfig;
+    context: any;
+    tableBodyCols: TableBodyCol[];
+    headerActions?: HeaderAction[];
+    rowActions?: any[];
+    iconMap?: Record<string, any>;
+}
+export declare const createGenericModulePage: (config: ComponentConfig) => React.FC<GenericModulePageProps>;
+export {};

package/factory/generic-component-factory.js

@@ -0,0 +1,119 @@
+/**
+ * Generic Component Factory
+ *
+ * Reusable UI components for CRUD modules with customizable configuration.
+ * Generates tables, forms, drawers, and other common UI patterns.
+ */
+'use client';
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGenericModulePage = exports.GenericDrawer = exports.GenericTable = exports.DRAWER_TYPES = void 0;
+var react_1 = __importStar(require("react"));
+var next_intl_1 = require("next-intl");
+var general_1 = require("../general");
+var use_rtl_1 = require("../hooks/use-rtl");
+var enhanced_table_1 = require("@appcorp/shadcn/components/enhanced-table");
+var sonner_1 = require("@appcorp/shadcn/components/ui/sonner");
+var drawer_generic_1 = require("@appcorp/shadcn/components/drawer-generic");
+var enhanced_drawer_header_1 = require("@appcorp/shadcn/components/enhanced-drawer-header");
+var enhanced_drawer_footer_1 = require("@appcorp/shadcn/components/enhanced-drawer-footer");
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+exports.DRAWER_TYPES = {
+    FORM_DRAWER: 'FORM_DRAWER',
+    FILTER_DRAWER: 'FILTER_DRAWER',
+    VIEW_DRAWER: 'VIEW_DRAWER',
+    MORE_ACTIONS_DRAWER: 'MORE_ACTIONS_DRAWER',
+};
+var GenericTable = function (_a) {
+    var config = _a.config, context = _a.context, tableBodyCols = _a.tableBodyCols, headerActions = _a.headerActions, rowActions = _a.rowActions;
+    var t = (0, next_intl_1.useTranslations)(config.moduleName.toLowerCase());
+    var isRTL = (0, use_rtl_1.useRTL)();
+    var tableHeadItems = (0, react_1.useMemo)(function () {
+        return config.tableColumns.map(function (col) { return ({
+            label: t(col.label),
+            width: col.width,
+        }); });
+    }, [config.tableColumns, t]);
+    var totalPages = (0, general_1.calculatePages)(context.state.count, context.state.pageLimit);
+    // Build header actions from context or props
+    var allHeaderActions = (0, react_1.useMemo)(function () { return headerActions || context.headerActions || []; }, [headerActions, context.headerActions]);
+    return (react_1.default.createElement("div", { className: "space-y-4 ".concat(isRTL ? 'rtl' : 'ltr'), dir: isRTL ? 'rtl' : 'ltr' },
+        react_1.default.createElement(enhanced_table_1.EnhancedTable, { currentPage: Number(context.state.currentPage), handleNextOnClick: context.handlePageChange, handleOnSelect: context.handlePageLimitChange, handlePreviousOnClick: function () {
+                return context.handlePageChange(context.state.currentPage - 1);
+            }, handleSearchInput: context.handleSearch, headerActions: allHeaderActions, isNextDisabled: (0, general_1.isNextButtonDisabled)(context.state.currentPage, totalPages), isPreviousDisabled: (0, general_1.isPreviousButtonDisabled)(context.state.currentPage), listOptions: (0, general_1.getAvailablePageLimits)(context.state.count), loading: context.listLoading, nodeSelectKey: "pageLimit", pageLimit: context.state.pageLimit, rowActions: rowActions || context.rowActions || [], searchDisabled: false, searchEnabled: true, searchId: "".concat(config.moduleName.toLowerCase(), "-search"), searchPlaceholder: t(config.searchPlaceholder), searchValue: context.state.searchQuery, tableBodyCols: tableBodyCols, tableBodyRows: context.state.items, tableDescription: t(config.tableDescription), tableHeadItems: tableHeadItems, tableHeading: t(config.tableTitle), totalPages: Number(totalPages) })));
+};
+exports.GenericTable = GenericTable;
+var GenericDrawer = function (_a) {
+    var _b, _c, _d, _e, _f, _g;
+    var config = _a.config, context = _a.context, formContent = _a.formContent, viewContent = _a.viewContent, filterContent = _a.filterContent, moreActionsContent = _a.moreActionsContent;
+    var t = (0, next_intl_1.useTranslations)(config.moduleName.toLowerCase());
+    var isRTL = (0, use_rtl_1.useRTL)();
+    var closeDrawer = context.closeDrawer || context.handleCloseDrawer;
+    var _h = context.state, disableSaveButton = _h.disableSaveButton, drawer = _h.drawer;
+    var isFormDrawer = drawer === exports.DRAWER_TYPES.FORM_DRAWER;
+    var isViewDrawer = drawer === exports.DRAWER_TYPES.VIEW_DRAWER;
+    var isFilterDrawer = drawer === exports.DRAWER_TYPES.FILTER_DRAWER;
+    var isMoreActionsDrawer = drawer === exports.DRAWER_TYPES.MORE_ACTIONS_DRAWER;
+    var isOpen = isFormDrawer || isViewDrawer || isFilterDrawer || isMoreActionsDrawer;
+    var drawerTitle = t(config.drawerTitle);
+    var drawerDescription = config.drawerDescription
+        ? t(config.drawerDescription)
+        : '';
+    var errors = (_b = context.state.errors) !== null && _b !== void 0 ? _b : {};
+    var formHeader = isFormDrawer ? (react_1.default.createElement(enhanced_drawer_header_1.EnhancedDrawerHeader, { title: drawerTitle, description: drawerDescription })) : null;
+    var viewHeader = isViewDrawer ? (react_1.default.createElement(enhanced_drawer_header_1.EnhancedDrawerHeader, { title: drawerTitle, description: drawerDescription })) : null;
+    var filterHeader = isFilterDrawer ? (react_1.default.createElement(enhanced_drawer_header_1.EnhancedDrawerHeader, { title: drawerTitle, description: drawerDescription })) : null;
+    var moreActionsHeader = isMoreActionsDrawer ? (react_1.default.createElement(enhanced_drawer_header_1.EnhancedDrawerHeader, { title: drawerTitle, description: drawerDescription })) : null;
+    var formFooter = isFormDrawer ? (react_1.default.createElement(enhanced_drawer_footer_1.EnhancedDrawerFooter, { applyFilters: function () { }, clearFilters: function () { }, closeDrawer: closeDrawer, disableSaveButton: disableSaveButton, drawerType: enhanced_drawer_footer_1.DRAWER_FOOTER_COMPONENT_TYPE.FORM_DRAWER, errors: errors, handleSubmit: context.handleSubmit, updateLoading: (_c = context.updateLoading) !== null && _c !== void 0 ? _c : false })) : null;
+    var viewFooter = isViewDrawer ? (react_1.default.createElement(enhanced_drawer_footer_1.EnhancedDrawerFooter, { applyFilters: function () { }, clearFilters: function () { }, closeDrawer: closeDrawer, disableSaveButton: false, drawerType: enhanced_drawer_footer_1.DRAWER_FOOTER_COMPONENT_TYPE.VIEW_DRAWER, errors: errors, handleSubmit: function () { }, updateLoading: false })) : null;
+    var filterFooter = isFilterDrawer ? (react_1.default.createElement(enhanced_drawer_footer_1.EnhancedDrawerFooter, { applyFilters: (_d = context.applyFilters) !== null && _d !== void 0 ? _d : (function () { }), clearFilters: (_e = context.clearFilters) !== null && _e !== void 0 ? _e : (function () { }), closeDrawer: closeDrawer, disableSaveButton: false, drawerType: enhanced_drawer_footer_1.DRAWER_FOOTER_COMPONENT_TYPE.FILTER_DRAWER, errors: errors, handleSubmit: (_f = context.handleSubmit) !== null && _f !== void 0 ? _f : (function () { }), updateLoading: false })) : null;
+    var moreActionsFooter = isMoreActionsDrawer ? (react_1.default.createElement(enhanced_drawer_footer_1.EnhancedDrawerFooter, { applyFilters: function () { }, clearFilters: function () { }, closeDrawer: closeDrawer, disableSaveButton: false, drawerType: enhanced_drawer_footer_1.DRAWER_FOOTER_COMPONENT_TYPE.MORE_ACTIONS_DRAWER, errors: errors, handleSubmit: function () { }, updateLoading: false })) : null;
+    return (react_1.default.createElement(drawer_generic_1.DrawerGeneric, { direction: isRTL ? 'left' : 'right', filterDrawer: isFilterDrawer ? filterContent : null, filterDrawerFooter: filterFooter, filterDrawerHeader: filterHeader, formDrawer: isFormDrawer ? formContent : null, formDrawerFooter: formFooter, formDrawerHeader: formHeader, moreActionsDrawer: isMoreActionsDrawer ? moreActionsContent : null, moreActionsDrawerFooter: moreActionsFooter, moreActionsDrawerHeader: moreActionsHeader, onOpenChange: function (open) { return !open && closeDrawer(); }, open: isOpen, viewDrawer: isViewDrawer ? viewContent : null, viewDrawerFooter: viewFooter, viewDrawerHeader: viewHeader, width: (_g = config.size) !== null && _g !== void 0 ? _g : 'small' }));
+};
+exports.GenericDrawer = GenericDrawer;
+var createGenericModulePage = function (config) {
+    var GenericModulePage = function (_a) {
+        var context = _a.context, tableBodyCols = _a.tableBodyCols, headerActions = _a.headerActions, rowActions = _a.rowActions, iconMap = _a.iconMap;
+        return (react_1.default.createElement("div", { className: "space-y-6" },
+            react_1.default.createElement(exports.GenericTable, { config: config, context: context, tableBodyCols: tableBodyCols, headerActions: headerActions, rowActions: rowActions, iconMap: iconMap }),
+            react_1.default.createElement(exports.GenericDrawer, { config: config, context: context, formContent: config.formContent, viewContent: config.viewContent, filterContent: config.filterContent, moreActionsContent: config.moreActionsContent }),
+            react_1.default.createElement(sonner_1.Toaster, null)));
+    };
+    return GenericModulePage;
+};
+exports.createGenericModulePage = createGenericModulePage;

package/factory/generic-module-factory.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Generic Module Factory - Minimal Version
+ *
+ * Provides reusable reducer and context structure for CRUD modules.
+ * API integration is handled by individual modules for maximum flexibility.
+ */
+import React from 'react';
+export interface ModuleConfig<T = any> {
+    name: string;
+    displayName: string;
+    initialState: T;
+    drawerTypes: Record<string, string>;
+    hooks?: {
+        onFormValidation?: (data: any) => Promise<boolean>;
+        onBeforeSubmit?: (data: any) => Promise<any>;
+        onAfterSubmit?: (state: any, response: any) => Promise<void>;
+        customActions?: Record<string, (state: any, payload?: any) => any>;
+    };
+}
+export interface GenericModuleContext<T = any> {
+    state: T;
+    dispatch: React.Dispatch<any>;
+}
+export declare const GENERIC_ACTION_TYPES: {
+    readonly RESET_FORM: "RESET_FORM";
+    readonly SET_CURRENT_PAGE: "SET_CURRENT_PAGE";
+    readonly SET_PAGE_LIMIT: "SET_PAGE_LIMIT";
+    readonly SET_SEARCH_QUERY: "SET_SEARCH_QUERY";
+    readonly SET_DRAWER: "SET_DRAWER";
+    readonly SET_ITEMS: "SET_ITEMS";
+    readonly SET_FORM_DATA: "SET_FORM_DATA";
+    readonly SET_DISABLE_SAVE_BUTTON: "SET_DISABLE_SAVE_BUTTON";
+    readonly SET_INPUT_FIELD: "SET_INPUT_FIELD";
+    readonly SET_ERRORS: "SET_ERRORS";
+};
+export declare const createGenericReducer: <T>(config: ModuleConfig<T>) => (state: T, action: any) => T;
+export declare const createGenericModuleHook: <T>(config: ModuleConfig<T>) => () => GenericModuleContext<T>;
+export declare const createGenericModuleProvider: <T>(config: ModuleConfig<T>) => {
+    Provider: React.FC<{
+        children: React.ReactNode;
+    }>;
+    useContext: () => GenericModuleContext<T>;
+    Context: React.Context<GenericModuleContext<T> | undefined>;
+};
+export declare const createGenericModule: <T>(config: ModuleConfig<T>) => {
+    reducer: (state: T, action: any) => T;
+    Provider: React.FC<{
+        children: React.ReactNode;
+    }>;
+    useContext: () => GenericModuleContext<T>;
+    config: ModuleConfig<T>;
+    actionTypes: {
+        readonly RESET_FORM: "RESET_FORM";
+        readonly SET_CURRENT_PAGE: "SET_CURRENT_PAGE";
+        readonly SET_PAGE_LIMIT: "SET_PAGE_LIMIT";
+        readonly SET_SEARCH_QUERY: "SET_SEARCH_QUERY";
+        readonly SET_DRAWER: "SET_DRAWER";
+        readonly SET_ITEMS: "SET_ITEMS";
+        readonly SET_FORM_DATA: "SET_FORM_DATA";
+        readonly SET_DISABLE_SAVE_BUTTON: "SET_DISABLE_SAVE_BUTTON";
+        readonly SET_INPUT_FIELD: "SET_INPUT_FIELD";
+        readonly SET_ERRORS: "SET_ERRORS";
+    };
+    initialState: T;
+};

package/factory/generic-module-factory.js

@@ -0,0 +1,159 @@
+/**
+ * Generic Module Factory - Minimal Version
+ *
+ * Provides reusable reducer and context structure for CRUD modules.
+ * API integration is handled by individual modules for maximum flexibility.
+ */
+'use client';
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGenericModule = exports.createGenericModuleProvider = exports.createGenericModuleHook = exports.createGenericReducer = exports.GENERIC_ACTION_TYPES = void 0;
+var react_1 = __importStar(require("react"));
+// ============================================================================
+// ACTION TYPES
+// ============================================================================
+exports.GENERIC_ACTION_TYPES = {
+    RESET_FORM: 'RESET_FORM',
+    SET_CURRENT_PAGE: 'SET_CURRENT_PAGE',
+    SET_PAGE_LIMIT: 'SET_PAGE_LIMIT',
+    SET_SEARCH_QUERY: 'SET_SEARCH_QUERY',
+    SET_DRAWER: 'SET_DRAWER',
+    SET_ITEMS: 'SET_ITEMS',
+    SET_FORM_DATA: 'SET_FORM_DATA',
+    SET_DISABLE_SAVE_BUTTON: 'SET_DISABLE_SAVE_BUTTON',
+    SET_INPUT_FIELD: 'SET_INPUT_FIELD',
+    SET_ERRORS: 'SET_ERRORS',
+};
+// ============================================================================
+// GENERIC REDUCER FACTORY
+// ============================================================================
+var createGenericReducer = function (config) {
+    return function (state, action) {
+        var _a;
+        switch (action.type) {
+            case exports.GENERIC_ACTION_TYPES.RESET_FORM: {
+                var current = state;
+                return __assign(__assign(__assign({}, state), config.initialState), { count: current.count, currentPage: current.currentPage, items: current.items, pageLimit: current.pageLimit, searchQuery: current.searchQuery });
+            }
+            case exports.GENERIC_ACTION_TYPES.SET_CURRENT_PAGE:
+                return __assign(__assign({}, state), { currentPage: action.payload.currentPage });
+            case exports.GENERIC_ACTION_TYPES.SET_PAGE_LIMIT:
+                return __assign(__assign({}, state), { pageLimit: action.payload.pageLimit });
+            case exports.GENERIC_ACTION_TYPES.SET_SEARCH_QUERY:
+                return __assign(__assign({}, state), { searchQuery: action.payload.searchQuery });
+            case exports.GENERIC_ACTION_TYPES.SET_DRAWER:
+                return __assign(__assign({}, state), { drawer: action.payload.drawer });
+            case exports.GENERIC_ACTION_TYPES.SET_ITEMS:
+                return __assign(__assign({}, state), { items: action.payload.items, count: action.payload.count });
+            case exports.GENERIC_ACTION_TYPES.SET_FORM_DATA:
+                return __assign(__assign({}, state), action.payload.form);
+            case exports.GENERIC_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON:
+                return __assign(__assign({}, state), { disableSaveButton: action.payload.disabled });
+            case exports.GENERIC_ACTION_TYPES.SET_INPUT_FIELD:
+                return __assign(__assign({}, state), (_a = {}, _a[action.payload.key] = action.payload.value, _a));
+            case exports.GENERIC_ACTION_TYPES.SET_ERRORS:
+                return __assign(__assign({}, state), { errors: action.payload.errors });
+            default:
+                return state;
+        }
+    };
+};
+exports.createGenericReducer = createGenericReducer;
+// ============================================================================
+// GENERIC MODULE HOOK FACTORY
+// ============================================================================
+var createGenericModuleHook = function (config) {
+    return function () {
+        var _a = (0, react_1.useReducer)((0, exports.createGenericReducer)(config), config.initialState), state = _a[0], dispatch = _a[1];
+        return {
+            state: state,
+            dispatch: dispatch,
+        };
+    };
+};
+exports.createGenericModuleHook = createGenericModuleHook;
+// ============================================================================
+// GENERIC PROVIDER FACTORY
+// ============================================================================
+var createGenericModuleProvider = function (config) {
+    var GenericContext = react_1.default.createContext(undefined);
+    var GenericProvider = function (_a) {
+        var children = _a.children;
+        var useGenericModule = (0, exports.createGenericModuleHook)(config);
+        var contextValue = useGenericModule();
+        return (react_1.default.createElement(GenericContext.Provider, { value: contextValue }, children));
+    };
+    var useGenericModuleContext = function () {
+        var context = react_1.default.useContext(GenericContext);
+        if (context === undefined) {
+            throw new Error("useGenericModuleContext must be used within GenericProvider for ".concat(config.name));
+        }
+        return context;
+    };
+    return {
+        Provider: GenericProvider,
+        useContext: useGenericModuleContext,
+        Context: GenericContext,
+    };
+};
+exports.createGenericModuleProvider = createGenericModuleProvider;
+// ============================================================================
+// MAIN MODULE FACTORY
+// ============================================================================
+var createGenericModule = function (config) {
+    var reducer = (0, exports.createGenericReducer)(config);
+    var _a = (0, exports.createGenericModuleProvider)(config), Provider = _a.Provider, useContext = _a.useContext;
+    return {
+        reducer: reducer,
+        Provider: Provider,
+        useContext: useContext,
+        config: config,
+        actionTypes: exports.GENERIC_ACTION_TYPES,
+        initialState: config.initialState,
+    };
+};
+exports.createGenericModule = createGenericModule;

package/factory/index.d.ts

@@ -0,0 +1,2 @@
+export * from './generic-component-factory';
+export * from './generic-module-factory';

package/factory/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./generic-component-factory"), exports);
+__exportStar(require("./generic-module-factory"), exports);

package/hooks/use-rtl.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Hook to detect RTL (Right-to-Left) layout based on current locale
+ * @returns {boolean} true if current locale requires RTL layout (Urdu), false otherwise
+ */
+export declare const useRTL: () => boolean;
+/**
+ * Hook to get RTL-aware CSS classes
+ *
+ * @returns Object containing common RTL-aware class combinations
+ *
+ * @example
+ * ```tsx
+ * const rtlClasses = useRTLClasses();
+ *
+ * // For icon buttons (ensures proper centering in RTL)
+ * <Button size="icon" className={`h-8 w-8 ${rtlClasses.iconButton}`}>
+ *   <Icon />
+ * </Button>
+ *
+ * // For buttons with icon and text
+ * <Button className={rtlClasses.iconWithText("left")}>
+ *   <Icon />
+ *   <span>Button Text</span>
+ * </Button>
+ * ```
+ */
+export declare const useRTLClasses: () => {
+    isRTL: boolean;
+    container: string;
+    direction: string;
+    flexRow: string;
+    flexRowReverse: string;
+    textAlign: string;
+    textAlignReverse: string;
+    marginLeft: string;
+    marginRight: string;
+    paddingLeft: (size: string) => string;
+    paddingRight: (size: string) => string;
+    gap: (size: string) => string;
+    roundedLeft: string;
+    roundedRight: string;
+    iconButton: string;
+    iconWithText: (iconPosition?: "left" | "right") => "flex items-center flex-row-reverse gap-2" | "flex items-center gap-2";
+};

package/hooks/use-rtl.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRTLClasses = exports.useRTL = void 0;
+var next_intl_1 = require("next-intl");
+/**
+ * Hook to detect RTL (Right-to-Left) layout based on current locale
+ * @returns {boolean} true if current locale requires RTL layout (Urdu), false otherwise
+ */
+var useRTL = function () {
+    var locale = (0, next_intl_1.useLocale)();
+    return locale === 'ur';
+};
+exports.useRTL = useRTL;
+/**
+ * Hook to get RTL-aware CSS classes
+ *
+ * @returns Object containing common RTL-aware class combinations
+ *
+ * @example
+ * ```tsx
+ * const rtlClasses = useRTLClasses();
+ *
+ * // For icon buttons (ensures proper centering in RTL)
+ * <Button size="icon" className={`h-8 w-8 ${rtlClasses.iconButton}`}>
+ *   <Icon />
+ * </Button>
+ *
+ * // For buttons with icon and text
+ * <Button className={rtlClasses.iconWithText("left")}>
+ *   <Icon />
+ *   <span>Button Text</span>
+ * </Button>
+ * ```
+ */
+var useRTLClasses = function () {
+    var isRTL = (0, exports.useRTL)();
+    return {
+        isRTL: isRTL,
+        // Container classes
+        container: isRTL ? 'rtl' : 'ltr',
+        direction: isRTL ? 'rtl' : 'ltr',
+        // Flex classes
+        flexRow: isRTL ? 'flex-row-reverse' : 'flex-row',
+        flexRowReverse: isRTL ? 'flex-row' : 'flex-row-reverse',
+        // Text alignment
+        textAlign: isRTL ? 'text-right' : 'text-left',
+        textAlignReverse: isRTL ? 'text-left' : 'text-right',
+        // Margin classes
+        marginLeft: isRTL ? 'mr-auto' : 'ml-auto',
+        marginRight: isRTL ? 'ml-auto' : 'mr-auto',
+        // Padding classes
+        paddingLeft: function (size) { return (isRTL ? "pr-".concat(size) : "pl-".concat(size)); },
+        paddingRight: function (size) { return (isRTL ? "pl-".concat(size) : "pr-".concat(size)); },
+        // Gap and spacing
+        gap: function (size) { return "gap-".concat(size); },
+        // Border radius (for buttons, cards, etc.)
+        roundedLeft: isRTL ? 'rounded-r' : 'rounded-l',
+        roundedRight: isRTL ? 'rounded-l' : 'rounded-r',
+        // Icon button classes for proper centering in RTL
+        iconButton: 'flex items-center justify-center border',
+        // Icon with text combinations
+        iconWithText: function (iconPosition) {
+            if (iconPosition === void 0) { iconPosition = 'left'; }
+            if (iconPosition === 'left') {
+                return isRTL
+                    ? 'flex items-center flex-row-reverse gap-2'
+                    : 'flex items-center gap-2';
+            }
+            return isRTL
+                ? 'flex items-center gap-2'
+                : 'flex items-center flex-row-reverse gap-2';
+        },
+    };
+};
+exports.useRTLClasses = useRTLClasses;

package/index.d.ts

@@ -23,6 +23,7 @@ export * from './api/stellar-solutions/quote-invoice';
 export * from './api/stellar-solutions/tax';
 export * from './api/stellar-solutions/type';
 export * from './constants';
+export * from './factory';
 export * from './general';
 export * from './hooks';
 export * from './local-storage';

package/index.js

@@ -39,6 +39,7 @@ __exportStar(require("./api/stellar-solutions/quote-invoice"), exports);
 __exportStar(require("./api/stellar-solutions/tax"), exports);
 __exportStar(require("./api/stellar-solutions/type"), exports);
 __exportStar(require("./constants"), exports);
+__exportStar(require("./factory"), exports);
 __exportStar(require("./general"), exports);
 __exportStar(require("./hooks"), exports);
 __exportStar(require("./local-storage"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-pakistan/util-functions",
-  "version": "1.25.32",
+  "version": "1.25.33",
   "description": "A library of all util functions",
   "main": "index.js",
   "scripts": {
@@ -47,6 +47,7 @@
   "homepage": "https://github.com/react-pakistan/util-functions#readme",
   "devDependencies": {
     "@appcorp/app-corp-vista": "^0.1.20",
+    "@appcorp/shadcn": "^1.1.43",
     "@babel/core": "^7.24.5",
     "@babel/preset-typescript": "^7.24.1",
     "@eslint/js": "^9.17.0",
@@ -74,6 +75,7 @@
     "lodash.curry": "^4.1.1",
     "lodash.isequal": "^4.5.0",
     "next": "^15",
+    "next-intl": "^4.8.3",
     "prettier": "^3.4.2",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",