mewkit 1.14.1 → 1.16.0

package/dist/visual-plan/server/visual-plan-server.js

@@ -0,0 +1,79 @@
+/**
+ * Visual Plan studio server — a domain-specific loopback server built ENTIRELY
+ * from the domain-neutral `local-web` primitives (Phase 2). It owns only its
+ * routes + CSP; the loopback bind, Host guard, port fallback, static traversal
+ * guard, and graceful stop all come from `local-web`.
+ *
+ * Routes:
+ *   GET   /api/visual-plan            → artifact JSON + ETag
+ *   PATCH /api/visual-plan            → typed visual patch (If-Match required)
+ *   POST  /api/visual-plan/feedback   → freeze an immutable feedback batch
+ *   GET   /api/visual-plan/feedback/:id → read a batch
+ *   *                                 → static bundle (dist/visual-plan-web)
+ */
+import { LocalServer } from "../../local-web/local-server.js";
+import { serveStatic } from "../../local-web/static-handler.js";
+import { LOOPBACK_HOST } from "../../local-web/constants.js";
+import { SECURITY_HEADERS } from "./csp.js";
+import { handleGetPlan, writeJson } from "./routes/get-plan.js";
+import { handlePatch } from "./routes/patch.js";
+import { handlePostFeedback, handleGetFeedback } from "./routes/feedback.js";
+export class VisualPlanServer {
+    server;
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+        this.server = new LocalServer({
+            port: opts.port,
+            verbose: opts.verbose,
+            handler: (req, res) => this.route(req, res),
+        });
+    }
+    get port() {
+        return this.server.port;
+    }
+    get url() {
+        return this.server.url;
+    }
+    start() {
+        return this.server.start();
+    }
+    stop() {
+        return this.server.stop();
+    }
+    route(req, res) {
+        // CSP + baseline security headers on EVERY response (setHeader persists
+        // through the static handler's own writeHead, which never sets these).
+        for (const [k, v] of Object.entries(SECURITY_HEADERS))
+            res.setHeader(k, v);
+        const pathname = new URL(req.url ?? "/", `http://${LOOPBACK_HOST}:${this.server.port}`).pathname;
+        const planDir = this.opts.planDir;
+        const FEEDBACK = "/api/visual-plan/feedback";
+        if (pathname === "/api/visual-plan") {
+            if (req.method === "GET" || req.method === "HEAD")
+                handleGetPlan(res, planDir);
+            else if (req.method === "PATCH")
+                void handlePatch(req, res, planDir);
+            else
+                writeJson(res, 405, { error: "method-not-allowed" });
+            return;
+        }
+        if (pathname === FEEDBACK) {
+            if (req.method === "POST")
+                void handlePostFeedback(req, res, planDir);
+            else
+                writeJson(res, 405, { error: "method-not-allowed" });
+            return;
+        }
+        if (pathname.startsWith(`${FEEDBACK}/`)) {
+            const id = pathname.slice(FEEDBACK.length + 1);
+            if (req.method === "GET")
+                handleGetFeedback(res, planDir, id);
+            else
+                writeJson(res, 405, { error: "method-not-allowed" });
+            return;
+        }
+        serveStatic(req, res, this.opts.bundleDir);
+    }
+}
+//# sourceMappingURL=visual-plan-server.js.map

package/dist/visual-plan/server/visual-plan-server.js.map

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

package/dist/visual-plan-web/index.css

@@ -0,0 +1 @@
+@font-face{font-family:Architects Daughter;font-style:normal;font-display:swap;font-weight:400;src:url(/architects-daughter-latin-ext-400-normal.woff2) format("woff2"),url(/architects-daughter-latin-ext-400-normal.woff) format("woff");unicode-range:U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}@font-face{font-family:Architects Daughter;font-style:normal;font-display:swap;font-weight:400;src:url(/architects-daughter-latin-400-normal.woff2) format("woff2"),url(/architects-daughter-latin-400-normal.woff) format("woff");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}:root{--vp-bg: #f4f5f7;--vp-surface: #ffffff;--vp-border: #d7dbe0;--vp-text: #1c2430;--vp-muted: #64707d;--vp-accent: #3563e9;--wf-bg: #ffffff;--wf-fg: #1c2430;--wf-line: #d7dbe0;--wf-muted: #eef1f4}@media(prefers-color-scheme:dark){:root{--vp-bg: #0b0e13;--vp-surface: #141a22;--vp-border: #263041;--vp-text: #e8edf3;--vp-muted: #93a1b0;--vp-accent: #6f97ff;--wf-bg: #161d27;--wf-fg: #e8edf3;--wf-line: #2b3648;--wf-muted: #1e2733}}*{box-sizing:border-box}html,body,#root{height:100%;margin:0}body{font-family:system-ui,-apple-system,Segoe UI,sans-serif;background:var(--vp-bg);color:var(--vp-text)}.vp-app{display:flex;flex-direction:column;height:100%}.vp-loading,.vp-error{padding:2rem;color:var(--vp-muted)}.vp-error{color:#c0392b}.vp-toolbar{display:flex;align-items:center;gap:.75rem;padding:.5rem 1rem;background:var(--vp-surface);border-bottom:1px solid var(--vp-border)}.vp-toolbar-title{font-weight:600}.vp-toolbar-meta{color:var(--vp-muted);font-size:.85rem}.vp-error-banner{font-size:.75rem;color:#fff;background:#c0392b;padding:.1rem .6rem;border-radius:6px}.vp-save-status{font-size:.75rem;color:var(--vp-muted);padding:.1rem .5rem;border-radius:999px;border:1px solid var(--vp-border)}.vp-save-status[data-state=saving]{color:var(--vp-accent)}.vp-save-status[data-state=stale],.vp-save-status[data-state=error]{color:#c0392b;border-color:#c0392b}.vp-mode-toggle{font-size:.78rem;padding:.15rem .6rem;border:1px solid var(--vp-border);border-radius:6px;background:var(--vp-surface);color:var(--vp-text);cursor:pointer}.vp-toolbar-review{margin-left:auto;font-size:.8rem;padding:.1rem .5rem;border-radius:999px;border:1px solid var(--vp-border)}.vp-sketch .vp-artboard-title,.vp-sketch .wf-root{font-family:Architects Daughter,Comic Sans MS,cursive}.vp-sketch .vp-artboard{border-color:transparent}.vp-toolbar-review[data-status=approved]{color:#1f8a4c;border-color:#1f8a4c}.vp-body{display:grid;grid-template-columns:1fr 260px 260px;flex:1;min-height:0}.vp-viewport{position:relative;overflow:hidden;background:var(--vp-bg);outline:none}.vp-world{position:absolute;top:0;left:0}@media(prefers-reduced-motion:no-preference){.vp-world{transition:transform 80ms ease-out}}.vp-lane{border:1px dashed var(--vp-border);border-radius:12px;background:color-mix(in srgb,var(--vp-surface) 40%,transparent)}.vp-lane-label{font-size:.75rem;color:var(--vp-muted);padding:.4rem .7rem;text-transform:uppercase;letter-spacing:.04em}.vp-artboard{border:1px solid var(--vp-border);border-radius:10px;background:var(--vp-surface);overflow:hidden;cursor:pointer;box-shadow:0 1px 3px #00000014}.vp-artboard.is-selected{outline:2px solid var(--vp-accent)}.vp-artboard-header{display:flex;align-items:center;justify-content:space-between;padding:.35rem .6rem;border-bottom:1px solid var(--vp-border);font-size:.8rem}.vp-artboard-surface{font-size:.7rem;color:var(--vp-muted)}.vp-artboard-surface[data-change=target]{color:var(--vp-accent)}.vp-artboard-body{overflow:hidden;background:var(--wf-bg)}.vp-zoom-controls{position:absolute;bottom:12px;right:12px;display:flex;gap:4px;align-items:center;background:var(--vp-surface);border:1px solid var(--vp-border);border-radius:8px;padding:2px 6px}.vp-zoom-controls button{border:none;background:transparent;color:var(--vp-text);cursor:pointer;font-size:.9rem;padding:2px 6px}.vp-zoom-level{font-size:.75rem;color:var(--vp-muted);min-width:40px;text-align:center}.vp-side{border-left:1px solid var(--vp-border);background:var(--vp-surface);overflow-y:auto;display:flex;flex-direction:column}.vp-edit-controls{padding:.5rem .75rem;border-top:1px solid var(--vp-border);display:flex;gap:10px;flex-wrap:wrap}.vp-edit-field{display:flex;flex-direction:column;font-size:.72rem;color:var(--vp-muted);gap:2px}.vp-edit-field select,.vp-edit-field input{font-size:.8rem;padding:2px 4px;border:1px solid var(--vp-border);border-radius:4px;background:var(--vp-bg);color:var(--vp-text)}.vp-feedback{padding:.75rem;border-top:1px solid var(--vp-border);display:flex;flex-direction:column;gap:6px}.vp-feedback-ops{list-style:none;margin:0;padding:0;font-size:.78rem;display:flex;flex-direction:column;gap:2px}.vp-fb-type{color:var(--vp-muted);font-size:.7rem}.vp-feedback select,.vp-feedback textarea{font-size:.8rem;border:1px solid var(--vp-border);border-radius:4px;background:var(--vp-bg);color:var(--vp-text);padding:4px}.vp-feedback textarea{min-height:48px;resize:vertical}.vp-fb-hint{font-size:.72rem;color:#c0392b;margin:0}.vp-copy-command{display:flex;flex-direction:column;gap:4px;background:var(--vp-bg);border:1px solid var(--vp-border);border-radius:6px;padding:6px}.vp-copy-command code{font-size:.72rem;word-break:break-all}.vp-coverage-panel,.vp-inspector{background:var(--vp-surface);padding:.75rem}.vp-coverage-panel{border-left:1px solid var(--vp-border);overflow-y:auto}.vp-panel-title{font-size:.9rem;margin:0 0 .5rem}.vp-coverage-summary{display:flex;flex-wrap:wrap;gap:4px;margin-bottom:.6rem}.vp-cov-chip{font-size:.7rem;padding:.1rem .4rem;border-radius:999px;border:1px solid var(--vp-border)}.vp-cov-chip[data-mode=unresolved]{color:#c0392b;border-color:#c0392b}.vp-cov-chip[data-mode=resolved]{color:#1f8a4c}.vp-coverage-list{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:2px}.vp-coverage-row{display:flex;gap:6px;font-size:.78rem;padding:.2rem .3rem;border-radius:6px}.vp-coverage-row[data-mode=unresolved]{background:color-mix(in srgb,#c0392b 12%,transparent)}.vp-cov-surface{color:var(--vp-muted);margin-left:auto}.vp-inspector-fields{display:grid;grid-template-columns:auto 1fr;gap:4px 10px;font-size:.8rem;margin:0}.vp-inspector-fields dt{color:var(--vp-muted)}.vp-inspector-refs{margin:0;padding-left:1rem}.vp-inspector-empty{color:var(--vp-muted);font-size:.85rem}.vp-connector-path{stroke:var(--vp-muted);stroke-width:2}.vp-connector-arrow{fill:var(--vp-muted)}.vp-connector-label{fill:var(--vp-muted);font-size:11px;paint-order:stroke;stroke:var(--vp-bg);stroke-width:3px}.vp-annotation-layer{position:absolute;top:0;left:0}.vp-note{background:color-mix(in srgb,#f4c542 22%,var(--vp-surface));border:1px solid color-mix(in srgb,#f4c542 55%,var(--vp-border));border-radius:8px;padding:6px 8px;font-size:12px;color:var(--vp-text);box-shadow:0 1px 2px #00000014}.vp-markup{color:#c0392b;font-size:12px;font-weight:600}.wf-root{color:var(--wf-fg);font:14px/1.4 system-ui,sans-serif;padding:12px}.wf-root .wf-screen{display:flex;flex-direction:column;gap:10px}.wf-root .wf-topbar{border-bottom:1px solid var(--wf-line);padding-bottom:6px}.wf-root h1,.wf-root h2,.wf-root h3{margin:0}.wf-root .wf-form{display:flex;flex-direction:column;gap:6px}.wf-root .wf-input{height:32px;border:1px solid var(--wf-line);border-radius:6px;background:var(--wf-muted)}.wf-root .wf-button{display:inline-block;padding:8px 14px;background:var(--vp-accent);color:#fff;border-radius:6px;text-align:center;text-decoration:none}.wf-root .wf-error{color:#c0392b}.wf-root .wf-list{padding-left:1.1rem;margin:0}.wf-root a{color:var(--vp-accent)}

package/dist/visual-plan-web/index.html

@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<meta name="viewport" content="width=device-width, initial-scale=1" />
+		<meta
+			http-equiv="Content-Security-Policy"
+			content="default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; connect-src 'self';"
+		/>
+		<title>meowkit visual-plan</title>
+		<script type="module" crossorigin src="/index.js"></script>
+		<link rel="stylesheet" crossorigin href="/index.css">
+	</head>
+	<body>
+		<div id="root"></div>
+	</body>
+</html>