@aethervtt/shard-platform-tauri 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Patrick Dias
+
+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,3 @@
+# @aethervtt/shard-platform-tauri
+
+Part of [Shard](https://github.com/aethervtt/shard), a WebGPU-first 2D/3D game engine in TypeScript. See the repository for documentation.

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { Platform } from '@aethervtt/shard-platform';
+export interface TauriPlatformOptions {
+    /** Absolute path of the project root. Project paths resolve against it. */
+    projectRoot: string;
+    /**
+     * Absolute folder for `storage` (saves, settings): the app data folder for the project, e.g.
+     * `<appDataDir>/<project>`. Default `<projectRoot>/.shard/user`.
+     */
+    dataDir?: string;
+}
+export declare function createTauriPlatform(options: TauriPlatformOptions): Platform;

package/dist/index.js

@@ -0,0 +1,88 @@
+import { createWebAudioBackend, createWebWorkers } from "@aethervtt/shard-platform-web";
+import {
+  exists,
+  mkdir,
+  readDir,
+  readFile,
+  readTextFile,
+  remove,
+  rename,
+  watch,
+  writeFile,
+  writeTextFile
+} from "@tauri-apps/plugin-fs";
+function createTauriStorage(dir) {
+  const path = (key) => `${dir}/${key}`;
+  const parent = (p) => p.slice(0, p.lastIndexOf("/"));
+  const walk = async (folder, prefix, out) => {
+    const entries = await readDir(folder).catch(() => []);
+    for (const e of entries) {
+      const key = prefix === "" ? e.name : `${prefix}/${e.name}`;
+      if (e.isDirectory) await walk(`${folder}/${e.name}`, key, out);
+      else if (e.isFile && !e.name.endsWith(".tmp")) out.push(key);
+    }
+  };
+  return {
+    read: async (key) => await exists(path(key)) ? readFile(path(key)) : void 0,
+    write: async (key, data) => {
+      const target = path(key);
+      await mkdir(parent(target), { recursive: true });
+      await writeFile(`${target}.tmp`, data);
+      await rename(`${target}.tmp`, target);
+    },
+    list: async (prefix) => {
+      const out = [];
+      await walk(dir, "", out);
+      return out.filter((k) => k.startsWith(prefix)).sort();
+    },
+    delete: async (key) => {
+      if (await exists(path(key))) await remove(path(key));
+    }
+  };
+}
+function createTauriPlatform(options) {
+  const root = options.projectRoot.replace(/\/+$/, "");
+  const resolve = (path) => path.startsWith("/") ? path : `${root}/${path}`;
+  const relative = (path) => path.startsWith(`${root}/`) ? path.slice(root.length + 1) : path;
+  const toChange = (event) => {
+    const type = event.type;
+    const kind = typeof type === "object" && "create" in type ? "create" : typeof type === "object" && "remove" in type ? "remove" : "modify";
+    return event.paths.map((path) => ({ kind, path: relative(path) }));
+  };
+  const fs = {
+    writable: true,
+    readText: (path) => readTextFile(resolve(path)),
+    readBytes: (path) => readFile(resolve(path)),
+    writeText: (path, data) => writeTextFile(resolve(path), data),
+    writeBytes: (path, data) => writeFile(resolve(path), data),
+    exists: (path) => exists(resolve(path)),
+    watch: async (path, onChange) => watch(resolve(path), (event) => toChange(event).forEach(onChange), {
+      recursive: true,
+      delayMs: 50
+    })
+  };
+  let audio;
+  let workers;
+  return {
+    name: "tauri",
+    // Web workers in the webview; made on first use.
+    get workers() {
+      workers ??= createWebWorkers();
+      return workers;
+    },
+    // The webview has Web Audio; made on first use.
+    get audio() {
+      audio ??= createWebAudioBackend();
+      return audio;
+    },
+    fs,
+    storage: createTauriStorage((options.dataDir ?? `${root}/.shard/user`).replace(/\/+$/, "")),
+    clock: { now: () => performance.now() },
+    log: {
+      log: (level, message, data) => console[level](`[shard] ${message}`, data ?? "")
+    }
+  };
+}
+export {
+  createTauriPlatform
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@aethervtt/shard-platform-tauri",
+  "version": "0.0.1",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@aethervtt/shard-core": "0.0.1",
+    "@aethervtt/shard-platform": "0.0.1",
+    "@aethervtt/shard-platform-web": "0.0.1",
+    "@tauri-apps/api": "^2.11.1",
+    "@tauri-apps/plugin-fs": "^2.5.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aethervtt/shard.git",
+    "directory": "packages/platform-tauri"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "shard": {
+    "buildSha": "d6c5c6aef4675575c878b02cf2c8f738b4190229"
+  }
+}