Files
detective/types.ts

91 lines
2.4 KiB
TypeScript

// ActionArgs is a union of all the different argument types that can be used with an
// action
export type ActionArgs = ApplyEffectArgs;
// ApplyEffectArgs are the arguments required to apply effects to a player or scene
export interface ApplyEffectArgs extends Args {
effect: string;
applyTo: "player" | "scene";
reversible: boolean;
reverseResult?: string;
}
// ApplyEffectItemAction describes the apply effect action
export interface ApplyEffectItemAction extends ItemAction {
type: "applyEffect";
args: ApplyEffectArgs;
}
// Args is a base interface for the various argument interfaces
export interface Args {
result: string;
}
// Conditions contains story elements that can be conditionally applied to the scene or
// player
export interface Conditions<T extends EntityProperties> {
effects: Effect<T>[];
}
// Direction is union that contains the different directions a player can go
export type Direction =
| "north"
| "northeast"
| "east"
| "southest"
| "south"
| "southwest"
| "west"
| "northwest"
| "up"
| "down";
// Effect represents some effect that may be applied to a scene or player
export interface Effect<T extends EntityProperties> {
name: string;
properties: T;
source: "player" | "scene"; // where the effect is applied
}
// Exit describes the exits that the user can take to go to another scene
export interface Exit {
description: string;
direction: Direction;
scene: string;
}
// Item represents some item either in the scene or in the player's inventory
export interface Item {
name: string;
actions?: { [name: string]: ItemAction };
}
// ItemActionType is a union of all the types of action that can be used
export type ItemActionType = "applyEffect";
// ItemAction represents an action that can be taken by an item
export interface ItemAction {
type: ItemActionType;
args: ActionArgs;
}
// SceneProperties are the properties (in addition to the EntityProperties) that are
// needed by the scene
export interface SceneProperties extends EntityProperties {
description?: string;
exits?: Exit[];
name?: string;
}
// StoryScene holds both the conditions and properties for a scene.
export interface StoryScene<T extends EntityProperties> {
identifier: string;
conditions: Conditions<T>;
properties: SceneProperties;
}
// EntityProperties is a base interface for the properties that a user or scene might have
export interface EntityProperties {
items?: Item[];
}