@rdlabo/ionic-angular-kit 0.0.7 → 0.0.9

package/README.md

@@ -155,6 +155,8 @@ presentPopover<O>(
 
 presentToast(options: ToastOptions): Promise<HTMLIonToastElement>
 // kit defaults: position='bottom', duration=2000, swipeGesture='vertical'
+// A bottom toast with no explicit positionAnchor auto-anchors above a visible <ion-tab-bar>
+// (so it clears the tabs); keyboard avoidance rides the native keyboard resize.
 // caller options spread over the defaults — any field can be overridden
 
 alertClose(options: { header: string; message: string; subHeader?: string }): Promise<void>
@@ -288,9 +290,9 @@ A fleet-canonical HTTP interceptor with:
 
 - Per-request auth header injection
 - Configurable bypass (CDN, S3, external URLs)
-- Exponential-backoff retry (count: 2) skipping `[400, 403, 404, 418, 500, 502]` and `401`
-- Offline fallback (short-circuit error with a cached response)
-- Error hooks for 401, 403, network errors, and server errors with `error.message`
+- **Safe retry**: only idempotent methods (`GET`/`HEAD`/`OPTIONS`, or a request with an `Idempotency-Key`) are retried, and only on a transient status `[0, 408, 429, 502, 503, 504]`, up to 2 times with a short jittered backoff (honoring `Retry-After`). **Writes are never auto-retried** (no duplicate saves).
+- **Offline fast-fail**: when the device is offline the interceptor stops retrying immediately and hands off to `offlineFallback` instead of waiting out the backoff.
+- **Status classification**: `0`→`onNetworkError` (connected only), `429`→`onRateLimited`, `502/503/504`→`onServerBusy`, `400/422/500`+message→`onServerError`, `401`→`onUnauthorized`, `403`→`onForbidden`. Other statuses (e.g. `404`) are left to the caller.
 
 **Convention:** all app-specific logic (auth headers, error UI) lives in the config factory. The retry policy, bypass evaluation, and error dispatch are fixed in the kit and not overridable per-call.
 
@@ -330,12 +332,16 @@ export const appConfig: ApplicationConfig = {
 };
 ```
 
-**Error dispatch order** (in `catchError`):
+**Error dispatch** (after retries, in `catchError`):
 1. `offlineFallback` non-null → return fallback observable (no further hooks called)
-2. `401` → `onUnauthorized`
-3. `403` → `onForbidden`
-4. Non-400/500 status AND device connected → `onNetworkError`
-5. 400 or 500 with `error.message` → `onServerError`
+2. `401` → `onUnauthorized` · `403` → `onForbidden`
+3. `0` (connected) → `onNetworkError` · `429` → `onRateLimited(retryAfter?)` · `502/503/504` → `onServerBusy(status, retryAfter?)`
+4. `400/422/500` with `error.message` → `onServerError`
+5. anything else (`404`, …) → not handled here; the caller decides
+
+Plus: a `getAuthHeaders` rejection → `onAuthError(request, error)` (the request is never sent).
+
+**Note (0.0.9):** `onNetworkError` is now narrowed to genuine network failures (status `0`); `502/503/429` moved to `onServerBusy`/`onRateLimited`. Existing configs stay valid — they just fire less often — so adopt the new hooks only if you want to distinguish server-busy / rate-limit from a connection loss.
 
 ### KitReloadAlertController
 

package/fesm2022/rdlabo-ionic-angular-kit.mjs

@@ -6,10 +6,10 @@ import { Capacitor } from '@capacitor/core';
 import { Keyboard } from '@capacitor/keyboard';
 import { ImpactStyle, Haptics } from '@capacitor/haptics';
 import { Router } from '@angular/router';
-import { map, mergeMap, tap, catchError } from 'rxjs/operators';
+import { map, mergeMap, catchError, tap } from 'rxjs/operators';
 import { HttpResponse } from '@angular/common/http';
 import { Network } from '@capacitor/network';
-import { from, retry, throwError, timer } from 'rxjs';
+import { from, throwError, retry, timer } from 'rxjs';
 
 /**
  * Thin, typed wrapper around `@ionic/storage-angular`.
@@ -242,8 +242,12 @@ class KitOverlayController {
      * from the configured labels; any of these can be overridden via `options`. Presenting a toast
      * also triggers light native haptic feedback as an intentional kit UX choice.
      *
-     * Bottom is the fleet-wide default (top left the toast fighting the tab bar and the keyboard); an
-     * app that wants it elsewhere passes `position` / `positionAnchor` in `options`.
+     * Bottom is the fleet-wide default (top left the toast fighting the tab bar and the keyboard).
+     * For a bottom toast with no explicit `positionAnchor`, if a visible `ion-tab-bar` is present the
+     * toast is automatically anchored above it (Ionic places a bottom toast above its `positionAnchor`),
+     * so the toast never sits behind the tabs. Avoiding the on-screen keyboard is handled by the native
+     * keyboard resize — the anchored/bottom toast rides the shrinking viewport above the keyboard;
+     * Ionic itself has no toast keyboard-avoidance option. An app can override either via `options`.
      *
      * @param options - Ionic toast options that override the kit defaults
      * @returns the presented toast element
@@ -254,13 +258,22 @@ class KitOverlayController {
      */
     async presentToast(options) {
         void kitImpact();
-        const toast = await this.#toastCtrl.create({
+        const merged = {
             position: 'bottom',
             duration: 2000,
             buttons: [this.#labels.close],
             swipeGesture: 'vertical',
             ...options,
-        });
+        };
+        // Anchor a bottom toast above the tab bar when one is visibly present and the caller did not
+        // set an explicit anchor, so the toast clears the tabs (and rides the keyboard-resized viewport).
+        if (merged.position === 'bottom' && merged.positionAnchor === undefined) {
+            const tabBar = document.querySelector('ion-tab-bar');
+            if (tabBar && tabBar.getBoundingClientRect().height > 0) {
+                merged.positionAnchor = tabBar;
+            }
+        }
+        const toast = await this.#toastCtrl.create(merged);
         await toast.present();
         return toast;
     }
@@ -788,11 +801,49 @@ const kitRequireAuthorizedGuard = (_route, state) => {
 };
 
 /**
- * HTTP status codes that must never be retried. `401` is handled separately and thrown immediately.
+ * HTTP methods that are safe to retry automatically.
+ *
+ * @remarks
+ * Non-idempotent methods (`POST` / `PATCH` / `DELETE`) are never auto-retried, because a response
+ * lost *after* the server processed the write would be replayed into a duplicate write ("saved twice
+ * from one tap"). A non-idempotent request that is genuinely safe to replay opts in by carrying an
+ * `Idempotency-Key` header (which the server must honor).
+ *
+ * @internal
+ */
+const RETRYABLE_METHODS = ['GET', 'HEAD', 'OPTIONS'];
+/**
+ * Transient HTTP statuses worth retrying: `0` (network/transport failure), `408` (request timeout),
+ * `429` (rate limited), and the `502` / `503` / `504` gateway-availability family. Every other status
+ * is thrown immediately — a whitelist is safer than a blacklist for deciding what to replay.
+ *
+ * @internal
+ */
+const RETRYABLE_STATUSES = [0, 408, 429, 502, 503, 504];
+/**
+ * Maximum number of automatic retries for a retryable request.
+ *
+ * @internal
+ */
+const MAX_RETRIES = 2;
+/**
+ * Parse a `Retry-After` header (delta-seconds or an HTTP-date) into milliseconds, or `null` when it
+ * is absent or unparseable.
  *
  * @internal
  */
-const NON_RETRYABLE_STATUSES = [400, 403, 404, 418, 500, 502];
+const parseRetryAfterMs = (error) => {
+    const header = error.headers?.get('Retry-After');
+    if (!header) {
+        return null;
+    }
+    const seconds = Number(header);
+    if (Number.isFinite(seconds)) {
+        return Math.max(0, seconds * 1000);
+    }
+    const dateMs = Date.parse(header);
+    return Number.isNaN(dateMs) ? null : Math.max(0, dateMs - Date.now());
+};
 /**
  * Injection token that carries the {@link KitHttpConfig} to {@link kitAuthInterceptor}.
  */
@@ -829,6 +880,41 @@ const KIT_HTTP_CONFIG = new InjectionToken('@rdlabo/ionic-angular-kit:http');
  * ```
  */
 const provideKitHttp = (configFactory) => makeEnvironmentProviders([{ provide: KIT_HTTP_CONFIG, useFactory: configFactory }]);
+/**
+ * Classify a final (post-retry) error and invoke the matching {@link KitHttpConfig} hook.
+ *
+ * @internal
+ */
+const dispatchError = (config, req, error) => {
+    const status = error.status;
+    const retryAfterMs = parseRetryAfterMs(error);
+    const retryAfterSeconds = retryAfterMs === null ? undefined : Math.round(retryAfterMs / 1000);
+    if (status === 401) {
+        config.onUnauthorized?.(req);
+    }
+    else if (status === 403) {
+        config.onForbidden?.(req);
+    }
+    else if (status === 0) {
+        // Genuine network/transport failure. Only surface it when the device is actually connected
+        // (server unreachable); when offline, offlineFallback owns the UX — a reload prompt won't help.
+        void Network.getStatus().then((network) => {
+            if (network.connected) {
+                config.onNetworkError?.(status);
+            }
+        });
+    }
+    else if (status === 429) {
+        config.onRateLimited?.(retryAfterSeconds);
+    }
+    else if ([502, 503, 504].includes(status)) {
+        config.onServerBusy?.(status, retryAfterSeconds);
+    }
+    else if ([400, 422, 500].includes(status) && error.error?.message) {
+        config.onServerError?.(error.error.message);
+    }
+    // Every other status (404, 418, …) is left to the caller — no generic alert.
+};
 /**
  * Canonical functional HTTP interceptor that applies authentication, retries, and error handling.
  *
@@ -836,14 +922,17 @@ const provideKitHttp = (configFactory) => makeEnvironmentProviders([{ provide: K
  * Behavior, driven by the injected {@link KitHttpConfig}:
  *
  * 1. Requests for which `bypass` returns `true` are forwarded untouched.
- * 2. Otherwise the headers from `getAuthHeaders` and `buildExtraHeaders` are merged onto a cloned request.
- * 3. Failed requests are retried up to 2 times with a linearly increasing backoff of `500ms * (retryCount + 5)`,
- *    except that `401` and any {@link NON_RETRYABLE_STATUSES | non-retryable status}
- *    (`400`, `403`, `404`, `418`, `500`, `502`) are thrown immediately without retrying.
- * 4. On error, `offlineFallback` is consulted first; otherwise `401` calls `onUnauthorized`, `403`
- *    calls `onForbidden`, network-class failures (anything other than `400`/`500`) call
- *    `onNetworkError` when the device is connected, and `400`/`500` responses carrying a body
- *    message call `onServerError`.
+ * 2. If `getAuthHeaders` rejects, `onAuthError` is called and the request is not sent.
+ * 3. Otherwise the headers from `getAuthHeaders` and `buildExtraHeaders` are merged onto a cloned request.
+ * 4. On failure the request is retried up to {@link MAX_RETRIES} times, but **only** when the device
+ *    is online, the method is a {@link RETRYABLE_METHODS | retryable method} (or carries an
+ *    `Idempotency-Key`), and the status is a {@link RETRYABLE_STATUSES | transient status}. The
+ *    backoff is `retryCount * 500ms` plus up to 250ms of jitter, or the server's `Retry-After`.
+ *    When the device is offline it stops retrying immediately.
+ * 5. On the final error, `offlineFallback` is consulted first; otherwise the error is classified by
+ *    status (see {@link dispatchError}): `401`→`onUnauthorized`, `403`→`onForbidden`, `0`→
+ *    `onNetworkError` (when connected), `429`→`onRateLimited`, `502`/`503`/`504`→`onServerBusy`, and
+ *    `400`/`422`/`500` with a body message→`onServerError`.
  *
  * @param request - The outgoing request.
  * @param next - The next handler in the interceptor chain.
@@ -859,45 +948,40 @@ const kitAuthInterceptor = (request, next) => {
     if (config.bypass?.(request)) {
         return next(request);
     }
-    return from(config.getAuthHeaders(request)).pipe(mergeMap((authHeaders) => {
+    return from(Promise.resolve(config.getAuthHeaders(request))).pipe(catchError((headerError) => {
+        // getAuthHeaders failed → the request is never sent; classify it instead of failing silently.
+        config.onAuthError?.(request, headerError);
+        return throwError(() => headerError);
+    }), mergeMap((authHeaders) => {
         const req = request.clone({ setHeaders: { ...authHeaders, ...config.buildExtraHeaders?.(request) } });
+        const retryable = RETRYABLE_METHODS.includes(req.method) || req.headers.has('Idempotency-Key');
         return next(req).pipe(retry({
-            count: 2,
-            delay: (e, retryCount) => {
-                if (e.status === 401) {
-                    return throwError(() => e);
+            count: MAX_RETRIES,
+            delay: (error, retryCount) => from(Network.getStatus()).pipe(mergeMap((network) => {
+                // Offline → don't wait out the retries; fail fast so offlineFallback can take over.
+                if (!network.connected) {
+                    return throwError(() => error);
                 }
-                if (NON_RETRYABLE_STATUSES.includes(e.status)) {
-                    return throwError(() => e);
+                // Only replay idempotent requests, and only on a transient status.
+                if (!retryable || !RETRYABLE_STATUSES.includes(error.status)) {
+                    return throwError(() => error);
                 }
-                return timer((retryCount + 5) * 500);
-            },
+                // Short linear backoff (500ms, 1000ms, …) plus jitter to de-correlate a fleet of
+                // clients reconnecting at once; the server's Retry-After wins when present.
+                const backoff = parseRetryAfterMs(error) ?? retryCount * 500 + Math.random() * 250;
+                return timer(backoff);
+            })),
         }), tap((event) => {
             if (event instanceof HttpResponse) {
                 config.onResponse?.(event);
             }
-        }), catchError((e) => {
-            const fallback = config.offlineFallback?.(req, e);
+        }), catchError((error) => {
+            const fallback = config.offlineFallback?.(req, error);
             if (fallback) {
                 return fallback;
             }
-            if (e.status === 401) {
-                config.onUnauthorized?.(req);
-            }
-            else if (e.status === 403) {
-                config.onForbidden?.(req);
-            }
-            else if (![400, 500].includes(e.status)) {
-                void Network.getStatus().then((status) => {
-                    if (status.connected) {
-                        config.onNetworkError?.(e.status);
-                    }
-                });
-            }
-            else if (e.error?.message) {
-                config.onServerError?.(e.error.message);
-            }
-            return throwError(() => e);
+            dispatchError(config, req, error);
+            return throwError(() => error);
         }));
     }));
 };

package/fesm2022/rdlabo-ionic-angular-kit.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"rdlabo-ionic-angular-kit.mjs","sources":["../../../projects/kit/src/lib/storage/kit-storage.service.ts","../../../projects/kit/src/lib/overlay/overlay-config.ts","../../../projects/kit/src/lib/utils/haptics.ts","../../../projects/kit/src/lib/overlay/kit-overlay.controller.ts","../../../projects/kit/src/lib/overlay/kit-reload-alert.controller.ts","../../../projects/kit/src/lib/overlay/kit-auth-failed-alert.ts","../../../projects/kit/src/lib/directives/autofill.directive.ts","../../../projects/kit/src/lib/keyboard/kit-keyboard.controller.ts","../../../projects/kit/src/lib/auth/auth-guards.ts","../../../projects/kit/src/lib/http/kit-http.interceptor.ts","../../../projects/kit/src/lib/utils/array.ts","../../../projects/kit/src/lib/utils/object.ts","../../../projects/kit/src/lib/utils/dom.ts","../../../projects/kit/src/public-api.ts","../../../projects/kit/src/rdlabo-ionic-angular-kit.ts"],"sourcesContent":["import { inject, Injectable } from '@angular/core';\nimport { Storage } from '@ionic/storage-angular';\n\n/**\n * Thin, typed wrapper around `@ionic/storage-angular`.\n *\n * Starts `create()` exactly once and stores the resulting ready Promise. Every operation awaits\n * that Promise before touching the underlying store, so calls made before initialization completes\n * are queued rather than dropped.\n *\n * @remarks\n * A naive wrapper that reads the store synchronously would silently no-op (or throw) when invoked\n * before `create()` resolves, losing early writes. Awaiting the one-time ready Promise on every\n * operation removes that race without forcing callers to coordinate initialization themselves.\n *\n * @example\n * ```ts\n * constructor(private readonly storage: KitStorageService) {}\n *\n * async ngOnInit(): Promise<void> {\n *   await this.storage.set('token', 'abc123');\n *   const token = await this.storage.get<string>('token');\n * }\n * ```\n */\n@Injectable({\n  providedIn: 'root',\n})\nexport class KitStorageService {\n  /** One-time `create()` ready Promise; awaited before every operation so early calls are not lost. */\n  readonly #ready: Promise<Storage> = inject(Storage).create();\n\n  /**\n   * Persist a value under the given key.\n   *\n   * @typeParam T - type of the value being stored\n   * @param key - key to store the value under\n   * @param value - value to persist; overwrites any existing value for the key\n   * @returns a Promise that resolves once the value has been written\n   * @example\n   * ```ts\n   * await storage.set('user', { id: 1, name: 'Ada' });\n   * ```\n   */\n  async set<T>(key: string, value: T): Promise<void> {\n    await (await this.#ready).set(key, value);\n  }\n\n  /**\n   * Read the value stored under the given key.\n   *\n   * @typeParam T - expected type of the stored value\n   * @param key - key to read\n   * @returns the stored value, or `null` when the key is absent\n   * @example\n   * ```ts\n   * const user = await storage.get<{ id: number }>('user');\n   * ```\n   */\n  async get<T>(key: string): Promise<T | null> {\n    return (await (await this.#ready).get(key)) ?? null;\n  }\n\n  /**\n   * Remove the value stored under the given key.\n   *\n   * @param key - key to remove; a no-op when the key is absent\n   * @returns a Promise that resolves once the key has been removed\n   */\n  async remove(key: string): Promise<void> {\n    await (await this.#ready).remove(key);\n  }\n\n  /**\n   * Remove every key/value pair from the store.\n   *\n   * @returns a Promise that resolves once the store has been emptied\n   */\n  async clear(): Promise<void> {\n    await (await this.#ready).clear();\n  }\n\n  /**\n   * List every key currently present in the store.\n   *\n   * @returns an array of all stored keys\n   */\n  async keys(): Promise<string[]> {\n    return (await this.#ready).keys();\n  }\n}\n","import type { EnvironmentProviders } from '@angular/core';\nimport { InjectionToken, makeEnvironmentProviders } from '@angular/core';\n\n/**\n * User-visible button labels consumed by `KitOverlayController`.\n *\n * @remarks\n * The kit deliberately ships no i18n strings of its own and has no hard dependency on\n * `@angular/localize`. The consuming application always provides these labels: multilingual apps\n * pass `$localize`-resolved strings, single-language apps pass plain literals.\n */\nexport interface KitLabels {\n  /** Text for the \"close\" button used by alerts and toasts. */\n  readonly close: string;\n  /** Text for the \"cancel\" button used by confirmation alerts. */\n  readonly cancel: string;\n}\n\n/**\n * Overlay configuration injected via `provideKitOverlay()`.\n *\n * @remarks\n * All fields are required; the consuming application must supply a complete configuration.\n */\nexport interface KitOverlayConfig {\n  /** Button labels used across the overlays presented by `KitOverlayController`. */\n  readonly labels: KitLabels;\n}\n\n/**\n * Injection token carrying the {@link KitOverlayConfig} for `KitOverlayController`.\n *\n * @remarks\n * Provide it through {@link provideKitOverlay} rather than registering it directly.\n */\nexport const KIT_OVERLAY_CONFIG = new InjectionToken<KitOverlayConfig>('@rdlabo/ionic-angular-kit:overlay');\n\n/**\n * Wire `KitOverlayController` into the application by providing its button labels.\n *\n * @param config - overlay configuration, including the button labels to inject\n * @returns environment providers to add to the application's provider list\n * @example\n * ```ts\n * bootstrapApplication(AppComponent, {\n *   providers: [\n *     provideKitOverlay({ labels: { close: $localize`Close`, cancel: $localize`Cancel` } }),\n *   ],\n * });\n * ```\n */\nexport const provideKitOverlay = (config: KitOverlayConfig): EnvironmentProviders =>\n  makeEnvironmentProviders([{ provide: KIT_OVERLAY_CONFIG, useValue: config }]);\n","import { Capacitor } from '@capacitor/core';\nimport { Haptics, ImpactStyle } from '@capacitor/haptics';\n\n/**\n * Trigger native haptic impact feedback.\n *\n * Delegates to `@capacitor/haptics` `Haptics.impact()` when running on a native platform. On the\n * web (or any non-native platform) it is a no-op and resolves without doing anything.\n *\n * @remarks\n * This haptic side effect was previously bundled implicitly into toast/modal presentation. It has\n * been decoupled into this explicit function so callers opt in to the feedback deliberately, rather\n * than receiving it as a hidden side effect of presenting UI.\n *\n * @param style - The impact intensity to play. Defaults to {@link ImpactStyle.Light}.\n * @returns A promise that resolves once the feedback has been requested (immediately on the web).\n * @example\n * ```ts\n * import { ImpactStyle } from '@capacitor/haptics';\n *\n * // Light tap (default)\n * await kitImpact();\n *\n * // Stronger feedback, e.g. on a confirming action\n * await kitImpact(ImpactStyle.Heavy);\n * ```\n */\nexport const kitImpact = async (style: ImpactStyle = ImpactStyle.Light): Promise<void> => {\n  if (Capacitor.isNativePlatform()) {\n    await Haptics.impact({ style });\n  }\n};\n","import { inject, Injectable } from '@angular/core';\nimport type { ModalOptions, PopoverOptions, ToastOptions } from '@ionic/angular/standalone';\nimport { AlertController, ModalController, PopoverController, ToastController } from '@ionic/angular/standalone';\nimport type { PluginListenerHandle } from '@capacitor/core';\nimport { Capacitor } from '@capacitor/core';\nimport { Keyboard } from '@capacitor/keyboard';\nimport { KIT_OVERLAY_CONFIG } from './overlay-config';\nimport { kitImpact } from '../utils/haptics';\n\n/**\n * Options for {@link KitOverlayController.presentModal}.\n *\n * @remarks\n * Extends Ionic's `ModalOptions` but omits `component` and `componentProps`, which are passed as\n * dedicated arguments instead.\n */\nexport interface KitModalPresentOptions extends Omit<ModalOptions, 'component' | 'componentProps'> {\n  /**\n   * When `true`, expand the sheet to its maximum breakpoint while the native keyboard is shown.\n   *\n   * @remarks\n   * Only has an effect on native platforms; ignored on the web.\n   */\n  watchKeyboard?: boolean;\n}\n\n/**\n * Options for {@link KitOverlayController.alertClose}.\n */\nexport interface KitAlertCloseOptions {\n  /** Alert header text. */\n  header: string;\n  /** Alert body message. */\n  message: string;\n  /** Optional alert sub-header text shown beneath the header. */\n  subHeader?: string;\n}\n\n/**\n * Options for {@link KitOverlayController.alertConfirm}.\n *\n * @remarks\n * Extends {@link KitAlertCloseOptions} with the confirm-button text.\n */\nexport interface KitAlertConfirmOptions extends KitAlertCloseOptions {\n  /**\n   * Text for the OK (confirm) button.\n   *\n   * @remarks\n   * Action-specific, so it is supplied by the caller rather than taken from the shared labels.\n   */\n  okText: string;\n}\n\n/**\n * Attach a native keyboard listener that grows the modal to its maximum breakpoint when the\n * keyboard appears.\n *\n * @param modal - the presented modal element to resize\n * @returns a listener handle; on non-native platforms a no-op handle whose `remove()` does nothing\n * @internal\n */\nconst watchModalKeyboard = async (modal: HTMLIonModalElement): Promise<PluginListenerHandle> => {\n  if (!Capacitor.isNativePlatform()) {\n    return { remove: async () => undefined };\n  }\n  return Keyboard.addListener('keyboardDidShow', () => modal.setCurrentBreakpoint(1));\n};\n\n/**\n * Ergonomic wrapper that consolidates Ionic's overlay controllers (Modal / Toast / Alert).\n *\n * @remarks\n * Folds the repetitive create → present → onDidDismiss sequence into single calls and returns the\n * relevant result directly. It holds no application-specific policy such as navigation; compose\n * those concerns on the consuming side.\n *\n * @example\n * ```ts\n * constructor(private readonly overlay: KitOverlayController) {}\n *\n * async edit(): Promise<void> {\n *   const result = await this.overlay.presentModal<EditResult>(EditPage, { id: 1 });\n *   if (result) {\n *     await this.overlay.presentToast({ message: 'Saved' });\n *   }\n * }\n * ```\n */\n@Injectable({\n  providedIn: 'root',\n})\nexport class KitOverlayController {\n  readonly #modalCtrl = inject(ModalController);\n  readonly #popoverCtrl = inject(PopoverController);\n  readonly #toastCtrl = inject(ToastController);\n  readonly #alertCtrl = inject(AlertController);\n  readonly #labels = inject(KIT_OVERLAY_CONFIG).labels;\n\n  /**\n   * Present a modal and resolve with the data passed to its dismissal.\n   *\n   * @typeParam O - type of the data returned when the modal is dismissed\n   * @param component - the component to render inside the modal\n   * @param componentProps - props to pass to the modal component\n   * @param options - additional modal options, including {@link KitModalPresentOptions.watchKeyboard}\n   * @returns the dismiss data, or `undefined` when the modal is dismissed without data\n   * @example\n   * ```ts\n   * const data = await overlay.presentModal<{ saved: boolean }>(EditPage, { id: 1 }, { watchKeyboard: true });\n   * ```\n   */\n  async presentModal<O = unknown>(\n    component: ModalOptions['component'],\n    componentProps?: ModalOptions['componentProps'],\n    options: KitModalPresentOptions = {},\n  ): Promise<O | undefined> {\n    const { watchKeyboard, ...modalOptions } = options;\n    const modal = await this.#modalCtrl.create({ component, componentProps, ...modalOptions });\n    await modal.present();\n    const handle = watchKeyboard ? await watchModalKeyboard(modal) : null;\n    const { data } = await modal.onDidDismiss<O>();\n    await handle?.remove();\n    return data;\n  }\n\n  /**\n   * Present a popover and resolve with the data passed to its dismissal.\n   *\n   * @typeParam O - type of the data returned when the popover is dismissed\n   * @param component - the component to render inside the popover\n   * @param componentProps - props to pass to the popover component\n   * @param options - additional popover options (for example `event` to anchor it, or `cssClass`)\n   * @returns the dismiss data, or `undefined` when the popover is dismissed without data\n   * @example\n   * ```ts\n   * const choice = await overlay.presentPopover<MenuChoice>(MenuPopover, { items }, { event });\n   * ```\n   */\n  async presentPopover<O = unknown>(\n    component: PopoverOptions['component'],\n    componentProps?: PopoverOptions['componentProps'],\n    options: Omit<PopoverOptions, 'component' | 'componentProps'> = {},\n  ): Promise<O | undefined> {\n    const popover = await this.#popoverCtrl.create({ component, componentProps, ...options });\n    await popover.present();\n    const { data } = await popover.onDidDismiss<O>();\n    return data;\n  }\n\n  /**\n   * Present a toast using kit defaults that the caller may override.\n   *\n   * @remarks\n   * Defaults to a bottom position, a 2000ms duration, a vertical swipe gesture, and a close button\n   * from the configured labels; any of these can be overridden via `options`. Presenting a toast\n   * also triggers light native haptic feedback as an intentional kit UX choice.\n   *\n   * Bottom is the fleet-wide default (top left the toast fighting the tab bar and the keyboard); an\n   * app that wants it elsewhere passes `position` / `positionAnchor` in `options`.\n   *\n   * @param options - Ionic toast options that override the kit defaults\n   * @returns the presented toast element\n   * @example\n   * ```ts\n   * await overlay.presentToast({ message: 'Copied to clipboard' });\n   * ```\n   */\n  async presentToast(options: ToastOptions): Promise<HTMLIonToastElement> {\n    void kitImpact();\n    const toast = await this.#toastCtrl.create({\n      position: 'bottom',\n      duration: 2000,\n      buttons: [this.#labels.close],\n      swipeGesture: 'vertical',\n      ...options,\n    });\n    await toast.present();\n    return toast;\n  }\n\n  /**\n   * Present a notification alert with a single \"close\" button and wait for it to be dismissed.\n   *\n   * @param options - alert content (header, message, optional sub-header)\n   * @returns a Promise that resolves once the alert has been dismissed\n   * @example\n   * ```ts\n   * await overlay.alertClose({ header: 'Done', message: 'Your changes were saved.' });\n   * ```\n   */\n  async alertClose(options: KitAlertCloseOptions): Promise<void> {\n    const alert = await this.#alertCtrl.create({\n      header: options.header,\n      subHeader: options.subHeader,\n      message: options.message,\n      buttons: [this.#labels.close],\n    });\n    await alert.present();\n    await alert.onWillDismiss();\n  }\n\n  /**\n   * Present a confirmation alert with cancel and OK buttons.\n   *\n   * @param options - alert content plus the OK button text via {@link KitAlertConfirmOptions.okText}\n   * @returns `true` when the user presses OK, `false` otherwise (cancel or backdrop dismissal)\n   * @example\n   * ```ts\n   * const ok = await overlay.alertConfirm({\n   *   header: 'Delete item?',\n   *   message: 'This cannot be undone.',\n   *   okText: 'Delete',\n   * });\n   * if (ok) {\n   *   await remove();\n   * }\n   * ```\n   */\n  async alertConfirm(options: KitAlertConfirmOptions): Promise<boolean> {\n    const alert = await this.#alertCtrl.create({\n      header: options.header,\n      subHeader: options.subHeader,\n      message: options.message,\n      buttons: [\n        { text: this.#labels.cancel, role: 'cancel' },\n        { text: options.okText, role: 'confirm' },\n      ],\n    });\n    await alert.present();\n    const { role } = await alert.onWillDismiss();\n    return role === 'confirm';\n  }\n}\n","import { inject, Injectable } from '@angular/core';\nimport { AlertController } from '@ionic/angular/standalone';\nimport { KIT_OVERLAY_CONFIG } from './overlay-config';\n\n/**\n * Content for {@link KitReloadAlertController.present}.\n */\nexport interface KitReloadAlertOptions {\n  /** Alert header text. */\n  header: string;\n  /** Alert body message. */\n  message: string;\n  /**\n   * Text for the reload (confirm) button, e.g. \"リフレッシュ\".\n   *\n   * @remarks\n   * Action-specific, so it is supplied by the caller rather than taken from the shared labels.\n   * The cancel button uses the configured {@link KitLabels.cancel}.\n   */\n  okText: string;\n}\n\n/**\n * The fleet's canonical \"network error → offer to reload\" alert, as a stateful controller.\n *\n * @remarks\n * Consolidates the good-UX variant that had drifted across the fleet into one behavior:\n *\n * - **De-dup** — never stacks; a second {@link present} while an alert is already shown is a no-op.\n * - **Backdrop lock** — `backdropDismiss: false`, so a critical network error can't be dismissed by\n *   an accidental backdrop tap; the user consciously chooses cancel or reload.\n * - **Auto-dismiss on reconnect** — the presented alert is tracked, so {@link dismiss} (called from a\n *   later successful response) clears a now-stale error alert instead of leaving it on screen.\n * - **Reload on confirm** — the confirm button calls `location.reload()`.\n *\n * All user-facing text is supplied by the caller so the kit stays free of any hardcoded i18n; the\n * cancel button reuses {@link KitOverlayConfig.labels}. Because it performs navigation\n * (`location.reload()`) and holds state, it is a dedicated controller rather than part of\n * {@link KitOverlayController}, which stays free of navigation policy.\n *\n * @example\n * ```ts\n * // In an HTTP interceptor:\n * const reload = inject(KitReloadAlertController);\n * // ...on a network-class error while connected:\n * await reload.present({ header: 'ネットワークエラー', message: `…（${status}）`, okText: 'リフレッシュ' });\n * // ...on any later successful response:\n * await reload.dismiss();\n * ```\n */\n@Injectable({\n  providedIn: 'root',\n})\nexport class KitReloadAlertController {\n  readonly #alertCtrl = inject(AlertController);\n  readonly #labels = inject(KIT_OVERLAY_CONFIG).labels;\n  #alert: HTMLIonAlertElement | null = null;\n\n  /**\n   * Present the reload alert, unless one is already on screen.\n   *\n   * @param options - alert content plus the reload-button text\n   * @returns a Promise that resolves once the alert has been presented (or immediately if suppressed)\n   */\n  async present(options: KitReloadAlertOptions): Promise<void> {\n    // この controller 経由でも直書き ion-alert でも、多重表示しない。\n    if (this.#alert || document.querySelector('ion-alert')) {\n      return;\n    }\n    const alert = await this.#alertCtrl.create({\n      header: options.header,\n      message: options.message,\n      backdropDismiss: false,\n      buttons: [\n        { text: this.#labels.cancel, role: 'cancel' },\n        {\n          text: options.okText,\n          handler: () => {\n            location.reload();\n          },\n        },\n      ],\n    });\n    this.#alert = alert;\n    void alert.onDidDismiss().then(() => {\n      // 別の present で置き換わっていない限り、追跡を解除する。\n      if (this.#alert === alert) {\n        this.#alert = null;\n      }\n    });\n    await alert.present();\n  }\n\n  /**\n   * Dismiss the tracked reload alert if one is showing.\n   *\n   * @remarks\n   * Typically called from a later successful response so a stale \"network error\" alert clears once\n   * connectivity is restored. A no-op when nothing is showing.\n   *\n   * @returns a Promise that resolves once the alert has been dismissed (or immediately if none)\n   */\n  async dismiss(): Promise<void> {\n    const alert = this.#alert;\n    this.#alert = null;\n    await alert?.dismiss();\n  }\n}\n","import type { AlertController } from '@ionic/angular/standalone';\n\n/**\n * Content for {@link kitPresentAuthFailedAlert}.\n */\nexport interface KitAuthFailedAlertOptions {\n  /** Alert header, e.g. \"ログインできませんでした\". */\n  header: string;\n  /** Optional sub-header; typically the short server error code/name. */\n  subHeader?: string;\n  /** Alert body message; typically the server-provided detail. */\n  message: string;\n  /** Text for the single close button, e.g. \"閉じる\". */\n  closeText: string;\n}\n\n/**\n * Present the fleet's canonical \"sign-in / token exchange failed\" alert.\n *\n * @remarks\n * Folds together the alert every token-exchange app duplicated verbatim when a startup re-login\n * fails: an informative alert (header + optional server error as sub-header + detail message) with a\n * single close button that reloads the app (`location.reload()`) so the user restarts cleanly. The\n * caller is still responsible for signing the user out around this call.\n *\n * All user-facing text is supplied by the caller so the kit stays free of any hardcoded i18n. Kept\n * as a standalone helper (taking the `AlertController`) rather than a method on\n * {@link KitOverlayController}, which holds no navigation policy such as `location.reload()`.\n *\n * @param alertCtrl - Ionic's `AlertController`\n * @param options - alert content plus the close-button text\n * @returns a Promise that resolves once the alert has been presented\n * @example\n * ```ts\n * onAuthorized: async () => {\n *   const logged = await auth.tokenLogin().catch(async (e) => {\n *     await kitPresentAuthFailedAlert(alertCtrl, {\n *       header: 'ログインできませんでした',\n *       subHeader: e.error.error,\n *       message: e.error.detail,\n *       closeText: '閉じる',\n *     });\n *     await auth.signOut();\n *     return undefined;\n *   });\n *   // ...\n * };\n * ```\n */\nexport const kitPresentAuthFailedAlert = async (\n  alertCtrl: AlertController,\n  options: KitAuthFailedAlertOptions,\n): Promise<void> => {\n  const alert = await alertCtrl.create({\n    header: options.header,\n    subHeader: options.subHeader,\n    message: options.message,\n    buttons: [\n      {\n        text: options.closeText,\n        role: 'cancel',\n        handler: () => {\n          location.reload();\n        },\n      },\n    ],\n  });\n  await alert.present();\n};\n","import type { OnInit } from '@angular/core';\nimport { Directive, ElementRef, inject } from '@angular/core';\nimport { Capacitor } from '@capacitor/core';\n\n/**\n * Work around iOS `ion-input` autofill values not propagating to the Angular form model.\n *\n * On iOS, when the browser autofills an `ion-input` (for example a saved password), the value\n * is written to the underlying native `<input>` element but the corresponding `change` event is\n * not forwarded to the host `ion-input`, so the Angular form control (and `ngModel`) never sees\n * the autofilled value. This directive listens for the first `change` event on the inner input\n * element and mirrors its value back onto the host element, restoring two-way binding.\n *\n * Apply it to any `ion-input` that participates in a form and may be autofilled by attaching the\n * `rdlaboAutofill` attribute.\n *\n * @remarks\n * The directive is a no-op on every platform other than iOS, where the value already propagates\n * correctly. A short timeout is used because `ion-input` creates its inner `<input>` element\n * asynchronously after the host element is initialized.\n *\n * @example\n * ```html\n * <ion-input rdlaboAutofill type=\"password\" [(ngModel)]=\"password\"></ion-input>\n * ```\n */\n@Directive({\n  selector: '[rdlaboAutofill]',\n  standalone: true,\n})\nexport class KitAutofillDirective implements OnInit {\n  readonly #el = inject(ElementRef);\n\n  constructor() {}\n\n  /**\n   * Register the iOS autofill workaround once the directive is initialized.\n   *\n   * Returns immediately on non-iOS platforms. On iOS, after a short delay it attaches a one-shot,\n   * passive `change` listener to the inner `<input>` element that `ion-input` renders, copying the\n   * autofilled value back onto the host element so the Angular form model stays in sync. Any error\n   * while locating the inner input (for example if the element is not yet present) is swallowed.\n   *\n   * @returns Nothing.\n   */\n  ngOnInit(): void {\n    if (Capacitor.getPlatform() !== 'ios') {\n      return;\n    }\n    setTimeout(() => {\n      try {\n        this.#el.nativeElement.children[0].addEventListener(\n          'change',\n          (e: Event) => {\n            this.#el.nativeElement.value = (e.target as HTMLInputElement).value;\n          },\n          {\n            capture: false,\n            once: true,\n            passive: true,\n          },\n        );\n      } catch {\n        /* empty */\n      }\n    }, 100); // Need some time for the ion-input to create the input element\n  }\n}\n","import type { ElementRef } from '@angular/core';\nimport { DOCUMENT, inject, Injectable } from '@angular/core';\nimport { Platform } from '@ionic/angular/standalone';\nimport type { PluginListenerHandle } from '@capacitor/core';\nimport { Keyboard } from '@capacitor/keyboard';\n\n/**\n * How {@link KitKeyboardController.init} adjusts the target element when the native keyboard appears.\n *\n * - `transform` — CSS `translateY(-keyboardHeight + safeAreaBottom)` for a smooth iOS animation\n *   (typical for an `ion-footer`).\n * - `offset` — set the `--offset-bottom` custom property to the negative keyboard height.\n * - `keyboard-offset` — set the `--padding-bottom` custom property to the keyboard height.\n */\nexport type KitKeyboardAdjust = 'transform' | 'offset' | 'keyboard-offset';\n\n/**\n * Registers native keyboard listeners that reposition an element when the keyboard shows/hides.\n *\n * @remarks\n * A no-op on non-hybrid (web) platforms — `init` returns an empty handle list. On native it handles\n * iOS and Android differences (Android only toggles the `footer-toolbar-padding` class on an\n * `ion-footer` for the `transform` mode, working around an Ionic footer bug). The caller owns the\n * returned handles and must `remove()` them when the view is destroyed.\n *\n * @example\n * ```ts\n * export class ComposePage {\n *   readonly #keyboard = inject(KitKeyboardController);\n *   readonly #footer = viewChild.required<ElementRef>('footer');\n *   #handles: PluginListenerHandle[] = [];\n *\n *   async ngAfterViewInit() {\n *     this.#handles = await this.#keyboard.init(this.#footer(), 'transform');\n *   }\n *   ngOnDestroy() {\n *     this.#handles.forEach((h) => h.remove());\n *   }\n * }\n * ```\n */\n@Injectable({\n  providedIn: 'root',\n})\nexport class KitKeyboardController {\n  readonly #platform = inject(Platform);\n  readonly #document = inject(DOCUMENT);\n\n  /**\n   * Attach keyboard show/hide listeners that adjust `elementRef` per `type`.\n   *\n   * @param elementRef - The element to reposition (e.g. an `ion-footer`).\n   * @param type - The adjustment strategy; see {@link KitKeyboardAdjust}.\n   * @returns The registered listener handles (empty on non-native platforms).\n   */\n  async init(elementRef: ElementRef, type: KitKeyboardAdjust): Promise<PluginListenerHandle[]> {\n    if (!this.#platform.is('hybrid')) {\n      return [];\n    }\n    return [\n      await this.#keyboardWillShow(elementRef, type),\n      await this.#keyboardWillHide(elementRef, type),\n      await this.#keyboardDidShow(elementRef),\n      await this.#keyboardDidHide(elementRef),\n    ];\n  }\n\n  #keyboardWillShow(elementRef: ElementRef, type: KitKeyboardAdjust): Promise<PluginListenerHandle> {\n    return Keyboard.addListener('keyboardWillShow', (info) => {\n      if (this.#platform.is('android')) {\n        if (elementRef.nativeElement.tagName === 'ION-FOOTER' && type === 'transform') {\n          // https://github.com/ionic-team/ionic-framework/blob/main/core/src/components/footer/footer.tsx\n          elementRef.nativeElement.classList.remove('footer-toolbar-padding');\n        }\n        return;\n      }\n\n      elementRef.nativeElement.classList.add('show-keyboard');\n      const bodyStyleDeclaration = window.getComputedStyle(this.#document.querySelector('body') as Element);\n      const safeArea = parseInt(bodyStyleDeclaration.getPropertyValue('--ion-safe-area-bottom'), 10);\n\n      if (type === 'transform') {\n        elementRef.nativeElement.style.transition = 'transform 420ms';\n        elementRef.nativeElement.style.willChange = 'transform';\n        requestAnimationFrame(\n          () => (elementRef.nativeElement.style.transform = `translateY(${info.keyboardHeight * -1 + safeArea}px)`),\n        );\n      } else if (type === 'offset') {\n        requestAnimationFrame(() => {\n          const keyboardOffset = elementRef.nativeElement.style.getPropertyValue('--keyboard-offset');\n          if (!keyboardOffset || parseInt(keyboardOffset, 10) === 0) {\n            elementRef.nativeElement.style.setProperty('--offset-bottom', `${info.keyboardHeight * -1}px`);\n          }\n        });\n      } else {\n        requestAnimationFrame(() => {\n          const keyboardOffset = elementRef.nativeElement.style.getPropertyValue('--keyboard-offset');\n          if (!keyboardOffset || parseInt(keyboardOffset, 10) === 0) {\n            elementRef.nativeElement.style.setProperty('--padding-bottom', `${info.keyboardHeight}px`);\n          }\n        });\n      }\n    });\n  }\n\n  #keyboardWillHide(elementRef: ElementRef, type: KitKeyboardAdjust): Promise<PluginListenerHandle> {\n    return Keyboard.addListener('keyboardWillHide', () => {\n      if (this.#platform.is('android')) {\n        if (elementRef.nativeElement.tagName === 'ION-FOOTER' && type === 'transform') {\n          elementRef.nativeElement.classList.add('footer-toolbar-padding');\n        }\n        return;\n      }\n\n      elementRef.nativeElement.classList.remove('show-keyboard');\n\n      if (type === 'transform') {\n        elementRef.nativeElement.style.transition = 'transform 0ms';\n        elementRef.nativeElement.style.transform = `translateY(0px)`;\n        elementRef.nativeElement.style.willChange = 'transform';\n      } else if (type === 'offset') {\n        elementRef.nativeElement.style.setProperty('--offset-bottom', '0px');\n      } else {\n        elementRef.nativeElement.style.setProperty('--padding-bottom', '0px');\n      }\n    });\n  }\n\n  #keyboardDidShow(elementRef: ElementRef): Promise<PluginListenerHandle> {\n    return Keyboard.addListener('keyboardDidShow', () => {\n      elementRef.nativeElement.style.willChange = 'auto';\n    });\n  }\n\n  #keyboardDidHide(elementRef: ElementRef): Promise<PluginListenerHandle> {\n    return Keyboard.addListener('keyboardDidHide', () => {\n      elementRef.nativeElement.style.willChange = 'auto';\n    });\n  }\n}\n","import type { EnvironmentProviders } from '@angular/core';\nimport { inject, InjectionToken, makeEnvironmentProviders } from '@angular/core';\nimport type { CanActivateFn, RouterStateSnapshot, UrlTree } from '@angular/router';\nimport { Router } from '@angular/router';\nimport { NavController } from '@ionic/angular/standalone';\nimport type { Observable } from 'rxjs';\nimport { map, mergeMap } from 'rxjs/operators';\n\n/**\n * Discriminated set of authentication states the guards react to.\n *\n * @remarks\n * The application is responsible for emitting these values through {@link KitAuthConfig.authState}.\n * An application that does not use a value (for example email confirmation) simply never emits it.\n *\n * - `user` — fully authenticated and verified.\n * - `confirm` — awaiting email confirmation.\n * - `required` — not authenticated.\n * - `anonymous` — signed in anonymously; the user can still be guided toward full registration.\n */\nexport type KitAuthState = 'user' | 'confirm' | 'required' | 'anonymous';\n\n/**\n * Redirect targets (route paths) used by the guards when access is denied.\n *\n * @remarks\n * Every field is required and must be provided per application, because the guards have no\n * knowledge of the host application's route layout.\n */\nexport interface KitAuthRedirects {\n  /** Used by {@link kitRequiredUnauthorizedGuard}: where to navigate when the user is already authenticated (`user`). */\n  readonly whenAuthorized: string;\n  /** Used by {@link kitRequiredUnauthorizedGuard}: where to navigate when the user is awaiting email confirmation (`confirm`). */\n  readonly whenConfirming: string;\n  /** Used by {@link kitRequireConfirmingGuard}: where to navigate when the state is not `confirm`. */\n  readonly whenNotConfirming: string;\n  /** Used by {@link kitRequireAuthorizedGuard}: where to navigate when the state is not `user` and the fallback is not allowed. */\n  readonly whenUnauthorized: string;\n}\n\n/**\n * Configuration consumed by the authentication guards, injected through {@link provideKitAuth}.\n *\n * @remarks\n * `authState` and `redirects` are required. The `onAuthorized` / `onUnauthenticated` hooks are\n * optional and default to allowing the authenticated user through (`true`) and falling through to\n * the default redirect (`false`) respectively, so an app only supplies the ones with real logic.\n */\nexport interface KitAuthConfig {\n  /**\n   * Source of the current authentication state.\n   *\n   * @remarks\n   * Typically backed by the application's own auth service (for example `AuthService.isAuth()`).\n   *\n   * @returns A stream of {@link KitAuthState} values.\n   */\n  authState(): Observable<KitAuthState>;\n  /**\n   * Application-specific work that runs in {@link kitRequireAuthorizedGuard} after the state is confirmed to be `user`.\n   *\n   * @remarks\n   * Typical responsibilities include token login, permission checks, terms-of-service acceptance,\n   * or restoring a previously requested redirect. Optional; defaults to `true` (allow activation).\n   *\n   * @param state - The router state snapshot of the route being activated.\n   * @returns `true` to allow activation, or a `UrlTree` to perform a custom redirect.\n   */\n  onAuthorized?(state: RouterStateSnapshot): Promise<boolean | UrlTree>;\n  /**\n   * Fallback that runs in {@link kitRequireAuthorizedGuard} when the state is `required` (not authenticated).\n   *\n   * @remarks\n   * For example, attempt an anonymous sign-in and allow the route. Optional; defaults to `false`\n   * (fall through to the default `whenUnauthorized` redirect).\n   *\n   * @param state - The router state snapshot of the route being activated.\n   * @returns `true` to allow activation, a `UrlTree` for a custom redirect, or `false` to use the default redirect.\n   */\n  onUnauthenticated?(state: RouterStateSnapshot): Promise<boolean | UrlTree>;\n  /** Redirect targets used by the guards. */\n  redirects: KitAuthRedirects;\n}\n\n/**\n * Injection token that carries the {@link KitAuthConfig} to the authentication guards.\n */\nexport const KIT_AUTH_CONFIG = new InjectionToken<KitAuthConfig>('@rdlabo/ionic-angular-kit:auth');\n\n/**\n * Wire the authentication guard configuration into the application's dependency injection.\n *\n * @remarks\n * The factory runs inside an injection context, so it may call `inject()` (for example\n * `inject(AuthService)`) to build the configuration.\n *\n * @param configFactory - Factory that returns the {@link KitAuthConfig} for the application.\n * @returns Environment providers to add to the application bootstrap.\n *\n * @example\n * ```ts\n * provideKitAuth(() => {\n *   const auth = inject(AuthService);\n *   return {\n *     // onAuthorized / onUnauthenticated are optional (default: allow / fall through to redirect).\n *     authState: () => auth.isAuth(),\n *     redirects: {\n *       whenAuthorized: '/',\n *       whenConfirming: '/auth/confirm',\n *       whenNotConfirming: '/auth/signin',\n *       whenUnauthorized: 'auth',\n *     },\n *   };\n * });\n * ```\n */\nexport const provideKitAuth = (configFactory: () => KitAuthConfig): EnvironmentProviders =>\n  makeEnvironmentProviders([{ provide: KIT_AUTH_CONFIG, useFactory: configFactory }]);\n\n/**\n * Guard that requires the user to be unauthenticated (for example sign-in or sign-up pages).\n *\n * @remarks\n * Allows the `required` and `anonymous` states (an anonymous user is permitted to proceed to a\n * registration page). An authenticated user (`user`) is sent to `whenAuthorized`, and a user\n * awaiting confirmation (`confirm`) is sent to `whenConfirming`.\n *\n * @returns A stream emitting `true` to allow activation, or `false` after triggering a redirect.\n *\n * @example\n * ```ts\n * const routes: Routes = [{ path: 'signin', component: SigninPage, canActivate: [kitRequiredUnauthorizedGuard] }];\n * ```\n */\nexport const kitRequiredUnauthorizedGuard: CanActivateFn = () => {\n  const { authState, redirects } = inject(KIT_AUTH_CONFIG);\n  const router = inject(Router);\n  const navCtrl = inject(NavController);\n\n  return authState().pipe(\n    map((data) => {\n      if (data === 'user') {\n        navCtrl.setDirection('root');\n        router.navigate([redirects.whenAuthorized]);\n        return false;\n      } else if (data === 'confirm') {\n        router.navigate([redirects.whenConfirming]);\n        return false;\n      }\n      // 'required' | 'anonymous'\n      return true;\n    }),\n  );\n};\n\n/**\n * Guard that requires the user to be awaiting email confirmation (`confirm`).\n *\n * @remarks\n * Any other state triggers a redirect: an `anonymous` user is sent to the authenticated area\n * (`whenAuthorized`), and every remaining state is sent to `whenNotConfirming`.\n *\n * @returns A stream emitting `true` to allow activation, or `false` after triggering a redirect.\n *\n * @example\n * ```ts\n * const routes: Routes = [{ path: 'confirm', component: ConfirmPage, canActivate: [kitRequireConfirmingGuard] }];\n * ```\n */\nexport const kitRequireConfirmingGuard: CanActivateFn = () => {\n  const { authState, redirects } = inject(KIT_AUTH_CONFIG);\n  const router = inject(Router);\n  const navCtrl = inject(NavController);\n\n  return authState().pipe(\n    map((data) => {\n      if (data === 'confirm') {\n        return true;\n      }\n      navCtrl.setDirection('root');\n      router.navigate([data === 'anonymous' ? redirects.whenAuthorized : redirects.whenNotConfirming]);\n      return false;\n    }),\n  );\n};\n\n/**\n * Guard that requires the user to be fully authenticated (`user`).\n *\n * @remarks\n * - `user` — runs {@link KitAuthConfig.onAuthorized} (token login, permission checks, and so on).\n * - `anonymous` — allowed as-is, for applications that permit anonymous browsing.\n * - `required` / `confirm` — runs {@link KitAuthConfig.onUnauthenticated}; if it resolves to `false`,\n *   the user is redirected to `whenUnauthorized`.\n *\n * @param _route - The activated route snapshot (unused).\n * @param state - The router state snapshot, forwarded to the configuration hooks.\n * @returns A stream emitting the activation result: `true`, a `UrlTree`, or `false` after a redirect.\n *\n * @example\n * ```ts\n * const routes: Routes = [{ path: 'home', component: HomePage, canActivate: [kitRequireAuthorizedGuard] }];\n * ```\n */\nexport const kitRequireAuthorizedGuard: CanActivateFn = (_route, state) => {\n  const { authState, onAuthorized, onUnauthenticated, redirects } = inject(KIT_AUTH_CONFIG);\n  const router = inject(Router);\n  const navCtrl = inject(NavController);\n\n  return authState().pipe(\n    mergeMap(async (data) => {\n      if (data === 'user') {\n        // 既定は「許可」。tokenLogin / 権限確認等が必要なアプリだけ onAuthorized を渡す。\n        return onAuthorized ? onAuthorized(state) : true;\n      }\n      if (data === 'anonymous') {\n        return true;\n      }\n      // 既定は false（whenUnauthorized へ）。匿名ログイン等のフォールバックが要るアプリだけ渡す。\n      const fallback = onUnauthenticated ? await onUnauthenticated(state) : false;\n      if (fallback !== false) {\n        return fallback;\n      }\n      navCtrl.setDirection('root');\n      router.navigate([redirects.whenUnauthorized]);\n      return false;\n    }),\n  );\n};\n","import type { EnvironmentProviders } from '@angular/core';\nimport { inject, InjectionToken, makeEnvironmentProviders } from '@angular/core';\nimport type { HttpErrorResponse, HttpEvent, HttpInterceptorFn, HttpRequest } from '@angular/common/http';\nimport { HttpResponse } from '@angular/common/http';\nimport { Network } from '@capacitor/network';\nimport type { Observable } from 'rxjs';\nimport { from, retry, throwError, timer } from 'rxjs';\nimport { catchError, mergeMap, tap } from 'rxjs/operators';\n\n/**\n * HTTP status codes that must never be retried. `401` is handled separately and thrown immediately.\n *\n * @internal\n */\nconst NON_RETRYABLE_STATUSES = [400, 403, 404, 418, 500, 502];\n\n/**\n * Configuration that customizes the behavior of {@link kitAuthInterceptor}, injected through {@link provideKitHttp}.\n *\n * @remarks\n * The interceptor fixes the retry policy (up to 2 retries with a linearly increasing backoff, plus immediate\n * throw on `401` and on every {@link NON_RETRYABLE_STATUSES | non-retryable status}) and the overall\n * control flow. Only the hooks below are application-specific.\n *\n * Only {@link KitHttpConfig.getAuthHeaders} is required — it has no safe default. Every other hook is\n * optional and defaults to a no-op (or `{}` / `false` / `null` as appropriate), so an app configures\n * only the behavior that actually differs from the canonical baseline.\n */\nexport interface KitHttpConfig {\n  /**\n   * Produce authentication and metadata headers for the outgoing request.\n   *\n   * @param request - The outgoing request about to be sent.\n   * @returns A map of header names to values, resolved asynchronously.\n   */\n  getAuthHeaders(request: HttpRequest<unknown>): Promise<Record<string, string>>;\n  /**\n   * Produce additional headers for the outgoing request.\n   *\n   * @remarks\n   * Optional; defaults to adding no extra headers.\n   *\n   * @param request - The outgoing request about to be sent.\n   * @returns A map of header names to values; return `{}` when none are needed.\n   */\n  buildExtraHeaders?(request: HttpRequest<unknown>): Record<string, string>;\n  /**\n   * Called for every successful response that completed an actual network round trip.\n   *\n   * @remarks\n   * Responses synthesized by {@link KitHttpConfig.offlineFallback} are produced after `catchError`\n   * and therefore never reach this hook, so it observes genuine successes only. A typical use is to\n   * reset an \"offline\" flag once connectivity is restored. Optional; defaults to a no-op.\n   *\n   * @param event - The successful `HttpResponse`.\n   */\n  onResponse?(event: HttpResponse<unknown>): void;\n  /**\n   * Decide whether to pass the request straight through, skipping auth, retry, and error handling.\n   *\n   * @remarks\n   * Useful for external URLs such as S3 or a CDN. Optional; defaults to `false` (never bypass).\n   *\n   * @param request - The outgoing request.\n   * @returns `true` to bypass the interceptor pipeline.\n   */\n  bypass?(request: HttpRequest<unknown>): boolean;\n  /**\n   * Provide an offline short-circuit when a request fails.\n   *\n   * @remarks\n   * Returning a non-null observable replaces the error with that response (for example a queued\n   * offline result). Optional; defaults to `null` (no fallback, normal error handling proceeds).\n   *\n   * @param request - The request that failed (after headers were applied).\n   * @param error - The error response that triggered the fallback.\n   * @returns A replacement event stream, or `null` for no fallback.\n   */\n  offlineFallback?(request: HttpRequest<unknown>, error: HttpErrorResponse): Observable<HttpEvent<unknown>> | null;\n  /**\n   * Side effect to run on a `401` response (for example an expired token).\n   *\n   * @remarks\n   * Optional; defaults to a no-op.\n   *\n   * @param request - The request that received the `401`.\n   */\n  onUnauthorized?(request: HttpRequest<unknown>): void;\n  /**\n   * Side effect to run on a `403` response (a permission error).\n   *\n   * @remarks\n   * Optional; defaults to a no-op.\n   *\n   * @param request - The request that received the `403`.\n   */\n  onForbidden?(request: HttpRequest<unknown>): void;\n  /**\n   * UX hook for network-originated errors while the device is connected.\n   *\n   * @remarks\n   * Optional; defaults to a no-op. The kit ships {@link KitReloadAlertController} as the fleet's\n   * canonical implementation of this hook (with auto-dismiss on reconnect via `onResponse`).\n   *\n   * @param status - The HTTP status code, or a string descriptor for non-HTTP failures.\n   * @returns Optionally a promise to await before continuing.\n   */\n  onNetworkError?(status: number | string): Promise<void> | void;\n  /**\n   * UX hook for `400` / `500` responses that carry a server-provided message.\n   *\n   * @remarks\n   * Optional; defaults to a no-op.\n   *\n   * @param message - The message extracted from the error body.\n   */\n  onServerError?(message: string): void;\n}\n\n/**\n * Injection token that carries the {@link KitHttpConfig} to {@link kitAuthInterceptor}.\n */\nexport const KIT_HTTP_CONFIG = new InjectionToken<KitHttpConfig>('@rdlabo/ionic-angular-kit:http');\n\n/**\n * Wire the {@link kitAuthInterceptor} configuration into the application's dependency injection.\n *\n * @remarks\n * Register the interceptor itself separately via `provideHttpClient(withInterceptors([kitAuthInterceptor]))`.\n * The factory runs inside an injection context, so it may call `inject()`.\n *\n * @param configFactory - Factory that returns the {@link KitHttpConfig} for the application.\n * @returns Environment providers to add to the application bootstrap.\n *\n * @example\n * ```ts\n * bootstrapApplication(AppComponent, {\n *   providers: [\n *     provideHttpClient(withInterceptors([kitAuthInterceptor])),\n *     provideKitHttp(() => {\n *       const auth = inject(AuthService);\n *       const reload = inject(KitReloadAlertController);\n *       return {\n *         // Only getAuthHeaders is required; every other hook is optional and defaults to a no-op.\n *         getAuthHeaders: async () => ({ Authorization: `Bearer ${await auth.token()}` }),\n *         onUnauthorized: () => auth.signOut(),\n *         onNetworkError: (status) =>\n *           reload.present({ header: 'Network error', message: `Reload? (${status})`, okText: 'Reload' }),\n *         onResponse: () => void reload.dismiss(),\n *       };\n *     }),\n *   ],\n * });\n * ```\n */\nexport const provideKitHttp = (configFactory: () => KitHttpConfig): EnvironmentProviders =>\n  makeEnvironmentProviders([{ provide: KIT_HTTP_CONFIG, useFactory: configFactory }]);\n\n/**\n * Canonical functional HTTP interceptor that applies authentication, retries, and error handling.\n *\n * @remarks\n * Behavior, driven by the injected {@link KitHttpConfig}:\n *\n * 1. Requests for which `bypass` returns `true` are forwarded untouched.\n * 2. Otherwise the headers from `getAuthHeaders` and `buildExtraHeaders` are merged onto a cloned request.\n * 3. Failed requests are retried up to 2 times with a linearly increasing backoff of `500ms * (retryCount + 5)`,\n *    except that `401` and any {@link NON_RETRYABLE_STATUSES | non-retryable status}\n *    (`400`, `403`, `404`, `418`, `500`, `502`) are thrown immediately without retrying.\n * 4. On error, `offlineFallback` is consulted first; otherwise `401` calls `onUnauthorized`, `403`\n *    calls `onForbidden`, network-class failures (anything other than `400`/`500`) call\n *    `onNetworkError` when the device is connected, and `400`/`500` responses carrying a body\n *    message call `onServerError`.\n *\n * @param request - The outgoing request.\n * @param next - The next handler in the interceptor chain.\n * @returns A stream of HTTP events for the (possibly modified, retried, or replaced) request.\n *\n * @example\n * ```ts\n * provideHttpClient(withInterceptors([kitAuthInterceptor]));\n * ```\n */\nexport const kitAuthInterceptor: HttpInterceptorFn = (request, next) => {\n  const config = inject(KIT_HTTP_CONFIG);\n\n  if (config.bypass?.(request)) {\n    return next(request);\n  }\n\n  return from(config.getAuthHeaders(request)).pipe(\n    mergeMap((authHeaders) => {\n      const req = request.clone({ setHeaders: { ...authHeaders, ...config.buildExtraHeaders?.(request) } });\n\n      return next(req).pipe(\n        retry({\n          count: 2,\n          delay: (e: HttpErrorResponse, retryCount) => {\n            if (e.status === 401) {\n              return throwError(() => e);\n            }\n            if (NON_RETRYABLE_STATUSES.includes(e.status)) {\n              return throwError(() => e);\n            }\n            return timer((retryCount + 5) * 500);\n          },\n        }),\n        tap((event) => {\n          if (event instanceof HttpResponse) {\n            config.onResponse?.(event);\n          }\n        }),\n        catchError((e: HttpErrorResponse) => {\n          const fallback = config.offlineFallback?.(req, e);\n          if (fallback) {\n            return fallback;\n          }\n          if (e.status === 401) {\n            config.onUnauthorized?.(req);\n          } else if (e.status === 403) {\n            config.onForbidden?.(req);\n          } else if (![400, 500].includes(e.status)) {\n            void Network.getStatus().then((status) => {\n              if (status.connected) {\n                config.onNetworkError?.(e.status);\n              }\n            });\n          } else if (e.error?.message) {\n            config.onServerError?.(e.error.message);\n          }\n          return throwError(() => e);\n        }),\n      );\n    }),\n  );\n};\n","/**\n * Merge a newly fetched page of items into an existing list by id, keeping the result sorted.\n *\n * Items are merged by the numeric `key` field. On a duplicate `key` the item from `arrayNew` wins\n * and replaces the one in `arrayOld`. Old items whose `key` falls *inside* the window spanned by\n * `arrayNew` (between its first and last `key`) are dropped, since the freshly fetched page is the\n * authoritative copy of that window; old items *outside* the window are kept. The merged items are\n * finally sorted by `key`, ascending or descending according to `order`.\n *\n * The algorithm is:\n * 1. If both inputs are empty, return an empty array.\n * 2. Read the first (`lead`) and last (`last`) `key` values of `arrayNew` as the bounds of the\n *    page's window. Keep the old items whose `key` lies *outside* that window (at or beyond the\n *    extremes) and drop those strictly inside it, handling both a high-to-low page (`lead > last`)\n *    and a low-to-high page (`lead < last`). A single-value page (`lead === last`) keeps all old items.\n * 3. Remove old items whose `key` already exists in `arrayNew` (new wins on duplicates).\n * 4. Concatenate `arrayNew` with the surviving old items and sort by `key` in the requested\n *    direction.\n *\n * @remarks\n * Designed for infinite-scroll / paginated list merging, where each fetched page may overlap the\n * previously held items and the server returns a contiguous, ordered window of records. The `key`\n * field is treated as a number for range comparison and sorting.\n *\n * @typeParam T - Element type of both arrays. Its `key` property must be a numeric value.\n * @param arrayOld - The previously accumulated list. May be empty or nullish-safe (empty when falsy).\n * @param arrayNew - The newly fetched page of items; its `key` range defines the window that its own\n *   items replace, and its items take precedence on duplicates.\n * @param key - The property of `T` used as the unique, numeric id for matching, range filtering, and sorting.\n * @param order - Sort direction by `key`: `'ASC'` for ascending or `'DESC'` for descending. Defaults to `'DESC'`.\n * @param secondaryKey - Optional second property for extra de-duplication. When provided, any\n *   surviving old item whose `secondaryKey` value matches that of *any* new item is dropped before\n *   the `key` merge. Useful when a record keeps a stable `key` but its secondary identity changes\n *   between pages (e.g. items keyed by `id` but also grouped by `parentId`). Omit to skip this step.\n * @returns A new array containing `arrayNew` merged with the out-of-window, non-duplicate old items, sorted by `key`.\n * @example\n * ```ts\n * interface Post {\n *   id: number;\n *   title: string;\n * }\n *\n * const loaded: Post[] = [\n *   { id: 30, title: 'c' },\n *   { id: 20, title: 'b' },\n *   { id: 10, title: 'a' },\n * ];\n * const nextPage: Post[] = [\n *   { id: 20, title: 'b (updated)' },\n *   { id: 15, title: 'a.5' },\n * ];\n *\n * // Descending merge: id 30 lies above the new page's [15, 20] window so it is kept; id 20 is\n * // inside the window and is replaced by the new value; id 10 lies below the window and is kept.\n * const merged = arrayConcatById(loaded, nextPage, 'id', 'DESC');\n * // => [{ id: 30, title: 'c' }, { id: 20, title: 'b (updated)' }, { id: 15, title: 'a.5' }, { id: 10, title: 'a' }]\n * ```\n */\nexport const arrayConcatById = <T>(\n  arrayOld: T[],\n  arrayNew: T[],\n  key: keyof T,\n  order: 'ASC' | 'DESC' = 'DESC',\n  secondaryKey?: keyof T,\n): T[] => {\n  if (!arrayNew.length && !arrayOld.length) {\n    return [];\n  }\n  const lead = arrayNew[0][key] as number;\n  const last = arrayNew[arrayNew.length - 1][key] as number;\n\n  const filteredOld = (arrayOld || []).filter((vol) => {\n    const value = vol[key] as number;\n    return (lead > last && (value >= lead || value <= last)) || (lead < last && (value <= lead || value >= last)) || lead === last;\n  });\n\n  const secondaryFilteredOld = secondaryKey\n    ? filteredOld.filter((vol) => !arrayNew.some((element) => element[secondaryKey] === vol[secondaryKey]))\n    : filteredOld;\n\n  const oldData = secondaryFilteredOld.filter((vol) => !arrayNew.some((element) => element[key] === vol[key]));\n  const data = arrayNew.concat(oldData);\n\n  const direction = order === 'ASC' ? 1 : -1;\n  return data.sort((a, b) => {\n    const x = a[key] as number;\n    const y = b[key] as number;\n    if (x > y) {\n      return direction;\n    }\n    if (x < y) {\n      return direction * -1;\n    }\n    return 0;\n  });\n};\n","/**\n * Order-independent deep equality check.\n *\n * @remarks\n * Returns `true` when `a` and `b` serialize to the same value after their (nested) object entries are\n * sorted by key, so property order does not affect the result. Intended for cheap \"did this state\n * object change?\" comparisons.\n *\n * Caveats of the JSON-serialization approach: values that JSON drops or coerces (`undefined`,\n * functions, `NaN`, `Date`, `Map`/`Set`) are compared by their serialized form, and array element\n * order is treated as significant (arrays are not reordered in a meaningful way). Use a structural\n * deep-equal library when those cases matter.\n *\n * @param a - First object.\n * @param b - Second object.\n * @returns `true` when the two objects are deeply equal ignoring key order.\n * @example\n * ```ts\n * objectEqual({ a: 1, b: 2 }, { b: 2, a: 1 }); // => true\n * objectEqual({ a: 1 }, { a: 2 });             // => false\n * ```\n */\nexport const objectEqual = (a: object, b: object): boolean => {\n  if (Object.is(a, b)) {\n    return true;\n  }\n  const sortDeep = (obj: unknown): unknown => {\n    if (typeof obj !== 'object' || !obj) {\n      return undefined;\n    }\n    return Object.entries(obj)\n      .sort()\n      .map(([entryKey, value]) => [entryKey, typeof value === 'object' ? sortDeep(value) : value]);\n  };\n  return JSON.stringify(sortDeep(a)) === JSON.stringify(sortDeep(b));\n};\n","/**\n * Disable the button that triggered an event while an async operation runs, re-enabling it after.\n *\n * @remarks\n * Prevents the common double-submit / double-tap bug: the `event.target` button is disabled, the\n * work is awaited, and the button is re-enabled — even if the work rejects (the rejection is\n * swallowed here so the button always recovers; handle errors inside `work` if you need to react).\n *\n * @param event - The DOM event whose `target` is the button to disable (e.g. a click event).\n * @param work - The async operation to run while the button is disabled.\n * @returns A Promise that resolves once the work has settled and the button has been re-enabled.\n * @example\n * ```ts\n * async submit(event: Event): Promise<void> {\n *   await disableHandler(event, this.save());\n * }\n * ```\n */\nexport const disableHandler = async (event: Event, work: Promise<void | boolean>): Promise<void> => {\n  const target = event.target as HTMLButtonElement;\n  target.disabled = true;\n  await work.catch((): undefined => undefined);\n  target.disabled = false;\n};\n","/*\n * Public API Surface of @rdlabo/ionic-angular-kit\n */\n\n// Storage: typed wrapper around the platform key/value store.\nexport * from './lib/storage/kit-storage.service';\n\n// Overlay: wrapper around the Ionic Modal / Toast / Alert controllers.\nexport * from './lib/overlay/overlay-config';\nexport * from './lib/overlay/kit-overlay.controller';\nexport * from './lib/overlay/kit-reload-alert.controller';\nexport * from './lib/overlay/kit-auth-failed-alert';\n\n// Directives.\nexport * from './lib/directives/autofill.directive';\n\n// Keyboard: native keyboard reposition listeners.\nexport * from './lib/keyboard/kit-keyboard.controller';\n\n// Auth: functional route guards.\nexport * from './lib/auth/auth-guards';\n\n// HTTP: functional interceptor.\nexport * from './lib/http/kit-http.interceptor';\n\n// Utils: framework-agnostic pure helpers.\nexport * from './lib/utils/haptics';\nexport * from './lib/utils/array';\nexport * from './lib/utils/object';\nexport * from './lib/utils/dom';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;;;;;;;;;AAGA;;;;;;;;;;;;;;;;;;;;;AAqBG;MAIU,iBAAiB,CAAA;;IAEnB,MAAM,GAAqB,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE;AAE5D;;;;;;;;;;;AAWG;AACH,IAAA,MAAM,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAA;AAChC,QAAA,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;IAC3C;AAEA;;;;;;;;;;AAUG;IACH,MAAM,GAAG,CAAI,GAAW,EAAA;AACtB,QAAA,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;IACrD;AAEA;;;;;AAKG;IACH,MAAM,MAAM,CAAC,GAAW,EAAA;QACtB,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;IACvC;AAEA;;;;AAIG;AACH,IAAA,MAAM,KAAK,GAAA;QACT,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE;IACnC;AAEA;;;;AAIG;AACH,IAAA,MAAM,IAAI,GAAA;QACR,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE;IACnC;+GA7DW,iBAAiB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAAjB,IAAA,SAAA,IAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,SAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,iBAAiB,cAFhB,MAAM,EAAA,CAAA,CAAA;;4FAEP,iBAAiB,EAAA,UAAA,EAAA,CAAA;kBAH7B,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACV,oBAAA,UAAU,EAAE,MAAM;AACnB,iBAAA;;;ACED;;;;;AAKG;MACU,kBAAkB,GAAG,IAAI,cAAc,CAAmB,mCAAmC;AAE1G;;;;;;;;;;;;;AAaG;MACU,iBAAiB,GAAG,CAAC,MAAwB,KACxD,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;;ACjD9E;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACI,MAAM,SAAS,GAAG,OAAO,KAAA,GAAqB,WAAW,CAAC,KAAK,KAAmB;AACvF,IAAA,IAAI,SAAS,CAAC,gBAAgB,EAAE,EAAE;QAChC,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjC;AACF;;ACuBA;;;;;;;AAOG;AACH,MAAM,kBAAkB,GAAG,OAAO,KAA0B,KAAmC;AAC7F,IAAA,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,EAAE;QACjC,OAAO,EAAE,MAAM,EAAE,YAAY,SAAS,EAAE;IAC1C;AACA,IAAA,OAAO,QAAQ,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;AACrF,CAAC;AAED;;;;;;;;;;;;;;;;;;;AAmBG;MAIU,oBAAoB,CAAA;AACtB,IAAA,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC;AACpC,IAAA,YAAY,GAAG,MAAM,CAAC,iBAAiB,CAAC;AACxC,IAAA,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC;AACpC,IAAA,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC;AACpC,IAAA,OAAO,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC,MAAM;AAEpD;;;;;;;;;;;;AAYG;IACH,MAAM,YAAY,CAChB,SAAoC,EACpC,cAA+C,EAC/C,UAAkC,EAAE,EAAA;QAEpC,MAAM,EAAE,aAAa,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO;AAClD,QAAA,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,YAAY,EAAE,CAAC;AAC1F,QAAA,MAAM,KAAK,CAAC,OAAO,EAAE;AACrB,QAAA,MAAM,MAAM,GAAG,aAAa,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,GAAG,IAAI;QACrE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,YAAY,EAAK;AAC9C,QAAA,MAAM,MAAM,EAAE,MAAM,EAAE;AACtB,QAAA,OAAO,IAAI;IACb;AAEA;;;;;;;;;;;;AAYG;IACH,MAAM,cAAc,CAClB,SAAsC,EACtC,cAAiD,EACjD,UAAgE,EAAE,EAAA;AAElE,QAAA,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;AACzF,QAAA,MAAM,OAAO,CAAC,OAAO,EAAE;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,YAAY,EAAK;AAChD,QAAA,OAAO,IAAI;IACb;AAEA;;;;;;;;;;;;;;;;;AAiBG;IACH,MAAM,YAAY,CAAC,OAAqB,EAAA;QACtC,KAAK,SAAS,EAAE;QAChB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;AACzC,YAAA,QAAQ,EAAE,QAAQ;AAClB,YAAA,QAAQ,EAAE,IAAI;AACd,YAAA,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;AAC7B,YAAA,YAAY,EAAE,UAAU;AACxB,YAAA,GAAG,OAAO;AACX,SAAA,CAAC;AACF,QAAA,MAAM,KAAK,CAAC,OAAO,EAAE;AACrB,QAAA,OAAO,KAAK;IACd;AAEA;;;;;;;;;AASG;IACH,MAAM,UAAU,CAAC,OAA6B,EAAA;QAC5C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YACzC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;AACxB,YAAA,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;AAC9B,SAAA,CAAC;AACF,QAAA,MAAM,KAAK,CAAC,OAAO,EAAE;AACrB,QAAA,MAAM,KAAK,CAAC,aAAa,EAAE;IAC7B;AAEA;;;;;;;;;;;;;;;;AAgBG;IACH,MAAM,YAAY,CAAC,OAA+B,EAAA;QAChD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YACzC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;AACxB,YAAA,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC7C,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;AAC1C,aAAA;AACF,SAAA,CAAC;AACF,QAAA,MAAM,KAAK,CAAC,OAAO,EAAE;QACrB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE;QAC5C,OAAO,IAAI,KAAK,SAAS;IAC3B;+GA5IW,oBAAoB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAApB,IAAA,SAAA,IAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,SAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,oBAAoB,cAFnB,MAAM,EAAA,CAAA,CAAA;;4FAEP,oBAAoB,EAAA,UAAA,EAAA,CAAA;kBAHhC,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACV,oBAAA,UAAU,EAAE,MAAM;AACnB,iBAAA;;;ACrED;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BG;MAIU,wBAAwB,CAAA;AAC1B,IAAA,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC;AACpC,IAAA,OAAO,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC,MAAM;IACpD,MAAM,GAA+B,IAAI;AAEzC;;;;;AAKG;IACH,MAAM,OAAO,CAAC,OAA8B,EAAA;;QAE1C,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE;YACtD;QACF;QACA,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YACzC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;AACxB,YAAA,eAAe,EAAE,KAAK;AACtB,YAAA,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;AAC7C,gBAAA;oBACE,IAAI,EAAE,OAAO,CAAC,MAAM;oBACpB,OAAO,EAAE,MAAK;wBACZ,QAAQ,CAAC,MAAM,EAAE;oBACnB,CAAC;AACF,iBAAA;AACF,aAAA;AACF,SAAA,CAAC;AACF,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK;QACnB,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,MAAK;;AAElC,YAAA,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE;AACzB,gBAAA,IAAI,CAAC,MAAM,GAAG,IAAI;YACpB;AACF,QAAA,CAAC,CAAC;AACF,QAAA,MAAM,KAAK,CAAC,OAAO,EAAE;IACvB;AAEA;;;;;;;;AAQG;AACH,IAAA,MAAM,OAAO,GAAA;AACX,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM;AACzB,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI;AAClB,QAAA,MAAM,KAAK,EAAE,OAAO,EAAE;IACxB;+GArDW,wBAAwB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAAxB,IAAA,SAAA,IAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,SAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,wBAAwB,cAFvB,MAAM,EAAA,CAAA,CAAA;;4FAEP,wBAAwB,EAAA,UAAA,EAAA,CAAA;kBAHpC,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACV,oBAAA,UAAU,EAAE,MAAM;AACnB,iBAAA;;;ACpCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCG;AACI,MAAM,yBAAyB,GAAG,OACvC,SAA0B,EAC1B,OAAkC,KACjB;AACjB,IAAA,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC;QACnC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;AACxB,QAAA,OAAO,EAAE;AACP,YAAA;gBACE,IAAI,EAAE,OAAO,CAAC,SAAS;AACvB,gBAAA,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,MAAK;oBACZ,QAAQ,CAAC,MAAM,EAAE;gBACnB,CAAC;AACF,aAAA;AACF,SAAA;AACF,KAAA,CAAC;AACF,IAAA,MAAM,KAAK,CAAC,OAAO,EAAE;AACvB;;AChEA;;;;;;;;;;;;;;;;;;;;;AAqBG;MAKU,oBAAoB,CAAA;AACtB,IAAA,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC;AAEjC,IAAA,WAAA,GAAA,EAAe;AAEf;;;;;;;;;AASG;IACH,QAAQ,GAAA;AACN,QAAA,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE;YACrC;QACF;QACA,UAAU,CAAC,MAAK;AACd,YAAA,IAAI;AACF,gBAAA,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,gBAAgB,CACjD,QAAQ,EACR,CAAC,CAAQ,KAAI;AACX,oBAAA,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,GAAI,CAAC,CAAC,MAA2B,CAAC,KAAK;AACrE,gBAAA,CAAC,EACD;AACE,oBAAA,OAAO,EAAE,KAAK;AACd,oBAAA,IAAI,EAAE,IAAI;AACV,oBAAA,OAAO,EAAE,IAAI;AACd,iBAAA,CACF;YACH;AAAE,YAAA,MAAM;;YAER;AACF,QAAA,CAAC,EAAE,GAAG,CAAC,CAAC;IACV;+GApCW,oBAAoB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA,CAAA;mGAApB,oBAAoB,EAAA,YAAA,EAAA,IAAA,EAAA,QAAA,EAAA,kBAAA,EAAA,QAAA,EAAA,EAAA,EAAA,CAAA,CAAA;;4FAApB,oBAAoB,EAAA,UAAA,EAAA,CAAA;kBAJhC,SAAS;AAAC,YAAA,IAAA,EAAA,CAAA;AACT,oBAAA,QAAQ,EAAE,kBAAkB;AAC5B,oBAAA,UAAU,EAAE,IAAI;AACjB,iBAAA;;;ACbD;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;MAIU,qBAAqB,CAAA;AACvB,IAAA,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC;AAC5B,IAAA,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC;AAErC;;;;;;AAMG;AACH,IAAA,MAAM,IAAI,CAAC,UAAsB,EAAE,IAAuB,EAAA;QACxD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE;AAChC,YAAA,OAAO,EAAE;QACX;QACA,OAAO;AACL,YAAA,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,IAAI,CAAC;AAC9C,YAAA,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,IAAI,CAAC;AAC9C,YAAA,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC;AACvC,YAAA,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC;SACxC;IACH;IAEA,iBAAiB,CAAC,UAAsB,EAAE,IAAuB,EAAA;QAC/D,OAAO,QAAQ,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC,IAAI,KAAI;YACvD,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE;AAChC,gBAAA,IAAI,UAAU,CAAC,aAAa,CAAC,OAAO,KAAK,YAAY,IAAI,IAAI,KAAK,WAAW,EAAE;;oBAE7E,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,wBAAwB,CAAC;gBACrE;gBACA;YACF;YAEA,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC;AACvD,YAAA,MAAM,oBAAoB,GAAG,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,MAAM,CAAY,CAAC;AACrG,YAAA,MAAM,QAAQ,GAAG,QAAQ,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,EAAE,EAAE,CAAC;AAE9F,YAAA,IAAI,IAAI,KAAK,WAAW,EAAE;gBACxB,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,GAAG,iBAAiB;gBAC7D,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,GAAG,WAAW;gBACvD,qBAAqB,CACnB,OAAO,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,GAAG,CAAA,WAAA,EAAc,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAA,GAAA,CAAK,CAAC,CAC1G;YACH;AAAO,iBAAA,IAAI,IAAI,KAAK,QAAQ,EAAE;gBAC5B,qBAAqB,CAAC,MAAK;AACzB,oBAAA,MAAM,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,gBAAgB,CAAC,mBAAmB,CAAC;AAC3F,oBAAA,IAAI,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE;AACzD,wBAAA,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAA,EAAG,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAA,EAAA,CAAI,CAAC;oBAChG;AACF,gBAAA,CAAC,CAAC;YACJ;iBAAO;gBACL,qBAAqB,CAAC,MAAK;AACzB,oBAAA,MAAM,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,gBAAgB,CAAC,mBAAmB,CAAC;AAC3F,oBAAA,IAAI,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE;AACzD,wBAAA,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,kBAAkB,EAAE,GAAG,IAAI,CAAC,cAAc,CAAA,EAAA,CAAI,CAAC;oBAC5F;AACF,gBAAA,CAAC,CAAC;YACJ;AACF,QAAA,CAAC,CAAC;IACJ;IAEA,iBAAiB,CAAC,UAAsB,EAAE,IAAuB,EAAA;AAC/D,QAAA,OAAO,QAAQ,CAAC,WAAW,CAAC,kBAAkB,EAAE,MAAK;YACnD,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE;AAChC,gBAAA,IAAI,UAAU,CAAC,aAAa,CAAC,OAAO,KAAK,YAAY,IAAI,IAAI,KAAK,WAAW,EAAE;oBAC7E,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,wBAAwB,CAAC;gBAClE;gBACA;YACF;YAEA,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC;AAE1D,YAAA,IAAI,IAAI,KAAK,WAAW,EAAE;gBACxB,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,GAAG,eAAe;gBAC3D,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,GAAG,iBAAiB;gBAC5D,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,GAAG,WAAW;YACzD;AAAO,iBAAA,IAAI,IAAI,KAAK,QAAQ,EAAE;gBAC5B,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,iBAAiB,EAAE,KAAK,CAAC;YACtE;iBAAO;gBACL,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,kBAAkB,EAAE,KAAK,CAAC;YACvE;AACF,QAAA,CAAC,CAAC;IACJ;AAEA,IAAA,gBAAgB,CAAC,UAAsB,EAAA;AACrC,QAAA,OAAO,QAAQ,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAK;YAClD,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,GAAG,MAAM;AACpD,QAAA,CAAC,CAAC;IACJ;AAEA,IAAA,gBAAgB,CAAC,UAAsB,EAAA;AACrC,QAAA,OAAO,QAAQ,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAK;YAClD,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,GAAG,MAAM;AACpD,QAAA,CAAC,CAAC;IACJ;+GA9FW,qBAAqB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAArB,IAAA,SAAA,IAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,SAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,qBAAqB,cAFpB,MAAM,EAAA,CAAA,CAAA;;4FAEP,qBAAqB,EAAA,UAAA,EAAA,CAAA;kBAHjC,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACV,oBAAA,UAAU,EAAE,MAAM;AACnB,iBAAA;;;ACyCD;;AAEG;MACU,eAAe,GAAG,IAAI,cAAc,CAAgB,gCAAgC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BG;MACU,cAAc,GAAG,CAAC,aAAkC,KAC/D,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AAEpF;;;;;;;;;;;;;;AAcG;AACI,MAAM,4BAA4B,GAAkB,MAAK;IAC9D,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,eAAe,CAAC;AACxD,IAAA,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;AAC7B,IAAA,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC;IAErC,OAAO,SAAS,EAAE,CAAC,IAAI,CACrB,GAAG,CAAC,CAAC,IAAI,KAAI;AACX,QAAA,IAAI,IAAI,KAAK,MAAM,EAAE;AACnB,YAAA,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;YAC5B,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;AAC3C,YAAA,OAAO,KAAK;QACd;AAAO,aAAA,IAAI,IAAI,KAAK,SAAS,EAAE;YAC7B,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;AAC3C,YAAA,OAAO,KAAK;QACd;;AAEA,QAAA,OAAO,IAAI;IACb,CAAC,CAAC,CACH;AACH;AAEA;;;;;;;;;;;;;AAaG;AACI,MAAM,yBAAyB,GAAkB,MAAK;IAC3D,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,eAAe,CAAC;AACxD,IAAA,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;AAC7B,IAAA,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC;IAErC,OAAO,SAAS,EAAE,CAAC,IAAI,CACrB,GAAG,CAAC,CAAC,IAAI,KAAI;AACX,QAAA,IAAI,IAAI,KAAK,SAAS,EAAE;AACtB,YAAA,OAAO,IAAI;QACb;AACA,QAAA,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;QAC5B,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,WAAW,GAAG,SAAS,CAAC,cAAc,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;AAChG,QAAA,OAAO,KAAK;IACd,CAAC,CAAC,CACH;AACH;AAEA;;;;;;;;;;;;;;;;;AAiBG;MACU,yBAAyB,GAAkB,CAAC,MAAM,EAAE,KAAK,KAAI;AACxE,IAAA,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,eAAe,CAAC;AACzF,IAAA,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;AAC7B,IAAA,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC;IAErC,OAAO,SAAS,EAAE,CAAC,IAAI,CACrB,QAAQ,CAAC,OAAO,IAAI,KAAI;AACtB,QAAA,IAAI,IAAI,KAAK,MAAM,EAAE;;AAEnB,YAAA,OAAO,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI;QAClD;AACA,QAAA,IAAI,IAAI,KAAK,WAAW,EAAE;AACxB,YAAA,OAAO,IAAI;QACb;;AAEA,QAAA,MAAM,QAAQ,GAAG,iBAAiB,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,GAAG,KAAK;AAC3E,QAAA,IAAI,QAAQ,KAAK,KAAK,EAAE;AACtB,YAAA,OAAO,QAAQ;QACjB;AACA,QAAA,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;QAC5B,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAC7C,QAAA,OAAO,KAAK;IACd,CAAC,CAAC,CACH;AACH;;AC3NA;;;;AAIG;AACH,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;AAyG7D;;AAEG;MACU,eAAe,GAAG,IAAI,cAAc,CAAgB,gCAAgC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BG;MACU,cAAc,GAAG,CAAC,aAAkC,KAC/D,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;MACU,kBAAkB,GAAsB,CAAC,OAAO,EAAE,IAAI,KAAI;AACrE,IAAA,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC;IAEtC,IAAI,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE;AAC5B,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB;AAEA,IAAA,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAC9C,QAAQ,CAAC,CAAC,WAAW,KAAI;QACvB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC,iBAAiB,GAAG,OAAO,CAAC,EAAE,EAAE,CAAC;QAErG,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CACnB,KAAK,CAAC;AACJ,YAAA,KAAK,EAAE,CAAC;AACR,YAAA,KAAK,EAAE,CAAC,CAAoB,EAAE,UAAU,KAAI;AAC1C,gBAAA,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE;AACpB,oBAAA,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC5B;gBACA,IAAI,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;AAC7C,oBAAA,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC5B;gBACA,OAAO,KAAK,CAAC,CAAC,UAAU,GAAG,CAAC,IAAI,GAAG,CAAC;YACtC,CAAC;AACF,SAAA,CAAC,EACF,GAAG,CAAC,CAAC,KAAK,KAAI;AACZ,YAAA,IAAI,KAAK,YAAY,YAAY,EAAE;AACjC,gBAAA,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;YAC5B;AACF,QAAA,CAAC,CAAC,EACF,UAAU,CAAC,CAAC,CAAoB,KAAI;YAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAe,GAAG,GAAG,EAAE,CAAC,CAAC;YACjD,IAAI,QAAQ,EAAE;AACZ,gBAAA,OAAO,QAAQ;YACjB;AACA,YAAA,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE;AACpB,gBAAA,MAAM,CAAC,cAAc,GAAG,GAAG,CAAC;YAC9B;AAAO,iBAAA,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE;AAC3B,gBAAA,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC;YAC3B;AAAO,iBAAA,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;gBACzC,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,KAAI;AACvC,oBAAA,IAAI,MAAM,CAAC,SAAS,EAAE;wBACpB,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;oBACnC;AACF,gBAAA,CAAC,CAAC;YACJ;AAAO,iBAAA,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE;gBAC3B,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;YACzC;AACA,YAAA,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC,CACH;IACH,CAAC,CAAC,CACH;AACH;;AC3OA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDG;AACI,MAAM,eAAe,GAAG,CAC7B,QAAa,EACb,QAAa,EACb,GAAY,EACZ,KAAA,GAAwB,MAAM,EAC9B,YAAsB,KACf;IACP,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;AACxC,QAAA,OAAO,EAAE;IACX;IACA,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAW;AACvC,IAAA,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAW;AAEzD,IAAA,MAAM,WAAW,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,GAAG,KAAI;AAClD,QAAA,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAW;AAChC,QAAA,OAAO,CAAC,IAAI,GAAG,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,IAAI;AAChI,IAAA,CAAC,CAAC;IAEF,MAAM,oBAAoB,GAAG;AAC3B,UAAE,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC,YAAY,CAAC,CAAC;UACpG,WAAW;AAEf,IAAA,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5G,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;AAErC,IAAA,MAAM,SAAS,GAAG,KAAK,KAAK,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAI;AACxB,QAAA,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW;AAC1B,QAAA,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW;AAC1B,QAAA,IAAI,CAAC,GAAG,CAAC,EAAE;AACT,YAAA,OAAO,SAAS;QAClB;AACA,QAAA,IAAI,CAAC,GAAG,CAAC,EAAE;AACT,YAAA,OAAO,SAAS,GAAG,CAAC,CAAC;QACvB;AACA,QAAA,OAAO,CAAC;AACV,IAAA,CAAC,CAAC;AACJ;;AC/FA;;;;;;;;;;;;;;;;;;;;;AAqBG;MACU,WAAW,GAAG,CAAC,CAAS,EAAE,CAAS,KAAa;IAC3D,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;AACnB,QAAA,OAAO,IAAI;IACb;AACA,IAAA,MAAM,QAAQ,GAAG,CAAC,GAAY,KAAa;QACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,EAAE;AACnC,YAAA,OAAO,SAAS;QAClB;AACA,QAAA,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG;AACtB,aAAA,IAAI;AACJ,aAAA,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,KAAK,KAAK,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;AAChG,IAAA,CAAC;AACD,IAAA,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACpE;;ACnCA;;;;;;;;;;;;;;;;;AAiBG;AACI,MAAM,cAAc,GAAG,OAAO,KAAY,EAAE,IAA6B,KAAmB;AACjG,IAAA,MAAM,MAAM,GAAG,KAAK,CAAC,MAA2B;AAChD,IAAA,MAAM,CAAC,QAAQ,GAAG,IAAI;IACtB,MAAM,IAAI,CAAC,KAAK,CAAC,MAAiB,SAAS,CAAC;AAC5C,IAAA,MAAM,CAAC,QAAQ,GAAG,KAAK;AACzB;;ACvBA;;AAEG;AAEH;;ACJA;;AAEG;;;;"}
+{"version":3,"file":"rdlabo-ionic-angular-kit.mjs","sources":["../../../projects/kit/src/lib/storage/kit-storage.service.ts","../../../projects/kit/src/lib/overlay/overlay-config.ts","../../../projects/kit/src/lib/utils/haptics.ts","../../../projects/kit/src/lib/overlay/kit-overlay.controller.ts","../../../projects/kit/src/lib/overlay/kit-reload-alert.controller.ts","../../../projects/kit/src/lib/overlay/kit-auth-failed-alert.ts","../../../projects/kit/src/lib/directives/autofill.directive.ts","../../../projects/kit/src/lib/keyboard/kit-keyboard.controller.ts","../../../projects/kit/src/lib/auth/auth-guards.ts","../../../projects/kit/src/lib/http/kit-http.interceptor.ts","../../../projects/kit/src/lib/utils/array.ts","../../../projects/kit/src/lib/utils/object.ts","../../../projects/kit/src/lib/utils/dom.ts","../../../projects/kit/src/public-api.ts","../../../projects/kit/src/rdlabo-ionic-angular-kit.ts"],"sourcesContent":["import { inject, Injectable } from '@angular/core';\nimport { Storage } from '@ionic/storage-angular';\n\n/**\n * Thin, typed wrapper around `@ionic/storage-angular`.\n *\n * Starts `create()` exactly once and stores the resulting ready Promise. Every operation awaits\n * that Promise before touching the underlying store, so calls made before initialization completes\n * are queued rather than dropped.\n *\n * @remarks\n * A naive wrapper that reads the store synchronously would silently no-op (or throw) when invoked\n * before `create()` resolves, losing early writes. Awaiting the one-time ready Promise on every\n * operation removes that race without forcing callers to coordinate initialization themselves.\n *\n * @example\n * ```ts\n * constructor(private readonly storage: KitStorageService) {}\n *\n * async ngOnInit(): Promise<void> {\n *   await this.storage.set('token', 'abc123');\n *   const token = await this.storage.get<string>('token');\n * }\n * ```\n */\n@Injectable({\n  providedIn: 'root',\n})\nexport class KitStorageService {\n  /** One-time `create()` ready Promise; awaited before every operation so early calls are not lost. */\n  readonly #ready: Promise<Storage> = inject(Storage).create();\n\n  /**\n   * Persist a value under the given key.\n   *\n   * @typeParam T - type of the value being stored\n   * @param key - key to store the value under\n   * @param value - value to persist; overwrites any existing value for the key\n   * @returns a Promise that resolves once the value has been written\n   * @example\n   * ```ts\n   * await storage.set('user', { id: 1, name: 'Ada' });\n   * ```\n   */\n  async set<T>(key: string, value: T): Promise<void> {\n    await (await this.#ready).set(key, value);\n  }\n\n  /**\n   * Read the value stored under the given key.\n   *\n   * @typeParam T - expected type of the stored value\n   * @param key - key to read\n   * @returns the stored value, or `null` when the key is absent\n   * @example\n   * ```ts\n   * const user = await storage.get<{ id: number }>('user');\n   * ```\n   */\n  async get<T>(key: string): Promise<T | null> {\n    return (await (await this.#ready).get(key)) ?? null;\n  }\n\n  /**\n   * Remove the value stored under the given key.\n   *\n   * @param key - key to remove; a no-op when the key is absent\n   * @returns a Promise that resolves once the key has been removed\n   */\n  async remove(key: string): Promise<void> {\n    await (await this.#ready).remove(key);\n  }\n\n  /**\n   * Remove every key/value pair from the store.\n   *\n   * @returns a Promise that resolves once the store has been emptied\n   */\n  async clear(): Promise<void> {\n    await (await this.#ready).clear();\n  }\n\n  /**\n   * List every key currently present in the store.\n   *\n   * @returns an array of all stored keys\n   */\n  async keys(): Promise<string[]> {\n    return (await this.#ready).keys();\n  }\n}\n","import type { EnvironmentProviders } from '@angular/core';\nimport { InjectionToken, makeEnvironmentProviders } from '@angular/core';\n\n/**\n * User-visible button labels consumed by `KitOverlayController`.\n *\n * @remarks\n * The kit deliberately ships no i18n strings of its own and has no hard dependency on\n * `@angular/localize`. The consuming application always provides these labels: multilingual apps\n * pass `$localize`-resolved strings, single-language apps pass plain literals.\n */\nexport interface KitLabels {\n  /** Text for the \"close\" button used by alerts and toasts. */\n  readonly close: string;\n  /** Text for the \"cancel\" button used by confirmation alerts. */\n  readonly cancel: string;\n}\n\n/**\n * Overlay configuration injected via `provideKitOverlay()`.\n *\n * @remarks\n * All fields are required; the consuming application must supply a complete configuration.\n */\nexport interface KitOverlayConfig {\n  /** Button labels used across the overlays presented by `KitOverlayController`. */\n  readonly labels: KitLabels;\n}\n\n/**\n * Injection token carrying the {@link KitOverlayConfig} for `KitOverlayController`.\n *\n * @remarks\n * Provide it through {@link provideKitOverlay} rather than registering it directly.\n */\nexport const KIT_OVERLAY_CONFIG = new InjectionToken<KitOverlayConfig>('@rdlabo/ionic-angular-kit:overlay');\n\n/**\n * Wire `KitOverlayController` into the application by providing its button labels.\n *\n * @param config - overlay configuration, including the button labels to inject\n * @returns environment providers to add to the application's provider list\n * @example\n * ```ts\n * bootstrapApplication(AppComponent, {\n *   providers: [\n *     provideKitOverlay({ labels: { close: $localize`Close`, cancel: $localize`Cancel` } }),\n *   ],\n * });\n * ```\n */\nexport const provideKitOverlay = (config: KitOverlayConfig): EnvironmentProviders =>\n  makeEnvironmentProviders([{ provide: KIT_OVERLAY_CONFIG, useValue: config }]);\n","import { Capacitor } from '@capacitor/core';\nimport { Haptics, ImpactStyle } from '@capacitor/haptics';\n\n/**\n * Trigger native haptic impact feedback.\n *\n * Delegates to `@capacitor/haptics` `Haptics.impact()` when running on a native platform. On the\n * web (or any non-native platform) it is a no-op and resolves without doing anything.\n *\n * @remarks\n * This haptic side effect was previously bundled implicitly into toast/modal presentation. It has\n * been decoupled into this explicit function so callers opt in to the feedback deliberately, rather\n * than receiving it as a hidden side effect of presenting UI.\n *\n * @param style - The impact intensity to play. Defaults to {@link ImpactStyle.Light}.\n * @returns A promise that resolves once the feedback has been requested (immediately on the web).\n * @example\n * ```ts\n * import { ImpactStyle } from '@capacitor/haptics';\n *\n * // Light tap (default)\n * await kitImpact();\n *\n * // Stronger feedback, e.g. on a confirming action\n * await kitImpact(ImpactStyle.Heavy);\n * ```\n */\nexport const kitImpact = async (style: ImpactStyle = ImpactStyle.Light): Promise<void> => {\n  if (Capacitor.isNativePlatform()) {\n    await Haptics.impact({ style });\n  }\n};\n","import { inject, Injectable } from '@angular/core';\nimport type { ModalOptions, PopoverOptions, ToastOptions } from '@ionic/angular/standalone';\nimport { AlertController, ModalController, PopoverController, ToastController } from '@ionic/angular/standalone';\nimport type { PluginListenerHandle } from '@capacitor/core';\nimport { Capacitor } from '@capacitor/core';\nimport { Keyboard } from '@capacitor/keyboard';\nimport { KIT_OVERLAY_CONFIG } from './overlay-config';\nimport { kitImpact } from '../utils/haptics';\n\n/**\n * Options for {@link KitOverlayController.presentModal}.\n *\n * @remarks\n * Extends Ionic's `ModalOptions` but omits `component` and `componentProps`, which are passed as\n * dedicated arguments instead.\n */\nexport interface KitModalPresentOptions extends Omit<ModalOptions, 'component' | 'componentProps'> {\n  /**\n   * When `true`, expand the sheet to its maximum breakpoint while the native keyboard is shown.\n   *\n   * @remarks\n   * Only has an effect on native platforms; ignored on the web.\n   */\n  watchKeyboard?: boolean;\n}\n\n/**\n * Options for {@link KitOverlayController.alertClose}.\n */\nexport interface KitAlertCloseOptions {\n  /** Alert header text. */\n  header: string;\n  /** Alert body message. */\n  message: string;\n  /** Optional alert sub-header text shown beneath the header. */\n  subHeader?: string;\n}\n\n/**\n * Options for {@link KitOverlayController.alertConfirm}.\n *\n * @remarks\n * Extends {@link KitAlertCloseOptions} with the confirm-button text.\n */\nexport interface KitAlertConfirmOptions extends KitAlertCloseOptions {\n  /**\n   * Text for the OK (confirm) button.\n   *\n   * @remarks\n   * Action-specific, so it is supplied by the caller rather than taken from the shared labels.\n   */\n  okText: string;\n}\n\n/**\n * Attach a native keyboard listener that grows the modal to its maximum breakpoint when the\n * keyboard appears.\n *\n * @param modal - the presented modal element to resize\n * @returns a listener handle; on non-native platforms a no-op handle whose `remove()` does nothing\n * @internal\n */\nconst watchModalKeyboard = async (modal: HTMLIonModalElement): Promise<PluginListenerHandle> => {\n  if (!Capacitor.isNativePlatform()) {\n    return { remove: async () => undefined };\n  }\n  return Keyboard.addListener('keyboardDidShow', () => modal.setCurrentBreakpoint(1));\n};\n\n/**\n * Ergonomic wrapper that consolidates Ionic's overlay controllers (Modal / Toast / Alert).\n *\n * @remarks\n * Folds the repetitive create → present → onDidDismiss sequence into single calls and returns the\n * relevant result directly. It holds no application-specific policy such as navigation; compose\n * those concerns on the consuming side.\n *\n * @example\n * ```ts\n * constructor(private readonly overlay: KitOverlayController) {}\n *\n * async edit(): Promise<void> {\n *   const result = await this.overlay.presentModal<EditResult>(EditPage, { id: 1 });\n *   if (result) {\n *     await this.overlay.presentToast({ message: 'Saved' });\n *   }\n * }\n * ```\n */\n@Injectable({\n  providedIn: 'root',\n})\nexport class KitOverlayController {\n  readonly #modalCtrl = inject(ModalController);\n  readonly #popoverCtrl = inject(PopoverController);\n  readonly #toastCtrl = inject(ToastController);\n  readonly #alertCtrl = inject(AlertController);\n  readonly #labels = inject(KIT_OVERLAY_CONFIG).labels;\n\n  /**\n   * Present a modal and resolve with the data passed to its dismissal.\n   *\n   * @typeParam O - type of the data returned when the modal is dismissed\n   * @param component - the component to render inside the modal\n   * @param componentProps - props to pass to the modal component\n   * @param options - additional modal options, including {@link KitModalPresentOptions.watchKeyboard}\n   * @returns the dismiss data, or `undefined` when the modal is dismissed without data\n   * @example\n   * ```ts\n   * const data = await overlay.presentModal<{ saved: boolean }>(EditPage, { id: 1 }, { watchKeyboard: true });\n   * ```\n   */\n  async presentModal<O = unknown>(\n    component: ModalOptions['component'],\n    componentProps?: ModalOptions['componentProps'],\n    options: KitModalPresentOptions = {},\n  ): Promise<O | undefined> {\n    const { watchKeyboard, ...modalOptions } = options;\n    const modal = await this.#modalCtrl.create({ component, componentProps, ...modalOptions });\n    await modal.present();\n    const handle = watchKeyboard ? await watchModalKeyboard(modal) : null;\n    const { data } = await modal.onDidDismiss<O>();\n    await handle?.remove();\n    return data;\n  }\n\n  /**\n   * Present a popover and resolve with the data passed to its dismissal.\n   *\n   * @typeParam O - type of the data returned when the popover is dismissed\n   * @param component - the component to render inside the popover\n   * @param componentProps - props to pass to the popover component\n   * @param options - additional popover options (for example `event` to anchor it, or `cssClass`)\n   * @returns the dismiss data, or `undefined` when the popover is dismissed without data\n   * @example\n   * ```ts\n   * const choice = await overlay.presentPopover<MenuChoice>(MenuPopover, { items }, { event });\n   * ```\n   */\n  async presentPopover<O = unknown>(\n    component: PopoverOptions['component'],\n    componentProps?: PopoverOptions['componentProps'],\n    options: Omit<PopoverOptions, 'component' | 'componentProps'> = {},\n  ): Promise<O | undefined> {\n    const popover = await this.#popoverCtrl.create({ component, componentProps, ...options });\n    await popover.present();\n    const { data } = await popover.onDidDismiss<O>();\n    return data;\n  }\n\n  /**\n   * Present a toast using kit defaults that the caller may override.\n   *\n   * @remarks\n   * Defaults to a bottom position, a 2000ms duration, a vertical swipe gesture, and a close button\n   * from the configured labels; any of these can be overridden via `options`. Presenting a toast\n   * also triggers light native haptic feedback as an intentional kit UX choice.\n   *\n   * Bottom is the fleet-wide default (top left the toast fighting the tab bar and the keyboard).\n   * For a bottom toast with no explicit `positionAnchor`, if a visible `ion-tab-bar` is present the\n   * toast is automatically anchored above it (Ionic places a bottom toast above its `positionAnchor`),\n   * so the toast never sits behind the tabs. Avoiding the on-screen keyboard is handled by the native\n   * keyboard resize — the anchored/bottom toast rides the shrinking viewport above the keyboard;\n   * Ionic itself has no toast keyboard-avoidance option. An app can override either via `options`.\n   *\n   * @param options - Ionic toast options that override the kit defaults\n   * @returns the presented toast element\n   * @example\n   * ```ts\n   * await overlay.presentToast({ message: 'Copied to clipboard' });\n   * ```\n   */\n  async presentToast(options: ToastOptions): Promise<HTMLIonToastElement> {\n    void kitImpact();\n    const merged: ToastOptions = {\n      position: 'bottom',\n      duration: 2000,\n      buttons: [this.#labels.close],\n      swipeGesture: 'vertical',\n      ...options,\n    };\n    // Anchor a bottom toast above the tab bar when one is visibly present and the caller did not\n    // set an explicit anchor, so the toast clears the tabs (and rides the keyboard-resized viewport).\n    if (merged.position === 'bottom' && merged.positionAnchor === undefined) {\n      const tabBar = document.querySelector('ion-tab-bar');\n      if (tabBar && tabBar.getBoundingClientRect().height > 0) {\n        merged.positionAnchor = tabBar as HTMLElement;\n      }\n    }\n    const toast = await this.#toastCtrl.create(merged);\n    await toast.present();\n    return toast;\n  }\n\n  /**\n   * Present a notification alert with a single \"close\" button and wait for it to be dismissed.\n   *\n   * @param options - alert content (header, message, optional sub-header)\n   * @returns a Promise that resolves once the alert has been dismissed\n   * @example\n   * ```ts\n   * await overlay.alertClose({ header: 'Done', message: 'Your changes were saved.' });\n   * ```\n   */\n  async alertClose(options: KitAlertCloseOptions): Promise<void> {\n    const alert = await this.#alertCtrl.create({\n      header: options.header,\n      subHeader: options.subHeader,\n      message: options.message,\n      buttons: [this.#labels.close],\n    });\n    await alert.present();\n    await alert.onWillDismiss();\n  }\n\n  /**\n   * Present a confirmation alert with cancel and OK buttons.\n   *\n   * @param options - alert content plus the OK button text via {@link KitAlertConfirmOptions.okText}\n   * @returns `true` when the user presses OK, `false` otherwise (cancel or backdrop dismissal)\n   * @example\n   * ```ts\n   * const ok = await overlay.alertConfirm({\n   *   header: 'Delete item?',\n   *   message: 'This cannot be undone.',\n   *   okText: 'Delete',\n   * });\n   * if (ok) {\n   *   await remove();\n   * }\n   * ```\n   */\n  async alertConfirm(options: KitAlertConfirmOptions): Promise<boolean> {\n    const alert = await this.#alertCtrl.create({\n      header: options.header,\n      subHeader: options.subHeader,\n      message: options.message,\n      buttons: [\n        { text: this.#labels.cancel, role: 'cancel' },\n        { text: options.okText, role: 'confirm' },\n      ],\n    });\n    await alert.present();\n    const { role } = await alert.onWillDismiss();\n    return role === 'confirm';\n  }\n}\n","import { inject, Injectable } from '@angular/core';\nimport { AlertController } from '@ionic/angular/standalone';\nimport { KIT_OVERLAY_CONFIG } from './overlay-config';\n\n/**\n * Content for {@link KitReloadAlertController.present}.\n */\nexport interface KitReloadAlertOptions {\n  /** Alert header text. */\n  header: string;\n  /** Alert body message. */\n  message: string;\n  /**\n   * Text for the reload (confirm) button, e.g. \"リフレッシュ\".\n   *\n   * @remarks\n   * Action-specific, so it is supplied by the caller rather than taken from the shared labels.\n   * The cancel button uses the configured {@link KitLabels.cancel}.\n   */\n  okText: string;\n}\n\n/**\n * The fleet's canonical \"network error → offer to reload\" alert, as a stateful controller.\n *\n * @remarks\n * Consolidates the good-UX variant that had drifted across the fleet into one behavior:\n *\n * - **De-dup** — never stacks; a second {@link present} while an alert is already shown is a no-op.\n * - **Backdrop lock** — `backdropDismiss: false`, so a critical network error can't be dismissed by\n *   an accidental backdrop tap; the user consciously chooses cancel or reload.\n * - **Auto-dismiss on reconnect** — the presented alert is tracked, so {@link dismiss} (called from a\n *   later successful response) clears a now-stale error alert instead of leaving it on screen.\n * - **Reload on confirm** — the confirm button calls `location.reload()`.\n *\n * All user-facing text is supplied by the caller so the kit stays free of any hardcoded i18n; the\n * cancel button reuses {@link KitOverlayConfig.labels}. Because it performs navigation\n * (`location.reload()`) and holds state, it is a dedicated controller rather than part of\n * {@link KitOverlayController}, which stays free of navigation policy.\n *\n * @example\n * ```ts\n * // In an HTTP interceptor:\n * const reload = inject(KitReloadAlertController);\n * // ...on a network-class error while connected:\n * await reload.present({ header: 'ネットワークエラー', message: `…（${status}）`, okText: 'リフレッシュ' });\n * // ...on any later successful response:\n * await reload.dismiss();\n * ```\n */\n@Injectable({\n  providedIn: 'root',\n})\nexport class KitReloadAlertController {\n  readonly #alertCtrl = inject(AlertController);\n  readonly #labels = inject(KIT_OVERLAY_CONFIG).labels;\n  #alert: HTMLIonAlertElement | null = null;\n\n  /**\n   * Present the reload alert, unless one is already on screen.\n   *\n   * @param options - alert content plus the reload-button text\n   * @returns a Promise that resolves once the alert has been presented (or immediately if suppressed)\n   */\n  async present(options: KitReloadAlertOptions): Promise<void> {\n    // この controller 経由でも直書き ion-alert でも、多重表示しない。\n    if (this.#alert || document.querySelector('ion-alert')) {\n      return;\n    }\n    const alert = await this.#alertCtrl.create({\n      header: options.header,\n      message: options.message,\n      backdropDismiss: false,\n      buttons: [\n        { text: this.#labels.cancel, role: 'cancel' },\n        {\n          text: options.okText,\n          handler: () => {\n            location.reload();\n          },\n        },\n      ],\n    });\n    this.#alert = alert;\n    void alert.onDidDismiss().then(() => {\n      // 別の present で置き換わっていない限り、追跡を解除する。\n      if (this.#alert === alert) {\n        this.#alert = null;\n      }\n    });\n    await alert.present();\n  }\n\n  /**\n   * Dismiss the tracked reload alert if one is showing.\n   *\n   * @remarks\n   * Typically called from a later successful response so a stale \"network error\" alert clears once\n   * connectivity is restored. A no-op when nothing is showing.\n   *\n   * @returns a Promise that resolves once the alert has been dismissed (or immediately if none)\n   */\n  async dismiss(): Promise<void> {\n    const alert = this.#alert;\n    this.#alert = null;\n    await alert?.dismiss();\n  }\n}\n","import type { AlertController } from '@ionic/angular/standalone';\n\n/**\n * Content for {@link kitPresentAuthFailedAlert}.\n */\nexport interface KitAuthFailedAlertOptions {\n  /** Alert header, e.g. \"ログインできませんでした\". */\n  header: string;\n  /** Optional sub-header; typically the short server error code/name. */\n  subHeader?: string;\n  /** Alert body message; typically the server-provided detail. */\n  message: string;\n  /** Text for the single close button, e.g. \"閉じる\". */\n  closeText: string;\n}\n\n/**\n * Present the fleet's canonical \"sign-in / token exchange failed\" alert.\n *\n * @remarks\n * Folds together the alert every token-exchange app duplicated verbatim when a startup re-login\n * fails: an informative alert (header + optional server error as sub-header + detail message) with a\n * single close button that reloads the app (`location.reload()`) so the user restarts cleanly. The\n * caller is still responsible for signing the user out around this call.\n *\n * All user-facing text is supplied by the caller so the kit stays free of any hardcoded i18n. Kept\n * as a standalone helper (taking the `AlertController`) rather than a method on\n * {@link KitOverlayController}, which holds no navigation policy such as `location.reload()`.\n *\n * @param alertCtrl - Ionic's `AlertController`\n * @param options - alert content plus the close-button text\n * @returns a Promise that resolves once the alert has been presented\n * @example\n * ```ts\n * onAuthorized: async () => {\n *   const logged = await auth.tokenLogin().catch(async (e) => {\n *     await kitPresentAuthFailedAlert(alertCtrl, {\n *       header: 'ログインできませんでした',\n *       subHeader: e.error.error,\n *       message: e.error.detail,\n *       closeText: '閉じる',\n *     });\n *     await auth.signOut();\n *     return undefined;\n *   });\n *   // ...\n * };\n * ```\n */\nexport const kitPresentAuthFailedAlert = async (\n  alertCtrl: AlertController,\n  options: KitAuthFailedAlertOptions,\n): Promise<void> => {\n  const alert = await alertCtrl.create({\n    header: options.header,\n    subHeader: options.subHeader,\n    message: options.message,\n    buttons: [\n      {\n        text: options.closeText,\n        role: 'cancel',\n        handler: () => {\n          location.reload();\n        },\n      },\n    ],\n  });\n  await alert.present();\n};\n","import type { OnInit } from '@angular/core';\nimport { Directive, ElementRef, inject } from '@angular/core';\nimport { Capacitor } from '@capacitor/core';\n\n/**\n * Work around iOS `ion-input` autofill values not propagating to the Angular form model.\n *\n * On iOS, when the browser autofills an `ion-input` (for example a saved password), the value\n * is written to the underlying native `<input>` element but the corresponding `change` event is\n * not forwarded to the host `ion-input`, so the Angular form control (and `ngModel`) never sees\n * the autofilled value. This directive listens for the first `change` event on the inner input\n * element and mirrors its value back onto the host element, restoring two-way binding.\n *\n * Apply it to any `ion-input` that participates in a form and may be autofilled by attaching the\n * `rdlaboAutofill` attribute.\n *\n * @remarks\n * The directive is a no-op on every platform other than iOS, where the value already propagates\n * correctly. A short timeout is used because `ion-input` creates its inner `<input>` element\n * asynchronously after the host element is initialized.\n *\n * @example\n * ```html\n * <ion-input rdlaboAutofill type=\"password\" [(ngModel)]=\"password\"></ion-input>\n * ```\n */\n@Directive({\n  selector: '[rdlaboAutofill]',\n  standalone: true,\n})\nexport class KitAutofillDirective implements OnInit {\n  readonly #el = inject(ElementRef);\n\n  constructor() {}\n\n  /**\n   * Register the iOS autofill workaround once the directive is initialized.\n   *\n   * Returns immediately on non-iOS platforms. On iOS, after a short delay it attaches a one-shot,\n   * passive `change` listener to the inner `<input>` element that `ion-input` renders, copying the\n   * autofilled value back onto the host element so the Angular form model stays in sync. Any error\n   * while locating the inner input (for example if the element is not yet present) is swallowed.\n   *\n   * @returns Nothing.\n   */\n  ngOnInit(): void {\n    if (Capacitor.getPlatform() !== 'ios') {\n      return;\n    }\n    setTimeout(() => {\n      try {\n        this.#el.nativeElement.children[0].addEventListener(\n          'change',\n          (e: Event) => {\n            this.#el.nativeElement.value = (e.target as HTMLInputElement).value;\n          },\n          {\n            capture: false,\n            once: true,\n            passive: true,\n          },\n        );\n      } catch {\n        /* empty */\n      }\n    }, 100); // Need some time for the ion-input to create the input element\n  }\n}\n","import type { ElementRef } from '@angular/core';\nimport { DOCUMENT, inject, Injectable } from '@angular/core';\nimport { Platform } from '@ionic/angular/standalone';\nimport type { PluginListenerHandle } from '@capacitor/core';\nimport { Keyboard } from '@capacitor/keyboard';\n\n/**\n * How {@link KitKeyboardController.init} adjusts the target element when the native keyboard appears.\n *\n * - `transform` — CSS `translateY(-keyboardHeight + safeAreaBottom)` for a smooth iOS animation\n *   (typical for an `ion-footer`).\n * - `offset` — set the `--offset-bottom` custom property to the negative keyboard height.\n * - `keyboard-offset` — set the `--padding-bottom` custom property to the keyboard height.\n */\nexport type KitKeyboardAdjust = 'transform' | 'offset' | 'keyboard-offset';\n\n/**\n * Registers native keyboard listeners that reposition an element when the keyboard shows/hides.\n *\n * @remarks\n * A no-op on non-hybrid (web) platforms — `init` returns an empty handle list. On native it handles\n * iOS and Android differences (Android only toggles the `footer-toolbar-padding` class on an\n * `ion-footer` for the `transform` mode, working around an Ionic footer bug). The caller owns the\n * returned handles and must `remove()` them when the view is destroyed.\n *\n * @example\n * ```ts\n * export class ComposePage {\n *   readonly #keyboard = inject(KitKeyboardController);\n *   readonly #footer = viewChild.required<ElementRef>('footer');\n *   #handles: PluginListenerHandle[] = [];\n *\n *   async ngAfterViewInit() {\n *     this.#handles = await this.#keyboard.init(this.#footer(), 'transform');\n *   }\n *   ngOnDestroy() {\n *     this.#handles.forEach((h) => h.remove());\n *   }\n * }\n * ```\n */\n@Injectable({\n  providedIn: 'root',\n})\nexport class KitKeyboardController {\n  readonly #platform = inject(Platform);\n  readonly #document = inject(DOCUMENT);\n\n  /**\n   * Attach keyboard show/hide listeners that adjust `elementRef` per `type`.\n   *\n   * @param elementRef - The element to reposition (e.g. an `ion-footer`).\n   * @param type - The adjustment strategy; see {@link KitKeyboardAdjust}.\n   * @returns The registered listener handles (empty on non-native platforms).\n   */\n  async init(elementRef: ElementRef, type: KitKeyboardAdjust): Promise<PluginListenerHandle[]> {\n    if (!this.#platform.is('hybrid')) {\n      return [];\n    }\n    return [\n      await this.#keyboardWillShow(elementRef, type),\n      await this.#keyboardWillHide(elementRef, type),\n      await this.#keyboardDidShow(elementRef),\n      await this.#keyboardDidHide(elementRef),\n    ];\n  }\n\n  #keyboardWillShow(elementRef: ElementRef, type: KitKeyboardAdjust): Promise<PluginListenerHandle> {\n    return Keyboard.addListener('keyboardWillShow', (info) => {\n      if (this.#platform.is('android')) {\n        if (elementRef.nativeElement.tagName === 'ION-FOOTER' && type === 'transform') {\n          // https://github.com/ionic-team/ionic-framework/blob/main/core/src/components/footer/footer.tsx\n          elementRef.nativeElement.classList.remove('footer-toolbar-padding');\n        }\n        return;\n      }\n\n      elementRef.nativeElement.classList.add('show-keyboard');\n      const bodyStyleDeclaration = window.getComputedStyle(this.#document.querySelector('body') as Element);\n      const safeArea = parseInt(bodyStyleDeclaration.getPropertyValue('--ion-safe-area-bottom'), 10);\n\n      if (type === 'transform') {\n        elementRef.nativeElement.style.transition = 'transform 420ms';\n        elementRef.nativeElement.style.willChange = 'transform';\n        requestAnimationFrame(\n          () => (elementRef.nativeElement.style.transform = `translateY(${info.keyboardHeight * -1 + safeArea}px)`),\n        );\n      } else if (type === 'offset') {\n        requestAnimationFrame(() => {\n          const keyboardOffset = elementRef.nativeElement.style.getPropertyValue('--keyboard-offset');\n          if (!keyboardOffset || parseInt(keyboardOffset, 10) === 0) {\n            elementRef.nativeElement.style.setProperty('--offset-bottom', `${info.keyboardHeight * -1}px`);\n          }\n        });\n      } else {\n        requestAnimationFrame(() => {\n          const keyboardOffset = elementRef.nativeElement.style.getPropertyValue('--keyboard-offset');\n          if (!keyboardOffset || parseInt(keyboardOffset, 10) === 0) {\n            elementRef.nativeElement.style.setProperty('--padding-bottom', `${info.keyboardHeight}px`);\n          }\n        });\n      }\n    });\n  }\n\n  #keyboardWillHide(elementRef: ElementRef, type: KitKeyboardAdjust): Promise<PluginListenerHandle> {\n    return Keyboard.addListener('keyboardWillHide', () => {\n      if (this.#platform.is('android')) {\n        if (elementRef.nativeElement.tagName === 'ION-FOOTER' && type === 'transform') {\n          elementRef.nativeElement.classList.add('footer-toolbar-padding');\n        }\n        return;\n      }\n\n      elementRef.nativeElement.classList.remove('show-keyboard');\n\n      if (type === 'transform') {\n        elementRef.nativeElement.style.transition = 'transform 0ms';\n        elementRef.nativeElement.style.transform = `translateY(0px)`;\n        elementRef.nativeElement.style.willChange = 'transform';\n      } else if (type === 'offset') {\n        elementRef.nativeElement.style.setProperty('--offset-bottom', '0px');\n      } else {\n        elementRef.nativeElement.style.setProperty('--padding-bottom', '0px');\n      }\n    });\n  }\n\n  #keyboardDidShow(elementRef: ElementRef): Promise<PluginListenerHandle> {\n    return Keyboard.addListener('keyboardDidShow', () => {\n      elementRef.nativeElement.style.willChange = 'auto';\n    });\n  }\n\n  #keyboardDidHide(elementRef: ElementRef): Promise<PluginListenerHandle> {\n    return Keyboard.addListener('keyboardDidHide', () => {\n      elementRef.nativeElement.style.willChange = 'auto';\n    });\n  }\n}\n","import type { EnvironmentProviders } from '@angular/core';\nimport { inject, InjectionToken, makeEnvironmentProviders } from '@angular/core';\nimport type { CanActivateFn, RouterStateSnapshot, UrlTree } from '@angular/router';\nimport { Router } from '@angular/router';\nimport { NavController } from '@ionic/angular/standalone';\nimport type { Observable } from 'rxjs';\nimport { map, mergeMap } from 'rxjs/operators';\n\n/**\n * Discriminated set of authentication states the guards react to.\n *\n * @remarks\n * The application is responsible for emitting these values through {@link KitAuthConfig.authState}.\n * An application that does not use a value (for example email confirmation) simply never emits it.\n *\n * - `user` — fully authenticated and verified.\n * - `confirm` — awaiting email confirmation.\n * - `required` — not authenticated.\n * - `anonymous` — signed in anonymously; the user can still be guided toward full registration.\n */\nexport type KitAuthState = 'user' | 'confirm' | 'required' | 'anonymous';\n\n/**\n * Redirect targets (route paths) used by the guards when access is denied.\n *\n * @remarks\n * Every field is required and must be provided per application, because the guards have no\n * knowledge of the host application's route layout.\n */\nexport interface KitAuthRedirects {\n  /** Used by {@link kitRequiredUnauthorizedGuard}: where to navigate when the user is already authenticated (`user`). */\n  readonly whenAuthorized: string;\n  /** Used by {@link kitRequiredUnauthorizedGuard}: where to navigate when the user is awaiting email confirmation (`confirm`). */\n  readonly whenConfirming: string;\n  /** Used by {@link kitRequireConfirmingGuard}: where to navigate when the state is not `confirm`. */\n  readonly whenNotConfirming: string;\n  /** Used by {@link kitRequireAuthorizedGuard}: where to navigate when the state is not `user` and the fallback is not allowed. */\n  readonly whenUnauthorized: string;\n}\n\n/**\n * Configuration consumed by the authentication guards, injected through {@link provideKitAuth}.\n *\n * @remarks\n * `authState` and `redirects` are required. The `onAuthorized` / `onUnauthenticated` hooks are\n * optional and default to allowing the authenticated user through (`true`) and falling through to\n * the default redirect (`false`) respectively, so an app only supplies the ones with real logic.\n */\nexport interface KitAuthConfig {\n  /**\n   * Source of the current authentication state.\n   *\n   * @remarks\n   * Typically backed by the application's own auth service (for example `AuthService.isAuth()`).\n   *\n   * @returns A stream of {@link KitAuthState} values.\n   */\n  authState(): Observable<KitAuthState>;\n  /**\n   * Application-specific work that runs in {@link kitRequireAuthorizedGuard} after the state is confirmed to be `user`.\n   *\n   * @remarks\n   * Typical responsibilities include token login, permission checks, terms-of-service acceptance,\n   * or restoring a previously requested redirect. Optional; defaults to `true` (allow activation).\n   *\n   * @param state - The router state snapshot of the route being activated.\n   * @returns `true` to allow activation, or a `UrlTree` to perform a custom redirect.\n   */\n  onAuthorized?(state: RouterStateSnapshot): Promise<boolean | UrlTree>;\n  /**\n   * Fallback that runs in {@link kitRequireAuthorizedGuard} when the state is `required` (not authenticated).\n   *\n   * @remarks\n   * For example, attempt an anonymous sign-in and allow the route. Optional; defaults to `false`\n   * (fall through to the default `whenUnauthorized` redirect).\n   *\n   * @param state - The router state snapshot of the route being activated.\n   * @returns `true` to allow activation, a `UrlTree` for a custom redirect, or `false` to use the default redirect.\n   */\n  onUnauthenticated?(state: RouterStateSnapshot): Promise<boolean | UrlTree>;\n  /** Redirect targets used by the guards. */\n  redirects: KitAuthRedirects;\n}\n\n/**\n * Injection token that carries the {@link KitAuthConfig} to the authentication guards.\n */\nexport const KIT_AUTH_CONFIG = new InjectionToken<KitAuthConfig>('@rdlabo/ionic-angular-kit:auth');\n\n/**\n * Wire the authentication guard configuration into the application's dependency injection.\n *\n * @remarks\n * The factory runs inside an injection context, so it may call `inject()` (for example\n * `inject(AuthService)`) to build the configuration.\n *\n * @param configFactory - Factory that returns the {@link KitAuthConfig} for the application.\n * @returns Environment providers to add to the application bootstrap.\n *\n * @example\n * ```ts\n * provideKitAuth(() => {\n *   const auth = inject(AuthService);\n *   return {\n *     // onAuthorized / onUnauthenticated are optional (default: allow / fall through to redirect).\n *     authState: () => auth.isAuth(),\n *     redirects: {\n *       whenAuthorized: '/',\n *       whenConfirming: '/auth/confirm',\n *       whenNotConfirming: '/auth/signin',\n *       whenUnauthorized: 'auth',\n *     },\n *   };\n * });\n * ```\n */\nexport const provideKitAuth = (configFactory: () => KitAuthConfig): EnvironmentProviders =>\n  makeEnvironmentProviders([{ provide: KIT_AUTH_CONFIG, useFactory: configFactory }]);\n\n/**\n * Guard that requires the user to be unauthenticated (for example sign-in or sign-up pages).\n *\n * @remarks\n * Allows the `required` and `anonymous` states (an anonymous user is permitted to proceed to a\n * registration page). An authenticated user (`user`) is sent to `whenAuthorized`, and a user\n * awaiting confirmation (`confirm`) is sent to `whenConfirming`.\n *\n * @returns A stream emitting `true` to allow activation, or `false` after triggering a redirect.\n *\n * @example\n * ```ts\n * const routes: Routes = [{ path: 'signin', component: SigninPage, canActivate: [kitRequiredUnauthorizedGuard] }];\n * ```\n */\nexport const kitRequiredUnauthorizedGuard: CanActivateFn = () => {\n  const { authState, redirects } = inject(KIT_AUTH_CONFIG);\n  const router = inject(Router);\n  const navCtrl = inject(NavController);\n\n  return authState().pipe(\n    map((data) => {\n      if (data === 'user') {\n        navCtrl.setDirection('root');\n        router.navigate([redirects.whenAuthorized]);\n        return false;\n      } else if (data === 'confirm') {\n        router.navigate([redirects.whenConfirming]);\n        return false;\n      }\n      // 'required' | 'anonymous'\n      return true;\n    }),\n  );\n};\n\n/**\n * Guard that requires the user to be awaiting email confirmation (`confirm`).\n *\n * @remarks\n * Any other state triggers a redirect: an `anonymous` user is sent to the authenticated area\n * (`whenAuthorized`), and every remaining state is sent to `whenNotConfirming`.\n *\n * @returns A stream emitting `true` to allow activation, or `false` after triggering a redirect.\n *\n * @example\n * ```ts\n * const routes: Routes = [{ path: 'confirm', component: ConfirmPage, canActivate: [kitRequireConfirmingGuard] }];\n * ```\n */\nexport const kitRequireConfirmingGuard: CanActivateFn = () => {\n  const { authState, redirects } = inject(KIT_AUTH_CONFIG);\n  const router = inject(Router);\n  const navCtrl = inject(NavController);\n\n  return authState().pipe(\n    map((data) => {\n      if (data === 'confirm') {\n        return true;\n      }\n      navCtrl.setDirection('root');\n      router.navigate([data === 'anonymous' ? redirects.whenAuthorized : redirects.whenNotConfirming]);\n      return false;\n    }),\n  );\n};\n\n/**\n * Guard that requires the user to be fully authenticated (`user`).\n *\n * @remarks\n * - `user` — runs {@link KitAuthConfig.onAuthorized} (token login, permission checks, and so on).\n * - `anonymous` — allowed as-is, for applications that permit anonymous browsing.\n * - `required` / `confirm` — runs {@link KitAuthConfig.onUnauthenticated}; if it resolves to `false`,\n *   the user is redirected to `whenUnauthorized`.\n *\n * @param _route - The activated route snapshot (unused).\n * @param state - The router state snapshot, forwarded to the configuration hooks.\n * @returns A stream emitting the activation result: `true`, a `UrlTree`, or `false` after a redirect.\n *\n * @example\n * ```ts\n * const routes: Routes = [{ path: 'home', component: HomePage, canActivate: [kitRequireAuthorizedGuard] }];\n * ```\n */\nexport const kitRequireAuthorizedGuard: CanActivateFn = (_route, state) => {\n  const { authState, onAuthorized, onUnauthenticated, redirects } = inject(KIT_AUTH_CONFIG);\n  const router = inject(Router);\n  const navCtrl = inject(NavController);\n\n  return authState().pipe(\n    mergeMap(async (data) => {\n      if (data === 'user') {\n        // 既定は「許可」。tokenLogin / 権限確認等が必要なアプリだけ onAuthorized を渡す。\n        return onAuthorized ? onAuthorized(state) : true;\n      }\n      if (data === 'anonymous') {\n        return true;\n      }\n      // 既定は false（whenUnauthorized へ）。匿名ログイン等のフォールバックが要るアプリだけ渡す。\n      const fallback = onUnauthenticated ? await onUnauthenticated(state) : false;\n      if (fallback !== false) {\n        return fallback;\n      }\n      navCtrl.setDirection('root');\n      router.navigate([redirects.whenUnauthorized]);\n      return false;\n    }),\n  );\n};\n","import type { EnvironmentProviders } from '@angular/core';\nimport { inject, InjectionToken, makeEnvironmentProviders } from '@angular/core';\nimport type { HttpErrorResponse, HttpEvent, HttpInterceptorFn, HttpRequest } from '@angular/common/http';\nimport { HttpResponse } from '@angular/common/http';\nimport { Network } from '@capacitor/network';\nimport type { Observable } from 'rxjs';\nimport { from, retry, throwError, timer } from 'rxjs';\nimport { catchError, mergeMap, tap } from 'rxjs/operators';\n\n/**\n * HTTP methods that are safe to retry automatically.\n *\n * @remarks\n * Non-idempotent methods (`POST` / `PATCH` / `DELETE`) are never auto-retried, because a response\n * lost *after* the server processed the write would be replayed into a duplicate write (\"saved twice\n * from one tap\"). A non-idempotent request that is genuinely safe to replay opts in by carrying an\n * `Idempotency-Key` header (which the server must honor).\n *\n * @internal\n */\nconst RETRYABLE_METHODS = ['GET', 'HEAD', 'OPTIONS'];\n\n/**\n * Transient HTTP statuses worth retrying: `0` (network/transport failure), `408` (request timeout),\n * `429` (rate limited), and the `502` / `503` / `504` gateway-availability family. Every other status\n * is thrown immediately — a whitelist is safer than a blacklist for deciding what to replay.\n *\n * @internal\n */\nconst RETRYABLE_STATUSES = [0, 408, 429, 502, 503, 504];\n\n/**\n * Maximum number of automatic retries for a retryable request.\n *\n * @internal\n */\nconst MAX_RETRIES = 2;\n\n/**\n * Parse a `Retry-After` header (delta-seconds or an HTTP-date) into milliseconds, or `null` when it\n * is absent or unparseable.\n *\n * @internal\n */\nconst parseRetryAfterMs = (error: HttpErrorResponse): number | null => {\n  const header = error.headers?.get('Retry-After');\n  if (!header) {\n    return null;\n  }\n  const seconds = Number(header);\n  if (Number.isFinite(seconds)) {\n    return Math.max(0, seconds * 1000);\n  }\n  const dateMs = Date.parse(header);\n  return Number.isNaN(dateMs) ? null : Math.max(0, dateMs - Date.now());\n};\n\n/**\n * Configuration that customizes the behavior of {@link kitAuthInterceptor}, injected through {@link provideKitHttp}.\n *\n * @remarks\n * The interceptor fixes the retry policy and control flow; only the hooks below are app-specific:\n *\n * - Retries only {@link RETRYABLE_METHODS | idempotent methods} (or a request bearing an\n *   `Idempotency-Key`) on a {@link RETRYABLE_STATUSES | transient status}, up to {@link MAX_RETRIES}\n *   times with a short jittered backoff (honoring `Retry-After`). Writes are never auto-retried.\n * - When the device is offline it fails fast to {@link KitHttpConfig.offlineFallback} instead of\n *   waiting out the retries.\n * - On a final error it classifies by status and calls the matching hook (see each hook below).\n *\n * Only {@link KitHttpConfig.getAuthHeaders} is required — it has no safe default. Every other hook is\n * optional and defaults to a no-op (or `{}` / `false` / `null` as appropriate), so an app configures\n * only the behavior that actually differs from the canonical baseline.\n */\nexport interface KitHttpConfig {\n  /**\n   * Produce authentication and metadata headers for the outgoing request.\n   *\n   * @param request - The outgoing request about to be sent.\n   * @returns A map of header names to values, resolved asynchronously.\n   */\n  getAuthHeaders(request: HttpRequest<unknown>): Promise<Record<string, string>>;\n  /**\n   * Produce additional headers for the outgoing request.\n   *\n   * @remarks\n   * Optional; defaults to adding no extra headers.\n   *\n   * @param request - The outgoing request about to be sent.\n   * @returns A map of header names to values; return `{}` when none are needed.\n   */\n  buildExtraHeaders?(request: HttpRequest<unknown>): Record<string, string>;\n  /**\n   * Called for every successful response that completed an actual network round trip.\n   *\n   * @remarks\n   * Responses synthesized by {@link KitHttpConfig.offlineFallback} are produced after `catchError`\n   * and therefore never reach this hook, so it observes genuine successes only. A typical use is to\n   * reset an \"offline\" flag once connectivity is restored. Optional; defaults to a no-op.\n   *\n   * @param event - The successful `HttpResponse`.\n   */\n  onResponse?(event: HttpResponse<unknown>): void;\n  /**\n   * Decide whether to pass the request straight through, skipping auth, retry, and error handling.\n   *\n   * @remarks\n   * Useful for external URLs such as S3 or a CDN. Optional; defaults to `false` (never bypass).\n   *\n   * @param request - The outgoing request.\n   * @returns `true` to bypass the interceptor pipeline.\n   */\n  bypass?(request: HttpRequest<unknown>): boolean;\n  /**\n   * Provide an offline short-circuit when a request fails.\n   *\n   * @remarks\n   * Returning a non-null observable replaces the error with that response (for example a queued\n   * offline result). Optional; defaults to `null` (no fallback, normal error handling proceeds).\n   *\n   * @param request - The request that failed (after headers were applied).\n   * @param error - The error response that triggered the fallback.\n   * @returns A replacement event stream, or `null` for no fallback.\n   */\n  offlineFallback?(request: HttpRequest<unknown>, error: HttpErrorResponse): Observable<HttpEvent<unknown>> | null;\n  /**\n   * Side effect to run on a `401` response (for example an expired token).\n   *\n   * @remarks\n   * Optional; defaults to a no-op.\n   *\n   * @param request - The request that received the `401`.\n   */\n  onUnauthorized?(request: HttpRequest<unknown>): void;\n  /**\n   * Side effect to run on a `403` response (a permission error).\n   *\n   * @remarks\n   * Optional; defaults to a no-op.\n   *\n   * @param request - The request that received the `403`.\n   */\n  onForbidden?(request: HttpRequest<unknown>): void;\n  /**\n   * UX hook for a genuine network / transport failure (status `0`) while the device reports itself\n   * connected — i.e. the server is unreachable rather than the phone being offline.\n   *\n   * @remarks\n   * Optional; defaults to a no-op. Narrow by design: it fires only for status `0` (not for `404`,\n   * `429`, `5xx`, …, which have their own hooks), so a \"connection lost, reload?\" prompt is not shown\n   * for server-side problems. When the device is offline it is not called at all — `offlineFallback`\n   * owns that path. The kit ships {@link KitReloadAlertController} as the canonical implementation\n   * (with de-dup so concurrent failures show a single alert, and auto-dismiss on reconnect).\n   *\n   * @param status - The HTTP status code (`0`), or a string descriptor for non-HTTP failures.\n   * @returns Optionally a promise to await before continuing.\n   */\n  onNetworkError?(status: number | string): Promise<void> | void;\n  /**\n   * UX hook for a transient server-availability failure (`502` / `503` / `504`), fired after retries\n   * are exhausted.\n   *\n   * @remarks\n   * Optional; defaults to a no-op. Distinct from {@link KitHttpConfig.onNetworkError} — the device's\n   * connection is fine, the server is momentarily unavailable — so the app can say \"server busy, try\n   * again shortly\" rather than prompt a reload.\n   *\n   * @param status - `502`, `503`, or `504`.\n   * @param retryAfterSeconds - The server's `Retry-After` hint in seconds, when provided.\n   */\n  onServerBusy?(status: number, retryAfterSeconds?: number): void;\n  /**\n   * UX hook for a `429 Too Many Requests` response, fired after retries are exhausted.\n   *\n   * @remarks\n   * Optional; defaults to a no-op.\n   *\n   * @param retryAfterSeconds - The server's `Retry-After` hint in seconds, when provided.\n   */\n  onRateLimited?(retryAfterSeconds?: number): void;\n  /**\n   * UX hook for `400` / `422` / `500` responses that carry a server-provided message.\n   *\n   * @remarks\n   * Optional; defaults to a no-op. Note that the message comes straight from the API; prefer a\n   * user-facing `userMessage` / `code` in your error contract over showing a raw developer message.\n   *\n   * @param message - The message extracted from the error body.\n   */\n  onServerError?(message: string): void;\n  /**\n   * Side effect for a failure while *producing* the auth headers (`getAuthHeaders` rejected).\n   *\n   * @remarks\n   * Optional; defaults to a no-op. Because the request is never sent in this case, it does not reach\n   * the response-error hooks; classify it here (for example a failed token refresh) so it does not\n   * fail silently.\n   *\n   * @param request - The request whose headers could not be produced.\n   * @param error - The error thrown by `getAuthHeaders`.\n   */\n  onAuthError?(request: HttpRequest<unknown>, error: unknown): void;\n}\n\n/**\n * Injection token that carries the {@link KitHttpConfig} to {@link kitAuthInterceptor}.\n */\nexport const KIT_HTTP_CONFIG = new InjectionToken<KitHttpConfig>('@rdlabo/ionic-angular-kit:http');\n\n/**\n * Wire the {@link kitAuthInterceptor} configuration into the application's dependency injection.\n *\n * @remarks\n * Register the interceptor itself separately via `provideHttpClient(withInterceptors([kitAuthInterceptor]))`.\n * The factory runs inside an injection context, so it may call `inject()`.\n *\n * @param configFactory - Factory that returns the {@link KitHttpConfig} for the application.\n * @returns Environment providers to add to the application bootstrap.\n *\n * @example\n * ```ts\n * bootstrapApplication(AppComponent, {\n *   providers: [\n *     provideHttpClient(withInterceptors([kitAuthInterceptor])),\n *     provideKitHttp(() => {\n *       const auth = inject(AuthService);\n *       const reload = inject(KitReloadAlertController);\n *       return {\n *         // Only getAuthHeaders is required; every other hook is optional and defaults to a no-op.\n *         getAuthHeaders: async () => ({ Authorization: `Bearer ${await auth.token()}` }),\n *         onUnauthorized: () => auth.signOut(),\n *         onNetworkError: (status) =>\n *           reload.present({ header: 'Network error', message: `Reload? (${status})`, okText: 'Reload' }),\n *         onResponse: () => void reload.dismiss(),\n *       };\n *     }),\n *   ],\n * });\n * ```\n */\nexport const provideKitHttp = (configFactory: () => KitHttpConfig): EnvironmentProviders =>\n  makeEnvironmentProviders([{ provide: KIT_HTTP_CONFIG, useFactory: configFactory }]);\n\n/**\n * Classify a final (post-retry) error and invoke the matching {@link KitHttpConfig} hook.\n *\n * @internal\n */\nconst dispatchError = (config: KitHttpConfig, req: HttpRequest<unknown>, error: HttpErrorResponse): void => {\n  const status = error.status;\n  const retryAfterMs = parseRetryAfterMs(error);\n  const retryAfterSeconds = retryAfterMs === null ? undefined : Math.round(retryAfterMs / 1000);\n\n  if (status === 401) {\n    config.onUnauthorized?.(req);\n  } else if (status === 403) {\n    config.onForbidden?.(req);\n  } else if (status === 0) {\n    // Genuine network/transport failure. Only surface it when the device is actually connected\n    // (server unreachable); when offline, offlineFallback owns the UX — a reload prompt won't help.\n    void Network.getStatus().then((network) => {\n      if (network.connected) {\n        config.onNetworkError?.(status);\n      }\n    });\n  } else if (status === 429) {\n    config.onRateLimited?.(retryAfterSeconds);\n  } else if ([502, 503, 504].includes(status)) {\n    config.onServerBusy?.(status, retryAfterSeconds);\n  } else if ([400, 422, 500].includes(status) && error.error?.message) {\n    config.onServerError?.(error.error.message);\n  }\n  // Every other status (404, 418, …) is left to the caller — no generic alert.\n};\n\n/**\n * Canonical functional HTTP interceptor that applies authentication, retries, and error handling.\n *\n * @remarks\n * Behavior, driven by the injected {@link KitHttpConfig}:\n *\n * 1. Requests for which `bypass` returns `true` are forwarded untouched.\n * 2. If `getAuthHeaders` rejects, `onAuthError` is called and the request is not sent.\n * 3. Otherwise the headers from `getAuthHeaders` and `buildExtraHeaders` are merged onto a cloned request.\n * 4. On failure the request is retried up to {@link MAX_RETRIES} times, but **only** when the device\n *    is online, the method is a {@link RETRYABLE_METHODS | retryable method} (or carries an\n *    `Idempotency-Key`), and the status is a {@link RETRYABLE_STATUSES | transient status}. The\n *    backoff is `retryCount * 500ms` plus up to 250ms of jitter, or the server's `Retry-After`.\n *    When the device is offline it stops retrying immediately.\n * 5. On the final error, `offlineFallback` is consulted first; otherwise the error is classified by\n *    status (see {@link dispatchError}): `401`→`onUnauthorized`, `403`→`onForbidden`, `0`→\n *    `onNetworkError` (when connected), `429`→`onRateLimited`, `502`/`503`/`504`→`onServerBusy`, and\n *    `400`/`422`/`500` with a body message→`onServerError`.\n *\n * @param request - The outgoing request.\n * @param next - The next handler in the interceptor chain.\n * @returns A stream of HTTP events for the (possibly modified, retried, or replaced) request.\n *\n * @example\n * ```ts\n * provideHttpClient(withInterceptors([kitAuthInterceptor]));\n * ```\n */\nexport const kitAuthInterceptor: HttpInterceptorFn = (request, next) => {\n  const config = inject(KIT_HTTP_CONFIG);\n\n  if (config.bypass?.(request)) {\n    return next(request);\n  }\n\n  return from(Promise.resolve(config.getAuthHeaders(request))).pipe(\n    catchError((headerError: unknown) => {\n      // getAuthHeaders failed → the request is never sent; classify it instead of failing silently.\n      config.onAuthError?.(request, headerError);\n      return throwError(() => headerError);\n    }),\n    mergeMap((authHeaders) => {\n      const req = request.clone({ setHeaders: { ...authHeaders, ...config.buildExtraHeaders?.(request) } });\n      const retryable = RETRYABLE_METHODS.includes(req.method) || req.headers.has('Idempotency-Key');\n\n      return next(req).pipe(\n        retry({\n          count: MAX_RETRIES,\n          delay: (error: HttpErrorResponse, retryCount: number) =>\n            from(Network.getStatus()).pipe(\n              mergeMap((network) => {\n                // Offline → don't wait out the retries; fail fast so offlineFallback can take over.\n                if (!network.connected) {\n                  return throwError(() => error);\n                }\n                // Only replay idempotent requests, and only on a transient status.\n                if (!retryable || !RETRYABLE_STATUSES.includes(error.status)) {\n                  return throwError(() => error);\n                }\n                // Short linear backoff (500ms, 1000ms, …) plus jitter to de-correlate a fleet of\n                // clients reconnecting at once; the server's Retry-After wins when present.\n                const backoff = parseRetryAfterMs(error) ?? retryCount * 500 + Math.random() * 250;\n                return timer(backoff);\n              }),\n            ),\n        }),\n        tap((event) => {\n          if (event instanceof HttpResponse) {\n            config.onResponse?.(event);\n          }\n        }),\n        catchError((error: HttpErrorResponse) => {\n          const fallback = config.offlineFallback?.(req, error);\n          if (fallback) {\n            return fallback;\n          }\n          dispatchError(config, req, error);\n          return throwError(() => error);\n        }),\n      );\n    }),\n  );\n};\n","/**\n * Merge a newly fetched page of items into an existing list by id, keeping the result sorted.\n *\n * Items are merged by the numeric `key` field. On a duplicate `key` the item from `arrayNew` wins\n * and replaces the one in `arrayOld`. Old items whose `key` falls *inside* the window spanned by\n * `arrayNew` (between its first and last `key`) are dropped, since the freshly fetched page is the\n * authoritative copy of that window; old items *outside* the window are kept. The merged items are\n * finally sorted by `key`, ascending or descending according to `order`.\n *\n * The algorithm is:\n * 1. If both inputs are empty, return an empty array.\n * 2. Read the first (`lead`) and last (`last`) `key` values of `arrayNew` as the bounds of the\n *    page's window. Keep the old items whose `key` lies *outside* that window (at or beyond the\n *    extremes) and drop those strictly inside it, handling both a high-to-low page (`lead > last`)\n *    and a low-to-high page (`lead < last`). A single-value page (`lead === last`) keeps all old items.\n * 3. Remove old items whose `key` already exists in `arrayNew` (new wins on duplicates).\n * 4. Concatenate `arrayNew` with the surviving old items and sort by `key` in the requested\n *    direction.\n *\n * @remarks\n * Designed for infinite-scroll / paginated list merging, where each fetched page may overlap the\n * previously held items and the server returns a contiguous, ordered window of records. The `key`\n * field is treated as a number for range comparison and sorting.\n *\n * @typeParam T - Element type of both arrays. Its `key` property must be a numeric value.\n * @param arrayOld - The previously accumulated list. May be empty or nullish-safe (empty when falsy).\n * @param arrayNew - The newly fetched page of items; its `key` range defines the window that its own\n *   items replace, and its items take precedence on duplicates.\n * @param key - The property of `T` used as the unique, numeric id for matching, range filtering, and sorting.\n * @param order - Sort direction by `key`: `'ASC'` for ascending or `'DESC'` for descending. Defaults to `'DESC'`.\n * @param secondaryKey - Optional second property for extra de-duplication. When provided, any\n *   surviving old item whose `secondaryKey` value matches that of *any* new item is dropped before\n *   the `key` merge. Useful when a record keeps a stable `key` but its secondary identity changes\n *   between pages (e.g. items keyed by `id` but also grouped by `parentId`). Omit to skip this step.\n * @returns A new array containing `arrayNew` merged with the out-of-window, non-duplicate old items, sorted by `key`.\n * @example\n * ```ts\n * interface Post {\n *   id: number;\n *   title: string;\n * }\n *\n * const loaded: Post[] = [\n *   { id: 30, title: 'c' },\n *   { id: 20, title: 'b' },\n *   { id: 10, title: 'a' },\n * ];\n * const nextPage: Post[] = [\n *   { id: 20, title: 'b (updated)' },\n *   { id: 15, title: 'a.5' },\n * ];\n *\n * // Descending merge: id 30 lies above the new page's [15, 20] window so it is kept; id 20 is\n * // inside the window and is replaced by the new value; id 10 lies below the window and is kept.\n * const merged = arrayConcatById(loaded, nextPage, 'id', 'DESC');\n * // => [{ id: 30, title: 'c' }, { id: 20, title: 'b (updated)' }, { id: 15, title: 'a.5' }, { id: 10, title: 'a' }]\n * ```\n */\nexport const arrayConcatById = <T>(\n  arrayOld: T[],\n  arrayNew: T[],\n  key: keyof T,\n  order: 'ASC' | 'DESC' = 'DESC',\n  secondaryKey?: keyof T,\n): T[] => {\n  if (!arrayNew.length && !arrayOld.length) {\n    return [];\n  }\n  const lead = arrayNew[0][key] as number;\n  const last = arrayNew[arrayNew.length - 1][key] as number;\n\n  const filteredOld = (arrayOld || []).filter((vol) => {\n    const value = vol[key] as number;\n    return (lead > last && (value >= lead || value <= last)) || (lead < last && (value <= lead || value >= last)) || lead === last;\n  });\n\n  const secondaryFilteredOld = secondaryKey\n    ? filteredOld.filter((vol) => !arrayNew.some((element) => element[secondaryKey] === vol[secondaryKey]))\n    : filteredOld;\n\n  const oldData = secondaryFilteredOld.filter((vol) => !arrayNew.some((element) => element[key] === vol[key]));\n  const data = arrayNew.concat(oldData);\n\n  const direction = order === 'ASC' ? 1 : -1;\n  return data.sort((a, b) => {\n    const x = a[key] as number;\n    const y = b[key] as number;\n    if (x > y) {\n      return direction;\n    }\n    if (x < y) {\n      return direction * -1;\n    }\n    return 0;\n  });\n};\n","/**\n * Order-independent deep equality check.\n *\n * @remarks\n * Returns `true` when `a` and `b` serialize to the same value after their (nested) object entries are\n * sorted by key, so property order does not affect the result. Intended for cheap \"did this state\n * object change?\" comparisons.\n *\n * Caveats of the JSON-serialization approach: values that JSON drops or coerces (`undefined`,\n * functions, `NaN`, `Date`, `Map`/`Set`) are compared by their serialized form, and array element\n * order is treated as significant (arrays are not reordered in a meaningful way). Use a structural\n * deep-equal library when those cases matter.\n *\n * @param a - First object.\n * @param b - Second object.\n * @returns `true` when the two objects are deeply equal ignoring key order.\n * @example\n * ```ts\n * objectEqual({ a: 1, b: 2 }, { b: 2, a: 1 }); // => true\n * objectEqual({ a: 1 }, { a: 2 });             // => false\n * ```\n */\nexport const objectEqual = (a: object, b: object): boolean => {\n  if (Object.is(a, b)) {\n    return true;\n  }\n  const sortDeep = (obj: unknown): unknown => {\n    if (typeof obj !== 'object' || !obj) {\n      return undefined;\n    }\n    return Object.entries(obj)\n      .sort()\n      .map(([entryKey, value]) => [entryKey, typeof value === 'object' ? sortDeep(value) : value]);\n  };\n  return JSON.stringify(sortDeep(a)) === JSON.stringify(sortDeep(b));\n};\n","/**\n * Disable the button that triggered an event while an async operation runs, re-enabling it after.\n *\n * @remarks\n * Prevents the common double-submit / double-tap bug: the `event.target` button is disabled, the\n * work is awaited, and the button is re-enabled — even if the work rejects (the rejection is\n * swallowed here so the button always recovers; handle errors inside `work` if you need to react).\n *\n * @param event - The DOM event whose `target` is the button to disable (e.g. a click event).\n * @param work - The async operation to run while the button is disabled.\n * @returns A Promise that resolves once the work has settled and the button has been re-enabled.\n * @example\n * ```ts\n * async submit(event: Event): Promise<void> {\n *   await disableHandler(event, this.save());\n * }\n * ```\n */\nexport const disableHandler = async (event: Event, work: Promise<void | boolean>): Promise<void> => {\n  const target = event.target as HTMLButtonElement;\n  target.disabled = true;\n  await work.catch((): undefined => undefined);\n  target.disabled = false;\n};\n","/*\n * Public API Surface of @rdlabo/ionic-angular-kit\n */\n\n// Storage: typed wrapper around the platform key/value store.\nexport * from './lib/storage/kit-storage.service';\n\n// Overlay: wrapper around the Ionic Modal / Toast / Alert controllers.\nexport * from './lib/overlay/overlay-config';\nexport * from './lib/overlay/kit-overlay.controller';\nexport * from './lib/overlay/kit-reload-alert.controller';\nexport * from './lib/overlay/kit-auth-failed-alert';\n\n// Directives.\nexport * from './lib/directives/autofill.directive';\n\n// Keyboard: native keyboard reposition listeners.\nexport * from './lib/keyboard/kit-keyboard.controller';\n\n// Auth: functional route guards.\nexport * from './lib/auth/auth-guards';\n\n// HTTP: functional interceptor.\nexport * from './lib/http/kit-http.interceptor';\n\n// Utils: framework-agnostic pure helpers.\nexport * from './lib/utils/haptics';\nexport * from './lib/utils/array';\nexport * from './lib/utils/object';\nexport * from './lib/utils/dom';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rdlabo/ionic-angular-kit",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",

package/types/rdlabo-ionic-angular-kit.d.ts

@@ -226,8 +226,12 @@ declare class KitOverlayController {
      * from the configured labels; any of these can be overridden via `options`. Presenting a toast
      * also triggers light native haptic feedback as an intentional kit UX choice.
      *
-     * Bottom is the fleet-wide default (top left the toast fighting the tab bar and the keyboard); an
-     * app that wants it elsewhere passes `position` / `positionAnchor` in `options`.
+     * Bottom is the fleet-wide default (top left the toast fighting the tab bar and the keyboard).
+     * For a bottom toast with no explicit `positionAnchor`, if a visible `ion-tab-bar` is present the
+     * toast is automatically anchored above it (Ionic places a bottom toast above its `positionAnchor`),
+     * so the toast never sits behind the tabs. Avoiding the on-screen keyboard is handled by the native
+     * keyboard resize — the anchored/bottom toast rides the shrinking viewport above the keyboard;
+     * Ionic itself has no toast keyboard-avoidance option. An app can override either via `options`.
      *
      * @param options - Ionic toast options that override the kit defaults
      * @returns the presented toast element
@@ -634,9 +638,14 @@ declare const kitRequireAuthorizedGuard: CanActivateFn;
  * Configuration that customizes the behavior of {@link kitAuthInterceptor}, injected through {@link provideKitHttp}.
  *
  * @remarks
- * The interceptor fixes the retry policy (up to 2 retries with a linearly increasing backoff, plus immediate
- * throw on `401` and on every {@link NON_RETRYABLE_STATUSES | non-retryable status}) and the overall
- * control flow. Only the hooks below are application-specific.
+ * The interceptor fixes the retry policy and control flow; only the hooks below are app-specific:
+ *
+ * - Retries only {@link RETRYABLE_METHODS | idempotent methods} (or a request bearing an
+ *   `Idempotency-Key`) on a {@link RETRYABLE_STATUSES | transient status}, up to {@link MAX_RETRIES}
+ *   times with a short jittered backoff (honoring `Retry-After`). Writes are never auto-retried.
+ * - When the device is offline it fails fast to {@link KitHttpConfig.offlineFallback} instead of
+ *   waiting out the retries.
+ * - On a final error it classifies by status and calls the matching hook (see each hook below).
  *
  * Only {@link KitHttpConfig.getAuthHeaders} is required — it has no safe default. Every other hook is
  * optional and defaults to a no-op (or `{}` / `false` / `null` as appropriate), so an app configures
@@ -712,25 +721,64 @@ interface KitHttpConfig {
      */
     onForbidden?(request: HttpRequest<unknown>): void;
     /**
-     * UX hook for network-originated errors while the device is connected.
+     * UX hook for a genuine network / transport failure (status `0`) while the device reports itself
+     * connected — i.e. the server is unreachable rather than the phone being offline.
      *
      * @remarks
-     * Optional; defaults to a no-op. The kit ships {@link KitReloadAlertController} as the fleet's
-     * canonical implementation of this hook (with auto-dismiss on reconnect via `onResponse`).
+     * Optional; defaults to a no-op. Narrow by design: it fires only for status `0` (not for `404`,
+     * `429`, `5xx`, …, which have their own hooks), so a "connection lost, reload?" prompt is not shown
+     * for server-side problems. When the device is offline it is not called at all — `offlineFallback`
+     * owns that path. The kit ships {@link KitReloadAlertController} as the canonical implementation
+     * (with de-dup so concurrent failures show a single alert, and auto-dismiss on reconnect).
      *
-     * @param status - The HTTP status code, or a string descriptor for non-HTTP failures.
+     * @param status - The HTTP status code (`0`), or a string descriptor for non-HTTP failures.
      * @returns Optionally a promise to await before continuing.
      */
     onNetworkError?(status: number | string): Promise<void> | void;
     /**
-     * UX hook for `400` / `500` responses that carry a server-provided message.
+     * UX hook for a transient server-availability failure (`502` / `503` / `504`), fired after retries
+     * are exhausted.
+     *
+     * @remarks
+     * Optional; defaults to a no-op. Distinct from {@link KitHttpConfig.onNetworkError} — the device's
+     * connection is fine, the server is momentarily unavailable — so the app can say "server busy, try
+     * again shortly" rather than prompt a reload.
+     *
+     * @param status - `502`, `503`, or `504`.
+     * @param retryAfterSeconds - The server's `Retry-After` hint in seconds, when provided.
+     */
+    onServerBusy?(status: number, retryAfterSeconds?: number): void;
+    /**
+     * UX hook for a `429 Too Many Requests` response, fired after retries are exhausted.
      *
      * @remarks
      * Optional; defaults to a no-op.
      *
+     * @param retryAfterSeconds - The server's `Retry-After` hint in seconds, when provided.
+     */
+    onRateLimited?(retryAfterSeconds?: number): void;
+    /**
+     * UX hook for `400` / `422` / `500` responses that carry a server-provided message.
+     *
+     * @remarks
+     * Optional; defaults to a no-op. Note that the message comes straight from the API; prefer a
+     * user-facing `userMessage` / `code` in your error contract over showing a raw developer message.
+     *
      * @param message - The message extracted from the error body.
      */
     onServerError?(message: string): void;
+    /**
+     * Side effect for a failure while *producing* the auth headers (`getAuthHeaders` rejected).
+     *
+     * @remarks
+     * Optional; defaults to a no-op. Because the request is never sent in this case, it does not reach
+     * the response-error hooks; classify it here (for example a failed token refresh) so it does not
+     * fail silently.
+     *
+     * @param request - The request whose headers could not be produced.
+     * @param error - The error thrown by `getAuthHeaders`.
+     */
+    onAuthError?(request: HttpRequest<unknown>, error: unknown): void;
 }
 /**
  * Injection token that carries the {@link KitHttpConfig} to {@link kitAuthInterceptor}.
@@ -775,14 +823,17 @@ declare const provideKitHttp: (configFactory: () => KitHttpConfig) => Environmen
  * Behavior, driven by the injected {@link KitHttpConfig}:
  *
  * 1. Requests for which `bypass` returns `true` are forwarded untouched.
- * 2. Otherwise the headers from `getAuthHeaders` and `buildExtraHeaders` are merged onto a cloned request.
- * 3. Failed requests are retried up to 2 times with a linearly increasing backoff of `500ms * (retryCount + 5)`,
- *    except that `401` and any {@link NON_RETRYABLE_STATUSES | non-retryable status}
- *    (`400`, `403`, `404`, `418`, `500`, `502`) are thrown immediately without retrying.
- * 4. On error, `offlineFallback` is consulted first; otherwise `401` calls `onUnauthorized`, `403`
- *    calls `onForbidden`, network-class failures (anything other than `400`/`500`) call
- *    `onNetworkError` when the device is connected, and `400`/`500` responses carrying a body
- *    message call `onServerError`.
+ * 2. If `getAuthHeaders` rejects, `onAuthError` is called and the request is not sent.
+ * 3. Otherwise the headers from `getAuthHeaders` and `buildExtraHeaders` are merged onto a cloned request.
+ * 4. On failure the request is retried up to {@link MAX_RETRIES} times, but **only** when the device
+ *    is online, the method is a {@link RETRYABLE_METHODS | retryable method} (or carries an
+ *    `Idempotency-Key`), and the status is a {@link RETRYABLE_STATUSES | transient status}. The
+ *    backoff is `retryCount * 500ms` plus up to 250ms of jitter, or the server's `Retry-After`.
+ *    When the device is offline it stops retrying immediately.
+ * 5. On the final error, `offlineFallback` is consulted first; otherwise the error is classified by
+ *    status (see {@link dispatchError}): `401`→`onUnauthorized`, `403`→`onForbidden`, `0`→
+ *    `onNetworkError` (when connected), `429`→`onRateLimited`, `502`/`503`/`504`→`onServerBusy`, and
+ *    `400`/`422`/`500` with a body message→`onServerError`.
  *
  * @param request - The outgoing request.
  * @param next - The next handler in the interceptor chain.