@memberjunction/react-runtime 6.2.0-edge.0 → 6.2.0-edge.2

package/dist/utilities/standard-libraries.js

@@ -8,28 +8,49 @@ const DEFAULT_LIBRARY_CONFIG = {
 };
 export class StandardLibraryManager {
     static { this.configuration = DEFAULT_LIBRARY_CONFIG; }
-    static setConfiguration(config) {
+    static SetConfiguration(config) {
         this.configuration = config;
     }
-    static getConfiguration() {
+    static setConfiguration(config) {
+        return this.SetConfiguration(config);
+    }
+    static GetConfiguration() {
         return this.configuration;
     }
-    static getEnabledLibraries() {
+    static getConfiguration() {
+        return this.GetConfiguration();
+    }
+    static GetEnabledLibraries() {
         return this.configuration.libraries.filter(lib => lib.isEnabled);
     }
-    static getLibrariesByCategory(category) {
+    static getEnabledLibraries() {
+        return this.GetEnabledLibraries();
+    }
+    static GetLibrariesByCategory(category) {
         return this.configuration.libraries.filter(lib => lib.category === category && lib.isEnabled);
     }
-    static getCoreLibraries() {
+    static getLibrariesByCategory(category) {
+        return this.GetLibrariesByCategory(category);
+    }
+    static GetCoreLibraries() {
         return this.configuration.libraries.filter(lib => lib.isCore && lib.isEnabled);
     }
-    static getComponentLibraries() {
+    static getCoreLibraries() {
+        return this.GetCoreLibraries();
+    }
+    static GetComponentLibraries() {
         return this.configuration.libraries.filter(lib => !lib.isRuntimeOnly && lib.isEnabled);
     }
-    static getLibraryById(id) {
+    static getComponentLibraries() {
+        return this.GetComponentLibraries();
+    }
+    static GetLibraryById(id) {
         return this.configuration.libraries.find(lib => lib.id === id);
     }
-    static getLibraryUrls() {
+    static getLibraryById(id) {
+        return this.GetLibraryById(id);
+    }
+    static GetLibraryUrls() {
         const urls = {};
         this.configuration.libraries
             .filter(lib => lib.isEnabled)
@@ -42,11 +63,17 @@ export class StandardLibraryManager {
         });
         return urls;
     }
-    static resetToDefault() {
+    static getLibraryUrls() {
+        return this.GetLibraryUrls();
+    }
+    static ResetToDefault() {
         this.configuration = DEFAULT_LIBRARY_CONFIG;
     }
+    static resetToDefault() {
+        return this.ResetToDefault();
+    }
 }
-export function createStandardLibraries() {
+export function CreateStandardLibraries() {
     if (typeof window === 'undefined') {
         return {};
     }
@@ -59,4 +86,7 @@ export function createStandardLibraries() {
     });
     return libs;
 }
+export function createStandardLibraries() {
+    return CreateStandardLibraries();
+}
 //# sourceMappingURL=standard-libraries.js.map

package/dist/utilities/standard-libraries.js.map

@@ -1 +1 @@
-{"version":3,"file":"standard-libraries.js","sourceRoot":"","sources":["../../src/utilities/standard-libraries.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Standard libraries configuration for React components\n * @module @memberjunction/react-runtime/utilities\n */\n\nimport { LibraryConfiguration, ExternalLibraryConfig } from '../types/library-config';\n\n\n/**\n * Type for dynamically loaded libraries available to React components\n */\nexport type StandardLibraries = Record<string, any>;\n\n/**\n * Default empty library configuration\n * Libraries should be configured dynamically at runtime\n */\nconst DEFAULT_LIBRARY_CONFIG: LibraryConfiguration = {\n  libraries: [],\n  metadata: {\n    version: '1.0.0',\n    lastUpdated: new Date().toISOString(),\n    description: 'Empty default configuration - libraries should be configured at runtime'\n  }\n};\n\n/**\n * Manages standard library configurations with dynamic loading support\n */\nexport class StandardLibraryManager {\n  private static configuration: LibraryConfiguration = DEFAULT_LIBRARY_CONFIG;\n  \n  /**\n   * Set a custom library configuration\n   */\n  static setConfiguration(config: LibraryConfiguration): void {\n    this.configuration = config;\n  }\n  \n  /**\n   * Get the current library configuration\n   */\n  static getConfiguration(): LibraryConfiguration {\n    return this.configuration;\n  }\n  \n  /**\n   * Get all enabled libraries\n   */\n  static getEnabledLibraries(): ExternalLibraryConfig[] {\n    return this.configuration.libraries.filter(lib => lib.isEnabled);\n  }\n  \n  /**\n   * Get libraries by category\n   */\n  static getLibrariesByCategory(category: ExternalLibraryConfig['category']): ExternalLibraryConfig[] {\n    return this.configuration.libraries.filter(lib => lib.category === category && lib.isEnabled);\n  }\n  \n  /**\n   * Get core libraries (runtime essentials)\n   */\n  static getCoreLibraries(): ExternalLibraryConfig[] {\n    return this.configuration.libraries.filter(lib => lib.isCore && lib.isEnabled);\n  }\n  \n  /**\n   * Get component libraries (non-runtime)\n   */\n  static getComponentLibraries(): ExternalLibraryConfig[] {\n    return this.configuration.libraries.filter(lib => !lib.isRuntimeOnly && lib.isEnabled);\n  }\n  \n  /**\n   * Get library by ID\n   */\n  static getLibraryById(id: string): ExternalLibraryConfig | undefined {\n    return this.configuration.libraries.find(lib => lib.id === id);\n  }\n  \n  /**\n   * Get library URLs as a simple object (for backward compatibility)\n   */\n  static getLibraryUrls(): Record<string, string> {\n    const urls: Record<string, string> = {};\n    this.configuration.libraries\n      .filter(lib => lib.isEnabled)\n      .forEach(lib => {\n        // Use uppercase key for backward compatibility\n        const key = lib.id.replace(/-/g, '_').toUpperCase();\n        urls[key] = lib.cdnUrl;\n        if (lib.cdnCssUrl) {\n          urls[`${key}_CSS`] = lib.cdnCssUrl;\n        }\n      });\n    return urls;\n  }\n  \n  /**\n   * Reset to default configuration\n   */\n  static resetToDefault(): void {\n    this.configuration = DEFAULT_LIBRARY_CONFIG;\n  }\n}\n\n\n/**\n * Creates a standard libraries object for browser environments\n * Dynamically collects all libraries based on current configuration\n */\nexport function createStandardLibraries(): StandardLibraries {\n  if (typeof window === 'undefined') {\n    // Return empty object in Node.js environments\n    return {};\n  }\n  \n  const libs: StandardLibraries = {};\n  \n  // Add all component libraries as globals based on configuration\n  StandardLibraryManager.getComponentLibraries().forEach(lib => {\n    const globalValue = (window as any)[lib.globalVariable];\n    if (globalValue !== undefined) {\n      libs[lib.globalVariable] = globalValue;\n    }\n  });\n  \n  return libs;\n}"]}
+{"version":3,"file":"standard-libraries.js","sourceRoot":"","sources":["../../src/utilities/standard-libraries.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Standard libraries configuration for React components\n * @module @memberjunction/react-runtime/utilities\n */\n\nimport { LibraryConfiguration, ExternalLibraryConfig } from '../types/library-config';\n\n\n/**\n * Type for dynamically loaded libraries available to React components\n */\nexport type StandardLibraries = Record<string, any>;\n\n/**\n * Default empty library configuration\n * Libraries should be configured dynamically at runtime\n */\nconst DEFAULT_LIBRARY_CONFIG: LibraryConfiguration = {\n  libraries: [],\n  metadata: {\n    version: '1.0.0',\n    lastUpdated: new Date().toISOString(),\n    description: 'Empty default configuration - libraries should be configured at runtime'\n  }\n};\n\n/**\n * Manages standard library configurations with dynamic loading support\n */\nexport class StandardLibraryManager {\n  private static configuration: LibraryConfiguration = DEFAULT_LIBRARY_CONFIG;\n  \n  /**\n   * Set a custom library configuration\n   */\n  static SetConfiguration(config: LibraryConfiguration): void {\n    this.configuration = config;\n  }\n\n  /** @deprecated Use {@link SetConfiguration}. */\n  static setConfiguration(config: LibraryConfiguration): void {\n    return this.SetConfiguration(config);\n  }\n  \n  /**\n   * Get the current library configuration\n   */\n  static GetConfiguration(): LibraryConfiguration {\n    return this.configuration;\n  }\n\n  /** @deprecated Use {@link GetConfiguration}. */\n  static getConfiguration(): LibraryConfiguration {\n    return this.GetConfiguration();\n  }\n  \n  /**\n   * Get all enabled libraries\n   */\n  static GetEnabledLibraries(): ExternalLibraryConfig[] {\n    return this.configuration.libraries.filter(lib => lib.isEnabled);\n  }\n\n  /** @deprecated Use {@link GetEnabledLibraries}. */\n  static getEnabledLibraries(): ExternalLibraryConfig[] {\n    return this.GetEnabledLibraries();\n  }\n  \n  /**\n   * Get libraries by category\n   */\n  static GetLibrariesByCategory(category: ExternalLibraryConfig['category']): ExternalLibraryConfig[] {\n    return this.configuration.libraries.filter(lib => lib.category === category && lib.isEnabled);\n  }\n\n  /** @deprecated Use {@link GetLibrariesByCategory}. */\n  static getLibrariesByCategory(category: ExternalLibraryConfig['category']): ExternalLibraryConfig[] {\n    return this.GetLibrariesByCategory(category);\n  }\n  \n  /**\n   * Get core libraries (runtime essentials)\n   */\n  static GetCoreLibraries(): ExternalLibraryConfig[] {\n    return this.configuration.libraries.filter(lib => lib.isCore && lib.isEnabled);\n  }\n\n  /** @deprecated Use {@link GetCoreLibraries}. */\n  static getCoreLibraries(): ExternalLibraryConfig[] {\n    return this.GetCoreLibraries();\n  }\n  \n  /**\n   * Get component libraries (non-runtime)\n   */\n  static GetComponentLibraries(): ExternalLibraryConfig[] {\n    return this.configuration.libraries.filter(lib => !lib.isRuntimeOnly && lib.isEnabled);\n  }\n\n  /** @deprecated Use {@link GetComponentLibraries}. */\n  static getComponentLibraries(): ExternalLibraryConfig[] {\n    return this.GetComponentLibraries();\n  }\n  \n  /**\n   * Get library by ID\n   */\n  static GetLibraryById(id: string): ExternalLibraryConfig | undefined {\n    return this.configuration.libraries.find(lib => lib.id === id);\n  }\n\n  /** @deprecated Use {@link GetLibraryById}. */\n  static getLibraryById(id: string): ExternalLibraryConfig | undefined {\n    return this.GetLibraryById(id);\n  }\n  \n  /**\n   * Get library URLs as a simple object (for backward compatibility)\n   */\n  static GetLibraryUrls(): Record<string, string> {\n    const urls: Record<string, string> = {};\n    this.configuration.libraries\n      .filter(lib => lib.isEnabled)\n      .forEach(lib => {\n        // Use uppercase key for backward compatibility\n        const key = lib.id.replace(/-/g, '_').toUpperCase();\n        urls[key] = lib.cdnUrl;\n        if (lib.cdnCssUrl) {\n          urls[`${key}_CSS`] = lib.cdnCssUrl;\n        }\n      });\n    return urls;\n  }\n\n  /** @deprecated Use {@link GetLibraryUrls}. */\n  static getLibraryUrls(): Record<string, string> {\n    return this.GetLibraryUrls();\n  }\n  \n  /**\n   * Reset to default configuration\n   */\n  static ResetToDefault(): void {\n    this.configuration = DEFAULT_LIBRARY_CONFIG;\n  }\n\n  /** @deprecated Use {@link ResetToDefault}. */\n  static resetToDefault(): void {\n    return this.ResetToDefault();\n  }\n}\n\n\n/**\n * Creates a standard libraries object for browser environments\n * Dynamically collects all libraries based on current configuration\n */\nexport function CreateStandardLibraries(): StandardLibraries {\n  if (typeof window === 'undefined') {\n    // Return empty object in Node.js environments\n    return {};\n  }\n  \n  const libs: StandardLibraries = {};\n  \n  // Add all component libraries as globals based on configuration\n  StandardLibraryManager.getComponentLibraries().forEach(lib => {\n    const globalValue = (window as any)[lib.globalVariable];\n    if (globalValue !== undefined) {\n      libs[lib.globalVariable] = globalValue;\n    }\n  });\n  \n  return libs;\n}\n\n/** @deprecated Use {@link CreateStandardLibraries}. */\nexport function createStandardLibraries(): StandardLibraries {\n  return CreateStandardLibraries();\n}"]}

package/dist/utilities/user-state.d.ts

@@ -1,7 +1,12 @@
 export declare const USER_STATE_KEY_PREFIX = "InteractiveComponents_UserState_Root/";
+export declare function ResolveUserStateScope(explicitScope: string | undefined | null, namespace: string | undefined | null, name: string | undefined | null): string | null;
 export declare function resolveUserStateScope(explicitScope: string | undefined | null, namespace: string | undefined | null, name: string | undefined | null): string | null;
+export declare function UserStateStorageKey(scope: string | null): string | null;
 export declare function userStateStorageKey(scope: string | null): string | null;
+export declare function ParseStoredUserSettings(raw: string | undefined | null): Record<string, unknown>;
 export declare function parseStoredUserSettings(raw: string | undefined | null): Record<string, unknown>;
+export declare function MergeUserSettings(hostDefaults: Record<string, unknown> | undefined | null, stored: Record<string, unknown> | undefined | null): Record<string, unknown>;
 export declare function mergeUserSettings(hostDefaults: Record<string, unknown> | undefined | null, stored: Record<string, unknown> | undefined | null): Record<string, unknown>;
+export declare function ApplyUserSettingsUpdate(current: Record<string, unknown> | undefined | null, incoming: Record<string, unknown> | undefined | null): Record<string, unknown>;
 export declare function applyUserSettingsUpdate(current: Record<string, unknown> | undefined | null, incoming: Record<string, unknown> | undefined | null): Record<string, unknown>;
 //# sourceMappingURL=user-state.d.ts.map

package/dist/utilities/user-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-state.d.ts","sourceRoot":"","sources":["../../src/utilities/user-state.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,qBAAqB,0CAA0C,CAAC;AAiB7E,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACxC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACpC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAC9B,MAAM,GAAG,IAAI,CAYf;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEvE;AAOD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAa/F;AAOD,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,EACxD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAsBD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,EACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB"}
+{"version":3,"file":"user-state.d.ts","sourceRoot":"","sources":["../../src/utilities/user-state.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,qBAAqB,0CAA0C,CAAC;AAiB7E,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACxC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACpC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAC9B,MAAM,GAAG,IAAI,CAYf;AAGD,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACxC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACpC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAC9B,MAAM,GAAG,IAAI,CAEf;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEvE;AAGD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEvE;AAOD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAa/F;AAGD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE/F;AAOD,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,EACxD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAGD,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,EACxD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAsBD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,EACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAGD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,EACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB"}

package/dist/utilities/user-state.js

@@ -1,5 +1,5 @@
 export const USER_STATE_KEY_PREFIX = 'InteractiveComponents_UserState_Root/';
-export function resolveUserStateScope(explicitScope, namespace, name) {
+export function ResolveUserStateScope(explicitScope, namespace, name) {
     const explicit = explicitScope?.trim();
     if (explicit) {
         return explicit.toLowerCase();
@@ -12,10 +12,16 @@ export function resolveUserStateScope(explicitScope, namespace, name) {
     const scope = cleanNamespace ? `${cleanNamespace}/${cleanName}` : cleanName;
     return scope.toLowerCase();
 }
-export function userStateStorageKey(scope) {
+export function resolveUserStateScope(explicitScope, namespace, name) {
+    return ResolveUserStateScope(explicitScope, namespace, name);
+}
+export function UserStateStorageKey(scope) {
     return scope ? `${USER_STATE_KEY_PREFIX}${scope}` : null;
 }
-export function parseStoredUserSettings(raw) {
+export function userStateStorageKey(scope) {
+    return UserStateStorageKey(scope);
+}
+export function ParseStoredUserSettings(raw) {
     if (!raw) {
         return {};
     }
@@ -30,10 +36,16 @@ export function parseStoredUserSettings(raw) {
         return {};
     }
 }
-export function mergeUserSettings(hostDefaults, stored) {
+export function parseStoredUserSettings(raw) {
+    return ParseStoredUserSettings(raw);
+}
+export function MergeUserSettings(hostDefaults, stored) {
     return { ...(hostDefaults ?? {}), ...(stored ?? {}) };
 }
-export function applyUserSettingsUpdate(current, incoming) {
+export function mergeUserSettings(hostDefaults, stored) {
+    return MergeUserSettings(hostDefaults, stored);
+}
+export function ApplyUserSettingsUpdate(current, incoming) {
     const next = { ...(current ?? {}) };
     for (const [key, value] of Object.entries(incoming ?? {})) {
         if (value === null || value === undefined) {
@@ -45,4 +57,7 @@ export function applyUserSettingsUpdate(current, incoming) {
     }
     return next;
 }
+export function applyUserSettingsUpdate(current, incoming) {
+    return ApplyUserSettingsUpdate(current, incoming);
+}
 //# sourceMappingURL=user-state.js.map

package/dist/utilities/user-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-state.js","sourceRoot":"","sources":["../../src/utilities/user-state.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,qBAAqB,GAAG,uCAAuC,CAAC;AAiB7E,MAAM,UAAU,qBAAqB,CACnC,aAAwC,EACxC,SAAoC,EACpC,IAA+B;IAE/B,MAAM,QAAQ,GAAG,aAAa,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,cAAc,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;AAC7B,CAAC;AAMD,MAAM,UAAU,mBAAmB,CAAC,KAAoB;IACtD,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,qBAAqB,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC;AAOD,MAAM,UAAU,uBAAuB,CAAC,GAA8B;IACpE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,OAAO,MAAiC,CAAC;QAC3C,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAOD,MAAM,UAAU,iBAAiB,CAC/B,YAAwD,EACxD,MAAkD;IAElD,OAAO,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC;AAsBD,MAAM,UAAU,uBAAuB,CACrC,OAAmD,EACnD,QAAoD;IAEpD,MAAM,IAAI,GAA4B,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;IAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;QAC1D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * @fileoverview Helpers for the per-user interactive-component settings contract\n * (`savedUserSettings` in / `onSaveUserSettings` out).\n *\n * These helpers are intentionally **pure and framework-agnostic** so the Angular\n * host bridge and the Node test harness share one implementation and the scoping /\n * serialization logic can be unit tested in isolation. The host wires these to a\n * durable per-user store (e.g. `UserInfoEngine`); the runtime itself never persists.\n *\n * @module @memberjunction/react-runtime\n */\n\n/**\n * Prefix applied to every interactive-component user-settings storage key. The\n * full key is `InteractiveComponents_UserState_Root/<scope>`, where `<scope>` is\n * resolved by {@link resolveUserStateScope}. It is deliberately long and unique\n * to avoid collisions with other namespaced keys in the shared\n * `MJ: User Settings` keyspace. Keeping the prefix in one place also avoids\n * stringly-typed drift between the seed (read) and persist (write) paths.\n */\nexport const USER_STATE_KEY_PREFIX = 'InteractiveComponents_UserState_Root/';\n\n/**\n * Resolve the stable per-component scope used to namespace a component's\n * persisted user settings.\n *\n * An explicit, host-supplied scope always wins (used when a host needs to\n * differentiate two instances of the same component spec — e.g. scope a form's\n * settings by the entity it edits). Otherwise the scope is derived from the\n * component spec's `namespace` + `name`.\n *\n * The result is lowercased to avoid case-variant duplicate rows in the settings\n * store (per MJ's user-settings key convention).\n *\n * @returns the resolved scope, or `null` when no stable scope can be derived\n *          (e.g. an unnamed component) — signaling the caller to skip persistence.\n */\nexport function resolveUserStateScope(\n  explicitScope: string | undefined | null,\n  namespace: string | undefined | null,\n  name: string | undefined | null\n): string | null {\n  const explicit = explicitScope?.trim();\n  if (explicit) {\n    return explicit.toLowerCase();\n  }\n  const cleanName = name?.trim();\n  if (!cleanName) {\n    return null;\n  }\n  const cleanNamespace = namespace?.trim();\n  const scope = cleanNamespace ? `${cleanNamespace}/${cleanName}` : cleanName;\n  return scope.toLowerCase();\n}\n\n/**\n * Build the full storage key for a resolved scope, or `null` when the scope is\n * `null` (persistence should be skipped).\n */\nexport function userStateStorageKey(scope: string | null): string | null {\n  return scope ? `${USER_STATE_KEY_PREFIX}${scope}` : null;\n}\n\n/**\n * Safely parse a stored settings blob into a plain object. Returns `{}` for\n * null/empty input, invalid JSON, or any non-object JSON (arrays, primitives) —\n * persisted user settings are always a flat key/value object.\n */\nexport function parseStoredUserSettings(raw: string | undefined | null): Record<string, unknown> {\n  if (!raw) {\n    return {};\n  }\n  try {\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {\n      return parsed as Record<string, unknown>;\n    }\n    return {};\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Merge host-provided defaults with the stored per-user settings. Stored values\n * win, so a returning user sees their saved preferences while a host can still\n * seed sensible first-run defaults that fill any gaps.\n */\nexport function mergeUserSettings(\n  hostDefaults: Record<string, unknown> | undefined | null,\n  stored: Record<string, unknown> | undefined | null\n): Record<string, unknown> {\n  return { ...(hostDefaults ?? {}), ...(stored ?? {}) };\n}\n\n/**\n * Apply an `onSaveUserSettings` payload to the host's current settings snapshot.\n *\n * **Merge, not replace.** The contract asks components to pass the complete\n * settings object, but the host must be resilient to a component (especially an\n * AI-generated one) passing only the changed keys — and to the stale-prop case\n * where a component spreads the mount-time `savedUserSettings` prop, which the\n * host deliberately never refreshes mid-session (no re-render on save). Under\n * full-replace semantics either slip silently wipes every other saved\n * preference; under merge the worst case is a no-op.\n *\n * **Removing a key requires explicit intent**: set its value to `null` and the\n * key is deleted from the snapshot (reads fall back to defaults via the\n * documented `savedUserSettings?.key ?? fallback` pattern). `undefined` values\n * are treated the same way, since `JSON.stringify` would drop them from the\n * persisted blob anyway and the in-memory snapshot must stay consistent with\n * what is stored.\n *\n * @returns a new object — neither input is mutated.\n */\nexport function applyUserSettingsUpdate(\n  current: Record<string, unknown> | undefined | null,\n  incoming: Record<string, unknown> | undefined | null\n): Record<string, unknown> {\n  const next: Record<string, unknown> = { ...(current ?? {}) };\n  for (const [key, value] of Object.entries(incoming ?? {})) {\n    if (value === null || value === undefined) {\n      delete next[key];\n    } else {\n      next[key] = value;\n    }\n  }\n  return next;\n}\n"]}
+{"version":3,"file":"user-state.js","sourceRoot":"","sources":["../../src/utilities/user-state.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Helpers for the per-user interactive-component settings contract\n * (`savedUserSettings` in / `onSaveUserSettings` out).\n *\n * These helpers are intentionally **pure and framework-agnostic** so the Angular\n * host bridge and the Node test harness share one implementation and the scoping /\n * serialization logic can be unit tested in isolation. The host wires these to a\n * durable per-user store (e.g. `UserInfoEngine`); the runtime itself never persists.\n *\n * @module @memberjunction/react-runtime\n */\n\n/**\n * Prefix applied to every interactive-component user-settings storage key. The\n * full key is `InteractiveComponents_UserState_Root/<scope>`, where `<scope>` is\n * resolved by {@link resolveUserStateScope}. It is deliberately long and unique\n * to avoid collisions with other namespaced keys in the shared\n * `MJ: User Settings` keyspace. Keeping the prefix in one place also avoids\n * stringly-typed drift between the seed (read) and persist (write) paths.\n */\nexport const USER_STATE_KEY_PREFIX = 'InteractiveComponents_UserState_Root/';\n\n/**\n * Resolve the stable per-component scope used to namespace a component's\n * persisted user settings.\n *\n * An explicit, host-supplied scope always wins (used when a host needs to\n * differentiate two instances of the same component spec — e.g. scope a form's\n * settings by the entity it edits). Otherwise the scope is derived from the\n * component spec's `namespace` + `name`.\n *\n * The result is lowercased to avoid case-variant duplicate rows in the settings\n * store (per MJ's user-settings key convention).\n *\n * @returns the resolved scope, or `null` when no stable scope can be derived\n *          (e.g. an unnamed component) — signaling the caller to skip persistence.\n */\nexport function ResolveUserStateScope(\n  explicitScope: string | undefined | null,\n  namespace: string | undefined | null,\n  name: string | undefined | null\n): string | null {\n  const explicit = explicitScope?.trim();\n  if (explicit) {\n    return explicit.toLowerCase();\n  }\n  const cleanName = name?.trim();\n  if (!cleanName) {\n    return null;\n  }\n  const cleanNamespace = namespace?.trim();\n  const scope = cleanNamespace ? `${cleanNamespace}/${cleanName}` : cleanName;\n  return scope.toLowerCase();\n}\n\n/** @deprecated Use {@link ResolveUserStateScope}. */\nexport function resolveUserStateScope(\n  explicitScope: string | undefined | null,\n  namespace: string | undefined | null,\n  name: string | undefined | null\n): string | null {\n  return ResolveUserStateScope(explicitScope, namespace, name);\n}\n\n/**\n * Build the full storage key for a resolved scope, or `null` when the scope is\n * `null` (persistence should be skipped).\n */\nexport function UserStateStorageKey(scope: string | null): string | null {\n  return scope ? `${USER_STATE_KEY_PREFIX}${scope}` : null;\n}\n\n/** @deprecated Use {@link UserStateStorageKey}. */\nexport function userStateStorageKey(scope: string | null): string | null {\n  return UserStateStorageKey(scope);\n}\n\n/**\n * Safely parse a stored settings blob into a plain object. Returns `{}` for\n * null/empty input, invalid JSON, or any non-object JSON (arrays, primitives) —\n * persisted user settings are always a flat key/value object.\n */\nexport function ParseStoredUserSettings(raw: string | undefined | null): Record<string, unknown> {\n  if (!raw) {\n    return {};\n  }\n  try {\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {\n      return parsed as Record<string, unknown>;\n    }\n    return {};\n  } catch {\n    return {};\n  }\n}\n\n/** @deprecated Use {@link ParseStoredUserSettings}. */\nexport function parseStoredUserSettings(raw: string | undefined | null): Record<string, unknown> {\n  return ParseStoredUserSettings(raw);\n}\n\n/**\n * Merge host-provided defaults with the stored per-user settings. Stored values\n * win, so a returning user sees their saved preferences while a host can still\n * seed sensible first-run defaults that fill any gaps.\n */\nexport function MergeUserSettings(\n  hostDefaults: Record<string, unknown> | undefined | null,\n  stored: Record<string, unknown> | undefined | null\n): Record<string, unknown> {\n  return { ...(hostDefaults ?? {}), ...(stored ?? {}) };\n}\n\n/** @deprecated Use {@link MergeUserSettings}. */\nexport function mergeUserSettings(\n  hostDefaults: Record<string, unknown> | undefined | null,\n  stored: Record<string, unknown> | undefined | null\n): Record<string, unknown> {\n  return MergeUserSettings(hostDefaults, stored);\n}\n\n/**\n * Apply an `onSaveUserSettings` payload to the host's current settings snapshot.\n *\n * **Merge, not replace.** The contract asks components to pass the complete\n * settings object, but the host must be resilient to a component (especially an\n * AI-generated one) passing only the changed keys — and to the stale-prop case\n * where a component spreads the mount-time `savedUserSettings` prop, which the\n * host deliberately never refreshes mid-session (no re-render on save). Under\n * full-replace semantics either slip silently wipes every other saved\n * preference; under merge the worst case is a no-op.\n *\n * **Removing a key requires explicit intent**: set its value to `null` and the\n * key is deleted from the snapshot (reads fall back to defaults via the\n * documented `savedUserSettings?.key ?? fallback` pattern). `undefined` values\n * are treated the same way, since `JSON.stringify` would drop them from the\n * persisted blob anyway and the in-memory snapshot must stay consistent with\n * what is stored.\n *\n * @returns a new object — neither input is mutated.\n */\nexport function ApplyUserSettingsUpdate(\n  current: Record<string, unknown> | undefined | null,\n  incoming: Record<string, unknown> | undefined | null\n): Record<string, unknown> {\n  const next: Record<string, unknown> = { ...(current ?? {}) };\n  for (const [key, value] of Object.entries(incoming ?? {})) {\n    if (value === null || value === undefined) {\n      delete next[key];\n    } else {\n      next[key] = value;\n    }\n  }\n  return next;\n}\n\n/** @deprecated Use {@link ApplyUserSettingsUpdate}. */\nexport function applyUserSettingsUpdate(\n  current: Record<string, unknown> | undefined | null,\n  incoming: Record<string, unknown> | undefined | null\n): Record<string, unknown> {\n  return ApplyUserSettingsUpdate(current, incoming);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/react-runtime",
-  "version": "6.2.0-edge.0",
+  "version": "6.2.0-edge.2",
   "description": "Platform-agnostic React component runtime for MemberJunction. Provides core compilation, registry, and execution capabilities for React components in any JavaScript environment.",
   "type": "module",
   "main": "dist/index.js",
@@ -20,12 +20,12 @@
   "homepage": "https://github.com/MemberJunction/MJ#readme",
   "dependencies": {
     "@babel/standalone": "^7.29.1",
-    "@memberjunction/ai-vectors-memory": "6.2.0-edge.0",
-    "@memberjunction/core": "6.2.0-edge.0",
-    "@memberjunction/core-entities": "6.2.0-edge.0",
-    "@memberjunction/global": "6.2.0-edge.0",
-    "@memberjunction/graphql-dataprovider": "6.2.0-edge.0",
-    "@memberjunction/interactive-component-types": "6.2.0-edge.0",
+    "@memberjunction/ai-vectors-memory": "6.2.0-edge.2",
+    "@memberjunction/core": "6.2.0-edge.2",
+    "@memberjunction/core-entities": "6.2.0-edge.2",
+    "@memberjunction/global": "6.2.0-edge.2",
+    "@memberjunction/graphql-dataprovider": "6.2.0-edge.2",
+    "@memberjunction/interactive-component-types": "6.2.0-edge.2",
     "rxjs": "^7.8.2"
   },
   "devDependencies": {

package/src/__tests__/error-boundary.test.ts

@@ -0,0 +1,80 @@
+import { describe, it, expect, vi } from 'vitest';
+import { CreateErrorBoundary } from '../runtime/error-boundary';
+
+/**
+ * Minimal stand-in for the React the runtime is handed at call time. This package takes
+ * React as an injected `any` and has no react dependency of its own, so the tests below
+ * reproduce React's calling convention rather than importing the library.
+ */
+function makeFakeReact() {
+    return {
+        Component: class {
+            props: any;
+            state: any;
+            constructor(props: any) {
+                this.props = props;
+            }
+            setState(update: any) {
+                const next = typeof update === 'function' ? update(this.state) : update;
+                this.state = { ...this.state, ...next };
+            }
+        },
+        createElement: (type: any, props: any, ...children: any[]) => ({ type, props, children }),
+    };
+}
+
+describe('CreateErrorBoundary — React lifecycle contract', () => {
+    /**
+     * react-dom reads the static into a local and invokes it with no receiver:
+     *
+     *     var getDerivedStateFromError = fiber.type.getDerivedStateFromError;
+     *     ... getDerivedStateFromError(error);
+     *
+     * Anything that reaches `this` in that call throws — and it throws while React is
+     * already handling the child's error, so the boundary never renders and the whole
+     * tree unmounts. The name must therefore sit on the real declaration, never on a
+     * forwarding stub.
+     */
+    it('exposes getDerivedStateFromError as a static that survives an unbound call', () => {
+        const Boundary = CreateErrorBoundary(makeFakeReact(), { logErrors: false });
+
+        const getDerivedStateFromError = Boundary.getDerivedStateFromError;
+        expect(typeof getDerivedStateFromError).toBe('function');
+
+        const error = new Error('boom');
+        const next = getDerivedStateFromError(error);
+
+        expect(next).toEqual({ hasError: true, error });
+    });
+
+    /** React calls this one ON the instance, so an ordinary prototype method is correct. */
+    it('calls the error handler from componentDidCatch on the instance', () => {
+        const onError = vi.fn();
+        const React = makeFakeReact();
+        const Boundary = CreateErrorBoundary(React, { logErrors: false, onError });
+
+        const instance = new Boundary({});
+        const error = new Error('boom');
+        const errorInfo = { componentStack: 'at Boom' };
+
+        instance.componentDidCatch(error, errorInfo);
+
+        expect(onError).toHaveBeenCalledWith(error, errorInfo);
+        expect(instance.State.errorInfo).toBe(errorInfo);
+    });
+
+    /** The fallback is what the two members above exist to reach. */
+    it('renders the fallback once the error state is applied', () => {
+        const React = makeFakeReact();
+        const Boundary = CreateErrorBoundary(React, {
+            logErrors: false,
+            fallback: () => React.createElement('div', null, 'FALLBACK'),
+        });
+
+        const instance = new Boundary({});
+        instance.setState(Boundary.getDerivedStateFromError(new Error('boom')));
+
+        const tree = instance.render();
+        expect(tree.children).toContain('FALLBACK');
+    });
+});

package/src/__tests__/runtime-utilities-factory.test.ts

@@ -13,7 +13,7 @@
  */
 import { describe, it, expect, beforeEach } from 'vitest';
 import { MJGlobal, RegisterClass } from '@memberjunction/global';
-import { RuntimeUtilities, createRuntimeUtilities } from '../utilities/runtime-utilities';
+import { RuntimeUtilities, CreateRuntimeUtilities } from '../utilities/runtime-utilities';
 
 /** A host's substitute implementation, registered above the base. */
 @RegisterClass(RuntimeUtilities, 'RuntimeUtilities', 10)
@@ -29,13 +29,13 @@ describe('createRuntimeUtilities', () => {
     });
 
     it('resolves a registered subclass in a browser environment', () => {
-        const utilities = createRuntimeUtilities();
+        const utilities = CreateRuntimeUtilities();
         expect(utilities).toBeInstanceOf(HostRuntimeUtilities);
     });
 
     it('returns something that is still a RuntimeUtilities', () => {
         // The contract callers rely on: whatever comes back exposes `buildUtilities`.
-        const utilities = createRuntimeUtilities();
+        const utilities = CreateRuntimeUtilities();
         expect(utilities).toBeInstanceOf(RuntimeUtilities);
         expect(typeof utilities.buildUtilities).toBe('function');
     });
@@ -51,7 +51,7 @@ describe('createRuntimeUtilities', () => {
             throw new Error('simulated resolution failure');
         };
         try {
-            expect(createRuntimeUtilities()).toBeInstanceOf(RuntimeUtilities);
+            expect(CreateRuntimeUtilities()).toBeInstanceOf(RuntimeUtilities);
         } finally {
             factory.CreateInstance = original;
         }

package/src/__tests__/user-state.test.ts

@@ -1,99 +1,99 @@
 import { describe, it, expect } from 'vitest';
 import {
   USER_STATE_KEY_PREFIX,
-  resolveUserStateScope,
-  userStateStorageKey,
-  parseStoredUserSettings,
-  mergeUserSettings,
-  applyUserSettingsUpdate
+  ResolveUserStateScope,
+  UserStateStorageKey,
+  ParseStoredUserSettings,
+  MergeUserSettings,
+  ApplyUserSettingsUpdate
 } from '../utilities/user-state';
 
 describe('user-state helpers', () => {
   describe('resolveUserStateScope', () => {
     it('prefers an explicit scope over namespace/name', () => {
-      expect(resolveUserStateScope('Form/Contacts', 'crm', 'ContactForm')).toBe('form/contacts');
+      expect(ResolveUserStateScope('Form/Contacts', 'crm', 'ContactForm')).toBe('form/contacts');
     });
 
     it('lowercases the explicit scope', () => {
-      expect(resolveUserStateScope('MyDashboard', null, null)).toBe('mydashboard');
+      expect(ResolveUserStateScope('MyDashboard', null, null)).toBe('mydashboard');
     });
 
     it('trims surrounding whitespace from the explicit scope', () => {
-      expect(resolveUserStateScope('  Spaced  ', null, null)).toBe('spaced');
+      expect(ResolveUserStateScope('  Spaced  ', null, null)).toBe('spaced');
     });
 
     it('combines namespace and name when no explicit scope is given', () => {
-      expect(resolveUserStateScope(undefined, 'CRM/Analytics', 'AccountDashboard'))
+      expect(ResolveUserStateScope(undefined, 'CRM/Analytics', 'AccountDashboard'))
         .toBe('crm/analytics/accountdashboard');
     });
 
     it('uses just the name when there is no namespace', () => {
-      expect(resolveUserStateScope(undefined, undefined, 'SalesReport')).toBe('salesreport');
-      expect(resolveUserStateScope(null, '   ', 'SalesReport')).toBe('salesreport');
+      expect(ResolveUserStateScope(undefined, undefined, 'SalesReport')).toBe('salesreport');
+      expect(ResolveUserStateScope(null, '   ', 'SalesReport')).toBe('salesreport');
     });
 
     it('returns null when no stable scope can be derived', () => {
-      expect(resolveUserStateScope(undefined, undefined, undefined)).toBeNull();
-      expect(resolveUserStateScope('', '', '')).toBeNull();
-      expect(resolveUserStateScope('   ', 'crm', '   ')).toBeNull();
+      expect(ResolveUserStateScope(undefined, undefined, undefined)).toBeNull();
+      expect(ResolveUserStateScope('', '', '')).toBeNull();
+      expect(ResolveUserStateScope('   ', 'crm', '   ')).toBeNull();
     });
   });
 
   describe('userStateStorageKey', () => {
     it('prefixes a resolved scope with the unique root namespace', () => {
-      expect(userStateStorageKey('form/contacts')).toBe(`${USER_STATE_KEY_PREFIX}form/contacts`);
-      expect(userStateStorageKey('form/contacts')).toBe('InteractiveComponents_UserState_Root/form/contacts');
+      expect(UserStateStorageKey('form/contacts')).toBe(`${USER_STATE_KEY_PREFIX}form/contacts`);
+      expect(UserStateStorageKey('form/contacts')).toBe('InteractiveComponents_UserState_Root/form/contacts');
     });
 
     it('returns null for a null scope', () => {
-      expect(userStateStorageKey(null)).toBeNull();
+      expect(UserStateStorageKey(null)).toBeNull();
     });
   });
 
   describe('parseStoredUserSettings', () => {
     it('parses a valid JSON object', () => {
-      expect(parseStoredUserSettings('{"sortBy":"Name","page":2}')).toEqual({ sortBy: 'Name', page: 2 });
+      expect(ParseStoredUserSettings('{"sortBy":"Name","page":2}')).toEqual({ sortBy: 'Name', page: 2 });
     });
 
     it('returns an empty object for null/undefined/empty input', () => {
-      expect(parseStoredUserSettings(null)).toEqual({});
-      expect(parseStoredUserSettings(undefined)).toEqual({});
-      expect(parseStoredUserSettings('')).toEqual({});
+      expect(ParseStoredUserSettings(null)).toEqual({});
+      expect(ParseStoredUserSettings(undefined)).toEqual({});
+      expect(ParseStoredUserSettings('')).toEqual({});
     });
 
     it('returns an empty object for invalid JSON instead of throwing', () => {
-      expect(parseStoredUserSettings('{not valid json')).toEqual({});
+      expect(ParseStoredUserSettings('{not valid json')).toEqual({});
     });
 
     it('returns an empty object for non-object JSON (arrays, primitives)', () => {
-      expect(parseStoredUserSettings('[1,2,3]')).toEqual({});
-      expect(parseStoredUserSettings('42')).toEqual({});
-      expect(parseStoredUserSettings('"hello"')).toEqual({});
-      expect(parseStoredUserSettings('null')).toEqual({});
+      expect(ParseStoredUserSettings('[1,2,3]')).toEqual({});
+      expect(ParseStoredUserSettings('42')).toEqual({});
+      expect(ParseStoredUserSettings('"hello"')).toEqual({});
+      expect(ParseStoredUserSettings('null')).toEqual({});
     });
   });
 
   describe('mergeUserSettings', () => {
     it('lets stored values win over host defaults', () => {
-      const merged = mergeUserSettings({ sortBy: 'CloseDate', viewMode: 'grid' }, { sortBy: 'Name' });
+      const merged = MergeUserSettings({ sortBy: 'CloseDate', viewMode: 'grid' }, { sortBy: 'Name' });
       expect(merged).toEqual({ sortBy: 'Name', viewMode: 'grid' });
     });
 
     it('keeps host defaults that the stored settings do not override', () => {
-      expect(mergeUserSettings({ a: 1, b: 2 }, { b: 3 })).toEqual({ a: 1, b: 3 });
+      expect(MergeUserSettings({ a: 1, b: 2 }, { b: 3 })).toEqual({ a: 1, b: 3 });
     });
 
     it('handles null/undefined on either side', () => {
-      expect(mergeUserSettings(null, { x: 1 })).toEqual({ x: 1 });
-      expect(mergeUserSettings({ x: 1 }, null)).toEqual({ x: 1 });
-      expect(mergeUserSettings(null, null)).toEqual({});
-      expect(mergeUserSettings(undefined, undefined)).toEqual({});
+      expect(MergeUserSettings(null, { x: 1 })).toEqual({ x: 1 });
+      expect(MergeUserSettings({ x: 1 }, null)).toEqual({ x: 1 });
+      expect(MergeUserSettings(null, null)).toEqual({});
+      expect(MergeUserSettings(undefined, undefined)).toEqual({});
     });
 
     it('returns a new object (does not mutate inputs)', () => {
       const defaults = { a: 1 };
       const stored = { b: 2 };
-      const merged = mergeUserSettings(defaults, stored);
+      const merged = MergeUserSettings(defaults, stored);
       expect(merged).not.toBe(defaults);
       expect(merged).not.toBe(stored);
       expect(defaults).toEqual({ a: 1 });
@@ -103,13 +103,13 @@ describe('user-state helpers', () => {
 
   describe('applyUserSettingsUpdate', () => {
     it('overlays incoming keys onto the current snapshot', () => {
-      expect(applyUserSettingsUpdate({ viewMode: 'grid', sortBy: 'CloseDate' }, { sortBy: 'Name' }))
+      expect(ApplyUserSettingsUpdate({ viewMode: 'grid', sortBy: 'CloseDate' }, { sortBy: 'Name' }))
         .toEqual({ viewMode: 'grid', sortBy: 'Name' });
     });
 
     it('preserves untouched keys when a component passes only a delta', () => {
       // The AI-forgot-the-spread case: a delta must not wipe other preferences.
-      expect(applyUserSettingsUpdate({ viewMode: 'grid', page: 3 }, { sortBy: 'Name' }))
+      expect(ApplyUserSettingsUpdate({ viewMode: 'grid', page: 3 }, { sortBy: 'Name' }))
         .toEqual({ viewMode: 'grid', page: 3, sortBy: 'Name' });
     });
 
@@ -117,35 +117,35 @@ describe('user-state helpers', () => {
       // Component spreads the mount-time prop both times; the host snapshot
       // must still accumulate both changes.
       const mountProp = { viewMode: 'grid' };
-      let snapshot = applyUserSettingsUpdate(mountProp, { ...mountProp, sortBy: 'Name' });
-      snapshot = applyUserSettingsUpdate(snapshot, { ...mountProp, viewMode: 'list' });
+      let snapshot = ApplyUserSettingsUpdate(mountProp, { ...mountProp, sortBy: 'Name' });
+      snapshot = ApplyUserSettingsUpdate(snapshot, { ...mountProp, viewMode: 'list' });
       expect(snapshot).toEqual({ viewMode: 'list', sortBy: 'Name' });
     });
 
     it('removes a key when its incoming value is explicitly null', () => {
-      expect(applyUserSettingsUpdate({ sortBy: 'Name', viewMode: 'grid' }, { sortBy: null }))
+      expect(ApplyUserSettingsUpdate({ sortBy: 'Name', viewMode: 'grid' }, { sortBy: null }))
         .toEqual({ viewMode: 'grid' });
     });
 
     it('removes a key when its incoming value is undefined', () => {
-      expect(applyUserSettingsUpdate({ sortBy: 'Name', viewMode: 'grid' }, { sortBy: undefined }))
+      expect(ApplyUserSettingsUpdate({ sortBy: 'Name', viewMode: 'grid' }, { sortBy: undefined }))
         .toEqual({ viewMode: 'grid' });
     });
 
     it('treats a full-object payload as a superset (replace-equivalent)', () => {
-      expect(applyUserSettingsUpdate({ a: 1, b: 2 }, { a: 10, b: 20 })).toEqual({ a: 10, b: 20 });
+      expect(ApplyUserSettingsUpdate({ a: 1, b: 2 }, { a: 10, b: 20 })).toEqual({ a: 10, b: 20 });
     });
 
     it('handles null/undefined on either side', () => {
-      expect(applyUserSettingsUpdate(null, { x: 1 })).toEqual({ x: 1 });
-      expect(applyUserSettingsUpdate({ x: 1 }, null)).toEqual({ x: 1 });
-      expect(applyUserSettingsUpdate(null, null)).toEqual({});
+      expect(ApplyUserSettingsUpdate(null, { x: 1 })).toEqual({ x: 1 });
+      expect(ApplyUserSettingsUpdate({ x: 1 }, null)).toEqual({ x: 1 });
+      expect(ApplyUserSettingsUpdate(null, null)).toEqual({});
     });
 
     it('returns a new object (does not mutate inputs)', () => {
       const current = { a: 1 };
       const incoming = { b: 2 };
-      const next = applyUserSettingsUpdate(current, incoming);
+      const next = ApplyUserSettingsUpdate(current, incoming);
       expect(next).not.toBe(current);
       expect(next).not.toBe(incoming);
       expect(current).toEqual({ a: 1 });

package/src/compiler/babel-config.ts

@@ -51,16 +51,21 @@ export const DEVELOPMENT_CONFIG = {
  * @param production - Whether to use production configuration
  * @returns Babel configuration object
  */
-export function getBabelConfig(production: boolean = false) {
+export function GetBabelConfig(production: boolean = false) {
   return production ? PRODUCTION_CONFIG : DEVELOPMENT_CONFIG;
 }
 
+/** @deprecated Use {@link GetBabelConfig}. */
+export function getBabelConfig(production: boolean = false) {
+  return GetBabelConfig(production);
+}
+
 /**
  * Validates that required Babel presets are available
  * @param babel - Babel instance to check
  * @returns true if all required presets are available
  */
-export function validateBabelPresets(babel: any): boolean {
+export function ValidateBabelPresets(babel: any): boolean {
   if (!babel || !babel.availablePresets) {
     return false;
   }
@@ -69,6 +74,11 @@ export function validateBabelPresets(babel: any): boolean {
   return 'react' in babel.availablePresets;
 }
 
+/** @deprecated Use {@link ValidateBabelPresets}. */
+export function validateBabelPresets(babel: any): boolean {
+  return ValidateBabelPresets(babel);
+}
+
 /**
  * Common JSX pragma options for different React versions
  */
@@ -88,10 +98,15 @@ export const JSX_PRAGMAS = {
  * @param reactVersion - React version (e.g., "18.2.0")
  * @returns JSX configuration options
  */
-export function getJSXConfig(reactVersion?: string) {
+export function GetJSXConfig(reactVersion?: string) {
   // React 17+ supports the new JSX transform
   if (reactVersion && parseInt(reactVersion.split('.')[0]) >= 17) {
     return JSX_PRAGMAS.automatic;
   }
   return JSX_PRAGMAS.classic;
+}
+
+/** @deprecated Use {@link GetJSXConfig}. */
+export function getJSXConfig(reactVersion?: string) {
+  return GetJSXConfig(reactVersion);
 }