@suss/extractor 0.18.0 → 0.20.0

package/dist/index.cjs

@@ -866,6 +866,7 @@ function assembleSummary(raw, options = DEFAULT_OPTIONS) {
     location: {
       file: raw.identity.file,
       range: raw.identity.range,
+      ...raw.identity.span !== void 0 ? { span: raw.identity.span } : {},
       exportName: raw.identity.exportName
     },
     identity: {
@@ -899,6 +900,9 @@ function buildMetadata(raw) {
       label: raw.sourceDocumentLabel
     });
   }
+  if (raw.mount !== void 0) {
+    metadata = (0, import_behavioral_ir2.withMountMetadata)(metadata, raw.mount);
+  }
   return Object.keys(metadata).length > 0 ? metadata : null;
 }
 function buildHttpMetadataValue(raw) {

package/dist/index.d.cts

@@ -1292,6 +1292,16 @@ interface DiscoveredCustomUnit {
     kind: string;
     /** Discovered name (e.g. "UserCard"). */
     name: string;
+    /**
+     * The unit's callable identity, when the pack states one: the module
+     * it lives in and the name it goes by there. A server action is the
+     * case, so intent and the keyed pairing pass can refer to it. The
+     * adapter puts both on the unit's function-call binding.
+     */
+    functionCallInfo?: {
+        module: string;
+        exportName: string;
+    };
     /**
      * Terminal patterns to extract from this unit's body. Defaults to
      * the pack-level `terminals` when unset.
@@ -2017,6 +2027,20 @@ interface CallOps {
      * `model("User", schema)` call it was declared as says everything.
      */
     callee(): CallOps | null;
+    /**
+     * Whether the call goes to a name the program bound, rather than to
+     * an expression written in place. `useAppStore(...)` does;
+     * `create()(...)` does not, even though both are bare calls.
+     */
+    namedCallee?(): boolean;
+    /**
+     * The properties the function argument in this position reads off
+     * its first parameter, one per distinct first segment: `(s) =>
+     * s.bears.count` reads `bears`, and a parameter used whole reads
+     * `*`. Null when the argument is not a function of one plain
+     * parameter.
+     */
+    parameterReadsAt?(index: number): readonly string[] | null;
     /**
      * What a named property of the object an argument states says. A
      * property bag is not a call, so nothing else here reaches into one.
@@ -2029,6 +2053,15 @@ interface CallOps {
      * for a pack whose rule has to walk it.
      */
     valueAt(index: number): ValueOps | null;
+    /**
+     * The one call behind the receiver the origin accepts, however many
+     * name, construction, or query hops separate them. Mongoose's
+     * `model(...)` behind a document is the picture. Null when nothing
+     * behind the receiver matches, when two distinct calls do (picking
+     * one would depend on the order facts arrived), and for an origin
+     * kind with no construction to hand back.
+     */
+    anchorCall?(origin: ReceiverOrigin): CallOps | null;
 }
 /**
  * The property an adapter puts its ops on, in the context it hands a
@@ -2251,6 +2284,11 @@ interface RawCodeStructure {
             start: number;
             end: number;
         };
+        /** Character offsets of the unit, when a source position backs it. */
+        span?: {
+            start: number;
+            end: number;
+        };
         exportName: string | null;
         exportPath: string[] | null;
     };
@@ -2292,6 +2330,11 @@ interface RawCodeStructure {
     /** The document this unit was read out of, when something else read out of
      * the same document states what this one relies on. */
     sourceDocumentLabel?: string;
+    /** Set when several mounts serve the declaration and this unit is one of them. */
+    mount?: {
+        siblings: number;
+        prefix: string;
+    };
     /** The extractor cannot derive this. An adapter that has the SDL and knows
      * which field the resolver serves fills it in. */
     graphqlDeclaredContract?: GraphqlDeclaredContract;

package/dist/index.d.ts

@@ -1292,6 +1292,16 @@ interface DiscoveredCustomUnit {
     kind: string;
     /** Discovered name (e.g. "UserCard"). */
     name: string;
+    /**
+     * The unit's callable identity, when the pack states one: the module
+     * it lives in and the name it goes by there. A server action is the
+     * case, so intent and the keyed pairing pass can refer to it. The
+     * adapter puts both on the unit's function-call binding.
+     */
+    functionCallInfo?: {
+        module: string;
+        exportName: string;
+    };
     /**
      * Terminal patterns to extract from this unit's body. Defaults to
      * the pack-level `terminals` when unset.
@@ -2017,6 +2027,20 @@ interface CallOps {
      * `model("User", schema)` call it was declared as says everything.
      */
     callee(): CallOps | null;
+    /**
+     * Whether the call goes to a name the program bound, rather than to
+     * an expression written in place. `useAppStore(...)` does;
+     * `create()(...)` does not, even though both are bare calls.
+     */
+    namedCallee?(): boolean;
+    /**
+     * The properties the function argument in this position reads off
+     * its first parameter, one per distinct first segment: `(s) =>
+     * s.bears.count` reads `bears`, and a parameter used whole reads
+     * `*`. Null when the argument is not a function of one plain
+     * parameter.
+     */
+    parameterReadsAt?(index: number): readonly string[] | null;
     /**
      * What a named property of the object an argument states says. A
      * property bag is not a call, so nothing else here reaches into one.
@@ -2029,6 +2053,15 @@ interface CallOps {
      * for a pack whose rule has to walk it.
      */
     valueAt(index: number): ValueOps | null;
+    /**
+     * The one call behind the receiver the origin accepts, however many
+     * name, construction, or query hops separate them. Mongoose's
+     * `model(...)` behind a document is the picture. Null when nothing
+     * behind the receiver matches, when two distinct calls do (picking
+     * one would depend on the order facts arrived), and for an origin
+     * kind with no construction to hand back.
+     */
+    anchorCall?(origin: ReceiverOrigin): CallOps | null;
 }
 /**
  * The property an adapter puts its ops on, in the context it hands a
@@ -2251,6 +2284,11 @@ interface RawCodeStructure {
             start: number;
             end: number;
         };
+        /** Character offsets of the unit, when a source position backs it. */
+        span?: {
+            start: number;
+            end: number;
+        };
         exportName: string | null;
         exportPath: string[] | null;
     };
@@ -2292,6 +2330,11 @@ interface RawCodeStructure {
     /** The document this unit was read out of, when something else read out of
      * the same document states what this one relies on. */
     sourceDocumentLabel?: string;
+    /** Set when several mounts serve the declaration and this unit is one of them. */
+    mount?: {
+        siblings: number;
+        prefix: string;
+    };
     /** The extractor cannot derive this. An adapter that has the SDL and knows
      * which field the resolver serves fills it in. */
     graphqlDeclaredContract?: GraphqlDeclaredContract;

package/dist/index.js

@@ -4,6 +4,7 @@ import {
   exchangesHttpResponses,
   withGraphqlMetadata,
   withHttpMetadata,
+  withMountMetadata,
   withSourceDocumentMetadata
 } from "@suss/behavioral-ir";
 
@@ -823,6 +824,7 @@ function assembleSummary(raw, options = DEFAULT_OPTIONS) {
     location: {
       file: raw.identity.file,
       range: raw.identity.range,
+      ...raw.identity.span !== void 0 ? { span: raw.identity.span } : {},
       exportName: raw.identity.exportName
     },
     identity: {
@@ -856,6 +858,9 @@ function buildMetadata(raw) {
       label: raw.sourceDocumentLabel
     });
   }
+  if (raw.mount !== void 0) {
+    metadata = withMountMetadata(metadata, raw.mount);
+  }
   return Object.keys(metadata).length > 0 ? metadata : null;
 }
 function buildHttpMetadataValue(raw) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suss/extractor",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "type": "module",
   "description": "Framework-agnostic extraction pipeline that turns raw extractions into suss behavioral summaries.",
   "keywords": [
@@ -45,7 +45,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@suss/behavioral-ir": "0.18.0"
+    "@suss/behavioral-ir": "0.20.0"
   },
   "devDependencies": {
     "tsup": "*",