@robosystems/report-components

A source-agnostic React library for rendering XBRL-grade financial statements. The same components render financial statements from any source — a static holon.jsonld file (a report's canonical dataset-form holon), a live general ledger, or a graph database (entity graph or the SEC repository) — because the render logic is source-independent. The only thing that varies is a thin data adapter that turns its source into a normalized report model; the components handle the presentation-order walk, calculation-subtotal footing, and Information-Block table projection identically for every adapter.

Features

• Components — ReportView, StatementTable, FactInspector, and ExternalTextBlock for full statements down to per-fact inspection
• Five reference adapters (under /adapters) — parseJsonld for canonical holon.jsonld files, parseTavi for tavi.json (the same filing as a Project Tavi compiled model, XBRL International's draft — the same facts, walked directly with no RDF step; parseReportDocument sniffs which of the two it was handed), cypherAdapter for live graphs over GraphQL, fetchSecReportShell/fetchSecSection for the SEC repository, and parseStore for pre-parsed RDF stores
• Correct-by-construction rendering — presentation-order walk, calculation-subtotal footing, multi-factSet facts, and structure-title/kind parsing shared across all sources
• Plain React, ESM, tree-shakeable — react/react-dom peers only, no framework-specific imports; the same package feeds a Next.js app or a lightweight Vite app

Installation

npm install @robosystems/report-components

Usage

Render a statement by feeding ReportView a normalized report model produced by an adapter:

import { ReportView } from '@robosystems/report-components'
import { parseJsonld } from '@robosystems/report-components/adapters'

// `holonText` is a report's dataset-form holon.jsonld (scene / boundary / projection)
const report = await parseJsonld(holonText)

export function Report() {
  return <ReportView report={report} />
}

Status

Pre-1.0. Published to npm and consumed in production by RoboLedger and the xbrlkit viewer. The API surface may still evolve between minor versions until 1.0.

Resources

• RoboSystems Platform
• GitHub Repository
• API Reference

Support

• Issues
• Documentation
• Projects
• Discussions

License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT © 2026 RFS LLC