ttsc 0.32.0 → 0.32.1

package/lib/plugin/internal/load/collectProjectHostInputs.d.ts

@@ -2,6 +2,8 @@ import type { ITtscParsedProjectConfig } from "../../../structures/internal/ITts
 /**
  * Return config ancestry and package-discovery manifest inputs, including
  * missing nearer candidates that could redirect the selected package later.
+ * Discovery uses the selected config directory or explicit pluginConfigDir,
+ * matching the entry resolver independently of the compiler's source root.
  *
  * @evidence contracts/common.md#principled-implementation Config ancestry, lexical selection and missing config candidates influence selection; automatic discovery additionally observes nearest manifest and dependency search candidates through the selecting root. The project reader separately states whether these config observations are complete.
  * @evidence contracts/common.md#clear-and-simple-design The collector obtains package resolution from its owner and assembles universal loader inputs, leaving source Program dependencies to the native reference graph.
@@ -13,4 +15,4 @@ import type { ITtscParsedProjectConfig } from "../../../structures/internal/ITts
  *
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The Set and returned array belong to this call, with no cross-call retention or acquired open resource.
  */
-export declare function collectProjectHostInputs(project: ITtscParsedProjectConfig, includePluginDiscovery?: boolean): string[];
+export declare function collectProjectHostInputs(project: ITtscParsedProjectConfig, includePluginDiscovery?: boolean, pluginConfigDir?: string): string[];

package/lib/plugin/internal/load/collectProjectHostInputs.js

@@ -7,10 +7,13 @@ exports.collectProjectHostInputs = collectProjectHostInputs;
 const node_module_1 = require("node:module");
 const node_path_1 = __importDefault(require("node:path"));
 const PluginPackageResolution_1 = require("./PluginPackageResolution");
+const ProjectPluginEntries_1 = require("./ProjectPluginEntries");
 const moduleResolutionBaseSelects_1 = require("./moduleResolutionBaseSelects");
 /**
  * Return config ancestry and package-discovery manifest inputs, including
  * missing nearer candidates that could redirect the selected package later.
+ * Discovery uses the selected config directory or explicit pluginConfigDir,
+ * matching the entry resolver independently of the compiler's source root.
  *
  * @evidence contracts/common.md#principled-implementation Config ancestry, lexical selection and missing config candidates influence selection; automatic discovery additionally observes nearest manifest and dependency search candidates through the selecting root. The project reader separately states whether these config observations are complete.
  * @evidence contracts/common.md#clear-and-simple-design The collector obtains package resolution from its owner and assembles universal loader inputs, leaving source Program dependencies to the native reference graph.
@@ -22,11 +25,11 @@ const moduleResolutionBaseSelects_1 = require("./moduleResolutionBaseSelects");
  *
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The Set and returned array belong to this call, with no cross-call retention or acquired open resource.
  */
-function collectProjectHostInputs(project, includePluginDiscovery = true) {
+function collectProjectHostInputs(project, includePluginDiscovery = true, pluginConfigDir) {
     const inputs = new Set([...project.configPaths, ...(project.configInputs ?? [])].map((file) => node_path_1.default.resolve(file)));
     if (!includePluginDiscovery)
         return [...inputs].sort();
-    const manifestCandidates = PluginPackageResolution_1.PluginPackageResolution.collectNearestPackageJsonCandidates(project.root);
+    const manifestCandidates = PluginPackageResolution_1.PluginPackageResolution.collectNearestPackageJsonCandidates(ProjectPluginEntries_1.ProjectPluginEntries.resolvePluginBaseDir(project, pluginConfigDir));
     for (const candidate of manifestCandidates)
         inputs.add(candidate);
     const manifest = manifestCandidates.find(PluginPackageResolution_1.PluginPackageResolution.existingFile);

package/lib/plugin/internal/load/collectProjectHostInputs.js.map

@@ -1 +1 @@
-{"version":3,"file":"collectProjectHostInputs.js","sourceRoot":"","sources":["../../../../src/plugin/internal/load/collectProjectHostInputs.ts"],"names":[],"mappings":";;;;;;AAAA,6CAA4C;AAC5C,0DAA6B;AAG7B,uEAAoE;AACpE,+EAA4E;AAE5E;;;;;;;;;;;;;GAaG;AACH,kCACE,OAAiC,EACjC,sBAAsB,GAAY,IAAI;IAEtC,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACrE,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CACnB,CACF,CAAC;IACF,IAAI,CAAC,sBAAsB;QAAE,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,kBAAkB,GACtB,iDAAuB,CAAC,mCAAmC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,KAAK,MAAM,SAAS,IAAI,kBAAkB;QAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CACtC,iDAAuB,CAAC,YAAY,CACrC,CAAC;IACF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,eAAe,GACnB,iDAAuB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,WAAW,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC3C,KAAK,MAAM,UAAU,IAAI,iDAAuB,CAAC,qBAAqB,CACpE,eAAe,CAChB,EAAE,CAAC;gBACF,MAAM,kBAAkB,GACtB,iDAAuB,CAAC,4BAA4B,CAClD,UAAU,EACV,WAAW,CACZ,CAAC;gBACJ,KAAK,MAAM,SAAS,IAAI,mCAAmC,CACzD,UAAU,EACV,QAAQ,EACR,kBAAkB,CACnB,EAAE,CAAC;oBACF,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC;gBACD,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;oBACrC,MAAM,CAAC,GAAG,CAAC,mBAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,SAAS,mCAAmC,CAC1C,WAAmB,EACnB,UAAkB,EAClB,gBAAoC;IAEpC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,UAAU,IAAI,IAAA,2BAAa,EAAC,UAAU,CAAC,CAAC,OAAO,CAAC,KAAK,CAC9D,WAAW,CACZ,IAAI,EAAE,EAAE,CAAC;QACR,MAAM,gBAAgB,GAAG,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1E,GAAG,CAAC,IAAI,CAAC,mBAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC;QACtD,IAAI,IAAA,yDAA2B,EAAC,gBAAgB,EAAE,gBAAgB,EAAE,EAAE,CAAC;YACrE,MAAM;IACV,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"collectProjectHostInputs.js","sourceRoot":"","sources":["../../../../src/plugin/internal/load/collectProjectHostInputs.ts"],"names":[],"mappings":";;;;;;AAAA,6CAA4C;AAC5C,0DAA6B;AAG7B,uEAAoE;AACpE,iEAA8D;AAC9D,+EAA4E;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,kCACE,OAAiC,EACjC,sBAAsB,GAAY,IAAI,EACtC,eAAwB;IAExB,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACrE,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CACnB,CACF,CAAC;IACF,IAAI,CAAC,sBAAsB;QAAE,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,kBAAkB,GACtB,iDAAuB,CAAC,mCAAmC,CACzD,2CAAoB,CAAC,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,CACpE,CAAC;IACJ,KAAK,MAAM,SAAS,IAAI,kBAAkB;QAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CACtC,iDAAuB,CAAC,YAAY,CACrC,CAAC;IACF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,eAAe,GACnB,iDAAuB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,WAAW,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC3C,KAAK,MAAM,UAAU,IAAI,iDAAuB,CAAC,qBAAqB,CACpE,eAAe,CAChB,EAAE,CAAC;gBACF,MAAM,kBAAkB,GACtB,iDAAuB,CAAC,4BAA4B,CAClD,UAAU,EACV,WAAW,CACZ,CAAC;gBACJ,KAAK,MAAM,SAAS,IAAI,mCAAmC,CACzD,UAAU,EACV,QAAQ,EACR,kBAAkB,CACnB,EAAE,CAAC;oBACF,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC;gBACD,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;oBACrC,MAAM,CAAC,GAAG,CAAC,mBAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,SAAS,mCAAmC,CAC1C,WAAmB,EACnB,UAAkB,EAClB,gBAAoC;IAEpC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,UAAU,IAAI,IAAA,2BAAa,EAAC,UAAU,CAAC,CAAC,OAAO,CAAC,KAAK,CAC9D,WAAW,CACZ,IAAI,EAAE,EAAE,CAAC;QACR,MAAM,gBAAgB,GAAG,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1E,GAAG,CAAC,IAAI,CAAC,mBAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC;QACtD,IAAI,IAAA,yDAA2B,EAAC,gBAAgB,EAAE,gBAAgB,EAAE,EAAE,CAAC;YACrE,MAAM;IACV,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/plugin/internal/load/hasProjectPluginEntries.d.ts

@@ -9,6 +9,8 @@ import type { ITtscParsedProjectConfig } from "../../../structures/internal/ITts
  * omitted entries can therefore read manifests and resolve native packages.
  *
  * @param entries - Explicit entries; `false` always returns `false`.
+ * @param pluginConfigDir - Original consumer directory for generated configs;
+ *   omitted entries otherwise discover from the selected config directory.
  * @evidence contracts/common.md#principled-implementation Explicit false disables all plugin discovery; otherwise the shared entry resolver's enabled-not-false predicate checks the same population the loader would consider.
  * @evidence contracts/common.md#clear-and-simple-design The presence query delegates config/package selection to its owner instead of reproducing descriptor evaluation or build logic.
  * @evidence contracts/common.md#prohibited-implementation-shortcuts Enabled selection follows declared configuration, without assuming a known package marker or fabricating absence after a resolver error.
@@ -18,4 +20,4 @@ import type { ITtscParsedProjectConfig } from "../../../structures/internal/ITts
  * @evidence contracts/performance.md#efficient-algorithms Explicit false avoids discovery. Otherwise resolution materializes all entries before an at-most-linear enabled scan; explicit lists allocate one wrapper per entry, while omitted lists additionally incur ancestor, manifest-byte, dependency and native specifier-resolution work delegated to the entry resolver. No fixed project-size bound is imposed.
  * @evidenceExclude contracts/performance.md#reuse-equivalent-work This fresh presence observation coordinates no reusable producer result across calls; it neither retains package authority nor promises that subsequent loading avoids discovery again.
  */
-export declare function hasProjectPluginEntries(project: ITtscParsedProjectConfig, entries?: readonly ITtscProjectPluginConfig[] | false): boolean;
+export declare function hasProjectPluginEntries(project: ITtscParsedProjectConfig, entries?: readonly ITtscProjectPluginConfig[] | false, pluginConfigDir?: string): boolean;

package/lib/plugin/internal/load/hasProjectPluginEntries.js

@@ -11,6 +11,8 @@ const ProjectPluginEntries_1 = require("./ProjectPluginEntries");
  * omitted entries can therefore read manifests and resolve native packages.
  *
  * @param entries - Explicit entries; `false` always returns `false`.
+ * @param pluginConfigDir - Original consumer directory for generated configs;
+ *   omitted entries otherwise discover from the selected config directory.
  * @evidence contracts/common.md#principled-implementation Explicit false disables all plugin discovery; otherwise the shared entry resolver's enabled-not-false predicate checks the same population the loader would consider.
  * @evidence contracts/common.md#clear-and-simple-design The presence query delegates config/package selection to its owner instead of reproducing descriptor evaluation or build logic.
  * @evidence contracts/common.md#prohibited-implementation-shortcuts Enabled selection follows declared configuration, without assuming a known package marker or fabricating absence after a resolver error.
@@ -20,10 +22,10 @@ const ProjectPluginEntries_1 = require("./ProjectPluginEntries");
  * @evidence contracts/performance.md#efficient-algorithms Explicit false avoids discovery. Otherwise resolution materializes all entries before an at-most-linear enabled scan; explicit lists allocate one wrapper per entry, while omitted lists additionally incur ancestor, manifest-byte, dependency and native specifier-resolution work delegated to the entry resolver. No fixed project-size bound is imposed.
  * @evidenceExclude contracts/performance.md#reuse-equivalent-work This fresh presence observation coordinates no reusable producer result across calls; it neither retains package authority nor promises that subsequent loading avoids discovery again.
  */
-function hasProjectPluginEntries(project, entries) {
+function hasProjectPluginEntries(project, entries, pluginConfigDir) {
     if (entries === false) {
         return false;
     }
-    return ProjectPluginEntries_1.ProjectPluginEntries.resolvePluginEntries(project, entries).some((entry) => entry.config.enabled !== false);
+    return ProjectPluginEntries_1.ProjectPluginEntries.resolvePluginEntries(project, entries, pluginConfigDir).some((entry) => entry.config.enabled !== false);
 }
 //# sourceMappingURL=hasProjectPluginEntries.js.map

package/lib/plugin/internal/load/hasProjectPluginEntries.js.map

@@ -1 +1 @@
-{"version":3,"file":"hasProjectPluginEntries.js","sourceRoot":"","sources":["../../../../src/plugin/internal/load/hasProjectPluginEntries.ts"],"names":[],"mappings":";;;AAEA,iEAA8D;AAE9D;;;;;;;;;;;;;;;;;GAiBG;AACH,iCACE,OAAiC,EACjC,OAAqD;IAErD,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,2CAAoB,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CACrE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,KAAK,CAC1C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"hasProjectPluginEntries.js","sourceRoot":"","sources":["../../../../src/plugin/internal/load/hasProjectPluginEntries.ts"],"names":[],"mappings":";;;AAEA,iEAA8D;AAE9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iCACE,OAAiC,EACjC,OAAqD,EACrD,eAAwB;IAExB,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,2CAAoB,CAAC,oBAAoB,CAC9C,OAAO,EACP,OAAO,EACP,eAAe,CAChB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC;AACpD,CAAC"}

package/lib/plugin/internal/load/loadProjectPlugins.d.ts

@@ -1,6 +1,8 @@
+import { WatchInputPublication } from "../../../compiler/internal/build/WatchInputPublication";
 import type { ITtscProjectPluginConfig } from "../../../structures/ITtscProjectPluginConfig";
 import type { ITtscLoadedNativePlugin } from "../../../structures/internal/ITtscLoadedNativePlugin";
 import type { ITtscParsedProjectConfig } from "../../../structures/internal/ITtscParsedProjectConfig";
+import type { TtscPluginSourceInputsHandler } from "../../../structures/internal/TtscSingleFileEmitOptions";
 import { PluginContentIdentities } from "../source/PluginContentIdentities";
 /**
  * Resolve, load, and build all native plugin sidecars for a TypeScript project.
@@ -31,6 +33,9 @@ import { PluginContentIdentities } from "../source/PluginContentIdentities";
  * declaration. Sequential content, metadata and physical-path observations are
  * not an atomic snapshot or detection of every omitted read.
  *
+ * Synchronous callers require synchronous watch-input handlers; use
+ * {@link loadProjectPlugins.async} to await a worker's baseline publication.
+ *
  * @param options.binary - Absolute path to the ttsc native helper binary.
  * @param options.cacheDir - Override the plugin binary cache directory.
  * @param options.cwd - Working directory for resolving relative paths.
@@ -41,11 +46,12 @@ import { PluginContentIdentities } from "../source/PluginContentIdentities";
  *   native environment-name identity. Defaults to `process.env` for CLI
  *   callers, so ambient behavior is unchanged.
  * @param options.file - Path to the tsconfig/jsconfig file.
- * @param options.pluginConfigDir - Caller-declared anchor for plugin
- *   config-file discovery (see `ITtscPluginFactoryContext.pluginConfigDir`).
- * @param options.projectRoot - Override the project root directory.
+ * @param options.pluginConfigDir - Caller-declared consumer directory for
+ *   plugin packages, factory contexts and config-file discovery.
+ * @param options.projectRoot - Override the source root, native working
+ *   directory, cache anchor and returned relative Go-source base.
  * @param options.tsconfig - Alias for `file`.
- * @evidence contracts/common.md#principled-implementation The loader brackets project discovery observations, evaluates descriptors in isolated processes and validates declarations before publishing conservative source repair interests. Metadata refusal remains terminal; valid records narrow watch interests before final admission/build, while contradictory content or physical observations are omitted from proof rather than retroactively blessed.
+ * @evidence contracts/common.md#principled-implementation The loader brackets discovery at the selected config or explicit pluginConfigDir and factories receive that consumer anchor, independently of the source root retained for descriptor/native process cwd, caches and relative Go sources. It validates declarations before publishing conservative source repair interests. Metadata refusal remains terminal; valid records narrow watch interests before final admission/build, while contradictory content or physical observations are omitted from proof rather than retroactively blessed.
  * @evidence contracts/common.md#clear-and-simple-design The operation owns one ordered load generation; private helpers separate discovery, evaluation, validation, composition and proof merging, while package resolution and source building remain their own modules.
  * @evidence contracts/common.md#prohibited-implementation-shortcuts Descriptor module caches are isolated rather than deleting application singletons. ttsx retry occurs only for explicit supported TypeScript loader incompatibility, with plugins disabled to avoid recursive self-hosting; arbitrary descriptor failures are not retried into false success.
  * @evidence contracts/common.md#meaningful-documentation Native JSDoc explains result provenance, environment and path options; helper comments explain input races, conservative proof omission, fallback authority and cleanup. Member/tag spacing and separated concepts follow the documentation skill.
@@ -76,7 +82,7 @@ export declare function loadProjectPlugins(options: {
      * Observe plugin build roots before building, including failed builds, with
      * the record store that proves their states (#1728).
      */
-    onWatchInputs?: (inputs: readonly string[], identities?: PluginContentIdentities.Store) => void;
+    onWatchInputs?: TtscPluginSourceInputsHandler;
     /** Caller-selected anchor for plugin-owned configuration discovery. */
     pluginConfigDir?: string;
     /** Project root override for generated config wrappers. */
@@ -124,3 +130,28 @@ export declare function loadProjectPlugins(options: {
     /** Resolved project values and logical/physical configuration identity. */
     project: ITtscParsedProjectConfig;
 };
+/**
+ * Keep synchronous loading and awaited watch handoffs on one load sequence.
+ *
+ * @evidence contracts/common.md#principled-implementation Both completion modes advance one ordered discovery, admission, publication and build sequence. Awaited stepping preserves baseline-before-read handoffs before package selection and source builds, including empty selection and conservative repair roots.
+ * @evidence contracts/common.md#clear-and-simple-design The namespace adds an awaited runner beside synchronous loading and exposes one generator to build orchestration; existing helpers retain discovery, validation and compilation responsibilities.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Publication suspension retains failed-build interests and source proof rather than rebuilding a baseline after compilation. Pending publication cannot establish observation; rejection enters the real load failure path without replacing admission or native builds.
+ * @evidence contracts/common.md#meaningful-documentation Entry prose distinguishes completion modes, baseline-before-read ordering and internal sequence completion/rejection duties; the primary loader documents input and result provenance.
+ * @evidence contracts/portability.md#os-neutral-implementation The shared sequence retains existing native resolution, paths, environment and argument-array handling; the namespace adds no independent boundary.
+ * @evidence contracts/performance.md#efficient-algorithms Discovery, source hashing, Go metadata, validation and builds retain their original input costs; each publication adds one suspension without repeating those phases.
+ * @evidence contracts/performance.md#reuse-equivalent-work Validated descriptor/source records and load-local digest/reader sharing remain available across suspension; the completion wrapper retains no reusable load or in-flight cache.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources One load generation stays live while its current handoff settles; evaluator cleanup and returned-generation ownership remain with the sequence, and handler rejection enters generator cleanup.
+ */
+export declare namespace loadProjectPlugins {
+    /**
+     * Load plugins after each watch owner confirms its reported input baseline. A
+     * rejected handoff fails loading before the next source read or build.
+     */
+    function async(options: Parameters<typeof loadProjectPlugins>[0]): Promise<ReturnType<typeof loadProjectPlugins>>;
+    /**
+     * Produce one load, suspending at each watch-input handoff before continuing.
+     * Internal build orchestration consumes the whole sequence with its chosen
+     * completion runner; it must deliver rejection back into the sequence.
+     */
+    function steps(options: Parameters<typeof loadProjectPlugins>[0]): WatchInputPublication.Sequence<ReturnType<typeof loadProjectPlugins>>;
+}