@timeax/form-palette 0.0.30 → 0.0.31

package/dist/extra.mjs

@@ -216,19 +216,139 @@ function mapOptions(rawList, mapping, ctx) {
 }
 
 // src/presets/lister/engine/search.ts
-function optionText(o3) {
-  var _a;
-  const l2 = o3.label;
-  if (typeof l2 === "string") return l2;
-  if (typeof l2 === "number") return String(l2);
-  const rl = (_a = o3.raw) == null ? void 0 : _a.label;
-  if (typeof rl === "string") return rl;
-  return String(o3.value);
-}
-function filterOptionsLocal(options, query) {
+function getPath2(obj, path) {
+  if (!obj || !path) return void 0;
+  if (!path.includes(".")) return obj[path];
+  let cur = obj;
+  for (const part of path.split(".")) {
+    if (cur == null) return void 0;
+    cur = cur[part];
+  }
+  return cur;
+}
+function toText(v2) {
+  if (v2 == null) return "";
+  if (typeof v2 === "string") return v2;
+  if (typeof v2 === "number" || typeof v2 === "boolean") return String(v2);
+  return "";
+}
+function collectAllText(obj, out, depth = 2, budget = { n: 80 }) {
+  if (obj == null || budget.n <= 0) return;
+  const t4 = typeof obj;
+  if (t4 === "string" || t4 === "number" || t4 === "boolean") {
+    out.push(String(obj));
+    budget.n -= 1;
+    return;
+  }
+  if (depth <= 0) return;
+  if (Array.isArray(obj)) {
+    for (const x2 of obj) collectAllText(x2, out, depth - 1, budget);
+    return;
+  }
+  if (t4 === "object") {
+    for (const k2 of Object.keys(obj)) {
+      collectAllText(obj[k2], out, depth - 1, budget);
+      if (budget.n <= 0) break;
+    }
+  }
+}
+function matchQueryInText(q2, text) {
+  if (!q2) return true;
+  return text.toLowerCase().includes(q2);
+}
+function buildSearchTextForKeys(raw, keys) {
+  const parts = [];
+  for (const k2 of keys) {
+    const key = String(k2);
+    const v2 = getPath2(raw, key);
+    if (v2 == null) continue;
+    if (Array.isArray(v2)) {
+      for (const x2 of v2) {
+        const s4 = toText(x2);
+        if (s4) parts.push(s4);
+      }
+      continue;
+    }
+    const s3 = toText(v2);
+    if (s3) parts.push(s3);
+  }
+  return parts.join(" ");
+}
+function matchesSearch(raw, q2, search) {
+  if (!q2) return true;
+  if (search == null ? void 0 : search.searchAll) {
+    return matchQueryInText(q2, buildSearchTextAll(raw));
+  }
+  if (Array.isArray(search == null ? void 0 : search.searchOnly) && search.searchOnly.length) {
+    return matchQueryInText(
+      q2,
+      buildSearchTextForKeys(raw, search.searchOnly)
+    );
+  }
+  if (typeof (search == null ? void 0 : search.subject) === "string" && search.subject) {
+    return matchQueryInText(
+      q2,
+      buildSearchTextForKeys(raw, [search.subject])
+    );
+  }
+  return matchQueryInText(q2, buildSearchTextAll(raw));
+}
+function buildSearchTextAll(raw) {
+  const parts = [];
+  collectAllText(raw, parts, 2);
+  return parts.join(" ");
+}
+function isEmptyFilterValue(v2) {
+  if (v2 === void 0 || v2 === null) return true;
+  if (typeof v2 === "string" && v2.trim() === "") return true;
+  return Array.isArray(v2) && v2.length === 0;
+}
+function matchesFilters(raw, filters) {
+  if (!filters) return true;
+  for (const key of Object.keys(filters)) {
+    if (key === "search" || key === "subject" || key === "searchAll" || key === "searchOnly") {
+      continue;
+    }
+    const fv = filters[key];
+    if (isEmptyFilterValue(fv)) continue;
+    const rv = getPath2(raw, key);
+    if (Array.isArray(fv)) {
+      if (Array.isArray(rv)) {
+        const ok = rv.some((x2) => fv.includes(x2));
+        if (!ok) return false;
+      } else {
+        if (!fv.includes(rv)) return false;
+      }
+      continue;
+    }
+    if (Array.isArray(rv)) {
+      if (!rv.includes(fv)) return false;
+      continue;
+    }
+    if (String(rv) !== String(fv)) return false;
+  }
+  return true;
+}
+function filterRawListLocal(rawList, query, search, filters, opts) {
+  let list = Array.isArray(rawList) ? rawList : [];
+  const ctx = { query, search, filters };
+  const filtersLocal = (opts == null ? void 0 : opts.filtersSpec) && opts.filtersSpec.local;
+  if (typeof filtersLocal === "function") {
+    const out = filtersLocal(list, ctx);
+    if (Array.isArray(out)) list = out;
+  } else {
+    list = list.filter(
+      (r5) => matchesFilters(r5, filters)
+    );
+  }
   const q2 = (query != null ? query : "").trim().toLowerCase();
-  if (!q2) return options;
-  return options.filter((o3) => optionText(o3).toLowerCase().includes(q2));
+  if (!q2) return list;
+  const searchLocal = (opts == null ? void 0 : opts.searchSpec) && opts.searchSpec.local;
+  if (typeof searchLocal === "function") {
+    const out = searchLocal(list, ctx);
+    if (Array.isArray(out)) return out;
+  }
+  return list.filter((r5) => matchesSearch(r5, q2, search));
 }
 
 // src/presets/lister/engine/selection.ts
@@ -390,7 +510,8 @@ function initialSessionState(sessionId) {
     filtersPatch: {},
     effectiveFilters: void 0,
     // IMPORTANT: these are now OPTION IDS (not db values)
-    selectedFilterValues: []
+    selectedFilterValues: [],
+    searchPayload: void 0
   };
 }
 function buildSearchPayloadFromTarget(target) {
@@ -402,7 +523,7 @@ function buildSearchPayloadFromTarget(target) {
     return subject ? { subject } : void 0;
   }
   if (target.mode === "only") {
-    const only = Array.isArray(target.only) ? target.only.filter(Boolean) : void 0;
+    const only = Array.isArray(target.only) ? target.only.filter((v2) => v2 !== null && v2 !== void 0) : void 0;
     return only && only.length ? { searchOnly: only } : void 0;
   }
   return void 0;
@@ -659,16 +780,15 @@ function ListerProvider(props) {
   );
   const fetchAndHydrate = React.useCallback(
     async (id, reason, override) => {
-      var _a2, _b2, _c2, _d, _e, _f, _g, _h;
+      var _a2, _b2, _c2, _d, _e, _f, _g;
       const s0 = getSession(id);
       if (!(s0 == null ? void 0 : s0.definition)) return;
       const myReq = ((_a2 = reqIdBySessionRef.current[id]) != null ? _a2 : 0) + 1;
       reqIdBySessionRef.current[id] = myReq;
       const query = (_b2 = override == null ? void 0 : override.query) != null ? _b2 : s0.query;
       const filters = (_d = (_c2 = override == null ? void 0 : override.filters) != null ? _c2 : s0.effectiveFilters) != null ? _d : s0.filters;
-      const search = (_f = override == null ? void 0 : override.search) != null ? _f : buildSearchPayloadFromTarget(
-        (_e = getSession(id)) == null ? void 0 : _e.searchTarget
-      );
+      const hasSearchOverride = !!override && Object.prototype.hasOwnProperty.call(override, "search");
+      const search = hasSearchOverride ? override.search : (_e = s0.searchPayload) != null ? _e : buildSearchPayloadFromTarget(s0.searchTarget);
       patchSession(id, {
         errorCode: void 0,
         loading: reason !== "refresh",
@@ -701,7 +821,7 @@ function ListerProvider(props) {
           details: {
             sessionId: id,
             kind: s3 == null ? void 0 : s3.kind,
-            endpoint: (_h = (_g = s3 == null ? void 0 : s3.definition) == null ? void 0 : _g.source) == null ? void 0 : _h.endpoint,
+            endpoint: (_g = (_f = s3 == null ? void 0 : s3.definition) == null ? void 0 : _f.source) == null ? void 0 : _g.endpoint,
             query,
             filters,
             search
@@ -755,7 +875,7 @@ function ListerProvider(props) {
             nextPatch,
             spec
           );
-          shouldFetch = (spec == null ? void 0 : spec.autoFetch) !== false;
+          shouldFetch = (spec == null ? void 0 : spec.autoFetch) !== false && s4.searchMode !== "local";
           return {
             ...s4,
             filtersPatch: nextPatch,
@@ -844,7 +964,7 @@ function ListerProvider(props) {
   );
   const apiOpenAny = React.useCallback(
     async (kindOrDef, filters, opts) => {
-      var _a2, _b2, _c2, _d, _e, _f, _g, _h, _i;
+      var _a2, _b2, _c2, _d, _e, _f, _g, _h, _i, _j, _k, _l;
       const mode = (_a2 = opts == null ? void 0 : opts.mode) != null ? _a2 : "single";
       try {
         const def = typeof kindOrDef === "string" ? getPreset(kindOrDef) : kindOrDef;
@@ -867,7 +987,8 @@ function ListerProvider(props) {
         const pos = anchorToPos(opts == null ? void 0 : opts.anchor);
         const filtersSpec = (_d = opts == null ? void 0 : opts.filtersSpec) != null ? _d : prev == null ? void 0 : prev.filtersSpec;
         const filtersPatch = (_e = prev == null ? void 0 : prev.filtersPatch) != null ? _e : {};
-        const selectedFilterValues = (_f = prev == null ? void 0 : prev.selectedFilterValues) != null ? _f : [];
+        const resolvedSearchMode = (_g = (_f = opts == null ? void 0 : opts.searchMode) != null ? _f : prev == null ? void 0 : prev.searchMode) != null ? _g : "remote";
+        const selectedFilterValues = (_h = prev == null ? void 0 : prev.selectedFilterValues) != null ? _h : [];
         const effectiveFilters = computeEffectiveFilters(
           filters,
           filtersPatch,
@@ -875,10 +996,10 @@ function ListerProvider(props) {
         );
         const searchSpec = def == null ? void 0 : def.search;
         const defaultCol = searchSpec == null ? void 0 : searchSpec.default;
-        const defaultSearchTarget = defaultCol ? { mode: "subject", subject: defaultCol, only: null } : void 0;
-        const searchTarget = (_g = prev == null ? void 0 : prev.searchTarget) != null ? _g : defaultSearchTarget;
-        const initialQuery = (_i = (_h = opts == null ? void 0 : opts.initialQuery) != null ? _h : prev == null ? void 0 : prev.query) != null ? _i : "";
-        const searchPayload = buildSearchPayloadFromTarget(searchTarget);
+        const defaultSearchTarget2 = defaultCol ? { mode: "subject", subject: defaultCol, only: null } : void 0;
+        const searchTarget = (_i = prev == null ? void 0 : prev.searchTarget) != null ? _i : defaultSearchTarget2;
+        const initialQuery = (_k = (_j = opts == null ? void 0 : opts.initialQuery) != null ? _j : prev == null ? void 0 : prev.query) != null ? _k : "";
+        const searchPayload = (_l = prev == null ? void 0 : prev.searchPayload) != null ? _l : buildSearchPayloadFromTarget(searchTarget);
         const { rawList, optionsList } = await performFetch(
           def,
           effectiveFilters,
@@ -886,7 +1007,7 @@ function ListerProvider(props) {
         );
         return await new Promise(
           (resolve) => {
-            var _a3, _b3, _c3, _d2;
+            var _a3, _b3, _c3;
             const base = initialSessionState(sessionId);
             const nextSession = {
               ...prev ? { ...prev } : base,
@@ -902,12 +1023,12 @@ function ListerProvider(props) {
               draggable: (_a3 = opts == null ? void 0 : opts.draggable) != null ? _a3 : true,
               position: pos,
               hasMoved: false,
-              searchMode: (_b3 = opts == null ? void 0 : opts.searchMode) != null ? _b3 : "remote",
+              searchMode: resolvedSearchMode,
               query: initialQuery,
               searchSpec,
               searchTarget,
-              showRefresh: (_c3 = opts == null ? void 0 : opts.showRefresh) != null ? _c3 : false,
-              refreshMode: (_d2 = opts == null ? void 0 : opts.refreshMode) != null ? _d2 : "preserve-selection",
+              showRefresh: (_b3 = opts == null ? void 0 : opts.showRefresh) != null ? _b3 : false,
+              refreshMode: (_c3 = opts == null ? void 0 : opts.refreshMode) != null ? _c3 : "preserve-selection",
               // filters
               filtersSpec,
               filtersPatch,
@@ -1125,17 +1246,32 @@ function ListerProvider(props) {
   );
   const setSearchMode = React.useCallback(
     (id, mode) => {
+      var _a2;
+      const s3 = getSession(id);
+      if (!s3) return;
+      const prevMode = s3.searchMode;
       patchSession(id, { searchMode: mode });
+      if (prevMode === mode) return;
+      if (mode === "local") {
+        fetchAndHydrate(id, "refresh", {
+          filters: (_a2 = s3.effectiveFilters) != null ? _a2 : s3.filters,
+          query: "",
+          // base fetch (unsearched)
+          search: void 0
+          // force NO search payload
+        });
+      }
     },
-    [patchSession]
+    [fetchAndHydrate, getSession, patchSession]
   );
   const scheduleRemoteFetch = React.useCallback(
     (id, q2, payloadOverride) => {
       if (timerBySessionRef.current[id])
         clearTimeout(timerBySessionRef.current[id]);
       timerBySessionRef.current[id] = setTimeout(() => {
+        var _a2;
         const s3 = getSession(id);
-        const search = payloadOverride != null ? payloadOverride : buildSearchPayloadFromTarget(s3 == null ? void 0 : s3.searchTarget);
+        const search = (_a2 = payloadOverride != null ? payloadOverride : s3 == null ? void 0 : s3.searchPayload) != null ? _a2 : buildSearchPayloadFromTarget(s3 == null ? void 0 : s3.searchTarget);
         fetchAndHydrate(id, "search", { query: q2, search });
       }, debounceMs);
     },
@@ -1144,7 +1280,10 @@ function ListerProvider(props) {
   const setSearchTarget = React.useCallback(
     (id, target) => {
       var _a2, _b2;
-      patchSession(id, { searchTarget: target });
+      patchSession(id, {
+        searchTarget: target,
+        searchPayload: void 0
+      });
       const s3 = getSession(id);
       const mode = (_a2 = s3 == null ? void 0 : s3.searchMode) != null ? _a2 : "remote";
       const q2 = (_b2 = s3 == null ? void 0 : s3.query) != null ? _b2 : "";
@@ -1156,7 +1295,7 @@ function ListerProvider(props) {
   );
   const searchLocalImpl = React.useCallback(
     (id, q2, payload) => {
-      patchSession(id, { query: q2 });
+      patchSession(id, { query: q2, searchPayload: payload });
       const s3 = getSession(id);
       if (!s3) return;
       if (s3.searchMode === "hybrid") {
@@ -1167,7 +1306,7 @@ function ListerProvider(props) {
   );
   const searchRemoteImpl = React.useCallback(
     (id, q2, payload) => {
-      patchSession(id, { query: q2 });
+      patchSession(id, { query: q2, searchPayload: payload });
       scheduleRemoteFetch(id, q2, payload);
     },
     [patchSession, scheduleRemoteFetch]
@@ -1195,13 +1334,30 @@ function ListerProvider(props) {
   );
   const getVisibleOptions = React.useCallback(
     (id) => {
+      var _a2, _b2, _c2, _d;
       const s3 = getSession(id);
       if (!s3) return [];
-      if (s3.searchMode === "local")
-        return filterOptionsLocal(s3.optionsList, s3.query);
-      if (s3.searchMode === "hybrid")
-        return filterOptionsLocal(s3.optionsList, s3.query);
-      return s3.optionsList;
+      if (s3.searchMode === "remote") return s3.optionsList;
+      const def = s3.definition;
+      if (!def) return [];
+      const filters = (_a2 = s3.effectiveFilters) != null ? _a2 : s3.filters;
+      const payload = (_b2 = s3.searchPayload) != null ? _b2 : buildSearchPayloadFromTarget(s3 == null ? void 0 : s3.searchTarget);
+      const visibleRaw = filterRawListLocal(
+        (_c2 = s3.rawList) != null ? _c2 : [],
+        s3.query,
+        payload,
+        filters,
+        {
+          searchSpec: (_d = s3.searchSpec) != null ? _d : def.search,
+          filtersSpec: s3.filtersSpec
+        }
+      );
+      const mapCtx = { query: s3.query, filters };
+      return mapOptions(
+        visibleRaw,
+        def.mapping,
+        mapCtx
+      );
     },
     [getSession]
   );
@@ -1266,50 +1422,6 @@ function ListerProvider(props) {
   );
   return /* @__PURE__ */ jsx(Ctx.Provider, { value, children: props.children });
 }
-function useLister() {
-  const ctx = React.useContext(Ctx);
-  if (!ctx)
-    throw new Error("useLister must be used within <ListerProvider />");
-  const api = React.useMemo(() => {
-    const fetch = ((kindOrDef, filters, opts) => ctx.apiFetchAny(kindOrDef, filters, opts));
-    const open = ((kindOrDef, filters, opts) => ctx.apiOpenAny(kindOrDef, filters, opts));
-    return {
-      fetch,
-      open,
-      registerPreset: (kind, def) => ctx.registerPreset(kind, def),
-      getPreset: (kind) => ctx.getPreset(kind)
-    };
-  }, [ctx]);
-  const active = ctx.store.activeId ? ctx.store.sessions[ctx.store.activeId] : void 0;
-  return {
-    api,
-    store: ctx.store,
-    state: active,
-    actions: {
-      focus: ctx.focus,
-      dispose: ctx.dispose,
-      apply: ctx.apply,
-      cancel: ctx.cancel,
-      close: ctx.close,
-      toggle: ctx.toggle,
-      select: ctx.select,
-      deselect: ctx.deselect,
-      clear: ctx.clear,
-      setQuery: ctx.setQuery,
-      setSearchMode: ctx.setSearchMode,
-      setSearchTarget: ctx.setSearchTarget,
-      searchLocal: ctx.searchLocal,
-      searchRemote: ctx.searchRemote,
-      refresh: ctx.refresh,
-      setPosition: ctx.setPosition,
-      getFilterCtx: ctx.getFilterCtx,
-      applyFilterOption: ctx.applyFilterOption,
-      registerPreset: ctx.registerPreset,
-      getPreset: ctx.getPreset,
-      getVisibleOptions: ctx.getVisibleOptions
-    }
-  };
-}
 
 // ../../node_modules/clsx/dist/clsx.mjs
 function r(e4) {
@@ -25800,6 +25912,7 @@ function SearchBar(props) {
     }
   };
   const hasSearchTargetUI = !!searchSpec && (allowAll || specSubjects.length > 0 || specOnly.length > 0 || allowCustomSubject);
+  console.log(searchMode);
   return /* @__PURE__ */ jsx("div", { className: "px-3 py-2", onMouseDown: () => actions.focus(id), children: /* @__PURE__ */ jsx(
     Input,
     {
@@ -25971,7 +26084,7 @@ function SearchBar(props) {
           {
             variant: "select",
             mode: "button",
-            value: searchMode,
+            defaultValue: searchMode,
             triggerClassName: "border-none ring-0 shadow-none! px-1! cursor-pointer",
             options: [
               {
@@ -26248,6 +26361,429 @@ function FooterBar(props) {
     }
   );
 }
+function useLister() {
+  const ctx = React.useContext(Ctx);
+  if (!ctx)
+    throw new Error("useLister must be used within <ListerProvider />");
+  const api = React.useMemo(() => {
+    const fetch = ((kindOrDef, filters, opts) => ctx.apiFetchAny(kindOrDef, filters, opts));
+    const open = ((kindOrDef, filters, opts) => ctx.apiOpenAny(kindOrDef, filters, opts));
+    return {
+      fetch,
+      open,
+      registerPreset: (kind, def) => ctx.registerPreset(kind, def),
+      getPreset: (kind) => ctx.getPreset(kind)
+    };
+  }, [ctx]);
+  const active = ctx.store.activeId ? ctx.store.sessions[ctx.store.activeId] : void 0;
+  return {
+    api,
+    store: ctx.store,
+    state: active,
+    actions: {
+      focus: ctx.focus,
+      dispose: ctx.dispose,
+      apply: ctx.apply,
+      cancel: ctx.cancel,
+      close: ctx.close,
+      toggle: ctx.toggle,
+      select: ctx.select,
+      deselect: ctx.deselect,
+      clear: ctx.clear,
+      setQuery: ctx.setQuery,
+      setSearchMode: ctx.setSearchMode,
+      setSearchTarget: ctx.setSearchTarget,
+      searchLocal: ctx.searchLocal,
+      searchRemote: ctx.searchRemote,
+      refresh: ctx.refresh,
+      setPosition: ctx.setPosition,
+      getFilterCtx: ctx.getFilterCtx,
+      applyFilterOption: ctx.applyFilterOption,
+      registerPreset: ctx.registerPreset,
+      getPreset: ctx.getPreset,
+      getVisibleOptions: ctx.getVisibleOptions
+    }
+  };
+}
+function defaultSearchTarget(search) {
+  const def = search == null ? void 0 : search.default;
+  return def ? { mode: "subject", subject: def, only: null } : void 0;
+}
+function isKey(x2) {
+  return typeof x2 === "string" || typeof x2 === "number";
+}
+function useData(opts) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  const ctx = React.useContext(Ctx);
+  if (!ctx) throw new Error("useData must be used within <ListerProvider />");
+  const enabled = (_a = opts.enabled) != null ? _a : true;
+  const debounceMs = (_b = opts.debounceMs) != null ? _b : 300;
+  const [data, setData] = React.useState(() => {
+    var _a2;
+    return (_a2 = opts.initial) != null ? _a2 : [];
+  });
+  const [loading, setLoading] = React.useState(false);
+  const [error, setError] = React.useState(void 0);
+  const [query, _setQuery] = React.useState("");
+  const [searchMode, _setSearchMode] = React.useState(
+    (_c = opts.searchMode) != null ? _c : "remote"
+  );
+  const [searchTarget, _setSearchTarget] = React.useState(() => defaultSearchTarget(opts.search));
+  const [filters, _setFilters] = React.useState(
+    opts.filters
+  );
+  const selectionMode = (_e = (_d = opts.selection) == null ? void 0 : _d.mode) != null ? _e : "none";
+  const selectionPrune = (_g = (_f = opts.selection) == null ? void 0 : _f.prune) != null ? _g : "never";
+  const getItemKey = React.useMemo(() => {
+    var _a2;
+    const key = (_a2 = opts.selection) == null ? void 0 : _a2.key;
+    if (!key) {
+      return (item) => {
+        var _a3;
+        const v2 = (_a3 = item == null ? void 0 : item.id) != null ? _a3 : item == null ? void 0 : item.value;
+        return isKey(v2) ? v2 : null;
+      };
+    }
+    if (typeof key === "function") {
+      return (item) => {
+        const v2 = key(item);
+        return isKey(v2) ? v2 : null;
+      };
+    }
+    return (item) => {
+      const v2 = item == null ? void 0 : item[key];
+      return isKey(v2) ? v2 : null;
+    };
+  }, [(_h = opts.selection) == null ? void 0 : _h.key]);
+  const [selectedIdsArr, setSelectedIdsArr] = React.useState([]);
+  const selectedCacheRef = React.useRef(/* @__PURE__ */ new Map());
+  const reqIdRef = React.useRef(0);
+  const timerRef = React.useRef(null);
+  const didMountRef = React.useRef(false);
+  const skipNextModeEffectRef = React.useRef(false);
+  const inlineDef = React.useMemo(() => {
+    var _a2;
+    return makeInlineDef({
+      id: opts.id,
+      endpoint: opts.endpoint,
+      method: (_a2 = opts.method) != null ? _a2 : "GET",
+      selector: opts.selector,
+      buildRequest: opts.buildRequest,
+      search: opts.search
+    });
+  }, [
+    opts.id,
+    opts.endpoint,
+    opts.method,
+    opts.selector,
+    opts.buildRequest,
+    opts.search
+  ]);
+  const dataById = React.useMemo(() => {
+    const map = /* @__PURE__ */ new Map();
+    if (selectionMode === "none") return map;
+    for (const item of data) {
+      const k2 = getItemKey(item);
+      if (k2 == null) continue;
+      map.set(k2, item);
+    }
+    return map;
+  }, [data, getItemKey, selectionMode]);
+  const normalizeIds = React.useCallback((v2) => {
+    return Array.isArray(v2) ? v2 : [v2];
+  }, []);
+  const commitSelectedCache = React.useCallback(
+    (list) => {
+      if (selectionMode === "none") return;
+      for (const item of list) {
+        const k2 = getItemKey(item);
+        if (k2 == null) continue;
+        selectedCacheRef.current.set(k2, item);
+      }
+    },
+    [getItemKey, selectionMode]
+  );
+  const fetchImpl = React.useCallback(
+    async (override) => {
+      var _a2, _b2, _c2, _d2, _e2, _f2;
+      if (!enabled) return data;
+      const q2 = (_a2 = override == null ? void 0 : override.query) != null ? _a2 : query;
+      const f2 = (_b2 = override == null ? void 0 : override.filters) != null ? _b2 : filters;
+      const t4 = (_c2 = override == null ? void 0 : override.searchTarget) != null ? _c2 : searchTarget;
+      const myReq = ++reqIdRef.current;
+      setLoading(true);
+      setError(void 0);
+      try {
+        const payload = (_d2 = override == null ? void 0 : override.search) != null ? _d2 : buildSearchPayloadFromTarget(t4);
+        const res = await ctx.apiFetchAny(inlineDef, f2, {
+          query: q2,
+          search: payload
+        });
+        const list = (_f2 = (_e2 = res == null ? void 0 : res.rawList) != null ? _e2 : res == null ? void 0 : res.raw) != null ? _f2 : [];
+        commitSelectedCache(list);
+        if (selectionMode !== "none" && selectionPrune === "missing") {
+          const nextIds = /* @__PURE__ */ new Set();
+          for (const item of list) {
+            const k2 = getItemKey(item);
+            if (k2 != null) nextIds.add(k2);
+          }
+          setSelectedIdsArr(
+            (prev) => prev.filter((x2) => nextIds.has(x2))
+          );
+        }
+        if (reqIdRef.current !== myReq) return list;
+        setData(list);
+        setLoading(false);
+        return list;
+      } catch (e4) {
+        if (reqIdRef.current !== myReq) return data;
+        setError(e4);
+        setLoading(false);
+        return data;
+      }
+    },
+    [
+      commitSelectedCache,
+      ctx,
+      data,
+      enabled,
+      filters,
+      getItemKey,
+      inlineDef,
+      query,
+      searchTarget,
+      selectionMode,
+      selectionPrune
+    ]
+  );
+  const refresh = React.useCallback(() => {
+    void fetchImpl();
+  }, [fetchImpl]);
+  const setQuery = React.useCallback((q2) => _setQuery(q2), []);
+  const setSearchMode = React.useCallback(
+    (m2) => {
+      if (timerRef.current) clearTimeout(timerRef.current);
+      if (m2 === "remote" || m2 === "hybrid") {
+        skipNextModeEffectRef.current = true;
+        _setSearchMode(m2);
+        void fetchImpl();
+        return;
+      }
+      _setSearchMode(m2);
+      if (m2 === "local") {
+        void fetchImpl({
+          query: "",
+          search: void 0
+        });
+      }
+    },
+    [fetchImpl]
+  );
+  const setSearchTarget = React.useCallback(
+    (t4) => {
+      _setSearchTarget(t4);
+      if (searchMode === "remote" || searchMode === "hybrid") {
+        if (timerRef.current) clearTimeout(timerRef.current);
+        timerRef.current = setTimeout(() => {
+          void fetchImpl({ searchTarget: t4 });
+        }, debounceMs);
+      }
+    },
+    [debounceMs, fetchImpl, searchMode]
+  );
+  const setFilters = React.useCallback(
+    (next) => _setFilters(next),
+    []
+  );
+  const patchFilters = React.useCallback((patch) => {
+    _setFilters((prev) => ({
+      ...prev != null ? prev : {},
+      ...patch
+    }));
+  }, []);
+  const clearFilters = React.useCallback(() => _setFilters(void 0), []);
+  const fetchOnMount = (_i = opts.fetchOnMount) != null ? _i : !opts.initial;
+  React.useEffect(() => {
+    if (!enabled) return;
+    if (!fetchOnMount) return;
+    void fetchImpl();
+  }, []);
+  React.useEffect(() => {
+    if (!enabled) return;
+    if (!didMountRef.current) {
+      didMountRef.current = true;
+      return;
+    }
+    if (searchMode !== "remote" && searchMode !== "hybrid") return;
+    if (skipNextModeEffectRef.current) {
+      skipNextModeEffectRef.current = false;
+      return;
+    }
+    if (timerRef.current) clearTimeout(timerRef.current);
+    timerRef.current = setTimeout(() => {
+      void fetchImpl();
+    }, debounceMs);
+    return () => {
+      if (timerRef.current) clearTimeout(timerRef.current);
+    };
+  }, [debounceMs, enabled, fetchImpl, query, searchMode, searchTarget]);
+  React.useEffect(() => {
+    if (!enabled) return;
+    if (opts.autoFetchOnFilterChange === false) return;
+    if (!didMountRef.current) return;
+    if (searchMode !== "remote" && searchMode !== "hybrid") return;
+    void fetchImpl();
+  }, [enabled, fetchImpl, filters, opts.autoFetchOnFilterChange, searchMode]);
+  const visible = React.useMemo(() => {
+    if (searchMode !== "local" && searchMode !== "hybrid") return data;
+    const payload = buildSearchPayloadFromTarget(searchTarget);
+    let list = data;
+    if ((payload == null ? void 0 : payload.searchOnly) && payload.searchOnly.length) {
+      const allow = new Set(payload.searchOnly);
+      list = list.filter((item) => {
+        const k2 = getItemKey(item);
+        return k2 != null && allow.has(k2);
+      });
+    }
+    const q2 = query.trim();
+    if (!q2) return list;
+    const ql = q2.toLowerCase();
+    if (payload == null ? void 0 : payload.subject) {
+      const key = payload.subject;
+      return list.filter(
+        (item) => {
+          var _a2;
+          return String((_a2 = item == null ? void 0 : item[key]) != null ? _a2 : "").toLowerCase().includes(ql);
+        }
+      );
+    }
+    return list.filter(
+      (item) => String(item != null ? item : "").toLowerCase().includes(ql)
+    );
+  }, [data, getItemKey, query, searchMode, searchTarget]);
+  const selectedIds = React.useMemo(() => {
+    var _a2;
+    if (selectionMode === "none") return null;
+    if (selectionMode === "single") return (_a2 = selectedIdsArr[0]) != null ? _a2 : null;
+    return selectedIdsArr;
+  }, [selectionMode, selectedIdsArr]);
+  const isSelected = React.useCallback(
+    (id) => {
+      if (selectionMode === "none") return false;
+      return selectedIdsArr.includes(id);
+    },
+    [selectedIdsArr, selectionMode]
+  );
+  const clearSelection = React.useCallback(() => {
+    if (selectionMode === "none") return;
+    setSelectedIdsArr([]);
+  }, [selectionMode]);
+  const select = React.useCallback(
+    (idOrIds) => {
+      if (selectionMode === "none") return;
+      const ids = normalizeIds(idOrIds).filter(isKey);
+      if (!ids.length) return;
+      for (const id of ids) {
+        const hit = dataById.get(id);
+        if (hit) selectedCacheRef.current.set(id, hit);
+      }
+      if (selectionMode === "single") {
+        setSelectedIdsArr([ids[0]]);
+        return;
+      }
+      setSelectedIdsArr((prev) => {
+        const set = new Set(prev);
+        for (const id of ids) set.add(id);
+        return Array.from(set);
+      });
+    },
+    [dataById, normalizeIds, selectionMode]
+  );
+  const deselect = React.useCallback(
+    (idOrIds) => {
+      if (selectionMode === "none") return;
+      const ids = new Set(normalizeIds(idOrIds).filter(isKey));
+      if (!ids.size) return;
+      setSelectedIdsArr((prev) => {
+        const next = prev.filter((x2) => !ids.has(x2));
+        if (selectionMode === "single") return next.slice(0, 1);
+        return next;
+      });
+    },
+    [normalizeIds, selectionMode]
+  );
+  const toggle = React.useCallback(
+    (id) => {
+      if (selectionMode === "none") return;
+      const hit = dataById.get(id);
+      if (hit) selectedCacheRef.current.set(id, hit);
+      if (selectionMode === "single") {
+        setSelectedIdsArr((prev) => prev[0] === id ? [] : [id]);
+        return;
+      }
+      setSelectedIdsArr((prev) => {
+        const set = new Set(prev);
+        if (set.has(id)) set.delete(id);
+        else set.add(id);
+        return Array.from(set);
+      });
+    },
+    [dataById, selectionMode]
+  );
+  const selected = React.useMemo(() => {
+    var _a2, _b2, _c2, _d2;
+    if (selectionMode === "none") return null;
+    if (selectionMode === "single") {
+      const id = selectedIdsArr[0];
+      if (id == null) return null;
+      return (_b2 = (_a2 = dataById.get(id)) != null ? _a2 : selectedCacheRef.current.get(id)) != null ? _b2 : null;
+    }
+    const out = [];
+    for (const id of selectedIdsArr) {
+      const item = (_d2 = (_c2 = dataById.get(id)) != null ? _c2 : selectedCacheRef.current.get(id)) != null ? _d2 : null;
+      if (item) out.push(item);
+    }
+    return out;
+  }, [dataById, selectedIdsArr, selectionMode]);
+  const getSelection = React.useCallback(() => selected, [selected]);
+  React.useEffect(() => {
+    if (selectionMode === "none") {
+      setSelectedIdsArr([]);
+      return;
+    }
+    if (selectionMode === "single") {
+      setSelectedIdsArr((prev) => prev.length ? [prev[0]] : []);
+    }
+  }, [selectionMode]);
+  return {
+    id: opts.id,
+    data,
+    visible,
+    loading,
+    error,
+    query,
+    setQuery,
+    searchMode,
+    setSearchMode,
+    searchTarget,
+    setSearchTarget,
+    filters,
+    setFilters,
+    patchFilters,
+    clearFilters,
+    selectionMode,
+    selectedIds,
+    selected,
+    select,
+    deselect,
+    toggle,
+    clearSelection,
+    isSelected,
+    getSelection,
+    refresh,
+    fetch: fetchImpl
+  };
+}
 /*! Bundled license information:
 
 lucide-react/dist/esm/shared/src/utils.js:
@@ -26298,6 +26834,6 @@ lucide-react/dist/esm/lucide-react.js:
    *)
 */
 
-export { FooterBar, HeaderBar, json_editor_default as JsonEditor, ListerProvider, ListerUI, OptionList, SearchBar, useLister };
+export { Ctx, FooterBar, HeaderBar, json_editor_default as JsonEditor, ListerProvider, ListerUI, OptionList, SearchBar, buildSearchPayloadFromTarget, useData, useLister };
 //# sourceMappingURL=extra.mjs.map
 //# sourceMappingURL=extra.mjs.map