@git-stunts/git-warp 10.1.1 → 10.1.2

package/index.js

@@ -1,5 +1,24 @@
+/* @ts-self-types="./index.d.ts" */
+
 /**
- * @fileoverview Empty Graph - A graph database substrate using Git commits pointing to the empty tree.
+ * @module
+ *
+ * Deterministic WARP graph over Git: graph-native storage, traversal,
+ * and tooling. All graph state lives as Git commits pointing to the
+ * well-known empty tree — invisible to normal Git workflows, but
+ * inheriting content-addressing, cryptographic integrity, and
+ * distributed replication.
+ *
+ * @example
+ * ```ts
+ * import WarpGraph from "@git-stunts/git-warp";
+ *
+ * const graph = await WarpGraph.open({ repo: ".", graphName: "myGraph" });
+ * const patch = await graph.createPatch("writer-1");
+ * patch.addNode("user:alice").setProperty("user:alice", "name", "Alice");
+ * await patch.commit();
+ * const state = await graph.materialize();
+ * ```
  */
 
 import GitGraphAdapter from './src/infrastructure/adapters/GitGraphAdapter.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@git-stunts/git-warp",
-  "version": "10.1.1",
+  "version": "10.1.2",
   "description": "Deterministic WARP graph over Git: graph-native storage, traversal, and tooling.",
   "type": "module",
   "license": "Apache-2.0",

package/src/domain/entities/GraphNode.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Immutable value object representing a single graph node backed by a
+ * Git commit pointing to the empty tree.
+ *
+ * @module
+ */
+
+/**
+ * Immutable entity representing a graph node.
+ */
+export default class GraphNode {
+  /** Commit SHA */
+  readonly sha: string;
+  /** Author name */
+  readonly author: string | undefined;
+  /** Commit date */
+  readonly date: string | undefined;
+  /** Node message/data */
+  readonly message: string;
+  /** Array of parent SHAs */
+  readonly parents: readonly string[];
+
+  constructor(data: {
+    sha: string;
+    message: string;
+    author?: string;
+    date?: string;
+    parents?: string[];
+  });
+}

package/src/domain/entities/GraphNode.js

@@ -1,3 +1,12 @@
+/* @ts-self-types="./GraphNode.d.ts" */
+
+/**
+ * @module
+ *
+ * Immutable value object representing a single graph node backed by a
+ * Git commit pointing to the empty tree.
+ */
+
 /**
  * Immutable domain entity representing a node in the graph.
  *

package/src/visualization/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Visualization module for rendering WARP graph data as ASCII tables,
+ * SVG diagrams, and interactive browser views.
+ *
+ * @module
+ */
+
+// ASCII renderers
+export declare const colors: Record<string, (s: string) => string>;
+export declare const colorsDefault: Record<string, (s: string) => string>;
+export declare function createBox(content: string, options?: Record<string, unknown>): string;
+export declare function createTable(rows: unknown[], options?: Record<string, unknown>): string;
+export declare function progressBar(current: number, total: number, options?: Record<string, unknown>): string;
+export declare function renderInfoView(data: Record<string, unknown>): string;
+export declare function renderCheckView(data: Record<string, unknown>): string;
+export declare function renderMaterializeView(data: Record<string, unknown>): string;
+export declare function renderHistoryView(data: Record<string, unknown>): string;
+export declare function summarizeOps(ops: unknown[]): string;
+export declare function renderPathView(data: Record<string, unknown>): string;
+export declare function renderGraphView(data: Record<string, unknown>): string;
+
+// SVG renderer
+export declare function renderSvg(positionedGraph: Record<string, unknown>, options?: Record<string, unknown>): string;
+
+// Layout engine
+export declare function layoutGraph(graphData: { nodes: unknown[]; edges: unknown[] }, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+export declare function queryResultToGraphData(result: Record<string, unknown>): { nodes: unknown[]; edges: unknown[] };
+export declare function pathResultToGraphData(result: Record<string, unknown>): { nodes: unknown[]; edges: unknown[] };
+export declare function rawGraphToGraphData(result: Record<string, unknown>): { nodes: unknown[]; edges: unknown[] };
+export declare function toElkGraph(graphData: { nodes: unknown[]; edges: unknown[] }, options?: Record<string, unknown>): Record<string, unknown>;
+export declare function getDefaultLayoutOptions(): Record<string, string>;
+export declare function runLayout(elkGraph: Record<string, unknown>): Promise<Record<string, unknown>>;
+
+// Utils
+export declare function truncate(str: string, maxWidth: number): string;
+export declare function timeAgo(dateStr: string): string;
+export declare function formatDuration(ms: number): string;
+export declare function padRight(str: string, width: number): string;
+export declare function padLeft(str: string, width: number): string;
+export declare function center(str: string, width: number): string;
+export declare function stripAnsi(str: string): string;

package/src/visualization/index.js

@@ -1,5 +1,11 @@
+/* @ts-self-types="./index.d.ts" */
+
 /**
- * Visualization module - main exports
+ * @module
+ *
+ * Visualization module for rendering WARP graph data as ASCII tables,
+ * SVG diagrams, and interactive browser views. Includes ELK-based
+ * graph layout, ANSI formatting utilities, and CLI renderers.
  */
 
 // ASCII renderers

package/src/visualization/utils/ansi.js

@@ -1,4 +1,10 @@
-import stripAnsiLib from 'strip-ansi';
+// ANSI escape code regex (inlined from ansi-regex@6 / strip-ansi@7)
+// Valid string terminator sequences: BEL, ESC\, 0x9c
+const ST = '(?:\\u0007|\\u001B\\u005C|\\u009C)';
+const osc = `(?:\\u001B\\][\\s\\S]*?${ST})`;
+const csi =
+  '[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]';
+const ansiRegex = new RegExp(`${osc}|${csi}`, 'g');
 
 /**
  * Strips ANSI escape codes from a string.
@@ -8,7 +14,7 @@ import stripAnsiLib from 'strip-ansi';
  * @returns {string} The string with all ANSI codes removed
  */
 export function stripAnsi(str) {
-  return stripAnsiLib(str);
+  return str.replace(ansiRegex, '');
 }
 
 export default { stripAnsi };