keri-ts 0.3.0 → 0.3.1

package/README.md

@@ -61,6 +61,14 @@ tufa annotate --qb2 --in <binary.qb2> --out <annotation.txt>
 - `--out <path>`: output file path (defaults to stdout)
 - `--qb2`: parse input as qb2 binary
 - `--pretty`: pretty-print annotation output
+- `--colored`: colorize annotation output on stdout only (ignored with `--out`)
+
+Optional color overrides:
+
+- File: `$HOME/.tufa/annot-color.yaml` or `$HOME/.tufa/annot-color.yml`
+- Keys: `counter`, `group`, `body`, `signature`, `said`, `opaque`, `comment`
+- Values: `black`, `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, `white`,
+  or bright variants (`brightBlack` ... `brightWhite`)
 
 ## Package entrypoints
 
@@ -72,3 +80,8 @@ npx tufa --help
 deno task tufa --help
 deno task tufa version
 ```
+
+## License
+
+Licensed under the Apache License, Version 2.0 (`Apache-2.0`). See the
+top-level `LICENSE` file in this repository.

package/esm/app/cli/annotate-color.js

@@ -0,0 +1,215 @@
+import * as dntShim from "../../_dnt.shims.js";
+const ANSI_CODES = {
+    black: "\x1b[30m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    magenta: "\x1b[35m",
+    cyan: "\x1b[36m",
+    white: "\x1b[37m",
+    brightBlack: "\x1b[90m",
+    brightRed: "\x1b[91m",
+    brightGreen: "\x1b[92m",
+    brightYellow: "\x1b[93m",
+    brightBlue: "\x1b[94m",
+    brightMagenta: "\x1b[95m",
+    brightCyan: "\x1b[96m",
+    brightWhite: "\x1b[97m",
+};
+const RESET = "\x1b[0m";
+const COLOR_KEYS = [
+    "counter",
+    "group",
+    "body",
+    "signature",
+    "said",
+    "opaque",
+    "comment",
+];
+const DEFAULT_COLORS = {
+    counter: "cyan",
+    group: "magenta",
+    body: "green",
+    signature: "yellow",
+    said: "brightBlue",
+    opaque: "brightRed",
+    comment: "brightBlack",
+};
+const SAID_CAPTURE = /(said=)(\S+)/g;
+const COMMENT_DELIM = " # ";
+function isColorName(value) {
+    return typeof value === "string" && value in ANSI_CODES;
+}
+function parseColorConfig(raw) {
+    const parsed = {};
+    const lines = raw.split(/\r?\n/);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const match = /^([A-Za-z][A-Za-z0-9_-]*)\s*:\s*(.+?)\s*$/.exec(trimmed);
+        if (!match)
+            return null;
+        const key = match[1];
+        let value = match[2];
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        parsed[key] = value;
+    }
+    const config = {};
+    for (const key of COLOR_KEYS) {
+        const value = parsed[key];
+        if (value === undefined)
+            continue;
+        if (!isColorName(value))
+            return null;
+        config[key] = value;
+    }
+    return config;
+}
+function resolveConfigPath(homeDir) {
+    const basePath = `${homeDir}/.tufa`;
+    const yamlPath = `${basePath}/annot-color.yaml`;
+    const ymlPath = `${basePath}/annot-color.yml`;
+    try {
+        const stat = dntShim.Deno.statSync(yamlPath);
+        if (stat.isFile)
+            return yamlPath;
+    }
+    catch {
+        // Continue to .yml fallback
+    }
+    try {
+        const stat = dntShim.Deno.statSync(ymlPath);
+        if (stat.isFile)
+            return ymlPath;
+    }
+    catch {
+        // No config file, use defaults
+    }
+    return null;
+}
+function readUserColorConfig() {
+    const homeDir = dntShim.Deno.env.get("HOME");
+    if (!homeDir)
+        return null;
+    const configPath = resolveConfigPath(homeDir);
+    if (!configPath)
+        return null;
+    try {
+        return parseColorConfig(dntShim.Deno.readTextFileSync(configPath));
+    }
+    catch {
+        return null;
+    }
+}
+function toAnsiColors(userConfig) {
+    const names = { ...DEFAULT_COLORS };
+    if (userConfig) {
+        for (const key of COLOR_KEYS) {
+            const value = userConfig[key];
+            if (value)
+                names[key] = value;
+        }
+    }
+    return {
+        counter: ANSI_CODES[names.counter],
+        group: ANSI_CODES[names.group],
+        body: ANSI_CODES[names.body],
+        signature: ANSI_CODES[names.signature],
+        said: ANSI_CODES[names.said],
+        opaque: ANSI_CODES[names.opaque],
+        comment: ANSI_CODES[names.comment],
+    };
+}
+function color(text, ansiCode) {
+    if (!text)
+        return text;
+    return `${ansiCode}${text}${RESET}`;
+}
+function colorizeComment(comment, colors) {
+    const saidTinted = comment.replace(SAID_CAPTURE, (_whole, prefix, said) => `${prefix}${color(said, colors.said)}`);
+    return color(saidTinted, colors.comment);
+}
+function colorizeValue(value, comment, colors) {
+    const text = value.trim();
+    if (!text)
+        return value;
+    if (comment && /opaque/i.test(comment)) {
+        return color(value, colors.opaque);
+    }
+    if (comment && /(Indexer|Sig|Sigs|Signature)/.test(comment)) {
+        return color(value, colors.signature);
+    }
+    if (comment && /(Group|count=|counter)/.test(comment)) {
+        return color(value, colors.group);
+    }
+    if (comment && /SERDER/.test(comment)) {
+        return color(value, colors.body);
+    }
+    if (/^[\[{]/.test(text)) {
+        return color(value, colors.body);
+    }
+    if (/^-[A-Za-z0-9_-]+$/.test(text)) {
+        return color(value, colors.counter);
+    }
+    return value;
+}
+function colorizeLine(line, colors) {
+    const trimmed = line.trimStart();
+    if (trimmed.startsWith("#")) {
+        return color(line, colors.comment);
+    }
+    const idx = line.indexOf(COMMENT_DELIM);
+    if (idx === -1) {
+        return colorizeValue(line, null, colors);
+    }
+    const value = line.slice(0, idx);
+    const comment = line.slice(idx + COMMENT_DELIM.length);
+    const valueTinted = colorizeValue(value, comment, colors);
+    const commentTinted = colorizeComment(comment, colors);
+    return `${valueTinted}${COMMENT_DELIM}${commentTinted}`;
+}
+/**
+ * Apply ANSI styling for CLI-only CESR annotation display.
+ * This is intentionally presentation-only and must not alter persisted output.
+ */
+export function colorizeAnnotatedOutput(annotated) {
+    const colors = toAnsiColors(readUserColorConfig());
+    const lines = annotated.split("\n");
+    const out = [];
+    let inPrettyJsonBody = false;
+    // support colorizing lines even with --pretty arg
+    for (const line of lines) {
+        const idx = line.indexOf(COMMENT_DELIM);
+        const value = idx === -1 ? line : line.slice(0, idx);
+        const comment = idx === -1 ? null : line.slice(idx + COMMENT_DELIM.length);
+        const trimmed = value.trim();
+        if (comment && /SERDER/.test(comment)) {
+            if (trimmed === "}" || trimmed === "]") {
+                const valueTinted = color(value, colors.body);
+                const commentTinted = colorizeComment(comment, colors);
+                out.push(`${valueTinted}${COMMENT_DELIM}${commentTinted}`);
+                inPrettyJsonBody = false;
+                continue;
+            }
+            out.push(colorizeLine(line, colors));
+            inPrettyJsonBody = false;
+            continue;
+        }
+        if (inPrettyJsonBody && idx === -1) {
+            out.push(color(line, colors.body));
+            continue;
+        }
+        if (idx === -1 && (trimmed === "{" || trimmed === "[")) {
+            inPrettyJsonBody = true;
+            out.push(color(line, colors.body));
+            continue;
+        }
+        out.push(colorizeLine(line, colors));
+    }
+    return out.join("\n");
+}

package/esm/app/cli/annotate.js

@@ -1,5 +1,6 @@
 import * as dntShim from "../../_dnt.shims.js";
 import { annotate } from "cesr-ts";
+import { colorizeAnnotatedOutput } from "./annotate-color.js";
 const TEXT_DECODER = new TextDecoder();
 /**
  * Reads bytes from stdin in chunks of 64KB and returns them as a single Uint8Array
@@ -34,6 +35,7 @@ export function* annotateCommand(args) {
         outPath: args.outPath,
         qb2: args.qb2,
         pretty: args.pretty,
+        colored: args.colored,
     };
     const inputBytes = options.inPath
         ? dntShim.Deno.readFileSync(options.inPath)
@@ -48,5 +50,8 @@ export function* annotateCommand(args) {
         dntShim.Deno.writeTextFileSync(options.outPath, annotated);
         return;
     }
-    console.log(annotated);
+    const output = options.colored
+        ? colorizeAnnotatedOutput(annotated)
+        : annotated;
+    console.log(output);
 }

package/esm/app/cli/command-definitions.js

@@ -199,6 +199,7 @@ function regAnnotateCmd(program, dispatch) {
         .option("--out <path>", "Output file path (defaults to stdout)")
         .option("--qb2", "Treat input as qb2 binary instead of text CESR")
         .option("--pretty", "Pretty-print annotation output")
+        .option("--colored", "Colorize annotation output (stdout only)")
         .action((options) => {
         dispatch({
             name: "annotate",
@@ -207,6 +208,7 @@ function regAnnotateCmd(program, dispatch) {
                 outPath: options.out,
                 qb2: options.qb2 || false,
                 pretty: options.pretty || false,
+                colored: options.colored || false,
             },
         });
         return Promise.resolve();

package/esm/app/version.js

@@ -2,8 +2,8 @@
  * Generated by scripts/generate_versions.ts.
  * Do not edit by hand.
  */
-export const PACKAGE_VERSION = "0.3.0";
-export const BUILD_METADATA = "build.3.9b643722";
+export const PACKAGE_VERSION = "0.3.1";
+export const BUILD_METADATA = "build.4.f47c821b";
 export const DISPLAY_VERSION = BUILD_METADATA
     ? `${PACKAGE_VERSION}+${BUILD_METADATA}`
     : PACKAGE_VERSION;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keri-ts",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "KERI TypeScript package with database primitives and CLI runtime",
   "homepage": "https://github.com/kentbull/keri-ts",
   "repository": {

package/types/app/cli/annotate-color.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Apply ANSI styling for CLI-only CESR annotation display.
+ * This is intentionally presentation-only and must not alter persisted output.
+ */
+export declare function colorizeAnnotatedOutput(annotated: string): string;
+//# sourceMappingURL=annotate-color.d.ts.map

package/types/app/cli/annotate-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotate-color.d.ts","sourceRoot":"","sources":["../../../src/app/cli/annotate-color.ts"],"names":[],"mappings":"AAyOA;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAyCjE"}

package/types/app/cli/annotate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotate.d.ts","sourceRoot":"","sources":["../../../src/app/cli/annotate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAuD3C,wBAAiB,eAAe,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,SAAS,CAAC,IAAI,CAAC,CAyBjB"}
+{"version":3,"file":"annotate.d.ts","sourceRoot":"","sources":["../../../src/app/cli/annotate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AA4D3C,wBAAiB,eAAe,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,SAAS,CAAC,IAAI,CAAC,CA6BjB"}

package/types/app/version.d.ts

@@ -2,7 +2,7 @@
  * Generated by scripts/generate_versions.ts.
  * Do not edit by hand.
  */
-export declare const PACKAGE_VERSION = "0.3.0";
-export declare const BUILD_METADATA = "build.3.9b643722";
+export declare const PACKAGE_VERSION = "0.3.1";
+export declare const BUILD_METADATA = "build.4.f47c821b";
 export declare const DISPLAY_VERSION: string;
 //# sourceMappingURL=version.d.ts.map