@typecad/cuttlefish 1.0.0-alpha.6 → 1.0.0-alpha.7

package/dist/ui-hook.d.ts

@@ -58,7 +58,23 @@ export interface TranspilerUIHook {
     lowerOnMount(htmlPath: string, opts: LowerOptions): LoweredUI;
     resolveColor(input: string, format: "rgb565" | "rgb666" | "rgb888" | "mono"): number;
     resolveColorInternal(input: string, format: "rgb565" | "rgb666" | "rgb888" | "mono"): number;
-    emitRuntimeHeader(): string;
+    /**
+     * Emits ONLY the CuttlefishGFX class definition (the shared GFX base for
+     * native display paths). Called separately from emitRuntimeHeader so the
+     * class can be emitted BEFORE display adapter declarations that
+     * instantiate CuttlefishGFX by value. Returns "" when active is false
+     * (Arduino path).
+     */
+    emitCuttlefishGfx(active: boolean): string;
+    /**
+     * Options controlling runtime-header emission.
+     *   - nativeDisplayActive: when true, emit the shared CuttlefishGFX class
+     *     (used by native display adapters on AVR/ESP32). Arduino paths pass
+     *     false (default) and use Adafruit_GFX directly.
+     */
+    emitRuntimeHeader(opts?: {
+        nativeDisplayActive?: boolean;
+    }): string;
     splitUiFile(src: string): UiFileParts;
     generateProjectUITypeDeclarations(projectRoot: string): {
         written: string[];

package/dist/utils/cli.js

@@ -431,12 +431,16 @@ export function parseCommandLine(argv) {
         // gen-decls - generate .d.ts from C++ files
         if (command === "gen-decls") {
             const allFlag = argv.includes("--all");
+            const componentsFlag = argv.includes("--components");
+            if (allFlag && componentsFlag) {
+                throw new Error("gen-decls: --components and --all are mutually exclusive. Use one or the other.");
+            }
             // The positional path may sit at argv[3] or argv[4] depending on whether
             // --all precedes or follows it. Scan argv starting after the subcommand
             // name (argv[2]) for the first token that is not a flag and not a known
             // flag's value. This mirrors the default-pipeline approach of "first
             // non-flag token wins".
-            const booleanFlags = new Set(["--all"]);
+            const booleanFlags = new Set(["--all", "--components"]);
             const valueFlags = new Set([
                 "--emit", "--target", "--outDir", "--out-dir", "--emit-maps", "--build-target",
             ]);
@@ -457,6 +461,28 @@ export function parseCommandLine(argv) {
                 inputPath = tok;
                 break;
             }
+            // --components mode: scan managed_components/ + components/ declared in
+            // cuttlefish.config.ts. Falls back to cwd when no path is given.
+            if (componentsFlag) {
+                const componentsDir = inputPath || process.cwd();
+                return {
+                    command: "gen-decls",
+                    inputFile: undefined,
+                    emitMode,
+                    target,
+                    outDir: outDir ? path.resolve(process.cwd(), outDir) : undefined,
+                    emitMaps,
+                    noTranspile: false,
+                    compile: false,
+                    upload: false,
+                    monitor: false,
+                    watch: false,
+                    baud: 9600,
+                    platformContext,
+                    scanDir: undefined,
+                    componentsDir: path.resolve(process.cwd(), componentsDir),
+                };
+            }
             if (!inputPath && !allFlag) {
                 throw new Error("Missing input C++ file path. Use: gen-decls <file.cpp> or gen-decls --all <directory>");
             }

package/dist/utils/fs.d.ts

@@ -2,3 +2,16 @@ export declare function ensureDir(dirPath: string): void;
 export declare function readText(filePath: string): string;
 export declare function writeText(filePath: string, content: string): void;
 export declare function listFiles(dirPath: string, extension: string): string[];
+/**
+ * Recursive variant of {@link listFiles}. Walks `dirPath` depth-first and
+ * returns every file (in every subdirectory) whose name ends with `extension`.
+ *
+ * Used by {@link loadLibraryDefinitions} so libdefs under nested cache dirs
+ * like `.cuttlefish/component-decls/<component>/` are discovered. Purely
+ * additive vs. the non-recursive `listFiles` — single-level layouts keep
+ * working, nested layouts now also work.
+ *
+ * Returns absolute paths. Unreadable directories are silently skipped
+ * (matches `listFiles`'s not-exist behavior for non-existent roots).
+ */
+export declare function listFilesRecursive(dirPath: string, extension: string): string[];

package/dist/utils/fs.js

@@ -10,6 +10,15 @@ export function readText(filePath) {
 }
 export function writeText(filePath, content) {
     ensureDir(path.dirname(filePath));
+    // Skip writing when content is identical — preserves mtime so downstream
+    // build tools (idf.py/ninja, arduino-cli, make) can skip recompilation.
+    try {
+        if (fs.readFileSync(filePath, "utf8") === content)
+            return;
+    }
+    catch {
+        // File doesn't exist yet — fall through to write.
+    }
     fs.writeFileSync(filePath, content, "utf8");
 }
 export function listFiles(dirPath, extension) {
@@ -21,3 +30,44 @@ export function listFiles(dirPath, extension) {
         .filter((name) => name.toLowerCase().endsWith(extension.toLowerCase()))
         .map((name) => path.join(dirPath, name));
 }
+/**
+ * Recursive variant of {@link listFiles}. Walks `dirPath` depth-first and
+ * returns every file (in every subdirectory) whose name ends with `extension`.
+ *
+ * Used by {@link loadLibraryDefinitions} so libdefs under nested cache dirs
+ * like `.cuttlefish/component-decls/<component>/` are discovered. Purely
+ * additive vs. the non-recursive `listFiles` — single-level layouts keep
+ * working, nested layouts now also work.
+ *
+ * Returns absolute paths. Unreadable directories are silently skipped
+ * (matches `listFiles`'s not-exist behavior for non-existent roots).
+ */
+export function listFilesRecursive(dirPath, extension) {
+    if (!fs.existsSync(dirPath)) {
+        return [];
+    }
+    const ext = extension.toLowerCase();
+    const out = [];
+    const stack = [dirPath];
+    while (stack.length > 0) {
+        const cur = stack.pop();
+        let entries;
+        try {
+            entries = fs.readdirSync(cur, { withFileTypes: true });
+        }
+        catch {
+            // Permission error / race / etc. Skip this subtree.
+            continue;
+        }
+        for (const entry of entries) {
+            const full = path.join(cur, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(full);
+            }
+            else if (entry.isFile() && entry.name.toLowerCase().endsWith(ext)) {
+                out.push(full);
+            }
+        }
+    }
+    return out;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typecad/cuttlefish",
-  "version": "1.0.0-alpha.6",
+  "version": "1.0.0-alpha.7",
   "description": "TypeScript to C++ transpiler — native, Arduino, and bare-metal targets",
   "type": "module",
   "main": "./dist/transpile.js",
@@ -49,6 +49,10 @@
       "types": "./dist/emit/route-hal-op.d.ts",
       "default": "./dist/emit/route-hal-op.js"
     },
+    "./lib/component-decls": {
+      "types": "./dist/libdef/component-decls.d.ts",
+      "default": "./dist/libdef/component-decls.js"
+    },
     "./ir/transformers/ui-lowering": {
       "types": "./dist/ir/transformers/ui-lowering.d.ts",
       "default": "./dist/ir/transformers/ui-lowering.js"
@@ -81,10 +85,10 @@
     "chalk": "^4.1.2",
     "typescript": "^5.7.3",
     "zod": "^3.24.0",
-    "@typecad/arduino-cli": "1.0.0-alpha.6"
+    "@typecad/arduino-cli": "1.0.0-alpha.7"
   },
   "peerDependencies": {
-    "@typecad/ui": "1.0.0-alpha.6"
+    "@typecad/ui": "1.0.0-alpha.7"
   },
   "peerDependenciesMeta": {
     "@typecad/ui": {
@@ -92,7 +96,7 @@
     }
   },
   "optionalDependencies": {
-    "@typecad/framework-native": "1.0.0-alpha.6"
+    "@typecad/framework-native": "1.0.0-alpha.7"
   },
   "devDependencies": {
     "@types/node": "^22.10.7"