@feugene/granularity 0.10.0 → 0.12.0

package/dist/types/src/components/GrConfirmDialog/GrConfirmDialog.vue.d.ts

@@ -48,7 +48,7 @@ type __VLS_Slots = {} & {
     footer?: (props: typeof __VLS_18) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrConfirmDialogProps>, {
-    title: string;
+    title: undefined;
     description: undefined;
     closeOnBackdrop: boolean;
     closeOnEsc: boolean;
@@ -58,10 +58,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     headerConfig: undefined;
     footerConfig: undefined;
     bodyConfig: undefined;
-    closeLabel: string;
+    closeLabel: undefined;
     buttonSize: undefined;
-    confirmText: string;
-    cancelText: string;
+    confirmText: undefined;
+    cancelText: undefined;
     confirmVariant: string;
     confirmTone: string;
     error: null;
@@ -73,7 +73,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     confirm: () => void;
     cancel: () => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrConfirmDialogProps>, {
-    title: string;
+    title: undefined;
     description: undefined;
     closeOnBackdrop: boolean;
     closeOnEsc: boolean;
@@ -83,10 +83,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     headerConfig: undefined;
     footerConfig: undefined;
     bodyConfig: undefined;
-    closeLabel: string;
+    closeLabel: undefined;
     buttonSize: undefined;
-    confirmText: string;
-    cancelText: string;
+    confirmText: undefined;
+    cancelText: undefined;
     confirmVariant: string;
     confirmTone: string;
     error: null;

package/dist/types/src/components/GrDataTable/GrDataTable.vue.d.ts

@@ -11,10 +11,20 @@ export interface GrDataTableProps<TRow extends Record<string, unknown> = Record<
     columns: GrDataColumn[];
     /** Ключ строки или функция-резолвер. По умолчанию — поле `'id'`. */
     rowKey?: GrDataTableRowKey<TRow>;
-    /** Ключ колонки для начальной сортировки. */
+    /** Ключ колонки для начальной сортировки (uncontrolled-режим). */
     initialSortKey?: string;
-    /** Направление начальной сортировки. */
+    /** Направление начальной сортировки (uncontrolled-режим). */
     initialSortDir?: 'asc' | 'desc';
+    /** Контролируемый ключ сортировки: `v-model:sortKey`. Задаёт controlled-режим. */
+    sortKey?: string;
+    /** Контролируемое направление сортировки: `v-model:sortDir`. */
+    sortDir?: 'asc' | 'desc';
+    /**
+     * Внешняя сортировка (например серверная): компонент НЕ сортирует `rows`
+     * сам, а только сообщает о смене через `update:sortKey`/`update:sortDir`/
+     * `sort-change`. `rows` при этом должны приходить уже отсортированными.
+     */
+    externalSort?: boolean;
     density?: GrTableDensity;
     caption?: string;
     ariaLabel?: string;
@@ -22,7 +32,14 @@ export interface GrDataTableProps<TRow extends Record<string, unknown> = Record<
     regionLabel?: string;
 }
 declare const __VLS_export: <TRow extends Record<string, unknown> = Record<string, unknown>>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & __VLS_PrettifyLocal<GrDataTableProps<TRow>> & (typeof globalThis extends {
+    props: import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & __VLS_PrettifyLocal<GrDataTableProps<TRow> & {
+        "onUpdate:sortKey"?: ((value: string) => any) | undefined;
+        "onUpdate:sortDir"?: ((value: "desc" | "asc") => any) | undefined;
+        "onSort-change"?: ((value: {
+            key: string;
+            dir: "asc" | "desc";
+        }) => any) | undefined;
+    }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: {}) => void;
@@ -38,9 +55,16 @@ declare const __VLS_export: <TRow extends Record<string, unknown> = Record<strin
     } & {
         foot?: (props: {}) => any;
     };
-    emit: {};
+    emit: {
+        (e: "update:sortKey", value: string): void;
+        (e: "update:sortDir", value: "asc" | "desc"): void;
+        (e: "sort-change", value: {
+            key: string;
+            dir: "asc" | "desc";
+        }): void;
+    };
 }>) => import("vue").VNode & {
-    __ctx?: Awaited<typeof __VLS_setup>;
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/src/components/GrDialog/GrDialog.vue.d.ts

@@ -30,7 +30,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     headerConfig: undefined;
     footerConfig: undefined;
     bodyConfig: undefined;
-    closeLabel: string;
+    closeLabel: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: boolean) => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDialogProps>, {
@@ -43,7 +43,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     headerConfig: undefined;
     footerConfig: undefined;
     bodyConfig: undefined;
-    closeLabel: string;
+    closeLabel: undefined;
 }>>> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {

package/dist/types/src/components/GrDialog/GrDialogHeader.vue.d.ts

@@ -15,14 +15,14 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     title: undefined;
     showCloseButton: boolean;
     config: undefined;
-    closeLabel: string;
+    closeLabel: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     close: () => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDialogHeaderProps>, {
     title: undefined;
     showCloseButton: boolean;
     config: undefined;
-    closeLabel: string;
+    closeLabel: undefined;
 }>>> & Readonly<{
     onClose?: (() => any) | undefined;
 }>, {

package/dist/types/src/components/GrDivider/GrDivider.vue.d.ts

@@ -0,0 +1,58 @@
+/**
+ * GrDivider — разделитель контента.
+ *
+ * - `orientation="horizontal"` (по умолчанию) — линия на всю ширину; с `label`
+ *   или default-слотом рисует текст по центру/краю между отрезками линии.
+ * - `orientation="vertical"` — тонкая вертикальная линия (для inline-разделения,
+ *   например в тулбарах).
+ */
+export type GrDividerOrientation = 'horizontal' | 'vertical';
+export type GrDividerAlign = 'start' | 'center' | 'end';
+type __VLS_Props = {
+    orientation?: GrDividerOrientation;
+    label?: string;
+    align?: GrDividerAlign;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    orientation: string;
+    label: undefined;
+    align: string;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    orientation: string;
+    label: undefined;
+    align: string;
+}>>> & Readonly<{}>, {
+    label: string;
+    align: GrDividerAlign;
+    orientation: GrDividerOrientation;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/types/src/components/GrDivider/config.d.ts

@@ -0,0 +1 @@
+export declare const grDividerConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrDivider">;

package/dist/types/src/components/GrDivider/index.d.ts

@@ -0,0 +1,4 @@
+export { default } from './GrDivider.vue';
+export { default as GrDivider } from './GrDivider.vue';
+export type { GrDividerAlign, GrDividerOrientation } from './GrDivider.vue';
+export { grDividerConfig } from './config';

package/dist/types/src/components/GrDrawer/GrDrawer.vue.d.ts

@@ -15,13 +15,13 @@ export interface GrDrawerProps {
     /** i18n-friendly aria-label для кнопки закрытия. */
     closeLabel?: string;
 }
-declare var __VLS_47: {}, __VLS_68: {}, __VLS_70: {};
+declare var __VLS_46: {}, __VLS_67: {}, __VLS_69: {};
 type __VLS_Slots = {} & {
-    title?: (props: typeof __VLS_47) => any;
+    title?: (props: typeof __VLS_46) => any;
 } & {
-    default?: (props: typeof __VLS_68) => any;
+    default?: (props: typeof __VLS_67) => any;
 } & {
-    footer?: (props: typeof __VLS_70) => any;
+    footer?: (props: typeof __VLS_69) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDrawerProps>, {
     title: undefined;
@@ -29,7 +29,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     closeOnEsc: boolean;
     side: string;
     size: string;
-    closeLabel: string;
+    closeLabel: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: boolean) => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDrawerProps>, {
@@ -38,7 +38,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     closeOnEsc: boolean;
     side: string;
     size: string;
-    closeLabel: string;
+    closeLabel: undefined;
 }>>> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {

package/dist/types/src/components/GrDropdown/GrDropdown.vue.d.ts

@@ -11,12 +11,19 @@ export interface GrDropdownProps {
     /** Куда телепортировать панель (`body` по умолчанию). */
     teleportTo?: string | HTMLElement;
 }
+declare function onTriggerKeydown(event: KeyboardEvent): void;
 declare function toggle(): void;
 declare function close(): void;
 declare var __VLS_1: {
     open: boolean;
     toggle: typeof toggle;
     close: typeof close;
+    triggerProps: {
+        'aria-haspopup': "menu";
+        'aria-expanded': boolean;
+        'aria-controls': string | undefined;
+        onKeydown: typeof onTriggerKeydown;
+    };
 }, __VLS_15: {
     close: typeof close;
 };

package/dist/types/src/components/GrDropdownMenu/GrDropdownMenu.vue.d.ts

@@ -22,6 +22,12 @@ declare var __VLS_9: {
     open: boolean;
     toggle: () => void;
     close: () => void;
+    triggerProps: {
+        'aria-haspopup': "menu";
+        'aria-expanded': boolean;
+        'aria-controls': string | undefined;
+        onKeydown: (event: KeyboardEvent) => void;
+    };
 }, __VLS_18: {
     close: () => void;
 };

package/dist/types/src/components/GrFileUpload/GrFileUpload.vue.d.ts

@@ -113,10 +113,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     withCredentials: boolean;
     showFileList: boolean;
     uploadExtraData: undefined;
-    placeholder: string;
+    placeholder: undefined;
     showProgress: boolean;
     progressTone: string;
-    progressLabel: string;
+    progressLabel: undefined;
     hideProgressOnSuccess: number;
 }>>, {
     uploadFiles: typeof handleFiles;
@@ -143,10 +143,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     withCredentials: boolean;
     showFileList: boolean;
     uploadExtraData: undefined;
-    placeholder: string;
+    placeholder: undefined;
     showProgress: boolean;
     progressTone: string;
-    progressLabel: string;
+    progressLabel: undefined;
     hideProgressOnSuccess: number;
 }>>> & Readonly<{
     onSuccess?: ((payload: any) => any) | undefined;

package/dist/types/src/components/GrFormField/GrFormField.vue.d.ts

@@ -1,28 +1,41 @@
 type LabelClass = string | string[] | Record<string, boolean>;
 type __VLS_Props = {
     label?: string;
+    /** Явный id контрола. Если не задан — генерируется автоматически. */
     forId?: string;
     error?: string;
+    /** Подсказка под лейблом/над контролом (можно также через слот `#hint`). */
+    hint?: string;
+    /** Помечает поле обязательным (маркер `*` + `aria-required` у контрола). */
+    required?: boolean;
     labelClass?: LabelClass;
 };
-declare var __VLS_1: {};
+declare var __VLS_1: {}, __VLS_3: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+    hint?: (props: typeof __VLS_1) => any;
+} & {
+    default?: (props: typeof __VLS_3) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
     label: undefined;
     forId: undefined;
     error: undefined;
+    hint: undefined;
+    required: boolean;
     labelClass: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
     label: undefined;
     forId: undefined;
     error: undefined;
+    hint: undefined;
+    required: boolean;
     labelClass: undefined;
 }>>> & Readonly<{}>, {
     label: string;
+    required: boolean;
     error: string;
     forId: string;
+    hint: string;
     labelClass: LabelClass;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/types/src/components/GrFormField/context.d.ts

@@ -0,0 +1,20 @@
+import { type ComputedRef, type InjectionKey } from 'vue';
+/**
+ * Контекст поля формы, который `GrFormField` предоставляет своим контролам
+ * (`GrInput` / `GrSelect` / `GrTextarea`). Контролы читают его через
+ * {@link useGrFormFieldContext} и используют как fallback для `id`,
+ * `aria-describedby` и `aria-invalid` — без ручного прокидывания `forId`.
+ */
+export interface GrFormFieldContext {
+    /** Сгенерированный (или переданный `forId`) id контрола. */
+    id: ComputedRef<string | undefined>;
+    /** `aria-describedby`: id подсказки и/или сообщения об ошибке. */
+    describedById: ComputedRef<string | undefined>;
+    /** Невалидно ли поле (есть `error`). */
+    invalid: ComputedRef<boolean>;
+    /** Обязательное ли поле. */
+    required: ComputedRef<boolean>;
+}
+export declare const GR_FORM_FIELD_KEY: InjectionKey<GrFormFieldContext>;
+/** Возвращает контекст поля формы или `null`, если контрол вне `GrFormField`. */
+export declare function useGrFormFieldContext(): GrFormFieldContext | null;

package/dist/types/src/components/GrFormField/index.d.ts

@@ -1,3 +1,4 @@
 export { default } from './GrFormField.vue';
 export { default as GrFormField } from './GrFormField.vue';
+export { GR_FORM_FIELD_KEY, useGrFormFieldContext, type GrFormFieldContext } from './context';
 export { grFormFieldConfig } from './config';

package/dist/types/src/components/GrFormFile/GrFormFile.vue.d.ts

@@ -38,11 +38,11 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     multiple: boolean;
     disabled: boolean;
     accept: undefined;
-    uploadText: string;
-    changeText: string;
-    removeText: string;
-    clearAllText: string;
-    placeholder: string;
+    uploadText: undefined;
+    changeText: undefined;
+    removeText: undefined;
+    clearAllText: undefined;
+    placeholder: undefined;
     validators: undefined;
     validate: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -55,18 +55,18 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     multiple: boolean;
     disabled: boolean;
     accept: undefined;
-    uploadText: string;
-    changeText: string;
-    removeText: string;
-    clearAllText: string;
-    placeholder: string;
+    uploadText: undefined;
+    changeText: undefined;
+    removeText: undefined;
+    clearAllText: undefined;
+    placeholder: undefined;
     validators: undefined;
     validate: undefined;
 }>>> & Readonly<{
     "onUpdate:modelValue"?: ((value: File | File[] | null) => any) | undefined;
+    onClear?: (() => any) | undefined;
     onChange?: ((value: File | File[] | null) => any) | undefined;
     onValidation?: ((errors: FileValidationIssue[]) => any) | undefined;
-    onClear?: (() => any) | undefined;
     "onUpdate:errors"?: ((errors: FileValidationIssue[]) => any) | undefined;
 }>, {
     disabled: boolean;

package/dist/types/src/components/GrImageViewer/GrImageViewer.vue.d.ts

@@ -8,6 +8,10 @@
  *   show-progress
  *   hide-on-click-modal
  * />
+ *
+ * Логика вынесена в composables: `useZoomPan` (масштаб/поворот/пан + метрики),
+ * `useWheelGesture` (зум колесом/трекпадом с rAF-батчингом), `useViewerKeyboard`
+ * (клавиатура). Сам SFC отвечает за оверлей, индекс изображений и композицию.
  */
 type __VLS_Props = {
     modelValue: boolean;
@@ -106,15 +110,15 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     wheelZoom: boolean;
     draggable: boolean;
     zIndex: undefined;
-    closeLabel: string;
-    prevLabel: string;
-    nextLabel: string;
-    zoomInLabel: string;
-    zoomOutLabel: string;
-    resetZoomLabel: string;
-    rotateLeftLabel: string;
-    rotateRightLabel: string;
-    emptyText: string;
+    closeLabel: undefined;
+    prevLabel: undefined;
+    nextLabel: undefined;
+    zoomInLabel: undefined;
+    zoomOutLabel: undefined;
+    resetZoomLabel: undefined;
+    rotateLeftLabel: undefined;
+    rotateRightLabel: undefined;
+    emptyText: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: boolean) => void;
     close: () => void;
@@ -132,15 +136,15 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     wheelZoom: boolean;
     draggable: boolean;
     zIndex: undefined;
-    closeLabel: string;
-    prevLabel: string;
-    nextLabel: string;
-    zoomInLabel: string;
-    zoomOutLabel: string;
-    resetZoomLabel: string;
-    rotateLeftLabel: string;
-    rotateRightLabel: string;
-    emptyText: string;
+    closeLabel: undefined;
+    prevLabel: undefined;
+    nextLabel: undefined;
+    zoomInLabel: undefined;
+    zoomOutLabel: undefined;
+    resetZoomLabel: undefined;
+    rotateLeftLabel: undefined;
+    rotateRightLabel: undefined;
+    emptyText: undefined;
 }>>> & Readonly<{
     onClose?: (() => any) | undefined;
     onSwitch?: ((newIndex: number) => any) | undefined;

package/dist/types/src/components/GrImageViewer/composables/useViewerKeyboard.d.ts

@@ -0,0 +1,20 @@
+export interface ViewerKeyboardActions {
+    close: () => void;
+    prev: () => void;
+    next: () => void;
+    zoomIn: () => void;
+    zoomOut: () => void;
+    reset: () => void;
+}
+export interface UseViewerKeyboardOptions {
+    /** Закрывать ли по Escape (проп `closeOnPressEscape`). */
+    closeOnEscape: () => boolean;
+    actions: ViewerKeyboardActions;
+}
+/**
+ * useViewerKeyboard — клавиатурное управление просмотрщиком:
+ * Esc — закрыть, стрелки — переключение, `+`/`-`/`0` — зум/сброс.
+ */
+export declare function useViewerKeyboard(options: UseViewerKeyboardOptions): {
+    onKeydown: (event: KeyboardEvent) => void;
+};

package/dist/types/src/components/GrImageViewer/composables/useWheelGesture.d.ts

@@ -0,0 +1,16 @@
+export interface UseWheelGestureOptions {
+    /** Разрешён ли зум колесом (проп `wheelZoom` + наличие изображений). */
+    enabled: () => boolean;
+    /** Применить множитель масштаба (накопленный за кадр). */
+    applyZoomFactor: (factor: number) => void;
+}
+/**
+ * useWheelGesture — масштабирование колесом мыши / жестом трекпада с батчингом
+ * по `requestAnimationFrame` (рендер не чаще кадра — без «дёрганья»/наслоения) и
+ * временным отключением CSS-перехода на время жеста (`isWheelZooming`).
+ */
+export declare function useWheelGesture(options: UseWheelGestureOptions): {
+    isWheelZooming: import("vue").Ref<boolean, boolean>;
+    onWheel: (event: WheelEvent) => void;
+    endWheelZoom: () => void;
+};

package/dist/types/src/components/GrImageViewer/composables/useZoomPan.d.ts

@@ -0,0 +1,50 @@
+import { type Ref } from 'vue';
+export declare function formatPercent(value: number): string;
+export interface UseZoomPanOptions {
+    minScale: () => number;
+    maxScale: () => number;
+    zoomRate: () => number;
+    draggable: () => boolean;
+    /** Ссылка на `<img>` — для измерения layout-размера и подписки ResizeObserver. */
+    imageEl: Ref<HTMLImageElement | null>;
+    /** Колбэк на поворот (эмит `rotate`). */
+    onRotate: (deg: number) => void;
+}
+/**
+ * useZoomPan — состояние и логика масштаба/поворота/панорамирования картинки,
+ * а также метрики (натуральный/вписанный/фактический размер, реальный масштаб).
+ * Вынесено из монолитного `GrImageViewer.vue`.
+ */
+export declare function useZoomPan(options: UseZoomPanOptions): {
+    scale: Ref<number, number>;
+    rotation: Ref<number, number>;
+    offsetX: Ref<number, number>;
+    offsetY: Ref<number, number>;
+    isDragging: Ref<boolean, boolean>;
+    naturalWidth: Ref<number, number>;
+    naturalHeight: Ref<number, number>;
+    fittedWidth: Ref<number, number>;
+    fittedHeight: Ref<number, number>;
+    imageStyle: import("vue").ComputedRef<{
+        transform: string;
+    }>;
+    zoomValueText: import("vue").ComputedRef<string>;
+    renderedWidth: import("vue").ComputedRef<number>;
+    renderedHeight: import("vue").ComputedRef<number>;
+    realScale: import("vue").ComputedRef<number>;
+    realScalePercent: import("vue").ComputedRef<string>;
+    setScale: (value: number) => void;
+    zoomIn: () => void;
+    zoomOut: () => void;
+    rotateLeft: () => void;
+    rotateRight: () => void;
+    resetTransform: () => void;
+    resetImageMetrics: () => void;
+    measureFitted: () => void;
+    onImageLoad: (event: Event) => void;
+    startObservingImage: () => void;
+    stopObservingImage: () => void;
+    onPointerDown: (event: PointerEvent) => void;
+    onPointerMove: (event: PointerEvent) => void;
+    onPointerUp: (event: PointerEvent) => void;
+};