UNPKG

@stone-js/core

Version:

Stone.js core library, providing the kernel, factory, and context for building applications.

60 lines (40 loc) 4.03 kB
# Stone.js - Core [![npm](https://img.shields.io/npm/l/@stone-js/core)](https://opensource.org/licenses/MIT) [![npm](https://img.shields.io/npm/v/@stone-js/core)](https://www.npmjs.com/package/@stone-js/core) [![npm](https://img.shields.io/npm/dm/@stone-js/core)](https://www.npmjs.com/package/@stone-js/core) ![Maintenance](https://img.shields.io/maintenance/yes/2025) [![Build Status](https://github.com/stone-foundation/stone-js-core/actions/workflows/main.yml/badge.svg)](https://github.com/stone-foundation/stone-js-core/actions/workflows/main.yml) [![Publish Package to npmjs](https://github.com/stone-foundation/stone-js-core/actions/workflows/release.yml/badge.svg)](https://github.com/stone-foundation/stone-js-core/actions/workflows/release.yml) [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=stone-foundation_stone-js-core&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=stone-foundation_stone-js-core) [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=stone-foundation_stone-js-core&metric=coverage)](https://sonarcloud.io/summary/new_code?id=stone-foundation_stone-js-core) [![Security Policy](https://img.shields.io/badge/Security-Policy-blue.svg)](./SECURITY.md) [![CodeQL](https://github.com/stone-foundation/stone-js-core/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/stone-foundation/stone-js-core/security/code-scanning) [![Dependabot Status](https://img.shields.io/badge/Dependabot-enabled-brightgreen.svg)](https://github.com/stone-foundation/stone-js-core/network/updates) [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org) A universal JavaScript/TypeScript core for building scalable, context-adaptive applications with reusable business logic, independent of runtime environments. --- ## Overview **Stone.js Core** is the heart of the Stone.js framework, a context-aware, universal JavaScript/TypeScript framework designed to help you build scalable and portable applications that adapt to any runtime. > With Stone.js, business logic is no longer tied to one environment. > It becomes **reusable**, **composable**, and **context-resilient**. Whether you're targeting a command-line interface, an HTTP server, a browser app, an AWS Lambda function, or an edge environment, `@stone-js/core` provides the foundational architecture to keep your logic consistent, modular, and fully decoupled from infrastructure. ## Why Stone.js Core? - **Write once, run anywhere** — build your application logic independently of the environment. - **Context-first architecture** — every runtime context (CLI, HTTP, cloud, serverless, FaaS, browser) becomes a plug-and-play adapter. - **Universal lifecycle** — process events and produce responses in a unified flow. - **No assumptions, full control** — fully customizable configuration, extensibility, and composition. - **Framework without a framework** — use Stone.js with or without a frontend, backend, or transport protocol. ## What's Inside? Stone.js Core provides the foundational building blocks that power the entire ecosystem: - A flexible **context execution engine** (kernel) to handle app lifecycles. - A universal **event system** that translates any platform input into structured intents. - A **blueprint configuration model** for organizing app behavior and dependencies. - A powerful, context-aware **middleware and handler core**. - A runtime-independent foundation to power **modular, adaptive applications**. ## Learn More This package is part of the Stone.js ecosystem, a modern JavaScript framework built around the Continuum Architecture. Explore the full documentation: [https://stonejs.dev](https://stonejs.dev) ## API documentation - [API](https://github.com/stone-foundation/stone-js-core/blob/main/docs/modules.md) ## Contributing See [Contributing Guide](https://github.com/stone-foundation/stone-js-core/blob/main/CONTRIBUTING.md).