@dereekb/util 13.12.0 → 13.12.1

package/eslint/package.json

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

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.12.0",
+  "version": "13.12.1",
   "peerDependencies": {
-    "@dereekb/util": "13.12.0",
+    "@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.12.0",
+  "version": "13.12.1",
   "sideEffects": false,
   "exports": {
     "./test": {

package/test/package.json

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