Crate amble_script 

amble_script – authoring-focused DSL, parser, and compiler for building Amble worlds.

The crate powers the amble_script CLI but is fully usable as a library. Major capabilities:

• Parse and lint .amble sources for rooms, items, triggers, spinners, NPCs, and goals, catching unresolved references early.
• Compile the DSL into structured TOML that the amble_engine crate consumes.
• Provide AST types so tooling can analyze or transform worlds before serialization.

use amble_script::{parse_rooms, compile_rooms_to_toml};

let src = r#"
room foyer {
  name "Foyer"
  desc "An inviting entryway."
}
"#;
let rooms = parse_rooms(src).expect("valid DSL");
let toml = compile_rooms_to_toml(&rooms).expect("compiles");
println!("{toml}");

For a full language tour see amble_script/docs/dsl_creator_handbook.md in the repository.

Structs

ActionStmt

Top-level action statement with optional priority metadata.

ConsumableAst

Consumable configuration attached to an item.

ExitAst

Connection between rooms emitted within a room AST.

GoalAst

High-level representation of a single goal definition in the DSL.

ItemAbilityAst

Single item ability entry declared within an item.

ItemAst

AST node describing an item definition.

ItemPatchAst

Data patch applied to an item when executing a modify item action.

NpcAst

AST node describing an NPC definition.

NpcDialoguePatchAst

NPC dialogue line update used inside a modify npc action.

NpcMovementAst

Movement configuration emitted for NPCs.

NpcMovementPatchAst

Movement configuration updates for an NPC.

NpcPatchAst

Data patch applied to an NPC when executing a modify npc action.

OverlayAst

Conditional overlay text applied to a room.

RoomAst

Minimal AST for a room definition. AST node describing a compiled room definition.

RoomExitPatchAst

Exit data emitted inside a modify room action patch.

RoomPatchAst

Data patch applied to a room when executing a modify room action.

SpinnerAst

Spinner definition containing weighted text wedges.

SpinnerWedgeAst

Individual wedge (value + weight) inside a spinner.

TriggerAst

A minimal AST for a single trigger.

Enums

ActionAst

Minimal action variants.

AstError

Errors that can happen when parsing the DSL input.

CompileError

Errors that can occur while compiling the AST to TOML.

ConditionAst

Trigger condition variants.

ConsumableWhenAst

Behavior when a consumable item is depleted.

ContainerStateAst

Container states expressible in the DSL.

GoalCondAst

Conditions that can activate, complete, or fail a goal.

GoalGroupAst

Logical grouping for goals used when rendering score breakdowns.

IngestModeAst

Ingestion modes supported by the DSL; mirrors engine IngestMode.

ItemLocationAst

Possible item locations in the DSL.

NpcLocationAst

Location specifier used for NPC placement.

NpcMovementTypeAst

Movement types supported for NPC definitions.

NpcStateValue

NPC state reference used in overlays and patches.

NpcTimingPatchAst

Movement timing update for an NPC.

OnFalseAst

Policy to apply when a scheduled condition evaluates to false at fire time.

OverlayCondAst

Overlay predicate used when computing room description variants.

Functions

compile_goals_to_toml

Compile goals into TOML string matching amble_engine/data/goals.toml structure.

compile_items_to_toml

Compile items into TOML string matching amble_engine/data/items.toml structure.

compile_npcs_to_toml

Compile NPCs into TOML string matching amble_engine/data/npcs.toml structure.

compile_rooms_to_toml

Compile rooms into TOML string matching amble_engine/data/rooms.toml structure.

compile_spinners_to_toml

Compile spinners into TOML string matching amble_engine/data/spinners.toml structure.

compile_trigger_to_toml

Compile a TriggerAst into a TOML string representing one RawTrigger.

compile_triggers_to_toml

Compile multiple triggers into a single TOML string with one triggers array.

parse_goals

Parse only goal definitions from the given source.

parse_items

Parse only items from a source (helper/testing). Parse only item definitions from the given source.

parse_npcs

Parse only npcs from a source (helper/testing). Parse only NPC definitions from the given source.

parse_program

Parse multiple triggers from a full source file (triggers only view).

parse_program_full

Parse a full program returning triggers, rooms, items, and spinners.

parse_rooms

Parse only rooms from a source (helper/testing). Parse only room definitions from the given source.

parse_spinners

Parse only spinners from a source (helper/testing). Parse only spinner definitions from the given source.

parse_trigger

Parse a single trigger source string; returns the first trigger found.