@atlaskit/editor-plugin-autocomplete 2.1.0 → 2.3.0

package/dist/es2019/pm-plugins/slow-lane-client.js

@@ -7,6 +7,8 @@
  *   Response: { semantic_vector: number[], lm_logits: Record<string, number> }
  */
 
+import { isAutocompleteDebugEnabled } from './debug-mode';
+
 // ─── Types ───────────────────────────────────────────────────────────────────
 
 /** Request payload for typeahead-encodings endpoint. */
@@ -63,16 +65,16 @@ export const createSlowLaneClient = config => {
       text,
       session_id: sessionId
     };
-
-    // Log the exact payload being sent so the comment/reply structure is visible
-    // eslint-disable-next-line no-console
-    console.groupCollapsed(`%c[SlowLane] %c📤 Sending context | ${text.length} chars`, 'color: #9c27b0; font-weight: bold;', 'color: inherit;');
-    text.split('\n').forEach((line, i, arr) => {
+    if (isAutocompleteDebugEnabled()) {
+      // eslint-disable-next-line no-console
+      console.groupCollapsed(`%c[SlowLane] %c📤 Sending context | ${text.length} chars`, 'color: #9c27b0; font-weight: bold;', 'color: inherit;');
+      text.split('\n').forEach((line, i, arr) => {
+        // eslint-disable-next-line no-console
+        console.log(`  ${i === arr.length - 1 ? '▶' : ' '} ${line}`);
+      });
       // eslint-disable-next-line no-console
-      console.log(`  ${i === arr.length - 1 ? '▶' : ' '} ${line}`);
-    });
-    // eslint-disable-next-line no-console
-    console.groupEnd();
+      console.groupEnd();
+    }
     try {
       const res = await fetchFn(url, {
         method: 'POST',
@@ -82,8 +84,10 @@ export const createSlowLaneClient = config => {
       if (!res.ok) {
         storedContextVector = null;
         storedLmLogits = null;
-        // eslint-disable-next-line no-console
-        console.log(`%c[SlowLane] %c❌ Request failed (${res.status})`, 'color: #9c27b0; font-weight: bold;', 'color: #f44336;');
+        if (isAutocompleteDebugEnabled()) {
+          // eslint-disable-next-line no-console
+          console.log(`%c[SlowLane] %c❌ Request failed (${res.status})`, 'color: #9c27b0; font-weight: bold;', 'color: #f44336;');
+        }
         return;
       }
       const data = await res.json();
@@ -97,16 +101,16 @@ export const createSlowLaneClient = config => {
       } else {
         storedLmLogits = null;
       }
-
-      // Log what came back so it can be correlated with the next prediction group
-      // eslint-disable-next-line no-console
-      console.groupCollapsed(`%c[SlowLane] %c📥 Response received`, 'color: #9c27b0; font-weight: bold;', 'color: inherit;');
-      // eslint-disable-next-line no-console
-      console.log(storedContextVector ? `✅ semantic_vector: ${storedContextVector.length} dims` : '❌ No semantic_vector');
-      // eslint-disable-next-line no-console
-      console.log(storedLmLogits ? `✅ lm_logits: ${Object.keys(storedLmLogits).length} tokens` : '❌ No lm_logits');
-      // eslint-disable-next-line no-console
-      console.groupEnd();
+      if (isAutocompleteDebugEnabled()) {
+        // eslint-disable-next-line no-console
+        console.groupCollapsed(`%c[SlowLane] %c📥 Response received`, 'color: #9c27b0; font-weight: bold;', 'color: inherit;');
+        // eslint-disable-next-line no-console
+        console.log(storedContextVector ? `✅ semantic_vector: ${storedContextVector.length} dims` : '❌ No semantic_vector');
+        // eslint-disable-next-line no-console
+        console.log(storedLmLogits ? `✅ lm_logits: ${Object.keys(storedLmLogits).length} tokens` : '❌ No lm_logits');
+        // eslint-disable-next-line no-console
+        console.groupEnd();
+      }
       onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate({
         textLength: text.length,
         hasVector: storedContextVector !== null,
@@ -116,8 +120,10 @@ export const createSlowLaneClient = config => {
     } catch (e) {
       storedContextVector = null;
       storedLmLogits = null;
-      // eslint-disable-next-line no-console
-      console.log('%c[SlowLane] %c❌ Network error — context cleared', 'color: #9c27b0; font-weight: bold;', 'color: #f44336;');
+      if (isAutocompleteDebugEnabled()) {
+        // eslint-disable-next-line no-console
+        console.log('%c[SlowLane] %c❌ Network error — context cleared', 'color: #9c27b0; font-weight: bold;', 'color: #f44336;');
+      }
     }
   };
   const updateContextDebounced = text => {

package/dist/es2019/pm-plugins/text-predictor.js

@@ -21,6 +21,7 @@ import l3VocabularyData from './data/l3_vocabulary.json';
 import vocabularyData from './data/vocabulary_10k.json';
 import wordIndexData from './data/word_index_10k.json';
 // import { rankCandidates, isGrammarAllowed } from './scoring-pipeline';
+import { isAutocompleteDebugEnabled } from './debug-mode';
 import { rankCandidates, STAGE1_WEIGHT, STAGE2_WEIGHT, MIN_STAGE1_SCORE } from './scoring-pipeline';
 import { getStoredContextVector, getStoredLmLogits } from './slow-lane-client';
 
@@ -161,7 +162,7 @@ export const initL3Vocabulary = l3Words => {
     // loses to any domain word in Stage 1, but still scores above 0.
     l3Trie.insert(word, L3_BASELINE_FREQ, 0, 0);
   }
-  if (debugMode) {
+  if (isAutocompleteDebugEnabled()) {
     // eslint-disable-next-line no-console
     console.log(`[text-predictor] L3 General English loaded: ${l3Words.length} words`);
   }
@@ -174,9 +175,7 @@ export const initL3Vocabulary = l3Words => {
 let isInitialized = false;
 let vectorStore = null;
 let vectorsLoadStarted = false;
-let debugMode = true;
 let lastPredictionDebug = null;
-let hasLoggedSemanticActive = false;
 
 /** Get vector for a word from the store. */
 const getWordVector = word => {
@@ -263,25 +262,12 @@ const extractPreviousWord = text => {
 
 // ─── Debug Helpers ───────────────────────────────────────────────────────────
 
-/** Enable or disable debug logging. Also checks localStorage key `autocomplete-debug`. */
-export const setDebugMode = enabled => {
-  debugMode = enabled;
-};
-
-/** Check localStorage for autocomplete-debug on first access. */
-const ensureDebugModeFromStorage = () => {
-  if (typeof localStorage !== 'undefined' && localStorage.getItem('autocomplete-debug') === '1') {
-    debugMode = true;
-  }
-};
-
 /**
  * Get predictor status for debugging.
  * vectorsLoaded: true when semantic scoring is active
  * wordCount: number of words in vector store (0 if not loaded)
  */
 export const getPredictorStatus = () => {
-  ensureDebugModeFromStorage();
   return {
     vectorsLoaded: vectorStore !== null,
     wordCount: vectorStore ? Object.keys(vectorStore.wordIndex).length : 0,
@@ -295,7 +281,6 @@ export const getPredictorStatus = () => {
  * Returns null if no prediction has run yet or debug was off.
  */
 export const getLastPredictionDebug = () => {
-  ensureDebugModeFromStorage();
   return lastPredictionDebug;
 };
 export const initVocabulary = vocabulary => {
@@ -336,7 +321,7 @@ export const ingestDocumentPage = pageContent => {
       validBoostedWords.add(word);
     }
   }
-  if (debugMode && validBoostedWords.size > 0) {
+  if (isAutocompleteDebugEnabled() && validBoostedWords.size > 0) {
     // eslint-disable-next-line no-console
     console.groupCollapsed(`%c[L1 Session] %cPrimed ${validBoostedWords.size} valid dictionary words from page`, 'color: #00b8d9; font-weight: bold;', 'color: inherit; font-style: italic;');
     // eslint-disable-next-line no-console
@@ -346,7 +331,6 @@ export const ingestDocumentPage = pageContent => {
   }
 };
 export const predict = textBefore => {
-  ensureDebugModeFromStorage();
   if (!isInitialized) {
     loadDefaultVocabulary();
   }
@@ -428,7 +412,7 @@ export const predict = textBefore => {
   const lmLogits = getStoredLmLogits();
 
   // Raw LM Output Logger
-  if (debugMode && lmLogits && Object.keys(lmLogits).length > 0) {
+  if (isAutocompleteDebugEnabled() && lmLogits && Object.keys(lmLogits).length > 0) {
     const rawLmTop = Object.entries(lmLogits).sort((a, b) => b[1] - a[1]).slice(0, 5).map(([word, score]) => ({
       Word: word,
       Prob: Number(score.toFixed(5))
@@ -437,9 +421,6 @@ export const predict = textBefore => {
     console.log('%c[Raw LM Prediction]🧠', 'color: #e83e8c; font-weight: bold;', rawLmTop);
   }
   const mode = contextVector ? 'warm' : 'cold';
-  if (debugMode && contextVector && !hasLoggedSemanticActive) {
-    hasLoggedSemanticActive = true;
-  }
 
   // Build ScoringCandidate array from TrieNodes
   const scoringCandidates = candidates.map(({
@@ -464,7 +445,7 @@ export const predict = textBefore => {
   } = rankCandidates(scoringCandidates, contextVector, w => getWordVector(w), prefixLmLogits, wordTrie.maxTenantFreq, previousWord);
   const best = ranked[0];
   const suggestion = best && best.finalScore >= MIN_SCORE_THRESHOLD ? best.word.slice(currentWord.length) : null;
-  if (debugMode) {
+  if (isAutocompleteDebugEnabled()) {
     const latencyMs = performance.now() - t0;
     const tokens = tokenize(trimmed);
     const contextWords = tokens.slice(-CONTEXT_WORDS);
@@ -612,8 +593,7 @@ export const loadVectorsAsync = async options => {
       wordIndex,
       dim
     };
-    ensureDebugModeFromStorage();
-    if (debugMode) {
+    if (isAutocompleteDebugEnabled()) {
       // eslint-disable-next-line no-console
       console.log('[text-predictor] Vectors loaded:', {
         wordCount: nWords,

package/dist/esm/autocompletePlugin.js

@@ -1,6 +1,7 @@
 import { autocompletePluginKey, createAutocompletePlugin } from './pm-plugins/autocomplete-plugin';
 export var autocompletePlugin = function autocompletePlugin(_ref) {
-  var options = _ref.config;
+  var options = _ref.config,
+    api = _ref.api;
   return {
     name: 'autocomplete',
     getSharedState: function getSharedState(editorState) {
@@ -13,7 +14,7 @@ export var autocompletePlugin = function autocompletePlugin(_ref) {
       return [{
         name: 'autocomplete',
         plugin: function plugin() {
-          return createAutocompletePlugin(options);
+          return createAutocompletePlugin(options, api);
         }
       }];
     }

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

@@ -1,6 +1,7 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+import { ACTION, ACTION_SUBJECT, EVENT_TYPE } from '@atlaskit/editor-common/analytics';
 import { SafePlugin } from '@atlaskit/editor-common/safe-plugin';
 import { keydownHandler } from '@atlaskit/editor-prosemirror/keymap';
 import { PluginKey } from '@atlaskit/editor-prosemirror/state';
@@ -61,6 +62,7 @@ var setAutocompleteMeta = function setAutocompleteMeta(tr, meta) {
 /**
  * Apply a ghost text suggestion to the editor state.
  */
+var lastShownGhostText = '';
 var showGhostText = function showGhostText(view, text, position) {
   var state = view.state,
     dispatch = view.dispatch;
@@ -139,7 +141,17 @@ var buildSlowLaneText = function buildSlowLaneText(docText, context) {
   lines.push("reply ".concat(nextReplyNumber, ": ").concat(docText));
   return lines.join('\n');
 };
-export var createAutocompletePlugin = function createAutocompletePlugin(options) {
+var getTypedLengthForPrediction = function getTypedLengthForPrediction(textBefore) {
+  var _textBefore$match$, _textBefore$match;
+  if (isWordBoundary(textBefore)) {
+    return 0;
+  }
+
+  // eslint-disable-next-line require-unicode-regexp
+  var trailingToken = (_textBefore$match$ = (_textBefore$match = textBefore.match(/([^\s.,;:!?]*)$/)) === null || _textBefore$match === void 0 ? void 0 : _textBefore$match[1]) !== null && _textBefore$match$ !== void 0 ? _textBefore$match$ : '';
+  return trailingToken.length;
+};
+export var createAutocompletePlugin = function createAutocompletePlugin(options, api) {
   var debounceTimer = null;
   var hasIngestedPage = false;
   var resolvedContext;
@@ -156,6 +168,24 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options)
    * re-showing the same suggestion. Resets to null as soon as the text changes.
    */
   var dismissedContext = null;
+  var lastSuggestionTypedLength = 0;
+  var lastSuggestionLength = 0;
+  var fireSuggestionInsertedAnalytics = function fireSuggestionInsertedAnalytics(ghostText) {
+    var _api$analytics;
+    var typedLength = lastSuggestionTypedLength;
+    var suggestionLength = lastSuggestionLength || typedLength + ghostText.length;
+    var kssDelta = suggestionLength - typedLength;
+    api === null || api === void 0 || (_api$analytics = api.analytics) === null || _api$analytics === void 0 || _api$analytics.actions.fireAnalyticsEvent({
+      action: ACTION.SUGGESTION_INSERTED,
+      actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
+      eventType: EVENT_TYPE.TRACK,
+      attributes: {
+        suggestionLength: suggestionLength,
+        typedLength: typedLength,
+        kssDelta: kssDelta
+      }
+    });
+  };
   var slowLaneClient = createSlowLaneClient({
     baseUrl: '',
     endpoint: SLOW_LANE_ENDPOINT
@@ -196,7 +226,19 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options)
       // Tier 1 prediction is synchronous -- no async needed
       var prediction = predict(textBefore);
       if (prediction && prediction.length > 0) {
+        var typedLength = getTypedLengthForPrediction(textBefore);
+        lastSuggestionTypedLength = typedLength;
+        lastSuggestionLength = typedLength + prediction.length;
         showGhostText(view, prediction, selection.from);
+        if (prediction !== lastShownGhostText) {
+          var _api$analytics2;
+          lastShownGhostText = prediction;
+          api === null || api === void 0 || (_api$analytics2 = api.analytics) === null || _api$analytics2 === void 0 || _api$analytics2.actions.fireAnalyticsEvent({
+            action: ACTION.SUGGESTION_VIEWED,
+            actionSubject: ACTION_SUBJECT.CONTEXTUAL_TYPEAHEAD,
+            eventType: EVENT_TYPE.TRACK
+          });
+        }
       }
     }, DEBOUNCE_MS);
   };
@@ -267,13 +309,27 @@ export var createAutocompletePlugin = function createAutocompletePlugin(options)
       },
       handleKeyDown: keydownHandler({
         Tab: function Tab(state, dispatch) {
+          var _pluginState$ghostTex;
+          var pluginState = autocompletePluginKey.getState(state);
+          var ghostText = (_pluginState$ghostTex = pluginState === null || pluginState === void 0 ? void 0 : pluginState.ghostText) !== null && _pluginState$ghostTex !== void 0 ? _pluginState$ghostTex : '';
           var accepted = acceptGhostText(state, dispatch);
-          if (accepted) justAccepted = true;
+          if (accepted) {
+            justAccepted = true;
+            lastShownGhostText = '';
+            fireSuggestionInsertedAnalytics(ghostText);
+          }
           return accepted;
         },
         ArrowRight: function ArrowRight(state, dispatch) {
+          var _pluginState$ghostTex2;
+          var pluginState = autocompletePluginKey.getState(state);
+          var ghostText = (_pluginState$ghostTex2 = pluginState === null || pluginState === void 0 ? void 0 : pluginState.ghostText) !== null && _pluginState$ghostTex2 !== void 0 ? _pluginState$ghostTex2 : '';
           var accepted = acceptGhostText(state, dispatch);
-          if (accepted) justAccepted = true;
+          if (accepted) {
+            justAccepted = true;
+            lastShownGhostText = '';
+            fireSuggestionInsertedAnalytics(ghostText);
+          }
           return accepted;
         },
         Escape: function Escape(state, dispatch) {

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

@@ -0,0 +1,18 @@
+/**
+ * Contextual Typeahead Completions (CTC) debug logging utility.
+ *
+ * Logs are silent by default. To enable in any environment (dev, staging, prod):
+ *
+ *   localStorage.setItem('atl-ctc-dbg', '1')
+ *
+ * Then reload the page. To disable:
+ *
+ *   localStorage.removeItem('atl-ctc-dbg')
+ */
+export var isAutocompleteDebugEnabled = function isAutocompleteDebugEnabled() {
+  try {
+    return typeof localStorage !== 'undefined' && localStorage.getItem('atl-ctc-dbg') === '1';
+  } catch (_unused) {
+    return false;
+  }
+};

package/dist/esm/pm-plugins/slow-lane-client.js

@@ -10,6 +10,8 @@ import _regeneratorRuntime from "@babel/runtime/regenerator";
  *   Response: { semantic_vector: number[], lm_logits: Record<string, number> }
  */
 
+import { isAutocompleteDebugEnabled } from './debug-mode';
+
 // ─── Types ───────────────────────────────────────────────────────────────────
 
 /** Request payload for typeahead-encodings endpoint. */
@@ -74,37 +76,41 @@ export var createSlowLaneClient = function createSlowLaneClient(config) {
             payload = {
               text: text,
               session_id: sessionId
-            }; // Log the exact payload being sent so the comment/reply structure is visible
-            // eslint-disable-next-line no-console
-            console.groupCollapsed("%c[SlowLane] %c\uD83D\uDCE4 Sending context | ".concat(text.length, " chars"), 'color: #9c27b0; font-weight: bold;', 'color: inherit;');
-            text.split('\n').forEach(function (line, i, arr) {
+            };
+            if (isAutocompleteDebugEnabled()) {
               // eslint-disable-next-line no-console
-              console.log("  ".concat(i === arr.length - 1 ? '▶' : ' ', " ").concat(line));
-            });
-            // eslint-disable-next-line no-console
-            console.groupEnd();
-            _context.prev = 7;
-            _context.next = 10;
+              console.groupCollapsed("%c[SlowLane] %c\uD83D\uDCE4 Sending context | ".concat(text.length, " chars"), 'color: #9c27b0; font-weight: bold;', 'color: inherit;');
+              text.split('\n').forEach(function (line, i, arr) {
+                // eslint-disable-next-line no-console
+                console.log("  ".concat(i === arr.length - 1 ? '▶' : ' ', " ").concat(line));
+              });
+              // eslint-disable-next-line no-console
+              console.groupEnd();
+            }
+            _context.prev = 5;
+            _context.next = 8;
             return fetchFn(url, {
               method: 'POST',
               headers: headers,
               body: JSON.stringify(payload)
             });
-          case 10:
+          case 8:
             res = _context.sent;
             if (res.ok) {
-              _context.next = 16;
+              _context.next = 14;
               break;
             }
             storedContextVector = null;
             storedLmLogits = null;
-            // eslint-disable-next-line no-console
-            console.log("%c[SlowLane] %c\u274C Request failed (".concat(res.status, ")"), 'color: #9c27b0; font-weight: bold;', 'color: #f44336;');
+            if (isAutocompleteDebugEnabled()) {
+              // eslint-disable-next-line no-console
+              console.log("%c[SlowLane] %c\u274C Request failed (".concat(res.status, ")"), 'color: #9c27b0; font-weight: bold;', 'color: #f44336;');
+            }
             return _context.abrupt("return");
-          case 16:
-            _context.next = 18;
+          case 14:
+            _context.next = 16;
             return res.json();
-          case 18:
+          case 16:
             data = _context.sent;
             if (data.semantic_vector && Array.isArray(data.semantic_vector)) {
               storedContextVector = new Float32Array(data.semantic_vector);
@@ -116,36 +122,38 @@ export var createSlowLaneClient = function createSlowLaneClient(config) {
             } else {
               storedLmLogits = null;
             }
-
-            // Log what came back so it can be correlated with the next prediction group
-            // eslint-disable-next-line no-console
-            console.groupCollapsed("%c[SlowLane] %c\uD83D\uDCE5 Response received", 'color: #9c27b0; font-weight: bold;', 'color: inherit;');
-            // eslint-disable-next-line no-console
-            console.log(storedContextVector ? "\u2705 semantic_vector: ".concat(storedContextVector.length, " dims") : '❌ No semantic_vector');
-            // eslint-disable-next-line no-console
-            console.log(storedLmLogits ? "\u2705 lm_logits: ".concat(Object.keys(storedLmLogits).length, " tokens") : '❌ No lm_logits');
-            // eslint-disable-next-line no-console
-            console.groupEnd();
+            if (isAutocompleteDebugEnabled()) {
+              // eslint-disable-next-line no-console
+              console.groupCollapsed("%c[SlowLane] %c\uD83D\uDCE5 Response received", 'color: #9c27b0; font-weight: bold;', 'color: inherit;');
+              // eslint-disable-next-line no-console
+              console.log(storedContextVector ? "\u2705 semantic_vector: ".concat(storedContextVector.length, " dims") : '❌ No semantic_vector');
+              // eslint-disable-next-line no-console
+              console.log(storedLmLogits ? "\u2705 lm_logits: ".concat(Object.keys(storedLmLogits).length, " tokens") : '❌ No lm_logits');
+              // eslint-disable-next-line no-console
+              console.groupEnd();
+            }
             onUpdate === null || onUpdate === void 0 || onUpdate({
               textLength: text.length,
               hasVector: storedContextVector !== null,
               hasLmLogits: storedLmLogits !== null
             });
             // eslint-disable-next-line no-unused-vars
-            _context.next = 33;
+            _context.next = 28;
             break;
-          case 28:
-            _context.prev = 28;
-            _context.t0 = _context["catch"](7);
+          case 23:
+            _context.prev = 23;
+            _context.t0 = _context["catch"](5);
             storedContextVector = null;
             storedLmLogits = null;
-            // eslint-disable-next-line no-console
-            console.log('%c[SlowLane] %c❌ Network error — context cleared', 'color: #9c27b0; font-weight: bold;', 'color: #f44336;');
-          case 33:
+            if (isAutocompleteDebugEnabled()) {
+              // eslint-disable-next-line no-console
+              console.log('%c[SlowLane] %c❌ Network error — context cleared', 'color: #9c27b0; font-weight: bold;', 'color: #f44336;');
+            }
+          case 28:
           case "end":
             return _context.stop();
         }
-      }, _callee, null, [[7, 28]]);
+      }, _callee, null, [[5, 23]]);
     }));
     return function doUpdateContext(_x) {
       return _ref.apply(this, arguments);

package/dist/esm/pm-plugins/text-predictor.js

@@ -29,6 +29,7 @@ import l3VocabularyData from './data/l3_vocabulary.json';
 import vocabularyData from './data/vocabulary_10k.json';
 import wordIndexData from './data/word_index_10k.json';
 // import { rankCandidates, isGrammarAllowed } from './scoring-pipeline';
+import { isAutocompleteDebugEnabled } from './debug-mode';
 import { rankCandidates, STAGE1_WEIGHT, STAGE2_WEIGHT, MIN_STAGE1_SCORE } from './scoring-pipeline';
 import { getStoredContextVector, getStoredLmLogits } from './slow-lane-client';
 
@@ -223,7 +224,7 @@ export var initL3Vocabulary = function initL3Vocabulary(l3Words) {
   } finally {
     _iterator5.f();
   }
-  if (debugMode) {
+  if (isAutocompleteDebugEnabled()) {
     // eslint-disable-next-line no-console
     console.log("[text-predictor] L3 General English loaded: ".concat(l3Words.length, " words"));
   }
@@ -236,9 +237,7 @@ export var initL3Vocabulary = function initL3Vocabulary(l3Words) {
 var isInitialized = false;
 var vectorStore = null;
 var vectorsLoadStarted = false;
-var debugMode = true;
 var lastPredictionDebug = null;
-var hasLoggedSemanticActive = false;
 
 /** Get vector for a word from the store. */
 var getWordVector = function getWordVector(word) {
@@ -344,25 +343,12 @@ var extractPreviousWord = function extractPreviousWord(text) {
 
 // ─── Debug Helpers ───────────────────────────────────────────────────────────
 
-/** Enable or disable debug logging. Also checks localStorage key `autocomplete-debug`. */
-export var setDebugMode = function setDebugMode(enabled) {
-  debugMode = enabled;
-};
-
-/** Check localStorage for autocomplete-debug on first access. */
-var ensureDebugModeFromStorage = function ensureDebugModeFromStorage() {
-  if (typeof localStorage !== 'undefined' && localStorage.getItem('autocomplete-debug') === '1') {
-    debugMode = true;
-  }
-};
-
 /**
  * Get predictor status for debugging.
  * vectorsLoaded: true when semantic scoring is active
  * wordCount: number of words in vector store (0 if not loaded)
  */
 export var getPredictorStatus = function getPredictorStatus() {
-  ensureDebugModeFromStorage();
   return {
     vectorsLoaded: vectorStore !== null,
     wordCount: vectorStore ? Object.keys(vectorStore.wordIndex).length : 0,
@@ -376,7 +362,6 @@ export var getPredictorStatus = function getPredictorStatus() {
  * Returns null if no prediction has run yet or debug was off.
  */
 export var getLastPredictionDebug = function getLastPredictionDebug() {
-  ensureDebugModeFromStorage();
   return lastPredictionDebug;
 };
 export var initVocabulary = function initVocabulary(vocabulary) {
@@ -435,7 +420,7 @@ export var ingestDocumentPage = function ingestDocumentPage(pageContent) {
   } finally {
     _iterator9.f();
   }
-  if (debugMode && validBoostedWords.size > 0) {
+  if (isAutocompleteDebugEnabled() && validBoostedWords.size > 0) {
     // eslint-disable-next-line no-console
     console.groupCollapsed("%c[L1 Session] %cPrimed ".concat(validBoostedWords.size, " valid dictionary words from page"), 'color: #00b8d9; font-weight: bold;', 'color: inherit; font-style: italic;');
     // eslint-disable-next-line no-console
@@ -445,7 +430,6 @@ export var ingestDocumentPage = function ingestDocumentPage(pageContent) {
   }
 };
 export var predict = function predict(textBefore) {
-  ensureDebugModeFromStorage();
   if (!isInitialized) {
     loadDefaultVocabulary();
   }
@@ -538,7 +522,7 @@ export var predict = function predict(textBefore) {
   var lmLogits = getStoredLmLogits();
 
   // Raw LM Output Logger
-  if (debugMode && lmLogits && Object.keys(lmLogits).length > 0) {
+  if (isAutocompleteDebugEnabled() && lmLogits && Object.keys(lmLogits).length > 0) {
     var rawLmTop = Object.entries(lmLogits).sort(function (a, b) {
       return b[1] - a[1];
     }).slice(0, 5).map(function (_ref) {
@@ -554,9 +538,6 @@ export var predict = function predict(textBefore) {
     console.log('%c[Raw LM Prediction]🧠', 'color: #e83e8c; font-weight: bold;', rawLmTop);
   }
   var mode = contextVector ? 'warm' : 'cold';
-  if (debugMode && contextVector && !hasLoggedSemanticActive) {
-    hasLoggedSemanticActive = true;
-  }
 
   // Build ScoringCandidate array from TrieNodes
   var scoringCandidates = candidates.map(function (_ref3) {
@@ -587,7 +568,7 @@ export var predict = function predict(textBefore) {
     pipelineDebug = _rankCandidates.pipelineDebug;
   var best = ranked[0];
   var suggestion = best && best.finalScore >= MIN_SCORE_THRESHOLD ? best.word.slice(currentWord.length) : null;
-  if (debugMode) {
+  if (isAutocompleteDebugEnabled()) {
     var latencyMs = performance.now() - t0;
     var tokens = tokenize(trimmed);
     var contextWords = tokens.slice(-CONTEXT_WORDS);
@@ -767,8 +748,7 @@ export var loadVectorsAsync = /*#__PURE__*/function () {
             wordIndex: wordIndex,
             dim: dim
           };
-          ensureDebugModeFromStorage();
-          if (debugMode) {
+          if (isAutocompleteDebugEnabled()) {
             // eslint-disable-next-line no-console
             console.log('[text-predictor] Vectors loaded:', {
               wordCount: nWords,
@@ -776,19 +756,19 @@ export var loadVectorsAsync = /*#__PURE__*/function () {
               sizeBytes: float32.byteLength
             });
           }
-          _context.next = 41;
+          _context.next = 40;
           break;
-        case 37:
-          _context.prev = 37;
+        case 36:
+          _context.prev = 36;
           _context.t1 = _context["catch"](17);
           vectorsLoadStarted = false;
           // eslint-disable-next-line no-console
           console.warn('[text-predictor] Failed to load vectors:', _context.t1);
-        case 41:
+        case 40:
         case "end":
           return _context.stop();
       }
-    }, _callee, null, [[6, 12], [17, 37]]);
+    }, _callee, null, [[6, 12], [17, 36]]);
   }));
   return function loadVectorsAsync(_x) {
     return _ref6.apply(this, arguments);

package/dist/types/autocompletePluginType.d.ts

@@ -1,6 +1,8 @@
-import type { NextEditorPlugin } from '@atlaskit/editor-common/types';
+import type { NextEditorPlugin, OptionalPlugin } from '@atlaskit/editor-common/types';
+import type { AnalyticsPlugin } from '@atlaskit/editor-plugin-analytics';
 import type { AutocompletePluginOptions, AutocompletePluginState } from './pm-plugins/autocomplete-plugin';
 export type AutocompletePlugin = NextEditorPlugin<'autocomplete', {
     pluginConfiguration?: AutocompletePluginOptions | undefined;
     sharedState: AutocompletePluginState | undefined;
+    dependencies: [OptionalPlugin<AnalyticsPlugin>];
 }>;

package/dist/types/pm-plugins/autocomplete-plugin.d.ts

@@ -1,7 +1,9 @@
 import { SafePlugin } from '@atlaskit/editor-common/safe-plugin';
+import type { ExtractInjectionAPI } from '@atlaskit/editor-common/types';
 import { PluginKey } from '@atlaskit/editor-prosemirror/state';
 import { DecorationSet } from '@atlaskit/editor-prosemirror/view';
-export declare const autocompletePluginKey: PluginKey<any>;
+import type { AutocompletePlugin } from '../autocompletePluginType';
+export declare const autocompletePluginKey: PluginKey;
 export interface AutocompletePluginState {
     /** The decoration set containing the ghost text widget */
     decorationSet: DecorationSet;
@@ -39,4 +41,4 @@ export interface AutocompletePluginOptions {
      */
     getVectorsBinaryUrl?: () => Promise<string>;
 }
-export declare const createAutocompletePlugin: (options?: AutocompletePluginOptions) => SafePlugin<AutocompletePluginState>;
+export declare const createAutocompletePlugin: (options?: AutocompletePluginOptions, api?: ExtractInjectionAPI<AutocompletePlugin>) => SafePlugin<AutocompletePluginState>;

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

@@ -0,0 +1,12 @@
+/**
+ * Contextual Typeahead Completions (CTC) debug logging utility.
+ *
+ * Logs are silent by default. To enable in any environment (dev, staging, prod):
+ *
+ *   localStorage.setItem('atl-ctc-dbg', '1')
+ *
+ * Then reload the page. To disable:
+ *
+ *   localStorage.removeItem('atl-ctc-dbg')
+ */
+export declare const isAutocompleteDebugEnabled: () => boolean;