skillgrid 0.0.42 → 0.0.43

package/dist/components/Button/Button.d.ts

@@ -1,6 +1,7 @@
-import { ButtonProps, BackButtonProps } from './Button.type';
+import { ButtonProps, BackButtonProps, LinkButtonProps } from './Button.type';
 export declare const Button: import('react').ForwardRefExoticComponent<(ButtonProps & {
     style?: React.CSSProperties;
 }) & import('react').RefAttributes<HTMLButtonElement | HTMLAnchorElement>> & {
     Back: import('react').ForwardRefExoticComponent<BackButtonProps & import('react').RefAttributes<HTMLButtonElement | HTMLAnchorElement>>;
+    Link: import('react').ForwardRefExoticComponent<LinkButtonProps & import('react').RefAttributes<HTMLButtonElement | HTMLAnchorElement>>;
 };

package/dist/components/Button/Button.type.d.ts

@@ -1,5 +1,13 @@
 export type LinkSize = 'l' | 'm' | 's';
 export type ButtonSize = 'l' | 'm' | 's' | 'xs';
+/**
+ * Button style types - all available styles including gray
+ */
+export type ButtonStyle = 'neutral' | 'accent' | 'positive' | 'negative' | 'contrast' | 'gray' | 'warning' | 'dreamy' | 'special' | 'lovely' | 'vivid' | 'blue';
+/**
+ * Button style types without gray variant
+ */
+export type ButtonStyleWithoutGray = Exclude<ButtonStyle, 'gray'>;
 /**
  * Base properties common to all button and link variants
  */
@@ -85,51 +93,24 @@ type ButtonBaseProps = BaseProps & {
      */
     iconLeft?: React.ReactNode;
 };
-/**
- * Base properties common to all link variants
- */
-type LinkBaseProps = BaseProps & LinkStyleProps & {
-    /**
-     * Display variant
-     */
-    displayAs: 'link';
-    /**
-     * Underline setting (only for displayAs='link')
-     * @default false
-     */
-    showUnderline?: boolean;
-    /**
-     * Button icon (right side, only for links)
-     */
-    iconRight?: React.ReactNode;
-    postfix?: never;
-    subcaption?: never;
-    loading?: never;
-    stretched?: never;
-};
 type CommonProps = (Omit<ButtonBaseProps, 'mode'> & {
     /**
-     * Button style type
+     * Button style type (gray is not available for this variant)
      * @default 'neutral'
      */
-    buttonStyle?: 'neutral' | 'accent' | 'positive' | 'negative' | 'contrast' | 'gray';
+    buttonStyle?: ButtonStyleWithoutGray;
     /**
-     * Button variant - primary mode supports all buttonStyle options including gray
+     * Button variant - supports both primary and secondary modes
      * @default 'primary'
      */
-    mode?: 'primary';
+    mode?: 'primary' | 'secondary';
     /**
      * Button size
      * @default 'm'
      */
     size?: ButtonSize;
     /**
-     * Display variant
-     * @default 'button'
-     */
-    displayAs?: 'button';
-    /**
-     * Button postfix (only for displayAs='button')
+     * Button postfix
      */
     postfix?: React.ReactNode;
     /**
@@ -156,27 +137,24 @@ type CommonProps = (Omit<ButtonBaseProps, 'mode'> & {
     paddings?: never;
 } & ButtonSizeAndSubcaption) | (Omit<ButtonBaseProps, 'mode'> & {
     /**
-     * Button style type (gray is not available for secondary/tertiary)
+     * Button style type - supports union types including 'gray'
+     * When 'gray' is used, mode must be 'primary' only
      * @default 'neutral'
      */
-    buttonStyle?: 'neutral' | 'accent' | 'positive' | 'negative' | 'contrast';
+    buttonStyle?: ButtonStyle;
     /**
-     * Button variant
+     * Button variant - when buttonStyle includes 'gray', only 'primary' is allowed
+     * For other buttonStyle values, both 'primary' and 'secondary' are allowed
      * @default 'primary'
      */
-    mode?: 'secondary';
+    mode?: 'primary' | 'secondary';
     /**
      * Button size
      * @default 'm'
      */
     size?: ButtonSize;
     /**
-     * Display variant
-     * @default 'button'
-     */
-    displayAs?: 'button';
-    /**
-     * Button postfix (only for displayAs='button')
+     * Button postfix
      */
     postfix?: React.ReactNode;
     /**
@@ -206,7 +184,7 @@ type CommonProps = (Omit<ButtonBaseProps, 'mode'> & {
      * Button style type (gray is not available for secondary/tertiary)
      * @default 'neutral'
      */
-    buttonStyle?: 'neutral' | 'accent' | 'positive' | 'negative' | 'contrast';
+    buttonStyle?: ButtonStyleWithoutGray;
     /**
      * Button variant
      * @default 'primary'
@@ -218,12 +196,7 @@ type CommonProps = (Omit<ButtonBaseProps, 'mode'> & {
      */
     size?: ButtonSize;
     /**
-     * Display variant
-     * @default 'button'
-     */
-    displayAs?: 'button';
-    /**
-     * Button postfix (only for displayAs='button')
+     * Button postfix
      */
     postfix?: React.ReactNode;
     /**
@@ -252,7 +225,7 @@ type CommonProps = (Omit<ButtonBaseProps, 'mode'> & {
     paddings?: boolean;
     iconRight?: never;
     showUnderline?: never;
-} & ButtonSizeAndSubcaption) | (LinkBaseProps & LinkIconVariant);
+} & ButtonSizeAndSubcaption);
 /**
  * Props when rendered as a native HTMLButtonElement (default behaviour).
  */
@@ -272,28 +245,17 @@ export type ButtonAsAnchorProps = CommonProps & React.AnchorHTMLAttributes<HTMLA
 };
 /**
  * Discriminated union tying `href` and `onClick` types to the `as` prop.
+ * Properties unavailable for regular Button (iconRight, showUnderline) are excluded from autocomplete.
  */
-export type ButtonProps = ButtonAsNativeButtonProps | ButtonAsAnchorProps;
+export type ButtonProps = Omit<ButtonAsNativeButtonProps, 'iconRight' | 'showUnderline'> | Omit<ButtonAsAnchorProps, 'iconRight' | 'showUnderline'>;
 /**
  * Runtime type guard that checks if the provided props correspond to an anchor variant of the Button.
  */
-export declare const isAsLink: (props: ButtonProps) => props is ButtonAsAnchorProps;
+export declare const isAsLink: (props: ButtonProps) => props is Omit<ButtonAsAnchorProps, "iconRight" | "showUnderline">;
 /**
  * Runtime type guard that checks if the provided props correspond to a native button variant.
  */
-export declare const isAsButton: (props: ButtonProps) => props is ButtonAsNativeButtonProps;
-/**
- * Runtime type guard that checks if the component should be displayed as a button.
- */
-export declare const isDisplayAsButton: (props: ButtonProps) => props is Extract<ButtonProps, {
-    displayAs?: "button";
-}>;
-/**
- * Runtime type guard that checks if the component should be displayed as a link.
- */
-export declare const isDisplayAsLink: (props: ButtonProps) => props is Extract<ButtonProps, {
-    displayAs: "link";
-}>;
+export declare const isAsButton: (props: ButtonProps) => props is Omit<ButtonAsNativeButtonProps, "iconRight" | "showUnderline">;
 /**
  * Enforces that subcaption can be provided only when size is 'l'.
  * - If subcaption is present → size must be 'l'
@@ -306,8 +268,38 @@ type ButtonSizeAndSubcaption = {
     subcaption: React.ReactNode;
     size: 'l';
 };
+/**
+ * Props for Button.Link component - specialized variant for link display.
+ * Properties unavailable for Button.Link (loading, stretched, postfix, subcaption, paddings) are excluded from autocomplete.
+ */
+export type LinkButtonProps = Omit<BaseProps & LinkStyleProps & LinkIconVariant & {
+    /**
+     * Underline setting
+     * @default false
+     */
+    showUnderline?: boolean;
+    /**
+     * Render as native button element
+     */
+    as?: 'button';
+} & React.ButtonHTMLAttributes<HTMLButtonElement>, 'loading' | 'stretched' | 'postfix' | 'subcaption' | 'paddings'> | Omit<BaseProps & LinkStyleProps & LinkIconVariant & {
+    /**
+     * Underline setting
+     * @default false
+     */
+    showUnderline?: boolean;
+    /**
+     * Render as anchor element
+     */
+    as: 'a';
+    /**
+     * External link default. If target/rel are not provided, sets target="_blank"
+     * and adds rel="noopener noreferrer". Explicit target/rel take precedence.
+     */
+    isExternal?: boolean;
+} & React.AnchorHTMLAttributes<HTMLAnchorElement>, 'loading' | 'stretched' | 'postfix' | 'subcaption' | 'paddings'>;
 /**
  * Props for Button.Back component - based on ButtonProps with restricted design props
  */
-export type BackButtonProps = Omit<ButtonAsNativeButtonProps, 'mode' | 'buttonStyle' | 'size' | 'displayAs' | 'loading' | 'stretched' | 'postfix' | 'subcaption' | 'iconRight' | 'showUnderline'> | Omit<ButtonAsAnchorProps, 'mode' | 'buttonStyle' | 'size' | 'displayAs' | 'loading' | 'stretched' | 'postfix' | 'subcaption' | 'iconRight' | 'showUnderline'>;
+export type BackButtonProps = Omit<ButtonAsNativeButtonProps, 'mode' | 'buttonStyle' | 'size' | 'loading' | 'stretched' | 'postfix' | 'subcaption' | 'iconRight' | 'showUnderline'> | Omit<ButtonAsAnchorProps, 'mode' | 'buttonStyle' | 'size' | 'loading' | 'stretched' | 'postfix' | 'subcaption' | 'iconRight' | 'showUnderline'>;
 export {};

package/dist/components/Button/index.d.ts

@@ -1,2 +1,2 @@
 export { Button } from './Button';
-export type { ButtonProps } from './Button.type';
+export type { ButtonProps, BackButtonProps, LinkButtonProps } from './Button.type';

package/dist/components/Button/lib/get-safe-rel.d.ts

@@ -0,0 +1,11 @@
+import { HTMLAttributeAnchorTarget } from 'react';
+type GetSafeRelParams = {
+    rel?: string;
+    target?: HTMLAttributeAnchorTarget;
+};
+/**
+ * Гарантирует, что ссылки, открывающиеся в новой вкладке, содержат rel-атрибуты,
+ * блокирующие доступ к объекту `window.opener`.
+ */
+export declare const getSafeRel: ({ rel, target }: GetSafeRelParams) => string | undefined;
+export {};

package/dist/components/Button/lib/get-safe-rel.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Icon/Icon.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+import { IconProps } from './Icon.type';
+/**
+ * Компонент Icon для отображения SVG иконок из assets
+ * Поддерживает только React элементы (SVG), не поддерживает emoji и строки
+ */
+type IconComponent = {
+    <E extends React.ElementType = 'button'>(props: IconProps<E>): React.ReactElement | null;
+    displayName?: string;
+};
+export declare const Icon: IconComponent;
+export {};

package/dist/components/Icon/Icon.type.d.ts

@@ -0,0 +1,156 @@
+export type IconModeBase = 'primary' | 'secondary';
+export type IconMode = IconModeBase | 'tertiary';
+export type IconStyleNonNeutral = 'accent' | 'positive' | 'negative' | 'warning' | 'special' | 'dreamy' | 'lovely' | 'vivid' | 'constant' | 'inverse' | 'custom' | 'none';
+export type IconStyle = 'neutral' | IconStyleNonNeutral;
+export type BorderStyle = 'neutral' | 'phantom' | 'overlay' | 'accent' | 'positive' | 'negative' | 'warning' | 'special' | 'dreamy' | 'lovely' | 'vivid';
+export type BackgroundStyle = 'primary' | 'secondary' | 'tertiary' | 'transparent' | 'overlay' | 'constant' | 'inverse' | 'constant-secondary' | 'inverse-secondary' | 'positive' | 'warning' | 'negative' | 'accent' | 'positive-secondary' | 'warning-secondary' | 'negative-secondary' | 'accent-secondary' | 'special' | 'dreamy' | 'lovely' | 'vivid' | 'special-secondary' | 'dreamy-secondary' | 'lovely-secondary' | 'vivid-secondary';
+export type IconSize = number;
+export type ShadowMode = false | 'permanent' | 'increases-when-pressed';
+export type BadgeSize = 'extra-small' | 'small';
+export type BadgeSizeNumeric = 8 | 16 | 20;
+export interface BadgeConfig {
+    show: boolean;
+    size?: BadgeSize;
+    value?: number | string;
+}
+type AsProp<E extends React.ElementType> = {
+    /**
+     * Элемент для рендера
+     * @default 'button'
+     */
+    as?: E;
+};
+type PropsToOmit<E extends React.ElementType, P> = keyof (AsProp<E> & P);
+type PolymorphicComponentProps<E extends React.ElementType, Props = object> = Props & AsProp<E> & Omit<React.ComponentPropsWithoutRef<E>, PropsToOmit<E, Props>>;
+type PolymorphicRef<E extends React.ElementType> = React.ComponentPropsWithRef<E>['ref'];
+export type PolymorphicComponentPropsWithRef<E extends React.ElementType, Props = object> = PolymorphicComponentProps<E, Props> & {
+    ref?: PolymorphicRef<E>;
+};
+interface BaseIconProps {
+    /**
+     * Иконка (только React элементы - SVG)
+     * Используйте Icon.Category.Name компоненты для доступа к иконкам из assets
+     */
+    icon?: React.ReactElement;
+    /**
+     * Размер иконки в пикселях
+     * @default 24
+     */
+    iconSize?: IconSize;
+    /**
+     * Кастомный цвет для режима 'custom'
+     */
+    customColor?: string;
+    /**
+     * Стиль иконки при hover
+     * Позволяет задать любой цвет из набора для состояния hover
+     */
+    hoverStyle?: IconStyle;
+    /**
+     * Кастомный цвет для hover при hoverStyle='custom'
+     */
+    hoverCustomColor?: string;
+    /**
+     * Стиль иконки при pressed
+     * Позволяет задать любой цвет из набора для состояния pressed
+     */
+    pressedStyle?: IconStyle;
+    /**
+     * Кастомный цвет для pressed при pressedStyle='custom'
+     */
+    pressedCustomColor?: string;
+    /**
+     * Внутренние отступы
+     * @default false
+     */
+    padding?: false | number;
+    /**
+     * Фон иконки
+     * @default false
+     */
+    background?: false | BackgroundStyle;
+    /**
+     * Тень
+     * @default false
+     */
+    shadow?: ShadowMode;
+    /**
+     * Показывать рамку
+     * @default false
+     */
+    showBorder?: boolean;
+    /**
+     * Стиль рамки
+     * @default 'neutral'
+     */
+    borderStyle?: BorderStyle;
+    /**
+     * Радиус скругления углов
+     */
+    borderRadius?: number | '50%';
+    /**
+     * Конфигурация бейджа
+     */
+    badge?: BadgeConfig;
+    /**
+     * Состояние checked (для переключаемых иконок)
+     * @default false
+     */
+    checked?: false | React.ReactNode;
+    /**
+     * Состояние disabled
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Состояние loading
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * Дополнительный CSS класс
+     */
+    className?: string;
+    /**
+     * Inline стили
+     */
+    styles?: React.CSSProperties;
+    /**
+     * Test ID для тестирования
+     */
+    'data-testid'?: string;
+    /**
+     * ARIA label для доступности
+     */
+    'aria-label'?: string;
+    /**
+     * ARIA описание
+     */
+    'aria-describedby'?: string;
+}
+interface NeutralIconProps extends BaseIconProps {
+    /**
+     * Стиль иконки
+     * @default 'neutral'
+     */
+    style?: 'neutral';
+    /**
+     * Режим отображения иконки (для neutral доступны primary, secondary и tertiary)
+     * @default 'primary'
+     */
+    mode?: IconMode;
+}
+interface NonNeutralIconProps extends BaseIconProps {
+    /**
+     * Стиль иконки
+     */
+    style?: IconStyleNonNeutral;
+    /**
+     * Режим отображения иконки (только primary и secondary)
+     * @default 'primary'
+     */
+    mode?: IconModeBase;
+}
+type BaseIconPropsUnion = NeutralIconProps | NonNeutralIconProps;
+export type IconProps<E extends React.ElementType = 'div'> = PolymorphicComponentPropsWithRef<E, BaseIconPropsUnion>;
+export {};