Gole NPM Packages

Modular JavaScript, TypeScript, React, font rendering, and printer packages powering the Gole Number System ecosystem.

🚧

Packages Currently Under Active Development

The @golenumber package suite is currently undergoing internal research, security audits, and API stabilization prior to public release on the NPM registry. Early access versions, architecture specifications, and implementation guides are available via the Gole MCP Server for AI assistants and partner integrations.

📦 Available & Planned Packages

Explore the 5 core packages constituting the Gole software architecture:

Core Math Engine

@golenumber/gole-core

In Development

Low-level JavaScript and TypeScript mathematical engine for the Gole Number System. Provides core decimal-to-Gole conversion algorithms, pair splitting, ligature character mapping, and validation routines.

  • Core conversion algorithms: toGole(), toGoleFloat(), and toDecimal()
  • Deterministic 2-digit pairing and ligature symbol lookup tables
  • High-performance integer padding and numeric string parsers
  • Zero-dependency lightweight ES module & CommonJS build
npm install @golenumber/gole-core (Coming Soon)
Typography & Assets

@golenumber/gole-font

In Development

OpenType font bundle and CSS binding utilities for rendering Gole ligature glyphs across web browsers, mobile viewports, and desktop applications.

  • Pre-configured OpenType font assets (.woff2, .woff, .ttf)
  • CSS utility classes (.gole-font) for automatic ligature substitution
  • Cross-browser font loading and webfont face declarations
  • Compatible with React, Next.js, Vue, Svelte, and vanilla HTML/CSS
npm install @golenumber/gole-font (Coming Soon)
React Components

@golenumber/react-gole

In Development

Modular React component library providing pre-styled Gole number displays, interactive conversion widgets, dual-notation counters, and input controls.

  • <GoleText /> and <GoleDisplay /> components for seamless rendering
  • Real-time dual decimal-to-Gole input fields and form bindings
  • Micro-animation support for smooth digit transitions
  • Full TypeScript props definitions and Tailwind/Vanilla CSS support
npm install @golenumber/react-gole (Coming Soon)
Hardware & PDF Printing

@golenumber/react-gole-tag-generator

In Development

Specialized Canvas and PDF printing engine designed for rendering high-resolution Gole numbers on industrial labels, receipt printers, and shipping manifests.

  • High-DPI HTML5 Canvas vector rendering engine
  • PDF label export utilities for logistics and warehouse management
  • Thermal printer ESC/POS command formatting for hardware integration
  • Customizable label dimensions, margins, and barcode overlay support
npm install @golenumber/react-gole-tag-generator (Coming Soon)
Data Visualization

@golenumber/react-recharts

In Development

Integration package extending Recharts to support dual-scale numerical axes, custom Gole data points, tooltip formatting, and chart legends.

  • Dual-axis formatting (Decimal + Gole ligature values)
  • Custom SVG Tick and Tooltip renderers for Recharts line/bar charts
  • Real-time stock dashboard and industrial telemetry chart presets
  • Seamless TypeScript props integration with standard Recharts components
npm install @golenumber/react-recharts (Coming Soon)

Developer Resources & Implementation Guides

Connected AI IDEs (Cursor, Claude, Windsurf, Antigravity, Codex) can fetch full step-by-step implementation code and OpenType font binding specifications directly from the Gole MCP Server using the get_gole_npm_implementation_guide tool.

Ask Gole AI chatbot