@callidescope/nx 0.0.29 → 0.0.31

package/dist/src/index.d.ts

@@ -128,19 +128,19 @@ declare interface InferTargetsArguments {
 declare interface LoadedRunConfiguration {
     readonly configuration: ResolvedCallidescopeConfiguration;
     /**
-     * Where the configuration was read from, or nothing when none was found.
+     * Where the configuration was read from.
      *
      * The path the loader settled on rather than the one it was handed, since a
-     * search may have answered — and a run resolves a project's own
-     * configuration relative to it.
+     * relative path is resolved before it is read — and a run resolves a
+     * project's own configuration relative to it.
      */
-    readonly path: string | undefined;
+    readonly path: string;
 }
 
 /** Arguments for loading the configuration one run is judged by. */
 declare interface LoadRunConfigurationArguments {
-    /** Resolved from this plugin's `nx.json` registration when omitted. */
-    readonly configurationPath?: string | undefined;
+    /** The workspace configuration file, as this plugin's registration names it. */
+    readonly configurationPath: string;
     readonly workspaceRoot: string;
 }
 
@@ -148,7 +148,7 @@ declare interface LoadRunConfigurationArguments {
 export declare interface LookupArguments {
     /** Each `<file>#<qualified-name>`, the form every callidescope stack prints. */
     readonly addresses: readonly string[];
-    readonly configurationPath?: string | undefined;
+    readonly configurationPath: string;
     /** Workspace-relative directories the lookup resolves the address against. */
     readonly directories: readonly string[];
     readonly format?: CallidescopeOutputFormat | undefined;
@@ -180,7 +180,7 @@ export declare class MainModule {
  *
  * `codependix-nx-projects` declares a near-identical shape and reads it out of the
  * graph the same way. They are deliberately not shared: the two packages sit
- * in different toolchains, and `configuration/eslint.config.ts` lets this one
+ * in different toolchains, and `projects/configuration/eslint.config.ts` lets this one
  * depend on nothing but `logging` precisely so `@nx/devkit` cannot spread. A
  * package extracted to hold both would have to be depended on by both, which
  * is the coupling that rule exists to prevent.
@@ -206,15 +206,20 @@ export declare class OptionsModule {
  * from being built.
  */
 export declare class OptionsService {
-    constructor();
+    private readonly configurationService;
+    constructor(configurationService: ConfigurationService);
     /** Narrows an untrusted value to an array without widening it to `any`. */
     private isUnknownArray;
-    /** Reads one `nx.json` plugin entry, if it is this plugin's registration. */
-    private readEntryConfigurationPath;
-    /** Reads this plugin's `configurationPath` out of an `nx.json`, if it names one. */
-    private readRegisteredConfigurationPath;
     /** Reads a string field from an untrusted record, or `undefined`. */
     private readString;
+    /**
+     * Reads the `configuration` option of an executor, refusing a missing one.
+     *
+     * Nx validates the option against `schema.json`, but a target written by hand
+     * reaches an executor unchecked, so the same refusal the plugin option gets —
+     * decided by the configuration layer — is applied here.
+     */
+    readConfiguration(value: unknown): string;
     /**
      * Narrows an untrusted output format to one callidescope renders.
      *
@@ -223,6 +228,17 @@ export declare class OptionsService {
      * configuration chose rather than reaching the renderer.
      */
     readFormat(value: unknown): CallidescopeOutputFormat | undefined;
+    /**
+     * Reads the two options every lookup executor shares, the configuration
+     * path refused when missing and the format narrowed.
+     */
+    readLookupOptions(options: {
+        configuration: unknown;
+        format?: unknown;
+    }): {
+        configurationPath: string;
+        format: CallidescopeOutputFormat | undefined;
+    };
     /**
      * Reads a list of strings out of an executor's options.
      *
@@ -234,19 +250,12 @@ export declare class OptionsService {
      */
     readStringList(value: unknown): string[];
     /**
-     * Resolves the configuration path a workspace means, without assuming one.
+     * Resolves the effective plugin options from an untrusted value.
      *
-     * Nx passes plugin options to `createNodes` and to executors, but not to
-     * anything run outside Nx, so a caller that has a filesystem resolves the
-     * path itself rather than assuming a workspace keeps its configuration at
-     * the root. `exists` is supplied by the caller because the callers do not
-     * agree on what a filesystem is.
+     * Every field has a default except `configurationPath`: the workspace
+     * configuration is never searched for, so a registration that does not name
+     * it is refused rather than guessed at.
      */
-    resolveConfigurationPath(args: {
-        exists: (candidatePath: string) => boolean;
-        nxConfiguration: unknown;
-    }): string;
-    /** Resolves the effective plugin options from an untrusted value. */
     resolvePluginOptions(options: unknown): CallidescopePluginOptions;
 }
 
@@ -628,26 +637,17 @@ declare interface ResolveTraceScopeArguments {
 }
 
 /**
- * Finds and reads the callidescope configuration one run is judged by.
+ * Reads the callidescope configuration one run is judged by.
  *
  * Its own service rather than more of `PluginService`, because every target
- * here starts by answering the same question — which configuration file is
- * this run's — and none of them can be written until it is answered. Keeping
+ * here starts by reading the same file — the one its `configurationPath` names
+ * — and none of them can be written until it is read. Keeping
  * it apart also keeps the verdict and the inference in `PluginService` beside
  * each other, which is where the rules a reader comes looking for are.
  */
 declare class RunConfigurationService {
     private readonly configurationService;
-    private readonly optionsService;
-    constructor(configurationService: ConfigurationService, optionsService: OptionsService);
-    /**
-     * Reads the workspace's `nx.json`, so this plugin's own registration can be
-     * consulted for a configuration path an executor was not given.
-     *
-     * Unreadable or malformed is not an error: the caller falls back to the
-     * conventional filenames, which a workspace with no registration gets anyway.
-     */
-    private readNxConfiguration;
+    constructor(configurationService: ConfigurationService);
     /**
      * Resolves and loads the configuration one run is judged by.
      *
@@ -668,8 +668,8 @@ declare type RunGateArguments = Omit<RunTraceArguments, "format">;
 
 /** Arguments for tracing one resolved selection. */
 declare interface RunTraceArguments {
-    /** Resolved from this plugin's `nx.json` registration when omitted. */
-    readonly configurationPath?: string | undefined;
+    /** The workspace configuration file, as this plugin's registration names it. */
+    readonly configurationPath: string;
     readonly directories: readonly string[];
     /** What the run prints. Defaults to markdown when omitted. */
     readonly format?: CallidescopeOutputFormat | undefined;

package/dist/src/index.js

@@ -1,4 +1,4 @@
-import { _ as e, a as t, b as n, d as r, f as i, g as a, h as o, i as s, l as c, m as l, n as u, o as d, p as f, r as p, s as m, t as h, u as g, v as _, y as v } from "../plugin-context.utilities-ByGoz-_t.js";
+import { _ as e, a as t, b as n, d as r, f as i, g as a, h as o, i as s, l as c, m as l, n as u, o as d, p as f, r as p, s as m, t as h, u as g, v as _, y as v } from "../plugin-context.utilities-B2BXtiTJ.js";
 import y from "node:path";
 //#region projects/ic-suite/callidescope/callidescope-nx/src/index.ts
 var b = {

package/package.json

@@ -4,11 +4,11 @@
     "url": "https://github.com/organizzolini/codebase/issues"
   },
   "dependencies": {
-    "@callidescope/cli": "0.0.29",
-    "@callidescope/configuration": "0.0.29",
-    "@callidescope/core": "0.0.28",
-    "@callidescope/graph": "0.0.28",
-    "@callidescope/output": "0.0.28",
+    "@callidescope/cli": "0.0.31",
+    "@callidescope/configuration": "0.0.31",
+    "@callidescope/core": "0.0.30",
+    "@callidescope/graph": "0.0.30",
+    "@callidescope/output": "0.0.30",
     "@nestjs/common": "^11.1.21 || ^12.0.1",
     "@nestjs/core": "^11.1.21 || ^12.0.1",
     "@nx/devkit": "^23.0.0",
@@ -79,5 +79,5 @@
     "strict": true
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.0.29"
+  "version": "0.0.31"
 }

package/src/executors/breadth/schema.json

@@ -7,8 +7,8 @@
       "items": { "type": "string" },
       "type": "array"
     },
-    "configurationPath": {
-      "description": "Path to the callidescope configuration file, relative to the workspace root.",
+    "configuration": {
+      "description": "Required. Path to the callidescope configuration file, relative to the workspace root.",
       "type": "string"
     },
     "format": {
@@ -32,7 +32,7 @@
       "type": "boolean"
     }
   },
-  "required": ["addresses"],
+  "required": ["addresses", "configuration"],
   "title": "Callidescope breadth",
   "type": "object"
 }

package/src/executors/depth/schema.json

@@ -7,8 +7,8 @@
       "items": { "type": "string" },
       "type": "array"
     },
-    "configurationPath": {
-      "description": "Path to the callidescope configuration file, relative to the workspace root.",
+    "configuration": {
+      "description": "Required. Path to the callidescope configuration file, relative to the workspace root.",
       "type": "string"
     },
     "format": {
@@ -32,7 +32,7 @@
       "type": "boolean"
     }
   },
-  "required": ["addresses"],
+  "required": ["addresses", "configuration"],
   "title": "Callidescope depth",
   "type": "object"
 }

package/src/executors/gate/schema.json

@@ -2,8 +2,8 @@
   "$schema": "http://json-schema.org/schema",
   "description": "Fail a project whose call stacks broke the depth or breadth limits it is held to, resolved against the project and its Nx dependencies.",
   "properties": {
-    "configurationPath": {
-      "description": "Path to the callidescope configuration file, relative to the workspace root.",
+    "configuration": {
+      "description": "Required. Path to the callidescope configuration file, relative to the workspace root.",
       "type": "string"
     },
     "projects": {
@@ -22,7 +22,7 @@
       "type": "boolean"
     }
   },
-  "required": [],
+  "required": ["configuration"],
   "title": "Callidescope gate",
   "type": "object"
 }

package/src/executors/trace/schema.json

@@ -2,8 +2,8 @@
   "$schema": "http://json-schema.org/schema",
   "description": "Trace a project's call stacks with callidescope, following its Nx dependencies.",
   "properties": {
-    "configurationPath": {
-      "description": "Path to the callidescope configuration file, relative to the workspace root.",
+    "configuration": {
+      "description": "Required. Path to the callidescope configuration file, relative to the workspace root.",
       "type": "string"
     },
     "format": {
@@ -27,7 +27,7 @@
       "type": "boolean"
     }
   },
-  "required": [],
+  "required": ["configuration"],
   "title": "Callidescope trace",
   "type": "object"
 }