grofc_utils 1.0.0 → 1.1.1

package/index.js

@@ -1,5 +1,6 @@
 export * from './src/array.js';
 export * from './src/guard.js';
 export * from './src/missingData.js';
+export * from './src/object.js';
 export * from './src/random.js';
 export * from './src/string.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grofc_utils",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "",
   "main": "index.js",
   "scripts": {
@@ -26,6 +26,10 @@
       "import": "./src/missingData.js",
       "types": "./types/src/missingData.d.ts"
     },
+    "./object": {
+      "import": "./src/object.js",
+      "types": "./types/src/object.d.ts"
+    },
     "./random": {
       "import": "./src/random.js",
       "types": "./types/src/random.d.ts"
@@ -40,6 +44,14 @@
   "license": "ISC",
   "type": "module",
   "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "eslint": "^9.39.1",
+    "globals": "^16.5.0",
     "vitest": "^4.0.6"
-  }
+  },
+  "files": [
+    "index.js",
+    "/src",
+    "/types"
+  ]
 }

package/src/guard.js

@@ -204,6 +204,30 @@ export function throwIfIsNotNonNegativeInteger(variable, name = "variable") {
         throwRangeErrorGiveValue(variable, name, "a non-negative integer");
     }
 }
+//
+// 字符串类型守卫函数
+//
+export function throwIfIsNotString(variable, name = "variable") {
+    if (typeof variable !== "string") {
+        throwTypeErrorGiveType(variable, name, "string")
+    }
+}
+//
+// symbol类型守卫函数
+//
+export function throwIfIsNotSymbol(variable, name = "variable") {
+    if (typeof variable !== "symbol") {
+        throwTypeErrorGiveType(variable, name, "symbol")
+    }
+}
+//
+// bigint类型守卫函数
+//
+export function throwIfIsNotBigInt(variable, name = "variable") {
+    if (typeof variable !== "bigint") {
+        throwTypeErrorGiveType(variable, name, "bigint")
+    }
+}
 // ------------------------------------------------
 // 对象类型守卫函数
 // ------------------------------------------------
@@ -218,10 +242,25 @@ export function throwIfIsNotPlainObject(variable, name = "variable") {
         throwTypeErrorGiveType(variable, name, "a plain object");
     }
 }
+/**
+ * 检查对象是否包含指定的键
+ * @param {*} variable - 要检查的对象
+ * @param {string} key - 要检查的键名
+ * @param {string} name - 变量名称（用于错误消息）
+ * @throws {TypeError} 当variable不是普通对象或key不是字符串时抛出类型错误
+ * @throws {Error} 当对象中找不到指定键时抛出错误
+ */
+export function throwIfKeyMissing(variable, key, name = "variable") {
+    throwIfIsNotPlainObject(variable);
+    throwIfIsNotString(key);
+    if (!(key in variable)) {
+        throw new Error(`Expected ${name} to have key : "${key}", but cannot find.`)
+    }
+}
 /**
  * 检查对象是否缺少所有指定的键
  * @param {*} variable - 要检查的对象
- * @param {string|string[]} keys - 要检查的键名或键名数组
+ * @param {string[]} keys - 要检查的键名数组
  * @param {string} name - 变量名称（用于错误消息）
  * @throws {TypeError} 当 variable 不是普通对象时抛出类型错误
  * @throws {GuardError} 当 keys 不是字符串或字符串数组时抛出守卫错误
@@ -229,18 +268,15 @@ export function throwIfIsNotPlainObject(variable, name = "variable") {
  */
 export function throwIfAllKeysMissing(variable, keys, name = "variable") {
     throwIfIsNotPlainObject(variable);
-    if (!Array.isArray(keys)) {
-        if (typeof keys === "string") keys = [keys];
-        else safeGuardExecute(throwTypeErrorGiveType, keys, name, "string", "an array of string");
-    }
+    safeGuardExecute(throwIfIsNotStringArray, keys, name, "an array of string");
     if (keys.every(key => !(key in variable))) {
-        throw new Error(`Expected ${name} to have at least one attribute of [${keys.map(k => `'${k}'`).join(" ,")}], but cannot find.`)
+        throw new Error(`Expected ${name} to have at least one keys of [${keys.map(k => `'${k}'`).join(" ,")}], but cannot find.`)
     }
 }
 /**
  * 检查对象是否缺少任意指定的键
  * @param {*} variable - 要检查的对象
- * @param {string|string[]} keys - 要检查的键名或键名数组
+ * @param {string[]} keys - 要检查的键名数组
  * @param {string} name - 变量名称（用于错误消息）
  * @throws {TypeError} 当 variable 不是普通对象时抛出类型错误
  * @throws {GuardError} 当 keys 不是字符串或字符串数组时抛出守卫错误
@@ -248,13 +284,58 @@ export function throwIfAllKeysMissing(variable, keys, name = "variable") {
  */
 export function throwIfSomeKeysMissing(variable, keys, name = "variable") {
     throwIfIsNotPlainObject(variable);
-    if (!Array.isArray(keys)) {
-        if (typeof keys === "string") keys = [keys];
-        else safeGuardExecute(throwTypeErrorGiveType, keys, name, "string", "an array of string");
-    }
+    safeGuardExecute(throwIfIsNotStringArray, keys, name, "an array of string");
     const l = keys.filter(key => !(key in variable))
     if (l.length) {
-        throw new Error(`Expected ${name} to have at all attributes of [${keys.map(k => `'${k}'`).join(" ,")}], but missing [${l.map(k => `'${k}'`).join(" ,")}].`)
+        throw new Error(`Expected ${name} to have at all keys of [${keys.map(k => `'${k}'`).join(" ,")}], but missing [${l.map(k => `'${k}'`).join(" ,")}].`)
+    }
+}
+/**
+ * 检查对象是否包含指定的键
+ * @param {*} variable - 要检查的对象
+ * @param {string} property - 要检查的键名
+ * @param {string} name - 变量名称（用于错误消息）
+ * @throws {TypeError} 当variable不是普通对象或property不是字符串时抛出类型错误
+ * @throws {Error} 当对象中找不到指定键时抛出错误
+ */
+export function throwIfOwnPropertyMissing(variable, property, name = "variable") {
+    throwIfIsNotPlainObject(variable);
+    throwIfIsNotString(property);
+    if (Object.hasOwn(variable, property)) {
+        throw new Error(`Expected ${name} to have own property : "${property}", but cannot find.`)
+    }
+}
+/**
+ * 检查对象是否缺少所有指定的键
+ * @param {*} variable - 要检查的对象
+ * @param {string[]}properties- 要检查的键名数组
+ * @param {string} name - 变量名称（用于错误消息）
+ * @throws {TypeError} 当 variable 不是普通对象时抛出类型错误
+ * @throws {GuardError} 当properties不是字符串或字符串数组时抛出守卫错误
+ * @throws {Error} 当对象缺少所有指定键时抛出错误
+ */
+export function throwIfAllOwnPropertiesMissing(variable, properties, name = "variable") {
+    throwIfIsNotPlainObject(variable);
+    safeGuardExecute(throwIfIsNotStringArray, properties, name, "an array of string");
+    if (properties.every(p => !Object.hasOwn(variable, p))) {
+        throw new Error(`Expected ${name} to have at least one own property of [${properties.map(k => `'${k}'`).join(" ,")}], but cannot find.`)
+    }
+}
+/**
+ * 检查对象是否缺少任意指定的键
+ * @param {*} variable - 要检查的对象
+ * @param {string[]} properties - 要检查的键名数组
+ * @param {string} name - 变量名称（用于错误消息）
+ * @throws {TypeError} 当 variable 不是普通对象时抛出类型错误
+ * @throws {GuardError} 当 properties 不是字符串或字符串数组时抛出守卫错误
+ * @throws {Error} 当对象缺少任何一个指定键时抛出错误
+ */
+export function throwIfSomeOwnPropertiesMissing(variable, properties, name = "variable") {
+    throwIfIsNotPlainObject(variable);
+    safeGuardExecute(throwIfIsNotStringArray, properties, name, "an array of string");
+    const l = properties.filter(p => !Object.hasOwn(variable, p))
+    if (l.length) {
+        throw new Error(`Expected ${name} to have at all own properties of [${properties.map(k => `'${k}'`).join(" ,")}], but missing [${l.map(k => `'${k}'`).join(" ,")}].`)
     }
 }
 // ------------------------------------------------
@@ -311,6 +392,25 @@ export function throwIfIsNotNonEmptyArray(variable, name = "variable") {
         throwRangeErrorGiveValue(variable, name, "a non-empty array");
     }
 }
+
+export function throwIfIsNotStringArray(variable, name = "variable", generalTerm = `all elements of ${name || "array"}`) {
+    throwIfIsNotArray(variable, name);
+    const acceptType = "strings";
+    for (const e of variable) {
+        if (typeof e !== "string") {
+            throwTypeErrorForArray(generalTerm, acceptType, `a non-string value of type ${getType(e)}`)
+        }
+    }
+}
+export function throwIfIsNotNumberArray(variable, name = "variable", generalTerm = `all elements of ${name || "array"}`) {
+    throwIfIsNotArray(variable, name);
+    const acceptType = "numbers";
+    for (const e of variable) {
+        if (typeof e !== "number") {
+            throwTypeErrorForArray(generalTerm, acceptType, `a non-number value of type ${getType(e)}`)
+        }
+    }
+}
 /**
  * 检查变量是否为仅包含非NaN数字的数组，如果不是则抛出类型错误
  * 

package/src/object.js

@@ -0,0 +1,13 @@
+import { throwIfIsNotPlainObject, throwIfKeyMissing } from "./guard";
+
+export function setReadOnlyProperty(obj, name) {
+    throwIfIsNotPlainObject(obj);
+    throwIfKeyMissing(obj, name, "obj");
+    const descriptor = Object.getOwnPropertyDescriptor(obj, name);
+    Object.defineProperty(obj, name, {
+        value: descriptor.value,
+        writable: false,
+        configurable: false,
+        enumerable: descriptor.enumerable ?? true
+    })
+}

package/src/random.js

@@ -151,7 +151,7 @@ export function randomVectors(len, dim = 2, mod = 1, generator = randomGaussian)
  * @param {(r: number, c: number) => number} generator 用于生成矩阵元素的函数，接收行列索引作为参数，默认生成0-10的随机整数
  * @returns {number[][]} 二维数组表示的矩阵，大小为rows×cols
  */
-export function randomMatrix(rows = 2, cols = rows, generator = (_r, _c) => randomInt(0, 10)) {
+export function randomMatrix(rows = 2, cols = rows, generator = () => randomInt(0, 10)) {
     throwIfIsNotNonNegativeInteger(rows, "rows");
     throwIfIsNotNonNegativeInteger(cols, "cols");
     throwIfIsNotFunction(generator, "generator");
@@ -166,7 +166,7 @@ export function randomMatrix(rows = 2, cols = rows, generator = (_r, _c) => rand
  * @param {(r: number, c: number) => number} generator 用于生成矩阵元素的函数，接收行列索引作为参数，默认生成0-10的随机整数
  * @returns {number[][][]} 包含len个矩阵的数组，每个矩阵都是二维数组
  */
-export function randomMatrices(len, rows = 2, cols = rows, generator = (_r, _c) => randomInt(0, 10)) {
+export function randomMatrices(len, rows = 2, cols = rows, generator = () => randomInt(0, 10)) {
     throwIfIsNotNonNegativeInteger(len, "len");
     return Array.from({ length: len }, () => randomMatrix(rows, cols, generator))
 }

package/types/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./src/array.js";
 export * from "./src/guard.js";
 export * from "./src/missingData.js";
+export * from "./src/object.js";
 export * from "./src/random.js";
 export * from "./src/string.js";

package/types/src/guard.d.ts

@@ -82,6 +82,9 @@ export function throwIfIsNotNegativeInteger(variable: any, name?: string): void;
  * @throws {RangeError} 当变量不是非负整数时抛出范围错误
  */
 export function throwIfIsNotNonNegativeInteger(variable: any, name?: string): void;
+export function throwIfIsNotString(variable: any, name?: string): void;
+export function throwIfIsNotSymbol(variable: any, name?: string): void;
+export function throwIfIsNotBigInt(variable: any, name?: string): void;
 /**
  * 检查变量是否为普通对象（非 null，非数组）
  * @param {*} variable - 要检查的变量
@@ -89,26 +92,64 @@ export function throwIfIsNotNonNegativeInteger(variable: any, name?: string): vo
  * @throws {TypeError} 当变量不是普通对象时抛出类型错误
  */
 export function throwIfIsNotPlainObject(variable: any, name?: string): void;
+/**
+ * 检查对象是否包含指定的键
+ * @param {*} variable - 要检查的对象
+ * @param {string} key - 要检查的键名
+ * @param {string} name - 变量名称（用于错误消息）
+ * @throws {TypeError} 当variable不是普通对象或key不是字符串时抛出类型错误
+ * @throws {Error} 当对象中找不到指定键时抛出错误
+ */
+export function throwIfKeyMissing(variable: any, key: string, name?: string): void;
 /**
  * 检查对象是否缺少所有指定的键
  * @param {*} variable - 要检查的对象
- * @param {string|string[]} keys - 要检查的键名或键名数组
+ * @param {string[]} keys - 要检查的键名数组
  * @param {string} name - 变量名称（用于错误消息）
  * @throws {TypeError} 当 variable 不是普通对象时抛出类型错误
  * @throws {GuardError} 当 keys 不是字符串或字符串数组时抛出守卫错误
  * @throws {Error} 当对象缺少所有指定键时抛出错误
  */
-export function throwIfAllKeysMissing(variable: any, keys: string | string[], name?: string): void;
+export function throwIfAllKeysMissing(variable: any, keys: string[], name?: string): void;
 /**
  * 检查对象是否缺少任意指定的键
  * @param {*} variable - 要检查的对象
- * @param {string|string[]} keys - 要检查的键名或键名数组
+ * @param {string[]} keys - 要检查的键名数组
  * @param {string} name - 变量名称（用于错误消息）
  * @throws {TypeError} 当 variable 不是普通对象时抛出类型错误
  * @throws {GuardError} 当 keys 不是字符串或字符串数组时抛出守卫错误
  * @throws {Error} 当对象缺少任何一个指定键时抛出错误
  */
-export function throwIfSomeKeysMissing(variable: any, keys: string | string[], name?: string): void;
+export function throwIfSomeKeysMissing(variable: any, keys: string[], name?: string): void;
+/**
+ * 检查对象是否包含指定的键
+ * @param {*} variable - 要检查的对象
+ * @param {string} property - 要检查的键名
+ * @param {string} name - 变量名称（用于错误消息）
+ * @throws {TypeError} 当variable不是普通对象或property不是字符串时抛出类型错误
+ * @throws {Error} 当对象中找不到指定键时抛出错误
+ */
+export function throwIfOwnPropertyMissing(variable: any, property: string, name?: string): void;
+/**
+ * 检查对象是否缺少所有指定的键
+ * @param {*} variable - 要检查的对象
+ * @param {string[]}properties- 要检查的键名数组
+ * @param {string} name - 变量名称（用于错误消息）
+ * @throws {TypeError} 当 variable 不是普通对象时抛出类型错误
+ * @throws {GuardError} 当properties不是字符串或字符串数组时抛出守卫错误
+ * @throws {Error} 当对象缺少所有指定键时抛出错误
+ */
+export function throwIfAllOwnPropertiesMissing(variable: any, properties: any, name?: string): void;
+/**
+ * 检查对象是否缺少任意指定的键
+ * @param {*} variable - 要检查的对象
+ * @param {string[]} properties - 要检查的键名数组
+ * @param {string} name - 变量名称（用于错误消息）
+ * @throws {TypeError} 当 variable 不是普通对象时抛出类型错误
+ * @throws {GuardError} 当 properties 不是字符串或字符串数组时抛出守卫错误
+ * @throws {Error} 当对象缺少任何一个指定键时抛出错误
+ */
+export function throwIfSomeOwnPropertiesMissing(variable: any, properties: string[], name?: string): void;
 /**
  * 检查变量是否为函数类型，如果不是则抛出类型错误
  * @param {*} variable - 要检查的变量
@@ -132,6 +173,8 @@ export function throwIfIsNotIterable(variable: any, name?: string): void;
 export function throwIfIsNotIterableObject(variable: any, name?: string): void;
 export function throwIfIsNotArray(variable: any, name?: string): void;
 export function throwIfIsNotNonEmptyArray(variable: any, name?: string): void;
+export function throwIfIsNotStringArray(variable: any, name?: string, generalTerm?: string): void;
+export function throwIfIsNotNumberArray(variable: any, name?: string, generalTerm?: string): void;
 /**
  * 检查变量是否为仅包含非NaN数字的数组，如果不是则抛出类型错误
  *

package/types/src/object.d.ts

@@ -0,0 +1 @@
+export function setReadOnlyProperty(obj: any, name: any): void;

package/generate.exports.js

@@ -1,51 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const projectRoot = path.resolve(__dirname);
-
-function generateExports() {
-  const srcDir = path.join(projectRoot, 'src');
-  
-  // 获取src目录下所有的js文件
-  const jsFiles = fs.readdirSync(srcDir)
-    .filter(file => fs.statSync(path.join(srcDir, file)).isFile() && path.extname(file) === '.js')
-    .map(file => path.basename(file, '.js'))
-    .sort();
-  
-  // 生成 index.js 内容
-  const exportLines = jsFiles.map(file => `export * from './src/${file}.js';`);
-  const indexContent = exportLines.join('\n') + '\n';
-  
-  // 写入 index.js 文件
-  fs.writeFileSync(path.join(projectRoot, 'index.js'), indexContent);
-  console.log('index.js 文件已生成');
-  
-  // 构建 package.json 的 exports 字段
-  const exports = {
-    ".": {
-      "import": "./index.js",
-      "types": "./types/index.d.ts"
-    }
-  };
-  
-  // 为每个文件添加导出配置
-  jsFiles.forEach(file => {
-    exports[`./${file}`] = {
-      "import": `./src/${file}.js`,
-      "types": `./types/src/${file}.d.ts`
-    };
-  });
-  
-  // 更新 package.json
-  const packagePath = path.join(projectRoot, 'package.json');
-  const packageJson = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
-  packageJson.exports = exports;
-  fs.writeFileSync(packagePath, JSON.stringify(packageJson, null, 2) + '\n');
-  
-  console.log('Exports 字段已更新');
-}
-
-generateExports();

package/readme.md

@@ -1,4 +0,0 @@
-### 如何使用？
-```
-npm install github:xinyuan-noname/grofc_utils
-```

package/tsconfig.json

@@ -1,112 +0,0 @@
-{
-  "compilerOptions": {
-    /* Visit https://aka.ms/tsconfig to read more about this file */
-
-    /* Projects */
-    // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
-    // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
-    // "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
-    // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
-    // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
-    // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
-
-    /* Language and Environment */
-    "target": "es2021",                                  /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-    // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
-    // "jsx": "preserve",                                /* Specify what JSX code is generated. */
-    // "experimentalDecorators": true,                   /* Enable experimental support for legacy experimental decorators. */
-    // "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
-    // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
-    // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
-    // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
-    // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
-    // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
-    // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
-    // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
-
-    /* Modules */
-    "module": "commonjs",                                /* Specify what module code is generated. */
-    // "rootDir": "./",                                  /* Specify the root folder within your source files. */
-    // "moduleResolution": "node10",                     /* Specify how TypeScript looks up a file from a given module specifier. */
-    // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
-    // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
-    // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
-    // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
-    // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
-    // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
-    // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
-    // "allowImportingTsExtensions": true,               /* Allow imports to include TypeScript file extensions. Requires '--moduleResolution bundler' and either '--noEmit' or '--emitDeclarationOnly' to be set. */
-    // "rewriteRelativeImportExtensions": true,          /* Rewrite '.ts', '.tsx', '.mts', and '.cts' file extensions in relative import paths to their JavaScript equivalent in output files. */
-    // "resolvePackageJsonExports": true,                /* Use the package.json 'exports' field when resolving package imports. */
-    // "resolvePackageJsonImports": true,                /* Use the package.json 'imports' field when resolving imports. */
-    // "customConditions": [],                           /* Conditions to set in addition to the resolver-specific defaults when resolving imports. */
-    // "noUncheckedSideEffectImports": true,             /* Check side effect imports. */
-    // "resolveJsonModule": true,                        /* Enable importing .json files. */
-    // "allowArbitraryExtensions": true,                 /* Enable importing files with any extension, provided a declaration file is present. */
-    // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
-
-    /* JavaScript Support */
-    "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
-    // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
-    // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
-
-    /* Emit */
-    "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
-    // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
-    "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
-    // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
-    // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
-    // "noEmit": true,                                   /* Disable emitting files from a compilation. */
-    // "outFile": "",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
-    "outDir": "./types",                                   /* Specify an output folder for all emitted files. */
-    // "removeComments": true,                           /* Disable emitting comments. */
-    // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
-    // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
-    // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
-    // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
-    // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
-    // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
-    // "newLine": "crlf",                                /* Set the newline character for emitting files. */
-    // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
-    // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
-    // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
-    // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
-    // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
-
-    /* Interop Constraints */
-    // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
-    // "verbatimModuleSyntax": true,                     /* Do not transform or elide any imports or exports not marked as type-only, ensuring they are written in the output file's format based on the 'module' setting. */
-    // "isolatedDeclarations": true,                     /* Require sufficient annotation on exports so other tools can trivially generate declaration files. */
-    // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
-    "esModuleInterop": true,                             /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */
-    // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
-    "forceConsistentCasingInFileNames": true,            /* Ensure that casing is correct in imports. */
-
-    /* Type Checking */
-    "strict": true,                                      /* Enable all strict type-checking options. */
-    // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
-    // "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
-    // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
-    // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
-    // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
-    // "strictBuiltinIteratorReturn": true,              /* Built-in iterators are instantiated with a 'TReturn' type of 'undefined' instead of 'any'. */
-    // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
-    // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
-    // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
-    // "noUnusedLocals": true,                           /* Enable error reporting when local variables aren't read. */
-    // "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read. */
-    // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
-    // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
-    // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
-    // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
-    // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
-    // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
-    // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
-    // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
-
-    /* Completeness */
-    // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
-    "skipLibCheck": true                                 /* Skip type checking all .d.ts files. */
-  },
-  "exclude": ["./src","types","./generate.exports.js"]
-}