@atlaskit/editor-plugin-autocomplete 3.6.1 → 4.0.0

package/CANONICAL_FIX__DO_NOT_USE_ME_A/package.json

@@ -4,12 +4,5 @@
   "module": "../dist/esm/pm-plugins/autocomplete-plugin.js",
   "module:es2019": "../dist/es2019/pm-plugins/autocomplete-plugin.js",
   "sideEffects": false,
-  "types": "../dist/types/pm-plugins/autocomplete-plugin.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/pm-plugins/autocomplete-plugin.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/pm-plugins/autocomplete-plugin.d.ts"
 }

package/CANONICAL_FIX__DO_NOT_USE_ME_B/package.json

@@ -4,12 +4,5 @@
   "module": "../dist/esm/pm-plugins/slow-lane-client.js",
   "module:es2019": "../dist/es2019/pm-plugins/slow-lane-client.js",
   "sideEffects": false,
-  "types": "../dist/types/pm-plugins/slow-lane-client.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/pm-plugins/slow-lane-client.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/pm-plugins/slow-lane-client.d.ts"
 }

package/CANONICAL_FIX__DO_NOT_USE_ME_C/package.json

@@ -4,12 +4,5 @@
   "module": "../dist/esm/pm-plugins/text-predictor.js",
   "module:es2019": "../dist/es2019/pm-plugins/text-predictor.js",
   "sideEffects": false,
-  "types": "../dist/types/pm-plugins/text-predictor.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/pm-plugins/text-predictor.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/pm-plugins/text-predictor.d.ts"
 }

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @atlaskit/editor-plugin-autocomplete
 
+## 4.0.0
+
+### Major Changes
+
+- [`f2dc9097319f0`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/f2dc9097319f0) - ###
+  Dropped support for _legacy_ Typescript 4 types. **Typescript 5 is now the new minimum**.
+
+  Removes the `typesVersions` property and `dist/types-ts4.5` directory from the dist.
+
+  Types are now exclusively via the `"types": "dist/types/index.d.ts"` property.
+
+  ```diff
+  - "typesVersions": {
+  -    ">=4.5 <4.9": {
+  -        "*": [
+  -            "dist/types-ts4.5/*",
+  -            "dist/types-ts4.5/index.d.ts"
+  -        ]
+  -    }
+  - },
+  ```
+
+### Patch Changes
+
+- [`f92001e22291e`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/f92001e22291e) -
+  Reverts the mid-word cursor suppression for ghost-text suggestions. Autocomplete suggestions will
+  again appear regardless of cursor position within a word.
+- Updated dependencies
+
+## 3.6.2
+
+### Patch Changes
+
+- [`8ed22a585196f`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/8ed22a585196f) -
+  [ux] Fixes a bug where autocomplete suggestions were shown when the cursor was positioned in the
+  middle of an existing word. Suggestions are now suppressed unless the cursor is at the trailing
+  edge of a token.
+- Updated dependencies
+
 ## 3.6.1
 
 ### Patch Changes

package/autocompletePlugin/package.json

@@ -4,12 +4,5 @@
   "module": "../dist/esm/entry-points/autocompletePlugin.js",
   "module:es2019": "../dist/es2019/entry-points/autocompletePlugin.js",
   "sideEffects": false,
-  "types": "../dist/types/entry-points/autocompletePlugin.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/entry-points/autocompletePlugin.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/entry-points/autocompletePlugin.d.ts"
 }

package/autocompletePluginType/package.json

@@ -4,12 +4,5 @@
   "module": "../dist/esm/entry-points/autocompletePluginType.js",
   "module:es2019": "../dist/es2019/entry-points/autocompletePluginType.js",
   "sideEffects": false,
-  "types": "../dist/types/entry-points/autocompletePluginType.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/entry-points/autocompletePluginType.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/entry-points/autocompletePluginType.d.ts"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-autocomplete",
-	"version": "3.6.1",
+	"version": "4.0.0",
 	"description": "Client-side text autocomplete plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -16,27 +16,19 @@
 	"module": "dist/esm/index.js",
 	"module:es2019": "dist/es2019/index.js",
 	"types": "dist/types/index.d.ts",
-	"typesVersions": {
-		">=4.5 <4.9": {
-			"*": [
-				"dist/types-ts4.5/*",
-				"dist/types-ts4.5/index.d.ts"
-			]
-		}
-	},
 	"sideEffects": false,
 	"atlaskit:src": "src/index.ts",
 	"dependencies": {
-		"@atlaskit/editor-prosemirror": "^7.3.0",
-		"@atlaskit/ufo": "^0.5.0",
+		"@atlaskit/editor-prosemirror": "^8.0.0",
+		"@atlaskit/ufo": "^1.0.0",
 		"@babel/runtime": "^7.0.0",
 		"@mlc-ai/web-llm": "^0.2.78",
 		"compromise": "^14.15.0",
 		"wink-nlp": "^2.4.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^115.15.0",
-		"@atlaskit/editor-plugin-analytics": "^11.0.0",
+		"@atlaskit/editor-common": "^116.0.0",
+		"@atlaskit/editor-plugin-analytics": "^12.0.0",
 		"react": "^18.2.0"
 	},
 	"techstack": {

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

@@ -4,12 +4,5 @@
   "module": "../../../dist/esm/entry-points/src-pm-plugins-autocomplete-plugin.js",
   "module:es2019": "../../../dist/es2019/entry-points/src-pm-plugins-autocomplete-plugin.js",
   "sideEffects": false,
-  "types": "../../../dist/types/entry-points/src-pm-plugins-autocomplete-plugin.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../../../dist/types-ts4.5/entry-points/src-pm-plugins-autocomplete-plugin.d.ts"
-      ]
-    }
-  }
+  "types": "../../../dist/types/entry-points/src-pm-plugins-autocomplete-plugin.d.ts"
 }

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

@@ -680,20 +680,20 @@ export const createAutocompletePlugin = (
 					}
 					return false;
 				},
-			focus: () => {
-				loadDefaultVocabulary({ isLocalLLM: options?.useLocalModel ?? false }).catch((error) => {
-					logException(error as Error, {
-						location: 'editor-plugin-autocomplete/loadDefaultVocabulary',
+				focus: () => {
+					loadDefaultVocabulary({ isLocalLLM: options?.useLocalModel ?? false }).catch((error) => {
+						logException(error as Error, {
+							location: 'editor-plugin-autocomplete/loadDefaultVocabulary',
+						});
 					});
-				});
-				loadVectorsAsync({
-					getBinaryUrl: options?.getVectorsBinaryUrl,
-					isLocalLLM: options?.useLocalModel ?? false,
-				}).catch((error) => {
-					logException(error as Error, {
-						location: 'editor-plugin-autocomplete/loadVectorsAsync',
+					loadVectorsAsync({
+						getBinaryUrl: options?.getVectorsBinaryUrl,
+						isLocalLLM: options?.useLocalModel ?? false,
+					}).catch((error) => {
+						logException(error as Error, {
+							location: 'editor-plugin-autocomplete/loadVectorsAsync',
+						});
 					});
-				});
 					if (!hasIngestedPage) {
 						hasIngestedPage = true;
 						refreshContext({

package/src/pm-plugins/local-slow-lane-client.ts

@@ -367,16 +367,14 @@ let bePayloadDataPromise: Promise<void> | undefined;
  * :param shape: `'object'` if the source JSON is `{...}`, `'array'` if `[...]`.
  * :returns: The parsed JSON value, or `null` if neither interop mode applies.
  */
-const unwrapJsonModule = <T,>(mod: unknown, shape: 'object' | 'array'): T | null => {
+const unwrapJsonModule = <T>(mod: unknown, shape: 'object' | 'array'): T | null => {
 	if (mod == null || typeof mod !== 'object') {
 		return null;
 	}
 	const namespace = mod as Record<string, unknown> & { default?: unknown };
 
 	// Compute the named-export own-keys (strip synthetic markers).
-	const ownKeys = Object.keys(namespace).filter(
-		(k) => k !== 'default' && k !== '__esModule',
-	);
+	const ownKeys = Object.keys(namespace).filter((k) => k !== 'default' && k !== '__esModule');
 
 	// PREFER named exports when present — they always reflect the JSON's real
 	// top-level keys / indices, regardless of what `default` happens to be.
@@ -456,10 +454,7 @@ const loadBePayloadData = (): Promise<void> => {
 			}
 
 			firstTokenToWords = new Map(
-				Object.entries(firstTokenToWordsData).map(([tokenId, words]) => [
-					Number(tokenId),
-					words,
-				]),
+				Object.entries(firstTokenToWordsData).map(([tokenId, words]) => [Number(tokenId), words]),
 			);
 			l2Words = new Set(Object.keys(vocabularyData.words));
 			prefixMapTokenIds = Array.from(firstTokenToWords.keys());
@@ -519,7 +514,6 @@ export const computeBePayload = (
 	 */
 	validTokenIds: number[] = prefixMapTokenIds,
 ): Record<string, number> => {
-
 	// 1. Numerically-stable masked softmax over validTokenIds only.
 	let maxLogit = -Infinity;
 	for (const id of validTokenIds) {
@@ -1006,7 +1000,7 @@ export const createLocalSlowLaneClient = (
 		const lmText = truncateToLastNWords(text, BE_PARITY.MAX_CONTEXT_TOKENS);
 		const semanticText = truncateToLastNWords(text, BE_PARITY.MAX_CONTEXT_WORDS);
 		const arcticInput = wrapForArctic(semanticText);
-		const captureCompletionTime = <T,>(
+		const captureCompletionTime = <T>(
 			promise: Promise<T>,
 			onResolved: (resolvedAt: number) => void,
 		): Promise<T> =>
@@ -1043,8 +1037,7 @@ export const createLocalSlowLaneClient = (
 						max_tokens: 1,
 						temperature: 0,
 						logprobs: false,
-					})
-					,
+					}),
 					(resolvedAt) => {
 						tLmDone = resolvedAt;
 					},
@@ -1053,8 +1046,7 @@ export const createLocalSlowLaneClient = (
 					engine.embeddings.create({
 						model: LOCAL_MLC_EMBEDDING_MODEL_ID,
 						input: arcticInput,
-					})
-					,
+					}),
 					(resolvedAt) => {
 						tEmbDone = resolvedAt;
 					},

package/src/pm-plugins/slow-lane-client/package.json

@@ -4,12 +4,5 @@
   "module": "../../../dist/esm/entry-points/src-pm-plugins-slow-lane-client.js",
   "module:es2019": "../../../dist/es2019/entry-points/src-pm-plugins-slow-lane-client.js",
   "sideEffects": false,
-  "types": "../../../dist/types/entry-points/src-pm-plugins-slow-lane-client.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../../../dist/types-ts4.5/entry-points/src-pm-plugins-slow-lane-client.d.ts"
-      ]
-    }
-  }
+  "types": "../../../dist/types/entry-points/src-pm-plugins-slow-lane-client.d.ts"
 }

package/src/pm-plugins/text-predictor/package.json

@@ -4,12 +4,5 @@
   "module": "../../../dist/esm/entry-points/src-pm-plugins-text-predictor.js",
   "module:es2019": "../../../dist/es2019/entry-points/src-pm-plugins-text-predictor.js",
   "sideEffects": false,
-  "types": "../../../dist/types/entry-points/src-pm-plugins-text-predictor.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../../../dist/types-ts4.5/entry-points/src-pm-plugins-text-predictor.d.ts"
-      ]
-    }
-  }
+  "types": "../../../dist/types/entry-points/src-pm-plugins-text-predictor.d.ts"
 }

package/src/pm-plugins/text-predictor.ts

@@ -889,7 +889,10 @@ export const loadDefaultVocabulary = (options?: { isLocalLLM?: boolean }): Promi
 				l3WordCount: l3VocabularyData.length,
 			});
 		} catch (e) {
-			failExp(EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', { isLocalLLM, errorType: 'parse_error' });
+			failExp(EXPERIENCE_NAME.LOAD_VOCABULARY, 'singleton', {
+				isLocalLLM,
+				errorType: 'parse_error',
+			});
 			// Allow a later call to retry the load rather than caching the failure.
 			vocabularyLoadPromise = undefined;
 			throw e;

package/dist/types-ts4.5/analytics/ufo.d.ts

@@ -1,38 +0,0 @@
-/**
- * UFO experience tracking helpers for `@atlaskit/editor-plugin-autocomplete`.
- *
- * Pattern follows `packages/linking-platform/smart-card/src/state/analytics/ufoExperiences.ts`
- * (ConcurrentExperience keyed per request/instance) plus a try/catch safety wrap
- * inspired by `packages/editor/collab-provider/src/analytics/ufo.ts` so a UFO
- * runtime error can never break the autocomplete feature.
- *
- * Experience names must be registered in DataPortal's `task` attribute before
- * they can power FE Reliability SLOs:
- * https://hello.atlassian.net/wiki/spaces/AA6/pages/3961393753
- */
-import { type CustomData } from '@atlaskit/ufo';
-/**
- * Experience name strings are surfaced downstream by the UFO pipeline as
- * `platform.fe.<type>.<platform.component>.<name>` (e.g.
- * `platform.fe.operation.editor-plugin-autocomplete.slow-lane-fetch`), so
- * names here should be short, dot-free, and must not repeat the component
- * name. This matches the convention used by `@atlaskit/emoji`'s
- * `ufoExperiences` map (e.g. `'emoji-rendered'`).
- */
-/**
- * Only experiences with meaningful async work and a real success/failure
- * outcome belong on UFO (which measures latency and success rate for FE
- * Reliability SLOs). Per-keystroke suggestion lifecycle counters (viewed /
- * inserted / dismissed) are tracked via analytics-next instead — they would
- * otherwise emit zero-duration events on every word boundary.
- */
-export declare const EXPERIENCE_NAME: {
-    readonly SLOW_LANE_FETCH: "slow-lane-fetch";
-    readonly LOAD_VOCABULARY: "load-vocabulary";
-    readonly LOAD_VECTORS: "load-vectors";
-};
-export type AutocompleteExperienceName = (typeof EXPERIENCE_NAME)[keyof typeof EXPERIENCE_NAME];
-export declare const startExp: (name: AutocompleteExperienceName, id: string, metadata?: CustomData) => void;
-export declare const succeedExp: (name: AutocompleteExperienceName, id: string, metadata?: CustomData) => void;
-export declare const failExp: (name: AutocompleteExperienceName, id: string, metadata?: CustomData) => void;
-export declare const abortExp: (name: AutocompleteExperienceName, id: string, reason?: string) => void;

package/dist/types-ts4.5/autocompletePlugin.d.ts

@@ -1,2 +0,0 @@
-import type { AutocompletePlugin } from './autocompletePluginType';
-export declare const autocompletePlugin: AutocompletePlugin;

package/dist/types-ts4.5/autocompletePluginType.d.ts

@@ -1,10 +0,0 @@
-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-ts4.5/entry-points/autocompletePlugin.d.ts

@@ -1 +0,0 @@
-export { autocompletePlugin } from '../autocompletePlugin';

package/dist/types-ts4.5/entry-points/autocompletePluginType.d.ts

@@ -1 +0,0 @@
-export type { AutocompletePlugin } from '../autocompletePluginType';

package/dist/types-ts4.5/entry-points/src-pm-plugins-autocomplete-plugin.d.ts

@@ -1,2 +0,0 @@
-export { autocompletePluginKey, createAutocompletePlugin } from '../pm-plugins/autocomplete-plugin';
-export type { AutocompleteContext, AutocompletePluginOptions, AutocompletePluginState, } from '../pm-plugins/autocomplete-plugin';

package/dist/types-ts4.5/entry-points/src-pm-plugins-slow-lane-client.d.ts

@@ -1,2 +0,0 @@
-export { createSlowLaneClient, getStoredContextVector, getStoredLmLogits, isWordBoundary, setDefaultSlowLaneClient, } from '../pm-plugins/slow-lane-client';
-export type { SlowLaneClientConfig, TypeaheadEncodingsRequest, TypeaheadEncodingsResponse, } from '../pm-plugins/slow-lane-client';

package/dist/types-ts4.5/entry-points/src-pm-plugins-text-predictor.d.ts

@@ -1,2 +0,0 @@
-export { getLastPredictionDebug, getPredictorStatus, incrementSessionFreq, ingestDocumentPage, initL3Vocabulary, initVectors, initVocabulary, loadDefaultVocabulary, loadVectorsAsync, predict, } from '../pm-plugins/text-predictor';
-export type { TenantVocabulary, WeightedTerm } from '../pm-plugins/text-predictor';

package/dist/types-ts4.5/index.d.ts

@@ -1,2 +0,0 @@
-export { autocompletePlugin } from './autocompletePlugin';
-export type { AutocompletePlugin } from './autocompletePluginType';

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

@@ -1,49 +0,0 @@
-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';
-import type { AutocompletePlugin } from '../autocompletePluginType';
-export declare const autocompletePluginKey: PluginKey;
-export interface AutocompletePluginState {
-    /** The decoration set containing the ghost text widget */
-    decorationSet: DecorationSet;
-    /** The document position where the ghost text should appear */
-    ghostPosition: number;
-    /** The predicted ghost text to display */
-    ghostText: string;
-}
-/**
- * Context provided to the autocomplete plugin on first editor focus.
- * Text fields are selectively ingested to boost word-frequency scoring for
- * predictions, giving words already present in the document/thread an L1
- * priority boost.
- */
-export interface AutocompleteContext {
-    /** Full page content as a string (e.g. markdown). */
-    fullPageContent?: string;
-    /** The currently selected text on the page, if any. */
-    pageSelectionContent?: string;
-    /** Content of the parent comment when the editor is in reply or edit mode. */
-    parentCommentContent?: string;
-    /** Contents of sibling comments when the editor is in reply or edit mode. */
-    siblingCommentsContents?: string[];
-}
-export interface AutocompletePluginOptions {
-    /**
-     * Async function called once on first editor focus to retrieve context for
-     * word-frequency boosting. Called lazily so the preset can remain synchronous.
-     */
-    getContext?: () => Promise<AutocompleteContext | undefined>;
-    /**
-     * Async function that resolves to a URL for the word vectors binary file.
-     * When provided, this takes precedence over the bundled asset URL.
-     * Use this to serve vectors from a CDN or media service in production.
-     */
-    getVectorsBinaryUrl?: () => Promise<string>;
-    /**
-     * When true, uses on-device inference via WebGPU (MLC WebLLM) instead of
-     * the network-based slow-lane backend. Defaults to false (network client).
-     */
-    useLocalModel?: boolean;
-}
-export declare const createAutocompletePlugin: (options?: AutocompletePluginOptions, api?: ExtractInjectionAPI<AutocompletePlugin>) => SafePlugin<AutocompletePluginState>;

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

@@ -1,27 +0,0 @@
-/**
- * Contextual Typeahead Completions (CTC) debug logging utility.
- *
- * Logs are silent by default. Enable in any environment (dev, staging, prod):
- *
- *   // Live, for the current session (no reload required):
- *   __atlCtcDebug__.enable()
- *
- *   // To disable:
- *   __atlCtcDebug__.disable()
- *
- *   // 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/ghost-text-decoration.d.ts

@@ -1,7 +0,0 @@
-import type { EditorState } from '@atlaskit/editor-prosemirror/state';
-import { DecorationSet } from '@atlaskit/editor-prosemirror/view';
-/**
- * Creates a DecorationSet containing a ghost text widget at the given position.
- * The ghost text is rendered as a styled <span> that appears after the cursor.
- */
-export declare const createGhostTextDecorationSet: (state: EditorState, position: number, text: string) => DecorationSet;

package/dist/types-ts4.5/pm-plugins/local-slow-lane-client.d.ts

@@ -1,241 +0,0 @@
-/**
- * Local Slow Lane Client: On-device inference via @mlc-ai/web-llm.
- *
- * Drop-in replacement for the network-based slow-lane-client. Instead of calling
- * a backend API, this client runs two models in the browser via WebGPU, in a
- * single MLCEngine, to reproduce the BE encoder's outputs on-device:
- *
- *   - Causal LM (SmolLM2-135M-Instruct): one decode step per word boundary. A
- *     registered LogitProcessor captures the raw next-token logits, which
- *     `computeBePayload` turns into a whole-word `lm_logits` payload — a faithful
- *     port of the BE `CausalLMEncoder._get_top_k_probs` (masked softmax over the
- *     vocab's first-tokens, prefix expansion, L2 reservation, log-space pooling).
- *   - Semantic embedder (Snowflake Arctic Embed S): produces the real 384-d
- *     `semantic_vector`. Inputs are wrapped as passages (see `wrapForArctic`) so
- *     the runtime vector lands in the same space as the precomputed word bin.
- *
- * ── Why main thread (no Web Worker)? ─────────────────────────────────────
- * The models are small enough (~640 MB combined VRAM) that WebGPU inference on
- * the main thread is viable:
- *
- *   - WebGPU GPU compute is inherently async (doesn't block the main thread)
- *   - CPU overhead (BE-parity post-processing) is a few ms
- *   - Per-inference latency is well within autocomplete expectations
- *     (~250 ms between word boundaries)
- *
- * This avoids all the complexity of Web Workers:
- *   - No CSP workarounds (blob URLs, inline scripts)
- *   - No bundler configuration (worker-plugin, import.meta.url)
- *   - No message passing protocol
- *   - Standard npm import — just works
- *
- * ── Interface ────────────────────────────────────────────────────────────
- * Same shape as createSlowLaneClient so text-predictor.ts needs zero changes.
- * The client exposes getContextVector() and getLmLogits() which are populated
- * asynchronously after each updateContext() call.
- */
-export interface LocalSlowLaneClientConfig {
-    /**
-     * Optional custom model registration for models not in web-llm's
-     * built-in list. When provided, the model is appended to the app
-     * config before engine creation.
-     */
-    customModelConfig?: {
-        /** Context window size override (optional) */
-        contextWindowSize?: number;
-        /** HuggingFace URL to the model weights (e.g. "https://huggingface.co/HuggingFaceTB/smollm-135M-instruct-add-basics-q0f16-MLC") */
-        model: string;
-        /** URL to the compiled WASM library for this model architecture */
-        modelLib: string;
-        /** VRAM required in MB (optional, for resource planning) */
-        vramRequiredMB?: number;
-    };
-    /** Debounce interval in ms before sending context for inference. */
-    debounceMs?: number;
-    /**
-     * MLC model identifier.
-     * Defaults to the built-in SmolLM2-135M-Instruct-q0f16-MLC.
-     *
-     * To use a custom HuggingFace model, provide both `modelId` and
-     * `customModelConfig` with the model URL and WASM library URL.
-     */
-    modelId?: string;
-    /** Callback fired when the engine fails to load/start. */
-    onLoadError?: (error: LocalSlowLaneLoadError) => void;
-    /** Callback fired when the engine successfully loads and is ready. */
-    onLoadSuccess?: (info: LocalSlowLaneLoadSuccess) => void;
-    /** Callback fired with status messages (model loading progress, etc.). */
-    onStatus?: (message: string) => void;
-    /** Callback fired when inference returns new results. */
-    onUpdate?: (opts: {
-        hasLmLogits: boolean;
-        hasVector: boolean;
-        textLength: number;
-    }) => void;
-}
-export interface LocalSlowLaneClient {
-    /** Clean up resources. */
-    destroy: () => void;
-    getContextVector: () => Float32Array | null;
-    getLmLogits: () => Record<string, number> | null;
-    /** Whether the model is loaded and ready for inference. */
-    isReady: () => boolean;
-    isWordBoundary: (text: string) => boolean;
-    setContextVector: (vector: Float32Array | null) => void;
-    setLmLogits: (logits: Record<string, number> | null) => void;
-    updateContext: (text: string) => void;
-}
-/**
- * Why the local engine failed to load/start.
- *
- * The first three are user-machine limitations (WebGPU missing, no compatible
- * GPU adapter, GPU lacks the `shader-f16` feature the model needs);
- * `insufficient_memory` is hit when weights don't fit in VRAM. The rest cover
- * delivery/runtime failures unrelated to hardware.
- */
-export type LocalSlowLaneLoadErrorReason = 'webgpu_unavailable' | 'webgpu_no_adapter' | 'missing_shader_f16' | 'insufficient_memory' | 'model_download_failed' | 'module_load_failed' | 'init_failed';
-/** Snapshot of the machine's WebGPU support, used to explain hardware limits. */
-export interface WebGpuCapabilities {
-    /** Whether `navigator.gpu.requestAdapter()` returned a usable adapter. */
-    adapterAvailable?: boolean;
-    /** GPU architecture reported by the adapter (e.g. "metal-3", "rdna2"). */
-    architecture?: string;
-    /** Whether `navigator.gpu` exists at all. */
-    available: boolean;
-    /** Largest single GPU buffer the adapter allows, in MB. */
-    maxBufferSizeMB?: number;
-    /** Largest storage-buffer binding the adapter allows, in MB. */
-    maxStorageBufferBindingSizeMB?: number;
-    /** Whether the adapter exposes the `shader-f16` feature the model requires. */
-    shaderF16Supported?: boolean;
-    /** GPU vendor reported by the adapter (e.g. "apple", "intel"). */
-    vendor?: string;
-}
-export interface LocalSlowLaneLoadError {
-    /** WebGPU support snapshot — explains hardware limitations behind the failure. */
-    capabilities: WebGpuCapabilities;
-    /** Semantic embedder loaded alongside the causal LM (loads atomically). */
-    embeddingModelId: string;
-    /** Canonical, controlled failure description (never raw error text). */
-    message: string;
-    /** Causal LM identifier that failed to load. */
-    modelId: string;
-    /** Coarse, privacy-safe failure category. */
-    reason: LocalSlowLaneLoadErrorReason;
-}
-export interface LocalSlowLaneLoadSuccess {
-    /** WebGPU support snapshot for the machine that loaded the model. */
-    capabilities: WebGpuCapabilities;
-    /** Semantic embedder loaded alongside the causal LM (loads atomically). */
-    embeddingModelId: string;
-    /** Model engine load time in ms (excludes the WebGPU capability probe). */
-    loadDurationMs: number;
-    /** Causal LM identifier that loaded. */
-    modelId: string;
-}
-export declare const LOCAL_MLC_CAUSAL_MODEL_ID = "SmolLM2-135M-Instruct-q0f16-MLC";
-/**
- * MLC ID for the semantic embedder (Snowflake Arctic Embed S, batch=4 variant).
- *
- * The `-b4` suffix selects the prebuilt variant compiled for a max batch size of
- * 4 (≈239 MB VRAM) rather than `-b32` (≈1023 MB VRAM). Autocomplete embeds one
- * context at a time, so `-b4` is the right fit. This model IS in
- * `prebuiltAppConfig.model_list` of web-llm 0.2.82 — no `customModelConfig` needed.
- */
-export declare const LOCAL_MLC_EMBEDDING_MODEL_ID = "snowflake-arctic-embed-s-q0f32-MLC-b4";
-/**
- * Wrap raw context text with BERT special tokens before embedding.
- *
- * web-llm's `EmbeddingPipeline` does NOT auto-prepend `[CLS]` / append `[SEP]`
- * (the official MLC embeddings example wraps manually). The Python
- * `sentence_transformers` side that generated the word-vector bin adds these
- * inside `model.encode()`, so we must mirror it here for the runtime context
- * vector to land in the same region of Arctic's embedding space as the bin.
- *
- * No query prefix is applied: the semantic step is sentence-to-sentence (`s2s`)
- * similarity ("which words are conceptually similar to this context?"), not
- * sentence-to-passage (`s2p`) retrieval. Arctic's query prefix would misframe
- * the relationship. Encode both sides as passages. See implementation.md §4.3.
- */
-export declare const wrapForArctic: (text: string) => string;
-/**
- * BE-parity constants — must match `CausalLMEncoder` defaults in the Python
- * sidecar (`cc-smarts/python-sidecar/src/causal_lm_encoder.py`) and
- * `SlowLaneEngine` (`typeahead_context_encoding.py`) so local payloads behave
- * identically to the server-client setup.
- */
-export declare const BE_PARITY: {
-    /** Final payload size cap (BE: `top_k_words`). */
-    readonly TOP_K_WORDS: 2000;
-    /** L2 (domain) words admitted unconditionally before pooling (BE: `reserved_l2_slots`). */
-    readonly RESERVED_L2_SLOTS: 500;
-    /** Log-space additive bias favouring L2 over L3 in the pool (BE: `l2_bias`). */
-    readonly L2_BIAS: 1;
-    /** Drop words below this probability from the final payload (BE: `> 0.00001`). */
-    readonly MIN_PROB: 0.00001;
-    /**
-     * Word-level approximation of the BE causal LM token limit.
-     *
-     * BE: `CausalLMEncoder.max_context_tokens = 100` (BPE tokens, left-truncated).
-     * FE: no tokenizer available, so we approximate with word count. English text
-     * averages ~1.3–1.5 BPE tokens/word, meaning 100 words ≈ 130–150 tokens.
-     * Using 100 words keeps the approximation simple and errs on the side of
-     * sending slightly more context than the BE sees — acceptable for a PoC.
-     */
-    readonly MAX_CONTEXT_TOKENS: 100;
-    /**
-     * Word-level rolling window for the semantic embedder.
-     *
-     * BE: `SlowLaneEngine.max_context_words = 100` (applied in
-     * `typeahead_context_encoding.py` before calling `SemanticEncoder.encode`).
-     * Truncated identically here so the runtime Arctic vector lands in the same
-     * region of the embedding space as the precomputed word-vector bin.
-     */
-    readonly MAX_CONTEXT_WORDS: 100;
-};
-/**
- * Convert a raw next-token logit vector into a whole-word probability payload,
- * faithfully porting the BE `CausalLMEncoder._get_top_k_probs`
- * (`cc-smarts/python-sidecar/src/causal_lm_encoder.py`).
- *
- * Steps: (1) numerically-stable masked softmax over only the token ids present
- * in the prefix-expansion map; (2) spread each token's probability to every
- * whole word sharing that first token, taking the max; (3) reserve the top L2
- * words unconditionally; (4) rank the remainder in a log-space pool with an
- * additive L2 bias; (5) emit raw probabilities for the survivors, lowercased
- * and trimmed at `MIN_PROB`.
- *
- * :params:
- *   rawLogits: Full-vocabulary logits from the LM's single decode step
- *   prefixMap: Map of first-token id to the words starting with that token
- *   domainWords: Set of L2 (domain) words, for tier-aware ranking
- * :returns:
- *   A record of lowercase word to probability — the BE `lm_logits` payload
- */
-export declare const computeBePayload: (rawLogits: Float32Array, prefixMap: Map<number, string[]>, domainWords: Set<string>, 
-/**
- * Pre-derived token-ID array for the softmax mask. Defaults to the
- * module-level `prefixMapTokenIds` (zero allocation in production). Pass
- * `Array.from(prefixMap.keys())` in tests that supply a custom prefixMap so
- * the softmax mask stays consistent with the iteration in Step 2.
- */
-validTokenIds?: number[]) => Record<string, number>;
-/**
- * Create a local slow-lane client powered by MLC WebLLM.
- *
- * The engine is initialised lazily — model weights are downloaded (and cached
- * in IndexedDB) on first use. Subsequent page loads skip the download.
- *
- * Usage:
- * ```ts
- * const client = createLocalSlowLaneClient({ debounceMs: 300 });
- * // On word boundaries:
- * client.updateContext(docText);
- * // In scoring pipeline:
- * const vec = client.getContextVector();
- * const logits = client.getLmLogits();
- * // On plugin teardown:
- * client.destroy();
- * ```
- */
-export declare const createLocalSlowLaneClient: (config?: LocalSlowLaneClientConfig) => LocalSlowLaneClient;

package/dist/types-ts4.5/pm-plugins/scoring-pipeline.d.ts

@@ -1,43 +0,0 @@
-/**
- * Scoring Pipeline: Stage 1 (Semantic + Frequency), Grammar Filter, Stage 2 (LM Re-ranking).
- *
- * Operates synchronously on pre-loaded data. Each stage gracefully degrades
- * when its required data isn't available (cold → warm → full warm).
- */
-export interface ScoringCandidate {
-    authorFreq: number;
-    docFreq: number;
-    sessionFreq: number;
-    tenantFreq: number;
-    word: string;
-}
-export interface ScoredCandidate {
-    finalScore: number;
-    freqScore: number;
-    lmScore: number;
-    semanticScore: number;
-    word: string;
-}
-/** Metadata returned by the grammar filter for debug logging in the caller. */
-export interface GrammarFilterMeta {
-    after: number;
-    before: number;
-    dropped: string[];
-    prevTags: string[];
-    prevWord: string;
-}
-export declare const STAGE1_WEIGHT = 0.35;
-export declare const STAGE2_WEIGHT = 0.65;
-export declare const MIN_STAGE1_SCORE = 0.35;
-export interface PipelineDebug {
-    final: number;
-    grammarRejected: string[];
-    initial: number;
-    stage1Rejected: string[];
-}
-export interface RankCandidatesResult {
-    candidates: ScoredCandidate[];
-    grammarMeta: GrammarFilterMeta | null;
-    pipelineDebug: PipelineDebug;
-}
-export declare function rankCandidates(candidates: ScoringCandidate[], contextVector: Float32Array | null, getWordVector: (word: string) => Float32Array | null, lmLogits: Record<string, number> | null, maxTenantFreq: number, previousWord: string): RankCandidatesResult;

package/dist/types-ts4.5/pm-plugins/slow-lane-client.d.ts

@@ -1,46 +0,0 @@
-/**
- * Slow Lane Client: Backend context encoding for autocomplete.
- *
- * Fires a BE request on word boundaries to encode document context.
- * Expects the typeahead-encodings API format:
- *   Request:  { text, session_id }
- *   Response: { semantic_vector: number[], lm_logits: Record<string, number> }
- */
-/** Request payload for typeahead-encodings endpoint. */
-export interface TypeaheadEncodingsRequest {
-    session_id: string;
-    text: string;
-}
-/** Response from typeahead-encodings endpoint. */
-export interface TypeaheadEncodingsResponse {
-    lm_logits: Record<string, number>;
-    semantic_vector: number[];
-}
-/**
- * Check if text ends with a word boundary character (space or punctuation).
- */
-export declare const isWordBoundary: (text: string) => boolean;
-export interface SlowLaneClientConfig {
-    baseUrl: string;
-    debounceMs?: number;
-    endpoint?: string;
-    fetchFn?: typeof fetch;
-    onUpdate?: (opts: {
-        hasLmLogits: boolean;
-        hasVector: boolean;
-        textLength: number;
-    }) => void;
-    productKey?: string;
-    sessionId?: string;
-}
-export declare const createSlowLaneClient: (config: SlowLaneClientConfig) => {
-    getContextVector: () => Float32Array | null;
-    getLmLogits: () => Record<string, number> | null;
-    isWordBoundary: (text: string) => boolean;
-    setContextVector: (vector: Float32Array | null) => void;
-    setLmLogits: (logits: Record<string, number> | null) => void;
-    updateContext: (text: string) => void;
-};
-export declare const setDefaultSlowLaneClient: (client: ReturnType<typeof createSlowLaneClient> | null) => void;
-export declare const getStoredContextVector: () => Float32Array | null;
-export declare const getStoredLmLogits: () => Record<string, number> | null;

package/dist/types-ts4.5/pm-plugins/text-predictor.d.ts

@@ -1,91 +0,0 @@
-/**
- * Fast Lane Predictor: Local autocomplete using weighted trie + frequency + semantic scoring.
- *
- * Two prediction modes:
- *   1. Word boundary → bigram-based next-word suggestion (grammar-filtered)
- *   2. Mid-word (≥3 chars) → trie prefix search → scoring pipeline → top result
- *
- * Scoring is delegated to scoring-pipeline.ts which handles:
- *   Stage 1 (semantic + frequency), grammar filter, Stage 2 (optional LM re-ranking).
- *
- * Context vector: average of word vectors from text before cursor (last N words).
- * Falls back to cold mode (freq-only) when vectors not yet loaded.
- *
- * Session personalization (L1): words the user types are incrementally boosted
- * via incrementSessionFreq(), called on word boundaries from the plugin.
- */
-export interface WeightedTerm {
-    authorFreq: number;
-    docFreq: number;
-    freq: number;
-    word: string;
-}
-export interface TenantVocabulary {
-    terms: WeightedTerm[];
-}
-interface VectorStore {
-    dim: number;
-    float32: Float32Array;
-    wordIndex: Record<string, number>;
-}
-/**
- * Loads the General English vocabulary.
- * expects a simple array of strings: ["about", "above", "actually", ...]
- */
-export declare const initL3Vocabulary: (l3Words: string[]) => void;
-/**
- * Get predictor status for debugging.
- * vectorsLoaded: true when semantic scoring is active
- * wordCount: number of words in vector store (0 if not loaded)
- */
-export declare const getPredictorStatus: () => {
-    isInitialized: boolean;
-    vectorsLoaded: boolean;
-    vectorsLoadStarted: boolean;
-    wordCount: number;
-};
-/**
- * Get details of the last prediction (for debugging).
- * Returns null if no prediction has run yet or debug was off.
- */
-export declare const getLastPredictionDebug: () => {
-    contextWords: string[];
-    currentWord: string;
-    mode: "cold" | "warm";
-    suggestion: string | null;
-    textBefore: string;
-    topCandidates: Array<{
-        finalScore: number;
-        freqScore: number;
-        lmScore: number;
-        semanticScore: number;
-        word: string;
-    }>;
-} | null;
-export declare const initVocabulary: (vocabulary: TenantVocabulary) => void;
-/**
- * Increment L1 session frequency for a single word.
- * Called from the plugin on word boundaries for efficient incremental boosting.
- */
-export declare const incrementSessionFreq: (word: string) => void;
-/**
- * Prime session frequencies from a document page string.
- *
- * Iterates through every token in `pageContent` and increments its session
- * frequency so that words already present on the page receive an L1 boost
- * before the user starts typing.
- *
- * Pass `undefined` (or omit the argument) to skip priming — useful when the
- * calling context does not yet have a page value available.
- */
-export declare const ingestDocumentPage: (pageContent: string | undefined) => void;
-export declare const predict: (textBefore: string) => string | null;
-export declare const loadVectorsAsync: (options?: {
-    getBinaryUrl?: () => Promise<string>;
-    isLocalLLM?: boolean;
-}) => Promise<void>;
-export declare const initVectors: (store: VectorStore) => void;
-export declare const loadDefaultVocabulary: (options?: {
-    isLocalLLM?: boolean;
-}) => Promise<void>;
-export {};