eslint-plugin-use-agnostic 1.5.1 → 1.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,5 +2,5 @@
2
2
 
3
3
  import { resolvedConfigData } from "../../../comments.config.mjs";
4
4
 
5
- /** @type {ResolvedConfigData} */
5
+ /** @type {ResolvedConfigData} `resolvedConfigData` can be imported as is but I've noticed that for some reason the type-safety is more advanced when it is re-typed and re-exported, here as `commentVariablesData`. */
6
6
  export const commentVariablesData = resolvedConfigData;
@@ -8,6 +8,8 @@ import {
8
8
  agnosticComponentsComments,
9
9
  } from "./modules-comments.js";
10
10
 
11
+ // Notice: The Comment Variables config and its directly related imports are to be the only place in the code where variables are defined manually, such as `"use server logics"` as a key below. Then, within the code, string variables can be made from values of the config's .mts file in JS/TS (or from its JSON in other languages given how universal JSON is as a notation), so that the text variables in comments and text variables in-code are entirely in sync.
12
+
11
13
  export const agnostic20Comments = Object.freeze({
12
14
  "use server logics": serverLogicsComments,
13
15
  "use server components": serverComponentsComments,
@@ -1,3 +1,5 @@
1
+ // Notice: So eventually the only place where you're going to manually write your text variables will eventually be in Comment Variables, because by doing so you ensure that your text variables are not only variables inside of your code, but variables inside of your comments too, thanks to Comment Variables.
2
+
1
3
  export const serverLogicsComments = Object.freeze({
2
4
  "use server logics":
3
5
  /* valid */ "$COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDS $COMMENT#AGNOSTIC20#FORCOMPOSEDVARIABLES#CANCOMPOSEONEANOTHER" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#USE_SERVER_LOGICS */,
@@ -18,12 +20,16 @@ export const serverLogicsComments = Object.freeze({
18
20
  "Server Logics," /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDSCOMMA */,
19
21
  kindsPeriod:
20
22
  "Server Logics." /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDSPERIOD */,
23
+ module:
24
+ "$COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#MODULE */,
21
25
  thatsAModule:
22
26
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSA $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#THATSAMODULE */,
23
27
  importingWithExtension:
24
28
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#IMPORTINGWITHEXTENSION */,
25
29
  importingByAFolder:
26
30
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#IMPORTINGBYAFOLDER */,
31
+ directive:
32
+ "use server logics" /* $COMMENT#AGNOSTIC20#USE_SERVER_LOGICS#DIRECTIVE */,
27
33
  });
28
34
 
29
35
  export const serverComponentsComments = Object.freeze({
@@ -47,12 +53,16 @@ export const serverComponentsComments = Object.freeze({
47
53
  "Server Components," /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDSCOMMA */,
48
54
  kindsPeriod:
49
55
  "Server Components." /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDSPERIOD */,
56
+ module:
57
+ "$COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#MODULE */,
50
58
  thatsAModule:
51
59
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSA $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#THATSAMODULE */,
52
60
  importingWithExtension:
53
61
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#IMPORTINGWITHEXTENSION */,
54
62
  importingByAFolder:
55
63
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#IMPORTINGBYAFOLDER */,
64
+ directive:
65
+ "use server components" /* $COMMENT#AGNOSTIC20#USE_SERVER_COMPONENTS#DIRECTIVE */,
56
66
  });
57
67
 
58
68
  export const serverFunctionsComments = Object.freeze({
@@ -76,12 +86,16 @@ export const serverFunctionsComments = Object.freeze({
76
86
  "Server Functions," /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDSCOMMA */,
77
87
  kindsPeriod:
78
88
  "Server Functions." /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDSPERIOD */,
89
+ module:
90
+ "$COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#MODULE */,
79
91
  thatsAModule:
80
92
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSA $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#THATSAMODULE */,
81
93
  importingWithExtension:
82
94
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#IMPORTINGWITHEXTENSION */,
83
95
  importingByAFolder:
84
96
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#IMPORTINGBYAFOLDER */,
97
+ directive:
98
+ "use server functions" /* $COMMENT#AGNOSTIC20#USE_SERVER_FUNCTIONS#DIRECTIVE */,
85
99
  });
86
100
 
87
101
  export const clientLogicsComments = Object.freeze({
@@ -104,12 +118,16 @@ export const clientLogicsComments = Object.freeze({
104
118
  "Client Logics," /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDSCOMMA */,
105
119
  kindsPeriod:
106
120
  "Client Logics." /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDSPERIOD */,
121
+ module:
122
+ "$COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#MODULE */,
107
123
  thatsAModule:
108
124
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSA $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#THATSAMODULE */,
109
125
  importingWithExtension:
110
126
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#IMPORTINGWITHEXTENSION */,
111
127
  importingByAFolder:
112
128
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#IMPORTINGBYAFOLDER */,
129
+ directive:
130
+ "use client logics" /* $COMMENT#AGNOSTIC20#USE_CLIENT_LOGICS#DIRECTIVE */,
113
131
  });
114
132
 
115
133
  export const clientComponentsComments = Object.freeze({
@@ -133,12 +151,16 @@ export const clientComponentsComments = Object.freeze({
133
151
  "Client Components," /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDSCOMMA */,
134
152
  kindsPeriod:
135
153
  "Client Components." /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDSPERIOD */,
154
+ module:
155
+ "$COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#MODULE */,
136
156
  thatsAModule:
137
157
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSA $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#THATSAMODULE */,
138
158
  importingWithExtension:
139
159
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#IMPORTINGWITHEXTENSION */,
140
160
  importingByAFolder:
141
161
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#IMPORTINGBYAFOLDER */,
162
+ directive:
163
+ "use client components" /* $COMMENT#AGNOSTIC20#USE_CLIENT_COMPONENTS#DIRECTIVE */,
142
164
  });
143
165
 
144
166
  export const agnosticLogicsComments = Object.freeze({
@@ -161,12 +183,16 @@ export const agnosticLogicsComments = Object.freeze({
161
183
  "Agnostic Logics," /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDSCOMMA */,
162
184
  kindsPeriod:
163
185
  "Agnostic Logics." /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDSPERIOD */,
186
+ module:
187
+ "$COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#MODULE */,
164
188
  thatsAModule:
165
189
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSAN $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#THATSAMODULE */,
166
190
  importingWithExtension:
167
191
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGAN $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#IMPORTINGWITHEXTENSION */,
168
192
  importingByAFolder:
169
193
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGAN $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#IMPORTINGBYAFOLDER */,
194
+ directive:
195
+ "use agnostic logics" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_LOGICS#DIRECTIVE */,
170
196
  });
171
197
 
172
198
  export const agnosticComponentsComments = Object.freeze({
@@ -190,10 +216,14 @@ export const agnosticComponentsComments = Object.freeze({
190
216
  "Agnostic Components," /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDSCOMMA */,
191
217
  kindsPeriod:
192
218
  "Agnostic Components." /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDSPERIOD */,
219
+ module:
220
+ "$COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#MODULE */,
193
221
  thatsAModule:
194
222
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#THATSAN $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#THATSAMODULE */,
195
223
  importingWithExtension:
196
224
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGAN $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#WITHEXTENSIONPARENTHESES" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#IMPORTINGWITHEXTENSION */,
197
225
  importingByAFolder:
198
226
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGAN $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#IMPORTINGBYAFOLDER */,
227
+ directive:
228
+ "use agnostic components" /* $COMMENT#AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#DIRECTIVE */,
199
229
  });
@@ -23,6 +23,12 @@ export const serverLogicsComments = Object.freeze({
23
23
  "Prime Server Logics," /* $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#KINDSCOMMA */,
24
24
  kindsPeriod:
25
25
  "Prime Server Logics." /* $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#KINDSPERIOD */,
26
+ kindsSimple:
27
+ "AGNOSTIC20#USE_SERVER_LOGICS#KINDS" /* $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#KINDSSIMPLE */,
28
+ module:
29
+ "$COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#MODULE */,
30
+ moduleSimple:
31
+ "AGNOSTIC20#USE_SERVER_LOGICS#MODULE" /* $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#MODULESIMPLE */,
26
32
  importingAModule:
27
33
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#IMPORTINGAMODULE */,
28
34
  importingByAFolder:
@@ -31,6 +37,10 @@ export const serverLogicsComments = Object.freeze({
31
37
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGYPERIOD" /* $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#IMPORTINGVIASTRATEGY */,
32
38
  importingViaStrategyByAFolder:
33
39
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGY $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#IMPORTINGVIASTRATEGYBYAFOLDER */,
40
+ directive:
41
+ "AGNOSTIC20#USE_SERVER_LOGICS#DIRECTIVE" /* $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#DIRECTIVE */, // wasn't affected because commented directives requires quotes attached, which don't count as whitespace
42
+ atStrategy:
43
+ "@serverLogics" /* $COMMENT#DIRECTIVE21#USE_SERVER_LOGICS#ATSTRATEGY */, // was affected because strategies in comments are used raw, like /* @serverLogics */
34
44
  });
35
45
 
36
46
  export const clientLogicsComments = Object.freeze({
@@ -58,6 +68,12 @@ export const clientLogicsComments = Object.freeze({
58
68
  "Prime Client Logics," /* $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#KINDSCOMMA */,
59
69
  kindsPeriod:
60
70
  "Prime Client Logics." /* $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#KINDSPERIOD */,
71
+ kindsSimple:
72
+ "AGNOSTIC20#USE_CLIENT_LOGICS#KINDS" /* $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#KINDSSIMPLE */,
73
+ module:
74
+ "$COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#MODULE */,
75
+ moduleSimple:
76
+ "AGNOSTIC20#USE_CLIENT_LOGICS#MODULE" /* $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#MODULESIMPLE */,
61
77
  importingAModule:
62
78
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#IMPORTINGAMODULE */,
63
79
  importingByAFolder:
@@ -66,6 +82,10 @@ export const clientLogicsComments = Object.freeze({
66
82
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGYPERIOD" /* $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#IMPORTINGVIASTRATEGY */,
67
83
  importingViaStrategyByAFolder:
68
84
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGY $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#IMPORTINGVIASTRATEGYBYAFOLDER */,
85
+ directive:
86
+ "AGNOSTIC20#USE_CLIENT_LOGICS#DIRECTIVE" /* $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#DIRECTIVE */,
87
+ atStrategy:
88
+ "@clientLogics" /* $COMMENT#DIRECTIVE21#USE_CLIENT_LOGICS#ATSTRATEGY */,
69
89
  });
70
90
 
71
91
  export const agnosticLogicsComments = Object.freeze({
@@ -93,6 +113,12 @@ export const agnosticLogicsComments = Object.freeze({
93
113
  "Prime Agnostic Logics," /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#KINDSCOMMA */,
94
114
  kindsPeriod:
95
115
  "Prime Agnostic Logics." /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#KINDSPERIOD */,
116
+ kindsSimple:
117
+ "AGNOSTIC20#USE_AGNOSTIC_LOGICS#KINDS" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#KINDSSIMPLE */,
118
+ module:
119
+ "$COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#MODULE */,
120
+ moduleSimple:
121
+ "AGNOSTIC20#USE_AGNOSTIC_LOGICS#MODULE" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#MODULESIMPLE */,
96
122
  importingAModule:
97
123
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#IMPORTINGAMODULE */,
98
124
  importingByAFolder:
@@ -101,6 +127,10 @@ export const agnosticLogicsComments = Object.freeze({
101
127
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGYPERIOD" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#IMPORTINGVIASTRATEGY */,
102
128
  importingViaStrategyByAFolder:
103
129
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGY $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#IMPORTINGVIASTRATEGYBYAFOLDER */,
130
+ directive:
131
+ "AGNOSTIC20#USE_AGNOSTIC_LOGICS#DIRECTIVE" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#DIRECTIVE */,
132
+ atStrategy:
133
+ "@agnosticLogics" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_LOGICS#ATSTRATEGY */,
104
134
  });
105
135
 
106
136
  export const serverComponentsComments = Object.freeze({
@@ -128,6 +158,12 @@ export const serverComponentsComments = Object.freeze({
128
158
  "Lineal Server Components," /* $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#KINDSCOMMA */,
129
159
  kindsPeriod:
130
160
  "Lineal Server Components." /* $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#KINDSPERIOD */,
161
+ kindsSimple:
162
+ "AGNOSTIC20#USE_SERVER_COMPONENTS#KINDS" /* $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#KINDSSIMPLE */,
163
+ module:
164
+ "$COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#MODULE */,
165
+ moduleSimple:
166
+ "AGNOSTIC20#USE_SERVER_COMPONENTS#MODULE" /* $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#MODULESIMPLE */,
131
167
  importingAModule:
132
168
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#IMPORTINGAMODULE */,
133
169
  importingByAFolder:
@@ -136,6 +172,10 @@ export const serverComponentsComments = Object.freeze({
136
172
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGYPERIOD" /* $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#IMPORTINGVIASTRATEGY */,
137
173
  importingViaStrategyByAFolder:
138
174
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGY $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#IMPORTINGVIASTRATEGYBYAFOLDER */,
175
+ directive:
176
+ "AGNOSTIC20#USE_SERVER_COMPONENTS#DIRECTIVE" /* $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#DIRECTIVE */,
177
+ atStrategy:
178
+ "@serverComponents" /* $COMMENT#DIRECTIVE21#USE_SERVER_COMPONENTS#ATSTRATEGY */,
139
179
  });
140
180
 
141
181
  export const clientComponentsComments = Object.freeze({
@@ -157,16 +197,20 @@ export const clientComponentsComments = Object.freeze({
157
197
  /* valid */ "(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 grandchildren of an ancestor Lineal Client Component, enforcing them to render exclusively on the client." /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#USE_CLIENT_CONTEXTS */,
158
198
  "use agnostic conditions":
159
199
  /* valid */ "$COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#SPECIALSCOMMA $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#ASIFLINEALAGNOSTIC $COMMENT#DIRECTIVE21#FORCOMPOSEDVARIABLES#RENDERCLIENTLIKESERVER" /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#USE_AGNOSTIC_CONDITIONS */,
160
- module:
161
- "Lineal Client Components Module" /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#MODULE */,
162
- modulePeriod:
163
- "Lineal Client Components Module." /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#MODULEPERIOD */,
164
200
  kinds:
165
201
  "Lineal Client Components" /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#KINDS */,
166
202
  kindsComma:
167
203
  "Lineal Client Components," /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#KINDSCOMMA */,
168
204
  kindsPeriod:
169
205
  "Lineal Client Components." /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#KINDSPERIOD */,
206
+ kindsSimple:
207
+ "AGNOSTIC20#USE_CLIENT_COMPONENTS#KINDS" /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#KINDSSIMPLE */,
208
+ module:
209
+ "Lineal Client Components Module" /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#MODULE */,
210
+ modulePeriod:
211
+ "Lineal Client Components Module." /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#MODULEPERIOD */,
212
+ moduleSimple:
213
+ "AGNOSTIC20#USE_CLIENT_COMPONENTS#MODULE" /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#MODULESIMPLE */,
170
214
  importingAModule:
171
215
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#IMPORTINGAMODULE */,
172
216
  importingByAFolder:
@@ -175,6 +219,10 @@ export const clientComponentsComments = Object.freeze({
175
219
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGYPERIOD" /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#IMPORTINGVIASTRATEGY */,
176
220
  importingViaStrategyByAFolder:
177
221
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGY $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#IMPORTINGVIASTRATEGYBYAFOLDER */,
222
+ directive:
223
+ "AGNOSTIC20#USE_CLIENT_COMPONENTS#DIRECTIVE" /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#DIRECTIVE */,
224
+ atStrategy:
225
+ "@clientComponents" /* $COMMENT#DIRECTIVE21#USE_CLIENT_COMPONENTS#ATSTRATEGY */,
178
226
  });
179
227
 
180
228
  export const agnosticComponentsComments = Object.freeze({
@@ -202,6 +250,12 @@ export const agnosticComponentsComments = Object.freeze({
202
250
  "Lineal Agnostic Components," /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#KINDSCOMMA */,
203
251
  kindsPeriod:
204
252
  "Lineal Agnostic Components." /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#KINDSPERIOD */,
253
+ kindsSimple:
254
+ "AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#KINDS" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#KINDSSIMPLE */,
255
+ module:
256
+ "$COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#MODULE */,
257
+ moduleSimple:
258
+ "AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#MODULE" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#MODULESIMPLE */,
205
259
  importingAModule:
206
260
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTINGA $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULEPERIOD" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#IMPORTINGAMODULE */,
207
261
  importingByAFolder:
@@ -210,6 +264,10 @@ export const agnosticComponentsComments = Object.freeze({
210
264
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGYPERIOD" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#IMPORTINGVIASTRATEGY */,
211
265
  importingViaStrategyByAFolder:
212
266
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGY $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#IMPORTINGVIASTRATEGYBYAFOLDER */,
267
+ directive:
268
+ "AGNOSTIC20#USE_AGNOSTIC_COMPONENTS#DIRECTIVE" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#DIRECTIVE */,
269
+ atStrategy:
270
+ "@agnosticComponents" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_COMPONENTS#ATSTRATEGY */,
213
271
  });
214
272
 
215
273
  export const serverFunctionsComments = Object.freeze({
@@ -237,6 +295,12 @@ export const serverFunctionsComments = Object.freeze({
237
295
  "Special Server Functions," /* $COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#KINDSCOMMA */,
238
296
  kindsPeriod:
239
297
  "Special Server Functions." /* $COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#KINDSPERIOD */,
298
+ kindsSimple:
299
+ "AGNOSTIC20#USE_SERVER_FUNCTIONS#KINDS" /* $COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#KINDSSIMPLE */,
300
+ module:
301
+ "$COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#MODULE */,
302
+ moduleSimple:
303
+ "AGNOSTIC20#USE_SERVER_FUNCTIONS#MODULE" /* $COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#MODULESIMPLE */,
240
304
  specials:
241
305
  "(Special) Server Functions" /* $COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#SPECIALS */,
242
306
  specialsComma:
@@ -251,6 +315,10 @@ export const serverFunctionsComments = Object.freeze({
251
315
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#SPECIALS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGYPERIOD" /* $COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#IMPORTINGVIASTRATEGY */,
252
316
  importingViaStrategyByAFolder:
253
317
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#SPECIALS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGY $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#IMPORTINGVIASTRATEGYBYAFOLDER */,
318
+ directive:
319
+ "AGNOSTIC20#USE_SERVER_FUNCTIONS#DIRECTIVE" /* $COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#DIRECTIVE */,
320
+ atStrategy:
321
+ "@serverFunctions" /* $COMMENT#DIRECTIVE21#USE_SERVER_FUNCTIONS#ATSTRATEGY */,
254
322
  });
255
323
 
256
324
  export const clientContextsComments = Object.freeze({
@@ -278,6 +346,12 @@ export const clientContextsComments = Object.freeze({
278
346
  "Special Client Contexts," /* $COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#KINDSCOMMA */,
279
347
  kindsPeriod:
280
348
  "Special Client Contexts." /* $COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#KINDSPERIOD */,
349
+ kindsSimple:
350
+ "Client Contexts" /* $COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#KINDSSIMPLE */,
351
+ module:
352
+ "$COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#MODULE */,
353
+ moduleSimple:
354
+ "$COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#KINDSSIMPLE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#MODULESIMPLE */,
281
355
  specials:
282
356
  "(Special) Client Contexts Components" /* $COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#SPECIALS */,
283
357
  specialsComma:
@@ -292,6 +366,10 @@ export const clientContextsComments = Object.freeze({
292
366
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#SPECIALS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGYPERIOD" /* $COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#IMPORTINGVIASTRATEGY */,
293
367
  importingViaStrategyByAFolder:
294
368
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#SPECIALS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGY $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#IMPORTINGVIASTRATEGYBYAFOLDER */,
369
+ directive:
370
+ "use client contexts" /* $COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#DIRECTIVE */,
371
+ atStrategy:
372
+ "@clientContexts" /* $COMMENT#DIRECTIVE21#USE_CLIENT_CONTEXTS#ATSTRATEGY */,
295
373
  });
296
374
 
297
375
  export const agnosticConditionsComments = Object.freeze({
@@ -319,6 +397,12 @@ export const agnosticConditionsComments = Object.freeze({
319
397
  "Special Agnostic Conditions," /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#KINDSCOMMA */,
320
398
  kindsPeriod:
321
399
  "Special Agnostic Conditions." /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#KINDSPERIOD */,
400
+ kindsSimple:
401
+ "Agnostic Conditions" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#KINDSSIMPLE */,
402
+ module:
403
+ "$COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#MODULE */,
404
+ moduleSimple:
405
+ "$COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#KINDSSIMPLE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#MODULESIMPLE */,
322
406
  specials:
323
407
  "(Special) Agnostic Conditions Components" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#SPECIALS */,
324
408
  specialsComma:
@@ -333,6 +417,10 @@ export const agnosticConditionsComments = Object.freeze({
333
417
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#SPECIALS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGYPERIOD" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#IMPORTINGVIASTRATEGY */,
334
418
  importingViaStrategyByAFolder:
335
419
  "$COMMENT#TESTS#FORCOMPOSEDVARIABLES#IMPORTING $COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#SPECIALS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#VIASTRATEGY $COMMENT#TESTS#FORCOMPOSEDVARIABLES#BYFOLDER" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#IMPORTINGVIASTRATEGYBYAFOLDER */,
420
+ directive:
421
+ "use agnostic conditions" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#DIRECTIVE */,
422
+ atStrategy:
423
+ "@agnosticConditions" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_CONDITIONS#ATSTRATEGY */,
336
424
  });
337
425
 
338
426
  export const agnosticStrategiesComments = Object.freeze({
@@ -344,10 +432,18 @@ export const agnosticStrategiesComments = Object.freeze({
344
432
  "Special Agnostic Strategies," /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_STRATEGIES#KINDSCOMMA */,
345
433
  kindsPeriod:
346
434
  "Special Agnostic Strategies." /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_STRATEGIES#KINDSPERIOD */,
435
+ kindsSimple:
436
+ "Agnostic Strategies" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_STRATEGIES#KINDSSIMPLE */,
437
+ module:
438
+ "$COMMENT#DIRECTIVE21#USE_AGNOSTIC_STRATEGIES#KINDS $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_STRATEGIES#MODULE */,
439
+ moduleSimple:
440
+ "$COMMENT#DIRECTIVE21#USE_AGNOSTIC_STRATEGIES#KINDSSIMPLE $COMMENT#TESTS#FORCOMPOSEDVARIABLES#MODULE" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_STRATEGIES#MODULESIMPLE */,
347
441
  specials:
348
442
  "(Special) Agnostic Strategies" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_STRATEGIES#SPECIALS */,
349
443
  specialsComma:
350
444
  "(Special) Agnostic Strategies," /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_STRATEGIES#SPECIALSCOMMA */,
351
445
  specialsPeriod:
352
446
  "(Special) Agnostic Strategies." /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_STRATEGIES#SPECIALSPERIOD */,
447
+ directive:
448
+ "use agnostic strategies" /* $COMMENT#DIRECTIVE21#USE_AGNOSTIC_STRATEGIES#DIRECTIVE */,
353
449
  });
@@ -1,5 +1,7 @@
1
1
  import tseslint from "typescript-eslint";
2
2
 
3
+ import { commentVariablesData } from "../../../jscomments/_commons/constants/data.js";
4
+
3
5
  /**
4
6
  * @typedef {import('../../../types/_commons/typedefs').Extensions} Extensions
5
7
  * @typedef {import('../../../types/_commons/typedefs').LanguageOptions} LanguageOptions
@@ -53,31 +55,53 @@ export const exportNotStrategized =
53
55
  // - AIA: Agnostic-Included Architecture (agnostic20)
54
56
  // - DFA: Directive-First Architecture (directive21)
55
57
  // agnostic20
56
- export const USE_SERVER_LOGICS = "use server logics";
57
- export const USE_CLIENT_LOGICS = "use client logics";
58
- export const USE_AGNOSTIC_LOGICS = "use agnostic logics";
59
- export const USE_SERVER_COMPONENTS = "use server components";
60
- export const USE_CLIENT_COMPONENTS = "use client components";
61
- export const USE_AGNOSTIC_COMPONENTS = "use agnostic components";
62
- export const USE_SERVER_FUNCTIONS = "use server functions";
58
+ export const USE_SERVER_LOGICS =
59
+ commentVariablesData.agnostic20["use server logics"].directive.value;
60
+ export const USE_CLIENT_LOGICS =
61
+ commentVariablesData.agnostic20["use client logics"].directive.value;
62
+ export const USE_AGNOSTIC_LOGICS =
63
+ commentVariablesData.agnostic20["use agnostic logics"].directive.value;
64
+ export const USE_SERVER_COMPONENTS =
65
+ commentVariablesData.agnostic20["use server components"].directive.value;
66
+ export const USE_CLIENT_COMPONENTS =
67
+ commentVariablesData.agnostic20["use client components"].directive.value;
68
+ export const USE_AGNOSTIC_COMPONENTS =
69
+ commentVariablesData.agnostic20["use agnostic components"].directive.value;
70
+ export const USE_SERVER_FUNCTIONS =
71
+ commentVariablesData.agnostic20["use server functions"].directive.value;
63
72
  // and directive21
64
- export const USE_CLIENT_CONTEXTS = "use client contexts";
65
- export const USE_AGNOSTIC_CONDITIONS = "use agnostic conditions";
66
- export const USE_AGNOSTIC_STRATEGIES = "use agnostic strategies";
73
+ export const USE_CLIENT_CONTEXTS =
74
+ commentVariablesData.directive21["use client contexts"].directive.value;
75
+ export const USE_AGNOSTIC_CONDITIONS =
76
+ commentVariablesData.directive21["use agnostic conditions"].directive.value;
77
+ export const USE_AGNOSTIC_STRATEGIES =
78
+ commentVariablesData.directive21["use agnostic strategies"].directive.value;
67
79
 
68
80
  // all "resolved" modules (from AIA/agnostic20 & DFA/directive21)
69
81
  // agnostic20
70
- export const SERVER_LOGICS_MODULE = "Server Logics Module";
71
- export const CLIENT_LOGICS_MODULE = "Client Logics Module";
72
- export const AGNOSTIC_LOGICS_MODULE = "Agnostic Logics Module";
73
- export const SERVER_COMPONENTS_MODULE = "Server Components Module";
74
- export const CLIENT_COMPONENTS_MODULE = "Client Components Module";
75
- export const AGNOSTIC_COMPONENTS_MODULE = "Agnostic Components Module";
76
- export const SERVER_FUNCTIONS_MODULE = "Server Functions Module";
82
+ export const SERVER_LOGICS_MODULE =
83
+ commentVariablesData.agnostic20["use server logics"].module.value;
84
+ export const CLIENT_LOGICS_MODULE =
85
+ commentVariablesData.agnostic20["use client logics"].module.value;
86
+ export const AGNOSTIC_LOGICS_MODULE =
87
+ commentVariablesData.agnostic20["use agnostic logics"].module.value;
88
+ export const SERVER_COMPONENTS_MODULE =
89
+ commentVariablesData.agnostic20["use server components"].module.value;
90
+ export const CLIENT_COMPONENTS_MODULE =
91
+ commentVariablesData.agnostic20["use client components"].module.value;
92
+ export const AGNOSTIC_COMPONENTS_MODULE =
93
+ commentVariablesData.agnostic20["use agnostic components"].module.value;
94
+ export const SERVER_FUNCTIONS_MODULE =
95
+ commentVariablesData.agnostic20["use server functions"].module.value;
77
96
  // and directive21
78
- export const CLIENT_CONTEXTS_MODULE = "Client Contexts Module";
79
- export const AGNOSTIC_CONDITIONS_MODULE = "Agnostic Conditions Module";
80
- export const AGNOSTIC_STRATEGIES_MODULE = "Agnostic Strategies Module";
97
+ export const CLIENT_CONTEXTS_MODULE =
98
+ commentVariablesData.directive21["use client contexts"].moduleSimple.value;
99
+ export const AGNOSTIC_CONDITIONS_MODULE =
100
+ commentVariablesData.directive21["use agnostic conditions"].moduleSimple
101
+ .value;
102
+ export const AGNOSTIC_STRATEGIES_MODULE =
103
+ commentVariablesData.directive21["use agnostic strategies"].moduleSimple
104
+ .value;
81
105
 
82
106
  // all mappings of "resolved" directives with "resolved" modules
83
107
  // agnostic20
@@ -11,7 +11,6 @@ import {
11
11
 
12
12
  import { makeIntroForSpecificViolationMessage } from "../../../_commons/utilities/helpers.js";
13
13
 
14
- // import { resolvedConfigData } from "../../../../jscomments/_commons/constants/bases.js";
15
14
  import { commentVariablesData } from "../../../../jscomments/_commons/constants/data.js";
16
15
 
17
16
  /**
@@ -14,7 +14,6 @@ import {
14
14
 
15
15
  import { makeIntroForSpecificViolationMessage } from "../../../_commons/utilities/helpers.js";
16
16
 
17
- // import { resolvedConfigData } from "../../../../jscomments/_commons/constants/bases.js";
18
17
  import { commentVariablesData } from "../../../../jscomments/_commons/constants/data.js";
19
18
 
20
19
  /**
@@ -74,15 +73,24 @@ export const commentedDirectives_extensionRules = Object.freeze({
74
73
  });
75
74
 
76
75
  // commented strategies
77
- export const AT_SERVER_LOGICS = "@serverLogics";
78
- export const AT_CLIENT_LOGICS = "@clientLogics";
79
- export const AT_AGNOSTIC_LOGICS = "@agnosticLogics";
80
- export const AT_SERVER_COMPONENTS = "@serverComponents";
81
- export const AT_CLIENT_COMPONENTS = "@clientComponents";
82
- export const AT_AGNOSTIC_COMPONENTS = "@agnosticComponents";
83
- export const AT_SERVER_FUNCTIONS = "@serverFunctions";
84
- export const AT_CLIENT_CONTEXTS = "@clientContexts";
85
- export const AT_AGNOSTIC_CONDITIONS = "@agnosticConditions";
76
+ export const AT_SERVER_LOGICS =
77
+ commentVariablesData.directive21["use server logics"].atStrategy.value;
78
+ export const AT_CLIENT_LOGICS =
79
+ commentVariablesData.directive21["use client logics"].atStrategy.value;
80
+ export const AT_AGNOSTIC_LOGICS =
81
+ commentVariablesData.directive21["use agnostic logics"].atStrategy.value;
82
+ export const AT_SERVER_COMPONENTS =
83
+ commentVariablesData.directive21["use server components"].atStrategy.value;
84
+ export const AT_CLIENT_COMPONENTS =
85
+ commentVariablesData.directive21["use client components"].atStrategy.value;
86
+ export const AT_AGNOSTIC_COMPONENTS =
87
+ commentVariablesData.directive21["use agnostic components"].atStrategy.value;
88
+ export const AT_SERVER_FUNCTIONS =
89
+ commentVariablesData.directive21["use server functions"].atStrategy.value;
90
+ export const AT_CLIENT_CONTEXTS =
91
+ commentVariablesData.directive21["use client contexts"].atStrategy.value;
92
+ export const AT_AGNOSTIC_CONDITIONS =
93
+ commentVariablesData.directive21["use agnostic conditions"].atStrategy.value;
86
94
 
87
95
  // commented strategies array
88
96
  /** @type {CommentedStrategies} */
@@ -140,7 +148,8 @@ export const commentedDirectives_verificationReports = Object.freeze({
140
148
  [USE_SERVER_FUNCTIONS]: `${MODULES_MARKED_WITH_THE_} "${USE_SERVER_FUNCTIONS}" ${_DIRECTIVE_MUST_HAVE_A_NON_JSX_FILE_EXTENSION}.`,
141
149
  [USE_CLIENT_CONTEXTS]: `${MODULES_MARKED_WITH_THE_} "${USE_CLIENT_CONTEXTS}" ${_DIRECTIVE_MUST_HAVE_A_JSX_FILE_EXTENSION}.`,
142
150
  [USE_AGNOSTIC_CONDITIONS]: `${MODULES_MARKED_WITH_THE_} "${USE_AGNOSTIC_CONDITIONS}" ${_DIRECTIVE_MUST_HAVE_A_JSX_FILE_EXTENSION}.`,
143
- [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.)`,
151
+ // [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.)`,
152
+ [USE_AGNOSTIC_STRATEGIES]: `${MODULES_MARKED_WITH_THE_} "${USE_AGNOSTIC_STRATEGIES}" ${_DIRECTIVE_MUST_HAVE_A_JSX_FILE_EXTENSION}.`,
144
153
  });
145
154
 
146
155
  /* commentedDirectives_blockedImports */
package/library/index.js CHANGED
@@ -48,6 +48,8 @@ export {
48
48
 
49
49
  // NEW: eslint-plugin-use-agnostic is effectively the premier implementation of the Directive-First Architecture. As such, the following imports are to access its constants and utilities across other implementations of the Directive-First Architecture, such as eXtra JSX.
50
50
 
51
+ export { EXTENSIONS } from "./_commons/constants/bases.js";
52
+
51
53
  // agnostic20
52
54
 
53
55
  export {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "eslint-plugin-use-agnostic",
3
- "version": "1.5.1",
3
+ "version": "1.6.1",
4
4
  "description": "Highlights problematic server-client imports in projects made with the Fullstack React Architecture.",
5
5
  "keywords": [
6
6
  "eslint",
package/types/index.d.ts CHANGED
@@ -18,6 +18,22 @@ export const enforceCommentedDirectivesRuleName: "enforce-commented-directives-i
18
18
 
19
19
  // NEW
20
20
 
21
+ // JavaScript/TypeScript extensions array
22
+ export const EXTENSIONS: readonly [
23
+ ".tsx",
24
+ ".ts",
25
+ ".mtsx",
26
+ ".mts",
27
+ ".ctsx",
28
+ ".cts",
29
+ ".jsx",
30
+ ".js",
31
+ ".mjsx",
32
+ ".mjs",
33
+ ".cjsx",
34
+ ".cjs"
35
+ ];
36
+
21
37
  // agnostic20
22
38
 
23
39
  // directives
@@ -1,24 +0,0 @@
1
- // now obsolete
2
-
3
- import url from "url";
4
- import path from "path";
5
-
6
- import { createRequire } from "module";
7
- const require = createRequire(import.meta.url);
8
-
9
- // // (Only useful during development.)
10
- // const resolvedConfigDataForType = await import("../../../comments.config.json");
11
-
12
- const filename = url.fileURLToPath(import.meta.url);
13
- const dirname = path.dirname(filename);
14
-
15
- const rawPath = path.join(dirname, "../../../comments.config.json");
16
-
17
- // /** @type {typeof resolvedConfigDataForType.default} (The `default` property on `resolvedConfigDataForType` – and I assume on `raw` itself – is a copy of the whole thing, naturally not including the `default` property recursively. Though `.default` here is unnecessary and technically untrue, it allows the inferred type to look better.) */
18
- const raw = require(rawPath);
19
- export const resolvedConfigData = raw;
20
-
21
- /* Notes
22
- We're actually not supposed to install comment-variables-resolve-config. What's supposed to happen is that the resolved config data should be made and consumed as a JSON either via a command in the CLI or automatically on save by the VS Code extension.
23
- For the CLI, the decision has been taken to automatically create the JSON every time the CLI is successfully run with any command. For the plugin, that's on every save connected to the config file.
24
- */