marlarky 1.0.0

package/dist/morphology/pluralize.test.js

@@ -0,0 +1,86 @@
+import { describe, it, expect } from 'vitest';
+import { pluralize, singularize, isPlural } from './pluralize.js';
+describe('Pluralization', () => {
+    describe('pluralize', () => {
+        it('handles regular plurals (add s)', () => {
+            expect(pluralize('cat')).toBe('cats');
+            expect(pluralize('dog')).toBe('dogs');
+            expect(pluralize('house')).toBe('houses');
+        });
+        it('handles words ending in s, x, z, ch, sh (add es)', () => {
+            expect(pluralize('bus')).toBe('buses');
+            expect(pluralize('box')).toBe('boxes');
+            expect(pluralize('buzz')).toBe('buzzes');
+            expect(pluralize('church')).toBe('churches');
+            expect(pluralize('dish')).toBe('dishes');
+        });
+        it('handles words ending in consonant + y (change to ies)', () => {
+            expect(pluralize('baby')).toBe('babies');
+            expect(pluralize('city')).toBe('cities');
+            expect(pluralize('story')).toBe('stories');
+        });
+        it('handles words ending in vowel + y (add s)', () => {
+            expect(pluralize('boy')).toBe('boys');
+            expect(pluralize('day')).toBe('days');
+            expect(pluralize('key')).toBe('keys');
+        });
+        it('handles irregular plurals', () => {
+            expect(pluralize('person')).toBe('people');
+            expect(pluralize('man')).toBe('men');
+            expect(pluralize('woman')).toBe('women');
+            expect(pluralize('child')).toBe('children');
+            expect(pluralize('foot')).toBe('feet');
+            expect(pluralize('tooth')).toBe('teeth');
+            expect(pluralize('mouse')).toBe('mice');
+        });
+        it('handles words that are the same singular and plural', () => {
+            expect(pluralize('sheep')).toBe('sheep');
+            expect(pluralize('fish')).toBe('fish');
+            expect(pluralize('deer')).toBe('deer');
+        });
+        it('handles Latin/Greek plurals', () => {
+            expect(pluralize('analysis')).toBe('analyses');
+            expect(pluralize('criterion')).toBe('criteria');
+            expect(pluralize('phenomenon')).toBe('phenomena');
+            expect(pluralize('thesis')).toBe('theses');
+        });
+        it('preserves capitalization', () => {
+            expect(pluralize('Person')).toBe('People');
+            expect(pluralize('MOUSE')).toBe('MICE');
+        });
+    });
+    describe('singularize', () => {
+        it('handles regular singulars', () => {
+            expect(singularize('cats')).toBe('cat');
+            expect(singularize('dogs')).toBe('dog');
+        });
+        it('handles ies -> y', () => {
+            expect(singularize('babies')).toBe('baby');
+            expect(singularize('cities')).toBe('city');
+        });
+        it('handles irregular singulars', () => {
+            expect(singularize('people')).toBe('person');
+            expect(singularize('men')).toBe('man');
+            expect(singularize('women')).toBe('woman');
+            expect(singularize('children')).toBe('child');
+        });
+    });
+    describe('isPlural', () => {
+        it('identifies known plurals', () => {
+            expect(isPlural('people')).toBe(true);
+            expect(isPlural('men')).toBe(true);
+            expect(isPlural('children')).toBe(true);
+        });
+        it('identifies known singulars', () => {
+            expect(isPlural('person')).toBe(false);
+            expect(isPlural('man')).toBe(false);
+            expect(isPlural('child')).toBe(false);
+        });
+        it('uses heuristic for unknown words', () => {
+            expect(isPlural('cats')).toBe(true);
+            expect(isPlural('dogs')).toBe(true);
+            expect(isPlural('cat')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=pluralize.test.js.map

package/dist/morphology/pluralize.test.js.map

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

package/dist/providers/index.d.ts

@@ -0,0 +1,2 @@
+export { WordProvider } from './word-provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,2 @@
+export { WordProvider } from './word-provider.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/providers/word-provider.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Lexicon-Aware Word Provider
+ * Samples words from lexicon with Faker fallback
+ */
+import type { IFakerAdapter } from '../interfaces/faker-adapter.js';
+import type { IRng } from '../interfaces/rng.js';
+import type { LexiconStore } from '../lexicon/store.js';
+import type { GenerationContext } from '../types/context.js';
+import type { LexicalItem, POS } from '../types/lexicon.js';
+export declare class WordProvider {
+    private lexiconStore;
+    private fakerAdapter;
+    private rng;
+    constructor(lexiconStore: LexiconStore, fakerAdapter: IFakerAdapter, rng: IRng);
+    /**
+     * Get a word by POS with lexicon sampling and faker fallback
+     */
+    getWord(pos: POS, ctx: GenerationContext, options?: {
+        tags?: string[];
+        termSetIds?: string[];
+        features?: Record<string, unknown>;
+        exclude?: string[];
+        fallbackToFaker?: boolean;
+    }): LexicalItem;
+    /**
+     * Get a fallback word from default lists or faker
+     */
+    private getFallbackWord;
+    /**
+     * Get a word directly from faker
+     */
+    private getFromFaker;
+    /**
+     * Get a noun
+     */
+    getNoun(ctx: GenerationContext, options?: {
+        tags?: string[];
+        exclude?: string[];
+    }): LexicalItem;
+    /**
+     * Get a verb
+     */
+    getVerb(ctx: GenerationContext, options?: {
+        tags?: string[];
+        exclude?: string[];
+    }): LexicalItem;
+    /**
+     * Get an adjective
+     */
+    getAdjective(ctx: GenerationContext, options?: {
+        tags?: string[];
+        exclude?: string[];
+    }): LexicalItem;
+    /**
+     * Get an adverb
+     */
+    getAdverb(ctx: GenerationContext, options?: {
+        tags?: string[];
+        exclude?: string[];
+    }): LexicalItem;
+    /**
+     * Get a preposition
+     */
+    getPreposition(ctx: GenerationContext, options?: {
+        tags?: string[];
+        exclude?: string[];
+    }): LexicalItem;
+    /**
+     * Get a conjunction
+     */
+    getConjunction(ctx: GenerationContext, options?: {
+        tags?: string[];
+        exclude?: string[];
+    }): LexicalItem;
+    /**
+     * Get an interjection
+     */
+    getInterjection(ctx: GenerationContext, options?: {
+        tags?: string[];
+        exclude?: string[];
+    }): LexicalItem;
+    /**
+     * Get a determiner
+     */
+    getDeterminer(ctx: GenerationContext, options?: {
+        exclude?: string[];
+    }): string;
+    /**
+     * Get a subject pronoun
+     */
+    getSubjectPronoun(): string;
+    /**
+     * Get an object pronoun
+     */
+    getObjectPronoun(): string;
+    /**
+     * Get a possessive determiner
+     */
+    getPossessiveDeterminer(): string;
+    /**
+     * Get a modal verb
+     */
+    getModal(): string;
+    /**
+     * Get a subordinating conjunction
+     */
+    getSubordinator(): string;
+    /**
+     * Get a relative pronoun
+     */
+    getRelativePronoun(): string;
+    /**
+     * Get a coordinating conjunction
+     */
+    getCoordinator(): string;
+    /**
+     * Get a transition word/phrase
+     */
+    getTransition(): string;
+    /**
+     * Get related terms based on current context
+     */
+    getRelatedNoun(ctx: GenerationContext): LexicalItem | undefined;
+}
+//# sourceMappingURL=word-provider.d.ts.map

package/dist/providers/word-provider.d.ts.map

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

package/dist/providers/word-provider.js

@@ -0,0 +1,266 @@
+/**
+ * Lexicon-Aware Word Provider
+ * Samples words from lexicon with Faker fallback
+ */
+import { recordChoice } from '../types/context.js';
+import * as defaults from '../defaults/index.js';
+export class WordProvider {
+    lexiconStore;
+    fakerAdapter;
+    rng;
+    constructor(lexiconStore, fakerAdapter, rng) {
+        this.lexiconStore = lexiconStore;
+        this.fakerAdapter = fakerAdapter;
+        this.rng = rng;
+    }
+    /**
+     * Get a word by POS with lexicon sampling and faker fallback
+     */
+    getWord(pos, ctx, options = {}) {
+        const { tags, termSetIds, features, exclude, fallbackToFaker = true } = options;
+        // Try lexicon first
+        const query = {
+            pos,
+            tags,
+            termSetIds,
+            features: features,
+            exclude,
+            fallbackToFaker,
+        };
+        const lexiconItem = this.lexiconStore.sampleTerm(query, ctx);
+        if (lexiconItem) {
+            // Record the choice for correlations
+            recordChoice(ctx, {
+                type: 'term',
+                item: lexiconItem,
+                termSetId: lexiconItem.termSetId,
+                scope: 'token',
+            });
+            // Apply correlations
+            this.lexiconStore.applyCorrelations(ctx, {
+                type: 'term',
+                item: lexiconItem,
+                termSetId: lexiconItem.termSetId,
+                scope: 'token',
+            });
+            // Add relation hints
+            if (lexiconItem.value) {
+                const relations = this.lexiconStore.evaluateRelations(lexiconItem.value);
+                for (const rel of relations) {
+                    ctx.relationHints.push(rel.term);
+                }
+            }
+            return lexiconItem;
+        }
+        // Fallback to default lists or faker
+        if (fallbackToFaker) {
+            const value = this.getFallbackWord(pos, exclude);
+            const item = {
+                value,
+                pos,
+                tags: [],
+            };
+            recordChoice(ctx, {
+                type: 'term',
+                item,
+                scope: 'token',
+            });
+            return item;
+        }
+        // If no fallback, throw
+        throw new Error(`No term found for POS: ${pos}`);
+    }
+    /**
+     * Get a fallback word from default lists or faker
+     */
+    getFallbackWord(pos, exclude) {
+        let candidates;
+        switch (pos) {
+            case 'noun':
+                candidates = defaults.DEFAULT_NOUNS;
+                break;
+            case 'verb':
+                candidates = defaults.DEFAULT_VERBS;
+                break;
+            case 'adj':
+                candidates = defaults.DEFAULT_ADJECTIVES;
+                break;
+            case 'adv':
+                candidates = defaults.DEFAULT_ADVERBS;
+                break;
+            case 'prep':
+                candidates = defaults.DEFAULT_PREPOSITIONS;
+                break;
+            case 'conj':
+                candidates = defaults.DEFAULT_CONJUNCTIONS;
+                break;
+            case 'intj':
+                candidates = defaults.DEFAULT_INTERJECTIONS;
+                break;
+            case 'det':
+                candidates = defaults.DEFAULT_DETERMINERS;
+                break;
+            default:
+                candidates = [];
+        }
+        // Filter exclusions
+        if (exclude && exclude.length > 0) {
+            const excludeSet = new Set(exclude);
+            candidates = candidates.filter(w => !excludeSet.has(w));
+        }
+        // If we have candidates, pick from them
+        if (candidates.length > 0) {
+            return this.rng.pick(candidates);
+        }
+        // Otherwise use faker
+        return this.getFromFaker(pos);
+    }
+    /**
+     * Get a word directly from faker
+     */
+    getFromFaker(pos) {
+        switch (pos) {
+            case 'noun':
+                return this.fakerAdapter.noun();
+            case 'verb':
+                return this.fakerAdapter.verb();
+            case 'adj':
+                return this.fakerAdapter.adjective();
+            case 'adv':
+                return this.fakerAdapter.adverb();
+            case 'prep':
+                return this.fakerAdapter.preposition();
+            case 'conj':
+                return this.fakerAdapter.conjunction();
+            case 'intj':
+                return this.fakerAdapter.interjection();
+            case 'det':
+                return this.rng.pick(defaults.DEFAULT_DETERMINERS);
+            default:
+                return this.fakerAdapter.noun();
+        }
+    }
+    /**
+     * Get a noun
+     */
+    getNoun(ctx, options) {
+        return this.getWord('noun', ctx, options);
+    }
+    /**
+     * Get a verb
+     */
+    getVerb(ctx, options) {
+        return this.getWord('verb', ctx, options);
+    }
+    /**
+     * Get an adjective
+     */
+    getAdjective(ctx, options) {
+        return this.getWord('adj', ctx, options);
+    }
+    /**
+     * Get an adverb
+     */
+    getAdverb(ctx, options) {
+        return this.getWord('adv', ctx, options);
+    }
+    /**
+     * Get a preposition
+     */
+    getPreposition(ctx, options) {
+        return this.getWord('prep', ctx, options);
+    }
+    /**
+     * Get a conjunction
+     */
+    getConjunction(ctx, options) {
+        return this.getWord('conj', ctx, options);
+    }
+    /**
+     * Get an interjection
+     */
+    getInterjection(ctx, options) {
+        return this.getWord('intj', ctx, options);
+    }
+    /**
+     * Get a determiner
+     */
+    getDeterminer(ctx, options) {
+        const item = this.getWord('det', ctx, options);
+        return item.value;
+    }
+    /**
+     * Get a subject pronoun
+     */
+    getSubjectPronoun() {
+        return this.rng.pick(defaults.DEFAULT_SUBJECT_PRONOUNS);
+    }
+    /**
+     * Get an object pronoun
+     */
+    getObjectPronoun() {
+        return this.rng.pick(defaults.DEFAULT_OBJECT_PRONOUNS);
+    }
+    /**
+     * Get a possessive determiner
+     */
+    getPossessiveDeterminer() {
+        return this.rng.pick(defaults.DEFAULT_POSSESSIVE_DETERMINERS);
+    }
+    /**
+     * Get a modal verb
+     */
+    getModal() {
+        return this.rng.pick(defaults.DEFAULT_MODALS);
+    }
+    /**
+     * Get a subordinating conjunction
+     */
+    getSubordinator() {
+        return this.rng.pick(defaults.DEFAULT_SUBORDINATORS);
+    }
+    /**
+     * Get a relative pronoun
+     */
+    getRelativePronoun() {
+        return this.rng.pick(defaults.DEFAULT_RELATIVES);
+    }
+    /**
+     * Get a coordinating conjunction
+     */
+    getCoordinator() {
+        return this.rng.pick(defaults.DEFAULT_CONJUNCTIONS);
+    }
+    /**
+     * Get a transition word/phrase
+     */
+    getTransition() {
+        return this.rng.pick(defaults.DEFAULT_TRANSITIONS);
+    }
+    /**
+     * Get related terms based on current context
+     */
+    getRelatedNoun(ctx) {
+        if (ctx.relationHints.length === 0)
+            return undefined;
+        // Try to find a term set containing one of the hinted terms
+        for (const hint of ctx.relationHints) {
+            const query = {
+                pos: 'noun',
+                fallbackToFaker: false,
+            };
+            // Look for term sets containing this hint
+            const termSets = this.lexiconStore.getTermSetsByPOS('noun');
+            for (const { id, set } of termSets) {
+                if (set.terms.some(t => t.value === hint)) {
+                    query.termSetIds = [id];
+                    const item = this.lexiconStore.sampleTerm(query, ctx);
+                    if (item)
+                        return item;
+                }
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=word-provider.js.map

package/dist/providers/word-provider.js.map

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

package/dist/rng/index.d.ts

@@ -0,0 +1,2 @@
+export { SeedableRng } from './seedable-rng.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/rng/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rng/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/rng/index.js

@@ -0,0 +1,2 @@
+export { SeedableRng } from './seedable-rng.js';
+//# sourceMappingURL=index.js.map

package/dist/rng/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rng/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/rng/seedable-rng.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Seedable Random Number Generator
+ * Implements a Mulberry32 PRNG for deterministic output
+ */
+import type { IRng, WeightedItem } from '../interfaces/rng.js';
+export declare class SeedableRng implements IRng {
+    private _seed;
+    private _next;
+    constructor(seed?: number);
+    seed(n: number): void;
+    get currentSeed(): number;
+    float(): number;
+    int(min: number, max: number): number;
+    pick<T>(list: T[]): T;
+    weightedPick<T>(items: WeightedItem<T>[]): T;
+    shuffle<T>(list: T[]): T[];
+    chance(probability: number): boolean;
+}
+//# sourceMappingURL=seedable-rng.d.ts.map

package/dist/rng/seedable-rng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seedable-rng.d.ts","sourceRoot":"","sources":["../../src/rng/seedable-rng.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAc/D,qBAAa,WAAY,YAAW,IAAI;IACtC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAe;gBAEhB,IAAI,GAAE,MAAmB;IAKrC,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKrB,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,KAAK,IAAI,MAAM;IAIf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAOrC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC;IAOrB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;IAyB5C,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAS1B,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;CAGrC"}

package/dist/rng/seedable-rng.js

@@ -0,0 +1,77 @@
+/**
+ * Seedable Random Number Generator
+ * Implements a Mulberry32 PRNG for deterministic output
+ */
+/**
+ * Mulberry32 - a fast, high-quality 32-bit PRNG
+ */
+function mulberry32(seed) {
+    return function () {
+        let t = seed += 0x6D2B79F5;
+        t = Math.imul(t ^ t >>> 15, t | 1);
+        t ^= t + Math.imul(t ^ t >>> 7, t | 61);
+        return ((t ^ t >>> 14) >>> 0) / 4294967296;
+    };
+}
+export class SeedableRng {
+    _seed;
+    _next;
+    constructor(seed = Date.now()) {
+        this._seed = seed;
+        this._next = mulberry32(seed);
+    }
+    seed(n) {
+        this._seed = n;
+        this._next = mulberry32(n);
+    }
+    get currentSeed() {
+        return this._seed;
+    }
+    float() {
+        return this._next();
+    }
+    int(min, max) {
+        if (min > max) {
+            [min, max] = [max, min];
+        }
+        return Math.floor(this.float() * (max - min + 1)) + min;
+    }
+    pick(list) {
+        if (list.length === 0) {
+            throw new Error('Cannot pick from empty list');
+        }
+        return list[this.int(0, list.length - 1)];
+    }
+    weightedPick(items) {
+        if (items.length === 0) {
+            throw new Error('Cannot pick from empty weighted list');
+        }
+        // Filter out zero/negative weights
+        const validItems = items.filter(i => i.weight > 0);
+        if (validItems.length === 0) {
+            throw new Error('All weights are zero or negative');
+        }
+        const totalWeight = validItems.reduce((sum, item) => sum + item.weight, 0);
+        let random = this.float() * totalWeight;
+        for (const item of validItems) {
+            random -= item.weight;
+            if (random <= 0) {
+                return item.item;
+            }
+        }
+        // Fallback (shouldn't happen, but for safety)
+        return validItems[validItems.length - 1].item;
+    }
+    shuffle(list) {
+        const result = [...list];
+        for (let i = result.length - 1; i > 0; i--) {
+            const j = this.int(0, i);
+            [result[i], result[j]] = [result[j], result[i]];
+        }
+        return result;
+    }
+    chance(probability) {
+        return this.float() < probability;
+    }
+}
+//# sourceMappingURL=seedable-rng.js.map

package/dist/rng/seedable-rng.js.map

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

package/dist/rng/seedable-rng.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=seedable-rng.test.d.ts.map

package/dist/rng/seedable-rng.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seedable-rng.test.d.ts","sourceRoot":"","sources":["../../src/rng/seedable-rng.test.ts"],"names":[],"mappings":""}