@athenaintel/react 0.18.0 → 0.20.0

package/dist/chat-ui/mentions/suggestions/data/orchestrator.cjs

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const athenaDiagnostics = require("../../../../diagnostics/athena-diagnostics.cjs");
+const itemCache = require("./item-cache.cjs");
+const scopeRegistry = require("./scope-registry.cjs");
+const MAX_ERROR_RETRIES = 3;
+function selectItems(store, scope, query, _targetCount, parentScope) {
+  const state = store.state;
+  const scopeId = typeof scope === "string" ? scope : scope.id;
+  const parentScopeId = parentScope ? typeof parentScope === "string" ? parentScope : parentScope.id : void 0;
+  const items = itemCache.getFilteredItems(state.cache, scopeId, query);
+  let isFetching = false;
+  let hasMore = true;
+  try {
+    const fetchState = scopeRegistry.getFetchState(state.registry, scopeId, query, parentScopeId);
+    isFetching = fetchState.isFetching;
+    hasMore = fetchState.hasNextPage;
+  } catch {
+    hasMore = false;
+  }
+  return { items, isFetching, hasMore };
+}
+function triggerFetchIfNeeded(store, scope, query, _targetCount, parentScope) {
+  const scopeId = typeof scope === "string" ? scope : scope.id;
+  const parentScopeId = parentScope ? typeof parentScope === "string" ? parentScope : parentScope.id : void 0;
+  const state = store.state;
+  let entry;
+  try {
+    entry = scopeRegistry.getEntry(state.registry, scopeId, parentScopeId);
+  } catch {
+    return;
+  }
+  const fetchState = scopeRegistry.getFetchState(state.registry, scopeId, query, parentScopeId);
+  if (fetchState.isFetching || !fetchState.hasNextPage || fetchState.error) {
+    return;
+  }
+  const meta = fetchState.meta || {};
+  if ((meta.fetchAttempts || 0) >= 10) return;
+  scopeRegistry.updateFetchState(state.registry, scopeId, query, { isFetching: true }, parentScopeId);
+  store.setState((prev) => ({ ...prev }));
+  const sourceFn = entry.sourceFn;
+  const sourceConfig = entry.sourceConfig;
+  sourceFn({
+    scope: scopeId,
+    query,
+    fetchState,
+    sourceConfig
+  }).then((result) => {
+    var _a, _b;
+    const currentState = store.state;
+    itemCache.addItems(currentState.cache, result.items, scopeId);
+    if (result.sources) {
+      for (const src of result.sources) {
+        try {
+          scopeRegistry.getEntry(currentState.registry, src.scope);
+        } catch {
+          scopeRegistry.registerSource(
+            currentState.registry,
+            src.scope,
+            src.sourceFn,
+            src.sourceConfig,
+            src.isFlat
+          );
+        }
+      }
+    }
+    if (result.bindings) {
+      for (const binding of result.bindings) {
+        scopeRegistry.bindScopes(currentState.registry, binding.browseScope, binding.searchScope);
+      }
+    }
+    const currentMeta = fetchState.meta || {};
+    const consumed = ((_a = result.pagination) == null ? void 0 : _a.consumedCount) ?? result.items.length;
+    const newValidated = (currentMeta.validatedCount || 0) + consumed;
+    scopeRegistry.updateFetchState(
+      currentState.registry,
+      scopeId,
+      query,
+      {
+        isFetching: false,
+        hasNextPage: ((_b = result.pagination) == null ? void 0 : _b.hasMore) ?? false,
+        error: null,
+        meta: {
+          ...currentMeta,
+          ...result.meta,
+          validatedCount: newValidated,
+          fetchAttempts: (currentMeta.fetchAttempts || 0) + 1,
+          errorAttempts: 0
+        }
+      },
+      parentScopeId
+    );
+    store.setState((prev) => ({ ...prev }));
+  }).catch((error) => {
+    const currentState = store.state;
+    const currentMeta = fetchState.meta || {};
+    const errorAttempts = (currentMeta.errorAttempts || 0) + 1;
+    const retriable = errorAttempts < MAX_ERROR_RETRIES;
+    if (retriable) {
+      athenaDiagnostics.athenaDiagnostics.emit("mentions.fetch.error", {
+        level: "warn",
+        data: {
+          scopeId,
+          attempt: errorAttempts,
+          retriable,
+          error: error instanceof Error ? error.message : String(error)
+        }
+      });
+    } else {
+      athenaDiagnostics.athenaDiagnostics.error(
+        "mentions.fetch.error",
+        error,
+        { code: "mentions_fetch_failed", message: `Mention suggestions failed for ${scopeId}` },
+        { scopeId, attempt: errorAttempts, retriable }
+      );
+    }
+    scopeRegistry.updateFetchState(
+      currentState.registry,
+      scopeId,
+      query,
+      {
+        isFetching: false,
+        hasNextPage: retriable,
+        error: retriable ? null : error instanceof Error ? error : new Error(String(error)),
+        meta: { ...currentMeta, errorAttempts }
+      },
+      parentScopeId
+    );
+    store.setState((prev) => ({ ...prev }));
+  });
+}
+exports.selectItems = selectItems;
+exports.triggerFetchIfNeeded = triggerFetchIfNeeded;
+//# sourceMappingURL=orchestrator.cjs.map

package/dist/chat-ui/mentions/suggestions/data/orchestrator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.cjs","sources":["../../../../../src/chat-ui/mentions/suggestions/data/orchestrator.ts"],"sourcesContent":["/**\n * Mention Orchestrator — Async data fetching with registry + cache.\n *\n * selectItems (pure read) + triggerFetchIfNeeded (async fetch).\n */\n\nimport { athenaDiagnostics } from \"../../../../diagnostics/athena-diagnostics\";\nimport type { MenuItem, MenuScope, FetchMetadata, SourceToRegister } from \"./types\";\nimport type { MentionSuggestionsStore, MentionSuggestionsStoreState } from \"./use-mention-suggestions\";\nimport { getFilteredItems, addItems } from \"./item-cache\";\nimport {\n  getEntry,\n  getFetchState,\n  updateFetchState,\n  registerSource,\n  bindScopes,\n} from \"./scope-registry\";\nimport { filterItems } from \"./utils/filter-items\";\n\n/** Consecutive fetch failures tolerated before a scope+query stops retrying. */\nconst MAX_ERROR_RETRIES = 3;\n\n/**\n * Select items for a given scope + query from the cache.\n * Pure, synchronous read — no side effects.\n */\nexport function selectItems(\n  store: MentionSuggestionsStore,\n  scope: MenuScope | { id: string },\n  query: string,\n  _targetCount?: number,\n  parentScope?: MenuScope | { id: string },\n): { items: MenuItem[]; isFetching: boolean; hasMore: boolean } {\n  const state = store.state;\n  const scopeId = typeof scope === \"string\" ? scope : scope.id;\n  const parentScopeId = parentScope\n    ? typeof parentScope === \"string\" ? parentScope : parentScope.id\n    : undefined;\n\n  // Read from cache\n  const items = getFilteredItems(state.cache, scopeId, query);\n\n  // Read fetch state from registry\n  let isFetching = false;\n  let hasMore = true;\n\n  try {\n    const fetchState = getFetchState(state.registry, scopeId, query, parentScopeId);\n    isFetching = fetchState.isFetching;\n    hasMore = fetchState.hasNextPage;\n  } catch {\n    // Scope not registered — no more to fetch\n    hasMore = false;\n  }\n\n  return { items, isFetching, hasMore };\n}\n\n/**\n * Trigger an async fetch if needed.\n * Called by useMenuItems when cache < target AND hasMore AND !fetching.\n */\nexport function triggerFetchIfNeeded(\n  store: MentionSuggestionsStore,\n  scope: MenuScope | { id: string },\n  query: string,\n  _targetCount?: number,\n  parentScope?: MenuScope | { id: string },\n): void {\n  const scopeId = typeof scope === \"string\" ? scope : scope.id;\n  const parentScopeId = parentScope\n    ? typeof parentScope === \"string\" ? parentScope : parentScope.id\n    : undefined;\n\n  const state = store.state;\n\n  // Check if scope is registered\n  let entry;\n  try {\n    entry = getEntry(state.registry, scopeId, parentScopeId);\n  } catch {\n    return; // Not registered, nothing to fetch\n  }\n\n  // Check fetch state\n  const fetchState = getFetchState(state.registry, scopeId, query, parentScopeId);\n  if (fetchState.isFetching || !fetchState.hasNextPage || fetchState.error) {\n    return;\n  }\n\n  // Safety limit\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  if ((meta.fetchAttempts || 0) >= 10) return;\n\n  // Mark as fetching\n  updateFetchState(state.registry, scopeId, query, { isFetching: true }, parentScopeId);\n  store.setState((prev) => ({ ...prev }));\n\n  // Async fetch\n  const sourceFn = entry.sourceFn;\n  const sourceConfig = entry.sourceConfig;\n\n  sourceFn({\n    scope: scopeId,\n    query,\n    fetchState,\n    sourceConfig,\n  })\n    .then((result) => {\n      const currentState = store.state;\n\n      // Add items to cache with scope tagging\n      addItems(currentState.cache, result.items, scopeId);\n\n      // Register dynamically discovered sources\n      if (result.sources) {\n        for (const src of result.sources) {\n          try {\n            getEntry(currentState.registry, src.scope);\n          } catch {\n            // Not registered yet — register it\n            registerSource(\n              currentState.registry,\n              src.scope,\n              src.sourceFn,\n              src.sourceConfig,\n              src.isFlat,\n            );\n          }\n        }\n      }\n\n      // Register dynamically discovered bindings\n      if (result.bindings) {\n        for (const binding of result.bindings) {\n          bindScopes(currentState.registry, binding.browseScope, binding.searchScope);\n        }\n      }\n\n      // Update fetch state\n      const currentMeta = (fetchState.meta as FetchMetadata) || {};\n      // Advance the server-side offset by the rows the source consumed, which\n      // exceeds `items.length` whenever a source drops rows after fetching.\n      const consumed = result.pagination?.consumedCount ?? result.items.length;\n      const newValidated = (currentMeta.validatedCount || 0) + consumed;\n\n      updateFetchState(\n        currentState.registry,\n        scopeId,\n        query,\n        {\n          isFetching: false,\n          hasNextPage: result.pagination?.hasMore ?? false,\n          error: null,\n          meta: {\n            ...currentMeta,\n            ...result.meta,\n            validatedCount: newValidated,\n            fetchAttempts: (currentMeta.fetchAttempts || 0) + 1,\n            errorAttempts: 0,\n          },\n        },\n        parentScopeId,\n      );\n\n      // Trigger re-render\n      store.setState((prev) => ({ ...prev }));\n    })\n    .catch((error) => {\n      const currentState = store.state;\n      const currentMeta = (fetchState.meta as FetchMetadata) || {};\n      const errorAttempts = ((currentMeta.errorAttempts as number) || 0) + 1;\n      const retriable = errorAttempts < MAX_ERROR_RETRIES;\n\n      // Retriable failures are a warning on the bus; the final one is an\n      // error and also lands in the scope's fetch state below.\n      if (retriable) {\n        athenaDiagnostics.emit(\"mentions.fetch.error\", {\n          level: \"warn\",\n          data: {\n            scopeId,\n            attempt: errorAttempts,\n            retriable,\n            error: error instanceof Error ? error.message : String(error),\n          },\n        });\n      } else {\n        athenaDiagnostics.error(\n          \"mentions.fetch.error\",\n          error,\n          { code: \"mentions_fetch_failed\", message: `Mention suggestions failed for ${scopeId}` },\n          { scopeId, attempt: errorAttempts, retriable },\n        );\n      }\n\n      updateFetchState(\n        currentState.registry,\n        scopeId,\n        query,\n        {\n          isFetching: false,\n          hasNextPage: retriable,\n          error: retriable\n            ? null\n            : error instanceof Error\n              ? error\n              : new Error(String(error)),\n          meta: { ...currentMeta, errorAttempts },\n        },\n        parentScopeId,\n      );\n\n      store.setState((prev) => ({ ...prev }));\n    });\n}\n"],"names":["getFilteredItems","getFetchState","getEntry","updateFetchState","addItems","registerSource","bindScopes","athenaDiagnostics"],"mappings":"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"}

package/dist/chat-ui/mentions/suggestions/data/orchestrator.js

@@ -0,0 +1,134 @@
+import { athenaDiagnostics } from "../../../../diagnostics/athena-diagnostics.js";
+import { getFilteredItems, addItems } from "./item-cache.js";
+import { getFetchState, getEntry, updateFetchState, registerSource, bindScopes } from "./scope-registry.js";
+const MAX_ERROR_RETRIES = 3;
+function selectItems(store, scope, query, _targetCount, parentScope) {
+  const state = store.state;
+  const scopeId = typeof scope === "string" ? scope : scope.id;
+  const parentScopeId = parentScope ? typeof parentScope === "string" ? parentScope : parentScope.id : void 0;
+  const items = getFilteredItems(state.cache, scopeId, query);
+  let isFetching = false;
+  let hasMore = true;
+  try {
+    const fetchState = getFetchState(state.registry, scopeId, query, parentScopeId);
+    isFetching = fetchState.isFetching;
+    hasMore = fetchState.hasNextPage;
+  } catch {
+    hasMore = false;
+  }
+  return { items, isFetching, hasMore };
+}
+function triggerFetchIfNeeded(store, scope, query, _targetCount, parentScope) {
+  const scopeId = typeof scope === "string" ? scope : scope.id;
+  const parentScopeId = parentScope ? typeof parentScope === "string" ? parentScope : parentScope.id : void 0;
+  const state = store.state;
+  let entry;
+  try {
+    entry = getEntry(state.registry, scopeId, parentScopeId);
+  } catch {
+    return;
+  }
+  const fetchState = getFetchState(state.registry, scopeId, query, parentScopeId);
+  if (fetchState.isFetching || !fetchState.hasNextPage || fetchState.error) {
+    return;
+  }
+  const meta = fetchState.meta || {};
+  if ((meta.fetchAttempts || 0) >= 10) return;
+  updateFetchState(state.registry, scopeId, query, { isFetching: true }, parentScopeId);
+  store.setState((prev) => ({ ...prev }));
+  const sourceFn = entry.sourceFn;
+  const sourceConfig = entry.sourceConfig;
+  sourceFn({
+    scope: scopeId,
+    query,
+    fetchState,
+    sourceConfig
+  }).then((result) => {
+    var _a, _b;
+    const currentState = store.state;
+    addItems(currentState.cache, result.items, scopeId);
+    if (result.sources) {
+      for (const src of result.sources) {
+        try {
+          getEntry(currentState.registry, src.scope);
+        } catch {
+          registerSource(
+            currentState.registry,
+            src.scope,
+            src.sourceFn,
+            src.sourceConfig,
+            src.isFlat
+          );
+        }
+      }
+    }
+    if (result.bindings) {
+      for (const binding of result.bindings) {
+        bindScopes(currentState.registry, binding.browseScope, binding.searchScope);
+      }
+    }
+    const currentMeta = fetchState.meta || {};
+    const consumed = ((_a = result.pagination) == null ? void 0 : _a.consumedCount) ?? result.items.length;
+    const newValidated = (currentMeta.validatedCount || 0) + consumed;
+    updateFetchState(
+      currentState.registry,
+      scopeId,
+      query,
+      {
+        isFetching: false,
+        hasNextPage: ((_b = result.pagination) == null ? void 0 : _b.hasMore) ?? false,
+        error: null,
+        meta: {
+          ...currentMeta,
+          ...result.meta,
+          validatedCount: newValidated,
+          fetchAttempts: (currentMeta.fetchAttempts || 0) + 1,
+          errorAttempts: 0
+        }
+      },
+      parentScopeId
+    );
+    store.setState((prev) => ({ ...prev }));
+  }).catch((error) => {
+    const currentState = store.state;
+    const currentMeta = fetchState.meta || {};
+    const errorAttempts = (currentMeta.errorAttempts || 0) + 1;
+    const retriable = errorAttempts < MAX_ERROR_RETRIES;
+    if (retriable) {
+      athenaDiagnostics.emit("mentions.fetch.error", {
+        level: "warn",
+        data: {
+          scopeId,
+          attempt: errorAttempts,
+          retriable,
+          error: error instanceof Error ? error.message : String(error)
+        }
+      });
+    } else {
+      athenaDiagnostics.error(
+        "mentions.fetch.error",
+        error,
+        { code: "mentions_fetch_failed", message: `Mention suggestions failed for ${scopeId}` },
+        { scopeId, attempt: errorAttempts, retriable }
+      );
+    }
+    updateFetchState(
+      currentState.registry,
+      scopeId,
+      query,
+      {
+        isFetching: false,
+        hasNextPage: retriable,
+        error: retriable ? null : error instanceof Error ? error : new Error(String(error)),
+        meta: { ...currentMeta, errorAttempts }
+      },
+      parentScopeId
+    );
+    store.setState((prev) => ({ ...prev }));
+  });
+}
+export {
+  selectItems,
+  triggerFetchIfNeeded
+};
+//# sourceMappingURL=orchestrator.js.map

package/dist/chat-ui/mentions/suggestions/data/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sources":["../../../../../src/chat-ui/mentions/suggestions/data/orchestrator.ts"],"sourcesContent":["/**\n * Mention Orchestrator — Async data fetching with registry + cache.\n *\n * selectItems (pure read) + triggerFetchIfNeeded (async fetch).\n */\n\nimport { athenaDiagnostics } from \"../../../../diagnostics/athena-diagnostics\";\nimport type { MenuItem, MenuScope, FetchMetadata, SourceToRegister } from \"./types\";\nimport type { MentionSuggestionsStore, MentionSuggestionsStoreState } from \"./use-mention-suggestions\";\nimport { getFilteredItems, addItems } from \"./item-cache\";\nimport {\n  getEntry,\n  getFetchState,\n  updateFetchState,\n  registerSource,\n  bindScopes,\n} from \"./scope-registry\";\nimport { filterItems } from \"./utils/filter-items\";\n\n/** Consecutive fetch failures tolerated before a scope+query stops retrying. */\nconst MAX_ERROR_RETRIES = 3;\n\n/**\n * Select items for a given scope + query from the cache.\n * Pure, synchronous read — no side effects.\n */\nexport function selectItems(\n  store: MentionSuggestionsStore,\n  scope: MenuScope | { id: string },\n  query: string,\n  _targetCount?: number,\n  parentScope?: MenuScope | { id: string },\n): { items: MenuItem[]; isFetching: boolean; hasMore: boolean } {\n  const state = store.state;\n  const scopeId = typeof scope === \"string\" ? scope : scope.id;\n  const parentScopeId = parentScope\n    ? typeof parentScope === \"string\" ? parentScope : parentScope.id\n    : undefined;\n\n  // Read from cache\n  const items = getFilteredItems(state.cache, scopeId, query);\n\n  // Read fetch state from registry\n  let isFetching = false;\n  let hasMore = true;\n\n  try {\n    const fetchState = getFetchState(state.registry, scopeId, query, parentScopeId);\n    isFetching = fetchState.isFetching;\n    hasMore = fetchState.hasNextPage;\n  } catch {\n    // Scope not registered — no more to fetch\n    hasMore = false;\n  }\n\n  return { items, isFetching, hasMore };\n}\n\n/**\n * Trigger an async fetch if needed.\n * Called by useMenuItems when cache < target AND hasMore AND !fetching.\n */\nexport function triggerFetchIfNeeded(\n  store: MentionSuggestionsStore,\n  scope: MenuScope | { id: string },\n  query: string,\n  _targetCount?: number,\n  parentScope?: MenuScope | { id: string },\n): void {\n  const scopeId = typeof scope === \"string\" ? scope : scope.id;\n  const parentScopeId = parentScope\n    ? typeof parentScope === \"string\" ? parentScope : parentScope.id\n    : undefined;\n\n  const state = store.state;\n\n  // Check if scope is registered\n  let entry;\n  try {\n    entry = getEntry(state.registry, scopeId, parentScopeId);\n  } catch {\n    return; // Not registered, nothing to fetch\n  }\n\n  // Check fetch state\n  const fetchState = getFetchState(state.registry, scopeId, query, parentScopeId);\n  if (fetchState.isFetching || !fetchState.hasNextPage || fetchState.error) {\n    return;\n  }\n\n  // Safety limit\n  const meta = (fetchState.meta as FetchMetadata) || {};\n  if ((meta.fetchAttempts || 0) >= 10) return;\n\n  // Mark as fetching\n  updateFetchState(state.registry, scopeId, query, { isFetching: true }, parentScopeId);\n  store.setState((prev) => ({ ...prev }));\n\n  // Async fetch\n  const sourceFn = entry.sourceFn;\n  const sourceConfig = entry.sourceConfig;\n\n  sourceFn({\n    scope: scopeId,\n    query,\n    fetchState,\n    sourceConfig,\n  })\n    .then((result) => {\n      const currentState = store.state;\n\n      // Add items to cache with scope tagging\n      addItems(currentState.cache, result.items, scopeId);\n\n      // Register dynamically discovered sources\n      if (result.sources) {\n        for (const src of result.sources) {\n          try {\n            getEntry(currentState.registry, src.scope);\n          } catch {\n            // Not registered yet — register it\n            registerSource(\n              currentState.registry,\n              src.scope,\n              src.sourceFn,\n              src.sourceConfig,\n              src.isFlat,\n            );\n          }\n        }\n      }\n\n      // Register dynamically discovered bindings\n      if (result.bindings) {\n        for (const binding of result.bindings) {\n          bindScopes(currentState.registry, binding.browseScope, binding.searchScope);\n        }\n      }\n\n      // Update fetch state\n      const currentMeta = (fetchState.meta as FetchMetadata) || {};\n      // Advance the server-side offset by the rows the source consumed, which\n      // exceeds `items.length` whenever a source drops rows after fetching.\n      const consumed = result.pagination?.consumedCount ?? result.items.length;\n      const newValidated = (currentMeta.validatedCount || 0) + consumed;\n\n      updateFetchState(\n        currentState.registry,\n        scopeId,\n        query,\n        {\n          isFetching: false,\n          hasNextPage: result.pagination?.hasMore ?? false,\n          error: null,\n          meta: {\n            ...currentMeta,\n            ...result.meta,\n            validatedCount: newValidated,\n            fetchAttempts: (currentMeta.fetchAttempts || 0) + 1,\n            errorAttempts: 0,\n          },\n        },\n        parentScopeId,\n      );\n\n      // Trigger re-render\n      store.setState((prev) => ({ ...prev }));\n    })\n    .catch((error) => {\n      const currentState = store.state;\n      const currentMeta = (fetchState.meta as FetchMetadata) || {};\n      const errorAttempts = ((currentMeta.errorAttempts as number) || 0) + 1;\n      const retriable = errorAttempts < MAX_ERROR_RETRIES;\n\n      // Retriable failures are a warning on the bus; the final one is an\n      // error and also lands in the scope's fetch state below.\n      if (retriable) {\n        athenaDiagnostics.emit(\"mentions.fetch.error\", {\n          level: \"warn\",\n          data: {\n            scopeId,\n            attempt: errorAttempts,\n            retriable,\n            error: error instanceof Error ? error.message : String(error),\n          },\n        });\n      } else {\n        athenaDiagnostics.error(\n          \"mentions.fetch.error\",\n          error,\n          { code: \"mentions_fetch_failed\", message: `Mention suggestions failed for ${scopeId}` },\n          { scopeId, attempt: errorAttempts, retriable },\n        );\n      }\n\n      updateFetchState(\n        currentState.registry,\n        scopeId,\n        query,\n        {\n          isFetching: false,\n          hasNextPage: retriable,\n          error: retriable\n            ? null\n            : error instanceof Error\n              ? error\n              : new Error(String(error)),\n          meta: { ...currentMeta, errorAttempts },\n        },\n        parentScopeId,\n      );\n\n      store.setState((prev) => ({ ...prev }));\n    });\n}\n"],"names":[],"mappings":"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"}

package/dist/chat-ui/mentions/suggestions/data/scope-registry.cjs

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function createScopeRegistry() {
+  return {
+    entries: {},
+    scopeBindings: /* @__PURE__ */ new Map()
+  };
+}
+function registerSource(registry, scope, sourceFn, sourceConfig = {}, isFlat2 = false) {
+  registry.entries[scope] = {
+    scope,
+    sourceFn,
+    sourceConfig,
+    fetchStates: {},
+    // Empty until first query
+    isFlat: isFlat2
+  };
+}
+function getEntry(registry, scope, parentScope) {
+  if (registry.entries[scope]) {
+    return registry.entries[scope];
+  }
+  if (parentScope) {
+    const parentEntry = getEntry(registry, parentScope);
+    const childEntry = {
+      scope,
+      sourceFn: parentEntry.sourceFn,
+      sourceConfig: parentEntry.sourceConfig,
+      // Same config as parent
+      fetchStates: {},
+      // Fresh fetch states for this scope
+      isFlat: parentEntry.isFlat
+      // Inherit flat mode
+    };
+    return childEntry;
+  }
+  throw new Error(`No Source registered for scope: ${scope} (and no parent to inherit from)`);
+}
+function getFetchState(registry, scope, query, parentScope) {
+  const entry = getEntry(registry, scope, parentScope);
+  const queryKey = query || "*";
+  return entry.fetchStates[queryKey] ?? {
+    isFetching: false,
+    hasNextPage: true,
+    // Assume yes until proven otherwise
+    fetchNext: null,
+    error: null,
+    // No error initially
+    meta: null
+    // Source will initialize this
+  };
+}
+function updateFetchState(registry, scope, query, updates, parentScope) {
+  const virtualEntry = getEntry(registry, scope, parentScope);
+  if (!registry.entries[scope]) {
+    registry.entries[scope] = {
+      scope,
+      sourceFn: virtualEntry.sourceFn,
+      sourceConfig: virtualEntry.sourceConfig,
+      fetchStates: {},
+      isFlat: virtualEntry.isFlat
+      // Inherit flat mode from parent
+    };
+  }
+  const entry = registry.entries[scope];
+  const queryKey = query || "*";
+  if (!entry.fetchStates[queryKey]) {
+    entry.fetchStates[queryKey] = {
+      isFetching: false,
+      hasNextPage: true,
+      fetchNext: null,
+      error: null,
+      meta: null
+    };
+  }
+  Object.assign(entry.fetchStates[queryKey], updates);
+}
+function bindScopes(registry, browseScope, searchScope) {
+  registry.scopeBindings.set(browseScope, searchScope);
+}
+function getSearchScope(registry, browseScope) {
+  return registry.scopeBindings.get(browseScope) || null;
+}
+exports.bindScopes = bindScopes;
+exports.createScopeRegistry = createScopeRegistry;
+exports.getEntry = getEntry;
+exports.getFetchState = getFetchState;
+exports.getSearchScope = getSearchScope;
+exports.registerSource = registerSource;
+exports.updateFetchState = updateFetchState;
+//# sourceMappingURL=scope-registry.cjs.map

package/dist/chat-ui/mentions/suggestions/data/scope-registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-registry.cjs","sources":["../../../../../src/chat-ui/mentions/suggestions/data/scope-registry.ts"],"sourcesContent":["import { clearByScope, type ItemCache } from './item-cache';\nimport type { FetchState, MenuScope, SourceFn } from './types';\n\n/**\n * Scope Registry\n *\n * Plain object + pure functions for managing source functions.\n * Each scope has a source function, config, and fetch state per query.\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Scope registry entry - per menu scope\n * Stores source function, config, and fetch state per query\n */\nexport interface ScopeRegistryEntry {\n  scope: MenuScope;\n  sourceFn: SourceFn;\n  sourceConfig: any; // Source-specific configuration (can include getters!)\n\n  // Fetch state per query text\n  // Key: \"*\" = browsing (no query), \"searchText\" = specific search query\n  fetchStates: Record<string, FetchState>;\n\n  // Flat list mode: if true, items don't get navigatesToScope\n  // Use for scopes that should show all items at once (e.g., Folders)\n  isFlat?: boolean;\n}\n\n/**\n * Scope registry - plain object\n * Maps MenuScope → ScopeRegistryEntry\n */\nexport interface ScopeRegistry {\n  entries: Record<MenuScope, ScopeRegistryEntry>;\n  // Scope bindings: browse scope → search scope\n  // When a scope has a query, UI switches to the search scope\n  // Example: 'root' + query → 'global_search'\n  scopeBindings: Map<MenuScope, MenuScope>;\n}\n\n// ============================================================================\n// Utils\n// ============================================================================\n\n/**\n * Create empty registry\n */\nexport function createScopeRegistry(): ScopeRegistry {\n  return {\n    entries: {},\n    scopeBindings: new Map(),\n  };\n}\n\n/**\n * Register a source function for a specific scope\n * Creates full entry immediately with empty fetchStates\n *\n * @param registry - Registry to mutate\n * @param scope - Scope identifier\n * @param sourceFn - Pure function to fetch/transform items\n * @param sourceConfig - Any configuration the source function needs (can include getters!)\n * @param isFlat - If true, items won't get navigatesToScope (flat list, no hierarchy)\n */\nexport function registerSource(\n  registry: ScopeRegistry,\n  scope: MenuScope,\n  sourceFn: SourceFn,\n  sourceConfig: any = {},\n  isFlat: boolean = false\n): void {\n  registry.entries[scope] = {\n    scope,\n    sourceFn,\n    sourceConfig,\n    fetchStates: {}, // Empty until first query\n    isFlat,\n  };\n}\n\n/**\n * Unregister a source (cleanup)\n */\nexport function unregisterSource(registry: ScopeRegistry, scope: MenuScope): void {\n  delete registry.entries[scope];\n}\n\n/**\n * Get or create entry for scope\n * Auto-inherits source function from parent if not explicitly registered\n *\n * @param registry - Registry to read/mutate\n * @param scope - Scope to get entry for\n * @param parentScope - Optional parent scope (for inheritance)\n * @returns Entry (may be newly created)\n */\nexport function getEntry(\n  registry: ScopeRegistry,\n  scope: MenuScope,\n  parentScope?: MenuScope\n): ScopeRegistryEntry {\n  // Check if already exists\n  if (registry.entries[scope]) {\n    return registry.entries[scope];\n  }\n\n  // Not registered - try to inherit from parent\n  if (parentScope) {\n    const parentEntry = getEntry(registry, parentScope);\n\n    // Create child entry with inherited sourceFn + sourceConfig + isFlat\n    const childEntry: ScopeRegistryEntry = {\n      scope,\n      sourceFn: parentEntry.sourceFn,\n      sourceConfig: parentEntry.sourceConfig, // Same config as parent\n      fetchStates: {}, // Fresh fetch states for this scope\n      isFlat: parentEntry.isFlat, // Inherit flat mode\n    };\n\n    // DON'T store it - return virtual entry (store is frozen during reads!)\n    return childEntry;\n  }\n\n  throw new Error(`No Source registered for scope: ${scope} (and no parent to inherit from)`);\n}\n\n/**\n * Get fetch state for a specific scope + query combination\n * Returns a default FetchState if not found\n */\nexport function getFetchState(\n  registry: ScopeRegistry,\n  scope: MenuScope,\n  query: string,\n  parentScope?: MenuScope\n): FetchState {\n  const entry = getEntry(registry, scope, parentScope);\n  const queryKey = query || '*'; // '*' = browsing (no query)\n\n  // Return existing fetch state, or a default one\n  return (\n    entry.fetchStates[queryKey] ?? {\n      isFetching: false,\n      hasNextPage: true, // Assume yes until proven otherwise\n      fetchNext: null,\n      error: null, // No error initially\n      meta: null, // Source will initialize this\n    }\n  );\n}\n\n/**\n * Update fetch state (mutates registry - use inside updateWithImmer!)\n * Ensures the entry exists in the registry before updating\n */\nexport function updateFetchState(\n  registry: ScopeRegistry,\n  scope: MenuScope,\n  query: string,\n  updates: Partial<FetchState>,\n  parentScope?: MenuScope\n): void {\n  // Get entry (may be virtual if inherited)\n  const virtualEntry = getEntry(registry, scope, parentScope);\n\n  // Ensure the entry is actually stored in the registry\n  if (!registry.entries[scope]) {\n    registry.entries[scope] = {\n      scope,\n      sourceFn: virtualEntry.sourceFn,\n      sourceConfig: virtualEntry.sourceConfig,\n      fetchStates: {},\n      isFlat: virtualEntry.isFlat, // Inherit flat mode from parent\n    };\n  }\n\n  const entry = registry.entries[scope];\n  const queryKey = query || '*';\n\n  // Ensure fetch state entry exists\n  if (!entry.fetchStates[queryKey]) {\n    entry.fetchStates[queryKey] = {\n      isFetching: false,\n      hasNextPage: true,\n      fetchNext: null,\n      error: null,\n      meta: null,\n    };\n  }\n\n  // Apply updates\n  Object.assign(entry.fetchStates[queryKey], updates);\n}\n\n/**\n * Invalidate a scope - removes scope from items and resets fetch states\n * Use when dynamic data changes (e.g., workspace members updated, tabs closed)\n *\n * Items lose this scope but stay in cache if they have other scopes.\n * Only removes items completely if they have no scopes left.\n *\n * @param registry - Registry to mutate\n * @param cache - Cache to mutate (imported type from item-cache)\n * @param scope - Scope to invalidate\n */\nexport function invalidateScope(registry: ScopeRegistry, cache: ItemCache, scope: MenuScope): void {\n  if (cache.items) {\n    clearByScope(cache, scope);\n  }\n\n  // Reset fetch states for this scope (force refetch)\n  if (registry.entries[scope]) {\n    registry.entries[scope].fetchStates = {}; // Clear all fetch state\n  }\n}\n\n/**\n * Bind two scopes: browse scope → search scope\n * When user types a query in the browse scope, UI switches to search scope\n *\n * Example:\n *   bindScopes(registry, 'root', 'global_search')\n *   → Typing in root scope switches to global_search\n *\n * @param registry - Registry to mutate\n * @param browseScope - The scope shown when browsing (no query)\n * @param searchScope - The scope shown when searching (has query)\n */\nexport function bindScopes(\n  registry: ScopeRegistry,\n  browseScope: MenuScope,\n  searchScope: MenuScope\n): void {\n  registry.scopeBindings.set(browseScope, searchScope);\n}\n\n/**\n * Get the search scope for a browse scope (if bound)\n * Returns null if no binding exists\n *\n * @param registry - Registry to read\n * @param browseScope - The scope to check\n * @returns Search scope or null\n */\nexport function getSearchScope(registry: ScopeRegistry, browseScope: MenuScope): MenuScope | null {\n  return registry.scopeBindings.get(browseScope) || null;\n}\n\n/**\n * Check if a scope is configured as flat (no hierarchy)\n * Returns false if scope not found (safe default = hierarchical)\n */\nexport function isFlat(registry: ScopeRegistry, scope: MenuScope): boolean {\n  const entry = registry.entries[scope];\n  return entry?.isFlat || false;\n}\n"],"names":["isFlat"],"mappings":";;AAmDO,SAAS,sBAAqC;AACnD,SAAO;AAAA,IACL,SAAS,CAAA;AAAA,IACT,mCAAmB,IAAA;AAAA,EAAI;AAE3B;AAYO,SAAS,eACd,UACA,OACA,UACA,eAAoB,CAAA,GACpBA,UAAkB,OACZ;AACN,WAAS,QAAQ,KAAK,IAAI;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa,CAAA;AAAA;AAAA,IACb,QAAAA;AAAAA,EAAA;AAEJ;AAkBO,SAAS,SACd,UACA,OACA,aACoB;AAEpB,MAAI,SAAS,QAAQ,KAAK,GAAG;AAC3B,WAAO,SAAS,QAAQ,KAAK;AAAA,EAC/B;AAGA,MAAI,aAAa;AACf,UAAM,cAAc,SAAS,UAAU,WAAW;AAGlD,UAAM,aAAiC;AAAA,MACrC;AAAA,MACA,UAAU,YAAY;AAAA,MACtB,cAAc,YAAY;AAAA;AAAA,MAC1B,aAAa,CAAA;AAAA;AAAA,MACb,QAAQ,YAAY;AAAA;AAAA,IAAA;AAItB,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,mCAAmC,KAAK,kCAAkC;AAC5F;AAMO,SAAS,cACd,UACA,OACA,OACA,aACY;AACZ,QAAM,QAAQ,SAAS,UAAU,OAAO,WAAW;AACnD,QAAM,WAAW,SAAS;AAG1B,SACE,MAAM,YAAY,QAAQ,KAAK;AAAA,IAC7B,YAAY;AAAA,IACZ,aAAa;AAAA;AAAA,IACb,WAAW;AAAA,IACX,OAAO;AAAA;AAAA,IACP,MAAM;AAAA;AAAA,EAAA;AAGZ;AAMO,SAAS,iBACd,UACA,OACA,OACA,SACA,aACM;AAEN,QAAM,eAAe,SAAS,UAAU,OAAO,WAAW;AAG1D,MAAI,CAAC,SAAS,QAAQ,KAAK,GAAG;AAC5B,aAAS,QAAQ,KAAK,IAAI;AAAA,MACxB;AAAA,MACA,UAAU,aAAa;AAAA,MACvB,cAAc,aAAa;AAAA,MAC3B,aAAa,CAAA;AAAA,MACb,QAAQ,aAAa;AAAA;AAAA,IAAA;AAAA,EAEzB;AAEA,QAAM,QAAQ,SAAS,QAAQ,KAAK;AACpC,QAAM,WAAW,SAAS;AAG1B,MAAI,CAAC,MAAM,YAAY,QAAQ,GAAG;AAChC,UAAM,YAAY,QAAQ,IAAI;AAAA,MAC5B,YAAY;AAAA,MACZ,aAAa;AAAA,MACb,WAAW;AAAA,MACX,OAAO;AAAA,MACP,MAAM;AAAA,IAAA;AAAA,EAEV;AAGA,SAAO,OAAO,MAAM,YAAY,QAAQ,GAAG,OAAO;AACpD;AAoCO,SAAS,WACd,UACA,aACA,aACM;AACN,WAAS,cAAc,IAAI,aAAa,WAAW;AACrD;AAUO,SAAS,eAAe,UAAyB,aAA0C;AAChG,SAAO,SAAS,cAAc,IAAI,WAAW,KAAK;AACpD;;;;;;;;"}

package/dist/chat-ui/mentions/suggestions/data/scope-registry.js

@@ -0,0 +1,91 @@
+function createScopeRegistry() {
+  return {
+    entries: {},
+    scopeBindings: /* @__PURE__ */ new Map()
+  };
+}
+function registerSource(registry, scope, sourceFn, sourceConfig = {}, isFlat2 = false) {
+  registry.entries[scope] = {
+    scope,
+    sourceFn,
+    sourceConfig,
+    fetchStates: {},
+    // Empty until first query
+    isFlat: isFlat2
+  };
+}
+function getEntry(registry, scope, parentScope) {
+  if (registry.entries[scope]) {
+    return registry.entries[scope];
+  }
+  if (parentScope) {
+    const parentEntry = getEntry(registry, parentScope);
+    const childEntry = {
+      scope,
+      sourceFn: parentEntry.sourceFn,
+      sourceConfig: parentEntry.sourceConfig,
+      // Same config as parent
+      fetchStates: {},
+      // Fresh fetch states for this scope
+      isFlat: parentEntry.isFlat
+      // Inherit flat mode
+    };
+    return childEntry;
+  }
+  throw new Error(`No Source registered for scope: ${scope} (and no parent to inherit from)`);
+}
+function getFetchState(registry, scope, query, parentScope) {
+  const entry = getEntry(registry, scope, parentScope);
+  const queryKey = query || "*";
+  return entry.fetchStates[queryKey] ?? {
+    isFetching: false,
+    hasNextPage: true,
+    // Assume yes until proven otherwise
+    fetchNext: null,
+    error: null,
+    // No error initially
+    meta: null
+    // Source will initialize this
+  };
+}
+function updateFetchState(registry, scope, query, updates, parentScope) {
+  const virtualEntry = getEntry(registry, scope, parentScope);
+  if (!registry.entries[scope]) {
+    registry.entries[scope] = {
+      scope,
+      sourceFn: virtualEntry.sourceFn,
+      sourceConfig: virtualEntry.sourceConfig,
+      fetchStates: {},
+      isFlat: virtualEntry.isFlat
+      // Inherit flat mode from parent
+    };
+  }
+  const entry = registry.entries[scope];
+  const queryKey = query || "*";
+  if (!entry.fetchStates[queryKey]) {
+    entry.fetchStates[queryKey] = {
+      isFetching: false,
+      hasNextPage: true,
+      fetchNext: null,
+      error: null,
+      meta: null
+    };
+  }
+  Object.assign(entry.fetchStates[queryKey], updates);
+}
+function bindScopes(registry, browseScope, searchScope) {
+  registry.scopeBindings.set(browseScope, searchScope);
+}
+function getSearchScope(registry, browseScope) {
+  return registry.scopeBindings.get(browseScope) || null;
+}
+export {
+  bindScopes,
+  createScopeRegistry,
+  getEntry,
+  getFetchState,
+  getSearchScope,
+  registerSource,
+  updateFetchState
+};
+//# sourceMappingURL=scope-registry.js.map

package/dist/chat-ui/mentions/suggestions/data/scope-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-registry.js","sources":["../../../../../src/chat-ui/mentions/suggestions/data/scope-registry.ts"],"sourcesContent":["import { clearByScope, type ItemCache } from './item-cache';\nimport type { FetchState, MenuScope, SourceFn } from './types';\n\n/**\n * Scope Registry\n *\n * Plain object + pure functions for managing source functions.\n * Each scope has a source function, config, and fetch state per query.\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Scope registry entry - per menu scope\n * Stores source function, config, and fetch state per query\n */\nexport interface ScopeRegistryEntry {\n  scope: MenuScope;\n  sourceFn: SourceFn;\n  sourceConfig: any; // Source-specific configuration (can include getters!)\n\n  // Fetch state per query text\n  // Key: \"*\" = browsing (no query), \"searchText\" = specific search query\n  fetchStates: Record<string, FetchState>;\n\n  // Flat list mode: if true, items don't get navigatesToScope\n  // Use for scopes that should show all items at once (e.g., Folders)\n  isFlat?: boolean;\n}\n\n/**\n * Scope registry - plain object\n * Maps MenuScope → ScopeRegistryEntry\n */\nexport interface ScopeRegistry {\n  entries: Record<MenuScope, ScopeRegistryEntry>;\n  // Scope bindings: browse scope → search scope\n  // When a scope has a query, UI switches to the search scope\n  // Example: 'root' + query → 'global_search'\n  scopeBindings: Map<MenuScope, MenuScope>;\n}\n\n// ============================================================================\n// Utils\n// ============================================================================\n\n/**\n * Create empty registry\n */\nexport function createScopeRegistry(): ScopeRegistry {\n  return {\n    entries: {},\n    scopeBindings: new Map(),\n  };\n}\n\n/**\n * Register a source function for a specific scope\n * Creates full entry immediately with empty fetchStates\n *\n * @param registry - Registry to mutate\n * @param scope - Scope identifier\n * @param sourceFn - Pure function to fetch/transform items\n * @param sourceConfig - Any configuration the source function needs (can include getters!)\n * @param isFlat - If true, items won't get navigatesToScope (flat list, no hierarchy)\n */\nexport function registerSource(\n  registry: ScopeRegistry,\n  scope: MenuScope,\n  sourceFn: SourceFn,\n  sourceConfig: any = {},\n  isFlat: boolean = false\n): void {\n  registry.entries[scope] = {\n    scope,\n    sourceFn,\n    sourceConfig,\n    fetchStates: {}, // Empty until first query\n    isFlat,\n  };\n}\n\n/**\n * Unregister a source (cleanup)\n */\nexport function unregisterSource(registry: ScopeRegistry, scope: MenuScope): void {\n  delete registry.entries[scope];\n}\n\n/**\n * Get or create entry for scope\n * Auto-inherits source function from parent if not explicitly registered\n *\n * @param registry - Registry to read/mutate\n * @param scope - Scope to get entry for\n * @param parentScope - Optional parent scope (for inheritance)\n * @returns Entry (may be newly created)\n */\nexport function getEntry(\n  registry: ScopeRegistry,\n  scope: MenuScope,\n  parentScope?: MenuScope\n): ScopeRegistryEntry {\n  // Check if already exists\n  if (registry.entries[scope]) {\n    return registry.entries[scope];\n  }\n\n  // Not registered - try to inherit from parent\n  if (parentScope) {\n    const parentEntry = getEntry(registry, parentScope);\n\n    // Create child entry with inherited sourceFn + sourceConfig + isFlat\n    const childEntry: ScopeRegistryEntry = {\n      scope,\n      sourceFn: parentEntry.sourceFn,\n      sourceConfig: parentEntry.sourceConfig, // Same config as parent\n      fetchStates: {}, // Fresh fetch states for this scope\n      isFlat: parentEntry.isFlat, // Inherit flat mode\n    };\n\n    // DON'T store it - return virtual entry (store is frozen during reads!)\n    return childEntry;\n  }\n\n  throw new Error(`No Source registered for scope: ${scope} (and no parent to inherit from)`);\n}\n\n/**\n * Get fetch state for a specific scope + query combination\n * Returns a default FetchState if not found\n */\nexport function getFetchState(\n  registry: ScopeRegistry,\n  scope: MenuScope,\n  query: string,\n  parentScope?: MenuScope\n): FetchState {\n  const entry = getEntry(registry, scope, parentScope);\n  const queryKey = query || '*'; // '*' = browsing (no query)\n\n  // Return existing fetch state, or a default one\n  return (\n    entry.fetchStates[queryKey] ?? {\n      isFetching: false,\n      hasNextPage: true, // Assume yes until proven otherwise\n      fetchNext: null,\n      error: null, // No error initially\n      meta: null, // Source will initialize this\n    }\n  );\n}\n\n/**\n * Update fetch state (mutates registry - use inside updateWithImmer!)\n * Ensures the entry exists in the registry before updating\n */\nexport function updateFetchState(\n  registry: ScopeRegistry,\n  scope: MenuScope,\n  query: string,\n  updates: Partial<FetchState>,\n  parentScope?: MenuScope\n): void {\n  // Get entry (may be virtual if inherited)\n  const virtualEntry = getEntry(registry, scope, parentScope);\n\n  // Ensure the entry is actually stored in the registry\n  if (!registry.entries[scope]) {\n    registry.entries[scope] = {\n      scope,\n      sourceFn: virtualEntry.sourceFn,\n      sourceConfig: virtualEntry.sourceConfig,\n      fetchStates: {},\n      isFlat: virtualEntry.isFlat, // Inherit flat mode from parent\n    };\n  }\n\n  const entry = registry.entries[scope];\n  const queryKey = query || '*';\n\n  // Ensure fetch state entry exists\n  if (!entry.fetchStates[queryKey]) {\n    entry.fetchStates[queryKey] = {\n      isFetching: false,\n      hasNextPage: true,\n      fetchNext: null,\n      error: null,\n      meta: null,\n    };\n  }\n\n  // Apply updates\n  Object.assign(entry.fetchStates[queryKey], updates);\n}\n\n/**\n * Invalidate a scope - removes scope from items and resets fetch states\n * Use when dynamic data changes (e.g., workspace members updated, tabs closed)\n *\n * Items lose this scope but stay in cache if they have other scopes.\n * Only removes items completely if they have no scopes left.\n *\n * @param registry - Registry to mutate\n * @param cache - Cache to mutate (imported type from item-cache)\n * @param scope - Scope to invalidate\n */\nexport function invalidateScope(registry: ScopeRegistry, cache: ItemCache, scope: MenuScope): void {\n  if (cache.items) {\n    clearByScope(cache, scope);\n  }\n\n  // Reset fetch states for this scope (force refetch)\n  if (registry.entries[scope]) {\n    registry.entries[scope].fetchStates = {}; // Clear all fetch state\n  }\n}\n\n/**\n * Bind two scopes: browse scope → search scope\n * When user types a query in the browse scope, UI switches to search scope\n *\n * Example:\n *   bindScopes(registry, 'root', 'global_search')\n *   → Typing in root scope switches to global_search\n *\n * @param registry - Registry to mutate\n * @param browseScope - The scope shown when browsing (no query)\n * @param searchScope - The scope shown when searching (has query)\n */\nexport function bindScopes(\n  registry: ScopeRegistry,\n  browseScope: MenuScope,\n  searchScope: MenuScope\n): void {\n  registry.scopeBindings.set(browseScope, searchScope);\n}\n\n/**\n * Get the search scope for a browse scope (if bound)\n * Returns null if no binding exists\n *\n * @param registry - Registry to read\n * @param browseScope - The scope to check\n * @returns Search scope or null\n */\nexport function getSearchScope(registry: ScopeRegistry, browseScope: MenuScope): MenuScope | null {\n  return registry.scopeBindings.get(browseScope) || null;\n}\n\n/**\n * Check if a scope is configured as flat (no hierarchy)\n * Returns false if scope not found (safe default = hierarchical)\n */\nexport function isFlat(registry: ScopeRegistry, scope: MenuScope): boolean {\n  const entry = registry.entries[scope];\n  return entry?.isFlat || false;\n}\n"],"names":["isFlat"],"mappings":"AAmDO,SAAS,sBAAqC;AACnD,SAAO;AAAA,IACL,SAAS,CAAA;AAAA,IACT,mCAAmB,IAAA;AAAA,EAAI;AAE3B;AAYO,SAAS,eACd,UACA,OACA,UACA,eAAoB,CAAA,GACpBA,UAAkB,OACZ;AACN,WAAS,QAAQ,KAAK,IAAI;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa,CAAA;AAAA;AAAA,IACb,QAAAA;AAAAA,EAAA;AAEJ;AAkBO,SAAS,SACd,UACA,OACA,aACoB;AAEpB,MAAI,SAAS,QAAQ,KAAK,GAAG;AAC3B,WAAO,SAAS,QAAQ,KAAK;AAAA,EAC/B;AAGA,MAAI,aAAa;AACf,UAAM,cAAc,SAAS,UAAU,WAAW;AAGlD,UAAM,aAAiC;AAAA,MACrC;AAAA,MACA,UAAU,YAAY;AAAA,MACtB,cAAc,YAAY;AAAA;AAAA,MAC1B,aAAa,CAAA;AAAA;AAAA,MACb,QAAQ,YAAY;AAAA;AAAA,IAAA;AAItB,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,mCAAmC,KAAK,kCAAkC;AAC5F;AAMO,SAAS,cACd,UACA,OACA,OACA,aACY;AACZ,QAAM,QAAQ,SAAS,UAAU,OAAO,WAAW;AACnD,QAAM,WAAW,SAAS;AAG1B,SACE,MAAM,YAAY,QAAQ,KAAK;AAAA,IAC7B,YAAY;AAAA,IACZ,aAAa;AAAA;AAAA,IACb,WAAW;AAAA,IACX,OAAO;AAAA;AAAA,IACP,MAAM;AAAA;AAAA,EAAA;AAGZ;AAMO,SAAS,iBACd,UACA,OACA,OACA,SACA,aACM;AAEN,QAAM,eAAe,SAAS,UAAU,OAAO,WAAW;AAG1D,MAAI,CAAC,SAAS,QAAQ,KAAK,GAAG;AAC5B,aAAS,QAAQ,KAAK,IAAI;AAAA,MACxB;AAAA,MACA,UAAU,aAAa;AAAA,MACvB,cAAc,aAAa;AAAA,MAC3B,aAAa,CAAA;AAAA,MACb,QAAQ,aAAa;AAAA;AAAA,IAAA;AAAA,EAEzB;AAEA,QAAM,QAAQ,SAAS,QAAQ,KAAK;AACpC,QAAM,WAAW,SAAS;AAG1B,MAAI,CAAC,MAAM,YAAY,QAAQ,GAAG;AAChC,UAAM,YAAY,QAAQ,IAAI;AAAA,MAC5B,YAAY;AAAA,MACZ,aAAa;AAAA,MACb,WAAW;AAAA,MACX,OAAO;AAAA,MACP,MAAM;AAAA,IAAA;AAAA,EAEV;AAGA,SAAO,OAAO,MAAM,YAAY,QAAQ,GAAG,OAAO;AACpD;AAoCO,SAAS,WACd,UACA,aACA,aACM;AACN,WAAS,cAAc,IAAI,aAAa,WAAW;AACrD;AAUO,SAAS,eAAe,UAAyB,aAA0C;AAChG,SAAO,SAAS,cAAc,IAAI,WAAW,KAAK;AACpD;"}