@typecad/cuttlefish 0.1.0-alpha.1 → 0.1.0-alpha.2

package/dist/cli.js

@@ -12,7 +12,7 @@ import { resolveStrategy } from "./platform/registry.js";
 import { loadFrameworkPackage } from "./framework-package.js";
 import { getLoadedFramework, hasLoadedFramework } from "./framework-registry.js";
 import { loadCuttlefishConfig, generateVirtualTypeDeclaration } from "./config-loader.js";
-import { requireUIHook } from "./ui-hook.js";
+import { requireUIHook, hasUIHook } from "./ui-hook.js";
 import { loadUIEngine } from "./ui/ui-bridge.js";
 import { runWatch, discoverWatchDirs } from "./watch.js";
 import { runExpectTests, assertTypeScriptInput, printDiagnostics, printMappedCompileErrors } from "./cli-utils.js";
@@ -321,7 +321,11 @@ async function main() {
                 // Strategy not yet loaded — env.d.ts will have generic declarations only
             }
             generateVirtualTypeDeclaration(config, platformDeclarations);
-            requireUIHook().generateProjectUITypeDeclarations(path.dirname(config.configPath));
+            // @typecad/ui is optional — skip UI type-decl generation when the engine
+            // is not loaded (no UI modules exist to declare).
+            if (hasUIHook()) {
+                requireUIHook().generateProjectUITypeDeclarations(path.dirname(config.configPath));
+            }
         }
         // Print branded header and build info
         ui.printHeader();
@@ -421,7 +425,11 @@ async function main() {
                     console.log();
                     try {
                         if (config) {
-                            requireUIHook().generateProjectUITypeDeclarations(path.dirname(config.configPath));
+                            // @typecad/ui is optional — skip UI type-decl generation when the
+                            // engine is not loaded (no UI modules exist to declare).
+                            if (hasUIHook()) {
+                                requireUIHook().generateProjectUITypeDeclarations(path.dirname(config.configPath));
+                            }
                         }
                         ui.printTranspiling();
                         const rebuildResult = await transpileFile({

package/dist/orchestrator/type-checker.js

@@ -4,7 +4,7 @@ import ts from "typescript";
 import { makeDiagnostic } from "../ir/ast-node-utils.js";
 import { canonicalize, buildSemanticFacts } from "./semantic-facts.js";
 import { verifyFacts } from "./semantic-facts-verifier.js";
-import { requireUIHook } from "../ui-hook.js";
+import { requireUIHook, hasUIHook } from "../ui-hook.js";
 /**
  * Type-checks TypeScript files using the TypeScript compiler.
  * Returns early if any errors are found.
@@ -54,7 +54,9 @@ export function typeCheckFiles(files, _boardPackage, entryFile) {
             }
         }
     }
-    const uiModules = requireUIHook().allUIModules();
+    // @typecad/ui is optional — when the engine is not loaded there are no UI
+    // modules and nothing to register with the type-checker.
+    const uiModules = hasUIHook() ? requireUIHook().allUIModules() : [];
     if (uiModules.length > 0) {
         compilerOptions.allowArbitraryExtensions = true;
         const rootDirs = new Set((compilerOptions.rootDirs ?? []).map((dir) => path.resolve(dir)));

package/dist/testing.d.ts

@@ -14,6 +14,7 @@ export { registerPlatformStrategy, resolveStrategy, clearAllProfileCaches } from
 export type { EmitMode, GeneratedOutputs, TargetProfile, PlatformContext } from "./types.js";
 export { findConfigFile, parseConfigFile, loadCuttlefishConfig, generateVirtualTypeDeclaration, } from "./config-loader.js";
 export { transpileFile } from "./transpile.js";
+export { resetUIEngine, __simulateUIAbsentForTest } from "./ui/ui-bridge.js";
 export { scaffoldProject, normalizeProjectName, KNOWN_BOARDS, generateProjectPackageJson, generateProjectTsconfig, generateProjectConfig, generateProjectEnvDts, generateStarterSketch, generateGitignore, generateEslintConfig, runInitWizard, } from "./create/index.js";
 export type { InitProjectOptions } from "./create/index.js";
 export { scaffoldBoardPackages, parseBoardSpec, safeParseBoardSpec, stripJsonc, } from "./create/index.js";

package/dist/testing.js

@@ -15,6 +15,8 @@ export { registerPlatformStrategy, resolveStrategy, clearAllProfileCaches } from
 export { findConfigFile, parseConfigFile, loadCuttlefishConfig, generateVirtualTypeDeclaration, } from "./config-loader.js";
 // ── Transpiler internal API ─────────────────────────────────────────────────
 export { transpileFile } from "./transpile.js";
+// ── UI bridge (optional @typecad/ui) ─────────────────────────────────────────
+export { resetUIEngine, __simulateUIAbsentForTest } from "./ui/ui-bridge.js";
 // ── Project scaffolding ──────────────────────────────────────────────────────
 export { scaffoldProject, normalizeProjectName, KNOWN_BOARDS, generateProjectPackageJson, generateProjectTsconfig, generateProjectConfig, generateProjectEnvDts, generateStarterSketch, generateGitignore, generateEslintConfig, runInitWizard, } from "./create/index.js";
 // ── Board codegen (`cuttlefish board add`) ───────────────────────────────────

package/dist/transpile.js

@@ -6,7 +6,7 @@ import ts from "typescript";
 import { buildProgramIR } from "./ir/build-ir.js";
 import { classDeclarationToIR } from "./ir/declaration-builders.js";
 import { clickHandlers } from "./ir/transformers/ui-call-resolver.js";
-import { requireUIHook } from "./ui-hook.js";
+import { requireUIHook, hasUIHook } from "./ui-hook.js";
 import { loadUIEngine } from "./ui/ui-bridge.js";
 import { setDisplayProfile, resetDisplayProfile } from "./stores/display-profile-store.js";
 import { setThemeCss, resetThemeCss, setThemeClass } from "./stores/theme-store.js";
@@ -344,9 +344,12 @@ export async function transpileFile(options) {
     // The graph build above already loaded all .ui.html modules; surface their
     // parser warnings (unknown CSS properties, unknown HTML tags) here so the
     // author sees typos and unsupported features instead of silent drops.
-    for (const mod of requireUIHook().allUIModules()) {
-        for (const d of mod.diagnostics) {
-            diagnostics.push({ ...d, source: d.source ?? path.basename(mod.htmlPath) });
+    // Guarded: @typecad/ui is optional, so there may be no UI engine loaded.
+    if (hasUIHook()) {
+        for (const mod of requireUIHook().allUIModules()) {
+            for (const d of mod.diagnostics) {
+                diagnostics.push({ ...d, source: d.source ?? path.basename(mod.htmlPath) });
+            }
         }
     }
     // ── Semantic gates (Phase 3) ──────────────────────────────────────────────
@@ -459,9 +462,12 @@ export async function transpileFile(options) {
     profiler.captureMemorySnapshot("ir:post-build");
     profiler.endTimer("ir:build-all");
     // ── UI mount-time warnings (scroll memory budget, etc.) ─────────────────
-    for (const mod of requireUIHook().allUIModules()) {
-        for (const d of mod.mountDiagnostics) {
-            diagnostics.push({ ...d, source: d.source ?? path.basename(mod.htmlPath) });
+    // Guarded: @typecad/ui is optional; no engine means no UI modules.
+    if (hasUIHook()) {
+        for (const mod of requireUIHook().allUIModules()) {
+            for (const d of mod.mountDiagnostics) {
+                diagnostics.push({ ...d, source: d.source ?? path.basename(mod.htmlPath) });
+            }
         }
     }
     throwIfFatalDiagnostics(rawIRArray.flatMap(({ filePath, programIR }) => programIR.diagnostics.map((diagnostic) => ({ filePath, diagnostic }))));

package/dist/ui/ui-bridge.d.ts

@@ -2,3 +2,15 @@
  *  Called by transpile.ts at the start of each transpile run.
  *  Safe to call when @typecad/ui is absent (hook stays null). */
 export declare function loadUIEngine(): Promise<void>;
+/** Reset the UI bridge to its initial state: forget that a load was attempted
+ *  and clear the registered hook. Mirrors the other `reset*` session helpers
+ *  (clearCaches, resetDisplayProfile) so each transpile run — and each test —
+ *  starts from a clean slate. */
+export declare function resetUIEngine(): void;
+/** Test-only: force the bridge into the "no @typecad/ui" state — mark the load
+ *  as already attempted and leave the hook null, exactly as if the dynamic
+ *  import in loadUIEngine() had failed because the package is not installed.
+ *  This lets the test suite (which runs inside the monorepo where @typecad/ui
+ *  IS resolvable) reproduce a plain end-user project that has not added
+ *  @typecad/ui as a dependency. */
+export declare function __simulateUIAbsentForTest(): void;

package/dist/ui/ui-bridge.js

@@ -32,3 +32,21 @@ export async function loadUIEngine() {
         // @typecad/ui is not installed — cuttlefish works without UI support.
     }
 }
+/** Reset the UI bridge to its initial state: forget that a load was attempted
+ *  and clear the registered hook. Mirrors the other `reset*` session helpers
+ *  (clearCaches, resetDisplayProfile) so each transpile run — and each test —
+ *  starts from a clean slate. */
+export function resetUIEngine() {
+    loaded = false;
+    setUIHook(null);
+}
+/** Test-only: force the bridge into the "no @typecad/ui" state — mark the load
+ *  as already attempted and leave the hook null, exactly as if the dynamic
+ *  import in loadUIEngine() had failed because the package is not installed.
+ *  This lets the test suite (which runs inside the monorepo where @typecad/ui
+ *  IS resolvable) reproduce a plain end-user project that has not added
+ *  @typecad/ui as a dependency. */
+export function __simulateUIAbsentForTest() {
+    loaded = true;
+    setUIHook(null);
+}

package/package.json

@@ -1,127 +1,127 @@
-{
-  "name": "@typecad/cuttlefish",
-  "version": "0.1.0-alpha.1",
-  "description": "TypeScript to C++ transpiler — native, Arduino, and bare-metal targets",
-  "type": "module",
-  "main": "./dist/transpile.js",
-  "types": "./dist/transpile.d.ts",
-  "bin": {
-    "cuttlefish": "dist/cli.js"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/transpile.d.ts",
-      "default": "./dist/transpile.js"
-    },
-    "./testing": {
-      "types": "./dist/testing.d.ts",
-      "default": "./dist/testing.js"
-    },
-    "./api": {
-      "types": "./dist/api/index.d.ts",
-      "default": "./dist/api/index.js"
-    },
-    "./api/shared": {
-      "types": "./dist/api/shared/index.d.ts",
-      "default": "./dist/api/shared/index.js"
-    },
-    "./ui-hook": {
-      "types": "./dist/ui-hook.d.ts",
-      "default": "./dist/ui-hook.js"
-    },
-    "./config-loader": {
-      "types": "./dist/config-loader.d.ts",
-      "default": "./dist/config-loader.js"
-    },
-    "./stores/display-profile-store": {
-      "types": "./dist/stores/display-profile-store.d.ts",
-      "default": "./dist/stores/display-profile-store.js"
-    },
-    "./stores/theme-store": {
-      "types": "./dist/stores/theme-store.d.ts",
-      "default": "./dist/stores/theme-store.js"
-    },
-    "./api/schema": {
-      "types": "./dist/api/schema/index.d.ts",
-      "default": "./dist/api/schema/index.js"
-    },
-    "./emit/route-hal-op": {
-      "types": "./dist/emit/route-hal-op.d.ts",
-      "default": "./dist/emit/route-hal-op.js"
-    },
-    "./ir/transformers/ui-lowering": {
-      "types": "./dist/ir/transformers/ui-lowering.d.ts",
-      "default": "./dist/ir/transformers/ui-lowering.js"
-    },
-    "./ir/ui-element-auto-wire": {
-      "types": "./dist/ir/ui-element-auto-wire.d.ts",
-      "default": "./dist/ir/ui-element-auto-wire.js"
-    },
-    "./ir/transformers/ui-mount": {
-      "types": "./dist/ir/transformers/ui-mount.d.ts",
-      "default": "./dist/ir/transformers/ui-mount.js"
-    },
-    "./ir/transformers/ui-reactive": {
-      "types": "./dist/ir/transformers/ui-reactive.d.ts",
-      "default": "./dist/ir/transformers/ui-reactive.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build",
-    "start": "node dist/cli.js"
-  },
-  "dependencies": {
-    "chalk": "^4.1.2",
-    "typescript": "^5.7.3",
-    "zod": "^3.24.0"
-  },
-  "peerDependencies": {
-    "@typecad/ui": "0.1.0-alpha.1"
-  },
-  "peerDependenciesMeta": {
-    "@typecad/ui": {
-      "optional": true
-    }
-  },
-  "optionalDependencies": {
-    "@typecad/framework-native": "0.1.0-alpha.1"
-  },
-  "devDependencies": {
-    "@types/node": "^22.10.7"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/justind000/typecode.git",
-    "directory": "packages/cuttlefish"
-  },
-  "homepage": "https://github.com/justind000/typecode/tree/main/packages/cuttlefish",
-  "bugs": {
-    "url": "https://github.com/justind000/typecode/issues"
-  },
-  "keywords": [
-    "arduino",
-    "cli",
-    "codegen",
-    "cpp",
-    "cuttlefish",
-    "embedded",
-    "firmware",
-    "microcontroller",
-    "transpiler",
-    "typecad",
-    "typescript"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "author": "typecad0",
-  "sideEffects": false
-}
+{
+  "name": "@typecad/cuttlefish",
+  "version": "0.1.0-alpha.2",
+  "description": "TypeScript to C++ transpiler — native, Arduino, and bare-metal targets",
+  "type": "module",
+  "main": "./dist/transpile.js",
+  "types": "./dist/transpile.d.ts",
+  "bin": {
+    "cuttlefish": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/transpile.d.ts",
+      "default": "./dist/transpile.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    },
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "default": "./dist/api/index.js"
+    },
+    "./api/shared": {
+      "types": "./dist/api/shared/index.d.ts",
+      "default": "./dist/api/shared/index.js"
+    },
+    "./ui-hook": {
+      "types": "./dist/ui-hook.d.ts",
+      "default": "./dist/ui-hook.js"
+    },
+    "./config-loader": {
+      "types": "./dist/config-loader.d.ts",
+      "default": "./dist/config-loader.js"
+    },
+    "./stores/display-profile-store": {
+      "types": "./dist/stores/display-profile-store.d.ts",
+      "default": "./dist/stores/display-profile-store.js"
+    },
+    "./stores/theme-store": {
+      "types": "./dist/stores/theme-store.d.ts",
+      "default": "./dist/stores/theme-store.js"
+    },
+    "./api/schema": {
+      "types": "./dist/api/schema/index.d.ts",
+      "default": "./dist/api/schema/index.js"
+    },
+    "./emit/route-hal-op": {
+      "types": "./dist/emit/route-hal-op.d.ts",
+      "default": "./dist/emit/route-hal-op.js"
+    },
+    "./ir/transformers/ui-lowering": {
+      "types": "./dist/ir/transformers/ui-lowering.d.ts",
+      "default": "./dist/ir/transformers/ui-lowering.js"
+    },
+    "./ir/ui-element-auto-wire": {
+      "types": "./dist/ir/ui-element-auto-wire.d.ts",
+      "default": "./dist/ir/ui-element-auto-wire.js"
+    },
+    "./ir/transformers/ui-mount": {
+      "types": "./dist/ir/transformers/ui-mount.d.ts",
+      "default": "./dist/ir/transformers/ui-mount.js"
+    },
+    "./ir/transformers/ui-reactive": {
+      "types": "./dist/ir/transformers/ui-reactive.d.ts",
+      "default": "./dist/ir/transformers/ui-reactive.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/cli.js"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "typescript": "^5.7.3",
+    "zod": "^3.24.0"
+  },
+  "peerDependencies": {
+    "@typecad/ui": "0.1.0-alpha.2"
+  },
+  "peerDependenciesMeta": {
+    "@typecad/ui": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "@typecad/framework-native": "0.1.0-alpha.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/justind000/typecode.git",
+    "directory": "packages/cuttlefish"
+  },
+  "homepage": "https://github.com/justind000/typecode/tree/main/packages/cuttlefish",
+  "bugs": {
+    "url": "https://github.com/justind000/typecode/issues"
+  },
+  "keywords": [
+    "arduino",
+    "cli",
+    "codegen",
+    "cpp",
+    "cuttlefish",
+    "embedded",
+    "firmware",
+    "microcontroller",
+    "transpiler",
+    "typecad",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "author": "typecad0",
+  "sideEffects": false
+}