gralobe 1.0.5 → 1.0.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Batikan Bora Ormanci
+
+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

@@ -1,11 +1,14 @@
 # Gralobe
 
-> **NPM Package created as part of a submission to [TechArena Finland Hackathon](https://platform.techarena-finland.hackathon.com)**
+> **Open-source NPM package for beautiful 3D globe visualizations**
+>
+> Created as part of a submission to [TechArena Finland Hackathon](https://platform.techarena-finland.hackathon.com). This is a community contribution we're committed to maintaining and improving!
 
-Interactive 3D globe visualization with world statistics, smooth flat map ↔ globe transitions, and country labels.
+Interactive 3D globe visualization with world statistics, smooth flat map ↔ globe transitions, and country labels. **Nothing like this existed before** - and it's 100% useful for data visualization, dashboards, and educational projects!
 
 [![npm version](https://img.shields.io/npm/v/gralobe.svg)](https://www.npmjs.com/package/gralobe)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm downloads](https://img.shields.io/npm/dm/gralobe.svg)](https://www.npmjs.com/package/gralobe)
 
 ## Features
 
@@ -18,9 +21,13 @@ Interactive 3D globe visualization with world statistics, smooth flat map ↔ gl
 - Height extrusion based on data values
 - Fully typed TypeScript API
 
-## Demo
+## Live Demo
 
-See `video_demo_1_compressed.mp4` in this repository for a demonstration.
+**[🌐 Try it live at gralobe.vercel.app](https://gralobe.vercel.app)** - A fully configurable version where you can explore different datasets, textures, and visual effects!
+
+[![Gralobe Demo](https://img.youtube.com/vi/0sl-scBeB88/0.jpg)](https://youtu.be/0sl-scBeB88)
+
+**[▶️ Watch the demo on YouTube](https://youtu.be/0sl-scBeB88)**
 
 ## Installation
 
@@ -219,15 +226,29 @@ const customStat: StatisticData = {
     format: (v) => `${v.toFixed(1)}%`,
   },
   values: {
-    '840': 75.5, // USA (ISO numeric code)
-    '156': 42.3, // China
-    // ... more countries
+    'US': 75.5,      // ISO alpha-2
+    'Germany': 42.3, // Country name
+    'CHN': 60.0,     // ISO alpha-3
+    '826': 55.0,     // ISO numeric
   },
 };
 
 globe.setStatistic(customStat);
 ```
 
+### Supported Country Code Formats
+
+Gralobe accepts multiple country identifier formats:
+
+| Format | Example | Description |
+|--------|---------|-------------|
+| ISO 3166-1 alpha-2 | `US`, `DE`, `TR` | 2-letter country codes |
+| ISO 3166-1 alpha-3 | `USA`, `DEU`, `TUR` | 3-letter country codes |
+| ISO 3166-1 numeric | `840`, `276`, `792` | 3-digit numeric codes |
+| Country name | `Germany`, `Turkey` | Common English names |
+
+All formats are automatically normalized internally.
+
 ## TypeScript Types
 
 ```typescript