@dereekb/util 13.11.18 → 13.12.1

package/eslint/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util/eslint",
-  "version": "13.11.18",
+  "version": "13.12.1",
   "peerDependencies": {
     "@typescript-eslint/utils": "8.59.3"
   },

package/eslint/src/lib/dbx-tag-families.d.ts

@@ -1,6 +1,6 @@
 /**
  * Shared helpers for the `@dbx<Family>` companion-tag ESLint rules. Mirrors the
- * scanner schemas in `packages/dbx-components-mcp/src/scan/*-extract.ts` so
+ * scanner schemas in `packages/dbx-cli/src/lib/mcp-scan/scan/*-extract.ts` so
  * violations surface at lint time instead of at manifest-regeneration time.
  *
  * Each per-family rule supplies a {@link DbxTagFamilySpec} describing which

package/eslint/src/lib/index.d.ts

@@ -16,10 +16,12 @@ export { UTIL_REQUIRE_DBX_DOCS_UI_EXAMPLE_COMPANION_TAGS_RULE, type UtilRequireD
 export { UTIL_REQUIRE_DBX_MODEL_SNAPSHOT_FIELD_COMPANION_TAGS_RULE, type UtilRequireDbxModelSnapshotFieldCompanionTagsRuleOptions, type UtilRequireDbxModelSnapshotFieldCompanionTagsRuleDefinition } from './require-dbx-model-snapshot-field-companion-tags.rule';
 export { UTIL_REQUIRE_DBX_ACTION_COMPANION_TAGS_RULE, type UtilRequireDbxActionCompanionTagsRuleOptions, type UtilRequireDbxActionCompanionTagsRuleDefinition } from './require-dbx-action-companion-tags.rule';
 export { UTIL_REQUIRE_DBX_FORM_FIELD_COMPANION_TAGS_RULE, type UtilRequireDbxFormFieldCompanionTagsRuleOptions, type UtilRequireDbxFormFieldCompanionTagsRuleDefinition } from './require-dbx-form-field-companion-tags.rule';
-export { UTIL_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE, type UtilRequireDbxModelCompanionTagsRuleOptions, type UtilRequireDbxModelCompanionTagsRuleDefinition } from './require-dbx-model-companion-tags.rule';
 export { UTIL_REQUIRE_DBX_AUTH_COMPANION_TAGS_RULE, type UtilRequireDbxAuthCompanionTagsRuleOptions, type UtilRequireDbxAuthCompanionTagsRuleDefinition } from './require-dbx-auth-companion-tags.rule';
 export { UTIL_REQUIRE_DBX_RULE_COMPANION_TAGS_RULE, type UtilRequireDbxRuleCompanionTagsRuleOptions, type UtilRequireDbxRuleCompanionTagsRuleDefinition } from './require-dbx-rule-companion-tags.rule';
 export { UTIL_REQUIRE_CONSTANT_NAMING_RULE, type UtilRequireConstantNamingRuleOptions, type UtilRequireConstantNamingRuleDefinition } from './require-constant-naming.rule';
 export { UTIL_REQUIRE_DEFAULT_PREFIX_NAMING_RULE, type UtilRequireDefaultPrefixNamingRuleOptions, type UtilRequireDefaultPrefixNamingRuleDefinition } from './require-default-prefix-naming.rule';
 export { UTIL_REQUIRE_EXPORTED_JSDOC_EXAMPLE_RULE, type UtilRequireExportedJsdocExampleRuleOptions, type UtilRequireExportedJsdocExampleRuleDefinition } from './require-exported-jsdoc-example.rule';
 export { UTIL_ESLINT_PLUGIN, utilESLintPlugin, type UtilEslintPlugin } from './plugin';
+export { getStatementAnchor, leadingJsdocFor } from './comments';
+export { parseJsdocComment, type ParsedJsdoc, type ParsedJsdocTag, type ParsedJsdocLine } from './jsdoc-parser';
+export { buildLowercaseTagsFix, checkDbxTagFamily, findFamilyTags, parseBooleanTagValue, reportOnJsdocLine, type DbxCompanionTagSpec, type DbxTagFamilySpec } from './dbx-tag-families';

package/eslint/src/lib/plugin.d.ts

@@ -16,7 +16,6 @@ import { type UtilRequireDbxDocsUiExampleCompanionTagsRuleDefinition } from './r
 import { type UtilRequireDbxModelSnapshotFieldCompanionTagsRuleDefinition } from './require-dbx-model-snapshot-field-companion-tags.rule';
 import { type UtilRequireDbxActionCompanionTagsRuleDefinition } from './require-dbx-action-companion-tags.rule';
 import { type UtilRequireDbxFormFieldCompanionTagsRuleDefinition } from './require-dbx-form-field-companion-tags.rule';
-import { type UtilRequireDbxModelCompanionTagsRuleDefinition } from './require-dbx-model-companion-tags.rule';
 import { type UtilRequireDbxAuthCompanionTagsRuleDefinition } from './require-dbx-auth-companion-tags.rule';
 import { type UtilRequireDbxRuleCompanionTagsRuleDefinition } from './require-dbx-rule-companion-tags.rule';
 import { type UtilRequireConstantNamingRuleDefinition } from './require-constant-naming.rule';
@@ -48,7 +47,6 @@ export interface UtilEslintPlugin {
         readonly 'require-dbx-model-snapshot-field-companion-tags': UtilRequireDbxModelSnapshotFieldCompanionTagsRuleDefinition;
         readonly 'require-dbx-action-companion-tags': UtilRequireDbxActionCompanionTagsRuleDefinition;
         readonly 'require-dbx-form-field-companion-tags': UtilRequireDbxFormFieldCompanionTagsRuleDefinition;
-        readonly 'require-dbx-model-companion-tags': UtilRequireDbxModelCompanionTagsRuleDefinition;
         readonly 'require-dbx-auth-companion-tags': UtilRequireDbxAuthCompanionTagsRuleDefinition;
         readonly 'require-dbx-rule-companion-tags': UtilRequireDbxRuleCompanionTagsRuleDefinition;
         readonly 'require-constant-naming': UtilRequireConstantNamingRuleDefinition;

package/eslint/src/lib/require-constant-naming.rule.d.ts

@@ -11,6 +11,17 @@ export interface UtilRequireConstantNamingRuleOptions {
      * Defaults to `@dbxAllowConstantName`.
      */
     readonly exemptJsdocTag?: string;
+    /**
+     * Type annotation identifier names whose `export const X: T = {...}` declarations are exempt
+     * from the rule.
+     *
+     * When the declarator's type annotation is a `TSTypeReference` whose identifier (or leftmost
+     * segment of a `TSQualifiedName`) is in this list, the constant is skipped regardless of casing.
+     *
+     * Defaults to {@link DEFAULT_EXEMPT_TYPE_ANNOTATIONS}. Pass an empty array to opt out of the
+     * defaults entirely (strict mode); pass a non-empty array to replace the defaults.
+     */
+    readonly exemptTypeAnnotations?: readonly string[];
 }
 /**
  * ESLint rule definition for require-constant-naming.
@@ -54,6 +65,12 @@ export interface UtilRequireConstantNamingRuleDefinition {
  * Use the exempt JSDoc tag (default `@dbxAllowConstantName`) to silence the rule on a specific
  * declaration when the heuristics get it wrong.
  *
+ * Framework-prescribed singleton types (UIRouter's `Ng2StateDeclaration`, Angular's
+ * `ApplicationConfig`, `Routes`, etc.) are exempt by default via the `exemptTypeAnnotations` option:
+ * any `export const X: T = {...}` whose type annotation is a `TSTypeReference` to one of those
+ * names is skipped regardless of casing. Pass `exemptTypeAnnotations: []` to opt out of the
+ * defaults, or pass a non-empty array to replace the default allowlist with a project-specific set.
+ *
  * Not auto-fixable: renaming an exported binding has cross-file impact that an autofix can't safely
  * propagate.
  *

package/eslint/src/lib/require-dbx-action-companion-tags.rule.d.ts

@@ -37,7 +37,7 @@ export interface UtilRequireDbxActionCompanionTagsRuleDefinition {
 }
 /**
  * ESLint rule enforcing `@dbxAction` companion tags. Mirrors the scanner
- * schema at `packages/dbx-components-mcp/src/scan/actions-extract.ts`. Class
+ * schema at `packages/dbx-cli/src/lib/mcp-scan/scan/actions-extract.ts`. Class
  * declarations carry the `@dbxAction` marker; enum declarations carry the
  * `@dbxActionStateEnum` marker, and `@dbxActionStateTransitionsFrom/To` are
  * valid on enum-member JSDocs.

package/eslint/src/lib/require-dbx-auth-companion-tags.rule.d.ts

@@ -35,7 +35,7 @@ export interface UtilRequireDbxAuthCompanionTagsRuleDefinition {
 }
 /**
  * ESLint rule enforcing the three `@dbxAuth*` marker families. Mirrors the
- * scanner schema at `packages/dbx-components-mcp/src/scan/auth-extract.ts`.
+ * scanner schema at `packages/dbx-cli/src/lib/mcp-scan/scan/auth-extract.ts`.
  *
  * - `@dbxAuthClaimsApp <slug>` on an interface / type alias.
  * - `@dbxAuthClaim` (bare) on a `PropertySignature` inside an interface.

package/eslint/src/lib/require-dbx-docs-ui-example-companion-tags.rule.d.ts

@@ -36,7 +36,7 @@ export interface UtilRequireDbxDocsUiExampleCompanionTagsRuleDefinition {
 }
 /**
  * ESLint rule enforcing `@dbxDocsUiExample` companion tags. Mirrors the
- * scanner schema at `packages/dbx-components-mcp/src/scan/dbx-docs-ui-examples-extract.ts`.
+ * scanner schema at `packages/dbx-cli/src/lib/mcp-scan/scan/dbx-docs-ui-examples-extract.ts`.
  */
 export declare const UTIL_REQUIRE_DBX_DOCS_UI_EXAMPLE_COMPANION_TAGS_RULE: UtilRequireDbxDocsUiExampleCompanionTagsRuleDefinition;
 export {};

package/eslint/src/lib/require-dbx-filter-companion-tags.rule.d.ts

@@ -35,7 +35,7 @@ export interface UtilRequireDbxFilterCompanionTagsRuleDefinition {
 }
 /**
  * ESLint rule enforcing `@dbxFilter` companion tags. Mirrors the scanner
- * schema at `packages/dbx-components-mcp/src/scan/filters-extract.ts`.
+ * schema at `packages/dbx-cli/src/lib/mcp-scan/scan/filters-extract.ts`.
  * Applies to classes (filter directives) and exported interfaces (filter
  * patterns); the scanner reads both as filter entries.
  */

package/eslint/src/lib/require-dbx-form-field-companion-tags.rule.d.ts

@@ -39,7 +39,7 @@ export interface UtilRequireDbxFormFieldCompanionTagsRuleDefinition {
 }
 /**
  * ESLint rule enforcing `@dbxFormField` companion tags. Mirrors the scanner
- * schema at `packages/dbx-components-mcp/src/scan/forge-fields-extract.ts`,
+ * schema at `packages/dbx-cli/src/lib/mcp-scan/scan/forge-fields-extract.ts`,
  * including the tier-conditional required-tag matrix.
  */
 export declare const UTIL_REQUIRE_DBX_FORM_FIELD_COMPANION_TAGS_RULE: UtilRequireDbxFormFieldCompanionTagsRuleDefinition;

package/eslint/src/lib/require-dbx-model-snapshot-field-companion-tags.rule.d.ts

@@ -38,7 +38,7 @@ export interface UtilRequireDbxModelSnapshotFieldCompanionTagsRuleDefinition {
 }
 /**
  * ESLint rule enforcing `@dbxModelSnapshotField` companion tags. Mirrors the
- * scanner schema at `packages/dbx-components-mcp/src/scan/model-snapshot-fields-extract.ts`.
+ * scanner schema at `packages/dbx-cli/src/lib/mcp-scan/scan/model-snapshot-fields-extract.ts`.
  */
 export declare const UTIL_REQUIRE_DBX_MODEL_SNAPSHOT_FIELD_COMPANION_TAGS_RULE: UtilRequireDbxModelSnapshotFieldCompanionTagsRuleDefinition;
 export {};

package/eslint/src/lib/require-dbx-pipe-companion-tags.rule.d.ts

@@ -36,7 +36,7 @@ export interface UtilRequireDbxPipeCompanionTagsRuleDefinition {
 }
 /**
  * ESLint rule enforcing `@dbxPipe` companion tags. Mirrors the scanner schema
- * at `packages/dbx-components-mcp/src/scan/pipes-extract.ts` so violations
+ * at `packages/dbx-cli/src/lib/mcp-scan/scan/pipes-extract.ts` so violations
  * surface at lint time instead of at manifest-regeneration time.
  */
 export declare const UTIL_REQUIRE_DBX_PIPE_COMPANION_TAGS_RULE: UtilRequireDbxPipeCompanionTagsRuleDefinition;

package/eslint/src/lib/require-dbx-util-companion-tags.rule.d.ts

@@ -55,7 +55,7 @@ export interface UtilRequireDbxUtilCompanionTagsRuleDefinition {
 /**
  * ESLint rule enforcing that exports tagged `@dbxUtil` carry the registry-required companion tags
  * with valid value formats. Mirrors the scanner schema at
- * `packages/dbx-components-mcp/src/scan/utils-extract.ts` so violations surface at lint time
+ * `packages/dbx-cli/src/lib/mcp-scan/scan/utils-extract.ts` so violations surface at lint time
  * instead of at manifest-regeneration time.
  *
  * Checks:

package/eslint/src/lib/require-dbx-web-companion-tags.rule.d.ts

@@ -37,7 +37,7 @@ export interface UtilRequireDbxWebCompanionTagsRuleDefinition {
 }
 /**
  * ESLint rule enforcing `@dbxWebComponent` companion tags. Mirrors the scanner
- * schema at `packages/dbx-components-mcp/src/scan/ui-components-extract.ts`.
+ * schema at `packages/dbx-cli/src/lib/mcp-scan/scan/ui-components-extract.ts`.
  */
 export declare const UTIL_REQUIRE_DBX_WEB_COMPANION_TAGS_RULE: UtilRequireDbxWebCompanionTagsRuleDefinition;
 export {};

package/eslint/src/lib/require-deprecated-alias-placement.rule.d.ts

@@ -47,23 +47,29 @@ interface RuleContext {
     readonly sourceCode: AstNode;
 }
 /**
- * ESLint rule requiring that exports carrying a `@deprecated` JSDoc tag live at the bottom of the
- * file under a `// COMPAT: Deprecated aliases` line comment, and that no non-deprecated exports
- * follow the marker. The rule mirrors the workspace's "Deprecated Alias Placement" convention so
- * that deprecated aliases stay segregated from current code and are easy to spot for removal.
+ * ESLint rule requiring that `@deprecated` *aliases* live at the bottom of the file under a
+ * `// COMPAT: Deprecated aliases` line comment, and that no non-deprecated exports follow the
+ * marker. The rule mirrors the workspace's "Deprecated Alias Placement" convention so that
+ * deprecated aliases stay segregated from current code and are easy to spot for removal.
+ *
+ * Only *relocatable* deprecated statements participate (see {@link computeMovableStatements}):
+ * type-only declarations (always runtime-safe to move) and runtime value aliases — a
+ * `VariableDeclaration` whose initializer references a non-deprecated binding — that are not
+ * referenced elsewhere in the file. Primary runtime definitions (literal-valued consts, functions,
+ * classes, enums) and any value still referenced by other code are left exactly where they are, so
+ * the autofix can never reorder a value below its uses (a use-before-declaration error).
  *
  * The rule reports at most one violation per concern (missing marker, alias above marker,
  * non-deprecated below marker) to keep editor noise manageable; once the first violation in a
  * category is fixed, re-linting will surface the next one.
  *
  * Autofix coverage:
- *   - `missingCompatMarker` — inserts `// COMPAT: Deprecated aliases` and consolidates all
- *     deprecated blocks at the bottom of the file. When the deprecated tail is already at the
- *     bottom of the file, only the marker line is inserted (no statements are moved). When
- *     deprecated exports are interleaved with non-deprecated ones, the autofix removes each
- *     deprecated block from its current location and re-emits them in source order at the bottom
- *     of the file under the marker.
- *   - `deprecatedAliasNotAtBottom` — moves the misplaced deprecated block from above the marker to
+ *   - `missingCompatMarker` — inserts `// COMPAT: Deprecated aliases` and consolidates all movable
+ *     blocks at the bottom of the file. When the movable tail is already at the bottom of the file,
+ *     only the marker line is inserted (no statements are moved). When movable aliases are
+ *     interleaved with other statements, the autofix removes each movable block from its current
+ *     location and re-emits them in source order at the bottom of the file under the marker.
+ *   - `deprecatedAliasNotAtBottom` — moves the misplaced movable block from above the marker to
  *     just after the marker. One block per pass; ESLint's autofix loop converges across multiple
  *     violations.
  *   - `nonDeprecatedAfterMarker` — moves the misplaced non-deprecated block from below the marker

package/fetch/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/fetch",
-  "version": "13.11.18",
+  "version": "13.12.1",
   "peerDependencies": {
-    "@dereekb/util": "13.11.18",
+    "@dereekb/util": "13.12.1",
     "make-error": "^1.3.6",
     "fast-content-type-parse": "^3.0.0"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util",
-  "version": "13.11.18",
+  "version": "13.12.1",
   "sideEffects": false,
   "exports": {
     "./test": {

package/test/index.cjs.js

@@ -1220,6 +1220,69 @@ function _ts_generator(thisArg, body) {
     }
     return promiseResult;
 }
+/**
+ * Invokes `fn` and returns the value it rejects with. Throws {@link UnexpectedSuccessFailureError}
+ * when `fn` resolves successfully.
+ *
+ * Use this when a test needs the thrown value in hand to assert on multiple of its properties
+ * (e.g. inspect a structured `details.code`). For "did it throw at all" checks, prefer
+ * {@link expectFail} or vitest's `await expect(fn()).rejects.toThrow(...)`.
+ *
+ * @param fn - Async function expected to reject.
+ * @returns The thrown value as `unknown`.
+ * @throws {UnexpectedSuccessFailureError} When `fn` resolves successfully.
+ *
+ * @example
+ * ```ts
+ * const error = await captureRejection(() => callResetPassword({ resetPassword: '000000' }));
+ * expect(error).toBeInstanceOf(HttpsError);
+ * expect((error as HttpsError).code).toBe('invalid-argument');
+ * ```
+ */ function captureRejection(fn) {
+    return _async_to_generator(function() {
+        var thrown, didThrow, e;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    didThrow = false;
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        3,
+                        ,
+                        4
+                    ]);
+                    return [
+                        4,
+                        fn()
+                    ];
+                case 2:
+                    _state.sent();
+                    return [
+                        3,
+                        4
+                    ];
+                case 3:
+                    e = _state.sent();
+                    thrown = e;
+                    didThrow = true;
+                    return [
+                        3,
+                        4
+                    ];
+                case 4:
+                    if (!didThrow) {
+                        failDueToSuccess();
+                    }
+                    return [
+                        2,
+                        thrown
+                    ];
+            }
+        });
+    })();
+}
 function expectSuccessfulFail(errorFn) {
     var handleError = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : EXPECT_ERROR_DEFAULT_HANDLER;
     var result;
@@ -1559,6 +1622,7 @@ exports.JestExpectedFailError = JestExpectedFailError;
 exports.JestUnexpectedSuccessFailureError = JestUnexpectedSuccessFailureError;
 exports.UnexpectedSuccessFailureError = UnexpectedSuccessFailureError;
 exports.callbackTest = callbackTest;
+exports.captureRejection = captureRejection;
 exports.expectFail = expectFail;
 exports.expectFailAssertErrorType = expectFailAssertErrorType;
 exports.expectSuccessfulFail = expectSuccessfulFail;

package/test/index.esm.js

@@ -1218,6 +1218,69 @@ function _ts_generator(thisArg, body) {
     }
     return promiseResult;
 }
+/**
+ * Invokes `fn` and returns the value it rejects with. Throws {@link UnexpectedSuccessFailureError}
+ * when `fn` resolves successfully.
+ *
+ * Use this when a test needs the thrown value in hand to assert on multiple of its properties
+ * (e.g. inspect a structured `details.code`). For "did it throw at all" checks, prefer
+ * {@link expectFail} or vitest's `await expect(fn()).rejects.toThrow(...)`.
+ *
+ * @param fn - Async function expected to reject.
+ * @returns The thrown value as `unknown`.
+ * @throws {UnexpectedSuccessFailureError} When `fn` resolves successfully.
+ *
+ * @example
+ * ```ts
+ * const error = await captureRejection(() => callResetPassword({ resetPassword: '000000' }));
+ * expect(error).toBeInstanceOf(HttpsError);
+ * expect((error as HttpsError).code).toBe('invalid-argument');
+ * ```
+ */ function captureRejection(fn) {
+    return _async_to_generator(function() {
+        var thrown, didThrow, e;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    didThrow = false;
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        3,
+                        ,
+                        4
+                    ]);
+                    return [
+                        4,
+                        fn()
+                    ];
+                case 2:
+                    _state.sent();
+                    return [
+                        3,
+                        4
+                    ];
+                case 3:
+                    e = _state.sent();
+                    thrown = e;
+                    didThrow = true;
+                    return [
+                        3,
+                        4
+                    ];
+                case 4:
+                    if (!didThrow) {
+                        failDueToSuccess();
+                    }
+                    return [
+                        2,
+                        thrown
+                    ];
+            }
+        });
+    })();
+}
 function expectSuccessfulFail(errorFn) {
     var handleError = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : EXPECT_ERROR_DEFAULT_HANDLER;
     var result;
@@ -1543,4 +1606,4 @@ function _is_native_reflect_construct() {
  * @deprecated Use useTestFunctionMapFixture from shared instead. This is kept for backwards compatibility.
  */ var useJestFunctionMapFixture = useTestFunctionMapFixture;
 
-export { AbstractChildJestTestContextFixture, AbstractChildTestContextFixture, AbstractJestTestContextFixture, AbstractTestContextFixture, AbstractWrappedFixture, AbstractWrappedFixtureWithInstance, EXPECT_ERROR_DEFAULT_HANDLER, ExpectedErrorOfSpecificTypeError, ExpectedFailError, JestExpectedErrorOfSpecificTypeError, JestExpectedFailError, JestUnexpectedSuccessFailureError, UnexpectedSuccessFailureError, callbackTest, expectFail, expectFailAssertErrorType, expectSuccessfulFail, failDueToSuccess, failDueToSuccessError, failSuccessfully, failSuccessfullyError, failTest, failWithDoneDueToSuccess, failWithJestDoneCallback, failWithTestDoneCallback, fakeDoneHandler, instanceWrapJestTestContextFactory, instanceWrapTestContextFactory, itShouldFail, jestExpectFailAssertErrorType, jestTestContextBuilder, shouldFail, testContextBuilder, testDoneCallbackRef, useJestContextFixture, useJestFunctionFixture, useJestFunctionMapFixture, useTestContextFixture, useTestFunctionFixture, useTestFunctionMapFixture, wrapJestTestContextFactory, wrapTestContextFactory };
+export { AbstractChildJestTestContextFixture, AbstractChildTestContextFixture, AbstractJestTestContextFixture, AbstractTestContextFixture, AbstractWrappedFixture, AbstractWrappedFixtureWithInstance, EXPECT_ERROR_DEFAULT_HANDLER, ExpectedErrorOfSpecificTypeError, ExpectedFailError, JestExpectedErrorOfSpecificTypeError, JestExpectedFailError, JestUnexpectedSuccessFailureError, UnexpectedSuccessFailureError, callbackTest, captureRejection, expectFail, expectFailAssertErrorType, expectSuccessfulFail, failDueToSuccess, failDueToSuccessError, failSuccessfully, failSuccessfullyError, failTest, failWithDoneDueToSuccess, failWithJestDoneCallback, failWithTestDoneCallback, fakeDoneHandler, instanceWrapJestTestContextFactory, instanceWrapTestContextFactory, itShouldFail, jestExpectFailAssertErrorType, jestTestContextBuilder, shouldFail, testContextBuilder, testDoneCallbackRef, useJestContextFixture, useJestFunctionFixture, useJestFunctionMapFixture, useTestContextFixture, useTestFunctionFixture, useTestFunctionMapFixture, wrapJestTestContextFactory, wrapTestContextFactory };

package/test/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/test",
-  "version": "13.11.18",
+  "version": "13.12.1",
   "peerDependencies": {
-    "@dereekb/util": "13.11.18",
+    "@dereekb/util": "13.12.1",
     "make-error": "^1.3.6"
   },
   "exports": {

package/test/src/lib/shared/shared.fail.d.ts

@@ -105,6 +105,26 @@ export declare function expectFailAssertErrorType(expectedType: ClassType | Clas
  * ```
  */
 export declare function expectFail(errorFn: () => PromiseOrValue<any>, assertFailType?: ExpectFailAssertionFunction): Promise<void>;
+/**
+ * Invokes `fn` and returns the value it rejects with. Throws {@link UnexpectedSuccessFailureError}
+ * when `fn` resolves successfully.
+ *
+ * Use this when a test needs the thrown value in hand to assert on multiple of its properties
+ * (e.g. inspect a structured `details.code`). For "did it throw at all" checks, prefer
+ * {@link expectFail} or vitest's `await expect(fn()).rejects.toThrow(...)`.
+ *
+ * @param fn - Async function expected to reject.
+ * @returns The thrown value as `unknown`.
+ * @throws {UnexpectedSuccessFailureError} When `fn` resolves successfully.
+ *
+ * @example
+ * ```ts
+ * const error = await captureRejection(() => callResetPassword({ resetPassword: '000000' }));
+ * expect(error).toBeInstanceOf(HttpsError);
+ * expect((error as HttpsError).code).toBe('invalid-argument');
+ * ```
+ */
+export declare function captureRejection<T>(fn: () => Promise<T>): Promise<unknown>;
 /**
  * Function that expects an {@link ExpectedFailError} to be thrown by `errorFn`.
  *

package/eslint/src/lib/require-dbx-model-companion-tags.rule.d.ts

@@ -1,46 +0,0 @@
-interface AstNode {
-    readonly type: string;
-    [key: string]: any;
-}
-/**
- * Options for the require-dbx-model-companion-tags rule.
- */
-export interface UtilRequireDbxModelCompanionTagsRuleOptions {
-    readonly allowedEncodings?: readonly string[];
-    readonly knownCompanions?: readonly string[];
-    readonly requireBareMarker?: boolean;
-}
-/**
- * ESLint rule definition for require-dbx-model-companion-tags.
- */
-export interface UtilRequireDbxModelCompanionTagsRuleDefinition {
-    readonly meta: {
-        readonly type: 'suggestion';
-        readonly fixable: 'code';
-        readonly docs: {
-            readonly description: string;
-            readonly recommended: boolean;
-        };
-        readonly messages: Readonly<Record<string, string>>;
-        readonly schema: readonly object[];
-    };
-    create(context: {
-        options: UtilRequireDbxModelCompanionTagsRuleOptions[];
-        report: (descriptor: {
-            loc?: AstNode;
-            messageId: string;
-            data?: Record<string, string>;
-        }) => void;
-        sourceCode: AstNode;
-    }): Record<string, (node: AstNode) => void>;
-}
-/**
- * ESLint rule enforcing `@dbxModel` / `@dbxModelSubObject` / `@dbxModelOrganizationalGroupRoot`
- * companion tags. Mirrors the scanner schema at
- * `packages/dbx-components-mcp/src/scan/extract-models/find-interfaces.ts`.
- *
- * Does NOT enforce a Slug / Category / Tags shape because the scanner does
- * not consume those for this family.
- */
-export declare const UTIL_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE: UtilRequireDbxModelCompanionTagsRuleDefinition;
-export {};