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

package/src/runtime/component-hierarchy.ts

@@ -117,7 +117,7 @@ export class ComponentHierarchyRegistrar {
    * @param options - Registration options
    * @returns Registration result with details about success/failures
    */
-  async registerHierarchy(
+  async RegisterHierarchy(
     rootSpec: ComponentSpec,
     options: HierarchyRegistrationOptions
   ): Promise<HierarchyRegistrationResult> {
@@ -297,13 +297,21 @@ export class ComponentHierarchyRegistrar {
     };
   }
 
+  /** @deprecated Use {@link RegisterHierarchy}. */
+  async registerHierarchy(
+    rootSpec: ComponentSpec,
+    options: HierarchyRegistrationOptions
+  ): Promise<HierarchyRegistrationResult> {
+    return this.RegisterHierarchy(rootSpec, options);
+  }
+
   /**
    * Registers a single component from a specification
    * @param spec - Component specification
    * @param options - Registration options
    * @returns Registration result for this component
    */
-  async registerSingleComponent(
+  async RegisterSingleComponent(
     spec: ComponentSpec,
     options: {
       styles?: ComponentStyles;
@@ -423,6 +431,20 @@ export class ComponentHierarchyRegistrar {
     }
   }
 
+  /** @deprecated Use {@link RegisterSingleComponent}. */
+  async registerSingleComponent(
+    spec: ComponentSpec,
+    options: {
+      styles?: ComponentStyles;
+      namespace?: string;
+      version?: string;
+      allowOverride?: boolean;
+      allLibraries: MJComponentLibraryEntity[];
+    }
+  ): Promise<{ success: boolean; error?: ComponentRegistrationError }> {
+    return this.RegisterSingleComponent(spec, options);
+  }
+
   /**
    * Recursively registers child components
    * @param children - Array of child component specifications
@@ -440,7 +462,7 @@ export class ComponentHierarchyRegistrar {
   ): Promise<void> {
     for (const child of children) {
       // Register this child
-      const childResult = await this.registerSingleComponent(child, {
+      const childResult = await this.RegisterSingleComponent(child, {
         styles: options.styles,
         namespace: options.namespace,
         version: options.version,
@@ -483,7 +505,7 @@ export class ComponentHierarchyRegistrar {
  * @param options - Registration options
  * @returns Registration result
  */
-export async function registerComponentHierarchy(
+export async function RegisterComponentHierarchy(
   rootSpec: ComponentSpec,
   compiler: ComponentCompiler,
   registry: ComponentRegistry,
@@ -494,12 +516,23 @@ export async function registerComponentHierarchy(
   return registrar.registerHierarchy(rootSpec, options);
 }
 
+/** @deprecated Use {@link RegisterComponentHierarchy}. */
+export async function registerComponentHierarchy(
+  rootSpec: ComponentSpec,
+  compiler: ComponentCompiler,
+  registry: ComponentRegistry,
+  runtimeContext: RuntimeContext,
+  options: HierarchyRegistrationOptions
+): Promise<HierarchyRegistrationResult> {
+  return RegisterComponentHierarchy(rootSpec, compiler, registry, runtimeContext, options);
+}
+
 /**
  * Validates a component specification before registration
  * @param spec - Component specification to validate
  * @returns Array of validation errors (empty if valid)
  */
-export function validateComponentSpec(spec: ComponentSpec): string[] {
+export function ValidateComponentSpec(spec: ComponentSpec): string[] {
   const errors: string[] = [];
 
   if (!spec.name) {
@@ -519,7 +552,7 @@ export function validateComponentSpec(spec: ComponentSpec): string[] {
   // Validate child components recursively
   const children = spec.dependencies || [];
   children.forEach((child, index) => {
-    const childErrors = validateComponentSpec(child);
+    const childErrors = ValidateComponentSpec(child);
     childErrors.forEach(error => {
       errors.push(`Child ${index} (${child.name || 'unnamed'}): ${error}`);
     });
@@ -528,29 +561,39 @@ export function validateComponentSpec(spec: ComponentSpec): string[] {
   return errors;
 }
 
+/** @deprecated Use {@link ValidateComponentSpec}. */
+export function validateComponentSpec(spec: ComponentSpec): string[] {
+  return ValidateComponentSpec(spec);
+}
+
 /**
  * Flattens a component hierarchy into a list of all components
  * @param rootSpec - The root component specification
  * @returns Array of all component specifications in the hierarchy
  */
-export function flattenComponentHierarchy(rootSpec: ComponentSpec): ComponentSpec[] {
+export function FlattenComponentHierarchy(rootSpec: ComponentSpec): ComponentSpec[] {
   const components: ComponentSpec[] = [rootSpec];
   
   const children = rootSpec.dependencies || [];
   children.forEach(child => {
-    components.push(...flattenComponentHierarchy(child));
+    components.push(...FlattenComponentHierarchy(child));
   });
 
   return components;
 }
 
+/** @deprecated Use {@link FlattenComponentHierarchy}. */
+export function flattenComponentHierarchy(rootSpec: ComponentSpec): ComponentSpec[] {
+  return FlattenComponentHierarchy(rootSpec);
+}
+
 /**
  * Counts the total number of components in a hierarchy
  * @param rootSpec - The root component specification
  * @param includeEmpty - Whether to include components without code
  * @returns Total component count
  */
-export function countComponentsInHierarchy(
+export function CountComponentsInHierarchy(
   rootSpec: ComponentSpec,
   includeEmpty: boolean = false
 ): number {
@@ -562,8 +605,16 @@ export function countComponentsInHierarchy(
 
   const children = rootSpec.dependencies || [];
   children.forEach(child => {
-    count += countComponentsInHierarchy(child, includeEmpty);
+    count += CountComponentsInHierarchy(child, includeEmpty);
   });
 
   return count;
+}
+
+/** @deprecated Use {@link CountComponentsInHierarchy}. */
+export function countComponentsInHierarchy(
+  rootSpec: ComponentSpec,
+  includeEmpty: boolean = false
+): number {
+  return CountComponentsInHierarchy(rootSpec, includeEmpty);
 }

package/src/runtime/error-boundary.ts

@@ -12,7 +12,7 @@ import { ErrorBoundaryOptions, ComponentError } from '../types';
  * @param options - Error boundary options
  * @returns Error boundary component class
  */
-export function createErrorBoundary(React: any, options: ErrorBoundaryOptions = {}): any {
+export function CreateErrorBoundary(React: any, options: ErrorBoundaryOptions = {}): any {
   const {
     onError,
     fallback,
@@ -24,11 +24,20 @@ export function createErrorBoundary(React: any, options: ErrorBoundaryOptions =
    * Error boundary component class
    */
   return class ErrorBoundary extends React.Component {
-    state: { hasError: boolean; error: Error | null; errorInfo: any; retryCount: number };
+    State: { hasError: boolean; error: Error | null; errorInfo: any; retryCount: number };
+
+    /** @deprecated Use {@link State}. */
+    get state(): { hasError: boolean; error: Error | null; errorInfo: any; retryCount: number } {
+      return this.State;
+    }
+    /** @deprecated Use {@link State}. */
+    set state(value: { hasError: boolean; error: Error | null; errorInfo: any; retryCount: number }) {
+      this.State = value;
+    }
 
     constructor(props: any) {
       super(props);
-      this.state = {
+      this.State = {
         hasError: false,
         error: null,
         errorInfo: null,
@@ -36,6 +45,10 @@ export function createErrorBoundary(React: any, options: ErrorBoundaryOptions =
       };
     }
 
+    // React reads this static into a local and calls it UNBOUND
+    // (`var f = fiber.type.getDerivedStateFromError; f(error)`), so a stub that
+    // forwards through `this` throws while handling the child's error and unmounts
+    // the whole tree. The name has to stay on the real declaration.
     static getDerivedStateFromError(error: Error): any {
       // Update state to trigger fallback UI
       return { hasError: true, error };
@@ -61,7 +74,7 @@ export function createErrorBoundary(React: any, options: ErrorBoundaryOptions =
       this.setState({ errorInfo });
     }
 
-    handleRetry = () => {
+    HandleRetry = () => {
       this.setState((prevState: any) => ({
         hasError: false,
         error: null,
@@ -70,7 +83,16 @@ export function createErrorBoundary(React: any, options: ErrorBoundaryOptions =
       }));
     };
 
-    handleReset = () => {
+    /** @deprecated Use {@link HandleRetry}. */
+    get handleRetry() {
+      return this.HandleRetry;
+    }
+    /** @deprecated Use {@link HandleRetry}. */
+    set handleRetry(value) {
+      this.HandleRetry = value;
+    }
+
+    HandleReset = () => {
       this.setState({
         hasError: false,
         error: null,
@@ -79,24 +101,33 @@ export function createErrorBoundary(React: any, options: ErrorBoundaryOptions =
       });
     };
 
+    /** @deprecated Use {@link HandleReset}. */
+    get handleReset() {
+      return this.HandleReset;
+    }
+    /** @deprecated Use {@link HandleReset}. */
+    set handleReset(value) {
+      this.HandleReset = value;
+    }
+
     render() {
-      if (this.state.hasError) {
+      if (this.State.hasError) {
         // Use custom fallback if provided
         if (fallback) {
           if (typeof fallback === 'function') {
             return fallback({
-              error: this.state.error,
-              errorInfo: this.state.errorInfo,
-              retry: this.handleRetry,
-              reset: this.handleReset,
-              retryCount: this.state.retryCount
+              error: this.State.error,
+              errorInfo: this.State.errorInfo,
+              retry: this.HandleRetry,
+              reset: this.HandleReset,
+              retryCount: this.State.retryCount
             });
           }
           return fallback;
         }
 
         // Default error UI
-        const showRetry = recovery === 'retry' && this.state.retryCount < 3;
+        const showRetry = recovery === 'retry' && this.State.retryCount < 3;
         const showReset = recovery === 'reset';
 
         return React.createElement(
@@ -116,7 +147,7 @@ export function createErrorBoundary(React: any, options: ErrorBoundaryOptions =
             { style: { color: '#666' } },
             'An error occurred while rendering this component.'
           ),
-          this.state.error && React.createElement(
+          this.State.error && React.createElement(
             'details',
             { style: { marginTop: '10px' } },
             React.createElement(
@@ -135,9 +166,9 @@ export function createErrorBoundary(React: any, options: ErrorBoundaryOptions =
                   fontSize: '12px'
                 }
               },
-              this.state.error.toString(),
+              this.State.error.toString(),
               '\n\n',
-              this.state.error.stack
+              this.State.error.stack
             )
           ),
           (showRetry || showReset) && React.createElement(
@@ -146,7 +177,7 @@ export function createErrorBoundary(React: any, options: ErrorBoundaryOptions =
             showRetry && React.createElement(
               'button',
               {
-                onClick: this.handleRetry,
+                onClick: this.HandleRetry,
                 style: {
                   padding: '8px 16px',
                   marginRight: '10px',
@@ -157,12 +188,12 @@ export function createErrorBoundary(React: any, options: ErrorBoundaryOptions =
                   cursor: 'pointer'
                 }
               },
-              `Retry (${3 - this.state.retryCount} attempts left)`
+              `Retry (${3 - this.State.retryCount} attempts left)`
             ),
             showReset && React.createElement(
               'button',
               {
-                onClick: this.handleReset,
+                onClick: this.HandleReset,
                 style: {
                   padding: '8px 16px',
                   backgroundColor: '#757575',
@@ -183,6 +214,11 @@ export function createErrorBoundary(React: any, options: ErrorBoundaryOptions =
   };
 }
 
+/** @deprecated Use {@link CreateErrorBoundary}. */
+export function createErrorBoundary(React: any, options: ErrorBoundaryOptions = {}): any {
+  return CreateErrorBoundary(React, options);
+}
+
 /**
  * Creates a functional error boundary wrapper using React hooks
  * @param React - React library instance
@@ -190,8 +226,8 @@ export function createErrorBoundary(React: any, options: ErrorBoundaryOptions =
  * @param options - Error boundary options
  * @returns Wrapped component with error boundary
  */
-export function withErrorBoundary(React: any, Component: any, options: ErrorBoundaryOptions = {}): any {
-  const ErrorBoundaryComponent = createErrorBoundary(React, options);
+export function WithErrorBoundary(React: any, Component: any, options: ErrorBoundaryOptions = {}): any {
+  const ErrorBoundaryComponent = CreateErrorBoundary(React, options);
   
   return (props: any) => {
     return React.createElement(
@@ -202,6 +238,11 @@ export function withErrorBoundary(React: any, Component: any, options: ErrorBoun
   };
 }
 
+/** @deprecated Use {@link WithErrorBoundary}. */
+export function withErrorBoundary(React: any, Component: any, options: ErrorBoundaryOptions = {}): any {
+  return WithErrorBoundary(React, Component, options);
+}
+
 /**
  * Formats a component error for display or logging
  * @param error - Error to format
@@ -209,7 +250,7 @@ export function withErrorBoundary(React: any, Component: any, options: ErrorBoun
  * @param phase - Phase when error occurred
  * @returns Formatted component error
  */
-export function formatComponentError(
+export function FormatComponentError(
   error: Error,
   componentName: string,
   phase: ComponentError['phase']
@@ -226,12 +267,21 @@ export function formatComponentError(
   };
 }
 
+/** @deprecated Use {@link FormatComponentError}. */
+export function formatComponentError(
+  error: Error,
+  componentName: string,
+  phase: ComponentError['phase']
+): ComponentError {
+  return FormatComponentError(error, componentName, phase);
+}
+
 /**
  * Creates a simple error logger for error boundaries
  * @param componentName - Name of the component
  * @returns Error logging function
  */
-export function createErrorLogger(componentName: string): (error: Error, errorInfo: any) => void {
+export function CreateErrorLogger(componentName: string): (error: Error, errorInfo: any) => void {
   return (error: Error, errorInfo: any) => {
     console.group(`🚨 React Component Error: ${componentName}`);
     console.error('Error:', error);
@@ -239,4 +289,9 @@ export function createErrorLogger(componentName: string): (error: Error, errorIn
     console.error('Props:', errorInfo.props);
     console.groupEnd();
   };
+}
+
+/** @deprecated Use {@link CreateErrorLogger}. */
+export function createErrorLogger(componentName: string): (error: Error, errorInfo: any) => void {
+  return CreateErrorLogger(componentName);
 }

package/src/runtime/index.ts

@@ -4,31 +4,31 @@
  */
 
 export {
-  createErrorBoundary,
-  withErrorBoundary,
-  formatComponentError,
-  createErrorLogger
+  CreateErrorBoundary, createErrorBoundary,
+  WithErrorBoundary, withErrorBoundary,
+  FormatComponentError, formatComponentError,
+  CreateErrorLogger, createErrorLogger
 } from './error-boundary';
 
 
 export {
-  buildComponentProps,
-  normalizeCallbacks,
-  normalizeStyles,
-  validateComponentProps,
-  mergeProps,
-  createPropsTransformer,
-  wrapCallbacksWithLogging,
-  extractPropPaths,
+  BuildComponentProps, buildComponentProps,
+  NormalizeCallbacks, normalizeCallbacks,
+  NormalizeStyles, normalizeStyles,
+  ValidateComponentProps, validateComponentProps,
+  MergeProps, mergeProps,
+  CreatePropsTransformer, createPropsTransformer,
+  WrapCallbacksWithLogging, wrapCallbacksWithLogging,
+  ExtractPropPaths, extractPropPaths,
   PropBuilderOptions
 } from './prop-builder';
 
 export {
   ComponentHierarchyRegistrar,
-  registerComponentHierarchy,
-  validateComponentSpec,
-  flattenComponentHierarchy,
-  countComponentsInHierarchy,
+  RegisterComponentHierarchy, registerComponentHierarchy,
+  ValidateComponentSpec, validateComponentSpec,
+  FlattenComponentHierarchy, flattenComponentHierarchy,
+  CountComponentsInHierarchy, countComponentsInHierarchy,
   HierarchyRegistrationResult,
   ComponentRegistrationError,
   HierarchyRegistrationOptions

package/src/runtime/prop-builder.ts

@@ -36,7 +36,7 @@ export interface PropBuilderOptions {
  * @param options - Builder options
  * @returns Built component props
  */
-export function buildComponentProps(
+export function BuildComponentProps(
   data: any = {},
   userState: any = {},
   utilities: any = {},
@@ -66,20 +66,38 @@ export function buildComponentProps(
     data: transformedData,
     userState: transformedState,
     utilities,
-    callbacks: normalizeCallbacks(callbacks, debounceUpdateUserState),
+    callbacks: NormalizeCallbacks(callbacks, debounceUpdateUserState),
     components,
-    styles: normalizeStyles(styles),
+    styles: NormalizeStyles(styles),
     onStateChanged
   };
 
   // Validate if enabled
   if (validate) {
-    validateComponentProps(props);
+    ValidateComponentProps(props);
   }
 
   return props;
 }
 
+/** @deprecated Use {@link BuildComponentProps}. */
+export function buildComponentProps(
+  data: any = {},
+  userState: any = {},
+  utilities: any = {},
+  callbacks: ComponentCallbacks = {
+    OpenEntityRecord: () => {},
+    RegisterMethod: () => {},
+    CreateSimpleNotification: () => {}
+  },
+  components: Record<string, any> = {},
+  styles?: ComponentStyles,
+  options: PropBuilderOptions = {},
+  onStateChanged?: (stateUpdate: Record<string, any>) => void
+): ComponentProps {
+  return BuildComponentProps(data, userState, utilities, callbacks, components, styles, options, onStateChanged);
+}
+
 // Store subjects for debouncing per component instance
 const updateUserStateSubjects = new WeakMap<Function, Subject<any>>();
 
@@ -120,7 +138,7 @@ function deepEqual(obj1: any, obj2: any): boolean {
  * @param debounceMs - Debounce time for UpdateUserState in milliseconds
  * @returns Normalized callbacks
  */
-export function normalizeCallbacks(callbacks: any, debounceMs: number = 3000): ComponentCallbacks {
+export function NormalizeCallbacks(callbacks: any, debounceMs: number = 3000): ComponentCallbacks {
   // Provide default implementations for required callbacks
   const normalized: ComponentCallbacks = {
     OpenEntityRecord: callbacks?.OpenEntityRecord || (() => {}),
@@ -140,24 +158,34 @@ export function normalizeCallbacks(callbacks: any, debounceMs: number = 3000): C
   return normalized;
 }
 
+/** @deprecated Use {@link NormalizeCallbacks}. */
+export function normalizeCallbacks(callbacks: any, debounceMs: number = 3000): ComponentCallbacks {
+  return NormalizeCallbacks(callbacks, debounceMs);
+}
+
 /**
  * Normalizes component styles
  * @param styles - Raw styles object
  * @returns Normalized styles
  */
-export function normalizeStyles(styles?: any): any {
+export function NormalizeStyles(styles?: any): any {
   // Pass through the full styles object as-is
   // This allows Skip components to access their full style structure
   // including colors, typography, borders, etc.
   return styles;
 }
 
+/** @deprecated Use {@link NormalizeStyles}. */
+export function normalizeStyles(styles?: any): any {
+  return NormalizeStyles(styles);
+}
+
 /**
  * Validates component props
  * @param props - Props to validate
  * @throws Error if validation fails
  */
-export function validateComponentProps(props: ComponentProps): void {
+export function ValidateComponentProps(props: ComponentProps): void {
   // Validate data
   if (props.data === null || props.data === undefined) {
     throw new Error('Component props.data cannot be null or undefined');
@@ -186,12 +214,17 @@ export function validateComponentProps(props: ComponentProps): void {
   }
 }
 
+/** @deprecated Use {@link ValidateComponentProps}. */
+export function validateComponentProps(props: ComponentProps): void {
+  return ValidateComponentProps(props);
+}
+
 /**
  * Merges multiple prop objects
  * @param propsList - Array of props to merge
  * @returns Merged props
  */
-export function mergeProps(...propsList: Partial<ComponentProps>[]): ComponentProps {
+export function MergeProps(...propsList: Partial<ComponentProps>[]): ComponentProps {
   const merged: ComponentProps = {
     data: {},
     userState: {},
@@ -229,13 +262,18 @@ export function mergeProps(...propsList: Partial<ComponentProps>[]): ComponentPr
 
   return merged;
 }
+
+/** @deprecated Use {@link MergeProps}. */
+export function mergeProps(...propsList: Partial<ComponentProps>[]): ComponentProps {
+  return MergeProps(...propsList);
+}
  
 /**
  * Creates a props transformer function
  * @param transformations - Map of prop paths to transformer functions
  * @returns Props transformer
  */
-export function createPropsTransformer(
+export function CreatePropsTransformer(
   transformations: Record<string, (value: any) => any>
 ): (props: ComponentProps) => ComponentProps {
   return (props: ComponentProps) => {
@@ -264,13 +302,20 @@ export function createPropsTransformer(
   };
 }
 
+/** @deprecated Use {@link CreatePropsTransformer}. */
+export function createPropsTransformer(
+  transformations: Record<string, (value: any) => any>
+): (props: ComponentProps) => ComponentProps {
+  return CreatePropsTransformer(transformations);
+}
+
 /**
  * Creates a callback wrapper that adds logging
  * @param callbacks - Original callbacks
  * @param componentName - Component name for logging
  * @returns Wrapped callbacks
  */
-export function wrapCallbacksWithLogging(
+export function WrapCallbacksWithLogging(
   callbacks: ComponentCallbacks,
   componentName: string
 ): ComponentCallbacks {
@@ -322,12 +367,20 @@ export function wrapCallbacksWithLogging(
   return wrapped;
 }
 
+/** @deprecated Use {@link WrapCallbacksWithLogging}. */
+export function wrapCallbacksWithLogging(
+  callbacks: ComponentCallbacks,
+  componentName: string
+): ComponentCallbacks {
+  return WrapCallbacksWithLogging(callbacks, componentName);
+}
+
 /**
  * Extracts props paths used by a component
  * @param componentCode - Component source code
  * @returns Array of prop paths
  */
-export function extractPropPaths(componentCode: string): string[] {
+export function ExtractPropPaths(componentCode: string): string[] {
   const paths: string[] = [];
   
   // Simple regex patterns to find prop access
@@ -346,4 +399,9 @@ export function extractPropPaths(componentCode: string): string[] {
   }
 
   return [...new Set(paths)]; // Remove duplicates
+}
+
+/** @deprecated Use {@link ExtractPropPaths}. */
+export function extractPropPaths(componentCode: string): string[] {
+  return ExtractPropPaths(componentCode);
 }