@gtkx/navigation 2.0.0-beta.11 → 2.0.0-beta.13

package/src/tab-view/tab-view-host.tsx

@@ -0,0 +1,474 @@
+import type * as GObject from "@gtkx/gi/gobject";
+import type { ParamListBase, RouteProp } from "@react-navigation/core";
+import type { ReactNode } from "react";
+import * as Adw from "@gtkx/gi/adw";
+import * as Gio from "@gtkx/gi/gio";
+import { AdwBin, AdwTabBar, AdwTabOverview, AdwToolbarView } from "@gtkx/jsx/adw";
+import { createPortal, rootElement, useProperty, useSignal } from "@gtkx/react";
+import { createContext, useContext, useLayoutEffect, useState, useSyncExternalStore } from "react";
+import type { AppliedOptions, PageRecord, PageStore } from "./page-registry.js";
+import type {
+    TabViewDescriptor,
+    TabViewDescriptorMap,
+    TabViewIcon,
+    TabViewNavigationConfig,
+    TabViewNavigationHelpers,
+    TabViewNavigationOptions,
+    TabViewNavigationState,
+} from "./types.js";
+import { HeaderBar } from "../shared/header-bar.js";
+import { getFocusedRoute, requireDescriptor } from "../shared/routes.js";
+import { createPageStore, ownerOf, recordOf, registerPage } from "./page-registry.js";
+import { createRouteKey, focusedKey, hasRoute, TabViewActions } from "./tab-view-router.js";
+import { useHasLoaded } from "../shared/use-has-loaded.js";
+
+type State = TabViewNavigationState<ParamListBase>;
+type Route = State["routes"][number];
+
+type TabViewHostProps = TabViewNavigationConfig & {
+    view: Adw.TabView;
+    state: State;
+    navigation: TabViewNavigationHelpers;
+    descriptors: TabViewDescriptorMap;
+};
+
+type TabContentProps = {
+    descriptor: TabViewDescriptor;
+    isFocused: boolean;
+};
+
+/** The native view of the surrounding tab view navigator and access to its pages. */
+type TabViewHandle = {
+    /** The `Adw.TabView` the navigator renders into. */
+    view: Adw.TabView;
+    /** Returns the native page of a route, or `null` when it is not in this view. */
+    getPage: (key: string) => Adw.TabPage | null;
+    /** Moves a route's page into another view, appending to its pinned or unpinned group by default. */
+    transferTab: (key: string, target: Adw.TabView, position?: number) => void;
+};
+
+const TabViewContext = createContext<TabViewHandle | null>(null);
+
+/** Returns the surrounding tab view navigator's native view and page access. */
+const useTabView = (): TabViewHandle => {
+    const handle = useContext(TabViewContext);
+
+    if (handle === null) {
+        throw new Error("useTabView must be called inside a tab view navigator.");
+    }
+
+    return handle;
+};
+
+const toIcon = (icon: TabViewIcon | null | undefined): Gio.Icon | null =>
+    typeof icon === "string" ? Gio.ThemedIcon.new(icon) : (icon ?? null);
+
+type PageSync = (page: Adw.TabPage, previous: AppliedOptions, next: AppliedOptions) => void;
+
+const sync =
+    <K extends keyof AppliedOptions>(key: K, set: (page: Adw.TabPage, value: AppliedOptions[K]) => void): PageSync =>
+    (page, previous, next) => {
+        if (previous[key] !== next[key]) {
+            set(page, next[key]);
+        }
+    };
+
+const pageSyncs: PageSync[] = [
+    sync("title", (page, title) => page.setTitle(title ?? "")),
+    sync("icon", (page, icon) => page.setIcon(toIcon(icon))),
+    sync("tooltip", (page, tooltip) => page.setTooltip(tooltip ?? "")),
+    sync("keyword", (page, keyword) => page.setKeyword(keyword ?? "")),
+    sync("loading", (page, loading) => page.setLoading(loading ?? false)),
+    sync("needsAttention", (page, value) => page.setNeedsAttention(value ?? false)),
+    sync("indicatorIcon", (page, icon) => page.setIndicatorIcon(toIcon(icon))),
+    sync("indicatorActivatable", (page, value) => page.setIndicatorActivatable(value ?? false)),
+    sync("indicatorTooltip", (page, value) => page.setIndicatorTooltip(value ?? "")),
+    sync("liveThumbnail", (page, value) => page.setLiveThumbnail(value ?? false)),
+    sync("thumbnailXalign", (page, value) => page.setThumbnailXalign(value ?? 0)),
+    sync("thumbnailYalign", (page, value) => page.setThumbnailYalign(value ?? 0)),
+];
+
+const applyPageOptions = (record: PageRecord, options: TabViewNavigationOptions): void => {
+    const next: AppliedOptions = { ...options, title: options.title ?? record.route.name };
+
+    for (const apply of pageSyncs) {
+        apply(record.page, record.applied, next);
+    }
+
+    record.applied = next;
+};
+
+type PagePlacement = {
+    position: number;
+    pinned: boolean;
+    parent?: PageRecord;
+};
+
+const createPage = (view: Adw.TabView, store: PageStore, route: Route, placement: PagePlacement): PageRecord => {
+    const host = new Adw.Bin();
+    const pinnedCount = view.getNPinnedPages();
+    const page = placement.pinned
+        ? view.insertPinned(host, Math.min(placement.position, pinnedCount))
+        : placement.parent !== undefined && ownerOf(placement.parent.page) === view
+          ? view.addPage(host, placement.parent.page)
+          : view.insert(host, Math.min(Math.max(placement.position, pinnedCount), view.getNPages()));
+    const record: PageRecord = { route, page, host, applied: {} };
+
+    registerPage(record);
+    store.set(record);
+
+    return record;
+};
+
+const presentRecord = (view: Adw.TabView, store: PageStore, key: string | undefined): PageRecord | undefined => {
+    const record = key === undefined ? undefined : store.get(key);
+
+    return record !== undefined && ownerOf(record.page) === view ? record : undefined;
+};
+
+const adoptPages = (view: Adw.TabView, store: PageStore): void => {
+    for (let position = 0; position < view.getNPages(); position += 1) {
+        const record = recordOf(view.getNthPage(position));
+
+        if (record !== undefined && store.get(record.route.key) === undefined) {
+            store.set(record);
+        }
+    }
+};
+
+const syncPages = (view: Adw.TabView, store: PageStore, state: State, descriptors: TabViewDescriptorMap): void => {
+    adoptPages(view, store);
+
+    for (const key of store.keys()) {
+        if (!hasRoute(state, key)) {
+            const record = store.get(key);
+            store.delete(key);
+
+            if (record !== undefined && ownerOf(record.page) === view) {
+                view.closePage(record.page);
+            }
+        }
+    }
+
+    state.routes.forEach((route, position) => {
+        if (store.get(route.key) === undefined) {
+            const parentKey = state.parents[route.key];
+
+            createPage(view, store, route, {
+                position,
+                pinned: state.pinnedKeys.includes(route.key),
+                parent: parentKey === undefined ? undefined : store.get(parentKey),
+            });
+        }
+    });
+
+    const present = state.routes.flatMap((route) => {
+        const record = presentRecord(view, store, route.key);
+
+        return record === undefined ? [] : [{ route, record }];
+    });
+
+    for (const { route, record } of present) {
+        const pinned = state.pinnedKeys.includes(route.key);
+
+        if (record.page.getPinned() !== pinned) {
+            view.setPagePinned(record.page, pinned);
+        }
+    }
+
+    present.forEach(({ record }, position) => {
+        if (view.getPagePosition(record.page) !== position) {
+            view.reorderPage(record.page, position);
+        }
+    });
+
+    for (const { route, record } of present) {
+        record.route = route;
+        applyPageOptions(record, descriptors[route.key]?.options ?? {});
+    }
+
+    const focus = focusedKey(state);
+    const focused = presentRecord(view, store, focus);
+
+    if (focus !== store.lastFocus) {
+        store.lastFocus = focus;
+
+        if (focused !== undefined && view.getSelectedPage() !== focused.page) {
+            view.setSelectedPage(focused.page);
+        }
+    }
+};
+
+const TabContent = ({ descriptor, isFocused }: TabContentProps): ReactNode => {
+    const hasLoaded = useHasLoaded(isFocused || descriptor.options.lazy === false);
+
+    return hasLoaded ? descriptor.render() : null;
+};
+
+const TabViewHost = (props: TabViewHostProps): ReactNode => {
+    const { view, state, navigation, descriptors } = props;
+    const { tabBarVisible, tabBarAutohide, tabBarExpand, tabBarInverted, overview, menuModel, renderMenu } = props;
+    const { extraDropTarget, onExtraDragDrop, onCreateWindow, onSetupMenu, shortcuts, defaultIcon } = props;
+    const [store] = useState(createPageStore);
+    const [placeholder, setPlaceholder] = useState<Adw.Bin | null>(null);
+    const [renderedMenu, setRenderedMenu] = useState<Gio.MenuModel | null>(null);
+    const selectedPage = useProperty(view, "selectedPage");
+    const focused = getFocusedRoute(state);
+    const descriptor = requireDescriptor(descriptors, focused.key);
+
+    useSyncExternalStore(store.subscribe, store.getVersion, store.getVersion);
+
+    if (menuModel != null && renderMenu !== undefined) {
+        throw new Error("Pass the tab view navigator either menuModel or renderMenu, not both.");
+    }
+
+    const menu = renderMenu === undefined ? (menuModel ?? null) : renderedMenu;
+
+    const routeOf = (page: Adw.TabPage): RouteProp<ParamListBase> | undefined => {
+        const key = recordOf(page)?.route.key;
+
+        return key === undefined ? undefined : descriptors[key]?.route;
+    };
+
+    const [handle] = useState<TabViewHandle>(() => ({
+        view,
+        getPage: (key) => presentRecord(view, store, key)?.page ?? null,
+        transferTab: (key, target, position) => {
+            const record = presentRecord(view, store, key);
+
+            if (record === undefined) {
+                throw new Error(`Route "${key}" has no page in this tab view.`);
+            }
+
+            const pinned = record.page.getPinned();
+            const minimum = pinned ? 0 : target.getNPinnedPages();
+            const maximum = pinned ? target.getNPinnedPages() : target.getNPages();
+            const index = position ?? maximum;
+
+            if (!Number.isInteger(index) || index < minimum || index > maximum) {
+                throw new RangeError("The position is outside the tab's pinned or unpinned group.");
+            }
+
+            view.transferPage(record.page, target, index);
+        },
+    }));
+
+    useLayoutEffect(() => {
+        if (placeholder === null) {
+            return;
+        }
+
+        placeholder.setChild(view);
+
+        return () => {
+            if (placeholder.getChild() === view) {
+                placeholder.setChild(null);
+            }
+        };
+    }, [placeholder, view]);
+
+    useLayoutEffect(() => {
+        view.setMenuModel(menu);
+    }, [view, menu]);
+
+    useLayoutEffect(() => {
+        if (shortcuts !== undefined) {
+            view.setShortcuts(shortcuts);
+        }
+    }, [view, shortcuts]);
+
+    useLayoutEffect(() => {
+        const icon = toIcon(defaultIcon);
+
+        if (icon !== null) {
+            view.setDefaultIcon(icon);
+        }
+    }, [view, defaultIcon]);
+
+    useLayoutEffect(() => {
+        syncPages(view, store, state, descriptors);
+    }, [view, store, state, descriptors]);
+
+    useLayoutEffect(() => {
+        const selected = view.getSelectedPage();
+        const key = selected === null ? undefined : recordOf(selected)?.route.key;
+        const current = navigation.getState();
+
+        if (key === undefined || !hasRoute(current, key) || focusedKey(current) === key) {
+            return;
+        }
+
+        const event = navigation.emit({ type: "tabPress", target: key, canPreventDefault: true });
+
+        if (event.defaultPrevented) {
+            const previous = presentRecord(view, store, focusedKey(current));
+
+            if (previous !== undefined) {
+                view.setSelectedPage(previous.page);
+            }
+
+            return;
+        }
+
+        navigation.dispatch(TabViewActions.selectTab(key));
+    }, [selectedPage, navigation, view, store]);
+
+    useSignal(view, "close-page", (page) => {
+        const key = recordOf(page)?.route.key;
+
+        if (key === undefined || !hasRoute(navigation.getState(), key)) {
+            view.closePageFinish(page, true);
+
+            return true;
+        }
+
+        navigation.dispatch(TabViewActions.closeTab(key));
+        view.closePageFinish(page, !hasRoute(navigation.getState(), key));
+
+        return true;
+    });
+
+    useSignal(view, "page-attached", (page, position) => {
+        const record = recordOf(page);
+
+        if (record === undefined || hasRoute(navigation.getState(), record.route.key)) {
+            return;
+        }
+
+        store.set(record);
+        navigation.dispatch({
+            type: "OPEN_TAB",
+            payload: { ...record.route, position, pinned: page.getPinned(), select: false },
+        });
+    });
+
+    useSignal(view, "page-detached", (page) => {
+        const key = recordOf(page)?.route.key;
+
+        if (key !== undefined && hasRoute(navigation.getState(), key)) {
+            navigation.dispatch(TabViewActions.closeTab(key));
+        }
+    });
+
+    useSignal(view, "page-reordered", (page, position) => {
+        const key = recordOf(page)?.route.key;
+
+        if (key !== undefined && hasRoute(navigation.getState(), key)) {
+            navigation.dispatch(TabViewActions.reorderTab(key, position));
+        }
+    });
+
+    useSignal(view, "indicator-activated", (page) => {
+        const key = recordOf(page)?.route.key;
+
+        if (key !== undefined && hasRoute(navigation.getState(), key)) {
+            navigation.emit({ type: "indicatorActivated", target: key });
+        }
+    });
+
+    useSignal(view, "setup-menu", (page) => {
+        onSetupMenu?.(page === null ? null : (routeOf(page) ?? null));
+    });
+
+    useSignal(view, "create-window", () => onCreateWindow?.() ?? undefined);
+
+    const createTab = (): Adw.TabPage | undefined => {
+        const target = overview?.onCreateTab?.();
+
+        if (target === undefined) {
+            return undefined;
+        }
+
+        const route: Route = { key: createRouteKey(target.name), name: target.name, params: target.params };
+        const record = createPage(view, store, route, { position: view.getNPages(), pinned: false });
+
+        navigation.dispatch({ type: "OPEN_TAB", payload: { ...route, position: view.getPagePosition(record.page) } });
+
+        if (!hasRoute(navigation.getState(), route.key)) {
+            store.delete(route.key);
+            view.closePage(record.page);
+
+            return undefined;
+        }
+
+        return record.page;
+    };
+
+    const drop = (page: Adw.TabPage, value: GObject.Value): boolean => {
+        const route = routeOf(page);
+
+        return route === undefined ? false : (onExtraDragDrop?.(route, value) ?? false);
+    };
+
+    const header =
+        descriptor.options.headerShown === false ? null : descriptor.options.header === undefined ? (
+            <HeaderBar options={descriptor.options} />
+        ) : (
+            <>
+                {descriptor.options.header({
+                    route: descriptor.route,
+                    navigation: descriptor.navigation,
+                    options: descriptor.options,
+                })}
+            </>
+        );
+
+    const content = (
+        <AdwToolbarView
+            top={
+                <>
+                    {header}
+                    <AdwTabBar
+                        view={view}
+                        visible={tabBarVisible ?? true}
+                        autohide={tabBarAutohide ?? true}
+                        expandTabs={tabBarExpand ?? true}
+                        inverted={tabBarInverted ?? false}
+                        extraDropTarget={extraDropTarget ?? null}
+                        onExtraDragDrop={drop}
+                    />
+                </>
+            }
+        >
+            <AdwBin ref={setPlaceholder} />
+        </AdwToolbarView>
+    );
+
+    return (
+        <TabViewContext.Provider value={handle}>
+            {overview === undefined ? (
+                content
+            ) : (
+                <AdwTabOverview
+                    view={view}
+                    open={overview.open}
+                    enableNewTab={overview.enableNewTab === true && overview.onCreateTab !== undefined}
+                    enableSearch={overview.enableSearch ?? true}
+                    extraDropTarget={extraDropTarget ?? null}
+                    onCreateTab={createTab}
+                    onExtraDragDrop={drop}
+                    onNotifyOpen={(open) => overview.onOpenChange?.(open ?? false)}
+                >
+                    {content}
+                </AdwTabOverview>
+            )}
+            {renderMenu === undefined ? null : createPortal(renderMenu(setRenderedMenu), rootElement)}
+            {state.routes.map((route) => {
+                const record = presentRecord(view, store, route.key);
+
+                return record === undefined
+                    ? null
+                    : createPortal(
+                          <TabContent
+                              descriptor={requireDescriptor(descriptors, route.key)}
+                              isFocused={route.key === focused.key}
+                          />,
+                          record.host,
+                          route.key,
+                      );
+            })}
+        </TabViewContext.Provider>
+    );
+};
+
+export { type TabViewHandle, TabViewHost, useTabView };