flet-box 1.0.4 → 1.0.6

package/README.md

@@ -95,8 +95,18 @@ flet-box createBundle www      # bundle the app into www/
 flet-box build android         # Android debug APK
 flet-box build ios             # iOS Simulator app (macOS + Xcode)
 flet-box build ios --archive   # unsigned iOS archive, sign in Xcode
+
+# API lookup + anti-hallucination gate (works offline, in the repo or any app)
+flet-box check-api                      # scan src/ for invented widgets/props
+flet-box check-api --props Button       # print the real props of one widget
+flet-box check-api --list               # print every public export
+flet-box check-api --emit-api           # (re)generate .fletbox/api/cheatsheet.md
 ```
 
+In a generated app these are also `npm run check` (and `npm run check -- --props Button`),
+because `flet-box create` writes `scripts/check-app.mjs` plus the `AGENTS.md` contract
+that points any AI assistant at the real API.
+
 ## Android and iOS
 
 `flet-box create` ships the Capacitor config, so the same SPA builds for both platforms. FletBox isn't on the npm registry — link it before installing:

package/bin/cli.js

@@ -13,17 +13,15 @@ import { createRequire } from "module";
 import fs from "fs";
 import path from "path";
 import { createProject } from "./commands/create.js";
+import { checkApi } from "./commands/checkApi.js";
 import { packageManager } from "./commands/package.js";
 import { createBundle } from "./commands/createBundle.js";
 import { buildAndroid } from "./commands/buildAndroid.js";
 import { buildIOS } from "./commands/buildIOS.js";
 import { runNative } from "./commands/runNative.js";
-import { runDevServer } from "./commands/runServer.js";
 import { createScreen } from "./commands/createScreen.js";
 import { createComponent } from "./commands/createComponent.js";
 import { killServer } from "./commands/killServer.js";
-import { runBundle } from "./commands/runBundle.js";
-import { runCloudflareDemo } from "./commands/runCloudflare.js";
 import { release } from "./commands/release.js";
 import { c, gradient, section, banner, divider, width, setupCtrlC } from "./utils/colors.js";
 
@@ -73,6 +71,11 @@ ${cmd("   └─ [dir]", "target folder (default www)")}
 ${cmd("release [--patch]", "Bump version, rebuild, tag (OTA release)")}
 ${cmd("   └─ --minor|--major", "bump that position instead of patch")}
 ${cmd("   └─ --push", "push the commit + tag to origin")}
+${cmd("check-api", "Validate the app against the installed flet-box API")}
+${cmd("   └─ --props <Widget>", "print one widget's real props")}
+${cmd("   └─ --list", "list every widget")}
+${cmd("   └─ --emit-api", "write .fletbox/api/cheatsheet.md")}
+${cmd("   └─ alias", "check | checkApi | doctor")}
 ${cmd("build android", "Build Android debug APK")}
 ${cmd("build android --release", "Build unsigned release APK/AAB to sign yourself")}
 ${cmd("build ios", "Build iOS Simulator app (macOS + Xcode)")}
@@ -262,6 +265,15 @@ async function main() {
         await release(args.slice(1));
         break;
 
+      case "check-api":
+      case "checkApi":
+      case "check":
+      case "doctor": {
+        const { exitCode } = await checkApi(args.slice(1));
+        if (exitCode) process.exit(exitCode);
+        break;
+      }
+
       case "build":
         if (args[1] === "android") {
           buildAndroid(args.slice(2));
@@ -308,7 +320,11 @@ async function main() {
           runNative(args.slice(1));
           break;
         }
-        await runDevServer({
+        // The server commands are the only ones that pull in `ws`/`chokidar`,
+        // which are devDependencies: a consumer installing `flet-box` from npm
+        // has neither, so loading them at module scope would break every CLI
+        // command for them. Import them when a server is actually started.
+        await (await import("./commands/runServer.js")).runDevServer({
           spaMode: false,
           hotReload: flags.hot,
           port: flags.port,
@@ -329,7 +345,7 @@ async function main() {
           !args[1].startsWith("-")
             ? args[1]
             : "www";
-        await runBundle({
+        await (await import("./commands/runBundle.js")).runBundle({
           target: targetDir,
           port: flags.port,
           askPort: !flags.portExplicit,
@@ -342,7 +358,7 @@ async function main() {
       case "runSpa":
       case "spa":
         ensureProject();
-        await runDevServer({
+        await (await import("./commands/runServer.js")).runDevServer({
           spaMode: true,
           hotReload: true,
           port: flags.port,
@@ -356,7 +372,7 @@ async function main() {
       case "demo":
       case "tunnel":
         ensureProject();
-        await runCloudflareDemo({
+        await (await import("./commands/runCloudflare.js")).runCloudflareDemo({
           port: flags.port,
           logRequests: flags.logRequests,
         });