quario 0.1.0 → 0.2.0

package/lib/scope.js

@@ -119,12 +119,6 @@ let RUNNERS = {
     };
   },
 };
-/** @type {(fold: Fold) => Eval} */
-let startRunner = ({ fn, per }) => {
-  let step = RUNNERS[fn]();
-  return (scope) => step(per ? per(scope) : 1);
-};
-
 // The runner set as a value, and the two things a band does with it. `extend`
 // is the whole of persist-vs-reset: a group's own runners are fresh per
 // instance, the outer ones fold on unchanged.
@@ -136,10 +130,10 @@ let runnerSet = (runners) => {
       // Declaring no runners is not a change of set, so a band whose `run`
       // block is absent renders under this very value rather than a copy.
       if (!folds.length) return value;
-      let started = folds.map(([name, fold]) => /** @type {[string, Eval]} */ ([
-        name,
-        startRunner(fold),
-      ]));
+      let started = folds.map(([name, { fn, per }]) => {
+        let step = RUNNERS[fn]();
+        return /** @type {[string, Eval]} */ ([name, (scope) => step(per ? per(scope) : 1)]);
+      });
       return runnerSet([...runners, ...started]);
     },
     // The per-row detail scope: `@` bound to the row, its running values folded

package/lib/stream.js

@@ -8,10 +8,10 @@
  * loop back is a stream rule — the two are independent, and a target breathes
  * while stamping finished pages, which is no walk at all (CONTEXT.md).
  */
-// The token-join sjabloon renders with: literals verbatim, values
-// `String(value ?? '')`. Re-exported so event consumers derive display text
-// from a cell's tokens without hand-rolling the join.
-export { text } from "sjabloon";
+// The token-join sjabloon renders with — literals verbatim, values through
+// the scalar `display()` rule — re-exported together so event consumers
+// derive display text from a cell's tokens without hand-rolling the join.
+export { display, text } from "sjabloon";
 
 /** @type {(value: any) => boolean} */
 let finiteNum = (value) => typeof value === "number" && Number.isFinite(value);
@@ -42,7 +42,7 @@ export function typed(tokens) {
 
 // The report's own bands, by the role their items wear (CONTEXT.md, "Band").
 // The page ones are in it although no walk emits them: the question is whose
-// band a role names, not what a walk hands over (ADR 0021).
+// band a role names, not what a walk hands over (ADR 0028).
 let REPORT_BANDS = new Set([
   "report-header",
   "report-footer",
@@ -55,7 +55,7 @@ let REPORT_BANDS = new Set([
  * Whether a band item's `role` names one of the report's own bands rather than
  * a group instance's. This says whose band it is, never how to lay one out —
  * what a consumer does with the answer is its own. See SCHEMA.md ("Event
- * stream") for the contract and ADR 0021 for why the engine classifies rather
+ * stream") for the contract and ADR 0028 for why the engine classifies rather
  * than carrying a verdict on the events themselves.
  *
  * @param {string} role An item or image event's `role`.

package/lib/style.js

@@ -25,6 +25,12 @@ let ALIGNMENTS = ["left", "center", "right"];
 // beside the vocabulary it narrows, and `checkImageStyle` below is how the
 // traversal asks for it -- it keeps no second list of its own.
 let IMAGE_STYLES = ["align", "background"];
+// The declarations a report default accepts. A report default states what the
+// document is set in, so it carries only the two declarations that describe a
+// typeface -- and, unlike the rest of the vocabulary, only the two no band-role
+// default has to argue with. Anything else is a definition error rather than a
+// silent no-op, exactly as on an image (SCHEMA.md, "Report default").
+let REPORT_STYLES = ["family", "size"];
 /** @type {Record<string, StyleSpec>} */
 let STYLES = {
   family: spec(
@@ -36,6 +42,7 @@ let STYLES = {
   italic: FLAG,
   underline: FLAG,
   strikethrough: FLAG,
+  uppercase: FLAG,
   color: COLOR,
   background: COLOR,
   align: spec("expected left, center, or right", (value) => ALIGNMENTS.includes(value)),
@@ -55,12 +62,20 @@ export let checkStyle = (name, value) => {
   return rule.ok(value) ? null : rule.msg;
 };
 
-// The same check narrowed to what an image accepts, so a text declaration on
-// one is refused as pointedly as an unknown name. A node that takes part of
-// the vocabulary names this checker rather than passing a flag, which is what
-// keeps the subset and its wording here, together.
-/** @type {(name: string, value: any) => string | null} */
-export let checkImageStyle = (name, value) =>
-  Object.hasOwn(STYLES, name) && !IMAGE_STYLES.includes(name)
-    ? 'style "' + name + '" does not apply to an image'
+// The same check narrowed to a subset of the vocabulary, so a declaration a
+// node cannot wear is refused as pointedly as an unknown name rather than
+// silently doing nothing. A node that takes part of the vocabulary names the
+// checker this makes rather than passing a flag, which is what keeps each
+// subset and its wording together, here.
+//
+// `subject` completes "does not apply to ___", so it carries its own article.
+/** @type {(allowed: string[], subject: string) => (name: string, value: any) => string | null} */
+let narrowed = (allowed, subject) => (name, value) =>
+  Object.hasOwn(STYLES, name) && !allowed.includes(name)
+    ? 'style "' + name + '" does not apply to ' + subject
     : checkStyle(name, value);
+
+export let checkImageStyle = narrowed(IMAGE_STYLES, "an image");
+// "a report default" rather than the key's name: the key is `style` like every
+// other one, so the message has to say which `style` refused it.
+export let checkReportStyle = narrowed(REPORT_STYLES, "a report default");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quario",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A tiny, runtime-neutral report engine — in the makings, not yet released",
   "homepage": "https://getquario.com",
   "license": "SEE LICENSE IN LICENSE",
@@ -33,9 +33,9 @@
     "postpack": "node -e \"require('fs').rmSync('LICENSE',{force:true})\""
   },
   "dependencies": {
-    "padvinder": "^0.4.0",
-    "sjabloon": "^0.8.0",
-    "xprsn": "^0.9.0"
+    "padvinder": "^0.9.0",
+    "sjabloon": "^0.12.0",
+    "xprsn": "^0.11.1"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.3",
@@ -51,7 +51,7 @@
         "sjabloon",
         "padvinder"
       ],
-      "limit": "8 kB"
+      "limit": "9 kB"
     }
   ],
   "engines": {