@typecad/cuttlefish 1.0.0-alpha.11 → 1.0.0-alpha.12

package/dist/api/config.d.ts

@@ -54,8 +54,12 @@ export interface CuttlefishConfig {
     /**
      * MCU package providing silicon definitions.
      * Example: '@typecad/mcu-atmega328p'
+     *
+     * Optional for native/host targets — a desktop build has no MCU (the
+     * loader generates a boardless `@typecad/board` shim). Embedded targets
+     * should set this (or the deprecated `board`).
      */
-    mcu: string;
+    mcu?: string;
     /**
      * Board package to use. (Deprecated — use mcu + contract instead)
      */

package/dist/api/shared/framework-manifest.d.ts

@@ -20,17 +20,17 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
         generateHeaderFile: z.ZodBoolean;
         customBridgeShim: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        sourceExtension: "cpp" | "ino" | "cc" | "h";
         entrypointFunctionName: string;
         requiresLoopFunction: boolean;
-        sourceExtension: "ino" | "cc" | "cpp" | "h";
         generateHeaderFile: boolean;
         overrideBaseName?: string | undefined;
         outputSubdirectory?: string | undefined;
         customBridgeShim?: string | undefined;
     }, {
+        sourceExtension: "cpp" | "ino" | "cc" | "h";
         entrypointFunctionName: string;
         requiresLoopFunction: boolean;
-        sourceExtension: "ino" | "cc" | "cpp" | "h";
         generateHeaderFile: boolean;
         overrideBaseName?: string | undefined;
         outputSubdirectory?: string | undefined;
@@ -41,13 +41,13 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
         forcedIncludes: z.ZodArray<z.ZodString, "many">;
         symbolAliases: z.ZodRecord<z.ZodString, z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        targets: string[];
         forcedIncludes: string[];
         symbolAliases: Record<string, string>;
-    }, {
         targets: string[];
+    }, {
         forcedIncludes: string[];
         symbolAliases: Record<string, string>;
+        targets: string[];
     }>;
     hal: z.ZodObject<{
         [x: string]: z.ZodObject<{
@@ -57,12 +57,12 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
             partialCoverage: z.ZodDefault<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
             supported: boolean;
-            ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
+            ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
             partialCoverage: boolean;
             unsupportedReason?: string | undefined;
         }, {
             supported: boolean;
-            ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
+            ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
             unsupportedReason?: string | undefined;
             partialCoverage?: boolean | undefined;
         }>;
@@ -81,12 +81,12 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
         partialCoverage: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         supported: boolean;
-        ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
+        ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
         partialCoverage: boolean;
         unsupportedReason?: string | undefined;
     }, {
         supported: boolean;
-        ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
+        ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
         unsupportedReason?: string | undefined;
         partialCoverage?: boolean | undefined;
     }>, z.objectOutputType<{
@@ -97,12 +97,12 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
             partialCoverage: z.ZodDefault<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
             supported: boolean;
-            ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
+            ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
             partialCoverage: boolean;
             unsupportedReason?: string | undefined;
         }, {
             supported: boolean;
-            ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
+            ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
             unsupportedReason?: string | undefined;
             partialCoverage?: boolean | undefined;
         }>;
@@ -121,12 +121,12 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
         partialCoverage: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         supported: boolean;
-        ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
+        ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
         partialCoverage: boolean;
         unsupportedReason?: string | undefined;
     }, {
         supported: boolean;
-        ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
+        ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
         unsupportedReason?: string | undefined;
         partialCoverage?: boolean | undefined;
     }>, "strip">, z.objectInputType<{
@@ -137,12 +137,12 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
             partialCoverage: z.ZodDefault<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
             supported: boolean;
-            ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
+            ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
             partialCoverage: boolean;
             unsupportedReason?: string | undefined;
         }, {
             supported: boolean;
-            ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
+            ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
             unsupportedReason?: string | undefined;
             partialCoverage?: boolean | undefined;
         }>;
@@ -161,12 +161,12 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
         partialCoverage: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         supported: boolean;
-        ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
+        ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
         partialCoverage: boolean;
         unsupportedReason?: string | undefined;
     }, {
         supported: boolean;
-        ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
+        ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
         unsupportedReason?: string | undefined;
         partialCoverage?: boolean | undefined;
     }>, "strip">>;
@@ -222,16 +222,19 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
             compile: z.ZodBoolean;
             upload: z.ZodBoolean;
             monitor: z.ZodBoolean;
+            debug: z.ZodOptional<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
             prepare: boolean;
             compile: boolean;
             upload: boolean;
             monitor: boolean;
+            debug?: boolean | undefined;
         }, {
             prepare: boolean;
             compile: boolean;
             upload: boolean;
             monitor: boolean;
+            debug?: boolean | undefined;
         }>;
         reexportedFrom: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
@@ -241,6 +244,7 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
             compile: boolean;
             upload: boolean;
             monitor: boolean;
+            debug?: boolean | undefined;
         };
         reexportedFrom?: string | undefined;
     }, {
@@ -250,6 +254,7 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
             compile: boolean;
             upload: boolean;
             monitor: boolean;
+            debug?: boolean | undefined;
         };
         reexportedFrom?: string | undefined;
     }>;
@@ -305,12 +310,12 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
             recommendedStringImpl: "std_string" | "static_string";
         }>;
     }, "strip", z.ZodTypeAny, {
-        normalizeCppType: boolean;
-        mathHeader: "none" | "<math.h>" | "<Arduino.h>";
+        needsIostream: boolean;
         needsStdString: boolean;
         needsStdVector: boolean;
-        needsIostream: boolean;
         needsStdFunction: boolean;
+        mathHeader: "none" | "<math.h>" | "<Arduino.h>";
+        normalizeCppType: boolean;
         stdlibSupport: {
             hasVector: boolean;
             hasString: boolean;
@@ -321,12 +326,12 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
             recommendedStringImpl: "std_string" | "static_string";
         };
     }, {
-        normalizeCppType: boolean;
-        mathHeader: "none" | "<math.h>" | "<Arduino.h>";
+        needsIostream: boolean;
         needsStdString: boolean;
         needsStdVector: boolean;
-        needsIostream: boolean;
         needsStdFunction: boolean;
+        mathHeader: "none" | "<math.h>" | "<Arduino.h>";
+        normalizeCppType: boolean;
         stdlibSupport: {
             hasVector: boolean;
             hasString: boolean;
@@ -371,42 +376,42 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
         zephyr?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    hal: {
+        [x: string]: {
+            supported: boolean;
+            ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
+            partialCoverage: boolean;
+            unsupportedReason?: string | undefined;
+        };
+        raw?: unknown;
+    } & {
+        [k: string]: {
+            supported: boolean;
+            ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
+            partialCoverage: boolean;
+            unsupportedReason?: string | undefined;
+        };
+    };
+    packageName: string;
     schemaVersion: 1;
     frameworkId: string;
-    packageName: string;
     canonical: boolean;
     displayName: string;
     description: string;
     implementationMode: "from-scratch" | "extends-canonical" | "extends-other";
     entrypoint: {
+        sourceExtension: "cpp" | "ino" | "cc" | "h";
         entrypointFunctionName: string;
         requiresLoopFunction: boolean;
-        sourceExtension: "ino" | "cc" | "cpp" | "h";
         generateHeaderFile: boolean;
         overrideBaseName?: string | undefined;
         outputSubdirectory?: string | undefined;
         customBridgeShim?: string | undefined;
     };
     profile: {
-        targets: string[];
         forcedIncludes: string[];
         symbolAliases: Record<string, string>;
-    };
-    hal: {
-        [x: string]: {
-            supported: boolean;
-            ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
-            partialCoverage: boolean;
-            unsupportedReason?: string | undefined;
-        };
-        raw?: unknown;
-    } & {
-        [k: string]: {
-            supported: boolean;
-            ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
-            partialCoverage: boolean;
-            unsupportedReason?: string | undefined;
-        };
+        targets: string[];
     };
     polyfills: {
         emitted: {
@@ -426,16 +431,17 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
             compile: boolean;
             upload: boolean;
             monitor: boolean;
+            debug?: boolean | undefined;
         };
         reexportedFrom?: string | undefined;
     };
     typeEmission: {
-        normalizeCppType: boolean;
-        mathHeader: "none" | "<math.h>" | "<Arduino.h>";
+        needsIostream: boolean;
         needsStdString: boolean;
         needsStdVector: boolean;
-        needsIostream: boolean;
         needsStdFunction: boolean;
+        mathHeader: "none" | "<math.h>" | "<Arduino.h>";
+        normalizeCppType: boolean;
         stdlibSupport: {
             hasVector: boolean;
             hasString: boolean;
@@ -451,6 +457,12 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
         hardwareTestGroups: string[];
         halResolutionTests: string[];
     };
+    doctor?: {
+        available: boolean;
+    } | undefined;
+    licenses?: {
+        available: boolean;
+    } | undefined;
     basedOn?: string | undefined;
     inheritsStrategyId?: string | undefined;
     libraryResolution?: {
@@ -460,51 +472,45 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
         tryGenerateLibDecl: boolean;
         reexportedFrom?: string | undefined;
     } | undefined;
-    doctor?: {
-        available: boolean;
-    } | undefined;
-    licenses?: {
-        available: boolean;
-    } | undefined;
     compat?: {
         zephyr?: string | undefined;
     } | undefined;
 }, {
+    hal: {
+        [x: string]: {
+            supported: boolean;
+            ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
+            unsupportedReason?: string | undefined;
+            partialCoverage?: boolean | undefined;
+        };
+        raw?: unknown;
+    } & {
+        [k: string]: {
+            supported: boolean;
+            ops: Record<string, "stub" | "polyfill" | "supported" | "unsupported" | "probe-inconclusive">;
+            unsupportedReason?: string | undefined;
+            partialCoverage?: boolean | undefined;
+        };
+    };
+    packageName: string;
     schemaVersion: 1;
     frameworkId: string;
-    packageName: string;
     displayName: string;
     description: string;
     implementationMode: "from-scratch" | "extends-canonical" | "extends-other";
     entrypoint: {
+        sourceExtension: "cpp" | "ino" | "cc" | "h";
         entrypointFunctionName: string;
         requiresLoopFunction: boolean;
-        sourceExtension: "ino" | "cc" | "cpp" | "h";
         generateHeaderFile: boolean;
         overrideBaseName?: string | undefined;
         outputSubdirectory?: string | undefined;
         customBridgeShim?: string | undefined;
     };
     profile: {
-        targets: string[];
         forcedIncludes: string[];
         symbolAliases: Record<string, string>;
-    };
-    hal: {
-        [x: string]: {
-            supported: boolean;
-            ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
-            unsupportedReason?: string | undefined;
-            partialCoverage?: boolean | undefined;
-        };
-        raw?: unknown;
-    } & {
-        [k: string]: {
-            supported: boolean;
-            ops: Record<string, "supported" | "stub" | "unsupported" | "probe-inconclusive" | "polyfill">;
-            unsupportedReason?: string | undefined;
-            partialCoverage?: boolean | undefined;
-        };
+        targets: string[];
     };
     polyfills: {
         emitted: {
@@ -524,16 +530,17 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
             compile: boolean;
             upload: boolean;
             monitor: boolean;
+            debug?: boolean | undefined;
         };
         reexportedFrom?: string | undefined;
     };
     typeEmission: {
-        normalizeCppType: boolean;
-        mathHeader: "none" | "<math.h>" | "<Arduino.h>";
+        needsIostream: boolean;
         needsStdString: boolean;
         needsStdVector: boolean;
-        needsIostream: boolean;
         needsStdFunction: boolean;
+        mathHeader: "none" | "<math.h>" | "<Arduino.h>";
+        normalizeCppType: boolean;
         stdlibSupport: {
             hasVector: boolean;
             hasString: boolean;
@@ -549,6 +556,12 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
         hardwareTestGroups: string[];
         halResolutionTests: string[];
     };
+    doctor?: {
+        available: boolean;
+    } | undefined;
+    licenses?: {
+        available: boolean;
+    } | undefined;
     canonical?: boolean | undefined;
     basedOn?: string | undefined;
     inheritsStrategyId?: string | undefined;
@@ -559,12 +572,6 @@ export declare const FrameworkManifestSchema: z.ZodObject<{
         tryGenerateLibDecl: boolean;
         reexportedFrom?: string | undefined;
     } | undefined;
-    doctor?: {
-        available: boolean;
-    } | undefined;
-    licenses?: {
-        available: boolean;
-    } | undefined;
     compat?: {
         zephyr?: string | undefined;
     } | undefined;

package/dist/api/shared/framework-manifest.js

@@ -84,6 +84,7 @@ const ToolchainCoverageSchema = z.object({
         compile: z.boolean(),
         upload: z.boolean(),
         monitor: z.boolean(),
+        debug: z.boolean().optional(),
     }),
     reexportedFrom: z.string().optional(),
 });

package/dist/cli.js

@@ -442,6 +442,12 @@ async function main() {
         let effectiveFrameworkPackage = options.frameworkPackage;
         let effectiveMcuPackage;
         let effectivePort = options.port;
+        // CUTTLEFISH_PORT env var sits between the CLI flag and the config file
+        // (flag > env > config), so cross-platform uploads don't need a
+        // Windows-specific COM port baked into package.json scripts.
+        if (!effectivePort && process.env.CUTTLEFISH_PORT) {
+            effectivePort = process.env.CUTTLEFISH_PORT;
+        }
         if (config) {
             if (config.mcu) {
                 effectiveMcuPackage = config.mcu;

package/dist/config-loader.d.ts

@@ -52,6 +52,14 @@ export interface ResolvedCuttlefishConfig {
  * Returns the absolute path on success, `undefined` if none is found.
  */
 export declare function findConfigFile(startDir: string): string | undefined;
+/**
+ * Warn about config values the AST-only parser cannot evaluate. The loader
+ * deliberately never runs user code (no ts-node / dynamic import), so only
+ * inline literals survive extraction; without these warnings a value like
+ * `libraries: sdlLibraries` (an identifier) used to vanish silently and
+ * surface later as an opaque link error.
+ */
+export type ConfigDropWarning = (message: string) => void;
 /**
  *
  * The file must have a default export whose initializer is an object literal.