@rse/specbook 1.2.3 → 1.2.5

package/dst/specbook-link.js

@@ -55,7 +55,7 @@ export const buildLinkIndex = (specification) => {
     const walk = (object, parent) => {
         const node = { object, parent, pos: index.length, name: plainText(object.name) };
         index.push(node);
-        for (const child of object.childs)
+        for (const child of object.children)
             walk(child, node);
     };
     for (const artifact of specification.artifacts)
@@ -173,7 +173,7 @@ export const resolveUnique = (index, reference, from) => {
 };
 /*  derive the fully-qualified anchor path of every object: the
     "<kind>-<id>" segments (whitespace in kinds dashed) of the ancestor
-    chain joined with "." (the index lists parents before childs)  */
+    chain joined with "." (the index lists parents before children)  */
 export const anchorPaths = (index) => {
     const paths = new Map();
     for (const node of index) {

package/dst/specbook-parse-semantic.js

@@ -129,11 +129,11 @@ const parenProp = (object, props) => {
     values matching the regexp or enum expression of the flag), where
     a kind without any sibling fails a present flag, too, but only for
     an optional kind, as the missing-kind check reports a required one  */
-const checkSiblingFlags = (ctx, object, childs, meta) => {
+const checkSiblingFlags = (ctx, object, children, meta) => {
     const marker = (flag) => flag === undefined || flag === false ? undefined :
         { filter: typeof flag === "string" ? compileValueExpr(flag) : undefined };
-    for (const child of childs) {
-        const siblings = object.childs.filter((c) => c.kind === child.kind);
+    for (const child of children) {
+        const siblings = object.children.filter((c) => c.kind === child.kind);
         for (const prop of child.props ?? []) {
             const unique = marker(prop.unique);
             const present = marker(prop.present);
@@ -165,7 +165,7 @@ const checkSiblingFlags = (ctx, object, childs, meta) => {
         }
     }
 };
-/*  validate a single object (and recursively its childs) against its schema  */
+/*  validate a single object (and recursively its children) against its schema  */
 const validateObject = (ctx, object, schema, level) => {
     const meta = ctx.metaOf(object);
     const props = schema.props ?? [];
@@ -199,10 +199,10 @@ const validateObject = (ctx, object, schema, level) => {
         if (!props.some((p) => p.name === property.key))
             ctx.diagnose(meta.file, ctx.propMeta.get(property)?.line ?? meta.line, `unknown property "${property.key}" on ${object.kind} "${object.name}"`);
     /*  check the configured child objects  */
-    const childs = schema.childs ?? [];
-    for (const child of object.childs) {
+    const children = schema.children ?? [];
+    for (const child of object.children) {
         const childMeta = ctx.metaOf(child);
-        const childSchema = childs.find((c) => c.kind === child.kind);
+        const childSchema = children.find((c) => c.kind === child.kind);
         if (childSchema === undefined) {
             ctx.diagnose(childMeta.file, childMeta.line, `unknown object kind "${child.kind}" below ${object.kind} "${object.name}"`);
             continue;
@@ -210,20 +210,20 @@ const validateObject = (ctx, object, schema, level) => {
         validateObject(ctx, child, childSchema, level + 1);
     }
     /*  check the sibling-scoped property flags of the child kinds  */
-    checkSiblingFlags(ctx, object, childs, meta);
+    checkSiblingFlags(ctx, object, children, meta);
     /*  report the configured child object kinds which are missing  */
-    for (const child of childs)
+    for (const child of children)
         if (child.optional !== true
-            && !object.childs.some((c) => c.kind === child.kind))
+            && !object.children.some((c) => c.kind === child.kind))
             ctx.diagnose(meta.file, meta.line, `required object kind "${child.kind}" missing below ${object.kind} "${object.name}"`);
-    /*  order the childs and properties exactly along the schema
+    /*  order the children and properties exactly along the schema
         definition (the sort is stable, so objects of the same kind
         and unknown items keep their document order)  */
     const kindPos = (kind) => {
-        const i = childs.findIndex((c) => c.kind === kind);
-        return i >= 0 ? i : childs.length;
+        const i = children.findIndex((c) => c.kind === kind);
+        return i >= 0 ? i : children.length;
     };
-    object.childs.sort((a, b) => kindPos(a.kind) - kindPos(b.kind));
+    object.children.sort((a, b) => kindPos(a.kind) - kindPos(b.kind));
     const propPos = (key) => {
         const i = props.findIndex((p) => p.name === key);
         return i >= 0 ? i : props.length;
@@ -242,8 +242,8 @@ export const collectSchemas = (specification, config) => {
     const schemas = new Map();
     const walk = (object, schema) => {
         schemas.set(object, schema);
-        for (const child of object.childs) {
-            const childSchema = (schema.childs ?? []).find((c) => c.kind === child.kind);
+        for (const child of object.children) {
+            const childSchema = (schema.children ?? []).find((c) => c.kind === child.kind);
             if (childSchema !== undefined)
                 walk(child, childSchema);
         }
@@ -284,7 +284,7 @@ const checkIds = (ctx, objects) => {
             const meta = ctx.metaOf(object);
             ctx.diagnose(meta.file, meta.line, `id "${object.id}" of ${object.kind} "${object.name}" collides with preceding ${object.kind} "${first.name}"`);
         }
-        checkIds(ctx, object.childs);
+        checkIds(ctx, object.children);
     }
 };
 /*  the objects a property of an object references (resolved and
@@ -317,7 +317,7 @@ const checkAutomata = (ctx, schemas) => {
         const automaton = schema.automaton;
         if (automaton === undefined)
             continue;
-        const nodes = object.childs.filter((child) => child.kind === automaton.nodes);
+        const nodes = object.children.filter((child) => child.kind === automaton.nodes);
         const nodeSet = new Set(nodes);
         const flagged = (node, name) => {
             const property = findProp(ctx, node, name);
@@ -329,7 +329,7 @@ const checkAutomata = (ctx, schemas) => {
             the node set is skipped, as the property checks report it)  */
         const succs = new Map(nodes.map((node) => [node, new Set()]));
         const preds = new Map(nodes.map((node) => [node, new Set()]));
-        for (const edge of object.childs.filter((child) => child.kind === automaton.edges)) {
+        for (const edge of object.children.filter((child) => child.kind === automaton.edges)) {
             const source = referencedObjects(ctx, edge, automaton.source)[0];
             const target = referencedObjects(ctx, edge, automaton.target)[0];
             if (source !== undefined && target !== undefined && nodeSet.has(source) && nodeSet.has(target)) {
@@ -446,7 +446,7 @@ const checkReferenced = (ctx, specification, schemas) => {
                 if (target !== undefined && !chain.includes(target))
                     referrers.set(target, (referrers.get(target) ?? new Set()).add(object));
             }
-        object.childs.forEach(walk);
+        object.children.forEach(walk);
     };
     for (const artifact of specification.artifacts)
         artifact.objects.forEach(walk);
@@ -494,7 +494,7 @@ export const validate = (ctx, specification, config) => {
             references all over the corpus  */
         if (object.paren !== undefined && object.anchor === undefined && !ctx.parenProps.has(object))
             assignId(ctx.linkIndex, object, object.paren);
-        object.childs.forEach(promote);
+        object.children.forEach(promote);
     };
     for (const artifact of specification.artifacts)
         artifact.objects.forEach(promote);
@@ -554,7 +554,7 @@ export const validateReferences = (ctx, specification) => {
             if (object.description.rationale !== undefined)
                 check(object, object.description.rationale, meta.file, meta.line);
         }
-        object.childs.forEach(walk);
+        object.children.forEach(walk);
     };
     for (const artifact of specification.artifacts)
         artifact.objects.forEach(walk);

package/dst/specbook-parse-syntax.js

@@ -150,7 +150,7 @@ const embed = (ctx, object, file) => {
         load(object.description, object.description.description, line);
     for (const property of object.properties)
         load(property, property.value, ctx.propMeta.get(property)?.line ?? line);
-    for (const child of object.childs)
+    for (const child of object.children)
         embed(ctx, child, file);
 };
 /*  parse an unordered list of key-values and/or concise-format objects  */
@@ -229,7 +229,7 @@ const parseConcise = (ctx, item, parent, file, line, group) => {
         id: anchor ?? slugify(name),
         name,
         properties: [],
-        childs: []
+        children: []
     };
     if (anchor !== undefined)
         object.anchor = anchor;
@@ -267,7 +267,7 @@ const parseConcise = (ctx, item, parent, file, line, group) => {
             ctx.diagnose(file, subLine, `nested ordered list below ${kind} "${name}" ignored`);
         subLine += (sub.raw.match(/\n/g) ?? []).length;
     }
-    parent.childs.push(object);
+    parent.children.push(object);
 };
 /*  parse a heading token into either a grouping container (e.g. "### STATE",
     collecting objects of its kind below the parent object) or a new object
@@ -298,7 +298,7 @@ const parseHeading = (ctx, token, state, stamps, file, line) => {
         id: heading.id ?? (depth === 1 ? heading.paren : undefined) ?? slugify(heading.name),
         name: heading.name,
         properties: [],
-        childs: []
+        children: []
     };
     if (heading.id !== undefined)
         object.anchor = heading.id;
@@ -310,7 +310,7 @@ const parseHeading = (ctx, token, state, stamps, file, line) => {
     if (parent === undefined)
         state.artifacts.push({ ...stamps, objects: [object] });
     else
-        parent.childs.push(object);
+        parent.children.push(object);
     state.stack.length = depth - 1;
     state.stack[depth - 1] = object;
     state.current = object;

package/dst/specbook-parse.js

@@ -51,7 +51,7 @@ export const specStatistics = (specification) => {
             texts.push(object.description.description, object.description.rationale ?? "");
         for (const text of texts)
             links += (plainText(text).match(referenceRegex) ?? []).length;
-        object.childs.forEach(walk);
+        object.children.forEach(walk);
     };
     for (const artifact of specification.artifacts)
         artifact.objects.forEach(walk);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":                                "@rse/specbook",
-    "version":                             "1.2.3",
+    "version":                             "1.2.5",
     "publishConfig":                       { "access": "public" },
     "description":                         "Markdown-based Specification Format (API, CLI and MCP service)",
     "license":                             "Apache-2.0",
@@ -24,19 +24,19 @@
         "pdf-lib":                         "1.17.1",
         "subset-font":                     "2.7.0",
         "@rse/mrcs":                       "0.9.2",
-        "@rse/gradia":                     "1.1.9",
+        "@rse/gradia":                     "1.2.1",
         "@toon-format/toon":               "4.1.1",
         "valibot":                         "1.4.2",
         "nunjucks":                        "3.2.4",
         "@rse/nunjucks-addons":            "2.2.0",
         "textframe":                       "1.2.1",
-        "@swc/html":                       "1.16.1",
+        "@swc/html":                       "1.16.2",
         "tokenizr":                        "2.2.1",
-        "playwright":                      "1.62.1",
+        "playwright":                      "1.63.0",
         "source-code-error":               "1.2.0",
         "commander":                       "15.0.0",
         "chalk":                           "6.0.0",
-        "chokidar":                        "5.0.0",
+        "chokidar5":                       "npm:chokidar@5.0.0",
         "glob":                            "13.0.6",
         "es-toolkit":                      "1.52.0",
         "fastify":                         "5.12.3",
@@ -64,7 +64,7 @@
         "source-code-pro":                 "2.42.0",
         "@fontsource/noto-sans-symbols":   "5.3.0",
         "postcss":                         "8.5.28",
-        "postcss-cli":                     "11.0.1",
+        "postcss-cli":                     "12.0.0",
         "postcss-url":                     "10.1.4",
         "stylus":                          "0.64.0",
         "@rse/stx":                        "1.1.6",