@africanies/angular-web-sdk 0.1.12 → 0.1.13

package/dist/libs/africanies-ui/fesm2022/africanies-africanies-ui.mjs

@@ -46,6 +46,9 @@ import { NgTemplateOutlet, NgClass, DatePipe } from '@angular/common';
  * </button>
  * ```
  */
+/**
+ * Theme-token button used across AFRICANIES surfaces.
+ */
 class ButtonComponent {
     modeColor = inject(ModeColorService);
     /**
@@ -239,6 +242,9 @@ function toastFingerprint(variant, title, message) {
  * Single toast card — dense, token-based, with optional countdown rail.
  * Stacked identical toasts can expand; close peels the outermost copy.
  */
+/**
+ * Single toast card — dense, token-based, with optional countdown rail. Stacked identical toasts can expand; close peels the outermost copy.
+ */
 class ToastItemComponent {
     /** Stack entry to render. */
     item = input.required(/* @ts-ignore */
@@ -667,6 +673,9 @@ function railFill(variant) {
  * Caps to the viewport and scrolls when the stack (or an expanded group)
  * would otherwise run off-screen.
  */
+/**
+ * Fixed stack host attached once by {@link ToastService.ensureHost}. Caps to the viewport and scrolls when the stack (or an expanded group) would otherwise run off-screen.
+ */
 class ToastHostComponent {
     toastService = inject(ToastService);
     toasts = this.toastService.items;
@@ -684,7 +693,7 @@ class ToastHostComponent {
     <div class="flex w-full flex-col gap-2">
       @if (toastService.showHostActions()) {
         <div
-          class="sticky top-0 z-10 flex flex-wrap justify-end gap-2 bg-white/80 pb-1 backdrop-blur-sm dark:bg-ink-surface/80"
+          class="sticky top-0 z-10 flex flex-wrap justify-end gap-2 bg-transparent pb-1 backdrop-blur-sm dark:bg-transparent"
         >
           @if (toastService.hasStacks()) {
             @if (toastService.allStacksExpanded()) {
@@ -753,7 +762,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
     <div class="flex w-full flex-col gap-2">
       @if (toastService.showHostActions()) {
         <div
-          class="sticky top-0 z-10 flex flex-wrap justify-end gap-2 bg-white/80 pb-1 backdrop-blur-sm dark:bg-ink-surface/80"
+          class="sticky top-0 z-10 flex flex-wrap justify-end gap-2 bg-transparent pb-1 backdrop-blur-sm dark:bg-transparent"
         >
           @if (toastService.hasStacks()) {
             @if (toastService.allStacksExpanded()) {
@@ -827,6 +836,9 @@ const TOAST_OVERLAY_Z_INDEX = '1100';
  *
  * Prefer {@link provideAfricaniesToasts} at bootstrap so the host overlay mounts once.
  */
+/**
+ * Imperative toast stack for AFRICANIES apps.
+ */
 class ToastService {
     overlay = inject(Overlay);
     injector = inject(Injector);
@@ -1161,6 +1173,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * <africanies-copy [value]="ref" ariaLabel="Copy reference" [announce]="true" />
  * ```
  */
+/**
+ * Icon button that copies {@link value} to the clipboard.
+ */
 class CopyButtonComponent {
     toastService = inject(ToastService, { optional: true });
     /** Plain text written to the clipboard. */
@@ -1396,6 +1411,9 @@ function navigateNavItem(router, item, keepScroll = true) {
  * </africanies-action-menu>
  * ```
  */
+/**
+ * Marks projected content as the custom trigger for {@link ActionMenuComponent}.
+ */
 class ActionMenuTriggerDirective {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ActionMenuTriggerDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
     static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.8", type: ActionMenuTriggerDirective, isStandalone: true, selector: "[africaniesActionMenuTrigger]", ngImport: i0 });
@@ -1475,6 +1493,9 @@ const MENU_PANEL_POSITIONS = [
  * }
  * ```
  */
+/**
+ * Compact overflow menu for row and toolbar actions.
+ */
 class ActionMenuComponent {
     router = inject(Router);
     panelPositions = MENU_PANEL_POSITIONS;
@@ -1902,6 +1923,9 @@ let nextMenuId = 0;
  * />
  * ```
  */
+/**
+ * Blocking empty state when a fetch succeeded but produced no rows / value.
+ */
 class EmptyStateComponent {
     /**
      * Empty-copy. Defaults to a generic phrase; override for filter-specific help.
@@ -2001,6 +2025,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </div>
  * ```
  */
+/**
+ * Compact error pill for non-blocking failures while stale data stays visible — distinct from {@link ErrorStateComponent} (full-section blocking).
+ */
 class ErrorIndicatorComponent {
     /**
      * Error copy. When empty, the indicator is not shown.
@@ -2146,6 +2173,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * />
  * ```
  */
+/**
+ * Blocking error state for failed async fetches (not field validation).
+ */
 class ErrorStateComponent {
     /**
      * Human-readable failure reason. Required so the alert is never an empty
@@ -2233,6 +2263,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * <africanies-loading-state mode="inline" message="Refreshing…" />
  * ```
  */
+/**
+ * Blocking / inline loading indicator for async surfaces.
+ */
 class LoadingStateComponent {
     modeColor = inject(ModeColorService);
     /**
@@ -2344,6 +2377,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </africanies-async-state>
  * ```
  */
+/**
+ * Async query wrapper that maps {@link AsyncQueryStateModel} into loading / error / empty / success with non-blocking badges for background activity.
+ */
 class AsyncStateComponent {
     /**
      * Snapshot from the app's query layer (e.g. mapped `injectQuery()` signals).
@@ -2560,6 +2596,9 @@ function isEmptyData(data) {
  * </africanies-accordion>
  * ```
  */
+/**
+ * Bordered expandable panel with animated fold — the pattern used on Manifest detail and Make Payment review.
+ */
 class AccordionComponent {
     /** Plain-text header. Prefer projected `[africaniesAccordionTitle]` for rich titles. */
     title = input('', /* @ts-ignore */
@@ -2690,6 +2729,9 @@ const DEFAULT_ICONS = {
  * }
  * ```
  */
+/**
+ * Inline page/section banner — distinct from {@link ErrorStateComponent} (full-section async failure + Retry).
+ */
 class AlertComponent {
     /** Semantic tone. Defaults to `info`. */
     variant = input('info', /* @ts-ignore */
@@ -2871,6 +2913,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * <africanies-chip variant="warning" [removable]="true" (removed)="clear()">Pending</africanies-chip>
  * ```
  */
+/**
+ * Compact status / category label.
+ */
 class ChipComponent {
     /** Semantic tone. Defaults to `neutral`. Ignored when {@link color} is set. */
     variant = input('neutral', /* @ts-ignore */
@@ -3026,6 +3071,9 @@ function normalizeCarrierLogoSlug(value) {
  * <africanies-carrier-logo [carrier]="item.delivery_vendor" />
  * ```
  */
+/**
+ * Inline carrier marks for delivery vendor cells.
+ */
 class CarrierLogoComponent {
     /** Raw carrier slug or label from the API. */
     carrier = input('', /* @ts-ignore */
@@ -3178,6 +3226,9 @@ function deliveryVendorSelected(storedValue, baseOptions = deliveryVendorSelectO
  * />
  * ```
  */
+/**
+ * Compact stacked text for table cells and detail panels.
+ */
 class ContentStackComponent {
     /** Primary line — usually a person or entity name. */
     title = input('', /* @ts-ignore */
@@ -3290,6 +3341,9 @@ function provideAfricaniesToasts() {
  * </africanies-tooltip>
  * ```
  */
+/**
+ * Marks projected content as the custom trigger for {@link TooltipComponent}.
+ */
 class TooltipTriggerDirective {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: TooltipTriggerDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
     static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.8", type: TooltipTriggerDirective, isStandalone: true, selector: "[africaniesTooltipTrigger]", ngImport: i0 });
@@ -3389,6 +3443,9 @@ const PLACEMENT_POSITIONS$1 = {
  * </africanies-tooltip>
  * ```
  */
+/**
+ * Contextual help tip — default info icon or a custom projected trigger.
+ */
 class TooltipComponent {
     tooltipId = `africanies-tooltip-${++nextTooltipId}`;
     customTrigger = contentChild(TooltipTriggerDirective, /* @ts-ignore */
@@ -3666,6 +3723,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </africanies-info-popover>
  * ```
  */
+/**
+ * Marks projected content as the custom trigger for {@link InfoPopoverComponent}.
+ */
 class InfoPopoverTriggerDirective {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: InfoPopoverTriggerDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
     static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.8", type: InfoPopoverTriggerDirective, isStandalone: true, selector: "[africaniesInfoPopoverTrigger]", ngImport: i0 });
@@ -3771,6 +3831,9 @@ const PLACEMENT_POSITIONS = {
  * </africanies-info-popover>
  * ```
  */
+/**
+ * Hover / focus / click info panel with a white card, optional title, and fully projected body content (any child component or markup).
+ */
 class InfoPopoverComponent {
     panelId = `africanies-info-popover-${++nextInfoPopoverId}`;
     customTrigger = contentChild(InfoPopoverTriggerDirective, /* @ts-ignore */
@@ -4086,6 +4149,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </africanies-info-popover>
  * ```
  */
+/**
+ * Marks projected content as the panel body for {@link InfoPopoverComponent}.
+ */
 class InfoPopoverContentDirective {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: InfoPopoverContentDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
     static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.8", type: InfoPopoverContentDirective, isStandalone: true, selector: "[africaniesInfoPopoverContent]", ngImport: i0 });
@@ -4186,6 +4252,9 @@ let nextDatePickerId = 0;
  * </africanies-date-picker>
  * ```
  */
+/**
+ * Date field wrapping native `input[type=date]`, following shared AFRICANIES form field pattern.
+ */
 class DatePickerComponent {
     theme = inject(ThemeService, { optional: true });
     controlId = `africanies-date-picker-${++nextDatePickerId}`;
@@ -4632,6 +4701,9 @@ function attachOverlayContent(overlay, parentInjector, component, overlayConfig,
  * });
  * ```
  */
+/**
+ * Opens centered modal dialogs via Angular CDK Overlay.
+ */
 class ModalService {
     overlay = inject(Overlay);
     injector = inject(Injector);
@@ -4817,6 +4889,9 @@ const SELECT_PANEL_POSITIONS = [
  * ]);
  * ```
  */
+/**
+ * Option select following the shared AFRICANIES form field pattern.
+ */
 class SelectComponent {
     modal = inject(ModalService, { optional: true });
     modeColor = inject(ModeColorService);
@@ -6133,6 +6208,9 @@ let nextTextInputId = 0;
  * </africanies-text-input>
  * ```
  */
+/**
+ * Single-line text field — **reference** form control for `@africanies/africanies-ui`.
+ */
 class TextInputComponent {
     /** Stable ids so label / aria-describedby stay paired across re-renders. */
     controlId = `africanies-text-input-${++nextTextInputId}`;
@@ -6341,6 +6419,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * No-ops when Angular Router is not in the injector (unit tests without
  * `provideRouter`).
  */
+/**
+ * Bidirectional list-query sync with the browser URL.
+ */
 class FilterQueryService {
     route = inject(ActivatedRoute, { optional: true });
     router = inject(Router, { optional: true });
@@ -6475,6 +6556,9 @@ function paramMapToRecord(map) {
  * {@link FilterDrawerResult}. Successful Apply also writes the query bag to
  * the browser URL via {@link FilterQueryService} (page resets to 1).
  */
+/**
+ * Schema-driven filter drawer body.
+ */
 class FilterDrawerPanel {
     data = inject(OVERLAY_DATA);
     ref = inject((AfricaniesOverlayRef));
@@ -7455,6 +7539,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * drawer.open(FiltersPanel, { data: { facet: 'status' } });
  * ```
  */
+/**
+ * Opens edge-anchored drawer panels via Angular CDK Overlay.
+ */
 class DrawerService {
     overlay = inject(Overlay);
     injector = inject(Injector);
@@ -7554,6 +7641,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  *   });
  * ```
  */
+/**
+ * Opens the schema-driven {@link FilterDrawerPanel} via {@link DrawerService}.
+ */
 class FilterDrawerService {
     drawer = inject(DrawerService);
     filterQuery = inject(FilterQueryService);
@@ -7590,6 +7680,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * primary button shows {@link ButtonComponent} loading until the work
  * settles. Errors leave the dialog open.
  */
+/**
+ * Built-in confirm dialog hosted by {@link ConfirmService} / {@link ModalService}.
+ */
 class ConfirmDialogComponent {
     /** Stable ids so aria-labelledby / aria-describedby stay unique per instance. */
     titleId = `africanies-confirm-title-${cryptoRandom()}`;
@@ -7890,6 +7983,9 @@ function cryptoRandom() {
  *   });
  * ```
  */
+/**
+ * One-line confirm flow built on {@link ModalService}.
+ */
 class ConfirmService {
     modal = inject(ModalService);
     /**
@@ -7937,6 +8033,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </africanies-overlay-frame>
  * ```
  */
+/**
+ * Marks projected chrome as the non-scrolling overlay header (title + close).
+ */
 class OverlayHeaderDirective {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: OverlayHeaderDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
     static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.8", type: OverlayHeaderDirective, isStandalone: true, selector: "[africaniesOverlayHeader]", ngImport: i0 });
@@ -7962,6 +8061,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </africanies-overlay-frame>
  * ```
  */
+/**
+ * Marks projected chrome as the non-scrolling overlay footer (actions).
+ */
 class OverlayFooterDirective {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: OverlayFooterDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
     static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.8", type: OverlayFooterDirective, isStandalone: true, selector: "[africaniesOverlayFooter]", ngImport: i0 });
@@ -8004,6 +8106,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * export class EditModal {}
  * ```
  */
+/**
+ * Header / scroll body / footer shell for {@link ModalService} and {@link DrawerService} panels.
+ */
 class OverlayFrameComponent {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: OverlayFrameComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
     static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "22.0.8", type: OverlayFrameComponent, isStandalone: true, selector: "africanies-overlay-frame", host: { classAttribute: "flex min-h-0 w-full flex-1 flex-col overflow-hidden" }, ngImport: i0, template: `
@@ -8113,6 +8218,9 @@ const PLACE_DETAILS_FIELD_MASK = 'id,displayName,formattedAddress,addressCompone
  * No Maps JavaScript widget, AutocompleteService, or PlacesService.
  * Register {@link provideGooglePlaces} with a key that has Places API (New).
  */
+/**
+ * Places API (New) over REST — same contract as the working React autocomplete (`POST …/places:autocomplete`, `GET …/places/{id}`).
+ */
 class GooglePlacesService {
     config = inject(GOOGLE_PLACES_CONFIG, { optional: true });
     /**
@@ -8312,6 +8420,9 @@ const ADDRESS_PANEL_POSITIONS = [
  * </africanies-address-input>
  * ```
  */
+/**
+ * Google Places address field with suggestion dropdown.
+ */
 class AddressInputComponent {
     places = inject(GooglePlacesService);
     destroyRef = inject(DestroyRef);
@@ -8898,6 +9009,9 @@ let nextCheckboxId = 0;
  * />
  * ```
  */
+/**
+ * Boolean checkbox following the shared AFRICANIES form field pattern.
+ */
 class CheckboxComponent {
     modeColor = inject(ModeColorService);
     controlId = `africanies-checkbox-${++nextCheckboxId}`;
@@ -9208,6 +9322,9 @@ function fileExtensionLabel(fileName) {
  * Prefer opening via {@link ModalService} so the stream is owned by this
  * dialog and torn down on close / destroy.
  */
+/**
+ * Live webcam capture dialog for {@link FileUploadComponent}.
+ */
 class CameraCaptureDialogComponent {
     destroyRef = inject(DestroyRef);
     ref = inject((AfricaniesOverlayRef));
@@ -9514,6 +9631,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * Object URLs created here are revoked on destroy; the list’s image
  * `previewUrl` is left alone.
  */
+/**
+ * Large-file preview modal for {@link FileUploadComponent}.
+ */
 class FilePreviewDialogComponent {
     data = inject(OVERLAY_DATA);
     ref = inject((AfricaniesOverlayRef));
@@ -9713,6 +9833,9 @@ let nextFileUploadId = 0;
  * />
  * ```
  */
+/**
+ * File / camera / drag-and-drop picker following the shared AFRICANIES form field pattern.
+ */
 class FileUploadComponent {
     destroyRef = inject(DestroyRef);
     /** Optional so the control still works when overlays are not registered. */
@@ -10781,6 +10904,9 @@ function formatWhileTyping(raw) {
  * amount = signal<number | null>(1250); // UI shows "1,250"
  * ```
  */
+/**
+ * Numeric field following the shared AFRICANIES form field pattern.
+ */
 class NumberInputComponent {
     controlId = `africanies-number-input-${++nextNumberInputId}`;
     hintId = `${this.controlId}-hint`;
@@ -11064,6 +11190,9 @@ let nextOtpId = 0;
  * />
  * ```
  */
+/**
+ * One-time-passcode field — discrete digit cells, single string model.
+ */
 class OtpInputComponent {
     destroyRef = inject(DestroyRef);
     cellInputs = viewChildren('cellInput', /* @ts-ignore */
@@ -12006,6 +12135,9 @@ const PANEL_POSITIONS$1 = [
  * />
  * ```
  */
+/**
+ * International phone field — flag + dial code + national number.
+ */
 class PhoneInputComponent {
     controlId = `africanies-phone-input-${++nextPhoneInputId}`;
     hintId = `${this.controlId}-hint`;
@@ -12496,6 +12628,9 @@ let nextRadioId = 0;
  * />
  * ```
  */
+/**
+ * Radio group following the shared AFRICANIES form field pattern.
+ */
 class RadioComponent {
     modeColor = inject(ModeColorService);
     groupName = `africanies-radio-${++nextRadioId}`;
@@ -12741,6 +12876,9 @@ const PANEL_POSITIONS = [
  * />
  * ```
  */
+/**
+ * Generic type-as-you-search combobox with a debounced async lookup and overlay result list.
+ */
 class SearchComboboxComponent {
     destroyRef = inject(DestroyRef);
     controlId = `africanies-search-combobox-${++nextSearchComboboxId}`;
@@ -13370,6 +13508,9 @@ let nextTextareaId = 0;
  * />
  * ```
  */
+/**
+ * Multi-line text field following the shared form-control pattern (`shared AFRICANIES form field pattern`). Supports prefix/suffix slots, field-level `error`, and {@link ControlValueAccessor}.
+ */
 class TextareaComponent {
     controlId = `africanies-textarea-${++nextTextareaId}`;
     hintId = `${this.controlId}-hint`;
@@ -13565,6 +13706,9 @@ let nextToggleId = 0;
  * />
  * ```
  */
+/**
+ * Boolean switch following the shared AFRICANIES form field pattern.
+ */
 class ToggleComponent {
     modeColor = inject(ModeColorService);
     controlId = `africanies-toggle-${++nextToggleId}`;
@@ -13812,6 +13956,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * <africanies-breadcrumb [items]="staticCrumbs" />
  * ```
  */
+/**
+ * Breadcrumb trail for hierarchical navigation.
+ */
 class BreadcrumbComponent {
     modeColor = inject(ModeColorService);
     /** Ordered crumbs; the last entry is the current page. */
@@ -14322,6 +14469,9 @@ const DEFAULT_LINK_ACTIVE$2 = {
  * ]" />
  * ```
  */
+/**
+ * Compact segmented control for view modes and filters.
+ */
 class SegmentComponent {
     router = inject(Router);
     modeColor = inject(ModeColorService);
@@ -14631,6 +14781,9 @@ const SHIPPING_MODE_GLYPH = `M88.42,68.75a48.8,48.8,0,0,1-4.74,11.1h9.89a7.67,7.
  * </africanies-side-nav>
  * ```
  */
+/**
+ * Two-up shipping mode switcher for app-shell side navs.
+ */
 class ShippingModeSwitchComponent {
     shipping = inject(ShippingModeService);
     /**
@@ -15026,6 +15179,9 @@ const AFRICANIES_BRAND_LOGO_MINI_URL = new InjectionToken('AFRICANIES_BRAND_LOGO
  * Override with a custom `logoSrc` on {@link SideNavComponent} when the host
  * ships its own mark.
  */
+/**
+ * Default AFRICANIES wordmark — inlined so it works without copying static assets.
+ */
 class BrandLogoComponent {
     size = input('md', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
@@ -15159,6 +15315,9 @@ const DEFAULT_LINK_ACTIVE$1 = {
  * />
  * ```
  */
+/**
+ * App shell side navigation with icons, nested items, and a collapsible rail.
+ */
 class SideNavComponent {
     modeColor = inject(ModeColorService);
     defaultLogoUrl = inject(AFRICANIES_BRAND_LOGO_URL);
@@ -15478,6 +15637,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </ng-template>
  * ```
  */
+/**
+ * Registers projected tab panel content against a tab id for {@link TabsComponent} (local / non-router mode).
+ */
 class TabDefDirective {
     /** Template projected as the active tab panel. */
     template = inject((TemplateRef));
@@ -15531,6 +15693,9 @@ const DEFAULT_LINK_ACTIVE = {
  * <router-outlet />
  * ```
  */
+/**
+ * Tab list for page / section navigation.
+ */
 class TabsComponent {
     router = inject(Router);
     modeColor = inject(ModeColorService);
@@ -15880,6 +16045,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </africanies-page-header>
  * ```
  */
+/**
+ * Page title + subtitle for product screens.
+ */
 class PageHeaderComponent {
     /** Page heading. Omit when the shell already rendered a title. */
     title = input('', /* @ts-ignore */
@@ -15955,6 +16123,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * Content chrome above the app-shell body: Back, breadcrumbs, then the page
  * title and optional subtitle.
  */
+/**
+ * Content chrome above the app-shell body: Back, breadcrumbs, then the page title and optional subtitle.
+ */
 class AppShellContentHeaderComponent {
     router = inject(Router);
     breadcrumbs = input([], /* @ts-ignore */
@@ -16078,6 +16249,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * <africanies-avatar name="Ops Team" />
  * ```
  */
+/**
+ * Circular avatar with image or initials fallback.
+ */
 class AvatarComponent {
     /** Display name — used for initials when no image loads. */
     name = input('', /* @ts-ignore */
@@ -16184,6 +16358,9 @@ function initialsFromName(name) {
  * />
  * ```
  */
+/**
+ * Avatar trigger with an attached overflow menu — profile / account actions.
+ */
 class AvatarMenuComponent {
     name = input.required(/* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
@@ -16280,6 +16457,9 @@ const MARK_ALL_CONFIRM_MS = 4000;
  *
  * Opened via {@link NotificationDrawerService}.
  */
+/**
+ * Right-edge drawer listing in-app notifications.
+ */
 class NotificationDrawerPanel {
     ref = inject(AfricaniesOverlayRef);
     data = inject(OVERLAY_DATA);
@@ -17086,6 +17266,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  *
  * Requires {@link provideAfricaniesUiOverlays} at bootstrap.
  */
+/**
+ * Opens {@link NotificationDrawerPanel} via {@link DrawerService}.
+ */
 class NotificationDrawerService {
     drawer = inject(DrawerService);
     /**
@@ -17369,13 +17552,14 @@ function hashString(value) {
 }
 
 /** Bump when cache shape or city resolution strategy changes. */
-const CACHE_KEY = 'africanies-header-weather-v7';
-const FETCH_MS = 4_000;
-const BROWSER_GEO_MS = 3_500;
-/** IP fallback — city string is used only when reverse-geocode is empty. */
+const CACHE_KEY = 'africanies-header-weather-v8';
+const FETCH_MS = 8_000;
+/** After Allow, wait for a GPS/Wi-Fi fix. A short timeout loses the prompt and falls through to IP. */
+const DEVICE_GEO_MS = 15_000;
+const DEVICE_GEO_PROMPT_MS = 25_000;
+/** IP city is the office egress (often Lagos) and must not label the device. */
 const GEO_URL = 'https://get.geojs.io/v1/ip/geo.json';
-/** Client reverse-geocode so the label matches the forecast coordinates. */
-const REVERSE_GEO_URL = 'https://api.bigdatacloud.net/data/reverse-geocode-client';
+const REVERSE_GEO_URL = 'https://geocoding-api.open-meteo.com/v1/reverse';
 const WEATHER_LABELS = {
     clear: 'Clear',
     cloudy: 'Cloudy',
@@ -17445,15 +17629,16 @@ function headerWeatherIcon(kind, hour) {
     return 'cloud-o';
 }
 /**
- * City-level forecast via browser / IP geolocation + Open-Meteo (no API key).
+ * City-level forecast. The label is the device location only.
  *
- * Coordinates prefer the browser Geolocation API (accurate for travellers;
- * may prompt once). Otherwise IP geo is used. The city label is reverse-
- * geocoded from those coordinates, with the IP city as a fallback.
+ * The Geolocation API (GPS / nearby Wi-Fi) is reverse-geocoded. IP lookup is
+ * not used for the city — a shared office egress makes every colleague "Lagos".
+ * If the device fix is refused, weather still loads from IP coordinates with
+ * no city.
  *
  * Fails closed: missing browser APIs, timeouts, and HTTP errors all return
- * `null` so the greeting can stay time-of-day only. Cached per local hour
- * in `sessionStorage`.
+ * `null` so the greeting can stay time-of-day only. A snapshot with a city
+ * is cached per local hour in `sessionStorage`.
  *
  * @param fetchFn - Injected `fetch` for tests.
  * @returns Forecast snapshot, or `null` when lookup fails.
@@ -17469,7 +17654,8 @@ async function loadHeaderWeather(fetchFn) {
         return cached;
     }
     try {
-        const coords = await resolveCoordinates(run);
+        const device = await tryDeviceCoordinates();
+        const coords = device ?? (await ipCoordinates(run));
         if (!coords) {
             return null;
         }
@@ -17486,10 +17672,13 @@ async function loadHeaderWeather(fetchFn) {
             return null;
         }
         const temperatureC = asNumber(forecast?.current?.temperature_2m) ?? undefined;
-        const city = (await reverseGeocodeCity(run, coords.latitude, coords.longitude)) ??
-            coords.fallbackCity;
+        const city = device
+            ? await reverseGeocodeCity(run, device.latitude, device.longitude)
+            : undefined;
         const weather = { kind, temperatureC, city };
-        writeCache({ hour, kind, temperatureC, city });
+        if (city) {
+            writeCache({ hour, kind, temperatureC, city });
+        }
         return weather;
     }
     catch {
@@ -17536,41 +17725,27 @@ function writeCache(value) {
         // Private mode / quota — greeting still works without cache.
     }
 }
-/**
- * Prefer device coordinates when available (may prompt once); otherwise fall
- * back to IP geo. IP is always fetched in parallel so its city can backfill
- * the label when reverse-geocode is empty (browser geo has no city string).
- */
-async function resolveCoordinates(fetchFn) {
-    const [browser, ipGeo] = await Promise.all([
-        tryBrowserGeolocation(),
-        fetchIpGeo(fetchFn),
-    ]);
-    const ipCity = asCity(ipGeo?.city);
-    if (browser) {
-        return { ...browser, fallbackCity: ipCity };
-    }
-    const latitude = asNumber(ipGeo?.latitude);
-    const longitude = asNumber(ipGeo?.longitude);
+async function ipCoordinates(fetchFn) {
+    const payload = (await fetchJson(fetchFn, GEO_URL));
+    const latitude = asNumber(payload?.latitude);
+    const longitude = asNumber(payload?.longitude);
     if (latitude === null || longitude === null) {
         return null;
     }
-    return {
-        latitude,
-        longitude,
-        fallbackCity: ipCity,
-    };
-}
-async function fetchIpGeo(fetchFn) {
-    return (await fetchJson(fetchFn, GEO_URL));
+    return { latitude, longitude };
 }
-async function tryBrowserGeolocation() {
+async function tryDeviceCoordinates() {
     if (typeof navigator === 'undefined' ||
         typeof navigator.geolocation?.getCurrentPosition !== 'function') {
         return null;
     }
+    const permission = await geolocationPermission();
+    if (permission === 'denied') {
+        return null;
+    }
+    const timeout = permission === 'granted' ? DEVICE_GEO_MS : DEVICE_GEO_PROMPT_MS;
     return await new Promise((resolve) => {
-        const timer = setTimeout(() => resolve(null), BROWSER_GEO_MS);
+        const timer = setTimeout(() => resolve(null), timeout);
         navigator.geolocation.getCurrentPosition((position) => {
             clearTimeout(timer);
             resolve({
@@ -17581,20 +17756,28 @@ async function tryBrowserGeolocation() {
             clearTimeout(timer);
             resolve(null);
         }, {
-            enableHighAccuracy: false,
-            maximumAge: 600_000,
-            timeout: BROWSER_GEO_MS,
+            enableHighAccuracy: true,
+            maximumAge: 0,
+            timeout,
         });
     });
 }
+async function geolocationPermission() {
+    try {
+        const status = await navigator.permissions?.query({ name: 'geolocation' });
+        return status?.state ?? 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
 async function reverseGeocodeCity(fetchFn, latitude, longitude) {
     const url = `${REVERSE_GEO_URL}?latitude=${encodeURIComponent(String(latitude))}` +
         `&longitude=${encodeURIComponent(String(longitude))}` +
-        `&localityLanguage=en`;
+        `&language=en&count=1`;
     const payload = (await fetchJson(fetchFn, url));
-    return (asCity(payload?.city) ??
-        asCity(payload?.locality) ??
-        asCity(payload?.principalSubdivision));
+    const place = payload?.results?.[0];
+    return asCity(place?.name) ?? asCity(place?.admin1);
 }
 function asNumber(value) {
     if (typeof value === 'number' && Number.isFinite(value)) {
@@ -17634,6 +17817,9 @@ async function fetchJson(fetchFn, url) {
     }
 }
 
+/**
+ * Marks projected content as extra leading chrome in {@link AppShellHeaderComponent}.
+ */
 /**
  * Marks projected content as extra leading chrome in {@link AppShellHeaderComponent}.
  */
@@ -17651,6 +17837,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
 /**
  * Marks projected content as extra trailing chrome in {@link AppShellHeaderComponent}.
  */
+/**
+ * Marks projected content as extra trailing chrome in {@link AppShellHeaderComponent}.
+ */
 class AppShellHeaderEndDirective {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AppShellHeaderEndDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
     static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.8", type: AppShellHeaderEndDirective, isStandalone: true, selector: "[africaniesAppShellHeaderEnd]", ngImport: i0 });
@@ -17679,6 +17868,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * />
  * ```
  */
+/**
+ * Product header bar for {@link AppShellComponent}: a short time-of-day kicker plus the given name, local weather, live clock, notification inbox drawer, and avatar menu. Breadcrumbs and Back belong in the content column via {@link AppShellContentHeaderComponent}.
+ */
 class AppShellHeaderComponent {
     notificationsDrawer = inject(NotificationDrawerService);
     destroyRef = inject(DestroyRef);
@@ -18113,6 +18305,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  *
  * When present, the built-in {@link AppShellHeaderComponent} is skipped.
  */
+/**
+ * Marks projected content as the custom header for {@link AppShellComponent}.
+ */
 class AppShellHeaderSlotDirective {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AppShellHeaderSlotDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
     static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.8", type: AppShellHeaderSlotDirective, isStandalone: true, selector: "[africaniesAppShellHeader]", ngImport: i0 });
@@ -18154,6 +18349,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </africanies-app-shell>
  * ```
  */
+/**
+ * Application chrome scaffold: side nav + sticky header + constrained content.
+ */
 class AppShellComponent {
     modeColor = inject(ModeColorService);
     logoMiniUrl = inject(AFRICANIES_BRAND_LOGO_MINI_URL);
@@ -18352,6 +18550,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * />
  * ```
  */
+/**
+ * Image with a shaped loading frame and fallback while the asset fetches or if it fails to render.
+ */
 class ImageComponent {
     imgRef = viewChild('img', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "imgRef" }] : /* istanbul ignore next */ []));
@@ -18550,6 +18751,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </ng-template>
  * ```
  */
+/**
+ * Registers a projected cell template against a column key for {@link TableComponent}.
+ */
 class CellDefDirective {
     /** Template projected into matching column body cells. */
     template = inject((TemplateRef));
@@ -18583,6 +18787,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </ng-template>
  * ```
  */
+/**
+ * Registers a projected header cell template against a column key for {@link TableComponent}.
+ */
 class HeaderCellDefDirective {
     /** Template projected into the matching column header cell. */
     template = inject(TemplateRef);
@@ -18615,6 +18822,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </ng-template>
  * ```
  */
+/**
+ * Registers a label / value pair inside an expanded table row.
+ */
 class RowDetailDefDirective {
     /** Template rendered as the detail value. */
     template = inject((TemplateRef));
@@ -18689,6 +18899,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  *
  * Page controls for server-style lists (bind to {@link PaginationMetaModel}).
  */
+/**
+ * Page-size select, numbered pager, and prev/next — driven by {@link PaginationMetaModel} from the API envelope.
+ */
 class PaginationComponent {
     filterQuery = inject(FilterQueryService);
     modeColor = inject(ModeColorService);
@@ -19085,6 +19298,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * to the top of that scrollport. Mobile keeps horizontal-only overflow so
  * page scroll is unchanged.
  */
+/**
+ * Presentational data table with template-based cells.
+ */
 class TableComponent {
     destroyRef = inject(DestroyRef);
     shipping = inject(ShippingModeService);
@@ -20321,6 +20537,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * </ng-template>
  * ```
  */
+/**
+ * Registers projected step body content against a step key for {@link StepperComponent}.
+ */
 class StepDefDirective {
     /** Template projected as the active step body. */
     template = inject((TemplateRef));
@@ -20357,6 +20576,9 @@ function prefersReducedMotion() {
  * When `animateSteps` is true (default), the step body fades/slides via the
  * Web Animations API (skipped when the user prefers reduced motion).
  */
+/**
+ * Multi-step wizard for form flows (e.g. shipment creation).
+ */
 class StepperComponent {
     modeColor = inject(ModeColorService);
     steps = input.required(/* @ts-ignore */
@@ -20645,6 +20867,9 @@ const ACTIONS = [
  * export class ToolbarModule {}
  * ```
  */
+/**
+ * Button, copy-to-clipboard control, overflow action menu, and avatar menu.
+ */
 class AfricaniesActionsModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesActionsModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
     static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesActionsModule, imports: [ButtonComponent,
@@ -20694,6 +20919,9 @@ const FEEDBACK = [
  * export class ListPageModule {}
  * ```
  */
+/**
+ * Async feedback states, accordion panels, inline alert, and status chips.
+ */
 class AfricaniesFeedbackModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesFeedbackModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
     static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesFeedbackModule, imports: [AccordionComponent,
@@ -20748,6 +20976,9 @@ const FORM_CONTROLS = [
  * export class ShipmentFormsModule {}
  * ```
  */
+/**
+ * All form controls in one import for apps that prefer NgModules.
+ */
 class AfricaniesFormsModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesFormsModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
     static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesFormsModule, imports: [TextInputComponent,
@@ -20796,6 +21027,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
  * imports: [InfoPopoverComponent, InfoPopoverContentDirective, InfoPopoverTriggerDirective],
  * ```
  */
+/**
+ * NgModule facade for {@link InfoPopoverComponent} and its trigger/content markers.
+ */
 class AfricaniesInfoPopoverModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesInfoPopoverModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
     static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesInfoPopoverModule, imports: [InfoPopoverComponent,
@@ -20849,6 +21083,9 @@ const NAV = [
  * export class ShellModule {}
  * ```
  */
+/**
+ * App shell, breadcrumb, tabs (+ `africaniesTabDef`), segment, side nav, shipping mode switch, brand logo, avatar menu, and shell header chrome.
+ */
 class AfricaniesNavigationModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesNavigationModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
     static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesNavigationModule, imports: [AppShellComponent,
@@ -20907,6 +21144,9 @@ const STEPPER = [StepperComponent, StepDefDirective];
  * export class WizardModule {}
  * ```
  */
+/**
+ * Stepper (+ `africaniesStepDef`).
+ */
 class AfricaniesStepperModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesStepperModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
     static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesStepperModule, imports: [StepperComponent, StepDefDirective], exports: [StepperComponent, StepDefDirective] });
@@ -20937,6 +21177,9 @@ const DATA = [
  * export class ShipmentsListModule {}
  * ```
  */
+/**
+ * Table (+ `africaniesCellDef`) and pagination.
+ */
 class AfricaniesTableModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesTableModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
     static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesTableModule, imports: [TableComponent,
@@ -20969,6 +21212,9 @@ const TOOLTIP = [TooltipComponent, TooltipTriggerDirective];
  * export class FormHintsModule {}
  * ```
  */
+/**
+ * Tooltip (+ `africaniesTooltipTrigger`).
+ */
 class AfricaniesTooltipModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesTooltipModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
     static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AfricaniesTooltipModule, imports: [TooltipComponent, TooltipTriggerDirective], exports: [TooltipComponent, TooltipTriggerDirective] });