@nkzw/fate-devtools 0.0.0-stage → 2.0.1

package/lib/vite.mjs

@@ -0,0 +1,98 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { extname, join, normalize, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+// src/vite.ts
+/**
+* Vite plugin for the fate devtools.
+*
+* Adds a "fate" panel to Vite DevTools and serves the same panel as a
+* standalone page at `/__fate-devtools/`.
+*
+* @example
+* import { fateDevtools } from '@nkzw/fate-devtools/vite';
+*
+* export default defineConfig({
+*   devtools: true,
+*   plugins: [fateDevtools()],
+* });
+*
+* @module @nkzw/fate-devtools/vite
+*/
+const contentTypes = {
+	".css": "text/css; charset=utf-8",
+	".html": "text/html; charset=utf-8",
+	".js": "text/javascript; charset=utf-8",
+	".json": "application/json; charset=utf-8",
+	".svg": "image/svg+xml"
+};
+const icon = `data:image/svg+xml,${encodeURIComponent("<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 64 64\"><rect width=\"64\" height=\"64\" rx=\"18\" fill=\"#3d87f5\"/><text x=\"18\" y=\"47\" fill=\"white\" font-family=\"Georgia,serif\" font-style=\"italic\" font-size=\"52\">f</text></svg>")}`;
+const findPanelDirectory = () => {
+	const candidates = [new URL("./panel/", import.meta.url), new URL("../lib/panel/", import.meta.url)];
+	for (const candidate of candidates) {
+		const directory = fileURLToPath(candidate);
+		if (existsSync(join(directory, "index.html"))) return directory;
+	}
+	return null;
+};
+/**
+* Registers the fate panel with Vite DevTools and serves it during development.
+*/
+function fateDevtools({ base = "/__fate-devtools/" } = {}) {
+	const mountPath = base.endsWith("/") ? base : `${base}/`;
+	return {
+		apply: "serve",
+		configureServer(server) {
+			const directory = findPanelDirectory();
+			server.middlewares.use(async (request, response, next) => {
+				const url = request.url?.split("?")[0];
+				if (!url || url !== mountPath.slice(0, -1) && !url.startsWith(mountPath)) return next();
+				if (!directory) {
+					response.statusCode = 500;
+					response.end("fate-devtools: The panel has not been built. Run `vp run build` in @nkzw/fate-devtools.");
+					return;
+				}
+				if (url === mountPath.slice(0, -1)) {
+					response.statusCode = 302;
+					response.setHeader("Location", mountPath);
+					response.end();
+					return;
+				}
+				let path;
+				try {
+					path = decodeURIComponent(url.slice(mountPath.length));
+				} catch {
+					response.statusCode = 400;
+					response.end();
+					return;
+				}
+				const file = normalize(join(directory, path || "index.html"));
+				if (!file.startsWith(directory.endsWith(sep) ? directory : directory + sep)) {
+					response.statusCode = 403;
+					response.end();
+					return;
+				}
+				try {
+					const body = await readFile(existsSync(file) ? file : join(directory, "index.html"));
+					response.setHeader("Content-Type", contentTypes[extname(file)] ?? "application/octet-stream");
+					response.setHeader("Cache-Control", "no-cache");
+					response.end(body);
+				} catch {
+					next();
+				}
+			});
+		},
+		devtools: { setup(context) {
+			context.docks.register({
+				category: "app",
+				icon,
+				id: "fate",
+				title: "fate",
+				type: "iframe",
+				url: mountPath
+			});
+		} },
+		name: "fate:devtools"
+	};
+}
+export { fateDevtools };

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@nkzw/fate-devtools",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2.0.1",
+  "description": "Devtools for fate, with a Vite DevTools panel.",
+  "homepage": "https://github.com/nkzw-tech/fate",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nkzw-tech/fate"
+  },
+  "files": [
+    "lib"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.mts",
+      "@nkzw/source": "./src/index.ts",
+      "default": "./lib/index.mjs"
+    },
+    "./react": {
+      "types": "./lib/react.d.mts",
+      "@nkzw/source": "./src/react.tsx",
+      "default": "./lib/react.mjs"
+    },
+    "./vite": {
+      "types": "./lib/vite.d.mts",
+      "@nkzw/source": "./src/vite.ts",
+      "default": "./lib/vite.mjs"
+    }
+  },
+  "devDependencies": {
+    "@nkzw/fate": "2.0.1",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
+    "react-fate": "2.0.1",
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.6.0",
+    "vite-plus": "1.6.0"
+  },
+  "peerDependencies": {
+    "@nkzw/fate": "^2.0.0",
+    "react": "^19.2.0",
+    "react-fate": "^2.0.0",
+    "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-fate": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    }
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-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.