@singapore-editor/spellcheck 0.1.1

package/dist/controller.d.ts

@@ -0,0 +1,51 @@
+import type { EditorDisposable, EditorEditContributionContext, EditorViewContributionContext, EditorViewContributionUpdateKind, EditorViewSnapshot } from '@singapore-editor/core/extensions';
+import type { EditorSpellcheckFeature } from './feature';
+import { type SpellcheckScope } from './proseRanges';
+import type { SpellcheckService } from './service';
+export type SpellcheckChecker = Pick<SpellcheckService, 'check' | 'suggest' | 'isAccepted' | 'setAcceptedWords' | 'onDidChangeAcceptedWords'>;
+/**
+ * One editor's spellcheck. Marks are always derived from the current text: the worker answers with
+ * verdicts per word, never with offsets, so a reply that lands after an edit cannot paint stale ranges.
+ */
+export declare class SpellcheckController {
+    private readonly checker;
+    private readonly scope;
+    private view;
+    private edit;
+    private highlightName;
+    private readonly verdicts;
+    private readonly pending;
+    private readonly lines;
+    private issues;
+    private held;
+    private paintedKey;
+    private recheckInputs;
+    private dictionaryVersion;
+    private verdictVersion;
+    private wordsKey;
+    private wordsCaptures;
+    private cachedWords;
+    private failed;
+    private disposed;
+    constructor(checker: SpellcheckChecker, scope: SpellcheckScope);
+    attachView(context: EditorViewContributionContext): EditorDisposable;
+    attachEdit(context: EditorEditContributionContext): EditorDisposable;
+    feature(): EditorSpellcheckFeature;
+    update(snapshot: EditorViewSnapshot, kind: EditorViewContributionUpdateKind): void;
+    private refresh;
+    private recheck;
+    /** Selection and scroll updates outnumber edits; they reuse the words while the window holds. */
+    private windowWords;
+    private words;
+    private proseWords;
+    private lineWords;
+    private request;
+    private settle;
+    /** A failed worker is not asked again by this editor: every keystroke would start another. */
+    private fail;
+    /** Every issue in the window answers `issueAt`; only those on mounted rows are painted. */
+    private paint;
+    private issueAt;
+    private replace;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,6BAA6B,EAC7B,6BAA6B,EAC7B,gCAAgC,EAChC,kBAAkB,EACnB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EAAE,uBAAuB,EAAc,MAAM,WAAW,CAAA;AACpE,OAAO,EAA6C,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAUlD,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,iBAAiB,EACjB,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,kBAAkB,GAAG,0BAA0B,CACrF,CAAA;AAcD;;;GAGG;AACH,qBAAa,oBAAoB;IAoB7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IApBxB,OAAO,CAAC,IAAI,CAA6C;IACzD,OAAO,CAAC,IAAI,CAA6C;IACzD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAQ;gBAGL,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,eAAe;IAGlC,UAAU,CAAC,OAAO,EAAE,6BAA6B,GAAG,gBAAgB;IAsBpE,UAAU,CAAC,OAAO,EAAE,6BAA6B,GAAG,gBAAgB;IAKpE,OAAO,IAAI,uBAAuB;IAYlC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,gCAAgC,GAAG,IAAI;IAUzF,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;IAgCf,iGAAiG;IACjG,OAAO,CAAC,WAAW;IA8BnB,OAAO,CAAC,KAAK;IAoBb,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,OAAO;IAiBf,OAAO,CAAC,MAAM;IASd,8FAA8F;IAC9F,OAAO,CAAC,IAAI;IAYZ,2FAA2F;IAC3F,OAAO,CAAC,KAAK;IAcb,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;CAWhB"}

package/dist/controller.js

@@ -0,0 +1,307 @@
+import { spellcheckRegions } from "./proseRanges.js";
+import { SPELLING_STYLE } from "./styles.js";
+import { foldApostrophes, tokenizeSpellWords } from "./tokenizer.js";
+//#region src/controller.ts
+var DEFAULT_SUGGESTIONS = 5;
+var MAX_CACHED_LINES = 4096;
+var RECHECK_KINDS = /* @__PURE__ */ new Set([
+	"document",
+	"content",
+	"tokens",
+	"selection",
+	"viewport",
+	"layout"
+]);
+/**
+* One editor's spellcheck. Marks are always derived from the current text: the worker answers with
+* verdicts per word, never with offsets, so a reply that lands after an edit cannot paint stale ranges.
+*/
+var SpellcheckController = class {
+	checker;
+	scope;
+	view = null;
+	edit = null;
+	highlightName = "";
+	verdicts = /* @__PURE__ */ new Map();
+	pending = /* @__PURE__ */ new Set();
+	lines = /* @__PURE__ */ new Map();
+	issues = [];
+	held = [];
+	paintedKey = "";
+	recheckInputs = "";
+	dictionaryVersion = 0;
+	verdictVersion = 0;
+	wordsKey = "";
+	wordsCaptures = null;
+	cachedWords = [];
+	failed = false;
+	disposed = false;
+	constructor(checker, scope) {
+		this.checker = checker;
+		this.scope = scope;
+	}
+	attachView(context) {
+		this.view = context;
+		this.highlightName = `${context.highlightPrefix}-spelling`;
+		const captures = context.requestSyntaxCaptures();
+		const accepted = this.checker.onDidChangeAcceptedWords(() => {
+			this.dictionaryVersion += 1;
+			this.verdicts.clear();
+			this.pending.clear();
+			this.verdictVersion += 1;
+			this.refresh();
+		});
+		return { dispose: () => {
+			captures.dispose();
+			accepted.dispose();
+			context.clearRangeHighlight(this.highlightName);
+			this.view = null;
+			this.disposed = true;
+		} };
+	}
+	attachEdit(context) {
+		this.edit = context;
+		return { dispose: () => this.edit = null };
+	}
+	feature() {
+		return {
+			issueAt: (offset) => this.issueAt(offset),
+			suggestions: (offset, limit = DEFAULT_SUGGESTIONS) => {
+				const issue = this.issueAt(offset);
+				return issue ? this.checker.suggest(issue.word, limit) : Promise.resolve([]);
+			},
+			replace: (offset, word) => this.replace(offset, word),
+			setAcceptedWords: (words) => this.checker.setAcceptedWords(words)
+		};
+	}
+	update(snapshot, kind) {
+		if (kind === "clear") {
+			this.paint([], null);
+			return;
+		}
+		if (!RECHECK_KINDS.has(kind)) return;
+		if (kind === "document") this.held = [];
+		this.recheck(snapshot, kind === "content");
+	}
+	refresh() {
+		if (this.view) this.recheck(this.view.getSnapshot(), false);
+	}
+	recheck(snapshot, edited) {
+		const context = this.view;
+		if (!context || !context.hasDocument()) return this.paint([], null);
+		const window = checkWindow(snapshot);
+		const words = window ? this.windowWords(snapshot, context, window) : [];
+		if (!words) {
+			this.recheckInputs = "";
+			return this.paint([], null);
+		}
+		const carets = caretOffsets(snapshot);
+		const mounted = mountedRange(snapshot);
+		const inputs = `${this.wordsKey}|${carets.join(",")}|${mounted?.start}:${mounted?.end}|${this.verdictVersion}`;
+		if (!edited && inputs === this.recheckInputs) return;
+		this.recheckInputs = inputs;
+		this.held = edited ? wordsAtCarets(words, carets) : stillHeld(this.held, carets);
+		const issues = [];
+		const unknown = /* @__PURE__ */ new Set();
+		for (const word of words) {
+			const verdict = this.verdicts.get(word.word);
+			if (verdict === false) continue;
+			if (isHeld(word, this.held)) continue;
+			if (verdict === void 0) unknown.add(word.word);
+			else if (!this.checker.isAccepted(word.word)) issues.push(word);
+		}
+		this.paint(issues, mounted);
+		this.request(unknown);
+	}
+	/** Selection and scroll updates outnumber edits; they reuse the words while the window holds. */
+	windowWords(snapshot, context, window) {
+		const captures = context.getSyntaxCaptures();
+		const replacements = context.getInlineReplacementRanges();
+		const key = [
+			snapshot.languageId,
+			snapshot.textVersion,
+			window.start,
+			window.end,
+			...replacements.flatMap((range) => [range.start, range.end])
+		].join(",");
+		if (key === this.wordsKey && captures === this.wordsCaptures) return this.cachedWords;
+		const regions = spellcheckRegions({
+			languageId: snapshot.languageId,
+			captures,
+			window,
+			scope: this.scope
+		});
+		if (!regions) return null;
+		this.recheckInputs = "";
+		this.cachedWords = this.words(snapshot, regions, replacements);
+		this.wordsKey = key;
+		this.wordsCaptures = captures;
+		return this.cachedWords;
+	}
+	words(snapshot, regions, replacements) {
+		const text = snapshot.textSnapshot;
+		const excluded = [...regions.excluded, ...replacements];
+		const words = [];
+		for (const region of regions.prose) this.proseWords(text, region, excluded, words);
+		for (const region of regions.code) {
+			if (region.end - region.start > 16384) continue;
+			const source = text.readRange(region.start, region.end);
+			const local = localRanges(excluded, region);
+			for (const word of tokenizeSpellWords(source, {
+				mode: "code",
+				excluded: local
+			})) words.push(shifted(word, region.start));
+		}
+		return words;
+	}
+	proseWords(text, region, excluded, words) {
+		const firstLine = text.lineAt(region.start);
+		const lastLine = text.lineAt(region.end);
+		for (let line = firstLine; line <= lastLine; line++) {
+			const range = text.lineRange(line);
+			if (range.end - range.start > 16384) continue;
+			const local = localRanges(excluded, range);
+			const lineWords = this.lineWords(text.readRange(range.start, range.end), local);
+			for (const word of lineWords) words.push(shifted(word, range.start));
+		}
+	}
+	lineWords(line, excluded) {
+		if (excluded.length > 0) return tokenizeSpellWords(line, { excluded });
+		const cached = this.lines.get(line);
+		if (cached) return cached;
+		if (this.lines.size >= MAX_CACHED_LINES) this.lines.clear();
+		const words = tokenizeSpellWords(line);
+		this.lines.set(line, words);
+		return words;
+	}
+	request(unknown) {
+		if (this.failed) return;
+		const words = [...unknown].filter((word) => !this.pending.has(word));
+		if (words.length === 0) return;
+		for (const word of words) this.pending.add(word);
+		const dictionaryVersion = this.dictionaryVersion;
+		this.checker.check(words).then((misspelled) => {
+			if (dictionaryVersion === this.dictionaryVersion) this.settle(words, new Set(misspelled));
+		}, (error) => {
+			if (dictionaryVersion === this.dictionaryVersion) this.fail(words, error);
+		});
+	}
+	settle(words, misspelled) {
+		for (const word of words) {
+			this.pending.delete(word);
+			this.verdicts.set(word, misspelled.has(word));
+		}
+		this.verdictVersion += 1;
+		if (!this.disposed) this.refresh();
+	}
+	/** A failed worker is not asked again by this editor: every keystroke would start another. */
+	fail(words, error) {
+		for (const word of words) this.pending.delete(word);
+		if (this.disposed || this.failed) return;
+		this.failed = true;
+		this.view?.log({
+			action: "spellcheck.check",
+			level: "warn",
+			message: "Spellcheck stopped: the dictionary worker failed",
+			reason: error instanceof Error ? error.message : String(error)
+		});
+	}
+	/** Every issue in the window answers `issueAt`; only those on mounted rows are painted. */
+	paint(issues, mounted) {
+		this.issues = issues;
+		const view = this.view;
+		if (!view) return;
+		const painted = mounted ? issues.filter((issue) => issue.end > mounted.start && issue.start < mounted.end) : [];
+		const key = painted.map((issue) => `${issue.start}:${issue.end}`).join(",");
+		if (key === this.paintedKey) return;
+		this.paintedKey = key;
+		if (painted.length === 0) view.clearRangeHighlight(this.highlightName);
+		else view.setRangeHighlight(this.highlightName, painted, SPELLING_STYLE);
+	}
+	issueAt(offset) {
+		return this.issues.find((issue) => issue.start <= offset && offset <= issue.end) ?? null;
+	}
+	replace(offset, word) {
+		const issue = this.issueAt(offset);
+		const edit = this.edit;
+		if (!issue || !edit) return false;
+		const text = edit.getTextSnapshot();
+		if (!text || foldApostrophes(text.readRange(issue.start, issue.end)) !== issue.word) return false;
+		edit.applyEdits([{
+			from: issue.start,
+			to: issue.end,
+			text: word
+		}], "spellcheck.replace");
+		return true;
+	}
+};
+function mountedRange(snapshot) {
+	let start = Number.POSITIVE_INFINITY;
+	let end = -1;
+	for (const row of snapshot.visibleRows) {
+		if (row.source !== "document") continue;
+		start = Math.min(start, row.startOffset);
+		end = Math.max(end, row.endOffset);
+	}
+	return end < 0 ? null : {
+		start,
+		end
+	};
+}
+/** The mounted rows plus one screen above and below them. */
+function checkWindow(snapshot) {
+	let first = Number.POSITIVE_INFINITY;
+	let last = -1;
+	for (const row of snapshot.visibleRows) {
+		if (row.source !== "document") continue;
+		first = Math.min(first, row.bufferRow);
+		last = Math.max(last, row.bufferRow);
+	}
+	if (last < 0) return null;
+	const text = snapshot.textSnapshot;
+	const span = last - first + 1;
+	const startLine = Math.max(0, first - span);
+	const endLine = Math.min(text.lineCount - 1, last + span);
+	return {
+		start: text.lineStart(startLine),
+		end: text.lineRange(endLine).end
+	};
+}
+function caretOffsets(snapshot) {
+	return snapshot.selections.filter((selection) => selection.startOffset === selection.endOffset).map((selection) => selection.headOffset);
+}
+function containsCaret(range, carets) {
+	return carets.some((caret) => range.start <= caret && caret <= range.end);
+}
+/** The words being typed: held back until the caret leaves them. */
+function wordsAtCarets(words, carets) {
+	return words.filter((word) => containsCaret(word, carets));
+}
+function stillHeld(held, carets) {
+	return held.filter((range) => containsCaret(range, carets));
+}
+function isHeld(word, held) {
+	return held.some((range) => range.start === word.start && range.end === word.end);
+}
+function localRanges(ranges, within) {
+	const local = [];
+	for (const range of ranges) {
+		if (range.end <= within.start || range.start >= within.end) continue;
+		local.push({
+			start: range.start - within.start,
+			end: range.end - within.start
+		});
+	}
+	return local;
+}
+function shifted(word, by) {
+	return {
+		start: word.start + by,
+		end: word.end + by,
+		word: word.word
+	};
+}
+//#endregion
+export { SpellcheckController };
+
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","names":[],"sources":["../src/controller.ts"],"sourcesContent":["import type {\n  EditorDisposable,\n  EditorEditContributionContext,\n  EditorViewContributionContext,\n  EditorViewContributionUpdateKind,\n  EditorViewSnapshot,\n} from '@singapore-editor/core/extensions'\nimport type { EditorSpellcheckFeature, SpellIssue } from './feature'\nimport { spellcheckRegions, type SpellcheckRegions, type SpellcheckScope } from './proseRanges'\nimport type { SpellcheckService } from './service'\nimport { SPELLING_STYLE } from './styles'\nimport {\n  foldApostrophes,\n  MAX_SPELLCHECK_LINE_LENGTH,\n  tokenizeSpellWords,\n  type SpellTextRange,\n  type SpellWord,\n} from './tokenizer'\n\nexport type SpellcheckChecker = Pick<\n  SpellcheckService,\n  'check' | 'suggest' | 'isAccepted' | 'setAcceptedWords' | 'onDidChangeAcceptedWords'\n>\n\nconst DEFAULT_SUGGESTIONS = 5\n// Lines keyed by their text: typing re-tokenizes the line it changes, never the whole window.\nconst MAX_CACHED_LINES = 4096\nconst RECHECK_KINDS: ReadonlySet<EditorViewContributionUpdateKind> = new Set([\n  'document',\n  'content',\n  'tokens',\n  'selection',\n  'viewport',\n  'layout',\n])\n\n/**\n * One editor's spellcheck. Marks are always derived from the current text: the worker answers with\n * verdicts per word, never with offsets, so a reply that lands after an edit cannot paint stale ranges.\n */\nexport class SpellcheckController {\n  private view: EditorViewContributionContext | null = null\n  private edit: EditorEditContributionContext | null = null\n  private highlightName = ''\n  private readonly verdicts = new Map<string, boolean>()\n  private readonly pending = new Set<string>()\n  private readonly lines = new Map<string, readonly SpellWord[]>()\n  private issues: readonly SpellIssue[] = []\n  private held: readonly SpellTextRange[] = []\n  private paintedKey = ''\n  private recheckInputs = ''\n  private dictionaryVersion = 0\n  private verdictVersion = 0\n  private wordsKey = ''\n  private wordsCaptures: readonly unknown[] | null = null\n  private cachedWords: readonly SpellWord[] = []\n  private failed = false\n  private disposed = false\n\n  public constructor(\n    private readonly checker: SpellcheckChecker,\n    private readonly scope: SpellcheckScope,\n  ) {}\n\n  public attachView(context: EditorViewContributionContext): EditorDisposable {\n    this.view = context\n    this.highlightName = `${context.highlightPrefix}-spelling`\n    const captures = context.requestSyntaxCaptures()\n    const accepted = this.checker.onDidChangeAcceptedWords(() => {\n      this.dictionaryVersion += 1\n      this.verdicts.clear()\n      this.pending.clear()\n      this.verdictVersion += 1\n      this.refresh()\n    })\n    return {\n      dispose: () => {\n        captures.dispose()\n        accepted.dispose()\n        context.clearRangeHighlight(this.highlightName)\n        this.view = null\n        this.disposed = true\n      },\n    }\n  }\n\n  public attachEdit(context: EditorEditContributionContext): EditorDisposable {\n    this.edit = context\n    return { dispose: () => (this.edit = null) }\n  }\n\n  public feature(): EditorSpellcheckFeature {\n    return {\n      issueAt: (offset) => this.issueAt(offset),\n      suggestions: (offset, limit = DEFAULT_SUGGESTIONS) => {\n        const issue = this.issueAt(offset)\n        return issue ? this.checker.suggest(issue.word, limit) : Promise.resolve([])\n      },\n      replace: (offset, word) => this.replace(offset, word),\n      setAcceptedWords: (words) => this.checker.setAcceptedWords(words),\n    }\n  }\n\n  public update(snapshot: EditorViewSnapshot, kind: EditorViewContributionUpdateKind): void {\n    if (kind === 'clear') {\n      this.paint([], null)\n      return\n    }\n    if (!RECHECK_KINDS.has(kind)) return\n    if (kind === 'document') this.held = []\n    this.recheck(snapshot, kind === 'content')\n  }\n\n  private refresh(): void {\n    if (this.view) this.recheck(this.view.getSnapshot(), false)\n  }\n\n  private recheck(snapshot: EditorViewSnapshot, edited: boolean): void {\n    const context = this.view\n    if (!context || !context.hasDocument()) return this.paint([], null)\n\n    const window = checkWindow(snapshot)\n    const words = window ? this.windowWords(snapshot, context, window) : []\n    if (!words) {\n      this.recheckInputs = ''\n      return this.paint([], null)\n    }\n\n    const carets = caretOffsets(snapshot)\n    const mounted = mountedRange(snapshot)\n    const inputs = `${this.wordsKey}|${carets.join(',')}|${mounted?.start}:${mounted?.end}|${this.verdictVersion}`\n    if (!edited && inputs === this.recheckInputs) return\n    this.recheckInputs = inputs\n    this.held = edited ? wordsAtCarets(words, carets) : stillHeld(this.held, carets)\n\n    const issues: SpellIssue[] = []\n    const unknown = new Set<string>()\n    for (const word of words) {\n      const verdict = this.verdicts.get(word.word)\n      if (verdict === false) continue\n      if (isHeld(word, this.held)) continue\n      if (verdict === undefined) unknown.add(word.word)\n      else if (!this.checker.isAccepted(word.word)) issues.push(word)\n    }\n\n    this.paint(issues, mounted)\n    this.request(unknown)\n  }\n\n  /** Selection and scroll updates outnumber edits; they reuse the words while the window holds. */\n  private windowWords(\n    snapshot: EditorViewSnapshot,\n    context: EditorViewContributionContext,\n    window: SpellTextRange,\n  ): readonly SpellWord[] | null {\n    const captures = context.getSyntaxCaptures()\n    const replacements = context.getInlineReplacementRanges()\n    const key = [\n      snapshot.languageId,\n      snapshot.textVersion,\n      window.start,\n      window.end,\n      ...replacements.flatMap((range) => [range.start, range.end]),\n    ].join(',')\n    if (key === this.wordsKey && captures === this.wordsCaptures) return this.cachedWords\n\n    const regions = spellcheckRegions({\n      languageId: snapshot.languageId,\n      captures,\n      window,\n      scope: this.scope,\n    })\n    if (!regions) return null\n    this.recheckInputs = ''\n    this.cachedWords = this.words(snapshot, regions, replacements)\n    this.wordsKey = key\n    this.wordsCaptures = captures\n    return this.cachedWords\n  }\n\n  private words(\n    snapshot: EditorViewSnapshot,\n    regions: SpellcheckRegions,\n    replacements: readonly SpellTextRange[],\n  ): readonly SpellWord[] {\n    const text = snapshot.textSnapshot\n    const excluded = [...regions.excluded, ...replacements]\n    const words: SpellWord[] = []\n    for (const region of regions.prose) this.proseWords(text, region, excluded, words)\n    for (const region of regions.code) {\n      if (region.end - region.start > MAX_SPELLCHECK_LINE_LENGTH) continue\n      const source = text.readRange(region.start, region.end)\n      const local = localRanges(excluded, region)\n      for (const word of tokenizeSpellWords(source, { mode: 'code', excluded: local })) {\n        words.push(shifted(word, region.start))\n      }\n    }\n    return words\n  }\n\n  private proseWords(\n    text: EditorViewSnapshot['textSnapshot'],\n    region: SpellTextRange,\n    excluded: readonly SpellTextRange[],\n    words: SpellWord[],\n  ): void {\n    const firstLine = text.lineAt(region.start)\n    const lastLine = text.lineAt(region.end)\n    for (let line = firstLine; line <= lastLine; line++) {\n      const range = text.lineRange(line)\n      if (range.end - range.start > MAX_SPELLCHECK_LINE_LENGTH) continue\n      const local = localRanges(excluded, range)\n      const lineWords = this.lineWords(text.readRange(range.start, range.end), local)\n      for (const word of lineWords) words.push(shifted(word, range.start))\n    }\n  }\n\n  private lineWords(line: string, excluded: readonly SpellTextRange[]): readonly SpellWord[] {\n    if (excluded.length > 0) return tokenizeSpellWords(line, { excluded })\n\n    const cached = this.lines.get(line)\n    if (cached) return cached\n    if (this.lines.size >= MAX_CACHED_LINES) this.lines.clear()\n    const words = tokenizeSpellWords(line)\n    this.lines.set(line, words)\n    return words\n  }\n\n  private request(unknown: ReadonlySet<string>): void {\n    if (this.failed) return\n    const words = [...unknown].filter((word) => !this.pending.has(word))\n    if (words.length === 0) return\n\n    for (const word of words) this.pending.add(word)\n    const dictionaryVersion = this.dictionaryVersion\n    this.checker.check(words).then(\n      (misspelled) => {\n        if (dictionaryVersion === this.dictionaryVersion) this.settle(words, new Set(misspelled))\n      },\n      (error: unknown) => {\n        if (dictionaryVersion === this.dictionaryVersion) this.fail(words, error)\n      },\n    )\n  }\n\n  private settle(words: readonly string[], misspelled: ReadonlySet<string>): void {\n    for (const word of words) {\n      this.pending.delete(word)\n      this.verdicts.set(word, misspelled.has(word))\n    }\n    this.verdictVersion += 1\n    if (!this.disposed) this.refresh()\n  }\n\n  /** A failed worker is not asked again by this editor: every keystroke would start another. */\n  private fail(words: readonly string[], error: unknown): void {\n    for (const word of words) this.pending.delete(word)\n    if (this.disposed || this.failed) return\n    this.failed = true\n    this.view?.log({\n      action: 'spellcheck.check',\n      level: 'warn',\n      message: 'Spellcheck stopped: the dictionary worker failed',\n      reason: error instanceof Error ? error.message : String(error),\n    })\n  }\n\n  /** Every issue in the window answers `issueAt`; only those on mounted rows are painted. */\n  private paint(issues: readonly SpellIssue[], mounted: SpellTextRange | null): void {\n    this.issues = issues\n    const view = this.view\n    if (!view) return\n    const painted = mounted\n      ? issues.filter((issue) => issue.end > mounted.start && issue.start < mounted.end)\n      : []\n    const key = painted.map((issue) => `${issue.start}:${issue.end}`).join(',')\n    if (key === this.paintedKey) return\n    this.paintedKey = key\n    if (painted.length === 0) view.clearRangeHighlight(this.highlightName)\n    else view.setRangeHighlight(this.highlightName, painted, SPELLING_STYLE)\n  }\n\n  private issueAt(offset: number): SpellIssue | null {\n    return this.issues.find((issue) => issue.start <= offset && offset <= issue.end) ?? null\n  }\n\n  private replace(offset: number, word: string): boolean {\n    const issue = this.issueAt(offset)\n    const edit = this.edit\n    if (!issue || !edit) return false\n    const text = edit.getTextSnapshot()\n    if (!text || foldApostrophes(text.readRange(issue.start, issue.end)) !== issue.word)\n      return false\n\n    edit.applyEdits([{ from: issue.start, to: issue.end, text: word }], 'spellcheck.replace')\n    return true\n  }\n}\n\nfunction mountedRange(snapshot: EditorViewSnapshot): SpellTextRange | null {\n  let start = Number.POSITIVE_INFINITY\n  let end = -1\n  for (const row of snapshot.visibleRows) {\n    if (row.source !== 'document') continue\n    start = Math.min(start, row.startOffset)\n    end = Math.max(end, row.endOffset)\n  }\n  return end < 0 ? null : { start, end }\n}\n\n/** The mounted rows plus one screen above and below them. */\nfunction checkWindow(snapshot: EditorViewSnapshot): SpellTextRange | null {\n  let first = Number.POSITIVE_INFINITY\n  let last = -1\n  for (const row of snapshot.visibleRows) {\n    if (row.source !== 'document') continue\n    first = Math.min(first, row.bufferRow)\n    last = Math.max(last, row.bufferRow)\n  }\n  if (last < 0) return null\n\n  const text = snapshot.textSnapshot\n  const span = last - first + 1\n  const startLine = Math.max(0, first - span)\n  const endLine = Math.min(text.lineCount - 1, last + span)\n  return { start: text.lineStart(startLine), end: text.lineRange(endLine).end }\n}\n\nfunction caretOffsets(snapshot: EditorViewSnapshot): readonly number[] {\n  return snapshot.selections\n    .filter((selection) => selection.startOffset === selection.endOffset)\n    .map((selection) => selection.headOffset)\n}\n\nfunction containsCaret(range: SpellTextRange, carets: readonly number[]): boolean {\n  return carets.some((caret) => range.start <= caret && caret <= range.end)\n}\n\n/** The words being typed: held back until the caret leaves them. */\nfunction wordsAtCarets(\n  words: readonly SpellWord[],\n  carets: readonly number[],\n): readonly SpellTextRange[] {\n  return words.filter((word) => containsCaret(word, carets))\n}\n\nfunction stillHeld(\n  held: readonly SpellTextRange[],\n  carets: readonly number[],\n): readonly SpellTextRange[] {\n  return held.filter((range) => containsCaret(range, carets))\n}\n\nfunction isHeld(word: SpellTextRange, held: readonly SpellTextRange[]): boolean {\n  return held.some((range) => range.start === word.start && range.end === word.end)\n}\n\nfunction localRanges(\n  ranges: readonly SpellTextRange[],\n  within: SpellTextRange,\n): readonly SpellTextRange[] {\n  const local: SpellTextRange[] = []\n  for (const range of ranges) {\n    if (range.end <= within.start || range.start >= within.end) continue\n    local.push({ start: range.start - within.start, end: range.end - within.start })\n  }\n  return local\n}\n\nfunction shifted(word: SpellWord, by: number): SpellWord {\n  return { start: word.start + by, end: word.end + by, word: word.word }\n}\n"],"mappings":"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"}

package/dist/dictionaryAssets.d.ts

@@ -0,0 +1,4 @@
+import type { SpellDictionaryUrls } from './dictionaryData';
+/** US and British spellings are both accepted, with software vocabulary on top. */
+export declare const ENGLISH_DICTIONARIES: SpellDictionaryUrls;
+//# sourceMappingURL=dictionaryAssets.d.ts.map

package/dist/dictionaryAssets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionaryAssets.d.ts","sourceRoot":"","sources":["../src/dictionaryAssets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAE3D,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,EAAE,mBAGlC,CAAA"}

package/dist/dictionaryData.d.ts

@@ -0,0 +1,13 @@
+import type { SpellEngineSource } from './engine';
+export type SpellDictionaryUrls = {
+    readonly dictionaries: readonly string[];
+    readonly suggestionWeights: SpellEngineSource['suggestionWeights'];
+};
+/** Fetches and inflates each dictionary. Every fetch starts before any is awaited. */
+export declare function loadSpellEngineSource(urls: SpellDictionaryUrls): Promise<SpellEngineSource>;
+/**
+ * A server that labels `.gz` files `Content-Encoding: gzip` hands fetch the inflated bytes, so the
+ * gzip magic number decides whether there is anything left to inflate.
+ */
+export declare function inflateDictionary(bytes: Uint8Array<ArrayBuffer>): Promise<Uint8Array<ArrayBuffer>>;
+//# sourceMappingURL=dictionaryData.d.ts.map

package/dist/dictionaryData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionaryData.d.ts","sourceRoot":"","sources":["../src/dictionaryData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEjD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,mBAAmB,CAAC,CAAA;CACnE,CAAA;AAED,sFAAsF;AACtF,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAGjG;AAQD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAKlC"}

package/dist/engine.d.ts

@@ -0,0 +1,18 @@
+import { mapDictionaryInformationToWeightMap } from 'cspell-trie-lib';
+type DictionaryInformation = Parameters<typeof mapDictionaryInformationToWeightMap>[0];
+export type SpellEngine = {
+    isCorrect(word: string): boolean;
+    /** The words among `words` that are misspelled, each once, in first-seen order. */
+    check(words: readonly string[]): readonly string[];
+    suggest(word: string, limit: number): readonly string[];
+    /** Replaces the accepted list. Accepted words are never misspelled and can be suggested. */
+    setAcceptedWords(words: readonly string[]): void;
+};
+export type SpellEngineSource = {
+    /** Decompressed tries, in either of cspell-trie-lib's encodings. */
+    readonly dictionaries: readonly Uint8Array<ArrayBuffer>[];
+    readonly suggestionWeights: DictionaryInformation;
+};
+export declare function createSpellEngine(source: SpellEngineSource): SpellEngine;
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,mCAAmC,EAGpC,MAAM,iBAAiB,CAAA;AAExB,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,mCAAmC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEtF,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAChC,mFAAmF;IACnF,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAAA;IAClD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IACvD,4FAA4F;IAC5F,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CACjD,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,CAAC,WAAW,CAAC,EAAE,CAAA;IACzD,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAAA;CAClD,CAAA;AAID,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAuBxE"}

package/dist/feature.d.ts

@@ -0,0 +1,19 @@
+export type SpellIssue = {
+    readonly start: number;
+    readonly end: number;
+    readonly word: string;
+};
+/** What a host reaches through `editor.getFeature(EDITOR_SPELLCHECK_FEATURE)`. */
+export type EditorSpellcheckFeature = {
+    /** The marked word at `offset`, edges included; only words on or near the screen are marked. */
+    issueAt(offset: number): SpellIssue | null;
+    /** Replacements for the marked word at `offset`, best first; empty when nothing is marked there. */
+    suggestions(offset: number, limit?: number): Promise<readonly string[]>;
+    /** Replaces the marked word at `offset` as one undoable edit. False when nothing is marked there. */
+    replace(offset: number, word: string): boolean;
+    /** Words never marked, in every editor sharing this editor's spellcheck service. */
+    setAcceptedWords(words: readonly string[]): void;
+};
+export declare const EDITOR_SPELLCHECK_FEATURE_ID = "editor.spellcheck";
+export declare const EDITOR_SPELLCHECK_FEATURE: import("@singapore-editor/core").EditorCapabilityToken<EditorSpellcheckFeature>;
+//# sourceMappingURL=feature.d.ts.map

package/dist/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../src/feature.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,kFAAkF;AAClF,MAAM,MAAM,uBAAuB,GAAG;IACpC,gGAAgG;IAChG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAA;IAC1C,oGAAoG;IACpG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;IACvE,qGAAqG;IACrG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAC9C,oFAAoF;IACpF,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CACjD,CAAA;AAED,eAAO,MAAM,4BAA4B,sBAAsB,CAAA;AAE/D,eAAO,MAAM,yBAAyB,iFAErC,CAAA"}

package/dist/feature.js

@@ -0,0 +1,8 @@
+import { createEditorCapabilityToken } from "@singapore-editor/core/extensions";
+//#region src/feature.ts
+var EDITOR_SPELLCHECK_FEATURE_ID = "editor.spellcheck";
+var EDITOR_SPELLCHECK_FEATURE = createEditorCapabilityToken(EDITOR_SPELLCHECK_FEATURE_ID);
+//#endregion
+export { EDITOR_SPELLCHECK_FEATURE, EDITOR_SPELLCHECK_FEATURE_ID };
+
+//# sourceMappingURL=feature.js.map

package/dist/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","names":[],"sources":["../src/feature.ts"],"sourcesContent":["import { createEditorCapabilityToken } from '@singapore-editor/core/extensions'\n\nexport type SpellIssue = {\n  readonly start: number\n  readonly end: number\n  readonly word: string\n}\n\n/** What a host reaches through `editor.getFeature(EDITOR_SPELLCHECK_FEATURE)`. */\nexport type EditorSpellcheckFeature = {\n  /** The marked word at `offset`, edges included; only words on or near the screen are marked. */\n  issueAt(offset: number): SpellIssue | null\n  /** Replacements for the marked word at `offset`, best first; empty when nothing is marked there. */\n  suggestions(offset: number, limit?: number): Promise<readonly string[]>\n  /** Replaces the marked word at `offset` as one undoable edit. False when nothing is marked there. */\n  replace(offset: number, word: string): boolean\n  /** Words never marked, in every editor sharing this editor's spellcheck service. */\n  setAcceptedWords(words: readonly string[]): void\n}\n\nexport const EDITOR_SPELLCHECK_FEATURE_ID = 'editor.spellcheck'\n\nexport const EDITOR_SPELLCHECK_FEATURE = createEditorCapabilityToken<EditorSpellcheckFeature>(\n  EDITOR_SPELLCHECK_FEATURE_ID,\n)\n"],"mappings":";;AAoBA,IAAa,+BAA+B;AAE5C,IAAa,4BAA4B,4BACvC,4BACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { SpellcheckChecker } from './controller';
+export { EDITOR_SPELLCHECK_FEATURE, EDITOR_SPELLCHECK_FEATURE_ID, type EditorSpellcheckFeature, type SpellIssue, } from './feature';
+export { createSpellcheckPlugin, type SpellcheckPluginOptions } from './plugin';
+export type { SpellcheckScope } from './proseRanges';
+export { SpellcheckService, type SpellcheckServiceOptions } from './service';
+export { tokenizeSpellWords, type SpellTextRange, type SpellTokenizeMode, type SpellTokenizeOptions, type SpellWord, } from './tokenizer';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,UAAU,GAChB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,sBAAsB,EAAE,KAAK,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAC5E,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,SAAS,GACf,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import { EDITOR_SPELLCHECK_FEATURE, EDITOR_SPELLCHECK_FEATURE_ID } from "./feature.js";
+import { tokenizeSpellWords } from "./tokenizer.js";
+import { createSpellcheckPlugin } from "./plugin.js";
+import { SpellcheckService } from "./service.js";
+export { EDITOR_SPELLCHECK_FEATURE, EDITOR_SPELLCHECK_FEATURE_ID, SpellcheckService, createSpellcheckPlugin, tokenizeSpellWords };

package/dist/plugin.d.ts

@@ -0,0 +1,12 @@
+import type { EditorPlugin } from '@singapore-editor/core/extensions';
+import { type SpellcheckChecker } from './controller';
+import type { SpellcheckScope } from './proseRanges';
+export type SpellcheckPluginOptions = {
+    /** The page's one service, shared by every editor. */
+    readonly service: SpellcheckChecker;
+    /** Defaults to `prose`: plain text and Markdown. */
+    readonly scope?: SpellcheckScope;
+};
+/** Marks misspelled words on and near the screen, and registers `EDITOR_SPELLCHECK_FEATURE`. */
+export declare function createSpellcheckPlugin(options: SpellcheckPluginOptions): EditorPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AACrE,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAE3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,MAAM,MAAM,uBAAuB,GAAG;IACpC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAA;CACjC,CAAA;AAED,gGAAgG;AAChG,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,YAAY,CAyBrF"}

package/dist/plugin.js

@@ -0,0 +1,27 @@
+import { EDITOR_SPELLCHECK_FEATURE } from "./feature.js";
+import { SpellcheckController } from "./controller.js";
+//#region src/plugin.ts
+/** Marks misspelled words on and near the screen, and registers `EDITOR_SPELLCHECK_FEATURE`. */
+function createSpellcheckPlugin(options) {
+	return {
+		name: "editor.spellcheck",
+		activate(context) {
+			const controller = new SpellcheckController(options.service, options.scope ?? "prose");
+			return [
+				context.registerViewContribution({ createContribution: (view) => {
+					const attachment = controller.attachView(view);
+					return {
+						update: (snapshot, kind) => controller.update(snapshot, kind),
+						dispose: () => attachment.dispose()
+					};
+				} }),
+				context.registerEditContribution({ createContribution: (edit) => controller.attachEdit(edit) }),
+				context.registerCapabilityContribution({ createContribution: (capability) => capability.registerFeature(EDITOR_SPELLCHECK_FEATURE, controller.feature()) })
+			];
+		}
+	};
+}
+//#endregion
+export { createSpellcheckPlugin };
+
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["import type { EditorPlugin } from '@singapore-editor/core/extensions'\nimport { SpellcheckController, type SpellcheckChecker } from './controller'\nimport { EDITOR_SPELLCHECK_FEATURE } from './feature'\nimport type { SpellcheckScope } from './proseRanges'\n\nexport type SpellcheckPluginOptions = {\n  /** The page's one service, shared by every editor. */\n  readonly service: SpellcheckChecker\n  /** Defaults to `prose`: plain text and Markdown. */\n  readonly scope?: SpellcheckScope\n}\n\n/** Marks misspelled words on and near the screen, and registers `EDITOR_SPELLCHECK_FEATURE`. */\nexport function createSpellcheckPlugin(options: SpellcheckPluginOptions): EditorPlugin {\n  return {\n    name: 'editor.spellcheck',\n    activate(context) {\n      const controller = new SpellcheckController(options.service, options.scope ?? 'prose')\n      return [\n        context.registerViewContribution({\n          createContribution: (view) => {\n            const attachment = controller.attachView(view)\n            return {\n              update: (snapshot, kind) => controller.update(snapshot, kind),\n              dispose: () => attachment.dispose(),\n            }\n          },\n        }),\n        context.registerEditContribution({\n          createContribution: (edit) => controller.attachEdit(edit),\n        }),\n        context.registerCapabilityContribution({\n          createContribution: (capability) =>\n            capability.registerFeature(EDITOR_SPELLCHECK_FEATURE, controller.feature()),\n        }),\n      ]\n    },\n  }\n}\n"],"mappings":";;;;AAaA,SAAgB,uBAAuB,SAAgD;CACrF,OAAO;EACL,MAAM;EACN,SAAS,SAAS;GAChB,MAAM,aAAa,IAAI,qBAAqB,QAAQ,SAAS,QAAQ,SAAS,OAAO;GACrF,OAAO;IACL,QAAQ,yBAAyB,EAC/B,qBAAqB,SAAS;KAC5B,MAAM,aAAa,WAAW,WAAW,IAAI;KAC7C,OAAO;MACL,SAAS,UAAU,SAAS,WAAW,OAAO,UAAU,IAAI;MAC5D,eAAe,WAAW,QAAQ;KACpC;IACF,EACF,CAAC;IACD,QAAQ,yBAAyB,EAC/B,qBAAqB,SAAS,WAAW,WAAW,IAAI,EAC1D,CAAC;IACD,QAAQ,+BAA+B,EACrC,qBAAqB,eACnB,WAAW,gBAAgB,2BAA2B,WAAW,QAAQ,CAAC,EAC9E,CAAC;GACH;EACF;CACF;AACF"}

package/dist/proseRanges.d.ts

@@ -0,0 +1,25 @@
+import type { SpellTextRange } from './tokenizer';
+/** `prose` checks plain text and Markdown only; `proseAndCode` also checks comments and strings. */
+export type SpellcheckScope = 'prose' | 'proseAndCode';
+export type SpellcheckCapture = {
+    readonly startIndex: number;
+    readonly endIndex: number;
+    readonly captureName: string;
+};
+export type SpellcheckRegionInput = {
+    readonly languageId: string | null;
+    /** Null while the parse that decides which parts are prose has not landed. */
+    readonly captures: readonly SpellcheckCapture[] | null;
+    readonly window: SpellTextRange;
+    readonly scope: SpellcheckScope;
+};
+export type SpellcheckRegions = {
+    /** Checked word by word as written. */
+    readonly prose: readonly SpellTextRange[];
+    /** Comments and strings: camelCase and snake_case are split. */
+    readonly code: readonly SpellTextRange[];
+    readonly excluded: readonly SpellTextRange[];
+};
+/** Which parts of the window are checked, or null while the syntax that decides it is loading. */
+export declare function spellcheckRegions(input: SpellcheckRegionInput): SpellcheckRegions | null;
+//# sourceMappingURL=proseRanges.d.ts.map

package/dist/proseRanges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proseRanges.d.ts","sourceRoot":"","sources":["../src/proseRanges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,oGAAoG;AACpG,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,cAAc,CAAA;AAEtD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI,CAAA;IACtD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;IACzC,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;CAC7C,CAAA;AAaD,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,qBAAqB,GAAG,iBAAiB,GAAG,IAAI,CAiBxF"}