bupkis 0.18.2 → 1.0.0

package/dist/assertion/slotify.js

@@ -0,0 +1,161 @@
+/**
+ * Provides {@link slotify}, which converts {@link AssertionParts} (phrases, Zod
+ * schemas) into {@link AssertionSlots} (Zod schemas only).
+ *
+ * `AssertionSlots` are used to match assertions against arguments to
+ * `expect()`.
+ *
+ * @packageDocumentation
+ */
+import { inspect } from 'util';
+import { z } from 'zod';
+import { kStringLiteral } from "../constant.js";
+import { AssertionImplementationError } from "../error.js";
+import { isPhrase, isPhraseLiteral, isPhraseLiteralChoice, isStandardSchema, isZodType, } from "../guards.js";
+import { BupkisRegistry } from "../metadata.js";
+/**
+ * This cache saves previously-computed _slotifications_ to speed up
+ * `createAssertion`/`createAsyncAssertion`. While these are unlikely to be
+ * called repeatedly with the same values, it's still extra work that doesn't
+ * need to be done more than once.
+ */
+const slotifyCache = new WeakMap();
+/**
+ * Cache for phrase literal schemas to avoid recreating identical Zod schemas.
+ * This significantly reduces the "Definition (core.js)" overhead seen in flame
+ * graphs since phrase literals like 'to be a string' are reused across many
+ * assertions.
+ */
+const phraseLiteralSchemaCache = new Map();
+/**
+ * Cache for phrase literal choice schemas to avoid recreating identical Zod
+ * schemas. This optimizes cases where multiple phrase options like ['to be a',
+ * 'to be an'] are reused across different assertions.
+ */
+const phraseLiteralChoiceSchemaCache = new Map();
+/**
+ * Builds slots out of assertion parts.
+ *
+ * @remarks
+ * This function converts {@link AssertionParts} into {@link AssertionSlots} by
+ * processing string literals and Zod schemas, registering metadata for runtime
+ * introspection, and handling validation constraints such as preventing "not "
+ * prefixes in string literal parts.
+ * @function
+ * @param parts Assertion parts
+ * @returns Slots
+ * @internal
+ */
+export const slotify = (parts) => {
+    if (slotifyCache.has(parts)) {
+        // Safe cast: cache key is the exact same `parts` reference
+        return slotifyCache.get(parts);
+    }
+    const slots = parts.flatMap((part, index) => {
+        const result = [];
+        if (index === 0 && isPhrase(part)) {
+            result.push(z.unknown().meta({ description: 'subject' }));
+        }
+        if (isPhraseLiteralChoice(part)) {
+            if (part.some((p) => p.startsWith('not '))) {
+                throw new AssertionImplementationError(`PhraseLiteralChoice at parts[${index}] must not include phrases starting with "not "; refactor to be a positive assertion: ${inspect(part)}`);
+            }
+            result.push(createPhraseLiteralChoiceSchema(part));
+        }
+        else if (isPhraseLiteral(part)) {
+            if (part.startsWith('not ')) {
+                throw new AssertionImplementationError(`PhraseLiteral at parts[${index}] must not start with "not "; refactor to be a positive assertion: ${inspect(part)}`);
+            }
+            result.push(createPhraseLiteralSchema(part));
+        }
+        else if (typeof part === 'string' && part === 'and') {
+            // Special case: "and" is allowed when followed by a schema (Zod or Standard Schema)
+            const nextPart = parts[index + 1];
+            if (index + 1 >= parts.length ||
+                !(isZodType(nextPart) || isStandardSchema(nextPart))) {
+                throw new AssertionImplementationError(`"and" at parts[${index}] must be followed by a schema but was followed by ${index + 1 >= parts.length
+                    ? 'nothing'
+                    : `${inspect(nextPart)} (${typeof nextPart})`}`);
+            }
+            result.push(createPhraseLiteralSchema(part));
+        }
+        else {
+            // Schema parts: either Zod or Standard Schema
+            if (isZodType(part)) {
+                result.push(part);
+            }
+            else if (isStandardSchema(part)) {
+                // Convert Standard Schema to Zod schema for slotification
+                // Slots use Zod's safeParse, so we need a Zod wrapper
+                const zodWrapper = z.custom((value) => {
+                    const validationResult = part['~standard'].validate(value);
+                    // Must be synchronous for slots
+                    if (validationResult instanceof Promise) {
+                        return false;
+                    }
+                    return !validationResult.issues;
+                }, { error: `Failed Standard Schema validation` });
+                result.push(zodWrapper);
+            }
+            else {
+                throw new AssertionImplementationError(`Expected schema, phrase literal, or phrase literal choice at parts[${index}] but received ${inspect(part)} (${typeof part})`);
+            }
+        }
+        return result;
+    });
+    slotifyCache.set(parts, slots);
+    return slots;
+};
+/**
+ * Creates a schema for a choice of phrase literals
+ *
+ * This schema is a branded literal schema to differentiate regular strings from
+ * phrases.
+ *
+ * @function
+ * @param part Phrase literal choice (tuple of strings)
+ * @returns Schema
+ */
+const createPhraseLiteralChoiceSchema = (part) => {
+    // Check cache first to avoid recreating identical schemas
+    if (phraseLiteralChoiceSchemaCache.has(part)) {
+        return phraseLiteralChoiceSchemaCache.get(part);
+    }
+    const schema = z
+        .literal(part)
+        .brand('string-literal')
+        .register(BupkisRegistry, {
+        [kStringLiteral]: true,
+        values: part,
+    });
+    // Cache the schema for future use
+    phraseLiteralChoiceSchemaCache.set(part, schema);
+    return schema;
+};
+/**
+ * Creates a schema for a single phrase literal
+ *
+ * This schema is a branded literal schema to differentiate regular strings from
+ * phrases.
+ *
+ * @function
+ * @param part Phrase literal (string)
+ * @returns Schema
+ */
+const createPhraseLiteralSchema = (part) => {
+    // Check cache first to avoid recreating identical schemas
+    if (phraseLiteralSchemaCache.has(part)) {
+        return phraseLiteralSchemaCache.get(part);
+    }
+    const schema = z
+        .literal(part)
+        .brand('string-literal')
+        .register(BupkisRegistry, {
+        [kStringLiteral]: true,
+        value: part,
+    });
+    // Cache the schema for future use
+    phraseLiteralSchemaCache.set(part, schema);
+    return schema;
+};
+//# sourceMappingURL=slotify.js.map

package/dist/assertion/slotify.js.map

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

package/dist/bootstrap.cjs

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Factory function for creating the main assertion functions.
+ *
+ * This module provides the {@link bootstrap} function that creates both
+ * synchronous and asynchronous assertion engines.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expectAsync = exports.expect = void 0;
+const index_js_1 = require("./assertion/index.cjs");
+const use_js_1 = require("./use.cjs");
+/**
+ * Factory function that creates both synchronous and asynchronous assertion
+ * engines.
+ *
+ * @function
+ * @returns Object containing {@link expect} and {@link expectAsync} functions
+ * @internal
+ */
+const bootstrap = () => {
+    const { expect, expectAsync } = (0, use_js_1.createUse)(index_js_1.SyncAssertions, index_js_1.AsyncAssertions)([...index_js_1.SyncAssertions, ...index_js_1.AsyncAssertions]);
+    return { expect, expectAsync };
+};
+const api = bootstrap();
+/**
+ * The main synchronous assertion function which can execute only built-in
+ * assertions.
+ *
+ * @function
+ * @group Core API
+ */
+exports.expect = api.expect;
+/**
+ * The main asynchronous assertion function which can execute only built-in
+ * assertions.
+ *
+ * @function
+ * @group Core API
+ */
+exports.expectAsync = api.expectAsync;
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,oDAAuE;AAEvE,sCAAqC;AAErC;;;;;;;GAOG;AACH,MAAM,SAAS,GAAG,GAGhB,EAAE;IACF,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,kBAAS,EACvC,yBAAc,EACd,0BAAe,CAChB,CAAC,CAAC,GAAG,yBAAc,EAAE,GAAG,0BAAe,CAAC,CAAC,CAAC;IAE3C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;AAExB;;;;;;GAMG;AACU,QAAA,MAAM,GAAkC,GAAG,CAAC,MAAM,CAAC;AAEhE;;;;;;GAMG;AACU,QAAA,WAAW,GAAwC,GAAG,CAAC,WAAW,CAAC"}

package/dist/bootstrap.d.cts

@@ -0,0 +1,27 @@
+/**
+ * Factory function for creating the main assertion functions.
+ *
+ * This module provides the {@link bootstrap} function that creates both
+ * synchronous and asynchronous assertion engines.
+ *
+ * @packageDocumentation
+ */
+import { AsyncAssertions, SyncAssertions } from "./assertion/index.cjs";
+import { type Expect, type ExpectAsync } from "./types.cjs";
+/**
+ * The main synchronous assertion function which can execute only built-in
+ * assertions.
+ *
+ * @function
+ * @group Core API
+ */
+export declare const expect: Expect<typeof SyncAssertions>;
+/**
+ * The main asynchronous assertion function which can execute only built-in
+ * assertions.
+ *
+ * @function
+ * @group Core API
+ */
+export declare const expectAsync: ExpectAsync<typeof AsyncAssertions>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,8BAA6B;AACvE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,oBAAmB;AAyB3D;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,OAAO,cAAc,CAAc,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,OAAO,eAAe,CAAmB,CAAC"}

package/dist/bootstrap.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Factory function for creating the main assertion functions.
+ *
+ * This module provides the {@link bootstrap} function that creates both
+ * synchronous and asynchronous assertion engines.
+ *
+ * @packageDocumentation
+ */
+import { AsyncAssertions, SyncAssertions } from "./assertion/index.js";
+import { type Expect, type ExpectAsync } from "./types.js";
+/**
+ * The main synchronous assertion function which can execute only built-in
+ * assertions.
+ *
+ * @function
+ * @group Core API
+ */
+export declare const expect: Expect<typeof SyncAssertions>;
+/**
+ * The main asynchronous assertion function which can execute only built-in
+ * assertions.
+ *
+ * @function
+ * @group Core API
+ */
+export declare const expectAsync: ExpectAsync<typeof AsyncAssertions>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,6BAA6B;AACvE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,mBAAmB;AAyB3D;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,OAAO,cAAc,CAAc,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,OAAO,eAAe,CAAmB,CAAC"}

package/dist/bootstrap.js

@@ -0,0 +1,40 @@
+/**
+ * Factory function for creating the main assertion functions.
+ *
+ * This module provides the {@link bootstrap} function that creates both
+ * synchronous and asynchronous assertion engines.
+ *
+ * @packageDocumentation
+ */
+import { AsyncAssertions, SyncAssertions } from "./assertion/index.js";
+import { createUse } from "./use.js";
+/**
+ * Factory function that creates both synchronous and asynchronous assertion
+ * engines.
+ *
+ * @function
+ * @returns Object containing {@link expect} and {@link expectAsync} functions
+ * @internal
+ */
+const bootstrap = () => {
+    const { expect, expectAsync } = createUse(SyncAssertions, AsyncAssertions)([...SyncAssertions, ...AsyncAssertions]);
+    return { expect, expectAsync };
+};
+const api = bootstrap();
+/**
+ * The main synchronous assertion function which can execute only built-in
+ * assertions.
+ *
+ * @function
+ * @group Core API
+ */
+export const expect = api.expect;
+/**
+ * The main asynchronous assertion function which can execute only built-in
+ * assertions.
+ *
+ * @function
+ * @group Core API
+ */
+export const expectAsync = api.expectAsync;
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,6BAA6B;AAEvE,OAAO,EAAE,SAAS,EAAE,iBAAiB;AAErC;;;;;;;GAOG;AACH,MAAM,SAAS,GAAG,GAGhB,EAAE;IACF,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CACvC,cAAc,EACd,eAAe,CAChB,CAAC,CAAC,GAAG,cAAc,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC;IAE3C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAkC,GAAG,CAAC,MAAM,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAwC,GAAG,CAAC,WAAW,CAAC"}

package/dist/constant.cjs

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Shared constants and symbols used throughout the library.
+ *
+ * This module defines unique symbols and constants that are used internally for
+ * marking and identifying special values and types within the assertion
+ * system.
+ *
+ * @packageDocumentation
+ * @internal
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DAY_NAMES = exports.FAIL = exports.kBupkisError = exports.KEYPATH_REGEX = exports.kExpectIt = exports.kBupkisNegatedAssertionError = exports.kBupkisFailAssertionError = exports.kBupkisAssertionError = exports.kStringLiteral = void 0;
+const { freeze } = Object;
+const { for: symbolFor } = Symbol;
+/**
+ * Symbol flagging the value as a Bupkis-created string literal, which will be
+ * omitted from the parameters to an `AssertionImpl`.
+ */
+exports.kStringLiteral = symbolFor('bupkis-string-literal');
+/**
+ * Symbol used to flag an `AssertionError` as our own.
+ *
+ * Uses `symbolFor()` to ensure the symbol is shared across module instances,
+ * which is important in monorepo setups where the same package may be loaded
+ * from different paths.
+ */
+exports.kBupkisAssertionError = symbolFor('bupkis-assertion-error');
+/**
+ * Symbol used to flag a `FailAssertionError`
+ */
+exports.kBupkisFailAssertionError = symbolFor('bupkis-fail-assertion-error');
+/**
+ * Symbol used to flag a `NegatedAssertionError`
+ */
+exports.kBupkisNegatedAssertionError = symbolFor('bupkis-negated-assertion-error');
+/**
+ * Symbol used to flag a function as an `expect.it` executor.
+ */
+exports.kExpectIt = symbolFor('bupkis-expect-it');
+/**
+ * Regular expression that matches valid keypath syntax.
+ *
+ * Matches patterns like:
+ *
+ * - Simple identifiers: `foo`
+ * - Dot notation: `foo.bar`, `foo.bar.baz`
+ * - Bracket notation with numbers: `foo[0]`, `bar[123]`
+ * - Bracket notation with quoted strings: `foo["key"]`, `bar['prop']`
+ * - Mixed notation: `foo.bar[0].baz`, `obj[0]["key"].prop`
+ *
+ * The regex breaks down as:
+ *
+ * - `^[a-zA-Z_$][a-zA-Z0-9_$]*` - Valid identifier start
+ * - `(?:` - Non-capturing group for additional segments
+ *
+ *   - `\.` - Dot followed by identifier
+ *   - `|` - OR
+ *   - `\[(?:\d+|"[^"]*"|'[^']*')\]` - Bracket notation (number or quoted string)
+ * - `)*$` - Zero or more additional segments, end of string
+ *
+ * @public
+ */
+exports.KEYPATH_REGEX = /^[a-zA-Z_$][-a-zA-Z0-9_$]*(?:(?:\.[a-zA-Z_$][-a-zA-Z0-9_$]*)|(?:\[(?:\d+|"[^"]*"|'[^']*')\]))*$/;
+/**
+ * Symbol used to flag a function as a Bupkis-thrown error.
+ */
+exports.kBupkisError = symbolFor('bupkis-error');
+/**
+ * Assertion ID of a `FailAssertionError`.
+ */
+exports.FAIL = 'FAIL';
+exports.DAY_NAMES = freeze([
+    'Sunday',
+    'Monday',
+    'Tuesday',
+    'Wednesday',
+    'Thursday',
+    'Friday',
+    'Saturday',
+]);
+//# sourceMappingURL=constant.js.map

package/dist/constant.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../src/constant.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;AAC1B,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;AAElC;;;GAGG;AAEU,QAAA,cAAc,GAAW,SAAS,CAAC,uBAAuB,CAAC,CAAC;AAEzE;;;;;;GAMG;AAEU,QAAA,qBAAqB,GAAW,SAAS,CACpD,wBAAwB,CACzB,CAAC;AAEF;;GAEG;AACU,QAAA,yBAAyB,GAAW,SAAS,CACxD,6BAA6B,CAC9B,CAAC;AAEF;;GAEG;AAEU,QAAA,4BAA4B,GAAW,SAAS,CAC3D,gCAAgC,CACjC,CAAC;AAEF;;GAEG;AACU,QAAA,SAAS,GAAW,SAAS,CAAC,kBAAkB,CAAC,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEU,QAAA,aAAa,GACxB,iGAAiG,CAAC;AAEpG;;GAEG;AACU,QAAA,YAAY,GAAW,SAAS,CAAC,cAAc,CAAC,CAAC;AAE9D;;GAEG;AACU,QAAA,IAAI,GAAG,MAAe,CAAC;AAEvB,QAAA,SAAS,GAAG,MAAM,CAAC;IAC9B,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,WAAW;IACX,UAAU;IACV,QAAQ;IACR,UAAU;CACF,CAAC,CAAC"}

package/dist/constant.d.cts

@@ -0,0 +1,69 @@
+/**
+ * Shared constants and symbols used throughout the library.
+ *
+ * This module defines unique symbols and constants that are used internally for
+ * marking and identifying special values and types within the assertion
+ * system.
+ *
+ * @packageDocumentation
+ * @internal
+ */
+/**
+ * Symbol flagging the value as a Bupkis-created string literal, which will be
+ * omitted from the parameters to an `AssertionImpl`.
+ */
+export declare const kStringLiteral: symbol;
+/**
+ * Symbol used to flag an `AssertionError` as our own.
+ *
+ * Uses `symbolFor()` to ensure the symbol is shared across module instances,
+ * which is important in monorepo setups where the same package may be loaded
+ * from different paths.
+ */
+export declare const kBupkisAssertionError: symbol;
+/**
+ * Symbol used to flag a `FailAssertionError`
+ */
+export declare const kBupkisFailAssertionError: symbol;
+/**
+ * Symbol used to flag a `NegatedAssertionError`
+ */
+export declare const kBupkisNegatedAssertionError: symbol;
+/**
+ * Symbol used to flag a function as an `expect.it` executor.
+ */
+export declare const kExpectIt: symbol;
+/**
+ * Regular expression that matches valid keypath syntax.
+ *
+ * Matches patterns like:
+ *
+ * - Simple identifiers: `foo`
+ * - Dot notation: `foo.bar`, `foo.bar.baz`
+ * - Bracket notation with numbers: `foo[0]`, `bar[123]`
+ * - Bracket notation with quoted strings: `foo["key"]`, `bar['prop']`
+ * - Mixed notation: `foo.bar[0].baz`, `obj[0]["key"].prop`
+ *
+ * The regex breaks down as:
+ *
+ * - `^[a-zA-Z_$][a-zA-Z0-9_$]*` - Valid identifier start
+ * - `(?:` - Non-capturing group for additional segments
+ *
+ *   - `\.` - Dot followed by identifier
+ *   - `|` - OR
+ *   - `\[(?:\d+|"[^"]*"|'[^']*')\]` - Bracket notation (number or quoted string)
+ * - `)*$` - Zero or more additional segments, end of string
+ *
+ * @public
+ */
+export declare const KEYPATH_REGEX: RegExp;
+/**
+ * Symbol used to flag a function as a Bupkis-thrown error.
+ */
+export declare const kBupkisError: symbol;
+/**
+ * Assertion ID of a `FailAssertionError`.
+ */
+export declare const FAIL: "FAIL";
+export declare const DAY_NAMES: readonly ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+//# sourceMappingURL=constant.d.ts.map

package/dist/constant.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.d.ts","sourceRoot":"","sources":["../src/constant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;GAGG;AAEH,eAAO,MAAM,cAAc,EAAE,MAA2C,CAAC;AAEzE;;;;;;GAMG;AAEH,eAAO,MAAM,qBAAqB,EAAE,MAEnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAEvC,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,4BAA4B,EAAE,MAE1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAAsC,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,eAAO,MAAM,aAAa,QACyE,CAAC;AAEpG;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAkC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,IAAI,EAAG,MAAe,CAAC;AAEpC,eAAO,MAAM,SAAS,yFAQX,CAAC"}

package/dist/constant.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Shared constants and symbols used throughout the library.
+ *
+ * This module defines unique symbols and constants that are used internally for
+ * marking and identifying special values and types within the assertion
+ * system.
+ *
+ * @packageDocumentation
+ * @internal
+ */
+/**
+ * Symbol flagging the value as a Bupkis-created string literal, which will be
+ * omitted from the parameters to an `AssertionImpl`.
+ */
+export declare const kStringLiteral: symbol;
+/**
+ * Symbol used to flag an `AssertionError` as our own.
+ *
+ * Uses `symbolFor()` to ensure the symbol is shared across module instances,
+ * which is important in monorepo setups where the same package may be loaded
+ * from different paths.
+ */
+export declare const kBupkisAssertionError: symbol;
+/**
+ * Symbol used to flag a `FailAssertionError`
+ */
+export declare const kBupkisFailAssertionError: symbol;
+/**
+ * Symbol used to flag a `NegatedAssertionError`
+ */
+export declare const kBupkisNegatedAssertionError: symbol;
+/**
+ * Symbol used to flag a function as an `expect.it` executor.
+ */
+export declare const kExpectIt: symbol;
+/**
+ * Regular expression that matches valid keypath syntax.
+ *
+ * Matches patterns like:
+ *
+ * - Simple identifiers: `foo`
+ * - Dot notation: `foo.bar`, `foo.bar.baz`
+ * - Bracket notation with numbers: `foo[0]`, `bar[123]`
+ * - Bracket notation with quoted strings: `foo["key"]`, `bar['prop']`
+ * - Mixed notation: `foo.bar[0].baz`, `obj[0]["key"].prop`
+ *
+ * The regex breaks down as:
+ *
+ * - `^[a-zA-Z_$][a-zA-Z0-9_$]*` - Valid identifier start
+ * - `(?:` - Non-capturing group for additional segments
+ *
+ *   - `\.` - Dot followed by identifier
+ *   - `|` - OR
+ *   - `\[(?:\d+|"[^"]*"|'[^']*')\]` - Bracket notation (number or quoted string)
+ * - `)*$` - Zero or more additional segments, end of string
+ *
+ * @public
+ */
+export declare const KEYPATH_REGEX: RegExp;
+/**
+ * Symbol used to flag a function as a Bupkis-thrown error.
+ */
+export declare const kBupkisError: symbol;
+/**
+ * Assertion ID of a `FailAssertionError`.
+ */
+export declare const FAIL: "FAIL";
+export declare const DAY_NAMES: readonly ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+//# sourceMappingURL=constant.d.ts.map

package/dist/constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.d.ts","sourceRoot":"","sources":["../src/constant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;GAGG;AAEH,eAAO,MAAM,cAAc,EAAE,MAA2C,CAAC;AAEzE;;;;;;GAMG;AAEH,eAAO,MAAM,qBAAqB,EAAE,MAEnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAEvC,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,4BAA4B,EAAE,MAE1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAAsC,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,eAAO,MAAM,aAAa,QACyE,CAAC;AAEpG;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAkC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,IAAI,EAAG,MAAe,CAAC;AAEpC,eAAO,MAAM,SAAS,yFAQX,CAAC"}

package/dist/constant.js

@@ -0,0 +1,79 @@
+/**
+ * Shared constants and symbols used throughout the library.
+ *
+ * This module defines unique symbols and constants that are used internally for
+ * marking and identifying special values and types within the assertion
+ * system.
+ *
+ * @packageDocumentation
+ * @internal
+ */
+const { freeze } = Object;
+const { for: symbolFor } = Symbol;
+/**
+ * Symbol flagging the value as a Bupkis-created string literal, which will be
+ * omitted from the parameters to an `AssertionImpl`.
+ */
+export const kStringLiteral = symbolFor('bupkis-string-literal');
+/**
+ * Symbol used to flag an `AssertionError` as our own.
+ *
+ * Uses `symbolFor()` to ensure the symbol is shared across module instances,
+ * which is important in monorepo setups where the same package may be loaded
+ * from different paths.
+ */
+export const kBupkisAssertionError = symbolFor('bupkis-assertion-error');
+/**
+ * Symbol used to flag a `FailAssertionError`
+ */
+export const kBupkisFailAssertionError = symbolFor('bupkis-fail-assertion-error');
+/**
+ * Symbol used to flag a `NegatedAssertionError`
+ */
+export const kBupkisNegatedAssertionError = symbolFor('bupkis-negated-assertion-error');
+/**
+ * Symbol used to flag a function as an `expect.it` executor.
+ */
+export const kExpectIt = symbolFor('bupkis-expect-it');
+/**
+ * Regular expression that matches valid keypath syntax.
+ *
+ * Matches patterns like:
+ *
+ * - Simple identifiers: `foo`
+ * - Dot notation: `foo.bar`, `foo.bar.baz`
+ * - Bracket notation with numbers: `foo[0]`, `bar[123]`
+ * - Bracket notation with quoted strings: `foo["key"]`, `bar['prop']`
+ * - Mixed notation: `foo.bar[0].baz`, `obj[0]["key"].prop`
+ *
+ * The regex breaks down as:
+ *
+ * - `^[a-zA-Z_$][a-zA-Z0-9_$]*` - Valid identifier start
+ * - `(?:` - Non-capturing group for additional segments
+ *
+ *   - `\.` - Dot followed by identifier
+ *   - `|` - OR
+ *   - `\[(?:\d+|"[^"]*"|'[^']*')\]` - Bracket notation (number or quoted string)
+ * - `)*$` - Zero or more additional segments, end of string
+ *
+ * @public
+ */
+export const KEYPATH_REGEX = /^[a-zA-Z_$][-a-zA-Z0-9_$]*(?:(?:\.[a-zA-Z_$][-a-zA-Z0-9_$]*)|(?:\[(?:\d+|"[^"]*"|'[^']*')\]))*$/;
+/**
+ * Symbol used to flag a function as a Bupkis-thrown error.
+ */
+export const kBupkisError = symbolFor('bupkis-error');
+/**
+ * Assertion ID of a `FailAssertionError`.
+ */
+export const FAIL = 'FAIL';
+export const DAY_NAMES = freeze([
+    'Sunday',
+    'Monday',
+    'Tuesday',
+    'Wednesday',
+    'Thursday',
+    'Friday',
+    'Saturday',
+]);
+//# sourceMappingURL=constant.js.map

package/dist/constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../src/constant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;AAC1B,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;AAElC;;;GAGG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAW,SAAS,CAAC,uBAAuB,CAAC,CAAC;AAEzE;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAW,SAAS,CACpD,wBAAwB,CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAW,SAAS,CACxD,6BAA6B,CAC9B,CAAC;AAEF;;GAEG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAW,SAAS,CAC3D,gCAAgC,CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAW,SAAS,CAAC,kBAAkB,CAAC,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,CAAC,MAAM,aAAa,GACxB,iGAAiG,CAAC;AAEpG;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAW,SAAS,CAAC,cAAc,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,MAAe,CAAC;AAEpC,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC;IAC9B,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,WAAW;IACX,UAAU;IACV,QAAQ;IACR,UAAU;CACF,CAAC,CAAC"}