Skip to content

Repository files navigation

React Data Inspector

A structured JavaScript data inspector for React: inspect the value you actually have.

Beta release channel. Website · Playground · Documentation. Run npm install && npm run dev locally. See release readiness before production adoption.

import { DataInspector } from '@nipe-solutions/react-data-inspector'
import '@nipe-solutions/react-data-inspector/styles.css'

;<DataInspector value={data} />

Install the beta release:

npm install @nipe-solutions/react-data-inspector@beta

Why this exists

JavaScript data is a graph. Dates, collections, undefined values, symbols and object identity deserve explicit semantics. A getter should not run just because a debugging panel opened.

  • Distinct circular and shared references, with reference target navigation.
  • Real JavaScript types and descriptor-based property inspection.
  • Controlled expansion and selection; cancellable search through collapsed data.
  • Hierarchical ranges and bounded rendering for large values.
  • Tree keyboard navigation, separate focus/selection, accessible actions.
  • Inspector and classic presentations on the same graph engine.
  • CSS variables, targeted slots, custom types and actions, unstyled mode.
  • React 18.3/19, SSR, TypeScript, ESM/CJS; no runtime dependencies beyond React peers.

Change only what you need

<DataInspector
  value={data}
  types={[moneyType]}
  actions={[openEntityAction]}
  className="my-inspector"
/>
.my-inspector {
  --rdi-background: #f7fbf9;
  --rdi-string-color: #206246;
  --rdi-focus-ring: #1d664c;
}

Prefer quoted keys and object-viewer syntax? Set presentation="classic"; see presentation modes.

See the compiled customization examples, API reference, architecture and type matrix, and performance methodology.

The beta is read-only; editing is not part of the public API. Getters are not evaluated, promises are not awaited, functions are not executed, and WeakMap/WeakSet contents remain opaque. Collection paths are not presented as JSON Pointers.

Development

npm run check
npm run test:e2e
npm run benchmark

MIT · NIPE Open Source

The playground guide covers live external updates, type scenarios, customization and opt-in measurements. Run npm run dev and open /playground.

About

A structured JavaScript data inspector for React. Cycle-safe, shared-reference aware, controlled and customizable.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages