@epam/ai-dial-chat-shared 1.2.0-dev.112 → 1.2.0-dev.115

package/hooks/useTextRefinement.js

@@ -0,0 +1,66 @@
+import { useCallback as e, useLayoutEffect as t, useRef as n, useState as r } from "react";
+//#region src/hooks/useTextRefinement.ts
+var i = /* @__PURE__ */ function(e) {
+	return e.Idle = "idle", e.Pending = "pending", e.Success = "success", e.Error = "error", e.Restored = "restored", e.Unchanged = "unchanged", e;
+}({}), a = (i) => {
+	let [a, o] = r("idle"), [s, c] = r(!1), l = n(i), u = n(!1), d = n({
+		value: i.value,
+		resetKey: i.resetKey,
+		generation: 0,
+		controller: void 0,
+		baseline: void 0,
+		expected: void 0
+	}), f = e(() => {
+		let e = d.current;
+		e.generation++, e.controller?.abort(), e.controller = void 0, e.baseline = void 0, e.expected = void 0;
+	}, []), p = e(() => {
+		f(), u.current && (o("idle"), c(!1));
+	}, [f]);
+	t(() => (u.current = !0, () => {
+		u.current = !1, f();
+	}), [f]), t(() => {
+		let e = l.current, t = d.current;
+		l.current = i;
+		let n = t.value !== i.value, r = n && t.expected === i.value;
+		t.resetKey !== i.resetKey || e.onRefine && !i.onRefine || !e.disabled && i.disabled || n && !r ? p() : r && (t.expected = void 0), t.value = i.value, t.resetKey = i.resetKey;
+	});
+	let m = e(async () => {
+		let e = l.current, t = d.current;
+		if (!u.current || !e.onRefine || e.disabled || !e.value.trim() || t.controller || t.expected !== void 0) return;
+		let n = new AbortController();
+		t.controller = n;
+		let r = ++t.generation, i = e.value, a = () => u.current && r === t.generation && !n.signal.aborted && l.current.value === i;
+		o("pending");
+		try {
+			let r = await e.onRefine(i, n.signal);
+			if (!a()) return;
+			if (typeof r != "string" || !r.trim()) throw Error("Empty refinement");
+			if (r === i) {
+				o("unchanged");
+				return;
+			}
+			t.baseline ??= i, t.expected = r, c(!0), o("success"), l.current.onChange(r);
+		} catch (e) {
+			if (!a()) return;
+			typeof e == "object" && e && "name" in e && e.name === "AbortError" ? o("idle") : o("error");
+		} finally {
+			r === t.generation && (t.controller = void 0);
+		}
+	}, []), h = e(() => {
+		let e = d.current;
+		if (!u.current || l.current.disabled || e.controller || e.baseline === void 0) return;
+		let t = e.baseline;
+		e.baseline = void 0, e.expected = t, c(!1), o("restored"), l.current.onChange(t);
+	}, []);
+	return {
+		state: a,
+		isPending: a === "pending",
+		canRefine: !!(i.onRefine && !i.disabled && i.value.trim() && a !== "pending"),
+		canUndo: s,
+		refine: m,
+		undo: h,
+		reset: p
+	};
+};
+//#endregion
+export { i as TextRefinementState, a as useTextRefinement };

package/index.d.ts

@@ -2416,6 +2416,37 @@ export declare interface TextCharacterRangeSelector {
     end: number;
 }
 
+/** Asynchronous rewriting callback supplied by the consuming host. */
+export declare type TextRefinementCallback = (value: string, signal: AbortSignal) => Promise<string>;
+
+/** Controls and feedback for a single field. */
+export declare interface TextRefinementResult {
+    /** Current field-local feedback state. */
+    state: TextRefinementState;
+    /** Whether this field has a request in progress. */
+    isPending: boolean;
+    /** Whether the current value can be refined. */
+    canRefine: boolean;
+    /** Whether an original baseline can be restored. */
+    canUndo: boolean;
+    /** Refines the latest committed value; duplicate activation is ignored. */
+    refine: () => Promise<void>;
+    /** Restores the baseline from before the first successful refinement. */
+    undo: () => void;
+    /** Cancels work and clears feedback and Undo without modifying the value. */
+    reset: () => void;
+}
+
+/** Field-local refinement feedback state. */
+export declare enum TextRefinementState {
+    Idle = "idle",
+    Pending = "pending",
+    Success = "success",
+    Error = "error",
+    Restored = "restored",
+    Unchanged = "unchanged"
+}
+
 /** A single selectable UI theme. */
 export declare interface Theme {
     /** Unique theme identifier (e.g. `'dark'`, `'light'`). */
@@ -2653,4 +2684,21 @@ export declare interface UserProfile {
     isAdmin: boolean;
 }
 
+/** Preserves an author's draft and Undo baseline across asynchronous controlled updates. */
+export declare const useTextRefinement: (options: UseTextRefinementOptions) => TextRefinementResult;
+
+/** Controlled value and lifecycle inputs for one refinable field. */
+export declare interface UseTextRefinementOptions {
+    /** Current controlled field value. */
+    value: string;
+    /** Host rewriting callback. Omission disables refinement and clears its state. */
+    onRefine?: TextRefinementCallback;
+    /** Publishes a successful result or the original Undo baseline. */
+    onChange: (value: string) => void;
+    /** Disables refinement and cancels active work when true. Defaults to false. */
+    disabled?: boolean;
+    /** Draft identity; changing it resets state even when text is equal. */
+    resetKey?: unknown;
+}
+
 export { }

package/index.js

@@ -56,11 +56,12 @@ import { MarkdownWithPlaceholders as et } from "./components/MarkdownWithPlaceho
 import { useCollapsedText as tt } from "./hooks/useCollapsedText.js";
 import { useAvailableHeightCap as nt } from "./hooks/useAvailableHeightCap.js";
 import { useIsMobile as rt } from "./hooks/useIsMobile.js";
-import { DialFileManagerActionProfile as it, DialFileManagerVariant as at } from "./file-manager/file-manager-variant.js";
-import { getParentFolderPath as ot, isHiddenPath as st } from "./file-manager/path.js";
-import { FileUploadStatus as ct } from "./file-manager/upload-batch.js";
-import { useGridEditingScroll as lt } from "./file-manager/useGridEditingScroll/useGridEditingScroll.js";
-import { OperationLoaderModal as ut } from "./file-manager/OperationLoaderModal/OperationLoaderModal.js";
-import { UploadProgressModal as dt } from "./file-manager/UploadProgressModal/UploadProgressModal.js";
-import { isSkillSelectionUnsupported as ft } from "./utils/is-skill-selection-unsupported.js";
-export { f as AttachmentErrorReason, p as AttachmentType, fe as BASE_LG_ICON_PROPS, pe as BASE_MD_ICON_PROPS, ze as CHAT_SHARED_CLASS, Xe as COMPACT_MARKDOWN_CLASS_NAMES, m as CatalogEntityType, _ as CodeBlockTheme, e as ConversationTransferErrorCode, t as ConversationTransferJobStatus, n as ConversationTransferSubjectKind, r as ConversationTransferUnitKind, i as ConversationTransferWarningCode, Ae as CopyButton, je as CopyIconButton, Ze as DEFAULT_MARKDOWN_CLASS_NAMES, Ue as DEFAULT_MARKDOWN_TABLE_DOWNLOAD_FILENAME, Se as DESKTOP_BREAKPOINT_PX, Ce as DESKTOP_MEDIA_QUERY, ke as DeploymentIcon, it as DialFileManagerActionProfile, at as DialFileManagerVariant, ne as ENTITY_TYPE_BG_COLOR, re as ENTITY_TYPE_COLOR, Ie as EntityHeader, Pe as EntityTypeLabel, Fe as FeaturedChip, h as FileExtension, ct as FileUploadStatus, a as FilterTab, me as HIDDEN_FILE, Oe as InitialsAvatar, Ne as ItemHeader, ge as MARKDOWN_EDITOR_MAX_HEIGHT_CLASS_NAME, ye as MARKDOWN_EDITOR_PREVIEW_LIST_CLASS_NAME, We as MARKDOWN_TABLE_CSV_MIME_TYPE, $e as MDMessageViewer, g as MIMEType, v as MIME_TYPE_ALIASES, y as MIME_TYPE_AUDIO_PREFIX, b as MIME_TYPE_EXT_MAP, x as MIME_TYPE_WILDCARD, we as MOBILE_MAX_WIDTH_PX, Te as MOBILE_MEDIA_QUERY, He as MarkdownCodeBlock, Je as MarkdownRenderer, qe as MarkdownTable, Ge as MarkdownTableCopyFormat, et as MarkdownWithPlaceholders, o as MessageRating, s as MessageRole, ut as OperationLoaderModal, A as PROHIBITED_CONVERSATION_NAME_CHARS_RE, ie as PROMPT_PARAM_DEFAULT_SEPARATOR, ae as PROMPT_PARAM_PATTERN, oe as PROMPT_VARIABLE_CLASS_NAME, Me as PanelEmptyState, Qe as PlainTextRenderer, _e as RESIZABLE_FIELD_MAX_HEIGHT_CSS_VARIABLE, ve as RESIZABLE_TEXTAREA_CLASS_NAME, c as RequestStatus, Le as ResourceSummary, d as ResponseFormat, be as SELECT_LIST_MAX_HEIGHT_CLASS_NAME, xe as SELECT_LIST_MAX_HEIGHT_PX, l as StageStatus, u as StatusEvent, he as TAG_INPUT_TAG_CLASS_NAME, Re as TableHeader, dt as UploadProgressModal, Y as base64ToBlob, I as buildCssVars, se as buildPromptParamDefaults, V as copyMarkdownAsRichText, H as copyToClipboard, Ye as defaultMarkdownComponents, X as downloadTextFile, Z as ensureDownloadFilename, De as extractInitials, ce as extractPromptParams, K as formatCost, G as formatFileSize, W as formatLastUsed, q as formatPrice, J as formatUnitPrice, de as generateUUID, S as getAttachmentTypeFromMime, C as getBaseMimeType, Q as getFileExtensionForLanguage, ot as getParentFolderPath, j as getUtf8ByteLength, w as inferMimeTypeFromPath, D as isAnnotationSelector, B as isAudioTranscriptionSupported, st as isHiddenPath, ft as isSkillSelectionUnsupported, L as isStatusMessage, U as markdownToRichTextHtml, F as mergeClasses, R as messageAttachmentToDisplayAttachment, z as messageAttachmentsToDisplayAttachments, T as normalizeMimeType, O as normalizePersistedHtmlTagAttachmentType, k as normalizeRawAnnotations, Ee as pickAvatarColor, le as rehypePromptVariables, ue as resolvePromptParams, Ve as restrainedSyntaxTheme, M as sanitizeConversationName, Ke as serializeMarkdownTableRows, N as stripTrailingDots, E as stripUrlQueryAndFragment, $ as triggerAnchorDownload, ee as triggerBlobDownload, P as truncateToUtf8Bytes, te as tryBase64ToBytes, nt as useAvailableHeightCap, Be as useCodeCopy, tt as useCollapsedText, lt as useGridEditingScroll, rt as useIsMobile };
+import { TextRefinementState as it, useTextRefinement as at } from "./hooks/useTextRefinement.js";
+import { DialFileManagerActionProfile as ot, DialFileManagerVariant as st } from "./file-manager/file-manager-variant.js";
+import { getParentFolderPath as ct, isHiddenPath as lt } from "./file-manager/path.js";
+import { FileUploadStatus as ut } from "./file-manager/upload-batch.js";
+import { useGridEditingScroll as dt } from "./file-manager/useGridEditingScroll/useGridEditingScroll.js";
+import { OperationLoaderModal as ft } from "./file-manager/OperationLoaderModal/OperationLoaderModal.js";
+import { UploadProgressModal as pt } from "./file-manager/UploadProgressModal/UploadProgressModal.js";
+import { isSkillSelectionUnsupported as mt } from "./utils/is-skill-selection-unsupported.js";
+export { f as AttachmentErrorReason, p as AttachmentType, fe as BASE_LG_ICON_PROPS, pe as BASE_MD_ICON_PROPS, ze as CHAT_SHARED_CLASS, Xe as COMPACT_MARKDOWN_CLASS_NAMES, m as CatalogEntityType, _ as CodeBlockTheme, e as ConversationTransferErrorCode, t as ConversationTransferJobStatus, n as ConversationTransferSubjectKind, r as ConversationTransferUnitKind, i as ConversationTransferWarningCode, Ae as CopyButton, je as CopyIconButton, Ze as DEFAULT_MARKDOWN_CLASS_NAMES, Ue as DEFAULT_MARKDOWN_TABLE_DOWNLOAD_FILENAME, Se as DESKTOP_BREAKPOINT_PX, Ce as DESKTOP_MEDIA_QUERY, ke as DeploymentIcon, ot as DialFileManagerActionProfile, st as DialFileManagerVariant, ne as ENTITY_TYPE_BG_COLOR, re as ENTITY_TYPE_COLOR, Ie as EntityHeader, Pe as EntityTypeLabel, Fe as FeaturedChip, h as FileExtension, ut as FileUploadStatus, a as FilterTab, me as HIDDEN_FILE, Oe as InitialsAvatar, Ne as ItemHeader, ge as MARKDOWN_EDITOR_MAX_HEIGHT_CLASS_NAME, ye as MARKDOWN_EDITOR_PREVIEW_LIST_CLASS_NAME, We as MARKDOWN_TABLE_CSV_MIME_TYPE, $e as MDMessageViewer, g as MIMEType, v as MIME_TYPE_ALIASES, y as MIME_TYPE_AUDIO_PREFIX, b as MIME_TYPE_EXT_MAP, x as MIME_TYPE_WILDCARD, we as MOBILE_MAX_WIDTH_PX, Te as MOBILE_MEDIA_QUERY, He as MarkdownCodeBlock, Je as MarkdownRenderer, qe as MarkdownTable, Ge as MarkdownTableCopyFormat, et as MarkdownWithPlaceholders, o as MessageRating, s as MessageRole, ft as OperationLoaderModal, A as PROHIBITED_CONVERSATION_NAME_CHARS_RE, ie as PROMPT_PARAM_DEFAULT_SEPARATOR, ae as PROMPT_PARAM_PATTERN, oe as PROMPT_VARIABLE_CLASS_NAME, Me as PanelEmptyState, Qe as PlainTextRenderer, _e as RESIZABLE_FIELD_MAX_HEIGHT_CSS_VARIABLE, ve as RESIZABLE_TEXTAREA_CLASS_NAME, c as RequestStatus, Le as ResourceSummary, d as ResponseFormat, be as SELECT_LIST_MAX_HEIGHT_CLASS_NAME, xe as SELECT_LIST_MAX_HEIGHT_PX, l as StageStatus, u as StatusEvent, he as TAG_INPUT_TAG_CLASS_NAME, Re as TableHeader, it as TextRefinementState, pt as UploadProgressModal, Y as base64ToBlob, I as buildCssVars, se as buildPromptParamDefaults, V as copyMarkdownAsRichText, H as copyToClipboard, Ye as defaultMarkdownComponents, X as downloadTextFile, Z as ensureDownloadFilename, De as extractInitials, ce as extractPromptParams, K as formatCost, G as formatFileSize, W as formatLastUsed, q as formatPrice, J as formatUnitPrice, de as generateUUID, S as getAttachmentTypeFromMime, C as getBaseMimeType, Q as getFileExtensionForLanguage, ct as getParentFolderPath, j as getUtf8ByteLength, w as inferMimeTypeFromPath, D as isAnnotationSelector, B as isAudioTranscriptionSupported, lt as isHiddenPath, mt as isSkillSelectionUnsupported, L as isStatusMessage, U as markdownToRichTextHtml, F as mergeClasses, R as messageAttachmentToDisplayAttachment, z as messageAttachmentsToDisplayAttachments, T as normalizeMimeType, O as normalizePersistedHtmlTagAttachmentType, k as normalizeRawAnnotations, Ee as pickAvatarColor, le as rehypePromptVariables, ue as resolvePromptParams, Ve as restrainedSyntaxTheme, M as sanitizeConversationName, Ke as serializeMarkdownTableRows, N as stripTrailingDots, E as stripUrlQueryAndFragment, $ as triggerAnchorDownload, ee as triggerBlobDownload, P as truncateToUtf8Bytes, te as tryBase64ToBytes, nt as useAvailableHeightCap, Be as useCodeCopy, tt as useCollapsedText, dt as useGridEditingScroll, rt as useIsMobile, at as useTextRefinement };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-chat-shared",
   "description": "Shared domain models, utilities, and UI components for AI DIAL Chat libraries",
-  "version": "1.2.0-dev.112",
+  "version": "1.2.0-dev.115",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": [