dsh-taiwind 0.1.0 → 0.3.0

package/LICENSE.md

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025-PRESENT dsh-tauri-desk
-
-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.
+MIT License
+
+Copyright (c) 2025-PRESENT dsh-tauri-desk
+
+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

@@ -32,12 +32,10 @@ flowchart LR
 ## ✨ 特性
 
 - **CSS-first**：保留未编译的 `main.css`，支持 `@theme`、`@utility`、`@custom-variant`、`@apply`、`@source inline(...)`。
-- **按需扫描**：从 `clientModules.graph()` 取当前客户端包，`clientPath(id)` 定位构建产物，不依赖插件源码。
 - **官方编译器**：Tailwind 扫描器提取候选类，统一编译；不加载 Preflight，不重置宿主界面。
-- **单一 style**：首屏注入 `<head>`，客户端接管同一个 `<style data-plugin="dsh-taiwind" data-plugin-css="utilities">`。
-- **自动收缩**：删除类名、分包或卸载插件后，下次成功编译即收缩；无磁盘缓存。
-- **失败保留**：运行期编译失败返回 503，已打开页面保留上一份有效样式，修复后自动恢复。
-- **条件请求**：带 ETag 的 CSS 接口，命中返回 304；插件图变化立即刷新，另每两秒检查产物与配置。
+- **单一入口**：首屏注入 `<head>`，客户端接管同一个 `<style data-plugin="dsh-taiwind" data-plugin-css="utilities">`。
+- **热更新**：插件安装/卸载/启停，或客户端产物、`main.css` 改动后都会自动重新编译；已打开的页面无需刷新即可换上新样式，也不必重启宿主。
+- **条件请求**：带 ETag 的 CSS 接口，命中返回 304；内容没变就不读产物、不跑 Tailwind。
 - **完整清理**：停用移除路由、监听、定时器与客户端样式，并取消进行中的请求。
 
 ## 🚀 快速开始
@@ -58,15 +56,24 @@ pnpm add dsh-taiwind
       name: dsh-taiwind
 ```
 
-用户启用业务插件时，`dsh-taiwind` 将随行一起启用，而客户端半也必须有一行启用中的 Loader 条目才会被 `dsh-client-modules` 加载。
+用户启用业务插件时，`dsh-taiwind` 将随行一起启用。
 
-- 它没有界面、没有工具，唯一产物是共享样式接口 `plugins/dsh-taiwind.css` 和页面上的一个 `<style data-plugin="dsh-taiwind">`。
-- 宿主半要求 `clientModules`、`webServer`、`connection` 三件服务齐备。
+- 它没有界面和工具，唯一产物是共享样式接口 `plugins/taiwind.css` 和页面上的 `<style data-plugin="dsh-taiwind">`。
 - 扫描范围是当前客户端图里所有插件的构建产物，插件图变化会自动触发重新编译。
 
-### 2. 在插件包里写样式
+### 2. 声明样式入口
 
-在插件包中保留未编译的 `main.css`，不需要 `tailwind.config.js`，也不用把路径传给本插件：
+在插件包的 `package.json` 里显式声明未编译的 CSS 入口（相对包根，必须位于包内）：
+
+```json
+{
+  "dsh": {
+    "taiwind": "src/main.css"
+  }
+}
+```
+
+`main.css` 保留未编译的 CSS-first 写法：
 
 ```css
 @import "tailwindcss";
@@ -81,17 +88,13 @@ pnpm add dsh-taiwind
 }
 ```
 
-客户端直接使用 `bg-notes-accent w-notes-panel notes-compact` 即可。
-
-入口发现顺序：
+🚀 客户端直接使用 taiwind 类名，例如 `bg-notes-accent w-notes-panel notes-compact` 即可。
 
-1. 包根目录的 `main.css`
-2. 客户端入口同目录的 `client/main.css`
-3. 找到多个会明确报错，不任意选择
+没有声明 `dsh.taiwind` 的包不参与样式编译；声明了但路径不是相对 `.css`、文件不存在或指向包外都会明确报错，不会去猜别的 `main.css`。
 
 ### 3. 发布时携带样式文件
 
-在 `package.json` 中添加 `files` 字段，发布时需要携带 `main.css`：
+在 `package.json` 中添加 `files` 字段，发布时需要携带入口 CSS 及它引用的相对 CSS：
 
 ```json
 {
@@ -104,7 +107,7 @@ pnpm add dsh-taiwind
 
 ## ⚙️ 配置文件（可选）
 
-可在包根目录放一份 `tailwind.config.js`（也认 `.cjs` / `.mjs`），或用 CSS 的 `@config` 显式引用：
+可在包根目录放一份 `tailwind.config.js`，或用 CSS 的 `@config` 显式引用：
 
 ```js
 /** @type {import("tailwindcss").Config} */

package/cordis.patch.yml

@@ -1,3 +1,3 @@
-- insert:
-    - id: dsh-taiwind
-      name: dsh-taiwind
+- insert:
+    - id: dsh-taiwind
+      name: dsh-taiwind

package/dist/client.cjs

@@ -1,4 +1,4 @@
 window.__ModuleLoader__.load({id:"dsh-taiwind",factory:(require)=>{var module={exports:{}};var exports=module.exports;
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=`dsh-taiwind`;function t(){let t=document.head.querySelector(`[data-plugin="dsh-taiwind"][data-plugin-css="utilities"]`),n=t??document.createElement(`style`);n.dataset.plugin=e,n.dataset.pluginCss=`utilities`,t||document.head.append(n);let r=new AbortController,i=``,a=!1,o,s=``,c=async()=>{let t=new AbortController,l=setTimeout(()=>t.abort(),15e3),u=()=>t.abort();r.signal.addEventListener(`abort`,u,{once:!0});try{let e=await fetch(new URL(`plugins/dsh-taiwind.css`,document.baseURI),{credentials:`same-origin`,cache:`no-cache`,headers:i?{"If-None-Match":i}:{},signal:t.signal});if(e.status!==304){if(!e.ok)throw Error(`Stylesheet request failed (${e.status})`);let t=await e.text();a||(n.textContent!==t&&(n.textContent=t),i=e.headers.get(`ETag`)??``)}s=``}catch(t){if(!a){let n=t instanceof Error?t.message:String(t);s!==n&&(s=n,console.warn(`${e}: ${n}; keeping previous stylesheet`))}}finally{clearTimeout(l),r.signal.removeEventListener(`abort`,u),a||(o=setTimeout(()=>void c(),2e3))}};return c(),()=>{a=!0,r.abort(),clearTimeout(o),n.remove()}}function n(e){e.effect(t)}exports.apply=n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=`dsh-taiwind`;function t(){let t=document.head.querySelector(`[data-plugin="dsh-taiwind"][data-plugin-css="utilities"]`),n=t??document.createElement(`style`);n.dataset.plugin=e,n.dataset.pluginCss=`utilities`,t||document.head.append(n);let r=new AbortController,i=``,a=!1,o,s=``,c=async()=>{let t=new AbortController,l=setTimeout(()=>t.abort(),15e3),u=()=>t.abort();r.signal.addEventListener(`abort`,u,{once:!0});try{let e=await fetch(new URL(`plugins/taiwind.css`,document.baseURI),{credentials:`same-origin`,cache:`no-cache`,headers:i?{"If-None-Match":i}:{},signal:t.signal});if(e.status!==304){if(!e.ok)throw Error(`Stylesheet request failed (${e.status})`);let t=await e.text();a||(n.textContent!==t&&(n.textContent=t),i=e.headers.get(`ETag`)??``)}s=``}catch(t){if(!a){let n=t instanceof Error?t.message:String(t);s!==n&&(s=n,console.warn(`${e}: ${n}; keeping previous stylesheet`))}}finally{clearTimeout(l),r.signal.removeEventListener(`abort`,u),a||(o=setTimeout(()=>void c(),2e3))}};return c(),()=>{a=!0,r.abort(),clearTimeout(o),n.remove()}}function n(e){e.effect(t)}exports.apply=n;
 return module.exports;}});
 //# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.cjs","names":[],"sources":["../src/constants.ts","../src/client/styles.ts","../src/client/index.ts"],"sourcesContent":["export const PLUGIN_ID = 'dsh-taiwind'\r\nexport const STYLESHEET_PATH = 'plugins/dsh-taiwind.css'\r\nexport const STYLE_SELECTOR = '[data-plugin=\"dsh-taiwind\"][data-plugin-css=\"utilities\"]'\r\nexport const POLL_INTERVAL_MS = 2000\r\n","import { PLUGIN_ID, POLL_INTERVAL_MS, STYLE_SELECTOR, STYLESHEET_PATH } from '../constants'\r\n\r\nexport function mountStyles(): () => void {\r\n  const existing = document.head.querySelector<HTMLStyleElement>(STYLE_SELECTOR)\r\n  const style = existing ?? document.createElement('style')\r\n  style.dataset.plugin = PLUGIN_ID\r\n  style.dataset.pluginCss = 'utilities'\r\n  if (!existing)\r\n    document.head.append(style)\r\n\r\n  const controller = new AbortController()\r\n  let etag = ''\r\n  let disposed = false\r\n  let timer: ReturnType<typeof setTimeout> | undefined\r\n  let lastError = ''\r\n\r\n  const update = async (): Promise<void> => {\r\n    const request = new AbortController()\r\n    const timeout = setTimeout(() => request.abort(), 15000)\r\n    const abort = (): void => request.abort()\r\n    controller.signal.addEventListener('abort', abort, { once: true })\r\n    try {\r\n      const response = await fetch(new URL(STYLESHEET_PATH, document.baseURI), {\r\n        credentials: 'same-origin',\r\n        cache: 'no-cache',\r\n        headers: etag ? { 'If-None-Match': etag } : {},\r\n        signal: request.signal,\r\n      })\r\n      if (response.status !== 304) {\r\n        if (!response.ok)\r\n          throw new Error(`Stylesheet request failed (${response.status})`)\r\n        const css = await response.text()\r\n        if (!disposed) {\r\n          if (style.textContent !== css)\r\n            style.textContent = css\r\n          etag = response.headers.get('ETag') ?? ''\r\n        }\r\n      }\r\n      lastError = ''\r\n    }\r\n    catch (error) {\r\n      if (!disposed) {\r\n        const message = error instanceof Error ? error.message : String(error)\r\n        if (lastError !== message) {\r\n          lastError = message\r\n          console.warn(`${PLUGIN_ID}: ${message}; keeping previous stylesheet`)\r\n        }\r\n      }\r\n    }\r\n    finally {\r\n      clearTimeout(timeout)\r\n      controller.signal.removeEventListener('abort', abort)\r\n      if (!disposed)\r\n        timer = setTimeout(() => void update(), POLL_INTERVAL_MS)\r\n    }\r\n  }\r\n  void update()\r\n\r\n  return () => {\r\n    disposed = true\r\n    controller.abort()\r\n    clearTimeout(timer)\r\n    style.remove()\r\n  }\r\n}\r\n","import type { Context } from '@deepseek-ai/cordis'\r\nimport { mountStyles } from './styles'\r\n\r\nexport function apply(ctx: Context): void {\r\n  ctx.effect(mountStyles)\r\n}\r\n"],"mappings":";mEAAA,MAAa,EAAY,cCEzB,SAAgB,GAA0B,CACxC,IAAM,EAAW,SAAS,KAAK,cAAgC,0DAAc,EACvE,EAAQ,GAAY,SAAS,cAAc,OAAO,EACxD,EAAM,QAAQ,OAAS,EACvB,EAAM,QAAQ,UAAY,YACrB,GACH,SAAS,KAAK,OAAO,CAAK,EAE5B,IAAM,EAAa,IAAI,gBACnB,EAAO,GACP,EAAW,GACX,EACA,EAAY,GAEV,EAAS,SAA2B,CACxC,IAAM,EAAU,IAAI,gBACd,EAAU,eAAiB,EAAQ,MAAM,EAAG,IAAK,EACjD,MAAoB,EAAQ,MAAM,EACxC,EAAW,OAAO,iBAAiB,QAAS,EAAO,CAAE,KAAM,EAAK,CAAC,EACjE,GAAI,CACF,IAAM,EAAW,MAAM,MAAM,IAAI,IAAI,0BAAiB,SAAS,OAAO,EAAG,CACvE,YAAa,cACb,MAAO,WACP,QAAS,EAAO,CAAE,gBAAiB,CAAK,EAAI,CAAC,EAC7C,OAAQ,EAAQ,MAClB,CAAC,EACD,GAAI,EAAS,SAAW,IAAK,CAC3B,GAAI,CAAC,EAAS,GACZ,MAAU,MAAM,8BAA8B,EAAS,OAAO,EAAE,EAClE,IAAM,EAAM,MAAM,EAAS,KAAK,EAC3B,IACC,EAAM,cAAgB,IACxB,EAAM,YAAc,GACtB,EAAO,EAAS,QAAQ,IAAI,MAAM,GAAK,GAE3C,CACA,EAAY,EACd,OACO,EAAO,CACZ,GAAI,CAAC,EAAU,CACb,IAAM,EAAU,aAAiB,MAAQ,EAAM,QAAU,OAAO,CAAK,EACjE,IAAc,IAChB,EAAY,EACZ,QAAQ,KAAK,GAAG,EAAU,IAAI,EAAQ,8BAA8B,EAExE,CACF,QACQ,CACN,aAAa,CAAO,EACpB,EAAW,OAAO,oBAAoB,QAAS,CAAK,EAC/C,IACH,EAAQ,eAAiB,KAAK,EAAO,EAAG,GAAgB,EAC5D,CACF,EAGA,OAFA,EAAY,MAEC,CACX,EAAW,GACX,EAAW,MAAM,EACjB,aAAa,CAAK,EAClB,EAAM,OAAO,CACf,CACF,CC7DA,SAAgB,EAAM,EAAoB,CACxC,EAAI,OAAO,CAAW,CACxB"}
+{"version":3,"file":"client.cjs","names":[],"sources":["../src/constants.ts","../src/client/styles.ts","../src/client/index.ts"],"sourcesContent":["export const PLUGIN_ID = 'dsh-taiwind'\nexport const STYLESHEET_PATH = 'plugins/taiwind.css'\nexport const STYLE_SELECTOR = '[data-plugin=\"dsh-taiwind\"][data-plugin-css=\"utilities\"]'\nexport const POLL_INTERVAL_MS = 2000\n","import { PLUGIN_ID, POLL_INTERVAL_MS, STYLE_SELECTOR, STYLESHEET_PATH } from '../constants'\n\nexport function mountStyles(): () => void {\n  const existing = document.head.querySelector<HTMLStyleElement>(STYLE_SELECTOR)\n  const style = existing ?? document.createElement('style')\n  style.dataset.plugin = PLUGIN_ID\n  style.dataset.pluginCss = 'utilities'\n  if (!existing)\n    document.head.append(style)\n\n  const controller = new AbortController()\n  let etag = ''\n  let disposed = false\n  let timer: ReturnType<typeof setTimeout> | undefined\n  let lastError = ''\n\n  const update = async (): Promise<void> => {\n    const request = new AbortController()\n    const timeout = setTimeout(() => request.abort(), 15000)\n    const abort = (): void => request.abort()\n    controller.signal.addEventListener('abort', abort, { once: true })\n    try {\n      const response = await fetch(new URL(STYLESHEET_PATH, document.baseURI), {\n        credentials: 'same-origin',\n        cache: 'no-cache',\n        headers: etag ? { 'If-None-Match': etag } : {},\n        signal: request.signal,\n      })\n      if (response.status !== 304) {\n        if (!response.ok)\n          throw new Error(`Stylesheet request failed (${response.status})`)\n        const css = await response.text()\n        if (!disposed) {\n          if (style.textContent !== css)\n            style.textContent = css\n          etag = response.headers.get('ETag') ?? ''\n        }\n      }\n      lastError = ''\n    }\n    catch (error) {\n      if (!disposed) {\n        const message = error instanceof Error ? error.message : String(error)\n        if (lastError !== message) {\n          lastError = message\n          console.warn(`${PLUGIN_ID}: ${message}; keeping previous stylesheet`)\n        }\n      }\n    }\n    finally {\n      clearTimeout(timeout)\n      controller.signal.removeEventListener('abort', abort)\n      if (!disposed)\n        timer = setTimeout(() => void update(), POLL_INTERVAL_MS)\n    }\n  }\n  void update()\n\n  return () => {\n    disposed = true\n    controller.abort()\n    clearTimeout(timer)\n    style.remove()\n  }\n}\n","import type { Context } from '@deepseek-ai/cordis'\nimport { mountStyles } from './styles'\n\nexport function apply(ctx: Context): void {\n  ctx.effect(mountStyles)\n}\n"],"mappings":";mEAAA,MAAa,EAAY,cCEzB,SAAgB,GAA0B,CACxC,IAAM,EAAW,SAAS,KAAK,cAAgC,0DAAc,EACvE,EAAQ,GAAY,SAAS,cAAc,OAAO,EACxD,EAAM,QAAQ,OAAS,EACvB,EAAM,QAAQ,UAAY,YACrB,GACH,SAAS,KAAK,OAAO,CAAK,EAE5B,IAAM,EAAa,IAAI,gBACnB,EAAO,GACP,EAAW,GACX,EACA,EAAY,GAEV,EAAS,SAA2B,CACxC,IAAM,EAAU,IAAI,gBACd,EAAU,eAAiB,EAAQ,MAAM,EAAG,IAAK,EACjD,MAAoB,EAAQ,MAAM,EACxC,EAAW,OAAO,iBAAiB,QAAS,EAAO,CAAE,KAAM,EAAK,CAAC,EACjE,GAAI,CACF,IAAM,EAAW,MAAM,MAAM,IAAI,IAAI,sBAAiB,SAAS,OAAO,EAAG,CACvE,YAAa,cACb,MAAO,WACP,QAAS,EAAO,CAAE,gBAAiB,CAAK,EAAI,CAAC,EAC7C,OAAQ,EAAQ,MAClB,CAAC,EACD,GAAI,EAAS,SAAW,IAAK,CAC3B,GAAI,CAAC,EAAS,GACZ,MAAU,MAAM,8BAA8B,EAAS,OAAO,EAAE,EAClE,IAAM,EAAM,MAAM,EAAS,KAAK,EAC3B,IACC,EAAM,cAAgB,IACxB,EAAM,YAAc,GACtB,EAAO,EAAS,QAAQ,IAAI,MAAM,GAAK,GAE3C,CACA,EAAY,EACd,OACO,EAAO,CACZ,GAAI,CAAC,EAAU,CACb,IAAM,EAAU,aAAiB,MAAQ,EAAM,QAAU,OAAO,CAAK,EACjE,IAAc,IAChB,EAAY,EACZ,QAAQ,KAAK,GAAG,EAAU,IAAI,EAAQ,8BAA8B,EAExE,CACF,QACQ,CACN,aAAa,CAAO,EACpB,EAAW,OAAO,oBAAoB,QAAS,CAAK,EAC/C,IACH,EAAQ,eAAiB,KAAK,EAAO,EAAG,GAAgB,EAC5D,CACF,EAGA,OAFA,EAAY,MAEC,CACX,EAAW,GACX,EAAW,MAAM,EACjB,aAAa,CAAK,EAClB,EAAM,OAAO,CACf,CACF,CC7DA,SAAgB,EAAM,EAAoB,CACxC,EAAI,OAAO,CAAW,CACxB"}

package/dist/index.js

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 import { createHash } from "node:crypto";
-import { readFile, readdir, realpath } from "node:fs/promises";
+import { readFile, readdir, realpath, stat } from "node:fs/promises";
 import { dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { pathToFileURL } from "node:url";
 import { Scanner } from "@tailwindcss/oxide";
@@ -138,34 +138,20 @@ async function bundles(directory) {
 	}
 	return files;
 }
-async function cssEntry(root, clientDirectory) {
-	for (const directory of /* @__PURE__ */ new Set([root, clientDirectory])) {
-		const entry = (await readdir(directory, { withFileTypes: true })).find((item) => item.name === "main.css");
-		if (entry) {
-			if (!entry.isFile()) throw new Error(`${directory}: main.css must be a regular file`);
-			return join(directory, entry.name);
-		}
+async function cssEntry(root, owner) {
+	const entry = JSON.parse(await readFile(join(root, "package.json"), "utf8")).dsh?.taiwind;
+	if (entry === void 0) {
+		if (await stat(join(root, "main.css")).then((info) => info.isFile(), () => false)) throw new Error(`${owner}: main.css is not discovered automatically anymore; declare "dsh": { "taiwind": "main.css" } in package.json`);
+		return;
 	}
-	const found = [];
-	const visit = async (directory) => {
-		for (const item of await readdir(directory, { withFileTypes: true })) {
-			if ([
-				"node_modules",
-				"archive",
-				".git"
-			].includes(item.name) || item.isSymbolicLink()) continue;
-			const path = join(directory, item.name);
-			if (item.isDirectory()) await visit(path);
-			else if (item.isFile() && item.name === "main.css") found.push(path);
-		}
-	};
-	await visit(root);
-	if (found.length > 1) throw new Error(`${root}: multiple main.css entries found: ${found.sort().join(", ")}`);
-	return found[0];
+	if (typeof entry !== "string" || !entry.trim() || extname(entry) !== ".css") throw new Error(`${owner}: dsh.taiwind must be a relative .css path`);
+	const path = resolve(root, entry);
+	if (!await stat(path).then((info) => info.isFile(), () => false)) throw new Error(`${owner}: dsh.taiwind entry not found: ${entry}`);
+	return path;
 }
 async function compilePlugins(entries) {
 	const hash = createHash("sha256");
-	const sources = [];
+	const bundleFiles = [];
 	const extend = Object.create(null);
 	const merged = { theme: { extend } };
 	const owners = /* @__PURE__ */ new Map();
@@ -281,14 +267,16 @@ async function compilePlugins(entries) {
 		for (const file of await bundles(dirname(path))) {
 			if (seen.has(file)) continue;
 			seen.add(file);
-			const content = await readFile(file, "utf8");
-			hash.update(JSON.stringify([file, content]));
-			sources.push({
-				content,
-				extension: extname(file).slice(1)
-			});
+			const info = await stat(file);
+			hash.update(JSON.stringify([
+				file,
+				info.mtimeMs,
+				info.ctimeMs,
+				info.size
+			]));
+			bundleFiles.push(file);
 		}
-		const stylesheet = await cssEntry(root, dirname(path));
+		const stylesheet = await cssEntry(root, entry.id);
 		if (stylesheet) {
 			cssImports.push(await loadCss(stylesheet, root, entry.id));
 			continue;
@@ -305,7 +293,12 @@ async function compilePlugins(entries) {
 	const utilities = await readFile(new URL(import.meta.resolve("tailwindcss/utilities.css")), "utf8");
 	hash.update(JSON.stringify([theme, utilities]));
 	const digest = hash.digest("hex");
-	if (cached?.hash === digest) return cached.css;
+	if (cached?.signature === digest) return cached.css;
+	const sources = [];
+	for (const file of bundleFiles) sources.push({
+		content: await readFile(file, "utf8"),
+		extension: extname(file).slice(1)
+	});
 	const candidates = new Scanner({}).scanFiles(sources);
 	const compiler = await compile(`@layer theme, base, components, utilities;\n@layer theme {\n${theme}\n}\n${cssImports.map((path) => `@import ${JSON.stringify(path.replaceAll("\\", "/"))};`).join("\n")}\n@layer utilities {\n${utilities}\n}\n@config "dsh-taiwind:merged";`, {
 		loadModule: async (id) => {
@@ -330,7 +323,7 @@ async function compilePlugins(entries) {
 	if (compiler.sources.length || compiler.root !== null && compiler.root !== "none") throw new Error("Tailwind source(...) directory scanning is not supported; file candidates come from client bundles");
 	const css = compiler.build(candidates);
 	cached = {
-		hash: digest,
+		signature: digest,
 		css
 	};
 	return css;
@@ -338,7 +331,7 @@ async function compilePlugins(entries) {
 //#endregion
 //#region src/constants.ts
 const PLUGIN_ID = "dsh-taiwind";
-const STYLESHEET_PATH = "plugins/dsh-taiwind.css";
+const STYLESHEET_PATH = "plugins/taiwind.css";
 const POLL_INTERVAL_MS = 2e3;
 //#endregion
 //#region src/index.ts
@@ -351,7 +344,7 @@ const inject = [
 async function apply(ctx) {
 	let css = "";
 	let etag = "";
-	let failed = false;
+	let failed = true;
 	let disposed = false;
 	let generation = 0;
 	let pending;
@@ -385,23 +378,24 @@ async function apply(ctx) {
 	ctx.effect(() => () => {
 		disposed = true;
 	});
+	const fail = (error) => {
+		if (disposed) return;
+		failed = true;
+		const message = error instanceof Error ? error.message : String(error);
+		if (message !== lastError) {
+			lastError = message;
+			ctx.logger.warn(`${PLUGIN_ID}: ${message}; keeping previous stylesheet`);
+		}
+	};
 	const update = () => {
-		refresh().catch((error) => {
-			if (disposed) return;
-			failed = true;
-			const message = error instanceof Error ? error.message : String(error);
-			if (message !== lastError) {
-				lastError = message;
-				ctx.logger.warn(`${PLUGIN_ID}: ${message}; keeping previous stylesheet`);
-			}
-		});
+		refresh().catch(fail);
 	};
-	ctx.effect(() => ctx.clientModules.onGraphChanged(() => {
+	const invalidate = () => {
 		generation++;
 		update();
-	}));
-	await refresh();
-	if (disposed) return;
+	};
+	ctx.effect(() => ctx.clientModules.onGraphChanged(invalidate));
+	ctx.effect(() => ctx.clientModules.onRebuilt(invalidate));
 	ctx.effect(() => ctx.webServer.register({
 		kind: "exact",
 		path: `/${STYLESHEET_PATH}`,
@@ -447,6 +441,11 @@ async function apply(ctx) {
 		timer.unref();
 		return () => clearInterval(timer);
 	});
+	try {
+		await refresh();
+	} catch (error) {
+		fail(error);
+	}
 }
 //#endregion
 export { apply, inject, name };

package/icon.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" rx="14" fill="#102a43"/><g fill="none" stroke="#67e8f9" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"><path d="M14 18h12l9 14h15M14 46h12l9-14M14 32h36"/><path d="m44 26 6 6-6 6"/></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" rx="14" fill="#102a43"/><g fill="none" stroke="#67e8f9" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"><path d="M14 18h12l9 14h15M14 46h12l9-14M14 32h36"/><path d="m44 26 6 6-6 6"/></g></svg>

package/locale/en.json

@@ -1,6 +1,6 @@
-{
-  "meta": {
-    "title": "Shared Tailwind CSS",
-    "description": "Combines client bundle utility classes into one stylesheet, with per-plugin static Tailwind configuration."
-  }
-}
+{
+  "meta": {
+    "title": "Shared Tailwind CSS",
+    "description": "Combines client bundle utility classes into one stylesheet, with per-plugin static Tailwind configuration."
+  }
+}

package/locale/zh.json

@@ -1,6 +1,6 @@
-{
-  "meta": {
-    "title": "共享 Tailwind 样式",
-    "description": "聚合客户端插件的工具类，生成一份去重样式，支持各插件独立的静态 Tailwind 配置。"
-  }
-}
+{
+  "meta": {
+    "title": "共享 Tailwind 样式",
+    "description": "聚合客户端插件的工具类，生成一份去重样式，支持各插件独立的静态 Tailwind 配置。"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-taiwind",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "One shared Tailwind stylesheet for DSH plugins with per-plugin configuration",
   "author": "Hairy <wwu710632@gmail.com>",
   "license": "MIT",