@tyndall/core

Overview

Core framework contracts, routing, configuration schemas, and shared runtime/build orchestration interfaces.

Responsibilities

• Define framework-wide types, schemas, and contracts
• Build route graphs and route metadata
• Attach nested layout metadata for UI adapters when enabled
• Track special route files (_app, _document, _404, _error, init.server) for downstream build/runtime usage
• Provide route matching, fallback policy evaluation, and page API contracts
• Resolve strict project config including logging, scroll restoration, and SSR client-routing policies (logging.level, routing.scrollRestoration, routing.ssrClientRouting)
• Define route data hooks (init.server, getRouteData) and route data key helpers
• Validate build version configuration for downstream manifest/HTML version stamping
• Provide client-bootstrap payload application behavior that remains compatible with mounted UI adapter roots
• Provide UI adapter streaming interfaces for SSR runtimes that support streaming responses

Public API Highlights

• loadConfig
• createRouteGraph
• resolveRouteWithPolicyFallback
• resolveUIAdapter

Development

• Build: bun run --filter @tyndall/core 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.