@party-stack/build-config 0.1.3 → 0.2.0

package/README.md

@@ -39,3 +39,47 @@ 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`.
+
+## Effect libraries
+
+Effect packages opt in to separate presets; the ordinary library preset is unchanged:
+
+```ts
+import { defineEffectLibraryConfig } from "@party-stack/build-config/effect";
+
+export default defineEffectLibraryConfig();
+```
+
+```json
+{
+    "extends": "@party-stack/build-config/effect/tsconfig.json"
+}
+```
+
+This adds Effect's recommended type-aware lint rules and language-service plugin.
+The root prepare hook patches workspace TypeScript 7 and Vite+'s bundled Oxlint via
+`effect-tsgo patch --oxlint`. The lockfile pins the integration version. Ordinary
+libraries do not opt in to the Effect rules or TypeScript plugin.
+
+VS Code uses the workspace TypeScript SDK, and the recommended Effect extension
+provides debugger utilities. Its extension does not itself install the language
+service; that comes from the repository's `@effect/tsgo` dependency and patch step.
+Diagnostics are disabled in the editor plugin to avoid duplicate reports from
+Vite+/Oxc; editor hovers/refactors remain available. Reload the editor's TypeScript
+server after the first installation. See [Effect's development guide](https://effect.website/docs/v4/getting-started/devtools).
+
+### Effect tests and repository guidance
+
+Official skills are installed under `.agents/skills`. Read the installed root
+`node_modules/effect/AGENTS.md` completely before writing Effect code, following
+its version-matched links for errors, services, schemas, resources, and tests.
+Reusable Effect functions use `Effect.fnUntraced` unless a named tracing boundary
+is useful. Infrastructure errors use `Schema.TaggedError`; application records
+are not required to use Schema.
+
+The Effect preset maps `vitest` to `vite-plus/test` and inlines `@effect/vitest`,
+so Effect's test helpers use Vite+'s runner instead of registering with a second
+Vitest instance. Install `@effect/vitest` in packages that use it. `it.effect`
+provides Effect test services; use `it.live` for integration tests that need real
+time or native I/O. The ordinary library preset does not add these defaults.
+Caller test aliases and inlined dependencies are merged with the Effect defaults.

package/lib/effect.d.ts

@@ -0,0 +1,7 @@
+import { LibraryConfig } from "./index.js";
+import { ViteUserConfig } from "vite-plus";
+//#region src/effect.d.ts
+/** Opt in to Effect's type-aware diagnostics without changing ordinary libraries. */
+export declare function defineEffectLibraryConfig(config?: LibraryConfig): ViteUserConfig;
+//#endregion
+//# sourceMappingURL=effect.d.ts.map

package/lib/effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.d.ts","names":[],"sources":["../src/effect.ts"],"mappings":";;;;wBAKgB,0BAA0B,SAAQ,gBAAqB"}

package/lib/effect.js

@@ -0,0 +1,34 @@
+import { defineLibraryConfig } from "./index.js";
+import { recommended } from "@effect/tsgo/oxlint-presets";
+import { mergeConfig } from "vite-plus";
+//#region src/effect.ts
+/** Opt in to Effect's type-aware diagnostics without changing ordinary libraries. */
+function defineEffectLibraryConfig(config = {}) {
+	return defineLibraryConfig({
+		...config,
+		test: mergeConfig({
+			alias: [{
+				find: /^vitest$/,
+				replacement: "vite-plus/test"
+			}],
+			server: { deps: { inline: ["@effect/vitest"] } }
+		}, config.test ?? {}),
+		lint: {
+			...config.lint,
+			extends: [recommended, ...config.lint?.extends ?? []],
+			rules: {
+				"vitest/no-standalone-expect": ["warn", { additionalTestBlockFunctions: [
+					"it.effect",
+					"it.effect.prop",
+					"it.live",
+					"it.live.prop"
+				] }],
+				...config.lint?.rules
+			}
+		}
+	});
+}
+//#endregion
+export { defineEffectLibraryConfig };
+
+//# sourceMappingURL=effect.js.map

package/lib/effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.js","names":[],"sources":["../src/effect.ts"],"sourcesContent":["import { recommended } from \"@effect/tsgo/oxlint-presets\";\nimport { mergeConfig, type ViteUserConfig } from \"vite-plus\";\nimport { defineLibraryConfig, type LibraryConfig } from \"./index.js\";\n\n/** Opt in to Effect's type-aware diagnostics without changing ordinary libraries. */\nexport function defineEffectLibraryConfig(config: LibraryConfig = {}): ViteUserConfig {\n    return defineLibraryConfig({\n        ...config,\n        test: mergeConfig(\n            {\n                alias: [{ find: /^vitest$/, replacement: \"vite-plus/test\" }],\n                server: { deps: { inline: [\"@effect/vitest\"] } },\n            },\n            config.test ?? {}\n        ),\n        lint: {\n            ...config.lint,\n            extends: [recommended, ...(config.lint?.extends ?? [])],\n            rules: {\n                \"vitest/no-standalone-expect\": [\n                    \"warn\",\n                    {\n                        additionalTestBlockFunctions: [\n                            \"it.effect\",\n                            \"it.effect.prop\",\n                            \"it.live\",\n                            \"it.live.prop\",\n                        ],\n                    },\n                ],\n                ...config.lint?.rules,\n            },\n        },\n    });\n}\n"],"mappings":";;;;;AAKA,SAAgB,0BAA0B,SAAwB,CAAC,GAAmB;CAClF,OAAO,oBAAoB;EACvB,GAAG;EACH,MAAM,YACF;GACI,OAAO,CAAC;IAAE,MAAM;IAAY,aAAa;GAAiB,CAAC;GAC3D,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,gBAAgB,EAAE,EAAE;EACnD,GACA,OAAO,QAAQ,CAAC,CACpB;EACA,MAAM;GACF,GAAG,OAAO;GACV,SAAS,CAAC,aAAa,GAAI,OAAO,MAAM,WAAW,CAAC,CAAE;GACtD,OAAO;IACH,+BAA+B,CAC3B,QACA,EACI,8BAA8B;KAC1B;KACA;KACA;KACA;IACJ,EACJ,CACJ;IACA,GAAG,OAAO,MAAM;GACpB;EACJ;CACJ,CAAC;AACL"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@party-stack/build-config",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "files": [
     "lib",
     "tsconfig"
@@ -13,11 +13,20 @@
     },
     "./tsconfig.json": "./tsconfig/library.json",
     "./react/tsconfig.json": "./tsconfig/react.json",
-    "./app/tsconfig.json": "./tsconfig/app.json"
+    "./app/tsconfig.json": "./tsconfig/app.json",
+    "./effect": {
+      "types": "./lib/effect.d.ts",
+      "default": "./lib/effect.js"
+    },
+    "./effect/tsconfig.json": "./tsconfig/effect-library.json"
+  },
+  "dependencies": {
+    "@effect/tsgo": "^0.53.4"
   },
   "devDependencies": {
     "@types/node": "^24.10.1",
     "typescript": "~7.0.2",
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.2.0",
     "vite-plus": "1.2.0"
   },
   "peerDependencies": {

package/tsconfig/effect-library.json

@@ -0,0 +1,11 @@
+{
+    "extends": "./library.json",
+    "compilerOptions": {
+        "plugins": [
+            {
+                "name": "@effect/language-service",
+                "diagnostics": false
+            }
+        ]
+    }
+}