@koshmoney/countries 1.0.1-beta.3 → 1.0.1-beta.4

package/README.md

@@ -36,8 +36,27 @@ yarn add @koshmoney/countries
 pnpm add @koshmoney/countries
 ```
 
+### TypeScript Configuration
+
+Subpath imports work automatically with modern TypeScript settings (`moduleResolution: "node16"`, `"nodenext"`, or `"bundler"`).
+
+For older configurations (`moduleResolution: "node"`), the library includes `typesVersions` fallback, so no additional configuration is needed.
+
+## Module Types
+
+This library separates modules for optimal bundle size:
+
+| Type | Modules | Import Path |
+|------|---------|-------------|
+| **Core** | `country`, `subdivision`, `postalCode` | `@koshmoney/countries` |
+| **Specialized** | `currency`, `dialCode`, `geography`, `membership` | `@koshmoney/countries/{module}` |
+
+**Core modules** are included in the main bundle. **Specialized modules** require subpath imports to keep your bundle small.
+
 ## Quick Start
 
+### Core Modules
+
 ```typescript
 import { country, subdivision, postalCode } from '@koshmoney/countries';
 
@@ -66,7 +85,11 @@ postalCode.isValid('US', '90210');     // true
 postalCode.isValid('GB', 'SW1A 1AA');  // true
 postalCode.getName('US');              // 'ZIP Code'
 postalCode.getName('IN');              // 'PIN Code'
+```
+
+### Specialized Modules (subpath imports)
 
+```typescript
 // Currency data
 import { currency } from '@koshmoney/countries/currency';
 currency.getCurrency('US');
@@ -214,9 +237,14 @@ currency.getCurrencyCode('DE');        // 'EUR'
 currency.getCurrencySymbol('IN');      // '₹'
 currency.getCurrencyName('BR');        // 'Brazilian Real'
 
-// Reverse lookup
-currency.getCountriesByCurrency('EUR');
+// Check if country uses a specific currency
+currency.usesCurrency('FR', 'EUR');    // true
+currency.usesCurrency('GB', 'EUR');    // false
+
+// Reverse lookup - get all countries using a currency
+currency.countriesUsingCurrency('EUR');
 // ['AD', 'AT', 'BE', 'CY', 'DE', 'EE', 'ES', 'FI', 'FR', ...]
+currency.getCountriesByCurrency('EUR'); // alias for countriesUsingCurrency
 ```
 
 ### Dial Code Functions
@@ -267,12 +295,14 @@ geography.getRegion('BR');             // 'South America'
 geography.getGeography('FR');
 // { continent: 'Europe', region: 'Western Europe' }
 
-// Reverse lookups
-geography.getCountriesByContinent('Europe');
+// Reverse lookups - get all countries in a continent/region
+geography.countriesInContinent('Europe');
 // ['AD', 'AL', 'AT', 'AX', 'BA', 'BE', ...]
+geography.getCountriesByContinent('Europe'); // alias for countriesInContinent
 
-geography.getCountriesByRegion('Eastern Asia');
+geography.countriesInRegion('Eastern Asia');
 // ['CN', 'HK', 'JP', 'KP', 'KR', 'MO', 'MN', 'TW']
+geography.getCountriesByRegion('Eastern Asia'); // alias for countriesInRegion
 
 // Get all continents/regions
 geography.getContinents();
@@ -311,6 +341,10 @@ membership.isEurozone('SE');           // false (Sweden uses SEK)
 membership.isSchengen('FR');           // true
 membership.isSchengen('IE');           // false (Ireland not in Schengen)
 
+// Generic membership check
+membership.isMember('FR', 'EU');       // true
+membership.isMember('CH', 'SEPA');     // true
+
 // Get all memberships at once
 membership.getMemberships('FR');
 // { EU: true, SEPA: true, EEA: true, Eurozone: true, Schengen: true }
@@ -364,7 +398,9 @@ import {
   getCurrencyCode,
   getCurrencySymbol,
   getCurrencyName,
-  getCountriesByCurrency,
+  usesCurrency,
+  countriesUsingCurrency,
+  getCountriesByCurrency, // alias for countriesUsingCurrency
 } from '@koshmoney/countries/currency';
 
 // Dial code functions
@@ -381,8 +417,10 @@ import {
   getContinent,
   getRegion,
   getGeography,
-  getCountriesByContinent,
-  getCountriesByRegion,
+  countriesInContinent,
+  countriesInRegion,
+  getCountriesByContinent, // alias for countriesInContinent
+  getCountriesByRegion,    // alias for countriesInRegion
   getContinents,
   getRegions,
 } from '@koshmoney/countries/geography';
@@ -394,6 +432,7 @@ import {
   isEEA,
   isEurozone,
   isSchengen,
+  isMember,
   getMemberships,
   getMembers,
 } from '@koshmoney/countries/membership';

package/package.json

@@ -1,11 +1,39 @@
 {
   "name": "@koshmoney/countries",
-  "version": "1.0.1-beta.3",
+  "version": "1.0.1-beta.4",
   "description": "Complete ISO 3166-1 (countries) and ISO 3166-2 (subdivisions) lookup library with full TypeScript support",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "country": [
+        "./dist/country/index.d.ts"
+      ],
+      "subdivision": [
+        "./dist/subdivision/index.d.ts"
+      ],
+      "subdivision/*": [
+        "./dist/subdivision/data/*.d.ts"
+      ],
+      "postalCode": [
+        "./dist/postalCode/index.d.ts"
+      ],
+      "currency": [
+        "./dist/currency/index.d.ts"
+      ],
+      "dialCode": [
+        "./dist/dialCode/index.d.ts"
+      ],
+      "geography": [
+        "./dist/geography/index.d.ts"
+      ],
+      "membership": [
+        "./dist/membership/index.d.ts"
+      ]
+    }
+  },
   "sideEffects": [
     "./dist/subdivision/data/*.js",
     "./dist/subdivision/data/*.cjs",