BlazorFlowGraph.Diffing 0.2.0

BlazorFlowGraph

BlazorFlowGraph is a semantic dataflow visualization framework for .NET and Blazor applications.

The repository focuses on semantic graph projection, incremental synchronization, automatic layout, and browser-side rendering rather than generic diagram editing.

Documentation Map

Start here:

• docs/TERMINOLOGY.md — canonical project vocabulary
• docs/SPECS.md — behavioral authority, invariants, contracts, and validation expectations
• docs/architecture/system-overview.md — runtime boundaries and subsystem responsibilities
• docs/WORKFLOWS.md — workflow intent index
• docs/TBPS.md — reusable task best practices
• docs/agent-context/project-context.md — concise repository context
• docs/milestones/README.md — milestone document structure
• docs/decisions/ — accepted architectural decisions
• Milestones.md — capability roadmap and milestone progression

Specialized references:

• docs/integration/guide.md — consumer integration guidance
• docs/protocol/contracts.md — shared graph contract reference
• docs/layout/architecture.md — layout engine reference
• docs/rendering/model.md — render pipeline reference
• docs/research/README.md — exploratory research document location
• docs/ai/ — AI-facing architecture, protocol, and rendering references
• samples.md — sample catalog with run commands and screenshots

docs/agent-context/ and docs/ai/ are routing and context aids. Durable terminology, behavior, structure, rationale, workflow intent, and process guidance live in terminology, specs, architecture, decisions, workflows, and TBPs.

Repository Structure

src/
  DotNet/
  TypeScript/
samples/
tests/
docs/
.github/
tooling/

Architecture at a Glance

• .NET owns semantic models, projection generation, diff generation, validation, and orchestration.
• TypeScript owns rendering, layout execution, reconciliation, viewport state, and interaction state.
• Blazor stays thin and acts as the hosting and integration layer.

Authoritative architecture details live in docs/architecture/system-overview.md.

Quick Start

Install package

dotnet add package BlazorFlowGraph.Blazor

Register services

builder.Services.AddDataflowVisualizer();

Render a graph

@using BlazorFlowGraph.Blazor

<DataflowGraph Snapshot="@snapshot" Width="1200" Height="800" />

Load the browser bundle

<script src="_content/BlazorFlowGraph.Blazor/js/dataflow-visualizer.js"></script>

Public contract references

• docs/specs/graph-snapshots.md
• docs/specs/graph-diffs.md
• docs/specs/browser-runtime-reconciliation.md
• docs/specs/semantic-overlays.md
• docs/specs/overlay-provider-contract.md
• docs/specs/inspection-workflows.md
• docs/specs/search-and-filtering.md
• docs/specs/semantic-layering.md
• docs/specs/large-graph-visibility.md
• docs/specs/viewport-and-navigation.md
• docs/specs/spatial-indexing.md
• docs/specs/progressive-rendering.md
• docs/specs/multi-view-navigation.md
• docs/specs/minimap-overview.md
• docs/specs/runtime-diagnostics.md
• docs/specs/renderer-backend-contract.md
• docs/specs/layout-provider-contract.md
• docs/specs/package-and-release-contract.md

Development

Prerequisites

• .NET 10 SDK
• Node.js LTS
• Corepack enabled for pnpm

Restore

corepack enable
pnpm install --frozen-lockfile
dotnet restore BlazorFlowGraph.slnx

Build

pnpm build
dotnet build BlazorFlowGraph.slnx --no-restore --configuration Release

TypeScript checks

pnpm typecheck
pnpm test

.NET tests

dotnet run --no-build --project tests/DotNet/BlazorFlowGraph.Protocol.Tests --configuration Release
dotnet run --no-build --project tests/DotNet/BlazorFlowGraph.Diffing.Tests --configuration Release
dotnet run --no-build --project tests/DotNet/BlazorFlowGraph.Projection.Tests --configuration Release
dotnet run --no-build --project tests/DotNet/BlazorFlowGraph.Semantics.Tests --configuration Release

Additional guidance

• Codespace.md — zero-install Codespaces setup
• Nuget.md — NuGet packaging and release guidance
• tooling/README.md — repository tooling notes

Current Status

The repository is in an early platform-building phase with milestones covering semantic projection, incremental synchronization, layout infrastructure, renderer abstraction, and sample-driven validation.

See Milestones.md for the roadmap.

License

This project is licensed under the Unlicense. See LICENSE.