@shipload/item-renderer 0.1.0

package/.github/workflows/ci.yml

@@ -0,0 +1,14 @@
+name: ci
+on:
+  push: { branches: [main] }
+  pull_request:
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v1
+        with: { bun-version: latest }
+      - run: bun install
+      - run: bun test
+      - run: bun run scripts/check-bundle-size.ts

package/.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+bun.lockb
+dist/
+.DS_Store
+test/__image_snapshots__/*.diff.png
+coverage/

package/Makefile

@@ -0,0 +1,50 @@
+SHELL := /usr/bin/env bash
+BIN   := ./node_modules/.bin
+
+.PHONY: dev
+dev: node_modules
+	bun run scripts/preview.ts
+
+.PHONY: test
+test: node_modules
+	bun test
+
+.PHONY: test-pixel
+test-pixel: node_modules
+	bun test test/pixel.test.ts
+
+.PHONY: test-update
+test-update: node_modules
+	UPDATE_IMAGE_SNAPSHOTS=1 bun test --update-snapshots
+
+.PHONY: typecheck
+typecheck: node_modules
+	$(BIN)/tsc --noEmit
+
+.PHONY: lint
+lint: node_modules
+	$(BIN)/biome check src test scripts
+
+.PHONY: format
+format: node_modules
+	$(BIN)/biome format --write src test scripts
+
+.PHONY: bundle-check
+bundle-check: node_modules
+	bun run scripts/check-bundle-size.ts
+
+.PHONY: fonts
+fonts: node_modules
+	bun run scripts/copy-fonts.ts
+
+.PHONY: check
+check: typecheck lint test bundle-check
+
+.PHONY: clean
+clean:
+	rm -rf node_modules bun.lock
+
+node_modules: package.json
+	bun install
+	bun link @shipload/sdk
+	@touch $@

package/biome.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.8.0/schema.json",
+  "organizeImports": { "enabled": true },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": { "noExplicitAny": "error" },
+      "style": { "useImportType": "error" }
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  }
+}

package/bun.lock

@@ -0,0 +1,123 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "@shipload/item-renderer",
+      "dependencies": {
+        "@shipload/sdk": "^2.0.0-rc13",
+        "@wharfkit/antelope": "^1.0.0",
+      },
+      "devDependencies": {
+        "@biomejs/biome": "^1.8.0",
+        "@fontsource/inter": "^5.2.8",
+        "@fontsource/jetbrains-mono": "^5.2.8",
+        "@fontsource/orbitron": "^5.2.8",
+        "@resvg/resvg-js": "^2.6.0",
+        "@types/bun": "latest",
+        "pixelmatch": "^6.0.0",
+        "pngjs": "^7.0.0",
+        "typescript": "^5.4.0",
+      },
+    },
+  },
+  "packages": {
+    "@biomejs/biome": ["@biomejs/biome@1.9.4", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "1.9.4", "@biomejs/cli-darwin-x64": "1.9.4", "@biomejs/cli-linux-arm64": "1.9.4", "@biomejs/cli-linux-arm64-musl": "1.9.4", "@biomejs/cli-linux-x64": "1.9.4", "@biomejs/cli-linux-x64-musl": "1.9.4", "@biomejs/cli-win32-arm64": "1.9.4", "@biomejs/cli-win32-x64": "1.9.4" }, "bin": { "biome": "bin/biome" } }, "sha512-1rkd7G70+o9KkTn5KLmDYXihGoTaIGO9PIIN2ZB7UJxFrWw04CZHPYiMRjYsaDvVV7hP1dYNRLxSANLaBFGpog=="],
+
+    "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@1.9.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-bFBsPWrNvkdKrNCYeAp+xo2HecOGPAy9WyNyB/jKnnedgzl4W4Hb9ZMzYNbf8dMCGmUdSavlYHiR01QaYR58cw=="],
+
+    "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@1.9.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-ngYBh/+bEedqkSevPVhLP4QfVPCpb+4BBe2p7Xs32dBgs7rh9nY2AIYUL6BgLw1JVXV8GlpKmb/hNiuIxfPfZg=="],
+
+    "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@1.9.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-fJIW0+LYujdjUgJJuwesP4EjIBl/N/TcOX3IvIHJQNsAqvV2CHIogsmA94BPG6jZATS4Hi+xv4SkBBQSt1N4/g=="],
+
+    "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@1.9.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-v665Ct9WCRjGa8+kTr0CzApU0+XXtRgwmzIf1SeKSGAv+2scAlW6JR5PMFo6FzqqZ64Po79cKODKf3/AAmECqA=="],
+
+    "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@1.9.4", "", { "os": "linux", "cpu": "x64" }, "sha512-lRCJv/Vi3Vlwmbd6K+oQ0KhLHMAysN8lXoCI7XeHlxaajk06u7G+UsFSO01NAs5iYuWKmVZjmiOzJ0OJmGsMwg=="],
+
+    "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@1.9.4", "", { "os": "linux", "cpu": "x64" }, "sha512-gEhi/jSBhZ2m6wjV530Yy8+fNqG8PAinM3oV7CyO+6c3CEh16Eizm21uHVsyVBEB6RIM8JHIl6AGYCv6Q6Q9Tg=="],
+
+    "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@1.9.4", "", { "os": "win32", "cpu": "arm64" }, "sha512-tlbhLk+WXZmgwoIKwHIHEBZUwxml7bRJgk0X2sPyNR3S93cdRq6XulAZRQJ17FYGGzWne0fgrXBKpl7l4M87Hg=="],
+
+    "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@1.9.4", "", { "os": "win32", "cpu": "x64" }, "sha512-8Y5wMhVIPaWe6jw2H+KlEm4wP/f7EW3810ZLmDlrEEy5KvBsb9ECEfu/kMWD484ijfQ8+nIi0giMgu9g1UAuuA=="],
+
+    "@fontsource/inter": ["@fontsource/inter@5.2.8", "", {}, "sha512-P6r5WnJoKiNVV+zvW2xM13gNdFhAEpQ9dQJHt3naLvfg+LkF2ldgSLiF4T41lf1SQCM9QmkqPTn4TH568IRagg=="],
+
+    "@fontsource/jetbrains-mono": ["@fontsource/jetbrains-mono@5.2.8", "", {}, "sha512-6w8/SG4kqvIMu7xd7wt6x3idn1Qux3p9N62s6G3rfldOUYHpWcc2FKrqf+Vo44jRvqWj2oAtTHrZXEP23oSKwQ=="],
+
+    "@fontsource/orbitron": ["@fontsource/orbitron@5.2.8", "", {}, "sha512-ruzrDl5vnqNykk5DZWY0Ezj4aeFZSbCnwJTc/98ojNJHSsHhlhT2r7rwQrA5sptmF8JtB8TQTAvlfRvcV28RPw=="],
+
+    "@resvg/resvg-js": ["@resvg/resvg-js@2.6.2", "", { "optionalDependencies": { "@resvg/resvg-js-android-arm-eabi": "2.6.2", "@resvg/resvg-js-android-arm64": "2.6.2", "@resvg/resvg-js-darwin-arm64": "2.6.2", "@resvg/resvg-js-darwin-x64": "2.6.2", "@resvg/resvg-js-linux-arm-gnueabihf": "2.6.2", "@resvg/resvg-js-linux-arm64-gnu": "2.6.2", "@resvg/resvg-js-linux-arm64-musl": "2.6.2", "@resvg/resvg-js-linux-x64-gnu": "2.6.2", "@resvg/resvg-js-linux-x64-musl": "2.6.2", "@resvg/resvg-js-win32-arm64-msvc": "2.6.2", "@resvg/resvg-js-win32-ia32-msvc": "2.6.2", "@resvg/resvg-js-win32-x64-msvc": "2.6.2" } }, "sha512-xBaJish5OeGmniDj9cW5PRa/PtmuVU3ziqrbr5xJj901ZDN4TosrVaNZpEiLZAxdfnhAe7uQ7QFWfjPe9d9K2Q=="],
+
+    "@resvg/resvg-js-android-arm-eabi": ["@resvg/resvg-js-android-arm-eabi@2.6.2", "", { "os": "android", "cpu": "arm" }, "sha512-FrJibrAk6v29eabIPgcTUMPXiEz8ssrAk7TXxsiZzww9UTQ1Z5KAbFJs+Z0Ez+VZTYgnE5IQJqBcoSiMebtPHA=="],
+
+    "@resvg/resvg-js-android-arm64": ["@resvg/resvg-js-android-arm64@2.6.2", "", { "os": "android", "cpu": "arm64" }, "sha512-VcOKezEhm2VqzXpcIJoITuvUS/fcjIw5NA/w3tjzWyzmvoCdd+QXIqy3FBGulWdClvp4g+IfUemigrkLThSjAQ=="],
+
+    "@resvg/resvg-js-darwin-arm64": ["@resvg/resvg-js-darwin-arm64@2.6.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-nmok2LnAd6nLUKI16aEB9ydMC6Lidiiq2m1nEBDR1LaaP7FGs4AJ90qDraxX+CWlVuRlvNjyYJTNv8qFjtL9+A=="],
+
+    "@resvg/resvg-js-darwin-x64": ["@resvg/resvg-js-darwin-x64@2.6.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-GInyZLjgWDfsVT6+SHxQVRwNzV0AuA1uqGsOAW+0th56J7Nh6bHHKXHBWzUrihxMetcFDmQMAX1tZ1fZDYSRsw=="],
+
+    "@resvg/resvg-js-linux-arm-gnueabihf": ["@resvg/resvg-js-linux-arm-gnueabihf@2.6.2", "", { "os": "linux", "cpu": "arm" }, "sha512-YIV3u/R9zJbpqTTNwTZM5/ocWetDKGsro0SWp70eGEM9eV2MerWyBRZnQIgzU3YBnSBQ1RcxRZvY/UxwESfZIw=="],
+
+    "@resvg/resvg-js-linux-arm64-gnu": ["@resvg/resvg-js-linux-arm64-gnu@2.6.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-zc2BlJSim7YR4FZDQ8OUoJg5holYzdiYMeobb9pJuGDidGL9KZUv7SbiD4E8oZogtYY42UZEap7dqkkYuA91pg=="],
+
+    "@resvg/resvg-js-linux-arm64-musl": ["@resvg/resvg-js-linux-arm64-musl@2.6.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-3h3dLPWNgSsD4lQBJPb4f+kvdOSJHa5PjTYVsWHxLUzH4IFTJUAnmuWpw4KqyQ3NA5QCyhw4TWgxk3jRkQxEKg=="],
+
+    "@resvg/resvg-js-linux-x64-gnu": ["@resvg/resvg-js-linux-x64-gnu@2.6.2", "", { "os": "linux", "cpu": "x64" }, "sha512-IVUe+ckIerA7xMZ50duAZzwf1U7khQe2E0QpUxu5MBJNao5RqC0zwV/Zm965vw6D3gGFUl7j4m+oJjubBVoftw=="],
+
+    "@resvg/resvg-js-linux-x64-musl": ["@resvg/resvg-js-linux-x64-musl@2.6.2", "", { "os": "linux", "cpu": "x64" }, "sha512-UOf83vqTzoYQO9SZ0fPl2ZIFtNIz/Rr/y+7X8XRX1ZnBYsQ/tTb+cj9TE+KHOdmlTFBxhYzVkP2lRByCzqi4jQ=="],
+
+    "@resvg/resvg-js-win32-arm64-msvc": ["@resvg/resvg-js-win32-arm64-msvc@2.6.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-7C/RSgCa+7vqZ7qAbItfiaAWhyRSoD4l4BQAbVDqRRsRgY+S+hgS3in0Rxr7IorKUpGE69X48q6/nOAuTJQxeQ=="],
+
+    "@resvg/resvg-js-win32-ia32-msvc": ["@resvg/resvg-js-win32-ia32-msvc@2.6.2", "", { "os": "win32", "cpu": "ia32" }, "sha512-har4aPAlvjnLcil40AC77YDIk6loMawuJwFINEM7n0pZviwMkMvjb2W5ZirsNOZY4aDbo5tLx0wNMREp5Brk+w=="],
+
+    "@resvg/resvg-js-win32-x64-msvc": ["@resvg/resvg-js-win32-x64-msvc@2.6.2", "", { "os": "win32", "cpu": "x64" }, "sha512-ZXtYhtUr5SSaBrUDq7DiyjOFJqBVL/dOBN7N/qmi/pO0IgiWW/f/ue3nbvu9joWE5aAKDoIzy/CxsY0suwGosQ=="],
+
+    "@shipload/sdk": ["@shipload/sdk@2.0.0-rc9", "", { "dependencies": { "@wharfkit/antelope": "^1.2.0", "@wharfkit/contract": "^1.2.1", "@wharfkit/session": "^1.3.1", "tslib": "^2.1.0" } }, "sha512-7Knz/QiJqtD5DfA/gC7eqG/e809RSBAqkU7CzKI0NWmmWGWkZbnfPxbqem2ZFQsj9K1BxOfcynAeA3jeBQfuFA=="],
+
+    "@types/bun": ["@types/bun@1.3.12", "", { "dependencies": { "bun-types": "1.3.12" } }, "sha512-DBv81elK+/VSwXHDlnH3Qduw+KxkTIWi7TXkAeh24zpi5l0B2kUg9Ga3tb4nJaPcOFswflgi/yAvMVBPrxMB+A=="],
+
+    "@types/node": ["@types/node@25.6.0", "", { "dependencies": { "undici-types": "~7.19.0" } }, "sha512-+qIYRKdNYJwY3vRCZMdJbPLJAtGjQBudzZzdzwQYkEPQd+PJGixUL5QfvCLDaULoLv+RhT3LDkwEfKaAkgSmNQ=="],
+
+    "@wharfkit/abicache": ["@wharfkit/abicache@1.2.2", "", { "dependencies": { "@wharfkit/antelope": "^1.0.2", "@wharfkit/signing-request": "^3.1.0", "pako": "^2.0.4", "tslib": "^2.1.0" } }, "sha512-yOsYz2qQpQy7Nb8XZj62pZqp8YnmWDqFlrenYksBb9jl+1aWIpFhWd+14VEez4tUAezRH4UWW+w1SX5vhmUY9A=="],
+
+    "@wharfkit/antelope": ["@wharfkit/antelope@1.2.0", "", { "dependencies": { "bn.js": "^4.11.9", "brorand": "^1.1.0", "elliptic": "^6.5.4", "hash.js": "^1.0.0", "pako": "^2.1.0", "tslib": "^2.0.3" } }, "sha512-9q0nvM8yUtjKTQlukKZODAhUN2S2/cfSlIYdh2mPnaOCSH8KOLJ2gYCPuQVvH1FE9AKu312lM5TzhkRccf1VjQ=="],
+
+    "@wharfkit/common": ["@wharfkit/common@1.5.0", "", { "dependencies": { "tslib": "^2.1.0" }, "peerDependencies": { "@wharfkit/antelope": "^1.0.0" } }, "sha512-eqXkOy+vshcEzK8kED+EsoTPJjlBKHYglgV9CBnZQgIlGrWIRXWH4YaXH3W7EbI/nCRJCaNqxm5fC+pgpFcp8g=="],
+
+    "@wharfkit/contract": ["@wharfkit/contract@1.2.1", "", { "dependencies": { "@wharfkit/abicache": "^1.2.0", "@wharfkit/antelope": "^1.0.4", "@wharfkit/signing-request": "^3.1.0", "tslib": "^2.1.0" } }, "sha512-3UhCtDYCyapfM2nRTrslcbvko864d4MOpxRAz7TR/ZUbRAgZsxhYLFLEv1v23/SU+vsFzAHNBmvzkLEG0OLaHQ=="],
+
+    "@wharfkit/session": ["@wharfkit/session@1.6.1", "", { "dependencies": { "@wharfkit/abicache": "^1.2.1", "@wharfkit/antelope": "^1.0.11", "@wharfkit/common": "^1.2.0", "@wharfkit/signing-request": "^3.1.0", "pako": "^2.0.4", "tslib": "^2.1.0" } }, "sha512-k6ntDGOe8bvD/Ps0erTPTFMdYVFrw5cRvPcEwxytlmRRcNV/M8xWcpCYWdmGDxa8QYqynf/hAkbVh1PSwRGl5A=="],
+
+    "@wharfkit/signing-request": ["@wharfkit/signing-request@3.4.0", "", { "dependencies": { "@wharfkit/antelope": "^1.1.1", "tslib": "^2.0.3" } }, "sha512-WstXfmR9i5pKaYXDUwNFNCgBIvN6u5IRGWSfj5O3XzthbtJUmRoJNtjGMaNnUqZ1MMx5YY4/JpY3b2e6LbpXLw=="],
+
+    "bn.js": ["bn.js@4.12.3", "", {}, "sha512-fGTi3gxV/23FTYdAoUtLYp6qySe2KE3teyZitipKNRuVYcBkoP/bB3guXN/XVKUe9mxCHXnc9C4ocyz8OmgN0g=="],
+
+    "brorand": ["brorand@1.1.0", "", {}, "sha512-cKV8tMCEpQs4hK/ik71d6LrPOnpkpGBR0wzxqr68g2m/LB2GxVYQroAjMJZRVM1Y4BCjCKc3vAamxSzOY2RP+w=="],
+
+    "bun-types": ["bun-types@1.3.12", "", { "dependencies": { "@types/node": "*" } }, "sha512-HqOLj5PoFajAQciOMRiIZGNoKxDJSr6qigAttOX40vJuSp6DN/CxWp9s3C1Xwm4oH7ybueITwiaOcWXoYVoRkA=="],
+
+    "elliptic": ["elliptic@6.6.1", "", { "dependencies": { "bn.js": "^4.11.9", "brorand": "^1.1.0", "hash.js": "^1.0.0", "hmac-drbg": "^1.0.1", "inherits": "^2.0.4", "minimalistic-assert": "^1.0.1", "minimalistic-crypto-utils": "^1.0.1" } }, "sha512-RaddvvMatK2LJHqFJ+YA4WysVN5Ita9E35botqIYspQ4TkRAlCicdzKOjlyv/1Za5RyTNn7di//eEV0uTAfe3g=="],
+
+    "hash.js": ["hash.js@1.1.7", "", { "dependencies": { "inherits": "^2.0.3", "minimalistic-assert": "^1.0.1" } }, "sha512-taOaskGt4z4SOANNseOviYDvjEJinIkRgmp7LbKP2YTTmVxWBl87s/uzK9r+44BclBSp2X7K1hqeNfz9JbBeXA=="],
+
+    "hmac-drbg": ["hmac-drbg@1.0.1", "", { "dependencies": { "hash.js": "^1.0.3", "minimalistic-assert": "^1.0.0", "minimalistic-crypto-utils": "^1.0.1" } }, "sha512-Tti3gMqLdZfhOQY1Mzf/AanLiqh1WTiJgEj26ZuYQ9fbkLomzGchCws4FyrSd4VkpBfiNhaE1On+lOz894jvXg=="],
+
+    "inherits": ["inherits@2.0.4", "", {}, "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="],
+
+    "minimalistic-assert": ["minimalistic-assert@1.0.1", "", {}, "sha512-UtJcAD4yEaGtjPezWuO9wC4nwUnVH/8/Im3yEHQP4b67cXlD/Qr9hdITCU1xDbSEXg2XKNaP8jsReV7vQd00/A=="],
+
+    "minimalistic-crypto-utils": ["minimalistic-crypto-utils@1.0.1", "", {}, "sha512-JIYlbt6g8i5jKfJ3xz7rF0LXmv2TkDxBLUkiBeZ7bAx4GnnNMr8xFpGnOxn6GhTEHx3SjRrZEoU+j04prX1ktg=="],
+
+    "pako": ["pako@2.1.0", "", {}, "sha512-w+eufiZ1WuJYgPXbV/PO3NCMEc3xqylkKHzp8bxp1uW4qaSNQUkwmLLEc3kKsfz8lpV1F8Ht3U1Cm+9Srog2ug=="],
+
+    "pixelmatch": ["pixelmatch@6.0.0", "", { "dependencies": { "pngjs": "^7.0.0" }, "bin": { "pixelmatch": "bin/pixelmatch" } }, "sha512-FYpL4XiIWakTnIqLqvt3uN4L9B3TsuHIvhLILzTiJZMJUsGvmKNeL4H3b6I99LRyerK9W4IuOXw+N28AtRgK2g=="],
+
+    "pngjs": ["pngjs@7.0.0", "", {}, "sha512-LKWqWJRhstyYo9pGvgor/ivk2w94eSjE3RGVuzLGlr3NmD8bf7RcYGze1mNdEHRP6TRP6rMuDHk5t44hnTRyow=="],
+
+    "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.19.2", "", {}, "sha512-qYVnV5OEm2AW8cJMCpdV20CDyaN3g0AjDlOGf1OW4iaDEx8MwdtChUp4zu4H0VP3nDRF/8RKWH+IPp9uW0YGZg=="],
+  }
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@shipload/item-renderer",
+  "version": "0.1.0",
+  "description": "Deterministic SVG rendering for Shipload items",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./fonts": {
+      "types": "./src/fonts/index.ts",
+      "default": "./src/fonts/index.ts"
+    },
+    "./fonts/load-bun": {
+      "types": "./src/fonts/load-bun.ts",
+      "default": "./src/fonts/load-bun.ts"
+    },
+    "./fonts/*.woff2": "./src/fonts/*.woff2",
+    "./test/fixtures": {
+      "types": "./test/fixtures/cargo-items.ts",
+      "default": "./test/fixtures/cargo-items.ts"
+    }
+  },
+  "files": ["src", "!src/**/*.test.ts"],
+  "scripts": {
+    "test": "bun test",
+    "test:pixel": "bun test test/pixel.test.ts",
+    "dev:preview": "bun run scripts/preview.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src test scripts",
+    "fonts:copy": "bun run scripts/copy-fonts.ts"
+  },
+  "dependencies": {
+    "@shipload/sdk": "^2.0.0-rc13",
+    "@wharfkit/antelope": "^1.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.8.0",
+    "@fontsource/inter": "^5.2.8",
+    "@fontsource/jetbrains-mono": "^5.2.8",
+    "@fontsource/orbitron": "^5.2.8",
+    "@resvg/resvg-js": "^2.6.0",
+    "@types/bun": "latest",
+    "pixelmatch": "^6.0.0",
+    "pngjs": "^7.0.0",
+    "typescript": "^5.4.0"
+  }
+}

package/scripts/check-bundle-size.ts

@@ -0,0 +1,37 @@
+import { gzipSync } from 'node:zlib'
+
+const CORE_LIMIT_BYTES = 50 * 1024
+
+async function main() {
+  const result = await Bun.build({
+    entrypoints: ['./src/index.ts'],
+    target: 'browser',
+    format: 'esm',
+    minify: true,
+    external: ['@shipload/sdk', '@wharfkit/antelope'],
+  })
+
+  if (!result.success) {
+    for (const msg of result.logs) console.error(msg)
+    process.exit(1)
+  }
+
+  let totalBytes = 0
+  let totalGzipped = 0
+  for (const out of result.outputs) {
+    const text = await out.text()
+    const bytes = new TextEncoder().encode(text).length
+    const gz = gzipSync(new TextEncoder().encode(text)).length
+    console.log(`${out.path}: ${bytes} bytes (${gz} gzipped)`)
+    totalBytes += bytes
+    totalGzipped += gz
+  }
+
+  console.log(`core bundle total: ${totalBytes} bytes, ${totalGzipped} gzipped`)
+  if (totalGzipped > CORE_LIMIT_BYTES) {
+    console.error(`FAIL: core bundle is ${totalGzipped} gzipped, limit is ${CORE_LIMIT_BYTES}`)
+    process.exit(1)
+  }
+}
+
+main()

package/scripts/copy-fonts.ts

@@ -0,0 +1,41 @@
+import { copyFile, mkdir } from 'node:fs/promises'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const OUT_DIR = resolve(__dirname, '../src/fonts')
+const NM = resolve(__dirname, '../node_modules')
+
+const FACES = [
+  {
+    src: `${NM}/@fontsource/orbitron/files/orbitron-latin-700-normal.woff2`,
+    out: 'orbitron-700.woff2',
+  },
+  {
+    src: `${NM}/@fontsource/inter/files/inter-latin-400-normal.woff2`,
+    out: 'inter-400.woff2',
+  },
+  {
+    src: `${NM}/@fontsource/inter/files/inter-latin-600-normal.woff2`,
+    out: 'inter-600.woff2',
+  },
+  {
+    src: `${NM}/@fontsource/jetbrains-mono/files/jetbrains-mono-latin-500-normal.woff2`,
+    out: 'jetbrains-500.woff2',
+  },
+]
+
+async function main() {
+  await mkdir(OUT_DIR, { recursive: true })
+  for (const face of FACES) {
+    const dest = resolve(OUT_DIR, face.out)
+    await copyFile(face.src, dest)
+    const size = (await Bun.file(dest).arrayBuffer()).byteLength
+    console.log(`wrote ${face.out} (${size} bytes)`)
+  }
+}
+
+main().catch((e) => {
+  console.error(e)
+  process.exit(1)
+})

package/scripts/preview.ts

@@ -0,0 +1,43 @@
+import { resolveItem } from '@shipload/sdk'
+import { renderItem } from '../src/render.ts'
+import { FIXTURES } from '../test/fixtures/cargo-items.ts'
+
+function page(): string {
+  const sections: string[] = []
+  for (const [name, item] of Object.entries(FIXTURES)) {
+    const resolved = resolveItem(item.item_id, item.stats, item.modules)
+    const svg = renderItem(item, resolved)
+    sections.push(
+      `<section><h3>${name}</h3><div class="wrap">${svg}</div></section>`,
+    )
+  }
+  return `
+    <!doctype html>
+    <html>
+      <head>
+        <meta charset="utf-8">
+        <title>item-renderer preview</title>
+        <style>
+          body { background: #0a0a0c; color: #e6e8ec; font-family: Inter, sans-serif; padding: 24px; }
+          main { display: grid; grid-template-columns: repeat(auto-fill, minmax(320px, 1fr)); gap: 24px; }
+          section { background: #11141a; padding: 16px; border-radius: 10px; }
+          h3 { margin: 0 0 8px; color: #8f98a8; font-size: 12px; text-transform: uppercase; letter-spacing: 1px; }
+          .wrap svg { display: block; }
+        </style>
+      </head>
+      <body>
+        <h1>Fixtures</h1>
+        <main>${sections.join('')}</main>
+      </body>
+    </html>
+  `
+}
+
+const port = Number(process.env.PORT ?? 5173)
+
+Bun.serve({
+  port,
+  fetch: () => new Response(page(), { headers: { 'content-type': 'text/html' } }),
+})
+
+console.log(`preview running at http://localhost:${port}`)

package/src/errors.ts

@@ -0,0 +1,22 @@
+export class InvalidPayloadError extends Error {
+  override readonly name = 'InvalidPayloadError'
+  constructor(message: string) {
+    super(message)
+  }
+}
+
+export class UnknownItemError extends Error {
+  override readonly name = 'UnknownItemError'
+  readonly itemId: number
+  constructor(itemId: number) {
+    super(`unknown item id: ${itemId}`)
+    this.itemId = itemId
+  }
+}
+
+export class RenderError extends Error {
+  override readonly name = 'RenderError'
+  constructor(message: string, options?: { cause?: unknown }) {
+    super(message, options)
+  }
+}

package/src/fonts/index.ts

@@ -0,0 +1,36 @@
+export type FontKey = 'orbitron-700' | 'inter-400' | 'inter-600' | 'jetbrains-500'
+
+export interface FontMeta {
+  family: string
+  weight: number
+  fileName: string
+}
+
+export const FONT_MANIFEST: Record<FontKey, FontMeta> = {
+  'orbitron-700': { family: 'Orbitron', weight: 700, fileName: 'orbitron-700.woff2' },
+  'inter-400': { family: 'Inter', weight: 400, fileName: 'inter-400.woff2' },
+  'inter-600': { family: 'Inter', weight: 600, fileName: 'inter-600.woff2' },
+  'jetbrains-500': { family: 'JetBrains Mono', weight: 500, fileName: 'jetbrains-500.woff2' },
+}
+
+function bytesToBase64(bytes: Uint8Array): string {
+  let binary = ''
+  for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]!)
+  return btoa(binary)
+}
+
+export function embedFontsInSvg(
+  svg: string,
+  fontData: Record<FontKey, Uint8Array>,
+): string {
+  const faceBlocks = (Object.keys(fontData) as FontKey[]).map((key) => {
+    const meta = FONT_MANIFEST[key]
+    const b64 = bytesToBase64(fontData[key])
+    return (
+      `@font-face { font-family: "${meta.family}"; font-weight: ${meta.weight}; ` +
+      `font-style: normal; src: url(data:font/woff2;base64,${b64}) format("woff2"); }`
+    )
+  }).join('\n')
+  const style = `<defs><style type="text/css"><![CDATA[\n${faceBlocks}\n]]></style></defs>`
+  return svg.replace('>', `>${style}`)
+}

package/src/fonts/load-bun.ts

@@ -0,0 +1,16 @@
+import { readFile } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { FONT_MANIFEST, type FontKey } from './index.ts'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+
+export async function loadFontData(): Promise<Record<FontKey, Uint8Array>> {
+  const entries = await Promise.all(
+    (Object.keys(FONT_MANIFEST) as FontKey[]).map(async (key) => {
+      const buf = await readFile(join(HERE, FONT_MANIFEST[key].fileName))
+      return [key, new Uint8Array(buf)] as const
+    }),
+  )
+  return Object.fromEntries(entries) as Record<FontKey, Uint8Array>
+}

package/src/index.ts

@@ -0,0 +1,46 @@
+// Version
+export const VERSION = '0.1.0'
+
+// Errors
+export { InvalidPayloadError, UnknownItemError, RenderError } from './errors.ts'
+
+// Payload
+export { encodePayload, decodePayload } from './payload/codec.ts'
+export type { CargoItem, CargoItemLike } from './payload/codec.ts'
+
+// Rendering
+export { renderItem, renderFromPayload, type RenderOptions } from './render.ts'
+export { renderByType, type RenderByTypeOpts } from './templates/index.ts'
+
+// Links + meta
+export { linkToItemPage, linkToItemImage } from './links.ts'
+export { itemPageMeta } from './meta.ts'
+export type { ItemPageMeta, ItemPageMetaOptions } from './meta.ts'
+
+// Tokens (consumed by testmap tailwind.config)
+export { tokens } from './tokens/index.ts'
+export type { Tokens, CategoryColorKey, TierColorKey } from './tokens/colors.ts'
+
+// Category icon primitive
+export { categoryIconSvg, categoryIconPath } from './primitives/category-icon.ts'
+export type { CategoryIconPathOpts, CategoryIconSvgOpts } from './primitives/category-icon.ts'
+
+// Item cell templates
+export { renderItemCell, itemCellGroup } from './templates/item-cell.ts'
+export type { ItemCellProps, ItemCellGroupProps } from './templates/item-cell.ts'
+
+// Ship panel template
+export { renderShipPanel } from './templates/ship-panel.ts'
+export type { ShipPanelProps, ShipPanelSlot } from './templates/ship-panel.ts'
+
+// Re-exports from sdkv2 so consumers only need one import boundary
+export {
+  resolveItem,
+  ServerContract,
+  type ResolvedItem,
+  type ResolvedItemStat,
+  type ResolvedItemType,
+  type ResolvedModuleSlot,
+  type ResolvedAttributeGroup,
+} from '@shipload/sdk'
+export type { CategoryIconShape } from '@shipload/sdk'

package/src/links.ts

@@ -0,0 +1,19 @@
+import type { CargoItem } from './payload/codec.ts'
+import { encodePayload } from './payload/codec.ts'
+
+const DEFAULT_WEBSITE_BASE = 'https://shiploadgame.com'
+const DEFAULT_IMAGE_BASE = 'https://img.shiploadgame.com'
+
+export function linkToItemPage(item: CargoItem, baseUrl = DEFAULT_WEBSITE_BASE): string {
+  const payload = encodePayload(item)
+  return `${baseUrl}/guide/item/${payload}`
+}
+
+export function linkToItemImage(
+  item: CargoItem,
+  ext: 'png' | 'svg',
+  baseUrl = DEFAULT_IMAGE_BASE,
+): string {
+  const payload = encodePayload(item)
+  return `${baseUrl}/item/${payload}.${ext}`
+}

package/src/meta.ts

@@ -0,0 +1,42 @@
+import type { ResolvedItem } from '@shipload/sdk'
+import type { CargoItem } from './payload/codec.ts'
+import { linkToItemImage } from './links.ts'
+
+function tierLabel(tier: string): string {
+  return tier.toUpperCase()
+}
+
+function categoryLabel(resolved: ResolvedItem): string {
+  if (!resolved.category) return ''
+  return resolved.category[0]!.toUpperCase() + resolved.category.slice(1)
+}
+
+function describeItem(resolved: ResolvedItem): string {
+  const parts: string[] = []
+  if (resolved.category) parts.push(categoryLabel(resolved))
+  parts.push(tierLabel(resolved.tier))
+  parts.push(`${resolved.mass.toLocaleString('en-US')} kg`)
+  return parts.join(' · ')
+}
+
+export interface ItemPageMeta {
+  title: string
+  description: string
+  ogImage: string
+}
+
+export interface ItemPageMetaOptions {
+  imageBaseUrl?: string
+}
+
+export function itemPageMeta(
+  item: CargoItem,
+  resolved: ResolvedItem,
+  opts?: ItemPageMetaOptions,
+): ItemPageMeta {
+  return {
+    title: `${resolved.name} · Shipload Guide`,
+    description: describeItem(resolved),
+    ogImage: linkToItemImage(item, 'png', opts?.imageBaseUrl),
+  }
+}

package/src/payload/base64url.ts

@@ -0,0 +1,27 @@
+import { InvalidPayloadError } from '../errors.ts'
+
+export function bytesToBase64Url(bytes: Uint8Array): string {
+  let binary = ''
+  for (let i = 0; i < bytes.byteLength; i++) binary += String.fromCharCode(bytes[i]!)
+  const b64 = btoa(binary)
+  return b64.replaceAll('+', '-').replaceAll('/', '_').replaceAll('=', '')
+}
+
+export function base64UrlToBytes(input: string): Uint8Array {
+  if (!/^[A-Za-z0-9_-]*$/.test(input)) {
+    throw new InvalidPayloadError('payload contains non-base64url characters')
+  }
+  const padded = input.replaceAll('-', '+').replaceAll('_', '/').padEnd(
+    Math.ceil(input.length / 4) * 4,
+    '='
+  )
+  let binary: string
+  try {
+    binary = atob(padded)
+  } catch (e) {
+    throw new InvalidPayloadError(`base64 decode failed: ${(e as Error).message}`)
+  }
+  const bytes = new Uint8Array(binary.length)
+  for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i)
+  return bytes
+}

package/src/payload/codec.ts

@@ -0,0 +1,26 @@
+import { Serializer } from '@wharfkit/antelope'
+import { ServerContract } from '@shipload/sdk'
+import { InvalidPayloadError } from '../errors.ts'
+import { base64UrlToBytes, bytesToBase64Url } from './base64url.ts'
+
+export type CargoItem = InstanceType<typeof ServerContract.Types.cargo_item>
+export type CargoItemLike = Parameters<typeof ServerContract.Types.cargo_item.from>[0]
+
+export function encodePayload(input: CargoItemLike): string {
+  const item = ServerContract.Types.cargo_item.from(input)
+  const bytes = Serializer.encode({ object: item }).array
+  return bytesToBase64Url(bytes)
+}
+
+export function decodePayload(input: string): CargoItem {
+  if (input.length === 0) throw new InvalidPayloadError('empty payload')
+  const bytes = base64UrlToBytes(input)
+  try {
+    return Serializer.decode({
+      data: bytes,
+      type: ServerContract.Types.cargo_item,
+    }) as CargoItem
+  } catch (e) {
+    throw new InvalidPayloadError(`cargo_item decode failed: ${(e as Error).message}`)
+  }
+}