@bendyline/molen-ambient 0.0.9 → 0.0.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,87 @@
1
+ import { z } from "zod";
2
+
3
+ //#region src/kernel/wildlife-types.d.ts
4
+ declare const WILDLIFE_FAMILIES: readonly ["ungulate", "canid", "feline", "rodent", "lagomorph", "hopper", "elephant", "bird", "reptile", "fish", "insect"];
5
+ type WildlifeFamily = (typeof WILDLIFE_FAMILIES)[number];
6
+ type WildlifeMotion = "walk" | "hop" | "fly" | "swim" | "crawl";
7
+ interface WildlifeSpecies {
8
+ id: string;
9
+ version: number;
10
+ title: string;
11
+ /** Omitted for functional habitat groups that make no precise species claim. */
12
+ taxon?: string;
13
+ /** Identifier in an attributed range document. Named taxa require a range at the Earth binding. */
14
+ range?: string;
15
+ /** Coarse seasonal appearance/activity; not a weather or migration model. */
16
+ winterColor?: string;
17
+ inactiveInWinter?: boolean;
18
+ body: {
19
+ family: WildlifeFamily; /** Meters: standing height, nose-to-rump length, torso width. Wings and tails may extend them. */
20
+ height: number;
21
+ length: number;
22
+ width: number;
23
+ color: string;
24
+ accent: string;
25
+ details: Array<"antlers" | "horns" | "long-neck" | "bushy-tail" | "stripes" | "spots" | "wader" | "waterfowl" | "raptor" | "parrot" | "long-tail">;
26
+ };
27
+ motion: WildlifeMotion;
28
+ /** Meters per second. This is ambient travel, not maximum running speed. */
29
+ speed: number;
30
+ /** Maximum travel from the stable spawn anchor in meters. */
31
+ roam: number;
32
+ /** Height above ground/water for flight; depth below the surface for swimming. */
33
+ clearance: number;
34
+ /** Probability of resting at a target. Flying/swimming animals keep moving. */
35
+ rest: number;
36
+ /** Body-size clearance from obstacles, meters. */
37
+ margin: number;
38
+ }
39
+ /** Already selected by the host's regional/range resolver. Density is a visual population prior. */
40
+ interface WildlifeChoice {
41
+ species: WildlifeSpecies;
42
+ density: number;
43
+ habitats: readonly string[];
44
+ }
45
+ interface WildlifeHabitat {
46
+ /** Actual mapped surface, not potential vegetation from a biome map. */
47
+ kind: string;
48
+ height: number;
49
+ water: boolean;
50
+ /** False on roads, buildings, steep terrain, or insufficiently known terrain. */
51
+ safe: boolean;
52
+ }
53
+ declare const wildlifeSpeciesSchema: z.ZodType<WildlifeSpecies>;
54
+ //#endregion
55
+ //#region src/kernel/wildlife.d.ts
56
+ declare const WILDLIFE_TICK_RATE = 20;
57
+ declare const WILDLIFE_CELL_METERS = 96;
58
+ interface WildlifeAgent {
59
+ id: string;
60
+ species: string;
61
+ seed: number;
62
+ anchor: [number, number];
63
+ position: [number, number, number];
64
+ target: [number, number];
65
+ heading: number;
66
+ speed: number;
67
+ since: number;
68
+ nextDecision: number;
69
+ decisions: number;
70
+ phase: number;
71
+ }
72
+ interface WildlifeWorld {
73
+ choices(x: number, z: number): readonly WildlifeChoice[];
74
+ habitat(x: number, z: number, margin: number): WildlifeHabitat | undefined;
75
+ }
76
+ interface WildlifeBudget {
77
+ animals: number;
78
+ radius: number;
79
+ /** 0..1 stable thinning. Changing quality keeps existing candidate identities. */
80
+ density: number;
81
+ }
82
+ /** Stable world-grid candidates. Adding an unrelated species does not reroll an existing one. */
83
+ declare function wildlifeCandidates(world: WildlifeWorld, observer: readonly [number, number, number], budget: WildlifeBudget, tick?: number): WildlifeAgent[];
84
+ /** Advance one 1/20-second step. A host can snapshot these plain records without hidden state. */
85
+ declare function stepWildlife(agents: readonly WildlifeAgent[], speciesById: ReadonlyMap<string, WildlifeSpecies>, world: WildlifeWorld, tick: number): WildlifeAgent[];
86
+ //#endregion
87
+ export { WildlifeWorld as a, WILDLIFE_FAMILIES as c, WildlifeHabitat as d, WildlifeMotion as f, WildlifeBudget as i, WildlifeChoice as l, wildlifeSpeciesSchema as m, WILDLIFE_TICK_RATE as n, stepWildlife as o, WildlifeSpecies as p, WildlifeAgent as r, wildlifeCandidates as s, WILDLIFE_CELL_METERS as t, WildlifeFamily as u };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bendyline/molen-ambient",
3
- "version": "0.0.9",
3
+ "version": "0.0.11",
4
4
  "private": false,
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -42,14 +42,14 @@
42
42
  ],
43
43
  "dependencies": {
44
44
  "zod": "^4.6.5",
45
- "@bendyline/molen-kernel": "0.0.6",
46
- "@bendyline/molen-terrain": "0.0.9",
47
- "@bendyline/molen-schema": "0.0.6",
48
- "@bendyline/molen-figures": "0.0.8"
45
+ "@bendyline/molen-figures": "0.0.9",
46
+ "@bendyline/molen-schema": "0.0.7",
47
+ "@bendyline/molen-kernel": "0.0.7",
48
+ "@bendyline/molen-terrain": "0.0.11"
49
49
  },
50
50
  "peerDependencies": {
51
51
  "three": ">=0.184.0 <0.187.0",
52
- "@bendyline/molen-client": "0.0.8"
52
+ "@bendyline/molen-client": "0.0.9"
53
53
  },
54
54
  "peerDependenciesMeta": {
55
55
  "@bendyline/molen-client": {
@@ -67,7 +67,7 @@
67
67
  "tsdown": "^0.22.2",
68
68
  "typescript": "^6.0.3",
69
69
  "vitest": "^5.0.1",
70
- "@bendyline/molen-client": "0.0.8"
70
+ "@bendyline/molen-client": "0.0.9"
71
71
  },
72
72
  "scripts": {
73
73
  "build": "tsdown",