@particle-academy/fancy-cms-ui 0.0.1-dev.9 → 0.1.0

package/dist/editor.cjs

@@ -361,10 +361,13 @@ ${inner}
   }
   return blocks.join("\n\n") + (blocks.length ? "\n" : "");
 }
-function literal(v) {
-  if (v === void 0 || v === null) return "";
-  if (isBinding(v)) return "";
-  return String(v);
+function getPath(data, path) {
+  return path.split(".").reduce((o, k) => o == null ? void 0 : o[k], data);
+}
+function resolveValue(v, data) {
+  if (v === void 0 || v === null) return v;
+  if (isBinding(v)) return getPath(data, v.$bind);
+  return v;
 }
 var defaultRegistry = {
   section: ({ children }) => children,
@@ -372,18 +375,29 @@ var defaultRegistry = {
   grid: ({ children }) => children,
   frame: ({ children }) => children,
   shape: ({ children }) => children,
-  text: ({ node }) => literal(node.props.content),
-  heading: ({ node }) => literal(node.props.content) || "Heading",
-  button: ({ node }) => {
-    const label2 = literal(node.props.label) || literal(node.props.content) || "Button";
-    const variant = literal(node.props.variant) || "primary";
+  card: ({ children }) => children,
+  text: ({ node, text }) => text(node.props.content),
+  heading: ({ node, text }) => text(node.props.content) || "Heading",
+  // Rich text — inline-formatted HTML (gradient spans, links, <code>, …) that
+  // plain `text` can't express. The author owns the markup (it's their content).
+  richtext: ({ node, text }) => /* @__PURE__ */ jsxRuntime.jsx("div", { dangerouslySetInnerHTML: { __html: text(node.props.html) } }),
+  link: ({ node, text }) => /* @__PURE__ */ jsxRuntime.jsx("a", { href: text(node.props.href) || "#", style: { color: "inherit", textDecoration: "underline" }, children: text(node.props.content) || "link" }),
+  divider: () => /* @__PURE__ */ jsxRuntime.jsx("hr", { style: { border: "none", borderTop: "1px solid #e2e8f0", margin: 0 } }),
+  callout: ({ node, text }) => {
+    const tone = { info: "#3b82f6", success: "#10b981", warning: "#f59e0b", danger: "#ef4444" }[text(node.props.variant)] ?? "#3b82f6";
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { style: { display: "flex", gap: 10, padding: "12px 14px", borderRadius: 10, background: `${tone}14`, borderLeft: `3px solid ${tone}` }, children: /* @__PURE__ */ jsxRuntime.jsx("span", { style: { fontSize: 13 }, children: text(node.props.content) || "Callout" }) });
+  },
+  code: ({ node, text }) => /* @__PURE__ */ jsxRuntime.jsx("pre", { style: { margin: 0, padding: "12px 14px", borderRadius: 10, background: "#0b1220", color: "#e2e8f0", fontFamily: "ui-monospace, monospace", fontSize: 13, overflowX: "auto" }, children: /* @__PURE__ */ jsxRuntime.jsx("code", { children: text(node.props.content) }) }),
+  button: ({ node, text }) => {
+    const label2 = text(node.props.label) || text(node.props.content) || "Button";
+    const variant = text(node.props.variant) || "primary";
     return /* @__PURE__ */ jsxRuntime.jsx("span", { "data-cms-button": variant, style: buttonStyle(variant), children: label2 });
   },
-  image: ({ node }) => /* @__PURE__ */ jsxRuntime.jsx(
+  image: ({ node, text }) => /* @__PURE__ */ jsxRuntime.jsx(
     "img",
     {
-      src: literal(node.props.src),
-      alt: literal(node.props.alt),
+      src: text(node.props.src),
+      alt: text(node.props.alt),
       style: { width: "100%", height: "100%", objectFit: "cover", display: "block" }
     }
   )
@@ -405,30 +419,34 @@ function buttonStyle(variant) {
   if (variant === "outline") return { ...base, background: "transparent", color: "#7c3aed", border: "1px solid #7c3aed" };
   return { ...base, background: "#7c3aed", color: "#fff", border: "1px solid #7c3aed" };
 }
-function RenderNode({ doc, id, registry = defaultRegistry }) {
+function RenderNode({ doc, id, registry = defaultRegistry, data }) {
   const node = doc.nodes[id];
   if (!node) return null;
-  const kids = childrenOf(doc, id).map((child) => /* @__PURE__ */ jsxRuntime.jsx(RenderNode, { doc, id: child.id, registry }, child.id));
+  if (node.type === "repeater") {
+    const arr = resolveValue(node.props.items, data);
+    const items = Array.isArray(arr) ? arr : [];
+    const template = childrenOf(doc, id)[0];
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { "data-cms": node.id, className: node.className, children: template ? items.map((item, index) => /* @__PURE__ */ jsxRuntime.jsx(RenderNode, { doc, id: template.id, registry, data: { ...data, item, index } }, index)) : null });
+  }
+  const kids = childrenOf(doc, id).map((child) => /* @__PURE__ */ jsxRuntime.jsx(RenderNode, { doc, id: child.id, registry, data }, child.id));
+  const resolve = (v) => resolveValue(v, data);
+  const text = (v) => {
+    const r = resolve(v);
+    return r === void 0 || r === null ? "" : String(r);
+  };
   const renderer = registry[node.type];
-  const inner = renderer ? renderer({ node, doc, children: kids }) : node.island ? null : kids;
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    "div",
-    {
-      "data-cms": node.id,
-      "data-cms-island": node.island ? node.type : void 0,
-      className: node.className,
-      children: inner
-    }
-  );
+  const inner = renderer ? renderer({ node, doc, children: kids, data, resolve, text }) : node.island ? null : kids;
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { "data-cms": node.id, "data-cms-island": node.island ? node.type : void 0, className: node.className, children: inner });
 }
 function CmsPage({
   doc,
   registry = defaultRegistry,
+  data,
   includeStyles = true
 }) {
   return /* @__PURE__ */ jsxRuntime.jsxs(react.Fragment, { children: [
     includeStyles ? /* @__PURE__ */ jsxRuntime.jsx("style", { "data-cms-styles": "", children: emitDocCss(doc) }) : null,
-    doc.sections.map((id) => /* @__PURE__ */ jsxRuntime.jsx(RenderNode, { doc, id, registry }, id))
+    doc.sections.map((id) => /* @__PURE__ */ jsxRuntime.jsx(RenderNode, { doc, id, registry, data }, id))
   ] });
 }
 function Canvas({ doc, selection, onSelect, apply }) {
@@ -802,7 +820,7 @@ function Toolbar({ ed }) {
     }
   );
 }
-var CONTAINER_TYPES = /* @__PURE__ */ new Set(["section", "frame", "stack", "grid", "shape"]);
+var CONTAINER_TYPES = /* @__PURE__ */ new Set(["section", "frame", "stack", "grid", "shape", "card", "device"]);
 function NodeInspector({
   node,
   transform,
@@ -816,9 +834,9 @@ function NodeInspector({
 }) {
   const base = node.style.base ?? {};
   const setT = (patch) => onTransform({ ...transform, ...patch });
-  const handled = /* @__PURE__ */ new Set(["content", "label"]);
+  const handled = /* @__PURE__ */ new Set(["content", "label", "html"]);
   const extraKeys = Object.keys(node.props).filter(
-    (k) => !handled.has(k) && ["string", "number", "boolean"].includes(typeof node.props[k])
+    (k) => !handled.has(k) && (["string", "number", "boolean"].includes(typeof node.props[k]) || isBinding(node.props[k]))
   );
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { style: panel, onPointerDown: (e) => e.stopPropagation(), children: [
     /* @__PURE__ */ jsxRuntime.jsxs("div", { style: headRow, children: [
@@ -831,14 +849,11 @@ function NodeInspector({
       /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", style: iconBtn, title: "Close", onClick: onClose, children: "\u2715" })
     ] }),
     /* @__PURE__ */ jsxRuntime.jsxs("div", { style: body, children: [
-      "content" in node.props ? /* @__PURE__ */ jsxRuntime.jsx(Group, { label: "Content", children: /* @__PURE__ */ jsxRuntime.jsx(
-        "textarea",
-        {
-          style: { ...input2, minHeight: 64, resize: "vertical", lineHeight: 1.4 },
-          value: String(node.props.content ?? ""),
-          onChange: (e) => onProps({ content: e.target.value })
-        }
-      ) }) : null,
+      "content" in node.props || node.type === "richtext" ? /* @__PURE__ */ jsxRuntime.jsxs("p", { style: { fontSize: 11, color: "var(--fg-3, #94a3b8)", margin: "0 0 12px", lineHeight: 1.45, paddingBottom: 12, borderBottom: "1px solid #1e293b" }, children: [
+        "\u270E Edit the text ",
+        /* @__PURE__ */ jsxRuntime.jsx("strong", { children: "directly on the page" }),
+        " \u2014 click in and type. This panel is for layout, style, and bindings."
+      ] }) : null,
       "label" in node.props ? /* @__PURE__ */ jsxRuntime.jsx(Group, { label: "Label", children: /* @__PURE__ */ jsxRuntime.jsx("input", { style: input2, value: String(node.props.label ?? ""), onChange: (e) => onProps({ label: e.target.value }) }) }) : null,
       extraKeys.length ? /* @__PURE__ */ jsxRuntime.jsx(Group, { label: "Properties", children: extraKeys.map((k) => /* @__PURE__ */ jsxRuntime.jsx(PropField, { name: k, value: node.props[k], onChange: (v) => onProps({ [k]: v }) }, k)) }) : null,
       /* @__PURE__ */ jsxRuntime.jsxs(Group, { label: "Position & size", children: [
@@ -943,24 +958,50 @@ function Row({ children }) {
   return /* @__PURE__ */ jsxRuntime.jsx("div", { style: { display: "flex", gap: 8 }, children });
 }
 function PropField({ name, value, onChange }) {
+  const bound = isBinding(value);
+  const link = /* @__PURE__ */ jsxRuntime.jsx(
+    "button",
+    {
+      type: "button",
+      title: bound ? "Unbind (use a literal value)" : "Bind to data (e.g. item.name)",
+      onClick: () => onChange(bound ? "" : { $bind: "" }),
+      style: { background: "none", border: "none", cursor: "pointer", padding: 0, fontSize: 11, color: bound ? "#a78bfa" : "#64748b" },
+      children: "\u{1F517}"
+    }
+  );
+  if (bound) {
+    return /* @__PURE__ */ jsxRuntime.jsxs("label", { style: field, children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("span", { style: { ...fieldLabel, display: "flex", justifyContent: "space-between", alignItems: "center" }, children: [
+        name,
+        " ",
+        link
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsx("input", { style: { ...input2, borderColor: "#7c3aed" }, placeholder: "data path \xB7 e.g. item.name", value: value.$bind, onChange: (e) => onChange({ $bind: e.target.value }) })
+    ] });
+  }
   if (typeof value === "boolean") {
     return /* @__PURE__ */ jsxRuntime.jsxs("label", { style: { display: "flex", alignItems: "center", gap: 8, fontSize: 12 }, children: [
       /* @__PURE__ */ jsxRuntime.jsx("input", { type: "checkbox", checked: value, onChange: (e) => onChange(e.target.checked) }),
-      /* @__PURE__ */ jsxRuntime.jsx("span", { style: { textTransform: "capitalize" }, children: name })
+      /* @__PURE__ */ jsxRuntime.jsx("span", { style: { textTransform: "capitalize", flex: 1 }, children: name }),
+      link
     ] });
   }
   if (name === "variant") {
-    return /* @__PURE__ */ jsxRuntime.jsx(Sel, { label: name, value: String(value), options: [["primary", "Primary"], ["ghost", "Ghost"], ["outline", "Outline"]], onChange });
+    return /* @__PURE__ */ jsxRuntime.jsx(Sel, { label: name, value: String(value ?? ""), options: [["primary", "Primary"], ["ghost", "Ghost"], ["outline", "Outline"]], onChange });
   }
   const isNum = typeof value === "number";
   return /* @__PURE__ */ jsxRuntime.jsxs("label", { style: field, children: [
-    /* @__PURE__ */ jsxRuntime.jsx("span", { style: fieldLabel, children: name }),
+    /* @__PURE__ */ jsxRuntime.jsxs("span", { style: { ...fieldLabel, display: "flex", justifyContent: "space-between", alignItems: "center" }, children: [
+      name,
+      " ",
+      link
+    ] }),
     /* @__PURE__ */ jsxRuntime.jsx(
       "input",
       {
         style: input2,
         type: isNum ? "number" : "text",
-        value: String(value),
+        value: String(value ?? ""),
         onChange: (e) => onChange(isNum ? Number(e.target.value) : e.target.value)
       }
     )
@@ -1144,9 +1185,11 @@ function snapshotSubtree(doc, id) {
   return { rootId: id, nodes };
 }
 var Z2 = 2147483e3;
+var SNAP = 6;
 function EditablePage({
   doc,
   registry = defaultRegistry,
+  data,
   timelineDock,
   transforms,
   onNodeTransform,
@@ -1218,13 +1261,17 @@ function EditablePage({
     };
   }, [measureBox, ed.state.doc]);
   react.useEffect(() => {
-    if (!editing || !selection || !pageRef.current || selNode?.type !== "text") return;
-    const el = pageRef.current.querySelector(`[data-cms="${cssEscape2(selection)}"]`);
-    if (!el) return;
+    const t = selNode?.type;
+    const editable = t === "text" || t === "heading" || t === "richtext";
+    if (!editing || !selection || !pageRef.current || !editable) return;
+    const wrapper = pageRef.current.querySelector(`[data-cms="${cssEscape2(selection)}"]`);
+    if (!wrapper) return;
+    const isRich = t === "richtext";
+    const el = (isRich ? wrapper.firstElementChild : wrapper) ?? wrapper;
     el.setAttribute("contenteditable", "true");
     el.style.outline = "none";
     el.focus();
-    const commit = () => ed.apply({ t: "set_props", id: selection, patch: { content: el.innerText } });
+    const commit = () => ed.apply({ t: "set_props", id: selection, patch: isRich ? { html: el.innerHTML } : { content: el.innerText } });
     el.addEventListener("blur", commit);
     return () => {
       el.removeEventListener("blur", commit);
@@ -1249,11 +1296,84 @@ function EditablePage({
       const order = keyBetween(siblings.length ? siblings[siblings.length - 1].order : null, null);
       const id = `n${doc2.seq + 1}-${Math.floor(performance.now())}`;
       const def = ADD_DEFAULTS[kind];
-      ed.apply({ t: "insert_node", node: { id, type: def.type, parent, order, props: { ...def.props }, style: { base: { ...def.style } } } });
+      ed.apply({ t: "insert_node", node: { id, type: def.type, parent, order, layout: def.layout, props: { ...def.props }, style: { base: { ...def.style } } } });
       ed.select(id);
     },
     [ed, selNode]
   );
+  react.useCallback(
+    (kind, targetId) => {
+      const doc2 = ed.state.doc;
+      const target = targetId ? doc2.nodes[targetId] : null;
+      const parent = target ? CONTAINER_TYPES2.has(target.type) ? target.id : target.parent : doc2.sections[doc2.sections.length - 1] ?? null;
+      const siblings = childrenOf(doc2, parent);
+      const order = keyBetween(siblings.length ? siblings[siblings.length - 1].order : null, null);
+      const id = `n${doc2.seq + 1}-${Math.floor(performance.now())}`;
+      const def = ADD_DEFAULTS[kind];
+      ed.apply({ t: "insert_node", node: { id, type: def.type, parent, order, layout: def.layout, props: { ...def.props }, style: { base: { ...def.style } } } });
+      ed.select(id);
+    },
+    [ed]
+  );
+  const [paletteOpen, setPaletteOpen] = react.useState(false);
+  const [draggingEl, setDraggingEl] = react.useState(false);
+  react.useEffect(() => {
+    if (!editing) {
+      setPaletteOpen(false);
+      return;
+    }
+    const onMove = (e) => {
+      if (draggingEl) return;
+      if (e.clientX >= window.innerWidth - 26) setPaletteOpen(true);
+      else if (e.clientX < window.innerWidth - 236) setPaletteOpen(false);
+    };
+    window.addEventListener("mousemove", onMove);
+    return () => window.removeEventListener("mousemove", onMove);
+  }, [editing, draggingEl]);
+  const [dropHint, setDropHint] = react.useState(null);
+  const computeDropTarget = (clientX, clientY) => {
+    const el = document.elementFromPoint(clientX, clientY)?.closest("[data-cms]");
+    if (!el) return { id: null, edge: "inside", rect: null };
+    const id = el.getAttribute("data-cms");
+    const node = ed.state.doc.nodes[id];
+    const r = el.getBoundingClientRect();
+    const rect = { x: r.left, y: r.top, w: r.width, h: r.height };
+    if (node && CONTAINER_TYPES2.has(node.type)) return { id, edge: "inside", rect };
+    return { id, edge: clientY < r.top + r.height / 2 ? "before" : "after", rect };
+  };
+  const onPageDragOver = (e) => {
+    e.preventDefault();
+    e.dataTransfer.dropEffect = "copy";
+    setDropHint(computeDropTarget(e.clientX, e.clientY));
+  };
+  const insertRelative = (kind, hint) => {
+    const doc2 = ed.state.doc;
+    let parent;
+    let order;
+    if (!hint.id || hint.edge === "inside") {
+      parent = hint.id ?? (doc2.sections[doc2.sections.length - 1] ?? null);
+      const sib = childrenOf(doc2, parent);
+      order = keyBetween(sib.length ? sib[sib.length - 1].order : null, null);
+    } else {
+      const target = doc2.nodes[hint.id];
+      parent = target.parent;
+      const sib = childrenOf(doc2, parent);
+      const idx = sib.findIndex((n) => n.id === hint.id);
+      order = hint.edge === "before" ? keyBetween(idx > 0 ? sib[idx - 1].order : null, target.order) : keyBetween(target.order, idx < sib.length - 1 ? sib[idx + 1].order : null);
+    }
+    const id = `n${doc2.seq + 1}-${Math.floor(performance.now())}`;
+    const def = ADD_DEFAULTS[kind];
+    ed.apply({ t: "insert_node", node: { id, type: def.type, parent, order, layout: def.layout, props: { ...def.props }, style: { base: { ...def.style } } } });
+    ed.select(id);
+  };
+  const onPageDrop = (e) => {
+    const kind = e.dataTransfer.getData("application/x-cms-element");
+    if (!kind) return;
+    e.preventDefault();
+    insertRelative(kind, computeDropTarget(e.clientX, e.clientY));
+    setDropHint(null);
+    setDraggingEl(false);
+  };
   const setStyle = (patch) => selection && ed.apply({ t: "set_style", id: selection, breakpoint: "base", patch });
   const setProps = (patch) => selection && ed.apply({ t: "set_props", id: selection, patch });
   const setLayout = (layout) => selection && ed.apply({ t: "set_layout", id: selection, layout });
@@ -1321,8 +1441,23 @@ function EditablePage({
     if (el) ed.select(el.getAttribute("data-cms"));
     else ed.select(null);
   };
-  const page = /* @__PURE__ */ jsxRuntime.jsx("div", { ref: pageRef, onClickCapture, onContextMenu: onContextMenuSelect, children: /* @__PURE__ */ jsxRuntime.jsx(CmsPage, { doc: ed.state.doc, registry }) });
-  const pageShell = pinned ? /* @__PURE__ */ jsxRuntime.jsx("div", { ref: spacerRef, style: { height: `${Math.max(1, frames) * 100}vh` }, children: /* @__PURE__ */ jsxRuntime.jsx("div", { style: { position: "sticky", top: 0, height: "100vh", overflow: "hidden" }, children: page }) }) : page;
+  const page = /* @__PURE__ */ jsxRuntime.jsx(
+    "div",
+    {
+      ref: pageRef,
+      onClickCapture,
+      onContextMenu: onContextMenuSelect,
+      onDragOver: editing ? onPageDragOver : void 0,
+      onDragLeave: editing ? () => setDropHint(null) : void 0,
+      onDrop: editing ? onPageDrop : void 0,
+      children: /* @__PURE__ */ jsxRuntime.jsx(CmsPage, { doc: ed.state.doc, registry, data })
+    }
+  );
+  const pageShell = pinned ? /* @__PURE__ */ jsxRuntime.jsx("div", { ref: spacerRef, style: { height: `${Math.max(1, frames) * 100}vh` }, children: /* @__PURE__ */ jsxRuntime.jsx("div", { style: { position: "sticky", top: 0, height: "100vh", overflow: "hidden" }, children: page }) }) : frames > 1 ? (
+    // Normal flow, but "expanded" — extra scroll length below the content so a
+    // page can be made longer than its content (the ＋ Frame control).
+    /* @__PURE__ */ jsxRuntime.jsx("div", { style: { minHeight: `${frames * 100}vh` }, children: page })
+  ) : page;
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { position: "relative" }, children: [
     editing ? /* @__PURE__ */ jsxRuntime.jsxs(reactFancy.ContextMenu, { children: [
       /* @__PURE__ */ jsxRuntime.jsx(reactFancy.ContextMenu.Trigger, { children: pageShell }),
@@ -1384,16 +1519,101 @@ function EditablePage({
         onAdd: addNode
       }
     ) : null,
+    editing && dropHint?.rect ? /* @__PURE__ */ jsxRuntime.jsx(DropIndicator, { hint: dropHint }) : null,
+    editing ? /* @__PURE__ */ jsxRuntime.jsx(ElementPalette, { open: paletteOpen, onDragChange: setDraggingEl }) : null,
     editing && timelineDock ? /* @__PURE__ */ jsxRuntime.jsx("div", { style: { position: "fixed", left: 0, right: 0, bottom: 0, zIndex: Z2 }, children: timelineDock }) : null
   ] });
 }
-var CONTAINER_TYPES2 = /* @__PURE__ */ new Set(["section", "frame", "stack", "grid", "shape"]);
+function DropIndicator({
+  hint
+}) {
+  const r = hint.rect;
+  if (!r) return null;
+  const color = "#ec4899";
+  if (hint.edge === "inside") {
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { style: { position: "fixed", left: r.x, top: r.y, width: r.w, height: r.h, outline: `2px dashed ${color}`, outlineOffset: -2, borderRadius: 6, pointerEvents: "none", zIndex: Z2 + 4 } });
+  }
+  const y = hint.edge === "before" ? r.y : r.y + r.h;
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { style: { position: "fixed", left: r.x, top: y - 1.5, width: r.w, height: 3, background: color, borderRadius: 2, boxShadow: "0 0 0 1px #fff", pointerEvents: "none", zIndex: Z2 + 4 } });
+}
+function ElementPalette({ open, onDragChange }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      style: {
+        position: "fixed",
+        top: 64,
+        bottom: 96,
+        right: 0,
+        width: 216,
+        transform: open ? "translateX(0)" : "translateX(100%)",
+        transition: "transform 0.18s ease",
+        background: "#0b1220",
+        color: "#e2e8f0",
+        borderLeft: "1px solid #1e293b",
+        borderTopLeftRadius: 12,
+        borderBottomLeftRadius: 12,
+        boxShadow: "-18px 0 48px -20px rgba(0,0,0,0.6)",
+        zIndex: Z2 + 2,
+        fontFamily: "system-ui, sans-serif",
+        padding: 12,
+        overflowY: "auto"
+      },
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("div", { style: { fontSize: 11, letterSpacing: "0.06em", textTransform: "uppercase", opacity: 0.5, marginBottom: 10 }, children: "Elements" }),
+        /* @__PURE__ */ jsxRuntime.jsx("div", { style: { display: "grid", gridTemplateColumns: "1fr 1fr", gap: 8 }, children: ADD_MENU.map((m) => /* @__PURE__ */ jsxRuntime.jsxs(
+          "div",
+          {
+            draggable: true,
+            onDragStart: (e) => {
+              e.dataTransfer.setData("application/x-cms-element", m.kind);
+              e.dataTransfer.effectAllowed = "copy";
+              onDragChange(true);
+            },
+            onDragEnd: () => onDragChange(false),
+            title: `Drag "${m.label}" onto the page`,
+            style: {
+              display: "flex",
+              flexDirection: "column",
+              alignItems: "center",
+              justifyContent: "center",
+              gap: 4,
+              height: 56,
+              borderRadius: 8,
+              background: "#0f172a",
+              border: "1px solid #1e293b",
+              cursor: "grab",
+              fontSize: 12,
+              userSelect: "none"
+            },
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsx("span", { style: { fontSize: 16, opacity: 0.7 }, children: "\uFF0B" }),
+              m.label
+            ]
+          },
+          m.kind
+        )) }),
+        /* @__PURE__ */ jsxRuntime.jsx("p", { style: { fontSize: 10.5, opacity: 0.45, marginTop: 12, lineHeight: 1.4 }, children: "Drag an Element onto the page. It drops into the container you release over." })
+      ]
+    }
+  );
+}
+var CONTAINER_TYPES2 = /* @__PURE__ */ new Set(["section", "frame", "stack", "grid", "shape", "card", "device", "repeater"]);
 var ADD_DEFAULTS = {
   text: { type: "text", props: { content: "New text" }, style: { color: "inherit" } },
   heading: { type: "heading", props: { content: "New heading" }, style: { fontSize: { value: 28, unit: "px" }, fontWeight: 700 } },
   button: { type: "button", props: { label: "Button", href: "#", variant: "primary" }, style: {} },
+  link: { type: "link", props: { content: "link text", href: "#" }, style: { color: "#7c3aed" } },
   image: { type: "image", props: { src: "", alt: "" }, style: {} },
-  box: { type: "frame", props: {}, style: { padding: { value: 16, unit: "px" } } }
+  box: { type: "frame", props: {}, style: { padding: { value: 16, unit: "px" } } },
+  stack: { type: "stack", props: {}, style: { gap: { value: 12, unit: "px" } }, layout: "stack" },
+  grid: { type: "grid", props: {}, style: { gap: { value: 12, unit: "px" } }, layout: "grid" },
+  card: { type: "card", props: {}, style: { padding: { value: 16, unit: "px" }, radius: { value: 12, unit: "px" }, border: "1px solid #e2e8f0" } },
+  callout: { type: "callout", props: { content: "Heads up \u2014 this is a callout.", variant: "info" }, style: {} },
+  divider: { type: "divider", props: {}, style: {} },
+  code: { type: "code", props: { content: "npm install @particle-academy/react-fancy", lang: "bash" }, style: {} },
+  richtext: { type: "richtext", props: { html: "<p>Rich <strong>text</strong> with <em>inline</em> formatting.</p>" }, style: {} },
+  repeater: { type: "repeater", props: { items: "" }, style: { gap: { value: 12, unit: "px" } }, layout: "stack" }
 };
 var GRIPS = [
   { key: "nw", north: true, west: true, cursor: "nwse-resize" },
@@ -1414,20 +1634,55 @@ function SelectionOverlay({
   onLive
 }) {
   const drag = react.useRef(null);
+  const targets = react.useRef({ vx: [], hy: [] });
+  const [guides, setGuides] = react.useState({ x: null, y: null });
   const apply = (t) => {
     const el = getEl();
     if (el) applyTransform(el, t);
   };
+  const snap = (cands, lines) => {
+    let best = { delta: 0, at: null, dist: SNAP + 1 };
+    for (const line of lines) {
+      for (const c of cands) {
+        const diff = line - c;
+        if (Math.abs(diff) < best.dist) best = { delta: diff, at: line, dist: Math.abs(diff) };
+      }
+    }
+    return best.dist <= SNAP ? { delta: best.delta, at: best.at } : { delta: 0, at: null };
+  };
   const startMove = (e) => {
     e.stopPropagation();
     e.preventDefault();
     e.currentTarget.setPointerCapture(e.pointerId);
     drag.current = { x: e.clientX, y: e.clientY, w: box.w, h: box.h, live: { ...base } };
+    const sel = getEl();
+    const vx = /* @__PURE__ */ new Set();
+    const hy = /* @__PURE__ */ new Set();
+    document.querySelectorAll("[data-cms]").forEach((el) => {
+      if (sel && (el === sel || sel.contains(el) || el.contains(sel))) return;
+      const r = el.getBoundingClientRect();
+      vx.add(r.left).add(r.left + r.width / 2).add(r.right);
+      hy.add(r.top).add(r.top + r.height / 2).add(r.bottom);
+    });
+    targets.current = { vx: [...vx], hy: [...hy] };
   };
   const moveMove = (e) => {
     const d = drag.current;
     if (!d) return;
-    d.live = { ...base, x: (base.x ?? 0) + (e.clientX - d.x), y: (base.y ?? 0) + (e.clientY - d.y) };
+    let dx = e.clientX - d.x;
+    let dy = e.clientY - d.y;
+    if (!e.altKey) {
+      const l = box.x + dx;
+      const t = box.y + dy;
+      const sx = snap([l, l + box.w / 2, l + box.w], targets.current.vx);
+      const sy = snap([t, t + box.h / 2, t + box.h], targets.current.hy);
+      dx += sx.delta;
+      dy += sy.delta;
+      setGuides({ x: sx.at, y: sy.at });
+    } else if (guides.x !== null || guides.y !== null) {
+      setGuides({ x: null, y: null });
+    }
+    d.live = { ...base, x: (base.x ?? 0) + dx, y: (base.y ?? 0) + dy };
     apply(d.live);
     onLive();
   };
@@ -1462,6 +1717,7 @@ function SelectionOverlay({
     const d = drag.current;
     if (d) onTransform(d.live);
     drag.current = null;
+    setGuides({ x: null, y: null });
   };
   const outline = {
     position: "fixed",
@@ -1491,6 +1747,8 @@ function SelectionOverlay({
     return { left: cx - 6, top: cy - 6, cursor: g.cursor };
   };
   return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    guides.x !== null ? /* @__PURE__ */ jsxRuntime.jsx("div", { style: { position: "fixed", left: guides.x, top: 0, bottom: 0, width: 1, background: "#ec4899", zIndex: Z2 + 3, pointerEvents: "none" } }) : null,
+    guides.y !== null ? /* @__PURE__ */ jsxRuntime.jsx("div", { style: { position: "fixed", top: guides.y, left: 0, right: 0, height: 1, background: "#ec4899", zIndex: Z2 + 3, pointerEvents: "none" } }) : null,
     /* @__PURE__ */ jsxRuntime.jsx("div", { style: outline }),
     movable ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
       /* @__PURE__ */ jsxRuntime.jsx(
@@ -1555,11 +1813,20 @@ function FloatingToolbar({
   ] });
 }
 var ADD_MENU = [
-  { kind: "text", label: "Text" },
   { kind: "heading", label: "Heading" },
+  { kind: "text", label: "Text" },
   { kind: "button", label: "Button" },
+  { kind: "link", label: "Link" },
   { kind: "image", label: "Image" },
-  { kind: "box", label: "Box" }
+  { kind: "card", label: "Card" },
+  { kind: "callout", label: "Callout" },
+  { kind: "stack", label: "Stack" },
+  { kind: "grid", label: "Grid" },
+  { kind: "box", label: "Box" },
+  { kind: "divider", label: "Divider" },
+  { kind: "code", label: "Code" },
+  { kind: "richtext", label: "Rich text" },
+  { kind: "repeater", label: "Repeater" }
 ];
 function EditBar({
   editing,
@@ -1577,7 +1844,7 @@ function EditBar({
     /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", style: { ...btn, background: editing ? "#8b5cf6" : "transparent" }, onClick: onToggle, children: editing ? "\u25CF Editing" : "Edit" }),
     editing ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
       /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { position: "relative" }, children: [
-        /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", style: { ...btn, background: open ? "#1e293b" : "transparent" }, onClick: () => setOpen((v) => !v), title: "Add an element", children: "\uFF0B Add \u25BE" }),
+        /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", style: { ...btn, background: open ? "#1e293b" : "transparent" }, onClick: () => setOpen((v) => !v), title: "Add an Element (or drag from the right-edge palette)", children: "\uFF0B Element \u25BE" }),
         open ? /* @__PURE__ */ jsxRuntime.jsx("div", { style: { position: "absolute", top: "calc(100% + 6px)", right: 0, background: "#0f172a", border: "1px solid #1e293b", borderRadius: 10, padding: 4, display: "flex", flexDirection: "column", minWidth: 132, boxShadow: "0 12px 32px -10px rgba(0,0,0,0.6)" }, children: ADD_MENU.map((m) => /* @__PURE__ */ jsxRuntime.jsx(
           "button",
           {
@@ -1615,7 +1882,7 @@ function EditMenuItems({
   return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
     editable ? /* @__PURE__ */ jsxRuntime.jsx(reactFancy.ContextMenu.Item, { onClick: onEditText, children: "Edit text" }) : null,
     /* @__PURE__ */ jsxRuntime.jsxs(reactFancy.ContextMenu.Sub, { children: [
-      /* @__PURE__ */ jsxRuntime.jsx(reactFancy.ContextMenu.SubTrigger, { children: isContainer ? "Add inside" : "Add" }),
+      /* @__PURE__ */ jsxRuntime.jsx(reactFancy.ContextMenu.SubTrigger, { children: isContainer ? "Add Element inside" : "Add Element" }),
       /* @__PURE__ */ jsxRuntime.jsx(reactFancy.ContextMenu.SubContent, { className: "!z-[2147483647]", children: ADD_MENU.map((m) => /* @__PURE__ */ jsxRuntime.jsx(reactFancy.ContextMenu.Item, { onClick: () => onAdd(m.kind), children: m.label }, m.kind)) })
     ] }),
     node ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [