@overkill-dev/doubles 0.0.1 → 0.0.3

package/doubles/double-usage-count-assertion.js

@@ -0,0 +1,73 @@
+import { defineCompositeAssertion } from "../assert/assertion-extension.js";
+import { modeNoun } from "./double-usage-contract.js";
+import { countFor, inspectedDouble, validNonNegativeInteger } from "./double-usage-inspection.js";
+function countAssertion(input) {
+    const inspected = inspectedDouble(input.check, input.subject);
+    if (!inspected.valid) {
+        return inspected.failure;
+    }
+    return input.check.group([
+        input.check.annotated('expected count').true(validNonNegativeInteger(input.expectedCount)),
+        input.check.annotated(`${modeNoun(input.mode)} count`).equal(countFor(inspected.history, input.mode), input.expectedCount)
+    ]);
+}
+function atLeastOneAssertion(check, subject, mode) {
+    const inspected = inspectedDouble(check, subject);
+    return inspected.valid
+        ? check.annotated(`${modeNoun(mode)} count`).greaterThan(countFor(inspected.history, mode), 0)
+        : inspected.failure;
+}
+function noEventsAssertion(check, subject, mode) {
+    const inspected = inspectedDouble(check, subject);
+    return inspected.valid
+        ? check.annotated(`${modeNoun(mode)} count`).equal(countFor(inspected.history, mode), 0)
+        : inspected.failure;
+}
+function onceAssertion(check, subject, mode) {
+    return countAssertion({ check, expectedCount: 1, mode, subject });
+}
+export function countReference(name, mode) {
+    return defineCompositeAssertion({
+        assert(check, subject, expectedCount) {
+            return countAssertion({ check, expectedCount, mode, subject });
+        },
+        formatSummary() {
+            return `Expected double ${modeNoun(mode)} count to match.`;
+        },
+        name
+    });
+}
+export function atLeastOneReference(name, mode) {
+    return defineCompositeAssertion({
+        assert(check, subject) {
+            return atLeastOneAssertion(check, subject, mode);
+        },
+        formatSummary() {
+            return `Expected double to have at least one ${modeNoun(mode)}.`;
+        },
+        name
+    });
+}
+export function noEventsReference(name, mode) {
+    return defineCompositeAssertion({
+        assert(check, subject) {
+            return noEventsAssertion(check, subject, mode);
+        },
+        formatSummary() {
+            return `Expected double not to have ${modeNoun(mode)}s.`;
+        },
+        name
+    });
+}
+export function onceReference(name, mode) {
+    return defineCompositeAssertion({
+        assert(check, subject) {
+            return onceAssertion(check, subject, mode);
+        },
+        formatSummary() {
+            return `Expected double to have exactly one ${modeNoun(mode)}.`;
+        },
+        name
+    });
+}
+//# sourceMappingURL=double-usage-count-assertion.js.map

package/doubles/double-usage-count-assertion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"double-usage-count-assertion.js","sourceRoot":"","sources":["../../../../source/doubles/double-usage-count-assertion.ts"],"names":[],"mappings":"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"}

package/doubles/double-usage-disposal-assertion.js

@@ -0,0 +1,175 @@
+import { defineCompositeAssertion } from "../assert/assertion-extension.js";
+import { groupChildren } from "./double-usage-contract.js";
+import { chronologyFor, inspectedDouble, validNonNegativeInteger } from "./double-usage-inspection.js";
+import { protocolDisposeMethod } from "./protocol-double-metadata.js";
+const minimumOrderedDisposables = 2;
+function invalidDisposableFailure(check) {
+    return check.fromThrowable('test disposable', function expectedTestDisposable() {
+        throw new TypeError('Expected an Overkill test disposable.');
+    });
+}
+function inspectedDisposal(check, subject) {
+    const disposeMethod = protocolDisposeMethod(subject);
+    if (disposeMethod === null) {
+        return {
+            failure: invalidDisposableFailure(check),
+            valid: false
+        };
+    }
+    const inspection = inspectedDouble(check, disposeMethod);
+    return inspection.valid
+        ? {
+            inspection,
+            valid: true
+        }
+        : {
+            failure: inspection.failure,
+            valid: false
+        };
+}
+function disposalCount(check, subject) {
+    const inspected = inspectedDisposal(check, subject);
+    return inspected.valid
+        ? check.annotated('dispose count').greaterThan(inspected.inspection.history.callCount, 0)
+        : inspected.failure;
+}
+function noDisposal(check, subject) {
+    const inspected = inspectedDisposal(check, subject);
+    return inspected.valid
+        ? check.annotated('dispose count').equal(inspected.inspection.history.callCount, 0)
+        : inspected.failure;
+}
+function disposalOnce(check, subject) {
+    const inspected = inspectedDisposal(check, subject);
+    return inspected.valid
+        ? check.annotated('dispose count').equal(inspected.inspection.history.callCount, 1)
+        : inspected.failure;
+}
+function expectedDisposalCount(check, subject, expectedCount) {
+    const inspected = inspectedDisposal(check, subject);
+    if (!inspected.valid) {
+        return inspected.failure;
+    }
+    return check.group([
+        check.annotated('expected count').true(validNonNegativeInteger(expectedCount)),
+        check.annotated('dispose count').equal(inspected.inspection.history.callCount, expectedCount)
+    ]);
+}
+function inspectDisposables(check, disposables) {
+    const inspections = [];
+    const failures = [];
+    for (const disposable of disposables) {
+        const inspected = inspectedDisposal(check, disposable);
+        if (inspected.valid) {
+            inspections.push(inspected.inspection);
+        }
+        else {
+            failures.push(inspected.failure);
+        }
+    }
+    return failures.length === 0
+        ? {
+            inspections,
+            valid: true
+        }
+        : {
+            result: groupChildren(check, failures, 'disposal'),
+            valid: false
+        };
+}
+function hasMixedScope(inspections) {
+    const firstScope = inspections[0]?.chronology.scope;
+    return inspections.some(function hasDifferentScope(inspection) {
+        return inspection.chronology.scope !== firstScope;
+    });
+}
+function sharedScopeFailure(check) {
+    return check.fromThrowable('dispose order', function expectedSharedScope() {
+        throw new TypeError('Expected ordered disposables to belong to the same double scope.');
+    });
+}
+function disposalEventGroups(inspections) {
+    return inspections.map(function eventsFor(inspection) {
+        return chronologyFor(inspection.chronology, 'call');
+    });
+}
+function missingDisposalChecks(check, eventGroups) {
+    return eventGroups.flatMap(function missingEvents(events, index) {
+        return events.length === 0 ? [check.annotated(`dispose ${index}`).notEmpty(events)] : [];
+    });
+}
+function disposalOrderChecks(check, eventGroups) {
+    return eventGroups.slice(0, -1).flatMap(function pairOrder(previousEvents, index) {
+        const nextEvents = eventGroups[index + 1] ?? [];
+        const previousLast = previousEvents.at(-1);
+        const nextFirst = nextEvents[0];
+        return previousLast === undefined || nextFirst === undefined ? [] : [
+            check.annotated(`dispose order ${index} before ${index + 1}`).lessThan(previousLast.order, nextFirst.order)
+        ];
+    });
+}
+function disposalOrder(check, disposables) {
+    if (disposables.length < minimumOrderedDisposables) {
+        return check.fromThrowable('dispose order', function expectedDisposalOrder() {
+            throw new TypeError('Expected at least two disposables.');
+        });
+    }
+    const inspected = inspectDisposables(check, disposables);
+    if (!inspected.valid) {
+        return inspected.result;
+    }
+    if (hasMixedScope(inspected.inspections)) {
+        return sharedScopeFailure(check);
+    }
+    const eventGroups = disposalEventGroups(inspected.inspections);
+    return groupChildren(check, [
+        ...missingDisposalChecks(check, eventGroups),
+        ...disposalOrderChecks(check, eventGroups)
+    ], 'dispose order');
+}
+export function disposedReference(name) {
+    return defineCompositeAssertion({
+        assert: disposalCount,
+        formatSummary() {
+            return 'Expected disposable to have been disposed.';
+        },
+        name
+    });
+}
+export function notDisposedReference(name) {
+    return defineCompositeAssertion({
+        assert: noDisposal,
+        formatSummary() {
+            return 'Expected disposable not to have been disposed.';
+        },
+        name
+    });
+}
+export function disposedOnceReference(name) {
+    return defineCompositeAssertion({
+        assert: disposalOnce,
+        formatSummary() {
+            return 'Expected disposable to have been disposed once.';
+        },
+        name
+    });
+}
+export function disposeCountReference(name) {
+    return defineCompositeAssertion({
+        assert: expectedDisposalCount,
+        formatSummary() {
+            return 'Expected dispose count to match.';
+        },
+        name
+    });
+}
+export function disposeOrderReference(name) {
+    return defineCompositeAssertion({
+        assert: disposalOrder,
+        formatSummary() {
+            return 'Expected dispose order to match.';
+        },
+        name
+    });
+}
+//# sourceMappingURL=double-usage-disposal-assertion.js.map

package/doubles/double-usage-disposal-assertion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"double-usage-disposal-assertion.js","sourceRoot":"","sources":["../../../../source/doubles/double-usage-disposal-assertion.ts"],"names":[],"mappings":"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"}

package/doubles/double-usage-inspection.js

@@ -0,0 +1,59 @@
+import { doubleChronology } from "./double-chronology.js";
+export function recordsFor(history, mode) {
+    if (mode === 'call') {
+        return history.calls;
+    }
+    return mode === 'construction' ? history.constructions : history.interactions;
+}
+export function chronologyFor(chronology, mode) {
+    if (mode === 'call') {
+        return chronology.calls;
+    }
+    return mode === 'construction' ? chronology.constructions : chronology.interactions;
+}
+export function countFor(history, mode) {
+    if (mode === 'call') {
+        return history.callCount;
+    }
+    return mode === 'construction' ? history.constructionCount : history.interactionCount;
+}
+function hasNumberHistoryProperties(value) {
+    return typeof value === 'function' &&
+        typeof Reflect.get(value, 'callCount') === 'number' &&
+        typeof Reflect.get(value, 'constructionCount') === 'number' &&
+        typeof Reflect.get(value, 'interactionCount') === 'number' &&
+        typeof Reflect.get(value, 'iteratorEventCount') === 'number';
+}
+function hasArrayHistoryProperties(value) {
+    return typeof value === 'function' &&
+        Array.isArray(Reflect.get(value, 'calls')) &&
+        Array.isArray(Reflect.get(value, 'constructions')) &&
+        Array.isArray(Reflect.get(value, 'interactions')) &&
+        Array.isArray(Reflect.get(value, 'iteratorEvents'));
+}
+function isHistoryShape(value) {
+    return hasNumberHistoryProperties(value) &&
+        hasArrayHistoryProperties(value);
+}
+function invalidDoubleFailure(check) {
+    return check.fromThrowable('test double', function expectedTestDouble() {
+        throw new TypeError('Expected an Overkill test double.');
+    });
+}
+export function inspectedDouble(check, subject) {
+    const chronology = doubleChronology(subject);
+    return chronology === null || !isHistoryShape(subject)
+        ? {
+            failure: invalidDoubleFailure(check),
+            valid: false
+        }
+        : {
+            chronology,
+            history: subject,
+            valid: true
+        };
+}
+export function validNonNegativeInteger(value) {
+    return Number.isSafeInteger(value) && value >= 0;
+}
+//# sourceMappingURL=double-usage-inspection.js.map

package/doubles/double-usage-inspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"double-usage-inspection.js","sourceRoot":"","sources":["../../../../source/doubles/double-usage-inspection.ts"],"names":[],"mappings":"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"}

package/doubles/double-usage-iterator-assertion.js

@@ -0,0 +1,124 @@
+import { defineCompositeAssertion } from "../assert/assertion-extension.js";
+import { groupChildren } from "./double-usage-contract.js";
+import { inspectedDouble, validNonNegativeInteger } from "./double-usage-inspection.js";
+import { protocolIteratorEvents } from "./protocol-double-metadata.js";
+function inspectedIteratorEvents(check, subject) {
+    const protocolEvents = protocolIteratorEvents(subject);
+    if (protocolEvents !== null) {
+        return {
+            events: protocolEvents,
+            valid: true
+        };
+    }
+    const inspected = inspectedDouble(check, subject);
+    return inspected.valid
+        ? {
+            events: inspected.history.iteratorEvents,
+            valid: true
+        }
+        : {
+            result: inspected.failure,
+            valid: false
+        };
+}
+function iteratorEventCount(check, subject) {
+    const inspected = inspectedIteratorEvents(check, subject);
+    return inspected.valid
+        ? check.annotated('iterator event count').greaterThan(inspected.events.length, 0)
+        : inspected.result;
+}
+function noIteratorEvents(check, subject) {
+    const inspected = inspectedIteratorEvents(check, subject);
+    return inspected.valid
+        ? check.annotated('iterator event count').equal(inspected.events.length, 0)
+        : inspected.result;
+}
+function yieldedValues(history) {
+    return history
+        .iteratorEvents
+        .filter(function yieldedEvent(event) {
+        return event.kind === 'yield';
+    })
+        .map(function yieldedValue(event) {
+        return event.value;
+    });
+}
+function iteratorCountAssertion(input) {
+    const inspected = inspectedIteratorEvents(input.check, input.subject);
+    if (!inspected.valid) {
+        return inspected.result;
+    }
+    const actualCounts = {
+        event: inspected.events.length,
+        yield: yieldedValues({ iteratorEvents: inspected.events }).length
+    };
+    return input.check.group([
+        input.check.annotated('expected count').true(validNonNegativeInteger(input.expectedCount)),
+        input.check.annotated(input.value === 'event' ? 'iterator event count' : 'yield count').equal(actualCounts[input.value], input.expectedCount)
+    ]);
+}
+function yieldedExactlyAssertion(check, subject, expectedValues) {
+    const inspected = inspectedDouble(check, subject);
+    const protocolEvents = protocolIteratorEvents(subject);
+    if (protocolEvents !== null) {
+        return groupChildren(check, [
+            check.annotated('yielded values').deepEqual(yieldedValues({ iteratorEvents: protocolEvents }), expectedValues)
+        ], 'yielded values');
+    }
+    if (!inspected.valid) {
+        return inspected.failure;
+    }
+    return groupChildren(check, [
+        check.annotated('yielded values').deepEqual(yieldedValues(inspected.history), expectedValues)
+    ], 'yielded values');
+}
+export function iteratedReference(name) {
+    return defineCompositeAssertion({
+        assert: iteratorEventCount,
+        formatSummary() {
+            return 'Expected double iterator to have been consumed.';
+        },
+        name
+    });
+}
+export function notIteratedReference(name) {
+    return defineCompositeAssertion({
+        assert: noIteratorEvents,
+        formatSummary() {
+            return 'Expected double iterator not to have been consumed.';
+        },
+        name
+    });
+}
+export function iteratorEventCountReference(name) {
+    return defineCompositeAssertion({
+        assert(check, subject, expectedCount) {
+            return iteratorCountAssertion({ check, expectedCount, subject, value: 'event' });
+        },
+        formatSummary() {
+            return 'Expected double iterator event count to match.';
+        },
+        name
+    });
+}
+export function yieldCountReference(name) {
+    return defineCompositeAssertion({
+        assert(check, subject, expectedCount) {
+            return iteratorCountAssertion({ check, expectedCount, subject, value: 'yield' });
+        },
+        formatSummary() {
+            return 'Expected double yield count to match.';
+        },
+        name
+    });
+}
+export function yieldedExactlyReference(name) {
+    return defineCompositeAssertion({
+        assert: yieldedExactlyAssertion,
+        formatSummary() {
+            return 'Expected double yielded values to match exactly.';
+        },
+        name
+    });
+}
+//# sourceMappingURL=double-usage-iterator-assertion.js.map

package/doubles/double-usage-iterator-assertion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"double-usage-iterator-assertion.js","sourceRoot":"","sources":["../../../../source/doubles/double-usage-iterator-assertion.ts"],"names":[],"mappings":"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"}

package/doubles/double-usage-order-assertion.js

@@ -0,0 +1,91 @@
+import { defineCompositeAssertion } from "../assert/assertion-extension.js";
+import { groupChildren, modeNoun } from "./double-usage-contract.js";
+import { chronologyFor, inspectedDouble } from "./double-usage-inspection.js";
+const minimumOrderedDoubles = 2;
+function inspectDoubles(check, doubles) {
+    const inspections = [];
+    const failures = [];
+    for (const double of doubles) {
+        const inspection = inspectedDouble(check, double);
+        if (inspection.valid) {
+            inspections.push(inspection);
+        }
+        else {
+            failures.push(inspection.failure);
+        }
+    }
+    return failures.length === 0
+        ? {
+            inspections,
+            valid: true
+        }
+        : {
+            result: groupChildren(check, failures, 'double usage'),
+            valid: false
+        };
+}
+function hasMixedScope(inspections) {
+    const firstScope = inspections[0]?.chronology.scope;
+    return inspections.some(function hasDifferentScope(inspection) {
+        return inspection.chronology.scope !== firstScope;
+    });
+}
+function sharedScopeFailure(check) {
+    return check.fromThrowable('double usage scope', function expectedSharedScope() {
+        throw new TypeError('Expected ordered doubles to belong to the same double scope.');
+    });
+}
+function eventGroupsFor(inspections, mode) {
+    return inspections.map(function eventsFor(inspection) {
+        return chronologyFor(inspection.chronology, mode);
+    });
+}
+function missingEventChecks(check, eventGroups, mode) {
+    return eventGroups.flatMap(function missingEvents(events, index) {
+        return events.length === 0 ? [check.annotated(`${modeNoun(mode)} ${index}`).notEmpty(events)] : [];
+    });
+}
+function orderChecks(check, eventGroups, mode) {
+    return eventGroups.slice(0, -1).flatMap(function pairOrder(previousEvents, index) {
+        const nextEvents = eventGroups[index + 1] ?? [];
+        const previousLast = previousEvents.at(-1);
+        const nextFirst = nextEvents[0];
+        return previousLast === undefined || nextFirst === undefined ? [] : [
+            check
+                .annotated(`${modeNoun(mode)} order ${index} before ${index + 1}`)
+                .lessThan(previousLast.order, nextFirst.order)
+        ];
+    });
+}
+function orderAssertion(input) {
+    if (input.doubles.length < minimumOrderedDoubles) {
+        return input.check.fromThrowable('double usage order', function expectedDoubleOrder() {
+            throw new TypeError('Expected at least two doubles.');
+        });
+    }
+    const inspected = inspectDoubles(input.check, input.doubles);
+    if (!inspected.valid) {
+        return inspected.result;
+    }
+    if (hasMixedScope(inspected.inspections)) {
+        return sharedScopeFailure(input.check);
+    }
+    const eventGroups = eventGroupsFor(inspected.inspections, input.mode);
+    const children = [
+        ...missingEventChecks(input.check, eventGroups, input.mode),
+        ...orderChecks(input.check, eventGroups, input.mode)
+    ];
+    return groupChildren(input.check, children, `${modeNoun(input.mode)} order`);
+}
+export function orderReference(name, mode) {
+    return defineCompositeAssertion({
+        assert(check, doubles) {
+            return orderAssertion({ check, doubles, mode });
+        },
+        formatSummary() {
+            return `Expected double ${modeNoun(mode)} order to match.`;
+        },
+        name
+    });
+}
+//# sourceMappingURL=double-usage-order-assertion.js.map

package/doubles/double-usage-order-assertion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"double-usage-order-assertion.js","sourceRoot":"","sources":["../../../../source/doubles/double-usage-order-assertion.ts"],"names":[],"mappings":"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"}

package/doubles/double-usage.d.ts

@@ -0,0 +1,81 @@
+import type { AggregateArguments, AggregateIndexedArguments, AggregateIndexedPrefixArguments, AggregatePrefixArguments, CountArguments, IteratorValuesArguments, OrderArguments, UsageAssertionReference, ValueArguments } from './double-usage-contract.ts';
+type CountReference = UsageAssertionReference<CountArguments>;
+type IteratorValuesReference = UsageAssertionReference<IteratorValuesArguments>;
+type ValueReference = UsageAssertionReference<ValueArguments>;
+type OrderReference = UsageAssertionReference<OrderArguments>;
+type ArgumentReference = UsageAssertionReference<AggregateArguments>;
+type PrefixReference = UsageAssertionReference<AggregatePrefixArguments>;
+type IndexedArgumentReference = UsageAssertionReference<AggregateIndexedArguments>;
+type IndexedPrefixReference = UsageAssertionReference<AggregateIndexedPrefixArguments>;
+export type DoubleUsageAssertions = {
+    readonly callCount: CountReference;
+    readonly callOrder: OrderReference;
+    readonly called: ValueReference;
+    readonly calledOnce: ValueReference;
+    readonly calledOnceWith: ArgumentReference;
+    readonly calledOnceWithExactly: ArgumentReference;
+    readonly calledOnceWithPrefix: PrefixReference;
+    readonly calledWith: ArgumentReference;
+    readonly calledWithExactly: ArgumentReference;
+    readonly calledWithPrefix: PrefixReference;
+    readonly constructed: ValueReference;
+    readonly constructedOnce: ValueReference;
+    readonly constructedOnceWith: ArgumentReference;
+    readonly constructedOnceWithExactly: ArgumentReference;
+    readonly constructedOnceWithPrefix: PrefixReference;
+    readonly constructedWith: ArgumentReference;
+    readonly constructedWithExactly: ArgumentReference;
+    readonly constructedWithPrefix: PrefixReference;
+    readonly constructionCount: CountReference;
+    readonly constructionOrder: OrderReference;
+    readonly disposeCount: CountReference;
+    readonly disposeOrder: OrderReference;
+    readonly disposed: ValueReference;
+    readonly disposedOnce: ValueReference;
+    readonly interacted: ValueReference;
+    readonly interactedOnce: ValueReference;
+    readonly interactedOnceWith: ArgumentReference;
+    readonly interactedOnceWithExactly: ArgumentReference;
+    readonly interactedOnceWithPrefix: PrefixReference;
+    readonly interactedWith: ArgumentReference;
+    readonly interactedWithExactly: ArgumentReference;
+    readonly interactedWithPrefix: PrefixReference;
+    readonly iterated: ValueReference;
+    readonly iteratorEventCount: CountReference;
+    readonly interactionCount: CountReference;
+    readonly interactionOrder: OrderReference;
+    readonly lastCalledWith: ArgumentReference;
+    readonly lastCalledWithExactly: ArgumentReference;
+    readonly lastCalledWithPrefix: PrefixReference;
+    readonly lastConstructedWith: ArgumentReference;
+    readonly lastConstructedWithExactly: ArgumentReference;
+    readonly lastConstructedWithPrefix: PrefixReference;
+    readonly lastInteractedWith: ArgumentReference;
+    readonly lastInteractedWithExactly: ArgumentReference;
+    readonly lastInteractedWithPrefix: PrefixReference;
+    readonly notCalled: ValueReference;
+    readonly notCalledWith: ArgumentReference;
+    readonly notCalledWithPrefix: PrefixReference;
+    readonly notConstructed: ValueReference;
+    readonly notConstructedWith: ArgumentReference;
+    readonly notConstructedWithPrefix: PrefixReference;
+    readonly notDisposed: ValueReference;
+    readonly notInteracted: ValueReference;
+    readonly notInteractedWith: ArgumentReference;
+    readonly notInteractedWithPrefix: PrefixReference;
+    readonly notIterated: ValueReference;
+    readonly nthCallWith: IndexedArgumentReference;
+    readonly nthCallWithExactly: IndexedArgumentReference;
+    readonly nthCallWithPrefix: IndexedPrefixReference;
+    readonly nthConstructionWith: IndexedArgumentReference;
+    readonly nthConstructionWithExactly: IndexedArgumentReference;
+    readonly nthConstructionWithPrefix: IndexedPrefixReference;
+    readonly nthInteractionWith: IndexedArgumentReference;
+    readonly nthInteractionWithExactly: IndexedArgumentReference;
+    readonly nthInteractionWithPrefix: IndexedPrefixReference;
+    readonly yieldCount: CountReference;
+    readonly yieldedExactly: IteratorValuesReference;
+};
+export declare const doubleUsage: DoubleUsageAssertions;
+export {};
+//# sourceMappingURL=double-usage.d.ts.map

package/doubles/double-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"double-usage.d.ts","sourceRoot":"","sources":["../../../../source/doubles/double-usage.ts"],"names":[],"mappings":"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"}