@typecad/cuttlefish 0.1.0-alpha.2 → 1.0.0-alpha.3

package/README.md

@@ -3,7 +3,7 @@
 TypeScript → C++ transpiler for embedded firmware. Targets native (desktop),
 Arduino, and bare-metal MCU builds from a single TypeScript codebase.
 
-`cuttlefish` is the command-line tool at the center of the [TypeCAD](https://github.com/justind000/typecode)
+`cuttlefish` is the command-line tool at the center of the [TypeCAD](https://cuttlefish.typecad.net)
 toolchain: it loads `cuttlefish.config.ts`, transpiles TypeScript firmware to
 C++, and can chain compile, upload, and serial-monitor steps.
 
@@ -67,11 +67,11 @@ export default config;
 
 `@typecad/cuttlefish` is the transpiler core. It pairs with sibling packages:
 
-- [`@typecad/hal`](https://github.com/justind000/typecode/tree/main/packages/hal) — hardware abstraction (GPIO, I2C, SPI, UART) as regular TypeScript.
-- [`@typecad/ui`](https://github.com/justind000/typecode/tree/main/packages/ui) — HTML/CSS-driven graphics for microcontroller displays.
-- [`@typecad/expect`](https://github.com/justind000/typecode/tree/main/packages/expect) — hardware test framework (vitest-style assertions over serial).
-- [`@typecad/framework-arduino`](https://github.com/justind000/typecode/tree/main/packages/framework-arduino) — Arduino framework code-gen strategy.
-- [`@typecad/framework-native`](https://github.com/justind000/typecode/tree/main/packages/framework-native) — native desktop C++ code-gen strategy.
+- [`@typecad/hal`](https://cuttlefish.typecad.net) — hardware abstraction (GPIO, I2C, SPI, UART) as regular TypeScript.
+- [`@typecad/ui`](https://cuttlefish.typecad.net) — HTML/CSS-driven graphics for microcontroller displays.
+- [`@typecad/expect`](https://cuttlefish.typecad.net) — hardware test framework (vitest-style assertions over serial).
+- [`@typecad/framework-arduino`](https://cuttlefish.typecad.net) — Arduino framework code-gen strategy.
+- [`@typecad/framework-native`](https://cuttlefish.typecad.net) — native desktop C++ code-gen strategy.
 - `@typecad/mcu-*` and `@typecad/board-*` — silicon- and board-level pin/peripheral definitions.
 
 ## License

package/dist/api/board-types.d.ts

@@ -1 +1 @@
-export type ArchitectureIdentifier = 'avr' | 'esp32' | 'esp32s2' | 'esp32s3' | 'esp32c3' | 'esp32c6' | 'rp2040' | 'samd' | 'stm32' | 'nrf52' | (string & {});
+export type ArchitectureIdentifier = 'avr' | 'esp32' | 'esp32s2' | 'esp32s3' | 'esp32c3' | 'esp32c6' | 'rp2040' | 'rp2350' | 'samd' | 'stm32' | 'nrf52' | (string & {});

package/dist/api/shared/platform-strategy.d.ts

@@ -8,6 +8,12 @@ import type { PlatformGraphicsStrategy } from './graphics-strategy.js';
 export interface PlatformProfileStrategy {
     /** System #include headers forced at the top of every emitted file. */
     forcedIncludes(program: ProgramIR, ctx?: PlatformContext): string[];
+    /**
+     * Filter the HAL-discovered required includes (from __includes metadata).
+     * Frameworks that provide native peripheral drivers can strip stale Arduino
+     * library includes here. Defaults to returning the includes unchanged.
+     */
+    filterRequiredIncludes?(includes: string[]): string[];
     /** Symbol aliases (TypeScript name → C++ name). */
     symbolAliases(program: ProgramIR, ctx?: PlatformContext): Record<string, string>;
     /** Extra shim lines emitted after includes (e.g. #define fallbacks). */

package/dist/cli.js

@@ -361,6 +361,9 @@ async function main() {
                 });
                 printDiagnostics(result.diagnostics);
                 ui.printTasks(result.asyncTaskNames ?? [], result.usesTimers ?? false);
+                if (result.diagnosticsReportPath) {
+                    ui.printInfo(`Diagnostics report: ${result.diagnosticsReportPath}`);
+                }
                 if (result.diagnostics.length === 0) {
                     ui.printSuccess();
                     initialBuildOk = true;
@@ -451,6 +454,9 @@ async function main() {
                         });
                         printDiagnostics(rebuildResult.diagnostics);
                         ui.printTasks(rebuildResult.asyncTaskNames ?? [], rebuildResult.usesTimers ?? false);
+                        if (rebuildResult.diagnosticsReportPath) {
+                            ui.printInfo(`Diagnostics report: ${rebuildResult.diagnosticsReportPath}`);
+                        }
                         if (rebuildResult.diagnostics.length > 0) {
                             // Errors shown via printDiagnostics — skip compile/upload
                         }
@@ -535,6 +541,9 @@ async function main() {
             });
             printDiagnostics(result.diagnostics);
             ui.printTasks(result.asyncTaskNames ?? [], result.usesTimers ?? false);
+            if (result.diagnosticsReportPath) {
+                ui.printInfo(`Diagnostics report: ${result.diagnosticsReportPath}`);
+            }
         }
         if (hasFatalDiagnostics(result)) {
             ui.printError("Transpilation failed. Fix the transpiler diagnostics above before compiling.");

package/dist/create/init-scaffold.js

@@ -66,6 +66,28 @@ const _knownTargets = [
         buildTarget: 'esp32:esp32:esp32c6',
         mcu: 'esp32c6',
     },
+    {
+        id: 'rp2040',
+        displayName: 'RP2040 (Pico)',
+        isNative: false,
+        architecture: 'rp2040',
+        boardPackage: '@typecad/board-rp2040',
+        frameworkPackage: '@typecad/framework-arduino',
+        framework: 'arduino',
+        buildTarget: 'rp2040:rp2040:rpipico',
+        mcu: 'rp2040',
+    },
+    {
+        id: 'rp2350',
+        displayName: 'RP2350 (Pico 2)',
+        isNative: false,
+        architecture: 'rp2350',
+        boardPackage: '@typecad/board-rp2350',
+        frameworkPackage: '@typecad/framework-arduino',
+        framework: 'arduino',
+        buildTarget: 'rp2040:rp2040:rpipico2',
+        mcu: 'rp2350',
+    },
 ];
 export function registerKnownTarget(target) {
     const existing = _knownTargets.findIndex(t => t.id === target.id);

package/dist/emit/emitters/setup.js

@@ -715,7 +715,13 @@ export function buildEmitterContext(program, options) {
         includes.push(...emittedPolyfills.includes.map((include) => normalizeInclude(include)));
     }
     if (program.requiredIncludes) {
-        includes.push(...program.requiredIncludes);
+        let reqIncludes = [...program.requiredIncludes];
+        // Let the strategy strip stale includes (e.g. framework-avr removes
+        // Arduino library headers it doesn't need — Wire.h, SPI.h, etc.).
+        if (strategy.filterRequiredIncludes) {
+            reqIncludes = strategy.filterRequiredIncludes(reqIncludes);
+        }
+        includes.push(...reqIncludes);
     }
     // UI text bindings lower to snprintf bodies that need <stdio.h>. Pushed here
     // (in buildEmitterContext) rather than in emitUIRuntime because emitPreamble

package/dist/transpile.js

@@ -689,6 +689,7 @@ export async function transpileFile(options) {
     profiler.endTimer("post:flatten");
     // Profiler session ends (profiling disabled - no report generation)
     // ── Generate diagnostics report if enabled ──────────────────────────────
+    let diagnosticsReportPath;
     if (options.diagnostics) {
         try {
             const entryPreBuilt = preBuilt.get(entryFile);
@@ -708,17 +709,23 @@ export async function transpileFile(options) {
                 removedSymbols: allRemovedSymbols,
             });
             writeDiagnosticsReport(report, entryPreBuilt?.programIR ?? null, outDir);
+            diagnosticsReportPath = path.join(outDir, "diagnostics.md");
         }
         catch (e) {
-            // Diagnostics report generation is best-effort; don't fail the build
-            if (options.debug) {
-                logDebug(`Diagnostics report generation failed: ${e instanceof Error ? e.message : String(e)}`, true);
-            }
+            // Diagnostics report generation is best-effort; don't fail the build,
+            // but surface the failure so the user knows --diagnostics didn't work.
+            diagnostics.push({
+                severity: "warning",
+                message: `Diagnostics report generation failed: ${e instanceof Error ? e.message : String(e)}`,
+                code: "diagnostics-report-failed",
+                source: "transpile",
+            });
         }
     }
     return {
         ...entryOutputs,
         diagnostics,
+        diagnosticsReportPath,
     };
 }
 export function generateLibraryDefinitions(options) {

package/dist/types.d.ts

@@ -181,6 +181,8 @@ export interface GeneratedOutputs {
     diagnostics: Diagnostic[];
     asyncTaskNames?: string[];
     usesTimers?: boolean;
+    /** Path to the diagnostics.md report, if --diagnostics was passed. */
+    diagnosticsReportPath?: string;
 }
 interface CompileErrorEntry {
     filePath: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typecad/cuttlefish",
-  "version": "0.1.0-alpha.2",
+  "version": "1.0.0-alpha.3",
   "description": "TypeScript to C++ transpiler — native, Arduino, and bare-metal targets",
   "type": "module",
   "main": "./dist/transpile.js",
@@ -83,7 +83,7 @@
     "zod": "^3.24.0"
   },
   "peerDependencies": {
-    "@typecad/ui": "0.1.0-alpha.2"
+    "@typecad/ui": "1.0.0-alpha.3"
   },
   "peerDependenciesMeta": {
     "@typecad/ui": {
@@ -91,7 +91,7 @@
     }
   },
   "optionalDependencies": {
-    "@typecad/framework-native": "0.1.0-alpha.2"
+    "@typecad/framework-native": "1.0.0-alpha.3"
   },
   "devDependencies": {
     "@types/node": "^22.10.7"