@juo/blocks 1.12.0-alpha.1 → 1.12.0-alpha.2

package/dist/core.js

@@ -1,9 +1,9 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { c as createContext, d, w, a as defineBlock, b as createBlockInstance, r as registerBlock, E, u } from "./block-Bh3z0B3y.js";
-import { B, C, e, S, _, f, g, h, i, j, k, l, m, n, o, p, q, s, t, v, x, y, z, A, D, F } from "./block-Bh3z0B3y.js";
-import { D as D2, T, a, W, c, b, d as d2, e as e2, g as g2, h as h2, i as i2 } from "./juo-workflow-D3c29mxb.js";
+import { e as createContext, d, k as w, l as defineBlock, g as createBlockInstance, h as getDefinedBlocks, r as registerBlock, E, u } from "./block-B6s9jL7l.js";
+import { B, m, p, S, q, _, t, b, v, f, x, y, z, A, D, i, F, a, o, G, j, H, s, n, w as w2 } from "./block-B6s9jL7l.js";
+import { D as D2, a as a2, T, W, c, b as b2, d as d2, e, g, h, i as i2 } from "./juo-workflow-DY4rd256.js";
 import { reportBlockWarning, reportBlockError } from "./observability.js";
 function createState() {
   const discountCode = d(null);
@@ -105,6 +105,7 @@ function defineOverlayWrapper(opts) {
   const layout = opts.layout ?? "sidebar";
   const canAbort = opts.canAbort ?? true;
   return defineBlock(opts.name, {
+    displayName: opts.title,
     group: "internal",
     schema: OVERLAY_WRAPPER_SCHEMA,
     initialValue: () => ({
@@ -116,6 +117,67 @@ function defineOverlayWrapper(opts) {
     renderer: () => null
   });
 }
+const OVERLAY_PREFIX$1 = "overlay:";
+function callInitialValue(block) {
+  if (typeof block.initialValue !== "function") return block.initialValue;
+  try {
+    return block.initialValue();
+  } catch (error) {
+    console.warn(
+      `[overlays] initialValue() threw for "${block.name}"; its content block will not be hidden from the palette.`,
+      error
+    );
+    return void 0;
+  }
+}
+function buildOverlayRegistry(blocks) {
+  var _a, _b;
+  const registry = {};
+  for (const block of blocks) {
+    if (!block.name.startsWith(OVERLAY_PREFIX$1)) continue;
+    const id = block.name.slice(OVERLAY_PREFIX$1.length);
+    const initial = callInitialValue(block);
+    const first = (_b = (_a = initial == null ? void 0 : initial.slots) == null ? void 0 : _a.content) == null ? void 0 : _b[0];
+    const contentBlock = typeof (first == null ? void 0 : first.type) === "string" ? first.type : "";
+    registry[id] = {
+      block: block.name,
+      title: block.displayName ?? id,
+      contentBlock
+    };
+  }
+  return registry;
+}
+const OVERLAY_PREFIX = "overlay:";
+const OverlayServiceContext = createContext("services/overlay");
+function createOverlayService(themeState, options = {}) {
+  const getBlocks = options.getBlocks ?? getDefinedBlocks;
+  const current = w(() => {
+    const root = themeState.overlay.blocks.value[0];
+    const type = root == null ? void 0 : root.type;
+    if (typeof type !== "string" || !type.startsWith(OVERLAY_PREFIX)) {
+      return null;
+    }
+    const props = root.props ?? {};
+    return {
+      name: type,
+      // Defaults mirror defineOverlayWrapper's seeding in overlay-wrapper.ts — keep in sync.
+      layout: props.layout ?? "sidebar",
+      canAbort: Boolean(props.canAbort ?? true)
+    };
+  });
+  return {
+    getEditableOverlays() {
+      return buildOverlayRegistry(getBlocks());
+    },
+    open(name, params) {
+      void themeState.resolve("overlay", name, params);
+    },
+    close() {
+      themeState.overlay.blocks.value = [];
+    },
+    current
+  };
+}
 function isLocalhostOrigin(origin) {
   try {
     const url = new URL(origin);
@@ -231,8 +293,8 @@ function createApiCustomerAdapter(fetcher) {
           _tag: "Success",
           data: { id: data.id, name, email: data.email }
         };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     }
   };
@@ -320,8 +382,8 @@ function createApiLoginAdapter(fetcher, opts) {
           lang
         );
         return { _tag: "Success", data: void 0 };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async authenticate(params) {
@@ -355,8 +417,8 @@ function createApiLoginAdapter(fetcher, opts) {
           throw new Error(`Unexpected response: ${res.statusText}`);
         }
         return { _tag: "Success", data: await res.json() };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     getAuthorizeUrl({ connection, state, shop }) {
@@ -1305,7 +1367,7 @@ function createMockSchedulesAdapter() {
     },
     async removeAdjustment({ adjustmentId }) {
       await new Promise((r) => setTimeout(r, 200));
-      adjustments = adjustments.filter((a2) => a2.id !== adjustmentId);
+      adjustments = adjustments.filter((a3) => a3.id !== adjustmentId);
       return { _tag: "Success", data: void 0 };
     }
   };
@@ -1320,8 +1382,8 @@ function createApiSchedulesAdapter(fetcher) {
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         const data = await res.json();
         return { _tag: "Success", data: data.orders };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async getAdjustments() {
@@ -1329,15 +1391,15 @@ function createApiSchedulesAdapter(fetcher) {
         const res = await fetcher(`/customer/v1/schedules/adjustments`);
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         const data = await res.json();
-        const adjustments = data.data.map((a2) => ({
-          id: a2.id,
-          subscriptionId: a2.subscriptionId ?? "",
-          type: a2.type === "CHANGE_DATE" ? "date_change" : "skip",
-          newDate: a2.newDate
+        const adjustments = data.data.map((a3) => ({
+          id: a3.id,
+          subscriptionId: a3.subscriptionId ?? "",
+          type: a3.type === "CHANGE_DATE" ? "date_change" : "skip",
+          newDate: a3.newDate
         }));
         return { _tag: "Success", data: adjustments };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async skipOrder({ cycle, date }) {
@@ -1356,8 +1418,8 @@ function createApiSchedulesAdapter(fetcher) {
         });
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         return { _tag: "Success", data: void 0 };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async changeDateAdjustment({ newDate, currentDate }) {
@@ -1382,8 +1444,8 @@ function createApiSchedulesAdapter(fetcher) {
         });
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         return { _tag: "Success", data: void 0 };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async removeAdjustment({ adjustmentId }) {
@@ -1394,8 +1456,8 @@ function createApiSchedulesAdapter(fetcher) {
         );
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         return { _tag: "Success", data: void 0 };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     }
   };
@@ -1976,7 +2038,7 @@ function createApiSubscriptionAdapter(fetcher) {
       try {
         const params = new URLSearchParams();
         if ((_a = options == null ? void 0 : options.filters) == null ? void 0 : _a.length) {
-          const q2 = options.filters.filter((f2) => Object.keys(f2).length > 0).flatMap((f2) => Object.entries(f2).filter(([, v2]) => Boolean(v2))).map(([k2, v2]) => `${k2}:'${v2}'`).join(" AND ");
+          const q2 = options.filters.filter((f2) => Object.keys(f2).length > 0).flatMap((f2) => Object.entries(f2).filter(([, v2]) => Boolean(v2))).map(([k, v2]) => `${k}:'${v2}'`).join(" AND ");
           if (q2) params.set("query", q2);
         }
         if (options == null ? void 0 : options.pagination) {
@@ -2001,8 +2063,8 @@ function createApiSubscriptionAdapter(fetcher) {
             }
           }
         };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async getById(id) {
@@ -2014,8 +2076,8 @@ function createApiSubscriptionAdapter(fetcher) {
         const body = await res.json();
         const raw = body.data[0];
         return { _tag: "Success", data: raw ? mapSubscription(raw) : null };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async addItem({ subscriptionId, item }) {
@@ -2030,8 +2092,8 @@ function createApiSubscriptionAdapter(fetcher) {
         );
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         return { _tag: "Success", data: void 0 };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async removeItem({ subscriptionId, itemId }) {
@@ -2042,8 +2104,8 @@ function createApiSubscriptionAdapter(fetcher) {
         );
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         return { _tag: "Success", data: void 0 };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async updateItem({ subscriptionId, lineId, update }) {
@@ -2064,8 +2126,8 @@ function createApiSubscriptionAdapter(fetcher) {
         );
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         return { _tag: "Success", data: void 0 };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async skipLineItem({ subscriptionId, lineId, nextBillingDate }) {
@@ -2080,8 +2142,8 @@ function createApiSubscriptionAdapter(fetcher) {
         );
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         return { _tag: "Success", data: void 0 };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async updateBoxItems({ subscriptionId, parentId, items, shippingMethodHandle }) {
@@ -2096,8 +2158,8 @@ function createApiSubscriptionAdapter(fetcher) {
         );
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         return { _tag: "Success", data: void 0 };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async addDiscount({ subscriptionId, code }) {
@@ -2112,8 +2174,8 @@ function createApiSubscriptionAdapter(fetcher) {
         );
         if (!res.ok) return { _tag: "Failure", error: { kind: "NETWORK", message: `HTTP ${res.status}` } };
         return { _tag: "Success", data: void 0 };
-      } catch (e3) {
-        return { _tag: "Failure", error: { kind: "UNKNOWN", message: e3 instanceof Error ? e3.message : void 0 } };
+      } catch (e2) {
+        return { _tag: "Failure", error: { kind: "UNKNOWN", message: e2 instanceof Error ? e2.message : void 0 } };
       }
     },
     async removeDiscount({ subscriptionId, discountId }) {
@@ -2124,8 +2186,8 @@ function createApiSubscriptionAdapter(fetcher) {
         );
         if (!res.ok) return { _tag: "Failure", error: { kind: "NETWORK", message: `HTTP ${res.status}` } };
         return { _tag: "Success", data: void 0 };
-      } catch (e3) {
-        return { _tag: "Failure", error: { kind: "UNKNOWN", message: e3 instanceof Error ? e3.message : void 0 } };
+      } catch (e2) {
+        return { _tag: "Failure", error: { kind: "UNKNOWN", message: e2 instanceof Error ? e2.message : void 0 } };
       }
     },
     // Uses PATCH /customer/v1/subscriptions/{id} — the dedicated /reschedule route does not exist.
@@ -2142,8 +2204,8 @@ function createApiSubscriptionAdapter(fetcher) {
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         const data = await res.json();
         return { _tag: "Success", data: mapSubscription(data) };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async resume({ subscriptionId }) {
@@ -2155,8 +2217,8 @@ function createApiSubscriptionAdapter(fetcher) {
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         const data = await res.json();
         return { _tag: "Success", data: mapSubscription(data) };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async pause({ subscriptionId }) {
@@ -2168,8 +2230,8 @@ function createApiSubscriptionAdapter(fetcher) {
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         const data = await res.json();
         return { _tag: "Success", data: mapSubscription(data) };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async reactivate({ subscriptionId }) {
@@ -2181,8 +2243,8 @@ function createApiSubscriptionAdapter(fetcher) {
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         const data = await res.json();
         return { _tag: "Success", data: mapSubscription(data) };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     async cancel({ subscriptionId, reason }) {
@@ -2198,8 +2260,8 @@ function createApiSubscriptionAdapter(fetcher) {
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         const data = await res.json();
         return { _tag: "Success", data: mapSubscription(data) };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     // Legacy endpoint — no /customer/v1/subscriptions/{id}/plans exists yet.
@@ -2211,8 +2273,8 @@ function createApiSubscriptionAdapter(fetcher) {
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         const data = await res.json();
         return { _tag: "Success", data };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     // Legacy endpoint — no /customer/v1 equivalent exists yet.
@@ -2224,8 +2286,8 @@ function createApiSubscriptionAdapter(fetcher) {
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         const data = await res.json();
         return { _tag: "Success", data: (data == null ? void 0 : data.id) ?? null };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     // Legacy endpoint — no /customer/v1/subscriptions/{id}/upsells exists yet.
@@ -2252,8 +2314,8 @@ function createApiSubscriptionAdapter(fetcher) {
           };
         });
         return { _tag: "Success", data: products };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     // Legacy endpoint — no /customer/v1/subscriptions/{id}/upsells POST exists yet.
@@ -2273,8 +2335,8 @@ function createApiSubscriptionAdapter(fetcher) {
         );
         if (!res.ok) return { _tag: "Failure", error: `HTTP ${res.status}` };
         return { _tag: "Success", data: void 0 };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     // Legacy endpoint — no /customer/v1 equivalent exists yet.
@@ -2290,8 +2352,8 @@ function createApiSubscriptionAdapter(fetcher) {
           _tag: "Success",
           data: { id: data.id, createdAt: data.createdAt }
         };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     // Legacy endpoints, split by stage (see SubscriptionService.renewNow docs):
@@ -2311,8 +2373,8 @@ function createApiSubscriptionAdapter(fetcher) {
             result: (body == null ? void 0 : body.result) ?? "success"
           }
         };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     },
     // Legacy endpoint — POST /plan returns 204; re-fetch to return the updated subscription.
@@ -2334,8 +2396,8 @@ function createApiSubscriptionAdapter(fetcher) {
           _tag: "Failure",
           error: "Subscription not found after frequency change"
         };
-      } catch (e3) {
-        return { _tag: "Failure", error: e3 };
+      } catch (e2) {
+        return { _tag: "Failure", error: e2 };
       }
     }
   };
@@ -2398,6 +2460,14 @@ function createSubscriptionService(adapter) {
     itemsChangedAt,
     lastOrder,
     search: adapter.search,
+    // Prefer the adapter's rich cross-subscription list (legacy endpoint, active-first).
+    // Fall back to a single `search` page for adapters that don't implement it
+    // (e.g. the editor mock) so the cross-subscription views still render.
+    listAll: adapter.listAll ? adapter.listAll.bind(adapter) : async () => {
+      const result = await adapter.search();
+      if (result._tag !== "Success") return result;
+      return { _tag: "Success", data: result.data.items };
+    },
     getById: adapter.getById,
     getCurrentSubscriptionId,
     addItem: async (subscriptionId, item) => {
@@ -2746,13 +2816,14 @@ export {
   AuthenticationError,
   AuthenticationErrorReason,
   B as BlockWrapperEvent,
-  C as ContextProvideEvent,
-  e as ContextRequestEvent,
+  m as ContextProvideEvent,
+  p as ContextRequestEvent,
   CustomerServiceContext,
   D2 as DEFAULT_GLOBAL_STYLES,
   DISCOUNT_REJECTION_REASONS,
   LoginServiceContext,
   OrdersServiceContext,
+  OverlayServiceContext,
   ProductServiceContext,
   RouterServiceContext,
   SchedulesServiceContext,
@@ -2762,13 +2833,13 @@ export {
   u as Signal,
   StateContext,
   SubscriptionServiceContext,
-  T as ThemeStateContext,
-  a as TranslationContext,
+  a2 as ThemeStateContext,
+  T as TranslationContext,
   W as WorkflowServiceContext,
-  _ as __recordDevtoolsInstance,
-  f as __recordDevtoolsPropSetter,
-  g as attachEmptyTracking,
-  h as backfillInstanceDefaults,
+  q as __recordDevtoolsInstance,
+  _ as __recordDevtoolsPropSetter,
+  t as attachEmptyTracking,
+  b as backfillInstanceDefaults,
   w as computed,
   createApiCustomerAdapter,
   createApiLoginAdapter,
@@ -2776,9 +2847,9 @@ export {
   createApiSchedulesAdapter,
   createApiSubscriptionAdapter,
   createBlockInstance,
-  i as createBlockInstanceFromJSON,
-  j as createBlockInstanceFromObject,
-  k as createCeRenderer,
+  v as createBlockInstanceFromJSON,
+  f as createBlockInstanceFromObject,
+  x as createCeRenderer,
   createContext,
   createCustomerService,
   createLoginService,
@@ -2791,41 +2862,42 @@ export {
   createMockSubscriptionAdapter,
   createMockWorkflowApiAdapter,
   createOrdersService,
+  createOverlayService,
   createProductService,
   createRouterService,
   createSchedulesService,
-  l as createSelectedBlock,
+  y as createSelectedBlock,
   createSettingsService,
   createShopService,
   createState,
   createSubscriptionService,
   c as createThemeState,
-  b as createTranslationService,
+  b2 as createTranslationService,
   d2 as createWorkflowApiAdapter,
-  e2 as createWorkflowService,
+  e as createWorkflowService,
   defineBlock,
-  m as defineBlockRuntime,
+  z as defineBlockRuntime,
   defineOverlayWrapper,
   E as effect,
-  g2 as getDefaultBlockForAction,
-  n as getDefinedBlocks,
-  o as getDevtoolsBlockState,
-  h2 as hasDefaultBlockForAction,
-  p as hasRenderedContent,
+  g as getDefaultBlockForAction,
+  getDefinedBlocks,
+  A as getDevtoolsBlockState,
+  h as hasDefaultBlockForAction,
+  D as hasRenderedContent,
   i2 as indexOverrides,
-  q as injectContext,
-  s as isEditorPreview,
-  t as isStubDefinition,
+  i as injectContext,
+  F as isEditorPreview,
+  a as isStubDefinition,
   loadBlockRegistry,
   loginService,
-  v as onRegisterBlock,
-  x as provideContext,
+  o as onRegisterBlock,
+  G as provideContext,
   registerBlock,
-  y as serializeBlocks,
-  z as setDevtoolsBlockProp,
+  j as serializeBlocks,
+  H as setDevtoolsBlockProp,
   d as signal,
-  A as subscribeContext,
-  D as untracked,
+  s as subscribeContext,
+  n as untracked,
   waitForDevBlocksUrl,
-  F as withWrapper
+  w2 as withWrapper
 };

package/dist/devtools/env.d.ts

@@ -0,0 +1,3 @@
+export declare const target: typeof globalThis;
+export declare const isBrowser: boolean;
+//# sourceMappingURL=env.d.ts.map

package/dist/devtools/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/devtools/env.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,EAMJ,OAAO,UAAU,CAAC;AAEjC,eAAO,MAAM,SAAS,SAAgC,CAAC"}

package/dist/devtools/hook.d.ts

@@ -0,0 +1,35 @@
+import { DevtoolsEvent, DevtoolsEventKind, PropsSchema } from './protocol';
+/**
+ * The page-side resolver surface the framework (`blocks/core`) publishes on the
+ * hook so a backend running in a *separate bundle* (e.g. an injected extension
+ * script) can read/write live block state without importing `@juo/blocks`.
+ * Tree + picker are NOT here — the backend derives them from the DOM.
+ */
+export interface DevtoolsResolverSurface {
+    getBlockState(id: string): {
+        props: Record<string, unknown>;
+        propsSchema: PropsSchema;
+    } | null;
+    setBlockProp(id: string, key: string, value: unknown): {
+        props: Record<string, unknown>;
+    } | null;
+    /** Registry name → editor display label (displayName ?? name). */
+    getBlockCatalog(): Record<string, string>;
+}
+export interface JuoBlocksDevtoolsHook {
+    readonly version: number;
+    emit(kind: DevtoolsEventKind, payload: Record<string, unknown>): void;
+    on(cb: (e: DevtoolsEvent) => void): () => void;
+    off(cb: (e: DevtoolsEvent) => void): void;
+    /** Attached by `blocks/core` on first lifecycle emit; undefined until then. */
+    resolvers?: DevtoolsResolverSurface;
+}
+declare global {
+    var __JUO_BLOCKS_DEVTOOLS_HOOK__: JuoBlocksDevtoolsHook | undefined;
+}
+export declare function createHook(): JuoBlocksDevtoolsHook;
+/** Installs (idempotently) and returns the global hook. */
+export declare function installHook(): JuoBlocksDevtoolsHook;
+/** Returns the global hook if a shell has installed one, else undefined. */
+export declare function getHook(): JuoBlocksDevtoolsHook | undefined;
+//# sourceMappingURL=hook.d.ts.map

package/dist/devtools/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/devtools/hook.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AAIpB;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG;QACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,WAAW,EAAE,WAAW,CAAC;KAC1B,GAAG,IAAI,CAAC;IACT,YAAY,CACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb;QACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,GAAG,IAAI,CAAC;IACT,kEAAkE;IAClE,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC/C,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1C,+EAA+E;IAC/E,SAAS,CAAC,EAAE,uBAAuB,CAAC;CACrC;AAED,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,4BAA4B,EAAE,qBAAqB,GAAG,SAAS,CAAC;CACrE;AAED,wBAAgB,UAAU,IAAI,qBAAqB,CAqBlD;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,IAAI,qBAAqB,CAEnD;AAED,4EAA4E;AAC5E,wBAAgB,OAAO,IAAI,qBAAqB,GAAG,SAAS,CAE3D"}

package/dist/devtools/index.d.ts

@@ -0,0 +1,4 @@
+export * from './env';
+export * from './protocol';
+export * from './hook';
+//# sourceMappingURL=index.d.ts.map

package/dist/devtools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/devtools/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC"}