npm - @overkill-dev/assert - Versions diffs - 0.0.1 → 0.0.3 - Mend

@overkill-dev/assert 0.0.1 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/LICENSE +21 -0
package/assert/assertion-extension.d.ts +65 -0
package/assert/assertion-extension.d.ts.map +1 -0
package/assert/assertion-extension.js +257 -0
package/assert/assertion-extension.js.map +1 -0
package/package.json +33 -6
package/packages/assert/assert.entry-point.d.ts +5 -0
package/packages/assert/assert.entry-point.d.ts.map +1 -0
package/packages/assert/assert.entry-point.js +2 -0
package/packages/assert/assert.entry-point.js.map +1 -0
package/readme.md +54 -5
package/sbom.cdx.json +50 -0

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) Overkill contributors
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assert/assertion-extension.d.ts ADDED Viewed

@@ -0,0 +1,65 @@
+import { type CompositeAssertionGroup, type CompositeAssertionReference, type CompositeAssertionSummaryContext, type AssertCompositeAssertionReturn, type NarrowingCompositeAssertionReference } from '@overkill-dev/engine/assertion-protocol/assertion-reference.js';
+import type { BuiltInAssertAssertionNode, CompositeAssertionChildNode, ForeignAssertionNode } from '@overkill-dev/engine/assertion-protocol/assertion-node.js';
+import type { AssertionSource, DeepComparable, InstanceConstructor, NonEmptyReadonlyArray, ResolvableSourceLocation } from '@overkill-dev/engine/assertion-protocol/assertion-node-shape.d.ts';
+import { type SynchronousCallback, type ThrownMatcher } from '@overkill-dev/engine/assertion-protocol/thrown-matcher.js';
+type GroupItem<Source extends AssertionSource> = CompositeAssertionChildNode<Source> | CompositeAssertionGroup<Source>;
+type CompositeAssertionSummaryFormatter<Arguments extends readonly unknown[]> = (context: CompositeAssertionSummaryContext, ...parameters: Arguments) => string;
+type NarrowingCompositeAssertionSummaryFormatter<Actual, Arguments extends readonly unknown[]> = (context: CompositeAssertionSummaryContext, actual: Actual, ...parameters: Arguments) => string;
+export type CompositeCheckBuilder<Source extends AssertionSource = AssertionSource> = {
+    readonly annotated: (message: string) => CompositeCheckBuilder<Source>;
+    readonly array: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly arrayContainsPartial: <Actual, Expected>(actual: readonly DeepComparable<Actual>[], expectedSubset: DeepComparable<Expected>) => BuiltInAssertAssertionNode<Source>;
+    readonly between: (actual: number, minimum: number, maximum: number) => BuiltInAssertAssertionNode<Source>;
+    readonly boolean: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly deepEqual: <Actual, Expected>(actual: DeepComparable<Actual>, expected: DeepComparable<Expected>) => BuiltInAssertAssertionNode<Source>;
+    readonly defined: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly empty: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly endsWith: (actual: string, expected: string) => BuiltInAssertAssertionNode<Source>;
+    readonly equal: (actual: unknown, expected: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly fail: () => BuiltInAssertAssertionNode<Source>;
+    readonly false: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly fromRejectable: (label: string, body: () => Promise<void>) => Promise<ForeignAssertionNode<Source>>;
+    readonly fromThrowable: (label: string, body: () => void) => ForeignAssertionNode<Source>;
+    readonly function: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly greaterThan: (actual: number, expected: number) => BuiltInAssertAssertionNode<Source>;
+    readonly greaterThanOrEqual: (actual: number, expected: number) => BuiltInAssertAssertionNode<Source>;
+    readonly group: (children: NonEmptyReadonlyArray<GroupItem<Source>>) => CompositeAssertionGroup<Source>;
+    readonly hasProperty: (actual: unknown, key: PropertyKey) => BuiltInAssertAssertionNode<Source>;
+    readonly includes: (actual: string, expected: string) => BuiltInAssertAssertionNode<Source>;
+    readonly instanceOf: (actual: unknown, expected: InstanceConstructor) => BuiltInAssertAssertionNode<Source>;
+    readonly length: (actual: unknown, expectedLength: number) => BuiltInAssertAssertionNode<Source>;
+    readonly lessThan: (actual: number, expected: number) => BuiltInAssertAssertionNode<Source>;
+    readonly lessThanOrEqual: (actual: number, expected: number) => BuiltInAssertAssertionNode<Source>;
+    readonly match: (actual: string, pattern: RegExp) => BuiltInAssertAssertionNode<Source>;
+    readonly membersPartialDeepEqual: <Actual, Expected>(actual: readonly DeepComparable<Actual>[], expectedMembers: readonly DeepComparable<Expected>[]) => BuiltInAssertAssertionNode<Source>;
+    readonly notDeepEqual: <Actual, Expected>(actual: DeepComparable<Actual>, expected: DeepComparable<Expected>) => BuiltInAssertAssertionNode<Source>;
+    readonly notEmpty: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly notEqual: (actual: unknown, expected: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly notMatch: (actual: string, pattern: RegExp) => BuiltInAssertAssertionNode<Source>;
+    readonly notNull: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly null: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly number: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly object: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly partialDeepEqual: <Actual, Expected>(actual: DeepComparable<Actual>, expectedSubset: DeepComparable<Expected>) => BuiltInAssertAssertionNode<Source>;
+    readonly rejects: (thunk: () => PromiseLike<unknown>, matcher: ThrownMatcher) => Promise<CompositeAssertionGroup<Source>>;
+    readonly startsWith: (actual: string, expected: string) => BuiltInAssertAssertionNode<Source>;
+    readonly string: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly throws: <Body extends () => unknown>(body: SynchronousCallback<Body>, matcher: ThrownMatcher) => CompositeAssertionGroup<Source>;
+    readonly true: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+    readonly undefined: (actual: unknown) => BuiltInAssertAssertionNode<Source>;
+};
+export type CompositeAssertionDefinition<Arguments extends readonly unknown[], Result extends AssertCompositeAssertionReturn> = {
+    readonly assert: (check: CompositeCheckBuilder<'assert'>, ...parameters: Arguments) => Result;
+    readonly formatSummary?: CompositeAssertionSummaryFormatter<Arguments>;
+    readonly name: string;
+};
+export type NarrowingCompositeAssertionDefinition<Actual, Narrowed extends Actual, Arguments extends readonly unknown[]> = {
+    readonly formatSummary?: NarrowingCompositeAssertionSummaryFormatter<Actual, Arguments>;
+    readonly name: string;
+    readonly narrows: (actual: Actual, ...parameters: Arguments) => actual is Narrowed;
+};
+export declare function createCompositeCheckBuilder<Source extends AssertionSource>(source: Source, message: string | null, location: ResolvableSourceLocation): CompositeCheckBuilder<Source>;
+export declare function defineCompositeAssertion<Arguments extends readonly unknown[], Result extends AssertCompositeAssertionReturn>(definition: CompositeAssertionDefinition<Arguments, Result>): CompositeAssertionReference<Arguments, Result>;
+export declare function defineNarrowingCompositeAssertion<Actual, Narrowed extends Actual, Arguments extends readonly unknown[]>(definition: NarrowingCompositeAssertionDefinition<Actual, Narrowed, Arguments>): NarrowingCompositeAssertionReference<Actual, Narrowed, Arguments>;
+export {};
+//# sourceMappingURL=assertion-extension.d.ts.map

package/assert/assertion-extension.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"assertion-extension.d.ts","sourceRoot":"","sources":["../../../../source/assert/assertion-extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,8BAA8B,EACnC,KAAK,oCAAoC,EAC5C,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EACR,0BAA0B,EAC1B,2BAA2B,EAC3B,oBAAoB,EACvB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EACR,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EAC3B,MAAM,+CAA+C,CAAC;AAEvD,OAAO,EACH,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAErB,MAAM,yCAAyC,CAAC;AAEjD,KAAK,SAAS,CAAC,MAAM,SAAS,eAAe,IAAI,2BAA2B,CAAC,MAAM,CAAC,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAEvH,KAAK,kCAAkC,CAAC,SAAS,SAAS,SAAS,OAAO,EAAE,IAAI,CAC5E,OAAO,EAAE,gCAAgC,EACzC,GAAG,UAAU,EAAE,SAAS,KACvB,MAAM,CAAC;AAEZ,KAAK,2CAA2C,CAAC,MAAM,EAAE,SAAS,SAAS,SAAS,OAAO,EAAE,IAAI,CAC7F,OAAO,EAAE,gCAAgC,EACzC,MAAM,EAAE,MAAM,EACd,GAAG,UAAU,EAAE,SAAS,KACvB,MAAM,CAAC;AAUZ,MAAM,MAAM,qBAAqB,CAAC,MAAM,SAAS,eAAe,GAAG,eAAe,IAAI;IAClF,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvE,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACxE,QAAQ,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,QAAQ,EAC5C,MAAM,EAAE,SAAS,cAAc,CAAC,MAAM,CAAC,EAAE,EACzC,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,KACvC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC3G,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC1E,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,QAAQ,EACjC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,EAC9B,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,KACjC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC1E,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACxE,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC5F,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC3F,QAAQ,CAAC,IAAI,EAAE,MAAM,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACxD,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACxE,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7G,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1F,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC3E,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC/F,QAAQ,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACtG,QAAQ,CAAC,KAAK,EAAE,CACZ,QAAQ,EAAE,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KACjD,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAChG,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC5F,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,mBAAmB,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC5G,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACjG,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC5F,QAAQ,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnG,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACxF,QAAQ,CAAC,uBAAuB,EAAE,CAAC,MAAM,EAAE,QAAQ,EAC/C,MAAM,EAAE,SAAS,cAAc,CAAC,MAAM,CAAC,EAAE,EACzC,eAAe,EAAE,SAAS,cAAc,CAAC,QAAQ,CAAC,EAAE,KACnD,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,QAAQ,EACpC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,EAC9B,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,KACjC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC3E,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC9F,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC3F,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC1E,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACvE,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACzE,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACzE,QAAQ,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,QAAQ,EACxC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,EAC9B,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,KACvC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,CACd,KAAK,EAAE,MAAM,WAAW,CAAC,OAAO,CAAC,EACjC,OAAO,EAAE,aAAa,KACrB,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAC9F,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACzE,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,MAAM,OAAO,EACxC,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAC/B,OAAO,EAAE,aAAa,KACrB,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACvE,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC;CAC/E,CAAC;AAEF,MAAM,MAAM,4BAA4B,CACpC,SAAS,SAAS,SAAS,OAAO,EAAE,EACpC,MAAM,SAAS,8BAA8B,IAC7C;IACA,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,qBAAqB,CAAC,QAAQ,CAAC,EAAE,GAAG,UAAU,EAAE,SAAS,KAAK,MAAM,CAAC;IAC9F,QAAQ,CAAC,aAAa,CAAC,EAAE,kCAAkC,CAAC,SAAS,CAAC,CAAC;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,qCAAqC,CAC7C,MAAM,EACN,QAAQ,SAAS,MAAM,EACvB,SAAS,SAAS,SAAS,OAAO,EAAE,IACpC;IACA,QAAQ,CAAC,aAAa,CAAC,EAAE,2CAA2C,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,SAAS,KAAK,MAAM,IAAI,QAAQ,CAAC;CACtF,CAAC;AAuCF,wBAAgB,2BAA2B,CAAC,MAAM,SAAS,eAAe,EACtE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,QAAQ,EAAE,wBAAwB,GACnC,qBAAqB,CAAC,MAAM,CAAC,CA0P/B;AAED,wBAAgB,wBAAwB,CACpC,SAAS,SAAS,SAAS,OAAO,EAAE,EACpC,MAAM,SAAS,8BAA8B,EAC/C,UAAU,EAAE,4BAA4B,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,2BAA2B,CAAC,SAAS,EAAE,MAAM,CAAC,CAY7G;AAED,wBAAgB,iCAAiC,CAC7C,MAAM,EACN,QAAQ,SAAS,MAAM,EACvB,SAAS,SAAS,SAAS,OAAO,EAAE,EAEpC,UAAU,EAAE,qCAAqC,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,GAC/E,oCAAoC,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAOnE"}

package/assert/assertion-extension.js ADDED Viewed

@@ -0,0 +1,257 @@
+import { createAssertionReferenceRecord, createCompositeAssertionGroup, isCompositeAssertionGroup } from "@overkill-dev/engine/assertion-protocol/assertion-reference.js";
+import { createThrownErrorRecord } from "@overkill-dev/engine/assertion-protocol/thrown-error-record.js";
+import { thrownMatcherChildren } from "@overkill-dev/engine/assertion-protocol/thrown-matcher.js";
+function createForeignAssertionNode(input) {
+    return {
+        check: 'foreign',
+        label: input.label,
+        location: input.location,
+        message: input.message,
+        result: input.result,
+        source: input.source,
+        summary: input.result.passed
+            ? `Expected foreign assertion ${input.label} to pass.`
+            : `${input.label}: ${input.result.error.message}`
+    };
+}
+function assertNonEmptyItems(items, message) {
+    if (items.length === 0) {
+        throw new TypeError(message);
+    }
+}
+function flattenCompositeGroupItems(items) {
+    const children = items.flatMap(function toChildren(item) {
+        return isCompositeAssertionGroup(item) ? item.children : [item];
+    });
+    assertNonEmptyItems(children, 'Expected composite assertion group to contain children.');
+    return children;
+}
+export function createCompositeCheckBuilder(source, message, location) {
+    return {
+        annotated(childMessage) {
+            return createCompositeCheckBuilder(source, childMessage, location);
+        },
+        array(actual) {
+            return { actual, check: 'array', location, message, source };
+        },
+        arrayContainsPartial(actual, expected) {
+            return { actual, check: 'array-contains-partial', expected, location, message, source };
+        },
+        between(actual, minimum, maximum) {
+            return { actual, check: 'between', location, maximum, message, minimum, source };
+        },
+        boolean(actual) {
+            return { actual, check: 'boolean', location, message, source };
+        },
+        deepEqual(actual, expected) {
+            return { actual, check: 'deep-equal', expected, location, message, source };
+        },
+        defined(actual) {
+            return { actual, check: 'defined', location, message, source };
+        },
+        empty(actual) {
+            return { actual, check: 'empty', location, message, source };
+        },
+        endsWith(actual, expected) {
+            return { actual, check: 'ends-with', expected, location, message, source };
+        },
+        equal(actual, expected) {
+            return { actual, check: 'equal', expected, location, message, source };
+        },
+        fail() {
+            return { check: 'fail', location, message, source };
+        },
+        false(actual) {
+            return { actual, check: 'false', location, message, source };
+        },
+        async fromRejectable(label, body) {
+            try {
+                await body();
+                return createForeignAssertionNode({
+                    label,
+                    location,
+                    message,
+                    result: { passed: true },
+                    source
+                });
+            }
+            catch (error) {
+                return createForeignAssertionNode({
+                    label,
+                    location,
+                    message,
+                    result: {
+                        error: createThrownErrorRecord(error),
+                        passed: false
+                    },
+                    source
+                });
+            }
+        },
+        fromThrowable(label, body) {
+            try {
+                body();
+                return createForeignAssertionNode({
+                    label,
+                    location,
+                    message,
+                    result: { passed: true },
+                    source
+                });
+            }
+            catch (error) {
+                return createForeignAssertionNode({
+                    label,
+                    location,
+                    message,
+                    result: {
+                        error: createThrownErrorRecord(error),
+                        passed: false
+                    },
+                    source
+                });
+            }
+        },
+        function(actual) {
+            return { actual, check: 'function', location, message, source };
+        },
+        greaterThan(actual, expected) {
+            return { actual, check: 'greater-than', expected, location, message, source };
+        },
+        greaterThanOrEqual(actual, expected) {
+            return { actual, check: 'greater-than-or-equal', expected, location, message, source };
+        },
+        group(children) {
+            return createCompositeAssertionGroup(flattenCompositeGroupItems(children));
+        },
+        hasProperty(actual, key) {
+            return { actual, check: 'has-property', key, location, message, source };
+        },
+        includes(actual, expected) {
+            return { actual, check: 'includes', expected, location, message, source };
+        },
+        instanceOf(actual, expected) {
+            return { actual, check: 'instance-of', expected, location, message, source };
+        },
+        length(actual, expectedLength) {
+            return { actual, check: 'length', expectedLength, location, message, source };
+        },
+        lessThan(actual, expected) {
+            return { actual, check: 'less-than', expected, location, message, source };
+        },
+        lessThanOrEqual(actual, expected) {
+            return { actual, check: 'less-than-or-equal', expected, location, message, source };
+        },
+        match(actual, pattern) {
+            return { actual, check: 'match', location, message, pattern, source };
+        },
+        membersPartialDeepEqual(actual, expected) {
+            return { actual, check: 'members-partial-deep-equal', expected, location, message, source };
+        },
+        notDeepEqual(actual, expected) {
+            return { actual, check: 'not-deep-equal', expected, location, message, source };
+        },
+        notEmpty(actual) {
+            return { actual, check: 'not-empty', location, message, source };
+        },
+        notEqual(actual, expected) {
+            return { actual, check: 'not-equal', expected, location, message, source };
+        },
+        notMatch(actual, pattern) {
+            return { actual, check: 'not-match', location, message, pattern, source };
+        },
+        notNull(actual) {
+            return { actual, check: 'not-null', location, message, source };
+        },
+        null(actual) {
+            return { actual, check: 'null', location, message, source };
+        },
+        number(actual) {
+            return { actual, check: 'number', location, message, source };
+        },
+        object(actual) {
+            return { actual, check: 'object', location, message, source };
+        },
+        partialDeepEqual(actual, expected) {
+            return { actual, check: 'partial-deep-equal', expected, location, message, source };
+        },
+        async rejects(thunk, matcher) {
+            const promise = thunk();
+            try {
+                const value = await promise;
+                return createCompositeAssertionGroup(thrownMatcherChildren({
+                    kind: 'rejects',
+                    location,
+                    matcher,
+                    message,
+                    observation: { status: 'resolved', value },
+                    source
+                }));
+            }
+            catch (error) {
+                return createCompositeAssertionGroup(thrownMatcherChildren({
+                    kind: 'rejects',
+                    location,
+                    matcher,
+                    message,
+                    observation: { status: 'rejected', value: error },
+                    source
+                }));
+            }
+        },
+        startsWith(actual, expected) {
+            return { actual, check: 'starts-with', expected, location, message, source };
+        },
+        string(actual) {
+            return { actual, check: 'string', location, message, source };
+        },
+        throws(body, matcher) {
+            try {
+                const value = body();
+                return createCompositeAssertionGroup(thrownMatcherChildren({
+                    kind: 'throws',
+                    location,
+                    matcher,
+                    message,
+                    observation: { status: 'returned', value },
+                    source
+                }));
+            }
+            catch (error) {
+                return createCompositeAssertionGroup(thrownMatcherChildren({
+                    kind: 'throws',
+                    location,
+                    matcher,
+                    message,
+                    observation: { status: 'threw', value: error },
+                    source
+                }));
+            }
+        },
+        true(actual) {
+            return { actual, check: 'true', location, message, source };
+        },
+        undefined(actual) {
+            return { actual, check: 'undefined', location, message, source };
+        }
+    };
+}
+export function defineCompositeAssertion(definition) {
+    return createAssertionReferenceRecord({
+        formatSummary: definition.formatSummary ?? null,
+        kind: 'composite',
+        name: definition.name,
+        run(input) {
+            return definition.assert(createCompositeCheckBuilder(input.source, input.message, input.location), ...input.parameters);
+        }
+    });
+}
+export function defineNarrowingCompositeAssertion(definition) {
+    return createAssertionReferenceRecord({
+        formatSummary: definition.formatSummary ?? null,
+        kind: 'narrowing-composite',
+        name: definition.name,
+        narrows: definition.narrows
+    });
+}
+//# sourceMappingURL=assertion-extension.js.map

package/assert/assertion-extension.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"assertion-extension.js","sourceRoot":"","sources":["../../../../source/assert/assertion-extension.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,7 +1,34 @@
 {
-  "name": "@overkill-dev/assert",
-  "version": "0.0.1",
-  "description": "Placeholder claiming the npm package name \"@overkill-dev/assert\" so a trusted publisher can be configured. See https://github.com/npm/cli/issues/8544.",
-  "license": "MIT",
-  "deprecated": "Placeholder published as a workaround so a Trusted Publisher could be configured. See https://github.com/npm/cli/issues/8544."
-}
+    "author": "Christian Rackerseder <git@echooff.de>",
+    "bugs": {
+        "url": "https://github.com/enormora/overkill/issues"
+    },
+    "description": "Reusable Overkill assertion-extension helpers.",
+    "engines": {
+        "node": "^26"
+    },
+    "exports": {
+        ".": {
+            "import": "./packages/assert/assert.entry-point.js",
+            "types": "./packages/assert/assert.entry-point.d.ts"
+        }
+    },
+    "homepage": "https://github.com/enormora/overkill#readme",
+    "keywords": [
+        "tdd",
+        "test",
+        "tests"
+    ],
+    "license": "MIT",
+    "name": "@overkill-dev/assert",
+    "peerDependencies": {
+        "@overkill-dev/engine": "0.0.3"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/enormora/overkill.git"
+    },
+    "sideEffects": false,
+    "type": "module",
+    "version": "0.0.3"
+}

package/packages/assert/assert.entry-point.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export { defineCompositeAssertion, defineNarrowingCompositeAssertion } from '../../assert/assertion-extension.ts';
+export type { CompositeAssertionDefinition, CompositeCheckBuilder, NarrowingCompositeAssertionDefinition } from '../../assert/assertion-extension.ts';
+export type { AssertReferenceArguments, AssertReferenceReturn, CompositeAssertionGroup, CompositeAssertionReference, CompositeAssertionReturn, CompositeAssertionSummaryContext, NarrowingCompositeAssertionReference } from '@overkill-dev/engine/packages/engine/assertion-protocol.entry-point.js';
+export type { AssertionSource, DeepComparable, ErrorMatcher, ExactThrownMatcher, NonEmptyReadonlyArray, SynchronousCallback, ThrownMatcher } from '@overkill-dev/engine/packages/engine/assertion-protocol.entry-point.js';
+//# sourceMappingURL=assert.entry-point.d.ts.map

package/packages/assert/assert.entry-point.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"assert.entry-point.d.ts","sourceRoot":"","sources":["../../../../../source/packages/assert/assert.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,wBAAwB,EACxB,iCAAiC,EACpC,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACR,4BAA4B,EAC5B,qBAAqB,EACrB,qCAAqC,EACxC,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACR,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,gCAAgC,EAChC,oCAAoC,EACvC,MAAM,6CAA6C,CAAC;AACrD,YAAY,EACR,eAAe,EACf,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EAChB,MAAM,6CAA6C,CAAC"}

package/packages/assert/assert.entry-point.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export { defineCompositeAssertion, defineNarrowingCompositeAssertion } from "../../assert/assertion-extension.js";
2	+ //# sourceMappingURL=assert.entry-point.js.map

package/packages/assert/assert.entry-point.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"assert.entry-point.js","sourceRoot":"","sources":["../../../../../source/packages/assert/assert.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,wBAAwB,EACxB,iCAAiC,EACpC,MAAM,qCAAqC,CAAC"}

package/readme.md CHANGED Viewed

@@ -1,7 +1,56 @@
-# @overkill-dev/assert
+# `@overkill-dev/assert`
-This version is a placeholder published only to claim the npm name `@overkill-dev/assert` so a Trusted Publisher
-can subsequently be configured for it. It contains no real package content and is published already
-deprecated.
+Reusable assertion-extension helpers for Overkill.
-Workaround context: https://github.com/npm/cli/issues/8544
+Top-level API:
+- `defineCompositeAssertion(options)`
+- `defineNarrowingCompositeAssertion(options)`
+- `CompositeCheckBuilder`
+- `CompositeAssertionReference`
+- `NarrowingCompositeAssertionReference`
+- `CompositeAssertionReturn`
+- `AssertReferenceArguments`
+- `AssertReferenceReturn`
+- `ThrownMatcher`, `ErrorMatcher`, `ExactThrownMatcher`
+Composite assertions are imported reference values:
+```ts
+import { defineCompositeAssertion } from '@overkill-dev/assert';
+export const resultValueDeepEqual = defineCompositeAssertion({
+    name: 'resultValueDeepEqual',
+    assert(check, result: { readonly ok: boolean; readonly value: unknown; }, expected: unknown) {
+        return check.group([
+            check.annotated('ok flag').true(result.ok),
+            check.annotated('value').deepEqual(result.value, expected)
+        ]);
+    }
+});
+```
+Tests pass references to the engine-owned assertion facade:
+```ts
+scope.assert(resultValueDeepEqual, result, expected);
+```
+`defineNarrowingCompositeAssertion(...)` creates synchronous references accepted by both `scope.assert(...)` and `scope.require(...)`.
+Foreign throwable-style assertions can be bridged inside a composite assertion:
+```ts
+export const hasDomainInvariant = defineCompositeAssertion({
+    name: 'hasDomainInvariant',
+    assert(check, value: unknown) {
+        return check.fromThrowable('domain.assertInvariant', () => {
+            assertDomainInvariant(value);
+        });
+    }
+});
+```
+Each composite reference records one assertion boundary. Child checks created through `check.*` are grouped diagnostics, not extra plan units.

package/sbom.cdx.json ADDED Viewed

@@ -0,0 +1,50 @@
+{
+    "$schema": "http://cyclonedx.org/schema/bom-1.6.schema.json",
+    "bomFormat": "CycloneDX",
+    "specVersion": "1.6",
+    "version": 1,
+    "metadata": {
+        "tools": {
+            "components": [
+                {
+                    "type": "application",
+                    "name": "packtory",
+                    "version": "0.0.78"
+                }
+            ]
+        },
+        "component": {
+            "type": "library",
+            "name": "@overkill-dev/assert",
+            "version": "0.0.3",
+            "bom-ref": "pkg:npm/@overkill-dev/assert@0.0.3",
+            "purl": "pkg:npm/@overkill-dev/assert@0.0.3"
+        }
+    },
+    "components": [
+        {
+            "type": "library",
+            "name": "@overkill-dev/engine",
+            "version": "0.0.3",
+            "bom-ref": "pkg:npm/@overkill-dev/engine@0.0.3",
+            "scope": "optional",
+            "licenses": [
+                {
+                    "expression": "MIT"
+                }
+            ],
+            "purl": "pkg:npm/@overkill-dev/engine@0.0.3"
+        }
+    ],
+    "dependencies": [
+        {
+            "ref": "pkg:npm/@overkill-dev/assert@0.0.3",
+            "dependsOn": [
+                "pkg:npm/@overkill-dev/engine@0.0.3"
+            ]
+        },
+        {
+            "ref": "pkg:npm/@overkill-dev/engine@0.0.3"
+        }
+    ]
+}