dredless 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 certainhuman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# dredless
+
+A headless pure Javascript implementation (with type annotations) of `drednot.io`'s client protocol.
+
+## Quick Start
+
+Node (multi-session) usage:
+
+```js
+import Dredless, {EquipmentSlot, SignDisplayMode} from "dredless/node";
+
+const servers = await Dredless.fetchServers();
+const client = await Dredless.startNewShip(servers[0], "bot", "#de9797");
+
+client.player.move({ x: 1, y: 0 });
+client.inventory.slot(0).equip(EquipmentSlot.Feet);
+client.player.placeBlueprint({ x: 28, y: 18, width: 3, height: 3, source: "DSA:..." }, { invSlot: 2 });
+
+const ship = client.currentShip();
+const loader = ship?.machines.loaders()[0];
+loader?.configure({ cycle: 5, stack: 12 });
+
+const sign = ship?.machines.signs()[0];
+sign?.open();
+sign?.setText("Dock here", SignDisplayMode.WhenNear);
+
+client.on("inventory", () => console.log(client.inventory.hotbarSlots().map((slot) => slot.snapshot())));
+client.on("model", ({ world }) => console.log(world.model.transforms()));
+```
+
+Browser (ambient-session) usage:
+
+```js
+import Dredless from "dredless/browser";
+
+await Dredless.createAnonSession();
+const servers = await Dredless.fetchServers();
+const ships = await Dredless.fetchShips(servers[0]);
+const client = await Dredless.startShip(servers[0], ships[0]);
+
+// . . . client object can be used the same as in Node
+```
+
+## API Docs
+
+- [Node top-level API](docs/NODE_API.md): explicit session/token/start helpers. Use this if you are running in a Node environment.
+- [Browser top-level API](docs/BROWSER_API.md): ambient browser-session helpers. Use this if you are running in a browser environment.
+- [Shared API reference](docs/API_REFERENCE.md): client, world, entity, machine, inventory, management, and protocol APIs. Used by both runtime environments.