@orkestrel/scaffold 0.0.104 → 0.0.106

package/dist/src/server/index.d.cts

@@ -762,7 +762,7 @@ export declare const isUpstreamOptions: Guard<UpstreamOptions>;
  * directory; false otherwise.
  *
  * @remarks
- * The green-field law. A checkout of an empty repository is where a new
+ * The green-field law. A checkout of an empty repository is where a fresh
  * workspace legitimately starts, so that one directory is admitted and nothing
  * else is; anything more means the caller is repairing a workspace rather than
  * creating one. Only the first two entries are read, so the answer costs the
@@ -1729,7 +1729,7 @@ export declare class Materializer implements MaterializerInterface {
                     * non-negative safe integer.
                     */
                 constructor(budget: number);
-                /** The bytes the call has left; negative once a read overshoots the budget. */
+                /** The bytes the call has left; negative after a read overshoots the budget. */
                 get remaining(): number;
                 /**
                  * Spends bytes a read consumed from the allowance.
@@ -1755,12 +1755,12 @@ export declare class Materializer implements MaterializerInterface {
                  * Describes the byte allowance one upstream call spends across every read it makes.
                  *
                  * @remarks
-                 * `remaining` is the budget less every byte spent, and it goes negative once a
+                 * `remaining` is the budget less every byte spent, and it goes negative after a
                  * read overshoots, so a caller tells a call that has nothing left (`remaining`
                  * at or below zero) from one that spent past its budget (`remaining` below zero).
                  */
                 export declare interface ReadAllowanceInterface {
-                    /** The bytes the call has left; negative once a read overshoots the budget. */
+                    /** The bytes the call has left; negative after a read overshoots the budget. */
                     readonly remaining: number;
                     /**
                      * Spends bytes a read consumed from the allowance.
@@ -2298,7 +2298,7 @@ export declare class Materializer implements MaterializerInterface {
                     readonly note: string;
                 }
 
-                /** Holds the note a release carries when its packument names no readable latest version. */
+                /** Holds the note a release carries when its packument names no readable version under the `latest` tag. */
                 export declare const UNREADABLE_VERSION_NOTE = "the answer carries no readable latest version";
 
                 /**
@@ -2370,7 +2370,7 @@ export declare class Materializer implements MaterializerInterface {
                      /** Exposes the upstream reader's observation channel. */
                      get emitter(): EmitterInterface<UpstreamEventMap>;
                      /**
-                      * Looks up the newest release each declared range admits.
+                      * Looks up the highest release each declared range admits.
                       *
                       * @param dependencies - The declared dependencies to look up.
                       * @returns One release verdict per dependency, in input order.
@@ -2381,9 +2381,9 @@ export declare class Materializer implements MaterializerInterface {
                           * @remarks
                           * The reader selects across the packument's stable version map before any
                           * collection bound can truncate it. It falls back to `dist-tags.latest` only
-                          * when that version satisfies the declared range. `*` requests the newest
+                          * when that version satisfies the declared range. `*` requests the highest
                           * stable version outright. The verdict's `major` field carries the stable
-                          * major from the latest tag when that tag can be read.
+                          * major from the `latest` tag when that tag can be read.
                           *
                           * @example
                           * ```ts
@@ -2547,7 +2547,7 @@ export declare class Materializer implements MaterializerInterface {
                         export declare interface UpstreamInterface {
                             readonly emitter: EmitterInterface<UpstreamEventMap>;
                             /**
-                             * Looks up the newest release each declared range admits.
+                             * Looks up the highest release each declared range admits.
                              *
                              * @param dependencies - The declared dependencies to look up.
                              * @returns One release verdict per dependency, in input order.
@@ -2717,7 +2717,7 @@ export declare class Materializer implements MaterializerInterface {
                          *   the same name can receive its old inode back and is indistinguishable here
                          *   from one that never moved.
                          * - **No crash atomicity across destinations.** A process killed between
-                         *   promotions leaves the target holding some new files and some old ones, and
+                         *   promotions leaves the target holding some replacement files and some prior ones, and
                          *   leaves the private root behind. Nothing here is a journal, and the private
                          *   root's name is the only record a later run could read.
                          *

package/dist/src/server/index.d.ts

@@ -762,7 +762,7 @@ export declare const isUpstreamOptions: Guard<UpstreamOptions>;
  * directory; false otherwise.
  *
  * @remarks
- * The green-field law. A checkout of an empty repository is where a new
+ * The green-field law. A checkout of an empty repository is where a fresh
  * workspace legitimately starts, so that one directory is admitted and nothing
  * else is; anything more means the caller is repairing a workspace rather than
  * creating one. Only the first two entries are read, so the answer costs the
@@ -1729,7 +1729,7 @@ export declare class Materializer implements MaterializerInterface {
                     * non-negative safe integer.
                     */
                 constructor(budget: number);
-                /** The bytes the call has left; negative once a read overshoots the budget. */
+                /** The bytes the call has left; negative after a read overshoots the budget. */
                 get remaining(): number;
                 /**
                  * Spends bytes a read consumed from the allowance.
@@ -1755,12 +1755,12 @@ export declare class Materializer implements MaterializerInterface {
                  * Describes the byte allowance one upstream call spends across every read it makes.
                  *
                  * @remarks
-                 * `remaining` is the budget less every byte spent, and it goes negative once a
+                 * `remaining` is the budget less every byte spent, and it goes negative after a
                  * read overshoots, so a caller tells a call that has nothing left (`remaining`
                  * at or below zero) from one that spent past its budget (`remaining` below zero).
                  */
                 export declare interface ReadAllowanceInterface {
-                    /** The bytes the call has left; negative once a read overshoots the budget. */
+                    /** The bytes the call has left; negative after a read overshoots the budget. */
                     readonly remaining: number;
                     /**
                      * Spends bytes a read consumed from the allowance.
@@ -2298,7 +2298,7 @@ export declare class Materializer implements MaterializerInterface {
                     readonly note: string;
                 }
 
-                /** Holds the note a release carries when its packument names no readable latest version. */
+                /** Holds the note a release carries when its packument names no readable version under the `latest` tag. */
                 export declare const UNREADABLE_VERSION_NOTE = "the answer carries no readable latest version";
 
                 /**
@@ -2370,7 +2370,7 @@ export declare class Materializer implements MaterializerInterface {
                      /** Exposes the upstream reader's observation channel. */
                      get emitter(): EmitterInterface<UpstreamEventMap>;
                      /**
-                      * Looks up the newest release each declared range admits.
+                      * Looks up the highest release each declared range admits.
                       *
                       * @param dependencies - The declared dependencies to look up.
                       * @returns One release verdict per dependency, in input order.
@@ -2381,9 +2381,9 @@ export declare class Materializer implements MaterializerInterface {
                           * @remarks
                           * The reader selects across the packument's stable version map before any
                           * collection bound can truncate it. It falls back to `dist-tags.latest` only
-                          * when that version satisfies the declared range. `*` requests the newest
+                          * when that version satisfies the declared range. `*` requests the highest
                           * stable version outright. The verdict's `major` field carries the stable
-                          * major from the latest tag when that tag can be read.
+                          * major from the `latest` tag when that tag can be read.
                           *
                           * @example
                           * ```ts
@@ -2547,7 +2547,7 @@ export declare class Materializer implements MaterializerInterface {
                         export declare interface UpstreamInterface {
                             readonly emitter: EmitterInterface<UpstreamEventMap>;
                             /**
-                             * Looks up the newest release each declared range admits.
+                             * Looks up the highest release each declared range admits.
                              *
                              * @param dependencies - The declared dependencies to look up.
                              * @returns One release verdict per dependency, in input order.
@@ -2717,7 +2717,7 @@ export declare class Materializer implements MaterializerInterface {
                          *   the same name can receive its old inode back and is indistinguishable here
                          *   from one that never moved.
                          * - **No crash atomicity across destinations.** A process killed between
-                         *   promotions leaves the target holding some new files and some old ones, and
+                         *   promotions leaves the target holding some replacement files and some prior ones, and
                          *   leaves the private root behind. Nothing here is a journal, and the private
                          *   root's name is the only record a later run could read.
                          *

package/dist/src/server/index.js

@@ -151,7 +151,7 @@ var ORKESTREL_SCOPE = "orkestrel";
 * guides and these files.
 */
 var SCAFFOLD_REPOSITORY = "scaffold";
-/** Holds the note a release carries when its packument names no readable latest version. */
+/** Holds the note a release carries when its packument names no readable version under the `latest` tag. */
 var UNREADABLE_VERSION_NOTE = "the answer carries no readable latest version";
 /**
 * Names the media type that selects the registry's abbreviated packument.
@@ -757,7 +757,7 @@ function resolveContainedPath(root, path) {
 * directory; false otherwise.
 *
 * @remarks
-* The green-field law. A checkout of an empty repository is where a new
+* The green-field law. A checkout of an empty repository is where a fresh
 * workspace legitimately starts, so that one directory is admitted and nothing
 * else is; anything more means the caller is repairing a workspace rather than
 * creating one. Only the first two entries are read, so the answer costs the
@@ -2430,7 +2430,7 @@ var isUpstreamOptions = recordOf({
 *   the same name can receive its old inode back and is indistinguishable here
 *   from one that never moved.
 * - **No crash atomicity across destinations.** A process killed between
-*   promotions leaves the target holding some new files and some old ones, and
+*   promotions leaves the target holding some replacement files and some prior ones, and
 *   leaves the private root behind. Nothing here is a journal, and the private
 *   root's name is the only record a later run could read.
 *
@@ -3873,7 +3873,7 @@ var ReadAllowance = class {
 		if (!isNonNegativeInteger(budget) || !Number.isSafeInteger(budget)) throw new ScaffoldError("INVALID", "The read budget is not a non-negative safe integer.", { field: "budget" });
 		this.#remaining = budget;
 	}
-	/** The bytes the call has left; negative once a read overshoots the budget. */
+	/** The bytes the call has left; negative after a read overshoots the budget. */
 	get remaining() {
 		return this.#remaining;
 	}
@@ -3998,7 +3998,7 @@ var Upstream = class {
 		return this.#emitter;
 	}
 	/**
-	* Looks up the newest release each declared range admits.
+	* Looks up the highest release each declared range admits.
 	*
 	* @param dependencies - The declared dependencies to look up.
 	* @returns One release verdict per dependency, in input order.
@@ -4009,9 +4009,9 @@ var Upstream = class {
 	* @remarks
 	* The reader selects across the packument's stable version map before any
 	* collection bound can truncate it. It falls back to `dist-tags.latest` only
-	* when that version satisfies the declared range. `*` requests the newest
+	* when that version satisfies the declared range. `*` requests the highest
 	* stable version outright. The verdict's `major` field carries the stable
-	* major from the latest tag when that tag can be read.
+	* major from the `latest` tag when that tag can be read.
 	*
 	* @example
 	* ```ts