chore: sync with pumpkin wit

.gitignore

@@ -0,0 +1,43 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.idea/
+.vscode/
+
+# Wasm files
+*.wasm

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "src/pumpkin_api/wit_files/repo"]
+	path = src/pumpkin_api/wit_files/repo
+	url = https://github.com/Pumpkin-MC/Pumpkin.git

README.md

@@ -24,7 +24,8 @@ class MyPlugin(Plugin):
             name="my-plugin",
             version="0.1.0",
             authors=["you"],
-            description="An example plugin."
+            description="An example plugin.",
+            dependencies=[]
         )
 
     def on_load(self, ctx: context.Context) -> None:

example/main.py

@@ -10,7 +10,8 @@ class MyPlugin(Plugin):
             name="my-plugin",
             version="0.1.0",
             authors=["you"],
-            description="An example python plugin."
+            description="An example python plugin.",
+            dependencies=[]
         )
 
     def on_load(self, ctx: context.Context) -> None:

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pumpkin-api-py"
-version = "0.1.0.dev0"
+version = "0.1.0.dev1"
 description = "Pumpkin plugin API for Python"
 authors = [{name = "alex"}]
 license = "GPL-3.0-only"
@@ -17,6 +17,30 @@ pumpkin-api-build = "pumpkin_api.build:main"
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/pumpkin_api",
+]
+
 [tool.hatch.build.targets.wheel]
 packages = ["src/pumpkin_api"]
-include = ["src/pumpkin_api/wit_files/**/*.wit"]
+
+[tool.hatch.build.targets.wheel.sources]
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/block-entity.wit" = "pumpkin_api/wit_files/block-entity.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/command.wit" = "pumpkin_api/wit_files/command.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/common.wit" = "pumpkin_api/wit_files/common.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/context.wit" = "pumpkin_api/wit_files/context.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/entity.wit" = "pumpkin_api/wit_files/entity.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/event.wit" = "pumpkin_api/wit_files/event.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/gui.wit" = "pumpkin_api/wit_files/gui.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/i18n.wit" = "pumpkin_api/wit_files/i18n.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/log.wit" = "pumpkin_api/wit_files/log.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/metadata.wit" = "pumpkin_api/wit_files/metadata.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/permission.wit" = "pumpkin_api/wit_files/permission.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/player.wit" = "pumpkin_api/wit_files/player.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/plugin.wit" = "pumpkin_api/wit_files/plugin.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/scheduler.wit" = "pumpkin_api/wit_files/scheduler.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/scoreboard.wit" = "pumpkin_api/wit_files/scoreboard.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/server.wit" = "pumpkin_api/wit_files/server.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/text.wit" = "pumpkin_api/wit_files/text.wit"
+"src/pumpkin_api/wit_files/repo/pumpkin-plugin-wit/v0.1.0/world.wit" = "pumpkin_api/wit_files/world.wit"

src/pumpkin_api/__init__.py

@@ -23,7 +23,7 @@ from typing import Dict, Callable, Any, Type, Optional, List, Union
 from .wit.wit_world.imports import (
     server, event, command, context, text, scheduler, 
     logging, gui, scoreboard, i18n, player, world, 
-    common, entity, permission
+    common, block_entity, permission
 )
 from .wit.wit_world.exports import metadata
 from componentize_py_types import Err

src/pumpkin_api/build.py

@@ -11,6 +11,10 @@ def main():
 
     import pumpkin_api
     pkg_dir = os.path.dirname(pumpkin_api.__file__)
+    # In source checkout, they are in wit_files/repo/...
+    # In installed package, they are directly in wit_files/
+    wit_dir = os.path.join(pkg_dir, "wit_files", "repo", "pumpkin-plugin-wit", "v0.1.0")
+    if not os.path.exists(wit_dir):
         wit_dir = os.path.join(pkg_dir, "wit_files")
     
     # Pass the parent directory of pumpkin_api to componentize-py so it can resolve `pumpkin_api` module

src/pumpkin_api/wit/wit_world/exports/metadata.py

@@ -19,4 +19,5 @@ class PluginMetadata:
     version: str
     authors: List[str]
     description: str
+    dependencies: List[str]
 

src/pumpkin_api/wit/wit_world/imports/block_entity.py

@@ -74,11 +74,11 @@ class CommandBlockEntity:
 
 
 @dataclass
-class Entity_CommandBlockEntity:
+class BlockEntityType_CommandBlockEntity:
     value: CommandBlockEntity
 
 
-Entity = Union[Entity_CommandBlockEntity]
+BlockEntityType = Union[BlockEntityType_CommandBlockEntity]
 
 
 

src/pumpkin_api/wit/wit_world/imports/command.py

@@ -9,7 +9,7 @@ import weakref
 
 from componentize_py_types import Result, Ok, Err, Some
 from ..imports import common
-from ..imports import entity
+from ..imports import block_entity
 from ..imports import text
 from ..imports import world
 from ..imports import player
@@ -95,12 +95,12 @@ NotInBounds = Union[NotInBounds_LowerBound, NotInBounds_UpperBound]
 
 @dataclass
 class Arg_Entities:
-    value: List[entity.Entity]
+    value: List[world.Entity]
 
 
 @dataclass
 class Arg_Entity:
-    value: entity.Entity
+    value: world.Entity
 
 
 @dataclass
@@ -269,7 +269,7 @@ class CommandSenderType_Player:
 
 @dataclass
 class CommandSenderType_CommandBlock:
-    value: Tuple[entity.CommandBlockEntity, world.World]
+    value: Tuple[block_entity.CommandBlockEntity, world.World]
 
 
 @dataclass

src/pumpkin_api/wit/wit_world/imports/common.py

@@ -77,6 +77,29 @@ class ItemStack:
     registry_key: str
     count: int
 
+class EntityPose(Enum):
+    """
+    Represents the various poses an entity can be in.
+    """
+    STANDING = 0
+    FALL_FLYING = 1
+    SLEEPING = 2
+    SWIMMING = 3
+    SPIN_ATTACK = 4
+    CROUCHING = 5
+    LONG_JUMPING = 6
+    DYING = 7
+    CROAKING = 8
+    USING_TONGUE = 9
+    SITTING = 10
+    ROARING = 11
+    SNIFFING = 12
+    EMERGING = 13
+    DIGGING = 14
+    SLIDING = 15
+    SHOOTING = 16
+    INHALING = 17
+
 class Locale(Enum):
     """
     All Minecraft-supported locales.

src/pumpkin_api/wit/wit_world/imports/event.py

@@ -166,6 +166,12 @@ class PlayerToggleSneakEventData:
     is_sneaking: bool
     cancelled: bool
 
+@dataclass
+class PlayerToggleFlightEventData:
+    player: player.Player
+    is_flying: bool
+    cancelled: bool
+
 @dataclass
 class PlayerToggleSprintEventData:
     player: player.Player
@@ -271,16 +277,17 @@ class EventType(Enum):
     PLAYER_INTERACT_UNKNOWN_ENTITY_EVENT = 16
     PLAYER_INTERACT_EVENT = 17
     PLAYER_TOGGLE_SNEAK_EVENT = 18
-    PLAYER_TOGGLE_SPRINT_EVENT = 19
+    PLAYER_TOGGLE_FLIGHT_EVENT = 19
-    BLOCK_REDSTONE_EVENT = 20
+    PLAYER_TOGGLE_SPRINT_EVENT = 20
-    BLOCK_BREAK_EVENT = 21
+    BLOCK_REDSTONE_EVENT = 21
-    BLOCK_BURN_EVENT = 22
+    BLOCK_BREAK_EVENT = 22
-    BLOCK_CAN_BUILD_EVENT = 23
+    BLOCK_BURN_EVENT = 23
-    BLOCK_GROW_EVENT = 24
+    BLOCK_CAN_BUILD_EVENT = 24
-    BLOCK_PLACE_EVENT = 25
+    BLOCK_GROW_EVENT = 25
-    SERVER_COMMAND_EVENT = 26
+    BLOCK_PLACE_EVENT = 26
-    SPAWN_CHANGE_EVENT = 27
+    SERVER_COMMAND_EVENT = 27
-    SERVER_BROADCAST_EVENT = 28
+    SPAWN_CHANGE_EVENT = 28
+    SERVER_BROADCAST_EVENT = 29
 
 
 @dataclass
@@ -378,6 +385,11 @@ class Event_PlayerToggleSneakEvent:
     value: PlayerToggleSneakEventData
 
 
+@dataclass
+class Event_PlayerToggleFlightEvent:
+    value: PlayerToggleFlightEventData
+
+
 @dataclass
 class Event_PlayerToggleSprintEvent:
     value: PlayerToggleSprintEventData
@@ -428,7 +440,7 @@ class Event_ServerBroadcastEvent:
     value: ServerBroadcastEventData
 
 
-Event = Union[Event_PlayerJoinEvent, Event_PlayerLeaveEvent, Event_PlayerLoginEvent, Event_PlayerChatEvent, Event_PlayerCommandSendEvent, Event_PlayerPermissionCheckEvent, Event_PlayerMoveEvent, Event_PlayerTeleportEvent, Event_PlayerChangeWorldEvent, Event_PlayerExpChangeEvent, Event_PlayerItemHeldEvent, Event_PlayerChangedMainHandEvent, Event_PlayerGamemodeChangeEvent, Event_PlayerCustomPayloadEvent, Event_PlayerFishEvent, Event_PlayerEggThrowEvent, Event_PlayerInteractUnknownEntityEvent, Event_PlayerInteractEvent, Event_PlayerToggleSneakEvent, Event_PlayerToggleSprintEvent, Event_BlockRedstoneEvent, Event_BlockBreakEvent, Event_BlockBurnEvent, Event_BlockCanBuildEvent, Event_BlockGrowEvent, Event_BlockPlaceEvent, Event_ServerCommandEvent, Event_SpawnChangeEvent, Event_ServerBroadcastEvent]
+Event = Union[Event_PlayerJoinEvent, Event_PlayerLeaveEvent, Event_PlayerLoginEvent, Event_PlayerChatEvent, Event_PlayerCommandSendEvent, Event_PlayerPermissionCheckEvent, Event_PlayerMoveEvent, Event_PlayerTeleportEvent, Event_PlayerChangeWorldEvent, Event_PlayerExpChangeEvent, Event_PlayerItemHeldEvent, Event_PlayerChangedMainHandEvent, Event_PlayerGamemodeChangeEvent, Event_PlayerCustomPayloadEvent, Event_PlayerFishEvent, Event_PlayerEggThrowEvent, Event_PlayerInteractUnknownEntityEvent, Event_PlayerInteractEvent, Event_PlayerToggleSneakEvent, Event_PlayerToggleFlightEvent, Event_PlayerToggleSprintEvent, Event_BlockRedstoneEvent, Event_BlockBreakEvent, Event_BlockBurnEvent, Event_BlockCanBuildEvent, Event_BlockGrowEvent, Event_BlockPlaceEvent, Event_ServerCommandEvent, Event_SpawnChangeEvent, Event_ServerBroadcastEvent]
 
 
 

src/pumpkin_api/wit/wit_world/imports/player.py

@@ -35,6 +35,11 @@ class Player:
     A handle to a player on the server.
     """
     
+    def as_entity(self) -> world.Entity:
+        """
+        Returns the player as an entity.
+        """
+        raise NotImplementedError
     def get_id(self) -> str:
         """
         Returns the player's unique UUID as a string.

src/pumpkin_api/wit/wit_world/imports/world.py

@@ -8,6 +8,7 @@ from abc import abstractmethod
 import weakref
 
 from componentize_py_types import Result, Ok, Err, Some
+from ..imports import common
 from ..imports import text
 from ..imports import scoreboard
 
@@ -201,6 +202,78 @@ class World:
         Returns the minimum Y coordinate (bottom of the world).
         """
         raise NotImplementedError
+    def get_entities(self) -> List[Any]:
+        """
+        Returns a list of all entities in this world.
+        """
+        raise NotImplementedError
+    def __enter__(self) -> Self:
+        """Returns self"""
+        return self
+                                
+    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
+        """
+        Release this resource.
+        """
+        raise NotImplementedError
+
+
+class Entity:
+    
+    def get_id(self) -> int:
+        raise NotImplementedError
+    def get_uuid(self) -> str:
+        raise NotImplementedError
+    def get_type(self) -> str:
+        raise NotImplementedError
+    def get_position(self) -> Tuple[float, float, float]:
+        raise NotImplementedError
+    def get_world(self) -> World:
+        raise NotImplementedError
+    def get_yaw(self) -> float:
+        raise NotImplementedError
+    def get_pitch(self) -> float:
+        raise NotImplementedError
+    def get_head_yaw(self) -> float:
+        raise NotImplementedError
+    def is_on_ground(self) -> bool:
+        raise NotImplementedError
+    def is_sneaking(self) -> bool:
+        raise NotImplementedError
+    def is_sprinting(self) -> bool:
+        raise NotImplementedError
+    def is_invisible(self) -> bool:
+        raise NotImplementedError
+    def is_glowing(self) -> bool:
+        raise NotImplementedError
+    def teleport(self, pos: Tuple[float, float, float], world_ref: World) -> None:
+        raise NotImplementedError
+    def set_velocity(self, velocity: Tuple[float, float, float]) -> None:
+        raise NotImplementedError
+    def get_velocity(self) -> Tuple[float, float, float]:
+        raise NotImplementedError
+    def get_pose(self) -> common.EntityPose:
+        raise NotImplementedError
+    def get_name(self) -> text.TextComponent:
+        raise NotImplementedError
+    def set_custom_name(self, name: text.TextComponent) -> None:
+        raise NotImplementedError
+    def get_custom_name(self) -> Optional[text.TextComponent]:
+        raise NotImplementedError
+    def set_custom_name_visible(self, visible: bool) -> None:
+        raise NotImplementedError
+    def is_custom_name_visible(self) -> bool:
+        raise NotImplementedError
+    def is_invulnerable(self) -> bool:
+        raise NotImplementedError
+    def set_invulnerable(self, invulnerable: bool) -> None:
+        raise NotImplementedError
+    def get_fire_ticks(self) -> int:
+        raise NotImplementedError
+    def set_fire_ticks(self, ticks: int) -> None:
+        raise NotImplementedError
+    def remove(self) -> None:
+        raise NotImplementedError
     def __enter__(self) -> Self:
         """Returns self"""
         return self

src/pumpkin_api/wit_files/command.wit

@@ -1,189 +0,0 @@
-interface command {
-    use player.{player};
-    use %world.{%world};
-    use entity.{command-block-entity, entity};
-    use common.{position, block-position, locale};
-    use server.{server, difficulty};
-    use text.{text-component};
-
-    enum gamemode {
-        survival,
-        creative,
-        adventure,
-        spectator,
-    }
-
-    enum bossbar-color {
-        pink,
-        blue,
-        red,
-        green,
-        yellow,
-        purple,
-        white,
-    }
-
-    enum bossbar-style {
-        no-division,
-        notches6,
-        notches10,
-        notches12,
-        notches20,
-    }
-
-    enum sound-category {
-        master,
-        music,
-        records,
-        weather,
-        blocks,
-        hostile,
-        neutral,
-        players,
-        ambient,
-        voice,
-        ui,
-    }
-
-    enum entity-anchor {
-        feet,
-        eyes,
-    }
-
-    variant number {
-        float64(f64),
-        float32(f32),
-        int32(s32),
-        int64(s64),
-    }
-
-    variant not-in-bounds {
-        lower-bound(tuple<number, number>),
-        upper-bound(tuple<number, number>),
-    }
-
-    variant arg {
-        entities(list<entity>),
-        entity(entity),
-        players(list<player>),
-        block-pos(block-position),
-        pos3d(position),
-        pos2d(tuple<f64, f64>),
-        rotation(tuple<f32, bool, f32, bool>),
-        game-mode(gamemode),
-        difficulty(difficulty),
-        item(string),
-        item-predicate(string),
-        resource-location(string),
-        block(string),
-        block-predicate(string),
-        bossbar-color(bossbar-color),
-        bossbar-style(bossbar-style),
-        particle(string),
-        msg(string),
-        text-component(text-component),
-        time(s32),
-        num(result<number, not-in-bounds>),
-        %bool(bool),
-        simple(string),
-        sound-category(sound-category),
-        damage-type(string),
-        effect(string),
-        enchantment(string),
-        entity-anchor(entity-anchor),
-    }
-
-    resource consumed-args {
-        get-value: func(key: string) -> arg;
-    }
-
-    variant command-sender-type {
-        rcon,
-        console,
-        player(player),
-        command-block(tuple<command-block-entity, %world>),
-        dummy,
-    }
-
-    enum permission-level {
-        zero,
-        one,
-        two,
-        three,
-        four,
-    }
-
-    resource command-sender {
-        get-command-sender-type: func() -> command-sender-type;
-        send-message: func(text: text-component);
-        set-success-count: func(count: s32);
-        is-player: func() -> bool;
-        is-console: func() -> bool;
-        as-player: func() -> option<player>;
-        permission-level: func() -> permission-level;
-        has-permission-level: func(level: permission-level) -> bool;
-        has-permission: func(server: borrow<server>, node: string) -> bool;
-        position: func() -> option<position>;
-        %world: func() -> option<%world>;
-        get-locale: func() -> locale;
-        should-receive-feedback: func() -> bool;
-        should-broadcast-console-to-ops: func() -> bool;
-        should-track-output: func() -> bool;
-    }
-
-    enum string-type {
-        single-word,
-        quotable,
-        greedy,
-    }
-
-    variant argument-type {
-        %bool,
-        float(tuple<option<f32>, option<f32>>),
-        double(tuple<option<f64>, option<f64>>),
-        integer(tuple<option<s32>, option<s32>>),
-        long(tuple<option<s64>, option<s64>>),
-        %string(string-type),
-        entities,
-        entity,
-        %players,
-        game-profile,
-        block-pos,
-        position3d,
-        position2d,
-        block-state,
-        block-predicate,
-        item,
-        item-predicate,
-        component,
-        rotation,
-        %resource-location,
-        entity-anchor,
-        gamemode,
-        difficulty,
-        time(s32),
-        %resource(string),
-    }
-
-    variant command-error {
-        invalid-consumption(option<string>),
-        invalid-requirement,
-        permission-denied,
-        command-failed(text-component),
-    }
-
-    resource command-node {
-        literal: static func(name: string) -> command-node;
-        argument: static func(name: string, arg-type: argument-type) -> command-node;
-        then: func(node: command-node);
-        execute-with-handler-id: func(handler-id: u32);
-        require-with-handler-id: func(handler-id: u32);
-    }
-
-    resource command {
-        /// First name is primary, rest are aliases
-        constructor(names: list<string>, description: string);
-        then: func(node: command-node);
-        execute-with-handler-id: func(handler-id: u32);
-    }
-}

src/pumpkin_api/wit_files/common.wit

@@ -1,201 +0,0 @@
-/// Provides common types and utilities used across the entire plugin API.
-interface common {
-    /// Serialized text component as a postcard byte array.
-    /// @deprecated Use the text-component resource from the text interface instead.
-    type raw-text-component = list<u8>;
-
-    /// A position in the world grid (integers).
-    type block-position = tuple<s32, s32, s32>;
-
-    /// A precise coordinate in the world (floats).
-    type position = tuple<f64, f64, f64>;
-
-    /// Represents the hands of a player.
-    enum hand {
-        left,
-        right,
-    }
-
-    /// Represents the game modes available in Minecraft.
-    enum game-mode {
-        survival,
-        creative,
-        adventure,
-        spectator,
-    }
-
-    /// The 16 base Minecraft colors.
-    enum named-color {
-        black,
-        dark-blue,
-        dark-green,
-        dark-aqua,
-        dark-red,
-        dark-purple,
-        gold,
-        gray,
-        dark-gray,
-        blue,
-        green,
-        aqua,
-        red,
-        light-purple,
-        yellow,
-        white,
-    }
-
-    /// An RGB color represented by its red, green, and blue components.
-    record rgb-color {
-        r: u8,
-        g: u8,
-        b: u8,
-    }
-
-    /// An ARGB color with alpha (transparency) channel.
-    record argb-color {
-        a: u8,
-        r: u8,
-        g: u8,
-        b: u8,
-    }
-
-    /// Represents a stack of items with its type and count.
-    record item-stack {
-        /// The unique registry key (e.g., "minecraft:diamond").
-        registry-key: string,
-        /// The number of items in the stack.
-        count: u8,
-    }
-
-    /// All Minecraft-supported locales.
-    enum locale {
-        af-za,
-        ar-sa,
-        ast-es,
-        az-az,
-        ba-ru,
-        bar,
-        be-by,
-        bg-bg,
-        br-fr,
-        brb,
-        bs-ba,
-        ca-es,
-        cs-cz,
-        cy-gb,
-        da-dk,
-        de-at,
-        de-ch,
-        de-de,
-        el-gr,
-        en-au,
-        en-ca,
-        en-gb,
-        en-nz,
-        en-pt,
-        en-ud,
-        en-us,
-        enp,
-        enws,
-        eo-uy,
-        es-ar,
-        es-cl,
-        es-ec,
-        es-es,
-        es-mx,
-        es-uy,
-        es-ve,
-        esan,
-        et-ee,
-        eu-es,
-        fa-ir,
-        fi-fi,
-        fil-ph,
-        fo-fo,
-        fr-ca,
-        fr-fr,
-        fra-de,
-        fur-it,
-        fy-nl,
-        ga-ie,
-        gd-gb,
-        gl-es,
-        haw-us,
-        he-il,
-        hi-in,
-        hr-hr,
-        hu-hu,
-        hy-am,
-        id-id,
-        ig-ng,
-        io-en,
-        is-is,
-        isv,
-        it-it,
-        ja-jp,
-        jbo-en,
-        ka-ge,
-        kk-kz,
-        kn-in,
-        ko-kr,
-        ksh,
-        kw-gb,
-        la-la,
-        lb-lu,
-        li-li,
-        lmo,
-        lo-la,
-        lol-us,
-        lt-lt,
-        lv-lv,
-        lzh,
-        mk-mk,
-        mn-mn,
-        ms-my,
-        mt-mt,
-        nah,
-        nds-de,
-        nl-be,
-        nl-nl,
-        nn-no,
-        no-no,
-        oc-fr,
-        ovd,
-        pl-pl,
-        pt-br,
-        pt-pt,
-        qya-aa,
-        ro-ro,
-        rpr,
-        ru-ru,
-        ry-ua,
-        sah-sah,
-        se-no,
-        sk-sk,
-        sl-si,
-        so-so,
-        sq-al,
-        sr-cs,
-        sr-sp,
-        sv-se,
-        sxu,
-        szl,
-        ta-in,
-        th-th,
-        tl-ph,
-        tlh-aa,
-        tok,
-        tr-tr,
-        tt-ru,
-        uk-ua,
-        val-es,
-        vec-it,
-        vi-vn,
-        yi-de,
-        yo-ng,
-        zh-cn,
-        zh-hk,
-        zh-tw,
-        zlm-arab,
-    }
-}

src/pumpkin_api/wit_files/componentize_py_async_support/__init__.py

@@ -1,529 +0,0 @@
-import asyncio
-import componentize_py_runtime
-import subprocess
-
-from os import PathLike
-from socket import AddressFamily, AddressInfo, SocketKind, socket
-from concurrent.futures import Executor
-from componentize_py_types import Result, Ok, Err
-from dataclasses import dataclass
-from typing import Any, Optional, TypeVar, TypeVarTuple, Callable, IO, Literal, cast
-from contextvars import ContextVar, Context
-from collections.abc import Coroutine, Awaitable, Sequence
-from asyncio.protocols import BaseProtocol
-from asyncio.transports import Transport, WriteTransport, DatagramTransport, SubprocessTransport, ReadTransport
-from asyncio.base_events import Server
-
-try:
-    from ssl import SSLContext
-except:
-    pass
-
-@dataclass
-class _FutureState:
-    waitable_set: int | None
-    futures: dict[int, Any]
-    handles: list[asyncio.Handle]
-    pending_count: int
-
-class _ReturnCode:
-    COMPLETED = 0
-    DROPPED = 1
-    CANCELLED = 2
-
-class _CallbackCode:
-    EXIT = 0
-    YIELD = 1
-    WAIT = 2
-    POLL = 3
-
-class _Event:
-    NONE = 0
-    SUBTASK = 1
-    STREAM_READ = 2
-    STREAM_WRITE = 3
-    FUTURE_READ = 4
-    FUTURE_WRITE = 5
-    CANCELLED = 6
-
-class _Status:
-    STARTING = 0
-    STARTED = 1
-    RETURNED = 2
-    START_CANCELLED = 3
-    RETURN_CANCELLED = 4
-
-_T = TypeVar("_T")
-_Ts = TypeVarTuple("_Ts")
-_ProtocolT = TypeVar("_ProtocolT", bound=BaseProtocol)
-
-async def _noop() -> None:
-    pass
-    
-class _Loop(asyncio.AbstractEventLoop):
-    def __init__(self) -> None:
-        self.running: bool = False
-        self.exception: Optional[Any] = None
-
-    def poll(self, future_state: _FutureState) -> None:
-        while True:
-            handles = future_state.handles
-            future_state.handles = []
-            for handle in handles:
-                if not handle._cancelled:
-                    handle._run()
-                
-            if self.exception is not None:
-                raise self.exception
-
-            if len(handles) == 0 and len(future_state.handles) == 0:
-                return
-    
-    def get_debug(self) -> bool:
-        return False
-
-    def is_running(self) -> bool:
-        return self.running
-
-    def is_closed(self) -> bool:
-        return not self.running
-
-    def stop(self) -> None:
-        self.running = False
-
-    def close(self) -> None:
-        self.running = False
-
-    def shutdown_asyncgens(self) -> Coroutine[Any, Any, None]:
-        return _noop()
-
-    def call_exception_handler(self, context: dict[str, Any]) -> None:
-        self.exception = context.get('exception', None)
-
-    def call_soon(self,
-                  callback: Callable[[*_Ts], object],
-                  *args: *_Ts,
-                  context: Context | None = None) -> asyncio.Handle:
-        global _future_state
-
-        if context is not None:
-            future_state = context[_future_state]
-            handle = asyncio.Handle(callback, args, self, context)
-            future_state.handles.append(handle)
-            return handle
-        else:
-            raise AssertionError
-
-    def create_task(self, coroutine: Coroutine[Any, Any, _T], name: str | None = None, context: Context | None = None) -> asyncio.Task[_T]:
-        return asyncio.Task(coroutine, loop=self, context=context)
-
-    def create_future(self) -> asyncio.Future[Any]:
-        return asyncio.Future(loop=self)
-
-    # The remaining methods should be irrelevant for our purposes and thus unimplemented
-
-    def run_until_complete(self, future: Awaitable[_T]) -> _T:
-        raise NotImplementedError
-
-    def run_forever(self) -> None:
-        raise NotImplementedError
-
-    async def shutdown_default_executor(self) -> None:
-        raise NotImplementedError
-
-    def call_later(self,
-                   delay: float,
-                   callback: Callable[[*_Ts], object],
-                   *args: *_Ts,
-                   context: Context | None = None) -> asyncio.TimerHandle:
-        raise NotImplementedError
-
-    def call_at(self,
-                when: float,
-                callback: Callable[[*_Ts], object],
-                *args: *_Ts,
-                context: Context | None = None) -> asyncio.TimerHandle:
-        raise NotImplementedError
-
-    def time(self) -> float:
-        raise NotImplementedError
-
-    def call_soon_threadsafe(self,
-                             callback: Callable[[*_Ts], object],
-                             *args: *_Ts,
-                             context: Context | None = None) -> asyncio.Handle:
-        raise NotImplementedError
-
-    def run_in_executor(self,
-                        executor: Executor | None,
-                        func: Callable[[*_Ts], _T],
-                        *args: *_Ts) -> asyncio.Future[_T]:
-        raise NotImplementedError
-
-    def set_default_executor(self, executor: Executor) -> None:
-        raise NotImplementedError
-
-    async def getaddrinfo(
-            self,
-            host: bytes | str | None,
-            port: bytes | str | int | None,
-            *,
-            family: int = 0,
-            type: int = 0,
-            proto: int = 0,
-            flags: int = 0,
-    ) -> list[tuple[AddressFamily, SocketKind, int, str, tuple[str, int] | tuple[str, int, int, int]]]:
-        raise NotImplementedError
-
-    async def getnameinfo(self,
-                          sockaddr: tuple[str, int] | tuple[str, int, int, int],
-                          flags: int = 0) -> tuple[str, str]:
-        raise NotImplementedError
-    
-    async def create_connection(
-            self,
-            protocol_factory: Callable[[], _ProtocolT],
-            host: str | None = ...,
-            port: int | None = ...,
-            *,
-            ssl: bool | SSLContext | None = None,
-            family: int = 0,
-            proto: int = 0,
-            flags: int = 0,
-            sock: socket | None = None,
-            local_addr: tuple[str, int] | None = None,
-            server_hostname: str | None = None,
-            ssl_handshake_timeout: float | None = None,
-            ssl_shutdown_timeout: float | None = None,
-            happy_eyeballs_delay: float | None = None,
-            interleave: int | None = None,
-    ) -> tuple[Transport, _ProtocolT]:
-        raise NotImplementedError
-    
-    async def create_server(
-            self,
-            protocol_factory: Callable[[], BaseProtocol],
-            host: str | Sequence[str] | None = None,
-            port: int | None = None,
-            *,
-            family: int = AddressFamily.AF_UNSPEC,
-            flags: int = AddressInfo.AI_PASSIVE,
-            sock: socket | None = ...,
-            backlog: int = 100,
-            ssl: bool | SSLContext | None = None,
-            reuse_address: bool | None = None,
-            reuse_port: bool | None = None,
-            keep_alive: bool | None = None,
-            ssl_handshake_timeout: float | None = None,
-            ssl_shutdown_timeout: float | None = None,
-            start_serving: bool = True,
-    ) -> Server:
-        raise NotImplementedError
-
-    async def sendfile(self,
-                       transport: WriteTransport,
-                       file: IO[bytes],
-                       offset: int = 0,
-                       count: int | None = None,
-                       *,
-                       fallback: bool = True
-    ) -> int:
-        raise NotImplementedError
-
-    async def start_tls(
-            self,
-            transport: WriteTransport,
-            protocol: BaseProtocol,
-            sslcontext: SSLContext,
-            *,
-            server_side: bool = False,
-            server_hostname: str | None = None,
-            ssl_handshake_timeout: float | None = None,
-            ssl_shutdown_timeout: float | None = None,
-        ) -> Transport | None:
-        raise NotImplementedError
-
-    async def create_unix_connection(
-            self,
-            protocol_factory: Callable[[], _ProtocolT],
-            path: str | None = None,
-            *,
-            ssl: bool | SSLContext | None = None,
-            sock: socket | None = None,
-            server_hostname: str | None = None,
-            ssl_handshake_timeout: float | None = None,
-            ssl_shutdown_timeout: float | None = None,
-        ) -> tuple[Transport, _ProtocolT]:
-        raise NotImplementedError
-
-    async def create_unix_server(
-            self,
-            protocol_factory: Callable[[], BaseProtocol],
-            path: str | PathLike[str] | None = None,
-            *,
-            sock: socket | None = None,
-            backlog: int = 100,
-            ssl: bool | SSLContext | None = None,
-            ssl_handshake_timeout: float | None = None,
-            ssl_shutdown_timeout: float | None = None,
-            start_serving: bool = True,
-    ) -> Server:
-        raise NotImplementedError
-
-    async def connect_accepted_socket(
-            self,
-            protocol_factory: Callable[[], _ProtocolT],
-            sock: socket,
-            *,
-            ssl: bool | SSLContext | None = None,
-            ssl_handshake_timeout: float | None = None,
-            ssl_shutdown_timeout: float | None = None,
-        ) -> tuple[Transport, _ProtocolT]:
-        raise NotImplementedError
-
-    async def create_datagram_endpoint(
-            self,
-            protocol_factory: Callable[[], _ProtocolT],
-            local_addr: tuple[str, int] | str | None = None,
-            remote_addr: tuple[str, int] | str | None = None,
-            *,
-            family: int = 0,
-            proto: int = 0,
-            flags: int = 0,
-            reuse_address: bool | None = None,
-            reuse_port: bool | None = None,
-            allow_broadcast: bool | None = None,
-            sock: socket | None = None,
-    ) -> tuple[DatagramTransport, _ProtocolT]:
-        raise NotImplementedError
-
-    async def connect_read_pipe(self,
-                                protocol_factory: Callable[[], _ProtocolT],
-                                pipe: Any) ->  tuple[ReadTransport, _ProtocolT]:
-        raise NotImplementedError
-
-    async def connect_write_pipe(self,
-                                 protocol_factory: Callable[[], _ProtocolT],
-                                 pipe: Any) -> tuple[WriteTransport, _ProtocolT]:
-        raise NotImplementedError
-
-    async def subprocess_shell(
-        self,
-        protocol_factory: Callable[[], _ProtocolT],
-        cmd: bytes | str,
-        *,
-        stdin: int | IO[Any] | None = -1,
-        stdout: int | IO[Any] | None = -1,
-        stderr: int | IO[Any] | None = -1,
-        universal_newlines: Literal[False] = False,
-        shell: Literal[True] = True,
-        bufsize: Literal[0] = 0,
-        encoding: None = None,
-        errors: None = None,
-        text: Literal[False] | None = None,
-        **kwargs: Any,
-    ) -> tuple[SubprocessTransport, _ProtocolT]:
-        raise NotImplementedError
-
-    async def subprocess_exec(
-        self,
-        protocol_factory: Callable[[], _ProtocolT],
-        program: Any,
-        *args: Any,
-        stdin: int | IO[Any] | None = -1,
-        stdout: int | IO[Any] | None = -1,
-        stderr: int | IO[Any] | None = -1,
-        universal_newlines: Literal[False] = False,
-        shell: Literal[False] = False,
-        bufsize: Literal[0] = 0,
-        encoding: None = None,
-        errors: None = None,
-        **kwargs: Any,
-    ) -> tuple[SubprocessTransport, _ProtocolT]:
-        raise NotImplementedError
-
-    def add_reader(self, fd: Any, callback: Callable[[*_Ts], Any], *args: *_Ts) -> None:
-        raise NotImplementedError
-
-    def remove_reader(self, fd: Any) -> bool:
-        raise NotImplementedError
-
-    def add_writer(self, fd: Any, callback: Callable[[*_Ts], Any], *args: *_Ts) -> None:
-        raise NotImplementedError
-
-    def remove_writer(self, fd: Any) -> bool:
-        raise NotImplementedError
-
-    async def sock_recv(self, sock: socket, nbytes: int) -> bytes:
-        raise NotImplementedError
-
-    async def sock_recv_into(self, sock: socket, buf: Any) -> int:
-        raise NotImplementedError
-
-    async def sock_recvfrom(self, sock: socket, bufsize: int) -> tuple[bytes, Any]:
-        raise NotImplementedError
-
-    async def sock_recvfrom_into(self, sock: socket, buf: Any, nbytes: int = 0) -> tuple[int, Any]:
-        raise NotImplementedError
-
-    async def sock_sendall(self, sock: socket, data: Any) -> None:
-        raise NotImplementedError
-
-    async def sock_sendto(self, sock: socket, data: Any, address: Any) -> int:
-        raise NotImplementedError
-
-    async def sock_connect(self, sock: socket, address: Any) -> None:
-        raise NotImplementedError
-
-    async def sock_accept(self, sock: socket) -> tuple[socket, Any]:
-        raise NotImplementedError
-
-    async def sock_sendfile(
-            self,
-            sock: socket,
-            file: IO[bytes],
-            offset: int = 0,
-            count: int | None = None,
-            *,
-            fallback: bool | None = None
-    ) -> int:
-        raise NotImplementedError
-
-    def add_signal_handler(self, sig: int, callback: Callable[[*_Ts], object], *args: *_Ts) -> None:
-        raise NotImplementedError
-
-    def remove_signal_handler(self, sig: int) -> bool:
-        raise NotImplementedError
-
-    def set_task_factory(self, factory: Any | None) -> None:
-        raise NotImplementedError
-
-    def get_task_factory(self) -> None:
-        raise NotImplementedError
-
-    def get_exception_handler(self) -> None:
-        raise NotImplementedError
-
-    def set_exception_handler(self, handler: Any | None) -> None:
-        raise NotImplementedError
-
-    def default_exception_handler(self, context: dict[str, Any]) -> None:
-        raise NotImplementedError
-
-    def set_debug(self, enabled: bool) -> None:
-        raise NotImplementedError
-        
-_future_state: ContextVar[_FutureState] = ContextVar("_future_state")
-_loop = _Loop()
-asyncio.set_event_loop(_loop)
-_loop.running = True
-asyncio.events._set_running_loop(_loop)
-
-def _set_future_state(future_state: _FutureState) -> None:
-    global _future_state
-
-    _future_state.set(future_state)
-
-async def _return_result(export_index: int, borrows: int, coroutine: Any) -> None:
-    global _future_state
-
-    try:
-        try:
-            result: Result[Any, Any] = Ok(await coroutine)
-        except Err as e:
-            result = e
-
-        componentize_py_runtime.call_task_return(export_index, borrows, result)
-    except Exception as e:
-        _loop.exception = e
-
-    assert _future_state.get().pending_count > 0
-    _future_state.get().pending_count -= 1
-
-def first_poll(export_index: int, borrows: int, coroutine: Any) -> int:
-    context = Context()
-    future_state = _FutureState(None, {}, [], 1)
-    context.run(_set_future_state, future_state)
-    asyncio.create_task(_return_result(export_index, borrows, coroutine), context=context)
-    return _poll(future_state)
-
-def _poll(future_state: _FutureState) -> int:
-    global _loop
-
-    _loop.poll(future_state)
-
-    if future_state.pending_count == 0:
-        if future_state.waitable_set is not None:
-            componentize_py_runtime.waitable_set_drop(future_state.waitable_set)
-        
-        return _CallbackCode.EXIT
-    else:
-        waitable_set = future_state.waitable_set
-        assert waitable_set is not None
-        componentize_py_runtime.context_set(future_state)
-        return _CallbackCode.WAIT | (waitable_set << 4)
-
-def callback(event0: int, event1: int, event2: int) -> int:
-    future_state = componentize_py_runtime.context_get()
-    componentize_py_runtime.context_set(None)
-    
-    match event0:
-        case _Event.NONE:
-            pass
-        case _Event.SUBTASK:
-            match event2:
-                case _Status.STARTING:
-                    raise AssertionError
-                case _Status.STARTED:
-                    pass
-                case _Status.RETURNED:
-                    componentize_py_runtime.waitable_join(event1, 0)
-                    componentize_py_runtime.subtask_drop(event1)
-                    future_state.futures.pop(event1).set_result(event2)
-                case _:
-                    # todo
-                    raise NotImplementedError
-        case _Event.STREAM_READ | _Event.STREAM_WRITE | _Event.FUTURE_READ | _Event.FUTURE_WRITE:
-            componentize_py_runtime.waitable_join(event1, 0)
-            future_state.futures.pop(event1).set_result(event2)
-        case _:
-            # todo
-            raise NotImplementedError
-
-    return _poll(future_state)
-    
-async def await_result[T](result: Result[T, tuple[int, int]]) -> T:
-    global _loop
-    global _future_state
-    
-    if isinstance(result, Ok):
-        return result.value
-    else:
-        future_state = _future_state.get()
-        waitable, promise = result.value
-        future = _loop.create_future()
-        future_state.futures[waitable] = future
-        
-        if future_state.waitable_set is None:
-            future_state.waitable_set = componentize_py_runtime.waitable_set_new()
-        componentize_py_runtime.waitable_join(waitable, future_state.waitable_set)
-        
-        return cast(T, componentize_py_runtime.promise_get_result(await future, promise))
-
-async def _wrap_spawned(coroutine: Any) -> None:
-    global _future_state
-
-    try:
-        await coroutine
-    except Exception as e:
-        _loop.exception = e
-
-    assert _future_state.get().pending_count > 0
-    _future_state.get().pending_count -= 1
-
-def spawn(coroutine: Any) -> None:
-    global _future_state
-
-    _future_state.get().pending_count += 1
-    
-    asyncio.create_task(_wrap_spawned(coroutine))

src/pumpkin_api/wit_files/componentize_py_async_support/futures.py

@@ -1,93 +0,0 @@
-import componentize_py_runtime
-import componentize_py_async_support
-import weakref
-
-from typing import TypeVar, Generic, cast, Self, Any, Callable
-from types import TracebackType
-from componentize_py_async_support import _ReturnCode
-
-T = TypeVar('T')
-
-class FutureReader(Generic[T]):
-    def __init__(self, type_: int, handle: int):
-        self.type_ = type_
-        self.handle: int | None = handle
-        self.finalizer = weakref.finalize(self, componentize_py_runtime.future_drop_readable, type_, handle)
-
-    async def read(self) -> T:
-        self.finalizer.detach()
-        handle = self.handle
-        self.handle = None
-        if handle is not None:
-            result = await componentize_py_async_support.await_result(
-                componentize_py_runtime.future_read(self.type_, handle)
-            )
-            componentize_py_runtime.future_drop_readable(self.type_, handle)
-            return cast(T, result)
-        else:
-            raise AssertionError
-
-    def __enter__(self) -> Self:
-        return self
-        
-    def __exit__(self,
-                 exc_type: type[BaseException] | None,
-                 exc_value: BaseException | None,
-                 traceback: TracebackType | None) -> bool | None:
-        if self.handle is not None:
-            self.finalizer.detach()
-            handle = self.handle
-            self.handle = None
-            componentize_py_runtime.future_drop_readable(self.type_, handle)
-
-        return None
-
-async def write(type_: int, handle: int, value: Any) -> None:
-    await componentize_py_async_support.await_result(
-        componentize_py_runtime.future_write(type_, handle, value)
-    )
-    componentize_py_runtime.future_drop_writable(type_, handle)    
-
-def write_default(type_: int, handle: int, default: Callable[[], Any]) -> None:
-    componentize_py_async_support.spawn(write(type_, handle, default()))
-            
-class FutureWriter(Generic[T]):
-    def __init__(self, type_: int, handle: int, default: Callable[[], T]):
-        self.type_ = type_
-        self.handle: int | None = handle
-        self.default = default
-        self.finalizer = weakref.finalize(self, write_default, type_, handle, default)
-
-    async def write(self, value: T) -> bool:
-        self.finalizer.detach()
-        handle = self.handle
-        self.handle = None
-        if handle is not None:
-            code, _ = await componentize_py_async_support.await_result(
-                componentize_py_runtime.future_write(self.type_, handle, value)
-            )
-            componentize_py_runtime.future_drop_writable(self.type_, handle)
-            match code:
-                case _ReturnCode.COMPLETED:
-                    return True
-                case _ReturnCode.DROPPED:
-                    return False
-                case _ReturnCode.CANCELLED:
-                    # todo
-                    raise NotImplementedError
-                case _:
-                    raise AssertionError
-        else:
-            raise AssertionError
-
-    def __enter__(self) -> Self:
-        return self
-        
-    def __exit__(self,
-                 exc_type: type[BaseException] | None,
-                 exc_value: BaseException | None,
-                 traceback: TracebackType | None) -> bool | None:
-        if self.handle is not None:
-            componentize_py_async_support.spawn(self.write(self.default()))
-
-        return None

src/pumpkin_api/wit_files/componentize_py_async_support/streams.py

@@ -1,189 +0,0 @@
-import componentize_py_runtime
-import componentize_py_async_support
-import weakref
-
-from typing import TypeVar, Generic, Self, cast
-from types import TracebackType
-from componentize_py_async_support import _ReturnCode
-
-class ByteStreamReader:
-    def __init__(self, type_: int, handle: int):
-        self.writer_dropped = False
-        self.type_ = type_
-        self.handle: int | None = handle
-        self.finalizer = weakref.finalize(self, componentize_py_runtime.stream_drop_readable, type_, handle)
-
-    async def read(self, max_count: int) -> bytes:
-        if self.writer_dropped:
-            return bytes()
-        
-        code, values = await self._read(max_count)
-
-        if code == _ReturnCode.DROPPED:
-            self.writer_dropped = True
-        
-        return values
-        
-    async def _read(self, max_count: int) -> tuple[int, bytes]:
-        if self.handle is not None:
-            return cast(tuple[int, bytes], await componentize_py_async_support.await_result(
-                componentize_py_runtime.stream_read(self.type_, self.handle, max_count)
-            ))
-        else:
-            raise AssertionError
-
-    def __enter__(self) -> Self:
-        return self
-        
-    def __exit__(self,
-                 exc_type: type[BaseException] | None,
-                 exc_value: BaseException | None,
-                 traceback: TracebackType | None) -> bool | None:
-        self.finalizer.detach()
-        handle = self.handle
-        self.handle = None
-        if handle is not None:
-            componentize_py_runtime.stream_drop_readable(self.type_, handle)
-        return None
-
-class ByteStreamWriter:
-    def __init__(self, type_: int, handle: int):
-        self.reader_dropped = False
-        self.type_ = type_
-        self.handle: int | None = handle
-        self.finalizer = weakref.finalize(self, componentize_py_runtime.stream_drop_writable, type_, handle)
-
-    async def write(self, source: bytes) -> int:
-        if self.reader_dropped:
-            return 0
-        
-        code, count = await self._write(source)
-
-        if code == _ReturnCode.DROPPED:
-            self.reader_dropped = True
-        
-        return count
-
-    async def _write(self, source: bytes) -> tuple[int, int]:
-        if self.handle is not None:
-            return await componentize_py_async_support.await_result(
-                componentize_py_runtime.stream_write(self.type_, self.handle, source)
-            )
-        else:
-            raise AssertionError
-
-    async def write_all(self, source: bytes) -> int:
-        total = 0
-        
-        while len(source) > 0 and not self.reader_dropped:
-            count = await self.write(source)
-            source = source[count:]
-            total += count
-            
-        return total
-
-    def __enter__(self) -> Self:
-        return self
-        
-    def __exit__(self,
-                 exc_type: type[BaseException] | None,
-                 exc_value: BaseException | None,
-                 traceback: TracebackType | None) -> bool | None:
-        self.finalizer.detach()
-        handle = self.handle
-        self.handle = None
-        if handle is not None:
-            componentize_py_runtime.stream_drop_writable(self.type_, handle)
-        return None
-
-T = TypeVar('T')
-
-class StreamReader(Generic[T]):
-    def __init__(self, type_: int, handle: int):
-        self.writer_dropped = False
-        self.type_ = type_
-        self.handle: int | None = handle
-        self.finalizer = weakref.finalize(self, componentize_py_runtime.stream_drop_readable, type_, handle)
-
-    async def read(self, max_count: int) -> list[T]:
-        if self.writer_dropped:
-            return []
-        
-        code, values = await self._read(max_count)
-
-        if code == _ReturnCode.DROPPED:
-            self.writer_dropped = True
-        
-        return values
-        
-    async def _read(self, max_count: int) -> tuple[int, list[T]]:
-        if self.handle is not None:
-            return cast(tuple[int, list[T]], await componentize_py_async_support.await_result(
-                componentize_py_runtime.stream_read(self.type_, self.handle, max_count)
-            ))
-        else:
-            raise AssertionError        
-
-    def __enter__(self) -> Self:
-        return self
-        
-    def __exit__(self,
-                 exc_type: type[BaseException] | None,
-                 exc_value: BaseException | None,
-                 traceback: TracebackType | None) -> bool | None:
-        self.finalizer.detach()
-        handle = self.handle
-        self.handle = None
-        if handle is not None:
-            componentize_py_runtime.stream_drop_readable(self.type_, handle)
-        return None
-
-class StreamWriter(Generic[T]):
-    def __init__(self, type_: int, handle: int):
-        self.reader_dropped = False
-        self.type_ = type_
-        self.handle: int | None = handle
-        self.finalizer = weakref.finalize(self, componentize_py_runtime.stream_drop_writable, type_, handle)
-
-    async def write(self, source: list[T]) -> int:
-        if self.reader_dropped:
-            return 0
-        
-        code, count = await self._write(source)
-
-        if code == _ReturnCode.DROPPED:
-            self.reader_dropped = True
-        
-        return count
-
-    async def _write(self, source: list[T]) -> tuple[int, int]:
-        if self.handle is not None:
-            return await componentize_py_async_support.await_result(
-                componentize_py_runtime.stream_write(self.type_, self.handle, source)
-            )
-        else:
-            raise AssertionError        
-
-    async def write_all(self, source: list[T]) -> int:
-        total = 0
-        
-        while len(source) > 0 and not self.reader_dropped:
-            count = await self.write(source)
-            source = source[count:]
-            total += count
-            
-        return total
-
-    def __enter__(self) -> Self:
-        return self
-        
-    def __exit__(self,
-                 exc_type: type[BaseException] | None,
-                 exc_value: BaseException | None,
-                 traceback: TracebackType | None) -> bool | None:
-        self.finalizer.detach()
-        handle = self.handle
-        self.handle = None
-        if handle is not None:
-            componentize_py_runtime.stream_drop_writable(self.type_, handle)
-        return None

src/pumpkin_api/wit_files/componentize_py_runtime.pyi

@@ -1,34 +0,0 @@
-from typing import Any
-from componentize_py_types import Result
-
-def call_task_return(index: int, borrows: int, result: Any) -> None: ...
-
-def waitable_set_drop(set: int) -> None: ...
-
-def context_set(value: Any) -> None: ...
-
-def context_get() -> Any: ...
-
-def waitable_join(waitable: int, set: int) -> None: ...
-
-def subtask_drop(task: int) -> None: ...
-
-def waitable_set_new() -> int: ...
-
-def promise_get_result(event: int, promise: int) -> Any: ...
-
-def future_read(ty: int, future: int) -> Result[Any, tuple[int, int]]: ...
-
-def future_write(ty: int, future: int, value: Any) -> Result[tuple[int, int], tuple[int, int]]: ...
-
-def future_drop_readable(ty: int, future: int) -> None: ...
-
-def future_drop_writable(ty: int, future: int) -> None: ...
-
-def stream_read(ty: int, stream: int, max_count: int) -> Result[tuple[int, bytes | list[Any]], tuple[int, int]]: ...
-
-def stream_write(ty: int, stream: int, values: bytes | list[Any]) -> Result[tuple[int, int], tuple[int, int]]: ...
-
-def stream_drop_readable(ty: int, stream: int) -> None: ...
-
-def stream_drop_writable(ty: int, stream: int) -> None: ...

src/pumpkin_api/wit_files/componentize_py_types.py

@@ -1,19 +0,0 @@
-from typing import TypeVar, Generic, Union
-from dataclasses import dataclass
-
-S = TypeVar('S')
-@dataclass
-class Some(Generic[S]):
-    value: S
-
-T = TypeVar('T')
-@dataclass
-class Ok(Generic[T]):
-    value: T
-
-E = TypeVar('E')
-@dataclass(frozen=True)
-class Err(Generic[E], Exception):
-    value: E
-
-Result = Union[Ok[T], Err[E]]

src/pumpkin_api/wit_files/context.wit

@@ -1,33 +0,0 @@
-/// The core context provided to a plugin during initialization and event handling.
-interface context {
-    use server.{server};
-    use event.{event-type, event-priority};
-    use command.{command};
-    use permission.{permission};
-
-    /// A contextual handle for plugin-related operations.
-    resource context {
-        /// Registers a handler for a specific event.
-        ///
-        /// * `handler-id`: Unique ID for the event handler.
-        /// * `event-type`: The type of event to listen for.
-        /// * `event-priority`: When this handler should be called relative to others.
-        /// * `blocking`: Whether the event should wait for this handler to finish.
-        register-event: func(handler-id: u32, event-type: event-type, event-priority: event-priority, blocking: bool);
-
-        /// Registers a new command.
-        ///
-        /// * `command`: The command definition.
-        /// * `permission`: The required permission node to execute this command.
-        register-command: func(command: command, permission: string);
-
-        /// Registers a permission node with the server.
-        register-permission: func(permission: permission) -> result<_, string>;
-
-        /// Returns the path to the plugin's private data folder.
-        get-data-folder: func() -> string;
-
-        /// Returns the global server instance.
-        get-server: func() -> server;
-    }
-}

src/pumpkin_api/wit_files/entity.wit

@@ -1,36 +0,0 @@
-interface entity {
-    use common.{block-position};
-
-    resource block-entity {
-        resource-location: func() -> string;
-        get-position: func() -> block-position;
-        get-id: func() -> u32;
-        // write-nbt: func(nbt: nbt-compound);
-        // from-nbt: func(nbt: nbt-compound, position: block-position) -> entity;
-        // tick: func(world: simple-world);
-        // write-internal: func(nbt: nbt-compound);
-        // chunk-data-nbt: func() -> option<nbt-compound;
-        // get-inventory: func() -> option<inventory>;
-        // set-block-state: func(block-state: block-state-id);
-        // on-block-replaced: func(world: simple-world, position: block-position);
-        is-dirty: func() -> bool;
-        clear-dirty: func();
-        // to-property-delegate: func() -> option<property-delegate>;
-        // to-experience-container: func() -> option<experience-container>;
-    }
-
-    resource command-block-entity {
-        get-block-entity: func () -> block-entity;
-        last-output: func() -> string;
-        track-output: func() -> bool;
-        success-count: func() -> u32;
-        command: func() -> string;
-        auto: func() -> bool;
-        condition-met: func() -> bool;
-        powered: func() -> bool;
-    }
-
-    variant entity {
-        command-block-entity(command-block-entity),
-    }
-}

src/pumpkin_api/wit_files/event.wit

@@ -1,311 +0,0 @@
-interface event {
-    use common.{block-position, game-mode, hand, item-stack, position};
-    use player.{player};
-    use text.{text-component};
-    use %world.{%world};
-
-    enum event-priority {
-        highest,
-        high,
-        normal,
-        low,
-        lowest,
-    }
-
-    record player-join-event-data {
-        player: player,
-        join-message: text-component,
-        cancelled: bool
-    }
-
-    record player-leave-event-data {
-        player: player,
-        leave-message: text-component,
-        cancelled: bool
-    }
-
-    record player-login-event-data {
-        player: player,
-        kick-message: text-component,
-        cancelled: bool
-    }
-
-    record player-chat-event-data {
-        player: player,
-        message: string,
-        recipients: list<player>,
-        cancelled: bool
-    }
-
-    record player-command-send-event-data {
-        player: player,
-        command: string,
-        cancelled: bool
-    }
-
-    record player-permission-check-event-data {
-        player: player,
-        permission: string,
-        permission-result: bool
-    }
-
-    record player-move-event-data {
-        player: player,
-        from-position: position,
-        to-position: position,
-        cancelled: bool
-    }
-
-    record player-teleport-event-data {
-        player: player,
-        from-position: position,
-        to-position: position,
-        cancelled: bool
-    }
-
-    record player-change-world-event-data {
-        player: player,
-        previous-world: %world,
-        new-world: %world,
-        position: position,
-        yaw: f32,
-        pitch: f32,
-        cancelled: bool
-    }
-
-    record player-exp-change-event-data {
-        player: player,
-        amount: s32
-    }
-
-    record player-item-held-event-data {
-        player: player,
-        previous-slot: u8,
-        new-slot: u8,
-        cancelled: bool
-    }
-
-    record player-changed-main-hand-event-data {
-        player: player,
-        main-hand: hand
-    }
-
-    record player-gamemode-change-event-data {
-        player: player,
-        previous-gamemode: game-mode,
-        new-gamemode: game-mode,
-        cancelled: bool
-    }
-
-    record player-custom-payload-event-data {
-        player: player,
-        channel: string,
-        data: list<u8>
-    }
-
-    enum player-fish-state {
-        fishing,
-        caught-fish,
-        caught-entity,
-        in-ground,
-        failed-attempt,
-        reel-in,
-        bite,
-    }
-
-    record player-fish-event-data {
-        player: player,
-        caught-uuid: option<string>,
-        caught-type: string,
-        hook-uuid: string,
-        state: player-fish-state,
-        hand: hand,
-        exp-to-drop: s32,
-        cancelled: bool
-    }
-
-    record player-egg-throw-event-data {
-        player: player,
-        egg-uuid: string,
-        hatching: bool,
-        num-hatches: u8,
-        hatching-type: string,
-        cancelled: bool
-    }
-
-    enum entity-interaction-action {
-        interact,
-        attack,
-        interact-at,
-    }
-
-    enum interact-action {
-        left-click-block,
-        left-click-air,
-        right-click-air,
-        right-click-block,
-    }
-
-    record player-interact-event-data {
-        player: player,
-        action: interact-action,
-        clicked-pos: option<block-position>,
-        item: item-stack,
-        block: string,
-        cancelled: bool
-    }
-
-    record player-toggle-sneak-event-data {
-        player: player,
-        is-sneaking: bool,
-        cancelled: bool
-    }
-
-    record player-toggle-sprint-event-data {
-        player: player,
-        is-sprinting: bool,
-        cancelled: bool
-    }
-
-    record player-interact-unknown-entity-event-data {
-        player: player,
-        entity-id: s32,
-        action: entity-interaction-action,
-        cancelled: bool
-    }
-
-    record block-redstone-event-data {
-        target-world: %world,
-        state-id: u16,
-        block-position: block-position,
-        old-current: s32,
-        new-current: s32,
-        cancelled: bool
-    }
-
-    record block-break-event-data {
-        player: option<player>,
-        block: string,
-        block-position: block-position,
-        exp: u32,
-        should-drop: bool,
-        cancelled: bool
-    }
-
-    record block-burn-event-data {
-        igniting-block: string,
-        block: string,
-        cancelled: bool
-    }
-
-    record block-can-build-event-data {
-        block-to-build: string,
-        buildable: bool,
-        player: player,
-        block: string,
-        cancelled: bool
-    }
-
-    record block-grow-event-data {
-        target-world: %world,
-        old-block: string,
-        old-state-id: u16,
-        new-block: string,
-        new-state-id: u16,
-        block-position: block-position,
-        cancelled: bool
-    }
-
-    record block-place-event-data {
-        player: player,
-        block-placed: string,
-        block-placed-against: string,
-        block-position: block-position,
-        can-build: bool,
-        cancelled: bool
-    }
-    record server-command-event-data {
-        command: string,
-        cancelled: bool
-    }
-
-    record spawn-change-event-data {
-        target-world: %world,
-        previous-position: block-position,
-        previous-yaw: f32,
-        previous-pitch: f32,
-        new-position: block-position,
-        new-yaw: f32,
-        new-pitch: f32
-    }
-
-    record server-broadcast-event-data {
-        message: text-component,
-        sender: text-component,
-        cancelled: bool
-    }
-
-    enum event-type {
-        player-join-event,
-        player-leave-event,
-        player-login-event,
-        player-chat-event,
-        player-command-send-event,
-        player-permission-check-event,
-        player-move-event,
-        player-teleport-event,
-        player-change-world-event,
-        player-exp-change-event,
-        player-item-held-event,
-        player-changed-main-hand-event,
-        player-gamemode-change-event,
-        player-custom-payload-event,
-        player-fish-event,
-        player-egg-throw-event,
-        player-interact-unknown-entity-event,
-        player-interact-event,
-        player-toggle-sneak-event,
-        player-toggle-sprint-event,
-        block-redstone-event,
-        block-break-event,
-        block-burn-event,
-        block-can-build-event,
-        block-grow-event,
-        block-place-event,
-        server-command-event,
-        spawn-change-event,
-        server-broadcast-event,
-    }
-
-    variant event {
-        player-join-event(player-join-event-data),
-        player-leave-event(player-leave-event-data),
-        player-login-event(player-login-event-data),
-        player-chat-event(player-chat-event-data),
-        player-command-send-event(player-command-send-event-data),
-        player-permission-check-event(player-permission-check-event-data),
-        player-move-event(player-move-event-data),
-        player-teleport-event(player-teleport-event-data),
-        player-change-world-event(player-change-world-event-data),
-        player-exp-change-event(player-exp-change-event-data),
-        player-item-held-event(player-item-held-event-data),
-        player-changed-main-hand-event(player-changed-main-hand-event-data),
-        player-gamemode-change-event(player-gamemode-change-event-data),
-        player-custom-payload-event(player-custom-payload-event-data),
-        player-fish-event(player-fish-event-data),
-        player-egg-throw-event(player-egg-throw-event-data),
-        player-interact-unknown-entity-event(player-interact-unknown-entity-event-data),
-        player-interact-event(player-interact-event-data),
-        player-toggle-sneak-event(player-toggle-sneak-event-data),
-        player-toggle-sprint-event(player-toggle-sprint-event-data),
-        block-redstone-event(block-redstone-event-data),
-        block-break-event(block-break-event-data),
-        block-burn-event(block-burn-event-data),
-        block-can-build-event(block-can-build-event-data),
-        block-grow-event(block-grow-event-data),
-        block-place-event(block-place-event-data),
-        server-command-event(server-command-event-data),
-        spawn-change-event(spawn-change-event-data),
-        server-broadcast-event(server-broadcast-event-data),
-    }
-}

src/pumpkin_api/wit_files/gui.wit

@@ -1,38 +0,0 @@
-interface gui {
-    use text.{text-component};
-    use common.{item-stack};
-
-    enum gui-type {
-        generic-9x1,
-        generic-9x2,
-        generic-9x3,
-        generic-9x4,
-        generic-9x5,
-        generic-9x6,
-        generic-3x3,
-        crafter-3x3,
-        anvil,
-        beacon,
-        blast-furnace,
-        brewing-stand,
-        crafting,
-        enchantment,
-        furnace,
-        grindstone,
-        hopper,
-        lectern,
-        loom,
-        merchant,
-        shulker-box,
-        smithing,
-        smoker,
-        cartography-table,
-        stonecutter,
-    }
-
-    resource gui {
-        constructor(%type: gui-type, title: text-component);
-        set-item: func(slot: u32, item: item-stack);
-        get-item: func(slot: u32) -> option<item-stack>;
-    }
-}

src/pumpkin_api/wit_files/i18n.wit

@@ -1,21 +0,0 @@
-interface i18n {
-    use common.{locale};
-
-    /// Retrieves a translated string from the host.
-    ///
-    /// # Arguments
-    /// * `key`: The namespaced translation key (e.g. `pumpkin:my_key`).
-    /// * `locale`: The target locale.
-    ///
-    /// # Returns
-    /// The localized string, falling back to English or the key itself.
-    translate: func(key: string, locale: locale) -> string;
-
-    /// Loads custom translations from a JSON string.
-    ///
-    /// # Arguments
-    /// * `namespace`: The namespace to associate these keys with.
-    /// * `json`: A JSON string containing a flat map of translations.
-    /// * `locale`: The target locale for these translations.
-    load-translations: func(namespace: string, json: string, locale: locale);
-}

src/pumpkin_api/wit_files/log.wit

@@ -1,14 +0,0 @@
-interface logging {
-    enum level {
-        trace,
-        debug,
-        info,
-        warn,
-        error,
-    }
-
-    /// log any general purpose message
-    log: func(level: level, message: string);
-    /// This function is meant to be used by the tracing crate.
-    log-tracing: func(event: list<u8>);
-}

src/pumpkin_api/wit_files/metadata.wit

@@ -1,15 +0,0 @@
-/// Plugin metadata describing the plugin and its compatibility.
-interface metadata {
-    record plugin-metadata {
-        /// Name of the plugin.
-        name: string,
-        /// Plugin version (semver).
-        version: string,
-        /// Plugin authors.
-        authors: list<string>,
-        /// Short description of the plugin.
-        description: string,
-    }
-
-    get-metadata: func() -> plugin-metadata;
-}

src/pumpkin_api/wit_files/permission.wit

@@ -1,46 +0,0 @@
-interface permission {
-    /// Represents the player's permission level
-    ///
-    /// Permission levels determine the player's access to commands and server operations.
-    /// Each numeric level corresponds to a specific role:
-    /// - `Zero`: `normal`: Player can use basic commands.
-    /// - `One`: `moderator`: Player can bypass spawn protection.
-    /// - `Two`: `gamemaster`: Player or executor can use more commands and player can use command blocks.
-    /// - `Three`:  `admin`: Player or executor can use commands related to multiplayer management.
-    /// - `Four`: `owner`: Player or executor can use all of the commands, including commands related to server management.
-    enum permission-level {
-        zero,
-        one,
-        two,
-        three,
-        four,
-    }
-
-    /// Describes the default behavior for permissions
-    variant permission-default {
-        /// Permission is not granted by default
-        deny,
-        /// Permission is granted by default
-        allow,
-        /// Permission is granted by default to operators
-        op(permission-level),
-    }
-
-    /// A child permission entry
-    record permission-child {
-        node: string,
-        value: bool,
-    }
-
-    /// Defines a permission node in the system
-    record permission {
-        /// The full node name (e.g., "minecraft:command.gamemode")
-        node: string,
-        /// Description of what this permission does
-        description: string,
-        /// The default value of this permission
-        default: permission-default,
-        /// Children nodes that are affected by this permission
-        children: list<permission-child>,
-    }
-}

src/pumpkin_api/wit_files/player.wit

@@ -1,172 +0,0 @@
-/// Represents a player connected to the Minecraft server.
-interface player {
-    use common.{hand, item-stack, position, game-mode};
-    use %world.{%world};
-    use permission.{permission-level};
-    use text.{text-component};
-    use gui.{gui};
-
-    /// Various abilities a player can have.
-    record player-abilities {
-        /// Whether the player is invulnerable to damage.
-        invulnerable:       bool,
-        /// Whether the player is currently flying.
-        flying:             bool,
-        /// Whether the player is allowed to fly.
-        allow-flying:       bool,
-        /// Whether the player is in creative mode.
-        creative:           bool,
-        /// Whether the player can modify the world.
-        allow-modify-world: bool,
-        /// The speed at which the player flies.
-        fly-speed:          f32,
-        /// The speed at which the player walks.
-        walk-speed:         f32,
-    }
-
-    /// A handle to a player on the server.
-    resource player {
-        /// Returns the player's unique UUID as a string.
-        get-id: func () -> string;
-        /// Returns the player's username.
-        get-name: func () -> string;
-
-        // Basic state
-
-        /// Returns the player's current position in the world.
-        get-position: func () -> position;
-        /// Returns the player's current yaw (horizontal rotation).
-        get-yaw: func () -> f32;
-        /// Returns the player's current pitch (vertical rotation).
-        get-pitch: func () -> f32;
-        /// Returns the world the player is currently in.
-        get-world: func () -> %world;
-        /// Returns the player's current game mode.
-        get-gamemode: func () -> game-mode;
-        /// Changes the player's game mode. Returns true if successful.
-        set-gamemode: func (mode: game-mode) -> bool;
-        /// Returns the player's locale (e.g., "en_us").
-        get-locale: func () -> string;
-        /// Returns the player's current ping in milliseconds.
-        get-ping: func () -> u32;
-
-        // Permissions & metadata
-
-        /// Returns the player's permission level (0-4).
-        get-permission-level: func () -> permission-level;
-        /// Sets the player's permission level.
-        set-permission-level: func (level: permission-level);
-        /// Checks if the player has a specific permission node.
-        has-permission: func (node: string) -> bool;
-        /// Returns the player's display name, which may include formatting.
-        get-display-name: func () -> text-component;
-
-        // Messaging & titles
-
-        /// Sends a system message to the player's chat.
-        send-system-message: func (text: text-component, overlay: bool);
-        /// Shows a large title on the player's screen.
-        show-title: func (text: text-component);
-        /// Shows a smaller subtitle on the player's screen.
-        show-subtitle: func (text: text-component);
-        /// Shows a message in the action bar area.
-        show-actionbar: func (text: text-component);
-        /// Sets the fade-in, stay, and fade-out times for titles.
-        send-title-animation: func (fade-in: s32, stay: s32, fade-out: s32);
-
-        // Teleport & kick
-
-        /// Teleports the player to a position in a world.
-        teleport: func (position: position, yaw: option<f32>, pitch: option<f32>, %world: %world);
-        /// Teleports the player to another world at a specific position.
-        teleport-world: func (world-ref: %world, position: position, yaw: option<f32>, pitch: option<f32>);
-        /// Kicks the player from the server with the specified reason.
-        kick: func (message: text-component);
-        /// Forces the player to respawn.
-        respawn: func ();
-
-        /// Opens a GUI for the player.
-        open-gui: func (gui-ref: gui);
-
-        /// Bans the player with an optional reason.
-        ban: func (reason: option<text-component>);
-        /// Bans the player's IP address with an optional reason.
-        ban-ip: func (reason: option<text-component>);
-
-        // Inventory
-
-        /// Returns the index of the currently selected hotbar slot (0-8).
-        get-selected-slot: func () -> u8;
-        /// Returns the item currently in the specified hand.
-        get-item-in-hand: func (hand: hand) -> option<item-stack>;
-        /// Returns the item in the specified inventory slot.
-        get-inventory-item: func (slot: u8) -> option<item-stack>;
-
-        // Status
-
-        /// Returns the player's current health.
-        get-health: func () -> f32;
-        /// Sets the player's current health.
-        set-health: func (health: f32);
-        /// Returns the player's maximum health.
-        get-max-health: func () -> f32;
-        /// Sets the player's maximum health.
-        set-max-health: func (max-health: f32);
-        /// Returns the player's food level (0-20).
-        get-food-level: func () -> u8;
-        /// Sets the player's food level.
-        set-food-level: func (food-level: u8);
-        /// Returns the player's food saturation level.
-        get-saturation: func () -> f32;
-        /// Sets the player's food saturation level.
-        set-saturation: func (saturation: f32);
-        /// Returns the player's food exhaustion level.
-        get-exhaustion: func () -> f32;
-        /// Sets the player's food exhaustion level.
-        set-exhaustion: func (exhaustion: f32);
-        /// Returns the player's current absorption amount.
-        get-absorption: func () -> f32;
-        /// Sets the player's current absorption amount.
-        set-absorption: func (absorption: f32);
-
-        /// Returns the player's total experience level.
-        get-experience-level:    func() -> s32;
-        /// Returns the player's progress toward the next level (0.0 to 1.0).
-        get-experience-progress: func() -> f32;
-        /// Returns the total experience points the player has.
-        get-experience-points:   func() -> s32;
-        /// Sets the player's total experience level.
-        set-experience-level:    func(level: s32);
-        /// Sets the player's progress toward the next level.
-        set-experience-progress: func(progress: f32);
-        /// Sets the player's total experience points.
-        set-experience-points:   func(points: s32);
-        /// Adds experience levels to the player.
-        add-experience-levels:   func(levels: s32);
-        /// Adds experience points to the player.
-        add-experience-points:   func(points: s32);
-
-        /// Returns whether the player is currently sneaking.
-        is-sneaking:  func() -> bool;
-        /// Sets whether the player is currently sneaking.
-        set-sneaking: func(sneaking: bool);
-        /// Returns whether the player is currently sprinting.
-        is-sprinting: func() -> bool;
-        /// Sets whether the player is currently sprinting.
-        set-sprinting: func(sprinting: bool);
-        /// Returns whether the player is currently on the ground.
-        is-on-ground: func() -> bool;
-        /// Returns whether the player is currently flying.
-        is-flying:    func() -> bool;
-        /// Sets whether the player should be flying.
-        set-flying:   func(flying: bool);
-
-        /// Returns the player's current abilities.
-        get-abilities: func() -> player-abilities;
-        /// Updates the player's abilities.
-        set-abilities: func(abilities: player-abilities);
-
-        /// Returns the player's IP address.
-        get-ip: func() -> string;
-    }
-}

src/pumpkin_api/wit_files/plugin.wit

@@ -1,61 +0,0 @@
-/// The main entry point for a Pumpkin plugin.
-/// This world defines the exports that the plugin must provide to the host
-/// and the imports that the host provides to the plugin.
-package pumpkin:plugin;
-
-world plugin {
-    use context.{context};
-    use event.{event};
-    use server.{server as server-instance};
-    use command.{command-sender, consumed-args, command-error};
-
-    // --- Host-provided imports ---
-
-    /// Provides logging capabilities to the plugin.
-    import logging;
-    /// Provides GUI creation and management.
-    import gui;
-    /// Provides scoreboard management.
-    import scoreboard;
-    /// Provides global server information and player lookup.
-    import server;
-    /// Provides text component building and formatting.
-    import text;
-    /// Provides command registration and argument parsing.
-    import command;
-    /// Provides the plugin execution context.
-    import context;
-    /// Provides internationalization and translation support.
-    import i18n;
-    /// Provides task scheduling for delayed or repeating logic.
-    import scheduler;
-
-    // --- Plugin-provided exports ---
-
-    /// Called by the host once to initialize the plugin.
-    /// Internal use only; plugins should use the `register_plugin!` macro.
-    export init-plugin: func();
-
-    /// Called when the plugin is being loaded.
-    /// Use this to register commands, events, and perform initial setup.
-    export on-load: func(context: context) -> result<_, string>;
-
-    /// Called when the plugin is being unloaded.
-    /// Use this to save data and clean up resources.
-    export on-unload: func(context: context) -> result<_, string>;
-
-    /// Provides plugin metadata (name, version, etc.) to the host.
-    export metadata;
-
-    /// Common types used across the API.
-    export common;
-
-    /// Dispatches an event to the plugin for handling.
-    export handle-event: func(event-id: u32, server: server-instance, event: event) -> event;
-
-    /// Dispatches a command execution to the plugin.
-    export handle-command: func(command-id: u32, sender: command-sender, server: server-instance, args: consumed-args) -> result<s32, command-error>;
-
-    /// Dispatches a scheduled task execution to the plugin.
-    export handle-task: func(handler-id: u32, server: server-instance);
-}

src/pumpkin_api/wit_files/poll_loop.py

@@ -1,440 +0,0 @@
-"""Defines a custom `asyncio` event loop backed by `wasi:io/poll#poll`.
-
-This also includes helper classes and functions for working with `wasi:http`.
-
-This is only useful for `wasi:http@0.2.x`; `wasi:http@0.3.x` uses a different
-mechanism to model concurrency.
-"""
-
-import asyncio
-import socket
-import subprocess
-
-from componentize_py_types import Ok, Err
-from wit_world.imports import types, streams, poll, outgoing_handler
-from wit_world.imports.types import (
-    IncomingBody,
-    OutgoingBody,
-    OutgoingRequest,
-    IncomingResponse,
-)
-from wit_world.imports.streams import StreamError_Closed, InputStream
-from wit_world.imports.poll import Pollable
-from typing import Optional, cast
-
-# Maximum number of bytes to read at a time
-READ_SIZE: int = 16 * 1024
-
-
-async def send(request: OutgoingRequest) -> IncomingResponse:
-    """Send the specified request and wait asynchronously for the response."""
-
-    future = outgoing_handler.handle(request, None)
-
-    while True:
-        response = future.get()
-        if response is None:
-            await register(cast(PollLoop, asyncio.get_event_loop()), future.subscribe())
-        else:
-            if isinstance(response, Ok):
-                if isinstance(response.value, Ok):
-                    return response.value.value
-                else:
-                    raise response.value
-            else:
-                raise response
-
-
-class Stream:
-    """Reader abstraction over `wasi:http/types#incoming-body`."""
-
-    def __init__(self, body: IncomingBody):
-        self.body: Optional[IncomingBody] = body
-        self.stream: Optional[InputStream] = body.stream()
-
-    async def next(self) -> Optional[bytes]:
-        """Wait for the next chunk of data to arrive on the stream.
-
-        This will return `None` when the end of the stream has been reached.
-        """
-        while True:
-            try:
-                if self.stream is None:
-                    return None
-                else:
-                    buffer = self.stream.read(READ_SIZE)
-                    if len(buffer) == 0:
-                        await register(
-                            cast(PollLoop, asyncio.get_event_loop()),
-                            self.stream.subscribe(),
-                        )
-                    else:
-                        return buffer
-            except Err as e:
-                if isinstance(e.value, StreamError_Closed):
-                    if self.stream is not None:
-                        self.stream.__exit__(None, None, None)
-                        self.stream = None
-                    if self.body is not None:
-                        IncomingBody.finish(self.body)
-                        self.body = None
-                else:
-                    raise e
-
-
-class Sink:
-    """Writer abstraction over `wasi:http/types#outgoing-body`."""
-
-    def __init__(self, body: OutgoingBody):
-        self.body = body
-        self.stream = body.write()
-
-    async def send(self, chunk: bytes):
-        """Write the specified bytes to the sink.
-
-        This may need to yield according to the backpressure requirements of the sink.
-        """
-        offset = 0
-        flushing = False
-        while True:
-            count = self.stream.check_write()
-            if count == 0:
-                await register(
-                    cast(PollLoop, asyncio.get_event_loop()), self.stream.subscribe()
-                )
-            elif offset == len(chunk):
-                if flushing:
-                    return
-                else:
-                    self.stream.flush()
-                    flushing = True
-            else:
-                count = min(count, len(chunk) - offset)
-                self.stream.write(chunk[offset : offset + count])
-                offset += count
-
-    def close(self):
-        """Close the stream, indicating no further data will be written."""
-
-        self.stream.__exit__(None, None, None)
-        self.stream = None
-        OutgoingBody.finish(self.body, None)
-        self.body = None
-
-
-class PollLoop(asyncio.AbstractEventLoop):
-    """Custom `asyncio` event loop backed by `wasi:io/poll#poll`."""
-
-    def __init__(self):
-        self.wakers = []
-        self.running = False
-        self.handles = []
-        self.exception = None
-
-    def get_debug(self):
-        return False
-
-    def run_until_complete(self, future):
-        future = asyncio.ensure_future(future, loop=self)
-
-        self.running = True
-        asyncio.events._set_running_loop(self)
-        while self.running and not future.done():
-            handles = self.handles
-            self.handles = []
-            for handle in handles:
-                if not handle._cancelled:
-                    handle._run()
-
-            if self.wakers:
-                [pollables, wakers] = list(map(list, zip(*self.wakers)))
-
-                new_wakers = []
-                ready = [False] * len(pollables)
-                for index in poll.poll(pollables):
-                    ready[index] = True
-
-                for (ready, pollable), waker in zip(zip(ready, pollables), wakers):
-                    if ready:
-                        pollable.__exit__(None, None, None)
-                        waker.set_result(None)
-                    else:
-                        new_wakers.append((pollable, waker))
-
-                self.wakers = new_wakers
-
-            if self.exception is not None:
-                raise self.exception
-
-        return future.result()
-
-    def is_running(self):
-        return self.running
-
-    def is_closed(self):
-        return not self.running
-
-    def stop(self):
-        self.running = False
-
-    def close(self):
-        self.running = False
-
-    def shutdown_asyncgens(self):
-        pass
-
-    def call_exception_handler(self, context):
-        self.exception = context.get("exception", None)
-
-    def call_soon(self, callback, *args, context=None):
-        handle = asyncio.Handle(callback, args, self, context)
-        self.handles.append(handle)
-        return handle
-
-    def create_task(self, coroutine):
-        return asyncio.Task(coroutine, loop=self)
-
-    def create_future(self):
-        return asyncio.Future(loop=self)
-
-    # The remaining methods should be irrelevant for our purposes and thus unimplemented
-
-    def run_forever(self):
-        raise NotImplementedError
-
-    async def shutdown_default_executor(self):
-        raise NotImplementedError
-
-    def _timer_handle_cancelled(self, handle):
-        raise NotImplementedError
-
-    def call_later(self, delay, callback, *args, context=None):
-        raise NotImplementedError
-
-    def call_at(self, when, callback, *args, context=None):
-        raise NotImplementedError
-
-    def time(self):
-        raise NotImplementedError
-
-    def call_soon_threadsafe(self, callback, *args, context=None):
-        raise NotImplementedError
-
-    def run_in_executor(self, executor, func, *args):
-        raise NotImplementedError
-
-    def set_default_executor(self, executor):
-        raise NotImplementedError
-
-    async def getaddrinfo(self, host, port, *, family=0, type=0, proto=0, flags=0):
-        raise NotImplementedError
-
-    async def getnameinfo(self, sockaddr, flags=0):
-        raise NotImplementedError
-
-    async def create_connection(
-        self,
-        protocol_factory,
-        host=None,
-        port=None,
-        *,
-        ssl=None,
-        family=0,
-        proto=0,
-        flags=0,
-        sock=None,
-        local_addr=None,
-        server_hostname=None,
-        ssl_handshake_timeout=None,
-        ssl_shutdown_timeout=None,
-        happy_eyeballs_delay=None,
-        interleave=None,
-    ):
-        raise NotImplementedError
-
-    async def create_server(
-        self,
-        protocol_factory,
-        host=None,
-        port=None,
-        *,
-        family=socket.AF_UNSPEC,
-        flags=socket.AI_PASSIVE,
-        sock=None,
-        backlog=100,
-        ssl=None,
-        reuse_address=None,
-        reuse_port=None,
-        ssl_handshake_timeout=None,
-        ssl_shutdown_timeout=None,
-        start_serving=True,
-    ):
-        raise NotImplementedError
-
-    async def sendfile(self, transport, file, offset=0, count=None, *, fallback=True):
-        raise NotImplementedError
-
-    async def start_tls(
-        self,
-        transport,
-        protocol,
-        sslcontext,
-        *,
-        server_side=False,
-        server_hostname=None,
-        ssl_handshake_timeout=None,
-        ssl_shutdown_timeout=None,
-    ):
-        raise NotImplementedError
-
-    async def create_unix_connection(
-        self,
-        protocol_factory,
-        path=None,
-        *,
-        ssl=None,
-        sock=None,
-        server_hostname=None,
-        ssl_handshake_timeout=None,
-        ssl_shutdown_timeout=None,
-    ):
-        raise NotImplementedError
-
-    async def create_unix_server(
-        self,
-        protocol_factory,
-        path=None,
-        *,
-        sock=None,
-        backlog=100,
-        ssl=None,
-        ssl_handshake_timeout=None,
-        ssl_shutdown_timeout=None,
-        start_serving=True,
-    ):
-        raise NotImplementedError
-
-    async def connect_accepted_socket(
-        self,
-        protocol_factory,
-        sock,
-        *,
-        ssl=None,
-        ssl_handshake_timeout=None,
-        ssl_shutdown_timeout=None,
-    ):
-        raise NotImplementedError
-
-    async def create_datagram_endpoint(
-        self,
-        protocol_factory,
-        local_addr=None,
-        remote_addr=None,
-        *,
-        family=0,
-        proto=0,
-        flags=0,
-        reuse_address=None,
-        reuse_port=None,
-        allow_broadcast=None,
-        sock=None,
-    ):
-        raise NotImplementedError
-
-    async def connect_read_pipe(self, protocol_factory, pipe):
-        raise NotImplementedError
-
-    async def connect_write_pipe(self, protocol_factory, pipe):
-        raise NotImplementedError
-
-    async def subprocess_shell(
-        self,
-        protocol_factory,
-        cmd,
-        *,
-        stdin=subprocess.PIPE,
-        stdout=subprocess.PIPE,
-        stderr=subprocess.PIPE,
-        **kwargs,
-    ):
-        raise NotImplementedError
-
-    async def subprocess_exec(
-        self,
-        protocol_factory,
-        *args,
-        stdin=subprocess.PIPE,
-        stdout=subprocess.PIPE,
-        stderr=subprocess.PIPE,
-        **kwargs,
-    ):
-        raise NotImplementedError
-
-    def add_reader(self, fd, callback, *args):
-        raise NotImplementedError
-
-    def remove_reader(self, fd):
-        raise NotImplementedError
-
-    def add_writer(self, fd, callback, *args):
-        raise NotImplementedError
-
-    def remove_writer(self, fd):
-        raise NotImplementedError
-
-    async def sock_recv(self, sock, nbytes):
-        raise NotImplementedError
-
-    async def sock_recv_into(self, sock, buf):
-        raise NotImplementedError
-
-    async def sock_recvfrom(self, sock, bufsize):
-        raise NotImplementedError
-
-    async def sock_recvfrom_into(self, sock, buf, nbytes=0):
-        raise NotImplementedError
-
-    async def sock_sendall(self, sock, data):
-        raise NotImplementedError
-
-    async def sock_sendto(self, sock, data, address):
-        raise NotImplementedError
-
-    async def sock_connect(self, sock, address):
-        raise NotImplementedError
-
-    async def sock_accept(self, sock):
-        raise NotImplementedError
-
-    async def sock_sendfile(self, sock, file, offset=0, count=None, *, fallback=None):
-        raise NotImplementedError
-
-    def add_signal_handler(self, sig, callback, *args):
-        raise NotImplementedError
-
-    def remove_signal_handler(self, sig):
-        raise NotImplementedError
-
-    def set_task_factory(self, factory):
-        raise NotImplementedError
-
-    def get_task_factory(self):
-        raise NotImplementedError
-
-    def get_exception_handler(self):
-        raise NotImplementedError
-
-    def set_exception_handler(self, handler):
-        raise NotImplementedError
-
-    def default_exception_handler(self, context):
-        raise NotImplementedError
-
-    def set_debug(self, enabled):
-        raise NotImplementedError
-
-
-async def register(loop: PollLoop, pollable: Pollable):
-    waker = loop.create_future()
-    loop.wakers.append((pollable, waker))
-    await waker

src/pumpkin_api/wit_files/repo

@@ -0,0 +1 @@
+Subproject commit 7cc4854078e8a4008253b2e3bc7dc89db0ef37d3

src/pumpkin_api/wit_files/scheduler.wit

@@ -1,24 +0,0 @@
-/// Provides functionality to schedule tasks to be executed later on the server.
-interface scheduler {
-    /// Schedules a task to be executed once after the specified number of ticks.
-    ///
-    /// * `handler-id`: The unique ID of the handler to call when the task executes.
-    /// * `delay-ticks`: The number of game ticks to wait before execution (20 ticks = 1 second).
-    ///
-    /// Returns a unique task ID that can be used to cancel the task.
-    schedule-delayed-task: func(handler-id: u32, delay-ticks: u64) -> u32;
-
-    /// Schedules a task to be executed repeatedly.
-    ///
-    /// * `handler-id`: The unique ID of the handler to call when the task executes.
-    /// * `delay-ticks`: The number of game ticks to wait before the first execution.
-    /// * `period-ticks`: The number of game ticks between subsequent executions.
-    ///
-    /// Returns a unique task ID that can be used to cancel the task.
-    schedule-repeating-task: func(handler-id: u32, delay-ticks: u64, period-ticks: u64) -> u32;
-
-    /// Cancels a scheduled task if it hasn't finished yet.
-    ///
-    /// * `task-id`: The ID of the task to cancel.
-    cancel-task: func(task-id: u32);
-}

src/pumpkin_api/wit_files/scoreboard.wit

@@ -1,72 +0,0 @@
-interface scoreboard {
-    use text.{text-component};
-    use common.{named-color};
-
-    enum render-type {
-        integer,
-        hearts
-    }
-
-    enum display-slot {
-        player-list,
-        sidebar,
-        below-name,
-        sidebar-team-black,
-        sidebar-team-dark-blue,
-        sidebar-team-dark-green,
-        sidebar-team-dark-aqua,
-        sidebar-team-dark-red,
-        sidebar-team-dark-purple,
-        sidebar-team-gold,
-        sidebar-team-gray,
-        sidebar-team-dark-gray,
-        sidebar-team-blue,
-        sidebar-team-green,
-        sidebar-team-aqua,
-        sidebar-team-red,
-        sidebar-team-light-purple,
-        sidebar-team-yellow,
-        sidebar-team-white,
-    }
-
-    enum nametag-visibility {
-        always,
-        never,
-        hide-for-other-teams,
-        hide-for-own-team
-    }
-
-    enum collision-rule {
-        always,
-        never,
-        push-other-teams,
-        push-own-team
-    }
-
-    record team-settings {
-        display-name: text-component,
-        friendly-fire: bool,
-        see-friendly-invisibles: bool,
-        nametag-visibility: nametag-visibility,
-        collision-rule: collision-rule,
-        color: named-color,
-        prefix: text-component,
-        suffix: text-component
-    }
-
-    resource scoreboard {
-        add-objective: func(name: string, display-name: text-component, render-type: render-type);
-        remove-objective: func(name: string);
-        set-display-slot: func(slot: display-slot, objective-name: string);
-
-        update-score: func(entity-name: string, objective-name: string, value: s32);
-        remove-score: func(entity-name: string, objective-name: string);
-
-        create-team: func(name: string, settings: team-settings);
-        remove-team: func(name: string);
-        update-team: func(name: string, settings: team-settings);
-
-        add-player-to-team: func(team-name: string, player-name: string);
-        remove-player-from-team: func(team-name: string, player-name: string);
-    }
-}

src/pumpkin_api/wit_files/server.wit

@@ -1,41 +0,0 @@
-interface server {
-    use player.{player};
-
-    /// Represents the difficulty setting of a Minecraft server.
-    enum difficulty {
-        /// Hostile mobs do not spawn. Players regain health automatically.
-        peaceful,
-        /// Hostile mobs deal less damage.
-        easy,
-        /// Standard Minecraft difficulty.
-        normal,
-        /// Hostile mobs deal more damage.
-        hard,
-    }
-
-    /// Represents the global server instance.
-    resource server {
-        /// Returns the current difficulty level of the server.
-        get-difficulty: func() -> difficulty;
-
-        /// Returns the total number of players currently connected to the server.
-        get-player-count: func() -> u32;
-
-        /// Returns the rolling average Milliseconds Per Tick (MSPT).
-        /// A value below 50.0 is required for a stable 20 TPS.
-        get-mspt: func() -> f64;
-
-        /// Returns the effective Ticks Per Second (TPS).
-        /// Ideal value is 20.0.
-        get-tps: func() -> f64;
-
-        /// Returns a list of all online players across all worlds.
-        get-all-players: func() -> list<player>;
-
-        /// Searches for a player by their exact name.
-        get-player-by-name: func(name: string) -> option<player>;
-
-        /// Searches for a player by their UUID string.
-        get-player-by-uuid: func(id: string) -> option<player>;
-    }
-}

src/pumpkin_api/wit_files/text.wit

@@ -1,41 +0,0 @@
-interface text {
-    use common.{named-color, rgb-color, argb-color};
-
-    resource text-component {
-        text: static func(plain: string) -> text-component;
-        translate: static func(key: string, %with: list<text-component>) -> text-component;
-
-        add-child: func(child: text-component);
-        add-text: func(text: string);
-        get-text: func() -> string;
-        encode: func() -> list<u8>;
-
-        // Style
-
-        color-named: func(color: named-color);
-        color-rgb: func(color: rgb-color);
-        bold: func(value: bool);
-        italic: func(value: bool);
-        underlined: func(value: bool);
-        strikethrough: func(value: bool);
-        obfuscated: func(value: bool);
-        /// Text inserted into chat when shift-clicked
-        insertion: func(text: string);
-        font: func(font: string);
-        shadow-color: func(color: argb-color);
-
-        // Click events
-
-        click-open-url: func(url: string);
-        click-run-command: func(command: string);
-        click-suggest-command: func(command: string);
-        click-copy-to-clipboard: func(text: string);
-
-        // Hover events
-
-        hover-show-text: func(text: text-component);
-        /// Item data as SNBT string
-        hover-show-item: func(item: string);
-        hover-show-entity: func(entity-type: string, id: string, name: option<text-component>);
-    }
-}

src/pumpkin_api/wit_files/wit_world/__init__.py

@@ -1,70 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-from .imports import event
-from .imports import server
-from .imports import command
-from .imports import context
-
-
-class WitWorld(Protocol):
-
-    @abstractmethod
-    def init_plugin(self) -> None:
-        """
-        --- Plugin-provided exports ---
-        Called by the host once to initialize the plugin.
-        Internal use only; plugins should use the `register_plugin!` macro.
-        """
-        raise NotImplementedError
-
-    @abstractmethod
-    def on_load(self, context: context.Context) -> None:
-        """
-        Called when the plugin is being loaded.
-        Use this to register commands, events, and perform initial setup.
-        
-        Raises: `componentize_py_types.Err(wit_world.imports.str)`
-        """
-        raise NotImplementedError
-
-    @abstractmethod
-    def on_unload(self, context: context.Context) -> None:
-        """
-        Called when the plugin is being unloaded.
-        Use this to save data and clean up resources.
-        
-        Raises: `componentize_py_types.Err(wit_world.imports.str)`
-        """
-        raise NotImplementedError
-
-    @abstractmethod
-    def handle_event(self, event_id: int, server: server.Server, event: event.Event) -> event.Event:
-        """
-        Dispatches an event to the plugin for handling.
-        """
-        raise NotImplementedError
-
-    @abstractmethod
-    def handle_command(self, command_id: int, sender: command.CommandSender, server: server.Server, args: command.ConsumedArgs) -> int:
-        """
-        Dispatches a command execution to the plugin.
-        
-        Raises: `componentize_py_types.Err(wit_world.imports.command.CommandError)`
-        """
-        raise NotImplementedError
-
-    @abstractmethod
-    def handle_task(self, handler_id: int, server: server.Server) -> None:
-        """
-        Dispatches a scheduled task execution to the plugin.
-        """
-        raise NotImplementedError
-

src/pumpkin_api/wit_files/wit_world/exports/__init__.py

@@ -1,19 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-from ..exports import metadata
-
-class Metadata(Protocol):
-
-    @abstractmethod
-    def get_metadata(self) -> metadata.PluginMetadata:
-        raise NotImplementedError
-
-

src/pumpkin_api/wit_files/wit_world/exports/metadata.py

@@ -1,22 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-"""
-Plugin metadata describing the plugin and its compatibility.
-"""
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-
-
-@dataclass
-class PluginMetadata:
-    name: str
-    version: str
-    authors: List[str]
-    description: str
-

src/pumpkin_api/wit_files/wit_world/imports/command.py

@@ -1,539 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-from ..imports import common
-from ..imports import entity
-from ..imports import text
-from ..imports import world
-from ..imports import player
-from ..imports import server
-
-class Gamemode(Enum):
-    SURVIVAL = 0
-    CREATIVE = 1
-    ADVENTURE = 2
-    SPECTATOR = 3
-
-class BossbarColor(Enum):
-    PINK = 0
-    BLUE = 1
-    RED = 2
-    GREEN = 3
-    YELLOW = 4
-    PURPLE = 5
-    WHITE = 6
-
-class BossbarStyle(Enum):
-    NO_DIVISION = 0
-    NOTCHES6 = 1
-    NOTCHES10 = 2
-    NOTCHES12 = 3
-    NOTCHES20 = 4
-
-class SoundCategory(Enum):
-    MASTER = 0
-    MUSIC = 1
-    RECORDS = 2
-    WEATHER = 3
-    BLOCKS = 4
-    HOSTILE = 5
-    NEUTRAL = 6
-    PLAYERS = 7
-    AMBIENT = 8
-    VOICE = 9
-    UI = 10
-
-class EntityAnchor(Enum):
-    FEET = 0
-    EYES = 1
-
-
-@dataclass
-class Number_Float64:
-    value: float
-
-
-@dataclass
-class Number_Float32:
-    value: float
-
-
-@dataclass
-class Number_Int32:
-    value: int
-
-
-@dataclass
-class Number_Int64:
-    value: int
-
-
-Number = Union[Number_Float64, Number_Float32, Number_Int32, Number_Int64]
-
-
-
-@dataclass
-class NotInBounds_LowerBound:
-    value: Tuple[Number, Number]
-
-
-@dataclass
-class NotInBounds_UpperBound:
-    value: Tuple[Number, Number]
-
-
-NotInBounds = Union[NotInBounds_LowerBound, NotInBounds_UpperBound]
-
-
-
-@dataclass
-class Arg_Entities:
-    value: List[entity.Entity]
-
-
-@dataclass
-class Arg_Entity:
-    value: entity.Entity
-
-
-@dataclass
-class Arg_Players:
-    value: List[player.Player]
-
-
-@dataclass
-class Arg_BlockPos:
-    value: Tuple[int, int, int]
-
-
-@dataclass
-class Arg_Pos3d:
-    value: Tuple[float, float, float]
-
-
-@dataclass
-class Arg_Pos2d:
-    value: Tuple[float, float]
-
-
-@dataclass
-class Arg_Rotation:
-    value: Tuple[float, bool, float, bool]
-
-
-@dataclass
-class Arg_GameMode:
-    value: Gamemode
-
-
-@dataclass
-class Arg_Difficulty:
-    value: server.Difficulty
-
-
-@dataclass
-class Arg_Item:
-    value: str
-
-
-@dataclass
-class Arg_ItemPredicate:
-    value: str
-
-
-@dataclass
-class Arg_ResourceLocation:
-    value: str
-
-
-@dataclass
-class Arg_Block:
-    value: str
-
-
-@dataclass
-class Arg_BlockPredicate:
-    value: str
-
-
-@dataclass
-class Arg_BossbarColor:
-    value: BossbarColor
-
-
-@dataclass
-class Arg_BossbarStyle:
-    value: BossbarStyle
-
-
-@dataclass
-class Arg_Particle:
-    value: str
-
-
-@dataclass
-class Arg_Msg:
-    value: str
-
-
-@dataclass
-class Arg_TextComponent:
-    value: text.TextComponent
-
-
-@dataclass
-class Arg_Time:
-    value: int
-
-
-@dataclass
-class Arg_Num:
-    value: Result[Number, NotInBounds]
-
-
-@dataclass
-class Arg_Bool:
-    value: bool
-
-
-@dataclass
-class Arg_Simple:
-    value: str
-
-
-@dataclass
-class Arg_SoundCategory:
-    value: SoundCategory
-
-
-@dataclass
-class Arg_DamageType:
-    value: str
-
-
-@dataclass
-class Arg_Effect:
-    value: str
-
-
-@dataclass
-class Arg_Enchantment:
-    value: str
-
-
-@dataclass
-class Arg_EntityAnchor:
-    value: EntityAnchor
-
-
-Arg = Union[Arg_Entities, Arg_Entity, Arg_Players, Arg_BlockPos, Arg_Pos3d, Arg_Pos2d, Arg_Rotation, Arg_GameMode, Arg_Difficulty, Arg_Item, Arg_ItemPredicate, Arg_ResourceLocation, Arg_Block, Arg_BlockPredicate, Arg_BossbarColor, Arg_BossbarStyle, Arg_Particle, Arg_Msg, Arg_TextComponent, Arg_Time, Arg_Num, Arg_Bool, Arg_Simple, Arg_SoundCategory, Arg_DamageType, Arg_Effect, Arg_Enchantment, Arg_EntityAnchor]
-
-
-class ConsumedArgs:
-    
-    def get_value(self, key: str) -> Arg:
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-
-@dataclass
-class CommandSenderType_Rcon:
-    pass
-
-
-@dataclass
-class CommandSenderType_Console:
-    pass
-
-
-@dataclass
-class CommandSenderType_Player:
-    value: player.Player
-
-
-@dataclass
-class CommandSenderType_CommandBlock:
-    value: Tuple[entity.CommandBlockEntity, world.World]
-
-
-@dataclass
-class CommandSenderType_Dummy:
-    pass
-
-
-CommandSenderType = Union[CommandSenderType_Rcon, CommandSenderType_Console, CommandSenderType_Player, CommandSenderType_CommandBlock, CommandSenderType_Dummy]
-
-
-class PermissionLevel(Enum):
-    ZERO = 0
-    ONE = 1
-    TWO = 2
-    THREE = 3
-    FOUR = 4
-
-class CommandSender:
-    
-    def get_command_sender_type(self) -> CommandSenderType:
-        raise NotImplementedError
-    def send_message(self, text: text.TextComponent) -> None:
-        raise NotImplementedError
-    def set_success_count(self, count: int) -> None:
-        raise NotImplementedError
-    def is_player(self) -> bool:
-        raise NotImplementedError
-    def is_console(self) -> bool:
-        raise NotImplementedError
-    def as_player(self) -> Optional[player.Player]:
-        raise NotImplementedError
-    def permission_level(self) -> PermissionLevel:
-        raise NotImplementedError
-    def has_permission_level(self, level: PermissionLevel) -> bool:
-        raise NotImplementedError
-    def has_permission(self, server: server.Server, node: str) -> bool:
-        raise NotImplementedError
-    def position(self) -> Optional[Tuple[float, float, float]]:
-        raise NotImplementedError
-    def world(self) -> Optional[world.World]:
-        raise NotImplementedError
-    def get_locale(self) -> common.Locale:
-        raise NotImplementedError
-    def should_receive_feedback(self) -> bool:
-        raise NotImplementedError
-    def should_broadcast_console_to_ops(self) -> bool:
-        raise NotImplementedError
-    def should_track_output(self) -> bool:
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-class StringType(Enum):
-    SINGLE_WORD = 0
-    QUOTABLE = 1
-    GREEDY = 2
-
-
-@dataclass
-class ArgumentType_Bool:
-    pass
-
-
-@dataclass
-class ArgumentType_Float:
-    value: Tuple[Optional[float], Optional[float]]
-
-
-@dataclass
-class ArgumentType_Double:
-    value: Tuple[Optional[float], Optional[float]]
-
-
-@dataclass
-class ArgumentType_Integer:
-    value: Tuple[Optional[int], Optional[int]]
-
-
-@dataclass
-class ArgumentType_Long:
-    value: Tuple[Optional[int], Optional[int]]
-
-
-@dataclass
-class ArgumentType_String:
-    value: StringType
-
-
-@dataclass
-class ArgumentType_Entities:
-    pass
-
-
-@dataclass
-class ArgumentType_Entity:
-    pass
-
-
-@dataclass
-class ArgumentType_Players:
-    pass
-
-
-@dataclass
-class ArgumentType_GameProfile:
-    pass
-
-
-@dataclass
-class ArgumentType_BlockPos:
-    pass
-
-
-@dataclass
-class ArgumentType_Position3d:
-    pass
-
-
-@dataclass
-class ArgumentType_Position2d:
-    pass
-
-
-@dataclass
-class ArgumentType_BlockState:
-    pass
-
-
-@dataclass
-class ArgumentType_BlockPredicate:
-    pass
-
-
-@dataclass
-class ArgumentType_Item:
-    pass
-
-
-@dataclass
-class ArgumentType_ItemPredicate:
-    pass
-
-
-@dataclass
-class ArgumentType_Component:
-    pass
-
-
-@dataclass
-class ArgumentType_Rotation:
-    pass
-
-
-@dataclass
-class ArgumentType_ResourceLocation:
-    pass
-
-
-@dataclass
-class ArgumentType_EntityAnchor:
-    pass
-
-
-@dataclass
-class ArgumentType_Gamemode:
-    pass
-
-
-@dataclass
-class ArgumentType_Difficulty:
-    pass
-
-
-@dataclass
-class ArgumentType_Time:
-    value: int
-
-
-@dataclass
-class ArgumentType_Resource:
-    value: str
-
-
-ArgumentType = Union[ArgumentType_Bool, ArgumentType_Float, ArgumentType_Double, ArgumentType_Integer, ArgumentType_Long, ArgumentType_String, ArgumentType_Entities, ArgumentType_Entity, ArgumentType_Players, ArgumentType_GameProfile, ArgumentType_BlockPos, ArgumentType_Position3d, ArgumentType_Position2d, ArgumentType_BlockState, ArgumentType_BlockPredicate, ArgumentType_Item, ArgumentType_ItemPredicate, ArgumentType_Component, ArgumentType_Rotation, ArgumentType_ResourceLocation, ArgumentType_EntityAnchor, ArgumentType_Gamemode, ArgumentType_Difficulty, ArgumentType_Time, ArgumentType_Resource]
-
-
-
-@dataclass
-class CommandError_InvalidConsumption:
-    value: Optional[str]
-
-
-@dataclass
-class CommandError_InvalidRequirement:
-    pass
-
-
-@dataclass
-class CommandError_PermissionDenied:
-    pass
-
-
-@dataclass
-class CommandError_CommandFailed:
-    value: text.TextComponent
-
-
-CommandError = Union[CommandError_InvalidConsumption, CommandError_InvalidRequirement, CommandError_PermissionDenied, CommandError_CommandFailed]
-
-
-class CommandNode:
-    
-    @classmethod
-    def literal(cls, name: str) -> Self:
-        raise NotImplementedError
-    @classmethod
-    def argument(cls, name: str, arg_type: ArgumentType) -> Self:
-        raise NotImplementedError
-    def then(self, node: Self) -> None:
-        raise NotImplementedError
-    def execute_with_handler_id(self, handler_id: int) -> None:
-        raise NotImplementedError
-    def require_with_handler_id(self, handler_id: int) -> None:
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-class Command:
-    
-    def __init__(self, names: List[str], description: str) -> None:
-        """
-        First name is primary, rest are aliases
-        """
-        raise NotImplementedError
-
-    def then(self, node: CommandNode) -> None:
-        raise NotImplementedError
-    def execute_with_handler_id(self, handler_id: int) -> None:
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-

src/pumpkin_api/wit_files/wit_world/imports/common.py

@@ -1,213 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-"""
-Provides common types and utilities used across the entire plugin API.
-"""
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-
-
-class Hand(Enum):
-    """
-    Represents the hands of a player.
-    """
-    LEFT = 0
-    RIGHT = 1
-
-class GameMode(Enum):
-    """
-    Represents the game modes available in Minecraft.
-    """
-    SURVIVAL = 0
-    CREATIVE = 1
-    ADVENTURE = 2
-    SPECTATOR = 3
-
-class NamedColor(Enum):
-    """
-    The 16 base Minecraft colors.
-    """
-    BLACK = 0
-    DARK_BLUE = 1
-    DARK_GREEN = 2
-    DARK_AQUA = 3
-    DARK_RED = 4
-    DARK_PURPLE = 5
-    GOLD = 6
-    GRAY = 7
-    DARK_GRAY = 8
-    BLUE = 9
-    GREEN = 10
-    AQUA = 11
-    RED = 12
-    LIGHT_PURPLE = 13
-    YELLOW = 14
-    WHITE = 15
-
-@dataclass
-class RgbColor:
-    """
-    An RGB color represented by its red, green, and blue components.
-    """
-    r: int
-    g: int
-    b: int
-
-@dataclass
-class ArgbColor:
-    """
-    An ARGB color with alpha (transparency) channel.
-    """
-    a: int
-    r: int
-    g: int
-    b: int
-
-@dataclass
-class ItemStack:
-    """
-    Represents a stack of items with its type and count.
-    """
-    registry_key: str
-    count: int
-
-class Locale(Enum):
-    """
-    All Minecraft-supported locales.
-    """
-    AF_ZA = 0
-    AR_SA = 1
-    AST_ES = 2
-    AZ_AZ = 3
-    BA_RU = 4
-    BAR = 5
-    BE_BY = 6
-    BG_BG = 7
-    BR_FR = 8
-    BRB = 9
-    BS_BA = 10
-    CA_ES = 11
-    CS_CZ = 12
-    CY_GB = 13
-    DA_DK = 14
-    DE_AT = 15
-    DE_CH = 16
-    DE_DE = 17
-    EL_GR = 18
-    EN_AU = 19
-    EN_CA = 20
-    EN_GB = 21
-    EN_NZ = 22
-    EN_PT = 23
-    EN_UD = 24
-    EN_US = 25
-    ENP = 26
-    ENWS = 27
-    EO_UY = 28
-    ES_AR = 29
-    ES_CL = 30
-    ES_EC = 31
-    ES_ES = 32
-    ES_MX = 33
-    ES_UY = 34
-    ES_VE = 35
-    ESAN = 36
-    ET_EE = 37
-    EU_ES = 38
-    FA_IR = 39
-    FI_FI = 40
-    FIL_PH = 41
-    FO_FO = 42
-    FR_CA = 43
-    FR_FR = 44
-    FRA_DE = 45
-    FUR_IT = 46
-    FY_NL = 47
-    GA_IE = 48
-    GD_GB = 49
-    GL_ES = 50
-    HAW_US = 51
-    HE_IL = 52
-    HI_IN = 53
-    HR_HR = 54
-    HU_HU = 55
-    HY_AM = 56
-    ID_ID = 57
-    IG_NG = 58
-    IO_EN = 59
-    IS_IS = 60
-    ISV = 61
-    IT_IT = 62
-    JA_JP = 63
-    JBO_EN = 64
-    KA_GE = 65
-    KK_KZ = 66
-    KN_IN = 67
-    KO_KR = 68
-    KSH = 69
-    KW_GB = 70
-    LA_LA = 71
-    LB_LU = 72
-    LI_LI = 73
-    LMO = 74
-    LO_LA = 75
-    LOL_US = 76
-    LT_LT = 77
-    LV_LV = 78
-    LZH = 79
-    MK_MK = 80
-    MN_MN = 81
-    MS_MY = 82
-    MT_MT = 83
-    NAH = 84
-    NDS_DE = 85
-    NL_BE = 86
-    NL_NL = 87
-    NN_NO = 88
-    NO_NO = 89
-    OC_FR = 90
-    OVD = 91
-    PL_PL = 92
-    PT_BR = 93
-    PT_PT = 94
-    QYA_AA = 95
-    RO_RO = 96
-    RPR = 97
-    RU_RU = 98
-    RY_UA = 99
-    SAH_SAH = 100
-    SE_NO = 101
-    SK_SK = 102
-    SL_SI = 103
-    SO_SO = 104
-    SQ_AL = 105
-    SR_CS = 106
-    SR_SP = 107
-    SV_SE = 108
-    SXU = 109
-    SZL = 110
-    TA_IN = 111
-    TH_TH = 112
-    TL_PH = 113
-    TLH_AA = 114
-    TOK = 115
-    TR_TR = 116
-    TT_RU = 117
-    UK_UA = 118
-    VAL_ES = 119
-    VEC_IT = 120
-    VI_VN = 121
-    YI_DE = 122
-    YO_NG = 123
-    ZH_CN = 124
-    ZH_HK = 125
-    ZH_TW = 126
-    ZLM_ARAB = 127
-
-

src/pumpkin_api/wit_files/wit_world/imports/context.py

@@ -1,70 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-"""
-The core context provided to a plugin during initialization and event handling.
-"""
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-from ..imports import permission
-from ..imports import event
-from ..imports import server
-from ..imports import command
-
-class Context:
-    """
-    A contextual handle for plugin-related operations.
-    """
-    
-    def register_event(self, handler_id: int, event_type: event.EventType, event_priority: event.EventPriority, blocking: bool) -> None:
-        """
-        Registers a handler for a specific event.
-        
-        * `handler-id`: Unique ID for the event handler.
-        * `event-type`: The type of event to listen for.
-        * `event-priority`: When this handler should be called relative to others.
-        * `blocking`: Whether the event should wait for this handler to finish.
-        """
-        raise NotImplementedError
-    def register_command(self, command: command.Command, permission: str) -> None:
-        """
-        Registers a new command.
-        
-        * `command`: The command definition.
-        * `permission`: The required permission node to execute this command.
-        """
-        raise NotImplementedError
-    def register_permission(self, permission: permission.Permission) -> None:
-        """
-        Registers a permission node with the server.
-        
-        Raises: `componentize_py_types.Err(wit_world.imports.str)`
-        """
-        raise NotImplementedError
-    def get_data_folder(self) -> str:
-        """
-        Returns the path to the plugin's private data folder.
-        """
-        raise NotImplementedError
-    def get_server(self) -> server.Server:
-        """
-        Returns the global server instance.
-        """
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-

src/pumpkin_api/wit_files/wit_world/imports/entity.py

@@ -1,84 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-
-
-class BlockEntity:
-    
-    def resource_location(self) -> str:
-        raise NotImplementedError
-    def get_position(self) -> Tuple[int, int, int]:
-        raise NotImplementedError
-    def get_id(self) -> int:
-        raise NotImplementedError
-    def is_dirty(self) -> bool:
-        """
-        write-nbt: func(nbt: nbt-compound);
-        from-nbt: func(nbt: nbt-compound, position: block-position) -> entity;
-        tick: func(world: simple-world);
-        write-internal: func(nbt: nbt-compound);
-        chunk-data-nbt: func() -> option<nbt-compound;
-        get-inventory: func() -> option<inventory>;
-        set-block-state: func(block-state: block-state-id);
-        on-block-replaced: func(world: simple-world, position: block-position);
-        """
-        raise NotImplementedError
-    def clear_dirty(self) -> None:
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-class CommandBlockEntity:
-    
-    def get_block_entity(self) -> BlockEntity:
-        raise NotImplementedError
-    def last_output(self) -> str:
-        raise NotImplementedError
-    def track_output(self) -> bool:
-        raise NotImplementedError
-    def success_count(self) -> int:
-        raise NotImplementedError
-    def command(self) -> str:
-        raise NotImplementedError
-    def auto(self) -> bool:
-        raise NotImplementedError
-    def condition_met(self) -> bool:
-        raise NotImplementedError
-    def powered(self) -> bool:
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-
-@dataclass
-class Entity_CommandBlockEntity:
-    value: CommandBlockEntity
-
-
-Entity = Union[Entity_CommandBlockEntity]
-
-
-

src/pumpkin_api/wit_files/wit_world/imports/event.py

@@ -1,434 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-from ..imports import common
-from ..imports import text
-from ..imports import world
-from ..imports import player
-
-class EventPriority(Enum):
-    HIGHEST = 0
-    HIGH = 1
-    NORMAL = 2
-    LOW = 3
-    LOWEST = 4
-
-@dataclass
-class PlayerJoinEventData:
-    player: player.Player
-    join_message: text.TextComponent
-    cancelled: bool
-
-@dataclass
-class PlayerLeaveEventData:
-    player: player.Player
-    leave_message: text.TextComponent
-    cancelled: bool
-
-@dataclass
-class PlayerLoginEventData:
-    player: player.Player
-    kick_message: text.TextComponent
-    cancelled: bool
-
-@dataclass
-class PlayerChatEventData:
-    player: player.Player
-    message: str
-    recipients: List[player.Player]
-    cancelled: bool
-
-@dataclass
-class PlayerCommandSendEventData:
-    player: player.Player
-    command: str
-    cancelled: bool
-
-@dataclass
-class PlayerPermissionCheckEventData:
-    player: player.Player
-    permission: str
-    permission_result: bool
-
-@dataclass
-class PlayerMoveEventData:
-    player: player.Player
-    from_position: Tuple[float, float, float]
-    to_position: Tuple[float, float, float]
-    cancelled: bool
-
-@dataclass
-class PlayerTeleportEventData:
-    player: player.Player
-    from_position: Tuple[float, float, float]
-    to_position: Tuple[float, float, float]
-    cancelled: bool
-
-@dataclass
-class PlayerChangeWorldEventData:
-    player: player.Player
-    previous_world: world.World
-    new_world: world.World
-    position: Tuple[float, float, float]
-    yaw: float
-    pitch: float
-    cancelled: bool
-
-@dataclass
-class PlayerExpChangeEventData:
-    player: player.Player
-    amount: int
-
-@dataclass
-class PlayerItemHeldEventData:
-    player: player.Player
-    previous_slot: int
-    new_slot: int
-    cancelled: bool
-
-@dataclass
-class PlayerChangedMainHandEventData:
-    player: player.Player
-    main_hand: common.Hand
-
-@dataclass
-class PlayerGamemodeChangeEventData:
-    player: player.Player
-    previous_gamemode: common.GameMode
-    new_gamemode: common.GameMode
-    cancelled: bool
-
-@dataclass
-class PlayerCustomPayloadEventData:
-    player: player.Player
-    channel: str
-    data: bytes
-
-class PlayerFishState(Enum):
-    FISHING = 0
-    CAUGHT_FISH = 1
-    CAUGHT_ENTITY = 2
-    IN_GROUND = 3
-    FAILED_ATTEMPT = 4
-    REEL_IN = 5
-    BITE = 6
-
-@dataclass
-class PlayerFishEventData:
-    player: player.Player
-    caught_uuid: Optional[str]
-    caught_type: str
-    hook_uuid: str
-    state: PlayerFishState
-    hand: common.Hand
-    exp_to_drop: int
-    cancelled: bool
-
-@dataclass
-class PlayerEggThrowEventData:
-    player: player.Player
-    egg_uuid: str
-    hatching: bool
-    num_hatches: int
-    hatching_type: str
-    cancelled: bool
-
-class EntityInteractionAction(Enum):
-    INTERACT = 0
-    ATTACK = 1
-    INTERACT_AT = 2
-
-class InteractAction(Enum):
-    LEFT_CLICK_BLOCK = 0
-    LEFT_CLICK_AIR = 1
-    RIGHT_CLICK_AIR = 2
-    RIGHT_CLICK_BLOCK = 3
-
-@dataclass
-class PlayerInteractEventData:
-    player: player.Player
-    action: InteractAction
-    clicked_pos: Optional[Tuple[int, int, int]]
-    item: common.ItemStack
-    block: str
-    cancelled: bool
-
-@dataclass
-class PlayerToggleSneakEventData:
-    player: player.Player
-    is_sneaking: bool
-    cancelled: bool
-
-@dataclass
-class PlayerToggleSprintEventData:
-    player: player.Player
-    is_sprinting: bool
-    cancelled: bool
-
-@dataclass
-class PlayerInteractUnknownEntityEventData:
-    player: player.Player
-    entity_id: int
-    action: EntityInteractionAction
-    cancelled: bool
-
-@dataclass
-class BlockRedstoneEventData:
-    target_world: world.World
-    state_id: int
-    block_position: Tuple[int, int, int]
-    old_current: int
-    new_current: int
-    cancelled: bool
-
-@dataclass
-class BlockBreakEventData:
-    player: Optional[player.Player]
-    block: str
-    block_position: Tuple[int, int, int]
-    exp: int
-    should_drop: bool
-    cancelled: bool
-
-@dataclass
-class BlockBurnEventData:
-    igniting_block: str
-    block: str
-    cancelled: bool
-
-@dataclass
-class BlockCanBuildEventData:
-    block_to_build: str
-    buildable: bool
-    player: player.Player
-    block: str
-    cancelled: bool
-
-@dataclass
-class BlockGrowEventData:
-    target_world: world.World
-    old_block: str
-    old_state_id: int
-    new_block: str
-    new_state_id: int
-    block_position: Tuple[int, int, int]
-    cancelled: bool
-
-@dataclass
-class BlockPlaceEventData:
-    player: player.Player
-    block_placed: str
-    block_placed_against: str
-    block_position: Tuple[int, int, int]
-    can_build: bool
-    cancelled: bool
-
-@dataclass
-class ServerCommandEventData:
-    command: str
-    cancelled: bool
-
-@dataclass
-class SpawnChangeEventData:
-    target_world: world.World
-    previous_position: Tuple[int, int, int]
-    previous_yaw: float
-    previous_pitch: float
-    new_position: Tuple[int, int, int]
-    new_yaw: float
-    new_pitch: float
-
-@dataclass
-class ServerBroadcastEventData:
-    message: text.TextComponent
-    sender: text.TextComponent
-    cancelled: bool
-
-class EventType(Enum):
-    PLAYER_JOIN_EVENT = 0
-    PLAYER_LEAVE_EVENT = 1
-    PLAYER_LOGIN_EVENT = 2
-    PLAYER_CHAT_EVENT = 3
-    PLAYER_COMMAND_SEND_EVENT = 4
-    PLAYER_PERMISSION_CHECK_EVENT = 5
-    PLAYER_MOVE_EVENT = 6
-    PLAYER_TELEPORT_EVENT = 7
-    PLAYER_CHANGE_WORLD_EVENT = 8
-    PLAYER_EXP_CHANGE_EVENT = 9
-    PLAYER_ITEM_HELD_EVENT = 10
-    PLAYER_CHANGED_MAIN_HAND_EVENT = 11
-    PLAYER_GAMEMODE_CHANGE_EVENT = 12
-    PLAYER_CUSTOM_PAYLOAD_EVENT = 13
-    PLAYER_FISH_EVENT = 14
-    PLAYER_EGG_THROW_EVENT = 15
-    PLAYER_INTERACT_UNKNOWN_ENTITY_EVENT = 16
-    PLAYER_INTERACT_EVENT = 17
-    PLAYER_TOGGLE_SNEAK_EVENT = 18
-    PLAYER_TOGGLE_SPRINT_EVENT = 19
-    BLOCK_REDSTONE_EVENT = 20
-    BLOCK_BREAK_EVENT = 21
-    BLOCK_BURN_EVENT = 22
-    BLOCK_CAN_BUILD_EVENT = 23
-    BLOCK_GROW_EVENT = 24
-    BLOCK_PLACE_EVENT = 25
-    SERVER_COMMAND_EVENT = 26
-    SPAWN_CHANGE_EVENT = 27
-    SERVER_BROADCAST_EVENT = 28
-
-
-@dataclass
-class Event_PlayerJoinEvent:
-    value: PlayerJoinEventData
-
-
-@dataclass
-class Event_PlayerLeaveEvent:
-    value: PlayerLeaveEventData
-
-
-@dataclass
-class Event_PlayerLoginEvent:
-    value: PlayerLoginEventData
-
-
-@dataclass
-class Event_PlayerChatEvent:
-    value: PlayerChatEventData
-
-
-@dataclass
-class Event_PlayerCommandSendEvent:
-    value: PlayerCommandSendEventData
-
-
-@dataclass
-class Event_PlayerPermissionCheckEvent:
-    value: PlayerPermissionCheckEventData
-
-
-@dataclass
-class Event_PlayerMoveEvent:
-    value: PlayerMoveEventData
-
-
-@dataclass
-class Event_PlayerTeleportEvent:
-    value: PlayerTeleportEventData
-
-
-@dataclass
-class Event_PlayerChangeWorldEvent:
-    value: PlayerChangeWorldEventData
-
-
-@dataclass
-class Event_PlayerExpChangeEvent:
-    value: PlayerExpChangeEventData
-
-
-@dataclass
-class Event_PlayerItemHeldEvent:
-    value: PlayerItemHeldEventData
-
-
-@dataclass
-class Event_PlayerChangedMainHandEvent:
-    value: PlayerChangedMainHandEventData
-
-
-@dataclass
-class Event_PlayerGamemodeChangeEvent:
-    value: PlayerGamemodeChangeEventData
-
-
-@dataclass
-class Event_PlayerCustomPayloadEvent:
-    value: PlayerCustomPayloadEventData
-
-
-@dataclass
-class Event_PlayerFishEvent:
-    value: PlayerFishEventData
-
-
-@dataclass
-class Event_PlayerEggThrowEvent:
-    value: PlayerEggThrowEventData
-
-
-@dataclass
-class Event_PlayerInteractUnknownEntityEvent:
-    value: PlayerInteractUnknownEntityEventData
-
-
-@dataclass
-class Event_PlayerInteractEvent:
-    value: PlayerInteractEventData
-
-
-@dataclass
-class Event_PlayerToggleSneakEvent:
-    value: PlayerToggleSneakEventData
-
-
-@dataclass
-class Event_PlayerToggleSprintEvent:
-    value: PlayerToggleSprintEventData
-
-
-@dataclass
-class Event_BlockRedstoneEvent:
-    value: BlockRedstoneEventData
-
-
-@dataclass
-class Event_BlockBreakEvent:
-    value: BlockBreakEventData
-
-
-@dataclass
-class Event_BlockBurnEvent:
-    value: BlockBurnEventData
-
-
-@dataclass
-class Event_BlockCanBuildEvent:
-    value: BlockCanBuildEventData
-
-
-@dataclass
-class Event_BlockGrowEvent:
-    value: BlockGrowEventData
-
-
-@dataclass
-class Event_BlockPlaceEvent:
-    value: BlockPlaceEventData
-
-
-@dataclass
-class Event_ServerCommandEvent:
-    value: ServerCommandEventData
-
-
-@dataclass
-class Event_SpawnChangeEvent:
-    value: SpawnChangeEventData
-
-
-@dataclass
-class Event_ServerBroadcastEvent:
-    value: ServerBroadcastEventData
-
-
-Event = Union[Event_PlayerJoinEvent, Event_PlayerLeaveEvent, Event_PlayerLoginEvent, Event_PlayerChatEvent, Event_PlayerCommandSendEvent, Event_PlayerPermissionCheckEvent, Event_PlayerMoveEvent, Event_PlayerTeleportEvent, Event_PlayerChangeWorldEvent, Event_PlayerExpChangeEvent, Event_PlayerItemHeldEvent, Event_PlayerChangedMainHandEvent, Event_PlayerGamemodeChangeEvent, Event_PlayerCustomPayloadEvent, Event_PlayerFishEvent, Event_PlayerEggThrowEvent, Event_PlayerInteractUnknownEntityEvent, Event_PlayerInteractEvent, Event_PlayerToggleSneakEvent, Event_PlayerToggleSprintEvent, Event_BlockRedstoneEvent, Event_BlockBreakEvent, Event_BlockBurnEvent, Event_BlockCanBuildEvent, Event_BlockGrowEvent, Event_BlockPlaceEvent, Event_ServerCommandEvent, Event_SpawnChangeEvent, Event_ServerBroadcastEvent]
-
-
-

src/pumpkin_api/wit_files/wit_world/imports/gui.py

@@ -1,61 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-from ..imports import common
-from ..imports import text
-
-class GuiType(Enum):
-    GENERIC_9X1 = 0
-    GENERIC_9X2 = 1
-    GENERIC_9X3 = 2
-    GENERIC_9X4 = 3
-    GENERIC_9X5 = 4
-    GENERIC_9X6 = 5
-    GENERIC_3X3 = 6
-    CRAFTER_3X3 = 7
-    ANVIL = 8
-    BEACON = 9
-    BLAST_FURNACE = 10
-    BREWING_STAND = 11
-    CRAFTING = 12
-    ENCHANTMENT = 13
-    FURNACE = 14
-    GRINDSTONE = 15
-    HOPPER = 16
-    LECTERN = 17
-    LOOM = 18
-    MERCHANT = 19
-    SHULKER_BOX = 20
-    SMITHING = 21
-    SMOKER = 22
-    CARTOGRAPHY_TABLE = 23
-    STONECUTTER = 24
-
-class Gui:
-    
-    def __init__(self, type: GuiType, title: text.TextComponent) -> None:
-        raise NotImplementedError
-
-    def set_item(self, slot: int, item: common.ItemStack) -> None:
-        raise NotImplementedError
-    def get_item(self, slot: int) -> Optional[common.ItemStack]:
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-

src/pumpkin_api/wit_files/wit_world/imports/i18n.py

@@ -1,35 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-from ..imports import common
-
-
-def translate(key: str, locale: common.Locale) -> str:
-    """
-    Retrieves a translated string from the host.
-    
-    # Arguments
-    * `key`: The namespaced translation key (e.g. `pumpkin:my_key`).
-    * `locale`: The target locale.
-    
-    # Returns
-    The localized string, falling back to English or the key itself.
-    """
-    raise NotImplementedError
-def load_translations(namespace: str, json: str, locale: common.Locale) -> None:
-    """
-    Loads custom translations from a JSON string.
-    
-    # Arguments
-    * `namespace`: The namespace to associate these keys with.
-    * `json`: A JSON string containing a flat map of translations.
-    * `locale`: The target locale for these translations.
-    """
-    raise NotImplementedError

src/pumpkin_api/wit_files/wit_world/imports/logging.py

@@ -1,30 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-
-
-class Level(Enum):
-    TRACE = 0
-    DEBUG = 1
-    INFO = 2
-    WARN = 3
-    ERROR = 4
-
-
-def log(level: Level, message: str) -> None:
-    """
-    log any general purpose message
-    """
-    raise NotImplementedError
-def log_tracing(event: bytes) -> None:
-    """
-    This function is meant to be used by the tracing crate.
-    """
-    raise NotImplementedError

src/pumpkin_api/wit_files/wit_world/imports/permission.py

@@ -1,71 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-
-
-class PermissionLevel(Enum):
-    """
-    Represents the player's permission level
-    
-    Permission levels determine the player's access to commands and server operations.
-    Each numeric level corresponds to a specific role:
-    - `Zero`: `normal`: Player can use basic commands.
-    - `One`: `moderator`: Player can bypass spawn protection.
-    - `Two`: `gamemaster`: Player or executor can use more commands and player can use command blocks.
-    - `Three`:  `admin`: Player or executor can use commands related to multiplayer management.
-    - `Four`: `owner`: Player or executor can use all of the commands, including commands related to server management.
-    """
-    ZERO = 0
-    ONE = 1
-    TWO = 2
-    THREE = 3
-    FOUR = 4
-
-
-@dataclass
-class PermissionDefault_Deny:
-    pass
-
-
-@dataclass
-class PermissionDefault_Allow:
-    pass
-
-
-@dataclass
-class PermissionDefault_Op:
-    value: PermissionLevel
-
-
-PermissionDefault = Union[PermissionDefault_Deny, PermissionDefault_Allow, PermissionDefault_Op]
-"""
-Describes the default behavior for permissions
-"""
-
-
-@dataclass
-class PermissionChild:
-    """
-    A child permission entry
-    """
-    node: str
-    value: bool
-
-@dataclass
-class Permission:
-    """
-    Defines a permission node in the system
-    """
-    node: str
-    description: str
-    default: PermissionDefault
-    children: List[PermissionChild]
-
-

src/pumpkin_api/wit_files/wit_world/imports/player.py

@@ -1,350 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-"""
-Represents a player connected to the Minecraft server.
-"""
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-from ..imports import common
-from ..imports import permission
-from ..imports import text
-from ..imports import gui
-from ..imports import world
-
-@dataclass
-class PlayerAbilities:
-    """
-    Various abilities a player can have.
-    """
-    invulnerable: bool
-    flying: bool
-    allow_flying: bool
-    creative: bool
-    allow_modify_world: bool
-    fly_speed: float
-    walk_speed: float
-
-class Player:
-    """
-    A handle to a player on the server.
-    """
-    
-    def get_id(self) -> str:
-        """
-        Returns the player's unique UUID as a string.
-        """
-        raise NotImplementedError
-    def get_name(self) -> str:
-        """
-        Returns the player's username.
-        """
-        raise NotImplementedError
-    def get_position(self) -> Tuple[float, float, float]:
-        """
-        Basic state
-        Returns the player's current position in the world.
-        """
-        raise NotImplementedError
-    def get_yaw(self) -> float:
-        """
-        Returns the player's current yaw (horizontal rotation).
-        """
-        raise NotImplementedError
-    def get_pitch(self) -> float:
-        """
-        Returns the player's current pitch (vertical rotation).
-        """
-        raise NotImplementedError
-    def get_world(self) -> world.World:
-        """
-        Returns the world the player is currently in.
-        """
-        raise NotImplementedError
-    def get_gamemode(self) -> common.GameMode:
-        """
-        Returns the player's current game mode.
-        """
-        raise NotImplementedError
-    def set_gamemode(self, mode: common.GameMode) -> bool:
-        """
-        Changes the player's game mode. Returns true if successful.
-        """
-        raise NotImplementedError
-    def get_locale(self) -> str:
-        """
-        Returns the player's locale (e.g., "en_us").
-        """
-        raise NotImplementedError
-    def get_ping(self) -> int:
-        """
-        Returns the player's current ping in milliseconds.
-        """
-        raise NotImplementedError
-    def get_permission_level(self) -> permission.PermissionLevel:
-        """
-        Permissions & metadata
-        Returns the player's permission level (0-4).
-        """
-        raise NotImplementedError
-    def set_permission_level(self, level: permission.PermissionLevel) -> None:
-        """
-        Sets the player's permission level.
-        """
-        raise NotImplementedError
-    def has_permission(self, node: str) -> bool:
-        """
-        Checks if the player has a specific permission node.
-        """
-        raise NotImplementedError
-    def get_display_name(self) -> text.TextComponent:
-        """
-        Returns the player's display name, which may include formatting.
-        """
-        raise NotImplementedError
-    def send_system_message(self, text: text.TextComponent, overlay: bool) -> None:
-        """
-        Messaging & titles
-        Sends a system message to the player's chat.
-        """
-        raise NotImplementedError
-    def show_title(self, text: text.TextComponent) -> None:
-        """
-        Shows a large title on the player's screen.
-        """
-        raise NotImplementedError
-    def show_subtitle(self, text: text.TextComponent) -> None:
-        """
-        Shows a smaller subtitle on the player's screen.
-        """
-        raise NotImplementedError
-    def show_actionbar(self, text: text.TextComponent) -> None:
-        """
-        Shows a message in the action bar area.
-        """
-        raise NotImplementedError
-    def send_title_animation(self, fade_in: int, stay: int, fade_out: int) -> None:
-        """
-        Sets the fade-in, stay, and fade-out times for titles.
-        """
-        raise NotImplementedError
-    def teleport(self, position: Tuple[float, float, float], yaw: Optional[float], pitch: Optional[float], world: world.World) -> None:
-        """
-        Teleport & kick
-        Teleports the player to a position in a world.
-        """
-        raise NotImplementedError
-    def teleport_world(self, world_ref: world.World, position: Tuple[float, float, float], yaw: Optional[float], pitch: Optional[float]) -> None:
-        """
-        Teleports the player to another world at a specific position.
-        """
-        raise NotImplementedError
-    def kick(self, message: text.TextComponent) -> None:
-        """
-        Kicks the player from the server with the specified reason.
-        """
-        raise NotImplementedError
-    def respawn(self) -> None:
-        """
-        Forces the player to respawn.
-        """
-        raise NotImplementedError
-    def open_gui(self, gui_ref: gui.Gui) -> None:
-        """
-        Opens a GUI for the player.
-        """
-        raise NotImplementedError
-    def ban(self, reason: Optional[text.TextComponent]) -> None:
-        """
-        Bans the player with an optional reason.
-        """
-        raise NotImplementedError
-    def ban_ip(self, reason: Optional[text.TextComponent]) -> None:
-        """
-        Bans the player's IP address with an optional reason.
-        """
-        raise NotImplementedError
-    def get_selected_slot(self) -> int:
-        """
-        Inventory
-        Returns the index of the currently selected hotbar slot (0-8).
-        """
-        raise NotImplementedError
-    def get_item_in_hand(self, hand: common.Hand) -> Optional[common.ItemStack]:
-        """
-        Returns the item currently in the specified hand.
-        """
-        raise NotImplementedError
-    def get_inventory_item(self, slot: int) -> Optional[common.ItemStack]:
-        """
-        Returns the item in the specified inventory slot.
-        """
-        raise NotImplementedError
-    def get_health(self) -> float:
-        """
-        Status
-        Returns the player's current health.
-        """
-        raise NotImplementedError
-    def set_health(self, health: float) -> None:
-        """
-        Sets the player's current health.
-        """
-        raise NotImplementedError
-    def get_max_health(self) -> float:
-        """
-        Returns the player's maximum health.
-        """
-        raise NotImplementedError
-    def set_max_health(self, max_health: float) -> None:
-        """
-        Sets the player's maximum health.
-        """
-        raise NotImplementedError
-    def get_food_level(self) -> int:
-        """
-        Returns the player's food level (0-20).
-        """
-        raise NotImplementedError
-    def set_food_level(self, food_level: int) -> None:
-        """
-        Sets the player's food level.
-        """
-        raise NotImplementedError
-    def get_saturation(self) -> float:
-        """
-        Returns the player's food saturation level.
-        """
-        raise NotImplementedError
-    def set_saturation(self, saturation: float) -> None:
-        """
-        Sets the player's food saturation level.
-        """
-        raise NotImplementedError
-    def get_exhaustion(self) -> float:
-        """
-        Returns the player's food exhaustion level.
-        """
-        raise NotImplementedError
-    def set_exhaustion(self, exhaustion: float) -> None:
-        """
-        Sets the player's food exhaustion level.
-        """
-        raise NotImplementedError
-    def get_absorption(self) -> float:
-        """
-        Returns the player's current absorption amount.
-        """
-        raise NotImplementedError
-    def set_absorption(self, absorption: float) -> None:
-        """
-        Sets the player's current absorption amount.
-        """
-        raise NotImplementedError
-    def get_experience_level(self) -> int:
-        """
-        Returns the player's total experience level.
-        """
-        raise NotImplementedError
-    def get_experience_progress(self) -> float:
-        """
-        Returns the player's progress toward the next level (0.0 to 1.0).
-        """
-        raise NotImplementedError
-    def get_experience_points(self) -> int:
-        """
-        Returns the total experience points the player has.
-        """
-        raise NotImplementedError
-    def set_experience_level(self, level: int) -> None:
-        """
-        Sets the player's total experience level.
-        """
-        raise NotImplementedError
-    def set_experience_progress(self, progress: float) -> None:
-        """
-        Sets the player's progress toward the next level.
-        """
-        raise NotImplementedError
-    def set_experience_points(self, points: int) -> None:
-        """
-        Sets the player's total experience points.
-        """
-        raise NotImplementedError
-    def add_experience_levels(self, levels: int) -> None:
-        """
-        Adds experience levels to the player.
-        """
-        raise NotImplementedError
-    def add_experience_points(self, points: int) -> None:
-        """
-        Adds experience points to the player.
-        """
-        raise NotImplementedError
-    def is_sneaking(self) -> bool:
-        """
-        Returns whether the player is currently sneaking.
-        """
-        raise NotImplementedError
-    def set_sneaking(self, sneaking: bool) -> None:
-        """
-        Sets whether the player is currently sneaking.
-        """
-        raise NotImplementedError
-    def is_sprinting(self) -> bool:
-        """
-        Returns whether the player is currently sprinting.
-        """
-        raise NotImplementedError
-    def set_sprinting(self, sprinting: bool) -> None:
-        """
-        Sets whether the player is currently sprinting.
-        """
-        raise NotImplementedError
-    def is_on_ground(self) -> bool:
-        """
-        Returns whether the player is currently on the ground.
-        """
-        raise NotImplementedError
-    def is_flying(self) -> bool:
-        """
-        Returns whether the player is currently flying.
-        """
-        raise NotImplementedError
-    def set_flying(self, flying: bool) -> None:
-        """
-        Sets whether the player should be flying.
-        """
-        raise NotImplementedError
-    def get_abilities(self) -> PlayerAbilities:
-        """
-        Returns the player's current abilities.
-        """
-        raise NotImplementedError
-    def set_abilities(self, abilities: PlayerAbilities) -> None:
-        """
-        Updates the player's abilities.
-        """
-        raise NotImplementedError
-    def get_ip(self) -> str:
-        """
-        Returns the player's IP address.
-        """
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-

src/pumpkin_api/wit_files/wit_world/imports/scheduler.py

@@ -1,44 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-"""
-Provides functionality to schedule tasks to be executed later on the server.
-"""
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-
-
-
-def schedule_delayed_task(handler_id: int, delay_ticks: int) -> int:
-    """
-    Schedules a task to be executed once after the specified number of ticks.
-    
-    * `handler-id`: The unique ID of the handler to call when the task executes.
-    * `delay-ticks`: The number of game ticks to wait before execution (20 ticks = 1 second).
-    
-    Returns a unique task ID that can be used to cancel the task.
-    """
-    raise NotImplementedError
-def schedule_repeating_task(handler_id: int, delay_ticks: int, period_ticks: int) -> int:
-    """
-    Schedules a task to be executed repeatedly.
-    
-    * `handler-id`: The unique ID of the handler to call when the task executes.
-    * `delay-ticks`: The number of game ticks to wait before the first execution.
-    * `period-ticks`: The number of game ticks between subsequent executions.
-    
-    Returns a unique task ID that can be used to cancel the task.
-    """
-    raise NotImplementedError
-def cancel_task(task_id: int) -> None:
-    """
-    Cancels a scheduled task if it hasn't finished yet.
-    
-    * `task-id`: The ID of the task to cancel.
-    """
-    raise NotImplementedError

src/pumpkin_api/wit_files/wit_world/imports/scoreboard.py

@@ -1,95 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-from ..imports import common
-from ..imports import text
-
-class RenderType(Enum):
-    INTEGER = 0
-    HEARTS = 1
-
-class DisplaySlot(Enum):
-    PLAYER_LIST = 0
-    SIDEBAR = 1
-    BELOW_NAME = 2
-    SIDEBAR_TEAM_BLACK = 3
-    SIDEBAR_TEAM_DARK_BLUE = 4
-    SIDEBAR_TEAM_DARK_GREEN = 5
-    SIDEBAR_TEAM_DARK_AQUA = 6
-    SIDEBAR_TEAM_DARK_RED = 7
-    SIDEBAR_TEAM_DARK_PURPLE = 8
-    SIDEBAR_TEAM_GOLD = 9
-    SIDEBAR_TEAM_GRAY = 10
-    SIDEBAR_TEAM_DARK_GRAY = 11
-    SIDEBAR_TEAM_BLUE = 12
-    SIDEBAR_TEAM_GREEN = 13
-    SIDEBAR_TEAM_AQUA = 14
-    SIDEBAR_TEAM_RED = 15
-    SIDEBAR_TEAM_LIGHT_PURPLE = 16
-    SIDEBAR_TEAM_YELLOW = 17
-    SIDEBAR_TEAM_WHITE = 18
-
-class NametagVisibility(Enum):
-    ALWAYS = 0
-    NEVER = 1
-    HIDE_FOR_OTHER_TEAMS = 2
-    HIDE_FOR_OWN_TEAM = 3
-
-class CollisionRule(Enum):
-    ALWAYS = 0
-    NEVER = 1
-    PUSH_OTHER_TEAMS = 2
-    PUSH_OWN_TEAM = 3
-
-@dataclass
-class TeamSettings:
-    display_name: text.TextComponent
-    friendly_fire: bool
-    see_friendly_invisibles: bool
-    nametag_visibility: NametagVisibility
-    collision_rule: CollisionRule
-    color: common.NamedColor
-    prefix: text.TextComponent
-    suffix: text.TextComponent
-
-class Scoreboard:
-    
-    def add_objective(self, name: str, display_name: text.TextComponent, render_type: RenderType) -> None:
-        raise NotImplementedError
-    def remove_objective(self, name: str) -> None:
-        raise NotImplementedError
-    def set_display_slot(self, slot: DisplaySlot, objective_name: str) -> None:
-        raise NotImplementedError
-    def update_score(self, entity_name: str, objective_name: str, value: int) -> None:
-        raise NotImplementedError
-    def remove_score(self, entity_name: str, objective_name: str) -> None:
-        raise NotImplementedError
-    def create_team(self, name: str, settings: TeamSettings) -> None:
-        raise NotImplementedError
-    def remove_team(self, name: str) -> None:
-        raise NotImplementedError
-    def update_team(self, name: str, settings: TeamSettings) -> None:
-        raise NotImplementedError
-    def add_player_to_team(self, team_name: str, player_name: str) -> None:
-        raise NotImplementedError
-    def remove_player_from_team(self, team_name: str, player_name: str) -> None:
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-

src/pumpkin_api/wit_files/wit_world/imports/server.py

@@ -1,75 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-from ..imports import player
-
-class Difficulty(Enum):
-    """
-    Represents the difficulty setting of a Minecraft server.
-    """
-    PEACEFUL = 0
-    EASY = 1
-    NORMAL = 2
-    HARD = 3
-
-class Server:
-    """
-    Represents the global server instance.
-    """
-    
-    def get_difficulty(self) -> Difficulty:
-        """
-        Returns the current difficulty level of the server.
-        """
-        raise NotImplementedError
-    def get_player_count(self) -> int:
-        """
-        Returns the total number of players currently connected to the server.
-        """
-        raise NotImplementedError
-    def get_mspt(self) -> float:
-        """
-        Returns the rolling average Milliseconds Per Tick (MSPT).
-        A value below 50.0 is required for a stable 20 TPS.
-        """
-        raise NotImplementedError
-    def get_tps(self) -> float:
-        """
-        Returns the effective Ticks Per Second (TPS).
-        Ideal value is 20.0.
-        """
-        raise NotImplementedError
-    def get_all_players(self) -> List[player.Player]:
-        """
-        Returns a list of all online players across all worlds.
-        """
-        raise NotImplementedError
-    def get_player_by_name(self, name: str) -> Optional[player.Player]:
-        """
-        Searches for a player by their exact name.
-        """
-        raise NotImplementedError
-    def get_player_by_uuid(self, id: str) -> Optional[player.Player]:
-        """
-        Searches for a player by their UUID string.
-        """
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-

src/pumpkin_api/wit_files/wit_world/imports/text.py

@@ -1,89 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-from ..imports import common
-
-class TextComponent:
-    
-    @classmethod
-    def text(cls, plain: str) -> Self:
-        raise NotImplementedError
-    @classmethod
-    def translate(cls, key: str, with_: List[Self]) -> Self:
-        raise NotImplementedError
-    def add_child(self, child: Self) -> None:
-        raise NotImplementedError
-    def add_text(self, text: str) -> None:
-        raise NotImplementedError
-    def get_text(self) -> str:
-        raise NotImplementedError
-    def encode(self) -> bytes:
-        raise NotImplementedError
-    def color_named(self, color: common.NamedColor) -> None:
-        """
-        Style
-        """
-        raise NotImplementedError
-    def color_rgb(self, color: common.RgbColor) -> None:
-        raise NotImplementedError
-    def bold(self, value: bool) -> None:
-        raise NotImplementedError
-    def italic(self, value: bool) -> None:
-        raise NotImplementedError
-    def underlined(self, value: bool) -> None:
-        raise NotImplementedError
-    def strikethrough(self, value: bool) -> None:
-        raise NotImplementedError
-    def obfuscated(self, value: bool) -> None:
-        raise NotImplementedError
-    def insertion(self, text: str) -> None:
-        """
-        Text inserted into chat when shift-clicked
-        """
-        raise NotImplementedError
-    def font(self, font: str) -> None:
-        raise NotImplementedError
-    def shadow_color(self, color: common.ArgbColor) -> None:
-        raise NotImplementedError
-    def click_open_url(self, url: str) -> None:
-        """
-        Click events
-        """
-        raise NotImplementedError
-    def click_run_command(self, command: str) -> None:
-        raise NotImplementedError
-    def click_suggest_command(self, command: str) -> None:
-        raise NotImplementedError
-    def click_copy_to_clipboard(self, text: str) -> None:
-        raise NotImplementedError
-    def hover_show_text(self, text: Self) -> None:
-        """
-        Hover events
-        """
-        raise NotImplementedError
-    def hover_show_item(self, item: str) -> None:
-        """
-        Item data as SNBT string
-        """
-        raise NotImplementedError
-    def hover_show_entity(self, entity_type: str, id: str, name: Optional[Self]) -> None:
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-

src/pumpkin_api/wit_files/wit_world/imports/world.py

@@ -1,215 +0,0 @@
-# This file is automatically generated by componentize-py
-# It is not intended for manual editing.
-from typing import TypeVar, Generic, Union, Optional, Protocol, Tuple, List, Any, Self, Callable
-from types import TracebackType
-from enum import Flag, Enum, auto
-from dataclasses import dataclass
-from abc import abstractmethod
-import weakref
-
-from componentize_py_types import Result, Ok, Err, Some
-from ..imports import text
-from ..imports import scoreboard
-
-class PistonBehavior(Enum):
-    """
-    Defines how a block reacts when pushed by a piston.
-    """
-    NORMAL = 0
-    DESTROY = 1
-    BLOCK = 2
-    IGNORE = 3
-    PUSH_ONLY = 4
-
-class SoundCategory(Enum):
-    """
-    Categories for sounds to control their volume independently.
-    """
-    MASTER = 0
-    MUSIC = 1
-    RECORDS = 2
-    WEATHER = 3
-    BLOCKS = 4
-    HOSTILE = 5
-    NEUTRAL = 6
-    PLAYERS = 7
-    AMBIENT = 8
-    VOICE = 9
-
-class ExplosionInteraction(Enum):
-    """
-    Defines how an explosion interacts with blocks in the world.
-    """
-    NONE = 0
-    BLOCK = 1
-    MOB = 2
-    TNT = 3
-    TRIGGER = 4
-
-class BlockFlags(Flag):
-    """
-    Flags used to control block updates and notifications.
-    """
-    NOTIFY_NEIGHBORS = auto()
-    NOTIFY_LISTENERS = auto()
-    FORCE_STATE = auto()
-    SKIP_DROPS = auto()
-    MOVED = auto()
-    SKIP_REDSTONE_WIRE_STATE_REPLACEMENT = auto()
-    SKIP_BLOCK_ENTITY_REPLACED_CALLBACK = auto()
-    SKIP_BLOCK_ADDED_CALLBACK = auto()
-
-@dataclass
-class BlockState:
-    """
-    Detailed information about a block's state.
-    """
-    id: int
-    luminance: int
-    opacity: int
-    hardness: float
-    is_air: bool
-    is_liquid: bool
-    is_solid: bool
-    is_full_cube: bool
-    piston_behavior: PistonBehavior
-    has_random_ticks: bool
-
-@dataclass
-class BlockStateId:
-    """
-    A simple wrapper for a block state ID.
-    """
-    id: int
-
-@dataclass
-class BlockPos:
-    """
-    A position in the world grid.
-    """
-    x: int
-    y: int
-    z: int
-
-class World:
-    """
-    Represents a Minecraft world (dimension).
-    """
-    
-    def get_id(self) -> str:
-        """
-        Returns the unique identifier of this world.
-        """
-        raise NotImplementedError
-    def get_block_state_id(self, pos: BlockPos) -> int:
-        """
-        Gets the block state ID at the specified position.
-        """
-        raise NotImplementedError
-    def get_block_state(self, pos: BlockPos) -> BlockState:
-        """
-        Gets detailed block state information at the specified position.
-        """
-        raise NotImplementedError
-    def set_block_state(self, pos: BlockPos, state: int, update_flags: BlockFlags) -> None:
-        """
-        Sets the block state at the specified position.
-        """
-        raise NotImplementedError
-    def get_time_of_day(self) -> int:
-        """
-        Returns the current time of day in ticks.
-        """
-        raise NotImplementedError
-    def set_time_of_day(self, time: int) -> None:
-        """
-        Sets the current time of day in ticks.
-        """
-        raise NotImplementedError
-    def get_world_age(self) -> int:
-        """
-        Returns the total age of the world in ticks.
-        """
-        raise NotImplementedError
-    def get_dimension(self) -> str:
-        """
-        Returns the dimension type (e.g., "minecraft:overworld").
-        """
-        raise NotImplementedError
-    def get_top_block_y(self, x: int, z: int) -> int:
-        """
-        Gets the highest non-air block Y coordinate at the specified X and Z.
-        """
-        raise NotImplementedError
-    def get_motion_blocking_height(self, x: int, z: int) -> int:
-        """
-        Gets the highest motion-blocking block Y coordinate.
-        """
-        raise NotImplementedError
-    def is_raining(self) -> bool:
-        """
-        Returns whether it is currently raining or snowing.
-        """
-        raise NotImplementedError
-    def set_raining(self, raining: bool) -> None:
-        """
-        Sets whether it should be raining or snowing.
-        """
-        raise NotImplementedError
-    def is_thundering(self) -> bool:
-        """
-        Returns whether there is currently a thunderstorm.
-        """
-        raise NotImplementedError
-    def set_thundering(self, thundering: bool) -> None:
-        """
-        Sets whether there should be a thunderstorm.
-        """
-        raise NotImplementedError
-    def broadcast_system_message(self, message: text.TextComponent, overlay: bool) -> None:
-        """
-        Broadcasts a system message to all players in this world.
-        """
-        raise NotImplementedError
-    def get_scoreboard(self) -> scoreboard.Scoreboard:
-        """
-        Returns the scoreboard associated with this world.
-        """
-        raise NotImplementedError
-    def play_sound(self, sound: str, category: SoundCategory, pos: Tuple[float, float, float], volume: float, pitch: float) -> None:
-        """
-        Plays a sound at the specified position for all players in the world.
-        """
-        raise NotImplementedError
-    def spawn_particle(self, particle: str, pos: Tuple[float, float, float], offset: Tuple[float, float, float], max_speed: float, count: int) -> None:
-        """
-        Spawns particles at the specified position.
-        """
-        raise NotImplementedError
-    def create_explosion(self, pos: Tuple[float, float, float], power: float, create_fire: bool, interaction: ExplosionInteraction) -> None:
-        """
-        Creates an explosion at the specified position.
-        """
-        raise NotImplementedError
-    def get_sea_level(self) -> int:
-        """
-        Returns the sea level of this world.
-        """
-        raise NotImplementedError
-    def get_min_y(self) -> int:
-        """
-        Returns the minimum Y coordinate (bottom of the world).
-        """
-        raise NotImplementedError
-    def __enter__(self) -> Self:
-        """Returns self"""
-        return self
-                                
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> bool | None:
-        """
-        Release this resource.
-        """
-        raise NotImplementedError
-
-
-

src/pumpkin_api/wit_files/world.wit

@@ -1,169 +0,0 @@
-interface %world {
-    use common.{position};
-    use text.{text-component};
-    use scoreboard.{scoreboard};
-
-    /// Defines how a block reacts when pushed by a piston.
-    enum piston-behavior {
-        /// Normal behavior; the block can be pushed and pulled.
-        normal,
-        /// The block is destroyed when pushed.
-        destroy,
-        /// The block cannot be pushed or pulled.
-        block,
-        /// The block is ignored by pistons.
-        ignore,
-        /// The block can only be pushed, not pulled.
-        push-only
-    }
-
-    /// Categories for sounds to control their volume independently.
-    enum sound-category {
-        master,
-        music,
-        records,
-        weather,
-        blocks,
-        hostile,
-        neutral,
-        players,
-        ambient,
-        voice,
-    }
-
-    /// Defines how an explosion interacts with blocks in the world.
-    enum explosion-interaction {
-        /// No interaction with blocks.
-        none,
-        /// Blocks are destroyed and may drop loot.
-        block,
-        /// Interaction typical for mob-caused explosions.
-        mob,
-        /// Interaction typical for TNT explosions.
-        tnt,
-        /// Triggers specific block behaviors.
-        trigger,
-    }
-
-    /// Flags used to control block updates and notifications.
-    flags block-flags {
-        /// Notifies neighbor blocks of the change.
-        notify-neighbors,
-        /// Notifies client listeners of the change.
-        notify-listeners,
-        /// Forces the block state even if it's the same.
-        force-state,
-        /// Skips dropping items when the block is removed.
-        skip-drops,
-        /// Indicates the block was moved (e.g., by a piston).
-        moved,
-        /// Skips state replacement for redstone wires.
-        skip-redstone-wire-state-replacement,
-        /// Skips the callback when a block entity is replaced.
-        skip-block-entity-replaced-callback,
-        /// Skips the callback when a block is added.
-        skip-block-added-callback,
-    }
-
-    /// Detailed information about a block's state.
-    record block-state {
-        /// The internal numerical ID of the block state.
-        id: u16,
-        /// The light level emitted by this block (0-15).
-        luminance: u8,
-        /// How much light this block blocks.
-        opacity: u8,
-        /// The hardness of the block, determining mining speed.
-        hardness: f32,
-        /// Whether this block is considered air.
-        is-air: bool,
-        /// Whether this block is a liquid.
-        is-liquid: bool,
-        /// Whether this block is a solid.
-        is-solid: bool,
-        /// Whether this block occupies a full cube.
-        is-full-cube: bool,
-        /// How this block behaves when pushed by a piston.
-        piston-behavior: piston-behavior,
-        /// Whether this block receives random ticks.
-        has-random-ticks: bool,
-    }
-
-    /// A simple wrapper for a block state ID.
-    record block-state-id {
-        id: u16,
-    }
-
-    /// A position in the world grid.
-    record block-pos {
-        x: s32,
-        y: s32,
-        z: s32,
-    }
-
-    /// Represents a Minecraft world (dimension).
-    resource %world {
-        /// Returns the unique identifier of this world.
-        get-id: func() -> string;
-
-        /// Gets the block state ID at the specified position.
-        get-block-state-id: func(pos: block-pos) -> u16;
-
-        /// Gets detailed block state information at the specified position.
-        get-block-state: func(pos: block-pos) -> block-state;
-
-        /// Sets the block state at the specified position.
-        set-block-state: func(pos: block-pos, state: u16, update-flags: block-flags);
-
-        /// Returns the current time of day in ticks.
-        get-time-of-day: func() -> u64;
-
-        /// Sets the current time of day in ticks.
-        set-time-of-day: func(time: u64);
-
-        /// Returns the total age of the world in ticks.
-        get-world-age: func() -> u64;
-
-        /// Returns the dimension type (e.g., "minecraft:overworld").
-        get-dimension: func() -> string;
-
-        /// Gets the highest non-air block Y coordinate at the specified X and Z.
-        get-top-block-y: func(x: s32, z: s32) -> s32;
-
-        /// Gets the highest motion-blocking block Y coordinate.
-        get-motion-blocking-height: func(x: s32, z: s32) -> s32;
-
-        /// Returns whether it is currently raining or snowing.
-        is-raining: func() -> bool;
-
-        /// Sets whether it should be raining or snowing.
-        set-raining: func(raining: bool);
-
-        /// Returns whether there is currently a thunderstorm.
-        is-thundering: func() -> bool;
-
-        /// Sets whether there should be a thunderstorm.
-        set-thundering: func(thundering: bool);
-
-        /// Broadcasts a system message to all players in this world.
-        broadcast-system-message: func(message: text-component, overlay: bool);
-
-        /// Returns the scoreboard associated with this world.
-        get-scoreboard: func() -> scoreboard;
-
-        /// Plays a sound at the specified position for all players in the world.
-        play-sound: func(sound: string, category: sound-category, pos: position, volume: f32, pitch: f32);
-
-        /// Spawns particles at the specified position.
-        spawn-particle: func(particle: string, pos: position, offset: position, max-speed: f32, count: s32);
-
-        /// Creates an explosion at the specified position.
-        create-explosion: func(pos: position, power: f32, create-fire: bool, interaction: explosion-interaction);
-
-        /// Returns the sea level of this world.
-        get-sea-level: func() -> s32;
-
-        /// Returns the minimum Y coordinate (bottom of the world).
-        get-min-y: func() -> s32;
-    }
-}