@jarenjs/app 0.46.5 → 0.56.0

package/README.md

@@ -40,6 +40,47 @@ const app = createApp({
 }, { node: document.getElementById('app') });
 ```
 
+### The same app, by code
+
+`@jarenjs/linq/app` writes that document from typed builders — the
+initial state derived from the state schema's defaults, the view the
+JSLT pen's stylesheet, the actions captured over `$`/`$event`/`$payload`
+and their patch pointers derived from the state shape — and answers the
+state's JSON Schema beside it for `validateState`:
+
+```javascript
+import { action, bind, defineApp, replace, transition } from '@jarenjs/linq/app';
+import { rule } from '@jarenjs/linq/jslt';
+import * as s from '@jarenjs/linq/schema';
+
+const counter = defineApp({
+  state: s.object({ count: s.integer().default(0) }),
+  view: [rule('$', (v) => ['main', {},
+    ['h1', {}, 'Count: ', v.get('count')],
+    ['button', { on: { click: 'inc' } }, '+'],
+    ['button', { on: { click: bind('add', { payload: 10 }) } }, '+10'],
+  ])],
+  actions: {
+    inc: action((st) => transition({
+      patch: [replace((c) => c.get('count'), st.get('count').add(1))],
+    })),
+    add: action((st, x) => transition({
+      patch: [replace((c) => c.get('count'), st.get('count').add(x.payload))],
+    }), { payload: s.integer() }),
+  },
+});
+
+createApp(counter.document, { node: document.getElementById('app') });
+```
+
+It is the same application — the test suite boots both and compares
+them frame for frame. The mapping table, every refusal and the
+member-name escape this example's `get('count')` spells are
+[APP-PEN.md](../linq/docs/APP-PEN.md); this package depends on none of
+it.
+
+## The view
+
 The view is a JSLT stylesheet: rules match state by location (JSONPath) and shape (JSON Schema, via `compileTypeTest`), bodies are query documents producing vnodes, and `$path`/`$root` are in scope — a rule rendering `/todos/3` can embed its own pointer in an event binding, which is why there are no payload-creator functions anywhere.
 
 ## Actions and transitions

package/docs/APP-FORMAT.md

@@ -38,6 +38,19 @@ valid per §2–§5. A **runtime** (the reference implementation is
 specified there, and MUST serialize dispatches per the transaction
 model of §8.
 
+One producer ships in this repository: `@jarenjs/linq/app` writes these
+documents from typed JavaScript builders — the state's initial value
+derived from its schema's defaults, the view the JSLT pen's stylesheet,
+actions captured over §3.1's three names, and patch pointers derived
+from the state shape — with `defineApp()` refusing at build time what
+§4 and §6 would otherwise report per dispatch. Its mapping table is
+[APP-PEN.md](../../linq/docs/APP-PEN.md); §2's document below
+and the `contract/catalog.load/start` action of
+[CONTRACT-FORMAT §11.1](../../contract/docs/CONTRACT-FORMAT.md) are
+rebuilt through it byte for byte by that package's test suite. Nothing
+in this package depends on it: the format is the contract, and a
+document written by hand is the same document.
+
 ## 2. The app document
 
 ```json

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jarenjs/app",
   "private": false,
-  "version": "0.46.5",
+  "version": "0.56.0",
   "type": "module",
   "main": "./src/index.js",
   "types": "./dist/types/index.d.ts",
@@ -50,8 +50,8 @@
     "prepack": "npm run build:types"
   },
   "dependencies": {
-    "@jarenjs/core": "^0.46.5",
-    "@jarenjs/json": "^0.46.5",
-    "@jarenjs/view": "^0.46.5"
+    "@jarenjs/core": "^0.56.0",
+    "@jarenjs/json": "^0.56.0",
+    "@jarenjs/view": "^0.56.0"
   }
 }