TradJS

TradJS is a Bun framework for server-rendered pages, native browser navigation, file-based API routes, and interactive widgets. Import server functions from tradjs or tradjs/server and browser functions from tradjs/client. This revision keeps the existing server improvements and simplifies the frontend around explicit rendering.

Components return ordinary JSX. Application state is ordinary JavaScript data. A controller method changes state and calls render(vnode, element) at the appropriate boundary. Controllers can be functions, objects, or classes; the framework supplies no controller base class or state wrapper.

render(vnode, element) updates the element's contents. The element can be a standalone root or an element created by JSX anywhere inside an existing managed tree. A subtree render shares the root's existing reconciliation records, so a later parent render sees the current descendants. Components inside the selected boundary execute on every call; parent and sibling components outside it do not execute.

The browser exports include render, createElement/h, jsx/jsxs/jsxDEV, Fragment, setReconciler, getReconciler, and the existing reconciler strategies. Reusable components remain available as Show, For, Button, Stack, VisuallyHidden, Spinner, and FadeIn, from tradjs/client or tradjs/client/components. Import tradjs/client/styles.css explicitly for the optional spinner and entry animations. The component collection does not impose a theme.

The signals dependency, tradjs/client/signals entry point, reactive mount helper, signal/computed/effect/batch/untracked/Signal exports, ReadonlySignal/MountOptions types, memo helper, and RenderOptions.memo are removed. The showcase route is now /features/rendering. Its page.client.tsx default function initializes the page; the actual components return JSX and do not return mount functions or disposers.

Configure TypeScript with jsx set to react-jsx and jsxImportSource set to tradjs/client. In a normal Bun environment, run bun install after applying this revision, then bun run typecheck and bun test. bun run build cleans and regenerates declaration files. The package version remains 4.3.0 as an unreleased source revision; choose the appropriate breaking-change version before publication.

Read docs/FRONTEND.txt for rendering and ownership contracts, docs/ANIMATIONS_AND_PERFORMANCE.txt for motion and performance guidance, and the existing docs/ARCHITECTURE.md for server behavior. Validation results accompany the changed-files archive in validation.json. Native Bun execution and real-browser performance remain release checks for a normal host.