@decohere/forge 0.0.1-dev.125 → 0.0.1-dev.126

package/README.md

@@ -8,9 +8,9 @@ Build system (SWC). `forge build --configuration debug` rewrites workspace impor
 
 ## Debug path aliases (not `node_modules` links)
 
-Forge debug (`aliasPaths: true`) asks the workspace package for a map of `package.json` `name` → source `main` (`Workspace.getPackageAliases`) and feeds it to SWC as `jsc.paths`. Flux uses the same map in its resolve hook only, and compiles without `jsc.paths` or `resolveFully`, so imports are resolved once (#513).
+Forge debug (`aliasPaths: true`) asks the workspace package for a map of `package.json` `name` → source `main` (`Workspace.getPackageAliases`) and feeds it to SWC as `jsc.paths`. Flux uses the same map in its resolve hook only, and compiles without `jsc.paths` or `resolveFully`, so imports are resolved once.
 
-`tsc` can't read the workspace alias map, and without `node_modules` links it finds workspace packages only through tsconfig `paths`. `forge paths` writes the map to `tsconfig.paths.json` for the root tsconfig to extend, and `forge paths --check` fails when the file is out of date (#518).
+`tsc` can't read the workspace alias map, and without `node_modules` links it finds workspace packages only through tsconfig `paths`. `forge paths` writes the map to `tsconfig.paths.json` for the root tsconfig to extend, and `forge paths --check` fails when the file is out of date.
 
 That is a **debug** rule. Release does not rewrite aliases: production must resolve like any other Node app (installed packages, `exports` / `main` pointing at emitted JS).
 
@@ -98,7 +98,7 @@ projects/shop.api/.package/
 ```
 
 - **Which libraries.** Forge walks the compiled import graph from the deployable's `main`, following relative imports and bare imports that the workspace package resolves to a workspace project (including subpath `exports` such as `@app/kernel/testing`, and transitively through copied libraries). Only those libraries are copied. A library nothing reaches, and its dependencies, stay out.
-- **Which third-party packages.** What is **declared** ships: the union of `dependencies` (never `devDependencies`) of the deployable, every copied library and the workspace root `package.json`. They do not have to be imported, so a module loaded by name at run time (a pino transport `target: "pino-roll"`) ships as long as it is declared. Removing dependencies nothing uses is the author's job; a warning-only unused-dependency analysis is planned in [#635](https://github.com/typesmiths/decohere/issues/635).
+- **Which third-party packages.** What is **declared** ships: the union of `dependencies` (never `devDependencies`) of the deployable, every copied library and the workspace root `package.json`. They do not have to be imported, so a module loaded by name at run time (a pino transport `target: "pino-roll"`) ships as long as it is declared. Removing dependencies nothing uses is the author's job; a warning-only unused-dependency analysis is planned.
 - **Versions.** Each shipped package is pinned to the exact version installed in the workspace (so the image runs what the tests ran). A declared package that is not installed fails the command.
 - **Imports that would crash.** If packaged code imports a third-party package that is only a `devDependency`, or declared nowhere, the command fails and names the package and who imports it.
 - **Install first, copy second.** `npm` removes folders it does not know, so the libraries are copied in after it runs. `npm` (not pnpm) is used because it writes real folders. The command fails if the output holds any symlink.
@@ -132,7 +132,7 @@ export default {
 };
 ```
 
-`forge package @app/shop.api` then copies `projects/shop.web/dist/` to `projects/shop.api/.package/ui/` (real files, never links). The API calls `.withStatic("/ui/", "ui")` and the Dockerfile stays `COPY .package/ ./`. `forge package` does **not** build the UI: if the folder is missing it fails and tells you to build the UI first. `to` must be a new folder inside `.package/` (not `es6`, `node_modules` or `config`). Running the UI's own toolchain from `forge build` is [#381](https://github.com/typesmiths/decohere/issues/381); see [ADR 0007](../../docs/adr/0007-serving-a-built-ui-from-http.md).
+`forge package @app/shop.api` then copies `projects/shop.web/dist/` to `projects/shop.api/.package/ui/` (real files, never links). The API calls `.withStatic("/ui/", "ui")` and the Dockerfile stays `COPY .package/ ./`. `forge package` does **not** build the UI: if the folder is missing it fails and tells you to build the UI first. `to` must be a new folder inside `.package/` (not `es6`, `node_modules` or `config`). Running the UI's own toolchain from `forge build` is not done yet; see [ADR 0007](../../docs/adr/0007-serving-a-built-ui-from-http.md).
 
 Design record: [ADR 0006](../../docs/adr/0006-forge-package-deployables.md).
 

package/commonjs/src/factories/swc-config.factory.js

@@ -73,7 +73,7 @@ class SwcConfigFactory {
             mergeArrays: false
         }, defaultOptions, options, userConfig ?? {});
     }
-    /** Stamps a per-file filename onto a pre-built base config; `.tsx` also turns on JSX (#518). */ createFileConfig(file, baseConfig) {
+    /** Stamps a per-file filename onto a pre-built base config; `.tsx` also turns on JSX. */ createFileConfig(file, baseConfig) {
         const tsx = file.fullPath.endsWith(".tsx");
         const jsc = tsx && baseConfig.jsc?.parser?.syntax === "typescript" ? {
             ...baseConfig.jsc,

package/commonjs/src/services/swc-transpiler.js

@@ -92,7 +92,7 @@ class SwcTranspiler {
 	 */ createBaseConfig(buildTarget, options = {}) {
         return this.#swcConfigFactory.createBaseConfig(buildTarget, this.withAliasContext(options));
     }
-    /** Sync variant of {@link transformCode}, for the load hook, which cannot await (#514). */ transformCodeSync(content, file, buildTarget, baseConfig) {
+    /** Sync variant of {@link transformCode}, for the load hook, which cannot await. */ transformCodeSync(content, file, buildTarget, baseConfig) {
         const swcOptions = this.#swcConfigFactory.createFileConfig(file, baseConfig);
         if (content === "") return SwcTranspiler.skippedEmpty(file, swcOptions);
         try {
@@ -114,8 +114,8 @@ class SwcTranspiler {
     /**
 	 * Compiles `content` as the source of `file`, without reading the file: for callers that
 	 * already hold the code, such as the Vitest plugin, which must compile what Vite passes it
-	 * rather than an earlier read of the disk (#517). Async SWC, on the thread pool, so many
-	 * calls in flight compile in parallel (#661). With a `project`, the response carries where
+	 * rather than an earlier read of the disk. Async SWC, on the thread pool, so many
+	 * calls in flight compile in parallel. With a `project`, the response carries where
 	 * the build writes the output.
 	 */ async transformCode(content, file, buildTarget, baseConfig, project) {
         const swcOptions = this.#swcConfigFactory.createFileConfig(file, baseConfig);

package/commonjs/src/services/transpile-cache.js

@@ -18,7 +18,7 @@ function _interop_require_default(obj) {
     };
 }
 /**
- * Where compiled code is cached on disk (#514), or null when caching is off:
+ * Where compiled code is cached on disk, or null when caching is off:
  *
  * - `DECOHERE_CACHE=0` turns it off.
  * - `DECOHERE_CACHE_DIR` puts it in that directory.

package/commonjs/src/vitest/forge-build.plugin.js

@@ -41,7 +41,7 @@ function forgeBuild(options) {
     const transpiler = new _swctranspiler.SwcTranspiler();
     /**
 	 * SWC options per project (tsconfig, `.swcrc`, path aliases), built once: rebuilding them for
-	 * every file was most of the plugin's per-file cost, as it was in flux (#513, #517).
+	 * every file was most of the plugin's per-file cost, as it was in flux.
 	 */ const baseConfigs = new Map();
     const transformCache = new Map();
     let workspace = null;
@@ -72,7 +72,7 @@ function forgeBuild(options) {
             logger.debug("Plugin loaded");
         },
         resolveId (source, importer) {
-            // `./a.js` is `a.ts` or `a.tsx`, `./a.mjs` is `a.mts`, `./a.cjs` is `a.cts` (#518).
+            // `./a.js` is `a.ts` or `a.tsx`, `./a.mjs` is `a.mts`, `./a.cjs` is `a.cts`.
             if (importer != null && /\.[mc]?jsx?$/.test(source) && source.startsWith(".")) {
                 const written = _nodepath.default.resolve(_nodepath.default.dirname(importer), source);
                 return _workspace.sourceExtensions.candidates(written).find((c)=>(0, _nodefs.existsSync)(c)) ?? null;
@@ -93,7 +93,7 @@ function forgeBuild(options) {
             await initWorkspace();
             const project = await workspace?.findProject(id, buildConfig);
             // The code Vite passes, not a read of the file: no content cache can serve an older
-            // version, and there is no pre-warm compiling files ahead from disk (#517).
+            // version, and there is no pre-warm compiling files ahead from disk.
             const response = await transpiler.transformCode(code, new _io.FileEx({
                 fullPath: id,
                 content: code

package/es6/src/factories/swc-config.factory.js

@@ -58,7 +58,7 @@ export class SwcConfigFactory {
             mergeArrays: false
         }, defaultOptions, options, userConfig ?? {});
     }
-    /** Stamps a per-file filename onto a pre-built base config; `.tsx` also turns on JSX (#518). */ createFileConfig(file, baseConfig) {
+    /** Stamps a per-file filename onto a pre-built base config; `.tsx` also turns on JSX. */ createFileConfig(file, baseConfig) {
         const tsx = file.fullPath.endsWith(".tsx");
         const jsc = tsx && baseConfig.jsc?.parser?.syntax === "typescript" ? {
             ...baseConfig.jsc,

package/es6/src/services/swc-transpiler.js

@@ -77,7 +77,7 @@ export class SwcTranspiler {
 	 */ createBaseConfig(buildTarget, options = {}) {
         return this.#swcConfigFactory.createBaseConfig(buildTarget, this.withAliasContext(options));
     }
-    /** Sync variant of {@link transformCode}, for the load hook, which cannot await (#514). */ transformCodeSync(content, file, buildTarget, baseConfig) {
+    /** Sync variant of {@link transformCode}, for the load hook, which cannot await. */ transformCodeSync(content, file, buildTarget, baseConfig) {
         const swcOptions = this.#swcConfigFactory.createFileConfig(file, baseConfig);
         if (content === "") return SwcTranspiler.skippedEmpty(file, swcOptions);
         try {
@@ -99,8 +99,8 @@ export class SwcTranspiler {
     /**
 	 * Compiles `content` as the source of `file`, without reading the file: for callers that
 	 * already hold the code, such as the Vitest plugin, which must compile what Vite passes it
-	 * rather than an earlier read of the disk (#517). Async SWC, on the thread pool, so many
-	 * calls in flight compile in parallel (#661). With a `project`, the response carries where
+	 * rather than an earlier read of the disk. Async SWC, on the thread pool, so many
+	 * calls in flight compile in parallel. With a `project`, the response carries where
 	 * the build writes the output.
 	 */ async transformCode(content, file, buildTarget, baseConfig, project) {
         const swcOptions = this.#swcConfigFactory.createFileConfig(file, baseConfig);

package/es6/src/services/transpile-cache.js

@@ -3,7 +3,7 @@ import os from "node:os";
 import path from "node:path";
 import { version as swcVersion } from "@swc/core";
 /**
- * Where compiled code is cached on disk (#514), or null when caching is off:
+ * Where compiled code is cached on disk, or null when caching is off:
  *
  * - `DECOHERE_CACHE=0` turns it off.
  * - `DECOHERE_CACHE_DIR` puts it in that directory.

package/es6/src/vitest/forge-build.plugin.js

@@ -26,7 +26,7 @@ export function forgeBuild(options) {
     const transpiler = new SwcTranspiler();
     /**
 	 * SWC options per project (tsconfig, `.swcrc`, path aliases), built once: rebuilding them for
-	 * every file was most of the plugin's per-file cost, as it was in flux (#513, #517).
+	 * every file was most of the plugin's per-file cost, as it was in flux.
 	 */ const baseConfigs = new Map();
     const transformCache = new Map();
     let workspace = null;
@@ -57,7 +57,7 @@ export function forgeBuild(options) {
             logger.debug("Plugin loaded");
         },
         resolveId (source, importer) {
-            // `./a.js` is `a.ts` or `a.tsx`, `./a.mjs` is `a.mts`, `./a.cjs` is `a.cts` (#518).
+            // `./a.js` is `a.ts` or `a.tsx`, `./a.mjs` is `a.mts`, `./a.cjs` is `a.cts`.
             if (importer != null && /\.[mc]?jsx?$/.test(source) && source.startsWith(".")) {
                 const written = path.resolve(path.dirname(importer), source);
                 return sourceExtensions.candidates(written).find((c)=>existsSync(c)) ?? null;
@@ -78,7 +78,7 @@ export function forgeBuild(options) {
             await initWorkspace();
             const project = await workspace?.findProject(id, buildConfig);
             // The code Vite passes, not a read of the file: no content cache can serve an older
-            // version, and there is no pre-warm compiling files ahead from disk (#517).
+            // version, and there is no pre-warm compiling files ahead from disk.
             const response = await transpiler.transformCode(code, new FileEx({
                 fullPath: id,
                 content: code

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decohere/forge",
-  "version": "0.0.1-dev.125",
+  "version": "0.0.1-dev.126",
   "description": "TypeScript monorepo build system — zero config, fast compilation, streamlined developer workflow",
   "keywords": [
     "typescript",
@@ -38,11 +38,11 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
-    "@decohere/core": "0.0.1-dev.125",
-    "@decohere/crucible": "0.0.1-dev.125",
-    "@decohere/devkit": "0.0.1-dev.125",
-    "@decohere/scribe": "0.0.1-dev.125",
-    "@decohere/workspace": "0.0.1-dev.125",
+    "@decohere/core": "0.0.1-dev.126",
+    "@decohere/crucible": "0.0.1-dev.126",
+    "@decohere/devkit": "0.0.1-dev.126",
+    "@decohere/scribe": "0.0.1-dev.126",
+    "@decohere/workspace": "0.0.1-dev.126",
     "@swc/core": "^1.11.11",
     "async": "^3.2.6",
     "parse-imports": "^2.2.1",

package/types/src/actions/paths.action.d.ts

@@ -14,7 +14,7 @@ export type PathsResponse = {
 };
 /**
  * Writes `tsconfig.paths.json`: tsconfig `paths` for every workspace package and the subpaths it
- * exports, from the workspace aliases (#518). Without `node_modules` links, `tsc` finds workspace
+ * exports, from the workspace aliases. Without `node_modules` links, `tsc` finds workspace
  * packages only through `paths`; generating them keeps them in step with what Flux, the Vitest
  * plugin and builds resolve. The root tsconfig extends the file.
  */

package/types/src/factories/swc-config.factory.d.ts

@@ -8,7 +8,7 @@ export declare class SwcConfigFactory {
      * Call once per (project, target) and then use createFileConfig() per file.
      */
     createBaseConfig(buildTarget: TranspileTarget, configOptions: SwcConfigOptions): Options;
-    /** Stamps a per-file filename onto a pre-built base config; `.tsx` also turns on JSX (#518). */
+    /** Stamps a per-file filename onto a pre-built base config; `.tsx` also turns on JSX. */
     createFileConfig(file: FileEx, baseConfig: Options): Options;
     private static nonemptyPaths;
     /**

package/types/src/services/swc-transpiler.d.ts

@@ -28,13 +28,13 @@ export declare class SwcTranspiler implements Transformer {
      * once and passes them to {@link transformCode}.
      */
     createBaseConfig(buildTarget: TranspileTarget, options?: TranspileOptions): Options;
-    /** Sync variant of {@link transformCode}, for the load hook, which cannot await (#514). */
+    /** Sync variant of {@link transformCode}, for the load hook, which cannot await. */
     transformCodeSync(content: string, file: FileEx, buildTarget: TranspileTarget, baseConfig: Options): TransformResponse;
     /**
      * Compiles `content` as the source of `file`, without reading the file: for callers that
      * already hold the code, such as the Vitest plugin, which must compile what Vite passes it
-     * rather than an earlier read of the disk (#517). Async SWC, on the thread pool, so many
-     * calls in flight compile in parallel (#661). With a `project`, the response carries where
+     * rather than an earlier read of the disk. Async SWC, on the thread pool, so many
+     * calls in flight compile in parallel. With a `project`, the response carries where
      * the build writes the output.
      */
     transformCode(content: string, file: FileEx, buildTarget: TranspileTarget, baseConfig: Options, project?: Project): Promise<TransformResponse>;

package/types/src/services/transpile-cache.d.ts

@@ -1,5 +1,5 @@
 /**
- * Where compiled code is cached on disk (#514), or null when caching is off:
+ * Where compiled code is cached on disk, or null when caching is off:
  *
  * - `DECOHERE_CACHE=0` turns it off.
  * - `DECOHERE_CACHE_DIR` puts it in that directory.