eslint-plugin-use-agnostic 1.2.2 → 1.3.0

package/README.md

@@ -1,5 +1,7 @@
 # eslint-plugin-use-agnostic
 
+_(Now powered by Comment Variables.)_
+
 `eslint-plugin-use-agnostic` highlights problematic server-client imports in projects made with the Fullstack React Architecture (Next.js App Router, etc.) based on each of their modules' derived effective directives through detailed import rule violations, thanks to the introduction of its very own `'use agnostic'` directive.
 
 ![Intro example of linting with the use-agnostic ESLint plugin including the suggestion to use the 'use agnostic' directive.](./assets/README/example.png)
@@ -42,6 +44,8 @@ export default defineConfig([
 ]);
 ```
 
+And don't forget to install the ESLint VS Code plugin for live reports.
+
 ## How it works
 
 In the beginning, there were not two kinds of modules in the Fullstack React Architecture (server vs. client). There were three:

package/comments.config.js

@@ -1,22 +1,22 @@
-import {
-  agnostic20ConfigName,
-  directive21ConfigName,
-} from "./library/_commons/constants/bases.js";
+import { jsDocComments } from "./jscomments/jsdoc/comments.js";
+import { testsComments } from "./jscomments/tests/comments.js";
+import { agnostic20Comments } from "./jscomments/agnostic20/comments.js";
+import { directive21Comments } from "./jscomments/directive21/comments.js";
 
-import {
-  jSDocComments,
-  testsComments,
-} from "./jscomments/_commons/constants/bases.js";
-import { agnostic20Comments } from "./jscomments/agnostic20/constants/bases.js";
-import { directive21Comments } from "./jscomments/directive21/constants/bases.js";
-
-const config = Object.freeze({
-  jsDoc: jSDocComments,
+export const data = Object.freeze({
+  jsDoc: jsDocComments,
   tests: testsComments,
-  [agnostic20ConfigName]: agnostic20Comments,
-  [directive21ConfigName]: directive21Comments,
+  agnostic20: agnostic20Comments,
+  directive21: directive21Comments,
 });
 
+const ignores = [];
+
+const config = {
+  data,
+  ignores,
+};
+
 export default config;
 
 /* Notes
@@ -29,4 +29,5 @@ Aims of the VSCode extension JSComments:
   - config["directive21"] would return $COMMENT#DIRECTIVE21#*
 - this way, instead doing a find-replace on a big documentation comment, the comment stays within the config and only the config placeholder is found and replaced for the same results
 A working CLI is already on npm: comment-variables.
+And the VS Code is also done now privately.
 */

package/jscomments/_commons/constants/bases.js

@@ -1,95 +1,21 @@
-// comment variables for JSDoc definitions
-export const jSDocComments = Object.freeze({
-  // library/_commons/utilities/helpers.js
-  basePath: "The absolute import path with its extension yet resolved.",
-  currentDir:
-    "The directory of the file containing the import, such as from `path.dirname(context.filename)`.",
-  importPath:
-    "The import specifier (e.g., `@/components/Button` or `./utils`), such as one from the current node.",
-  cwd: "The project root, such as from `context.cwd`.",
-  fileResolvedPath: "The resolved path of the file.",
-  aContext: "An ESLint rule's `context` object.",
-  resolvedDirectives_blockedImports: `The blocked imports object, either for agnostic20 or for directive21.`,
-  currentFileResolvedDirective: `The current file's "resolved" directive.`,
-  importedFileResolvedDirective: `The imported file's "resolved" directive.`,
-  theCurrentFileResolvedDirective: `The "resolved" directive of the "resolved" module.`,
-  // library/ ... /config.js
-  plugin: "The use-agnostic ESLint plugin itself.",
-  // library/agnostic20/_commons/constants/bases.js
-  currentFileEffectiveDirective: "The current file's effective directive.",
-  importedFileEffectiveDirective: "The imported file's effective directive.",
-  // library/ ... /flows.js
-  context: "The ESLint rule's `context` object.",
-  node: "The ESLint `node` of the rule's current traversal.",
-  // library/ ... /helpers.js
-  extension: "The JavaScript (TypeScript) extension of the file.",
-  resolvedPath: "The resolved path of the imported module.",
-  // library/agnostic20/_commons/utilities/helpers.js
-  ast: "The module's AST (Abstract Syntax Tree).",
-  directiveA20: `The directive as written on top of the file (\`"no directive"\` if no valid directive).`,
-  effectiveDirective: "The effective directive of the effective module.",
-  serverByDefault: `\`null\` denotes a server-by-default module, ideally a Server Module.`,
-  useServer: `\`'use server'\` denotes a Server Functions Module.`,
-  useClient: `\`'use client'\` denotes a Client Module.`,
-  useAgnostic: `\`'use agnostic'\` denotes an Agnostic Module (formerly Shared Module).`,
-  useServerLogics20: `\`'use server logics'\` denotes a Server Logics Module.`,
-  useServerComponents20: `\`'use server components'\` denotes a Server Components Module.`,
-  useServerFunctions20: `\`'use server functions'\` denotes a Server Functions Module.`,
-  useClientLogics20: `\`'use client logics'\` denotes a Client Logics Module.`,
-  useClientComponents20: `\`'use client components'\` denotes a Client Components Module.`,
-  useAgnosticLogics20: `\`'use agnostic logics'\` denotes an Agnostic Logics Module.`,
-  useAgnosticComponents20: `\`'use agnostic components'\` denotes an Agnostic Components Module.`,
-  // library/directive21/_commons/constants/bases.js
-  currentFileCommentedDirective: "The current file's commented directive.",
-  importedFileCommentedDirective: "The imported file's commented directive.",
-  // library/directive21/_commons/utilities/helpers.js
-  string: "The original string.",
-  sourceCode: "The ESLint SourceCode object.",
-  directiveD21:
-    "The commented directive as written on top of the file (cannot be `null` at that stage).",
-  commentedDirective: "The commented directive of the commented module.",
-  useServerLogics21: `\`'use server logics'\`, \`"use server logics"\` denoting a Server Logics Module.`,
-  useClientLogics21: `\`'use client logics'\`, \`"use client logics"\` denoting a Client Logics Module.`,
-  useAgnosticLogics21: `\`'use agnostic logics'\`, \`"use agnostic logics"\` denoting an Agnostic Logics Module.`,
-  useServerComponents21: `\`'use server components'\`, \`"use server components"\` denoting a Server Components Module.`,
-  useClientComponents21: `\`'use client components'\`, \`"use client components"\` denoting a Client Components Module.`,
-  useAgnosticComponents21: `\`'use agnostic components'\`, \`"use agnostic components"\` denoting an Agnostic Components Module.`,
-  useServerFunctions21: `\`'use server functions'\`, \`"use server functions"\` denoting a Server Functions Module.`,
-  useClientContexts21: `\`'use client contexts'\`, \`"use client contexts"\` denoting a Client Contexts Module.`,
-  useAgnosticConditions21: `\`'use agnostic conditions'\`, \`"use agnostic conditions"\` denoting an Agnostic Conditions Module.`,
-  useAgnosticStrategies21: `\`'use agnostic strategies'\`, \`"use agnostic strategies"\` denoting an Agnostic Strategies Module.`,
-  useServerLogicsExtensionRule: `\`'use server logics'\`: Server Logics Modules do NOT export JSX.`,
-  useClientLogicsExtensionRule: `\`'use client logics'\`: Client Logics Modules do NOT export JSX.`,
-  useAgnosticLogicsExtensionRule: `\`'use agnostic logics'\`: Agnostic Logics Modules do NOT export JSX.`,
-  useServerComponentsExtensionRule: `\`'use server components'\`: Server Components Modules ONLY export JSX.`,
-  useClientComponentsExtensionRule: `\`'use client components'\`: Client Components Modules ONLY export JSX.`,
-  useAgnosticComponentsExtensionRule: `\`'use agnostic components'\`: Agnostic Components Modules ONLY export JSX.`,
-  useServerFunctionsExtensionRule: `\`'use server functions'\`: Server Functions Modules do NOT export JSX.`,
-  useClientContextsExtensionRule: `\`'use client contexts'\`: Client Contexts Modules ONLY export JSX.`,
-  useAgnosticConditionsExtensionRule: `\`'use agnostic conditions'\`: Agnostic Conditions Modules ONLY export JSX.`,
-  useAgnosticStrategiesExtensionRule: `\`'use agnostic strategies'\`: Agnostic Strategies Modules may export JSX.`,
-  // tests/_commons/utilities/helpers.js
-  folderPath: "The provided directory.",
-  allFiles:
-    "The accumulator array of file paths. Defaults to an empty array on the initial call, and is passed through each recursive call to be mutated and collect results.",
-  javaScriptErrorsLength: "The number of errors expected on JavaScript files.",
-  typeScriptErrorsLength: "The number of errors expected on TypeScript files.",
-  messageId: "The messageId of the errors expected.",
-});
+import url from "url";
+import path from "path";
 
-// comment variables for tests flavor texts
-export const testsComments = Object.freeze({
-  thatsA: "That's a",
-  thatsAn: "That's an",
-  importingA: "...Importing a",
-  withExtension: "with extension",
-  withExtensionParentheses: "(with extension).",
-  byFolder: "by a folder.",
-  importing: "...Importing",
-  viaStrategy: "via Special Agnostic Strategy",
-  viaStrategyPeriod: "via Special Agnostic Strategy.",
-  viaAlias: "Via alias.",
-  viaBaseUrl: "Via baseUrl.",
-  valid: "Valid.",
-  invalid: "Invalid.",
-});
+import { makeResolvedConfigData } from "comment-variables-resolve-config";
+
+const dirname = path.dirname(url.fileURLToPath(import.meta.url));
+const jsCommentsConfigPath = path.join(dirname, "../../../comments.config.js");
+
+const makeResolvedConfigDataResults = await makeResolvedConfigData(
+  jsCommentsConfigPath
+);
+
+if (!makeResolvedConfigDataResults.success) {
+  makeResolvedConfigDataResults.errors.forEach((e) => {
+    console.error(e.message);
+  });
+  throw new Error("Failed to resolve config data.");
+}
+
+export const resolvedConfigData =
+  makeResolvedConfigDataResults.resolvedConfigData;

package/jscomments/agnostic20/comments.js

@@ -0,0 +1,79 @@
+import {
+  serverLogicsComments,
+  serverComponentsComments,
+  serverFunctionsComments,
+  clientLogicsComments,
+  clientComponentsComments,
+  agnosticLogicsComments,
+  agnosticComponentsComments,
+} from "./modules-comments.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,
+  forAliasVariables: Object.freeze({
+    serverNeverClient:
+      "Server Logics should never leak to the client." /* $COMMENT#AGNOSTIC20#FORALIASVARIABLES#SERVERNEVERCLIENT */,
+    clientNeverServer:
+      "Client Logics should never leak to the server." /* $COMMENT#AGNOSTIC20#FORALIASVARIABLES#CLIENTNEVERSERVER */,
+    agnosticCanServerClient:
+      "Agnostic Logics can run safely on the server just like they can on the client." /* $COMMENT#AGNOSTIC20#FORALIASVARIABLES#AGNOSTICCANSERVERCLIENT */,
+    agnosticCanClientServer:
+      "Agnostic Logics can run safely on the client just like they can on the server." /* $COMMENT#AGNOSTIC20#FORALIASVARIABLES#AGNOSTICCANCLIENTSERVER */,
+    serverFunctionsNoComponents:
+      "Server Functions have no business working with React Components." /* $COMMENT#AGNOSTIC20#FORALIASVARIABLES#SERVERFUNCTIONSNOCOMPONENTS */,
+    serverLogicsCantBoth:
+      "$COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTSERVERCLIENT" /* $COMMENT#AGNOSTIC20#FORALIASVARIABLES#SERVERLOGICSCANTBOTH */,
+    clientLogicsCantBoth:
+      "$COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTSERVERCLIENT" /* $COMMENT#AGNOSTIC20#FORALIASVARIABLES#CLIENTLOGICSCANTBOTH */,
+  }),
+  forComposedVariables: Object.freeze({
+    canComposeOneAnother:
+      "can compose with one another." /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANCOMPOSEONEANOTHER */,
+    cantTinkeredServer:
+      "cannot be tinkered with on the server." /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTTINKEREDSERVER */,
+    cantTinkeredClient:
+      "cannot be tinkered with on the client." /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTTINKEREDCLIENT */,
+    cantTinkeredBoth:
+      "cannot be tinkered with on both the server and the client." /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTTINKEREDBOTH */,
+    serverComponentsOKLogics:
+      "Server Components are OK to be composed with Server Logics as long as the Server Logics Module," /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#SERVERCOMPONENTSOKLOGICS */,
+    clientComponentsOKLogics:
+      "Client Components are OK to be composed with Client Logics as long as the Client Logics Module," /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CLIENTCOMPONENTSOKLOGICS */,
+    agnosticComponentsCanServer:
+      "Agnostic Components can be composed with Logics on the server just like they can on the client, as long at the Server Logics Module," /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#AGNOSTICCOMPONENTSCANSERVER */,
+    agnosticComponentsCanClient:
+      "Agnostic Components can be composed with Logics on the client just like they can on the server, as long as the Client Logics Module," /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#AGNOSTICCOMPONENTSCANCLIENT */,
+    agnosticComponentsCanAgnostic:
+      "Agnostic Components can be composed with Logics agnostically as long as the Agnostic Logics Module," /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#AGNOSTICCOMPONENTSCANAGNOSTIC */,
+    noExportComponents:
+      "by convention, does not export React components." /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#NOEXPORTCOMPONENTS */,
+    cantServerClient:
+      "cannot run on both the server and the client." /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTSERVERCLIENT */,
+    arentAllowed:
+      "aren't allowed because" /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#ARENTALLOWED */,
+    allowedBecause:
+      "allowed, because" /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#ALLOWEDBECAUSE */,
+    beingLogicServer:
+      "being logic from the server," /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#BEINGLOGICSERVER */,
+    beingLogicClient:
+      "being logic from the client," /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#BEINGLOGICCLIENT */,
+    beingLogicAgnostic:
+      "being environment-agnostic logic," /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#BEINGLOGICAGNOSTIC */,
+    canSafelySupport:
+      "can safely support" /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANSAFELYSUPPORT */,
+    canBeNestedInside:
+      "can be nested inside" /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANBENESTEDINSIDE */,
+    eitherWrapTree:
+      "either to wrap some of the tree with client state accessible through child Client Components and pass through Server Components" /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#EITHERWRAPTREE */,
+    ifStillOnServerTree:
+      "— if still on the Server Tree —" /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#IFSTILLONSERVERTREE */,
+    orCreateBoundaries:
+      "or to create client boundaries when the root of the application is planted on the server." /* $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#ORCREATEBOUNDARIES */,
+  }),
+});

package/jscomments/agnostic20/modules-comments.js

@@ -0,0 +1,199 @@
+export const serverLogicsComments = Object.freeze({
+  "use server logics":
+    /* valid */ "$COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANCOMPOSEONEANOTHER" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#USE_SERVER_LOGICS */,
+  "use server components":
+    /* valid */ "$COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#SERVERCOMPONENTSOKLOGICS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#NOEXPORTCOMPONENTS" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#USE_SERVER_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.)" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#USE_SERVER_FUNCTIONS */,
+  "use client logics":
+    /* invalid */ "AGNOSTIC20#FORALIASVARIABLES#CLIENTNEVERSERVER" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#USE_CLIENT_LOGICS */,
+  "use client components":
+    /* invalid */ "$COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTTINKEREDSERVER" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#USE_CLIENT_COMPONENTS */,
+  "use agnostic logics":
+    /* valid */ "AGNOSTIC20#FORALIASVARIABLES#AGNOSTICCANSERVERCLIENT" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#USE_AGNOSTIC_LOGICS */,
+  "use agnostic components":
+    /* valid */ "$COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#AGNOSTICCOMPONENTSCANSERVER $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#NOEXPORTCOMPONENTS" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#USE_AGNOSTIC_COMPONENTS */,
+  kinds: "Server Logics" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDS */,
+  kindsComma:
+    "Server Logics," /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDSCOMMA */,
+  kindsPeriod:
+    "Server Logics." /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDSPERIOD */,
+  thatsAModule:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSA $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#THATSAMODULE */,
+  importingWithExtension:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#IMPORTINGWITHEXTENSION */,
+  importingByAFolder:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#IMPORTINGBYAFOLDER */,
+});
+
+export const serverComponentsComments = Object.freeze({
+  "use server logics":
+    /* valid */ "$COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDSCOMMA $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#BEINGLOGICSERVER $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANSAFELYSUPPORT $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDSPERIOD" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#USE_SERVER_LOGICS */,
+  "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." /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#USE_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." /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#USE_SERVER_FUNCTIONS */,
+  "use client logics":
+    /* invalid */ "AGNOSTIC20#FORALIASVARIABLES#CLIENTNEVERSERVER" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#USE_CLIENT_LOGICS */,
+  "use client components":
+    /* valid */ "$COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANBENESTEDINSIDE $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#EITHERWRAPTREE $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#ORCREATEBOUNDARIES" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#USE_CLIENT_COMPONENTS */,
+  "use agnostic logics":
+    /* valid */ "AGNOSTIC20#FORALIASVARIABLES#AGNOSTICCANSERVERCLIENT" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#USE_AGNOSTIC_LOGICS */,
+  "use agnostic components":
+    /* valid */ "Agnostic Components can render safely on the server just like they can on the client." /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#USE_AGNOSTIC_COMPONENTS */,
+  kinds:
+    "Server Components" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS */,
+  kindsComma:
+    "Server Components," /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDSCOMMA */,
+  kindsPeriod:
+    "Server Components." /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDSPERIOD */,
+  thatsAModule:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSA $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#THATSAMODULE */,
+  importingWithExtension:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#IMPORTINGWITHEXTENSION */,
+  importingByAFolder:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#IMPORTINGBYAFOLDER */,
+});
+
+export const serverFunctionsComments = Object.freeze({
+  "use server logics":
+    /* valid */ "$COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDSCOMMA $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#BEINGLOGICSERVER $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANSAFELYSUPPORT $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDSPERIOD" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#USE_SERVER_LOGICS */,
+  "use server components":
+    /* invalid */ "$COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#ARENTALLOWED $COMMENT#AGNOSTIC20#FORALIASVARIABLES#SERVERFUNCTIONSNOCOMPONENTS" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#USE_SERVER_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.)" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#USE_SERVER_FUNCTIONS */,
+  "use client logics":
+    /* invalid */ "AGNOSTIC20#FORALIASVARIABLES#CLIENTNEVERSERVER" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#USE_CLIENT_LOGICS */,
+  "use client components":
+    /* invalid */ "$COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#ARENTALLOWED $COMMENT#AGNOSTIC20#FORALIASVARIABLES#SERVERFUNCTIONSNOCOMPONENTS" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#USE_CLIENT_COMPONENTS */,
+  "use agnostic logics":
+    /* valid */ "AGNOSTIC20#FORALIASVARIABLES#AGNOSTICCANSERVERCLIENT" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#USE_AGNOSTIC_LOGICS */,
+  "use agnostic components":
+    /* invalid */ "$COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#ARENTALLOWED $COMMENT#AGNOSTIC20#FORALIASVARIABLES#SERVERFUNCTIONSNOCOMPONENTS" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#USE_AGNOSTIC_COMPONENTS */,
+  kinds:
+    "Server Functions" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDS */,
+  kindsComma:
+    "Server Functions," /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDSCOMMA */,
+  kindsPeriod:
+    "Server Functions." /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDSPERIOD */,
+  thatsAModule:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSA $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#THATSAMODULE */,
+  importingWithExtension:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#IMPORTINGWITHEXTENSION */,
+  importingByAFolder:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#IMPORTINGBYAFOLDER */,
+});
+
+export const clientLogicsComments = Object.freeze({
+  "use server logics":
+    /* invalid */ "AGNOSTIC20#FORALIASVARIABLES#SERVERNEVERCLIENT" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#USE_SERVER_LOGICS */,
+  "use server components":
+    /* invalid */ "$COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTTINKEREDCLIENT" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#USE_SERVER_COMPONENTS */,
+  "use server functions":
+    /* valid */ "Server Functions can technically be attached to Client Components that are being tinkered with within Client Logics Modules." /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#USE_SERVER_FUNCTIONS */,
+  "use client logics":
+    /* valid */ "$COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANCOMPOSEONEANOTHER" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#USE_CLIENT_LOGICS */,
+  "use client components":
+    /* valid */ "$COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CLIENTCOMPONENTSOKLOGICS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#NOEXPORTCOMPONENTS" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#USE_CLIENT_COMPONENTS */,
+  "use agnostic logics":
+    /* valid */ "AGNOSTIC20#FORALIASVARIABLES#AGNOSTICCANCLIENTSERVER" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#USE_AGNOSTIC_LOGICS */,
+  "use agnostic components":
+    /* valid */ "$COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#AGNOSTICCOMPONENTSCANCLIENT $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#NOEXPORTCOMPONENTS" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#USE_AGNOSTIC_COMPONENTS */,
+  kinds: "Client Logics" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDS */,
+  kindsComma:
+    "Client Logics," /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDSCOMMA */,
+  kindsPeriod:
+    "Client Logics." /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDSPERIOD */,
+  thatsAModule:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSA $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#THATSAMODULE */,
+  importingWithExtension:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#IMPORTINGWITHEXTENSION */,
+  importingByAFolder:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#IMPORTINGBYAFOLDER */,
+});
+
+export const clientComponentsComments = Object.freeze({
+  "use server logics":
+    /* invalid */ "AGNOSTIC20#FORALIASVARIABLES#SERVERNEVERCLIENT" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#USE_SERVER_LOGICS */,
+  "use server components":
+    /* invalid */ "Server Components may only pass through Client Components via the children prop within Server Components Modules." /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#USE_SERVER_COMPONENTS */,
+  "use server functions":
+    /* valid */ "Server Functions can specifically be triggered by Client Components." /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#USE_SERVER_FUNCTIONS */,
+  "use client logics":
+    /* valid */ "$COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDSCOMMA $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#BEINGLOGICCLIENT $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANSAFELYSUPPORT $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDSPERIOD" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#USE_CLIENT_LOGICS */,
+  "use client components":
+    /* valid */ "$COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANCOMPOSEONEANOTHER" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#USE_CLIENT_COMPONENTS */,
+  "use agnostic logics":
+    /* valid */ "AGNOSTIC20#FORALIASVARIABLES#AGNOSTICCANCLIENTSERVER" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#USE_AGNOSTIC_LOGICS */,
+  "use agnostic components":
+    /* valid */ "Agnostic Components can render safely on the client just like they can on the server." /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#USE_AGNOSTIC_COMPONENTS */,
+  kinds:
+    "Client Components" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS */,
+  kindsComma:
+    "Client Components," /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDSCOMMA */,
+  kindsPeriod:
+    "Client Components." /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDSPERIOD */,
+  thatsAModule:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSA $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#THATSAMODULE */,
+  importingWithExtension:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#IMPORTINGWITHEXTENSION */,
+  importingByAFolder:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#IMPORTINGBYAFOLDER */,
+});
+
+export const agnosticLogicsComments = Object.freeze({
+  "use server logics":
+    /* invalid */ "AGNOSTIC20#FORALIASVARIABLES#SERVERLOGICSCANTBOTH" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#USE_SERVER_LOGICS */,
+  "use server components":
+    /* invalid */ "$COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTTINKEREDBOTH" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#USE_SERVER_COMPONENTS */,
+  "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." /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#USE_SERVER_FUNCTIONS */,
+  "use client logics":
+    /* invalid */ "AGNOSTIC20#FORALIASVARIABLES#CLIENTLOGICSCANTBOTH" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#USE_CLIENT_LOGICS */,
+  "use client components":
+    /* invalid */ "$COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTTINKEREDBOTH" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#USE_CLIENT_COMPONENTS */,
+  "use agnostic logics":
+    /* valid */ "$COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANCOMPOSEONEANOTHER" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#USE_AGNOSTIC_LOGICS */,
+  "use agnostic components":
+    /* valid */ "$COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#AGNOSTICCOMPONENTSCANAGNOSTIC $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#NOEXPORTCOMPONENTS" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#USE_AGNOSTIC_COMPONENTS */,
+  kinds: "Agnostic Logics" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDS */,
+  kindsComma:
+    "Agnostic Logics," /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDSCOMMA */,
+  kindsPeriod:
+    "Agnostic Logics." /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDSPERIOD */,
+  thatsAModule:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSAN $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#THATSAMODULE */,
+  importingWithExtension:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGAN $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#IMPORTINGWITHEXTENSION */,
+  importingByAFolder:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGAN $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#IMPORTINGBYAFOLDER */,
+});
+
+export const agnosticComponentsComments = Object.freeze({
+  "use server logics":
+    /* invalid */ "AGNOSTIC20#FORALIASVARIABLES#SERVERLOGICSCANTBOTH" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#USE_SERVER_LOGICS */,
+  "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." /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#USE_SERVER_COMPONENTS */,
+  "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." /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#USE_SERVER_FUNCTIONS */,
+  "use client logics":
+    /* invalid */ "AGNOSTIC20#FORALIASVARIABLES#CLIENTLOGICSCANTBOTH" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#USE_CLIENT_LOGICS */,
+  "use client components":
+    /* valid */ "$COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANBENESTEDINSIDE $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#EITHERWRAPTREE $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#IFSTILLONSERVERTREE $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#ORCREATEBOUNDARIES" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#USE_CLIENT_COMPONENTS */,
+  "use agnostic logics":
+    /* valid */ "$COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDSCOMMA $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#BEINGLOGICAGNOSTIC $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANSAFELYSUPPORT $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDSPERIOD" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#USE_AGNOSTIC_LOGICS */,
+  "use agnostic components":
+    /* valid */ "$COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANCOMPOSEONEANOTHER" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#USE_AGNOSTIC_COMPONENTS */,
+  kinds:
+    "Agnostic Components" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDS */,
+  kindsComma:
+    "Agnostic Components," /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDSCOMMA */,
+  kindsPeriod:
+    "Agnostic Components." /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDSPERIOD */,
+  thatsAModule:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSAN $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#THATSAMODULE */,
+  importingWithExtension:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGAN $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#IMPORTINGWITHEXTENSION */,
+  importingByAFolder:
+    "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGAN $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#IMPORTINGBYAFOLDER */,
+});

package/jscomments/directive21/comments.js

@@ -0,0 +1,105 @@
+import {
+  serverLogicsComments,
+  clientLogicsComments,
+  agnosticLogicsComments,
+  serverComponentsComments,
+  clientComponentsComments,
+  agnosticComponentsComments,
+  serverFunctionsComments,
+  clientContextsComments,
+  agnosticConditionsComments,
+  agnosticStrategiesComments,
+} from "./modules-comments.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": agnosticStrategiesComments,
+  forAliasVariables: Object.freeze({
+    serverNeverClient:
+      "Prime Server Logics should never leak to the client." /* $COMMENT#DIRECTIVE21#FORALIASVARIABLES#SERVERNEVERCLIENT */,
+    clientNeverServer:
+      "Prime Client Logics should never leak to the server." /* $COMMENT#DIRECTIVE21#FORALIASVARIABLES#CLIENTNEVERSERVER */,
+    agnosticCanServerClient:
+      "Prime Agnostic Logics can run safely on the server just like they can on the client." /* $COMMENT#DIRECTIVE21#FORALIASVARIABLES#AGNOSTICCANSERVERCLIENT */,
+    agnosticCanClientServer:
+      "Prime Agnostic Logics can run safely on the client just like they can on the server." /* $COMMENT#DIRECTIVE21#FORALIASVARIABLES#AGNOSTICCANCLIENTSERVER */,
+    serverFunctionsNoComponents:
+      "(Special) Server Functions have no business working with React Components." /* $COMMENT#DIRECTIVE21#FORALIASVARIABLES#SERVERFUNCTIONSNOCOMPONENTS */,
+    serverLogicsCantBoth:
+      "$COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#KINDS $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANTSERVERCLIENT" /* $COMMENT#DIRECTIVE21#FORALIASVARIABLES#SERVERLOGICSCANTBOTH */,
+    clientLogicsCantBoth:
+      "$COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#KINDS $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANTSERVERCLIENT" /* $COMMENT#DIRECTIVE21#FORALIASVARIABLES#CLIENTLOGICSCANTBOTH */,
+    agnosticComponentsCanAny:
+      "$COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANANYPRIMELOGICS $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#NOEXPORTCOMPONENTS" /* $COMMENT#DIRECTIVE21#FORALIASVARIABLES#AGNOSTICCOMPONENTSCANANY */,
+    agnosticComponentsRenderAny:
+      "$COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANCLIENTLIKESERVER" /* $COMMENT#DIRECTIVE21#FORALIASVARIABLES#AGNOSTICCOMPONENTSRENDERANY */,
+    serverFunctionsClient:
+      "$COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#SPECIALS $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANCLIENTCOMPONENTS" /* $COMMENT#DIRECTIVE21#FORALIASVARIABLES#SERVERFUNCTIONSCLIENT */,
+  }),
+  forComposedVariables: Object.freeze({
+    canComposeOneAnother:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#CANCOMPOSEONEANOTHER" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANCOMPOSEONEANOTHER */,
+    cantTinkeredServer:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTTINKEREDSERVER" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANTTINKEREDSERVER */,
+    cantTinkeredClient:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTTINKEREDCLIENT" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANTTINKEREDCLIENT */,
+    cantTinkeredBoth:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTTINKEREDBOTH" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANTTINKEREDBOTH */,
+    serverComponentsOKLogics:
+      "Lineal Server Components are OK to be composed with Prime Server Logics as long as the Prime Server Logics Module," /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#SERVERCOMPONENTSOKLOGICS */,
+    likeAnyClientComponentsComma:
+      "like any Client Components," /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#LIKEANYCLIENTCOMPONENTSCOMMA */,
+    likeAnyClientComponentsPeriod:
+      "like any Client Components." /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#LIKEANYCLIENTCOMPONENTSPERIOD */,
+    anyAgnosticComponentsPeriod:
+      "any Agnostic Components." /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#ANYAGNOSTICCOMPONENTSPERIOD */,
+    okClientLogics:
+      "are OK to be composed with Prime Client Logics as long as the Prime Client Logics Module," /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#OKCLIENTLOGICS */,
+    agnosticComponentsCanAny:
+      "Lineal Agnostic Components can be composed with any Prime Environment Logics agnostically, as long as the Prime Environment Logics Module," /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#AGNOSTICCOMPONENTSCANANY */,
+    asIfLinealAgnostic:
+      "as if they were Lineal Agnostic Components themselves," /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#ASIFLINEALAGNOSTIC */,
+    canAnyPrimeLogics:
+      "can be composed with any Prime Environment Logics agnostically, as long as the Prime Environment Logics Module," /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANANYPRIMELOGICS */,
+    noExportComponents:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#NOEXPORTCOMPONENTS" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#NOEXPORTCOMPONENTS */,
+    cantServerClient:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#CANTSERVERCLIENT" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANTSERVERCLIENT */,
+    arentAllowed:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#ARENTALLOWED" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#ARENTALLOWED */,
+    allowedBecause:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#ALLOWEDBECAUSE" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#ALLOWEDBECAUSE */,
+    beingLogicServer:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#BEINGLOGICSERVER" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#BEINGLOGICSERVER */,
+    beingLogicClient:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#BEINGLOGICCLIENT" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#BEINGLOGICCLIENT */,
+    beingLogicAgnostic:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#BEINGLOGICAGNOSTIC" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#BEINGLOGICAGNOSTIC */,
+    canSafelySupport:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#CANSAFELYSUPPORT" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANSAFELYSUPPORT */,
+    canBeNestedInside:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#CANBENESTEDINSIDE" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANBENESTEDINSIDE */,
+    toCreateBoundaries:
+      "to create client boundaries" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#TOCREATEBOUNDARIES */,
+    towrapTree:
+      "to wrap some of the tree with client state accessible through child Client Components, and to pass through Server Components" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#TOWRAPTREE */,
+    ifStillOnServerTree:
+      "AGNOSTIC20#FORCOMPOSEDVARIABLES#IFSTILLONSERVERTREE" /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#IFSTILLONSERVERTREE */,
+    whenRootOnServer:
+      "when the root of the application is planted on the server." /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#WHENROOTONSERVER */,
+    canClientComponents:
+      "can be specifically triggered by Client Components." /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANCLIENTCOMPONENTS */,
+    canServerLikeClient:
+      "can render safely on the server just like they can on the client." /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANSERVERLIKECLIENT */,
+    canClientLikeServer:
+      "can render safely on the client just like they can on the server." /* $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#CANCLIENTLIKESERVER */,
+  }),
+});