@atlaskit/editor-plugin-autocomplete 3.4.0 → 3.5.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @atlaskit/editor-plugin-autocomplete
 
+## 3.5.0
+
+### Minor Changes
+
+- [`52c7f5f973025`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/52c7f5f973025) -
+  Switch the CTC autocomplete debug toggle off `localStorage` and onto a storage-free mechanism.
+  Debug logging is now enabled via the `__atlCtcDebug__.enable()` / `.disable()` console API for the
+  current session, or by appending `?atlCtcDebug=1` to the URL to have it active from initial load
+  (and survive reloads). This avoids browser-storage consent controls (BSC) that can block
+  uncategorized `localStorage` writes in some products. The `isAutocompleteDebugEnabled()` API is
+  unchanged for callers.
+
+## 3.4.1
+
+### Patch Changes
+
+- [`4129a00a1ae04`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/4129a00a1ae04) -
+  Add `completionSource` attribute to contextual typeahead analytics events to distinguish between
+  cold (frequency-only), server slow-lane, and on-device local LLM scoring paths
+- Updated dependencies
+
 ## 3.4.0
 
 ### Minor Changes

package/dist/cjs/pm-plugins/autocomplete-plugin.js

@@ -223,6 +223,18 @@ var createAutocompletePlugin = exports.createAutocompletePlugin = function creat
   var dismissedContext = null;
   var lastSuggestionTypedLength = 0;
   var lastSuggestionLength = 0;
+
+  /**
+   * cold  → no slow-lane vector received yet; frequency-only trie scoring
+   * server → server slow-lane API returned the context vector
+   * localLlm → on-device WebGPU/MLC model returned the context vector
+   */
+  var getCompletionSource = function getCompletionSource() {
+    if (!slowLaneClient.getContextVector()) {
+      return 'cold';
+    }
+    return options !== null && options !== void 0 && options.useLocalModel ? 'localLlm' : 'server';
+  };
   var fireSuggestionDismissedAnalytics = function fireSuggestionDismissedAnalytics(reason) {
     var _api$analytics;
     api === null || api === void 0 || (_api$analytics = api.analytics) === null || _api$analytics === void 0 || _api$analytics.actions.fireAnalyticsEvent({
@@ -230,6 +242,7 @@ var createAutocompletePlugin = exports.createAutocompletePlugin = function creat
       actionSubject: _analytics.ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
       eventType: _analytics.EVENT_TYPE.TRACK,
       attributes: {
+        completionSource: getCompletionSource(),
         reason: reason
       }
     });
@@ -244,6 +257,7 @@ var createAutocompletePlugin = exports.createAutocompletePlugin = function creat
       actionSubject: _analytics.ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
       eventType: _analytics.EVENT_TYPE.TRACK,
       attributes: {
+        completionSource: getCompletionSource(),
         suggestionLength: suggestionLength,
         typedLength: typedLength,
         kssDelta: kssDelta
@@ -410,7 +424,10 @@ var createAutocompletePlugin = exports.createAutocompletePlugin = function creat
             api === null || api === void 0 || (_api$analytics3 = api.analytics) === null || _api$analytics3 === void 0 || _api$analytics3.actions.fireAnalyticsEvent({
               action: _analytics.ACTION.SUGGESTION_VIEWED,
               actionSubject: _analytics.ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
-              eventType: _analytics.EVENT_TYPE.TRACK
+              eventType: _analytics.EVENT_TYPE.TRACK,
+              attributes: {
+                completionSource: getCompletionSource()
+              }
             });
           }
         }

package/dist/cjs/pm-plugins/debug-mode.js

@@ -7,18 +7,59 @@ exports.isAutocompleteDebugEnabled = void 0;
 /**
  * Contextual Typeahead Completions (CTC) debug logging utility.
  *
- * Logs are silent by default. To enable in any environment (dev, staging, prod):
+ * Logs are silent by default. Enable in any environment (dev, staging, prod):
  *
- *   localStorage.setItem('atl-ctc-dbg', '1')
+ *   // Live, for the current session (no reload required):
+ *   __atlCtcDebug__.enable()
  *
- * Then reload the page. To disable:
+ *   // To disable:
+ *   __atlCtcDebug__.disable()
  *
- *   localStorage.removeItem('atl-ctc-dbg')
+ *   // From initial page load (survives reload) — append to the URL:
+ *   ?atlCtcDebug=1
+ *
+ * Storage-free by design: avoids browser-storage consent controls (BSC), which can
+ * block uncategorized localStorage/sessionStorage/cookie writes in some products.
  */
-var isAutocompleteDebugEnabled = exports.isAutocompleteDebugEnabled = function isAutocompleteDebugEnabled() {
+
+var hasUrlDebugFlag = function hasUrlDebugFlag() {
+  if (typeof window === 'undefined') {
+    return false;
+  }
   try {
-    return typeof localStorage !== 'undefined' && localStorage.getItem('atl-ctc-dbg') === '1';
+    return new URLSearchParams(window.location.search).get('atlCtcDebug') === '1';
   } catch (_unused) {
     return false;
   }
-};
+};
+
+// State lives on the window object (not a module closure) so duplicate copies of this
+// module across separate bundles/realms share one source of truth and the console API
+// controls them all. In-memory only; persisted across reload via the URL flag.
+var getDebugApi = function getDebugApi() {
+  if (typeof window === 'undefined') {
+    return undefined;
+  }
+  if (!window.__atlCtcDebug__) {
+    var debugEnabled = hasUrlDebugFlag();
+    window.__atlCtcDebug__ = {
+      enable: function enable() {
+        debugEnabled = true;
+      },
+      disable: function disable() {
+        debugEnabled = false;
+      },
+      isEnabled: function isEnabled() {
+        return debugEnabled;
+      }
+    };
+  }
+  return window.__atlCtcDebug__;
+};
+var isAutocompleteDebugEnabled = exports.isAutocompleteDebugEnabled = function isAutocompleteDebugEnabled() {
+  var _getDebugApi$isEnable, _getDebugApi;
+  return (_getDebugApi$isEnable = (_getDebugApi = getDebugApi()) === null || _getDebugApi === void 0 ? void 0 : _getDebugApi.isEnabled()) !== null && _getDebugApi$isEnable !== void 0 ? _getDebugApi$isEnable : false;
+};
+
+// Eagerly install so the console API is available on load, regardless of call order.
+getDebugApi();

package/dist/es2019/pm-plugins/autocomplete-plugin.js

@@ -211,6 +211,18 @@ export const createAutocompletePlugin = (options, api) => {
   let dismissedContext = null;
   let lastSuggestionTypedLength = 0;
   let lastSuggestionLength = 0;
+
+  /**
+   * cold  → no slow-lane vector received yet; frequency-only trie scoring
+   * server → server slow-lane API returned the context vector
+   * localLlm → on-device WebGPU/MLC model returned the context vector
+   */
+  const getCompletionSource = () => {
+    if (!slowLaneClient.getContextVector()) {
+      return 'cold';
+    }
+    return options !== null && options !== void 0 && options.useLocalModel ? 'localLlm' : 'server';
+  };
   const fireSuggestionDismissedAnalytics = reason => {
     var _api$analytics;
     api === null || api === void 0 ? void 0 : (_api$analytics = api.analytics) === null || _api$analytics === void 0 ? void 0 : _api$analytics.actions.fireAnalyticsEvent({
@@ -218,6 +230,7 @@ export const createAutocompletePlugin = (options, api) => {
       actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
       eventType: EVENT_TYPE.TRACK,
       attributes: {
+        completionSource: getCompletionSource(),
         reason
       }
     });
@@ -232,6 +245,7 @@ export const createAutocompletePlugin = (options, api) => {
       actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
       eventType: EVENT_TYPE.TRACK,
       attributes: {
+        completionSource: getCompletionSource(),
         suggestionLength,
         typedLength,
         kssDelta
@@ -392,7 +406,10 @@ export const createAutocompletePlugin = (options, api) => {
             api === null || api === void 0 ? void 0 : (_api$analytics3 = api.analytics) === null || _api$analytics3 === void 0 ? void 0 : _api$analytics3.actions.fireAnalyticsEvent({
               action: ACTION.SUGGESTION_VIEWED,
               actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
-              eventType: EVENT_TYPE.TRACK
+              eventType: EVENT_TYPE.TRACK,
+              attributes: {
+                completionSource: getCompletionSource()
+              }
             });
           }
         }

package/dist/es2019/pm-plugins/debug-mode.js

@@ -1,18 +1,57 @@
 /**
  * Contextual Typeahead Completions (CTC) debug logging utility.
  *
- * Logs are silent by default. To enable in any environment (dev, staging, prod):
+ * Logs are silent by default. Enable in any environment (dev, staging, prod):
  *
- *   localStorage.setItem('atl-ctc-dbg', '1')
+ *   // Live, for the current session (no reload required):
+ *   __atlCtcDebug__.enable()
  *
- * Then reload the page. To disable:
+ *   // To disable:
+ *   __atlCtcDebug__.disable()
  *
- *   localStorage.removeItem('atl-ctc-dbg')
+ *   // From initial page load (survives reload) — append to the URL:
+ *   ?atlCtcDebug=1
+ *
+ * Storage-free by design: avoids browser-storage consent controls (BSC), which can
+ * block uncategorized localStorage/sessionStorage/cookie writes in some products.
  */
-export const isAutocompleteDebugEnabled = () => {
+
+const hasUrlDebugFlag = () => {
+  if (typeof window === 'undefined') {
+    return false;
+  }
   try {
-    return typeof localStorage !== 'undefined' && localStorage.getItem('atl-ctc-dbg') === '1';
+    return new URLSearchParams(window.location.search).get('atlCtcDebug') === '1';
   } catch {
     return false;
   }
-};
+};
+
+// State lives on the window object (not a module closure) so duplicate copies of this
+// module across separate bundles/realms share one source of truth and the console API
+// controls them all. In-memory only; persisted across reload via the URL flag.
+const getDebugApi = () => {
+  if (typeof window === 'undefined') {
+    return undefined;
+  }
+  if (!window.__atlCtcDebug__) {
+    let debugEnabled = hasUrlDebugFlag();
+    window.__atlCtcDebug__ = {
+      enable: () => {
+        debugEnabled = true;
+      },
+      disable: () => {
+        debugEnabled = false;
+      },
+      isEnabled: () => debugEnabled
+    };
+  }
+  return window.__atlCtcDebug__;
+};
+export const isAutocompleteDebugEnabled = () => {
+  var _getDebugApi$isEnable, _getDebugApi;
+  return (_getDebugApi$isEnable = (_getDebugApi = getDebugApi()) === null || _getDebugApi === void 0 ? void 0 : _getDebugApi.isEnabled()) !== null && _getDebugApi$isEnable !== void 0 ? _getDebugApi$isEnable : false;
+};
+
+// Eagerly install so the console API is available on load, regardless of call order.
+getDebugApi();

package/dist/esm/pm-plugins/autocomplete-plugin.js

@@ -216,6 +216,18 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options,
   var dismissedContext = null;
   var lastSuggestionTypedLength = 0;
   var lastSuggestionLength = 0;
+
+  /**
+   * cold  → no slow-lane vector received yet; frequency-only trie scoring
+   * server → server slow-lane API returned the context vector
+   * localLlm → on-device WebGPU/MLC model returned the context vector
+   */
+  var getCompletionSource = function getCompletionSource() {
+    if (!slowLaneClient.getContextVector()) {
+      return 'cold';
+    }
+    return options !== null && options !== void 0 && options.useLocalModel ? 'localLlm' : 'server';
+  };
   var fireSuggestionDismissedAnalytics = function fireSuggestionDismissedAnalytics(reason) {
     var _api$analytics;
     api === null || api === void 0 || (_api$analytics = api.analytics) === null || _api$analytics === void 0 || _api$analytics.actions.fireAnalyticsEvent({
@@ -223,6 +235,7 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options,
       actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
       eventType: EVENT_TYPE.TRACK,
       attributes: {
+        completionSource: getCompletionSource(),
         reason: reason
       }
     });
@@ -237,6 +250,7 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options,
       actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
       eventType: EVENT_TYPE.TRACK,
       attributes: {
+        completionSource: getCompletionSource(),
         suggestionLength: suggestionLength,
         typedLength: typedLength,
         kssDelta: kssDelta
@@ -403,7 +417,10 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options,
             api === null || api === void 0 || (_api$analytics3 = api.analytics) === null || _api$analytics3 === void 0 || _api$analytics3.actions.fireAnalyticsEvent({
               action: ACTION.SUGGESTION_VIEWED,
               actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
-              eventType: EVENT_TYPE.TRACK
+              eventType: EVENT_TYPE.TRACK,
+              attributes: {
+                completionSource: getCompletionSource()
+              }
             });
           }
         }

package/dist/esm/pm-plugins/debug-mode.js

@@ -1,18 +1,59 @@
 /**
  * Contextual Typeahead Completions (CTC) debug logging utility.
  *
- * Logs are silent by default. To enable in any environment (dev, staging, prod):
+ * Logs are silent by default. Enable in any environment (dev, staging, prod):
  *
- *   localStorage.setItem('atl-ctc-dbg', '1')
+ *   // Live, for the current session (no reload required):
+ *   __atlCtcDebug__.enable()
  *
- * Then reload the page. To disable:
+ *   // To disable:
+ *   __atlCtcDebug__.disable()
  *
- *   localStorage.removeItem('atl-ctc-dbg')
+ *   // From initial page load (survives reload) — append to the URL:
+ *   ?atlCtcDebug=1
+ *
+ * Storage-free by design: avoids browser-storage consent controls (BSC), which can
+ * block uncategorized localStorage/sessionStorage/cookie writes in some products.
  */
-export var isAutocompleteDebugEnabled = function isAutocompleteDebugEnabled() {
+
+var hasUrlDebugFlag = function hasUrlDebugFlag() {
+  if (typeof window === 'undefined') {
+    return false;
+  }
   try {
-    return typeof localStorage !== 'undefined' && localStorage.getItem('atl-ctc-dbg') === '1';
+    return new URLSearchParams(window.location.search).get('atlCtcDebug') === '1';
   } catch (_unused) {
     return false;
   }
-};
+};
+
+// State lives on the window object (not a module closure) so duplicate copies of this
+// module across separate bundles/realms share one source of truth and the console API
+// controls them all. In-memory only; persisted across reload via the URL flag.
+var getDebugApi = function getDebugApi() {
+  if (typeof window === 'undefined') {
+    return undefined;
+  }
+  if (!window.__atlCtcDebug__) {
+    var debugEnabled = hasUrlDebugFlag();
+    window.__atlCtcDebug__ = {
+      enable: function enable() {
+        debugEnabled = true;
+      },
+      disable: function disable() {
+        debugEnabled = false;
+      },
+      isEnabled: function isEnabled() {
+        return debugEnabled;
+      }
+    };
+  }
+  return window.__atlCtcDebug__;
+};
+export var isAutocompleteDebugEnabled = function isAutocompleteDebugEnabled() {
+  var _getDebugApi$isEnable, _getDebugApi;
+  return (_getDebugApi$isEnable = (_getDebugApi = getDebugApi()) === null || _getDebugApi === void 0 ? void 0 : _getDebugApi.isEnabled()) !== null && _getDebugApi$isEnable !== void 0 ? _getDebugApi$isEnable : false;
+};
+
+// Eagerly install so the console API is available on load, regardless of call order.
+getDebugApi();

package/dist/types/pm-plugins/debug-mode.d.ts

@@ -1,12 +1,27 @@
 /**
  * Contextual Typeahead Completions (CTC) debug logging utility.
  *
- * Logs are silent by default. To enable in any environment (dev, staging, prod):
+ * Logs are silent by default. Enable in any environment (dev, staging, prod):
  *
- *   localStorage.setItem('atl-ctc-dbg', '1')
+ *   // Live, for the current session (no reload required):
+ *   __atlCtcDebug__.enable()
  *
- * Then reload the page. To disable:
+ *   // To disable:
+ *   __atlCtcDebug__.disable()
  *
- *   localStorage.removeItem('atl-ctc-dbg')
+ *   // From initial page load (survives reload) — append to the URL:
+ *   ?atlCtcDebug=1
+ *
+ * Storage-free by design: avoids browser-storage consent controls (BSC), which can
+ * block uncategorized localStorage/sessionStorage/cookie writes in some products.
  */
+declare global {
+    interface Window {
+        __atlCtcDebug__?: {
+            enable: () => void;
+            disable: () => void;
+            isEnabled: () => boolean;
+        };
+    }
+}
 export declare const isAutocompleteDebugEnabled: () => boolean;

package/dist/types-ts4.5/pm-plugins/debug-mode.d.ts

@@ -1,12 +1,27 @@
 /**
  * Contextual Typeahead Completions (CTC) debug logging utility.
  *
- * Logs are silent by default. To enable in any environment (dev, staging, prod):
+ * Logs are silent by default. Enable in any environment (dev, staging, prod):
  *
- *   localStorage.setItem('atl-ctc-dbg', '1')
+ *   // Live, for the current session (no reload required):
+ *   __atlCtcDebug__.enable()
  *
- * Then reload the page. To disable:
+ *   // To disable:
+ *   __atlCtcDebug__.disable()
  *
- *   localStorage.removeItem('atl-ctc-dbg')
+ *   // From initial page load (survives reload) — append to the URL:
+ *   ?atlCtcDebug=1
+ *
+ * Storage-free by design: avoids browser-storage consent controls (BSC), which can
+ * block uncategorized localStorage/sessionStorage/cookie writes in some products.
  */
+declare global {
+    interface Window {
+        __atlCtcDebug__?: {
+            enable: () => void;
+            disable: () => void;
+            isEnabled: () => boolean;
+        };
+    }
+}
 export declare const isAutocompleteDebugEnabled: () => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-autocomplete",
-	"version": "3.4.0",
+	"version": "3.5.0",
 	"description": "Client-side text autocomplete plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -35,7 +35,7 @@
 		"wink-nlp": "^2.4.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^115.7.0",
+		"@atlaskit/editor-common": "^115.8.0",
 		"@atlaskit/editor-plugin-analytics": "^11.0.0",
 		"react": "^18.2.0"
 	},

package/src/pm-plugins/autocomplete-plugin.ts

@@ -277,12 +277,24 @@ export const createAutocompletePlugin = (
 	let lastSuggestionTypedLength = 0;
 	let lastSuggestionLength = 0;
 
+	/**
+	 * cold  → no slow-lane vector received yet; frequency-only trie scoring
+	 * server → server slow-lane API returned the context vector
+	 * localLlm → on-device WebGPU/MLC model returned the context vector
+	 */
+	const getCompletionSource = (): 'cold' | 'server' | 'localLlm' => {
+		if (!slowLaneClient.getContextVector()) {
+			return 'cold';
+		}
+		return options?.useLocalModel ? 'localLlm' : 'server';
+	};
+
 	const fireSuggestionDismissedAnalytics = (reason: 'escape' | 'blur'): void => {
 		api?.analytics?.actions.fireAnalyticsEvent({
 			action: ACTION.SUGGESTION_DISMISSED,
 			actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
 			eventType: EVENT_TYPE.TRACK,
-			attributes: { reason },
+			attributes: { completionSource: getCompletionSource(), reason },
 		});
 	};
 
@@ -296,6 +308,7 @@ export const createAutocompletePlugin = (
 			actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
 			eventType: EVENT_TYPE.TRACK,
 			attributes: {
+				completionSource: getCompletionSource(),
 				suggestionLength,
 				typedLength,
 				kssDelta,
@@ -484,6 +497,7 @@ export const createAutocompletePlugin = (
 							action: ACTION.SUGGESTION_VIEWED,
 							actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
 							eventType: EVENT_TYPE.TRACK,
+							attributes: { completionSource: getCompletionSource() },
 						});
 					}
 				}

package/src/pm-plugins/debug-mode.ts

@@ -1,18 +1,65 @@
 /**
  * Contextual Typeahead Completions (CTC) debug logging utility.
  *
- * Logs are silent by default. To enable in any environment (dev, staging, prod):
+ * Logs are silent by default. Enable in any environment (dev, staging, prod):
  *
- *   localStorage.setItem('atl-ctc-dbg', '1')
+ *   // Live, for the current session (no reload required):
+ *   __atlCtcDebug__.enable()
  *
- * Then reload the page. To disable:
+ *   // To disable:
+ *   __atlCtcDebug__.disable()
  *
- *   localStorage.removeItem('atl-ctc-dbg')
+ *   // From initial page load (survives reload) — append to the URL:
+ *   ?atlCtcDebug=1
+ *
+ * Storage-free by design: avoids browser-storage consent controls (BSC), which can
+ * block uncategorized localStorage/sessionStorage/cookie writes in some products.
  */
-export const isAutocompleteDebugEnabled = (): boolean => {
+
+declare global {
+	interface Window {
+		__atlCtcDebug__?: {
+			enable: () => void;
+			disable: () => void;
+			isEnabled: () => boolean;
+		};
+	}
+}
+
+const hasUrlDebugFlag = (): boolean => {
+	if (typeof window === 'undefined') {
+		return false;
+	}
 	try {
-		return typeof localStorage !== 'undefined' && localStorage.getItem('atl-ctc-dbg') === '1';
+		return new URLSearchParams(window.location.search).get('atlCtcDebug') === '1';
 	} catch {
 		return false;
 	}
 };
+
+// State lives on the window object (not a module closure) so duplicate copies of this
+// module across separate bundles/realms share one source of truth and the console API
+// controls them all. In-memory only; persisted across reload via the URL flag.
+const getDebugApi = (): Window['__atlCtcDebug__'] => {
+	if (typeof window === 'undefined') {
+		return undefined;
+	}
+	if (!window.__atlCtcDebug__) {
+		let debugEnabled = hasUrlDebugFlag();
+		window.__atlCtcDebug__ = {
+			enable: () => {
+				debugEnabled = true;
+			},
+			disable: () => {
+				debugEnabled = false;
+			},
+			isEnabled: () => debugEnabled,
+		};
+	}
+	return window.__atlCtcDebug__;
+};
+
+export const isAutocompleteDebugEnabled = (): boolean => getDebugApi()?.isEnabled() ?? false;
+
+// Eagerly install so the console API is available on load, regardless of call order.
+getDebugApi();