@focus-reactive/payload-plugin-translator 0.1.0

package/dist/server/modules/translation-pipeline/stages/text-expander/TextChunkExpander.test.js

@@ -0,0 +1,396 @@
+import { describe, it, expect } from 'vitest';
+import { TextChunkExpander } from './TextChunkExpander';
+import { PlainTextExpander } from './PlainTextExpander';
+import { RichTextExpander } from './RichTextExpander';
+const createFieldChunk = (name, type, value, overrides = {}) => {
+    const data = { [name]: value };
+    return {
+        chunk: {
+            schema: { name, type, ...overrides },
+            dataRef: data,
+            key: name,
+            path: [name],
+        },
+        data,
+    };
+};
+describe('PlainTextExpander', () => {
+    const expander = new PlainTextExpander();
+    describe('canExpand', () => {
+        it('returns true for non-empty string', () => {
+            const { chunk } = createFieldChunk('title', 'text', 'Hello');
+            expect(expander.canExpand(chunk, 'Hello')).toBe(true);
+        });
+        it('returns false for empty string', () => {
+            const { chunk } = createFieldChunk('title', 'text', '');
+            expect(expander.canExpand(chunk, '')).toBe(false);
+        });
+        it('returns false for whitespace-only string', () => {
+            const { chunk } = createFieldChunk('title', 'text', '   ');
+            expect(expander.canExpand(chunk, '   ')).toBe(false);
+        });
+        it('returns false for non-string values', () => {
+            const { chunk } = createFieldChunk('title', 'text', 123);
+            expect(expander.canExpand(chunk, 123)).toBe(false);
+            expect(expander.canExpand(chunk, null)).toBe(false);
+            expect(expander.canExpand(chunk, {})).toBe(false);
+        });
+    });
+    describe('expand', () => {
+        it('creates PlainTextChunk with correct structure', () => {
+            const { chunk, data } = createFieldChunk('title', 'text', 'Hello');
+            const result = expander.expand(chunk, 'Hello', 0);
+            expect(result.chunks).toHaveLength(1);
+            expect(result.chunks[0]).toEqual({
+                type: 'plain',
+                index: 0,
+                text: 'Hello',
+                dataRef: data,
+                key: 'title',
+            });
+        });
+        it('populates textMap correctly', () => {
+            const { chunk } = createFieldChunk('title', 'text', 'Hello');
+            const result = expander.expand(chunk, 'Hello', 5);
+            expect(result.textMap).toEqual({ 5: 'Hello' });
+        });
+        it('increments nextIndex', () => {
+            const { chunk } = createFieldChunk('title', 'text', 'Hello');
+            const result = expander.expand(chunk, 'Hello', 3);
+            expect(result.nextIndex).toBe(4);
+        });
+    });
+});
+// Helper for creating Lexical nodes
+const createNode = (type, props, children) => ({ type, ...props, ...(children && { children }) });
+const wrapInRoot = (children) => ({ root: createNode('root', {}, children) });
+describe('RichTextExpander', () => {
+    const expander = new RichTextExpander();
+    const createLexicalRoot = (textNodes) => ({
+        root: {
+            type: 'root',
+            children: textNodes.map((text) => ({
+                type: 'paragraph',
+                children: [{ type: 'text', text, version: 1 }],
+                direction: 'ltr',
+                format: '',
+                indent: 0,
+                version: 1,
+            })),
+            direction: 'ltr',
+            format: '',
+            indent: 0,
+            version: 1,
+        },
+    });
+    describe('canExpand', () => {
+        it('returns true for richText field with Lexical root', () => {
+            const { chunk } = createFieldChunk('content', 'richText', createLexicalRoot(['Hello']));
+            expect(expander.canExpand(chunk, createLexicalRoot(['Hello']))).toBe(true);
+        });
+        it('returns false for non-richText field type', () => {
+            const { chunk } = createFieldChunk('content', 'text', createLexicalRoot(['Hello']));
+            expect(expander.canExpand(chunk, createLexicalRoot(['Hello']))).toBe(false);
+        });
+        it('returns false for non-Lexical value', () => {
+            const { chunk } = createFieldChunk('content', 'richText', 'plain string');
+            expect(expander.canExpand(chunk, 'plain string')).toBe(false);
+        });
+    });
+    describe('expand', () => {
+        it('creates RichTextChunk for each text node', () => {
+            const value = createLexicalRoot(['Hello', 'World']);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(2);
+            expect(result.chunks[0].type).toBe('richText');
+            expect(result.chunks[0].text).toBe('Hello');
+            expect(result.chunks[1].text).toBe('World');
+        });
+        it('assigns sequential indices', () => {
+            const value = createLexicalRoot(['Hello', 'World']);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 10);
+            expect(result.chunks[0].index).toBe(10);
+            expect(result.chunks[1].index).toBe(11);
+            expect(result.nextIndex).toBe(12);
+        });
+        it('populates textMap correctly', () => {
+            const value = createLexicalRoot(['Hello', 'World']);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.textMap).toEqual({ 0: 'Hello', 1: 'World' });
+        });
+        it('stores nodeRef for mutation', () => {
+            const value = createLexicalRoot(['Hello']);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            const richTextChunk = result.chunks[0];
+            // Mutate through nodeRef
+            if ('nodeRef' in richTextChunk) {
+                richTextChunk.nodeRef.text = 'Modified';
+            }
+            // Check mutation affected original value
+            expect(value.root.children[0].children[0].text).toBe('Modified');
+        });
+    });
+    describe('complex structures', () => {
+        it('expands heading with text', () => {
+            const value = wrapInRoot([createNode('heading', { tag: 'h1' }, [createNode('text', { text: 'Title' })])]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(1);
+            expect(result.chunks[0].text).toBe('Title');
+        });
+        it('expands list with multiple items', () => {
+            const value = wrapInRoot([
+                createNode('list', { listType: 'bullet' }, [
+                    createNode('listitem', {}, [createNode('text', { text: 'Item 1' })]),
+                    createNode('listitem', {}, [createNode('text', { text: 'Item 2' })]),
+                    createNode('listitem', {}, [createNode('text', { text: 'Item 3' })]),
+                ]),
+            ]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(3);
+            expect(result.textMap).toEqual({ 0: 'Item 1', 1: 'Item 2', 2: 'Item 3' });
+        });
+        it('expands link with text inside', () => {
+            const value = wrapInRoot([
+                createNode('paragraph', {}, [
+                    createNode('text', { text: 'Click ' }),
+                    createNode('link', { url: 'https://example.com' }, [createNode('text', { text: 'here' })]),
+                    createNode('text', { text: ' to continue' }),
+                ]),
+            ]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(3);
+            expect(result.chunks[0].text).toBe('Click ');
+            expect(result.chunks[1].text).toBe('here');
+            expect(result.chunks[2].text).toBe(' to continue');
+        });
+        it('expands quote with nested paragraph', () => {
+            const value = wrapInRoot([
+                createNode('quote', {}, [createNode('paragraph', {}, [createNode('text', { text: 'Famous quote' })])]),
+            ]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(1);
+            expect(result.chunks[0].text).toBe('Famous quote');
+        });
+        it('expands paragraph with multiple formatted text nodes', () => {
+            const value = wrapInRoot([
+                createNode('paragraph', {}, [
+                    createNode('text', { text: 'Normal ' }),
+                    createNode('text', { text: 'bold', format: 1 }),
+                    createNode('text', { text: ' and ' }),
+                    createNode('text', { text: 'italic', format: 2 }),
+                ]),
+            ]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(4);
+            expect(result.textMap).toEqual({
+                0: 'Normal ',
+                1: 'bold',
+                2: ' and ',
+                3: 'italic',
+            });
+        });
+        it('expands nested list inside list item', () => {
+            const value = wrapInRoot([
+                createNode('list', { listType: 'number' }, [
+                    createNode('listitem', {}, [
+                        createNode('text', { text: 'Parent item' }),
+                        createNode('list', { listType: 'bullet' }, [
+                            createNode('listitem', {}, [createNode('text', { text: 'Nested 1' })]),
+                            createNode('listitem', {}, [createNode('text', { text: 'Nested 2' })]),
+                        ]),
+                    ]),
+                ]),
+            ]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(3);
+            expect(result.textMap).toEqual({
+                0: 'Parent item',
+                1: 'Nested 1',
+                2: 'Nested 2',
+            });
+        });
+        it('preserves nodeRef for mutation in complex structure', () => {
+            const textNode = createNode('text', { text: 'Original' });
+            const value = wrapInRoot([createNode('list', {}, [createNode('listitem', {}, [textNode])])]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            // Mutate through nodeRef
+            if ('nodeRef' in result.chunks[0]) {
+                result.chunks[0].nodeRef.text = 'Translated';
+            }
+            expect(textNode.text).toBe('Translated');
+        });
+        it('expands mixed content (heading + paragraphs + list)', () => {
+            const value = wrapInRoot([
+                createNode('heading', { tag: 'h1' }, [createNode('text', { text: 'Title' })]),
+                createNode('paragraph', {}, [createNode('text', { text: 'Introduction text.' })]),
+                createNode('list', { listType: 'bullet' }, [
+                    createNode('listitem', {}, [createNode('text', { text: 'Point one' })]),
+                    createNode('listitem', {}, [createNode('text', { text: 'Point two' })]),
+                ]),
+                createNode('paragraph', {}, [createNode('text', { text: 'Conclusion.' })]),
+            ]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(5);
+            expect(result.textMap).toEqual({
+                0: 'Title',
+                1: 'Introduction text.',
+                2: 'Point one',
+                3: 'Point two',
+                4: 'Conclusion.',
+            });
+        });
+    });
+    describe('skips non-text nodes', () => {
+        it('skips upload/image nodes', () => {
+            const value = wrapInRoot([
+                createNode('paragraph', {}, [createNode('text', { text: 'Before image' })]),
+                createNode('upload', { relationTo: 'media', value: { id: '123' } }),
+                createNode('paragraph', {}, [createNode('text', { text: 'After image' })]),
+            ]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(2);
+            expect(result.textMap).toEqual({ 0: 'Before image', 1: 'After image' });
+        });
+        it('skips linebreak nodes', () => {
+            const value = wrapInRoot([
+                createNode('paragraph', {}, [
+                    createNode('text', { text: 'Line one' }),
+                    createNode('linebreak', {}),
+                    createNode('text', { text: 'Line two' }),
+                ]),
+            ]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(2);
+            expect(result.textMap).toEqual({ 0: 'Line one', 1: 'Line two' });
+        });
+        it('skips horizontalrule nodes', () => {
+            const value = wrapInRoot([
+                createNode('paragraph', {}, [createNode('text', { text: 'Above' })]),
+                createNode('horizontalrule', {}),
+                createNode('paragraph', {}, [createNode('text', { text: 'Below' })]),
+            ]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(2);
+            expect(result.textMap).toEqual({ 0: 'Above', 1: 'Below' });
+        });
+        it('skips relationship/block nodes', () => {
+            const value = wrapInRoot([
+                createNode('paragraph', {}, [createNode('text', { text: 'Text content' })]),
+                createNode('relationship', { relationTo: 'posts', value: { id: '456' } }),
+                createNode('block', { fields: { blockType: 'cta' } }),
+            ]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(1);
+            expect(result.chunks[0].text).toBe('Text content');
+        });
+        it('only collects text nodes from mixed content', () => {
+            const value = wrapInRoot([
+                createNode('heading', { tag: 'h1' }, [createNode('text', { text: 'Title' })]),
+                createNode('upload', { relationTo: 'media' }),
+                createNode('paragraph', {}, [
+                    createNode('text', { text: 'Some ' }),
+                    createNode('linebreak', {}),
+                    createNode('text', { text: 'text' }),
+                ]),
+                createNode('horizontalrule', {}),
+                createNode('list', {}, [createNode('listitem', {}, [createNode('text', { text: 'Item' })])]),
+                createNode('relationship', { relationTo: 'pages' }),
+            ]);
+            const { chunk } = createFieldChunk('content', 'richText', value);
+            const result = expander.expand(chunk, value, 0);
+            expect(result.chunks).toHaveLength(4);
+            expect(result.textMap).toEqual({
+                0: 'Title',
+                1: 'Some ',
+                2: 'text',
+                3: 'Item',
+            });
+        });
+    });
+});
+describe('TextChunkExpander', () => {
+    const defaultExpanders = [new RichTextExpander(), new PlainTextExpander()];
+    describe('expand', () => {
+        it('expands multiple field chunks', () => {
+            const data1 = { title: 'Hello' };
+            const data2 = { description: 'World' };
+            const chunks = [
+                { schema: { name: 'title', type: 'text' }, dataRef: data1, key: 'title', path: ['title'] },
+                {
+                    schema: { name: 'description', type: 'text' },
+                    dataRef: data2,
+                    key: 'description',
+                    path: ['description'],
+                },
+            ];
+            const expander = new TextChunkExpander(defaultExpanders);
+            const result = expander.expand(chunks);
+            expect(result.textChunks).toHaveLength(2);
+            expect(result.textMap).toEqual({ 0: 'Hello', 1: 'World' });
+        });
+        it('assigns unique indices across all chunks', () => {
+            const richTextValue = {
+                root: {
+                    type: 'root',
+                    children: [
+                        { type: 'paragraph', children: [{ type: 'text', text: 'First', version: 1 }], version: 1 },
+                        { type: 'paragraph', children: [{ type: 'text', text: 'Second', version: 1 }], version: 1 },
+                    ],
+                    version: 1,
+                },
+            };
+            const data1 = { content: richTextValue };
+            const data2 = { title: 'Third' };
+            const chunks = [
+                { schema: { name: 'content', type: 'richText' }, dataRef: data1, key: 'content', path: ['content'] },
+                { schema: { name: 'title', type: 'text' }, dataRef: data2, key: 'title', path: ['title'] },
+            ];
+            const expander = new TextChunkExpander(defaultExpanders);
+            const result = expander.expand(chunks);
+            expect(result.textChunks).toHaveLength(3);
+            expect(result.textMap).toEqual({ 0: 'First', 1: 'Second', 2: 'Third' });
+        });
+        it('uses first matching expander', () => {
+            const data = { title: 'Hello' };
+            const chunks = [
+                { schema: { name: 'title', type: 'text' }, dataRef: data, key: 'title', path: ['title'] },
+            ];
+            // RichTextExpander won't match, PlainTextExpander will
+            const expander = new TextChunkExpander(defaultExpanders);
+            const result = expander.expand(chunks);
+            expect(result.textChunks[0].type).toBe('plain');
+        });
+        it('skips chunks with no matching expander', () => {
+            const data = { title: 123 }; // number, no expander matches
+            const chunks = [
+                { schema: { name: 'title', type: 'text' }, dataRef: data, key: 'title', path: ['title'] },
+            ];
+            const expander = new TextChunkExpander(defaultExpanders);
+            const result = expander.expand(chunks);
+            expect(result.textChunks).toHaveLength(0);
+            expect(result.textMap).toEqual({});
+        });
+        it('returns empty result for empty input', () => {
+            const expander = new TextChunkExpander(defaultExpanders);
+            const result = expander.expand([]);
+            expect(result.textChunks).toEqual([]);
+            expect(result.textMap).toEqual({});
+        });
+    });
+});

package/dist/server/modules/translation-pipeline/stages/text-expander/TextExpander.interface.d.ts

@@ -0,0 +1,27 @@
+import type { FieldChunk, TextChunk } from '../../types';
+/**
+ * Result of text expansion for a single FieldChunk.
+ */
+export type ExpansionResult = {
+    /** Generated TextChunks */
+    chunks: TextChunk[];
+    /** Map of index -> text for translation API */
+    textMap: Record<number, string>;
+    /** Next available index */
+    nextIndex: number;
+};
+/**
+ * Interface for text expanders.
+ * Each expander handles a specific type of field (plain text, richText).
+ */
+export interface TextExpander {
+    /**
+     * Checks if this expander can handle the given field chunk.
+     */
+    canExpand(chunk: FieldChunk, value: unknown): boolean;
+    /**
+     * Expands a FieldChunk into one or more TextChunks.
+     */
+    expand(chunk: FieldChunk, value: unknown, startIndex: number): ExpansionResult;
+}
+//# sourceMappingURL=TextExpander.interface.d.ts.map

package/dist/server/modules/translation-pipeline/stages/text-expander/TextExpander.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextExpander.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/server/modules/translation-pipeline/stages/text-expander/TextExpander.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAExD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,2BAA2B;IAC3B,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAA;IAErD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,CAAA;CAC/E"}

package/dist/server/modules/translation-pipeline/stages/text-expander/TextExpander.interface.js

@@ -0,0 +1,6 @@
+/**
+ * Interface for text expanders.
+ * Each expander handles a specific type of field (plain text, richText).
+ */ export { };
+
+//# sourceMappingURL=TextExpander.interface.js.map

package/dist/server/modules/translation-pipeline/stages/text-expander/TextExpander.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/server/modules/translation-pipeline/stages/text-expander/TextExpander.interface.ts"],"sourcesContent":["import type { FieldChunk, TextChunk } from '../../types'\n\n/**\n * Result of text expansion for a single FieldChunk.\n */\nexport type ExpansionResult = {\n  /** Generated TextChunks */\n  chunks: TextChunk[]\n  /** Map of index -> text for translation API */\n  textMap: Record<number, string>\n  /** Next available index */\n  nextIndex: number\n}\n\n/**\n * Interface for text expanders.\n * Each expander handles a specific type of field (plain text, richText).\n */\nexport interface TextExpander {\n  /**\n   * Checks if this expander can handle the given field chunk.\n   */\n  canExpand(chunk: FieldChunk, value: unknown): boolean\n\n  /**\n   * Expands a FieldChunk into one or more TextChunks.\n   */\n  expand(chunk: FieldChunk, value: unknown, startIndex: number): ExpansionResult\n}\n"],"names":[],"mappings":"AAcA;;;CAGC,GACD,WAUC"}

package/dist/server/modules/translation-pipeline/stages/text-expander/index.d.ts

@@ -0,0 +1,7 @@
+export { TextChunkExpander } from './TextChunkExpander';
+export type { TextExpansionResult } from './TextChunkExpander';
+export type { TextExpander, ExpansionResult } from './TextExpander.interface';
+export { PlainTextExpander } from './PlainTextExpander';
+export { RichTextExpander } from './RichTextExpander';
+export { TextChunkExpanderStage } from './TextChunkExpander.stage';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/modules/translation-pipeline/stages/text-expander/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/server/modules/translation-pipeline/stages/text-expander/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/server/modules/translation-pipeline/stages/text-expander/index.js

@@ -0,0 +1,6 @@
+export { TextChunkExpander } from './TextChunkExpander';
+export { PlainTextExpander } from './PlainTextExpander';
+export { RichTextExpander } from './RichTextExpander';
+export { TextChunkExpanderStage } from './TextChunkExpander.stage';
+
+//# sourceMappingURL=index.js.map

package/dist/server/modules/translation-pipeline/stages/text-expander/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/server/modules/translation-pipeline/stages/text-expander/index.ts"],"sourcesContent":["export { TextChunkExpander } from './TextChunkExpander'\nexport type { TextExpansionResult } from './TextChunkExpander'\nexport type { TextExpander, ExpansionResult } from './TextExpander.interface'\nexport { PlainTextExpander } from './PlainTextExpander'\nexport { RichTextExpander } from './RichTextExpander'\nexport { TextChunkExpanderStage } from './TextChunkExpander.stage'\n"],"names":["TextChunkExpander","PlainTextExpander","RichTextExpander","TextChunkExpanderStage"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,sBAAqB;AAGvD,SAASC,iBAAiB,QAAQ,sBAAqB;AACvD,SAASC,gBAAgB,QAAQ,qBAAoB;AACrD,SAASC,sBAAsB,QAAQ,4BAA2B"}

package/dist/server/modules/translation-pipeline/stages/translation/Translation.stage.d.ts

@@ -0,0 +1,11 @@
+import type { PipelineContext, PipelineStage } from '../../types';
+import type { TranslationProvider } from '../../../translation-providers';
+/**
+ * Calls translation provider to translate text.
+ */
+export declare class TranslationStage implements PipelineStage {
+    private readonly provider;
+    constructor(provider: TranslationProvider);
+    execute(ctx: PipelineContext): Promise<PipelineContext>;
+}
+//# sourceMappingURL=Translation.stage.d.ts.map

package/dist/server/modules/translation-pipeline/stages/translation/Translation.stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Translation.stage.d.ts","sourceRoot":"","sources":["../../../../../../src/server/modules/translation-pipeline/stages/translation/Translation.stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAEzE;;GAEG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,mBAAmB;IAEpD,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;CAgB9D"}

package/dist/server/modules/translation-pipeline/stages/translation/Translation.stage.js

@@ -0,0 +1,23 @@
+/**
+ * Calls translation provider to translate text.
+ */ export class TranslationStage {
+    provider;
+    constructor(provider){
+        this.provider = provider;
+    }
+    async execute(ctx) {
+        if (!ctx.textMap || Object.keys(ctx.textMap).length === 0) {
+            return ctx;
+        }
+        const translations = await this.provider.translate(ctx.textMap, ctx.sourceLng, ctx.targetLng);
+        if (!translations) {
+            throw new Error('Translation provider returned null');
+        }
+        return {
+            ...ctx,
+            translations
+        };
+    }
+}
+
+//# sourceMappingURL=Translation.stage.js.map

package/dist/server/modules/translation-pipeline/stages/translation/Translation.stage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/server/modules/translation-pipeline/stages/translation/Translation.stage.ts"],"sourcesContent":["import type { PipelineContext, PipelineStage } from '../../types'\nimport type { TranslationProvider } from '../../../translation-providers'\n\n/**\n * Calls translation provider to translate text.\n */\nexport class TranslationStage implements PipelineStage {\n  constructor(private readonly provider: TranslationProvider) {}\n\n  async execute(ctx: PipelineContext): Promise<PipelineContext> {\n    if (!ctx.textMap || Object.keys(ctx.textMap).length === 0) {\n      return ctx\n    }\n\n    const translations = await this.provider.translate(ctx.textMap, ctx.sourceLng, ctx.targetLng)\n\n    if (!translations) {\n      throw new Error('Translation provider returned null')\n    }\n\n    return {\n      ...ctx,\n      translations,\n    }\n  }\n}\n"],"names":["TranslationStage","provider","execute","ctx","textMap","Object","keys","length","translations","translate","sourceLng","targetLng","Error"],"mappings":"AAGA;;CAEC,GACD,OAAO,MAAMA;;IACX,YAAY,AAAiBC,QAA6B,CAAE;aAA/BA,WAAAA;IAAgC;IAE7D,MAAMC,QAAQC,GAAoB,EAA4B;QAC5D,IAAI,CAACA,IAAIC,OAAO,IAAIC,OAAOC,IAAI,CAACH,IAAIC,OAAO,EAAEG,MAAM,KAAK,GAAG;YACzD,OAAOJ;QACT;QAEA,MAAMK,eAAe,MAAM,IAAI,CAACP,QAAQ,CAACQ,SAAS,CAACN,IAAIC,OAAO,EAAED,IAAIO,SAAS,EAAEP,IAAIQ,SAAS;QAE5F,IAAI,CAACH,cAAc;YACjB,MAAM,IAAII,MAAM;QAClB;QAEA,OAAO;YACL,GAAGT,GAAG;YACNK;QACF;IACF;AACF"}

package/dist/server/modules/translation-pipeline/stages/translation/index.d.ts

@@ -0,0 +1,2 @@
+export { TranslationStage } from './Translation.stage';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/modules/translation-pipeline/stages/translation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/server/modules/translation-pipeline/stages/translation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/server/modules/translation-pipeline/stages/translation/index.js

@@ -0,0 +1,3 @@
+export { TranslationStage } from './Translation.stage';
+
+//# sourceMappingURL=index.js.map

package/dist/server/modules/translation-pipeline/stages/translation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/server/modules/translation-pipeline/stages/translation/index.ts"],"sourcesContent":["export { TranslationStage } from './Translation.stage'\n"],"names":["TranslationStage"],"mappings":"AAAA,SAASA,gBAAgB,QAAQ,sBAAqB"}

package/dist/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.d.ts

@@ -0,0 +1,18 @@
+import type { TextChunk } from '../../types';
+/**
+ * Applies translations by mutating data through TextChunk references.
+ * This is the simplest stage - just direct mutation.
+ *
+ * Stage 5 of the translation pipeline.
+ */
+export declare class TranslationMutator {
+    /**
+     * Applies translations to source data via TextChunk references.
+     *
+     * @param textChunks - TextChunks with references to data
+     * @param translations - Map of index -> translated text
+     * @returns Mutation result with count of translated chunks
+     */
+    apply(textChunks: TextChunk[], translations: Record<number, string>): void;
+}
+//# sourceMappingURL=TranslationMutator.d.ts.map

package/dist/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationMutator.d.ts","sourceRoot":"","sources":["../../../../../../src/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAY3E"}

package/dist/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.js

@@ -0,0 +1,27 @@
+import { isPlainTextChunk, isRichTextChunk } from '../../types';
+/**
+ * Applies translations by mutating data through TextChunk references.
+ * This is the simplest stage - just direct mutation.
+ *
+ * Stage 5 of the translation pipeline.
+ */ export class TranslationMutator {
+    /**
+   * Applies translations to source data via TextChunk references.
+   *
+   * @param textChunks - TextChunks with references to data
+   * @param translations - Map of index -> translated text
+   * @returns Mutation result with count of translated chunks
+   */ apply(textChunks, translations) {
+        for (const chunk of textChunks){
+            const translation = translations[chunk.index];
+            if (translation === undefined) continue;
+            if (isPlainTextChunk(chunk)) {
+                chunk.dataRef[chunk.key] = translation;
+            } else if (isRichTextChunk(chunk)) {
+                chunk.nodeRef.text = translation;
+            }
+        }
+    }
+}
+
+//# sourceMappingURL=TranslationMutator.js.map

package/dist/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.ts"],"sourcesContent":["import type { TextChunk } from '../../types'\nimport { isPlainTextChunk, isRichTextChunk } from '../../types'\n\n/**\n * Applies translations by mutating data through TextChunk references.\n * This is the simplest stage - just direct mutation.\n *\n * Stage 5 of the translation pipeline.\n */\nexport class TranslationMutator {\n  /**\n   * Applies translations to source data via TextChunk references.\n   *\n   * @param textChunks - TextChunks with references to data\n   * @param translations - Map of index -> translated text\n   * @returns Mutation result with count of translated chunks\n   */\n  apply(textChunks: TextChunk[], translations: Record<number, string>): void {\n    for (const chunk of textChunks) {\n      const translation = translations[chunk.index]\n      if (translation === undefined) continue\n\n      if (isPlainTextChunk(chunk)) {\n        chunk.dataRef[chunk.key] = translation\n      } else if (isRichTextChunk(chunk)) {\n        chunk.nodeRef.text = translation\n      }\n    }\n  }\n}\n"],"names":["isPlainTextChunk","isRichTextChunk","TranslationMutator","apply","textChunks","translations","chunk","translation","index","undefined","dataRef","key","nodeRef","text"],"mappings":"AACA,SAASA,gBAAgB,EAAEC,eAAe,QAAQ,cAAa;AAE/D;;;;;CAKC,GACD,OAAO,MAAMC;IACX;;;;;;GAMC,GACDC,MAAMC,UAAuB,EAAEC,YAAoC,EAAQ;QACzE,KAAK,MAAMC,SAASF,WAAY;YAC9B,MAAMG,cAAcF,YAAY,CAACC,MAAME,KAAK,CAAC;YAC7C,IAAID,gBAAgBE,WAAW;YAE/B,IAAIT,iBAAiBM,QAAQ;gBAC3BA,MAAMI,OAAO,CAACJ,MAAMK,GAAG,CAAC,GAAGJ;YAC7B,OAAO,IAAIN,gBAAgBK,QAAQ;gBACjCA,MAAMM,OAAO,CAACC,IAAI,GAAGN;YACvB;QACF;IACF;AACF"}

package/dist/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.stage.d.ts

@@ -0,0 +1,8 @@
+import type { PipelineContext, PipelineStage } from '../../types';
+/**
+ * Applies translations to data via mutation.
+ */
+export declare class TranslationMutatorStage implements PipelineStage {
+    execute(ctx: PipelineContext): PipelineContext;
+}
+//# sourceMappingURL=TranslationMutator.stage.d.ts.map

package/dist/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationMutator.stage.d.ts","sourceRoot":"","sources":["../../../../../../src/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGjE;;GAEG;AACH,qBAAa,uBAAwB,YAAW,aAAa;IAC3D,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe;CAU/C"}

package/dist/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.stage.js

@@ -0,0 +1,15 @@
+import { TranslationMutator } from './TranslationMutator';
+/**
+ * Applies translations to data via mutation.
+ */ export class TranslationMutatorStage {
+    execute(ctx) {
+        if (!ctx.textChunks || !ctx.translations) {
+            throw new Error('TranslationMutatorStage requires textChunks and translations');
+        }
+        const mutator = new TranslationMutator();
+        mutator.apply(ctx.textChunks, ctx.translations);
+        return ctx;
+    }
+}
+
+//# sourceMappingURL=TranslationMutator.stage.js.map

package/dist/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.stage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.stage.ts"],"sourcesContent":["import type { PipelineContext, PipelineStage } from '../../types'\nimport { TranslationMutator } from './TranslationMutator'\n\n/**\n * Applies translations to data via mutation.\n */\nexport class TranslationMutatorStage implements PipelineStage {\n  execute(ctx: PipelineContext): PipelineContext {\n    if (!ctx.textChunks || !ctx.translations) {\n      throw new Error('TranslationMutatorStage requires textChunks and translations')\n    }\n\n    const mutator = new TranslationMutator()\n    mutator.apply(ctx.textChunks, ctx.translations)\n\n    return ctx\n  }\n}\n"],"names":["TranslationMutator","TranslationMutatorStage","execute","ctx","textChunks","translations","Error","mutator","apply"],"mappings":"AACA,SAASA,kBAAkB,QAAQ,uBAAsB;AAEzD;;CAEC,GACD,OAAO,MAAMC;IACXC,QAAQC,GAAoB,EAAmB;QAC7C,IAAI,CAACA,IAAIC,UAAU,IAAI,CAACD,IAAIE,YAAY,EAAE;YACxC,MAAM,IAAIC,MAAM;QAClB;QAEA,MAAMC,UAAU,IAAIP;QACpBO,QAAQC,KAAK,CAACL,IAAIC,UAAU,EAAED,IAAIE,YAAY;QAE9C,OAAOF;IACT;AACF"}

package/dist/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.test.d.ts

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

package/dist/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationMutator.test.d.ts","sourceRoot":"","sources":["../../../../../../src/server/modules/translation-pipeline/stages/translation-applicator/TranslationMutator.test.ts"],"names":[],"mappings":""}