@chuvenger/devdock 0.5.0 → 0.7.0

package/dist/react-router.cjs

@@ -3,6 +3,7 @@
 var react = require('react');
 var reactRouter = require('react-router');
 var reactDom = require('react-dom');
+var cn = require('cn');
 var jsxRuntime = require('react/jsx-runtime');
 
 // src/react/react-router.tsx
@@ -25,6 +26,188 @@ function matchHotkey(spec, e) {
   return e.key.toLowerCase() === key;
 }
 
+// src/core/theme.ts
+var partClass = {
+  root: "devdock-root",
+  button: "devdock-button",
+  dot: "devdock-dot",
+  buttonLabel: "devdock-button-label",
+  panel: "devdock-panel",
+  title: "devdock-title",
+  inputWrap: "devdock-input-wrap",
+  input: "devdock-input",
+  body: "devdock-body",
+  list: "devdock-list",
+  section: "devdock-section",
+  group: "devdock-group",
+  row: "devdock-row",
+  rowActive: "",
+  rowLabel: "devdock-row-label",
+  rowPath: "devdock-row-path",
+  check: "devdock-check",
+  empty: "devdock-empty",
+  viewLabel: "devdock-view-label",
+  view: "devdock-view"
+};
+var STYLE_MARKER = "data-devdock-styles";
+var FONT = "ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif";
+var BASE_CSS = `
+.devdock-root { font-family: var(--devdock-font, ${FONT}); }
+
+.devdock-button {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 8px 12px;
+  font-size: 12px;
+  font-weight: 700;
+  letter-spacing: 0.6px;
+  color: var(--devdock-button-fg, #fff);
+  background: var(--devdock-button-bg, #111317);
+  border: 1px solid var(--devdock-border, #2a2e37);
+  border-radius: 999px;
+  box-shadow: 0 4px 14px rgba(0, 0, 0, 0.35);
+  cursor: pointer;
+}
+.devdock-button:where([aria-expanded="true"]) {
+  background: var(--devdock-accent, #2563eb);
+}
+
+.devdock-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 999px;
+  background: var(--devdock-success, #22c55e);
+  display: inline-block;
+}
+
+.devdock-panel {
+  width: var(--devdock-width, 280px);
+  max-height: var(--devdock-max-height, 70vh);
+  display: flex;
+  flex-direction: column;
+  background: var(--devdock-bg, #16181d);
+  color: var(--devdock-fg, #e7e9ee);
+  border: 1px solid var(--devdock-border, #2a2e37);
+  border-radius: var(--devdock-radius, 12px);
+  box-shadow: var(--devdock-shadow, 0 12px 40px rgba(0, 0, 0, 0.45));
+  overflow: hidden;
+}
+
+.devdock-title {
+  padding: 10px 12px;
+  border-bottom: 1px solid var(--devdock-border, #2a2e37);
+  font-size: 12px;
+  font-weight: 600;
+  letter-spacing: 0.4px;
+  text-transform: uppercase;
+  color: var(--devdock-muted, #8b909c);
+}
+
+.devdock-input-wrap { padding: 8px; }
+
+.devdock-input {
+  width: 100%;
+  box-sizing: border-box;
+  padding: 8px 10px;
+  font-size: 13px;
+  color: var(--devdock-fg, #e7e9ee);
+  background: var(--devdock-input-bg, #0f1115);
+  border: 1px solid var(--devdock-border, #2a2e37);
+  border-radius: var(--devdock-radius-sm, 8px);
+  outline: none;
+}
+
+.devdock-body {
+  overflow-y: auto;
+  display: flex;
+  flex-direction: column;
+}
+
+.devdock-list { padding: 0 6px 8px; }
+
+.devdock-section { margin-top: 6px; }
+
+.devdock-group {
+  padding: 6px 8px 2px;
+  font-size: 10px;
+  font-weight: 700;
+  letter-spacing: 0.6px;
+  text-transform: uppercase;
+  color: var(--devdock-subtle, #6b7280);
+}
+
+.devdock-row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  width: 100%;
+  text-align: left;
+  padding: 8px 10px;
+  font-size: 13px;
+  color: var(--devdock-fg, #e7e9ee);
+  background: transparent;
+  border: none;
+  border-radius: var(--devdock-radius-sm, 8px);
+  cursor: pointer;
+}
+.devdock-row:where([data-active]) {
+  background: var(--devdock-accent, #2563eb);
+  color: var(--devdock-accent-fg, #e7e9ee);
+}
+
+.devdock-row-label {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.devdock-row-path {
+  font-size: 11px;
+  color: var(--devdock-subtle, #6b7280);
+  font-family: ui-monospace, SFMono-Regular, monospace;
+  flex-shrink: 0;
+}
+:where(.devdock-row[data-active]) .devdock-row-path {
+  /* Whatever colour the row ended up with, stepped back: currentColor in the
+     color property means the inherited one, so this tracks the row however it
+     was set - a token, a class of yours - instead of guessing at the accent. */
+  color: color-mix(in oklab, currentColor 75%, transparent);
+}
+
+.devdock-check {
+  flex-shrink: 0;
+  width: 12px;
+  text-align: center;
+  color: var(--devdock-success, #22c55e);
+}
+
+.devdock-empty {
+  padding: 12px;
+  font-size: 13px;
+  color: var(--devdock-subtle, #6b7280);
+}
+
+.devdock-view-label {
+  padding: 4px 8px 0;
+  font-size: 11px;
+  color: var(--devdock-muted, #8b909c);
+}
+
+.devdock-view { padding: 2px 8px 6px; }
+`;
+var DEFAULT_LAYER = "devdock";
+function dockStyles(layer) {
+  if (!layer) return BASE_CSS;
+  const block = `@layer ${layer} {${BASE_CSS}}
+`;
+  if (layer !== DEFAULT_LAYER) return block;
+  const order = `@layer theme, base, components, ${layer}, utilities;`;
+  return `${order}
+${block}`;
+}
+
 // src/core/dock.ts
 var viteDevFlag = () => {
   try {
@@ -55,33 +238,12 @@ var isDevHost = () => {
   if (!host) return true;
   return host === "localhost" || host.endsWith(".localhost") || host.endsWith(".local") || host === "::1" || host === "0.0.0.0" || isLocalIPv4(host);
 };
-function el(tag, styles, props) {
+function el(tag, props) {
   const node = document.createElement(tag);
-  if (styles) Object.assign(node.style, styles);
   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 }
-  );
-}
+var PARTS = Object.keys(partClass);
 function cornerStyle(position) {
   const gap = "16px";
   switch (position) {
@@ -104,7 +266,6 @@ function panelAnchor(position) {
     [isRight ? "right" : "left"]: "0"
   };
 }
-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) => {
@@ -121,96 +282,67 @@ function createDevDock(initial = {}) {
     } };
   }
   let opts = { ...initial };
+  const cls = (...parts) => cn.cn(parts.map((part) => [partClass[part], opts.classNames?.[part]]));
+  const classSig = () => PARTS.map((p) => cn.cn(opts.classNames?.[p])).join("\0");
   let open = false;
   let query = "";
   let active = 0;
   let mounted = false;
   const host = el("div");
   host.setAttribute("data-devdock", "");
-  const shadowMode = initial.shadow ?? true;
+  const shadowMode = initial.shadow ?? (initial.classNames ? "inherit" : 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", {
-    width: "280px",
-    maxHeight: "min(70vh, 480px)",
-    display: "flex",
-    flexDirection: "column",
-    background: "#16181d",
-    color: "#e7e9ee",
-    border: "1px solid #2a2e37",
-    borderRadius: "12px",
-    boxShadow: "0 12px 40px rgba(0,0,0,0.45)",
-    overflow: "hidden"
+  const baseStyle = el("style", {
+    textContent: dockStyles(initial.cssLayer ?? DEFAULT_LAYER)
   });
+  baseStyle.setAttribute(STYLE_MARKER, "");
+  if (shadowRoot) mountPoint.appendChild(baseStyle);
+  const styleSlot = shadowRoot && shadowMode === "inherit" ? el("div") : null;
+  if (styleSlot) {
+    styleSlot.style.display = "contents";
+    mountPoint.appendChild(styleSlot);
+  }
+  const root = el("div");
+  mountPoint.appendChild(root);
+  const panel = el("div");
   panel.setAttribute("role", "dialog");
-  const heading = el("div", {
-    padding: "10px 12px",
-    borderBottom: "1px solid #2a2e37",
-    fontSize: "12px",
-    fontWeight: "600",
-    letterSpacing: "0.4px",
-    textTransform: "uppercase",
-    color: "#8b909c"
-  });
-  const inputWrap = el("div", { padding: "8px" });
-  const input = el("input", {
-    width: "100%",
-    boxSizing: "border-box",
-    padding: "8px 10px",
-    fontSize: "13px",
-    color: "#e7e9ee",
-    background: "#0f1115",
-    border: "1px solid #2a2e37",
-    borderRadius: "8px",
-    outline: "none"
-  });
+  const heading = el("div");
+  const inputWrap = el("div");
+  const input = el("input");
   input.placeholder = "Filter\u2026";
   inputWrap.appendChild(input);
-  const list = el("div", { padding: "0 6px 8px" });
+  const list = el("div");
   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"
-  });
+  const body = el("div");
   body.append(viewsBefore, list, viewsAfter);
   panel.append(heading, inputWrap, body);
-  const button = el("button", {
-    display: "inline-flex",
-    alignItems: "center",
-    gap: "6px",
-    padding: "8px 12px",
-    fontSize: "12px",
-    fontWeight: "700",
-    letterSpacing: "0.6px",
-    color: "#fff",
-    background: "#111317",
-    border: "1px solid #2a2e37",
-    borderRadius: "999px",
-    boxShadow: "0 4px 14px rgba(0,0,0,0.35)",
-    cursor: "pointer"
-  });
+  const button = el("button");
   button.type = "button";
   button.setAttribute("aria-label", "Toggle dev menu");
-  const dot = el("span", {
-    width: "8px",
-    height: "8px",
-    borderRadius: "999px",
-    background: "#22c55e",
-    display: "inline-block"
-  });
+  const dot = el("span");
   const buttonLabel = el("span");
   button.append(dot, buttonLabel);
   root.appendChild(button);
+  const sectionHeading = (text) => el("div", { className: cls("group"), textContent: text });
+  const viewLabel = (text) => el("div", { className: cls("viewLabel"), textContent: text });
+  const paintClasses = () => {
+    root.className = cls("root");
+    button.className = cls("button");
+    dot.className = cls("dot");
+    buttonLabel.className = cls("buttonLabel");
+    panel.className = cls("panel");
+    heading.className = cls("title");
+    inputWrap.className = cls("inputWrap");
+    input.className = cls("input");
+    body.className = cls("body");
+    list.className = cls("list");
+  };
   const enabled = () => {
     const e = opts.enabled;
     if (typeof e === "function") return e();
@@ -294,9 +426,9 @@ function createDevDock(initial = {}) {
   const paintActive = () => {
     rows.forEach((row, idx) => {
       const isActive = idx === active;
-      row.node.style.background = isActive ? "#2563eb" : "transparent";
-      if (row.pathSpan)
-        row.pathSpan.style.color = isActive ? "#cfe0ff" : "#6b7280";
+      if (isActive) row.node.setAttribute("data-active", "");
+      else row.node.removeAttribute("data-active");
+      row.node.className = isActive ? cls("row", "rowActive") : cls("row");
     });
   };
   const setActive = (next, scroll = false) => {
@@ -308,7 +440,7 @@ function createDevDock(initial = {}) {
   const renderList = () => {
     const filtered = getFiltered();
     active = Math.min(active, Math.max(0, filtered.length - 1));
-    const sig = filtered.map(itemSig).join("\n");
+    const sig = [classSig(), ...filtered.map(itemSig)].join("\n");
     if (sig === rowsSig) {
       filtered.forEach((it, idx) => {
         const row = rows[idx];
@@ -324,11 +456,7 @@ function createDevDock(initial = {}) {
     list.replaceChildren();
     if (filtered.length === 0) {
       list.appendChild(
-        el(
-          "div",
-          { padding: "12px", fontSize: "13px", color: "#6b7280" },
-          { textContent: "Nothing here." }
-        )
+        el("div", { className: cls("empty"), textContent: "Nothing here." })
       );
       return;
     }
@@ -339,55 +467,26 @@ function createDevDock(initial = {}) {
       groups.set(it.group, arr);
     }
     for (const [groupName, groupItems] of groups) {
-      const section = el("div", { marginTop: "6px" });
+      const section = el("div", { className: cls("section") });
       section.appendChild(sectionHeading(groupName));
       for (const it of groupItems) {
         const idx = filtered.indexOf(it);
-        const row = el("button", {
-          display: "flex",
-          alignItems: "center",
-          justifyContent: "space-between",
-          gap: "8px",
-          width: "100%",
-          textAlign: "left",
-          padding: "8px 10px",
-          fontSize: "13px",
-          color: "#e7e9ee",
-          background: "transparent",
-          border: "none",
-          borderRadius: "8px",
-          cursor: "pointer"
-        });
+        const row = el("button", { className: cls("row") });
         row.type = "button";
-        const labelSpan = el("span", {
-          overflow: "hidden",
-          textOverflow: "ellipsis",
-          whiteSpace: "nowrap"
-        });
+        const labelSpan = el("span", { className: cls("rowLabel") });
         row.appendChild(labelSpan);
         let pathSpan = null;
         if (it.kind === "route" && it.route.path !== it.label) {
-          pathSpan = el(
-            "span",
-            {
-              fontSize: "11px",
-              color: "#6b7280",
-              fontFamily: "ui-monospace, SFMono-Regular, monospace",
-              flexShrink: "0"
-            },
-            { textContent: it.route.path }
-          );
+          pathSpan = el("span", {
+            className: cls("rowPath"),
+            textContent: it.route.path
+          });
           row.appendChild(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"
-          });
+          checkSpan = el("span", { className: cls("check") });
           row.appendChild(checkSpan);
         }
         const rec = { item: it, node: row, labelSpan, pathSpan, checkSpan };
@@ -416,11 +515,14 @@ function createDevDock(initial = {}) {
   };
   const renderViews = () => {
     const keyed = keyViews(opts.views ?? []);
-    const sig = keyed.map(
-      ({ view, key }) => [key, viewOrder(view), view.group ?? "", view.label ?? ""].join(
-        "\0"
+    const sig = [
+      classSig(),
+      ...keyed.map(
+        ({ view, key }) => [key, viewOrder(view), view.group ?? "", view.label ?? ""].join(
+          "\0"
+        )
       )
-    ).join("\n");
+    ].join("\n");
     if (sig === viewsSig) return;
     viewsSig = sig;
     const live = new Set(keyed.map(({ key }) => key));
@@ -448,7 +550,7 @@ function createDevDock(initial = {}) {
           });
       }
       for (const section of sections.values()) {
-        const wrap = el("div", { marginTop: "6px" });
+        const wrap = el("div", { className: cls("section") });
         if (section.heading) wrap.appendChild(sectionHeading(section.heading));
         for (const { view, key } of section.items) {
           if (view.group != null && view.label)
@@ -458,7 +560,7 @@ function createDevDock(initial = {}) {
             wrap.appendChild(existing.host);
             continue;
           }
-          const viewHost = el("div", { padding: "2px 8px 6px" });
+          const viewHost = el("div", { className: cls("view") });
           viewHost.setAttribute("data-devdock-view", view.id ?? "");
           wrap.appendChild(viewHost);
           pending.push({ view, key, host: viewHost });
@@ -485,7 +587,9 @@ function createDevDock(initial = {}) {
       }
     }
     const sheets = [
-      ...document.querySelectorAll('style, link[rel~="stylesheet" i]')
+      ...document.querySelectorAll(
+        `style:not([${STYLE_MARKER}]), link[rel~="stylesheet" i]`
+      )
     ];
     const sig = sheets.map((n) => `${n.tagName}\0${n.getAttribute("href") ?? n.textContent}`).join("\n");
     if (sig === clonesSig) return;
@@ -531,8 +635,8 @@ function createDevDock(initial = {}) {
     panel.setAttribute("aria-label", opts.title ?? "Dev Menu");
     Object.assign(panel.style, panelAnchor(position));
     buttonLabel.textContent = opts.label ?? "DEV";
-    button.style.background = open ? "#2563eb" : "#111317";
     button.setAttribute("aria-expanded", String(open));
+    paintClasses();
   };
   function setOpen(next) {
     if (open === next) return;
@@ -594,6 +698,8 @@ function createDevDock(initial = {}) {
   };
   const mount = () => {
     if (mounted) return;
+    if (!shadowRoot)
+      (document.head ?? document.documentElement).prepend(baseStyle);
     (opts.container ?? document.body).appendChild(host);
     addListeners();
     syncStyles();
@@ -604,6 +710,7 @@ function createDevDock(initial = {}) {
     if (!mounted) return;
     removeListeners();
     unwatchStyles();
+    if (!shadowRoot) baseStyle.remove();
     host.remove();
     mounted = false;
   };
@@ -735,23 +842,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]