@bigdreamsweb3/wordbin 1.0.6 → 1.0.8

package/dist/core/index.d.ts

@@ -0,0 +1,58 @@
+import { EncodeResult, WordBinDictionary } from '../types.js';
+type PayloadFormat = "bytes" | "base58" | "base64" | "hex" | "bin21";
+export interface DecodeResult {
+    /** The decoded text — words for WordBin payloads, best-effort for others. */
+    text: string;
+    /** True only when the payload was a valid, fully-parsed WordBin stream. */
+    isWordBin: boolean;
+    /** Auto-detected wire format of the input. */
+    detectedFormat: PayloadFormat;
+    /**
+     * Human-readable notice when the payload is not a valid WordBin stream.
+     * Includes information about what the decoder did as a fallback.
+     */
+    notice?: string;
+    /**
+     * Present when partial scanning was used (non-WordBin payloads).
+     * Lists raw byte sequences that had no dictionary match, in order.
+     */
+    rawSegments?: string[];
+}
+export declare class WordBin {
+    private primaryDictVersion;
+    private log;
+    constructor(initialDict?: WordBinDictionary, options?: {
+        debug?: boolean;
+    });
+    static createFromWords(words: string[]): Promise<WordBin>;
+    static createFromJson(dictJson: WordBinDictionary): Promise<WordBin>;
+    static create(options?: {
+        debug?: boolean;
+    }): Promise<WordBin>;
+    private getMapsForVersion;
+    encode(text: string | EncodeResult | Uint8Array, options?: {
+        dictVersion?: number;
+    }): Promise<EncodeResult>;
+    /**
+     * Decodes any supported payload format back to human-readable text.
+     *
+     * For valid WordBin payloads:  returns the exact original words.
+     * For non-WordBin payloads:    scans byte-by-byte, extracts dictionary words
+     *                               wherever possible, and preserves unrecognised
+     *                               bytes as "[0xXX]" markers.
+     */
+    decode(payload: Uint8Array | string): Promise<DecodeResult>;
+    /**
+     * O(n) longest-match-first decode. Returns null if any byte has no match.
+     * This is the fast path; tryDecode is used as a backtracking fallback.
+     */
+    private greedyDecode;
+    /**
+     * Scans through the buffer extracting any recognised dictionary words.
+     * Unrecognised bytes are collected as raw segments and rendered as [0xXX].
+     * Always consumes the entire buffer — never returns null.
+     */
+    private partialScan;
+    private tryDecode;
+}
+export {};

package/dist/data/wordbin-v1-bip39.json

@@ -446,15 +446,15 @@
     "988180": [
       "offer"
     ],
-    "b0ad": [
-      "able"
-    ],
     "df864c": [
       "abandon"
     ],
     "bcffaa": [
       "ability"
     ],
+    "b0ad": [
+      "able"
+    ],
     "a4262e": [
       "about"
     ],
@@ -1647,8 +1647,7 @@
       "crush"
     ],
     "58a6": [
-      "cry",
-      "math"
+      "cry"
     ],
     "60a0f7": [
       "crystal"
@@ -2574,24 +2573,24 @@
     "5a5770": [
       "furnace"
     ],
-    "f44a": [
-      "fury"
-    ],
     "ebb3de": [
       "future"
     ],
+    "f44a": [
+      "fury"
+    ],
     "4e5aa6": [
       "gadget"
     ],
     "66dd": [
       "gain"
     ],
-    "eba4ae": [
-      "galaxy"
-    ],
     "ce387d": [
       "gallery"
     ],
+    "eba4ae": [
+      "galaxy"
+    ],
     "6ca5": [
       "game"
     ],
@@ -6143,6 +6142,9 @@
     ],
     "24fe": [
       "zoo"
+    ],
+    "ad06fa": [
+      "math"
     ]
   }
 }

package/dist/{dictionary.d.ts → dict/builder.d.ts}

@@ -1,4 +1,4 @@
-import { WordBinDictionary } from './types';
+import { WordBinDictionary } from '../types';
 export interface BuildDictionaryOptions {
     /**
      * Dictionary version number (used in header and for format compatibility)

package/dist/{dictionary-loader.d.ts → dict/dictionary-loader.d.ts}

@@ -1,4 +1,4 @@
-import { WordBinDictionary } from './types.js';
+import { WordBinDictionary } from '../types.js';
 /**
  * Scan all available dictionary versions from all data dirs
  */

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { MAGIC } from './constants.js';
-export { buildDictionary } from './dictionary';
-export { WordBin } from './core.js';
+export { MAGIC } from './constants';
+export { buildDictionary } from './dict/builder';
+export { WordBin } from './core/index';
 export type { EncodeResult, WordBinDictionary } from './types';