@starci/eslint-canon-fe 9.5.23 → 9.6.2

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.
Files changed (164) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/docs/button-intent.md +1 -1
  3. package/package.json +1 -1
  4. package/runtime/bundle.json +192 -0
  5. package/runtime/engine/by-code-unit.mjs +6 -6
  6. package/runtime/engine/model-config.mjs +98 -76
  7. package/runtime/engine/orca-config.mjs +22 -17
  8. package/runtime/engine/release-config.mjs +22 -18
  9. package/runtime/engine/removed-vocabulary.mjs +21 -20
  10. package/runtime/engine/resources-config.mjs +42 -35
  11. package/runtime/engine/runtime-root.mjs +11 -13
  12. package/runtime/engine/secrets.mjs +170 -102
  13. package/runtime/engine/sonar-config.mjs +16 -13
  14. package/runtime/engine/temp-root.mjs +3 -9
  15. package/runtime/knowledge/hfs/canon-pins.yaml +10 -10
  16. package/runtime/knowledge/hfs/slots.yaml +2 -2
  17. package/runtime/knowledge/sonar-gate.yaml +1 -1
  18. package/runtime/packages/hfs/templates/app/package-scripts/package.json +1 -1
  19. package/runtime/scripts/api/git/cat-file.mjs +0 -1
  20. package/runtime/scripts/api/git/config-get.mjs +1 -2
  21. package/runtime/scripts/api/git/diff.mjs +0 -1
  22. package/runtime/scripts/api/git/lib.mjs +32 -32
  23. package/runtime/scripts/api/git/ls-files.mjs +0 -1
  24. package/runtime/scripts/api/git/ls-tree.mjs +0 -1
  25. package/runtime/scripts/api/git/merge-base.mjs +2 -3
  26. package/runtime/scripts/api/git/remote.mjs +0 -1
  27. package/runtime/scripts/api/git/rev-parse-query.mjs +0 -1
  28. package/runtime/scripts/api/git/show.mjs +0 -1
  29. package/runtime/scripts/hfs/allows.mjs +37 -38
  30. package/runtime/scripts/hfs/architecture/ast-walks.mjs +180 -163
  31. package/runtime/scripts/hfs/architecture/automatic-gates.mjs +80 -73
  32. package/runtime/scripts/hfs/architecture/backend-app-files.mjs +88 -77
  33. package/runtime/scripts/hfs/architecture/backend.mjs +378 -357
  34. package/runtime/scripts/hfs/architecture/background-unowned.mjs +201 -187
  35. package/runtime/scripts/hfs/architecture/canon-clones.mjs +260 -209
  36. package/runtime/scripts/hfs/architecture/canon-jsx-clones.mjs +149 -116
  37. package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +72 -68
  38. package/runtime/scripts/hfs/architecture/clones.mjs +212 -217
  39. package/runtime/scripts/hfs/architecture/config-unread.mjs +7 -9
  40. package/runtime/scripts/hfs/architecture/config.mjs +302 -268
  41. package/runtime/scripts/hfs/architecture/connection-map.mjs +258 -225
  42. package/runtime/scripts/hfs/architecture/constructor-deps.mjs +80 -71
  43. package/runtime/scripts/hfs/architecture/context-coupling.mjs +82 -77
  44. package/runtime/scripts/hfs/architecture/context-map.mjs +267 -234
  45. package/runtime/scripts/hfs/architecture/context-owner.mjs +73 -61
  46. package/runtime/scripts/hfs/architecture/context-platform-tables.mjs +47 -43
  47. package/runtime/scripts/hfs/architecture/context-transaction.mjs +54 -52
  48. package/runtime/scripts/hfs/architecture/contract-fixture-guard.mjs +113 -104
  49. package/runtime/scripts/hfs/architecture/contracts-readonly.mjs +288 -270
  50. package/runtime/scripts/hfs/architecture/contracts.mjs +408 -393
  51. package/runtime/scripts/hfs/architecture/cross-app-duplicate.mjs +50 -51
  52. package/runtime/scripts/hfs/architecture/dead-exports-bindings.mjs +143 -119
  53. package/runtime/scripts/hfs/architecture/dead-exports.mjs +286 -228
  54. package/runtime/scripts/hfs/architecture/default-deny.mjs +129 -110
  55. package/runtime/scripts/hfs/architecture/doc-language.mjs +24 -19
  56. package/runtime/scripts/hfs/architecture/entity-registry.mjs +20 -22
  57. package/runtime/scripts/hfs/architecture/entrypoint.mjs +47 -45
  58. package/runtime/scripts/hfs/architecture/error-codes.mjs +37 -35
  59. package/runtime/scripts/hfs/architecture/error-masked.mjs +55 -59
  60. package/runtime/scripts/hfs/architecture/fe-slot-allows.mjs +24 -23
  61. package/runtime/scripts/hfs/architecture/feature-shape.mjs +40 -38
  62. package/runtime/scripts/hfs/architecture/framework-pinned.mjs +21 -21
  63. package/runtime/scripts/hfs/architecture/frontend-block-render.mjs +106 -98
  64. package/runtime/scripts/hfs/architecture/frontend-grammar.mjs +153 -150
  65. package/runtime/scripts/hfs/architecture/frontend-routing.mjs +161 -149
  66. package/runtime/scripts/hfs/architecture/frontend-world-render.mjs +343 -305
  67. package/runtime/scripts/hfs/architecture/frontend-world.mjs +340 -294
  68. package/runtime/scripts/hfs/architecture/frontend.mjs +174 -184
  69. package/runtime/scripts/hfs/architecture/function-spec-providers.mjs +124 -106
  70. package/runtime/scripts/hfs/architecture/hfs-graph.mjs +52 -48
  71. package/runtime/scripts/hfs/architecture/hooks-are-hooks.mjs +81 -71
  72. package/runtime/scripts/hfs/architecture/i18n-keys.mjs +155 -141
  73. package/runtime/scripts/hfs/architecture/identity.mjs +141 -125
  74. package/runtime/scripts/hfs/architecture/index.mjs +272 -272
  75. package/runtime/scripts/hfs/architecture/injection-token-exported.mjs +45 -43
  76. package/runtime/scripts/hfs/architecture/jwt-ast.mjs +195 -176
  77. package/runtime/scripts/hfs/architecture/machine-ast.mjs +163 -155
  78. package/runtime/scripts/hfs/architecture/managed-scripts.mjs +19 -20
  79. package/runtime/scripts/hfs/architecture/module-per-transport.mjs +177 -172
  80. package/runtime/scripts/hfs/architecture/next-data-contract.mjs +100 -78
  81. package/runtime/scripts/hfs/architecture/next-data-inference.mjs +170 -154
  82. package/runtime/scripts/hfs/architecture/next-data-key.mjs +311 -275
  83. package/runtime/scripts/hfs/architecture/next-data-symbols.mjs +17 -17
  84. package/runtime/scripts/hfs/architecture/next-data.mjs +351 -334
  85. package/runtime/scripts/hfs/architecture/operation-contract-roots.mjs +39 -37
  86. package/runtime/scripts/hfs/architecture/owners.mjs +97 -98
  87. package/runtime/scripts/hfs/architecture/package-shape.mjs +56 -55
  88. package/runtime/scripts/hfs/architecture/presentation.mjs +138 -130
  89. package/runtime/scripts/hfs/architecture/reachability.mjs +258 -241
  90. package/runtime/scripts/hfs/architecture/register-once.mjs +152 -139
  91. package/runtime/scripts/hfs/architecture/registration.mjs +301 -267
  92. package/runtime/scripts/hfs/architecture/required-files.mjs +172 -167
  93. package/runtime/scripts/hfs/architecture/route-files-thin.mjs +85 -77
  94. package/runtime/scripts/hfs/architecture/schema-owner.mjs +206 -181
  95. package/runtime/scripts/hfs/architecture/server-action.mjs +48 -48
  96. package/runtime/scripts/hfs/architecture/side-boundary.mjs +2 -5
  97. package/runtime/scripts/hfs/architecture/source-names-shape.mjs +261 -259
  98. package/runtime/scripts/hfs/architecture/source-names.mjs +304 -278
  99. package/runtime/scripts/hfs/architecture/sql-keys.mjs +277 -194
  100. package/runtime/scripts/hfs/architecture/sql-owner.mjs +236 -194
  101. package/runtime/scripts/hfs/architecture/sql-returning.mjs +46 -45
  102. package/runtime/scripts/hfs/architecture/sql-token-forms.mjs +86 -74
  103. package/runtime/scripts/hfs/architecture/sql-tokens.mjs +456 -341
  104. package/runtime/scripts/hfs/architecture/staged-consumers.mjs +35 -30
  105. package/runtime/scripts/hfs/architecture/surface.mjs +64 -74
  106. package/runtime/scripts/hfs/architecture/symbols.mjs +209 -216
  107. package/runtime/scripts/hfs/architecture/test-world-files.mjs +165 -155
  108. package/runtime/scripts/hfs/architecture/tiers.mjs +161 -154
  109. package/runtime/scripts/hfs/architecture/transport-owner.mjs +155 -149
  110. package/runtime/scripts/hfs/architecture/type-context.mjs +255 -250
  111. package/runtime/scripts/hfs/architecture/typescript.mjs +358 -318
  112. package/runtime/scripts/hfs/architecture/unit-spec-providers.mjs +110 -92
  113. package/runtime/scripts/hfs/declaration-shape.mjs +140 -103
  114. package/runtime/scripts/hfs/declaration-slots.mjs +64 -61
  115. package/runtime/scripts/hfs/edition-slots.mjs +43 -40
  116. package/runtime/scripts/hfs/linear-text.mjs +20 -20
  117. package/runtime/scripts/hfs/param-names.mjs +6 -11
  118. package/runtime/scripts/hfs/path-findings.mjs +120 -100
  119. package/runtime/scripts/hfs/repo-identity.mjs +55 -42
  120. package/runtime/scripts/hfs/rule-catalog.mjs +353 -257
  121. package/runtime/scripts/hfs/rule-params-shape.mjs +60 -47
  122. package/runtime/scripts/hfs/rules/database-migrations.mjs +428 -388
  123. package/runtime/scripts/hfs/rules/fe-no-tests.mjs +37 -36
  124. package/runtime/scripts/hfs/rules/read.mjs +19 -15
  125. package/runtime/scripts/hfs/rules/secrets.mjs +1 -1
  126. package/runtime/scripts/hfs/rules/spec-placement.mjs +12 -13
  127. package/runtime/scripts/hfs/slot-app-view.mjs +69 -74
  128. package/runtime/scripts/hfs/slot-classify.mjs +42 -38
  129. package/runtime/scripts/hfs/slot-errors.mjs +8 -7
  130. package/runtime/scripts/hfs/slot-imports.mjs +70 -63
  131. package/runtime/scripts/hfs/slot-manifest-shape.mjs +74 -52
  132. package/runtime/scripts/hfs/slot-match.mjs +122 -111
  133. package/runtime/scripts/hfs/slot-path.mjs +0 -2
  134. package/runtime/scripts/hfs/slot-required.mjs +65 -59
  135. package/runtime/scripts/hfs/slot-semantic-problems.mjs +138 -112
  136. package/runtime/scripts/hfs/slot-side-problems.mjs +23 -19
  137. package/runtime/scripts/hfs/slots.mjs +175 -152
  138. package/runtime/scripts/hfs/test-world-slot.mjs +0 -1
  139. package/runtime/scripts/hfs/trailing-slashes.mjs +4 -4
  140. package/runtime/scripts/hfs/typescript-programs.mjs +66 -69
  141. package/runtime/scripts/hfs/view.mjs +38 -40
  142. package/runtime/scripts/lib/dockerfile.mjs +131 -114
  143. package/runtime/scripts/lib/env.mjs +3 -6
  144. package/runtime/scripts/lib/event-contract.mjs +73 -78
  145. package/runtime/scripts/lib/git.mjs +15 -16
  146. package/runtime/scripts/lib/glob.mjs +23 -14
  147. package/runtime/scripts/lib/grammar-lint.mjs +33 -37
  148. package/runtime/scripts/lib/i18n.mjs +32 -35
  149. package/runtime/scripts/lib/in-order.mjs +57 -38
  150. package/runtime/scripts/lib/json-clone.mjs +45 -36
  151. package/runtime/scripts/lib/json.mjs +26 -14
  152. package/runtime/scripts/lib/language.mjs +133 -129
  153. package/runtime/scripts/lib/list.mjs +9 -14
  154. package/runtime/scripts/lib/mutation-fence.mjs +10 -5
  155. package/runtime/scripts/lib/path-key.mjs +53 -38
  156. package/runtime/scripts/lib/read-text.mjs +30 -17
  157. package/runtime/scripts/lib/regex.mjs +1 -2
  158. package/runtime/scripts/lib/same-text.mjs +0 -1
  159. package/runtime/scripts/lib/sops-envelope.mjs +148 -120
  160. package/runtime/scripts/lib/stack-services.mjs +128 -129
  161. package/runtime/scripts/lib/ts-analysis.mjs +28 -26
  162. package/runtime/scripts/lib/ts-ast.mjs +36 -42
  163. package/runtime/scripts/lib/walk.mjs +33 -27
  164. package/runtime/scripts/lib/yaml-cached.mjs +4 -4
@@ -2,102 +2,113 @@ import path from 'node:path';
2
2
  import { allowsFile } from '../allows.mjs';
3
3
  import { relativePath, unwrapExpression } from './typescript.mjs';
4
4
  import { accessName, sourceLocation } from '../../lib/ts-ast.mjs';
5
-
6
5
  const PROCESS_MODULES = new Set(['process', 'node:process']);
7
6
  const PROCESS_GLOBAL = new Set(['process']);
8
7
  const GLOBAL_HOLDERS = new Set(['globalThis', 'global']);
9
8
  const REFLECT_GLOBAL = new Set(['Reflect']);
10
-
11
9
  function bindingName(ts, element) {
12
- const name = element.propertyName ?? element.name;
13
- if (ts.isIdentifier(name) || ts.isStringLiteralLike(name)) return name.text;
14
- return ts.isComputedPropertyName(name) && ts.isStringLiteralLike(name.expression) ? name.expression.text : null;
10
+ const name = element.propertyName ?? element.name;
11
+ if (ts.isIdentifier(name) || ts.isStringLiteralLike(name))
12
+ return name.text;
13
+ return ts.isComputedPropertyName(name) && ts.isStringLiteralLike(name.expression) ? name.expression.text : null;
15
14
  }
16
-
17
15
  /** A global name is not a same-named local variable or parameter. */
18
16
  function isGlobalName(ts, checker, node, names) {
19
- if (!ts.isIdentifier(node) || !names.has(node.text)) return false;
20
- const declarations = checker?.getSymbolAtLocation(node)?.getDeclarations() ?? [];
21
- return declarations.every(declaration => declaration.getSourceFile().isDeclarationFile);
17
+ if (!ts.isIdentifier(node) || !names.has(node.text))
18
+ return false;
19
+ const declarations = checker?.getSymbolAtLocation(node)?.getDeclarations() ?? [];
20
+ return declarations.every(declaration => declaration.getSourceFile().isDeclarationFile);
22
21
  }
23
-
24
22
  function recordProcessBindings(ts, clause, add, report) {
25
- if (clause?.name) add(clause.name);
26
- const bindings = clause?.namedBindings;
27
- if (bindings && ts.isNamespaceImport(bindings)) add(bindings.name);
28
- if (!bindings || !ts.isNamedImports(bindings)) return;
29
- for (const element of bindings.elements) {
30
- const name = (element.propertyName ?? element.name).text;
31
- if (name === 'env') report(element);
32
- else if (name === 'default') add(element.name);
33
- }
23
+ if (clause?.name)
24
+ add(clause.name);
25
+ const bindings = clause?.namedBindings;
26
+ if (bindings && ts.isNamespaceImport(bindings))
27
+ add(bindings.name);
28
+ if (!bindings || !ts.isNamedImports(bindings))
29
+ return;
30
+ for (const element of bindings.elements) {
31
+ const name = (element.propertyName ?? element.name).text;
32
+ if (name === 'env')
33
+ report(element);
34
+ else if (name === 'default')
35
+ add(element.name);
36
+ }
34
37
  }
35
-
36
38
  function processImportSymbols(ts, checker, sourceFile, report) {
37
- const imports = new Set();
38
- const add = name => {
39
- const symbol = checker.getSymbolAtLocation(name);
40
- if (symbol) imports.add(symbol);
41
- };
42
- for (const statement of sourceFile.statements) {
43
- if (!ts.isImportDeclaration(statement) || !ts.isStringLiteralLike(statement.moduleSpecifier)
44
- || !PROCESS_MODULES.has(statement.moduleSpecifier.text)) continue;
45
- recordProcessBindings(ts, statement.importClause, add, report);
46
- }
47
- return imports;
39
+ const imports = new Set();
40
+ const add = (name) => {
41
+ const symbol = checker.getSymbolAtLocation(name);
42
+ if (symbol)
43
+ imports.add(symbol);
44
+ };
45
+ for (const statement of sourceFile.statements) {
46
+ if (!ts.isImportDeclaration(statement) || !ts.isStringLiteralLike(statement.moduleSpecifier)
47
+ || !PROCESS_MODULES.has(statement.moduleSpecifier.text))
48
+ continue;
49
+ recordProcessBindings(ts, statement.importClause, add, report);
50
+ }
51
+ return imports;
48
52
  }
49
-
50
53
  /** Process bindings are resolved by symbol, so a nested parameter cannot masquerade as an imported process. */
51
54
  function processAccess(ts, checker, sourceFile, report) {
52
- const imports = processImportSymbols(ts, checker, sourceFile, report);
53
- const isProcess = expression => {
54
- const node = unwrapExpression(ts, expression);
55
- if (!node) return false;
56
- if (ts.isIdentifier(node)) return imports.has(checker.getSymbolAtLocation(node))
57
- || isGlobalName(ts, checker, node, PROCESS_GLOBAL);
58
- return accessName(ts, node) === 'process'
59
- && isGlobalName(ts, checker, node.expression, GLOBAL_HOLDERS);
60
- };
61
- return node => {
62
- if (accessName(ts, node) === 'env' && isProcess(node.expression)) report(node);
63
- if (ts.isVariableDeclaration(node) && node.initializer && isProcess(node.initializer) && ts.isObjectBindingPattern(node.name)
64
- && node.name.elements.some(element => bindingName(ts, element) === 'env')) report(node);
65
- if (ts.isCallExpression(node) && accessName(ts, node.expression) === 'get'
66
- && isGlobalName(ts, checker, node.expression.expression, REFLECT_GLOBAL)
67
- && isProcess(node.arguments[0]) && node.arguments[1] && ts.isStringLiteralLike(node.arguments[1]) && node.arguments[1].text === 'env') report(node);
68
- };
55
+ const imports = processImportSymbols(ts, checker, sourceFile, report);
56
+ const isProcess = (expression) => {
57
+ const node = unwrapExpression(ts, expression);
58
+ if (!node)
59
+ return false;
60
+ if (ts.isIdentifier(node)) {
61
+ const symbol = checker.getSymbolAtLocation(node);
62
+ return (symbol !== undefined && imports.has(symbol)) || isGlobalName(ts, checker, node, PROCESS_GLOBAL);
63
+ }
64
+ return accessName(ts, node) === 'process'
65
+ && isGlobalName(ts, checker, node.expression, GLOBAL_HOLDERS); // reason: accessName names only property and element accesses
66
+ };
67
+ return (node) => {
68
+ if (accessName(ts, node) === 'env' && isProcess(node.expression))
69
+ report(node); // reason: accessName names only property and element accesses
70
+ if (ts.isVariableDeclaration(node) && node.initializer && isProcess(node.initializer) && ts.isObjectBindingPattern(node.name)
71
+ && node.name.elements.some(element => bindingName(ts, element) === 'env'))
72
+ report(node);
73
+ if (ts.isCallExpression(node) && accessName(ts, node.expression) === 'get'
74
+ && isGlobalName(ts, checker, node.expression.expression, REFLECT_GLOBAL)
75
+ && isProcess(node.arguments[0]) && node.arguments[1] && ts.isStringLiteralLike(node.arguments[1]) && node.arguments[1].text === 'env')
76
+ report(node);
77
+ };
69
78
  }
70
-
71
79
  /** The declaration, rather than the caller's name, identifies EnvSource readers and configuration helpers. */
72
80
  function appEnvironmentCall(config, ts, checker, call) {
73
- const declaration = checker.getResolvedSignature(call)?.declaration;
74
- if (!declaration) return false;
75
- const relative = relativePath(config.root, declaration.getSourceFile().fileName);
76
- if (ts.isMethodDeclaration(declaration) && ts.isClassDeclaration(declaration.parent) && declaration.parent.name?.text === 'EnvSource') {
77
- return config.hfs.tierOf(relative) === 'platform' && path.posix.basename(config.hfs.ownerOf(relative)?.root ?? '') === 'config';
78
- }
79
- if (!ts.isFunctionDeclaration(declaration) && !ts.isArrowFunction(declaration) && !ts.isFunctionExpression(declaration)) return false;
80
- return allowsFile(config.hfs, relative)?.entry === '<app>.env.ts'
81
- || (path.posix.basename(relative).endsWith('.config.ts') && config.hfs.slotOf(relative) !== null);
81
+ const declaration = checker.getResolvedSignature(call)?.declaration;
82
+ if (!declaration)
83
+ return false;
84
+ const relative = relativePath(config.root, declaration.getSourceFile().fileName);
85
+ if (ts.isMethodDeclaration(declaration) && ts.isClassDeclaration(declaration.parent) && declaration.parent.name?.text === 'EnvSource') {
86
+ return config.hfs.tierOf(relative) === 'platform' && path.posix.basename(config.hfs.ownerOf(relative)?.root ?? '') === 'config';
87
+ }
88
+ if (!ts.isFunctionDeclaration(declaration) && !ts.isArrowFunction(declaration) && !ts.isFunctionExpression(declaration))
89
+ return false;
90
+ return allowsFile(config.hfs, relative)?.entry === '<app>.env.ts'
91
+ || (path.posix.basename(relative).endsWith('.config.ts') && config.hfs.slotOf(relative) !== null);
82
92
  }
83
-
84
93
  /** Composition groups and options consume parsed options; only the app's matching env role and main read them. */
85
94
  export function checkApplicationEnvironment(config, context, sourceFile, fileName, violations) {
86
- const role = allowsFile(config.hfs, relativePath(config.root, fileName));
87
- if (role?.allowed && (role.entry === 'main.ts' || role.entry === '<app>.env.ts')) return;
88
- const { ts } = context;
89
- const checker = context.checkerFor(fileName);
90
- const report = node => violations.push({
91
- ruleId: 'BE_APP_COMPOSITION_ONLY',
92
- path: relativePath(config.root, fileName),
93
- ...sourceLocation(sourceFile, node),
94
- message: "Application environment reads live in main.ts or the matching <app>.env.ts. Options files and compose/<area>.ts receive the typed result of read<App>Env(env: EnvSource).",
95
- });
96
- const checkProcess = processAccess(ts, checker, sourceFile, report);
97
- const visit = node => {
98
- checkProcess(node);
99
- if (ts.isCallExpression(node) && appEnvironmentCall(config, ts, checker, node)) report(node);
100
- ts.forEachChild(node, visit);
101
- };
102
- visit(sourceFile);
95
+ const role = allowsFile(config.hfs, relativePath(config.root, fileName));
96
+ if (role?.allowed && (role.entry === 'main.ts' || role.entry === '<app>.env.ts'))
97
+ return;
98
+ const { ts } = context;
99
+ const checker = context.checkerFor(fileName);
100
+ const report = node => violations.push({
101
+ ruleId: 'BE_APP_COMPOSITION_ONLY',
102
+ path: relativePath(config.root, fileName),
103
+ ...sourceLocation(sourceFile, node),
104
+ message: "Application environment reads live in main.ts or the matching <app>.env.ts. Options files and compose/<area>.ts receive the typed result of read<App>Env(env: EnvSource).",
105
+ });
106
+ const checkProcess = processAccess(ts, checker, sourceFile, report);
107
+ const visit = (node) => {
108
+ checkProcess(node);
109
+ if (ts.isCallExpression(node) && appEnvironmentCall(config, ts, checker, node))
110
+ report(node);
111
+ ts.forEachChild(node, visit);
112
+ };
113
+ visit(sourceFile);
103
114
  }