stream-chat-react 14.12.0 → 15.0.0-rc.1

package/dist/es/plugins/SlotLayout/ChatView.mjs

@@ -0,0 +1,277 @@
+import { useStateStore } from "../../store/hooks/useStateStore.mjs";
+import { requireContext } from "../../context/requireContext.mjs";
+import { useChatContext } from "../../context/ChatContext.mjs";
+import { DialogManagerProvider } from "../../context/DialogManagerContext.mjs";
+import { useTranslationContext } from "../../context/TranslationContext.mjs";
+import { Button } from "../../components/Button/Button.mjs";
+import { useStableId } from "../../components/UtilityComponents/useStableId.mjs";
+import { useComponentContextIcons } from "../../context/useComponentContextIcons.mjs";
+import { UnreadCountBadge } from "../../components/Threads/UnreadCountBadge.mjs";
+import { DEFAULT_CHAT_VIEW_A11Y_CONTEXT_VALUE, createChatViewA11yContextValue } from "./ChatView.a11y.utility.mjs";
+import { SlotRegistryContext, defaultSlotKindRegistry, renderSlotFromRegistry, resolveSlotKindRegistry } from "./slotRegistry.mjs";
+import { getLayoutViewState } from "./hooks/useLayoutViewState.mjs";
+import { ChatViewNavigationProvider } from "./ChatViewNavigationContext.mjs";
+import { WorkspaceNavigationAdapter } from "./workspaceNavigationAdapter.mjs";
+import { createChatViewSlotBinding, getChatViewEntityBinding } from "./slotBinding.mjs";
+import { WorkspaceLayout } from "./layout/WorkspaceLayout.mjs";
+import { LayoutController, createLayoutRuntimeState } from "./layoutController/LayoutController.mjs";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import clsx from "clsx";
+//#region src/plugins/SlotLayout/ChatView.tsx
+var ChatViewContext = createContext(void 0);
+var ChatViewA11yContext = createContext(DEFAULT_CHAT_VIEW_A11Y_CONTEXT_VALUE);
+var useChatViewContext = () => requireContext(useContext(ChatViewContext), "useChatViewContext", "ChatView");
+var activeViewSelector = ({ activeView }) => ({ activeView });
+var workspaceLayoutStateSelector = (state) => ({
+	activeView: state.activeView,
+	viewState: getLayoutViewState(state)
+});
+var DefaultSlotFallback = () => /* @__PURE__ */ jsx("div", {
+	className: "str-chat__chat-view__workspace-layout-slot-fallback",
+	children: "Select a channel to start messaging"
+});
+var resolveSlotFallbackComponent = ({ slot, SlotFallback, slotFallbackComponents }) => slotFallbackComponents?.[slot] ?? SlotFallback ?? DefaultSlotFallback;
+var BUILTIN_WORKSPACE_LAYOUT = "nav-rail-entity-list-workspace";
+var DEFAULT_LIST_BINDING_KEY = "list";
+var LIST_KIND_BY_LAYOUT = {
+	channels: "channelList",
+	threads: "threadList"
+};
+var buildDefaultLayoutDescriptors = (slots) => {
+	const seedSlot = slots[0];
+	return ["channels", "threads"].map((id) => ({
+		id,
+		initialBindings: seedSlot ? { [seedSlot]: {
+			key: DEFAULT_LIST_BINDING_KEY,
+			kind: LIST_KIND_BY_LAYOUT[id],
+			source: {}
+		} } : void 0,
+		slots
+	}));
+};
+var DEFAULT_SLOT_NAMES = ["slot1"];
+var DEFAULT_LAYOUT_DESCRIPTORS = buildDefaultLayoutDescriptors(DEFAULT_SLOT_NAMES);
+var seedLayoutsFromDescriptors = (descriptors) => descriptors.reduce((acc, descriptor) => {
+	const slotBindings = {};
+	Object.entries(descriptor.initialBindings ?? {}).forEach(([slot, entity]) => {
+		if (entity) slotBindings[slot] = createChatViewSlotBinding(entity);
+	});
+	acc[descriptor.id] = createLayoutRuntimeState({
+		availableSlots: descriptor.slots,
+		slotBindings,
+		slotNames: descriptor.slots
+	});
+	return acc;
+}, {});
+var ChatView = ({ children, deriveWorkspaceNavigation, dialogManagerId, duplicateEntityPolicy, entityInferrers = [], layout, layoutController, layouts: layoutsProp, resolveDuplicateEntity, SlotFallback, slotFallbackComponents, slotRenderers, viewActionSlotResolvers: viewActionSlotResolversProp, views }) => {
+	const { theme } = useChatContext();
+	const chatViewId = useStableId();
+	const a11yValue = useMemo(() => createChatViewA11yContextValue(chatViewId), [chatViewId]);
+	const [viewActionSlotResolvers, setViewActionSlotResolvers] = useState({});
+	const layoutDescriptors = layoutsProp ?? DEFAULT_LAYOUT_DESCRIPTORS;
+	const seedFromDescriptors = !!layoutsProp || layout === BUILTIN_WORKSPACE_LAYOUT || !!views;
+	const internalLayoutController = useMemo(() => new LayoutController({
+		duplicateEntityPolicy,
+		initialState: {
+			activeView: "channels",
+			layouts: seedFromDescriptors ? seedLayoutsFromDescriptors(layoutDescriptors) : { channels: createLayoutRuntimeState({
+				availableSlots: DEFAULT_SLOT_NAMES,
+				slotNames: DEFAULT_SLOT_NAMES
+			}) }
+		},
+		resolveDuplicateEntity
+	}), [
+		duplicateEntityPolicy,
+		layoutDescriptors,
+		resolveDuplicateEntity,
+		seedFromDescriptors
+	]);
+	const effectiveLayoutController = layoutController ?? internalLayoutController;
+	const { activeView } = useStateStore(effectiveLayoutController.state, activeViewSelector) ?? activeViewSelector(effectiveLayoutController.state.getLatestValue());
+	const setActiveView = useCallback((cv) => {
+		effectiveLayoutController.setActiveView(cv);
+	}, [effectiveLayoutController]);
+	const registerViewActionSlotResolvers = useCallback((view, resolvers) => {
+		setViewActionSlotResolvers((current) => {
+			if (current[view] === resolvers) return current;
+			const next = { ...current };
+			if (!resolvers) delete next[view];
+			else next[view] = resolvers;
+			return next;
+		});
+	}, []);
+	const resolveActionTargetSlot = useCallback((view, args) => viewActionSlotResolvers[view]?.[args.action]?.(args), [viewActionSlotResolvers]);
+	const value = useMemo(() => ({
+		activeView,
+		entityInferers: entityInferrers,
+		layoutController: effectiveLayoutController,
+		registerViewActionSlotResolvers,
+		resolveActionTargetSlot,
+		setActiveView
+	}), [
+		activeView,
+		effectiveLayoutController,
+		entityInferrers,
+		registerViewActionSlotResolvers,
+		resolveActionTargetSlot,
+		setActiveView
+	]);
+	useEffect(() => {
+		if (!viewActionSlotResolversProp) return;
+		const entries = Object.entries(viewActionSlotResolversProp);
+		entries.forEach(([view, resolvers]) => registerViewActionSlotResolvers(view, resolvers));
+		return () => {
+			entries.forEach(([view]) => registerViewActionSlotResolvers(view, void 0));
+		};
+	}, [registerViewActionSlotResolvers, viewActionSlotResolversProp]);
+	const { viewState } = useStateStore(effectiveLayoutController.state, workspaceLayoutStateSelector) ?? workspaceLayoutStateSelector(effectiveLayoutController.state.getLatestValue());
+	const slotKindRegistry = useMemo(() => resolveSlotKindRegistry(slotRenderers), [slotRenderers]);
+	const activeViewContent = views?.[activeView];
+	const content = views ? /* @__PURE__ */ jsxs(Fragment$1, { children: [children, activeViewContent != null && /* @__PURE__ */ jsx("div", {
+		className: `str-chat__chat-view__${activeView}`,
+		id: a11yValue.chatViewPanelIds[activeView],
+		children: activeViewContent
+	})] }) : layout === BUILTIN_WORKSPACE_LAYOUT ? (() => {
+		const slots = viewState.availableSlots.map((slot) => {
+			const content = renderSlotFromRegistry(getChatViewEntityBinding(viewState.slotBindings[slot]), slot, slotKindRegistry);
+			const Fallback = resolveSlotFallbackComponent({
+				slot,
+				SlotFallback,
+				slotFallbackComponents
+			});
+			return {
+				content: content ?? /* @__PURE__ */ jsx(Fallback, { slot }),
+				slot
+			};
+		});
+		return /* @__PURE__ */ jsx(WorkspaceLayout, {
+			navRail: /* @__PURE__ */ jsx(ChatViewSelector, {}),
+			slots
+		});
+	})() : children;
+	return /* @__PURE__ */ jsx(ChatViewA11yContext.Provider, {
+		value: a11yValue,
+		children: /* @__PURE__ */ jsx(ChatViewContext.Provider, {
+			value,
+			children: /* @__PURE__ */ jsx(SlotRegistryContext.Provider, {
+				value: slotKindRegistry,
+				children: /* @__PURE__ */ jsx(ChatViewNavigationProvider, { children: /* @__PURE__ */ jsx(WorkspaceNavigationAdapter, {
+					deriveWorkspaceNavigation,
+					children: /* @__PURE__ */ jsx("div", {
+						className: clsx("str-chat", theme, "str-chat__chat-view"),
+						children: /* @__PURE__ */ jsx(DialogManagerProvider, {
+							id: dialogManagerId,
+							children: content
+						})
+					})
+				}) })
+			})
+		})
+	});
+};
+var useActiveThread = ({ activeThread }) => {
+	useEffect(() => {
+		if (!activeThread) return;
+		const handleVisibilityChange = () => {
+			if (document.visibilityState === "visible" && document.hasFocus()) activeThread.activate();
+			if (document.visibilityState === "hidden" || !document.hasFocus()) activeThread.deactivate();
+		};
+		handleVisibilityChange();
+		window.addEventListener("focus", handleVisibilityChange);
+		window.addEventListener("blur", handleVisibilityChange);
+		return () => {
+			activeThread.deactivate();
+			window.removeEventListener("blur", handleVisibilityChange);
+			window.removeEventListener("focus", handleVisibilityChange);
+		};
+	}, [activeThread]);
+};
+var ChatViewSelectorButton = ({ ActiveIcon, children, className, Icon, iconOnly = true, isActive, text, ...props }) => {
+	const SelectorIcon = isActive && ActiveIcon ? ActiveIcon : Icon;
+	const shouldShowTooltip = !!text && iconOnly;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "str-chat__chat-view__selector-button-container",
+		children: [/* @__PURE__ */ jsxs(Button, {
+			appearance: "ghost",
+			"aria-current": isActive || void 0,
+			"aria-label": props["aria-label"] ?? (shouldShowTooltip ? text : void 0),
+			className: clsx("str-chat__chat-view__selector-button", className),
+			variant: "secondary",
+			...props,
+			children: [children ?? (SelectorIcon && /* @__PURE__ */ jsx(SelectorIcon, {})), !iconOnly && text && /* @__PURE__ */ jsx("div", {
+				className: "str-chat__chat-view__selector-button-text",
+				children: text
+			})]
+		}), shouldShowTooltip && /* @__PURE__ */ jsx("div", {
+			"aria-hidden": "true",
+			className: "str-chat__chat-view__selector-button-tooltip str-chat__tooltip",
+			children: text
+		})]
+	});
+};
+var unreadThreadCountSelector = ({ unreadThreadCount }) => ({ unreadThreadCount });
+var ChatViewChannelsSelectorButton = ({ iconOnly = true }) => {
+	const { IconMessageBubble, IconMessageBubbleFill } = useComponentContextIcons();
+	const { activeView, setActiveView } = useChatViewContext();
+	const { t } = useTranslationContext();
+	const isActive = activeView === "channels";
+	return /* @__PURE__ */ jsx(ChatViewSelectorButton, {
+		ActiveIcon: IconMessageBubbleFill,
+		"aria-label": t("slotLayout.chatView.openChannelsView.ariaLabel", "Open channels view"),
+		Icon: IconMessageBubble,
+		iconOnly,
+		isActive,
+		onClick: () => setActiveView("channels"),
+		onPointerDown: () => setActiveView("channels"),
+		text: t("slotLayout.chatView.channels.text", "Channels")
+	});
+};
+var ChatViewThreadsSelectorButton = ({ iconOnly = true }) => {
+	const { IconThread, IconThreadFill } = useComponentContextIcons();
+	const { client } = useChatContext();
+	const { unreadThreadCount } = useStateStore(client.threads.state, unreadThreadCountSelector) ?? { unreadThreadCount: 0 };
+	const { activeView, setActiveView } = useChatViewContext();
+	const { t } = useTranslationContext();
+	const isActive = activeView === "threads";
+	return /* @__PURE__ */ jsx(ChatViewSelectorButton, {
+		ActiveIcon: IconThreadFill,
+		"aria-label": unreadThreadCount > 0 ? t("slotLayout.chatView.openThreadsViewUnread.ariaLabel", {
+			count: unreadThreadCount,
+			defaultValue_one: "Open threads view, {{ count }} unread thread",
+			defaultValue_other: "Open threads view, {{ count }} unread threads"
+		}) : t("slotLayout.chatView.openThreadsView.ariaLabel", "Open threads view"),
+		Icon: IconThread,
+		iconOnly,
+		isActive,
+		onClick: () => setActiveView("threads"),
+		onPointerDown: () => setActiveView("threads"),
+		text: t("common.threads.text", "Threads"),
+		children: /* @__PURE__ */ jsx(UnreadCountBadge, {
+			count: unreadThreadCount,
+			position: "top-right",
+			children: isActive ? /* @__PURE__ */ jsx(IconThreadFill, {}) : /* @__PURE__ */ jsx(IconThread, {})
+		})
+	});
+};
+var defaultChatViewSelectorItemSet = [{
+	Component: ChatViewChannelsSelectorButton,
+	type: "channels"
+}, {
+	Component: ChatViewThreadsSelectorButton,
+	type: "threads"
+}];
+var ChatViewSelector = ({ iconOnly = true, itemSet = defaultChatViewSelectorItemSet }) => {
+	const { t } = useTranslationContext();
+	return /* @__PURE__ */ jsx("div", {
+		"aria-label": t("slotLayout.chatView.chatViewControls.ariaLabel", "Chat view controls"),
+		className: "str-chat__chat-view__selector",
+		role: "navigation",
+		children: itemSet.map(({ Component, type }) => /* @__PURE__ */ jsx(Component, { iconOnly }, type))
+	});
+};
+ChatView.Selector = ChatViewSelector;
+//#endregion
+export { ChatView, ChatViewChannelsSelectorButton, ChatViewContext, ChatViewSelectorButton, ChatViewThreadsSelectorButton, createChatViewSlotBinding, defaultChatViewSelectorItemSet, defaultSlotKindRegistry, getChatViewEntityBinding, useActiveThread, useChatViewContext };
+
+//# sourceMappingURL=ChatView.mjs.map

package/dist/es/plugins/SlotLayout/ChatView.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatView.mjs","names":[],"sources":["../../../../src/plugins/SlotLayout/ChatView.tsx"],"sourcesContent":["import clsx from 'clsx';\nimport React, {\n  type ComponentType,\n  createContext,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react';\nimport { useStableId } from '../../components/UtilityComponents/useStableId';\n\nimport { Button, type ButtonProps } from '../../components/Button';\nimport { UnreadCountBadge } from '../../components/Threads/UnreadCountBadge';\nimport {\n  DialogManagerProvider,\n  useChatContext,\n  useComponentContextIcons,\n  useTranslationContext,\n} from '../../context';\nimport { useStateStore } from '../../store';\n// MERGE-RECONCILE: this file keeps PR #2909's slot/layout navigation architecture\n// (LayoutController / WorkspaceLayout / ChatViewNavigationProvider, context shape\n// activeView/setActiveView/layoutController) as the base, and adopts release-v15's\n// navigation-landmark accessibility (ChatViewA11yContext with chatViewPanelIds only;\n// role=\"navigation\" + aria-current selector, no tab/tabpanel wiring) and Phosphor\n// icons (../Icons) on top. PR's `Icon` from '../Threads/icons' was removed and is\n// no longer imported. Reconcile if the layout navigation is later dropped in favor of the\n// simpler release-v15 ChatView.\nimport {\n  type ChatViewA11yContextValue,\n  createChatViewA11yContextValue,\n  DEFAULT_CHAT_VIEW_A11Y_CONTEXT_VALUE,\n} from './ChatView.a11y.utility';\nimport { ChatViewNavigationProvider } from './ChatViewNavigationContext';\nimport { WorkspaceNavigationAdapter } from './workspaceNavigationAdapter';\nimport type { DeriveWorkspaceNavigation } from './workspaceNavigationAdapter';\nimport { WorkspaceLayout } from './layout/WorkspaceLayout';\nimport {\n  createLayoutRuntimeState,\n  LayoutController as LayoutControllerClass,\n} from './layoutController/LayoutController';\nimport { createChatViewSlotBinding, getChatViewEntityBinding } from './slotBinding';\nimport {\n  renderSlotFromRegistry,\n  resolveSlotKindRegistry,\n  SlotRegistryContext,\n} from './slotRegistry';\n\nimport type { PropsWithChildren } from 'react';\nimport type { Thread, ThreadManagerState } from 'stream-chat';\nimport type {\n  ChatViewLayoutState,\n  DuplicateEntityPolicy,\n  LayoutController,\n  LayoutRuntimeState,\n  LayoutSlotBinding,\n  ResolveDuplicateEntity,\n  SlotName,\n} from './layoutController/layoutControllerTypes';\nimport type {\n  ChatViewEntityBinding,\n  ChatViewSlotFallbackProps,\n  ChatViewSlotRenderers,\n  LayoutDescriptor,\n} from './slotBinding';\nimport { getLayoutViewState } from './hooks';\nimport { requireContext } from '../../context/requireContext';\n\n// Re-export the binding primitives + renderer types from their leaf modules so\n// existing `stream-chat-react` imports keep resolving through ChatView.\nexport * from './slotBinding';\nexport type { SlotKindDefinition, SlotKindRegistry } from './slotRegistry';\nexport { defaultSlotKindRegistry } from './slotRegistry';\n\nexport type ChatView = 'channels' | 'threads';\n\n/**\n * ChatView switches between two independent surfaces, not panels in a single\n * WAI-ARIA Tabs widget. The selector is a navigation landmark\n * (`role=\"navigation\"`) holding one button per surface; the button for the\n * surface currently shown is marked with `aria-current=\"true\"` (the \"current\n * item in a set\" — not `\"page\"`, since this SDK view may be embedded in a larger\n * host UI that owns the page). View wrappers stay plain `<div>`s (id only, from\n * `chatViewPanelIds`) to avoid leaking ancestor context into descendants like\n * the composer textarea.\n */\n\n// Entity-binding primitives + per-kind renderer types live in the leaf module\n// `./slotBinding` (so the generic <Slot> and the renderer registry can consume\n// them without an import cycle). Re-exported here for back-compat.\nexport type ChatViewEntityInferer = {\n  kind: ChatViewEntityBinding['kind'];\n  match: (source: unknown) => boolean;\n  toBinding: (source: unknown) => ChatViewEntityBinding;\n};\n\nexport type ChatViewBuiltinLayout = 'nav-rail-entity-list-workspace';\n\nexport type ChatViewProps = PropsWithChildren<{\n  /**\n   * Optional id for the dialog manager ChatView hosts inside its `.str-chat` root. Dialogs\n   * opened by view content (context menus, member actions, …) resolve to this manager and\n   * their overlays render under `.str-chat`, so the SDK's `.str-chat`-scoped dialog CSS\n   * applies. Omit for a local (unregistered) manager.\n   */\n  /**\n   * Optionally override the {@link WorkspaceNavigation} the ChatView provides — e.g. make\n   * `openChannel`/`openThread` open beside the current content on ⌘/ctrl-click. Receives the\n   * SDK-derived navigation and returns only the members to override — the rest keep their default.\n   * Must be referentially stable.\n   */\n  deriveWorkspaceNavigation?: DeriveWorkspaceNavigation;\n  dialogManagerId?: string;\n  duplicateEntityPolicy?: DuplicateEntityPolicy;\n  entityInferrers?: ChatViewEntityInferer[];\n  layout?: ChatViewBuiltinLayout;\n  layoutController?: LayoutController;\n  layouts?: LayoutDescriptor[];\n  resolveDuplicateEntity?: ResolveDuplicateEntity;\n  SlotFallback?: ComponentType<ChatViewSlotFallbackProps>;\n  slotFallbackComponents?: Partial<\n    Record<string, ComponentType<ChatViewSlotFallbackProps>>\n  >;\n  slotRenderers?: ChatViewSlotRenderers;\n  /**\n   * Per-view content (D8). The active view's node is rendered inside an a11y tabpanel;\n   * that view's slot topology comes from the matching `layouts` descriptor, and\n   * `viewActionSlotResolvers[view]` (if any) is registered while it is active. Replaces\n   * the removed `ChatView.Channels`/`ChatView.Threads` gated components — the app writes\n   * one mapping instead of two hand-composed, activeView-gated trees.\n   */\n  views?: Partial<Record<ChatView, ReactNode>>;\n  /** Optional per-view navigation action slot resolvers. */\n  viewActionSlotResolvers?: Partial<Record<ChatView, ViewActionSlotResolvers>>;\n}>;\n\nexport type ChatViewNavigationAction = 'openChannel' | 'openThread';\n\nexport type ResolveViewActionTargetSlotArgs = {\n  action: ChatViewNavigationAction;\n  activeView: ChatView;\n  availableSlots: SlotName[];\n  requestedSlot?: SlotName;\n  slotBindings: Record<SlotName, LayoutSlotBinding | undefined>;\n  slotNames?: SlotName[];\n};\n\nexport type ResolveViewActionTargetSlot = (\n  args: ResolveViewActionTargetSlotArgs,\n) => SlotName | undefined;\n\nexport type ViewActionSlotResolvers = Partial<\n  Record<ChatViewNavigationAction, ResolveViewActionTargetSlot>\n>;\n\ntype ChatViewContextValue = {\n  activeView: ChatView;\n  entityInferers: ChatViewEntityInferer[];\n  layoutController: LayoutController;\n  registerViewActionSlotResolvers: (\n    view: ChatView,\n    resolvers?: ViewActionSlotResolvers,\n  ) => void;\n  resolveActionTargetSlot: (\n    view: ChatView,\n    args: ResolveViewActionTargetSlotArgs,\n  ) => SlotName | undefined;\n  setActiveView: (cv: ChatView) => void;\n};\n\n// No default: a shared `LayoutController` would let unrelated subtrees write to one instance.\nexport const ChatViewContext = createContext<ChatViewContextValue | undefined>(undefined);\nconst ChatViewA11yContext = createContext<ChatViewA11yContextValue>(\n  DEFAULT_CHAT_VIEW_A11Y_CONTEXT_VALUE,\n);\n\nexport const useChatViewContext = () =>\n  requireContext(useContext(ChatViewContext), 'useChatViewContext', 'ChatView');\n\nconst activeViewSelector = ({ activeView }: ChatViewLayoutState) => ({ activeView });\nconst workspaceLayoutStateSelector = (state: ChatViewLayoutState) => ({\n  activeView: state.activeView,\n  viewState: getLayoutViewState(state),\n});\n\nconst DefaultSlotFallback = () => (\n  <div className='str-chat__chat-view__workspace-layout-slot-fallback'>\n    Select a channel to start messaging\n  </div>\n);\n\nconst resolveSlotFallbackComponent = ({\n  slot,\n  SlotFallback,\n  slotFallbackComponents,\n}: {\n  SlotFallback?: ComponentType<ChatViewSlotFallbackProps>;\n  slot: string;\n  slotFallbackComponents?: Partial<\n    Record<string, ComponentType<ChatViewSlotFallbackProps>>\n  >;\n}) => slotFallbackComponents?.[slot] ?? SlotFallback ?? DefaultSlotFallback;\n\nconst BUILTIN_WORKSPACE_LAYOUT: ChatViewBuiltinLayout = 'nav-rail-entity-list-workspace';\nconst DEFAULT_LIST_BINDING_KEY = 'list';\n\n// D7 — the built-in views expressed as declarative layout descriptors. Each layout\n// seeds its own list kind into its first slot (channels -> channelList,\n// threads -> threadList); the kind picks the renderer, so there is no `source.view`.\nconst LIST_KIND_BY_LAYOUT: Record<ChatView, 'channelList' | 'threadList'> = {\n  channels: 'channelList',\n  threads: 'threadList',\n};\nconst buildDefaultLayoutDescriptors = (slots: SlotName[]): LayoutDescriptor[] => {\n  const seedSlot = slots[0];\n  return (['channels', 'threads'] as const).map((id) => ({\n    id,\n    initialBindings: seedSlot\n      ? {\n          [seedSlot]: {\n            key: DEFAULT_LIST_BINDING_KEY,\n            kind: LIST_KIND_BY_LAYOUT[id],\n            source: {},\n          },\n        }\n      : undefined,\n    slots,\n  }));\n};\n\n// Without app `layouts`, each view has a single slot.\nconst DEFAULT_SLOT_NAMES: SlotName[] = ['slot1'];\nconst DEFAULT_LAYOUT_DESCRIPTORS = buildDefaultLayoutDescriptors(DEFAULT_SLOT_NAMES);\n\n// D7 — turn the declarative descriptors into seeded per-layout runtime state at\n// controller construction (replaces the imperative, lazy seed effect).\nconst seedLayoutsFromDescriptors = (\n  descriptors: LayoutDescriptor[],\n): Partial<Record<ChatView, LayoutRuntimeState>> =>\n  descriptors.reduce<Partial<Record<ChatView, LayoutRuntimeState>>>((acc, descriptor) => {\n    const slotBindings: Record<SlotName, LayoutSlotBinding | undefined> = {};\n    Object.entries(descriptor.initialBindings ?? {}).forEach(([slot, entity]) => {\n      if (entity) slotBindings[slot] = createChatViewSlotBinding(entity);\n    });\n    acc[descriptor.id] = createLayoutRuntimeState({\n      availableSlots: descriptor.slots,\n      slotBindings,\n      slotNames: descriptor.slots,\n    });\n    return acc;\n  }, {});\n\nexport const ChatView = ({\n  children,\n  deriveWorkspaceNavigation,\n  dialogManagerId,\n  duplicateEntityPolicy,\n  entityInferrers = [],\n  layout,\n  layoutController,\n  layouts: layoutsProp,\n  resolveDuplicateEntity,\n  SlotFallback,\n  slotFallbackComponents,\n  slotRenderers,\n  viewActionSlotResolvers: viewActionSlotResolversProp,\n  views,\n}: ChatViewProps) => {\n  const { theme } = useChatContext();\n  const chatViewId = useStableId();\n  const a11yValue = useMemo(\n    () => createChatViewA11yContextValue(chatViewId),\n    [chatViewId],\n  );\n  const [viewActionSlotResolvers, setViewActionSlotResolvers] = useState<\n    Partial<Record<ChatView, ViewActionSlotResolvers>>\n  >({});\n  const layoutDescriptors = layoutsProp ?? DEFAULT_LAYOUT_DESCRIPTORS;\n\n  // Seed every layout's slots and bindings from its descriptor up front when the SDK owns per-view\n  // rendering (the built-in workspace or the `views` map), or when the app declares its layouts. In\n  // bare `children` mode without `layouts` the app renders its own lists, so the channels view gets\n  // the default slot and no list binding.\n  const seedFromDescriptors =\n    !!layoutsProp || layout === BUILTIN_WORKSPACE_LAYOUT || !!views;\n\n  const internalLayoutController = useMemo(\n    () =>\n      new LayoutControllerClass({\n        duplicateEntityPolicy,\n        initialState: {\n          activeView: 'channels',\n          layouts: seedFromDescriptors\n            ? seedLayoutsFromDescriptors(layoutDescriptors)\n            : {\n                channels: createLayoutRuntimeState({\n                  availableSlots: DEFAULT_SLOT_NAMES,\n                  slotNames: DEFAULT_SLOT_NAMES,\n                }),\n              },\n        },\n        resolveDuplicateEntity,\n      }),\n    [\n      duplicateEntityPolicy,\n      layoutDescriptors,\n      resolveDuplicateEntity,\n      seedFromDescriptors,\n    ],\n  );\n\n  const effectiveLayoutController = layoutController ?? internalLayoutController;\n\n  const { activeView } =\n    useStateStore(effectiveLayoutController.state, activeViewSelector) ??\n    activeViewSelector(effectiveLayoutController.state.getLatestValue());\n\n  const setActiveView = useCallback(\n    (cv: ChatView) => {\n      // Per-view layouts are retained across switches (that is the point of the\n      // `layouts` map): each view keeps its own slot bindings so returning to it\n      // restores what was open. We must NOT release the source view's channel/thread\n      // bindings here — display is slot-based, so releasing on switch would drop the\n      // open channel/thread (e.g. `?channel=` cleared when moving to the threads view).\n      effectiveLayoutController.setActiveView(cv);\n    },\n    [effectiveLayoutController],\n  );\n\n  const registerViewActionSlotResolvers = useCallback(\n    (view: ChatView, resolvers?: ViewActionSlotResolvers) => {\n      setViewActionSlotResolvers((current) => {\n        const previous = current[view];\n        if (previous === resolvers) return current;\n\n        const next = { ...current };\n        if (!resolvers) delete next[view];\n        else next[view] = resolvers;\n        return next;\n      });\n    },\n    [],\n  );\n\n  const resolveActionTargetSlot = useCallback(\n    (view: ChatView, args: ResolveViewActionTargetSlotArgs) =>\n      viewActionSlotResolvers[view]?.[args.action]?.(args),\n    [viewActionSlotResolvers],\n  );\n\n  const value = useMemo(\n    () => ({\n      activeView,\n      entityInferers: entityInferrers,\n      layoutController: effectiveLayoutController,\n      registerViewActionSlotResolvers,\n      resolveActionTargetSlot,\n      setActiveView,\n    }),\n    [\n      activeView,\n      effectiveLayoutController,\n      entityInferrers,\n      registerViewActionSlotResolvers,\n      resolveActionTargetSlot,\n      setActiveView,\n    ],\n  );\n\n  // Register per-view navigation action resolvers supplied via the `views`-mode prop.\n  useEffect(() => {\n    if (!viewActionSlotResolversProp) return;\n    const entries = Object.entries(viewActionSlotResolversProp) as Array<\n      [ChatView, ViewActionSlotResolvers | undefined]\n    >;\n    entries.forEach(([view, resolvers]) =>\n      registerViewActionSlotResolvers(view, resolvers),\n    );\n    return () => {\n      entries.forEach(([view]) => registerViewActionSlotResolvers(view, undefined));\n    };\n  }, [registerViewActionSlotResolvers, viewActionSlotResolversProp]);\n\n  const workspaceLayoutState =\n    useStateStore(effectiveLayoutController.state, workspaceLayoutStateSelector) ??\n    workspaceLayoutStateSelector(effectiveLayoutController.state.getLatestValue());\n  const { viewState } = workspaceLayoutState;\n\n  const slotKindRegistry = useMemo(\n    () => resolveSlotKindRegistry(slotRenderers),\n    [slotRenderers],\n  );\n\n  // D8 — the active view's content is rendered in a single plain container (a\n  // navigation-landmark view wrapper with a stable id from `chatViewPanelIds`, no\n  // tab/tabpanel role); per-view slot topology is seeded from its `layouts` descriptor.\n  // Always-on `children` (e.g. sync helpers, dialog managers) render alongside it,\n  // regardless of the active view.\n  const activeViewContent = views?.[activeView];\n\n  const content = views ? (\n    <>\n      {children}\n      {activeViewContent != null && (\n        <div\n          className={`str-chat__chat-view__${activeView}`}\n          id={a11yValue.chatViewPanelIds[activeView]}\n        >\n          {activeViewContent}\n        </div>\n      )}\n    </>\n  ) : layout === BUILTIN_WORKSPACE_LAYOUT ? (\n    (() => {\n      const slots = viewState.availableSlots.map((slot) => {\n        const content = renderSlotFromRegistry(\n          getChatViewEntityBinding(viewState.slotBindings[slot]),\n          slot,\n          slotKindRegistry,\n        );\n        const Fallback = resolveSlotFallbackComponent({\n          slot,\n          SlotFallback,\n          slotFallbackComponents,\n        });\n\n        return {\n          content: content ?? <Fallback slot={slot} />,\n          slot,\n        };\n      });\n\n      return <WorkspaceLayout navRail={<ChatViewSelector />} slots={slots} />;\n    })()\n  ) : (\n    children\n  );\n\n  return (\n    <ChatViewA11yContext.Provider value={a11yValue}>\n      <ChatViewContext.Provider value={value}>\n        <SlotRegistryContext.Provider value={slotKindRegistry}>\n          <ChatViewNavigationProvider>\n            {/* Expose the slot-agnostic WorkspaceNavigation adapter (D1) to the subtree so core\n                components navigate through it rather than the ChatView slot API directly. */}\n            <WorkspaceNavigationAdapter\n              deriveWorkspaceNavigation={deriveWorkspaceNavigation}\n            >\n              <div className={clsx('str-chat', theme, 'str-chat__chat-view')}>\n                {/* Host the chat-view dialog manager INSIDE `.str-chat` so dialogs opened by\n                    view content (context menus, member actions, …) portal here and inherit the\n                    `.str-chat`-scoped dialog CSS. Nested managers (e.g. MessageList's) still win\n                    where present. */}\n                <DialogManagerProvider id={dialogManagerId}>\n                  {content}\n                </DialogManagerProvider>\n              </div>\n            </WorkspaceNavigationAdapter>\n          </ChatViewNavigationProvider>\n        </SlotRegistryContext.Provider>\n      </ChatViewContext.Provider>\n    </ChatViewA11yContext.Provider>\n  );\n};\n\n// thread business logic that's impossible to keep within client but encapsulated for ease of use\nexport const useActiveThread = ({ activeThread }: { activeThread?: Thread }) => {\n  useEffect(() => {\n    if (!activeThread) return;\n\n    const handleVisibilityChange = () => {\n      if (document.visibilityState === 'visible' && document.hasFocus()) {\n        activeThread.activate();\n      }\n      if (document.visibilityState === 'hidden' || !document.hasFocus()) {\n        activeThread.deactivate();\n      }\n    };\n\n    handleVisibilityChange();\n\n    window.addEventListener('focus', handleVisibilityChange);\n    window.addEventListener('blur', handleVisibilityChange);\n    return () => {\n      activeThread.deactivate();\n      window.removeEventListener('blur', handleVisibilityChange);\n      window.removeEventListener('focus', handleVisibilityChange);\n    };\n  }, [activeThread]);\n};\n\n// D8 — `ThreadAdapter` is retired: the threads view renders the thread(s) bound in\n// thread slots (via `useSlotThreads` + `Thread`), so there is no single\n// `activeThread` adapter. `useActiveThread` remains for callers that render a thread\n// panel and want focus-driven activate/deactivate.\n\nexport const ChatViewSelectorButton = ({\n  ActiveIcon,\n  children,\n  className,\n  Icon,\n  iconOnly = true,\n  isActive,\n  text,\n  ...props\n}: ButtonProps & {\n  ActiveIcon?: ComponentType;\n  iconOnly?: boolean;\n  Icon?: ComponentType;\n  isActive?: boolean;\n  text?: string;\n}) => {\n  const SelectorIcon = isActive && ActiveIcon ? ActiveIcon : Icon;\n  const shouldShowTooltip = !!text && iconOnly;\n\n  return (\n    <div className='str-chat__chat-view__selector-button-container'>\n      <Button\n        appearance='ghost'\n        aria-current={isActive || undefined}\n        aria-label={props['aria-label'] ?? (shouldShowTooltip ? text : undefined)}\n        className={clsx('str-chat__chat-view__selector-button', className)}\n        variant='secondary'\n        {...props}\n      >\n        {children ?? (SelectorIcon && <SelectorIcon />)}\n        {!iconOnly && text && (\n          <div className='str-chat__chat-view__selector-button-text'>{text}</div>\n        )}\n      </Button>\n      {shouldShowTooltip && (\n        <div\n          aria-hidden='true'\n          className='str-chat__chat-view__selector-button-tooltip str-chat__tooltip'\n        >\n          {text}\n        </div>\n      )}\n    </div>\n  );\n};\n\nconst unreadThreadCountSelector = ({ unreadThreadCount }: ThreadManagerState) => ({\n  unreadThreadCount,\n});\n\nexport type ChatViewSelectorItemProps = {\n  iconOnly?: boolean;\n};\n\nexport const ChatViewChannelsSelectorButton = ({\n  iconOnly = true,\n}: ChatViewSelectorItemProps) => {\n  const { IconMessageBubble, IconMessageBubbleFill } = useComponentContextIcons();\n  const { activeView, setActiveView } = useChatViewContext();\n  const { t } = useTranslationContext();\n\n  const isActive = activeView === 'channels';\n\n  return (\n    <ChatViewSelectorButton\n      ActiveIcon={IconMessageBubbleFill}\n      aria-label={t(\n        'slotLayout.chatView.openChannelsView.ariaLabel',\n        'Open channels view',\n      )}\n      Icon={IconMessageBubble}\n      iconOnly={iconOnly}\n      isActive={isActive}\n      onClick={() => setActiveView('channels')}\n      onPointerDown={() => setActiveView('channels')}\n      text={t('slotLayout.chatView.channels.text', 'Channels')}\n    />\n  );\n};\n\nexport const ChatViewThreadsSelectorButton = ({\n  iconOnly = true,\n}: ChatViewSelectorItemProps) => {\n  const { IconThread, IconThreadFill } = useComponentContextIcons();\n  const { client } = useChatContext();\n  const { unreadThreadCount } = useStateStore(\n    client.threads.state,\n    unreadThreadCountSelector,\n  ) ?? {\n    unreadThreadCount: 0,\n  };\n  const { activeView, setActiveView } = useChatViewContext();\n  const { t } = useTranslationContext();\n\n  const isActive = activeView === 'threads';\n  const label =\n    unreadThreadCount > 0\n      ? t('slotLayout.chatView.openThreadsViewUnread.ariaLabel', {\n          count: unreadThreadCount,\n          defaultValue_one: 'Open threads view, {{ count }} unread thread',\n          defaultValue_other: 'Open threads view, {{ count }} unread threads',\n        })\n      : t('slotLayout.chatView.openThreadsView.ariaLabel', 'Open threads view');\n\n  return (\n    <ChatViewSelectorButton\n      ActiveIcon={IconThreadFill}\n      aria-label={label}\n      Icon={IconThread}\n      iconOnly={iconOnly}\n      isActive={isActive}\n      onClick={() => setActiveView('threads')}\n      onPointerDown={() => setActiveView('threads')}\n      text={t('common.threads.text', 'Threads')}\n    >\n      <UnreadCountBadge count={unreadThreadCount} position='top-right'>\n        {isActive ? <IconThreadFill /> : <IconThread />}\n      </UnreadCountBadge>\n    </ChatViewSelectorButton>\n  );\n};\n\nexport type ChatViewSelectorItem = {\n  Component: React.ComponentType<ChatViewSelectorItemProps>;\n  type: string & {};\n};\n\nexport type ChatViewSelectorEntry = ChatViewSelectorItem;\n\nexport type ChatViewSelectorProps = {\n  iconOnly?: boolean;\n  itemSet?: ChatViewSelectorEntry[];\n};\n\nexport const defaultChatViewSelectorItemSet: ChatViewSelectorEntry[] = [\n  {\n    Component: ChatViewChannelsSelectorButton,\n    type: 'channels' as string & {},\n  },\n  {\n    Component: ChatViewThreadsSelectorButton,\n    type: 'threads' as string & {},\n  },\n];\n\nconst ChatViewSelector = ({\n  iconOnly = true,\n  itemSet = defaultChatViewSelectorItemSet,\n}: ChatViewSelectorProps) => {\n  const { t } = useTranslationContext();\n\n  return (\n    <div\n      aria-label={t(\n        'slotLayout.chatView.chatViewControls.ariaLabel',\n        'Chat view controls',\n      )}\n      className='str-chat__chat-view__selector'\n      role='navigation'\n    >\n      {itemSet.map(({ Component, type }) => (\n        <Component iconOnly={iconOnly} key={type} />\n      ))}\n    </div>\n  );\n};\n\nChatView.Selector = ChatViewSelector;\n"],"mappings":"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"}

package/dist/es/plugins/SlotLayout/ChatViewNavigationContext.mjs

@@ -0,0 +1,239 @@
+import { useStateStore } from "../../store/hooks/useStateStore.mjs";
+import { isPersistentSlotKind, resolveSlotKindView, useSlotRegistry } from "./slotRegistry.mjs";
+import { getLayoutViewState, useLayoutViewState } from "./hooks/useLayoutViewState.mjs";
+import { createChatViewSlotBinding, getChatViewEntityBinding } from "./slotBinding.mjs";
+import { useChatViewContext } from "./ChatView.mjs";
+import { createContext, useContext, useMemo } from "react";
+import { Thread } from "stream-chat";
+import { jsx } from "react/jsx-runtime";
+//#region src/plugins/SlotLayout/ChatViewNavigationContext.tsx
+var resolveDefaultTargetSlot = ({ additive, isPersistentSlot, kind, requestedSlot, runtime }) => {
+	if (requestedSlot && runtime.availableSlots.includes(requestedSlot)) return requestedSlot;
+	const readSlotKind = (slot) => getChatViewEntityBinding(runtime.slotBindings[slot])?.kind;
+	const isFree = (slot) => !runtime.slotBindings[slot] && !runtime.slotLayers[slot]?.length;
+	const sameKind = runtime.availableSlots.find((slot) => readSlotKind(slot) === kind);
+	const firstFreeNonPersistent = runtime.availableSlots.find((slot) => isFree(slot) && !isPersistentSlot(slot));
+	const firstFree = runtime.availableSlots.find((slot) => isFree(slot));
+	const lastNonPersistent = [...runtime.availableSlots].reverse().find((slot) => !isPersistentSlot(slot));
+	if (additive) return firstFreeNonPersistent ?? firstFree ?? lastNonPersistent;
+	return sameKind ?? firstFreeNonPersistent ?? firstFree ?? lastNonPersistent;
+};
+/**
+* Binding builder for the `thread` kind (D6). The `{ channel, message }` ->
+* `Thread` construction (with dedupe against `client.threads`) lives here so
+* callers can drive the generic `open` with a ready binding instead of a
+* thread-specific navigation method.
+*/
+var createThreadEntityBinding = (client, target) => {
+	const thread = client.threads.threadsById[target.message.id] ?? new Thread({
+		channel: target.channel,
+		client,
+		parentMessage: target.message
+	});
+	return {
+		key: thread.id ?? void 0,
+		kind: "thread",
+		source: thread
+	};
+};
+var chatViewNavigationStateSelector = (state) => ({ activeView: state.activeView });
+var ChatViewNavigationContext = createContext({
+	close: () => void 0,
+	hide: () => void 0,
+	open: () => ({
+		reason: "no-available-slot",
+		status: "rejected"
+	}),
+	openView: () => void 0,
+	popLayer: () => void 0,
+	pushLayer: () => void 0,
+	release: () => void 0,
+	unhide: () => void 0
+});
+var useChatViewNavigation = () => useContext(ChatViewNavigationContext);
+/** The slot (in the active view) currently holding a binding of `kind`, if any. */
+var useSlotForKind = (kind) => {
+	const { availableSlots, slotBindings } = useLayoutViewState();
+	return useMemo(() => availableSlots.find((slot) => getChatViewEntityBinding(slotBindings[slot])?.kind === kind), [
+		availableSlots,
+		kind,
+		slotBindings
+	]);
+};
+/** The slot (in the active view) whose binding carries entity `key`, if any. */
+var useSlotForKey = (key) => {
+	const { availableSlots, slotBindings } = useLayoutViewState();
+	return useMemo(() => key === void 0 ? void 0 : availableSlots.find((slot) => getChatViewEntityBinding(slotBindings[slot])?.key === key), [
+		availableSlots,
+		key,
+		slotBindings
+	]);
+};
+var ChatViewNavigationProvider = ({ children }) => {
+	const { layoutController, resolveActionTargetSlot } = useChatViewContext();
+	const registry = useSlotRegistry();
+	const { availableSlots, slotBindings, slotLayers } = useLayoutViewState();
+	const { activeView } = useStateStore(layoutController.state, chatViewNavigationStateSelector) ?? chatViewNavigationStateSelector(layoutController.state.getLatestValue());
+	const value = useMemo(() => {
+		const slotKind = (slot) => getChatViewEntityBinding(slotBindings[slot])?.kind;
+		const buildRuntimeForView = (view) => {
+			const viewState = getLayoutViewState(layoutController.state.getLatestValue(), view);
+			return {
+				activeViewState: viewState,
+				availableSlots: viewState.availableSlots,
+				orderedSlots: viewState.slotNames?.length ? viewState.slotNames : viewState.availableSlots,
+				slotBindings: viewState.slotBindings,
+				slotLayers: viewState.slotLayers ?? {}
+			};
+		};
+		const makeIsPersistentSlot = (runtime) => (slot) => isPersistentSlotKind(registry, getChatViewEntityBinding(runtime.slotBindings[slot])?.kind);
+		const materializeTargetSlot = (runtime, slot) => {
+			if (!slot) return void 0;
+			if (runtime.availableSlots.includes(slot)) return slot;
+			if (!runtime.orderedSlots.includes(slot)) return void 0;
+			const nextAvailableSlots = runtime.orderedSlots.filter((candidate) => runtime.availableSlots.includes(candidate) || candidate === slot);
+			layoutController.setAvailableSlots(nextAvailableSlots);
+			return slot;
+		};
+		const resolveTargetSlot = ({ additive, kind, requestedSlot, runtime, view }) => {
+			const action = !additive && kind === "channel" ? "openChannel" : !additive && kind === "thread" ? "openThread" : void 0;
+			if (action) {
+				const customTargetSlot = resolveActionTargetSlot(view, {
+					action,
+					activeView: view,
+					availableSlots: runtime.availableSlots,
+					requestedSlot,
+					slotBindings: runtime.slotBindings,
+					slotNames: runtime.orderedSlots
+				});
+				if (customTargetSlot) {
+					const materialized = materializeTargetSlot(runtime, customTargetSlot);
+					if (materialized) return materialized;
+				}
+			}
+			return materializeTargetSlot(runtime, resolveDefaultTargetSlot({
+				additive,
+				isPersistentSlot: makeIsPersistentSlot(runtime),
+				kind,
+				requestedSlot,
+				runtime
+			}));
+		};
+		const openView = (view, options) => {
+			layoutController.openView(view, { slot: options?.slot });
+		};
+		const closeReplyThreads = (replacedChannel) => {
+			availableSlots.forEach((slot) => {
+				const layers = slotLayers?.[slot] ?? [];
+				const top = layers[layers.length - 1];
+				const topEntity = getChatViewEntityBinding(top);
+				if (replacedChannel && topEntity?.kind === "thread" && topEntity.source.channel?.cid === replacedChannel.cid) {
+					layoutController.popLayer(slot);
+					return;
+				}
+				if (slotKind(slot) !== "thread") return;
+				if (!top) {
+					layoutController.release(slot);
+					return;
+				}
+				layoutController.bind(slot, top);
+				layoutController.popLayer(slot);
+			});
+		};
+		const open = (binding, options) => {
+			const kindView = resolveSlotKindView(registry, binding.kind);
+			const targetView = kindView ?? activeView;
+			const runtime = buildRuntimeForView(targetView);
+			const targetSlot = resolveTargetSlot({
+				additive: options?.additive,
+				kind: binding.kind,
+				requestedSlot: options?.slot,
+				runtime,
+				view: targetView
+			});
+			if (!targetSlot) return {
+				reason: "no-available-slot",
+				status: "rejected"
+			};
+			if (kindView) openView(targetView, options);
+			const isPersistentSlot = makeIsPersistentSlot(runtime);
+			const anchorSlot = runtime.availableSlots.find((slot) => !isPersistentSlot(slot));
+			const targetBase = runtime.slotBindings[targetSlot];
+			const targetBaseKind = getChatViewEntityBinding(targetBase)?.kind;
+			const targetOccupied = !!targetBase || !!runtime.slotLayers[targetSlot]?.length;
+			const isSecondaryTarget = targetSlot !== anchorSlot;
+			const shownInTarget = getChatViewEntityBinding(runtime.slotLayers[targetSlot]?.at(-1) ?? targetBase);
+			if (options?.additive && isSecondaryTarget && binding.key !== void 0 && shownInTarget?.key === binding.key) return {
+				slot: targetSlot,
+				status: "opened"
+			};
+			const stacksBesideSameKind = !!options?.additive && binding.kind === "channel";
+			const sameKindBaseReplace = !!targetBase && targetBaseKind === binding.kind && !stacksBesideSameKind;
+			if (options?.layer || isSecondaryTarget && targetOccupied && !sameKindBaseReplace) {
+				layoutController.pushLayer(targetSlot, createChatViewSlotBinding(binding));
+				return {
+					slot: targetSlot,
+					status: "layered"
+				};
+			}
+			if (binding.kind === "channel") {
+				const replaced = getChatViewEntityBinding(targetBase);
+				closeReplyThreads(replaced?.kind === "channel" ? replaced.source : void 0);
+			}
+			return layoutController.openInLayout(createChatViewSlotBinding(binding), { targetSlot });
+		};
+		const close = (slot) => {
+			if (!availableSlots.includes(slot)) return;
+			if (slotLayers?.[slot]?.length) {
+				layoutController.popLayer(slot);
+				return;
+			}
+			if (isPersistentSlotKind(registry, slotKind(slot))) return;
+			layoutController.release(slot);
+		};
+		const release = (slot) => {
+			if (!availableSlots.includes(slot)) return;
+			if (isPersistentSlotKind(registry, slotKind(slot))) return;
+			layoutController.release(slot);
+		};
+		const hide = (slot) => {
+			if (availableSlots.includes(slot)) layoutController.hide(slot);
+		};
+		const pushLayer = (slot, binding) => {
+			if (!availableSlots.includes(slot)) return;
+			layoutController.pushLayer(slot, createChatViewSlotBinding(binding));
+		};
+		const popLayer = (slot) => {
+			if (availableSlots.includes(slot)) layoutController.popLayer(slot);
+		};
+		const unhide = (slot) => {
+			if (availableSlots.includes(slot)) layoutController.unhide(slot);
+		};
+		return {
+			close,
+			hide,
+			open,
+			openView,
+			popLayer,
+			pushLayer,
+			release,
+			unhide
+		};
+	}, [
+		activeView,
+		availableSlots,
+		layoutController,
+		registry,
+		resolveActionTargetSlot,
+		slotBindings,
+		slotLayers
+	]);
+	return /* @__PURE__ */ jsx(ChatViewNavigationContext.Provider, {
+		value,
+		children
+	});
+};
+//#endregion
+export { ChatViewNavigationProvider, createThreadEntityBinding, useChatViewNavigation, useSlotForKey, useSlotForKind };
+
+//# sourceMappingURL=ChatViewNavigationContext.mjs.map

package/dist/es/plugins/SlotLayout/ChatViewNavigationContext.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatViewNavigationContext.mjs","names":[],"sources":["../../../../src/plugins/SlotLayout/ChatViewNavigationContext.tsx"],"sourcesContent":["import React, { createContext, useContext, useMemo } from 'react';\n\nimport { useStateStore } from '../../store';\nimport {\n  createChatViewSlotBinding,\n  getChatViewEntityBinding,\n  useChatViewContext,\n} from './ChatView';\nimport {\n  isPersistentSlotKind,\n  resolveSlotKindView,\n  useSlotRegistry,\n} from './slotRegistry';\n\nimport type { PropsWithChildren } from 'react';\nimport type {\n  LocalMessage,\n  Channel as StreamChannel,\n  StreamChat,\n  Thread as StreamThread,\n} from 'stream-chat';\nimport { Thread as StreamThreadClass } from 'stream-chat';\nimport type {\n  ChatView,\n  ChatViewEntityBinding,\n  ResolveViewActionTargetSlotArgs,\n} from './ChatView';\nimport { getLayoutViewState, useLayoutViewState } from './hooks/useLayoutViewState';\nimport type {\n  ChatViewLayoutState,\n  ChatViewLayoutViewState,\n  LayoutSlotBinding,\n  OpenResult,\n  SlotName,\n} from './layoutController/layoutControllerTypes';\n\ntype ViewSlotRuntime = {\n  activeViewState: ChatViewLayoutViewState;\n  availableSlots: SlotName[];\n  orderedSlots: SlotName[];\n  slotBindings: Record<SlotName, LayoutSlotBinding | undefined>;\n  slotLayers: Record<SlotName, LayoutSlotBinding[] | undefined>;\n};\n\n// D6 — the resolver is kind-driven and persistent-aware (via the registry), not\n// keyed on a fixed set of actions or a hardcoded list-kind set. Precedence:\n// reuse a same-kind slot -> first free non-persistent -> first free -> first\n// non-persistent. Persistent (list) slots are never an implicit target and there\n// is deliberately no \"last slot\" fallback, so when only persistent slots remain\n// the resolver returns undefined and `openInLayout` rejects rather than\n// destroying a list.\nconst resolveDefaultTargetSlot = ({\n  additive,\n  isPersistentSlot,\n  kind,\n  requestedSlot,\n  runtime,\n}: {\n  additive?: boolean;\n  isPersistentSlot: (slot: SlotName) => boolean;\n  kind: ChatViewEntityBinding['kind'];\n  requestedSlot?: SlotName;\n  runtime: ViewSlotRuntime;\n}): SlotName | undefined => {\n  if (requestedSlot && runtime.availableSlots.includes(requestedSlot)) {\n    return requestedSlot;\n  }\n\n  const readSlotKind = (slot: SlotName) =>\n    getChatViewEntityBinding(runtime.slotBindings[slot])?.kind;\n  // A slot is \"free\" only when it has neither a base binding NOR a covering layer stack — binding\n  // into the base beneath a layer would render invisibly, so a layered slot counts as occupied.\n  const isFree = (slot: SlotName) =>\n    !runtime.slotBindings[slot] && !runtime.slotLayers[slot]?.length;\n  const sameKind = runtime.availableSlots.find((slot) => readSlotKind(slot) === kind);\n  const firstFreeNonPersistent = runtime.availableSlots.find(\n    (slot) => isFree(slot) && !isPersistentSlot(slot),\n  );\n  const firstFree = runtime.availableSlots.find((slot) => isFree(slot));\n  // When every slot is occupied, evict the LAST non-persistent slot rather than the first.\n  // Slots run primary -> secondary, so the first slot holds the anchor content (e.g. the main\n  // channel); a newly-opened panel — a reply thread opened while a 2nd channel occupies the\n  // secondary slot, say — should replace the most-recent secondary panel, never make the\n  // primary disappear.\n  const lastNonPersistent = [...runtime.availableSlots]\n    .reverse()\n    .find((slot) => !isPersistentSlot(slot));\n\n  // `additive` opens *beside* existing content (ctrl/⌘-click): skip the same-kind slot, which\n  // would replace the current primary, and prefer a free/secondary slot instead. In a\n  // single-slot layout it falls through to that slot, so it degrades to a normal open.\n  if (additive) {\n    return firstFreeNonPersistent ?? firstFree ?? lastNonPersistent;\n  }\n\n  return sameKind ?? firstFreeNonPersistent ?? firstFree ?? lastNonPersistent;\n};\n\nexport type OpenThreadTarget =\n  | StreamThread\n  | { channel: StreamChannel; message: LocalMessage };\n\n/**\n * Binding builder for the `thread` kind (D6). The `{ channel, message }` ->\n * `Thread` construction (with dedupe against `client.threads`) lives here so\n * callers can drive the generic `open` with a ready binding instead of a\n * thread-specific navigation method.\n */\nexport const createThreadEntityBinding = (\n  client: StreamChat,\n  target: { channel: StreamChannel; message: LocalMessage },\n): ChatViewEntityBinding => {\n  const existingThread = client.threads.threadsById[target.message.id];\n  const thread =\n    existingThread ??\n    new StreamThreadClass({\n      channel: target.channel,\n      client,\n      parentMessage: target.message,\n    });\n  return { key: thread.id ?? undefined, kind: 'thread', source: thread };\n};\n\n/** Options for {@link ChatViewNavigation.open}. */\nexport type ChatViewOpenOptions = {\n  /**\n   * Open *beside* existing content instead of replacing it.\n   *\n   * By default `open` reuses the slot that already holds the binding's `kind` (so selecting a\n   * channel replaces the current channel). With `additive: true` the resolver skips that\n   * same-kind slot and instead targets the first free non-persistent slot — falling back to the\n   * last non-persistent slot when every slot is occupied. The effect is that the entity opens in\n   * a *secondary* slot next to the current one (e.g. ctrl/⌘-click a channel to open a 2nd channel\n   * side-by-side, or a search result beside the open channel).\n   *\n   * In a single-slot layout there is no secondary slot to open into, so it falls back to that\n   * one slot and behaves like a normal open. Ignored when an explicit `slot` is provided.\n   *\n   * @default false\n   */\n  additive?: boolean;\n  /**\n   * Open non-destructively: push the binding as a **layer** on top of the resolved target slot's\n   * current content instead of replacing it, and skip dependent-slot invalidation (nothing is\n   * being replaced). `close`/`popLayer` on that slot later restores what was underneath, at its\n   * exact state. Compose with `additive` to target the *secondary* slot — e.g.\n   * `open(channel, { additive: true, layer: true })` stacks a channel over an open reply thread\n   * without closing it. Orthogonal to slot resolution: `layer` chooses stack-vs-replace, while\n   * `slot`/`additive` choose *which* slot.\n   *\n   * @default false\n   */\n  layer?: boolean;\n  /**\n   * Bind into this specific slot, when it exists in the target view's layout. Takes precedence\n   * over `additive` and over the default kind-based slot resolution. Ignored (falls back to the\n   * default resolution) when the named slot is not part of the active layout.\n   */\n  slot?: SlotName;\n};\n\nexport type ChatViewNavigation = {\n  /**\n   * Dismiss the top of `slot`. If the slot has layers (see {@link pushLayer}), pop the topmost\n   * layer, revealing what's beneath at its preserved state. Only when no layers remain does this\n   * release the base binding. No-op for empty or persistent slots.\n   */\n  close: (slot: SlotName) => void;\n  /**\n   * Close `slot` entirely: its base binding and every layer stacked on it. Where {@link close}\n   * steps back one layer, this dismisses the whole panel. No-op for empty or persistent slots.\n   */\n  release: (slot: SlotName) => void;\n  /** Hide `slot` without releasing its binding (subtree stays mounted). */\n  hide: (slot: SlotName) => void;\n  /**\n   * Push `binding` as a **layer** on top of `slot`'s current content. The content beneath stays\n   * mounted (state/scroll preserved) and hidden; the layer covers it. Use for transient overlays\n   * that should return to the underlying view — e.g. a member profile opened over a thread, where\n   * `close`/`popLayer` restores the thread exactly where it was. Ephemeral (not serialized).\n   */\n  pushLayer: (slot: SlotName, binding: ChatViewEntityBinding) => void;\n  /** Pop `slot`'s top layer, revealing the layer/base beneath. No-op when there are no layers. */\n  popLayer: (slot: SlotName) => void;\n  /**\n   * Resolve a target slot for `binding` and bind it there, switching to the binding kind's view\n   * first if needed (e.g. a `channel` binding activates the channels view).\n   *\n   * Slot resolution, in order:\n   * 1. `options.slot`, if that slot exists in the target view's layout;\n   * 2. otherwise, unless `options.additive` is set, the slot already holding this `kind`\n   *    (replacing its content);\n   * 3. the first free non-persistent slot;\n   * 4. the first free slot;\n   * 5. the last non-persistent slot (evicting a secondary panel — never the primary).\n   *\n   * See {@link ChatViewOpenOptions.additive} for opening *beside* current content instead of\n   * replacing.\n   *\n   * Returns an {@link OpenResult}; if no slot can be resolved the call is a rejected no-op — no\n   * view switch and no dependent-slot teardown, so a rejected open never leaves a partial state.\n   */\n  open: (binding: ChatViewEntityBinding, options?: ChatViewOpenOptions) => OpenResult;\n  /** Switch the active view (channels/threads); optionally focus a specific `slot`. */\n  openView: (view: ChatView, options?: { slot?: SlotName }) => void;\n  /** Reveal a previously hidden `slot`. */\n  unhide: (slot: SlotName) => void;\n};\n\nconst chatViewNavigationStateSelector = (state: ChatViewLayoutState) => ({\n  activeView: state.activeView,\n});\n\nconst ChatViewNavigationContext = createContext<ChatViewNavigation>({\n  close: () => undefined,\n  hide: () => undefined,\n  open: () => ({ reason: 'no-available-slot', status: 'rejected' }),\n  openView: () => undefined,\n  popLayer: () => undefined,\n  pushLayer: () => undefined,\n  release: () => undefined,\n  unhide: () => undefined,\n});\n\nexport const useChatViewNavigation = () => useContext(ChatViewNavigationContext);\n\n/** The slot (in the active view) currently holding a binding of `kind`, if any. */\nexport const useSlotForKind = (\n  kind: ChatViewEntityBinding['kind'],\n): SlotName | undefined => {\n  const { availableSlots, slotBindings } = useLayoutViewState();\n  return useMemo(\n    () =>\n      availableSlots.find(\n        (slot) => getChatViewEntityBinding(slotBindings[slot])?.kind === kind,\n      ),\n    [availableSlots, kind, slotBindings],\n  );\n};\n\n/** The slot (in the active view) whose binding carries entity `key`, if any. */\nexport const useSlotForKey = (key?: string): SlotName | undefined => {\n  const { availableSlots, slotBindings } = useLayoutViewState();\n  return useMemo(\n    () =>\n      key === undefined\n        ? undefined\n        : availableSlots.find(\n            (slot) => getChatViewEntityBinding(slotBindings[slot])?.key === key,\n          ),\n    [availableSlots, key, slotBindings],\n  );\n};\n\nexport const ChatViewNavigationProvider = ({ children }: PropsWithChildren) => {\n  const { layoutController, resolveActionTargetSlot } = useChatViewContext();\n  const registry = useSlotRegistry();\n  const { availableSlots, slotBindings, slotLayers } = useLayoutViewState();\n  const { activeView } =\n    useStateStore(layoutController.state, chatViewNavigationStateSelector) ??\n    chatViewNavigationStateSelector(layoutController.state.getLatestValue());\n\n  const value = useMemo<ChatViewNavigation>(() => {\n    const slotKind = (slot: SlotName) =>\n      getChatViewEntityBinding(slotBindings[slot])?.kind;\n\n    const buildRuntimeForView = (view: ChatView): ViewSlotRuntime => {\n      const state = layoutController.state.getLatestValue();\n      const viewState = getLayoutViewState(state, view);\n\n      return {\n        activeViewState: viewState,\n        availableSlots: viewState.availableSlots,\n        orderedSlots: viewState.slotNames?.length\n          ? viewState.slotNames\n          : viewState.availableSlots,\n        slotBindings: viewState.slotBindings,\n        slotLayers: viewState.slotLayers ?? {},\n      };\n    };\n\n    const makeIsPersistentSlot = (runtime: ViewSlotRuntime) => (slot: SlotName) =>\n      isPersistentSlotKind(\n        registry,\n        getChatViewEntityBinding(runtime.slotBindings[slot])?.kind,\n      );\n\n    const materializeTargetSlot = (runtime: ViewSlotRuntime, slot?: SlotName) => {\n      if (!slot) return undefined;\n      if (runtime.availableSlots.includes(slot)) return slot;\n      if (!runtime.orderedSlots.includes(slot)) return undefined;\n\n      const nextAvailableSlots = runtime.orderedSlots.filter(\n        (candidate) => runtime.availableSlots.includes(candidate) || candidate === slot,\n      );\n      layoutController.setAvailableSlots(nextAvailableSlots);\n      return slot;\n    };\n\n    const resolveTargetSlot = ({\n      additive,\n      kind,\n      requestedSlot,\n      runtime,\n      view,\n    }: {\n      additive?: boolean;\n      kind: ChatViewEntityBinding['kind'];\n      requestedSlot?: SlotName;\n      runtime: ViewSlotRuntime;\n      view: ChatView;\n    }) => {\n      // Preserve the public per-view resolver extension point (keyed on the\n      // channel/thread actions) for the kinds that have one. `additive` (open beside) skips it\n      // and uses the default resolver, which is where the \"prefer a free/secondary slot\" logic\n      // lives.\n      const action =\n        !additive && kind === 'channel'\n          ? 'openChannel'\n          : !additive && kind === 'thread'\n            ? 'openThread'\n            : undefined;\n      if (action) {\n        const args: ResolveViewActionTargetSlotArgs = {\n          action,\n          activeView: view,\n          availableSlots: runtime.availableSlots,\n          requestedSlot,\n          slotBindings: runtime.slotBindings,\n          slotNames: runtime.orderedSlots,\n        };\n        const customTargetSlot = resolveActionTargetSlot(view, args);\n        if (customTargetSlot) {\n          const materialized = materializeTargetSlot(runtime, customTargetSlot);\n          if (materialized) return materialized;\n        }\n      }\n\n      return materializeTargetSlot(\n        runtime,\n        resolveDefaultTargetSlot({\n          additive,\n          isPersistentSlot: makeIsPersistentSlot(runtime),\n          kind,\n          requestedSlot,\n          runtime,\n        }),\n      );\n    };\n\n    const openView: ChatViewNavigation['openView'] = (view, options) => {\n      layoutController.openView(view, { slot: options?.slot });\n    };\n\n    // Replacing a channel closes the reply threads opened from it. A thread slot is released, but\n    // content stacked over the thread (a channel opened beside it) stays, its top layer becoming\n    // the slot's base. A reply thread of `replacedChannel` stacked over another panel is popped,\n    // revealing that panel.\n    const closeReplyThreads = (replacedChannel?: StreamChannel) => {\n      availableSlots.forEach((slot) => {\n        const layers = slotLayers?.[slot] ?? [];\n        const top = layers[layers.length - 1];\n        const topEntity = getChatViewEntityBinding(top);\n        if (\n          replacedChannel &&\n          topEntity?.kind === 'thread' &&\n          topEntity.source.channel?.cid === replacedChannel.cid\n        ) {\n          layoutController.popLayer(slot);\n          return;\n        }\n        if (slotKind(slot) !== 'thread') return;\n        if (!top) {\n          layoutController.release(slot);\n          return;\n        }\n        layoutController.bind(slot, top);\n        layoutController.popLayer(slot);\n      });\n    };\n\n    const open: ChatViewNavigation['open'] = (binding, options) => {\n      // Resolve the target slot BEFORE any mutation: a rejected open is a no-op\n      // (no view switch, no dependent-slot teardown), never a destructive\n      // partial navigation.\n      const kindView = resolveSlotKindView(registry, binding.kind);\n      const targetView = kindView ?? activeView;\n      const runtime = buildRuntimeForView(targetView);\n      const targetSlot = resolveTargetSlot({\n        additive: options?.additive,\n        kind: binding.kind,\n        requestedSlot: options?.slot,\n        runtime,\n        view: targetView,\n      });\n\n      if (!targetSlot) {\n        return { reason: 'no-available-slot', status: 'rejected' };\n      }\n\n      // Kinds that declare a target view switch to it on open (e.g. channel ->\n      // channels); view-agnostic kinds (thread) open in the active view.\n      if (kindView) openView(targetView, options);\n\n      // Base policy — \"open in the secondary slot; if it's occupied, stack a layer\" for both\n      // channels (⌘/ctrl-click) and threads (reply-in-thread). Push a LAYER when:\n      //  - `options.layer` explicitly asks for it, OR\n      //  - the target is a SECONDARY slot (not the primary/anchor slot) that is already occupied\n      //    (a base binding or a covering layer) and this is NOT an in-place same-kind replace.\n      // The primary/anchor slot (first non-persistent slot) always base-binds — selecting a channel\n      // there replaces it, and single-slot layouts keep replacing rather than layering. A same-kind\n      // base (thread over thread in its own slot) is an intentional replace and stays a base bind -\n      // except a channel opened beside another one (`additive`), which stacks too, so that stepping\n      // back returns to the previous channel. Everything else landing on an occupied secondary\n      // slot stacks on top instead of evicting/hiding it — `close`/`popLayer` restores what's\n      // beneath.\n      const isPersistentSlot = makeIsPersistentSlot(runtime);\n      const anchorSlot = runtime.availableSlots.find((slot) => !isPersistentSlot(slot));\n      const targetBase = runtime.slotBindings[targetSlot];\n      const targetBaseKind = getChatViewEntityBinding(targetBase)?.kind;\n      const targetOccupied = !!targetBase || !!runtime.slotLayers[targetSlot]?.length;\n      const isSecondaryTarget = targetSlot !== anchorSlot;\n      // Opening beside what the target slot already shows on top changes nothing. Anything else -\n      // a channel lower in its stack, or open in another slot - is stacked on top, so it is shown.\n      const shownInTarget = getChatViewEntityBinding(\n        runtime.slotLayers[targetSlot]?.at(-1) ?? targetBase,\n      );\n      if (\n        options?.additive &&\n        isSecondaryTarget &&\n        binding.key !== undefined &&\n        shownInTarget?.key === binding.key\n      ) {\n        return { slot: targetSlot, status: 'opened' };\n      }\n      const stacksBesideSameKind = !!options?.additive && binding.kind === 'channel';\n      const sameKindBaseReplace =\n        !!targetBase && targetBaseKind === binding.kind && !stacksBesideSameKind;\n\n      if (\n        options?.layer ||\n        (isSecondaryTarget && targetOccupied && !sameKindBaseReplace)\n      ) {\n        layoutController.pushLayer(targetSlot, createChatViewSlotBinding(binding));\n        return { slot: targetSlot, status: 'layered' };\n      }\n\n      // Dependent-slot invalidation: replacing a channel closes threads bound to\n      // the previous channel. (Interim kind check; a later step may express this\n      // as registry policy.) Only on a real base replace — layered opens above skip it.\n      if (binding.kind === 'channel') {\n        const replaced = getChatViewEntityBinding(targetBase);\n        closeReplyThreads(replaced?.kind === 'channel' ? replaced.source : undefined);\n      }\n\n      return layoutController.openInLayout(createChatViewSlotBinding(binding), {\n        targetSlot,\n      });\n    };\n\n    const close: ChatViewNavigation['close'] = (slot) => {\n      if (!availableSlots.includes(slot)) return;\n      // Layers dismiss top-down: pop the topmost layer first and only release the base binding\n      // once no layers remain.\n      if (slotLayers?.[slot]?.length) {\n        layoutController.popLayer(slot);\n        return;\n      }\n      // Persistent kinds (nav-rail lists) are hide-only; close never releases them.\n      if (isPersistentSlotKind(registry, slotKind(slot))) return;\n      layoutController.release(slot);\n    };\n\n    const release: ChatViewNavigation['release'] = (slot) => {\n      if (!availableSlots.includes(slot)) return;\n      if (isPersistentSlotKind(registry, slotKind(slot))) return;\n      layoutController.release(slot);\n    };\n\n    const hide: ChatViewNavigation['hide'] = (slot) => {\n      if (availableSlots.includes(slot)) layoutController.hide(slot);\n    };\n\n    const pushLayer: ChatViewNavigation['pushLayer'] = (slot, binding) => {\n      if (!availableSlots.includes(slot)) return;\n      layoutController.pushLayer(slot, createChatViewSlotBinding(binding));\n    };\n\n    const popLayer: ChatViewNavigation['popLayer'] = (slot) => {\n      if (availableSlots.includes(slot)) layoutController.popLayer(slot);\n    };\n\n    const unhide: ChatViewNavigation['unhide'] = (slot) => {\n      if (availableSlots.includes(slot)) layoutController.unhide(slot);\n    };\n\n    return { close, hide, open, openView, popLayer, pushLayer, release, unhide };\n  }, [\n    activeView,\n    availableSlots,\n    layoutController,\n    registry,\n    resolveActionTargetSlot,\n    slotBindings,\n    slotLayers,\n  ]);\n\n  return (\n    <ChatViewNavigationContext.Provider value={value}>\n      {children}\n    </ChatViewNavigationContext.Provider>\n  );\n};\n"],"mappings":"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"}