@weave-framework/cli 0.2.53 → 0.2.162

package/README.md

@@ -0,0 +1,21 @@
+# @weave-framework/cli
+
+The Weave CLI — `weave build`, `weave dev` (watch + live-reload), `weave check`, `weave routes`.
+
+Part of **[Weave](https://weaveframework.dev/)** — a fine-grained reactive, signal-native UI framework: no Virtual DOM, zero third-party runtime dependencies.
+
+```bash
+npm install -D @weave-framework/cli
+```
+
+Scaffolded apps already include it (with scripts wired up):
+
+```bash
+npm create weave@latest my-app
+```
+
+📚 **Guides + full API reference:** [weaveframework.dev](https://weaveframework.dev/)
+
+## License
+
+MIT

package/bin/weave.mjs

@@ -23,6 +23,9 @@ await esbuild({
   bundle: true,
   format: 'esm',
   platform: 'node',
+  // NB: @weave-framework/mcp stays INLINED in the dev bin (unlike the prod build, which
+  // externalizes it) — the dev bundle runs from node_modules/.weave/, whose module
+  // resolution can't reach the workspace-linked package, so we bundle it in.
   external: ['esbuild', 'typescript', 'sass'],
   outfile: out,
 });

package/dist/cli.js

@@ -507,6 +507,9 @@ var Parser = class {
     if (rawName.startsWith("class:")) {
       return { type: "class", name: rawName.slice(6), expr: exprOf(), offset };
     }
+    if (rawName.startsWith("style:")) {
+      return { type: "style", name: rawName.slice(6), expr: exprOf(), offset };
+    }
     if (rawName.startsWith("bind:")) {
       return { type: "bind", name: rawName.slice(5), expr: exprOf(), offset };
     }
@@ -741,10 +744,11 @@ function rewrite(expr, scope, ctxRef = "ctx") {
       const name = expr.slice(i, j);
       const isProperty = lastNonSpace(out) === ".";
       const binding = scope.get(name);
-      if (binding && !isProperty) {
+      const prev = lastNonSpace(out);
+      const next = firstNonSpaceFrom(expr, j);
+      const isObjectKey = (prev === "{" || prev === ",") && next === ":";
+      if (binding && !isProperty && !isObjectKey) {
         if (binding.kind !== "local") {
-          const prev = lastNonSpace(out);
-          const next = firstNonSpaceFrom(expr, j);
           if ((prev === "{" || prev === ",") && (next === "," || next === "}")) insert(`${name}: `);
         }
         if (binding.kind === "ctx") {
@@ -943,8 +947,11 @@ function freeIdentifiers(expr) {
       let j = i + 1;
       while (j < n && ID_CHAR.test(expr[j])) j++;
       const name = expr.slice(i, j);
-      const isProperty = lastNonSpace(expr.slice(0, i)) === ".";
-      if (!isProperty && !NON_CTX.has(name) && !params.has(name)) out.add(name);
+      const prev = lastNonSpace(expr.slice(0, i));
+      const next = firstNonSpaceFrom(expr, j);
+      const isProperty = prev === ".";
+      const isObjectKey = (prev === "{" || prev === ",") && next === ":";
+      if (!isProperty && !isObjectKey && !NON_CTX.has(name) && !params.has(name)) out.add(name);
       i = j;
       continue;
     }
@@ -978,6 +985,8 @@ var Gen = class {
   // @weave-framework/runtime/dom helpers
   usedCore = /* @__PURE__ */ new Set();
   // @weave-framework/runtime primitives (computed, …)
+  usedComponents = /* @__PURE__ */ new Set();
+  // PascalCase child tags referenced in module mode
   templates = [];
   tplN = 0;
   fnN = 0;
@@ -989,13 +998,19 @@ var Gen = class {
     this.usedCore.add(name);
     return this.mode === "function" ? `rt.${name}` : name;
   }
-  /** Reference a child component: from the `_c` map in function mode, bare (imported) in module mode. */
+  /**
+   * Reference a child component: from the `_c` map in function mode, bare (imported)
+   * in module mode. In module mode the bare identifier must be in the emitted module's
+   * scope — the loader resolves each recorded tag to a real `import` (see the plugin's
+   * child-import injection), or the component's own `<script>` imports it explicitly.
+   */
   Comp(name) {
+    this.usedComponents.add(name);
     return this.mode === "function" ? `_c.${name}` : name;
   }
-  tpl(html) {
+  tpl(html, svg = false) {
     const v = `_t${this.tplN++}`;
-    this.templates.push(`const ${v} = ${this.H("template")}(${JSON.stringify(html)});`);
+    this.templates.push(`const ${v} = ${this.H(svg ? "templateSvg" : "template")}(${JSON.stringify(html)});`);
     return v;
   }
   fn(prefix = "_b") {
@@ -1008,15 +1023,79 @@ function compileTemplate(input, options = {}) {
   const gen = new Gen(mode, options.scopeAttr, options.hostAttr);
   const ast = parseTemplate(input);
   const render = compileFragment(gen, ast, ctxScope(options.scope ?? []), "render", "ctx, slots", true);
+  const components = [...gen.usedComponents];
   if (mode === "function") {
     const body = [...gen.templates, render, "return render(ctx, {});"].join("\n");
-    return { code: body };
+    return { code: body, components };
   }
   const domImport = `import { ${[...gen.used].sort().join(", ")} } from ${JSON.stringify(runtimeImport)};`;
   const coreImport = gen.usedCore.size ? `import { ${[...gen.usedCore].sort().join(", ")} } from "@weave-framework/runtime";
 ` : "";
   const code = [domImport + "\n" + coreImport, ...gen.templates, `export default ${render}`].join("\n");
-  return { code };
+  return { code, components };
+}
+var SVG_TAGS = /* @__PURE__ */ new Set([
+  "path",
+  "rect",
+  "circle",
+  "ellipse",
+  "line",
+  "polyline",
+  "polygon",
+  "g",
+  "defs",
+  "use",
+  "symbol",
+  "marker",
+  "mask",
+  "pattern",
+  "clipPath",
+  "linearGradient",
+  "radialGradient",
+  "stop",
+  "image",
+  "foreignObject",
+  "text",
+  "tspan",
+  "textPath",
+  "desc",
+  "view",
+  "filter",
+  "feBlend",
+  "feColorMatrix",
+  "feComponentTransfer",
+  "feComposite",
+  "feConvolveMatrix",
+  "feDiffuseLighting",
+  "feDisplacementMap",
+  "feDropShadow",
+  "feFlood",
+  "feFuncA",
+  "feFuncB",
+  "feFuncG",
+  "feFuncR",
+  "feGaussianBlur",
+  "feImage",
+  "feMerge",
+  "feMergeNode",
+  "feMorphology",
+  "feOffset",
+  "feSpecularLighting",
+  "feTile",
+  "feTurbulence",
+  "animate",
+  "animateMotion",
+  "animateTransform",
+  "mpath",
+  "set"
+]);
+var TRANSITION_PHASES = /* @__PURE__ */ new Set(["enterstart", "enterend", "leavestart", "leaveend"]);
+function pascalToKebab(tag) {
+  return tag.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2").toLowerCase();
+}
+function childImportCandidates(tag) {
+  const k = pascalToKebab(tag);
+  return [`../${k}/${k}`, `./${k}`, `./${k}/${k}`];
 }
 function compileFragment(gen, nodes, scope, name, param = "", isHost = false) {
   const top = trimTop(nodes);
@@ -1180,6 +1259,9 @@ function compileFragment(gen, nodes, scope, name, param = "", isHost = false) {
       case "class":
         sink.push(`${gen.H("bindClass")}(${n}, ${q(attr.name)}, () => ${rewrite(attr.expr, sc).code});`);
         break;
+      case "style":
+        sink.push(`${gen.H("bindStyleProp")}(${n}, ${q(attr.name)}, () => ${rewrite(attr.expr, sc).code});`);
+        break;
       case "show":
         sink.push(`${gen.H("bindShow")}(${n}, () => ${rewrite(attr.expr, sc).code});`);
         break;
@@ -1190,6 +1272,10 @@ function compileFragment(gen, nodes, scope, name, param = "", isHost = false) {
         break;
       }
       case "event": {
+        if (TRANSITION_PHASES.has(attr.name)) {
+          sink.push(`${gen.H("transitionEvent")}(${n}, ${q(attr.name)}, ${rewrite(attr.expr, sc).code});`);
+          break;
+        }
         const handler = wrapHandler(attr, sc);
         const opts = eventOpts(attr.modifiers);
         sink.push(`${gen.H("listen")}(${n}, ${q(attr.name)}, ${handler}${opts ? `, ${opts}` : ""});`);
@@ -1201,7 +1287,7 @@ function compileFragment(gen, nodes, scope, name, param = "", isHost = false) {
       case "use": {
         const action = rewrite(attr.name, sc).code;
         sink.push(
-          attr.expr !== void 0 ? `${gen.H("applyAction")}(${n}, ${action}, ${rewrite(attr.expr, sc).code});` : `${gen.H("applyAction")}(${n}, ${action});`
+          attr.expr !== void 0 ? `${gen.H("applyAction")}(${n}, ${action}, () => ${rewrite(attr.expr, sc).code});` : `${gen.H("applyAction")}(${n}, ${action});`
         );
         break;
       }
@@ -1384,8 +1470,10 @@ function compileFragment(gen, nodes, scope, name, param = "", isHost = false) {
   }
   if (singleRoot) emitElement(sole, [], scope, isHost);
   else emitChildren(top, [], scope, isHost);
+  const topEls = top.filter((n) => n.type === "element");
+  const svgRoot = topEls.length > 0 && SVG_TAGS.has(topEls[0].tag);
   const ctor = singleRoot ? gen.H("clone") : gen.H("cloneFragment");
-  const tplVar = gen.tpl(html);
+  const tplVar = gen.tpl(html, svgRoot);
   const body = [
     `const _r = ${ctor}(${tplVar});`,
     ...nodeDecls,
@@ -1852,7 +1940,7 @@ function compileComponent(src, opts = {}) {
     renderBody,
     `export default defineComponent(${setupArg});`
   ].filter(Boolean).join("\n\n");
-  return { code, css, hash };
+  return { code, css, hash, components: compiled.components };
 }
 function parseSfcLoc(source) {
   const script = locateBlock(source, "script");
@@ -1916,7 +2004,7 @@ function extractBlock(source, tag) {
 }
 
 // packages/compiler/src/sources.ts
-var DECL = /export\s+const\s+(template|styles)\s*(?::[^=]+)?=\s*/g;
+var DECL = /export\s+const\s+(template|styles)\s*(?::[^=\n]+)?=\s*/g;
 function extractSources(script) {
   let template;
   let templateRange;
@@ -1948,10 +2036,30 @@ function extractSources(script) {
 function parseLiteral(src, i, kind) {
   i = skipWs(src, i);
   const c = src[i];
-  if (c === '"' || c === "'" || c === "`") return parseString(src, i);
+  if (c === '"' || c === "'" || c === "`") return parseConcat(src, i);
   if (c === "[") return parseArray(src, i);
   throw new Error(`weave: \`${kind}\` must be a static string${kind === "styles" ? " or array of strings" : ""}`);
 }
+function parseConcat(src, i) {
+  const first = parseString(src, i);
+  let value = first.value;
+  let end = first.end;
+  let single = true;
+  for (; ; ) {
+    const plus = skipWs(src, end);
+    if (src[plus] !== "+") break;
+    const nextStart = skipWs(src, plus + 1);
+    const c = src[nextStart];
+    if (c !== '"' && c !== "'" && c !== "`") {
+      throw new Error("weave: `template`/`styles` must be a static string \u2014 `+` may only join string literals");
+    }
+    const next = parseString(src, nextStart);
+    value += next.value;
+    end = next.end;
+    single = false;
+  }
+  return single ? { value, end, innerStart: first.innerStart, innerEnd: first.innerEnd } : { value, end };
+}
 function parseString(src, i) {
   const quote = src[i];
   const innerStart = i + 1;
@@ -1983,7 +2091,7 @@ function parseArray(src, i) {
       j++;
       continue;
     }
-    const str = parseString(src, j);
+    const str = parseConcat(src, j);
     items.push(str.value);
     j = str.end;
   }
@@ -2028,15 +2136,18 @@ function langFromExt(file) {
   if (file.endsWith(".sass")) return "sass";
   return "css";
 }
+function pkgImporters(sass) {
+  return [new sass.NodePackageImporter()];
+}
 async function compileStyleFile(path) {
   if (langFromExt(path) === "css") return readFile(path, "utf8");
   const sass = await import("sass");
-  return sass.compile(path).css;
+  return sass.compile(path, { importers: pkgImporters(sass) }).css;
 }
 async function compileStyleFileTracked(path) {
   if (langFromExt(path) === "css") return { css: await readFile(path, "utf8"), files: [path] };
   const sass = await import("sass");
-  const result = sass.compile(path);
+  const result = sass.compile(path, { importers: pkgImporters(sass) });
   const files = result.loadedUrls.filter((u) => u.protocol === "file:").map((u) => fileURLToPath(u));
   return { css: result.css, files };
 }
@@ -2045,15 +2156,24 @@ async function compileStyleSource(source, lang, fromDir) {
   const sass = await import("sass");
   return sass.compileString(source, {
     syntax: lang === "sass" ? "indented" : "scss",
-    loadPaths: fromDir ? [fromDir] : []
+    loadPaths: fromDir ? [fromDir] : [],
+    importers: pkgImporters(sass)
   }).css;
 }
 
 // packages/cli/src/plugin.ts
+function styleId(css) {
+  let h = 5381;
+  for (let i = 0; i < css.length; i++) h = Math.imul(h, 33) ^ css.charCodeAt(i) | 0;
+  return "w-css-" + (h >>> 0).toString(36);
+}
 function cssInjector(css) {
   if (!css) return "";
+  const id = styleId(css);
   return `
-;(()=>{const s=document.createElement("style");s.textContent=${JSON.stringify(
+;(()=>{const id=${JSON.stringify(
+    id
+  )};if(document.getElementById(id))return;const s=document.createElement("style");s.id=id;s.textContent=${JSON.stringify(
     css
   )};document.head.appendChild(s);})();
 `;
@@ -2100,6 +2220,78 @@ async function resolveStyles(decl, tsPath, dir, styleLang) {
   const compiled = await compileStyleFileTracked(siblingStyle);
   return { css: compiled.css, files: compiled.files };
 }
+function stripComments(code) {
+  let out = "";
+  let i = 0;
+  const n = code.length;
+  while (i < n) {
+    const c = code[i];
+    const d = code[i + 1];
+    if (c === '"' || c === "'" || c === "`") {
+      const quote = c;
+      out += c;
+      i++;
+      while (i < n) {
+        const ch = code[i];
+        if (ch === "\\") {
+          out += ch + (code[i + 1] ?? "");
+          i += 2;
+          continue;
+        }
+        out += ch;
+        i++;
+        if (ch === quote) break;
+      }
+      continue;
+    }
+    if (c === "/" && d === "/") {
+      while (i < n && code[i] !== "\n") i++;
+      continue;
+    }
+    if (c === "/" && d === "*") {
+      i += 2;
+      while (i < n && !(code[i] === "*" && code[i + 1] === "/")) i++;
+      i += 2;
+      continue;
+    }
+    out += c;
+    i++;
+  }
+  return out;
+}
+function importsBinding(script, name) {
+  if (!script) return false;
+  const code = stripComments(script);
+  const word = new RegExp(`\\b${name}\\b`);
+  const IMPORT = /import\s+([^;]*?)\s+from\s+['"][^'"]+['"]/g;
+  let m;
+  while ((m = IMPORT.exec(code)) !== null) {
+    if (word.test(m[1])) return true;
+  }
+  return false;
+}
+function resolveChildModule(tag, dir) {
+  for (const cand of childImportCandidates(tag)) {
+    for (const ext of [".ts", ".weave"]) {
+      if (existsSync(resolve(dir, cand + ext))) return cand;
+    }
+  }
+  return null;
+}
+function injectChildImports(code, components, dir, script, filename) {
+  const imports = [];
+  for (const tag of components) {
+    if (importsBinding(script, tag)) continue;
+    const cand = resolveChildModule(tag, dir);
+    if (cand === null) {
+      throw new Error(
+        `weave: ${filename} composes <${tag}> but no import for it was found. Import it in the component's script, or place its module at ${childImportCandidates(tag).map((c) => `${c}.ts`).join(" / ")} (relative to the component).`
+      );
+    }
+    imports.push(`import ${tag} from ${JSON.stringify(cand + ".js")};`);
+  }
+  return imports.length ? imports.join("\n") + "\n" + code : code;
+}
 function weave(state, options = {}) {
   const styleLang = options.styleLang ?? "css";
   const dev2 = options.dev ?? false;
@@ -2118,8 +2310,9 @@ function weave(state, options = {}) {
         const source = await readFile2(args.path, "utf8");
         const src = parseSfc(source);
         const styles = src.styles ? await compileStyleSource(src.styles, styleLang, dirname(args.path)) : void 0;
-        const { code, css } = compileComponent({ ...src, styles }, { filename: args.path });
-        return emit2(code, css, dirname(args.path));
+        const { code, css, components } = compileComponent({ ...src, styles }, { filename: args.path });
+        const wired = injectChildImports(code, components, dirname(args.path), src.script, args.path);
+        return emit2(wired, css, dirname(args.path));
       });
       build2.onLoad({ filter: /\.ts$/ }, async (args) => {
         if (args.path.includes("node_modules")) return void 0;
@@ -2142,11 +2335,12 @@ function weave(state, options = {}) {
           dir,
           styleLang
         );
-        const { code, css } = compileComponent(
+        const { code, css, components } = compileComponent(
           { script: decl.script, template: template.text, styles: styles.css },
           { filename: args.path }
         );
-        return { ...emit2(code, css, dir), watchFiles: [...template.files, ...styles.files] };
+        const wired = injectChildImports(code, components, dir, decl.script, args.path);
+        return { ...emit2(wired, css, dir), watchFiles: [...template.files, ...styles.files] };
       });
     }
   };
@@ -2309,7 +2503,7 @@ async function build(config) {
 import { context } from "esbuild";
 import { createServer } from "node:http";
 import { mkdir as mkdir2, writeFile as writeFile2, readFile as readFile4 } from "node:fs/promises";
-import { join as join3, extname, relative as relative2, sep as sep2 } from "node:path";
+import { join as join3, extname, relative as relative2, sep as sep2, isAbsolute } from "node:path";
 var RELOAD_PATH = "/__weave_reload";
 var MIME = {
   ".html": "text/html; charset=utf-8",
@@ -2336,7 +2530,7 @@ async function devInMemory(config) {
     const css = (await Promise.all(config.styles.map(compileStyleFile))).join("\n");
     if (css)
       banner = {
-        js: `(()=>{const s=document.createElement("style");s.textContent=${JSON.stringify(
+        js: `(()=>{const id="w-global-styles";if(document.getElementById(id))return;const s=document.createElement("style");s.id=id;s.textContent=${JSON.stringify(
           css
         )};document.head.appendChild(s);})();`
       };
@@ -2401,8 +2595,15 @@ async function handleRequest(req, res, config, outputs, clients) {
     return;
   }
   if (extname(url)) {
+    const target = join3(config.servedir, url);
+    const rel = relative2(config.servedir, target);
+    if (rel === ".." || rel.startsWith(".." + sep2) || isAbsolute(rel)) {
+      res.writeHead(403);
+      res.end("Forbidden");
+      return;
+    }
     try {
-      const buf = await readFile4(join3(config.servedir, url));
+      const buf = await readFile4(target);
       res.writeHead(200, { "content-type": mime(url) });
       res.end(buf);
     } catch {
@@ -2604,7 +2805,7 @@ function generateRoutes(dir, opts = {}) {
 import { build as esbuildBuild } from "esbuild";
 import { existsSync as existsSync4 } from "node:fs";
 import { readFile as readFile5 } from "node:fs/promises";
-import { resolve as resolve2, dirname as dirname2, join as join5, isAbsolute } from "node:path";
+import { resolve as resolve2, dirname as dirname2, join as join5, isAbsolute as isAbsolute2 } from "node:path";
 function defineConfig(config) {
   return config;
 }
@@ -2648,7 +2849,7 @@ async function importConfigModule(file) {
   return mod.default ?? mod;
 }
 function resolveConfig(raw, root) {
-  const abs = (p) => isAbsolute(p) ? p : resolve2(root, p);
+  const abs = (p) => isAbsolute2(p) ? p : resolve2(root, p);
   if (!raw.root && !raw.entry) {
     throw new Error("weave: config must declare either `root` (generated bootstrap) or `entry` (hand-written)");
   }
@@ -3201,8 +3402,21 @@ weave check: ${errors} error${errors === 1 ? "" : "s"}`);
     console.log(`weave routes \u2192 ${written}`);
     return;
   }
+  if (cmd === "mcp") {
+    try {
+      const mcp = await import("@weave-framework/mcp");
+      await mcp.runStdioServer();
+    } catch (e) {
+      console.error(
+        `weave mcp: could not start the MCP server \u2014 is @weave-framework/mcp installed?
+${e?.message ?? String(e)}`
+      );
+      process.exit(1);
+    }
+    return;
+  }
   console.error(
-    "usage: weave <build|dev|check|routes> [entry|paths\u2026] [--config file] [--out dir] [--serve dir] [--port n] [--no-minify] [--eager]"
+    "usage: weave <build|dev|check|routes|mcp> [entry|paths\u2026] [--config file] [--out dir] [--serve dir] [--port n] [--no-minify] [--eager]"
   );
   process.exit(1);
 }

package/dist/styles.d.ts

@@ -10,7 +10,7 @@
 export type StyleLang = 'css' | 'scss' | 'sass';
 /** The style language implied by a file extension (defaults to plain CSS). */
 export declare function langFromExt(file: string): StyleLang;
-/** Compile a style FILE to CSS — `@use`/`@import` resolve relative to it. */
+/** Compile a style FILE to CSS — `@use`/`@import` resolve relative to it (+ `pkg:` packages). */
 export declare function compileStyleFile(path: string): Promise<string>;
 /**
  * Like {@link compileStyleFile} but also reports every file the compile pulled in —

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weave-framework/cli",
-  "version": "0.2.53",
+  "version": "0.2.162",
   "description": "Weave CLI — `weave build`, `weave dev` (watch + live-reload), `weave check`, `weave routes`.",
   "type": "module",
   "bin": {
@@ -31,7 +31,8 @@
   },
   "dependencies": {
     "esbuild": "^0.25.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "@weave-framework/mcp": "0.2.162"
   },
   "optionalDependencies": {
     "sass": "^1.0.0"