minerender 2.0.0-alpha.8 → 2.1.0-alpha.0

package/.worktrees/jobqu-review/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Haylee Schäfer
+
+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/.worktrees/jobqu-review/README.md

@@ -0,0 +1,176 @@
+## jobqu
+[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FInventivetalentDev%2Fjobqu.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2FInventivetalentDev%2Fjobqu?ref=badge_shield)
+
+Queue to run jobs with unique keys at fixed intervals
+
+```
+npm install --save jobqu
+```
+
+## Single
+Collects all promises for a key & calls the runner function once per key per interval
+```typescript
+import { JobQueue } from "jobqu";
+
+const queue = new JobQueue<string, string>(function (s: string) {
+    console.log("runner: " + s);
+    return new Promise(resolve => {
+        setTimeout(() => {
+            resolve(s + Math.ceil(Math.random() * 100000));
+        }, Math.random() * 1000);
+    })
+});
+queue.add("mykey").then(val => {
+    console.log("mykey 1: " + val);
+});
+queue.add("notmykey").then(val => {
+    console.log("notmykey 1: " + val);
+})
+queue.add("mykey").then(val => {
+    console.log("mykey 2: " + val);
+});
+setTimeout(() => {
+    queue.add("mykey").then(val => {
+        console.log("mykey 3: " + val);
+    });
+    queue.add("notmykey").then(val => {
+        console.log("notmykey 2: " + val);
+    })
+}, 100);
+// mykey 1 == mykey 2 == mykey 3
+// notmykey 1 == notmykey 2
+setTimeout(() => queue.end(), 5000);
+
+/*
+runner: mykey
+runner: notmykey
+notmykey 1: notmykey26663
+notmykey 2: notmykey26663
+mykey 1: mykey40915
+mykey 2: mykey40915
+mykey 3: mykey40915
+ */
+```
+
+## Multi
+Collects all promises for a key & calls the runner function with multiple keys to resolve
+```typescript
+import { MultiJobQueue } from "jobqu";
+
+const queue = new MultiJobQueue<string, string>(function (sa: string[]) {
+    console.log("runner: " + sa);
+    return new Promise(resolve => {
+        setTimeout(() => {
+            let result = new Map<string, string>();
+            for (let s of sa) {
+                result.set(s, s + Math.ceil(Math.random() * 100000));
+            }
+            resolve(result);
+        }, Math.random() * 1000);
+    })
+});
+queue.add("mykey").then(val => {
+    console.log("mykey 1: " + val);
+});
+queue.add("notmykey").then(val=>{
+    console.log("notmykey 1: " + val);
+})
+queue.add("mykey").then(val => {
+    console.log("mykey 2: " + val);
+});
+setTimeout(() => {
+    queue.add("mykey").then(val => {
+        console.log("mykey 3: " + val);
+    });
+    queue.add("notmykey").then(val=>{
+        console.log("notmykey 2: " + val);
+    })
+}, 100);
+// mykey 1 == mykey 2 == mykey 3
+// notmykey 1 == notmykey 2
+setTimeout(() => queue.end(), 5000);
+
+/*
+runner: mykey,notmykey
+mykey 1: mykey23920
+mykey 2: mykey23920
+mykey 3: mykey23920
+notmykey 1: notmykey18288
+notmykey 2: notmykey18288
+ */
+```
+
+
+## Options
+Both queues accept the same options object:
+
+```typescript
+new JobQueue(runner, { interval: 1000, maxPerRun: 10, maxActive: 20 });
+```
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `interval` | `1000` | milliseconds between runs |
+| `maxPerRun` | `-1` | maximum keys handed to the runner per interval |
+| `maxActive` | `-1` | maximum keys running at once, including all active batches |
+
+Negative `maxPerRun` or `maxActive` values mean unlimited. The runner takes one key for
+`JobQueue` or an array of keys for `MultiJobQueue`. Numeric calls remain supported as
+`new JobQueue(runner, interval, maxPerRun)` and `new MultiJobQueue(runner, interval, maxPerRun)`.
+
+Runs are always at least `interval` apart, and everything added in the meantime is collected into
+the next one. A key that is still running is skipped, so the same key never runs twice at once —
+and a slow key never holds up the rest of the queue, even with `maxPerRun` set. Jobs added while
+their key is running are collected for the next run rather than resolved with the older value.
+At the active limit, dispatch pauses until a running key settles. Waiting for capacity does not
+create a polling timer, and resumed runs still respect `interval` and `maxPerRun`.
+
+## Methods
+
+| Method | Description |
+| --- | --- |
+| `add(key)` | queue a job, returns `Promise<V>` |
+| `remove(key)` | drop a queued job, rejecting its promise; returns whether one was queued |
+| `clear()` | drop every queued job, rejecting their promises |
+| `end()` | stop the queue task and drop every queued job |
+| `unref()` / `ref()` | whether *queued* jobs keep the node process alive (`ref` by default) |
+| `size` | number of keys waiting to run |
+| `activeSize` | number of keys currently handed to the runner |
+| `keys()` | keys waiting to run |
+
+## Errors
+Whatever the runner throws or rejects with is passed straight through to every job in that run.
+Two errors come from the queue itself:
+
+```typescript
+import { JobCancelledError, MissingResultError } from "jobqu";
+
+queue.add("mykey").catch(err => {
+    if (err instanceof JobCancelledError) {
+        // err.reason is "removed", "cleared" or "ended"
+    }
+});
+```
+
+- **`JobCancelledError`** — the job was dropped by `remove()`, `clear()` or `end()` before it ran,
+  or `add()` was called after `end()`. A job already handed to the runner cannot be cancelled and
+  settles as usual.
+- **`MissingResultError`** — `MultiJobQueue` only: the runner's map had no entry for this key. To
+  say "no value", map the key to an explicit value such as `null` instead of leaving it out.
+
+## Stopping
+The queue only holds a timer while it has jobs to run. Once it drains it stops ticking entirely, so
+an idle queue never keeps the node process alive — and it wakes back up on the next `add()`.
+
+While jobs *are* waiting the timer does keep the process alive, so pending work is not dropped on
+the way out. Call `unref()` if not even that should hold the process open:
+```typescript
+const queue = new JobQueue<string, string>(runner).unref();
+```
+
+`end()` stops the queue for good and rejects everything still queued, so awaiting callers are never
+left hanging. It cannot be restarted — `add()` rejects once it has ended.
+
+
+## License
+[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FInventivetalentDev%2Fjobqu.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2FInventivetalentDev%2Fjobqu?ref=badge_large)

package/.worktrees/v2-asset-sources/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Haylee Schäfer
+
+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/.worktrees/v2-asset-sources/README.md

@@ -0,0 +1,30 @@
+# MineRender V2
+
+A TypeScript library for rendering Minecraft skins, models, blocks, entities, and worlds.
+This monorepo contains the `minerender` package, demo pages, and examples.
+V2 is in alpha; see [ROADMAP.md](./ROADMAP.md) for progress and remaining work,
+including headless Node rendering.
+
+## Develop locally
+
+Use Node.js 22+ and Yarn 4.5.3 through Corepack. Run these commands from the repository root:
+
+```sh
+corepack enable
+yarn install --immutable
+yarn build
+```
+
+Choose a workspace to work on:
+
+| Workspace | Purpose | Development command |
+|---|---|---|
+| [packages/minerender](./packages/minerender) | Public library | `yarn build:watch` |
+| [apps/web](./apps/web) | Demo and manual test pages | `yarn dev:web` |
+| [examples/vite](./examples/vite) | Vue/Vite example | `yarn dev:vite` |
+| [examples/script-tag](./examples/script-tag) | Plain HTML example | `yarn dev:script-tag` |
+
+The `dev:*` commands build the library before starting their server.
+Run `yarn typecheck` and `yarn test` to check your changes.
+
+See [AGENTS.md](./AGENTS.md) for architecture, contributor conventions, and publishing instructions.

package/.worktrees/v2-asset-sources/examples/script-tag/README.md

@@ -0,0 +1,13 @@
+# MineRender script-tag example
+
+This page loads the library's IIFE bundle through one script tag and uses the `MineRender` global. It renders a skin and a diamond sword with orbit controls. The bundle includes three.js and `OrbitControls`.
+
+From the repository root:
+
+1. Install dependencies with `yarn install`.
+2. Build the library with `yarn workspace minerender build`.
+3. Run `yarn workspace @minerender/example-script-tag dev`, then open `http://127.0.0.1:5174`.
+
+Run `yarn workspace @minerender/example-script-tag build` to copy the page and library bundle into `examples/script-tag/dist`. You can serve that directory with any static web server. The page fetches Minecraft assets over HTTPS.
+
+After editing the page or rebuilding the library, restart the development server to copy the updated files.

package/.worktrees/v2-asset-sources/examples/vite/README.md

@@ -0,0 +1,13 @@
+# MineRender Vite example
+
+This Vue example uses ESM imports from the `minerender` workspace. It renders a skin, a diamond sword, and a stone block. Select a resource-pack ZIP to override their vanilla assets.
+
+From the repository root:
+
+1. Install dependencies with `yarn install`.
+2. Build the library with `yarn workspace minerender build`.
+3. Start the example with `yarn workspace @minerender/example-vite dev`, then open `http://127.0.0.1:5175`.
+
+Run `yarn workspace @minerender/example-vite build` to typecheck the example and generate `examples/vite/dist`. Rebuild the library after changing its source.
+
+The example fetches Minecraft assets over HTTPS. It keeps the Node polyfill plugin because the library's asset loaders include the NBT parser, which uses `zlib`.

package/.worktrees/v2-asset-sources/packages/minerender/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Haylee Schäfer
+
+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/.worktrees/v2-asset-sources/packages/minerender/README.md

@@ -0,0 +1,24 @@
+# MineRender V2
+
+A TypeScript library for interactive Minecraft skins, models, blocks, entities, and worlds.
+V2 is in alpha. See the [roadmap](https://github.com/InventivetalentDev/MineRender/blob/main/ROADMAP.md) for feature parity and remaining work.
+
+Install the alpha package with its three.js peer:
+
+```sh
+yarn add minerender@alpha three@^0.158.0
+```
+
+In a browser application:
+
+```ts
+import { Renderer } from "minerender";
+
+const renderer = new Renderer();
+renderer.appendTo(document.body);
+renderer.start();
+```
+
+The package provides ESM and CommonJS entries for browsers and Node.js, plus
+`dist/bundle.js` for the `MineRender` browser global. Node imports require the optional
+native `canvas` dependency; headless rendering is still in development.

package/.worktrees/v2-brightness/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Haylee Schäfer
+
+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/.worktrees/v2-brightness/README.md

@@ -0,0 +1,30 @@
+# MineRender V2
+
+A TypeScript library for rendering Minecraft skins, models, blocks, entities, and worlds.
+This monorepo contains the `minerender` package, demo pages, and examples.
+V2 is in alpha; see [ROADMAP.md](./ROADMAP.md) for progress and remaining work,
+including headless Node rendering.
+
+## Develop locally
+
+Use Node.js 22+ and Yarn 4.5.3 through Corepack. Run these commands from the repository root:
+
+```sh
+corepack enable
+yarn install --immutable
+yarn build
+```
+
+Choose a workspace to work on:
+
+| Workspace | Purpose | Development command |
+|---|---|---|
+| [packages/minerender](./packages/minerender) | Public library | `yarn build:watch` |
+| [apps/web](./apps/web) | Demo and manual test pages | `yarn dev:web` |
+| [examples/vite](./examples/vite) | Vue/Vite example | `yarn dev:vite` |
+| [examples/script-tag](./examples/script-tag) | Plain HTML example | `yarn dev:script-tag` |
+
+The `dev:*` commands build the library before starting their server.
+Run `yarn typecheck` and `yarn test` to check your changes.
+
+See [AGENTS.md](./AGENTS.md) for architecture, contributor conventions, and publishing instructions.

package/.worktrees/v2-brightness/examples/script-tag/README.md

@@ -0,0 +1,13 @@
+# MineRender script-tag example
+
+This page loads the library's IIFE bundle through one script tag and uses the `MineRender` global. It renders a skin and a diamond sword with orbit controls. The bundle includes three.js and `OrbitControls`.
+
+From the repository root:
+
+1. Install dependencies with `yarn install`.
+2. Build the library with `yarn workspace minerender build`.
+3. Run `yarn workspace @minerender/example-script-tag dev`, then open `http://127.0.0.1:5174`.
+
+Run `yarn workspace @minerender/example-script-tag build` to copy the page and library bundle into `examples/script-tag/dist`. You can serve that directory with any static web server. The page fetches Minecraft assets over HTTPS.
+
+After editing the page or rebuilding the library, restart the development server to copy the updated files.

package/.worktrees/v2-brightness/examples/vite/README.md

@@ -0,0 +1,13 @@
+# MineRender Vite example
+
+This Vue example uses ESM imports from the `minerender` workspace. It renders a skin, a diamond sword, and a stone block. Select a resource-pack ZIP to override their vanilla assets.
+
+From the repository root:
+
+1. Install dependencies with `yarn install`.
+2. Build the library with `yarn workspace minerender build`.
+3. Start the example with `yarn workspace @minerender/example-vite dev`, then open `http://127.0.0.1:5175`.
+
+Run `yarn workspace @minerender/example-vite build` to typecheck the example and generate `examples/vite/dist`. Rebuild the library after changing its source.
+
+The example fetches Minecraft assets over HTTPS. It keeps the Node polyfill plugin because the library's asset loaders include the NBT parser, which uses `zlib`.

package/.worktrees/v2-brightness/packages/minerender/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Haylee Schäfer
+
+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/.worktrees/v2-brightness/packages/minerender/README.md

@@ -0,0 +1,24 @@
+# MineRender V2
+
+A TypeScript library for interactive Minecraft skins, models, blocks, entities, and worlds.
+V2 is in alpha. See the [roadmap](https://github.com/InventivetalentDev/MineRender/blob/main/ROADMAP.md) for feature parity and remaining work.
+
+Install the alpha package with its three.js peer:
+
+```sh
+yarn add minerender@alpha three@^0.158.0
+```
+
+In a browser application:
+
+```ts
+import { Renderer } from "minerender";
+
+const renderer = new Renderer();
+renderer.appendTo(document.body);
+renderer.start();
+```
+
+The package provides ESM and CommonJS entries for browsers and Node.js, plus
+`dist/bundle.js` for the `MineRender` browser global. Node imports require the optional
+native `canvas` dependency; headless rendering is still in development.

package/.worktrees/v2-cache-recovery/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Haylee Schäfer
+
+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/.worktrees/v2-cache-recovery/README.md

@@ -0,0 +1,30 @@
+# MineRender V2
+
+A TypeScript library for rendering Minecraft skins, models, blocks, entities, and worlds.
+This monorepo contains the `minerender` package, demo pages, and examples.
+V2 is in alpha; see [ROADMAP.md](./ROADMAP.md) for progress and remaining work,
+including headless Node rendering.
+
+## Develop locally
+
+Use Node.js 22+ and Yarn 4.5.3 through Corepack. Run these commands from the repository root:
+
+```sh
+corepack enable
+yarn install --immutable
+yarn build
+```
+
+Choose a workspace to work on:
+
+| Workspace | Purpose | Development command |
+|---|---|---|
+| [packages/minerender](./packages/minerender) | Public library | `yarn build:watch` |
+| [apps/web](./apps/web) | Demo and manual test pages | `yarn dev:web` |
+| [examples/vite](./examples/vite) | Vue/Vite example | `yarn dev:vite` |
+| [examples/script-tag](./examples/script-tag) | Plain HTML example | `yarn dev:script-tag` |
+
+The `dev:*` commands build the library before starting their server.
+Run `yarn typecheck` and `yarn test` to check your changes.
+
+See [AGENTS.md](./AGENTS.md) for architecture, contributor conventions, and publishing instructions.

package/.worktrees/v2-cache-recovery/examples/script-tag/README.md

@@ -0,0 +1,13 @@
+# MineRender script-tag example
+
+This page loads the library's IIFE bundle through one script tag and uses the `MineRender` global. It renders a skin and a diamond sword with orbit controls. The bundle includes three.js and `OrbitControls`.
+
+From the repository root:
+
+1. Install dependencies with `yarn install`.
+2. Build the library with `yarn workspace minerender build`.
+3. Run `yarn workspace @minerender/example-script-tag dev`, then open `http://127.0.0.1:5174`.
+
+Run `yarn workspace @minerender/example-script-tag build` to copy the page and library bundle into `examples/script-tag/dist`. You can serve that directory with any static web server. The page fetches Minecraft assets over HTTPS.
+
+After editing the page or rebuilding the library, restart the development server to copy the updated files.

package/.worktrees/v2-cache-recovery/examples/vite/README.md

@@ -0,0 +1,13 @@
+# MineRender Vite example
+
+This Vue example uses ESM imports from the `minerender` workspace. It renders a skin, a diamond sword, and a stone block. Select a resource-pack ZIP to override their vanilla assets.
+
+From the repository root:
+
+1. Install dependencies with `yarn install`.
+2. Build the library with `yarn workspace minerender build`.
+3. Start the example with `yarn workspace @minerender/example-vite dev`, then open `http://127.0.0.1:5175`.
+
+Run `yarn workspace @minerender/example-vite build` to typecheck the example and generate `examples/vite/dist`. Rebuild the library after changing its source.
+
+The example fetches Minecraft assets over HTTPS. It keeps the Node polyfill plugin because the library's asset loaders include the NBT parser, which uses `zlib`.

package/.worktrees/v2-cache-recovery/packages/minerender/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Haylee Schäfer
+
+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/.worktrees/v2-cache-recovery/packages/minerender/README.md

@@ -0,0 +1,24 @@
+# MineRender V2
+
+A TypeScript library for interactive Minecraft skins, models, blocks, entities, and worlds.
+V2 is in alpha. See the [roadmap](https://github.com/InventivetalentDev/MineRender/blob/main/ROADMAP.md) for feature parity and remaining work.
+
+Install the alpha package with its three.js peer:
+
+```sh
+yarn add minerender@alpha three@^0.158.0
+```
+
+In a browser application:
+
+```ts
+import { Renderer } from "minerender";
+
+const renderer = new Renderer();
+renderer.appendTo(document.body);
+renderer.start();
+```
+
+The package provides ESM and CommonJS entries for browsers and Node.js, plus
+`dist/bundle.js` for the `MineRender` browser global. Node imports require the optional
+native `canvas` dependency; headless rendering is still in development.

package/.worktrees/v2-ci-stack/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Haylee Schäfer
+
+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.