@macroforge/svelte-preprocessor 0.1.18

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+import type { PreprocessorGroup } from "svelte/compiler";
+/**
+ * Options for the macroforge Svelte preprocessor
+ */
+export interface MacroforgePreprocessorOptions {
+    /**
+     * Whether to keep @derive decorators in the output.
+     * Useful for debugging or when you need to see the decorators in generated code.
+     * @default false
+     */
+    keepDecorators?: boolean;
+    /**
+     * Whether to process JavaScript files (not just TypeScript).
+     * By default, only `<script lang="ts">` blocks are processed.
+     * @default false
+     */
+    processJavaScript?: boolean;
+}
+/**
+ * Creates a Svelte preprocessor that expands macroforge macros in `<script>` blocks.
+ *
+ * This preprocessor should be placed BEFORE other preprocessors like `vitePreprocess()`
+ * to ensure macros are expanded before TypeScript compilation.
+ *
+ * @example
+ * ```js
+ * // svelte.config.js
+ * import { vitePreprocess } from '@sveltejs/vite-plugin-svelte';
+ * import { macroforgePreprocess } from '@macroforge/svelte-preprocessor';
+ *
+ * export default {
+ *   preprocess: [
+ *     macroforgePreprocess(),  // Expand macros FIRST
+ *     vitePreprocess()          // Then handle TypeScript/CSS
+ *   ]
+ * };
+ * ```
+ */
+export declare function macroforgePreprocess(options?: MacroforgePreprocessorOptions): PreprocessorGroup;
+export default macroforgePreprocess;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,iBAAiB,CAAC;AA2CvE;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,6BAAkC,GAC1C,iBAAiB,CAsEnB;AAED,eAAe,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,88 @@
+// Dynamic import to handle native binding loading
+let expandSync = null;
+async function ensureExpandSync() {
+    if (expandSync === null) {
+        try {
+            const macroforge = await import("macroforge");
+            expandSync = macroforge.expandSync;
+        }
+        catch (error) {
+            console.warn("[@macroforge/svelte-preprocessor] Failed to load macroforge native bindings:", error);
+            expandSync = null;
+        }
+    }
+    return expandSync;
+}
+/**
+ * Creates a Svelte preprocessor that expands macroforge macros in `<script>` blocks.
+ *
+ * This preprocessor should be placed BEFORE other preprocessors like `vitePreprocess()`
+ * to ensure macros are expanded before TypeScript compilation.
+ *
+ * @example
+ * ```js
+ * // svelte.config.js
+ * import { vitePreprocess } from '@sveltejs/vite-plugin-svelte';
+ * import { macroforgePreprocess } from '@macroforge/svelte-preprocessor';
+ *
+ * export default {
+ *   preprocess: [
+ *     macroforgePreprocess(),  // Expand macros FIRST
+ *     vitePreprocess()          // Then handle TypeScript/CSS
+ *   ]
+ * };
+ * ```
+ */
+export function macroforgePreprocess(options = {}) {
+    const { keepDecorators = false, processJavaScript = false } = options;
+    const scriptPreprocessor = async ({ content, filename, attributes, }) => {
+        // Check if we should process this script block
+        const lang = attributes.lang || attributes.type;
+        const isTypeScript = lang === "ts" || lang === "typescript";
+        const isJavaScript = !lang || lang === "js" || lang === "javascript" || lang === "module";
+        if (!isTypeScript && !(processJavaScript && isJavaScript)) {
+            return; // Return undefined = no changes
+        }
+        // Early bailout: no macros to process
+        if (!content.includes("@derive")) {
+            return;
+        }
+        // Ensure native bindings are loaded
+        const expand = await ensureExpandSync();
+        if (!expand) {
+            // Native bindings not available - skip silently
+            return;
+        }
+        try {
+            const result = expand(content, filename || "component.svelte", {
+                keepDecorators,
+            });
+            // Report any diagnostics
+            for (const diag of result.diagnostics) {
+                if (diag.level === "error") {
+                    console.error(`[@macroforge/svelte-preprocessor] Error in ${filename}: ${diag.message}`);
+                }
+                else if (diag.level === "warning") {
+                    console.warn(`[@macroforge/svelte-preprocessor] Warning in ${filename}: ${diag.message}`);
+                }
+            }
+            // Only return if code was actually changed
+            if (result.code && result.code !== content) {
+                return {
+                    code: result.code,
+                    // TODO: Add source map support when expandSync provides it
+                };
+            }
+        }
+        catch (error) {
+            // Log warning but don't fail - let Svelte continue
+            console.warn(`[@macroforge/svelte-preprocessor] Failed to expand macros in ${filename}:`, error instanceof Error ? error.message : String(error));
+        }
+        return; // No changes
+    };
+    return {
+        name: "macroforge",
+        script: scriptPreprocessor,
+    };
+}
+export default macroforgePreprocess;

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@macroforge/svelte-preprocessor",
+  "version": "0.1.18",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rymskip/macroforge-ts.git"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "npm run build && node --test tests/**/*.test.js"
+  },
+  "dependencies": {
+    "macroforge": "^0.1.18"
+  },
+  "peerDependencies": {
+    "svelte": "^5.0.0"
+  },
+  "devDependencies": {
+    "svelte": "^5.43.8",
+    "typescript": "^5.9.3"
+  }
+}