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

@burdenoff/fe-libs

v2026.1117.8

Published

Burdenoff frontend primitives and domain libraries

Readme

@burdenoff/fe-libs

Frontend primitives and domain libraries for all Burdenoff products.

Architecture

This is a Layer 1 package - a monolithic package with subpath exports for all primitives.

Package Structure

@burdenoff/fe-libs/
├── /workflow    - Workflow primitives (Node, Canvas, Edge)
├── /tag         - Tag components
├── /form        - Form components
├── /button      - Button primitives
└── /shared      - Shared utilities (cn, types)

Usage

import { Button } from '@burdenoff/fe-libs/button';
import { mockProducts } from '@burdenoff/fe-libs/shared/utils/mockData';
import { cn } from '@burdenoff/fe-libs/shared';

Tree shaking and import-only integrations

The package declares a conservative sideEffects allowlist so importing a hook or shell helper through a public barrel does not also retain unrelated feature renderers. Public exports and implementation identities are unchanged.

Import-only initialization barrels, CSS, bundled vendor initialization, shims, native boot modules, event sinks, providers, utilities, the assistant history storage listener and the breadcrumb registry remain side-effectful. Do not replace this with blanket sideEffects: false: import-only integrations must keep working.

When adding module-level executable code, review its variable/class initializers as well as its statements. Add an allowlist entry when initialization changes state outside that module. The package-side-effects tests guard the known boot paths and require explicit classification of new top-level executable statements; they do not replace that initializer review. Validate the packed package and loaded consumer routes, including lazy feature opening, before release.

Development

Installed public-shim consumer verification

After building and packing, create a private consumer with the actual local archive as its @burdenoff/fe-libs dependency and exact React/ReactDOM 19.3.1 peers. Use a normal script-disabled install to generate its lock, then a frozen coherence install. Do not source-link the library or borrow another node_modules.

node scripts/verification/installed-shim-consumer.mjs /path/to/private-consumer /path/to/candidate.tgz sha512-actual-archive-integrity

The verifier checks the archive SRI, every installed shipped file, the real lock, bare public shim imports, assert initialization/behavior, React peer/hook identity and the server snapshot. It does not invent full-browser-root support on Node, qualify the FluidGrids SDK, install dependencies, or publish anything.

# Install dependencies
bun install

# Build library
bun run build

# Type check
bun run type:check

# Run all checks
bun run sanity

Components

Workflow Primitives

  • WorkflowNode - Renders a workflow node with status indicators
  • WorkflowCanvas - Canvas component for workflow builder with grid background

Button

  • Button - Versatile button component with variants (default, destructive, outline, secondary, ghost, link)

Shared

  • cn - Utility for merging Tailwind classes

shell-native (app shells only)

@burdenoff/fe-libs/shell-native is the shell-side native runtime: Capacitor (iOS/Android), Electron desktop and PWA wiring in one entry point. App shells import it; microfrontends never do — MFEs talk to the shell through window.__burdenoffNativeBridge (@burdenoff/fe-libs/shared/native).

Boot it once in main.tsx, before React mounts:

import { bootNativeShell, registerDeepLinkNavigator } from '@burdenoff/fe-libs/shell-native';

const shell = bootNativeShell({
  product: 'vibecontrols',
  appName: 'VibeControls',
  // Optional plugins are loaded ONLY through these loaders, so web-only shells
  // never bundle them.
  plugins: {
    updater: () => import('@capgo/capacitor-updater'),
    pushNotifications: () => import('@capacitor/push-notifications'),
  },
  push: { enabled: true, onToken: (token) => void registerDevice(token) },
  runtimeHooks: { syncPendingOperations: refetchAll, saveState: flushDrafts },
});

// Inside the router:
registerDeepLinkNavigator((path) => navigate(path));
// After the first meaningful paint:
void shell.markAppReady();

Boot order (each step is individually try/caught — boot never throws): preview → OTA notifyAppReady → auth-redirect intercept → external URL opener → native bridge + platform classes → device info → status-bar theme listener → keyboard → Android back button → deep links → network → app-state hooks → push listeners → splash safety timer (native) → PWA service worker (web) → desktop shell boot.

Contracts the shells and MFEs can rely on:

  • Window globals — __burdenoffNativeBridge, __burdenoffDeviceInfo, __burdenoffOpenExternal(url), __burdenoffPushToken, __burdenoffPwaInstallPrompt.
  • Body classes — platform-ios | platform-android | platform-web, platform-native, platform-preview, keyboard-open. <html> carries data-platform and (in preview) data-native-preview.
  • CSS var — --keyboard-height (0px when closed).
  • Window events — burdenoff:appReady, burdenoff:appStateChange, burdenoff:networkStatusChange, burdenoff:keyboardWillShow|DidShow|WillHide|DidHide, burdenoff:pushToken, burdenoff:pwaUpdateReady, burdenoff:pwaInstalled, burdenoff:pwaInstallAvailable. The shell listens for burdenoff:statusBarTheme.

Native preview flag

?__nativePreview=ios|android|pwa|desktop renders the installed-app chrome in a plain browser (persisted in sessionStorage, cleared with off). It is presentation only — real plugin calls stay gated on Capacitor.isPluginAvailable, and the flag is ignored inside a real native app.

Build-time config generators

defineCapacitorConfig(nativeConfig), defineWebManifest(nativeConfig) and renderServiceWorker(nativeConfig, version) are pure functions (no @capacitor/* imports) that emit each product's capacitor.config.ts, public/manifest.json and public/sw.js from its native.config.json (NativeConfig).

Raw colours, canvas tokens and the shared ESLint guard

UI code uses semantic tokens only. createEslintConfig() from @burdenoff/fe-libs/shared/config/eslint.config.mjs reports, as an error, hex / rgb() / hsl() / oklch() literals and Tailwind palette classes (bg-red-500, text-white, border-t-gray-200, …) in string literals and template strings. Comments and test files are not checked.

  • A repo that still carries raw-colour debt can pass rawColors: 'warn' while it sweeps; treat that as a tracked, temporary opt-out.
  • A repo with a standalone ESLint config applies the same guard with 'no-restricted-syntax': ['error', ...rawColorRestrictedSyntax()].

Workflow builders, graphs and mappers use the canvas tokens in tokens.css. Each one aliases an existing chart-* / status-* / surface token, so it follows light/dark mode, the brand and the expressive themes:

| Group | Tokens | | ------------- | -------------------------------------------------------------------------------------------------------- | | Canvas | --color-canvas-{bg,grid,selection,minimap-bg,minimap-node,minimap-mask,control-bg} | | Node surface | --color-node-{bg,bg-hover,border,border-hover,border-selected,text,text-muted,handle,handle-connected} | | Node category | --color-node-{trigger,action,logic,loop,data,integration,ai,human,utility,end,default} plus -subtle | | Node state | --color-node-state-{idle,queued,running,success,warning,error,skipped} | | Edge | --color-edge-{default,hover,selected,active,success,error,compatible,incompatible,label-bg,label-text} | | Data type | --color-datatype-{string,number,boolean,object,array,date,binary,any} |

app-shell.css maps them to Tailwind utilities (bg-node-trigger, stroke-edge-default, ring-node-state-running, …). A shell with its own @theme imports @burdenoff/fe-libs/shared/styles/canvas-theme.css instead. For React Flow props, SVG attributes and inline styles, use the helpers in @burdenoff/fe-libs/shared/utils (nodeCategoryColor, edgeColor, nodeStateColor, dataTypeColor, chartSeriesColor(chartSeriesIndex(key))) and the literal class records (nodeCategoryClasses, nodeStateRingClasses, dataTypeTextClasses).

Explicit product analytics and withdrawal

ComradeCircle's default observability configuration uses the shared Rybbit sink's explicit event transport rather than the provider script's automatic capture. It sends only the five reviewed comradecircle.* funnel facts, resolves known route templates, and never includes resource IDs, query strings, fragments, page titles, referrers, cookies or bearer headers. The public ingestion endpoint requires a public site ID, not a client-side API key.

The host must set privacyConsent: true and privacyConsentReopen: true. The latter keeps a Privacy choices control visible after a decision so people can withdraw or change their choice. Consent, GPC and DNT are checked before every event. Withdrawal and unmount abort outstanding requests; the sink has no replay/retry queue. Alpha has no default site and does not reuse the production site. MFEs still emit typed events through useEventBus() only.

eventEndpoint and routeTemplates are opt-in AppShellObservabilityConfig.rybbit options. Unmatched routes fail closed in explicit mode. Other products keep their existing script mode; this product adoption is not a claim that the legacy provider's automatic listeners support revocation. The original script-loading criterion is replaced by explicit-ingestion verification because removing a loaded third-party script does not remove the listeners it installed.

Tech Stack

  • React 19
  • TypeScript 5.9+
  • TailwindCSS v4
  • Radix UI (for accessible primitives)
  • Vite 7 (for building)

Export migration (BOFF-9417)

Beginning with the first CalVer release containing BOFF-9417, the already nonfunctional @burdenoff/fe-libs/workflow export metadata is explicitly retired. Both advertised targets (dist/workflow.js and dist/workflow.d.ts) are absent from the verified published 2026.1016.3 package. The former WorkflowCanvas/WorkflowNode implementation was deliberately removed in source commit f0920f9a on 2026-01-15; this change does not remove a working runtime implementation or restore that obsolete UI. Existing published releases are unchanged. Usage outside the bounded local repository inventory is unknown; this is not a claim that external consumers do not exist.

Current workflow-builder functionality belongs to @burdenoff/fluidgrids-fe-sdk (WorkflowBuilder and WorkflowBuilderCore), not another microfrontend import. Those APIs differ from the deleted generic canvas/node props and require an explicit consumer migration; they are not a drop-in compatibility adapter. Consumers should review their intended workflow behavior before choosing that API.

The existing @burdenoff/fe-libs/shared/utils/mockData subpath is retained. Its five fixture arrays now have an explicit runtime build entry alongside their declarations. The archive verifier checks literal export/bin targets in the actual npm tar before publication; wildcard export patterns and universal consumer compatibility are not certified by that existence check. Normal release automation assigns the concrete CalVer version; this source note does not claim publication or host adoption.

Captured workspace actions

Use graphqlFetchPinned when a request belongs to a captured actor or workspace. Its named export also makes an incompatible host-library pin fail during the build. It refuses a missing or expired captured bearer before dispatch and never substitutes the account bearer from profile storage, refreshes the account session, or replays a response. Specify authority and context through the typed request options; pinned mode refuses alternate workspace/context overrides in extraHeaders. The caller supplies the current credential after normal session renewal and reviews a failed or ambiguous mutation before attempting it again.

For workspace authority, reuse the shared preparation guard:

const prepared = await prepareWorkspaceRequest({
  url: resolveGatewayUrl('workspace', baseUrl),
  authToken,
  actorId,
  workspaceId,
  tenantId,
  currentQuery: query,
  signal,
});
prepared.assertCurrent();
const response = await graphqlFetchPinned({
  gateway: 'workspace',
  baseUrl,
  query,
  variables,
  authToken,
  workspaceId,
  workspaceToken: prepared.workspaceToken,
  signal,
});

prepareWorkspaceRequest binds profile, actor and workspace authority and checks concurrent changes during token issuance. Pass the captured request context and cancel obsolete reads when the surrounding identity changes. Partition and remount UI query observers by actor/context as well; a response-cache key alone does not bind a request's credentials. The default refreshable mode retains profile-based session recovery. Existing explicit-token consumers need an individual authority/refresh review before adopting pinned behavior; this additive API does not retroactively repair those callers.

Third-party PDF.js redistribution material

The build preserves PDF.js upstream copyright/license headers and adds an accurate Vite/Rolldown transformation notice to both copied PDF.js modules. The packed package includes the exact installed upstream Apache-2.0 license, attribution, source-version/hash ledger and any supplied upstream NOTICE files under dist/third-party/pdfjs-dist/. Build and extracted-archive verification fail if this material or either PDF.js module is missing or altered.

Applications redistributing the PDF.js code must also retain its notices and copy this accompanying legal material into their deployed distribution. Do not strip the notices or omit the license to reduce bundle size. This does not replace the separate notice/source-availability obligations of optional native plugins.