@zthun/janitor-vite 21.1.0

package/LICENSE.md

@@ -0,0 +1,20 @@
+# MIT License
+
+Copyright (c) 2024 Anthony Bonta
+
+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

@@ -0,0 +1,90 @@
+# Janitor Vite
+
+This is a set of common plugins for vite that simplifies build setup.
+
+## Getting Started
+
+```sh
+# NPM
+npm install @zthun/janitor-vite --save-dev
+# Yarn
+yarn add @zthun/janitor-vite --dev
+```
+
+## Projects
+
+The first step is to pick your project type. What are you building?
+
+| Type     | Description                                             |
+| -------- | ------------------------------------------------------- |
+| Node     | Basic node command line app.                            |
+| CLI      | Same as node. Here for semantics.                       |
+| NestJS   | Same as node. Here for semantics.                       |
+| DOM      | A browser based application.                            |
+| React    | A DOM application that uses react as the framework.     |
+| Monorepo | You're building multiple things in the packages folder. |
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { projectMonorepo } from "@zthun/janitor-vite";
+
+export default defineConfig({
+  plugins: [projectMonorepo()],
+});
+```
+
+## Extensions
+
+After you have the type of project you're building, you can use available
+extensions to modify the project with extra features.
+
+| Type        | Description                                                                                                 |
+| ----------- | ----------------------------------------------------------------------------------------------------------- |
+| Library     | Turns your project into an npm library. Usually only used with the base project or a dom project.           |
+| Externalize | Externalizes your dependencies so they are not bundled. If you build a library, you get this automatically. |
+| DevServer   | Adds a dev server. Usually paired with a dom project.                                                       |
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { project, extensionLibrary } from "@zthun/janitor-vite";
+
+// Basic library for browsers and node.
+export default defineConfig({
+  plugins: [project(), extensionLibrary()],
+});
+```
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { projectReact, extensionLibrary } from "@zthun/janitor-vite";
+
+// Builds a react library.
+export default defineConfig({
+  plugins: [projectReact(), extensionLibrary()],
+});
+```
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { projectCli, extensionExternalize } from "@zthun/janitor-vite";
+
+// Builds a cli that does not bundle dependencies.
+export default defineConfig({
+  plugins: [projectCli(), extensionExternalize()],
+});
+```
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { projectReact, extensionDevServer } from "@zthun/janitor-vite";
+
+// Basic react application
+export default defineConfig({
+  plugins: [projectReact(), extensionDevServer()],
+});
+```

package/dist/extensions/extension-dev-server.d.mts

@@ -0,0 +1,37 @@
+import { Plugin } from 'vite';
+/**
+ * Options for the dev server.
+ *
+ * The expectation for almost every repository in this instance
+ * is that it is running the backend and frontend in a docker
+ * compose environment, so it assumes it will be running in a docker
+ * network.
+ *
+ * If this isn't true, then these options will be useful.
+ */
+export interface ExtensionDevServerOptions {
+    /**
+     * The port to run on.
+     *
+     * @default 5173
+     */
+    port?: number;
+    /**
+     * The binding host.
+     *
+     * @default "0.0.0.0"
+     */
+    host?: string;
+}
+/**
+ * Adds a dev server to your vite build.
+ *
+ * This is usually paired with a dom based project and
+ * is only used for debugging.  AllowedHosts in this plugin
+ * is set to true to allow for local manipulation of the
+ * OS host file to simulate true domains.
+ *
+ * @returns
+ *        A list of plugins that add the dev server option.
+ */
+export declare function extensionDevServer(options?: ExtensionDevServerOptions): Plugin[];

package/dist/extensions/extension-externalize.d.mts

@@ -0,0 +1,29 @@
+import { PathLike } from 'node:fs';
+import { Plugin } from 'vite';
+/**
+ * Options for externalizing dependencies.
+ */
+export interface ExternalizeOptions {
+    /**
+     * The path to the package json file that contains dependencies
+     * to externalize or false to only externalize node builtins.
+     *
+     * If this is undefined, then the package.json in the current
+     * working directory will be used.
+     */
+    packageJson?: PathLike | false;
+}
+/**
+ * An externalize extension tells a project to not bundle the dependencies together.
+ *
+ * This is mostly used for libraries and if you use extensionLibrary(), or projectNode()
+ * you do not need to include this extension as it will be included for you already.
+ *
+ * @param options -
+ *        Optional options for how to externalize dependency values.
+ *
+ * @returns
+ *        A list of plugins that will stop vite from bundling packages
+ *        from the node_modules directory and node builtins.
+ */
+export declare const extensionExternalize: (options?: ExternalizeOptions) => Plugin[];

package/dist/extensions/extension-library.d.mts

@@ -0,0 +1,26 @@
+import { Plugin } from 'vite';
+/**
+ * Turns any project into a shared library.
+ *
+ * A library does not actually run any code, it simply contains shared
+ * code that makes up other projects.
+ *
+ * A library is expected to have an index.mts file under the src directory
+ * that is a long list of exports that the library will provide to consumers.
+ * Only one barrel export should be used for a library. It's better to have
+ * multiple libraries than to complicate a library with subpaths in the
+ * exports of package.json.  This keeps the expectations that when you npm
+ * library "foo", you can do import { something } from 'foo' and not need to
+ * have the brain overload of hunting down available paths from within.
+ *
+ * When you classify something as a library, source maps are turned on,
+ * and none of your code for it will be minified.  This is to help with
+ * debugging library code outside of the library development environment.
+ * Module libraries in the janitor system are not expected to be deployed
+ * to a system by themselves.  They are bundled with the overarching parent
+ * application.
+ *
+ * @returns
+ *        The list of plugins that turn any project into a library.
+ */
+export declare function extensionLibrary(): Plugin[];

package/dist/helpful/get-all-node-builtins.d.mts

@@ -0,0 +1 @@
+export declare function getAllNodeBuiltins(): RegExp[];

package/dist/helpful/get-all-package-dependencies.d.mts

@@ -0,0 +1,2 @@
+import { PathLike } from 'node:fs';
+export declare function getAllPackageDependencies(pkg: PathLike): RegExp[];

package/dist/helpful/resolve-cwd.d.mts

@@ -0,0 +1,2 @@
+import { UserConfig } from 'vite';
+export declare function resolveCwd(current?: UserConfig): string;

package/dist/index.cjs

@@ -0,0 +1,343 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let node_path = require("node:path");
+let node_module = require("node:module");
+let node_fs = require("node:fs");
+let lodash_es = require("lodash-es");
+let unplugin_dts_vite = require("unplugin-dts/vite");
+unplugin_dts_vite = __toESM(unplugin_dts_vite, 1);
+let unplugin_swc = require("unplugin-swc");
+unplugin_swc = __toESM(unplugin_swc, 1);
+require("vitest/config");
+let _vitejs_plugin_react_swc = require("@vitejs/plugin-react-swc");
+_vitejs_plugin_react_swc = __toESM(_vitejs_plugin_react_swc, 1);
+//#region src/extensions/extension-dev-server.mts
+/**
+* Adds a dev server to your vite build.
+*
+* This is usually paired with a dom based project and
+* is only used for debugging.  AllowedHosts in this plugin
+* is set to true to allow for local manipulation of the
+* OS host file to simulate true domains.
+*
+* @returns
+*        A list of plugins that add the dev server option.
+*/ function extensionDevServer(options = {}) {
+	const { port = 5173, host = "0.0.0.0" } = options;
+	return [{
+		name: "janitor:extension-dev-server",
+		config: () => {
+			return { server: {
+				allowedHosts: true,
+				strictPort: true,
+				host,
+				port
+			} };
+		}
+	}];
+}
+//#endregion
+//#region src/helpful/get-all-node-builtins.mts
+function getAllNodeBuiltins() {
+	return node_module.builtinModules.map((m) => new RegExp(`^(?:node:)?${m}$`));
+}
+//#endregion
+//#region src/helpful/get-all-package-dependencies.mts
+function getAllPackageDependencies(pkg) {
+	try {
+		const externals = /* @__PURE__ */ new Set();
+		const contents = (0, node_fs.readFileSync)(pkg).toString();
+		const { dependencies = [], devDependencies = [], optionalDependencies = [], peerDependencies = [] } = JSON.parse(contents);
+		const push = externals.add.bind(externals);
+		Object.keys(dependencies).concat(Object.keys(devDependencies)).concat(Object.keys(optionalDependencies)).concat(Object.keys(peerDependencies)).map((dep) => new RegExp(`^${dep}(?:/.+)?$`)).forEach(push);
+		return Array.from(externals);
+	} catch {
+		return [];
+	}
+}
+//#endregion
+//#region src/helpful/resolve-cwd.mts
+function resolveCwd(current) {
+	return current?.root || process.cwd();
+}
+//#endregion
+//#region src/extensions/extension-externalize.mts
+/**
+* An externalize extension tells a project to not bundle the dependencies together.  
+*
+* This is mostly used for libraries and if you use extensionLibrary(), or projectNode()
+* you do not need to include this extension as it will be included for you already.
+*
+* @param options -
+*        Optional options for how to externalize dependency values.
+*
+* @returns
+*        A list of plugins that will stop vite from bundling packages
+*        from the node_modules directory and node builtins.
+*/ var extensionExternalize = (options = {}) => {
+	return [{
+		name: "janitor:extension-externalize",
+		config: (current) => {
+			const cwd = resolveCwd(current);
+			const fallback = (0, node_path.resolve)(cwd, "package.json");
+			const { packageJson = fallback } = options;
+			const externalDeps = new Set(getAllNodeBuiltins());
+			if (packageJson !== false) getAllPackageDependencies(packageJson).forEach((p) => externalDeps.add(p));
+			const depMatchers = Array.from(externalDeps);
+			return { build: { rolldownOptions: { external: (source) => {
+				return depMatchers.some((depMatcher) => depMatcher.test(source));
+			} } } };
+		}
+	}];
+};
+//#endregion
+//#region src/extensions/extension-library.mts
+/**
+* Turns any project into a shared library.
+*
+* A library does not actually run any code, it simply contains shared
+* code that makes up other projects.
+*
+* A library is expected to have an index.mts file under the src directory
+* that is a long list of exports that the library will provide to consumers.
+* Only one barrel export should be used for a library. It's better to have
+* multiple libraries than to complicate a library with subpaths in the
+* exports of package.json.  This keeps the expectations that when you npm
+* library "foo", you can do import { something } from 'foo' and not need to
+* have the brain overload of hunting down available paths from within.
+*
+* When you classify something as a library, source maps are turned on,
+* and none of your code for it will be minified.  This is to help with
+* debugging library code outside of the library development environment.
+* Module libraries in the janitor system are not expected to be deployed
+* to a system by themselves.  They are bundled with the overarching parent
+* application.
+*
+* @returns
+*        The list of plugins that turn any project into a library.
+*/ function extensionLibrary() {
+	return [
+		...extensionExternalize(),
+		...(0, lodash_es.castArray)((0, unplugin_dts_vite.default)({
+			compilerOptions: { paths: {} },
+			include: ["src/**/*.{js,mjs,cjs,ts,mts,jsx,tsx}"],
+			exclude: ["**/*.{spec,test}.{js,mjs,cjs,ts,mts,jsx,tsx}"]
+		})),
+		{
+			name: "janitor:extension-library",
+			config: (current) => {
+				const cwd = resolveCwd(current);
+				return { build: {
+					minify: false,
+					sourcemap: true,
+					lib: {
+						entry: { index: (0, node_path.resolve)(cwd, "./src/index.mts") },
+						formats: ["cjs", "es"]
+					}
+				} };
+			}
+		}
+	];
+}
+//#endregion
+//#region src/projects/project.mts
+/**
+* The base plugin for all project types.
+*
+* This will be included with every project.  The default build engine for all projects
+* is swc.  While esbuild and oxc outperform swc, swc has the closest and most accurate
+* implementation of the latest ECMAScript features which gives us one unified build engine.
+*
+* A vite build should only include one project type and as many extensions as it wants.
+*
+* @returns
+*        A list of plugins that all project types will provide.
+*/ function project() {
+	return [unplugin_swc.default.vite({ jsc: { transform: { react: { runtime: "automatic" } } } }), {
+		name: "janitor:project",
+		config: () => {
+			return {
+				oxc: false,
+				resolve: { tsconfigPaths: true },
+				build: {
+					chunkSizeWarningLimit: 8e3,
+					minify: true,
+					sourcemap: false,
+					rolldownOptions: { checks: { pluginTimings: false } }
+				},
+				test: {
+					globals: true,
+					testTimeout: 2e4,
+					maxConcurrency: 10
+				}
+			};
+		}
+	}];
+}
+//#endregion
+//#region src/projects/project-node.mts
+/**
+* A plugin that marks a project as a node application.
+*
+* Node applications expect an entry point of main.mts under the
+* src directory.
+*
+* @returns
+*        A list of plugins that turn a project into a node base cli
+*        project.
+*/ function projectNode() {
+	return [
+		...project(),
+		...extensionExternalize({ packageJson: false }),
+		{
+			name: "janitor:project-node",
+			config: (current) => {
+				const cwd = resolveCwd(current);
+				return {
+					resolve: {
+						conditions: [
+							"module",
+							"node",
+							"development|production"
+						],
+						mainFields: [
+							"module",
+							"jsnext:main",
+							"jsnext"
+						]
+					},
+					build: { lib: {
+						entry: { main: (0, node_path.resolve)(cwd, "./src/main.mts") },
+						formats: ["es"]
+					} }
+				};
+			}
+		}
+	];
+}
+//#endregion
+//#region src/projects/project-cli.mts
+/**
+* Currently the same as {@link projectNode}.
+*
+* @returns
+*        A list of plugins that turn your project into a cli.
+*/ function projectCli() {
+	return [...projectNode(), { name: "janitor:project-cli" }];
+}
+//#endregion
+//#region src/projects/project-dom.mts
+/**
+* A project for the DOM is a frontend application built with
+* basic web components, html, and css.
+*
+* Frontend projects with frameworks will automatically have this plugin.
+*
+* This will set the testing environment to happy-dom.
+*
+* @returns
+*      A list of plugins that setup a vite build as a project for
+*      a frontend.
+*/ function projectDom() {
+	return [...project(), {
+		name: "janitor:project-dom",
+		config: () => {
+			return { test: {
+				environment: "happy-dom",
+				pool: "vmThreads",
+				environmentOptions: { happyDOM: { settings: { handleDisabledFileLoadingAsSuccess: true } } }
+			} };
+		}
+	}];
+}
+//#endregion
+//#region src/projects/project-monorepo.mts
+/**
+* A special project type for the root vite config or vitest config where
+* the repository is a monorepo of packages that use more than one config entry
+* for each package.
+*
+* This should only be set in a monorepo where the root just specifies which
+* packages the monorepo outputs.  It sets up vitest to look for vite.config
+* files under each package.
+*
+* @returns
+*        The list of plugins to use for the root monorepo.
+*/ function projectMonorepo() {
+	return [...project(), {
+		name: "janitor:project-monorepo",
+		config: (current) => {
+			return { test: { projects: [`${resolveCwd(current)}/packages/*/{vite,vitest}.config.{js,cjs,mjs,ts,mts}`] } };
+		}
+	}];
+}
+//#endregion
+//#region src/projects/project-nestjs.mts
+/**
+* Currently the same as {@link projectNode}.
+*
+* @returns
+*        A list of plugins that turn your project into an app that
+*        runs a NestJS backend.
+*/ function projectNestJs() {
+	return [...projectNode(), { name: "janitor:project-nestjs" }];
+}
+//#endregion
+//#region src/projects/project-react.mts
+/**
+* A project that builds out a react website.
+*
+* A react website is just a dom project that has the
+* react swc plugin enabled.
+*
+* This should normally be coupled with the server extension
+* for full debugging support.
+*
+* @returns
+*        A list of plugins that builds a react website.
+*/ function projectReact() {
+	return [
+		...projectDom(),
+		...(0, _vitejs_plugin_react_swc.default)(),
+		{
+			name: "janitor:project-react",
+			config: () => {
+				return { oxc: false };
+			}
+		}
+	];
+}
+//#endregion
+exports.extensionDevServer = extensionDevServer;
+exports.extensionExternalize = extensionExternalize;
+exports.extensionLibrary = extensionLibrary;
+exports.project = project;
+exports.projectCli = projectCli;
+exports.projectDom = projectDom;
+exports.projectMonorepo = projectMonorepo;
+exports.projectNestJs = projectNestJs;
+exports.projectNode = projectNode;
+exports.projectReact = projectReact;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["extensionDevServer","options","port","host","name","config","server","allowedHosts","strictPort","builtinModules","modules","getAllNodeBuiltins","map","m","RegExp","readFileSync","getAllPackageDependencies","pkg","externals","Set","contents","toString","dependencies","devDependencies","optionalDependencies","peerDependencies","JSON","parse","push","add","bind","Object","keys","concat","map","dep","RegExp","forEach","Array","from","resolveCwd","current","root","process","cwd","resolve","getAllNodeBuiltins","getAllPackageDependencies","resolveCwd","extensionExternalize","options","name","config","current","cwd","fallback","packageJson","externalDeps","Set","forEach","p","add","depMatchers","Array","from","build","rolldownOptions","external","source","some","depMatcher","test","resolve","castArray","dts","resolveCwd","extensionExternalize","extensionLibrary","compilerOptions","paths","include","exclude","name","config","current","cwd","build","minify","sourcemap","lib","entry","index","formats","swc","project","vite","jsc","transform","react","runtime","name","config","oxc","resolve","tsconfigPaths","build","chunkSizeWarningLimit","minify","sourcemap","rolldownOptions","checks","pluginTimings","test","globals","testTimeout","maxConcurrency","resolve","extensionExternalize","resolveCwd","project","projectNode","packageJson","name","config","current","cwd","conditions","mainFields","build","lib","entry","main","formats","projectNode","projectCli","name","project","projectDom","name","config","test","environment","pool","environmentOptions","happyDOM","settings","handleDisabledFileLoadingAsSuccess","resolveCwd","project","projectMonorepo","name","config","current","cwd","test","projects","projectNode","projectNestJs","name","react","projectDom","projectReact","name","config","oxc"],"sources":["../src/extensions/extension-dev-server.mts","../src/helpful/get-all-node-builtins.mts","../src/helpful/get-all-package-dependencies.mts","../src/helpful/resolve-cwd.mts","../src/extensions/extension-externalize.mts","../src/extensions/extension-library.mts","../src/projects/project.mts","../src/projects/project-node.mts","../src/projects/project-cli.mts","../src/projects/project-dom.mts","../src/projects/project-monorepo.mts","../src/projects/project-nestjs.mts","../src/projects/project-react.mts"],"sourcesContent":["import type { Plugin } from \"vite\";\n\n/**\n * Options for the dev server.\n *\n * The expectation for almost every repository in this instance\n * is that it is running the backend and frontend in a docker\n * compose environment, so it assumes it will be running in a docker\n * network.  \n *\n * If this isn't true, then these options will be useful.\n */\nexport interface ExtensionDevServerOptions {\n  /**\n   * The port to run on.  \n   *\n   * @default 5173\n   */\n  port?: number;\n\n  /**\n   * The binding host.\n   *\n   * @default \"0.0.0.0\"\n   */\n  host?: string;\n}\n\n/**\n * Adds a dev server to your vite build.\n *\n * This is usually paired with a dom based project and\n * is only used for debugging.  AllowedHosts in this plugin\n * is set to true to allow for local manipulation of the\n * OS host file to simulate true domains.\n *\n * @returns\n *        A list of plugins that add the dev server option.\n */\nexport function extensionDevServer(\n  options: ExtensionDevServerOptions = {},\n): Plugin[] {\n  const { port = 5173, host = \"0.0.0.0\" } = options;\n\n  return [\n    {\n      name: \"janitor:extension-dev-server\",\n      config: () => {\n        return {\n          server: {\n            allowedHosts: true,\n            strictPort: true,\n            host,\n            port,\n          },\n        };\n      },\n    },\n  ];\n}\n","import { builtinModules as modules } from \"node:module\";\n\nexport function getAllNodeBuiltins(): RegExp[] {\n  return modules.map((m) => new RegExp(`^(?:node:)?${m}$`));\n}\n","import { type PathLike, readFileSync } from \"node:fs\";\n\nexport function getAllPackageDependencies(pkg: PathLike): RegExp[] {\n  try {\n    const externals = new Set<RegExp>();\n\n    const contents = readFileSync(pkg).toString();\n    const {\n      dependencies = [],\n      devDependencies = [],\n      optionalDependencies = [],\n      peerDependencies = [],\n    } = JSON.parse(contents) as Record<string, Record<string, string>>;\n\n    const push = externals.add.bind(externals);\n\n    Object.keys(dependencies)\n      .concat(Object.keys(devDependencies))\n      .concat(Object.keys(optionalDependencies))\n      .concat(Object.keys(peerDependencies))\n      .map((dep) => new RegExp(`^${dep}(?:/.+)?$`))\n      .forEach(push);\n\n    return Array.from(externals);\n  } catch {\n    return [];\n  }\n}\n","import type { UserConfig } from \"vite\";\n\nexport function resolveCwd(current?: UserConfig): string {\n  return current?.root || process.cwd();\n}\n","import type { PathLike } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nimport type { Plugin, UserConfig } from \"vite\";\n\nimport { getAllNodeBuiltins } from \"../helpful/get-all-node-builtins.mjs\";\nimport { getAllPackageDependencies } from \"../helpful/get-all-package-dependencies.mjs\";\nimport { resolveCwd } from \"../helpful/resolve-cwd.mjs\";\n\n/**\n * Options for externalizing dependencies.\n */\nexport interface ExternalizeOptions {\n  /**\n   * The path to the package json file that contains dependencies\n   * to externalize or false to only externalize node builtins.\n   *\n   * If this is undefined, then the package.json in the current\n   * working directory will be used.\n   */\n  packageJson?: PathLike | false;\n}\n\n/**\n * An externalize extension tells a project to not bundle the dependencies together.  \n *\n * This is mostly used for libraries and if you use extensionLibrary(), or projectNode()\n * you do not need to include this extension as it will be included for you already.\n *\n * @param options -\n *        Optional options for how to externalize dependency values.\n *\n * @returns\n *        A list of plugins that will stop vite from bundling packages\n *        from the node_modules directory and node builtins.\n */\nexport const extensionExternalize = (\n  options: ExternalizeOptions = {},\n): Plugin[] => {\n  return [\n    {\n      name: \"janitor:extension-externalize\",\n      config: (current) => {\n        const cwd = resolveCwd(current);\n        const fallback = resolve(cwd, \"package.json\");\n        const { packageJson = fallback } = options;\n        const externalDeps = new Set<RegExp>(getAllNodeBuiltins());\n\n        if (packageJson !== false) {\n          getAllPackageDependencies(packageJson).forEach((p) =>\n            externalDeps.add(p),\n          );\n        }\n\n        const depMatchers = Array.from(externalDeps);\n\n        return {\n          build: {\n            rolldownOptions: {\n              external: (source) => {\n                return depMatchers.some((depMatcher) =>\n                  depMatcher.test(source),\n                );\n              },\n            },\n          },\n        } satisfies UserConfig;\n      },\n    },\n  ];\n};\n","import { resolve } from \"node:path\";\n\nimport { castArray } from \"lodash-es\";\nimport dts from \"unplugin-dts/vite\";\nimport type { Plugin } from \"vite\";\n\nimport { resolveCwd } from \"../helpful/resolve-cwd.mjs\";\nimport { extensionExternalize } from \"./extension-externalize.mjs\";\n\n/**\n * Turns any project into a shared library.\n *\n * A library does not actually run any code, it simply contains shared\n * code that makes up other projects.\n *\n * A library is expected to have an index.mts file under the src directory\n * that is a long list of exports that the library will provide to consumers.\n * Only one barrel export should be used for a library. It's better to have\n * multiple libraries than to complicate a library with subpaths in the\n * exports of package.json.  This keeps the expectations that when you npm\n * library \"foo\", you can do import { something } from 'foo' and not need to\n * have the brain overload of hunting down available paths from within.\n *\n * When you classify something as a library, source maps are turned on,\n * and none of your code for it will be minified.  This is to help with\n * debugging library code outside of the library development environment.\n * Module libraries in the janitor system are not expected to be deployed\n * to a system by themselves.  They are bundled with the overarching parent\n * application.\n *\n * @returns\n *        The list of plugins that turn any project into a library.\n */\nexport function extensionLibrary(): Plugin[] {\n  return [\n    ...extensionExternalize(),\n    ...castArray(\n      dts({\n        compilerOptions: {\n          // Always turn off paths when building for production.  You want to make\n          // sure that your build is building in the correct order and that your\n          // actual paths are correct.\n          paths: {},\n        },\n        // We only want to include output source files, not any config files outside\n        // of our source code directory.\n        include: [\"src/**/*.{js,mjs,cjs,ts,mts,jsx,tsx}\"],\n        // Make sure to exclude spec and test files as well, these don't need to\n        // be included (and shouldn't be).\n        exclude: [\"**/*.{spec,test}.{js,mjs,cjs,ts,mts,jsx,tsx}\"],\n      }),\n    ),\n    {\n      name: \"janitor:extension-library\",\n      config: (current) => {\n        const cwd = resolveCwd(current);\n\n        return {\n          build: {\n            minify: false,\n            sourcemap: true,\n            lib: {\n              entry: {\n                index: resolve(cwd, \"./src/index.mts\"),\n              },\n              formats: [\"cjs\", \"es\"],\n            },\n          },\n        };\n      },\n    },\n  ];\n}\n","import swc from \"unplugin-swc\";\nimport type { Plugin } from \"vite\";\n\n/**\n * The base plugin for all project types.\n *\n * This will be included with every project.  The default build engine for all projects\n * is swc.  While esbuild and oxc outperform swc, swc has the closest and most accurate\n * implementation of the latest ECMAScript features which gives us one unified build engine.\n *\n * A vite build should only include one project type and as many extensions as it wants.\n *\n * @returns\n *        A list of plugins that all project types will provide.\n */\nexport function project(): Plugin[] {\n  return [\n    swc.vite({\n      jsc: {\n        transform: {\n          react: {\n            runtime: \"automatic\",\n          },\n        },\n      },\n    }),\n    {\n      name: \"janitor:project\",\n      config: () => {\n        return {\n          oxc: false,\n          resolve: {\n            tsconfigPaths: true,\n          },\n          build: {\n            chunkSizeWarningLimit: 8000,\n            minify: true,\n            sourcemap: false,\n            rolldownOptions: {\n              checks: {\n                pluginTimings: false,\n              },\n            },\n          },\n          test: {\n            globals: true,\n            testTimeout: 20000,\n            maxConcurrency: 10,\n          },\n        };\n      },\n    },\n  ];\n}\n","import { resolve } from \"node:path\";\n\nimport type { Plugin } from \"vite\";\n\nimport { extensionExternalize } from \"../extensions/extension-externalize.mjs\";\nimport { resolveCwd } from \"../helpful/resolve-cwd.mjs\";\nimport { project } from \"./project.mjs\";\n\n/**\n * A plugin that marks a project as a node application.\n *\n * Node applications expect an entry point of main.mts under the\n * src directory.\n *\n * @returns\n *        A list of plugins that turn a project into a node base cli\n *        project.\n */\nexport function projectNode(): Plugin[] {\n  return [\n    ...project(),\n    ...extensionExternalize({ packageJson: false }),\n    {\n      name: \"janitor:project-node\",\n      config: (current) => {\n        const cwd = resolveCwd(current);\n\n        return {\n          resolve: {\n            conditions: [\"module\", \"node\", \"development|production\"],\n            mainFields: [\"module\", \"jsnext:main\", \"jsnext\"],\n          },\n          build: {\n            lib: {\n              entry: {\n                main: resolve(cwd, \"./src/main.mts\"),\n              },\n              formats: [\"es\"],\n            },\n          },\n        };\n      },\n    },\n  ];\n}\n","import type { Plugin } from \"vite\";\n\nimport { projectNode } from \"./project-node.mjs\";\n\n/**\n * Currently the same as {@link projectNode}.\n *\n * @returns\n *        A list of plugins that turn your project into a cli.\n */\nexport function projectCli(): Plugin[] {\n  return [\n    ...projectNode(),\n    {\n      name: \"janitor:project-cli\",\n    },\n  ];\n}\n","import \"vitest/config\";\n\nimport type { Plugin } from \"vite\";\n\nimport { project } from \"./project.mjs\";\n\n/**\n * A project for the DOM is a frontend application built with\n * basic web components, html, and css.\n *\n * Frontend projects with frameworks will automatically have this plugin.\n *\n * This will set the testing environment to happy-dom.\n *\n * @returns\n *      A list of plugins that setup a vite build as a project for\n *      a frontend.\n */\nexport function projectDom(): Plugin[] {\n  return [\n    ...project(),\n    {\n      name: \"janitor:project-dom\",\n      config: () => {\n        return {\n          test: {\n            environment: \"happy-dom\",\n            pool: \"vmThreads\",\n            environmentOptions: {\n              happyDOM: {\n                settings: {\n                  // This is to shut up happy-dom yelling about not being able\n                  // to download some injected css files.\n                  handleDisabledFileLoadingAsSuccess: true,\n                },\n              },\n            },\n          },\n        };\n      },\n    },\n  ];\n}\n","import \"vitest/config\";\n\nimport type { Plugin } from \"vite\";\n\nimport { resolveCwd } from \"../helpful/resolve-cwd.mjs\";\nimport { project } from \"./project.mjs\";\n\n/**\n * A special project type for the root vite config or vitest config where\n * the repository is a monorepo of packages that use more than one config entry\n * for each package.\n *\n * This should only be set in a monorepo where the root just specifies which\n * packages the monorepo outputs.  It sets up vitest to look for vite.config\n * files under each package.\n *\n * @returns\n *        The list of plugins to use for the root monorepo.\n */\nexport function projectMonorepo(): Plugin[] {\n  return [\n    ...project(),\n    {\n      name: \"janitor:project-monorepo\",\n      config: (current) => {\n        const cwd = resolveCwd(current);\n\n        return {\n          test: {\n            projects: [\n              `${cwd}/packages/*/{vite,vitest}.config.{js,cjs,mjs,ts,mts}`,\n            ],\n          },\n        };\n      },\n    },\n  ];\n}\n","import type { Plugin } from \"vite\";\n\nimport { projectNode } from \"./project-node.mjs\";\n\n/**\n * Currently the same as {@link projectNode}.\n *\n * @returns\n *        A list of plugins that turn your project into an app that\n *        runs a NestJS backend.\n */\nexport function projectNestJs(): Plugin[] {\n  return [\n    ...projectNode(),\n    {\n      name: \"janitor:project-nestjs\",\n    },\n  ];\n}\n","import react from \"@vitejs/plugin-react-swc\";\nimport type { Plugin } from \"vite\";\n\nimport { projectDom } from \"./project-dom.mjs\";\n\n/**\n * A project that builds out a react website.\n *\n * A react website is just a dom project that has the\n * react swc plugin enabled.\n *\n * This should normally be coupled with the server extension\n * for full debugging support.\n *\n * @returns\n *        A list of plugins that builds a react website.\n */\nexport function projectReact(): Plugin[] {\n  return [\n    ...projectDom(),\n    ...react(),\n    {\n      name: \"janitor:project-react\",\n      config: () => {\n        return {\n          oxc: false,\n        };\n      },\n    },\n  ];\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,10 @@
+export * from './extensions/extension-dev-server.mjs';
+export * from './extensions/extension-externalize.mjs';
+export * from './extensions/extension-library.mjs';
+export * from './projects/project.mjs';
+export * from './projects/project-cli.mjs';
+export * from './projects/project-dom.mjs';
+export * from './projects/project-monorepo.mjs';
+export * from './projects/project-nestjs.mjs';
+export * from './projects/project-node.mjs';
+export * from './projects/project-react.mjs';

package/dist/index.js

@@ -0,0 +1,308 @@
+import { resolve } from "node:path";
+import { builtinModules } from "node:module";
+import { readFileSync } from "node:fs";
+import { castArray } from "lodash-es";
+import dts from "unplugin-dts/vite";
+import swc from "unplugin-swc";
+import "vitest/config";
+import react from "@vitejs/plugin-react-swc";
+//#region src/extensions/extension-dev-server.mts
+/**
+* Adds a dev server to your vite build.
+*
+* This is usually paired with a dom based project and
+* is only used for debugging.  AllowedHosts in this plugin
+* is set to true to allow for local manipulation of the
+* OS host file to simulate true domains.
+*
+* @returns
+*        A list of plugins that add the dev server option.
+*/ function extensionDevServer(options = {}) {
+	const { port = 5173, host = "0.0.0.0" } = options;
+	return [{
+		name: "janitor:extension-dev-server",
+		config: () => {
+			return { server: {
+				allowedHosts: true,
+				strictPort: true,
+				host,
+				port
+			} };
+		}
+	}];
+}
+//#endregion
+//#region src/helpful/get-all-node-builtins.mts
+function getAllNodeBuiltins() {
+	return builtinModules.map((m) => new RegExp(`^(?:node:)?${m}$`));
+}
+//#endregion
+//#region src/helpful/get-all-package-dependencies.mts
+function getAllPackageDependencies(pkg) {
+	try {
+		const externals = /* @__PURE__ */ new Set();
+		const contents = readFileSync(pkg).toString();
+		const { dependencies = [], devDependencies = [], optionalDependencies = [], peerDependencies = [] } = JSON.parse(contents);
+		const push = externals.add.bind(externals);
+		Object.keys(dependencies).concat(Object.keys(devDependencies)).concat(Object.keys(optionalDependencies)).concat(Object.keys(peerDependencies)).map((dep) => new RegExp(`^${dep}(?:/.+)?$`)).forEach(push);
+		return Array.from(externals);
+	} catch {
+		return [];
+	}
+}
+//#endregion
+//#region src/helpful/resolve-cwd.mts
+function resolveCwd(current) {
+	return current?.root || process.cwd();
+}
+//#endregion
+//#region src/extensions/extension-externalize.mts
+/**
+* An externalize extension tells a project to not bundle the dependencies together.  
+*
+* This is mostly used for libraries and if you use extensionLibrary(), or projectNode()
+* you do not need to include this extension as it will be included for you already.
+*
+* @param options -
+*        Optional options for how to externalize dependency values.
+*
+* @returns
+*        A list of plugins that will stop vite from bundling packages
+*        from the node_modules directory and node builtins.
+*/ var extensionExternalize = (options = {}) => {
+	return [{
+		name: "janitor:extension-externalize",
+		config: (current) => {
+			const cwd = resolveCwd(current);
+			const fallback = resolve(cwd, "package.json");
+			const { packageJson = fallback } = options;
+			const externalDeps = new Set(getAllNodeBuiltins());
+			if (packageJson !== false) getAllPackageDependencies(packageJson).forEach((p) => externalDeps.add(p));
+			const depMatchers = Array.from(externalDeps);
+			return { build: { rolldownOptions: { external: (source) => {
+				return depMatchers.some((depMatcher) => depMatcher.test(source));
+			} } } };
+		}
+	}];
+};
+//#endregion
+//#region src/extensions/extension-library.mts
+/**
+* Turns any project into a shared library.
+*
+* A library does not actually run any code, it simply contains shared
+* code that makes up other projects.
+*
+* A library is expected to have an index.mts file under the src directory
+* that is a long list of exports that the library will provide to consumers.
+* Only one barrel export should be used for a library. It's better to have
+* multiple libraries than to complicate a library with subpaths in the
+* exports of package.json.  This keeps the expectations that when you npm
+* library "foo", you can do import { something } from 'foo' and not need to
+* have the brain overload of hunting down available paths from within.
+*
+* When you classify something as a library, source maps are turned on,
+* and none of your code for it will be minified.  This is to help with
+* debugging library code outside of the library development environment.
+* Module libraries in the janitor system are not expected to be deployed
+* to a system by themselves.  They are bundled with the overarching parent
+* application.
+*
+* @returns
+*        The list of plugins that turn any project into a library.
+*/ function extensionLibrary() {
+	return [
+		...extensionExternalize(),
+		...castArray(dts({
+			compilerOptions: { paths: {} },
+			include: ["src/**/*.{js,mjs,cjs,ts,mts,jsx,tsx}"],
+			exclude: ["**/*.{spec,test}.{js,mjs,cjs,ts,mts,jsx,tsx}"]
+		})),
+		{
+			name: "janitor:extension-library",
+			config: (current) => {
+				const cwd = resolveCwd(current);
+				return { build: {
+					minify: false,
+					sourcemap: true,
+					lib: {
+						entry: { index: resolve(cwd, "./src/index.mts") },
+						formats: ["cjs", "es"]
+					}
+				} };
+			}
+		}
+	];
+}
+//#endregion
+//#region src/projects/project.mts
+/**
+* The base plugin for all project types.
+*
+* This will be included with every project.  The default build engine for all projects
+* is swc.  While esbuild and oxc outperform swc, swc has the closest and most accurate
+* implementation of the latest ECMAScript features which gives us one unified build engine.
+*
+* A vite build should only include one project type and as many extensions as it wants.
+*
+* @returns
+*        A list of plugins that all project types will provide.
+*/ function project() {
+	return [swc.vite({ jsc: { transform: { react: { runtime: "automatic" } } } }), {
+		name: "janitor:project",
+		config: () => {
+			return {
+				oxc: false,
+				resolve: { tsconfigPaths: true },
+				build: {
+					chunkSizeWarningLimit: 8e3,
+					minify: true,
+					sourcemap: false,
+					rolldownOptions: { checks: { pluginTimings: false } }
+				},
+				test: {
+					globals: true,
+					testTimeout: 2e4,
+					maxConcurrency: 10
+				}
+			};
+		}
+	}];
+}
+//#endregion
+//#region src/projects/project-node.mts
+/**
+* A plugin that marks a project as a node application.
+*
+* Node applications expect an entry point of main.mts under the
+* src directory.
+*
+* @returns
+*        A list of plugins that turn a project into a node base cli
+*        project.
+*/ function projectNode() {
+	return [
+		...project(),
+		...extensionExternalize({ packageJson: false }),
+		{
+			name: "janitor:project-node",
+			config: (current) => {
+				const cwd = resolveCwd(current);
+				return {
+					resolve: {
+						conditions: [
+							"module",
+							"node",
+							"development|production"
+						],
+						mainFields: [
+							"module",
+							"jsnext:main",
+							"jsnext"
+						]
+					},
+					build: { lib: {
+						entry: { main: resolve(cwd, "./src/main.mts") },
+						formats: ["es"]
+					} }
+				};
+			}
+		}
+	];
+}
+//#endregion
+//#region src/projects/project-cli.mts
+/**
+* Currently the same as {@link projectNode}.
+*
+* @returns
+*        A list of plugins that turn your project into a cli.
+*/ function projectCli() {
+	return [...projectNode(), { name: "janitor:project-cli" }];
+}
+//#endregion
+//#region src/projects/project-dom.mts
+/**
+* A project for the DOM is a frontend application built with
+* basic web components, html, and css.
+*
+* Frontend projects with frameworks will automatically have this plugin.
+*
+* This will set the testing environment to happy-dom.
+*
+* @returns
+*      A list of plugins that setup a vite build as a project for
+*      a frontend.
+*/ function projectDom() {
+	return [...project(), {
+		name: "janitor:project-dom",
+		config: () => {
+			return { test: {
+				environment: "happy-dom",
+				pool: "vmThreads",
+				environmentOptions: { happyDOM: { settings: { handleDisabledFileLoadingAsSuccess: true } } }
+			} };
+		}
+	}];
+}
+//#endregion
+//#region src/projects/project-monorepo.mts
+/**
+* A special project type for the root vite config or vitest config where
+* the repository is a monorepo of packages that use more than one config entry
+* for each package.
+*
+* This should only be set in a monorepo where the root just specifies which
+* packages the monorepo outputs.  It sets up vitest to look for vite.config
+* files under each package.
+*
+* @returns
+*        The list of plugins to use for the root monorepo.
+*/ function projectMonorepo() {
+	return [...project(), {
+		name: "janitor:project-monorepo",
+		config: (current) => {
+			return { test: { projects: [`${resolveCwd(current)}/packages/*/{vite,vitest}.config.{js,cjs,mjs,ts,mts}`] } };
+		}
+	}];
+}
+//#endregion
+//#region src/projects/project-nestjs.mts
+/**
+* Currently the same as {@link projectNode}.
+*
+* @returns
+*        A list of plugins that turn your project into an app that
+*        runs a NestJS backend.
+*/ function projectNestJs() {
+	return [...projectNode(), { name: "janitor:project-nestjs" }];
+}
+//#endregion
+//#region src/projects/project-react.mts
+/**
+* A project that builds out a react website.
+*
+* A react website is just a dom project that has the
+* react swc plugin enabled.
+*
+* This should normally be coupled with the server extension
+* for full debugging support.
+*
+* @returns
+*        A list of plugins that builds a react website.
+*/ function projectReact() {
+	return [
+		...projectDom(),
+		...react(),
+		{
+			name: "janitor:project-react",
+			config: () => {
+				return { oxc: false };
+			}
+		}
+	];
+}
+//#endregion
+export { extensionDevServer, extensionExternalize, extensionLibrary, project, projectCli, projectDom, projectMonorepo, projectNestJs, projectNode, projectReact };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["extensionDevServer","options","port","host","name","config","server","allowedHosts","strictPort","builtinModules","modules","getAllNodeBuiltins","map","m","RegExp","readFileSync","getAllPackageDependencies","pkg","externals","Set","contents","toString","dependencies","devDependencies","optionalDependencies","peerDependencies","JSON","parse","push","add","bind","Object","keys","concat","map","dep","RegExp","forEach","Array","from","resolveCwd","current","root","process","cwd","resolve","getAllNodeBuiltins","getAllPackageDependencies","resolveCwd","extensionExternalize","options","name","config","current","cwd","fallback","packageJson","externalDeps","Set","forEach","p","add","depMatchers","Array","from","build","rolldownOptions","external","source","some","depMatcher","test","resolve","castArray","dts","resolveCwd","extensionExternalize","extensionLibrary","compilerOptions","paths","include","exclude","name","config","current","cwd","build","minify","sourcemap","lib","entry","index","formats","swc","project","vite","jsc","transform","react","runtime","name","config","oxc","resolve","tsconfigPaths","build","chunkSizeWarningLimit","minify","sourcemap","rolldownOptions","checks","pluginTimings","test","globals","testTimeout","maxConcurrency","resolve","extensionExternalize","resolveCwd","project","projectNode","packageJson","name","config","current","cwd","conditions","mainFields","build","lib","entry","main","formats","projectNode","projectCli","name","project","projectDom","name","config","test","environment","pool","environmentOptions","happyDOM","settings","handleDisabledFileLoadingAsSuccess","resolveCwd","project","projectMonorepo","name","config","current","cwd","test","projects","projectNode","projectNestJs","name","react","projectDom","projectReact","name","config","oxc"],"sources":["../src/extensions/extension-dev-server.mts","../src/helpful/get-all-node-builtins.mts","../src/helpful/get-all-package-dependencies.mts","../src/helpful/resolve-cwd.mts","../src/extensions/extension-externalize.mts","../src/extensions/extension-library.mts","../src/projects/project.mts","../src/projects/project-node.mts","../src/projects/project-cli.mts","../src/projects/project-dom.mts","../src/projects/project-monorepo.mts","../src/projects/project-nestjs.mts","../src/projects/project-react.mts"],"sourcesContent":["import type { Plugin } from \"vite\";\n\n/**\n * Options for the dev server.\n *\n * The expectation for almost every repository in this instance\n * is that it is running the backend and frontend in a docker\n * compose environment, so it assumes it will be running in a docker\n * network.  \n *\n * If this isn't true, then these options will be useful.\n */\nexport interface ExtensionDevServerOptions {\n  /**\n   * The port to run on.  \n   *\n   * @default 5173\n   */\n  port?: number;\n\n  /**\n   * The binding host.\n   *\n   * @default \"0.0.0.0\"\n   */\n  host?: string;\n}\n\n/**\n * Adds a dev server to your vite build.\n *\n * This is usually paired with a dom based project and\n * is only used for debugging.  AllowedHosts in this plugin\n * is set to true to allow for local manipulation of the\n * OS host file to simulate true domains.\n *\n * @returns\n *        A list of plugins that add the dev server option.\n */\nexport function extensionDevServer(\n  options: ExtensionDevServerOptions = {},\n): Plugin[] {\n  const { port = 5173, host = \"0.0.0.0\" } = options;\n\n  return [\n    {\n      name: \"janitor:extension-dev-server\",\n      config: () => {\n        return {\n          server: {\n            allowedHosts: true,\n            strictPort: true,\n            host,\n            port,\n          },\n        };\n      },\n    },\n  ];\n}\n","import { builtinModules as modules } from \"node:module\";\n\nexport function getAllNodeBuiltins(): RegExp[] {\n  return modules.map((m) => new RegExp(`^(?:node:)?${m}$`));\n}\n","import { type PathLike, readFileSync } from \"node:fs\";\n\nexport function getAllPackageDependencies(pkg: PathLike): RegExp[] {\n  try {\n    const externals = new Set<RegExp>();\n\n    const contents = readFileSync(pkg).toString();\n    const {\n      dependencies = [],\n      devDependencies = [],\n      optionalDependencies = [],\n      peerDependencies = [],\n    } = JSON.parse(contents) as Record<string, Record<string, string>>;\n\n    const push = externals.add.bind(externals);\n\n    Object.keys(dependencies)\n      .concat(Object.keys(devDependencies))\n      .concat(Object.keys(optionalDependencies))\n      .concat(Object.keys(peerDependencies))\n      .map((dep) => new RegExp(`^${dep}(?:/.+)?$`))\n      .forEach(push);\n\n    return Array.from(externals);\n  } catch {\n    return [];\n  }\n}\n","import type { UserConfig } from \"vite\";\n\nexport function resolveCwd(current?: UserConfig): string {\n  return current?.root || process.cwd();\n}\n","import type { PathLike } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nimport type { Plugin, UserConfig } from \"vite\";\n\nimport { getAllNodeBuiltins } from \"../helpful/get-all-node-builtins.mjs\";\nimport { getAllPackageDependencies } from \"../helpful/get-all-package-dependencies.mjs\";\nimport { resolveCwd } from \"../helpful/resolve-cwd.mjs\";\n\n/**\n * Options for externalizing dependencies.\n */\nexport interface ExternalizeOptions {\n  /**\n   * The path to the package json file that contains dependencies\n   * to externalize or false to only externalize node builtins.\n   *\n   * If this is undefined, then the package.json in the current\n   * working directory will be used.\n   */\n  packageJson?: PathLike | false;\n}\n\n/**\n * An externalize extension tells a project to not bundle the dependencies together.  \n *\n * This is mostly used for libraries and if you use extensionLibrary(), or projectNode()\n * you do not need to include this extension as it will be included for you already.\n *\n * @param options -\n *        Optional options for how to externalize dependency values.\n *\n * @returns\n *        A list of plugins that will stop vite from bundling packages\n *        from the node_modules directory and node builtins.\n */\nexport const extensionExternalize = (\n  options: ExternalizeOptions = {},\n): Plugin[] => {\n  return [\n    {\n      name: \"janitor:extension-externalize\",\n      config: (current) => {\n        const cwd = resolveCwd(current);\n        const fallback = resolve(cwd, \"package.json\");\n        const { packageJson = fallback } = options;\n        const externalDeps = new Set<RegExp>(getAllNodeBuiltins());\n\n        if (packageJson !== false) {\n          getAllPackageDependencies(packageJson).forEach((p) =>\n            externalDeps.add(p),\n          );\n        }\n\n        const depMatchers = Array.from(externalDeps);\n\n        return {\n          build: {\n            rolldownOptions: {\n              external: (source) => {\n                return depMatchers.some((depMatcher) =>\n                  depMatcher.test(source),\n                );\n              },\n            },\n          },\n        } satisfies UserConfig;\n      },\n    },\n  ];\n};\n","import { resolve } from \"node:path\";\n\nimport { castArray } from \"lodash-es\";\nimport dts from \"unplugin-dts/vite\";\nimport type { Plugin } from \"vite\";\n\nimport { resolveCwd } from \"../helpful/resolve-cwd.mjs\";\nimport { extensionExternalize } from \"./extension-externalize.mjs\";\n\n/**\n * Turns any project into a shared library.\n *\n * A library does not actually run any code, it simply contains shared\n * code that makes up other projects.\n *\n * A library is expected to have an index.mts file under the src directory\n * that is a long list of exports that the library will provide to consumers.\n * Only one barrel export should be used for a library. It's better to have\n * multiple libraries than to complicate a library with subpaths in the\n * exports of package.json.  This keeps the expectations that when you npm\n * library \"foo\", you can do import { something } from 'foo' and not need to\n * have the brain overload of hunting down available paths from within.\n *\n * When you classify something as a library, source maps are turned on,\n * and none of your code for it will be minified.  This is to help with\n * debugging library code outside of the library development environment.\n * Module libraries in the janitor system are not expected to be deployed\n * to a system by themselves.  They are bundled with the overarching parent\n * application.\n *\n * @returns\n *        The list of plugins that turn any project into a library.\n */\nexport function extensionLibrary(): Plugin[] {\n  return [\n    ...extensionExternalize(),\n    ...castArray(\n      dts({\n        compilerOptions: {\n          // Always turn off paths when building for production.  You want to make\n          // sure that your build is building in the correct order and that your\n          // actual paths are correct.\n          paths: {},\n        },\n        // We only want to include output source files, not any config files outside\n        // of our source code directory.\n        include: [\"src/**/*.{js,mjs,cjs,ts,mts,jsx,tsx}\"],\n        // Make sure to exclude spec and test files as well, these don't need to\n        // be included (and shouldn't be).\n        exclude: [\"**/*.{spec,test}.{js,mjs,cjs,ts,mts,jsx,tsx}\"],\n      }),\n    ),\n    {\n      name: \"janitor:extension-library\",\n      config: (current) => {\n        const cwd = resolveCwd(current);\n\n        return {\n          build: {\n            minify: false,\n            sourcemap: true,\n            lib: {\n              entry: {\n                index: resolve(cwd, \"./src/index.mts\"),\n              },\n              formats: [\"cjs\", \"es\"],\n            },\n          },\n        };\n      },\n    },\n  ];\n}\n","import swc from \"unplugin-swc\";\nimport type { Plugin } from \"vite\";\n\n/**\n * The base plugin for all project types.\n *\n * This will be included with every project.  The default build engine for all projects\n * is swc.  While esbuild and oxc outperform swc, swc has the closest and most accurate\n * implementation of the latest ECMAScript features which gives us one unified build engine.\n *\n * A vite build should only include one project type and as many extensions as it wants.\n *\n * @returns\n *        A list of plugins that all project types will provide.\n */\nexport function project(): Plugin[] {\n  return [\n    swc.vite({\n      jsc: {\n        transform: {\n          react: {\n            runtime: \"automatic\",\n          },\n        },\n      },\n    }),\n    {\n      name: \"janitor:project\",\n      config: () => {\n        return {\n          oxc: false,\n          resolve: {\n            tsconfigPaths: true,\n          },\n          build: {\n            chunkSizeWarningLimit: 8000,\n            minify: true,\n            sourcemap: false,\n            rolldownOptions: {\n              checks: {\n                pluginTimings: false,\n              },\n            },\n          },\n          test: {\n            globals: true,\n            testTimeout: 20000,\n            maxConcurrency: 10,\n          },\n        };\n      },\n    },\n  ];\n}\n","import { resolve } from \"node:path\";\n\nimport type { Plugin } from \"vite\";\n\nimport { extensionExternalize } from \"../extensions/extension-externalize.mjs\";\nimport { resolveCwd } from \"../helpful/resolve-cwd.mjs\";\nimport { project } from \"./project.mjs\";\n\n/**\n * A plugin that marks a project as a node application.\n *\n * Node applications expect an entry point of main.mts under the\n * src directory.\n *\n * @returns\n *        A list of plugins that turn a project into a node base cli\n *        project.\n */\nexport function projectNode(): Plugin[] {\n  return [\n    ...project(),\n    ...extensionExternalize({ packageJson: false }),\n    {\n      name: \"janitor:project-node\",\n      config: (current) => {\n        const cwd = resolveCwd(current);\n\n        return {\n          resolve: {\n            conditions: [\"module\", \"node\", \"development|production\"],\n            mainFields: [\"module\", \"jsnext:main\", \"jsnext\"],\n          },\n          build: {\n            lib: {\n              entry: {\n                main: resolve(cwd, \"./src/main.mts\"),\n              },\n              formats: [\"es\"],\n            },\n          },\n        };\n      },\n    },\n  ];\n}\n","import type { Plugin } from \"vite\";\n\nimport { projectNode } from \"./project-node.mjs\";\n\n/**\n * Currently the same as {@link projectNode}.\n *\n * @returns\n *        A list of plugins that turn your project into a cli.\n */\nexport function projectCli(): Plugin[] {\n  return [\n    ...projectNode(),\n    {\n      name: \"janitor:project-cli\",\n    },\n  ];\n}\n","import \"vitest/config\";\n\nimport type { Plugin } from \"vite\";\n\nimport { project } from \"./project.mjs\";\n\n/**\n * A project for the DOM is a frontend application built with\n * basic web components, html, and css.\n *\n * Frontend projects with frameworks will automatically have this plugin.\n *\n * This will set the testing environment to happy-dom.\n *\n * @returns\n *      A list of plugins that setup a vite build as a project for\n *      a frontend.\n */\nexport function projectDom(): Plugin[] {\n  return [\n    ...project(),\n    {\n      name: \"janitor:project-dom\",\n      config: () => {\n        return {\n          test: {\n            environment: \"happy-dom\",\n            pool: \"vmThreads\",\n            environmentOptions: {\n              happyDOM: {\n                settings: {\n                  // This is to shut up happy-dom yelling about not being able\n                  // to download some injected css files.\n                  handleDisabledFileLoadingAsSuccess: true,\n                },\n              },\n            },\n          },\n        };\n      },\n    },\n  ];\n}\n","import \"vitest/config\";\n\nimport type { Plugin } from \"vite\";\n\nimport { resolveCwd } from \"../helpful/resolve-cwd.mjs\";\nimport { project } from \"./project.mjs\";\n\n/**\n * A special project type for the root vite config or vitest config where\n * the repository is a monorepo of packages that use more than one config entry\n * for each package.\n *\n * This should only be set in a monorepo where the root just specifies which\n * packages the monorepo outputs.  It sets up vitest to look for vite.config\n * files under each package.\n *\n * @returns\n *        The list of plugins to use for the root monorepo.\n */\nexport function projectMonorepo(): Plugin[] {\n  return [\n    ...project(),\n    {\n      name: \"janitor:project-monorepo\",\n      config: (current) => {\n        const cwd = resolveCwd(current);\n\n        return {\n          test: {\n            projects: [\n              `${cwd}/packages/*/{vite,vitest}.config.{js,cjs,mjs,ts,mts}`,\n            ],\n          },\n        };\n      },\n    },\n  ];\n}\n","import type { Plugin } from \"vite\";\n\nimport { projectNode } from \"./project-node.mjs\";\n\n/**\n * Currently the same as {@link projectNode}.\n *\n * @returns\n *        A list of plugins that turn your project into an app that\n *        runs a NestJS backend.\n */\nexport function projectNestJs(): Plugin[] {\n  return [\n    ...projectNode(),\n    {\n      name: \"janitor:project-nestjs\",\n    },\n  ];\n}\n","import react from \"@vitejs/plugin-react-swc\";\nimport type { Plugin } from \"vite\";\n\nimport { projectDom } from \"./project-dom.mjs\";\n\n/**\n * A project that builds out a react website.\n *\n * A react website is just a dom project that has the\n * react swc plugin enabled.\n *\n * This should normally be coupled with the server extension\n * for full debugging support.\n *\n * @returns\n *        A list of plugins that builds a react website.\n */\nexport function projectReact(): Plugin[] {\n  return [\n    ...projectDom(),\n    ...react(),\n    {\n      name: \"janitor:project-react\",\n      config: () => {\n        return {\n          oxc: false,\n        };\n      },\n    },\n  ];\n}\n"],"mappings":"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"}

package/dist/projects/project-cli.d.mts

@@ -0,0 +1,8 @@
+import { Plugin } from 'vite';
+/**
+ * Currently the same as {@link projectNode}.
+ *
+ * @returns
+ *        A list of plugins that turn your project into a cli.
+ */
+export declare function projectCli(): Plugin[];

package/dist/projects/project-dom.d.mts

@@ -0,0 +1,14 @@
+import { Plugin } from 'vite';
+/**
+ * A project for the DOM is a frontend application built with
+ * basic web components, html, and css.
+ *
+ * Frontend projects with frameworks will automatically have this plugin.
+ *
+ * This will set the testing environment to happy-dom.
+ *
+ * @returns
+ *      A list of plugins that setup a vite build as a project for
+ *      a frontend.
+ */
+export declare function projectDom(): Plugin[];

package/dist/projects/project-monorepo.d.mts

@@ -0,0 +1,14 @@
+import { Plugin } from 'vite';
+/**
+ * A special project type for the root vite config or vitest config where
+ * the repository is a monorepo of packages that use more than one config entry
+ * for each package.
+ *
+ * This should only be set in a monorepo where the root just specifies which
+ * packages the monorepo outputs.  It sets up vitest to look for vite.config
+ * files under each package.
+ *
+ * @returns
+ *        The list of plugins to use for the root monorepo.
+ */
+export declare function projectMonorepo(): Plugin[];

package/dist/projects/project-nestjs.d.mts

@@ -0,0 +1,9 @@
+import { Plugin } from 'vite';
+/**
+ * Currently the same as {@link projectNode}.
+ *
+ * @returns
+ *        A list of plugins that turn your project into an app that
+ *        runs a NestJS backend.
+ */
+export declare function projectNestJs(): Plugin[];

package/dist/projects/project-node.d.mts

@@ -0,0 +1,12 @@
+import { Plugin } from 'vite';
+/**
+ * A plugin that marks a project as a node application.
+ *
+ * Node applications expect an entry point of main.mts under the
+ * src directory.
+ *
+ * @returns
+ *        A list of plugins that turn a project into a node base cli
+ *        project.
+ */
+export declare function projectNode(): Plugin[];

package/dist/projects/project-react.d.mts

@@ -0,0 +1,14 @@
+import { Plugin } from 'vite';
+/**
+ * A project that builds out a react website.
+ *
+ * A react website is just a dom project that has the
+ * react swc plugin enabled.
+ *
+ * This should normally be coupled with the server extension
+ * for full debugging support.
+ *
+ * @returns
+ *        A list of plugins that builds a react website.
+ */
+export declare function projectReact(): Plugin[];

package/dist/projects/project.d.mts

@@ -0,0 +1,14 @@
+import { Plugin } from 'vite';
+/**
+ * The base plugin for all project types.
+ *
+ * This will be included with every project.  The default build engine for all projects
+ * is swc.  While esbuild and oxc outperform swc, swc has the closest and most accurate
+ * implementation of the latest ECMAScript features which gives us one unified build engine.
+ *
+ * A vite build should only include one project type and as many extensions as it wants.
+ *
+ * @returns
+ *        A list of plugins that all project types will provide.
+ */
+export declare function project(): Plugin[];

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@zthun/janitor-vite",
+  "version": "21.1.0",
+  "description": "A shared set of plugins for vite that use conventions over configuration",
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "exports": {
+    "types": "./dist/index.d.mts",
+    "require": "./dist/index.cjs",
+    "import": "./dist/index.js"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "vite build"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zthun/janitor",
+    "directory": "packages/janitor-vite"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@swc/core": "^1.16.0",
+    "@vitejs/plugin-react-swc": "^4.3.3",
+    "happy-dom": "^20.11.2",
+    "lodash-es": "^4.18.1",
+    "unplugin-dts": "^1.0.3",
+    "unplugin-swc": "^1.5.11",
+    "vite": "^8.2.1",
+    "vitest": "^4.1.11"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "happy-dom": "^20.11.2",
+    "vite": "^8.2.1",
+    "vitest": "^4.1.11"
+  },
+  "peerDependenciesMeta": {
+    "happy-dom": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Anthony Bonta",
+  "gitHead": "1541f1775452c766b016e1e8e830a717a4bb8eca"
+}