@mise-en-scene/server 0.1.0

package/README.md

@@ -0,0 +1,221 @@
+# @mise-en-scene/server
+
+Design studio MCP + HTTP server. Serves HTML designs in the browser with hot-reload, exports to SVG/PNG/JPG/PDF, manages design versions with branching, and provides typography intelligence.
+
+## MCP Tools
+
+### Core
+
+| Tool | Input | Description |
+|------|-------|-------------|
+| `studio_preview` | `html`, `filename?` | Write HTML+CSS+SVG to preview server, triggers hot-reload |
+| `studio_feedback` | — | Read user interaction feedback (click selections) |
+| `studio_screenshot` | `selector?` | Capture screenshot for self-critique (returns image) |
+| `studio_export` | `format`, `width?`, `height?`, `preset?`, `quality?` | Export to SVG, PNG, JPG, or PDF |
+
+### Versioning
+
+| Tool | Input | Description |
+|------|-------|-------------|
+| `studio_branch` | `name`, `from_branch?`, `from_version?` | Create a design branch |
+| `studio_checkout` | `branch`, `version?` | Switch to a branch or version |
+| `studio_gallery` | — | Open the version gallery in browser |
+
+### Typography
+
+| Tool | Input | Description |
+|------|-------|-------------|
+| `studio_font_suggest` | `mood`, `context?` | Get curated font pairing suggestions |
+| `studio_font_analyze_url` | `url` | Extract font stack from any website |
+| `studio_font_scale` | `base_size?`, `ratio?` | Generate a modular type scale |
+| `studio_font_embed` | `fonts[]` | Generate @font-face CSS with base64 woff2 |
+
+## Usage
+
+### As an MCP Server
+
+```json
+{
+  "mcpServers": {
+    "mise-en-scene-server": {
+      "command": "npx",
+      "args": ["@mise-en-scene/server"]
+    }
+  }
+}
+```
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MISE_PORT` | `3333` | HTTP server port |
+| `MISE_DESIGN_DIR` | `mise-en-scene/main` | Directory for design files |
+
+## Components
+
+### HTTP Server
+
+Zero-dependency HTTP server (no Express). Serves the newest `.html` file from the design directory with runtime injection — a `<script>` tag and `<link>` to the client-side runtime are added automatically.
+
+Routes:
+
+| Route | Description |
+|-------|-------------|
+| `GET /` | Serve newest HTML design with runtime injection |
+| `GET /gallery` | Version gallery with thumbnail grid |
+| `GET /mise-en-scene.js` | Client-side runtime |
+| `GET /styles.css` | Selection highlight styles |
+
+### WebSocket Server
+
+Real-time communication between the browser and the MCP server:
+
+- **Server → Browser**: `reload` (trigger page refresh), `highlight` (visual feedback)
+- **Browser → Server**: `select` (user clicked an element — captured as feedback)
+
+### File Watcher
+
+Uses chokidar to watch the design directory for `.html` file changes. Triggers WebSocket `reload` broadcast on new or modified files.
+
+### Export Pipeline
+
+Lazy-loads Puppeteer on first use. Supports four export formats:
+
+| Format | Engine | Notes |
+|--------|--------|-------|
+| SVG | SVGO | Extracts inline SVGs, optimizes with multipass |
+| PNG | Puppeteer | Full-page or selector-based capture |
+| JPG | Puppeteer | Configurable quality (1-100) |
+| PDF | Puppeteer | Configurable dimensions, print media |
+
+#### Dimension Presets
+
+13 built-in presets across three categories:
+
+**Social:**
+`instagram-post` (1080x1080), `instagram-story` (1080x1920), `twitter-post` (1200x675), `twitter-header` (1500x500), `facebook-post` (1200x630), `linkedin-post` (1200x627), `og-image` (1200x630)
+
+**Web:**
+`desktop-hd` (1920x1080), `desktop` (1440x900), `tablet` (768x1024), `mobile` (375x812)
+
+**Print:**
+`a4` (2480x3508 @ 300dpi), `letter` (2550x3300 @ 300dpi)
+
+### Screenshot
+
+Captures the current design state as a PNG image. Used by the agent for self-critique — screenshot the design, analyze it against the taste profile, fix issues before presenting to the user.
+
+```
+studio_screenshot()           → full page capture
+studio_screenshot("h1")       → capture specific element
+studio_screenshot(".header")  → capture by CSS selector
+```
+
+Returns image data as base64 in the MCP response (not written to disk).
+
+### Version Manager
+
+Git-inspired branching for design iterations:
+
+```
+studio_preview(html)              → saves as next version on current branch
+studio_branch("dark-theme")      → fork from current version
+studio_checkout("main", 2)       → switch to main/v2
+studio_gallery()                  → view all branches and versions
+```
+
+Versions are stored as flat HTML files (`v1.html`, `v2.html`, ...) organized by branch. Metadata is persisted in `meta.json`:
+
+```json
+{
+  "branches": {
+    "main": { "versions": [1, 2, 3] },
+    "dark-theme": { "forkedFrom": { "branch": "main", "version": 2 }, "versions": [1] }
+  },
+  "stars": [{ "branch": "main", "version": 2 }],
+  "current": { "branch": "main", "version": 3 }
+}
+```
+
+### Typography Intelligence
+
+#### Font Registry
+
+35+ fonts classified by category and subtype:
+
+| Category | Subtypes |
+|----------|----------|
+| Serif | old-style, transitional, modern, slab |
+| Sans-serif | grotesque, neo-grotesque, geometric, humanist |
+| Display | creative, bold, futuristic |
+| Monospace | technical, terminal |
+
+Each font entry includes `category`, `subtype`, `era`, and `mood` descriptors.
+
+#### Curated Pairings
+
+8 aesthetic presets with display + body font pairings, Google Fonts import URLs, and mood descriptions:
+
+| Aesthetic | Display | Body | Mood |
+|-----------|---------|------|------|
+| dark-premium | Fraunces | Outfit | Elegant, editorial |
+| clean-minimal | Satoshi | Satoshi | Confident, modern |
+| neobrutalism | Space Grotesk | Space Mono | Technical, raw |
+| editorial | Instrument Serif | Instrument Sans | Refined, readable |
+| y2k-cyber | Orbitron | JetBrains Mono | Sci-fi, technical |
+| warm-scandinavian | DM Serif Display | DM Sans | Approachable, refined |
+| creative-playful | Bricolage Grotesque | Bricolage Grotesque | Expressive, bold |
+| luxury | Playfair Display | Source Sans 3 | Classic, timeless |
+
+#### Font Suggestion Engine
+
+`studio_font_suggest(mood)` scores pairings against the mood query using token-based text similarity, filters out avoided fonts, and returns the top 3 matches.
+
+#### Type Scale Generator
+
+`studio_font_scale(base_size, ratio)` generates CSS custom properties for a modular type scale:
+
+| Ratio | Name | Use Case |
+|-------|------|----------|
+| 1.2 | Minor Third | Body-heavy, readability |
+| 1.25 | Major Third | General purpose |
+| 1.333 | Perfect Fourth | Balanced drama |
+| 1.618 | Golden Ratio | Posters, maximum drama |
+
+Produces 11 named steps (xs through 7xl) with size, line-height, and letter-spacing. Headlines get tighter line-height and tracking automatically.
+
+#### URL Font Analyzer
+
+`studio_font_analyze_url(url)` launches Puppeteer, navigates to the URL, and extracts computed font families, weights, and styles from common HTML elements.
+
+#### Font Embedder
+
+`studio_font_embed(fonts)` fetches woff2 files from URLs and returns `@font-face` CSS with base64-inlined font data — for self-contained SVG exports.
+
+## Feedback System
+
+User interactions in the browser are captured as JSON Lines in a `.feedback` file:
+
+```jsonl
+{"type":"select","element":{"tag":"h1","classes":["title"],"text":"Hello"},"timestamp":1710...}
+```
+
+The agent reads feedback via `studio_feedback`, interprets selections, and records design decisions in taste memory.
+
+## Client Runtime
+
+The browser runtime (`mise-en-scene.js`) provides:
+
+- **WebSocket connection** with auto-reconnect (2s backoff)
+- **Live reload** on design file changes
+- **Click-to-select** — clicking any element sends a `select` event to the server
+- **Visual feedback** — selected elements get a `.mise-selected` outline
+
+## Development
+
+```bash
+npm test                # Run tests (42 unit + 3 integration + 6 Puppeteer)
+npm run build           # Compile TypeScript
+npm run test:watch      # Watch mode
+```

package/dist/export/index.d.ts

@@ -0,0 +1,10 @@
+import { PuppeteerManager } from './puppeteer-manager.js';
+import type { ExportOptions } from '../types.js';
+export declare class ExportPipeline {
+    private puppeteer;
+    export(html: string, outputDir: string, opts: ExportOptions): Promise<string>;
+    screenshot(url: string, selector?: string): Promise<Buffer>;
+    getPuppeteerManager(): PuppeteerManager;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/export/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAA0B;IAErC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAkC7E,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjE,mBAAmB,IAAI,gBAAgB;IAEjC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAChC"}

package/dist/export/index.js

@@ -0,0 +1,53 @@
+import { PuppeteerManager } from './puppeteer-manager.js';
+import { extractAndOptimizeSvg } from './svg-export.js';
+import { exportRaster } from './raster-export.js';
+import { exportPdf } from './pdf-export.js';
+import { getPreset } from './presets.js';
+import fs from 'fs';
+import path from 'path';
+export class ExportPipeline {
+    puppeteer = new PuppeteerManager();
+    async export(html, outputDir, opts) {
+        fs.mkdirSync(outputDir, { recursive: true });
+        let width = opts.width;
+        let height = opts.height;
+        if (opts.preset) {
+            const preset = getPreset(opts.preset);
+            if (preset) {
+                width = width ?? preset.width;
+                height = height ?? preset.height;
+            }
+        }
+        const timestamp = Date.now();
+        switch (opts.format) {
+            case 'svg': {
+                const svg = await extractAndOptimizeSvg(html);
+                const outPath = path.join(outputDir, `export-${timestamp}.svg`);
+                fs.writeFileSync(outPath, svg);
+                return outPath;
+            }
+            case 'png':
+            case 'jpg': {
+                const buffer = await exportRaster(this.puppeteer, html, { format: opts.format, width, height, quality: opts.quality, dpi: opts.dpi });
+                const ext = opts.format === 'jpg' ? 'jpg' : 'png';
+                const outPath = path.join(outputDir, `export-${timestamp}.${ext}`);
+                fs.writeFileSync(outPath, buffer);
+                return outPath;
+            }
+            case 'pdf': {
+                const buffer = await exportPdf(this.puppeteer, html, { width, height });
+                const outPath = path.join(outputDir, `export-${timestamp}.pdf`);
+                fs.writeFileSync(outPath, buffer);
+                return outPath;
+            }
+            default: throw new Error(`Unsupported format: ${opts.format}`);
+        }
+    }
+    async screenshot(url, selector) {
+        const { takeScreenshot } = await import('../screenshot.js');
+        return takeScreenshot(this.puppeteer, url, { selector });
+    }
+    getPuppeteerManager() { return this.puppeteer; }
+    async shutdown() { await this.puppeteer.shutdown(); }
+}
+//# sourceMappingURL=index.js.map

package/dist/export/index.js.map

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

package/dist/export/pdf-export.d.ts

@@ -0,0 +1,8 @@
+import type { PuppeteerManager } from './puppeteer-manager.js';
+interface PdfOptions {
+    width?: number;
+    height?: number;
+}
+export declare function exportPdf(manager: PuppeteerManager, html: string, opts?: PdfOptions): Promise<Buffer>;
+export {};
+//# sourceMappingURL=pdf-export.d.ts.map

package/dist/export/pdf-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-export.d.ts","sourceRoot":"","sources":["../../src/export/pdf-export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,UAAU,UAAU;IAAG,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAAE;AAEzD,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAc3G"}

package/dist/export/pdf-export.js

@@ -0,0 +1,17 @@
+export async function exportPdf(manager, html, opts) {
+    const page = await manager.getPage();
+    try {
+        await page.setContent(html, { waitUntil: 'networkidle0', timeout: 10000 });
+        const buffer = await page.pdf({
+            width: opts?.width ? `${opts.width}px` : undefined,
+            height: opts?.height ? `${opts.height}px` : undefined,
+            printBackground: true,
+            margin: { top: 0, right: 0, bottom: 0, left: 0 },
+        });
+        return Buffer.from(buffer);
+    }
+    finally {
+        await page.close();
+    }
+}
+//# sourceMappingURL=pdf-export.js.map

package/dist/export/pdf-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-export.js","sourceRoot":"","sources":["../../src/export/pdf-export.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAyB,EAAE,IAAY,EAAE,IAAiB;IACxF,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC;YAC5B,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS;YAClD,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,SAAS;YACrD,eAAe,EAAE,IAAI;YACrB,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;SACjD,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/export/presets.d.ts

@@ -0,0 +1,4 @@
+import type { DimensionPreset } from '../types.js';
+export declare function getPreset(name: string): DimensionPreset | null;
+export declare function listPresets(): DimensionPreset[];
+//# sourceMappingURL=presets.d.ts.map

package/dist/export/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/export/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAkBnD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAE9D;AAED,wBAAgB,WAAW,IAAI,eAAe,EAAE,CAE/C"}

package/dist/export/presets.js

@@ -0,0 +1,22 @@
+const PRESETS = {
+    'instagram-post': { name: 'Instagram Post', width: 1080, height: 1080, category: 'social' },
+    'instagram-story': { name: 'Instagram Story', width: 1080, height: 1920, category: 'social' },
+    'twitter-header': { name: 'Twitter Header', width: 1500, height: 500, category: 'social' },
+    'twitter-post': { name: 'Twitter Post', width: 1200, height: 675, category: 'social' },
+    'facebook-cover': { name: 'Facebook Cover', width: 1640, height: 624, category: 'social' },
+    'linkedin-banner': { name: 'LinkedIn Banner', width: 1584, height: 396, category: 'social' },
+    'og-image': { name: 'OG Image', width: 1200, height: 630, category: 'web' },
+    'favicon': { name: 'Favicon', width: 512, height: 512, category: 'web' },
+    'hd': { name: 'HD 1080p', width: 1920, height: 1080, category: 'web' },
+    'a4': { name: 'A4 (300dpi)', width: 2480, height: 3508, category: 'print' },
+    'letter': { name: 'US Letter (300dpi)', width: 2550, height: 3300, category: 'print' },
+    'poster-18x24': { name: 'Poster 18×24 (150dpi)', width: 2700, height: 3600, category: 'print' },
+    'business-card': { name: 'Business Card (300dpi)', width: 1050, height: 600, category: 'print' },
+};
+export function getPreset(name) {
+    return PRESETS[name] ?? null;
+}
+export function listPresets() {
+    return Object.values(PRESETS);
+}
+//# sourceMappingURL=presets.js.map

package/dist/export/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/export/presets.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAoC;IAC/C,gBAAgB,EAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC9F,iBAAiB,EAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC/F,gBAAgB,EAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC7F,cAAc,EAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC3F,gBAAgB,EAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC7F,iBAAiB,EAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC9F,UAAU,EAAW,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE;IACpF,SAAS,EAAY,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE;IAClF,IAAI,EAAiB,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;IACrF,IAAI,EAAiB,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE;IAC1F,QAAQ,EAAa,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE;IACjG,cAAc,EAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE;IACpG,eAAe,EAAM,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE;CACrG,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/export/puppeteer-manager.d.ts

@@ -0,0 +1,8 @@
+import { type Page } from 'puppeteer';
+export declare class PuppeteerManager {
+    private browser;
+    isRunning(): boolean;
+    getPage(): Promise<Page>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=puppeteer-manager.d.ts.map

package/dist/export/puppeteer-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer-manager.d.ts","sourceRoot":"","sources":["../../src/export/puppeteer-manager.ts"],"names":[],"mappings":"AAAA,OAAkB,EAAgB,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAE/D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAwB;IAEvC,SAAS,IAAI,OAAO;IAId,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAUxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAMhC"}

package/dist/export/puppeteer-manager.js

@@ -0,0 +1,23 @@
+import puppeteer from 'puppeteer';
+export class PuppeteerManager {
+    browser = null;
+    isRunning() {
+        return this.browser !== null && this.browser.connected;
+    }
+    async getPage() {
+        if (!this.browser || !this.browser.connected) {
+            this.browser = await puppeteer.launch({
+                headless: true,
+                args: ['--no-sandbox', '--disable-setuid-sandbox'],
+            });
+        }
+        return this.browser.newPage();
+    }
+    async shutdown() {
+        if (this.browser) {
+            await this.browser.close();
+            this.browser = null;
+        }
+    }
+}
+//# sourceMappingURL=puppeteer-manager.js.map

package/dist/export/puppeteer-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer-manager.js","sourceRoot":"","sources":["../../src/export/puppeteer-manager.ts"],"names":[],"mappings":"AAAA,OAAO,SAAsC,MAAM,WAAW,CAAC;AAE/D,MAAM,OAAO,gBAAgB;IACnB,OAAO,GAAmB,IAAI,CAAC;IAEvC,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAC7C,IAAI,CAAC,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC;gBACpC,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,CAAC,cAAc,EAAE,0BAA0B,CAAC;aACnD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;CACF"}

package/dist/export/raster-export.d.ts

@@ -0,0 +1,11 @@
+import type { PuppeteerManager } from './puppeteer-manager.js';
+interface RasterOptions {
+    format: 'png' | 'jpg';
+    width?: number;
+    height?: number;
+    quality?: number;
+    dpi?: number;
+}
+export declare function exportRaster(manager: PuppeteerManager, html: string, opts: RasterOptions): Promise<Buffer>;
+export {};
+//# sourceMappingURL=raster-export.d.ts.map

package/dist/export/raster-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster-export.d.ts","sourceRoot":"","sources":["../../src/export/raster-export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,UAAU,aAAa;IACrB,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBhH"}

package/dist/export/raster-export.js

@@ -0,0 +1,22 @@
+export async function exportRaster(manager, html, opts) {
+    const page = await manager.getPage();
+    try {
+        const width = opts.width ?? 1200;
+        const height = opts.height ?? 800;
+        await page.setViewport({ width, height, deviceScaleFactor: opts.dpi ?? 1 });
+        await page.setContent(html, { waitUntil: 'networkidle0', timeout: 10000 });
+        const screenshotOpts = {
+            type: opts.format === 'jpg' ? 'jpeg' : 'png',
+            fullPage: false,
+            clip: { x: 0, y: 0, width, height },
+        };
+        if (opts.format === 'jpg' && opts.quality)
+            screenshotOpts.quality = opts.quality;
+        const buffer = await page.screenshot(screenshotOpts);
+        return Buffer.from(buffer);
+    }
+    finally {
+        await page.close();
+    }
+}
+//# sourceMappingURL=raster-export.js.map

package/dist/export/raster-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster-export.js","sourceRoot":"","sources":["../../src/export/raster-export.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAyB,EAAE,IAAY,EAAE,IAAmB;IAC7F,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;QAClC,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5E,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3E,MAAM,cAAc,GAAQ;YAC1B,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK;YAC5C,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE;SACpC,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO;YAAE,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QACjF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/export/svg-export.d.ts

@@ -0,0 +1,2 @@
+export declare function extractAndOptimizeSvg(html: string): Promise<string>;
+//# sourceMappingURL=svg-export.d.ts.map

package/dist/export/svg-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-export.d.ts","sourceRoot":"","sources":["../../src/export/svg-export.ts"],"names":[],"mappings":"AAEA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBzE"}

package/dist/export/svg-export.js

@@ -0,0 +1,24 @@
+import { optimize } from 'svgo';
+export async function extractAndOptimizeSvg(html) {
+    const svgMatch = html.match(/<svg[\s\S]*?<\/svg>/i);
+    if (!svgMatch)
+        throw new Error('No SVG element found in the provided HTML');
+    const rawSvg = svgMatch[0];
+    const result = optimize(rawSvg, {
+        multipass: true,
+        plugins: [
+            'removeDoctype', 'removeXMLProcInst', 'removeComments', 'removeMetadata',
+            'removeEditorsNSData', 'cleanupAttrs', 'mergeStyles', 'inlineStyles',
+            'minifyStyles', 'cleanupIds', 'removeUselessDefs', 'cleanupNumericValues',
+            'convertColors', 'removeUnknownsAndDefaults', 'removeNonInheritableGroupAttrs',
+            'removeUselessStrokeAndFill', 'cleanupEnableBackground', 'removeHiddenElems',
+            'removeEmptyText', 'convertShapeToPath', 'convertEllipseToCircle',
+            'moveElemsAttrsToGroup', 'moveGroupAttrsToElems', 'collapseGroups',
+            'convertPathData', 'convertTransform', 'removeEmptyAttrs',
+            'removeEmptyContainers', 'removeDimensions', 'removeStyleElement',
+            'removeScriptElement', 'sortAttrs', 'sortDefsChildren',
+        ],
+    });
+    return result.data;
+}
+//# sourceMappingURL=svg-export.js.map

package/dist/export/svg-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-export.js","sourceRoot":"","sources":["../../src/export/svg-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACpD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE;QAC9B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE;YACP,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB;YACxE,qBAAqB,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc;YACpE,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,sBAAsB;YACzE,eAAe,EAAE,2BAA2B,EAAE,gCAAgC;YAC9E,4BAA4B,EAAE,yBAAyB,EAAE,mBAAmB;YAC5E,iBAAiB,EAAE,oBAAoB,EAAE,wBAAwB;YACjE,uBAAuB,EAAE,uBAAuB,EAAE,gBAAgB;YAClE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB;YACzD,uBAAuB,EAAE,kBAAkB,EAAE,oBAAoB;YACjE,qBAAqB,EAAE,WAAW,EAAE,kBAAkB;SACvD;KACF,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/feedback.d.ts

@@ -0,0 +1,4 @@
+import type { FeedbackEvent } from './types.js';
+export declare function readFeedback(designDir: string): FeedbackEvent[];
+export declare function appendFeedback(designDir: string, event: Record<string, unknown>): void;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAQ/D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAGtF"}

package/dist/feedback.js

@@ -0,0 +1,23 @@
+import fs from 'fs';
+import path from 'path';
+export function readFeedback(designDir) {
+    const feedbackPath = path.join(designDir, '.feedback');
+    if (!fs.existsSync(feedbackPath))
+        return [];
+    const content = fs.readFileSync(feedbackPath, 'utf-8').trim();
+    if (!content)
+        return [];
+    return content.split('\n').filter((line) => line.trim()).map((line) => {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            return null;
+        }
+    }).filter(Boolean);
+}
+export function appendFeedback(designDir, event) {
+    fs.mkdirSync(designDir, { recursive: true });
+    fs.appendFileSync(path.join(designDir, '.feedback'), JSON.stringify(event) + '\n');
+}
+//# sourceMappingURL=feedback.js.map

package/dist/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACpE,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IACzD,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAoB,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,KAA8B;IAC9E,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACrF,CAAC"}

package/dist/http-server.d.ts

@@ -0,0 +1,15 @@
+import http from 'http';
+interface ServerOptions {
+    port: number;
+    designDir: string;
+    host?: string;
+}
+interface ServerInstance {
+    port: number;
+    server: http.Server;
+    close: () => Promise<void>;
+}
+export declare function getNewestHtmlFile(dir: string): string | null;
+export declare function createHttpServer(opts: ServerOptions): Promise<ServerInstance>;
+export {};
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAMxB,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW5D;AA4BD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAwEnF"}