puzzle-lib 2.0.0-alpha.2 → 2.0.0-beta.2

package/build/src/ngrams/ngrams.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Scores adding a new letter given the preceding context.
+ * Uses the highest available n-gram: trigram if 2+ prior chars,
+ * bigram if 1 prior char, unigram if starting fresh.
+ */
+export declare function scoreNextLetter(context: string, letter: string): number;
+/**
+ * Scores a complete text string by summing n-gram log-probabilities.
+ * Uses unigram for the first character, bigram for the second,
+ * and trigrams for all subsequent characters. Non-letter characters
+ * are skipped. Input is normalized to lowercase once before scoring.
+ */
+export declare function scoreText(text: string): number;

package/build/src/ngrams/ngrams.js

@@ -0,0 +1,71 @@
+import { BIGRAM_LOG_PROB, MIN_BIGRAM_LOG_PROB } from './bigrams.js';
+import { TRIGRAM_LOG_PROB, MIN_TRIGRAM_LOG_PROB } from './trigrams.js';
+import { UNIGRAM_LOG_PROB, MIN_UNIGRAM_LOG_PROB } from './unigrams.js';
+function isLetter(c) {
+    return c >= 'a' && c <= 'z';
+}
+/**
+ * Returns the unigram log-probability for a single letter.
+ */
+function scoreUnigram(a) {
+    return UNIGRAM_LOG_PROB[a.toLowerCase()] ?? MIN_UNIGRAM_LOG_PROB;
+}
+/**
+ * Returns the bigram log-probability for a pair of letters.
+ */
+function scoreBigram(a, b) {
+    const key = (a + b).toLowerCase();
+    return BIGRAM_LOG_PROB[key] ?? MIN_BIGRAM_LOG_PROB;
+}
+/**
+ * Returns the trigram log-probability for three letters.
+ */
+function scoreTrigram(a, b, c) {
+    const key = (a + b + c).toLowerCase();
+    return TRIGRAM_LOG_PROB[key] ?? MIN_TRIGRAM_LOG_PROB;
+}
+/**
+ * Scores adding a new letter given the preceding context.
+ * Uses the highest available n-gram: trigram if 2+ prior chars,
+ * bigram if 1 prior char, unigram if starting fresh.
+ */
+export function scoreNextLetter(context, letter) {
+    const len = context.length;
+    if (len >= 2) {
+        return scoreTrigram(context[len - 2], context[len - 1], letter);
+    }
+    else if (len === 1) {
+        return scoreBigram(context[0], letter);
+    }
+    return scoreUnigram(letter);
+}
+/**
+ * Scores a complete text string by summing n-gram log-probabilities.
+ * Uses unigram for the first character, bigram for the second,
+ * and trigrams for all subsequent characters. Non-letter characters
+ * are skipped. Input is normalized to lowercase once before scoring.
+ */
+export function scoreText(text) {
+    const lower = text.toLowerCase();
+    const letters = [];
+    for (const c of lower) {
+        if (isLetter(c)) {
+            letters.push(c);
+        }
+    }
+    if (letters.length === 0)
+        return 0;
+    let score = UNIGRAM_LOG_PROB[letters[0]] ?? MIN_UNIGRAM_LOG_PROB;
+    for (let i = 1; i < letters.length; i++) {
+        if (i >= 2) {
+            const key = letters[i - 2] + letters[i - 1] + letters[i];
+            score += TRIGRAM_LOG_PROB[key] ?? MIN_TRIGRAM_LOG_PROB;
+        }
+        else {
+            const key = letters[i - 1] + letters[i];
+            score += BIGRAM_LOG_PROB[key] ?? MIN_BIGRAM_LOG_PROB;
+        }
+    }
+    return score;
+}
+//# sourceMappingURL=ngrams.js.map

package/build/src/ngrams/ngrams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngrams.js","sourceRoot":"","sources":["../../../src/ngrams/ngrams.ts"],"names":[],"mappings":"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"}

package/build/src/ngrams/trigrams.d.ts

@@ -0,0 +1,2 @@
+export declare const TRIGRAM_LOG_PROB: Record<string, number>;
+export declare const MIN_TRIGRAM_LOG_PROB = -25.685277;