@party-stack/build-config 0.0.0-stage → 0.1.2

package/LICENSE

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

package/README.md

@@ -1,3 +1,41 @@
-# Temporary Holding Version
+# Build config
 
-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.
+Shared Vite+, Vitest, and TypeScript settings for libraries and apps.
+
+```ts
+import { defineLibraryConfig } from "@party-stack/build-config";
+
+export default defineLibraryConfig();
+```
+
+```json
+{
+    "extends": "@party-stack/build-config/tsconfig.json"
+}
+```
+
+React and Expo libraries use `@party-stack/build-config/react/tsconfig.json` for
+JSX and bundler module resolution. They use the same Vite helper.
+
+The preset provides:
+
+- `check`, `build`, and `test` tasks, ordered after their prerequisites.
+- Unbundled ESM, declarations, and source maps in `lib` through `vp pack`.
+- Vitest discovery under `src`, with package-specific test options.
+- TypeScript path resolution through `resolve.tsconfigPaths` for libraries and apps.
+- Strict TypeScript settings targeting ES2022, with Node and DOM types.
+
+Apps use `defineAppConfig` from the same package. It provides check/build/test/dev
+tasks, browser targets, and `.test.ts`/`.test.tsx` discovery. Supply framework
+plugins and app-specific settings in the caller. Apps can extend
+`@party-stack/build-config/app/tsconfig.json` for strict checks without emitting.
+TanStack Start apps use `@party-stack/tanstack-start-build-config` for framework
+plugins, React Compiler, Tailwind, and the app TSConfig together.
+
+Package options override the defaults. Resolve and individual task options are merged;
+arrays and task cache options replace their defaults. Lint and formatting remain
+in the workspace root.
+
+The package builds during installation. After editing it, run
+`vp run @party-stack/build-config#build`. If its `lib` output is missing, bootstrap
+with `pnpm exec vp -C packages/build-config pack`.

package/lib/index.d.ts

@@ -0,0 +1,21 @@
+import { ViteUserConfig } from "vite-plus";
+//#region src/index.d.ts
+type RunConfig = NonNullable<ViteUserConfig["run"]>;
+type TaskDefinition = NonNullable<RunConfig["tasks"]>[string];
+type TaskOptions = Exclude<TaskDefinition, string | string[]>;
+/** Override individual task options without repeating their command or prerequisites. */
+export type LibraryConfig = Omit<ViteUserConfig, "run"> & {
+  run?: Omit<RunConfig, "tasks"> & {
+    tasks?: Record<string, string | string[] | Partial<TaskOptions>>;
+  };
+};
+/**
+ * Configure an ESM library. Package overrides replace arrays and merge the
+ * pack, test, and individual task options with these defaults.
+ */
+export declare function defineLibraryConfig(config?: LibraryConfig): ViteUserConfig;
+export type AppConfig = LibraryConfig;
+/** Configure app tasks while leaving framework plugins with the caller. */
+export declare function defineAppConfig(config?: AppConfig): ViteUserConfig;
+//#endregion
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;KAGK,YAAY,YAAY;KACxB,iBAAiB,YAAY;KAC7B,cAAc,QAAQ;;YAGf,gBAAgB,KAAK;EAC7B,MAAM,KAAK;IACP,QAAQ,mCAAmC,QAAQ;;;;;;;wBAQ3C,oBAAoB,SAAQ,gBAAqB;YA2CrD,YAAY;;wBAGR,gBAAgB,SAAQ,YAAiB"}

package/lib/index.js

@@ -0,0 +1,151 @@
+import { defineConfig } from "vite-plus";
+//#region src/index.ts
+/**
+* Configure an ESM library. Package overrides replace arrays and merge the
+* pack, test, and individual task options with these defaults.
+*/
+function defineLibraryConfig(config = {}) {
+	return composeConfig(defineConfig({
+		resolve: { tsconfigPaths: true },
+		run: { tasks: {
+			check: {
+				command: "vp check",
+				cache: { input: [
+					{ auto: true },
+					"!.",
+					"*.{json,jsonc,ts,mts,js,mjs}"
+				] },
+				dependsOn: [{
+					task: "build",
+					from: ["dependencies", "devDependencies"]
+				}]
+			},
+			build: {
+				command: "vp pack",
+				cache: { input: [
+					{ auto: true },
+					"!.",
+					"*.{json,jsonc,ts,mts,js,mjs}",
+					"!lib/**"
+				] },
+				dependsOn: ["check", {
+					task: "build",
+					from: ["dependencies", "devDependencies"]
+				}]
+			},
+			test: {
+				command: "vp test",
+				dependsOn: ["build"]
+			}
+		} },
+		pack: {
+			entry: [
+				"src/**/*.{ts,tsx}",
+				"!src/**/*.d.ts",
+				"!src/**/*.test.{ts,tsx}",
+				"!src/**/*.bench.{ts,tsx}"
+			],
+			outDir: "lib",
+			root: "src",
+			target: "es2022",
+			unbundle: true,
+			fixedExtension: false,
+			deps: { neverBundle: true }
+		},
+		test: {
+			include: ["src/**/*.test.{ts,tsx}"],
+			passWithNoTests: true
+		}
+	}), config);
+}
+/** Configure app tasks while leaving framework plugins with the caller. */
+function defineAppConfig(config = {}) {
+	return composeConfig(defineConfig({
+		resolve: { tsconfigPaths: true },
+		run: { tasks: {
+			check: {
+				command: "vp check",
+				dependsOn: [{
+					task: "build",
+					from: ["dependencies", "devDependencies"]
+				}]
+			},
+			build: {
+				command: "vp build",
+				cache: { untrackedEnv: ["SHLVL"] },
+				dependsOn: ["check", {
+					task: "build",
+					from: ["dependencies", "devDependencies"]
+				}]
+			},
+			test: {
+				command: "vp test",
+				dependsOn: ["build"]
+			},
+			dev: {
+				command: "vp dev",
+				dependsOn: [{
+					task: "build",
+					from: ["dependencies", "devDependencies"]
+				}],
+				cache: false
+			}
+		} },
+		build: { target: [
+			"chrome107",
+			"edge107",
+			"firefox104",
+			"safari16"
+		] },
+		test: {
+			include: ["src/**/*.test.{ts,tsx}"],
+			passWithNoTests: true
+		}
+	}), config);
+}
+function composeConfig(base, config) {
+	const tasks = { ...base.run?.tasks };
+	for (const [name, override] of Object.entries(config.run?.tasks ?? {})) {
+		const original = tasks[name];
+		if (typeof override === "string" || Array.isArray(override)) tasks[name] = override;
+		else {
+			const inherited = typeof original === "object" && !Array.isArray(original) ? original : void 0;
+			const command = override.command ?? inherited?.command;
+			if (command === void 0) throw new Error(`Task "${name}" needs a command because it has no preset default.`);
+			tasks[name] = {
+				...inherited,
+				...override,
+				command
+			};
+		}
+	}
+	return {
+		...base,
+		...config,
+		resolve: {
+			...base.resolve,
+			...config.resolve
+		},
+		...base.pack || config.pack ? { pack: Array.isArray(config.pack) ? config.pack : {
+			...Array.isArray(base.pack) ? {} : base.pack,
+			...config.pack
+		} } : {},
+		...base.build || config.build ? { build: {
+			...base.build,
+			...config.build
+		} } : {},
+		test: {
+			...base.test,
+			...config.test
+		},
+		run: {
+			...base.run,
+			...config.run,
+			tasks
+		}
+	};
+}
+//#endregion
+export { defineAppConfig, defineLibraryConfig };
+
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { defineConfig } from \"vite-plus\";\nimport type { ViteUserConfig } from \"vite-plus\";\n\ntype RunConfig = NonNullable<ViteUserConfig[\"run\"]>;\ntype TaskDefinition = NonNullable<RunConfig[\"tasks\"]>[string];\ntype TaskOptions = Exclude<TaskDefinition, string | string[]>;\n\n/** Override individual task options without repeating their command or prerequisites. */\nexport type LibraryConfig = Omit<ViteUserConfig, \"run\"> & {\n    run?: Omit<RunConfig, \"tasks\"> & {\n        tasks?: Record<string, string | string[] | Partial<TaskOptions>>;\n    };\n};\n\n/**\n * Configure an ESM library. Package overrides replace arrays and merge the\n * pack, test, and individual task options with these defaults.\n */\nexport function defineLibraryConfig(config: LibraryConfig = {}): ViteUserConfig {\n    const base = defineConfig({\n        resolve: { tsconfigPaths: true },\n        run: {\n            tasks: {\n                check: {\n                    command: \"vp check\",\n                    // Track root files without making generated directory entries inputs.\n                    cache: {\n                        input: [{ auto: true }, \"!.\", \"*.{json,jsonc,ts,mts,js,mjs}\"],\n                    },\n                    dependsOn: [{ task: \"build\", from: [\"dependencies\", \"devDependencies\"] }],\n                },\n                build: {\n                    command: \"vp pack\",\n                    // Generated outputs and package directory listings must not invalidate their own build.\n                    cache: {\n                        input: [{ auto: true }, \"!.\", \"*.{json,jsonc,ts,mts,js,mjs}\", \"!lib/**\"],\n                    },\n                    dependsOn: [\"check\", { task: \"build\", from: [\"dependencies\", \"devDependencies\"] }],\n                },\n                test: { command: \"vp test\", dependsOn: [\"build\"] },\n            },\n        },\n        pack: {\n            entry: [\n                \"src/**/*.{ts,tsx}\",\n                \"!src/**/*.d.ts\",\n                \"!src/**/*.test.{ts,tsx}\",\n                \"!src/**/*.bench.{ts,tsx}\",\n            ],\n            outDir: \"lib\",\n            root: \"src\",\n            target: \"es2022\",\n            unbundle: true,\n            fixedExtension: false,\n            deps: { neverBundle: true },\n        },\n        test: { include: [\"src/**/*.test.{ts,tsx}\"], passWithNoTests: true },\n    });\n    return composeConfig(base, config);\n}\n\nexport type AppConfig = LibraryConfig;\n\n/** Configure app tasks while leaving framework plugins with the caller. */\nexport function defineAppConfig(config: AppConfig = {}): ViteUserConfig {\n    return composeConfig(\n        defineConfig({\n            resolve: { tsconfigPaths: true },\n            run: {\n                tasks: {\n                    check: {\n                        command: \"vp check\",\n                        dependsOn: [{ task: \"build\", from: [\"dependencies\", \"devDependencies\"] }],\n                    },\n                    build: {\n                        command: \"vp build\",\n                        // Shell nesting changed cache fingerprints without changing app outputs.\n                        cache: { untrackedEnv: [\"SHLVL\"] },\n                        dependsOn: [\"check\", { task: \"build\", from: [\"dependencies\", \"devDependencies\"] }],\n                    },\n                    test: { command: \"vp test\", dependsOn: [\"build\"] },\n                    dev: {\n                        command: \"vp dev\",\n                        dependsOn: [{ task: \"build\", from: [\"dependencies\", \"devDependencies\"] }],\n                        cache: false,\n                    },\n                },\n            },\n            // Preserve Vite 7 browser support after the Vite 8 default target change.\n            build: { target: [\"chrome107\", \"edge107\", \"firefox104\", \"safari16\"] },\n            test: { include: [\"src/**/*.test.{ts,tsx}\"], passWithNoTests: true },\n        }),\n        config\n    );\n}\n\nfunction composeConfig(base: ViteUserConfig, config: LibraryConfig): ViteUserConfig {\n    const tasks = { ...base.run?.tasks };\n    for (const [name, override] of Object.entries(config.run?.tasks ?? {})) {\n        const original = tasks[name];\n        if (typeof override === \"string\" || Array.isArray(override)) {\n            tasks[name] = override;\n        } else {\n            const inherited = typeof original === \"object\" && !Array.isArray(original) ? original : undefined;\n            const command = override.command ?? inherited?.command;\n            if (command === undefined) {\n                throw new Error(`Task \"${name}\" needs a command because it has no preset default.`);\n            }\n            tasks[name] = { ...inherited, ...override, command };\n        }\n    }\n    return {\n        ...base,\n        ...config,\n        resolve: { ...base.resolve, ...config.resolve },\n        ...(base.pack || config.pack\n            ? {\n                  pack: Array.isArray(config.pack)\n                      ? config.pack\n                      : { ...(Array.isArray(base.pack) ? {} : base.pack), ...config.pack },\n              }\n            : {}),\n        ...(base.build || config.build ? { build: { ...base.build, ...config.build } } : {}),\n        test: { ...base.test, ...config.test },\n        run: { ...base.run, ...config.run, tasks },\n    };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,27 @@
 {
   "name": "@party-stack/build-config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.2",
+  "files": [
+    "lib",
+    "tsconfig"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./tsconfig.json": "./tsconfig/library.json",
+    "./react/tsconfig.json": "./tsconfig/react.json",
+    "./app/tsconfig.json": "./tsconfig/app.json"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "typescript": "~7.0.2",
+    "vite-plus": "1.1.0"
+  },
+  "peerDependencies": {
+    "vite-plus": "^1.1.0"
+  },
+  "scripts": {}
 }

package/tsconfig/app.json

@@ -0,0 +1,14 @@
+{
+    "extends": "./react.json",
+    "compilerOptions": {
+        "rootDir": "${configDir}",
+        "noEmit": true,
+        "noUncheckedIndexedAccess": false,
+        "lib": ["DOM", "DOM.Iterable", "ESNext"],
+        "types": ["node", "vite/client"],
+        "paths": {
+            "@/*": ["${configDir}/src/*"]
+        }
+    },
+    "include": ["${configDir}/src/**/*.ts", "${configDir}/src/**/*.tsx", "${configDir}/vite.config.ts"]
+}

package/tsconfig/library.json

@@ -0,0 +1,22 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "compilerOptions": {
+        "types": ["node"],
+        "outDir": "${configDir}/lib",
+        "rootDir": "${configDir}/src",
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true,
+        "isolatedModules": true,
+        "noUncheckedIndexedAccess": true,
+        "resolveJsonModule": true,
+        "strict": true,
+        "allowUnreachableCode": false,
+        "lib": ["ES2022", "DOM", "DOM.Iterable"],
+        "target": "ES2022",
+        "module": "NodeNext",
+        "moduleResolution": "NodeNext",
+        "skipLibCheck": true
+    },
+    "include": ["${configDir}/src/**/*.ts"]
+}

package/tsconfig/react.json

@@ -0,0 +1,9 @@
+{
+    "extends": "./library.json",
+    "compilerOptions": {
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+        "jsx": "react-jsx"
+    },
+    "include": ["${configDir}/src/**/*.ts", "${configDir}/src/**/*.tsx"]
+}