flet-box 1.0.3 → 1.0.5

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,6 +13,7 @@ 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";
@@ -73,6 +74,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 +268,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));