vite-plugin-ferry 0.1.5 → 0.2.0

package/dist/generators/enums.d.ts

@@ -4,20 +4,25 @@ export type EnumGeneratorOptions = {
     outputDir: string;
     packageName: string;
     prettyPrint?: boolean;
+    cwd: string;
 };
 /**
- * Generate TypeScript type declarations for enums.
+ * Generate TypeScript type declaration for a single enum.
  */
-export declare function generateEnumTypeScript(enums: Record<string, EnumDefinition>): string;
+export declare function generateSingleEnumTypeScript(enumDef: EnumDefinition, phpFile?: string): string;
 /**
- * Generate runtime JavaScript for enums.
+ * Generate source map for a single enum.
  */
-export declare function generateEnumRuntime(enums: Record<string, EnumDefinition>, prettyPrint?: boolean): string;
+export declare function generateEnumSourceMap(enumDef: EnumDefinition, generatedFile: string, phpFile: string, outputDir: string): string;
+/**
+ * Generate runtime JavaScript for a single enum.
+ */
+export declare function generateSingleEnumRuntime(enumDef: EnumDefinition, prettyPrint?: boolean): string;
 /**
  * Collect all enum definitions from the enums directory.
  * This is a plugin-level function that handles file I/O.
  */
-export declare function collectEnums(enumsDir: string): Record<string, EnumDefinition>;
+export declare function collectEnums(enumsDir: string, cwd: string): Record<string, EnumDefinition>;
 /**
  * Generate enum files (TypeScript declarations and runtime JavaScript).
  */

package/dist/generators/enums.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/generators/enums.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAc/E,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,MAAM,CA4BpF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,WAAW,UAAO,GAAG,MAAM,CAgCrG;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA0B7E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CA6BjE"}
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/generators/enums.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAiB/E,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAmC9F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM,CAsCR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,cAAc,EAAE,WAAW,UAAO,GAAG,MAAM,CAsB7F;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA4B1F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAmDjE"}

package/dist/generators/enums.js

@@ -1,73 +1,109 @@
 import ts from 'typescript';
 import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { getPhpFiles, readFileSafe, writeFileEnsureDir } from '../utils/file.js';
+import { join, relative } from 'node:path';
+import { getPhpFiles, readFileSafe, writeFileEnsureDir, cleanOutputDir } from '../utils/file.js';
 import { parseEnumContent } from '../utils/php-parser.js';
-import { printNodes, createEnum, createConstObject, createObjectLiteral, createDeclareConstWithType, createTypeLiteral, createStringLiteral, createNumericLiteral, createExportDefault, printNode, } from '../utils/ts-generator.js';
+import { createEnum, createConstObject, createObjectLiteral, createDeclareConstWithType, createTypeLiteral, createStringLiteral, createNumericLiteral, printNode, } from '../utils/ts-generator.js';
+import { generateSourceMap, createSourceMapComment, } from '../utils/source-map.js';
 /**
- * Generate TypeScript type declarations for enums.
+ * Generate TypeScript type declaration for a single enum.
  */
-export function generateEnumTypeScript(enums) {
-    const nodes = [];
-    for (const enumName of Object.keys(enums)) {
-        const enumDef = enums[enumName];
-        const hasLabels = enumDef.cases.some((c) => c.label);
-        if (hasLabels) {
-            // Generate a declare const with typed properties for enums with labels
-            const properties = enumDef.cases.map((c) => ({
-                name: c.key,
-                type: createTypeLiteral([
-                    { name: 'value', type: ts.factory.createLiteralTypeNode(createStringLiteral(String(c.value))) },
-                    {
-                        name: 'label',
-                        type: ts.factory.createLiteralTypeNode(createStringLiteral(c.label || String(c.value))),
-                    },
-                ]),
-            }));
-            nodes.push(createDeclareConstWithType(enumDef.name, createTypeLiteral(properties)));
-        }
-        else {
-            // Generate a traditional enum
-            nodes.push(createEnum(enumDef.name, enumDef.cases.map((c) => ({ key: c.key, value: c.value }))));
-        }
+export function generateSingleEnumTypeScript(enumDef, phpFile) {
+    const hasLabels = enumDef.cases.some((c) => c.label);
+    let node;
+    if (hasLabels) {
+        const properties = enumDef.cases.map((c) => ({
+            name: c.key,
+            type: createTypeLiteral([
+                { name: 'value', type: ts.factory.createLiteralTypeNode(createStringLiteral(String(c.value))) },
+                {
+                    name: 'label',
+                    type: ts.factory.createLiteralTypeNode(createStringLiteral(c.label || String(c.value))),
+                },
+            ]),
+        }));
+        node = createDeclareConstWithType(enumDef.name, createTypeLiteral(properties));
+    }
+    else {
+        node = createEnum(enumDef.name, enumDef.cases.map((c) => ({ key: c.key, value: c.value })));
+    }
+    const lines = [];
+    // Add JSDoc with source reference
+    if (phpFile) {
+        lines.push(`/** @see ${phpFile} */`);
     }
-    return nodes.length > 0 ? printNodes(nodes) + '\n' : '';
+    lines.push(printNode(node));
+    // Add source map comment
+    if (phpFile) {
+        lines.push(createSourceMapComment(`${enumDef.name}.d.ts.map`));
+    }
+    return lines.join('\n') + '\n';
 }
 /**
- * Generate runtime JavaScript for enums.
+ * Generate source map for a single enum.
  */
-export function generateEnumRuntime(enums, prettyPrint = true) {
-    const nodes = [];
-    for (const enumName of Object.keys(enums)) {
-        const enumDef = enums[enumName];
-        const hasLabels = enumDef.cases.some((c) => c.label);
-        const properties = enumDef.cases.map((c) => {
-            let value;
-            if (hasLabels) {
-                value = createObjectLiteral([
-                    { key: 'value', value: createStringLiteral(String(c.value)) },
-                    { key: 'label', value: createStringLiteral(c.label || String(c.value)) },
-                ], prettyPrint);
-            }
-            else if (typeof c.value === 'number') {
-                value = createNumericLiteral(c.value);
-            }
-            else {
-                value = createStringLiteral(String(c.value));
-            }
-            return { key: c.key, value };
+export function generateEnumSourceMap(enumDef, generatedFile, phpFile, outputDir) {
+    const mappings = [];
+    // Map enum declaration to its source location
+    if (enumDef.loc) {
+        mappings.push({
+            generatedLine: 2, // Line after JSDoc comment
+            generatedColumn: 0,
+            sourceLine: enumDef.loc.line,
+            sourceColumn: enumDef.loc.column || 0,
         });
-        nodes.push(createConstObject(enumDef.name, properties));
     }
-    // Add export default {}
-    nodes.push(createExportDefault(ts.factory.createObjectLiteralExpression([])));
-    return nodes.map(printNode).join('\n\n') + '\n';
+    // Map each enum case to its source location
+    const hasLabels = enumDef.cases.some((c) => c.label);
+    let currentLine = 3; // Start after "export enum Name {" or "export declare const Name: {"
+    for (const enumCase of enumDef.cases) {
+        if (enumCase.loc) {
+            mappings.push({
+                generatedLine: currentLine,
+                generatedColumn: 4, // Indented
+                sourceLine: enumCase.loc.line,
+                sourceColumn: enumCase.loc.column || 0,
+            });
+        }
+        // For labeled enums, each case takes multiple lines
+        currentLine += hasLabels ? 4 : 1;
+    }
+    // Calculate relative path from output dir to PHP file
+    const relativeSource = relative(outputDir, join(process.cwd(), phpFile)).replace(/\\/g, '/');
+    return generateSourceMap({
+        file: generatedFile,
+        sources: [relativeSource],
+        mappings,
+    });
+}
+/**
+ * Generate runtime JavaScript for a single enum.
+ */
+export function generateSingleEnumRuntime(enumDef, prettyPrint = true) {
+    const hasLabels = enumDef.cases.some((c) => c.label);
+    const properties = enumDef.cases.map((c) => {
+        let value;
+        if (hasLabels) {
+            value = createObjectLiteral([
+                { key: 'value', value: createStringLiteral(String(c.value)) },
+                { key: 'label', value: createStringLiteral(c.label || String(c.value)) },
+            ], prettyPrint);
+        }
+        else if (typeof c.value === 'number') {
+            value = createNumericLiteral(c.value);
+        }
+        else {
+            value = createStringLiteral(String(c.value));
+        }
+        return { key: c.key, value };
+    });
+    return printNode(createConstObject(enumDef.name, properties)) + '\n';
 }
 /**
  * Collect all enum definitions from the enums directory.
  * This is a plugin-level function that handles file I/O.
  */
-export function collectEnums(enumsDir) {
+export function collectEnums(enumsDir, cwd) {
     const enums = {};
     if (!existsSync(enumsDir)) {
         return enums;
@@ -79,7 +115,9 @@ export function collectEnums(enumsDir) {
             const content = readFileSafe(enumPath);
             if (!content)
                 continue;
-            const def = parseEnumContent(content);
+            // Calculate relative path from project root for source mapping
+            const relativePhpPath = relative(cwd, enumPath);
+            const def = parseEnumContent(content, relativePhpPath);
             if (def) {
                 enums[def.name] = def;
             }
@@ -95,17 +133,34 @@ export function collectEnums(enumsDir) {
  * Generate enum files (TypeScript declarations and runtime JavaScript).
  */
 export function generateEnums(options) {
-    const { enumsDir, outputDir, packageName, prettyPrint = true } = options;
+    const { enumsDir, outputDir, packageName, prettyPrint = true, cwd } = options;
+    // Clean existing generated files
+    cleanOutputDir(outputDir);
     // Collect all enums
-    const enums = collectEnums(enumsDir);
-    // Generate TypeScript declarations
-    const dtsContent = generateEnumTypeScript(enums);
-    const dtsPath = join(outputDir, 'index.d.ts');
-    writeFileEnsureDir(dtsPath, dtsContent);
-    // Generate runtime JavaScript
-    const jsContent = generateEnumRuntime(enums, prettyPrint);
-    const jsPath = join(outputDir, 'index.js');
-    writeFileEnsureDir(jsPath, jsContent);
+    const enums = collectEnums(enumsDir, cwd);
+    const enumNames = Object.keys(enums);
+    // Generate individual files for each enum
+    for (const enumName of enumNames) {
+        const enumDef = enums[enumName];
+        const phpFile = enumDef.loc?.file;
+        // Generate {EnumName}.d.ts with JSDoc and source map comment
+        const dtsContent = generateSingleEnumTypeScript(enumDef, phpFile);
+        writeFileEnsureDir(join(outputDir, `${enumName}.d.ts`), dtsContent);
+        // Generate {EnumName}.d.ts.map
+        if (phpFile) {
+            const sourceMap = generateEnumSourceMap(enumDef, `${enumName}.d.ts`, phpFile, outputDir);
+            writeFileEnsureDir(join(outputDir, `${enumName}.d.ts.map`), sourceMap);
+        }
+        // Generate {EnumName}.js
+        const jsContent = generateSingleEnumRuntime(enumDef, prettyPrint);
+        writeFileEnsureDir(join(outputDir, `${enumName}.js`), jsContent);
+    }
+    // Generate barrel index.d.ts
+    const indexDts = enumNames.map((n) => `export { ${n} } from './${n}.js';`).join('\n') + '\n';
+    writeFileEnsureDir(join(outputDir, 'index.d.ts'), indexDts);
+    // Generate barrel index.js
+    const indexJs = enumNames.map((n) => `export { ${n} } from './${n}.js';`).join('\n') + '\n';
+    writeFileEnsureDir(join(outputDir, 'index.js'), indexJs);
     // Generate package.json
     const pkgJson = JSON.stringify({
         name: packageName,

package/dist/generators/resources.d.ts

@@ -6,12 +6,17 @@ export type ResourceGeneratorOptions = {
     outputDir: string;
     packageName: string;
     prettyPrint?: boolean;
+    cwd: string;
 };
 export type FieldInfo = ResourceFieldInfo;
 /**
- * Generate TypeScript type declarations for resources.
+ * Generate TypeScript type declaration for a single resource.
  */
-export declare function generateResourceTypeScript(resources: Record<string, Record<string, ResourceFieldInfo>>, fallbacks: string[], referencedEnums: Set<string>): string;
+export declare function generateSingleResourceTypeScript(className: string, fields: Record<string, ResourceFieldInfo>, isFallback: boolean, referencedEnums: Set<string>, phpFile?: string): string;
+/**
+ * Generate source map for a single resource.
+ */
+export declare function generateResourceSourceMap(className: string, fields: Record<string, ResourceFieldInfo>, generatedFile: string, phpFile: string, outputDir: string, hasEnumImports: boolean): string;
 /**
  * Generate runtime JavaScript for resources.
  * Resources are type-only, so this just exports an empty object.

package/dist/generators/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/generators/resources.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAUhC,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAGF,MAAM,MAAM,SAAS,GAAG,iBAAiB,CAAC;AAE1C;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAC5D,SAAS,EAAE,MAAM,EAAE,EACnB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAC3B,MAAM,CAuCR;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAoEzE"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/generators/resources.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAehC,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAGF,MAAM,MAAM,SAAS,GAAG,iBAAiB,CAAC;AAE1C;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACzC,UAAU,EAAE,OAAO,EACnB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,EAC5B,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAuDR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACzC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,OAAO,GACtB,MAAM,CAiCR;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAmHzE"}

package/dist/generators/resources.js

@@ -1,32 +1,40 @@
 import ts from 'typescript';
 import { existsSync } from 'node:fs';
-import { join, parse } from 'node:path';
-import { getPhpFiles, readFileSafe, writeFileEnsureDir } from '../utils/file.js';
+import { join, parse, relative } from 'node:path';
+import { getPhpFiles, readFileSafe, writeFileEnsureDir, cleanOutputDir } from '../utils/file.js';
 import { extractDocblockArrayShape, parseResourceFieldsAst, } from '../utils/php-parser.js';
 import { mapDocTypeToTs } from '../utils/type-mapper.js';
 import { printNode, createTypeAlias, createImportType, parseTypeString, createTypeLiteral, } from '../utils/ts-generator.js';
+import { generateSourceMap, createSourceMapComment, } from '../utils/source-map.js';
 /**
- * Generate TypeScript type declarations for resources.
+ * Generate TypeScript type declaration for a single resource.
  */
-export function generateResourceTypeScript(resources, fallbacks, referencedEnums) {
+export function generateSingleResourceTypeScript(className, fields, isFallback, referencedEnums, phpFile) {
     const nodes = [];
+    // Find which enums this resource actually uses
+    const usedEnums = new Set();
+    for (const info of Object.values(fields)) {
+        const type = info.type || '';
+        for (const enumName of referencedEnums) {
+            if (type.includes(enumName)) {
+                usedEnums.add(enumName);
+            }
+        }
+    }
     // Import referenced enums from @app/enums
-    if (referencedEnums.size > 0) {
-        const enumImports = Array.from(referencedEnums).sort();
+    if (usedEnums.size > 0) {
+        const enumImports = Array.from(usedEnums).sort();
         nodes.push(createImportType(enumImports, '@app/enums'));
     }
-    // Generate resource types
-    for (const className of Object.keys(resources)) {
-        const fields = resources[className];
-        if (fallbacks.includes(className)) {
-            // Fallback type: Record<string, any>
-            const recordType = ts.factory.createTypeReferenceNode(ts.factory.createIdentifier('Record'), [
-                ts.factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword),
-                ts.factory.createKeywordTypeNode(ts.SyntaxKind.AnyKeyword),
-            ]);
-            nodes.push(createTypeAlias(className, recordType));
-            continue;
-        }
+    if (isFallback) {
+        // Fallback type: Record<string, any>
+        const recordType = ts.factory.createTypeReferenceNode(ts.factory.createIdentifier('Record'), [
+            ts.factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword),
+            ts.factory.createKeywordTypeNode(ts.SyntaxKind.AnyKeyword),
+        ]);
+        nodes.push(createTypeAlias(className, recordType));
+    }
+    else {
         // Create type literal with all fields
         const properties = Object.keys(fields).map((key) => {
             const info = fields[key];
@@ -38,9 +46,49 @@ export function generateResourceTypeScript(resources, fallbacks, referencedEnums
         });
         nodes.push(createTypeAlias(className, createTypeLiteral(properties)));
     }
-    if (nodes.length === 0)
-        return '';
-    return nodes.map(printNode).join('\n\n') + '\n';
+    const lines = [];
+    // Add JSDoc with source reference
+    if (phpFile) {
+        lines.push(`/** @see ${phpFile} */`);
+    }
+    lines.push(nodes.map(printNode).join('\n\n'));
+    // Add source map comment
+    if (phpFile) {
+        lines.push(createSourceMapComment(`${className}.d.ts.map`));
+    }
+    return lines.join('\n') + '\n';
+}
+/**
+ * Generate source map for a single resource.
+ */
+export function generateResourceSourceMap(className, fields, generatedFile, phpFile, outputDir, hasEnumImports) {
+    const mappings = [];
+    // Calculate base line (after JSDoc comment and optional import)
+    let currentLine = 2; // Start after JSDoc comment
+    if (hasEnumImports) {
+        currentLine += 2; // Import statement + blank line
+    }
+    // Map each field to its source location
+    const fieldKeys = Object.keys(fields);
+    for (let i = 0; i < fieldKeys.length; i++) {
+        const key = fieldKeys[i];
+        const info = fields[key];
+        if (info.loc) {
+            mappings.push({
+                generatedLine: currentLine + 1 + i, // +1 for the "export type X = {" line
+                generatedColumn: 4, // Indented
+                sourceLine: info.loc.line,
+                sourceColumn: info.loc.column || 0,
+            });
+        }
+    }
+    // Calculate relative path from output dir to PHP file
+    const relativeSource = relative(outputDir, join(process.cwd(), phpFile)).replace(/\\/g, '/');
+    return generateSourceMap({
+        file: generatedFile,
+        sources: [relativeSource],
+        mappings,
+    });
 }
 /**
  * Generate runtime JavaScript for resources.
@@ -53,9 +101,12 @@ export function generateResourceRuntime() {
  * Generate resource type files (TypeScript declarations and runtime JavaScript).
  */
 export function generateResources(options) {
-    const { resourcesDir, enumsDir, modelsDir, outputDir, packageName } = options;
+    const { resourcesDir, enumsDir, modelsDir, outputDir, packageName, cwd } = options;
+    // Clean existing generated files
+    cleanOutputDir(outputDir);
     const collectedEnums = {};
     const resources = {};
+    const resourcePhpFiles = {};
     const fallbacks = [];
     if (!existsSync(resourcesDir)) {
         console.warn(`Resources directory not found: ${resourcesDir}`);
@@ -67,6 +118,8 @@ export function generateResources(options) {
             const filePath = join(resourcesDir, file);
             const content = readFileSafe(filePath) || '';
             const className = parse(file).name;
+            // Calculate relative path from project root for source mapping
+            const relativePhpPath = relative(cwd, filePath);
             const docShape = extractDocblockArrayShape(content);
             const mappedDocShape = docShape ? mapDocTypeToTsForShape(docShape) : null;
             const fields = parseResourceFieldsAst(content, {
@@ -75,6 +128,7 @@ export function generateResources(options) {
                 enumsDir,
                 docShape: mappedDocShape,
                 collectedEnums,
+                filePath: relativePhpPath,
             });
             if (!fields) {
                 fallbacks.push(className);
@@ -83,6 +137,7 @@ export function generateResources(options) {
             else {
                 resources[className] = fields;
             }
+            resourcePhpFiles[className] = relativePhpPath;
         }
         catch (e) {
             console.warn(`Failed to parse resource file: ${file}`, e);
@@ -90,14 +145,40 @@ export function generateResources(options) {
     }
     // Track which enums are actually referenced
     const referencedEnums = new Set(Object.keys(collectedEnums));
-    // Generate TypeScript declarations
-    const dtsContent = generateResourceTypeScript(resources, fallbacks, referencedEnums);
-    const dtsPath = join(outputDir, 'index.d.ts');
-    writeFileEnsureDir(dtsPath, dtsContent);
-    // Generate runtime JavaScript
-    const jsContent = generateResourceRuntime();
-    const jsPath = join(outputDir, 'index.js');
-    writeFileEnsureDir(jsPath, jsContent);
+    const resourceNames = Object.keys(resources);
+    // Generate individual files for each resource
+    for (const className of resourceNames) {
+        const fields = resources[className];
+        const isFallback = fallbacks.includes(className);
+        const phpFile = resourcePhpFiles[className];
+        // Check if this resource has enum imports
+        const usedEnums = new Set();
+        for (const info of Object.values(fields)) {
+            const type = info.type || '';
+            for (const enumName of referencedEnums) {
+                if (type.includes(enumName)) {
+                    usedEnums.add(enumName);
+                }
+            }
+        }
+        const hasEnumImports = usedEnums.size > 0;
+        // Generate {ResourceName}.d.ts with JSDoc and source map comment
+        const dtsContent = generateSingleResourceTypeScript(className, fields, isFallback, referencedEnums, phpFile);
+        writeFileEnsureDir(join(outputDir, `${className}.d.ts`), dtsContent);
+        // Generate {ResourceName}.d.ts.map
+        if (phpFile && !isFallback) {
+            const sourceMap = generateResourceSourceMap(className, fields, `${className}.d.ts`, phpFile, outputDir, hasEnumImports);
+            writeFileEnsureDir(join(outputDir, `${className}.d.ts.map`), sourceMap);
+        }
+        // Generate {ResourceName}.js (empty export for type-only)
+        writeFileEnsureDir(join(outputDir, `${className}.js`), 'export {};\n');
+    }
+    // Generate barrel index.d.ts
+    const indexDts = resourceNames.map((n) => `export type { ${n} } from './${n}.js';`).join('\n') + '\n';
+    writeFileEnsureDir(join(outputDir, 'index.d.ts'), indexDts);
+    // Generate barrel index.js
+    const indexJs = resourceNames.map((n) => `export * from './${n}.js';`).join('\n') + '\n';
+    writeFileEnsureDir(join(outputDir, 'index.js'), indexJs);
     // Generate package.json
     const pkgJson = JSON.stringify({
         name: packageName,

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAMnC,MAAM,MAAM,0BAA0B,GAAG;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,OAAO,GAAE,0BAA+B,GAAG,MAAM,CAyF9E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAMnC,MAAM,MAAM,0BAA0B,GAAG;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,OAAO,GAAE,0BAA+B,GAAG,MAAM,CA6F9E"}

package/dist/index.js

@@ -34,6 +34,7 @@ export default function ferry(options = {}) {
             outputDir: enumsOutputDir,
             packageName: `${namespace}/enums`,
             prettyPrint,
+            cwd,
         });
         // Generate @app/resources package
         generateResources({
@@ -43,6 +44,7 @@ export default function ferry(options = {}) {
             outputDir: resourcesOutputDir,
             packageName: `${namespace}/resources`,
             prettyPrint,
+            cwd,
         });
     }
     return {
@@ -78,6 +80,7 @@ export default function ferry(options = {}) {
                 enumsDir,
                 outputDir: enumsOutputDir,
                 packageName: `${namespace}/enums`,
+                cwd,
                 server,
             });
             // Set up resource watcher
@@ -87,6 +90,7 @@ export default function ferry(options = {}) {
                 modelsDir,
                 outputDir: resourcesOutputDir,
                 packageName: `${namespace}/resources`,
+                cwd,
                 server,
             });
         },

package/dist/utils/file.d.ts

@@ -10,4 +10,8 @@ export declare function writeFileEnsureDir(filePath: string, content: string): v
  * Get all PHP files from a directory.
  */
 export declare function getPhpFiles(dir: string): string[];
+/**
+ * Clean generated files from output directory, keeping package.json.
+ */
+export declare function cleanOutputDir(outputDir: string): void;
 //# sourceMappingURL=file.d.ts.map

package/dist/utils/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/utils/file.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI1E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjD"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/utils/file.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI1E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAStD"}

package/dist/utils/file.js

@@ -1,5 +1,5 @@
-import { existsSync, readFileSync, mkdirSync, writeFileSync, readdirSync } from 'node:fs';
-import { dirname } from 'node:path';
+import { existsSync, readFileSync, mkdirSync, writeFileSync, readdirSync, unlinkSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 /**
  * Safely read a file, returning null if it doesn't exist or can't be read.
  */
@@ -28,3 +28,16 @@ export function getPhpFiles(dir) {
     }
     return readdirSync(dir).filter((f) => f.endsWith('.php'));
 }
+/**
+ * Clean generated files from output directory, keeping package.json.
+ */
+export function cleanOutputDir(outputDir) {
+    if (!existsSync(outputDir))
+        return;
+    const files = readdirSync(outputDir);
+    for (const file of files) {
+        if (file.endsWith('.d.ts') || file.endsWith('.js') || file.endsWith('.d.ts.map')) {
+            unlinkSync(join(outputDir, file));
+        }
+    }
+}

package/dist/utils/php-parser.d.ts

@@ -1,18 +1,25 @@
+export type SourceLocation = {
+    file: string;
+    line: number;
+    column?: number;
+};
 export type EnumCase = {
     key: string;
     value: string | number;
     label?: string;
+    loc?: SourceLocation;
 };
 export type EnumDefinition = {
     name: string;
     backing: string | null;
     cases: EnumCase[];
+    loc?: SourceLocation;
 };
 /**
  * Parse PHP enum content and extract its definition.
  * This is a pure function that takes PHP source code as input.
  */
-export declare function parseEnumContent(phpContent: string): EnumDefinition | null;
+export declare function parseEnumContent(phpContent: string, filePath?: string): EnumDefinition | null;
 /**
  * Parse model casts from PHP model content.
  * This is a pure function that takes PHP source code as input.
@@ -26,6 +33,7 @@ export declare function extractDocblockArrayShape(phpContent: string): Record<st
 export type ResourceFieldInfo = {
     type: string;
     optional: boolean;
+    loc?: SourceLocation;
 };
 export type ResourceArrayEntry = {
     key: string;
@@ -39,6 +47,7 @@ export type ParseResourceOptions = {
     docShape?: Record<string, string> | null;
     collectedEnums?: Record<string, EnumDefinition>;
     resourceClass?: string;
+    filePath?: string;
 };
 /**
  * Parse resource fields from PHP content using AST.

package/dist/utils/php-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"php-parser.d.ts","sourceRoot":"","sources":["../../src/utils/php-parser.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,CAAC;AA6FF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAsF1E;AA4CD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwC1E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAwE3F;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AA8RF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,eAAe,CAAM,GACxD,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAqC1C"}
+{"version":3,"file":"php-parser.d.ts","sourceRoot":"","sources":["../../src/utils/php-parser.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB,CAAC;AA6FF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAgG7F;AA4CD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwC1E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAwE3F;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAgTF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,eAAe,CAAM,GACxD,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAqC1C"}

package/dist/utils/php-parser.js

@@ -13,7 +13,7 @@ const parser = new PhpParser({
         php8: true,
     },
     ast: {
-        withPositions: false,
+        withPositions: true,
     },
 });
 /**
@@ -108,7 +108,7 @@ function getStringValue(node) {
  * Parse PHP enum content and extract its definition.
  * This is a pure function that takes PHP source code as input.
  */
-export function parseEnumContent(phpContent) {
+export function parseEnumContent(phpContent, filePath) {
     const ast = parsePhp(phpContent);
     if (!ast)
         return null;
@@ -118,6 +118,10 @@ export function parseEnumContent(phpContent) {
         return null;
     const name = typeof enumNode.name === 'string' ? enumNode.name : enumNode.name.name;
     const backing = enumNode.valueType ? enumNode.valueType.name.toLowerCase() : null;
+    // Capture enum location
+    const enumLoc = filePath && enumNode.loc?.start
+        ? { file: filePath, line: enumNode.loc.start.line, column: enumNode.loc.start.column }
+        : undefined;
     // Extract enum cases
     const cases = [];
     const enumCases = findAllNodesByKind(enumNode, 'enumcase');
@@ -147,7 +151,11 @@ export function parseEnumContent(phpContent) {
         else {
             value = key;
         }
-        cases.push({ key, value });
+        // Capture case location
+        const caseLoc = filePath && enumCase.loc?.start
+            ? { file: filePath, line: enumCase.loc.start.line, column: enumCase.loc.start.column }
+            : undefined;
+        cases.push({ key, value, loc: caseLoc });
     }
     // Parse label() method if it exists
     const methods = findAllNodesByKind(enumNode, 'method');
@@ -186,7 +194,7 @@ export function parseEnumContent(phpContent) {
             }
         }
     }
-    return { name, backing, cases };
+    return { name, backing, cases, loc: enumLoc };
 }
 /**
  * Extract key-value pairs from a PHP array node.
@@ -474,13 +482,20 @@ function inferTypeFromAstNode(node, key, options = {}) {
             if (resource === 'Collection') {
                 return { type: 'any[]', optional };
             }
-            // Resource::collection or Resource::make returns Resource[]
-            if (method === 'collection' || method === 'make') {
+            // Resource::collection returns Resource[] (array of resources)
+            if (method === 'collection') {
                 if (resourceExists(resource, resourcesDir)) {
                     return { type: `${resource}[]`, optional };
                 }
                 return { type: 'any[]', optional };
             }
+            // Resource::make returns a single Resource
+            if (method === 'make') {
+                if (resourceExists(resource, resourcesDir)) {
+                    return { type: resource, optional };
+                }
+                return { type: 'any', optional };
+            }
         }
         // Check if it's a whenLoaded call without a wrapper resource
         if (call.what.kind === 'propertylookup') {
@@ -572,6 +587,7 @@ function inferTypeFromAstNode(node, key, options = {}) {
  */
 function parseArrayEntries(items, options = {}) {
     const result = {};
+    const { filePath } = options;
     for (const item of items) {
         if (item.kind !== 'entry')
             continue;
@@ -582,6 +598,14 @@ function parseArrayEntries(items, options = {}) {
         if (!key)
             continue;
         const fieldInfo = inferTypeFromAstNode(entry.value, key, options);
+        // Capture field location from the entry key
+        if (filePath && entry.key.loc?.start) {
+            fieldInfo.loc = {
+                file: filePath,
+                line: entry.key.loc.start.line,
+                column: entry.key.loc.start.column,
+            };
+        }
         result[key] = { key, fieldInfo };
         // Handle nested arrays
         if (entry.value.kind === 'array') {

package/dist/utils/source-map.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Source map generation utilities.
+ * Implements the Source Map v3 format with VLQ encoding.
+ */
+export type SourceMapping = {
+    generatedLine: number;
+    generatedColumn: number;
+    sourceLine: number;
+    sourceColumn: number;
+    name?: string;
+};
+export type SourceMapOptions = {
+    file: string;
+    sourceRoot?: string;
+    sources: string[];
+    sourcesContent?: (string | null)[];
+    names?: string[];
+    mappings: SourceMapping[];
+};
+/**
+ * Generate a source map JSON string.
+ */
+export declare function generateSourceMap(options: SourceMapOptions): string;
+/**
+ * Create the sourceMappingURL comment to append to generated files.
+ */
+export declare function createSourceMapComment(mapFileName: string): string;
+/**
+ * Calculate relative path from one file to another.
+ * Used to compute the source path relative to the generated .d.ts.map file.
+ */
+export declare function relativePath(from: string, to: string): string;
+//# sourceMappingURL=source-map.d.ts.map

package/dist/utils/source-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-map.d.ts","sourceRoot":"","sources":["../../src/utils/source-map.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAqFF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAcnE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAmB7D"}

package/dist/utils/source-map.js

@@ -0,0 +1,105 @@
+/**
+ * Source map generation utilities.
+ * Implements the Source Map v3 format with VLQ encoding.
+ */
+const BASE64_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+/**
+ * Encode a single number as VLQ (Variable Length Quantity).
+ */
+function encodeVLQ(value) {
+    let result = '';
+    let vlq = value < 0 ? (-value << 1) | 1 : value << 1;
+    do {
+        let digit = vlq & 0x1f;
+        vlq >>>= 5;
+        if (vlq > 0) {
+            digit |= 0x20; // continuation bit
+        }
+        result += BASE64_CHARS[digit];
+    } while (vlq > 0);
+    return result;
+}
+/**
+ * Encode a source map segment.
+ * Each segment contains: generatedColumn, sourceIndex, sourceLine, sourceColumn, [nameIndex]
+ */
+function encodeSegment(generatedColumn, sourceIndex, sourceLine, sourceColumn, prevState) {
+    const result = encodeVLQ(generatedColumn - prevState.genCol) +
+        encodeVLQ(sourceIndex - prevState.srcIdx) +
+        encodeVLQ(sourceLine - prevState.srcLine) +
+        encodeVLQ(sourceColumn - prevState.srcCol);
+    prevState.genCol = generatedColumn;
+    prevState.srcIdx = sourceIndex;
+    prevState.srcLine = sourceLine;
+    prevState.srcCol = sourceColumn;
+    return result;
+}
+/**
+ * Generate VLQ-encoded mappings string from mapping entries.
+ */
+function encodeMappings(mappings) {
+    if (mappings.length === 0)
+        return '';
+    // Sort by generated line, then column
+    const sorted = [...mappings].sort((a, b) => {
+        if (a.generatedLine !== b.generatedLine)
+            return a.generatedLine - b.generatedLine;
+        return a.generatedColumn - b.generatedColumn;
+    });
+    const lines = [];
+    const state = { genCol: 0, srcIdx: 0, srcLine: 0, srcCol: 0 };
+    for (const mapping of sorted) {
+        // Ensure we have enough lines
+        while (lines.length < mapping.generatedLine) {
+            lines.push([]);
+            state.genCol = 0; // Reset column at start of each line
+        }
+        const lineIndex = mapping.generatedLine - 1;
+        const segment = encodeSegment(mapping.generatedColumn, 0, // sourceIndex - always 0 since we have one source file per map
+        mapping.sourceLine - 1, // 0-indexed in source maps
+        mapping.sourceColumn, state);
+        lines[lineIndex].push(segment);
+    }
+    return lines.map((segments) => segments.join(',')).join(';');
+}
+/**
+ * Generate a source map JSON string.
+ */
+export function generateSourceMap(options) {
+    const { file, sourceRoot = '', sources, sourcesContent, names = [], mappings } = options;
+    const map = {
+        version: 3,
+        file,
+        sourceRoot,
+        sources,
+        ...(sourcesContent ? { sourcesContent } : {}),
+        names,
+        mappings: encodeMappings(mappings),
+    };
+    return JSON.stringify(map);
+}
+/**
+ * Create the sourceMappingURL comment to append to generated files.
+ */
+export function createSourceMapComment(mapFileName) {
+    return `//# sourceMappingURL=${mapFileName}`;
+}
+/**
+ * Calculate relative path from one file to another.
+ * Used to compute the source path relative to the generated .d.ts.map file.
+ */
+export function relativePath(from, to) {
+    const fromParts = from.split('/').slice(0, -1); // Remove filename
+    const toParts = to.split('/');
+    // Find common prefix
+    let commonLength = 0;
+    while (commonLength < fromParts.length &&
+        commonLength < toParts.length &&
+        fromParts[commonLength] === toParts[commonLength]) {
+        commonLength++;
+    }
+    // Build relative path
+    const ups = fromParts.length - commonLength;
+    const remaining = toParts.slice(commonLength);
+    return [...Array(ups).fill('..'), ...remaining].join('/');
+}

package/dist/watchers/enums.js

@@ -5,7 +5,7 @@ import { logError, logFileChange, logRegeneration } from '../utils/banner.js';
  * Set up a watcher for enum files.
  */
 export function setupEnumWatcher(options) {
-    const { enumsDir, outputDir, packageName, server } = options;
+    const { enumsDir, outputDir, packageName, cwd, server } = options;
     const enumPattern = join(enumsDir, '*.php');
     const generatedJsPath = join(outputDir, 'index.js');
     // Watch PHP enum files
@@ -17,7 +17,7 @@ export function setupEnumWatcher(options) {
             try {
                 logFileChange('enums', basename(filePath));
                 // Regenerate enum files
-                generateEnums({ enumsDir, outputDir, packageName });
+                generateEnums({ enumsDir, outputDir, packageName, cwd });
                 // Tell Vite the generated file changed (triggers normal HMR)
                 server.watcher.emit('change', generatedJsPath);
                 logRegeneration('enums');

package/dist/watchers/resources.js

@@ -5,7 +5,7 @@ import { logError, logFileChange, logRegeneration } from '../utils/banner.js';
  * Set up a watcher for resource and model files.
  */
 export function setupResourceWatcher(options) {
-    const { resourcesDir, enumsDir, modelsDir, outputDir, packageName, server } = options;
+    const { resourcesDir, enumsDir, modelsDir, outputDir, packageName, cwd, server } = options;
     const resourcePattern = join(resourcesDir, '*.php');
     const modelPattern = join(modelsDir, '*.php');
     const generatedDtsPath = join(outputDir, 'index.d.ts');
@@ -21,7 +21,7 @@ export function setupResourceWatcher(options) {
                 const fileType = isModel ? 'model' : 'resource';
                 logFileChange(fileType, basename(filePath));
                 // Regenerate resource types
-                generateResources({ resourcesDir, enumsDir, modelsDir, outputDir, packageName });
+                generateResources({ resourcesDir, enumsDir, modelsDir, outputDir, packageName, cwd });
                 // Tell Vite the generated type file changed
                 // TypeScript will pick up changes automatically
                 server.watcher.emit('change', generatedDtsPath);

package/package.json

@@ -3,7 +3,7 @@
   "prettier": "@aniftyco/prettier",
   "description": "Ferries Laravel types to your TypeScript frontend",
   "type": "module",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "repository": "https://github.com/aniftyco/vite-plugin-ferry",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",