@avocadostudio-ai/cli 0.3.2 → 0.3.3

package/README.md

@@ -1,8 +1,31 @@
 # @avocadostudio-ai/cli
 
-Self-host launcher for the Avocado Studio editor UI. Serves a prebuilt editor bundle and points it at any [Avocado Studio orchestrator](https://github.com/avocadostudio-ai/avocado) you control.
+Self-host launcher for the Avocado Studio editor UI. Serves a prebuilt editor bundle and points it at any Avocado Studio orchestrator you control.
 
-## Quick Start
+**This package is the editor UI and nothing else.** There is no third service to
+deploy, and for most sites there is no separate orchestrator to deploy either —
+see [Library mode](#library-mode-the-common-case) before following the Quick
+Start, which describes the standalone deployment.
+
+## Library mode: the common case
+
+If your site mounts `createOrchestrator` from `@avocadostudio-ai/site-sdk` — the
+path the [integration docs](https://docs.avocadostudio.dev/integration/nextjs-integration)
+describe — the orchestrator is already running *inside your site*, at
+`/api/avocado`. Point the CLI at it:
+
+```bash
+npx @avocadostudio-ai/cli start \
+  --orchestrator http://localhost:3000/api/avocado \
+  --preview      http://localhost:3000
+```
+
+Two commands total, in two terminals: your `dev` script, and this. Substitute
+your own port — `3000` is the Next.js default, not a requirement. The default
+`--orchestrator` value below (`http://localhost:4200`) is for the standalone
+server and is **wrong for library mode**; pass the flag.
+
+## Quick Start (standalone orchestrator)
 
 ```bash
 npx @avocadostudio-ai/cli start --orchestrator https://your-orchestrator.example.com
@@ -20,8 +43,8 @@ npx @avocadostudio-ai/cli start \
 
 ## What You Need
 
-- An Avocado Studio orchestrator running and reachable from your browser. See the [orchestrator setup docs](https://github.com/avocadostudio-ai/avocado/tree/main/apps/orchestrator).
-- A site that integrates the [`@avocadostudio-ai/site-sdk`](https://github.com/avocadostudio-ai/avocado/tree/main/packages/site-sdk) so the editor can load, edit, and publish to it.
+- An orchestrator the editor can reach — either mounted in your site (library mode, above) or deployed separately.
+- A site that integrates [`@avocadostudio-ai/site-sdk`](https://www.npmjs.com/package/@avocadostudio-ai/site-sdk) so the editor can load, edit, and publish to it. Its README is the fullest reference for both modes.
 - Node.js 22+.
 
 ## Flags
@@ -46,13 +69,13 @@ This means the same prebuilt bundle works against any orchestrator — no rebuil
 
 The CLI ships a frozen editor build that speaks postMessage protocol `site-editor/v1`. On startup it probes the orchestrator's `/health` endpoint and warns if the reported `protocolVersion` does not match. The warning does not block startup — the editor may still work if the protocol changes were backwards-compatible.
 
-Pin the CLI version to your orchestrator deployment if you want strict compatibility. Use `npx @avocadostudio-ai/cli@0.1.0 start ...` to lock to a specific version.
+Pin the CLI version to your orchestrator deployment if you want strict compatibility — `npx @avocadostudio-ai/cli@<version> start ...`, using the version your site's `@avocadostudio-ai/*` packages are on. Keep the two in step: the CLI ships a frozen editor build, so a CLI several releases behind your site is the usual cause of an editor that loads and then behaves oddly.
 
 ## What This Is Not
 
 - **Not an auth layer.** The orchestrator handles auth via its `/auth/status` and `/auth/verify` routes; set `ACCESS_PASSWORD_HASH` on the orchestrator side. The CLI doesn't proxy or gate requests.
 - **Not a managed service.** No telemetry is sent anywhere. If you want the hosted Avocado Studio with managed orchestrator + eval pipeline, see the project homepage.
-- **Not bundled with an orchestrator.** You run the orchestrator separately (Render, Fly, Docker, your own box). This CLI is just the editor UI.
+- **Not an orchestrator.** This CLI is the editor UI. The orchestrator runs either inside your site (`createOrchestrator`, the common case) or separately (Render, Fly, Docker, your own box). Either way it is not in this package — but "separately" is not the only option, and reading this line as "you must deploy a third service" is the misreading it used to invite.
 
 ## License
 

package/dist/index.js

@@ -13922,7 +13922,16 @@ var f = {
   text: (label) => ({ kind: "text", label }),
   longtext: (label) => ({ kind: "text", label, multiline: true }),
   richtext: (label) => ({ kind: "richtext", label }),
+  /** A resource address — an iframe src, a video file. Never an internal page. */
   url: (label) => ({ kind: "url", label, inlineEditable: false }),
+  /** A navigation target: an internal page, or an external URL / mailto / tel / anchor. */
+  link: (label) => ({ kind: "link", label, inlineEditable: false }),
+  /**
+   * The "open in new tab" companion for a link prop. Named by convention
+   * (`newTabKeyFor`) so the property panel renders it inside the link control
+   * rather than as a row of its own — the same pairing as `image`/`imageAlt`.
+   */
+  newTab: (label = "Open in new tab") => ({ kind: "boolean", label, inlineEditable: false }),
   image: (label, imageSpec) => ({ kind: "image", label, inlineEditable: false, ...imageSpec ? { imageSpec } : {} }),
   imageAlt: (label) => ({ kind: "imageAlt", label }),
   headingLevel: () => ({ kind: "headingLevel", label: "Heading type", inlineEditable: false })
@@ -13935,13 +13944,15 @@ registerBlock("Hero", {
     subheading: external_exports.string().min(1),
     ctaText: external_exports.string().min(1),
     ctaHref: external_exports.string().min(1),
+    ctaNewTab: external_exports.boolean().optional(),
     imageUrl: external_exports.string().min(1),
     imageAlt: external_exports.string().min(1),
     imagePosition: external_exports.enum(["left", "right", "full"]).default("right").catch("right"),
     textAlign: external_exports.enum(["left", "center"]).default("left").catch("left"),
     eyebrow: external_exports.string().optional(),
     secondaryCtaText: external_exports.string().optional(),
-    secondaryCtaHref: external_exports.string().optional()
+    secondaryCtaHref: external_exports.string().optional(),
+    secondaryCtaNewTab: external_exports.boolean().optional()
   }),
   meta: {
     displayName: "Hero",
@@ -13951,14 +13962,16 @@ registerBlock("Hero", {
       heading: f.text("Heading"),
       subheading: f.text("Subheading"),
       ctaText: f.text("CTA button text"),
-      ctaHref: f.url("CTA link"),
+      ctaHref: f.link("CTA link"),
+      ctaNewTab: f.newTab(),
       imageUrl: f.image("Hero image", { aspectRatio: "landscape", width: 1536, height: 1024 }),
       imageAlt: f.imageAlt("Hero image alt text"),
       imagePosition: { kind: "enum", label: "Image position", options: ["left", "right", "full"], inlineEditable: false },
       textAlign: { kind: "enum", label: "Text alignment", options: ["left", "center"], inlineEditable: false },
       eyebrow: f.text("Eyebrow text"),
       secondaryCtaText: f.text("Secondary CTA text"),
-      secondaryCtaHref: f.url("Secondary CTA link"),
+      secondaryCtaHref: f.link("Secondary CTA link"),
+      secondaryCtaNewTab: f.newTab(),
       headingLevel: f.headingLevel()
     }
   }
@@ -14060,8 +14073,10 @@ registerBlock("CTA", {
     description: external_exports.string().min(1),
     ctaText: external_exports.string().min(1),
     ctaHref: external_exports.string().min(1),
+    ctaNewTab: external_exports.boolean().optional(),
     secondaryCtaText: external_exports.string().optional(),
-    secondaryCtaHref: external_exports.string().optional()
+    secondaryCtaHref: external_exports.string().optional(),
+    secondaryCtaNewTab: external_exports.boolean().optional()
   }),
   meta: {
     displayName: "Call to Action",
@@ -14071,9 +14086,11 @@ registerBlock("CTA", {
       title: f.text("Headline"),
       description: f.longtext("Description"),
       ctaText: f.text("Button text"),
-      ctaHref: f.url("Button link"),
+      ctaHref: f.link("Button link"),
+      ctaNewTab: f.newTab(),
       secondaryCtaText: f.text("Secondary button text"),
-      secondaryCtaHref: f.url("Secondary button link"),
+      secondaryCtaHref: f.link("Secondary button link"),
+      secondaryCtaNewTab: f.newTab(),
       headingLevel: f.headingLevel()
     }
   }
@@ -14086,6 +14103,7 @@ registerBlock("Card", {
     description: external_exports.string().min(1),
     ctaText: external_exports.string().min(1),
     ctaHref: external_exports.string().min(1),
+    ctaNewTab: external_exports.boolean().optional(),
     imageUrl: external_exports.string().min(1).optional(),
     imageAlt: external_exports.string().min(1).optional(),
     variant: external_exports.enum(["default", "full-bleed"]).default("default").catch("default")
@@ -14098,7 +14116,8 @@ registerBlock("Card", {
       title: f.text("Card title"),
       description: f.longtext("Card description"),
       ctaText: f.text("Button text"),
-      ctaHref: f.url("Button link"),
+      ctaHref: f.link("Button link"),
+      ctaNewTab: f.newTab(),
       imageUrl: f.image("Card image", { aspectRatio: "landscape", width: 768, height: 512 }),
       imageAlt: f.imageAlt("Card image alt text"),
       variant: { kind: "enum", label: "Variant", options: ["default", "full-bleed"], inlineEditable: false },
@@ -14121,6 +14140,7 @@ registerBlock("CardGrid", {
         description: external_exports.string().min(1),
         ctaText: external_exports.string().min(1),
         ctaHref: external_exports.string().min(1),
+        ctaNewTab: external_exports.boolean().optional(),
         imageUrl: external_exports.string().min(1).optional(),
         imageAlt: external_exports.string().min(1).optional()
       })
@@ -14144,7 +14164,8 @@ registerBlock("CardGrid", {
           title: f.text("Card title"),
           description: f.longtext("Card description"),
           ctaText: f.text("Button text"),
-          ctaHref: f.url("Button link"),
+          ctaHref: f.link("Button link"),
+          ctaNewTab: f.newTab(),
           imageUrl: f.image("Card image", { aspectRatio: "landscape", width: 768, height: 512 }),
           imageAlt: f.imageAlt("Card image alt text")
         }
@@ -14212,6 +14233,7 @@ var twoColumnChild = external_exports.object({
   text: external_exports.string().optional(),
   label: external_exports.string().optional(),
   href: external_exports.string().optional(),
+  newTab: external_exports.boolean().optional(),
   src: external_exports.string().optional(),
   alt: external_exports.string().optional(),
   poster: external_exports.string().optional(),
@@ -14223,7 +14245,8 @@ var twoColumnItemFields = {
   type: { kind: "enum", label: "Component type", options: ["heading", "subheading", "paragraph", "list", "cta", "ctas", "image", "video"] },
   text: f.longtext("Text content"),
   label: f.text("Button label"),
-  href: f.url("Link URL"),
+  href: f.link("Link URL"),
+  newTab: f.newTab(),
   src: f.image("Media source", { aspectRatio: "portrait", width: 768, height: 1024 }),
   alt: f.imageAlt("Alt text"),
   poster: f.image("Video poster image", { aspectRatio: "landscape", width: 768, height: 512 })
@@ -14293,7 +14316,8 @@ registerBlock("Footer", {
 var navLinkLeaf = external_exports.object({
   id: external_exports.string().optional(),
   label: external_exports.string().min(1),
-  href: external_exports.string().min(1)
+  href: external_exports.string().min(1),
+  newTab: external_exports.boolean().optional()
 });
 registerBlock("SiteHeader", {
   schema: external_exports.object({
@@ -14320,7 +14344,8 @@ registerBlock("SiteHeader", {
         label: "Nav links",
         itemFields: {
           label: f.text("Link label"),
-          href: f.url("Link URL")
+          href: f.link("Link URL"),
+          newTab: f.newTab()
         }
       }
     }
@@ -14355,6 +14380,7 @@ registerBlock("Banner", {
     variant: external_exports.enum(["info", "success", "warning"]).default("info").catch("info"),
     ctaText: external_exports.string().optional(),
     ctaHref: external_exports.string().optional(),
+    ctaNewTab: external_exports.boolean().optional(),
     backgroundColor: external_exports.string().optional(),
     textColor: external_exports.string().optional()
   }),
@@ -14366,7 +14392,8 @@ registerBlock("Banner", {
       text: f.text("Banner text"),
       variant: { kind: "enum", label: "Variant", options: ["info", "success", "warning"], inlineEditable: false },
       ctaText: f.text("Button label"),
-      ctaHref: f.url("Button link"),
+      ctaHref: f.link("Button link"),
+      ctaNewTab: f.newTab(),
       backgroundColor: { kind: "color", label: "Background color", inlineEditable: false },
       textColor: { kind: "color", label: "Text color", inlineEditable: false }
     }
@@ -14383,7 +14410,8 @@ registerBlock("Carousel", {
       heading: external_exports.string().optional(),
       description: external_exports.string().optional(),
       ctaText: external_exports.string().optional(),
-      ctaHref: external_exports.string().optional()
+      ctaHref: external_exports.string().optional(),
+      ctaNewTab: external_exports.boolean().optional()
     })).min(1),
     autoplay: external_exports.enum(["true", "false"]).default("false").catch("false"),
     interval: external_exports.number().optional()
@@ -14405,7 +14433,8 @@ registerBlock("Carousel", {
           heading: f.text("Heading"),
           description: f.longtext("Description"),
           ctaText: f.text("Button label"),
-          ctaHref: f.url("Button link")
+          ctaHref: f.link("Button link"),
+          ctaNewTab: f.newTab()
         }
       }
     }
@@ -14490,8 +14519,11 @@ registerBlock("Table", {
     fields: {
       title: f.text("Section title"),
       headingLevel: f.headingLevel(),
-      headers: f.text("Column headers"),
-      rows: f.text("Table rows"),
+      // Both are lists of scalars, which `FieldKind` cannot name — the panel
+      // recognises the value's shape instead: `headers` edits one per line,
+      // `rows` (string[][]) is shown there and edited cell-by-cell in the page.
+      headers: f.text("Column headers (one per line)"),
+      rows: f.text("Table rows (edit cells in the page)"),
       striped: { kind: "enum", label: "Striped rows", options: ["true", "false"], inlineEditable: false }
     }
   }
@@ -14559,7 +14591,7 @@ var jsonSchemaLikeSchema = external_exports.lazy(
   }).catchall(external_exports.unknown())
 );
 var fieldMetaSchema = external_exports.object({
-  kind: external_exports.enum(["text", "richtext", "url", "image", "imageAlt", "enum", "color", "number", "boolean", "headingLevel"]),
+  kind: external_exports.enum(["text", "richtext", "url", "link", "image", "imageAlt", "enum", "color", "number", "boolean", "headingLevel"]),
   label: external_exports.string().optional(),
   inlineEditable: external_exports.boolean().optional(),
   options: external_exports.array(external_exports.string()).optional(),
@@ -15041,7 +15073,19 @@ var chatStartResponseSchema = external_exports.object({
   error: external_exports.string().optional()
 }).passthrough();
 var slugsResponseSchema = external_exports.object({
-  slugs: external_exports.array(external_exports.string()).optional()
+  slugs: external_exports.array(external_exports.string()).optional(),
+  /*
+   * The same pages the `slugs` array names, with the title and the URL that
+   * `/draft/slugs` has always returned beside them. The editor parsed this
+   * response and kept only the bare slugs, so the link picker had nothing to
+   * label a page with; `path` is what a locale-prefixed site navigates to when
+   * it differs from the slug (see docs/ideas/page-identity-punch-list.md).
+   */
+  pages: external_exports.array(external_exports.object({
+    slug: external_exports.string(),
+    path: external_exports.string().optional(),
+    title: external_exports.string().optional()
+  }).passthrough()).optional()
 }).passthrough();
 var bootstrapResponseSchema = external_exports.object({
   slugs: external_exports.array(external_exports.string()).optional()

package/editor-dist/assets/{Editor-EPSED64A-CH6D2Zb0.js → Editor-EPSED64A-BQPpPIMn.js}

@@ -1 +1 @@
-import{P as b}from"./chunk-2CNEFIQP-D3Yc-Xrd.js";import{u as y,a as j,E as L,_ as m,L as M,b as p,o as P,i as A}from"./PuckPrototypeRoute-dMA7e2BV.js";import{r as s,j as g}from"./index-bSQ3lNnY.js";import{E as N,u as U}from"./index-Zan79wWH.js";import"./index-QORB5JJO.js";A();A();function C({content:a,onChange:x,extensions:v,editable:d=!0,onFocusChange:o,name:c}){const[i,E]=P(null,50,{leading:!0,maxWait:200}),l=s.useRef(!1),S=s.useRef(""),f=s.useRef(null),R=!!f.current,_=j(t=>t.state.ui.field.focus===c),T=t=>{f.current&&clearTimeout(f.current),f.current=setTimeout(()=>{S.current===t&&(f.current=null)},200)},u=y(),e=U({extensions:v,content:a,editable:d,immediatelyRender:!1,parseOptions:{preserveWhitespace:"full"},onUpdate:({editor:t})=>{if(l.current||!_){u.getState().setUi({field:{focus:c}});return}const r=t.getHTML(),{from:n,to:h}=t.state.selection;E({from:n,to:h,html:r}),T(r),S.current=r}});return s.useEffect(()=>{if(!e)return;const t=()=>{o==null||o(e)};return e.on("focus",t),()=>{e.off("focus",t)}},[e,o]),s.useEffect(()=>{if(i){const{ui:t}=u.getState().state;x(i.html,{field:m(p({},t.field),{metadata:{from:i.from,to:i.to}})})}},[e,i,x,u,c]),s.useEffect(()=>{e==null||e.setEditable(d)},[e,d]),s.useEffect(()=>{var t;if(!e||R||e.getHTML()===a)return;l.current=!0,e.commands.setContent(a,{emitUpdate:!1});const{ui:n}=u.getState().state;typeof((t=n.field.metadata)==null?void 0:t.from)<"u"&&e.commands.setTextSelection({from:n.field.metadata.from,to:n.field.metadata.to}),l.current=!1},[a,e,u]),e}var F=s.memo(a=>{const{onChange:x,content:v,readOnly:d=!1,field:o,inline:c=!1,onFocus:i,id:E,name:l}=a,{tiptap:S={},options:f}=o,{extensions:R=[]}=S,_=s.useMemo(()=>[b.configure(f),...R],[o,R]),T=y(),u=`${l}${c?"::inline":""}`,e=C({content:v,onChange:x,extensions:_,editable:!d,name:u,onFocusChange:r=>{if(r){const n=T.getState();T.setState({currentRichText:{field:o,editor:r,id:E,inline:c},state:m(p({},n.state),{ui:m(p({},n.state.ui),{field:m(p({},n.state.ui.field),{focus:u})})})}),i==null||i(r)}}}),t=j(r=>{var n,h;return!c&&((n=r.currentRichText)==null?void 0:n.id)===E&&((h=r.currentRichText)!=null&&h.inlineComponentId)?r.currentRichText.editor:e});return e?g.jsx(L,m(p({},a),{editor:e,menu:g.jsx(M,{field:o,editor:t,readOnly:d}),children:g.jsx(N,{editor:e,className:"rich-text"})})):null});F.displayName="Editor";export{F as Editor};
+import{P as b}from"./chunk-2CNEFIQP-B3HjHnn-.js";import{u as y,a as j,E as L,_ as m,L as M,b as p,o as P,i as A}from"./PuckPrototypeRoute-CEtarLZd.js";import{r as s,j as g}from"./index-8s1LXOA6.js";import{E as N,u as U}from"./index-B0cipFdl.js";import"./index-CIC8kldS.js";A();A();function C({content:a,onChange:x,extensions:v,editable:d=!0,onFocusChange:o,name:c}){const[i,E]=P(null,50,{leading:!0,maxWait:200}),l=s.useRef(!1),S=s.useRef(""),f=s.useRef(null),R=!!f.current,_=j(t=>t.state.ui.field.focus===c),T=t=>{f.current&&clearTimeout(f.current),f.current=setTimeout(()=>{S.current===t&&(f.current=null)},200)},u=y(),e=U({extensions:v,content:a,editable:d,immediatelyRender:!1,parseOptions:{preserveWhitespace:"full"},onUpdate:({editor:t})=>{if(l.current||!_){u.getState().setUi({field:{focus:c}});return}const r=t.getHTML(),{from:n,to:h}=t.state.selection;E({from:n,to:h,html:r}),T(r),S.current=r}});return s.useEffect(()=>{if(!e)return;const t=()=>{o==null||o(e)};return e.on("focus",t),()=>{e.off("focus",t)}},[e,o]),s.useEffect(()=>{if(i){const{ui:t}=u.getState().state;x(i.html,{field:m(p({},t.field),{metadata:{from:i.from,to:i.to}})})}},[e,i,x,u,c]),s.useEffect(()=>{e==null||e.setEditable(d)},[e,d]),s.useEffect(()=>{var t;if(!e||R||e.getHTML()===a)return;l.current=!0,e.commands.setContent(a,{emitUpdate:!1});const{ui:n}=u.getState().state;typeof((t=n.field.metadata)==null?void 0:t.from)<"u"&&e.commands.setTextSelection({from:n.field.metadata.from,to:n.field.metadata.to}),l.current=!1},[a,e,u]),e}var F=s.memo(a=>{const{onChange:x,content:v,readOnly:d=!1,field:o,inline:c=!1,onFocus:i,id:E,name:l}=a,{tiptap:S={},options:f}=o,{extensions:R=[]}=S,_=s.useMemo(()=>[b.configure(f),...R],[o,R]),T=y(),u=`${l}${c?"::inline":""}`,e=C({content:v,onChange:x,extensions:_,editable:!d,name:u,onFocusChange:r=>{if(r){const n=T.getState();T.setState({currentRichText:{field:o,editor:r,id:E,inline:c},state:m(p({},n.state),{ui:m(p({},n.state.ui),{field:m(p({},n.state.ui.field),{focus:u})})})}),i==null||i(r)}}}),t=j(r=>{var n,h;return!c&&((n=r.currentRichText)==null?void 0:n.id)===E&&((h=r.currentRichText)!=null&&h.inlineComponentId)?r.currentRichText.editor:e});return e?g.jsx(L,m(p({},a),{editor:e,menu:g.jsx(M,{field:o,editor:t,readOnly:d}),children:g.jsx(N,{editor:e,className:"rich-text"})})):null});F.displayName="Editor";export{F as Editor};