@api-client/ui 0.5.30 → 0.5.31

package/build/src/core/ActivityManager.d.ts

@@ -54,9 +54,9 @@ export declare enum IntentFlags {
      */
     ByReference = 4
 }
-export interface Intent {
+export interface Intent<T = unknown> {
     action: string;
-    data?: unknown;
+    data?: T;
     category?: string[];
     flags?: number;
     /**
@@ -68,6 +68,22 @@ export declare enum IntentResult {
     RESULT_CANCELED = 0,
     RESULT_OK = 1
 }
+/**
+ * Type for activity constructor with static action property.
+ */
+export interface ActivityConstructor {
+    new (parent: Application): Activity;
+    action?: string;
+}
+/**
+ * Enhanced activity registration options.
+ */
+export interface ActivityRegistrationOptions {
+    /** Whether to override existing registrations */
+    override?: boolean;
+    /** Optional validation function for intents */
+    validateIntent?: (intent: Intent) => boolean;
+}
 /**
  * Manages application activities.
  *
@@ -97,7 +113,13 @@ export declare class ActivityManager {
     private modalActivityStack;
     private generateActivityId;
     constructor(parent: Application);
-    registerActivity(action: string, activityClass: typeof Activity): void;
+    /**
+     * Registers an activity class with enhanced options.
+     * @param action The action name to register the activity for.
+     * @param activityClass The activity class constructor.
+     * @param options Optional registration configuration.
+     */
+    registerActivity(action: string, activityClass: ActivityConstructor, options?: ActivityRegistrationOptions): void;
     /**
      * Creates an activity and pushes it into the stack, but it does not initialize any of the lifecycle methods.
      * It is a way to put an activity at some place of the stack,
@@ -150,13 +172,99 @@ export declare class ActivityManager {
      * @param activity The activity to bring to the foreground.
      */
     private updateCurrentActivity;
+    /**
+     * Safely executes an async lifecycle method with error handling.
+     * @param lifecycleMethod The lifecycle method to execute.
+     * @param activity The activity instance.
+     * @param methodName The name of the method for error reporting.
+     * @returns Promise that resolves when the method completes or rejects with wrapped error.
+     */
+    private safeExecuteLifecycleMethod;
     /**
      * Allows navigating back through the activity stack.
      * Call `ActivityManager.navigateBack()` when the user performs a back action
      * (e.g., clicks a back button).
+     * @returns Promise that resolves to true if navigation was successful, false if at root.
+     */
+    navigateBack(): Promise<boolean>;
+    /**
+     * Navigates to a specific activity in the stack, clearing activities above it.
+     * @param action The action of the activity to navigate to.
+     * @returns Promise that resolves to true if navigation was successful.
+     */
+    navigateToActivity(action: string): Promise<boolean>;
+    /**
+     * Clears the entire activity stack and starts a new root activity.
+     * @param intent The intent for the new root activity.
+     */
+    clearStackAndStart(intent: Intent): Promise<void>;
+    /**
+     * Creates an intent with better type safety and validation.
+     * @param action The action name.
+     * @param data Optional intent data.
+     * @param options Optional intent configuration.
+     * @returns A properly formed intent.
      */
-    navigateBack(): Promise<void>;
+    createIntent<T = unknown>(action: string, data?: T, options?: {
+        category?: string[];
+        flags?: number;
+        requestCode?: number;
+    }): Intent<T>;
     createRequestCode(): number;
     findActiveActivity(action: string): Activity | undefined;
+    /**
+     * Transitions an activity from Created to Resumed state.
+     * @param activity The activity to transition.
+     * @returns true if successful, false if activity was destroyed during transition.
+     */
+    private transitionCreatedToResumed;
+    /**
+     * Transitions an activity from Started to Resumed state.
+     * @param activity The activity to transition.
+     * @returns true if successful, false if activity was destroyed during transition.
+     */
+    private transitionStartedToResumed;
+    /**
+     * Transitions an activity from Initialized to Resumed state.
+     * @param activity The activity to transition.
+     * @param intent The intent used to create the activity.
+     * @returns true if successful, false if activity was destroyed during transition.
+     */
+    private transitionInitializedToResumed;
+    /**
+     * Cleans up resources for destroyed activities to prevent memory leaks.
+     * @param activity The activity to clean up.
+     */
+    private cleanupActivity;
+    /**
+     * Validates that an activity stack is in a consistent state.
+     * @param stack The activity stack to validate.
+     * @returns Array of validation errors, empty if valid.
+     */
+    private validateStackConsistency;
+    /**
+     * Gets diagnostic information about the current state of the activity manager.
+     * Useful for debugging and monitoring.
+     * @returns Object containing current state information.
+     */
+    getDiagnostics(): {
+        totalActivities: number;
+        modalActivities: number;
+        currentActivity?: string;
+        topActivity?: string;
+        stackValidation: string[];
+        modalStackValidation: string[];
+    };
+    /**
+     * Gets all registered activity actions.
+     * @returns Array of registered action names.
+     */
+    getRegisteredActions(): string[];
+    /**
+     * Checks if an action is registered.
+     * @param action The action to check.
+     * @returns true if the action is registered, false otherwise.
+     */
+    isActionRegistered(action: string): boolean;
 }
 //# sourceMappingURL=ActivityManager.d.ts.map

package/build/src/core/ActivityManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActivityManager.d.ts","sourceRoot":"","sources":["../../../src/core/ActivityManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAGnD,oBAAY,iBAAiB;IAC3B;;;OAGG;IACH,WAAW,IAAA;IACX;;;OAGG;IACH,OAAO,IAAA;IACP;;;OAGG;IACH,OAAO,IAAA;IACP;;;OAGG;IACH,OAAO,IAAA;IACP;;;OAGG;IACH,MAAM,IAAA;IACN;;;OAGG;IACH,OAAO,IAAA;IACP;;;OAGG;IACH,SAAS,IAAA;CACV;AAED,oBAAY,WAAW;IACrB;;OAEG;IACH,KAAK,IAAS;IACd;;OAEG;IACH,SAAS,IAAS;IAClB;;;;;OAKG;IACH,WAAW,IAAS;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,oBAAY,YAAY;IACtB,eAAe,IAAA;IACf,SAAS,IAAA;CACV;AA0BD;;;;;;;;;GASG;AACH,qBAAa,eAAe;;IAC1B,OAAO,CAAC,eAAe,CAAC,CAAU;IAElC;;OAEG;IACH,OAAO,CAAC,eAAe,CAAqC;IAE5D;;;OAGG;IACH,OAAO,CAAC,aAAa,CAA2B;IAEhD;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAA2B;IAErD,OAAO,CAAC,kBAAkB;gBAMd,MAAM,EAAE,WAAW;IAK/B,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,QAAQ,GAAG,IAAI;IAiBtE;;;;;;;;;OASG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAShC;;;;OAIG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDlD,OAAO,CAAC,aAAa;IAgBrB;;;;;OAKG;IACG,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhF,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAIxC;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;YAiCzC,oBAAoB;YAoBpB,wBAAwB;IAYtC,cAAc,IAAI,QAAQ,GAAG,SAAS;IAStC,kBAAkB,IAAI,QAAQ,GAAG,SAAS;IAI1C;;;;;;;OAOG;IACH,WAAW,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,QAAQ,GAAG,IAAI;IAwB9D;;;;;;OAMG;YACW,qBAAqB;IAsEnC;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC,iBAAiB,IAAI,MAAM;IAM3B,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;CAGzD"}
+{"version":3,"file":"ActivityManager.d.ts","sourceRoot":"","sources":["../../../src/core/ActivityManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAGnD,oBAAY,iBAAiB;IAC3B;;;OAGG;IACH,WAAW,IAAA;IACX;;;OAGG;IACH,OAAO,IAAA;IACP;;;OAGG;IACH,OAAO,IAAA;IACP;;;OAGG;IACH,OAAO,IAAA;IACP;;;OAGG;IACH,MAAM,IAAA;IACN;;;OAGG;IACH,OAAO,IAAA;IACP;;;OAGG;IACH,SAAS,IAAA;CACV;AAED,oBAAY,WAAW;IACrB;;OAEG;IACH,KAAK,IAAS;IACd;;OAEG;IACH,SAAS,IAAS;IAClB;;;;;OAKG;IACH,WAAW,IAAS;CACrB;AAED,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,OAAO;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,CAAC,CAAA;IACR,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,oBAAY,YAAY;IACtB,eAAe,IAAA;IACf,SAAS,IAAA;CACV;AA0BD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAA;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;CAC7C;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAe;;IAC1B,OAAO,CAAC,eAAe,CAAC,CAAU;IAElC;;OAEG;IACH,OAAO,CAAC,eAAe,CAAqC;IAE5D;;;OAGG;IACH,OAAO,CAAC,aAAa,CAA2B;IAEhD;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAA2B;IAErD,OAAO,CAAC,kBAAkB;gBAMd,MAAM,EAAE,WAAW;IAK/B;;;;;OAKG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,mBAAmB,EAClC,OAAO,GAAE,2BAAgC,GACxC,IAAI;IA0BP;;;;;;;;;OASG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAShC;;;;OAIG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDlD,OAAO,CAAC,aAAa;IAgBrB;;;;;OAKG;IACG,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhF,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAIxC;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;YAoCzC,oBAAoB;YAoBpB,wBAAwB;IAYtC,cAAc,IAAI,QAAQ,GAAG,SAAS;IAStC,kBAAkB,IAAI,QAAQ,GAAG,SAAS;IAI1C;;;;;;;OAOG;IACH,WAAW,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,QAAQ,GAAG,IAAI;IAwB9D;;;;;;OAMG;YACW,qBAAqB;IAoDnC;;;;;;OAMG;YACW,0BAA0B;IAuBxC;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBtC;;;;OAIG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB1D;;;OAGG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvD;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,GAAG,OAAO,EACtB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,CAAC,EACR,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;QACnB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,WAAW,CAAC,EAAE,MAAM,CAAA;KAChB,GACL,MAAM,CAAC,CAAC,CAAC;IAYZ,iBAAiB,IAAI,MAAM;IAM3B,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIxD;;;;OAIG;YACW,0BAA0B;IAgBxC;;;;OAIG;YACW,0BAA0B;IAUxC;;;;;OAKG;YACW,8BAA8B;IAU5C;;;OAGG;IACH,OAAO,CAAC,eAAe;IAevB;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAsBhC;;;;OAIG;IACH,cAAc,IAAI;QAChB,eAAe,EAAE,MAAM,CAAA;QACvB,eAAe,EAAE,MAAM,CAAA;QACvB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,eAAe,EAAE,MAAM,EAAE,CAAA;QACzB,oBAAoB,EAAE,MAAM,EAAE,CAAA;KAC/B;IAWD;;;OAGG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;;;OAIG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;CAG5C"}

package/build/src/core/ActivityManager.js

@@ -94,10 +94,22 @@ export class ActivityManager {
         this.#parent = parent;
         // this.reflectEvent = this.reflectEvent.bind(this)
     }
-    registerActivity(action, activityClass) {
-        if (this.activityClasses.has(action)) {
+    /**
+     * Registers an activity class with enhanced options.
+     * @param action The action name to register the activity for.
+     * @param activityClass The activity class constructor.
+     * @param options Optional registration configuration.
+     */
+    registerActivity(action, activityClass, options = {}) {
+        const { override = false } = options;
+        if (this.activityClasses.has(action) && !override) {
             // eslint-disable-next-line no-console
             console.warn(`Activity with action "${action}" already registered.`, new Error().stack);
+            return;
+        }
+        // Validate that the class extends Activity
+        if (typeof activityClass !== 'function') {
+            throw new Error(`Invalid activity class for action "${action}": must be a constructor function`);
         }
         this.activityClasses.set(action, activityClass);
     }
@@ -245,6 +257,8 @@ export class ActivityManager {
             stackEntry.activity.lifecycle = ActivityLifecycle.Stopped;
             await stackEntry.activity.onDestroy();
             stackEntry.activity.lifecycle = ActivityLifecycle.Destroyed;
+            // Clean up resources to prevent memory leaks
+            this.cleanupActivity(stackEntry.activity);
             await this.manageActivityResult(stackEntry.activity, stackEntry.intent);
             // Resume the previous activity
             await this.bringLastActivityToFront();
@@ -284,11 +298,11 @@ export class ActivityManager {
     async bringLastActivityToFront() {
         if (this.modalActivityStack.length > 0) {
             const previousEntry = this.modalActivityStack[this.activityStack.length - 1];
-            await this.updateCurrentActivity(previousEntry.activity, false);
+            await this.updateCurrentActivity(previousEntry.activity, false, previousEntry.intent);
         }
         else if (this.activityStack.length > 0) {
             const previousEntry = this.activityStack[this.activityStack.length - 1];
-            await this.updateCurrentActivity(previousEntry.activity, false);
+            await this.updateCurrentActivity(previousEntry.activity, false, previousEntry.intent);
         }
         else {
             this.currentActivity = undefined; // No more activities
@@ -343,7 +357,7 @@ export class ActivityManager {
      *
      * @param activity The activity to bring to the foreground.
      */
-    async updateCurrentActivity(activity, isModal) {
+    async updateCurrentActivity(activity, isModal, intent) {
         this.setupStyles(activity, this.currentActivity);
         if (this.currentActivity &&
             this.currentActivity !== activity &&
@@ -353,61 +367,33 @@ export class ActivityManager {
             await this.currentActivity.onPause();
             this.currentActivity.lifecycle = ActivityLifecycle.Paused;
         }
-        if (activity.lifecycle === ActivityLifecycle.Paused) {
-            await activity.onResume();
-            if (this.isDestroyed(activity)) {
-                return;
-            }
-            activity.lifecycle = ActivityLifecycle.Resumed;
-            activity.requestUpdate();
-        }
-        else if (activity.lifecycle === ActivityLifecycle.Stopped) {
-            await activity.onRestart();
-            activity.lifecycle = ActivityLifecycle.Resumed;
-        }
-        else if (activity.lifecycle === ActivityLifecycle.Destroyed) {
-            throw new Error(`Invalid state. The activity is already destroyed.`);
-        }
-        else if (activity.lifecycle === ActivityLifecycle.Created) {
-            await activity.onStart();
-            if (this.isDestroyed(activity)) {
-                return;
-            }
-            activity.lifecycle = ActivityLifecycle.Started;
-            await activity.onResume();
-            if (this.isDestroyed(activity)) {
-                return;
-            }
-            activity.lifecycle = ActivityLifecycle.Resumed;
-            activity.requestUpdate();
-        }
-        else if (activity.lifecycle === ActivityLifecycle.Started) {
-            await activity.onResume();
-            if (this.isDestroyed(activity)) {
-                return;
-            }
-            activity.lifecycle = ActivityLifecycle.Resumed;
-            activity.requestUpdate();
-        }
-        else if (activity.lifecycle === ActivityLifecycle.Initialized) {
-            // TODO: Figure out intent passing here.
-            await activity.onCreate();
-            activity.lifecycle = ActivityLifecycle.Created;
-            if (this.isDestroyed(activity)) {
-                // the activity finished and the manager already took care of this situation.
-                return;
-            }
-            await activity.onStart();
-            if (this.isDestroyed(activity)) {
-                return;
-            }
-            activity.lifecycle = ActivityLifecycle.Started;
-            await activity.onResume();
-            if (this.isDestroyed(activity)) {
-                return;
-            }
-            activity.lifecycle = ActivityLifecycle.Resumed;
-            activity.requestUpdate();
+        switch (activity.lifecycle) {
+            case ActivityLifecycle.Paused:
+                if (!(await this.transitionStartedToResumed(activity))) {
+                    return;
+                }
+                break;
+            case ActivityLifecycle.Stopped:
+                await this.safeExecuteLifecycleMethod(() => activity.onRestart(), activity, 'onRestart');
+                activity.lifecycle = ActivityLifecycle.Resumed;
+                break;
+            case ActivityLifecycle.Destroyed:
+                throw new Error(`Invalid state. The activity is already destroyed.`);
+            case ActivityLifecycle.Created:
+                if (!(await this.transitionCreatedToResumed(activity))) {
+                    return;
+                }
+                break;
+            case ActivityLifecycle.Started:
+                if (!(await this.transitionStartedToResumed(activity))) {
+                    return;
+                }
+                break;
+            case ActivityLifecycle.Initialized:
+                if (!(await this.transitionInitializedToResumed(activity, intent))) {
+                    return;
+                }
+                break;
         }
         if (!isModal) {
             // With a modal activity, it renders directly to the `<body>` and renders outside
@@ -415,17 +401,104 @@ export class ActivityManager {
             this.currentActivity = activity;
         }
     }
+    /**
+     * Safely executes an async lifecycle method with error handling.
+     * @param lifecycleMethod The lifecycle method to execute.
+     * @param activity The activity instance.
+     * @param methodName The name of the method for error reporting.
+     * @returns Promise that resolves when the method completes or rejects with wrapped error.
+     */
+    async safeExecuteLifecycleMethod(lifecycleMethod, activity, methodName) {
+        try {
+            await lifecycleMethod();
+        }
+        catch (error) {
+            const activityName = activity.constructor.name;
+            const wrappedError = new Error(`Error in ${activityName}.${methodName}(): ${error instanceof Error ? error.message : String(error)}`);
+            wrappedError.cause = error;
+            // Allow the activity to handle its own errors, but still propagate
+            this.#parent.dispatchEvent(new CustomEvent('activity-lifecycle-error', {
+                detail: { activity, methodName, error: wrappedError },
+            }));
+            throw wrappedError;
+        }
+    }
     /**
      * Allows navigating back through the activity stack.
      * Call `ActivityManager.navigateBack()` when the user performs a back action
      * (e.g., clicks a back button).
+     * @returns Promise that resolves to true if navigation was successful, false if at root.
      */
     async navigateBack() {
+        // Handle modal activities first
+        if (this.modalActivityStack.length > 0) {
+            const topModal = this.modalActivityStack[this.modalActivityStack.length - 1];
+            await this.finishActivity(topModal.activity);
+            return true;
+        }
+        // Handle regular activities
         if (this.activityStack.length > 1 && this.currentActivity) {
-            // Finish current, which will resume previous
             await this.finishActivity(this.currentActivity);
+            return true;
         }
-        // Else do nothing (or display a message, or exit the app)
+        // At root, cannot navigate back
+        return false;
+    }
+    /**
+     * Navigates to a specific activity in the stack, clearing activities above it.
+     * @param action The action of the activity to navigate to.
+     * @returns Promise that resolves to true if navigation was successful.
+     */
+    async navigateToActivity(action) {
+        const index = this.activityStack.findIndex((entry) => entry.action === action);
+        if (index === -1) {
+            return false;
+        }
+        // Finish all activities above the target
+        const activitiesToFinish = this.activityStack.slice(index + 1);
+        for (const entry of activitiesToFinish) {
+            await this.finishActivity(entry.activity);
+        }
+        // Bring the target activity to the front
+        const targetEntry = this.activityStack[index];
+        await this.updateCurrentActivity(targetEntry.activity, false, targetEntry.intent);
+        return true;
+    }
+    /**
+     * Clears the entire activity stack and starts a new root activity.
+     * @param intent The intent for the new root activity.
+     */
+    async clearStackAndStart(intent) {
+        // Finish all activities
+        const allActivities = [...this.activityStack, ...this.modalActivityStack];
+        for (const entry of allActivities) {
+            if (entry.activity.lifecycle !== ActivityLifecycle.Destroyed) {
+                await this.finishActivity(entry.activity);
+            }
+        }
+        // Clear stacks
+        this.activityStack.length = 0;
+        this.modalActivityStack.length = 0;
+        this.currentActivity = undefined;
+        // Start new root activity
+        await this.startActivity(intent);
+    }
+    /**
+     * Creates an intent with better type safety and validation.
+     * @param action The action name.
+     * @param data Optional intent data.
+     * @param options Optional intent configuration.
+     * @returns A properly formed intent.
+     */
+    createIntent(action, data, options = {}) {
+        if (!this.isActionRegistered(action)) {
+            throw new Error(`Cannot create intent for unregistered action: ${action}`);
+        }
+        return {
+            action,
+            data,
+            ...options,
+        };
     }
     createRequestCode() {
         const min = 1000;
@@ -435,5 +508,121 @@ export class ActivityManager {
     findActiveActivity(action) {
         return this.activityStack.find((entry) => entry.action === action)?.activity;
     }
+    /**
+     * Transitions an activity from Created to Resumed state.
+     * @param activity The activity to transition.
+     * @returns true if successful, false if activity was destroyed during transition.
+     */
+    async transitionCreatedToResumed(activity) {
+        await this.safeExecuteLifecycleMethod(() => activity.onStart(), activity, 'onStart');
+        if (this.isDestroyed(activity)) {
+            return false;
+        }
+        activity.lifecycle = ActivityLifecycle.Started;
+        await this.safeExecuteLifecycleMethod(() => activity.onResume(), activity, 'onResume');
+        if (this.isDestroyed(activity)) {
+            return false;
+        }
+        activity.lifecycle = ActivityLifecycle.Resumed;
+        activity.requestUpdate();
+        return true;
+    }
+    /**
+     * Transitions an activity from Started to Resumed state.
+     * @param activity The activity to transition.
+     * @returns true if successful, false if activity was destroyed during transition.
+     */
+    async transitionStartedToResumed(activity) {
+        await this.safeExecuteLifecycleMethod(() => activity.onResume(), activity, 'onResume');
+        if (this.isDestroyed(activity)) {
+            return false;
+        }
+        activity.lifecycle = ActivityLifecycle.Resumed;
+        activity.requestUpdate();
+        return true;
+    }
+    /**
+     * Transitions an activity from Initialized to Resumed state.
+     * @param activity The activity to transition.
+     * @param intent The intent used to create the activity.
+     * @returns true if successful, false if activity was destroyed during transition.
+     */
+    async transitionInitializedToResumed(activity, intent) {
+        await this.safeExecuteLifecycleMethod(() => activity.onCreate(intent), activity, 'onCreate');
+        activity.lifecycle = ActivityLifecycle.Created;
+        if (this.isDestroyed(activity)) {
+            return false;
+        }
+        return await this.transitionCreatedToResumed(activity);
+    }
+    /**
+     * Cleans up resources for destroyed activities to prevent memory leaks.
+     * @param activity The activity to clean up.
+     */
+    cleanupActivity(activity) {
+        // Remove any event listeners that might create memory leaks
+        // This changes the entire prototype chain of the activity,
+        // effectively making it a new object. We can't do that as the activity will loose some
+        // of its properties, so we don't do it for now.
+        // if (activity instanceof EventTarget) {
+        //   // Clear all event listeners by replacing the activity with a new EventTarget
+        //   // This is a defensive approach since we can't enumerate listeners
+        //   Object.setPrototypeOf(activity, EventTarget.prototype)
+        // }
+        // Clear any references that might prevent garbage collection
+        activity.renderRoot = undefined;
+    }
+    /**
+     * Validates that an activity stack is in a consistent state.
+     * @param stack The activity stack to validate.
+     * @returns Array of validation errors, empty if valid.
+     */
+    validateStackConsistency(stack) {
+        const errors = [];
+        const seenIds = new Set();
+        for (const entry of stack) {
+            if (seenIds.has(entry.id)) {
+                errors.push(`Duplicate activity ID found: ${entry.id}`);
+            }
+            seenIds.add(entry.id);
+            if (!entry.activity || !entry.id || !entry.action) {
+                errors.push(`Invalid stack entry: missing required properties`);
+            }
+            if (entry.activity.lifecycle === ActivityLifecycle.Destroyed) {
+                errors.push(`Destroyed activity found in stack: ${entry.id}`);
+            }
+        }
+        return errors;
+    }
+    /**
+     * Gets diagnostic information about the current state of the activity manager.
+     * Useful for debugging and monitoring.
+     * @returns Object containing current state information.
+     */
+    getDiagnostics() {
+        return {
+            totalActivities: this.activityStack.length,
+            modalActivities: this.modalActivityStack.length,
+            currentActivity: this.currentActivity?.constructor.name,
+            topActivity: this.getTopActivity()?.constructor.name,
+            stackValidation: this.validateStackConsistency(this.activityStack),
+            modalStackValidation: this.validateStackConsistency(this.modalActivityStack),
+        };
+    }
+    /**
+     * Gets all registered activity actions.
+     * @returns Array of registered action names.
+     */
+    getRegisteredActions() {
+        return Array.from(this.activityClasses.keys());
+    }
+    /**
+     * Checks if an action is registered.
+     * @param action The action to check.
+     * @returns true if the action is registered, false otherwise.
+     */
+    isActionRegistered(action) {
+        return this.activityClasses.has(action);
+    }
 }
 //# sourceMappingURL=ActivityManager.js.map

package/build/src/core/ActivityManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActivityManager.js","sourceRoot":"","sources":["../../../src/core/ActivityManager.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Activity } from './Activity.js'\nimport type { Application } from './Application.js'\nimport { navigateScreen } from './ApplicationRoute.js'\n\nexport enum ActivityLifecycle {\n  /**\n   * The activity is initialized, but not yet created.\n   * This is the initial state of the activity.\n   */\n  Initialized,\n  /**\n   * The activity is created, but not yet started.\n   * This is the state after the `onCreate()` method is called.\n   */\n  Created,\n  /**\n   * The activity is started, but not yet resumed.\n   * This is the state after the `onStart()` method is called.\n   */\n  Started,\n  /**\n   * The activity is resumed and visible to the user.\n   * This is the state after the `onResume()` method is called.\n   */\n  Resumed,\n  /**\n   * The activity is paused, but still visible to the user.\n   * This is the state after the `onPause()` method is called.\n   */\n  Paused,\n  /**\n   * The activity is stopped and no longer visible to the user.\n   * This is the state after the `onStop()` method is called.\n   */\n  Stopped,\n  /**\n   * The activity is destroyed and no longer exists.\n   * This is the state after the `onDestroy()` method is called.\n   */\n  Destroyed,\n}\n\nexport enum IntentFlags {\n  /**\n   * Marks that the activity should be rendered as a modal.\n   */\n  Modal = 1 << 0,\n  /**\n   * The activity is started for result.\n   */\n  ForResult = 1 << 1,\n  /**\n   * When set, the intent data is passed by reference.\n   * By default the activity manager makes a copy of the intent data.\n   * This is useful when the data is large and you want to avoid copying it\n   * or when you want to share the same data between activities.\n   */\n  ByReference = 1 << 2,\n}\n\nexport interface Intent {\n  action: string\n  data?: unknown\n  category?: string[]\n  flags?: number\n  /**\n   * The request code used to distinguish between different activities.\n   */\n  requestCode?: number\n}\n\nexport enum IntentResult {\n  RESULT_CANCELED,\n  RESULT_OK,\n}\n\n/**\n * Defines the information stored for each activity on the stack:\n * the Activity instance, a unique id, and optionally the Intent that started the activity\n * (useful for restoring state).\n */\ninterface ActivityStackEntry {\n  /**\n   * The instance of the activity.\n   */\n  activity: Activity\n  /**\n   * Activity's unique ID.\n   */\n  id: string\n  /**\n   * The intent that started the activity.\n   */\n  intent: Intent\n  /**\n   * The action name the activity is registered for.\n   */\n  action: string\n}\n\n/**\n * Manages application activities.\n *\n * An activity is a screen or a portion of a rendered screen that has its own\n * lifecycle methods and routing.\n *\n * An activity is registered by its class definition. Because of that, activities\n * cannot have constructors that require own parameters. Activities have to be\n * self contained or use the event system to request data.\n */\nexport class ActivityManager {\n  private currentActivity?: Activity\n\n  /**\n   * Stores activity *classes* by unique ID (action name).\n   */\n  private activityClasses = new Map<string, typeof Activity>()\n\n  /**\n   * Represents the activity stack. It is used to manage\n   * the UI state after calling the back action.\n   */\n  private activityStack: ActivityStackEntry[] = []\n\n  /**\n   * A stack of activities that are rendered over other activities\n   * in a dialog.\n   */\n  private modalActivityStack: ActivityStackEntry[] = []\n\n  private generateActivityId(): string {\n    return Math.random().toString(36).substring(2, 15)\n  }\n\n  #parent: Application\n\n  constructor(parent: Application) {\n    this.#parent = parent\n    // this.reflectEvent = this.reflectEvent.bind(this)\n  }\n\n  registerActivity(action: string, activityClass: typeof Activity): void {\n    if (this.activityClasses.has(action)) {\n      // eslint-disable-next-line no-console\n      console.warn(`Activity with action \"${action}\" already registered.`, new Error().stack)\n    }\n    this.activityClasses.set(action, activityClass)\n  }\n\n  // protected reflectEvent<T extends Event>(event: T): T {\n  //   const copy = Reflect.construct(event.constructor, [event.type, event])\n  //   const dispatched = this.#parent.events.dispatchEvent(copy)\n  //   if (!dispatched) {\n  //     event.preventDefault()\n  //   }\n  //   return copy\n  // }\n\n  /**\n   * Creates an activity and pushes it into the stack, but it does not initialize any of the lifecycle methods.\n   * It is a way to put an activity at some place of the stack,\n   * but it will be only initialized when other activities finis.\n   *\n   * Note, if you add an uninitialized activity and you won't add more activities then this activity may never run.\n   * Make sure that there's always another activity.\n   *\n   * @param intent The intent that created this activity.\n   */\n  async createActivity(intent: Intent): Promise<void> {\n    const activity = this.buildActivity(intent)\n    const activityId = this.generateActivityId()\n    const stackEntry: ActivityStackEntry = { activity, id: activityId, intent, action: intent.action }\n    this.activityStack.push(stackEntry)\n  }\n\n  setupRoute(intent: Intent): void {\n    if (intent.data) {\n      const typed = intent.data as { uri?: string }\n      if (typed.uri) {\n        navigateScreen(typed.uri)\n      }\n    }\n  }\n\n  /**\n   * Starts a new activity and brings it to the foreground.\n   *\n   * @param intent The intent that created this activity.\n   */\n  async startActivity(intent: Intent): Promise<void> {\n    const { currentActivity, activityStack } = this\n    const lastIndex = activityStack.findLastIndex((entry) => entry.action === intent.action)\n    // if the activity is in the history list, we bring it up and update intent.\n    if (lastIndex > -1) {\n      const info = activityStack[lastIndex]\n      activityStack.splice(lastIndex, 1)\n      activityStack.push({\n        id: info.id,\n        activity: info.activity,\n        action: info.action,\n        intent,\n      })\n      await info.activity.onNewIntent(intent)\n      // TODO: Check if the activity is destroyed.\n      this.setupRoute(intent)\n      await this.updateCurrentActivity(info.activity, false)\n      return\n    }\n    const activity = this.buildActivity(intent)\n    if (currentActivity) {\n      await currentActivity.onPause()\n      currentActivity.lifecycle = ActivityLifecycle.Paused\n    }\n\n    const activityId = this.generateActivityId()\n    const stackEntry: ActivityStackEntry = { activity, id: activityId, intent, action: intent.action }\n    // Modal activities are pretty much the same as regular activities but are rendered on top\n    // of other activities. We keep track of them on another stack as all modal activities must\n    // finish before returning to the regular stack.\n    const isModal = (intent.flags ?? 0) & IntentFlags.Modal\n    if (isModal) {\n      this.modalActivityStack.push(stackEntry)\n    } else {\n      this.activityStack.push(stackEntry)\n    }\n    await activity.onCreate(intent)\n    if (this.isDestroyed(activity)) {\n      // the activity finished and the manager already took care of this situation.\n      return\n    }\n    activity.lifecycle = ActivityLifecycle.Created\n\n    await this.updateCurrentActivity(activity, !!isModal)\n    if (this.isDestroyed(activity)) {\n      // the activity finished and the manager already took care of this situation.\n      return\n    }\n    this.setupRoute(intent)\n  }\n\n  private buildActivity(intent: Intent): Activity {\n    const action = intent.action\n    if (!this.activityClasses.has(action)) {\n      throw new Error(`No activity class registered for action: ${action}`)\n    }\n\n    const ActivityClass = this.activityClasses.get(action)\n    if (!ActivityClass) {\n      throw new Error(`No activity class registered for action: ${action}`)\n    }\n\n    // We use the container to resolve dependencies, if any.\n    // const activity = (await container.make(ActivityClass, [this.#parent])) as Activity\n    return new ActivityClass(this.#parent)\n  }\n\n  /**\n   * Starts an activity that should return a result to the calling activity.\n   * The result should be a unique number across the application.\n   * @param intent The intent to start the activity.\n   * @param requestCode The request code used to match the activity result.\n   */\n  async startActivityForResult(intent: Intent, requestCode: number): Promise<void> {\n    intent.requestCode = requestCode\n    const byReference = (intent.flags ?? 0) & IntentFlags.ByReference\n    const shallowCopy = { ...intent }\n    const data = shallowCopy.data\n    if (byReference) {\n      delete shallowCopy.data\n    }\n    const deepCopy = structuredClone(shallowCopy)\n    if (data && byReference) {\n      deepCopy.data = data\n    }\n    if (deepCopy.flags) {\n      deepCopy.flags = deepCopy.flags | IntentFlags.ForResult\n    } else {\n      deepCopy.flags = IntentFlags.ForResult\n    }\n    await this.startActivity(deepCopy)\n  }\n\n  isDestroyed(activity: Activity): boolean {\n    return activity.lifecycle === ActivityLifecycle.Destroyed\n  }\n\n  /**\n   * @param activity The activity to finish.\n   */\n  async finishActivity(activity: Activity): Promise<void> {\n    this.setupStyles(undefined, activity)\n    const isModal = this.modalActivityStack.some((entry) => entry.activity === activity)\n    const stack = isModal ? this.modalActivityStack : this.activityStack\n    const index = stack.findIndex((entry) => entry.activity === activity)\n    if (index !== -1) {\n      const stackEntry = stack.splice(index, 1)[0]\n\n      await stackEntry.activity.onPause()\n      stackEntry.activity.lifecycle = ActivityLifecycle.Paused\n      await stackEntry.activity.onStop()\n      stackEntry.activity.lifecycle = ActivityLifecycle.Stopped\n      await stackEntry.activity.onDestroy()\n      stackEntry.activity.lifecycle = ActivityLifecycle.Destroyed\n\n      await this.manageActivityResult(stackEntry.activity, stackEntry.intent)\n\n      // Resume the previous activity\n      await this.bringLastActivityToFront()\n    } else {\n      if (activity.lifecycle === ActivityLifecycle.Created) {\n        await activity.onStop()\n        activity.lifecycle = ActivityLifecycle.Stopped\n      }\n      await activity.onDestroy()\n      activity.lifecycle = ActivityLifecycle.Destroyed\n      // This can happen when an activity finishes in one of the callback methods,\n      // before it is added to the stack. In that case, we bring the last activity back to the front.\n      await this.bringLastActivityToFront()\n    }\n    this.#parent.requestUpdate()\n  }\n\n  private async manageActivityResult(activity: Activity, intent: Intent): Promise<void> {\n    const { flags = 0, requestCode = -1 } = intent\n    if (flags & IntentFlags.ForResult) {\n      const all = [...this.activityStack, ...this.modalActivityStack]\n      const target = all.find((entry) => entry.activity.hasRequestCode(requestCode))\n      if (target) {\n        if (target.activity.lifecycle === ActivityLifecycle.Destroyed) {\n          return\n        }\n        if (target.activity.lifecycle === ActivityLifecycle.Resumed) {\n          await target.activity.onPause()\n          target.activity.lifecycle = ActivityLifecycle.Paused\n        }\n        const intentCopy = structuredClone(intent)\n        intentCopy.data = activity.getResult()\n        await target.activity.onActivityResult(requestCode, activity.resultCode, intentCopy)\n      }\n    }\n  }\n\n  private async bringLastActivityToFront(): Promise<void> {\n    if (this.modalActivityStack.length > 0) {\n      const previousEntry = this.modalActivityStack[this.activityStack.length - 1]\n      await this.updateCurrentActivity(previousEntry.activity, false)\n    } else if (this.activityStack.length > 0) {\n      const previousEntry = this.activityStack[this.activityStack.length - 1]\n      await this.updateCurrentActivity(previousEntry.activity, false)\n    } else {\n      this.currentActivity = undefined // No more activities\n    }\n  }\n\n  getTopActivity(): Activity | undefined {\n    const topModal = this.modalActivityStack.findLast((a) => a.activity.lifecycle === ActivityLifecycle.Resumed)\n    if (topModal) {\n      return topModal.activity\n    }\n    const top = this.activityStack.findLast((a) => a.activity.lifecycle === ActivityLifecycle.Resumed)\n    return top ? top.activity : undefined\n  }\n\n  getCurrentActivity(): Activity | undefined {\n    return this.currentActivity\n  }\n\n  /**\n   * Sets the styles for the current activity.\n   * This method adds or removes CSS classes based on the activity's class name\n   * and action, allowing for dynamic styling based on the active activity.\n   * @param activity The activity to set styles for.\n   * If not provided, it will not set any styles.\n   * If the activity is the same as the current one, it does nothing.\n   */\n  setupStyles(activity?: Activity, oldActivity?: Activity): void {\n    if (activity === oldActivity) {\n      return\n    }\n    const root = document?.documentElement\n    if (!root) {\n      return\n    }\n    if (oldActivity) {\n      const ctor = oldActivity.constructor as typeof Activity\n      root.classList.remove(ctor.name.toLowerCase())\n      if (ctor.action) {\n        root.classList.remove(ctor.action.replace(/\\//g, '-'))\n      }\n    }\n    if (activity) {\n      const ctor = activity.constructor as typeof Activity\n      root.classList.add(ctor.name.toLowerCase())\n      if (ctor.action) {\n        root.classList.add(ctor.action.replace(/\\//g, '-'))\n      }\n    }\n  }\n\n  /**\n   * A helper method to handle the transition between activities, ensuring\n   * lifecycle methods are called in the correct order (pause the previous activity,\n   * then start/resume the new one). This centralizes lifecycle management.\n   *\n   * @param activity The activity to bring to the foreground.\n   */\n  private async updateCurrentActivity(activity: Activity, isModal: boolean): Promise<void> {\n    this.setupStyles(activity, this.currentActivity)\n    if (\n      this.currentActivity &&\n      this.currentActivity !== activity &&\n      this.currentActivity.lifecycle !== ActivityLifecycle.Destroyed &&\n      // Make sure we don't pause the current activity if it's already paused.\n      this.currentActivity.lifecycle !== ActivityLifecycle.Paused\n    ) {\n      await this.currentActivity.onPause()\n      this.currentActivity.lifecycle = ActivityLifecycle.Paused\n    }\n    if (activity.lifecycle === ActivityLifecycle.Paused) {\n      await activity.onResume()\n      if (this.isDestroyed(activity)) {\n        return\n      }\n      activity.lifecycle = ActivityLifecycle.Resumed\n      activity.requestUpdate()\n    } else if (activity.lifecycle === ActivityLifecycle.Stopped) {\n      await activity.onRestart()\n      activity.lifecycle = ActivityLifecycle.Resumed\n    } else if (activity.lifecycle === ActivityLifecycle.Destroyed) {\n      throw new Error(`Invalid state. The activity is already destroyed.`)\n    } else if (activity.lifecycle === ActivityLifecycle.Created) {\n      await activity.onStart()\n      if (this.isDestroyed(activity)) {\n        return\n      }\n      activity.lifecycle = ActivityLifecycle.Started\n      await activity.onResume()\n      if (this.isDestroyed(activity)) {\n        return\n      }\n      activity.lifecycle = ActivityLifecycle.Resumed\n      activity.requestUpdate()\n    } else if (activity.lifecycle === ActivityLifecycle.Started) {\n      await activity.onResume()\n      if (this.isDestroyed(activity)) {\n        return\n      }\n      activity.lifecycle = ActivityLifecycle.Resumed\n      activity.requestUpdate()\n    } else if (activity.lifecycle === ActivityLifecycle.Initialized) {\n      // TODO: Figure out intent passing here.\n      await activity.onCreate()\n      activity.lifecycle = ActivityLifecycle.Created\n      if (this.isDestroyed(activity)) {\n        // the activity finished and the manager already took care of this situation.\n        return\n      }\n      await activity.onStart()\n      if (this.isDestroyed(activity)) {\n        return\n      }\n      activity.lifecycle = ActivityLifecycle.Started\n      await activity.onResume()\n      if (this.isDestroyed(activity)) {\n        return\n      }\n      activity.lifecycle = ActivityLifecycle.Resumed\n      activity.requestUpdate()\n    }\n    if (!isModal) {\n      // With a modal activity, it renders directly to the `<body>` and renders outside\n      // of the normal rendering flow. We keep the previous activity rendered.\n      this.currentActivity = activity\n    }\n  }\n\n  /**\n   * Allows navigating back through the activity stack.\n   * Call `ActivityManager.navigateBack()` when the user performs a back action\n   * (e.g., clicks a back button).\n   */\n  async navigateBack(): Promise<void> {\n    if (this.activityStack.length > 1 && this.currentActivity) {\n      // Finish current, which will resume previous\n      await this.finishActivity(this.currentActivity)\n    }\n    // Else do nothing (or display a message, or exit the app)\n  }\n\n  createRequestCode(): number {\n    const min = 1000\n    const max = 9999\n    return Math.floor(Math.random() * (max - min) + min)\n  }\n\n  findActiveActivity(action: string): Activity | undefined {\n    return this.activityStack.find((entry) => entry.action === action)?.activity\n  }\n}\n"]}
+{"version":3,"file":"ActivityManager.js","sourceRoot":"","sources":["../../../src/core/ActivityManager.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Activity } from './Activity.js'\nimport type { Application } from './Application.js'\nimport { navigateScreen } from './ApplicationRoute.js'\n\nexport enum ActivityLifecycle {\n  /**\n   * The activity is initialized, but not yet created.\n   * This is the initial state of the activity.\n   */\n  Initialized,\n  /**\n   * The activity is created, but not yet started.\n   * This is the state after the `onCreate()` method is called.\n   */\n  Created,\n  /**\n   * The activity is started, but not yet resumed.\n   * This is the state after the `onStart()` method is called.\n   */\n  Started,\n  /**\n   * The activity is resumed and visible to the user.\n   * This is the state after the `onResume()` method is called.\n   */\n  Resumed,\n  /**\n   * The activity is paused, but still visible to the user.\n   * This is the state after the `onPause()` method is called.\n   */\n  Paused,\n  /**\n   * The activity is stopped and no longer visible to the user.\n   * This is the state after the `onStop()` method is called.\n   */\n  Stopped,\n  /**\n   * The activity is destroyed and no longer exists.\n   * This is the state after the `onDestroy()` method is called.\n   */\n  Destroyed,\n}\n\nexport enum IntentFlags {\n  /**\n   * Marks that the activity should be rendered as a modal.\n   */\n  Modal = 1 << 0,\n  /**\n   * The activity is started for result.\n   */\n  ForResult = 1 << 1,\n  /**\n   * When set, the intent data is passed by reference.\n   * By default the activity manager makes a copy of the intent data.\n   * This is useful when the data is large and you want to avoid copying it\n   * or when you want to share the same data between activities.\n   */\n  ByReference = 1 << 2,\n}\n\nexport interface Intent<T = unknown> {\n  action: string\n  data?: T\n  category?: string[]\n  flags?: number\n  /**\n   * The request code used to distinguish between different activities.\n   */\n  requestCode?: number\n}\n\nexport enum IntentResult {\n  RESULT_CANCELED,\n  RESULT_OK,\n}\n\n/**\n * Defines the information stored for each activity on the stack:\n * the Activity instance, a unique id, and optionally the Intent that started the activity\n * (useful for restoring state).\n */\ninterface ActivityStackEntry {\n  /**\n   * The instance of the activity.\n   */\n  activity: Activity\n  /**\n   * Activity's unique ID.\n   */\n  id: string\n  /**\n   * The intent that started the activity.\n   */\n  intent: Intent\n  /**\n   * The action name the activity is registered for.\n   */\n  action: string\n}\n\n/**\n * Type for activity constructor with static action property.\n */\nexport interface ActivityConstructor {\n  new (parent: Application): Activity\n  action?: string\n}\n\n/**\n * Enhanced activity registration options.\n */\nexport interface ActivityRegistrationOptions {\n  /** Whether to override existing registrations */\n  override?: boolean\n  /** Optional validation function for intents */\n  validateIntent?: (intent: Intent) => boolean\n}\n\n/**\n * Manages application activities.\n *\n * An activity is a screen or a portion of a rendered screen that has its own\n * lifecycle methods and routing.\n *\n * An activity is registered by its class definition. Because of that, activities\n * cannot have constructors that require own parameters. Activities have to be\n * self contained or use the event system to request data.\n */\nexport class ActivityManager {\n  private currentActivity?: Activity\n\n  /**\n   * Stores activity *classes* by unique ID (action name).\n   */\n  private activityClasses = new Map<string, typeof Activity>()\n\n  /**\n   * Represents the activity stack. It is used to manage\n   * the UI state after calling the back action.\n   */\n  private activityStack: ActivityStackEntry[] = []\n\n  /**\n   * A stack of activities that are rendered over other activities\n   * in a dialog.\n   */\n  private modalActivityStack: ActivityStackEntry[] = []\n\n  private generateActivityId(): string {\n    return Math.random().toString(36).substring(2, 15)\n  }\n\n  #parent: Application\n\n  constructor(parent: Application) {\n    this.#parent = parent\n    // this.reflectEvent = this.reflectEvent.bind(this)\n  }\n\n  /**\n   * Registers an activity class with enhanced options.\n   * @param action The action name to register the activity for.\n   * @param activityClass The activity class constructor.\n   * @param options Optional registration configuration.\n   */\n  registerActivity(\n    action: string,\n    activityClass: ActivityConstructor,\n    options: ActivityRegistrationOptions = {}\n  ): void {\n    const { override = false } = options\n\n    if (this.activityClasses.has(action) && !override) {\n      // eslint-disable-next-line no-console\n      console.warn(`Activity with action \"${action}\" already registered.`, new Error().stack)\n      return\n    }\n\n    // Validate that the class extends Activity\n    if (typeof activityClass !== 'function') {\n      throw new Error(`Invalid activity class for action \"${action}\": must be a constructor function`)\n    }\n\n    this.activityClasses.set(action, activityClass as typeof Activity)\n  }\n\n  // protected reflectEvent<T extends Event>(event: T): T {\n  //   const copy = Reflect.construct(event.constructor, [event.type, event])\n  //   const dispatched = this.#parent.events.dispatchEvent(copy)\n  //   if (!dispatched) {\n  //     event.preventDefault()\n  //   }\n  //   return copy\n  // }\n\n  /**\n   * Creates an activity and pushes it into the stack, but it does not initialize any of the lifecycle methods.\n   * It is a way to put an activity at some place of the stack,\n   * but it will be only initialized when other activities finis.\n   *\n   * Note, if you add an uninitialized activity and you won't add more activities then this activity may never run.\n   * Make sure that there's always another activity.\n   *\n   * @param intent The intent that created this activity.\n   */\n  async createActivity(intent: Intent): Promise<void> {\n    const activity = this.buildActivity(intent)\n    const activityId = this.generateActivityId()\n    const stackEntry: ActivityStackEntry = { activity, id: activityId, intent, action: intent.action }\n    this.activityStack.push(stackEntry)\n  }\n\n  setupRoute(intent: Intent): void {\n    if (intent.data) {\n      const typed = intent.data as { uri?: string }\n      if (typed.uri) {\n        navigateScreen(typed.uri)\n      }\n    }\n  }\n\n  /**\n   * Starts a new activity and brings it to the foreground.\n   *\n   * @param intent The intent that created this activity.\n   */\n  async startActivity(intent: Intent): Promise<void> {\n    const { currentActivity, activityStack } = this\n    const lastIndex = activityStack.findLastIndex((entry) => entry.action === intent.action)\n    // if the activity is in the history list, we bring it up and update intent.\n    if (lastIndex > -1) {\n      const info = activityStack[lastIndex]\n      activityStack.splice(lastIndex, 1)\n      activityStack.push({\n        id: info.id,\n        activity: info.activity,\n        action: info.action,\n        intent,\n      })\n      await info.activity.onNewIntent(intent)\n      // TODO: Check if the activity is destroyed.\n      this.setupRoute(intent)\n      await this.updateCurrentActivity(info.activity, false)\n      return\n    }\n    const activity = this.buildActivity(intent)\n    if (currentActivity) {\n      await currentActivity.onPause()\n      currentActivity.lifecycle = ActivityLifecycle.Paused\n    }\n\n    const activityId = this.generateActivityId()\n    const stackEntry: ActivityStackEntry = { activity, id: activityId, intent, action: intent.action }\n    // Modal activities are pretty much the same as regular activities but are rendered on top\n    // of other activities. We keep track of them on another stack as all modal activities must\n    // finish before returning to the regular stack.\n    const isModal = (intent.flags ?? 0) & IntentFlags.Modal\n    if (isModal) {\n      this.modalActivityStack.push(stackEntry)\n    } else {\n      this.activityStack.push(stackEntry)\n    }\n    await activity.onCreate(intent)\n    if (this.isDestroyed(activity)) {\n      // the activity finished and the manager already took care of this situation.\n      return\n    }\n    activity.lifecycle = ActivityLifecycle.Created\n\n    await this.updateCurrentActivity(activity, !!isModal)\n    if (this.isDestroyed(activity)) {\n      // the activity finished and the manager already took care of this situation.\n      return\n    }\n    this.setupRoute(intent)\n  }\n\n  private buildActivity(intent: Intent): Activity {\n    const action = intent.action\n    if (!this.activityClasses.has(action)) {\n      throw new Error(`No activity class registered for action: ${action}`)\n    }\n\n    const ActivityClass = this.activityClasses.get(action)\n    if (!ActivityClass) {\n      throw new Error(`No activity class registered for action: ${action}`)\n    }\n\n    // We use the container to resolve dependencies, if any.\n    // const activity = (await container.make(ActivityClass, [this.#parent])) as Activity\n    return new ActivityClass(this.#parent)\n  }\n\n  /**\n   * Starts an activity that should return a result to the calling activity.\n   * The result should be a unique number across the application.\n   * @param intent The intent to start the activity.\n   * @param requestCode The request code used to match the activity result.\n   */\n  async startActivityForResult(intent: Intent, requestCode: number): Promise<void> {\n    intent.requestCode = requestCode\n    const byReference = (intent.flags ?? 0) & IntentFlags.ByReference\n    const shallowCopy = { ...intent }\n    const data = shallowCopy.data\n    if (byReference) {\n      delete shallowCopy.data\n    }\n    const deepCopy = structuredClone(shallowCopy)\n    if (data && byReference) {\n      deepCopy.data = data\n    }\n    if (deepCopy.flags) {\n      deepCopy.flags = deepCopy.flags | IntentFlags.ForResult\n    } else {\n      deepCopy.flags = IntentFlags.ForResult\n    }\n    await this.startActivity(deepCopy)\n  }\n\n  isDestroyed(activity: Activity): boolean {\n    return activity.lifecycle === ActivityLifecycle.Destroyed\n  }\n\n  /**\n   * @param activity The activity to finish.\n   */\n  async finishActivity(activity: Activity): Promise<void> {\n    this.setupStyles(undefined, activity)\n    const isModal = this.modalActivityStack.some((entry) => entry.activity === activity)\n    const stack = isModal ? this.modalActivityStack : this.activityStack\n    const index = stack.findIndex((entry) => entry.activity === activity)\n    if (index !== -1) {\n      const stackEntry = stack.splice(index, 1)[0]\n\n      await stackEntry.activity.onPause()\n      stackEntry.activity.lifecycle = ActivityLifecycle.Paused\n      await stackEntry.activity.onStop()\n      stackEntry.activity.lifecycle = ActivityLifecycle.Stopped\n      await stackEntry.activity.onDestroy()\n      stackEntry.activity.lifecycle = ActivityLifecycle.Destroyed\n\n      // Clean up resources to prevent memory leaks\n      this.cleanupActivity(stackEntry.activity)\n\n      await this.manageActivityResult(stackEntry.activity, stackEntry.intent)\n\n      // Resume the previous activity\n      await this.bringLastActivityToFront()\n    } else {\n      if (activity.lifecycle === ActivityLifecycle.Created) {\n        await activity.onStop()\n        activity.lifecycle = ActivityLifecycle.Stopped\n      }\n      await activity.onDestroy()\n      activity.lifecycle = ActivityLifecycle.Destroyed\n      // This can happen when an activity finishes in one of the callback methods,\n      // before it is added to the stack. In that case, we bring the last activity back to the front.\n      await this.bringLastActivityToFront()\n    }\n    this.#parent.requestUpdate()\n  }\n\n  private async manageActivityResult(activity: Activity, intent: Intent): Promise<void> {\n    const { flags = 0, requestCode = -1 } = intent\n    if (flags & IntentFlags.ForResult) {\n      const all = [...this.activityStack, ...this.modalActivityStack]\n      const target = all.find((entry) => entry.activity.hasRequestCode(requestCode))\n      if (target) {\n        if (target.activity.lifecycle === ActivityLifecycle.Destroyed) {\n          return\n        }\n        if (target.activity.lifecycle === ActivityLifecycle.Resumed) {\n          await target.activity.onPause()\n          target.activity.lifecycle = ActivityLifecycle.Paused\n        }\n        const intentCopy = structuredClone(intent)\n        intentCopy.data = activity.getResult()\n        await target.activity.onActivityResult(requestCode, activity.resultCode, intentCopy)\n      }\n    }\n  }\n\n  private async bringLastActivityToFront(): Promise<void> {\n    if (this.modalActivityStack.length > 0) {\n      const previousEntry = this.modalActivityStack[this.activityStack.length - 1]\n      await this.updateCurrentActivity(previousEntry.activity, false, previousEntry.intent)\n    } else if (this.activityStack.length > 0) {\n      const previousEntry = this.activityStack[this.activityStack.length - 1]\n      await this.updateCurrentActivity(previousEntry.activity, false, previousEntry.intent)\n    } else {\n      this.currentActivity = undefined // No more activities\n    }\n  }\n\n  getTopActivity(): Activity | undefined {\n    const topModal = this.modalActivityStack.findLast((a) => a.activity.lifecycle === ActivityLifecycle.Resumed)\n    if (topModal) {\n      return topModal.activity\n    }\n    const top = this.activityStack.findLast((a) => a.activity.lifecycle === ActivityLifecycle.Resumed)\n    return top ? top.activity : undefined\n  }\n\n  getCurrentActivity(): Activity | undefined {\n    return this.currentActivity\n  }\n\n  /**\n   * Sets the styles for the current activity.\n   * This method adds or removes CSS classes based on the activity's class name\n   * and action, allowing for dynamic styling based on the active activity.\n   * @param activity The activity to set styles for.\n   * If not provided, it will not set any styles.\n   * If the activity is the same as the current one, it does nothing.\n   */\n  setupStyles(activity?: Activity, oldActivity?: Activity): void {\n    if (activity === oldActivity) {\n      return\n    }\n    const root = document?.documentElement\n    if (!root) {\n      return\n    }\n    if (oldActivity) {\n      const ctor = oldActivity.constructor as typeof Activity\n      root.classList.remove(ctor.name.toLowerCase())\n      if (ctor.action) {\n        root.classList.remove(ctor.action.replace(/\\//g, '-'))\n      }\n    }\n    if (activity) {\n      const ctor = activity.constructor as typeof Activity\n      root.classList.add(ctor.name.toLowerCase())\n      if (ctor.action) {\n        root.classList.add(ctor.action.replace(/\\//g, '-'))\n      }\n    }\n  }\n\n  /**\n   * A helper method to handle the transition between activities, ensuring\n   * lifecycle methods are called in the correct order (pause the previous activity,\n   * then start/resume the new one). This centralizes lifecycle management.\n   *\n   * @param activity The activity to bring to the foreground.\n   */\n  private async updateCurrentActivity(activity: Activity, isModal: boolean, intent?: Intent): Promise<void> {\n    this.setupStyles(activity, this.currentActivity)\n    if (\n      this.currentActivity &&\n      this.currentActivity !== activity &&\n      this.currentActivity.lifecycle !== ActivityLifecycle.Destroyed &&\n      // Make sure we don't pause the current activity if it's already paused.\n      this.currentActivity.lifecycle !== ActivityLifecycle.Paused\n    ) {\n      await this.currentActivity.onPause()\n      this.currentActivity.lifecycle = ActivityLifecycle.Paused\n    }\n    switch (activity.lifecycle) {\n      case ActivityLifecycle.Paused:\n        if (!(await this.transitionStartedToResumed(activity))) {\n          return\n        }\n        break\n\n      case ActivityLifecycle.Stopped:\n        await this.safeExecuteLifecycleMethod(() => activity.onRestart(), activity, 'onRestart')\n        activity.lifecycle = ActivityLifecycle.Resumed\n        break\n\n      case ActivityLifecycle.Destroyed:\n        throw new Error(`Invalid state. The activity is already destroyed.`)\n\n      case ActivityLifecycle.Created:\n        if (!(await this.transitionCreatedToResumed(activity))) {\n          return\n        }\n        break\n\n      case ActivityLifecycle.Started:\n        if (!(await this.transitionStartedToResumed(activity))) {\n          return\n        }\n        break\n\n      case ActivityLifecycle.Initialized:\n        if (!(await this.transitionInitializedToResumed(activity, intent))) {\n          return\n        }\n        break\n    }\n    if (!isModal) {\n      // With a modal activity, it renders directly to the `<body>` and renders outside\n      // of the normal rendering flow. We keep the previous activity rendered.\n      this.currentActivity = activity\n    }\n  }\n\n  /**\n   * Safely executes an async lifecycle method with error handling.\n   * @param lifecycleMethod The lifecycle method to execute.\n   * @param activity The activity instance.\n   * @param methodName The name of the method for error reporting.\n   * @returns Promise that resolves when the method completes or rejects with wrapped error.\n   */\n  private async safeExecuteLifecycleMethod(\n    lifecycleMethod: () => void | Promise<void>,\n    activity: Activity,\n    methodName: string\n  ): Promise<void> {\n    try {\n      await lifecycleMethod()\n    } catch (error) {\n      const activityName = activity.constructor.name\n      const wrappedError = new Error(\n        `Error in ${activityName}.${methodName}(): ${error instanceof Error ? error.message : String(error)}`\n      )\n      wrappedError.cause = error\n      // Allow the activity to handle its own errors, but still propagate\n      this.#parent.dispatchEvent(\n        new CustomEvent('activity-lifecycle-error', {\n          detail: { activity, methodName, error: wrappedError },\n        })\n      )\n      throw wrappedError\n    }\n  }\n\n  /**\n   * Allows navigating back through the activity stack.\n   * Call `ActivityManager.navigateBack()` when the user performs a back action\n   * (e.g., clicks a back button).\n   * @returns Promise that resolves to true if navigation was successful, false if at root.\n   */\n  async navigateBack(): Promise<boolean> {\n    // Handle modal activities first\n    if (this.modalActivityStack.length > 0) {\n      const topModal = this.modalActivityStack[this.modalActivityStack.length - 1]\n      await this.finishActivity(topModal.activity)\n      return true\n    }\n\n    // Handle regular activities\n    if (this.activityStack.length > 1 && this.currentActivity) {\n      await this.finishActivity(this.currentActivity)\n      return true\n    }\n\n    // At root, cannot navigate back\n    return false\n  }\n\n  /**\n   * Navigates to a specific activity in the stack, clearing activities above it.\n   * @param action The action of the activity to navigate to.\n   * @returns Promise that resolves to true if navigation was successful.\n   */\n  async navigateToActivity(action: string): Promise<boolean> {\n    const index = this.activityStack.findIndex((entry) => entry.action === action)\n    if (index === -1) {\n      return false\n    }\n\n    // Finish all activities above the target\n    const activitiesToFinish = this.activityStack.slice(index + 1)\n    for (const entry of activitiesToFinish) {\n      await this.finishActivity(entry.activity)\n    }\n\n    // Bring the target activity to the front\n    const targetEntry = this.activityStack[index]\n    await this.updateCurrentActivity(targetEntry.activity, false, targetEntry.intent)\n    return true\n  }\n\n  /**\n   * Clears the entire activity stack and starts a new root activity.\n   * @param intent The intent for the new root activity.\n   */\n  async clearStackAndStart(intent: Intent): Promise<void> {\n    // Finish all activities\n    const allActivities = [...this.activityStack, ...this.modalActivityStack]\n    for (const entry of allActivities) {\n      if (entry.activity.lifecycle !== ActivityLifecycle.Destroyed) {\n        await this.finishActivity(entry.activity)\n      }\n    }\n\n    // Clear stacks\n    this.activityStack.length = 0\n    this.modalActivityStack.length = 0\n    this.currentActivity = undefined\n\n    // Start new root activity\n    await this.startActivity(intent)\n  }\n\n  /**\n   * Creates an intent with better type safety and validation.\n   * @param action The action name.\n   * @param data Optional intent data.\n   * @param options Optional intent configuration.\n   * @returns A properly formed intent.\n   */\n  createIntent<T = unknown>(\n    action: string,\n    data?: T,\n    options: {\n      category?: string[]\n      flags?: number\n      requestCode?: number\n    } = {}\n  ): Intent<T> {\n    if (!this.isActionRegistered(action)) {\n      throw new Error(`Cannot create intent for unregistered action: ${action}`)\n    }\n\n    return {\n      action,\n      data,\n      ...options,\n    }\n  }\n\n  createRequestCode(): number {\n    const min = 1000\n    const max = 9999\n    return Math.floor(Math.random() * (max - min) + min)\n  }\n\n  findActiveActivity(action: string): Activity | undefined {\n    return this.activityStack.find((entry) => entry.action === action)?.activity\n  }\n\n  /**\n   * Transitions an activity from Created to Resumed state.\n   * @param activity The activity to transition.\n   * @returns true if successful, false if activity was destroyed during transition.\n   */\n  private async transitionCreatedToResumed(activity: Activity): Promise<boolean> {\n    await this.safeExecuteLifecycleMethod(() => activity.onStart(), activity, 'onStart')\n    if (this.isDestroyed(activity)) {\n      return false\n    }\n    activity.lifecycle = ActivityLifecycle.Started\n\n    await this.safeExecuteLifecycleMethod(() => activity.onResume(), activity, 'onResume')\n    if (this.isDestroyed(activity)) {\n      return false\n    }\n    activity.lifecycle = ActivityLifecycle.Resumed\n    activity.requestUpdate()\n    return true\n  }\n\n  /**\n   * Transitions an activity from Started to Resumed state.\n   * @param activity The activity to transition.\n   * @returns true if successful, false if activity was destroyed during transition.\n   */\n  private async transitionStartedToResumed(activity: Activity): Promise<boolean> {\n    await this.safeExecuteLifecycleMethod(() => activity.onResume(), activity, 'onResume')\n    if (this.isDestroyed(activity)) {\n      return false\n    }\n    activity.lifecycle = ActivityLifecycle.Resumed\n    activity.requestUpdate()\n    return true\n  }\n\n  /**\n   * Transitions an activity from Initialized to Resumed state.\n   * @param activity The activity to transition.\n   * @param intent The intent used to create the activity.\n   * @returns true if successful, false if activity was destroyed during transition.\n   */\n  private async transitionInitializedToResumed(activity: Activity, intent?: Intent): Promise<boolean> {\n    await this.safeExecuteLifecycleMethod(() => activity.onCreate(intent), activity, 'onCreate')\n    activity.lifecycle = ActivityLifecycle.Created\n    if (this.isDestroyed(activity)) {\n      return false\n    }\n\n    return await this.transitionCreatedToResumed(activity)\n  }\n\n  /**\n   * Cleans up resources for destroyed activities to prevent memory leaks.\n   * @param activity The activity to clean up.\n   */\n  private cleanupActivity(activity: Activity): void {\n    // Remove any event listeners that might create memory leaks\n    // This changes the entire prototype chain of the activity,\n    // effectively making it a new object. We can't do that as the activity will loose some\n    // of its properties, so we don't do it for now.\n    // if (activity instanceof EventTarget) {\n    //   // Clear all event listeners by replacing the activity with a new EventTarget\n    //   // This is a defensive approach since we can't enumerate listeners\n    //   Object.setPrototypeOf(activity, EventTarget.prototype)\n    // }\n\n    // Clear any references that might prevent garbage collection\n    activity.renderRoot = undefined\n  }\n\n  /**\n   * Validates that an activity stack is in a consistent state.\n   * @param stack The activity stack to validate.\n   * @returns Array of validation errors, empty if valid.\n   */\n  private validateStackConsistency(stack: ActivityStackEntry[]): string[] {\n    const errors: string[] = []\n    const seenIds = new Set<string>()\n\n    for (const entry of stack) {\n      if (seenIds.has(entry.id)) {\n        errors.push(`Duplicate activity ID found: ${entry.id}`)\n      }\n      seenIds.add(entry.id)\n\n      if (!entry.activity || !entry.id || !entry.action) {\n        errors.push(`Invalid stack entry: missing required properties`)\n      }\n\n      if (entry.activity.lifecycle === ActivityLifecycle.Destroyed) {\n        errors.push(`Destroyed activity found in stack: ${entry.id}`)\n      }\n    }\n\n    return errors\n  }\n\n  /**\n   * Gets diagnostic information about the current state of the activity manager.\n   * Useful for debugging and monitoring.\n   * @returns Object containing current state information.\n   */\n  getDiagnostics(): {\n    totalActivities: number\n    modalActivities: number\n    currentActivity?: string\n    topActivity?: string\n    stackValidation: string[]\n    modalStackValidation: string[]\n  } {\n    return {\n      totalActivities: this.activityStack.length,\n      modalActivities: this.modalActivityStack.length,\n      currentActivity: this.currentActivity?.constructor.name,\n      topActivity: this.getTopActivity()?.constructor.name,\n      stackValidation: this.validateStackConsistency(this.activityStack),\n      modalStackValidation: this.validateStackConsistency(this.modalActivityStack),\n    }\n  }\n\n  /**\n   * Gets all registered activity actions.\n   * @returns Array of registered action names.\n   */\n  getRegisteredActions(): string[] {\n    return Array.from(this.activityClasses.keys())\n  }\n\n  /**\n   * Checks if an action is registered.\n   * @param action The action to check.\n   * @returns true if the action is registered, false otherwise.\n   */\n  isActionRegistered(action: string): boolean {\n    return this.activityClasses.has(action)\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@api-client/ui",
-  "version": "0.5.30",
+  "version": "0.5.31",
   "description": "Internal UI component library for the API Client ecosystem.",
   "license": "UNLICENSED",
   "main": "build/src/index.js",

package/src/core/ActivityManager.ts

@@ -58,9 +58,9 @@ export enum IntentFlags {
   ByReference = 1 << 2,
 }
 
-export interface Intent {
+export interface Intent<T = unknown> {
   action: string
-  data?: unknown
+  data?: T
   category?: string[]
   flags?: number
   /**
@@ -98,6 +98,24 @@ interface ActivityStackEntry {
   action: string
 }
 
+/**
+ * Type for activity constructor with static action property.
+ */
+export interface ActivityConstructor {
+  new (parent: Application): Activity
+  action?: string
+}
+
+/**
+ * Enhanced activity registration options.
+ */
+export interface ActivityRegistrationOptions {
+  /** Whether to override existing registrations */
+  override?: boolean
+  /** Optional validation function for intents */
+  validateIntent?: (intent: Intent) => boolean
+}
+
 /**
  * Manages application activities.
  *
@@ -139,12 +157,31 @@ export class ActivityManager {
     // this.reflectEvent = this.reflectEvent.bind(this)
   }
 
-  registerActivity(action: string, activityClass: typeof Activity): void {
-    if (this.activityClasses.has(action)) {
+  /**
+   * Registers an activity class with enhanced options.
+   * @param action The action name to register the activity for.
+   * @param activityClass The activity class constructor.
+   * @param options Optional registration configuration.
+   */
+  registerActivity(
+    action: string,
+    activityClass: ActivityConstructor,
+    options: ActivityRegistrationOptions = {}
+  ): void {
+    const { override = false } = options
+
+    if (this.activityClasses.has(action) && !override) {
       // eslint-disable-next-line no-console
       console.warn(`Activity with action "${action}" already registered.`, new Error().stack)
+      return
     }
-    this.activityClasses.set(action, activityClass)
+
+    // Validate that the class extends Activity
+    if (typeof activityClass !== 'function') {
+      throw new Error(`Invalid activity class for action "${action}": must be a constructor function`)
+    }
+
+    this.activityClasses.set(action, activityClass as typeof Activity)
   }
 
   // protected reflectEvent<T extends Event>(event: T): T {
@@ -302,6 +339,9 @@ export class ActivityManager {
       await stackEntry.activity.onDestroy()
       stackEntry.activity.lifecycle = ActivityLifecycle.Destroyed
 
+      // Clean up resources to prevent memory leaks
+      this.cleanupActivity(stackEntry.activity)
+
       await this.manageActivityResult(stackEntry.activity, stackEntry.intent)
 
       // Resume the previous activity
@@ -343,10 +383,10 @@ export class ActivityManager {
   private async bringLastActivityToFront(): Promise<void> {
     if (this.modalActivityStack.length > 0) {
       const previousEntry = this.modalActivityStack[this.activityStack.length - 1]
-      await this.updateCurrentActivity(previousEntry.activity, false)
+      await this.updateCurrentActivity(previousEntry.activity, false, previousEntry.intent)
     } else if (this.activityStack.length > 0) {
       const previousEntry = this.activityStack[this.activityStack.length - 1]
-      await this.updateCurrentActivity(previousEntry.activity, false)
+      await this.updateCurrentActivity(previousEntry.activity, false, previousEntry.intent)
     } else {
       this.currentActivity = undefined // No more activities
     }
@@ -404,7 +444,7 @@ export class ActivityManager {
    *
    * @param activity The activity to bring to the foreground.
    */
-  private async updateCurrentActivity(activity: Activity, isModal: boolean): Promise<void> {
+  private async updateCurrentActivity(activity: Activity, isModal: boolean, intent?: Intent): Promise<void> {
     this.setupStyles(activity, this.currentActivity)
     if (
       this.currentActivity &&
@@ -416,56 +456,38 @@ export class ActivityManager {
       await this.currentActivity.onPause()
       this.currentActivity.lifecycle = ActivityLifecycle.Paused
     }
-    if (activity.lifecycle === ActivityLifecycle.Paused) {
-      await activity.onResume()
-      if (this.isDestroyed(activity)) {
-        return
-      }
-      activity.lifecycle = ActivityLifecycle.Resumed
-      activity.requestUpdate()
-    } else if (activity.lifecycle === ActivityLifecycle.Stopped) {
-      await activity.onRestart()
-      activity.lifecycle = ActivityLifecycle.Resumed
-    } else if (activity.lifecycle === ActivityLifecycle.Destroyed) {
-      throw new Error(`Invalid state. The activity is already destroyed.`)
-    } else if (activity.lifecycle === ActivityLifecycle.Created) {
-      await activity.onStart()
-      if (this.isDestroyed(activity)) {
-        return
-      }
-      activity.lifecycle = ActivityLifecycle.Started
-      await activity.onResume()
-      if (this.isDestroyed(activity)) {
-        return
-      }
-      activity.lifecycle = ActivityLifecycle.Resumed
-      activity.requestUpdate()
-    } else if (activity.lifecycle === ActivityLifecycle.Started) {
-      await activity.onResume()
-      if (this.isDestroyed(activity)) {
-        return
-      }
-      activity.lifecycle = ActivityLifecycle.Resumed
-      activity.requestUpdate()
-    } else if (activity.lifecycle === ActivityLifecycle.Initialized) {
-      // TODO: Figure out intent passing here.
-      await activity.onCreate()
-      activity.lifecycle = ActivityLifecycle.Created
-      if (this.isDestroyed(activity)) {
-        // the activity finished and the manager already took care of this situation.
-        return
-      }
-      await activity.onStart()
-      if (this.isDestroyed(activity)) {
-        return
-      }
-      activity.lifecycle = ActivityLifecycle.Started
-      await activity.onResume()
-      if (this.isDestroyed(activity)) {
-        return
-      }
-      activity.lifecycle = ActivityLifecycle.Resumed
-      activity.requestUpdate()
+    switch (activity.lifecycle) {
+      case ActivityLifecycle.Paused:
+        if (!(await this.transitionStartedToResumed(activity))) {
+          return
+        }
+        break
+
+      case ActivityLifecycle.Stopped:
+        await this.safeExecuteLifecycleMethod(() => activity.onRestart(), activity, 'onRestart')
+        activity.lifecycle = ActivityLifecycle.Resumed
+        break
+
+      case ActivityLifecycle.Destroyed:
+        throw new Error(`Invalid state. The activity is already destroyed.`)
+
+      case ActivityLifecycle.Created:
+        if (!(await this.transitionCreatedToResumed(activity))) {
+          return
+        }
+        break
+
+      case ActivityLifecycle.Started:
+        if (!(await this.transitionStartedToResumed(activity))) {
+          return
+        }
+        break
+
+      case ActivityLifecycle.Initialized:
+        if (!(await this.transitionInitializedToResumed(activity, intent))) {
+          return
+        }
+        break
     }
     if (!isModal) {
       // With a modal activity, it renders directly to the `<body>` and renders outside
@@ -474,17 +496,130 @@ export class ActivityManager {
     }
   }
 
+  /**
+   * Safely executes an async lifecycle method with error handling.
+   * @param lifecycleMethod The lifecycle method to execute.
+   * @param activity The activity instance.
+   * @param methodName The name of the method for error reporting.
+   * @returns Promise that resolves when the method completes or rejects with wrapped error.
+   */
+  private async safeExecuteLifecycleMethod(
+    lifecycleMethod: () => void | Promise<void>,
+    activity: Activity,
+    methodName: string
+  ): Promise<void> {
+    try {
+      await lifecycleMethod()
+    } catch (error) {
+      const activityName = activity.constructor.name
+      const wrappedError = new Error(
+        `Error in ${activityName}.${methodName}(): ${error instanceof Error ? error.message : String(error)}`
+      )
+      wrappedError.cause = error
+      // Allow the activity to handle its own errors, but still propagate
+      this.#parent.dispatchEvent(
+        new CustomEvent('activity-lifecycle-error', {
+          detail: { activity, methodName, error: wrappedError },
+        })
+      )
+      throw wrappedError
+    }
+  }
+
   /**
    * Allows navigating back through the activity stack.
    * Call `ActivityManager.navigateBack()` when the user performs a back action
    * (e.g., clicks a back button).
+   * @returns Promise that resolves to true if navigation was successful, false if at root.
    */
-  async navigateBack(): Promise<void> {
+  async navigateBack(): Promise<boolean> {
+    // Handle modal activities first
+    if (this.modalActivityStack.length > 0) {
+      const topModal = this.modalActivityStack[this.modalActivityStack.length - 1]
+      await this.finishActivity(topModal.activity)
+      return true
+    }
+
+    // Handle regular activities
     if (this.activityStack.length > 1 && this.currentActivity) {
-      // Finish current, which will resume previous
       await this.finishActivity(this.currentActivity)
+      return true
+    }
+
+    // At root, cannot navigate back
+    return false
+  }
+
+  /**
+   * Navigates to a specific activity in the stack, clearing activities above it.
+   * @param action The action of the activity to navigate to.
+   * @returns Promise that resolves to true if navigation was successful.
+   */
+  async navigateToActivity(action: string): Promise<boolean> {
+    const index = this.activityStack.findIndex((entry) => entry.action === action)
+    if (index === -1) {
+      return false
+    }
+
+    // Finish all activities above the target
+    const activitiesToFinish = this.activityStack.slice(index + 1)
+    for (const entry of activitiesToFinish) {
+      await this.finishActivity(entry.activity)
+    }
+
+    // Bring the target activity to the front
+    const targetEntry = this.activityStack[index]
+    await this.updateCurrentActivity(targetEntry.activity, false, targetEntry.intent)
+    return true
+  }
+
+  /**
+   * Clears the entire activity stack and starts a new root activity.
+   * @param intent The intent for the new root activity.
+   */
+  async clearStackAndStart(intent: Intent): Promise<void> {
+    // Finish all activities
+    const allActivities = [...this.activityStack, ...this.modalActivityStack]
+    for (const entry of allActivities) {
+      if (entry.activity.lifecycle !== ActivityLifecycle.Destroyed) {
+        await this.finishActivity(entry.activity)
+      }
+    }
+
+    // Clear stacks
+    this.activityStack.length = 0
+    this.modalActivityStack.length = 0
+    this.currentActivity = undefined
+
+    // Start new root activity
+    await this.startActivity(intent)
+  }
+
+  /**
+   * Creates an intent with better type safety and validation.
+   * @param action The action name.
+   * @param data Optional intent data.
+   * @param options Optional intent configuration.
+   * @returns A properly formed intent.
+   */
+  createIntent<T = unknown>(
+    action: string,
+    data?: T,
+    options: {
+      category?: string[]
+      flags?: number
+      requestCode?: number
+    } = {}
+  ): Intent<T> {
+    if (!this.isActionRegistered(action)) {
+      throw new Error(`Cannot create intent for unregistered action: ${action}`)
+    }
+
+    return {
+      action,
+      data,
+      ...options,
     }
-    // Else do nothing (or display a message, or exit the app)
   }
 
   createRequestCode(): number {
@@ -496,4 +631,142 @@ export class ActivityManager {
   findActiveActivity(action: string): Activity | undefined {
     return this.activityStack.find((entry) => entry.action === action)?.activity
   }
+
+  /**
+   * Transitions an activity from Created to Resumed state.
+   * @param activity The activity to transition.
+   * @returns true if successful, false if activity was destroyed during transition.
+   */
+  private async transitionCreatedToResumed(activity: Activity): Promise<boolean> {
+    await this.safeExecuteLifecycleMethod(() => activity.onStart(), activity, 'onStart')
+    if (this.isDestroyed(activity)) {
+      return false
+    }
+    activity.lifecycle = ActivityLifecycle.Started
+
+    await this.safeExecuteLifecycleMethod(() => activity.onResume(), activity, 'onResume')
+    if (this.isDestroyed(activity)) {
+      return false
+    }
+    activity.lifecycle = ActivityLifecycle.Resumed
+    activity.requestUpdate()
+    return true
+  }
+
+  /**
+   * Transitions an activity from Started to Resumed state.
+   * @param activity The activity to transition.
+   * @returns true if successful, false if activity was destroyed during transition.
+   */
+  private async transitionStartedToResumed(activity: Activity): Promise<boolean> {
+    await this.safeExecuteLifecycleMethod(() => activity.onResume(), activity, 'onResume')
+    if (this.isDestroyed(activity)) {
+      return false
+    }
+    activity.lifecycle = ActivityLifecycle.Resumed
+    activity.requestUpdate()
+    return true
+  }
+
+  /**
+   * Transitions an activity from Initialized to Resumed state.
+   * @param activity The activity to transition.
+   * @param intent The intent used to create the activity.
+   * @returns true if successful, false if activity was destroyed during transition.
+   */
+  private async transitionInitializedToResumed(activity: Activity, intent?: Intent): Promise<boolean> {
+    await this.safeExecuteLifecycleMethod(() => activity.onCreate(intent), activity, 'onCreate')
+    activity.lifecycle = ActivityLifecycle.Created
+    if (this.isDestroyed(activity)) {
+      return false
+    }
+
+    return await this.transitionCreatedToResumed(activity)
+  }
+
+  /**
+   * Cleans up resources for destroyed activities to prevent memory leaks.
+   * @param activity The activity to clean up.
+   */
+  private cleanupActivity(activity: Activity): void {
+    // Remove any event listeners that might create memory leaks
+    // This changes the entire prototype chain of the activity,
+    // effectively making it a new object. We can't do that as the activity will loose some
+    // of its properties, so we don't do it for now.
+    // if (activity instanceof EventTarget) {
+    //   // Clear all event listeners by replacing the activity with a new EventTarget
+    //   // This is a defensive approach since we can't enumerate listeners
+    //   Object.setPrototypeOf(activity, EventTarget.prototype)
+    // }
+
+    // Clear any references that might prevent garbage collection
+    activity.renderRoot = undefined
+  }
+
+  /**
+   * Validates that an activity stack is in a consistent state.
+   * @param stack The activity stack to validate.
+   * @returns Array of validation errors, empty if valid.
+   */
+  private validateStackConsistency(stack: ActivityStackEntry[]): string[] {
+    const errors: string[] = []
+    const seenIds = new Set<string>()
+
+    for (const entry of stack) {
+      if (seenIds.has(entry.id)) {
+        errors.push(`Duplicate activity ID found: ${entry.id}`)
+      }
+      seenIds.add(entry.id)
+
+      if (!entry.activity || !entry.id || !entry.action) {
+        errors.push(`Invalid stack entry: missing required properties`)
+      }
+
+      if (entry.activity.lifecycle === ActivityLifecycle.Destroyed) {
+        errors.push(`Destroyed activity found in stack: ${entry.id}`)
+      }
+    }
+
+    return errors
+  }
+
+  /**
+   * Gets diagnostic information about the current state of the activity manager.
+   * Useful for debugging and monitoring.
+   * @returns Object containing current state information.
+   */
+  getDiagnostics(): {
+    totalActivities: number
+    modalActivities: number
+    currentActivity?: string
+    topActivity?: string
+    stackValidation: string[]
+    modalStackValidation: string[]
+  } {
+    return {
+      totalActivities: this.activityStack.length,
+      modalActivities: this.modalActivityStack.length,
+      currentActivity: this.currentActivity?.constructor.name,
+      topActivity: this.getTopActivity()?.constructor.name,
+      stackValidation: this.validateStackConsistency(this.activityStack),
+      modalStackValidation: this.validateStackConsistency(this.modalActivityStack),
+    }
+  }
+
+  /**
+   * Gets all registered activity actions.
+   * @returns Array of registered action names.
+   */
+  getRegisteredActions(): string[] {
+    return Array.from(this.activityClasses.keys())
+  }
+
+  /**
+   * Checks if an action is registered.
+   * @param action The action to check.
+   * @returns true if the action is registered, false otherwise.
+   */
+  isActionRegistered(action: string): boolean {
+    return this.activityClasses.has(action)
+  }
 }

package/test/core/activity_manager.spec.ts

@@ -354,10 +354,10 @@ describe('ActivityManager', () => {
 
       assert.isTrue(activity1.onActivityResult.calledOnce)
       const [calledRequestCode, calledResultCode, calledIntent] = activity1.onActivityResult.firstCall.args
-      assert.equal(calledRequestCode, requestCode)
-      assert.equal(calledResultCode, IntentResult.RESULT_OK)
-      assert.deepEqual(calledIntent.data, resultData)
-      assert.equal(calledIntent.action, TestActivity2.action)
+      assert.equal(calledRequestCode, requestCode, 'has the request code from activity1')
+      assert.equal(calledResultCode, IntentResult.RESULT_OK, 'has the OK result code')
+      assert.deepEqual(calledIntent.data, resultData, 'has the result data from activity2')
+      assert.equal(calledIntent.action, TestActivity2.action, 'has the action of activity2')
     })
 
     it('handles finishing an activity that was only created (not fully started)', async () => {