@remix-run/assets 0.4.4 → 0.5.0

package/dist/lib/scripts/emit.d.ts

@@ -18,7 +18,10 @@ type EmitResult = {
     error: AssetServerCompilationError;
 };
 export declare function emitResolvedModule(resolvedModule: ResolvedModule, options: {
+    getHmrImportTimestamp(identityPath: string): number | null;
     getServedUrl(identityPath: string): Promise<string>;
+    getStableUrl(identityPath: string): string;
+    hmrClientPathname?: string;
     sourceMaps?: 'external' | 'inline';
 }): Promise<EmitResult>;
 export {};

package/dist/lib/scripts/emit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../src/lib/scripts/emit.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAE1E,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,YAAY,GAAG,IAAI,CAAA;CAC/B,CAAA;AAED,KAAK,UAAU,GACX;IACE,EAAE,EAAE,IAAI,CAAA;IACR,KAAK,EAAE,aAAa,CAAA;CACrB,GACD;IACE,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE,2BAA2B,CAAA;CACnC,CAAA;AAEL,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE;IACP,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACnD,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAA;CACnC,GACA,OAAO,CAAC,UAAU,CAAC,CAkCrB"}
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../src/lib/scripts/emit.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAE1E,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,YAAY,GAAG,IAAI,CAAA;CAC/B,CAAA;AAED,KAAK,UAAU,GACX;IACE,EAAE,EAAE,IAAI,CAAA;IACR,KAAK,EAAE,aAAa,CAAA;CACrB,GACD;IACE,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE,2BAA2B,CAAA;CACnC,CAAA;AAQL,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE;IACP,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC1D,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACnD,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAA;CACnC,GACA,OAAO,CAAC,UAAU,CAAC,CAkCrB"}

package/dist/lib/scripts/emit.js

@@ -1,12 +1,12 @@
 import MagicString from 'magic-string';
-import { createAssetServerCompilationError, isAssetServerCompilationError, } from "../compilation-error.js";
-import { hashContent } from "../fingerprint.js";
-import { composeSourceMaps } from "../source-maps.js";
+import { createAssetServerCompilationError, isAssetServerCompilationError, } from '../compilation-error.js';
+import { hashContent } from '../fingerprint.js';
+import { composeSourceMaps } from '../source-maps.js';
 export async function emitResolvedModule(resolvedModule, options) {
     try {
         let importUrls = await Promise.all(resolvedModule.deps.map((depPath) => options.getServedUrl(depPath)));
         let rewriteResult = await rewriteImports(resolvedModule, options);
-        let finalCode = rewriteResult.code;
+        let finalCode = prependHmrContext(resolvedModule, rewriteResult.code, options);
         if (rewriteResult.sourceMap) {
             if (options.sourceMaps === 'inline') {
                 let encoded = Buffer.from(rewriteResult.sourceMap).toString('base64');
@@ -39,14 +39,33 @@ async function rewriteImports(resolvedModule, options) {
     let rewrittenSource = new MagicString(resolvedModule.rawCode);
     for (let imported of resolvedModule.imports) {
         let url = await options.getServedUrl(imported.depPath);
+        let hmrImportTimestamp = options.getHmrImportTimestamp(imported.depPath);
+        if (hmrImportTimestamp !== null) {
+            url = addTimestampQuery(url, hmrImportTimestamp);
+        }
         rewrittenSource.overwrite(imported.start, imported.end, imported.quote ? `${imported.quote}${url}${imported.quote}` : url);
     }
+    for (let acceptedDep of resolvedModule.hmr.acceptedDeps) {
+        let url = options.getStableUrl(acceptedDep.depPath);
+        rewrittenSource.overwrite(acceptedDep.start, acceptedDep.end, acceptedDep.quote ? `${acceptedDep.quote}${url}${acceptedDep.quote}` : url);
+    }
     let code = rewrittenSource.toString();
-    let sourceMap = resolvedModule.sourceMap && resolvedModule.imports.length > 0
+    let sourceMap = resolvedModule.sourceMap &&
+        (resolvedModule.imports.length > 0 || resolvedModule.hmr.acceptedDeps.length > 0)
         ? composeSourceMaps(rewrittenSource.generateMap({ hires: true }).toString(), resolvedModule.sourceMap)
         : resolvedModule.sourceMap;
     return { code, sourceMap };
 }
+function addTimestampQuery(pathname, timestamp) {
+    return `${pathname}${pathname.includes('?') ? '&' : '?'}t=${timestamp}`;
+}
+function prependHmrContext(resolvedModule, code, options) {
+    if (!options.hmrClientPathname || !resolvedModule.hmr.usesImportMetaHot)
+        return code;
+    return (`import { createHotContext as __remixCreateHotContext } from ${JSON.stringify(options.hmrClientPathname)};\n` +
+        `import.meta.hot = __remixCreateHotContext(${JSON.stringify(resolvedModule.stableUrlPathname)});\n` +
+        code);
+}
 async function createEmittedAsset(content) {
     return {
         content,

package/dist/lib/scripts/resolve.d.ts

@@ -18,9 +18,13 @@ type ResolvedImport = {
     quote?: '"' | "'" | '`';
     start: number;
 };
+type ResolvedHmrAcceptedDependency = ResolvedImport;
 export type ResolvedModule = {
     deps: string[];
     fingerprint: string | null;
+    hmr: Omit<TransformedModule['hmr'], 'acceptedDeps'> & {
+        acceptedDeps: ResolvedHmrAcceptedDependency[];
+    };
     identityPath: string;
     imports: ResolvedImport[];
     trackedFiles: string[];

package/dist/lib/scripts/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/lib/scripts/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAMnD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAM1E,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAE9C,KAAK,YAAY,GAAG,YAAY,CAAC,iBAAiB,EAAE,cAAc,EAAE,aAAa,CAAC,CAAA;AAElF,eAAO,MAAM,sBAAsB;;;;CAIC,CAAA;AAEpC,eAAO,MAAM,kBAAkB,UAAiD,CAAA;AAChF,eAAO,MAAM,yBAAyB,UAAiD,CAAA;AAGvF,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAYD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,QAAQ,EAAE,cAAc,CAAA;CACzB,GAAG,CACA;IACE,EAAE,EAAE,IAAI,CAAA;IACR,KAAK,EAAE,cAAc,CAAA;CACtB,GACD;IACE,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE,2BAA2B,CAAA;CACnC,CACJ,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAA;IACxC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACzC,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAAA;IACnE,eAAe,EAAE,eAAe,CAAA;IAChC,MAAM,EAAE,cAAc,CAAA;CACvB,CAAA;AAaD,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,iBAAiB,EAC9B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,aAAa,CAAC,CA0IxB"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/lib/scripts/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAMnD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAM1E,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAE9C,KAAK,YAAY,GAAG,YAAY,CAAC,iBAAiB,EAAE,cAAc,EAAE,aAAa,CAAC,CAAA;AAElF,eAAO,MAAM,sBAAsB;;;;CAIC,CAAA;AAEpC,eAAO,MAAM,kBAAkB,UAAiD,CAAA;AAChF,eAAO,MAAM,yBAAyB,UAAiD,CAAA;AAGvF,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,6BAA6B,GAAG,cAAc,CAAA;AAYnD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,GAAG,EAAE,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,GAAG;QACpD,YAAY,EAAE,6BAA6B,EAAE,CAAA;KAC9C,CAAA;IACD,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,QAAQ,EAAE,cAAc,CAAA;CACzB,GAAG,CACA;IACE,EAAE,EAAE,IAAI,CAAA;IACR,KAAK,EAAE,cAAc,CAAA;CACtB,GACD;IACE,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE,2BAA2B,CAAA;CACnC,CACJ,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAA;IACxC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACzC,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAAA;IACnE,eAAe,EAAE,eAAe,CAAA;IAChC,MAAM,EAAE,cAAc,CAAA;CACvB,CAAA;AAaD,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,iBAAiB,EAC9B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,aAAa,CAAC,CA2PxB"}

package/dist/lib/scripts/resolve.js

@@ -1,8 +1,8 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { createAssetServerCompilationError, isAssetServerCompilationError, } from "../compilation-error.js";
-import { getInjectedPackageNameForSpecifier, getInjectedPackageImporterPath, restoreAuthoredInjectedPackageSpecifier, } from "../injected-packages.js";
-import { normalizeFilePath } from "../paths.js";
+import { createAssetServerCompilationError, isAssetServerCompilationError, } from '../compilation-error.js';
+import { getInjectedPackageNameForSpecifier, getInjectedPackageImporterPath, restoreAuthoredInjectedPackageSpecifier, } from '../injected-packages.js';
+import { normalizeFilePath } from '../paths.js';
 export const resolverExtensionAlias = {
     '.js': ['.js', '.ts', '.tsx', '.jsx'],
     '.jsx': ['.jsx', '.tsx'],
@@ -27,6 +27,7 @@ export async function resolveModule(record, transformed, args) {
         });
     }
     let importsWithPaths = [];
+    let acceptedDepsWithPaths = [];
     let deps = new Set();
     for (let unresolved of transformed.unresolvedImports) {
         let displaySpecifier = getDisplayImportSpecifier(unresolved.specifier);
@@ -46,8 +47,8 @@ export async function resolveModule(record, transformed, args) {
             }), trackedFiles, trackedResolutions, transformed.resolvedPath, { isWatchIgnored: args.isWatchIgnored, trackedResolution });
         }
         if (!args.isAllowed(resolvedImport.identityPath)) {
-            return failResolve(createAssetServerCompilationError(`Import "${displaySpecifier}" in ${transformed.resolvedPath}, resolved to "${resolvedImport.identityPath}", is not allowed by the asset server allow/deny configuration. ` +
-                `Add a matching allow rule for this file path, remove a conflicting deny rule for this file path, or mark this import as external.`, {
+            return failResolve(createAssetServerCompilationError(`Import "${displaySpecifier}" in ${transformed.resolvedPath}, resolved to "${resolvedImport.identityPath}", is not allowed by the asset server access configuration. ` +
+                `Add a matching allowFiles or allowPackages rule, remove a conflicting denyFiles rule, or mark this import as external.`, {
                 code: 'IMPORT_NOT_ALLOWED',
             }), trackedFiles, trackedResolutions, transformed.resolvedPath, { isWatchIgnored: args.isWatchIgnored, trackedResolution });
         }
@@ -78,12 +79,73 @@ export async function resolveModule(record, transformed, args) {
             start: unresolved.start,
         });
     }
+    for (let unresolved of transformed.hmr.acceptedDeps) {
+        if (isBrowserExternalModuleUrl(unresolved.specifier))
+            continue;
+        let displaySpecifier = getDisplayImportSpecifier(unresolved.specifier);
+        let trackedResolution = getTrackedRelativeImportResolution(transformed.importerDir, displaySpecifier, args.isWatchIgnored);
+        let resolvedSpec = resolvedImports.get(unresolved.specifier);
+        if (!resolvedSpec?.absolutePath) {
+            try {
+                resolvedSpec = await batchResolveSpecifiers([unresolved.specifier], transformed.resolvedPath, args.resolverFactory).then((resolved) => resolved.get(unresolved.specifier));
+            }
+            catch (error) {
+                return failResolve(error, trackedFiles, trackedResolutions, transformed.resolvedPath, {
+                    isWatchIgnored: args.isWatchIgnored,
+                    trackedResolution,
+                });
+            }
+        }
+        if (!resolvedSpec?.absolutePath) {
+            return failResolve(createAssetServerCompilationError(`Failed to resolve accepted HMR dependency "${displaySpecifier}" in ${transformed.resolvedPath}. ` +
+                `Ensure it resolves to a file within the configured asset server fileMap, or mark it as external.`, {
+                code: 'IMPORT_RESOLUTION_FAILED',
+            }), trackedFiles, trackedResolutions, transformed.resolvedPath, { isWatchIgnored: args.isWatchIgnored, trackedResolution });
+        }
+        let resolvedImport = args.resolveModulePath(resolvedSpec.absolutePath);
+        if (!resolvedImport) {
+            return failResolve(createAssetServerCompilationError(`Accepted HMR dependency "${displaySpecifier}" in ${transformed.resolvedPath}, resolved to "${resolvedSpec.absolutePath}", is not a supported script file. ` +
+                `Supported extensions are ${supportedScriptExtensions.join(', ')}.`, {
+                code: 'IMPORT_NOT_SUPPORTED',
+            }), trackedFiles, trackedResolutions, transformed.resolvedPath, { isWatchIgnored: args.isWatchIgnored, trackedResolution });
+        }
+        if (!args.isAllowed(resolvedImport.identityPath)) {
+            return failResolve(createAssetServerCompilationError(`Accepted HMR dependency "${displaySpecifier}" in ${transformed.resolvedPath}, resolved to "${resolvedImport.identityPath}", is not allowed by the asset server allow/deny configuration. ` +
+                `Add a matching allow rule for this file path, remove a conflicting deny rule for this file path, or mark this import as external.`, {
+                code: 'IMPORT_NOT_ALLOWED',
+            }), trackedFiles, trackedResolutions, transformed.resolvedPath, { isWatchIgnored: args.isWatchIgnored, trackedResolution });
+        }
+        let stableUrlPathname = args.routes.toUrlPathname(resolvedImport.identityPath);
+        if (!stableUrlPathname) {
+            return failResolve(createAssetServerCompilationError(`Accepted HMR dependency "${displaySpecifier}" in ${transformed.resolvedPath}, resolved to "${resolvedImport.identityPath}", is outside all configured fileMap entries. ` +
+                `Add a matching fileMap entry for this file path, or mark this import as external.`, {
+                code: 'IMPORT_OUTSIDE_FILE_MAP',
+            }), trackedFiles, trackedResolutions, transformed.resolvedPath, { isWatchIgnored: args.isWatchIgnored, trackedResolution });
+        }
+        if (trackedResolution) {
+            trackedResolutions.push({
+                ...trackedResolution,
+                resolvedIdentityPath: resolvedImport.identityPath,
+            });
+        }
+        acceptedDepsWithPaths.push({
+            depPath: resolvedImport.identityPath,
+            end: unresolved.end,
+            quote: unresolved.quote,
+            start: unresolved.start,
+        });
+    }
     return {
         ok: true,
         tracking: toResolveTracking(trackedFiles, trackedResolutions),
         value: {
             deps: [...deps],
             fingerprint: transformed.fingerprint,
+            hmr: {
+                acceptedDeps: acceptedDepsWithPaths,
+                selfAccepting: transformed.hmr.selfAccepting,
+                usesImportMetaHot: transformed.hmr.usesImportMetaHot,
+            },
             identityPath: record.identityPath,
             imports: importsWithPaths,
             trackedFiles: [...trackedFiles],
@@ -226,6 +288,9 @@ function normalizeSpecifierResolution(specifier, importerPath) {
 function getDisplayImportSpecifier(specifier) {
     return restoreAuthoredInjectedPackageSpecifier(specifier) ?? specifier;
 }
+function isBrowserExternalModuleUrl(url) {
+    return url.startsWith('data:') || url.startsWith('http://') || url.startsWith('https://');
+}
 function failResolve(error, trackedFiles, trackedResolutions, importerPath, options = {}) {
     return {
         ok: false,

package/dist/lib/scripts/transform.d.ts

@@ -1,6 +1,7 @@
 import type { TsConfigJsonResolved } from 'get-tsconfig';
 import type { AssetServerCompilationError } from '../compilation-error.ts';
 import type { ModuleRecord, ModuleTracking } from '../module-store.ts';
+import type { ModuleLoader } from '../loaders.ts';
 import type { CompiledRoutes } from '../routes.ts';
 import type { EmittedModule } from './emit.ts';
 import type { ResolvedScriptTarget } from '../target.ts';
@@ -16,8 +17,14 @@ type UnresolvedImport = {
     specifier: string;
     start: number;
 };
+type HmrAcceptedDependency = UnresolvedImport;
 export type TransformedModule = {
     fingerprint: string | null;
+    hmr: {
+        acceptedDeps: HmrAcceptedDependency[];
+        selfAccepting: boolean;
+        usesImportMetaHot: boolean;
+    };
     identityPath: string;
     importerDir: string;
     packageSpecifiers: string[];
@@ -48,6 +55,7 @@ export type TransformArgs = {
     externalSet: ReadonlySet<string>;
     isWatchIgnored(filePath: string): boolean;
     minify: boolean;
+    loaders: readonly ModuleLoader[];
     resolveActualPath(identityPath: string): string | null;
     routes: CompiledRoutes;
     sourceMapSourcePaths: 'absolute' | 'url';
@@ -60,5 +68,6 @@ export declare function createTsconfigTransformOptionsResolver(): {
     getTransformOptions(filePath: string, isWatchIgnored: (filePath: string) => boolean): TsconfigTransformOptions;
 };
 export declare function transformModule(record: ScriptRecord, args: TransformArgs): Promise<TransformResult>;
+export declare function getHmrAnalysis(rawCode: string): TransformedModule['hmr'];
 export {};
 //# sourceMappingURL=transform.d.ts.map

package/dist/lib/scripts/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/lib/scripts/transform.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAS,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAS/D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAO1E,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,KAAK,YAAY,GAAG,YAAY,CAAC,iBAAiB,EAAE,cAAc,EAAE,aAAa,CAAC,CAAA;AA4BlF,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,KAAK,gBAAgB,GAAG;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,iBAAiB,EAAE,gBAAgB,EAAE,CAAA;CACtC,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,QAAQ,EAAE,cAAc,CAAA;CACzB,GAAG,CACA;IACE,EAAE,EAAE,IAAI,CAAA;IACR,KAAK,EAAE,iBAAiB,CAAA;CACzB,GACD;IACE,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE,2BAA2B,CAAA;CACnC,CACJ,CAAA;AAED,KAAK,wBAAwB,GAAG;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,WAAW,CAAC,EAAE,oBAAoB,CAAA;CACnC,CAAA;AAED,KAAK,gCAAgC,GAAG,UAAU,CAAC,OAAO,sCAAsC,CAAC,CAAA;AAEjG,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IACrC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACzC,MAAM,EAAE,OAAO,CAAA;IACf,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACtD,MAAM,EAAE,cAAc,CAAA;IACtB,oBAAoB,EAAE,UAAU,GAAG,KAAK,CAAA;IACxC,UAAU,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAA;IACxC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAA;IACnC,gCAAgC,EAAE,gCAAgC,CAAA;CACnE,CAAA;AAED,wBAAgB,sCAAsC;;;EAkCrD;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,eAAe,CAAC,CA6H1B"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/lib/scripts/transform.ts"],"names":[],"mappings":"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"}

package/dist/lib/scripts/transform.js

@@ -1,18 +1,20 @@
 import * as fs from 'node:fs';
 import * as fsp from 'node:fs/promises';
 import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
 import { getTsconfig } from 'get-tsconfig';
 import MagicString from 'magic-string';
 import { minify } from 'oxc-minify';
 import { parseSync, visitorKeys } from 'oxc-parser';
 import { transform as oxcTransform } from 'oxc-transform';
 import { init as esModuleLexerInit, parse as esModuleLexer } from 'es-module-lexer';
-import { isCommonJS, mayContainCommonJSModuleGlobals } from "./cjs-check.js";
-import { createAssetServerCompilationError, isAssetServerCompilationError, } from "../compilation-error.js";
-import { generateFingerprint } from "../fingerprint.js";
-import { maskAuthoredInjectedPackageSpecifier, mayContainInjectedPackageSpecifier, restoreAuthoredInjectedPackageSpecifier, } from "../injected-packages.js";
-import { normalizeFilePath } from "../paths.js";
-import { composeSourceMaps, rewriteSourceMapSources, stringifySourceMap } from "../source-maps.js";
+import { isCommonJS, mayContainCommonJSModuleGlobals } from './cjs-check.js';
+import { createAssetServerCompilationError, isAssetServerCompilationError, } from '../compilation-error.js';
+import { generateFingerprint } from '../fingerprint.js';
+import { maskAuthoredInjectedPackageSpecifier, mayContainInjectedPackageSpecifier, restoreAuthoredInjectedPackageSpecifier, } from '../injected-packages.js';
+import { normalizeFilePath } from '../paths.js';
+import { composeSourceMaps, rewriteSourceMapSources, stringifySourceMap } from '../source-maps.js';
+import { scriptLoaderConditions } from './conditions.js';
 const scriptModuleTypes = [
     { extension: '.js', lang: 'js' },
     { extension: '.jsx', lang: 'jsx' },
@@ -105,9 +107,17 @@ export async function transformModule(record, args) {
         };
     }
     try {
+        let stableUrlPathname = args.routes.toUrlPathname(record.identityPath);
+        if (!stableUrlPathname) {
+            throw createAssetServerCompilationError(`File ${record.identityPath} is outside all configured fileMap entries.`, {
+                code: 'FILE_OUTSIDE_FILE_MAP',
+            });
+        }
         let analysis = await analyzeModuleSource(sourceText, resolvedPath, transformOptions, {
             define: args.define ?? undefined,
             minify: args.minify,
+            loaders: args.loaders,
+            moduleUrl: stableUrlPathname,
             sourceMaps: args.sourceMaps ?? undefined,
             target: args.target ?? undefined,
         });
@@ -119,12 +129,6 @@ export async function transformModule(record, args) {
                 code: 'COMMONJS_NOT_SUPPORTED',
             });
         }
-        let stableUrlPathname = args.routes.toUrlPathname(record.identityPath);
-        if (!stableUrlPathname) {
-            throw createAssetServerCompilationError(`File ${record.identityPath} is outside all configured fileMap entries.`, {
-                code: 'FILE_OUTSIDE_FILE_MAP',
-            });
-        }
         let sourceMap = analysis.sourceMap
             ? rewriteSourceMapSources(analysis.sourceMap, resolvedPath, stableUrlPathname, args.sourceMapSourcePaths, sourceText)
             : null;
@@ -140,6 +144,7 @@ export async function transformModule(record, args) {
                         buildId: args.buildId,
                         content: sourceText,
                     }),
+                hmr: getHmrAnalysis(analysis.rawCode),
                 identityPath: record.identityPath,
                 importerDir: path.dirname(resolvedPath),
                 packageSpecifiers: analysis.unresolvedImports
@@ -164,6 +169,105 @@ export async function transformModule(record, args) {
         };
     }
 }
+export function getHmrAnalysis(rawCode) {
+    let mayUseImportMetaHot = rawCode.includes('import.meta.hot');
+    let usesImportMetaHot = false;
+    let acceptedDeps = [];
+    let selfAccepting = false;
+    if (mayUseImportMetaHot) {
+        try {
+            let parseResult = parseSync('hmr-analysis.js', rawCode, {
+                lang: 'js',
+                sourceType: 'module',
+            });
+            if (parseResult.errors.length > 0) {
+                throw createAssetServerCompilationError(`Failed to analyze HMR usage in transformed script. ${parseResult.errors[0]?.message ?? 'Unknown parse error'}`, {
+                    code: 'TRANSFORM_FAILED',
+                });
+            }
+            walkAst(parseResult.program, (node) => {
+                if (isImportMetaHotNode(node)) {
+                    usesImportMetaHot = true;
+                }
+                if (node.type !== 'CallExpression')
+                    return;
+                if (!isImportMetaHotAcceptCallee(node.callee))
+                    return;
+                let [firstArgument] = node.arguments;
+                if (firstArgument === undefined || !isAcceptedDependencyArgument(firstArgument)) {
+                    selfAccepting = true;
+                    return;
+                }
+                acceptedDeps.push(...getAcceptedDependencies(firstArgument, rawCode));
+            });
+        }
+        catch (error) {
+            if (isAssetServerCompilationError(error))
+                throw error;
+            throw createAssetServerCompilationError(`Failed to analyze HMR usage in transformed script.`, {
+                cause: error,
+                code: 'TRANSFORM_FAILED',
+            });
+        }
+    }
+    return {
+        acceptedDeps,
+        selfAccepting,
+        usesImportMetaHot,
+    };
+}
+function isImportMetaHotAcceptCallee(node) {
+    let callee = unwrapChainExpression(node);
+    if (callee.type !== 'MemberExpression')
+        return false;
+    if (callee.computed || !isIdentifierNode(callee.property, 'accept'))
+        return false;
+    return isImportMetaHotNode(callee.object);
+}
+function isImportMetaHotNode(node) {
+    let hot = unwrapChainExpression(node);
+    if (hot.type !== 'MemberExpression')
+        return false;
+    if (hot.computed || !isIdentifierNode(hot.property, 'hot'))
+        return false;
+    let meta = unwrapChainExpression(hot.object);
+    return (meta.type === 'MetaProperty' &&
+        isIdentifierNode(meta.meta, 'import') &&
+        isIdentifierNode(meta.property, 'meta'));
+}
+function unwrapChainExpression(node) {
+    return node.type === 'ChainExpression' ? node.expression : node;
+}
+function isIdentifierNode(node, name) {
+    return node.type === 'Identifier' && node.name === name;
+}
+function isAcceptedDependencyArgument(node) {
+    return isStringLiteralNode(node) || node.type === 'ArrayExpression';
+}
+function getAcceptedDependencies(node, source) {
+    if (isStringLiteralNode(node)) {
+        return [
+            {
+                end: node.end - 1,
+                specifier: node.value,
+                start: node.start + 1,
+            },
+        ];
+    }
+    if (node.type !== 'ArrayExpression')
+        return [];
+    let deps = [];
+    for (let element of node.elements) {
+        if (!isStringLiteralNode(element))
+            continue;
+        deps.push({
+            end: element.end - 1,
+            specifier: element.value,
+            start: element.start + 1,
+        });
+    }
+    return deps;
+}
 function findNearestTsconfigPath(directory) {
     let currentDirectory = directory;
     while (true) {
@@ -203,6 +307,38 @@ async function analyzeModuleSource(sourceText, resolvedPath, transformOptions, o
     }
     let rawCode = transformResult.code.trimEnd();
     let sourceMap = stringifySourceMap(transformResult.map);
+    if (options.loaders.length > 0) {
+        let loaderUrl = pathToFileURL(resolvedPath).href;
+        let loaderInputSource = sourceMap ? appendInlineSourceMap(rawCode, sourceMap) : rawCode;
+        let loaderOutputSource;
+        try {
+            let loaderResult = runModuleLoaders(loaderUrl, {
+                format: 'module',
+                loaders: options.loaders,
+                moduleUrl: options.moduleUrl,
+                source: loaderInputSource,
+            });
+            loaderOutputSource = moduleLoadSourceToString(getModuleLoadSource(loaderUrl, loaderResult));
+        }
+        catch (error) {
+            if (isAssetServerCompilationError(error))
+                throw error;
+            throw createAssetServerCompilationError(`Module loader failed for ${loaderUrl}. ${formatUnknownError(error)}`, {
+                cause: error,
+                code: 'LOADER_FAILED',
+            });
+        }
+        if (loaderOutputSource !== loaderInputSource) {
+            let loaderOutput = extractInlineSourceMap(loaderOutputSource);
+            rawCode = loaderOutput.code.trimEnd();
+            sourceMap =
+                loaderOutput.sourceMap && loaderOutput.sourceMap !== sourceMap
+                    ? sourceMap
+                        ? composeSourceMaps(loaderOutput.sourceMap, sourceMap)
+                        : loaderOutput.sourceMap
+                    : null;
+        }
+    }
     if (options.minify) {
         let minifyResult = await minifyModule(rawCode, resolvedPath, options.target, options.sourceMaps);
         rawCode = minifyResult.code.trimEnd();
@@ -220,6 +356,76 @@ async function analyzeModuleSource(sourceText, resolvedPath, transformOptions, o
         unresolvedImports: await getUnresolvedImportsFromLexer(rawCode),
     };
 }
+function runModuleLoaders(url, options) {
+    let loadContext = {
+        conditions: [...scriptLoaderConditions],
+        format: options.format,
+        importAttributes: {},
+        moduleUrl: options.moduleUrl,
+    };
+    let load = (_url, context) => ({
+        format: context?.format ?? options.format,
+        source: options.source,
+    });
+    for (let loader of options.loaders) {
+        let nextLoad = load;
+        load = (nextUrl, nextContext) => {
+            let nextLoadCalled = false;
+            let wrappedNextLoad = (wrappedUrl, wrappedContext) => {
+                if (wrappedUrl !== nextUrl) {
+                    throw createAssetServerCompilationError(`Module loader for ${nextUrl} attempted to change the module URL to ${wrappedUrl}. Loaders cannot change module URLs.`, {
+                        code: 'LOADER_FAILED',
+                    });
+                }
+                nextLoadCalled = true;
+                return nextLoad(wrappedUrl, wrappedContext);
+            };
+            let result = loader(nextUrl, {
+                conditions: nextContext?.conditions ?? loadContext.conditions,
+                format: nextContext?.format ?? loadContext.format,
+                importAttributes: nextContext?.importAttributes ?? loadContext.importAttributes,
+                moduleUrl: nextContext?.moduleUrl ?? loadContext.moduleUrl,
+            }, wrappedNextLoad);
+            if (!nextLoadCalled && result.shortCircuit !== true) {
+                throw createAssetServerCompilationError(`Module loader for ${nextUrl} returned without calling nextLoad or setting shortCircuit: true.`, {
+                    code: 'LOADER_FAILED',
+                });
+            }
+            return result;
+        };
+    }
+    return load(url, loadContext);
+}
+function getModuleLoadSource(url, result) {
+    if (result.format !== 'module') {
+        throw createAssetServerCompilationError(`Module loader for ${url} returned unsupported format ${JSON.stringify(result.format)}. Only "module" is supported.`, {
+            code: 'LOADER_FAILED',
+        });
+    }
+    if (result.source !== undefined && result.source !== null)
+        return result.source;
+    throw createAssetServerCompilationError(`Module loader for ${url} did not return source.`, {
+        code: 'LOADER_FAILED',
+    });
+}
+function moduleLoadSourceToString(source) {
+    if (typeof source === 'string')
+        return source;
+    return new TextDecoder().decode(source);
+}
+function appendInlineSourceMap(source, sourceMap) {
+    let encoded = Buffer.from(sourceMap).toString('base64');
+    return `${source}\n//# sourceMappingURL=data:application/json;base64,${encoded}`;
+}
+function extractInlineSourceMap(source) {
+    let sourceMapPattern = /(?:\/\/# sourceMappingURL=data:application\/json;base64,([A-Za-z0-9+/=]+)|\/\*# sourceMappingURL=data:application\/json;base64,([A-Za-z0-9+/=]+) \*\/)\s*$/g;
+    let sourceMap = null;
+    let code = source.replace(sourceMapPattern, (_match, lineComment, blockComment) => {
+        sourceMap = Buffer.from(lineComment ?? blockComment, 'base64').toString('utf-8');
+        return '';
+    });
+    return { code, sourceMap };
+}
 async function minifyModule(rawCode, resolvedPath, target, sourceMaps) {
     try {
         let result = await minify(resolvedPath, rawCode, {
@@ -324,7 +530,7 @@ async function getUnresolvedImportsFromLexer(rawCode) {
     let unresolvedImports = [];
     for (let imported of imports) {
         let specifier = getStaticImportSpecifier(rawCode, imported);
-        if (specifier == null || shouldSkipImportSpecifier(specifier))
+        if (specifier == null || isBrowserExternalModuleUrl(specifier))
             continue;
         unresolvedImports.push({
             specifier,
@@ -338,6 +544,9 @@ async function getUnresolvedImportsFromLexer(rawCode) {
 function getDisplayImportSpecifier(specifier) {
     return restoreAuthoredInjectedPackageSpecifier(specifier) ?? specifier;
 }
+function isBrowserExternalModuleUrl(url) {
+    return url.startsWith('data:') || url.startsWith('http://') || url.startsWith('https://');
+}
 function maskAuthoredInjectedPackageImports(sourceText, resolvedPath) {
     if (!mayContainInjectedPackageSpecifier(sourceText)) {
         return sourceText;
@@ -423,11 +632,6 @@ function getStaticImportSpecifier(source, imported) {
 function isStaticTemplateLiteral(specifier) {
     return specifier.startsWith('`') && specifier.endsWith('`') && !specifier.includes('${');
 }
-function shouldSkipImportSpecifier(specifier) {
-    return (specifier.startsWith('data:') ||
-        specifier.startsWith('http://') ||
-        specifier.startsWith('https://'));
-}
 function getImportQuote(source, start) {
     let firstCharacter = source[start];
     if (firstCharacter === '"' || firstCharacter === "'" || firstCharacter === '`') {

package/dist/lib/source-maps.js

@@ -1,5 +1,5 @@
 import { SourceMapConsumer, SourceMapGenerator } from 'source-map-js';
-import { normalizeFilePath } from "./paths.js";
+import { normalizeFilePath } from './paths.js';
 export function composeSourceMaps(rewriteSourceMap, transformSourceMap) {
     let rewriteConsumer = new SourceMapConsumer(JSON.parse(rewriteSourceMap));
     let transformConsumer = new SourceMapConsumer(JSON.parse(transformSourceMap));

package/dist/lib/styles/compiler.d.ts

@@ -24,6 +24,9 @@ type StyleCompilerOptions = {
     getServedFileUrl?(identityPath: string, options: {
         transform: readonly string[] | null;
     }): Promise<string>;
+    hmr?: {
+        send(pathname: string, timestamp: number): void;
+    };
     isAllowed(absolutePath: string): boolean;
     isServedFilePath(filePath: string): boolean;
     minify: boolean;
@@ -31,6 +34,10 @@ type StyleCompilerOptions = {
         add: string[];
         remove: string[];
     }) => void;
+    onWatchFilesChange?: (delta: {
+        add: string[];
+        remove: string[];
+    }) => void;
     rootDir: string;
     routes: CompiledRoutes;
     sourceMapSourcePaths: 'absolute' | 'url';
@@ -42,7 +49,13 @@ type StyleCompiler = {
     getHref(filePath: string): Promise<string>;
     getPreloadLayers(filePath: string | readonly string[]): Promise<string[][]>;
     getStyle(filePath: string, options: StyleGetOptions): Promise<StyleGetResult>;
-    handleFileEvent(filePath: string, event: 'add' | 'change' | 'unlink'): Promise<void>;
+    classifyHmrFileEvent(filePath: string, event: 'add' | 'change' | 'unlink'): Promise<StyleHmrUpdate[]>;
+    invalidateFileEvent(filePath: string, event: 'add' | 'change' | 'unlink'): void;
+};
+export type StyleHmrUpdate = {
+    filePath: string;
+    path: string;
+    timestamp: number;
 };
 export declare function createStyleCompiler(options: StyleCompilerOptions): StyleCompiler;
 export declare function isStyleFilePath(filePath: string): boolean;

package/dist/lib/styles/compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/lib/styles/compiler.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,WAAW,CAAA;AAS3D,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,YAAY,GAAG,IAAI,CAAA;CAC/B,CAAA;AAED,KAAK,cAAc,GACf;IACE,KAAK,EAAE,kBAAkB,CAAA;IACzB,IAAI,EAAE,OAAO,CAAA;CACd,GACD;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,cAAc,CAAA;CACrB,CAAA;AAEL,KAAK,eAAe,GAAG;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,gBAAgB,CAAC,CACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;QACP,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;KACpC,GACA,OAAO,CAAC,MAAM,CAAC,CAAA;IAClB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAA;IACxC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3C,MAAM,EAAE,OAAO,CAAA;IACf,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAA;IAC/E,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;IACtB,oBAAoB,EAAE,UAAU,GAAG,KAAK,CAAA;IACxC,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAA;IAClC,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAChC,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC1C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC7E,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACrF,CAAA;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAmOhF;AAkED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE;IACP,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;CACf,GACA,QAAQ,CA6BV"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/lib/styles/compiler.ts"],"names":[],"mappings":"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"}