@rdlabo/ionic-angular-kit 0.0.2 → 0.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -272,26 +272,28 @@ A fleet-canonical HTTP interceptor with:
272
272
  ```typescript
273
273
  // app.config.ts
274
274
  import { provideHttpClient, withInterceptors } from '@angular/common/http';
275
- import { kitAuthInterceptor, provideKitHttp, kitPresentReloadAlert } from '@rdlabo/ionic-angular-kit';
275
+ import { kitAuthInterceptor, provideKitHttp, KitReloadAlertController } from '@rdlabo/ionic-angular-kit';
276
276
 
277
277
  export const appConfig: ApplicationConfig = {
278
278
  providers: [
279
279
  provideHttpClient(withInterceptors([kitAuthInterceptor])),
280
280
  provideKitHttp(() => {
281
281
  const auth = inject(AuthService);
282
- const overlay = inject(KitOverlayController);
282
+ const reload = inject(KitReloadAlertController);
283
283
  return {
284
284
  getAuthHeaders: async (req) => ({
285
285
  Authorization: `Bearer ${await auth.getToken()}`,
286
286
  }),
287
287
  onUnauthorized: (req) => auth.signOut(),
288
- // Fleet-canonical "network error → offer reload" (see kitPresentReloadAlert).
288
+ // Fleet-canonical "network error → offer reload" (see KitReloadAlertController).
289
289
  onNetworkError: (status) =>
290
- kitPresentReloadAlert(overlay, {
290
+ reload.present({
291
291
  header: 'ネットワークエラー',
292
292
  message: `通信できませんでした。リフレッシュしますか?(${status})`,
293
293
  okText: 'リフレッシュ',
294
294
  }),
295
+ // Auto-dismiss the stale alert once connectivity is back.
296
+ onResponse: () => void reload.dismiss(),
295
297
  // buildExtraHeaders / bypass / offlineFallback / onForbidden / onServerError omitted → kit defaults.
296
298
  };
297
299
  }),
@@ -306,18 +308,28 @@ export const appConfig: ApplicationConfig = {
306
308
  4. Non-400/500 status AND device connected → `onNetworkError`
307
309
  5. 400 or 500 with `error.message` → `onServerError`
308
310
 
309
- ### kitPresentReloadAlert
311
+ ### KitReloadAlertController
310
312
 
311
- The fleet's canonical "network error → offer to reload" confirmation, folding together the three concerns every app used to copy-paste: (1) suppress stacking when an `ion-alert` is already shown, (2) `alertConfirm`, (3) `location.reload()` on confirm. All text is passed in, so the kit stays free of hardcoded i18n. Usually wired from `onNetworkError`, but callable anywhere (e.g. an offline fallback).
313
+ The fleet's canonical "network error → offer to reload" alert, as a stateful controller that unifies the good-UX variant that had drifted across apps:
314
+
315
+ - **De-dup** — never stacks; a second `present()` while one is showing is a no-op.
316
+ - **Backdrop lock** — `backdropDismiss: false`, so a critical error isn't dismissed by an accidental backdrop tap.
317
+ - **Auto-dismiss on reconnect** — `dismiss()` (called from a later successful response) clears a now-stale error alert.
318
+ - **Reload on confirm** — the confirm button calls `location.reload()`; cancel uses the configured `labels.cancel`.
319
+
320
+ All text is passed in, so the kit stays free of hardcoded i18n. Wire `present` from a network-class error and `dismiss` from a success (interceptor `onResponse`, or a class interceptor's success path).
312
321
 
313
322
  ```typescript
314
- import { kitPresentReloadAlert } from '@rdlabo/ionic-angular-kit';
323
+ import { KitReloadAlertController } from '@rdlabo/ionic-angular-kit';
315
324
 
316
- await kitPresentReloadAlert(overlay, {
325
+ const reload = inject(KitReloadAlertController);
326
+ await reload.present({
317
327
  header: 'ネットワークエラー',
318
328
  message: `通信できませんでした。リフレッシュしますか?(${status})`,
319
329
  okText: 'リフレッシュ',
320
330
  });
331
+ // later, on a successful response:
332
+ await reload.dismiss();
321
333
  ```
322
334
 
323
335
  ---
@@ -303,48 +303,94 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
303
303
  }] });
304
304
 
305
305
  /**
306
- * Present the fleet's canonical "network error → offer to reload" confirmation.
306
+ * The fleet's canonical "network error → offer to reload" alert, as a stateful controller.
307
307
  *
308
308
  * @remarks
309
- * Folds together the three copy-pasted concerns that every app duplicated around a network failure:
309
+ * Consolidates the good-UX variant that had drifted across the fleet into one behavior:
310
310
  *
311
- * 1. Suppress stacking if an `ion-alert` is already on screen, do nothing.
312
- * 2. Ask the user to confirm via {@link KitOverlayController.alertConfirm}.
313
- * 3. Call `location.reload()` when the user confirms.
311
+ * - **De-dup**never stacks; a second {@link present} while an alert is already shown is a no-op.
312
+ * - **Backdrop lock** `backdropDismiss: false`, so a critical network error can't be dismissed by
313
+ * an accidental backdrop tap; the user consciously chooses cancel or reload.
314
+ * - **Auto-dismiss on reconnect** — the presented alert is tracked, so {@link dismiss} (called from a
315
+ * later successful response) clears a now-stale error alert instead of leaving it on screen.
316
+ * - **Reload on confirm** — the confirm button calls `location.reload()`.
314
317
  *
315
- * All user-facing text (`header`, `message`, `okText`) is supplied by the caller so the kit stays
316
- * free of any hardcoded i18n. Typically wired from {@link KitHttpConfig.onNetworkError}, but it can
317
- * be called from anywhere an app wants the same behavior (e.g. an offline fallback).
318
+ * All user-facing text is supplied by the caller so the kit stays free of any hardcoded i18n; the
319
+ * cancel button reuses {@link KitOverlayConfig.labels}. Because it performs navigation
320
+ * (`location.reload()`) and holds state, it is a dedicated controller rather than part of
321
+ * {@link KitOverlayController}, which stays free of navigation policy.
318
322
  *
319
- * @param overlay - the kit overlay controller used to present the confirmation
320
- * @param options - alert content plus the confirm-button text (usually "Refresh")
321
- * @returns a Promise that resolves once the alert is dismissed (the page reloads on confirm)
322
323
  * @example
323
324
  * ```ts
324
- * provideKitHttp(() => {
325
- * const overlay = inject(KitOverlayController);
326
- * return {
327
- * getAuthHeaders: async () => ({ ... }),
328
- * onNetworkError: (status) =>
329
- * kitPresentReloadAlert(overlay, {
330
- * header: 'ネットワークエラー',
331
- * message: `通信できませんでした。リフレッシュしますか?(${status})`,
332
- * okText: 'リフレッシュ',
333
- * }),
334
- * };
335
- * });
325
+ * // In an HTTP interceptor:
326
+ * const reload = inject(KitReloadAlertController);
327
+ * // ...on a network-class error while connected:
328
+ * await reload.present({ header: 'ネットワークエラー', message: `…(${status})`, okText: 'リフレッシュ' });
329
+ * // ...on any later successful response:
330
+ * await reload.dismiss();
336
331
  * ```
337
332
  */
338
- const kitPresentReloadAlert = async (overlay, options) => {
339
- // 既にアラート表示中なら多重表示しない。
340
- if (document.querySelector('ion-alert')) {
341
- return;
333
+ class KitReloadAlertController {
334
+ #alertCtrl = inject(AlertController);
335
+ #labels = inject(KIT_OVERLAY_CONFIG).labels;
336
+ #alert = null;
337
+ /**
338
+ * Present the reload alert, unless one is already on screen.
339
+ *
340
+ * @param options - alert content plus the reload-button text
341
+ * @returns a Promise that resolves once the alert has been presented (or immediately if suppressed)
342
+ */
343
+ async present(options) {
344
+ // この controller 経由でも直書き ion-alert でも、多重表示しない。
345
+ if (this.#alert || document.querySelector('ion-alert')) {
346
+ return;
347
+ }
348
+ const alert = await this.#alertCtrl.create({
349
+ header: options.header,
350
+ message: options.message,
351
+ backdropDismiss: false,
352
+ buttons: [
353
+ { text: this.#labels.cancel, role: 'cancel' },
354
+ {
355
+ text: options.okText,
356
+ handler: () => {
357
+ location.reload();
358
+ },
359
+ },
360
+ ],
361
+ });
362
+ this.#alert = alert;
363
+ void alert.onDidDismiss().then(() => {
364
+ // 別の present で置き換わっていない限り、追跡を解除する。
365
+ if (this.#alert === alert) {
366
+ this.#alert = null;
367
+ }
368
+ });
369
+ await alert.present();
342
370
  }
343
- const reload = await overlay.alertConfirm(options);
344
- if (reload) {
345
- location.reload();
371
+ /**
372
+ * Dismiss the tracked reload alert if one is showing.
373
+ *
374
+ * @remarks
375
+ * Typically called from a later successful response so a stale "network error" alert clears once
376
+ * connectivity is restored. A no-op when nothing is showing.
377
+ *
378
+ * @returns a Promise that resolves once the alert has been dismissed (or immediately if none)
379
+ */
380
+ async dismiss() {
381
+ const alert = this.#alert;
382
+ this.#alert = null;
383
+ await alert?.dismiss();
346
384
  }
347
- };
385
+ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: KitReloadAlertController, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
386
+ static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: KitReloadAlertController, providedIn: 'root' }); }
387
+ }
388
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: KitReloadAlertController, decorators: [{
389
+ type: Injectable,
390
+ args: [{
391
+ providedIn: 'root',
392
+ }]
393
+ }] });
348
394
 
349
395
  /**
350
396
  * Work around iOS `ion-input` autofill values not propagating to the Angular form model.
@@ -570,13 +616,14 @@ const KIT_HTTP_CONFIG = new InjectionToken('@rdlabo/ionic-angular-kit:http');
570
616
  * provideHttpClient(withInterceptors([kitAuthInterceptor])),
571
617
  * provideKitHttp(() => {
572
618
  * const auth = inject(AuthService);
573
- * const overlay = inject(KitOverlayController);
619
+ * const reload = inject(KitReloadAlertController);
574
620
  * return {
575
621
  * // Only getAuthHeaders is required; every other hook is optional and defaults to a no-op.
576
622
  * getAuthHeaders: async () => ({ Authorization: `Bearer ${await auth.token()}` }),
577
623
  * onUnauthorized: () => auth.signOut(),
578
624
  * onNetworkError: (status) =>
579
- * kitPresentReloadAlert(overlay, { header: 'Network error', message: `Reload? (${status})`, okText: 'Reload' }),
625
+ * reload.present({ header: 'Network error', message: `Reload? (${status})`, okText: 'Reload' }),
626
+ * onResponse: () => void reload.dismiss(),
580
627
  * };
581
628
  * }),
582
629
  * ],
@@ -746,5 +793,5 @@ const arrayConcatById = (arrayOld, arrayNew, key, order = 'DESC') => {
746
793
  * Generated bundle index. Do not edit.
747
794
  */
748
795
 
749
- export { KIT_AUTH_CONFIG, KIT_HTTP_CONFIG, KIT_OVERLAY_CONFIG, KitAutofillDirective, KitOverlayController, KitStorageService, arrayConcatById, kitAuthInterceptor, kitImpact, kitPresentReloadAlert, kitRequireAuthorizedGuard, kitRequireConfirmingGuard, kitRequiredUnauthorizedGuard, provideKitAuth, provideKitHttp, provideKitOverlay };
796
+ export { KIT_AUTH_CONFIG, KIT_HTTP_CONFIG, KIT_OVERLAY_CONFIG, KitAutofillDirective, KitOverlayController, KitReloadAlertController, KitStorageService, arrayConcatById, kitAuthInterceptor, kitImpact, kitRequireAuthorizedGuard, kitRequireConfirmingGuard, kitRequiredUnauthorizedGuard, provideKitAuth, provideKitHttp, provideKitOverlay };
750
797
  //# sourceMappingURL=rdlabo-ionic-angular-kit.mjs.map
@@ -1 +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/reload-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 type { KitAlertConfirmOptions } from './kit-overlay.controller';\nimport { KitOverlayController } from './kit-overlay.controller';\n\n/**\n * Present the fleet's canonical \"network error → offer to reload\" confirmation.\n *\n * @remarks\n * Folds together the three copy-pasted concerns that every app duplicated around a network failure:\n *\n * 1. Suppress stacking — if an `ion-alert` is already on screen, do nothing.\n * 2. Ask the user to confirm via {@link KitOverlayController.alertConfirm}.\n * 3. Call `location.reload()` when the user confirms.\n *\n * All user-facing text (`header`, `message`, `okText`) is supplied by the caller so the kit stays\n * free of any hardcoded i18n. Typically wired from {@link KitHttpConfig.onNetworkError}, but it can\n * be called from anywhere an app wants the same behavior (e.g. an offline fallback).\n *\n * @param overlay - the kit overlay controller used to present the confirmation\n * @param options - alert content plus the confirm-button text (usually \"Refresh\")\n * @returns a Promise that resolves once the alert is dismissed (the page reloads on confirm)\n * @example\n * ```ts\n * provideKitHttp(() => {\n * const overlay = inject(KitOverlayController);\n * return {\n * getAuthHeaders: async () => ({ ... }),\n * onNetworkError: (status) =>\n * kitPresentReloadAlert(overlay, {\n * header: 'ネットワークエラー',\n * message: `通信できませんでした。リフレッシュしますか?(${status})`,\n * okText: 'リフレッシュ',\n * }),\n * };\n * });\n * ```\n */\nexport const kitPresentReloadAlert = async (\n overlay: KitOverlayController,\n options: KitAlertConfirmOptions,\n): Promise<void> => {\n // 既にアラート表示中なら多重表示しない。\n if (document.querySelector('ion-alert')) {\n return;\n }\n const reload = await overlay.alertConfirm(options);\n if (reload) {\n location.reload();\n }\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 * All members are required. The hooks let the host application plug its own auth service and\n * navigation policy into the otherwise fixed guard control flow.\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.\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. Applications that do not need\n * this should pass `async () => false` to fall through to the default 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 * authState: () => auth.isAuth(),\n * onAuthorized: async () => true,\n * onUnauthenticated: async () => false,\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 return onAuthorized(state);\n }\n if (data === 'anonymous') {\n return true;\n }\n const fallback = await onUnauthenticated(state);\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 kitPresentReloadAlert} as the fleet's\n * canonical implementation of this hook.\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 overlay = inject(KitOverlayController);\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 * kitPresentReloadAlert(overlay, { header: 'Network error', message: `Reload? (${status})`, okText: 'Reload' }),\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/reload-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":"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"}
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/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 { 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 * All members are required. The hooks let the host application plug its own auth service and\n * navigation policy into the otherwise fixed guard control flow.\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.\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. Applications that do not need\n * this should pass `async () => false` to fall through to the default 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 * authState: () => auth.isAuth(),\n * onAuthorized: async () => true,\n * onUnauthenticated: async () => false,\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 return onAuthorized(state);\n }\n if (data === 'anonymous') {\n return true;\n }\n const fallback = await onUnauthenticated(state);\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';\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":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rdlabo/ionic-angular-kit",
3
- "version": "0.0.2",
3
+ "version": "0.0.4",
4
4
  "peerDependencies": {
5
5
  "@angular/common": "^21.0.0",
6
6
  "@angular/core": "^21.0.0",
@@ -253,39 +253,72 @@ declare class KitOverlayController {
253
253
  }
254
254
 
255
255
  /**
256
- * Present the fleet's canonical "network error → offer to reload" confirmation.
256
+ * Content for {@link KitReloadAlertController.present}.
257
+ */
258
+ interface KitReloadAlertOptions {
259
+ /** Alert header text. */
260
+ header: string;
261
+ /** Alert body message. */
262
+ message: string;
263
+ /**
264
+ * Text for the reload (confirm) button, e.g. "リフレッシュ".
265
+ *
266
+ * @remarks
267
+ * Action-specific, so it is supplied by the caller rather than taken from the shared labels.
268
+ * The cancel button uses the configured {@link KitLabels.cancel}.
269
+ */
270
+ okText: string;
271
+ }
272
+ /**
273
+ * The fleet's canonical "network error → offer to reload" alert, as a stateful controller.
257
274
  *
258
275
  * @remarks
259
- * Folds together the three copy-pasted concerns that every app duplicated around a network failure:
276
+ * Consolidates the good-UX variant that had drifted across the fleet into one behavior:
260
277
  *
261
- * 1. Suppress stacking if an `ion-alert` is already on screen, do nothing.
262
- * 2. Ask the user to confirm via {@link KitOverlayController.alertConfirm}.
263
- * 3. Call `location.reload()` when the user confirms.
278
+ * - **De-dup**never stacks; a second {@link present} while an alert is already shown is a no-op.
279
+ * - **Backdrop lock** `backdropDismiss: false`, so a critical network error can't be dismissed by
280
+ * an accidental backdrop tap; the user consciously chooses cancel or reload.
281
+ * - **Auto-dismiss on reconnect** — the presented alert is tracked, so {@link dismiss} (called from a
282
+ * later successful response) clears a now-stale error alert instead of leaving it on screen.
283
+ * - **Reload on confirm** — the confirm button calls `location.reload()`.
264
284
  *
265
- * All user-facing text (`header`, `message`, `okText`) is supplied by the caller so the kit stays
266
- * free of any hardcoded i18n. Typically wired from {@link KitHttpConfig.onNetworkError}, but it can
267
- * be called from anywhere an app wants the same behavior (e.g. an offline fallback).
285
+ * All user-facing text is supplied by the caller so the kit stays free of any hardcoded i18n; the
286
+ * cancel button reuses {@link KitOverlayConfig.labels}. Because it performs navigation
287
+ * (`location.reload()`) and holds state, it is a dedicated controller rather than part of
288
+ * {@link KitOverlayController}, which stays free of navigation policy.
268
289
  *
269
- * @param overlay - the kit overlay controller used to present the confirmation
270
- * @param options - alert content plus the confirm-button text (usually "Refresh")
271
- * @returns a Promise that resolves once the alert is dismissed (the page reloads on confirm)
272
290
  * @example
273
291
  * ```ts
274
- * provideKitHttp(() => {
275
- * const overlay = inject(KitOverlayController);
276
- * return {
277
- * getAuthHeaders: async () => ({ ... }),
278
- * onNetworkError: (status) =>
279
- * kitPresentReloadAlert(overlay, {
280
- * header: 'ネットワークエラー',
281
- * message: `通信できませんでした。リフレッシュしますか?(${status})`,
282
- * okText: 'リフレッシュ',
283
- * }),
284
- * };
285
- * });
292
+ * // In an HTTP interceptor:
293
+ * const reload = inject(KitReloadAlertController);
294
+ * // ...on a network-class error while connected:
295
+ * await reload.present({ header: 'ネットワークエラー', message: `…(${status})`, okText: 'リフレッシュ' });
296
+ * // ...on any later successful response:
297
+ * await reload.dismiss();
286
298
  * ```
287
299
  */
288
- declare const kitPresentReloadAlert: (overlay: KitOverlayController, options: KitAlertConfirmOptions) => Promise<void>;
300
+ declare class KitReloadAlertController {
301
+ #private;
302
+ /**
303
+ * Present the reload alert, unless one is already on screen.
304
+ *
305
+ * @param options - alert content plus the reload-button text
306
+ * @returns a Promise that resolves once the alert has been presented (or immediately if suppressed)
307
+ */
308
+ present(options: KitReloadAlertOptions): Promise<void>;
309
+ /**
310
+ * Dismiss the tracked reload alert if one is showing.
311
+ *
312
+ * @remarks
313
+ * Typically called from a later successful response so a stale "network error" alert clears once
314
+ * connectivity is restored. A no-op when nothing is showing.
315
+ *
316
+ * @returns a Promise that resolves once the alert has been dismissed (or immediately if none)
317
+ */
318
+ dismiss(): Promise<void>;
319
+ static ɵfac: i0.ɵɵFactoryDeclaration<KitReloadAlertController, never>;
320
+ static ɵprov: i0.ɵɵInjectableDeclaration<KitReloadAlertController>;
321
+ }
289
322
 
290
323
  /**
291
324
  * Work around iOS `ion-input` autofill values not propagating to the Angular form model.
@@ -568,8 +601,8 @@ interface KitHttpConfig {
568
601
  * UX hook for network-originated errors while the device is connected.
569
602
  *
570
603
  * @remarks
571
- * Optional; defaults to a no-op. The kit ships {@link kitPresentReloadAlert} as the fleet's
572
- * canonical implementation of this hook.
604
+ * Optional; defaults to a no-op. The kit ships {@link KitReloadAlertController} as the fleet's
605
+ * canonical implementation of this hook (with auto-dismiss on reconnect via `onResponse`).
573
606
  *
574
607
  * @param status - The HTTP status code, or a string descriptor for non-HTTP failures.
575
608
  * @returns Optionally a promise to await before continuing.
@@ -606,13 +639,14 @@ declare const KIT_HTTP_CONFIG: InjectionToken<KitHttpConfig>;
606
639
  * provideHttpClient(withInterceptors([kitAuthInterceptor])),
607
640
  * provideKitHttp(() => {
608
641
  * const auth = inject(AuthService);
609
- * const overlay = inject(KitOverlayController);
642
+ * const reload = inject(KitReloadAlertController);
610
643
  * return {
611
644
  * // Only getAuthHeaders is required; every other hook is optional and defaults to a no-op.
612
645
  * getAuthHeaders: async () => ({ Authorization: `Bearer ${await auth.token()}` }),
613
646
  * onUnauthorized: () => auth.signOut(),
614
647
  * onNetworkError: (status) =>
615
- * kitPresentReloadAlert(overlay, { header: 'Network error', message: `Reload? (${status})`, okText: 'Reload' }),
648
+ * reload.present({ header: 'Network error', message: `Reload? (${status})`, okText: 'Reload' }),
649
+ * onResponse: () => void reload.dismiss(),
616
650
  * };
617
651
  * }),
618
652
  * ],
@@ -729,5 +763,5 @@ declare const kitImpact: (style?: ImpactStyle) => Promise<void>;
729
763
  */
730
764
  declare const arrayConcatById: <T>(arrayOld: T[], arrayNew: T[], key: keyof T, order?: "ASC" | "DESC") => T[];
731
765
 
732
- export { KIT_AUTH_CONFIG, KIT_HTTP_CONFIG, KIT_OVERLAY_CONFIG, KitAutofillDirective, KitOverlayController, KitStorageService, arrayConcatById, kitAuthInterceptor, kitImpact, kitPresentReloadAlert, kitRequireAuthorizedGuard, kitRequireConfirmingGuard, kitRequiredUnauthorizedGuard, provideKitAuth, provideKitHttp, provideKitOverlay };
733
- export type { KitAlertCloseOptions, KitAlertConfirmOptions, KitAuthConfig, KitAuthRedirects, KitAuthState, KitHttpConfig, KitLabels, KitModalPresentOptions, KitOverlayConfig };
766
+ export { KIT_AUTH_CONFIG, KIT_HTTP_CONFIG, KIT_OVERLAY_CONFIG, KitAutofillDirective, KitOverlayController, KitReloadAlertController, KitStorageService, arrayConcatById, kitAuthInterceptor, kitImpact, kitRequireAuthorizedGuard, kitRequireConfirmingGuard, kitRequiredUnauthorizedGuard, provideKitAuth, provideKitHttp, provideKitOverlay };
767
+ export type { KitAlertCloseOptions, KitAlertConfirmOptions, KitAuthConfig, KitAuthRedirects, KitAuthState, KitHttpConfig, KitLabels, KitModalPresentOptions, KitOverlayConfig, KitReloadAlertOptions };