@asheeui/vite 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ashee Softworks
+
+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/dist/index.cjs

@@ -0,0 +1,88 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let node_path = require("node:path");
+let _asheeui_utils_node = require("@asheeui/utils/node");
+//#region src/index.ts
+/**
+* Public specifier that application code imports to access the
+* resolved AsheeUI config.
+*
+* @example
+* ```ts
+* import config from "virtual:ashee-config";
+* ```
+*/
+const VIRTUAL_ID = "virtual:ashee-config";
+/** Vite-internal, `\0`-prefixed id used after `resolveId`. */
+const RESOLVED_VIRTUAL_ID = `\0${VIRTUAL_ID}`;
+/**
+* Create the Vite plugin that exposes the AsheeUI config as the
+* `virtual:ashee-config` module.
+*
+* Responsibilities:
+* - Resolves the virtual id to an internal, `\0`-prefixed id.
+* - Loads the module by discovering `asheeui.config.*` at the project
+*   root and re-exporting its `default`/`config` export (or
+*   `undefined` when no config exists).
+* - Watches for config file creation, deletion, and edits during dev,
+*   invalidating the module and forcing a full reload.
+*
+* @param options - Plugin options.
+* @param options.root - Override directory for config discovery.
+* @returns A Vite plugin object.
+*
+* @example
+* ```ts
+* // vite.config.ts
+* import { defineConfig } from "vite";
+* import { asheeui } from "@asheeui/vite";
+*
+* export default defineConfig({
+*   plugins: [asheeui()],
+* });
+* ```
+*/
+function asheeui(options = {}) {
+	let root;
+	const isConfigFile = (file) => _asheeui_utils_node.CANDIDATES.some((f) => (0, node_path.resolve)(root, f) === file);
+	const invalidateAndReload = (server) => {
+		const mod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_ID);
+		if (mod) server.moduleGraph.invalidateModule(mod);
+		server.ws.send({ type: "full-reload" });
+	};
+	return {
+		name: "ashee:config",
+		enforce: "pre",
+		configResolved(resolved) {
+			root = options.root ?? resolved.root;
+		},
+		configureServer(server) {
+			server.watcher.on("add", (file) => {
+				if (isConfigFile(file)) invalidateAndReload(server);
+			});
+			server.watcher.on("unlink", (file) => {
+				if (isConfigFile(file)) invalidateAndReload(server);
+			});
+		},
+		resolveId(id) {
+			if (id === VIRTUAL_ID) return RESOLVED_VIRTUAL_ID;
+		},
+		load(id) {
+			if (id !== RESOLVED_VIRTUAL_ID) return;
+			const match = (0, _asheeui_utils_node.discoverConfig)(root);
+			if (!match) return "const config = undefined;\nexport default config;";
+			return [
+				`import * as mod from ${JSON.stringify(match)};`,
+				`const exports = { ...mod };`,
+				`const config = exports.default ?? exports.config ?? exports;`,
+				`export default config;`
+			].join("\n");
+		},
+		handleHotUpdate({ file, server }) {
+			if (!isConfigFile(file)) return;
+			invalidateAndReload(server);
+			return [];
+		}
+	};
+}
+//#endregion
+exports.asheeui = asheeui;

package/dist/index.d.cts

@@ -0,0 +1,42 @@
+import { Plugin } from "vite";
+//#region src/index.d.ts
+/** Options accepted by the {@link asheeui} plugin factory. */
+interface AsheeConfigPluginOptions {
+  /**
+   * Override the directory to look for `asheeui.config.*` in.
+   *
+   * Defaults to Vite's configured root.
+   */
+  root?: string;
+}
+/**
+ * Create the Vite plugin that exposes the AsheeUI config as the
+ * `virtual:ashee-config` module.
+ *
+ * Responsibilities:
+ * - Resolves the virtual id to an internal, `\0`-prefixed id.
+ * - Loads the module by discovering `asheeui.config.*` at the project
+ *   root and re-exporting its `default`/`config` export (or
+ *   `undefined` when no config exists).
+ * - Watches for config file creation, deletion, and edits during dev,
+ *   invalidating the module and forcing a full reload.
+ *
+ * @param options - Plugin options.
+ * @param options.root - Override directory for config discovery.
+ * @returns A Vite plugin object.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from "vite";
+ * import { asheeui } from "@asheeui/vite";
+ *
+ * export default defineConfig({
+ *   plugins: [asheeui()],
+ * });
+ * ```
+ */
+declare function asheeui(options?: AsheeConfigPluginOptions): Plugin;
+//#endregion
+export { AsheeConfigPluginOptions, asheeui };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;UAmBiB;;;;;;EAMf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8Bc,QAAQ,UAAS,2BAAgC"}

package/dist/index.d.mts

@@ -0,0 +1,42 @@
+import { Plugin } from "vite";
+//#region src/index.d.ts
+/** Options accepted by the {@link asheeui} plugin factory. */
+interface AsheeConfigPluginOptions {
+  /**
+   * Override the directory to look for `asheeui.config.*` in.
+   *
+   * Defaults to Vite's configured root.
+   */
+  root?: string;
+}
+/**
+ * Create the Vite plugin that exposes the AsheeUI config as the
+ * `virtual:ashee-config` module.
+ *
+ * Responsibilities:
+ * - Resolves the virtual id to an internal, `\0`-prefixed id.
+ * - Loads the module by discovering `asheeui.config.*` at the project
+ *   root and re-exporting its `default`/`config` export (or
+ *   `undefined` when no config exists).
+ * - Watches for config file creation, deletion, and edits during dev,
+ *   invalidating the module and forcing a full reload.
+ *
+ * @param options - Plugin options.
+ * @param options.root - Override directory for config discovery.
+ * @returns A Vite plugin object.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from "vite";
+ * import { asheeui } from "@asheeui/vite";
+ *
+ * export default defineConfig({
+ *   plugins: [asheeui()],
+ * });
+ * ```
+ */
+declare function asheeui(options?: AsheeConfigPluginOptions): Plugin;
+//#endregion
+export { AsheeConfigPluginOptions, asheeui };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;UAmBiB;;;;;;EAMf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8Bc,QAAQ,UAAS,2BAAgC"}

package/dist/index.mjs

@@ -0,0 +1,89 @@
+import { resolve } from "node:path";
+import { CANDIDATES, discoverConfig } from "@asheeui/utils/node";
+//#region src/index.ts
+/**
+* Public specifier that application code imports to access the
+* resolved AsheeUI config.
+*
+* @example
+* ```ts
+* import config from "virtual:ashee-config";
+* ```
+*/
+const VIRTUAL_ID = "virtual:ashee-config";
+/** Vite-internal, `\0`-prefixed id used after `resolveId`. */
+const RESOLVED_VIRTUAL_ID = `\0${VIRTUAL_ID}`;
+/**
+* Create the Vite plugin that exposes the AsheeUI config as the
+* `virtual:ashee-config` module.
+*
+* Responsibilities:
+* - Resolves the virtual id to an internal, `\0`-prefixed id.
+* - Loads the module by discovering `asheeui.config.*` at the project
+*   root and re-exporting its `default`/`config` export (or
+*   `undefined` when no config exists).
+* - Watches for config file creation, deletion, and edits during dev,
+*   invalidating the module and forcing a full reload.
+*
+* @param options - Plugin options.
+* @param options.root - Override directory for config discovery.
+* @returns A Vite plugin object.
+*
+* @example
+* ```ts
+* // vite.config.ts
+* import { defineConfig } from "vite";
+* import { asheeui } from "@asheeui/vite";
+*
+* export default defineConfig({
+*   plugins: [asheeui()],
+* });
+* ```
+*/
+function asheeui(options = {}) {
+	let root;
+	const isConfigFile = (file) => CANDIDATES.some((f) => resolve(root, f) === file);
+	const invalidateAndReload = (server) => {
+		const mod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_ID);
+		if (mod) server.moduleGraph.invalidateModule(mod);
+		server.ws.send({ type: "full-reload" });
+	};
+	return {
+		name: "ashee:config",
+		enforce: "pre",
+		configResolved(resolved) {
+			root = options.root ?? resolved.root;
+		},
+		configureServer(server) {
+			server.watcher.on("add", (file) => {
+				if (isConfigFile(file)) invalidateAndReload(server);
+			});
+			server.watcher.on("unlink", (file) => {
+				if (isConfigFile(file)) invalidateAndReload(server);
+			});
+		},
+		resolveId(id) {
+			if (id === VIRTUAL_ID) return RESOLVED_VIRTUAL_ID;
+		},
+		load(id) {
+			if (id !== RESOLVED_VIRTUAL_ID) return;
+			const match = discoverConfig(root);
+			if (!match) return "const config = undefined;\nexport default config;";
+			return [
+				`import * as mod from ${JSON.stringify(match)};`,
+				`const exports = { ...mod };`,
+				`const config = exports.default ?? exports.config ?? exports;`,
+				`export default config;`
+			].join("\n");
+		},
+		handleHotUpdate({ file, server }) {
+			if (!isConfigFile(file)) return;
+			invalidateAndReload(server);
+			return [];
+		}
+	};
+}
+//#endregion
+export { asheeui };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { CANDIDATES, discoverConfig } from \"@asheeui/utils/node\";\nimport type { Plugin, ViteDevServer } from \"vite\";\n\n/**\n * Public specifier that application code imports to access the\n * resolved AsheeUI config.\n *\n * @example\n * ```ts\n * import config from \"virtual:ashee-config\";\n * ```\n */\nconst VIRTUAL_ID = \"virtual:ashee-config\";\n\n/** Vite-internal, `\\0`-prefixed id used after `resolveId`. */\nconst RESOLVED_VIRTUAL_ID = `\\0${VIRTUAL_ID}`;\n\n/** Options accepted by the {@link asheeui} plugin factory. */\nexport interface AsheeConfigPluginOptions {\n  /**\n   * Override the directory to look for `asheeui.config.*` in.\n   *\n   * Defaults to Vite's configured root.\n   */\n  root?: string;\n}\n\n/**\n * Create the Vite plugin that exposes the AsheeUI config as the\n * `virtual:ashee-config` module.\n *\n * Responsibilities:\n * - Resolves the virtual id to an internal, `\\0`-prefixed id.\n * - Loads the module by discovering `asheeui.config.*` at the project\n *   root and re-exporting its `default`/`config` export (or\n *   `undefined` when no config exists).\n * - Watches for config file creation, deletion, and edits during dev,\n *   invalidating the module and forcing a full reload.\n *\n * @param options - Plugin options.\n * @param options.root - Override directory for config discovery.\n * @returns A Vite plugin object.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import { defineConfig } from \"vite\";\n * import { asheeui } from \"@asheeui/vite\";\n *\n * export default defineConfig({\n *   plugins: [asheeui()],\n * });\n * ```\n */\nexport function asheeui(options: AsheeConfigPluginOptions = {}): Plugin {\n  let root: string;\n\n  const isConfigFile = (file: string) =>\n    CANDIDATES.some((f) => resolve(root, f) === file);\n\n  const invalidateAndReload = (server: ViteDevServer) => {\n    const mod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_ID);\n    if (mod) server.moduleGraph.invalidateModule(mod);\n    server.ws.send({ type: \"full-reload\" });\n  };\n\n  return {\n    name: \"ashee:config\",\n    enforce: \"pre\",\n    configResolved(resolved) {\n      root = options.root ?? resolved.root;\n    },\n    configureServer(server) {\n      // Creating or deleting the config file is not a \"change\" to an\n      // existing module, so `handleHotUpdate` below will not see it.\n      // Watch raw filesystem events for both cases.\n      server.watcher.on(\"add\", (file) => {\n        if (isConfigFile(file)) invalidateAndReload(server);\n      });\n      server.watcher.on(\"unlink\", (file) => {\n        if (isConfigFile(file)) invalidateAndReload(server);\n      });\n    },\n    resolveId(id) {\n      if (id === VIRTUAL_ID) return RESOLVED_VIRTUAL_ID;\n    },\n    load(id) {\n      if (id !== RESOLVED_VIRTUAL_ID) return;\n\n      const match = discoverConfig(root);\n      if (!match) {\n        return \"const config = undefined;\\nexport default config;\";\n      }\n\n      return [\n        `import * as mod from ${JSON.stringify(match)};`,\n        `const exports = { ...mod };`,\n        `const config = exports.default ?? exports.config ?? exports;`,\n        `export default config;`,\n      ].join(\"\\n\");\n    },\n    handleHotUpdate({ file, server }) {\n      if (!isConfigFile(file)) return;\n      invalidateAndReload(server);\n      return []; // stop this file's own update from propagating separately\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAaA,MAAM,aAAa;;AAGnB,MAAM,sBAAsB,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCjC,SAAgB,QAAQ,UAAoC,CAAC,GAAW;CACtE,IAAI;CAEJ,MAAM,gBAAgB,SACpB,WAAW,MAAM,MAAM,QAAQ,MAAM,CAAC,MAAM,IAAI;CAElD,MAAM,uBAAuB,WAA0B;EACrD,MAAM,MAAM,OAAO,YAAY,cAAc,mBAAmB;EAChE,IAAI,KAAK,OAAO,YAAY,iBAAiB,GAAG;EAChD,OAAO,GAAG,KAAK,EAAE,MAAM,cAAc,CAAC;CACxC;CAEA,OAAO;EACL,MAAM;EACN,SAAS;EACT,eAAe,UAAU;GACvB,OAAO,QAAQ,QAAQ,SAAS;EAClC;EACA,gBAAgB,QAAQ;GAItB,OAAO,QAAQ,GAAG,QAAQ,SAAS;IACjC,IAAI,aAAa,IAAI,GAAG,oBAAoB,MAAM;GACpD,CAAC;GACD,OAAO,QAAQ,GAAG,WAAW,SAAS;IACpC,IAAI,aAAa,IAAI,GAAG,oBAAoB,MAAM;GACpD,CAAC;EACH;EACA,UAAU,IAAI;GACZ,IAAI,OAAO,YAAY,OAAO;EAChC;EACA,KAAK,IAAI;GACP,IAAI,OAAO,qBAAqB;GAEhC,MAAM,QAAQ,eAAe,IAAI;GACjC,IAAI,CAAC,OACH,OAAO;GAGT,OAAO;IACL,wBAAwB,KAAK,UAAU,KAAK,EAAE;IAC9C;IACA;IACA;GACF,CAAC,CAAC,KAAK,IAAI;EACb;EACA,gBAAgB,EAAE,MAAM,UAAU;GAChC,IAAI,CAAC,aAAa,IAAI,GAAG;GACzB,oBAAoB,MAAM;GAC1B,OAAO,CAAC;EACV;CACF;AACF"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@asheeui/vite",
+  "version": "0.3.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "asheeui": "0.5.0"
+  },
+  "peerDependencies": {
+    "vite": "^8.2.1",
+    "@asheeui/utils": "0.3.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.22.14",
+    "vite": "^8.2.1"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsdown src/index.ts --format esm,cjs --dts --clean",
+    "dev": "tsdown src/index.ts --format esm,cjs --dts --watch"
+  },
+  "module": "./dist/index.mjs"
+}