@callidescope/nx 0.0.1

package/dist/plugin.utilities-CX_Q5t8_.js

@@ -0,0 +1,18 @@
+import { n as e, r as t } from "./plugin-context.utilities-bBTXF3Wk.js";
+//#region packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.utilities.ts
+async function n(n) {
+	let r = await e(), i = r.readStringList(n.options.projects), a = r.readStringList(n.options.tags);
+	if (i.length === 0 && a.length === 0) {
+		if (n.context.projectName === void 0) throw Error(`The callidescope ${n.label} executor must be run against a project, or given \`projects\` or \`tags\`.`);
+		i.push(n.context.projectName);
+	}
+	let o = await t(), s = await o.resolveTraceScope({
+		projectNames: i,
+		tags: a,
+		withDependencies: n.options.withDependencies !== !1
+	});
+	if (s.unknownNames.length > 0 || s.unmatchedTags.length > 0) throw Error(o.describeRefusedScope(s));
+	return s;
+}
+//#endregion
+export { n as t };

package/dist/src/executors/breadth/executor.d.ts

@@ -0,0 +1,34 @@
+import { ExecutorContext } from '@nx/devkit';
+
+/** Options the `depth` and `breadth` executors accept. */
+declare interface AddressExecutorOptions {
+    /**
+     * The callables to look up, each `<file>#<qualified-name>`.
+     *
+     * Plural to match the `--addresses` the command line takes, so one target
+     * run answers about a whole rename rather than one callable at a time.
+     */
+    readonly addresses?: string[] | undefined;
+    readonly configurationPath?: string | undefined;
+    readonly format?: string | undefined;
+    /** Nx project names to resolve against, replacing the target's own project. */
+    readonly projects?: string[] | undefined;
+    /** Nx project tags to resolve against, matching a project carrying any of them. */
+    readonly tags?: string[] | undefined;
+    /** Widen the selection along the Nx dependency graph. Defaults to true. */
+    readonly withDependencies?: boolean | undefined;
+}
+
+/**
+ * Prints each named callable's direct callers and callees side by side — the two questions a rename or a refactor needs answered together.
+ *
+ * The addresses are resolved against the target's own project and its Nx
+ * dependencies rather than the whole workspace, which is both faster than the
+ * `callidescope breadth` command and the set the addresses actually belong to.
+ */
+declare function breadthExecutor(options: AddressExecutorOptions, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;
+export default breadthExecutor;
+
+export { }

package/dist/src/executors/breadth/executor.js

@@ -0,0 +1,11 @@
+import { t as e } from "../../../address.utilities-DJG3-xMW.js";
+//#region packages/ic-suite/callidescope/callidescope-nx/src/executors/breadth/executor.ts
+async function t(t, n) {
+	return await e({
+		context: n,
+		kind: "breadth",
+		options: t
+	});
+}
+//#endregion
+export { t as default };

package/dist/src/executors/depth/executor.d.ts

@@ -0,0 +1,34 @@
+import { ExecutorContext } from '@nx/devkit';
+
+/** Options the `depth` and `breadth` executors accept. */
+declare interface AddressExecutorOptions {
+    /**
+     * The callables to look up, each `<file>#<qualified-name>`.
+     *
+     * Plural to match the `--addresses` the command line takes, so one target
+     * run answers about a whole rename rather than one callable at a time.
+     */
+    readonly addresses?: string[] | undefined;
+    readonly configurationPath?: string | undefined;
+    readonly format?: string | undefined;
+    /** Nx project names to resolve against, replacing the target's own project. */
+    readonly projects?: string[] | undefined;
+    /** Nx project tags to resolve against, matching a project carrying any of them. */
+    readonly tags?: string[] | undefined;
+    /** Widen the selection along the Nx dependency graph. Defaults to true. */
+    readonly withDependencies?: boolean | undefined;
+}
+
+/**
+ * Prints every call stack above and below each named callable — every caller chain up to a root, every callee chain down to a leaf.
+ *
+ * The addresses are resolved against the target's own project and its Nx
+ * dependencies rather than the whole workspace, which is both faster than the
+ * `callidescope depth` command and the set the addresses actually belong to.
+ */
+declare function depthExecutor(options: AddressExecutorOptions, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;
+export default depthExecutor;
+
+export { }

package/dist/src/executors/depth/executor.js

@@ -0,0 +1,11 @@
+import { t as e } from "../../../address.utilities-DJG3-xMW.js";
+//#region packages/ic-suite/callidescope/callidescope-nx/src/executors/depth/executor.ts
+async function t(t, n) {
+	return await e({
+		context: n,
+		kind: "depth",
+		options: t
+	});
+}
+//#endregion
+export { t as default };

package/dist/src/executors/gate/executor.d.ts

@@ -0,0 +1,37 @@
+import { ExecutorContext } from '@nx/devkit';
+
+/**
+ * Fails one project's task when its call stacks broke the limits it is held to.
+ *
+ * The gate rather than the trace: `trace` prints every stack in a project for
+ * somebody reading it, and this prints only the stacks and callables that
+ * decided the exit code, which is what a failed pipeline is asked to explain.
+ *
+ * Inferred onto every project holding a `tsconfig.json` that the workspace
+ * configuration does not exclude, so `nx affected -t gate` gates a branch by
+ * the projects it changed — and a project whose stacks got deeper is named by
+ * the task that failed, which one workspace-wide task never could.
+ *
+ * With neither `projects` nor `tags` given, the selection is the project this
+ * target belongs to, widened along the Nx dependency graph: a stack truncated
+ * at a package boundary measures the wrong thing. The widening decides what is
+ * traced and not what is judged — a dependency's breach fails the dependency's
+ * own gate, which is the task named after the project that owns it.
+ */
+declare function gateExecutor(options: GateExecutorOptions, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;
+export default gateExecutor;
+
+/** Options the gate executor accepts. */
+declare interface GateExecutorOptions {
+    readonly configurationPath?: string | undefined;
+    /** Nx project names to gate, replacing the target's own project. */
+    readonly projects?: string[] | undefined;
+    /** Nx project tags to gate, selecting a project carrying any of them. */
+    readonly tags?: string[] | undefined;
+    /** Widen the selection along the Nx dependency graph. Defaults to true. */
+    readonly withDependencies?: boolean | undefined;
+}
+
+export { }

package/dist/src/executors/gate/executor.js

@@ -0,0 +1,20 @@
+import { c as e, r as t } from "../../../plugin-context.utilities-bBTXF3Wk.js";
+import { t as n } from "../../../plugin.utilities-CX_Q5t8_.js";
+//#region packages/ic-suite/callidescope/callidescope-nx/src/executors/gate/executor.ts
+async function r(r, i) {
+	let a = await n({
+		context: i,
+		label: "gate",
+		options: r
+	});
+	if (a.directories.length === 0) return process.stdout.write(`${e}\n`), { success: !1 };
+	let o = await (await t()).runGate({
+		...r.configurationPath === void 0 ? {} : { configurationPath: r.configurationPath },
+		directories: a.directories,
+		judgedProjectNames: a.selectedDirectories,
+		workspaceRoot: i.root
+	});
+	return process.stdout.write(`${o.report}\n`), { success: o.ok };
+}
+//#endregion
+export { r as default };

package/dist/src/executors/trace/executor.d.ts

@@ -0,0 +1,33 @@
+import { ExecutorContext } from '@nx/devkit';
+
+/**
+ * Traces one selection of Nx projects with callidescope.
+ *
+ * Inferred onto every project holding a `tsconfig.json`, so
+ * `nx run-many -t trace` covers the workspace,
+ * `nx run-many -t trace --projects=tag:type:package` covers a category, and
+ * `nx affected -t trace` covers only what changed — none of which the
+ * workspace-wide command can do, and none of which needs a flag of its own:
+ * selecting projects is what the task runner is for.
+ *
+ * With neither `projects` nor `tags` given, the selection is the project this
+ * target belongs to.
+ */
+declare function traceExecutor(options: TraceExecutorOptions, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;
+export default traceExecutor;
+
+/** Options the trace executor accepts. */
+declare interface TraceExecutorOptions {
+    readonly configurationPath?: string | undefined;
+    readonly format?: string | undefined;
+    /** Nx project names to trace, replacing the target's own project. */
+    readonly projects?: string[] | undefined;
+    /** Nx project tags to trace, selecting a project carrying any of them. */
+    readonly tags?: string[] | undefined;
+    /** Widen the selection along the Nx dependency graph. Defaults to true. */
+    readonly withDependencies?: boolean | undefined;
+}
+
+export { }

package/dist/src/executors/trace/executor.js

@@ -0,0 +1,21 @@
+import { n as e, r as t } from "../../../plugin-context.utilities-bBTXF3Wk.js";
+import { t as n } from "../../../plugin.utilities-CX_Q5t8_.js";
+//#region packages/ic-suite/callidescope/callidescope-nx/src/executors/trace/executor.ts
+async function r(r, i) {
+	let a = await n({
+		context: i,
+		label: "trace",
+		options: r
+	});
+	if (a.directories.length === 0) return { success: !0 };
+	let o = await e(), s = await (await t()).runTrace({
+		...r.configurationPath === void 0 ? {} : { configurationPath: r.configurationPath },
+		directories: a.directories,
+		format: o.readFormat(r.format),
+		judgedProjectNames: a.selectedDirectories,
+		workspaceRoot: i.root
+	});
+	return process.stdout.write(`${s.report}\n`), { success: s.ok };
+}
+//#endregion
+export { r as default };