@p11-core/cli 0.0.4 → 0.0.6

package/dist/index.js

@@ -3519,7 +3519,7 @@ var cliPackageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)),
 var docsTopics = /* @__PURE__ */ new Map([
   ["index", "docs/index.md"],
   ["components", "docs/components.md"],
-  ["publishing", "docs/publishing.md"]
+  ["sharing", "docs/sharing.md"]
 ]);
 var exampleFiles = /* @__PURE__ */ new Map([["all-components", "examples/all-components.tsx"]]);
 var allowedDocumentComponents = /* @__PURE__ */ new Set([
@@ -3628,9 +3628,13 @@ async function main() {
   if (!isKnownTopLevelCommand(program2, command)) throw new Error(`Unknown command: ${command}`);
   await program2.parseAsync(process.argv);
 }
-function createCliProgram() {
+function createCliProgram(options = {}) {
   const program2 = new Command();
-  program2.name("p11").description("Publish and inspect p11 document pages.");
+  const warnBeforeAction = options.warnIfUpdateAvailable ?? warnIfUpdateAvailable;
+  program2.name("p11").description("Share and inspect p11 document pages.");
+  program2.hook("preAction", async () => {
+    await warnBeforeAction();
+  });
   program2.addHelpText(
     "after",
     `
@@ -3638,25 +3642,23 @@ function createCliProgram() {
 Environment:
   P11_API_URL  Defaults to ${builtDefaultApiUrl}`
   );
-  const publishCommand = program2.command("publish").description("Publish a page module.").argument("[page.tsx]").option("--json", "Print the API response as JSON.").option("--edit-url [url]", "Update an existing page using an edit URL or edit id.").option("--api-url [url]", "Override the p11 API URL.").action(async (input, options) => {
-    await warnIfUpdateAvailable();
-    await publish(input, normalizePublishOptions(options));
+  const shareCommand = program2.command("share").description("Share a review link for a page.").argument("[page.tsx]").option("--json", "Print the API response as JSON.").option("--edit-url [url]", "Share a new version using an edit URL or edit id.").option("--api-url [url]", "Override the p11 API URL.").action(async (input, options2) => {
+    await publish(input, normalizePublishOptions(options2));
   });
-  allowLegacyParserBehavior(publishCommand);
-  const commentsCommand = program2.command("comments").description("Fetch exported comments for a read/edit URL or id.").argument("[readUrl|editUrl|readId|editId]").option("--json", "Print comments as JSON.").option("--output [file]", "Write comments JSON to a file.").option("--version [n]", "Fetch comments for a specific page version.").option("--api-url [url]", "Override the p11 API URL.").action(async (target, options) => {
-    await warnIfUpdateAvailable();
-    await comments(target, normalizeCommentsOptions(options));
+  allowLegacyParserBehavior(shareCommand);
+  const commentsCommand = program2.command("comments").description("Fetch exported comments for a read/edit URL or id.").argument("[readUrl|editUrl|readId|editId]").option("--json", "Print comments as JSON.").option("--output [file]", "Write comments JSON to a file.").option("--version [n]", "Fetch comments for a specific page version.").option("--api-url [url]", "Override the p11 API URL.").action(async (target, options2) => {
+    await comments(target, normalizeCommentsOptions(options2));
   });
   allowLegacyParserBehavior(commentsCommand);
-  program2.command("history").description("List saved publish read/edit URLs.").option("--json", "Print saved history as JSON.").action(async (options) => {
-    await history(normalizeHistoryOptions(options));
+  program2.command("history").description("List saved read/edit links.").option("--json", "Print saved history as JSON.").action(async (options2) => {
+    await history(normalizeHistoryOptions(options2));
   });
-  const docsCommand = program2.command("docs").description("Print p11 authoring docs.").argument("[topic]", "Docs topic: components or publishing.").action(async (topic) => {
+  const docsCommand = program2.command("docs").description("Print p11 authoring docs.").argument("[topic]", "Docs topic: components or sharing.").action(async (topic) => {
     await docs(topic);
   });
   allowLegacyParserBehavior(docsCommand);
-  const exampleCommand = program2.command("example").description("Print or write a p11 example document.").argument("[name]", "Example name: all-components.").option("--output [file]", "Write the example to a file.").action(async (name, options) => {
-    await example(name, normalizeExampleOptions(options));
+  const exampleCommand = program2.command("example").description("Print or write a p11 example document.").argument("[name]", "Example name: all-components.").option("--output [file]", "Write the example to a file.").action(async (name, options2) => {
+    await example(name, normalizeExampleOptions(options2));
   });
   allowLegacyParserBehavior(exampleCommand);
   return program2;
@@ -3697,15 +3699,15 @@ function optionString(value, missingValueMessage) {
   return typeof value === "string" ? value : void 0;
 }
 async function publish(input, options) {
-  if (!input) throw new Error("Usage: p11 publish <page.tsx> [--json] [--edit-url URL]");
+  if (!input) throw new Error("Usage: p11 share <page.tsx> [--json] [--edit-url URL]");
   const resolvedInput = path.resolve(input);
   const inputStat = await stat(resolvedInput).catch(() => null);
   if (!inputStat) throw new Error(`Path does not exist: ${input}`);
   if (!inputStat.isFile()) {
-    throw new Error("Input must be a .tsx, .jsx, .ts, or .js page module.");
+    throw new Error("Input must be a .tsx, .jsx, .ts, or .js page file.");
   }
   if (!/\.[cm]?[tj]sx?$/.test(resolvedInput)) {
-    throw new Error("File input must be a .tsx, .jsx, .ts, or .js page module.");
+    throw new Error("File input must be a .tsx, .jsx, .ts, or .js page file.");
   }
   const cleanupDir = await mkdtemp(path.join(process.cwd(), ".p11-build-"));
   const distDir = path.join(cleanupDir, "dist");
@@ -3728,14 +3730,14 @@ async function publish(input, options) {
     });
     const text = await response.text();
     if (!response.ok) {
-      throw new Error(`Publish failed (${response.status}): ${responseErrorMessage(text)}`);
+      throw new Error(`Share failed (${response.status}): ${responseErrorMessage(text)}`);
     }
     const data = JSON.parse(text);
     await appendPublishHistory(data, {
       apiUrl,
       source: resolvedInput
     }).catch((error) => {
-      console.error(`Warning: published, but could not save history: ${errorMessage(error)}`);
+      console.error(`Warning: shared, but could not save history: ${errorMessage(error)}`);
     });
     if (options.json) {
       console.log(JSON.stringify(data, null, 2));
@@ -3765,7 +3767,7 @@ async function docs(topic) {
   const normalizedTopic = topic ?? "index";
   const relativePath = docsTopics.get(normalizedTopic);
   if (!relativePath) {
-    throw new Error(`Unknown docs topic: ${normalizedTopic}. Available topics: components, publishing`);
+    throw new Error(`Unknown docs topic: ${normalizedTopic}. Available topics: components, sharing`);
   }
   process.stdout.write(await readCliAsset(relativePath));
 }
@@ -3903,7 +3905,7 @@ async function removeStaleHistoryLock(lockDir) {
 }
 function printHistory(entries, limit) {
   if (entries.length === 0) {
-    console.log(`No history yet. Publish a document to create ${historyFilePath()}.`);
+    console.log(`No history yet. Share a document to create ${historyFilePath()}.`);
     return;
   }
   const displayEntries = entries.slice(-limit).reverse();
@@ -4432,6 +4434,7 @@ export {
   buildPageModule,
   commentsApiUrlForTarget,
   commentsExportJson,
+  createCliProgram,
   isNewerVersion,
   parseCommentsTarget,
   parseEditId,

package/docs/components.md

@@ -1,6 +1,6 @@
 # p11 Components
 
-p11 documents are React modules that export a default component and import document-safe components from `@p11-core/components`.
+p11 documents are React files that export a default component and import document-safe components from `@p11-core/components`.
 
 ## Minimal Document
 
@@ -76,7 +76,7 @@ Supported languages include TypeScript, JavaScript, Python, Rust, HTML/XML, CSS,
 
 ## Validation
 
-`p11 publish` validates the document before build and upload.
+`p11 share` validates the document before build and upload.
 
 Do not import or render app/control components such as:
 

package/docs/index.md

@@ -1,12 +1,12 @@
 # p11 CLI Docs
 
-p11 publishes reviewable, public-but-unlisted document pages from React document modules.
+p11 shares reviewable, public-but-unlisted document pages from React files.
 
 ## Common Commands
 
 ```bash
-p11 publish <page.tsx>
-p11 publish <page.tsx> --edit-url <editUrl>
+p11 share <page.tsx>
+p11 share <page.tsx> --edit-url <editUrl>
 p11 history
 p11 comments <readUrl|editUrl|readId|editId>
 ```
@@ -17,7 +17,7 @@ Add `--json` when scripting or when exact structured fields are needed.
 
 ```bash
 p11 docs components
-p11 docs publishing
+p11 docs sharing
 ```
 
 ## Examples
@@ -28,4 +28,4 @@ p11 example all-components
 p11 example all-components --output ./all-components.tsx
 ```
 
-Use `p11 publish --help`, `p11 comments --help`, and `p11 history --help` for command-specific flags.
+Use `p11 share --help`, `p11 comments --help`, and `p11 history --help` for command-specific flags.

package/docs/{publishing.md → sharing.md}

@@ -1,18 +1,18 @@
-# p11 Publishing
+# p11 Sharing
 
-Publish a document module:
+Share a review link for a document:
 
 ```bash
-p11 publish ./page.tsx
+p11 share ./page.tsx
 ```
 
-Update an existing document with an edit URL or edit id:
+Share a new version with an edit URL or edit id:
 
 ```bash
-p11 publish ./page.tsx --edit-url <editUrl>
+p11 share ./page.tsx --edit-url <editUrl>
 ```
 
-Fetch recent local publish history:
+Fetch recent local share history:
 
 ```bash
 p11 history

package/examples/all-components.tsx

@@ -46,7 +46,7 @@ export default function All() {
           <Quote>
             The page is intentionally broad: authors can use it to inspect
             screen layout, print pagination, source-line anchors, tables,
-            figures, and syntax highlighting in one published document.
+            figures, and syntax highlighting in one shared document.
           </Quote>
         </Section>
 
@@ -76,7 +76,7 @@ export default function All() {
             Unordered lists work for parallel facts and short capabilities.
           </Text>
           <List>
-            <ListItem>Publish static React-authored documents.</ListItem>
+            <ListItem>Share static React-authored documents.</ListItem>
             <ListItem>Allow anonymous comments on text selections.</ListItem>
             <ListItem>
               Export comments with source file and line anchors.
@@ -84,8 +84,8 @@ export default function All() {
           </List>
           <Text>Ordered lists work for procedural steps.</Text>
           <List ordered>
-            <ListItem>Author a document module.</ListItem>
-            <ListItem>Publish it with the CLI.</ListItem>
+            <ListItem>Author a document file.</ListItem>
+            <ListItem>Share it with the CLI.</ListItem>
             <ListItem>
               Review the screen view and browser print output.
             </ListItem>
@@ -166,12 +166,12 @@ export default function All() {
           <Heading>6. TypeScript</Heading>
           <CodeBlock language="typescript">
             {code`
-              type PublishOptions = {
+              type ShareOptions = {
                 input: string;
                 comments?: boolean;
               };
 
-              export async function publish(options: PublishOptions) {
+              export async function share(options: ShareOptions) {
                 const response = await fetch("/api/pages", {
                   method: "POST",
                   body: JSON.stringify(options)
@@ -307,7 +307,7 @@ export default function All() {
           <Heading>14. Bash</Heading>
           <CodeBlock language="bash">
             {code`
-              p11 publish ./all-components.tsx
+              p11 share ./all-components.tsx
               p11 comments <readUrl> --version 1
             `}
           </CodeBlock>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@p11-core/cli",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "license": "UNLICENSED",
   "type": "module",
   "bin": {