@pinepaper.studio/mcp-server 1.0.0

package/dist/browser/bridge.js.map

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

package/dist/browser/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * PinePaper Browser Module
+ *
+ * Exports for browser-side usage of PinePaper MCP tools.
+ */
+export { PinePaperBridge, PinePaperStudioHandler, createBridge, createStudioHandler, type BridgeMessage, type BridgeConfig, } from './bridge.js';
+export { PinePaperBrowserController, getBrowserController, resetBrowserController, type BrowserControllerConfig, type ExecuteResult, } from './puppeteer-controller.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,aAAa,GACnB,MAAM,2BAA2B,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,8 @@
+/**
+ * PinePaper Browser Module
+ *
+ * Exports for browser-side usage of PinePaper MCP tools.
+ */
+export { PinePaperBridge, PinePaperStudioHandler, createBridge, createStudioHandler, } from './bridge.js';
+export { PinePaperBrowserController, getBrowserController, resetBrowserController, } from './puppeteer-controller.js';
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,GAGpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,GAGvB,MAAM,2BAA2B,CAAC"}

package/dist/browser/puppeteer-controller.d.ts

@@ -0,0 +1,93 @@
+/**
+ * PinePaper Puppeteer Controller
+ *
+ * Controls a real browser instance running PinePaper Studio.
+ * Executes code directly via page.evaluate() and provides screenshots.
+ */
+export interface BrowserControllerConfig {
+    /** PinePaper Studio URL (default: https://pinepaper.studio) */
+    studioUrl?: string;
+    /** Whether to run browser in headless mode (default: false for visibility) */
+    headless?: boolean;
+    /** Browser viewport width (default: 1280) */
+    viewportWidth?: number;
+    /** Browser viewport height (default: 800) */
+    viewportHeight?: number;
+    /** Timeout for page operations in ms (default: 30000) */
+    timeout?: number;
+}
+export interface ExecuteResult {
+    success: boolean;
+    result?: unknown;
+    error?: string;
+    screenshot?: string;
+}
+/**
+ * Controls PinePaper Studio via Puppeteer.
+ *
+ * This controller:
+ * 1. Launches a browser and navigates to PinePaper Studio
+ * 2. Executes JavaScript code directly in the page context
+ * 3. Captures screenshots to show results
+ */
+export declare class PinePaperBrowserController {
+    private browser;
+    private page;
+    private config;
+    private isConnected;
+    constructor(config?: BrowserControllerConfig);
+    /**
+     * Check if connected to browser
+     */
+    get connected(): boolean;
+    /**
+     * Get current studio URL
+     */
+    get studioUrl(): string;
+    /**
+     * Launch browser and navigate to PinePaper Studio
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect and close browser
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Execute JavaScript code in PinePaper Studio
+     */
+    executeCode(code: string, takeScreenshot?: boolean): Promise<ExecuteResult>;
+    /**
+     * Take a screenshot of the current canvas
+     */
+    takeScreenshot(): Promise<string | undefined>;
+    /**
+     * Get the current page URL
+     */
+    getCurrentUrl(): Promise<string | undefined>;
+    /**
+     * Navigate to a different URL
+     */
+    navigateTo(url: string): Promise<void>;
+    /**
+     * Reload the page
+     */
+    reload(): Promise<void>;
+    /**
+     * Refresh the page and wait for PinePaper to be ready again.
+     * This is the most reliable way to get a clean canvas.
+     */
+    refreshPage(): Promise<void>;
+    /**
+     * Check if PinePaper API is available
+     */
+    checkPinePaperReady(): Promise<boolean>;
+}
+/**
+ * Get or create the global browser controller instance
+ */
+export declare function getBrowserController(config?: BrowserControllerConfig): PinePaperBrowserController;
+/**
+ * Reset the global controller (for testing)
+ */
+export declare function resetBrowserController(): void;
+//# sourceMappingURL=puppeteer-controller.d.ts.map

package/dist/browser/puppeteer-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer-controller.d.ts","sourceRoot":"","sources":["../../src/browser/puppeteer-controller.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;GAOG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,uBAA4B;IAgBhD;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwD9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,UAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IA6C9E;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA6BnD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAIlD;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAU7B;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BlC;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;CAiB9C;AAQD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,uBAAuB,GAC/B,0BAA0B,CAK5B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAK7C"}

package/dist/browser/puppeteer-controller.js

@@ -0,0 +1,280 @@
+/**
+ * PinePaper Puppeteer Controller
+ *
+ * Controls a real browser instance running PinePaper Studio.
+ * Executes code directly via page.evaluate() and provides screenshots.
+ */
+// =============================================================================
+// BROWSER CONTROLLER CLASS
+// =============================================================================
+/**
+ * Controls PinePaper Studio via Puppeteer.
+ *
+ * This controller:
+ * 1. Launches a browser and navigates to PinePaper Studio
+ * 2. Executes JavaScript code directly in the page context
+ * 3. Captures screenshots to show results
+ */
+export class PinePaperBrowserController {
+    browser = null;
+    page = null;
+    config;
+    isConnected = false;
+    constructor(config = {}) {
+        // Ensure URL points to /editor where the code console and API are available
+        let studioUrl = config.studioUrl || 'https://pinepaper.studio';
+        if (!studioUrl.includes('/editor')) {
+            studioUrl = studioUrl.replace(/\/$/, '') + '/editor';
+        }
+        this.config = {
+            studioUrl,
+            headless: config.headless ?? false, // Default to visible browser
+            viewportWidth: config.viewportWidth || 1280,
+            viewportHeight: config.viewportHeight || 800,
+            timeout: config.timeout || 30000,
+        };
+    }
+    /**
+     * Check if connected to browser
+     */
+    get connected() {
+        return this.isConnected && this.page !== null;
+    }
+    /**
+     * Get current studio URL
+     */
+    get studioUrl() {
+        return this.config.studioUrl;
+    }
+    /**
+     * Launch browser and navigate to PinePaper Studio
+     */
+    async connect() {
+        if (this.isConnected) {
+            console.error('[PinePaper] Already connected');
+            return;
+        }
+        try {
+            // Dynamic import to avoid issues when puppeteer isn't installed
+            const puppeteer = await import('puppeteer');
+            console.error('[PinePaper] Launching browser...');
+            this.browser = await puppeteer.default.launch({
+                headless: this.config.headless,
+                args: [
+                    '--no-sandbox',
+                    '--disable-setuid-sandbox',
+                    `--window-size=${this.config.viewportWidth},${this.config.viewportHeight}`,
+                ],
+            });
+            this.page = await this.browser.newPage();
+            await this.page.setViewport({
+                width: this.config.viewportWidth,
+                height: this.config.viewportHeight,
+            });
+            console.error(`[PinePaper] Navigating to ${this.config.studioUrl}...`);
+            await this.page.goto(this.config.studioUrl, {
+                waitUntil: 'networkidle2',
+                timeout: this.config.timeout,
+            });
+            // Wait for PinePaper to be ready (check for app object)
+            console.error('[PinePaper] Waiting for PinePaper Studio to initialize...');
+            await this.page.waitForFunction(() => {
+                // Check if PinePaper's global app or API is available
+                return (typeof window.app !== 'undefined' ||
+                    typeof window.pinepaper !== 'undefined' ||
+                    typeof window.paper !== 'undefined');
+            }, { timeout: this.config.timeout });
+            this.isConnected = true;
+            console.error('[PinePaper] Connected to PinePaper Studio');
+        }
+        catch (error) {
+            await this.disconnect();
+            throw new Error(`Failed to connect to PinePaper Studio: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Disconnect and close browser
+     */
+    async disconnect() {
+        if (this.browser) {
+            try {
+                await this.browser.close();
+            }
+            catch {
+                // Ignore errors during cleanup
+            }
+        }
+        this.browser = null;
+        this.page = null;
+        this.isConnected = false;
+        console.error('[PinePaper] Disconnected from browser');
+    }
+    /**
+     * Execute JavaScript code in PinePaper Studio
+     */
+    async executeCode(code, takeScreenshot = true) {
+        if (!this.page || !this.isConnected) {
+            return {
+                success: false,
+                error: 'Not connected to PinePaper Studio. Call connect() first.',
+            };
+        }
+        try {
+            // Execute the code in page context
+            const result = await this.page.evaluate((codeToRun) => {
+                try {
+                    // eslint-disable-next-line no-eval
+                    const evalResult = eval(codeToRun);
+                    // Handle promises
+                    if (evalResult instanceof Promise) {
+                        return evalResult.then((r) => ({ success: true, result: r }));
+                    }
+                    return { success: true, result: evalResult };
+                }
+                catch (e) {
+                    return {
+                        success: false,
+                        error: e instanceof Error ? e.message : 'Execution error',
+                    };
+                }
+            }, code);
+            // Take screenshot if requested
+            let screenshot;
+            if (takeScreenshot && result.success) {
+                screenshot = await this.takeScreenshot();
+            }
+            return {
+                ...result,
+                screenshot,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown execution error',
+            };
+        }
+    }
+    /**
+     * Take a screenshot of the current canvas
+     */
+    async takeScreenshot() {
+        if (!this.page) {
+            return undefined;
+        }
+        try {
+            // Try to capture just the canvas element, fallback to full page
+            const canvasElement = await this.page.$('canvas');
+            if (canvasElement) {
+                const screenshot = await canvasElement.screenshot({
+                    encoding: 'base64',
+                    type: 'png',
+                });
+                return screenshot;
+            }
+            // Fallback to full page
+            const screenshot = await this.page.screenshot({
+                encoding: 'base64',
+                type: 'png',
+                fullPage: false,
+            });
+            return screenshot;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Get the current page URL
+     */
+    async getCurrentUrl() {
+        return this.page?.url();
+    }
+    /**
+     * Navigate to a different URL
+     */
+    async navigateTo(url) {
+        if (!this.page) {
+            throw new Error('Not connected to browser');
+        }
+        await this.page.goto(url, {
+            waitUntil: 'networkidle2',
+            timeout: this.config.timeout,
+        });
+    }
+    /**
+     * Reload the page
+     */
+    async reload() {
+        if (!this.page) {
+            throw new Error('Not connected to browser');
+        }
+        await this.page.reload({
+            waitUntil: 'networkidle2',
+            timeout: this.config.timeout,
+        });
+    }
+    /**
+     * Refresh the page and wait for PinePaper to be ready again.
+     * This is the most reliable way to get a clean canvas.
+     */
+    async refreshPage() {
+        if (!this.page) {
+            throw new Error('Not connected to browser');
+        }
+        console.error('[PinePaper] Refreshing page...');
+        await this.page.reload({
+            waitUntil: 'networkidle2',
+            timeout: this.config.timeout,
+        });
+        // Wait for PinePaper to be ready again
+        console.error('[PinePaper] Waiting for PinePaper Studio to reinitialize...');
+        await this.page.waitForFunction(() => {
+            return (typeof window.app !== 'undefined' ||
+                typeof window.pinepaper !== 'undefined' ||
+                typeof window.paper !== 'undefined');
+        }, { timeout: this.config.timeout });
+        console.error('[PinePaper] Page refreshed and ready');
+    }
+    /**
+     * Check if PinePaper API is available
+     */
+    async checkPinePaperReady() {
+        if (!this.page) {
+            return false;
+        }
+        try {
+            return await this.page.evaluate(() => {
+                return (typeof window.app !== 'undefined' ||
+                    typeof window.pinepaper !== 'undefined' ||
+                    typeof window.paper !== 'undefined');
+            });
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// =============================================================================
+// SINGLETON INSTANCE
+// =============================================================================
+let globalController = null;
+/**
+ * Get or create the global browser controller instance
+ */
+export function getBrowserController(config) {
+    if (!globalController) {
+        globalController = new PinePaperBrowserController(config);
+    }
+    return globalController;
+}
+/**
+ * Reset the global controller (for testing)
+ */
+export function resetBrowserController() {
+    if (globalController) {
+        globalController.disconnect().catch(() => { });
+        globalController = null;
+    }
+}
+//# sourceMappingURL=puppeteer-controller.js.map

package/dist/browser/puppeteer-controller.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env bun
+/**
+ * PinePaper MCP Server CLI
+ *
+ * Entry point for running the MCP server from command line.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/cli.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env bun
+/**
+ * PinePaper MCP Server CLI
+ *
+ * Entry point for running the MCP server from command line.
+ */
+import { createServer } from './index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+const VERSION = '1.0.0';
+async function main() {
+    const args = process.argv.slice(2);
+    // Handle help flag
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(`
+PinePaper MCP Server v${VERSION}
+
+Create animated graphics with AI using the Model Context Protocol.
+
+USAGE:
+  pinepaper-mcp [options]
+
+OPTIONS:
+  --help, -h      Show this help message
+  --version, -v   Show version number
+
+CONFIGURATION:
+  Add to your Claude Desktop config (claude_desktop_config.json):
+
+  {
+    "mcpServers": {
+      "pinepaper": {
+        "command": "npx",
+        "args": ["-y", "@pinepaper/mcp-server"]
+      }
+    }
+  }
+
+TOOLS:
+  Item Creation:
+    - pinepaper_create_item    Create text, shapes, graphics
+    - pinepaper_modify_item    Modify item properties
+    - pinepaper_delete_item    Remove items
+
+  Relations (Animation):
+    - pinepaper_add_relation   Create behavior relationships
+    - pinepaper_remove_relation Remove relationships
+    - pinepaper_query_relations Query existing relations
+
+  Animation:
+    - pinepaper_animate        Simple loop animations
+    - pinepaper_keyframe_animate Timed keyframe animations
+    - pinepaper_play_timeline  Control playback
+
+  Generators:
+    - pinepaper_execute_generator Run background generators
+    - pinepaper_list_generators   List available generators
+
+  Effects:
+    - pinepaper_apply_effect   Apply visual effects
+
+  Query:
+    - pinepaper_get_items      Get canvas items
+    - pinepaper_get_relation_stats Get relation statistics
+
+  Canvas:
+    - pinepaper_set_background_color Set background
+    - pinepaper_set_canvas_size      Set dimensions
+
+  Export:
+    - pinepaper_export_svg          Export as animated SVG
+    - pinepaper_export_training_data Export LLM training pairs
+
+DOCUMENTATION:
+  https://pinepaper.studio/docs/mcp
+
+SUPPORT:
+  https://github.com/pinepaper/mcp-server/issues
+`);
+        process.exit(0);
+    }
+    // Handle version flag
+    if (args.includes('--version') || args.includes('-v')) {
+        console.log(VERSION);
+        process.exit(0);
+    }
+    // Start the server
+    try {
+        const server = await createServer();
+        const transport = new StdioServerTransport();
+        console.error('╔═══════════════════════════════════════════════════╗');
+        console.error('║          PinePaper MCP Server v' + VERSION + '             ║');
+        console.error('╠═══════════════════════════════════════════════════╣');
+        console.error('║  Create animated graphics with AI                 ║');
+        console.error('║  https://pinepaper.studio                         ║');
+        console.error('╚═══════════════════════════════════════════════════╝');
+        console.error('');
+        console.error('Server starting on stdio transport...');
+        await server.connect(transport);
+        console.error('✓ Server connected and ready');
+        console.error('');
+        console.error('Waiting for tool calls...');
+    }
+    catch (error) {
+        console.error('Failed to start server:', error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,mBAAmB;IACnB,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC;wBACQ,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+D9B,CAAC,CAAC;QACC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,sBAAsB;IACtB,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,mBAAmB;IACnB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,mCAAmC,GAAG,OAAO,GAAG,gBAAgB,CAAC,CAAC;QAChF,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAEvD,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/i18n/i18n-manager.d.ts

@@ -0,0 +1,88 @@
+/**
+ * i18n Manager
+ *
+ * Handles internationalization for the PinePaper MCP Server.
+ * Supports all 41 locales from PinePaper Studio.
+ */
+import { SupportedLocale, TranslationKeys, TranslationFunction } from './types.js';
+export interface I18nConfig {
+    defaultLocale?: SupportedLocale;
+    fallbackLocale?: SupportedLocale;
+    loadPath?: string;
+}
+export declare class I18nManager {
+    private currentLocale;
+    private fallbackLocale;
+    private translations;
+    private loadedLocales;
+    constructor(config?: I18nConfig);
+    /**
+     * Load translations for a locale
+     */
+    loadLocale(locale: SupportedLocale): Promise<void>;
+    /**
+     * Set the current locale
+     */
+    setLocale(locale: SupportedLocale): Promise<void>;
+    /**
+     * Get the current locale
+     */
+    getLocale(): SupportedLocale;
+    /**
+     * Check if current locale is RTL
+     */
+    isRTL(): boolean;
+    /**
+     * Get translation for a key
+     */
+    t(key: string, params?: Record<string, string | number>): string;
+    /**
+     * Get a translation function bound to current locale
+     */
+    getTranslationFunction(): TranslationFunction;
+    /**
+     * Get all translations for current locale
+     */
+    getTranslations(): TranslationKeys | undefined;
+    /**
+     * Get tool description in current locale
+     */
+    getToolDescription(toolName: string): string;
+    /**
+     * Get tool name in current locale
+     */
+    getToolName(toolName: string): string;
+    /**
+     * Get error message in current locale
+     */
+    getError(errorKey: string, params?: Record<string, string | number>): string;
+    /**
+     * Get success message in current locale
+     */
+    getSuccess(successKey: string, params?: Record<string, string | number>): string;
+    /**
+     * Detect locale from Accept-Language header
+     */
+    static detectLocale(acceptLanguage?: string): SupportedLocale;
+    /**
+     * Get nested value from object
+     */
+    private getNestedValue;
+    /**
+     * Interpolate parameters into translation string
+     */
+    private interpolate;
+}
+/**
+ * Get the singleton i18n manager instance
+ */
+export declare function getI18n(): I18nManager;
+/**
+ * Initialize i18n with a specific locale
+ */
+export declare function initI18n(locale?: SupportedLocale): Promise<I18nManager>;
+/**
+ * Shorthand translation function
+ */
+export declare function t(key: string, params?: Record<string, string | number>): string;
+//# sourceMappingURL=i18n-manager.d.ts.map

package/dist/i18n/i18n-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-manager.d.ts","sourceRoot":"","sources":["../../src/i18n/i18n-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EAIf,eAAe,EACf,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,UAAU;IACzB,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,YAAY,CAAoD;IACxE,OAAO,CAAC,aAAa,CAAmC;gBAE5C,MAAM,GAAE,UAAe;IAKnC;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxD;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD;;OAEG;IACH,SAAS,IAAI,eAAe;IAI5B;;OAEG;IACH,KAAK,IAAI,OAAO;IAIhB;;OAEG;IACH,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM;IA4BhE;;OAEG;IACH,sBAAsB,IAAI,mBAAmB;IAK7C;;OAEG;IACH,eAAe,IAAI,eAAe,GAAG,SAAS;IAI9C;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI5C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIrC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM;IAI5E;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM;IAIhF;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,eAAe;IAsC7D;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,WAAW;CAQpB;AAQD;;GAEG;AACH,wBAAgB,OAAO,IAAI,WAAW,CAKrC;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAO7E;AAED;;GAEG;AACH,wBAAgB,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAE/E"}