swpp-backends 3.0.0-alpha.1 → 3.0.0-alpha.100

package/{types/swpp/config/ConfigLoader.d.ts → dist/swpp/config/ConfigCluster.d.ts}

@@ -1,26 +1,12 @@
 import { COMMON_TYPE_COMP_ENV } from '../database/CompilationEnv';
 import { COMMON_TYPE_CROSS_DEP } from '../database/CrossDepCode';
 import { COMMON_TYPE_CROSS_ENV } from '../database/CrossEnv';
+import { COMMON_TYPE_DOM_CODE } from '../database/DomCode';
 import { COMMON_TYPE_RUNTIME_CORE } from '../database/RuntimeCoreCode';
 import { COMMON_KEY_RUNTIME_DEP, FunctionInBrowser } from '../database/RuntimeDepCode';
 import { COMMON_TYPE_RUNTIME_EVENT } from '../database/RuntimeEventCode';
-import { CompilationData, RuntimeData } from '../SwCompiler';
-export declare class ConfigLoader {
-    /** 支持的拓展名列表 */
-    private static readonly extensions;
-    private static jiti;
-    private config;
-    private isBuilt;
-    /**
-     * 加载一个配置文件，越早加载的优先级越高
-     * @param file
-     */
-    load(file: string): Promise<void>;
-    /** 将配置项的内容写入到环境中 */
-    write(runtime: RuntimeData, compilation: CompilationData): void;
-    /** 将新配置合并到已有配置中 */
-    private mergeConfig;
-}
+import { CompilationData } from '../SwCompiler';
+import { IndivisibleName, SwppConfigModifier } from './ConfigLoader';
 /** 定义一个通过 `export default` 导出的配置 */
 export declare function defineConfig(config: SwppConfigTemplate): SwppConfigTemplate;
 /** 定义一个通过 `export const compilationEnv` 导出的配置 */
@@ -33,8 +19,13 @@ export declare function defineRuntimeDep(config: SwppConfigRuntimeDep): SwppConf
 export declare function defineCrossDep(config: SwppConfigCrossDep): SwppConfigCrossDep;
 /** 定义一个通过 `export const runtimeCore` 导出的配置 */
 export declare function defineRuntimeCore(config: SwppConfigRuntimeCore): SwppConfigRuntimeCore;
+/** 定义一个通过 `export const domConfig` 导出的配置 */
+export declare function defineDomConfig(config: SwppConfigDomConfig): SwppConfigDomConfig;
 /** 定义一个通过 `export const runtimeEvent` 导出的配置 */
 export declare function defineRuntimeEvent(config: SwppConfigRuntimeEvent): SwppConfigRuntimeEvent;
+export type IndivisibleConfig<T> = {
+    [K in typeof IndivisibleName]: true;
+} & T;
 /**
  * 定义一个无法分割的对象配置，这对一些强依赖对象内部属性的设置很有用，可以避免对象被错误地拼接。
  *
@@ -68,7 +59,7 @@ export declare function defineRuntimeEvent(config: SwppConfigRuntimeEvent): Swpp
  * }
  * ```
  */
-export declare function defineIndivisibleConfig<T extends Record<string, any>>(value: T): T;
+export declare function defineIndivisibleConfig<T extends object>(value: T): IndivisibleConfig<T>;
 type ValueOrReturnValue<T> = T | ((this: CompilationData) => T);
 /**
  * SWPP 配置模板
@@ -77,17 +68,23 @@ type ValueOrReturnValue<T> = T | ((this: CompilationData) => T);
  */
 export interface SwppConfigTemplate {
     /** @see {SwppConfigCompilationEnv} */
-    compilationEnv: SwppConfigCompilationEnv;
+    compilationEnv?: SwppConfigCompilationEnv;
     /** @see {SwppConfigCrossEnv} */
-    crossEnv: SwppConfigCrossEnv;
+    crossEnv?: SwppConfigCrossEnv;
     /** @see {SwppConfigRuntimeDep} */
-    runtimeDep: SwppConfigRuntimeDep;
+    runtimeDep?: SwppConfigRuntimeDep;
     /** @see {SwppConfigCrossDep} */
-    crossDep: SwppConfigCrossDep;
+    crossDep?: SwppConfigCrossDep;
     /** @see {SwppConfigRuntimeCore} */
-    runtimeCore: SwppConfigRuntimeCore;
+    runtimeCore?: SwppConfigRuntimeCore;
     /** @see {SwppConfigRuntimeEvent} */
-    runtimeEvent: SwppConfigRuntimeEvent;
+    runtimeEvent?: SwppConfigRuntimeEvent;
+    /** @see {SwppConfigDomConfig} */
+    domConfig?: SwppConfigDomConfig;
+    /** 配置编辑器 */
+    modifier?: SwppConfigModifier;
+}
+export interface SwppConfigInterface {
 }
 /**
  * 运行时函数依赖。
@@ -121,7 +118,7 @@ export interface SwppConfigTemplate {
  */
 export type SwppConfigRuntimeDep = {
     [K in keyof COMMON_KEY_RUNTIME_DEP | string]?: K extends keyof COMMON_KEY_RUNTIME_DEP ? COMMON_KEY_RUNTIME_DEP[K]['default'] : FunctionInBrowser<any[], any>;
-};
+} & SwppConfigInterface;
 /**
  * 运行时核心功能.
  *
@@ -132,7 +129,7 @@ export type SwppConfigRuntimeDep = {
  */
 export type SwppConfigRuntimeCore = {
     [K in keyof COMMON_TYPE_RUNTIME_CORE | string]?: K extends keyof COMMON_TYPE_RUNTIME_CORE ? COMMON_TYPE_RUNTIME_CORE[K]['default'] : FunctionInBrowser<any[], any>;
-};
+} & SwppConfigInterface;
 /**
  * 运行时 & 编译期的函数依赖。
  *
@@ -168,7 +165,7 @@ export type SwppConfigRuntimeCore = {
  */
 export type SwppConfigCrossDep = {
     [K in keyof COMMON_TYPE_CROSS_DEP | string]?: K extends keyof COMMON_TYPE_CROSS_DEP ? COMMON_TYPE_CROSS_DEP[K]['default'] : any;
-};
+} & SwppConfigInterface;
 /**
  * 运行时事件注册。
  *
@@ -196,7 +193,7 @@ export type SwppConfigCrossDep = {
  */
 export type SwppConfigRuntimeEvent = {
     [K in keyof COMMON_TYPE_RUNTIME_EVENT | string]?: K extends keyof COMMON_TYPE_RUNTIME_EVENT ? COMMON_TYPE_RUNTIME_EVENT[K]['default'] : FunctionInBrowser<[Event], any>;
-};
+} & SwppConfigInterface;
 /**
  * 运行时 & 编译期环境变量。
  *
@@ -226,7 +223,7 @@ export type SwppConfigRuntimeEvent = {
  */
 export type SwppConfigCrossEnv = {
     [K in keyof COMMON_TYPE_CROSS_ENV | string]: ValueOrReturnValue<K extends keyof COMMON_TYPE_CROSS_ENV ? COMMON_TYPE_CROSS_ENV[K]['default'] : any>;
-};
+} & SwppConfigInterface;
 /**
  * 构建期使用的环境变量。
  *
@@ -240,5 +237,17 @@ export type SwppConfigCrossEnv = {
  */
 export type SwppConfigCompilationEnv = {
     [K in keyof COMMON_TYPE_COMP_ENV | string]?: K extends keyof COMMON_TYPE_COMP_ENV ? COMMON_TYPE_COMP_ENV[K]['default'] : any;
-};
+} & SwppConfigInterface;
+/**
+ * 运行时使用的常量、函数。
+ *
+ * 该配置项用于放置需要生成到 dom.js 中的内容。
+ *
+ * 对于每一项配置 `<KEY>: <value>`：<KEY> 是常量名或函数名，常量推荐大写下划线命名，函数推荐小写驼峰命名，<value> 是值。
+ *
+ * 该配置项中的值只能使用本配置项中包含的内容，不能使用其它编译期、运行期的内容。
+ */
+export type SwppConfigDomConfig = {
+    [K in keyof COMMON_TYPE_DOM_CODE | string]?: K extends keyof COMMON_TYPE_DOM_CODE ? COMMON_TYPE_DOM_CODE[K]['default'] : any;
+} & SwppConfigInterface;
 export {};

package/dist/swpp/config/ConfigCluster.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineConfig = defineConfig;
+exports.defineCompilationEnv = defineCompilationEnv;
+exports.defineCrossEnv = defineCrossEnv;
+exports.defineRuntimeDep = defineRuntimeDep;
+exports.defineCrossDep = defineCrossDep;
+exports.defineRuntimeCore = defineRuntimeCore;
+exports.defineDomConfig = defineDomConfig;
+exports.defineRuntimeEvent = defineRuntimeEvent;
+exports.defineIndivisibleConfig = defineIndivisibleConfig;
+const ConfigLoader_1 = require("./ConfigLoader");
+/** 定义一个通过 `export default` 导出的配置 */
+function defineConfig(config) {
+    return config;
+}
+/** 定义一个通过 `export const compilationEnv` 导出的配置 */
+function defineCompilationEnv(config) {
+    return config;
+}
+/** 定义一个通过 `export const crossEnv` 导出的配置 */
+function defineCrossEnv(config) {
+    return config;
+}
+/** 定义一个通过 `export const runtimeDep` 导出的配置 */
+function defineRuntimeDep(config) {
+    return config;
+}
+/** 定义一个通过 `export const crossDep` 导出的配置 */
+function defineCrossDep(config) {
+    return config;
+}
+/** 定义一个通过 `export const runtimeCore` 导出的配置 */
+function defineRuntimeCore(config) {
+    return config;
+}
+/** 定义一个通过 `export const domConfig` 导出的配置 */
+function defineDomConfig(config) {
+    return config;
+}
+/** 定义一个通过 `export const runtimeEvent` 导出的配置 */
+function defineRuntimeEvent(config) {
+    return config;
+}
+/**
+ * 定义一个无法分割的对象配置，这对一些强依赖对象内部属性的设置很有用，可以避免对象被错误地拼接。
+ *
+ * 默认情况下，当定义一个对象配置时，将允许从其它配置文件中合并一部分配置到对象中，比如：
+ *
+ * ```typescript
+ * // 当前配置
+ * exampleConfig.obj = {
+ *     value1: 'hello world'
+ * }
+ * // 如果还有一个配置文件中也声明了这个配置
+ * exampleConfig.obj = {
+ *     value2: 'hello swpp'
+ * }
+ * // 最终将合并生成如下配置
+ * exampleConfig.obj = {
+ *     value1: 'hello world',
+ *     value2: 'hello swpp'
+ * }
+ * ```
+ *
+ * 通过该函数，可以禁止 swpp 合并配置时仅选取对象的部分字段，要么全部使用 [value] 的值，要么完全不使用 [value] 的值。
+ *
+ * 放入到上述例子中，假如两个 obj 任意一个或多个通过 `defineIndivisibleConfig({ xxx: xxx })` 设置，最终的值将取决于两个配置文件的优先级，
+ * 若 `value2` 的优先级高将产生：
+ *
+ * ```typescript
+ * // 最终结果
+ * exampleConfig.obj = {
+ *     value2: 'hello swpp'
+ * }
+ * ```
+ */
+function defineIndivisibleConfig(value) {
+    Object.defineProperty(value, ConfigLoader_1.IndivisibleName, {
+        value: true,
+        writable: false,
+        configurable: false,
+        enumerable: false
+    });
+    return value;
+}

package/dist/swpp/config/ConfigLoader.d.ts

@@ -0,0 +1,56 @@
+import { CompilationData, RuntimeData } from '../SwCompiler';
+import { IndivisibleConfig, SwppConfigTemplate } from './ConfigCluster';
+export declare const IndivisibleName = "1indivisible__";
+export declare class ConfigLoader {
+    /** 支持的拓展名列表 */
+    private static readonly extensions;
+    private static jiti;
+    private config;
+    private modifierList;
+    /**
+     * 加载一个配置文件，越早加载的优先级越高
+     * @param file
+     */
+    load(file: string): Promise<void>;
+    /**
+     * 加载一个在代码层面编写的配置
+     */
+    loadFromCode(config: SwppConfigTemplate): void;
+    /** 将配置项的内容写入到环境中 */
+    generate(): Readonly<{
+        runtime: RuntimeData;
+        compilation: CompilationData;
+    }>;
+    /** 将新配置合并到已有配置中 */
+    private static mergeConfig;
+}
+/**
+ * 配置编辑器
+ */
+export interface SwppConfigModifier {
+    /**
+     * 自定义运行时和编译期的属性表
+     *
+     * 优先级越高越优先生效
+     */
+    build?: () => {
+        runtime: IndivisibleConfig<RuntimeData>;
+        compilation: IndivisibleConfig<CompilationData>;
+    };
+    /**
+     * 本函数用于向系统注册新的属性。
+     *
+     * 该函数内应当只调用 xxx.append 函数及其它工具函数，非必要不应当包含其它有副作用的操作。
+     *
+     * 优先级越低该函数越早执行。
+     */
+    registry?: (runtime: RuntimeData, compilation: CompilationData) => void;
+    /**
+     * 本函数用于动态修改属性的值。
+     *
+     * 该函数内应当只调用 xxx.update 函数及其它工具函数，非必要不应当包含其它有副作用的操作。
+     *
+     * 优先级越低该函数越早执行
+     */
+    dynamic?: (runtime: RuntimeData, compilation: CompilationData) => void;
+}

package/dist/swpp/config/ConfigLoader.js

@@ -3,22 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigLoader = void 0;
-exports.defineConfig = defineConfig;
-exports.defineCompilationEnv = defineCompilationEnv;
-exports.defineCrossEnv = defineCrossEnv;
-exports.defineRuntimeDep = defineRuntimeDep;
-exports.defineCrossDep = defineCrossDep;
-exports.defineRuntimeCore = defineRuntimeCore;
-exports.defineRuntimeEvent = defineRuntimeEvent;
-exports.defineIndivisibleConfig = defineIndivisibleConfig;
+exports.ConfigLoader = exports.IndivisibleName = void 0;
 const jiti_1 = require("jiti");
 const path_1 = __importDefault(require("path"));
+const SwCompiler_1 = require("../SwCompiler");
 const untils_1 = require("../untils");
-const IndivisibleName = '1indivisible__';
+exports.IndivisibleName = '1indivisible__';
 class ConfigLoader {
     constructor() {
-        this.isBuilt = false;
+        this.modifierList = [];
     }
     // noinspection JSUnusedGlobalSymbols
     /**
@@ -26,13 +19,7 @@ class ConfigLoader {
      * @param file
      */
     async load(file) {
-        if (this.isBuilt)
-            throw {
-                code: untils_1.exceptionNames.configBuilt,
-                message: '配置文件已经完成构建，不能继续加载新的配置',
-                file
-            };
-        const extensionName = path_1.default.extname(file);
+        const extensionName = path_1.default.extname(file).substring(1);
         if (!ConfigLoader.extensions.includes(extensionName)) {
             throw {
                 code: untils_1.exceptionNames.unsupportedFileType,
@@ -43,30 +30,50 @@ class ConfigLoader {
         // @ts-ignore
         const content = await ConfigLoader.jiti.import(file);
         let newConfig = 'default' in content ? content.default : content;
+        this.loadFromCode(newConfig);
+    }
+    /**
+     * 加载一个在代码层面编写的配置
+     */
+    loadFromCode(config) {
+        if ('modifier' in config) {
+            this.modifierList.push(config.modifier);
+        }
         if (this.config)
-            this.mergeConfig(newConfig);
+            ConfigLoader.mergeConfig(this.config, config);
         else
-            this.config = newConfig;
+            this.config = config;
     }
     // noinspection JSUnusedGlobalSymbols
     /** 将配置项的内容写入到环境中 */
-    write(runtime, compilation) {
+    generate() {
         if (!this.config)
             throw {
                 code: untils_1.exceptionNames.nullPoint,
                 message: '构建配之前必须至少加载一个配置文件'
             };
+        // 构建属性集
+        const { runtime, compilation } = (this.modifierList.find(it => it.build)?.build ?? (() => {
+            const compilation = new SwCompiler_1.CompilationData();
+            const runtime = new SwCompiler_1.RuntimeData(compilation);
+            return { runtime, compilation };
+        }))();
         const config = this.config;
         // 写入运行时信息
         const writeRuntime = () => {
-            const insertList = ['runtimeDep', 'runtimeCore', 'runtimeEvent'];
+            const insertList = ['runtimeDep', 'runtimeCore', 'runtimeEvent', 'domConfig'];
             for (let str of insertList) {
                 const configValue = config[str];
+                const database = runtime[str];
                 if (!configValue)
                     continue;
                 for (let key in configValue) {
                     const value = configValue[key];
-                    runtime.runtimeDep.update(key, () => value ?? null);
+                    if (typeof value == 'object') {
+                        const def = database.readDefault(key);
+                        ConfigLoader.mergeConfig(value, def, false);
+                    }
+                    database.update(key, () => value ?? null);
                 }
             }
         };
@@ -79,6 +86,10 @@ class ConfigLoader {
                 };
             for (let key in config.compilationEnv) {
                 const value = config.compilationEnv[key];
+                if (typeof value == 'object') {
+                    const def = compilation.compilationEnv.readDefault(key);
+                    ConfigLoader.mergeConfig(value, def, false);
+                }
                 compilation.compilationEnv.update(key, () => value);
             }
         };
@@ -93,6 +104,10 @@ class ConfigLoader {
                             code: untils_1.exceptionNames.invalidVarType,
                             message: `crossEnv[${key}] 应当返回一个非函数对象，却返回了：${value.toString()}`
                         };
+                    if (typeof value == 'object') {
+                        const def = runtime.crossEnv.readDefault(key);
+                        ConfigLoader.mergeConfig(value, def, false);
+                    }
                     runtime.crossEnv.update(key, () => value);
                 }
             }
@@ -114,18 +129,33 @@ class ConfigLoader {
                             code: untils_1.exceptionNames.invalidVarType,
                             message: `crossDep[${key}] 返回的对象应当包含 {runOnBrowser} 字段，却返回了：${JSON.stringify(value, null, 2)}`
                         };
+                    const def = runtime.crossDep.readDefault(key);
+                    ConfigLoader.mergeConfig(value, def, false);
                     runtime.crossDep.update(key, () => value);
                 }
             }
         };
+        // 运行 registry
+        for (let i = this.modifierList.length - 1; i >= 0; i--) {
+            const modifier = this.modifierList[i];
+            modifier.registry?.(runtime, compilation);
+        }
         writeRuntime();
         writeCompilation();
         writeCross();
+        // 运行 dynamic
+        for (let i = this.modifierList.length - 1; i >= 0; i--) {
+            const modifier = this.modifierList[i];
+            modifier.dynamic?.(runtime, compilation);
+        }
+        return Object.freeze({ runtime, compilation });
     }
     /** 将新配置合并到已有配置中 */
-    mergeConfig(other) {
-        function mergeHelper(high, low) {
+    static mergeConfig(config, other, isTop = true) {
+        function mergeHelper(high, low, skip) {
             for (let key in low) {
+                if (skip && key == 'modifier')
+                    continue;
                 const lowValue = low[key];
                 if (key in high) {
                     const highValue = high[key];
@@ -135,8 +165,8 @@ class ConfigLoader {
                     }
                     if (typeof highValue != typeof lowValue)
                         continue;
-                    if (typeof highValue == 'object' && !highValue[IndivisibleName] && !lowValue[IndivisibleName]) {
-                        mergeHelper(highValue, lowValue);
+                    if (typeof highValue == 'object' && !highValue[exports.IndivisibleName] && !lowValue[exports.IndivisibleName]) {
+                        mergeHelper(highValue, lowValue, false);
                     }
                 }
                 else {
@@ -144,7 +174,7 @@ class ConfigLoader {
                 }
             }
         }
-        mergeHelper(this.config, other);
+        mergeHelper(config, other, isTop);
     }
 }
 exports.ConfigLoader = ConfigLoader;
@@ -153,78 +183,5 @@ ConfigLoader.extensions = [
     'js', 'ts', 'cjs', 'cts', 'mjs', 'mjs'
 ];
 ConfigLoader.jiti = (0, jiti_1.createJiti)(__filename, {
-    fsCache: false,
-    alias: {
-        'swpp-backends': path_1.default.join(__dirname, '..', '..', 'index')
-    }
+    fsCache: false
 });
-/** 定义一个通过 `export default` 导出的配置 */
-function defineConfig(config) {
-    return config;
-}
-/** 定义一个通过 `export const compilationEnv` 导出的配置 */
-function defineCompilationEnv(config) {
-    return config;
-}
-/** 定义一个通过 `export const crossEnv` 导出的配置 */
-function defineCrossEnv(config) {
-    return config;
-}
-/** 定义一个通过 `export const runtimeDep` 导出的配置 */
-function defineRuntimeDep(config) {
-    return config;
-}
-/** 定义一个通过 `export const crossDep` 导出的配置 */
-function defineCrossDep(config) {
-    return config;
-}
-/** 定义一个通过 `export const runtimeCore` 导出的配置 */
-function defineRuntimeCore(config) {
-    return config;
-}
-/** 定义一个通过 `export const runtimeEvent` 导出的配置 */
-function defineRuntimeEvent(config) {
-    return config;
-}
-/**
- * 定义一个无法分割的对象配置，这对一些强依赖对象内部属性的设置很有用，可以避免对象被错误地拼接。
- *
- * 默认情况下，当定义一个对象配置时，将允许从其它配置文件中合并一部分配置到对象中，比如：
- *
- * ```typescript
- * // 当前配置
- * exampleConfig.obj = {
- *     value1: 'hello world'
- * }
- * // 如果还有一个配置文件中也声明了这个配置
- * exampleConfig.obj = {
- *     value2: 'hello swpp'
- * }
- * // 最终将合并生成如下配置
- * exampleConfig.obj = {
- *     value1: 'hello world',
- *     value2: 'hello swpp'
- * }
- * ```
- *
- * 通过该函数，可以禁止 swpp 合并配置时仅选取对象的部分字段，要么全部使用 [value] 的值，要么完全不使用 [value] 的值。
- *
- * 放入到上述例子中，假如两个 obj 任意一个或多个通过 `defineIndivisibleConfig({ xxx: xxx })` 设置，最终的值将取决于两个配置文件的优先级，
- * 若 `value2` 的优先级高将产生：
- *
- * ```typescript
- * // 最终结果
- * exampleConfig.obj = {
- *     value2: 'hello swpp'
- * }
- * ```
- */
-function defineIndivisibleConfig(value) {
-    Object.defineProperty(value, IndivisibleName, {
-        value: true,
-        writable: false,
-        configurable: false,
-        enumerable: false
-    });
-    return value;
-}

package/{types → dist}/swpp/database/CompilationEnv.d.ts

@@ -1,6 +1,8 @@
 import { FileParserRegistry } from '../FileParser';
 import { UpdateJson } from '../JsonBuilder';
 import { FiniteConcurrencyFetcher } from '../NetworkFileHandler';
+import { FileUpdateTracker } from '../ResourcesScanner';
+import { CompilationData } from '../SwCompiler';
 import { CrossDepCode } from './CrossDepCode';
 import { CrossEnv } from './CrossEnv';
 import { KeyValueDatabase } from './KeyValueDatabase';
@@ -22,22 +24,33 @@ export declare enum AllowNotFoundEnum {
 }
 declare function buildCommon(_env: any, crossEnv: CrossEnv, crossCode: CrossDepCode): {
     readonly DOMAIN_HOST: import("./KeyValueDatabase").DatabaseValue<string>;
-    /** HTML 数量限制 */
+    readonly SERVICE_WORKER: import("./KeyValueDatabase").DatabaseValue<string>;
+    /** HTML 数量限制，设置为 <= 0 表示不限制 */
     readonly JSON_HTML_LIMIT: import("./KeyValueDatabase").DatabaseValue<number>;
     /** 版本信息长度限制 */
     readonly VERSION_LENGTH_LIMIT: import("./KeyValueDatabase").DatabaseValue<number>;
-    /** 获取已经上线的版本文件 */
-    readonly VERSION_FILE: import("./KeyValueDatabase").DatabaseValue<() => Promise<UpdateJson>>;
+    /** swpp 的 JSON 文件的基本信息 */
+    readonly SWPP_JSON_FILE: import("./KeyValueDatabase").DatabaseValue<{
+        swppPath: string;
+        trackerPath: string;
+        versionPath: string;
+        fetchVersionFile(): Promise<UpdateJson>;
+        fetchTrackerFile(compilation: CompilationData): Promise<FileUpdateTracker>;
+    }>;
     /** 读取一个本地文件 */
-    readonly LOCAL_FILE_READER: import("./KeyValueDatabase").DatabaseValue<(path: string) => Promise<string>>;
+    readonly readLocalFile: import("./KeyValueDatabase").DatabaseValue<(path: string) => Promise<string>>;
     /** 拉取网络文件 */
-    readonly FETCH_NETWORK_FILE: import("./KeyValueDatabase").DatabaseValue<FiniteConcurrencyFetcher>;
+    readonly NETWORK_FILE_FETCHER: import("./KeyValueDatabase").DatabaseValue<FiniteConcurrencyFetcher>;
     /** 判断文件是否是 404 */
-    readonly IS_NOT_FOUND: import("./KeyValueDatabase").DatabaseValue<{
+    readonly isNotFound: import("./KeyValueDatabase").DatabaseValue<{
         response: (response: Response) => boolean;
         error: (err: any) => boolean;
     }>;
+    /** 是否允许 404 */
     readonly ALLOW_NOT_FOUND: import("./KeyValueDatabase").DatabaseValue<AllowNotFoundEnum>;
+    /** 文件解析器 */
     readonly FILE_PARSER: import("./KeyValueDatabase").DatabaseValue<FileParserRegistry>;
+    /** 检查一个链接是否是稳定的（也就是 URL 不变其返回的结果永远不变） */
+    readonly isStable: import("./KeyValueDatabase").DatabaseValue<(_url: URL) => boolean>;
 };
 export {};