@ai-matrx/associations 0.11.4 → 0.12.1

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog — @ai-matrx/associations
 
+## 0.12.1
+
+Re-cut of 0.12.0 — same package source. The 0.12.0 tag was cut from a commit whose workspace
+lockfile did not match `shared/messaging/package.json` (ERR_PNPM_OUTDATED_LOCKFILE), so its
+publish could never install; an immutable tag cannot move, so the bytes ship as 0.12.1.
+No consumer action beyond 0.12.0's.
+
+## 0.12.0
+
+* `UniversalAssociationPicker`: an empty search box with no recents (favorites / last-viewed) now
+  **browses candidates across the offered tokens** instead of saying "No recent items" — it was a
+  screen that lied for an account with hundreds of records it had never opened. Results carry a
+  "Recent" or "Browse" label.
+* `UniversalAssociationPicker` takes `emptyQueryMode?: "recents" | "candidates"` (default
+  `"recents"`, which falls back as above).
+* `useUniversalEntitySearch` returns `source: "search" | "recents" | "candidates"` (new
+  `UniversalSearchSource` type); `isRecents` is unchanged in meaning.
+* A chip whose token has a `pickerOverrides` component (Files → the host's window) no longer
+  leaves the picker body blank: it says the window is open (or closed), offers "Bring window to
+  front" / "Reopen window", and "Back to search". Closing the override window keeps the chip
+  selected instead of silently dropping back to search.
+
+**Consumer action:** none required. Hosts whose override window renders attached state should
+read `AssociationPickerProps.attachedIds` (it has always been passed; matrx-frontend's file
+override did not read it until this release's adoption).
+
+## 0.11.5
+
+Automatic changed-only republish, cut by the release train while the 0.12.0 source below was
+already on `main` (a checkout sweep committed it before its own version bump) — so 0.11.5 DOES
+carry the 0.12.0 picker changes despite its auto text. Adopt 0.12.0.
+
 ## 0.11.4
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/{CommentThread-DDeqHgTk.d.cts → CommentThread-C78e8433.d.cts}

@@ -1634,6 +1634,12 @@ interface UniversalAssociationPickerProps {
     ownerId?: string | null;
     /** Org stamped onto rows created via the per-token "+ New" footer. */
     orgId?: string | null;
+    /**
+     * What an empty search box shows. `"recents"` (default) shows favorites and
+     * last-viewed records and falls back to browsing candidates when there are
+     * none; `"candidates"` always browses the available records.
+     */
+    emptyQueryMode?: "recents" | "candidates";
     className?: string;
 }
 declare function attachedKey(token: string, id: string): string;

package/dist/{CommentThread-DDeqHgTk.d.ts → CommentThread-C78e8433.d.ts}

@@ -1634,6 +1634,12 @@ interface UniversalAssociationPickerProps {
     ownerId?: string | null;
     /** Org stamped onto rows created via the per-token "+ New" footer. */
     orgId?: string | null;
+    /**
+     * What an empty search box shows. `"recents"` (default) shows favorites and
+     * last-viewed records and falls back to browsing candidates when there are
+     * none; `"candidates"` always browses the available records.
+     */
+    emptyQueryMode?: "recents" | "candidates";
     className?: string;
 }
 declare function attachedKey(token: string, id: string): string;

package/dist/react/index.cjs

@@ -1690,7 +1690,9 @@ function useUniversalEntitySearch(args) {
   const store = useAssociationsStore();
   const [results, setResults] = (0, import_react6.useState)([]);
   const [loading, setLoading] = (0, import_react6.useState)(false);
-  const [isRecents, setIsRecents] = (0, import_react6.useState)(true);
+  const [source, setSource] = (0, import_react6.useState)(
+    emptyQueryMode === "candidates" ? "candidates" : "recents"
+  );
   const runRef = (0, import_react6.useRef)(0);
   const tokensKey = (tokens ?? []).join(",");
   (0, import_react6.useEffect)(() => {
@@ -1701,25 +1703,36 @@ function useUniversalEntitySearch(args) {
       if (runRef.current !== run) return;
       setLoading(true);
       const activeTokens = tokensKey ? tokensKey.split(",") : store.registry.listableTokens();
+      const browse = () => store.candidates.searchCandidatesAcrossTokens({
+        tokens: activeTokens,
+        search: trimmed,
+        ownerId: ownerId ?? null,
+        perTokenLimit
+      });
       let next = [];
-      if (trimmed || emptyQueryMode === "candidates") {
-        next = await store.candidates.searchCandidatesAcrossTokens({
-          tokens: activeTokens,
-          search: trimmed,
-          ownerId: ownerId ?? null,
-          perTokenLimit
-        });
+      let nextSource;
+      if (trimmed) {
+        next = await browse();
+        nextSource = "search";
+      } else if (emptyQueryMode === "candidates") {
+        next = await browse();
+        nextSource = "candidates";
       } else {
         next = await loadRecents(store, activeTokens);
+        nextSource = "recents";
+        if (next.length === 0 && runRef.current === run) {
+          next = await browse();
+          nextSource = "candidates";
+        }
       }
       if (runRef.current !== run) return;
       setResults(next);
-      setIsRecents(!trimmed && emptyQueryMode === "recents");
+      setSource(nextSource);
       setLoading(false);
     }, DEBOUNCE_MS);
     return () => clearTimeout(timer);
   }, [query, tokensKey, ownerId, enabled, perTokenLimit, emptyQueryMode, store]);
-  return { results, loading, isRecents };
+  return { results, loading, isRecents: source === "recents", source };
 }
 async function loadRecents(store, tokens) {
   const res = await store.favorites.list();
@@ -2782,7 +2795,15 @@ function attachedKey(token, id) {
   return `${token}:${id}`;
 }
 function UniversalAssociationPicker(props) {
-  const { attachedKeys, onAttach, onDetach, ownerId, orgId, className } = props;
+  const {
+    attachedKeys,
+    onAttach,
+    onDetach,
+    ownerId,
+    orgId,
+    emptyQueryMode = "recents",
+    className
+  } = props;
   const store = useAssociationsStore();
   const { pickerOverrides } = useAssociationsUiPorts();
   const notifier = useNotifier();
@@ -2790,12 +2811,19 @@ function UniversalAssociationPicker(props) {
   const [query, setQuery] = (0, import_react14.useState)("");
   const [browseToken, setBrowseToken] = (0, import_react14.useState)(null);
   const [busyKey, setBusyKey] = (0, import_react14.useState)(null);
-  const { results, loading, isRecents } = useUniversalEntitySearch({
+  const [overrideOpen, setOverrideOpen] = (0, import_react14.useState)(false);
+  const [overrideMount, setOverrideMount] = (0, import_react14.useState)(0);
+  const { results, loading, source } = useUniversalEntitySearch({
     query,
     tokens,
     ownerId: ownerId ?? null,
-    enabled: browseToken === null
+    enabled: browseToken === null,
+    emptyQueryMode
   });
+  const selectToken = (next) => {
+    setBrowseToken(next);
+    setOverrideOpen(next !== null && Boolean(pickerOverrides?.[next]));
+  };
   const toggle = async (c) => {
     const key = attachedKey(c.token, c.id);
     if (busyKey) return;
@@ -2828,7 +2856,7 @@ function UniversalAssociationPicker(props) {
           value: query,
           onChange: (e) => {
             setQuery(e.target.value);
-            if (browseToken) setBrowseToken(null);
+            if (browseToken) selectToken(null);
           },
           placeholder: "Search everything\u2026",
           className: "pl-8 text-base",
@@ -2851,7 +2879,8 @@ function UniversalAssociationPicker(props) {
             "button",
             {
               type: "button",
-              onClick: () => setBrowseToken(active ? null : t),
+              "aria-pressed": active,
+              onClick: () => selectToken(active ? null : t),
               className: (0, import_design_system4.cn)(
                 "inline-flex shrink-0 items-center gap-1 rounded-md border px-1.5 py-0.5 text-[11px] transition-colors",
                 active ? "border-primary/50 bg-primary/10 text-foreground" : "border-border text-muted-foreground hover:text-foreground hover:bg-accent"
@@ -2869,20 +2898,62 @@ function UniversalAssociationPicker(props) {
     browseToken && BrowseOverride ? (
       // The token's canonical host picker (e.g. the stored-files browser)
       // owns per-token browsing when registered — never a plain list twin.
-      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
-        BrowseOverride,
+      // It opens in its own window; this body says where it went.
+      /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(
+        "div",
         {
-          open: true,
-          onOpenChange: (open) => {
-            if (!open) setBrowseToken(null);
-          },
-          token: browseToken,
-          orgId: orgId ?? null,
-          attachedIds: new Set(
-            [...attachedKeys].filter((k) => k.startsWith(`${browseToken}:`)).map((k) => k.slice(browseToken.length + 1))
-          ),
-          onAttach: (id, title) => onAttach(browseToken, id, title),
-          onDetach: (id) => onDetach(browseToken, id)
+          role: "region",
+          "aria-label": `${store.registry.getEntityInfo(browseToken).labelPlural} window`,
+          className: "flex flex-1 flex-col items-center justify-center gap-3 px-4 py-8 text-center",
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { className: "text-sm text-foreground", children: overrideOpen ? `The ${store.registry.getEntityInfo(browseToken).labelPlural.toLowerCase()} window is open.` : `The ${store.registry.getEntityInfo(browseToken).labelPlural.toLowerCase()} window is closed.` }),
+            /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { className: "max-w-xs text-[12px] text-muted-foreground", children: overrideOpen ? "Check items there to attach them; uncheck to detach. Changes save as you go." : "Reopen it to pick more, or go back to search everything." }),
+            /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { className: "flex flex-wrap items-center justify-center gap-2", children: [
+              /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(
+                import_design_system4.Button,
+                {
+                  type: "button",
+                  size: "sm",
+                  variant: overrideOpen ? "outline" : "default",
+                  onClick: () => {
+                    setOverrideOpen(true);
+                    setOverrideMount((n) => n + 1);
+                  },
+                  children: [
+                    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(MaximizeIcon, { className: "mr-1.5 h-3.5 w-3.5" }),
+                    overrideOpen ? "Bring window to front" : "Reopen window"
+                  ]
+                }
+              ),
+              /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+                import_design_system4.Button,
+                {
+                  type: "button",
+                  size: "sm",
+                  variant: "ghost",
+                  onClick: () => selectToken(null),
+                  children: "Back to search"
+                }
+              )
+            ] }),
+            overrideOpen && /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+              BrowseOverride,
+              {
+                open: true,
+                onOpenChange: (open) => {
+                  if (!open) setOverrideOpen(false);
+                },
+                token: browseToken,
+                orgId: orgId ?? null,
+                attachedIds: new Set(
+                  [...attachedKeys].filter((k) => k.startsWith(`${browseToken}:`)).map((k) => k.slice(browseToken.length + 1))
+                ),
+                onAttach: (id, title) => onAttach(browseToken, id, title),
+                onDetach: (id) => onDetach(browseToken, id)
+              },
+              overrideMount
+            )
+          ]
         }
       )
     ) : browseToken ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("div", { className: "flex min-h-0 flex-1 flex-col", children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
@@ -2891,7 +2962,7 @@ function UniversalAssociationPicker(props) {
         token: browseToken,
         enabled: true,
         orgId,
-        onClose: () => setBrowseToken(null),
+        onClose: () => selectToken(null),
         attachedIds: new Set(
           [...attachedKeys].filter((k) => k.startsWith(`${browseToken}:`)).map((k) => k.slice(browseToken.length + 1))
         ),
@@ -2904,8 +2975,8 @@ function UniversalAssociationPicker(props) {
         role: "region",
         "aria-label": "Association search results",
         className: "-mx-1 min-h-24 flex-1 overflow-y-auto overscroll-contain px-1",
-        children: results.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { className: "py-6 text-center text-[12px] text-muted-foreground", children: loading ? "Searching\u2026" : query.trim() ? "No matches \u2014 narrow with a type chip to browse." : "No recent items. Type to search, or pick a type to browse." }) : /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { className: "space-y-2", children: [
-          isRecents && /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { className: "px-1 text-[10px] font-medium uppercase tracking-wider text-muted-foreground/60", children: "Recent" }),
+        children: results.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { className: "py-6 text-center text-[12px] text-muted-foreground", children: loading ? "Searching\u2026" : query.trim() ? "No matches \u2014 narrow with a type chip to browse." : "Nothing to attach yet. Type to search, or pick a type to browse." }) : /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { className: "space-y-2", children: [
+          source !== "search" && /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { className: "px-1 text-[10px] font-medium uppercase tracking-wider text-muted-foreground/60", children: source === "recents" ? "Recent" : "Browse" }),
           [...groups.entries()].map(([token, items]) => {
             const info = store.registry.getEntityInfo(token);
             const GroupIcon = info.Icon ?? DefaultEntityIcon;