@epam/ai-dial-chat-hooks 1.1.0-dev.253 → 1.1.0-dev.255

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-chat-hooks",
   "description": "Framework-level React hooks extracted from AI DIAL Chat for building custom chat interfaces",
-  "version": "1.1.0-dev.253",
+  "version": "1.1.0-dev.255",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -17,14 +17,14 @@
   },
   "peerDependencies": {
     "react": "^19.2.6",
-    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.253",
-    "@epam/ai-dial-attachment-input": "1.1.0-dev.253",
-    "@epam/ai-dial-chat-api-client": "1.1.0-dev.253",
-    "@epam/ai-dial-chat-shared": "1.1.0-dev.253",
-    "@epam/ai-dial-quotations": "1.1.0-dev.253",
+    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.255",
+    "@epam/ai-dial-attachment-input": "1.1.0-dev.255",
+    "@epam/ai-dial-chat-api-client": "1.1.0-dev.255",
+    "@epam/ai-dial-chat-shared": "1.1.0-dev.255",
+    "@epam/ai-dial-quotations": "1.1.0-dev.255",
     "@epam/ai-dial-react-file-manager": "*",
-    "@epam/ai-dial-share": "1.1.0-dev.253",
-    "@epam/ai-dial-source-panel": "1.1.0-dev.253",
+    "@epam/ai-dial-share": "1.1.0-dev.255",
+    "@epam/ai-dial-source-panel": "1.1.0-dev.255",
     "fflate": "^0.8.3"
   },
   "repository": {

package/useChatSettingsFormConfig/useChatSettingsFormConfig.d.ts

@@ -0,0 +1,128 @@
+import { ResponseFormat, Conversation, DeploymentFeatures } from '@epam/ai-dial-chat-shared';
+/** Values emitted by the chat-settings modal when the user clicks Save. */
+export interface ChatSettingsValues {
+    /** Updated response format, present when the response-format field was shown. */
+    responseFormat?: ResponseFormat;
+    /** Updated system prompt, present when the system-prompt field was shown. */
+    systemPrompt?: string;
+    /** Updated temperature, present when the temperature field was shown. */
+    temperature?: number;
+}
+/**
+ * Translatable strings the chat-settings form surfaces. Every field defaults
+ * to an English fallback inside the hook; pass translated values from the
+ * consuming app (e.g. via a `useTranslation`-backed labels hook).
+ */
+export interface ChatSettingsFormLabels {
+    /** Dropdown item label and modal title. */
+    settings: string;
+    /** Toast/message text announced after a successful save. */
+    savedNotification: string;
+    /** Label for the response-format field. */
+    responseFormatLabel: string;
+    /** Helper text shown below the response-format field. */
+    responseFormatHint: string;
+    /** Label for the Markdown radio option. */
+    responseFormatMarkdown: string;
+    /** Label for the plain-text radio option. */
+    responseFormatPlainText: string;
+    /** Label for the system-prompt field. */
+    systemPromptLabel: string;
+    /** Tooltip for the system-prompt field. */
+    systemPromptTooltip: string;
+    /** Label for the temperature field. */
+    temperatureLabel: string;
+    /** Label for the precise end of the temperature slider. */
+    temperaturePrecise: string;
+    /** Label for the neutral midpoint of the temperature slider. */
+    temperatureNeutral: string;
+    /** Label for the creative end of the temperature slider. */
+    temperatureCreative: string;
+    /** Hint text shown below the temperature field. */
+    temperatureHint: string;
+    /** Save button label. */
+    saveLabel: string;
+    /** Tooltip shown on the disabled Save button. */
+    saveDisabledTooltip: string;
+}
+/** Configuration the chat-settings popover/modal consumes. */
+export type UseChatSettingsFormConfigResult = {
+    /** Feature flags controlling which fields appear. */
+    features: {
+        systemPrompt: boolean;
+        temperature: boolean;
+        responseFormat: boolean;
+    };
+    /** Current response format pre-selected in the modal. */
+    responseFormat: ResponseFormat;
+    /** Current system prompt pre-populated in the modal. */
+    systemPrompt: string;
+    /** Current temperature pre-populated in the modal. */
+    temperature: number;
+    /** Called with updated values when the user clicks Save. */
+    onSave: (values: ChatSettingsValues) => void;
+    /** Label for the dropdown menu item. */
+    menuItemLabel: string;
+    /** Modal title. */
+    title: string;
+    /** Label for the response-format field. */
+    responseFormatLabel: string;
+    /** Helper text shown below the response-format field. */
+    responseFormatHint: string;
+    /** Label for the Markdown radio option. */
+    responseFormatMarkdownLabel: string;
+    /** Label for the plain-text radio option. */
+    responseFormatPlainTextLabel: string;
+    /** Label for the system-prompt field. */
+    systemPromptLabel: string;
+    /** Tooltip for the system-prompt field. */
+    systemPromptTooltip: string;
+    /** Label for the temperature field. */
+    temperatureLabel: string;
+    /** Slider endpoint labels, in `[precise, neutral, creative]` order. */
+    temperatureLabels: [string, string, string];
+    /** Hint text shown below the temperature field. */
+    temperatureHint: string;
+    /** Save button label. */
+    saveLabel: string;
+    /** Tooltip shown on the disabled Save button. */
+    saveDisabledTooltip: string;
+};
+interface LocalModeValues {
+    responseFormat: ResponseFormat;
+    systemPrompt: string;
+    temperature: number;
+}
+interface LocalModeParams {
+    mode: 'local';
+    values: LocalModeValues;
+    onValuesChange: (values: LocalModeValues) => void;
+    deploymentFeatures?: DeploymentFeatures;
+    /** True when the selected deployment is a Quick App. Its orchestrator sets its own fixed temperature, so the temperature field is forced off regardless of `deploymentFeatures`. */
+    isQuickApp?: boolean;
+}
+interface ConversationModeParams {
+    mode: 'conversation';
+    conversation: Conversation;
+    onConversationChange: (conversation: Conversation) => void;
+    deploymentFeatures?: DeploymentFeatures;
+    /** True when the conversation's deployment is a Quick App. Its orchestrator sets its own fixed temperature, so the temperature field is forced off regardless of `deploymentFeatures`. */
+    isQuickApp?: boolean;
+}
+type Params = LocalModeParams | ConversationModeParams;
+/** Common, host-injected options shared by both modes. */
+interface Options {
+    /** Translatable labels. Fields not provided fall back to English defaults. */
+    labels?: Partial<ChatSettingsFormLabels>;
+    /** Called after a successful save so the host can surface its own toast/notification. */
+    onSaved?: () => void;
+}
+/**
+ * Assembles the chat-settings form config (feature flags, current values, save
+ * handler, labels) for either an in-flight local composer or a persisted
+ * conversation. Headless: translation and notifications are the host's
+ * responsibility, supplied via `labels` and `onSaved`.
+ */
+export declare const useChatSettingsFormConfig: (params: Params & Options) => UseChatSettingsFormConfigResult;
+export {};
+//# sourceMappingURL=useChatSettingsFormConfig.d.ts.map

package/useChatSettingsFormConfig/useChatSettingsFormConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatSettingsFormConfig.d.ts","sourceRoot":"","sources":["../../src/useChatSettingsFormConfig/useChatSettingsFormConfig.ts"],"names":[],"mappings":"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"}