@typecad/framework-zephyr 1.0.0-alpha.16 → 1.0.0-alpha.19

package/dist/toolchain/env-check.d.ts

@@ -40,7 +40,7 @@ export interface ZephyrEnvCheck {
     compatRange: string | undefined;
     /** Result of the compat-range check against the detected version. */
     compatStatus: CompatStatus;
-    /** Raw board target from cuttlefish.config.ts, if configured. */
+    /** Raw board target from typecad-hal.config.ts, if configured. */
     buildTarget: string | undefined;
     /** buildTarget normalized for the installed Zephyr version (may equal it). */
     resolvedBoardTarget: string | undefined;
@@ -61,8 +61,6 @@ export type ZephyrEnvFailure = {
     fixCommand: string | undefined;
 };
 export type ZephyrEnvResult = ZephyrEnvOk | ZephyrEnvFailure;
-/** Clear the west-probe cache (for tests). Also resets discovery cache. */
-export declare function resetWestProbeCacheForTest(): void;
 /**
  * Gather west facts: discover a usable install, then run `west --version`
  * through it to capture the version. Memoized for the process lifetime (west

package/dist/toolchain/env-check.js

@@ -1,5 +1,5 @@
 // ---------------------------------------------------------------------------
-// Zephyr environment check — the shared detection behind `cuttlefish doctor`.
+// Zephyr environment check — the shared detection behind `typecad-hal doctor`.
 //
 // Zephyr environment check: gather the impure
 // environment facts once (west presence + version, Zephyr version, board
@@ -21,16 +21,11 @@
 import { spawnSync } from 'node:child_process';
 import { existsSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
-import { discoverWest, resetWestDiscoveryCache } from './west-discover.js';
+import { discoverWest } from './west-discover.js';
 import { westSpawn } from './west-spawn.js';
 import { detectZephyrVersion, checkZephyrCompat, resolveBoardTarget, } from './compat.js';
 // ---- west probe (impure; isolated + cached + overridable) ------------------
 let cachedProbe;
-/** Clear the west-probe cache (for tests). Also resets discovery cache. */
-export function resetWestProbeCacheForTest() {
-    cachedProbe = undefined;
-    resetWestDiscoveryCache();
-}
 /**
  * Gather west facts: discover a usable install, then run `west --version`
  * through it to capture the version. Memoized for the process lifetime (west

package/dist/toolchain/index.d.ts

@@ -1,5 +1,14 @@
 import type { ToolchainOptions, CompileResult, UploadResult } from '@typecad/cuttlefish/api/shared';
 import type { ZephyrChipDescriptor } from '../chips/types.js';
+export declare function scanMatrix(src: string): {
+    rows: number[];
+    cols: number[];
+} | undefined;
+export declare function scanHid(src: string): 'keyboard' | 'mouse' | undefined;
+export declare function scanStrips(src: string): Array<{
+    index: number;
+    count: number;
+}>;
 /**
  * Distinct DT-bound sensors the emitted sources reference — the lowering's
  * state blocks name each one `__tc_sensor_<part>_i2c<N>_0x<addr>_dev`
@@ -11,10 +20,12 @@ export interface ScannedSensorPart {
     part: string;
     busIndex: number;
     port: number;
-    busKind: 'i2c' | 'spi';
+    busKind: 'i2c' | 'spi' | 'w1';
     spiHz: number;
     spiMode: number;
     alertPin: number;
+    /** 1-Wire parts: the converter resolution in bits. */
+    resolution: number;
 }
 export interface ScannedSpiTarget {
     busIndex: number;
@@ -28,7 +39,7 @@ export interface ScannedSpiTarget {
 export declare function scanSpiTargets(src: string): ScannedSpiTarget[];
 export declare function scanSensorParts(src: string): ScannedSensorPart[];
 /**
- * Derive the Zephyr project root from the cuttlefish-emitted source path.
+ * Derive the Zephyr project root from the typecad-hal-emitted source path.
  *
  * Cuttlefish emits `src/main.cpp` under the output dir. The CLI passes
  * `sourcePath` = full path to `main.cpp` and `outputDir` = its parent (`src/`).
@@ -43,7 +54,7 @@ export declare function projectRootFromOptions(o: ToolchainOptions): string;
  * runner for its hardware (xiao_ble → nrfutil, esp32* → esptool), and `west
  * flash` resolves it automatically. The framework only intervenes where the
  * board default needs an argument it can't infer:
- *   - An explicit `zephyr.runner` (from cuttlefish.config.ts) always wins.
+ *   - An explicit `zephyr.runner` (from typecad-hal.config.ts) always wins.
  *   - ESP32 boards forward the port via `--esp-device` (esptool reads the
  *     device from it); board.cmake still picks the runner.
  *   - Every other board trusts the board.cmake default. Previously this forced
@@ -78,6 +89,15 @@ export type ProbeResolution = {
     ok: false;
     error: string;
 };
+/**
+ * The board a cached build dir was configured for (CMakeCache.txt's
+ * BOARD:STRING — the exact value passed to `west build -b`), or undefined
+ * when no cache exists. compile() compares it against the requested board
+ * and nukes the dir on mismatch: `west build`'s --pristine=auto covers
+ * cmake/config churn, NOT a board switch — west aborts with "refusing to
+ * proceed without --force", and cuttlefish doesn't forward that flag.
+ */
+export declare function cachedBuildBoard(buildDir: string): string | undefined;
 export declare function resolveProbeMethod(zc: Record<string, unknown> | undefined, chip: ZephyrChipDescriptor, purpose?: 'flash' | 'debug'): ProbeResolution;
 /**
  * Run an openocd session against the board's probe config — the shared
@@ -197,4 +217,9 @@ export declare const Toolchain: {
     upload(o: ToolchainOptions): UploadResult;
     monitor(o: ToolchainOptions): void;
     debug(o: ToolchainOptions): void;
+    debugServer(o: ToolchainOptions, action: "start" | "stop"): void;
 };
+/** How long `--monitor` waits for the port to (re)appear after a flash reset. */
+export declare const MONITOR_PORT_WAIT_MS = 8000;
+/** argv for the pyserial port wait — exported for the toolchain unit tests. */
+export declare function serialPortWaitArgs(port: string, timeoutMs: number): string[];