eslint-plugin-fast-import 1.0.0-beta2

package/dist/types/base.d.ts

@@ -0,0 +1,230 @@
+import type { TSESTree } from '@typescript-eslint/utils';
+type Base = {
+    /**
+     * The AST node in ESTree format of the complete ESM statement for this entry
+     */
+    statementNode: TSESTree.Node;
+    /**
+     * The AST node in ESTree format to report an error on, if one exists.
+     *
+     * Note: this may not be the node representing the entire ESM statement
+     */
+    reportNode: TSESTree.Node | TSESTree.Token;
+};
+export type BaseSingleImport = Base & {
+    importType: 'single';
+    /**
+     * Where we're importing from, e.g. `'./bar'` in:
+     *
+     * ```
+     * import { foo } from './bar'
+     * ```
+     */
+    moduleSpecifier: string;
+    /**
+     * What we're importing, e.g. `foo` in:
+     *
+     * ```
+     * import { foo } from './bar'
+     * ```
+     */
+    importName: string;
+    /**
+     * What we're calling the import locally. This is usually the same as `importName`, but can sometimes be different. If
+     * we do:
+     *
+     * ```
+     * import { foo as alias } from './bar'
+     * ```
+     *
+     * then `importName` equals `foo` and `importAlias` equals `alias`
+     */
+    importAlias: string;
+    /**
+     * If true, then this is a TypeScript type import, e.g.
+     *
+     * ```
+     * import type { Foo } from './bar'
+     * ```
+     */
+    isTypeImport: boolean;
+};
+export type BaseBarrelImport = Base & {
+    importType: 'barrel';
+    /**
+     * Where we're importing from, e.g. `'./bar'` in:
+     *
+     * ```
+     * import * as foo from './bar'
+     * ```
+     */
+    moduleSpecifier: string;
+    /**
+     * What we're calling the import, named for consistency with single imports. If
+     * we do:
+     *
+     * ```
+     * import * as foo from './bar'
+     * ```
+     *
+     * then `importAlias` equals `foo`
+     */
+    importAlias: string;
+    /**
+     * If true, then this is a TypeScript type import, e.g.
+     *
+     * ```
+     * import type * as Foo from './bar'
+     * ```
+     */
+    isTypeImport: boolean;
+};
+export type BaseDynamicImport = Base & {
+    importType: 'dynamic';
+    /**
+     * Where we're importing from, e.g. `'./bar'` in:
+     *
+     * ```
+     * import('./bar')
+     * ```
+     *
+     * Note: if the value is not a string literal, then this value is `undefined`
+     */
+    moduleSpecifier: string | undefined;
+};
+export type BaseImport = BaseSingleImport | BaseBarrelImport | BaseDynamicImport;
+export type BaseExport = Base & {
+    /**
+     * What we're export, e.g. `foo` in:
+     *
+     * ```
+     * export const foo = 10;
+     * ```
+     */
+    exportName: string;
+    /**
+     * Indicates whether or not this rexport is an entry point for the app. For example, if we're running a Next.js app
+     * and this export is `getServerSideProps` in a page file, the we consider this an an entry point export since
+     * we'll never see the import itself
+     */
+    isEntryPoint: boolean;
+    /**
+     * If true, then this is a TypeScript type import, e.g.
+     *
+     * ```
+     * export type Foo = 10;
+     * ```
+     */
+    isTypeExport: boolean;
+};
+export type BaseSingleReexport = Base & {
+    reexportType: 'single';
+    /**
+     * Where we're reexporting from, e.g. `'./bar'` in:
+     *
+     * ```
+     * export { foo } from './bar'
+     * ```
+     */
+    moduleSpecifier: string;
+    /**
+     * What we're reexporting, e.g. `foo` in:
+     *
+     * ```
+     * export { foo } from './bar'
+     * ```
+     */
+    importName: string;
+    /**
+     * What we're naming the reexport. This is usually the same as `importName`, but can sometimes be different. If we do:
+     *
+     * ```
+     * export { foo as alias } from './bar'
+     * ```
+     *
+     * then `importName` equals `foo` and `exportName` equals `alias`
+     */
+    exportName: string;
+    /**
+     * If true, then this is a TypeScript type reexport, e.g.
+     *
+     * ```
+     * export type { Foo } from './bar'
+     * ```
+     */
+    isTypeReexport: boolean;
+    /**
+     * Indicates whether or not this reexport is an entry point for the app. For example, if we're running a Next.js app
+     * and this reexport is `getServerSideProps` in a page file, the we consider this an an entry point reexport since
+     * we'll never see the import itself
+     */
+    isEntryPoint: boolean;
+};
+export type BaseBarrelReexport = Base & {
+    reexportType: 'barrel';
+    /**
+     * Where we're reexporting from, e.g. `'./bar'` in:
+     *
+     * ```
+     * export * from './bar'
+     * ```
+     */
+    moduleSpecifier: string;
+    /**
+     * The name of the rollup object, if specified, e.g. `foo` in:
+     *
+     * ```
+     * export * as foo from './bar'
+     * ```
+     */
+    exportName: string | undefined;
+    /**
+     * If true, then this is a TypeScript type reexport, e.g.
+     *
+     * ```
+     * export type * from './bar'
+     * ```
+     */
+    isTypeReexport: boolean;
+    /**
+     * Indicates whether or not this reexport is an entry point for the app. For example, if we're running a Next.js app
+     * and this reexport is `getServerSideProps` in a page file, the we consider this an an entry point reexport since
+     * we'll never see the import itself
+     */
+    isEntryPoint: boolean;
+};
+export type BaseReexport = BaseSingleReexport | BaseBarrelReexport;
+/**
+ * This represents a file that is imported in ESM code, but is not an ESM file. Examples include importing CSS or JSON
+ * files. These files get an entry for bookeeping reasons, but otherwise are not parsed or anlayzed
+ */
+export type BaseOtherFileDetails = {
+    fileType: 'other';
+};
+/**
+ * Represents an ESM file and its imports, exports, and reexports.
+ */
+export type BaseCodeFileDetails = {
+    fileType: 'code';
+    lastUpdatedAt: number;
+    imports: BaseImport[];
+    exports: BaseExport[];
+    reexports: BaseReexport[];
+};
+type BaseFileDetails = BaseOtherFileDetails | BaseCodeFileDetails;
+export type BaseProjectInfo = {
+    /**
+     * Mapping of _absolute_ file paths to file details
+     */
+    files: Map<string, BaseFileDetails>;
+    /**
+     * The root path of source code in the project
+     */
+    rootDir: string;
+    /**
+     * If defined, an alias for referencing first party imports absolutely. For example, Next.js defaults to `@`, meaning
+     * a file at `src/components/foo` can be imported anywhere with `@/components/foo`
+     */
+    alias: Record<string, string>;
+};
+export {};

package/dist/types/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/types/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/types/base.ts"],"names":[],"mappings":""}

package/dist/types/context.d.ts

@@ -0,0 +1,2 @@
+import type { RuleContext } from '@typescript-eslint/utils/ts-eslint';
+export type GenericContext = RuleContext<string, readonly unknown[]>;

package/dist/types/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/types/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":""}

package/dist/types/resolved.d.ts

@@ -0,0 +1,60 @@
+import type { BaseBarrelImport, BaseBarrelReexport, BaseDynamicImport, BaseExport, BaseOtherFileDetails, BaseProjectInfo, BaseSingleImport, BaseSingleReexport } from './base.js';
+export type Resolved = {
+    moduleType: 'builtin';
+} | {
+    moduleType: 'thirdParty';
+} | {
+    moduleType: 'firstPartyCode';
+    /**
+     * The absolute path of the file that the import/reexport points to. For the statement in a file at
+     * `/Users/bryan/myProject/src/foo.ts`:
+     *
+     * ```
+     * import { bar } from './bar';
+     * ```
+     *
+     * then `resolvedModulePath` is `/Users/bryan/myProject/src/bar/index.ts`
+     */
+    resolvedModulePath: string;
+} | {
+    moduleType: 'firstPartyOther';
+    /**
+     * The absolute path of the file that the import/reexport points to. For the statement in a file at
+     * `/Users/bryan/myProject/src/foo.ts`:
+     *
+     * ```
+     * import { bar } from './bar';
+     * ```
+     *
+     * then `resolvedModulePath` is `/Users/bryan/myProject/src/bar/index.ts`
+     *
+     * Note: value is `undefined` if the import can't be resolved, aka the module specifier isn't valid. While the
+     * developer's intentions might have been to import a code file, we can't don't know for sure. Pretending it's
+     * always a non-code file is safer
+     */
+    resolvedModulePath: string | undefined;
+};
+export type ResolvedSingleImport = BaseSingleImport & Resolved;
+export type ResolvedBarrelImport = BaseBarrelImport & Resolved;
+export type ResolvedDynamicImport = BaseDynamicImport & Resolved;
+export type ResolvedImport = ResolvedSingleImport | ResolvedBarrelImport | ResolvedDynamicImport;
+export type ResolvedExport = BaseExport;
+export type ResolvedSingleReexport = BaseSingleReexport & Resolved;
+export type ResolvedBarrelReexport = BaseBarrelReexport & Resolved;
+export type ResolvedReexport = ResolvedSingleReexport | ResolvedBarrelReexport;
+export type ResolvedOtherFileDetails = BaseOtherFileDetails;
+export type ResolvedCodeFileDetails = {
+    fileType: 'code';
+    lastUpdatedAt: number;
+    imports: ResolvedImport[];
+    exports: ResolvedExport[];
+    reexports: ResolvedReexport[];
+};
+type ResolvedFileDetails = ResolvedOtherFileDetails | ResolvedCodeFileDetails;
+export type ResolvedProjectInfo = Omit<BaseProjectInfo, 'files'> & {
+    /**
+     * Mapping of _absolute_ file paths to file details
+     */
+    files: Map<string, ResolvedFileDetails>;
+};
+export {};

package/dist/types/resolved.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolved.js.map

package/dist/types/resolved.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved.js","sourceRoot":"","sources":["../../src/types/resolved.ts"],"names":[],"mappings":""}

package/dist/util/code.d.ts

@@ -0,0 +1 @@
+export declare function isCodeFile(filePath: string): boolean;

package/dist/util/code.js

@@ -0,0 +1,6 @@
+import { extname } from 'node:path';
+const VALID_EXTENSIONS = ['.ts', '.tsx', '.mts', '.js', '.jsx', '.mjs'];
+export function isCodeFile(filePath) {
+    return VALID_EXTENSIONS.includes(extname(filePath));
+}
+//# sourceMappingURL=code.js.map

package/dist/util/code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/util/code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAExE,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/util/error.d.ts

@@ -0,0 +1,14 @@
+import type { TSESTree } from '@typescript-eslint/utils';
+type SourceDetails = {
+    filePath: string;
+    fileContents?: string;
+    node: TSESTree.Node;
+};
+/**
+ * An error class that adds special formatting for internal errors, including printing out what file and AST node was
+ * being processed when the error occured
+ */
+export declare class InternalError extends Error {
+    constructor(message: string, sourceDetails?: SourceDetails);
+}
+export {};

package/dist/util/error.js

@@ -0,0 +1,19 @@
+/**
+ * An error class that adds special formatting for internal errors, including printing out what file and AST node was
+ * being processed when the error occured
+ */
+export class InternalError extends Error {
+    constructor(message, sourceDetails) {
+        let formattedMessage = `Internal error: ${message}. This is a bug, please report the message and the stack trace to the maintainer at https://github.com/nebrius/fast-import/issues`;
+        if (sourceDetails) {
+            if (sourceDetails.fileContents) {
+                formattedMessage += `\n\nIn ${sourceDetails.filePath}:\n\n${sourceDetails.fileContents.substring(sourceDetails.node.range[0], sourceDetails.node.range[1])}\n`;
+            }
+            else {
+                formattedMessage += `\n\nIn ${sourceDetails.filePath}\n`;
+            }
+        }
+        super(formattedMessage);
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/util/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/util/error.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe,EAAE,aAA6B;QACxD,IAAI,gBAAgB,GAAG,mBAAmB,OAAO,mIAAmI,CAAC;QACrL,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,aAAa,CAAC,YAAY,EAAE,CAAC;gBAC/B,gBAAgB,IAAI,UAAU,aAAa,CAAC,QAAQ,QAAQ,aAAa,CAAC,YAAY,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACjK,CAAC;iBAAM,CAAC;gBACN,gBAAgB,IAAI,UAAU,aAAa,CAAC,QAAQ,IAAI,CAAC;YAC3D,CAAC;QACH,CAAC;QACD,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/util/files.d.ts

@@ -0,0 +1,10 @@
+import type { IgnorePattern } from '../settings/settings.js';
+export declare function getFilesSync(rootDir: string, ignorePatterns: IgnorePattern[]): {
+    filePath: string;
+    latestUpdatedAt: number;
+}[];
+export declare function getFiles(rootDir: string, ignorePatterns: IgnorePattern[]): Promise<{
+    filePath: string;
+    latestUpdatedAt: number;
+}[]>;
+export declare function isFileIgnored(rootDir: string, filePath: string): boolean;

package/dist/util/files.js

@@ -0,0 +1,122 @@
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { readdir, stat } from 'node:fs/promises';
+import { basename, dirname, join, relative } from 'node:path';
+import ignore from 'ignore';
+import { InternalError } from './error.js';
+export function getFilesSync(rootDir, ignorePatterns) {
+    // Read in the files and their stats, and filter out directories
+    const potentialFiles = readdirSync(rootDir, {
+        recursive: true,
+        encoding: 'utf-8',
+    })
+        .map((f) => join(rootDir, f))
+        // Stats will be used for multiple checks later, so we want to cache it now.
+        // Unfortunately we need more than what {withFileTypes: true} provides, so
+        // we still need to call statSync separately
+        .map((filePath) => ({ filePath, stats: statSync(filePath) }))
+        // Filter out any directories, so that this is only a file list
+        .filter((f) => !f.stats.isDirectory());
+    // Return the list of files
+    return buildFileList(rootDir, ignorePatterns, potentialFiles.filter(({ filePath }) => basename(filePath) !== '.gitignore'));
+}
+export async function getFiles(rootDir, ignorePatterns) {
+    // First, read in the files and convert the results to absolute path
+    const potentialFilePaths = (await readdir(rootDir, {
+        recursive: true,
+        encoding: 'utf-8',
+    })).map((f) => join(rootDir, f));
+    // Now add the stats to each file
+    const potentialFiles = (await Promise.all(potentialFilePaths.map(async (filePath) => {
+        const stats = await stat(filePath);
+        return { filePath, stats };
+    })))
+        // Filter out any directories, so that this is only a file list
+        .filter((f) => !f.stats.isDirectory());
+    // Return the list of files
+    return buildFileList(rootDir, ignorePatterns, potentialFiles.filter(({ filePath }) => basename(filePath) !== '.gitignore'));
+}
+let ignores = null;
+export function isFileIgnored(rootDir, filePath) {
+    if (!ignores) {
+        throw new InternalError(`isFileIgnored called before ignores initialized`);
+    }
+    if (!filePath.startsWith(rootDir)) {
+        return true;
+    }
+    for (const { dir, ig } of ignores) {
+        // Ignore file paths are relative to the directory the ignore file is in,
+        // and needs files passed in to check to also be relative to that same
+        // directory, so we get the relative path to the ignore file directory
+        if (filePath.startsWith(dir) && ig.ignores(relative(dir, filePath))) {
+            return true;
+        }
+    }
+    return false;
+}
+function buildFileList(rootDir, ignorePatterns, potentialFiles) {
+    // Create the ignore instances for use in filtering
+    initializeIgnores(rootDir, ignorePatterns, potentialFiles);
+    // Filter out ignored files
+    const files = [];
+    for (const { filePath, stats } of potentialFiles) {
+        if (isFileIgnored(rootDir, filePath)) {
+            continue;
+        }
+        files.push({
+            filePath,
+            latestUpdatedAt: stats.mtimeMs,
+        });
+    }
+    return files;
+}
+function initializeIgnores(rootDir, ignorePatterns, potentialFiles) {
+    if (ignores) {
+        return;
+    }
+    // First, we need to traverse up the folder tree until we find the git root
+    // folder. We're often operating in a project where `rootDir` is a `src`
+    // folder, or even in a monorepo. In these cases, there is likely a gitignore
+    // file(s) futher up the tree
+    const extraIgnoreFiles = [];
+    const rootDirContents = readdirSync(rootDir);
+    if (!rootDirContents.includes('.git')) {
+        let currentDir = dirname(rootDir);
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        while (true) {
+            const currentDirContents = readdirSync(currentDir);
+            if (currentDirContents.includes('.gitignore')) {
+                extraIgnoreFiles.push(join(currentDir, '.gitignore'));
+            }
+            if (
+            // If we found the git folder, bail
+            currentDirContents.includes('.git') ||
+                // If we're at the root folder of the file system, bail. Note: we do the
+                // check this way to support both UNIX and Windows filesystems
+                currentDir === dirname(rootDir)) {
+                break;
+            }
+            currentDir = dirname(rootDir);
+        }
+    }
+    // Normalize and read in all ignore file contents
+    const ignoreFiles = [
+        ...extraIgnoreFiles,
+        ...potentialFiles
+            .filter(({ filePath }) => basename(filePath) === '.gitignore')
+            .map(({ filePath }) => filePath),
+    ].map((filePath) => ({
+        filePath,
+        contents: readFileSync(filePath, 'utf-8'),
+    }));
+    ignores = [
+        ...ignorePatterns.map((i) => ({
+            dir: i.dir,
+            ig: ignore().add(i.contents),
+        })),
+        ...ignoreFiles.map((i) => ({
+            dir: dirname(i.filePath),
+            ig: ignore().add(i.contents),
+        })),
+    ];
+}
+//# sourceMappingURL=files.js.map

package/dist/util/files.js.map

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

package/dist/util/logging.d.ts

@@ -0,0 +1,5 @@
+export declare function warn(msg: string): void;
+export declare function error(msg: string): void;
+export declare function setVerbose(verbose: boolean): void;
+export declare function debug(msg: string): void;
+export declare function formatMilliseconds(duration: number): string;

package/dist/util/logging.js

@@ -0,0 +1,19 @@
+export function warn(msg) {
+    console.warn(`[Warn] fast-import: ${msg}`);
+}
+export function error(msg) {
+    console.error(`[Error] fast-import: ${msg}`);
+}
+let verboseEnabled = false;
+export function setVerbose(verbose) {
+    verboseEnabled = verbose;
+}
+export function debug(msg) {
+    if (verboseEnabled) {
+        console.debug(`[Debug] fast-import: ${msg}`);
+    }
+}
+export function formatMilliseconds(duration) {
+    return duration.toLocaleString() + 'ms';
+}
+//# sourceMappingURL=logging.js.map

package/dist/util/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/util/logging.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO,CAAC,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,IAAI,cAAc,GAAG,KAAK,CAAC;AAC3B,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,cAAc,GAAG,OAAO,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,QAAQ,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC;AAC1C,CAAC"}

package/eslint.config.mjs

@@ -0,0 +1,85 @@
+import js from '@eslint/js';
+import { FlatCompat } from '@eslint/eslintrc';
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
+import tseslint from 'typescript-eslint';
+import { createTypeScriptImportResolver } from 'eslint-import-resolver-typescript';
+import jest from 'eslint-plugin-jest';
+import globals from 'globals';
+import { getDirname } from 'cross-dirname';
+import { includeIgnoreFile } from '@eslint/compat';
+import { join } from 'node:path';
+import fastEsm from './dist/plugin.js';
+import { globalIgnores } from 'eslint/config';
+
+const compat = new FlatCompat({
+  baseDirectory: getDirname(),
+  recommendedConfig: js.configs.recommended,
+  allConfig: js.configs.all,
+});
+
+export default tseslint.config(
+  includeIgnoreFile(join(getDirname(), '.gitignore')),
+  globalIgnores(['src/**/__test__/**/project/*', 'jest.config.ts']),
+  {
+    settings: {
+      'import/resolver-next': [
+        createTypeScriptImportResolver({
+          alwaysTryTypes: true,
+        }),
+      ],
+      'fast-import': {
+        entryPoints: [
+          {
+            file: 'plugin.ts',
+            symbol: 'default',
+          },
+        ],
+        debugLogging: true,
+      },
+    },
+    files: ['**/*.{js,mjs,jsx,ts,tsx,mts}'],
+    languageOptions: {
+      globals: globals.node,
+    },
+  },
+  fastEsm.configs.recommended,
+  eslintPluginPrettierRecommended,
+  ...tseslint.configs.strictTypeChecked.map((r) =>
+    r.name === 'typescript-eslint/strict-type-checked'
+      ? {
+          ...r,
+          files: ['**/*.{ts,tsx,mts}'],
+        }
+      : r
+  ),
+  {
+    files: ['**/*.{ts,tsx,mts}'],
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: getDirname(),
+      },
+    },
+    rules: {
+      '@typescript-eslint/consistent-type-imports': 'error',
+    },
+  },
+  {
+    files: ['**/*.test.ts'],
+    ...jest.configs['flat/recommended'],
+  },
+  {
+    // disable type-aware linting on JS files
+    files: ['**/*..jsx,mjs}'],
+    extends: [tseslint.configs.disableTypeChecked],
+  },
+  ...compat.extends('eslint:recommended'),
+  {
+    rules: {
+      'object-shorthand': 'error',
+
+      // Handled by TypeScript eslint
+      'no-unused-vars': 'off',
+    },
+  }
+);

package/jest.config.ts

@@ -0,0 +1,10 @@
+import type { Config } from 'jest';
+import { createDefaultEsmPreset } from 'ts-jest';
+
+const presetConfig = createDefaultEsmPreset();
+
+export default {
+  ...presetConfig,
+  resolver: 'ts-jest-resolver',
+  setupFilesAfterEnv: ['<rootDir>/src/__test__/setup.ts'],
+} satisfies Config;