@iota-uz/sdk 0.3.1 → 0.3.2

package/README.MD

@@ -122,6 +122,8 @@ The script automatically detects your OS (macOS/Linux) and architecture, downloa
 
 **Prerequisites:** Go and Homebrew (macOS only) must be installed first.
 
+**Node/pnpm:** The repo pins `pnpm@9.15.0` via the `packageManager` field in `package.json`. Ensure [Corepack](https://nodejs.org/api/corepack.html) is enabled (`corepack enable`) in CI and contributor environments so the correct pnpm version is used; otherwise `npm` or `yarn` may run without warning.
+
 For full setup instructions, see the [Installation Guide](https://iota-uz.github.io/iota-sdk/getting-started/installation.html).
 
 ## 🔐 Super Admin

package/dist/applet/vite.cjs

@@ -0,0 +1,231 @@
+'use strict';
+
+var fs2 = require('fs');
+var path2 = require('path');
+var child_process = require('child_process');
+var crypto = require('crypto');
+var module$1 = require('module');
+var os = require('os');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var fs2__default = /*#__PURE__*/_interopDefault(fs2);
+var path2__default = /*#__PURE__*/_interopDefault(path2);
+var crypto__default = /*#__PURE__*/_interopDefault(crypto);
+var os__default = /*#__PURE__*/_interopDefault(os);
+
+// ui/src/applet-vite/vite.ts
+var APPLET_DEV_MANIFEST = "applet-dev.json";
+function readAppletDevManifest(viteDir) {
+  const dir = viteDir ?? process.cwd();
+  const filePath = path2__default.default.join(dir, APPLET_DEV_MANIFEST);
+  try {
+    const raw = fs2__default.default.readFileSync(filePath, "utf-8");
+    const data = JSON.parse(raw);
+    if (typeof data.basePath === "string" && typeof data.assetsBase === "string" && typeof data.vitePort === "number" && typeof data.backendUrl === "string") {
+      return data;
+    }
+  } catch {
+  }
+  return null;
+}
+var DEFAULT_DEDUPE = ["react", "react-dom", "react-router-dom", "react-is"];
+function getAppletAssetsBase(viteDir, manifest) {
+  const resolved = manifest ?? readAppletDevManifest(viteDir);
+  if (resolved) {
+    const base2 = resolved.assetsBase;
+    return base2.endsWith("/") ? base2 : base2 + "/";
+  }
+  const base = process.env.APPLET_ASSETS_BASE ?? "";
+  return base.endsWith("/") ? base : base ? base + "/" : "/";
+}
+function getAppletVitePort(defaultPort = 5173, viteDir, manifest) {
+  const resolved = manifest ?? readAppletDevManifest(viteDir);
+  if (resolved) return resolved.vitePort;
+  const p = process.env.APPLET_VITE_PORT;
+  if (p === void 0 || p === "") return defaultPort;
+  const n = Number(p);
+  return Number.isFinite(n) ? n : defaultPort;
+}
+function createAppletViteConfig(opts) {
+  const manifest = readAppletDevManifest(opts.viteConfigDir);
+  const base = getAppletAssetsBase(opts.viteConfigDir, manifest);
+  const port = getAppletVitePort(5173, opts.viteConfigDir, manifest);
+  const basePath = manifest?.basePath ?? opts.basePath;
+  const backendUrl = manifest?.backendUrl ?? opts.backendUrl;
+  const config = {
+    base,
+    resolve: {
+      dedupe: DEFAULT_DEDUPE,
+      alias: createLocalSdkAliases({
+        enabled: opts.enableLocalSdkAliases ?? Boolean(process.env.IOTA_SDK_DIST),
+        sdkDistDir: opts.sdkDistDir ?? process.env.IOTA_SDK_DIST
+      })
+    },
+    server: {
+      port,
+      strictPort: true,
+      proxy: createAppletBackendProxy({
+        basePath,
+        backendUrl
+      })
+    }
+  };
+  if (opts.extend) {
+    return mergeConfig(config, opts.extend);
+  }
+  return config;
+}
+function createAppletBackendProxy(opts) {
+  const base = opts.basePath.replace(/\/+$/, "");
+  const target = opts.backendUrl.replace(/\/+$/, "");
+  return {
+    [base + "/rpc"]: target,
+    [base + "/stream"]: target
+  };
+}
+function createLocalSdkAliases(opts) {
+  const enabled = opts?.enabled ?? Boolean(opts?.sdkDistDir ?? process.env.IOTA_SDK_DIST);
+  const dir = opts?.sdkDistDir ?? process.env.IOTA_SDK_DIST;
+  if (!enabled || !dir) return [];
+  const sdkDist = path2__default.default.resolve(dir);
+  return [
+    { find: /^@iota-uz\/sdk\/bichat$/, replacement: path2__default.default.join(sdkDist, "bichat/index.mjs") },
+    { find: /^@iota-uz\/sdk$/, replacement: path2__default.default.join(sdkDist, "index.mjs") }
+  ];
+}
+function mergeConfig(a, b) {
+  const aResolve = a.resolve;
+  const bResolve = b.resolve;
+  const aServer = a.server;
+  const bServer = b.server;
+  const aPlugins = a.plugins;
+  const bPlugins = b.plugins;
+  const merged = { ...a, ...b };
+  if (bResolve) {
+    const aAlias = aResolve?.alias;
+    const bAlias = bResolve.alias;
+    const aIsArray = Array.isArray(aAlias);
+    const bIsArray = Array.isArray(bAlias);
+    const alias = aIsArray && bIsArray ? [...aAlias, ...bAlias] : bAlias !== void 0 ? bAlias : aResolve?.alias;
+    merged.resolve = {
+      ...aResolve,
+      ...bResolve,
+      alias,
+      dedupe: bResolve.dedupe ?? merged.resolve?.dedupe ?? aResolve?.dedupe
+    };
+  }
+  if (bServer) {
+    merged.server = { ...aServer, ...bServer };
+  }
+  if (bPlugins) {
+    merged.plugins = [...aPlugins ?? [], ...bPlugins];
+  }
+  return merged;
+}
+var VIRTUAL_APPLET_STYLES_ID = "virtual:applet-styles";
+var RESOLVED_ID = "\0" + VIRTUAL_APPLET_STYLES_ID;
+function resolvePrependPath(specifierOrPath, root) {
+  if (path2__default.default.isAbsolute(specifierOrPath)) {
+    return specifierOrPath;
+  }
+  if (!specifierOrPath.startsWith(".") && !specifierOrPath.startsWith("/")) {
+    try {
+      const req = module$1.createRequire(path2__default.default.join(root, "package.json"));
+      return req.resolve(specifierOrPath);
+    } catch {
+      return null;
+    }
+  }
+  return path2__default.default.join(root, specifierOrPath);
+}
+function createAppletStylesVirtualModulePlugin(options = {}) {
+  const inputCss = options.inputCss ?? "src/index.css";
+  const outputCssPath = options.outputCssPath ?? "dist/style.css";
+  const tailwindConfigPath = options.tailwindConfigPath;
+  const prependCss = options.prependCss ?? [];
+  let root = process.cwd();
+  return {
+    name: "applet-styles-virtual-module",
+    configResolved(config) {
+      root = config.root;
+    },
+    resolveId(id) {
+      if (id === VIRTUAL_APPLET_STYLES_ID) return RESOLVED_ID;
+      return null;
+    },
+    load(id) {
+      if (id !== RESOLVED_ID) return null;
+      const parts = [];
+      for (const p of prependCss) {
+        const full = resolvePrependPath(p, root);
+        if (full) {
+          try {
+            parts.push(fs2__default.default.readFileSync(full, "utf-8"));
+          } catch {
+          }
+        }
+      }
+      const inputPath = path2__default.default.join(root, inputCss);
+      let mainCss = null;
+      if (fs2__default.default.existsSync(inputPath)) {
+        const tmpFile = path2__default.default.join(os__default.default.tmpdir(), `applet-styles-${Date.now()}-${crypto__default.default.randomUUID()}.css`);
+        const args = ["-i", inputPath, "-o", tmpFile];
+        if (tailwindConfigPath) {
+          const configPath = path2__default.default.join(root, tailwindConfigPath);
+          if (fs2__default.default.existsSync(configPath)) {
+            args.push("-c", configPath);
+          }
+        }
+        const pnpmCmd = process.platform === "win32" ? "pnpm.cmd" : "pnpm";
+        const result = child_process.spawnSync(pnpmCmd, ["exec", "tailwindcss", ...args], {
+          cwd: root,
+          stdio: "pipe"
+        });
+        if (result.status === 0 && fs2__default.default.existsSync(tmpFile)) {
+          mainCss = fs2__default.default.readFileSync(tmpFile, "utf-8");
+          try {
+            fs2__default.default.unlinkSync(tmpFile);
+          } catch {
+          }
+        }
+      }
+      if (mainCss === null) {
+        const fallbackPath = path2__default.default.isAbsolute(outputCssPath) ? outputCssPath : path2__default.default.join(root, outputCssPath);
+        try {
+          mainCss = fs2__default.default.readFileSync(fallbackPath, "utf-8");
+        } catch {
+          if (process.env.NODE_ENV !== "production") {
+            console.warn(
+              `[applet-styles] Could not compile via Tailwind CLI and ${fallbackPath} not found; export empty string. Install tailwindcss in the project or build CSS first.`
+            );
+          }
+          mainCss = "";
+        }
+      }
+      parts.push(mainCss);
+      const css = parts.join("\n");
+      return `export default ${JSON.stringify(css)}`;
+    }
+  };
+}
+function createBichatStylesPlugin(options = {}) {
+  return createAppletStylesVirtualModulePlugin({
+    ...options,
+    inputCss: options.inputCss ?? "src/index.css",
+    outputCssPath: options.outputCssPath ?? "dist/style.css",
+    prependCss: ["@iota-uz/sdk/bichat/styles.css"]
+  });
+}
+
+exports.VIRTUAL_APPLET_STYLES_ID = VIRTUAL_APPLET_STYLES_ID;
+exports.createAppletBackendProxy = createAppletBackendProxy;
+exports.createAppletStylesVirtualModulePlugin = createAppletStylesVirtualModulePlugin;
+exports.createAppletViteConfig = createAppletViteConfig;
+exports.createBichatStylesPlugin = createBichatStylesPlugin;
+exports.createLocalSdkAliases = createLocalSdkAliases;
+exports.getAppletAssetsBase = getAppletAssetsBase;
+exports.getAppletVitePort = getAppletVitePort;
+exports.readAppletDevManifest = readAppletDevManifest;
+//# sourceMappingURL=vite.cjs.map
+//# sourceMappingURL=vite.cjs.map

package/dist/applet/vite.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../ui/src/applet-vite/vite.ts","../../ui/src/applet-vite/styles-plugin.ts"],"names":["path","fs","base","createRequire","os","crypto","spawnSync"],"mappings":"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","file":"vite.cjs","sourcesContent":["/**\n * Applet Frontend Kit: Vite config helpers for applets running behind a base path\n * with dev proxy and optional local SDK aliasing.\n */\nimport type { UserConfig } from 'vite'\nimport fs from 'node:fs'\nimport path from 'node:path'\n\nexport type AppletViteOptions = {\n  /** Applet base path (e.g. \"/admin/ali/chat\" or \"/bi-chat\"); overridden by applet-dev.json when present. */\n  basePath: string\n  /** Backend URL for proxy (e.g. \"http://localhost:3200\"); overridden by applet-dev.json when present. */\n  backendUrl: string\n  /** Directory containing applet-dev.json (default: process.cwd()). When set, base/port/proxy use manifest if present. */\n  viteConfigDir?: string\n  /** Enable Vite aliases to local SDK dist for HMR when iterating on SDK (default: from IOTA_SDK_DIST) */\n  enableLocalSdkAliases?: boolean\n  /** Override SDK dist directory when enableLocalSdkAliases is true (default: process.env.IOTA_SDK_DIST) */\n  sdkDistDir?: string\n  /** Merge additional Vite config */\n  extend?: UserConfig\n}\n\n/** Shape of applet-dev.json written by the Go dev runner (single source of truth when using `just dev <name>`). */\nexport type AppletDevManifest = {\n  basePath: string\n  assetsBase: string\n  vitePort: number\n  backendUrl: string\n}\n\nconst APPLET_DEV_MANIFEST = 'applet-dev.json'\n\n/**\n * Reads applet-dev.json from viteDir (default process.cwd()). When using `just dev <name>`, the Go runner writes this file.\n * Returns null if file is missing or invalid (env vars remain the fallback).\n */\nexport function readAppletDevManifest(viteDir?: string): AppletDevManifest | null {\n  const dir = viteDir ?? process.cwd()\n  const filePath = path.join(dir, APPLET_DEV_MANIFEST)\n  try {\n    const raw = fs.readFileSync(filePath, 'utf-8')\n    const data = JSON.parse(raw) as AppletDevManifest\n    if (typeof data.basePath === 'string' && typeof data.assetsBase === 'string' && typeof data.vitePort === 'number' && typeof data.backendUrl === 'string') {\n      return data\n    }\n  } catch {\n    // file missing or invalid\n  }\n  return null\n}\n\nconst DEFAULT_DEDUPE = ['react', 'react-dom', 'react-router-dom', 'react-is']\n\nexport type AppletDevManifestOrNull = AppletDevManifest | null\n\n/**\n * Returns base URL for assets (with trailing slash). Prefers manifest when provided (avoids re-reading file), then applet-dev.json, then APPLET_ASSETS_BASE env.\n */\nexport function getAppletAssetsBase(viteDir?: string, manifest?: AppletDevManifestOrNull): string {\n  const resolved = manifest ?? readAppletDevManifest(viteDir)\n  if (resolved) {\n    const base = resolved.assetsBase\n    return base.endsWith('/') ? base : base + '/'\n  }\n  const base = process.env.APPLET_ASSETS_BASE ?? ''\n  return base.endsWith('/') ? base : base ? base + '/' : '/'\n}\n\n/**\n * Returns dev server port. Prefers manifest when provided (avoids re-reading file), then applet-dev.json, then APPLET_VITE_PORT env.\n */\nexport function getAppletVitePort(defaultPort = 5173, viteDir?: string, manifest?: AppletDevManifestOrNull): number {\n  const resolved = manifest ?? readAppletDevManifest(viteDir)\n  if (resolved) return resolved.vitePort\n  const p = process.env.APPLET_VITE_PORT\n  if (p === undefined || p === '') return defaultPort\n  const n = Number(p)\n  return Number.isFinite(n) ? n : defaultPort\n}\n\n/**\n * Builds a full Vite config for an applet: base, port, dedupe, proxy, optional local SDK aliases.\n * When applet-dev.json is present (e.g. when using `just dev <name>`), base, port, basePath, and backendUrl come from it.\n *\n * **Merge semantics for `extend`:** When you pass `extend`, it is merged with the base config as follows:\n * - **resolve.alias**: arrays are concatenated (base aliases first, then extend aliases).\n * - **plugins**: arrays are concatenated (base plugins first, then extend plugins).\n * - **server**, **base**, **resolve.dedupe** and other scalar/object fields: extend overrides base (Object.assign-style).\n * To fully override the base config, spread first: `defineConfig({ ...createAppletViteConfig(opts), ...yourOverrides })`.\n */\nexport function createAppletViteConfig(opts: AppletViteOptions): UserConfig {\n  const manifest = readAppletDevManifest(opts.viteConfigDir)\n  const base = getAppletAssetsBase(opts.viteConfigDir, manifest)\n  const port = getAppletVitePort(5173, opts.viteConfigDir, manifest)\n  const basePath = manifest?.basePath ?? opts.basePath\n  const backendUrl = manifest?.backendUrl ?? opts.backendUrl\n  const config: UserConfig = {\n    base,\n    resolve: {\n      dedupe: DEFAULT_DEDUPE,\n      alias: createLocalSdkAliases({\n        enabled: opts.enableLocalSdkAliases ?? Boolean(process.env.IOTA_SDK_DIST),\n        sdkDistDir: opts.sdkDistDir ?? process.env.IOTA_SDK_DIST,\n      }),\n    },\n    server: {\n      port,\n      strictPort: true,\n      proxy: createAppletBackendProxy({\n        basePath,\n        backendUrl,\n      }),\n    },\n  }\n  if (opts.extend) {\n    return mergeConfig(config, opts.extend)\n  }\n  return config\n}\n\n/**\n * Returns proxy entries for applet RPC and stream under basePath.\n * Use as server.proxy in Vite config.\n * Note: /stream is SSE; plain string targets do not set ws or changeOrigin. If WebSocket upgrade or SSE proxying issues arise, configure proxy with ws: true or a custom configure.\n */\nexport function createAppletBackendProxy(opts: {\n  basePath: string\n  backendUrl: string\n}): Record<string, string> {\n  const base = opts.basePath.replace(/\\/+$/, '')\n  const target = opts.backendUrl.replace(/\\/+$/, '')\n  return {\n    [base + '/rpc']: target,\n    [base + '/stream']: target,\n  }\n}\n\n/**\n * Returns resolve.alias entries to point @iota-uz/sdk and @iota-uz/sdk/bichat to a local dist.\n * Use when IOTA_SDK_DIST is set or sdkDistDir is passed, so the app uses the local SDK build with HMR.\n */\nexport function createLocalSdkAliases(opts?: {\n  enabled?: boolean\n  sdkDistDir?: string\n}): Array<{ find: string | RegExp; replacement: string }> {\n  const enabled = opts?.enabled ?? Boolean(opts?.sdkDistDir ?? process.env.IOTA_SDK_DIST)\n  const dir = opts?.sdkDistDir ?? process.env.IOTA_SDK_DIST\n  if (!enabled || !dir) return []\n  const sdkDist = path.resolve(dir)\n  return [\n    { find: /^@iota-uz\\/sdk\\/bichat$/, replacement: path.join(sdkDist, 'bichat/index.mjs') },\n    { find: /^@iota-uz\\/sdk$/, replacement: path.join(sdkDist, 'index.mjs') },\n  ]\n}\n\n/**\n * Merges base config with extend. Start with merged = { ...a, ...b } so no Vite fields from b are dropped.\n * We capture a.resolve, b.resolve, a.server, b.server, a.plugins, b.plugins before the spread so we never\n * read b's values as \"original\" a when merging. resolve.alias: only coerce to array when both sides are\n * actually arrays (concat); otherwise leave Record/object as-is and prefer b's value then a's.\n */\nfunction mergeConfig(a: UserConfig, b: UserConfig): UserConfig {\n  const aResolve = a.resolve\n  const bResolve = b.resolve\n  const aServer = a.server\n  const bServer = b.server\n  const aPlugins = a.plugins\n  const bPlugins = b.plugins\n\n  const merged: UserConfig = { ...a, ...b }\n\n  if (bResolve) {\n    const aAlias = aResolve?.alias\n    const bAlias = bResolve.alias\n    const aIsArray = Array.isArray(aAlias)\n    const bIsArray = Array.isArray(bAlias)\n    const alias =\n      aIsArray && bIsArray\n        ? [...(aAlias as Array<{ find: string | RegExp; replacement: string }>), ...(bAlias as Array<{ find: string | RegExp; replacement: string }>)]\n        : (bAlias !== undefined ? bAlias : aResolve?.alias)\n    merged.resolve = {\n      ...aResolve,\n      ...bResolve,\n      alias,\n      dedupe: bResolve.dedupe ?? merged.resolve?.dedupe ?? aResolve?.dedupe,\n    }\n  }\n  if (bServer) {\n    merged.server = { ...aServer, ...bServer }\n  }\n  if (bPlugins) {\n    merged.plugins = [...(aPlugins ?? []), ...bPlugins]\n  }\n  return merged\n}\n","/**\n * Vite plugin that provides a virtual module exporting the compiled applet CSS string\n * for Shadow DOM injection (defineReactAppletElement({ styles })).\n * Can compile CSS via Tailwind CLI in the plugin or fall back to reading a prebuilt file.\n */\nimport type { Plugin } from 'vite'\nimport { spawnSync } from 'node:child_process'\nimport crypto from 'node:crypto'\nimport fs from 'node:fs'\nimport { createRequire } from 'node:module'\nimport os from 'node:os'\nimport path from 'node:path'\n\nexport const VIRTUAL_APPLET_STYLES_ID = 'virtual:applet-styles'\nconst RESOLVED_ID = '\\0' + VIRTUAL_APPLET_STYLES_ID\n\nexport type AppletStylesVirtualModuleOptions = {\n  /**\n   * Input CSS for Tailwind (e.g. src/index.css). When set, the plugin tries to run Tailwind CLI to compile.\n   * Default: \"src/index.css\"\n   */\n  inputCss?: string\n  /**\n   * Path to Tailwind config (optional). If not set, CLI uses its default lookup.\n   */\n  tailwindConfigPath?: string\n  /**\n   * Path to the compiled CSS file when not using Tailwind CLI (fallback), or when Tailwind is not available.\n   * Default: \"dist/style.css\"\n   */\n  outputCssPath?: string\n  /**\n   * CSS to prepend: package specifiers (e.g. \"@iota-uz/sdk/bichat/styles.css\") or paths relative to project root.\n   * Specifiers are resolved via Node resolution from the project root.\n   * Default: []\n   */\n  prependCss?: string[]\n}\n\n/**\n * Resolves a prepend CSS entry: absolute paths returned as-is; non-relative, non-absolute\n * specifiers (e.g. @iota-uz/sdk/bichat/styles.css or some-lib/styles.css) are resolved via\n * Node module resolution first; relative paths are joined to root.\n */\nfunction resolvePrependPath(specifierOrPath: string, root: string): string | null {\n  if (path.isAbsolute(specifierOrPath)) {\n    return specifierOrPath\n  }\n  if (!specifierOrPath.startsWith('.') && !specifierOrPath.startsWith('/')) {\n    try {\n      const req = createRequire(path.join(root, 'package.json'))\n      return req.resolve(specifierOrPath)\n    } catch {\n      return null\n    }\n  }\n  return path.join(root, specifierOrPath)\n}\n\n/**\n * Creates a Vite plugin that registers virtual:applet-styles and exports the compiled CSS string.\n * When inputCss is set, tries to run Tailwind CLI to compile; if Tailwind is not available, falls back to reading outputCssPath.\n */\nexport function createAppletStylesVirtualModulePlugin(\n  options: AppletStylesVirtualModuleOptions = {}\n): Plugin {\n  const inputCss = options.inputCss ?? 'src/index.css'\n  const outputCssPath = options.outputCssPath ?? 'dist/style.css'\n  const tailwindConfigPath = options.tailwindConfigPath\n  const prependCss = options.prependCss ?? []\n  let root = process.cwd()\n\n  return {\n    name: 'applet-styles-virtual-module',\n    configResolved(config) {\n      root = config.root\n    },\n    resolveId(id: string) {\n      if (id === VIRTUAL_APPLET_STYLES_ID) return RESOLVED_ID\n      return null\n    },\n    load(id: string) {\n      if (id !== RESOLVED_ID) return null\n\n      const parts: string[] = []\n\n      for (const p of prependCss) {\n        const full = resolvePrependPath(p, root)\n        if (full) {\n          try {\n            parts.push(fs.readFileSync(full, 'utf-8'))\n          } catch {\n            // Prepend file missing (e.g. optional SDK styles); skip\n          }\n        }\n      }\n\n      const inputPath = path.join(root, inputCss)\n      let mainCss: string | null = null\n\n      // Try Tailwind CLI if input file exists. spawnSync blocks the event loop; for parallel builds consider a random suffix (e.g. crypto.randomUUID()).\n      if (fs.existsSync(inputPath)) {\n        const tmpFile = path.join(os.tmpdir(), `applet-styles-${Date.now()}-${crypto.randomUUID()}.css`)\n        const args = ['-i', inputPath, '-o', tmpFile]\n        if (tailwindConfigPath) {\n          const configPath = path.join(root, tailwindConfigPath)\n          if (fs.existsSync(configPath)) {\n            args.push('-c', configPath)\n          }\n        }\n        // Use platform-specific executable and no shell so args (paths with spaces) are passed safely on Windows.\n        const pnpmCmd = process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm'\n        const result = spawnSync(pnpmCmd, ['exec', 'tailwindcss', ...args], {\n          cwd: root,\n          stdio: 'pipe',\n        })\n        if (result.status === 0 && fs.existsSync(tmpFile)) {\n          mainCss = fs.readFileSync(tmpFile, 'utf-8')\n          try {\n            fs.unlinkSync(tmpFile)\n          } catch {\n            /* ignore */\n          }\n        }\n      }\n\n      if (mainCss === null) {\n        const fallbackPath = path.isAbsolute(outputCssPath) ? outputCssPath : path.join(root, outputCssPath)\n        try {\n          mainCss = fs.readFileSync(fallbackPath, 'utf-8')\n        } catch {\n          if (process.env.NODE_ENV !== 'production') {\n            console.warn(\n              `[applet-styles] Could not compile via Tailwind CLI and ${fallbackPath} not found; export empty string. Install tailwindcss in the project or build CSS first.`\n            )\n          }\n          mainCss = ''\n        }\n      }\n\n      parts.push(mainCss)\n      const css = parts.join('\\n')\n      return `export default ${JSON.stringify(css)}`\n    },\n  }\n}\n\n/**\n * Convenience plugin for BiChat applets: compiles app CSS and prepends SDK BiChat styles.\n * Uses default input src/index.css and package specifier @iota-uz/sdk/bichat/styles.css.\n */\nexport function createBichatStylesPlugin(\n  options: Omit<AppletStylesVirtualModuleOptions, 'prependCss'> = {}\n): Plugin {\n  return createAppletStylesVirtualModulePlugin({\n    ...options,\n    inputCss: options.inputCss ?? 'src/index.css',\n    outputCssPath: options.outputCssPath ?? 'dist/style.css',\n    prependCss: ['@iota-uz/sdk/bichat/styles.css'],\n  })\n}\n"]}

package/dist/applet/vite.d.cts

@@ -0,0 +1,115 @@
+import { UserConfig, Plugin } from 'vite';
+
+/**
+ * Applet Frontend Kit: Vite config helpers for applets running behind a base path
+ * with dev proxy and optional local SDK aliasing.
+ */
+
+type AppletViteOptions = {
+    /** Applet base path (e.g. "/admin/ali/chat" or "/bi-chat"); overridden by applet-dev.json when present. */
+    basePath: string;
+    /** Backend URL for proxy (e.g. "http://localhost:3200"); overridden by applet-dev.json when present. */
+    backendUrl: string;
+    /** Directory containing applet-dev.json (default: process.cwd()). When set, base/port/proxy use manifest if present. */
+    viteConfigDir?: string;
+    /** Enable Vite aliases to local SDK dist for HMR when iterating on SDK (default: from IOTA_SDK_DIST) */
+    enableLocalSdkAliases?: boolean;
+    /** Override SDK dist directory when enableLocalSdkAliases is true (default: process.env.IOTA_SDK_DIST) */
+    sdkDistDir?: string;
+    /** Merge additional Vite config */
+    extend?: UserConfig;
+};
+/** Shape of applet-dev.json written by the Go dev runner (single source of truth when using `just dev <name>`). */
+type AppletDevManifest = {
+    basePath: string;
+    assetsBase: string;
+    vitePort: number;
+    backendUrl: string;
+};
+/**
+ * Reads applet-dev.json from viteDir (default process.cwd()). When using `just dev <name>`, the Go runner writes this file.
+ * Returns null if file is missing or invalid (env vars remain the fallback).
+ */
+declare function readAppletDevManifest(viteDir?: string): AppletDevManifest | null;
+type AppletDevManifestOrNull = AppletDevManifest | null;
+/**
+ * Returns base URL for assets (with trailing slash). Prefers manifest when provided (avoids re-reading file), then applet-dev.json, then APPLET_ASSETS_BASE env.
+ */
+declare function getAppletAssetsBase(viteDir?: string, manifest?: AppletDevManifestOrNull): string;
+/**
+ * Returns dev server port. Prefers manifest when provided (avoids re-reading file), then applet-dev.json, then APPLET_VITE_PORT env.
+ */
+declare function getAppletVitePort(defaultPort?: number, viteDir?: string, manifest?: AppletDevManifestOrNull): number;
+/**
+ * Builds a full Vite config for an applet: base, port, dedupe, proxy, optional local SDK aliases.
+ * When applet-dev.json is present (e.g. when using `just dev <name>`), base, port, basePath, and backendUrl come from it.
+ *
+ * **Merge semantics for `extend`:** When you pass `extend`, it is merged with the base config as follows:
+ * - **resolve.alias**: arrays are concatenated (base aliases first, then extend aliases).
+ * - **plugins**: arrays are concatenated (base plugins first, then extend plugins).
+ * - **server**, **base**, **resolve.dedupe** and other scalar/object fields: extend overrides base (Object.assign-style).
+ * To fully override the base config, spread first: `defineConfig({ ...createAppletViteConfig(opts), ...yourOverrides })`.
+ */
+declare function createAppletViteConfig(opts: AppletViteOptions): UserConfig;
+/**
+ * Returns proxy entries for applet RPC and stream under basePath.
+ * Use as server.proxy in Vite config.
+ * Note: /stream is SSE; plain string targets do not set ws or changeOrigin. If WebSocket upgrade or SSE proxying issues arise, configure proxy with ws: true or a custom configure.
+ */
+declare function createAppletBackendProxy(opts: {
+    basePath: string;
+    backendUrl: string;
+}): Record<string, string>;
+/**
+ * Returns resolve.alias entries to point @iota-uz/sdk and @iota-uz/sdk/bichat to a local dist.
+ * Use when IOTA_SDK_DIST is set or sdkDistDir is passed, so the app uses the local SDK build with HMR.
+ */
+declare function createLocalSdkAliases(opts?: {
+    enabled?: boolean;
+    sdkDistDir?: string;
+}): Array<{
+    find: string | RegExp;
+    replacement: string;
+}>;
+
+/**
+ * Vite plugin that provides a virtual module exporting the compiled applet CSS string
+ * for Shadow DOM injection (defineReactAppletElement({ styles })).
+ * Can compile CSS via Tailwind CLI in the plugin or fall back to reading a prebuilt file.
+ */
+
+declare const VIRTUAL_APPLET_STYLES_ID = "virtual:applet-styles";
+type AppletStylesVirtualModuleOptions = {
+    /**
+     * Input CSS for Tailwind (e.g. src/index.css). When set, the plugin tries to run Tailwind CLI to compile.
+     * Default: "src/index.css"
+     */
+    inputCss?: string;
+    /**
+     * Path to Tailwind config (optional). If not set, CLI uses its default lookup.
+     */
+    tailwindConfigPath?: string;
+    /**
+     * Path to the compiled CSS file when not using Tailwind CLI (fallback), or when Tailwind is not available.
+     * Default: "dist/style.css"
+     */
+    outputCssPath?: string;
+    /**
+     * CSS to prepend: package specifiers (e.g. "@iota-uz/sdk/bichat/styles.css") or paths relative to project root.
+     * Specifiers are resolved via Node resolution from the project root.
+     * Default: []
+     */
+    prependCss?: string[];
+};
+/**
+ * Creates a Vite plugin that registers virtual:applet-styles and exports the compiled CSS string.
+ * When inputCss is set, tries to run Tailwind CLI to compile; if Tailwind is not available, falls back to reading outputCssPath.
+ */
+declare function createAppletStylesVirtualModulePlugin(options?: AppletStylesVirtualModuleOptions): Plugin;
+/**
+ * Convenience plugin for BiChat applets: compiles app CSS and prepends SDK BiChat styles.
+ * Uses default input src/index.css and package specifier @iota-uz/sdk/bichat/styles.css.
+ */
+declare function createBichatStylesPlugin(options?: Omit<AppletStylesVirtualModuleOptions, 'prependCss'>): Plugin;
+
+export { type AppletDevManifest, type AppletStylesVirtualModuleOptions, type AppletViteOptions, VIRTUAL_APPLET_STYLES_ID, createAppletBackendProxy, createAppletStylesVirtualModulePlugin, createAppletViteConfig, createBichatStylesPlugin, createLocalSdkAliases, getAppletAssetsBase, getAppletVitePort, readAppletDevManifest };

package/dist/applet/vite.d.ts

@@ -0,0 +1,115 @@
+import { UserConfig, Plugin } from 'vite';
+
+/**
+ * Applet Frontend Kit: Vite config helpers for applets running behind a base path
+ * with dev proxy and optional local SDK aliasing.
+ */
+
+type AppletViteOptions = {
+    /** Applet base path (e.g. "/admin/ali/chat" or "/bi-chat"); overridden by applet-dev.json when present. */
+    basePath: string;
+    /** Backend URL for proxy (e.g. "http://localhost:3200"); overridden by applet-dev.json when present. */
+    backendUrl: string;
+    /** Directory containing applet-dev.json (default: process.cwd()). When set, base/port/proxy use manifest if present. */
+    viteConfigDir?: string;
+    /** Enable Vite aliases to local SDK dist for HMR when iterating on SDK (default: from IOTA_SDK_DIST) */
+    enableLocalSdkAliases?: boolean;
+    /** Override SDK dist directory when enableLocalSdkAliases is true (default: process.env.IOTA_SDK_DIST) */
+    sdkDistDir?: string;
+    /** Merge additional Vite config */
+    extend?: UserConfig;
+};
+/** Shape of applet-dev.json written by the Go dev runner (single source of truth when using `just dev <name>`). */
+type AppletDevManifest = {
+    basePath: string;
+    assetsBase: string;
+    vitePort: number;
+    backendUrl: string;
+};
+/**
+ * Reads applet-dev.json from viteDir (default process.cwd()). When using `just dev <name>`, the Go runner writes this file.
+ * Returns null if file is missing or invalid (env vars remain the fallback).
+ */
+declare function readAppletDevManifest(viteDir?: string): AppletDevManifest | null;
+type AppletDevManifestOrNull = AppletDevManifest | null;
+/**
+ * Returns base URL for assets (with trailing slash). Prefers manifest when provided (avoids re-reading file), then applet-dev.json, then APPLET_ASSETS_BASE env.
+ */
+declare function getAppletAssetsBase(viteDir?: string, manifest?: AppletDevManifestOrNull): string;
+/**
+ * Returns dev server port. Prefers manifest when provided (avoids re-reading file), then applet-dev.json, then APPLET_VITE_PORT env.
+ */
+declare function getAppletVitePort(defaultPort?: number, viteDir?: string, manifest?: AppletDevManifestOrNull): number;
+/**
+ * Builds a full Vite config for an applet: base, port, dedupe, proxy, optional local SDK aliases.
+ * When applet-dev.json is present (e.g. when using `just dev <name>`), base, port, basePath, and backendUrl come from it.
+ *
+ * **Merge semantics for `extend`:** When you pass `extend`, it is merged with the base config as follows:
+ * - **resolve.alias**: arrays are concatenated (base aliases first, then extend aliases).
+ * - **plugins**: arrays are concatenated (base plugins first, then extend plugins).
+ * - **server**, **base**, **resolve.dedupe** and other scalar/object fields: extend overrides base (Object.assign-style).
+ * To fully override the base config, spread first: `defineConfig({ ...createAppletViteConfig(opts), ...yourOverrides })`.
+ */
+declare function createAppletViteConfig(opts: AppletViteOptions): UserConfig;
+/**
+ * Returns proxy entries for applet RPC and stream under basePath.
+ * Use as server.proxy in Vite config.
+ * Note: /stream is SSE; plain string targets do not set ws or changeOrigin. If WebSocket upgrade or SSE proxying issues arise, configure proxy with ws: true or a custom configure.
+ */
+declare function createAppletBackendProxy(opts: {
+    basePath: string;
+    backendUrl: string;
+}): Record<string, string>;
+/**
+ * Returns resolve.alias entries to point @iota-uz/sdk and @iota-uz/sdk/bichat to a local dist.
+ * Use when IOTA_SDK_DIST is set or sdkDistDir is passed, so the app uses the local SDK build with HMR.
+ */
+declare function createLocalSdkAliases(opts?: {
+    enabled?: boolean;
+    sdkDistDir?: string;
+}): Array<{
+    find: string | RegExp;
+    replacement: string;
+}>;
+
+/**
+ * Vite plugin that provides a virtual module exporting the compiled applet CSS string
+ * for Shadow DOM injection (defineReactAppletElement({ styles })).
+ * Can compile CSS via Tailwind CLI in the plugin or fall back to reading a prebuilt file.
+ */
+
+declare const VIRTUAL_APPLET_STYLES_ID = "virtual:applet-styles";
+type AppletStylesVirtualModuleOptions = {
+    /**
+     * Input CSS for Tailwind (e.g. src/index.css). When set, the plugin tries to run Tailwind CLI to compile.
+     * Default: "src/index.css"
+     */
+    inputCss?: string;
+    /**
+     * Path to Tailwind config (optional). If not set, CLI uses its default lookup.
+     */
+    tailwindConfigPath?: string;
+    /**
+     * Path to the compiled CSS file when not using Tailwind CLI (fallback), or when Tailwind is not available.
+     * Default: "dist/style.css"
+     */
+    outputCssPath?: string;
+    /**
+     * CSS to prepend: package specifiers (e.g. "@iota-uz/sdk/bichat/styles.css") or paths relative to project root.
+     * Specifiers are resolved via Node resolution from the project root.
+     * Default: []
+     */
+    prependCss?: string[];
+};
+/**
+ * Creates a Vite plugin that registers virtual:applet-styles and exports the compiled CSS string.
+ * When inputCss is set, tries to run Tailwind CLI to compile; if Tailwind is not available, falls back to reading outputCssPath.
+ */
+declare function createAppletStylesVirtualModulePlugin(options?: AppletStylesVirtualModuleOptions): Plugin;
+/**
+ * Convenience plugin for BiChat applets: compiles app CSS and prepends SDK BiChat styles.
+ * Uses default input src/index.css and package specifier @iota-uz/sdk/bichat/styles.css.
+ */
+declare function createBichatStylesPlugin(options?: Omit<AppletStylesVirtualModuleOptions, 'prependCss'>): Plugin;
+
+export { type AppletDevManifest, type AppletStylesVirtualModuleOptions, type AppletViteOptions, VIRTUAL_APPLET_STYLES_ID, createAppletBackendProxy, createAppletStylesVirtualModulePlugin, createAppletViteConfig, createBichatStylesPlugin, createLocalSdkAliases, getAppletAssetsBase, getAppletVitePort, readAppletDevManifest };