@bikdotai/bik-component-library 0.0.777-beta.22 → 0.0.777-beta.24

package/dist/cjs/components/WhatsAppTextEditor/WhatsAppTextEditor.d.ts

@@ -71,9 +71,10 @@ export type CustomEditorProps = React.TextareaHTMLAttributes<HTMLTextAreaElement
     instructionSuggestions?: string[];
     onAnalyticsEvent?: (name: AIEventName, payload: AIEventPayload) => void;
     /**
-     * Fires when the user **Accepts** an AI suggestion. Persist `payload.isAiTagged` (or the
-     * full payload) in host state and send on template save — the editor ref `get()` only
-     * returns body text. See `MERCHANT_ADMIN_REACT_INTEGRATION.md` (AI tag section).
+     * Fires on AI-tag computations:
+     * - `source: "accept"` after accepting a suggestion (addition check: >=50% => true)
+     * - `source: "post_edit_debounce"` after edit idle/blur (retention check: <50% => true)
+     * Persist `payload.isAiTagged` (or full payload) in host state and send on save.
      */
     onAITagComputed?: (payload: AITagPayload) => void;
     /**
@@ -139,9 +140,10 @@ export declare const WhatsAppTextEditor: React.ForwardRefExoticComponent<React.T
     instructionSuggestions?: string[] | undefined;
     onAnalyticsEvent?: ((name: AIEventName, payload: AIEventPayload) => void) | undefined;
     /**
-     * Fires when the user **Accepts** an AI suggestion. Persist `payload.isAiTagged` (or the
-     * full payload) in host state and send on template save — the editor ref `get()` only
-     * returns body text. See `MERCHANT_ADMIN_REACT_INTEGRATION.md` (AI tag section).
+     * Fires on AI-tag computations:
+     * - `source: "accept"` after accepting a suggestion (addition check: >=50% => true)
+     * - `source: "post_edit_debounce"` after edit idle/blur (retention check: <50% => true)
+     * Persist `payload.isAiTagged` (or full payload) in host state and send on save.
      */
     onAITagComputed?: ((payload: AITagPayload) => void) | undefined;
     /**

package/dist/cjs/components/WhatsAppTextEditor/ai/aiTag.d.ts

@@ -1,18 +1,23 @@
 /**
- * AI template tag: show only when the edit distance between what the user had
- * (baseline) and what they accepted is at least half of the longer of the two strings.
+ * AI tag math shared by accept and post-edit flows.
  *
- * **Wiring:** `WhatsAppTextEditor` calls `onAITagComputed` with this result when the user
- * Accepts a suggestion — the editor does not return the tag from `ref.get()`. Host apps
- * should store `isAiTagged` (and optional full payload) in their own state and send it on
- * save. See `MERCHANT_ADMIN_REACT_INTEGRATION.md` → “AI tag — where it comes from…”.
+ * `changePercent` is always computed as:
+ *   levenshteinDistance(aiBaseline, currentText) / max(len(aiBaseline), len(currentText), 1)
+ *
+ * `isAiTagged` interpretation is source-specific:
+ * - `accept`: addition check (`>= 50%` => true)
+ * - `post_edit_debounce`: retention check (`< 50%` => true)
  */
 export declare const AI_TAG_CHANGE_RATIO_THRESHOLD = 0.5;
 export type AITagPayload = {
     changedCharacters: number;
     templateLength: number;
     changePercent: number;
-    /** True when changedCharacters / templateLength >= {@link AI_TAG_CHANGE_RATIO_THRESHOLD} */
+    /**
+     * Interpretation depends on source:
+     * - `accept`: true when changedCharacters / templateLength >= threshold.
+     * - `post_edit_debounce`: true when changedCharacters / templateLength < threshold.
+     */
     isAiTagged: boolean;
     /**
      * True when this accept occurred during the “initial AI prefill” phase: the host
@@ -51,8 +56,8 @@ export declare function levenshteinDistance(a: string, b: string): number;
  */
 export declare function computeAiTagOnAccept(input: ComputeAiTagOnAcceptInput): AITagPayload;
 /**
- * Computes AI tag after user edits an accepted AI suggestion.
- * For post-edit flow, we still apply the same tag rule:
- * changedCharacters / templateLength >= AI_TAG_CHANGE_RATIO_THRESHOLD => AI-tagged.
+ * Computes AI tag after user edits AI-derived text.
+ * Post-edit is a retention check: if drift from AI baseline reaches >= 50%,
+ * the text is treated as no longer AI-tagged.
  */
 export declare function computeAiTagOnPostEdit(input: ComputeAiTagOnPostEditInput): AITagPayload;

package/dist/cjs/components/WhatsAppTextEditor/ai/aiTag.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});function e(e,t){const n=e.length,i=t.length,a=Array(i+1).fill(0).map(((e,t)=>t));for(let r=1;r<=n;r++){let n=a[0];a[0]=r;for(let c=1;c<=i;c++){const i=a[c];e[r-1]===t[c-1]?a[c]=n:a[c]=Math.min(a[c-1],a[c],n)+1,n=i}}return a[i]}exports.AI_TAG_CHANGE_RATIO_THRESHOLD=.5,exports.computeAiTagOnAccept=function(t){const{baselineText:n,acceptedText:i,initialAiPrefillPhase:a}=t,r=e(n,i),c=Math.max(n.length,i.length,1),l=r/c;return{changedCharacters:r,templateLength:c,changePercent:l,isAiTagged:l>=.5,initialAiPrefillPhase:a}},exports.computeAiTagOnPostEdit=function(t){const{acceptedAiText:n,currentEditedText:i}=t,a=e(n,i),r=Math.max(n.length,i.length,1),c=a/r;return{changedCharacters:a,templateLength:r,changePercent:c,isAiTagged:c>=.5,initialAiPrefillPhase:!1}},exports.levenshteinDistance=e;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});function e(e,t){const n=e.length,i=t.length,a=Array(i+1).fill(0).map(((e,t)=>t));for(let r=1;r<=n;r++){let n=a[0];a[0]=r;for(let c=1;c<=i;c++){const i=a[c];e[r-1]===t[c-1]?a[c]=n:a[c]=Math.min(a[c-1],a[c],n)+1,n=i}}return a[i]}exports.AI_TAG_CHANGE_RATIO_THRESHOLD=.5,exports.computeAiTagOnAccept=function(t){const{baselineText:n,acceptedText:i,initialAiPrefillPhase:a}=t,r=e(n,i),c=Math.max(n.length,i.length,1),l=r/c;return{changedCharacters:r,templateLength:c,changePercent:l,isAiTagged:l>=.5,initialAiPrefillPhase:a}},exports.computeAiTagOnPostEdit=function(t){const{acceptedAiText:n,currentEditedText:i}=t,a=e(n,i),r=Math.max(n.length,i.length,1),c=a/r;return{changedCharacters:a,templateLength:r,changePercent:c,isAiTagged:c<.5,initialAiPrefillPhase:!1}},exports.levenshteinDistance=e;

package/dist/esm/components/WhatsAppTextEditor/WhatsAppTextEditor.d.ts

@@ -71,9 +71,10 @@ export type CustomEditorProps = React.TextareaHTMLAttributes<HTMLTextAreaElement
     instructionSuggestions?: string[];
     onAnalyticsEvent?: (name: AIEventName, payload: AIEventPayload) => void;
     /**
-     * Fires when the user **Accepts** an AI suggestion. Persist `payload.isAiTagged` (or the
-     * full payload) in host state and send on template save — the editor ref `get()` only
-     * returns body text. See `MERCHANT_ADMIN_REACT_INTEGRATION.md` (AI tag section).
+     * Fires on AI-tag computations:
+     * - `source: "accept"` after accepting a suggestion (addition check: >=50% => true)
+     * - `source: "post_edit_debounce"` after edit idle/blur (retention check: <50% => true)
+     * Persist `payload.isAiTagged` (or full payload) in host state and send on save.
      */
     onAITagComputed?: (payload: AITagPayload) => void;
     /**
@@ -139,9 +140,10 @@ export declare const WhatsAppTextEditor: React.ForwardRefExoticComponent<React.T
     instructionSuggestions?: string[] | undefined;
     onAnalyticsEvent?: ((name: AIEventName, payload: AIEventPayload) => void) | undefined;
     /**
-     * Fires when the user **Accepts** an AI suggestion. Persist `payload.isAiTagged` (or the
-     * full payload) in host state and send on template save — the editor ref `get()` only
-     * returns body text. See `MERCHANT_ADMIN_REACT_INTEGRATION.md` (AI tag section).
+     * Fires on AI-tag computations:
+     * - `source: "accept"` after accepting a suggestion (addition check: >=50% => true)
+     * - `source: "post_edit_debounce"` after edit idle/blur (retention check: <50% => true)
+     * Persist `payload.isAiTagged` (or full payload) in host state and send on save.
      */
     onAITagComputed?: ((payload: AITagPayload) => void) | undefined;
     /**

package/dist/esm/components/WhatsAppTextEditor/ai/aiTag.d.ts

@@ -1,18 +1,23 @@
 /**
- * AI template tag: show only when the edit distance between what the user had
- * (baseline) and what they accepted is at least half of the longer of the two strings.
+ * AI tag math shared by accept and post-edit flows.
  *
- * **Wiring:** `WhatsAppTextEditor` calls `onAITagComputed` with this result when the user
- * Accepts a suggestion — the editor does not return the tag from `ref.get()`. Host apps
- * should store `isAiTagged` (and optional full payload) in their own state and send it on
- * save. See `MERCHANT_ADMIN_REACT_INTEGRATION.md` → “AI tag — where it comes from…”.
+ * `changePercent` is always computed as:
+ *   levenshteinDistance(aiBaseline, currentText) / max(len(aiBaseline), len(currentText), 1)
+ *
+ * `isAiTagged` interpretation is source-specific:
+ * - `accept`: addition check (`>= 50%` => true)
+ * - `post_edit_debounce`: retention check (`< 50%` => true)
  */
 export declare const AI_TAG_CHANGE_RATIO_THRESHOLD = 0.5;
 export type AITagPayload = {
     changedCharacters: number;
     templateLength: number;
     changePercent: number;
-    /** True when changedCharacters / templateLength >= {@link AI_TAG_CHANGE_RATIO_THRESHOLD} */
+    /**
+     * Interpretation depends on source:
+     * - `accept`: true when changedCharacters / templateLength >= threshold.
+     * - `post_edit_debounce`: true when changedCharacters / templateLength < threshold.
+     */
     isAiTagged: boolean;
     /**
      * True when this accept occurred during the “initial AI prefill” phase: the host
@@ -51,8 +56,8 @@ export declare function levenshteinDistance(a: string, b: string): number;
  */
 export declare function computeAiTagOnAccept(input: ComputeAiTagOnAcceptInput): AITagPayload;
 /**
- * Computes AI tag after user edits an accepted AI suggestion.
- * For post-edit flow, we still apply the same tag rule:
- * changedCharacters / templateLength >= AI_TAG_CHANGE_RATIO_THRESHOLD => AI-tagged.
+ * Computes AI tag after user edits AI-derived text.
+ * Post-edit is a retention check: if drift from AI baseline reaches >= 50%,
+ * the text is treated as no longer AI-tagged.
  */
 export declare function computeAiTagOnPostEdit(input: ComputeAiTagOnPostEditInput): AITagPayload;

package/dist/esm/components/WhatsAppTextEditor/ai/aiTag.js

@@ -1 +1 @@
-const e=.5;function t(e,t){const n=e.length,a=t.length,i=Array(a+1).fill(0).map(((e,t)=>t));for(let l=1;l<=n;l++){let n=i[0];i[0]=l;for(let r=1;r<=a;r++){const a=i[r];e[l-1]===t[r-1]?i[r]=n:i[r]=Math.min(i[r-1],i[r],n)+1,n=a}}return i[a]}function n(e){const{baselineText:n,acceptedText:a,initialAiPrefillPhase:i}=e,l=t(n,a),r=Math.max(n.length,a.length,1),c=l/r;return{changedCharacters:l,templateLength:r,changePercent:c,isAiTagged:c>=.5,initialAiPrefillPhase:i}}function a(e){const{acceptedAiText:n,currentEditedText:a}=e,i=t(n,a),l=Math.max(n.length,a.length,1),r=i/l;return{changedCharacters:i,templateLength:l,changePercent:r,isAiTagged:r>=.5,initialAiPrefillPhase:!1}}export{e as AI_TAG_CHANGE_RATIO_THRESHOLD,n as computeAiTagOnAccept,a as computeAiTagOnPostEdit,t as levenshteinDistance};
+const e=.5;function t(e,t){const n=e.length,a=t.length,i=Array(a+1).fill(0).map(((e,t)=>t));for(let l=1;l<=n;l++){let n=i[0];i[0]=l;for(let r=1;r<=a;r++){const a=i[r];e[l-1]===t[r-1]?i[r]=n:i[r]=Math.min(i[r-1],i[r],n)+1,n=a}}return i[a]}function n(e){const{baselineText:n,acceptedText:a,initialAiPrefillPhase:i}=e,l=t(n,a),r=Math.max(n.length,a.length,1),c=l/r;return{changedCharacters:l,templateLength:r,changePercent:c,isAiTagged:c>=.5,initialAiPrefillPhase:i}}function a(e){const{acceptedAiText:n,currentEditedText:a}=e,i=t(n,a),l=Math.max(n.length,a.length,1),r=i/l;return{changedCharacters:i,templateLength:l,changePercent:r,isAiTagged:r<.5,initialAiPrefillPhase:!1}}export{e as AI_TAG_CHANGE_RATIO_THRESHOLD,n as computeAiTagOnAccept,a as computeAiTagOnPostEdit,t as levenshteinDistance};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@bikdotai/bik-component-library",
-	"version": "0.0.777-beta.22",
+	"version": "0.0.777-beta.24",
 	"description": "Bik Component Library",
 	"repository": {
 		"type": "git",