@arbidocs/blocks 0.3.114 → 0.3.115

package/dist/index.d.cts

@@ -1113,6 +1113,12 @@ interface StudioPersistence {
      */
     savePublished: (arbi: Arbi | null, live: boolean, slug: string, data: unknown) => Promise<PersistVia>;
     loadPublished: <T>(arbi: Arbi | null, live: boolean, slug: string) => Promise<LoadResult<T>>;
+    /**
+     * Delete a slug's stored authoring + published pages (backend and localStorage
+     * mirror). Lets a page be reset to empty; also the deterministic-reset hook a
+     * test/demo needs, since backend content otherwise wins over a fresh seed.
+     */
+    deletePage: (arbi: Arbi | null, live: boolean, slug: string) => Promise<void>;
     saveTheme: (arbi: Arbi | null, live: boolean, theme: unknown) => Promise<PersistVia>;
     loadTheme: <T>(arbi: Arbi | null, live: boolean) => Promise<LoadResult<T>>;
 }
@@ -1174,6 +1180,13 @@ interface StudioEditorProps {
     live: boolean;
     initialSlug?: string;
     testIdPrefix?: string;
+    /**
+     * Install a DEV-only `window.__studioResetSlug(slug)` hook that clears a slug's
+     * stored page so a fresh seed governs the canvas. For tests/demos only — it can
+     * delete pages, so keep it off in production (pass `import.meta.env.DEV`). The
+     * package stays env-agnostic; the consumer owns the flag.
+     */
+    resetSeam?: boolean;
     /**
      * Optional sink for published image bytes. When omitted, publishing inlines
      * each asset as a `data:` URI (self-contained, no backend). Provide this to
@@ -1181,7 +1194,7 @@ interface StudioEditorProps {
      */
     publishAsset?: MaterializeOptions['publishAsset'];
 }
-declare function StudioEditor({ config, pages, persistence, themeBundle, defaultTheme, brandLabel, backHref, backLabel, live, initialSlug, testIdPrefix, publishAsset, }: StudioEditorProps): react.JSX.Element;
+declare function StudioEditor({ config, pages, persistence, themeBundle, defaultTheme, brandLabel, backHref, backLabel, live, initialSlug, testIdPrefix, publishAsset, resetSeam, }: StudioEditorProps): react.JSX.Element;
 
 interface PageRendererProps {
     config: Config;

package/dist/index.d.ts

@@ -1113,6 +1113,12 @@ interface StudioPersistence {
      */
     savePublished: (arbi: Arbi | null, live: boolean, slug: string, data: unknown) => Promise<PersistVia>;
     loadPublished: <T>(arbi: Arbi | null, live: boolean, slug: string) => Promise<LoadResult<T>>;
+    /**
+     * Delete a slug's stored authoring + published pages (backend and localStorage
+     * mirror). Lets a page be reset to empty; also the deterministic-reset hook a
+     * test/demo needs, since backend content otherwise wins over a fresh seed.
+     */
+    deletePage: (arbi: Arbi | null, live: boolean, slug: string) => Promise<void>;
     saveTheme: (arbi: Arbi | null, live: boolean, theme: unknown) => Promise<PersistVia>;
     loadTheme: <T>(arbi: Arbi | null, live: boolean) => Promise<LoadResult<T>>;
 }
@@ -1174,6 +1180,13 @@ interface StudioEditorProps {
     live: boolean;
     initialSlug?: string;
     testIdPrefix?: string;
+    /**
+     * Install a DEV-only `window.__studioResetSlug(slug)` hook that clears a slug's
+     * stored page so a fresh seed governs the canvas. For tests/demos only — it can
+     * delete pages, so keep it off in production (pass `import.meta.env.DEV`). The
+     * package stays env-agnostic; the consumer owns the flag.
+     */
+    resetSeam?: boolean;
     /**
      * Optional sink for published image bytes. When omitted, publishing inlines
      * each asset as a `data:` URI (self-contained, no backend). Provide this to
@@ -1181,7 +1194,7 @@ interface StudioEditorProps {
      */
     publishAsset?: MaterializeOptions['publishAsset'];
 }
-declare function StudioEditor({ config, pages, persistence, themeBundle, defaultTheme, brandLabel, backHref, backLabel, live, initialSlug, testIdPrefix, publishAsset, }: StudioEditorProps): react.JSX.Element;
+declare function StudioEditor({ config, pages, persistence, themeBundle, defaultTheme, brandLabel, backHref, backLabel, live, initialSlug, testIdPrefix, publishAsset, resetSeam, }: StudioEditorProps): react.JSX.Element;
 
 interface PageRendererProps {
     config: Config;

package/dist/index.js

@@ -2375,7 +2375,8 @@ function StudioEditor({
   live,
   initialSlug,
   testIdPrefix = "studio",
-  publishAsset
+  publishAsset,
+  resetSeam = false
 }) {
   const arbi = useArbi();
   const materialize = useMemo(
@@ -2406,6 +2407,14 @@ function StudioEditor({
       cancelled = true;
     };
   }, [slug, live]);
+  useEffect(() => {
+    if (!resetSeam) return;
+    const w = window;
+    w.__studioResetSlug = (s) => persistence.deletePage(arbi, live, s);
+    return () => {
+      delete w.__studioResetSlug;
+    };
+  }, [resetSeam, arbi, live, persistence]);
   const persist4 = useCallback(
     async (toSave) => {
       setSaving(true);
@@ -2691,6 +2700,26 @@ function createStudioPersistence(cfg) {
   function loadPublished(arbi, live, slug) {
     return readPage(arbi, live, publishedKey(slug), publishedFile(slug));
   }
+  async function deletePage(arbi, live, slug) {
+    try {
+      localStorage.removeItem(pageKey(slug));
+      localStorage.removeItem(publishedKey(slug));
+    } catch {
+    }
+    if (!canUseArbi(arbi, live)) return;
+    try {
+      await arbi.selectWorkspace(WORKSPACE_ID);
+      const docs = await arbi.documents.list();
+      const names = [pageFile(slug), publishedFile(slug)];
+      const ids = docs.filter(
+        (d) => (d.folder ?? "").includes(FOLDER) && names.some((n) => (d.file_name ?? "").endsWith(n))
+      ).map((d) => d.external_id);
+      if (ids.length) await arbi.documents.delete(ids);
+      console.info(`[studio] deleted ${ids.length} doc(s) for "${slug}" from ARBI`);
+    } catch (e) {
+      console.warn(`[studio] ARBI delete failed for "${slug}"`, e);
+    }
+  }
   async function saveTheme(arbi, live, theme) {
     try {
       localStorage.setItem(THEME_KEY, JSON.stringify(theme));
@@ -2727,7 +2756,7 @@ function createStudioPersistence(cfg) {
       return null;
     }
   }
-  return { savePage, loadPage, savePublished, loadPublished, saveTheme, loadTheme };
+  return { savePage, loadPage, savePublished, loadPublished, deletePage, saveTheme, loadTheme };
 }
 function AiTextField({
   value,
@@ -2967,7 +2996,7 @@ function ImageFieldControl({
               {
                 src: thumb,
                 alt: d.file_name ?? "",
-                className: "aspect-square w-full object-cover"
+                className: "aspect-square w-full bg-muted object-contain"
               }
             ) : /* @__PURE__ */ jsx("span", { className: "flex aspect-square w-full items-center justify-center bg-muted text-muted-foreground", children: /* @__PURE__ */ jsx(ImagePlus, { className: "size-4" }) })
           },