@spyglassmc/core 0.4.4 → 0.4.6

package/lib/processor/completer/builtin.d.ts

@@ -1,6 +1,6 @@
 import type { DeepReadonly } from '../../common/index.js';
 import type { BooleanBaseNode } from '../../node/BooleanNode.js';
-import type { FileNode, LiteralBaseNode, PairNode, RecordBaseNode, ResourceLocationNode, StringBaseNode, SymbolBaseNode } from '../../node/index.js';
+import type { FileNode, LiteralBaseNode, PairNode, Quote, RecordBaseNode, ResourceLocationNode, StringBaseNode, SymbolBaseNode } from '../../node/index.js';
 import { AstNode } from '../../node/index.js';
 import type { CompleterContext, MetaRegistry } from '../../service/index.js';
 import type { RangeLike } from '../../source/index.js';
@@ -20,11 +20,12 @@ export declare const literal: Completer<LiteralBaseNode>;
 export declare const noop: Completer<any>;
 interface RecordOptions<K extends AstNode, V extends AstNode, N extends RecordBaseNode<K, V>> {
     key: (record: DeepReadonly<N>, pair: DeepReadonly<PairNode<K, V>> | undefined, ctx: CompleterContext, range: RangeLike, insertValue: boolean, insertPairEnd: boolean, existingKeys: DeepReadonly<K>[]) => CompletionItem[];
-    value: (record: DeepReadonly<N>, pair: DeepReadonly<PairNode<K, V>>, ctx: CompleterContext) => CompletionItem[];
+    value: (record: DeepReadonly<N>, pair: DeepReadonly<PairNode<K, V>>, ctx: CompleterContext, range: RangeLike) => CompletionItem[];
 }
 export declare function record<K extends AstNode, V extends AstNode, N extends RecordBaseNode<K, V>>(o: RecordOptions<K, V, N>): Completer<N>;
 export declare const resourceLocation: Completer<ResourceLocationNode>;
 export declare const string: Completer<StringBaseNode>;
+export declare function escapeString(value: string, quote?: Quote): string;
 export declare const symbol: Completer<SymbolBaseNode>;
 export declare function registerCompleters(meta: MetaRegistry): void;
 export {};

package/lib/processor/completer/builtin.js

@@ -3,6 +3,7 @@ import { ResourceLocation } from '../../common/index.js';
 import { AstNode } from '../../node/index.js';
 import { LinterConfigValue } from '../../service/index.js';
 import { Range } from '../../source/index.js';
+import { SymbolUtil } from '../../symbol/index.js';
 import { CompletionItem } from './Completer.js';
 /**
  * Uses the shallowest selected node that has its own completer to provide the completion items.
@@ -43,10 +44,22 @@ export const literal = (node) => {
         ['resourceLocation', 17 /* CompletionKind.File */],
         ['variable', 6 /* CompletionKind.Variable */],
     ]).get(node.options.colorTokenType ?? 'keyword') ?? 14 /* CompletionKind.Keyword */;
-    return (node.options.pool.map((v) => CompletionItem.create(v, node, { kind })) ??
-        []);
+    return (node.options.pool.map((v) => CompletionItem.create(v, node, { kind })) ?? []);
 };
 export const noop = () => [];
+const prefixed = (node, ctx) => {
+    const child = node.children.find(c => c.type !== 'literal');
+    if (!child) {
+        return [CompletionItem.create('!', node)];
+    }
+    const childItems = dispatch(child, ctx);
+    return childItems.map(item => ({
+        ...item,
+        label: node.prefix + item.label,
+        filterText: node.prefix + (item.filterText ?? item.label),
+        insertText: node.prefix + (item.insertText ?? item.label),
+    }));
+};
 export function record(o) {
     return (node, ctx) => {
         if (!Range.contains(Range.translate(node, 1, -1), ctx.offset, true)) {
@@ -54,9 +67,7 @@ export function record(o) {
         }
         const completeKeys = (pair) => o.key(node, pair, ctx, pair?.key ?? ctx.offset, false, false, existingKeys);
         const completePairs = (pair) => o.key(node, pair, ctx, pair ?? ctx.offset, true, hasNextPair || !!pair?.end, existingKeys);
-        const existingKeys = node.children
-            .filter((n) => !!n.key)
-            .map((n) => n.key);
+        const existingKeys = node.children.filter((n) => !!n.key).map((n) => n.key);
         const index = binarySearch(node.children, ctx.offset, (n, o) => n.end
             ? Range.compareOffset(Range.translate(n, 0, -1), o, true)
             : Range.compareOffset(n.range, o, true));
@@ -69,33 +80,35 @@ export function record(o) {
         if (!key && !sep && !value) {
             return completePairs(undefined);
         }
-        if ((key && Range.contains(key, ctx.offset, true)) ||
-            (sep && ctx.offset <= sep.start) ||
-            (value && ctx.offset < value.range.start)) {
+        if ((key && Range.contains(key, ctx.offset, true)) || (sep && ctx.offset <= sep.start)) {
             // Selected key.
             if (!value || Range.isEmpty(value.range)) {
                 return completePairs(pair);
             }
             return completeKeys(pair);
         }
-        if ((value && Range.contains(value, ctx.offset, true)) ||
-            (sep && ctx.offset >= sep.end) ||
-            (key && ctx.offset > key.range.end)) {
+        if (value && ctx.offset < value.range.start) {
+            return o.value(node, pair, ctx, ctx.offset);
+        }
+        if ((value && Range.contains(value, ctx.offset, true))
+            || (sep && ctx.offset >= sep.end)
+            || (key && ctx.offset > key.range.end)) {
             // Selected value.
-            return o.value(node, pair, ctx);
+            return o.value(node, pair, ctx, value ?? ctx.offset);
         }
         return [];
     };
 }
 export const resourceLocation = (node, ctx) => {
     const config = LinterConfigValue.destruct(ctx.config.lint.idOmitDefaultNamespace);
-    const includeEmptyNamespace = !node.options.isPredicate &&
-        node.namespace === '';
-    const includeDefaultNamespace = node.options.isPredicate ||
-        config?.ruleValue !== true;
-    const excludeDefaultNamespace = !node.options.isPredicate &&
-        config?.ruleValue !== false;
-    const getPool = (category) => optimizePool(Object.keys(ctx.symbols.getVisibleSymbols(category, ctx.doc.uri)));
+    const includeEmptyNamespace = !node.options.requireCanonical && node.namespace === '';
+    const includeDefaultNamespace = node.options.requireCanonical || config?.ruleValue !== true;
+    const excludeDefaultNamespace = !node.options.requireCanonical && config?.ruleValue !== false;
+    const getPool = (category) => {
+        const symbols = ctx.symbols.getVisibleSymbols(category, ctx.doc.uri);
+        const declarations = Object.entries(symbols).flatMap(([key, symbol]) => SymbolUtil.isDeclared(symbol) ? [key] : []);
+        return optimizePool(declarations);
+    };
     const optimizePool = (pool) => {
         const defaultNsPrefix = `${ResourceLocation.DefaultNamespace}${ResourceLocation.NamespacePathSep}`;
         const defaultNsIds = [];
@@ -131,12 +144,32 @@ export const resourceLocation = (node, ctx) => {
                 ? getPool(`tag/${node.options.category}`).map((v) => `${ResourceLocation.TagPrefix}${v}`)
                 : []),
         ];
-    return pool.map((v) => CompletionItem.create(v, node, { kind: 3 /* CompletionKind.Function */ }));
+    const items = pool.map((v) => CompletionItem.create(v, node, { kind: 3 /* CompletionKind.Function */ }));
+    if (node.options.category) {
+        const symbols = ctx.symbols.getVisibleSymbols(node.options.category, ctx.doc.uri);
+        const thisKey = Object.entries(symbols).flatMap(([key, symbol]) => {
+            if ((symbol.declaration?.[0] ?? symbol.definition?.[0])?.uri == ctx.doc.uri) {
+                return [key];
+            }
+            return [];
+        });
+        if (thisKey.length > 0) {
+            items.push(CompletionItem.create('THIS', node, {
+                kind: 15 /* CompletionKind.Snippet */,
+                insertText: thisKey[0],
+                detail: thisKey[0],
+            }));
+        }
+    }
+    return items;
 };
 export const string = (node, ctx) => {
     if (node.children?.length) {
-        // FIXME: Escape quotes/slashes in the result. Note that `\`, `$`, and `}` have to be escaped due to TextMate syntax.
-        return dispatch(node.children[0], ctx);
+        return dispatch(node.children[0], ctx).map(item => ({
+            ...item,
+            filterText: escapeString(item.filterText ?? item.label, node.quote),
+            insertText: escapeString(item.insertText ?? item.label, node.quote),
+        }));
     }
     if (node.options.quotes && node.value === '') {
         return node.options.quotes.map((q) => CompletionItem.create(`${q}${q}`, node, {
@@ -146,8 +179,18 @@ export const string = (node, ctx) => {
     }
     return [];
 };
+export function escapeString(value, quote) {
+    if (!quote) {
+        return value;
+    }
+    return value.replaceAll('\\', '\\\\').replaceAll(quote, '\\"');
+}
 export const symbol = (node, ctx) => {
-    return Object.keys(ctx.symbols.query(ctx.doc, node.options.category, ...(node.options.parentPath ?? [])).visibleMembers).map((v) => CompletionItem.create(v, node, { kind: 6 /* CompletionKind.Variable */ }));
+    const path = node.options.parentPath ?? [];
+    const symbols = ctx.symbols.query(ctx.doc, node.options.category, ...path).visibleMembers;
+    return Object.entries(symbols)
+        .filter(([k, v]) => SymbolUtil.isDeclared(v))
+        .map(([k, v]) => CompletionItem.create(k, node, { kind: 6 /* CompletionKind.Variable */ }));
 };
 export function registerCompleters(meta) {
     meta.registerCompleter('boolean', boolean);
@@ -156,6 +199,7 @@ export function registerCompleters(meta) {
     meta.registerCompleter('integer', noop);
     meta.registerCompleter('long', noop);
     meta.registerCompleter('literal', literal);
+    meta.registerCompleter('prefixed', prefixed);
     meta.registerCompleter('resource_location', resourceLocation);
     meta.registerCompleter('string', string);
     meta.registerCompleter('symbol', symbol);

package/lib/processor/formatter/Formatter.js

@@ -1,8 +1,6 @@
 export function formatterContextIndentation(ctx, additionalLevels = 0) {
     const total = ctx.indentLevel + additionalLevels;
-    return ctx.insertSpaces
-        ? ' '.repeat(total * ctx.tabSize)
-        : '\t'.repeat(total);
+    return ctx.insertSpaces ? ' '.repeat(total * ctx.tabSize) : '\t'.repeat(total);
 }
 export function indentFormatter(ctx, additionalLevels = 1) {
     return {

package/lib/processor/formatter/builtin.js

@@ -3,11 +3,9 @@ export const fallback = (node) => {
     throw new Error(`No formatter registered for type ${node.type}`);
 };
 export const file = (node, ctx) => {
-    return node.children
-        .map((child) => {
+    return node.children.map((child) => {
         return ctx.meta.getFormatter(child.type)(child, ctx);
-    })
-        .join('');
+    }).join('');
 };
 export const boolean = (node) => {
     return node.value ? 'true' : 'false';

package/lib/processor/linter/builtin/undeclaredSymbol.js

@@ -1,37 +1,24 @@
+import { localeQuote, localize } from '@spyglassmc/locales';
 import { Arrayable, ResourceLocation } from '../../../common/index.js';
-import { SymbolLinterConfig as Config } from '../../../service/index.js';
-// import { localeQuote, localize } from '@spyglassmc/locales'
-// import type { DeepReadonly } from '../../../common/index.js'
-// import { Arrayable, ResourceLocation } from '../../../common/index.js'
-// import type { AstNode } from '../../../node/index.js'
-// import type { LinterContext } from '../../../service/index.js'
-// import { LinterSeverity, SymbolLinterConfig as Config } from '../../../service/index.js'
-// import type { Symbol } from '../../../symbol/index.js'
-// import { SymbolUtil, SymbolVisibility } from '../../../symbol/index.js'
-// import type { Linter } from '../Linter.js'
+import { LinterSeverity, SymbolLinterConfig as Config } from '../../../service/index.js';
+import { SymbolUtil } from '../../../symbol/index.js';
 export const undeclaredSymbol = (node, ctx) => {
-    // if (!node.symbol || SymbolUtil.isDeclared(node.symbol)) {
-    // 	return
-    // }
-    // const action = getAction(ctx.ruleValue as Config, node.symbol, ctx)
-    // if (Config.Action.isDeclare(action)) {
-    // 	ctx.symbols
-    // 		.query({ doc: ctx.doc, node }, node.symbol.category, ...node.symbol.path)
-    // 		.amend({
-    // 			data: { visibility: getVisibility(action.declare) },
-    // 			usage: { type: 'declaration', node },
-    // 		})
-    // }
-    // if (Config.Action.isReport(action)) {
-    // 	const severityOverride = action.report === 'inherit' ? undefined : LinterSeverity.toErrorSeverity(action.report)
-    // 	ctx.err.lint(
-    // 		localize('linter.undeclared-symbol.message',
-    // 			node.symbol.category,
-    // 			localeQuote(node.symbol.identifier)
-    // 		),
-    // 		node, undefined, severityOverride
-    // 	)
-    // }
+    if (!node.symbol || SymbolUtil.isDeclared(node.symbol)) {
+        return;
+    }
+    const action = getAction(ctx.ruleValue, node.symbol, ctx);
+    if (Config.Action.isDeclare(action)) {
+        ctx.symbols.query({ doc: ctx.doc, node }, node.symbol.category, ...node.symbol.path).amend({
+            data: { visibility: getVisibility(action.declare) },
+            usage: { type: 'declaration', node },
+        });
+    }
+    if (Config.Action.isReport(action)) {
+        const severityOverride = action.report === 'inherit'
+            ? undefined
+            : LinterSeverity.toErrorSeverity(action.report);
+        ctx.err.lint(localize('linter.undeclared-symbol.message', node.symbol.category, localeQuote(node.symbol.identifier)), node, undefined, severityOverride);
+    }
 };
 function getAction(config, symbol, ctx) {
     if (Config.Action.is(config)) {
@@ -43,17 +30,17 @@ function getAction(config, symbol, ctx) {
             const namespace = resourceLocation.slice(0, resourceLocation.indexOf(ResourceLocation.NamespacePathSep));
             return ((condition.category
                 ? Arrayable.toArray(condition.category).includes(symbol.category)
-                : true) &&
-                (condition.namespace
+                : true)
+                && (condition.namespace
                     ? Arrayable.toArray(condition.namespace).includes(namespace)
-                    : true) &&
-                (condition.excludeNamespace
+                    : true)
+                && (condition.excludeNamespace
                     ? !Arrayable.toArray(condition.excludeNamespace).includes(namespace)
-                    : true) &&
-                (condition.pattern
+                    : true)
+                && (condition.pattern
                     ? Arrayable.toArray(condition.pattern).some((p) => new RegExp(p).test(symbol.identifier))
-                    : true) &&
-                (condition.excludePattern
+                    : true)
+                && (condition.excludePattern
                     ? !Arrayable.toArray(condition.excludePattern).some((p) => new RegExp(p).test(symbol.identifier))
                     : true));
         }

package/lib/service/CacheService.d.ts

@@ -7,7 +7,7 @@ import type { Project } from './Project.js';
  * The format version of the cache. Should be increased when any changes that
  * could invalidate the cache are introduced to the Spyglass codebase.
  */
-export declare const LatestCacheVersion = 2;
+export declare const LatestCacheVersion = 3;
 /**
  * Checksums of cached files or roots.
  */

package/lib/service/CacheService.js

@@ -5,15 +5,11 @@ import { fileUtil } from './fileUtil.js';
  * The format version of the cache. Should be increased when any changes that
  * could invalidate the cache are introduced to the Spyglass codebase.
  */
-export const LatestCacheVersion = 2;
+export const LatestCacheVersion = 3;
 var Checksums;
 (function (Checksums) {
     function create() {
-        return {
-            files: {},
-            roots: {},
-            symbolRegistrars: {},
-        };
+        return { files: {}, roots: {}, symbolRegistrars: {} };
     }
     Checksums.create = create;
 })(Checksums || (Checksums = {}));
@@ -36,8 +32,7 @@ export class CacheService {
             }
             try {
                 // TODO: Don't update this for every single change.
-                this.checksums.files[doc.uri] = await this.project.externals.crypto
-                    .getSha1(doc.getText());
+                this.checksums.files[doc.uri] = await this.project.externals.crypto.getSha1(doc.getText());
             }
             catch (e) {
                 if (!this.project.externals.error.isKind(e, 'EISDIR')) {
@@ -128,7 +123,11 @@ export class CacheService {
             }
         }
         for (const [uri, checksum] of Object.entries(this.checksums.files)) {
-            if (unchangedRoots.some((root) => uri.startsWith(root))) {
+            if (unchangedRoots.some((root) => fileUtil.isSubUriOf(uri, root))) {
+                ans.unchangedFiles.push(uri);
+                continue;
+            }
+            if (this.project.ignore.ignores(uri)) {
                 ans.unchangedFiles.push(uri);
                 continue;
             }
@@ -142,8 +141,8 @@ export class CacheService {
                 }
             }
             catch (e) {
-                if (this.project.externals.error.isKind(e, 'ENOENT') ||
-                    this.project.externals.error.isKind(e, 'EISDIR')) {
+                if (this.project.externals.error.isKind(e, 'ENOENT')
+                    || this.project.externals.error.isKind(e, 'EISDIR')) {
                     ans.removedFiles.push(uri);
                 }
                 else {
@@ -187,8 +186,8 @@ export class CacheService {
         return false;
     }
     async hasFileChangedSinceCache(doc) {
-        return (this.checksums.files[doc.uri] !==
-            (await this.project.externals.crypto.getSha1(doc.getText())));
+        return (this.checksums.files[doc.uri]
+            !== (await this.project.externals.crypto.getSha1(doc.getText())));
     }
     reset() {
         this.#hasValidatedFiles = false;

package/lib/service/Config.d.ts

@@ -21,6 +21,28 @@ export interface Config {
      */
     snippet: SnippetsConfig;
 }
+export interface CustomResourceConfig {
+    /**
+     * The entry you have dispatched from mcdoc. (eg. `picoblaze:game_event`)
+     */
+    category: string;
+    /**
+     * The file extension name of the dispatched resource. Only `.json` is supported for now.
+     */
+    ext?: '.json';
+    /**
+     * The pack type of the dispatched resource. Only `data` is supported for now.
+     */
+    pack?: 'data';
+    /**
+     * The first minecraft version the dispatched resource is available in.
+     */
+    since?: `1.${number}`;
+    /**
+     * The first minecraft version the dispatched resource is no longer available in.
+     */
+    until?: `1.${number}`;
+}
 export interface EnvConfig {
     /**
      * Where to download data like `mcmeta` or `vanilla-mcdoc` from (case-insensitive).
@@ -36,6 +58,20 @@ export interface EnvConfig {
      * to a data pack folder or data pack archive (e.g. `.zip` or `.tar.gz`), or a special string like `@vanilla-mcdoc`.
      */
     dependencies: string[];
+    /**
+     * A list of file patterns to exclude. Each value in this array can either be a glob pattern or the special string `@gitignore`.
+     */
+    exclude: string[];
+    /**
+     * **Experimental feature, breaking changes could occur.**
+     *
+     * Track changes at [issue #1254](https://github.com/SpyglassMC/Spyglass/issues/1254).
+     *
+     * Custom resources, currently only works for `minecraft:resource` JSON definitions dispatched from mcdoc.
+     */
+    customResources: {
+        [path: string]: CustomResourceConfig;
+    };
     feature: {
         codeActions: boolean;
         colors: boolean;

package/lib/service/Config.js

@@ -4,10 +4,10 @@ import { FileCategories, RegistryCategories } from '../symbol/index.js';
 export var LinterSeverity;
 (function (LinterSeverity) {
     function is(value) {
-        return (value === 'hint' ||
-            value === 'information' ||
-            value === 'warning' ||
-            value === 'error');
+        return (value === 'hint'
+            || value === 'information'
+            || value === 'warning'
+            || value === 'error');
     }
     LinterSeverity.is = is;
     function toErrorSeverity(value) {
@@ -31,21 +31,12 @@ export var LinterConfigValue;
             return undefined;
         }
         if (LinterSeverity.is(value)) {
-            return {
-                ruleSeverity: LinterSeverity.toErrorSeverity(value),
-                ruleValue: true,
-            };
+            return { ruleSeverity: LinterSeverity.toErrorSeverity(value), ruleValue: true };
         }
         if (Array.isArray(value) && LinterSeverity.is(value[0])) {
-            return {
-                ruleSeverity: LinterSeverity.toErrorSeverity(value[0]),
-                ruleValue: value[1],
-            };
+            return { ruleSeverity: LinterSeverity.toErrorSeverity(value[0]), ruleValue: value[1] };
         }
-        return {
-            ruleSeverity: 2 /* ErrorSeverity.Warning */,
-            ruleValue: value,
-        };
+        return { ruleSeverity: 2 /* ErrorSeverity.Warning */, ruleValue: value };
     }
     LinterConfigValue.destruct = destruct;
 })(LinterConfigValue || (LinterConfigValue = {}));
@@ -62,10 +53,9 @@ export var SymbolLinterConfig;
                 return false;
             }
             const value = v;
-            return ((value.if === undefined || Arrayable.is(value.if, Condition.is)) &&
-                (value.then === undefined || Action.is(value.then)) &&
-                (value.override === undefined ||
-                    Arrayable.is(value.override, Complex.is)));
+            return ((value.if === undefined || Arrayable.is(value.if, Condition.is))
+                && (value.then === undefined || Action.is(value.then))
+                && (value.override === undefined || Arrayable.is(value.override, Complex.is)));
         }
         Complex.is = is;
     })(Complex = SymbolLinterConfig.Complex || (SymbolLinterConfig.Complex = {}));
@@ -76,29 +66,28 @@ export var SymbolLinterConfig;
                 return false;
             }
             const value = v;
-            return ((value.category === undefined ||
-                Arrayable.is(value.category, TypePredicates.isString)) &&
-                (value.pattern === undefined ||
-                    Arrayable.is(value.pattern, TypePredicates.isString)) &&
-                (value.excludePattern === undefined ||
-                    Arrayable.is(value.excludePattern, TypePredicates.isString)) &&
-                (value.namespace === undefined ||
-                    Arrayable.is(value.namespace, TypePredicates.isString)) &&
-                (value.excludeNamespace === undefined ||
-                    Arrayable.is(value.excludeNamespace, TypePredicates.isString)));
+            return ((value.category === undefined
+                || Arrayable.is(value.category, TypePredicates.isString))
+                && (value.pattern === undefined || Arrayable.is(value.pattern, TypePredicates.isString))
+                && (value.excludePattern === undefined
+                    || Arrayable.is(value.excludePattern, TypePredicates.isString))
+                && (value.namespace === undefined
+                    || Arrayable.is(value.namespace, TypePredicates.isString))
+                && (value.excludeNamespace === undefined
+                    || Arrayable.is(value.excludeNamespace, TypePredicates.isString)));
         }
         Condition.is = is;
     })(Condition = SymbolLinterConfig.Condition || (SymbolLinterConfig.Condition = {}));
     let Action;
     (function (Action) {
         function isDeclare(value) {
-            return (value !== undefined &&
-                ['block', 'file', 'public'].includes(value.declare));
+            return (value !== undefined
+                && ['block', 'file', 'public'].includes(value.declare));
         }
         Action.isDeclare = isDeclare;
         function isReport(value) {
-            return (value !== undefined &&
-                ['inherit', 'hint', 'information', 'warning', 'error'].includes(value.report));
+            return (value !== undefined
+                && ['inherit', 'hint', 'information', 'warning', 'error'].includes(value.report));
         }
         Action.isReport = isReport;
         function is(v) {
@@ -117,10 +106,9 @@ export var SymbolLinterConfig;
 export const VanillaConfig = {
     env: {
         dataSource: 'GitHub',
-        dependencies: [
-            '@vanilla-datapack',
-            '@vanilla-mcdoc',
-        ],
+        dependencies: ['@vanilla-datapack', '@vanilla-mcdoc'],
+        exclude: ['@gitignore', '.vscode/', '.github/'],
+        customResources: {},
         feature: {
             codeActions: true,
             colors: true,
@@ -204,9 +192,7 @@ export const VanillaConfig = {
             {
                 if: [
                     { category: RegistryCategories, namespace: 'minecraft' },
-                    {
-                        category: [...FileCategories, 'bossbar', 'objective', 'team'],
-                    },
+                    { category: [...FileCategories, 'bossbar', 'objective', 'team'] },
                 ],
                 then: { report: 'warning' },
             },
@@ -223,10 +209,7 @@ export const VanillaConfig = {
 export class ConfigService {
     project;
     defaultConfig;
-    static ConfigFileNames = Object.freeze([
-        'spyglass.json',
-        '.spyglassrc.json',
-    ]);
+    static ConfigFileNames = Object.freeze(['spyglass.json', '.spyglassrc.json']);
     #eventEmitter;
     constructor(project, defaultConfig = VanillaConfig) {
         this.project = project;

package/lib/service/Context.d.ts

@@ -13,6 +13,7 @@ import type { ProfilerFactory } from './Profiler.js';
 import type { ProjectData } from './Project.js';
 export interface ContextBase {
     fs: FileService;
+    isDebugging: boolean;
     logger: Logger;
     meta: MetaRegistry;
     profilers: ProfilerFactory;
@@ -137,6 +138,7 @@ export declare namespace SignatureHelpProviderContext {
     function create(project: ProjectData, opts: SignatureHelpProviderContextOptions): SignatureHelpProviderContext;
 }
 export interface UriBinderContext extends ContextBase {
+    config: Config;
     symbols: SymbolUtil;
 }
 export declare namespace UriBinderContext {

package/lib/service/Context.js

@@ -7,6 +7,7 @@ export var ContextBase;
     function create(project) {
         return {
             fs: project.fs,
+            isDebugging: project.isDebugging,
             logger: project.logger,
             meta: project.meta,
             profilers: project.profilers,
@@ -44,20 +45,14 @@ export var ProcessorContext;
 var ProcessorWithRangeContext;
 (function (ProcessorWithRangeContext) {
     function create(project, opts) {
-        return {
-            ...ProcessorContext.create(project, opts),
-            range: opts.range,
-        };
+        return { ...ProcessorContext.create(project, opts), range: opts.range };
     }
     ProcessorWithRangeContext.create = create;
 })(ProcessorWithRangeContext || (ProcessorWithRangeContext = {}));
 var ProcessorWithOffsetContext;
 (function (ProcessorWithOffsetContext) {
     function create(project, opts) {
-        return {
-            ...ProcessorContext.create(project, opts),
-            offset: opts.offset,
-        };
+        return { ...ProcessorContext.create(project, opts), offset: opts.offset };
     }
     ProcessorWithOffsetContext.create = create;
 })(ProcessorWithOffsetContext || (ProcessorWithOffsetContext = {}));
@@ -137,10 +132,7 @@ export var SignatureHelpProviderContext;
 export var UriBinderContext;
 (function (UriBinderContext) {
     function create(project) {
-        return {
-            ...ContextBase.create(project),
-            symbols: project.symbols,
-        };
+        return { ...ContextBase.create(project), config: project.config, symbols: project.symbols };
     }
     UriBinderContext.create = create;
 })(UriBinderContext || (UriBinderContext = {}));

package/lib/service/Downloader.d.ts

@@ -31,6 +31,9 @@ interface Job<R> {
     };
     transformer: (data: Uint8Array) => PromiseLike<R> | R;
     options?: ExternalDownloaderOptions;
+    /**
+     * If set, caches the result in memory. Time in milliseconds.
+     */
     ttl?: number;
 }
 export {};

package/lib/service/Downloader.js

@@ -13,9 +13,12 @@ export class Downloader {
     async download(job, out = {}) {
         const { id, cache, uri, options, transformer, ttl } = job;
         if (ttl && this.#memoryCache.has(uri)) {
-            const { buffer, time } = this.#memoryCache.get(uri);
-            if (time <= performance.now() + ttl) {
+            const memoryCacheEntry = this.#memoryCache.get(uri);
+            const { buffer, time, cacheUri, checksum } = memoryCacheEntry;
+            if (performance.now() <= time + ttl) {
                 this.logger.info(`[Downloader] [${id}] Skipped thanks to valid cache in memory`);
+                out.cacheUri = cacheUri;
+                out.checksum = checksum;
                 return await transformer(buffer);
             }
             else {
@@ -28,7 +31,8 @@ export class Downloader {
         if (cache) {
             const { checksumJob, checksumExtension } = cache;
             out.cacheUri = cacheUri = new Uri(`downloader/${id}`, this.cacheRoot).toString();
-            cacheChecksumUri = new Uri(`downloader/${id}${checksumExtension}`, this.cacheRoot).toString();
+            cacheChecksumUri = new Uri(`downloader/${id}${checksumExtension}`, this.cacheRoot)
+                .toString();
             try {
                 out.checksum = checksum = await this.download({
                     ...checksumJob,
@@ -42,6 +46,8 @@ export class Downloader {
                             if (ttl) {
                                 this.#memoryCache.set(uri, {
                                     buffer: cachedBuffer,
+                                    cacheUri,
+                                    checksum,
                                     time: performance.now(),
                                 });
                             }