@looop-games/cli 0.1.14 → 0.1.15

package/CHANGELOG.md

@@ -14,6 +14,15 @@ Versions: [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.1.15] - 2026-07-13
+
+### Changed
+- When a non-primitive file lands in your primitives folder, the error now sends
+  you to a `lib/` subfolder for the helper, instead of saying it can live
+  "anywhere in your game". It can't: a primitive runs in the browser too (to
+  predict with), so a helper outside the `/shared/` tree resolves on the room
+  server but 404s in the browser. `lib/` is reachable from both sides.
+
 ## [0.1.14] - 2026-07-13
 
 > How to write a room primitive — the folder, the filename-is-type rule, and

package/lib/primitives.mjs

@@ -106,8 +106,12 @@ export function scanPrimitives(projectDir) {
         throw new Error(
           `${PRIMITIVES_DIR}/${name} has no default export, so it cannot be a primitive.\n` +
             'A primitive is `export default class { ... }`, and its filename is its type name.\n' +
-            `If ${name} is a HELPER your primitive imports, move it out of this folder — anywhere else in\n` +
-            `your game works, or a subfolder here (e.g. ${PRIMITIVES_DIR}/lib/${name}), which is not scanned.`,
+            `If ${name} is a HELPER your primitive imports, put it in a lib/ subfolder here —\n` +
+            `  ${PRIMITIVES_DIR}/lib/${name}\n` +
+            `and import it as './lib/${name}'. The scanner skips lib/, and a primitive runs on BOTH\n` +
+            'sides — bundled into the room AND served to the browser to predict with — so its helper\n' +
+            'has to sit under this /shared/ tree to be reachable from both. Anywhere else in your game\n' +
+            'resolves for the room but 404s in the browser.',
         );
       }
       found.push({ type: name.slice(0, -3), module: `${PRIMITIVES_DIR}/${name}` });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@looop-games/cli",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Looop game development CLI — dev server, login, and publishing for standalone Looop games.",
   "type": "module",
   "license": "Apache-2.0",