@swarm.ing/pieui 2.0.29 → 2.0.31

package/dist/cli.js

@@ -188157,7 +188157,7 @@ var require_typescript_json_schema = __commonJS((exports2) => {
 });
 
 // src/cli.ts
-var import_node_path22 = __toESM(require("node:path"));
+var import_node_path23 = __toESM(require("node:path"));
 
 // src/code/args.ts
 var VALID_CARD_ACTIONS = [
@@ -188171,7 +188171,8 @@ var VALID_CARD_ACTIONS = [
   "remote",
   "dump-metadata",
   "check-sync",
-  "add-story"
+  "add-story",
+  "generate-preview"
 ];
 var VALID_CARD_REMOTE_ACTIONS = [
   "push",
@@ -188375,6 +188376,9 @@ var parseArgs = (argv) => {
     } else if (action === "add-story") {
       result.componentName = positionals[0];
       result.cardAddStoryForce = boolFlags.force;
+    } else if (action === "generate-preview") {
+      result.componentName = positionals[0];
+      result.cardGeneratePreviewOut = flags.dumpMetadataOut;
     } else if (action === "remote") {
       const sub = positionals[0];
       if (sub && VALID_CARD_REMOTE_ACTIONS.includes(sub)) {
@@ -188460,6 +188464,7 @@ var ALL_LINES = [
   "  card list-events <Name>                          List methods keys on the registered PieCard",
   "  card add-event <Name> <event>                    Add a new methods key with a default handler",
   "  card add-story <Name> [--force]                  Generate a Storybook stories.tsx wired to PieCard methods",
+  "  card generate-preview <Name> [--out file.png]    Render the component story via storycap and save a PNG preview",
   "  card dump-metadata <Name> [--out file.json]      Dump full PieMetadata JSON for the component",
   "  card check-sync <Name>                           Compare TS ↔ Python metadata; prompt for backend project path if not configured",
   "  card remote list [--user U] [--project S]        List remote components",
@@ -188531,6 +188536,7 @@ var CARD_LINES = [
   "  list-events <Name>                          List methods keys on the registered PieCard",
   "  add-event <Name> <event>                    Add a new methods key with a default handler",
   "  add-story <Name> [--force]                  Generate a Storybook stories.tsx wired to PieCard methods (--force overwrites)",
+  "  generate-preview <Name> [--out file.png]    Render the component story via storycap and save a PNG preview",
   "  dump-metadata <Name> [--out file.json]      Dump full PieMetadata JSON for the component",
   "  check-sync <Name>                           Compare TS ↔ Python metadata; prompts for backend project path",
   "  remote ...                                  Remote storage operations (see `pieui card remote --help`)",
@@ -196682,13 +196688,152 @@ var cardAddStoryCommand = (componentName, options = {}) => {
   } else if (result.addedPerSite.length === 0) {
     console.log(`[pieui] <PieCard> forwarding already complete in ${uiPath}`);
   }
+  const mainPath = findStorybookMainPath(process.cwd());
+  if (!mainPath) {
+    const bunBin = process.env.PIEUI_CREATE_BUN_BIN || "bun";
+    installAndWireStorybook(process.cwd(), bunBin);
+  } else {
+    const addedAddon = patchStorybookMainAddons(mainPath);
+    const addedStories = patchStorybookMainStories(mainPath);
+    if (addedAddon) {
+      console.log(`[pieui] Added '${PIEUI_STORYBOOK_ADDON}' to ${mainPath}`);
+    }
+    if (addedStories) {
+      console.log(`[pieui] Added '${PIEUI_STORYBOOK_STORIES_GLOB}' to stories in ${mainPath}`);
+    }
+    if (!addedAddon && !addedStories) {
+      console.log(`[pieui] Storybook config already wired (${import_node_path15.default.relative(process.cwd(), mainPath)})`);
+    }
+  }
   printRequirements(cardAddStoryRequirements(componentName));
 };
 
-// src/code/commands/cardAddFromMeta.ts
+// src/code/commands/cardGeneratePreview.ts
 var import_node_fs15 = __toESM(require("node:fs"));
+var import_node_http = __toESM(require("node:http"));
+var import_node_os = __toESM(require("node:os"));
 var import_node_path16 = __toESM(require("node:path"));
 var import_node_child_process3 = require("node:child_process");
+var STORYBOOK_PORT = 6006;
+var STORY_TITLE_NAMESPACE = "PieComponents";
+var isStorybookReachable = (port) => new Promise((resolve) => {
+  const req = import_node_http.default.get({ hostname: "localhost", port, path: "/index.json" }, (res) => {
+    res.resume();
+    resolve(res.statusCode === 200);
+  });
+  req.on("error", () => resolve(false));
+  req.setTimeout(1500, () => {
+    req.destroy();
+    resolve(false);
+  });
+});
+var waitForStorybook = async (port, timeoutMs) => {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (await isStorybookReachable(port))
+      return true;
+    await new Promise((r) => setTimeout(r, 1500));
+  }
+  return false;
+};
+var killProcessTree = (proc) => {
+  if (!proc.pid)
+    return;
+  try {
+    process.kill(-proc.pid, "SIGTERM");
+  } catch {
+    try {
+      proc.kill("SIGTERM");
+    } catch {}
+  }
+};
+var cardGeneratePreviewCommand = async (componentName, options = {}) => {
+  if (!componentName) {
+    throw new Error("Component name is required");
+  }
+  const settings = loadSettings();
+  const componentDir = import_node_path16.default.join(settings.componentsDir, componentName);
+  if (!import_node_fs15.default.existsSync(componentDir)) {
+    throw new Error(`Component directory not found: ${componentDir}`);
+  }
+  const storyPath = import_node_path16.default.join(componentDir, `${componentName}.stories.tsx`);
+  if (!import_node_fs15.default.existsSync(storyPath)) {
+    throw new Error(`Story file not found: ${storyPath}
+` + `Run \`pieui card add-story ${componentName}\` first.`);
+  }
+  const outPath = import_node_path16.default.resolve(process.cwd(), options.out || import_node_path16.default.join(componentDir, "preview.png"));
+  import_node_fs15.default.mkdirSync(import_node_path16.default.dirname(outPath), { recursive: true });
+  const bunBin = process.env.PIEUI_CREATE_BUN_BIN || "bun";
+  let sbProc = null;
+  const alreadyRunning = await isStorybookReachable(STORYBOOK_PORT);
+  if (!alreadyRunning) {
+    console.log(`[pieui] Storybook not running on :${STORYBOOK_PORT} — starting it temporarily...`);
+    sbProc = import_node_child_process3.spawn(bunBin, ["run", "storybook"], {
+      cwd: process.cwd(),
+      stdio: "ignore",
+      env: process.env,
+      detached: true
+    });
+    sbProc.unref();
+    const ready = await waitForStorybook(STORYBOOK_PORT, 180000);
+    if (!ready) {
+      killProcessTree(sbProc);
+      throw new Error("Storybook failed to become reachable within 3 minutes");
+    }
+    console.log(`[pieui] Storybook ready on :${STORYBOOK_PORT}`);
+  } else {
+    console.log(`[pieui] Using running Storybook on :${STORYBOOK_PORT}`);
+  }
+  const tmpDir = import_node_fs15.default.mkdtempSync(import_node_path16.default.join(import_node_os.default.tmpdir(), "pieui-storycap-"));
+  try {
+    const include = `${STORY_TITLE_NAMESPACE}/${componentName}/*`;
+    console.log(`[pieui] Running storycap for "${include}"...`);
+    const result = import_node_child_process3.spawnSync(bunBin, [
+      "x",
+      "storycap@latest",
+      `http://localhost:${STORYBOOK_PORT}`,
+      "--include",
+      include,
+      "--outDir",
+      tmpDir,
+      "--serverTimeout",
+      "60000"
+    ], {
+      cwd: process.cwd(),
+      stdio: "inherit",
+      env: process.env
+    });
+    if (result.error) {
+      throw result.error;
+    }
+    if (result.status !== 0) {
+      throw new Error(`storycap exited with code ${result.status ?? "unknown"}`);
+    }
+    const producedDir = import_node_path16.default.join(tmpDir, STORY_TITLE_NAMESPACE, componentName);
+    if (!import_node_fs15.default.existsSync(producedDir)) {
+      throw new Error(`storycap finished but no PNGs were produced under ${producedDir}
+` + `Tmp listing: ${import_node_fs15.default.readdirSync(tmpDir).join(", ") || "(empty)"}`);
+    }
+    const pngs = import_node_fs15.default.readdirSync(producedDir).filter((f) => f.endsWith(".png")).sort();
+    if (pngs.length === 0) {
+      throw new Error(`No PNGs in ${producedDir}`);
+    }
+    const picked = import_node_path16.default.join(producedDir, pngs[0]);
+    import_node_fs15.default.copyFileSync(picked, outPath);
+    console.log(`[pieui] Preview written: ${outPath}` + (pngs.length > 1 ? ` (picked ${pngs[0]}; other states available: ${pngs.slice(1).join(", ")})` : ""));
+  } finally {
+    import_node_fs15.default.rmSync(tmpDir, { recursive: true, force: true });
+    if (sbProc) {
+      killProcessTree(sbProc);
+      console.log("[pieui] Storybook stopped");
+    }
+  }
+};
+
+// src/code/commands/cardAddFromMeta.ts
+var import_node_fs16 = __toESM(require("node:fs"));
+var import_node_path17 = __toESM(require("node:path"));
+var import_node_child_process4 = require("node:child_process");
 
 // src/code/jsonSchemaToTs.ts
 var INDENT = "    ";
@@ -196768,11 +196913,11 @@ var jsonSchemaToTsType = (schema) => renderType(asSchema(schema), 0);
 // src/code/commands/cardAddFromMeta.ts
 var PIE_CONFIG_PATH = ".pie/config.json";
 var readBackendConfig = () => {
-  const configPath = import_node_path16.default.join(process.cwd(), PIE_CONFIG_PATH);
-  if (!import_node_fs15.default.existsSync(configPath))
+  const configPath = import_node_path17.default.join(process.cwd(), PIE_CONFIG_PATH);
+  if (!import_node_fs16.default.existsSync(configPath))
     return null;
   try {
-    const parsed = JSON.parse(import_node_fs15.default.readFileSync(configPath, "utf8"));
+    const parsed = JSON.parse(import_node_fs16.default.readFileSync(configPath, "utf8"));
     if (typeof parsed !== "object" || parsed === null)
       return null;
     return parsed;
@@ -196789,16 +196934,16 @@ var cardNameToClassFilename = (name) => {
   return snake.endsWith("_card") ? `${snake}.py` : `${snake}_card.py`;
 };
 var resolveSource = (fromRaw, cardName, cfg) => {
-  if (fromRaw && import_node_fs15.default.existsSync(fromRaw)) {
-    const stat = import_node_fs15.default.statSync(fromRaw);
-    const abs = import_node_path16.default.resolve(fromRaw);
+  if (fromRaw && import_node_fs16.default.existsSync(fromRaw)) {
+    const stat = import_node_fs16.default.statSync(fromRaw);
+    const abs = import_node_path17.default.resolve(fromRaw);
     if (stat.isFile() && abs.endsWith(".json")) {
       return { kind: "json-file", path: abs };
     }
     if (stat.isFile() && abs.endsWith(".py")) {
-      const componentsDir2 = import_node_path16.default.dirname(abs);
-      const backendRoot2 = import_node_path16.default.dirname(componentsDir2);
-      const inferred = classFilenameToCardName(import_node_path16.default.basename(abs));
+      const componentsDir2 = import_node_path17.default.dirname(abs);
+      const backendRoot2 = import_node_path17.default.dirname(componentsDir2);
+      const inferred = classFilenameToCardName(import_node_path17.default.basename(abs));
       return {
         kind: "py-file",
         backendRoot: backendRoot2,
@@ -196806,7 +196951,7 @@ var resolveSource = (fromRaw, cardName, cfg) => {
       };
     }
     if (stat.isDirectory()) {
-      const backendRoot2 = import_node_path16.default.dirname(abs);
+      const backendRoot2 = import_node_path17.default.dirname(abs);
       return { kind: "name", backendRoot: backendRoot2, cardName };
     }
     throw new Error(`--from path is not a recognized source: ${fromRaw}`);
@@ -196815,15 +196960,15 @@ var resolveSource = (fromRaw, cardName, cfg) => {
     if (!cfg?.backendComponentsDir) {
       throw new Error(`--from "${fromRaw}" is not an existing path and no backendComponentsDir is configured in ${PIE_CONFIG_PATH}`);
     }
-    const componentsDir2 = import_node_path16.default.resolve(cfg.backendComponentsDir);
-    const backendRoot2 = import_node_path16.default.dirname(componentsDir2);
+    const componentsDir2 = import_node_path17.default.resolve(cfg.backendComponentsDir);
+    const backendRoot2 = import_node_path17.default.dirname(componentsDir2);
     return { kind: "name", backendRoot: backendRoot2, cardName: fromRaw };
   }
   if (!cfg?.backendComponentsDir) {
     throw new Error(`No --from provided and no backendComponentsDir configured in ${PIE_CONFIG_PATH}`);
   }
-  const componentsDir = import_node_path16.default.resolve(cfg.backendComponentsDir);
-  const backendRoot = import_node_path16.default.dirname(componentsDir);
+  const componentsDir = import_node_path17.default.resolve(cfg.backendComponentsDir);
+  const backendRoot = import_node_path17.default.dirname(componentsDir);
   return { kind: "name", backendRoot, cardName };
 };
 var unwrapTypescriptEnvelope2 = (parsed) => {
@@ -196840,11 +196985,11 @@ var unwrapTypescriptEnvelope2 = (parsed) => {
 };
 var fetchMetadata = (source) => {
   if (source.kind === "json-file") {
-    const raw = import_node_fs15.default.readFileSync(source.path, "utf8");
+    const raw = import_node_fs16.default.readFileSync(source.path, "utf8");
     return unwrapTypescriptEnvelope2(JSON.parse(raw));
   }
   console.log(`[pieui] Invoking: pie card dump-metadata ${source.cardName} (cwd: ${source.backendRoot})`);
-  const result = import_node_child_process3.spawnSync("pie", ["card", "dump-metadata", source.cardName], {
+  const result = import_node_child_process4.spawnSync("pie", ["card", "dump-metadata", source.cardName], {
     cwd: source.backendRoot,
     stdio: ["ignore", "pipe", "pipe"],
     env: process.env
@@ -196976,10 +197121,10 @@ var renderUI = (componentName, meta, inputInterfaceName) => {
 };
 var updateRegistryFile2 = (componentsDir, componentName) => {
   const registryPath = resolveRegistryPath(componentsDir);
-  if (!import_node_fs15.default.existsSync(registryPath)) {
+  if (!import_node_fs16.default.existsSync(registryPath)) {
     throw new Error('registry.ts not found. Run "pieui init" first.');
   }
-  let registryContent = import_node_fs15.default.readFileSync(registryPath, "utf8");
+  let registryContent = import_node_fs16.default.readFileSync(registryPath, "utf8");
   const importRegex = new RegExp(`["']@/piecomponents/${componentName}["']`);
   if (importRegex.test(registryContent)) {
     throw new Error(`Component ${componentName} is already registered in registry.ts`);
@@ -196988,17 +197133,17 @@ var updateRegistryFile2 = (componentsDir, componentName) => {
   registryContent = registryContent.trimEnd() + `
 ` + importLine + `
 `;
-  import_node_fs15.default.writeFileSync(registryPath, registryContent, "utf8");
+  import_node_fs16.default.writeFileSync(registryPath, registryContent, "utf8");
 };
 var hasBackendSourceFor = (componentName) => {
   const cfg = readBackendConfig();
   if (!cfg?.backendComponentsDir)
     return false;
-  const componentsDir = import_node_path16.default.resolve(cfg.backendComponentsDir);
-  if (!import_node_fs15.default.existsSync(componentsDir))
+  const componentsDir = import_node_path17.default.resolve(cfg.backendComponentsDir);
+  if (!import_node_fs16.default.existsSync(componentsDir))
     return false;
-  const candidate = import_node_path16.default.join(componentsDir, cardNameToClassFilename(componentName));
-  return import_node_fs15.default.existsSync(candidate);
+  const candidate = import_node_path17.default.join(componentsDir, cardNameToClassFilename(componentName));
+  return import_node_fs16.default.existsSync(candidate);
 };
 var cardAddFromMetaCommand = (componentName, componentType, fromRaw) => {
   if (!componentName) {
@@ -197010,8 +197155,8 @@ var cardAddFromMetaCommand = (componentName, componentType, fromRaw) => {
   const cfg = readBackendConfig();
   const source = resolveSource(fromRaw, componentName, cfg);
   if (source.kind === "name") {
-    const candidate = import_node_path16.default.join(source.backendRoot, import_node_path16.default.basename(import_node_path16.default.resolve(cfg.backendComponentsDir)), cardNameToClassFilename(source.cardName));
-    if (!import_node_fs15.default.existsSync(candidate)) {
+    const candidate = import_node_path17.default.join(source.backendRoot, import_node_path17.default.basename(import_node_path17.default.resolve(cfg.backendComponentsDir)), cardNameToClassFilename(source.cardName));
+    if (!import_node_fs16.default.existsSync(candidate)) {
       console.warn(`[pieui] Note: expected backend file ${candidate} not found; relying on pie's resolution`);
     }
   }
@@ -197019,30 +197164,30 @@ var cardAddFromMetaCommand = (componentName, componentType, fromRaw) => {
   console.log(`[pieui] Loaded metadata for "${meta.name}" (${meta.events.length} events, input: ${meta.inputPropsCode ? "yes" : "no"})`);
   const dataInterfaceName = extractTypeName(meta.propsCode) || `${componentName}Data`;
   const inputInterfaceName = meta.inputPropsCode ? extractTypeName(meta.inputPropsCode) || `${componentName}StoredInput` : null;
-  const pieComponentsDir = import_node_path16.default.join(process.cwd(), "piecomponents");
-  if (!import_node_fs15.default.existsSync(pieComponentsDir)) {
+  const pieComponentsDir = import_node_path17.default.join(process.cwd(), "piecomponents");
+  if (!import_node_fs16.default.existsSync(pieComponentsDir)) {
     throw new Error('piecomponents directory not found. Run "pieui init" first.');
   }
-  const componentDir = import_node_path16.default.join(pieComponentsDir, componentName);
-  if (import_node_fs15.default.existsSync(componentDir)) {
+  const componentDir = import_node_path17.default.join(pieComponentsDir, componentName);
+  if (import_node_fs16.default.existsSync(componentDir)) {
     throw new Error(`Component ${componentName} already exists`);
   }
   try {
-    import_node_fs15.default.mkdirSync(import_node_path16.default.join(componentDir, "ui"), { recursive: true });
-    import_node_fs15.default.mkdirSync(import_node_path16.default.join(componentDir, "types"), { recursive: true });
-    import_node_fs15.default.writeFileSync(import_node_path16.default.join(componentDir, "index.ts"), componentIndexTemplate(componentName), "utf8");
-    import_node_fs15.default.writeFileSync(import_node_path16.default.join(componentDir, "types", "index.ts"), renderTypes(componentName, componentType, meta, dataInterfaceName, inputInterfaceName), "utf8");
-    import_node_fs15.default.writeFileSync(import_node_path16.default.join(componentDir, "ui", `${componentName}.tsx`), renderUI(componentName, meta, inputInterfaceName), "utf8");
+    import_node_fs16.default.mkdirSync(import_node_path17.default.join(componentDir, "ui"), { recursive: true });
+    import_node_fs16.default.mkdirSync(import_node_path17.default.join(componentDir, "types"), { recursive: true });
+    import_node_fs16.default.writeFileSync(import_node_path17.default.join(componentDir, "index.ts"), componentIndexTemplate(componentName), "utf8");
+    import_node_fs16.default.writeFileSync(import_node_path17.default.join(componentDir, "types", "index.ts"), renderTypes(componentName, componentType, meta, dataInterfaceName, inputInterfaceName), "utf8");
+    import_node_fs16.default.writeFileSync(import_node_path17.default.join(componentDir, "ui", `${componentName}.tsx`), renderUI(componentName, meta, inputInterfaceName), "utf8");
     updateRegistryFile2(pieComponentsDir, componentName);
   } catch (error) {
-    import_node_fs15.default.rmSync(componentDir, { recursive: true, force: true });
+    import_node_fs16.default.rmSync(componentDir, { recursive: true, force: true });
     throw error;
   }
   console.log(`[pieui] Component ${componentName} ported from backend successfully`);
   console.log(`[pieui] Files created:`);
-  console.log(`  - ${import_node_path16.default.join(componentDir, "index.ts")}`);
-  console.log(`  - ${import_node_path16.default.join(componentDir, "types", "index.ts")}`);
-  console.log(`  - ${import_node_path16.default.join(componentDir, "ui", `${componentName}.tsx`)}`);
+  console.log(`  - ${import_node_path17.default.join(componentDir, "index.ts")}`);
+  console.log(`  - ${import_node_path17.default.join(componentDir, "types", "index.ts")}`);
+  console.log(`  - ${import_node_path17.default.join(componentDir, "ui", `${componentName}.tsx`)}`);
   console.log(`[pieui] Data interface: ${dataInterfaceName}`);
   if (inputInterfaceName) {
     console.log(`[pieui] Input interface: ${inputInterfaceName}`);
@@ -197102,8 +197247,8 @@ var pageAddCommand = (pagePath) => {
 };
 
 // src/code/commands/pageView.ts
-var import_node_fs16 = __toESM(require("node:fs"));
-var import_node_path17 = __toESM(require("node:path"));
+var import_node_fs17 = __toESM(require("node:fs"));
+var import_node_path18 = __toESM(require("node:path"));
 var normalizePagePath2 = (pagePath) => {
   const trimmed = pagePath.trim();
   if (!trimmed)
@@ -197112,7 +197257,7 @@ var normalizePagePath2 = (pagePath) => {
   const noRel = slashed.replace(/^\.\/+/, "");
   const noApp = noRel.replace(/^app\//, "");
   const noEdge = noApp.replace(/^\/+|\/+$/g, "");
-  const normalized = import_node_path17.default.posix.normalize(noEdge);
+  const normalized = import_node_path18.default.posix.normalize(noEdge);
   if (!normalized || normalized === ".") {
     throw new Error("Path is required for page view command");
   }
@@ -197123,11 +197268,11 @@ var normalizePagePath2 = (pagePath) => {
 };
 var pageViewCommand = (pagePath) => {
   const normalized = normalizePagePath2(pagePath);
-  const target = import_node_path17.default.join(process.cwd(), "app", normalized, "page.tsx");
-  if (!import_node_fs16.default.existsSync(target)) {
+  const target = import_node_path18.default.join(process.cwd(), "app", normalized, "page.tsx");
+  if (!import_node_fs17.default.existsSync(target)) {
     throw new Error(`Page file not found: ${target}`);
   }
-  const source = import_node_fs16.default.readFileSync(target, "utf8");
+  const source = import_node_fs17.default.readFileSync(target, "utf8");
   console.log(`[pieui] Path: ${target}`);
   console.log("");
   process.stdout.write(source);
@@ -197137,26 +197282,26 @@ var pageViewCommand = (pagePath) => {
 };
 
 // src/code/commands/pageAjax.ts
-var import_node_fs17 = __toESM(require("node:fs"));
-var import_node_path18 = __toESM(require("node:path"));
-var import_node_child_process4 = require("node:child_process");
+var import_node_fs18 = __toESM(require("node:fs"));
+var import_node_path19 = __toESM(require("node:path"));
+var import_node_child_process5 = require("node:child_process");
 var PIE_CONFIG_PATH2 = ".pie/config.json";
 var readBackendRoot = () => {
-  const configPath = import_node_path18.default.join(process.cwd(), PIE_CONFIG_PATH2);
-  if (!import_node_fs17.default.existsSync(configPath))
+  const configPath = import_node_path19.default.join(process.cwd(), PIE_CONFIG_PATH2);
+  if (!import_node_fs18.default.existsSync(configPath))
     return;
   try {
-    const parsed = JSON.parse(import_node_fs17.default.readFileSync(configPath, "utf8"));
+    const parsed = JSON.parse(import_node_fs18.default.readFileSync(configPath, "utf8"));
     if (typeof parsed !== "object" || parsed === null)
       return;
     const config = parsed;
     if (!config.backendPagesDir)
       return;
-    const pages = import_node_path18.default.resolve(config.backendPagesDir);
-    if (!import_node_fs17.default.existsSync(pages) || !import_node_fs17.default.statSync(pages).isDirectory()) {
+    const pages = import_node_path19.default.resolve(config.backendPagesDir);
+    if (!import_node_fs18.default.existsSync(pages) || !import_node_fs18.default.statSync(pages).isDirectory()) {
       return;
     }
-    return import_node_path18.default.dirname(pages);
+    return import_node_path19.default.dirname(pages);
   } catch {
     return;
   }
@@ -197173,7 +197318,7 @@ var pageAjaxCommand = (pageName, action, handlerName) => {
   }
   console.log(`[pieui] Delegating to backend: ${backendRoot}`);
   console.log(`[pieui]   pie page ajax ${pageName} ${action} ${handlerName}`);
-  const result = import_node_child_process4.spawnSync("pie", ["page", "ajax", pageName, action, handlerName], { cwd: backendRoot, stdio: "inherit", env: process.env });
+  const result = import_node_child_process5.spawnSync("pie", ["page", "ajax", pageName, action, handlerName], { cwd: backendRoot, stdio: "inherit", env: process.env });
   if (result.error) {
     throw new Error(`Failed to invoke \`pie\` in ${backendRoot}: ${result.error.message}`);
   }
@@ -197539,49 +197684,49 @@ var createPieAppCommand = (appName) => {
 };
 
 // src/code/commands/login.ts
-var import_node_child_process5 = require("node:child_process");
+var import_node_child_process6 = require("node:child_process");
 var import_node_crypto = require("node:crypto");
-var import_node_fs19 = __toESM(require("node:fs"));
-var import_node_path20 = __toESM(require("node:path"));
+var import_node_fs20 = __toESM(require("node:fs"));
+var import_node_path21 = __toESM(require("node:path"));
 
 // src/code/services/projectLinks.ts
-var import_node_fs18 = __toESM(require("node:fs"));
-var import_node_path19 = __toESM(require("node:path"));
+var import_node_fs19 = __toESM(require("node:fs"));
+var import_node_path20 = __toESM(require("node:path"));
 var readline3 = __toESM(require("node:readline/promises"));
 var PIE_CONFIG_DIR3 = ".pie";
 var PIE_CONFIG_FILE3 = "config.json";
-var configPathFor = (cwd) => import_node_path19.default.join(cwd, PIE_CONFIG_DIR3, PIE_CONFIG_FILE3);
+var configPathFor = (cwd) => import_node_path20.default.join(cwd, PIE_CONFIG_DIR3, PIE_CONFIG_FILE3);
 var readConfig2 = (cwd) => {
   const p = configPathFor(cwd);
-  if (!import_node_fs18.default.existsSync(p))
+  if (!import_node_fs19.default.existsSync(p))
     return {};
   try {
-    const parsed = JSON.parse(import_node_fs18.default.readFileSync(p, "utf8"));
+    const parsed = JSON.parse(import_node_fs19.default.readFileSync(p, "utf8"));
     return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : {};
   } catch {
     return {};
   }
 };
 var writeConfig2 = (cwd, config) => {
-  const dir = import_node_path19.default.join(cwd, PIE_CONFIG_DIR3);
-  import_node_fs18.default.mkdirSync(dir, { recursive: true });
-  import_node_fs18.default.writeFileSync(configPathFor(cwd), JSON.stringify(config, null, 2) + `
+  const dir = import_node_path20.default.join(cwd, PIE_CONFIG_DIR3);
+  import_node_fs19.default.mkdirSync(dir, { recursive: true });
+  import_node_fs19.default.writeFileSync(configPathFor(cwd), JSON.stringify(config, null, 2) + `
 `, "utf8");
 };
 var walkUpForPyproject2 = (start) => {
-  let dir = import_node_path19.default.resolve(start);
-  while (dir !== import_node_path19.default.dirname(dir)) {
-    if (import_node_fs18.default.existsSync(import_node_path19.default.join(dir, "pyproject.toml")))
+  let dir = import_node_path20.default.resolve(start);
+  while (dir !== import_node_path20.default.dirname(dir)) {
+    if (import_node_fs19.default.existsSync(import_node_path20.default.join(dir, "pyproject.toml")))
       return dir;
-    dir = import_node_path19.default.dirname(dir);
+    dir = import_node_path20.default.dirname(dir);
   }
   return null;
 };
 var ensureBackendDir2 = async (cwd) => {
   const config = readConfig2(cwd);
   if (config.backendProjectDir) {
-    const dir = import_node_path19.default.resolve(cwd, config.backendProjectDir);
-    if (import_node_fs18.default.existsSync(dir) && import_node_fs18.default.statSync(dir).isDirectory())
+    const dir = import_node_path20.default.resolve(cwd, config.backendProjectDir);
+    if (import_node_fs19.default.existsSync(dir) && import_node_fs19.default.statSync(dir).isDirectory())
       return dir;
     console.error(`[pieui] Configured backendProjectDir not found: ${dir}`);
   }
@@ -197606,9 +197751,9 @@ var ensureBackendDir2 = async (cwd) => {
     const raw = (await rl.question("[pieui] Path to backend (pie) project: ")).trim();
     if (!raw)
       return null;
-    const expanded = raw.startsWith("~") ? import_node_path19.default.join(process.env.HOME || "", raw.slice(1).replace(/^[\\/]/, "")) : raw;
-    const absolute = import_node_path19.default.resolve(expanded);
-    if (!import_node_fs18.default.existsSync(absolute) || !import_node_fs18.default.statSync(absolute).isDirectory()) {
+    const expanded = raw.startsWith("~") ? import_node_path20.default.join(process.env.HOME || "", raw.slice(1).replace(/^[\\/]/, "")) : raw;
+    const absolute = import_node_path20.default.resolve(expanded);
+    if (!import_node_fs19.default.existsSync(absolute) || !import_node_fs19.default.statSync(absolute).isDirectory()) {
       console.error(`[pieui] Not a directory: ${absolute}`);
       return null;
     }
@@ -197642,11 +197787,11 @@ var generateCode = (length = CODE_LENGTH) => {
 var tryOpenBrowser = (url) => {
   try {
     if (process.platform === "win32") {
-      import_node_child_process5.execFile("cmd", ["/c", "start", "", url], () => {});
+      import_node_child_process6.execFile("cmd", ["/c", "start", "", url], () => {});
     } else if (process.platform === "darwin") {
-      import_node_child_process5.execFile("open", [url], () => {});
+      import_node_child_process6.execFile("open", [url], () => {});
     } else {
-      import_node_child_process5.execFile("xdg-open", [url], () => {});
+      import_node_child_process6.execFile("xdg-open", [url], () => {});
     }
   } catch {}
 };
@@ -197677,8 +197822,8 @@ var appendPieCredentialsToEnv = (cwd, config) => {
   if (Object.keys(entries).length === 0) {
     return;
   }
-  const envPath = import_node_path20.default.join(cwd, ".env");
-  let content = import_node_fs19.default.existsSync(envPath) ? import_node_fs19.default.readFileSync(envPath, "utf8") : "";
+  const envPath = import_node_path21.default.join(cwd, ".env");
+  let content = import_node_fs20.default.existsSync(envPath) ? import_node_fs20.default.readFileSync(envPath, "utf8") : "";
   if (content.length > 0 && !content.endsWith(`
 `)) {
     content += `
@@ -197688,7 +197833,7 @@ var appendPieCredentialsToEnv = (cwd, config) => {
   content += `${additions.join(`
 `)}
 `;
-  import_node_fs19.default.writeFileSync(envPath, content, "utf8");
+  import_node_fs20.default.writeFileSync(envPath, content, "utf8");
   console.log(`[pie] Appended credentials to ${envPath}`);
 };
 async function loginCommand(options = {}) {
@@ -197709,8 +197854,8 @@ async function loginCommand(options = {}) {
   try {
     openBrowser(connectUrl);
   } catch {}
-  const pieDir = import_node_path20.default.join(cwd, ".pie");
-  const configPath = import_node_path20.default.join(pieDir, "config.json");
+  const pieDir = import_node_path21.default.join(cwd, ".pie");
+  const configPath = import_node_path21.default.join(pieDir, "config.json");
   const url = `${credentialsApi}?${new URLSearchParams({ code }).toString()}`;
   let first = true;
   while (true) {
@@ -197744,7 +197889,7 @@ async function loginCommand(options = {}) {
         throw new Error("Login succeeded but response had no 'config' field");
       }
       const credBlob = typeof record.config === "object" && record.config !== null && !Array.isArray(record.config) ? record.config : {};
-      import_node_fs19.default.mkdirSync(pieDir, { recursive: true });
+      import_node_fs20.default.mkdirSync(pieDir, { recursive: true });
       mergeConfig(cwd, credBlob);
       console.log(`[pie] Saved credentials to ${configPath}`);
       appendPieCredentialsToEnv(cwd, record.config);
@@ -197759,9 +197904,9 @@ async function loginCommand(options = {}) {
 }
 
 // src/code/commands/selfUpgrade.ts
-var import_node_child_process6 = require("node:child_process");
-var import_node_fs20 = __toESM(require("node:fs"));
-var import_node_path21 = __toESM(require("node:path"));
+var import_node_child_process7 = require("node:child_process");
+var import_node_fs21 = __toESM(require("node:fs"));
+var import_node_path22 = __toESM(require("node:path"));
 var __dirname = "/home/runner/work/pieui/pieui/src/code/commands";
 var PACKAGE_NAME = "@swarm.ing/pieui";
 var INSTALL_ARGS = {
@@ -197772,7 +197917,7 @@ var INSTALL_ARGS = {
 };
 var isPackageManager = (value2) => value2 === "bun" || value2 === "npm" || value2 === "pnpm" || value2 === "yarn";
 var hasBinary = (bin) => {
-  const result = import_node_child_process6.spawnSync("which", [bin], { stdio: "ignore" });
+  const result = import_node_child_process7.spawnSync("which", [bin], { stdio: "ignore" });
   return result.status === 0;
 };
 var detectPackageManager = () => {
@@ -197785,13 +197930,13 @@ var detectPackageManager = () => {
 };
 var readInstalledVersion = () => {
   const candidates = [
-    import_node_path21.default.resolve(__dirname, "..", "package.json"),
-    import_node_path21.default.resolve(__dirname, "..", "..", "package.json"),
-    import_node_path21.default.resolve(__dirname, "..", "..", "..", "package.json")
+    import_node_path22.default.resolve(__dirname, "..", "package.json"),
+    import_node_path22.default.resolve(__dirname, "..", "..", "package.json"),
+    import_node_path22.default.resolve(__dirname, "..", "..", "..", "package.json")
   ];
   for (const file of candidates) {
     try {
-      const raw = import_node_fs20.default.readFileSync(file, "utf8");
+      const raw = import_node_fs21.default.readFileSync(file, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed.name === PACKAGE_NAME && parsed.version) {
         return parsed.version;
@@ -197815,7 +197960,7 @@ var selfUpgradeCommand = async (override) => {
   }
   const args = INSTALL_ARGS[pm];
   console.log(`[pieui] Upgrading via ${pm}: ${pm} ${args.join(" ")}`);
-  const result = import_node_child_process6.spawnSync(pm, args, {
+  const result = import_node_child_process7.spawnSync(pm, args, {
     stdio: "inherit",
     env: process.env
   });
@@ -197899,8 +198044,8 @@ var main = async () => {
       await selfUpgradeCommand(args.selfUpgradePm);
       return;
     case "postbuild":
-      console.log(`[pieui] Source directory: ${import_node_path22.default.resolve(process.cwd(), srcDir)}`);
-      console.log(`[pieui] Output directory: ${import_node_path22.default.resolve(process.cwd(), outDir)}`);
+      console.log(`[pieui] Source directory: ${import_node_path23.default.resolve(process.cwd(), srcDir)}`);
+      console.log(`[pieui] Output directory: ${import_node_path23.default.resolve(process.cwd(), outDir)}`);
       console.log(`[pieui] Append mode: ${append}`);
       await postbuildCommand(srcDir, outDir, append);
       return;
@@ -197977,6 +198122,13 @@ var main = async () => {
         cardAddStoryCommand(name, { force: cardAddStoryForce });
         return;
       }
+      if (cardAction === "generate-preview") {
+        const name = requireName(componentName, "Component name");
+        await cardGeneratePreviewCommand(name, {
+          out: args.cardGeneratePreviewOut
+        });
+        return;
+      }
       if (cardAction === "remote") {
         if (cardRemoteAction === "list") {
           await cardRemoteListCommand({

package/dist/code/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/code/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAOR,UAAU,EACb,MAAM,SAAS,CAAA;AAyKhB,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,KAAG,UA2I1C,CAAA;AAED,MAAM,MAAM,SAAS,GACf,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,WAAW,GACX,MAAM,GACN,aAAa,GACb,MAAM,GACN,cAAc,CAAA;AAEpB,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,KAAG,SAAS,GAAG,IAe5D,CAAA;AAwMD,eAAO,MAAM,UAAU,GAAI,QAAO,SAAiB,SAwBlD,CAAA"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/code/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAOR,UAAU,EACb,MAAM,SAAS,CAAA;AA0KhB,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,KAAG,UA8I1C,CAAA;AAED,MAAM,MAAM,SAAS,GACf,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,WAAW,GACX,MAAM,GACN,aAAa,GACb,MAAM,GACN,cAAc,CAAA;AAEpB,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,KAAG,SAAS,GAAG,IAe5D,CAAA;AA0MD,eAAO,MAAM,UAAU,GAAI,QAAO,SAAiB,SAwBlD,CAAA"}

package/dist/code/commands/cardAddStory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cardAddStory.d.ts","sourceRoot":"","sources":["../../../src/code/commands/cardAddStory.ts"],"names":[],"mappings":"AAoIA,eAAO,MAAM,mBAAmB,GAC5B,eAAe,MAAM,EACrB,UAAS;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,KAClC,IA4FF,CAAA"}
+{"version":3,"file":"cardAddStory.d.ts","sourceRoot":"","sources":["../../../src/code/commands/cardAddStory.ts"],"names":[],"mappings":"AA4IA,eAAO,MAAM,mBAAmB,GAC5B,eAAe,MAAM,EACrB,UAAS;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,KAClC,IAyHF,CAAA"}

package/dist/code/commands/cardGeneratePreview.d.ts

@@ -0,0 +1,4 @@
+export declare const cardGeneratePreviewCommand: (componentName: string, options?: {
+    out?: string;
+}) => Promise<void>;
+//# sourceMappingURL=cardGeneratePreview.d.ts.map

package/dist/code/commands/cardGeneratePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardGeneratePreview.d.ts","sourceRoot":"","sources":["../../../src/code/commands/cardGeneratePreview.ts"],"names":[],"mappings":"AAqDA,eAAO,MAAM,0BAA0B,GACnC,eAAe,MAAM,EACrB,UAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,KAC/B,OAAO,CAAC,IAAI,CAwHd,CAAA"}

package/dist/code/types.d.ts

@@ -3,7 +3,7 @@ export declare const MANIFEST_FILENAME = "pieui.components.json";
 export declare const REGISTER_FUNCTION = "registerPieComponent";
 export type ComponentType = 'simple' | 'complex' | 'simple-container' | 'complex-container';
 export type ListFilter = 'all' | ComponentType;
-export type CardAction = 'add' | 'list' | 'pull' | 'view' | 'remove' | 'list-events' | 'add-event' | 'remote' | 'dump-metadata' | 'check-sync' | 'add-story';
+export type CardAction = 'add' | 'list' | 'pull' | 'view' | 'remove' | 'list-events' | 'add-event' | 'remote' | 'dump-metadata' | 'check-sync' | 'add-story' | 'generate-preview';
 export type CardRemoteAction = 'push' | 'pull' | 'list' | 'remove' | 'history' | 'public' | 'private';
 export type PageAction = 'add' | 'view' | 'ajax';
 export type PageAjaxAction = 'add' | 'remove';
@@ -38,6 +38,7 @@ export type ParsedArgs = {
     historyTo?: number;
     selfUpgradePm?: string;
     dumpMetadataOut?: string;
+    cardGeneratePreviewOut?: string;
 };
 export type CardScaffoldOptions = {
     ajax?: boolean;

package/dist/code/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/code/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/code/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,wBAAwB,CAAA;AAElD,eAAO,MAAM,iBAAiB,0BAA0B,CAAA;AACxD,eAAO,MAAM,iBAAiB,yBAAyB,CAAA;AAEvD,MAAM,MAAM,aAAa,GACnB,QAAQ,GACR,SAAS,GACT,kBAAkB,GAClB,mBAAmB,CAAA;AAEzB,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,aAAa,CAAA;AAC9C,MAAM,MAAM,UAAU,GAChB,KAAK,GACL,MAAM,GACN,MAAM,GACN,MAAM,GACN,QAAQ,GACR,aAAa,GACb,WAAW,GACX,QAAQ,GACR,eAAe,GACf,YAAY,GACZ,WAAW,GACX,kBAAkB,CAAA;AACxB,MAAM,MAAM,gBAAgB,GACtB,MAAM,GACN,MAAM,GACN,MAAM,GACN,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,CAAA;AACf,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAChD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,CAAA;AAE7C,MAAM,MAAM,UAAU,GAAG;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,GAAG,CAAC,UAAU,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEhD,MAAM,MAAM,YAAY,GAAG;IACvB;;yBAEqB;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,EAAE,UAAU,GAAG,IAAI,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC7C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,gBAAgB,EAAE,UAAU,GAAG,IAAI,CAAA;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA"}

package/dist/storybook/addon/preset.d.cts

@@ -1,2 +1,3 @@
 export function managerEntries(entry?: any[]): any[];
+export function viteFinal(config: any): Promise<any>;
 //# sourceMappingURL=preset.d.cts.map

package/dist/storybook/addon/preset.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"preset.d.cts","sourceRoot":"","sources":["../../../src/storybook/addon/preset.cjs"],"names":[],"mappings":"AAgByB,qDAGxB"}
+{"version":3,"file":"preset.d.cts","sourceRoot":"","sources":["../../../src/storybook/addon/preset.cjs"],"names":[],"mappings":"AAgByB,qDAGxB;AAQmB,qDAUnB"}

package/dist/storybook/addon/preset.js

@@ -18,3 +18,21 @@ exports.managerEntries = (entry = []) => [
     ...entry,
     path.join(__dirname, 'manager.js'),
 ]
+
+// Force-dedupe React and pieui so linked installs (`file:`/`npm link`) that
+// drag pieui's own node_modules along don't end up with two React instances.
+// Two Reacts → two distinct PieConfigContext objects → providers and
+// consumers don't match → "must be used within PieConfigProvider". Published
+// npm installs already dedupe via peerDependencies; declaring this here is a
+// safe no-op there.
+exports.viteFinal = async (config) => {
+    config.resolve = config.resolve || {}
+    const dedupe = new Set([
+        ...(config.resolve.dedupe || []),
+        'react',
+        'react-dom',
+        '@swarm.ing/pieui',
+    ])
+    config.resolve.dedupe = Array.from(dedupe)
+    return config
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@swarm.ing/pieui",
-    "version": "2.0.29",
+    "version": "2.0.31",
     "description": "A React component library featuring PieCard component",
     "repository": {
         "type": "git",