@api-client/ui 0.0.15 → 0.1.0

package/build/src/core/Activity.js

@@ -0,0 +1,309 @@
+import { __esDecorate, __runInitializers } from "tslib";
+/* eslint-disable @typescript-eslint/no-unused-vars */
+import { nothing } from 'lit';
+import { ActivityState, IntentResult } from './ActivityManager.js';
+import { FragmentManager } from './FragmentManager.js';
+import { bound } from '../decorators/bound.js';
+import { EventTypes } from '../events/EventTypes.js';
+/**
+ * `Activity` is a crucial component of your app. An application sends an intent
+ * to bring the activity. If it's found, the activity gets to the foreground and start its activity.
+ *
+ * **Lifecycle**
+ *
+ * - `onCreated()` - fires when the system first creates the activity.
+ * - `onStart()` - the activity becomes visible to the user as the app prepares for
+ *  the activity to enter the foreground and become interactive.
+ * - `onResume()` - the state in which the app interacts with the user.
+ * - `onPause()` - the first indication that the user is leaving your activity.
+ * - `onStop()` - your activity is no longer visible to the user.
+ * - `onDestroy()`- is called before the activity is destroyed
+ */
+let Activity = (() => {
+    let _classSuper = EventTarget;
+    let _instanceExtraInitializers = [];
+    let _handleIntentEvent_decorators;
+    return class Activity extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _handleIntentEvent_decorators = [bound];
+            __esDecorate(this, null, _handleIntentEvent_decorators, { kind: "method", name: "handleIntentEvent", static: false, private: false, access: { has: obj => "handleIntentEvent" in obj, get: obj => obj.handleIntentEvent }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        /**
+         * To be set by an activity to replace the default render root.
+         * This is particularly useful when the activity is a modal dialog
+         * and the content should be rendered outside the application's render root.
+         */
+        renderRoot = __runInitializers(this, _instanceExtraInitializers);
+        /**
+         * An activity can define its action name that does not change.
+         * It then should be used as the activity registration key.
+         * This way other activities/fragments can use it to call the activity.
+         */
+        static action;
+        state = ActivityState.Initialized;
+        parent;
+        /**
+         * The fragment manager that manages fragments in this activity.
+         */
+        manager;
+        resultData;
+        exitCode = IntentResult.RESULT_CANCELED;
+        get resultCode() {
+            return this.exitCode;
+        }
+        /**
+         * When starting an new activity for result, we add the request code here
+         * so that the manager can track which activity originally called the
+         * activity for result.
+         */
+        pendingRequestCodes = [];
+        constructor(parent) {
+            super();
+            this.parent = parent;
+            this.manager = new FragmentManager(this);
+        }
+        /**
+         * Called when the activity is starting. This is where most initialization should go.
+         * You can call `finish()` from within this function, in which case `onDestroy()` will be
+         * immediately called after `onCreate()` without any of the rest of the activity lifecycle
+         * (`onStart()`, `onResume()`, `onPause()`, etc) executing.
+         *
+         * In the `onCreate()` method, perform basic activity startup logic that happens only once
+         * for the entire life of the activity.
+         * @param intent Optional intent data.
+         */
+        onCreate(intent) {
+            this.dispatchEvent(new CustomEvent('activity:create', { detail: intent }));
+        }
+        /**
+         * Called when the activity becomes visible.
+         * As `onCreate()` exits, the activity enters the `Started` state, and the activity becomes visible
+         * to the user. This callback contains what amounts to the activity’s final preparations for coming
+         * to the foreground and becoming interactive.
+         *
+         * Called after `onCreate()`.  It will usually be followed by onResume().
+         * This is a good place to begin running animations, etc.
+         * You can call `finish()` from within this function, in which case `onStop()` will be
+         * immediately called after `onStart()` without the lifecycle transitions
+         * in-between (`onResume()`, `onPause()`, etc) executing.
+         */
+        onStart() {
+            this.dispatchEvent(new CustomEvent('activity:start', { detail: null }));
+        }
+        /**
+         * Called when the activity gains focus.
+         * Called after the `onPause()`. This is usually a hint for your activity to start interacting
+         * with the user, which is a good indicator that the activity became active and ready to receive input.
+         * This sometimes could also be a transit state toward another resting state.
+         * For instance, an activity may be relaunched to `onPause()` due to configuration changes and
+         * the activity was visible, but wasn't the top-most activity of an activity task.
+         * The `render()` function is always called after this callback.
+         */
+        onResume() {
+            this.dispatchEvent(new CustomEvent('activity:resume', { detail: null }));
+        }
+        /**
+         * Called when the activity loses focus.
+         * Called as part of the activity lifecycle when the user no longer actively interacts with the activity,
+         * but it is still visible on screen. The counterpart to `onResume()`.
+         *
+         * When activity B is launched in front of activity A, this callback will be invoked on A.
+         * B will not be created until A's `onPause()` returns, so be sure to not do anything lengthy here.
+         *
+         * This callback is mostly used for saving any persistent state the activity is editing,
+         * to present a "edit in place" model to the user and making sure nothing is lost if there are
+         * not enough resources to start the new activity without first killing this one.
+         * This is also a good place to stop things that consume a noticeable amount of CPU in order
+         * to make the switch to the next activity as fast as possible.
+         */
+        onPause() {
+            this.dispatchEvent(new CustomEvent('activity:pause', { detail: null }));
+        }
+        /**
+         * Called when you are no longer visible to the user.
+         * You will next receive either onRestart(), onDestroy(), or nothing, depending on later user activity.
+         * This is a good place to stop refreshing UI, running animations and other visual things.
+         */
+        onStop() {
+            this.dispatchEvent(new CustomEvent('activity:stop', { detail: null }));
+        }
+        onRestart() {
+            this.dispatchEvent(new CustomEvent('activity:restart', { detail: null }));
+        }
+        /**
+         * Perform any final cleanup before an activity is destroyed.
+         * This can happen because the activity is finishing (someone called finish() on it).
+         */
+        onDestroy() {
+            this.dispatchEvent(new CustomEvent('activity:destroy', { detail: null }));
+        }
+        /**
+         * Called when a new intent is delivered
+         * @param intent New intent data.
+         */
+        onNewIntent(intent) {
+            //
+        }
+        /**
+         * Called by the renderer when the activity is rendered for the first time.
+         */
+        onFirstRender() {
+            //
+        }
+        /**
+         * A function called when it should render the view.
+         */
+        render() {
+            return nothing;
+        }
+        /**
+         * Finishes the activity.
+         */
+        async finish() {
+            await this.getApplication().manager.finishActivity(this);
+        }
+        /**
+         * When the activity changes its state it should call the
+         * `requestUpdate()` method to inform the parent application to
+         * perform the render operation.
+         * The function dispatches the `activity:update` custom event
+         * that is handled by the parent application.
+         *
+         * Note, the application may choose to not call the render procedure
+         * (for example, when the activity is not visible). The rendering
+         * function is asynchronous. The only way to know the activity is being rendered,
+         * is when the `render()` method if called.
+         */
+        requestUpdate(opts = {}) {
+            const { activity = true } = opts;
+            if (activity) {
+                this.manager.updateActiveFragments();
+            }
+            this.parent.requestUpdate(opts);
+        }
+        /**
+         * Registers a new fragment.
+         * @param key The name of the fragment
+         * @param fragment The fragment to register.
+         */
+        addFragment(key, fragment, data) {
+            this.manager.attachFragment(key, fragment, this, data);
+        }
+        showFragment(key, root) {
+            this.manager.showFragment(key, root);
+        }
+        hideFragment(key) {
+            const fragment = this.manager.findFragment(key);
+            if (fragment) {
+                this.manager.hideFragment(fragment);
+            }
+        }
+        /**
+         * Unifies Fragment and Activity interfaces.
+         * @returns `this`
+         */
+        getApplication() {
+            return this.parent;
+        }
+        /**
+         * A shortcut to the `manager` function.
+         * @param intent The intent to start
+         */
+        startActivity(intent) {
+            return this.parent.manager.startActivity(intent);
+        }
+        /**
+         * Starts a new activity for a result.
+         * @param intent The intent that created this activity.
+         * @returns The request code created with this call.
+         */
+        async startActivityForResult(intent) {
+            const { manager } = this.getApplication();
+            const code = manager.createRequestCode();
+            this.pendingRequestCodes.push(code);
+            await manager.startActivityForResult(intent, code);
+            return code;
+        }
+        /**
+         * Call this method to return data to the activity that started this activity.
+         * @param data The data to return.
+         */
+        setResult(resultCode, data) {
+            this.exitCode = resultCode;
+            this.resultData = data;
+        }
+        /**
+         * Called when an activity you launched exits, giving you the `requestCode` you started it with,
+         * the `resultCode` it returned, and any additional data from it. The `resultCode` will be `RESULT_CANCELED`
+         * if the activity explicitly returned that, didn't return any result, or crashed during its operation.
+         *
+         * An activity can never receive a result in the resumed state. You can count on `onResume()` being called
+         * after this method, though not necessarily immediately after. If the activity was resumed,
+         * it will be paused and the result will be delivered, followed by `onResume()`.
+         *
+         * @param requestCode The request code passed to startActivityForResult.
+         * @param data The result from the activity.
+         * @param intent The intent that was used to start the activity.
+         */
+        async onActivityResult(requestCode, resultCode, intent) {
+            const index = this.pendingRequestCodes.indexOf(requestCode);
+            if (index !== -1) {
+                this.pendingRequestCodes.splice(index, 1);
+            }
+            // First we check whether any of the fragments has the code.
+            const fragment = this.manager.findByRequestCode(requestCode);
+            if (fragment) {
+                return fragment.onActivityResult(requestCode, resultCode, intent);
+            }
+            if (this.constructor === Activity) {
+                // eslint-disable-next-line no-console
+                console.info(`Activity#onActivityResult not implemented. Request code: ${requestCode}, result code: ${resultCode}`, intent);
+            }
+        }
+        getActivity() {
+            return this;
+        }
+        /**
+         * Checks whether this activity initiated the activity for result.
+         * @param code The request code to look for.
+         * @returns `true` if the activity has the request code.
+         */
+        hasRequestCode(code) {
+            return this.pendingRequestCodes.includes(code);
+        }
+        getResult() {
+            return this.resultData;
+        }
+        /**
+         * A handler for the intent event dispatched by web components hosted by this activity.
+         *
+         * **Usage example:**
+         *
+         * ```ts
+         * <custom-element @startactivity="${this.handleIntentEvent}"></custom-element>
+         * <custom-element @startactivityforresult="${this.handleIntentEvent}"></custom-element>
+         * ```
+         *
+         * @param event The event that was dispatched.
+         * @returns A promise that resolves when the intent is handled.
+         * @throws An error if the activity has no activity.
+         * @throws An error if the event type is not recognized.
+         */
+        async handleIntentEvent(event) {
+            if (event.type === EventTypes.Intent.startActivityForResult) {
+                const info = event.detail;
+                await this.startActivityForResult(info.intent);
+            }
+            else if (event.type === EventTypes.Intent.startActivity) {
+                this.startActivity(event.detail.intent);
+            }
+            else {
+                throw new Error(`Unrecognized intent event: ${event.type}`);
+            }
+        }
+    };
+})();
+export { Activity };
+//# sourceMappingURL=Activity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Activity.js","sourceRoot":"","sources":["../../../src/core/Activity.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/no-unused-vars */\nimport { nothing, TemplateResult } from 'lit'\nimport { ActivityState, IntentResult, type Intent } from './ActivityManager.js'\nimport { FragmentManager } from './FragmentManager.js'\nimport type { Fragment } from './Fragment.js'\nimport type { Application, UpdateRequest } from './Application.js'\nimport { bound } from '../decorators/bound.js'\nimport type { ActivityDetail, ActivityWithResultDetail } from '../events/IntentEvents.js'\nimport { EventTypes } from '../events/EventTypes.js'\n\n/**\n * `Activity` is a crucial component of your app. An application sends an intent\n * to bring the activity. If it's found, the activity gets to the foreground and start its activity.\n *\n * **Lifecycle**\n *\n * - `onCreated()` - fires when the system first creates the activity.\n * - `onStart()` - the activity becomes visible to the user as the app prepares for\n *  the activity to enter the foreground and become interactive.\n * - `onResume()` - the state in which the app interacts with the user.\n * - `onPause()` - the first indication that the user is leaving your activity.\n * - `onStop()` - your activity is no longer visible to the user.\n * - `onDestroy()`- is called before the activity is destroyed\n */\nexport class Activity extends EventTarget {\n  /**\n   * To be set by an activity to replace the default render root.\n   * This is particularly useful when the activity is a modal dialog\n   * and the content should be rendered outside the application's render root.\n   */\n  renderRoot?: HTMLElement\n  /**\n   * An activity can define its action name that does not change.\n   * It then should be used as the activity registration key.\n   * This way other activities/fragments can use it to call the activity.\n   */\n  static action?: string\n\n  public state: ActivityState = ActivityState.Initialized\n  protected parent: Application\n  /**\n   * The fragment manager that manages fragments in this activity.\n   */\n  protected manager: FragmentManager\n  protected resultData?: unknown\n\n  protected exitCode = IntentResult.RESULT_CANCELED\n\n  get resultCode(): IntentResult {\n    return this.exitCode\n  }\n\n  /**\n   * When starting an new activity for result, we add the request code here\n   * so that the manager can track which activity originally called the\n   * activity for result.\n   */\n  protected pendingRequestCodes: number[] = []\n\n  constructor(parent: Application) {\n    super()\n    this.parent = parent\n    this.manager = new FragmentManager(this)\n  }\n\n  /**\n   * Called when the activity is starting. This is where most initialization should go.\n   * You can call `finish()` from within this function, in which case `onDestroy()` will be\n   * immediately called after `onCreate()` without any of the rest of the activity lifecycle\n   * (`onStart()`, `onResume()`, `onPause()`, etc) executing.\n   *\n   * In the `onCreate()` method, perform basic activity startup logic that happens only once\n   * for the entire life of the activity.\n   * @param intent Optional intent data.\n   */\n  onCreate(intent?: Intent): void | Promise<void> {\n    this.dispatchEvent(new CustomEvent('activity:create', { detail: intent }))\n  }\n\n  /**\n   * Called when the activity becomes visible.\n   * As `onCreate()` exits, the activity enters the `Started` state, and the activity becomes visible\n   * to the user. This callback contains what amounts to the activity’s final preparations for coming\n   * to the foreground and becoming interactive.\n   *\n   * Called after `onCreate()`.  It will usually be followed by onResume().\n   * This is a good place to begin running animations, etc.\n   * You can call `finish()` from within this function, in which case `onStop()` will be\n   * immediately called after `onStart()` without the lifecycle transitions\n   * in-between (`onResume()`, `onPause()`, etc) executing.\n   */\n  onStart(): void | Promise<void> {\n    this.dispatchEvent(new CustomEvent('activity:start', { detail: null }))\n  }\n\n  /**\n   * Called when the activity gains focus.\n   * Called after the `onPause()`. This is usually a hint for your activity to start interacting\n   * with the user, which is a good indicator that the activity became active and ready to receive input.\n   * This sometimes could also be a transit state toward another resting state.\n   * For instance, an activity may be relaunched to `onPause()` due to configuration changes and\n   * the activity was visible, but wasn't the top-most activity of an activity task.\n   * The `render()` function is always called after this callback.\n   */\n  onResume(): void | Promise<void> {\n    this.dispatchEvent(new CustomEvent('activity:resume', { detail: null }))\n  }\n\n  /**\n   * Called when the activity loses focus.\n   * Called as part of the activity lifecycle when the user no longer actively interacts with the activity,\n   * but it is still visible on screen. The counterpart to `onResume()`.\n   *\n   * When activity B is launched in front of activity A, this callback will be invoked on A.\n   * B will not be created until A's `onPause()` returns, so be sure to not do anything lengthy here.\n   *\n   * This callback is mostly used for saving any persistent state the activity is editing,\n   * to present a \"edit in place\" model to the user and making sure nothing is lost if there are\n   * not enough resources to start the new activity without first killing this one.\n   * This is also a good place to stop things that consume a noticeable amount of CPU in order\n   * to make the switch to the next activity as fast as possible.\n   */\n  onPause(): void | Promise<void> {\n    this.dispatchEvent(new CustomEvent('activity:pause', { detail: null }))\n  }\n\n  /**\n   * Called when you are no longer visible to the user.\n   * You will next receive either onRestart(), onDestroy(), or nothing, depending on later user activity.\n   * This is a good place to stop refreshing UI, running animations and other visual things.\n   */\n  onStop(): void | Promise<void> {\n    this.dispatchEvent(new CustomEvent('activity:stop', { detail: null }))\n  }\n\n  onRestart(): void | Promise<void> {\n    this.dispatchEvent(new CustomEvent('activity:restart', { detail: null }))\n  }\n\n  /**\n   * Perform any final cleanup before an activity is destroyed.\n   * This can happen because the activity is finishing (someone called finish() on it).\n   */\n  onDestroy(): void | Promise<void> {\n    this.dispatchEvent(new CustomEvent('activity:destroy', { detail: null }))\n  }\n\n  /**\n   * Called when a new intent is delivered\n   * @param intent New intent data.\n   */\n  onNewIntent(intent: Intent): void | Promise<void> {\n    //\n  }\n\n  /**\n   * Called by the renderer when the activity is rendered for the first time.\n   */\n  onFirstRender(): void {\n    //\n  }\n\n  /**\n   * A function called when it should render the view.\n   */\n  render(): TemplateResult | typeof nothing {\n    return nothing\n  }\n\n  /**\n   * Finishes the activity.\n   */\n  async finish(): Promise<void> {\n    await this.getApplication().manager.finishActivity(this)\n  }\n\n  /**\n   * When the activity changes its state it should call the\n   * `requestUpdate()` method to inform the parent application to\n   * perform the render operation.\n   * The function dispatches the `activity:update` custom event\n   * that is handled by the parent application.\n   *\n   * Note, the application may choose to not call the render procedure\n   * (for example, when the activity is not visible). The rendering\n   * function is asynchronous. The only way to know the activity is being rendered,\n   * is when the `render()` method if called.\n   */\n  requestUpdate(opts: UpdateRequest = {}): void {\n    const { activity = true } = opts\n    if (activity) {\n      this.manager.updateActiveFragments()\n    }\n    this.parent.requestUpdate(opts)\n  }\n\n  /**\n   * Registers a new fragment.\n   * @param key The name of the fragment\n   * @param fragment The fragment to register.\n   */\n  addFragment(key: string, fragment: Fragment, data?: unknown): void {\n    this.manager.attachFragment(key, fragment, this, data)\n  }\n\n  showFragment(key: string, root?: HTMLElement): void {\n    this.manager.showFragment(key, root)\n  }\n\n  hideFragment(key: string): void {\n    const fragment = this.manager.findFragment(key)\n    if (fragment) {\n      this.manager.hideFragment(fragment)\n    }\n  }\n\n  /**\n   * Unifies Fragment and Activity interfaces.\n   * @returns `this`\n   */\n  getApplication(): Application {\n    return this.parent\n  }\n\n  /**\n   * A shortcut to the `manager` function.\n   * @param intent The intent to start\n   */\n  startActivity(intent: Intent): Promise<void> {\n    return this.parent.manager.startActivity(intent)\n  }\n\n  /**\n   * Starts a new activity for a result.\n   * @param intent The intent that created this activity.\n   * @returns The request code created with this call.\n   */\n  async startActivityForResult(intent: Intent): Promise<number> {\n    const { manager } = this.getApplication()\n    const code = manager.createRequestCode()\n    this.pendingRequestCodes.push(code)\n    await manager.startActivityForResult(intent, code)\n    return code\n  }\n\n  /**\n   * Call this method to return data to the activity that started this activity.\n   * @param data The data to return.\n   */\n  setResult(resultCode: IntentResult, data?: unknown): void {\n    this.exitCode = resultCode\n    this.resultData = data\n  }\n\n  /**\n   * Called when an activity you launched exits, giving you the `requestCode` you started it with,\n   * the `resultCode` it returned, and any additional data from it. The `resultCode` will be `RESULT_CANCELED`\n   * if the activity explicitly returned that, didn't return any result, or crashed during its operation.\n   *\n   * An activity can never receive a result in the resumed state. You can count on `onResume()` being called\n   * after this method, though not necessarily immediately after. If the activity was resumed,\n   * it will be paused and the result will be delivered, followed by `onResume()`.\n   *\n   * @param requestCode The request code passed to startActivityForResult.\n   * @param data The result from the activity.\n   * @param intent The intent that was used to start the activity.\n   */\n  async onActivityResult(requestCode: number, resultCode: IntentResult, intent: Intent): Promise<void> {\n    const index = this.pendingRequestCodes.indexOf(requestCode)\n    if (index !== -1) {\n      this.pendingRequestCodes.splice(index, 1)\n    }\n    // First we check whether any of the fragments has the code.\n    const fragment = this.manager.findByRequestCode(requestCode)\n    if (fragment) {\n      return fragment.onActivityResult(requestCode, resultCode, intent)\n    }\n    if (this.constructor === Activity) {\n      // eslint-disable-next-line no-console\n      console.info(\n        `Activity#onActivityResult not implemented. Request code: ${requestCode}, result code: ${resultCode}`,\n        intent\n      )\n    }\n  }\n\n  getActivity(): Activity {\n    return this\n  }\n\n  /**\n   * Checks whether this activity initiated the activity for result.\n   * @param code The request code to look for.\n   * @returns `true` if the activity has the request code.\n   */\n  hasRequestCode(code: number): boolean {\n    return this.pendingRequestCodes.includes(code)\n  }\n\n  getResult(): unknown | undefined {\n    return this.resultData\n  }\n\n  /**\n   * A handler for the intent event dispatched by web components hosted by this activity.\n   *\n   * **Usage example:**\n   *\n   * ```ts\n   * <custom-element @startactivity=\"${this.handleIntentEvent}\"></custom-element>\n   * <custom-element @startactivityforresult=\"${this.handleIntentEvent}\"></custom-element>\n   * ```\n   *\n   * @param event The event that was dispatched.\n   * @returns A promise that resolves when the intent is handled.\n   * @throws An error if the activity has no activity.\n   * @throws An error if the event type is not recognized.\n   */\n  @bound\n  async handleIntentEvent(event: CustomEvent<ActivityDetail | ActivityWithResultDetail>): Promise<void> {\n    if (event.type === EventTypes.Intent.startActivityForResult) {\n      const info = event.detail as ActivityWithResultDetail\n      await this.startActivityForResult(info.intent)\n    } else if (event.type === EventTypes.Intent.startActivity) {\n      this.startActivity(event.detail.intent)\n    } else {\n      throw new Error(`Unrecognized intent event: ${event.type}`)\n    }\n  }\n}\n"]}

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

@@ -0,0 +1,125 @@
+import type { Activity } from './Activity.js';
+import type { Application } from './Application.js';
+export declare enum ActivityState {
+    Initialized = 0,
+    Created = 1,
+    Started = 2,
+    Resumed = 3,
+    Paused = 4,
+    Stopped = 5,
+    Destroyed = 6
+}
+export declare enum IntentFlags {
+    /**
+     * Marks that the activity should be rendered as a modal.
+     */
+    Modal = 1,
+    /**
+     * The activity is started for result.
+     */
+    ForResult = 2,
+    /**
+     * When set, the intent data is passed by reference.
+     * By default the activity manager makes a copy of the intent data.
+     * This is useful when the data is large and you want to avoid copying it
+     * or when you want to share the same data between activities.
+     */
+    ByReference = 4
+}
+export interface Intent {
+    action: string;
+    data?: unknown;
+    category?: string[];
+    flags?: number;
+    /**
+     * The request code used to distinguish between different activities.
+     */
+    requestCode?: number;
+}
+export declare enum IntentResult {
+    RESULT_CANCELED = 0,
+    RESULT_OK = 1
+}
+/**
+ * Manages application activities.
+ *
+ * An activity is a screen or a portion of a rendered screen that has its own
+ * lifecycle methods and routing.
+ *
+ * An activity is registered by its class definition. Because of that, activities
+ * cannot have constructors that require own parameters. Activities have to be
+ * self contained or use the event system to request data.
+ */
+export declare class ActivityManager {
+    #private;
+    private currentActivity?;
+    /**
+     * Stores activity *classes* by unique ID (action name).
+     */
+    private activityClasses;
+    /**
+     * Represents the activity stack. It is used to manage
+     * the UI state after calling the back action.
+     */
+    private activityStack;
+    /**
+     * A stack of activities that are rendered over other activities
+     * in a dialog.
+     */
+    private modalActivityStack;
+    private generateActivityId;
+    constructor(parent: Application);
+    registerActivity(action: string, activityClass: typeof Activity): 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,
+     * but it will be only initialized when other activities finis.
+     *
+     * Note, if you add an uninitialized activity and you won't add more activities then this activity may never run.
+     * Make sure that there's always another activity.
+     *
+     * @param intent The intent that created this activity.
+     */
+    createActivity(intent: Intent): Promise<void>;
+    setupRoute(intent: Intent): void;
+    /**
+     * Starts a new activity and brings it to the foreground.
+     *
+     * @param intent The intent that created this activity.
+     */
+    startActivity(intent: Intent): Promise<void>;
+    private buildActivity;
+    /**
+     * Starts an activity that should return a result to the calling activity.
+     * The result should be a unique number across the application.
+     * @param intent The intent to start the activity.
+     * @param requestCode The request code used to match the activity result.
+     */
+    startActivityForResult(intent: Intent, requestCode: number): Promise<void>;
+    isDestroyed(activity: Activity): boolean;
+    /**
+     * @param activity The activity to finish.
+     */
+    finishActivity(activity: Activity): Promise<void>;
+    private manageActivityResult;
+    private bringLastActivityToFront;
+    getTopActivity(): Activity | undefined;
+    getCurrentActivity(): Activity | undefined;
+    /**
+     * A helper method to handle the transition between activities, ensuring
+     * lifecycle methods are called in the correct order (pause the previous activity,
+     * then start/resume the new one). This centralizes lifecycle management.
+     *
+     * @param activity The activity to bring to the foreground.
+     */
+    private updateCurrentActivity;
+    /**
+     * Allows navigating back through the activity stack.
+     * Call `ActivityManager.navigateBack()` when the user performs a back action
+     * (e.g., clicks a back button).
+     */
+    navigateBack(): Promise<void>;
+    createRequestCode(): number;
+    findActiveActivity(action: string): Activity | undefined;
+}
+//# sourceMappingURL=ActivityManager.d.ts.map

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

@@ -0,0 +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,aAAa;IACvB,WAAW,IAAA;IACX,OAAO,IAAA;IACP,OAAO,IAAA;IACP,OAAO,IAAA;IACP,MAAM,IAAA;IACN,OAAO,IAAA;IACP,SAAS,IAAA;CACV;AAED,oBAAY,WAAW;IACrB;;OAEG;IAEH,KAAK,IAAS;IACd;;OAEG;IAEH,SAAS,IAAS;IAClB;;;;;OAKG;IAEH,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;IAoDlD,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;YAgCzC,oBAAoB;YAoBpB,wBAAwB;IAYtC,cAAc,IAAI,QAAQ,GAAG,SAAS;IAStC,kBAAkB,IAAI,QAAQ,GAAG,SAAS;IAI1C;;;;;;OAMG;YACW,qBAAqB;IAyDnC;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC,iBAAiB,IAAI,MAAM;IAM3B,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;CAGzD"}