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

package/dist/create/board-spec.d.ts

@@ -44,10 +44,10 @@ export declare const BoardSpecSchema: z.ZodObject<{
             instance: number;
             role: string;
         }[] | undefined;
+        notes?: string | undefined;
         alt?: string[] | undefined;
         warnings?: string[] | undefined;
         unsafe?: boolean | undefined;
-        notes?: string | undefined;
         onboardLed?: boolean | undefined;
     }, {
         gpio: number;
@@ -57,10 +57,10 @@ export declare const BoardSpecSchema: z.ZodObject<{
             instance: number;
             role: string;
         }[] | undefined;
+        notes?: string | undefined;
         alt?: string[] | undefined;
         warnings?: string[] | undefined;
         unsafe?: boolean | undefined;
-        notes?: string | undefined;
         onboardLed?: boolean | undefined;
     }>, "many">;
     unsafe: z.ZodArray<z.ZodString, "many">;
@@ -75,21 +75,21 @@ export declare const BoardSpecSchema: z.ZodObject<{
         tx: z.ZodOptional<z.ZodString>;
         rx: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
-        sda?: string | undefined;
-        scl?: string | undefined;
+        cs?: string | undefined;
         mosi?: string | undefined;
-        miso?: string | undefined;
         sck?: string | undefined;
-        cs?: string | undefined;
+        miso?: string | undefined;
+        sda?: string | undefined;
+        scl?: string | undefined;
         tx?: string | undefined;
         rx?: string | undefined;
     }, {
-        sda?: string | undefined;
-        scl?: string | undefined;
+        cs?: string | undefined;
         mosi?: string | undefined;
-        miso?: string | undefined;
         sck?: string | undefined;
-        cs?: string | undefined;
+        miso?: string | undefined;
+        sda?: string | undefined;
+        scl?: string | undefined;
         tx?: string | undefined;
         rx?: string | undefined;
     }>>;
@@ -103,21 +103,21 @@ export declare const BoardSpecSchema: z.ZodObject<{
         tx: z.ZodOptional<z.ZodString>;
         rx: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
-        sda?: string | undefined;
-        scl?: string | undefined;
+        cs?: string | undefined;
         mosi?: string | undefined;
-        miso?: string | undefined;
         sck?: string | undefined;
-        cs?: string | undefined;
+        miso?: string | undefined;
+        sda?: string | undefined;
+        scl?: string | undefined;
         tx?: string | undefined;
         rx?: string | undefined;
     }, {
-        sda?: string | undefined;
-        scl?: string | undefined;
+        cs?: string | undefined;
         mosi?: string | undefined;
-        miso?: string | undefined;
         sck?: string | undefined;
-        cs?: string | undefined;
+        miso?: string | undefined;
+        sda?: string | undefined;
+        scl?: string | undefined;
         tx?: string | undefined;
         rx?: string | undefined;
     }>>;
@@ -131,21 +131,21 @@ export declare const BoardSpecSchema: z.ZodObject<{
         tx: z.ZodOptional<z.ZodString>;
         rx: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
-        sda?: string | undefined;
-        scl?: string | undefined;
+        cs?: string | undefined;
         mosi?: string | undefined;
-        miso?: string | undefined;
         sck?: string | undefined;
-        cs?: string | undefined;
+        miso?: string | undefined;
+        sda?: string | undefined;
+        scl?: string | undefined;
         tx?: string | undefined;
         rx?: string | undefined;
     }, {
-        sda?: string | undefined;
-        scl?: string | undefined;
+        cs?: string | undefined;
         mosi?: string | undefined;
-        miso?: string | undefined;
         sck?: string | undefined;
-        cs?: string | undefined;
+        miso?: string | undefined;
+        sda?: string | undefined;
+        scl?: string | undefined;
         tx?: string | undefined;
         rx?: string | undefined;
     }>>;
@@ -230,18 +230,18 @@ export declare const BoardSpecSchema: z.ZodObject<{
         maxValue: z.ZodNumber;
         referenceVoltages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     }, "strict", z.ZodTypeAny, {
+        maxValue: number;
         instance: number;
         channels: number;
         resolution: number;
         referenceVoltage: number;
-        maxValue: number;
         referenceVoltages?: Record<string, number> | undefined;
     }, {
+        maxValue: number;
         instance: number;
         channels: number;
         resolution: number;
         referenceVoltage: number;
-        maxValue: number;
         referenceVoltages?: Record<string, number> | undefined;
     }>, "many">;
     pwm: z.ZodObject<{
@@ -273,14 +273,14 @@ export declare const BoardSpecSchema: z.ZodObject<{
         bits: z.ZodUnion<[z.ZodLiteral<8>, z.ZodLiteral<16>, z.ZodLiteral<32>, z.ZodLiteral<64>]>;
         features: z.ZodOptional<z.ZodArray<z.ZodEnum<["pwm", "capture", "compare", "interrupt", "dma"]>, "many">>;
     }, "strict", z.ZodTypeAny, {
+        bits: 8 | 16 | 32 | 64;
         type: "general" | "high_speed" | "rtc" | "sys";
         instance: number;
-        bits: 8 | 16 | 32 | 64;
         features?: ("pwm" | "capture" | "compare" | "interrupt" | "dma")[] | undefined;
     }, {
+        bits: 8 | 16 | 32 | 64;
         type: "general" | "high_speed" | "rtc" | "sys";
         instance: number;
-        bits: 8 | 16 | 32 | 64;
         features?: ("pwm" | "capture" | "compare" | "interrupt" | "dma")[] | undefined;
     }>, "many">;
     wifi: z.ZodObject<{
@@ -365,68 +365,42 @@ export declare const BoardSpecSchema: z.ZodObject<{
     }>;
 }, "strict", z.ZodTypeAny, {
     architecture: string;
-    mcuId: string;
-    mcuName: string;
-    boardId: string;
-    boardName: string;
-    vendor: string;
-    clockSpeed: number;
-    fqbn: string;
-    arduinoDefine: string;
-    moduleFlash: number | null;
-    externalRam: number | null;
-    gpioRange: [number, number];
-    excludedGpio: number[];
-    pins: {
-        gpio: number;
-        capabilities: "FULL_GPIO" | "FULL_GPIO_ANALOG" | "FULL_GPIO_TOUCH" | "FULL_GPIO_ANALOG_TOUCH" | "FULL_GPIO_DAC" | "INPUT_ONLY";
-        functions?: {
-            type: "i2c" | "spi" | "uart" | "adc" | "dac" | "pwm" | "touch" | "usb";
-            instance: number;
-            role: string;
-        }[] | undefined;
-        alt?: string[] | undefined;
-        warnings?: string[] | undefined;
-        unsafe?: boolean | undefined;
-        notes?: string | undefined;
-        onboardLed?: boolean | undefined;
-    }[];
     i2c: Record<string, {
-        sda?: string | undefined;
-        scl?: string | undefined;
+        cs?: string | undefined;
         mosi?: string | undefined;
-        miso?: string | undefined;
         sck?: string | undefined;
-        cs?: string | undefined;
+        miso?: string | undefined;
+        sda?: string | undefined;
+        scl?: string | undefined;
         tx?: string | undefined;
         rx?: string | undefined;
     }>;
     spi: Record<string, {
-        sda?: string | undefined;
-        scl?: string | undefined;
+        cs?: string | undefined;
         mosi?: string | undefined;
-        miso?: string | undefined;
         sck?: string | undefined;
-        cs?: string | undefined;
+        miso?: string | undefined;
+        sda?: string | undefined;
+        scl?: string | undefined;
         tx?: string | undefined;
         rx?: string | undefined;
     }>;
     uart: Record<string, {
-        sda?: string | undefined;
-        scl?: string | undefined;
+        cs?: string | undefined;
         mosi?: string | undefined;
-        miso?: string | undefined;
         sck?: string | undefined;
-        cs?: string | undefined;
+        miso?: string | undefined;
+        sda?: string | undefined;
+        scl?: string | undefined;
         tx?: string | undefined;
         rx?: string | undefined;
     }>;
     adc: {
+        maxValue: number;
         instance: number;
         channels: number;
         resolution: number;
         referenceVoltage: number;
-        maxValue: number;
         referenceVoltages?: Record<string, number> | undefined;
     }[];
     pwm: {
@@ -439,6 +413,37 @@ export declare const BoardSpecSchema: z.ZodObject<{
         vid: string;
         pid: string;
     };
+    wifi: {
+        type: "wifi" | "wifi6";
+        supportsStation: boolean;
+        supportsAp: boolean;
+    };
+    mcuId: string;
+    mcuName: string;
+    boardId: string;
+    boardName: string;
+    vendor: string;
+    clockSpeed: number;
+    fqbn: string;
+    arduinoDefine: string;
+    moduleFlash: number | null;
+    externalRam: number | null;
+    gpioRange: [number, number];
+    excludedGpio: number[];
+    pins: {
+        gpio: number;
+        capabilities: "FULL_GPIO" | "FULL_GPIO_ANALOG" | "FULL_GPIO_TOUCH" | "FULL_GPIO_ANALOG_TOUCH" | "FULL_GPIO_DAC" | "INPUT_ONLY";
+        functions?: {
+            type: "i2c" | "spi" | "uart" | "adc" | "dac" | "pwm" | "touch" | "usb";
+            instance: number;
+            role: string;
+        }[] | undefined;
+        notes?: string | undefined;
+        alt?: string[] | undefined;
+        warnings?: string[] | undefined;
+        unsafe?: boolean | undefined;
+        onboardLed?: boolean | undefined;
+    }[];
     unsafe: string[];
     analog: string[];
     peripheralInstances: {
@@ -459,9 +464,9 @@ export declare const BoardSpecSchema: z.ZodObject<{
         }[];
     };
     timers: {
+        bits: 8 | 16 | 32 | 64;
         type: "general" | "high_speed" | "rtc" | "sys";
         instance: number;
-        bits: 8 | 16 | 32 | 64;
         features?: ("pwm" | "capture" | "compare" | "interrupt" | "dma")[] | undefined;
     }[];
     features: {
@@ -473,11 +478,6 @@ export declare const BoardSpecSchema: z.ZodObject<{
         hardwareRng: boolean;
         fpu: boolean;
     };
-    wifi: {
-        type: "wifi" | "wifi6";
-        supportsStation: boolean;
-        supportsAp: boolean;
-    };
     bluetooth: {
         type: "classic" | "ble" | "dual";
         version: string;
@@ -489,75 +489,49 @@ export declare const BoardSpecSchema: z.ZodObject<{
         externalRam?: number | undefined;
         rtcMemory?: number | undefined;
     };
-    description?: string | undefined;
     touch?: {
         pins: string[];
         channels: number;
     } | null | undefined;
+    description?: string | undefined;
 }, {
     architecture: string;
-    mcuId: string;
-    mcuName: string;
-    boardId: string;
-    boardName: string;
-    vendor: string;
-    clockSpeed: number;
-    fqbn: string;
-    arduinoDefine: string;
-    moduleFlash: number | null;
-    externalRam: number | null;
-    gpioRange: [number, number];
-    excludedGpio: number[];
-    pins: {
-        gpio: number;
-        capabilities: "FULL_GPIO" | "FULL_GPIO_ANALOG" | "FULL_GPIO_TOUCH" | "FULL_GPIO_ANALOG_TOUCH" | "FULL_GPIO_DAC" | "INPUT_ONLY";
-        functions?: {
-            type: "i2c" | "spi" | "uart" | "adc" | "dac" | "pwm" | "touch" | "usb";
-            instance: number;
-            role: string;
-        }[] | undefined;
-        alt?: string[] | undefined;
-        warnings?: string[] | undefined;
-        unsafe?: boolean | undefined;
-        notes?: string | undefined;
-        onboardLed?: boolean | undefined;
-    }[];
     i2c: Record<string, {
-        sda?: string | undefined;
-        scl?: string | undefined;
+        cs?: string | undefined;
         mosi?: string | undefined;
-        miso?: string | undefined;
         sck?: string | undefined;
-        cs?: string | undefined;
+        miso?: string | undefined;
+        sda?: string | undefined;
+        scl?: string | undefined;
         tx?: string | undefined;
         rx?: string | undefined;
     }>;
     spi: Record<string, {
-        sda?: string | undefined;
-        scl?: string | undefined;
+        cs?: string | undefined;
         mosi?: string | undefined;
-        miso?: string | undefined;
         sck?: string | undefined;
-        cs?: string | undefined;
+        miso?: string | undefined;
+        sda?: string | undefined;
+        scl?: string | undefined;
         tx?: string | undefined;
         rx?: string | undefined;
     }>;
     uart: Record<string, {
-        sda?: string | undefined;
-        scl?: string | undefined;
+        cs?: string | undefined;
         mosi?: string | undefined;
-        miso?: string | undefined;
         sck?: string | undefined;
-        cs?: string | undefined;
+        miso?: string | undefined;
+        sda?: string | undefined;
+        scl?: string | undefined;
         tx?: string | undefined;
         rx?: string | undefined;
     }>;
     adc: {
+        maxValue: number;
         instance: number;
         channels: number;
         resolution: number;
         referenceVoltage: number;
-        maxValue: number;
         referenceVoltages?: Record<string, number> | undefined;
     }[];
     pwm: {
@@ -570,6 +544,37 @@ export declare const BoardSpecSchema: z.ZodObject<{
         vid: string;
         pid: string;
     };
+    wifi: {
+        type: "wifi" | "wifi6";
+        supportsStation: boolean;
+        supportsAp: boolean;
+    };
+    mcuId: string;
+    mcuName: string;
+    boardId: string;
+    boardName: string;
+    vendor: string;
+    clockSpeed: number;
+    fqbn: string;
+    arduinoDefine: string;
+    moduleFlash: number | null;
+    externalRam: number | null;
+    gpioRange: [number, number];
+    excludedGpio: number[];
+    pins: {
+        gpio: number;
+        capabilities: "FULL_GPIO" | "FULL_GPIO_ANALOG" | "FULL_GPIO_TOUCH" | "FULL_GPIO_ANALOG_TOUCH" | "FULL_GPIO_DAC" | "INPUT_ONLY";
+        functions?: {
+            type: "i2c" | "spi" | "uart" | "adc" | "dac" | "pwm" | "touch" | "usb";
+            instance: number;
+            role: string;
+        }[] | undefined;
+        notes?: string | undefined;
+        alt?: string[] | undefined;
+        warnings?: string[] | undefined;
+        unsafe?: boolean | undefined;
+        onboardLed?: boolean | undefined;
+    }[];
     unsafe: string[];
     analog: string[];
     peripheralInstances: {
@@ -590,9 +595,9 @@ export declare const BoardSpecSchema: z.ZodObject<{
         }[];
     };
     timers: {
+        bits: 8 | 16 | 32 | 64;
         type: "general" | "high_speed" | "rtc" | "sys";
         instance: number;
-        bits: 8 | 16 | 32 | 64;
         features?: ("pwm" | "capture" | "compare" | "interrupt" | "dma")[] | undefined;
     }[];
     features: {
@@ -604,11 +609,6 @@ export declare const BoardSpecSchema: z.ZodObject<{
         hardwareRng: boolean;
         fpu: boolean;
     };
-    wifi: {
-        type: "wifi" | "wifi6";
-        supportsStation: boolean;
-        supportsAp: boolean;
-    };
     bluetooth: {
         type: "classic" | "ble" | "dual";
         version: string;
@@ -620,11 +620,11 @@ export declare const BoardSpecSchema: z.ZodObject<{
         externalRam?: number | undefined;
         rtcMemory?: number | undefined;
     };
-    description?: string | undefined;
     touch?: {
         pins: string[];
         channels: number;
     } | null | undefined;
+    description?: string | undefined;
 }>;
 export type BoardSpec = z.infer<typeof BoardSpecSchema>;
 export declare function parseBoardSpec(jsoncText: string): BoardSpec;

package/dist/create/debug-artifacts.d.ts

@@ -0,0 +1,20 @@
+export interface FrameworkDebugArtifactsOptions {
+    /** Framework package name (e.g. '@typecad/framework-zephyr'), if known. */
+    frameworkPackage?: string;
+    /** Absolute path to the new cuttlefish project root. */
+    workspaceRoot: string;
+    /** The framework build target (e.g. Zephyr board id), if known. */
+    buildTarget?: string;
+}
+/**
+ * Module loader for the framework package. Returns the loaded module, or
+ * undefined when it cannot be resolved. Injectable for tests.
+ */
+export type FrameworkModuleLoader = (packageName: string) => any | undefined;
+/**
+ * Generate the framework's starter debug artifacts for a new project.
+ * Returns the workspace-relative paths written (e.g. ['.vscode/launch.json']),
+ * or [] when the framework has no debug support, isn't resolvable yet, or the
+ * generator failed (warns, never throws).
+ */
+export declare function generateFrameworkDebugArtifacts(o: FrameworkDebugArtifactsOptions, loadModule?: FrameworkModuleLoader): string[];

package/dist/create/debug-artifacts.js

@@ -0,0 +1,69 @@
+// ---------------------------------------------------------------------------
+// debug-artifacts.ts — create-time framework debug profile generation
+//
+// `cuttlefish create` scaffolds a project that has never been built, so the
+// framework toolchain's post-build debug-artifact writer (e.g. Zephyr's
+// writeDebugConfig, which runs after a successful `west build --debug`) has
+// never had a chance to run. Without a .vscode/launch.json, pressing F5 in VS
+// Code just opens the "select a debugger" menu.
+//
+// Frameworks that support native debugging may export
+// `writeProjectDebugArtifacts({ workspaceRoot, buildTarget })` from their
+// package root (see @typecad/framework-zephyr). This helper loads the freshly
+// installed framework package and invokes that export — the framework decides
+// whether the target is debug-capable and what to write. Frameworks without
+// the export (or targets without native debug support) are a silent no-op.
+//
+// Everything here is best-effort: a failed or skipped generation never fails
+// `cuttlefish create`, because the first `--debug` build still writes the
+// artifacts the hard way.
+// ---------------------------------------------------------------------------
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadFrameworkPackage } from "../framework-package.js";
+const cliModuleDir = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Generate the framework's starter debug artifacts for a new project.
+ * Returns the workspace-relative paths written (e.g. ['.vscode/launch.json']),
+ * or [] when the framework has no debug support, isn't resolvable yet, or the
+ * generator failed (warns, never throws).
+ */
+export function generateFrameworkDebugArtifacts(o, loadModule) {
+    if (!o.frameworkPackage || !o.workspaceRoot)
+        return [];
+    // Default loader: prefer the new project's node_modules (populated by the
+    // create install step), then the CLI's own module location (monorepo /
+    // --no-install flows where the framework is a workspace sibling of the
+    // running cuttlefish).
+    const loader = loadModule ?? ((packageName) => {
+        for (const dir of [o.workspaceRoot, cliModuleDir]) {
+            try {
+                return loadFrameworkPackage(packageName, dir);
+            }
+            catch {
+                // not resolvable from this location — try the next
+            }
+        }
+        return undefined;
+    });
+    let mod;
+    try {
+        mod = loader(o.frameworkPackage);
+    }
+    catch {
+        return [];
+    }
+    if (!mod || typeof mod.writeProjectDebugArtifacts !== "function")
+        return [];
+    try {
+        const written = mod.writeProjectDebugArtifacts({
+            workspaceRoot: o.workspaceRoot,
+            buildTarget: o.buildTarget,
+        });
+        return Array.isArray(written) ? written.map(String) : [];
+    }
+    catch (e) {
+        console.warn(`! Debug profile generation failed: ${e.message}`);
+        return [];
+    }
+}

package/dist/create/eslint-rules-template.js

@@ -300,9 +300,12 @@ export default {
           return "";
         }
         function isContainerVar(node) {
-          if (node.type === "Identifier" && containerVars.has(node.name)) return true;
-          if (node.type === "CallExpression" && node.callee.type === "MemberExpression" && node.callee.property.type === "Identifier" && FUNCTIONAL_METHODS.has(node.callee.property.name)) return true;
-          return false;
+          // Only identifiers with a known container type count. A
+          // CallExpression receiver (e.g. arr.map(f).filter(g)) is the RESULT
+          // of a functional method — on arrays that's another array, which
+          // the transpiler lowers; treating it as a container flagged every
+          // supported method chain as an error.
+          return node.type === "Identifier" && containerVars.has(node.name);
         }
         return {
           VariableDeclarator(node) {

package/dist/create/index.d.ts

@@ -7,6 +7,8 @@ export type { ProjectInstallResult } from './install-deps.js';
 export { generateProjectPackageJson, generateProjectTsconfig, generateProjectConfig, generateProjectEnvDts, generateStarterSketch, generateStarterTest, generateStarterSim, generateGitignore, generateEslintConfig, } from './init-templates.js';
 export type { InitProjectOptions } from './init-templates.js';
 export { runInitWizard } from './init-wizard.js';
+export { generateFrameworkDebugArtifacts } from './debug-artifacts.js';
+export type { FrameworkDebugArtifactsOptions, FrameworkModuleLoader } from './debug-artifacts.js';
 export { scaffoldBoardPackages } from './board-codegen.js';
 export type { ScaffoldBoardResult } from './board-codegen.js';
 export { generateFrameworkChecklist } from './board-checklist.js';

package/dist/create/index.js

@@ -3,6 +3,7 @@ export { FRAMEWORK_CATALOG, frameworksForTarget, frameworkCatalogEntry, detectPa
 export { installProjectDependencies, __setProjectInstallRunnerForTest } from './install-deps.js';
 export { generateProjectPackageJson, generateProjectTsconfig, generateProjectConfig, generateProjectEnvDts, generateStarterSketch, generateStarterTest, generateStarterSim, generateGitignore, generateEslintConfig, } from './init-templates.js';
 export { runInitWizard } from './init-wizard.js';
+export { generateFrameworkDebugArtifacts } from './debug-artifacts.js';
 // Board codegen tool (`cuttlefish board add`)
 export { scaffoldBoardPackages } from './board-codegen.js';
 export { generateFrameworkChecklist } from './board-checklist.js';

package/dist/create/init-scaffold.d.ts

@@ -33,4 +33,5 @@ export interface ScaffoldProjectResult {
 export declare function scaffoldProject(options: InitProjectOptions, outDir?: string): ScaffoldProjectResult;
 export declare function printInitNextSteps(options: InitProjectOptions, outDir: string, opts?: {
     installed?: boolean;
+    debugProfile?: boolean;
 }): void;

package/dist/create/init-scaffold.js

@@ -168,6 +168,11 @@ export function printInitNextSteps(options, outDir, opts = {}) {
         console.log(chalk.dim(`  npm install`));
     }
     console.log(`  ${chalk.cyan("npm run compile")}`);
+    if (opts.debugProfile) {
+        console.log();
+        console.log(chalk.bold.white("To debug (VS Code):"));
+        console.log(`  ${chalk.cyan("open the folder and press F5")} ${chalk.dim("(builds + flashes, then attaches GDB)")}`);
+    }
     if (!options.isNative) {
         const portHint = process.platform === 'win32' ? 'COM4' : '/dev/ttyACM0';
         console.log();

package/dist/create/init-templates.js

@@ -149,7 +149,6 @@ const config = {
 
   // Output options
   output: {
-    optimize: 'speed',
     outDir: './out',
   },
 };
@@ -198,7 +197,6 @@ const config: CuttlefishConfig = {
   // Output / build options
   output: {
     framework: '${options.framework}',
-    optimize: 'size',
     outDir: './out',
   },