npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

okf-viz

v2.2.0

Published

Graph projection and browser rendering for an analyzed OKF bundle

Readme

okf-viz

okf-viz is the graph: the projection from a canonical okf.inspect.v1 bundle analysis to graph data, and the browser rendering of that data.

It is a library, not a page. If you want a finished HTML file you can open without a network, use the CLI (okf visualize), which builds one around this graph.

import { analyzeBundle } from "okf-core";
import { toVisualizationGraph } from "okf-viz";

const graph = toVisualizationGraph(analyzeBundle(source));

Interactive readers should use toVisualizationIndex for their initial browser payload. It keeps the graph, facets, titles, descriptions and tags while leaving document bodies and full provenance detail to the reader's on-demand document request.

toVisualizationGraph is pure. No clock, environment, storage, network, Markdown parsing, or link resolution enters it, so the same analysis always produces the same graph.

What the graph encodes

Four channels, each carrying one fact, so a reader can tell them apart:

  • Fill and shape are the page's type.
  • The border is who wrote the page — solid for a person, dashed for an agent, double for a process, absent when the actor grammar says nothing.
  • Opacity is whether a person ever checked the page.
  • A dotted outline marks a pending node: a link to a page nobody has written yet, which is work in progress rather than an error.

Rendering in a browser

okf-viz/browser mounts the graph into an element with Cytoscape and returns a handle for selecting, focusing, dimming and fitting it.

import cytoscape from "cytoscape";
import { mountGraph } from "okf-viz/browser";

const handle = mountGraph(document.getElementById("graph"), graph, { cytoscape });
handle.select("concepts/example.md");

A consumer with a large corpus can keep the graph larger than the viewport and ask for more spacing without depending on Cytoscape's option shape:

mountGraph(element, graph, {
  cytoscape,
  spacing: "roomy",
  initialViewport: "natural",
  theme: myApplicationTheme,
});

At overview zoom the renderer suppresses ordinary labels and arrowheads. Selection remains visible, and detail returns as the user zooms in.

The handle covers what a reader does to a graph: select one node, setDimmed to fade everything a predicate rejects, runLayout, fit the whole graph, and frame a set of nodes so the view shows exactly those. frame is what a focus mode needs — having decided which pages matter, show those and no more. Ids the graph does not carry are ignored, and an empty set leaves the camera alone rather than fitting nothing.

Cytoscape is a peer dependency. This package does not bundle it, so a consumer picks the version, dedupes it, and reaches the same cy instance the graph is drawn on. A consumer that needs a self-contained file inlines it at its own build step; the CLI does exactly that.

License

Apache-2.0.