44 lines
3.4 KiB
JavaScript
44 lines
3.4 KiB
JavaScript
"use strict";
|
|
|
|
// Layer: core/deterministic
|
|
// Shared deterministic pseudo-random helpers used by behavior, item runtime,
|
|
// and visual effects. Previously this bootstrap lived inline in several
|
|
// modules; keeping it here prevents helper drift and load-order surprises.
|
|
(function ensureDeterministicHelpers(global) {
|
|
if (typeof global.deterministicChance === "function" && typeof global.deterministicRange === "function") return;
|
|
const clamp01 = v => Math.max(0, Math.min(1, Number(v) || 0));
|
|
const keyPart = value => {
|
|
if (value == null) return "null";
|
|
if (typeof value === "number") return Number.isFinite(value) ? value.toFixed(3) : "nan";
|
|
if (typeof value === "string" || typeof value === "boolean") return String(value);
|
|
if (typeof value === "object") {
|
|
const id = value.familyKey || value.id || value.seed || value.liveToken || value.name;
|
|
if (id) return `${value.type || value.constructor?.name || "entity"}:${id}`;
|
|
const x = Number.isFinite(value.x) ? value.x.toFixed(1) : "x";
|
|
const y = Number.isFinite(value.y) ? value.y.toFixed(1) : "y";
|
|
return `${value.type || value.constructor?.name || "entity"}@${x},${y}`;
|
|
}
|
|
return String(value);
|
|
};
|
|
const hashUnit = (seed, salt = "") => {
|
|
const str = `${seed}:${salt}`;
|
|
let h = 2166136261;
|
|
for (let i = 0; i < str.length; i++) { h ^= str.charCodeAt(i); h = Math.imul(h, 16777619); }
|
|
return ((h >>> 0) % 100000) / 100000;
|
|
};
|
|
global.deterministicFrame = global.deterministicFrame || ((worldRef = null, hz = 60) => Math.floor((Number(worldRef?.time || 0) || 0) * Math.max(1, Number(hz) || 60) + 1e-6));
|
|
global.deterministicUnit = global.deterministicUnit || ((worldRef = null, salt = "", ...parts) => hashUnit(String(worldRef?.worldSeed || "tarinai-world"), [salt, global.deterministicFrame(worldRef, 60), Number(worldRef?._deterministicEpoch || 0) || 0, ...parts.map(keyPart)].join("|")));
|
|
global.deterministicRange = global.deterministicRange || ((worldRef = null, salt = "", min = 0, max = 1, ...parts) => (Number(min) || 0) + global.deterministicUnit(worldRef, salt, ...parts) * ((Number(max) || 0) - (Number(min) || 0)));
|
|
global.deterministicSigned = global.deterministicSigned || ((worldRef = null, salt = "", ...parts) => global.deterministicUnit(worldRef, salt, ...parts) < 0.5 ? -1 : 1);
|
|
global.deterministicChance = global.deterministicChance || ((worldRef = null, salt = "", chance = 0, ...parts) => { const p = clamp01(chance); return p >= 1 || (p > 0 && global.deterministicUnit(worldRef, salt, ...parts) < p); });
|
|
global.deterministicAngle = global.deterministicAngle || ((worldRef = null, salt = "", ...parts) => global.deterministicRange(worldRef, salt, 0, Math.PI * 2, ...parts));
|
|
})(typeof window !== "undefined" ? window : globalThis);
|
|
|
|
// Keep the historical bare helper names available to legacy scripts while the
|
|
// implementation lives on globalThis.
|
|
var deterministicFrame = (typeof window !== "undefined" ? window : globalThis).deterministicFrame;
|
|
var deterministicUnit = (typeof window !== "undefined" ? window : globalThis).deterministicUnit;
|
|
var deterministicRange = (typeof window !== "undefined" ? window : globalThis).deterministicRange;
|
|
var deterministicSigned = (typeof window !== "undefined" ? window : globalThis).deterministicSigned;
|
|
var deterministicChance = (typeof window !== "undefined" ? window : globalThis).deterministicChance;
|
|
var deterministicAngle = (typeof window !== "undefined" ? window : globalThis).deterministicAngle;
|