@api-client/ui 0.1.8 → 0.1.9

package/build/src/core/Activity.js

@@ -6,18 +6,40 @@ 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.
+ * ## Activity
  *
- * **Lifecycle**
+ * `Activity` is a core building block of your application, representing a single,
+ * focused operation that a user can perform.
+ * Activities manage their own lifecycle, UI, and fragments, and communicate with the application
+ * and other activities via intents.
  *
- * - `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
+ * Activities are managed by the application and can be started, paused, resumed, stopped,
+ * and destroyed according to the app's navigation and user actions.
+ * They can also start other activities for results, manage fragments, and handle intent
+ * events dispatched by hosted web components.
+ *
+ * ### Lifecycle Methods
+ * - `onCreate(intent?)` - Called when the activity is first created.
+ * - `onStart()` - Called when the activity becomes visible to the user.
+ * - `onResume()` - Called when the activity gains focus and becomes interactive.
+ * - `onPause()` - Called when the activity loses focus but is still visible.
+ * - `onStop()` - Called when the activity is no longer visible.
+ * - `onDestroy()` - Called before the activity is destroyed.
+ * - `onRestart()` - Called after the activity has been stopped, just prior to it being started again.
+ *
+ * ### Example
+ * ```typescript
+ * class MyActivity extends Activity {
+ *   async onCreate(intent?: Intent) {
+ *     super.onCreate(intent);
+ *     // Initialization logic here
+ *   }
+ *
+ *   render() {
+ *     return html`<h1>Hello from MyActivity!</h1>`;
+ *   }
+ * }
+ * ```
  */
 let Activity = (() => {
     let _classSuper = EventTarget;
@@ -31,151 +53,160 @@ let Activity = (() => {
             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.
+         * The root element where the activity's content should be rendered.
+         * Set this if you want to render outside the application's default render root (e.g., for modals).
          */
         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.
+         * An optional static action name for the activity.
+         * Use this as the registration key for referencing the activity in intents.
+         *
+         * @example
+         * ```typescript
+         * class LoginActivity extends Activity {
+         *   static action = 'login';
+         * }
+         * ```
          */
         static action;
+        /** The current lifecycle state of the activity. */
         lifecycle = ActivityLifecycle.Initialized;
+        /** The parent application instance. */
         parent;
-        /**
-         * The fragment manager that manages fragments in this activity.
-         */
+        /** The fragment manager for managing fragments within this activity. */
         manager;
+        /** Data to be returned as a result to the calling activity. */
         resultData;
+        /** The exit code for the activity result. */
         exitCode = IntentResult.RESULT_CANCELED;
+        /** Gets the current result code for the activity. */
         get resultCode() {
             return this.exitCode;
         }
+        /** Tracks pending request codes for activities started for result. */
+        pendingRequestCodes = [];
         /**
-         * 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.
+         * Constructs a new Activity.
+         * @param parent The parent application instance.
          */
-        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.
+         * Checks if the activity is in the `Destroyed` state.
+         * @returns `true` if destroyed, `false` otherwise.
+         */
+        isDestroyed() {
+            return this.lifecycle === ActivityLifecycle.Destroyed;
+        }
+        /**
+         * Checks if the activity is in the `Resumed` state.
+         * @returns `true` if resumed, `false` otherwise.
+         */
+        isResumed() {
+            return this.lifecycle === ActivityLifecycle.Resumed;
+        }
+        /**
+         * Called when the activity is starting. Override to perform initialization logic.
          * @param intent Optional intent data.
+         * @example
+         * ```typescript
+         * async onCreate(intent?: Intent) {
+         *   await fetchData();
+         * }
+         * ```
          */
         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.
+         * Called when the activity becomes visible to the user.
+         * Override to start animations or prepare UI.
          */
         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.
+         * Called when the activity gains focus and becomes interactive.
+         * Override to start input handling or resume tasks.
          */
         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.
+         * Called when the activity loses focus but is still visible.
+         * Override to pause ongoing tasks or save state.
          */
         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.
+         * Called when the activity is no longer visible to the user.
+         * Override to stop UI updates or animations.
          */
         onStop() {
             this.dispatchEvent(new CustomEvent('activity:stop', { detail: null }));
         }
+        /**
+         * Called after the activity has been stopped, just prior to it being started again.
+         */
         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).
+         * Called before the activity is destroyed. Override to clean up resources.
          */
         onDestroy() {
             this.dispatchEvent(new CustomEvent('activity:destroy', { detail: null }));
             this.manager.onDestroy();
         }
         /**
-         * Called when a new intent is delivered
+         * Called when a new intent is delivered to the activity.
+         * Override to handle new intents.
          * @param intent New intent data.
          */
         onNewIntent(intent) {
-            //
+            // Override in subclass if needed
         }
         /**
          * Called by the renderer when the activity is rendered for the first time.
+         * Override to perform actions after first render.
          */
         onFirstRender() {
-            //
+            // Override in subclass if needed
         }
         /**
-         * A function called when it should render the view.
+         * Renders the activity's view. Override to provide UI.
+         * @returns A Lit TemplateResult or `nothing` if nothing should be rendered.
+         * @example
+         * ```typescript
+         * render() {
+         *   return html`<div>Hello, world!</div>`;
+         * }
+         * ```
          */
         render() {
             return nothing;
         }
         /**
-         * Finishes the activity.
+         * Finishes the activity and notifies the application.
+         * @example
+         * ```typescript
+         * await this.finish();
+         * ```
          */
         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.
+         * Requests the parent application to update the UI.
+         * @param opts Update options.
+         * @example
+         * ```typescript
+         * this.requestUpdate();
+         * ```
          */
         requestUpdate(opts = {}) {
             const { activity = true } = opts;
@@ -185,16 +216,30 @@ let Activity = (() => {
             this.parent.requestUpdate(opts);
         }
         /**
-         * Registers a new fragment.
-         * @param key The name of the fragment
-         * @param fragment The fragment to register.
+         * Registers a new fragment with this activity.
+         * @param key The fragment's key.
+         * @param fragment The fragment instance.
+         * @param data Optional data to pass to the fragment.
+         * @example
+         * ```typescript
+         * await this.addFragment('profile', new ProfileFragment());
+         * ```
          */
         async addFragment(key, fragment, data) {
             await this.manager.attachFragment(key, fragment, this, data);
         }
+        /**
+         * Shows a registered fragment.
+         * @param key The fragment's key.
+         * @param root Optional root element to render into.
+         */
         async showFragment(key, root) {
             await this.manager.showFragment(key, root);
         }
+        /**
+         * Hides a registered fragment.
+         * @param key The fragment's key.
+         */
         async hideFragment(key) {
             const fragment = this.manager.findFragment(key);
             if (fragment) {
@@ -202,23 +247,31 @@ let Activity = (() => {
             }
         }
         /**
-         * Unifies Fragment and Activity interfaces.
-         * @returns `this`
+         * Returns the parent application instance.
+         * @returns The application.
          */
         getApplication() {
             return this.parent;
         }
         /**
-         * A shortcut to the `manager` function.
-         * @param intent The intent to start
+         * Starts a new activity.
+         * @param intent The intent to start.
+         * @example
+         * ```typescript
+         * await this.startActivity({ action: 'login' });
+         * ```
          */
         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.
+         * @param intent The intent to start.
+         * @returns The request code for the started activity.
+         * @example
+         * ```typescript
+         * const code = await this.startActivityForResult({ action: 'pickFile' });
+         * ```
          */
         async startActivityForResult(intent) {
             const { manager } = this.getApplication();
@@ -228,25 +281,32 @@ let Activity = (() => {
             return code;
         }
         /**
-         * Call this method to return data to the activity that started this activity.
-         * @param data The data to return.
+         * Sets the result to be returned to the calling activity.
+         * @param resultCode The result code.
+         * @param data Optional result data.
+         * @example
+         * ```typescript
+         * this.setResult(IntentResult.RESULT_OK, { userId: 123 });
+         * ```
          */
         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.
+         * Called when an activity you launched exits, giving you the request code, result code, and intent.
+         * Override to handle results from started activities.
+         * @param requestCode The request code.
+         * @param resultCode The result code.
          * @param intent The intent that was used to start the activity.
+         * @example
+         * ```typescript
+         * async onActivityResult(requestCode, resultCode, intent) {
+         *   if (resultCode === IntentResult.RESULT_OK) {
+         *     // handle result
+         *   }
+         * }
+         * ```
          */
         async onActivityResult(requestCode, resultCode, intent) {
             const index = this.pendingRequestCodes.indexOf(requestCode);
@@ -263,34 +323,39 @@ let Activity = (() => {
                 console.info(`Activity#onActivityResult not implemented. Request code: ${requestCode}, result code: ${resultCode}`, intent);
             }
         }
+        /**
+         * Returns the current activity instance.
+         * @returns This activity.
+         */
         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.
+         * Checks if this activity initiated the activity for result with the given code.
+         * @param code The request code.
+         * @returns `true` if the code is pending, `false` otherwise.
          */
         hasRequestCode(code) {
             return this.pendingRequestCodes.includes(code);
         }
+        /**
+         * Gets the result data set by `setResult`.
+         * @returns The result data or `undefined`.
+         */
         getResult() {
             return this.resultData;
         }
         /**
-         * A handler for the intent event dispatched by web components hosted by this activity.
-         *
-         * **Usage example:**
+         * Handles intent events dispatched by web components hosted by this activity.
          *
-         * ```ts
+         * Usage example:
+         * ```html
          * <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.
+         * @param event The intent event.
+         * @throws Error if the event type is not recognized.
          */
         async handleIntentEvent(event) {
             if (event.type === EventTypes.Intent.startActivityForResult) {

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

@@ -1 +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 { ActivityLifecycle, 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 lifecycle: ActivityLifecycle = ActivityLifecycle.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    this.manager.onDestroy()\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  async addFragment(key: string, fragment: Fragment, data?: unknown): Promise<void> {\n    await this.manager.attachFragment(key, fragment, this, data)\n  }\n\n  async showFragment(key: string, root?: HTMLElement): Promise<void> {\n    await this.manager.showFragment(key, root)\n  }\n\n  async hideFragment(key: string): Promise<void> {\n    const fragment = this.manager.findFragment(key)\n    if (fragment) {\n      await 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      await this.startActivity(event.detail.intent)\n    } else {\n      throw new Error(`Unrecognized intent event: ${event.type}`)\n    }\n  }\n}\n"]}
+{"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 { ActivityLifecycle, 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\n *\n * `Activity` is a core building block of your application, representing a single,\n * focused operation that a user can perform.\n * Activities manage their own lifecycle, UI, and fragments, and communicate with the application\n * and other activities via intents.\n *\n * Activities are managed by the application and can be started, paused, resumed, stopped,\n * and destroyed according to the app's navigation and user actions.\n * They can also start other activities for results, manage fragments, and handle intent\n * events dispatched by hosted web components.\n *\n * ### Lifecycle Methods\n * - `onCreate(intent?)` - Called when the activity is first created.\n * - `onStart()` - Called when the activity becomes visible to the user.\n * - `onResume()` - Called when the activity gains focus and becomes interactive.\n * - `onPause()` - Called when the activity loses focus but is still visible.\n * - `onStop()` - Called when the activity is no longer visible.\n * - `onDestroy()` - Called before the activity is destroyed.\n * - `onRestart()` - Called after the activity has been stopped, just prior to it being started again.\n *\n * ### Example\n * ```typescript\n * class MyActivity extends Activity {\n *   async onCreate(intent?: Intent) {\n *     super.onCreate(intent);\n *     // Initialization logic here\n *   }\n *\n *   render() {\n *     return html`<h1>Hello from MyActivity!</h1>`;\n *   }\n * }\n * ```\n */\nexport class Activity extends EventTarget {\n  /**\n   * The root element where the activity's content should be rendered.\n   * Set this if you want to render outside the application's default render root (e.g., for modals).\n   */\n  renderRoot?: HTMLElement\n\n  /**\n   * An optional static action name for the activity.\n   * Use this as the registration key for referencing the activity in intents.\n   *\n   * @example\n   * ```typescript\n   * class LoginActivity extends Activity {\n   *   static action = 'login';\n   * }\n   * ```\n   */\n  static action?: string\n\n  /** The current lifecycle state of the activity. */\n  public lifecycle: ActivityLifecycle = ActivityLifecycle.Initialized\n\n  /** The parent application instance. */\n  protected parent: Application\n\n  /** The fragment manager for managing fragments within this activity. */\n  protected manager: FragmentManager\n\n  /** Data to be returned as a result to the calling activity. */\n  protected resultData?: unknown\n\n  /** The exit code for the activity result. */\n  protected exitCode = IntentResult.RESULT_CANCELED\n\n  /** Gets the current result code for the activity. */\n  get resultCode(): IntentResult {\n    return this.exitCode\n  }\n\n  /** Tracks pending request codes for activities started for result. */\n  protected pendingRequestCodes: number[] = []\n\n  /**\n   * Constructs a new Activity.\n   * @param parent The parent application instance.\n   */\n  constructor(parent: Application) {\n    super()\n    this.parent = parent\n    this.manager = new FragmentManager(this)\n  }\n\n  /**\n   * Checks if the activity is in the `Destroyed` state.\n   * @returns `true` if destroyed, `false` otherwise.\n   */\n  isDestroyed(): boolean {\n    return this.lifecycle === ActivityLifecycle.Destroyed\n  }\n\n  /**\n   * Checks if the activity is in the `Resumed` state.\n   * @returns `true` if resumed, `false` otherwise.\n   */\n  isResumed(): boolean {\n    return this.lifecycle === ActivityLifecycle.Resumed\n  }\n\n  /**\n   * Called when the activity is starting. Override to perform initialization logic.\n   * @param intent Optional intent data.\n   * @example\n   * ```typescript\n   * async onCreate(intent?: Intent) {\n   *   await fetchData();\n   * }\n   * ```\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 to the user.\n   * Override to start animations or prepare UI.\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 and becomes interactive.\n   * Override to start input handling or resume tasks.\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 but is still visible.\n   * Override to pause ongoing tasks or save state.\n   */\n  onPause(): void | Promise<void> {\n    this.dispatchEvent(new CustomEvent('activity:pause', { detail: null }))\n  }\n\n  /**\n   * Called when the activity is no longer visible to the user.\n   * Override to stop UI updates or animations.\n   */\n  onStop(): void | Promise<void> {\n    this.dispatchEvent(new CustomEvent('activity:stop', { detail: null }))\n  }\n\n  /**\n   * Called after the activity has been stopped, just prior to it being started again.\n   */\n  onRestart(): void | Promise<void> {\n    this.dispatchEvent(new CustomEvent('activity:restart', { detail: null }))\n  }\n\n  /**\n   * Called before the activity is destroyed. Override to clean up resources.\n   */\n  onDestroy(): void | Promise<void> {\n    this.dispatchEvent(new CustomEvent('activity:destroy', { detail: null }))\n    this.manager.onDestroy()\n  }\n\n  /**\n   * Called when a new intent is delivered to the activity.\n   * Override to handle new intents.\n   * @param intent New intent data.\n   */\n  onNewIntent(intent: Intent): void | Promise<void> {\n    // Override in subclass if needed\n  }\n\n  /**\n   * Called by the renderer when the activity is rendered for the first time.\n   * Override to perform actions after first render.\n   */\n  onFirstRender(): void {\n    // Override in subclass if needed\n  }\n\n  /**\n   * Renders the activity's view. Override to provide UI.\n   * @returns A Lit TemplateResult or `nothing` if nothing should be rendered.\n   * @example\n   * ```typescript\n   * render() {\n   *   return html`<div>Hello, world!</div>`;\n   * }\n   * ```\n   */\n  render(): TemplateResult | typeof nothing {\n    return nothing\n  }\n\n  /**\n   * Finishes the activity and notifies the application.\n   * @example\n   * ```typescript\n   * await this.finish();\n   * ```\n   */\n  async finish(): Promise<void> {\n    await this.getApplication().manager.finishActivity(this)\n  }\n\n  /**\n   * Requests the parent application to update the UI.\n   * @param opts Update options.\n   * @example\n   * ```typescript\n   * this.requestUpdate();\n   * ```\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 with this activity.\n   * @param key The fragment's key.\n   * @param fragment The fragment instance.\n   * @param data Optional data to pass to the fragment.\n   * @example\n   * ```typescript\n   * await this.addFragment('profile', new ProfileFragment());\n   * ```\n   */\n  async addFragment(key: string, fragment: Fragment, data?: unknown): Promise<void> {\n    await this.manager.attachFragment(key, fragment, this, data)\n  }\n\n  /**\n   * Shows a registered fragment.\n   * @param key The fragment's key.\n   * @param root Optional root element to render into.\n   */\n  async showFragment(key: string, root?: HTMLElement): Promise<void> {\n    await this.manager.showFragment(key, root)\n  }\n\n  /**\n   * Hides a registered fragment.\n   * @param key The fragment's key.\n   */\n  async hideFragment(key: string): Promise<void> {\n    const fragment = this.manager.findFragment(key)\n    if (fragment) {\n      await this.manager.hideFragment(fragment)\n    }\n  }\n\n  /**\n   * Returns the parent application instance.\n   * @returns The application.\n   */\n  getApplication(): Application {\n    return this.parent\n  }\n\n  /**\n   * Starts a new activity.\n   * @param intent The intent to start.\n   * @example\n   * ```typescript\n   * await this.startActivity({ action: 'login' });\n   * ```\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 to start.\n   * @returns The request code for the started activity.\n   * @example\n   * ```typescript\n   * const code = await this.startActivityForResult({ action: 'pickFile' });\n   * ```\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   * Sets the result to be returned to the calling activity.\n   * @param resultCode The result code.\n   * @param data Optional result data.\n   * @example\n   * ```typescript\n   * this.setResult(IntentResult.RESULT_OK, { userId: 123 });\n   * ```\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 request code, result code, and intent.\n   * Override to handle results from started activities.\n   * @param requestCode The request code.\n   * @param resultCode The result code.\n   * @param intent The intent that was used to start the activity.\n   * @example\n   * ```typescript\n   * async onActivityResult(requestCode, resultCode, intent) {\n   *   if (resultCode === IntentResult.RESULT_OK) {\n   *     // handle result\n   *   }\n   * }\n   * ```\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  /**\n   * Returns the current activity instance.\n   * @returns This activity.\n   */\n  getActivity(): Activity {\n    return this\n  }\n\n  /**\n   * Checks if this activity initiated the activity for result with the given code.\n   * @param code The request code.\n   * @returns `true` if the code is pending, `false` otherwise.\n   */\n  hasRequestCode(code: number): boolean {\n    return this.pendingRequestCodes.includes(code)\n  }\n\n  /**\n   * Gets the result data set by `setResult`.\n   * @returns The result data or `undefined`.\n   */\n  getResult(): unknown | undefined {\n    return this.resultData\n  }\n\n  /**\n   * Handles intent events dispatched by web components hosted by this activity.\n   *\n   * Usage example:\n   * ```html\n   * <custom-element @startactivity=\"${this.handleIntentEvent}\"></custom-element>\n   * <custom-element @startactivityforresult=\"${this.handleIntentEvent}\"></custom-element>\n   * ```\n   *\n   * @param event The intent event.\n   * @throws 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      await this.startActivity(event.detail.intent)\n    } else {\n      throw new Error(`Unrecognized intent event: ${event.type}`)\n    }\n  }\n}\n"]}

package/package.json

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