@codeleap/types 6.2.3 → 6.8.0

package/dist/appSettings.d.ts

@@ -0,0 +1,94 @@
+import { DeepPartial, Matcher, LogType } from '.';
+/**
+ * Global configuration contract for a CodeLeap product.
+ * Every field is deeply optional so that apps only declare what they need;
+ * the runtime layer is responsible for supplying sensible defaults for
+ * any omitted fields.
+ */
+export type AppSettings = DeepPartial<{
+    AppName: string;
+    CompanyName: string;
+    CompanySuffix: string;
+    Description: string;
+    Environment: {
+        IsDev: boolean;
+        Type: 'production' | 'development';
+        InitTime: any;
+    };
+    Application: {
+        IsBrowser: boolean;
+    };
+    BaseURL: string;
+    Sentry: {
+        enable: boolean;
+        dsn: string;
+        provider: any;
+        debug?: boolean;
+        initArgs?: any;
+        beforeBreadcrumb?: any;
+    };
+    PerformanceInspector: {
+        enable: boolean;
+        maxRenders: number;
+        blacklist?: string[];
+    };
+    Logger: {
+        Level: LogType | LogType[];
+        DeviceIdentifier?: string;
+        IgnoreWarnings?: string[];
+        StringifyObjects?: boolean;
+        isMain?: boolean;
+        inspect?: any;
+        alwaysSendToSentry?: boolean;
+        Obfuscate: {
+            keys: Matcher<'key'>[];
+            values: Matcher<'value'>[];
+        };
+    };
+    Vars: {
+        GooglePlayURL: string;
+        AppStoreURL: string;
+        WebsiteURL: string;
+        PrivacyPolicy: string;
+    };
+    Fetch: {
+        ProductionURL: string;
+        DevelopmentURL: string;
+    };
+    Social: {
+        FaceURL: string;
+        LinkedinURL: string;
+    };
+    ContactINFO: {
+        Website: string;
+        TermsAndPrivacy: string;
+        SupportEMAIL: string;
+        ContactEMAIL: string;
+        ContactPHONE: string;
+    };
+    ApiCredentials: {
+        GoogleSignin: {
+            WebClientId: string;
+        };
+        FacebookSDK: {
+            AppId: string;
+        };
+    };
+    Slack: {
+        echo: {
+            channel?: string;
+            icon: string;
+            token: string;
+            baseURL?: string;
+            enabled?: boolean;
+            options?: Record<string, any>;
+        };
+    };
+}>;
+/**
+ * The subset of `AppSettings` that is safe to mutate at runtime
+ * (e.g. by environment-specific config files or feature flags).
+ * Structural settings such as app identity are intentionally excluded.
+ */
+export type ConfigurableSettings = Pick<AppSettings, 'Fetch' | 'Logger' | 'ApiCredentials'>;
+//# sourceMappingURL=appSettings.d.ts.map

package/dist/appSettings.d.ts.map

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

package/dist/common.d.ts

@@ -0,0 +1,30 @@
+/** A `Promise<T>` that may carry an optional `abort()` method for cancellation (e.g. wrapping an `AbortController`). */
+export type CancellablePromise<T> = Promise<T> & {
+    abort?: () => void;
+};
+/** A browser `File` paired with an object-URL preview string. The preview must be revoked with `URL.revokeObjectURL` when no longer needed. */
+export type WebInputFile = {
+    file: File;
+    preview: string;
+};
+type MobileFileBase = {
+    fileCopyUri?: string;
+    name: string;
+    size: number;
+    type: string;
+    uri: string;
+};
+/**
+ * React Native file descriptor, based on the shape returned by `react-native-document-picker`.
+ * The `Extra` parameter lets callers bolt on additional fields while omitting any that conflict with the base shape.
+ */
+export type MobileFile<Extra = {}> = Omit<MobileFileBase, keyof Extra> & Partial<Extra>;
+/** A `MobileFile` paired with a local preview URI (e.g. a `file://` path or data URL). */
+export type FileWithPreview<Extra = {}> = {
+    file: MobileFile<Extra>;
+    preview: string;
+};
+/** Accepts either a bare `MobileFile` or a `FileWithPreview`. Use when a handler must cope with both the raw-pick and post-preview states. */
+export type MobileInputFile<Extra = {}> = FileWithPreview<Extra> | MobileFile<Extra>;
+export {};
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA,wHAAwH;AACxH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,CAAA;AAEvE,+IAA+I;AAC/I,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,KAAK,GAAG,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;AAEvF,0FAA0F;AAC1F,MAAM,MAAM,eAAe,CAAC,KAAK,GAAG,EAAE,IAAI;IACxC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,8IAA8I;AAC9I,MAAM,MAAM,eAAe,CAAC,KAAK,GAAG,EAAE,IAAI,eAAe,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA"}

package/dist/google-places.d.ts

@@ -0,0 +1,102 @@
+/** A single component of a structured address (e.g. city, country, postal code), as returned by the Google Places API. */
+export type AddressComponent = {
+    long_name: string;
+    short_name: string;
+    types: string[];
+};
+/** A geographic coordinate pair. */
+export type LatLng = {
+    lat: number;
+    lng: number;
+};
+/** A rectangular bounding box defined by its northeast and southwest corners. */
+export type GeometryBounds = {
+    northeast: LatLng;
+    southwest: LatLng;
+};
+/** Spatial metadata for a place: its precise location, geocode type, and recommended viewport. */
+export type Geometry = {
+    location: LatLng;
+    location_type: string;
+    viewport: GeometryBounds;
+};
+/** An Open Location Code (OLC) for a place, in both compound (human-readable) and global forms. */
+export type PlusCode = {
+    compound_code: string;
+    global_code: string;
+};
+/** Identifies a run of characters within an autocomplete suggestion that matched the user's query. */
+export type MatchedSubstring = {
+    length: number;
+    offset: number;
+};
+/** A token in the structured breakdown of an autocomplete prediction (e.g. city, country). */
+export type Term = {
+    offset: number;
+    value: string;
+};
+/** A reference to a place photo hosted by Google. Use `photo_reference` to fetch the image via the Places Photo API. */
+export type Photo = {
+    height: number;
+    html_attributions: string[];
+    photo_reference: string;
+    width: number;
+};
+/**
+ * Full detail record for a resolved place, as returned by the Places Details endpoint.
+ * `photos` and `website` are not guaranteed — some places (e.g. cities) omit them.
+ */
+export type PlaceDetails = {
+    address_components: AddressComponent[];
+    adr_address: string;
+    formatted_address: string;
+    geometry: Geometry;
+    icon: string;
+    icon_background_color: string;
+    icon_mask_base_uri: string;
+    name: string;
+    place_id: string;
+    reference: string;
+    types: string[];
+    url: string;
+    utc_offset: number;
+    vicinity: string;
+    photos?: Photo[];
+    website?: string;
+};
+/** `PlaceDetails` extended with a `plus_code` — present when the geocoder can assign an OLC to the result. */
+export type PlaceLatLngDetails = PlaceDetails & {
+    plus_code: PlusCode;
+};
+/**
+ * An autocomplete prediction from the Places Autocomplete API.
+ * `details` is populated only after a subsequent Details lookup is performed for this prediction.
+ */
+export type PlaceAddress = {
+    description: string;
+    matched_substrings: MatchedSubstring[];
+    place_id: string;
+    reference: string;
+    structured_formatting: {
+        main_text: string;
+        main_text_matched_substrings: MatchedSubstring[];
+        secondary_text: string;
+    };
+    terms: Term[];
+    types: string[];
+    details?: PlaceDetails;
+};
+/**
+ * A reverse-geocoding result keyed by coordinates rather than a place ID.
+ * `details` is populated only after an explicit Details lookup.
+ */
+export type PlaceLatLng = {
+    address_components: AddressComponent[];
+    formatted_address: string;
+    geometry: Geometry;
+    place_id: string;
+    plus_code: PlusCode;
+    types: string[];
+    details?: PlaceLatLngDetails;
+};
+//# sourceMappingURL=google-places.d.ts.map

package/dist/google-places.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-places.d.ts","sourceRoot":"","sources":["../src/google-places.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAC1H,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAED,oCAAoC;AACpC,MAAM,MAAM,MAAM,GAAG;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,kGAAkG;AAClG,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,cAAc,CAAA;CACzB,CAAA;AAED,mGAAmG;AACnG,MAAM,MAAM,QAAQ,GAAG;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,sGAAsG;AACtG,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,8FAA8F;AAC9F,MAAM,MAAM,IAAI,GAAG;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,wHAAwH;AACxH,MAAM,MAAM,KAAK,GAAG;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,kBAAkB,EAAE,gBAAgB,EAAE,CAAA;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,QAAQ,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,qBAAqB,EAAE,MAAM,CAAA;IAC7B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAIhB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,8GAA8G;AAC9G,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG;IAC9C,SAAS,EAAE,QAAQ,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB,EAAE,gBAAgB,EAAE,CAAA;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,EAAE;QACrB,SAAS,EAAE,MAAM,CAAA;QACjB,4BAA4B,EAAE,gBAAgB,EAAE,CAAA;QAChD,cAAc,EAAE,MAAM,CAAA;KACvB,CAAA;IACD,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,KAAK,EAAE,MAAM,EAAE,CAAA;IAEf,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,kBAAkB,EAAE,gBAAgB,EAAE,CAAA;IACtC,iBAAiB,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,QAAQ,CAAA;IACnB,KAAK,EAAE,MAAM,EAAE,CAAA;IAEf,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAC7B,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './google-places';
+export * from './pathMapping';
+export * from './utility';
+export * from './common';
+export * as TypeGuards from './typeGuards';
+export * from './appSettings';
+export * as RNMaskedTextTypes from './react-native-masked-text';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,OAAO,KAAK,UAAU,MAAM,cAAc,CAAA;AAC1C,cAAc,eAAe,CAAA;AAC7B,OAAO,KAAK,iBAAiB,MAAM,4BAA4B,CAAA"}

package/dist/pathMapping.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Lookup table that maps a depth counter `N` to `N - 1`.
+ * Used to decrement the recursion depth in types like `Paths` and `ReplaceRecursive`.
+ * Terminates at `0 → never` to halt infinite recursion.
+ */
+export type Prev = [
+    never,
+    0,
+    1,
+    2,
+    3,
+    4,
+    5,
+    6,
+    7,
+    8,
+    9,
+    10,
+    11,
+    12,
+    13,
+    14,
+    15,
+    16,
+    17,
+    18,
+    19,
+    20,
+    ...0[]
+];
+/**
+ * Concatenates two path segments with a `.` separator.
+ * Produces an empty junction when `P` is an empty string (root key case).
+ */
+export type Join<K, P> = K extends string | number ? P extends string | number ? `${K}${'' extends P ? '' : '.'}${P}` : never : never;
+/**
+ * Recursively generates all valid dot-notation path strings for an object type `T`.
+ * Stops at `Date` values (treating them as leaves) and at depth `D` (default 2).
+ * Includes both the parent key and all descendant paths via `Join`.
+ */
+export type Paths<T, D extends number = 2> = [D] extends [never] ? never : (T extends Date ? '' : (T extends object ? {
+    [K in keyof T]-?: K extends string | number ? `${K}` | Join<K, Paths<T[K], Prev[D]>> : never;
+}[keyof T] : ''));
+/**
+ * Like `Paths` but unbounded in depth and always treats every object as
+ * a traversable node (no `Date` short-circuit). Prefer `Paths` for large
+ * or deeply nested types to avoid hitting the TS recursion limit.
+ */
+export type ExtractPath<T> = T extends object ? {
+    [K in keyof T & (string | number)]: T[K] extends object ? `${K}` | `${K}.${ExtractPath<T[K]>}` : `${K}`;
+}[keyof T & (string | number)] : never;
+//# sourceMappingURL=pathMapping.d.ts.map

package/dist/pathMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathMapping.d.ts","sourceRoot":"","sources":["../src/pathMapping.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,KAAK;IACL,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,EAAE;IACF,GAAG,CAAC,EAAE;CACP,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,MAAM,GAC9C,CAAC,SAAS,MAAM,GAAG,MAAM,GACvB,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC,EAAE,GACpC,KAAK,GACP,KAAK,CAAA;AAET;;;;GAIG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAC5D,KAAK,GACL,CAAC,CAAC,SAAS,IAAI,GACb,EAAE,GACA,CAAC,CAAC,SAAS,MAAM,GACf;KACG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,MAAM,GAAG,MAAM,GACvC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GACtC,KAAK;CACV,CAAC,MAAM,CAAC,CAAC,GACV,EAAE,CAAC,CACR,CAAA;AAEL;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACzC;KACC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACnD,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GACpC,GAAG,CAAC,EAAE;CACX,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,GAC5B,KAAK,CAAA"}

package/dist/react-native-masked-text.d.ts

@@ -0,0 +1,43 @@
+/** The mask format to apply. `'custom'` requires a `mask` pattern in `TextInputMaskOptionProp`. */
+export type TextInputMaskTypeProp = 'credit-card' | 'cpf' | 'cnpj' | 'zip-code' | 'only-numbers' | 'money' | 'cel-phone' | 'datetime' | 'custom';
+/**
+ * Format options for `TextInputMask`. Which fields are relevant depends on the active `type`:
+ * - **money** — `precision`, `separator`, `delimiter`, `unit`, `suffixUnit`, `zeroCents`
+ * - **cel-phone** — `withDDD`, `dddMask`, `maskType`
+ * - **datetime** — `format` (moment.js pattern)
+ * - **credit-card** — `obfuscated`, `issuer`
+ * - **custom** — `mask`, `validator`, `getRawValue`, `translation`
+ */
+export interface TextInputMaskOptionProp {
+    precision?: number;
+    separator?: string;
+    delimiter?: string;
+    unit?: string;
+    suffixUnit?: string;
+    zeroCents?: boolean;
+    withDDD?: boolean;
+    dddMask?: string;
+    maskType?: 'BRL' | 'INTERNATIONAL';
+    format?: string;
+    obfuscated?: boolean;
+    issuer?: 'visa-or-mastercard' | 'diners' | 'amex';
+    mask?: string;
+    validator?: (value: string, settings: TextInputMaskOptionProp) => boolean;
+    getRawValue?: (value: string, settings: TextInputMaskOptionProp) => any;
+    translation?: {
+        [s: string]: (val: string) => string | null | undefined;
+    };
+}
+/**
+ * Props for the `TextInputMask` component from `react-native-masked-text`.
+ * Set `includeRawValueInChangeText` to receive the unmasked value alongside the formatted one in `onChangeText`.
+ */
+export interface TextInputMaskProps {
+    type: TextInputMaskTypeProp;
+    options?: TextInputMaskOptionProp;
+    checkText?: (previous: string, next: string) => boolean;
+    customTextInput?: any;
+    customTextInputProps?: Object;
+    includeRawValueInChangeText?: boolean;
+}
+//# sourceMappingURL=react-native-masked-text.d.ts.map

package/dist/react-native-masked-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native-masked-text.d.ts","sourceRoot":"","sources":["../src/react-native-masked-text.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,MAAM,qBAAqB,GAC3B,aAAa,GACb,KAAK,GACL,MAAM,GACN,UAAU,GACV,cAAc,GACd,OAAO,GACP,WAAW,GACX,UAAU,GACV,QAAQ,CAAA;AAEd;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IAEpC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;IAGnB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,KAAK,GAAG,eAAe,CAAA;IAGlC,MAAM,CAAC,EAAE,MAAM,CAAA;IAGf,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,CAAC,EAAE,oBAAoB,GAAG,QAAQ,GAAG,MAAM,CAAA;IAGjD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB,KAAK,OAAO,CAAA;IACzE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB,KAAK,GAAG,CAAA;IACvE,WAAW,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;KAAE,CAAA;CAC5E;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,qBAAqB,CAAA;IAC3B,OAAO,CAAC,EAAE,uBAAuB,CAAA;IACjC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACvD,eAAe,CAAC,EAAE,GAAG,CAAA;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,2BAA2B,CAAC,EAAE,OAAO,CAAA;CACxC"}

package/dist/typeGuards.d.ts

@@ -0,0 +1,31 @@
+import { AnyFunction } from './utility';
+import React from 'react';
+export declare function isNumber(x: unknown): x is number;
+export declare function isString(x: unknown): x is string;
+/** Returns `true` for any value whose `typeof` is `'object'`, including `null`. Pair with `isNil` when null must be excluded. */
+export declare function isObject(x: unknown): x is object;
+export declare function isBoolean(x: unknown): x is boolean;
+export declare function isFunction(x: unknown): x is (AnyFunction);
+/** Checks callable shape only — does not distinguish between regular functions and class constructors. Use `isConstructor` when the `new` signature matters. */
+export declare function isConstructor(x: unknown): x is (new (...args: unknown[]) => any);
+export declare function isArray(x: unknown): x is any[];
+export declare function isUndefined(x: unknown): x is undefined;
+export declare function isNull(x: unknown): x is null;
+export declare function isNil(x: unknown): x is null | undefined;
+/** Checks membership of `x` in the `Enum` array — useful for narrowing to a specific string/number literal union at runtime. */
+export declare function is<T>(x: unknown, Enum: T[]): x is T;
+type Abstract<T> = Function & {
+    prototype: T;
+};
+type Constructor<T> = new (...args: any[]) => T;
+type Class<T = any> = Abstract<T> | Constructor<T>;
+/** Works for both concrete classes and abstract classes via the `Abstract<T>` branch. */
+export declare function isInstance<T extends Class, X = T extends Class<infer X> ? X : never>(x: unknown, cls: T): x is X;
+/** Delegates to `React.isValidElement` — returns `true` for JSX elements but `false` for plain components (functions/classes). */
+export declare function isElement(x: unknown): x is React.ReactElement;
+/** Accepts both a component type (function/class) and a rendered element — use when a prop can receive either form. */
+export declare function isComponentOrElement<P>(x: any): x is React.ComponentType<P> | React.ReactElement;
+/** Duck-types against `.then` and `.catch` rather than `instanceof Promise`, so it works across realms and custom thenables. */
+export declare function isPromise(x: unknown): x is Promise<any>;
+export {};
+//# sourceMappingURL=typeGuards.d.ts.map

package/dist/typeGuards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["../src/typeGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAEhD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAEhD;AAED,iIAAiI;AACjI,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAEhD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,CAElD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAEzD;AAED,gKAAgK;AAChK,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,CAEhF;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,GAAG,EAAE,CAE9C;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,SAAS,CAEtD;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,IAAI,CAE5C;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,IAAI,GAAG,SAAS,CAEvD;AAED,gIAAgI;AAChI,wBAAgB,EAAE,CAAC,CAAC,EAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAEpD;AACD,KAAK,QAAQ,CAAC,CAAC,IAAI,QAAQ,GAAG;IAAC,SAAS,EAAE,CAAC,CAAA;CAAC,CAAA;AAE5C,KAAK,WAAW,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAC/C,KAAK,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;AAElD,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAEhH;AAED,kIAAkI;AAClI,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,YAAY,CAE7D;AAED,uHAAuH;AACvH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAEhG;AAED,gIAAgI;AAChI,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,CAEvD"}

package/dist/utility.d.ts

@@ -0,0 +1,136 @@
+import { ReactNode } from 'react';
+import { Prev } from './pathMapping';
+/** Matches any callable — use as a constraint, not as a call signature. */
+export type AnyFunction = (...args: any[]) => any;
+/** Matches any `Record<string, any>`. Useful as a generic object constraint. */
+export type AnyRecord = Record<string, any>;
+/** Constrains a record whose values must all be strings. */
+export type StringRecord = Record<string, string>;
+/** Makes every property in `T` `readonly` shallowly. Prefer this over the built-in `Readonly<T>` only when you need the mapped-type form for composability. */
+export type ReadOnly<T> = {
+    readonly [Property in keyof T]: T[Property];
+};
+/** Collects the keys of every nested object value in `T`. Only one level deep — grandchildren are not included. */
+export type NestedKeys<T> = {
+    [K in keyof T]: T[K] extends Record<any, any> ? keyof T[K] : never;
+}[keyof T];
+/** Typed function with explicit `Args` and `Return` — use instead of `AnyFunction` when the signature matters. */
+export type FunctionType<Args extends any[], Return> = (...args: Args) => Return;
+/**
+ * Recursively makes every property optional.
+ * `null` and `RegExp` values are widened to `any` to avoid
+ * their structural members being partially unwrapped.
+ */
+export type DeepPartial<T> = Partial<{
+    [Property in keyof T]: T[Property] extends Record<string, any> ? T[Property] extends null | RegExp ? any : DeepPartial<T[Property]> : T[Property] extends null | RegExp ? any : Partial<T[Property]>;
+}>;
+type PrependNextNum<A extends Array<unknown>> = A['length'] extends infer T ? ((t: T, ...a: A) => void) extends (...x: infer X) => void ? X : never : never;
+type EnumerateInternal<A extends Array<unknown>, N extends number> = {
+    0: A;
+    1: EnumerateInternal<PrependNextNum<A>, N>;
+}[N extends A['length'] ? 0 : 1];
+/**
+ * Produces a union of integers from `0` up to (but not including) `N`.
+ * Useful for constraining numeric literals without listing them by hand.
+ * @example `Enumerate<5>` → `0 | 1 | 2 | 3 | 4`
+ */
+export type Enumerate<N extends number> = EnumerateInternal<[
+], N> extends (infer E)[] ? E : never;
+/**
+ * Produces a union of integers in the half-open interval `[FROM, TO)`.
+ * @example `Range<2, 5>` → `2 | 3 | 4`
+ */
+export type Range<FROM extends number, TO extends number> = Exclude<Enumerate<TO>, Enumerate<FROM>>;
+/** Maps each key of a component/variant union `C` to an optional CSS value. Used to type per-variant style overrides. */
+export type StylesOf<C extends string | number | symbol = any, CSS = any> = Partial<Record<C, CSS>>;
+type IsDict<T> = T extends AnyFunction ? false : T extends Record<string, any> ? true : false;
+/**
+ * Walks every property of `T` and replaces occurrences of `Replace` with `With`.
+ * The depth counter `D` (default 10) prevents infinite recursion on circular types.
+ * Functions are left untouched even if they satisfy the `Replace` constraint.
+ */
+export type ReplaceRecursive<T, Replace, With, D extends number = 10> = [D] extends [never] ? never : {
+    [Property in keyof T]: T[Property] extends Replace ? With : IsDict<T[Property]> extends true ? ReplaceRecursive<T[Property], Replace, With, Prev[D]> : T[Property];
+};
+/**
+ * Like `Omit<T, K>` but preserves the exact property types without the
+ * homomorphic mapped-type widening that `Omit` can introduce on complex generics.
+ */
+export type SmartOmit<T, K extends keyof T> = {
+    [Property in Exclude<keyof T, K>]: T[Property];
+};
+/** Extracts the props type of a React component `T`, optionally omitting keys listed in `Exclude`. */
+export type PropsOf<T, Exclude extends string = ''> = T extends React.ComponentType<infer P> ? Omit<P, Exclude> : any;
+/** A dictionary with string keys and homogeneous values of type `T`. Prefer over `Record<string, T>` when the key set is unknown at compile time. */
+export type Hashmap<T> = {
+    [key: string]: T;
+};
+/** Unwraps the resolved value of a `Promise<U>`. Passes non-promise types through unchanged. */
+export type UnwrapPromise<T> = T extends Promise<infer U> ? U : T;
+/** Extracts the resolved return type of an async function. Returns `never` for non-async functions. */
+export type AsyncReturnType<T> = T extends (...args: any[]) => Promise<infer U> ? U : never;
+/**
+ * Extracts the `variants` prop type from a component that accepts `{ variants: V }`.
+ * Falls back to `string[]` when the inferred type is not a string or string array.
+ */
+export type VariantsOf<T> = T extends ((props: {
+    variants: infer V;
+}) => any) ? (V extends (string | string[]) ? V : (string[])) : (string[]);
+/** Strips `string` from a union, leaving only the non-string literal members. Useful for extracting enum-like members from a mixed union. */
+export type VariantList<T> = Exclude<T, string>;
+/** Unwraps the element type that a `React.Ref<U>` points to. */
+export type GetRefType<T> = T extends React.Ref<infer U> ? U : never;
+/**
+ * Returns a union of the keys of `T` whose value type extends `Filter`.
+ * Uses a sentinel string `'__never__'` internally to avoid distributing `never` in the union.
+ */
+export type FilterKeys<T, Filter = any> = Exclude<{
+    [P in keyof T]: T[P] extends Filter ? P : '__never__';
+}[keyof T], '__never__'>;
+/** The tuple returned by `React.useState<T>()` — useful for passing state as a single prop. */
+export type ReactState<T = any> = [
+    T,
+    React.Dispatch<React.SetStateAction<T>>
+];
+/**
+ * Expands a state tuple into a props object with the value key and a `set<Name>` setter key.
+ * @example `ReactStateProps<'count', number>` → `{ count: number; setCount: Dispatch<...> }`
+ */
+export type ReactStateProps<Name extends string, T = any, State extends ReactState<T> = ReactState<T>> = {
+    [P in Name as `set${Capitalize<Name>}`]: State[1];
+} & {
+    [P in Name]: State[0];
+};
+/** Union of every ref shape React accepts — callback refs, `MutableRefObject`, `ForwardedRef`, and the legacy form. Use when a utility must accept any ref flavour. */
+export type AnyRef<T> = React.Ref<T> | React.MutableRefObject<T> | ((instance: T | null) => void) | null | React.ForwardedRef<T> | React.LegacyRef<T>;
+/** Produces a union of valid indices for a readonly tuple `T`. Excludes the `length` value itself. */
+export type Indices<T extends readonly any[]> = Exclude<Partial<T>['length'], T['length']>;
+/** Replaces the types of specific keys `Keys` in `Object` with `With`, leaving all other keys intact. */
+export type Replace<Object, Keys extends keyof Object, With = any> = Omit<Object, Keys> & {
+    [P in Keys]: With;
+};
+/**
+ * Flexible predicate type used for filtering or matching.
+ * Accepts a plain string, a partial `RegExp` descriptor, or a two-argument predicate
+ * that receives the value/key and a type discriminant `T`.
+ */
+export type Matcher<T> = string | Partial<RegExp> | FunctionType<[valueOrKey: any, type: T], boolean>;
+/** Logger severity levels, including `'silent'` to suppress all output. */
+export type LogType = 'info' | 'debug' | 'warn' | 'error' | 'log' | 'silent';
+/** Drops the first argument of a function and returns the remaining parameter types. */
+export type SecondToLastArguments<T extends AnyFunction> = T extends ((...args: [infer _, ...infer Rest]) => any) ? Rest : never;
+/** An array of `{ label, value }` pairs — the canonical shape for select/dropdown data sources. */
+export type Options<T> = {
+    label: string;
+    value: T;
+}[];
+/** A single entry from an `Options<T>` array. */
+export type Option<T> = Options<T>[number];
+/** A label that can be a plain string or any React-renderable node. */
+export type Label = string | ReactNode;
+/** Union of all value types in `T`. Equivalent to `T[keyof T]`. */
+export type ValueOf<T> = T[keyof T];
+/** Alias for `keyof T` — useful when you need to pass the key union as a generic argument. */
+export type Keyof<T> = keyof T;
+export {};
+//# sourceMappingURL=utility.d.ts.map

package/dist/utility.d.ts.map

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

package/package.json

@@ -1,7 +1,20 @@
 {
   "name": "@codeleap/types",
-  "version": "6.2.3",
+  "version": "6.8.0",
   "main": "src/index.ts",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
   "license": "UNLICENSED",
   "repository": {
     "url": "https://github.com/codeleap-uk/internal-libs-monorepo.git",
@@ -9,14 +22,15 @@
     "directory": "packages/types"
   },
   "devDependencies": {
-    "@codeleap/config": "6.2.3",
+    "@codeleap/config": "6.8.0",
     "ts-node-dev": "1.1.8"
   },
   "scripts": {
-    "build": "echo 'No build needed'"
+    "build": "tsc --build tsconfig.build.json",
+    "typecheck": "bun tsc --noEmit -p ./tsconfig.json"
   },
   "peerDependencies": {
-    "typescript": "5.5.2",
+    "typescript": "6.0.3",
     "react": "19.1.0"
   }
-}
+}

package/src/appSettings.ts

@@ -1,8 +1,14 @@
 import { DeepPartial, Matcher, LogType } from '.'
 
+/**
+ * Global configuration contract for a CodeLeap product.
+ * Every field is deeply optional so that apps only declare what they need;
+ * the runtime layer is responsible for supplying sensible defaults for
+ * any omitted fields.
+ */
 export type AppSettings = DeepPartial<{
   AppName: string
-  
+
   CompanyName: string
 
   CompanySuffix: string
@@ -96,6 +102,11 @@ export type AppSettings = DeepPartial<{
   }
 }>
 
+/**
+ * The subset of `AppSettings` that is safe to mutate at runtime
+ * (e.g. by environment-specific config files or feature flags).
+ * Structural settings such as app identity are intentionally excluded.
+ */
 export type ConfigurableSettings = Pick<
   AppSettings,
   'Fetch' | 'Logger' | 'ApiCredentials'

package/src/common.ts

@@ -1,5 +1,7 @@
+/** A `Promise<T>` that may carry an optional `abort()` method for cancellation (e.g. wrapping an `AbortController`). */
 export type CancellablePromise<T> = Promise<T> & { abort?: () => void }
 
+/** A browser `File` paired with an object-URL preview string. The preview must be revoked with `URL.revokeObjectURL` when no longer needed. */
 export type WebInputFile = {
   file: File
   preview: string
@@ -13,11 +15,17 @@ type MobileFileBase = {
   uri: string
 }
 
+/**
+ * React Native file descriptor, based on the shape returned by `react-native-document-picker`.
+ * The `Extra` parameter lets callers bolt on additional fields while omitting any that conflict with the base shape.
+ */
 export type MobileFile<Extra = {}> = Omit<MobileFileBase, keyof Extra> & Partial<Extra>
 
+/** A `MobileFile` paired with a local preview URI (e.g. a `file://` path or data URL). */
 export type FileWithPreview<Extra = {}> = {
   file: MobileFile<Extra>
   preview: string
 }
 
+/** Accepts either a bare `MobileFile` or a `FileWithPreview`. Use when a handler must cope with both the raw-pick and post-preview states. */
 export type MobileInputFile<Extra = {}> = FileWithPreview<Extra> | MobileFile<Extra>

package/src/google-places.ts

@@ -1,40 +1,48 @@
+/** A single component of a structured address (e.g. city, country, postal code), as returned by the Google Places API. */
 export type AddressComponent = {
   long_name: string
   short_name: string
   types: string[]
 }
 
+/** A geographic coordinate pair. */
 export type LatLng = {
   lat: number
   lng: number
 }
 
+/** A rectangular bounding box defined by its northeast and southwest corners. */
 export type GeometryBounds = {
   northeast: LatLng
   southwest: LatLng
 }
 
+/** Spatial metadata for a place: its precise location, geocode type, and recommended viewport. */
 export type Geometry = {
   location: LatLng
   location_type: string
   viewport: GeometryBounds
 }
 
+/** An Open Location Code (OLC) for a place, in both compound (human-readable) and global forms. */
 export type PlusCode = {
   compound_code: string
   global_code: string
 }
 
+/** Identifies a run of characters within an autocomplete suggestion that matched the user's query. */
 export type MatchedSubstring = {
   length: number
   offset: number
 }
 
+/** A token in the structured breakdown of an autocomplete prediction (e.g. city, country). */
 export type Term = {
   offset: number
   value: string
 }
 
+/** A reference to a place photo hosted by Google. Use `photo_reference` to fetch the image via the Places Photo API. */
 export type Photo = {
   height: number
   html_attributions: string[]
@@ -42,6 +50,10 @@ export type Photo = {
   width: number
 }
 
+/**
+ * Full detail record for a resolved place, as returned by the Places Details endpoint.
+ * `photos` and `website` are not guaranteed — some places (e.g. cities) omit them.
+ */
 export type PlaceDetails = {
   address_components: AddressComponent[]
   adr_address: string
@@ -64,10 +76,15 @@ export type PlaceDetails = {
   website?: string
 }
 
+/** `PlaceDetails` extended with a `plus_code` — present when the geocoder can assign an OLC to the result. */
 export type PlaceLatLngDetails = PlaceDetails & {
   plus_code: PlusCode
 }
 
+/**
+ * An autocomplete prediction from the Places Autocomplete API.
+ * `details` is populated only after a subsequent Details lookup is performed for this prediction.
+ */
 export type PlaceAddress = {
   description: string
   matched_substrings: MatchedSubstring[]
@@ -84,6 +101,10 @@ export type PlaceAddress = {
   details?: PlaceDetails
 }
 
+/**
+ * A reverse-geocoding result keyed by coordinates rather than a place ID.
+ * `details` is populated only after an explicit Details lookup.
+ */
 export type PlaceLatLng = {
   address_components: AddressComponent[]
   formatted_address: string

package/src/pathMapping.ts

@@ -1,3 +1,8 @@
+/**
+ * Lookup table that maps a depth counter `N` to `N - 1`.
+ * Used to decrement the recursion depth in types like `Paths` and `ReplaceRecursive`.
+ * Terminates at `0 → never` to halt infinite recursion.
+ */
 export type Prev = [
   never,
   0,
@@ -24,12 +29,21 @@ export type Prev = [
   ...0[]
 ]
 
+/**
+ * Concatenates two path segments with a `.` separator.
+ * Produces an empty junction when `P` is an empty string (root key case).
+ */
 export type Join<K, P> = K extends string | number
   ? P extends string | number
     ? `${K}${'' extends P ? '' : '.'}${P}`
     : never
   : never
 
+/**
+ * Recursively generates all valid dot-notation path strings for an object type `T`.
+ * Stops at `Date` values (treating them as leaves) and at depth `D` (default 2).
+ * Includes both the parent key and all descendant paths via `Join`.
+ */
 export type Paths<T, D extends number = 2> = [D] extends [never]
   ? never
   : (T extends Date
@@ -43,6 +57,11 @@ export type Paths<T, D extends number = 2> = [D] extends [never]
         : '')
     )
 
+/**
+ * Like `Paths` but unbounded in depth and always treats every object as
+ * a traversable node (no `Date` short-circuit). Prefer `Paths` for large
+ * or deeply nested types to avoid hitting the TS recursion limit.
+ */
 export type ExtractPath<T> = T extends object
   ? {
     [K in keyof T & (string | number)]: T[K] extends object

package/src/react-native-masked-text.ts

@@ -1,4 +1,4 @@
-// Type prop of TextInputMask.
+/** The mask format to apply. `'custom'` requires a `mask` pattern in `TextInputMaskOptionProp`. */
 export type TextInputMaskTypeProp =
     | 'credit-card'
     | 'cpf'
@@ -10,7 +10,14 @@ export type TextInputMaskTypeProp =
     | 'datetime'
     | 'custom'
 
-// Option prop of TextInputMask.
+/**
+ * Format options for `TextInputMask`. Which fields are relevant depends on the active `type`:
+ * - **money** — `precision`, `separator`, `delimiter`, `unit`, `suffixUnit`, `zeroCents`
+ * - **cel-phone** — `withDDD`, `dddMask`, `maskType`
+ * - **datetime** — `format` (moment.js pattern)
+ * - **credit-card** — `obfuscated`, `issuer`
+ * - **custom** — `mask`, `validator`, `getRawValue`, `translation`
+ */
 export interface TextInputMaskOptionProp {
     // Money type.
     precision?: number
@@ -39,7 +46,10 @@ export interface TextInputMaskOptionProp {
     translation?: { [s: string]: (val: string) => string | null | undefined }
 }
 
-// TextInputMask Props
+/**
+ * Props for the `TextInputMask` component from `react-native-masked-text`.
+ * Set `includeRawValueInChangeText` to receive the unmasked value alongside the formatted one in `onChangeText`.
+ */
 export interface TextInputMaskProps {
     type: TextInputMaskTypeProp
     options?: TextInputMaskOptionProp
@@ -48,4 +58,3 @@ export interface TextInputMaskProps {
     customTextInputProps?: Object
     includeRawValueInChangeText?: boolean
 }
-

package/src/typeGuards.ts

@@ -1,61 +1,73 @@
 import { AnyFunction } from './utility'
 import React from 'react'
 
-export function isNumber(x): x is number {
+export function isNumber(x: unknown): x is number {
   return typeof x === 'number'
 }
 
-export function isString(x): x is string {
+export function isString(x: unknown): x is string {
   return typeof x === 'string'
 }
-export function isObject(x): x is object {
+
+/** Returns `true` for any value whose `typeof` is `'object'`, including `null`. Pair with `isNil` when null must be excluded. */
+export function isObject(x: unknown): x is object {
   return typeof x === 'object'
 }
-export function isBoolean(x): x is boolean {
+
+export function isBoolean(x: unknown): x is boolean {
   return typeof x === 'boolean'
 }
-export function isFunction(x): x is (AnyFunction) {
+
+export function isFunction(x: unknown): x is (AnyFunction) {
   return typeof x === 'function'
 }
 
-export function isConstructor(x): x is (new (...args) => any) {
+/** Checks callable shape only — does not distinguish between regular functions and class constructors. Use `isConstructor` when the `new` signature matters. */
+export function isConstructor(x: unknown): x is (new (...args: unknown[]) => any) {
   return typeof x === 'function'
 }
-export function isArray(x): x is any[] {
+
+export function isArray(x: unknown): x is any[] {
   return Array.isArray(x)
 }
-export function isUndefined(x): x is undefined {
+
+export function isUndefined(x: unknown): x is undefined {
   return typeof x === 'undefined'
 }
 
-export function isNull(x): x is null {
+export function isNull(x: unknown): x is null {
   return x === null
 }
 
-export function isNil(x): x is null | undefined {
+export function isNil(x: unknown): x is null | undefined {
   return isNull(x) || isUndefined(x)
 }
 
-export function is<T >(x, Enum: T[]): x is T {
-  return Enum.includes(x)
+/** Checks membership of `x` in the `Enum` array — useful for narrowing to a specific string/number literal union at runtime. */
+export function is<T >(x: unknown, Enum: T[]): x is T {
+  return Enum.includes(x as T)
 }
 type Abstract<T> = Function & {prototype: T}
 
 type Constructor<T> = new (...args: any[]) => T
 type Class<T = any> = Abstract<T> | Constructor<T>
 
-export function isInstance<T extends Class, X = T extends Class<infer X> ? X : never>(x, cls: T): x is X {
-  return x instanceof cls
+/** Works for both concrete classes and abstract classes via the `Abstract<T>` branch. */
+export function isInstance<T extends Class, X = T extends Class<infer X> ? X : never>(x: unknown, cls: T): x is X {
+  return x instanceof (cls as Constructor<X>)
 }
 
-export function isElement(x): x is React.ReactElement {
+/** Delegates to `React.isValidElement` — returns `true` for JSX elements but `false` for plain components (functions/classes). */
+export function isElement(x: unknown): x is React.ReactElement {
   return React.isValidElement(x)
 }
 
+/** Accepts both a component type (function/class) and a rendered element — use when a prop can receive either form. */
 export function isComponentOrElement<P>(x: any): x is React.ComponentType<P> | React.ReactElement {
   return isFunction(x) || isElement(x)
 }
 
-export function isPromise(x): x is Promise<any> {
-  return isFunction(x?.then) && isFunction(x?.catch)
-}
+/** Duck-types against `.then` and `.catch` rather than `instanceof Promise`, so it works across realms and custom thenables. */
+export function isPromise(x: unknown): x is Promise<any> {
+  return isFunction((x as any)?.then) && isFunction((x as any)?.catch)
+}

package/src/utility.ts

@@ -1,24 +1,36 @@
 import { ReactNode } from 'react'
 import { Prev } from './pathMapping'
 /* eslint-disable no-unused-vars */
+
+/** Matches any callable — use as a constraint, not as a call signature. */
 export type AnyFunction = (...args: any[]) => any
 
+/** Matches any `Record<string, any>`. Useful as a generic object constraint. */
 export type AnyRecord = Record<string, any>
 
+/** Constrains a record whose values must all be strings. */
 export type StringRecord = Record<string, string>
 
+/** Makes every property in `T` `readonly` shallowly. Prefer this over the built-in `Readonly<T>` only when you need the mapped-type form for composability. */
 export type ReadOnly<T> = {
   readonly [Property in keyof T]: T[Property];
 }
 
+/** Collects the keys of every nested object value in `T`. Only one level deep — grandchildren are not included. */
 export type NestedKeys<T> = {
   [K in keyof T]: T[K] extends Record<any, any> ? keyof T[K] : never;
 }[keyof T]
 
+/** Typed function with explicit `Args` and `Return` — use instead of `AnyFunction` when the signature matters. */
 export type FunctionType<Args extends any[], Return> = (
   ...args: Args
 ) => Return
 
+/**
+ * Recursively makes every property optional.
+ * `null` and `RegExp` values are widened to `any` to avoid
+ * their structural members being partially unwrapped.
+ */
 export type DeepPartial<T> = Partial<{
   [Property in keyof T]: T[Property] extends Record<string, any>
     ? T[Property] extends null|RegExp
@@ -40,6 +52,11 @@ type EnumerateInternal<A extends Array<unknown>, N extends number> = {
   1: EnumerateInternal<PrependNextNum<A>, N>
 }[N extends A['length'] ? 0 : 1]
 
+/**
+ * Produces a union of integers from `0` up to (but not including) `N`.
+ * Useful for constraining numeric literals without listing them by hand.
+ * @example `Enumerate<5>` → `0 | 1 | 2 | 3 | 4`
+ */
 export type Enumerate<N extends number> = EnumerateInternal<
   [],
   N
@@ -47,11 +64,16 @@ export type Enumerate<N extends number> = EnumerateInternal<
   ? E
   : never
 
+/**
+ * Produces a union of integers in the half-open interval `[FROM, TO)`.
+ * @example `Range<2, 5>` → `2 | 3 | 4`
+ */
 export type Range<FROM extends number, TO extends number> = Exclude<
   Enumerate<TO>,
   Enumerate<FROM>
 >
 
+/** Maps each key of a component/variant union `C` to an optional CSS value. Used to type per-variant style overrides. */
 export type StylesOf<
   C extends string | number | symbol = any,
   CSS = any
@@ -63,6 +85,11 @@ type IsDict<T> = T extends AnyFunction
   ? true
   : false
 
+/**
+ * Walks every property of `T` and replaces occurrences of `Replace` with `With`.
+ * The depth counter `D` (default 10) prevents infinite recursion on circular types.
+ * Functions are left untouched even if they satisfy the `Replace` constraint.
+ */
 export type ReplaceRecursive<T, Replace, With, D extends number = 10> = [D] extends [never] ? never : {
   [Property in keyof T]: T[Property] extends Replace
     ? With
@@ -70,64 +97,103 @@ export type ReplaceRecursive<T, Replace, With, D extends number = 10> = [D] exte
     ? ReplaceRecursive<T[Property], Replace, With, Prev[D]>
     : T[Property];
 }
+
+/**
+ * Like `Omit<T, K>` but preserves the exact property types without the
+ * homomorphic mapped-type widening that `Omit` can introduce on complex generics.
+ */
 export type SmartOmit<T, K extends keyof T> = {
   [Property in Exclude<keyof T, K>]: T[Property];
 }
 
+/** Extracts the props type of a React component `T`, optionally omitting keys listed in `Exclude`. */
 export type PropsOf<T, Exclude extends string = ''> = T extends React.ComponentType<infer P> ? Omit<P, Exclude> : any
 
+/** A dictionary with string keys and homogeneous values of type `T`. Prefer over `Record<string, T>` when the key set is unknown at compile time. */
 export type Hashmap<T> = {
   [key: string]: T
 }
 
+/** Unwraps the resolved value of a `Promise<U>`. Passes non-promise types through unchanged. */
 export type UnwrapPromise<T> = T extends Promise<infer U> ? U : T
 
+/** Extracts the resolved return type of an async function. Returns `never` for non-async functions. */
 export type AsyncReturnType<T> = T extends (...args: any[]) => Promise<infer U> ? U : never
 
+/**
+ * Extracts the `variants` prop type from a component that accepts `{ variants: V }`.
+ * Falls back to `string[]` when the inferred type is not a string or string array.
+ */
 export type VariantsOf<T> =T extends ((props: {variants: infer V}) => any) ?
   (V extends (string | string[]) ? V : (string[]))
 
   : (string[])
 
+/** Strips `string` from a union, leaving only the non-string literal members. Useful for extracting enum-like members from a mixed union. */
 export type VariantList<T> = Exclude<T, string>
 
+/** Unwraps the element type that a `React.Ref<U>` points to. */
 export type GetRefType<T> = T extends React.Ref<infer U> ? U : never
 
+/**
+ * Returns a union of the keys of `T` whose value type extends `Filter`.
+ * Uses a sentinel string `'__never__'` internally to avoid distributing `never` in the union.
+ */
 export type FilterKeys<T, Filter = any> = Exclude<{
   [P in keyof T]: T[P] extends Filter ? P : '__never__'
 }[keyof T], '__never__'>
 
+/** The tuple returned by `React.useState<T>()` — useful for passing state as a single prop. */
 export type ReactState<T = any> = [
   T,
   React.Dispatch<React.SetStateAction<T>>
 ]
 
+/**
+ * Expands a state tuple into a props object with the value key and a `set<Name>` setter key.
+ * @example `ReactStateProps<'count', number>` → `{ count: number; setCount: Dispatch<...> }`
+ */
 export type ReactStateProps<Name extends string, T = any, State extends ReactState<T> = ReactState<T>> = {
   [P in Name as `set${Capitalize<Name>}`]: State[1]
 } & {
   [P in Name ]: State[0]
 }
 
+/** Union of every ref shape React accepts — callback refs, `MutableRefObject`, `ForwardedRef`, and the legacy form. Use when a utility must accept any ref flavour. */
 export type AnyRef<T> = React.Ref<T> | React.MutableRefObject<T> | ((instance: T | null) => void) | null | React.ForwardedRef<T> | React.LegacyRef<T>
 
+/** Produces a union of valid indices for a readonly tuple `T`. Excludes the `length` value itself. */
 export type Indices<T extends readonly any[]> = Exclude<Partial<T>['length'], T['length']>
 
+/** Replaces the types of specific keys `Keys` in `Object` with `With`, leaving all other keys intact. */
 export type Replace<Object, Keys extends keyof Object, With = any> = Omit<Object, Keys> & {
   [P in Keys]: With
 }
 
+/**
+ * Flexible predicate type used for filtering or matching.
+ * Accepts a plain string, a partial `RegExp` descriptor, or a two-argument predicate
+ * that receives the value/key and a type discriminant `T`.
+ */
 export type Matcher<T> = string | Partial<RegExp> | FunctionType<[valueOrKey: any, type: T], boolean>
 
+/** Logger severity levels, including `'silent'` to suppress all output. */
 export type LogType = 'info' | 'debug' | 'warn' | 'error' | 'log' | 'silent'
 
+/** Drops the first argument of a function and returns the remaining parameter types. */
 export type SecondToLastArguments<T extends AnyFunction> = T extends ((...args: [infer _, ...infer Rest]) => any) ? Rest : never
 
+/** An array of `{ label, value }` pairs — the canonical shape for select/dropdown data sources. */
 export type Options<T> = { label: string; value: T }[]
 
+/** A single entry from an `Options<T>` array. */
 export type Option<T> = Options<T>[number]
 
+/** A label that can be a plain string or any React-renderable node. */
 export type Label = string | ReactNode
 
+/** Union of all value types in `T`. Equivalent to `T[keyof T]`. */
 export type ValueOf<T> = T[keyof T]
 
+/** Alias for `keyof T` — useful when you need to pass the key union as a generic argument. */
 export type Keyof<T> = keyof T

package/package.json.bak

@@ -1,22 +0,0 @@
-{
-  "name": "@codeleap/types",
-  "version": "6.2.3",
-  "main": "src/index.ts",
-  "license": "UNLICENSED",
-  "repository": {
-    "url": "https://github.com/codeleap-uk/internal-libs-monorepo.git",
-    "type": "git",
-    "directory": "packages/types"
-  },
-  "devDependencies": {
-    "@codeleap/config": "workspace:*",
-    "ts-node-dev": "1.1.8"
-  },
-  "scripts": {
-    "build": "echo 'No build needed'"
-  },
-  "peerDependencies": {
-    "typescript": "5.5.2",
-    "react": "19.1.0"
-  }
-}