chore: initial commit と༼ ◕_◕ と ༽

Author: koistya

.claude/commands/generate-exports.md

@@ -0,0 +1,21 @@
+- [ ] Get the list of word categories (themes) in the `words` directory where each category has a corresponding `words/<list>.txt` file.
+
+- [ ] For each category, run the command to generate the export files:
+
+```bash
+bun run ./scripts/generate.ts <list> <ClassName>
+```
+
+Where `<list>` is the name of the words list (e.g., `cities`, `animals`) and `<ClassName>` is the name of the class representing each item in the list (e.g., `City`, `Animal`, etc.).
+
+- [ ] Update `exports` in `package.json` to ensure that it contains all the word lists with the default export for each category pointing to `<list>-20.ts` (default) file. These exports need to support Bun, Deno, TypeScript, types, and ESM.
+
+- [ ] Update the list of themes in `cli.ts`; use `./words/<list>-100.js` as the default theme for each category.
+
+- [ ] Update the "Word Lists" section in `README.md` to ensure that the list of categories and the top 10 words for each category are accurate and up-to-date.
+
+- [ ] Format the generated files using Prettier:
+
+```bash
+bun prettier --write .
+```

.claude/commands/generate-words.md

@@ -0,0 +1,26 @@
+Your task is to generate a curated list of exactly 100 words for a given theme or category.
+
+**Theme or Category:** $ARGUMENTS
+
+Load existing list from `words/<list>.txt` file, if it exists to see if you can improve this list by adding, removing, or re-ordering items (just small incremental updates). If the file does not exist, create a new one.
+
+Follow these rules strictly:
+
+**1. Word Constraints:**
+
+- **Length:** Every word must be 7 characters long or shorter (i.e., less than 8 characters).
+- **Simplicity:** Use only single, non-compound words. For example, for the theme 'weather', use 'rain' and 'snow', but not 'thunderstorm'.
+- **Purity:** Do not include abbreviations, acronyms, slang, or proper nouns (like brands, 'USA', 'UK', etc.).
+
+**2. List Ordering:**
+The list must be sorted by the following criteria, in this specific order of priority:
+
+- **Primary Criterion - Memorability (Weight: 0.5):** Place the most common, fundamental, and evocative words first. These should be high-frequency words that are strongly associated with the theme and easy to recall.
+- **Secondary Criterion - Shortness (Weight: 0.3):** When words have a similar level of memorability, the shorter word must come first.
+- **Tertiary Criterion - Easy to Spell (Weight 0.2):** If two words are equally memorable and of the same length, the one that is easier to spell should come first.
+
+Please generate only the final, numbered list of 100 words.
+
+Save it to `words/<list>.txt` file, one word per line without any additional formatting or prefixes.
+
+Run `bun prettier --write words/<list>.txt` to format the file after generating the list.

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+# GitHub Sponsors configuration
+github: koistya

.github/copilot-instructions.md

@@ -0,0 +1 @@
+#file:../CLAUDE.md

.github/workflows/main.yml

@@ -0,0 +1,34 @@
+name: CI/CD
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      # https://github.com/oven-sh/setup-bun
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      # https://github.com/actions/cache
+      - uses: actions/cache@v4
+        with:
+          path: |
+            ~/.bun/install/cache
+          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lock') }}
+
+      - run: bun install --frozen-lockfile
+
+      - run: bun prettier --check .
+
+      - run: bun eslint .
+
+      - run: bun test

.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+*.log
+.env*
+.DS_Store
+dist/
+build/

.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "editor.formatOnSave": true,
+  "editor.tabSize": 2,
+  "cSpell.words": ["codenames", "kriasoft"]
+}