@plyaz/config 1.2.1 → 1.3.0

package/dist/locale/currencies.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Currency Code Constants
+ *
+ * ISO 4217 currency codes for international currencies.
+ *
+ * @module locale/currencies
+ */
+/**
+ * Common currency codes (ISO 4217)
+ */
+export declare const CURRENCY_CODES: {
+    readonly USD: "USD";
+    readonly EUR: "EUR";
+    readonly GBP: "GBP";
+    readonly JPY: "JPY";
+    readonly CHF: "CHF";
+    readonly CAD: "CAD";
+    readonly AUD: "AUD";
+    readonly CNY: "CNY";
+    readonly INR: "INR";
+    readonly KRW: "KRW";
+    readonly SGD: "SGD";
+    readonly HKD: "HKD";
+    readonly TWD: "TWD";
+    readonly THB: "THB";
+    readonly IDR: "IDR";
+    readonly MYR: "MYR";
+    readonly PHP: "PHP";
+    readonly VND: "VND";
+    readonly BDT: "BDT";
+    readonly PKR: "PKR";
+    readonly LKR: "LKR";
+    readonly SEK: "SEK";
+    readonly NOK: "NOK";
+    readonly DKK: "DKK";
+    readonly PLN: "PLN";
+    readonly CZK: "CZK";
+    readonly HUF: "HUF";
+    readonly RON: "RON";
+    readonly BGN: "BGN";
+    readonly HRK: "HRK";
+    readonly RSD: "RSD";
+    readonly ISK: "ISK";
+    readonly BRL: "BRL";
+    readonly MXN: "MXN";
+    readonly ARS: "ARS";
+    readonly CLP: "CLP";
+    readonly COP: "COP";
+    readonly PEN: "PEN";
+    readonly UYU: "UYU";
+    readonly VES: "VES";
+    readonly BOB: "BOB";
+    readonly PYG: "PYG";
+    readonly CRC: "CRC";
+    readonly GTQ: "GTQ";
+    readonly HNL: "HNL";
+    readonly NIO: "NIO";
+    readonly PAB: "PAB";
+    readonly DOP: "DOP";
+    readonly JMD: "JMD";
+    readonly TTD: "TTD";
+    readonly BBD: "BBD";
+    readonly AED: "AED";
+    readonly SAR: "SAR";
+    readonly QAR: "QAR";
+    readonly KWD: "KWD";
+    readonly BHD: "BHD";
+    readonly OMR: "OMR";
+    readonly JOD: "JOD";
+    readonly ILS: "ILS";
+    readonly TRY: "TRY";
+    readonly IQD: "IQD";
+    readonly IRR: "IRR";
+    readonly LBP: "LBP";
+    readonly SYP: "SYP";
+    readonly ZAR: "ZAR";
+    readonly NGN: "NGN";
+    readonly EGP: "EGP";
+    readonly KES: "KES";
+    readonly GHS: "GHS";
+    readonly MAD: "MAD";
+    readonly TND: "TND";
+    readonly DZD: "DZD";
+    readonly ETB: "ETB";
+    readonly TZS: "TZS";
+    readonly UGX: "UGX";
+    readonly ZMW: "ZMW";
+    readonly BWP: "BWP";
+    readonly MUR: "MUR";
+    readonly NZD: "NZD";
+    readonly FJD: "FJD";
+    readonly PGK: "PGK";
+    readonly RUB: "RUB";
+    readonly UAH: "UAH";
+    readonly BYN: "BYN";
+    readonly KZT: "KZT";
+    readonly UZS: "UZS";
+    readonly AZN: "AZN";
+    readonly GEL: "GEL";
+    readonly AMD: "AMD";
+    readonly BTC: "BTC";
+    readonly ETH: "ETH";
+    readonly USDT: "USDT";
+    readonly USDC: "USDC";
+};
+/**
+ * Currency metadata
+ */
+export declare const CURRENCY_INFO: {
+    /**
+     * Currencies with no decimal places
+     */
+    readonly NO_DECIMAL_CURRENCIES: readonly ["JPY", "KRW", "VND", "IDR", "CLP", "ISK", "TWD"];
+    /**
+     * Currencies with 3 decimal places
+     */
+    readonly THREE_DECIMAL_CURRENCIES: readonly ["BHD", "IQD", "JOD", "KWD", "OMR", "TND"];
+    /**
+     * Major reserve currencies
+     */
+    readonly RESERVE_CURRENCIES: readonly ["USD", "EUR", "GBP", "JPY", "CNY"];
+    /**
+     * G7 currencies
+     */
+    readonly G7_CURRENCIES: readonly ["USD", "EUR", "GBP", "JPY", "CAD"];
+    /**
+     * Default decimal places for most currencies
+     */
+    readonly DEFAULT_DECIMAL_PLACES: 2;
+};
+/**
+ * Type exports
+ */
+export type CurrencyCode = (typeof CURRENCY_CODES)[keyof typeof CURRENCY_CODES];
+export type CurrencyInfo = (typeof CURRENCY_INFO)[keyof typeof CURRENCY_INFO];

package/dist/locale/formats.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Locale and Date Formatting Constants
+ *
+ * Constants for formatting dates, numbers, and locale-specific values.
+ *
+ * @module locale/formats
+ */
+/**
+ * Number and currency formatting constants
+ */
+export declare const LOCALE_FORMATS: {
+    /**
+     * Locale separator character
+     */
+    readonly LOCALE_SEPARATOR: "-";
+    /**
+     * BCP 47 separator character
+     */
+    readonly BCP47_SEPARATOR: "-";
+    /**
+     * Currency decimal places
+     */
+    readonly CURRENCY_DECIMALS: 2;
+    /**
+     * Currency symbol placement (before/after)
+     */
+    readonly CURRENCY_SYMBOL_BEFORE: true;
+    /**
+     * Thousands separator
+     */
+    readonly THOUSANDS_SEPARATOR: ",";
+    /**
+     * Decimal separator
+     */
+    readonly DECIMAL_SEPARATOR: ".";
+    /**
+     * Maximum locale string length
+     */
+    readonly MAX_LOCALE_LENGTH: 35;
+    /**
+     * Minimum locale string length
+     */
+    readonly MIN_LOCALE_LENGTH: 2;
+    /**
+     * Percentage decimal places
+     */
+    readonly PERCENTAGE_DECIMALS: 2;
+    /**
+     * Default number of fraction digits
+     */
+    readonly DEFAULT_FRACTION_DIGITS: 2;
+    /**
+     * Maximum fraction digits
+     */
+    readonly MAX_FRACTION_DIGITS: 20;
+};
+/**
+ * Date and time formatting patterns
+ */
+export declare const DATE_FORMATS: {
+    /**
+     * ISO 8601 date format
+     */
+    readonly ISO_DATE: "YYYY-MM-DD";
+    /**
+     * ISO 8601 datetime format
+     */
+    readonly ISO_DATETIME: "YYYY-MM-DDTHH:mm:ss.sssZ";
+    /**
+     * ISO 8601 time format
+     */
+    readonly ISO_TIME: "HH:mm:ss";
+    /**
+     * US date format
+     */
+    readonly US_DATE: "MM/DD/YYYY";
+    /**
+     * European date format
+     */
+    readonly EU_DATE: "DD/MM/YYYY";
+    /**
+     * UK date format
+     */
+    readonly UK_DATE: "DD/MM/YYYY";
+    /**
+     * Japanese date format
+     */
+    readonly JP_DATE: "YYYY/MM/DD";
+    /**
+     * Short date format
+     */
+    readonly SHORT_DATE: "MMM DD";
+    /**
+     * Long date format
+     */
+    readonly LONG_DATE: "MMMM DD, YYYY";
+    /**
+     * Full date format
+     */
+    readonly FULL_DATE: "dddd, MMMM DD, YYYY";
+    /**
+     * Time format 12-hour
+     */
+    readonly TIME_12H: "hh:mm A";
+    /**
+     * Time format 24-hour
+     */
+    readonly TIME_24H: "HH:mm";
+    /**
+     * Time with seconds 12-hour
+     */
+    readonly TIME_12H_SECONDS: "hh:mm:ss A";
+    /**
+     * Time with seconds 24-hour
+     */
+    readonly TIME_24H_SECONDS: "HH:mm:ss";
+    /**
+     * Relative time threshold in seconds
+     */
+    readonly RELATIVE_TIME_THRESHOLD: 86400;
+    /**
+     * Month/Year format
+     */
+    readonly MONTH_YEAR: "MMMM YYYY";
+    /**
+     * Short month/Year format
+     */
+    readonly SHORT_MONTH_YEAR: "MMM YYYY";
+    /**
+     * Year only format
+     */
+    readonly YEAR_ONLY: "YYYY";
+};
+/**
+ * Text direction constants
+ */
+export declare const TEXT_DIRECTION: {
+    /**
+     * Left-to-right
+     */
+    readonly LTR: "ltr";
+    /**
+     * Right-to-left
+     */
+    readonly RTL: "rtl";
+    /**
+     * Auto-detect
+     */
+    readonly AUTO: "auto";
+};
+/**
+ * Type exports
+ */
+export type LocaleFormat = (typeof LOCALE_FORMATS)[keyof typeof LOCALE_FORMATS];
+export type DateFormat = (typeof DATE_FORMATS)[keyof typeof DATE_FORMATS];
+export type TextDirectionValue = (typeof TEXT_DIRECTION)[keyof typeof TEXT_DIRECTION];

package/dist/locale/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Locale Module
+ *
+ * Central export point for all localization-related constants and utilities.
+ *
+ * @module locale
+ */
+export * from './iso';
+export * from './formats';
+export * from './phone';
+export * from './address';
+export * from './currencies';
+export * from './countries';
+export * from './languages';

package/dist/locale/iso.d.ts

@@ -0,0 +1,73 @@
+/**
+ * ISO Standards Constants
+ *
+ * International Organization for Standardization (ISO) code lengths
+ * and standards used for country codes, language codes, currencies, etc.
+ *
+ * @module locale/iso
+ */
+/**
+ * ISO code length standards
+ */
+export declare const ISO_STANDARDS: {
+    /**
+     * ISO 3166-1 alpha-2 country code length (e.g., "US", "GB", "FR")
+     */
+    readonly ISO_COUNTRY_CODE_LENGTH: 2;
+    /**
+     * ISO 3166-1 alpha-3 country code length (e.g., "USA", "GBR", "FRA")
+     */
+    readonly ISO_COUNTRY_CODE_ALPHA3_LENGTH: 3;
+    /**
+     * ISO 639-1 language code length (e.g., "en", "fr", "es")
+     */
+    readonly ISO_LANGUAGE_CODE_LENGTH: 2;
+    /**
+     * ISO 639-2 language code length (e.g., "eng", "fra", "spa")
+     */
+    readonly ISO_LANGUAGE_CODE_ALPHA3_LENGTH: 3;
+    /**
+     * ISO 4217 currency code length (e.g., "USD", "EUR", "GBP")
+     */
+    readonly ISO_CURRENCY_CODE_LENGTH: 3;
+    /**
+     * ISO 8601 date format length (YYYY-MM-DD)
+     */
+    readonly ISO_DATE_LENGTH: 10;
+    /**
+     * ISO 8601 datetime format length (YYYY-MM-DDTHH:mm:ss.sssZ)
+     */
+    readonly ISO_DATETIME_LENGTH: 24;
+    /**
+     * ISO 8601 time format length (HH:mm:ss)
+     */
+    readonly ISO_TIME_LENGTH: 8;
+    /**
+     * ISO week date format length (YYYY-Www)
+     */
+    readonly ISO_WEEK_DATE_LENGTH: 8;
+    /**
+     * BCP 47 language tag minimum length (e.g., "en")
+     */
+    readonly BCP47_MIN_LENGTH: 2;
+    /**
+     * BCP 47 language tag with region (e.g., "en-US")
+     */
+    readonly BCP47_WITH_REGION_LENGTH: 5;
+    /**
+     * RFC 5646 maximum language tag length
+     */
+    readonly RFC5646_MAX_LENGTH: 35;
+    /**
+     * ISO 3166-1 numeric country code length
+     */
+    readonly ISO_NUMERIC_COUNTRY_CODE_LENGTH: 3;
+    /**
+     * ISO 639-3 language code length
+     */
+    readonly ISO_639_3_LENGTH: 3;
+};
+/**
+ * Type for ISO standard values
+ */
+export type IsoStandard = (typeof ISO_STANDARDS)[keyof typeof ISO_STANDARDS];

package/dist/locale/languages.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Common Locale Constants
+ *
+ * BCP 47 language tags for common locales worldwide.
+ *
+ * @module locale/locales
+ */
+/**
+ * Locale regions
+ */
+export declare const LOCALE_REGIONS: {
+    readonly AMERICAS: readonly ["en-US", "es-MX", "pt-BR", "en-CA", "fr-CA"];
+    readonly EUROPE: readonly ["en-GB", "de-DE", "fr-FR", "it-IT", "es-ES", "nl-NL"];
+    readonly ASIA_PACIFIC: readonly ["zh-CN", "ja-JP", "ko-KR", "hi-IN", "en-AU"];
+    readonly MIDDLE_EAST_AFRICA: readonly ["ar-SA", "he-IL", "tr-TR", "en-ZA"];
+};
+/**
+ * Type exports
+ */
+export type LocaleRegion = (typeof LOCALE_REGIONS)[keyof typeof LOCALE_REGIONS];

package/dist/locale/phone.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Phone Number Formatting Constants
+ *
+ * Constants for phone number validation and formatting across different countries.
+ *
+ * @module locale/phone
+ */
+/**
+ * Phone number formats and validation
+ */
+export declare const PHONE_FORMATS: {
+    /**
+     * International prefix
+     */
+    readonly INTERNATIONAL_PREFIX: "+";
+    /**
+     * International direct dialing prefix
+     */
+    readonly IDD_PREFIX: "00";
+    /**
+     * US country code
+     */
+    readonly US_COUNTRY_CODE: "1";
+    /**
+     * UK country code
+     */
+    readonly UK_COUNTRY_CODE: "44";
+    /**
+     * Germany country code
+     */
+    readonly DE_COUNTRY_CODE: "49";
+    /**
+     * France country code
+     */
+    readonly FR_COUNTRY_CODE: "33";
+    /**
+     * Japan country code
+     */
+    readonly JP_COUNTRY_CODE: "81";
+    /**
+     * China country code
+     */
+    readonly CN_COUNTRY_CODE: "86";
+    /**
+     * India country code
+     */
+    readonly IN_COUNTRY_CODE: "91";
+    /**
+     * Brazil country code
+     */
+    readonly BR_COUNTRY_CODE: "55";
+    /**
+     * US phone number length (without country code)
+     */
+    readonly US_PHONE_LENGTH: 10;
+    /**
+     * UK phone number length (without country code)
+     */
+    readonly UK_PHONE_LENGTH: 10;
+    /**
+     * International phone minimum length
+     */
+    readonly MIN_PHONE_LENGTH: 7;
+    /**
+     * International phone maximum length
+     */
+    readonly MAX_PHONE_LENGTH: 15;
+    /**
+     * E.164 format maximum length (with +)
+     */
+    readonly E164_MAX_LENGTH: 16;
+    /**
+     * E.164 format minimum length (with +)
+     */
+    readonly E164_MIN_LENGTH: 8;
+    /**
+     * Area code length (US)
+     */
+    readonly US_AREA_CODE_LENGTH: 3;
+    /**
+     * Exchange code length (US)
+     */
+    readonly US_EXCHANGE_CODE_LENGTH: 3;
+    /**
+     * Line number length (US)
+     */
+    readonly US_LINE_NUMBER_LENGTH: 4;
+    /**
+     * Extension maximum length
+     */
+    readonly MAX_EXTENSION_LENGTH: 6;
+    /**
+     * Country code maximum length
+     */
+    readonly MAX_COUNTRY_CODE_LENGTH: 3;
+    /**
+     * National number maximum length
+     */
+    readonly MAX_NATIONAL_NUMBER_LENGTH: 15;
+};
+/**
+ * Phone number format patterns
+ */
+export declare const PHONE_PATTERNS: {
+    /**
+     * US phone format pattern
+     */
+    readonly US_FORMAT: "(XXX) XXX-XXXX";
+    /**
+     * UK phone format pattern
+     */
+    readonly UK_FORMAT: "XXXX XXX XXXX";
+    /**
+     * International format pattern
+     */
+    readonly INTERNATIONAL_FORMAT: "+X XXX XXX XXXX";
+    /**
+     * E.164 format pattern
+     */
+    readonly E164_FORMAT: "+XXXXXXXXXXXX";
+    /**
+     * Extension format
+     */
+    readonly EXTENSION_FORMAT: "ext. XXXX";
+};
+/**
+ * Type exports
+ */
+export type PhoneFormat = (typeof PHONE_FORMATS)[keyof typeof PHONE_FORMATS];
+export type PhonePattern = (typeof PHONE_PATTERNS)[keyof typeof PHONE_PATTERNS];

package/dist/locales.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Default locale for the application (ISO 639-1 language code)
+ */
+export declare const DEFAULT_LOCALE = "en";
+/**
+ * List of supported locale codes for the application
+ */
+export declare const SUPPORTED_LOCALES: readonly ["en", "es", "pt"];
+/**
+ * Default timezone for the application (IANA timezone identifier)
+ */
+export declare const TIMEZONE = "America/Sao_Paulo";
+/**
+ * Default timezone offset from UTC
+ */
+export declare const TIMEZONE_OFFSET = -3;
+/**
+ * Default country code (ISO 3166-1 alpha-2)
+ */
+export declare const DEFAULT_COUNTRY = "BR";
+/**
+ * Default currency code (ISO 4217)
+ */
+export declare const DEFAULT_CURRENCY = "BRL";
+/**
+ * Default language code (ISO 639-1)
+ */
+export declare const DEFAULT_LANGUAGE = "en";
+/**
+ * Type for supported locales
+ */
+export type SupportedLocale = (typeof SUPPORTED_LOCALES)[number];

package/dist/math/constants.d.ts

@@ -187,6 +187,10 @@ export declare const NUMBER_SYSTEM: {
  * Mathematical and percentage constants
  */
 export declare const MATH_CONSTANTS: {
+    /**
+     * Maximum percentage value
+     */
+    readonly PERCENTAGE_MAX: 100;
     /**
      * Half value (50%)
      */

package/dist/providers/alchemy.d.ts

@@ -1,11 +1,38 @@
+/**
+ * Alchemy blockchain provider configuration
+ */
 export declare const ALCHEMY_CONFIG: {
+    /**
+     * Alchemy API key from environment
+     */
     apiKey: string;
+    /**
+     * RPC URLs for different blockchain networks
+     */
     rpcUrls: {
+        /**
+         * Ethereum mainnet RPC URL
+         */
         ethereum: string;
+        /**
+         * Polygon mainnet RPC URL
+         */
         polygon: string;
+        /**
+         * Arbitrum mainnet RPC URL
+         */
         arbitrum: string;
+        /**
+         * Optimism mainnet RPC URL
+         */
         optimism: string;
+        /**
+         * Base mainnet RPC URL
+         */
         base: string;
+        /**
+         * Solana mainnet RPC URL
+         */
         solana: string;
     };
 };

package/dist/providers/oauth.d.ts

@@ -1,20 +1,68 @@
+/**
+ * OAuth provider configurations
+ */
 export declare const OAUTH_PROVIDERS: {
+    /**
+     * Google OAuth configuration
+     */
     readonly google: {
+        /**
+         * Google OAuth client ID
+         */
         readonly clientId: string;
+        /**
+         * Google OAuth client secret
+         */
         readonly clientSecret: string;
+        /**
+         * Google OAuth redirect URI
+         */
         readonly redirectUri: string;
+        /**
+         * Google OAuth permission scopes
+         */
         readonly scopes: readonly ["openid", "profile", "email"];
     };
+    /**
+     * Discord OAuth configuration
+     */
     readonly discord: {
+        /**
+         * Discord OAuth client ID
+         */
         readonly clientId: string;
+        /**
+         * Discord OAuth client secret
+         */
         readonly clientSecret: string;
+        /**
+         * Discord OAuth redirect URI
+         */
         readonly redirectUri: string;
+        /**
+         * Discord OAuth permission scopes
+         */
         readonly scopes: readonly ["identify", "email"];
     };
+    /**
+     * Facebook OAuth configuration
+     */
     readonly facebook: {
+        /**
+         * Facebook OAuth client ID
+         */
         readonly clientId: string;
+        /**
+         * Facebook OAuth client secret
+         */
         readonly clientSecret: string;
+        /**
+         * Facebook OAuth redirect URI
+         */
         readonly redirectUri: string;
+        /**
+         * Facebook OAuth permission scopes
+         */
         readonly scopes: readonly ["public_profile", "email"];
     };
 };

package/dist/security.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Security and compliance configuration
+ */
 export declare const SECURITY: {
+    /**
+     * ISO country codes for blocked regions (sanctions/compliance)
+     * KP: North Korea, SY: Syria, IR: Iran, CU: Cuba, SD: Sudan, SO: Somalia
+     * UA-CR: Ukraine-Crimea, UA-DP: Ukraine-Donetsk, UA-LU: Ukraine-Luhansk
+     */
     readonly BLOCKED_REGIONS: readonly ["KP", "SY", "IR", "CU", "SD", "SO", "UA-CR", "UA-DP", "UA-LU"];
 };

package/dist/social.cjs

@@ -1,4 +1,4 @@
 'use strict';// @plyaz package - Built with tsup
-var t={x:"https://x.com/Plyaz_",instagram:"https://instagram.com/plyaz_",linkedin:"https://linkedin.com/company/plyaz"},o={docs:"https://plyaz.gitbook.io/plyaz",community:"https://community.plyaz.co.uk",support:"mailto:help@plyaz.co.uk"};
-exports.PRODUCT_LINKS=o;exports.SOCIAL_LINKS=t;//# sourceMappingURL=social.cjs.map
+var t={x:"https://x.com/Plyaz_",instagram:"https://instagram.com/plyaz_",linkedin:"https://linkedin.com/company/plyaz"},o={docs:"https://plyaz.gitbook.io/plyaz",community:"https://community.plyaz.co.uk",support:"mailto:help@plyaz.co.uk"},p={INITIAL_POSTS_TO_SHOW:3,POSTS_INCREMENT:3,ANIMATION_DELAY:100};
+exports.BLOG=p;exports.PRODUCT_LINKS=o;exports.SOCIAL_LINKS=t;//# sourceMappingURL=social.cjs.map
 //# sourceMappingURL=social.cjs.map