hook-o-gnese 0.0.1

package/dist/index.mjs

@@ -0,0 +1,357 @@
+import { t as ALL_RULES } from "./registry-iRG6wil9.mjs";
+//#region node_modules/.deno/@oxlint+plugins@1.63.0/node_modules/@oxlint/plugins/index.js
+const EMPTY_VISITOR = {};
+/**
+* Convert a plugin which used Oxlint's `createOnce` API to also work with ESLint.
+*
+* If any of the plugin's rules use the Oxlint alternative `createOnce` API,
+* add ESLint-compatible `create` methods to those rules, which delegate to `createOnce`.
+* This makes the plugin compatible with ESLint.
+*
+* The `plugin` object passed in is mutated in-place.
+*
+* @param plugin - Plugin to convert
+* @returns Plugin with all rules having `create` method
+* @throws {Error} If `plugin` is not an object, or `plugin.rules` is not an object
+*/
+function eslintCompatPlugin(plugin) {
+	if (typeof plugin != "object" || !plugin) throw Error("Plugin must be an object");
+	let { rules } = plugin;
+	if (typeof rules != "object" || !rules) throw Error("Plugin must have an object as `rules` property");
+	let afterHooksState = new AfterHooksState();
+	for (let ruleName in rules) Object.hasOwn(rules, ruleName) && convertRule(rules[ruleName], afterHooksState);
+	return plugin;
+}
+/**
+* Class containing state for tracking if any `after` hooks for a plugin's rules need to be called.
+*
+* # Aims
+*
+* Aims are:
+* 1. `after` hook of each rule runs after all other AST visit functions, and CFG event handlers.
+* 2. `after` hooks for *all* a plugin's rules run after *all* that plugin's rules have completed visiting AST.
+* 3. `after` hooks for *all* a plugin's rules run before *any* of plugin's rules begin linting another file.
+* 4. In the case of an error during AST traversal, `after` hooks are always still run.
+*
+* The above exactly matches the behavior when running a `createOnce` rule in Oxlint.
+*
+* # Why this is important
+*
+* All the complication comes from ensuring `after` hooks run even after an error during AST traversal.
+*
+* In ESLint CLI, an error will crash the process, so it doesn't particularly matter if `after` hooks run or not,
+* but language servers will typically swallow errors, and keep the process running.
+*
+* Rules using `before` and `after` hooks will often rely on both hooks running in a predictable order,
+* to maintain some internal state. For example, they may use `before` and `after` hooks to maintain a per-file
+* cache of data which is shared between rules. The cache use case is why rule (2) above is important.
+*
+* Below is an example of using `before` and `after` hooks to maintain a per-file cache, shared between rules.
+* It relies on all `before` hooks running before any rule starts visiting the AST,
+* and all `after` hooks running after all rules have finished visiting the AST.
+*
+* ```ts
+* let cache: Data | null = null;
+*
+* let numRunningRules = 0;
+*
+* const setupCache = (context) => {
+*   if (cache === null) cache = new Data(context);
+*   numRunningRules++;
+* };
+*
+* const teardownCache = () => {
+*   numRunningRules--;
+*   if (numRunningRules === 0) cache = null;
+* };
+*
+* const rule1 = {
+*   createOnce(context) {
+*     return {
+*       before() {
+*         setupCache(context);
+*       },
+*       Identifier(node) {
+*         // Use `cache`
+*       },
+*       after: teardownCache,
+*     };
+*   },
+* };
+*
+* const rule2 = {
+*   // Same as above
+* };
+*
+* const rule3 = {
+*   // Same as above
+* };
+* ```
+*
+* If `after` hooks did not always run, the next lint run could get stale state, and malfunction.
+* If `after` hooks ran in the wrong order (e.g. after some `before` hooks for next file),
+* `numRunningRules` would never get to 0, and cache would never be cleared.
+*
+* Note that because all rules run together in a single AST traversal, if a rule from plugin X throws an error,
+* it can disrupt rules from plugin Y. This would make it hard to debug.
+*
+* # Mechanism
+*
+* ## Initialization
+*
+* Rules with an `after` hook register themselves by:
+*
+* 1. Calling `registerResetFunction` to register a function to run `after` hook and clean up internal state.
+*    This call adds the reset fn to `resetFunctions`, and adds `AFTER_HOOK_INACTIVE` to `pendingStates`.
+* 2. Adding an `onCodePathEnd` CFG event handler to the visitor which calls `ruleFinished` at end of AST traversal.
+*
+* ## Per-file setup
+*
+* Before linting a file, `create` will call `setupAfterHook` which is created by `createContextAndVisitor`.
+* This registers that the `after` hook for the rule needs to run, by setting `pendingStates[ruleIndex]`
+* to `AFTER_HOOK_PENDING`, and incrementing `pendingCount`.
+*
+* If a cleanup microtask has not been scheduled yet, one is scheduled now (see reason below).
+*
+* ## Normal operation
+*
+* AST traversal for each rule ends with `ruleFinished` hook being called from `onCodePathEnd` CFG event handler.
+* It increments `lintFinishedCount`. If `lintFinishedCount` equals `pendingCount`, all rules have finished linting
+* the file, and `reset` is called, which calls all the pending `after` hooks.
+*
+* ## Error handling
+*
+* If an error is thrown during AST traversal, we ensure that `after` hooks are still run by 2 mechanisms:
+*
+* ### 1. Next microtick
+*
+* Before any rules began linting files, a microtask was scheduled, which runs on next micro-tick.
+* All language servers we're aware of run each lint task in a separate tick, so this microtask will run in next tick
+* after a linting run, before the next lint task starts.
+*
+* If the linting run completed successfully, the microtask does nothing.
+*
+* But if an error was thrown during AST traversal, this will be visible from the state of `pendingCount`.
+* The microtask will run any `after` hooks which need to be run, and reset state to reflect that there are
+* no more pending `after` hooks.
+*
+* ### 2. Fallback: Next lint run
+*
+* Before linting any file, the state of `pendingCount` is checked.
+* If any `after` hooks are still pending, they are run immediately.
+* They're run before the `context` objects in `createOnce` closures are updated to the next file,
+* so they run with access to the old `context` object from the last file.
+*
+* This fallback should not be required, but it's included as "belt and braces", to handle if any language server
+* or other environment running ESLint programmatically, does not pause a tick between linting runs.
+*/
+var AfterHooksState = class {
+	resetFunctions = [];
+	pendingStates = [];
+	pendingCount = 0;
+	lintFinishedCount = 0;
+	resetIsScheduled = !1;
+	sourceCode = null;
+	resetMicrotask = this.resetMicrotaskImpl.bind(this);
+	/**
+	* Register a function to run `after` hook for a rule, and reset state.
+	* @param reset - Function to run `after` hook and reset state
+	* @returns Index of rule
+	*/
+	registerResetFunction(reset) {
+		let { pendingStates } = this, index = pendingStates.length;
+		return pendingStates.push(0), this.resetFunctions.push(reset), index;
+	}
+	/**
+	* Register that a rule with `after` hook has completed linting a file.
+	* Called by `onCodePathEnd` CFG event handler which is added to visitor for rules with `after` hooks.
+	*
+	* If all rules with an `after` hook which needs to be run have completed linting the file, run all `after` hooks.
+	*/
+	ruleFinished() {
+		this.lintFinishedCount++, this.lintFinishedCount === this.pendingCount && this.reset(!1);
+	}
+	/**
+	* Call all reset functions where corresponding entry in `pendingStates` is `AFTER_HOOK_PENDING`.
+	* Should only be called when some `after` hooks are pending.
+	*
+	* @param ignoreErrors - `true` to catch and silently ignore any errors which occur in `after` hooks.
+	*   `false` to throw them,
+	* @throws {unknown} If `ignoreErrors` is `false` and an error occurs in any `after` hooks.
+	*/
+	reset(ignoreErrors) {
+		this.pendingCount;
+		let { resetFunctions, pendingStates } = this, hooksLen = pendingStates.length, hasError = !1, error;
+		for (let i = 0; i < hooksLen; i++) if (pendingStates[i] !== 0) {
+			pendingStates[i] = 0;
+			try {
+				resetFunctions[i]();
+			} catch (e) {
+				hasError === !1 && (hasError = !0, error = e);
+			}
+		}
+		if (this.pendingCount = 0, this.lintFinishedCount = 0, this.sourceCode = null, hasError === !0 && ignoreErrors === !1) throw error;
+	}
+	/**
+	* Schedule a microtask to run `reset` functions.
+	*/
+	scheduleReset() {
+		queueMicrotask(this.resetMicrotask), this.resetIsScheduled = !0;
+	}
+	/**
+	* Function which is scheduled as the cleanup microtask.
+	* `scheduleReset` uses `resetMicrotask` which is this method bound to `this`.
+	*/
+	resetMicrotaskImpl() {
+		this.resetIsScheduled = !1, this.pendingCount !== 0 && this.reset(!0);
+	}
+};
+/**
+* Convert a rule.
+*
+* The `rule` object passed in is mutated in-place.
+*
+* @param rule - Rule to convert
+* @param afterHooksState - State of `after` hooks
+* @throws {Error} If `rule` is not an object
+*/
+function convertRule(rule, afterHooksState) {
+	if (typeof rule != "object" || !rule) throw Error("Rule must be an object");
+	if ("create" in rule) return;
+	let context = null, visitor, beforeHook, setupAfterHook;
+	rule.create = (eslintContext) => {
+		context === null && ({context, visitor, beforeHook, setupAfterHook} = createContextAndVisitor(rule, afterHooksState));
+		let eslintFileContext = Object.getPrototypeOf(eslintContext);
+		if (setupAfterHook !== null) {
+			let { sourceCode } = eslintFileContext;
+			afterHooksState.sourceCode !== sourceCode && (afterHooksState.sourceCode = sourceCode, afterHooksState.pendingCount !== 0 && afterHooksState.reset(!0));
+		}
+		return Object.defineProperties(context, {
+			id: { value: eslintContext.id },
+			options: { value: eslintContext.options },
+			report: { value: eslintContext.report }
+		}), Object.setPrototypeOf(context, eslintFileContext), beforeHook !== null && beforeHook() === !1 ? EMPTY_VISITOR : (setupAfterHook !== null && (setupAfterHook(eslintFileContext.sourceCode.ast), afterHooksState.resetIsScheduled === !1 && afterHooksState.scheduleReset()), visitor);
+	};
+}
+const FILE_CONTEXT = Object.freeze({
+	get filename() {
+		throw Error("Cannot access `context.filename` in `createOnce`");
+	},
+	getFilename() {
+		throw Error("Cannot call `context.getFilename` in `createOnce`");
+	},
+	get physicalFilename() {
+		throw Error("Cannot access `context.physicalFilename` in `createOnce`");
+	},
+	getPhysicalFilename() {
+		throw Error("Cannot call `context.getPhysicalFilename` in `createOnce`");
+	},
+	get cwd() {
+		throw Error("Cannot access `context.cwd` in `createOnce`");
+	},
+	getCwd() {
+		throw Error("Cannot call `context.getCwd` in `createOnce`");
+	},
+	get sourceCode() {
+		throw Error("Cannot access `context.sourceCode` in `createOnce`");
+	},
+	getSourceCode() {
+		throw Error("Cannot call `context.getSourceCode` in `createOnce`");
+	},
+	get languageOptions() {
+		throw Error("Cannot access `context.languageOptions` in `createOnce`");
+	},
+	get settings() {
+		throw Error("Cannot access `context.settings` in `createOnce`");
+	},
+	extend(extension) {
+		return Object.freeze(Object.assign(Object.create(this), extension));
+	},
+	get parserOptions() {
+		throw Error("Cannot access `context.parserOptions` in `createOnce`");
+	},
+	get parserPath() {
+		throw Error("Cannot access `context.parserPath` in `createOnce`");
+	}
+});
+/**
+* Call `createOnce` method of rule, and return `Context`, `Visitor`, and `beforeHook` (if any).
+*
+* @param rule - Rule with `createOnce` method
+* @param afterHooksState - State of `after` hooks
+* @returns Object with `context`, `visitor`, and `beforeHook` properties,
+*   and `setupAfterHook` function if visitor has an `after` hook
+*/
+function createContextAndVisitor(rule, afterHooksState) {
+	let { createOnce } = rule;
+	if (createOnce == null) throw Error("Rules must define either a `create` or `createOnce` method");
+	if (typeof createOnce != "function") throw Error("Rule `createOnce` property must be a function");
+	let context = Object.create(FILE_CONTEXT, {
+		id: {
+			value: null,
+			enumerable: !0,
+			configurable: !0
+		},
+		options: {
+			value: null,
+			enumerable: !0,
+			configurable: !0
+		},
+		report: {
+			value() {
+				throw Error("Cannot report errors in `createOnce`");
+			},
+			enumerable: !0,
+			configurable: !0
+		}
+	}), { before: beforeHook, after: afterHook, ...visitor } = createOnce.call(rule, context);
+	if (beforeHook === void 0) beforeHook = null;
+	else if (beforeHook !== null && typeof beforeHook != "function") throw Error("`before` property of visitor must be a function if defined");
+	let setupAfterHook = null;
+	if (afterHook != null) {
+		if (typeof afterHook != "function") throw Error("`after` property of visitor must be a function if defined");
+		let program = null, ruleIndex = afterHooksState.registerResetFunction(() => {
+			program = null, afterHook();
+		});
+		setupAfterHook = (ast) => {
+			program = ast, afterHooksState.pendingStates[ruleIndex] = 1, afterHooksState.pendingCount++;
+		};
+		let onCodePathEnd = visitor.onCodePathEnd;
+		visitor.onCodePathEnd = onCodePathEnd == null ? function(_codePath, node) {
+			node === program && afterHooksState.ruleFinished();
+		} : function(codePath, node) {
+			onCodePathEnd.call(this, codePath, node), node === program && afterHooksState.ruleFinished();
+		};
+	}
+	return {
+		context,
+		visitor,
+		beforeHook,
+		setupAfterHook
+	};
+}
+//#endregion
+//#region src/index.ts
+const plugin = eslintCompatPlugin({
+	meta: { name: "hook-o-gnese" },
+	rules: ALL_RULES
+});
+const recommended = {
+	jsPlugins: ["./node_modules/hook-o-gnese/dist/index.mjs"],
+	options: {
+		typeAware: true,
+		typeCheck: true
+	},
+	rules: {
+		"hook-o-gnese/no-fat-effects": "warn",
+		"hook-o-gnese/state-scatter": "warn",
+		"hook-o-gnese/hook-coupling": "error",
+		"hook-o-gnese/custom-hook-depth": ["warn", { maxDepth: 3 }],
+		"typescript/no-floating-promises": "error",
+		"typescript/no-misused-promises": "error"
+	}
+};
+//#endregion
+export { plugin as default, recommended };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../node_modules/.deno/@oxlint+plugins@1.63.0/node_modules/@oxlint/plugins/index.js","../src/index.ts"],"sourcesContent":["//#region src-js/package/define.ts\n/**\n* Define a plugin.\n*\n* No-op function, just to provide type safety. Input is passed through unchanged.\n*\n* @param plugin - Plugin to define\n* @returns Same plugin as passed in\n*/\nfunction definePlugin(plugin) {\n\treturn plugin;\n}\n/**\n* Define a rule.\n*\n* No-op function, just to provide type safety. Input is passed through unchanged.\n*\n* @param rule - Rule to define\n* @returns Same rule as passed in\n*/\nfunction defineRule(rule) {\n\treturn rule;\n}\n//#endregion\n//#region src-js/package/compat.ts\nconst EMPTY_VISITOR = {};\n/**\n* Convert a plugin which used Oxlint's `createOnce` API to also work with ESLint.\n*\n* If any of the plugin's rules use the Oxlint alternative `createOnce` API,\n* add ESLint-compatible `create` methods to those rules, which delegate to `createOnce`.\n* This makes the plugin compatible with ESLint.\n*\n* The `plugin` object passed in is mutated in-place.\n*\n* @param plugin - Plugin to convert\n* @returns Plugin with all rules having `create` method\n* @throws {Error} If `plugin` is not an object, or `plugin.rules` is not an object\n*/\nfunction eslintCompatPlugin(plugin) {\n\tif (typeof plugin != \"object\" || !plugin) throw Error(\"Plugin must be an object\");\n\tlet { rules } = plugin;\n\tif (typeof rules != \"object\" || !rules) throw Error(\"Plugin must have an object as `rules` property\");\n\tlet afterHooksState = new AfterHooksState();\n\tfor (let ruleName in rules) Object.hasOwn(rules, ruleName) && convertRule(rules[ruleName], afterHooksState);\n\treturn plugin;\n}\n/**\n* Class containing state for tracking if any `after` hooks for a plugin's rules need to be called.\n*\n* # Aims\n*\n* Aims are:\n* 1. `after` hook of each rule runs after all other AST visit functions, and CFG event handlers.\n* 2. `after` hooks for *all* a plugin's rules run after *all* that plugin's rules have completed visiting AST.\n* 3. `after` hooks for *all* a plugin's rules run before *any* of plugin's rules begin linting another file.\n* 4. In the case of an error during AST traversal, `after` hooks are always still run.\n*\n* The above exactly matches the behavior when running a `createOnce` rule in Oxlint.\n*\n* # Why this is important\n*\n* All the complication comes from ensuring `after` hooks run even after an error during AST traversal.\n*\n* In ESLint CLI, an error will crash the process, so it doesn't particularly matter if `after` hooks run or not,\n* but language servers will typically swallow errors, and keep the process running.\n*\n* Rules using `before` and `after` hooks will often rely on both hooks running in a predictable order,\n* to maintain some internal state. For example, they may use `before` and `after` hooks to maintain a per-file\n* cache of data which is shared between rules. The cache use case is why rule (2) above is important.\n*\n* Below is an example of using `before` and `after` hooks to maintain a per-file cache, shared between rules.\n* It relies on all `before` hooks running before any rule starts visiting the AST,\n* and all `after` hooks running after all rules have finished visiting the AST.\n*\n* ```ts\n* let cache: Data | null = null;\n*\n* let numRunningRules = 0;\n*\n* const setupCache = (context) => {\n*   if (cache === null) cache = new Data(context);\n*   numRunningRules++;\n* };\n*\n* const teardownCache = () => {\n*   numRunningRules--;\n*   if (numRunningRules === 0) cache = null;\n* };\n*\n* const rule1 = {\n*   createOnce(context) {\n*     return {\n*       before() {\n*         setupCache(context);\n*       },\n*       Identifier(node) {\n*         // Use `cache`\n*       },\n*       after: teardownCache,\n*     };\n*   },\n* };\n*\n* const rule2 = {\n*   // Same as above\n* };\n*\n* const rule3 = {\n*   // Same as above\n* };\n* ```\n*\n* If `after` hooks did not always run, the next lint run could get stale state, and malfunction.\n* If `after` hooks ran in the wrong order (e.g. after some `before` hooks for next file),\n* `numRunningRules` would never get to 0, and cache would never be cleared.\n*\n* Note that because all rules run together in a single AST traversal, if a rule from plugin X throws an error,\n* it can disrupt rules from plugin Y. This would make it hard to debug.\n*\n* # Mechanism\n*\n* ## Initialization\n*\n* Rules with an `after` hook register themselves by:\n*\n* 1. Calling `registerResetFunction` to register a function to run `after` hook and clean up internal state.\n*    This call adds the reset fn to `resetFunctions`, and adds `AFTER_HOOK_INACTIVE` to `pendingStates`.\n* 2. Adding an `onCodePathEnd` CFG event handler to the visitor which calls `ruleFinished` at end of AST traversal.\n*\n* ## Per-file setup\n*\n* Before linting a file, `create` will call `setupAfterHook` which is created by `createContextAndVisitor`.\n* This registers that the `after` hook for the rule needs to run, by setting `pendingStates[ruleIndex]`\n* to `AFTER_HOOK_PENDING`, and incrementing `pendingCount`.\n*\n* If a cleanup microtask has not been scheduled yet, one is scheduled now (see reason below).\n*\n* ## Normal operation\n*\n* AST traversal for each rule ends with `ruleFinished` hook being called from `onCodePathEnd` CFG event handler.\n* It increments `lintFinishedCount`. If `lintFinishedCount` equals `pendingCount`, all rules have finished linting\n* the file, and `reset` is called, which calls all the pending `after` hooks.\n*\n* ## Error handling\n*\n* If an error is thrown during AST traversal, we ensure that `after` hooks are still run by 2 mechanisms:\n*\n* ### 1. Next microtick\n*\n* Before any rules began linting files, a microtask was scheduled, which runs on next micro-tick.\n* All language servers we're aware of run each lint task in a separate tick, so this microtask will run in next tick\n* after a linting run, before the next lint task starts.\n*\n* If the linting run completed successfully, the microtask does nothing.\n*\n* But if an error was thrown during AST traversal, this will be visible from the state of `pendingCount`.\n* The microtask will run any `after` hooks which need to be run, and reset state to reflect that there are\n* no more pending `after` hooks.\n*\n* ### 2. Fallback: Next lint run\n*\n* Before linting any file, the state of `pendingCount` is checked.\n* If any `after` hooks are still pending, they are run immediately.\n* They're run before the `context` objects in `createOnce` closures are updated to the next file,\n* so they run with access to the old `context` object from the last file.\n*\n* This fallback should not be required, but it's included as \"belt and braces\", to handle if any language server\n* or other environment running ESLint programmatically, does not pause a tick between linting runs.\n*/\nvar AfterHooksState = class {\n\tresetFunctions = [];\n\tpendingStates = [];\n\tpendingCount = 0;\n\tlintFinishedCount = 0;\n\tresetIsScheduled = !1;\n\tsourceCode = null;\n\tresetMicrotask = this.resetMicrotaskImpl.bind(this);\n\t/**\n\t* Register a function to run `after` hook for a rule, and reset state.\n\t* @param reset - Function to run `after` hook and reset state\n\t* @returns Index of rule\n\t*/\n\tregisterResetFunction(reset) {\n\t\tlet { pendingStates } = this, index = pendingStates.length;\n\t\treturn pendingStates.push(0), this.resetFunctions.push(reset), index;\n\t}\n\t/**\n\t* Register that a rule with `after` hook has completed linting a file.\n\t* Called by `onCodePathEnd` CFG event handler which is added to visitor for rules with `after` hooks.\n\t*\n\t* If all rules with an `after` hook which needs to be run have completed linting the file, run all `after` hooks.\n\t*/\n\truleFinished() {\n\t\tthis.lintFinishedCount++, this.lintFinishedCount === this.pendingCount && this.reset(!1);\n\t}\n\t/**\n\t* Call all reset functions where corresponding entry in `pendingStates` is `AFTER_HOOK_PENDING`.\n\t* Should only be called when some `after` hooks are pending.\n\t*\n\t* @param ignoreErrors - `true` to catch and silently ignore any errors which occur in `after` hooks.\n\t*   `false` to throw them,\n\t* @throws {unknown} If `ignoreErrors` is `false` and an error occurs in any `after` hooks.\n\t*/\n\treset(ignoreErrors) {\n\t\tthis.pendingCount;\n\t\tlet { resetFunctions, pendingStates } = this, hooksLen = pendingStates.length, hasError = !1, error;\n\t\tfor (let i = 0; i < hooksLen; i++) if (pendingStates[i] !== 0) {\n\t\t\tpendingStates[i] = 0;\n\t\t\ttry {\n\t\t\t\tresetFunctions[i]();\n\t\t\t} catch (e) {\n\t\t\t\thasError === !1 && (hasError = !0, error = e);\n\t\t\t}\n\t\t}\n\t\tif (this.pendingCount = 0, this.lintFinishedCount = 0, this.sourceCode = null, hasError === !0 && ignoreErrors === !1) throw error;\n\t}\n\t/**\n\t* Schedule a microtask to run `reset` functions.\n\t*/\n\tscheduleReset() {\n\t\tqueueMicrotask(this.resetMicrotask), this.resetIsScheduled = !0;\n\t}\n\t/**\n\t* Function which is scheduled as the cleanup microtask.\n\t* `scheduleReset` uses `resetMicrotask` which is this method bound to `this`.\n\t*/\n\tresetMicrotaskImpl() {\n\t\tthis.resetIsScheduled = !1, this.pendingCount !== 0 && this.reset(!0);\n\t}\n};\n/**\n* Convert a rule.\n*\n* The `rule` object passed in is mutated in-place.\n*\n* @param rule - Rule to convert\n* @param afterHooksState - State of `after` hooks\n* @throws {Error} If `rule` is not an object\n*/\nfunction convertRule(rule, afterHooksState) {\n\tif (typeof rule != \"object\" || !rule) throw Error(\"Rule must be an object\");\n\tif (\"create\" in rule) return;\n\tlet context = null, visitor, beforeHook, setupAfterHook;\n\trule.create = (eslintContext) => {\n\t\tcontext === null && ({context, visitor, beforeHook, setupAfterHook} = createContextAndVisitor(rule, afterHooksState));\n\t\tlet eslintFileContext = Object.getPrototypeOf(eslintContext);\n\t\tif (setupAfterHook !== null) {\n\t\t\tlet { sourceCode } = eslintFileContext;\n\t\t\tafterHooksState.sourceCode !== sourceCode && (afterHooksState.sourceCode = sourceCode, afterHooksState.pendingCount !== 0 && afterHooksState.reset(!0));\n\t\t}\n\t\treturn Object.defineProperties(context, {\n\t\t\tid: { value: eslintContext.id },\n\t\t\toptions: { value: eslintContext.options },\n\t\t\treport: { value: eslintContext.report }\n\t\t}), Object.setPrototypeOf(context, eslintFileContext), beforeHook !== null && beforeHook() === !1 ? EMPTY_VISITOR : (setupAfterHook !== null && (setupAfterHook(eslintFileContext.sourceCode.ast), afterHooksState.resetIsScheduled === !1 && afterHooksState.scheduleReset()), visitor);\n\t};\n}\nconst FILE_CONTEXT = Object.freeze({\n\tget filename() {\n\t\tthrow Error(\"Cannot access `context.filename` in `createOnce`\");\n\t},\n\tgetFilename() {\n\t\tthrow Error(\"Cannot call `context.getFilename` in `createOnce`\");\n\t},\n\tget physicalFilename() {\n\t\tthrow Error(\"Cannot access `context.physicalFilename` in `createOnce`\");\n\t},\n\tgetPhysicalFilename() {\n\t\tthrow Error(\"Cannot call `context.getPhysicalFilename` in `createOnce`\");\n\t},\n\tget cwd() {\n\t\tthrow Error(\"Cannot access `context.cwd` in `createOnce`\");\n\t},\n\tgetCwd() {\n\t\tthrow Error(\"Cannot call `context.getCwd` in `createOnce`\");\n\t},\n\tget sourceCode() {\n\t\tthrow Error(\"Cannot access `context.sourceCode` in `createOnce`\");\n\t},\n\tgetSourceCode() {\n\t\tthrow Error(\"Cannot call `context.getSourceCode` in `createOnce`\");\n\t},\n\tget languageOptions() {\n\t\tthrow Error(\"Cannot access `context.languageOptions` in `createOnce`\");\n\t},\n\tget settings() {\n\t\tthrow Error(\"Cannot access `context.settings` in `createOnce`\");\n\t},\n\textend(extension) {\n\t\treturn Object.freeze(Object.assign(Object.create(this), extension));\n\t},\n\tget parserOptions() {\n\t\tthrow Error(\"Cannot access `context.parserOptions` in `createOnce`\");\n\t},\n\tget parserPath() {\n\t\tthrow Error(\"Cannot access `context.parserPath` in `createOnce`\");\n\t}\n});\n/**\n* Call `createOnce` method of rule, and return `Context`, `Visitor`, and `beforeHook` (if any).\n*\n* @param rule - Rule with `createOnce` method\n* @param afterHooksState - State of `after` hooks\n* @returns Object with `context`, `visitor`, and `beforeHook` properties,\n*   and `setupAfterHook` function if visitor has an `after` hook\n*/\nfunction createContextAndVisitor(rule, afterHooksState) {\n\tlet { createOnce } = rule;\n\tif (createOnce == null) throw Error(\"Rules must define either a `create` or `createOnce` method\");\n\tif (typeof createOnce != \"function\") throw Error(\"Rule `createOnce` property must be a function\");\n\tlet context = Object.create(FILE_CONTEXT, {\n\t\tid: {\n\t\t\tvalue: null,\n\t\t\tenumerable: !0,\n\t\t\tconfigurable: !0\n\t\t},\n\t\toptions: {\n\t\t\tvalue: null,\n\t\t\tenumerable: !0,\n\t\t\tconfigurable: !0\n\t\t},\n\t\treport: {\n\t\t\tvalue() {\n\t\t\t\tthrow Error(\"Cannot report errors in `createOnce`\");\n\t\t\t},\n\t\t\tenumerable: !0,\n\t\t\tconfigurable: !0\n\t\t}\n\t}), { before: beforeHook, after: afterHook, ...visitor } = createOnce.call(rule, context);\n\tif (beforeHook === void 0) beforeHook = null;\n\telse if (beforeHook !== null && typeof beforeHook != \"function\") throw Error(\"`before` property of visitor must be a function if defined\");\n\tlet setupAfterHook = null;\n\tif (afterHook != null) {\n\t\tif (typeof afterHook != \"function\") throw Error(\"`after` property of visitor must be a function if defined\");\n\t\tlet program = null, ruleIndex = afterHooksState.registerResetFunction(() => {\n\t\t\tprogram = null, afterHook();\n\t\t});\n\t\tsetupAfterHook = (ast) => {\n\t\t\tprogram = ast, afterHooksState.pendingStates[ruleIndex] = 1, afterHooksState.pendingCount++;\n\t\t};\n\t\tlet onCodePathEnd = visitor.onCodePathEnd;\n\t\tvisitor.onCodePathEnd = onCodePathEnd == null ? function(_codePath, node) {\n\t\t\tnode === program && afterHooksState.ruleFinished();\n\t\t} : function(codePath, node) {\n\t\t\tonCodePathEnd.call(this, codePath, node), node === program && afterHooksState.ruleFinished();\n\t\t};\n\t}\n\treturn {\n\t\tcontext,\n\t\tvisitor,\n\t\tbeforeHook,\n\t\tsetupAfterHook\n\t};\n}\n//#endregion\nexport { definePlugin, defineRule, eslintCompatPlugin };\n","import { eslintCompatPlugin, type Plugin } from \"@oxlint/plugins\";\nimport { ALL_RULES } from \"./rules/registry.ts\";\n\nconst plugin: Plugin = eslintCompatPlugin({\n  meta: { name: \"hook-o-gnese\" },\n  rules: ALL_RULES,\n});\n\nexport const recommended = {\n  jsPlugins: [\"./node_modules/hook-o-gnese/dist/index.mjs\"],\n  options: { typeAware: true, typeCheck: true },\n  rules: {\n    \"hook-o-gnese/no-fat-effects\": \"warn\",\n    \"hook-o-gnese/state-scatter\": \"warn\",\n    \"hook-o-gnese/hook-coupling\": \"error\",\n    \"hook-o-gnese/custom-hook-depth\": [\"warn\", { maxDepth: 3 }],\n    \"typescript/no-floating-promises\": \"error\",\n    \"typescript/no-misused-promises\": \"error\",\n  },\n};\n\nexport default plugin;\n"],"x_google_ignoreList":[0],"mappings":"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"}