@tyndall/build

Overview

Static build pipeline package for bundling, rendering, manifest generation, and cache-aware incremental output.

Responsibilities

• Execute build pipeline stages in deterministic order
• Bundle client and server assets and emit manifests
• Apply cache and incremental build strategies
• Emit client bootstrap policies for SSR+CSR transition behavior when configured
• Emit executable adapter-driven client/server runtime entries (not placeholder-only chunks)
• Clean output directory before each build to prevent stale artifact reuse across mode changes
• Recognize root special files (_app, _document, _404, _error, init.server) and wire them into build entries
• Render custom document shells when _document provides renderDocument or renderDocumentFragments
• Inject route data payloads (__HYPER_ROUTE_DATA__) into HTML and navigation payloads
• Emit legacy nomodule runtime assets with ES5-safe syntax when legacy.enabled is active
• Inject legacy polyfill scripts according to legacy.polyfills (auto or explicit script list)
• Emit ES5 classic browser scripts when target="es5" is configured (no module scripts)
• Stamp build version metadata into HTML, manifest, and script URLs when build.version is configured

Public API Highlights

• build
• runBuildPipeline
• bundleClient and bundleServer

Development

• Build: bun run --filter @tyndall/build build
• Test (from workspace root): bun test

Documentation

• Package specification: spec.md
• Package architecture: architecture.md
• Package changes: CHANGELOG.md

Maintenance Rules

• Keep this document aligned with implemented package behavior.
• Update spec.md and architecture.md whenever package contracts or design boundaries change.
• Record user-visible package changes in CHANGELOG.md.