@starci/eslint-canon-be 3.8.19 → 3.9.0

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/package.json +1 -1
  3. package/runtime/bundle.json +192 -0
  4. package/runtime/engine/by-code-unit.mjs +6 -6
  5. package/runtime/engine/model-config.mjs +98 -76
  6. package/runtime/engine/orca-config.mjs +22 -17
  7. package/runtime/engine/release-config.mjs +22 -18
  8. package/runtime/engine/removed-vocabulary.mjs +21 -20
  9. package/runtime/engine/resources-config.mjs +42 -35
  10. package/runtime/engine/runtime-root.mjs +11 -13
  11. package/runtime/engine/secrets.mjs +170 -102
  12. package/runtime/engine/sonar-config.mjs +16 -13
  13. package/runtime/engine/temp-root.mjs +3 -9
  14. package/runtime/knowledge/hfs/canon-pins.yaml +10 -10
  15. package/runtime/knowledge/hfs/rules.yaml +6 -6
  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,317 +2,319 @@ import { relativePath, UNPROVEN_FRAMEWORK, unwrapExpression } from './typescript
2
2
  import { constructedDecoratorKind, mutableDecoratorKind, nodeDecorators, tracedFrameworkKinds, violation } from './ast-walks.mjs';
3
3
  import { byCodeUnit } from '../../lib/list.mjs';
4
4
  function locateSource(h, config, context, sourceFile, roots, state) {
5
- const { featureRoots, moduleRoots, localFiles } = roots;
6
- const { canonical, frameworkTargets, locatedRoot, sourceRole, exportedDeclarations, SPECIAL_BASENAMES } = h;
7
- const fileName = canonical(sourceFile.fileName);
8
- const featureRoot = locatedRoot(featureRoots, fileName);
9
- const moduleRoot = locatedRoot(moduleRoots, fileName);
10
- if (!featureRoot && !moduleRoot) return null;
11
- state.checkedFiles += 1;
12
- const checker = context.checkerFor(fileName);
13
- if (!state.frameworkByChecker.has(checker)) state.frameworkByChecker.set(checker, frameworkTargets(config, context, checker, localFiles));
14
- const framework = state.frameworkByChecker.get(checker);
15
- const relativeToOwner = relativePath(featureRoot ?? moduleRoot, fileName);
16
- const parts = relativeToOwner.split('/');
17
- const directories = parts.slice(0, -1).map(part => part.toLowerCase());
18
- const applicationIndex = directories.indexOf('application');
19
- const transportIndex = directories.indexOf('transport');
20
- const inApplication = applicationIndex >= 0;
21
- const inTransport = transportIndex >= 0;
22
- const role = sourceRole(context.ts, sourceFile);
23
- const relative = relativePath(config.root, fileName);
24
- const migrationName = /^\d{10,}-[A-Z][A-Za-z0-9]*$/.test(role.base);
25
- const persistencePath = !role.spec && (migrationName || directories.includes('migrations'));
26
- const special = SPECIAL_BASENAMES.has(role.base.toLowerCase()) || migrationName
27
- || ['constants', 'enums', 'errors', 'migrations'].some(folder => directories.includes(folder));
28
- const publicDeclarations = exportedDeclarations(context.ts, checker, sourceFile);
29
- return { config, context, sourceFile, fileName, featureRoot, moduleRoot, checker, framework, directories, transportIndex,
30
- inApplication, inTransport, role, relative, migrationName, persistencePath, special, publicDeclarations };
5
+ const { featureRoots, moduleRoots, localFiles } = roots;
6
+ const { canonical, frameworkTargets, locatedRoot, sourceRole, exportedDeclarations, SPECIAL_BASENAMES } = h;
7
+ const fileName = canonical(sourceFile.fileName);
8
+ const featureRoot = locatedRoot(featureRoots, fileName);
9
+ const moduleRoot = locatedRoot(moduleRoots, fileName);
10
+ const ownerRoot = featureRoot ?? moduleRoot;
11
+ if (!ownerRoot)
12
+ return null;
13
+ state.checkedFiles += 1;
14
+ const checker = context.checkerFor(fileName);
15
+ if (!checker)
16
+ return null;
17
+ if (!state.frameworkByChecker.has(checker))
18
+ state.frameworkByChecker.set(checker, frameworkTargets(config, context, checker, localFiles));
19
+ const framework = state.frameworkByChecker.get(checker) ?? frameworkTargets(config, context, checker, localFiles);
20
+ const relativeToOwner = relativePath(ownerRoot, fileName);
21
+ const parts = relativeToOwner.split('/');
22
+ const directories = parts.slice(0, -1).map(part => part.toLowerCase());
23
+ const applicationIndex = directories.indexOf('application');
24
+ const transportIndex = directories.indexOf('transport');
25
+ const inApplication = applicationIndex >= 0;
26
+ const inTransport = transportIndex >= 0;
27
+ const role = sourceRole(context.ts, sourceFile);
28
+ const relative = relativePath(config.root, fileName);
29
+ const migrationName = /^\d{10,}-[A-Z][A-Za-z0-9]*$/.test(role.base);
30
+ const persistencePath = !role.spec && (migrationName || directories.includes('migrations'));
31
+ const special = SPECIAL_BASENAMES.has(role.base.toLowerCase()) || migrationName
32
+ || ['constants', 'enums', 'errors', 'migrations'].some(folder => directories.includes(folder));
33
+ const publicDeclarations = exportedDeclarations(context.ts, checker, sourceFile);
34
+ return { config, context, sourceFile, fileName, featureRoot, moduleRoot, checker, framework, directories, transportIndex,
35
+ inApplication, inTransport, role, relative, migrationName, persistencePath, special, publicDeclarations };
31
36
  }
32
-
33
37
  function reportSourceName(h, info, state) {
34
- const { kebabSourceBase, SOURCE_NAME_RULE_ID } = h;
35
- const { config, sourceFile, migrationName, role, relative } = info;
36
- if (!migrationName && !kebabSourceBase(role.base)) state.violations.push(violation(config, sourceFile, sourceFile, SOURCE_NAME_RULE_ID,
37
- `Source basename ${role.base} must use kebab-case segments plus an explicit role suffix.`));
38
- if (!role.role && !info.special) state.namingReasons.push(`${relative} has no statically identifiable source role`);
38
+ const { kebabSourceBase, SOURCE_NAME_RULE_ID } = h;
39
+ const { config, sourceFile, migrationName, role, relative } = info;
40
+ if (!migrationName && !kebabSourceBase(role.base))
41
+ state.violations.push(violation(config, sourceFile, sourceFile, SOURCE_NAME_RULE_ID, `Source basename ${role.base} must use kebab-case segments plus an explicit role suffix.`));
42
+ if (!role.role && !info.special)
43
+ state.namingReasons.push(`${relative} has no statically identifiable source role`);
39
44
  }
40
-
41
45
  function reportFeatureRoleConflicts(h, info, state) {
42
- const { SOURCE_LAYOUT_RULE_ID, APPLICATION_ROLES, TRANSPORT_ROLES } = h;
43
- const { config, sourceFile, role, directories, inApplication, inTransport, transportIndex } = info;
44
- const { violations } = state;
45
- if (inApplication && inTransport) violations.push(violation(config, sourceFile, sourceFile, SOURCE_LAYOUT_RULE_ID,
46
- 'A feature source cannot belong to both application and transport layers.'));
47
- if (role.role && APPLICATION_ROLES.has(role.role) && !inApplication) violations.push(violation(config, sourceFile, sourceFile,
48
- SOURCE_LAYOUT_RULE_ID, `${role.role} source belongs under the feature application/ layer.`));
49
- if (role.role && TRANSPORT_ROLES.has(role.role) && !inTransport) violations.push(violation(config, sourceFile, sourceFile,
50
- SOURCE_LAYOUT_RULE_ID, `${role.role} source belongs under the feature transport/<protocol>/ layer.`));
51
- if (inApplication && role.role && TRANSPORT_ROLES.has(role.role)) violations.push(violation(config, sourceFile, sourceFile,
52
- SOURCE_LAYOUT_RULE_ID, `Transport role ${role.role} cannot live in application/.`));
53
- if (inTransport && role.role && APPLICATION_ROLES.has(role.role)) violations.push(violation(config, sourceFile, sourceFile,
54
- SOURCE_LAYOUT_RULE_ID, `Application role ${role.role} cannot live in transport/.`));
55
- if (inTransport && transportIndex >= directories.length - 1) violations.push(violation(config, sourceFile, sourceFile,
56
- SOURCE_LAYOUT_RULE_ID, 'Feature transport source must name a protocol below transport/.'));
46
+ const { SOURCE_LAYOUT_RULE_ID, APPLICATION_ROLES, TRANSPORT_ROLES } = h;
47
+ const { config, sourceFile, role, directories, inApplication, inTransport, transportIndex } = info;
48
+ const { violations } = state;
49
+ if (inApplication && inTransport)
50
+ violations.push(violation(config, sourceFile, sourceFile, SOURCE_LAYOUT_RULE_ID, 'A feature source cannot belong to both application and transport layers.'));
51
+ if (role.role && APPLICATION_ROLES.has(role.role) && !inApplication)
52
+ violations.push(violation(config, sourceFile, sourceFile, SOURCE_LAYOUT_RULE_ID, `${role.role} source belongs under the feature application/ layer.`));
53
+ if (role.role && TRANSPORT_ROLES.has(role.role) && !inTransport)
54
+ violations.push(violation(config, sourceFile, sourceFile, SOURCE_LAYOUT_RULE_ID, `${role.role} source belongs under the feature transport/<protocol>/ layer.`));
55
+ if (inApplication && role.role && TRANSPORT_ROLES.has(role.role))
56
+ violations.push(violation(config, sourceFile, sourceFile, SOURCE_LAYOUT_RULE_ID, `Transport role ${role.role} cannot live in application/.`));
57
+ if (inTransport && role.role && APPLICATION_ROLES.has(role.role))
58
+ violations.push(violation(config, sourceFile, sourceFile, SOURCE_LAYOUT_RULE_ID, `Application role ${role.role} cannot live in transport/.`));
59
+ if (inTransport && transportIndex >= directories.length - 1)
60
+ violations.push(violation(config, sourceFile, sourceFile, SOURCE_LAYOUT_RULE_ID, 'Feature transport source must name a protocol below transport/.'));
57
61
  }
58
-
59
62
  /** A non-index source whose role is neither one of the layer's own roles nor one the other layer or the schema owns. */
60
63
  function unselectedLayerRole(role, layerRoles, otherRoles) {
61
- return role.base !== 'index' && (!role.role || !layerRoles.has(role.role)) && !(role.role && (otherRoles.has(role.role) || role.role === 'entity'));
64
+ return role.base !== 'index' && (!role.role || !layerRoles.has(role.role)) && !(role.role && (otherRoles.has(role.role) || role.role === 'entity'));
62
65
  }
63
-
64
66
  function reportFeatureRoleSelection(h, info, state) {
65
- const { APPLICATION_ROLES, TRANSPORT_ROLES, APPLICATION_LAYER_ROLES, TRANSPORT_LAYER_ROLES } = h;
66
- const { role, relative, directories, inApplication, inTransport, persistencePath } = info;
67
- const topLevelFeatureFile = directories.length === 1 && (role.base === 'index' || role.role === 'module' || role.spec);
68
- if (inApplication && unselectedLayerRole(role, APPLICATION_LAYER_ROLES, TRANSPORT_ROLES)) {
69
- state.layoutReasons.push(`${relative} role ${role.role ?? '(unclassified)'} is not a selected application-layer role`);
70
- }
71
- if (inTransport && unselectedLayerRole(role, TRANSPORT_LAYER_ROLES, APPLICATION_ROLES)) {
72
- state.layoutReasons.push(`${relative} role ${role.role ?? '(unclassified)'} is not a selected transport-layer role`);
73
- }
74
- if (inApplication || inTransport || topLevelFeatureFile) return;
75
- if (role.role && role.role !== 'entity' && !APPLICATION_ROLES.has(role.role) && !TRANSPORT_ROLES.has(role.role)) {
76
- state.layoutReasons.push(`${relative} role ${role.role} has no statically selected feature layer`);
77
- }
78
- if (!role.role && !persistencePath) state.layoutReasons.push(`${relative} has no statically selected feature layer`);
67
+ const { APPLICATION_ROLES, TRANSPORT_ROLES, APPLICATION_LAYER_ROLES, TRANSPORT_LAYER_ROLES } = h;
68
+ const { role, relative, directories, inApplication, inTransport, persistencePath } = info;
69
+ const topLevelFeatureFile = directories.length === 1 && (role.base === 'index' || role.role === 'module' || role.spec);
70
+ if (inApplication && unselectedLayerRole(role, APPLICATION_LAYER_ROLES, TRANSPORT_ROLES)) {
71
+ state.layoutReasons.push(`${relative} role ${role.role ?? '(unclassified)'} is not a selected application-layer role`);
72
+ }
73
+ if (inTransport && unselectedLayerRole(role, TRANSPORT_LAYER_ROLES, APPLICATION_ROLES)) {
74
+ state.layoutReasons.push(`${relative} role ${role.role ?? '(unclassified)'} is not a selected transport-layer role`);
75
+ }
76
+ if (inApplication || inTransport || topLevelFeatureFile)
77
+ return;
78
+ if (role.role && role.role !== 'entity' && !APPLICATION_ROLES.has(role.role) && !TRANSPORT_ROLES.has(role.role)) {
79
+ state.layoutReasons.push(`${relative} role ${role.role} has no statically selected feature layer`);
80
+ }
81
+ if (!role.role && !persistencePath)
82
+ state.layoutReasons.push(`${relative} has no statically selected feature layer`);
79
83
  }
80
-
81
84
  function reportFeatureSchemaPlacement(h, info, state) {
82
- const { SOURCE_LAYOUT_RULE_ID } = h;
83
- const { config, sourceFile, role, persistencePath } = info;
84
- if (persistencePath) state.violations.push(violation(config, sourceFile, sourceFile, SOURCE_LAYOUT_RULE_ID,
85
- 'Migration source cannot be owned by a feature; place it under the declared persistence module.'));
86
- if (role.role === 'entity') state.violations.push(violation(config, sourceFile, sourceFile, SOURCE_LAYOUT_RULE_ID,
87
- 'Entity source cannot be owned by a feature; place schema under the declared persistence module.'));
85
+ const { SOURCE_LAYOUT_RULE_ID } = h;
86
+ const { config, sourceFile, role, persistencePath } = info;
87
+ if (persistencePath)
88
+ state.violations.push(violation(config, sourceFile, sourceFile, SOURCE_LAYOUT_RULE_ID, 'Migration source cannot be owned by a feature; place it under the declared persistence module.'));
89
+ if (role.role === 'entity')
90
+ state.violations.push(violation(config, sourceFile, sourceFile, SOURCE_LAYOUT_RULE_ID, 'Entity source cannot be owned by a feature; place schema under the declared persistence module.'));
88
91
  }
89
-
90
92
  function reportFeatureLayout(h, info, state) {
91
- if (!info.featureRoot) return;
92
- reportFeatureRoleConflicts(h, info, state);
93
- reportFeatureRoleSelection(h, info, state);
94
- reportFeatureSchemaPlacement(h, info, state);
93
+ if (!info.featureRoot)
94
+ return;
95
+ reportFeatureRoleConflicts(h, info, state);
96
+ reportFeatureRoleSelection(h, info, state);
97
+ reportFeatureSchemaPlacement(h, info, state);
95
98
  }
96
-
97
99
  function inspectClassPlacement(h, info, declaration, kinds, state) {
98
- const { implementsFramework, SOURCE_LAYOUT_RULE_ID } = h;
99
- const { config, context, sourceFile, featureRoot, inTransport, directories, transportIndex, checker, framework } = info;
100
- const { ts } = context;
101
- const graphQlDto = kinds.some(kind => kind === 'ArgsType' || kind === 'InputType' || kind === 'ObjectType');
102
- if (graphQlDto && (!featureRoot || !inTransport || directories[transportIndex + 1] !== 'graphql')) {
103
- state.violations.push(violation(config, sourceFile, declaration.name ?? declaration, SOURCE_LAYOUT_RULE_ID,
104
- 'GraphQL DTO classes belong under a feature transport/graphql/ boundary.'));
105
- }
106
- const persistenceSchema = kinds.includes('Entity') || kinds.includes('ViewEntity')
107
- || implementsFramework(ts, checker, declaration, framework.bySymbol, 'MigrationInterface');
108
- if (persistenceSchema && featureRoot) state.violations.push(violation(config, sourceFile, declaration.name ?? declaration, SOURCE_LAYOUT_RULE_ID,
109
- 'TypeORM entities and migrations cannot be owned by a feature; place schema under its declared persistence module.'));
100
+ const { implementsFramework, SOURCE_LAYOUT_RULE_ID } = h;
101
+ const { config, context, sourceFile, featureRoot, inTransport, directories, transportIndex, checker, framework } = info;
102
+ const { ts } = context;
103
+ const graphQlDto = kinds.some(kind => kind === 'ArgsType' || kind === 'InputType' || kind === 'ObjectType');
104
+ if (graphQlDto && (!featureRoot || !inTransport || directories[transportIndex + 1] !== 'graphql')) {
105
+ state.violations.push(violation(config, sourceFile, declaration.name ?? declaration, SOURCE_LAYOUT_RULE_ID, 'GraphQL DTO classes belong under a feature transport/graphql/ boundary.'));
106
+ }
107
+ const persistenceSchema = kinds.includes('Entity') || kinds.includes('ViewEntity')
108
+ || implementsFramework(ts, checker, declaration, framework.bySymbol, 'MigrationInterface');
109
+ if (persistenceSchema && featureRoot)
110
+ state.violations.push(violation(config, sourceFile, declaration.name ?? declaration, SOURCE_LAYOUT_RULE_ID, 'TypeORM entities and migrations cannot be owned by a feature; place schema under its declared persistence module.'));
110
111
  }
111
-
112
112
  function inspectClassName(h, info, declaration, state) {
113
- const { implementedPortNames, SOURCE_NAME_RULE_ID, CLASS_ROLE_SUFFIX, NON_CLASS_ROLES } = h;
114
- const { config, sourceFile, role, relative, checker } = info;
115
- const { ts } = info.context;
116
- const { publicDeclarations } = info;
117
- const classSuffix = role.role && !NON_CLASS_ROLES.has(role.role) ? CLASS_ROLE_SUFFIX.get(role.role) : null;
118
- if (publicDeclarations.has(declaration) && !declaration.name) state.namingReasons.push(`${relative} exports an anonymous class whose role name cannot be proved`);
119
- else if (publicDeclarations.has(declaration) && declaration.name && classSuffix && !declaration.name.text.endsWith(classSuffix)
120
- && !implementedPortNames(ts, checker, declaration).some(port => declaration.name.text.endsWith(port))) {
121
- state.violations.push(violation(config, sourceFile, declaration.name, SOURCE_NAME_RULE_ID,
122
- `Exported class ${declaration.name.text} must end in ${classSuffix} for a ${role.role} source file, or in the name of the port it implements.`));
123
- } else if (publicDeclarations.has(declaration) && declaration.name && role.role && !NON_CLASS_ROLES.has(role.role) && !classSuffix) {
124
- state.namingReasons.push(`${relative} declares exported class ${declaration.name.text} with unclassified file role ${role.role}`);
125
- }
113
+ const { implementedPortNames, SOURCE_NAME_RULE_ID, CLASS_ROLE_SUFFIX, NON_CLASS_ROLES } = h;
114
+ const { config, sourceFile, role, relative, checker } = info;
115
+ const { ts } = info.context;
116
+ const { publicDeclarations } = info;
117
+ const classSuffix = role.role && !NON_CLASS_ROLES.has(role.role) ? CLASS_ROLE_SUFFIX.get(role.role) : null;
118
+ const nameNode = declaration.name;
119
+ if (publicDeclarations.has(declaration) && !nameNode)
120
+ state.namingReasons.push(`${relative} exports an anonymous class whose role name cannot be proved`);
121
+ else if (publicDeclarations.has(declaration) && nameNode && classSuffix && !nameNode.text.endsWith(classSuffix)
122
+ && !implementedPortNames(ts, checker, declaration).some(port => nameNode.text.endsWith(port))) {
123
+ state.violations.push(violation(config, sourceFile, nameNode, SOURCE_NAME_RULE_ID, `Exported class ${nameNode.text} must end in ${classSuffix} for a ${role.role} source file, or in the name of the port it implements.`));
124
+ }
125
+ else if (publicDeclarations.has(declaration) && nameNode && role.role && !NON_CLASS_ROLES.has(role.role) && !classSuffix) {
126
+ state.namingReasons.push(`${relative} declares exported class ${nameNode.text} with unclassified file role ${role.role}`);
127
+ }
126
128
  }
127
-
128
129
  function inspectClass(h, info, declaration, state) {
129
- const { decoratorKind } = h;
130
- const { ts } = info.context;
131
- const { checker, framework } = info;
132
- const declarationDecorators = nodeDecorators(ts, declaration);
133
- const kinds = declarationDecorators.map(decorator => decoratorKind(ts, checker, decorator, framework.bySymbol)).filter(Boolean);
134
- inspectClassPlacement(h, info, declaration, kinds, state);
135
- inspectClassName(h, info, declaration, state);
130
+ const { decoratorKind } = h;
131
+ const { ts } = info.context;
132
+ const { checker, framework } = info;
133
+ const declarationDecorators = nodeDecorators(ts, declaration);
134
+ const kinds = declarationDecorators.map(decorator => decoratorKind(ts, checker, decorator, framework.bySymbol)).filter((kind) => Boolean(kind));
135
+ inspectClassPlacement(h, info, declaration, kinds, state);
136
+ inspectClassName(h, info, declaration, state);
136
137
  }
137
-
138
138
  function inspectClasses(h, info, state) {
139
- const declarations = info.sourceFile.statements.filter(statement => info.context.ts.isClassDeclaration(statement));
140
- for (const declaration of declarations) inspectClass(h, info, declaration, state);
139
+ const declarations = info.sourceFile.statements.filter((statement) => info.context.ts.isClassDeclaration(statement));
140
+ for (const declaration of declarations)
141
+ inspectClass(h, info, declaration, state);
141
142
  }
142
-
143
143
  function inspectClassValue(h, info, declaration, state) {
144
- const { classValueStatus, SOURCE_NAME_RULE_ID, CLASS_ROLE_SUFFIX, NON_CLASS_ROLES } = h;
145
- const { config, sourceFile, relative, role, checker, publicDeclarations } = info;
146
- const { ts } = info.context;
147
- if (!publicDeclarations.has(declaration) || !declaration.initializer) return;
148
- const classValue = classValueStatus(ts, checker, declaration.initializer);
149
- if (classValue.status === 'unavailable') {
150
- state.namingReasons.push(`${relative} exports a class-valued declaration whose role identity is not statically proved`);
151
- return;
152
- }
153
- if (classValue.status !== 'class') return;
154
- const classSuffix = role.role && !NON_CLASS_ROLES.has(role.role) ? CLASS_ROLE_SUFFIX.get(role.role) : null;
155
- if (!classSuffix || !ts.isIdentifier(declaration.name)) {
156
- state.namingReasons.push(`${relative} exports a class-valued declaration without a statically selected class role`);
157
- return;
158
- }
159
- const names = [declaration.name.text, ...classValue.names];
160
- const invalid = names.find(name => !name.endsWith(classSuffix));
161
- if (invalid) state.violations.push(violation(config, sourceFile, declaration.name, SOURCE_NAME_RULE_ID,
162
- `Exported class value ${invalid} must end in ${classSuffix} for a ${role.role} source file.`));
144
+ const { classValueStatus, SOURCE_NAME_RULE_ID, CLASS_ROLE_SUFFIX, NON_CLASS_ROLES } = h;
145
+ const { config, sourceFile, relative, role, checker, publicDeclarations } = info;
146
+ const { ts } = info.context;
147
+ if (!publicDeclarations.has(declaration) || !declaration.initializer)
148
+ return;
149
+ const classValue = classValueStatus(ts, checker, declaration.initializer);
150
+ if (classValue.status === 'unavailable') {
151
+ state.namingReasons.push(`${relative} exports a class-valued declaration whose role identity is not statically proved`);
152
+ return;
153
+ }
154
+ if (classValue.status !== 'class')
155
+ return;
156
+ const classSuffix = role.role && !NON_CLASS_ROLES.has(role.role) ? CLASS_ROLE_SUFFIX.get(role.role) : null;
157
+ if (!classSuffix || !ts.isIdentifier(declaration.name)) {
158
+ state.namingReasons.push(`${relative} exports a class-valued declaration without a statically selected class role`);
159
+ return;
160
+ }
161
+ const names = [declaration.name.text, ...classValue.names];
162
+ const invalid = names.find(name => !name.endsWith(classSuffix));
163
+ if (invalid)
164
+ state.violations.push(violation(config, sourceFile, declaration.name, SOURCE_NAME_RULE_ID, `Exported class value ${invalid} must end in ${classSuffix} for a ${role.role} source file.`));
163
165
  }
164
-
165
166
  function inspectClassValues(h, info, state) {
166
- const { ts } = info.context;
167
- const { sourceFile } = info;
168
- for (const statement of sourceFile.statements) if (ts.isVariableStatement(statement)) {
169
- for (const declaration of statement.declarationList.declarations) inspectClassValue(h, info, declaration, state);
170
- }
167
+ const { ts } = info.context;
168
+ const { sourceFile } = info;
169
+ for (const statement of sourceFile.statements)
170
+ if (ts.isVariableStatement(statement)) {
171
+ for (const declaration of statement.declarationList.declarations)
172
+ inspectClassValue(h, info, declaration, state);
173
+ }
171
174
  }
172
-
173
175
  function inspectEnumMembers(h, info, statement, state) {
174
- const { SOURCE_NAME_RULE_ID } = h;
175
- const { config, sourceFile } = info;
176
- const { ts } = info.context;
177
- for (const member of statement.members) {
178
- const name = ts.isIdentifier(member.name) || ts.isStringLiteralLike(member.name) ? member.name.text : null;
179
- const initializer = member.initializer && unwrapExpression(ts, member.initializer);
180
- if (!name || !/^[A-Z][A-Za-z0-9]*$/.test(name) || !initializer || !ts.isStringLiteralLike(initializer)) {
181
- state.violations.push(violation(config, sourceFile, member.name, SOURCE_NAME_RULE_ID,
182
- 'Enum members must use PascalCase names with explicit static string values.'));
176
+ const { SOURCE_NAME_RULE_ID } = h;
177
+ const { config, sourceFile } = info;
178
+ const { ts } = info.context;
179
+ for (const member of statement.members) {
180
+ const name = ts.isIdentifier(member.name) || ts.isStringLiteralLike(member.name) ? member.name.text : null;
181
+ const initializer = member.initializer && unwrapExpression(ts, member.initializer);
182
+ if (!name || !/^[A-Z][A-Za-z0-9]*$/.test(name) || !initializer || !ts.isStringLiteralLike(initializer)) {
183
+ state.violations.push(violation(config, sourceFile, member.name, SOURCE_NAME_RULE_ID, 'Enum members must use PascalCase names with explicit static string values.'));
184
+ }
183
185
  }
184
- }
185
186
  }
186
-
187
187
  function inspectObjectContract(h, info, statement, state) {
188
- const { objectContractStatus, companionInterfaceAllowed, SOURCE_NAME_RULE_ID, TRANSPORT_OBJECT_SUFFIX } = h;
189
- const { config, sourceFile, role, checker, publicDeclarations } = info;
190
- const { ts } = info.context;
191
- const contractStatus = objectContractStatus(ts, checker, statement);
192
- const transportSuffix = TRANSPORT_OBJECT_SUFFIX.get(role.role);
193
- if (contractStatus === 'object' && publicDeclarations.has(statement) && transportSuffix && !role.spec
194
- && !statement.name.text.endsWith(transportSuffix) && !companionInterfaceAllowed(ts, sourceFile, statement.name.text)) {
195
- state.violations.push(violation(config, sourceFile, statement.name, SOURCE_NAME_RULE_ID,
196
- `Public object contract ${statement.name.text} in a ${role.role} source file must end in ${transportSuffix}.`));
197
- }
188
+ const { objectContractStatus, companionInterfaceAllowed, SOURCE_NAME_RULE_ID, TRANSPORT_OBJECT_SUFFIX } = h;
189
+ const { config, sourceFile, role, checker, publicDeclarations } = info;
190
+ const { ts } = info.context;
191
+ // an object contract is an interface or an object type alias, so any other statement has no contract name to judge
192
+ if (!ts.isInterfaceDeclaration(statement) && !ts.isTypeAliasDeclaration(statement))
193
+ return;
194
+ const contractStatus = objectContractStatus(ts, checker, statement);
195
+ const transportSuffix = role.role === null ? undefined : TRANSPORT_OBJECT_SUFFIX.get(role.role);
196
+ if (contractStatus === 'object' && publicDeclarations.has(statement) && transportSuffix && !role.spec
197
+ && !statement.name.text.endsWith(transportSuffix) && !companionInterfaceAllowed(ts, sourceFile, statement.name.text)) {
198
+ state.violations.push(violation(config, sourceFile, statement.name, SOURCE_NAME_RULE_ID, `Public object contract ${statement.name.text} in a ${role.role} source file must end in ${transportSuffix}.`));
199
+ }
198
200
  }
199
-
200
201
  function inspectEnumAndContract(h, info, statement, state) {
201
- const { hasModifier, SOURCE_NAME_RULE_ID } = h;
202
- const { config, sourceFile } = info;
203
- const { ts } = info.context;
204
- if (ts.isEnumDeclaration(statement)) {
205
- if (hasModifier(ts, statement, ts.SyntaxKind.ConstKeyword) || !/^[A-Z][A-Za-z0-9]*$/.test(statement.name.text)) {
206
- state.violations.push(violation(config, sourceFile, statement.name, SOURCE_NAME_RULE_ID,
207
- 'Enums must be non-const declarations with PascalCase names.'));
202
+ const { hasModifier, SOURCE_NAME_RULE_ID } = h;
203
+ const { config, sourceFile } = info;
204
+ const { ts } = info.context;
205
+ if (ts.isEnumDeclaration(statement)) {
206
+ if (hasModifier(ts, statement, ts.SyntaxKind.ConstKeyword) || !/^[A-Z][A-Za-z0-9]*$/.test(statement.name.text)) {
207
+ state.violations.push(violation(config, sourceFile, statement.name, SOURCE_NAME_RULE_ID, 'Enums must be non-const declarations with PascalCase names.'));
208
+ }
209
+ inspectEnumMembers(h, info, statement, state);
208
210
  }
209
- inspectEnumMembers(h, info, statement, state);
210
- }
211
- inspectObjectContract(h, info, statement, state);
211
+ inspectObjectContract(h, info, statement, state);
212
212
  }
213
-
214
213
  function inspectEnumsAndContracts(h, info, state) {
215
- for (const statement of info.sourceFile.statements) inspectEnumAndContract(h, info, statement, state);
214
+ for (const statement of info.sourceFile.statements)
215
+ inspectEnumAndContract(h, info, statement, state);
216
216
  }
217
-
218
217
  function inspectDynamicDecorator(info, dynamic, state) {
219
- const detail = `${info.relative} uses a mutable or constructed ${dynamic} decorator identity`;
220
- if (['Entity', 'ViewEntity', 'ArgsType', 'InputType', 'ObjectType', 'multiple framework', 'unproven framework'].includes(dynamic)) state.layoutReasons.push(detail);
221
- if (!['Entity', 'ViewEntity'].includes(dynamic)) state.namingReasons.push(detail);
218
+ const detail = `${info.relative} uses a mutable or constructed ${dynamic} decorator identity`;
219
+ if (['Entity', 'ViewEntity', 'ArgsType', 'InputType', 'ObjectType', 'multiple framework', 'unproven framework'].includes(dynamic))
220
+ state.layoutReasons.push(detail);
221
+ if (!['Entity', 'ViewEntity'].includes(dynamic))
222
+ state.namingReasons.push(detail);
222
223
  }
223
-
224
224
  function inspectDecorator(h, info, node, decorator, state) {
225
- const { graphqlField, graphqlArgument, decoratorKind, TRACE_NEW } = h;
226
- const { ts } = info.context;
227
- const { checker, framework } = info;
228
- const kind = decoratorKind(ts, checker, decorator, framework.bySymbol);
229
- if (!kind) {
230
- const dynamic = mutableDecoratorKind(ts, checker, decorator, framework.bySymbol)
231
- ?? constructedDecoratorKind(ts, checker, decorator, framework.bySymbol, TRACE_NEW);
232
- if (dynamic) inspectDynamicDecorator(info, dynamic, state);
233
- }
234
- if (kind === 'Mutation' || kind === 'Query') graphqlField({ config: info.config, context: info.context, sourceFile: info.sourceFile,
235
- node, decorator, kind, namingReasons: state.namingReasons, violations: state.violations });
236
- if (kind === 'Args') graphqlArgument(info.config, info.context, info.sourceFile, node, decorator, state.namingReasons, state.violations);
225
+ const { graphqlField, graphqlArgument, decoratorKind, TRACE_NEW } = h;
226
+ const { ts } = info.context;
227
+ const { checker, framework } = info;
228
+ const kind = decoratorKind(ts, checker, decorator, framework.bySymbol);
229
+ if (!kind) {
230
+ const dynamic = mutableDecoratorKind(ts, checker, decorator, framework.bySymbol)
231
+ ?? constructedDecoratorKind(ts, checker, decorator, framework.bySymbol, TRACE_NEW);
232
+ if (dynamic)
233
+ inspectDynamicDecorator(info, dynamic, state);
234
+ }
235
+ if (kind === 'Mutation' || kind === 'Query')
236
+ graphqlField({ config: info.config, context: info.context, sourceFile: info.sourceFile,
237
+ node, decorator, kind, namingReasons: state.namingReasons, violations: state.violations });
238
+ if (kind === 'Args')
239
+ graphqlArgument(info.config, info.context, info.sourceFile, node, decorator, state.namingReasons, state.violations);
237
240
  }
238
-
239
241
  function inspectNodeDecorators(h, info, node, state) {
240
- for (const decorator of nodeDecorators(info.context.ts, node)) inspectDecorator(h, info, node, decorator, state);
242
+ for (const decorator of nodeDecorators(info.context.ts, node))
243
+ inspectDecorator(h, info, node, decorator, state);
241
244
  }
242
-
243
245
  function inspectEnumCalls(h, info, node, state) {
244
- const { graphqlEnumRegistration, selectedCallKind, callsNamedHelper } = h;
245
- const { ts } = info.context;
246
- const { checker, framework } = info;
247
- if (!ts.isCallExpression(node)) return;
248
- if (selectedCallKind(ts, checker, node, framework.bySymbol) === 'registerEnumType') {
249
- graphqlEnumRegistration(info.config, info.context, info.sourceFile, node, state.namingReasons, state.violations);
250
- } else if (callsNamedHelper(ts, checker, node, 'createEnumType')) {
251
- state.namingReasons.push(`${info.relative} calls a project GraphQL enum adapter whose emitted type name is not statically proved`);
252
- }
246
+ const { graphqlEnumRegistration, selectedCallKind, callsNamedHelper } = h;
247
+ const { ts } = info.context;
248
+ const { checker, framework } = info;
249
+ if (!ts.isCallExpression(node))
250
+ return;
251
+ if (selectedCallKind(ts, checker, node, framework.bySymbol) === 'registerEnumType') {
252
+ graphqlEnumRegistration(info.config, info.context, info.sourceFile, node, state.namingReasons, state.violations);
253
+ }
254
+ else if (callsNamedHelper(ts, checker, node, 'createEnumType')) {
255
+ state.namingReasons.push(`${info.relative} calls a project GraphQL enum adapter whose emitted type name is not statically proved`);
256
+ }
253
257
  }
254
-
255
258
  function inspectConstructedSource(h, info, node, state) {
256
- const { SOURCE_LAYOUT_RULE_ID, TRACE_NEW } = h;
257
- const { ts } = info.context;
258
- const { checker, framework, publicDeclarations, featureRoot } = info;
259
- const exportedFactoryCall = ts.isCallExpression(node) && ts.isVariableDeclaration(node.parent) && publicDeclarations.has(node.parent);
260
- if ((ts.isNewExpression(node) || exportedFactoryCall) && featureRoot) {
261
- const constructed = tracedFrameworkKinds(ts, checker, node, framework.bySymbol, TRACE_NEW);
262
- if (constructed.has('EntitySchema')) state.violations.push(violation(info.config, info.sourceFile, node.expression, SOURCE_LAYOUT_RULE_ID,
263
- 'TypeORM EntitySchema cannot be owned by a feature; place schema under its declared persistence module.'));
264
- if (constructed.has(UNPROVEN_FRAMEWORK)) state.layoutReasons.push(`${info.relative} has a constructed provider identity beyond the bounded static trace`);
265
- }
259
+ const { SOURCE_LAYOUT_RULE_ID, TRACE_NEW } = h;
260
+ const { ts } = info.context;
261
+ const { checker, framework, publicDeclarations, featureRoot } = info;
262
+ const exportedFactoryCall = ts.isCallExpression(node) && ts.isVariableDeclaration(node.parent) && publicDeclarations.has(node.parent);
263
+ if ((ts.isNewExpression(node) || exportedFactoryCall) && featureRoot) {
264
+ const constructed = tracedFrameworkKinds(ts, checker, node, framework.bySymbol, TRACE_NEW);
265
+ if (constructed.has('EntitySchema'))
266
+ state.violations.push(violation(info.config, info.sourceFile, node.expression, SOURCE_LAYOUT_RULE_ID, 'TypeORM EntitySchema cannot be owned by a feature; place schema under its declared persistence module.'));
267
+ if (constructed.has(UNPROVEN_FRAMEWORK))
268
+ state.layoutReasons.push(`${info.relative} has a constructed provider identity beyond the bounded static trace`);
269
+ }
266
270
  }
267
-
268
271
  function visitSourceNode(h, info, node, state) {
269
- inspectNodeDecorators(h, info, node, state);
270
- inspectEnumCalls(h, info, node, state);
271
- inspectConstructedSource(h, info, node, state);
272
- info.context.ts.forEachChild(node, child => visitSourceNode(h, info, child, state));
272
+ inspectNodeDecorators(h, info, node, state);
273
+ inspectEnumCalls(h, info, node, state);
274
+ inspectConstructedSource(h, info, node, state);
275
+ info.context.ts.forEachChild(node, child => visitSourceNode(h, info, child, state));
273
276
  }
274
-
275
277
  function inspectSourceFile(h, config, context, sourceFile, roots, state) {
276
- const info = locateSource(h, config, context, sourceFile, roots, state);
277
- if (!info) return;
278
- reportSourceName(h, info, state);
279
- reportFeatureLayout(h, info, state);
280
- inspectClasses(h, info, state);
281
- inspectClassValues(h, info, state);
282
- inspectEnumsAndContracts(h, info, state);
283
- visitSourceNode(h, info, sourceFile, state);
278
+ const info = locateSource(h, config, context, sourceFile, roots, state);
279
+ if (!info)
280
+ return;
281
+ reportSourceName(h, info, state);
282
+ reportFeatureLayout(h, info, state);
283
+ inspectClasses(h, info, state);
284
+ inspectClassValues(h, info, state);
285
+ inspectEnumsAndContracts(h, info, state);
286
+ visitSourceNode(h, info, sourceFile, state);
284
287
  }
285
-
286
288
  function coverageFor(state) {
287
- for (const framework of state.frameworkByChecker.values()) {
288
- state.layoutReasons.push(...framework.reasons);
289
- state.namingReasons.push(...framework.reasons.filter(reason => reason.includes('@nestjs/graphql')));
290
- }
291
- if (state.checkedFiles === 0) {
292
- state.layoutReasons.push('the checked TypeScript program contains no configured backend feature or module source');
293
- state.namingReasons.push('the checked TypeScript program contains no configured backend feature or module source');
294
- }
295
- return {
296
- files: state.checkedFiles,
297
- layout: state.layoutReasons.length
298
- ? { status: 'unavailable', reason: 'one or more backend source placement relations are not statically proved', details: [...new Set(state.layoutReasons)].sort(byCodeUnit) }
299
- : { status: 'checked' },
300
- naming: state.namingReasons.length
301
- ? { status: 'unavailable', reason: 'one or more backend source naming relations are not statically proved', details: [...new Set(state.namingReasons)].sort(byCodeUnit) }
302
- : { status: 'checked' },
303
- };
289
+ for (const framework of state.frameworkByChecker.values()) {
290
+ state.layoutReasons.push(...framework.reasons);
291
+ state.namingReasons.push(...framework.reasons.filter(reason => reason.includes('@nestjs/graphql')));
292
+ }
293
+ if (state.checkedFiles === 0) {
294
+ state.layoutReasons.push('the checked TypeScript program contains no configured backend feature or module source');
295
+ state.namingReasons.push('the checked TypeScript program contains no configured backend feature or module source');
296
+ }
297
+ return {
298
+ files: state.checkedFiles,
299
+ layout: state.layoutReasons.length
300
+ ? { status: 'unavailable', reason: 'one or more backend source placement relations are not statically proved', details: [...new Set(state.layoutReasons)].sort(byCodeUnit) }
301
+ : { status: 'checked' },
302
+ naming: state.namingReasons.length
303
+ ? { status: 'unavailable', reason: 'one or more backend source naming relations are not statically proved', details: [...new Set(state.namingReasons)].sort(byCodeUnit) }
304
+ : { status: 'checked' },
305
+ };
304
306
  }
305
-
306
307
  /** Check the adopted domain-first backend source layout without inferring semantic ownership from folder names alone. */
307
308
  export function createBackendSourceShapeChecker(helpers) {
308
- const { absoluteRoots, canonical } = helpers;
309
- return function checkBackendSourceShape(config, context) {
310
- const featureRoots = absoluteRoots(config.root, config.backend.features);
311
- const moduleRoots = absoluteRoots(config.root, config.backend.modules);
312
- const localFiles = new Set(context.files.map(file => canonical(file.fileName)));
313
- const state = { frameworkByChecker: new Map(), violations: [], layoutReasons: [], namingReasons: [], checkedFiles: 0 };
314
- const roots = { featureRoots, moduleRoots, localFiles };
315
- for (const sourceFile of context.files) inspectSourceFile(helpers, config, context, sourceFile, roots, state);
316
- return { violations: state.violations, coverage: coverageFor(state) };
317
- };
309
+ const { absoluteRoots, canonical } = helpers;
310
+ return function checkBackendSourceShape(config, context) {
311
+ const featureRoots = absoluteRoots(config.root, config.backend.features);
312
+ const moduleRoots = absoluteRoots(config.root, config.backend.modules);
313
+ const localFiles = new Set(context.files.map(file => canonical(file.fileName)));
314
+ const state = { frameworkByChecker: new Map(), violations: [], layoutReasons: [], namingReasons: [], checkedFiles: 0 };
315
+ const roots = { featureRoots, moduleRoots, localFiles };
316
+ for (const sourceFile of context.files)
317
+ inspectSourceFile(helpers, config, context, sourceFile, roots, state);
318
+ return { violations: state.violations, coverage: coverageFor(state) };
319
+ };
318
320
  }