@remix-run/assets 0.1.0 → 0.3.0

package/dist/lib/asset-server.js

@@ -1,27 +1,17 @@
 import * as path from 'node:path';
 import * as fs from 'node:fs';
-import { isAssetServerCompilationError } from "./compilation-error.js";
 import { createAccessPolicy } from "./access.js";
-import { createModuleCompiler, createResponseForModule } from "./scripts/compiler.js";
-import { normalizeFilePath } from "./paths.js";
+import { isAssetServerCompilationError } from "./compilation-error.js";
+import { getFingerprintRequestCacheControl, parseFingerprintSuffix } from "./fingerprint.js";
+import { getInjectedPackageRouteConfigs } from "./injected-packages.js";
+import { normalizeFilePath, normalizePathname } from "./paths.js";
 import { compileRoutes } from "./routes.js";
+import { createResponseForScript, createScriptCompiler } from "./scripts/compiler.js";
+import { supportedScriptExtensions } from "./scripts/resolve.js";
+import { createResponseForStyle, createStyleCompiler, isStyleFilePath } from "./styles/compiler.js";
+import { resolveScriptTarget, resolveStyleTarget } from "./target.js";
 import { createAssetServerWatcher } from "./watch.js";
-const scriptTargets = [
-    'es2015',
-    'es2016',
-    'es2017',
-    'es2018',
-    'es2019',
-    'es2020',
-    'es2021',
-    'es2022',
-    'es2023',
-    'es2024',
-    'es2025',
-    'es2026',
-    'esnext',
-];
-const scriptTargetSet = new Set(scriptTargets);
+const scriptExtensionSet = new Set(supportedScriptExtensions);
 const chokidarWatcherByAssetServer = new WeakMap();
 const watcherByAssetServer = new WeakMap();
 export function getInternalChokidarWatcher(assetServer) {
@@ -33,8 +23,8 @@ export function getInternalWatchTargets(assetServer) {
 /**
  * Create an asset server instance
  *
- * Compiles TypeScript/JavaScript modules on demand with optional source-based URL
- * fingerprinting, caching, and configurable file mapping.
+ * Compiles TypeScript/JavaScript scripts and CSS styles on demand with optional
+ * source-based URL fingerprinting, caching, and configurable file mapping.
  *
  * @param options Server configuration
  * @returns A {@link AssetServer} with `fetch()`, `getHref()`, and `getPreloads()` methods
@@ -42,8 +32,9 @@ export function getInternalWatchTargets(assetServer) {
  * @example
  * ```ts
  * let assetServer = createAssetServer({
+ *   basePath: '/assets',
  *   fileMap: {
- *     '/assets/app/*path': 'app/*path',
+ *     '/app/*path': 'app/*path',
  *   },
  *   allow: ['app/**'],
  * })
@@ -60,11 +51,11 @@ export function createAssetServer(options) {
     });
     let watcher = null;
     let chokidarWatcher = null;
-    let moduleCompiler = createModuleCompiler({
+    let scriptCompiler = createScriptCompiler({
         buildId: resolvedOptions.buildId,
         define: resolvedOptions.define,
         external: resolvedOptions.external,
-        fingerprintModules: resolvedOptions.fingerprintModules,
+        fingerprintAssets: resolvedOptions.fingerprintAssets,
         isAllowed: accessPolicy.isAllowed,
         minify: resolvedOptions.minify,
         onWatchDirectoriesChange: (delta) => {
@@ -80,6 +71,23 @@ export function createAssetServer(options) {
         watchIgnore: resolvedOptions.watchOptions?.ignore,
         watchMode: resolvedOptions.watchOptions !== null,
     });
+    let styleCompiler = createStyleCompiler({
+        buildId: resolvedOptions.buildId,
+        fingerprintAssets: resolvedOptions.fingerprintAssets,
+        isAllowed: accessPolicy.isAllowed,
+        minify: resolvedOptions.minify,
+        onWatchDirectoriesChange: (delta) => {
+            if (!watcher)
+                return;
+            watcher.updateWatchedDirectories(delta);
+        },
+        rootDir: resolvedOptions.rootDir,
+        routes: resolvedOptions.routes,
+        sourceMapSourcePaths: resolvedOptions.sourceMapSourcePaths,
+        sourceMaps: resolvedOptions.sourceMaps,
+        targets: resolvedOptions.stylesTarget,
+        watchIgnore: resolvedOptions.watchOptions?.ignore,
+    });
     if (resolvedOptions.watchOptions) {
         watcher = createAssetServerWatcher({
             ...resolvedOptions.watchOptions,
@@ -102,7 +110,8 @@ export function createAssetServer(options) {
     async function handleWatchEvent(filePath, event) {
         try {
             let normalizedFilePath = normalizeFilePath(filePath);
-            await moduleCompiler.handleFileEvent(normalizedFilePath, event);
+            await scriptCompiler.handleFileEvent(normalizedFilePath, event);
+            await styleCompiler.handleFileEvent(normalizedFilePath, event);
         }
         catch (error) {
             console.error(`There was an error invalidating the asset server cache: ${error}`);
@@ -112,28 +121,58 @@ export function createAssetServer(options) {
         async fetch(request) {
             if (request.method !== 'GET' && request.method !== 'HEAD')
                 return null;
-            let parsedRequestPathname = moduleCompiler.parseRequestPathname(new URL(request.url).pathname);
+            let parsedRequestPathname = parseAssetRequestPathname(new URL(request.url).pathname, {
+                fingerprintAssets: resolvedOptions.fingerprintAssets,
+                routes: resolvedOptions.routes,
+            });
             if (!parsedRequestPathname)
                 return null;
             try {
                 let ifNoneMatch = request.headers.get('If-None-Match');
-                let moduleResult = await moduleCompiler.getModule(parsedRequestPathname.filePath, {
+                if (isStyleFilePath(parsedRequestPathname.filePath)) {
+                    let styleResult = await styleCompiler.getStyle(parsedRequestPathname.filePath, {
+                        ifNoneMatch,
+                        isSourceMapRequest: parsedRequestPathname.isSourceMapRequest,
+                        requestedFingerprint: parsedRequestPathname.requestedFingerprint,
+                    });
+                    if (styleResult.type === 'not-modified') {
+                        return new Response(null, {
+                            status: 304,
+                            headers: { ETag: styleResult.etag },
+                        });
+                    }
+                    let compiledStyle = styleResult.style;
+                    if (parsedRequestPathname.requestedFingerprint !== null) {
+                        if (compiledStyle.fingerprint !== parsedRequestPathname.requestedFingerprint)
+                            return null;
+                    }
+                    return createResponseForStyle(compiledStyle, {
+                        cacheControl: parsedRequestPathname.cacheControl,
+                        ifNoneMatch,
+                        isSourceMapRequest: parsedRequestPathname.isSourceMapRequest,
+                        method: request.method,
+                    });
+                }
+                if (!isScriptFilePath(parsedRequestPathname.filePath)) {
+                    return null;
+                }
+                let scriptResult = await scriptCompiler.getScript(parsedRequestPathname.filePath, {
                     ifNoneMatch,
                     isSourceMapRequest: parsedRequestPathname.isSourceMapRequest,
                     requestedFingerprint: parsedRequestPathname.requestedFingerprint,
                 });
-                if (moduleResult.type === 'not-modified') {
+                if (scriptResult.type === 'not-modified') {
                     return new Response(null, {
                         status: 304,
-                        headers: { ETag: moduleResult.etag },
+                        headers: { ETag: scriptResult.etag },
                     });
                 }
-                let compiledModule = moduleResult.module;
+                let compiledScript = scriptResult.script;
                 if (parsedRequestPathname.requestedFingerprint !== null) {
-                    if (compiledModule.fingerprint !== parsedRequestPathname.requestedFingerprint)
+                    if (compiledScript.fingerprint !== parsedRequestPathname.requestedFingerprint)
                         return null;
                 }
-                return createResponseForModule(compiledModule, {
+                return createResponseForScript(compiledScript, {
                     cacheControl: parsedRequestPathname.cacheControl,
                     ifNoneMatch,
                     isSourceMapRequest: parsedRequestPathname.isSourceMapRequest,
@@ -145,17 +184,45 @@ export function createAssetServer(options) {
                 // compiling imports. In this fetch context, both cases should fall through as "not
                 // handled here" so the outer router can continue to its own 404 behavior.
                 if (isAssetServerCompilationError(error) &&
-                    (error.code === 'MODULE_NOT_FOUND' || error.code === 'MODULE_NOT_ALLOWED')) {
+                    (error.code === 'FILE_NOT_FOUND' || error.code === 'FILE_NOT_ALLOWED')) {
                     return null;
                 }
                 return responseForError(error);
             }
         },
         async getHref(filePath) {
-            return moduleCompiler.getHref(filePath);
+            if (isStyleFilePath(filePath)) {
+                return styleCompiler.getHref(filePath);
+            }
+            return scriptCompiler.getHref(filePath);
         },
         async getPreloads(filePath) {
-            return moduleCompiler.getPreloadUrls(filePath);
+            let filePaths = Array.isArray(filePath) ? filePath : [filePath];
+            let styleFiles = [];
+            let scriptFiles = [];
+            for (let nextFilePath of filePaths) {
+                if (isStyleFilePath(nextFilePath)) {
+                    styleFiles.push(nextFilePath);
+                    continue;
+                }
+                scriptFiles.push(nextFilePath);
+            }
+            if (styleFiles.length === 0 && scriptFiles.length === 0) {
+                return [];
+            }
+            if (styleFiles.length === 0) {
+                return flattenPreloadLayers(await scriptCompiler.getPreloadLayers(filePath));
+            }
+            if (scriptFiles.length === 0) {
+                return flattenPreloadLayers(await styleCompiler.getPreloadLayers(filePath));
+            }
+            // Mixed asset type preloads need to be merged, so we merge in order of first asset type seen
+            let scriptPreloadLayersPromise = scriptCompiler.getPreloadLayers(scriptFiles);
+            let stylePreloadLayersPromise = styleCompiler.getPreloadLayers(styleFiles);
+            let preloadLayerGroups = isStyleFilePath(filePaths[0])
+                ? [stylePreloadLayersPromise, scriptPreloadLayersPromise]
+                : [scriptPreloadLayersPromise, stylePreloadLayersPromise];
+            return mergePreloadLayers(await Promise.all(preloadLayerGroups));
         },
         async close() {
             await watcher?.close();
@@ -175,11 +242,31 @@ function internalServerError() {
         headers: { 'Content-Type': 'text/plain; charset=utf-8' },
     });
 }
+function mergePreloadLayers(preloadLayersByRoot) {
+    let urls = [];
+    let seen = new Set();
+    let maxDepth = Math.max(0, ...preloadLayersByRoot.map((layers) => layers.length));
+    for (let depth = 0; depth < maxDepth; depth++) {
+        for (let preloadLayers of preloadLayersByRoot) {
+            for (let url of preloadLayers[depth] ?? []) {
+                if (seen.has(url))
+                    continue;
+                seen.add(url);
+                urls.push(url);
+            }
+        }
+    }
+    return urls;
+}
+function flattenPreloadLayers(preloadLayers) {
+    return preloadLayers.flatMap((layer) => layer);
+}
 function defaultErrorHandler(error) {
     console.error(error);
 }
 function resolveAssetServerOptions(options) {
     let rootDir = normalizeFilePath(fs.realpathSync(path.resolve(options.rootDir ?? process.cwd())));
+    let basePath = normalizeBasePath(options.basePath);
     let scriptOptions = options.scripts ?? {};
     let fingerprintOptions = normalizeFingerprintOptions({
         fingerprint: options.fingerprint,
@@ -187,31 +274,34 @@ function resolveAssetServerOptions(options) {
     });
     return {
         allow: options.allow,
+        basePath,
         buildId: fingerprintOptions.buildId,
         define: scriptOptions.define,
         deny: options.deny,
         external: scriptOptions.external ?? [],
-        fingerprintModules: fingerprintOptions.enabled,
-        minify: scriptOptions.minify ?? false,
+        fingerprintAssets: fingerprintOptions.enabled,
+        minify: options.minify ?? false,
         onError: options.onError ?? defaultErrorHandler,
         rootDir,
-        routes: compileRoutes({
-            fileMap: options.fileMap,
-            rootDir,
-        }),
-        sourceMapSourcePaths: scriptOptions.sourceMapSourcePaths ?? 'url',
-        sourceMaps: scriptOptions.sourceMaps,
-        scriptsTarget: normalizeTarget(scriptOptions.target),
+        routes: compileRoutes(basePath, [
+            {
+                fileMap: options.fileMap,
+                rootDir,
+            },
+            ...getInjectedPackageRouteConfigs(),
+        ]),
+        sourceMapSourcePaths: options.sourceMapSourcePaths ?? 'url',
+        sourceMaps: options.sourceMaps,
+        scriptsTarget: resolveScriptTarget(options.target),
+        stylesTarget: resolveStyleTarget(options.target),
         watchOptions: normalizeWatchOptions(options.watch),
     };
 }
-function normalizeTarget(target) {
-    if (target == null)
-        return undefined;
-    if (typeof target !== 'string' || !scriptTargetSet.has(target)) {
-        throw new TypeError(`Expected target to be one of ${scriptTargets.map((value) => `"${value}"`).join(', ')}. Received "${target}".`);
+function normalizeBasePath(basePath) {
+    if (typeof basePath !== 'string') {
+        throw new TypeError('basePath must be a string');
     }
-    return target;
+    return normalizePathname(basePath || '/').replace(/\/+$/, '') || '/';
 }
 function normalizeFingerprintOptions(options) {
     if (!options.fingerprint) {
@@ -240,3 +330,22 @@ function normalizeWatchOptions(options) {
         return {};
     return options;
 }
+function parseAssetRequestPathname(pathname, options) {
+    let isSourceMapRequest = pathname.endsWith('.map');
+    let pathWithoutMap = isSourceMapRequest ? pathname.slice(0, -4) : pathname;
+    let fingerprint = parseFingerprintSuffix(pathWithoutMap);
+    let filePath = options.routes.resolveUrlPathname(fingerprint.pathname);
+    if (!filePath)
+        return null;
+    if (options.fingerprintAssets && fingerprint.requestedFingerprint === null)
+        return null;
+    return {
+        cacheControl: getFingerprintRequestCacheControl(fingerprint.requestedFingerprint),
+        filePath,
+        isSourceMapRequest,
+        requestedFingerprint: fingerprint.requestedFingerprint,
+    };
+}
+function isScriptFilePath(filePath) {
+    return scriptExtensionSet.has(path.extname(filePath).toLowerCase());
+}

package/dist/lib/compilation-error.d.ts

@@ -1,6 +1,6 @@
-type AssetServerCompilationErrorCode = 'MODULE_NOT_FOUND' | 'MODULE_NOT_ALLOWED' | 'MODULE_OUTSIDE_FILE_MAP' | 'MODULE_COMMONJS_NOT_SUPPORTED' | 'MODULE_TRANSFORM_FAILED' | 'MODULE_EMIT_FAILED' | 'IMPORT_RESOLUTION_FAILED' | 'IMPORT_NOT_SUPPORTED' | 'IMPORT_NOT_ALLOWED' | 'IMPORT_OUTSIDE_FILE_MAP';
+type AssetServerCompilationErrorCode = 'FILE_NOT_FOUND' | 'FILE_NOT_ALLOWED' | 'FILE_OUTSIDE_FILE_MAP' | 'COMMONJS_NOT_SUPPORTED' | 'TRANSFORM_FAILED' | 'EMIT_FAILED' | 'IMPORT_RESOLUTION_FAILED' | 'IMPORT_NOT_SUPPORTED' | 'IMPORT_NOT_ALLOWED' | 'IMPORT_OUTSIDE_FILE_MAP';
 /**
- * Internal error used by the request-time module compilation pipeline.
+ * Internal error used by the request-time asset compilation pipeline.
  */
 export declare class AssetServerCompilationError extends Error {
     code: AssetServerCompilationErrorCode;

package/dist/lib/compilation-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compilation-error.d.ts","sourceRoot":"","sources":["../../src/lib/compilation-error.ts"],"names":[],"mappings":"AAAA,KAAK,+BAA+B,GAChC,kBAAkB,GAClB,oBAAoB,GACpB,yBAAyB,GACzB,+BAA+B,GAC/B,yBAAyB,GACzB,oBAAoB,GACpB,0BAA0B,GAC1B,sBAAsB,GACtB,oBAAoB,GACpB,yBAAyB,CAAA;AAE7B;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,IAAI,EAAE,+BAA+B,CAAA;IAErC,YACE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,IAAI,EAAE,+BAA+B,CAAA;KACtC,EAKF;CACF;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,2BAA2B,CAEtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,+BAA+B,CAAA;CACtC,GACA,2BAA2B,CAE7B"}
+{"version":3,"file":"compilation-error.d.ts","sourceRoot":"","sources":["../../src/lib/compilation-error.ts"],"names":[],"mappings":"AAAA,KAAK,+BAA+B,GAChC,gBAAgB,GAChB,kBAAkB,GAClB,uBAAuB,GACvB,wBAAwB,GACxB,kBAAkB,GAClB,aAAa,GACb,0BAA0B,GAC1B,sBAAsB,GACtB,oBAAoB,GACpB,yBAAyB,CAAA;AAE7B;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,IAAI,EAAE,+BAA+B,CAAA;IAErC,YACE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,IAAI,EAAE,+BAA+B,CAAA;KACtC,EAKF;CACF;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,2BAA2B,CAEtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,+BAA+B,CAAA;CACtC,GACA,2BAA2B,CAE7B"}

package/dist/lib/compilation-error.js

@@ -1,5 +1,5 @@
 /**
- * Internal error used by the request-time module compilation pipeline.
+ * Internal error used by the request-time asset compilation pipeline.
  */
 export class AssetServerCompilationError extends Error {
     code;

package/dist/lib/file-matcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-matcher.d.ts","sourceRoot":"","sources":["../../src/lib/file-matcher.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAA;AAEvD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAA;CAClB,GACL,WAAW,CA0Bb"}
+{"version":3,"file":"file-matcher.d.ts","sourceRoot":"","sources":["../../src/lib/file-matcher.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAA;AAEvD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAA;CAClB,GACL,WAAW,CA2Bb"}

package/dist/lib/file-matcher.js

@@ -1,5 +1,5 @@
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import picomatch from 'picomatch';
 import { normalizeFilePath, resolveFilePath } from "./paths.js";
 export function createFileMatcher(pattern, rootDir, options = {}) {
     let resolvedPatternPath = resolveFilePath(rootDir, pattern);
@@ -26,7 +26,8 @@ export function createFileMatcher(pattern, rootDir, options = {}) {
         }
         return (filePath) => filePath === resolvedPatternPath;
     }
-    return (filePath) => path.posix.matchesGlob(filePath, resolvedPatternPath);
+    let globMatcher = picomatch(resolvedPatternPath, { dot: true });
+    return (filePath) => globMatcher(filePath);
 }
 function isSameOrDescendantPath(filePath, directoryPath) {
     let normalizedDirectoryPath = directoryPath.replace(/\/+$/, '');

package/dist/lib/injected-packages.d.ts

@@ -0,0 +1,11 @@
+export declare function isInjectedPackageFilePath(filePath: string): boolean;
+export declare function getInjectedPackageRouteConfigs(): {
+    fileMap: Record<string, string>;
+    rootDir: string;
+}[];
+export declare function getInjectedPackageNameForSpecifier(specifier: string): string | null;
+export declare function mayContainInjectedPackageSpecifier(sourceText: string): boolean;
+export declare function maskAuthoredInjectedPackageSpecifier(specifier: string): string | null;
+export declare function restoreAuthoredInjectedPackageSpecifier(specifier: string): string | null;
+export declare function getInjectedPackageImporterPath(): string;
+//# sourceMappingURL=injected-packages.d.ts.map

package/dist/lib/injected-packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injected-packages.d.ts","sourceRoot":"","sources":["../../src/lib/injected-packages.ts"],"names":[],"mappings":"AAeA,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWnE;AAED,wBAAgB,8BAA8B,IAAI;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,OAAO,EAAE,MAAM,CAAA;CAChB,EAAE,CAWF;AAED,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQnF;AAED,wBAAgB,kCAAkC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED,wBAAgB,oCAAoC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMrF;AAED,wBAAgB,uCAAuC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYxF;AAMD,wBAAgB,8BAA8B,IAAI,MAAM,CAEvD"}

package/dist/lib/injected-packages.js

@@ -0,0 +1,86 @@
+import * as fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { getFilePathDirectory, normalizeFilePath } from "./paths.js";
+const injectedPackageNames = ['@oxc-project/runtime'];
+const injectedPackagesBasePath = '/__@remix/injected';
+const resolvedInjectedPackages = new Map();
+export function isInjectedPackageFilePath(filePath) {
+    let normalizedFilePath = normalizeFilePath(filePath);
+    for (let packageName of injectedPackageNames) {
+        let packageRoot = getResolvedInjectedPackage(packageName).packageRoot;
+        if (normalizedFilePath === packageRoot || normalizedFilePath.startsWith(`${packageRoot}/`)) {
+            return true;
+        }
+    }
+    return false;
+}
+export function getInjectedPackageRouteConfigs() {
+    return injectedPackageNames.map((packageName) => {
+        let { packageRoot } = getResolvedInjectedPackage(packageName);
+        return {
+            fileMap: {
+                [getInjectedPackageRoutePattern(packageName)]: `${packageName}/*path`,
+            },
+            rootDir: getInjectedPackageRouteRoot(packageRoot, packageName),
+        };
+    });
+}
+export function getInjectedPackageNameForSpecifier(specifier) {
+    for (let packageName of injectedPackageNames) {
+        if (specifier === packageName || specifier.startsWith(`${packageName}/`)) {
+            return packageName;
+        }
+    }
+    return null;
+}
+export function mayContainInjectedPackageSpecifier(sourceText) {
+    return injectedPackageNames.some((packageName) => sourceText.includes(packageName));
+}
+export function maskAuthoredInjectedPackageSpecifier(specifier) {
+    let packageName = getInjectedPackageNameForSpecifier(specifier);
+    if (!packageName)
+        return null;
+    let maskedPackageName = getMaskedInjectedPackageName(packageName);
+    return `${maskedPackageName}${specifier.slice(packageName.length)}`;
+}
+export function restoreAuthoredInjectedPackageSpecifier(specifier) {
+    for (let packageName of injectedPackageNames) {
+        let maskedPackageName = getMaskedInjectedPackageName(packageName);
+        if (specifier === maskedPackageName) {
+            return packageName;
+        }
+        if (specifier.startsWith(`${maskedPackageName}/`)) {
+            return `${packageName}${specifier.slice(maskedPackageName.length)}`;
+        }
+    }
+    return null;
+}
+function getMaskedInjectedPackageName(packageName) {
+    return `~${packageName.slice(1)}`;
+}
+export function getInjectedPackageImporterPath() {
+    return normalizeFilePath(fileURLToPath(import.meta.url));
+}
+function getResolvedInjectedPackage(packageName) {
+    let existing = resolvedInjectedPackages.get(packageName);
+    if (existing)
+        return existing;
+    let packageJsonUrl = import.meta.resolve(`${packageName}/package.json`);
+    let packageJsonPath = normalizeFilePath(fs.realpathSync(fileURLToPath(packageJsonUrl)));
+    let resolvedInjectedPackage = {
+        packageJsonPath,
+        packageRoot: normalizeFilePath(fs.realpathSync(getFilePathDirectory(packageJsonPath))),
+    };
+    resolvedInjectedPackages.set(packageName, resolvedInjectedPackage);
+    return resolvedInjectedPackage;
+}
+function getInjectedPackageRoutePattern(packageName) {
+    return `${injectedPackagesBasePath}/${packageName}/*path`;
+}
+function getInjectedPackageRouteRoot(packageRoot, packageName) {
+    let routeRoot = packageRoot;
+    for (let _segment of packageName.split('/')) {
+        routeRoot = getFilePathDirectory(routeRoot);
+    }
+    return routeRoot;
+}

package/dist/lib/module-store.d.ts

@@ -0,0 +1,41 @@
+export type ModuleTracking = {
+    trackedFiles: readonly string[];
+    trackedDirectories?: readonly string[];
+};
+export type ModuleWatchEvent = 'change' | 'add' | 'unlink';
+export type FileSnapshot = {
+    mtimeNs: bigint;
+    size: bigint;
+};
+export type ModuleSnapshot = ReadonlyMap<string, FileSnapshot>;
+type ModuleRecordState<transformed, resolved, emitted> = {
+    identityPath: string;
+    invalidationVersion: number;
+    transformed?: transformed;
+    resolved?: resolved;
+    emitted?: emitted;
+    emittedSnapshot?: ModuleSnapshot;
+    staleEmitted?: emitted;
+    staleEmittedSnapshot?: ModuleSnapshot;
+    trackedFiles: ReadonlySet<string>;
+    trackedDirectories: ReadonlySet<string>;
+};
+export type ModuleRecord<transformed, resolved, emitted> = Readonly<ModuleRecordState<transformed, resolved, emitted>>;
+export type ModuleStore<transformed, resolved, emitted> = {
+    get(identityPath: string): ModuleRecord<transformed, resolved, emitted>;
+    clearTransformed(identityPath: string, tracking: readonly ModuleTracking[]): void;
+    setTransformed(identityPath: string, transformed: transformed, tracking: readonly ModuleTracking[]): void;
+    setResolved(identityPath: string, resolved: resolved, tracking: readonly ModuleTracking[]): void;
+    clearResolved(identityPath: string, tracking: readonly ModuleTracking[]): void;
+    setEmitted(identityPath: string, emitted: emitted, snapshot: ModuleSnapshot | null): void;
+    invalidateForFileEvent(filePath: string, event: ModuleWatchEvent): void;
+    invalidateAll(): void;
+};
+export declare function createModuleStore<transformed, resolved, emitted>(options?: {
+    onWatchDirectoriesChange?: (delta: {
+        add: string[];
+        remove: string[];
+    }) => void;
+}): ModuleStore<transformed, resolved, emitted>;
+export {};
+//# sourceMappingURL=module-store.d.ts.map

package/dist/lib/module-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-store.d.ts","sourceRoot":"","sources":["../../src/lib/module-store.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAA;AAE1D,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AAE9D,KAAK,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,IAAI;IACvD,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,eAAe,CAAC,EAAE,cAAc,CAAA;IAChC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,oBAAoB,CAAC,EAAE,cAAc,CAAA;IACrC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACjC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACxC,CAAA;AAED,MAAM,MAAM,YAAY,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,IAAI,QAAQ,CACjE,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAClD,CAAA;AAeD,MAAM,MAAM,WAAW,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,IAAI;IACxD,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;IACvE,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAAA;IACjF,cAAc,CACZ,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,IAAI,CAAA;IACP,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAAA;IAChG,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAAA;IAC9E,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAAA;IACzF,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACvE,aAAa,IAAI,IAAI,CAAA;CACtB,CAAA;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAC9D,OAAO,GAAE;IACP,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAA;CAC3E,GACL,WAAW,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CA4M7C"}