@chuvenger/devdock 0.4.1 → 0.6.0

package/dist/react-router.cjs

@@ -2,6 +2,7 @@
 
 var react = require('react');
 var reactRouter = require('react-router');
+var reactDom = require('react-dom');
 var jsxRuntime = require('react/jsx-runtime');
 
 // src/react/react-router.tsx
@@ -60,6 +61,27 @@ function el(tag, styles, props) {
   if (props) Object.assign(node, props);
   return node;
 }
+function sectionHeading(text) {
+  return el(
+    "div",
+    {
+      padding: "6px 8px 2px",
+      fontSize: "10px",
+      fontWeight: "700",
+      letterSpacing: "0.6px",
+      textTransform: "uppercase",
+      color: "#6b7280"
+    },
+    { textContent: text }
+  );
+}
+function viewLabel(text) {
+  return el(
+    "div",
+    { padding: "4px 8px 0", fontSize: "11px", color: "#8b909c" },
+    { textContent: text }
+  );
+}
 function cornerStyle(position) {
   const gap = "16px";
   switch (position) {
@@ -83,6 +105,15 @@ function panelAnchor(position) {
   };
 }
 var FONT = "ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif";
+function keyViews(views) {
+  const used = /* @__PURE__ */ new Set();
+  return views.map((view, i) => {
+    let key = view.id ?? `#${i}`;
+    while (used.has(key)) key = `${key}#${i}`;
+    used.add(key);
+    return { view, key };
+  });
+}
 function createDevDock(initial = {}) {
   if (typeof document === "undefined") {
     return { update() {
@@ -96,9 +127,12 @@ function createDevDock(initial = {}) {
   let mounted = false;
   const host = el("div");
   host.setAttribute("data-devdock", "");
-  const useShadow = (initial.shadow ?? true) && typeof host.attachShadow === "function";
+  const shadowMode = initial.shadow ?? true;
+  const useShadow = shadowMode !== false && typeof host.attachShadow === "function";
   const shadowRoot = useShadow ? host.attachShadow({ mode: "open" }) : null;
   const mountPoint = shadowRoot ?? host;
+  const styleSlot = shadowRoot && shadowMode === "inherit" ? el("div", { display: "contents" }) : null;
+  if (styleSlot) mountPoint.appendChild(styleSlot);
   const root = el("div", { fontFamily: FONT });
   mountPoint.appendChild(root);
   const panel = el("div", {
@@ -137,8 +171,19 @@ function createDevDock(initial = {}) {
   });
   input.placeholder = "Filter\u2026";
   inputWrap.appendChild(input);
-  const list = el("div", { overflowY: "auto", padding: "0 6px 8px" });
-  panel.append(heading, inputWrap, list);
+  const list = el("div", { padding: "0 6px 8px" });
+  list.setAttribute("data-devdock-list", "");
+  const viewsBefore = el("div");
+  viewsBefore.setAttribute("data-devdock-views", "before");
+  const viewsAfter = el("div");
+  viewsAfter.setAttribute("data-devdock-views", "after");
+  const body = el("div", {
+    overflowY: "auto",
+    display: "flex",
+    flexDirection: "column"
+  });
+  body.append(viewsBefore, list, viewsAfter);
+  panel.append(heading, inputWrap, body);
   const button = el("button", {
     display: "inline-flex",
     alignItems: "center",
@@ -179,20 +224,35 @@ function createDevDock(initial = {}) {
   const buildItems = () => {
     const out = [];
     (opts.routes ?? []).forEach((r, i) => {
+      const key = `route:${r.path}:${i}`;
+      const label = r.label ?? r.path;
       out.push({
         kind: "route",
-        key: `route:${r.path}:${i}`,
-        label: r.label ?? r.path,
+        key,
+        label,
         group: r.group ?? "Routes",
+        sig: [key, r.group ?? "Routes", label, r.path].join("\0"),
         route: r
       });
     });
     (opts.commands ?? []).forEach((c, i) => {
+      const live = typeof c.label === "function";
+      const label = typeof c.label === "function" ? c.label() : c.label;
+      const checked = c.checked ? c.checked() === true : null;
+      const key = `cmd:${c.id ?? (live ? "" : label)}:${i}`;
+      const group = c.group ?? "Commands";
       out.push({
         kind: "command",
-        key: `cmd:${c.id ?? c.label}:${i}`,
-        label: c.label,
-        group: c.group ?? "Commands",
+        key,
+        label,
+        group,
+        sig: [
+          key,
+          group,
+          live ? "\0live" : label,
+          checked === null ? "" : "\0checkable"
+        ].join("\0"),
+        checked,
         command: c
       });
     });
@@ -220,9 +280,17 @@ function createDevDock(initial = {}) {
   };
   let rows = [];
   let rowsSig = null;
-  const itemSig = (it) => [it.key, it.group, it.label, it.kind === "route" ? it.route.path : ""].join(
-    "\0"
-  );
+  const itemSig = (it) => it.sig;
+  const paintRow = (row) => {
+    const it = row.item;
+    if (row.labelSpan.textContent !== it.label)
+      row.labelSpan.textContent = it.label;
+    if (row.checkSpan && it.kind === "command") {
+      const on = it.checked === true;
+      row.checkSpan.textContent = on ? "\u2713" : "";
+      row.node.setAttribute("aria-checked", String(on));
+    }
+  };
   const paintActive = () => {
     rows.forEach((row, idx) => {
       const isActive = idx === active;
@@ -244,7 +312,9 @@ function createDevDock(initial = {}) {
     if (sig === rowsSig) {
       filtered.forEach((it, idx) => {
         const row = rows[idx];
-        if (row) row.item = it;
+        if (!row) return;
+        row.item = it;
+        paintRow(row);
       });
       paintActive();
       return;
@@ -270,20 +340,7 @@ function createDevDock(initial = {}) {
     }
     for (const [groupName, groupItems] of groups) {
       const section = el("div", { marginTop: "6px" });
-      section.appendChild(
-        el(
-          "div",
-          {
-            padding: "6px 8px 2px",
-            fontSize: "10px",
-            fontWeight: "700",
-            letterSpacing: "0.6px",
-            textTransform: "uppercase",
-            color: "#6b7280"
-          },
-          { textContent: groupName }
-        )
-      );
+      section.appendChild(sectionHeading(groupName));
       for (const it of groupItems) {
         const idx = filtered.indexOf(it);
         const row = el("button", {
@@ -302,15 +359,11 @@ function createDevDock(initial = {}) {
           cursor: "pointer"
         });
         row.type = "button";
-        const labelSpan = el(
-          "span",
-          {
-            overflow: "hidden",
-            textOverflow: "ellipsis",
-            whiteSpace: "nowrap"
-          },
-          { textContent: it.label }
-        );
+        const labelSpan = el("span", {
+          overflow: "hidden",
+          textOverflow: "ellipsis",
+          whiteSpace: "nowrap"
+        });
         row.appendChild(labelSpan);
         let pathSpan = null;
         if (it.kind === "route" && it.route.path !== it.label) {
@@ -326,8 +379,20 @@ function createDevDock(initial = {}) {
           );
           row.appendChild(pathSpan);
         }
-        const rec = { item: it, node: row, pathSpan };
+        let checkSpan = null;
+        if (it.kind === "command" && it.checked !== null) {
+          row.setAttribute("role", "checkbox");
+          checkSpan = el("span", {
+            flexShrink: "0",
+            width: "12px",
+            textAlign: "center",
+            color: "#22c55e"
+          });
+          row.appendChild(checkSpan);
+        }
+        const rec = { item: it, node: row, labelSpan, pathSpan, checkSpan };
         rows[idx] = rec;
+        paintRow(rec);
         row.addEventListener("mouseenter", () => setActive(idx));
         row.addEventListener("click", () => void runItem(rec.item));
         section.appendChild(row);
@@ -336,6 +401,120 @@ function createDevDock(initial = {}) {
     }
     paintActive();
   };
+  const mountedViews = /* @__PURE__ */ new Map();
+  let viewsSig = null;
+  const viewOrder = (v) => v.order === "after" ? "after" : "before";
+  const unmountViews = () => {
+    for (const mv of mountedViews.values()) {
+      mv.teardown?.();
+      mv.host.remove();
+    }
+    mountedViews.clear();
+    viewsBefore.replaceChildren();
+    viewsAfter.replaceChildren();
+    viewsSig = null;
+  };
+  const renderViews = () => {
+    const keyed = keyViews(opts.views ?? []);
+    const sig = keyed.map(
+      ({ view, key }) => [key, viewOrder(view), view.group ?? "", view.label ?? ""].join(
+        "\0"
+      )
+    ).join("\n");
+    if (sig === viewsSig) return;
+    viewsSig = sig;
+    const live = new Set(keyed.map(({ key }) => key));
+    for (const [key, mv] of mountedViews) {
+      if (live.has(key)) continue;
+      mv.teardown?.();
+      mv.host.remove();
+      mountedViews.delete(key);
+    }
+    viewsBefore.replaceChildren();
+    viewsAfter.replaceChildren();
+    const pending = [];
+    for (const placement of ["before", "after"]) {
+      const container = placement === "before" ? viewsBefore : viewsAfter;
+      const here = keyed.filter(({ view }) => viewOrder(view) === placement);
+      const sections = /* @__PURE__ */ new Map();
+      for (const entry of here) {
+        const groupKey = entry.view.group ?? `\0${entry.key}`;
+        const section = sections.get(groupKey);
+        if (section) section.items.push(entry);
+        else
+          sections.set(groupKey, {
+            heading: entry.view.group ?? entry.view.label,
+            items: [entry]
+          });
+      }
+      for (const section of sections.values()) {
+        const wrap = el("div", { marginTop: "6px" });
+        if (section.heading) wrap.appendChild(sectionHeading(section.heading));
+        for (const { view, key } of section.items) {
+          if (view.group != null && view.label)
+            wrap.appendChild(viewLabel(view.label));
+          const existing = mountedViews.get(key);
+          if (existing) {
+            wrap.appendChild(existing.host);
+            continue;
+          }
+          const viewHost = el("div", { padding: "2px 8px 6px" });
+          viewHost.setAttribute("data-devdock-view", view.id ?? "");
+          wrap.appendChild(viewHost);
+          pending.push({ view, key, host: viewHost });
+        }
+        container.appendChild(wrap);
+      }
+    }
+    for (const { view, key, host: viewHost } of pending) {
+      const mv = { host: viewHost };
+      mountedViews.set(key, mv);
+      const teardown = view.mount(viewHost);
+      if (typeof teardown === "function") mv.teardown = teardown;
+    }
+  };
+  let clonesSig = null;
+  const syncStyles = () => {
+    if (!styleSlot || !shadowRoot) return;
+    const adopted = document.adoptedStyleSheets;
+    if (Array.isArray(adopted)) {
+      try {
+        const sr = shadowRoot;
+        sr.adoptedStyleSheets = [...adopted];
+      } catch {
+      }
+    }
+    const sheets = [
+      ...document.querySelectorAll('style, link[rel~="stylesheet" i]')
+    ];
+    const sig = sheets.map((n) => `${n.tagName}\0${n.getAttribute("href") ?? n.textContent}`).join("\n");
+    if (sig === clonesSig) return;
+    clonesSig = sig;
+    styleSlot.replaceChildren(...sheets.map((n) => n.cloneNode(true)));
+  };
+  let styleObserver = null;
+  let syncQueued = false;
+  const watchStyles = () => {
+    if (!styleSlot || styleObserver || !document.head || typeof MutationObserver === "undefined")
+      return;
+    styleObserver = new MutationObserver(() => {
+      if (syncQueued) return;
+      syncQueued = true;
+      queueMicrotask(() => {
+        syncQueued = false;
+        syncStyles();
+      });
+    });
+    styleObserver.observe(document.head, {
+      childList: true,
+      subtree: true,
+      characterData: true
+    });
+  };
+  const unwatchStyles = () => {
+    styleObserver?.disconnect();
+    styleObserver = null;
+  };
   const renderShell = () => {
     const position = opts.position ?? "bottom-right";
     const zIndex = opts.zIndex ?? 2147483e3;
@@ -365,9 +544,12 @@ function createDevDock(initial = {}) {
       panel.isConnected || root.insertBefore(panel, button);
       renderShell();
       renderList();
+      syncStyles();
+      renderViews();
       requestAnimationFrame(() => input.focus());
-    } else if (panel.isConnected) {
-      panel.remove();
+    } else {
+      unmountViews();
+      if (panel.isConnected) panel.remove();
     }
     renderShell();
   }
@@ -414,11 +596,14 @@ function createDevDock(initial = {}) {
     if (mounted) return;
     (opts.container ?? document.body).appendChild(host);
     addListeners();
+    syncStyles();
+    watchStyles();
     mounted = true;
   };
   const unmount = () => {
     if (!mounted) return;
     removeListeners();
+    unwatchStyles();
     host.remove();
     mounted = false;
   };
@@ -430,7 +615,10 @@ function createDevDock(initial = {}) {
       if (enabled()) {
         mount();
         renderShell();
-        if (open) renderList();
+        if (open) {
+          renderList();
+          renderViews();
+        }
       } else {
         setOpen(false);
         unmount();
@@ -442,24 +630,56 @@ function createDevDock(initial = {}) {
     }
   };
 }
-
-// src/react/DevDock.tsx
-function DevDock(props) {
+var NO_VIEWS = [];
+function DevDock({ views = NO_VIEWS, ...options }) {
   const instance = react.useRef(null);
-  const latest = react.useRef(props);
-  latest.current = props;
+  const [hosts, setHosts] = react.useState(
+    () => /* @__PURE__ */ new Map()
+  );
+  const alive = react.useRef(true);
+  const keyed = react.useMemo(() => keyViews(views), [views]);
+  const coreViews = react.useMemo(
+    () => keyed.map(({ key, view }) => ({
+      id: key,
+      label: view.label,
+      group: view.group,
+      order: view.order,
+      mount: (host) => {
+        setHosts((prev) => new Map(prev).set(key, host));
+        return () => {
+          if (!alive.current) return;
+          setHosts((prev) => {
+            const next = new Map(prev);
+            next.delete(key);
+            return next;
+          });
+        };
+      }
+    })),
+    [keyed]
+  );
+  const latest = react.useRef({ options, coreViews });
+  latest.current = { options, coreViews };
   react.useEffect(() => {
-    const inst = createDevDock(latest.current);
+    alive.current = true;
+    const inst = createDevDock({
+      ...latest.current.options,
+      views: latest.current.coreViews
+    });
     instance.current = inst;
     return () => {
+      alive.current = false;
       inst.destroy();
       instance.current = null;
     };
   }, []);
   react.useEffect(() => {
-    instance.current?.update(props);
+    instance.current?.update({ ...options, views: coreViews });
   });
-  return null;
+  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: keyed.map(({ key, view }) => {
+    const host = hosts.get(key);
+    return host ? reactDom.createPortal(view.render(), host, key) : null;
+  }) });
 }
 
 // src/core/match.ts
@@ -515,23 +735,116 @@ function walk(routes, parent, staticRoutes, inherited) {
   }
   return out;
 }
+var NO_ROUTES = [];
+var NO_HANDLES = /* @__PURE__ */ new Map();
+function lazyHandleOf(route) {
+  const lazy = route.lazy;
+  if (typeof lazy === "function") return async () => (await lazy())?.handle;
+  return typeof lazy?.handle === "function" ? lazy.handle : void 0;
+}
+async function readLazyHandle(route) {
+  try {
+    return await lazyHandleOf(route)?.();
+  } catch {
+    return void 0;
+  }
+}
+function collectLazy(routes, out = []) {
+  for (const r of routes) {
+    if (r.handle == null && lazyHandleOf(r) != null) out.push(r);
+    if (r.children?.length) collectLazy(r.children, out);
+  }
+  return out;
+}
+function signature(routes, out = []) {
+  for (const r of routes) {
+    const h = r.handle;
+    out.push(
+      `${r.path ?? ""}|${r.index ? 1 : 0}|${h?.dev}|${h?.devLabel}|${h?.devGroup}|${h?.hidden}|${lazyHandleOf(r) ? 1 : 0}`
+    );
+    if (r.children?.length) signature(r.children, out);
+  }
+  return out;
+}
+function useRouteTree(router) {
+  const routes = router?.routes ?? NO_ROUTES;
+  const [sig, setSig] = react.useState(() => signature(routes).join("\n"));
+  react.useEffect(() => {
+    if (!router?.subscribe) return;
+    const check = () => {
+      const next = signature(router.routes ?? NO_ROUTES).join("\n");
+      setSig((prev) => prev === next ? prev : next);
+    };
+    check();
+    return router.subscribe(check);
+  }, [router]);
+  return [routes, sig];
+}
+function useLazyHandles(routes, sig, enabled) {
+  const [handles, setHandles] = react.useState(NO_HANDLES);
+  const started = react.useRef(
+    /* @__PURE__ */ new WeakMap()
+  );
+  react.useEffect(() => {
+    if (!enabled) return;
+    const targets = collectLazy(routes);
+    if (targets.length === 0) return;
+    let cancelled = false;
+    void Promise.all(
+      targets.map((route) => {
+        let pending = started.current.get(route);
+        if (!pending) {
+          pending = readLazyHandle(route);
+          started.current.set(route, pending);
+        }
+        return pending.then((handle) => [route, handle]);
+      })
+    ).then((resolved) => {
+      if (cancelled) return;
+      const found = resolved.filter(
+        (entry) => entry[1] != null
+      );
+      setHandles(
+        (prev) => found.some(([route, handle]) => prev.get(route) !== handle) ? new Map([...prev, ...found]) : prev
+      );
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [routes, sig, enabled]);
+  return handles;
+}
+function mergeHandles(routes, handles) {
+  let changed = false;
+  const merged = routes.map((r) => {
+    const handle = r.handle ?? handles.get(r);
+    const children = r.children ? mergeHandles(r.children, handles) : r.children;
+    if (handle === r.handle && children === r.children) return r;
+    changed = true;
+    return { ...r, handle, children };
+  });
+  return changed ? merged : routes;
+}
 function useDetectedRoutes(options = {}) {
   const opts = isMatcher(options) ? { match: options } : options;
-  const { match, staticRoutes } = opts;
+  const { match, staticRoutes, loadHandles } = opts;
   const ctx = react.useContext(reactRouter.UNSAFE_DataRouterContext);
-  const routes = ctx?.router?.routes ?? [];
+  const [routes, sig] = useRouteTree(ctx?.router);
+  const handles = useLazyHandles(routes, sig, loadHandles === true);
   return react.useMemo(() => {
-    const deduped = dedupeByPath(flattenRoutes(routes, "", { staticRoutes }));
+    const tree = handles.size > 0 ? mergeHandles(routes, handles) : routes;
+    const deduped = dedupeByPath(flattenRoutes(tree, "", { staticRoutes }));
     return match ? deduped.filter(toPredicate(match)) : deduped;
-  }, [routes, match, staticRoutes]);
+  }, [routes, sig, handles, match, staticRoutes]);
 }
 function ReactRouterDevDock({
   match,
   staticRoutes,
+  loadHandles,
   ...props
 }) {
   const navigate = reactRouter.useNavigate();
-  const detected = useDetectedRoutes({ match, staticRoutes });
+  const detected = useDetectedRoutes({ match, staticRoutes, loadHandles });
   const routes = react.useMemo(
     () => [...detected, ...props.routes ?? []],
     [detected, props.routes]