@kensio/yulin 1.21.13 → 1.21.15

package/dist/service/dynamodb/expression/update/sim-dynamodb-update-clause.d.ts

@@ -1,9 +1,9 @@
-import type { SimDynamoDbExpressionPlaceholders } from "../sim-dynamodb-expression-placeholders.js";
+import type { SimDynamoDbExpressionAttributes } from "../sim-dynamodb-expression-attributes.js";
 import type { SimDynamoDbExpressionTokens } from "../sim-dynamodb-expression-tokens.js";
 import { SimDynamoDbUpdateTarget } from "./sim-dynamodb-update-target.js";
 interface SimDynamoDbUpdateClausesProperties {
     readonly tokens: SimDynamoDbExpressionTokens;
-    readonly names: SimDynamoDbExpressionPlaceholders<string>;
+    readonly attributes: SimDynamoDbExpressionAttributes;
 }
 /**
  * The clauses of an update expression, and the paths their actions write to.
@@ -14,7 +14,7 @@ interface SimDynamoDbUpdateClausesProperties {
  */
 export declare class SimDynamoDbUpdateClauses {
     private readonly tokens;
-    private readonly names;
+    private readonly attributes;
     private readonly read;
     constructor(properties: SimDynamoDbUpdateClausesProperties);
     /**

package/dist/service/dynamodb/expression/update/sim-dynamodb-update-clause.js

@@ -19,11 +19,11 @@ const clauseWords = new Set([
  */
 export class SimDynamoDbUpdateClauses {
     tokens;
-    names;
+    attributes;
     read = new Set();
     constructor(properties) {
         this.tokens = properties.tokens;
-        this.names = properties.names;
+        this.attributes = properties.attributes;
     }
     /**
      * Read the keyword the next clause starts with, refusing one already used.
@@ -47,7 +47,7 @@ export class SimDynamoDbUpdateClauses {
     target() {
         return new SimDynamoDbUpdateTarget(new SimDynamoDbDocumentPathParser({
             tokens: this.tokens,
-            names: this.names,
+            attributes: this.attributes,
         }).parse());
     }
     /**

package/dist/service/dynamodb/expression/update/sim-dynamodb-update-expression.js

@@ -13,7 +13,7 @@ import { SimDynamoDbUpdateParser } from "./sim-dynamodb-update-parser.js";
 export function parseSimDynamoDbUpdate(expression, parameters) {
     return new SimDynamoDbUpdateParser({
         tokens: SimDynamoDbExpressionTokens.of(updateExpressionName, expression, "the expression says nothing, and an expression cannot be empty"),
-        names: parameters.names,
+        attributes: parameters.attributes,
         values: parameters.values,
     }).parse();
 }

package/dist/service/dynamodb/expression/update/sim-dynamodb-update-operand-parser.d.ts

@@ -1,10 +1,11 @@
 import type { SimDynamoDbValue } from "../../item/sim-dynamodb-value.js";
+import type { SimDynamoDbExpressionAttributes } from "../sim-dynamodb-expression-attributes.js";
 import type { SimDynamoDbExpressionPlaceholders } from "../sim-dynamodb-expression-placeholders.js";
 import type { SimDynamoDbExpressionTokens } from "../sim-dynamodb-expression-tokens.js";
 import { type SimDynamoDbUpdateOperand, SimDynamoDbUpdatePathOperand, SimDynamoDbUpdateValueOperand } from "./sim-dynamodb-update-operand.js";
 interface SimDynamoDbUpdateOperandParserProperties {
     readonly tokens: SimDynamoDbExpressionTokens;
-    readonly names: SimDynamoDbExpressionPlaceholders<string>;
+    readonly attributes: SimDynamoDbExpressionAttributes;
     readonly values: SimDynamoDbExpressionPlaceholders<SimDynamoDbValue>;
 }
 /**
@@ -20,7 +21,7 @@ interface SimDynamoDbUpdateOperandParserProperties {
  */
 export declare class SimDynamoDbUpdateOperandParser {
     private readonly tokens;
-    private readonly names;
+    private readonly attributes;
     private readonly values;
     private readonly functions;
     constructor(properties: SimDynamoDbUpdateOperandParserProperties);

package/dist/service/dynamodb/expression/update/sim-dynamodb-update-operand-parser.js

@@ -20,12 +20,12 @@ const operators = new Set(["+", "-"]);
  */
 export class SimDynamoDbUpdateOperandParser {
     tokens;
-    names;
+    attributes;
     values;
     functions;
     constructor(properties) {
         this.tokens = properties.tokens;
-        this.names = properties.names;
+        this.attributes = properties.attributes;
         this.values = properties.values;
         this.functions = new SimDynamoDbUpdateFunctionParser({
             tokens: properties.tokens,
@@ -80,7 +80,7 @@ export class SimDynamoDbUpdateOperandParser {
     path() {
         return new SimDynamoDbUpdatePathOperand(new SimDynamoDbDocumentPathParser({
             tokens: this.tokens,
-            names: this.names,
+            attributes: this.attributes,
         }).parse());
     }
     /**

package/dist/service/dynamodb/expression/update/sim-dynamodb-update-parser.d.ts

@@ -1,10 +1,11 @@
 import type { SimDynamoDbValue } from "../../item/sim-dynamodb-value.js";
+import type { SimDynamoDbExpressionAttributes } from "../sim-dynamodb-expression-attributes.js";
 import type { SimDynamoDbExpressionPlaceholders } from "../sim-dynamodb-expression-placeholders.js";
 import type { SimDynamoDbExpressionTokens } from "../sim-dynamodb-expression-tokens.js";
 import { SimDynamoDbUpdate } from "./sim-dynamodb-update.js";
 interface SimDynamoDbUpdateParserProperties {
     readonly tokens: SimDynamoDbExpressionTokens;
-    readonly names: SimDynamoDbExpressionPlaceholders<string>;
+    readonly attributes: SimDynamoDbExpressionAttributes;
     readonly values: SimDynamoDbExpressionPlaceholders<SimDynamoDbValue>;
 }
 /**

package/dist/service/iam/authorize/match/condition/negated/sim-iam-negated-for-all-values-string-operator.d.ts

@@ -11,8 +11,11 @@ import type { SimIamStringComparison } from "../sim-iam-string-comparison.js";
  */
 export declare class SimIamNegatedForAllValuesStringOperator implements SimIamConditionOperator {
     private readonly comparison;
-    readonly matchesAbsentKey = true;
     constructor(comparison: SimIamStringComparison);
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey(): boolean;
     /**
      * Check whether every request value differs from every policy value.
      */

package/dist/service/iam/authorize/match/condition/negated/sim-iam-negated-for-all-values-string-operator.js

@@ -9,10 +9,15 @@ import { simIamStringValues } from "../string/sim-iam-string-values.js";
  */
 export class SimIamNegatedForAllValuesStringOperator {
     comparison;
-    matchesAbsentKey = true;
     constructor(comparison) {
         this.comparison = comparison;
     }
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey() {
+        return true;
+    }
     /**
      * Check whether every request value differs from every policy value.
      */

package/dist/service/iam/authorize/match/condition/negated/sim-iam-negated-for-any-value-string-operator.d.ts

@@ -12,8 +12,11 @@ import type { SimIamStringComparison } from "../sim-iam-string-comparison.js";
  */
 export declare class SimIamNegatedForAnyValueStringOperator implements SimIamConditionOperator {
     private readonly comparison;
-    readonly matchesAbsentKey = false;
     constructor(comparison: SimIamStringComparison);
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey(): boolean;
     /**
      * Check whether any request value differs from every policy value.
      */

package/dist/service/iam/authorize/match/condition/negated/sim-iam-negated-for-any-value-string-operator.js

@@ -10,10 +10,15 @@ import { simIamStringValues } from "../string/sim-iam-string-values.js";
  */
 export class SimIamNegatedForAnyValueStringOperator {
     comparison;
-    matchesAbsentKey = false;
     constructor(comparison) {
         this.comparison = comparison;
     }
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey() {
+        return false;
+    }
     /**
      * Check whether any request value differs from every policy value.
      */

package/dist/service/iam/authorize/match/condition/negated/sim-iam-negated-scalar-string-operator.d.ts

@@ -11,8 +11,11 @@ import type { SimIamStringComparison } from "../sim-iam-string-comparison.js";
  */
 export declare class SimIamNegatedScalarStringOperator implements SimIamConditionOperator {
     private readonly comparison;
-    readonly matchesAbsentKey = true;
     constructor(comparison: SimIamStringComparison);
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey(): boolean;
     /**
      * Check whether a request value differs from every policy value.
      */

package/dist/service/iam/authorize/match/condition/negated/sim-iam-negated-scalar-string-operator.js

@@ -9,10 +9,15 @@ import { simIamStringValues } from "../string/sim-iam-string-values.js";
  */
 export class SimIamNegatedScalarStringOperator {
     comparison;
-    matchesAbsentKey = true;
     constructor(comparison) {
         this.comparison = comparison;
     }
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey() {
+        return true;
+    }
     /**
      * Check whether a request value differs from every policy value.
      */

package/dist/service/iam/authorize/match/condition/null/sim-iam-null.d.ts

@@ -0,0 +1,23 @@
+import type { SimIamConditionValue } from "../../../../policy/sim-iam-policy.js";
+import type { SimIamConditionOperator } from "../sim-iam-condition-operator.js";
+/**
+ * IAM `Null` condition operator.
+ *
+ * `Null` checks whether the request carries a value for a context key, rather
+ * than comparing one. `"true"` matches where the key is absent and `"false"`
+ * where it is present. AWS names it and the `...IfExists` suffix as the two
+ * exceptions to the rule that an absent key fails a condition.
+ *
+ * It is what guards a `ForAllValues` `Allow`, which matches an absent key on
+ * its own. See `SimIamForAllValuesStringConditionOperator`.
+ */
+export declare class SimIamNull implements SimIamConditionOperator {
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey(expected: SimIamConditionValue): boolean;
+    /**
+     * Answer for a request carrying a value for the key.
+     */
+    matches(actual: SimIamConditionValue, expected: SimIamConditionValue): boolean;
+}

package/dist/service/iam/authorize/match/condition/null/sim-iam-null.js

@@ -0,0 +1,59 @@
+/**
+ * Read the policy value of a `Null` condition.
+ *
+ * AWS documents `"true"` and `"false"` as strings, which is the form a policy
+ * document and the CDK both write. The condition value type also admits a JSON
+ * boolean, and a policy written that way means the same thing. Anything else
+ * has no meaning here and leaves the condition matching nothing.
+ */
+function expectsAbsentKey(expected) {
+    if (typeof expected === "boolean") {
+        return expected;
+    }
+    if (expected === "true") {
+        return true;
+    }
+    return expected === "false" ? false : undefined;
+}
+/**
+ * Whether a request value counts as present for a `Null` check.
+ *
+ * AWS asks whether the key exists and its value is not null. A multi-valued key
+ * carrying no values resolves to a null dataset, and an empty string is the
+ * example AWS gives of one.
+ */
+function isPresent(actual) {
+    if (Array.isArray(actual)) {
+        return actual.length > 0;
+    }
+    return actual !== "";
+}
+/**
+ * IAM `Null` condition operator.
+ *
+ * `Null` checks whether the request carries a value for a context key, rather
+ * than comparing one. `"true"` matches where the key is absent and `"false"`
+ * where it is present. AWS names it and the `...IfExists` suffix as the two
+ * exceptions to the rule that an absent key fails a condition.
+ *
+ * It is what guards a `ForAllValues` `Allow`, which matches an absent key on
+ * its own. See `SimIamForAllValuesStringConditionOperator`.
+ */
+export class SimIamNull {
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey(expected) {
+        return expectsAbsentKey(expected) === true;
+    }
+    /**
+     * Answer for a request carrying a value for the key.
+     */
+    matches(actual, expected) {
+        const absentExpected = expectsAbsentKey(expected);
+        if (absentExpected === undefined) {
+            return false;
+        }
+        return absentExpected !== isPresent(actual);
+    }
+}

package/dist/service/iam/authorize/match/condition/numeric/less-than-equals/sim-iam-number-lte.d.ts

@@ -15,7 +15,10 @@ import type { SimIamConditionOperator } from "../../sim-iam-condition-operator.j
  * are rejected rather than being converted through JavaScript coercion rules.
  */
 export declare class SimIamNumericLessThanEquals implements SimIamConditionOperator {
-    readonly matchesAbsentKey = false;
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey(): boolean;
     /**
      * Compare one request value with one or more policy limits.
      */

package/dist/service/iam/authorize/match/condition/numeric/less-than-equals/sim-iam-number-lte.js

@@ -13,7 +13,12 @@
  * are rejected rather than being converted through JavaScript coercion rules.
  */
 export class SimIamNumericLessThanEquals {
-    matchesAbsentKey = false;
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey() {
+        return false;
+    }
     /**
      * Compare one request value with one or more policy limits.
      */

package/dist/service/iam/authorize/match/condition/sim-iam-condition-operator-parser.js

@@ -8,6 +8,7 @@ import { SimIamStringLike } from "./string/like/sim-iam-string-like.js";
 import { SimIamNumericLessThanEquals } from "./numeric/less-than-equals/sim-iam-number-lte.js";
 import { SimIamArnEquals } from "./arn/equals/sim-iam-arn-equals.js";
 import { SimIamArnLike } from "./arn/like/sim-iam-arn-like.js";
+import { SimIamNull } from "./null/sim-iam-null.js";
 const operatorFactories = new Map([
     ["ArnEquals", () => new SimIamArnEquals()],
     ["ArnLike", () => new SimIamArnLike()],
@@ -17,6 +18,7 @@ const operatorFactories = new Map([
     ],
     ["StringEquals", () => new SimIamStringEquals()],
     ["StringLike", () => new SimIamStringLike()],
+    ["Null", () => new SimIamNull()],
     [
         "ForAnyValue:StringEquals",
         () => new SimIamForAnyValueStringEquals(),

package/dist/service/iam/authorize/match/condition/sim-iam-condition-operator.d.ts

@@ -19,8 +19,12 @@ export interface SimIamConditionOperator {
      * true, because every value the request carries matches vacuously. AWS
      * documents all three rules, and warns that the `ForAllValues` rule leaves
      * an `Allow` overly permissive without a `Null` guard beside it.
+     *
+     * The policy value is passed because `Null` reads it. Every comparison
+     * operator answers the same way whatever the policy says, and takes no
+     * argument.
      */
-    readonly matchesAbsentKey: boolean;
+    matchesAbsentKey(expected: SimIamConditionValue): boolean;
     /**
      * Determine whether an actual request value satisfies the expected policy value.
      */

package/dist/service/iam/authorize/match/condition/sim-iam-policy-condition-matcher.js

@@ -59,7 +59,7 @@ export class SimIamPolicyConditionMatcher {
     entryMatches(operator, key, expected) {
         const actual = this.conditionContext.get(this.normalizeContextKey(key));
         if (actual === undefined) {
-            return operator.matchesAbsentKey;
+            return operator.matchesAbsentKey(expected);
         }
         return operator.matches(actual, expected);
     }

package/dist/service/iam/authorize/match/condition/string/all-values/sim-iam-for-all-values-string-condition-operator.d.ts

@@ -8,7 +8,10 @@ import type { SimIamConditionOperator } from "../../sim-iam-condition-operator.j
  * guard beside it to stay tight.
  */
 export declare abstract class SimIamForAllValuesStringConditionOperator implements SimIamConditionOperator {
-    readonly matchesAbsentKey = true;
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey(): boolean;
     /**
      * Check whether a given value matches the expected value.
      */

package/dist/service/iam/authorize/match/condition/string/all-values/sim-iam-for-all-values-string-condition-operator.js

@@ -7,7 +7,12 @@ import { simIamStringValues } from "../sim-iam-string-values.js";
  * guard beside it to stay tight.
  */
 export class SimIamForAllValuesStringConditionOperator {
-    matchesAbsentKey = true;
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey() {
+        return true;
+    }
     /**
      * Check whether a given value matches the expected value.
      */

package/dist/service/iam/authorize/match/condition/string/any-value/sim-iam-for-any-value-string-condition-operator.d.ts

@@ -4,7 +4,10 @@ import type { SimIamConditionOperator } from "../../sim-iam-condition-operator.j
  * Base for `ForAnyValue` IAM string operators.
  */
 export declare abstract class SimIamForAnyValueStringConditionOperator implements SimIamConditionOperator {
-    readonly matchesAbsentKey = false;
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey(): boolean;
     /**
      * Check whether a given value matches the expected value.
      */

package/dist/service/iam/authorize/match/condition/string/any-value/sim-iam-for-any-value-string-condition-operator.js

@@ -3,7 +3,12 @@ import { simIamStringValues } from "../sim-iam-string-values.js";
  * Base for `ForAnyValue` IAM string operators.
  */
 export class SimIamForAnyValueStringConditionOperator {
-    matchesAbsentKey = false;
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey() {
+        return false;
+    }
     /**
      * Check whether a given value matches the expected value.
      */

package/dist/service/iam/authorize/match/condition/string/sim-iam-scalar-string-condition-operator.d.ts

@@ -7,7 +7,10 @@ import type { SimIamConditionOperator } from "../sim-iam-condition-operator.js";
  * scalar or an array, with multiple policy values using OR semantics.
  */
 export declare abstract class SimIamScalarStringConditionOperator implements SimIamConditionOperator {
-    readonly matchesAbsentKey = false;
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey(): boolean;
     /**
      * Check whether a given value matches the expected value.
      */

package/dist/service/iam/authorize/match/condition/string/sim-iam-scalar-string-condition-operator.js

@@ -6,7 +6,12 @@ import { simIamStringValues } from "./sim-iam-string-values.js";
  * scalar or an array, with multiple policy values using OR semantics.
  */
 export class SimIamScalarStringConditionOperator {
-    matchesAbsentKey = false;
+    /**
+     * Answer for a request carrying no value for the key.
+     */
+    matchesAbsentKey() {
+        return false;
+    }
     /**
      * Check whether a given value matches the expected value.
      */

package/dist/util/background/background-clock-waits.d.ts

@@ -26,10 +26,17 @@ export declare class BackgroundClockWaits {
      */
     around<T>(wait: BackgroundClockWait, work: () => Promise<T>): Promise<T>;
     /**
-     * The work in a set that is neither waiting on the clock nor the work asking
-     * about it.
+     * The work in a set that completion has anything to wait for.
+     *
+     * The work asking is always left out. Waiting for the invocation the asking
+     * code is part of would be waiting for itself.
+     *
+     * Work waiting on the clock is left out where simulated time stands still,
+     * since only a caller moving the clock brings the instant it waits for, and
+     * that caller is the one waiting here. A running clock reaches the instant on
+     * its own, and this waits for the work to get there.
      */
-    runnable(held: ReadonlyMap<Promise<unknown>, BackgroundClockWait>): Promise<unknown>[];
+    runnable(held: ReadonlyMap<Promise<unknown>, BackgroundClockWait>, clockIsRunning?: boolean): Promise<unknown>[];
     /**
      * Whether the code running now is already inside outstanding work, and so
      * already counted.

package/dist/util/background/background-clock-waits.js

@@ -23,14 +23,21 @@ export class BackgroundClockWaits {
         return await this.storage.run(wait, work);
     }
     /**
-     * The work in a set that is neither waiting on the clock nor the work asking
-     * about it.
+     * The work in a set that completion has anything to wait for.
+     *
+     * The work asking is always left out. Waiting for the invocation the asking
+     * code is part of would be waiting for itself.
+     *
+     * Work waiting on the clock is left out where simulated time stands still,
+     * since only a caller moving the clock brings the instant it waits for, and
+     * that caller is the one waiting here. A running clock reaches the instant on
+     * its own, and this waits for the work to get there.
      */
-    runnable(held) {
+    runnable(held, clockIsRunning = false) {
         const own = this.storage.getStore();
         return held
             .entries()
-            .filter(([, wait]) => wait.count === 0 && wait !== own)
+            .filter(([, wait]) => wait !== own && (clockIsRunning || wait.count === 0))
             .map(([promise]) => promise)
             .toArray();
     }

package/dist/util/background/background-pending-tasks.d.ts

@@ -35,21 +35,27 @@ export declare class BackgroundPendingTasks {
      */
     get size(): number;
     /**
-     * Wait until nothing is outstanding but work that is waiting on the clock.
+     * Wait until nothing is outstanding that can still get somewhere.
      *
-     * Work that parks part way through ends the wait rather than extending it:
-     * only moving the clock releases it, and moving the clock is what waits
-     * here. The loop then looks again at what is left running, so work that
-     * carries on is waited for again.
+     * Where simulated time stands still, work that parks on the clock ends the
+     * wait rather than extending it. Only moving the clock releases it, and
+     * moving the clock is what waits here. The loop then looks again at what is
+     * left running, so work that carries on is waited for again.
+     *
+     * A running clock reaches those instants by itself, and the work parked on
+     * them is waited for like any other. What bounds the wait is the instant
+     * itself, which arrives in the real time between here and there.
      */
-    complete(): Promise<void>;
+    complete(clockIsRunning?: boolean): Promise<void>;
     /**
-     * The work completion has anything to wait for, which is whatever is
-     * neither waiting on the clock nor waiting for completion itself.
+     * The work completion has anything to wait for.
      *
      * Work that asks for the simulation to settle from inside itself is left
      * out. A handler advancing the clock is the ordinary case, and waiting for
      * the invocation it is part of would be waiting for itself.
+     *
+     * Work waiting on the clock joins it once simulated time is running, since
+     * a running clock is what brings the instant it waits for.
      */
-    running(): Promise<unknown>[];
+    running(clockIsRunning?: boolean): Promise<unknown>[];
 }

package/dist/util/background/background-pending-tasks.js

@@ -52,15 +52,19 @@ export class BackgroundPendingTasks {
         return this.#held.size;
     }
     /**
-     * Wait until nothing is outstanding but work that is waiting on the clock.
+     * Wait until nothing is outstanding that can still get somewhere.
      *
-     * Work that parks part way through ends the wait rather than extending it:
-     * only moving the clock releases it, and moving the clock is what waits
-     * here. The loop then looks again at what is left running, so work that
-     * carries on is waited for again.
+     * Where simulated time stands still, work that parks on the clock ends the
+     * wait rather than extending it. Only moving the clock releases it, and
+     * moving the clock is what waits here. The loop then looks again at what is
+     * left running, so work that carries on is waited for again.
+     *
+     * A running clock reaches those instants by itself, and the work parked on
+     * them is waited for like any other. What bounds the wait is the instant
+     * itself, which arrives in the real time between here and there.
      */
-    async complete() {
-        let running = this.running();
+    async complete(clockIsRunning = false) {
+        let running = this.running(clockIsRunning);
         while (running.length > 0) {
             // oxlint-disable-next-line no-await-in-loop
             const settled = await Promise.race([
@@ -68,19 +72,21 @@ export class BackgroundPendingTasks {
                 this.#clockWaits.next,
             ]);
             new BackgroundSettledTasks(settled).throwFirstFailure();
-            running = this.running();
+            running = this.running(clockIsRunning);
         }
     }
     /**
-     * The work completion has anything to wait for, which is whatever is
-     * neither waiting on the clock nor waiting for completion itself.
+     * The work completion has anything to wait for.
      *
      * Work that asks for the simulation to settle from inside itself is left
      * out. A handler advancing the clock is the ordinary case, and waiting for
      * the invocation it is part of would be waiting for itself.
+     *
+     * Work waiting on the clock joins it once simulated time is running, since
+     * a running clock is what brings the instant it waits for.
      */
-    running() {
-        return this.#clockWaits.runnable(this.#held);
+    running(clockIsRunning = false) {
+        return this.#clockWaits.runnable(this.#held, clockIsRunning);
     }
     /**
      * Keep work outstanding under its own record until it settles.

package/dist/util/background/background.d.ts

@@ -141,9 +141,11 @@ export declare class BackgroundTasks implements BackgroundScheduler, BackgroundC
      * Wait until all tasks currently scheduled have finished.
      * If tasks schedule more tasks, this will continue draining until idle.
      *
-     * Work waiting on the clock is not waited for: it is not outstanding, it is
-     * scheduled for a simulated instant that has not arrived. Only moving the
-     * clock releases it.
+     * What happens to work waiting on the clock follows the clock. Where
+     * simulated time stands still the work stays where it is, scheduled for an
+     * instant only a caller can bring, and this returns without it. Where
+     * simulated time runs, the instant arrives by itself and this waits for the
+     * work to get through it.
      */
     complete(): Promise<void>;
     /**
@@ -154,5 +156,11 @@ export declare class BackgroundTasks implements BackgroundScheduler, BackgroundC
      * See how many tasks are waiting for simulated time to reach them.
      */
     get dueTaskCount(): number;
+    /**
+     * Whether simulated time reaches a scheduled instant on its own.
+     *
+     * A clock with nothing to say about it advances, as the host clock does.
+     */
+    private get clockIsRunning();
 }
 export {};