Merge pull request leonardomso#640 from leonardomso/feat/changes

feat: Complete Documentation Site with 33 JavaScript Concepts

Author: leonardomso

.claude/CLAUDE.md

@@ -0,0 +1,27 @@
+name: Tests
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 'lts/*'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test

.github/workflows/action.yml

@@ -62,3 +62,6 @@ typings/
 
 # webstore IDE created directory
 .idea
+
+# OpenCode configuration (local only)
+.opencode/

.github/workflows/tests.yml

@@ -1,6 +1,59 @@
 # Contribution
 This project would not be possible without your help and support, and we appreciate your willingness to contribute!
 
+## Testing
+
+This project uses [Vitest](https://vitest.dev/) as the test runner to verify that code examples in the documentation work correctly.
+
+### Running Tests
+
+```bash
+# Run all tests once
+npm test
+
+# Run tests in watch mode (re-runs on file changes)
+npm run test:watch
+
+# Run tests with coverage report
+npm run test:coverage
+```
+
+### Test Structure
+
+Tests are organized by concept in the `tests/` directory:
+
+```
+tests/
+├── call-stack/
+│   └── call-stack.test.js
+├── primitive-types/
+│   └── primitive-types.test.js
+└── ...
+```
+
+### Writing Tests for Code Examples
+
+When adding new code examples to concept documentation, please include corresponding tests:
+
+1. **File naming**: Create `{concept-name}.test.js` in `tests/{concept-name}/`
+2. **Use explicit imports**: 
+   ```javascript
+   import { describe, it, expect } from 'vitest'
+   ```
+3. **Convert console.log examples to assertions**:
+   ```javascript
+   // Documentation example:
+   // console.log(typeof "hello") // "string"
+   
+   // Test:
+   it('should return string type', () => {
+     expect(typeof "hello").toBe("string")
+   })
+   ```
+4. **Test error cases**: Use `expect(() => { ... }).toThrow()` for operations that should throw
+5. **Skip browser-specific examples**: Tests run in Node.js, so skip DOM/window/document examples
+6. **Note strict mode behavior**: Vitest runs in strict mode, so operations that "silently fail" in non-strict mode will throw `TypeError`
+
 ### Creating a New Translation
 
 To create a new translation, please follow these steps:

.gitignore

@@ -0,0 +1,54 @@
+# Translations
+
+This project has been translated into 40+ languages thanks to our amazing community of contributors.
+
+## Available Translations
+
+- [اَلْعَرَبِيَّةُ‎ (Arabic)](https://github.com/amrsekilly/33-js-concepts) — Amr Elsekilly
+- [Български (Bulgarian)](https://github.com/thewebmasterp/33-js-concepts) — thewebmasterp
+- [汉语 (Chinese)](https://github.com/stephentian/33-js-concepts) — Re Tian
+- [Português do Brasil (Brazilian Portuguese)](https://github.com/tiagoboeing/33-js-concepts) — Tiago Boeing
+- [한국어 (Korean)](https://github.com/yjs03057/33-js-concepts.git) — Suin Lee
+- [Español (Spanish)](https://github.com/adonismendozaperez/33-js-conceptos) — Adonis Mendoza
+- [Türkçe (Turkish)](https://github.com/ilker0/33-js-concepts) — İlker Demir
+- [русский язык (Russian)](https://github.com/gumennii/33-js-concepts) — Mihail Gumennii
+- [Tiếng Việt (Vietnamese)](https://github.com/nguyentranchung/33-js-concepts) — Nguyễn Trần Chung
+- [Polski (Polish)](https://github.com/lip3k/33-js-concepts) — Dawid Lipinski
+- [فارسی (Persian)](https://github.com/majidalavizadeh/33-js-concepts) — Majid Alavizadeh
+- [Bahasa Indonesia (Indonesian)](https://github.com/rijdz/33-js-concepts) — Rijdzuan Sampoerna
+- [Français (French)](https://github.com/robinmetral/33-concepts-js) — Robin Métral
+- [हिन्दी (Hindi)](https://github.com/vikaschauhan/33-js-concepts) — Vikas Chauhan
+- [Ελληνικά (Greek)](https://github.com/DimitrisZx/33-js-concepts) — Dimitris Zarachanis
+- [日本語 (Japanese)](https://github.com/oimo23/33-js-concepts) — oimo23
+- [Deutsch (German)](https://github.com/burhannn/33-js-concepts) — burhannn
+- [украї́нська мо́ва (Ukrainian)](https://github.com/AndrewSavetchuk/33-js-concepts-ukrainian-translation) — Andrew Savetchuk
+- [සිංහල (Sinhala)](https://github.com/ududsha/33-js-concepts) — Udaya Shamendra
+- [Italiano (Italian)](https://github.com/Donearm/33-js-concepts) — Gianluca Fiore
+- [Latviešu (Latvian)](https://github.com/ANormalStick/33-js-concepts) — Jānis Īvāns
+- [Afaan Oromoo (Oromo)](https://github.com/Amandagne/33-js-concepts) — Amanuel Dagnachew
+- [ภาษาไทย (Thai)](https://github.com/ninearif/33-js-concepts) — Arif Waram
+- [Català (Catalan)](https://github.com/marioestradaf/33-js-concepts) — Mario Estrada
+- [Svenska (Swedish)](https://github.com/FenixHongell/33-js-concepts/) — Fenix Hongell
+- [ខ្មែរ (Khmer)](https://github.com/Chhunneng/33-js-concepts) — Chrea Chanchhunneng
+- [አማርኛ (Ethiopian)](https://github.com/hmhard/33-js-concepts) — Miniyahil Kebede (ምንያህል ከበደ)
+- [Беларуская мова (Belarussian)](https://github.com/Yafimau/33-js-concepts) — Dzianis Yafimau
+- [O'zbekcha (Uzbek)](https://github.com/smnv-shokh/33-js-concepts) — Shokhrukh Usmonov
+- [Urdu (اردو)](https://github.com/sudoyasir/33-js-concepts) — Yasir Nawaz
+- [हिन्दी (Hindi)](https://github.com/milostivyy/33-js-concepts) — Mahima Chauhan
+- [বাংলা (Bengali)](https://github.com/Jisan-mia/33-js-concepts) — Jisan Mia
+- [ગુજરાતી (Gujarati)](https://github.com/VatsalBhuva11/33-js-concepts) — Vatsal Bhuva
+- [سنڌي (Sindhi)](https://github.com/Sunny-unik/33-js-concepts) — Sunny Gandhwani
+- [भोजपुरी (Bhojpuri)](https://github.com/debnath003/33-js-concepts) — Pronay Debnath
+- [ਪੰਜਾਬੀ (Punjabi)](https://github.com/Harshdev098/33-js-concepts) — Harsh Dev Pathak
+- [Latin (Latin)](https://github.com/Harshdev098/33-js-concepts) — Harsh Dev Pathak
+- [മലയാളം (Malayalam)](https://github.com/Stark-Akshay/33-js-concepts) — Akshay Manoj
+- [Yorùbá (Yoruba)](https://github.com/ayobaj/33-js-concepts) — Ayomide Bajulaye
+- [עברית‎ (Hebrew)](https://github.com/rafyzg/33-js-concepts) — Refael Yzgea
+- [Nederlands (Dutch)](https://github.com/dlvisser/33-js-concepts) — Dave Visser
+- [தமிழ் (Tamil)](https://github.com/UdayaKrishnanM/33-js-concepts) — Udaya Krishnan M
+
+---
+
+## Want to Translate?
+
+We'd love to have more translations! See our [Contributing Guidelines](CONTRIBUTING.md) for details on how to submit a translation.