@feugene/granularity 0.19.0 → 0.21.0

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

@@ -1,129 +0,0 @@
-import { type GrFormRules, type GrFormTrigger } from './validation';
-export type { GrFormFileRule, GrFormRule, GrFormRules, GrFormTrigger, GrFormValidatorResult, } from './validation';
-/**
- * Публичный GR-примитив «Form» — оркестрация валидации над `GrFormField`.
- *
- * Модель формы (`v-model`-объект приложения) + декларативные `rules` по имени поля.
- * Форма прогоняет правила, раскладывает ошибки по контексту, скроллит к первой
- * ошибке и эмитит `submit` только при валидной форме. Императивный API — через
- * template ref (`validate` / `validateField` / `clearValidate` / `resetFields` /
- * `scrollToField`).
- */
-export interface GrFormProps {
-    /** Реактивный объект данных формы. Поля адресуются по `name` (`GrFormField`), в т.ч. dot-path. */
-    model: Record<string, unknown>;
-    /** Правила валидации по имени поля: `{ email: [{ required: true, type: 'email' }] }`. */
-    rules?: GrFormRules;
-    /** Валидировать поле при потере фокуса. */
-    validateOnBlur?: boolean;
-    /** Валидировать поле при каждом изменении значения. */
-    validateOnChange?: boolean;
-    /** Скроллить к первому невалидному полю после `validate()`. */
-    scrollToError?: boolean;
-    scrollBehavior?: ScrollBehavior;
-    /**
-     * Выключить форму целиком — типично на время отправки. Доезжает до контролов
-     * через контекст поля, поэтому обходить их по одному не нужно.
-     */
-    disabled?: boolean;
-}
-export interface GrFormEmits {
-    /** Форма прошла валидацию по submit. Отдаёт `model`. */
-    (e: 'submit', model: Record<string, unknown>): void;
-    /** Результат валидации одного поля. */
-    (e: 'validate', name: string, valid: boolean, message: string | undefined): void;
-    /**
-     * Submit не прошёл валидацию. Без этого события «форма невалидна» и «ничего
-     * не произошло» выглядят для потребителя одинаково.
-     */
-    (e: 'invalid', errors: Record<string, string>): void;
-}
-declare function validateField(name: string, trigger?: GrFormTrigger): Promise<boolean>;
-declare function validate(): Promise<boolean>;
-declare function clearValidate(names?: string | string[]): void;
-/**
- * Переснять «исходное» состояние. Нужен формам редактирования: модель там
- * наполняется после ответа сервера, а снимок в `setup` фиксировал пустой
- * объект — и `resetFields()` возвращал не «как было при загрузке», а пустоту.
- */
-declare function setSnapshot(model?: Record<string, unknown>): void;
-declare function resetFields(names?: string | string[]): void;
-declare function scrollToField(name: string): void;
-declare var __VLS_1: {
-    validate: typeof validate;
-    errors: Record<string, string | undefined>;
-    isDirty: boolean;
-    isValid: boolean;
-    validatingFields: Set<string> & Omit<Set<string>, keyof Set<any>>;
-    resetFields: typeof resetFields;
-    setSnapshot: typeof setSnapshot;
-};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormProps>, {
-    rules: undefined;
-    validateOnBlur: boolean;
-    validateOnChange: boolean;
-    scrollToError: boolean;
-    scrollBehavior: string;
-    disabled: boolean;
-}>>, {
-    validate: typeof validate;
-    validateField: typeof validateField;
-    clearValidate: typeof clearValidate;
-    resetFields: typeof resetFields;
-    scrollToField: typeof scrollToField;
-    setSnapshot: typeof setSnapshot;
-    isDirty: import("vue").ComputedRef<boolean>;
-    isValid: import("vue").ComputedRef<boolean>;
-    validatingFields: import("vue").ComputedRef<Set<string> & Omit<Set<string>, keyof Set<any>>>;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    submit: (model: Record<string, unknown>) => void;
-    validate: (name: string, valid: boolean, message: string | undefined) => void;
-    invalid: (errors: Record<string, string>) => void;
-}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormProps>, {
-    rules: undefined;
-    validateOnBlur: boolean;
-    validateOnChange: boolean;
-    scrollToError: boolean;
-    scrollBehavior: string;
-    disabled: boolean;
-}>>> & Readonly<{
-    onSubmit?: ((model: Record<string, unknown>) => any) | undefined;
-    onInvalid?: ((errors: Record<string, string>) => any) | undefined;
-    onValidate?: ((name: string, valid: boolean, message: string | undefined) => any) | undefined;
-}>, {
-    scrollBehavior: ScrollBehavior;
-    disabled: boolean;
-    rules: GrFormRules;
-    validateOnBlur: boolean;
-    validateOnChange: boolean;
-    scrollToError: boolean;
-}, {}, {}, {}, 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/GrForm/index.d.ts

@@ -1,10 +0,0 @@
-import type { ComponentExposed } from '../shared/instance';
-import type GrFormComponent from './GrForm.vue';
-export { default } from './GrForm.vue';
-export { default as GrForm } from './GrForm.vue';
-export { grFormConfig } from './config';
-export { GR_FORM_KEY, type GrFormContext, useGrFormContext } from './context';
-export type { GrFormFileRule, GrFormProps, GrFormRule, GrFormRules, GrFormTrigger, GrFormValidatorResult, } from './GrForm.vue';
-export { createGrFormMessageResolver, getByPath, type GrFormMessageResolver, type GrFormMessageTranslate, type GrFormRuleFailure, isEmpty, runFieldRules, } from './validation';
-export type { GrFormEmits } from './GrForm.vue';
-export type GrFormInstance = ComponentExposed<typeof GrFormComponent>;

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

@@ -1,122 +0,0 @@
-import { type GrFormFieldLabelPosition, type GrFormFieldSize } from './grFormFieldStyles';
-export interface GrFormFieldProps {
-    label?: string;
-    /**
-     * Имя поля в модели `GrForm` (в т.ч. dot-path `address.city`). Когда поле внутри
-     * `GrForm` и задан `name`, ошибка и признак обязательности берутся из формы по
-     * этому имени, а потеря фокуса триггерит валидацию поля.
-     */
-    name?: string;
-    /** Явный id контрола. Если не задан — генерируется автоматически. */
-    forId?: string;
-    /**
-     * Явная ошибка (или несколько). Перекрывает ошибку из `GrForm` — ручной
-     * режим без формы тоже здесь. Массив нужен там, где источник ошибок один,
-     * а претензий несколько: ответ сервера, валидация файла.
-     */
-    error?: string | string[];
-    /** Подсказка под лейблом/над контролом (можно также через слот `#hint`). */
-    hint?: string;
-    /** Помечает поле обязательным (маркер `*` + `aria-required` у контрола). */
-    required?: boolean;
-    /** Всё поле только для чтения: контролы внутри перестают редактироваться. */
-    readonly?: boolean;
-    /** Поле недоступно. Складывается с `disabled` формы по «или». */
-    disabled?: boolean;
-    /**
-     * Показывать текст ошибки. `false` — поле остаётся невалидным для контрола
-     * и AT (`aria-invalid`), но сообщение не занимает места: так делают в
-     * плотных таблицах-формах, где ошибка объясняется сводкой сверху.
-     */
-    showMessage?: boolean;
-    /** Размер подписи, подсказки и ошибки. Не задан — из `GrConfigProvider`, иначе `md`. */
-    size?: GrFormFieldSize;
-    /** Подпись сверху (по умолчанию) или сбоку — для плотных форм. */
-    labelPosition?: GrFormFieldLabelPosition;
-    /** Ширина колонки подписи при `labelPosition="start"`. Число — пиксели. */
-    labelWidth?: string | number;
-    labelClass?: LabelClass;
-}
-import './defaults';
-type LabelClass = string | string[] | Record<string, boolean>;
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {
-    errors: string[];
-};
-type __VLS_Slots = {} & {
-    label?: (props: typeof __VLS_1) => any;
-} & {
-    hint?: (props: typeof __VLS_3) => any;
-} & {
-    default?: (props: typeof __VLS_5) => any;
-} & {
-    error?: (props: typeof __VLS_7) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormFieldProps>, {
-    label: undefined;
-    name: undefined;
-    forId: undefined;
-    error: undefined;
-    hint: undefined;
-    required: boolean;
-    readonly: boolean;
-    disabled: boolean;
-    showMessage: boolean;
-    size: undefined;
-    labelPosition: undefined;
-    labelWidth: undefined;
-    labelClass: undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormFieldProps>, {
-    label: undefined;
-    name: undefined;
-    forId: undefined;
-    error: undefined;
-    hint: undefined;
-    required: boolean;
-    readonly: boolean;
-    disabled: boolean;
-    showMessage: boolean;
-    size: undefined;
-    labelPosition: undefined;
-    labelWidth: undefined;
-    labelClass: undefined;
-}>>> & Readonly<{}>, {
-    size: GrFormFieldSize;
-    labelPosition: GrFormFieldLabelPosition;
-    readonly: boolean;
-    label: string;
-    name: string;
-    error: string | string[];
-    disabled: boolean;
-    required: boolean;
-    forId: string;
-    hint: string;
-    showMessage: boolean;
-    labelWidth: string | number;
-    labelClass: LabelClass;
-}, {}, {}, {}, 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/GrFormField/index.d.ts

@@ -1,8 +0,0 @@
-export { default } from './GrFormField.vue';
-export { default as GrFormField } from './GrFormField.vue';
-export { GR_FORM_FIELD_KEY, type GrFormFieldContext, useGrFormFieldContext } from './context';
-export { grFormFieldConfig } from './config';
-export type { GrFormFieldConfigurableProps } from './defaults';
-export type { GrFormFieldLabelPosition, GrFormFieldSize } from './grFormFieldStyles';
-export { grFormFieldSafelist } from './safelist';
-export type { GrFormFieldProps } from './GrFormField.vue';

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

@@ -1,8 +0,0 @@
-export { default } from './GrFormSection.vue';
-export { default as GrFormSection } from './GrFormSection.vue';
-export type { GrFormSectionProps } from './GrFormSection.vue';
-export { grFormSectionConfig } from './config';
-export type { GrFormSectionConfigurableProps } from './defaults';
-export { GR_FORM_SECTION_HEADING_LEVELS } from './grFormSectionStyles';
-export type { GrFormSectionHeadingLevel } from './grFormSectionStyles';
-export { grFormSectionSafelist } from './safelist';

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

@@ -1,271 +0,0 @@
-/**
- * Usage:
- *
- * <GrImageViewer
- *   v-model="open"
- *   :url-list="images"
- *   :initial-index="0"
- *   show-progress
- *   hide-on-click-modal
- * />
- *
- * Логика вынесена в composables: `useZoomPan` (масштаб/поворот/пан + метрики),
- * `useWheelGesture` (зум колесом/трекпадом с rAF-батчингом), `useViewerKeyboard`
- * (клавиатура). Сам SFC отвечает за оверлей, индекс изображений и композицию.
- */
-/** Кадр просмотрщика: только адрес или адрес с альтернативным текстом. */
-export type GrImageViewerItem = {
-    src: string;
-    alt?: string;
-};
-export type GrImageViewerSource = string | GrImageViewerItem;
-export interface GrImageViewerProps {
-    modelValue: boolean;
-    /**
-     * Кадры. Строка — только адрес; объект `{ src, alt }` даёт изображению
-     * альтернативный текст: без него просмотрщик пуст для незрячего
-     * пользователя, а придумать текст за потребителя компонент не может.
-     */
-    urlList: GrImageViewerSource[];
-    initialIndex?: number;
-    zoomRate?: number;
-    minScale?: number;
-    maxScale?: number;
-    hideOnClickModal?: boolean;
-    closeOnPressEscape?: boolean;
-    showProgress?: boolean;
-    showZoomValue?: boolean;
-    /** Включает масштабирование колесом мыши / жестом на трекпаде. По умолчанию включено. */
-    wheelZoom?: boolean;
-    /** Включает перетаскивание (pan) картинки мышью. При наведении курсор «рука». По умолчанию выключено. */
-    draggable?: boolean;
-    /**
-     * Имя CSS-переменной слоя — escape-hatch мимо `--gr-z-modal`. Сырое число
-     * компонент не принимает: слой задаётся шкалой, см. `docs/z-index.md`.
-     */
-    zIndexVar?: string;
-    /** i18n: aria-label кнопки закрытия. */
-    closeLabel?: string;
-    /** i18n: aria-label кнопки «предыдущее изображение». */
-    prevLabel?: string;
-    /** i18n: aria-label кнопки «следующее изображение». */
-    nextLabel?: string;
-    /** i18n: aria-label кнопки «увеличить». */
-    zoomInLabel?: string;
-    /** i18n: aria-label кнопки «уменьшить». */
-    zoomOutLabel?: string;
-    /** i18n: aria-label кнопки «сбросить масштаб». */
-    resetZoomLabel?: string;
-    /** i18n: aria-label кнопки «до натурального размера». */
-    zoomToNaturalLabel?: string;
-    /** i18n: aria-label кнопки «повернуть влево». */
-    rotateLeftLabel?: string;
-    /** i18n: aria-label кнопки «повернуть вправо». */
-    rotateRightLabel?: string;
-    /** Показывать кнопку скачивания текущего кадра. */
-    showDownload?: boolean;
-    /** i18n: aria-label кнопки «скачать». */
-    downloadLabel?: string;
-    /** i18n: текст в пустом состоянии (нет изображений). */
-    emptyText?: string;
-    /**
-     * Доступное имя слоя. Модальный диалог без имени — нарушение
-     * `aria-dialog-name`: диктор объявит «диалог» и замолчит.
-     */
-    ariaLabel?: string;
-}
-export interface GrImageViewerEmits {
-    (e: 'update:modelValue', value: boolean): void;
-    (e: 'close'): void;
-    /** Показан другой кадр. */
-    (e: 'change', newIndex: number): void;
-    (e: 'rotate', deg: number): void;
-    /** Нажата кнопка скачивания. Само скачивание компонент уже запустил. */
-    (e: 'download', payload: {
-        src: string;
-        alt: string;
-        index: number;
-    }): void;
-}
-type GrImageViewerToolbarActions = {
-    close: () => void;
-    prev: () => void;
-    next: () => void;
-    zoomIn: () => void;
-    zoomOut: () => void;
-    /** Масштаб «один к одному»: реальные 100%, а не номинальные. */
-    zoomToNatural: () => void;
-    reset: () => void;
-    rotateLeft: () => void;
-    rotateRight: () => void;
-    /** Скачать текущий кадр — то же, что делает кнопка тулбара. */
-    download: () => void;
-};
-declare var __VLS_54: {
-    index: number;
-    /** Текущий кадр — адрес и альтернативный текст. */
-    src?: string;
-    alt: string;
-    displayIndex: number;
-    total: number;
-    scale: number;
-    rotation: number;
-    /** Натуральный (исходный) размер картинки, px. 0 пока изображение не загружено. */
-    naturalWidth: number;
-    naturalHeight: number;
-    /** Фактический размер изображения на экране c учётом scale, px (footprint вдоль осей картинки). */
-    renderedWidth: number;
-    renderedHeight: number;
-    /** Реальный масштаб относительно натурального размера (доля): renderedWidth / naturalWidth. */
-    realScale: number;
-    /** Реальный масштаб в процентах, отформатированный (например `67`). */
-    realScalePercent: string;
-    actions: GrImageViewerToolbarActions;
-}, __VLS_89: {
-    index: number;
-    /** Текущий кадр — адрес и альтернативный текст. */
-    src?: string;
-    alt: string;
-    displayIndex: number;
-    total: number;
-    scale: number;
-    rotation: number;
-    /** Натуральный (исходный) размер картинки, px. 0 пока изображение не загружено. */
-    naturalWidth: number;
-    naturalHeight: number;
-    /** Фактический размер изображения на экране c учётом scale, px (footprint вдоль осей картинки). */
-    renderedWidth: number;
-    renderedHeight: number;
-    /** Реальный масштаб относительно натурального размера (доля): renderedWidth / naturalWidth. */
-    realScale: number;
-    /** Реальный масштаб в процентах, отформатированный (например `67`). */
-    realScalePercent: string;
-    actions: GrImageViewerToolbarActions;
-};
-type __VLS_Slots = {} & {
-    toolbar?: (props: typeof __VLS_54) => any;
-} & {
-    'toolbar-actions'?: (props: typeof __VLS_89) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrImageViewerProps>, {
-    initialIndex: number;
-    zoomRate: number;
-    minScale: number;
-    maxScale: number;
-    hideOnClickModal: boolean;
-    closeOnPressEscape: boolean;
-    showProgress: boolean;
-    showZoomValue: boolean;
-    wheelZoom: boolean;
-    draggable: boolean;
-    zIndexVar: undefined;
-    closeLabel: undefined;
-    prevLabel: undefined;
-    nextLabel: undefined;
-    zoomInLabel: undefined;
-    zoomOutLabel: undefined;
-    resetZoomLabel: undefined;
-    zoomToNaturalLabel: undefined;
-    rotateLeftLabel: undefined;
-    rotateRightLabel: undefined;
-    showDownload: boolean;
-    downloadLabel: undefined;
-    emptyText: undefined;
-    ariaLabel: undefined;
-}>>, GrImageViewerToolbarActions, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (value: boolean) => void;
-    close: () => void;
-    change: (newIndex: number) => void;
-    rotate: (deg: number) => void;
-    download: (payload: {
-        src: string;
-        alt: string;
-        index: number;
-    }) => void;
-}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrImageViewerProps>, {
-    initialIndex: number;
-    zoomRate: number;
-    minScale: number;
-    maxScale: number;
-    hideOnClickModal: boolean;
-    closeOnPressEscape: boolean;
-    showProgress: boolean;
-    showZoomValue: boolean;
-    wheelZoom: boolean;
-    draggable: boolean;
-    zIndexVar: undefined;
-    closeLabel: undefined;
-    prevLabel: undefined;
-    nextLabel: undefined;
-    zoomInLabel: undefined;
-    zoomOutLabel: undefined;
-    resetZoomLabel: undefined;
-    zoomToNaturalLabel: undefined;
-    rotateLeftLabel: undefined;
-    rotateRightLabel: undefined;
-    showDownload: boolean;
-    downloadLabel: undefined;
-    emptyText: undefined;
-    ariaLabel: undefined;
-}>>> & Readonly<{
-    onClose?: (() => any) | undefined;
-    onChange?: ((newIndex: number) => any) | undefined;
-    onRotate?: ((deg: number) => any) | undefined;
-    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
-    onDownload?: ((payload: {
-        src: string;
-        alt: string;
-        index: number;
-    }) => any) | undefined;
-}>, {
-    zIndexVar: string;
-    ariaLabel: string;
-    emptyText: string;
-    closeLabel: string;
-    showProgress: boolean;
-    initialIndex: number;
-    zoomRate: number;
-    minScale: number;
-    maxScale: number;
-    hideOnClickModal: boolean;
-    closeOnPressEscape: boolean;
-    showZoomValue: boolean;
-    wheelZoom: boolean;
-    draggable: boolean;
-    prevLabel: string;
-    nextLabel: string;
-    zoomInLabel: string;
-    zoomOutLabel: string;
-    resetZoomLabel: string;
-    zoomToNaturalLabel: string;
-    rotateLeftLabel: string;
-    rotateRightLabel: string;
-    showDownload: boolean;
-    downloadLabel: string;
-}, {}, {}, {}, 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];
-}) & {};