@chidchanun/bcp 0.1.20 → 0.1.22

package/docs/releases/0.1.22.md

@@ -0,0 +1,77 @@
+# BCP Framework 0.1.22
+
+BCP 0.1.22 adds the first dedicated Developer Tools milestone.
+
+## Highlights
+
+- Added `bcp doctor` for project/runtime health diagnostics.
+- Added `bcp inspect` for environment, resolved config, dependency and route inspection.
+- Added `--json` output for both developer-tool commands.
+- `bcp doctor` returns a non-zero exit code when blocking checks fail, so it can be used as a CI health gate.
+- Added React / React DOM version and package-location checks to detect duplicate React installations before they surface as `Invalid hook call` runtime failures.
+- Added route conflict and client-boundary validation without starting the dev server.
+- Added development environment diagnostics without printing private environment values.
+- Added unit coverage for CLI parsing, version checks, missing-project diagnostics and deterministic inspection output.
+
+## `bcp doctor`
+
+```bash
+bcp doctor
+```
+
+The health report checks:
+
+- Node.js support,
+- `package.json`, `app/` and optional `public/`,
+- declared and installed BCP dependencies,
+- React and React DOM versions,
+- whether BCP and the application resolve the same React/React DOM package roots,
+- development environment loading,
+- resolved framework config,
+- page/API route discovery,
+- client/server module boundaries.
+
+Use JSON output in automation:
+
+```bash
+bcp doctor --json
+```
+
+## `bcp inspect`
+
+```bash
+bcp inspect
+```
+
+The inspection report includes:
+
+- framework/runtime identity,
+- loaded development env filenames,
+- public environment variable names,
+- resolved BCP configuration,
+- installed BCP/React/React DOM versions,
+- page and API route mappings.
+
+Machine-readable output:
+
+```bash
+bcp inspect --json
+```
+
+## Duplicate React diagnostics
+
+The Developer Tools milestone includes a check motivated by the 0.1.21 local release verification workflow.
+
+If an application is linked directly to a framework staging directory, the application may resolve React from its own `node_modules` while the BCP SSR renderer resolves React DOM from the framework checkout. `bcp doctor` detects this package-root split and reports it as a failure before SSR reaches the `Invalid hook call` error.
+
+For local release verification, continue using packed `.tgz` artifacts rather than installing `.package/bcp` as a linked directory.
+
+## Compatibility
+
+0.1.22 does not change public rendering, routing, database, authentication, validation, middleware or error-handling APIs.
+
+The new functionality is additive CLI tooling. Existing BCP applications can continue using the current commands unchanged.
+
+## Next milestone
+
+The next planned milestone is BCP 0.1.23 — Logging & Observability.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chidchanun/bcp",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "description": "BCP Framework - a React full-stack framework with file-based routing, SSR, APIs, middleware, islands, caching and standalone production builds.",
   "type": "module",
   "license": "MIT",

package/packages/bundler/src/index.ts

@@ -881,6 +881,9 @@ export class DevClientBundler {
                 jsx:
                     "automatic",
 
+                jsxDev:
+                    true,
+
                 define:
                     createClientEnvironmentDefines(
                         "development"
@@ -1010,7 +1013,7 @@ export class DevClientBundler {
          * เปลี่ยนเป็น
          *
          * Page
-         *   import A
+         *   เดิม import A
          *   import B
          *
          * จึง rebuild graph ใหม่
@@ -1737,17 +1740,18 @@ function createReactRefreshPlugin(
                         extension === ".ts" ||
                         extension === ".tsx";
 
+                    const parsesJsx =
+                        extension !== ".ts";
+
                     const presets:
                         any[] = [];
 
                     /*
-                     * Babel 8
-                     *
-                     * ไม่ใช้:
-                     *
-                     * allowDeclareFields
-                     * allExtensions
-                     * isTSX
+                     * Babel removes TypeScript syntax and
+                     * injects React Refresh registrations.
+                     * JSX intentionally remains untransformed
+                     * so esbuild owns JSX semantics for both
+                     * the normal dev bundle and production.
                      */
                     if (
                         isTypeScript
@@ -1757,17 +1761,6 @@ function createReactRefreshPlugin(
                         ]);
                     }
 
-                    presets.push([
-                        presetReact,
-                        {
-                            runtime:
-                                "automatic",
-
-                            development:
-                                true,
-                        },
-                    ]);
-
                     const result =
                         await transformAsync(
                             source,
@@ -1784,6 +1777,15 @@ function createReactRefreshPlugin(
                                 sourceType:
                                     "module",
 
+                                parserOpts:
+                                    parsesJsx
+                                        ? {
+                                            plugins: [
+                                                "jsx",
+                                            ],
+                                        }
+                                        : undefined,
+
                                 presets,
 
                                 plugins: [
@@ -1839,7 +1841,7 @@ ${result.code}
                             transformed,
 
                         loader:
-                            "js",
+                            "jsx",
 
                         resolveDir:
                             path.dirname(

package/packages/cli/src/args.ts

@@ -8,6 +8,8 @@ export type CliCommand =
   | "routes"
   | "update"
   | "db"
+  | "doctor"
+  | "inspect"
   | "help"
   | "version";
 
@@ -33,6 +35,8 @@ export interface CliOptions {
 
   updateDryRun?: boolean;
 
+  json?: boolean;
+
   dbAction?: DatabaseCliAction;
 
   dbMigrationName?: string;
@@ -61,6 +65,9 @@ export function parseCliArgs(
   let updateDryRun =
     false;
 
+  let json =
+    false;
+
   let dbAction:
     DatabaseCliAction | undefined;
 
@@ -209,6 +216,14 @@ export function parseCliArgs(
       continue;
     }
 
+    if (
+      argument === "--json"
+    ) {
+      json =
+        true;
+      continue;
+    }
+
     if (
       argument.startsWith("-")
     ) {
@@ -297,6 +312,8 @@ export function parseCliArgs(
       argument === "routes" ||
       argument === "update" ||
       argument === "db" ||
+      argument === "doctor" ||
+      argument === "inspect" ||
       argument === "help" ||
       argument === "version"
     ) {
@@ -322,6 +339,16 @@ export function parseCliArgs(
     );
   }
 
+  if (
+    json &&
+    command !== "doctor" &&
+    command !== "inspect"
+  ) {
+    throw new Error(
+      "Option --json is only valid with `bcp doctor` or `bcp inspect`."
+    );
+  }
+
   return {
     command,
     rootDirectory,
@@ -330,6 +357,11 @@ export function parseCliArgs(
     updateTarget,
     updateCheck,
     updateDryRun,
+    ...(json
+      ? {
+          json: true,
+        }
+      : {}),
     ...(command === "db"
       ? {
           dbAction,