@singapore-editor/tree-sitter 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+export { TreeSitterLanguageRegistry, createTreeSitterLanguageRegistry, isTreeSitterLanguageId, resolveTreeSitterLanguageAlias, resolveTreeSitterLanguageContribution, type TreeSitterLanguageAssets, type TreeSitterLanguageContribution, type TreeSitterLanguageDescriptor, type TreeSitterLanguageDisposable, type TreeSitterLanguageId, type TreeSitterLanguageRegistrationOptions, type TreeSitterLanguageResolver, } from './treeSitter/registry';
+export type { BracketInfo, FoldRange, TreeSitterCapture, TreeSitterError, TreeSitterInjectionInfo, TreeSitterParseResult, TreeSitterPoint, } from './treeSitter/types';
+export { canUseTreeSitterWorker, createTreeSitterWorkerBackend, TreeSitterWorkerClient, type TreeSitterBackend, type TreeSitterEditPayload, type TreeSitterParsePayload, type TreeSitterSelectionPayload, type TreeSitterWorkerCacheSnapshot, type TreeSitterWorkerLifecycleState, type TreeSitterWorkerOwnerSnapshot, } from './treeSitter/workerClient';
+export { createTreeSitterSourceDescriptor, readTreeSitterInputRange, readTreeSitterPieceTableInput, resolveTreeSitterSourceDescriptor, type TreeSitterSourceCache, type TreeSitterSourceDescriptor, } from './treeSitter/source';
+export type { TreeSitterSourceChunkRetentionSnapshot } from './treeSitter/sourceChunkRetention';
+export { TreeSitterSyntaxSession, createTextDiffEdit, createTreeSitterEditPayload, type TreeSitterSyntaxSessionOptions, } from './session';
+export { expandTreeSitterSelection, selectTreeSitterToken, shrinkTreeSitterSelection, type TreeSitterSelectionCommandOptions, type TreeSitterSelectionCommandResult, type TreeSitterSelectionExpansionState, } from './structuralSelection';
+import type { EditorSyntaxProvider } from '@singapore-editor/core/syntax';
+import type { EditorPlugin } from '@singapore-editor/core/extensions';
+import type { TreeSitterLanguageContribution, TreeSitterLanguageDisposable, TreeSitterLanguageId, TreeSitterLanguageRegistrationOptions, TreeSitterLanguageResolver } from './treeSitter/registry';
+import { type TreeSitterBackend } from './treeSitter/workerClient';
+export type TreeSitterSyntaxProviderOptions = {
+    readonly backend?: TreeSitterBackend;
+    /**
+     * Languages to compile ahead of their first document, read each time a document's first parse
+     * answers, so the host's set can change (a workspace switch) and paint is never delayed. Each is
+     * compiled once with its injection closure; unknown ids and load failures are skipped.
+     */
+    readonly warmLanguages?: () => readonly TreeSitterLanguageId[];
+};
+export type TreeSitterSyntaxProvider = EditorSyntaxProvider & TreeSitterLanguageResolver & {
+    registerLanguage(contribution: TreeSitterLanguageContribution, options?: TreeSitterLanguageRegistrationOptions): TreeSitterLanguageDisposable;
+};
+export type TreeSitterLanguagePluginOptions = TreeSitterLanguageRegistrationOptions & {
+    readonly name?: string;
+};
+export type TreeSitterSyntaxPluginOptions = {
+    readonly name?: string;
+};
+export declare const createTreeSitterSyntaxProvider: (options?: TreeSitterSyntaxProviderOptions) => TreeSitterSyntaxProvider;
+export declare const createTreeSitterLanguagePlugin: (contributions: readonly TreeSitterLanguageContribution[], options?: TreeSitterLanguagePluginOptions) => EditorPlugin;
+/** Registers an already-configured provider with an editor without constructing another backend. */
+export declare const createTreeSitterSyntaxPlugin: (provider: TreeSitterSyntaxProvider, options?: TreeSitterSyntaxPluginOptions) => EditorPlugin;
+//# 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,OAAO,EACL,0BAA0B,EAC1B,gCAAgC,EAChC,sBAAsB,EACtB,8BAA8B,EAC9B,qCAAqC,EACrC,KAAK,wBAAwB,EAC7B,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,qCAAqC,EAC1C,KAAK,0BAA0B,GAChC,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,GAChB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,GACnC,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACL,gCAAgC,EAChC,wBAAwB,EACxB,6BAA6B,EAC7B,iCAAiC,EACjC,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,GAChC,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,sCAAsC,EAAE,MAAM,mCAAmC,CAAA;AAC/F,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,2BAA2B,EAC3B,KAAK,8BAA8B,GACpC,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,iCAAiC,EACtC,KAAK,gCAAgC,EACrC,KAAK,iCAAiC,GACvC,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,KAAK,EAEV,YAAY,EAEb,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EAEV,8BAA8B,EAE9B,4BAA4B,EAC5B,oBAAoB,EACpB,qCAAqC,EACrC,0BAA0B,EAC3B,MAAM,uBAAuB,CAAA;AAI9B,OAAO,EAAiC,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAEjG,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IACpC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,SAAS,oBAAoB,EAAE,CAAA;CAC/D,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,GACzD,0BAA0B,GAAG;IAC3B,gBAAgB,CACd,YAAY,EAAE,8BAA8B,EAC5C,OAAO,CAAC,EAAE,qCAAqC,GAC9C,4BAA4B,CAAA;CAChC,CAAA;AAEH,MAAM,MAAM,+BAA+B,GAAG,qCAAqC,GAAG;IACpF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAsBD,eAAO,MAAM,8BAA8B,GACzC,UAAS,+BAAoC,KAC5C,wBAmCF,CAAA;AAuBD,eAAO,MAAM,8BAA8B,GACzC,eAAe,SAAS,8BAA8B,EAAE,EACxD,UAAS,+BAAoC,KAC5C,YASD,CAAA;AAEF,oGAAoG;AACpG,eAAO,MAAM,4BAA4B,GACvC,UAAU,wBAAwB,EAClC,UAAS,6BAAkC,KAC1C,YAGD,CAAA"}

package/dist/index.js

@@ -0,0 +1,143 @@
+import { TreeSitterLanguageRegistry, createTreeSitterLanguageRegistry, isTreeSitterLanguageId, resolveTreeSitterLanguageAlias, resolveTreeSitterLanguageClosure, resolveTreeSitterLanguageContribution } from "./treeSitter/registry.js";
+import { createTreeSitterSourceDescriptor, readTreeSitterInputRange, readTreeSitterPieceTableInput, resolveTreeSitterSourceDescriptor } from "./treeSitter/source.js";
+import { TreeSitterWorkerClient, canUseTreeSitterWorker, createTreeSitterWorkerBackend } from "./treeSitter/workerClient.js";
+import { TreeSitterSyntaxSession, createTextDiffEdit, createTreeSitterEditPayload } from "./session.js";
+import { expandTreeSitterSelection, selectTreeSitterToken, shrinkTreeSitterSelection, treeSitterSelectionRanges } from "./structuralSelection.js";
+//#region src/index.ts
+var DEFAULT_TREE_SITTER_PROVIDER_KEY = Symbol.for("@singapore-editor/tree-sitter/default-provider");
+var createTreeSitterSyntaxProvider = (options = {}) => {
+	const registry = new TreeSitterLanguageRegistry();
+	const backend = options.backend ?? createTreeSitterWorkerBackend();
+	let warmedKey = null;
+	const warm = () => {
+		const languageIds = options.warmLanguages?.() ?? [];
+		const key = languageIds.join("\n");
+		if (languageIds.length === 0 || key === warmedKey) return;
+		warmedKey = key;
+		warmTreeSitterLanguages(registry, backend, languageIds);
+	};
+	return {
+		createSession: (sessionOptions) => {
+			if (!sessionOptions.languageId) return null;
+			return new TreeSitterSyntaxSession({
+				...sessionOptions,
+				languageId: sessionOptions.languageId,
+				languageResolver: registry,
+				backend,
+				onFirstParse: warm
+			});
+		},
+		registerLanguage: (contribution, registrationOptions) => {
+			const registration = registry.registerLanguage(contribution, registrationOptions);
+			warmedKey = null;
+			return { dispose: () => {
+				registration.dispose();
+				warmedKey = null;
+			} };
+		},
+		resolveTreeSitterLanguage: (languageId) => registry.resolveTreeSitterLanguage(languageId)
+	};
+};
+var warmTreeSitterLanguages = async (resolver, backend, languageIds) => {
+	if (!backend.warmLanguages) return;
+	const closures = await Promise.allSettled(languageIds.map((languageId) => resolveTreeSitterLanguageClosure(resolver, languageId)));
+	const descriptors = /* @__PURE__ */ new Map();
+	for (const closure of closures) {
+		if (closure.status === "rejected") continue;
+		for (const descriptor of closure.value) if (!descriptors.has(descriptor.id)) descriptors.set(descriptor.id, descriptor);
+	}
+	await backend.warmLanguages([...descriptors.values()]).catch(() => void 0);
+};
+var createTreeSitterLanguagePlugin = (contributions, options = {}) => ({
+	name: options.name ?? "tree-sitter-languages",
+	activate(context) {
+		const registration = defaultProviderRegistration();
+		return [retainSyntaxProvider(context, registration), ...contributions.map((contribution) => retainLanguage(registration, contribution))];
+	}
+});
+/** Registers an already-configured provider with an editor without constructing another backend. */
+var createTreeSitterSyntaxPlugin = (provider, options = {}) => ({
+	name: options.name ?? "tree-sitter-syntax",
+	activate: (context) => contributeToEditor(context, provider)
+});
+var defaultProviderRegistration = () => {
+	const state = globalThis;
+	const existing = state[DEFAULT_TREE_SITTER_PROVIDER_KEY];
+	if (existing) return existing;
+	const registration = {
+		provider: createTreeSitterSyntaxProvider(),
+		contextReferences: /* @__PURE__ */ new WeakMap(),
+		languageReferences: /* @__PURE__ */ new Map()
+	};
+	state[DEFAULT_TREE_SITTER_PROVIDER_KEY] = registration;
+	return registration;
+};
+var retainSyntaxProvider = (context, registration) => {
+	const existing = registration.contextReferences.get(context);
+	if (existing) {
+		existing.references += 1;
+		return { dispose: () => releaseSyntaxProvider(context, registration) };
+	}
+	registration.contextReferences.set(context, {
+		contributions: contributeToEditor(context, registration.provider),
+		references: 1
+	});
+	return { dispose: () => releaseSyntaxProvider(context, registration) };
+};
+var contributeToEditor = (context, provider) => {
+	return [context.registerSyntaxProvider(provider), context.registerSelectionRangeProvider((selection) => treeSitterSelectionRanges(selection.folds))];
+};
+var retainLanguage = (registration, contribution) => {
+	const key = languageRegistrationKey(contribution);
+	const existing = registration.languageReferences.get(key);
+	if (existing) {
+		existing.references += 1;
+		return { dispose: () => releaseLanguage(registration, key) };
+	}
+	registration.languageReferences.set(key, {
+		disposable: registration.provider.registerLanguage(contribution, { replace: true }),
+		references: 1
+	});
+	return { dispose: () => releaseLanguage(registration, key) };
+};
+var releaseSyntaxProvider = (context, registration) => {
+	const reference = registration.contextReferences.get(context);
+	if (!reference) return;
+	reference.references -= 1;
+	if (reference.references > 0) return;
+	for (const contribution of reference.contributions.toReversed()) contribution.dispose();
+	registration.contextReferences.delete(context);
+};
+var releaseLanguage = (registration, key) => {
+	const reference = registration.languageReferences.get(key);
+	if (!reference) return;
+	reference.references -= 1;
+	if (reference.references > 0) return;
+	reference.disposable.dispose();
+	registration.languageReferences.delete(key);
+};
+var languageRegistrationKey = (contribution) => JSON.stringify({
+	aliases: sortedItems(contribution.aliases),
+	assets: inlineAssetSignature(contribution),
+	extensions: sortedItems(contribution.extensions),
+	id: contribution.id,
+	loader: lazyLoaderSignature(contribution)
+});
+var lazyLoaderSignature = (contribution) => {
+	if (!("load" in contribution)) return null;
+	return contribution.load?.toString() ?? null;
+};
+var inlineAssetSignature = (contribution) => {
+	if ("load" in contribution) return null;
+	return {
+		foldQuerySource: contribution.foldQuerySource,
+		highlightQuerySource: contribution.highlightQuerySource,
+		injectionQuerySource: contribution.injectionQuerySource,
+		wasmUrl: contribution.wasmUrl
+	};
+};
+var sortedItems = (items) => (items ?? []).toSorted();
+//#endregion
+export { TreeSitterLanguageRegistry, TreeSitterSyntaxSession, TreeSitterWorkerClient, canUseTreeSitterWorker, createTextDiffEdit, createTreeSitterEditPayload, createTreeSitterLanguagePlugin, createTreeSitterLanguageRegistry, createTreeSitterSourceDescriptor, createTreeSitterSyntaxPlugin, createTreeSitterSyntaxProvider, createTreeSitterWorkerBackend, expandTreeSitterSelection, isTreeSitterLanguageId, readTreeSitterInputRange, readTreeSitterPieceTableInput, resolveTreeSitterLanguageAlias, resolveTreeSitterLanguageContribution, resolveTreeSitterSourceDescriptor, selectTreeSitterToken, shrinkTreeSitterSelection };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["export {\n  TreeSitterLanguageRegistry,\n  createTreeSitterLanguageRegistry,\n  isTreeSitterLanguageId,\n  resolveTreeSitterLanguageAlias,\n  resolveTreeSitterLanguageContribution,\n  type TreeSitterLanguageAssets,\n  type TreeSitterLanguageContribution,\n  type TreeSitterLanguageDescriptor,\n  type TreeSitterLanguageDisposable,\n  type TreeSitterLanguageId,\n  type TreeSitterLanguageRegistrationOptions,\n  type TreeSitterLanguageResolver,\n} from './treeSitter/registry'\nexport type {\n  BracketInfo,\n  FoldRange,\n  TreeSitterCapture,\n  TreeSitterError,\n  TreeSitterInjectionInfo,\n  TreeSitterParseResult,\n  TreeSitterPoint,\n} from './treeSitter/types'\nexport {\n  canUseTreeSitterWorker,\n  createTreeSitterWorkerBackend,\n  TreeSitterWorkerClient,\n  type TreeSitterBackend,\n  type TreeSitterEditPayload,\n  type TreeSitterParsePayload,\n  type TreeSitterSelectionPayload,\n  type TreeSitterWorkerCacheSnapshot,\n  type TreeSitterWorkerLifecycleState,\n  type TreeSitterWorkerOwnerSnapshot,\n} from './treeSitter/workerClient'\nexport {\n  createTreeSitterSourceDescriptor,\n  readTreeSitterInputRange,\n  readTreeSitterPieceTableInput,\n  resolveTreeSitterSourceDescriptor,\n  type TreeSitterSourceCache,\n  type TreeSitterSourceDescriptor,\n} from './treeSitter/source'\nexport type { TreeSitterSourceChunkRetentionSnapshot } from './treeSitter/sourceChunkRetention'\nexport {\n  TreeSitterSyntaxSession,\n  createTextDiffEdit,\n  createTreeSitterEditPayload,\n  type TreeSitterSyntaxSessionOptions,\n} from './session'\nexport {\n  expandTreeSitterSelection,\n  selectTreeSitterToken,\n  shrinkTreeSitterSelection,\n  type TreeSitterSelectionCommandOptions,\n  type TreeSitterSelectionCommandResult,\n  type TreeSitterSelectionExpansionState,\n} from './structuralSelection'\nimport type { EditorSyntaxProvider } from '@singapore-editor/core/syntax'\nimport type {\n  EditorDisposable,\n  EditorPlugin,\n  EditorPluginContext,\n} from '@singapore-editor/core/extensions'\nimport type {\n  TreeSitterLanguageAssets,\n  TreeSitterLanguageContribution,\n  TreeSitterLanguageDescriptor,\n  TreeSitterLanguageDisposable,\n  TreeSitterLanguageId,\n  TreeSitterLanguageRegistrationOptions,\n  TreeSitterLanguageResolver,\n} from './treeSitter/registry'\nimport { TreeSitterLanguageRegistry, resolveTreeSitterLanguageClosure } from './treeSitter/registry'\nimport { TreeSitterSyntaxSession } from './session'\nimport { treeSitterSelectionRanges } from './structuralSelection'\nimport { createTreeSitterWorkerBackend, type TreeSitterBackend } from './treeSitter/workerClient'\n\nexport type TreeSitterSyntaxProviderOptions = {\n  readonly backend?: TreeSitterBackend\n  /**\n   * Languages to compile ahead of their first document, read each time a document's first parse\n   * answers, so the host's set can change (a workspace switch) and paint is never delayed. Each is\n   * compiled once with its injection closure; unknown ids and load failures are skipped.\n   */\n  readonly warmLanguages?: () => readonly TreeSitterLanguageId[]\n}\n\nexport type TreeSitterSyntaxProvider = EditorSyntaxProvider &\n  TreeSitterLanguageResolver & {\n    registerLanguage(\n      contribution: TreeSitterLanguageContribution,\n      options?: TreeSitterLanguageRegistrationOptions,\n    ): TreeSitterLanguageDisposable\n  }\n\nexport type TreeSitterLanguagePluginOptions = TreeSitterLanguageRegistrationOptions & {\n  readonly name?: string\n}\n\nexport type TreeSitterSyntaxPluginOptions = {\n  readonly name?: string\n}\n\ntype TreeSitterProviderRegistration = {\n  readonly provider: TreeSitterSyntaxProvider\n  readonly contextReferences: WeakMap<EditorPluginContext, TreeSitterContextReference>\n  readonly languageReferences: Map<string, TreeSitterLanguageReference>\n}\n\ntype TreeSitterContextReference = {\n  contributions: readonly EditorDisposable[]\n  references: number\n}\n\ntype TreeSitterLanguageReference = {\n  disposable: TreeSitterLanguageDisposable\n  references: number\n}\n\nconst DEFAULT_TREE_SITTER_PROVIDER_KEY = Symbol.for(\n  '@singapore-editor/tree-sitter/default-provider',\n)\n\nexport const createTreeSitterSyntaxProvider = (\n  options: TreeSitterSyntaxProviderOptions = {},\n): TreeSitterSyntaxProvider => {\n  const registry = new TreeSitterLanguageRegistry()\n  const backend = options.backend ?? createTreeSitterWorkerBackend()\n  let warmedKey: string | null = null\n  const warm = () => {\n    const languageIds = options.warmLanguages?.() ?? []\n    const key = languageIds.join('\\n')\n    if (languageIds.length === 0 || key === warmedKey) return\n    warmedKey = key\n    void warmTreeSitterLanguages(registry, backend, languageIds)\n  }\n\n  return {\n    createSession: (sessionOptions) => {\n      if (!sessionOptions.languageId) return null\n      return new TreeSitterSyntaxSession({\n        ...sessionOptions,\n        languageId: sessionOptions.languageId,\n        languageResolver: registry,\n        backend,\n        onFirstParse: warm,\n      })\n    },\n    registerLanguage: (contribution, registrationOptions) => {\n      const registration = registry.registerLanguage(contribution, registrationOptions)\n      warmedKey = null\n      return {\n        dispose: () => {\n          registration.dispose()\n          warmedKey = null\n        },\n      }\n    },\n    resolveTreeSitterLanguage: (languageId) => registry.resolveTreeSitterLanguage(languageId),\n  }\n}\n\nconst warmTreeSitterLanguages = async (\n  resolver: TreeSitterLanguageResolver,\n  backend: TreeSitterBackend,\n  languageIds: readonly TreeSitterLanguageId[],\n): Promise<void> => {\n  if (!backend.warmLanguages) return\n\n  const closures = await Promise.allSettled(\n    languageIds.map((languageId) => resolveTreeSitterLanguageClosure(resolver, languageId)),\n  )\n  const descriptors = new Map<TreeSitterLanguageId, TreeSitterLanguageDescriptor>()\n  for (const closure of closures) {\n    if (closure.status === 'rejected') continue\n    for (const descriptor of closure.value) {\n      if (!descriptors.has(descriptor.id)) descriptors.set(descriptor.id, descriptor)\n    }\n  }\n  // Best effort: a worker that cannot start fails the first document too, which reports it.\n  await backend.warmLanguages([...descriptors.values()]).catch(() => undefined)\n}\n\nexport const createTreeSitterLanguagePlugin = (\n  contributions: readonly TreeSitterLanguageContribution[],\n  options: TreeSitterLanguagePluginOptions = {},\n): EditorPlugin => ({\n  name: options.name ?? 'tree-sitter-languages',\n  activate(context) {\n    const registration = defaultProviderRegistration()\n    return [\n      retainSyntaxProvider(context, registration),\n      ...contributions.map((contribution) => retainLanguage(registration, contribution)),\n    ]\n  },\n})\n\n/** Registers an already-configured provider with an editor without constructing another backend. */\nexport const createTreeSitterSyntaxPlugin = (\n  provider: TreeSitterSyntaxProvider,\n  options: TreeSitterSyntaxPluginOptions = {},\n): EditorPlugin => ({\n  name: options.name ?? 'tree-sitter-syntax',\n  activate: (context) => contributeToEditor(context, provider),\n})\n\nconst defaultProviderRegistration = (): TreeSitterProviderRegistration => {\n  const state = globalThis as Record<PropertyKey, unknown>\n  const existing = state[DEFAULT_TREE_SITTER_PROVIDER_KEY] as\n    | TreeSitterProviderRegistration\n    | undefined\n  if (existing) return existing\n\n  const registration = {\n    provider: createTreeSitterSyntaxProvider(),\n    contextReferences: new WeakMap<EditorPluginContext, TreeSitterContextReference>(),\n    languageReferences: new Map<string, TreeSitterLanguageReference>(),\n  }\n  state[DEFAULT_TREE_SITTER_PROVIDER_KEY] = registration\n  return registration\n}\n\nconst retainSyntaxProvider = (\n  context: EditorPluginContext,\n  registration: TreeSitterProviderRegistration,\n): EditorDisposable => {\n  const existing = registration.contextReferences.get(context)\n  if (existing) {\n    existing.references += 1\n    return { dispose: () => releaseSyntaxProvider(context, registration) }\n  }\n\n  registration.contextReferences.set(context, {\n    contributions: contributeToEditor(context, registration.provider),\n    references: 1,\n  })\n  return {\n    dispose: () => releaseSyntaxProvider(context, registration),\n  }\n}\n\nconst contributeToEditor = (\n  context: EditorPluginContext,\n  provider: TreeSitterSyntaxProvider,\n): readonly EditorDisposable[] => {\n  return [\n    context.registerSyntaxProvider(provider),\n    context.registerSelectionRangeProvider((selection) =>\n      treeSitterSelectionRanges(selection.folds),\n    ),\n  ]\n}\n\nconst retainLanguage = (\n  registration: TreeSitterProviderRegistration,\n  contribution: TreeSitterLanguageContribution,\n): EditorDisposable => {\n  const key = languageRegistrationKey(contribution)\n  const existing = registration.languageReferences.get(key)\n  if (existing) {\n    existing.references += 1\n    return { dispose: () => releaseLanguage(registration, key) }\n  }\n\n  registration.languageReferences.set(key, {\n    disposable: registration.provider.registerLanguage(contribution, { replace: true }),\n    references: 1,\n  })\n  return { dispose: () => releaseLanguage(registration, key) }\n}\n\nconst releaseSyntaxProvider = (\n  context: EditorPluginContext,\n  registration: TreeSitterProviderRegistration,\n): void => {\n  const reference = registration.contextReferences.get(context)\n  if (!reference) return\n\n  reference.references -= 1\n  if (reference.references > 0) return\n\n  for (const contribution of reference.contributions.toReversed()) contribution.dispose()\n  registration.contextReferences.delete(context)\n}\n\nconst releaseLanguage = (registration: TreeSitterProviderRegistration, key: string): void => {\n  const reference = registration.languageReferences.get(key)\n  if (!reference) return\n\n  reference.references -= 1\n  if (reference.references > 0) return\n\n  reference.disposable.dispose()\n  registration.languageReferences.delete(key)\n}\n\nconst languageRegistrationKey = (contribution: TreeSitterLanguageContribution): string =>\n  JSON.stringify({\n    aliases: sortedItems(contribution.aliases),\n    assets: inlineAssetSignature(contribution),\n    extensions: sortedItems(contribution.extensions),\n    id: contribution.id,\n    loader: lazyLoaderSignature(contribution),\n  })\n\nconst lazyLoaderSignature = (contribution: TreeSitterLanguageContribution): string | null => {\n  if (!('load' in contribution)) return null\n\n  return contribution.load?.toString() ?? null\n}\n\nconst inlineAssetSignature = (\n  contribution: TreeSitterLanguageContribution,\n): TreeSitterLanguageAssets | null => {\n  if ('load' in contribution) return null\n\n  return {\n    foldQuerySource: contribution.foldQuerySource,\n    highlightQuerySource: contribution.highlightQuerySource,\n    injectionQuerySource: contribution.injectionQuerySource,\n    wasmUrl: contribution.wasmUrl,\n  }\n}\n\nconst sortedItems = (items: readonly string[] | undefined): readonly string[] =>\n  (items ?? []).toSorted()\n"],"mappings":"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"}

package/dist/session.d.ts

@@ -0,0 +1,89 @@
+import { type DocumentSessionChange, type DocumentTextSnapshot, type PieceTableSnapshot, type TextEdit } from '@singapore-editor/core/document';
+import { type EditorSyntaxRange, type EditorSyntaxResult, type EditorSyntaxSession, type EditorSyntaxFoldingSupport } from '@singapore-editor/core/syntax';
+import type { TreeSitterLanguageId } from './treeSitter/types';
+import { type TreeSitterLanguageResolver } from './treeSitter/registry';
+import { type TreeSitterBackend, type TreeSitterBackendEditPayload, type TreeSitterEditPayload } from './treeSitter/workerClient';
+export type TreeSitterSyntaxSessionOptions = {
+    readonly documentId: string;
+    readonly runtimeSessionId?: string;
+    readonly languageId: TreeSitterLanguageId;
+    readonly languageResolver?: TreeSitterLanguageResolver;
+    readonly foldingSupport?: Exclude<EditorSyntaxFoldingSupport, 'pending'>;
+    readonly includeHighlights?: boolean;
+    readonly includeCaptures?: boolean;
+    readonly syntaxMode?: 'full' | 'range';
+    readonly textSnapshot: DocumentTextSnapshot;
+    readonly snapshot: PieceTableSnapshot;
+    readonly backend?: TreeSitterBackend;
+    /** Called once, after the session's first parse answers. */
+    readonly onFirstParse?: () => void;
+};
+export declare class TreeSitterSyntaxSession implements EditorSyntaxSession {
+    private readonly documentId;
+    private runtimeSessionId;
+    private readonly languageId;
+    private readonly languageResolver;
+    private readonly includeHighlights;
+    private readonly includeCaptures;
+    private readonly syntaxMode;
+    private readonly backend;
+    private snapshotVersion;
+    private parsedSnapshotVersion;
+    private textSnapshot;
+    private snapshot;
+    private result;
+    private currentFoldingSupport;
+    private languageRegistrationPromise;
+    private readonly pendingLanguages;
+    private disposed;
+    private onFirstParse;
+    constructor(options: TreeSitterSyntaxSessionOptions);
+    get foldingSupport(): EditorSyntaxFoldingSupport;
+    refresh(textSnapshot: DocumentTextSnapshot): Promise<EditorSyntaxResult>;
+    private notifyFirstParse;
+    applyChange(change: DocumentSessionChange): Promise<EditorSyntaxResult>;
+    queryRange(range: EditorSyntaxRange): Promise<EditorSyntaxResult>;
+    canQueryRange(): boolean;
+    getResult(): EditorSyntaxResult;
+    getTokens(): EditorSyntaxResult['tokens'];
+    getSnapshotVersion(): number;
+    dispose(): void;
+    private applyIncrementalEdit;
+    private reparseAfterIncrementalFailure;
+    private isCurrentSnapshotVersion;
+    private ensureLanguageRegistered;
+    private registerResolvedLanguage;
+    private registerMissingLanguages;
+    private resolveLanguageDependencies;
+    private updateFromUnavailableLanguage;
+    private updateFromTreeSitterResult;
+    private updateFromTreeSitterRangeResult;
+    private createRangeUnavailableResult;
+    private createEmptyResult;
+    private resultContext;
+    private languageConfiguration;
+    private snapshotTag;
+}
+type TreeSitterBaseEditPayloadOptions = {
+    readonly documentId: string;
+    readonly runtimeSessionId: string;
+    readonly languageId: TreeSitterLanguageId;
+    readonly previousSnapshotVersion: number;
+    readonly snapshotVersion: number;
+    readonly previousSnapshot: PieceTableSnapshot;
+    readonly nextSnapshot: PieceTableSnapshot;
+    readonly edits: readonly TextEdit[];
+    readonly includeHighlights?: boolean;
+    readonly includeCaptures?: boolean;
+};
+type TreeSitterEditPayloadOptions = TreeSitterBaseEditPayloadOptions & {
+    readonly resultMode?: 'full';
+};
+type TreeSitterParseOnlyEditPayloadOptions = TreeSitterBaseEditPayloadOptions & {
+    readonly resultMode: 'parseOnly';
+};
+export declare function createTreeSitterEditPayload(options: TreeSitterParseOnlyEditPayloadOptions): TreeSitterBackendEditPayload | null;
+export declare function createTreeSitterEditPayload(options: TreeSitterEditPayloadOptions): TreeSitterEditPayload | null;
+export declare const createTextDiffEdit: (previousText: string, nextText: string) => TextEdit | null;
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}