eslint-plugin-use-agnostic 1.2.2 → 1.3.0

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

@@ -31,9 +31,9 @@ import {
 /* getCommentedDirectiveFromSourceCode */
 
 /**
- * Detects whether a string is single- or double-quoted.
- * @param {string} string The original string.
- * @returns `true` if single-quoted, `false` if double-quoted, `null` if neither.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#DETECTQUOTETYPE
+ * @param {string} string $COMMENT#JSDOC#PARAMS#DIRECTIVE21#STRING
+ * @returns $COMMENT#JSDOC#RETURNS#DIRECTIVE21#DETECTQUOTETYPE
  */
 const detectQuoteType = (string) => {
   if (string.startsWith("'") && string.endsWith("'")) {
@@ -46,9 +46,9 @@ const detectQuoteType = (string) => {
 };
 
 /**
- * Removes single quotes from a string known to be single-quoted.
- * @param {string} string The original string.
- * @returns The string with quotes removed.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#STRIPSINGLEQUOTES
+ * @param {string} string $COMMENT#JSDOC#PARAMS#DIRECTIVE21#STRING
+ * @returns $COMMENT#JSDOC#RETURNS#DIRECTIVE21#STRIPSINGLEQUOTES
  */
 const stripSingleQuotes = (string) => {
   if (string.startsWith("'") && string.endsWith("'")) {
@@ -58,9 +58,9 @@ const stripSingleQuotes = (string) => {
 };
 
 /**
- * Removes double quotes from a string known to be double-quoted.
- * @param {string} string The original string.
- * @returns The string with quotes removed.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#STRIPDOUBLEQUOTES
+ * @param {string} string $COMMENT#JSDOC#PARAMS#DIRECTIVE21#STRING
+ * @returns $COMMENT#JSDOC#RETURNS#DIRECTIVE21#STRIPSINGLEQUOTES
  */
 const stripDoubleQuotes = (string) => {
   if (string.startsWith('"') && string.endsWith('"')) {
@@ -70,21 +70,21 @@ const stripDoubleQuotes = (string) => {
 };
 
 /**
- * Gets the commented directive of a module from its ESLint SourceCode object.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#GETCOMMENTEDDIRECTIVEFROMSOURCECODE1
  *
- * Accepted directives for the default Directive-First Architecture are (single or double quotes included):
- * - `'use server logics'`, `"use server logics"` denoting a Server Logics Module.
- * - `'use client logics'`, `"use client logics"` denoting a Client Logics Module.
- * - `'use agnostic logics'`, `"use agnostic logics"` denoting an Agnostic Logics Module.
- * - `'use server components'`, `"use server components"` denoting a Server Components Module.
- * - `'use client components'`, `"use client components"` denoting a Client Components Module.
- * - `'use agnostic components'`, `"use agnostic components"` denoting an Agnostic Components Module.
- * - `'use server functions'`, `"use server functions"` denoting a Server Functions Module.
- * - `'use client contexts'`, `"use client contexts"` denoting a Client Contexts Module.
- * - `'use agnostic conditions'`, `"use agnostic conditions"` denoting an Agnostic Conditions Module.
- * - `'use agnostic strategies'`, `"use agnostic strategies"` denoting an Agnostic Strategies Module.
- * @param {SourceCode} sourceCode The ESLint SourceCode object.
- * @returns The commented directive, or lack thereof via `null`. Given the strictness of this architecture, the lack of a directive is considered a mistake. (Though rules may provide the opportunity to declare a default, and configs with preset defaults may become provided.)
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#GETCOMMENTEDDIRECTIVEFROMSOURCECODE2
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USESERVERLOGICSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USECLIENTLOGICSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICLOGICSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USESERVERCOMPONENTSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USECLIENTCOMPONENTSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICCOMPONENTSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USESERVERFUNCTIONSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USECLIENTCONTEXTSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICCONDITIONSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICSTRATEGIESA
+ * @param {SourceCode} sourceCode $COMMENT#JSDOC#PARAMS#DIRECTIVE21#SOURCECODE
+ * @returns $COMMENT#JSDOC#RETURNS#DIRECTIVE21#GETCOMMENTEDDIRECTIVEFROMSOURCECODE
  */
 export const getCommentedDirectiveFromSourceCode = (sourceCode) => {
   // gets the first comment from the source code
@@ -128,21 +128,21 @@ export const getCommentedDirectiveFromSourceCode = (sourceCode) => {
 /* getCommentedDirectiveFromCurrentModule */
 
 /**
- * Gets the commented directive of the current module.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#GETCOMMENTEDDIRECTIVEFROMCURRENTMODULE1
  *
- * Accepted directives for the default Directive-First Architecture are (single or double quotes included):
- * - `'use server logics'`, `"use server logics"` denoting a Server Logics Module.
- * - `'use client logics'`, `"use client logics"` denoting a Client Logics Module.
- * - `'use agnostic logics'`, `"use agnostic logics"` denoting an Agnostic Logics Module.
- * - `'use server components'`, `"use server components"` denoting a Server Components Module.
- * - `'use client components'`, `"use client components"` denoting a Client Components Module.
- * - `'use agnostic components'`, `"use agnostic components"` denoting an Agnostic Components Module.
- * - `'use server functions'`, `"use server functions"` denoting a Server Functions Module.
- * - `'use client contexts'`, `"use client contexts"` denoting a Client Contexts Module.
- * - `'use agnostic conditions'`, `"use agnostic conditions"` denoting an Agnostic Conditions Module.
- * - `'use agnostic strategies'`, `"use agnostic strategies"` denoting an Agnostic Strategies Module.
- * @param {Context} context The ESLint rule's `context` object.
- * @returns The commented directive, or lack thereof via `null`. Given the strictness of this architecture, the lack of a directive is considered a mistake. (Though rules may provide the opportunity to declare a default, and configs with preset defaults may become provided.)
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#GETCOMMENTEDDIRECTIVEFROMSOURCECODE2
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USESERVERLOGICSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USECLIENTLOGICSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICLOGICSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USESERVERCOMPONENTSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USECLIENTCOMPONENTSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICCOMPONENTSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USESERVERFUNCTIONSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USECLIENTCONTEXTSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICCONDITIONSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICSTRATEGIESA
+ * @param {Context} context $COMMENT#JSDOC#PARAMS#CONTEXTB
+ * @returns $COMMENT#JSDOC#RETURNS#DIRECTIVE21#GETCOMMENTEDDIRECTIVEFROMSOURCECODE
  */
 export const getCommentedDirectiveFromCurrentModule = (context) => {
   const sourceCode = context.sourceCode;
@@ -154,21 +154,21 @@ export const getCommentedDirectiveFromCurrentModule = (context) => {
 /* getCommentedDirectiveFromImportedModule */
 
 /**
- * Gets the commented directive of the imported module.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#GETCOMMENTEDDIRECTIVEFROMIMPORTEDMODULE1
  *
- * Accepted directives for the default Directive-First Architecture are (single or double quotes included):
- * - `'use server logics'`, `"use server logics"` denoting a Server Logics Module.
- * - `'use client logics'`, `"use client logics"` denoting a Client Logics Module.
- * - `'use agnostic logics'`, `"use agnostic logics"` denoting an Agnostic Logics Module.
- * - `'use server components'`, `"use server components"` denoting a Server Components Module.
- * - `'use client components'`, `"use client components"` denoting a Client Components Module.
- * - `'use agnostic components'`, `"use agnostic components"` denoting an Agnostic Components Module.
- * - `'use server functions'`, `"use server functions"` denoting a Server Functions Module.
- * - `'use client contexts'`, `"use client contexts"` denoting a Client Contexts Module.
- * - `'use agnostic conditions'`, `"use agnostic conditions"` denoting an Agnostic Conditions Module.
- * - `'use agnostic strategies'`, `"use agnostic strategies"` denoting an Agnostic Strategies Module.
- * @param {string} resolvedPath The resolved path of the imported module.
- * @returns The commented directive, or lack thereof via `null`. Given the strictness of this architecture, the lack of a directive is considered a mistake. (Though rules may provide the opportunity to declare a default, and configs with preset defaults may become provided.)
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#GETCOMMENTEDDIRECTIVEFROMSOURCECODE2
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USESERVERLOGICSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USECLIENTLOGICSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICLOGICSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USESERVERCOMPONENTSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USECLIENTCOMPONENTSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICCOMPONENTSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USESERVERFUNCTIONSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USECLIENTCONTEXTSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICCONDITIONSA
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICSTRATEGIESA
+ * @param {string} resolvedPath $COMMENT#JSDOC#PARAMS#RESOLVEDPATH
+ * @returns $COMMENT#JSDOC#RETURNS#DIRECTIVE21#GETCOMMENTEDDIRECTIVEFROMSOURCECODE
  */
 export const getCommentedDirectiveFromImportedModule = (resolvedPath) => {
   const sourceCode = getSourceCodeFromFilePath(resolvedPath);
@@ -180,20 +180,20 @@ export const getCommentedDirectiveFromImportedModule = (resolvedPath) => {
 /* getVerifiedCommentedDirective */
 
 /**
- * Ensures that a module's commented directive is consistent with its file extension (depending on whether it ends with 'x' for JSX).
- * - `'use server logics'`: Server Logics Modules do NOT export JSX.
- * - `'use client logics'`: Client Logics Modules do NOT export JSX.
- * - `'use agnostic logics'`: Agnostic Logics Modules do NOT export JSX.
- * - `'use server components'`: Server Components Modules ONLY export JSX.
- * - `'use client components'`: Client Components Modules ONLY export JSX.
- * - `'use agnostic components'`: Agnostic Components Modules ONLY export JSX.
- * - `'use server functions'`: Server Functions Modules do NOT export JSX.
- * - `'use client contexts'`: Client Contexts Modules ONLY export JSX.
- * - `'use agnostic conditions'`: Agnostic Conditions Modules ONLY export JSX.
- * - `'use agnostic strategies'`: Agnostic Strategies Modules may export JSX.
- * @param {CommentedDirective} directive The commented directive as written on top of the file (cannot be `null` at that stage).
- * @param {Extension} extension The JavaScript (TypeScript) extension of the file.
- * @returns The verified commented directive, from which imports rules are applied. Returns `null` if the verification failed, upon which an error will be reported depending on the commented directive, since the error logic here is strictly binary.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#GETVERIFIEDCOMMENTEDDIRECTIVE
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USESERVERLOGICSB
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USECLIENTLOGICSB
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICLOGICSB
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USESERVERCOMPONENTSB
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USECLIENTCOMPONENTSB
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICCOMPONENTSB
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USESERVERFUNCTIONSB
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USECLIENTCONTEXTSB
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICCONDITIONSB
+ * - $COMMENT#JSDOC#DETAILS#DIRECTIVE21#USEAGNOSTICSTRATEGIESB
+ * @param {CommentedDirective} directive $COMMENT#JSDOC#PARAMS#DIRECTIVE21#DIRECTIVE
+ * @param {Extension} extension $COMMENT#JSDOC#PARAMS#EXTENSION
+ * @returns $COMMENT#JSDOC#RETURNS#DIRECTIVE21#GETVERIFIEDCOMMENTEDDIRECTIVE
  */
 export const getVerifiedCommentedDirective = (directive, extension) => {
   const rule = commentedDirectives_extensionRules[directive];
@@ -209,10 +209,10 @@ export const getVerifiedCommentedDirective = (directive, extension) => {
 /* getStrategizedDirective */
 
 /**
- * Gets the interpreted directive from a specified commented Strategy (such as `@serverLogics`) nested inside the import declaration for an import from an Agnostic Strategies Module.
- * @param {Context} context The ESLint rule's `context` object.
- * @param {ImportDeclaration} node The ESLint `node` of the rule's current traversal.
- * @returns The interpreted directive, a.k.a. strategized directive, or lack thereof via `null`.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#GETSTRATEGIZEDDIRECTIVE
+ * @param {Context} context $COMMENT#JSDOC#PARAMS#CONTEXTB
+ * @param {ImportDeclaration} node $COMMENT#JSDOC#PARAMS#NODE
+ * @returns $COMMENT#JSDOC#RETURNS#DIRECTIVE21#GETSTRATEGIZEDDIRECTIVE
  */
 export const getStrategizedDirective = (context, node) => {
   // gets the first nested `/* */` comment inside the node
@@ -240,18 +240,18 @@ export const getStrategizedDirective = (context, node) => {
 /* addressDirectiveIfAgnosticStrategies */
 
 /**
- * Verifies the current node's export strategy if the current commented directive is `"use agnostic strategies"` by reporting `exportNotStrategized` in case an export is not strategized in an Agnostic Strategies Module.
- * @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 The commented directive, the addressed strategy (as a commented directive) or `null` in case of failure.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#ADDRESSDIRECTIVEIFAGNOSTICSTRATEGIES
+ * @param {Context} context $COMMENT#JSDOC#PARAMS#CONTEXTB
+ * @param {ExportNamedDeclaration | ExportAllDeclaration | ExportDefaultDeclaration} node $COMMENT#JSDOC#PARAMS#NODE
+ * @param {CommentedDirective} currentFileCommentedDirective $COMMENT#JSDOC#PARAMS#DIRECTIVE21#CURRENTFILECOMMENTEDDIRECTIVE
+ * @returns $COMMENT#JSDOC#RETURNS#DIRECTIVE21#ADDRESSDIRECTIVEIFAGNOSTICSTRATEGIES
  */
 export const addressDirectiveIfAgnosticStrategies = (
   context,
   node,
   currentFileCommentedDirective
 ) => {
-  // ignores if not addressing an Agnostic Strategies Module
+  // ignores if not addressing an Agnostic Strategies $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE
   if (currentFileCommentedDirective !== USE_AGNOSTIC_STRATEGIES)
     return currentFileCommentedDirective;
 
@@ -270,10 +270,10 @@ export const addressDirectiveIfAgnosticStrategies = (
 /* isImportBlocked */
 
 /**
- * Returns a boolean deciding if an imported file's commented directive is incompatible with the current file's commented directive.
- * @param {CommentedDirectiveWithoutUseAgnosticStrategies} currentFileCommentedDirective The current file's commented directive.
- * @param {CommentedDirectiveWithoutUseAgnosticStrategies} importedFileCommentedDirective The imported file's commented directive.
- * @returns `true` if the import is blocked, as established in `commentedDirectives_BlockedImports`.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#ISIMPORTBLOCKED
+ * @param {CommentedDirectiveWithoutUseAgnosticStrategies} currentFileCommentedDirective $COMMENT#JSDOC#PARAMS#DIRECTIVE21#CURRENTFILECOMMENTEDDIRECTIVE
+ * @param {CommentedDirectiveWithoutUseAgnosticStrategies} importedFileCommentedDirective $COMMENT#JSDOC#PARAMS#DIRECTIVE21#IMPORTEDFILECOMMENTEDDIRECTIVE
+ * @returns $COMMENT#JSDOC#RETURNS#DIRECTIVE21#ISIMPORTBLOCKED
  */
 export const isImportBlocked = (
   currentFileCommentedDirective,
@@ -288,9 +288,9 @@ export const isImportBlocked = (
 /* makeMessageFromCurrentFileCommentedDirective */
 
 /**
- * Lists in an message the commented modules incompatible with a commented module based on its commented directive.
- * @param {CommentedDirectiveWithoutUseAgnosticStrategies} commentedDirective The commented directive of the commented module.
- * @returns The message listing the incompatible commented modules.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#MAKEMESSAGEFROMCURRENTFILECOMMENTEDDIRECTIVE
+ * @param {CommentedDirectiveWithoutUseAgnosticStrategies} commentedDirective $COMMENT#JSDOC#PARAMS#DIRECTIVE21#COMMENTEDDIRECTIVE
+ * @returns $COMMENT#JSDOC#RETURNS#DIRECTIVE21#MAKEMESSAGEFROMCURRENTFILECOMMENTEDDIRECTIVE
  */
 export const makeMessageFromCurrentFileCommentedDirective = (
   commentedDirective
@@ -303,10 +303,10 @@ export const makeMessageFromCurrentFileCommentedDirective = (
 /* findSpecificViolationMessage */
 
 /**
- * Finds the `message` for the specific violation of commented directives import rules based on `commentedDirectives_BlockedImports`.
- * @param {CommentedDirectiveWithoutUseAgnosticStrategies} currentFileCommentedDirective The current file's commented directive.
- * @param {CommentedDirectiveWithoutUseAgnosticStrategies} importedFileCommentedDirective The imported file's commented directive.
- * @returns The corresponding `message`.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#FINDSPECIFICVIOLATIONMESSAGE
+ * @param {CommentedDirectiveWithoutUseAgnosticStrategies} currentFileCommentedDirective $COMMENT#JSDOC#PARAMS#DIRECTIVE21#CURRENTFILECOMMENTEDDIRECTIVE
+ * @param {CommentedDirectiveWithoutUseAgnosticStrategies} importedFileCommentedDirective $COMMENT#JSDOC#PARAMS#DIRECTIVE21#IMPORTEDFILECOMMENTEDDIRECTIVE
+ * @returns $COMMENT#JSDOC#RETURNS#FINDSPECIFICVIOLATIONMESSAGE
  */
 export const findSpecificViolationMessage = (
   currentFileCommentedDirective,

package/library/directive21/config.js

@@ -12,9 +12,9 @@ import {
  */
 
 /**
- * Makes the directive21 config for the use-agnostic ESLint plugin.
- * @param {Plugin} plugin The use-agnostic ESLint plugin itself.
- * @returns The directive21 config's name as a key and its config as its value.
+ * $COMMENT#JSDOC#DEFINITIONS#DIRECTIVE21#MAKEDIRECTIVE21CONFIG
+ * @param {Plugin} plugin $COMMENT#JSDOC#PARAMS#PLUGIN
+ * @returns $COMMENT#JSDOC#RETURNS#DIRECTIVE21#MAKEDIRECTIVE21CONFIG
  */
 export const makeDirective21Config = (plugin) => ({
   [directive21ConfigName]: defineConfig([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-use-agnostic",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "Highlights problematic server-client imports in projects made with the Fullstack React Architecture.",
   "keywords": [
     "eslint",
@@ -41,8 +41,9 @@
     "test": "node tests/agnostic20/import-rules.test.js && node tests/directive21/import-rules.test.js"
   },
   "dependencies": {
-    "get-sourcecode-from-file-path": "^1.0.0",
-    "resolve-importing-path": "^1.0.2",
+    "comment-variables-resolve-config": "^1.9.0",
+    "get-sourcecode-from-file-path": "^1.1.2",
+    "resolve-importing-path": "^1.0.3",
     "tsconfig-paths": "^4.2.0",
     "typescript-eslint": "^8.32.0"
   },

package/jscomments/agnostic20/constants/bases.js

@@ -1,29 +0,0 @@
-import {
-  serverLogicsComments,
-  serverComponentsComments,
-  serverFunctionsComments,
-  clientLogicsComments,
-  clientComponentsComments,
-  agnosticLogicsComments,
-  agnosticComponentsComments,
-} from "./modules-comments.js";
-
-import {
-  USE_SERVER_LOGICS,
-  USE_CLIENT_LOGICS,
-  USE_AGNOSTIC_LOGICS,
-  USE_SERVER_COMPONENTS,
-  USE_CLIENT_COMPONENTS,
-  USE_AGNOSTIC_COMPONENTS,
-  USE_SERVER_FUNCTIONS,
-} from "../../../library/_commons/constants/bases.js";
-
-export const agnostic20Comments = Object.freeze({
-  [USE_SERVER_LOGICS]: serverLogicsComments,
-  [USE_SERVER_COMPONENTS]: serverComponentsComments,
-  [USE_SERVER_FUNCTIONS]: serverFunctionsComments,
-  [USE_CLIENT_LOGICS]: clientLogicsComments,
-  [USE_CLIENT_COMPONENTS]: clientComponentsComments,
-  [USE_AGNOSTIC_LOGICS]: agnosticLogicsComments,
-  [USE_AGNOSTIC_COMPONENTS]: agnosticComponentsComments,
-});

package/jscomments/agnostic20/constants/modules-comments.js

@@ -1,143 +0,0 @@
-import {
-  USE_SERVER_LOGICS,
-  USE_CLIENT_LOGICS,
-  USE_AGNOSTIC_LOGICS,
-  USE_SERVER_COMPONENTS,
-  USE_CLIENT_COMPONENTS,
-  USE_AGNOSTIC_COMPONENTS,
-  USE_SERVER_FUNCTIONS,
-} from "../../../library/_commons/constants/bases.js";
-
-export const serverLogicsComments = Object.freeze({
-  // $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#USE_SERVER_LOGICS
-  [USE_SERVER_LOGICS]:
-    /* valid */ "Server Logics can compose with one another.",
-  [USE_SERVER_COMPONENTS]:
-    /* valid */ "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]:
-    /* valid */ "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.)",
-  [USE_CLIENT_LOGICS]:
-    /* invalid */ "Client Logics should never leak to the server, such as would be the case here in a Server Logics Module.",
-  [USE_CLIENT_COMPONENTS]:
-    /* invalid */ "Client Components cannot be tinkered with on the server.",
-  [USE_AGNOSTIC_LOGICS]:
-    /* valid */ "Agnostic Logics can run safely on the server just like they can on the client, such as is the case here in a Server Logics Module.",
-  [USE_AGNOSTIC_COMPONENTS]:
-    /* valid */ "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.",
-  module: "Server Logics Module",
-  modulePeriod: "Server Logics Module.",
-});
-
-export const serverComponentsComments = Object.freeze({
-  [USE_SERVER_LOGICS]:
-    /* valid */ "Server Logics, being logic from the server, can safely support Server Components.",
-  [USE_SERVER_COMPONENTS]:
-    /* valid */ "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]:
-    /* valid */ "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.",
-  [USE_CLIENT_LOGICS]:
-    /* invalid */ "Client Logics should never leak to the server, such as would be the case here in a Server Components Module.",
-  [USE_CLIENT_COMPONENTS]:
-    /* valid */ "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]:
-    /* valid */ "Agnostic Logics can run safely on the server just like they can on the client, such as is the case here in a Server Components Module.",
-  [USE_AGNOSTIC_COMPONENTS]:
-    /* valid */ "Agnostic Components can render safely on the server just like they can on the client.",
-  module: "Server Components Module",
-  modulePeriod: "Server Components Module.",
-});
-
-export const serverFunctionsComments = Object.freeze({
-  [USE_SERVER_LOGICS]:
-    /* valid */ "Server Logics, being logic from the server, can safely support Server Functions.",
-  [USE_SERVER_COMPONENTS]:
-    /* invalid */ "Server Components aren't allowed because Server Functions have no business working with React Components.",
-  [USE_SERVER_FUNCTIONS]:
-    /* valid */ "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.)",
-  [USE_CLIENT_LOGICS]:
-    /* invalid */ "Client Logics should never leak to the server, such as would be the case here in a Server Functions Module.",
-  [USE_CLIENT_COMPONENTS]:
-    /* invalid */ "Client Components aren't allowed because Server Functions have no business working with React Components.",
-  [USE_AGNOSTIC_LOGICS]:
-    /* valid */ "Agnostic Logics can run safely on the server just like they can on the client, such as is the case here in a Server Functions Module.",
-  [USE_AGNOSTIC_COMPONENTS]:
-    /* invalid */ "Agnostic Components aren't allowed because Server Functions have no business working with React Components.",
-  module: "Server Functions Module",
-  modulePeriod: "Server Functions Module.",
-});
-
-export const clientLogicsComments = Object.freeze({
-  [USE_SERVER_LOGICS]:
-    /* invalid */ "Server Logics should never leak to the client, such as would be the case here in a Client Logics Module.",
-  [USE_SERVER_COMPONENTS]:
-    /* invalid */ "Server Components cannot be thinkered with on the client.",
-  [USE_SERVER_FUNCTIONS]:
-    /* valid */ "Server Functions can technically be attached to Client Components that are being tinkered with within Client Logics Modules.",
-  [USE_CLIENT_LOGICS]:
-    /* valid */ "Client Logics can compose with one another.",
-  [USE_CLIENT_COMPONENTS]:
-    /* valid */ "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]:
-    /* valid */ "Agnostic Logics can run safely on the client just like they can on the server, such as is the case here in a Client Logics Module.",
-  [USE_AGNOSTIC_COMPONENTS]:
-    /* valid */ "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.",
-  module: "Client Logics Module",
-  modulePeriod: "Client Logics Module.",
-});
-
-export const clientComponentsComments = Object.freeze({
-  [USE_SERVER_LOGICS]:
-    /* invalid */ "Server Logics should never leak to the client, such as would be the case here in a Client Components Module.",
-  [USE_SERVER_COMPONENTS]:
-    /* invalid */ "Server Components may only pass through Client Components via the children prop within Server Components Modules.",
-  [USE_SERVER_FUNCTIONS]:
-    /* valid */ "Server Functions are specifically triggered by Client Components.",
-  [USE_CLIENT_LOGICS]:
-    /* valid */ "Client Logics, being logic from the client, can safely support Client Components.",
-  [USE_CLIENT_COMPONENTS]:
-    /* valid */ "Client Components can compose with one another.",
-  [USE_AGNOSTIC_LOGICS]:
-    /* valid */ "Agnostic Logics can run safely on the client just like they can on the server, such as is the case here in a Client Components Module.",
-  [USE_AGNOSTIC_COMPONENTS]:
-    /* valid */ "Agnostic Components can render safely on the client just like they can on the server.",
-  module: "Client Components Module",
-  modulePeriod: "Client Components Module.",
-});
-
-export const agnosticLogicsComments = Object.freeze({
-  [USE_SERVER_LOGICS]:
-    /* invalid */ "Server Logics cannot run on both the server and the client, such as would be the case here in an Agnostic Logics Module.",
-  [USE_SERVER_COMPONENTS]:
-    /* invalid */ "Server Components cannot be tinkered with on both the server and the client.",
-  [USE_SERVER_FUNCTIONS]:
-    /* invalid */ "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.",
-  [USE_CLIENT_LOGICS]:
-    /* invalid */ "Client Logics cannot run on both the server and the client, such as would be the case here in an Agnostic Logics Module.",
-  [USE_CLIENT_COMPONENTS]:
-    /* invalid */ "Client Components cannot be tinkered with on both the server and the client.",
-  [USE_AGNOSTIC_LOGICS]:
-    /* valid */ "Agnostic Logics can compose with one another.",
-  [USE_AGNOSTIC_COMPONENTS]:
-    /* valid */ "Agnostic Components can be composed with Logics agnostically as long as the Agnostic Logics Module, by convention, does not export React components.",
-  module: "Agnostic Logics Module",
-  modulePeriod: "Agnostic Logics Module.",
-});
-
-export const agnosticComponentsComments = Object.freeze({
-  [USE_SERVER_LOGICS]:
-    /* invalid */ "Server Logics cannot run on both the server and the client, such as would be the case here in an Agnostic Components Module.",
-  [USE_SERVER_COMPONENTS]:
-    /* invalid */ "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.",
-  [USE_SERVER_FUNCTIONS]:
-    /* valid */ "Server Functions can be passed to Client Components as props when Client Components are also legally imported into Agnostic Components Modules.",
-  [USE_CLIENT_LOGICS]:
-    /* invalid */ "Client Logics cannot run on both the server and the client, such as would be the case here in an Agnostic Components Module.",
-  [USE_CLIENT_COMPONENTS]:
-    /* valid */ "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]:
-    /* valid */ "Agnostic Logics, being environment-agnostic logic, can safely support Agnostic Components.",
-  [USE_AGNOSTIC_COMPONENTS]:
-    /* valid */ "Agnostic Components can compose with one another.",
-  module: "Agnostic Components Module",
-  modulePeriod: "Agnostic Components Module.",
-});

package/jscomments/directive21/constants/bases.js

@@ -1,38 +0,0 @@
-import {
-  serverLogicsComments,
-  clientLogicsComments,
-  agnosticLogicsComments,
-  serverComponentsComments,
-  clientComponentsComments,
-  agnosticComponentsComments,
-  serverFunctionsComments,
-  clientContextsComments,
-  agnosticConditionsComments,
-} from "./modules-comments.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,
-} from "../../../library/_commons/constants/bases.js";
-
-export const directive21Comments = Object.freeze({
-  [USE_SERVER_LOGICS]: serverLogicsComments,
-  [USE_CLIENT_LOGICS]: clientLogicsComments,
-  [USE_AGNOSTIC_LOGICS]: agnosticLogicsComments,
-  [USE_SERVER_COMPONENTS]: serverComponentsComments,
-  [USE_CLIENT_COMPONENTS]: clientComponentsComments,
-  [USE_AGNOSTIC_COMPONENTS]: agnosticComponentsComments,
-  [USE_SERVER_FUNCTIONS]: serverFunctionsComments,
-  [USE_CLIENT_CONTEXTS]: clientContextsComments,
-  [USE_AGNOSTIC_CONDITIONS]: agnosticConditionsComments,
-  [USE_AGNOSTIC_STRATEGIES]:
-    /* valid */ "(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.)",
-});