@bigdreamsweb3/wordbin 1.0.0

package/CONTRIBUTING.md

@@ -0,0 +1,155 @@
+Here's the **CONTRIBUTING.md** file ready for you to download and use in your project.
+
+You can copy the content below and save it as `CONTRIBUTING.md` in the root of your repository.
+
+```markdown
+# Contributing to WordBin
+
+Thank you for your interest in contributing to WordBin!  
+We welcome all kinds of help — bug reports, documentation improvements, new features, dictionary variants, tests, or even small fixes.
+
+This guide explains how to contribute effectively and what would be most valuable to the project right now.
+
+## Table of Contents
+
+- [Code of Conduct](#code-of-conduct)
+- [How to Contribute](#how-to-contribute)
+  - [Reporting Bugs](#reporting-bugs)
+  - [Suggesting Features or Improvements](#suggesting-features-or-improvements)
+  - [Submitting Pull Requests](#submitting-pull-requests)
+  - [Good First Issues](#good-first-issues)
+- [Development Setup](#development-setup)
+- [Current Priorities (2026)](#current-priorities-2026)
+- [Code Style & Conventions](#code-style--conventions)
+- [License](#license)
+
+## Code of Conduct
+
+This project follows the [Contributor Covenant Code of Conduct v2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).  
+Be respectful, inclusive, and constructive in all interactions.
+
+## How to Contribute
+
+### Reporting Bugs
+
+If you find a bug:
+
+1. Check if it's already reported in [existing issues](https://github.com/bigdreamsweb3/wordbin/issues).
+2. If not, open a new issue and include:
+   - Clear, descriptive title
+   - Steps to reproduce
+   - Expected vs actual behavior
+   - Node.js / browser version
+   - Dictionary version used (v1/v2/custom)
+   - Minimal code snippet or test case
+
+Use the **Bug report** template when available.
+
+### Suggesting Features or Improvements
+
+Have an idea for a new feature, better performance, UX improvement, or new dictionary type?
+
+Open an issue with:
+- Problem or opportunity you're addressing
+- Proposed solution (as detailed as you want)
+- Any alternatives you've considered
+- Rough estimate of impact/benefit
+
+Use the **Feature request** template if it exists.
+
+### Submitting Pull Requests
+
+Want to submit code? Awesome!
+
+1. **Fork** the repository and **clone** your fork
+2. Create a new branch:  
+   `git checkout -b fix/lowercase-normalization`  
+   or `feat/add-top-20k-dictionary`
+3. Make your changes
+4. Add or update tests if applicable
+5. Run the test suite:  
+   `npm test` or `npm run vitest`
+6. Commit with clear messages (semantic style preferred):  
+   `fix: normalize words to lowercase in buildDictionary`  
+   `feat: add CLI flag for lowercase normalization`  
+   `docs: improve contributing guide`  
+   `test: add cases for empty input and literals`
+7. Push your branch and open a pull request against `main`
+
+Small, focused PRs are usually merged quickly.  
+Larger changes might be reviewed in stages — feel free to open a draft PR early to discuss.
+
+### Good First Issues
+
+Looking for an easy entry point? These tasks are beginner-friendly:
+
+- Improve/fix documentation or README examples
+- Add case normalization (lowercase) to dictionary building
+- Create a smaller curated dictionary (e.g. top 10k–50k English words)
+- Add more helpful messages or progress indicators to the CLI
+- Write tests for edge cases (empty strings, very long phrases, invalid base64)
+- Create a simple browser demo (CodeSandbox, StackBlitz, or static HTML)
+
+Look for issues labeled **[good first issue]** on GitHub.
+
+## Development Setup
+
+```bash
+# 1. Fork & clone the repo
+git clone https://github.com/bigdreamsweb3/wordbin.git
+cd wordbin
+
+# 2. Install dependencies
+npm install
+
+# 3. Build the library
+npm run build
+
+# 4. Run tests
+npm test
+# or watch mode:
+npm run vitest
+
+# 5. Build dictionaries (optional)
+npx wordbin build --version 2
+# or interactive mode:
+npx wordbin build
+```
+
+Main source code lives in `src/`.  
+Generated dictionaries appear in `data/`.
+
+## Current Priorities (2026)
+
+These improvements would have the biggest impact right now:
+
+- Case-insensitive dictionaries (normalize to lowercase during build)
+- Smaller curated dictionaries (top 10k–50k words, programming keywords, domain-specific lists…)
+- Performance & compression benchmarks across dictionaries and phrase lengths
+- Interactive browser demo (CodeSandbox / StackBlitz / simple HTML page)
+- CLI enhancements (progress bars, `--lowercase`, `--output-dir`, better help)
+- Better error handling & messages (missing dictionary, invalid input, etc.)
+
+If you're unsure where to begin — feel free to ask in an issue or draft PR!
+
+## Code Style & Conventions
+
+- ESM syntax (`import` / `export`)
+- TypeScript where possible
+- Vitest for testing
+- Prefer async/await
+- Small, focused functions
+- JSDoc comments for public APIs
+
+We use **Prettier** + **ESLint** — run these before committing:
+
+```bash
+npm run lint
+npm run format
+```
+
+## License
+
+By contributing your code to this project, you agree that it will be licensed under the same [MIT License](./LICENSE) as the rest of the project.
+
+Thank you for helping make WordBin better!

package/README.md

@@ -0,0 +1,141 @@
+# WordBin – Encode words & short phrases into tiny, reversible binary
+
+![npm](https://img.shields.io/npm/v/@bigdreamsweb3/wordbin) ![license](https://img.shields.io/npm/l/@bigdreamsweb3/wordbin) ![node](https://img.shields.io/node/v/@bigdreamsweb3/wordbin)
+
+**WordBin** is a deterministic, reversible word-to-binary encoder/decoder that compresses short human-readable phrases into **tiny, predictable binary payloads**.
+
+Optimized for **Web3, blockchain, QR codes, IoT, URLs, and other space-sensitive applications**, WordBin ensures short sequences of words can be stored efficiently and recovered reliably.
+
+**npm description (for publishing):**
+
+> Deterministic word-to-binary encoder: compress short phrases for blockchain, Web3, IoT, QR codes, or space-sensitive storage.
+
+---
+
+## Why WordBin
+
+- Compress short phrases (crypto seeds, tags, keywords) into **2–4 byte IDs per word**.
+- Fully **deterministic & collision-safe** — same dictionary = same encoding.
+- Minimal payload → perfect for **blockchain metadata, NFC/QR codes, and low-bandwidth IoT**.
+- Works in **Node.js & browser**, no runtime dependencies.
+- Bundled **small dictionary (BIP-39)** with optional **large/custom dictionaries**.
+
+---
+
+## Quick Install
+
+```bash
+npm install @bigdreamsweb3/wordbin
+```
+
+> The small **v1 (BIP-39)** dictionary is included — ready to encode/decode immediately.
+
+---
+
+## Quick Start (Node.js / Browser)
+
+```js
+import { WordBin } from "@bigdreamsweb3/wordbin";
+
+// Use latest dictionary (v1 bundled, v2 if built)
+const wb = await WordBin.create();
+
+const phrase = "abandon ability able about above";
+const encoded = await wb.encode(phrase);
+
+console.log("Base64 payload:", encoded.encodedBase64);
+console.log("Encoded bytes:", encoded.encodedBytes);
+console.log("Original bytes:", encoded.originalBytes);
+
+const decoded = await wb.decode(encoded.encoded);
+console.log("Decoded:", decoded); // → "abandon ability able about above"
+```
+
+### Browser Example
+
+```html
+<script type="module">
+  import { WordBin } from "https://esm.sh/@bigdreamsweb3/wordbin";
+  const wb = await WordBin.create();
+</script>
+```
+
+---
+
+## CLI – Build Larger or Custom Dictionaries
+
+```bash
+# Interactive mode
+npx wordbin build
+
+# Direct commands
+npx wordbin build --version 1          # BIP-39 (small, bundled)
+npx wordbin build --version 2          # dwyl/english-words (~466k)
+npx wordbin build --all                # Both v1 + v2
+npx wordbin build --custom https://example.com/mywords.txt
+npx wordbin build --custom ./my-local-words.txt
+```
+
+> All generated files go to `./data/` in your current directory.
+
+---
+
+## Dictionary Versions
+
+| Version | Filename              | Words | Source             | ID bytes | Best for                                |
+| ------- | --------------------- | ----- | ------------------ | -------- | --------------------------------------- |
+| v1      | wordbin-v1-bip39.json | 2,048 | BIP-39 English     | ~2       | Crypto recovery seeds, high reliability |
+| v2      | wordbin-v2-dwyl.json  | ~466k | dwyl/english-words | 2–4      | General English, tags, keywords         |
+
+> **v2 note**: The dwyl list contains capitalized words. Encoding/decoding is case-sensitive. Normalize to lowercase for case-insensitive behavior.
+
+---
+
+## How It Works
+
+1. Each word → SHA-256 → first **2–4 bytes** = deterministic ID.
+2. Encoded payload: `[MAGIC_BYTES ('WB') | VERSION | WORD_IDS...]`
+3. Decoding reverses IDs → original words using the same dictionary.
+4. Optimized for **short sequences**, not arbitrary long text.
+
+---
+
+## Real-World Use Cases
+
+| Use Case                              | Typical Savings | Dictionary |
+| ------------------------------------- | --------------- | ---------- |
+| Crypto recovery phrases (12–24 words) | 50–65%          | v1         |
+| Short tags / keywords                 | 40–70%          | v2         |
+| Tiny QR codes / NFC labels            | 50–80%          | v1 or v2   |
+| Short links / URL-friendly tags       | 45–65%          | v2         |
+| On-chain metadata (Ethereum, Solana)  | 40–70%          | v2         |
+| LoRa / low-bandwidth IoT labels       | 50–75%          | v2         |
+| Offline phrase storage / search       | 35–60%          | v2         |
+
+> Not suitable for long texts, arbitrary binary files, or when dictionaries cannot be shared reliably.
+
+---
+
+## Loading Specific Dictionary Versions
+
+```js
+import { loadDictionaryByVersion } from "@bigdreamsweb3/wordbin";
+
+const dictV1 = await loadDictionaryByVersion(1); // always available
+const wbV1 = new WordBin(dictV1);
+
+const dictV2 = await loadDictionaryByVersion(2); // throws if not built
+```
+
+---
+
+## License
+
+MIT
+
+---
+
+## Contributing
+
+Want to help improve WordBin?
+Read our [CONTRIBUTING.md](./CONTRIBUTING.md) guide.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.mjs

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+import { mkdir, writeFile, readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { createInterface } from "node:readline";
+import { stdout, stdin } from "node:process";
+import { wordlists } from "bip39";
+import { b as buildDictionary } from "./dictionary-D3gr2Ala.js";
+const rl = createInterface({ input: stdin, output: stdout });
+const help = `
+WordBin CLI – Dictionary Builder
+
+Usage:
+  npx wordbin build [options]
+
+Options:
+  --version <num>    Build specific version (1 or 2)
+  --all              Build all versions
+  --custom <source>  Build from custom URL or local file path
+  --help             Show this help
+
+If no options provided, enters interactive mode.
+`;
+const args = process.argv.slice(2);
+const cmd = args[0];
+async function prompt(question) {
+  return new Promise((resolve2) => {
+    rl.question(question, resolve2);
+  });
+}
+async function saveDict(version, desc, words, filename) {
+  const dict = await buildDictionary(words, {
+    version,
+    description: desc
+  });
+  const outDir = resolve(process.cwd(), "data");
+  await mkdir(outDir, { recursive: true });
+  const outPath = resolve(outDir, filename);
+  await writeFile(outPath, JSON.stringify(dict, null, 2), "utf8");
+  console.log(`Saved ${filename} (${words.length} words) to ${outPath}`);
+}
+async function fetchWordsFromUrl(url) {
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`Failed to fetch: ${res.status}`);
+  const text = await res.text();
+  return text.split("\n").map((w) => w.trim()).filter(Boolean);
+}
+async function readWordsFromFile(path) {
+  const text = await readFile(path, "utf8");
+  return text.split("\n").map((w) => w.trim()).filter(Boolean);
+}
+async function buildV1() {
+  const words = wordlists.english;
+  if (!Array.isArray(words) || words.length !== 2048) {
+    throw new Error("Invalid BIP-39 wordlist");
+  }
+  await saveDict(
+    1,
+    "WordBin dictionary v1 – BIP-39 English (2048 words)",
+    words,
+    "wordbin-v1-bip39.json"
+  );
+}
+async function buildV2() {
+  console.log("Downloading dwyl/english-words...");
+  const url = "https://raw.githubusercontent.com/dwyl/english-words/master/words.txt";
+  const words = await fetchWordsFromUrl(url);
+  await saveDict(
+    2,
+    `WordBin dictionary v2 – dwyl/english-words (${words.length} words)`,
+    words,
+    "wordbin-v2-dwyl.json"
+  );
+}
+async function buildCustom(source) {
+  let words;
+  if (source.startsWith("http://") || source.startsWith("https://")) {
+    console.log(`Fetching from URL: ${source}`);
+    words = await fetchWordsFromUrl(source);
+  } else {
+    console.log(`Reading from local file: ${source}`);
+    words = await readWordsFromFile(source);
+  }
+  const version = 3;
+  const desc = `WordBin custom dictionary v${version} – from ${source} (${words.length} words)`;
+  await saveDict(version, desc, words, `wordbin-v${version}-custom.json`);
+}
+async function interactiveMode() {
+  console.log("Interactive Dictionary Builder");
+  console.log("Options: 1 (BIP-39), 2 (dwyl large), all, custom, or q to quit");
+  const choice = await prompt("Choose dictionary to build (default: 2): ") || "2";
+  if (choice === "q") {
+    rl.close();
+    return;
+  }
+  if (choice === "1") await buildV1();
+  else if (choice === "2") await buildV2();
+  else if (choice === "all") {
+    await buildV1();
+    await buildV2();
+  } else if (choice === "custom") {
+    const source = await prompt("Enter URL or local file path: ");
+    if (source) await buildCustom(source);
+  } else {
+    console.error("Invalid choice");
+  }
+  rl.close();
+}
+async function main() {
+  if (cmd === "--help" || cmd === "-h") {
+    console.log(help);
+    process.exit(0);
+  }
+  if (cmd === "build") {
+    if (args.length === 1) {
+      await interactiveMode();
+      return;
+    }
+    const option = args[1];
+    if (option === "--version") {
+      const ver = parseInt(args[2]);
+      if (ver === 1) await buildV1();
+      else if (ver === 2) await buildV2();
+      else console.error("Invalid version");
+    } else if (option === "--all") {
+      await buildV1();
+      await buildV2();
+    } else if (option === "--custom") {
+      const source = args[2];
+      if (!source) {
+        console.error("Provide URL or file path");
+        process.exit(1);
+      }
+      await buildCustom(source);
+    } else {
+      console.log(help);
+    }
+    return;
+  }
+  console.log(help);
+  process.exit(1);
+}
+main().catch((err) => {
+  console.error("Error:", err);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\r\n\r\nimport { writeFile, mkdir, readFile } from \"node:fs/promises\";\r\nimport { resolve } from \"node:path\";\r\nimport { createInterface } from \"node:readline\";\r\nimport { stdin as input, stdout as output } from \"node:process\";\r\nimport { wordlists } from \"bip39\";\r\nimport { buildDictionary } from \"./index\";\r\n\r\nconst rl = createInterface({ input, output });\r\n\r\nconst help = `\r\nWordBin CLI – Dictionary Builder\r\n\r\nUsage:\r\n  npx wordbin build [options]\r\n\r\nOptions:\r\n  --version <num>    Build specific version (1 or 2)\r\n  --all              Build all versions\r\n  --custom <source>  Build from custom URL or local file path\r\n  --help             Show this help\r\n\r\nIf no options provided, enters interactive mode.\r\n`;\r\n\r\nconst args = process.argv.slice(2);\r\nconst cmd = args[0];\r\n\r\nasync function prompt(question: string): Promise<string> {\r\n  return new Promise((resolve) => {\r\n    rl.question(question, resolve);\r\n  });\r\n}\r\n\r\nasync function saveDict(\r\n  version: number,\r\n  desc: string,\r\n  words: string[],\r\n  filename: string,\r\n) {\r\n  const dict = await buildDictionary(words, {\r\n    version,\r\n    description: desc,\r\n  });\r\n\r\n  const outDir = resolve(process.cwd(), \"data\");\r\n  await mkdir(outDir, { recursive: true });\r\n\r\n  const outPath = resolve(outDir, filename);\r\n  await writeFile(outPath, JSON.stringify(dict, null, 2), \"utf8\");\r\n\r\n  console.log(`Saved ${filename} (${words.length} words) to ${outPath}`);\r\n}\r\n\r\nasync function fetchWordsFromUrl(url: string) {\r\n  const res = await fetch(url);\r\n  if (!res.ok) throw new Error(`Failed to fetch: ${res.status}`);\r\n\r\n  const text = await res.text();\r\n  return text\r\n    .split(\"\\n\")\r\n    .map((w) => w.trim())\r\n    .filter(Boolean);\r\n}\r\n\r\nasync function readWordsFromFile(path: string) {\r\n  const text = await readFile(path, \"utf8\");\r\n  return text\r\n    .split(\"\\n\")\r\n    .map((w) => w.trim())\r\n    .filter(Boolean);\r\n}\r\n\r\nasync function buildV1() {\r\n  const words = wordlists.english;\r\n\r\n  if (!Array.isArray(words) || words.length !== 2048) {\r\n    throw new Error(\"Invalid BIP-39 wordlist\");\r\n  }\r\n\r\n  await saveDict(\r\n    1,\r\n    \"WordBin dictionary v1 – BIP-39 English (2048 words)\",\r\n    words,\r\n    \"wordbin-v1-bip39.json\",\r\n  );\r\n}\r\n\r\nasync function buildV2() {\r\n  console.log(\"Downloading dwyl/english-words...\");\r\n\r\n  const url =\r\n    \"https://raw.githubusercontent.com/dwyl/english-words/master/words.txt\";\r\n\r\n  const words = await fetchWordsFromUrl(url);\r\n\r\n  await saveDict(\r\n    2,\r\n    `WordBin dictionary v2 – dwyl/english-words (${words.length} words)`,\r\n    words,\r\n    \"wordbin-v2-dwyl.json\",\r\n  );\r\n}\r\n\r\nasync function buildCustom(source: string) {\r\n  let words: string[];\r\n\r\n  if (source.startsWith(\"http://\") || source.startsWith(\"https://\")) {\r\n    console.log(`Fetching from URL: ${source}`);\r\n    words = await fetchWordsFromUrl(source);\r\n  } else {\r\n    console.log(`Reading from local file: ${source}`);\r\n    words = await readWordsFromFile(source);\r\n  }\r\n\r\n  const version = 3;\r\n  const desc = `WordBin custom dictionary v${version} – from ${source} (${words.length} words)`;\r\n\r\n  await saveDict(version, desc, words, `wordbin-v${version}-custom.json`);\r\n}\r\n\r\nasync function interactiveMode() {\r\n  console.log(\"Interactive Dictionary Builder\");\r\n  console.log(\"Options: 1 (BIP-39), 2 (dwyl large), all, custom, or q to quit\");\r\n\r\n  const choice =\r\n    (await prompt(\"Choose dictionary to build (default: 2): \")) || \"2\";\r\n\r\n  if (choice === \"q\") {\r\n    rl.close();\r\n    return;\r\n  }\r\n\r\n  if (choice === \"1\") await buildV1();\r\n  else if (choice === \"2\") await buildV2();\r\n  else if (choice === \"all\") {\r\n    await buildV1();\r\n    await buildV2();\r\n  } else if (choice === \"custom\") {\r\n    const source = await prompt(\"Enter URL or local file path: \");\r\n    if (source) await buildCustom(source);\r\n  } else {\r\n    console.error(\"Invalid choice\");\r\n  }\r\n\r\n  rl.close();\r\n}\r\n\r\nasync function main() {\r\n  if (cmd === \"--help\" || cmd === \"-h\") {\r\n    console.log(help);\r\n    process.exit(0);\r\n  }\r\n\r\n  if (cmd === \"build\") {\r\n    if (args.length === 1) {\r\n      await interactiveMode();\r\n      return;\r\n    }\r\n\r\n    const option = args[1];\r\n\r\n    if (option === \"--version\") {\r\n      const ver = parseInt(args[2]);\r\n      if (ver === 1) await buildV1();\r\n      else if (ver === 2) await buildV2();\r\n      else console.error(\"Invalid version\");\r\n    } else if (option === \"--all\") {\r\n      await buildV1();\r\n      await buildV2();\r\n    } else if (option === \"--custom\") {\r\n      const source = args[2];\r\n      if (!source) {\r\n        console.error(\"Provide URL or file path\");\r\n        process.exit(1);\r\n      }\r\n      await buildCustom(source);\r\n    } else {\r\n      console.log(help);\r\n    }\r\n\r\n    return;\r\n  }\r\n\r\n  console.log(help);\r\n  process.exit(1);\r\n}\r\n\r\nmain().catch((err) => {\r\n  console.error(\"Error:\", err);\r\n  process.exit(1);\r\n});\r\n"],"names":["input","output","resolve"],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const MAGIC: Uint8Array<ArrayBuffer>;
+export declare const LITERAL = 255;

package/dist/core/id.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Deterministic word 	 ID generator
+ * Same output on browser and node (when using compatible input)
+ */
+export declare function generateWordId(word: string): Promise<Uint8Array>;

package/dist/core/tiers.d.ts

@@ -0,0 +1,4 @@
+export declare function getIdByteLength(wordLength: number): number;
+export declare function getWrapByteLength(wordLength: number): number;
+export declare function getTextEncoder(): Promise<TextEncoder>;
+export declare function wrapBase64(data: string): Promise<Uint8Array>;

package/dist/core.d.ts

@@ -0,0 +1,16 @@
+import { EncodeResult, WordBinDictionary } from './types';
+export declare class WordBin {
+    private primaryDictVersion;
+    constructor(initialDict?: WordBinDictionary, options?: {
+        debug?: boolean;
+    });
+    private log;
+    static createFromWords(words: string[]): Promise<WordBin>;
+    static createFromJson(dictJson: WordBinDictionary): Promise<WordBin>;
+    static create(): Promise<WordBin>;
+    private getReverseMapForVersion;
+    encode(text: string | EncodeResult | Uint8Array, options?: {
+        dictVersion?: number;
+    }): Promise<EncodeResult>;
+    decode(data: Uint8Array | string): Promise<string>;
+}