@chidchanun/bcp 0.3.1 → 0.3.2

package/docs/releases/0.3.2.md

@@ -0,0 +1,125 @@
+# BCP Framework 0.3.2 — Module System v2
+
+**State:** unreleased
+
+BCP Framework `0.3.2` adds a first-class server-side application module system on top of the Application Platform and Dependency Injection container introduced in `0.3.0` and `0.3.1`.
+
+## Highlights
+
+- new server-only `bcp/modules` public entrypoint;
+- dependency-first module import graph;
+- duplicate-name and circular-dependency detection;
+- typed DI providers owned by modules;
+- explicit token exports and imported-token re-exports;
+- existing BCP plugin contribution from modules;
+- legacy shared-service contribution for plugin interoperability;
+- module-owned Deployment Platform resources;
+- module `setup/start/stop/dispose` lifecycle;
+- startup cleanup when a module setup/start hook fails;
+- module config parser/schema support;
+- module graph/record diagnostics;
+- `createApp()` integration with both Module System v2 and legacy `bcp/plugins` modules;
+- compiled `modules.mjs` production runtime;
+- browser poison boundary for `bcp/modules`;
+- unit and prepared-package smoke coverage.
+
+## Public API
+
+```ts
+import {
+    MODULE_V2_KIND,
+    ModuleDependencyError,
+    ModuleLifecycleError,
+    composeModules,
+    defineModule,
+    isModuleDefinition,
+    resolveModuleOrder,
+} from "bcp/modules";
+```
+
+Important public types:
+
+```text
+ModuleDefinition
+ModuleInput
+ModuleContext
+ModuleComposition
+ModuleRecord
+ModuleConfigSchema
+ModuleConfigParser
+```
+
+## Application integration
+
+`ApplicationDefinition.modules` now accepts both:
+
+```text
+legacy PluginModule from bcp/plugins
+ModuleDefinition from bcp/modules
+```
+
+The application exposes:
+
+```ts
+app.modules
+app.context.modules
+```
+
+Module providers are registered into `app.container`; module plugins are composed into `app.plugins`; module shared services are composed into `app.services`; and module resources/lifecycle are registered into `app.deployment`.
+
+## Lifecycle ordering
+
+For v2 modules, imports are resolved before importers. Within each module, resources start before the module lifecycle hook:
+
+```text
+imported modules
+    ↓
+module resources
+    ↓
+module setup/start
+```
+
+Shutdown reverses this order:
+
+```text
+module stop/dispose
+    ↓
+module resources
+    ↓
+imported modules
+```
+
+If a module's own setup/start fails, its dispose hook is run before the error propagates and Deployment Platform rolls back previously started resources.
+
+## Compatibility
+
+Previous baseline: `0.3.1`.
+
+Intentional breaking changes from `0.3.1`: **none**.
+
+The existing `defineModule()` from `bcp/plugins` remains supported and unchanged. New application modules should import `defineModule()` from `bcp/modules`.
+
+## Packaging
+
+Prepared npm packages add:
+
+```text
+bcp/modules -> packages/client/src/modules.mjs
+```
+
+with TypeScript types from `packages/client/src/modules.ts` and the standard server-only browser boundary.
+
+## Validation
+
+Before tagging or publishing `0.3.2`:
+
+```powershell
+npm run typecheck
+npm run test:unit
+npm run test:integration
+npm run test:e2e
+npm run test:package
+npm run api:check
+npm run release:readiness
+npm run rc:check
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chidchanun/bcp",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "BCP Framework - a React full-stack application platform with routing, SSR, APIs, lifecycle composition and standalone production builds.",
   "type": "module",
   "license": "MIT",
@@ -18,6 +18,7 @@
     "framework",
     "application-platform",
     "dependency-injection",
+    "module-system",
     "ssr",
     "routing",
     "fullstack"
@@ -109,6 +110,11 @@
       "browser": "./packages/client/src/server-only.browser.mjs",
       "default": "./packages/client/src/container.mjs"
     },
+    "./modules": {
+      "types": "./packages/client/src/modules.ts",
+      "browser": "./packages/client/src/server-only.browser.mjs",
+      "default": "./packages/client/src/modules.mjs"
+    },
     "./application": {
       "types": "./packages/client/src/application.ts",
       "browser": "./packages/client/src/server-only.browser.mjs",

package/packages/bundler/src/client-boundary.ts

@@ -37,6 +37,7 @@ const SERVER_ONLY_IMPORTS =
         "bcp/observability",
         "bcp/deployment",
         "bcp/container",
+        "bcp/modules",
         "bcp/application",
     ]);