# WRNexusJS

WRNexusJS is an SSR-first, Bun-powered full-stack framework with a dedicated `.wrn` language, server rendering, selective client reactivity, file-based routing, database tooling, realtime communication, UI components, mobile support, and framework-native system packages.

## WRNexusJS 0.4.0

Version 0.4 introduces a package contribution platform. Installed `@wrnexus/*` systems can now register components, page/API/realtime routes, middleware, browser runtimes, static assets, Tailwind scan sources, database migrations, CLI inspection data, and DevToolbar panels.

A package-owned browser runtime is injected only when rendered markup asks for it:

```wrn
<Captcha type="alphanumeric" action="contact-submit" />
```

`@wrnexus/captcha` marks its output with `data-wrnexus-runtime="captcha"`. WRNexusJS then serves or bundles the package runtime and adds the correct script to the response. Applications no longer copy `captcha.js`, add script tags, or duplicate `Captcha.wrn` inside `@wrnexus/ui`.

## Development

```bash
bun install
bun run verify:0.4
bun run validate:0.4
```

The complete validation command runs framework typechecking, linting, package tests, formatting checks, integration tests, example tests/builds, CAPTCHA showcase checks, and managed CAPTCHA service tests.

## Main packages

The monorepo contains 30 framework packages covering the language/compiler, SSR/CSR, routing, server runtime, plugins, database access, queues, PubSub, uploads, validation, security, UI, mobile/native capabilities, AI, tracking, testing, and CAPTCHA.

Read:

- `docs/ARCHITECTURE-0.4.md`
- `docs/PACKAGE-RUNTIMES-0.4.md`
- `docs/PACKAGE-UPGRADES-0.4.md`
- `docs/UPGRADE-0.4.md`
- `docs/TEST-CHECKLIST-0.4.md`
- `packages/captcha/README.md`
- `CHANGELOG-0.4.0.md`