@admin-layout/tailwind-design-pro 12.0.16-alpha.6 → 12.0.16-alpha.62

package/lib/machines/settingsMachine.js

@@ -1,85 +1,25 @@
-import {defaultSettings}from'@admin-layout/client';import {createMachine,assign}from'xstate';import {SearchBarBehavior}from'./types.js';import {cloneDeep,set,merge}from'lodash-es';// Default route settings template
-const DEFAULT_LAYOUT = {
-  navigationMode: 'mixed',
-  sideMenuType: 'expanded',
-  contentWidth: 'fluid',
-  fixedHeader: true,
-  fixedSidebar: true,
-  splitMenus: false,
-  upperMenuDividerName: 'Navigation',
-  middleMenuDividerName: 'Dashboard',
-  lowerMenuDividerName: 'Admin'
-};
-// Default background settings
-const DEFAULT_BACKGROUND = {
-  type: 'color',
-  color: 'inherit',
-  image: '',
-  video: '',
-  videoThumbnail: ''
-};
-const DEFAULT_HEADER = {
-  showLogo: true,
-  showSearchSlot: true,
-  showRightContent: true,
-  showMenuToggle: true,
-  showBackButton: true,
-  showPageTitle: true,
-  showActionButtons: true,
-  position: 'fixed',
-  height: '64px',
-  elevation: 2,
-  showHeader: true,
-  showMenu: true,
-  menuHeaderRender: true,
-  searchBarRender: true,
-  searchBarBehavior: SearchBarBehavior.PERMANENT,
-  searchBarOverlay: true,
-  scrollThreshold: 50
-};
-// Shared view configuration similar to client's defaultSettings
-const SHARED_VIEW_CONFIG = {
-  layout: DEFAULT_LAYOUT,
-  regions: {
-    header: DEFAULT_HEADER,
-    footer: {
-      showFooter: true
-    },
-    background: DEFAULT_BACKGROUND
-  }
-};
-const defaultRouteSettings = {
-  layout: {
-    desktop: SHARED_VIEW_CONFIG.layout,
-    mobile: SHARED_VIEW_CONFIG.layout
-  },
-  regions: {
-    desktop: {
-      header: SHARED_VIEW_CONFIG.regions.header,
-      footer: SHARED_VIEW_CONFIG.regions.footer,
-      background: SHARED_VIEW_CONFIG.regions.background
-    },
-    mobile: {
-      header: SHARED_VIEW_CONFIG.regions.header,
-      footer: SHARED_VIEW_CONFIG.regions.footer,
-      background: SHARED_VIEW_CONFIG.regions.background
-    }
-  }
-};
-// Helper function to deep merge objects
-const deepMerge = (target, source) => {
-  const result = {
-    ...target
-  };
-  for (const key in source) {
-    if (source[key] instanceof Object && key in target) {
-      result[key] = deepMerge(target[key], source[key]);
-    } else {
-      result[key] = source[key];
-    }
-  }
-  return result;
-};
+import {cloneDeep,set}from'lodash-es';import {createMachine,assign}from'xstate';import {ConfigurationModel}from'@adminide-stack/core';/**
+ * SETTINGS MACHINE - COMPLETELY REFACTORED
+ *
+ * DESIGN PHILOSOPHY:
+ * This machine has been completely rewritten to eliminate any possibility of infinite loops
+ * by enforcing a strict separation between:
+ * 1. PUBLIC STATE: User-facing settings (stable, exposed to consumers)
+ * 2. INTERNAL STATE: Machine logic state (may have reference changes, never exposed)
+ *
+ * ARCHITECTURE:
+ * - Context is split into `public` and `internal` namespaces
+ * - Components ONLY access `context.public` via selectors
+ * - NO filtering is needed - separation is built into the structure
+ * - ConfigurationModel reference changes are isolated to `context.internal`
+ * - Redux receives ONLY `context.public` - no manual filtering required
+ *
+ * WHY THIS WORKS:
+ * - Reference changes in `context.internal.configModel` don't affect `context.public`
+ * - Components using selectors get stable references to `context.public`
+ * - No manual filtering means no chance of accidentally exposing internal state
+ * - Type system enforces the separation at compile time
+ */
 const settingsMachine = createMachine({
   id: 'settings',
   types: {},
@@ -87,115 +27,231 @@ const settingsMachine = createMachine({
   context: ({
     input
   }) => {
-    return merge({}, {
-      navTheme: defaultSettings.navTheme || 'light',
-      primaryColor: defaultSettings.primaryColor || '#1890ff',
-      secondaryColor: defaultSettings.secondaryColor || '#1890ff',
-      theme: defaultSettings.theme || 'default',
-      logo: defaultSettings.logo,
-      title: defaultSettings.title,
-      showSettingPanel: defaultSettings.showSettingPanel,
-      titleColor: defaultSettings.titleColor,
-      language: defaultSettings.language,
-      fontFamily: defaultSettings.fontFamily,
-      titleFontWeight: defaultSettings.titleFontWeight,
-      titleHeight: defaultSettings.titleHeight,
-      titleFontSize: defaultSettings.titleFontSize,
-      letterSpacings: defaultSettings.letterSpacings,
-      siderBgColor: defaultSettings.siderBgColor,
-      headerBgColor: defaultSettings.headerBgColor,
-      textColor: defaultSettings.textColor,
-      themeType: defaultSettings.themeType,
-      loginThemeColor: defaultSettings.loginThemeColor,
-      loginFormPosition: defaultSettings.loginFormPosition,
-      loginSocials: defaultSettings.loginSocials,
-      loginBackgroundImage: defaultSettings.loginBackgroundImage,
-      verifyFormLayout: defaultSettings.verifyFormLayout,
-      verifyFormImageUrl: defaultSettings.verifyFormImageUrl,
-      verifyFormBackgroundStyle: defaultSettings.verifyFormBackgroundStyle,
-      verifyFormVisibleFields: defaultSettings.verifyFormVisibleFields,
-      verifyFormShowSkipButton: defaultSettings.verifyFormShowSkipButton,
-      components: [],
-      activeComponent: null,
-      currentRoute: input?.settings?.currentRoute || '/',
-      routeSettings: {
-        '/': defaultRouteSettings
+    // Input settings are now flat: { logo: '...', theme: '...', [/route][device]: {...}, ... }
+    const rawSettings = input?.settings || {};
+    console.log('🔍 Context Init - Raw settings:', {
+      hasRawSettings: !!rawSettings,
+      rawSettingsKeys: rawSettings ? Object.keys(rawSettings).slice(0, 15) : []
+    });
+    // Settings are flat - no uilayout wrapper to handle
+    // Just separate base settings from bracket overrides
+    const cleanedSettings = rawSettings;
+    console.log('🔍 Context Init - Settings keys:', {
+      totalKeys: Object.keys(cleanedSettings).length,
+      bracketKeys: Object.keys(cleanedSettings).filter(k => k.startsWith('[') && k.endsWith(']'))
+    });
+    // Transform loader data into ConfigurationModel format
+    // Separate base settings from bracket overrides
+    const baseContents = {};
+    const overrides = [];
+    Object.keys(cleanedSettings).forEach(key => {
+      if (key.startsWith('[') && key.endsWith(']')) {
+        // This is a bracket override: [device] or [/route][device]
+        const overrideData = cleanedSettings[key];
+        overrides.push({
+          identifiers: [key],
+          contents: overrideData,
+          keys: Object.keys(overrideData)
+        });
+      } else {
+        // Base settings (flat, no wrapper)
+        baseContents[key] = cleanedSettings[key];
       }
-    }, input?.settings);
+    });
+    console.log('🔍 ConfigurationModel input:', {
+      baseKeys: Object.keys(baseContents),
+      overridesCount: overrides.length,
+      overrideIdentifiers: overrides.map(o => o.identifiers[0])
+    });
+    // ConfigurationModel handles ALL bracket patterns automatically
+    const configModel = new ConfigurationModel(baseContents, [], overrides);
+    // Get current route from input (passed from component) or default to '/'
+    const currentRoute = input?.currentRoute || '/';
+    const routePattern = input?.routePattern;
+    const deviceType = 'desktop'; // Default, will be updated by component
+    // Build override keys with fallback logic - use route pattern if available
+    const routeForBracket = routePattern || currentRoute;
+    const routeDeviceKey = `[${routeForBracket}][${deviceType}]`;
+    const deviceKey = `[${deviceType}]`;
+    // Apply overrides by chaining: base -> global -> route-specific
+    // First apply global override to base
+    const globalOverride = configModel.override(deviceKey);
+    // Then apply route-specific override on top of global
+    const routeOverride = globalOverride.override(routeDeviceKey);
+    // Extract final merged settings (already flat, no uilayout wrapper)
+    const mergedContents = routeOverride?.contents;
+    const effectiveSettings = mergedContents;
+    // Build PUBLIC settings (exposed to consumers)
+    // Build the UI settings object from all potential sources
+    const publicSettings = {
+      // Apply merged settings first
+      ...effectiveSettings,
+      components: effectiveSettings.components || [],
+      hiddenMenuKeys: effectiveSettings.hiddenMenuKeys || [],
+      hiddenMenuCategories: effectiveSettings.hiddenMenuCategories || []
+    };
+    // Build INTERNAL state (machine only, never exposed)
+    const internalState = {
+      configModel,
+      deviceType,
+      currentRoute,
+      changedSettings: {},
+      routePattern: input?.routePattern
+    };
+    // Return context with EXPLICIT separation
+    const context = {
+      public: publicSettings,
+      internal: internalState
+    };
+    console.log('🔍 Context Init - Final structure:', {
+      hasPublic: !!context.public,
+      hasInternal: !!context.internal,
+      publicKeys: Object.keys(context.public).slice(0, 10),
+      internalKeys: Object.keys(context.internal)
+    });
+    return context;
   },
   states: {
     idle: {
+      entry: ['updateReduxSettings'],
       on: {
-        UPDATE: {
+        UISETTING_UPDATE: {
           actions: [assign(({
             context,
             event
           }) => {
             if (!event.value) return context;
-            const newContext = cloneDeep({
-              ...context
-            });
-            // Handle top-level updates
-            if (event.value.navTheme !== undefined) {
-              newContext.navTheme = event.value.navTheme;
-            }
-            if (event.value.primaryColor !== undefined) {
-              newContext.primaryColor = event.value.primaryColor;
-            }
-            if (event.value.theme !== undefined) {
-              newContext.theme = event.value.theme;
-            }
-            // Add any new keys from event.value that don't exist in context
+            console.log('🔧 Machine UPDATE event:', event);
+            // Clone context to avoid mutations
+            const newContext = cloneDeep(context);
+            // Process each changed setting
             Object.keys(event.value).forEach(key => {
-              set(newContext, key, event.value[key]);
+              const newValue = event.value[key];
+              console.log('🔧 Processing key:', key, 'value:', newValue);
+              // Update ConfigurationModel
+              newContext.internal.configModel.setValue(key, newValue);
+              // Track in changedSettings
+              newContext.internal.changedSettings[key] = newValue;
+              // If it's a bracket key, check if it applies to current context
+              if (key.startsWith('[')) {
+                const bracketPattern = key.match(/^(\[[^\]]+\])+/);
+                if (bracketPattern) {
+                  const identifier = bracketPattern[0];
+                  // Use route pattern if available, otherwise fall back to current route
+                  const routeForBracket = newContext.internal.routePattern || newContext.internal.currentRoute;
+                  const currentIdentifier = `[${routeForBracket}][${newContext.internal.deviceType}]`;
+                  const deviceOnlyIdentifier = `[${newContext.internal.deviceType}]`;
+                  // If this override applies to current route/device, update public settings
+                  if (identifier === currentIdentifier || identifier === deviceOnlyIdentifier) {
+                    const remainingKey = key.substring(identifier.length);
+                    const path = remainingKey.startsWith('.') ? remainingKey.substring(1) : remainingKey;
+                    set(newContext.public, path, newValue);
+                  }
+                }
+              } else {
+                // Regular setting - update public settings directly
+                set(newContext.public, key, newValue);
+              }
             });
             return newContext;
           }), 'updateReduxSettings']
         },
-        ROUTE_CHANGE: {
+        UISETTING_ROUTE_CHANGE: {
           actions: [assign(({
             context,
             event
           }) => {
-            const newContext = cloneDeep({
-              ...context
-            });
             const routePath = event.pathname || '/';
-            // Update current route
-            newContext.currentRoute = routePath;
-            // Get the route's saved settings from history or use default
-            const routeSettings = context.routeSettings[routePath];
-            // Initialize route settings if it doesn't exist
-            if (!newContext.routeSettings[routePath]) {
-              newContext.routeSettings[routePath] = cloneDeep({
-                ...defaultRouteSettings
-              });
-              return newContext;
+            const routePattern = event.routePattern;
+            console.log('🔧 ROUTE_CHANGE to:', routePath, 'pattern:', routePattern);
+            // Clone context to avoid mutations
+            const newContext = cloneDeep(context);
+            // Update internal route and route pattern
+            newContext.internal.currentRoute = routePath;
+            if (routePattern) {
+              newContext.internal.routePattern = routePattern;
             }
-            newContext.routeSettings[routePath] = cloneDeep(routeSettings);
+            // Build override keys using route pattern if available
+            const routeForBracket = routePattern || routePath;
+            const routeDeviceKey = `[${routeForBracket}][${context.internal.deviceType}]`;
+            const deviceKey = `[${context.internal.deviceType}]`;
+            // Apply overrides by chaining: base -> device -> route+device
+            const globalOverride = context.internal.configModel.override(deviceKey);
+            const routeOverride = globalOverride.override(routeDeviceKey);
+            // Extract final merged settings
+            const mergedContents = routeOverride?.contents || context.internal.configModel.contents;
+            const effectiveSettings = mergedContents;
+            // Rebuild PUBLIC settings from scratch (no leakage from old route)
+            newContext.public = {
+              ...effectiveSettings,
+              components: effectiveSettings.components || [],
+              hiddenMenuKeys: effectiveSettings.hiddenMenuKeys || [],
+              hiddenMenuCategories: effectiveSettings.hiddenMenuCategories || []
+            };
             return newContext;
           }), 'updateReduxSettings']
         },
-        UPDATE_ROUTE_SETTINGS: {
+        UISETTING_UPDATE_ROUTE_SETTINGS: {
           actions: [assign(({
             context,
             event
           }) => ({
-            ...context,
-            routeSettings: deepMerge(context.routeSettings, event.settings)
+            ...context
+            // Route settings are now handled via uiSettings overrides
           })), 'updateReduxSettings']
         },
-        RESET: {
-          actions: [assign(() => ({
-            navTheme: defaultSettings.navTheme || 'light',
-            primaryColor: defaultSettings.primaryColor || '#1890ff',
-            theme: 'default',
-            components: [],
-            activeComponent: null,
-            routeSettings: {
-              '/': defaultRouteSettings
-            }
-          })), 'updateReduxSettings']
+        UISETTING_RESET: {
+          actions: [assign(({
+            context
+          }) => {
+            const newContext = cloneDeep(context);
+            // Reset public state
+            newContext.public.components = [];
+            newContext.public.activeComponent = undefined;
+            // Reset internal tracking
+            newContext.internal.changedSettings = {};
+            return newContext;
+          }), 'updateReduxSettings']
+        },
+        UISETTING_RESET_CHANGED_SETTINGS: {
+          actions: [assign(({
+            context
+          }) => {
+            const newContext = cloneDeep(context);
+            newContext.internal.changedSettings = {};
+            return newContext;
+          })]
+        },
+        UISETTING_UPDATE_DEVICE_TYPE: {
+          actions: [assign(({
+            context,
+            event
+          }) => {
+            const deviceType = event.deviceType || 'desktop';
+            console.log('🔧 UPDATE_DEVICE_TYPE to:', deviceType);
+            // Clone context to avoid mutations
+            const newContext = cloneDeep(context);
+            // Update internal device type
+            newContext.internal.deviceType = deviceType;
+            // Build override keys using route pattern if available
+            const routeForBracket = context.internal.routePattern || context.internal.currentRoute;
+            const routeDeviceKey = `[${routeForBracket}][${deviceType}]`;
+            const deviceKey = `[${deviceType}]`;
+            // Apply overrides by chaining: base -> device -> route+device
+            const globalOverride = context.internal.configModel.override(deviceKey);
+            const routeOverride = globalOverride.override(routeDeviceKey);
+            // Extract final merged settings
+            const mergedContents = routeOverride?.contents || context.internal.configModel.contents;
+            const effectiveSettings = mergedContents;
+            // Rebuild PUBLIC settings with new device overrides
+            newContext.public = {
+              ...effectiveSettings,
+              components: effectiveSettings.components || [],
+              hiddenMenuKeys: effectiveSettings.hiddenMenuKeys || [],
+              hiddenMenuCategories: effectiveSettings.hiddenMenuCategories || []
+            };
+            return newContext;
+          }), 'updateReduxSettings']
         }
         // SAVE: {
         //     actions: ['updateReduxSettings'],

package/lib/machines/settingsMachine.js.map

@@ -1 +1 @@
-{"version":3,"file":"settingsMachine.js","sources":["../../src/machines/settingsMachine.ts"],"sourcesContent":[null],"names":[],"mappings":"oLAcA;AACA,MAAM,cAAc,GAAG;AACnB,EAAA,cAAA,EAAc,OAA2B;AACzC,EAAA,YAAA,EAAY,UAA4B;AACxC,EAAA,YAAA,EAAY,OAAyB;AACrC,EAAA,WAAA,EAAW,IAAM;AACjB,EAAA,YAAA,EAAY,IAAM;AAClB,EAAA,UAAA,EAAU,KAAO;AACjB,EAAA,oBAAA,EAAoB,YAAc;AAClC,EAAA,qBAAA,EAAqB,WAAa;AAClC,EAAA,oBAAA,EAAoB;CACvB;AAED;AACA,MAAM,kBAAkB,GAAuB;AAC3C,EAAA,IAAA,EAAI,OAAS;AACb,EAAA,KAAA,EAAK,SAAW;AAChB,EAAA,KAAA,EAAK,EAAE;AACP,EAAA,KAAA,EAAK,EAAE;AACP,EAAA,cAAA,EAAc;CACjB;AAED,MAAM,cAAc,GAAG;AACnB,EAAA,QAAA,EAAQ,IAAM;AACd,EAAA,cAAA,EAAc,IAAM;AACpB,EAAA,gBAAA,EAAgB,IAAM;AACtB,EAAA,cAAA,EAAc,IAAM;AACpB,EAAA,cAAA,EAAc,IAAM;AACpB,EAAA,aAAA,EAAa,IAAM;AACnB,EAAA,iBAAA,EAAiB,IAAM;AACvB,EAAA,QAAA,EAAQ,OAA+B;AACvC,EAAA,MAAA,EAAM,MAAQ;AACd,EAAA,SAAA,EAAS;AACT,EAAA,UAAA,EAAU,IAAM;AAChB,EAAA,QAAA,EAAQ,IAAM;AACd,EAAA,gBAAA,EAAgB,IAAM;AACtB,EAAA,eAAA,EAAe,IAAM;mBACJ,EAAA,iBAAmB,CAAA,SAAU;AAC9C,EAAA,gBAAA,EAAgB,IAAM;AACtB,EAAA,eAAA,EAAe;CAClB;AAED;AACA,MAAM,kBAAkB,GAAG;AACvB,EAAA,MAAA,EAAM,cAAgB;AACtB,EAAA,OAAA,EAAO;AACH,IAAA,MAAA,EAAA,cAAsB;AACtB,IAAA,MAAA,EAAA;AACA,MAAA,UAAA,EAAU;AACb,KAAA;IACH,UAAA,EAAA;AAEF;AACI,CAAA;0BAC+B,GAAA;QAC3B,EAAM;AACT,IAAA,OAAA,EAAA,kBAAA,CAAA,MAAA;AACD,IAAA,MAAA,EAAS,kBAAA,CAAA;AACL,GAAA;AACI,EAAA,OAAA,EAAA;AACA,IAAA,OAAA,EAAA;AACA,MAAA,MAAA,EAAA,kBAAY,CAAA,OAAA,CAAA,MAAmB;AAClC,MAAA,MAAA,EAAA,kBAAA,CAAA,OAAA,CAAA,MAAA;AACD,MAAA,UAAQ,EAAA,kBAAA,CAAA,OAAA,CAAA;AACJ,KAAA;AACA,IAAA,MAAA,EAAA;AACA,MAAA,MAAA,EAAA,kBAAY,CAAA,OAAA,CAAA,MAAmB;AAClC,MAAA,MAAA,EAAA,kBAAA,CAAA,OAAA,CAAA,MAAA;AACJ,MAAA,UAAA,EAAA,kBAAA,CAAA,OAAA,CAAA;;AAGL;AACA,CAAA;AACI;AAEA,MAAA,SAAW,GAAG,CAAI,MAAA,EAAA,MAAS,KAAA;QACvB,MAAI,GAAA;AACA,IAAA,GAAA;;aACG,GAAC,IAAA,MAAA,EAAA;cACE,CAAA,GAAA,CAAC,kBAAkB,IAAC,GAAA,IAAA,MAAA,EAAA;YAC7B,CAAA,GAAA,CAAA,GAAA,SAAA,CAAA,MAAA,CAAA,GAAA,CAAA,EAAA,MAAA,CAAA,GAAA,CAAA,CAAA;KACJ,MAAA;AAED,MAAA,WAAa,GAAC,MAAA,CAAA,GAAA,CAAA;AAClB;AAEA;AACI,EAAA,OAAc,MAAA;AACd,CAAA;MAQS,eAAM,GAAA,aAAA,CAAA;AACf,EAAA,EAAA,EAAA,UAAY;SACD,EAAA;AAGC,EAAA,OAAA,EAAA,MAAA;AACA,EAAA,OAAA,EAAA,CAAA;AACA,IAAA;AACA,GAAA,KAAA;gBACI,CAAA,EAAiB,EAAA;cAChB,EAAA,eAAiB,CAAA,QAAM,IAAA,OAAA;kBACZ,EAAA,eAAiB,CAAA,YAAiB,IAAA,SAAA;oBACxC,EAAA,eAAiB,CAAA,cAAW,IAAA,SAAA;aAC9B,eAAiB,CAAA,KAAA,IAAC,SAAQ;YAClC,eAA2B,CAAA,IAAA;aACZ,eAAA,CAAE,KAAe;sBACrB,EAAA,eAAiB,CAAA,gBAAY;gBAC3B,EAAA,eAAiB,CAAA,UAAc;cAC9B,EAAA,eAAiB,CAAA,QAAA;gBACnB,EAAA,eAAiB,CAAA,UAAa;qBAC7B,EAAA,eAAiB,CAAA,eAAc;iBACnC,EAAA,eAAiB,CAAA,WAAU;mBAC3B,EAAA,eAAiB,CAAA,aAAU;oBAErB,EAAA,eAAiB,CAAA,cAAgB;kBAC/B,EAAA,eAAiB,CAAA,YAAkB;mBACxC,EAAA,eAAiB,CAAA,aAAa;eACtB,EAAA,eAAA,CAAA,SAAiB;eAErB,EAAA,eAAiB,CAAA,SAAA;qBACf,EAAA,eAAiB,CAAA,eAAmB;uBAC7B,EAAA,eAAiB,CAAA,iBAA0B;kBAC7C,EAAA,eAAA,CAAA,YAAiB;0BAChB,EAAA,eAAiB,CAAA,oBAAyB;AAClE,MAAA,gBAAU,EAAE,eAAE,CAAA,gBAAA;AACd,MAAA,kBAAA,EAAA,eAAqB,CAAA,kBAAA;AACrB,MAAA,yBAAmB,EAAE,eAAU,CAAA,yBAAmB;AAClD,MAAA,uBAAe,EAAA,eAAA,CAAA,uBAAA;AACX,MAAA,wBAAyB,EAAA,eAAA,CAAA,wBAAA;AAC5B,MAAA,UAAA,EAAA,EAAA;AACJ,MAAA,eACc,EAAA,IAClB;MACJ,YAAA,EAAA,KAAA,EAAA,QAAA,EAAA,YAAA,IAAA,GAAA;AACD,MAAA,aAAQ,EAAA;AACJ,QAAA,GAAA,EAAM;AACF;AACI,KAAA,EAAA,KAAA,EAAA,QAAM,CAAE;AACJ,GAAA;;;AAE0B,MAAA,EAAA,EAAA;;4BAIlB;;;;4BAKA,EAAI,OAAK,OAAO;wCACF,CAAA;;;;4BAKd,QAAC,KAAA,SAAA,EAAA;iCAC+D,GAAA,KAAA,CAAA,KAAA,CAAA,QAAA;AAEhE;AACI,YAAA,IAAA,KAAA,CAAA,KAAA,CAAA,YAAI,KAAA,SAAiB,EAAA;AACzB,cAAA,UAAA,CAAA,YAAG,GAAA,KAAA,CAAA,KAAA,CAAA,YAAA;AAEH;AACJ,YAAA,IAAA,KAAA,CAAA,KAAE,CAAA,KAAA,KAAA,SAAA,EAAA;wBACF,CAAqB,KAAA,GAAA,KAAA,CAAA,KAAA,CAAA,KAAA;AACxB;AACJ;AACD,YAAA,MAAA,CAAA,IAAA,CAAA,KAAc,CAAA,KAAA,CAAA,CAAA,OAAA,CAAA,GAAA,IAAA;AACV,cAAA,GAAA,CAAA,UAAS,EAAA,GAAA,EAAA,KAAA,CAAA,KAAA,CAAA,GAAA,CAAA,CAAA;;6BAEK;AACN,WAAA,CAAA,EAAA;;AAEA,QAAA,YAAA,EAAA;4BACA;;;;AAII,YAAA,MAAA,UAAA,GAAA,SAAA,CAAA;AACA,cAAA,GAAA;;8BAEM,KAAA,CAAA,QAAc,IAAA,GAAA;AACxB;AACJ,YAAA,UAAA,CAAA,YAAE,GAAA,SAAA;;AAEL,YAAA,MAAA,aAAA,GAAA,OAAA,CAAA,aAAA,CAAA,SAAA,CAAA;AACJ;AACD,YAAA,IAAA,CAAA,UAAA,CAAA,aAAuB,CAAA,SAAA,CAAA,EAAA;AACnB,cAAA,UAAA,CAAA,aAAS,CAAA,SAAA,CAAA,GAAA,SAAA,CAAA;;AAED,eAAA,CAAA;+BACa;AAChB;oCAEoB,CAAA,SAAA,CAAA,GAAA,SAAA,CAAA,aAAA,CAAA;AACxB,YAAA,OAAA,UAAA;AACJ,WAAA,CAAA,EAAA,qBAAA;AACD,SAAA;AACI,QAAA,qBAAS,EAAA;AACL,UAAA,OAAA,EAAA,CAAA,MAAA,CAAA,CAAA;AAGY,YAAA,OAAA;AACA,YAAA;AACA,WAAA,MAAA;AACA,YAAA,GAAA,OAAA;AACA,YAAA,aAAA,EAAA,SAAA,CAAA,QAAiB,aAAI,EAAA,KAAA,CAAA,QAAA;AACrB,WAAA,CAAA,CAAA,EAAA,qBAAA;AACI,SAAA;AACH,QAAA,KAAA,EAAA;AACI,UAAA,OAAA,EAAA,CAAA,MAAA,CAChB,OAAA;qCACoB,CAAA,QAAA,IAAA,OAAA;AACxB,YAAA,YAAA,EAAA,eAAA,CAAA,YAAA,IAAA,SAAA;AACJ,YAAA,KAAA,EAAA,SAAA;sBACS,EAAA,EAAA;2BAC8B,EAAA,IAAA;yBACnC,EAAA;AACR,cAAA,GAAA,EAAA;AACJ;AACJ,WAAA,CAAA,CAAA,EAAA,qBAAA;AACJ;;;;;;;"}
+{"version":3,"file":"settingsMachine.js","sources":["../../src/machines/settingsMachine.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/lib/machines/settingsMachine.test.d.ts

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

package/lib/machines/settingsMachine.test.d.ts.map

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

package/lib/machines/types.d.ts

@@ -1,6 +1,6 @@
 export type ThemeColor = 'blue' | 'indigo' | 'red' | 'orange' | 'yellow' | 'teal' | 'green' | 'blue' | 'purple';
 export type NavigationMode = 'sidebar' | 'topbar' | 'mixed';
-export type SideMenuType = 'expanded' | 'collapsed';
+export type SideMenuType = 'expanded' | 'collapsed' | 'perplexLayout';
 export type ContentWidth = 'fixed' | 'fluid';
 export declare enum SearchBarBehavior {
     PERMANENT = "permanent",
@@ -43,6 +43,58 @@ export type RouteSettings = {
             lowerMenuDividerName?: string;
         };
     };
+    header?: {
+        desktop?: {
+            showLogo?: boolean;
+            showSearchSlot?: boolean;
+            showRightContent?: boolean;
+            showMenuToggle?: boolean;
+            showBackButton?: boolean;
+            showPageTitle?: boolean;
+            showActionButtons?: boolean;
+            position?: 'fixed' | 'static';
+            height?: string;
+            elevation?: number;
+            showHeader?: boolean;
+            showMenu?: boolean;
+            menuHeaderRender?: boolean;
+            searchBarRender?: boolean;
+            searchBarBehavior?: SearchBarBehavior;
+            searchBarOverlay?: boolean;
+            scrollThreshold?: number;
+        };
+        mobile?: {
+            showLogo?: boolean;
+            showSearchSlot?: boolean;
+            showRightContent?: boolean;
+            showMenuToggle?: boolean;
+            showBackButton?: boolean;
+            showPageTitle?: boolean;
+            showActionButtons?: boolean;
+            position?: 'fixed' | 'static';
+            height?: string;
+            elevation?: number;
+            showHeader?: boolean;
+            showMenu?: boolean;
+            menuHeaderRender?: boolean;
+            searchBarRender?: boolean;
+            searchBarBehavior?: SearchBarBehavior;
+            searchBarOverlay?: boolean;
+            scrollThreshold?: number;
+        };
+    };
+    footer?: {
+        desktop?: {
+            showFooter?: boolean;
+        };
+        mobile?: {
+            showFooter?: boolean;
+        };
+    };
+    background?: {
+        desktop?: BackgroundSettings;
+        mobile?: BackgroundSettings;
+    };
     regions?: {
         desktop?: {
             background?: BackgroundSettings;
@@ -96,7 +148,11 @@ export type RouteSettings = {
         };
     };
 };
-export interface SettingsContext {
+/**
+ * UI Settings - User-facing settings that control the visual appearance and layout.
+ * This includes all visual/layout settings but excludes internal machine state.
+ */
+export interface UISettings {
     navTheme: 'light' | 'dark' | 'realDark';
     primaryColor: string;
     secondaryColor: string;
@@ -111,6 +167,7 @@ export interface SettingsContext {
     titleFontSize: string;
     letterSpacings: string;
     siderBgColor: string;
+    sideMenuType: SideMenuType;
     headerBgColor: string;
     textColor: string;
     themeType: string;
@@ -125,11 +182,45 @@ export interface SettingsContext {
     verifyFormShowSkipButton: boolean;
     components: ComponentSettings[];
     activeComponent?: string;
-    currentRoute?: string;
-    routeSettings: Record<string, RouteSettings>;
+    hiddenMenuKeys?: string[];
+    hiddenMenuCategories?: string[];
+    uiSettings?: {
+        uilayout?: {
+            layout?: any;
+            regions?: any;
+        };
+        overrides?: Record<string, any>;
+    };
+    overrides?: Record<string, any>;
+}
+/**
+ * Machine-internal state used for XState machine logic only.
+ * These values are NEVER exposed to consumers or synced to Redux.
+ *
+ * IMPORTANT: This interface contains ONLY machine-internal state.
+ * NO user-facing settings should be added here.
+ */
+export interface MachineInternalState {
+    configModel: any;
+    deviceType: 'desktop' | 'mobile';
+    currentRoute: string;
+    changedSettings: Record<string, any>;
+    routePattern?: string;
 }
+/**
+ * Settings Context - Complete state with separated UI and internal concerns.
+ */
+export interface SettingsContext {
+    public: UISettings;
+    internal: MachineInternalState;
+}
+/**
+ * Legacy type for backward compatibility
+ * @deprecated Use UISettings instead
+ */
+export type SettingsContextLegacy = UISettings;
 export type UpdateEvent = {
-    type: 'UPDATE';
+    type: 'UISETTING_UPDATE';
     value?: Partial<SettingsContext>;
 };
 export type ComponentEvent = {
@@ -146,7 +237,7 @@ export type ComponentEvent = {
     type: 'CLEAR_COMPONENT_SELECTION';
 };
 export type MachineEvent = {
-    type: 'UPDATE';
+    type: 'UISETTING_UPDATE';
     value: Partial<SettingsContext>;
 } | {
     type: 'REGISTER_COMPONENT';
@@ -161,14 +252,20 @@ export type MachineEvent = {
 } | {
     type: 'CLEAR_COMPONENT_SELECTION';
 } | {
-    type: 'RESET';
+    type: 'UISETTING_RESET';
 } | {
     type: 'SAVE';
 } | {
-    type: 'ROUTE_CHANGE';
+    type: 'UISETTING_RESET_CHANGED_SETTINGS';
+} | {
+    type: 'UISETTING_ROUTE_CHANGE';
     pathname: string;
+    routePattern?: string;
 } | {
-    type: 'UPDATE_ROUTE_SETTINGS';
+    type: 'UISETTING_UPDATE_ROUTE_SETTINGS';
     settings: Record<string, Partial<SettingsContext>>;
+} | {
+    type: 'UISETTING_UPDATE_DEVICE_TYPE';
+    deviceType: 'desktop' | 'mobile';
 };
 //# sourceMappingURL=types.d.ts.map