@swarm.ing/pieui 2.0.22 → 2.0.23

package/dist/cli.js

@@ -883,9 +883,9 @@ globstar while`, t, d, e, u, m), this.matchOne(t.slice(d), e.slice(u), s))
     Wt2.LRUCache = undefined;
     var er = typeof performance == "object" && performance && typeof performance.now == "function" ? performance : Date, as2 = new Set, ge2 = typeof process == "object" && process ? process : {}, ls2 = (n7, t, e, s) => {
       typeof ge2.emitWarning == "function" ? ge2.emitWarning(n7, t, e, s) : console.error(`[${e}] ${t}: ${n7}`);
-    }, Lt2 = globalThis.AbortController, os2 = globalThis.AbortSignal;
+    }, Lt2 = globalThis.AbortController, os3 = globalThis.AbortSignal;
     if (typeof Lt2 > "u") {
-      os2 = class {
+      os3 = class {
         onabort;
         _onabort = [];
         reason;
@@ -897,7 +897,7 @@ globstar while`, t, d, e, u, m), this.matchOne(t.slice(d), e.slice(u), s))
         constructor() {
           t();
         }
-        signal = new os2;
+        signal = new os3;
         abort(e) {
           if (!this.signal.aborted) {
             this.signal.reason = e, this.signal.aborted = true;
@@ -172964,7 +172964,7 @@ var require_v8_compile_cache = __commonJS((exports2, module2) => {
   var fs6 = require("fs");
   var path5 = require("path");
   var vm = require("vm");
-  var os2 = require("os");
+  var os3 = require("os");
   var hasOwnProperty = Object.prototype.hasOwnProperty;
 
   class FileSystemBlobStore {
@@ -173208,7 +173208,7 @@ var require_v8_compile_cache = __commonJS((exports2, module2) => {
     }
     const dirname = typeof process.getuid === "function" ? "v8-compile-cache-" + process.getuid() : "v8-compile-cache";
     const version = typeof process.versions.v8 === "string" ? process.versions.v8 : typeof process.versions.chakracore === "string" ? "chakracore-" + process.versions.chakracore : "node-" + process.version;
-    const cacheDir = path5.join(os2.tmpdir(), dirname, version);
+    const cacheDir = path5.join(os3.tmpdir(), dirname, version);
     return cacheDir;
   }
   function getMainName() {
@@ -188195,10 +188195,125 @@ var require_typescript_json_schema = __commonJS((exports2) => {
   }
 });
 
+// src/cli.ts
+var import_node_path9 = __toESM(require("node:path"));
+
 // src/code/args.ts
+var VALID_CARD_ACTIONS = [
+  "add",
+  "list",
+  "pull",
+  "view",
+  "remove",
+  "list-events",
+  "add-event",
+  "remote"
+];
+var VALID_CARD_REMOTE_ACTIONS = [
+  "push",
+  "pull",
+  "list",
+  "remove",
+  "history",
+  "public",
+  "private"
+];
+var VALID_PAGE_ACTIONS = ["add", "view", "ajax"];
+var VALID_PAGE_AJAX_ACTIONS = ["add", "remove"];
+var VALID_COMPONENT_TYPES = [
+  "simple",
+  "complex",
+  "simple-container",
+  "complex-container"
+];
+var VALID_LIST_FILTERS = [
+  "all",
+  "simple",
+  "complex",
+  "simple-container",
+  "complex-container"
+];
+var parseIntFlag = (name, raw) => {
+  if (!/^-?\d+$/.test(raw)) {
+    throw new Error(`${name} must be an integer, got ${JSON.stringify(raw)}`);
+  }
+  return Number(raw);
+};
+var consumeFlags = (tokens) => {
+  const flags = {};
+  const positionals = [];
+  let ajax = false;
+  let io = false;
+  for (let i = 0;i < tokens.length; i++) {
+    const tok = tokens[i];
+    if (tok === "--ajax") {
+      ajax = true;
+      continue;
+    }
+    if (tok === "--io") {
+      io = true;
+      continue;
+    }
+    if (tok === "--user" && tokens[i + 1]) {
+      flags.remoteUserId = tokens[i + 1];
+      i++;
+      continue;
+    }
+    if (tok === "--project" && tokens[i + 1]) {
+      flags.remoteProject = tokens[i + 1];
+      i++;
+      continue;
+    }
+    if (tok === "--page" && tokens[i + 1]) {
+      flags.historyPage = parseIntFlag("--page", tokens[i + 1]);
+      i++;
+      continue;
+    }
+    if (tok === "--per-page" && tokens[i + 1]) {
+      flags.historyPerPage = parseIntFlag("--per-page", tokens[i + 1]);
+      i++;
+      continue;
+    }
+    if (tok === "--from" && tokens[i + 1]) {
+      flags.historyFrom = parseIntFlag("--from", tokens[i + 1]);
+      i++;
+      continue;
+    }
+    if (tok === "--to" && tokens[i + 1]) {
+      flags.historyTo = parseIntFlag("--to", tokens[i + 1]);
+      i++;
+      continue;
+    }
+    if (tok.startsWith("--user=")) {
+      flags.remoteUserId = tok.slice("--user=".length);
+      continue;
+    }
+    if (tok.startsWith("--project=")) {
+      flags.remoteProject = tok.slice("--project=".length);
+      continue;
+    }
+    if (tok.startsWith("--page=")) {
+      flags.historyPage = parseIntFlag("--page", tok.slice("--page=".length));
+      continue;
+    }
+    if (tok.startsWith("--per-page=")) {
+      flags.historyPerPage = parseIntFlag("--per-page", tok.slice("--per-page=".length));
+      continue;
+    }
+    if (tok.startsWith("--from=")) {
+      flags.historyFrom = parseIntFlag("--from", tok.slice("--from=".length));
+      continue;
+    }
+    if (tok.startsWith("--to=")) {
+      flags.historyTo = parseIntFlag("--to", tok.slice("--to=".length));
+      continue;
+    }
+    positionals.push(tok);
+  }
+  return { positionals, flags, boolFlags: { ajax, io } };
+};
 var parseArgs = (argv) => {
   const [command = ""] = argv;
-  const cardFlagSet = new Set(["--io", "--ajax"]);
   const outDirFlag = argv.find((arg) => arg.startsWith("--out-dir="));
   const srcDirFlag = argv.find((arg) => arg.startsWith("--src-dir="));
   const outDirIndex = argv.findIndex((arg) => arg === "--out-dir" || arg === "-o");
@@ -188206,159 +188321,6 @@ var parseArgs = (argv) => {
   const appendFlag = argv.includes("--append");
   let outDir = command === "postbuild" ? "public" : ".";
   let srcDir = ".";
-  let componentType;
-  let componentName;
-  let createAppName;
-  let eventName;
-  let cardAction;
-  let cardAjax = false;
-  let cardIo = false;
-  let cardRemoteAction;
-  let remoteUserId;
-  let remoteProject;
-  let pageAction;
-  let pagePath;
-  let removeComponentName;
-  let listFilter;
-  if (command === "remove" && argv[1]) {
-    removeComponentName = argv[1];
-  }
-  if ((command === "create-pie-app" || command === "create-pieui" || command === "create") && argv[1]) {
-    createAppName = argv[1];
-  }
-  if (command === "list") {
-    const validFilters = [
-      "all",
-      "simple",
-      "complex",
-      "simple-container",
-      "complex-container"
-    ];
-    const filterArg = argv[1];
-    listFilter = filterArg && validFilters.includes(filterArg) ? filterArg : "all";
-  }
-  if (command === "card" && argv[1]) {
-    const validActions = ["add", "remote"];
-    if (validActions.includes(argv[1])) {
-      cardAction = argv[1];
-    }
-  }
-  if ((command === "card" && cardAction === "add" || command === "add") && argv[1]) {
-    const offset = command === "card" ? 2 : 1;
-    const cardArgv = argv.slice(offset);
-    const positionalArgs = cardArgv.filter((arg) => !cardFlagSet.has(arg));
-    cardIo = cardArgv.includes("--io");
-    cardAjax = cardArgv.includes("--ajax");
-    const validTypes = [
-      "simple",
-      "complex",
-      "simple-container",
-      "complex-container"
-    ];
-    if (validTypes.includes(positionalArgs[0])) {
-      componentType = positionalArgs[0];
-      componentName = positionalArgs[1];
-    } else {
-      componentType = "complex-container";
-      componentName = positionalArgs[0];
-    }
-  }
-  let historyPage;
-  let historyPerPage;
-  let historyFrom;
-  let historyTo;
-  if (command === "card" && cardAction === "remote" && argv[2]) {
-    const validRemoteActions = [
-      "push",
-      "pull",
-      "list",
-      "remove",
-      "history",
-      "public",
-      "private"
-    ];
-    const action = argv[2];
-    if (validRemoteActions.includes(action)) {
-      cardRemoteAction = action;
-      const rest = argv.slice(3);
-      const flagIndexes = new Set;
-      const parseIntFlag = (name, raw) => {
-        if (!/^-?\d+$/.test(raw)) {
-          throw new Error(`${name} must be an integer, got ${JSON.stringify(raw)}`);
-        }
-        return Number(raw);
-      };
-      for (let i = 0;i < rest.length; i++) {
-        const tok = rest[i];
-        if (tok === "--user" && rest[i + 1]) {
-          remoteUserId = rest[i + 1];
-          flagIndexes.add(i);
-          flagIndexes.add(i + 1);
-          i++;
-        } else if (tok === "--project" && rest[i + 1]) {
-          remoteProject = rest[i + 1];
-          flagIndexes.add(i);
-          flagIndexes.add(i + 1);
-          i++;
-        } else if (tok === "--page" && rest[i + 1]) {
-          historyPage = parseIntFlag("--page", rest[i + 1]);
-          flagIndexes.add(i);
-          flagIndexes.add(i + 1);
-          i++;
-        } else if (tok === "--per-page" && rest[i + 1]) {
-          historyPerPage = parseIntFlag("--per-page", rest[i + 1]);
-          flagIndexes.add(i);
-          flagIndexes.add(i + 1);
-          i++;
-        } else if (tok === "--from" && rest[i + 1]) {
-          historyFrom = parseIntFlag("--from", rest[i + 1]);
-          flagIndexes.add(i);
-          flagIndexes.add(i + 1);
-          i++;
-        } else if (tok === "--to" && rest[i + 1]) {
-          historyTo = parseIntFlag("--to", rest[i + 1]);
-          flagIndexes.add(i);
-          flagIndexes.add(i + 1);
-          i++;
-        } else if (tok?.startsWith("--user=")) {
-          remoteUserId = tok.slice("--user=".length);
-          flagIndexes.add(i);
-        } else if (tok?.startsWith("--project=")) {
-          remoteProject = tok.slice("--project=".length);
-          flagIndexes.add(i);
-        } else if (tok?.startsWith("--page=")) {
-          historyPage = parseIntFlag("--page", tok.slice("--page=".length));
-          flagIndexes.add(i);
-        } else if (tok?.startsWith("--per-page=")) {
-          historyPerPage = parseIntFlag("--per-page", tok.slice("--per-page=".length));
-          flagIndexes.add(i);
-        } else if (tok?.startsWith("--from=")) {
-          historyFrom = parseIntFlag("--from", tok.slice("--from=".length));
-          flagIndexes.add(i);
-        } else if (tok?.startsWith("--to=")) {
-          historyTo = parseIntFlag("--to", tok.slice("--to=".length));
-          flagIndexes.add(i);
-        }
-      }
-      const positionals = rest.filter((_, i) => !flagIndexes.has(i));
-      if (positionals[0])
-        componentName = positionals[0];
-    }
-  }
-  if (command === "page" && argv[1]) {
-    const validActions = ["add"];
-    if (validActions.includes(argv[1])) {
-      pageAction = argv[1];
-      pagePath = argv[2];
-    }
-  }
-  if (command === "list-events" && argv[1]) {
-    componentName = argv[1];
-  }
-  if (command === "add-event" && argv[1] && argv[2]) {
-    componentName = argv[1];
-    eventName = argv[2];
-  }
   if (outDirFlag) {
     outDir = outDirFlag.split("=")[1] || outDir;
   } else if (outDirIndex !== -1 && argv[outDirIndex + 1]) {
@@ -188369,127 +188331,300 @@ var parseArgs = (argv) => {
   } else if (srcDirIndex !== -1 && argv[srcDirIndex + 1]) {
     srcDir = argv[srcDirIndex + 1];
   }
-  return {
+  const result = {
     command,
     outDir,
     srcDir,
-    append: appendFlag,
-    componentName,
-    createAppName,
-    componentType,
-    eventName,
-    removeComponentName,
-    listFilter,
-    cardAction,
-    cardAjax,
-    cardIo,
-    cardRemoteAction,
-    remoteUserId,
-    remoteProject,
-    pageAction,
-    pagePath,
-    historyPage,
-    historyPerPage,
-    historyFrom,
-    historyTo
+    append: appendFlag
   };
+  if ((command === "create-pie-app" || command === "create-pieui" || command === "create") && argv[1]) {
+    result.createAppName = argv[1];
+  }
+  if (command === "card" && argv[1]) {
+    const action = argv[1];
+    if (!VALID_CARD_ACTIONS.includes(action)) {
+      return result;
+    }
+    result.cardAction = action;
+    const tail = argv.slice(2);
+    const { positionals, flags, boolFlags } = consumeFlags(tail);
+    if (action === "add") {
+      result.cardAjax = boolFlags.ajax;
+      result.cardIo = boolFlags.io;
+      if (positionals[0] && VALID_COMPONENT_TYPES.includes(positionals[0])) {
+        result.componentType = positionals[0];
+        result.componentName = positionals[1];
+      } else {
+        result.componentType = "complex-container";
+        result.componentName = positionals[0];
+      }
+    } else if (action === "list") {
+      const filter = positionals[0];
+      result.listFilter = filter && VALID_LIST_FILTERS.includes(filter) ? filter : "all";
+    } else if (action === "pull") {
+      result.cardPullRef = positionals[0];
+    } else if (action === "view") {
+      result.componentName = positionals[0];
+    } else if (action === "remove") {
+      result.componentName = positionals[0];
+    } else if (action === "list-events") {
+      result.componentName = positionals[0];
+    } else if (action === "add-event") {
+      result.componentName = positionals[0];
+      result.eventName = positionals[1];
+    } else if (action === "remote") {
+      const sub = positionals[0];
+      if (sub && VALID_CARD_REMOTE_ACTIONS.includes(sub)) {
+        result.cardRemoteAction = sub;
+        if (positionals[1])
+          result.componentName = positionals[1];
+        result.remoteUserId = flags.remoteUserId;
+        result.remoteProject = flags.remoteProject;
+        result.historyPage = flags.historyPage;
+        result.historyPerPage = flags.historyPerPage;
+        result.historyFrom = flags.historyFrom;
+        result.historyTo = flags.historyTo;
+      }
+    }
+  }
+  if (command === "page" && argv[1]) {
+    const action = argv[1];
+    if (!VALID_PAGE_ACTIONS.includes(action)) {
+      return result;
+    }
+    result.pageAction = action;
+    if (action === "add") {
+      result.pagePath = argv[2];
+    } else if (action === "view") {
+      result.pageName = argv[2];
+    } else if (action === "ajax") {
+      result.pageName = argv[2];
+      const sub = argv[3];
+      if (sub && VALID_PAGE_AJAX_ACTIONS.includes(sub)) {
+        result.pageAjaxAction = sub;
+      }
+      result.pageAjaxHandler = argv[4];
+    }
+  }
+  return result;
 };
-var printUsage = () => {
-  console.log("Usage: pieui <command> [options]");
-  console.log("");
-  console.log("Commands:");
-  console.log("  create <AppName>                        Create a Next.js app and run pieui init inside it");
-  console.log("  create-pie-app <AppName>                Create a blank Next.js web template for PieUI (bun create next-app under the hood)");
-  console.log("  create-pieui <AppName>                  Alias for create-pie-app");
-  console.log("  login                                   Sign in to PieUI and save credentials to .pie/config.json");
-  console.log("  init                                    Initialize piecomponents directory with registry.ts");
-  console.log("  card add [type] <ComponentName> [--io] [--ajax] Create a new component in piecomponents directory");
-  console.log("  page add <path>                         Create app/<path>/page.tsx from the standard Pie page template");
-  console.log("  card remote push <ComponentName>         Upload piecomponents/<Name>/ to PieUI storage (prints new revision)");
-  console.log("  card remote pull <ComponentName>[@rev]   Download component from current project (optional @<revision>)");
-  console.log("  card remote pull <project>/<ComponentName>[@rev]  Pull from a different project of the current user");
-  console.log("  card remote pull r/<user>/<ComponentName>         Pull a public component by another user");
-  console.log("  card remote list [--user U] [--project S]  List remote components for the configured or specified user/project");
-  console.log("  card remote remove <ComponentName>       Delete component from PieUI storage");
-  console.log("  card remote history <ComponentName> [--page N] [--per-page N] [--from R] [--to R]  Show revision history with per-file diff stats");
-  console.log("  card remote public <ComponentName>       Mark a component public (readable without API key as r/<user>/<Name>)");
-  console.log("  card remote private <ComponentName>      Make a public component private again");
-  console.log('  list-events <ComponentName>             List registered methods keys for <PieCard card="ComponentName" ... methods={...} />');
-  console.log('  add-event <ComponentName> <event>       Add a new methods key with a default handler to <PieCard card="ComponentName" ... methods={...} />');
-  console.log("  remove <ComponentName>                  Remove a component from piecomponents directory");
-  console.log("  postbuild                               Scan for components and generate manifest");
-  console.log("  list [filter]                            List registered components in a table");
-  console.log("");
-  console.log("Component types for card add command:");
-  console.log("  simple                  Simple component (only data prop)");
-  console.log("  complex                 Complex component (data + children props)");
-  console.log("  simple-container        Container with single content (data + content)");
-  console.log("  complex-container       Container with array content (data + content[])");
-  console.log("                         (default if type not specified)");
-  console.log("");
-  console.log("Options for card add:");
-  console.log("  --io                         Add realtime support fields to the generated data interface");
-  console.log("  --ajax                       Add AJAX request fields to the generated data interface");
-  console.log("");
-  console.log("Options for init:");
-  console.log("  --out-dir <dir>, -o <dir>    Base directory for piecomponents (default: .)");
-  console.log("");
-  console.log("Options for postbuild:");
-  console.log("  --out-dir <dir>, -o <dir>    Output directory (default: public)");
-  console.log("  --src-dir <dir>, -s <dir>    Source directory (default: src)");
-  console.log("  --append                      Include built-in pieui components in the manifest");
-  console.log("");
-  console.log("Options for list:");
-  console.log("  --src-dir <dir>, -s <dir>    Source directory (default: src)");
-  console.log("");
-  console.log("Options for list-events:");
-  console.log("  --src-dir <dir>, -s <dir>    Source directory to scan (default: .)");
-  console.log("");
-  console.log("Options for add-event:");
-  console.log("  --src-dir <dir>, -s <dir>    Source directory to modify (default: .)");
-  console.log("");
-  console.log("Filters for list:");
-  console.log("  all                 All components (default)");
-  console.log("  simple              Simple components (only data prop)");
-  console.log("  complex             Complex components (data + children props)");
-  console.log("  simple-container    Container with single content");
-  console.log("  complex-container   Container with array content");
-  console.log("");
-  console.log("Examples:");
-  console.log("  pieui login");
-  console.log("  pieui init");
-  console.log("  pieui create my-pie-app");
-  console.log("  pieui create-pie-app my-pie-app");
-  console.log("  pieui create-pieui my-pie-app");
-  console.log("  pieui init --out-dir packages/app");
-  console.log("  pieui card add MyCustomCard                   # Creates complex-container by default");
-  console.log("  pieui card add simple MySimpleCard            # Creates simple component");
-  console.log("  pieui card add complex-container MyContainerCard # Creates complex container");
-  console.log("  pieui card add simple LiveCard --io --ajax    # Adds realtime and AJAX fields");
-  console.log("  pieui page add chat                          # Creates app/chat/page.tsx");
-  console.log("  pieui postbuild --append --out-dir dist");
-  console.log("  pieui list                                    # List all components");
-  console.log("  pieui list simple                             # List only simple components");
-  console.log("  pieui list complex-container --src-dir app    # List complex containers in app/");
-  console.log("  pieui list-events ExchangeAlertsCard         # Print methods table for that PieCard usage");
-  console.log("  pieui add-event ExchangeAlertsCard alert     # Add methods.alert with default handler");
-  console.log("  pieui card remote push ExchangeAlertsCard    # Upload component directory (server assigns new revision)");
-  console.log("  pieui card remote pull ExchangeAlertsCard    # Download latest revision from current project");
-  console.log("  pieui card remote pull ExchangeAlertsCard@7  # Download revision 7 snapshot");
-  console.log("  pieui card remote pull other-proj/AlertsCard # Pull from another of your projects");
-  console.log("  pieui card remote pull r/delta37/YetAnotherCard  # Pull a public component by user delta37");
-  console.log("  pieui card remote list                       # List remote components");
-  console.log("  pieui card remote remove ExchangeAlertsCard  # Delete remote component");
-  console.log("  pieui card remote history ExchangeAlertsCard                      # Full history (newest first)");
-  console.log("  pieui card remote history ExchangeAlertsCard --page 1 --per-page 5 # Paginate");
-  console.log("  pieui card remote history ExchangeAlertsCard --from 12 --to 14    # Revision range");
-  console.log("  pieui card remote public ExchangeAlertsCard  # Make this component public");
-  console.log("  pieui card remote private ExchangeAlertsCard # Revert to private");
+var detectHelpScope = (argv) => {
+  if (!argv.includes("--help") && !argv.includes("-h"))
+    return null;
+  const [c0, c1] = argv;
+  if (!c0 || c0 === "--help" || c0 === "-h")
+    return "all";
+  if (c0 === "card" && c1 === "remote")
+    return "card-remote";
+  if (c0 === "card")
+    return "card";
+  if (c0 === "page")
+    return "page";
+  if (c0 === "init")
+    return "init";
+  if (c0 === "postbuild")
+    return "postbuild";
+  if (c0 === "login")
+    return "login";
+  if (c0 === "create" || c0 === "create-pie-app" || c0 === "create-pieui") {
+    return "create";
+  }
+  return "all";
+};
+var ALL_LINES = [
+  "Usage: pieui <command> [options]",
+  "",
+  "Commands:",
+  "  login                                            Sign in to PieUI and save credentials to .pie/config.json",
+  "  create <AppName>                                 Create a Next.js app and run pieui init inside it",
+  "  create-pie-app <AppName>                         Create a blank Next.js web template for PieUI",
+  "  create-pieui <AppName>                           Alias for create-pie-app",
+  "  init                                             Initialize piecomponents dir, registry.ts, tailwind & next.config; prompt for backend dirs",
+  "  postbuild                                        Scan for components and generate manifest",
+  "",
+  "Card management (mirrors `pie card ...`):",
+  "  card add [type] <Name> [--io] [--ajax]           Create a new component in piecomponents/",
+  "  card list [filter]                               List registered components",
+  "  card pull <ref>                                  Pull a card by Name, project/Name, or r/user/Name (public alias)",
+  "  card view <Name>                                 Print card name, props, ajax, IO, and events",
+  "  card remove <Name>                               Remove a component from piecomponents/",
+  "  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 remote list [--user U] [--project S]        List remote components",
+  "  card remote push <Name>                          Upload piecomponents/<Name>/ to PieUI storage",
+  "  card remote pull <Name>[@rev]                    Download component from PieUI storage",
+  "  card remote remove <Name>                        Delete component from PieUI storage",
+  "  card remote history <Name> [--page N] [--per-page N] [--from R] [--to R]",
+  "                                                   Show revision history with per-file diff stats",
+  "  card remote public <Name>                        Mark component public (readable as r/<user>/<Name>)",
+  "  card remote private <Name>                       Make a public component private again",
+  "",
+  "Page management (mirrors `pie page ...`):",
+  "  page add <path>                                  Create app/<path>/page.tsx from the standard Pie page template",
+  "  page view <path>                                 Print app/<path>/page.tsx source",
+  "  page ajax <path> <add|remove> <handler>          Add or remove an AJAX handler in app/<path>/page.tsx",
+  "",
+  "Component types for `card add`:",
+  "  simple              Simple component (only data prop)",
+  "  complex             Complex component (data + children props)",
+  "  simple-container    Container with single content (data + content)",
+  "  complex-container   Container with array content (data + content[])  [default]",
+  "",
+  "Options for `card add`:",
+  "  --io                Add realtime support fields to the generated data interface",
+  "  --ajax              Add AJAX request fields to the generated data interface",
+  "",
+  "Options for init:",
+  "  --out-dir <dir>, -o <dir>    Base directory for piecomponents (default: .)",
+  "",
+  "Options for postbuild:",
+  "  --out-dir <dir>, -o <dir>    Output directory (default: public)",
+  "  --src-dir <dir>, -s <dir>    Source directory (default: src)",
+  "  --append                     Include built-in pieui components in the manifest",
+  "",
+  "Options for `card list` / `card list-events` / `card add-event`:",
+  "  --src-dir <dir>, -s <dir>    Source directory (default: .)",
+  "",
+  "Examples:",
+  "  pieui login",
+  "  pieui init",
+  "  pieui create my-pie-app",
+  "  pieui card add MyCustomCard",
+  "  pieui card add simple MySimpleCard",
+  "  pieui card list complex-container",
+  "  pieui card view MyCustomCard",
+  "  pieui card pull r/alice/HeroCard",
+  "  pieui card remote push MyCustomCard",
+  "  pieui page add dashboard",
+  "  pieui page view dashboard",
+  "  pieui page ajax dashboard add refresh"
+];
+var CARD_LINES = [
+  "Usage: pieui card <subcommand> [options]",
+  "",
+  "Subcommands:",
+  "  add [type] <Name> [--io] [--ajax]           Create a new component in piecomponents/",
+  "  list [filter]                               List registered components",
+  "  pull <ref>                                  Pull a card by Name, project/Name, or r/user/Name (public alias)",
+  "  view <Name>                                 Print card name, props, ajax, IO, and events",
+  "  remove <Name>                               Remove a component from piecomponents/",
+  "  list-events <Name>                          List methods keys on the registered PieCard",
+  "  add-event <Name> <event>                    Add a new methods key with a default handler",
+  "  remote ...                                  Remote storage operations (see `pieui card remote --help`)",
+  "",
+  "Component types for `card add`:",
+  "  simple              Simple component (only data prop)",
+  "  complex             Complex component (data + children props)",
+  "  simple-container    Container with single content (data + content)",
+  "  complex-container   Container with array content (data + content[])  [default]",
+  "",
+  "Options for `card add`:",
+  "  --io                Add realtime support fields to the generated data interface",
+  "  --ajax              Add AJAX request fields to the generated data interface",
+  "",
+  "Options for `card list` / `card list-events` / `card add-event`:",
+  "  --src-dir <dir>, -s <dir>    Source directory (default: .)",
+  "",
+  "Examples:",
+  "  pieui card add MyCustomCard",
+  "  pieui card add simple MySimpleCard",
+  "  pieui card list complex-container",
+  "  pieui card view MyCustomCard",
+  "  pieui card pull r/alice/HeroCard"
+];
+var CARD_REMOTE_LINES = [
+  "Usage: pieui card remote <subcommand> [options]",
+  "",
+  "Subcommands:",
+  "  list [--user U] [--project S]               List remote components",
+  "  push <Name>                                 Upload piecomponents/<Name>/ to PieUI storage",
+  "  pull <Name>[@rev]                           Download component from PieUI storage",
+  "  remove <Name>                               Delete component from PieUI storage",
+  "  history <Name> [--page N] [--per-page N] [--from R] [--to R]",
+  "                                              Show revision history with per-file diff stats",
+  "  public <Name>                               Mark component public (readable as r/<user>/<Name>)",
+  "  private <Name>                              Make a public component private again",
+  "",
+  "Examples:",
+  "  pieui card remote push MyCustomCard",
+  "  pieui card remote pull MyCustomCard",
+  "  pieui card remote list --user alice --project demo",
+  "  pieui card remote history MyCustomCard --page 2"
+];
+var PAGE_LINES = [
+  "Usage: pieui page <subcommand> [options]",
+  "",
+  "Subcommands:",
+  "  add <path>                                  Create app/<path>/page.tsx from the standard Pie page template",
+  "  view <path>                                 Print app/<path>/page.tsx source",
+  "  ajax <path> <add|remove> <handler>          Add or remove an AJAX handler in app/<path>/page.tsx",
+  "",
+  "Examples:",
+  "  pieui page add dashboard",
+  "  pieui page view dashboard",
+  "  pieui page ajax dashboard add refresh"
+];
+var INIT_LINES = [
+  "Usage: pieui init [options]",
+  "",
+  "Initialize piecomponents dir, registry.ts, tailwind & next.config; prompt for backend dirs.",
+  "",
+  "Options:",
+  "  --out-dir <dir>, -o <dir>    Base directory for piecomponents (default: .)"
+];
+var POSTBUILD_LINES = [
+  "Usage: pieui postbuild [options]",
+  "",
+  "Scan for components and generate manifest.",
+  "",
+  "Options:",
+  "  --out-dir <dir>, -o <dir>    Output directory (default: public)",
+  "  --src-dir <dir>, -s <dir>    Source directory (default: src)",
+  "  --append                     Include built-in pieui components in the manifest"
+];
+var LOGIN_LINES = [
+  "Usage: pieui login",
+  "",
+  "Sign in to PieUI and save credentials to .pie/config.json."
+];
+var CREATE_LINES = [
+  "Usage: pieui create <AppName>",
+  "       pieui create-pie-app <AppName>",
+  "       pieui create-pieui <AppName>",
+  "",
+  "`create` creates a Next.js app and runs `pieui init` inside it.",
+  "`create-pie-app` (alias `create-pieui`) creates a blank Next.js web template for PieUI."
+];
+var printUsage = (scope = "all") => {
+  const lines = (() => {
+    switch (scope) {
+      case "card":
+        return CARD_LINES;
+      case "card-remote":
+        return CARD_REMOTE_LINES;
+      case "page":
+        return PAGE_LINES;
+      case "init":
+        return INIT_LINES;
+      case "postbuild":
+        return POSTBUILD_LINES;
+      case "login":
+        return LOGIN_LINES;
+      case "create":
+        return CREATE_LINES;
+      default:
+        return ALL_LINES;
+    }
+  })();
+  for (const line of lines)
+    console.log(line);
 };
 
 // src/code/commands/init.ts
 var import_fs = __toESM(require("fs"));
+var import_os = __toESM(require("os"));
 var import_path = __toESM(require("path"));
+var readline = __toESM(require("readline/promises"));
 
 // src/code/templates/componentIndex.ts
 var componentIndexTemplate = (componentName) => `import { registerPieComponent } from "@swarm.ing/pieui";
@@ -188837,15 +188972,15 @@ var componentTemplateFor = (componentType, componentName, options = {}) => {
 };
 
 // src/code/commands/init.ts
-var initCommand = (outDir) => {
+var initCommand = async (outDir) => {
   const resolvedOutDir = import_path.default.resolve(process.cwd(), outDir);
   console.log(`[pieui] Initializing piecomponents directory in ${resolvedOutDir}...`);
   const pieComponentsDir = import_path.default.join(resolvedOutDir, "piecomponents");
   if (!import_fs.default.existsSync(pieComponentsDir)) {
     import_fs.default.mkdirSync(pieComponentsDir, { recursive: true });
-    console.log("[pieui] Created piecomponents directory");
+    console.log(`[pieui] Created piecomponents directory: ${pieComponentsDir}`);
   } else {
-    console.log("[pieui] piecomponents directory already exists");
+    console.log(`[pieui] piecomponents directory already exists: ${pieComponentsDir}`);
   }
   const registryPath = import_path.default.join(pieComponentsDir, "registry.ts");
   const registryContent = `"use client";
@@ -188856,9 +188991,9 @@ var initCommand = (outDir) => {
 `;
   if (!import_fs.default.existsSync(registryPath)) {
     import_fs.default.writeFileSync(registryPath, registryContent, "utf8");
-    console.log("[pieui] Created registry.ts");
+    console.log(`[pieui] Created registry.ts: ${registryPath}`);
   } else {
-    console.log("[pieui] registry.ts already exists");
+    console.log(`[pieui] registry.ts already exists: ${registryPath}`);
   }
   const tailwindConfigPath = import_path.default.join(resolvedOutDir, "tailwind.config.js");
   const tailwindConfigTsPath = import_path.default.join(resolvedOutDir, "tailwind.config.ts");
@@ -188902,11 +189037,156 @@ var initCommand = (outDir) => {
     console.log(`[pieui]   "${pieuiContentPath}"`);
   }
   ensureNextConfig(resolvedOutDir);
+  await ensureBackendPaths(resolvedOutDir);
   console.log("[pieui] Initialization complete!");
   console.log("[pieui] Next steps:");
   console.log('  1. Import "./piecomponents/registry" in your app entry point');
   console.log('  2. Use "pieui card add <ComponentName>" to create new components');
 };
+var PIE_CONFIG_DIR = ".pie";
+var PIE_CONFIG_FILE = "config.json";
+var MAX_HOMEDIR_SCAN_DEPTH = 2;
+var ensureBackendPaths = async (resolvedOutDir) => {
+  const existing = readPieConfig(resolvedOutDir);
+  if (existing.backendPagesDir && existing.backendComponentsDir) {
+    console.log(`[pieui] Backend dirs already configured in .pie/${PIE_CONFIG_FILE}:`);
+    console.log(`[pieui]   pages:      ${existing.backendPagesDir}`);
+    console.log(`[pieui]   components: ${existing.backendComponentsDir}`);
+    return;
+  }
+  if (!process.stdin.isTTY) {
+    console.log("[pieui] Non-interactive shell — skipping backend pages/components prompt.");
+    console.log(`[pieui] To configure, add "backendPagesDir" and "backendComponentsDir" to ${import_path.default.join(resolvedOutDir, PIE_CONFIG_DIR, PIE_CONFIG_FILE)}`);
+    return;
+  }
+  const home = import_os.default.homedir();
+  console.log(`[pieui] Searching ${home} for backend projects with pages/ and components/ directories...`);
+  const candidates = findBackendCandidates(home, MAX_HOMEDIR_SCAN_DEPTH);
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  try {
+    let pagesDir = existing.backendPagesDir;
+    let componentsDir = existing.backendComponentsDir;
+    if (!pagesDir || !componentsDir) {
+      const picked = await pickBackendPair(rl, candidates, home);
+      if (picked) {
+        pagesDir = pagesDir || picked.pages;
+        componentsDir = componentsDir || picked.components;
+      }
+    }
+    if (!pagesDir) {
+      pagesDir = await promptAbsoluteDir(rl, "Path to backend pages directory", home);
+    }
+    if (!componentsDir) {
+      componentsDir = await promptAbsoluteDir(rl, "Path to backend components directory", home);
+    }
+    if (!pagesDir || !componentsDir) {
+      console.log("[pieui] Skipped backend paths — neither directory was provided.");
+      return;
+    }
+    writePieConfig(resolvedOutDir, {
+      ...existing,
+      backendPagesDir: pagesDir,
+      backendComponentsDir: componentsDir
+    });
+    const configPath = import_path.default.join(resolvedOutDir, PIE_CONFIG_DIR, PIE_CONFIG_FILE);
+    console.log(`[pieui] Saved backend paths to ${configPath}`);
+    console.log(`[pieui]   pages:      ${pagesDir}`);
+    console.log(`[pieui]   components: ${componentsDir}`);
+  } finally {
+    rl.close();
+  }
+};
+var findBackendCandidates = (home, maxDepth) => {
+  const found = [];
+  const visit = (dir, depth) => {
+    if (depth > maxDepth)
+      return;
+    let entries;
+    try {
+      entries = import_fs.default.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    const subdirs = entries.filter((e) => e.isDirectory() && !e.name.startsWith("."));
+    const subdirNames = new Set(subdirs.map((e) => e.name));
+    if (subdirNames.has("pages") && subdirNames.has("components")) {
+      found.push({
+        project: dir,
+        pages: import_path.default.join(dir, "pages"),
+        components: import_path.default.join(dir, "components")
+      });
+    }
+    for (const sub of subdirs) {
+      if (sub.name === "node_modules" || sub.name === ".git")
+        continue;
+      visit(import_path.default.join(dir, sub.name), depth + 1);
+    }
+  };
+  visit(home, 0);
+  return found;
+};
+var pickBackendPair = async (rl, candidates, home) => {
+  if (candidates.length === 0) {
+    console.log("[pieui] No matching backend projects found under home directory.");
+    return null;
+  }
+  console.log("[pieui] Found backend candidates:");
+  candidates.forEach((c, i) => {
+    const rel = import_path.default.relative(home, c.project) || ".";
+    console.log(`  ${i + 1}. ~/${rel}`);
+  });
+  const answer = (await rl.question(`[pieui] Pick a candidate [1-${candidates.length}] or press Enter to type paths manually: `)).trim();
+  if (!answer)
+    return null;
+  const idx = Number.parseInt(answer, 10);
+  if (Number.isNaN(idx) || idx < 1 || idx > candidates.length) {
+    console.log("[pieui] Invalid selection — falling back to manual input.");
+    return null;
+  }
+  return candidates[idx - 1];
+};
+var promptAbsoluteDir = async (rl, label, home) => {
+  while (true) {
+    const raw = (await rl.question(`[pieui] ${label} (absolute or ~/...): `)).trim();
+    if (!raw)
+      return;
+    const expanded = raw.startsWith("~") ? import_path.default.join(home, raw.slice(1).replace(/^[\\/]/, "")) : raw;
+    const absolute = import_path.default.resolve(expanded);
+    if (!absolute.startsWith(home + import_path.default.sep) && absolute !== home) {
+      console.log(`[pieui] Warning: ${absolute} is outside ${home}. Continuing anyway.`);
+    }
+    if (!import_fs.default.existsSync(absolute) || !import_fs.default.statSync(absolute).isDirectory()) {
+      console.log(`[pieui] Not a directory: ${absolute}. Try again.`);
+      continue;
+    }
+    return absolute;
+  }
+};
+var readPieConfig = (resolvedOutDir) => {
+  const configPath = import_path.default.join(resolvedOutDir, PIE_CONFIG_DIR, PIE_CONFIG_FILE);
+  if (!import_fs.default.existsSync(configPath))
+    return {};
+  try {
+    const parsed = JSON.parse(import_fs.default.readFileSync(configPath, "utf8"));
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+      return {};
+    return parsed;
+  } catch {
+    return {};
+  }
+};
+var writePieConfig = (resolvedOutDir, config) => {
+  const pieDir = import_path.default.join(resolvedOutDir, PIE_CONFIG_DIR);
+  if (!import_fs.default.existsSync(pieDir)) {
+    import_fs.default.mkdirSync(pieDir, { recursive: true });
+  }
+  const configPath = import_path.default.join(pieDir, PIE_CONFIG_FILE);
+  import_fs.default.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}
+`, "utf8");
+};
 var ensureNextConfig = (resolvedOutDir) => {
   const candidates = [
     "next.config.ts",
@@ -189075,10 +189355,10 @@ var addCommand = (componentName, componentType = "complex-container", options =
   }
   console.log(`[pieui] Component ${componentName} (${componentType}) created successfully!`);
   console.log(`[pieui] Files created:`);
-  console.log(`  - piecomponents/${componentName}/index.ts`);
-  console.log(`  - piecomponents/${componentName}/types/index.ts`);
-  console.log(`  - piecomponents/${componentName}/ui/${componentName}.tsx`);
-  console.log(`[pieui] Updated registry.ts with new component`);
+  console.log(`  - ${import_path3.default.join(componentDir, "index.ts")}`);
+  console.log(`  - ${import_path3.default.join(componentDir, "types", "index.ts")}`);
+  console.log(`  - ${import_path3.default.join(componentDir, "ui", `${componentName}.tsx`)}`);
+  console.log(`[pieui] Updated registry: ${resolveRegistryPath(pieComponentsDir)}`);
   console.log("");
   console.log(`[pieui] Component type: ${componentType}`);
   console.log(`[pieui] IO fields: ${options.io ? "enabled" : "disabled"}`);
@@ -189113,12 +189393,12 @@ var removeCommand = (componentName) => {
     console.error("[pieui] Error: piecomponents directory not found. Nothing to remove.");
     process.exit(1);
   }
-  const componentDir = import_path4.default.join(pieComponentsDir, componentName);
+  const componentDir = import_path4.default.resolve(pieComponentsDir, componentName);
   if (import_fs4.default.existsSync(componentDir)) {
     import_fs4.default.rmSync(componentDir, { recursive: true, force: true });
-    console.log(`[pieui] Removed directory: piecomponents/${componentName}`);
+    console.log(`[pieui] Removed directory: ${componentDir}`);
   } else {
-    console.log(`[pieui] Warning: Component directory piecomponents/${componentName} not found`);
+    console.log(`[pieui] Warning: Component directory not found: ${componentDir}`);
   }
   const registryPath = resolveRegistryPath(pieComponentsDir);
   if (import_fs4.default.existsSync(registryPath)) {
@@ -189131,9 +189411,9 @@ var removeCommand = (componentName) => {
 `);
     if (registryContent !== originalContent) {
       import_fs4.default.writeFileSync(registryPath, registryContent, "utf8");
-      console.log(`[pieui] Cleaned up registry.ts`);
+      console.log(`[pieui] Cleaned up registry: ${registryPath}`);
     } else {
-      console.log(`[pieui] Warning: ${componentName} not found in registry.ts`);
+      console.log(`[pieui] Warning: ${componentName} not found in ${registryPath}`);
     }
   }
   console.log(`[pieui] Component ${componentName} removed successfully!`);
@@ -189187,7 +189467,7 @@ var pe = "\x00PERIOD" + Math.random() + "\x00";
 var is = new RegExp(fe, "g");
 var rs = new RegExp(ue, "g");
 var ns = new RegExp(qt, "g");
-var os = new RegExp(de, "g");
+var os2 = new RegExp(de, "g");
 var hs = new RegExp(pe, "g");
 var as = /\\\\/g;
 var ls = /\\{/g;
@@ -189202,7 +189482,7 @@ function ps(n) {
   return n.replace(as, fe).replace(ls, ue).replace(cs, qt).replace(fs5, de).replace(us, pe);
 }
 function ms(n) {
-  return n.replace(is, "\\").replace(rs, "{").replace(ns, "}").replace(os, ",").replace(hs, ".");
+  return n.replace(is, "\\").replace(rs, "{").replace(ns, "}").replace(os2, ",").replace(hs, ".");
 }
 function me(n) {
   if (!n)
@@ -192462,7 +192742,7 @@ var defaultCompilerOptions = () => ({
   skipLibCheck: true
 });
 var findComponentRegistrations = (srcDir) => {
-  console.log(`[pieui] Searching for components in: ${srcDir}`);
+  console.log(`[pieui] Searching for components in: ${import_path5.default.resolve(process.cwd(), srcDir)}`);
   const files = Ze.sync(`${srcDir}/**/*.{ts,tsx}`, {
     ignore: ["**/*.d.ts", "**/dist/**", "**/node_modules/**"]
   });
@@ -192602,7 +192882,8 @@ var detectComponentType = (propsType, checker) => {
 
 // src/code/commands/list.ts
 var listCommand = (srcDir, filter) => {
-  console.log(`[pieui] Scanning components in: ${srcDir}`);
+  const resolvedSrcDir = import_path6.default.resolve(process.cwd(), srcDir);
+  console.log(`[pieui] Scanning components in: ${resolvedSrcDir}`);
   const files = Ze.sync(`${srcDir}/**/*.{ts,tsx}`, {
     ignore: [
       "**/*.d.ts",
@@ -192698,7 +192979,7 @@ var listCommand = (srcDir, filter) => {
               components.push({
                 name: componentName,
                 type: compType,
-                file: import_path6.default.relative(process.cwd(), componentFile),
+                file: import_path6.default.resolve(componentFile),
                 dataType: dataTypeName,
                 lazy: hasLoader && !componentRef
               });
@@ -192919,7 +193200,7 @@ var listEventsCommand = (srcDir, componentName) => {
           entries.push({
             event: f.event,
             handler: f.handler,
-            file: import_path7.default.relative(process.cwd(), sourceFile.fileName),
+            file: import_path7.default.resolve(sourceFile.fileName),
             line: f.line
           });
         }
@@ -192951,7 +193232,7 @@ var listEventsCommand = (srcDir, componentName) => {
           entries.push({
             event: f.event,
             handler: f.handler,
-            file: import_path7.default.relative(process.cwd(), sourceFile.fileName),
+            file: import_path7.default.resolve(sourceFile.fileName),
             line: f.line
           });
         }
@@ -193134,7 +193415,7 @@ var addEventCommand = (srcDir, componentName, eventName) => {
   const methodsObj = target.methodsObj;
   const existingKeys = getPropertyKeys(methodsObj);
   if (existingKeys.has(eventName)) {
-    console.log(`[pieui] methods.${eventName} already exists in ${import_path8.default.relative(process.cwd(), filePath)}`);
+    console.log(`[pieui] methods.${eventName} already exists in ${import_path8.default.resolve(filePath)}`);
     return;
   }
   const { propIndent, closingIndent } = computeIndentFromExistingProp(sourceText, target.sourceFile, methodsObj);
@@ -193150,7 +193431,7 @@ ${propIndent}${eventName}: ${handler}
 ${closingIndent}`;
   const updated = sourceText.slice(0, insertAt) + insertion + sourceText.slice(insertAt);
   import_fs6.default.writeFileSync(filePath, updated, "utf8");
-  console.log(`[pieui] Updated: ${import_path8.default.relative(process.cwd(), filePath)} (added "${eventName}")`);
+  console.log(`[pieui] Updated: ${import_path8.default.resolve(filePath)} (added "${eventName}")`);
 };
 
 // src/code/commands/postbuild.ts
@@ -194286,6 +194567,115 @@ var cardRemotePrivateCommand = async (componentName) => {
   console.log(`[pieui] is_public: ${state.isPublic}`);
 };
 
+// src/code/commands/cardPull.ts
+var cardPullCommand = async (cardRef) => {
+  await cardRemotePullCommand(cardRef);
+};
+
+// src/code/commands/cardView.ts
+var import_node_fs4 = __toESM(require("node:fs"));
+var import_node_path5 = __toESM(require("node:path"));
+var AJAX_FIELD_NAMES2 = new Set(["pathname", "deps_names", "kwargs"]);
+var IO_FIELD_RE = /\buse_[A-Za-z0-9_]+_support\b/g;
+var extractInterfaceBody = (source, interfaceName) => {
+  const idx = source.indexOf(`interface ${interfaceName}`);
+  if (idx === -1)
+    return null;
+  const braceStart = source.indexOf("{", idx);
+  if (braceStart === -1)
+    return null;
+  let depth = 0;
+  for (let i = braceStart;i < source.length; i++) {
+    const ch = source[i];
+    if (ch === "{")
+      depth++;
+    else if (ch === "}") {
+      depth--;
+      if (depth === 0)
+        return source.slice(braceStart + 1, i);
+    }
+  }
+  return null;
+};
+var parseProps = (body) => {
+  const props = [];
+  const lineRe = /^[ \t]*([A-Za-z_][A-Za-z0-9_]*)(\?)?\s*:\s*([^;\n]+?)\s*;?\s*$/gm;
+  let match;
+  while ((match = lineRe.exec(body)) !== null) {
+    const [, name, optional, typeRaw] = match;
+    props.push({
+      name,
+      type: typeRaw.trim(),
+      default: optional ? "(optional)" : "(required)"
+    });
+  }
+  return props;
+};
+var formatTable = (headers, rows) => {
+  const data = [headers, ...rows];
+  const widths = headers.map((_2, c) => Math.max(...data.map((row) => (row[c] ?? "").length)));
+  const hline = `+${widths.map((w) => "-".repeat(w + 2)).join("+")}+`;
+  const fmtRow = (cells) => `|${cells.map((cell, i) => ` ${(cell ?? "").padEnd(widths[i])} `).join("|")}|`;
+  return [hline, fmtRow(headers), hline, ...rows.map(fmtRow), hline].join(`
+`);
+};
+var cardViewCommand = (componentName) => {
+  const settings = loadSettings();
+  const componentDir = import_node_path5.default.join(settings.componentsDir, componentName);
+  if (!import_node_fs4.default.existsSync(componentDir)) {
+    throw new Error(`Component directory not found: ${componentDir}`);
+  }
+  const typesPath = import_node_path5.default.join(componentDir, "types.ts");
+  const indexPath = import_node_path5.default.join(componentDir, "index.tsx");
+  const indexPathTs = import_node_path5.default.join(componentDir, "index.ts");
+  const typesSource = import_node_fs4.default.existsSync(typesPath) ? import_node_fs4.default.readFileSync(typesPath, "utf8") : "";
+  const indexSource = import_node_fs4.default.existsSync(indexPath) ? import_node_fs4.default.readFileSync(indexPath, "utf8") : import_node_fs4.default.existsSync(indexPathTs) ? import_node_fs4.default.readFileSync(indexPathTs, "utf8") : "";
+  const dataInterface = extractInterfaceBody(typesSource, `${componentName}Data`) ?? "";
+  const props = parseProps(dataInterface);
+  const hasAjax = props.some((p) => AJAX_FIELD_NAMES2.has(p.name));
+  const ioFields2 = props.map((p) => p.name).filter((name) => IO_FIELD_RE.test(name));
+  IO_FIELD_RE.lastIndex = 0;
+  const events = [];
+  const eventRe = /\b(?:on|create)([A-Z][A-Za-z0-9]*)Event\b|methods\s*=\s*\{([\s\S]*?)\}/g;
+  const methodsMatch = indexSource.match(/methods\s*=\s*\{([\s\S]*?)\}/);
+  if (methodsMatch) {
+    const inner = methodsMatch[1];
+    const keyRe = /([A-Za-z_][A-Za-z0-9_]*)\s*:/g;
+    let m;
+    while ((m = keyRe.exec(inner)) !== null)
+      events.push(m[1]);
+  }
+  console.log("Name:");
+  console.log(componentName);
+  console.log("");
+  console.log("File:");
+  console.log(import_node_path5.default.resolve(componentDir));
+  console.log("");
+  console.log("Props:");
+  if (props.length === 0) {
+    console.log("(none)");
+  } else {
+    console.log(formatTable(["Name", "Type", "Default"], props.map((p) => [p.name, p.type, p.default])));
+  }
+  console.log("");
+  console.log("Ajax:");
+  console.log(hasAjax ? "yes" : "no");
+  console.log("");
+  console.log("IO:");
+  if (ioFields2.length === 0) {
+    console.log("no");
+  } else {
+    console.log(formatTable(["name"], ioFields2.map((n7) => [n7])));
+  }
+  console.log("");
+  console.log("Events:");
+  if (events.length === 0) {
+    console.log("no (run `pieui card list-events " + componentName + "`)");
+  } else {
+    console.log(formatTable(["event"], events.map((e) => [e])));
+  }
+};
+
 // src/code/commands/pageAdd.ts
 var import_fs8 = __toESM(require("fs"));
 var import_path10 = __toESM(require("path"));
@@ -194325,12 +194715,93 @@ var pageAddCommand = (pagePath) => {
     throw new Error("Page path must stay inside the app directory");
   }
   if (import_fs8.default.existsSync(targetFile)) {
-    console.error(`[pieui] Error: Page already exists at app/${normalizedPath}/page.tsx`);
+    console.error(`[pieui] Error: Page already exists at ${targetFile}`);
     process.exit(1);
   }
   import_fs8.default.mkdirSync(import_path10.default.dirname(targetFile), { recursive: true });
   import_fs8.default.writeFileSync(targetFile, pageTemplate(pageComponentName), "utf8");
-  console.log(`[pieui] Page created successfully at app/${normalizedPath}/page.tsx`);
+  console.log(`[pieui] Page created successfully at ${targetFile}`);
+};
+
+// src/code/commands/pageView.ts
+var import_node_fs5 = __toESM(require("node:fs"));
+var import_node_path6 = __toESM(require("node:path"));
+var normalizePagePath2 = (pagePath) => {
+  const trimmed = pagePath.trim();
+  if (!trimmed)
+    throw new Error("Path is required for page view command");
+  const slashed = trimmed.replace(/\\/g, "/");
+  const noRel = slashed.replace(/^\.\/+/, "");
+  const noApp = noRel.replace(/^app\//, "");
+  const noEdge = noApp.replace(/^\/+|\/+$/g, "");
+  const normalized = import_node_path6.default.posix.normalize(noEdge);
+  if (!normalized || normalized === ".") {
+    throw new Error("Path is required for page view command");
+  }
+  if (normalized === ".." || normalized.startsWith("../") || normalized.includes("/../")) {
+    throw new Error("Page path must stay inside the app directory");
+  }
+  return normalized;
+};
+var pageViewCommand = (pagePath) => {
+  const normalized = normalizePagePath2(pagePath);
+  const target = import_node_path6.default.join(process.cwd(), "app", normalized, "page.tsx");
+  if (!import_node_fs5.default.existsSync(target)) {
+    throw new Error(`Page file not found: ${target}`);
+  }
+  const source = import_node_fs5.default.readFileSync(target, "utf8");
+  console.log(`[pieui] Path: ${target}`);
+  console.log("");
+  process.stdout.write(source);
+  if (!source.endsWith(`
+`))
+    console.log("");
+};
+
+// src/code/commands/pageAjax.ts
+var import_node_fs6 = __toESM(require("node:fs"));
+var import_node_path7 = __toESM(require("node:path"));
+var import_node_child_process = require("node:child_process");
+var PIE_CONFIG_PATH = ".pie/config.json";
+var readBackendRoot = () => {
+  const configPath = import_node_path7.default.join(process.cwd(), PIE_CONFIG_PATH);
+  if (!import_node_fs6.default.existsSync(configPath))
+    return;
+  try {
+    const parsed = JSON.parse(import_node_fs6.default.readFileSync(configPath, "utf8"));
+    if (typeof parsed !== "object" || parsed === null)
+      return;
+    const config = parsed;
+    if (!config.backendPagesDir)
+      return;
+    const pages = import_node_path7.default.resolve(config.backendPagesDir);
+    if (!import_node_fs6.default.existsSync(pages) || !import_node_fs6.default.statSync(pages).isDirectory()) {
+      return;
+    }
+    return import_node_path7.default.dirname(pages);
+  } catch {
+    return;
+  }
+};
+var pageAjaxCommand = (pageName, action, handlerName) => {
+  if (!pageName)
+    throw new Error("Page name is required for page ajax command");
+  if (!handlerName) {
+    throw new Error("Handler name is required for page ajax command");
+  }
+  const backendRoot = readBackendRoot();
+  if (!backendRoot) {
+    throw new Error("Backend project not configured. Run `pieui init` to link a backend project (saves backendPagesDir/.backendComponentsDir to .pie/config.json).");
+  }
+  console.log(`[pieui] Delegating to backend: ${backendRoot}`);
+  console.log(`[pieui]   pie page ajax ${pageName} ${action} ${handlerName}`);
+  const result = import_node_child_process.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}`);
+  }
+  if (typeof result.status === "number" && result.status !== 0) {
+    process.exit(result.status);
+  }
 };
 
 // src/code/commands/create.ts
@@ -194338,6 +194809,7 @@ var import_fs9 = __toESM(require("fs"));
 var import_path11 = __toESM(require("path"));
 var import_child_process = require("child_process");
 var DEFAULT_TEMPLATE_SPEC = "next-app@latest";
+var DEFAULT_PIEUI_PACKAGE_SPEC = "@swarm.ing/pieui";
 var clearDirectory = (targetDir) => {
   if (!import_fs9.default.existsSync(targetDir))
     return;
@@ -194395,7 +194867,7 @@ var runBunCommand = (bunBin, args, cwd) => {
     throw new Error(`${args.join(" ")} failed (exit code ${result.status ?? "unknown"})`);
   }
 };
-var createCommand = (appName) => {
+var createCommand = async (appName) => {
   const trimmedAppName = appName.trim();
   if (!trimmedAppName) {
     console.error("[pieui] Error: App name is required for create command");
@@ -194408,6 +194880,7 @@ var createCommand = (appName) => {
   }
   const bunBin = process.env.PIEUI_CREATE_BUN_BIN || "bun";
   const templateSpec = process.env.PIEUI_CREATE_NEXT_APP_SPEC || DEFAULT_TEMPLATE_SPEC;
+  const pieuiPackageSpec = process.env.PIEUI_CREATE_PACKAGE_SPEC || DEFAULT_PIEUI_PACKAGE_SPEC;
   console.log(`[pieui] Creating Next.js app in "${trimmedAppName}"...`);
   const result = import_child_process.spawnSync(bunBin, ["create", templateSpec, trimmedAppName, "--yes"], {
     cwd: process.cwd(),
@@ -194421,9 +194894,9 @@ var createCommand = (appName) => {
     throw new Error(`create failed (exit code ${result.status ?? "unknown"})`);
   }
   scaffoldCreateAppFiles(appDir);
-  initCommand(trimmedAppName);
   writeFile(import_path11.default.join(appDir, ".env"), envTemplate());
-  runBunCommand(bunBin, ["install"], appDir);
+  runBunCommand(bunBin, ["add", pieuiPackageSpec], appDir);
+  await initCommand(trimmedAppName);
   runBunCommand(bunBin, ["run", "dev"], appDir);
 };
 
@@ -194676,10 +195149,10 @@ var createPieAppCommand = (appName) => {
 };
 
 // src/code/commands/login.ts
-var import_node_child_process = require("node:child_process");
+var import_node_child_process2 = require("node:child_process");
 var import_node_crypto = require("node:crypto");
-var import_node_fs4 = __toESM(require("node:fs"));
-var import_node_path5 = __toESM(require("node:path"));
+var import_node_fs7 = __toESM(require("node:fs"));
+var import_node_path8 = __toESM(require("node:path"));
 var CONNECT_BASE = "https://pieui.swarm.ing/connect";
 var CREDENTIALS_API = "https://api-pieui.swarm.ing/api/external/credentials";
 var CONNECT_BASE_ENV = "PIEUI_LOGIN_CONNECT_BASE";
@@ -194696,13 +195169,13 @@ var generateCode = (length = CODE_LENGTH) => {
 var tryOpenBrowser = (url) => {
   try {
     if (process.platform === "win32") {
-      import_node_child_process.execFile("cmd", ["/c", "start", "", url], () => {
+      import_node_child_process2.execFile("cmd", ["/c", "start", "", url], () => {
       });
     } else if (process.platform === "darwin") {
-      import_node_child_process.execFile("open", [url], () => {
+      import_node_child_process2.execFile("open", [url], () => {
       });
     } else {
-      import_node_child_process.execFile("xdg-open", [url], () => {
+      import_node_child_process2.execFile("xdg-open", [url], () => {
       });
     }
   } catch {
@@ -194735,8 +195208,8 @@ var appendPieCredentialsToEnv = (cwd, config) => {
   if (Object.keys(entries).length === 0) {
     return;
   }
-  const envPath = import_node_path5.default.join(cwd, ".env");
-  let content = import_node_fs4.default.existsSync(envPath) ? import_node_fs4.default.readFileSync(envPath, "utf8") : "";
+  const envPath = import_node_path8.default.join(cwd, ".env");
+  let content = import_node_fs7.default.existsSync(envPath) ? import_node_fs7.default.readFileSync(envPath, "utf8") : "";
   if (content.length > 0 && !content.endsWith(`
 `)) {
     content += `
@@ -194746,7 +195219,7 @@ var appendPieCredentialsToEnv = (cwd, config) => {
   content += `${additions.join(`
 `)}
 `;
-  import_node_fs4.default.writeFileSync(envPath, content, "utf8");
+  import_node_fs7.default.writeFileSync(envPath, content, "utf8");
   console.log(`[pie] Appended credentials to ${envPath}`);
 };
 async function loginCommand(options = {}) {
@@ -194768,8 +195241,8 @@ async function loginCommand(options = {}) {
     openBrowser(connectUrl);
   } catch {
   }
-  const pieDir = import_node_path5.default.join(cwd, ".pie");
-  const configPath = import_node_path5.default.join(pieDir, "config.json");
+  const pieDir = import_node_path8.default.join(cwd, ".pie");
+  const configPath = import_node_path8.default.join(pieDir, "config.json");
   const url = `${credentialsApi}?${new URLSearchParams({ code }).toString()}`;
   let first = true;
   while (true) {
@@ -194802,8 +195275,8 @@ async function loginCommand(options = {}) {
       if (!("config" in record)) {
         throw new Error("Login succeeded but response had no 'config' field");
       }
-      import_node_fs4.default.mkdirSync(pieDir, { recursive: true });
-      import_node_fs4.default.writeFileSync(configPath, `${JSON.stringify(record.config, null, 2)}
+      import_node_fs7.default.mkdirSync(pieDir, { recursive: true });
+      import_node_fs7.default.writeFileSync(configPath, `${JSON.stringify(record.config, null, 2)}
 `, "utf8");
       console.log(`[pie] Saved credentials to ${configPath}`);
       appendPieCredentialsToEnv(cwd, record.config);
@@ -194813,7 +195286,22 @@ async function loginCommand(options = {}) {
 }
 
 // src/cli.ts
+var requireName = (value2, label) => {
+  if (!value2) {
+    console.error(`[pieui] Error: ${label} is required`);
+    printUsage();
+    process.exit(1);
+  }
+  return value2;
+};
 var main = async () => {
+  const rawArgs = process.argv.slice(2);
+  const helpScope = detectHelpScope(rawArgs);
+  if (helpScope) {
+    printUsage(helpScope);
+    return;
+  }
+  const args = parseArgs(rawArgs);
   const {
     command,
     outDir,
@@ -194822,57 +195310,98 @@ var main = async () => {
     componentName,
     createAppName,
     componentType,
-    removeComponentName,
     listFilter,
     eventName,
     cardAction,
     cardAjax,
     cardIo,
     cardRemoteAction,
+    cardPullRef,
     remoteUserId,
     remoteProject,
     pageAction,
     pagePath,
+    pageName,
+    pageAjaxAction,
+    pageAjaxHandler,
     historyPage,
     historyPerPage,
     historyFrom,
     historyTo
-  } = parseArgs(process.argv.slice(2));
+  } = args;
   console.log(`[pieui] CLI started with command: "${command}"`);
   switch (command) {
     case "init":
-      initCommand(outDir);
+      await initCommand(outDir);
       return;
-    case "create":
-      if (!createAppName) {
-        console.error("[pieui] Error: App name is required for create command");
-        printUsage();
-        process.exit(1);
-      }
-      createCommand(createAppName);
+    case "create": {
+      const name = requireName(createAppName, "App name");
+      await createCommand(name);
       return;
+    }
     case "create-pie-app":
-    case "create-pieui":
-      if (!createAppName) {
-        console.error("[pieui] Error: App name is required for create-pie-app command");
+    case "create-pieui": {
+      const name = requireName(createAppName, "App name");
+      createPieAppCommand(name);
+      return;
+    }
+    case "login":
+      await loginCommand();
+      return;
+    case "postbuild":
+      console.log(`[pieui] Source directory: ${import_node_path9.default.resolve(process.cwd(), srcDir)}`);
+      console.log(`[pieui] Output directory: ${import_node_path9.default.resolve(process.cwd(), outDir)}`);
+      console.log(`[pieui] Append mode: ${append}`);
+      await postbuildCommand(srcDir, outDir, append);
+      return;
+    case "card": {
+      if (!cardAction) {
+        console.error("[pieui] Error: Supported card subcommands: add, list, pull, view, remove, list-events, add-event, remote");
         printUsage();
         process.exit(1);
       }
-      createPieAppCommand(createAppName);
-      return;
-    case "card":
       if (cardAction === "add") {
-        if (!componentName) {
-          console.error("[pieui] Error: Component name is required for card add command");
-          printUsage();
-          process.exit(1);
-        }
-        addCommand(componentName, componentType, {
+        const name = requireName(componentName, "Component name");
+        addCommand(name, componentType, {
           ajax: cardAjax,
           io: cardIo
         });
         return;
       }
+      if (cardAction === "list") {
+        listCommand(srcDir, listFilter || "all");
+        return;
+      }
+      if (cardAction === "pull") {
+        const ref = requireName(cardPullRef, "Card reference");
+        await cardPullCommand(ref);
+        return;
+      }
+      if (cardAction === "view") {
+        const name = requireName(componentName, "Component name");
+        cardViewCommand(name);
+        return;
+      }
+      if (cardAction === "remove") {
+        const name = requireName(componentName, "Component name");
+        removeCommand(name);
+        return;
+      }
+      if (cardAction === "list-events") {
+        const name = requireName(componentName, "Component name");
+        listEventsCommand(srcDir, name);
+        return;
+      }
+      if (cardAction === "add-event") {
+        const name = requireName(componentName, "Component name");
+        if (!eventName) {
+          console.error("[pieui] Error: Event name is required");
+          printUsage();
+          process.exit(1);
+        }
+        addEventCommand(srcDir, name, eventName);
+        return;
+      }
       if (cardAction === "remote") {
         if (cardRemoteAction === "list") {
           await cardRemoteListCommand({
@@ -194881,26 +195410,22 @@ var main = async () => {
           });
           return;
         }
-        if (!componentName) {
-          console.error(`[pieui] Error: Component name is required for card remote ${cardRemoteAction ?? ""} command`);
-          printUsage();
-          process.exit(1);
-        }
+        const name = requireName(componentName, `Component name (for card remote ${cardRemoteAction ?? ""})`);
         if (cardRemoteAction === "push") {
-          await cardRemotePushCommand(componentName);
+          await cardRemotePushCommand(name);
           return;
         }
         if (cardRemoteAction === "pull") {
-          await cardRemotePullCommand(componentName);
+          await cardRemotePullCommand(name);
           return;
         }
         if (cardRemoteAction === "remove") {
-          await cardRemoteRemoveCommand(componentName);
+          await cardRemoteRemoveCommand(name);
           return;
         }
         if (cardRemoteAction === "history") {
           await cardRemoteHistoryCommand({
-            componentName,
+            componentName: name,
             page: historyPage,
             perPage: historyPerPage,
             from: historyFrom,
@@ -194909,80 +195434,48 @@ var main = async () => {
           return;
         }
         if (cardRemoteAction === "public") {
-          await cardRemotePublicCommand(componentName);
+          await cardRemotePublicCommand(name);
           return;
         }
         if (cardRemoteAction === "private") {
-          await cardRemotePrivateCommand(componentName);
+          await cardRemotePrivateCommand(name);
           return;
         }
-        console.error("[pieui] Error: Supported card remote subcommands: push, pull, list, remove, history, public, private");
-        printUsage();
-        process.exit(1);
-      }
-      console.error("[pieui] Error: Supported card subcommands: add, remote");
-      printUsage();
-      process.exit(1);
-    case "add":
-      if (!componentName) {
-        console.error("[pieui] Error: Component name is required for card add command");
+        console.error("[pieui] Error: Supported card remote subcommands: list, push, pull, remove, history, public, private");
         printUsage();
         process.exit(1);
       }
-      addCommand(componentName, componentType, {
-        ajax: cardAjax,
-        io: cardIo
-      });
       return;
-    case "page":
-      if (pageAction !== "add") {
-        console.error("[pieui] Error: Supported page subcommands: add");
-        printUsage();
-        process.exit(1);
-      }
-      if (!pagePath) {
-        console.error("[pieui] Error: Path is required for page add command");
+    }
+    case "page": {
+      if (!pageAction) {
+        console.error("[pieui] Error: Supported page subcommands: add, view, ajax");
         printUsage();
         process.exit(1);
       }
-      pageAddCommand(pagePath);
-      return;
-    case "remove":
-      if (!removeComponentName) {
-        console.error("[pieui] Error: Component name is required for remove command");
-        printUsage();
-        process.exit(1);
+      if (pageAction === "add") {
+        const p = requireName(pagePath, "Path");
+        pageAddCommand(p);
+        return;
       }
-      removeCommand(removeComponentName);
-      return;
-    case "list":
-      listCommand(srcDir, listFilter || "all");
-      return;
-    case "list-events":
-      if (!componentName) {
-        console.error("[pieui] Error: Component name is required for list-events command");
-        printUsage();
-        process.exit(1);
+      if (pageAction === "view") {
+        const name = requireName(pageName, "Path");
+        pageViewCommand(name);
+        return;
       }
-      listEventsCommand(srcDir, componentName);
-      return;
-    case "add-event":
-      if (!componentName || !eventName) {
-        console.error("[pieui] Error: Component name and event name are required for add-event command");
-        printUsage();
-        process.exit(1);
+      if (pageAction === "ajax") {
+        const name = requireName(pageName, "Page name");
+        if (!pageAjaxAction) {
+          console.error("[pieui] Error: page ajax action must be `add` or `remove`");
+          printUsage();
+          process.exit(1);
+        }
+        const handler = requireName(pageAjaxHandler, "Handler name");
+        pageAjaxCommand(name, pageAjaxAction, handler);
+        return;
       }
-      addEventCommand(srcDir, componentName, eventName);
-      return;
-    case "postbuild":
-      console.log(`[pieui] Source directory: ${srcDir}`);
-      console.log(`[pieui] Output directory: ${outDir}`);
-      console.log(`[pieui] Append mode: ${append}`);
-      await postbuildCommand(srcDir, outDir, append);
-      return;
-    case "login":
-      await loginCommand();
       return;
+    }
     default:
       printUsage();
       process.exit(1);