@driftengine/physics 4.8.7 → 4.9.0

package/README.md

@@ -399,7 +399,7 @@ asserting that property since. What kept a pool out was never the engine.
 
 ```ts
 import { PhysicsWorld } from '@driftengine/physics';
-import { createIslandPool } from '@driftengine/physics/src/workers.ts';
+import { createIslandPool } from '@driftengine/physics/workers';
 
 const world = new PhysicsWorld({ workers: 4, pool: createIslandPool });
 world.parallelism; // { requested: 4, running: 4, reason: '' }
@@ -414,7 +414,7 @@ unreachable, so a barrel that merely re-exported the factory still wrote **12,25
 worker to disk in builds where nothing could fetch it. Reported by one consumer and reproduced on a
 second the same day.
 
-So the factory is at `@driftengine/physics/src/workers.ts`. A caller already had to name it, so the
+So the factory is at `@driftengine/physics/workers`. A caller already had to name it, so the
 cost is the specifier and nothing else, and importing `PhysicsWorld` now names no worker at all.
 
 **Read `parallelism` instead of assuming the option took.** Every path that does not start a pool

package/dist/workers.d.ts

@@ -23,11 +23,16 @@
  *
  * ```ts
  * import { PhysicsWorld } from '@driftengine/physics';
- * import { createIslandPool } from '@driftengine/physics/src/workers.ts';
+ * import { createIslandPool } from '@driftengine/physics/workers';
  *
  * const world = new PhysicsWorld({ workers: 4, pool: createIslandPool });
  * ```
  *
+ * **A declared subpath, so it resolves the way the barrel does**: to the build by default and to
+ * this file under `drift-source`. The path into `src/` documented until it was declared still
+ * resolves, through the manifest's `./*` passthrough, and hands every consumer TypeScript inside
+ * `node_modules`, which is the default the 2026-09-13 flip took away from the barrels.
+ *
  * `scripts/worker-entry.test.mjs` bundles the barrel and asserts it names no worker, because every
  * gate in this repository passed while the chunk was shipping.
  */

package/dist/workers.js

@@ -23,11 +23,16 @@
  *
  * ```ts
  * import { PhysicsWorld } from '@driftengine/physics';
- * import { createIslandPool } from '@driftengine/physics/src/workers.ts';
+ * import { createIslandPool } from '@driftengine/physics/workers';
  *
  * const world = new PhysicsWorld({ workers: 4, pool: createIslandPool });
  * ```
  *
+ * **A declared subpath, so it resolves the way the barrel does**: to the build by default and to
+ * this file under `drift-source`. The path into `src/` documented until it was declared still
+ * resolves, through the manifest's `./*` passthrough, and hands every consumer TypeScript inside
+ * `node_modules`, which is the default the 2026-09-13 flip took away from the barrels.
+ *
  * `scripts/worker-entry.test.mjs` bundles the barrel and asserts it names no worker, because every
  * gate in this repository passed while the chunk was shipping.
  */

package/dist/world.d.ts

@@ -87,7 +87,7 @@ export interface WorldOptions {
      *
      * ```ts
      * import { PhysicsWorld } from '@driftengine/physics';
-     * import { createIslandPool } from '@driftengine/physics/src/workers.ts';
+     * import { createIslandPool } from '@driftengine/physics/workers';
      *
      * const world = new PhysicsWorld({ workers: 4, pool: createIslandPool });
      * ```

package/dist/world.js

@@ -134,9 +134,9 @@ export class PhysicsWorld {
         if (granted > 0) {
             if (options.pool === undefined) {
                 this.parallelism.reason =
-                    'workers were asked for but no pool was given. Import createIslandPool from ' +
-                        '@driftengine/physics/src/workers.ts and pass it as the pool option; it is behind its ' +
-                        'own specifier so that importing PhysicsWorld does not put a worker in your bundle.';
+                    'workers were asked for but no pool was given. Import createIslandPool, exported by ' +
+                        "'@driftengine/physics/workers', and pass it as the pool option; it is behind its own " +
+                        'specifier so that importing PhysicsWorld does not put a worker in your bundle.';
             }
             else {
                 const pool = options.pool({ workers: granted, spawn: options.spawn });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@driftengine/physics",
-  "version": "4.8.7",
+  "version": "4.9.0",
   "description": "Collision shapes, spatial queries and swept kinematic collision",
   "license": "Apache-2.0",
   "type": "module",
@@ -12,6 +12,11 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./workers": {
+      "drift-source": "./src/workers.ts",
+      "types": "./dist/workers.d.ts",
+      "default": "./dist/workers.js"
+    },
     "./package.json": "./package.json",
     "./*": "./*"
   },

package/src/index.ts

@@ -59,7 +59,7 @@ export { solveIslandInto } from './islandSolve.ts';
  * decides the pool is unreachable — so re-exporting it from this barrel wrote a 12 KB gzipped
  * worker chunk into the bundle of every consumer that merely imported `PhysicsWorld`.
  *
- * It lives at `@driftengine/physics/src/workers.ts`, which that file explains. A caller already had
+ * It lives at `@driftengine/physics/workers`, which `workers.ts` explains. A caller already had
  * to name `createIslandPool` at the call site for 3.54.0's own reason, so this costs a specifier.
  *
  * The *types* stay reachable from here, because a type import emits nothing and a consumer typing a

package/src/workers.ts

@@ -23,11 +23,16 @@
  *
  * ```ts
  * import { PhysicsWorld } from '@driftengine/physics';
- * import { createIslandPool } from '@driftengine/physics/src/workers.ts';
+ * import { createIslandPool } from '@driftengine/physics/workers';
  *
  * const world = new PhysicsWorld({ workers: 4, pool: createIslandPool });
  * ```
  *
+ * **A declared subpath, so it resolves the way the barrel does**: to the build by default and to
+ * this file under `drift-source`. The path into `src/` documented until it was declared still
+ * resolves, through the manifest's `./*` passthrough, and hands every consumer TypeScript inside
+ * `node_modules`, which is the default the 2026-09-13 flip took away from the barrels.
+ *
  * `scripts/worker-entry.test.mjs` bundles the barrel and asserts it names no worker, because every
  * gate in this repository passed while the chunk was shipping.
  */

package/src/world.ts

@@ -126,7 +126,7 @@ export interface WorldOptions {
    *
    * ```ts
    * import { PhysicsWorld } from '@driftengine/physics';
-   * import { createIslandPool } from '@driftengine/physics/src/workers.ts';
+   * import { createIslandPool } from '@driftengine/physics/workers';
    *
    * const world = new PhysicsWorld({ workers: 4, pool: createIslandPool });
    * ```
@@ -284,9 +284,9 @@ export class PhysicsWorld implements IslandSolver {
     if (granted > 0) {
       if (options.pool === undefined) {
         this.parallelism.reason =
-          'workers were asked for but no pool was given. Import createIslandPool from ' +
-          '@driftengine/physics/src/workers.ts and pass it as the pool option; it is behind its ' +
-          'own specifier so that importing PhysicsWorld does not put a worker in your bundle.';
+          'workers were asked for but no pool was given. Import createIslandPool, exported by ' +
+          "'@driftengine/physics/workers', and pass it as the pool option; it is behind its own " +
+          'specifier so that importing PhysicsWorld does not put a worker in your bundle.';
       } else {
         const pool = options.pool({ workers: granted, spawn: options.spawn });
         if (pool.executor !== null) this.executor = pool.executor;