@epam/ai-dial-chat-shared 1.3.0-dev.34 → 1.3.0-dev.37

package/hooks/useTextRefinement.d.ts

@@ -0,0 +1,44 @@
+/** Asynchronous rewriting callback supplied by the consuming host. */
+export type TextRefinementCallback = (value: string, signal: AbortSignal) => Promise<string>;
+/** Field-local refinement feedback state. */
+export declare enum TextRefinementState {
+    Idle = "idle",
+    Pending = "pending",
+    Success = "success",
+    Error = "error",
+    Restored = "restored",
+    Unchanged = "unchanged"
+}
+/** Controlled value and lifecycle inputs for one refinable field. */
+export 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;
+}
+/** Controls and feedback for a single field. */
+export 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;
+}
+/** Preserves an author's draft and Undo baseline across asynchronous controlled updates. */
+export declare const useTextRefinement: (options: UseTextRefinementOptions) => TextRefinementResult;
+//# sourceMappingURL=useTextRefinement.d.ts.map

package/hooks/useTextRefinement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTextRefinement.d.ts","sourceRoot":"","sources":["../../src/hooks/useTextRefinement.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,MAAM,MAAM,sBAAsB,GAAG,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,6CAA6C;AAC7C,oBAAY,mBAAmB;IAC7B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAED,qEAAqE;AACrE,MAAM,WAAW,wBAAwB;IACvC,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,mEAAmE;IACnE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,KAAK,EAAE,mBAAmB,CAAC;IAC3B,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,yEAAyE;IACzE,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB,GAC5B,SAAS,wBAAwB,KAChC,oBA+IF,CAAC"}

package/hooks/useUnsavedChangesGuard.d.ts

@@ -0,0 +1,14 @@
+/** Result of {@link useUnsavedChangesGuard}. */
+export interface UnsavedChangesGuardResult {
+    /** Runs `action` immediately when nothing is dirty; otherwise defers it and opens the confirmation. */
+    guard: (action: () => void) => void;
+    /** Whether the discard confirmation should be shown. */
+    isConfirmOpen: boolean;
+    /** Closes the confirmation and runs the deferred action. */
+    confirm: () => void;
+    /** Closes the confirmation and drops the deferred action. */
+    dismiss: () => void;
+}
+/** Defers leaving a form with unsaved changes until the user confirms, and asks the browser to warn before the page unloads. */
+export declare const useUnsavedChangesGuard: (isDirty: boolean) => UnsavedChangesGuardResult;
+//# sourceMappingURL=useUnsavedChangesGuard.d.ts.map

package/hooks/useUnsavedChangesGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUnsavedChangesGuard.d.ts","sourceRoot":"","sources":["../../src/hooks/useUnsavedChangesGuard.ts"],"names":[],"mappings":"AAEA,gDAAgD;AAChD,MAAM,WAAW,yBAAyB;IACxC,uGAAuG;IACvG,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpC,wDAAwD;IACxD,aAAa,EAAE,OAAO,CAAC;IACvB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,gIAAgI;AAChI,eAAO,MAAM,sBAAsB,GACjC,SAAS,OAAO,KACf,yBAsCF,CAAC"}