@rse/specbook 1.2.5 → 1.2.7

package/dst/specbook-parse.js

@@ -10,7 +10,7 @@ import { ParseContext } from "./specbook-parse-common.js";
 import { parseFile } from "./specbook-parse-syntax.js";
 import { validate, validateReferences } from "./specbook-parse-semantic.js";
 import { validateDiagrams } from "./specbook-diagram.js";
-export { resolveArtifact } from "./specbook-parse-semantic.js";
+export { resolveArtifact, collectSchemas } from "./specbook-parse-semantic.js";
 /*  parse a set of specification Markdown files into the specification
     AST and optionally validate the result against a configuration  */
 export const parseSpecification = (sources, config) => {

package/dst/specbook-verbose.d.ts

@@ -1,4 +1,8 @@
-export type VerboseLevel = "debug" | "notice";
+export type VerboseLevel = "none" | "notice" | "detail" | "trace";
 export type Verbose = (msg: string, level?: VerboseLevel) => void;
+export declare const verbosities: readonly [0, 1, 2, 3];
+export type Verbosity = typeof verbosities[number];
+export declare const verbosityOf: Record<VerboseLevel, Verbosity>;
+export declare const parseVerbosity: (value: string | number | boolean) => Verbosity;
 export declare const literal: (value: string | number) => string;
 export declare const renderVerbose: (msg: string, style?: (value: string) => string) => string;

package/dst/specbook-verbose.js

@@ -3,6 +3,28 @@
 **  Copyright (c) 2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under Apache 2.0 <https://spdx.org/licenses/Apache-2.0>
 */
+/*  the verbosity a consumer runs at, as the least one surfacing the
+    messages of each level: a message passes a consumer whose verbosity
+    is at least the one of its level  */
+export const verbosities = [0, 1, 2, 3];
+export const verbosityOf = { none: 0, notice: 1, detail: 2, trace: 3 };
+/*  parse and validate a verbosity specification, where a bare flag (or
+    a boolean word) selects the regular processing information  */
+export const parseVerbosity = (value) => {
+    let level;
+    if (typeof value === "boolean")
+        level = value ? 1 : 0;
+    else if (typeof value === "string" && (/^(?:true|yes|on)$/i).test(value))
+        level = 1;
+    else if (typeof value === "string" && (/^(?:false|no|off)$/i).test(value))
+        level = 0;
+    else
+        level = typeof value === "string" && !(/^\d+$/).test(value) ? NaN : Number(value);
+    if (!verbosities.includes(level))
+        throw new Error(`unknown verbosity "${value}" ` +
+            `(supported: ${verbosities.join(", ")})`);
+    return level;
+};
 /*  the sentinel characters delimiting a marked literal value, taken
     from the Unicode private use area, so they never clash with the
     regular content of a verbose message  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":                                "@rse/specbook",
-    "version":                             "1.2.5",
+    "version":                             "1.2.7",
     "publishConfig":                       { "access": "public" },
     "description":                         "Markdown-based Specification Format (API, CLI and MCP service)",
     "license":                             "Apache-2.0",