@stacksjs/build 0.75.423 → 0.75.431

package/README.md

@@ -1,6 +1,23 @@
 # Stacks Build
 
-This package contains the web development build tooling. In simple terms, here lives the Vite & Nitro engine code.
+Shared Bun package build tooling, declaration validation and runtime export checks.
+
+## Workspace builds
+
+`buildWorkspacePackages(directories)` reads package names and runtime dependencies
+from the selected manifests and builds providers before their consumers. Each
+package runs once through its normal build script and keeps its declaration and
+runtime export checks. Failed dependencies block their consumers; independent
+packages still build and report failures. Cycles and duplicate package names fail
+before any build starts.
+
+`dependencyLayers(packages)` supplies the same stable ordering to framework
+publication. Dependencies outside the selected set are resolved normally. Peer
+dependencies do not order builds because optional integrations can form cycles.
+
+`buddy build:core` preserves the application's feature selection. The release
+workflow uses `.github/scripts/build-framework.ts` to select every buildable
+public framework package, including the umbrella, regardless of app features.
 
 ## ☘️ Features
 

package/dist/dependency-layers.d.ts

@@ -0,0 +1,6 @@
+/** Stable layers of selected packages, each after its declared dependencies. */
+export declare function dependencyLayers<T extends DependencyPackage>(packages: readonly T[]): T[][];
+export declare interface DependencyPackage {
+  name: string
+  dependencies: readonly string[]
+}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export type { DependencyPackage } from './dependency-layers';
+export type { WorkspaceBuildResult } from './workspace';
 /**
  * Parse every generated declaration before a package can report a successful
  * build. The invalid emission shapes this used to repair (`method<T>: (…) => …`
@@ -66,3 +68,5 @@ export declare function transpilePackage(options: {
  */
 export declare function rewriteRelativeTsSpecifiers(js: string): string;
 export declare function frameworkExternal(extras?: string[]): string[];
+export { dependencyLayers } from './dependency-layers';
+export { buildWorkspacePackages, workspaceBuildTargets } from './workspace';