@remix-run/assets 0.1.0 → 0.2.0

package/dist/lib/styles/transform.js

@@ -0,0 +1,131 @@
+import * as fs from 'node:fs/promises';
+import { transform } from 'lightningcss';
+import { createAssetServerCompilationError, isAssetServerCompilationError, } from "../compilation-error.js";
+import { generateFingerprint } from "../fingerprint.js";
+import { rewriteSourceMapSources, stringifySourceMap } from "../source-maps.js";
+export async function transformStyle(record, args) {
+    let resolvedPath = record.identityPath;
+    let trackedFiles = args.isWatchIgnored(resolvedPath) ? [] : [resolvedPath];
+    let rawBytes;
+    try {
+        rawBytes = new Uint8Array(await fs.readFile(resolvedPath));
+    }
+    catch (error) {
+        if (isNoEntityError(error)) {
+            return {
+                ok: false,
+                error: createAssetServerCompilationError(`File not found: ${resolvedPath}`, {
+                    cause: error,
+                    code: 'FILE_NOT_FOUND',
+                }),
+                tracking: {
+                    trackedFiles,
+                },
+            };
+        }
+        return {
+            ok: false,
+            error: toTransformFailedError(error, resolvedPath),
+            tracking: {
+                trackedFiles,
+            },
+        };
+    }
+    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 transformResult = runLightningTransform(resolvedPath, rawBytes, {
+            minify: args.minify,
+            sourceMap: args.sourceMaps != null,
+            targets: args.targets,
+        });
+        let sourceText = Buffer.from(rawBytes).toString('utf8');
+        let sourceMap = stringifySourceMap(transformResult.map);
+        sourceMap = sourceMap
+            ? rewriteSourceMapSources(sourceMap, resolvedPath, stableUrlPathname, args.sourceMapSourcePaths, sourceText)
+            : null;
+        let unresolvedDependencies = [];
+        for (let dependency of transformResult.dependencies ?? []) {
+            if (dependency.type === 'import') {
+                unresolvedDependencies.push({
+                    placeholder: dependency.placeholder,
+                    type: 'import',
+                    url: dependency.url,
+                });
+                continue;
+            }
+            if (dependency.type === 'url') {
+                unresolvedDependencies.push({
+                    placeholder: dependency.placeholder,
+                    type: 'url',
+                    url: dependency.url,
+                });
+            }
+        }
+        return {
+            ok: true,
+            tracking: {
+                trackedFiles,
+            },
+            value: {
+                fingerprint: args.buildId === null
+                    ? null
+                    : await generateFingerprint({
+                        buildId: args.buildId,
+                        content: sourceText,
+                    }),
+                identityPath: record.identityPath,
+                rawCode: Buffer.from(transformResult.code).toString('utf8'),
+                resolvedPath,
+                sourceMap,
+                stableUrlPathname,
+                trackedFiles,
+                unresolvedDependencies,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            error: toTransformFailedError(error, resolvedPath),
+            tracking: {
+                trackedFiles,
+            },
+        };
+    }
+}
+function runLightningTransform(identityPath, code, options) {
+    try {
+        return transform({
+            analyzeDependencies: {
+                preserveImports: true,
+            },
+            code,
+            filename: identityPath,
+            minify: options.minify,
+            sourceMap: options.sourceMap,
+            targets: options.targets ?? undefined,
+        });
+    }
+    catch (error) {
+        throw createAssetServerCompilationError(`Failed to transform style ${identityPath}. ${error instanceof Error ? error.message : String(error)}`, {
+            cause: error,
+            code: 'TRANSFORM_FAILED',
+        });
+    }
+}
+function toTransformFailedError(error, resolvedPath) {
+    if (isAssetServerCompilationError(error))
+        return error;
+    return createAssetServerCompilationError(`Failed to transform style ${resolvedPath}. ${error instanceof Error ? error.message : String(error)}`, {
+        cause: error,
+        code: 'TRANSFORM_FAILED',
+    });
+}
+function isNoEntityError(error) {
+    return (error instanceof Error && 'code' in error && error.code === 'ENOENT');
+}

package/dist/lib/target.d.ts

@@ -0,0 +1,21 @@
+import type { Targets as LightningCssTargets } from 'lightningcss';
+declare const browserTargetNames: readonly ["chrome", "edge", "firefox", "ie", "ios", "opera", "safari", "samsung"];
+export type AssetTargetVersion = `${number}` | `${number}.${number}` | `${number}.${number}.${number}`;
+export type BrowserTargetName = (typeof browserTargetNames)[number];
+export type ResolvedScriptTarget = string[];
+export type ResolvedStyleTarget = LightningCssTargets;
+export interface AssetTarget {
+    chrome?: AssetTargetVersion;
+    edge?: AssetTargetVersion;
+    firefox?: AssetTargetVersion;
+    ie?: AssetTargetVersion;
+    ios?: AssetTargetVersion;
+    opera?: AssetTargetVersion;
+    safari?: AssetTargetVersion;
+    samsung?: AssetTargetVersion;
+    es?: string;
+}
+export declare function resolveScriptTarget(target: AssetTarget | undefined): ResolvedScriptTarget | undefined;
+export declare function resolveStyleTarget(target: AssetTarget | undefined): ResolvedStyleTarget | undefined;
+export {};
+//# sourceMappingURL=target.d.ts.map

package/dist/lib/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/lib/target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElE,QAAA,MAAM,kBAAkB,mFASd,CAAA;AAeV,MAAM,MAAM,kBAAkB,GAC1B,GAAG,MAAM,EAAE,GACX,GAAG,MAAM,IAAI,MAAM,EAAE,GACrB,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAA;AACnC,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AACnE,MAAM,MAAM,oBAAoB,GAAG,MAAM,EAAE,CAAA;AAC3C,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAA;AAErD,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,IAAI,CAAC,EAAE,kBAAkB,CAAA;IACzB,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B,EAAE,CAAC,EAAE,kBAAkB,CAAA;IACvB,GAAG,CAAC,EAAE,kBAAkB,CAAA;IACxB,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAMD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,oBAAoB,GAAG,SAAS,CAgBlC;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,mBAAmB,GAAG,SAAS,CAajC"}

package/dist/lib/target.js

@@ -0,0 +1,127 @@
+const browserTargetNames = [
+    'chrome',
+    'edge',
+    'firefox',
+    'ie',
+    'ios',
+    'opera',
+    'safari',
+    'samsung',
+];
+const browserTargetNameSet = new Set(browserTargetNames);
+const lightningCssTargetNameByBrowserTargetName = {
+    chrome: 'chrome',
+    edge: 'edge',
+    firefox: 'firefox',
+    ie: 'ie',
+    ios: 'ios_saf',
+    opera: 'opera',
+    safari: 'safari',
+    samsung: 'samsung',
+};
+export function resolveScriptTarget(target) {
+    let resolvedTarget = normalizeScriptTargetObject(target, 'target');
+    if (!resolvedTarget)
+        return undefined;
+    let oxcTarget = [];
+    if (resolvedTarget.es) {
+        oxcTarget.push(resolvedTarget.es);
+    }
+    for (let browserTargetName of browserTargetNames) {
+        let version = resolvedTarget[browserTargetName];
+        if (version == null)
+            continue;
+        oxcTarget.push(`${browserTargetName}${version}`);
+    }
+    return oxcTarget;
+}
+export function resolveStyleTarget(target) {
+    let resolvedTarget = normalizeStyleTargetObject(target, 'target');
+    if (!resolvedTarget)
+        return undefined;
+    let lightningCssTargets = {};
+    for (let browserTargetName of browserTargetNames) {
+        let version = resolvedTarget[browserTargetName];
+        if (version == null)
+            continue;
+        lightningCssTargets[lightningCssTargetNameByBrowserTargetName[browserTargetName]] =
+            toLightningCssTargetVersion(version);
+    }
+    return lightningCssTargets;
+}
+function normalizeScriptTargetObject(target, optionPath) {
+    if (target == null)
+        return undefined;
+    if (!isPlainObject(target)) {
+        throw new TypeError(`${optionPath} must be an object`);
+    }
+    let normalizedTarget = {};
+    for (let [key, value] of Object.entries(target)) {
+        if (key === 'es') {
+            normalizedTarget.es = normalizeScriptTargetVersion(value, `${optionPath}.es`);
+            continue;
+        }
+        if (!browserTargetNameSet.has(key)) {
+            throw new TypeError(`${optionPath}.${key} is not a supported target`);
+        }
+        normalizedTarget[key] = normalizeBrowserTargetVersion(value, `${optionPath}.${key}`);
+    }
+    return Object.keys(normalizedTarget).length === 0 ? undefined : normalizedTarget;
+}
+function normalizeStyleTargetObject(target, optionPath) {
+    if (target == null)
+        return undefined;
+    if (!isPlainObject(target)) {
+        throw new TypeError(`${optionPath} must be an object`);
+    }
+    let normalizedTarget = {};
+    for (let [key, value] of Object.entries(target)) {
+        if (key === 'es') {
+            continue;
+        }
+        if (!browserTargetNameSet.has(key)) {
+            throw new TypeError(`${optionPath}.${key} is not a supported target`);
+        }
+        normalizedTarget[key] = normalizeBrowserTargetVersion(value, `${optionPath}.${key}`);
+    }
+    return Object.keys(normalizedTarget).length === 0 ? undefined : normalizedTarget;
+}
+function normalizeScriptTargetVersion(value, optionPath) {
+    if (typeof value !== 'string') {
+        throw new TypeError(`${optionPath} must be a string`);
+    }
+    let normalizedValue = value.trim();
+    if (normalizedValue.length === 0) {
+        throw new TypeError(`${optionPath} must be a non-empty string`);
+    }
+    if (!/^\d+$/.test(normalizedValue)) {
+        throw new TypeError(`${optionPath} must use a single numeric year like "2020"`);
+    }
+    if (!/^\d{4}$/.test(normalizedValue) || Number(normalizedValue) < 2015) {
+        throw new TypeError(`${optionPath} must use a four-digit year of 2015 or higher`);
+    }
+    return `es${normalizedValue}`;
+}
+function normalizeBrowserTargetVersion(value, optionPath) {
+    if (typeof value !== 'string') {
+        throw new TypeError(`${optionPath} must be a string`);
+    }
+    if (value.trim().length === 0) {
+        throw new TypeError(`${optionPath} must be a non-empty string`);
+    }
+    if (!/^\d+(\.\d+){0,2}$/.test(value)) {
+        throw new TypeError(`${optionPath} must use "X", "X.Y", or "X.Y.Z" version format`);
+    }
+    let segments = value.split('.').map(Number);
+    if (segments.some((segment) => segment > 255)) {
+        throw new TypeError(`${optionPath} must use version components between 0 and 255`);
+    }
+    return value;
+}
+function toLightningCssTargetVersion(version) {
+    let [major, minor = 0, patch = 0] = version.split('.').map(Number);
+    return major * 65536 + minor * 256 + patch;
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@remix-run/assets",
-  "version": "0.1.0",
-  "description": "Fetch-based server for compiling browser JS/TS assets on demand",
+  "version": "0.2.0",
+  "description": "Fetch-based server for compiling browser JS/TS and CSS assets on demand",
   "author": "Michael Jackson <mjijackson@gmail.com>",
   "license": "MIT",
   "repository": {
@@ -29,22 +29,27 @@
     "chokidar": "^5.0.0",
     "es-module-lexer": "^2.0.0",
     "get-tsconfig": "^4.13.6",
+    "lightningcss": "^1.32.0",
     "magic-string": "^0.30.21",
     "oxc-minify": "^0.121.0",
     "oxc-parser": "^0.121.0",
     "oxc-resolver": "^11.19.1",
     "oxc-transform": "^0.121.0",
+    "picomatch": "^4.0.4",
     "source-map-js": "^1.2.1",
     "@remix-run/headers": "0.19.0",
     "@remix-run/route-pattern": "0.20.1"
   },
   "devDependencies": {
     "@types/node": "^24.6.0",
+    "@types/picomatch": "^4.0.3",
     "@typescript/native-preview": "7.0.0-dev.20251125.1"
   },
   "keywords": [
     "remix",
     "scripts",
+    "styles",
+    "css",
     "assets",
     "transform",
     "server"