@macroforge/mcp-server 0.1.74 → 0.1.76

package/docs/custom-macros/custom-overview.md

@@ -75,6 +75,13 @@ Note
 
 The `import macro` comment tells Macroforge which package provides the macro.
 
+## Vite Dev Server
+
+When using a custom macro package as a local `file:` dependency, you may need to configure Vite's
+`server.fs.allow` and add `exports` to your package's `package.json` for dev mode to work. See the
+[Vite Plugin integration guide](../integration/vite-plugin.md#custom-macro-packages-with-file-dependencies)
+for details.
+
 ## Getting Started
 
 Follow these guides to create your own macros:

package/docs/integration/vite-plugin.md

@@ -110,6 +110,46 @@ During development, the plugin:
 - Expands macros on save
 - Provides HMR support for expanded code
 
+### Custom Macro Packages with `file:` Dependencies
+
+If your custom macro package is a local `file:` dependency (e.g. `"@my/macros": "file:./macros"`),
+the expanded code may contain runtime imports pointing to files inside that package. Vite's dev
+server restricts filesystem access to a set of allowed directories (`src/`, `.svelte-kit/`,
+`node_modules/`, etc.), and local `file:` dependencies outside those paths will be blocked.
+
+You must add the package directory to `server.fs.allow`:
+
+vite.config.ts
+
+```
+export default defineConfig({
+  plugins: [macroforge()],
+  server: {
+    fs: {
+      allow: ['macros']  // path to your local macro package
+    }
+  }
+});
+```
+
+The macro package also needs a `package.json` `exports` field so Vite can resolve subpath imports.
+For example, if expanded code imports from `@my/macros/helpers`:
+
+macros/package.json
+
+```
+{
+  "name": "@my/macros",
+  "exports": {
+    ".": { "types": "./index.d.ts", "default": "./index.js" },
+    "./helpers": "./helpers.ts"
+  }
+}
+```
+
+Without this, Vite's dev server will fail with `Pre-transform error: Failed to load url ...` even
+though the file exists on disk.
+
 ## Production Build
 
 During production builds, the plugin:

package/package.json

@@ -25,7 +25,7 @@
   "main": "dist/index.js",
   "name": "@macroforge/mcp-server",
   "peerDependencies": {
-    "macroforge": "^0.1.74"
+    "macroforge": "^0.1.76"
   },
   "peerDependenciesMeta": {
     "macroforge": {
@@ -46,5 +46,5 @@
     "test": "node --test tests/**/*.test.js"
   },
   "type": "module",
-  "version": "0.1.74"
+  "version": "0.1.76"
 }