ttsc 0.20.1 → 0.22.0

package/src/plugin/internal/loadProjectPlugins.ts

@@ -65,6 +65,7 @@ export function loadProjectPlugins(options: {
   entries?: readonly ITtscProjectPluginConfig[] | false;
   env?: NodeJS.ProcessEnv;
   file?: string;
+  onWatchInputs?: (inputs: readonly string[]) => void;
   pluginConfigDir?: string;
   projectRoot?: string;
   tsconfig?: string;
@@ -86,6 +87,7 @@ export function loadProjectPlugins(options: {
           (entry) => entry.config.enabled !== false,
         );
   if (entries.length === 0) {
+    options.onWatchInputs?.([]);
     return {
       nativePlugins: [],
       project,
@@ -150,6 +152,12 @@ export function loadProjectPlugins(options: {
       stage,
     };
   });
+  options.onWatchInputs?.(
+    records.flatMap((record) => [
+      record.source,
+      ...(record.contributors?.map((contributor) => contributor.source) ?? []),
+    ]),
+  );
   const linkedContributors = records
     .filter((record) => record.stage === "transform")
     .flatMap((record) =>

package/src/structures/ITtscPluginCapabilities.ts

@@ -46,6 +46,40 @@ export interface ITtscPluginCapabilities {
    */
   projectContextArgs?: boolean;
 
+  /**
+   * Whether the LSP sidecar implements the standalone `lsp-project-diagnostics`
+   * command.
+   *
+   * The command evaluates project rules without an open document. It is
+   * independent of `projectInputs`, which publishes only filesystem topology.
+   *
+   * @default false
+   */
+  projectDiagnostics?: boolean;
+
+  /**
+   * Whether the sidecar implements the `project-inputs` command. The command
+   * publishes normalized exact paths and glob populations declared by enabled
+   * project rules without loading a TypeScript Program.
+   *
+   * @default false
+   */
+  projectInputs?: boolean;
+
+  /**
+   * Whether the check-stage sidecar implements the newline-delimited
+   * `check-serve` protocol used by `ttsc check --watch`.
+   *
+   * A resident check host keeps one no-emit TypeScript Program across
+   * compatible source and declared external-input changes while constructing a
+   * fresh rule engine and reporter for every request. The launcher retains the
+   * spawn-per-cycle path when this capability is absent and never uses it for
+   * transform or emit work.
+   *
+   * @default false
+   */
+  residentCheck?: boolean;
+
   /**
    * Whether the sidecar accepts `--singleThreaded` and `--checkers` on its
    * command line. The lint sidecar parses both flags via `parseSubcommandFlags`

package/src/structures/internal/ITtscProjectInputSnapshot.ts

@@ -0,0 +1,29 @@
+/** Normalized local filesystem dependencies published by project rules. */
+export interface ITtscProjectInputSnapshot {
+  /** Exact absolute paths, retained even while missing. */
+  files: readonly string[];
+  /** Absolute glob patterns using forward-slash separators. */
+  globs: readonly string[];
+  /** Exact paths whose change invalidates plugin/execution selection. */
+  reloadFiles?: readonly string[];
+  /** Directories whose immediate topology changes execution selection. */
+  reloadDirectories?: readonly string[];
+  /** Physical project root that anchored relative declarations. */
+  root: string;
+  /**
+   * The spellings the contributors published, before identity normalization.
+   *
+   * Normalizing a declaration resolves it through every symlink on its way, so
+   * the retained snapshot names the file the link currently points at rather
+   * than the link. That is what every comparison needs and the wrong thing to
+   * watch: retargeting or replacing the link is exactly what decides which
+   * bytes the declaration names next, and it happens at the spelling that
+   * normalization discarded. Consumers that install watchers keep both.
+   */
+  declared?: {
+    files: readonly string[];
+    globs: readonly string[];
+    reloadFiles?: readonly string[];
+    reloadDirectories?: readonly string[];
+  };
+}

package/src/structures/internal/TtscSingleFileEmitOptions.ts

@@ -1,3 +1,4 @@
+import type { ITtscProjectInputSnapshot } from "./ITtscProjectInputSnapshot";
 import type { TtscCommonOptions } from "./TtscCommonOptions";
 
 /** Internal options for emitting one source file through the file-argument path. */
@@ -10,4 +11,8 @@ export interface TtscSingleFileEmitOptions extends TtscCommonOptions {
   out?: string;
   /** Suppress summary banners from ttsc/native sidecars. Defaults to `true`. */
   quiet?: boolean;
+  /** Receive native-plugin source roots when a watch owns this invocation. */
+  onWatchInputs?: (inputs: readonly string[]) => void;
+  /** Receive project-rule filesystem inputs when a watch owns this invocation. */
+  onProjectInputs?: (inputs: ITtscProjectInputSnapshot) => void;
 }