Description

BAZWEAVE-KIT

// literate design system

bazweave·kit

@ragbaz/bazweave-kit

A React/TypeScript design-system embryo for assembling BAZ.Weave literate documents: tokens, four-domain highlighting, iconography, grammars, MDX, widgets and site slots.

TOKENS · HIGHLIGHT · MDX · WIDGETS · SLOTS · DOCUSAURUS · NEXT.JS

The publishing layer for GLITHER. The same kit turns Glither / Gleam / WIT / Rust source into a publishable literate document, host-agnostic across Docusaurus, Next.js and static SSR.

A

bazweave-kit

1

literate design system

technical choicesZero-dependency regex highlighter (runs in browser, SSR and the WeasyPrint/PDF pipeline) · tokens as a single source of truth (generated from tokens.json) · MDX map exposing content widgets AND design elements by JSX name.

valueOne toolkit makes Glither documents publishable, themed consistently with the diagrams, on any MDX host.

functionalityFour-domain syntax highlighting · admonitions, tabs, steps, badges · PlantUML widget · ComposeStack (a docker-compose collection as a folding shipping container) · Hero/Plate/Callout/SpecTable design elements · Docusaurus & Next adapters.

interoperabilityMDX component map + adapters (docusaurus, nextjs) · static HTML / SSR render · shares the token palette with diabaz.

usabilityDrop-in mdxComponents; <WeaveMdxRoot> provides theme + fonts + stylesheet; widgets mirror Docusaurus APIs so the same MDX renders in both.

securityPure presentation; the static renderer escapes content; no secrets, no eval.

work in progressVisual-regression coverage for widgets; a deduced-overlay rendering mode; richer ComposeStack (env, health, per-service state) driven by composeToStack from a real docker-compose.yml.