eslint-plugin-use-agnostic 0.9.0 → 0.9.2

package/README.md

@@ -85,9 +85,9 @@ Only the first line of code in a file is observed for the presence of a directiv
 
 Aliased import paths are resolved only if your ESLint config file and your `tsconfig.json` file are in the same directory. (At least to my knowledge.)
 
-It is up to you to confirm that your Agnostic Modules are indeed agnostic, meaning that they do not have neither server- nor client-side code. `eslint-plugin-use-agnostic`, at least at this time, does not do this verification for you.
+It is up to you to confirm that your Agnostic Modules are indeed agnostic, meaning that they have neither server- nor client-side code. `eslint-plugin-use-agnostic`, at least at this time, does not do this verification for you.
 
-It is also up to you to ensure, as outlined above, that **you do not mix** exporting React components with exporting other logics within the same module. Separating exporting React components from their own modules ending with a JSX extension, from other logics from modules that don't end with a JSX extension, is crucial for distinguishing between Logics Modules and Components Modules.
+It is also up to you to ensure, as outlined above, that **you do not mix** exporting React components with exporting other logics within the same module. Separating exporting React components within their own modules ending with a JSX extension, from exporting other logics within modules that don't end with a JSX extension, is crucial for distinguishing between Logics Modules and Components Modules.
 
 The import rules are designed to be as permissive as possible, allowing for more obscure use cases as long as they are non-breaking. However, it is still your responsibility as a developer to, within a file, not mix in incompatible ways code that cannot compose.
 
@@ -95,13 +95,13 @@ The import rules are designed to be as permissive as possible, allowing for more
 
 I believe the core issue hindering the comprehension of React Server Components is the fact that the Fullstack React Architecture has entirely erased its own roots since the introduction of directives by disregarding the architecture's primordial realities I have detailed above: its Modules. Server Modules. Client Modules. Agnostic Modules.
 
-'use client' may denote to the server that a module's exports are to be imported as client references. But then that effectively makes it a "'use client' module", and it's only natural that a "'use client' module" would behave in a 'use client' way.
+'use client' may denote to the server that a module's exports are to be imported as client references. But that effectively makes said module a "'use client' module", and it's only natural that a "'use client' module" would behave in a 'use client' way.
 
-'use server' may denote to the client that a module's exports are to be imported as server references. But then that effectively makes it a "'use server' module", and it's only natural that a "'use server' module" would behave in a 'use server' way.
+'use server' may denote to the client that a module's exports are to be imported as server references. But that effectively makes said module a "'use server' module", and it's only natural that a "'use server' module" would behave in a 'use server' way.
 
 React can easily understand that a 'use client' module is, from a primordial standpoint, a Client Module. And it can also understand that a 'use server' module is a Server Module, albeit a special one.
 
-But not having a directive to distinguish between 1. non-special Server Modules that are never meant to be imported on the client, even as references; and 2. actual Agnostic Modules, the Shared Modules that are still here at the heart of this system and are able to run anywhere; that creates a confusion that is detrimental to every single stackholder in the RSC ecosystem:
+But not having a directive to distinguish between 1. non-special Server Modules that are never meant to be imported on the client, even as references; and 2. actual Agnostic Modules, the Shared Modules that are still here at the heart of this system and are able to run anywhere; this creates a confusion that is detrimental to every single stackholder in the RSC ecosystem:
 
 - Developers are confused and have no idea what "Server" or "Client" means, since React doesn't make it crystal clear.
 - LLMs are confused, because even they can't understand what 'use server' and 'use client' mean and therefore cannot explain it to developers facing their own specific concerns.
@@ -109,4 +109,4 @@ But not having a directive to distinguish between 1. non-special Server Modules
 
 This is what the 'use agnostic' directive solves. It clearly marks a module to be an Agnostic Module. And if a module that used to lack a directive can now be marked as an Agnostic Module, this allows modules without a directive to finally, truly be Server Modules by default. And eslint-plugin-use-agnostic can work from there.
 
-A lot more work needs to be done, and a lot of it unfortunately can only be optimized deeper into React's innerworkings. But if the introduction of 'use agnostic' can already create such powerful static analysis, imagine what it could produce if only it were incorporated into React as an official directive of the Fullstack React Architecture.
+A lot more needs to be done, and a lot of it unfortunately can only be optimized deeper into React's innerworkings. But if the introduction of 'use agnostic' can already create such powerful static analysis, imagine what it could produce if only it were incorporated into React as an official directive of the Fullstack React Architecture.

package/library/_commons/constants/bases.js

@@ -1,7 +1,7 @@
 /* plugin names */
 // use-agnostic
 export const useAgnosticPluginName = "use-agnostic";
-// crossingStrategies
+// crossingStrategies (canceled)
 export const strategiesPluginName = "strategies";
 
 /* config names */
@@ -18,7 +18,7 @@ export const enforceEffectiveDirectivesRuleName =
 export const enforceCommentedDirectivesRuleName =
   "enforce-commented-directives-import-rules";
 
-// crossingStrategies
+// crossingStrategies (canceled)
 export const verifySpecifierImportRuleName =
   "verify-specifier-import-export-same-strategy";
 export const verifyDefaultImportRuleName =
@@ -44,6 +44,8 @@ export const exportNotStrategized =
   "export-from-use-agnostic-strategies-not-strategized";
 
 // all "resolved" directives (from AIA/agnostic20 & DFA/directive21)
+// - AIA: Agnostic-Included Architecture (agnostic20)
+// - DFA: Directive-First Architecture (directive21)
 export const USE_SERVER_LOGICS = "use server logics";
 export const USE_CLIENT_LOGICS = "use client logics";
 export const USE_AGNOSTIC_LOGICS = "use agnostic logics";

package/library/_commons/utilities/helpers.js

@@ -97,6 +97,18 @@ export const getImportedFileFirstLine = (resolvedImportPath) => {
   return importedFileFirstLine;
 };
 
+/* highlightFirstLineOfCode */
+
+/**
+ * Gets the coordinates for the first line of code of a file.
+ * @param {import('@typescript-eslint/utils').TSESLint.RuleContext} context An ESLint rule's `context` object.
+ * @returns The `context.report` `loc`-compatible coordinates for the first line of code of a file.
+ */
+export const highlightFirstLineOfCode = (context) => ({
+  start: { line: 1, column: 0 },
+  end: { line: 1, column: context.sourceCode.lines[0].length },
+});
+
 /* isImportBlocked */
 
 /**
@@ -110,7 +122,7 @@ export const isImportBlocked = (
   // Note: "Blocked" here is preferred over "not allowed" because a specific message will be shared for each of the blocked situations, explaining their reasons and the solutions needed.
   resolvedDirectives_blockedImports,
   currentFileResolvedDirective,
-  importedFileResolvedDirective,
+  importedFileResolvedDirective
 ) =>
   resolvedDirectives_blockedImports[currentFileResolvedDirective]
     .map((e) => e.blockedImport)
@@ -123,12 +135,12 @@ export const isImportBlocked = (
  * @param {Readonly<{"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;}>} resolvedDirectives_ResolvedModules The resolved modules object, either for agnostic20 or for directive21.
  * @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} currentFileResolvedDirective The current file's "resolved" 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} importedFileResolvedDirective The imported file's "resolved" directive.
- * @returns {string} Returns "[Current file 'resolved' modules] are not allowed to import [imported file 'resolved' modules]".
+ * @returns {string} Returns "[Current file 'resolved' modules] are not allowed to import [imported file 'resolved' modules]."
  */
 export const makeIntroForSpecificViolationMessage = (
   resolvedDirectives_ResolvedModules,
   currentFileResolvedDirective,
-  importedFileResolvedDirective,
+  importedFileResolvedDirective
 ) =>
   `${resolvedDirectives_ResolvedModules[currentFileResolvedDirective]}s ${ARE_NOT_ALLOWED_TO_IMPORT} ${resolvedDirectives_ResolvedModules[importedFileResolvedDirective]}s.`;
 
@@ -144,14 +156,14 @@ export const makeIntroForSpecificViolationMessage = (
 export const makeMessageFromResolvedDirective = (
   resolvedDirectives_ResolvedModules,
   resolvedDirectives_blockedImports,
-  resolvedDirective,
+  resolvedDirective
 ) => {
   const effectiveModule = resolvedDirectives_ResolvedModules[resolvedDirective];
   const effectiveModulesString = effectiveModule + "s"; // plural
 
   const blockedImports =
     resolvedDirectives_blockedImports[resolvedDirective].map(
-      (e) => e.blockedImport,
+      (e) => e.blockedImport
     ) || [];
 
   if (blockedImports.length === 0) {
@@ -159,7 +171,7 @@ export const makeMessageFromResolvedDirective = (
   }
 
   const blockedEffectiveModules = blockedImports.map(
-    (e) => resolvedDirectives_ResolvedModules[e] + "s", // plural
+    (e) => resolvedDirectives_ResolvedModules[e] + "s" // plural
   );
 
   const blockedEffectiveModulesString =
@@ -184,8 +196,8 @@ export const makeMessageFromResolvedDirective = (
 export const findSpecificViolationMessage = (
   resolvedDirectives_blockedImports,
   currentFileResolvedDirective,
-  importedFileResolvedDirective,
+  importedFileResolvedDirective
 ) =>
   resolvedDirectives_blockedImports[currentFileResolvedDirective].find(
-    (e) => e.blockedImport === importedFileResolvedDirective,
+    (e) => e.blockedImport === importedFileResolvedDirective
   ).message;

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

@@ -65,6 +65,7 @@ export const directivesSet = new Set([USE_SERVER, USE_CLIENT, USE_AGNOSTIC]);
 
 /* from the getDirectiveFromImportedModule utility */
 
+/** @type {readonly [USE_SERVER, USE_CLIENT, USE_AGNOSTIC]} */
 export const directivesArray = Array.from(directivesSet);
 
 /* from the isImportBlocked utility */
@@ -75,7 +76,7 @@ export const directivesArray = Array.from(directivesSet);
  * Makes the intro for each specific import rule violation messages.
  * @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.
- * @returns {string} Returns "[Current file effective modules] are not allowed to import [imported file effective modules]".
+ * @returns {string} Returns "[Current file effective modules] are not allowed to import [imported file effective modules]."
  */
 const makeIntroForSpecificViolationMessage = (
   currentFileEffectiveDirective,
@@ -94,13 +95,13 @@ export const effectiveDirectives_BlockedImports = Object.freeze({
   [USE_SERVER_LOGICS]: [
     // USE_SERVER_LOGICS allowed, because Server Logics can compose with one another.
     // USE_SERVER_COMPONENTS allowed, because Server Components are OK to be composed with Server Logics as long as the Server Logics Module, by convention, does not export React components.
-    // USE_SERVER_FUNCTIONS allowed, because as Server Functions can import one another, it is only natural that they could compose through Server Logics.
+    // USE_SERVER_FUNCTIONS allowed, because Server Functions, being able to import one another, can compose and do so via Server Logics, despite this method seeming superfluous at first glance. (Perhaps a preferrable use case for this has been found or could be found either today or in the future.)
     {
       blockedImport: USE_CLIENT_LOGICS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_LOGICS,
         USE_CLIENT_LOGICS
-      )} Client logic should never leak to the server.`,
+      )} Client Logics should never leak to the server.`,
     },
     {
       blockedImport: USE_CLIENT_COMPONENTS,
@@ -109,55 +110,55 @@ export const effectiveDirectives_BlockedImports = Object.freeze({
         USE_CLIENT_COMPONENTS
       )} Client Components cannot be tinkered with on the server.`,
     },
-    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logic can run safely on the server just like it can on the client.
-    // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can be composed with Logics on the server just like they can on the client, again, as long at the Server Logics Module, by convention, does not export React components.
+    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logics can run safely on the server just like they can on the client.
+    // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can be composed with Logics on the server just like they can on the client, as long at the Server Logics Module, by convention, does not export React components.
   ],
   [USE_SERVER_COMPONENTS]: [
-    // USE_SERVER_LOGICS allowed, because logic from the server can safely support Server Components.
+    // USE_SERVER_LOGICS allowed, because Server Logics, being logic from the server, can safely support Server Components.
     // USE_SERVER_COMPONENTS allowed, because Server Components can compose with one another, assuming thanks to the inclusion of the 'use agnostic' directive that they are actual Server Components.
-    // USE_SERVER_FUNCTIONS allowed, because as Server Components Modules can import Client Components, they are able to pass them Server Functions as props as well, even though indeed Server Components Modules can make their own Server Functions through inline 'use server' directives.
+    // USE_SERVER_FUNCTIONS allowed, because Server Functions can be passed to imported Client Components within Server Components Modules, even though indeed Server Components Modules and Server Components can make their own Server Functions through inline 'use server' directives.
     {
       blockedImport: USE_CLIENT_LOGICS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_COMPONENTS,
         USE_CLIENT_LOGICS
-      )} Client logic should never leak to the server.`,
+      )} Client Logics should never leak to the server.`,
     },
     // USE_CLIENT_COMPONENTS allowed, because Client Components can be nested inside Server Components either to wrap some of the tree with client state accessible through child Client Components and pass through Server Components, or to create client boundaries when the root of the application is planted on the server.
-    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logic can run safely on the server just like it can on the client.
+    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logics can run safely on the server just like they can on the client.
     // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can render safely on the server just like they can on the client.
   ],
   [USE_SERVER_FUNCTIONS]: [
-    // USE_SERVER_LOGICS allowed, because logic from the server can safely support Server Functions.
+    // USE_SERVER_LOGICS allowed, because Server Logics, being logic from the server, can safely support Server Functions.
     {
       blockedImport: USE_SERVER_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_FUNCTIONS,
         USE_SERVER_COMPONENTS
-      )} Server Functions have no business working with React Components.`,
+      )} Server Components aren't allowed because Server Functions have no business working with React Components.`,
     },
-    // USE_SERVER_FUNCTIONS allowed, because even though Server Functions don't need to import one another and the same results can be generated via Server Logic alone for the outcome of a single Server Function, a rational use case could be found for composing Server Functions with one another either today or in the future.
+    // USE_SERVER_FUNCTIONS allowed, because Server Functions, even though they don't need to import one another and the same results can be generated via Server Logics for the outcome of a single Server Function, can still compose with one another. (Perhaps a preferrable use case for this has been found or could be found either today or in the future.)
     {
       blockedImport: USE_CLIENT_LOGICS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_FUNCTIONS,
         USE_CLIENT_LOGICS
-      )} Client logic should never leak to the server.`,
+      )} Client Logics should never leak to the server.`,
     },
     {
       blockedImport: USE_CLIENT_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_FUNCTIONS,
         USE_CLIENT_COMPONENTS
-      )} Server Functions have no business working with React Components.`,
+      )} Client Components aren't allowed because Server Functions have no business working with React Components.`,
     },
-    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logic can run safely on the server just like it can on the client.
+    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logics can run safely on the server just like they can on the client.
     {
       blockedImport: USE_AGNOSTIC_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_FUNCTIONS,
         USE_AGNOSTIC_COMPONENTS
-      )} Server Functions have no business working with React Components.`,
+      )} Agnostic Components aren't allowed because Server Functions have no business working with React Components.`,
     },
   ],
   [USE_CLIENT_LOGICS]: [
@@ -166,7 +167,7 @@ export const effectiveDirectives_BlockedImports = Object.freeze({
       message: `${makeIntroForSpecificViolationMessage(
         USE_CLIENT_LOGICS,
         USE_SERVER_LOGICS
-      )} Server logic should never leak to the client. 
+      )} Server Logics should never leak to the client. 
 ${SUGGEST_USE_AGNOSTIC}`,
     },
     {
@@ -177,11 +178,11 @@ ${SUGGEST_USE_AGNOSTIC}`,
       )} Server Components cannot be thinkered with on the client. 
 ${SUGGEST_USE_AGNOSTIC}`,
     },
-    // USE_SERVER_FUNCTIONS allowed, because it is technically feasible to tinker with a Client Component within a Client Logics Module and attach to said Client Component a Server Function to be triggered on the client.
+    // USE_SERVER_FUNCTIONS allowed, because Server Functions can technically be attached to Client Components that are being tinkered with within Client Logics Modules.
     // USE_CLIENT_LOGICS allowed, because Client Logics can compose with one another.
     // USE_CLIENT_COMPONENTS allowed, because Client Components are OK to be composed with Client Logics as long as the Client Logics Module, by convention, does not export React components.
-    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logic can run safely on the client just like it can on the server.
-    // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can be composed with Logics on the client just like they can on the server, again, as long at the Client Logics Module, by convention, does not export React components.
+    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logics can run safely on the client just like they can on the server.
+    // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can be composed with Logics on the client just like they can on the server, as long as the Client Logics Module, by convention, does not export React components.
   ],
   [USE_CLIENT_COMPONENTS]: [
     {
@@ -189,7 +190,7 @@ ${SUGGEST_USE_AGNOSTIC}`,
       message: `${makeIntroForSpecificViolationMessage(
         USE_CLIENT_COMPONENTS,
         USE_SERVER_LOGICS
-      )} Server logic should never leak to the client. 
+      )} Server Logics should never leak to the client. 
 ${SUGGEST_USE_AGNOSTIC}`,
     },
     {
@@ -197,13 +198,13 @@ ${SUGGEST_USE_AGNOSTIC}`,
       message: `${makeIntroForSpecificViolationMessage(
         USE_CLIENT_COMPONENTS,
         USE_SERVER_COMPONENTS
-      )} Server Components may only pass through Client Components through the children prop within Server Components Modules. 
+      )} Server Components may only pass through Client Components via the children prop within Server Components Modules. 
 ${SUGGEST_USE_AGNOSTIC}`,
     },
     // USE_SERVER_FUNCTIONS allowed, because Server Functions are specifically triggered by Client Components.
-    // USE_CLIENT_LOGICS allowed, because logic from the client can safely support Client Components.
+    // USE_CLIENT_LOGICS allowed, because Client Logics, being logic from the client, can safely support Client Components.
     // USE_CLIENT_COMPONENTS allowed, because Client Components can compose with one another.
-    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logic can run safely on the client just like it can on the server.
+    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logics can run safely on the client just like they can on the server.
     // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can render safely on the client just like they can on the server.
   ],
   [USE_AGNOSTIC_LOGICS]: [
@@ -212,7 +213,7 @@ ${SUGGEST_USE_AGNOSTIC}`,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_LOGICS,
         USE_SERVER_LOGICS
-      )} Server Logic cannot run in both the server and the client. 
+      )} Server Logics cannot run on both the server and the client. 
 ${SUGGEST_USE_AGNOSTIC}`,
     },
     {
@@ -228,14 +229,14 @@ ${SUGGEST_USE_AGNOSTIC}`,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_LOGICS,
         USE_SERVER_FUNCTIONS
-      )} Though Server Functions can be tinkered with on the server and on the client, use cases on both environments are not compatible.`,
+      )} Server Functions can be modified on the server and on the client, but their use cases on both environments are not one-to-one compatible, since they're being addressed as they are on the server and addressed as references on the client.`,
     },
     {
       blockedImport: USE_CLIENT_LOGICS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_LOGICS,
         USE_CLIENT_LOGICS
-      )} Client Logic cannot run in both the server and the client.`,
+      )} Client Logics cannot run on both the server and the client.`,
     },
     {
       blockedImport: USE_CLIENT_COMPONENTS,
@@ -253,7 +254,7 @@ ${SUGGEST_USE_AGNOSTIC}`,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_COMPONENTS,
         USE_SERVER_LOGICS
-      )} Server Logic cannot run in both the server and the client. 
+      )} Server Logics cannot run on both the server and the client. 
 ${SUGGEST_USE_AGNOSTIC}`,
     },
     {
@@ -261,19 +262,19 @@ ${SUGGEST_USE_AGNOSTIC}`,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_COMPONENTS,
         USE_SERVER_COMPONENTS
-      )} Unlike Client Components, Server Components cannot make silos of their own once on the client, and can therefore not be executed from the client. 
+      )} Server Components, unlike Client Components, cannot make silos of their own once on the opposing environment (the client in this case), and therefore cannot be executed from the client, making them unable to execute agnostically from both the server and the client. 
 ${SUGGEST_USE_AGNOSTIC}`,
     },
-    // USE_SERVER_FUNCTIONS allowed, because as Agnostic Components Modules can import Client Components, they are able to pass them Server Functions as props as well.
+    // USE_SERVER_FUNCTIONS allowed, because Server Functions can be passed to Client Components as props when Client Components are also legally imported into Agnostic Components Modules.
     {
       blockedImport: USE_CLIENT_LOGICS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_COMPONENTS,
         USE_CLIENT_LOGICS
-      )} Client Logic cannot run in both the server and the client.`,
+      )} Client Logics cannot run on both the server and the client.`,
     },
     // USE_CLIENT_COMPONENTS allowed, because Client Components can be nested inside Agnostic Components either to wrap some of the tree with client state accessible through child Client Components and pass through Server Components (if still on the Server Tree), or to create client boundaries when the root of the application is planted on the server.
-    // USE_AGNOSTIC_LOGICS allowed, because environment-agnostic logic can safely support Agnostic Components.
+    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logics, being environment-agnostic logic, can safely support Agnostic Components.
     // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can compose with one another.
   ],
 });

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

@@ -20,7 +20,10 @@ import {
   specificViolationMessage,
 } from "../constants/bases.js";
 
-import { resolveImportPath } from "../../../_commons/utilities/helpers.js";
+import {
+  resolveImportPath,
+  highlightFirstLineOfCode,
+} from "../../../_commons/utilities/helpers.js";
 import {
   getDirectiveFromCurrentModule,
   getDirectiveFromImportedModule,
@@ -61,10 +64,7 @@ export const currentFileFlow = (context) => {
     currentFileExtension.endsWith("x")
   ) {
     context.report({
-      loc: {
-        start: { line: 1, column: 0 },
-        end: { line: 1, column: context.sourceCode.lines[0].length },
-      },
+      loc: highlightFirstLineOfCode(context),
       messageId: useServerJSXMessageId,
     });
     return { skip: true };
@@ -91,9 +91,6 @@ export const currentFileFlow = (context) => {
 
 /**
  * The flow that is shared between import and re-export traversals to obtain the import file's effective directive.
- * @param {string} currentDir Directory of the file containing the import (from `path.dirname(context.filename)`).
- * @param {string} importPath The import specifier (e.g., `@/components/Button` or `./utils`).
- * @param {string} cwd Project root (from `context.cwd`). Caveat: only as an assumption currently.
  * @param {Readonly<import('@typescript-eslint/utils').TSESLint.RuleContext<typeof reExportNotSameMessageId | typeof importBreaksEffectiveImportRulesMessageId | typeof useServerJSXMessageId, []>>} 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; importedFileEffectiveDirective: undefined; resolvedImportPath: undefined;} | {skip: undefined; importedFileEffectiveDirective: USE_SERVER_LOGICS | USE_SERVER_COMPONENTS | USE_SERVER_FUNCTIONS | USE_CLIENT_LOGICS | USE_CLIENT_COMPONENTS | USE_AGNOSTIC_LOGICS | USE_AGNOSTIC_COMPONENTS; resolvedImportPath: string;}} Returns either an object with `skip: true` to disregard or one with the non-null `importedFileEffectiveDirective`.
@@ -202,9 +199,9 @@ export const reExportsFlow = (context, node, currentFileEffectiveDirective) => {
       node,
       messageId: reExportNotSameMessageId,
       data: {
-        // currentFileEffectiveDirective
+        // currentFileEffectiveDirective:
         currentFileEffectiveDirective,
-        // importedFileEffectiveDirective
+        // importedFileEffectiveDirective:
         importedFileEffectiveDirective,
       },
     });

package/library/agnostic20/config.js

@@ -9,6 +9,8 @@ import {
 
 /**
  * Makes the agnostic20 config for the use-agnostic ESLint plugin.
+ * @param {import('eslint').ESLint.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) => ({
   [agnostic20ConfigName]: defineConfig([

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

@@ -86,27 +86,29 @@ export const directivesSet = new Set([
 
 /* from the getCommentedDirectiveFromImportedModule utility */
 
+/** @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]} */
 export const directivesArray = Array.from(directivesSet);
 
 /* commentedDirectives_4RawImplementations */
 
-// make all four accepted commented directive implementations
-const makeRawCommentedDirectiveV1of4 = (directive) => `// '${directive}'`;
-const makeRawCommentedDirectiveV2of4 = (directive) => `// "${directive}"`;
-const makeRawCommentedDirectiveV3of4 = (directive) => `/* '${directive}' */`;
-const makeRawCommentedDirectiveV4of4 = (directive) => `/* "${directive}" */`;
+// all formatting styles as an array of [prefix, quote, suffix]
+const commentStyles = [
+  [`// `, `'`, ``], // V1: `// 'directive'`
+  [`// `, `"`, ``], // V2: `// "directive"`
+  [`/* `, `'`, ` */`], // V3: `/* 'directive' */`
+  [`/* `, `"`, ` */`], // V4: `/* "directive" */`
+];
 
 /**
  * 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
- * @returns
+ * @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.
+ * @returns {string[]} The array of formatted commented directives.
  */
-const make4RawImplementations = (directive) => [
-  makeRawCommentedDirectiveV1of4(directive),
-  makeRawCommentedDirectiveV2of4(directive),
-  makeRawCommentedDirectiveV3of4(directive),
-  makeRawCommentedDirectiveV4of4(directive),
-];
+const make4RawImplementations = (directive) =>
+  commentStyles.map(
+    ([prefix, quote, suffix]) =>
+      `${prefix}${quote}${directive}${quote}${suffix}`
+  );
 
 // mapped commented directives to their 4 raw implementations
 export const commentedDirectives_4RawImplementations = Object.freeze({
@@ -152,7 +154,7 @@ export const commentedStrategies_CommentedDirectives = Object.freeze({
  * 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.
- * @returns {string} Returns "[Current file commented modules] are not allowed to import [imported file commented modules]".
+ * @returns {string} Returns "[Current file commented modules] are not allowed to import [imported file commented modules]."
  */
 const makeIntroForSpecificViolationMessage = (
   currentFileCommentedDirective,
@@ -166,33 +168,33 @@ const makeIntroForSpecificViolationMessage = (
 
 export const commentedDirectives_BlockedImports = Object.freeze({
   [USE_SERVER_LOGICS]: [
-    // USE_SERVER_LOGICS allowed, because Server Logics can compose with one another.
+    // USE_SERVER_LOGICS allowed, because Prime Server Logics can compose with one another.
     {
       blockedImport: USE_CLIENT_LOGICS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_LOGICS,
         USE_CLIENT_LOGICS
-      )} Client logic should never leak to the server.`,
+      )} Prime Client Logics should never leak to the server.`,
     },
-    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logic can run safely on the server just like it can on the client.
-    // USE_SERVER_COMPONENTS allowed, because Server Components are OK to be composed with Server Logics as long as the Server Logics Module, by convention, does not export React components.
+    // USE_AGNOSTIC_LOGICS allowed, because Prime Agnostic Logics can run safely on the server just like they can on the client.
+    // USE_SERVER_COMPONENTS allowed, because Lineal Server Components are OK to be composed with Prime Server Logics as long as the Prime Server Logics Module, by convention, does not export React components.
     {
       blockedImport: USE_CLIENT_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_LOGICS,
         USE_CLIENT_COMPONENTS
-      )} Client Components cannot be tinkered with on the server.`,
+      )} Lineal Client Components, like any Client Components, cannot be tinkered with on the server.`,
     },
-    // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can be composed with Logics on the server just like they can on the client, again, as long at the Server Logics Module, by convention, does not export React components.
-    // USE_SERVER_FUNCTIONS allowed, because as Server Functions can import one another, it is only natural that they could compose through Server Logics.
+    // USE_AGNOSTIC_COMPONENTS allowed, because Lineal Agnostic Components can be composed with any Prime Environment Logics agnostically as long as the Prime Environment Logics Module, by convention, does not export React components.
+    // USE_SERVER_FUNCTIONS allowed, because (Special) Server Functions, being able to import one another, can compose and do so via Prime Server Logics, despite this method seeming superfluous at first glance. (Perhaps a preferrable use case for this has been found or could be found either today or in the future.)
     {
       blockedImport: USE_CLIENT_CONTEXTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_LOGICS,
         USE_CLIENT_CONTEXTS
-      )} Client Components cannot be tinkered with on the server, including Client Contexts Components.`,
+      )} (Special) Client Contexts Components, like any Client Components, cannot be tinkered with on the server.`,
     },
-    // USE_AGNOSTIC_CONDITIONS allowed, because though it would make sense to import their own `ComponentForServer` instead, Agnostic Conditions Components are still able to safely render on the server, guaranteeing that only their `ComponentForServer` will be effectively involved in Server Logics Modules.
+    // USE_AGNOSTIC_CONDITIONS allowed, because (Special) Agnostic Conditions Components are able to safely render on the server, guaranteeing that only their `ComponentForServer` will be effectively involved in Prime Server Logics Modules.
   ],
   [USE_CLIENT_LOGICS]: [
     {
@@ -200,22 +202,22 @@ export const commentedDirectives_BlockedImports = Object.freeze({
       message: `${makeIntroForSpecificViolationMessage(
         USE_CLIENT_LOGICS,
         USE_SERVER_LOGICS
-      )} Server logic should never leak to the client.`,
+      )} Prime Server Logics should never leak to the client.`,
     },
-    // USE_CLIENT_LOGICS allowed, because Client Logics can compose with one another.
-    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logic can run safely on the client just like it can on the server.
+    // USE_CLIENT_LOGICS allowed, because Prime Client Logics can compose with one another.
+    // USE_AGNOSTIC_LOGICS allowed, because Prime Agnostic Logics can run safely on the client just like they can on the server.
     {
       blockedImport: USE_SERVER_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_CLIENT_LOGICS,
         USE_SERVER_COMPONENTS
-      )} Server Components cannot be thinkered with on the client.`,
+      )} Lineal Server Components cannot be thinkered with on the client.`,
     },
-    // USE_CLIENT_COMPONENTS allowed, because Client Components are OK to be composed with Client Logics as long as the Client Logics Module, by convention, does not export React components.
-    // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can be composed with Logics on the client just like they can on the server, again, as long at the Client Logics Module, by convention, does not export React components.
-    // USE_SERVER_FUNCTIONS allowed, because it is technically feasible to tinker with a Client Component within a Client Logics Module and attach to said Client Component a Server Function to be triggered on the client.
-    // USE_CLIENT_CONTEXTS allowed, because Client Components are OK to be composed with Client Logics as long as the Client Logics Module, by convention, does not export React components, including Client Contexts Components.
-    // USE_AGNOSTIC_CONDITIONS allowed, because though it would make sense to import their own `ComponentForClient` instead, Agnostic Conditions Components are still able to safely render on the client, guaranteeing that only their `ComponentForClient` will be effectively involved in Client Logics Modules.
+    // USE_CLIENT_COMPONENTS allowed, because Lineal Client Components, like any Client Components, are OK to be composed with Prime Client Logics as long as the Prime Client Logics Module, by convention, does not export React components.
+    // USE_AGNOSTIC_COMPONENTS allowed, because Lineal Agnostic Components can be composed with any Prime Environment Logics agnostically as long as the Prime Environment Logics Module, by convention, does not export React components.
+    // USE_SERVER_FUNCTIONS allowed, because (Special) Server Functions can technically be attached to Client Components that are being tinkered with within Client Logics Modules.
+    // USE_CLIENT_CONTEXTS allowed, because (Special) Client Contexts Components, like any Client Components, are OK to be composed with Prime Client Logics as long as the Prime Client Logics Module, by convention, does not export React components.
+    // USE_AGNOSTIC_CONDITIONS allowed, because (Special) Agnostic Conditions Components are able to safely render on the client, guaranteeing that only their `ComponentForClient` will be effectively involved in Prime Client Logics Modules.
   ],
   [USE_AGNOSTIC_LOGICS]: [
     {
@@ -223,63 +225,63 @@ export const commentedDirectives_BlockedImports = Object.freeze({
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_LOGICS,
         USE_SERVER_LOGICS
-      )} Server Logic cannot run in both the server and the client.`,
+      )} Prime Server Logics cannot run on both the server and the client.`,
     },
     {
       blockedImport: USE_CLIENT_LOGICS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_LOGICS,
         USE_CLIENT_LOGICS
-      )} Client Logic cannot run in both the server and the client.`,
+      )} Prime Client Logics cannot run on both the server and the client.`,
     },
-    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logics can compose with one another.
+    // USE_AGNOSTIC_LOGICS allowed, because Prime Agnostic Logics can compose with one another.
     {
       blockedImport: USE_SERVER_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_LOGICS,
         USE_SERVER_COMPONENTS
-      )} Server Components cannot be tinkered with on both the server and the client.`,
+      )} Lineal Server Components cannot be tinkered with on both the server and the client.`,
     },
     {
       blockedImport: USE_CLIENT_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_LOGICS,
         USE_CLIENT_COMPONENTS
-      )} Client Components cannot be tinkered with on both the server and the client.`,
+      )} Lineal Client Components, like any Client Components, cannot be tinkered with on both the server and the client.`,
     },
-    // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can be composed with Logics agnostically as long as the Agnostic Logics Module, by convention, does not export React components.
+    // USE_AGNOSTIC_COMPONENTS allowed, because Lineal Agnostic Components can be composed with any Prime Environment Logics agnostically as long as the Prime Environment Logics Module, by convention, does not export React components.
     {
       blockedImport: USE_SERVER_FUNCTIONS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_LOGICS,
         USE_SERVER_FUNCTIONS
-      )} Though Server Functions can be tinkered with on the server and on the client, use cases on both environments are not compatible.`,
+      )} (Special) Server Functions can be modified on the server and on the client, but their use cases on both environments are not one-to-one compatible, since they're being addressed as they are on the server and addressed as references on the client.`,
     },
     {
       blockedImport: USE_CLIENT_CONTEXTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_LOGICS,
         USE_CLIENT_CONTEXTS
-      )} Client Components cannot be tinkered with on both the server and the client, including Client Contexts Components.`,
+      )} (Special) Client Contexts Components, like any Client Components, cannot be tinkered with on both the server and the client.`,
     },
-    // USE_AGNOSTIC_CONDITIONS allowed, because Agnostic Components can be composed with Logics agnostically as long as the Agnostic Logics Module, by convention, does not export React components, including Agnostic Conditions Components.
+    // USE_AGNOSTIC_CONDITIONS allowed, because (Special) Agnostic Conditions Components, as if they were Lineal Agnostic Components themselves, can be composed with any Prime Environment Logics agnostically as long as the Prime Environment Logics Module, by convention, does not export React components.
   ],
   [USE_SERVER_COMPONENTS]: [
-    // USE_SERVER_LOGICS allowed, because logic from the server can safely support Server Components.
+    // USE_SERVER_LOGICS allowed, because Prime Server Logics, being logic from the server, can safely support Lineal Server Components.
     {
       blockedImport: USE_CLIENT_LOGICS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_COMPONENTS,
         USE_CLIENT_LOGICS
-      )} Client logic should never leak to the server.`,
+      )} Prime Client Logics should never leak to the server.`,
     },
-    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logic can run safely on the server just like it can on the client.
-    // USE_SERVER_COMPONENTS allowed, because Server Components can compose with one another, now that thanks to the inclusion of Agnostic Components they are actual Server Components.
-    // USE_CLIENT_COMPONENTS allowed, because Client Components (Lineal Client Components) can be nested inside Server Components to create client boundaries when the root of the application is planted on the server.
-    // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can render safely on the server just like they can on the client.
-    // USE_SERVER_FUNCTIONS allowed, because as Server Components Modules can import Client Components, they are able to pass them Server Functions as props as well, even though indeed Server Components Modules can make their own Server Functions through inline 'use server' directives.
-    // USE_CLIENT_CONTEXTS allowed, because Client Components (Client Contexts Components) can be nested inside Server Components to wrap some of the tree with client state accessible through child Client Components and pass through Server Components when the root of the application is planted on the server.
-    // USE_AGNOSTIC_CONDITIONS allowed, because Agnostic Components can render safely on the server just like they can on the client, including Agnostic Conditions Components.
+    // USE_AGNOSTIC_LOGICS allowed, because Prime Agnostic Logics can run safely on the server just like they can on the client.
+    // USE_SERVER_COMPONENTS allowed, because Lineal Server Components can compose with one another, now that thanks to the inclusion of Agnostic Components they are actual Server Components.
+    // USE_CLIENT_COMPONENTS allowed, because Lineal Client Components can be nested inside Server Components to create client boundaries when the root of the application is planted on the server.
+    // USE_AGNOSTIC_COMPONENTS allowed, because Lineal Agnostic Components can render safely on the server just like they can on the client.
+    // USE_SERVER_FUNCTIONS allowed, because (Special) Server Functions can be passed to imported Client Components within Lineal Server Components Modules, even though indeed Lineal Server Components Modules and Lineal Server Components can make their own Server Functions through inline 'use server' directives.
+    // USE_CLIENT_CONTEXTS allowed, because (Special) Client Contexts Components can be nested inside Server Components to wrap some of the tree with client state accessible through child Client Components, and to pass through Server Components when the root of the application is planted on the server.
+    // USE_AGNOSTIC_CONDITIONS allowed, because (Special) Agnostic Conditions Components, as if they were Lineal Agnostic Components themselves, can render safely on the server just like they can on the client.
   ],
   [USE_CLIENT_COMPONENTS]: [
     {
@@ -287,22 +289,22 @@ export const commentedDirectives_BlockedImports = Object.freeze({
       message: `${makeIntroForSpecificViolationMessage(
         USE_CLIENT_COMPONENTS,
         USE_SERVER_LOGICS
-      )} Server logic should never leak to the client.`,
+      )} Prime Server Logics should never leak to the client.`,
     },
-    // USE_CLIENT_LOGICS allowed, because logic from the client can safely support Client Components.
-    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logic can run safely on the client just like it can on the server.
+    // USE_CLIENT_LOGICS allowed, because Prime Client Logics, being logic from the client, can safely support Lineal Client Components, like any Client Components.
+    // USE_AGNOSTIC_LOGICS allowed, because Prime Agnostic Logics can run safely on the client just like they can on the server.
     {
       blockedImport: USE_SERVER_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_CLIENT_COMPONENTS,
         USE_SERVER_COMPONENTS
-      )} Server Components cannot be the children of Lineal Client Components.`,
+      )} Lineal Server Components cannot be the children of Lineal Client Components.`,
     },
-    // USE_CLIENT_COMPONENTS allowed, because Client Components can compose with one another.
-    // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can render safely on the client just like they can on the server.
-    // USE_SERVER_FUNCTIONS allowed, because Server Functions are specifically triggered by Client Components.
-    // USE_CLIENT_CONTEXTS allowed, because that mechanism allows Client Contexts Components to effectively become Lineal and only render their children on the client since they would be the grand-children of a grand-parent Lineal Client Component.
-    // USE_AGNOSTIC_CONDITIONS allowed, because Agnostic Components can render safely on the client just like they can on the server, including Agnostic Conditions Components.
+    // USE_CLIENT_COMPONENTS allowed, because Lineal Client Components can compose with one another.
+    // USE_AGNOSTIC_COMPONENTS allowed, because Lineal Agnostic Components can render safely on the client just like they can on the server.
+    // USE_SERVER_FUNCTIONS allowed, because (Special) Server Functions are specifically triggered by Client Components.
+    // USE_CLIENT_CONTEXTS allowed, because (Special) Client Contexts Components can effectively become Lineal and only render their children on the client via this mechanism since, by a Client Contexts Component being the child of a Lineal Client Component, the Client Contexts Component's children become the grand-children of an ancestor Lineal Client Component, enforcing them to render exclusively on the client.
+    // USE_AGNOSTIC_CONDITIONS allowed, because (Special) Agnostic Conditions Components, as if they were Lineal Agnostic Components themselves, can render safely on the client just like they can on the server.
   ],
   [USE_AGNOSTIC_COMPONENTS]: [
     {
@@ -310,74 +312,74 @@ export const commentedDirectives_BlockedImports = Object.freeze({
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_COMPONENTS,
         USE_SERVER_LOGICS
-      )} Server Logic cannot run in both the server and the client.`,
+      )} Prime Server Logics cannot run on both the server and the client.`,
     },
     {
       blockedImport: USE_CLIENT_LOGICS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_COMPONENTS,
         USE_CLIENT_LOGICS
-      )} Client Logic cannot run in both the server and the client.`,
+      )} Prime Client Logics cannot run on both the server and the client.`,
     },
-    // USE_AGNOSTIC_LOGICS allowed, because environment-agnostic logic can safely support Agnostic Components.
+    // USE_AGNOSTIC_LOGICS allowed, because Prime Agnostic Logics, being environment-agnostic logic, can safely support Agnostic Components.
     {
       blockedImport: USE_SERVER_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_COMPONENTS,
         USE_SERVER_COMPONENTS
-      )} Unlike Client Components, Server Components cannot make silos of their own once on the client, and can therefore not be executed from the client.`,
+      )} Lineal Server Components, unlike Lineal Client Components, cannot make silos of their own once on the opposing environment (the client in this case), and therefore cannot be executed from the client, making them unable to execute agnostically from both the server and the client.`,
     },
-    // USE_CLIENT_COMPONENTS allowed, because Client Components (Lineal Client Components) can be nested inside Agnostic Components to create client boundaries when the root of the application is planted on the server.
-    // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can compose with one another.
-    // USE_SERVER_FUNCTIONS allowed, because as Agnostic Components Modules can import Client Components, they are able to pass them Server Functions as props as well.
-    // USE_CLIENT_CONTEXTS allowed, because Client Components (Client Contexts Components) can be nested inside Agnostic Components to wrap some of the tree with client state accessible through child Client Components and pass through Server Components (if still on the Server Tree) when the root of the application is planted on the server.
-    // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can compose with one another, including with Agnostic Conditions Components, making this a necessary mechanism for Server Components to be nested in Agnostic Components.
+    // USE_CLIENT_COMPONENTS allowed, because Lineal Client Components can be nested inside Agnostic Components to create client boundaries when the root of the application is planted on the server.
+    // USE_AGNOSTIC_COMPONENTS allowed, because Lineal Agnostic Components, can compose with one another.
+    // USE_SERVER_FUNCTIONS allowed, because (Special) Server Functions can be passed to Client Components as props when Client Components are also legally imported into Agnostic Components Modules.
+    // USE_CLIENT_CONTEXTS allowed, because (Special) Client Contexts Components can be nested inside Agnostic Components to wrap some of the tree with client state accessible through child Client Components, and to pass through Server Components (if still on the Server Tree) when the root of the application is planted on the server.
+    // USE_AGNOSTIC_CONDITIONS allowed, because (Special) Agnostic Conditions Components can compose with Lineal Agnostic Components as if they were Lineal Agnostic Components themselves, making them a necessary mechanism for Server Components to be nested in Agnostic Components.
   ],
   [USE_SERVER_FUNCTIONS]: [
-    // USE_SERVER_LOGICS allowed, because logic from the server can safely support Server Functions.
+    // USE_SERVER_LOGICS allowed, because Prime Server Logics, being logic from the server, can safely support (Special) Server Functions.
     {
       blockedImport: USE_CLIENT_LOGICS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_FUNCTIONS,
         USE_CLIENT_LOGICS
-      )} Client logic should never leak to the server.`,
+      )} Prime Client Logics should never leak to the server.`,
     },
-    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logic can run safely on the server just like it can on the client.
+    // USE_AGNOSTIC_LOGICS allowed, because Prime Agnostic Logics can run safely on the server just like they can on the client.
     {
       blockedImport: USE_SERVER_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_FUNCTIONS,
         USE_SERVER_COMPONENTS
-      )} Server Functions have no business working with React Components.`,
+      )} Lineal Server Components aren't allowed because (Special) Server Functions have no business working with React Components.`,
     },
     {
       blockedImport: USE_CLIENT_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_FUNCTIONS,
         USE_CLIENT_COMPONENTS
-      )} Server Functions have no business working with React Components.`,
+      )} Lineal Client Components aren't allowed because (Special) Server Functions have no business working with React Components.`,
     },
     {
       blockedImport: USE_AGNOSTIC_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_FUNCTIONS,
         USE_AGNOSTIC_COMPONENTS
-      )} Server Functions have no business working with React Components.`,
+      )} Lineal Agnostic Components aren't allowed because (Special) Server Functions have no business working with React Components.`,
     },
-    // USE_SERVER_FUNCTIONS allowed, because even though Server Functions don't need to import one another and the same results can be generated via Server Logic alone for the outcome of a single Server Function, a rational use case could be found for composing Server Functions with one another either today or in the future.
+    // USE_SERVER_FUNCTIONS allowed, because (Special) Server Functions, even though they don't need to import one another and the same results can be generated via Prime Server Logics for the outcome of a single Server Function, can still compose with one another. (Perhaps a preferrable use case for this has been found or could be found either today or in the future.)
     {
       blockedImport: USE_CLIENT_CONTEXTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_FUNCTIONS,
         USE_CLIENT_CONTEXTS
-      )} Server Functions have no business working with React Components.`,
+      )} (Special) Client Contexts Components aren't allowed because (Special) Server Functions have no business working with React Components.`,
     },
     {
       blockedImport: USE_AGNOSTIC_CONDITIONS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_SERVER_FUNCTIONS,
         USE_AGNOSTIC_CONDITIONS
-      )} Server Functions have no business working with React Components.`,
+      )} (Special) Agnostic Conditions Components aren't allowed (Special)because Server Functions have no business working with React Components.`,
     },
   ],
   [USE_CLIENT_CONTEXTS]: [
@@ -386,22 +388,22 @@ export const commentedDirectives_BlockedImports = Object.freeze({
       message: `${makeIntroForSpecificViolationMessage(
         USE_CLIENT_CONTEXTS,
         USE_SERVER_LOGICS
-      )} Server logic should never leak to the client.`,
+      )} Prime Server Logics should never leak to the client.`,
     },
-    // USE_CLIENT_LOGICS allowed, because logic from the client can safely support Client Components, including Client Contexts Components.
-    // USE_AGNOSTIC_LOGICS allowed, because Agnostic Logic can run safely on the client just like it can on the server.
+    // USE_CLIENT_LOGICS allowed, because Prime Client Logics, being logic from the client, can safely support (Special) Client Contexts Components, like any Client Components.
+    // USE_AGNOSTIC_LOGICS allowed, because Prime Agnostic Logics can run safely on the client just like they can on the server.
     {
       blockedImport: USE_SERVER_COMPONENTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_CLIENT_CONTEXTS,
         USE_SERVER_COMPONENTS
-      )} Server Components may only pass through Client Contexts Components through the children prop within Server Components Modules.`,
+      )} Lineal Server Components may only pass through Client Contexts Components via the children prop within Server Components Modules.`,
     },
-    // USE_CLIENT_COMPONENTS allowed, because Lineal Client Components can create client boundaries within Client Contexts Components.
-    // USE_AGNOSTIC_COMPONENTS allowed, because Agnostic Components can render safely on the client just like they can on the server.
-    // USE_SERVER_FUNCTIONS allowed, because Server Functions are specifically triggered by Client Components, including Client Contexts Components.
-    // USE_CLIENT_CONTEXTS allowed, because Client Contexts Components can compose with one another.
-    // USE_AGNOSTIC_CONDITIONS allowed, because Agnostic Components can render safely on the client just like they can on the server, including Agnostic Conditions Components, in a mechanism that allows Client Contexts Components to indirectly compose with child Server Components within Client Contexts Modules.
+    // USE_CLIENT_COMPONENTS allowed, because Lineal Client Components can create client boundaries within (Special) Client Contexts Components.
+    // USE_AGNOSTIC_COMPONENTS allowed, because Lineal Agnostic Components can render safely on the client just like they can on the server.
+    // USE_SERVER_FUNCTIONS allowed, because (Special) Server Functions are specifically triggered by Client Components.
+    // USE_CLIENT_CONTEXTS allowed, because (Special) Client Contexts Components can compose with one another.
+    // USE_AGNOSTIC_CONDITIONS allowed, because (Special) Agnostic Conditions Components, as if they were Lineal Agnostic Components themselves, can render safely on the client just like they can on the server, in a mechanism that allows Client Contexts Components to safely and indirectly compose with child Server Components within Client Contexts Modules.
   ],
   [USE_AGNOSTIC_CONDITIONS]: [
     {
@@ -409,52 +411,58 @@ export const commentedDirectives_BlockedImports = Object.freeze({
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_CONDITIONS,
         USE_SERVER_LOGICS
-      )} Server Logic cannot run in both the server and the client.`,
+      )} Prime Server Logics cannot run on both the server and the client.`,
     },
     {
       blockedImport: USE_CLIENT_LOGICS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_CONDITIONS,
         USE_CLIENT_LOGICS
-      )} Client Logic cannot run in both the server and the client.`,
+      )} Prime Client Logics cannot run on both the server and the client.`,
     },
-    // USE_AGNOSTIC_LOGICS allowed, because environment-agnostic logic can safely support Agnostic Components, including Agnostic Conditions Components. (In this case this is necessary for the import of the conditionAgnosticComponent function needed to make Agnostic Conditions Components.)
-    // USE_SERVER_COMPONENTS allowed, because they are to be paired with `ComponentForClient` components to form Agnostic Conditions Components.
-    // USE_CLIENT_COMPONENTS allowed, because they are to be paired with `ComponentForServer` components to form Agnostic Conditions Components.
-    // USE_AGNOSTIC_COMPONENTS allowed, because they can take the place of `ComponentForServer` and/or `ComponentForClient` components to form Agnostic Conditions Components.
+    // USE_AGNOSTIC_LOGICS allowed, because Prime Agnostic Logics, being environment-agnostic logic, can safely support Agnostic Components, including (Special) Agnostic Conditions Components. (In this case this is necessary for the import of the `conditionAgnosticComponent` function needed to make Agnostic Conditions Components.)
+    // USE_SERVER_COMPONENTS allowed, because Lineal Server Components are to be paired as `ComponentForServer` components with `ComponentForClient` components to form (Special) Agnostic Conditions Components.
+    // USE_CLIENT_COMPONENTS allowed, because Lineal Client Components are to be paired as `ComponentForClient` components with `ComponentForServer` components to form (Special) Agnostic Conditions Components.
+    // USE_AGNOSTIC_COMPONENTS allowed, because Lineal Agnostic Components can take the place of `ComponentForServer` and/or `ComponentForClient` components to form (Special) Agnostic Conditions Components.
     {
       blockedImport: USE_SERVER_FUNCTIONS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_CONDITIONS,
         USE_SERVER_FUNCTIONS
-      )} Agnostic Conditions Components only take finite, imported components as arguments in their making. As such, assigning props to these components, including Server Functions, is not made within Agnostic Conditions Modules.`,
+      )} (Special) Server Functions are not accepted because (Special) Agnostic Conditions Components only take finite, imported components as arguments in their making. As such, assigning props to these components, including Server Functions, is not made within Agnostic Conditions Modules.`,
     },
     {
       blockedImport: USE_CLIENT_CONTEXTS,
       message: `${makeIntroForSpecificViolationMessage(
         USE_AGNOSTIC_CONDITIONS,
         USE_CLIENT_CONTEXTS
-      )} Agnostic Conditions Components only take Lineal Components as arguments in their making.`,
+      )} (Special) Client Contexts Components cannot be used as component arguments for (Special) Agnostic Conditions Components since they only take Lineal Components as arguments in their making.`,
     },
-    // USE_AGNOSTIC_CONDITIONS allowed, because despite not being Lineal Components themselves, their output components can only be Lineal and compatible with their attributed rendering environments, making them acceptable arguments in the making of Agnostic Conditions Components.
+    // USE_AGNOSTIC_CONDITIONS allowed, because (Special) Agnostic Conditions Components, despite not being Lineal Components themselves, output components that can only be Lineal and compatible with their attributed rendering environments, making them acceptable arguments in the making of Agnostic Conditions Components.
   ],
   [USE_AGNOSTIC_STRATEGIES]: [
-    // Agnostic Strategies Modules can import all known modules, except themselves since they cannot be imported as they are, only as and via Strategies. (Since Agnostic Strategies Modules cannot be imported as they are, there is no such things as a 'use agnostic strategies' importFileCommentedDirective.)
+    // (Special) Agnostic Strategies Modules can import all known modules, except themselves since they cannot be imported as they are, only as and via Strategies. (Since Agnostic Strategies Modules cannot be imported as they are, there is no such things as a 'use agnostic strategies' importFileCommentedDirective.)
   ],
 });
 
 /* from the currentFileFlow flow */
 
+const MODULES_MARKED_WITH_THE_ = "modules marked with the";
+const _DIRECTIVE_MUST_HAVE_A_NON_JSX_FILE_EXTENSION =
+  "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({
-  // somehow doing it by hand is better for type inference
-  [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.`,
-  [USE_AGNOSTIC_LOGICS]: `modules marked with the "${USE_AGNOSTIC_LOGICS}" directive must have a non-JSX file extension.`,
-  [USE_SERVER_COMPONENTS]: `modules marked with the "${USE_SERVER_COMPONENTS}" directive must have a JSX file extension.`,
-  [USE_CLIENT_COMPONENTS]: `modules marked with the "${USE_CLIENT_COMPONENTS}" directive must have a JSX file extension.`,
-  [USE_AGNOSTIC_COMPONENTS]: `modules marked with the "${USE_AGNOSTIC_COMPONENTS}" directive must have a JSX file extension.`,
-  [USE_SERVER_FUNCTIONS]: `modules marked with the "${USE_SERVER_FUNCTIONS}" directive must have a non-JSX file extension.`,
-  [USE_CLIENT_CONTEXTS]: `modules marked with the "${USE_CLIENT_CONTEXTS}" directive must have a JSX file extension.`,
-  [USE_AGNOSTIC_CONDITIONS]: `modules marked with the "${USE_AGNOSTIC_CONDITIONS}" directive must have a JSX file extension.`,
-  [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.)`,
+  // 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}.`,
+  [USE_AGNOSTIC_LOGICS]: `${MODULES_MARKED_WITH_THE_} "${USE_AGNOSTIC_LOGICS}" ${_DIRECTIVE_MUST_HAVE_A_NON_JSX_FILE_EXTENSION}.`,
+  [USE_SERVER_COMPONENTS]: `${MODULES_MARKED_WITH_THE_} "${USE_SERVER_COMPONENTS}" ${_DIRECTIVE_MUST_HAVE_A_JSX_FILE_EXTENSION}.`,
+  [USE_CLIENT_COMPONENTS]: `${MODULES_MARKED_WITH_THE_} "${USE_CLIENT_COMPONENTS}" ${_DIRECTIVE_MUST_HAVE_A_JSX_FILE_EXTENSION}.`,
+  [USE_AGNOSTIC_COMPONENTS]: `${MODULES_MARKED_WITH_THE_} "${USE_AGNOSTIC_COMPONENTS}" ${_DIRECTIVE_MUST_HAVE_A_JSX_FILE_EXTENSION}.`,
+  [USE_SERVER_FUNCTIONS]: `${MODULES_MARKED_WITH_THE_} "${USE_SERVER_FUNCTIONS}" ${_DIRECTIVE_MUST_HAVE_A_NON_JSX_FILE_EXTENSION}.`,
+  [USE_CLIENT_CONTEXTS]: `${MODULES_MARKED_WITH_THE_} "${USE_CLIENT_CONTEXTS}" ${_DIRECTIVE_MUST_HAVE_A_JSX_FILE_EXTENSION}.`,
+  [USE_AGNOSTIC_CONDITIONS]: `${MODULES_MARKED_WITH_THE_} "${USE_AGNOSTIC_CONDITIONS}" ${_DIRECTIVE_MUST_HAVE_A_JSX_FILE_EXTENSION}.`,
+  [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.)`,
 });

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

@@ -28,7 +28,10 @@ import {
   specificFailure,
 } from "../constants/bases.js";
 
-import { resolveImportPath } from "../../../_commons/utilities/helpers.js";
+import {
+  resolveImportPath,
+  highlightFirstLineOfCode,
+} from "../../../_commons/utilities/helpers.js";
 import {
   getCommentedDirectiveFromCurrentModule,
   getVerifiedCommentedDirective,
@@ -37,6 +40,7 @@ import {
   makeMessageFromCommentedDirective,
   findSpecificViolationMessage,
   getStrategizedDirective,
+  addressDirectiveIfAgnosticStrategies,
 } from "./helpers.js";
 
 /* currentFileFlow */
@@ -67,10 +71,7 @@ export const currentFileFlow = (context) => {
   // reports if there is no directive or no valid directive (same, but eventually no directive could have defaults)
   if (!commentedDirective) {
     context.report({
-      loc: {
-        start: { line: 1, column: 0 },
-        end: { line: 1, column: context.sourceCode.lines[0].length },
-      },
+      loc: highlightFirstLineOfCode(context),
       messageId: noCommentedDirective,
     });
     return { skip: true };
@@ -84,10 +85,7 @@ export const currentFileFlow = (context) => {
   // reports if the verification failed
   if (!verifiedCommentedDirective) {
     context.report({
-      loc: {
-        start: { line: 1, column: 0 },
-        end: { line: 1, column: context.sourceCode.lines[0].length },
-      },
+      loc: highlightFirstLineOfCode(context),
       messageId: commentedDirectiveVerificationFailed,
       data: {
         [specificFailure]:
@@ -139,10 +137,11 @@ const importedFileFlow = (context, node) => {
   }
 
   /* GETTING THE CORRECT DIRECTIVE INTERPRETATION OF STRATEGY FOR AGNOSTIC STRATEGIES MODULES IMPORTS. 
-  (The Directive-First Architecture does not check whether the export and import Strategies are the same at this time, meaning a @clientLogics strategy could be wrongly imported and interpreted as a @serverLogics strategy.
+  (The Directive-First Architecture does not check whether the export and import Strategies are the same at this time, meaning an @clientLogics strategy could be wrongly imported and interpreted as an @serverLogics strategy.
   
-  After a short attempt, this feature is currently cancelled, mainly since the amount of work it will require will not be able to be transferred in a future where commented strategies will actually be real syntax.
+  After a short attempt, this feature is currently canceled, mainly since the amount of work it will require will not be able to be transferred in a future where commented strategies will actually be real syntax.
   
+  // (Consequently, details below are currently at the stage of wishful thinking.)
   However, Strategy exports are planned to be linting in the future within their own Agnostic Strategies Modules to ensure they respect import rules within their own scopes. It may also become possible to check whether the export and import Strategies are the same in the future when identifiers are defined and the same, especially for components modules where a convention could be to for all non-type export to be named and PascalCase.) */
   if (importedFileCommentedDirective === USE_AGNOSTIC_STRATEGIES) {
     const importingFileCommentedDirective = getStrategizedDirective(
@@ -222,27 +221,29 @@ export const allExportsFlow = (
   // does not operate on `export type`
   if (node.exportKind === "type") return;
 
-  if (node.source) {
+  // regular exports scenarios
+  if (!node.source) {
+    addressDirectiveIfAgnosticStrategies(
+      context,
+      node,
+      currentFileCommentedDirective
+    );
+  }
+  // re-exports scenarios
+  else {
     const result = importedFileFlow(context, node);
 
     if (result.skip) return;
     const { importedFileCommentedDirective } = result;
 
-    // ignores if this is NOT an Agnostic Strategies Module
-    // verifies current node export strategy if "use agnostic strategies"
-    if (currentFileCommentedDirective === USE_AGNOSTIC_STRATEGIES) {
-      const exportStrategizedDirective = getStrategizedDirective(context, node);
-
-      if (exportStrategizedDirective === null) {
-        context.report({
-          node,
-          messageId: exportNotStrategized,
-        });
-        return;
-      }
+    const addressedDirective = addressDirectiveIfAgnosticStrategies(
+      context,
+      node,
+      currentFileCommentedDirective
+    );
 
-      currentFileCommentedDirective = exportStrategizedDirective;
-    }
+    if (!addressedDirective) return;
+    else currentFileCommentedDirective = addressedDirective;
 
     if (currentFileCommentedDirective !== importedFileCommentedDirective) {
       context.report({
@@ -255,24 +256,6 @@ export const allExportsFlow = (
           importedFileCommentedDirective,
         },
       });
-      return;
-    }
-  } else {
-    // ignores if this is NOT an Agnostic Strategies Module
-    // verifies current node export strategy if "use agnostic strategies"
-    if (currentFileCommentedDirective === USE_AGNOSTIC_STRATEGIES) {
-      const exportStrategizedDirective = getStrategizedDirective(context, node);
-
-      if (exportStrategizedDirective === null) {
-        context.report({
-          node,
-          messageId: exportNotStrategized,
-        });
-        return;
-      }
-
-      // just to emphasize that this is the same short flow from above
-      currentFileCommentedDirective = exportStrategizedDirective;
     }
   }
 };

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

@@ -190,9 +190,11 @@ export const getCommentedDirectiveFromImportedModule = (resolvedImportPath) => {
   const importedFileFirstLine = getImportedFileFirstLine(resolvedImportPath);
 
   // sees if the first line includes any of the directives and finds the directive that it includes
+  /** @type {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 | ""} */
   let includedDirective = "";
-  const lengthOne = directivesArray.length;
-  for (let i = 0; i < lengthOne; i++) {
+  const firstLength = directivesArray.length;
+
+  for (let i = 0; i < firstLength; i++) {
     const directive = directivesArray[i];
     if (importedFileFirstLine.includes(directive)) {
       includedDirective = directive;
@@ -203,12 +205,14 @@ export const getCommentedDirectiveFromImportedModule = (resolvedImportPath) => {
   // returns null early if there is none of the directives in the first line
   if (includedDirective === "") return null;
 
+  /** @type {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 | ""} */
   let importFileDirective = "";
-  const lengthTwo =
-    // sucks for that any but, I'm working in JS here
-    commentedDirectives_4RawImplementations[includedDirective].length;
-  for (let i = 0; i < lengthTwo; i++) {
-    const raw = commentedDirectives_4RawImplementations[includedDirective][i];
+  const rawImplementations =
+    commentedDirectives_4RawImplementations[includedDirective];
+  const secondLength = rawImplementations.length;
+
+  for (let i = 0; i < secondLength; i++) {
+    const raw = rawImplementations[i];
     if (raw === importedFileFirstLine) {
       importFileDirective = includedDirective;
       break;
@@ -289,3 +293,33 @@ export const findSpecificViolationMessage = (
     currentFileCommentedDirective,
     importedFileCommentedDirective
   );
+
+/* addressDirectiveIfAgnosticStrategies */
+
+/**
+ * Verifies the current node's export strategy if `"use agnostic strategies"` by reporting `exportNotStrategized` in case an export is not strategized in an Agnostic Strategies Module.
+ * @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.
+ * @returns The commented directive, the addressed strategy (as a commented directive) or null in case of failure.
+ */
+export const addressDirectiveIfAgnosticStrategies = (
+  context,
+  node,
+  currentFileCommentedDirective
+) => {
+  // ignores if not addressing an Agnostic Strategies Module
+  if (currentFileCommentedDirective !== USE_AGNOSTIC_STRATEGIES)
+    return currentFileCommentedDirective;
+
+  const exportStrategizedDirective = getStrategizedDirective(context, node);
+
+  if (exportStrategizedDirective === null) {
+    context.report({
+      node,
+      messageId: exportNotStrategized,
+    });
+  }
+
+  return exportStrategizedDirective; // null indicates failure
+};

package/library/directive21/config.js

@@ -9,6 +9,8 @@ import {
 
 /**
  * Makes the directive21 config for the use-agnostic ESLint plugin.
+ * @param {import('eslint').ESLint.Plugin} plugin The use-agnostic ESLint plugin itself.
+ * @returns The directive21 config's name as a key and its config as its value.
  */
 export const makeDirective21Config = (plugin) => ({
   [directive21ConfigName]: defineConfig([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-use-agnostic",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Highlights problematic server-client imports in projects made with the Fullstack React Architecture.",
   "keywords": [
     "eslint",