Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
import { FavoriteIcon } from '@app/features/favorites/FavoriteIcon';
import { t } from '@app/lib/i18n';
import {
favoriteSplitContent,
useFavoriteDisplayName,
} from '@app/util/favorites';
import { useSplitLayout } from '@components/app/split-layout/layout';
import { toast } from '@core/component/Toast/Toast';
import { createHotkeyGroup, registerHotkey } from '@core/hotkey/hotkeys';
import { registerScope } from '@core/hotkey/utils';
import Star from '@icon/system/regular/star.svg';
import { useFavoritesData } from '@queries/favorites/favorites';
import type { Favorite } from '@service-storage/generated/schemas/favorite';
import { createEffect, createRoot, onCleanup } from 'solid-js';
import { CommandState } from './state';
/** Command scope for the favorites sub-view of the command menu. */
export const FAVORITES_COMMAND_SCOPE = 'command-scope-favorites';
registerScope({
parentScopeId: 'global',
scopeId: FAVORITES_COMMAND_SCOPE,
type: 'command',
});
const FAVORITES_KEYWORDS = ['favorites', 'favorite', 'starred', 'pinned'];
/**
* Registers the "Favorites" command-menu command and keeps the per-favorite
* commands in its sub-view scope in sync with the favorites data. Renders
* nothing.
*/
export function FavoritesCommands() {
// Non-suspending accessor: command `condition()`s are evaluated during the
// command menu's setup under a Suspense boundary, where a pending or failed
// favorites query must not suspend or throw.
const favoritesData = useFavoritesData();
const { openWithSplit } = useSplitLayout();
const openFavorite = (favorite: Favorite) => {
const result = openWithSplit(favoriteSplitContent(favorite), {
referredFrom: 'kommand-menu',
allowDuplicate: favorite.entityType === 'foreign_entity',
});
if (result.status === 'reused' && result.owner !== result.sourceOwner) {
toast.alert(t('commandMenu.contentAlreadyOpen'));
}
CommandState.setFocusDestinationOnClose(true);
// Close the menu and clear the query once a favorite is opened.
CommandState.close();
CommandState.setQuery('');
};
const staticGroup = createHotkeyGroup();
const dynamicGroup = createHotkeyGroup();
staticGroup.addDisposer(
CommandState.registerCommandScopePlaceholder(FAVORITES_COMMAND_SCOPE, () =>
t('commandMenu.openFavoritePlaceholder')
)
);
staticGroup.add(
registerHotkey({
scopeId: 'global',
description: () => t('commands.favorites'),
// An empty sub-view is a dead end, so hide the command until the user
// has favorites.
condition: () => (favoritesData()?.favorites.length ?? 0) > 0,
keyDownHandler: () => true,
activateCommandScopeId: FAVORITES_COMMAND_SCOPE,
keywords: FAVORITES_KEYWORDS,
icon: Star,
})
);
let disposeFavoritePreviews: () => void = () => undefined;
const registerFavorites = (list: Favorite[]) => {
// Registered without a hotkey: bare digits would fight type-to-filter in
// the sub-view's search input. The entries are still listed and openable
// via arrow/enter or click (the handler runs with `e` undefined).
// `runWithInputFocused` is required even without a hotkey: entering the
// sub-view captures its commands while the menu's search input has focus,
// and the capture filter drops commands without this flag.
disposeFavoritePreviews = createRoot((dispose) => {
list.forEach((favorite) => {
const description = useFavoriteDisplayName(favorite);
dynamicGroup.add(
registerHotkey({
scopeId: FAVORITES_COMMAND_SCOPE,
description,
keyDownHandler: () => {
openFavorite(favorite);
return true;
},
commandPaletteIcon: (props) => (
<FavoriteIcon favorite={favorite} class={props.class} />
),
runWithInputFocused: true,
})
);
});
return dispose;
});
};
// Hotkey registrations are non-reactive, so sync them with the favorites
// data: dispose and re-register the per-favorite commands on every change.
createEffect(() => {
const data = favoritesData();
dynamicGroup.dispose();
disposeFavoritePreviews();
disposeFavoritePreviews = () => undefined;
if (!data) return;
registerFavorites(data.favorites);
});
onCleanup(() => {
dynamicGroup.dispose();
disposeFavoritePreviews();
staticGroup.dispose();
});
return null;
}