@shrkcrft/boundaries 0.1.0-alpha.26 → 0.1.0-alpha.28

package/dist/wiring/trace-literal.js

@@ -17,13 +17,19 @@ export const TRACE_DEFAULT_GLOBS = [
  *  - `declare`  — a canonical definition (`const X = 'lit'`, `kind: 'lit'`, an enum value).
  *  - `register` — added to a collection / mapping (`register('lit')`, an array element, `{ 'lit': … }`).
  *  - `consume`  — compared / switched / handled (`=== 'lit'`, `case 'lit':`).
+ *  - `render`   — rendered / emitted at the boundary (JSX child `>{ 'lit' }`, template
+ *                 interpolation `${ 'lit' }`, a `render('lit')` / `res.send('lit')` call).
  *  - `reference`— an occurrence we can't confidently classify (still reported, with context).
+ *
+ * `render` only ever refines what would otherwise be a `reference`; it never
+ * steals a site from `declare` / `register` / `consume`.
  */
 export var TraceRole;
 (function (TraceRole) {
     TraceRole["Declare"] = "declare";
     TraceRole["Register"] = "register";
     TraceRole["Consume"] = "consume";
+    TraceRole["Render"] = "render";
     TraceRole["Reference"] = "reference";
 })(TraceRole || (TraceRole = {}));
 function escapeRegex(s) {
@@ -89,6 +95,20 @@ function classifyRole(before, after) {
     if (/\b(kind|type|id|name|slug|key|tag|code|token|permission|route|event|action|channel|topic|status|provide|providerToken)\s*[:=]$/i.test(b)) {
         return TraceRole.Declare;
     }
+    // Render/handle site — REACHED ONLY after every higher-precision rule above
+    // has declined, so this can only refine an occurrence that would otherwise be
+    // `reference`; it never steals from declare/register/consume:
+    //  - JSX child interpolation:        `<tag>{ 'lit' }`  (before ends `>{`).
+    //  - template-literal interpolation: `` `${ 'lit' }` `` (before ends `${`).
+    //  - a render / send-to-client call: `render('lit')`, `res.render('lit')`, `res.send('lit')`.
+    if (/>\s*\{$/.test(b))
+        return TraceRole.Render;
+    if (/\$\{$/.test(b))
+        return TraceRole.Render;
+    if (/\brender\w*\s*\($/i.test(b))
+        return TraceRole.Render;
+    if (/\bsend\w*\s*\($/i.test(b))
+        return TraceRole.Render;
     return TraceRole.Reference;
 }
 /** A const name is alias-resolvable only if Pascal/SCREAMING-cased (low collision risk). */
@@ -167,6 +187,7 @@ export function traceLiteral(projectRoot, literal, options = {}) {
         [TraceRole.Declare]: [],
         [TraceRole.Register]: [],
         [TraceRole.Consume]: [],
+        [TraceRole.Render]: [],
         [TraceRole.Reference]: [],
     };
     for (const s of sites)
@@ -180,6 +201,7 @@ export function traceLiteral(projectRoot, literal, options = {}) {
             [TraceRole.Declare]: sortSites(byRole[TraceRole.Declare]),
             [TraceRole.Register]: sortSites(byRole[TraceRole.Register]),
             [TraceRole.Consume]: sortSites(byRole[TraceRole.Consume]),
+            [TraceRole.Render]: sortSites(byRole[TraceRole.Render]),
             [TraceRole.Reference]: sortSites(byRole[TraceRole.Reference]),
         },
         aliases: [...aliasNames].sort(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/boundaries",
-  "version": "0.1.0-alpha.26",
+  "version": "0.1.0-alpha.28",
   "description": "SharkCraft boundary rules: detect when a repository violates its own architecture (forbidden imports across folder/package/layer boundaries).",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -43,7 +43,7 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.26"
+    "@shrkcrft/core": "^0.1.0-alpha.28"
   },
   "publishConfig": {
     "access": "public"