@snack-uikit/link 0.17.20 → 0.18.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 0.18.0 (2026-04-03)
+
+
+### Features
+
+* **PDS-3679:** added truncateMaxLines prop in Link ([ff25bd3](https://github.com/cloud-ru-tech/snack-uikit/commit/ff25bd3703e9d911a93bc657368ded03fa24ecaf))
+
+
+
+
+
 ## 0.17.20 (2026-03-27)
 
 ### Only dependencies have been changed

package/README.md

@@ -51,8 +51,9 @@ import { Link as ReactRouterLink } from 'react-router-dom';
 | appearance | enum Appearance: `"invert-neutral"`, `"neutral"`, `"primary"`, `"red"`, `"orange"`, `"yellow"`, `"green"`, `"blue"`, `"violet"`, `"pink"` | primary | Стилизует ссылку для размещения на цветном фоне |
 | textMode | enum TextMode: `"default"`, `"accent"`, `"on-accent"` | default | Тип поверхности, на которой размещена ссылка |
 | insideText | `boolean` | - | Находится ли ссылка внутри текста (и можно ли её переносить) |
-| truncateVariant | "end" \| "middle" | - | Вариант обрезания строки: <br> - `end` - с конца; <br> - `middle` - по середине |
-| as | `ComponentType \| ElementType` | 'a' | Полиморфный компонент.  Оформить переданный компонент или html элемент в стиль ссылки.  Список атрибутов, которые переданный компонент должен принять: <br/> - `className` <br/> - `data-size` <br/> - `data-text-mode` <br/> - `data-appearance` <br/> - `data-inside-text` |
+| truncateVariant | "end" \| "middle" | - | Вариант обрезания строки:  - `end` — с конца; - `middle` — посередине |
+| truncateMaxLines | `number` | 1 | Максимальное кол-во строк, до которого может сворачиваться текст ссылки. @remarks Применяется только при `truncateVariant === 'end'`. |
+| as | `ComponentType \| ElementType` | 'a' | Полиморфный компонент.  Оформить переданный компонент или html элемент в стиль ссылки.  Список атрибутов, которые переданный компонент должен принять: - `className` - `data-size` - `data-text-mode` - `data-appearance` - `data-inside-text` |
 
 
 [//]: DOCUMENTATION_SECTION_END

package/dist/cjs/components/Link.d.ts

@@ -1,4 +1,4 @@
 import { ElementType } from 'react';
 import { LinkProps } from './types';
 /** Компонент ссылка */
-export declare function Link<T extends ElementType = 'a'>({ text, className, textMode, size, purpose, appearance, insideText, truncateVariant, as, ...rest }: LinkProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function Link<T extends ElementType = 'a'>({ text, className, textMode, size, purpose, appearance, insideText, truncateVariant, truncateMaxLines, as, ...rest }: LinkProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/cjs/components/Link.js

@@ -35,9 +35,10 @@ function Link(_a) {
       appearance = constants_1.APPEARANCE.Primary,
       insideText = false,
       truncateVariant,
+      truncateMaxLines = 1,
       as
     } = _a,
-    rest = __rest(_a, ["text", "className", "textMode", "size", "purpose", "appearance", "insideText", "truncateVariant", "as"]);
+    rest = __rest(_a, ["text", "className", "textMode", "size", "purpose", "appearance", "insideText", "truncateVariant", "truncateMaxLines", "as"]);
   const Component = as || 'a';
   let fallbackProps;
   if (Component === 'a') {
@@ -64,7 +65,7 @@ function Link(_a) {
     "data-inside-text": insideText || undefined,
     children: insideText ? text : (0, jsx_runtime_1.jsx)(truncate_string_1.TruncateString, {
       text: text,
-      maxLines: 1,
+      maxLines: truncateMaxLines,
       variant: truncateVariant
     })
   }));

package/dist/cjs/components/types.d.ts

@@ -6,6 +6,32 @@ export type Appearance = ValueOf<typeof APPEARANCE>;
 export type Size = ValueOf<typeof SIZE>;
 export type Purpose = ValueOf<typeof PURPOSE>;
 export type TextMode = ValueOf<typeof TEXT_MODE>;
+type TruncateEndProps = {
+    /**
+     * Вариант обрезания строки:
+     *
+     * - `end` — с конца;
+     * - `middle` — посередине
+     */
+    truncateVariant?: Extract<TruncateStringProps['variant'], 'end'>;
+    /**
+     * Максимальное кол-во строк, до которого может сворачиваться текст ссылки.
+     * @remarks Применяется только при `truncateVariant === 'end'`.
+     * @default 1
+     */
+    truncateMaxLines?: number;
+};
+type TruncateMiddleProps = {
+    /**
+     * Вариант обрезания строки:
+     *
+     * - `end` — с конца;
+     * - `middle` — посередине
+     */
+    truncateVariant?: Extract<TruncateStringProps['variant'], 'middle'>;
+    truncateMaxLines?: never;
+};
+type TruncateProps = TruncateEndProps | TruncateMiddleProps;
 export type BaseProps = WithSupportProps<{
     /** Текст ссылки */
     text?: string;
@@ -27,14 +53,8 @@ export type BaseProps = WithSupportProps<{
     textMode?: TextMode;
     /** Находится ли ссылка внутри текста (и можно ли её переносить) */
     insideText?: boolean;
-    /**
-     * Вариант обрезания строки:
-     * <br> - `end` - с конца;
-     * <br> - `middle` - по середине
-     * */
-    truncateVariant?: TruncateStringProps['variant'];
 }>;
-export type LinkProps<T extends ElementType = 'a'> = BaseProps & {
+export type LinkProps<T extends ElementType = 'a'> = BaseProps & TruncateProps & {
     /**
      *
      * Полиморфный компонент.
@@ -42,16 +62,19 @@ export type LinkProps<T extends ElementType = 'a'> = BaseProps & {
      * Оформить переданный компонент или html элемент в стиль ссылки.
      *
      * Список атрибутов, которые переданный компонент должен принять:
-     * <br/> - `className`
-     * <br/> - `data-size`
-     * <br/> - `data-text-mode`
-     * <br/> - `data-appearance`
-     * <br/> - `data-inside-text`
+     * - `className`
+     * - `data-size`
+     * - `data-text-mode`
+     * - `data-appearance`
+     * - `data-inside-text`
      *
      * @type ComponentType | ElementType
      * @default 'a'
      *
-     * */
+     */
     as?: T;
 } & Omit<ComponentPropsWithoutRef<ElementType extends T ? 'a' : T>, keyof BaseProps>;
-export type PickLinkProps<T extends ElementType, SelectedKeys extends keyof LinkProps<T>> = Pick<LinkProps<T>, SelectedKeys> & Omit<ComponentPropsWithoutRef<ElementType extends T ? 'a' : T>, keyof BaseProps>;
+/** Сохраняет дискриминацию union при выборе полей (в отличие от `Pick` по union). */
+type DistributivePick<T, K extends keyof T> = T extends unknown ? Pick<T, K> : never;
+export type PickLinkProps<T extends ElementType, SelectedKeys extends keyof LinkProps<T>> = DistributivePick<LinkProps<T>, SelectedKeys> & Omit<ComponentPropsWithoutRef<ElementType extends T ? 'a' : T>, keyof BaseProps>;
+export {};

package/dist/esm/components/Link.d.ts

@@ -1,4 +1,4 @@
 import { ElementType } from 'react';
 import { LinkProps } from './types';
 /** Компонент ссылка */
-export declare function Link<T extends ElementType = 'a'>({ text, className, textMode, size, purpose, appearance, insideText, truncateVariant, as, ...rest }: LinkProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function Link<T extends ElementType = 'a'>({ text, className, textMode, size, purpose, appearance, insideText, truncateVariant, truncateMaxLines, as, ...rest }: LinkProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/esm/components/Link.js

@@ -18,7 +18,7 @@ import styles from './styles.module.css';
 /** Компонент ссылка */
 export function Link(_a) {
     var _b, _c;
-    var { text = '', className, textMode = TEXT_MODE.Default, size = SIZE.S, purpose = PURPOSE.Body, appearance = APPEARANCE.Primary, insideText = false, truncateVariant, as } = _a, rest = __rest(_a, ["text", "className", "textMode", "size", "purpose", "appearance", "insideText", "truncateVariant", "as"]);
+    var { text = '', className, textMode = TEXT_MODE.Default, size = SIZE.S, purpose = PURPOSE.Body, appearance = APPEARANCE.Primary, insideText = false, truncateVariant, truncateMaxLines = 1, as } = _a, rest = __rest(_a, ["text", "className", "textMode", "size", "purpose", "appearance", "insideText", "truncateVariant", "truncateMaxLines", "as"]);
     const Component = as || 'a';
     let fallbackProps;
     if (Component === 'a') {
@@ -31,5 +31,5 @@ export function Link(_a) {
     else {
         fallbackProps = rest;
     }
-    return (_jsx(Component, Object.assign({ className: cn(styles.link, className) }, fallbackProps, { "data-size": size, "data-purpose": purpose, "data-text-mode": textMode, "data-appearance": appearance, "data-inside-text": insideText || undefined, children: insideText ? text : _jsx(TruncateString, { text: text, maxLines: 1, variant: truncateVariant }) })));
+    return (_jsx(Component, Object.assign({ className: cn(styles.link, className) }, fallbackProps, { "data-size": size, "data-purpose": purpose, "data-text-mode": textMode, "data-appearance": appearance, "data-inside-text": insideText || undefined, children: insideText ? text : _jsx(TruncateString, { text: text, maxLines: truncateMaxLines, variant: truncateVariant }) })));
 }

package/dist/esm/components/types.d.ts

@@ -6,6 +6,32 @@ export type Appearance = ValueOf<typeof APPEARANCE>;
 export type Size = ValueOf<typeof SIZE>;
 export type Purpose = ValueOf<typeof PURPOSE>;
 export type TextMode = ValueOf<typeof TEXT_MODE>;
+type TruncateEndProps = {
+    /**
+     * Вариант обрезания строки:
+     *
+     * - `end` — с конца;
+     * - `middle` — посередине
+     */
+    truncateVariant?: Extract<TruncateStringProps['variant'], 'end'>;
+    /**
+     * Максимальное кол-во строк, до которого может сворачиваться текст ссылки.
+     * @remarks Применяется только при `truncateVariant === 'end'`.
+     * @default 1
+     */
+    truncateMaxLines?: number;
+};
+type TruncateMiddleProps = {
+    /**
+     * Вариант обрезания строки:
+     *
+     * - `end` — с конца;
+     * - `middle` — посередине
+     */
+    truncateVariant?: Extract<TruncateStringProps['variant'], 'middle'>;
+    truncateMaxLines?: never;
+};
+type TruncateProps = TruncateEndProps | TruncateMiddleProps;
 export type BaseProps = WithSupportProps<{
     /** Текст ссылки */
     text?: string;
@@ -27,14 +53,8 @@ export type BaseProps = WithSupportProps<{
     textMode?: TextMode;
     /** Находится ли ссылка внутри текста (и можно ли её переносить) */
     insideText?: boolean;
-    /**
-     * Вариант обрезания строки:
-     * <br> - `end` - с конца;
-     * <br> - `middle` - по середине
-     * */
-    truncateVariant?: TruncateStringProps['variant'];
 }>;
-export type LinkProps<T extends ElementType = 'a'> = BaseProps & {
+export type LinkProps<T extends ElementType = 'a'> = BaseProps & TruncateProps & {
     /**
      *
      * Полиморфный компонент.
@@ -42,16 +62,19 @@ export type LinkProps<T extends ElementType = 'a'> = BaseProps & {
      * Оформить переданный компонент или html элемент в стиль ссылки.
      *
      * Список атрибутов, которые переданный компонент должен принять:
-     * <br/> - `className`
-     * <br/> - `data-size`
-     * <br/> - `data-text-mode`
-     * <br/> - `data-appearance`
-     * <br/> - `data-inside-text`
+     * - `className`
+     * - `data-size`
+     * - `data-text-mode`
+     * - `data-appearance`
+     * - `data-inside-text`
      *
      * @type ComponentType | ElementType
      * @default 'a'
      *
-     * */
+     */
     as?: T;
 } & Omit<ComponentPropsWithoutRef<ElementType extends T ? 'a' : T>, keyof BaseProps>;
-export type PickLinkProps<T extends ElementType, SelectedKeys extends keyof LinkProps<T>> = Pick<LinkProps<T>, SelectedKeys> & Omit<ComponentPropsWithoutRef<ElementType extends T ? 'a' : T>, keyof BaseProps>;
+/** Сохраняет дискриминацию union при выборе полей (в отличие от `Pick` по union). */
+type DistributivePick<T, K extends keyof T> = T extends unknown ? Pick<T, K> : never;
+export type PickLinkProps<T extends ElementType, SelectedKeys extends keyof LinkProps<T>> = DistributivePick<LinkProps<T>, SelectedKeys> & Omit<ComponentPropsWithoutRef<ElementType extends T ? 'a' : T>, keyof BaseProps>;
+export {};

package/package.json

@@ -4,7 +4,7 @@
     "access": "public"
   },
   "title": "Link",
-  "version": "0.17.20",
+  "version": "0.18.0",
   "sideEffects": [
     "*.css",
     "*.woff",
@@ -40,5 +40,5 @@
     "@snack-uikit/utils": "4.0.1",
     "classnames": "2.5.1"
   },
-  "gitHead": "1f7164e6cecf3ccd35444c100907479607cf10f0"
+  "gitHead": "5c39afb3bd0a8cf9cd69992e1d390791c1434531"
 }

package/src/components/Link.tsx

@@ -18,6 +18,7 @@ export function Link<T extends ElementType = 'a'>({
   appearance = APPEARANCE.Primary,
   insideText = false,
   truncateVariant,
+  truncateMaxLines = 1,
   as,
   ...rest
 }: LinkProps<T>) {
@@ -48,7 +49,7 @@ export function Link<T extends ElementType = 'a'>({
       data-appearance={appearance}
       data-inside-text={insideText || undefined}
     >
-      {insideText ? text : <TruncateString text={text} maxLines={1} variant={truncateVariant} />}
+      {insideText ? text : <TruncateString text={text} maxLines={truncateMaxLines} variant={truncateVariant} />}
     </Component>
   );
 }

package/src/components/types.ts

@@ -13,6 +13,35 @@ export type Purpose = ValueOf<typeof PURPOSE>;
 
 export type TextMode = ValueOf<typeof TEXT_MODE>;
 
+type TruncateEndProps = {
+  /**
+   * Вариант обрезания строки:
+   *
+   * - `end` — с конца;
+   * - `middle` — посередине
+   */
+  truncateVariant?: Extract<TruncateStringProps['variant'], 'end'>;
+  /**
+   * Максимальное кол-во строк, до которого может сворачиваться текст ссылки.
+   * @remarks Применяется только при `truncateVariant === 'end'`.
+   * @default 1
+   */
+  truncateMaxLines?: number;
+};
+
+type TruncateMiddleProps = {
+  /**
+   * Вариант обрезания строки:
+   *
+   * - `end` — с конца;
+   * - `middle` — посередине
+   */
+  truncateVariant?: Extract<TruncateStringProps['variant'], 'middle'>;
+  truncateMaxLines?: never;
+};
+
+type TruncateProps = TruncateEndProps | TruncateMiddleProps;
+
 export type BaseProps = WithSupportProps<{
   /** Текст ссылки */
   text?: string;
@@ -34,36 +63,34 @@ export type BaseProps = WithSupportProps<{
   textMode?: TextMode;
   /** Находится ли ссылка внутри текста (и можно ли её переносить) */
   insideText?: boolean;
-  /**
-   * Вариант обрезания строки:
-   * <br> - `end` - с конца;
-   * <br> - `middle` - по середине
-   * */
-  truncateVariant?: TruncateStringProps['variant'];
 }>;
 
-export type LinkProps<T extends ElementType = 'a'> = BaseProps & {
-  /**
-   *
-   * Полиморфный компонент.
-   *
-   * Оформить переданный компонент или html элемент в стиль ссылки.
-   *
-   * Список атрибутов, которые переданный компонент должен принять:
-   * <br/> - `className`
-   * <br/> - `data-size`
-   * <br/> - `data-text-mode`
-   * <br/> - `data-appearance`
-   * <br/> - `data-inside-text`
-   *
-   * @type ComponentType | ElementType
-   * @default 'a'
-   *
-   * */
-  as?: T;
-} & Omit<ComponentPropsWithoutRef<ElementType extends T ? 'a' : T>, keyof BaseProps>;
+export type LinkProps<T extends ElementType = 'a'> = BaseProps &
+  TruncateProps & {
+    /**
+     *
+     * Полиморфный компонент.
+     *
+     * Оформить переданный компонент или html элемент в стиль ссылки.
+     *
+     * Список атрибутов, которые переданный компонент должен принять:
+     * - `className`
+     * - `data-size`
+     * - `data-text-mode`
+     * - `data-appearance`
+     * - `data-inside-text`
+     *
+     * @type ComponentType | ElementType
+     * @default 'a'
+     *
+     */
+    as?: T;
+  } & Omit<ComponentPropsWithoutRef<ElementType extends T ? 'a' : T>, keyof BaseProps>;
+
+/** Сохраняет дискриминацию union при выборе полей (в отличие от `Pick` по union). */
+type DistributivePick<T, K extends keyof T> = T extends unknown ? Pick<T, K> : never;
 
-export type PickLinkProps<T extends ElementType, SelectedKeys extends keyof LinkProps<T>> = Pick<
+export type PickLinkProps<T extends ElementType, SelectedKeys extends keyof LinkProps<T>> = DistributivePick<
   LinkProps<T>,
   SelectedKeys
 > &