@jarenjs/studio 0.56.0 → 0.67.0

package/README.md

@@ -63,6 +63,22 @@ error with a JSON Pointer. There is deliberately no single composed
 mega-schema; that is what lets a project mix an app, a store and a data
 query at once. See [PROJECT-FORMAT.md](docs/PROJECT-FORMAT.md).
 
+## Exports
+
+Every subpath a consumer can import, derived from the manifest by
+`npm run docs:derive` (`npm run docs:check` fails when the two drift):
+
+<!--fact:exports.studio-->
+| Import | Kind | Declarations |
+|---|---|---|
+| `@jarenjs/studio` | JavaScript | declared |
+| `@jarenjs/studio/component` | JavaScript | declared |
+| `@jarenjs/studio/schemas/jaren-project.draft-07.schema.json` | schema | — |
+| `@jarenjs/studio/schemas/jaren-project.schema.json` | schema | — |
+| `@jarenjs/studio/styles/studio.css` | asset | — |
+| `@jarenjs/studio/package.json` | metadata | — |
+<!--/fact-->
+
 ## Install
 
 ```

package/dist/types/assemble.d.ts

@@ -13,7 +13,7 @@
  * `classifyChange` is the load-bearing UX datum: a `state`-only edit must
  * HOT-DISPATCH into a running app (no reboot, the user keeps scroll and
  * inputs), while a `view`/`actions` change must reboot. It compares a
- * STRUCTURAL key (an app doc minus its `state`) via the suite's own
+ * STRUCTURAL key (an app's `view`, `actions` and `subs`) via the suite's own
  * `semanticKey` — the collision-free identity, not the memo-grade
  * `contentKey` fingerprint: a classification decides whether a running
  * app reboots, so a fingerprint collision would read a changed document

package/docs/PROJECT-FORMAT.md

@@ -75,8 +75,12 @@ share link and the eject, so its shape is fixed at v0.1.
 ## `classifyChange` — reboot vs. hot-update
 
 `classifyChange(prev, next)` reports, **per artifact**, whether a change
-is `structural`, `state-only`, or `none`. It compares a structural key —
-an `app` document *minus its `state`* — via the suite's own `contentKey`.
+is `structural`, `state-only`, or `none`. A change of artifact kind is
+structural even when the JSON text stays the same. It compares an app's
+`view`, `actions` and `subs` (other artifacts' whole documents) via the
+suite's collision-free `semanticKey`; a remaining document change is
+`state-only`. Every filename, including `__proto__`, is an own member of
+the result map.
 An IDE reads it to decide: a `state-only` edit hot-dispatches into a
 running app (the user keeps scroll and inputs); a `structural` edit
 reboots. Keeping this datum in the tested engine, and the policy in the

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jarenjs/studio",
   "private": false,
-  "version": "0.56.0",
+  "version": "0.67.0",
   "type": "module",
   "main": "./src/index.js",
   "types": "./dist/types/index.d.ts",
@@ -59,12 +59,12 @@
     "prepack": "npm run build:types"
   },
   "dependencies": {
-    "@jarenjs/core": "^0.56.0",
-    "@jarenjs/validate": "^0.56.0",
-    "@jarenjs/json": "^0.56.0",
-    "@jarenjs/app": "^0.56.0",
-    "@jarenjs/flow": "^0.56.0",
-    "@jarenjs/db": "^0.56.0",
-    "@jarenjs/contract": "^0.56.0"
+    "@jarenjs/core": "^0.67.0",
+    "@jarenjs/validate": "^0.67.0",
+    "@jarenjs/json": "^0.67.0",
+    "@jarenjs/app": "^0.67.0",
+    "@jarenjs/flow": "^0.67.0",
+    "@jarenjs/db": "^0.67.0",
+    "@jarenjs/contract": "^0.67.0"
   }
 }

package/src/assemble.js

@@ -14,14 +14,14 @@
  * `classifyChange` is the load-bearing UX datum: a `state`-only edit must
  * HOT-DISPATCH into a running app (no reboot, the user keeps scroll and
  * inputs), while a `view`/`actions` change must reboot. It compares a
- * STRUCTURAL key (an app doc minus its `state`) via the suite's own
+ * STRUCTURAL key (an app's `view`, `actions` and `subs`) via the suite's own
  * `semanticKey` — the collision-free identity, not the memo-grade
  * `contentKey` fingerprint: a classification decides whether a running
  * app reboots, so a fingerprint collision would read a changed document
  * as unchanged. The artifacts are parsed JSON, so the identity is total.
  */
 
-import { semanticKey } from '@jarenjs/core/object';
+import { semanticKey, setObjectMember } from '@jarenjs/core/object';
 import { validateFile } from './validate.js';
 
 /** Kinds that are runnable artifacts on their own (vs. `state`/`data`
@@ -90,15 +90,15 @@ export function classifyChange(prevProject, nextProject) {
   for (const [name, a] of next) {
     const b = prev.get(name);
     let c;
-    if (b === undefined) c = 'structural';
+    if (b === undefined || b.kind !== a.kind) c = 'structural';
     else if (structuralKey(b) !== structuralKey(a)) c = 'structural';
     else if (semanticKey(b.doc) !== semanticKey(a.doc)) c = 'state-only';
     else c = 'none';
-    perArtifact[name] = c;
+    setObjectMember(perArtifact, name, c);
     bump(c);
   }
   for (const name of prev.keys()) {
-    if (!next.has(name)) { perArtifact[name] = 'structural'; bump('structural'); }
+    if (!next.has(name)) { setObjectMember(perArtifact, name, 'structural'); bump('structural'); }
   }
   return { overall, perArtifact };
 }

package/src/component/host.js

@@ -15,6 +15,7 @@
  * hidden write.
  */
 
+import { setObjectMember } from '@jarenjs/core/object';
 import { classifyChange } from '../assemble.js';
 
 /**
@@ -30,7 +31,7 @@ export function hostPolicy(prevProject, nextProject) {
   /** @type {Record<string, 'reboot' | 'hot' | 'skip'>} */
   const out = {};
   for (const [name, change] of Object.entries(perArtifact)) {
-    out[name] = change === 'structural' ? 'reboot' : change === 'state-only' ? 'hot' : 'skip';
+    setObjectMember(out, name, change === 'structural' ? 'reboot' : change === 'state-only' ? 'hot' : 'skip');
   }
   return out;
 }