@zealakit/css-doctor-remix 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zealamic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,64 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @zealakit/css-doctor-remix
+
+**Remix 3 asset-server middleware for runtime CSS optimization.**
+
+[English](https://github.com/zealakit/css-doctor/blob/main/packages/css-doctor-remix/README.md) | [Tiếng Việt](https://github.com/zealakit/css-doctor/blob/main/packages/css-doctor-remix/README_VI.md) | [简体中文](https://github.com/zealakit/css-doctor/blob/main/packages/css-doctor-remix/README_CN.md)
+
+</div>
+
+---
+
+![css doctor](https://github.com/zealakit/css-doctor/blob/main/assets/images/css-doctor.jpg)
+
+## Installation
+
+```bash
+pnpm add @zealakit/css-doctor-remix
+```
+
+## Usage
+
+```ts
+import { createAssetServer } from "remix/assets";
+import { withCssDoctorAssets } from "@zealakit/css-doctor-remix";
+
+const baseAssets = createAssetServer({
+  basePath: "/assets",
+  rootDir: process.cwd(),
+  allowFiles: ["app/**/public/**", "app/routes.ts"],
+  allowPackages: ["remix"],
+});
+
+export const assets = withCssDoctorAssets(baseAssets, {
+  sizeBudget: {
+    enabled: true,
+    maxChunkSize: 30 * 1024,
+    isolateVariables: true,
+  },
+  minify: process.env.NODE_ENV === "production",
+  cache: { enabled: true, maxEntries: 100 },
+  exclude: [/\.module\.(css|scss)$/],
+});
+```
+
+## Options
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `sizeBudget.enabled` | `true` | Enable byte-budget splitting. |
+| `sizeBudget.maxChunkSize` | `60 * 1024` | Maximum bytes per emitted chunk. |
+| `sizeBudget.isolateVariables` | `true` | Extract `:root` and `@theme` variables first. |
+| `minify` | production | Minify emitted CSS with LightningCSS. |
+
+## Safety and limitations
+
+- No pageCoverage: Remix 3 has no build-time route-to-CSS graph.
+- Optimizes successful text/css GET responses and falls back to the original response on failure.
+- Uses an LRU cache based on URL, source ETag, and content hash.
+- Load page-specific module stylesheets from controller actions, not a global document head.
+
+## Full documentation
+
+Project README: [English](https://github.com/zealakit/css-doctor/blob/main/README.md) | [Tiếng Việt](https://github.com/zealakit/css-doctor/blob/main/README_VI.md) | [简体中文](https://github.com/zealakit/css-doctor/blob/main/README_CN.md)

package/README_CN.md

@@ -0,0 +1,64 @@
+<div align="center">
+
+# @zealakit/css-doctor-remix
+
+**用于运行时 CSS 优化的 Remix 3 Asset Server 中间件。**
+
+[English](https://github.com/zealakit/css-doctor/blob/main/packages/css-doctor-remix/README.md) | [Tiếng Việt](https://github.com/zealakit/css-doctor/blob/main/packages/css-doctor-remix/README_VI.md) | [简体中文](https://github.com/zealakit/css-doctor/blob/main/packages/css-doctor-remix/README_CN.md)
+
+</div>
+
+---
+
+![css doctor](https://github.com/zealakit/css-doctor/blob/main/assets/images/css-doctor.jpg)
+
+## 安装
+
+```bash
+pnpm add @zealakit/css-doctor-remix
+```
+
+## 使用
+
+```ts
+import { createAssetServer } from "remix/assets";
+import { withCssDoctorAssets } from "@zealakit/css-doctor-remix";
+
+const baseAssets = createAssetServer({
+  basePath: "/assets",
+  rootDir: process.cwd(),
+  allowFiles: ["app/**/public/**", "app/routes.ts"],
+  allowPackages: ["remix"],
+});
+
+export const assets = withCssDoctorAssets(baseAssets, {
+  sizeBudget: {
+    enabled: true,
+    maxChunkSize: 30 * 1024,
+    isolateVariables: true,
+  },
+  minify: process.env.NODE_ENV === "production",
+  cache: { enabled: true, maxEntries: 100 },
+  exclude: [/\.module\.(css|scss)$/],
+});
+```
+
+## 配置
+
+| 参数 | 默认值 | 说明 |
+| --- | --- | --- |
+| `sizeBudget.enabled` | `true` | 启用按字节预算分割。 |
+| `sizeBudget.maxChunkSize` | `60 * 1024` | 每个 chunk 的最大字节数。 |
+| `sizeBudget.isolateVariables` | `true` | 先提取 `:root` 与 `@theme` 变量。 |
+| `minify` | production | 使用 LightningCSS 压缩输出 CSS。 |
+
+## 安全与限制
+
+- 不支持 pageCoverage：Remix 3 没有构建期 route-to-CSS 图。
+- 优化成功的 text/css GET 响应，失败时回退原始响应。
+- 使用基于 URL、源 ETag 和内容哈希的 LRU 缓存。
+- 按 controller action 加载页面 module 样式，不要硬编码到全局 document head。
+
+## 完整文档
+
+项目 README：[English](https://github.com/zealakit/css-doctor/blob/main/README.md) | [Tiếng Việt](https://github.com/zealakit/css-doctor/blob/main/README_VI.md) | [简体中文](https://github.com/zealakit/css-doctor/blob/main/README_CN.md)

package/README_VI.md

@@ -0,0 +1,64 @@
+<div align="center">
+
+# @zealakit/css-doctor-remix
+
+**Middleware asset server Remix 3 tối ưu CSS runtime.**
+
+[English](https://github.com/zealakit/css-doctor/blob/main/packages/css-doctor-remix/README.md) | [Tiếng Việt](https://github.com/zealakit/css-doctor/blob/main/packages/css-doctor-remix/README_VI.md) | [简体中文](https://github.com/zealakit/css-doctor/blob/main/packages/css-doctor-remix/README_CN.md)
+
+</div>
+
+---
+
+![css doctor](https://github.com/zealakit/css-doctor/blob/main/assets/images/css-doctor.jpg)
+
+## Cài đặt
+
+```bash
+pnpm add @zealakit/css-doctor-remix
+```
+
+## Sử dụng
+
+```ts
+import { createAssetServer } from "remix/assets";
+import { withCssDoctorAssets } from "@zealakit/css-doctor-remix";
+
+const baseAssets = createAssetServer({
+  basePath: "/assets",
+  rootDir: process.cwd(),
+  allowFiles: ["app/**/public/**", "app/routes.ts"],
+  allowPackages: ["remix"],
+});
+
+export const assets = withCssDoctorAssets(baseAssets, {
+  sizeBudget: {
+    enabled: true,
+    maxChunkSize: 30 * 1024,
+    isolateVariables: true,
+  },
+  minify: process.env.NODE_ENV === "production",
+  cache: { enabled: true, maxEntries: 100 },
+  exclude: [/\.module\.(css|scss)$/],
+});
+```
+
+## Tùy chọn
+
+| Tùy chọn | Mặc định | Mô tả |
+| --- | --- | --- |
+| `sizeBudget.enabled` | `true` | Bật chia nhỏ theo byte budget. |
+| `sizeBudget.maxChunkSize` | `60 * 1024` | Số byte tối đa mỗi chunk. |
+| `sizeBudget.isolateVariables` | `true` | Tách biến `:root` và `@theme` trước. |
+| `minify` | production | Minify CSS bằng LightningCSS. |
+
+## An toàn và giới hạn
+
+- Không có pageCoverage: Remix 3 không có route-to-CSS graph lúc build.
+- Tối ưu response text/css thành công và fallback response gốc khi lỗi.
+- Dùng LRU cache theo URL, ETag gốc và content hash.
+- Nạp stylesheet module theo action controller, không hardcode toàn bộ vào document head.
+
+## Tài liệu đầy đủ
+
+README dự án: [English](https://github.com/zealakit/css-doctor/blob/main/README.md) | [Tiếng Việt](https://github.com/zealakit/css-doctor/blob/main/README_VI.md) | [简体中文](https://github.com/zealakit/css-doctor/blob/main/README_CN.md)

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/** Tier 2: physical size-budget splitting. */
+type SizeBudgetOptions = {
+    /** Enable size-budget splitting. @default true */
+    enabled?: boolean;
+    /** Maximum serialized bytes per body chunk. @default 60 * 1024 */
+    maxChunkSize?: number;
+    /** Isolate CSS variables before splitting. @default true */
+    isolateVariables?: boolean;
+};
+/** Memory cache configuration. */
+type CssDoctorRemixCacheOptions = {
+    /** Enable the optimized-response cache. @default true */
+    enabled?: boolean;
+    /** Maximum number of cached CSS responses. @default 100 */
+    maxEntries?: number;
+};
+/** Configuration for the Remix 3 asset middleware. */
+type CssDoctorRemixOptions = {
+    /** Tier 2 configuration. */
+    sizeBudget?: SizeBudgetOptions;
+    /** Minify CSS. Defaults to true only when NODE_ENV is production. */
+    minify?: boolean;
+    /** Memory cache configuration. */
+    cache?: CssDoctorRemixCacheOptions;
+    /** URL patterns for assets that must not be optimized. */
+    exclude?: Array<string | RegExp>;
+};
+/** The subset of Remix's AssetServer used by this adapter. */
+type RemixAssetServerLike = {
+    fetch: (request: Request) => Promise<Response | null>;
+};
+/** A cached, already-optimized CSS response. */
+type CssCacheEntry = {
+    body: string;
+    etag: string;
+    headers: Array<[string, string]>;
+    sizeBytes: number;
+};
+
+/**
+ * Wraps a Remix 3 AssetServer and optimizes CSS responses lazily.
+ *
+ * The original server remains the source of truth for every asset. The wrapper
+ * only intercepts successful `text/css` GET responses, and falls back to the
+ * original Response for every error or unsupported request.
+ */
+declare const withCssDoctorAssets: <T extends RemixAssetServerLike>(assetServer: T, options?: CssDoctorRemixOptions) => T;
+
+export { type CssCacheEntry, type CssDoctorRemixCacheOptions, type CssDoctorRemixOptions, type RemixAssetServerLike, type SizeBudgetOptions, withCssDoctorAssets };

package/dist/index.js

@@ -0,0 +1,183 @@
+// src/asset-middleware.ts
+import { createHash } from "crypto";
+import { optimizeCss } from "@zealakit/css-doctor-binding";
+
+// src/cache-manager.ts
+var CssCacheManager = class {
+  entries = /* @__PURE__ */ new Map();
+  maxEntries;
+  constructor(maxEntries = 100) {
+    this.maxEntries = Math.max(1, Math.floor(maxEntries));
+  }
+  get(key) {
+    const entry = this.entries.get(key);
+    if (!entry) {
+      return void 0;
+    }
+    this.entries.delete(key);
+    this.entries.set(key, entry);
+    return entry;
+  }
+  set(key, entry) {
+    if (this.entries.has(key)) {
+      this.entries.delete(key);
+    }
+    this.entries.set(key, entry);
+    while (this.entries.size > this.maxEntries) {
+      const oldest = this.entries.keys().next().value;
+      if (oldest === void 0) {
+        break;
+      }
+      this.entries.delete(oldest);
+    }
+  }
+  clear() {
+    this.entries.clear();
+  }
+  get size() {
+    return this.entries.size;
+  }
+};
+
+// src/asset-middleware.ts
+var DEFAULT_MAX_CHUNK_SIZE = 60 * 1024;
+var DEFAULT_CACHE_ENTRIES = 100;
+var CSS_MODULE_PATTERN = /\.module\.css$/i;
+var withCssDoctorAssets = (assetServer, options = {}) => {
+  const resolved = resolveOptions(options);
+  const wrappedFetch = async (request) => {
+    let pathname;
+    try {
+      pathname = new URL(request.url).pathname;
+    } catch {
+      return assetServer.fetch(request);
+    }
+    if (request.method !== "GET" || !pathname.toLowerCase().endsWith(".css") || shouldSkipPath(pathname, resolved.exclude)) {
+      return assetServer.fetch(request);
+    }
+    const response = await assetServer.fetch(request);
+    if (!response || response.status !== 200) {
+      return response;
+    }
+    const contentType = response.headers.get("content-type") ?? "";
+    if (!contentType.toLowerCase().startsWith("text/css")) {
+      return response;
+    }
+    let originalCss;
+    try {
+      originalCss = await response.clone().text();
+    } catch {
+      return response;
+    }
+    const contentHash = hash(originalCss);
+    const etag = response.headers.get("etag") ?? "";
+    const cacheKey = `${request.url}|${etag}|${contentHash}`;
+    if (resolved.cacheEnabled) {
+      const cached = resolved.cache.get(cacheKey);
+      if (cached) {
+        return createResponse(cached, response);
+      }
+    }
+    try {
+      const pipeline = optimizeCss({
+        cssContent: originalCss,
+        pageUsage: {},
+        pageCoverage: {
+          enabled: false,
+          minPageRatio: 0.5,
+          forceCommon: []
+        },
+        sizeBudget: {
+          enabled: resolved.sizeBudget.enabled,
+          maxChunkSize: resolved.sizeBudget.maxChunkSize,
+          isolateVariables: resolved.sizeBudget.isolateVariables
+        },
+        minify: resolved.minify
+      });
+      const optimizedCss = pipeline.chunks.filter((chunk) => chunk.page === void 0).map((chunk) => chunk.css).join("\n");
+      if (optimizedCss.length === 0) {
+        return response;
+      }
+      const optimizedHash = hash(optimizedCss);
+      const headers = new Headers(response.headers);
+      headers.delete("content-encoding");
+      headers.delete("transfer-encoding");
+      headers.set("content-type", "text/css; charset=utf-8");
+      headers.set(
+        "content-length",
+        String(Buffer.byteLength(optimizedCss, "utf8"))
+      );
+      headers.set("etag", `W/"cssd-${optimizedHash.slice(0, 16)}"`);
+      const headerEntries = [];
+      headers.forEach((value, key) => {
+        headerEntries.push([key, value]);
+      });
+      const entry = {
+        body: optimizedCss,
+        etag: headers.get("etag") ?? "",
+        headers: headerEntries,
+        sizeBytes: Buffer.byteLength(optimizedCss, "utf8")
+      };
+      if (resolved.cacheEnabled) {
+        resolved.cache.set(cacheKey, entry);
+      }
+      return createResponse(entry, response);
+    } catch (error) {
+      console.warn(
+        `[css-doctor:remix] failed to optimize ${pathname}; serving the original asset: ${describeError(error)}`
+      );
+      return response;
+    }
+  };
+  return new Proxy(assetServer, {
+    get(target, property) {
+      if (property === "fetch") {
+        return wrappedFetch;
+      }
+      const value = Reflect.get(target, property, target);
+      return typeof value === "function" ? value.bind(target) : value;
+    }
+  });
+};
+function resolveOptions(options) {
+  const maxChunkSize = options.sizeBudget?.maxChunkSize ?? DEFAULT_MAX_CHUNK_SIZE;
+  const maxEntries = options.cache?.maxEntries ?? DEFAULT_CACHE_ENTRIES;
+  return {
+    sizeBudget: {
+      enabled: options.sizeBudget?.enabled ?? true,
+      maxChunkSize: Number.isInteger(maxChunkSize) && maxChunkSize > 0 ? maxChunkSize : DEFAULT_MAX_CHUNK_SIZE,
+      isolateVariables: options.sizeBudget?.isolateVariables ?? true
+    },
+    minify: options.minify ?? process.env.NODE_ENV === "production",
+    cacheEnabled: options.cache?.enabled ?? true,
+    cache: new CssCacheManager(
+      Number.isInteger(maxEntries) && maxEntries > 0 ? maxEntries : DEFAULT_CACHE_ENTRIES
+    ),
+    exclude: options.exclude ?? []
+  };
+}
+function shouldSkipPath(pathname, exclude) {
+  if (CSS_MODULE_PATTERN.test(pathname)) {
+    return true;
+  }
+  return exclude.some(
+    (pattern) => typeof pattern === "string" ? pathname.includes(pattern) : pattern.test(pathname)
+  );
+}
+function createResponse(entry, original) {
+  return new Response(entry.body, {
+    status: original.status,
+    statusText: original.statusText,
+    headers: new Headers(entry.headers)
+  });
+}
+function hash(value) {
+  return createHash("sha256").update(value).digest("hex");
+}
+function describeError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+export {
+  withCssDoctorAssets
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/asset-middleware.ts","../src/cache-manager.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport { optimizeCss } from \"@zealakit/css-doctor-binding\";\nimport type { JsChunkOutput } from \"@zealakit/css-doctor-binding\";\n\nimport { CssCacheManager } from \"./cache-manager\";\nimport type {\n  CssCacheEntry,\n  CssDoctorRemixOptions,\n  RemixAssetServerLike,\n  SizeBudgetOptions,\n} from \"./types\";\n\nconst DEFAULT_MAX_CHUNK_SIZE = 60 * 1_024;\nconst DEFAULT_CACHE_ENTRIES = 100;\nconst CSS_MODULE_PATTERN = /\\.module\\.css$/i;\n\ntype ResolvedOptions = {\n  sizeBudget: Required<SizeBudgetOptions>;\n  minify: boolean;\n  cacheEnabled: boolean;\n  cache: CssCacheManager;\n  exclude: Array<string | RegExp>;\n};\n\n/**\n * Wraps a Remix 3 AssetServer and optimizes CSS responses lazily.\n *\n * The original server remains the source of truth for every asset. The wrapper\n * only intercepts successful `text/css` GET responses, and falls back to the\n * original Response for every error or unsupported request.\n */\nexport const withCssDoctorAssets = <T extends RemixAssetServerLike>(\n  assetServer: T,\n  options: CssDoctorRemixOptions = {},\n): T => {\n  const resolved = resolveOptions(options);\n  const wrappedFetch = async (request: Request): Promise<Response | null> => {\n    let pathname: string;\n\n    try {\n      pathname = new URL(request.url).pathname;\n    } catch {\n      return assetServer.fetch(request);\n    }\n\n    if (\n      request.method !== \"GET\" ||\n      !pathname.toLowerCase().endsWith(\".css\") ||\n      shouldSkipPath(pathname, resolved.exclude)\n    ) {\n      return assetServer.fetch(request);\n    }\n\n    const response = await assetServer.fetch(request);\n\n    if (!response || response.status !== 200) {\n      return response;\n    }\n\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n\n    if (!contentType.toLowerCase().startsWith(\"text/css\")) {\n      return response;\n    }\n\n    let originalCss: string;\n\n    try {\n      originalCss = await response.clone().text();\n    } catch {\n      return response;\n    }\n\n    const contentHash = hash(originalCss);\n    const etag = response.headers.get(\"etag\") ?? \"\";\n    const cacheKey = `${request.url}|${etag}|${contentHash}`;\n\n    if (resolved.cacheEnabled) {\n      const cached = resolved.cache.get(cacheKey);\n\n      if (cached) {\n        return createResponse(cached, response);\n      }\n    }\n\n    try {\n      const pipeline = optimizeCss({\n        cssContent: originalCss,\n        pageUsage: {},\n        pageCoverage: {\n          enabled: false,\n          minPageRatio: 0.5,\n          forceCommon: [],\n        },\n        sizeBudget: {\n          enabled: resolved.sizeBudget.enabled,\n          maxChunkSize: resolved.sizeBudget.maxChunkSize,\n          isolateVariables: resolved.sizeBudget.isolateVariables,\n        },\n        minify: resolved.minify,\n      });\n      const optimizedCss = pipeline.chunks\n        .filter((chunk: JsChunkOutput) => chunk.page === undefined)\n        .map((chunk: JsChunkOutput) => chunk.css)\n        .join(\"\\n\");\n\n      if (optimizedCss.length === 0) {\n        return response;\n      }\n\n      const optimizedHash = hash(optimizedCss);\n      const headers = new Headers(response.headers);\n\n      headers.delete(\"content-encoding\");\n      headers.delete(\"transfer-encoding\");\n      headers.set(\"content-type\", \"text/css; charset=utf-8\");\n      headers.set(\n        \"content-length\",\n        String(Buffer.byteLength(optimizedCss, \"utf8\")),\n      );\n      headers.set(\"etag\", `W/\"cssd-${optimizedHash.slice(0, 16)}\"`);\n\n      const headerEntries: Array<[string, string]> = [];\n      headers.forEach((value, key) => {\n        headerEntries.push([key, value]);\n      });\n\n      const entry: CssCacheEntry = {\n        body: optimizedCss,\n        etag: headers.get(\"etag\") ?? \"\",\n        headers: headerEntries,\n        sizeBytes: Buffer.byteLength(optimizedCss, \"utf8\"),\n      };\n\n      if (resolved.cacheEnabled) {\n        resolved.cache.set(cacheKey, entry);\n      }\n\n      return createResponse(entry, response);\n    } catch (error) {\n      console.warn(\n        `[css-doctor:remix] failed to optimize ${pathname}; serving the original asset: ${describeError(error)}`,\n      );\n      return response;\n    }\n  };\n\n  return new Proxy(assetServer, {\n    get(target, property) {\n      if (property === \"fetch\") {\n        return wrappedFetch;\n      }\n\n      const value = Reflect.get(target, property, target);\n\n      return typeof value === \"function\" ? value.bind(target) : value;\n    },\n  }) as T;\n};\n\nfunction resolveOptions(options: CssDoctorRemixOptions): ResolvedOptions {\n  const maxChunkSize =\n    options.sizeBudget?.maxChunkSize ?? DEFAULT_MAX_CHUNK_SIZE;\n  const maxEntries = options.cache?.maxEntries ?? DEFAULT_CACHE_ENTRIES;\n\n  return {\n    sizeBudget: {\n      enabled: options.sizeBudget?.enabled ?? true,\n      maxChunkSize:\n        Number.isInteger(maxChunkSize) && maxChunkSize > 0\n          ? maxChunkSize\n          : DEFAULT_MAX_CHUNK_SIZE,\n      isolateVariables: options.sizeBudget?.isolateVariables ?? true,\n    },\n    minify: options.minify ?? process.env.NODE_ENV === \"production\",\n    cacheEnabled: options.cache?.enabled ?? true,\n    cache: new CssCacheManager(\n      Number.isInteger(maxEntries) && maxEntries > 0\n        ? maxEntries\n        : DEFAULT_CACHE_ENTRIES,\n    ),\n    exclude: options.exclude ?? [],\n  };\n}\n\nfunction shouldSkipPath(\n  pathname: string,\n  exclude: Array<string | RegExp>,\n): boolean {\n  if (CSS_MODULE_PATTERN.test(pathname)) {\n    return true;\n  }\n\n  return exclude.some((pattern) =>\n    typeof pattern === \"string\"\n      ? pathname.includes(pattern)\n      : pattern.test(pathname),\n  );\n}\n\nfunction createResponse(entry: CssCacheEntry, original: Response): Response {\n  return new Response(entry.body, {\n    status: original.status,\n    statusText: original.statusText,\n    headers: new Headers(entry.headers),\n  });\n}\n\nfunction hash(value: string): string {\n  return createHash(\"sha256\").update(value).digest(\"hex\");\n}\n\nfunction describeError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n","import type { CssCacheEntry } from \"./types\";\n\n/**\n * Small insertion-ordered LRU cache for optimized CSS responses.\n *\n * The map keeps the least-recently-used entry first. Reading an entry moves it\n * to the end; writing above capacity evicts the first entry.\n */\nexport class CssCacheManager {\n  private readonly entries = new Map<string, CssCacheEntry>();\n  private readonly maxEntries: number;\n\n  constructor(maxEntries: number = 100) {\n    this.maxEntries = Math.max(1, Math.floor(maxEntries));\n  }\n\n  get(key: string): CssCacheEntry | undefined {\n    const entry = this.entries.get(key);\n\n    if (!entry) {\n      return undefined;\n    }\n\n    this.entries.delete(key);\n    this.entries.set(key, entry);\n    return entry;\n  }\n\n  set(key: string, entry: CssCacheEntry): void {\n    if (this.entries.has(key)) {\n      this.entries.delete(key);\n    }\n\n    this.entries.set(key, entry);\n\n    while (this.entries.size > this.maxEntries) {\n      const oldest = this.entries.keys().next().value;\n\n      if (oldest === undefined) {\n        break;\n      }\n\n      this.entries.delete(oldest);\n    }\n  }\n\n  clear(): void {\n    this.entries.clear();\n  }\n\n  get size(): number {\n    return this.entries.size;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@zealakit/css-doctor-remix",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "Remix 3 asset-server middleware for css-doctor CSS optimization",
+  "author": "nqhed - Huy Edward Nguyen",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README_VI.md",
+    "README_CN.md"
+  ],
+  "dependencies": {
+    "@zealakit/css-doctor-binding": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zealakit/css-doctor.git",
+    "directory": "packages/css-doctor-remix"
+  },
+  "bugs": {
+    "url": "https://github.com/zealakit/css-doctor/issues"
+  },
+  "homepage": "https://github.com/zealakit/css-doctor#readme",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint src",
+    "format": "biome format --write src",
+    "format:check": "biome format src",
+    "check": "biome check src"
+  }
 }