@timbal-ai/timbal-react 0.5.4 → 0.6.0

package/scripts/dev-linked.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * Run `bun run build:watch` in timbal-react, then a consumer dev server.
+ *
+ * Usage:
+ *   node scripts/dev-linked.mjs [consumerDir] [devCommand ...]
+ *
+ * Examples:
+ *   node scripts/dev-linked.mjs vite
+ *   node scripts/dev-linked.mjs examples/app-kit vite
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const timbalReactRoot = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  "..",
+);
+
+const args = process.argv.slice(2);
+let consumerDir = process.cwd();
+let devArgs = args;
+
+if (args[0]) {
+  const candidate = path.resolve(timbalReactRoot, args[0]);
+  if (existsSync(path.join(candidate, "package.json"))) {
+    consumerDir = candidate;
+    devArgs = args.slice(1);
+  }
+}
+
+const devCmd = devArgs[0] ?? "vite";
+const devCmdArgs = devArgs.slice(1);
+
+function run(cmd, args, opts) {
+  return spawn(cmd, args, {
+    cwd: opts.cwd,
+    stdio: "inherit",
+    shell: process.platform === "win32",
+    env: process.env,
+  });
+}
+
+console.log("[timbal-react] building + watching dist…");
+const watch = run("bun", ["run", "build:watch"], { cwd: timbalReactRoot });
+
+console.log(`[consumer] (${consumerDir}) ${devCmd} ${devCmdArgs.join(" ")}`.trim());
+const app = run(devCmd, devCmdArgs, { cwd: consumerDir });
+
+let exiting = false;
+function shutdown(code = 0) {
+  if (exiting) return;
+  exiting = true;
+  watch.kill("SIGTERM");
+  app.kill("SIGTERM");
+  process.exit(code);
+}
+
+process.on("SIGINT", () => shutdown(0));
+process.on("SIGTERM", () => shutdown(0));
+watch.on("exit", (code) => {
+  if (code) shutdown(code);
+});
+app.on("exit", (code) => shutdown(code ?? 0));

package/vite/local-dev.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "vite";
+
+/** Use in Vite apps that link `@timbal-ai/timbal-react` via `file:../timbal-react`. */
+export function timbalReactLocalDev(): Plugin;

package/vite/local-dev.mjs

@@ -0,0 +1,71 @@
+/**
+ * Vite plugin for apps that depend on `@timbal-ai/timbal-react` via `file:../timbal-react`.
+ *
+ * - Skips pre-bundling so `dist/` updates are not stuck in `node_modules/.vite/deps`
+ * - Watches the linked package `dist/` and triggers a full reload when it changes
+ */
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const TIMBAL_REACT_EXPORTS = [
+  "@timbal-ai/timbal-react",
+  "@timbal-ai/timbal-react/chat",
+  "@timbal-ai/timbal-react/studio",
+  "@timbal-ai/timbal-react/ui",
+  "@timbal-ai/timbal-react/app",
+];
+
+function resolveLinkedPackageRoot() {
+  try {
+    const require = createRequire(import.meta.url);
+    const pkgJson = require.resolve("@timbal-ai/timbal-react/package.json");
+    return path.dirname(pkgJson);
+  } catch {
+    return null;
+  }
+}
+
+/** @returns {import('vite').Plugin} */
+export function timbalReactLocalDev() {
+  /** @type {string | null} */
+  let distDir = null;
+
+  return {
+    name: "timbal-react-local-dev",
+    enforce: "pre",
+    config() {
+      const pkgRoot = resolveLinkedPackageRoot();
+      if (!pkgRoot) return {};
+
+      distDir = path.join(pkgRoot, "dist");
+      const distGlob = `${distDir.replace(/\\/g, "/")}/**`;
+
+      return {
+        optimizeDeps: {
+          exclude: TIMBAL_REACT_EXPORTS,
+        },
+        server: {
+          watch: {
+            ignored: ["**/.git/**", "**/node_modules/**", `!${distGlob}`],
+          },
+        },
+      };
+    },
+    handleHotUpdate({ file, server }) {
+      if (!distDir || !file.startsWith(distDir)) return;
+
+      for (const mod of server.moduleGraph.idToModuleMap.values()) {
+        if (
+          mod.id?.includes("@timbal-ai/timbal-react") ||
+          mod.id?.includes(`${path.sep}timbal-react${path.sep}dist`)
+        ) {
+          server.moduleGraph.invalidateModule(mod);
+        }
+      }
+
+      server.ws.send({ type: "full-reload" });
+      return [];
+    },
+  };
+}