@macroforge/shared 0.1.40

package/dist/config.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @module config
+ *
+ * Utilities for loading Macroforge configuration files.
+ */
+/**
+ * Supported config file names in order of precedence.
+ */
+export declare const CONFIG_FILES: readonly ["macroforge.config.ts", "macroforge.config.mts", "macroforge.config.js", "macroforge.config.mjs", "macroforge.config.cjs"];
+/**
+ * Result from parsing a config file.
+ */
+export interface ConfigLoadResult {
+    keepDecorators: boolean;
+    generateConvenienceConst: boolean;
+    hasForeignTypes: boolean;
+    foreignTypeCount: number;
+}
+/**
+ * Configuration options loaded from `macroforge.config.js` (or .ts/.mjs/.cjs).
+ *
+ * @remarks
+ * This configuration affects how macros are expanded and what artifacts
+ * are preserved in the output.
+ */
+export interface MacroConfig {
+    /**
+     * Whether to preserve `@derive` decorators in the output code after macro expansion.
+     *
+     * @remarks
+     * When `false` (default), decorators are removed after expansion since they serve
+     * only as compile-time directives. When `true`, decorators are kept in the output,
+     * which can be useful for debugging or when using runtime reflection.
+     */
+    keepDecorators: boolean;
+    /**
+     * Whether to generate a convenience const for non-class types.
+     *
+     * @remarks
+     * When `true` (default), generates an `export const TypeName = { ... } as const;`
+     * that groups all generated functions for a type into a single namespace-like object.
+     * For example: `export const User = { clone: userClone, serialize: userSerialize } as const;`
+     *
+     * When `false`, only the standalone functions are generated without the grouping const.
+     */
+    generateConvenienceConst?: boolean;
+    /**
+     * Path to the config file (used to cache and retrieve foreign types).
+     */
+    configPath?: string;
+    /**
+     * Whether the config has foreign type handlers defined.
+     */
+    hasForeignTypes?: boolean;
+}
+/**
+ * Function type for loading config content.
+ * This allows plugins to inject their own config loading mechanism.
+ */
+export type ConfigLoader = (content: string, filepath: string) => ConfigLoadResult;
+/**
+ * Finds a macroforge config file in the directory tree.
+ *
+ * @param startDir - The directory to start searching from
+ * @returns The path to the config file, or null if not found
+ *
+ * @remarks
+ * The search stops when:
+ * - A config file is found
+ * - A package.json boundary is reached
+ * - The filesystem root is reached
+ *
+ * @example
+ * ```typescript
+ * const configPath = findConfigFile('/project/src/components');
+ * // => '/project/macroforge.config.js' or null
+ * ```
+ */
+export declare function findConfigFile(startDir: string): string | null;
+/**
+ * Loads Macroforge configuration from `macroforge.config.js` (or .ts/.mjs/.cjs).
+ *
+ * @remarks
+ * Starting from the given directory, this function walks up the filesystem hierarchy
+ * looking for a macroforge config file. The first one found is parsed using the
+ * provided loader function (if any), which extracts configuration including
+ * foreign type handlers.
+ *
+ * @param startDir - The directory to start searching from (typically the project root)
+ * @param loadConfigFn - Optional function to parse the config file content.
+ *                       If provided, will be called with (content, filepath).
+ *                       If not provided, only the configPath will be set.
+ *
+ * @returns The loaded configuration, or default values if no config file is found
+ *
+ * @example
+ * ```typescript
+ * // Basic usage (no parsing, just find the config path)
+ * const config = loadMacroConfig('/project/src');
+ * // => { keepDecorators: false, configPath: '/project/macroforge.config.js' }
+ *
+ * // With Rust binary parser
+ * const config = loadMacroConfig('/project/src', rustTransformer.loadConfig);
+ * // => { keepDecorators: true, configPath: '...', hasForeignTypes: true }
+ * ```
+ */
+export declare function loadMacroConfig(startDir: string, loadConfigFn?: ConfigLoader): MacroConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,eAAO,MAAM,YAAY,sIAMf,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,OAAO,CAAC;IACxB,wBAAwB,EAAE,OAAO,CAAC;IAClC,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;OAOG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;;;;;;;;OASG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,KACb,gBAAgB,CAAC;AAEtB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsB9D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,YAAY,GAC1B,WAAW,CA8Bb"}

package/dist/config.js

@@ -0,0 +1,111 @@
+/**
+ * @module config
+ *
+ * Utilities for loading Macroforge configuration files.
+ */
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * Supported config file names in order of precedence.
+ */
+export const CONFIG_FILES = [
+    "macroforge.config.ts",
+    "macroforge.config.mts",
+    "macroforge.config.js",
+    "macroforge.config.mjs",
+    "macroforge.config.cjs",
+];
+/**
+ * Finds a macroforge config file in the directory tree.
+ *
+ * @param startDir - The directory to start searching from
+ * @returns The path to the config file, or null if not found
+ *
+ * @remarks
+ * The search stops when:
+ * - A config file is found
+ * - A package.json boundary is reached
+ * - The filesystem root is reached
+ *
+ * @example
+ * ```typescript
+ * const configPath = findConfigFile('/project/src/components');
+ * // => '/project/macroforge.config.js' or null
+ * ```
+ */
+export function findConfigFile(startDir) {
+    let current = startDir;
+    while (true) {
+        for (const filename of CONFIG_FILES) {
+            const candidate = path.join(current, filename);
+            if (fs.existsSync(candidate)) {
+                return candidate;
+            }
+        }
+        // Stop at package.json boundary
+        if (fs.existsSync(path.join(current, "package.json"))) {
+            break;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return null;
+}
+/**
+ * Loads Macroforge configuration from `macroforge.config.js` (or .ts/.mjs/.cjs).
+ *
+ * @remarks
+ * Starting from the given directory, this function walks up the filesystem hierarchy
+ * looking for a macroforge config file. The first one found is parsed using the
+ * provided loader function (if any), which extracts configuration including
+ * foreign type handlers.
+ *
+ * @param startDir - The directory to start searching from (typically the project root)
+ * @param loadConfigFn - Optional function to parse the config file content.
+ *                       If provided, will be called with (content, filepath).
+ *                       If not provided, only the configPath will be set.
+ *
+ * @returns The loaded configuration, or default values if no config file is found
+ *
+ * @example
+ * ```typescript
+ * // Basic usage (no parsing, just find the config path)
+ * const config = loadMacroConfig('/project/src');
+ * // => { keepDecorators: false, configPath: '/project/macroforge.config.js' }
+ *
+ * // With Rust binary parser
+ * const config = loadMacroConfig('/project/src', rustTransformer.loadConfig);
+ * // => { keepDecorators: true, configPath: '...', hasForeignTypes: true }
+ * ```
+ */
+export function loadMacroConfig(startDir, loadConfigFn) {
+    const fallback = { keepDecorators: false };
+    const configPath = findConfigFile(startDir);
+    if (!configPath) {
+        return fallback;
+    }
+    // If a loader function is provided, use it to parse the config
+    if (loadConfigFn) {
+        try {
+            const content = fs.readFileSync(configPath, "utf8");
+            const result = loadConfigFn(content, configPath);
+            return {
+                keepDecorators: result.keepDecorators,
+                generateConvenienceConst: result.generateConvenienceConst,
+                configPath,
+                hasForeignTypes: result.hasForeignTypes,
+            };
+        }
+        catch {
+            // Fall through to fallback
+        }
+    }
+    // Fallback: just mark the path but use defaults
+    return {
+        ...fallback,
+        configPath,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,sBAAsB;IACtB,uBAAuB;IACvB,sBAAsB;IACtB,uBAAuB;IACvB,uBAAuB;CACf,CAAC;AA8DX;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,OAAO,GAAG,QAAQ,CAAC;IAEvB,OAAO,IAAI,EAAE,CAAC;QACZ,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC/C,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7B,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YACtD,MAAM;QACR,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM;QAC9B,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,YAA2B;IAE3B,MAAM,QAAQ,GAAgB,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IAExD,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,+DAA+D;IAC/D,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACpD,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAEjD,OAAO;gBACL,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,wBAAwB,EAAE,MAAM,CAAC,wBAAwB;gBACzD,UAAU;gBACV,eAAe,EAAE,MAAM,CAAC,eAAe;aACxC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,OAAO;QACL,GAAG,QAAQ;QACX,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/external-manifest.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @module external-manifest
+ *
+ * Utilities for loading and caching external macro package manifests.
+ */
+import type { MacroManifest, MacroManifestEntry, DecoratorManifestEntry } from "macroforge";
+/**
+ * Function type for requiring modules.
+ * Accepts any function that can load a module by path.
+ */
+export type RequireFunction = (id: string) => any;
+/**
+ * Clears the external manifest cache.
+ * Useful for testing or when packages may have been updated.
+ */
+export declare function clearExternalManifestCache(): void;
+/**
+ * Attempts to load the manifest from an external macro package.
+ *
+ * External macro packages (like `@playground/macro`) export their own
+ * `__macroforgeGetManifest()` function that provides macro metadata
+ * including descriptions.
+ *
+ * @param modulePath - The package path (e.g., "@playground/macro")
+ * @param requireFn - Optional custom require function. If not provided, creates one using import.meta.url context.
+ * @returns The macro manifest, or null if loading failed
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const manifest = getExternalManifest("@playground/macro");
+ *
+ * // With custom require function (e.g., from vite-plugin)
+ * import { createRequire } from "module";
+ * const moduleRequire = createRequire(import.meta.url);
+ * const manifest = getExternalManifest("@playground/macro", moduleRequire);
+ * ```
+ */
+export declare function getExternalManifest(modulePath: string, requireFn?: RequireFunction): MacroManifest | null;
+/**
+ * Looks up macro info from an external package manifest.
+ *
+ * @param macroName - The macro name to look up
+ * @param modulePath - The package path
+ * @param requireFn - Optional custom require function
+ * @returns The macro manifest entry, or null if not found
+ *
+ * @example
+ * ```typescript
+ * const macroInfo = getExternalMacroInfo("Gigaform", "@playground/macro");
+ * if (macroInfo) {
+ *   console.log(macroInfo.description);
+ * }
+ * ```
+ */
+export declare function getExternalMacroInfo(macroName: string, modulePath: string, requireFn?: RequireFunction): MacroManifestEntry | null;
+/**
+ * Looks up decorator info from an external package manifest.
+ *
+ * @param decoratorName - The decorator name to look up
+ * @param modulePath - The package path
+ * @param requireFn - Optional custom require function
+ * @returns The decorator manifest entry, or null if not found
+ *
+ * @example
+ * ```typescript
+ * const decoratorInfo = getExternalDecoratorInfo("hiddenController", "@playground/macro");
+ * if (decoratorInfo) {
+ *   console.log(decoratorInfo.description);
+ * }
+ * ```
+ */
+export declare function getExternalDecoratorInfo(decoratorName: string, modulePath: string, requireFn?: RequireFunction): DecoratorManifestEntry | null;
+export type { MacroManifest, MacroManifestEntry, DecoratorManifestEntry };
+//# sourceMappingURL=external-manifest.d.ts.map

package/dist/external-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-manifest.d.ts","sourceRoot":"","sources":["../src/external-manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE5F;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,GAAG,CAAC;AAQlD;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,eAAe,GAC1B,aAAa,GAAG,IAAI,CAoBtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,eAAe,GAC1B,kBAAkB,GAAG,IAAI,CAS3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,eAAe,GAC1B,sBAAsB,GAAG,IAAI,CAS/B;AAGD,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/external-manifest.js

@@ -0,0 +1,105 @@
+/**
+ * @module external-manifest
+ *
+ * Utilities for loading and caching external macro package manifests.
+ */
+import { createRequire } from "module";
+/**
+ * Cache for external macro package manifests.
+ * Maps package path to its manifest (or null if failed to load).
+ */
+const externalManifestCache = new Map();
+/**
+ * Clears the external manifest cache.
+ * Useful for testing or when packages may have been updated.
+ */
+export function clearExternalManifestCache() {
+    externalManifestCache.clear();
+}
+/**
+ * Attempts to load the manifest from an external macro package.
+ *
+ * External macro packages (like `@playground/macro`) export their own
+ * `__macroforgeGetManifest()` function that provides macro metadata
+ * including descriptions.
+ *
+ * @param modulePath - The package path (e.g., "@playground/macro")
+ * @param requireFn - Optional custom require function. If not provided, creates one using import.meta.url context.
+ * @returns The macro manifest, or null if loading failed
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const manifest = getExternalManifest("@playground/macro");
+ *
+ * // With custom require function (e.g., from vite-plugin)
+ * import { createRequire } from "module";
+ * const moduleRequire = createRequire(import.meta.url);
+ * const manifest = getExternalManifest("@playground/macro", moduleRequire);
+ * ```
+ */
+export function getExternalManifest(modulePath, requireFn) {
+    if (externalManifestCache.has(modulePath)) {
+        return externalManifestCache.get(modulePath) ?? null;
+    }
+    try {
+        // Use provided require function or create one
+        const req = requireFn ?? createRequire(import.meta.url);
+        const pkg = req(modulePath);
+        if (typeof pkg.__macroforgeGetManifest === "function") {
+            const manifest = pkg.__macroforgeGetManifest();
+            externalManifestCache.set(modulePath, manifest);
+            return manifest;
+        }
+    }
+    catch {
+        // Package not found or doesn't export manifest
+    }
+    externalManifestCache.set(modulePath, null);
+    return null;
+}
+/**
+ * Looks up macro info from an external package manifest.
+ *
+ * @param macroName - The macro name to look up
+ * @param modulePath - The package path
+ * @param requireFn - Optional custom require function
+ * @returns The macro manifest entry, or null if not found
+ *
+ * @example
+ * ```typescript
+ * const macroInfo = getExternalMacroInfo("Gigaform", "@playground/macro");
+ * if (macroInfo) {
+ *   console.log(macroInfo.description);
+ * }
+ * ```
+ */
+export function getExternalMacroInfo(macroName, modulePath, requireFn) {
+    const manifest = getExternalManifest(modulePath, requireFn);
+    if (!manifest)
+        return null;
+    return (manifest.macros.find((m) => m.name.toLowerCase() === macroName.toLowerCase()) ?? null);
+}
+/**
+ * Looks up decorator info from an external package manifest.
+ *
+ * @param decoratorName - The decorator name to look up
+ * @param modulePath - The package path
+ * @param requireFn - Optional custom require function
+ * @returns The decorator manifest entry, or null if not found
+ *
+ * @example
+ * ```typescript
+ * const decoratorInfo = getExternalDecoratorInfo("hiddenController", "@playground/macro");
+ * if (decoratorInfo) {
+ *   console.log(decoratorInfo.description);
+ * }
+ * ```
+ */
+export function getExternalDecoratorInfo(decoratorName, modulePath, requireFn) {
+    const manifest = getExternalManifest(modulePath, requireFn);
+    if (!manifest)
+        return null;
+    return (manifest.decorators.find((d) => d.export.toLowerCase() === decoratorName.toLowerCase()) ?? null);
+}
+//# sourceMappingURL=external-manifest.js.map

package/dist/external-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-manifest.js","sourceRoot":"","sources":["../src/external-manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AASvC;;;GAGG;AACH,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAgC,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACxC,qBAAqB,CAAC,KAAK,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,SAA2B;IAE3B,IAAI,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,OAAO,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IACvD,CAAC;IAED,IAAI,CAAC;QACH,8CAA8C;QAC9C,MAAM,GAAG,GAAG,SAAS,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;QAC5B,IAAI,OAAO,GAAG,CAAC,uBAAuB,KAAK,UAAU,EAAE,CAAC;YACtD,MAAM,QAAQ,GAAkB,GAAG,CAAC,uBAAuB,EAAE,CAAC;YAC9D,qBAAqB,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAChD,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;IAED,qBAAqB,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAiB,EACjB,UAAkB,EAClB,SAA2B;IAE3B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,OAAO,CACL,QAAQ,CAAC,MAAM,CAAC,IAAI,CAClB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CACxD,IAAI,IAAI,CACV,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,wBAAwB,CACtC,aAAqB,EACrB,UAAkB,EAClB,SAA2B;IAE3B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,OAAO,CACL,QAAQ,CAAC,UAAU,CAAC,IAAI,CACtB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,WAAW,EAAE,CAC9D,IAAI,IAAI,CACV,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @module @macroforge/shared
+ *
+ * Shared utilities for Macroforge plugins.
+ *
+ * This package provides common functionality used by both `@macroforge/vite-plugin`
+ * and `@macroforge/typescript-plugin`, ensuring consistent behavior across
+ * different build tools.
+ *
+ * @packageDocumentation
+ */
+export { parseMacroImportComments } from "./macro-imports.js";
+export { getExternalManifest, getExternalMacroInfo, getExternalDecoratorInfo, clearExternalManifestCache, type MacroManifest, type MacroManifestEntry, type DecoratorManifestEntry, type RequireFunction, } from "./external-manifest.js";
+export { CONFIG_FILES, findConfigFile, loadMacroConfig, type MacroConfig, type ConfigLoader, type ConfigLoadResult, } from "./config.js";
+import { type RequireFunction } from "./external-manifest.js";
+/**
+ * Collects decorator modules from external macro packages referenced in the code.
+ *
+ * This function parses macro import comments in the code to find external packages,
+ * then loads their manifests and collects all decorator module names.
+ *
+ * @param code - The TypeScript source code to scan
+ * @param requireFn - Optional custom require function for loading external packages
+ * @returns Array of decorator module names from external packages
+ *
+ * @example
+ * ```typescript
+ * const code = `/** import macro {Gigaform} from "@playground/macro"; *​/
+ * /** @derive(Gigaform) *​/
+ * class MyForm {}`;
+ *
+ * const modules = collectExternalDecoratorModules(code);
+ * // => ["hiddenController", "fieldController", ...]
+ * ```
+ */
+export declare function collectExternalDecoratorModules(code: string, requireFn?: RequireFunction): string[];
+//# 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;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,eAAe,GAC1B,MAAM,EAAE,CAQV"}

package/dist/index.js

@@ -0,0 +1,47 @@
+/**
+ * @module @macroforge/shared
+ *
+ * Shared utilities for Macroforge plugins.
+ *
+ * This package provides common functionality used by both `@macroforge/vite-plugin`
+ * and `@macroforge/typescript-plugin`, ensuring consistent behavior across
+ * different build tools.
+ *
+ * @packageDocumentation
+ */
+// Re-export all utilities
+export { parseMacroImportComments } from "./macro-imports.js";
+export { getExternalManifest, getExternalMacroInfo, getExternalDecoratorInfo, clearExternalManifestCache, } from "./external-manifest.js";
+export { CONFIG_FILES, findConfigFile, loadMacroConfig, } from "./config.js";
+// Import for composite functions
+import { parseMacroImportComments } from "./macro-imports.js";
+import { getExternalManifest } from "./external-manifest.js";
+/**
+ * Collects decorator modules from external macro packages referenced in the code.
+ *
+ * This function parses macro import comments in the code to find external packages,
+ * then loads their manifests and collects all decorator module names.
+ *
+ * @param code - The TypeScript source code to scan
+ * @param requireFn - Optional custom require function for loading external packages
+ * @returns Array of decorator module names from external packages
+ *
+ * @example
+ * ```typescript
+ * const code = `/** import macro {Gigaform} from "@playground/macro"; *​/
+ * /** @derive(Gigaform) *​/
+ * class MyForm {}`;
+ *
+ * const modules = collectExternalDecoratorModules(code);
+ * // => ["hiddenController", "fieldController", ...]
+ * ```
+ */
+export function collectExternalDecoratorModules(code, requireFn) {
+    const imports = parseMacroImportComments(code);
+    const modulePaths = [...new Set(imports.values())];
+    return modulePaths.flatMap((modulePath) => {
+        const manifest = getExternalManifest(modulePath, requireFn);
+        return manifest?.decorators.map((d) => d.module) ?? [];
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,0BAA0B;AAC1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,GAK3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,GAIhB,MAAM,aAAa,CAAC;AAErB,iCAAiC;AACjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAwB,MAAM,wBAAwB,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,+BAA+B,CAC7C,IAAY,EACZ,SAA2B;IAE3B,MAAM,OAAO,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEnD,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;QACxC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAC5D,OAAO,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/macro-imports.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module macro-imports
+ *
+ * Utilities for parsing macro import comments in TypeScript code.
+ */
+/**
+ * Parses macro import comments from TypeScript code.
+ *
+ * @remarks
+ * Extracts macro names mapped to their source module paths from
+ * `/** import macro { ... } from "package" *​/` comments.
+ *
+ * @param text - The TypeScript source code to parse
+ * @returns Map of macro names to their module paths
+ *
+ * @example
+ * ```typescript
+ * const text = `/** import macro {JSON, FieldController} from "@playground/macro"; *​/`;
+ * parseMacroImportComments(text);
+ * // => Map { "JSON" => "@playground/macro", "FieldController" => "@playground/macro" }
+ * ```
+ */
+export declare function parseMacroImportComments(text: string): Map<string, string>;
+//# sourceMappingURL=macro-imports.d.ts.map

package/dist/macro-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"macro-imports.d.ts","sourceRoot":"","sources":["../src/macro-imports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAiB1E"}

package/dist/macro-imports.js

@@ -0,0 +1,39 @@
+/**
+ * @module macro-imports
+ *
+ * Utilities for parsing macro import comments in TypeScript code.
+ */
+/**
+ * Parses macro import comments from TypeScript code.
+ *
+ * @remarks
+ * Extracts macro names mapped to their source module paths from
+ * `/** import macro { ... } from "package" *​/` comments.
+ *
+ * @param text - The TypeScript source code to parse
+ * @returns Map of macro names to their module paths
+ *
+ * @example
+ * ```typescript
+ * const text = `/** import macro {JSON, FieldController} from "@playground/macro"; *​/`;
+ * parseMacroImportComments(text);
+ * // => Map { "JSON" => "@playground/macro", "FieldController" => "@playground/macro" }
+ * ```
+ */
+export function parseMacroImportComments(text) {
+    const imports = new Map();
+    const pattern = /\/\*\*\s*import\s+macro\s*\{([^}]+)\}\s*from\s*["']([^"']+)["']/gi;
+    let match;
+    while ((match = pattern.exec(text)) !== null) {
+        const names = match[1]
+            .split(",")
+            .map((n) => n.trim())
+            .filter(Boolean);
+        const modulePath = match[2];
+        for (const name of names) {
+            imports.set(name, modulePath);
+        }
+    }
+    return imports;
+}
+//# sourceMappingURL=macro-imports.js.map

package/dist/macro-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"macro-imports.js","sourceRoot":"","sources":["../src/macro-imports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,MAAM,OAAO,GACX,mEAAmE,CAAC;IACtE,IAAI,KAA6B,CAAC;IAElC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;aACnB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC,CAAC;QACnB,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@macroforge/shared",
+  "version": "0.1.40",
+  "description": "Shared utilities for Macroforge plugins",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rymskip/macroforge-ts.git"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "cleanbuild": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "macroforge": "^0.1.40"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}