@omisai/countries 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Omisai Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,188 @@
+# TypeScript Countries
+
+[![Test](https://github.com/omisai-tech/ts-countries/actions/workflows/test.yml/badge.svg)](https://github.com/omisai/ts-countries/actions/workflows/test.yml)
+[![NPM Version](https://img.shields.io/npm/v/@omisai/countries.svg)](https://www.npmjs.com/package/@omisai/countries)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+TypeScript package for country data with classes and interfaces generated from ISO 3166-1 standard.
+
+## Features
+
+- Fairly complete country data with 250+ countries
+- Multi-language support (EN, HU, DE, ES, IT, FR, PT)
+- TypeScript with full type definitions
+- Individual class for each country
+- ISO 3166-1 codes (alpha-2, alpha-3, numeric)
+- Telephone country codes
+- Capital cities
+- Continent classification
+- Built with Rolldown for optimal bundle size
+- 100% functional test coverage
+- Compatible with Node.js, Bun
+
+## Installation
+
+### Bun
+```bash
+bun add @omisai/countries
+```
+
+### NPM
+```bash
+npm install @omisai/countries
+```
+
+### PNPM
+```bash
+pnpm add @omisai/countries
+```
+
+### YARN
+```bash
+yarn add @omisai/countries
+```
+
+## Quick Start
+
+```typescript
+import { UnitedStates } from "@omisai/countries";
+
+const usa = new UnitedStates();
+console.log(usa.en);        // "United States"
+console.log(usa.alpha2);    // "US"
+console.log(usa.callingCode);      // "1"
+```
+
+## Usage
+
+```typescript
+import { UnitedStates, Germany, Japan, Country } from "@omisai/countries";
+
+// Use specific country classes
+const usa = new UnitedStates();
+console.log(usa.en); // "United States"
+console.log(usa.alpha2); // "US"
+console.log(usa.callingCode); // "1"
+console.log(usa.capital); // "Washington"
+
+// Get name in different languages
+const germany = new Germany();
+console.log(germany.getName("en")); // "Germany"
+console.log(germany.getName("de")); // "Deutschland"
+console.log(germany.getName("fr")); // "Allemagne"
+
+// Convert to JSON
+const japanData = new Japan().toJSON();
+console.log(japanData);
+```
+
+## Project Structure
+
+```
+ts-countries/
+├── src/
+│   ├── Country.ts           # Abstract base class
+│   ├── types/
+│   │   ├── Continent.ts     # Continent enum and names
+│   │   └── ICountry.ts      # Country interface
+│   ├── models/              # Generated country classes
+│   │   ├── UnitedStates.ts
+│   │   ├── Germany.ts
+│   │   └── ... (all countries)
+│   └── index.ts             # Main export file
+├── compiler.ts              # Generates country classes from CSV
+├── countries.csv            # Source data
+├── package.json
+└── tsconfig.json
+```
+
+## Development Scripts
+
+```bash
+# Generate country classes from CSV
+bun run compile
+
+# Build for production (ESM + CJS)
+bun run build
+
+# Run tests
+bun test
+
+# Run tests with coverage
+bun run test:coverage
+
+# Type check
+bun run typecheck
+
+# Clean generated files
+bun run clean
+
+# Full rebuild
+bun run rebuild
+```
+
+## Runtime Compatibility
+
+### Node.js
+```typescript
+import { UnitedStates } from "@omisai/countries";
+// or
+const { UnitedStates } = require("@omisai/countries");
+```
+
+### Bun
+```typescript
+import { UnitedStates } from "@omisai/countries";
+```
+
+## Testing
+
+The package includes comprehensive tests that run on Node.js, Bun:
+
+```bash
+# Node.js (Vitest)
+npm test
+
+# Bun
+bun test tests/*.test.ts
+
+## CI/CD
+
+This project uses GitHub Actions for:
+- ✅ Automated testing on Node.js 18, 20, 22
+- ✅ Automated testing on Bun
+- ✅ Code coverage reporting
+- ✅ Automated releases to NPM and JSR
+- ✅ Dependency updates via Dependabot
+
+## Releasing
+
+This project uses manual GitHub Actions workflow for releases. See [RELEASE.md](./RELEASE.md) for detailed instructions.
+
+**Quick release**:
+1. Go to Actions → Release workflow
+2. Click "Run workflow"
+3. Enter version (e.g., `1.0.0`)
+4. Run!
+
+The workflow automatically handles versioning, tagging, building, testing, and publishing to NPM and JSR.
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines.
+
+## License
+
+See the [LICENSE](./LICENSE) file for details.
+
+## Acknowledgments
+
+- Country data sourced from ISO 3166-1 standard
+- Built with [Rolldown](https://rolldown.rs/) - Fast JavaScript/TypeScript bundler
+- Tested with [Vitest](https://vitest.dev/) - Next generation testing framework

package/dist/Country.d.ts

@@ -0,0 +1,47 @@
+import { Continent } from "./types/Continent";
+import { ICountry } from "./types/ICountry";
+/**
+ * Abstract base Country class
+ * All country-specific classes will extend this
+ */
+export declare abstract class Country implements ICountry {
+    /** ISO 3166-1 alpha-2 code */
+    abstract alpha2: string;
+    /** ISO 3166-1 alpha-3 code */
+    abstract alpha3: string;
+    /** ISO 3166-1 numeric code */
+    abstract numeric: string;
+    /** FIPS code - Federal Information Processing Standard */
+    abstract fipCode: string;
+    /** Telephone country code */
+    abstract callingCode: string;
+    /** Capital city */
+    abstract capital: string;
+    /** Continent code */
+    abstract continent: Continent;
+    /** English name of the country */
+    abstract en: string;
+    /** Hungarian name of the country */
+    abstract hu: string;
+    /** German name of the country */
+    abstract de: string;
+    /** Spanish name of the country */
+    abstract es: string;
+    /** Italian name of the country */
+    abstract it: string;
+    /** French name of the country */
+    abstract fr: string;
+    /** Portuguese name of the country */
+    abstract pt: string;
+    /**
+     * Get the country name in a specific language
+     * @param lang Language code (en, hu, de, es, it, fr, pt)
+     * @returns Country name in the specified language
+     */
+    getName(lang?: "en" | "hu" | "de" | "es" | "it" | "fr" | "pt"): string;
+    /**
+     * Get country data as a plain object
+     */
+    toJSON(): ICountry;
+}
+//# sourceMappingURL=Country.d.ts.map

package/dist/Country.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Country.d.ts","sourceRoot":"","sources":["../src/Country.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;;GAGG;AACH,8BAAsB,OAAQ,YAAW,QAAQ;IAC/C,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,6BAA6B;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,mBAAmB;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,OAAO,CAAC,IAAI,GAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAW,GAAG,MAAM;IAI5E;;OAEG;IACH,MAAM,IAAI,QAAQ;CAkBnB"}