delvewright-dsl 0.39.0

Staged JSON DSL types and schemas for Delvewright adventure-map campaigns — the format the delvec compiler reads.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

//! DSL v0.5 (spec-0010): declared world `time`/`weather` + per-area `lighting`
//! and the `set-time`/`set-weather` effect verbs validate under `0.5.0` and are
//! `lighting.min_light` is range-checked (`DW0196`).
//!
//! Built on the hello-world casting/quests/dialogue (unchanged, 0.2.0) with a
//! v0.5 stage-1 `world` document — additive fields, so the rest is untouched.

mod common;

use delvewright_dsl::{RawCampaign, check_campaign};
use std::sync::LazyLock;

/// A v0.5 stage-1 world document declaring time, weather and an area `lighting`.
static WORLD_V05: LazyLock<String> = LazyLock::new(|| {
    common::at_dsl_version(
        r#"{
  "dsl_version": "%dsl_version%",
  "campaign_id": "hello-world",
  "stage": "world",
  "content": {
    "title": "The Keeper's Door",
    "theme": "A lonely keep at the edge of the moor.",
    "premise": "One locked door stands between you and the road home.",
    "seed": 20260729,
    "target_minutes": 5,
    "time": "midnight",
    "weather": "thunder",
    "areas": [
      {
        "id": "area/keep",
        "name": "The Keep",
        "prefab": "prefab/hello-room",
        "lighting": { "fixture": "lantern", "min_light": 9 }
      }
    ]
  }
}"#,
    )
});

fn campaign_with_world(world: &str) -> RawCampaign {
    RawCampaign {
        world: world.to_string(),
        npcs: common::read_valid("npcs.json"),
        classes: common::read_valid("classes.json"),
        quest_plan: common::read_valid("quest-plan.json"),
        quests: common::read_valid("quests.json"),
        dialogue: common::read_valid("dialogue.json"),
        world_edits: None,
        geometry_brief: None,
        layout_graph: None,
        site_plan: None,
        detail_plan: None,
        design: None,
    }
}

/// v0.5 time/weather/lighting validate clean under `dsl_version 0.5.0`.
#[test]
fn v05_world_surface_validates_clean() {
    let diags = check_campaign(&campaign_with_world(WORLD_V05.as_str()));
    assert!(
        diags.is_empty(),
        "expected zero diagnostics for the v0.5 world surface, got: {diags:#?}"
    );
}

/// `lighting.min_light` outside 1..=14 is `DW0196`.
#[test]
fn v05_min_light_out_of_range_is_dw0196() {
    let bad = WORLD_V05.replacen("\"min_light\": 9", "\"min_light\": 15", 1);
    let diags = check_campaign(&campaign_with_world(&bad));
    assert!(
        diags.iter().any(|d| d.code == "DW0196"),
        "min_light 15 must be DW0196 (range 1..=14): {diags:#?}"
    );
}