@adatechnology/game-urban 0.1.0 → 0.2.0

package/dist/index.js

@@ -215,6 +215,90 @@ function drawStreetGrid(b, block, count, width, options) {
 
 // src/block.ts
 import { createCityBuilding } from "@adatechnology/game-floorplan";
+
+// src/tower.ts
+var DEFAULT_TOWER_PRESETS = [
+  { id: "office", weight: 0.6, storeyHeight: 4, mechanicalEvery: 20, glass: true, color: 3955315 },
+  { id: "residential", weight: 0.4, storeyHeight: 3.1, mechanicalEvery: 25, glass: false }
+];
+var towerPresetOf = (id, weight, layout, extra = {}) => ({ id, weight, storeyHeight: layout.pitch, mechanicalEvery: 20, glass: layout.facade === "curtain", ...extra });
+var TOWER_DEFAULTS = { minHeight: 60, maxStoreys: 60, mast: 0.06, lit: 0.12 };
+var PODIUM = 1.5;
+var PLANT = 2895667;
+var PODIUM_COLOR = 2764081;
+var PARAPET = 2763308;
+var MAST = 10133670;
+var MAX_MAST = 25;
+var GLASS_COLUMN = 1.6;
+var MASONRY_COLUMN = 3;
+function pickTowerPreset(b, presets) {
+  const total = presets.reduce((sum2, p) => sum2 + p.weight, 0);
+  let r = b.random() * total;
+  for (const preset of presets) {
+    r -= preset.weight;
+    if (r < 0) return preset;
+  }
+  return presets[presets.length - 1];
+}
+var towerStoreys = (height, preset) => Math.max(3, Math.round(height / preset.storeyHeight));
+function drawTower(b, request, options = {}) {
+  const { x, z, width: w, depth: d, preset } = request;
+  const storeys = towerStoreys(request.height, preset);
+  const h = preset.storeyHeight;
+  const podium = h * PODIUM;
+  const skin = preset.color ?? request.color;
+  const mechanical = /* @__PURE__ */ new Set();
+  if (preset.mechanicalEvery) {
+    for (let k = preset.mechanicalEvery; k < storeys - 1; k += preset.mechanicalEvery) if (storeys - 1 - k >= preset.mechanicalEvery / 2) mechanical.add(k);
+  }
+  mechanical.add(storeys - 1);
+  b.box(x, 0, z, w + 0.6, podium, d + 0.6, PODIUM_COLOR);
+  const shaftTop = (storeys - 1) * h;
+  b.box(x, podium, z, w, shaftTop - podium + (podium - h), d, skin);
+  for (const k of mechanical) {
+    if (k === storeys - 1) b.box(x, k * h + (podium - h), z, w * 0.82, h, d * 0.82, PLANT);
+    else b.box(x, k * h + (podium - h), z, w + 0.4, h, d + 0.4, PLANT);
+  }
+  const top = storeys * h + (podium - h);
+  b.box(x, top, z, w * 0.82 + 0.3, 0.35, d * 0.82 + 0.3, PARAPET);
+  const mast = Math.min(MAX_MAST, top * (options.mast ?? TOWER_DEFAULTS.mast));
+  if (mast > 0.5) b.cylinder(x, top + 0.35, z, 0.12, 0.2, mast, MAST, -1, 6);
+  const column = preset.glass ? GLASS_COLUMN : MASONRY_COLUMN;
+  const winHeight = preset.glass ? h * 0.62 : 1.5;
+  const winWidth = preset.glass ? column * 0.86 : 1.3;
+  const faces = [[0, d / 2 + 0.03, w, 0], [0, -d / 2 - 0.03, w, Math.PI], [w / 2 + 0.03, 0, d, Math.PI / 2], [-w / 2 - 0.03, 0, d, -Math.PI / 2]];
+  for (const [ox, oz, faceWidth, ry] of faces) {
+    const columns = Math.max(1, Math.floor(faceWidth / column));
+    for (let storey = 1; storey < storeys; storey++) {
+      if (mechanical.has(storey)) continue;
+      const y = storey * h + (podium - h) + h * (preset.glass ? 0.2 : 0.35);
+      for (let c = 0; c < columns; c++) {
+        const u = (c - (columns - 1) / 2) * column;
+        const lit = b.random() < request.lit;
+        (lit ? b.windows.lit : b.windows.dark).push({ x: ox ? x + ox : x + u, y, z: ox ? z + u : z + oz, ry, width: winWidth, height: winHeight, isLit: lit });
+      }
+    }
+  }
+  return { x, z, width: w, depth: d, height: top + 0.35 + (mast > 0.5 ? mast : 0), color: request.color };
+}
+function createTowerDrawer(towers, plain) {
+  const minHeight = towers.minHeight ?? TOWER_DEFAULTS.minHeight;
+  const presets = towers.presets ?? DEFAULT_TOWER_PRESETS;
+  return (b, x, z, width, depth, height, color, o = {}) => {
+    if (height < minHeight || presets.length === 0) return plain(b, x, z, width, depth, height, color, o);
+    const preset = (o.preset ? presets.find((p) => p.id === o.preset) : void 0) ?? pickTowerPreset(b, presets);
+    const top = (preset.maxStoreys ?? towers.maxStoreys ?? TOWER_DEFAULTS.maxStoreys) * preset.storeyHeight;
+    const bottom = (preset.minStoreys ?? 0) * preset.storeyHeight;
+    const request = { x, z, width, depth, height: Math.min(Math.max(height, bottom), top), color, preset, lit: o.lit ?? towers.lit ?? TOWER_DEFAULTS.lit, ...o.use ? { use: o.use } : {}, ...o.storeys ? { storeys: o.storeys } : {} };
+    if (towers.provider) {
+      towers.provider(request, b);
+      return { x, z, width, depth, height: request.height, color };
+    }
+    return drawTower(b, request, towers);
+  };
+}
+
+// src/block.ts
 var DEFAULT_FACADES = [3882821, 4866104, 3489853, 4602426, 4143924, 3093561, 5327167, 5920334];
 var DEFAULT_PARTITIONS = 2;
 var DEFAULT_GAP = 0.08;
@@ -222,10 +306,22 @@ var STREET_MARGIN = 2;
 var FOOTPRINT_TRIM = 1.2;
 var FOOTPRINT_JITTER = 1.5;
 var HEIGHT_CURVE = 1.6;
+var DEFAULT_STOREY_PRESETS = { commercial: "office", residential: "residential" };
 function drawBuilding(b, x, z, width, depth, height, color, options = {}) {
   b.add(createCityBuilding({ x, z, width, depth, height, color, random: b.random, shopChance: options.shop, litChance: options.lit }));
   return { x, z, width, depth, height, color };
 }
+function pickUse(b, uses) {
+  const entries = Object.entries(uses).filter(([, w]) => w > 0);
+  const total = entries.reduce((sum2, [, w]) => sum2 + w, 0);
+  if (total <= 0) return void 0;
+  let r = b.random() * total;
+  for (const [use, w] of entries) {
+    r -= w;
+    if (r < 0) return use;
+  }
+  return entries[entries.length - 1][0];
+}
 var lerp = (a, b, t) => a + (b - a) * t;
 function fillBlock(b, cx, cz, size, minHeight, maxHeight, options = {}) {
   const placed = [];
@@ -238,11 +334,25 @@ function fillBlock(b, cx, cz, size, minHeight, maxHeight, options = {}) {
       if (b.random() < (options.gap || DEFAULT_GAP)) continue;
       const width = lot - FOOTPRINT_TRIM - b.random() * FOOTPRINT_JITTER;
       const depth = lot - FOOTPRINT_TRIM - b.random() * FOOTPRINT_JITTER;
-      const height = lerp(minHeight, maxHeight, Math.pow(b.random(), HEIGHT_CURVE));
+      const t = Math.pow(b.random(), HEIGHT_CURVE);
+      let height = lerp(minHeight, maxHeight, t);
+      let extra = null;
+      if (options.floors !== void 0 || options.uses) {
+        const use = options.uses ? pickUse(b, options.uses) : void 0;
+        const presetId = use ? (options.storeyPresets ?? DEFAULT_STOREY_PRESETS)[use] : void 0;
+        const preset = presetId ? (options.presets ?? DEFAULT_TOWER_PRESETS).find((p) => p.id === presetId) : void 0;
+        extra = { use, preset: preset?.id };
+        if (options.floors !== void 0) {
+          const [lo, hi] = typeof options.floors === "number" ? [options.floors, options.floors] : options.floors;
+          const storeys = Math.max(1, Math.round(lerp(lo, hi, t)));
+          height = storeys * (preset?.storeyHeight ?? options.storeyHeight ?? DEFAULT_TOWER_PRESETS[DEFAULT_TOWER_PRESETS.length - 1].storeyHeight);
+          extra.storeys = storeys;
+        }
+      }
       const x = cx - half + lot * (i + 0.5);
       const z = cz - half + lot * (j + 0.5);
       const color = b.pick(palette);
-      placed.push(drawBuilding(b, x, z, width, depth, height, color, options));
+      placed.push((options.draw ?? drawBuilding)(b, x, z, width, depth, height, color, extra ? { ...options, ...extra } : options));
     }
   }
   return placed;
@@ -313,7 +423,7 @@ function drawWires(b, points, y, color, c) {
 }
 
 // src/kit.ts
-import { applyPatches, mergeById, removeIds } from "@adatechnology/game-contracts";
+import { applyPatches as applyPatches2, mergeById as mergeById2, removeIds as removeIds2 } from "@adatechnology/game-contracts";
 import { createSilhouetteRandom } from "@adatechnology/game-floorplan";
 
 // src/neighbourhoods/houses.ts
@@ -385,13 +495,13 @@ function composePattern(kit, pattern, composer, b, origin, options = {}) {
     }
   };
   composer(context);
-  const text = pattern.text[locale] ?? pattern.text[DEFAULT_LOCALE];
-  kit.props.label(b, origin.x, origin.z + LABEL_OFFSET_Z, text.title, text.caption);
+  const text2 = pattern.text[locale] ?? pattern.text[DEFAULT_LOCALE];
+  kit.props.label(b, origin.x, origin.z + LABEL_OFFSET_Z, text2.title, text2.caption);
   return plan;
 }
 function patternMarker(pattern, origin, locale = DEFAULT_LOCALE) {
-  const text = pattern.text[locale] ?? pattern.text[DEFAULT_LOCALE];
-  return { x: origin.x, y: pattern.marker.height, z: origin.z + (pattern.marker.dz ?? 0), label: text.label, detail: text.detail };
+  const text2 = pattern.text[locale] ?? pattern.text[DEFAULT_LOCALE];
+  return { x: origin.x, y: pattern.marker.height, z: origin.z + (pattern.marker.dz ?? 0), label: text2.label, detail: text2.detail };
 }
 
 // src/neighbourhoods/composers.ts
@@ -792,6 +902,368 @@ var SAMPLE_CELLS = {
   military: { x: 160, z: 0 }
 };
 
+// src/cities/cities.ts
+import { applyPatches, mergeById, removeIds } from "@adatechnology/game-contracts";
+
+// src/cities/kinds.ts
+var DEFAULT_DISTRICT_KINDS = [
+  { id: "downtown", color: "#3b4f7a", zone: "zt", pattern: "financial_district", floors: [20, 60], uses: { commercial: 0.7, residential: 0.3 }, block: 90, text: { "pt-BR": { name: "Centro financeiro", description: "Arranha-c\xE9us de escrit\xF3rio e torres residenciais, de 20 a 60 andares." }, en: { name: "Downtown core", description: "Office and residential towers, 20 to 60 storeys." } } },
+  { id: "commercial_center", color: "#5b6fa3", zone: "zc", pattern: "downtown", floors: [4, 15], uses: { commercial: 0.6, residential: 0.4 }, block: 70, text: { "pt-BR": { name: "Centro comercial", description: "Loja no t\xE9rreo e escrit\xF3rios ou apartamentos em cima, de 4 a 15 andares." }, en: { name: "Commercial centre", description: "Shops on the ground floor, offices or flats above, 4 to 15 storeys." } } },
+  { id: "residential_high", color: "#7a68a6", zone: "zt", pattern: "downtown", floors: [8, 25], uses: { residential: 0.9, commercial: 0.1 }, block: 80, text: { "pt-BR": { name: "Bairro de pr\xE9dios", description: "Condom\xEDnios de pr\xE9dios de 8 a 25 andares com \xE1rea de lazer." }, en: { name: "High-rise residential", description: "Apartment blocks, 8 to 25 storeys." } } },
+  { id: "mixed", color: "#9c7fb8", zone: "zr3_zm", pattern: "downtown", floors: [2, 8], uses: { residential: 0.6, commercial: 0.4 }, block: 60, text: { "pt-BR": { name: "Uso misto", description: "Sobrados, pr\xE9dios baixos e com\xE9rcio de rua, de 2 a 8 andares." }, en: { name: "Mixed use", description: "Townhouses, low blocks and street shops, 2 to 8 storeys." } } },
+  { id: "residential_mid", color: "#d9a35b", zone: "zr2", pattern: "suburb", floors: [1, 4], uses: { residential: 0.95, commercial: 0.05 }, block: 60, text: { "pt-BR": { name: "Residencial m\xE9dio", description: "Casas, sobrados e pr\xE9dios pequenos de at\xE9 4 andares." }, en: { name: "Mid-density residential", description: "Houses and small blocks up to 4 storeys." } } },
+  { id: "residential_low", color: "#e8c477", zone: "zr1", pattern: "suburb", floors: [1, 2], uses: { residential: 1 }, block: 70, text: { "pt-BR": { name: "Residencial de casas", description: "Casas t\xE9rreas e sobrados com quintal e recuo." }, en: { name: "Low-density residential", description: "Houses with yards and setbacks." } } },
+  { id: "residential_gated", color: "#c9d27a", zone: "zr_ap", pattern: "suburb", floors: [1, 3], uses: { residential: 1 }, block: 110, text: { "pt-BR": { name: "Condom\xEDnio fechado", description: "Casas grandes em lotes amplos, muro e portaria." }, en: { name: "Gated community", description: "Large houses on big lots behind a wall and gate." } } },
+  { id: "residential_popular", color: "#d97a5b", zone: "zr2", pattern: "working_class", floors: [1, 3], uses: { residential: 0.9, commercial: 0.1 }, block: 45, text: { "pt-BR": { name: "Bairro popular", description: "Casas geminadas de laje, sem recuo, ruas estreitas." }, en: { name: "Working-class housing", description: "Terraced self-built houses, narrow streets." } } },
+  { id: "historic", color: "#b5835a", zone: "zr3_zm", pattern: "historic_street", floors: [1, 3], uses: { residential: 0.6, commercial: 0.4 }, block: 50, text: { "pt-BR": { name: "Centro hist\xF3rico", description: "Casario colonial colado, rua de pedra, igreja e pra\xE7a." }, en: { name: "Historic quarter", description: "Colonial row houses, cobbled streets, church and square." } } },
+  { id: "institutional", color: "#5aa3a0", zone: "zc", pattern: "downtown", floors: [2, 8], uses: { institutional: 1 }, block: 120, text: { "pt-BR": { name: "Institucional", description: "Hospital, escola, campus, prefeitura, delegacia e quartel de bombeiros." }, en: { name: "Institutional", description: "Hospital, schools, campus, city hall, police and fire stations." } } },
+  { id: "industrial", color: "#7d7d74", zone: "zi", pattern: "industrial_port", floors: [1, 1], uses: { industrial: 1 }, block: 140, text: { "pt-BR": { name: "Distrito industrial", description: "Galp\xF5es de 8 a 12 m, p\xE1tios e chamin\xE9s." }, en: { name: "Industrial district", description: "Sheds 8 to 12 m tall, yards and stacks." } } },
+  { id: "logistics", color: "#96968a", zone: "zi", pattern: "industrial_port", floors: [1, 1], uses: { industrial: 0.8, commercial: 0.2 }, block: 160, text: { "pt-BR": { name: "Distrito log\xEDstico", description: "Centros de distribui\xE7\xE3o, posto de caminhoneiro, p\xE1tio de carretas." }, en: { name: "Logistics", description: "Distribution centres, truck stop, trailer yards." } } },
+  { id: "port", color: "#5f7f8f", zone: "zi", pattern: "industrial_port", floors: [1, 1], uses: { industrial: 1 }, block: 150, text: { "pt-BR": { name: "Porto", description: "Cais, guindastes, cont\xEAineres empilhados e armaz\xE9ns." }, en: { name: "Port", description: "Quays, cranes, stacked containers and warehouses." } } },
+  { id: "rail_yard", color: "#6e6158", zone: "zi", pattern: "railway_village", floors: [1, 1], uses: { industrial: 1 }, block: 150, text: { "pt-BR": { name: "P\xE1tio ferrovi\xE1rio", description: "Linhas, rotunda, oficina e vag\xF5es parados." }, en: { name: "Rail yard", description: "Tracks, roundhouse, workshop and parked wagons." } } },
+  { id: "company_housing", color: "#cfae86", zone: "zr1", pattern: "railway_village", floors: [1, 1], uses: { residential: 1 }, block: 50, text: { "pt-BR": { name: "Vila oper\xE1ria", description: "Casas iguais em fila, da ferrovia ou da f\xE1brica." }, en: { name: "Company housing", description: "Identical row houses of the railway or the mill." } } },
+  { id: "hillside_resort", color: "#a3b58a", zone: "zr1", pattern: "mountain_resort", floors: [1, 2], uses: { residential: 0.7, commercial: 0.3 }, block: 60, text: { "pt-BR": { name: "Serra e pousadas", description: "Chal\xE9s e pousadas na encosta, ruas em curva." }, en: { name: "Hillside resort", description: "Chalets and inns on the slope." } } },
+  { id: "stilt", color: "#7fa3b5", zone: "zr1", pattern: "stilt_village", floors: [1, 1], uses: { residential: 1 }, block: 40, text: { "pt-BR": { name: "Palafitas", description: "Casas sobre estacas na beira da \xE1gua, trapiches." }, en: { name: "Stilt village", description: "Houses on stilts by the water, jetties." } } },
+  { id: "park", color: "#6f9a5e", zone: null, pattern: null, floors: [0, 0], uses: {}, block: 0, text: { "pt-BR": { name: "Parque e pra\xE7a", description: "\xC1rea verde, pra\xE7a, campo de futebol." }, en: { name: "Park", description: "Green space, square, football pitch." } } },
+  { id: "rural", color: "#a7b86d", zone: "za", pattern: "rural", floors: [1, 2], uses: { residential: 0.8, agricultural: 0.2 }, block: 250, text: { "pt-BR": { name: "Ch\xE1caras e s\xEDtios", description: "S\xEDtios com casa sede, horta e pomar." }, en: { name: "Smallholdings", description: "Smallholdings with a farmhouse, garden and orchard." } } },
+  { id: "farmland", color: "#c8c67e", zone: "za", pattern: "rural", floors: [0, 1], uses: { agricultural: 1 }, block: 400, text: { "pt-BR": { name: "Lavoura", description: "Planta\xE7\xE3o, silos e estradas de terra." }, en: { name: "Farmland", description: "Crops, silos and dirt roads." } } },
+  { id: "airfield", color: "#b8b8a8", zone: "za", pattern: "rural", floors: [1, 1], uses: { industrial: 1 }, block: 300, text: { "pt-BR": { name: "Aer\xF3dromo", description: "Pista, hangares e torre." }, en: { name: "Airfield", description: "Runway, hangars and tower." } } },
+  { id: "wild", color: "#4f7a4a", zone: null, pattern: null, floors: [0, 0], uses: {}, block: 0, text: { "pt-BR": { name: "Mata e morro", description: "Mata, morro, \xE1rea sem constru\xE7\xE3o." }, en: { name: "Woods and hills", description: "Woods and hills, unbuilt." } } }
+];
+
+// src/cities/templates.ts
+var DEFAULT_CITY_PLANS = [
+  {
+    id: "metropolis",
+    scale: "metropolis",
+    size: [6e3, 6e3],
+    text: { "pt-BR": { name: "Metr\xF3pole", description: "Centro financeiro de arranha-c\xE9us cercado de com\xE9rcio, bairros de pr\xE9dios, casas, periferia e ind\xFAstria na ferrovia." }, en: { name: "Metropolis", description: "Tower downtown ringed by commerce, high-rise and low-rise neighbourhoods, outskirts and industry on the railway." } },
+    districts: [
+      { id: "outskirts", kind: "rural", rect: [-3e3, -3e3, 3e3, 3e3] },
+      { id: "suburbs_w", kind: "residential_low", rect: [-2600, -2600, -600, 2600] },
+      { id: "suburbs_e", kind: "residential_mid", rect: [600, -2600, 2600, 1e3] },
+      { id: "periphery", kind: "residential_popular", rect: [-3e3, 1200, -800, 3e3] },
+      { id: "gated", kind: "residential_gated", rect: [1400, -3e3, 3e3, -1800] },
+      { id: "industry", kind: "industrial", rect: [600, 1600, 3e3, 3e3] },
+      { id: "logistics", kind: "logistics", rect: [2200, 400, 3e3, 1600] },
+      { id: "mixed", kind: "mixed", rect: [-1600, -1600, 1600, 1400] },
+      { id: "high", kind: "residential_high", rect: [-1400, -1500, -300, -300] },
+      { id: "high2", kind: "residential_high", rect: [300, -1500, 1400, -600] },
+      { id: "center", kind: "commercial_center", rect: [-900, -700, 1100, 800] },
+      { id: "downtown", kind: "downtown", rect: [-400, -400, 600, 400] },
+      { id: "hospital", kind: "institutional", rect: [-1600, 500, -1e3, 1100] },
+      { id: "campus", kind: "institutional", rect: [1300, -500, 2e3, 300] },
+      { id: "park", kind: "park", rect: [-300, 500, 500, 1100] },
+      { id: "hills", kind: "wild", rect: [-3e3, -3e3, -1800, -1800] }
+    ],
+    lines: [
+      { id: "ring", kind: "avenue", width: 30, points: [[-1700, -1700], [1700, -1700], [1700, 1500], [-1700, 1500], [-1700, -1700]] },
+      { id: "main_ns", kind: "avenue", width: 30, points: [[100, -3e3], [100, 3e3]] },
+      { id: "main_ew", kind: "avenue", width: 30, points: [[-3e3, 0], [3e3, 0]] },
+      { id: "rail", kind: "rail", width: 12, points: [[-3e3, 1500], [0, 1500], [3e3, 1300]] },
+      { id: "highway", kind: "highway", width: 24, points: [[-3e3, -2200], [3e3, -2400]] }
+    ],
+    landmarks: [
+      { kind: "station", at: [0, 1500] },
+      { kind: "hospital", at: [-1300, 800] },
+      { kind: "stadium", at: [1700, -100] },
+      { kind: "cathedral", at: [100, 100] },
+      { kind: "mall", at: [800, 600] },
+      { kind: "police", at: [300, -300] },
+      { kind: "fire", at: [-500, 600] },
+      { kind: "gas_station", at: [2400, -2300] }
+    ]
+  },
+  {
+    id: "regional_city",
+    scale: "city",
+    size: [4e3, 4e3],
+    text: { "pt-BR": { name: "Cidade m\xE9dia", description: "Centro comercial com poucos pr\xE9dios altos, bairros de casas e um distrito industrial." }, en: { name: "Regional city", description: "Commercial centre with a few tall buildings, house neighbourhoods and an industrial district." } },
+    districts: [
+      { id: "outskirts", kind: "rural", rect: [-2e3, -2e3, 2e3, 2e3] },
+      { id: "res_w", kind: "residential_low", rect: [-1800, -1600, -300, 1600] },
+      { id: "res_e", kind: "residential_mid", rect: [300, -1600, 1800, 600] },
+      { id: "popular", kind: "residential_popular", rect: [-1800, 800, -500, 1800] },
+      { id: "industry", kind: "industrial", rect: [500, 900, 2e3, 2e3] },
+      { id: "mixed", kind: "mixed", rect: [-800, -800, 900, 700] },
+      { id: "center", kind: "commercial_center", rect: [-400, -400, 500, 350] },
+      { id: "square", kind: "park", rect: [-100, -100, 150, 100] },
+      { id: "hospital", kind: "institutional", rect: [600, -900, 1e3, -500] }
+    ],
+    lines: [
+      { id: "main_ns", kind: "avenue", width: 24, points: [[0, -2e3], [0, 2e3]] },
+      { id: "main_ew", kind: "avenue", width: 24, points: [[-2e3, 0], [2e3, 0]] },
+      { id: "highway", kind: "highway", width: 24, points: [[-2e3, 1600], [2e3, 1500]] }
+    ],
+    landmarks: [
+      { kind: "church", at: [0, 0] },
+      { kind: "hospital", at: [800, -700] },
+      { kind: "school", at: [-600, 300] },
+      { kind: "police", at: [200, -200] },
+      { kind: "market", at: [300, 200] },
+      { kind: "gas_station", at: [1500, 1550] }
+    ]
+  },
+  {
+    id: "port_city",
+    scale: "city",
+    size: [4e3, 3e3],
+    text: { "pt-BR": { name: "Cidade portu\xE1ria", description: "Cais e armaz\xE9ns na margem, centro hist\xF3rico atr\xE1s do porto e bairros subindo o morro." }, en: { name: "Port city", description: "Quays and warehouses on the shore, old town behind the port and neighbourhoods up the hill." } },
+    districts: [
+      { id: "outskirts", kind: "rural", rect: [-2e3, -1500, 2e3, 1500] },
+      { id: "hill", kind: "residential_low", rect: [500, -1500, 2e3, -200] },
+      { id: "res", kind: "residential_mid", rect: [-300, -500, 1300, 900] },
+      { id: "industry", kind: "industrial", rect: [800, 500, 2e3, 1500] },
+      { id: "port", kind: "port", rect: [-2e3, -1300, -900, 1100] },
+      { id: "old_town", kind: "historic", rect: [-900, -800, 200, 400] },
+      { id: "center", kind: "commercial_center", rect: [-500, -400, 200, 100] },
+      { id: "stilts", kind: "stilt", rect: [-2e3, 1e3, -1200, 1500] }
+    ],
+    lines: [
+      { id: "shore", kind: "river", width: 60, points: [[-2e3, -1500], [-1950, 0], [-1900, 1500]] },
+      { id: "main", kind: "avenue", width: 20, points: [[-900, 0], [2e3, 0]] },
+      { id: "rail", kind: "rail", width: 12, points: [[-1200, -1500], [-1e3, -400]] }
+    ],
+    landmarks: [
+      { kind: "harbour_office", at: [-1200, 0] },
+      { kind: "church", at: [-300, -200] },
+      { kind: "market", at: [-600, 200] },
+      { kind: "lighthouse", at: [1600, -1300] },
+      { kind: "hospital", at: [700, 200] }
+    ]
+  },
+  {
+    id: "rail_town",
+    scale: "town",
+    size: [3e3, 3e3],
+    text: { "pt-BR": { name: "Cidade ferrovi\xE1ria", description: "Cidade que cresceu em volta da esta\xE7\xE3o: p\xE1tio, centro velho, vila da companhia." }, en: { name: "Rail town", description: "A town grown around its station: rail yard, old centre, company village." } },
+    districts: [
+      { id: "outskirts", kind: "rural", rect: [-1500, -1500, 1500, 1500] },
+      { id: "res", kind: "residential_low", rect: [500, 500, 1500, 1500] },
+      { id: "logistics", kind: "logistics", rect: [500, -700, 1500, 500] },
+      { id: "popular", kind: "residential_popular", rect: [-1500, 600, -300, 1500] },
+      { id: "company", kind: "company_housing", rect: [-1500, -800, -700, 500] },
+      { id: "yard", kind: "rail_yard", rect: [-700, 0, 500, 500] },
+      { id: "old_center", kind: "historic", rect: [-500, -700, 500, 0] }
+    ],
+    lines: [
+      { id: "rail", kind: "rail", width: 12, points: [[-1500, 250], [1500, 250]] },
+      { id: "highway", kind: "highway", width: 24, points: [[-1500, -100], [1500, -200]] }
+    ],
+    landmarks: [
+      { kind: "station", at: [0, 100] },
+      { kind: "church", at: [0, -400] },
+      { kind: "gas_station", at: [1e3, -150] }
+    ]
+  },
+  {
+    id: "country_town",
+    scale: "town",
+    size: [2400, 2400],
+    text: { "pt-BR": { name: "Cidade do interior", description: "Pra\xE7a da matriz no meio, com\xE9rcio t\xE9rreo em volta, casas, cooperativa e s\xEDtios em volta." }, en: { name: "Country town", description: "Main square with the church, ground-floor shops around, houses, a co-op and smallholdings." } },
+    districts: [
+      { id: "farms", kind: "farmland", rect: [-1200, -1200, 1200, 1200] },
+      { id: "chacaras", kind: "rural", rect: [-900, -900, 900, 900] },
+      { id: "houses", kind: "residential_low", rect: [-600, -600, 600, 500] },
+      { id: "company", kind: "company_housing", rect: [-700, 350, -250, 700] },
+      { id: "coop", kind: "farmland", rect: [350, 500, 900, 900], floors: [1, 1], uses: { agricultural: 0.5, industrial: 0.5 } },
+      { id: "center", kind: "historic", rect: [-250, -250, 250, 250] },
+      { id: "square", kind: "park", rect: [-60, -60, 60, 60] }
+    ],
+    lines: [
+      { id: "main", kind: "street", width: 12, points: [[-1200, 0], [1200, 0]] },
+      { id: "road", kind: "street", width: 8, points: [[0, -1200], [0, 1200]] }
+    ],
+    landmarks: [
+      { kind: "church", at: [0, -70] },
+      { kind: "market", at: [120, 80] },
+      { kind: "school", at: [-300, -200] },
+      { kind: "gas_station", at: [700, 0] },
+      { kind: "silo", at: [600, 700] }
+    ]
+  },
+  {
+    id: "mountain_village",
+    scale: "village",
+    size: [1600, 1200],
+    text: { "pt-BR": { name: "Vila serrana", description: "Largo da igreja, rua das pousadas subindo a serra e chal\xE9s espalhados na encosta." }, en: { name: "Mountain village", description: "Church square, a street of inns up the slope and chalets scattered on the hill." } },
+    districts: [
+      { id: "wild", kind: "wild", rect: [-800, -600, 800, 600] },
+      { id: "slope", kind: "rural", rect: [-700, -500, 700, 500] },
+      { id: "resort", kind: "hillside_resort", rect: [-400, -450, 500, 0] },
+      { id: "square", kind: "historic", rect: [-250, 0, 250, 300] },
+      { id: "station", kind: "rail_yard", rect: [300, 150, 700, 450] }
+    ],
+    lines: [
+      { id: "road", kind: "street", width: 7, points: [[-800, 200], [0, 150], [800, 300]] }
+    ],
+    landmarks: [
+      { kind: "church", at: [0, 150] },
+      { kind: "inn", at: [100, -200] },
+      { kind: "station", at: [500, 300] }
+    ]
+  }
+];
+
+// src/cities/cities.ts
+var DEFAULT_MAX_FLOORS = 60;
+var DEFAULT_STREET = 10;
+var DEFAULT_LOCALE2 = "pt-BR";
+var DEFAULT_STOREY_PRESETS2 = { commercial: "office", residential: "residential" };
+var text = (by, locale) => by[locale] ?? by[DEFAULT_LOCALE2];
+var named = (name, locale) => typeof name === "string" || name === void 0 ? name : name[locale] ?? name[DEFAULT_LOCALE2];
+var mergeLists = (parent, own) => {
+  const list = [...parent];
+  for (const item of own) {
+    const at = list.findIndex((p) => p.id === item.id);
+    if (at >= 0) list[at] = item;
+    else list.push(item);
+  }
+  return list;
+};
+function createCities(o) {
+  const maxFloors = o.maxFloors ?? DEFAULT_MAX_FLOORS;
+  const kindEntries = mergeById(DEFAULT_DISTRICT_KINDS, o.packs?.kinds);
+  applyPatches(kindEntries, o.patch?.kinds);
+  removeIds(kindEntries, o.remove?.kinds);
+  const planEntries = mergeById(DEFAULT_CITY_PLANS, o.packs?.plans);
+  applyPatches(planEntries, o.patch?.plans);
+  removeIds(planEntries, o.remove?.plans);
+  const registry = (entries, label) => ({
+    ids: () => [...entries.keys()],
+    list: () => [...entries.values()],
+    has: (id) => entries.has(id),
+    get(id) {
+      const entry = entries.get(id);
+      if (!entry) throw new Error(`Unknown ${label} "${id}"`);
+      return entry;
+    }
+  });
+  const kinds = registry(kindEntries, "district kind");
+  const rawPlans = registry(planEntries, "city plan");
+  const resolvePlan = (plan, seen = []) => {
+    if (seen.includes(plan.id)) throw new Error(`City plan "${plan.id}" extends itself (${[...seen, plan.id].join(" > ")})`);
+    const parent = plan.extends ? resolvePlan(rawPlans.get(plan.extends), [...seen, plan.id]) : void 0;
+    const scale = plan.scale ?? parent?.scale;
+    const size = plan.size ?? parent?.size;
+    const planText = plan.text ?? parent?.text;
+    if (!scale || !size || !planText) throw new Error(`City plan "${plan.id}" has no ${!scale ? "scale" : !size ? "size" : "text"}`);
+    return {
+      id: plan.id,
+      scale,
+      size,
+      text: planText,
+      extends: plan.extends,
+      districts: mergeLists(parent?.districts ?? [], plan.districts ?? []),
+      lines: mergeLists(parent?.lines ?? [], plan.lines ?? []),
+      landmarks: [...parent?.landmarks ?? [], ...plan.landmarks ?? []]
+    };
+  };
+  const plans = {
+    ...rawPlans,
+    /** The plan with everything inherited from the plans it extends. */
+    resolve: (id) => resolvePlan(rawPlans.get(id))
+  };
+  const layout = (planOrId, options = {}) => {
+    const plan = typeof planOrId === "string" ? plans.resolve(planOrId) : resolvePlan(planOrId);
+    const locale = options.locale ?? DEFAULT_LOCALE2;
+    const cap = Math.max(0, options.maxFloors ?? maxFloors);
+    const clamp2 = (n) => Math.min(cap, Math.max(0, n));
+    const districts = plan.districts.map((d) => {
+      const kind = kinds.get(d.kind);
+      const kindText = text(kind.text, locale);
+      const [lo, hi] = d.floors ?? kind.floors;
+      return {
+        id: d.id,
+        kind: kind.id,
+        rect: d.rect,
+        name: named(d.name, locale) ?? kindText.name,
+        description: kindText.description,
+        color: kind.color,
+        zone: kind.zone,
+        pattern: kind.pattern,
+        floors: [clamp2(lo), clamp2(hi)],
+        uses: d.uses ?? kind.uses,
+        block: kind.block
+      };
+    });
+    const inside = (d, x, z) => x >= d.rect[0] && x <= d.rect[2] && z >= d.rect[1] && z <= d.rect[3];
+    const districtAt = (x, z) => {
+      for (let i = districts.length - 1; i >= 0; i--) if (inside(districts[i], x, z)) return districts[i];
+      return void 0;
+    };
+    const blocks = (districtId, bo = {}) => {
+      const d = districts.find((x) => x.id === districtId);
+      if (!d) throw new Error(`City plan "${plan.id}" has no district "${districtId}"`);
+      const street = bo.street ?? DEFAULT_STREET;
+      const cell = d.block;
+      const side = cell - street;
+      if (cell <= 0 || side <= 0) return [];
+      const [x0, z0, x1, z1] = d.rect;
+      const cols = Math.floor((x1 - x0) / cell);
+      const rows = Math.floor((z1 - z0) / cell);
+      const ox = x0 + (x1 - x0 - cols * cell) / 2;
+      const oz = z0 + (z1 - z0 - rows * cell) / 2;
+      const found = [];
+      for (let i = 0; i < cols; i++) {
+        for (let j = 0; j < rows; j++) {
+          const x = ox + cell * (i + 0.5);
+          const z = oz + cell * (j + 0.5);
+          if (districtAt(x, z)?.id !== d.id) continue;
+          found.push({ x, z, size: [side, side], district: d.id, building: { floors: d.floors, uses: d.uses, zone: d.zone, pattern: d.pattern } });
+        }
+      }
+      return found;
+    };
+    const landmarks = plan.landmarks.map((l) => {
+      const { name, ...rest } = l;
+      const label = named(name, locale);
+      return label === void 0 ? rest : { ...rest, name: label };
+    });
+    const planText = text(plan.text, locale);
+    return { id: plan.id, scale: plan.scale, size: plan.size, name: planText.name, description: planText.description, districts, lines: [...plan.lines], landmarks, districtAt, blocks };
+  };
+  const stats = (l) => {
+    const xs = [...new Set(l.districts.flatMap((d) => [d.rect[0], d.rect[2]]))].sort((a, b) => a - b);
+    const zs = [...new Set(l.districts.flatMap((d) => [d.rect[1], d.rect[3]]))].sort((a, b) => a - b);
+    const area = /* @__PURE__ */ new Map();
+    let total = 0;
+    for (let i = 0; i + 1 < xs.length; i++) {
+      for (let j = 0; j + 1 < zs.length; j++) {
+        const x0 = xs[i];
+        const z0 = zs[j];
+        const w = xs[i + 1] - x0;
+        const d = zs[j + 1] - z0;
+        const owner = l.districtAt(x0 + w / 2, z0 + d / 2);
+        if (!owner) continue;
+        area.set(owner.kind, (area.get(owner.kind) ?? 0) + w * d);
+        total += w * d;
+      }
+    }
+    const count = /* @__PURE__ */ new Map();
+    for (const d of l.districts) count.set(d.kind, (count.get(d.kind) ?? 0) + 1);
+    return [...count.keys()].map((kind) => ({ kind, area: area.get(kind) ?? 0, share: total > 0 ? (area.get(kind) ?? 0) / total : 0, districts: count.get(kind) ?? 0 })).sort((a, b) => b.area - a.area);
+  };
+  const fillBlock2 = (b, block, options = {}) => {
+    const { floors, uses, pattern } = block.building;
+    if (floors[1] <= 0 || pattern === null) return [];
+    const { shop, ...rest } = options;
+    const storey = options.storeyHeight ?? o.presets.find((p) => p.id === DEFAULT_STOREY_PRESETS2.residential)?.storeyHeight ?? o.presets[0]?.storeyHeight;
+    return o.fill(b, {
+      cx: block.x,
+      cz: block.z,
+      size: Math.min(block.size[0], block.size[1]),
+      minHeight: floors[0] * storey,
+      maxHeight: floors[1] * storey,
+      floors: [floors[0], floors[1]],
+      uses,
+      shop: shop ?? uses.commercial ?? 0,
+      ...rest
+    });
+  };
+  return { maxFloors, kinds, plans, layout, stats, fillBlock: fillBlock2 };
+}
+
 // src/terrain/math.ts
 var clamp = (v, a, b) => v < a ? a : v > b ? b : v;
 var lerp2 = (a, b, t) => a + (b - a) * t;
@@ -922,17 +1394,20 @@ function drawTerrain(b, terrain, segments) {
 var DEFAULT_LIGHT_BUDGET = 16;
 var DEFAULT_URBAN_SEED = 7;
 function createUrban(options = {}) {
-  const entries = mergeById(DEFAULT_POLES, options.packs?.poles);
-  applyPatches(entries, options.patch?.poles);
-  removeIds(entries, options.remove?.poles);
+  const entries = mergeById2(DEFAULT_POLES, options.packs?.poles);
+  applyPatches2(entries, options.patch?.poles);
+  removeIds2(entries, options.remove?.poles);
   const shapes = { ...POLE_SHAPES, ...options.shapes };
-  const patterns = mergeById(DEFAULT_PATTERNS, options.packs?.neighbourhoods);
-  applyPatches(patterns, options.patch?.neighbourhoods);
-  removeIds(patterns, options.remove?.neighbourhoods);
+  const patterns = mergeById2(DEFAULT_PATTERNS, options.packs?.neighbourhoods);
+  applyPatches2(patterns, options.patch?.neighbourhoods);
+  removeIds2(patterns, options.remove?.neighbourhoods);
   const composers = { ...COMPOSERS, ...options.composers };
   const lightBudget = options.lights?.budget ?? DEFAULT_LIGHT_BUDGET;
   const facades = options.facades ?? DEFAULT_FACADES;
   const propColors = { ...DEFAULT_PROP_COLORS, ...options.props };
+  const towers = options.towers ? options.towers === true ? {} : options.towers : null;
+  const building = (b, x, z, width, depth, height, color, o) => drawBuilding(b, x, z, width, depth, height, color, o);
+  const drawBlockBuilding = towers ? createTowerDrawer(towers, building) : building;
   const poles = {
     ids: () => [...entries.keys()],
     list: () => [...entries.values()],
@@ -954,8 +1429,8 @@ function createUrban(options = {}) {
     },
     block: {
       facades,
-      building: (b, x, z, width, depth, height, color, o) => drawBuilding(b, x, z, width, depth, height, color, o),
-      fill: (b, g) => fillBlock(b, g.cx, g.cz, g.size, g.minHeight, g.maxHeight, { palette: facades, ...g })
+      building: drawBlockBuilding,
+      fill: (b, g) => fillBlock(b, g.cx, g.cz, g.size, g.minHeight, g.maxHeight, { palette: facades, draw: drawBlockBuilding, ...towers?.presets ? { presets: towers.presets } : {}, ...g })
     },
     props: {
       fence: drawFence,
@@ -998,7 +1473,15 @@ function createUrban(options = {}) {
     }
   };
   const terrain = (o) => createTerrain(o);
-  return { ...core, poles, builder, neighbourhoods, terrain, drawTerrain };
+  const cities = createCities({
+    maxFloors: options.cities?.maxFloors,
+    packs: { kinds: options.packs?.districtKinds, plans: options.packs?.cityPlans },
+    patch: { kinds: options.patch?.districtKinds, plans: options.patch?.cityPlans },
+    remove: { kinds: options.remove?.districtKinds, plans: options.remove?.cityPlans },
+    presets: towers?.presets ?? DEFAULT_TOWER_PRESETS,
+    fill: core.block.fill
+  });
+  return { ...core, poles, cities, builder, neighbourhoods, terrain, drawTerrain, towers: { enabled: towers !== null, options: towers } };
 }
 
 // src/neighbourhoods/providers.ts
@@ -1036,27 +1519,67 @@ function createPlantProvider(options = {}) {
     b.place("plant", id, request.x, request.z, { scale: request.scale, seed: key });
   };
 }
+
+// src/neighbourhoods/towers.ts
+var financialDistrict = {
+  id: "financial_district",
+  streetWidth: 16,
+  walkWidth: 4,
+  typologies: ["office_tower", "residential_tower"],
+  pole: "led_double",
+  lightColor: 14674175,
+  spacing: 25,
+  lit: 1,
+  compose: "downtown",
+  marker: { height: 40 },
+  text: {
+    "pt-BR": { label: "Distrito financeiro", title: "DISTRITO FINANCEIRO", caption: "avenida 2 \xD7 8 m \xB7 torres de 70 a 180 m", detail: "Torres de escrit\xF3rios e residenciais de 70 a 180 m. Poste met\xE1lico duplo, LED branco." },
+    en: { label: "Financial district", title: "FINANCIAL DISTRICT", caption: "avenue 2 \xD7 8 m \xB7 towers of 70 to 180 m", detail: "Office and residential towers of 70 to 180 m. Double steel pole, white LED." }
+  },
+  params: {
+    roadLength: 110,
+    roadColor: 2237480,
+    median: { width: 1.6, height: 0.18, color: 3820076 },
+    poles: { from: -50, to: 50 },
+    buildings: { perRow: 4, first: -39, pitch: 26, rowOffset: 24, size: 20, north: { minHeight: 90, range: 90, lit: 0.12 }, south: { minHeight: 70, range: 80, lit: 0.1 } },
+    walks: { offset: 14, length: 110 },
+    car: { dx: -8, dz: -3, ry: 1.57, color: 7038032 }
+  }
+};
+var TOWER_PATTERNS = [financialDistrict];
+var TOWER_SAMPLE_CELLS = { financial_district: { x: 160, z: 56 } };
 export {
   COMPOSERS,
+  DEFAULT_CITY_PLANS,
+  DEFAULT_DISTRICT_KINDS,
   DEFAULT_FACADES,
   DEFAULT_LIGHT_BUDGET,
+  DEFAULT_MAX_FLOORS,
   DEFAULT_PATTERNS,
   DEFAULT_PLANT_CONTEXTS,
   DEFAULT_POLES,
   DEFAULT_PROP_COLORS,
   DEFAULT_ROAD_STYLE,
+  DEFAULT_STOREY_PRESETS,
+  DEFAULT_STREET,
+  DEFAULT_TOWER_PRESETS,
   DEFAULT_URBAN_SEED,
   DEFAULT_WALK_STYLE,
   PARKED_VEHICLE_IDS,
   POLE_SHAPES,
   SAMPLE_CELLS,
   SILHOUETTE_TYPOLOGIES,
+  TOWER_DEFAULTS,
+  TOWER_PATTERNS,
+  TOWER_SAMPLE_CELLS,
   clamp,
   composePattern,
+  createCities,
   createLightBudget,
   createPlantProvider,
   createSilhouetteHouses,
   createTerrain,
+  createTowerDrawer,
   createUrban,
   createUrbanBuilder,
   createVehicleProvider,
@@ -1072,6 +1595,7 @@ export {
   drawStripLabel,
   drawTent,
   drawTerrain,
+  drawTower,
   drawTree,
   drawWalk,
   drawWatchtower,
@@ -1082,6 +1606,9 @@ export {
   insideRect,
   lerp2 as lerp,
   patternMarker,
-  smoothstep
+  pickTowerPreset,
+  smoothstep,
+  towerPresetOf,
+  towerStoreys
 };
 //# sourceMappingURL=index.js.map