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

package/dist/add-preset.d.ts

@@ -0,0 +1,4 @@
+import type { AddCommandOptions } from "./types.js";
+export declare function listAddPresets(): string;
+/** Run `cuttlefish add <preset>`: copy the preset into the project. */
+export declare function runAddPreset(options: AddCommandOptions): void;

package/dist/add-preset.js

@@ -0,0 +1,74 @@
+// ---------------------------------------------------------------------------
+// `cuttlefish add <preset>` — scaffold copy-and-own assets into a project.
+//
+// Presets are files shipped with the package under assets/. The command COPIES
+// them into the user's project (never injected at build time): the user owns
+// the file from day one and the build only reads what they reference. This is
+// the same philosophy as shadcn/ui — components as source you keep, not a
+// runtime dependency.
+// ---------------------------------------------------------------------------
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadShadcnTheme, applyShadcnTheme } from "./theme-tokens.js";
+import chalk from "chalk";
+const ASSETS_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../assets");
+const PRESETS = {
+    shadcn: {
+        source: "shadcn/shadcn.css",
+        dest: "src/styles/shadcn.css",
+        description: "shadcn-style CSS variable tokens + component class recipes (buttons, cards, badges, alerts, ...)",
+        nextSteps: [
+            `Link it from a stylesheet (sibling .ui.css file or a <style> block):`,
+            ``,
+            `    @import "./styles/shadcn.css";`,
+            ``,
+            `Then use the classes on native elements:`,
+            `    <button class="btn btn-primary">Save</button>`,
+            `    <view class="card"> ... <text class="card-title">Title</text> ... </view>`,
+            ``,
+            `Dark theme: the file defines a .dark token set — activate it with`,
+            `themeClass: 'dark' in cuttlefish.config.ts's display block.`,
+            `The file is yours: tune tokens and prune recipes freely.`,
+            ``,
+            `Themes: start from an included one with --theme <name>`,
+            `(see \`cuttlefish theme\` for the list); swap later with the same command.`,
+        ],
+    },
+};
+export function listAddPresets() {
+    return Object.entries(PRESETS).map(([id, p]) => `  ${id.padEnd(10)} ${p.description}`).join("\n");
+}
+/** Run `cuttlefish add <preset>`: copy the preset into the project. */
+export function runAddPreset(options) {
+    const preset = PRESETS[options.preset];
+    if (!preset) {
+        throw new Error(`Unknown preset "${options.preset}". Available presets:\n${listAddPresets()}`);
+    }
+    const src = path.join(ASSETS_DIR, preset.source);
+    if (!fs.existsSync(src)) {
+        throw new Error(`Preset asset missing from the cuttlefish package: ${src}`);
+    }
+    const dest = path.resolve(options.projectRoot, preset.dest);
+    if (fs.existsSync(dest) && !options.force) {
+        throw new Error(`${dest} already exists — re-run with --force to overwrite (your edits will be lost).`);
+    }
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(src, dest);
+    // --theme <name>: merge an included shadcn theme's tokens into the copied
+    // stylesheet (shadcn preset only; no-op for future presets without themes).
+    if (options.theme) {
+        if (options.preset !== "shadcn") {
+            throw new Error(`--theme applies to the shadcn preset only (got "${options.preset}").`);
+        }
+        const theme = loadShadcnTheme(options.theme, options.projectRoot);
+        fs.writeFileSync(dest, applyShadcnTheme(fs.readFileSync(dest, "utf-8"), theme), "utf-8");
+        console.log(chalk.green(`✓`) + ` Theme ${chalk.cyan(theme.name)} tokens merged into the copied file.`);
+    }
+    console.log(chalk.green(`✓`) + ` Added preset ${chalk.cyan(options.preset)} → ${path.relative(options.projectRoot, dest)}`);
+    console.log();
+    console.log(chalk.bold(`Next steps:`));
+    for (const line of preset.nextSteps) {
+        console.log(line ? `  ${line}` : ``);
+    }
+}

package/dist/api/config.d.ts

@@ -2,8 +2,6 @@ import type { ArchitectureIdentifier } from './board-types.js';
 import type { DisplayConfig } from './shared/display-profile.js';
 /** Build-system / framework the transpiler should target. */
 type OutputFramework = string & {};
-/** Optimization strategy. */
-type OptimizationLevel = 'none' | 'size' | 'speed' | 'balanced';
 /**
  * Output section — controls how generated C++ is laid out.
  */
@@ -14,8 +12,6 @@ interface CuttlefishOutputConfig {
      * Matches the optional Zod `output.framework` in config-schema.ts.
      */
     framework?: OutputFramework;
-    /** Optimization level. */
-    optimize?: OptimizationLevel;
     /** Directory to write generated files into (relative to project root). */
     outDir?: string;
     /** Additional compiler defines (KEY = value). */
@@ -40,8 +36,15 @@ export interface CuttlefishZephyrConfig {
     kconfig?: Record<string, string>;
     /** Extra arguments forwarded to `west build`. */
     cmakeArgs?: string[];
-    /** Override the west flash runner (e.g. 'nrfjprog', 'jlink'). */
+    /** Override the west flash runner (e.g. 'nrfjprog', 'jlink', 'openocd'). */
     runner?: string;
+    /**
+     * Extra arguments appended verbatim to `west flash` after the runner —
+     * anything the chosen runner's parser accepts. Example for an ST-Link
+     * clone with no SRST line wired to the target:
+     *   runnerArgs: ['--cmd-pre-init=reset_config none']
+     */
+    runnerArgs?: string[];
 }
 /**
  * Root configuration object exported from `cuttlefish.config.ts`.

package/dist/api/shared/display-adapters/sdl.js

@@ -323,7 +323,7 @@ export const sdlAdapter = (display) => {
             `    __tc_display.put(dx, dy, pixels[i]);`,
             `  }`,
             `}`,
-            `static inline CuttlefishCanvas16* display_createCanvas(int16_t w, int16_t h) { return new SdlGfxCanvas(w, h); }`,
+            `static inline CuttlefishCanvas16* display_createCanvas(int16_t w, int16_t h) { return new (std::nothrow) SdlGfxCanvas(w, h); }`,
             `static inline CuttlefishCanvas16* display_createCanvasPsram(int16_t, int16_t) { return nullptr; }`,
             `static inline void display_deleteCanvas(CuttlefishCanvas16* c) { delete c; }`,
             `static inline int16_t display_canvasWidth(CuttlefishCanvas16* c) { return c->width(); }`,

package/dist/api/shared/display-profile.d.ts

@@ -86,6 +86,11 @@ export interface DisplayProfile {
      * is read, so a missing/unsafe readback path must not affect normal drawing.
      */
     scanlineSync?: boolean;
+    /** Tearing-effect (TE) sync, hardware variant: GPIO number of the panel's
+     *  TE output. Opt-in — few off-the-shelf display boards break the pin out.
+     *  When wired, panel updates wait for the TE frame pulse instead of the
+     *  GET_SCANLINE readback (no MISO needed; see also scanlineSync). */
+    tearingEffectPin?: number;
     touch?: TouchProfile;
     /** Enable antialiased rendering for circles, lines, rounded corners, and text
      *  unless a node opts out with font-smoothing:none.
@@ -158,6 +163,12 @@ export interface DisplayConfig {
      * default because some ST7796S modules misbehave when this command is read.
      */
     scanlineSync?: boolean;
+    /** Tearing-effect (TE) hardware sync: GPIO number of the panel's TE output
+     *  (ST7796S TE / ILI9341 TE pin). Strictly opt-in — few off-the-shelf
+     *  display boards break the pin out. When wired, panel updates arm on the
+     *  TE frame pulse (tear-free writes, no MISO readback); the Zephyr overlay
+     *  emits te-gpios on the display DT node and the adapter raises TEON. */
+    tearingEffectPin?: number;
     touch?: TouchProfile | false;
     cs?: number;
     dc?: number;

package/dist/api/shared/display-profile.js

@@ -81,6 +81,7 @@ export function resolveDisplayProfile(config, registry) {
             spiPins: config.spiPins,
             colorOrder: config.colorOrder,
             invertDisplay: config.invertDisplay,
+            tearingEffectPin: config.tearingEffectPin,
             touch: config.touch === false ? undefined : config.touch,
             displayClass: config.displayClass,
             capabilities: config.capabilities,
@@ -112,6 +113,8 @@ export function resolveDisplayProfile(config, registry) {
         base.colorOrder = config.colorOrder;
     if (config.invertDisplay !== undefined)
         base.invertDisplay = config.invertDisplay;
+    if (config.tearingEffectPin !== undefined)
+        base.tearingEffectPin = config.tearingEffectPin;
     if (config.scanlineSync !== undefined)
         base.scanlineSync = config.scanlineSync;
     if (config.touch === false)