@airo-js/core
v0.7.1
Published
Airo core runtime — createApp, PageManager, EventBus, HashRouter, Theme, IsolationRoot, RuntimePipeline, registry mailbox.
Maintainers
Readme
@airo-js/core
The runtime engine for the airo framework. Pure rendering primitives — no domain knowledge, no opinions about data shape.
Status: v0.x. Surface still subject to refinement; consumers should target
^0.1until1.0ships.
What's in here
- App lifecycle —
createApp,App,AppDeps, lifecycle FSM - Page rendering —
PageManager,PageRenderer,PageRendererFactory,RenderContext - Schema —
Page,PageLayout,Region,Slot,AppConfig,ComponentSettings - Navigation —
HashRouter,NavigationState,buildCrumbs(data-only trail helper; cartridges render their own breadcrumb DOM) - Events —
EventBus,IEventBus(snapshot-semantics observer) - Style isolation —
IsolationRoot,setupIsolationRoot,wrapInShadow(Shadow DOM strategies:light/shadow; framework ships zero CSS — cartridges own every rule inside the shadow root) - Theming —
Theme(CSS custom-property injection +customCSSescape hatch) - Pipeline orchestration —
Transformer,PostProcessor,RuntimePipeline,createPipeline - Plugin discovery —
Registry,createRegistry,pushToMailbox(stub-queue self-registration for late-loading chunks)
Scope
Rendering, lifecycle, style isolation, page routing, theme injection, pipeline orchestration. That's it. No data fetching, no auth, no tenancy, no drafts, no persistence. Those belong in the host application.
Use with @airo-js/cartridge-kit
@airo-js/core is the runtime; @airo-js/cartridge-kit is the plugin contract built on top of it. Most consumers use them together — see @airo-js/cartridge-kit for the cartridge boot sequence.
Install
pnpm add @airo-js/coreLicense
Apache 2.0.
