@feugene/granularity 0.49.0 → 0.50.0

package/dist/types/index.d.ts

@@ -72,6 +72,7 @@ export * from './components/GrSwitch';
 export * from './components/GrTable';
 export * from './components/GrTabPanels';
 export * from './components/GrTabs';
+export * from './components/GrTabsWithPanels';
 export * from './components/GrTextarea';
 export * from './components/GrTimeline';
 export * from './components/GrToaster';
@@ -114,6 +115,8 @@ export { useGrFormControl } from './composables/useGrFormControl';
 export type { GrFormControlProps, GrFormControlState } from './composables/useGrFormControl';
 export { GRANULARITY_THEME_STATE, granularityThemePlugin, initThemeEarly, useTheme } from './composables/useTheme';
 export type { ThemeName, UseThemeOptions } from './composables/useTheme';
+export { GRANULARITY_HOTKEYS_STATE, granularityHotkeysPlugin, useHotkeys } from './composables/useHotkeys';
+export type { GranularityHotkeysPluginOptions, GrHotkeyDefinition, GrHotkeyRegistry } from './composables/useHotkeys';
 export { GRANULARITY_TOAST_STATE, granularityToastPlugin, useToast } from './composables/useToast';
 export type { GranularityToastPluginOptions, GrToastTone, Toast, ToastInput, ToastPromiseMessages, ToastState, } from './composables/useToast';
 export { GR_TONES } from './components/shared/tones';

package/dist/types/internal/hotkeySequence.d.ts

@@ -0,0 +1,22 @@
+import type { ParsedHotkeyCombo } from './keyboard';
+/**
+ * Сопоставление последовательностей клавиш («G, затем I»).
+ *
+ * Хранится буфер недавних нажатий, а хвост буфера сверяется с шагами хоткея.
+ * Буфер, а не автомат на каждый хоткей: цепочки с общим началом (`g i` и `g p`)
+ * буфер разводит сам, тогда как набор автоматов пришлось бы синхронизировать
+ * между собой — и первый же сброс одного из них ронял бы второй.
+ */
+/** Пауза, после которой набранное забывается. */
+export declare const HOTKEY_SEQUENCE_TIMEOUT_MS = 1000;
+export interface HotkeySequenceTracker {
+    /**
+     * Принять нажатие. Возвращает `false`, если событие в буфер не пошло —
+     * потребителю это говорит, что состояние не изменилось.
+     */
+    push: (event: KeyboardEvent, now: number) => boolean;
+    /** Совпадает ли хвост буфера со всеми шагами. */
+    matches: (steps: readonly ParsedHotkeyCombo[], apple?: boolean) => boolean;
+    reset: () => void;
+}
+export declare function createHotkeySequenceTracker(timeoutMs?: number): HotkeySequenceTracker;

package/dist/types/internal/keyboard.d.ts

@@ -50,3 +50,48 @@ export declare function eventMatchesKey(event: KeyboardEvent, expected: string,
  * Буквы под исключение не попадают: `'a'` и Shift+A — разные намерения.
  */
 export declare function shiftSatisfied(event: KeyboardEvent, expectedKey: string, expectShift: boolean): boolean;
+/**
+ * Разбор строки сочетания — один на пакет.
+ *
+ * Синтаксис `mod+shift+k` читают и директива `v-hotkey`, и `GrCommandPalette`
+ * со своим слушателем на `window`. Разборов было два, почти одинаковых, и они
+ * молча разошлись: `esc` и `space` директива приводила к `Escape` и пробелу, а
+ * палитра оставляла как есть — то есть сравнивала `event.key === 'esc'`, что не
+ * бывает истиной никогда, и такой хоткей не срабатывал вовсе.
+ */
+export interface ParsedHotkeyCombo {
+    key: string;
+    ctrl: boolean;
+    meta: boolean;
+    alt: boolean;
+    shift: boolean;
+    /** `mod` — Cmd на macOS, Ctrl на остальных платформах. */
+    mod: boolean;
+}
+/**
+ * Имя клавиши в том виде, в каком его даёт `KeyboardEvent.key`.
+ *
+ * Регистр многобуквенных имён сохраняется (`ArrowUp`, `F6`): их сравнивают
+ * посимвольно. Одиночные символы приводятся к нижнему регистру — верхний у них
+ * означает Shift, а он объявляется отдельным токеном.
+ */
+export declare function normalizeHotkeyToken(token: string): string;
+export declare function parseHotkeyCombo(combo: string): ParsedHotkeyCombo | null;
+/**
+ * Последовательность шагов: `'g i'` — «G, затем I», `'mod+k p'` — «⌘K, затем P».
+ *
+ * Шаги делятся пробелом, аккорд внутри шага — плюсом. Аккорд оказывается
+ * частным случаем из одного шага, поэтому отдельного пути для него нет: `'mod+k'`
+ * разбирается тем же вызовом и даёт массив длины один.
+ *
+ * Сам пробел как клавиша пишется словом `space` и с разделителем не спорит.
+ */
+export declare function parseHotkeySequence(value: string): ParsedHotkeyCombo[];
+/**
+ * Совпадает ли событие с шагом сочетания.
+ *
+ * Проверки IME-композиции здесь намеренно нет: у потребителей разный момент,
+ * когда её задавать. Директива спрашивает один раз на событие, до перебора всех
+ * своих хоткеев, — зашитая внутрь проверка повторялась бы на каждом.
+ */
+export declare function matchesHotkeyCombo(event: KeyboardEvent, combo: ParsedHotkeyCombo, apple?: boolean): boolean;