@shivaedev/build 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.1.1 - 2026-11-11
+
+### Changed
+
+- The README's examples name a module file after its export, as in `src/modules/notes/Notes.ts` and `#generated/modules/notes/Notes.ts`, and import operations from the module's `server/` folder, as applications write them.
+
+### Fixed
+
+- Generating no longer leaves an empty `.<file>.XXXXXX` folder beside every file it writes, under `src/generated` and in `node_modules/.cache/@shivaedev/build`. Each write still replaces the file in one rename, and its temporary folder is removed when the write ends, also when it fails or is interrupted. Folders left by earlier versions stay until you delete them.
+
 ## 0.1.0 - 2026-11-11
 
 ### Added

package/README.md

@@ -8,10 +8,10 @@ An operation written as `payload` and `*run` has its success and rejections only
 
 ```ts
 import { defineModule } from "@shivaedev/contract/defineModule.ts";
-import { notesWire } from "#generated/modules/notes/notes.ts";
-import { Create } from "#modules/notes/create.ts";
-import { List } from "#modules/notes/list.ts";
-import { NotesStore } from "#modules/notes/store.ts";
+import { notesWire } from "#generated/modules/notes/Notes.ts";
+import { Create } from "#modules/notes/server/Create.ts";
+import { List } from "#modules/notes/server/List.ts";
+import { NotesStore } from "#modules/notes/server/Store.ts";
 
 export const Notes = defineModule({ name: "notes", operations: [List, Create], requires: [NotesStore], wire: notesWire });
 ```
@@ -21,7 +21,7 @@ shivaedev-build generate
 ```
 
 ```text
-src/generated/modules/notes/notes.ts: written
+src/generated/modules/notes/Notes.ts: written
 ```
 
 ## Using it
@@ -68,7 +68,7 @@ The application's `package.json` runs the generator before anything that reads t
 }
 ```
 
-pnpm does not run `prepare` on a production install (`pnpm install --prod`), so a production install without development dependencies succeeds without the generator; the files must already be written, as `pnpm build` writes them through the Vite plugin. The folder's contents stay out of Git except a README that names the command, and once the application imports from the folder, Quality's `imports/resolvable` lists it as `generated`:
+pnpm does not run `prepare` on a production install (`pnpm install --prod`), so a production install without development dependencies succeeds without the generator; the files must already be written, as `pnpm build` writes them through the Vite plugin. The folder's contents stay out of Git except a README that names the command, and `quality lint` runs the `generate` script before it reads the sources, so no configuration names the folder:
 
 ```gitignore
 src/generated/*
@@ -123,19 +123,19 @@ With a generated client the browser never needs a module or its operations, so t
 The build fails with the import chain from the client entry to that module:
 
 ```text
-Server code reached the browser bundle: src/modules/notes/notes.ts is a module file: it calls defineModule. The import chain from the client entry:
+Server code reached the browser bundle: src/modules/notes/Notes.ts is a module file: it calls defineModule. The import chain from the client entry:
   index.html
   → src/client.ts
   → src/screens/notes.ts
-  → src/modules/notes/notes.ts
+  → src/modules/notes/Notes.ts
 The browser reaches a defined module through its generated client in src/generated and imports no server code.
 ```
 
-The browser imports `Notes` from `#generated/modules/notes/notes.ts` instead.
+The browser imports `Notes` from `#generated/modules/notes/Notes.ts` instead.
 
 ### The generated file
 
-For the module above, the file starts with a line saying it is generated from `src/modules/notes/notes.ts`, must not be edited and is not committed. It exports the module's wire, named after the module's `name`, the browser's contract under the module's own export name, built by `clientContract`, and a closing `ClientMatchesModule` assertion:
+For the module above, the file starts with a line saying it is generated from `src/modules/notes/Notes.ts`, must not be edited and is not committed. It exports the module's wire, named after the module's `name`, the browser's contract under the module's own export name, built by `clientContract`, and a closing `ClientMatchesModule` assertion:
 
 ```ts
 export const notesWire = {

package/dist/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE1D,eAAO,MAAM,aAAa,6HAMxB,CAAC;AAGH,eAAO,MAAM,eAAe,sIAO1B,CAAC"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE1D,eAAO,MAAM,aAAa,6HAMxB,CAAC;AAIH,eAAO,MAAM,eAAe,sIAW1B,CAAC"}

package/dist/files.js

@@ -3,13 +3,16 @@ export const readIfPresent = Effect.fn("Build.readIfPresent")(function* (file) {
     const fs = yield* FileSystem.FileSystem;
     return yield* fs.readFileString(file).pipe(Effect.map(Option.some), Effect.catchReason("PlatformError", "NotFound", () => Effect.succeed(Option.none())));
 });
-// A reader never sees half a file: the text goes to a fresh file beside the target, which then replaces it in one rename.
+// A reader never sees half a file: the text goes to a fresh file beside the target, which then replaces it in one rename. The
+// draft lives in a temporary folder of its own, removed when the write ends however it ends.
 export const writeAtomically = Effect.fn("Build.writeAtomically")(function* (file, text) {
     const fs = yield* FileSystem.FileSystem;
     const path = yield* Path.Path;
     yield* fs.makeDirectory(path.dirname(file), { recursive: true });
-    const draft = yield* fs.makeTempFile({ directory: path.dirname(file), prefix: `.${path.basename(file)}.` });
-    yield* fs.writeFileString(draft, text);
-    yield* fs.rename(draft, file);
+    yield* Effect.scoped(Effect.gen(function* () {
+        const draft = yield* fs.makeTempFileScoped({ directory: path.dirname(file), prefix: `.${path.basename(file)}.` });
+        yield* fs.writeFileString(draft, text);
+        yield* fs.rename(draft, file);
+    }));
 });
 //# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -1 +1 @@
-{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE1D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAY;IACpF,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CACzC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EACvB,MAAM,CAAC,WAAW,CAAC,eAAe,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAU,CAAC,CAAC,CAC5F,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,0HAA0H;AAC1H,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAY,EAAE,IAAY;IACtG,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,KAAK,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5G,KAAK,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC,CAAC,CAAC"}
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE1D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAY;IACpF,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CACzC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EACvB,MAAM,CAAC,WAAW,CAAC,eAAe,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAU,CAAC,CAAC,CAC5F,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,8HAA8H;AAC9H,6FAA6F;AAC7F,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAY,EAAE,IAAY;IACtG,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,KAAK,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CACnB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAClH,KAAK,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CACF,CAAC;AACH,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/build",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "An application's build setup: its Vite and Vitest configuration, and the generated wire and browser contract of each defined module",
   "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/build#readme",
   "bugs": {
@@ -45,7 +45,7 @@
   ],
   "dependencies": {
     "@shivaedev/heavy-lock": "0.11.2",
-    "@shivaedev/quality": "0.77.0",
+    "@shivaedev/quality": "0.78.0",
     "typescript": "npm:@typescript/typescript6@6.0.2"
   },
   "devDependencies": {
@@ -54,7 +54,7 @@
     "@shivaedev/changes": "0.12.0",
     "@shivaedev/contract": "0.44.0",
     "@shivaedev/errors": "0.12.0",
-    "@shivaedev/test-story": "0.47.0",
+    "@shivaedev/test-story": "0.47.1",
     "@types/node": "24.19.2",
     "@typescript/native": "npm:typescript@7.0.2",
     "effect": "4.1.2",

package/src/files.ts

@@ -8,12 +8,17 @@ export const readIfPresent = Effect.fn("Build.readIfPresent")(function* (file: s
 	);
 });
 
-// A reader never sees half a file: the text goes to a fresh file beside the target, which then replaces it in one rename.
+// A reader never sees half a file: the text goes to a fresh file beside the target, which then replaces it in one rename. The
+// draft lives in a temporary folder of its own, removed when the write ends however it ends.
 export const writeAtomically = Effect.fn("Build.writeAtomically")(function* (file: string, text: string) {
 	const fs = yield* FileSystem.FileSystem;
 	const path = yield* Path.Path;
 	yield* fs.makeDirectory(path.dirname(file), { recursive: true });
-	const draft = yield* fs.makeTempFile({ directory: path.dirname(file), prefix: `.${path.basename(file)}.` });
-	yield* fs.writeFileString(draft, text);
-	yield* fs.rename(draft, file);
+	yield* Effect.scoped(
+		Effect.gen(function* () {
+			const draft = yield* fs.makeTempFileScoped({ directory: path.dirname(file), prefix: `.${path.basename(file)}.` });
+			yield* fs.writeFileString(draft, text);
+			yield* fs.rename(draft, file);
+		}),
+	);
 });