Move numeric edge helpers to shared math

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,5 +1,5 @@
 MODEL: GPT-5.4-codex
 REASONING: high
 COMMAND:
-Execute docs/pr/BUILD_PR_REPO_STRUCTURE_68_MOVE_MAP_ID_HELPERS_TO_SHARED.md exactly.
-Package to <project folder>/tmp/BUILD_PR_REPO_STRUCTURE_68_MOVE_MAP_ID_HELPERS_TO_SHARED_delta.zip
+Execute docs/pr/BUILD_PR_REPO_STRUCTURE_69_MOVE_MAP_NUMERIC_EDGE_HELPERS_TO_SHARED_MATH.md exactly.
+Package to <project folder>/tmp/BUILD_PR_REPO_STRUCTURE_69_MOVE_MAP_NUMERIC_EDGE_HELPERS_TO_SHARED_MATH_delta.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-Move id helpers to shared utils
+Move numeric edge helpers to shared math

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-Next: numeric edge helpers
+Next: final inspector cleanup

docs/dev/reports/change_summary.txt

@@ -1 +1 @@
-id helpers consolidation
+numeric helpers consolidation

docs/dev/reports/file_tree.txt

@@ -1,2 +1,2 @@
 src/engine/debug/inspectors/shared/inspectorUtils.js
-src/shared/utils/idUtils.js
+src/shared/math/numberNormalization.js

docs/pr/BUILD_PR_REPO_STRUCTURE_69_MOVE_MAP_NUMERIC_EDGE_HELPERS_TO_SHARED_MATH.md

@@ -0,0 +1,13 @@
+# BUILD PR — Move Numeric Edge Helpers to Shared Math
+
+## Files
+- src/engine/debug/inspectors/shared/inspectorUtils.js
+- src/shared/math/numberNormalization.js
+
+## Actions
+- move remaining numeric edge helpers into shared math
+- import from shared
+
+## Constraints
+- exact files only
+- no refactor

src/engine/debug/inspectors/shared/inspectorUtils.js

@@ -8,9 +8,11 @@ inspectorUtils.js
 import { asPositiveInteger } from "../../../../shared/utils/numberUtils.js";
 import { sanitizeText } from "../../../../shared/utils/stringUtils.js";
 import { createId, isValidId } from "../../../../shared/utils/idUtils.js";
+import { asFinite, asNonNegativeInteger } from "../../../../shared/math/numberNormalization.js";
 
 export { sanitizeText };
 export { createId, isValidId };
+export { asFinite, asNonNegativeInteger };
 
 export function asObject(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value)
@@ -22,15 +24,6 @@ export function asArray(value) {
   return Array.isArray(value) ? value : [];
 }
 
-export function asFinite(value, fallback = 0) {
-  return Number.isFinite(value) ? Number(value) : fallback;
-}
-
-export function asNonNegativeInteger(value, fallback = 0) {
-  const normalized = Math.floor(asFinite(value, fallback));
-  return normalized >= 0 ? normalized : Math.max(0, Math.floor(asFinite(fallback, 0)));
-}
-
 export { asPositiveInteger };
 
 export function cloneJson(value) {

src/shared/math/numberNormalization.js

@@ -17,6 +17,15 @@ export function sanitizePositiveNumber(value, fallback) {
   return number > 0 ? number : fallback;
 }
 
+export function asFinite(value, fallback = 0) {
+  return Number.isFinite(value) ? Number(value) : fallback;
+}
+
+export function asNonNegativeInteger(value, fallback = 0) {
+  const normalized = Math.floor(asFinite(value, fallback));
+  return normalized >= 0 ? normalized : Math.max(0, Math.floor(asFinite(fallback, 0)));
+}
+
 export function roundNumber(value) {
   if (!Number.isFinite(value)) {
     return value;