@admin-layout/tailwind-design-pro 11.0.4-alpha.4 → 11.2.1-alpha.1

package/lib/tailwindConfig.d.ts

@@ -0,0 +1,100 @@
+export declare const themeConfig: {
+    colors: {
+        border: string;
+        input: string;
+        ring: string;
+        background: string;
+        foreground: string;
+        primary: {
+            DEFAULT: string;
+            foreground: string;
+        };
+        secondary: {
+            DEFAULT: string;
+            foreground: string;
+        };
+        destructive: {
+            DEFAULT: string;
+            foreground: string;
+        };
+        muted: {
+            DEFAULT: string;
+            foreground: string;
+        };
+        accent: {
+            DEFAULT: string;
+            foreground: string;
+        };
+        popover: {
+            DEFAULT: string;
+            foreground: string;
+        };
+        card: {
+            DEFAULT: string;
+            foreground: string;
+        };
+        sidebar: {
+            DEFAULT: string;
+            foreground: string;
+            primary: string;
+            'primary-foreground': string;
+            accent: string;
+            'accent-foreground': string;
+            border: string;
+            ring: string;
+        };
+        brand: {
+            primary: string;
+            secondary: string;
+            accent: string;
+        };
+        success: string;
+        warning: string;
+        error: string;
+        info: string;
+    };
+    backgroundImage: {
+        'gradient-primary': string;
+        'gradient-secondary': string;
+        'gradient-brand': string;
+    };
+    boxShadow: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+    };
+    transitionProperty: {
+        colors: string;
+        transform: string;
+        all: string;
+    };
+    borderRadius: {
+        lg: string;
+        md: string;
+        sm: string;
+    };
+    keyframes: {
+        'accordion-down': {
+            from: {
+                height: string;
+            };
+            to: {
+                height: string;
+            };
+        };
+        'accordion-up': {
+            from: {
+                height: string;
+            };
+            to: {
+                height: string;
+            };
+        };
+    };
+    animation: {
+        'accordion-down': string;
+        'accordion-up': string;
+    };
+};
+//# sourceMappingURL=tailwindConfig.d.ts.map

package/lib/tailwindConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwindConfig.d.ts","sourceRoot":"","sources":["../src/tailwindConfig.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoGvB,CAAC"}

package/lib/tailwindConfig.js

@@ -0,0 +1,101 @@
+const themeConfig = {
+  colors: {
+    border: 'hsl(var(--border))',
+    input: 'hsl(var(--input))',
+    ring: 'hsl(var(--ring))',
+    background: 'hsl(var(--background))',
+    foreground: 'hsl(var(--foreground))',
+    primary: {
+      DEFAULT: 'hsl(var(--primary))',
+      foreground: 'hsl(var(--primary-foreground))'
+    },
+    secondary: {
+      DEFAULT: 'hsl(var(--secondary))',
+      foreground: 'hsl(var(--secondary-foreground))'
+    },
+    destructive: {
+      DEFAULT: 'hsl(var(--destructive))',
+      foreground: 'hsl(var(--destructive-foreground))'
+    },
+    muted: {
+      DEFAULT: 'hsl(var(--muted))',
+      foreground: 'hsl(var(--muted-foreground))'
+    },
+    accent: {
+      DEFAULT: 'hsl(var(--accent))',
+      foreground: 'hsl(var(--accent-foreground))'
+    },
+    popover: {
+      DEFAULT: 'hsl(var(--popover))',
+      foreground: 'hsl(var(--popover-foreground))'
+    },
+    card: {
+      DEFAULT: 'hsl(var(--card))',
+      foreground: 'hsl(var(--card-foreground))'
+    },
+    sidebar: {
+      DEFAULT: 'hsl(var(--sidebar-background))',
+      foreground: 'hsl(var(--sidebar-foreground))',
+      primary: 'hsl(var(--sidebar-primary))',
+      'primary-foreground': 'hsl(var(--sidebar-primary-foreground))',
+      accent: 'hsl(var(--sidebar-accent))',
+      'accent-foreground': 'hsl(var(--sidebar-accent-foreground))',
+      border: 'hsl(var(--sidebar-border))',
+      ring: 'hsl(var(--sidebar-ring))'
+    },
+    // Brand colors
+    brand: {
+      primary: 'hsl(var(--brand-primary))',
+      secondary: 'hsl(var(--brand-secondary))',
+      accent: 'hsl(var(--brand-accent))'
+    },
+    // Semantic colors
+    success: 'hsl(var(--success))',
+    warning: 'hsl(var(--warning))',
+    error: 'hsl(var(--error))',
+    info: 'hsl(var(--info))'
+  },
+  backgroundImage: {
+    'gradient-primary': 'var(--gradient-primary)',
+    'gradient-secondary': 'var(--gradient-secondary)',
+    'gradient-brand': 'var(--gradient-brand)'
+  },
+  boxShadow: {
+    sm: 'var(--shadow-sm)',
+    md: 'var(--shadow-md)',
+    lg: 'var(--shadow-lg)',
+    xl: 'var(--shadow-xl)'
+  },
+  transitionProperty: {
+    colors: 'var(--transition-colors)',
+    transform: 'var(--transition-transform)',
+    all: 'var(--transition-all)'
+  },
+  borderRadius: {
+    lg: 'var(--radius)',
+    md: 'calc(var(--radius) - 2px)',
+    sm: 'calc(var(--radius) - 4px)'
+  },
+  keyframes: {
+    'accordion-down': {
+      from: {
+        height: '0'
+      },
+      to: {
+        height: 'var(--radix-accordion-content-height)'
+      }
+    },
+    'accordion-up': {
+      from: {
+        height: 'var(--radix-accordion-content-height)'
+      },
+      to: {
+        height: '0'
+      }
+    }
+  },
+  animation: {
+    'accordion-down': 'accordion-down 0.2s ease-out',
+    'accordion-up': 'accordion-up 0.2s ease-out'
+  }
+};export{themeConfig};//# sourceMappingURL=tailwindConfig.js.map

package/lib/tailwindConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwindConfig.js","sources":["../src/tailwindConfig.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAO,MAAM,WAAW,GAAG;AACvB,EAAA,MAAA,EAAM;AACF,IAAA,MAAA,EAAA,oBAAQ;AACR,IAAA,KAAA,EAAA,mBAAO;AACP,IAAA,IAAA,EAAA,kBAAM;AACN,IAAA,UAAA,EAAA,wBAAY;AACZ,IAAA,UAAA,EAAA,wBAAY;AACZ,IAAA,OAAA,EAAA;AACI,MAAA,OAAA,EAAA,qBAAS;AACT,MAAA,UAAA,EAAA;AACH,KAAA;AACD,IAAA,SAAA,EAAA;AACI,MAAA,OAAA,EAAA,uBAAS;AACT,MAAA,UAAA,EAAA;AACH,KAAA;AACD,IAAA,WAAA,EAAA;AACI,MAAA,OAAA,EAAA,yBAAS;AACT,MAAA,UAAA,EAAA;AACH,KAAA;AACD,IAAA,KAAA,EAAA;AACI,MAAA,OAAA,EAAA,mBAAS;AACT,MAAA,UAAA,EAAA;AACH,KAAA;AACD,IAAA,MAAA,EAAA;AACI,MAAA,OAAA,EAAA,oBAAS;AACT,MAAA,UAAA,EAAA;AACH,KAAA;AACD,IAAA,OAAA,EAAA;AACI,MAAA,OAAA,EAAA,qBAAS;AACT,MAAA,UAAA,EAAA;AACH,KAAA;AACD,IAAA,IAAA,EAAA;AACI,MAAA,OAAA,EAAA,kBAAS;AACT,MAAA,UAAA,EAAA;AACH,KAAA;AACD,IAAA,OAAA,EAAA;AACI,MAAA,OAAA,EAAA,gCAAS;AACT,MAAA,UAAA,EAAA,gCAAY;AACZ,MAAA,OAAA,EAAA,6BAAS;AACT,MAAA,oBAAA,EAAA,wCAAsB;AACtB,MAAA,MAAA,EAAA,4BAAQ;AACR,MAAA,mBAAA,EAAA,uCAAqB;AACrB,MAAA,MAAA,EAAA,4BAAQ;AACR,MAAA,IAAA,EAAA;AACH,KAAA;;AAED,IAAA,KAAA,EAAA;AACI,MAAA,OAAA,EAAA,2BAAS;AACT,MAAA,SAAA,EAAA,6BAAW;AACX,MAAA,MAAA,EAAA;AACH,KAAA;;AAED,IAAA,OAAA,EAAA,qBAAS;AACT,IAAA,OAAA,EAAA,qBAAS;AACT,IAAA,KAAA,EAAA,mBAAO;AACP,IAAA,IAAA,EAAA;AACH,GAAA;AACD,EAAA,eAAA,EAAe;AACX,IAAA,kBAAA,EAAA,yBAAoB;AACpB,IAAA,oBAAA,EAAA,2BAAsB;AACtB,IAAA,gBAAA,EAAA;AACH,GAAA;AACD,EAAA,SAAA,EAAS;AACL,IAAA,EAAA,EAAA,kBAAI;AACJ,IAAA,EAAA,EAAA,kBAAI;AACJ,IAAA,EAAA,EAAA,kBAAI;AACJ,IAAA,EAAA,EAAA;AACH,GAAA;AACD,EAAA,kBAAA,EAAkB;AACd,IAAA,MAAA,EAAA,0BAAQ;AACR,IAAA,SAAA,EAAA,6BAAW;AACX,IAAA,GAAA,EAAA;AACH,GAAA;AACD,EAAA,YAAA,EAAY;AACR,IAAA,EAAA,EAAA,eAAI;AACJ,IAAA,EAAA,EAAA,2BAAI;AACJ,IAAA,EAAA,EAAA;AACH,GAAA;AACD,EAAA,SAAA,EAAS;AACL,IAAA,gBAAA,EAAA;AACI,MAAA,IAAA,EAAA;AACI,QAAA,MAAA,EAAA;AACH,OAAA;AACD,MAAA,EAAA,EAAA;AACI,QAAA,MAAA,EAAA;AACH;AACJ,KAAA;AACD,IAAA,cAAA,EAAA;AACI,MAAA,IAAA,EAAA;AACI,QAAA,MAAA,EAAA;AACH,OAAA;AACD,MAAA,EAAA,EAAA;AACI,QAAA,MAAA,EAAA;AACH;AACJ;AACJ,GAAA;AACD,EAAA,SAAA,EAAS;AACL,IAAA,gBAAA,EAAA,8BAAkB;AAClB,IAAA,cAAA,EAAA;AACH;"}

package/lib/utils/__tests__/analytics-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analytics-utils.test.d.ts.map

package/lib/utils/__tests__/analytics-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-utils.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/analytics-utils.test.ts"],"names":[],"mappings":""}

package/lib/utils/__tests__/configOverrides.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=configOverrides.test.d.ts.map

package/lib/utils/__tests__/configOverrides.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configOverrides.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/configOverrides.test.ts"],"names":[],"mappings":""}

package/lib/utils/__tests__/menu.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=menu.test.d.ts.map

package/lib/utils/__tests__/menu.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/menu.test.ts"],"names":[],"mappings":""}

package/lib/utils/__tests__/selectors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=selectors.test.d.ts.map

package/lib/utils/__tests__/selectors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/selectors.test.ts"],"names":[],"mappings":""}

package/lib/utils/__tests__/settingsMachine.test.d.ts

@@ -0,0 +1,2 @@
+import 'reflect-metadata';
+//# sourceMappingURL=settingsMachine.test.d.ts.map

package/lib/utils/__tests__/settingsMachine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settingsMachine.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/settingsMachine.test.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC"}

package/lib/utils/__tests__/settingsUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=settingsUtils.test.d.ts.map

package/lib/utils/__tests__/settingsUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settingsUtils.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/settingsUtils.test.ts"],"names":[],"mappings":""}

package/lib/utils/analytics-utils.d.ts

@@ -0,0 +1,43 @@
+export interface GA4EventParams {
+    page_location?: string;
+    page_referrer?: string;
+    page_title?: string;
+    user_id?: string;
+    search_term?: string;
+    currency?: string;
+    value?: number;
+    items?: Array<{
+        item_id: string;
+        item_name: string;
+        item_category?: string;
+        price?: number;
+        quantity?: number;
+        [key: string]: any;
+    }>;
+    [key: string]: any;
+}
+/**
+ * Helper function to format property data for GA4 item tracking
+ */
+export declare const formatPropertyForGA4: (property: any) => GA4EventParams["items"][0];
+/**
+ * Helper function to create standard GA4 page view event params
+ */
+export declare const createPageViewParams: (pageTitle: string, additionalParams?: GA4EventParams) => GA4EventParams;
+/**
+ * Helper function to create standard GA4 search event params
+ */
+export declare const createSearchParams: (searchTerm: string, additionalParams?: GA4EventParams) => GA4EventParams;
+/**
+ * Helper function to track user engagement events
+ */
+export declare const trackUserEngagement: (analytics: any, eventName: string, params?: GA4EventParams) => void;
+/**
+ * Helper function to track property views
+ */
+export declare const trackPropertyView: (analytics: any, property: any) => void;
+/**
+ * Helper function to track property searches
+ */
+export declare const trackPropertySearch: (analytics: any, searchTerm: string, filters?: Record<string, any>) => void;
+//# sourceMappingURL=analytics-utils.d.ts.map

package/lib/utils/analytics-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-utils.d.ts","sourceRoot":"","sources":["../../src/utils/analytics-utils.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAE3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACtB,CAAC,CAAC;IAGH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,GAAG,KAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAU7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,WAAW,MAAM,EAAE,mBAAmB,cAAc,KAAG,cAO3F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,YAAY,MAAM,EAAE,mBAAmB,cAAc,KAAG,cAK1F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,GAAG,EAAE,WAAW,MAAM,EAAE,SAAS,cAAc,SAK7F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,GAAG,EAAE,UAAU,GAAG,SAG9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,GAAG,EAAE,YAAY,MAAM,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,SAIpG,CAAC"}

package/lib/utils/analytics.d.ts

@@ -0,0 +1,48 @@
+import { GA4EventParams } from './analytics-utils';
+/**
+ * Initialize Google Analytics
+ * @param {string} measurementId - Google Analytics measurement ID (GA4)
+ */
+export declare const initGA: (measurementId: string) => void;
+/**
+ * Track a GA4 standard event
+ * @param {string} eventName - GA4 event name
+ * @param {GA4EventParams} eventParams - Event parameters
+ */
+export declare const trackGA4Event: (eventName: string, eventParams?: GA4EventParams) => void;
+/**
+ * Check if Google Analytics is initialized
+ * @returns {boolean} Whether GA is initialized
+ */
+export declare const isGAInitialized: () => boolean;
+/**
+ * Track page views
+ * @param {string} path - URL path to track
+ * @param {string} title - Page title
+ */
+export declare const trackPageView: (path: string, title?: string) => void;
+/**
+ * Track events
+ * @param {string} category - Event category
+ * @param {string} action - Event action
+ * @param {string} label - Event label (optional)
+ * @param {number} value - Event value (optional)
+ */
+export declare const trackEvent: (category: string, action: string, label?: string, value?: number) => void;
+/**
+ * Track exception events
+ * @param {string} description - Error description
+ * @param {boolean} fatal - Whether the error was fatal
+ */
+export declare const trackException: (description: string, fatal?: boolean) => void;
+/**
+ * Track user properties
+ * @param {Record<string, string | number | boolean>} properties - User properties to track
+ */
+export declare const setUserProperties: (properties: Record<string, string | number | boolean>) => void;
+/**
+ * Set user ID for cross-device tracking
+ * @param {string} userId - User ID
+ */
+export declare const setUserId: (userId: string) => void;
+//# sourceMappingURL=analytics.d.ts.map

package/lib/utils/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/utils/analytics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAInD;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,eAAe,MAAM,KAAG,IAmF9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,EAAE,cAAc,cAAc,KAAG,IAiB/E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,OAElC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,IAsB5D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,EAAE,QAAQ,MAAM,EAAE,QAAQ,MAAM,EAAE,QAAQ,MAAM,KAAG,IA0B7F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,EAAE,QAAO,OAAe,KAAG,IAmB5E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,KAAG,IAiBzF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,IAsB1C,CAAC"}

package/lib/utils/configOverrides.d.ts

@@ -0,0 +1,213 @@
+/**
+ * Configuration Override System
+ *
+ * This module implements a VS Code-style configuration override pattern.
+ * Instead of deeply nested route and device-specific settings, we use a nested
+ * structure with context keys for overrides.
+ *
+ * ## Pattern
+ *
+ * Base configuration:
+ * ```
+ * uilayout.regions.header.showLogo = true
+ * ```
+ *
+ * Override for specific route and device:
+ * ```
+ * [route=/dashboard][device=mobile]: {
+ *   uilayout: {
+ *     regions: {
+ *       header: {
+ *         showLogo: false
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * ## Benefits
+ *
+ * 1. **Flat Schema**: Configuration schema is defined once, not duplicated per route/device
+ * 2. **Clear Inheritance**: Easy to see what's overridden and what uses defaults
+ * 3. **Flexibility**: Can add new context dimensions (e.g., [user=admin], [theme=dark])
+ * 4. **Database Friendly**: Nested structure is natural for MongoDB
+ * 5. **Type Safe**: TypeScript can enforce config keys
+ *
+ * ## Usage in MongoDB
+ *
+ * ```json
+ * {
+ *   "uiSettings": {
+ *     "uilayout": {
+ *       "regions": {
+ *         "header": {
+ *           "showLogo": true
+ *         }
+ *       }
+ *     },
+ *     "[route=/dashboard][device=mobile]": {
+ *       "uilayout": {
+ *         "regions": {
+ *           "header": {
+ *             "showLogo": false
+ *           }
+ *         }
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export interface OverrideContext {
+    route?: string;
+    device?: 'desktop' | 'mobile';
+    theme?: string;
+    user?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Parse multiple bracket pattern into array of identifiers
+ * Supports both single bracket [/route.mobile] and multiple bracket [/route][mobile] patterns
+ *
+ * @example
+ * parseMultipleBracketIdentifiers("[/dashboard][mobile]")
+ * // Returns: ['/dashboard', 'mobile']
+ *
+ * parseMultipleBracketIdentifiers("[mobile]")
+ * // Returns: ['mobile']
+ *
+ * parseMultipleBracketIdentifiers("[/dashboard.mobile]") // Backward compatibility
+ * // Returns: ['/dashboard', 'mobile']
+ */
+export declare function parseMultipleBracketIdentifiers(overrideKey: string): string[];
+/**
+ * Build multiple bracket pattern from identifiers array
+ *
+ * @example
+ * buildMultipleBracketKey(['/dashboard', 'mobile'])
+ * // Returns: "[/dashboard][mobile]"
+ *
+ * buildMultipleBracketKey(['mobile'])
+ * // Returns: "[mobile]"
+ */
+export declare function buildMultipleBracketKey(identifiers: string[]): string;
+/**
+ * Build multiple bracket pattern from context object
+ * Uses the new multiple bracket format: [/route][device]
+ *
+ * @example
+ * buildMultipleBracketKeyFromContext({ route: '/dashboard', device: 'mobile' })
+ * // Returns: "[/dashboard][mobile]"
+ *
+ * buildMultipleBracketKeyFromContext({ device: 'mobile' })
+ * // Returns: "[mobile]"
+ */
+export declare function buildMultipleBracketKeyFromContext(context: OverrideContext): string;
+/**
+ * Convert multiple bracket pattern to context object
+ *
+ * @example
+ * multipleBracketToContext("[/dashboard][mobile]")
+ * // Returns: { route: '/dashboard', device: 'mobile' }
+ */
+export declare function multipleBracketToContext(overrideKey: string): OverrideContext;
+/**
+ * Convert a dot-notation path to a nested object
+ * @example
+ * setNestedValue({}, 'uilayout.regions.header.showLogo', false)
+ * // Returns: { uilayout: { regions: { header: { showLogo: false } } } }
+ */
+export declare function setNestedValue(obj: any, path: string, value: any): any;
+/**
+ * Get a value from a nested object using dot notation
+ * @example
+ * getNestedValue({ uilayout: { regions: { header: { showLogo: false } } } }, 'uilayout.regions.header.showLogo')
+ * // Returns: false
+ */
+export declare function getNestedValue(obj: any, path: string, defaultValue?: any): any;
+/**
+ * Deep merge two objects
+ */
+export declare function deepMerge(target: any, source: any): any;
+/**
+ * Build an override context key from context
+ *
+ * Format: [route][device] or [route] or [device]
+ *
+ * @example
+ * buildOverrideKey({ route: '/dashboard', device: 'mobile' })
+ * // Returns: "[/dashboard][mobile]"
+ *
+ * buildOverrideKey({ route: '/dashboard' })
+ * // Returns: "[/dashboard]"
+ *
+ * buildOverrideKey({ device: 'mobile' })
+ * // Returns: "[mobile]"
+ */
+export declare function buildOverrideKey(context: OverrideContext): string;
+/**
+ * Parse an override key into its components
+ * Supports both new multiple bracket format and legacy dot notation
+ *
+ * @example
+ * parseOverrideKey("[/dashboard][mobile]")  // New format
+ * // Returns: { route: '/dashboard', device: 'mobile' }
+ *
+ * parseOverrideKey("[/dashboard.mobile]")   // Legacy format
+ * // Returns: { route: '/dashboard', device: 'mobile' }
+ *
+ * parseOverrideKey("[/dashboard]")
+ * // Returns: { route: '/dashboard' }
+ *
+ * parseOverrideKey("[mobile]")
+ * // Returns: { device: 'mobile' }
+ *
+ * parseOverrideKey("[.mobile]")  // Legacy device-only format
+ * // Returns: { device: 'mobile' }
+ */
+export declare function parseOverrideKey(overrideKey: string): OverrideContext;
+/**
+ * Get a configuration value with override support
+ *
+ * Priority:
+ * 1. Most specific override (all context matches)
+ * 2. Partial overrides (some context matches)
+ * 3. Base configuration value
+ * 4. Default value
+ *
+ * Works with nested storage where overrides are stored as:
+ * { "[route=/dashboard][device=mobile]": { uilayout: { regions: { header: { showLogo: false } } } } }
+ */
+export declare function getConfigValue<T = any>(settings: any, configKey: string, context: OverrideContext, defaultValue?: T): T;
+/**
+ * Set a configuration value as an override
+ *
+ * Returns the context key and nested value structure.
+ * The service layer will merge this into the settings object.
+ *
+ * @example
+ * const result = setConfigOverride('regions.header.showLogo', false, { route: '/dashboard', device: 'mobile' });
+ * // Returns: {
+ * //   contextKey: '[device=mobile][route=/dashboard]',
+ * //   path: 'uilayout.regions.header.showLogo',
+ * //   value: false,
+ * //   nestedValue: { uilayout: { regions: { header: { showLogo: false } } } }
+ * // }
+ */
+export declare function setConfigOverride(configKey: string, value: any, context: OverrideContext): {
+    contextKey: string;
+    path: string;
+    value: any;
+    nestedValue: any;
+};
+/**
+ * Get all overrides for a specific context
+ * Works with nested storage format
+ */
+export declare function getContextOverrides(settings: any, context: OverrideContext): Record<string, any>;
+/**
+ * Remove all overrides for a specific context
+ * Returns the context key to remove from settings
+ */
+export declare function clearContextOverrides(settings: any, context: OverrideContext): string | null;
+//# sourceMappingURL=configOverrides.d.ts.map

package/lib/utils/configOverrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configOverrides.d.ts","sourceRoot":"","sources":["../../src/utils/configOverrides.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAEH,MAAM,WAAW,eAAe;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CA2C7E;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAMrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAqBnF;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAoB7E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAiBtE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,GAAG,CAY9E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,CAkBvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAyBjE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAiDrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,GAAG,EAClC,QAAQ,EAAE,GAAG,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,EACxB,YAAY,CAAC,EAAE,CAAC,GACjB,CAAC,CAoEH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC7B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,GAAG,EACV,OAAO,EAAE,eAAe,GACzB;IACC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,GAAG,CAAC;IACX,WAAW,EAAE,GAAG,CAAC;CACpB,CAWA;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAShG;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAQ5F"}

package/lib/utils/configOverrides.js

@@ -0,0 +1,91 @@
+/**
+ * Configuration Override System
+ *
+ * This module implements a VS Code-style configuration override pattern.
+ * Instead of deeply nested route and device-specific settings, we use a nested
+ * structure with context keys for overrides.
+ *
+ * ## Pattern
+ *
+ * Base configuration:
+ * ```
+ * uilayout.regions.header.showLogo = true
+ * ```
+ *
+ * Override for specific route and device:
+ * ```
+ * [route=/dashboard][device=mobile]: {
+ *   uilayout: {
+ *     regions: {
+ *       header: {
+ *         showLogo: false
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * ## Benefits
+ *
+ * 1. **Flat Schema**: Configuration schema is defined once, not duplicated per route/device
+ * 2. **Clear Inheritance**: Easy to see what's overridden and what uses defaults
+ * 3. **Flexibility**: Can add new context dimensions (e.g., [user=admin], [theme=dark])
+ * 4. **Database Friendly**: Nested structure is natural for MongoDB
+ * 5. **Type Safe**: TypeScript can enforce config keys
+ *
+ * ## Usage in MongoDB
+ *
+ * ```json
+ * {
+ *   "uiSettings": {
+ *     "uilayout": {
+ *       "regions": {
+ *         "header": {
+ *           "showLogo": true
+ *         }
+ *       }
+ *     },
+ *     "[route=/dashboard][device=mobile]": {
+ *       "uilayout": {
+ *         "regions": {
+ *           "header": {
+ *             "showLogo": false
+ *           }
+ *         }
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Parse multiple bracket pattern into array of identifiers
+ * Supports both single bracket [/route.mobile] and multiple bracket [/route][mobile] patterns
+ *
+ * @example
+ * parseMultipleBracketIdentifiers("[/dashboard][mobile]")
+ * // Returns: ['/dashboard', 'mobile']
+ *
+ * parseMultipleBracketIdentifiers("[mobile]")
+ * // Returns: ['mobile']
+ *
+ * parseMultipleBracketIdentifiers("[/dashboard.mobile]") // Backward compatibility
+ * // Returns: ['/dashboard', 'mobile']
+ */
+/**
+ * Get a value from a nested object using dot notation
+ * @example
+ * getNestedValue({ uilayout: { regions: { header: { showLogo: false } } } }, 'uilayout.regions.header.showLogo')
+ * // Returns: false
+ */
+function getNestedValue(obj, path, defaultValue) {
+  const keys = path.split('.');
+  let current = obj;
+  for (const key of keys) {
+    if (current === null || current === undefined || typeof current !== 'object') {
+      return defaultValue;
+    }
+    current = current[key];
+  }
+  return current !== undefined ? current : defaultValue;
+}export{getNestedValue};//# sourceMappingURL=configOverrides.js.map

package/lib/utils/configOverrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configOverrides.js","sources":["../../src/utils/configOverrides.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2DG;AAUH;;;;;;;;;;;;;AAaG;;AA6JA;AACH;;;AAII;AACI,SAAI,cAAgB,CAAA,GAAI,EAAA,IAAO,EAAA,YAAc,EAAA;AACzC,EAAA,MAAA,IAAA,GAAA,IAAO;aACV,GAAA,GAAA;AACD,EAAA,KAAA,MAAA,GAAO,IAAG,IAAA,EAAQ;IACtB,IAAC,OAAA,KAAA,IAAA,IAAA,OAAA,KAAA,SAAA,IAAA,OAAA,OAAA,KAAA,QAAA,EAAA;MAED,OAAO,YAAY;AACvB,IAAC;AAED,IAAA,OAAA,GAAA,OAAA,CAAA,GAAA,CAAA;;AAEG,EAAA,OAAA,OAAA,KAAA,SAAA,GAAA,OAAA,GAAA,YAAA;AACH"}

package/lib/utils/formateCarData.d.ts

@@ -0,0 +1,2 @@
+export declare const formatCarRentalResponse: (data: any) => any;
+//# sourceMappingURL=formateCarData.d.ts.map