@gravity-ui/aikit 2.2.1-beta.c34166a0895bc049a23b2ba68f233d0ea0e55a8b.0 → 2.3.0

package/README.md

@@ -6,6 +6,8 @@ UI component library for AI chats built with Atomic Design principles.
 
 ![Cover image](https://raw.githubusercontent.com/gravity-ui/aikit/main/docs/assets/aikit_cover.png)
 
+![Example image](https://raw.githubusercontent.com/gravity-ui/aikit/main/docs/assets/aikit_example.png)
+
 ## Resources
 
 ### ![Globe Logo Light](https://raw.githubusercontent.com/gravity-ui/aikit/main/docs/assets/globe_light.svg#gh-light-mode-only) ![Globe Logo Dark](https://raw.githubusercontent.com/gravity-ui/aikit/main/docs/assets/globe_dark.svg#gh-dark-mode-only) [Website](https://gravity-ui.com/libraries/aikit)

package/build/cjs/hooks/index.d.ts

@@ -5,4 +5,3 @@ export * from "./useScrollPreservation.js";
 export * from "./useAutoCollapseOnSuccess.js";
 export * from "./useAutoCollapseOnCancelled.js";
 export * from "./useFileUploadStore.js";
-export * from "./useToolset.js";

package/build/cjs/hooks/index.js

@@ -8,5 +8,4 @@ tslib_1.__exportStar(require("./useScrollPreservation.js"), exports);
 tslib_1.__exportStar(require("./useAutoCollapseOnSuccess.js"), exports);
 tslib_1.__exportStar(require("./useAutoCollapseOnCancelled.js"), exports);
 tslib_1.__exportStar(require("./useFileUploadStore.js"), exports);
-tslib_1.__exportStar(require("./useToolset.js"), exports);
 //# sourceMappingURL=index.js.map

package/build/cjs/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"../../../src","sources":["hooks/index.ts"],"names":[],"mappings":";;;AAAA,sEAAmC;AACnC,8DAAiC;AACjC,8DAAiC;AACjC,qEAAwC;AACxC,wEAA2C;AAC3C,0EAA6C;AAC7C,kEAAqC;AACrC,0DAA6B","sourcesContent":["export * from './useDateFormatter';\nexport * from './useToolMessage';\nexport * from './useSmartScroll';\nexport * from './useScrollPreservation';\nexport * from './useAutoCollapseOnSuccess';\nexport * from './useAutoCollapseOnCancelled';\nexport * from './useFileUploadStore';\nexport * from './useToolset';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"../../../src","sources":["hooks/index.ts"],"names":[],"mappings":";;;AAAA,sEAAmC;AACnC,8DAAiC;AACjC,8DAAiC;AACjC,qEAAwC;AACxC,wEAA2C;AAC3C,0EAA6C;AAC7C,kEAAqC","sourcesContent":["export * from './useDateFormatter';\nexport * from './useToolMessage';\nexport * from './useSmartScroll';\nexport * from './useScrollPreservation';\nexport * from './useAutoCollapseOnSuccess';\nexport * from './useAutoCollapseOnCancelled';\nexport * from './useFileUploadStore';\n"]}

package/build/cjs/package.json

@@ -1 +1 @@
-{"version":"2.2.1-beta.c34166a0895bc049a23b2ba68f233d0ea0e55a8b.0","type":"commonjs","sideEffects":["*.css","*.scss"]}
+{"version":"2.3.0","type":"commonjs","sideEffects":["*.css","*.scss"]}

package/build/cjs/utils/index.d.ts

@@ -3,4 +3,3 @@ export * from "./messageUtils.js";
 export * from "./validation.js";
 export * from "./messageTypeRegistry.js";
 export * from "./clipboardUtils.js";
-export * from "./toolset/index.js";

package/build/cjs/utils/index.js

@@ -7,5 +7,4 @@ tslib_1.__exportStar(require("./messageUtils.js"), exports);
 tslib_1.__exportStar(require("./validation.js"), exports);
 tslib_1.__exportStar(require("./messageTypeRegistry.js"), exports);
 tslib_1.__exportStar(require("./clipboardUtils.js"), exports);
-tslib_1.__exportStar(require("./toolset/index.js"), exports);
 //# sourceMappingURL=index.js.map

package/build/cjs/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"../../../src","sources":["utils/index.ts"],"names":[],"mappings":";;;AAAA,mBAAmB;AACnB,yDAA4B;AAC5B,4DAA+B;AAC/B,0DAA6B;AAC7B,mEAAsC;AACtC,8DAAiC;AACjC,6DAA0B","sourcesContent":["// Export utilities\nexport * from './chatUtils';\nexport * from './messageUtils';\nexport * from './validation';\nexport * from './messageTypeRegistry';\nexport * from './clipboardUtils';\nexport * from './toolset';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"../../../src","sources":["utils/index.ts"],"names":[],"mappings":";;;AAAA,mBAAmB;AACnB,yDAA4B;AAC5B,4DAA+B;AAC/B,0DAA6B;AAC7B,mEAAsC;AACtC,8DAAiC","sourcesContent":["// Export utilities\nexport * from './chatUtils';\nexport * from './messageUtils';\nexport * from './validation';\nexport * from './messageTypeRegistry';\nexport * from './clipboardUtils';\n"]}

package/build/cjs/utils/messageTypeRegistry.js

@@ -8,11 +8,6 @@ function createMessageRendererRegistry() {
     return {};
 }
 function registerMessageRenderer(registry, contentType, renderer) {
-    if (process.env.NODE_ENV !== 'production' &&
-        Object.prototype.hasOwnProperty.call(registry, contentType)) {
-        // eslint-disable-next-line no-console
-        console.warn(`registerMessageRenderer: overwriting existing renderer for content type "${contentType}"`);
-    }
     Object.assign(registry, {
         [contentType]: renderer,
     });

package/build/cjs/utils/messageTypeRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"messageTypeRegistry.js","sourceRoot":"../../../src","sources":["utils/messageTypeRegistry.ts"],"names":[],"mappings":";;AAcA,sEAEC;AAED,0DAkBC;AAED,gDAKC;AAED,wEAQC;AAvCD,SAAgB,6BAA6B;IACzC,OAAO,EAAE,CAAC;AACd,CAAC;AAED,SAAgB,uBAAuB,CACnC,QAAiC,EACjC,WAA6B,EAC7B,QAAmC;IAEnC,IACI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QACrC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAC7D,CAAC;QACC,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACR,4EAA4E,WAAW,GAAG,CAC7F,CAAC;IACN,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;QACpB,CAAC,WAAW,CAAC,EAAE,QAAsC;KACxD,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,SAAgB,kBAAkB,CAC9B,QAAiC,EACjC,WAAmB;;IAEnB,OAAO,MAAA,QAAQ,CAAC,WAAW,CAAC,0CAAE,SAAS,CAAC;AAC5C,CAAC;AAED,SAAgB,8BAA8B,CAC1C,eAAwC,EACxC,cAAuC;IAEvC,uCACO,eAAe,GACf,cAAc,EACnB;AACN,CAAC","sourcesContent":["import type React from 'react';\n\nimport type {TMessageContent} from '../types/messages';\n\nexport type MessageContentComponentProps<TContent extends TMessageContent = TMessageContent> = {\n    part: TContent;\n};\n\nexport type MessageRenderer<TContent extends TMessageContent = TMessageContent> = {\n    component: React.ComponentType<MessageContentComponentProps<TContent>>;\n};\n\nexport type MessageRendererRegistry = Record<string, MessageRenderer>;\n\nexport function createMessageRendererRegistry(): MessageRendererRegistry {\n    return {};\n}\n\nexport function registerMessageRenderer<TContent extends TMessageContent>(\n    registry: MessageRendererRegistry,\n    contentType: TContent['type'],\n    renderer: MessageRenderer<TContent>,\n): MessageRendererRegistry {\n    if (\n        process.env.NODE_ENV !== 'production' &&\n        Object.prototype.hasOwnProperty.call(registry, contentType)\n    ) {\n        // eslint-disable-next-line no-console\n        console.warn(\n            `registerMessageRenderer: overwriting existing renderer for content type \"${contentType}\"`,\n        );\n    }\n    Object.assign(registry, {\n        [contentType]: renderer as unknown as MessageRenderer,\n    });\n    return registry;\n}\n\nexport function getMessageRenderer(\n    registry: MessageRendererRegistry,\n    contentType: string,\n): React.ComponentType<MessageContentComponentProps> | undefined {\n    return registry[contentType]?.component;\n}\n\nexport function mergeMessageRendererRegistries(\n    defaultRegistry: MessageRendererRegistry,\n    customRegistry: MessageRendererRegistry,\n): MessageRendererRegistry {\n    return {\n        ...defaultRegistry,\n        ...customRegistry,\n    };\n}\n"]}
+{"version":3,"file":"messageTypeRegistry.js","sourceRoot":"../../../src","sources":["utils/messageTypeRegistry.ts"],"names":[],"mappings":";;AAcA,sEAEC;AAED,0DASC;AAED,gDAKC;AAED,wEAQC;AA9BD,SAAgB,6BAA6B;IACzC,OAAO,EAAE,CAAC;AACd,CAAC;AAED,SAAgB,uBAAuB,CACnC,QAAiC,EACjC,WAA6B,EAC7B,QAAmC;IAEnC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;QACpB,CAAC,WAAW,CAAC,EAAE,QAAsC;KACxD,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,SAAgB,kBAAkB,CAC9B,QAAiC,EACjC,WAAmB;;IAEnB,OAAO,MAAA,QAAQ,CAAC,WAAW,CAAC,0CAAE,SAAS,CAAC;AAC5C,CAAC;AAED,SAAgB,8BAA8B,CAC1C,eAAwC,EACxC,cAAuC;IAEvC,uCACO,eAAe,GACf,cAAc,EACnB;AACN,CAAC","sourcesContent":["import type React from 'react';\n\nimport type {TMessageContent} from '../types/messages';\n\nexport type MessageContentComponentProps<TContent extends TMessageContent = TMessageContent> = {\n    part: TContent;\n};\n\nexport type MessageRenderer<TContent extends TMessageContent = TMessageContent> = {\n    component: React.ComponentType<MessageContentComponentProps<TContent>>;\n};\n\nexport type MessageRendererRegistry = Record<string, MessageRenderer>;\n\nexport function createMessageRendererRegistry(): MessageRendererRegistry {\n    return {};\n}\n\nexport function registerMessageRenderer<TContent extends TMessageContent>(\n    registry: MessageRendererRegistry,\n    contentType: TContent['type'],\n    renderer: MessageRenderer<TContent>,\n): MessageRendererRegistry {\n    Object.assign(registry, {\n        [contentType]: renderer as unknown as MessageRenderer,\n    });\n    return registry;\n}\n\nexport function getMessageRenderer(\n    registry: MessageRendererRegistry,\n    contentType: string,\n): React.ComponentType<MessageContentComponentProps> | undefined {\n    return registry[contentType]?.component;\n}\n\nexport function mergeMessageRendererRegistries(\n    defaultRegistry: MessageRendererRegistry,\n    customRegistry: MessageRendererRegistry,\n): MessageRendererRegistry {\n    return {\n        ...defaultRegistry,\n        ...customRegistry,\n    };\n}\n"]}

package/build/esm/hooks/index.d.ts

@@ -5,4 +5,3 @@ export * from "./useScrollPreservation.js";
 export * from "./useAutoCollapseOnSuccess.js";
 export * from "./useAutoCollapseOnCancelled.js";
 export * from "./useFileUploadStore.js";
-export * from "./useToolset.js";

package/build/esm/hooks/index.js

@@ -5,5 +5,4 @@ export * from "./useScrollPreservation.js";
 export * from "./useAutoCollapseOnSuccess.js";
 export * from "./useAutoCollapseOnCancelled.js";
 export * from "./useFileUploadStore.js";
-export * from "./useToolset.js";
 //# sourceMappingURL=index.js.map

package/build/esm/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"../../../src","sources":["hooks/index.ts"],"names":[],"mappings":"AAAA,4CAAmC;AACnC,oCAAiC;AACjC,oCAAiC;AACjC,2CAAwC;AACxC,8CAA2C;AAC3C,gDAA6C;AAC7C,wCAAqC;AACrC,gCAA6B","sourcesContent":["export * from './useDateFormatter';\nexport * from './useToolMessage';\nexport * from './useSmartScroll';\nexport * from './useScrollPreservation';\nexport * from './useAutoCollapseOnSuccess';\nexport * from './useAutoCollapseOnCancelled';\nexport * from './useFileUploadStore';\nexport * from './useToolset';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"../../../src","sources":["hooks/index.ts"],"names":[],"mappings":"AAAA,4CAAmC;AACnC,oCAAiC;AACjC,oCAAiC;AACjC,2CAAwC;AACxC,8CAA2C;AAC3C,gDAA6C;AAC7C,wCAAqC","sourcesContent":["export * from './useDateFormatter';\nexport * from './useToolMessage';\nexport * from './useSmartScroll';\nexport * from './useScrollPreservation';\nexport * from './useAutoCollapseOnSuccess';\nexport * from './useAutoCollapseOnCancelled';\nexport * from './useFileUploadStore';\n"]}

package/build/esm/package.json

@@ -1 +1 @@
-{"version":"2.2.1-beta.c34166a0895bc049a23b2ba68f233d0ea0e55a8b.0","type":"module","sideEffects":["*.css","*.scss"]}
+{"version":"2.3.0","type":"module","sideEffects":["*.css","*.scss"]}

package/build/esm/utils/index.d.ts

@@ -3,4 +3,3 @@ export * from "./messageUtils.js";
 export * from "./validation.js";
 export * from "./messageTypeRegistry.js";
 export * from "./clipboardUtils.js";
-export * from "./toolset/index.js";

package/build/esm/utils/index.js

@@ -4,5 +4,4 @@ export * from "./messageUtils.js";
 export * from "./validation.js";
 export * from "./messageTypeRegistry.js";
 export * from "./clipboardUtils.js";
-export * from "./toolset/index.js";
 //# sourceMappingURL=index.js.map

package/build/esm/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"../../../src","sources":["utils/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,+BAA4B;AAC5B,kCAA+B;AAC/B,gCAA6B;AAC7B,yCAAsC;AACtC,oCAAiC;AACjC,mCAA0B","sourcesContent":["// Export utilities\nexport * from './chatUtils';\nexport * from './messageUtils';\nexport * from './validation';\nexport * from './messageTypeRegistry';\nexport * from './clipboardUtils';\nexport * from './toolset';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"../../../src","sources":["utils/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,+BAA4B;AAC5B,kCAA+B;AAC/B,gCAA6B;AAC7B,yCAAsC;AACtC,oCAAiC","sourcesContent":["// Export utilities\nexport * from './chatUtils';\nexport * from './messageUtils';\nexport * from './validation';\nexport * from './messageTypeRegistry';\nexport * from './clipboardUtils';\n"]}

package/build/esm/utils/messageTypeRegistry.js

@@ -2,11 +2,6 @@ export function createMessageRendererRegistry() {
     return {};
 }
 export function registerMessageRenderer(registry, contentType, renderer) {
-    if (process.env.NODE_ENV !== 'production' &&
-        Object.prototype.hasOwnProperty.call(registry, contentType)) {
-        // eslint-disable-next-line no-console
-        console.warn(`registerMessageRenderer: overwriting existing renderer for content type "${contentType}"`);
-    }
     Object.assign(registry, {
         [contentType]: renderer,
     });

package/build/esm/utils/messageTypeRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"messageTypeRegistry.js","sourceRoot":"../../../src","sources":["utils/messageTypeRegistry.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,6BAA6B;IACzC,OAAO,EAAE,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CACnC,QAAiC,EACjC,WAA6B,EAC7B,QAAmC;IAEnC,IACI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QACrC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAC7D,CAAC;QACC,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACR,4EAA4E,WAAW,GAAG,CAC7F,CAAC;IACN,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;QACpB,CAAC,WAAW,CAAC,EAAE,QAAsC;KACxD,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAC9B,QAAiC,EACjC,WAAmB;;IAEnB,OAAO,MAAA,QAAQ,CAAC,WAAW,CAAC,0CAAE,SAAS,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC1C,eAAwC,EACxC,cAAuC;IAEvC,uCACO,eAAe,GACf,cAAc,EACnB;AACN,CAAC","sourcesContent":["import type React from 'react';\n\nimport type {TMessageContent} from '../types/messages';\n\nexport type MessageContentComponentProps<TContent extends TMessageContent = TMessageContent> = {\n    part: TContent;\n};\n\nexport type MessageRenderer<TContent extends TMessageContent = TMessageContent> = {\n    component: React.ComponentType<MessageContentComponentProps<TContent>>;\n};\n\nexport type MessageRendererRegistry = Record<string, MessageRenderer>;\n\nexport function createMessageRendererRegistry(): MessageRendererRegistry {\n    return {};\n}\n\nexport function registerMessageRenderer<TContent extends TMessageContent>(\n    registry: MessageRendererRegistry,\n    contentType: TContent['type'],\n    renderer: MessageRenderer<TContent>,\n): MessageRendererRegistry {\n    if (\n        process.env.NODE_ENV !== 'production' &&\n        Object.prototype.hasOwnProperty.call(registry, contentType)\n    ) {\n        // eslint-disable-next-line no-console\n        console.warn(\n            `registerMessageRenderer: overwriting existing renderer for content type \"${contentType}\"`,\n        );\n    }\n    Object.assign(registry, {\n        [contentType]: renderer as unknown as MessageRenderer,\n    });\n    return registry;\n}\n\nexport function getMessageRenderer(\n    registry: MessageRendererRegistry,\n    contentType: string,\n): React.ComponentType<MessageContentComponentProps> | undefined {\n    return registry[contentType]?.component;\n}\n\nexport function mergeMessageRendererRegistries(\n    defaultRegistry: MessageRendererRegistry,\n    customRegistry: MessageRendererRegistry,\n): MessageRendererRegistry {\n    return {\n        ...defaultRegistry,\n        ...customRegistry,\n    };\n}\n"]}
+{"version":3,"file":"messageTypeRegistry.js","sourceRoot":"../../../src","sources":["utils/messageTypeRegistry.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,6BAA6B;IACzC,OAAO,EAAE,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CACnC,QAAiC,EACjC,WAA6B,EAC7B,QAAmC;IAEnC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;QACpB,CAAC,WAAW,CAAC,EAAE,QAAsC;KACxD,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAC9B,QAAiC,EACjC,WAAmB;;IAEnB,OAAO,MAAA,QAAQ,CAAC,WAAW,CAAC,0CAAE,SAAS,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC1C,eAAwC,EACxC,cAAuC;IAEvC,uCACO,eAAe,GACf,cAAc,EACnB;AACN,CAAC","sourcesContent":["import type React from 'react';\n\nimport type {TMessageContent} from '../types/messages';\n\nexport type MessageContentComponentProps<TContent extends TMessageContent = TMessageContent> = {\n    part: TContent;\n};\n\nexport type MessageRenderer<TContent extends TMessageContent = TMessageContent> = {\n    component: React.ComponentType<MessageContentComponentProps<TContent>>;\n};\n\nexport type MessageRendererRegistry = Record<string, MessageRenderer>;\n\nexport function createMessageRendererRegistry(): MessageRendererRegistry {\n    return {};\n}\n\nexport function registerMessageRenderer<TContent extends TMessageContent>(\n    registry: MessageRendererRegistry,\n    contentType: TContent['type'],\n    renderer: MessageRenderer<TContent>,\n): MessageRendererRegistry {\n    Object.assign(registry, {\n        [contentType]: renderer as unknown as MessageRenderer,\n    });\n    return registry;\n}\n\nexport function getMessageRenderer(\n    registry: MessageRendererRegistry,\n    contentType: string,\n): React.ComponentType<MessageContentComponentProps> | undefined {\n    return registry[contentType]?.component;\n}\n\nexport function mergeMessageRendererRegistries(\n    defaultRegistry: MessageRendererRegistry,\n    customRegistry: MessageRendererRegistry,\n): MessageRendererRegistry {\n    return {\n        ...defaultRegistry,\n        ...customRegistry,\n    };\n}\n"]}

package/docs/HOOKS.md

@@ -1,17 +1,16 @@
 # Hooks
 
-AIKit exports 8 public hooks. All are re-exported from the package root and from the `@gravity-ui/aikit/hooks` subpath.
-
-| Hook                                                        | Purpose                                                                        |
-| ----------------------------------------------------------- | ------------------------------------------------------------------------------ |
-| [`useDateFormatter`](#usedateformatter)                     | Format chat timestamps with locale and relative-date logic                     |
-| [`useToolMessage`](#usetoolmessage)                         | Tool-message state machine (expand/collapse based on status)                   |
-| [`useSmartScroll`](#usesmartscroll)                         | Auto-scroll to bottom while respecting user scroll-up                          |
-| [`useScrollPreservation`](#usescrollpreservation)           | Preserve scroll position when items are prepended                              |
-| [`useAutoCollapseOnSuccess`](#useautocollapseonsuccess)     | Collapse a section when its async operation succeeds                           |
-| [`useAutoCollapseOnCancelled`](#useautocollapseoncancelled) | Collapse a section when its async operation is cancelled                       |
-| [`useFileUploadStore`](#usefileuploadstore)                 | Standalone file-upload store with progress/error states                        |
-| [`useToolset`](#usetoolset)                                 | Wire a toolset into the chat: renderer registry + history merge for tool calls |
+AIKit exports 7 public hooks. All are re-exported from the package root and from the `@gravity-ui/aikit/hooks` subpath.
+
+| Hook                                                        | Purpose                                                      |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| [`useDateFormatter`](#usedateformatter)                     | Format chat timestamps with locale and relative-date logic   |
+| [`useToolMessage`](#usetoolmessage)                         | Tool-message state machine (expand/collapse based on status) |
+| [`useSmartScroll`](#usesmartscroll)                         | Auto-scroll to bottom while respecting user scroll-up        |
+| [`useScrollPreservation`](#usescrollpreservation)           | Preserve scroll position when items are prepended            |
+| [`useAutoCollapseOnSuccess`](#useautocollapseonsuccess)     | Collapse a section when its async operation succeeds         |
+| [`useAutoCollapseOnCancelled`](#useautocollapseoncancelled) | Collapse a section when its async operation is cancelled     |
+| [`useFileUploadStore`](#usefileuploadstore)                 | Standalone file-upload store with progress/error states      |
 
 ## `useDateFormatter`
 
@@ -130,32 +129,3 @@ type UseFileUploadStoreReturn<Meta> = {
 ```
 
 See `src/hooks/useFileUploadStore.ts` for the complete type signature.
-
-## `useToolset`
-
-Wires a `Toolset` into the chat: returns a `MessageRendererRegistry` whose `tool`
-dispatcher renders your tool components, and a `handleToolResult` callback that
-merges results into history via `applyToolResult` and forwards the updated
-transcript to `onAfterResult` (typical use: re-sending the conversation to the
-model). The callback is deferred to a microtask so it never fires inside a React
-reducer pass.
-
-```typescript
-function useToolset<TCustom extends TMessageContent = never>(
-  options: UseToolsetOptions<TCustom>,
-): UseToolsetReturn;
-
-type UseToolsetOptions<TCustom> = {
-  toolset: Toolset;
-  setMessages: Dispatch<SetStateAction<TChatMessage<TCustom>[]>>;
-  onAfterResult?: (messages: TChatMessage<TCustom>[]) => void;
-  registry?: MessageRendererRegistry;
-};
-
-type UseToolsetReturn = {
-  messageRendererRegistry: MessageRendererRegistry;
-  handleToolResult: (event: ToolsetResultEvent) => void;
-};
-```
-
-See [GENUI.md](./GENUI.md) for an end-to-end example with a live model adapter.

package/llms.txt

@@ -88,7 +88,6 @@ Tree-shaken imports: `@gravity-ui/aikit/PromptInput`, `/Header`, `/MessageList`,
 - [useAutoCollapseOnSuccess](https://github.com/gravity-ui/aikit/blob/main/src/hooks/useAutoCollapseOnSuccess.ts): auto-collapse a section on success status
 - [useAutoCollapseOnCancelled](https://github.com/gravity-ui/aikit/blob/main/src/hooks/useAutoCollapseOnCancelled.ts): auto-collapse a section on cancelled status
 - [useFileUploadStore](https://github.com/gravity-ui/aikit/blob/main/src/hooks/useFileUploadStore.ts): headless file-upload store with progress/error states
-- [useToolset](https://github.com/gravity-ui/aikit/blob/main/src/hooks/useToolset.ts): wire a toolset into the chat — renderer registry + history merge for tool calls
 
 ## Theming & i18n
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravity-ui/aikit",
-  "version": "2.2.1-beta.c34166a0895bc049a23b2ba68f233d0ea0e55a8b.0",
+  "version": "2.3.0",
   "description": "Gravity UI base kit for building ai assistant chats",
   "license": "MIT",
   "type": "commonjs",
@@ -98,16 +98,6 @@
         "default": "./build/cjs/utils/clipboardUtils.js"
       }
     },
-    "./utils/toolset": {
-      "import": {
-        "types": "./build/esm/utils/toolset/index.d.ts",
-        "default": "./build/esm/utils/toolset/index.js"
-      },
-      "require": {
-        "types": "./build/cjs/utils/toolset/index.d.ts",
-        "default": "./build/cjs/utils/toolset/index.js"
-      }
-    },
     "./adapters": {
       "import": {
         "types": "./build/esm/adapters/index.d.ts",

package/build/cjs/hooks/useToolset.d.ts

@@ -1,28 +0,0 @@
-import type { Dispatch, SetStateAction } from 'react';
-import type { TChatMessage, TMessageContent } from "../types/messages.js";
-import type { MessageRendererRegistry } from "../utils/messageTypeRegistry.js";
-import { type Toolset, type ToolsetResultEvent } from "../utils/toolset/index.js";
-export type UseToolsetOptions<TCustom extends TMessageContent = never> = {
-    toolset: Toolset;
-    setMessages: Dispatch<SetStateAction<TChatMessage<TCustom>[]>>;
-    /**
-     * Called after the tool result has been merged into history.
-     * Typical use: forward the updated transcript to the model.
-     */
-    onAfterResult?: (messages: TChatMessage<TCustom>[]) => void;
-    /** Existing registry to extend instead of starting from a fresh one. */
-    registry?: MessageRendererRegistry;
-};
-export type UseToolsetReturn = {
-    messageRendererRegistry: MessageRendererRegistry;
-    handleToolResult: (event: ToolsetResultEvent) => void;
-};
-/**
- * Wire a toolset into the chat: returns a `MessageRendererRegistry` that
- * renders tool parts via the toolset and a `handleToolResult` callback that
- * merges results into history and notifies via `onAfterResult`.
- *
- * Pass the same `toolset` reference across renders (e.g. via `useMemo` or
- * `createToolset`) so the registry stays stable.
- */
-export declare function useToolset<TCustom extends TMessageContent = never>(options: UseToolsetOptions<TCustom>): UseToolsetReturn;

package/build/cjs/hooks/useToolset.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useToolset = useToolset;
-const react_1 = require("react");
-const toolset_1 = require("../utils/toolset/index.js");
-/**
- * Wire a toolset into the chat: returns a `MessageRendererRegistry` that
- * renders tool parts via the toolset and a `handleToolResult` callback that
- * merges results into history and notifies via `onAfterResult`.
- *
- * Pass the same `toolset` reference across renders (e.g. via `useMemo` or
- * `createToolset`) so the registry stays stable.
- */
-function useToolset(options) {
-    const { toolset, setMessages, onAfterResult, registry } = options;
-    const onAfterResultRef = (0, react_1.useRef)(onAfterResult);
-    // Mirror the latest onAfterResult into a ref every render so the
-    // registry memo below doesn't need to depend on it (which would
-    // rebuild the registry on every parent rerender).
-    (0, react_1.useEffect)(() => {
-        onAfterResultRef.current = onAfterResult;
-    });
-    const handleToolResult = (0, react_1.useCallback)((event) => {
-        setMessages((prev) => {
-            const updated = (0, toolset_1.applyToolResult)(prev, event);
-            if (updated !== prev) {
-                // Defer to a microtask: never call onAfterResult while
-                // React is still inside the setState reducer. Re-entrant
-                // setState is illegal in concurrent mode.
-                queueMicrotask(() => { var _a; return (_a = onAfterResultRef.current) === null || _a === void 0 ? void 0 : _a.call(onAfterResultRef, updated); });
-            }
-            return updated;
-        });
-    }, [setMessages]);
-    const messageRendererRegistry = (0, react_1.useMemo)(() => (0, toolset_1.createToolsetRenderer)(toolset, {
-        onToolResult: handleToolResult,
-        registry,
-    }), [toolset, handleToolResult, registry]);
-    return { messageRendererRegistry, handleToolResult };
-}
-//# sourceMappingURL=useToolset.js.map

package/build/cjs/hooks/useToolset.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useToolset.js","sourceRoot":"../../../src","sources":["hooks/useToolset.ts"],"names":[],"mappings":";;AAqCA,gCAuCC;AA5ED,iCAA8D;AAK9D,uDAK0B;AAmB1B;;;;;;;GAOG;AACH,SAAgB,UAAU,CACtB,OAAmC;IAEnC,MAAM,EAAC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAC,GAAG,OAAO,CAAC;IAEhE,MAAM,gBAAgB,GAAG,IAAA,cAAM,EAAC,aAAa,CAAC,CAAC;IAC/C,iEAAiE;IACjE,gEAAgE;IAChE,kDAAkD;IAClD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACX,gBAAgB,CAAC,OAAO,GAAG,aAAa,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,IAAA,mBAAW,EAChC,CAAC,KAAyB,EAAE,EAAE;QAC1B,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE;YACjB,MAAM,OAAO,GAAG,IAAA,yBAAe,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC7C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACnB,uDAAuD;gBACvD,yDAAyD;gBACzD,0CAA0C;gBAC1C,cAAc,CAAC,GAAG,EAAE,WAAC,OAAA,MAAA,gBAAgB,CAAC,OAAO,iEAAG,OAAO,CAAC,CAAA,EAAA,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO,OAAO,CAAC;QACnB,CAAC,CAAC,CAAC;IACP,CAAC,EACD,CAAC,WAAW,CAAC,CAChB,CAAC;IAEF,MAAM,uBAAuB,GAAG,IAAA,eAAO,EACnC,GAAG,EAAE,CACD,IAAA,+BAAqB,EAAC,OAAO,EAAE;QAC3B,YAAY,EAAE,gBAAgB;QAC9B,QAAQ;KACX,CAAC,EACN,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CACxC,CAAC;IAEF,OAAO,EAAC,uBAAuB,EAAE,gBAAgB,EAAC,CAAC;AACvD,CAAC","sourcesContent":["import {useCallback, useEffect, useMemo, useRef} from 'react';\nimport type {Dispatch, SetStateAction} from 'react';\n\nimport type {TChatMessage, TMessageContent} from '../types/messages';\nimport type {MessageRendererRegistry} from '../utils/messageTypeRegistry';\nimport {\n    type Toolset,\n    type ToolsetResultEvent,\n    applyToolResult,\n    createToolsetRenderer,\n} from '../utils/toolset';\n\nexport type UseToolsetOptions<TCustom extends TMessageContent = never> = {\n    toolset: Toolset;\n    setMessages: Dispatch<SetStateAction<TChatMessage<TCustom>[]>>;\n    /**\n     * Called after the tool result has been merged into history.\n     * Typical use: forward the updated transcript to the model.\n     */\n    onAfterResult?: (messages: TChatMessage<TCustom>[]) => void;\n    /** Existing registry to extend instead of starting from a fresh one. */\n    registry?: MessageRendererRegistry;\n};\n\nexport type UseToolsetReturn = {\n    messageRendererRegistry: MessageRendererRegistry;\n    handleToolResult: (event: ToolsetResultEvent) => void;\n};\n\n/**\n * Wire a toolset into the chat: returns a `MessageRendererRegistry` that\n * renders tool parts via the toolset and a `handleToolResult` callback that\n * merges results into history and notifies via `onAfterResult`.\n *\n * Pass the same `toolset` reference across renders (e.g. via `useMemo` or\n * `createToolset`) so the registry stays stable.\n */\nexport function useToolset<TCustom extends TMessageContent = never>(\n    options: UseToolsetOptions<TCustom>,\n): UseToolsetReturn {\n    const {toolset, setMessages, onAfterResult, registry} = options;\n\n    const onAfterResultRef = useRef(onAfterResult);\n    // Mirror the latest onAfterResult into a ref every render so the\n    // registry memo below doesn't need to depend on it (which would\n    // rebuild the registry on every parent rerender).\n    useEffect(() => {\n        onAfterResultRef.current = onAfterResult;\n    });\n\n    const handleToolResult = useCallback(\n        (event: ToolsetResultEvent) => {\n            setMessages((prev) => {\n                const updated = applyToolResult(prev, event);\n                if (updated !== prev) {\n                    // Defer to a microtask: never call onAfterResult while\n                    // React is still inside the setState reducer. Re-entrant\n                    // setState is illegal in concurrent mode.\n                    queueMicrotask(() => onAfterResultRef.current?.(updated));\n                }\n                return updated;\n            });\n        },\n        [setMessages],\n    );\n\n    const messageRendererRegistry = useMemo(\n        () =>\n            createToolsetRenderer(toolset, {\n                onToolResult: handleToolResult,\n                registry,\n            }),\n        [toolset, handleToolResult, registry],\n    );\n\n    return {messageRendererRegistry, handleToolResult};\n}\n"]}

package/build/cjs/utils/toolset/i18n/en.json

@@ -1,3 +0,0 @@
-{
-  "fallback-unknown-tool": "Unknown tool: {{toolName}}"
-}

package/build/cjs/utils/toolset/i18n/index.d.ts

@@ -1,13 +0,0 @@
-export declare const i18n: ((key: "fallback-unknown-tool", params?: import("@gravity-ui/i18n").Params) => string) & {
-    Translation: import("react").ComponentType<{
-        children: (props: {
-            t: (key: "fallback-unknown-tool", params?: import("@gravity-ui/i18n").Params) => string;
-        }) => React.ReactNode;
-    }>;
-    useTranslation: () => {
-        t: (key: "fallback-unknown-tool", params?: import("@gravity-ui/i18n").Params) => string;
-    };
-    keysetData: {
-        "g-aikit-Toolset": Record<"fallback-unknown-tool", import("@gravity-ui/i18n").KeyData>;
-    };
-};

package/build/cjs/utils/toolset/i18n/index.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.i18n = void 0;
-const tslib_1 = require("tslib");
-const i18n_1 = require("@gravity-ui/uikit/i18n");
-const cn_1 = require("../../cn.js");
-const en_json_1 = tslib_1.__importDefault(require("./en.json"));
-const ru_json_1 = tslib_1.__importDefault(require("./ru.json"));
-exports.i18n = (0, i18n_1.addComponentKeysets)({ en: en_json_1.default, ru: ru_json_1.default }, `${cn_1.NAMESPACE}Toolset`);
-//# sourceMappingURL=index.js.map

package/build/cjs/utils/toolset/i18n/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"../../../../../src","sources":["utils/toolset/i18n/index.ts"],"names":[],"mappings":";;;;AAAA,iDAA2D;AAE3D,oCAAmC;AAEnC,gEAA2B;AAC3B,gEAA2B;AAEd,QAAA,IAAI,GAAG,IAAA,0BAAmB,EAAC,EAAC,EAAE,EAAF,iBAAE,EAAE,EAAE,EAAF,iBAAE,EAAC,EAAE,GAAG,cAAS,SAAS,CAAC,CAAC","sourcesContent":["import {addComponentKeysets} from '@gravity-ui/uikit/i18n';\n\nimport {NAMESPACE} from '../../cn';\n\nimport en from './en.json';\nimport ru from './ru.json';\n\nexport const i18n = addComponentKeysets({en, ru}, `${NAMESPACE}Toolset`);\n"]}

package/build/cjs/utils/toolset/i18n/ru.json

@@ -1,3 +0,0 @@
-{
-  "fallback-unknown-tool": "Неизвестный инструмент: {{toolName}}"
-}

package/build/cjs/utils/toolset/index.d.ts

@@ -1,142 +0,0 @@
-import type { ComponentType } from 'react';
-import type { TChatMessage, TMessageContent, ToolMessageContentData } from "../../types/messages.js";
-import { type MessageRendererRegistry } from "../messageTypeRegistry.js";
-export type ToolSchemaResult<TArgs> = {
-    success: true;
-    data: TArgs;
-} | {
-    success: false;
-    error: {
-        message: string;
-    };
-};
-export type ToolSchema<TArgs> = {
-    validate: (input: unknown) => ToolSchemaResult<TArgs>;
-};
-export type ToolComponentProps<TArgs, TResult> = {
-    args: TArgs;
-    result?: TResult;
-    submitResult: (result: TResult) => void;
-};
-export type ToolExecutionStatus = 'success' | 'error' | 'cancelled';
-/**
- * Discriminated outcome returned by a tool's `execute` callback.
- * A tool may also return a bare `TResult`; it is then treated as
- * `{status: 'success', result}` to keep simple cases boilerplate-free.
- */
-export type ToolExecutionOutcome<TResult> = {
-    status: 'success';
-    result: TResult;
-} | {
-    status: 'error';
-    result?: TResult;
-    error?: {
-        message: string;
-    };
-} | {
-    status: 'cancelled';
-    result?: TResult;
-};
-export type ToolDefinition<TArgs, TResult, TName extends string = string> = {
-    name: TName;
-    description: string;
-    parameters: Record<string, unknown>;
-    schema: ToolSchema<TArgs>;
-    component: ComponentType<ToolComponentProps<TArgs, TResult>>;
-    /**
-     * Run after the user submits a result inside the tool component.
-     * Return:
-     *  - `TResult` (or a Promise of one) for a successful execution;
-     *  - a `ToolExecutionOutcome<TResult>` to explicitly report `error`
-     *    or `cancelled`. A thrown error is surfaced as `{status: 'error'}`.
-     */
-    execute?: (params: {
-        args: TArgs;
-        result: TResult;
-        toolCallId: string;
-    }) => TResult | ToolExecutionOutcome<TResult> | Promise<TResult | ToolExecutionOutcome<TResult>>;
-};
-export type RuntimeToolDefinition<TName extends string = string> = {
-    name: TName;
-    description: string;
-    parameters: Record<string, unknown>;
-    validate: (input: unknown) => ToolSchemaResult<unknown>;
-    /**
-     * Rendered as `<Renderer ... />` JSX. Hooks placed at the top of this
-     * component work normally because it is a real React component, not a
-     * function called inside another render path.
-     */
-    Renderer: ComponentType<ToolComponentProps<unknown, unknown>>;
-    execute: (params: {
-        args: unknown;
-        result: unknown;
-        toolCallId: string;
-    }) => unknown | ToolExecutionOutcome<unknown> | Promise<unknown | ToolExecutionOutcome<unknown>>;
-};
-export type Toolset = Record<string, RuntimeToolDefinition>;
-export type ToolPartContentData<TArgs = unknown, TResult = unknown> = ToolMessageContentData & {
-    toolCallId: string;
-    args?: TArgs;
-    result?: TResult;
-};
-export type ToolPartContent<TArgs = unknown, TResult = unknown> = TMessageContent<'tool', ToolPartContentData<TArgs, TResult>>;
-export type ToolsetResultEvent = {
-    toolCallId: string;
-    toolName: string;
-    status: ToolExecutionStatus;
-    result: unknown;
-    error?: {
-        message: string;
-    };
-};
-/**
- * Wrap a typed tool definition into an erased runtime entry that the
- * toolset renderer can dispatch by `toolName`. The literal `name` is
- * preserved as a type parameter so `createToolset` can derive its keys.
- */
-export declare function defineTool<TArgs, TResult, const TName extends string>(definition: ToolDefinition<TArgs, TResult, TName>): RuntimeToolDefinition<TName>;
-/**
- * Build a `Toolset` from a list of `defineTool(...)` results. Keys are
- * derived from `definition.name`, so the call site cannot drift between
- * a literal-object key and the embedded `name`. The return type narrows
- * its keys to the union of literal tool names, giving name-autocomplete
- * on lookups. Throws on duplicates.
- */
-export declare function createToolset<const T extends readonly RuntimeToolDefinition<string>[]>(...tools: T): {
-    [K in T[number]['name']]: RuntimeToolDefinition<T[number]['name']>;
-};
-/**
- * Map a `Toolset` to the OpenAI `tools[]` shape so chat clients can pass
- * tool definitions to the model without reimplementing the conversion.
- */
-export declare function toolsetToOpenAIDefinitions(toolset: Toolset): Array<{
-    type: 'function';
-    function: {
-        name: string;
-        description: string;
-        parameters: Record<string, unknown>;
-    };
-}>;
-export type CreateToolsetRendererOptions = {
-    onToolResult: (event: ToolsetResultEvent) => void;
-    /**
-     * Existing registry whose entries should be preserved. A shallow copy
-     * is taken; the input reference is never mutated.
-     */
-    registry?: MessageRendererRegistry;
-};
-/**
- * Build a `MessageRendererRegistry` whose `tool` renderer dispatches
- * by `toolName` into the provided toolset. Unknown tools and invalid
- * args fall back to a generic `<ToolMessage status="error" />`. Errors
- * thrown inside `execute` are surfaced via an `error` outcome.
- */
-export declare function createToolsetRenderer(toolset: Toolset, options: CreateToolsetRendererOptions): MessageRendererRegistry;
-/**
- * Merge a tool result into the matching `tool` part of the chat history.
- * Honors `event.status` so the part reflects success / error / cancelled.
- * For backward compatibility, a missing `status` is treated as `'success'`.
- * Returns the original array reference when nothing matched, so React state
- * setters can skip needless updates.
- */
-export declare function applyToolResult<TCustom extends TMessageContent = never>(messages: TChatMessage<TCustom>[], event: ToolsetResultEvent): TChatMessage<TCustom>[];