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

package/dist/types.d.ts

@@ -100,6 +100,8 @@ export interface TranspileOptions {
     autosar?: ComplianceMode;
     /** When true (and autosar is warn/strict), also emit the .autosar-deviations.arxml sidecar. */
     autosarArxml?: boolean;
+    /** Upgrade UI CSS-compatibility warnings (css-* diagnostics) to errors. */
+    strictCss?: boolean;
 }
 export interface LibraryDefinitionCondition {
     target?: TargetProfile;
@@ -179,6 +181,8 @@ export interface CommandLineOptions {
     autosar?: ComplianceMode;
     /** When true (and autosar is warn/strict), also emit the .autosar-deviations.arxml sidecar. */
     autosarArxml?: boolean;
+    /** Upgrade UI CSS-compatibility warnings (css-* diagnostics) to errors. */
+    strictCss?: boolean;
     /** Config file for preview command */
     configPath?: string;
     /** Project root (dir of cuttlefish.config.ts); passed to transpileFile for the ESLint gate. */
@@ -188,6 +192,7 @@ export interface GenerateLibdefOptions {
     inputFile: string;
     outDir: string;
 }
+/** `cuttlefish add <preset>` — scaffold a copy-and-own asset into the project. */
 export interface GeneratedOutputs {
     headerPath?: string;
     sourcePath: string;
@@ -233,4 +238,23 @@ export interface BoardAddCommandOptions {
     specPath: string;
     force?: boolean;
 }
+/** Parsed `cuttlefish library <subcommand>` options. */
+export interface LibraryCommandOptions {
+    command: "library";
+    subcommand: "search" | "install" | "init" | "validate";
+    /** Non-flag tokens after the subcommand: search text, install names, init name, validate path. */
+    positionals: string[];
+    /** search: taxonomy category id. */
+    category?: string;
+    /** init: framework id from the framework catalog. */
+    framework?: string;
+    /** init: comma-separated board-target prefixes. */
+    targets?: string;
+    /** init: scaffold directory (default ./<library-id>). */
+    dir?: string;
+    /** init: skip prompts, take defaults. */
+    yes?: boolean;
+    /** Machine-readable output for search/validate. */
+    json?: boolean;
+}
 export {};

package/dist/ui-hook.d.ts

@@ -75,6 +75,13 @@ export interface TranspilerUIHook {
         nativeDisplayActive?: boolean;
     }): string;
     splitUiFile(src: string): UiFileParts;
+    /** Pre-decode src="…" image references (png/jpg/ico/…) into the RGB565
+     *  asset cache. Must be awaited BEFORE loadUIModule/loadUIModuleFromText —
+     *  the synchronous asset reader and natural-size layout read the cache. */
+    warmUpImageDecoding(sourceText: string, baseDir: string, opts?: {
+        maxW?: number;
+        maxH?: number;
+    }): Promise<void>;
     generateProjectUITypeDeclarations(projectRoot: string): {
         written: string[];
         errors: Array<{

package/dist/utils/cli.d.ts

@@ -1,3 +1,3 @@
-import { CommandLineOptions, CreateCommandOptions, BoardAddCommandOptions } from "../types.js";
+import { CommandLineOptions, CreateCommandOptions, BoardAddCommandOptions, LibraryCommandOptions } from "../types.js";
 export declare function printHelp(): void;
-export declare function parseCommandLine(argv: string[]): CommandLineOptions | CreateCommandOptions | BoardAddCommandOptions | "help";
+export declare function parseCommandLine(argv: string[]): CommandLineOptions | CreateCommandOptions | BoardAddCommandOptions | LibraryCommandOptions | "help";

package/dist/utils/cli.js

@@ -20,6 +20,15 @@ export function printHelp() {
     console.log(`  cuttlefish doctor                              Check the active framework's environment (e.g. toolchain + board core)`);
     console.log(`  cuttlefish licenses [--all] [--strict]          Scan this project's Arduino libraries for SPDX licenses (--all: every installed library)`);
     console.log();
+    console.log(chalk.cyan(`LIBRARY PACKAGES`) + chalk.gray(` (npm keywords are the catalog)`));
+    console.log();
+    console.log(`  cuttlefish library search [text] [--category <id>] [--json]`);
+    console.log(`                          Browse cuttlefish library packages on npm, optionally by category`);
+    console.log(`  cuttlefish library install <pkg...>             Install library packages into this project`);
+    console.log(`  cuttlefish library init [name] [--framework <id>] [--category <id>] [--targets <list>]`);
+    console.log(`                          Scaffold a new library package (interactive; --yes takes defaults)`);
+    console.log(`  cuttlefish library validate [path] [--json]     Validate a library package (manifest, shims, keywords, AUTOSAR strict)`);
+    console.log();
     console.log(chalk.gray(`Transpilation is always performed first. Use --compile, --upload, and`));
     console.log(chalk.gray(`--monitor to chain operations after transpilation.`));
     console.log();
@@ -49,6 +58,10 @@ export function printHelp() {
     console.log(`  --autosar-arxml         Also write <name>.autosar-deviations.arxml (Artop/DaVinci).`);
     console.log(`                          No-op unless --autosar is warn or strict.`);
     console.log();
+    console.log(`  --strict-css            Treat UI CSS-compatibility warnings as errors (css-*`);
+    console.log(`                          diagnostics: ignored alpha, quantized font sizes,`);
+    console.log(`                          unsupported display/position values, viewport-hogging sizes).`);
+    console.log();
     console.log(chalk.cyan(`BUILD COMMANDS`) + chalk.gray(` (chain in order: --compile → --upload → --monitor)`));
     console.log();
     console.log(`  --compile               Compile the generated output using the framework toolchain.`);
@@ -277,6 +290,10 @@ function parsePipelineCommand(argv, command, inputFile) {
     // --autosar-arxml: also write the .autosar-deviations.arxml sidecar
     // (Artop/DaVinci tooling). No-op unless --autosar is warn or strict.
     const autosarArxml = readBooleanFlag(argv, ["--autosar-arxml"]);
+    // --strict-css: upgrade UI CSS-compatibility warnings (css-* diagnostics,
+    // e.g. ignored alpha, quantized font sizes, unsupported display values) to
+    // errors so builds fail instead of silently approximating.
+    const strictCss = readBooleanFlag(argv, ["--strict-css"]);
     const emitMode = emitFlag === "cpp" || emitFlag === "split" ? emitFlag : "split";
     const emitMaps = emitMapsFlag === undefined ? true : emitMapsFlag !== "false";
     // Accept any target string — the framework package registers its own strategy id.
@@ -329,6 +346,7 @@ function parsePipelineCommand(argv, command, inputFile) {
         frameworkPackage: frameworkFlag,
         autosar,
         autosarArxml,
+        strictCss,
     };
 }
 export function parseCommandLine(argv) {
@@ -362,9 +380,6 @@ export function parseCommandLine(argv) {
     if (firstArg === "create-board") {
         throw new Error(`The 'create-board' command has been removed. Board scaffolding is now in @typecad/create.`);
     }
-    if (firstArg === "init") {
-        throw new Error(`Use 'cuttlefish create' instead of 'cuttlefish init'.`);
-    }
     // build subcommand — entry point comes from cuttlefish.config.ts
     if (firstArg === "build") {
         return parsePipelineCommand(argv, "build");
@@ -432,6 +447,65 @@ export function parseCommandLine(argv) {
             platformContext: {},
         };
     }
+    // library subcommand — the cuttlefish library package manager
+    // (search/install/init/validate; npm keywords are the catalog).
+    if (firstArg === "library") {
+        const sub = argv[3];
+        const known = new Set(["search", "install", "init", "validate"]);
+        if (!sub || !known.has(sub)) {
+            throw new Error("Usage: cuttlefish library <search|install|init|validate> [args]. " +
+                "Try 'cuttlefish library search' to browse, or 'cuttlefish library init <name>'.");
+        }
+        const subcommand = sub;
+        // Value flags accept both forms (--category led and --category=led); the
+        // generic readFlag helper only handles the space-separated form, which
+        // would silently drop an equals-form filter.
+        const valueFlags = new Set(["--category", "--framework", "--targets", "--dir"]);
+        const flagValues = new Map();
+        const positionals = [];
+        let jsonFlag = false;
+        let yesFlag = false;
+        for (let i = 4; i < argv.length; i++) {
+            const tok = argv[i];
+            if (tok.startsWith("--") && tok.includes("=")) {
+                const eq = tok.indexOf("=");
+                flagValues.set(tok.slice(0, eq), tok.slice(eq + 1));
+                continue;
+            }
+            if (valueFlags.has(tok)) {
+                if (i + 1 < argv.length) {
+                    flagValues.set(tok, argv[++i]);
+                }
+                continue;
+            }
+            if (tok === "--json") {
+                jsonFlag = true;
+                continue;
+            }
+            if (tok === "--yes" || tok === "-y") {
+                yesFlag = true;
+                continue;
+            }
+            if (tok.startsWith("-"))
+                continue;
+            positionals.push(tok);
+        }
+        const category = flagValues.get("--category");
+        if (category !== undefined && subcommand !== "search" && subcommand !== "init") {
+            throw new Error("--category applies to 'library search' and 'library init' only.");
+        }
+        return {
+            command: "library",
+            subcommand,
+            positionals,
+            category,
+            framework: flagValues.get("--framework"),
+            targets: flagValues.get("--targets"),
+            dir: flagValues.get("--dir"),
+            yes: yesFlag,
+            json: jsonFlag,
+        };
+    }
     // Named subcommands
     if (firstArg === "gen-libdefs" || firstArg === "gen-decls" || firstArg === "map-error") {
         const command = firstArg;

package/dist/utils/ui.d.ts

@@ -27,6 +27,11 @@ export declare function printTranspiling(): void;
  * Print compiling step
  */
 export declare function printCompiling(target: string): void;
+/**
+ * Print the debug-session strategy notice (debug builds only): which
+ * framework's code-generation strategy is preparing the debug build.
+ */
+export declare function printDebugStrategy(framework: string): void;
 /**
  * Print uploading step
  */

package/dist/utils/ui.js

@@ -69,6 +69,13 @@ export function printTranspiling() {
 export function printCompiling(target) {
     console.log(chalk.cyan(`${ICON_COMPILE} Compiling for `) + chalk.white(target));
 }
+/**
+ * Print the debug-session strategy notice (debug builds only): which
+ * framework's code-generation strategy is preparing the debug build.
+ */
+export function printDebugStrategy(framework) {
+    console.log(chalk.cyan(`${ICON_COMPILE} Preparing to debug using `) + chalk.white(framework));
+}
 /**
  * Print uploading step
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typecad/cuttlefish",
-  "version": "1.0.0-alpha.12",
+  "version": "1.0.0-alpha.14",
   "description": "TypeScript to C++ transpiler — native, Arduino, and bare-metal targets",
   "type": "module",
   "main": "./dist/transpile.js",
@@ -37,6 +37,14 @@
       "types": "./dist/ir/build-ir-state.d.ts",
       "default": "./dist/ir/build-ir-state.js"
     },
+    "./library-packages": {
+      "types": "./dist/library-packages.d.ts",
+      "default": "./dist/library-packages.js"
+    },
+    "./compliance": {
+      "types": "./dist/emit/compliance/index.d.ts",
+      "default": "./dist/emit/compliance/index.js"
+    },
     "./config-loader": {
       "types": "./dist/config-loader.d.ts",
       "default": "./dist/config-loader.js"
@@ -83,7 +91,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "assets"
   ],
   "publishConfig": {
     "access": "public"
@@ -94,13 +103,13 @@
     "start": "node dist/cli.js"
   },
   "dependencies": {
-    "chalk": "^4.1.2",
+    "chalk": "^6.0.0",
     "typescript": "^5.7.3",
-    "zod": "^3.24.0"
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@typecad/ui": "1.0.0-alpha.12",
-    "@typecad/safety": "1.0.0-alpha.12"
+    "@typecad/ui": "1.0.0-alpha.14",
+    "@typecad/safety": "1.0.0-alpha.14"
   },
   "peerDependenciesMeta": {
     "@typecad/ui": {
@@ -111,8 +120,8 @@
     }
   },
   "optionalDependencies": {
-    "@typecad/expect": "1.0.0-alpha.12",
-    "@typecad/framework-native": "1.0.0-alpha.12"
+    "@typecad/expect": "1.0.0-alpha.14",
+    "@typecad/framework-native": "1.0.0-alpha.14"
   },
   "devDependencies": {
     "@types/node": "^22.10.7"
@@ -141,7 +150,7 @@
     "typescript"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=22.11.0"
   },
   "author": "typecad0",
   "sideEffects": false

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

@@ -1,28 +0,0 @@
-import type { ArchitectureIdentifier } from '../api/index.js';
-export interface InitProjectOptions {
-    projectName: string;
-    targetId: string;
-    targetDisplayName: string;
-    isNative: boolean;
-    architecture?: ArchitectureIdentifier;
-    boardPackage?: string;
-    frameworkPackage: string;
-    framework: string;
-    buildTarget?: string;
-    mcu?: string;
-    baudRate?: number;
-    includeSketch: boolean;
-    toolchainType?: string;
-    /** Extra frameworkData fields (e.g. `{ target: 'esp32s3' }` for framework-esp32). */
-    frameworkData?: Record<string, unknown>;
-}
-export declare function generateProjectPackageJson(options: InitProjectOptions): string;
-export declare function generateProjectTsconfig(options: InitProjectOptions): string;
-export declare function generateProjectConfig(options: InitProjectOptions): string;
-export declare function generateProjectEnvDts(options: InitProjectOptions): string;
-export declare function generateStarterSketch(options: InitProjectOptions): string;
-export declare function generateStarterTest(_options: InitProjectOptions): string;
-export declare function generateStarterSim(options: InitProjectOptions): string;
-export declare function generateBoardForwardingFile(boardPackage: string): string;
-export declare function generateGitignore(_options: InitProjectOptions): string;
-export declare function generateEslintConfig(_options: InitProjectOptions): string;

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

@@ -1,8 +0,0 @@
-import type { InitProjectOptions } from "./init-templates.js";
-export declare function runInitWizard(partialOptions?: {
-    projectName?: string;
-    board?: string;
-    framework?: string;
-    baud?: number;
-    noSketch?: boolean;
-}): Promise<InitProjectOptions | null>;