eslint-plugin-use-agnostic 0.9.6 → 0.9.7

package/library/agnostic20/_commons/utilities/helpers.js

@@ -1,16 +1,5 @@
+import { effectiveDirectives_effectiveModules } from "../../../_commons/constants/bases.js";
 import {
-  TSX,
-  TS,
-  JSX,
-  JS,
-  MJS,
-  CJS,
-  useServerJSXMessageId,
-  importBreaksEffectiveImportRulesMessageId,
-  reExportNotSameMessageId,
-} from "../../../_commons/constants/bases.js";
-import {
-  NO_DIRECTIVE,
   USE_SERVER,
   USE_CLIENT,
   USE_AGNOSTIC,
@@ -21,9 +10,9 @@ import {
   USE_CLIENT_COMPONENTS,
   USE_AGNOSTIC_LOGICS,
   USE_AGNOSTIC_COMPONENTS,
-  effectiveDirectives_EffectiveModules,
   directivesArray,
-  effectiveDirectives_BlockedImports,
+  directives_effectiveDirectives,
+  effectiveDirectives_blockedImports,
 } from "../constants/bases.js";
 
 import {
@@ -33,6 +22,13 @@ import {
   findSpecificViolationMessage as commonsFindSpecificViolationMessage,
 } from "../../../_commons/utilities/helpers.js";
 
+/**
+ * @typedef {import('../../../../types/agnostic20/_commons/typedefs.js').Context} Context
+ * @typedef {import('../../../../types/agnostic20/_commons/typedefs.js').Directive} Directive
+ * @typedef {import('../../../../types/agnostic20/_commons/typedefs.js').Extension} Extension
+ * @typedef {import('../../../../types/agnostic20/_commons/typedefs.js').EffectiveDirective} EffectiveDirective
+ */
+
 /* getDirectiveFromCurrentModule */
 
 /**
@@ -41,7 +37,7 @@ import {
  * - `'use client'` denotes a Client Module.
  * - `'use server'` denotes a Server Functions Module.
  * - `'use agnostic'` denotes an Agnostic Module (formerly Shared Module).
- * @param {Readonly<import('@typescript-eslint/utils').TSESLint.RuleContext<typeof reExportNotSameMessageId | typeof importBreaksEffectiveImportRulesMessageId | typeof useServerJSXMessageId, []>>} context The ESLint rule's `context` object.
+ * @param {Context} context The ESLint rule's `context` object.
  * @returns The directive, or lack thereof via `null`. The lack of a directive is considered server-by-default.
  */
 export const getDirectiveFromCurrentModule = (context) => {
@@ -79,15 +75,14 @@ export const getDirectiveFromCurrentModule = (context) => {
  * - `'use client components'` denotes a Client Components Module.
  * - `'use agnostic logics'` denotes an Agnostic Logics Module.
  * - `'use agnostic components'` denotes an Agnostic Components Module.
- * @param {NO_DIRECTIVE | USE_SERVER | USE_CLIENT | USE_AGNOSTIC} directive The directive as written on top of the file (`null` if no valid directive).
- * @param {TSX | TS | JSX | JS | MJS | CJS} extension The JavaScript (TypeScript) extension of the file.
+ * @param {Directive | null} directive The directive as written on top of the file (`null` if no valid directive).
+ * @param {Extension} extension The JavaScript (TypeScript) extension of the file.
  * @returns The effective directive, from which imports rules are applied.
  */
 export const getEffectiveDirective = (directive, extension) => {
   // I could use a map, but because this is in JS with JSDoc, a manual solution is peculiarly more typesafe.
-  if (directive === NO_DIRECTIVE && !extension.endsWith("x"))
-    return USE_SERVER_LOGICS;
-  if (directive === NO_DIRECTIVE && extension.endsWith("x"))
+  if (directive === null && !extension.endsWith("x")) return USE_SERVER_LOGICS;
+  if (directive === null && extension.endsWith("x"))
     return USE_SERVER_COMPONENTS;
   if (directive === USE_SERVER && !extension.endsWith("x"))
     return USE_SERVER_FUNCTIONS;
@@ -102,6 +97,23 @@ export const getEffectiveDirective = (directive, extension) => {
 
   return null; // default error, should be unreachable
 };
+// directives_effectiveDirectives
+/**
+ * @param {Directive | null} directive
+ * @param {Extension} extension
+ * @returns
+ */
+export const trueGetEffectiveDirective = (directive, extension) => {
+  const type = extension.endsWith("x")
+    ? "components"
+    : directive === USE_SERVER
+    ? "functions"
+    : "logics";
+
+  const a = directives_effectiveDirectives[directive];
+
+  return directives_effectiveDirectives[directive]?.[type] ?? null;
+};
 
 /* getDirectiveFromImportedModule */
 
@@ -139,8 +151,8 @@ export const getDirectiveFromImportedModule = (resolvedImportPath) => {
 
 /**
  * Returns a boolean deciding if an imported file's effective directive is incompatible with the current file's effective directive.
- * @param {USE_SERVER_LOGICS | USE_SERVER_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_LOGICS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_LOGICS | USE_AGNOSTIC_COMPONENTS} currentFileEffectiveDirective The current file's effective directive.
- * @param {USE_SERVER_LOGICS | USE_SERVER_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_LOGICS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_LOGICS | USE_AGNOSTIC_COMPONENTS} importedFileEffectiveDirective The imported file's effective directive.
+ * @param {EffectiveDirective} currentFileEffectiveDirective The current file's effective directive.
+ * @param {EffectiveDirective} importedFileEffectiveDirective The imported file's effective directive.
  * @returns `true` if the import is blocked, as established in `effectiveDirectives_BlockedImports`.
  */
 export const isImportBlocked = (
@@ -148,7 +160,7 @@ export const isImportBlocked = (
   importedFileEffectiveDirective
 ) =>
   commonsIsImportBlocked(
-    effectiveDirectives_BlockedImports,
+    effectiveDirectives_blockedImports,
     currentFileEffectiveDirective,
     importedFileEffectiveDirective
   );
@@ -157,13 +169,13 @@ export const isImportBlocked = (
 
 /**
  * Lists in an message the effective modules incompatible with an effective module based on its effective directive.
- * @param {USE_SERVER_LOGICS | USE_SERVER_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_LOGICS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_LOGICS | USE_AGNOSTIC_COMPONENTS} effectiveDirective The effective directive of the effective module.
+ * @param {EffectiveDirective} effectiveDirective The effective directive of the effective module.
  * @returns The message listing the incompatible effective modules.
  */
 export const makeMessageFromEffectiveDirective = (effectiveDirective) =>
   makeMessageFromResolvedDirective(
-    effectiveDirectives_EffectiveModules,
-    effectiveDirectives_BlockedImports,
+    effectiveDirectives_effectiveModules,
+    effectiveDirectives_blockedImports,
     effectiveDirective
   );
 
@@ -171,8 +183,8 @@ export const makeMessageFromEffectiveDirective = (effectiveDirective) =>
 
 /**
  * Finds the `message` for the specific violation of effective directives import rules based on `effectiveDirectives_BlockedImports`.
- * @param {USE_SERVER_LOGICS | USE_SERVER_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_LOGICS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_LOGICS | USE_AGNOSTIC_COMPONENTS} currentFileEffectiveDirective The current file's effective directive.
- * @param {USE_SERVER_LOGICS | USE_SERVER_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_LOGICS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_LOGICS | USE_AGNOSTIC_COMPONENTS} importedFileEffectiveDirective The imported file's effective directive.
+ * @param {EffectiveDirective} currentFileEffectiveDirective The current file's effective directive.
+ * @param {EffectiveDirective} importedFileEffectiveDirective The imported file's effective directive.
  * @returns The corresponding `message`.
  */
 export const findSpecificViolationMessage = (
@@ -180,7 +192,7 @@ export const findSpecificViolationMessage = (
   importedFileEffectiveDirective
 ) =>
   commonsFindSpecificViolationMessage(
-    effectiveDirectives_BlockedImports,
+    effectiveDirectives_blockedImports,
     currentFileEffectiveDirective,
     importedFileEffectiveDirective
   );

package/library/agnostic20/config.js

@@ -7,9 +7,13 @@ import {
   enforceEffectiveDirectivesRuleName,
 } from "../_commons/constants/bases.js";
 
+/**
+ * @typedef {import('../../types/agnostic20/_commons/typedefs.js').Plugin} Plugin
+ */
+
 /**
  * Makes the agnostic20 config for the use-agnostic ESLint plugin.
- * @param {import('eslint').ESLint.Plugin} plugin The use-agnostic ESLint plugin itself.
+ * @param {Plugin} plugin The use-agnostic ESLint plugin itself.
  * @returns The agnostic20 config's name as a key and its config as its value.
  */
 export const makeAgnostic20Config = (plugin) => ({

package/library/directive21/_commons/constants/bases.js

@@ -9,20 +9,19 @@ import {
   USE_CLIENT_CONTEXTS as COMMONS_USE_CLIENT_CONTEXTS,
   USE_AGNOSTIC_CONDITIONS as COMMONS_USE_AGNOSTIC_CONDITIONS,
   USE_AGNOSTIC_STRATEGIES as COMMONS_USE_AGNOSTIC_STRATEGIES,
-  SERVER_LOGICS_MODULE as COMMONS_SERVER_LOGICS_MODULE,
-  CLIENT_LOGICS_MODULE as COMMONS_CLIENT_LOGICS_MODULE,
-  AGNOSTIC_LOGICS_MODULE as COMMONS_AGNOSTIC_LOGICS_MODULE,
-  SERVER_COMPONENTS_MODULE as COMMONS_SERVER_COMPONENTS_MODULE,
-  CLIENT_COMPONENTS_MODULE as COMMONS_CLIENT_COMPONENTS_MODULE,
-  AGNOSTIC_COMPONENTS_MODULE as COMMONS_AGNOSTIC_COMPONENTS_MODULE,
-  SERVER_FUNCTIONS_MODULE as COMMONS_SERVER_FUNCTIONS_MODULE,
-  CLIENT_CONTEXTS_MODULE as COMMONS_CLIENT_CONTEXTS_MODULE,
-  AGNOSTIC_CONDITIONS_MODULE as COMMONS_AGNOSTIC_CONDITIONS_MODULE,
-  AGNOSTIC_STRATEGIES_MODULE as COMMONS_AGNOSTIC_STRATEGIES_MODULE,
+  commentedDirectives_commentedModules,
 } from "../../../_commons/constants/bases.js";
 
 import { makeIntroForSpecificViolationMessage as commonsMakeIntroForSpecificViolationMessage } from "../../../_commons/utilities/helpers.js";
 
+/**
+ * @typedef {import('../../../../types/directive21/_commons/typedefs.js').CommentedDirective} CommentedDirective
+ * @typedef {import('../../../../types/directive21/_commons/typedefs.js').CommentedDirectiveWithoutUseAgnosticStrategies} CommentedDirectiveWithoutUseAgnosticStrategies
+ * @typedef {import('../../../../types/directive21/_commons/typedefs.js').CommentedDirectives} CommentedDirectives
+ * @typedef {import('../../../../types/directive21/_commons/typedefs.js').CommentedStrategy} CommentedStrategy
+ * @typedef {import('../../../../types/directive21/_commons/typedefs.js').CommentedStrategies} CommentedStrategies
+ */
+
 // commented directives
 export const USE_SERVER_LOGICS = COMMONS_USE_SERVER_LOGICS;
 export const USE_CLIENT_LOGICS = COMMONS_USE_CLIENT_LOGICS;
@@ -36,7 +35,7 @@ export const USE_AGNOSTIC_CONDITIONS = COMMONS_USE_AGNOSTIC_CONDITIONS;
 export const USE_AGNOSTIC_STRATEGIES = COMMONS_USE_AGNOSTIC_STRATEGIES;
 
 // commented directives array
-/** @type {readonly [USE_SERVER_LOGICS, USE_CLIENT_LOGICS, USE_AGNOSTIC_LOGICS, USE_SERVER_COMPONENTS, USE_CLIENT_COMPONENTS, USE_AGNOSTIC_COMPONENTS, USE_SERVER_FUNCTIONS, USE_CLIENT_CONTEXTS, USE_AGNOSTIC_CONDITIONS, USE_AGNOSTIC_STRATEGIES]} */
+/** @type {CommentedDirectives} */
 export const directivesArray = [
   USE_SERVER_LOGICS,
   USE_CLIENT_LOGICS,
@@ -51,48 +50,22 @@ export const directivesArray = [
 ];
 
 // commented directives set
-/** @type {ReadonlySet<USE_SERVER_LOGICS | USE_CLIENT_LOGICS | USE_AGNOSTIC_LOGICS | USE_SERVER_COMPONENTS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_CONTEXTS | USE_AGNOSTIC_CONDITIONS | USE_AGNOSTIC_STRATEGIES>} */
+/** @type {ReadonlySet<CommentedDirective>} */
 export const directivesSet = new Set(directivesArray); // no longer used exported to satisfy static type inference
 
-// commented modules
-const SERVER_LOGICS_MODULE = COMMONS_SERVER_LOGICS_MODULE;
-const CLIENT_LOGICS_MODULE = COMMONS_CLIENT_LOGICS_MODULE;
-const AGNOSTIC_LOGICS_MODULE = COMMONS_AGNOSTIC_LOGICS_MODULE;
-const SERVER_COMPONENTS_MODULE = COMMONS_SERVER_COMPONENTS_MODULE;
-const CLIENT_COMPONENTS_MODULE = COMMONS_CLIENT_COMPONENTS_MODULE;
-const AGNOSTIC_COMPONENTS_MODULE = COMMONS_AGNOSTIC_COMPONENTS_MODULE;
-const SERVER_FUNCTIONS_MODULE = COMMONS_SERVER_FUNCTIONS_MODULE;
-const CLIENT_CONTEXTS_MODULE = COMMONS_CLIENT_CONTEXTS_MODULE;
-const AGNOSTIC_CONDITIONS_MODULE = COMMONS_AGNOSTIC_CONDITIONS_MODULE;
-const AGNOSTIC_STRATEGIES_MODULE = COMMONS_AGNOSTIC_STRATEGIES_MODULE;
-
-// mapping commented directives with commented modules
-export const commentedDirectives_CommentedModules = Object.freeze({
-  [USE_SERVER_LOGICS]: SERVER_LOGICS_MODULE,
-  [USE_CLIENT_LOGICS]: CLIENT_LOGICS_MODULE,
-  [USE_AGNOSTIC_LOGICS]: AGNOSTIC_LOGICS_MODULE,
-  [USE_SERVER_COMPONENTS]: SERVER_COMPONENTS_MODULE,
-  [USE_CLIENT_COMPONENTS]: CLIENT_COMPONENTS_MODULE,
-  [USE_AGNOSTIC_COMPONENTS]: AGNOSTIC_COMPONENTS_MODULE,
-  [USE_SERVER_FUNCTIONS]: SERVER_FUNCTIONS_MODULE,
-  [USE_CLIENT_CONTEXTS]: CLIENT_CONTEXTS_MODULE,
-  [USE_AGNOSTIC_CONDITIONS]: AGNOSTIC_CONDITIONS_MODULE,
-  [USE_AGNOSTIC_STRATEGIES]: AGNOSTIC_STRATEGIES_MODULE,
-});
-
 // commented strategies
-const AT_SERVER_LOGICS = "@serverLogics";
-const AT_CLIENT_LOGICS = "@clientLogics";
-const AT_AGNOSTIC_LOGICS = "@agnosticLogics";
-const AT_SERVER_COMPONENTS = "@serverComponents";
-const AT_CLIENT_COMPONENTS = "@clientComponents";
-const AT_AGNOSTIC_COMPONENTS = "@agnosticComponents";
-const AT_SERVER_FUNCTIONS = "@serverFunctions";
-const AT_CLIENT_CONTEXTS = "@clientContexts";
-const AT_AGNOSTIC_CONDITIONS = "@agnosticConditions";
+export const AT_SERVER_LOGICS = "@serverLogics";
+export const AT_CLIENT_LOGICS = "@clientLogics";
+export const AT_AGNOSTIC_LOGICS = "@agnosticLogics";
+export const AT_SERVER_COMPONENTS = "@serverComponents";
+export const AT_CLIENT_COMPONENTS = "@clientComponents";
+export const AT_AGNOSTIC_COMPONENTS = "@agnosticComponents";
+export const AT_SERVER_FUNCTIONS = "@serverFunctions";
+export const AT_CLIENT_CONTEXTS = "@clientContexts";
+export const AT_AGNOSTIC_CONDITIONS = "@agnosticConditions";
 
 // commented strategies array
-/** @type {readonly [AT_SERVER_LOGICS, AT_CLIENT_LOGICS, AT_AGNOSTIC_LOGICS, AT_SERVER_COMPONENTS, AT_CLIENT_COMPONENTS, AT_AGNOSTIC_COMPONENTS, AT_SERVER_FUNCTIONS, AT_CLIENT_CONTEXTS, AT_AGNOSTIC_CONDITIONS]} */
+/** @type {CommentedStrategies} */
 export const strategiesArray = [
   AT_SERVER_LOGICS,
   AT_CLIENT_LOGICS,
@@ -106,11 +79,11 @@ export const strategiesArray = [
 ];
 
 // commented strategies set
-/** @type {ReadonlySet<AT_SERVER_LOGICS | AT_CLIENT_LOGICS | AT_AGNOSTIC_LOGICS | AT_SERVER_COMPONENTS | AT_CLIENT_COMPONENTS | AT_AGNOSTIC_COMPONENTS | AT_SERVER_FUNCTIONS | AT_CLIENT_CONTEXTS | AT_AGNOSTIC_CONDITIONS>} */
+/** @type {ReadonlySet<CommentedStrategy>} */
 export const strategiesSet = new Set(strategiesArray); // no longer used exported to satisfy static type inference
 
 // mapped commented strategies to their commented directives
-export const commentedStrategies_CommentedDirectives = Object.freeze({
+export const commentedStrategies_commentedDirectives = Object.freeze({
   [AT_SERVER_LOGICS]: USE_SERVER_LOGICS,
   [AT_CLIENT_LOGICS]: USE_CLIENT_LOGICS,
   [AT_AGNOSTIC_LOGICS]: USE_AGNOSTIC_LOGICS,
@@ -141,7 +114,7 @@ const commentStyles = [
 
 /**
  * Makes the array of all four accepted commented directive implementations on a directive basis.
- * @param {USE_SERVER_LOGICS | USE_CLIENT_LOGICS | USE_AGNOSTIC_LOGICS | USE_SERVER_COMPONENTS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_CONTEXTS | USE_AGNOSTIC_CONDITIONS | USE_AGNOSTIC_STRATEGIES} directive The commented directive.
+ * @param {CommentedDirective} directive The commented directive.
  * @returns The array of formatted commented directives.
  */
 const make4RawImplementations = (directive) =>
@@ -163,7 +136,7 @@ export const commentedDirectives_4RawImplementations = Object.freeze({
   [USE_AGNOSTIC_STRATEGIES]: make4RawImplementations(USE_AGNOSTIC_STRATEGIES),
 });
 
-/* commentedDirectives_VerificationReports */
+/* commentedDirectives_verificationReports */
 
 const MODULES_MARKED_WITH_THE_ = "modules marked with the";
 const _DIRECTIVE_MUST_HAVE_A_NON_JSX_FILE_EXTENSION =
@@ -171,7 +144,7 @@ const _DIRECTIVE_MUST_HAVE_A_NON_JSX_FILE_EXTENSION =
 const _DIRECTIVE_MUST_HAVE_A_JSX_FILE_EXTENSION =
   "directive must have a JSX file extension";
 
-export const commentedDirectives_VerificationReports = Object.freeze({
+export const commentedDirectives_verificationReports = Object.freeze({
   // somehow doing it by hand is better for type inference in raw JS
   [USE_SERVER_LOGICS]: `${MODULES_MARKED_WITH_THE_} "${USE_SERVER_LOGICS}" ${_DIRECTIVE_MUST_HAVE_A_NON_JSX_FILE_EXTENSION}.`,
   [USE_CLIENT_LOGICS]: `${MODULES_MARKED_WITH_THE_} "${USE_CLIENT_LOGICS}" ${_DIRECTIVE_MUST_HAVE_A_NON_JSX_FILE_EXTENSION}.`,
@@ -185,12 +158,12 @@ export const commentedDirectives_VerificationReports = Object.freeze({
   [USE_AGNOSTIC_STRATEGIES]: `${MODULES_MARKED_WITH_THE_} "${USE_AGNOSTIC_STRATEGIES}" directive are free to have the file extension of their choosing. (This is not a problem and should never surface.)`,
 });
 
-/* commentedDirectives_BlockedImports */
+/* commentedDirectives_blockedImports */
 
 /**
  * Makes the intro for each specific import rule violation messages.
- * @param {USE_SERVER_LOGICS | USE_CLIENT_LOGICS | USE_AGNOSTIC_LOGICS | USE_SERVER_COMPONENTS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_CONTEXTS | USE_AGNOSTIC_CONDITIONS | USE_AGNOSTIC_STRATEGIES} currentFileCommentedDirective The current file's commented directive.
- * @param {USE_SERVER_LOGICS | USE_CLIENT_LOGICS | USE_AGNOSTIC_LOGICS | USE_SERVER_COMPONENTS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_CONTEXTS | USE_AGNOSTIC_CONDITIONS} importedFileCommentedDirective The imported file's commented directive.
+ * @param {CommentedDirective} currentFileCommentedDirective The current file's commented directive.
+ * @param {CommentedDirectiveWithoutUseAgnosticStrategies} importedFileCommentedDirective The imported file's commented directive.
  * @returns "[Current file commented modules] are not allowed to import [imported file commented modules]."
  */
 const makeIntroForSpecificViolationMessage = (
@@ -198,12 +171,12 @@ const makeIntroForSpecificViolationMessage = (
   importedFileCommentedDirective
 ) =>
   commonsMakeIntroForSpecificViolationMessage(
-    commentedDirectives_CommentedModules,
+    commentedDirectives_commentedModules,
     currentFileCommentedDirective,
     importedFileCommentedDirective
   );
 
-export const commentedDirectives_BlockedImports = Object.freeze({
+export const commentedDirectives_blockedImports = Object.freeze({
   [USE_SERVER_LOGICS]: [
     // USE_SERVER_LOGICS allowed, because Prime Server Logics can compose with one another.
     {

package/library/directive21/_commons/rules/import-rules.js

@@ -20,7 +20,11 @@ import {
   allExportsFlow,
 } from "../utilities/flows.js";
 
-/** @type {import('@typescript-eslint/utils').TSESLint.RuleModule<typeof reExportNotSameMessageId | typeof importBreaksCommentedImportRulesMessageId | typeof noCommentedDirective | typeof commentedDirectiveVerificationFailed | typeof importNotStrategized | typeof exportNotStrategized, []>} */
+/**
+ * @typedef {import('../../../../types/directive21/_commons/typedefs.js').Rule} Rule
+ */
+
+/** @type {Rule} */
 const rule = {
   meta: {
     type: "problem",

package/library/directive21/_commons/utilities/flows.js

@@ -7,20 +7,11 @@ import {
   noCommentedDirective,
   commentedDirectiveVerificationFailed,
   importNotStrategized,
-  exportNotStrategized,
+  skip,
 } from "../../../_commons/constants/bases.js";
 import {
-  USE_SERVER_LOGICS,
-  USE_CLIENT_LOGICS,
-  USE_AGNOSTIC_LOGICS,
-  USE_SERVER_COMPONENTS,
-  USE_CLIENT_COMPONENTS,
-  USE_AGNOSTIC_COMPONENTS,
-  USE_SERVER_FUNCTIONS,
-  USE_CLIENT_CONTEXTS,
-  USE_AGNOSTIC_CONDITIONS,
   USE_AGNOSTIC_STRATEGIES,
-  commentedDirectives_VerificationReports,
+  commentedDirectives_verificationReports,
   // currentFileCommentedDirective,
   // importedFileCommentedDirective,
   commentedDirectiveMessage,
@@ -43,14 +34,25 @@ import {
   addressDirectiveIfAgnosticStrategies,
 } from "./helpers.js";
 
+/**
+ * @typedef {import('../../../../types/directive21/_commons/typedefs.js').Context} Context
+ * @typedef {import('../../../../types/directive21/_commons/typedefs.js').CommentedDirective} CommentedDirective
+ * @typedef {import('../../../../types/directive21/_commons/typedefs.js').ImportDeclaration} ImportDeclaration
+ * @typedef {import('../../../../types/directive21/_commons/typedefs.js').ExportNamedDeclaration} ExportNamedDeclaration
+ * @typedef {import('../../../../types/directive21/_commons/typedefs.js').ExportAllDeclaration} ExportAllDeclaration
+ * @typedef {import('../../../../types/directive21/_commons/typedefs.js').ExportDefaultDeclaration} ExportDefaultDeclaration
+ */
+
 /* currentFileFlow */
 
 /**
  * The flow that begins the import rules enforcement rule, retrieving the valid directive of the current file before comparing it to upcoming valid directives of the files it imports.
- * @param {Readonly<import('@typescript-eslint/utils').TSESLint.RuleContext<typeof reExportNotSameMessageId | typeof importBreaksCommentedImportRulesMessageId | typeof noCommentedDirective | typeof commentedDirectiveVerificationFailed | typeof importNotStrategized | typeof exportNotStrategized, []>>} context The ESLint rule's `context` object.
- * @returns {{skip: true; verifiedCommentedDirective: undefined;} | {skip: undefined; verifiedCommentedDirective: USE_SERVER_LOGICS | USE_CLIENT_LOGICS | USE_AGNOSTIC_LOGICS | USE_SERVER_COMPONENTS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_CONTEXTS | USE_AGNOSTIC_CONDITIONS | USE_AGNOSTIC_STRATEGIES;}} Either an object with `skip: true` to disregard or one with the non-null `verifiedCommentedDirective`.
+ * @param {Context} context The ESLint rule's `context` object.
+ * @returns Either an object with `skip: true` to disregard or one with the non-null `verifiedCommentedDirective`. ()
  */
 export const currentFileFlow = (context) => {
+  const skipTrue = { ...skip, verifiedCommentedDirective: undefined };
+
   // GETTING THE EXTENSION OF THE CURRENT FILE
   const currentFileExtension = path.extname(context.filename);
 
@@ -62,7 +64,7 @@ export const currentFileFlow = (context) => {
     console.error(
       "ERROR. Linted files for this rule should only be in JavaScript (TypeScript)."
     );
-    return { skip: true };
+    return skipTrue;
   }
 
   // gets the commented directive from the current file
@@ -74,7 +76,7 @@ export const currentFileFlow = (context) => {
       loc: highlightFirstLineOfCode(context),
       messageId: noCommentedDirective,
     });
-    return { skip: true };
+    return skipTrue;
   }
 
   const verifiedCommentedDirective = getVerifiedCommentedDirective(
@@ -89,24 +91,26 @@ export const currentFileFlow = (context) => {
       messageId: commentedDirectiveVerificationFailed,
       data: {
         [specificFailure]:
-          commentedDirectives_VerificationReports[commentedDirective],
+          commentedDirectives_verificationReports[commentedDirective],
       },
     });
-    return { skip: true };
+    return skipTrue;
   }
 
-  return { verifiedCommentedDirective };
+  return { skip: undefined, verifiedCommentedDirective };
 };
 
 /* importedFileFlow */
 
 /**
  * The flow that is shared between import and re-export traversals to obtain the import file's commented directive.
- * @param {Readonly<import('@typescript-eslint/utils').TSESLint.RuleContext<typeof reExportNotSameMessageId | typeof importBreaksCommentedImportRulesMessageId | typeof noCommentedDirective | typeof commentedDirectiveVerificationFailed | typeof importNotStrategized | typeof exportNotStrategized, []>>} context The ESLint rule's `context` object.
- * @param {import('@typescript-eslint/types').TSESTree.ImportDeclaration} node The ESLint `node` of the rule's current traversal.
- * @returns {{skip: true; importedFileCommentedDirective: undefined;} | {skip: undefined; importedFileCommentedDirective: USE_SERVER_LOGICS | USE_CLIENT_LOGICS | USE_AGNOSTIC_LOGICS | USE_SERVER_COMPONENTS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_CONTEXTS | USE_AGNOSTIC_CONDITIONS;}} Either an object with `skip: true` to disregard or one with the non-null `importedFileCommentedDirective`.
+ * @param {Context} context The ESLint rule's `context` object.
+ * @param {ImportDeclaration} node The ESLint `node` of the rule's current traversal.
+ * @returns Either an object with `skip: true` to disregard or one with the non-null `importedFileCommentedDirective`.
  */
 const importedFileFlow = (context, node) => {
+  const skipTrue = { ...skip, importedFileCommentedDirective: undefined };
+
   // finds the full path of the import
   const resolvedImportPath = resolveImportPath(
     path.dirname(context.filename),
@@ -115,12 +119,12 @@ const importedFileFlow = (context, node) => {
   );
 
   // does not operate on paths it did not resolve
-  if (resolvedImportPath === null) return { skip: true };
+  if (resolvedImportPath === null) return skipTrue;
   // does not operate on non-JS files
   const isImportedFileJS = EXTENSIONS.some((ext) =>
     resolvedImportPath.endsWith(ext)
   );
-  if (!isImportedFileJS) return { skip: true };
+  if (!isImportedFileJS) return skipTrue;
 
   /* GETTING THE DIRECTIVE (or lack thereof) OF THE IMPORTED FILE */
   let importedFileCommentedDirective =
@@ -131,7 +135,7 @@ const importedFileFlow = (context, node) => {
     console.warn(
       "WARNING. The imported file, whose path has been resolved, has no directive. It is thus ignored since the report on that circumstance is available on the imported file itself."
     );
-    return { skip: true };
+    return skipTrue;
   }
 
   /* GETTING THE CORRECT DIRECTIVE INTERPRETATION OF STRATEGY FOR AGNOSTIC STRATEGIES MODULES IMPORTS. 
@@ -155,20 +159,20 @@ const importedFileFlow = (context, node) => {
         node,
         messageId: importNotStrategized,
       });
-      return { skip: true };
+      return skipTrue;
     }
   }
 
-  return { importedFileCommentedDirective };
+  return { skip: undefined, importedFileCommentedDirective };
 };
 
 /* importsFlow */
 
 /**
  * The full flow for import traversals to enforce effective directives import rules.
- * @param {Readonly<import('@typescript-eslint/utils').TSESLint.RuleContext<typeof reExportNotSameMessageId | typeof importBreaksCommentedImportRulesMessageId | typeof noCommentedDirective | typeof commentedDirectiveVerificationFailed | typeof importNotStrategized | typeof exportNotStrategized, []>>} context The ESLint rule's `context` object.
- * @param {import('@typescript-eslint/types').TSESTree.ImportDeclaration} node The ESLint `node` of the rule's current traversal.
- * @param {USE_SERVER_LOGICS | USE_CLIENT_LOGICS | USE_AGNOSTIC_LOGICS | USE_SERVER_COMPONENTS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_CONTEXTS | USE_AGNOSTIC_CONDITIONS | USE_AGNOSTIC_STRATEGIES} currentFileCommentedDirective The current file's commented directive.
+ * @param {Context} context The ESLint rule's `context` object.
+ * @param {ImportDeclaration} node The ESLint `node` of the rule's current traversal.
+ * @param {CommentedDirective} currentFileCommentedDirective The current file's commented directive.
  * @returns Early if the flow needs to be interrupted.
  */
 export const importsFlow = (context, node, currentFileCommentedDirective) => {
@@ -206,9 +210,9 @@ export const importsFlow = (context, node, currentFileCommentedDirective) => {
 
 /**
  * The full flow for export traversals, shared between `ExportNamedDeclaration`, `ExportAllDeclaration`, and `ExportDefaultDeclaration`, to ensure same commented directive re-exports in modules that aren't Agnostic Strategies Modules, and enforce strategized exports specifically in Agnostic Strategies Modules.
- * @param {Readonly<import('@typescript-eslint/utils').TSESLint.RuleContext<typeof reExportNotSameMessageId | typeof importBreaksCommentedImportRulesMessageId | typeof noCommentedDirective | typeof commentedDirectiveVerificationFailed | typeof importNotStrategized | typeof exportNotStrategized, []>>} context The ESLint rule's `context` object.
- * @param {import('@typescript-eslint/types').TSESTree.ExportNamedDeclaration | import('@typescript-eslint/types').TSESTree.ExportAllDeclaration | import('@typescript-eslint/types').TSESTree.ExportDefaultDeclaration} node The ESLint `node` of the rule's current traversal.
- * @param {USE_SERVER_LOGICS | USE_CLIENT_LOGICS | USE_AGNOSTIC_LOGICS | USE_SERVER_COMPONENTS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_CONTEXTS | USE_AGNOSTIC_CONDITIONS | USE_AGNOSTIC_STRATEGIES} currentFileCommentedDirective The current file's commented directive.
+ * @param {Context} context The ESLint rule's `context` object.
+ * @param {ExportNamedDeclaration | ExportAllDeclaration | ExportDefaultDeclaration} node The ESLint `node` of the rule's current traversal.
+ * @param {CommentedDirective} currentFileCommentedDirective The current file's commented directive.
  * @returns Early if the flow needs to be interrupted.
  */
 export const allExportsFlow = (