@weavix/tracker-components 0.0.3 → 0.1.1

package/build/cjs/components/Icon/PortfolioIcon/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "PortfolioIcon", {
+  enumerable: true,
+  get: function () {
+    return _PortfolioIcon.PortfolioIcon;
+  }
+});
+var _PortfolioIcon = require("./PortfolioIcon");
+// #sourceMappingURL=index.js.map

package/build/cjs/components/Icon/PortfolioIcon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_PortfolioIcon","require"],"sources":["index.ts"],"sourcesContent":["export {PortfolioIcon} from './PortfolioIcon';\nexport type {PortfolioIconProps} from './PortfolioIcon';\n"],"mappings":";;;;;;;;;;;AAAA,IAAAA,cAAA,GAAAC,OAAA","ignoreList":[]}

package/build/cjs/components/Icon/ProjectIcon/README.md

@@ -1,51 +1,175 @@
 # ProjectIcon
 
 <!-- description:start -->
-Component displaying an icon for a project entity
+Displays a colored icon for a Tracker project entity. The icon color is deterministically derived from the `projectId`, so the same project always renders the same color across sessions and environments.
 <!-- description:end -->
 
+## Usage
+
+```tsx
+import {ProjectIcon} from '@weavix/tracker-components';
+
+<ProjectIcon projectId={123} />
+```
+
 ## Component props
 
 <!-- props:start -->
 ```ts
 {
     /**
-     * Project ID used to generate a deterministic color
+     * Project ID used to generate a deterministic color.
+     * Accepts either the numeric shortId or a string entity ID.
      */
     projectId?: number | string;
+
     /**
-     * Additional class
+     * Additional CSS class applied to the root element.
      */
     className?: string;
+
     /**
-     * Entity type label (defaults to "project")
+     * Entity type label. Defaults to "project".
      */
     type?: string;
+
     /**
-     * Size of the SVG icon inside the container in pixels
+     * Size of the SVG icon inside the container in pixels.
      * @default 16
      */
     size?: number;
+
     /**
-     * Size of the icon container in pixels
+     * Size of the icon container (the colored square) in pixels.
      * @default 24
      */
     refugeSize?: number;
+
     /**
-     * Whether to render a colored background behind the icon
+     * Whether to render a colored background behind the icon.
      * @default true
      */
     withBackground?: boolean;
+
     /**
-     * Border radius variant of the icon container
+     * Border radius variant of the icon container.
      * @default 'm'
      */
     radius?: 'm' | 'l';
+
     /**
-     * Alpha (opacity) of the icon color
+     * Alpha (opacity) of the icon foreground color.
      * @default 1
      */
     colorAlpha?: number;
 }
 ```
 <!-- props:end -->
+
+---
+
+## Examples
+
+### Default
+
+```tsx
+import {ProjectIcon} from '@weavix/tracker-components';
+
+<ProjectIcon projectId={123} />
+```
+
+### Without background
+
+```tsx
+// Renders only the colored SVG, no background square
+<ProjectIcon projectId={123} withBackground={false} />
+```
+
+### Custom size
+
+```tsx
+<ProjectIcon projectId={123} size={20} refugeSize={32} />
+```
+
+### Large radius
+
+```tsx
+<ProjectIcon projectId={123} radius="l" />
+```
+
+### Alongside project name
+
+```tsx
+import {ProjectIcon} from '@weavix/tracker-components';
+
+export const ProjectLabel = ({project}: {project: {shortId: number; name: string}}) => (
+    <div style={{display: 'flex', alignItems: 'center', gap: 8}}>
+        <ProjectIcon projectId={project.shortId} />
+        <span>{project.name}</span>
+    </div>
+);
+```
+
+### Multiple projects (each gets a unique color)
+
+```tsx
+const projects = [
+    {shortId: 1, name: 'Backend API'},
+    {shortId: 2, name: 'Mobile App'},
+    {shortId: 3, name: 'Design System'},
+];
+
+projects.map((p) => (
+    <div key={p.shortId} style={{display: 'flex', alignItems: 'center', gap: 8}}>
+        <ProjectIcon projectId={p.shortId} />
+        <span>{p.name}</span>
+    </div>
+));
+```
+
+### Rendering from a Tracker API response
+
+The Tracker entities search endpoint returns `shortId` as a number — pass it directly:
+
+```tsx
+import React, {useEffect, useState} from 'react';
+import {ProjectIcon} from '@weavix/tracker-components';
+import type {MetaEntityV2} from '@weavix/tracker-api-types';
+
+interface Props {
+    trackerApi: TrackerApi;
+}
+
+export const ProjectList: React.FC<Props> = ({trackerApi}) => {
+    const [projects, setProjects] = useState<MetaEntityV2[]>([]);
+
+    useEffect(() => {
+        trackerApi.v3
+            .post['/entities/{entityType}/_search']({
+                pathParams: {entityType: 'project'},
+                queryParams: {fields: ['summary'], page: 1, perPage: 20},
+                bodyParams: {filter: {}, filterTypes: ['ALL'], input: ''},
+            })
+            .then((result) => setProjects(result.data));
+    }, [trackerApi]);
+
+    return (
+        <ul>
+            {projects.map((project) => (
+                <li key={project.id} style={{display: 'flex', alignItems: 'center', gap: 8}}>
+                    <ProjectIcon projectId={project.shortId} />
+                    <span>{project.fields?.summary?.value ?? project.id}</span>
+                </li>
+            ))}
+        </ul>
+    );
+};
+```
+
+---
+
+## Notes
+
+- `withBackground` defaults to `true` for projects (vs `false` for [`PortfolioIcon`](../PortfolioIcon/README.md)).
+- Pass `projectId` as the **numeric `shortId`** from the Tracker API for consistent color generation. String IDs are also accepted.
+- To render the correct icon for an arbitrary meta entity type, use [`MetaEntityIcon`](../MetaEntityIcon/README.md) instead.

package/build/cjs/components/Icon/ProjectIcon/index.d.ts

@@ -0,0 +1,2 @@
+export { ProjectIcon } from './ProjectIcon';
+export type { ProjectIconProps } from './ProjectIcon';

package/build/cjs/components/Icon/ProjectIcon/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "ProjectIcon", {
+  enumerable: true,
+  get: function () {
+    return _ProjectIcon.ProjectIcon;
+  }
+});
+var _ProjectIcon = require("./ProjectIcon");
+// #sourceMappingURL=index.js.map

package/build/cjs/components/Icon/ProjectIcon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_ProjectIcon","require"],"sources":["index.ts"],"sourcesContent":["export {ProjectIcon} from './ProjectIcon';\nexport type {ProjectIconProps} from './ProjectIcon';\n"],"mappings":";;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA","ignoreList":[]}

package/build/cjs/components/Icon/index.d.ts

@@ -1,3 +1,8 @@
+export * from './EntityIcon';
+export * from './GoalIcon';
+export * from './IconRefuge';
 export * from './IssueTypeIcon';
-export * from './PortfolioIcon/PortfolioIcon';
-export * from './ProjectIcon/ProjectIcon';
+export * from './KeyResultIcon';
+export * from './MetaEntityIcon';
+export * from './PortfolioIcon';
+export * from './ProjectIcon';

package/build/cjs/components/Icon/index.js

@@ -3,6 +3,39 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+var _EntityIcon = require("./EntityIcon");
+Object.keys(_EntityIcon).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _EntityIcon[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _EntityIcon[key];
+    }
+  });
+});
+var _GoalIcon = require("./GoalIcon");
+Object.keys(_GoalIcon).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _GoalIcon[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _GoalIcon[key];
+    }
+  });
+});
+var _IconRefuge = require("./IconRefuge");
+Object.keys(_IconRefuge).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _IconRefuge[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _IconRefuge[key];
+    }
+  });
+});
 var _IssueTypeIcon = require("./IssueTypeIcon");
 Object.keys(_IssueTypeIcon).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -14,7 +47,29 @@ Object.keys(_IssueTypeIcon).forEach(function (key) {
     }
   });
 });
-var _PortfolioIcon = require("./PortfolioIcon/PortfolioIcon");
+var _KeyResultIcon = require("./KeyResultIcon");
+Object.keys(_KeyResultIcon).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _KeyResultIcon[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _KeyResultIcon[key];
+    }
+  });
+});
+var _MetaEntityIcon = require("./MetaEntityIcon");
+Object.keys(_MetaEntityIcon).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _MetaEntityIcon[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _MetaEntityIcon[key];
+    }
+  });
+});
+var _PortfolioIcon = require("./PortfolioIcon");
 Object.keys(_PortfolioIcon).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _PortfolioIcon[key]) return;
@@ -25,7 +80,7 @@ Object.keys(_PortfolioIcon).forEach(function (key) {
     }
   });
 });
-var _ProjectIcon = require("./ProjectIcon/ProjectIcon");
+var _ProjectIcon = require("./ProjectIcon");
 Object.keys(_ProjectIcon).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _ProjectIcon[key]) return;

package/build/cjs/components/Icon/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_IssueTypeIcon","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_PortfolioIcon","_ProjectIcon"],"sources":["index.ts"],"sourcesContent":["export * from './IssueTypeIcon';\nexport * from './PortfolioIcon/PortfolioIcon';\nexport * from './ProjectIcon/ProjectIcon';\n"],"mappings":";;;;;AAAA,IAAAA,cAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,cAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,cAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,cAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,cAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,cAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,cAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,cAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,YAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,YAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,YAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,YAAA,CAAAN,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}
+{"version":3,"names":["_EntityIcon","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_GoalIcon","_IconRefuge","_IssueTypeIcon","_KeyResultIcon","_MetaEntityIcon","_PortfolioIcon","_ProjectIcon"],"sources":["index.ts"],"sourcesContent":["export * from './EntityIcon';\nexport * from './GoalIcon';\nexport * from './IconRefuge';\nexport * from './IssueTypeIcon';\nexport * from './KeyResultIcon';\nexport * from './MetaEntityIcon';\nexport * from './PortfolioIcon';\nexport * from './ProjectIcon';\n"],"mappings":"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","ignoreList":[]}

package/build/cjs/components/MetaEntitiesSelect/MetaEntitiesSelect.classname.d.ts

@@ -0,0 +1 @@
+export declare const cnMetaEntitiesSelect: import("@bem-react/classname").ClassNameFormatter;

package/build/cjs/components/MetaEntitiesSelect/MetaEntitiesSelect.classname.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.cnMetaEntitiesSelect = void 0;
+var _cn = require("./../cn");
+var cnMetaEntitiesSelect = exports.cnMetaEntitiesSelect = (0, _cn.block)('meta-entities-select');
+// #sourceMappingURL=MetaEntitiesSelect.classname.js.map

package/build/cjs/components/MetaEntitiesSelect/MetaEntitiesSelect.classname.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_cn","require","cnMetaEntitiesSelect","exports","block"],"sources":["MetaEntitiesSelect.classname.ts"],"sourcesContent":["import {block} from '~/src/components/cn';\n\nexport const cnMetaEntitiesSelect = block('meta-entities-select');\n"],"mappings":";;;;;;AAAA,IAAAA,GAAA,GAAAC,OAAA;AAEO,IAAMC,oBAAoB,GAAAC,OAAA,CAAAD,oBAAA,GAAG,IAAAE,SAAK,EAAC,sBAAsB,CAAC","ignoreList":[]}

package/build/cjs/components/MetaEntitiesSelect/MetaEntitiesSelect.d.ts

@@ -0,0 +1,10 @@
+import type { FC } from 'react';
+import type { MetaEntityV2 } from '@weavix/tracker-api-types';
+import type { EntitiesSuggestProps } from './components/EntitiesSuggest/EntitiesSuggest';
+type EntitiesSuggestPropsToOmit = 'getItemId' | 'getSuggestTextFromClickedItem' | 'renderItem';
+export type MetaEntitiesSelectProps = Omit<EntitiesSuggestProps<MetaEntityV2>, EntitiesSuggestPropsToOmit> & {
+    className?: string;
+    itemClassName?: string;
+};
+export declare const MetaEntitiesSelect: FC<MetaEntitiesSelectProps>;
+export {};

package/build/cjs/components/MetaEntitiesSelect/MetaEntitiesSelect.js

@@ -0,0 +1,65 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.MetaEntitiesSelect = void 0;
+var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _react = _interopRequireWildcard(require("react"));
+var _uikit = require("@gravity-ui/uikit");
+var _Icon = require("./../Icon");
+var _useLocalizedString2 = require("./../../hooks/useLocalizedString");
+var _MetaEntitiesSelect = require("./MetaEntitiesSelect.classname");
+var _EntitiesSuggest = require("./components/EntitiesSuggest/EntitiesSuggest");
+var _EntitiesSuggestItem = require("./components/EntitiesSuggestItem/EntitiesSuggestItem");
+var _i18n = require("./i18n");
+var _getMetaEntityDisplay = require("./utils/getMetaEntityDisplay");
+var _getMetaEntityId = require("./utils/getMetaEntityId");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+var _excluded = ["className", "itemClassName", "placeholder", "text", "onTextChange"];
+var MetaEntitiesSelect = exports.MetaEntitiesSelect = function MetaEntitiesSelect(_ref) {
+  var className = _ref.className,
+    itemClassName = _ref.itemClassName,
+    placeholder = _ref.placeholder,
+    initialText = _ref.text,
+    onTextChange = _ref.onTextChange,
+    suggestProps = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var config = (0, _uikit.getConfig)();
+  var _useLocalizedString = (0, _useLocalizedString2.useLocalizedString)(_i18n.defaultMessages, config.lang),
+    t = _useLocalizedString.t;
+  var _useState = (0, _react.useState)(initialText !== null && initialText !== void 0 ? initialText : ''),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    text = _useState2[0],
+    setText = _useState2[1];
+  var handleTextChange = (0, _react.useCallback)(function (value) {
+    setText(value);
+    onTextChange === null || onTextChange === void 0 || onTextChange(value);
+  }, [setText, onTextChange]);
+  var renderItem = (0, _react.useCallback)(function (entity) {
+    var entityName = (0, _getMetaEntityDisplay.getMetaEntityDisplay)(entity);
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_EntitiesSuggestItem.EntitiesSuggestItem, {
+      id: entity.id,
+      name: entityName,
+      className: (0, _MetaEntitiesSelect.cnMetaEntitiesSelect)('item', itemClassName),
+      icon: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Icon.MetaEntityIcon, {
+        entity: entity
+      })
+    }, entity.id);
+  }, [itemClassName]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_EntitiesSuggest.EntitiesSuggest, (0, _objectSpread2.default)((0, _objectSpread2.default)({}, suggestProps), {}, {
+    className: (0, _MetaEntitiesSelect.cnMetaEntitiesSelect)(null, className),
+    renderItem: renderItem,
+    placeholder: placeholder !== null && placeholder !== void 0 ? placeholder : t('placeholder'),
+    getItemsOnMount: true,
+    showItemsOnNoText: true,
+    getItemId: _getMetaEntityId.getMetaEntityId,
+    getSuggestTextFromClickedItem: _getMetaEntityDisplay.getMetaEntityDisplay,
+    text: text,
+    onTextChange: handleTextChange
+  }));
+};
+// #sourceMappingURL=MetaEntitiesSelect.js.map

package/build/cjs/components/MetaEntitiesSelect/MetaEntitiesSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireWildcard","require","_uikit","_Icon","_useLocalizedString2","_MetaEntitiesSelect","_EntitiesSuggest","_EntitiesSuggestItem","_i18n","_getMetaEntityDisplay","_getMetaEntityId","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","_interopRequireDefault","MetaEntitiesSelect","exports","_ref","className","itemClassName","placeholder","initialText","text","onTextChange","suggestProps","_objectWithoutProperties","_excluded","config","getConfig","_useLocalizedString","useLocalizedString","defaultMessages","lang","_useState","useState","_useState2","_slicedToArray","setText","handleTextChange","useCallback","value","renderItem","entity","entityName","getMetaEntityDisplay","_jsx","EntitiesSuggestItem","id","name","cnMetaEntitiesSelect","icon","MetaEntityIcon","EntitiesSuggest","_objectSpread","getItemsOnMount","showItemsOnNoText","getItemId","getMetaEntityId","getSuggestTextFromClickedItem"],"sources":["MetaEntitiesSelect.tsx"],"sourcesContent":["import type {FC} from 'react';\nimport React, {useCallback, useState} from 'react';\n\nimport {getConfig} from '@gravity-ui/uikit';\nimport type {MetaEntityV2} from '@weavix/tracker-api-types';\n\nimport {MetaEntityIcon} from '~/src/components/Icon/';\nimport {useLocalizedString} from '~/src/hooks/useLocalizedString';\n\nimport {cnMetaEntitiesSelect} from './MetaEntitiesSelect.classname';\nimport {EntitiesSuggest} from './components/EntitiesSuggest/EntitiesSuggest';\nimport type {EntitiesSuggestProps} from './components/EntitiesSuggest/EntitiesSuggest';\nimport {EntitiesSuggestItem} from './components/EntitiesSuggestItem/EntitiesSuggestItem';\nimport {defaultMessages} from './i18n';\nimport {getMetaEntityDisplay} from './utils/getMetaEntityDisplay';\nimport {getMetaEntityId} from './utils/getMetaEntityId';\n\ntype EntitiesSuggestPropsToOmit = 'getItemId' | 'getSuggestTextFromClickedItem' | 'renderItem';\n\nexport type MetaEntitiesSelectProps = Omit<\n    EntitiesSuggestProps<MetaEntityV2>,\n    EntitiesSuggestPropsToOmit\n> & {\n    className?: string;\n    itemClassName?: string;\n};\n\nexport const MetaEntitiesSelect: FC<MetaEntitiesSelectProps> = ({\n    className,\n    itemClassName,\n    placeholder,\n    text: initialText,\n    onTextChange,\n    ...suggestProps\n}) => {\n    const config = getConfig();\n    const {t} = useLocalizedString(defaultMessages, config.lang);\n    const [text, setText] = useState(initialText ?? '');\n    const handleTextChange = useCallback(\n        (value: string) => {\n            setText(value);\n            onTextChange?.(value);\n        },\n        [setText, onTextChange],\n    );\n\n    const renderItem = useCallback(\n        (entity: MetaEntityV2) => {\n            const entityName = getMetaEntityDisplay(entity);\n            return (\n                <EntitiesSuggestItem\n                    key={entity.id}\n                    id={entity.id}\n                    name={entityName}\n                    className={cnMetaEntitiesSelect('item', itemClassName)}\n                    icon={<MetaEntityIcon entity={entity} />}\n                />\n            );\n        },\n        [itemClassName],\n    );\n\n    return (\n        <EntitiesSuggest<MetaEntityV2>\n            {...suggestProps}\n            className={cnMetaEntitiesSelect(null, className)}\n            renderItem={renderItem}\n            placeholder={placeholder ?? t('placeholder')}\n            getItemsOnMount\n            showItemsOnNoText\n            getItemId={getMetaEntityId}\n            getSuggestTextFromClickedItem={getMetaEntityDisplay}\n            text={text}\n            onTextChange={handleTextChange}\n        />\n    );\n};\n"],"mappings":"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","ignoreList":[]}

package/build/cjs/components/MetaEntitiesSelect/README.md

@@ -0,0 +1,183 @@
+# MetaEntitiesSelect
+
+<!-- description:start -->
+A suggest-based select component for choosing Tracker meta entities (projects, portfolios, goals, or reports) inside a plugin. Renders each entity with its icon and display name, supports async item fetching, loading states, error display, and a clear button.
+<!-- description:end -->
+
+## Usage
+
+```tsx
+import {MetaEntitiesSelect} from '@weavix/tracker-components';
+import type {MetaEntitiesSelectProps} from '@weavix/tracker-components';
+import type {MetaEntityV2} from '@weavix/tracker-api-types';
+
+<MetaEntitiesSelect
+    getItems={(text) => fetchProjects(text)}
+    onChange={(entity) => console.log('selected', entity)}
+/>;
+```
+
+## Component props
+
+<!-- props:start -->
+```ts
+{
+    /**
+     * Async or sync function called to fetch items.
+     * Receives the current text input and should return a list of MetaEntityV2 objects.
+     * Called on mount (getItemsOnMount) and on every text change.
+     */
+    getItems?: (text: string) => MetaEntityV2[] | Promise<MetaEntityV2[]>;
+
+    /**
+     * Callback fired when the user selects an entity from the suggest list.
+     */
+    onChange?: (entity: MetaEntityV2) => void;
+
+    /**
+     * Callback fired when the text input value changes.
+     */
+    onTextChange?: (text: string) => void;
+
+    /**
+     * Current text value of the input (controlled).
+     */
+    text?: string;
+
+    /**
+     * Placeholder text shown when the input is empty.
+     * @default 'Select a project'
+     */
+    placeholder?: string;
+
+    /**
+     * Error message or boolean to display an error state on the control.
+     */
+    error?: string | boolean;
+
+    /**
+     * Whether to show a clear (×) button when a value is selected.
+     * @default true
+     */
+    hasClear?: boolean;
+
+    /**
+     * Additional CSS class applied to the root element.
+     */
+    className?: string;
+
+    /**
+     * Additional CSS class applied to each item in the suggest list.
+     */
+    itemClassName?: string;
+}
+```
+<!-- props:end -->
+
+## Types
+
+```ts
+// From @weavix/tracker-api-types
+type MetaEntityV2 = {
+    id: string;
+    shortId: number;
+    entityType: 'project' | 'portfolio' | 'report' | 'goal';
+    self: string;
+    version: number;
+    createdBy: {self: string; id: string; display: string};
+    createdAt: string;
+    updatedAt: string;
+    fields?: {
+        summary?: {value: string};
+        [key: string]: unknown;
+    };
+};
+```
+
+---
+
+## Tracker API
+
+`MetaEntitiesSelect` is data-agnostic — it accepts items via the `getItems` prop. You are responsible for fetching data from the Tracker API and passing it to the component.
+
+### Getting projects
+
+Use the entities search endpoint to fetch projects (or other entity types):
+
+```ts
+const result = await trackerApi.v3.post['/entities/{entityType}/_search']({
+    pathParams: {
+        entityType: 'project',
+    },
+    queryParams: {
+        fields: ['summary'],
+        page:1,
+        perPage: 50,
+    },
+    bodyParams: {
+        filter: {},
+        filterTypes: ['ALL'],
+        input,
+    },
+});
+return result.data; // MetaEntityV2[]
+```
+
+> **Other entity types:** The `entityType` path parameter accepts `'portfolio' | 'project' | 'report' | 'goal'`. Use the appropriate value depending on which entities you want to display in the select.
+
+> **Result:** Always return `result.data` from the API response.
+
+---
+
+### Example — Projects select with Tracker API
+
+Fetches projects on every text change using the entities search endpoint. Request errors are caught and passed to the component via the `error` prop.
+
+```tsx
+import React, {useState} from 'react';
+import {MetaEntitiesSelect} from '@weavix/tracker-components';
+import type {MetaEntityV2} from '@weavix/tracker-api-types';
+
+interface Props {
+    trackerApi: TrackerApi; // your Tracker API client
+    onChange: (entity: MetaEntityV2) => void;
+}
+
+export const ProjectSelect: React.FC<Props> = ({trackerApi, onChange}) => {
+    const [error, setError] = useState<string | undefined>(undefined);
+
+    const getItems = async (input: string): Promise<MetaEntityV2[]> => {
+        setError(undefined);
+        try {
+            const result = await trackerApi.v3.post['/entities/{entityType}/_search']({
+                pathParams: {
+                    entityType: 'project',
+                },
+                queryParams: {
+                    fields: ['summary'],
+                    page:1,
+                    perPage: 50,
+                },
+                bodyParams: {
+                    filter: {},
+                    filterTypes: ['ALL'],
+                    input,
+                },
+            });
+            return result.data;
+        } catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to load projects');
+            return [];
+        }
+    };
+
+    return (
+        <MetaEntitiesSelect
+            getItems={getItems}
+            onChange={onChange}
+            error={error}
+            placeholder="Select a project"
+        />
+    );
+};
+```

package/build/cjs/components/MetaEntitiesSelect/components/EntitiesSuggest/EntitiesSuggest.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { Ref } from 'react';
+import { SuggestView } from '~/src/components/Suggest';
+import type { SuggestProps } from '~/src/components/Suggest';
+type SuggestPropsToOmit = 'text' | 'onTextUpdate' | 'applicableInputValue' | 'onInputEnterKeyDown' | 'onUpdate';
+export type EntitiesSuggestProps<EntityType extends unknown = {}> = Omit<SuggestProps<EntityType>, SuggestPropsToOmit> & {
+    onChange?: (entity: EntityType | null) => void;
+    getItemId: (item: EntityType) => string | number;
+    getSuggestTextFromClickedItem: (item: EntityType) => string;
+    suggestRef?: Ref<SuggestView<EntityType>>;
+    text?: string;
+    onTextChange?: (text: string) => void;
+};
+export declare const EntitiesSuggest: <EntityType extends unknown = {}>({ onItemClick, onChange, hasClear, debounce, getItems, getItemId, getSuggestTextFromClickedItem, suggestRef, text: providedText, onTextChange, getItemsOnMount, ...suggestProps }: EntitiesSuggestProps<EntityType>) => React.JSX.Element;
+export {};