@swarm.ing/pieui 2.0.19 → 2.0.21

package/README.md

@@ -107,16 +107,20 @@ Create a blank Next.js web app template with PieUI CLI:
 
 ```sh
 bunx pieui create-pie-app my-pie-app
+# or alias:
+bunx pieui create-pieui my-pie-app
 ```
 
 This command:
 
 - runs `bun create next-app@latest my-pie-app --yes`
-- copies a standard `_shared` folder into the new app (sourced from `ai-exchange-bot`)
+- copies a standard `_shared` folder into the new app (sourced from `ai-exchange-bot` when found)
 - rewrites `dev/build/start` scripts to `bun --bun next ...`
 - appends a TODO marker in `app/page.tsx` for future backend (Python Unicorn) linking
 
-If the `_shared` source cannot be found automatically, set:
+If the `_shared` source cannot be found automatically, PieUI now creates a fallback `_shared/simple.tsx` scaffold and continues.
+
+To force a specific shared source, set:
 
 ```sh
 PIEUI_SHARED_TEMPLATE_DIR=/absolute/path/to/_shared bunx pieui create-pie-app my-pie-app

package/dist/cli.js

@@ -184030,18 +184030,31 @@ var parseArgs = (argv) => {
       componentName = positionalArgs[0];
     }
   }
+  let historyPage;
+  let historyPerPage;
+  let historyFrom;
+  let historyTo;
   if (command === "card" && cardAction === "remote" && argv[2]) {
     const validRemoteActions = [
       "push",
       "pull",
       "list",
-      "remove"
+      "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]) {
@@ -184054,12 +184067,44 @@ var parseArgs = (argv) => {
           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));
@@ -184109,7 +184154,11 @@ var parseArgs = (argv) => {
     remoteUserId,
     remoteProject,
     pageAction,
-    pagePath
+    pagePath,
+    historyPage,
+    historyPerPage,
+    historyFrom,
+    historyTo
   };
 };
 var printUsage = () => {
@@ -184124,9 +184173,14 @@ var printUsage = () => {
   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 PieUI storage into piecomponents/<Name>/ (optional @<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");
@@ -184187,10 +184241,17 @@ var printUsage = () => {
   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");
+  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");
 };
 
 // src/code/commands/init.ts
@@ -189257,6 +189318,92 @@ var parseComponentObject = (raw) => {
     signedUrl: typeof obj.signed_url === "string" ? obj.signed_url : typeof obj.signedUrl === "string" ? obj.signedUrl : undefined
   };
 };
+var parsePublicComponentState = (raw) => {
+  const obj = raw ?? {};
+  const pickStr = (...keys) => {
+    for (const k2 of keys) {
+      const v2 = obj[k2];
+      if (typeof v2 === "string")
+        return v2;
+    }
+    return "";
+  };
+  const registry = typeof obj.public_registry_name === "string" ? obj.public_registry_name : typeof obj.publicRegistryName === "string" ? obj.publicRegistryName : null;
+  return {
+    userId: pickStr("user_id", "userId"),
+    project: pickStr("project_slug", "projectSlug"),
+    componentName: pickStr("component_name", "componentName"),
+    isPublic: obj.is_public === true || obj.isPublic === true,
+    publicRegistryName: registry
+  };
+};
+var pickString = (obj, ...keys) => {
+  for (const k2 of keys) {
+    const v2 = obj[k2];
+    if (typeof v2 === "string")
+      return v2;
+  }
+  return "";
+};
+var pickNumber = (obj, ...keys) => {
+  for (const k2 of keys) {
+    const v2 = obj[k2];
+    if (typeof v2 === "number")
+      return v2;
+  }
+  return null;
+};
+var parseHistoryFile = (raw) => {
+  const obj = raw ?? {};
+  const key = typeof obj.key === "string" ? obj.key : "";
+  const status = obj.status;
+  if (status !== "added" && status !== "modified" && status !== "deleted") {
+    return null;
+  }
+  const additions = pickNumber(obj, "additions") ?? 0;
+  const deletions = pickNumber(obj, "deletions") ?? 0;
+  return {
+    key,
+    status,
+    isBinary: obj.is_binary === true || obj.isBinary === true,
+    additions,
+    deletions,
+    patch: typeof obj.patch === "string" ? obj.patch : undefined
+  };
+};
+var parseHistoryEntry = (raw) => {
+  const obj = raw ?? {};
+  const revision = pickNumber(obj, "revision");
+  if (revision === null)
+    return null;
+  const diff = obj.diff ?? {};
+  const rawFiles = Array.isArray(diff.files) ? diff.files : [];
+  const files = rawFiles.map(parseHistoryFile).filter((f) => f !== null);
+  return {
+    revision,
+    previousRevision: pickNumber(obj, "previous_revision", "previousRevision"),
+    createdAt: pickString(obj, "created_at", "createdAt"),
+    mutation: pickString(obj, "mutation"),
+    deleted: obj.deleted === true,
+    files
+  };
+};
+var parseComponentHistory = (raw) => {
+  const obj = raw ?? {};
+  const rawEntries = Array.isArray(obj.entries) ? obj.entries : [];
+  const entries = rawEntries.map(parseHistoryEntry).filter((e) => e !== null);
+  return {
+    userId: pickString(obj, "user_id", "userId"),
+    project: pickString(obj, "project_slug", "projectSlug"),
+    componentName: pickString(obj, "component_name", "componentName"),
+    page: pickNumber(obj, "page") ?? 1,
+    perPage: pickNumber(obj, "per_page", "perPage") ?? 10,
+    totalRevisions: pickNumber(obj, "total_revisions", "totalRevisions") ?? 0,
+    fromRevision: pickNumber(obj, "from_revision", "fromRevision"),
+    toRevision: pickNumber(obj, "to_revision", "toRevision"),
+    entries
+  };
+};
 var parseProjectComponentList = (raw) => {
   const obj = raw ?? {};
   const userId = typeof obj.user_id === "string" ? obj.user_id : typeof obj.userId === "string" ? obj.userId : "";
@@ -189336,16 +189483,22 @@ class PieStorageService {
   }
   componentUrl(args) {
     const userId = args.userId ?? this.settings.userId;
-    const slug = args.project ?? this.settings.project;
     if (!userId) {
       throw new PieStorageError("user_id is required (configure PIE_USER_ID or pass user_id)");
     }
+    if (args.isPublic) {
+      return `${this.baseUrl}/public-components/${pathPart(userId)}/${pathPart(args.componentName)}`;
+    }
+    const slug = args.project ?? this.settings.project;
     return `${this.baseUrl}/components/${pathPart(userId)}/${pathPart(slug)}/${pathPart(args.componentName)}`;
   }
   languageFileUrl(args) {
     const base = this.componentUrl(args);
     const encodedPath = normalizeObjectPath(args.objectPath);
     if (args.revision !== undefined) {
+      if (args.isPublic) {
+        throw new PieStorageError("revision is not supported for public components");
+      }
       return `${base}/revisions/${args.revision}/${STORAGE_LANGUAGE}/${encodedPath}`;
     }
     return `${base}/${STORAGE_LANGUAGE}/${encodedPath}`;
@@ -189353,6 +189506,9 @@ class PieStorageService {
   componentTreeUrl(args) {
     const base = this.componentUrl(args);
     if (args.revision !== undefined) {
+      if (args.isPublic) {
+        throw new PieStorageError("revision is not supported for public components");
+      }
       return `${base}/revisions/${args.revision}`;
     }
     return base;
@@ -189360,6 +189516,23 @@ class PieStorageService {
   revisionsUrl(args) {
     return `${this.componentUrl(args)}/revisions`;
   }
+  publicMarkUrl(args) {
+    return `${this.componentUrl(args)}/public`;
+  }
+  historyUrl(args) {
+    const base = `${this.componentUrl(args)}/history`;
+    const params = new URLSearchParams;
+    if (args.page !== undefined)
+      params.set("page", String(args.page));
+    if (args.perPage !== undefined)
+      params.set("per_page", String(args.perPage));
+    if (args.from !== undefined)
+      params.set("from", String(args.from));
+    if (args.to !== undefined)
+      params.set("to", String(args.to));
+    const qs2 = params.toString();
+    return qs2 ? `${base}?${qs2}` : base;
+  }
   languageBatchUrl(args) {
     return `${this.componentUrl(args)}/batch/${STORAGE_LANGUAGE}`;
   }
@@ -189373,7 +189546,11 @@ class PieStorageService {
   }
   async listComponent(args) {
     const url = this.componentTreeUrl(args);
-    const response = await this.request({ method: "GET", url });
+    const response = await this.request({
+      method: "GET",
+      url,
+      noAuth: args.isPublic
+    });
     const payload = await response.json();
     if (args.revision !== undefined) {
       const inner = payload.tree;
@@ -189387,6 +189564,21 @@ class PieStorageService {
     const response = await this.request({ method: "GET", url });
     return parseComponentRevisionList(await response.json());
   }
+  async markComponentPublic(args) {
+    const url = this.publicMarkUrl(args);
+    const response = await this.request({ method: "PUT", url });
+    return parsePublicComponentState(await response.json());
+  }
+  async markComponentPrivate(args) {
+    const url = this.publicMarkUrl(args);
+    const response = await this.request({ method: "DELETE", url });
+    return parsePublicComponentState(await response.json());
+  }
+  async getHistory(args) {
+    const url = this.historyUrl(args);
+    const response = await this.request({ method: "GET", url });
+    return parseComponentHistory(await response.json());
+  }
   async deleteComponent(args) {
     const url = this.componentUrl(args);
     await this.request({ method: "DELETE", url });
@@ -189488,7 +189680,11 @@ class PieStorageService {
     const fs9 = await import("node:fs");
     const path11 = await import("node:path");
     const url = this.languageFileUrl(args);
-    const response = await this.request({ method: "GET", url });
+    const response = await this.request({
+      method: "GET",
+      url,
+      noAuth: args.isPublic
+    });
     const buf = Buffer.from(await response.arrayBuffer());
     fs9.mkdirSync(path11.dirname(args.targetPath), { recursive: true });
     fs9.writeFileSync(args.targetPath, buf);
@@ -189513,9 +189709,9 @@ class PieStorageService {
     }
     return downloaded;
   }
-  headers(extra) {
+  headers(extra, noAuth) {
     const base = {};
-    if (this.settings.apiKey)
+    if (!noAuth && this.settings.apiKey)
       base["x-api-key"] = this.settings.apiKey;
     return { ...base, ...extra ?? {} };
   }
@@ -189526,7 +189722,7 @@ class PieStorageService {
     try {
       response = await fetch(opts.url, {
         method: opts.method,
-        headers: this.headers(opts.headers),
+        headers: this.headers(opts.headers, opts.noAuth),
         body: opts.body,
         signal: controller.signal
       });
@@ -189547,14 +189743,17 @@ ${detail}` : `${opts.method} ${opts.url} failed: ${response.status}`;
 }
 
 // src/code/commands/cardRemote/cardRef.ts
-var parseCardRef = (input) => {
-  const atIndex = input.indexOf("@");
+var parseNameAndRevision = (namePart, raw) => {
+  const atIndex = namePart.indexOf("@");
   if (atIndex === -1)
-    return { componentName: input };
-  const componentName = input.slice(0, atIndex);
-  const revisionPart = input.slice(atIndex + 1);
+    return { componentName: namePart };
+  const componentName = namePart.slice(0, atIndex);
+  const revisionPart = namePart.slice(atIndex + 1);
+  if (!componentName) {
+    throw new Error(`missing component name in ${JSON.stringify(raw)}`);
+  }
   if (!revisionPart) {
-    throw new Error(`missing revision after '@' in ${JSON.stringify(input)}`);
+    throw new Error(`missing revision after '@' in ${JSON.stringify(raw)}`);
   }
   if (!/^\d+$/.test(revisionPart)) {
     throw new Error(`revision must be a positive integer, got ${JSON.stringify(revisionPart)}`);
@@ -189565,13 +189764,51 @@ var parseCardRef = (input) => {
   }
   return { componentName, revision };
 };
+var parseCardRef = (input) => {
+  if (!input) {
+    throw new Error("card ref must not be empty");
+  }
+  if (input.startsWith("r/")) {
+    const rest = input.slice(2);
+    const parts2 = rest.split("/");
+    if (parts2.length !== 2 || !parts2[0] || !parts2[1]) {
+      throw new Error(`expected r/<user>/<Component>, got ${JSON.stringify(input)}`);
+    }
+    const [userId, namePart] = parts2;
+    const { componentName, revision } = parseNameAndRevision(namePart, input);
+    if (revision !== undefined) {
+      throw new Error("revision suffix is not supported for public refs (r/...)");
+    }
+    return { componentName, userId, isPublic: true };
+  }
+  const parts = input.split("/");
+  if (parts.length === 1) {
+    return parseNameAndRevision(input, input);
+  }
+  if (parts.length === 2) {
+    const [project, namePart] = parts;
+    if (!project || !namePart) {
+      throw new Error(`expected <project>/<Component>, got ${JSON.stringify(input)}`);
+    }
+    const { componentName, revision } = parseNameAndRevision(namePart, input);
+    return { componentName, revision, project };
+  }
+  throw new Error(`invalid card ref ${JSON.stringify(input)}: expected <Component>, <project>/<Component>, or r/<user>/<Component>`);
+};
 
 // src/code/commands/cardRemote/push.ts
 var cardRemotePushCommand = async (cardRef) => {
-  const { componentName, revision } = parseCardRef(cardRef);
-  if (revision !== undefined) {
+  const ref = parseCardRef(cardRef);
+  if (ref.revision !== undefined) {
     throw new Error("push does not accept a revision suffix");
   }
+  if (ref.isPublic) {
+    throw new Error("push does not accept public refs (r/...)");
+  }
+  if (ref.project || ref.userId) {
+    throw new Error("push does not accept project/user override; pass just <ComponentName>");
+  }
+  const { componentName } = ref;
   if (!/^[A-Z][A-Za-z0-9]+$/.test(componentName)) {
     throw new Error("Component name must start with uppercase letter and contain only letters and numbers");
   }
@@ -189626,12 +189863,15 @@ var latestRevisionNumber = async (service, componentName) => {
 var import_node_fs3 = __toESM(require("node:fs"));
 var import_node_path4 = __toESM(require("node:path"));
 var cardRemotePullCommand = async (cardRef) => {
-  const { componentName, revision } = parseCardRef(cardRef);
+  const ref = parseCardRef(cardRef);
+  const { componentName, revision, isPublic } = ref;
   const settings = loadSettings();
-  if (!settings.userId) {
+  const effectiveUserId = ref.userId ?? settings.userId;
+  if (!effectiveUserId) {
     throw new Error("user_id is required (set PIE_USER_ID in env or .env; run `pieui login`)");
   }
-  if (!settings.project) {
+  const effectiveProject = isPublic ? undefined : ref.project ?? settings.project;
+  if (!isPublic && !effectiveProject) {
     throw new Error("project is required (set PIE_PROJECT or PIE_PROJECT_SLUG in env or .env)");
   }
   const componentDir = import_node_path4.default.join(settings.componentsDir, componentName);
@@ -189645,23 +189885,27 @@ var cardRemotePullCommand = async (cardRef) => {
     downloaded = await service.downloadComponentDirectory({
       componentName,
       targetDir: tempDir,
-      revision
+      revision,
+      userId: effectiveUserId,
+      project: effectiveProject,
+      isPublic
     });
   } catch (error) {
     import_node_fs3.default.rmSync(tempDir, { recursive: true, force: true });
     throw error;
   }
+  const sourceLabel = isPublic ? `r/${effectiveUserId}/${componentName}` : ref.project ? `${effectiveProject}/${componentName}` : componentName;
+  const suffix = revision !== undefined ? `@${revision}` : "";
   if (downloaded.length === 0) {
     import_node_fs3.default.rmSync(tempDir, { recursive: true, force: true });
-    const suffix2 = revision !== undefined ? `@${revision}` : "";
-    throw new Error(`No typescript files found for remote component ${componentName}${suffix2} (user_id=${settings.userId}, project=${settings.project})`);
+    const where = isPublic ? `user_id=${effectiveUserId} (public)` : `user_id=${effectiveUserId}, project=${effectiveProject}`;
+    throw new Error(`No typescript files found for remote component ${sourceLabel}${suffix} (${where})`);
   }
   if (import_node_fs3.default.existsSync(componentDir)) {
     import_node_fs3.default.rmSync(componentDir, { recursive: true, force: true });
   }
   import_node_fs3.default.renameSync(tempDir, componentDir);
-  const suffix = revision !== undefined ? `@${revision}` : "";
-  console.log(`[pieui] Pulled card: ${componentName}${suffix}`);
+  console.log(`[pieui] Pulled card: ${sourceLabel}${suffix}`);
   for (const p of downloaded) {
     const relative = import_node_path4.default.relative(tempDir, p);
     console.log(`[pieui] Path: ${import_node_path4.default.join(componentDir, relative)}`);
@@ -189701,6 +189945,114 @@ var cardRemoteRemoveCommand = async (componentName) => {
   console.log(`[pieui] Removed remote component: ${componentName}`);
 };
 
+// src/code/commands/cardRemote/history.ts
+var extractPath = (key, componentName) => {
+  const marker = `/${componentName}/${STORAGE_LANGUAGE}/`;
+  const idx = key.indexOf(marker);
+  if (idx === -1)
+    return key;
+  return key.slice(idx + marker.length);
+};
+var formatFileBlock = (file, componentName) => {
+  const path13 = extractPath(file.key, componentName);
+  const before = file.status === "added" ? "a//dev/null" : `a/${path13}`;
+  const after = file.status === "deleted" ? "b//dev/null" : `b/${path13}`;
+  const lines = [];
+  lines.push(`diff --git ${before} ${after}`);
+  lines.push(`${file.status} +${file.additions} -${file.deletions} ${path13}`);
+  if (file.isBinary) {
+    lines.push("Binary files differ");
+  } else if (file.patch) {
+    lines.push(file.patch.replace(/\n+$/, ""));
+  }
+  return lines;
+};
+var formatRevisionBlock = (entry, componentName) => {
+  const lines = [];
+  lines.push(`revision ${componentName}@${entry.revision}`);
+  lines.push(`date ${entry.createdAt}`);
+  lines.push(`mutation ${entry.mutation}`);
+  if (entry.previousRevision !== null) {
+    lines.push(`previous ${entry.previousRevision}`);
+  }
+  if (entry.deleted) {
+    lines.push("deleted true");
+  }
+  for (const file of entry.files) {
+    lines.push("");
+    lines.push(...formatFileBlock(file, componentName));
+  }
+  return lines;
+};
+var cardRemoteHistoryCommand = async (options) => {
+  const settings = loadSettings();
+  if (!settings.userId) {
+    throw new Error("user_id is required (set PIE_USER_ID in env or .env)");
+  }
+  if (!settings.project) {
+    throw new Error("project is required (set PIE_PROJECT or PIE_PROJECT_SLUG)");
+  }
+  if (options.from !== undefined && options.to !== undefined && options.from > options.to) {
+    throw new Error("--from must be <= --to");
+  }
+  const service = new PieStorageService(settings);
+  const history = await service.getHistory({
+    componentName: options.componentName,
+    page: options.page,
+    perPage: options.perPage,
+    from: options.from,
+    to: options.to
+  });
+  const output = [];
+  output.push(`component ${history.userId}/${history.project}/${history.componentName}`);
+  output.push(`page ${history.page} per-page ${history.perPage} total-revisions ${history.totalRevisions}`);
+  if (history.fromRevision !== null || history.toRevision !== null) {
+    const from = history.fromRevision !== null ? String(history.fromRevision) : "*";
+    const to = history.toRevision !== null ? String(history.toRevision) : "*";
+    output.push(`range ${from}..${to}`);
+  }
+  for (const entry of history.entries) {
+    output.push("");
+    output.push(...formatRevisionBlock(entry, history.componentName));
+  }
+  console.log(output.join(`
+`));
+};
+
+// src/code/commands/cardRemote/public.ts
+var cardRemotePublicCommand = async (componentName) => {
+  const settings = loadSettings();
+  if (!settings.userId) {
+    throw new Error("user_id is required (set PIE_USER_ID in env or .env)");
+  }
+  if (!settings.project) {
+    throw new Error("project is required (set PIE_PROJECT or PIE_PROJECT_SLUG)");
+  }
+  const service = new PieStorageService(settings);
+  const state = await service.markComponentPublic({ componentName });
+  console.log(`[pieui] Marked public: ${state.componentName} (user=${state.userId} project=${state.project})`);
+  console.log(`[pieui] is_public: ${state.isPublic}`);
+  if (state.publicRegistryName) {
+    console.log(`[pieui] Public registry name: ${state.publicRegistryName}`);
+  }
+  console.log(`[pieui] Public read URL: <api>/public-components/${state.userId}/${state.componentName}`);
+};
+
+// src/code/commands/cardRemote/private.ts
+var cardRemotePrivateCommand = async (componentName) => {
+  const settings = loadSettings();
+  if (!settings.userId) {
+    throw new Error("user_id is required (set PIE_USER_ID in env or .env)");
+  }
+  if (!settings.project) {
+    throw new Error("project is required (set PIE_PROJECT or PIE_PROJECT_SLUG)");
+  }
+  const service = new PieStorageService(settings);
+  const state = await service.markComponentPrivate({ componentName });
+  console.log(`[pieui] Marked private: ${state.componentName} (user=${state.userId} project=${state.project})`);
+  console.log(`[pieui] is_public: ${state.isPublic}`);
+};
+
 // src/code/commands/pageAdd.ts
 var import_fs8 = __toESM(require("fs"));
 var import_path10 = __toESM(require("path"));
@@ -190247,7 +190599,11 @@ var main = async () => {
     remoteUserId,
     remoteProject,
     pageAction,
-    pagePath
+    pagePath,
+    historyPage,
+    historyPerPage,
+    historyFrom,
+    historyTo
   } = parseArgs(process.argv.slice(2));
   console.log(`[pieui] CLI started with command: "${command}"`);
   switch (command) {
@@ -190309,7 +190665,25 @@ var main = async () => {
           await cardRemoteRemoveCommand(componentName);
           return;
         }
-        console.error("[pieui] Error: Supported card remote subcommands: push, pull, list, remove");
+        if (cardRemoteAction === "history") {
+          await cardRemoteHistoryCommand({
+            componentName,
+            page: historyPage,
+            perPage: historyPerPage,
+            from: historyFrom,
+            to: historyTo
+          });
+          return;
+        }
+        if (cardRemoteAction === "public") {
+          await cardRemotePublicCommand(componentName);
+          return;
+        }
+        if (cardRemoteAction === "private") {
+          await cardRemotePrivateCommand(componentName);
+          return;
+        }
+        console.error("[pieui] Error: Supported card remote subcommands: push, pull, list, remove, history, public, private");
         printUsage();
         process.exit(1);
       }

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,EAMR,UAAU,EACb,MAAM,SAAS,CAAA;AAEhB,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,KAAG,UAiL1C,CAAA;AAED,eAAO,MAAM,UAAU,YAuKtB,CAAA"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/code/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMR,UAAU,EACb,MAAM,SAAS,CAAA;AAEhB,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,KAAG,UAoP1C,CAAA;AAED,eAAO,MAAM,UAAU,YA2MtB,CAAA"}

package/dist/code/commands/cardRemote/cardRef.d.ts

@@ -1,6 +1,9 @@
 export type CardRef = {
     componentName: string;
     revision?: number;
+    userId?: string;
+    project?: string;
+    isPublic?: boolean;
 };
 export declare const parseCardRef: (input: string) => CardRef;
 //# sourceMappingURL=cardRef.d.ts.map

package/dist/code/commands/cardRemote/cardRef.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cardRef.d.ts","sourceRoot":"","sources":["../../../../src/code/commands/cardRemote/cardRef.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAElE,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAkB5C,CAAA"}
+{"version":3,"file":"cardRef.d.ts","sourceRoot":"","sources":["../../../../src/code/commands/cardRemote/cardRef.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AA4BD,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OA4C5C,CAAA"}