Function createWorldEngine

packages/webapp/components/world/engine/world.js:42–11170

(options)

   one world would, and there is only ever one world on a page.
   ========================================================================== */
export function createWorldEngine(options) {
const { container, onState, lite } = options;

/* ============================================================= the two tiers
   A phone is not a small desktop. It has a tile-based GPU with a fraction of
   the bandwidth, a screen with three times the pixels per CSS unit, and a
   thermal budget that a frame costing three passes over the scene will spend
   in about ninety seconds — after which the whole device is throttled, not
   just this page.

   So `lite` is one decision, taken by the page before this engine exists (it
   configures a WebGL context, which cannot be reconfigured afterwards), and it
   is spent in exactly two places: the resolution the frame is drawn at, and
   how many times the scene is drawn for it. Nothing about the WORLD changes —
   the same land, the same buildings, the same look. */
const LITE = !!lite;
/* 2 is already a cap rather than the truth: a modern phone reports 3, and the
   difference between 2 and 3 is invisible at arm's length and 2.25x the
   fragments. On a handheld the same argument keeps going down one more step. */
const dprCap = () => Math.min(devicePixelRatio, LITE ? 1.5 : 2);

/* ============================================================================
   THE ART, and what it is arguing.

   The GROWTH machinery is the first pass's and is untouched, because it was
   never the part that was wrong:

   1. A district is NOT one building that gets taller. It is a PLACE that gets
      bigger, busier and better tended. Land area is the attention channel —
      "the more I read, the more land, the more life". Height is a supporting
      voice, not the melody.
   2. Twelve levels, not five. A five-level ladder saturates hard on real data
      (a four-year veteran reads a wall of 23 citadels), so the top of it
      carries no information. Twelve steps keep separating people all the way up.
   3. Everything is generated from (niche, level) — no models, no textures, no
      network. Two knobs, and the whole place re-composes.

   What the second pass changed is the LOOK. The first derived every realm's
   materials from daily.dev tokens by mixing, which kept the palette on-brand
   and made all six realms siblings of the same pastel family. The concept art
   per realm says something louder — each realm is its own WORLD, with its own
   light, its own rock and its own weather:

   4. REALM MATERIALS COME FROM THE CONCEPT ART (`C` in taxonomy), not from
      token mixes. DISTRICT ACCENTS STAY ON TOKENS: the realm is the place, the
      district is the subject, and the subject is daily.dev's. Brand rides the
      accent — lodestone band, roof trim, lamps, banners — where it is legible
      and where it does not fight the light.
   5. THE UNDERSIDE IS REALM IDENTITY. Every island floats, and in every concept
      image the bottom is the tell: crystal, wrapped roots, basalt columns, wet
      crag, icicles, clay. One keel cone for all six threw that away.
   6. EVERY REALM GETS A LANDFORM, standing at L1 before a single building is.
      Three realms used to have terrain of their own and three had only props,
      which left half the set unreadable until L3.
   ==========================================================================*/

/* ---------------------------------------------------------------- helpers */
const clamp=(v,a,b)=>v<a?a:v>b?b:v;