@asd14/eslint-config 14.6.0 → 15.0.0

package/README.md

@@ -3,13 +3,14 @@
 
 # @asd14/eslint-config
 
-> Reusable ESLint configurations.
+> ASD14's reusable ESLint configurations.
 
 <!-- vim-markdown-toc GFM -->
 
 - [Installation](#installation)
-  - [Peer dependencies](#peer-dependencies)
+- [Exports](#exports)
 - [Usage](#usage)
+  - [With NX](#with-nx)
 - [License](#license)
 
 <!-- vim-markdown-toc -->
@@ -17,26 +18,55 @@
 ## Installation
 
 ```sh
-npm install --save-dev @asd14/ts-config eslint@^9 prettier@^3
+npm install --save-dev @asd14/eslint-config eslint@^9 prettier@^3 typescript@^5
 ```
 
-### Peer dependencies
+> NOTE: `eslint`, `prettier` and `typescript` are peerDependencies
 
-This package requires and assumes you already installed:
+## Exports
 
-```json
-  "peerDependencies": {
-    "eslint": "^9",
-    "prettier": "^3"
+| Entrypoint                   | Description                                           |
+| ---------------------------- | ----------------------------------------------------- |
+| `@asd14/eslint-config/node`  | Node.js source files config                           |
+| `@asd14/eslint-config/react` | TypeScript + React source files combo config          |
+| `@asd14/eslint-config/ts`    | TypeScript + Node.js source files combo config        |
+| `@asd14/eslint-config/nx`    | NX module boundary configs (strict + relaxed for dev) |
+
+All environment configs re-export `commonIgnores` array and `devConfig` for
+convenience.
+
+## Usage
+
+```js
+import { tsConfig, commonIgnores, devConfig } from "@asd14/eslint-config/ts"
+
+const SRC_FILES = ["src/**/*.ts"]
+const TEST_FILES = ["src/**/*.test.ts"]
+const DEV_FILES = ["eslint.config.js"]
+
+/** @type {import("eslint").Linter.Config[]} */
+export default [
+  { ignores: [...commonIgnores] },
+  {
+    ...tsConfig,
+    files: [...SRC_FILES]
   },
+  {
+    ...tsConfig,
+    ...devConfig,
+    files: [...TEST_FILES, ...DEV_FILES],
+    rules: { ...tsConfig.rules, ...devConfig.rules }
+  }
+]
 ```
 
-## Usage
+### With NX
 
-In your `eslint.config.js`, extend the desired configuration:
+Compose the NX boundary configs into your source and dev entries.
 
 ```js
-import { tsNodeConfig, commonIgnores } from "@asd14/eslint-config/typescript"
+import { tsConfig, commonIgnores, devConfig } from "@asd14/eslint-config/ts"
+import { nxConfig, nxDevConfig } from "@asd14/eslint-config/nx"
 
 const SRC_FILES = ["src/**/*.ts"]
 const TEST_FILES = ["src/**/*.test.ts"]
@@ -44,12 +74,23 @@ const DEV_FILES = ["eslint.config.js"]
 
 /** @type {import("eslint").Linter.Config[]} */
 export default [
+  { ignores: commonIgnores },
   {
-    ignores: [...commonIgnores]
+    ...tsConfig,
+    files: [...SRC_FILES],
+    plugins: { ...tsConfig.plugins, ...nxConfig.plugins },
+    rules: { ...tsConfig.rules, ...nxConfig.rules }
   },
   {
-    ...tsNodeConfig,
-    files: [...SRC_FILES, ...DEV_FILES, ...TEST_FILES]
+    ...tsConfig,
+    ...devConfig,
+    files: [...TEST_FILES, ...DEV_FILES],
+    plugins: { ...tsConfig.plugins, ...nxDevConfig.plugins },
+    rules: {
+      ...tsConfig.rules,
+      ...devConfig.rules,
+      ...nxDevConfig.rules
+    }
   }
 ]
 ```

package/dist/types/eslint.config.d.ts

@@ -1,7 +1,7 @@
 declare namespace _default {
-    let files: ["src/**/*.js", "types/*.d.ts", "eslint.config.js"];
-    let ignores: ["node_modules", "dist", "coverage"];
-    let languageOptions: {
+    export let files: ["src/**/*.js", "types/*.d.ts", "eslint.config.js"];
+    export { commonIgnores as ignores };
+    export let languageOptions: {
         readonly ecmaVersion: "latest";
         readonly sourceType: "module";
         readonly parserOptions: {
@@ -95,12 +95,12 @@ declare namespace _default {
         };
         readonly parser: typeof import("@typescript-eslint/parser");
     };
-    let plugins: {
+    export let plugins: {
         readonly jsdoc: import("@eslint/core", { with: { "resolution-mode": "require" } }).Plugin & {
             configs: Record<`flat/${import("eslint-plugin-jsdoc").ConfigGroups}${import("eslint-plugin-jsdoc").ConfigVariants}${import("eslint-plugin-jsdoc").ErrorLevelVariants}`, import("eslint").Linter.Config> & Record<"examples" | "default-expressions" | "examples-and-default-expressions", import("eslint").Linter.Config[]> & Record<"flat/recommended-mixed", import("eslint").Linter.Config[]>;
         };
     };
-    let rules: {
+    export let rules: {
         readonly "import/no-extraneous-dependencies": ["error", {
             readonly includeTypes: true;
         }];
@@ -140,26 +140,23 @@ declare namespace _default {
         }];
         readonly "jsdoc/sort-tags": ["error", {
             readonly reportIntraTagGroupSpacing: false;
-            readonly reportTagGroupSpacing: false;
+            readonly reportTagGroupSpacing: true;
+            readonly tagSequence: readonly [{
+                readonly tags: readonly ["typedef", "callback"];
+            }, {
+                readonly tags: readonly ["param", "arg", "argument", "property", "prop"];
+            }, {
+                readonly tags: readonly ["returns", "return"];
+            }, {
+                readonly tags: readonly ["throws", "exception"];
+            }, {
+                readonly tags: readonly ["example"];
+            }];
         }];
-        readonly "jsdoc/tag-lines": ["error", "always", {
+        readonly "jsdoc/tag-lines": ["error", "any", {
             readonly startLines: 1;
             readonly endLines: 0;
             readonly applyToEndTag: false;
-            readonly tags: {
-                readonly returns: {
-                    readonly lines: "always";
-                };
-                readonly property: {
-                    readonly lines: "any";
-                };
-                readonly param: {
-                    readonly lines: "any";
-                };
-                readonly example: {
-                    readonly lines: "always";
-                };
-            };
         }];
         readonly "jsdoc/check-indentation": "error";
         readonly "jsdoc/check-alignment": "error";
@@ -215,8 +212,9 @@ declare namespace _default {
             readonly allowInObjectDestructuring: true;
         }];
     };
-    let settings: {
+    export let settings: {
         readonly [x: string]: unknown;
     };
 }
 export default _default;
+import commonIgnores from "./src/rules/ignores.js";

package/dist/types/src/configs/node.d.ts

@@ -1,7 +1,7 @@
-export { commonIgnores } from "../rules/ignores.js";
+import commonIgnores from "../rules/ignores.js";
+import devConfig from "../rules/dev.js";
 export namespace nodeConfig {
     let name: "ASD14 config for Node.js source files";
-    let ignores: ["node_modules", "dist", "coverage", "build"];
     namespace languageOptions {
         let ecmaVersion: "latest";
         let sourceType: "module";
@@ -137,26 +137,23 @@ export namespace nodeConfig {
         readonly "unicorn/error-message": "error";
         readonly "jsdoc/sort-tags": ["error", {
             readonly reportIntraTagGroupSpacing: false;
-            readonly reportTagGroupSpacing: false;
+            readonly reportTagGroupSpacing: true;
+            readonly tagSequence: readonly [{
+                readonly tags: readonly ["typedef", "callback"];
+            }, {
+                readonly tags: readonly ["param", "arg", "argument", "property", "prop"];
+            }, {
+                readonly tags: readonly ["returns", "return"];
+            }, {
+                readonly tags: readonly ["throws", "exception"];
+            }, {
+                readonly tags: readonly ["example"];
+            }];
         }];
-        readonly "jsdoc/tag-lines": ["error", "always", {
+        readonly "jsdoc/tag-lines": ["error", "any", {
             readonly startLines: 1;
             readonly endLines: 0;
             readonly applyToEndTag: false;
-            readonly tags: {
-                readonly returns: {
-                    readonly lines: "always";
-                };
-                readonly property: {
-                    readonly lines: "any";
-                };
-                readonly param: {
-                    readonly lines: "any";
-                };
-                readonly example: {
-                    readonly lines: "always";
-                };
-            };
         }];
         readonly "jsdoc/check-indentation": "error";
         readonly "jsdoc/check-alignment": "error";
@@ -219,24 +216,4 @@ export namespace nodeConfig {
         readonly [x: string]: unknown;
     };
 }
-export namespace nodeJestConfig {
-    let name_1: "ASD14's config for Node.js test files";
-    export { name_1 as name };
-    let languageOptions_1: import("@eslint/core", { with: { "resolution-mode": "require" } }).LanguageOptions | undefined;
-    export { languageOptions_1 as languageOptions };
-    let plugins_1: Record<string, import("@eslint/core", { with: { "resolution-mode": "require" } }).Plugin> | undefined;
-    export { plugins_1 as plugins };
-    let rules_1: {
-        readonly "jest/require-top-level-describe": "error";
-        readonly "jest/consistent-test-it": ["error", {
-            readonly fn: "test";
-            readonly withinDescribe: "test";
-        }];
-        readonly "jest/valid-title": ["error", {
-            readonly mustMatch: {
-                readonly test: "^given \\[.*\\] should \\[.*\\]$";
-            };
-        }];
-    };
-    export { rules_1 as rules };
-}
+export { commonIgnores, devConfig };

package/dist/types/src/configs/nx.d.ts

@@ -1,11 +1,10 @@
 export namespace nxConfig {
-    let name: "ASD14 config for source files inside an NX monorepo";
     let plugins: {
         readonly "@nx": Plugin;
     };
     let rules: {
         readonly "@nx/enforce-module-boundaries": ["error", {
-            readonly allow: readonly [];
+            readonly allow: readonly ["^.*/types$", "^.*/const$"];
             readonly depConstraints: readonly [{
                 sourceTag: string;
                 onlyDependOnLibsWithTags: string[];
@@ -44,21 +43,16 @@ export namespace nxConfig {
     };
 }
 export namespace nxDevConfig {
-    let name_1: "ASD14 config for dev files inside an NX monorepo";
-    export { name_1 as name };
     let plugins_1: {
         readonly "@nx": Plugin;
     };
     export { plugins_1 as plugins };
     let rules_1: {
-        readonly "import/no-extraneous-dependencies": ["error", {
-            readonly packageDir: readonly ["./", string];
-        }];
         readonly "@nx/enforce-module-boundaries": ["error", {
             readonly allow: readonly [];
             readonly depConstraints: readonly [{
                 readonly sourceTag: "*";
-                readonly onlyDependOnLibsWithTags: readonly ["type:lib"];
+                readonly onlyDependOnLibsWithTags: readonly ["type:library"];
             }];
         }];
     };

package/dist/types/src/configs/react.d.ts

@@ -1,7 +1,7 @@
-export { commonIgnores } from "../rules/ignores.js";
+import commonIgnores from "../rules/ignores.js";
+import devConfig from "../rules/dev.js";
 export namespace reactConfig {
-    let name: "ASD14 config for React source files";
-    let ignores: ["node_modules", "dist", "coverage", "build"];
+    let name: "ASD14 config for Typescript + React source files";
     let languageOptions: {
         readonly ecmaVersion: "latest";
         readonly sourceType: "module";
@@ -121,6 +121,8 @@ export namespace reactConfig {
             readonly CookieStore: false;
             readonly CookieStoreManager: false;
             readonly CountQueuingStrategy: false;
+            readonly crashReport: false;
+            readonly CrashReportContext: false;
             readonly createImageBitmap: false;
             readonly CreateMonitor: false;
             readonly Credential: false;
@@ -709,6 +711,7 @@ export namespace reactConfig {
             readonly Option: false;
             readonly OrientationSensor: false;
             readonly origin: false;
+            readonly Origin: false;
             readonly originAgentCluster: false;
             readonly OscillatorNode: false;
             readonly OTPCredential: false;
@@ -748,6 +751,7 @@ export namespace reactConfig {
             readonly PerformanceScriptTiming: false;
             readonly PerformanceServerTiming: false;
             readonly PerformanceTiming: false;
+            readonly PerformanceTimingConfidence: false;
             readonly PeriodicSyncManager: false;
             readonly PeriodicWave: false;
             readonly Permissions: false;
@@ -1275,47 +1279,6 @@ export namespace reactConfig {
         readonly "unicorn/no-useless-undefined": "off";
         readonly "unicorn/new-for-builtins": "error";
         readonly "unicorn/error-message": "error";
-        readonly "@typescript-eslint/no-unused-vars": ["error", {
-            readonly args: "all";
-            readonly argsIgnorePattern: "^_";
-            readonly caughtErrors: "all";
-            readonly caughtErrorsIgnorePattern: "^_";
-            readonly destructuredArrayIgnorePattern: "^_";
-            readonly varsIgnorePattern: "^_";
-            readonly ignoreRestSiblings: true;
-        }];
-        readonly "@typescript-eslint/require-await": "warn";
-        readonly "@typescript-eslint/dot-notation": "off";
-        readonly "@typescript-eslint/restrict-template-expressions": ["error", {
-            readonly allowBoolean: true;
-            readonly allowNumber: true;
-        }];
-        readonly "@typescript-eslint/no-var-requires": "off";
-        readonly "@typescript-eslint/no-use-before-define": "error";
-        readonly "@typescript-eslint/naming-convention": ["error", {
-            readonly selector: "default";
-            readonly leadingUnderscore: "allow";
-            readonly format: readonly ["camelCase", "PascalCase", "UPPER_CASE"];
-        }, {
-            readonly selector: "variable";
-            readonly types: readonly ["boolean"];
-            readonly format: readonly ["camelCase", "PascalCase"];
-            readonly prefix: readonly ["is", "has", "can", "does", "should", "will", "did", "was", "are"];
-        }, {
-            readonly selector: "variable";
-            readonly types: readonly ["boolean", "number", "string", "array"];
-            readonly modifiers: readonly ["const", "global"];
-            readonly format: readonly ["UPPER_CASE"];
-        }, {
-            readonly selector: "typeAlias";
-            readonly format: readonly ["PascalCase"];
-        }, {
-            readonly selector: "typeParameter";
-            readonly format: readonly ["PascalCase"];
-        }, {
-            readonly selector: readonly ["classProperty", "objectLiteralProperty", "typeProperty", "classMethod", "objectLiteralMethod", "typeMethod", "accessor", "enumMember"];
-            readonly format: readonly [];
-        }];
         readonly "react-refresh/only-export-components": "error";
         readonly "react-hooks/rules-of-hooks": "error";
         readonly "react-hooks/exhaustive-deps": "error";
@@ -1402,28 +1365,67 @@ export namespace reactConfig {
         readonly "react/no-access-state-in-setstate": "error";
         readonly "react/button-has-type": "error";
         readonly "react/jsx-props-no-spreading": "off";
+        readonly "@typescript-eslint/unified-signatures": "off";
+        readonly "@typescript-eslint/no-unused-vars": ["error", {
+            readonly args: "all";
+            readonly argsIgnorePattern: "^_";
+            readonly caughtErrors: "all";
+            readonly caughtErrorsIgnorePattern: "^_";
+            readonly destructuredArrayIgnorePattern: "^_";
+            readonly varsIgnorePattern: "^_";
+            readonly ignoreRestSiblings: true;
+        }];
+        readonly "@typescript-eslint/require-await": "warn";
+        readonly "@typescript-eslint/dot-notation": "off";
+        readonly "@typescript-eslint/restrict-template-expressions": ["error", {
+            readonly allowBoolean: true;
+            readonly allowNumber: true;
+        }];
+        readonly "@typescript-eslint/no-var-requires": "off";
+        readonly "@typescript-eslint/no-use-before-define": "error";
+        readonly "@typescript-eslint/naming-convention": ["error", {
+            readonly selector: "default";
+            readonly leadingUnderscore: "allow";
+            readonly format: readonly ["camelCase", "PascalCase", "UPPER_CASE"];
+        }, {
+            readonly selector: "variable";
+            readonly types: readonly ["boolean"];
+            readonly format: readonly ["camelCase", "PascalCase"];
+            readonly prefix: readonly ["is", "has", "can", "does", "should", "will", "did", "was", "are"];
+        }, {
+            readonly selector: "variable";
+            readonly types: readonly ["boolean", "number", "string", "array"];
+            readonly modifiers: readonly ["const", "global"];
+            readonly format: readonly ["UPPER_CASE"];
+        }, {
+            readonly selector: "typeAlias";
+            readonly format: readonly ["PascalCase"];
+        }, {
+            readonly selector: "typeParameter";
+            readonly format: readonly ["PascalCase"];
+        }, {
+            readonly selector: readonly ["classProperty", "objectLiteralProperty", "typeProperty", "classMethod", "objectLiteralMethod", "typeMethod", "accessor", "enumMember"];
+            readonly format: readonly [];
+        }];
         readonly "jsdoc/sort-tags": ["error", {
             readonly reportIntraTagGroupSpacing: false;
-            readonly reportTagGroupSpacing: false;
+            readonly reportTagGroupSpacing: true;
+            readonly tagSequence: readonly [{
+                readonly tags: readonly ["typedef", "callback"];
+            }, {
+                readonly tags: readonly ["param", "arg", "argument", "property", "prop"];
+            }, {
+                readonly tags: readonly ["returns", "return"];
+            }, {
+                readonly tags: readonly ["throws", "exception"];
+            }, {
+                readonly tags: readonly ["example"];
+            }];
         }];
-        readonly "jsdoc/tag-lines": ["error", "always", {
+        readonly "jsdoc/tag-lines": ["error", "any", {
             readonly startLines: 1;
             readonly endLines: 0;
             readonly applyToEndTag: false;
-            readonly tags: {
-                readonly returns: {
-                    readonly lines: "always";
-                };
-                readonly property: {
-                    readonly lines: "any";
-                };
-                readonly param: {
-                    readonly lines: "any";
-                };
-                readonly example: {
-                    readonly lines: "always";
-                };
-            };
         }];
         readonly "jsdoc/check-indentation": "error";
         readonly "jsdoc/check-alignment": "error";
@@ -1489,23 +1491,4 @@ export namespace reactConfig {
         };
     };
 }
-/** @satisfies {import("eslint").Linter.Config} */
-export const reactJestConfig: {
-    readonly name: "ASD14 config for React test files";
-    readonly plugins: {
-        readonly [x: string]: import("@eslint/core", { with: { "resolution-mode": "require" } }).Plugin;
-    };
-    readonly rules: {
-        readonly "jest/require-top-level-describe": "error";
-        readonly "jest/consistent-test-it": ["error", {
-            readonly fn: "test";
-            readonly withinDescribe: "test";
-        }];
-        readonly "jest/valid-title": ["error", {
-            readonly mustMatch: {
-                readonly test: "^given \\[.*\\] should \\[.*\\]$";
-            };
-        }];
-    };
-    readonly languageOptions: import("@eslint/core", { with: { "resolution-mode": "require" } }).LanguageOptions | undefined;
-};
+export { commonIgnores, devConfig };

package/dist/types/src/configs/{typescript.d.ts → ts.d.ts}

@@ -1,5 +1,6 @@
-export { commonIgnores } from "../rules/ignores.js";
-export namespace tsNodeConfig {
+import commonIgnores from "../rules/ignores.js";
+import devConfig from "../rules/dev.js";
+export namespace tsConfig {
     let name: "ASD14 config for Typescript + Node.js source files";
     let languageOptions: {
         readonly parser: typeof import("@typescript-eslint/parser");
@@ -137,26 +138,23 @@ export namespace tsNodeConfig {
         readonly "unicorn/error-message": "error";
         readonly "jsdoc/sort-tags": ["error", {
             readonly reportIntraTagGroupSpacing: false;
-            readonly reportTagGroupSpacing: false;
+            readonly reportTagGroupSpacing: true;
+            readonly tagSequence: readonly [{
+                readonly tags: readonly ["typedef", "callback"];
+            }, {
+                readonly tags: readonly ["param", "arg", "argument", "property", "prop"];
+            }, {
+                readonly tags: readonly ["returns", "return"];
+            }, {
+                readonly tags: readonly ["throws", "exception"];
+            }, {
+                readonly tags: readonly ["example"];
+            }];
         }];
-        readonly "jsdoc/tag-lines": ["error", "always", {
+        readonly "jsdoc/tag-lines": ["error", "any", {
             readonly startLines: 1;
             readonly endLines: 0;
             readonly applyToEndTag: false;
-            readonly tags: {
-                readonly returns: {
-                    readonly lines: "always";
-                };
-                readonly property: {
-                    readonly lines: "any";
-                };
-                readonly param: {
-                    readonly lines: "any";
-                };
-                readonly example: {
-                    readonly lines: "always";
-                };
-            };
         }];
         readonly "jsdoc/check-indentation": "error";
         readonly "jsdoc/check-alignment": "error";
@@ -214,6 +212,7 @@ export namespace tsNodeConfig {
             readonly allowInArrayDestructuring: true;
             readonly allowInObjectDestructuring: true;
         }];
+        readonly "@typescript-eslint/unified-signatures": "off";
         readonly "@typescript-eslint/no-unused-vars": ["error", {
             readonly args: "all";
             readonly argsIgnorePattern: "^_";
@@ -260,3 +259,4 @@ export namespace tsNodeConfig {
         readonly [x: string]: unknown;
     };
 }
+export { commonIgnores, devConfig };

package/dist/types/src/rules/dev.d.ts

@@ -0,0 +1,6 @@
+declare namespace _default {
+    let rules: {
+        readonly "import/no-extraneous-dependencies": "off";
+    };
+}
+export default _default;

package/dist/types/src/rules/ignores.d.ts

@@ -1,5 +1,2 @@
-/**
- * Common ignore patterns for ESLint flat configs
- * These are build outputs and dependencies that should never be linted
- */
-export const commonIgnores: readonly ["node_modules/**", "dist/**", "coverage/**", "build/**", ".next/**", ".nuxt/**", "out/**", "tmp/**", "temp/**"];
+declare const _default: string[];
+export default _default;

package/dist/types/src/rules/jsdoc.d.ts

@@ -5,26 +5,23 @@ declare namespace _default {
     let rules: {
         readonly "jsdoc/sort-tags": ["error", {
             readonly reportIntraTagGroupSpacing: false;
-            readonly reportTagGroupSpacing: false;
+            readonly reportTagGroupSpacing: true;
+            readonly tagSequence: readonly [{
+                readonly tags: readonly ["typedef", "callback"];
+            }, {
+                readonly tags: readonly ["param", "arg", "argument", "property", "prop"];
+            }, {
+                readonly tags: readonly ["returns", "return"];
+            }, {
+                readonly tags: readonly ["throws", "exception"];
+            }, {
+                readonly tags: readonly ["example"];
+            }];
         }];
-        readonly "jsdoc/tag-lines": ["error", "always", {
+        readonly "jsdoc/tag-lines": ["error", "any", {
             readonly startLines: 1;
             readonly endLines: 0;
             readonly applyToEndTag: false;
-            readonly tags: {
-                readonly returns: {
-                    readonly lines: "always";
-                };
-                readonly property: {
-                    readonly lines: "any";
-                };
-                readonly param: {
-                    readonly lines: "any";
-                };
-                readonly example: {
-                    readonly lines: "always";
-                };
-            };
         }];
         readonly "jsdoc/check-indentation": "error";
         readonly "jsdoc/check-alignment": "error";

package/dist/types/src/rules/typescript.d.ts

@@ -6,6 +6,7 @@ declare namespace _default {
         readonly "@typescript-eslint": any;
     };
     let rules: {
+        readonly "@typescript-eslint/unified-signatures": "off";
         readonly "@typescript-eslint/no-unused-vars": ["error", {
             readonly args: "all";
             readonly argsIgnorePattern: "^_";

package/dist/types/src/utils/find-up-sync.d.ts

@@ -15,20 +15,19 @@ export type FindUpSyncFn = (fileName: string, options?: FindUpSyncOptions | unde
  *
  * @param {string} fileName - The name of the file to find.
  * @param {FindUpSyncOptions} [options] - Options for the function.
+ *
  * @returns {string} The absolute path to the file.
  */
 /**
  * Find a file up the directory tree synchronously.
  *
- * @type {FindUpSyncFn}
- *
  * @throws {Error} If the starting folder does not exist.
- *
  * @throws {Error} If the file does not exist up the tree.
  *
  * @example
  *  const filePath = findUpSync("lerna.json");
  *  //=> "/Users/johndoe/Projects/WootWoot/lerna.json"
  *
+ * @type {FindUpSyncFn}
  */
 export const findUpSync: FindUpSyncFn;