@rdlabo/ionic-angular-kit 0.0.5 → 0.0.6

package/README.md

@@ -147,6 +147,12 @@ presentModal<O>(
   options?: KitModalPresentOptions,   // Omit<ModalOptions, 'component'|'componentProps'> + watchKeyboard?
 ): Promise<O | undefined>
 
+presentPopover<O>(
+  component: PopoverOptions['component'],
+  componentProps?: PopoverOptions['componentProps'],
+  options?: Omit<PopoverOptions, 'component'|'componentProps'>,   // e.g. { event } to anchor it
+): Promise<O | undefined>
+
 presentToast(options: ToastOptions): Promise<HTMLIonToastElement>
 // kit defaults: position='top', duration=2000, swipeGesture='vertical'
 // caller options spread over the defaults — any field can be overridden
@@ -163,6 +169,16 @@ alertConfirm(options: {
 
 `watchKeyboard: true` (on `presentModal` options) expands a bottom sheet to full height when the native keyboard appears (iOS/Android only; no-op on web).
 
+**Best practice — the modal launcher pattern.** Never call `modalController.create(...)` inline in a component. Instead, each modal/popover page exports a typed launcher next to itself and every call site goes through `KitOverlayController`:
+
+```typescript
+// detail.page.ts
+export const launchDetailPage = (overlay: KitOverlayController, props: DetailProps): Promise<DetailResult | undefined> =>
+  overlay.presentModal<DetailResult>(DetailPage, props, { backdropDismiss: false });
+```
+
+This centralizes presentation options, keeps component props and dismiss data type-safe, and makes every modal discoverable. A well-disciplined app has **zero** inline `controller.create()` calls.
+
 ---
 
 ### Auth guards + provideKitAuth
@@ -359,6 +375,58 @@ The directive is a no-op on non-iOS platforms.
 
 ---
 
+### KitKeyboardController
+
+Registers native keyboard show/hide listeners that reposition an element when the soft keyboard appears — useful for a footer input bar that must stay above the keyboard. A no-op on web (`init` returns `[]`); on native it handles the iOS/Android differences. Three adjustment strategies:
+
+- `transform` — `translateY(-keyboardHeight + safeAreaBottom)` (smooth iOS animation; typical for `ion-footer`)
+- `offset` — sets the `--offset-bottom` custom property
+- `keyboard-offset` — sets the `--padding-bottom` custom property
+
+```typescript
+import { KitKeyboardController } from '@rdlabo/ionic-angular-kit';
+
+export class ComposePage {
+  readonly #keyboard = inject(KitKeyboardController);
+  readonly #footer = viewChild.required<ElementRef>('footer');
+  #handles: PluginListenerHandle[] = [];
+
+  async ngAfterViewInit() {
+    this.#handles = await this.#keyboard.init(this.#footer(), 'transform');
+  }
+  ngOnDestroy() {
+    this.#handles.forEach((h) => h.remove()); // caller owns the handles
+  }
+}
+```
+
+---
+
+### Utilities
+
+Framework-agnostic helpers (no DI required unless noted):
+
+```typescript
+import { kitImpact, arrayConcatById, objectEqual, disableHandler } from '@rdlabo/ionic-angular-kit';
+
+// Native light haptic (no-op on web).
+await kitImpact();
+
+// Merge a paginated page into an existing list by numeric id, sorted; new items win on duplicates.
+// Optional 5th arg `secondaryKey` drops old items sharing that secondary field with any new item.
+const merged = arrayConcatById(loaded, nextPage, 'id', 'DESC', 'parentId');
+
+// Order-independent deep equality (sorted-entries JSON) for cheap "did this state change?" checks.
+if (!objectEqual(prev, next)) { /* changed */ }
+
+// Disable the clicked button while an async op runs, re-enabling it after (even on error).
+async onSubmit(event: Event) {
+  await disableHandler(event, this.save());
+}
+```
+
+---
+
 ## Consumer Vitest setup notes
 
 When testing a consumer app that declares `@rdlabo/ionic-angular-kit` as a `file:` symlink dependency, add the following to your `vitest.config.ts`:

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

@@ -1,7 +1,7 @@
 import * as i0 from '@angular/core';
-import { inject, Injectable, InjectionToken, makeEnvironmentProviders, ElementRef, Directive } from '@angular/core';
+import { inject, Injectable, InjectionToken, makeEnvironmentProviders, ElementRef, Directive, DOCUMENT } from '@angular/core';
 import { Storage } from '@ionic/storage-angular';
-import { ModalController, ToastController, AlertController, NavController } from '@ionic/angular/standalone';
+import { ModalController, PopoverController, ToastController, AlertController, Platform, NavController } from '@ionic/angular/standalone';
 import { Capacitor } from '@capacitor/core';
 import { Keyboard } from '@capacitor/keyboard';
 import { ImpactStyle, Haptics } from '@capacitor/haptics';
@@ -189,6 +189,7 @@ const watchModalKeyboard = async (modal) => {
  */
 class KitOverlayController {
     #modalCtrl = inject(ModalController);
+    #popoverCtrl = inject(PopoverController);
     #toastCtrl = inject(ToastController);
     #alertCtrl = inject(AlertController);
     #labels = inject(KIT_OVERLAY_CONFIG).labels;
@@ -214,6 +215,25 @@ class KitOverlayController {
         await handle?.remove();
         return data;
     }
+    /**
+     * Present a popover and resolve with the data passed to its dismissal.
+     *
+     * @typeParam O - type of the data returned when the popover is dismissed
+     * @param component - the component to render inside the popover
+     * @param componentProps - props to pass to the popover component
+     * @param options - additional popover options (for example `event` to anchor it, or `cssClass`)
+     * @returns the dismiss data, or `undefined` when the popover is dismissed without data
+     * @example
+     * ```ts
+     * const choice = await overlay.presentPopover<MenuChoice>(MenuPopover, { items }, { event });
+     * ```
+     */
+    async presentPopover(component, componentProps, options = {}) {
+        const popover = await this.#popoverCtrl.create({ component, componentProps, ...options });
+        await popover.present();
+        const { data } = await popover.onDidDismiss();
+        return data;
+    }
     /**
      * Present a toast using kit defaults that the caller may override.
      *
@@ -508,6 +528,129 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
                 }]
         }], ctorParameters: () => [] });
 
+/**
+ * Registers native keyboard listeners that reposition an element when the keyboard shows/hides.
+ *
+ * @remarks
+ * A no-op on non-hybrid (web) platforms — `init` returns an empty handle list. On native it handles
+ * iOS and Android differences (Android only toggles the `footer-toolbar-padding` class on an
+ * `ion-footer` for the `transform` mode, working around an Ionic footer bug). The caller owns the
+ * returned handles and must `remove()` them when the view is destroyed.
+ *
+ * @example
+ * ```ts
+ * export class ComposePage {
+ *   readonly #keyboard = inject(KitKeyboardController);
+ *   readonly #footer = viewChild.required<ElementRef>('footer');
+ *   #handles: PluginListenerHandle[] = [];
+ *
+ *   async ngAfterViewInit() {
+ *     this.#handles = await this.#keyboard.init(this.#footer(), 'transform');
+ *   }
+ *   ngOnDestroy() {
+ *     this.#handles.forEach((h) => h.remove());
+ *   }
+ * }
+ * ```
+ */
+class KitKeyboardController {
+    #platform = inject(Platform);
+    #document = inject(DOCUMENT);
+    /**
+     * Attach keyboard show/hide listeners that adjust `elementRef` per `type`.
+     *
+     * @param elementRef - The element to reposition (e.g. an `ion-footer`).
+     * @param type - The adjustment strategy; see {@link KitKeyboardAdjust}.
+     * @returns The registered listener handles (empty on non-native platforms).
+     */
+    async init(elementRef, type) {
+        if (!this.#platform.is('hybrid')) {
+            return [];
+        }
+        return [
+            await this.#keyboardWillShow(elementRef, type),
+            await this.#keyboardWillHide(elementRef, type),
+            await this.#keyboardDidShow(elementRef),
+            await this.#keyboardDidHide(elementRef),
+        ];
+    }
+    #keyboardWillShow(elementRef, type) {
+        return Keyboard.addListener('keyboardWillShow', (info) => {
+            if (this.#platform.is('android')) {
+                if (elementRef.nativeElement.tagName === 'ION-FOOTER' && type === 'transform') {
+                    // https://github.com/ionic-team/ionic-framework/blob/main/core/src/components/footer/footer.tsx
+                    elementRef.nativeElement.classList.remove('footer-toolbar-padding');
+                }
+                return;
+            }
+            elementRef.nativeElement.classList.add('show-keyboard');
+            const bodyStyleDeclaration = window.getComputedStyle(this.#document.querySelector('body'));
+            const safeArea = parseInt(bodyStyleDeclaration.getPropertyValue('--ion-safe-area-bottom'), 10);
+            if (type === 'transform') {
+                elementRef.nativeElement.style.transition = 'transform 420ms';
+                elementRef.nativeElement.style.willChange = 'transform';
+                requestAnimationFrame(() => (elementRef.nativeElement.style.transform = `translateY(${info.keyboardHeight * -1 + safeArea}px)`));
+            }
+            else if (type === 'offset') {
+                requestAnimationFrame(() => {
+                    const keyboardOffset = elementRef.nativeElement.style.getPropertyValue('--keyboard-offset');
+                    if (!keyboardOffset || parseInt(keyboardOffset, 10) === 0) {
+                        elementRef.nativeElement.style.setProperty('--offset-bottom', `${info.keyboardHeight * -1}px`);
+                    }
+                });
+            }
+            else {
+                requestAnimationFrame(() => {
+                    const keyboardOffset = elementRef.nativeElement.style.getPropertyValue('--keyboard-offset');
+                    if (!keyboardOffset || parseInt(keyboardOffset, 10) === 0) {
+                        elementRef.nativeElement.style.setProperty('--padding-bottom', `${info.keyboardHeight}px`);
+                    }
+                });
+            }
+        });
+    }
+    #keyboardWillHide(elementRef, type) {
+        return Keyboard.addListener('keyboardWillHide', () => {
+            if (this.#platform.is('android')) {
+                if (elementRef.nativeElement.tagName === 'ION-FOOTER' && type === 'transform') {
+                    elementRef.nativeElement.classList.add('footer-toolbar-padding');
+                }
+                return;
+            }
+            elementRef.nativeElement.classList.remove('show-keyboard');
+            if (type === 'transform') {
+                elementRef.nativeElement.style.transition = 'transform 0ms';
+                elementRef.nativeElement.style.transform = `translateY(0px)`;
+                elementRef.nativeElement.style.willChange = 'transform';
+            }
+            else if (type === 'offset') {
+                elementRef.nativeElement.style.setProperty('--offset-bottom', '0px');
+            }
+            else {
+                elementRef.nativeElement.style.setProperty('--padding-bottom', '0px');
+            }
+        });
+    }
+    #keyboardDidShow(elementRef) {
+        return Keyboard.addListener('keyboardDidShow', () => {
+            elementRef.nativeElement.style.willChange = 'auto';
+        });
+    }
+    #keyboardDidHide(elementRef) {
+        return Keyboard.addListener('keyboardDidHide', () => {
+            elementRef.nativeElement.style.willChange = 'auto';
+        });
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: KitKeyboardController, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: KitKeyboardController, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: KitKeyboardController, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }] });
+
 /**
  * Injection token that carries the {@link KitAuthConfig} to the authentication guards.
  */
@@ -786,6 +929,10 @@ const kitAuthInterceptor = (request, next) => {
  *   items replace, and its items take precedence on duplicates.
  * @param key - The property of `T` used as the unique, numeric id for matching, range filtering, and sorting.
  * @param order - Sort direction by `key`: `'ASC'` for ascending or `'DESC'` for descending. Defaults to `'DESC'`.
+ * @param secondaryKey - Optional second property for extra de-duplication. When provided, any
+ *   surviving old item whose `secondaryKey` value matches that of *any* new item is dropped before
+ *   the `key` merge. Useful when a record keeps a stable `key` but its secondary identity changes
+ *   between pages (e.g. items keyed by `id` but also grouped by `parentId`). Omit to skip this step.
  * @returns A new array containing `arrayNew` merged with the out-of-window, non-duplicate old items, sorted by `key`.
  * @example
  * ```ts
@@ -810,7 +957,7 @@ const kitAuthInterceptor = (request, next) => {
  * // => [{ id: 30, title: 'c' }, { id: 20, title: 'b (updated)' }, { id: 15, title: 'a.5' }, { id: 10, title: 'a' }]
  * ```
  */
-const arrayConcatById = (arrayOld, arrayNew, key, order = 'DESC') => {
+const arrayConcatById = (arrayOld, arrayNew, key, order = 'DESC', secondaryKey) => {
     if (!arrayNew.length && !arrayOld.length) {
         return [];
     }
@@ -820,7 +967,10 @@ const arrayConcatById = (arrayOld, arrayNew, key, order = 'DESC') => {
         const value = vol[key];
         return (lead > last && (value >= lead || value <= last)) || (lead < last && (value <= lead || value >= last)) || lead === last;
     });
-    const oldData = filteredOld.filter((vol) => !arrayNew.some((element) => element[key] === vol[key]));
+    const secondaryFilteredOld = secondaryKey
+        ? filteredOld.filter((vol) => !arrayNew.some((element) => element[secondaryKey] === vol[secondaryKey]))
+        : filteredOld;
+    const oldData = secondaryFilteredOld.filter((vol) => !arrayNew.some((element) => element[key] === vol[key]));
     const data = arrayNew.concat(oldData);
     const direction = order === 'ASC' ? 1 : -1;
     return data.sort((a, b) => {
@@ -836,6 +986,68 @@ const arrayConcatById = (arrayOld, arrayNew, key, order = 'DESC') => {
     });
 };
 
+/**
+ * Order-independent deep equality check.
+ *
+ * @remarks
+ * Returns `true` when `a` and `b` serialize to the same value after their (nested) object entries are
+ * sorted by key, so property order does not affect the result. Intended for cheap "did this state
+ * object change?" comparisons.
+ *
+ * Caveats of the JSON-serialization approach: values that JSON drops or coerces (`undefined`,
+ * functions, `NaN`, `Date`, `Map`/`Set`) are compared by their serialized form, and array element
+ * order is treated as significant (arrays are not reordered in a meaningful way). Use a structural
+ * deep-equal library when those cases matter.
+ *
+ * @param a - First object.
+ * @param b - Second object.
+ * @returns `true` when the two objects are deeply equal ignoring key order.
+ * @example
+ * ```ts
+ * objectEqual({ a: 1, b: 2 }, { b: 2, a: 1 }); // => true
+ * objectEqual({ a: 1 }, { a: 2 });             // => false
+ * ```
+ */
+const objectEqual = (a, b) => {
+    if (Object.is(a, b)) {
+        return true;
+    }
+    const sortDeep = (obj) => {
+        if (typeof obj !== 'object' || !obj) {
+            return undefined;
+        }
+        return Object.entries(obj)
+            .sort()
+            .map(([entryKey, value]) => [entryKey, typeof value === 'object' ? sortDeep(value) : value]);
+    };
+    return JSON.stringify(sortDeep(a)) === JSON.stringify(sortDeep(b));
+};
+
+/**
+ * Disable the button that triggered an event while an async operation runs, re-enabling it after.
+ *
+ * @remarks
+ * Prevents the common double-submit / double-tap bug: the `event.target` button is disabled, the
+ * work is awaited, and the button is re-enabled — even if the work rejects (the rejection is
+ * swallowed here so the button always recovers; handle errors inside `work` if you need to react).
+ *
+ * @param event - The DOM event whose `target` is the button to disable (e.g. a click event).
+ * @param work - The async operation to run while the button is disabled.
+ * @returns A Promise that resolves once the work has settled and the button has been re-enabled.
+ * @example
+ * ```ts
+ * async submit(event: Event): Promise<void> {
+ *   await disableHandler(event, this.save());
+ * }
+ * ```
+ */
+const disableHandler = async (event, work) => {
+    const target = event.target;
+    target.disabled = true;
+    await work.catch(() => undefined);
+    target.disabled = false;
+};
+
 /*
  * Public API Surface of @rdlabo/ionic-angular-kit
  */
@@ -845,5 +1057,5 @@ const arrayConcatById = (arrayOld, arrayNew, key, order = 'DESC') => {
  * Generated bundle index. Do not edit.
  */
 
-export { KIT_AUTH_CONFIG, KIT_HTTP_CONFIG, KIT_OVERLAY_CONFIG, KitAutofillDirective, KitOverlayController, KitReloadAlertController, KitStorageService, arrayConcatById, kitAuthInterceptor, kitImpact, kitPresentAuthFailedAlert, kitRequireAuthorizedGuard, kitRequireConfirmingGuard, kitRequiredUnauthorizedGuard, provideKitAuth, provideKitHttp, provideKitOverlay };
+export { KIT_AUTH_CONFIG, KIT_HTTP_CONFIG, KIT_OVERLAY_CONFIG, KitAutofillDirective, KitKeyboardController, KitOverlayController, KitReloadAlertController, KitStorageService, arrayConcatById, disableHandler, kitAuthInterceptor, kitImpact, kitPresentAuthFailedAlert, kitRequireAuthorizedGuard, kitRequireConfirmingGuard, kitRequiredUnauthorizedGuard, objectEqual, provideKitAuth, provideKitHttp, provideKitOverlay };
 //# sourceMappingURL=rdlabo-ionic-angular-kit.mjs.map

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/auth/auth-guards.ts","../../../projects/kit/src/lib/http/kit-http.interceptor.ts","../../../projects/kit/src/lib/utils/array.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, ToastOptions } from '@ionic/angular/standalone';\nimport { AlertController, ModalController, 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 #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 toast using kit defaults that the caller may override.\n   *\n   * @remarks\n   * Defaults to a top 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   * @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: 'top',\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 { 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 * @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>(arrayOld: T[], arrayNew: T[], key: keyof T, order: 'ASC' | 'DESC' = 'DESC'): 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 oldData = filteredOld.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 * 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// 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';\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,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;;;;;;;;;;;;;;AAcG;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,KAAK;AACf,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;+GAhHW,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;;;ACuDD;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDG;AACI,MAAM,eAAe,GAAG,CAAI,QAAa,EAAE,QAAa,EAAE,GAAY,EAAE,KAAA,GAAwB,MAAM,KAAS;IACpH,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;AAEF,IAAA,MAAM,OAAO,GAAG,WAAW,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;IACnG,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;;ACjFA;;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 top 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   * @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: 'top',\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":"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"}

package/package.json

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

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

@@ -1,6 +1,7 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, EnvironmentProviders, OnInit } from '@angular/core';
-import { ModalOptions, ToastOptions, AlertController } from '@ionic/angular/standalone';
+import { InjectionToken, EnvironmentProviders, OnInit, ElementRef } from '@angular/core';
+import { ModalOptions, PopoverOptions, ToastOptions, AlertController } from '@ionic/angular/standalone';
+import { PluginListenerHandle } from '@capacitor/core';
 import { RouterStateSnapshot, UrlTree, CanActivateFn } from '@angular/router';
 import { Observable } from 'rxjs';
 import { HttpRequest, HttpResponse, HttpErrorResponse, HttpEvent, HttpInterceptorFn } from '@angular/common/http';
@@ -203,6 +204,20 @@ declare class KitOverlayController {
      * ```
      */
     presentModal<O = unknown>(component: ModalOptions['component'], componentProps?: ModalOptions['componentProps'], options?: KitModalPresentOptions): Promise<O | undefined>;
+    /**
+     * Present a popover and resolve with the data passed to its dismissal.
+     *
+     * @typeParam O - type of the data returned when the popover is dismissed
+     * @param component - the component to render inside the popover
+     * @param componentProps - props to pass to the popover component
+     * @param options - additional popover options (for example `event` to anchor it, or `cssClass`)
+     * @returns the dismiss data, or `undefined` when the popover is dismissed without data
+     * @example
+     * ```ts
+     * const choice = await overlay.presentPopover<MenuChoice>(MenuPopover, { items }, { event });
+     * ```
+     */
+    presentPopover<O = unknown>(component: PopoverOptions['component'], componentProps?: PopoverOptions['componentProps'], options?: Omit<PopoverOptions, 'component' | 'componentProps'>): Promise<O | undefined>;
     /**
      * Present a toast using kit defaults that the caller may override.
      *
@@ -408,6 +423,54 @@ declare class KitAutofillDirective implements OnInit {
     static ɵdir: i0.ɵɵDirectiveDeclaration<KitAutofillDirective, "[rdlaboAutofill]", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * How {@link KitKeyboardController.init} adjusts the target element when the native keyboard appears.
+ *
+ * - `transform` — CSS `translateY(-keyboardHeight + safeAreaBottom)` for a smooth iOS animation
+ *   (typical for an `ion-footer`).
+ * - `offset` — set the `--offset-bottom` custom property to the negative keyboard height.
+ * - `keyboard-offset` — set the `--padding-bottom` custom property to the keyboard height.
+ */
+type KitKeyboardAdjust = 'transform' | 'offset' | 'keyboard-offset';
+/**
+ * Registers native keyboard listeners that reposition an element when the keyboard shows/hides.
+ *
+ * @remarks
+ * A no-op on non-hybrid (web) platforms — `init` returns an empty handle list. On native it handles
+ * iOS and Android differences (Android only toggles the `footer-toolbar-padding` class on an
+ * `ion-footer` for the `transform` mode, working around an Ionic footer bug). The caller owns the
+ * returned handles and must `remove()` them when the view is destroyed.
+ *
+ * @example
+ * ```ts
+ * export class ComposePage {
+ *   readonly #keyboard = inject(KitKeyboardController);
+ *   readonly #footer = viewChild.required<ElementRef>('footer');
+ *   #handles: PluginListenerHandle[] = [];
+ *
+ *   async ngAfterViewInit() {
+ *     this.#handles = await this.#keyboard.init(this.#footer(), 'transform');
+ *   }
+ *   ngOnDestroy() {
+ *     this.#handles.forEach((h) => h.remove());
+ *   }
+ * }
+ * ```
+ */
+declare class KitKeyboardController {
+    #private;
+    /**
+     * Attach keyboard show/hide listeners that adjust `elementRef` per `type`.
+     *
+     * @param elementRef - The element to reposition (e.g. an `ion-footer`).
+     * @param type - The adjustment strategy; see {@link KitKeyboardAdjust}.
+     * @returns The registered listener handles (empty on non-native platforms).
+     */
+    init(elementRef: ElementRef, type: KitKeyboardAdjust): Promise<PluginListenerHandle[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<KitKeyboardController, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<KitKeyboardController>;
+}
+
 /**
  * Discriminated set of authentication states the guards react to.
  *
@@ -785,6 +848,10 @@ declare const kitImpact: (style?: ImpactStyle) => Promise<void>;
  *   items replace, and its items take precedence on duplicates.
  * @param key - The property of `T` used as the unique, numeric id for matching, range filtering, and sorting.
  * @param order - Sort direction by `key`: `'ASC'` for ascending or `'DESC'` for descending. Defaults to `'DESC'`.
+ * @param secondaryKey - Optional second property for extra de-duplication. When provided, any
+ *   surviving old item whose `secondaryKey` value matches that of *any* new item is dropped before
+ *   the `key` merge. Useful when a record keeps a stable `key` but its secondary identity changes
+ *   between pages (e.g. items keyed by `id` but also grouped by `parentId`). Omit to skip this step.
  * @returns A new array containing `arrayNew` merged with the out-of-window, non-duplicate old items, sorted by `key`.
  * @example
  * ```ts
@@ -809,7 +876,51 @@ declare const kitImpact: (style?: ImpactStyle) => Promise<void>;
  * // => [{ id: 30, title: 'c' }, { id: 20, title: 'b (updated)' }, { id: 15, title: 'a.5' }, { id: 10, title: 'a' }]
  * ```
  */
-declare const arrayConcatById: <T>(arrayOld: T[], arrayNew: T[], key: keyof T, order?: "ASC" | "DESC") => T[];
+declare const arrayConcatById: <T>(arrayOld: T[], arrayNew: T[], key: keyof T, order?: "ASC" | "DESC", secondaryKey?: keyof T) => T[];
+
+/**
+ * Order-independent deep equality check.
+ *
+ * @remarks
+ * Returns `true` when `a` and `b` serialize to the same value after their (nested) object entries are
+ * sorted by key, so property order does not affect the result. Intended for cheap "did this state
+ * object change?" comparisons.
+ *
+ * Caveats of the JSON-serialization approach: values that JSON drops or coerces (`undefined`,
+ * functions, `NaN`, `Date`, `Map`/`Set`) are compared by their serialized form, and array element
+ * order is treated as significant (arrays are not reordered in a meaningful way). Use a structural
+ * deep-equal library when those cases matter.
+ *
+ * @param a - First object.
+ * @param b - Second object.
+ * @returns `true` when the two objects are deeply equal ignoring key order.
+ * @example
+ * ```ts
+ * objectEqual({ a: 1, b: 2 }, { b: 2, a: 1 }); // => true
+ * objectEqual({ a: 1 }, { a: 2 });             // => false
+ * ```
+ */
+declare const objectEqual: (a: object, b: object) => boolean;
+
+/**
+ * Disable the button that triggered an event while an async operation runs, re-enabling it after.
+ *
+ * @remarks
+ * Prevents the common double-submit / double-tap bug: the `event.target` button is disabled, the
+ * work is awaited, and the button is re-enabled — even if the work rejects (the rejection is
+ * swallowed here so the button always recovers; handle errors inside `work` if you need to react).
+ *
+ * @param event - The DOM event whose `target` is the button to disable (e.g. a click event).
+ * @param work - The async operation to run while the button is disabled.
+ * @returns A Promise that resolves once the work has settled and the button has been re-enabled.
+ * @example
+ * ```ts
+ * async submit(event: Event): Promise<void> {
+ *   await disableHandler(event, this.save());
+ * }
+ * ```
+ */
+declare const disableHandler: (event: Event, work: Promise<void | boolean>) => Promise<void>;
 
-export { KIT_AUTH_CONFIG, KIT_HTTP_CONFIG, KIT_OVERLAY_CONFIG, KitAutofillDirective, KitOverlayController, KitReloadAlertController, KitStorageService, arrayConcatById, kitAuthInterceptor, kitImpact, kitPresentAuthFailedAlert, kitRequireAuthorizedGuard, kitRequireConfirmingGuard, kitRequiredUnauthorizedGuard, provideKitAuth, provideKitHttp, provideKitOverlay };
-export type { KitAlertCloseOptions, KitAlertConfirmOptions, KitAuthConfig, KitAuthFailedAlertOptions, KitAuthRedirects, KitAuthState, KitHttpConfig, KitLabels, KitModalPresentOptions, KitOverlayConfig, KitReloadAlertOptions };
+export { KIT_AUTH_CONFIG, KIT_HTTP_CONFIG, KIT_OVERLAY_CONFIG, KitAutofillDirective, KitKeyboardController, KitOverlayController, KitReloadAlertController, KitStorageService, arrayConcatById, disableHandler, kitAuthInterceptor, kitImpact, kitPresentAuthFailedAlert, kitRequireAuthorizedGuard, kitRequireConfirmingGuard, kitRequiredUnauthorizedGuard, objectEqual, provideKitAuth, provideKitHttp, provideKitOverlay };
+export type { KitAlertCloseOptions, KitAlertConfirmOptions, KitAuthConfig, KitAuthFailedAlertOptions, KitAuthRedirects, KitAuthState, KitHttpConfig, KitKeyboardAdjust, KitLabels, KitModalPresentOptions, KitOverlayConfig, KitReloadAlertOptions };