@ssa-ui-kit/core 3.1.0 → 3.3.0

package/dist/components/PersonInfo/PersonInfoValue.d.ts

@@ -1,3 +1,8 @@
+/**
+ * PersonInfoValue - Primary value cell for PersonInfo, optionally a link.
+ * When linkAttributes (from getLinkAttributes) are provided, renders as <a> with
+ * personInfoValueLinkStyles: theme.colors.greyDarker, hover theme.colors.blue. Used by PersonInfoAvatar.
+ */
 import React from 'react';
 import { PersonInfoValueProps } from './types';
 export declare const PersonInfoValue: React.FC<PersonInfoValueProps>;

package/dist/components/PersonInfo/constants.d.ts

@@ -1,3 +1,8 @@
+/**
+ * PersonInfo badge color config. Uses theme.colors only (no palette).
+ * DEFAULT_BADGE_COLORS: order of MainColors keys used when badges are strings (cycled by index).
+ * BADGE_COLORS(theme): map of MainColors key → { text, bg } using theme.colors.* and theme.colors.*20.
+ */
 import type { Theme } from '@emotion/react';
 type BadgeColorName = keyof MainColors;
 export declare const DEFAULT_BADGE_COLORS: Array<keyof MainColors>;

package/dist/components/PersonInfo/helpers.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Returns link props for PersonInfo value/avatar when link is set.
+ * For AI: used by PersonInfoAvatar and PersonInfoValue. Returns { as: 'a', href, target?, rel? }
+ * when link is truthy; otherwise {}. openLinkInNewTab sets target="_blank" and rel="noreferrer".
+ */
 export declare const getLinkAttributes: (link?: string, openLinkInNewTab?: boolean) => {
     as: "a";
     href: string | undefined;

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

@@ -1,2 +1,6 @@
+/**
+ * PersonInfo public API. Re-exports PersonInfo component and all types (PersonInfoProps,
+ * PersonInfoStyles, PersonInfoCounterTooltip, etc.) for consumers.
+ */
 export * from './PersonInfo';
 export * from './types';

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

@@ -3,8 +3,16 @@ import { Interpolation, Theme } from '@emotion/react';
 import { CommonProps } from '../../types/emotion';
 import { IconProps } from '../Icon/types';
 import { getLinkAttributes } from './helpers';
+/**
+ * Style keys that can be overridden via PersonInfoProps.styles.
+ * All PersonInfo sub-components accept optional css from this map.
+ */
 type PersonInfoStyleKeys = 'title' | 'avatarName' | 'counter' | 'attributes' | 'badge' | 'badgeItem' | 'value' | 'description';
 export type PersonInfoStyles = Partial<Record<PersonInfoStyleKeys, Interpolation<Theme>>>;
+/**
+ * Single user entry for the counter tooltip list.
+ * Used by PersonInfoCounter; avatar is image URL, link opens in same/new tab per openLinkInNewTab.
+ */
 export interface PersonInfoCounterTooltipUser {
     id: string | number;
     name: string;
@@ -12,28 +20,70 @@ export interface PersonInfoCounterTooltipUser {
     link?: string;
     openLinkInNewTab?: boolean;
 }
+/**
+ * Tooltip payload for the “+N” counter next to the value.
+ * users array is rendered as a list inside the tooltip (e.g. via ImageItem).
+ */
 export interface PersonInfoCounterTooltip {
     users: PersonInfoCounterTooltipUser[];
 }
 export type PersonInfoLinkAttributes = ReturnType<typeof getLinkAttributes>;
+/**
+ * Props for the value sub-component (avatar row value, optionally a link).
+ * linkAttributes come from helpers.getLinkAttributes(link, openLinkInNewTab).
+ */
 export interface PersonInfoValueProps {
     value: string;
     css?: Interpolation<Theme>;
     linkAttributes?: PersonInfoLinkAttributes;
 }
+/**
+ * Props for the PersonInfo component.
+ * Uses theme.colors only (no theme.palette). See PersonInfo.tsx JSDoc for structure and examples.
+ *
+ * @example
+ * ```tsx
+ * <PersonInfo title="Assignee" value="John Doe" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <PersonInfo title="Owner" value="Jane" avatar="/j.jpg" link="/users/jane" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <PersonInfo title="Status" value="3" counterTooltip={{ users: [...] }} />
+ * ```
+ */
 export interface PersonInfoProps extends CommonProps {
+    /** Main label (required). */
     title: string;
+    /** Icon name or custom ReactNode before the title. */
     icon?: IconProps['name'] | ReactNode;
+    /** Primary value; with link becomes a link. */
     value?: string;
+    /** Badge(s): single node or array of string | ReactNode. Strings use DEFAULT_BADGE_COLORS. */
     badges?: ReactNode | (string | ReactNode)[];
+    /** Avatar image URL, shown next to value. */
     avatar?: string;
+    /** “+N” counter with tooltip listing users. */
     counterTooltip?: PersonInfoCounterTooltip;
+    /** List of strings or ReactNodes below the row. */
     attributes?: (string | ReactNode)[];
+    /** Extra description text. */
     description?: string;
+    /** Optional style overrides per PersonInfoStyleKeys. */
     styles?: PersonInfoStyles;
+    /** If set, value (or avatar+value) renders as a link. */
     link?: string;
+    /** When link is set, open in new tab and use rel="noreferrer". */
     openLinkInNewTab?: boolean;
 }
+/**
+ * Props for PersonInfoAvatar (value + optional avatar, optional link).
+ * Used internally by PersonInfo.
+ */
 export interface PersonInfoAvatarProps {
     avatar?: string;
     value?: string;
@@ -41,6 +91,10 @@ export interface PersonInfoAvatarProps {
     link?: string;
     openLinkInNewTab?: boolean;
 }
+/**
+ * Props for PersonInfoCounter (“+N” with tooltip).
+ * css overrides styles.counter.
+ */
 export interface PersonInfoCounterProps {
     counterTooltip?: PersonInfoCounterTooltip;
     css?: PersonInfoStyles['counter'];

package/dist/components/index.d.ts

@@ -37,7 +37,6 @@ export { default as MultipleDropdownOptions } from './MultipleDropdownOptions';
 export * from './Typeahead';
 export * from './DatePicker';
 export * from './DateRangePicker';
-export type { CalendarType } from './DatePicker/types';
 export * from './ColorPicker';
 export * from './SearchBox';
 export type * from './SearchBox/types';
@@ -111,6 +110,8 @@ export type * from './Stepper/types';
 export { default as Step } from './Step';
 export { default as StepConnector } from './StepConnector';
 export { default as StepLabel } from './StepLabel';
+export * from './History';
+export type * from './History/types';
 export * from './Pagination';
 export { default as Link } from './Link';
 export * from './WithLink';