@tyndall/build 0.0.1

package/README.md

@@ -0,0 +1,35 @@
+# @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
+- 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](./spec.md)
+- Package architecture: [architecture.md](./architecture.md)
+- Package changes: [CHANGELOG.md](./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.

package/dist/build.d.ts

@@ -0,0 +1,30 @@
+import type { Manifest, RouteGraph, UIAdapterRegistry } from "@tyndall/core";
+import { type BuildStageTiming } from "./pipeline.js";
+export type BuildMode = "ssg" | "ssr";
+export interface BuildCacheOptions {
+    enabled: boolean;
+    dir: string;
+    maxSizeMB?: number;
+    maxAgeDays?: number;
+    propsTTLSeconds: number | false;
+    renderCache: boolean;
+    chunkCache: boolean;
+}
+export interface BuildOptions {
+    rootDir: string;
+    mode?: BuildMode;
+    outDir?: string;
+    routesDir?: string;
+    publicDir?: string;
+    cache?: Partial<BuildCacheOptions>;
+    adapterRegistry?: UIAdapterRegistry;
+}
+export interface BuildResult {
+    outDir: string;
+    routeGraph: RouteGraph;
+    manifest: Manifest;
+    timings: BuildStageTiming[];
+    cache: BuildCacheOptions;
+}
+export declare const build: (options: BuildOptions) => Promise<BuildResult>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,QAAQ,EAGR,UAAU,EAEV,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAoDvB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAExE,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;AAEtC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,GAAG,KAAK,CAAC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAufD,eAAO,MAAM,KAAK,GAAU,SAAS,YAAY,KAAG,OAAO,CAAC,WAAW,CA0pBtE,CAAC"}