@m4l/gclick 0.36.0 → 0.36.1-beta-feature-795-m4l-react-native-ui-indicator-flag.0

package/components/indicators/IndicatorCountryPhone/hooks/useCountryPhoneCatalog/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/gclick/src/components/indicators/IndicatorCountryPhone/hooks/useCountryPhoneCatalog/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,kFAAkF;AAClF,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B"}

package/components/indicators/IndicatorCountryPhone/hooks/useCountryPhoneCatalog/useCountryPhoneCatalog.d.ts

@@ -0,0 +1,12 @@
+import { useNetwork } from '@m4l/core';
+import { CountryPhoneCountry } from '../../types';
+import { UseCountryPhoneCatalogOptions, UseCountryPhoneCatalogReturn } from './types';
+type NetworkOperation = ReturnType<typeof useNetwork>['networkOperation'];
+/** Retry one transient catalog failure while preserving auth failures for the host. */
+export declare function shouldRetryCountryPhoneCatalog(failureCount: number, error: unknown): boolean;
+/** Fetch every active page and reject truncated or duplicate catalog data. */
+export declare function fetchCountryPhoneCatalog(networkOperation: NetworkOperation, signal: AbortSignal): Promise<readonly CountryPhoneCountry[]>;
+/** Load the session- and locale-scoped catalog shared by phone controls. */
+export declare function useCountryPhoneCatalog(options?: UseCountryPhoneCatalogOptions): UseCountryPhoneCatalogReturn;
+export {};
+//# sourceMappingURL=useCountryPhoneCatalog.d.ts.map

package/components/indicators/IndicatorCountryPhone/hooks/useCountryPhoneCatalog/useCountryPhoneCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCountryPhoneCatalog.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/gclick/src/components/indicators/IndicatorCountryPhone/hooks/useCountryPhoneCatalog/useCountryPhoneCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,UAAU,EAAsB,MAAM,WAAW,CAAC;AASpF,OAAO,KAAK,EAA2B,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAE3F,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAW1E,uFAAuF;AACvF,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAG5F;AA8BD,8EAA8E;AAC9E,wBAAsB,wBAAwB,CAC5C,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CA+CzC;AA0CD,4EAA4E;AAC5E,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,6BAAkC,GAC1C,4BAA4B,CAiG9B"}

package/components/indicators/IndicatorCountryPhone/hooks/useCountryPhoneCatalog/useCountryPhoneCatalog.js

@@ -0,0 +1,146 @@
+import { useNetwork as _, useEnvironment as A, useAuth as S, useUserPreferences as q } from "@m4l/core";
+import { useQuery as I } from "@tanstack/react-query";
+import { useRef as k, useEffect as D, useCallback as H } from "react";
+import { INDICATOR_COUNTRY_PHONE_STALE_TIME as P, INDICATOR_COUNTRY_PHONE_PAGE_LIMIT as L, INDICATOR_COUNTRY_PHONE_ENDPOINT as N } from "../../constants.js";
+import { normalizeCountryPhoneItem as R } from "../../countryOptions.js";
+function M(t) {
+  if (!(typeof t != "object" || t === null || !("status" in t)))
+    return typeof t.status == "number" ? t.status : void 0;
+}
+function T(t, i) {
+  const n = M(i);
+  return n !== 401 && n !== 403 && t < 1;
+}
+function b(t, i, n, a) {
+  const { data: r, pager: e } = t;
+  if (!Array.isArray(r) || !e || !Number.isInteger(e.total) || e.total < 0)
+    throw new Error("Countries response contains an invalid pager.");
+  if (!Number.isInteger(e.page) || e.page !== i)
+    throw new Error("Countries response did not advance on the requested page.");
+  if (!Number.isInteger(e.limit) || e.limit <= 0)
+    throw new Error("Countries response contains an invalid page limit.");
+  if (r.length > e.limit)
+    throw new Error("Countries response exceeds its reported page limit.");
+  if (n !== void 0 && e.total !== n)
+    throw new Error("Countries response changed its reported total between pages.");
+  if (a !== void 0 && e.limit !== a)
+    throw new Error("Countries response changed its reported page limit between pages.");
+}
+async function U(t, i) {
+  const n = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Set();
+  let r = 0, e = 0, l, p;
+  for (; ; ) {
+    const c = await t({
+      method: "GET",
+      endPoint: N,
+      isRemote: !0,
+      responseToCamelCase: !0,
+      toastError: !1,
+      signal: i,
+      parms: { page: e, limit: L }
+    });
+    if (b(c, e, l, p), l ??= c.pager.total, p ??= c.pager.limit, r + c.data.length > c.pager.total)
+      throw new Error("Countries response contains more rows than its reported total.");
+    for (const h of c.data) {
+      const o = R(h);
+      if (a.has(o.apiId))
+        throw new Error(`Countries response contains duplicate identifier ${o.apiId}.`);
+      a.add(o.apiId), r += 1, o.active && n.set(o.apiId, o);
+    }
+    if (r === c.pager.total)
+      return [...n.values()];
+    if (c.data.length === 0)
+      throw new Error("Countries response ended before its reported total.");
+    e += 1;
+  }
+}
+async function z(t, i, n) {
+  const a = n.toUpperCase(), r = await t({
+    method: "GET",
+    endPoint: N,
+    isRemote: !0,
+    responseToCamelCase: !0,
+    toastError: !1,
+    signal: i,
+    parms: {
+      page: 0,
+      limit: 1,
+      f: [
+        { n: "id", o: "e", o1: a },
+        { n: "active", o: "e", o1: !1 }
+      ]
+    }
+  });
+  if (b(r, 0), r.pager.total !== r.data.length)
+    throw new Error("Countries response returned an incomplete inactive lookup.");
+  const e = r.data.map((l) => R(l)).find((l) => l.apiId === a);
+  if (!e)
+    return null;
+  if (e.active)
+    throw new Error(`Countries response returned active country ${a} for an inactive lookup.`);
+  return e;
+}
+function j(t = {}) {
+  const { enabled: i = !0, selectedValue: n } = t, { networkOperation: a } = _(), { hostApiRemote: r, database: e } = A(), { isAuthenticated: l, user: p } = S(), { locale: c } = q(), h = c || "en", o = n?.trim().toLowerCase(), m = [
+    r,
+    e,
+    p?.accountId ?? null,
+    p?.id ?? null,
+    h
+  ], g = m.join(""), f = k({
+    scopeIdentity: g,
+    countries: /* @__PURE__ */ new Map()
+  });
+  f.current.scopeIdentity !== g && (f.current = {
+    scopeIdentity: g,
+    countries: /* @__PURE__ */ new Map()
+  });
+  const y = i && l && !!p, s = I({
+    queryKey: ["indicator-country-phone", "active", ...m],
+    enabled: y,
+    staleTime: P,
+    retry: T,
+    queryFn: ({ signal: d }) => U(a, d)
+  }), C = s.data?.find(
+    (d) => d.value === o
+  ), E = !!(y && s.isSuccess && o && !C), u = I({
+    queryKey: ["indicator-country-phone", "historical", ...m, o ?? null],
+    enabled: E,
+    staleTime: P,
+    retry: T,
+    /** Fetch the selected inactive country only after the active catalog has loaded. */
+    queryFn: ({ signal: d }) => z(
+      a,
+      d,
+      o
+    )
+  });
+  D(() => {
+    for (const d of s.data ?? [])
+      f.current.countries.set(d.value, d);
+    u.data && f.current.countries.set(u.data.value, u.data);
+  }, [s.data, u.data]);
+  const O = H(async () => {
+    if (u.isError) {
+      await u.refetch();
+      return;
+    }
+    await s.refetch();
+  }, [s, u]), w = s.data !== void 0, v = o ? f.current.countries.get(o) : void 0;
+  return {
+    countries: s.data ?? [],
+    selectedCountry: C ?? u.data ?? (v ? { ...v, active: !1 } : void 0),
+    locale: h,
+    status: i ? s.isError && !w ? "error" : s.isPending ? "loading" : "loaded" : "disabled",
+    isRefreshing: s.isFetching && w,
+    hasRefreshError: s.isError && w,
+    isSelectedLoading: E && u.isPending,
+    hasSelectedError: u.isError,
+    retry: O
+  };
+}
+export {
+  U as fetchCountryPhoneCatalog,
+  T as shouldRetryCountryPhoneCatalog,
+  j as useCountryPhoneCatalog
+};

package/components/indicators/IndicatorCountryPhone/index.d.ts

@@ -0,0 +1,4 @@
+export { IndicatorCountryPhone } from './IndicatorCountryPhone';
+export { getIndicatorCountryPhoneComponentsDictionary } from './dictionary';
+export type { IndicatorCountryPhoneOption, IndicatorCountryPhoneProps } from './types';
+//# sourceMappingURL=index.d.ts.map

package/components/indicators/IndicatorCountryPhone/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/gclick/src/components/indicators/IndicatorCountryPhone/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,4CAA4C,EAAE,MAAM,cAAc,CAAC;AAC5E,YAAY,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC"}

package/components/indicators/IndicatorCountryPhone/slots.d.ts

@@ -0,0 +1,16 @@
+export declare enum IndicatorCountryPhoneSlots {
+    root = "root",
+    trigger = "trigger",
+    chip = "chip",
+    popover = "popover",
+    menu = "menu",
+    menuItem = "menuItem",
+    flag = "flag",
+    code = "code",
+    codeInput = "codeInput",
+    emptyState = "emptyState",
+    skeleton = "skeleton",
+    statusButton = "statusButton",
+    virtualItems = "virtualItems"
+}
+//# sourceMappingURL=slots.d.ts.map

package/components/indicators/IndicatorCountryPhone/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../../../../../../packages/gclick/src/components/indicators/IndicatorCountryPhone/slots.ts"],"names":[],"mappings":"AAAA,oBAAY,0BAA0B;IACpC,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,YAAY,iBAAiB;IAC7B,YAAY,iBAAiB;CAC9B"}

package/components/indicators/IndicatorCountryPhone/slots.js

@@ -0,0 +1,4 @@
+var p = /* @__PURE__ */ ((e) => (e.root = "root", e.trigger = "trigger", e.chip = "chip", e.popover = "popover", e.menu = "menu", e.menuItem = "menuItem", e.flag = "flag", e.code = "code", e.codeInput = "codeInput", e.emptyState = "emptyState", e.skeleton = "skeleton", e.statusButton = "statusButton", e.virtualItems = "virtualItems", e))(p || {});
+export {
+  p as IndicatorCountryPhoneSlots
+};

package/components/indicators/IndicatorCountryPhone/types.d.ts

@@ -0,0 +1,88 @@
+import { ChipProps, M4LOverridesStyleRules } from '@m4l/components';
+import { SvgIconProps } from '@mui/material/SvgIcon';
+import { Theme } from '@mui/material/styles';
+import { ComponentType, HTMLAttributes } from 'react';
+import { INDICATOR_COUNTRY_PHONE_COMPONENT_KEY } from './constants';
+import { IndicatorCountryPhoneSlots } from './slots';
+/** Component type used by the generated ISO-to-flag artwork lookup. */
+export type CountryPhoneFlagComponent = ComponentType<SvgIconProps>;
+/** One country returned by the authenticated countries endpoint after normalization. */
+export interface CountryPhoneCountry {
+    /** Uppercase ISO alpha-2 identity used by the API. */
+    apiId: string;
+    /** Lowercase ISO alpha-2 identity exposed by the component. */
+    value: string;
+    /** Localized name returned by the API. */
+    label: string;
+    /** E.164 calling code formatted for display with one leading plus sign. */
+    callingCode: string;
+    /** Whether the API permits this country to be selected. */
+    active: boolean;
+    /** Local flag artwork when the ISO identifier exists in `@m4l/icons`. */
+    flag?: CountryPhoneFlagComponent;
+}
+/** Raw country row after the shared network layer converts keys to camelCase. */
+export interface CountryPhoneApiItem {
+    id: string;
+    name: string;
+    active: boolean;
+    callingCode: string;
+}
+/** Pager returned by the countries endpoint. */
+export interface CountryPhoneApiPager {
+    total: number;
+    page: number;
+    limit: number;
+}
+/** Authenticated countries list response. */
+export interface CountryPhoneApiResponse {
+    data: CountryPhoneApiItem[];
+    pager: CountryPhoneApiPager;
+}
+/** A country selected from the authenticated phone-prefix catalog. */
+export interface IndicatorCountryPhoneOption {
+    /** Stable lowercase two-letter region identifier, usually ISO 3166-1 alpha-2. */
+    value: string;
+    /** Visible phone prefix, including the leading plus sign. */
+    callingCode: string;
+    /** Country name used by assistive technology. */
+    label: string;
+}
+/** Public props for the IndicatorCountryPhone wrapper. */
+export interface IndicatorCountryPhoneProps {
+    /** E.164 calling codes to include, such as [34, 44, 33]. Omit for all countries. */
+    options?: readonly number[];
+    /** Controlled selected country identifier. */
+    value?: string;
+    /** Initially selected country identifier when uncontrolled. */
+    defaultValue?: string;
+    /** Called when a country is selected. */
+    onChange?: (option: IndicatorCountryPhoneOption) => void;
+    /** Controlled popover visibility. */
+    expanded?: boolean;
+    /** Initial popover visibility when uncontrolled. */
+    defaultExpanded?: boolean;
+    /** Called whenever popover visibility is requested to change. */
+    onExpandedChange?: (expanded: boolean) => void;
+    /** Prevent country changes while the surrounding field is disabled or read-only. */
+    disabled?: boolean;
+    /** Additional Chip configuration; the wrapper owns its flag, label and click behavior. */
+    chipProps?: Omit<ChipProps, 'startIcon' | 'label' | 'onClick'>;
+    /** Additional attributes for the popover panel; the wrapper owns its content. */
+    popoverProps?: Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'dangerouslySetInnerHTML'>;
+    /** Additional class for the wrapper. */
+    className?: string;
+    /** Optional test identifier on the wrapper. */
+    dataTestId?: string;
+}
+/** State passed to the themeable component slots. */
+export interface IndicatorCountryPhoneOwnerState {
+    expanded?: boolean;
+    codeLength?: number;
+    rowTop?: number;
+    totalHeight?: number;
+    viewportHeight?: number;
+}
+export type IndicatorCountryPhoneSlotsType = keyof typeof IndicatorCountryPhoneSlots;
+export type IndicatorCountryPhoneStyles = M4LOverridesStyleRules<IndicatorCountryPhoneSlotsType, typeof INDICATOR_COUNTRY_PHONE_COMPONENT_KEY, Theme>;
+//# sourceMappingURL=types.d.ts.map

package/components/indicators/IndicatorCountryPhone/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../packages/gclick/src/components/indicators/IndicatorCountryPhone/types.ts"],"names":[],"mappings":"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"}

package/components/indicators/index.d.ts

@@ -1,5 +1,6 @@
 export * from './IndicatorBattery';
 export * from './IndicatorCSQ';
 export * from './IndicatorValueStatus';
+export * from './IndicatorCountryPhone';
 export * from './IndicatorValueAndMagnitude';
 //# sourceMappingURL=index.d.ts.map

package/components/indicators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/indicators/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/indicators/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC"}