@rse/specbook 0.9.3 → 0.9.5

package/dst/specbook-parse-syntax.js

@@ -3,8 +3,8 @@
 **  Copyright (c) 2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under Apache 2.0 <https://spdx.org/licenses/Apache-2.0>
 */
-import fs from "node:fs";
-import path from "node:path";
+import * as fs from "node:fs";
+import * as path from "node:path";
 import { marked } from "marked";
 import { embeddingRegex, embeddingMimeType } from "./specbook-parse-common.js";
 /*  split a description text into statement and optional rationale  */
@@ -89,7 +89,7 @@ const parseFrontmatter = (text) => {
         const line = 2 + (m[1].slice(0, km.index).match(/\n/g) ?? []).length;
         const value = km[1].trim();
         const date = new Date(value);
-        return { date: isNaN(date.getTime()) ? null : date, line, value };
+        return { date: Number.isNaN(date.getTime()) ? null : date, line, value };
     };
     return {
         present: true,
@@ -137,8 +137,7 @@ const parseList = (ctx, list, object, file, line) => {
         /*  a concise-format item carries a further segment on its first
             line, or ends it with the segment terminator (the case of an
             object without properties, whose description follows below)  */
-        const cm = first.match(/^([^:;]+):\s+(.+;.*)$/);
-        if (cm !== null)
+        if (/^[^:;]+:\s+.+;.*$/.test(first))
             parseConcise(ctx, item, object, file, line);
         else {
             const km = first.match(/^([^:;]+):\s*(.*)$/);
@@ -234,7 +233,7 @@ const parseConcise = (ctx, item, parent, file, line, group) => {
     const statements = new Array();
     for (const segment of segments) {
         const km = segment.match(/^([^:;]+):\s+(.+)$/);
-        if (km !== null && !(/\sBECAUSE\s/.test(segment))) {
+        if (km !== null && !(/\s(?:\*\*BECAUSE\*\*|BECAUSE)\s/.test(segment))) {
             const property = { key: km[1].trim(), value: km[2].trim() };
             ctx.propMeta.set(property, { line });
             object.properties.push(property);
@@ -261,6 +260,7 @@ export const parseFile = (ctx, source) => {
                 ctx.diagnose(source.file, info.line, info.value === null ?
                     `missing "${key}:" frontmatter key` :
                     `invalid "${key}:" frontmatter timestamp "${info.value}"`);
+    /*  the state tracked while walking the Markdown tokens  */
     const artifacts = new Array();
     const stack = new Array();
     let current = null;
@@ -278,15 +278,16 @@ export const parseFile = (ctx, source) => {
         if (token.type === "heading") {
             flush();
             group = null;
-            const heading = parseHeadingText(token.text);
+            const { depth, text } = token;
+            const heading = parseHeadingText(text);
             if (heading.malformed !== undefined)
                 ctx.diagnose(source.file, line, `malformed anchor "${heading.malformed}" in heading`);
-            if (heading.name === "" && token.depth > 1) {
+            if (heading.name === "" && depth > 1) {
                 /*  a grouping container heading (e.g. "### STATES") collects
                     objects of its singular kind below the parent object  */
-                const parent = stack[token.depth - 2];
+                const parent = stack[depth - 2];
                 if (parent === undefined)
-                    ctx.diagnose(source.file, line, `heading level ${token.depth} without parent object`);
+                    ctx.diagnose(source.file, line, `heading level ${depth} without parent object`);
                 else {
                     group = { parent, kind: heading.kind.replace(/S$/, "") };
                     current = parent;
@@ -295,7 +296,7 @@ export const parseFile = (ctx, source) => {
             else {
                 const object = {
                     kind: heading.kind,
-                    id: heading.id ?? (token.depth === 1 ? heading.paren : undefined) ?? slugify(heading.name),
+                    id: heading.id ?? (depth === 1 ? heading.paren : undefined) ?? slugify(heading.name),
                     name: heading.name,
                     properties: [],
                     childs: []
@@ -307,7 +308,7 @@ export const parseFile = (ctx, source) => {
                 if (heading.primary)
                     object.primary = true;
                 ctx.objectMeta.set(object, { file: source.file, line });
-                if (token.depth === 1) {
+                if (depth === 1) {
                     artifacts.push({
                         created: created.date ?? new Date(),
                         modified: modified.date ?? new Date(),
@@ -316,16 +317,16 @@ export const parseFile = (ctx, source) => {
                     stack.length = 0;
                 }
                 else {
-                    const parent = stack[token.depth - 2];
+                    const parent = stack[depth - 2];
                     if (parent === undefined) {
-                        ctx.diagnose(source.file, line, `heading level ${token.depth} without parent object`);
+                        ctx.diagnose(source.file, line, `heading level ${depth} without parent object`);
                         line += (token.raw.match(/\n/g) ?? []).length;
                         continue;
                     }
                     parent.childs.push(object);
                 }
-                stack.length = token.depth - 1;
-                stack[token.depth - 1] = object;
+                stack.length = depth - 1;
+                stack[depth - 1] = object;
                 current = object;
             }
         }

package/dst/specbook-parse-value.js

@@ -43,7 +43,7 @@ const parseValueExpr = (tokens, pos, nested) => {
         }
         catch (err) {
             throw new Error(`invalid regular expression "/${source}/": ` +
-                (err instanceof Error ? err.message : String(err)));
+                (err instanceof Error ? err.message : String(err)), { cause: err });
         }
     }
     else if (token.type === "reference")
@@ -119,5 +119,11 @@ export const splitItems = (text) => {
         else
             parts[parts.length - 1] += char;
     }
-    return parts.map((part) => part.trim()).filter((part) => part !== "");
+    return parts.map((part) => {
+        /*  unquote a fully double-quoted item, mirroring the member
+            quoting of the value expression lexer  */
+        const item = part.trim();
+        const m = item.match(/^"((?:\\"|[^"])*)"$/);
+        return m !== null ? m[1].replace(/\\"/g, "\"") : item;
+    }).filter((part) => part !== "");
 };

package/dst/specbook-parse.js

@@ -18,10 +18,14 @@ export class Parser {
     /*  parse all source files into the specification AST and
         optionally validate the result against a configuration  */
     parse(sources, config) {
+        /*  reset the parsing context to allow a reuse of the parser  */
+        this.ctx = new ParseContext();
+        /*  parse all source files into their artifacts  */
         const artifacts = new Array();
         for (const source of sources)
             artifacts.push(...parseFile(this.ctx, source));
         const specification = { artifacts };
+        /*  validate the resulting specification AST  */
         if (artifacts.length > 0) {
             this.ctx.linkIndex = buildLinkIndex(specification);
             if (config !== undefined)

package/dst/specbook-struct-schema.js

@@ -13,13 +13,13 @@ const GradiaConfigSchemas = Object.fromEntries(Object.entries(Gradia.config).map
     typeof value === "boolean" ? v.boolean() : typeof value === "number" ? v.number() : v.string()]));
 const SchemaDiagramConfig = v.partial(v.strictObject(GradiaConfigSchemas, (issue) => issue.expected === "never" ? "unknown Gradia rendering option" :
     "expected a map of Gradia rendering options"));
-const SchemaProperty = v.object({
+const SchemaProperty = v.strictObject({
     name: v.string(),
     desc: v.optional(v.string()),
     value: v.optional(v.string()),
     optional: v.optional(v.boolean())
 });
-const SchemaDiagram = v.object({
+const SchemaDiagram = v.strictObject({
     type: v.optional(v.picklist(["graph", "hub", "grid"])),
     nodes: v.optional(v.string()),
     edges: v.optional(v.string()),
@@ -34,12 +34,12 @@ const SchemaDiagram = v.object({
     properties: v.optional(v.array(v.string())),
     config: v.optional(SchemaDiagramConfig)
 });
-const SchemaFormat = v.object({
+const SchemaFormat = v.strictObject({
     type: v.optional(v.picklist(["auto", "complex", "concise"])),
-    maxTableColumns: v.optional(v.number()),
+    maxTableColumns: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1))),
     withUnusedProps: v.optional(v.boolean())
 });
-const SchemaObject = v.object({
+const SchemaObject = v.strictObject({
     kind: v.string(),
     name: v.optional(v.string()),
     id: v.optional(v.string()),

package/dst/specbook-theme.js

@@ -26,7 +26,7 @@ export const themeStylesheet = (colors) => ":root {\n" +
     aligned with the layer-2 CSS mapping of the HTML rendering  */
 export const themeMapping = (colors, style) => {
     const idx = style === "dark" ?
-        { text: 28, muted: 22, symbol: 20, border: 16, accent: 24 } :
+        { text: 29, muted: 22, symbol: 20, border: 16, accent: 24 } :
         { text: 5, muted: 22, symbol: 24, border: 28, accent: 12 };
     return {
         text: colors.base[idx.text - 1],

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":                                "@rse/specbook",
-    "version":                             "0.9.3",
+    "version":                             "0.9.5",
     "publishConfig":                       { "access": "public" },
     "description":                         "Markdown-based Specification Format (API, CLI and MCP service)",
     "license":                             "Apache-2.0",
@@ -24,7 +24,7 @@
         "pdf-lib":                         "1.17.1",
         "subset-font":                     "2.5.0",
         "@rse/mrcs":                       "0.9.2",
-        "@rse/gradia":                     "0.9.8",
+        "@rse/gradia":                     "1.0.0",
         "@toon-format/toon":               "4.1.1",
         "valibot":                         "1.4.2",
         "nunjucks":                        "3.2.4",
@@ -44,12 +44,11 @@
         "zod":                             "4.4.3"
     },
     "devDependencies": {
-        "eslint":                          "9.39.5",
-        "@eslint/js":                      "9.39.5",
+        "eslint":                          "10.9.0",
+        "@eslint/js":                      "10.0.1",
         "typescript-eslint":               "8.67.0",
         "eslint-plugin-promise":           "7.3.0",
-        "eslint-plugin-import":            "2.32.0",
-        "neostandard":                     "0.13.0",
+        "neostandard":                     "0.14.0-next.1",
         "globals":                         "17.11.0",
         "@types/node":                     "26.2.0",
         "@types/subset-font":              "2.3.0",