@rt-tools/ui-kit-v2 0.23.3 → 0.24.0

package/types/rt-tools-ui-kit-v2-icon.d.ts

@@ -1,8 +1,7 @@
-import { IRtIcon } from '@rt-tools/ui-kit-v2/core';
-import * as i0 from '@angular/core';
-import { InjectionToken, Signal, InputSignal, InputSignalWithTransform, EnvironmentProviders } from '@angular/core';
-import { BooleanInput } from '@angular/cdk/coercion';
-
+import { IRtIcon } from "@rt-tools/ui-kit-v2/core";
+import * as i0 from "@angular/core";
+import { EnvironmentProviders, InjectionToken, InputSignal, InputSignalWithTransform, Signal } from "@angular/core";
+import { BooleanInput } from "@angular/cdk/coercion";
 /**
  * Категории иконок rt-icon. 11 buckets: 8 prefix-based + Social (префикс `social-`) + Custom
  * (префикс `ico-`) + Misc (fallback).
@@ -11,16 +10,16 @@ import { BooleanInput } from '@angular/cdk/coercion';
  * Аннотация типа намеренно не указывается: явный `readonly string[]` потерял бы узкий
  * литеральный тип, нужный для {@link TIconCategory}. `as const` сохраняет литеральные ключи.
  */
-declare const CATEGORY_ORDER: readonly ["Navigation", "Alignment & Sorting", "Status", "Time & Calendar", "Communication", "Documents", "People", "Commerce", "Social", "Custom", "Misc"];
+export declare const CATEGORY_ORDER: readonly ["Navigation", "Alignment & Sorting", "Status", "Time & Calendar", "Communication", "Documents", "People", "Commerce", "Social", "Custom", "Misc"];
 /** Литеральный union из {@link CATEGORY_ORDER}. */
-type TIconCategory = (typeof CATEGORY_ORDER)[number];
+export type TIconCategory = (typeof CATEGORY_ORDER)[number];
 /**
  * Правило маппинга имени иконки в категорию.
  * Порядок правил в {@link ICON_CATEGORY_RULES} важен: первое совпавшее правило выигрывает.
  */
 interface IIconCategoryRule {
-    readonly category: TIconCategory;
-    readonly match: (name: string) => boolean;
+  readonly category: TIconCategory;
+  readonly match: (name: string) => boolean;
 }
 /**
  * Упорядоченный список правил категоризации.
@@ -28,18 +27,17 @@ interface IIconCategoryRule {
  * чтобы исключить конфликты с другими prefix-based категориями.
  * `Misc` — fallback в {@link categoryOf}, отдельным правилом не описывается.
  */
-declare const ICON_CATEGORY_RULES: readonly IIconCategoryRule[];
+export declare const ICON_CATEGORY_RULES: readonly IIconCategoryRule[];
 /**
  * Возвращает категорию для имени иконки.
  * Первое совпавшее правило в {@link ICON_CATEGORY_RULES} выигрывает; иначе — `Misc`.
  */
-declare function categoryOf(name: IRtIcon.Name): TIconCategory;
-
+export declare function categoryOf(name: IRtIcon.Name): TIconCategory;
 /**
  * Как значки приложения рисуют имя Material. Задаётся третьим аргументом `provideRtIcons()`;
  * по умолчанию `map-first` — пара из перечня кита, а без пары шрифт.
  */
-declare const RT_ICON_GLYPH_STRATEGY: InjectionToken<IRtIcon.GlyphStrategy>;
+export declare const RT_ICON_GLYPH_STRATEGY: InjectionToken<IRtIcon.GlyphStrategy>;
 /**
  * Готовность шрифтов страницы — одна на все значки.
  *
@@ -48,18 +46,17 @@ declare const RT_ICON_GLYPH_STRATEGY: InjectionToken<IRtIcon.GlyphStrategy>;
  * а не загрузку одной семьи. На сервере шрифтов нет — лигатура там скрыта. Браузер без интерфейса
  * шрифтов ждать нечем, и лигатура показывается сразу.
  */
-declare class RtIconFontService {
-    #private;
-    readonly ready: Signal<boolean>;
-    constructor();
-    static ɵfac: i0.ɵɵFactoryDeclaration<RtIconFontService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+export declare class RtIconFontService {
+  #private;
+  readonly ready: Signal<boolean>;
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<RtIconFontService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
-
 /** Имя значка кита — то, что рисует спрайт; остальное кит своим рисунком не закрывает. */
-declare function isKitIconName(name: string): name is IRtIcon.Name;
+export declare function isKitIconName(name: string): name is IRtIcon.Name;
 /** Пара имени Material из перечня кита; `null` — пары нет или имени нет. */
-declare function materialPairOf(glyph: string | null | undefined): IRtIcon.Name | null;
+export declare function materialPairOf(glyph: string | null | undefined): IRtIcon.Name | null;
 /**
  * Чем рисуется значок: своим рисунком кита или лигатурой шрифта Material.
  *
@@ -71,68 +68,107 @@ declare function materialPairOf(glyph: string | null | undefined): IRtIcon.Name
  *
  * `null` — значку нечего рисовать.
  */
-declare function resolveIconGlyph(name: IRtIcon.Name | null | undefined, glyph: string | null | undefined, strategy: IRtIcon.GlyphStrategy): IRtIcon.Resolved | null;
-
-declare class RtIconComponent {
-    #private;
-    /** Чем рисуется значок: именем кита или лигатурой шрифта. Ни имени, ни глифа — пустое место. */
-    protected readonly resolved: Signal<IRtIcon.Resolved | null>;
-    protected readonly kitName: Signal<IRtIcon.Name | null>;
-    protected readonly fontGlyph: Signal<string | null>;
-    /** Лигатура прячется, пока шрифты страницы не готовы: до того она рисуется словом. */
-    protected readonly glyphMods: Signal<Record<string, boolean>>;
-    protected readonly href: Signal<string | null>;
-    /**
-     * Набор, которым рисуется этот значок. Материальный закрывает не все имена кита — он слой
-     * переопределений, как набор оформления: имя без материального рисунка рисуется своим, и это
-     * не пробел.
-     */
-    protected readonly preset: Signal<IRtIcon.Preset>;
-    /** Рисунок значка: залитый бывает только у материального набора, свой набор заливки не знает. */
-    protected readonly drawing: Signal<IRtIcon.Drawing>;
-    /** Длина CSS стороны значка: ступень — её свойство `--rt-icon-step-*`, число — пиксели. */
-    protected readonly sizeValue: Signal<string>;
-    /** Оптический размер лигатуры, пока приложение не задало `--rt-icon-glyph-opsz`: сторона значка в пикселях. */
-    protected readonly opticalSize: Signal<number>;
-    protected readonly colorValue: Signal<string | null>;
-    protected readonly rotateStyle: Signal<string | null>;
-    /** Имя кита. Стоит рядом с глифом и побеждает его, когда переданы оба. */
-    readonly name: InputSignal<IRtIcon.Name | null>;
-    /**
-     * Имя Material вместо имени кита. Как оно рисуется — парой из перечня кита или лигатурой
-     * шрифта Material Symbols — решает настройка `glyphStrategy` у `provideRtIcons()`. Шрифт
-     * приложение подключает само; семья берётся из свойства `--rt-icon-glyph-font`.
-     */
-    readonly glyph: InputSignal<string | null>;
-    /**
-     * Как рисовать имя Material у этого значка. Перекрывает `glyphStrategy` из `provideRtIcons()`;
-     * `null` — берётся настройка приложения. Дефолт `null`.
-     */
-    readonly glyphStrategy: InputSignal<IRtIcon.GlyphStrategy | null>;
-    /**
-     * Ступень размера или число пикселей — для размеров между ступенями и крупнее последней.
-     * Числовая строка из статического атрибута читается числом, прочая строка вне ступеней — `md`.
-     * Внутри вход хранит ступень или положительное число пикселей.
-     */
-    readonly size: InputSignalWithTransform<IRtIcon.SizeInput, IRtIcon.SizeInput | string>;
-    readonly color: InputSignal<IRtIcon.Color>;
-    /**
-     * Залитый рисунок вместо контурного — как `FILL 1` у значка первого кита. Действует в
-     * материальном наборе; свой набор рисует значок одним рисунком. Дефолт `false`.
-     */
-    readonly fill: InputSignalWithTransform<boolean, BooleanInput>;
-    /**
-     * Значок вращается — как индикатор занятости внутри кнопки или строки. Когда система просит
-     * меньше движения, вращение медленнее. Поворот на время вращения уступает ему. Дефолт `false`.
-     */
-    readonly spin: InputSignalWithTransform<boolean, BooleanInput>;
-    readonly rotate: InputSignalWithTransform<number | null, TRotateInput>;
-    constructor();
-    static ɵfac: i0.ɵɵFactoryDeclaration<RtIconComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RtIconComponent, "rt-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "glyph": { "alias": "glyph"; "required": false; "isSignal": true; }; "glyphStrategy": { "alias": "glyphStrategy"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "fill": { "alias": "fill"; "required": false; "isSignal": true; }; "spin": { "alias": "spin"; "required": false; "isSignal": true; }; "rotate": { "alias": "rotate"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+export declare function resolveIconGlyph(name: IRtIcon.Name | null | undefined, glyph: string | null | undefined, strategy: IRtIcon.GlyphStrategy): IRtIcon.Resolved | null;
+export declare class RtIconComponent {
+  #private;
+  /** Чем рисуется значок: именем кита или лигатурой шрифта. Ни имени, ни глифа — пустое место. */
+  protected readonly resolved: Signal<IRtIcon.Resolved | null>;
+  protected readonly kitName: Signal<IRtIcon.Name | null>;
+  protected readonly fontGlyph: Signal<string | null>;
+  /** Лигатура прячется, пока шрифты страницы не готовы: до того она рисуется словом. */
+  protected readonly glyphMods: Signal<Record<string, boolean>>;
+  protected readonly href: Signal<string | null>;
+  /**
+   * Набор, которым рисуется этот значок. Материальный закрывает не все имена кита — он слой
+   * переопределений, как набор оформления: имя без материального рисунка рисуется своим, и это
+   * не пробел.
+   */
+  protected readonly preset: Signal<IRtIcon.Preset>;
+  /** Рисунок значка: залитый бывает только у материального набора, свой набор заливки не знает. */
+  protected readonly drawing: Signal<IRtIcon.Drawing>;
+  /** Длина CSS стороны значка: ступень — её свойство `--rt-icon-step-*`, число — пиксели. */
+  protected readonly sizeValue: Signal<string>;
+  /** Оптический размер лигатуры, пока приложение не задало `--rt-icon-glyph-opsz`: сторона значка в пикселях. */
+  protected readonly opticalSize: Signal<number>;
+  protected readonly colorValue: Signal<string | null>;
+  protected readonly rotateStyle: Signal<string | null>;
+  /** Имя кита. Стоит рядом с глифом и побеждает его, когда переданы оба. */
+  readonly name: InputSignal<IRtIcon.Name | null>;
+  /**
+   * Имя Material вместо имени кита. Как оно рисуется — парой из перечня кита или лигатурой
+   * шрифта Material Symbols — решает настройка `glyphStrategy` у `provideRtIcons()`. Шрифт
+   * приложение подключает само; семья берётся из свойства `--rt-icon-glyph-font`.
+   */
+  readonly glyph: InputSignal<string | null>;
+  /**
+   * Как рисовать имя Material у этого значка. Перекрывает `glyphStrategy` из `provideRtIcons()`;
+   * `null` — берётся настройка приложения. Дефолт `null`.
+   */
+  readonly glyphStrategy: InputSignal<IRtIcon.GlyphStrategy | null>;
+  /**
+   * Ступень размера или число пикселей — для размеров между ступенями и крупнее последней.
+   * Числовая строка из статического атрибута читается числом, прочая строка вне ступеней — `md`.
+   * Внутри вход хранит ступень или положительное число пикселей.
+   */
+  readonly size: InputSignalWithTransform<IRtIcon.SizeInput, IRtIcon.SizeInput | string>;
+  readonly color: InputSignal<IRtIcon.Color>;
+  /**
+   * Залитый рисунок вместо контурного — как `FILL 1` у значка первого кита. Действует в
+   * материальном наборе; свой набор рисует значок одним рисунком. Дефолт `false`.
+   */
+  readonly fill: InputSignalWithTransform<boolean, BooleanInput>;
+  /**
+   * Значок вращается — как индикатор занятости внутри кнопки или строки. Когда система просит
+   * меньше движения, вращение медленнее. Поворот на время вращения уступает ему. Дефолт `false`.
+   */
+  readonly spin: InputSignalWithTransform<boolean, BooleanInput>;
+  readonly rotate: InputSignalWithTransform<number | null, TRotateInput>;
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<RtIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RtIconComponent, "rt-icon", never, {
+    "name": {
+      "alias": "name";
+      "required": false;
+      "isSignal": true;
+    };
+    "glyph": {
+      "alias": "glyph";
+      "required": false;
+      "isSignal": true;
+    };
+    "glyphStrategy": {
+      "alias": "glyphStrategy";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "color": {
+      "alias": "color";
+      "required": false;
+      "isSignal": true;
+    };
+    "fill": {
+      "alias": "fill";
+      "required": false;
+      "isSignal": true;
+    };
+    "spin": {
+      "alias": "spin";
+      "required": false;
+      "isSignal": true;
+    };
+    "rotate": {
+      "alias": "rotate";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
 }
 type TRotateInput = number | string | null;
-
 /**
  * Имена, которыми набор значков виден со стороны страницы.
  *
@@ -142,29 +178,28 @@ type TRotateInput = number | string | null;
  * а реестр создаёт другой, и кадр выходит без значков.
  */
 /** Селектор inline-sprite, создаваемого один раз при первом обращении. */
-declare const RT_ICON_SPRITE_ID: string;
+export declare const RT_ICON_SPRITE_ID: string;
 /** Префикс `id` для inline-sprite символов. Изолирует от внешних `id` на странице. */
-declare const RT_ICON_SYMBOL_ID_PREFIX: string;
+export declare const RT_ICON_SYMBOL_ID_PREFIX: string;
 /**
  * Префикс `id` символов материального набора. Свой, а не общий: наборов на странице бывает два —
  * признак набора стоит и на корне, и на контейнере, — а один `id` держит один рисунок. С общим
  * префиксом второй набор молча забирал бы символ первого.
  */
-declare const RT_ICON_MATERIAL_SYMBOL_ID_PREFIX: string;
+export declare const RT_ICON_MATERIAL_SYMBOL_ID_PREFIX: string;
 /** Префикс `id` залитых рисунков материального набора: у имени их два, и `id` у каждого свой. */
-declare const RT_ICON_MATERIAL_FILL_SYMBOL_ID_PREFIX: string;
+export declare const RT_ICON_MATERIAL_FILL_SYMBOL_ID_PREFIX: string;
 /**
  * Атрибут, который переключает только набор рисунков значков: токенов набора оформления он не
  * несёт. Ставится на контейнер со значением `'material'` там, где значки нужны материальные, а
  * остальной вид — свой.
  */
-declare const RT_ICON_PRESET_ATTRIBUTE: string;
+export declare const RT_ICON_PRESET_ATTRIBUTE: string;
 /**
  * Селекторы, которыми страница объявляет материальный набор значков: признак набора оформления
  * и признак одних значков. Стили читают только первые два — токены под третьим не меняются.
  */
-declare const RT_ICON_MATERIAL_PRESET_SELECTOR: string;
-
+export declare const RT_ICON_MATERIAL_PRESET_SELECTOR: string;
 /**
  * Называет адрес, по которому приложение опубликовало набор значков `rt-icon`.
  *
@@ -195,63 +230,59 @@ declare const RT_ICON_MATERIAL_PRESET_SELECTOR: string;
  * @param materialBaseUrl Адрес материального набора. По умолчанию `/icons-material`.
  * @param options Настройки значков.
  */
-declare function provideRtIcons(baseUrl?: string, materialBaseUrl?: string, options?: IRtIconsOptions): EnvironmentProviders;
+export declare function provideRtIcons(baseUrl?: string, materialBaseUrl?: string, options?: IRtIconsOptions): EnvironmentProviders;
 /** Настройки значков приложения — третий аргумент `provideRtIcons()`. */
-interface IRtIconsOptions {
-    readonly glyphStrategy?: IRtIcon.GlyphStrategy;
+export interface IRtIconsOptions {
+  readonly glyphStrategy?: IRtIcon.GlyphStrategy;
 }
-
 /**
  * Адрес, по которому приложение публикует набор из `assets/icons` пакета.
  * Умолчание годится, когда сборка кладёт набор в корень статики; свой адрес
  * задаётся аргументом `provideRtIcons()`.
  */
-declare const RT_ICONS_BASE_URL: InjectionToken<string>;
+export declare const RT_ICONS_BASE_URL: InjectionToken<string>;
 /**
  * Адрес материального набора значков. Отдельный от своего: два набора стоят рядом, и приложение
  * кладёт их двумя папками.
  */
-declare const RT_ICONS_MATERIAL_BASE_URL: InjectionToken<string>;
-declare class RtIconRegistry {
-    #private;
-    constructor();
-    /**
-     * Имя symbol для `<use href="#X">`. Возвращает строку с ведущим `#`.
-     *
-     * Набор назван явно, а не выведен из страницы: одна и та же страница держит оба набора
-     * рядом — признак стоит и на корне, и на контейнере, — и вывод по странице дал бы обоим
-     * один ответ.
-     */
-    symbolHref(name: IRtIcon.Name, drawing?: IRtIcon.Drawing): string;
-    /**
-     * Просит значок по имени: грузит файл и дописывает `<symbol>` в спрайт страницы.
-     *
-     * Ответа зовущий не ждёт и потока не получает: разметка рисует ссылку на символ сразу, а
-     * браузер дорисовывает её, когда символ приезжает. Подписка живёт здесь и только здесь —
-     * иначе каждая разметка гасила бы её сама, а таких мест у значка два.
-     */
-    request(name: IRtIcon.Name, drawing?: IRtIcon.Drawing): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<RtIconRegistry, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+export declare const RT_ICONS_MATERIAL_BASE_URL: InjectionToken<string>;
+export declare class RtIconRegistry {
+  #private;
+  constructor();
+  /**
+   * Имя symbol для `<use href="#X">`. Возвращает строку с ведущим `#`.
+   *
+   * Набор назван явно, а не выведен из страницы: одна и та же страница держит оба набора
+   * рядом — признак стоит и на корне, и на контейнере, — и вывод по странице дал бы обоим
+   * один ответ.
+   */
+  symbolHref(name: IRtIcon.Name, drawing?: IRtIcon.Drawing): string;
+  /**
+   * Просит значок по имени: грузит файл и дописывает `<symbol>` в спрайт страницы.
+   *
+   * Ответа зовущий не ждёт и потока не получает: разметка рисует ссылку на символ сразу, а
+   * браузер дорисовывает её, когда символ приезжает. Подписка живёт здесь и только здесь —
+   * иначе каждая разметка гасила бы её сама, а таких мест у значка два.
+   */
+  request(name: IRtIcon.Name, drawing?: IRtIcon.Drawing): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RtIconRegistry, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
-
 /** Одна запись перечня: имя первого кита и то, чем оно закрывается здесь. */
-interface IRtIconMaterialEntry {
-    /** Имя значка первого кита — так, как оно стоит в его шаблоне. */
-    readonly from: string;
-    /** Имя этого набора либо `null`, если рисунка в наборе нет. */
-    readonly to: IRtIcon.Name | null;
-    /** Довод к паре либо причина, по которой пары нет. Пустым не бывает. */
-    readonly why: string;
+export interface IRtIconMaterialEntry {
+  /** Имя значка первого кита — так, как оно стоит в его шаблоне. */
+  readonly from: string;
+  /** Имя этого набора либо `null`, если рисунка в наборе нет. */
+  readonly to: IRtIcon.Name | null;
+  /** Довод к паре либо причина, по которой пары нет. Пустым не бывает. */
+  readonly why: string;
 }
-declare const iconMaterialMap: readonly IRtIconMaterialEntry[];
+export declare const iconMaterialMap: readonly IRtIconMaterialEntry[];
 /**
  * Имена кита, у которых в материальном наборе лежит свой рисунок.
  *
  * Считается из перечня, а не пишется списком: свой список разошёлся бы с перечнем молча — реестр
  * ходил бы за файлом, которого нет, или не ходил бы за лежащим.
  */
-declare const iconMaterialDrawn: ReadonlySet<IRtIcon.Name>;
-
-export { CATEGORY_ORDER, ICON_CATEGORY_RULES, RT_ICONS_BASE_URL, RT_ICONS_MATERIAL_BASE_URL, RT_ICON_GLYPH_STRATEGY, RT_ICON_MATERIAL_FILL_SYMBOL_ID_PREFIX, RT_ICON_MATERIAL_PRESET_SELECTOR, RT_ICON_MATERIAL_SYMBOL_ID_PREFIX, RT_ICON_PRESET_ATTRIBUTE, RT_ICON_SPRITE_ID, RT_ICON_SYMBOL_ID_PREFIX, RtIconComponent, RtIconFontService, RtIconRegistry, categoryOf, iconMaterialDrawn, iconMaterialMap, isKitIconName, materialPairOf, provideRtIcons, resolveIconGlyph };
-export type { IRtIconMaterialEntry, IRtIconsOptions, TIconCategory };
+export declare const iconMaterialDrawn: ReadonlySet<IRtIcon.Name>;
+export {};